Файлы: приём и отправка

import { client, user } from '@holocronlab/botruntime-runtime'

const DOCX_MIME =
  'application/vnd.openxmlformats-officedocument.wordprocessingml.document'

// Загрузить документ в файловый стор бота и отправить его в диалог одним
// файловым сообщением. key — стабильный путь (перезалив перезаписывает
// файл, а не плодит копии).
export async function sendDocument(
  conversationId: string,
  key: string,
  bytes: Uint8Array,
  title: string,
): Promise<void> {
  const { file } = await client.uploadFile({
    key,
    content: bytes,
    contentType: DOCX_MIME,
  })
  if (!file?.url) {
    throw new Error('uploadFile не вернул url файла')
  }

  await client.createMessage({
    conversationId,
    userId: user.id,
    type: 'file',
    tags: {},
    payload: { fileUrl: file.url, title, mimeType: DOCX_MIME },
  })
}

import { client } from '@holocronlab/botruntime-runtime'

// Ручной двухфазный аплоад, когда байты нельзя отдать одним вызовом
// (заливка из браузера, стрим, чанки): upsertFile → PUT байтов → URL.
// PUT идёт мимо client — Bearer-токен приложите сами, только на адрес платформы.
export async function uploadBytes(
  key: string,
  bytes: Uint8Array,
  contentType: string,
  token: string,
): Promise<string> {
  const { file } = await client.upsertFile({
    key,
    size: bytes.byteLength,
    contentType,
  })
  if (!file?.uploadUrl || !file?.url) {
    throw new Error('upsertFile не вернул uploadUrl/url')
  }

  const res = await fetch(file.uploadUrl, {
    method: 'PUT',
    headers: {
      authorization: `Bearer ${token}`,
      'content-type': contentType,
    },
    body: new Uint8Array(bytes).buffer as ArrayBuffer,
  })
  if (!res.ok) {
    throw new Error(`заливка байтов -> ${res.status}`)
  }

  return file.url
}

// Претензия по делу №42 всегда лежит по одному ключу — повторная генерация
// заменяет старую версию, диалог не засоряется дублями.
const key = `cases/${caseId}/claim.docx`

import { Conversation } from '@holocronlab/botruntime-runtime'

export default new Conversation({
  channel: '*',
  handler: async ({ message, execute }) => {
    if (message?.type === 'file') {
      const { fileUrl, title, mimeType } = message.payload
      // fileUrl — auth-гейтед ссылка API платформы. Передайте её инструменту,
      // который скачает байты с токеном бота или отдаст файл в LLM-шлюз.
      await execute({
        instructions: `Пользователь прислал документ «${title}» (${mimeType}). ` +
          `Разбери его и продолжи диалог.`,
      })
      return
    }

    await execute({ instructions: 'Ты — помощник. Отвечай кратко и по-русски.' })
  },
})

// Скачать защищённый файл: байты тянутся с токеном, сохраняются через
// временный object-URL (голый href ушёл бы без токена → 401).
async function download(path: string, key: string): Promise<void> {
  const blob = await apiFetchBlob(path, { key })
  const url = URL.createObjectURL(blob)
  const a = document.createElement('a')
  a.href = url
  a.download = key.split('/').pop() || key
  a.click()
  URL.revokeObjectURL(url)
}