@ykurilov/agent-chat-core 0.77.0 → 0.79.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @ykurilov/agent-chat-core
 
+## 0.79.0
+
+### Minor Changes
+
+- 88886de: Новые контракты приложения: HTTP `newChatGreeting` после `newChatData`, проверенное `createChat.title`, текущий вопрос `contextBlocks.userMessage` для ожидаемой асинхронной классификации, direct DeepSeek `low/high/max` и опциональные устойчивые номера фото.
+  
+  `createAttachments({ imageNumbers: true })` сохраняет серверный номер вместе с принятой картинкой; `service.getChatImages(userId, chatId)` возвращает соответствие номер/attachmentId полной активной ветки. Номера не меняются при повторе файла, перезапуске, компакции и переключении ветки; скрытые ветки не отдают свои номера другим файлам. Старые файлы без меток не заполняются задним числом, без настройки запрос модели прежний. Одновременные процессы используют существующую распределённую аренду чата.
+  
+  Приветствие вызывается только при HTTP-создании, не при GET/reload; повтор POST создаёт другой чат. `userMessage` равен null у служебного хода, approval/resume сохраняет исходный вопрос. Данные и название не попадают автоматически в системные инструкции. `importChat.chat.data` уже доступно в 0.77.0; тестовая модель — существующий AI SDK `ai/test`, новый тестовый пакет не нужен. Полные принятые contextBlocks после компакции передаются без обрезания, в прежнем порядке.
+  
+  Как обновить: все SDK-пакеты одной версией; новые настройки включать явно. SQL-схемы не меняются. [Точные примеры и ограничения](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/app-chat-contracts.md).
+
+## 0.78.0
+
+No changes in this release.
+
 ## 0.77.0
 
 ### Patch Changes
@@ -10,7 +26,7 @@
   
   `previewMigration` и опция `requiresConfirmation` у `migrateChats` оставляют разговоры без подходящей квитанции на прежней версии. Старый путь или поле карточки не считаются доказательством. Увеличения контекста судьи, автоматической проверки владения доменом и изменений JSON редактора нет.
   
-  Подключение, отмена, миграция и ограничения: [docs/flow-confirmations.md](../../docs/flow-confirmations.md). Без новых опций поведение прежнее; SQL-миграций нет. Приложение обрабатывает `busy`/`stale` при отмене и само определяет доверенный маршрут исправления атрибуции.
+  Подключение, отмена, миграция и ограничения: [docs/flow-confirmations.md](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/flow-confirmations.md). Без новых опций поведение прежнее; SQL-миграций нет. Приложение обрабатывает `busy`/`stale` при отмене и само определяет доверенный маршрут исправления атрибуции.
 
 ## 0.76.0
 

package/README.md

@@ -158,3 +158,5 @@ docs/getting-started.md, «Значки шагов и заголовки раз
 Вид расхода (`source`) — штатный (`BUILT_IN_USAGE_SOURCES`: ответ, сжатие, память, голос `voice_input`/`voice_polish` и другие)
 или свой вид приложения строкой, например `service.recordUsage({ …, source: "font_download" })`, без приведения типа. Лимиты
 считают все виды вместе; отчёт по одному виду — `sumUsage({ source })`.
+
+Контракты интеграции приложения: [HTTP-приветствие, текущий вопрос, номера фото, метаданные и тесты](https://github.com/ykurilov/agent-chat-sdk/blob/main/docs/app-chat-contracts.md).

package/dist/{chunk-BQTUOC3T.js → chunk-AJSRGBVM.js}

@@ -1618,7 +1618,7 @@ function screenDataOf(name, data, views) {
   }
 }
 function isModelOnlyPart(part) {
-  return part.type === FROZEN_CONTEXT_PART_TYPE || part.type === END_TURN_PART_TYPE;
+  return part.type === FROZEN_CONTEXT_PART_TYPE || part.type === END_TURN_PART_TYPE || part.type === "data-chat-image-number";
 }
 
 // src/thought-titles/thought-title-parts.ts
@@ -7003,6 +7003,8 @@ async function freezeTurnContext(input, turn, base, place) {
   const { memory, ownerId } = input;
   if (memory && ownerId && !input.group) sources.memory = () => memoryBlocks(memory, { userId: ownerId, chatId: input.chatId });
   if (input.contextBlocks) {
+    const question2 = turn.history.findLast((message) => message.role === "user" && !isStateMessage(message));
+    const human = question2 && isHumanMessage(question2) ? question2 : void 0;
     sources.app = appBlocksSource({
       contextBlocks: input.contextBlocks,
       timeoutMs: input.contextBlocksTimeoutMs ?? DEFAULT_CONTEXT_BLOCKS_TIMEOUT_MS,
@@ -7012,6 +7014,7 @@ async function freezeTurnContext(input, turn, base, place) {
         chatId: input.chatId,
         ownerId: input.ownerId ?? "",
         messageId: input.messageId,
+        userMessage: human ? { id: human.id, text: human.parts.filter((part) => part.type === "text").map((part) => part.text).join("\n") } : null,
         chat: structuredClone({ ...input.chatData && { data: input.chatData } }),
         state: structuredClone(turn.state),
         ...input.subject && { subject: structuredClone(input.subject) },
@@ -8936,11 +8939,16 @@ function createDeepSeekProvider(connectionOptions = {}) {
     createLanguageModel: (providerModelId, apiKey, options2) => createDeepSeek({ apiKey, fetch: options2?.fetch, ...connection })(providerModelId),
     // DeepSeek кэширует начало запроса сам.
     requestOptions: () => ({}),
-    // Рассуждения у DeepSeek только включаются и выключаются полем `thinking`; силы у них нет.
+    // Direct Chat Completions: thinking отдельно от reasoning_effort (официальные docs, 24.10.2026).
+    // Старые off/on сохраняют прежние байты; выбор силы включается профилем приложения.
     reasoningRequest: (level) => {
       if (level === "off") return { providerOptions: { deepseek: { thinking: { type: "disabled" } } } };
       if (level === "on") return { providerOptions: { deepseek: { thinking: { type: "enabled" } } } };
-      throw new Error(`DeepSeek \u043D\u0435 \u0437\u0430\u0434\u0430\u0451\u0442 \u0441\u0438\u043B\u0443 \u0440\u0430\u0441\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0439 (\u0443\u0440\u043E\u0432\u0435\u043D\u044C \xAB${level}\xBB), \u0442\u043E\u043B\u044C\u043A\u043E \xABoff\xBB \u0438 \xABon\xBB`);
+      const effort = level === "minimal" ? "low" : level === "medium" ? "high" : level;
+      if (effort === "low" || effort === "high" || effort === "max") {
+        return { providerOptions: { deepseek: { thinking: { type: "enabled" }, reasoningEffort: effort } } };
+      }
+      throw new Error(`DeepSeek: \u043D\u0435\u0438\u0437\u0432\u0435\u0441\u0442\u043D\u044B\u0439 \u0443\u0440\u043E\u0432\u0435\u043D\u044C \u0440\u0430\u0441\u0441\u0443\u0436\u0434\u0435\u043D\u0438\u0439 \xAB${level}\xBB`);
     },
     // Обрезки хвоста (`min_p`) в API DeepSeek нет (api-docs.deepseek.com: только temperature и top_p), а пакет провайдера
     // незнакомые поля не шлёт: `samplingRequest` нет, `sampling.minP` модели сюда не уходит.
@@ -10548,6 +10556,52 @@ function voiceChangeNote(set) {
 var DEFAULT_VOICE_MODE_HINT = voiceModeHint();
 var DEFAULT_TEXT_MODE_NOTE = "[\u0421\u043B\u0443\u0436\u0435\u0431\u043D\u0430\u044F \u043F\u043E\u043C\u0435\u0442\u043A\u0430 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F, \u0447\u0435\u043B\u043E\u0432\u0435\u043A \u0435\u0451 \u043D\u0435 \u043F\u0438\u0441\u0430\u043B \u0438 \u043D\u0435 \u0432\u0438\u0434\u0438\u0442: \u0440\u0430\u0437\u0433\u043E\u0432\u043E\u0440 \u0441\u043D\u043E\u0432\u0430 \u0438\u0434\u0451\u0442 \u0442\u0435\u043A\u0441\u0442\u043E\u043C, \u043E\u0442\u0432\u0435\u0442 \u043D\u0435 \u043E\u0437\u0432\u0443\u0447\u0438\u0432\u0430\u0435\u0442\u0441\u044F \u2014 \u043E\u0431\u044B\u0447\u043D\u044B\u0439 \u043F\u0438\u0441\u044C\u043C\u0435\u043D\u043D\u044B\u0439 \u0441\u0442\u0438\u043B\u044C \u0441\u043D\u043E\u0432\u0430 \u0443\u043C\u0435\u0441\u0442\u0435\u043D. \u0422\u0435\u0433\u0438 \u0433\u043E\u043B\u043E\u0441\u0430 \u0432 \u043A\u0432\u0430\u0434\u0440\u0430\u0442\u043D\u044B\u0445 \u0441\u043A\u043E\u0431\u043A\u0430\u0445 ([laughs], [sighs] \u0438 \u043F\u043E\u0434\u043E\u0431\u043D\u044B\u0435) \u0431\u043E\u043B\u044C\u0448\u0435 \u043D\u0435 \u0441\u0442\u0430\u0432\u044C, \u0434\u0430\u0436\u0435 \u0435\u0441\u043B\u0438 \u043E\u043D\u0438 \u0435\u0441\u0442\u044C \u0432 \u043F\u0440\u0435\u0436\u043D\u0438\u0445 \u043E\u0442\u0432\u0435\u0442\u0430\u0445 \u0432\u044B\u0448\u0435. \u041D\u0435 \u0443\u043F\u043E\u043C\u0438\u043D\u0430\u0439 \u044D\u0442\u0443 \u043F\u043E\u043C\u0435\u0442\u043A\u0443.]";
 
+// src/attachments/chat-image-numbers.ts
+var CHAT_IMAGE_NUMBER_PART = "data-chat-image-number";
+var PREFIX = "attachment:";
+var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function imageId(part) {
+  if (part.type !== "file" || !part.mediaType.startsWith("image/") || !part.url.startsWith(PREFIX)) return void 0;
+  const id = part.url.slice(PREFIX.length);
+  return UUID.test(id) ? id : void 0;
+}
+function chatImageReferences(messages) {
+  const byId = /* @__PURE__ */ new Map();
+  const byNumber = /* @__PURE__ */ new Map();
+  for (const message of messages) {
+    if (!isHumanMessage(message)) continue;
+    const files = new Set(message.parts.map(imageId).filter((id) => id !== void 0));
+    for (const part of message.parts) {
+      if (part.type !== CHAT_IMAGE_NUMBER_PART) continue;
+      const data = part.data;
+      if (!data || typeof data.attachmentId !== "string" || !files.has(data.attachmentId) || !Number.isSafeInteger(data.number) || data.number < 1) continue;
+      const number = data.number;
+      const existing = byId.get(data.attachmentId);
+      if (existing && existing.number !== number || byNumber.has(number) && byNumber.get(number) !== data.attachmentId) throw new Error("\u041F\u043E\u0432\u0440\u0435\u0436\u0434\u0435\u043D\u044B \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u044B\u0435 \u043D\u043E\u043C\u0435\u0440\u0430 \u043A\u0430\u0440\u0442\u0438\u043D\u043E\u043A \u0447\u0430\u0442\u0430");
+      byNumber.set(number, data.attachmentId);
+      if (!existing) byId.set(data.attachmentId, { number, attachmentId: data.attachmentId, messageId: message.id });
+    }
+  }
+  return [...byId.values()].sort((a, b) => a.number - b.number);
+}
+function numberedImageParts(history, parts) {
+  if (!parts.some((part) => imageId(part) !== void 0)) return parts;
+  const references = chatImageReferences(history);
+  const numbers = new Map(references.map((ref) => [ref.attachmentId, ref.number]));
+  let max = references.at(-1)?.number ?? 0;
+  return parts.flatMap((part) => {
+    const id = imageId(part);
+    if (!id) return [part];
+    let number = numbers.get(id);
+    if (number === void 0) {
+      if (max === Number.MAX_SAFE_INTEGER) throw new Error("\u0418\u0441\u0447\u0435\u0440\u043F\u0430\u043D\u044B \u043D\u043E\u043C\u0435\u0440\u0430 \u043A\u0430\u0440\u0442\u0438\u043D\u043E\u043A \u0447\u0430\u0442\u0430");
+      number = ++max;
+      numbers.set(id, number);
+    }
+    return [part, { type: CHAT_IMAGE_NUMBER_PART, data: { attachmentId: id, number } }];
+  });
+}
+
 // src/subject-chats/subject-chats.ts
 var SUBJECT_KEY_MAX_LENGTH = 200;
 var SUBJECT_DATA_MAX_BYTES = CHAT_DATA_MAX_BYTES;
@@ -10675,7 +10729,7 @@ function createSubjectChats(deps) {
             chatId,
             parentId: messages.at(-1)?.id ?? null,
             role: message.role,
-            parts,
+            parts: deps.attachments?.imageNumbers && message.role === "user" ? numberedImageParts(messages, parts) : parts,
             createdAt: isoDate(message.createdAt)
           })
         );
@@ -10752,7 +10806,7 @@ function assertGreeting(greeting) {
     throw new TypeError(`\u0422\u0435\u043A\u0441\u0442 \u0438\u043B\u0438 \u0443\u043A\u0430\u0437\u0430\u043D\u0438\u0435 \u043F\u0440\u0438\u0432\u0435\u0442\u0441\u0442\u0432\u0438\u044F \u2014 \u0441\u0442\u0440\u043E\u043A\u0430 \u043E\u0442 1 \u0434\u043E ${GREETING_MAX_LENGTH} \u0437\u043D\u0430\u043A\u043E\u0432.`);
   }
 }
-var UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+var UUID2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 var ISO_DATE_WITH_ZONE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})$/;
 function isValidDate(value) {
   return typeof value === "string" && ISO_DATE_WITH_ZONE.test(value) && !Number.isNaN(Date.parse(value));
@@ -10761,7 +10815,7 @@ function isoDate(value) {
   return new Date(value).toISOString();
 }
 function assertImport({ chat, messages }) {
-  if (chat.id !== void 0 && (typeof chat.id !== "string" || !UUID.test(chat.id))) throw new TypeError("id \u0438\u043C\u043F\u043E\u0440\u0442\u0438\u0440\u0443\u0435\u043C\u043E\u0433\u043E \u0447\u0430\u0442\u0430 \u2014 UUID.");
+  if (chat.id !== void 0 && (typeof chat.id !== "string" || !UUID2.test(chat.id))) throw new TypeError("id \u0438\u043C\u043F\u043E\u0440\u0442\u0438\u0440\u0443\u0435\u043C\u043E\u0433\u043E \u0447\u0430\u0442\u0430 \u2014 UUID.");
   if (chat.subjectKey !== void 0) assertSubjectKey(chat.subjectKey);
   if (chat.subjectData !== void 0) assertSubjectData(chat.subjectData);
   if (chat.data !== void 0) assertChatData(chat.data);
@@ -13417,6 +13471,10 @@ function createChatService(input) {
   function takeTurnSlot(userId, chatId) {
     startingSlots.set(chatId, turnSlots.take(userId));
   }
+  async function filePartsWithNumbers(chatId, parts) {
+    if (!options2.attachments?.imageNumbers || !parts.some((part) => part.mediaType.startsWith("image/"))) return parts;
+    return numberedImageParts(await storage.listMessages(chatId), parts);
+  }
   async function acceptFiles(userId, chatId, files) {
     return files.length > 0 ? options2.attachments.acceptUserParts({ userId, chatId, parts: files }) : [];
   }
@@ -13791,7 +13849,7 @@ function createChatService(input) {
         parentId: branch.at(-1)?.id ?? null,
         role: "user",
         parts: [
-          ...fileParts,
+          ...await filePartsWithNumbers(chatId, fileParts),
           ...text.trim().length > 0 ? [{ type: "text", text }] : [],
           ...sendOptions?.voiceMode === true ? [voiceModePart(await currentVoice(userId), void 0, uniqueVoiceSounds(sendOptions.voiceSounds ?? []))] : [],
           ...[channelPart(sendOptions?.channel ?? "web", sendOptions?.group)].filter((part) => part !== void 0),
@@ -14041,7 +14099,7 @@ function createChatService(input) {
             chatId,
             parentId,
             role: "user",
-            parts: [...fileParts, ...text.trim().length > 0 ? [{ type: "text", text }] : [], steerPart()]
+            parts: [...await filePartsWithNumbers(chatId, fileParts), ...text.trim().length > 0 ? [{ type: "text", text }] : [], steerPart()]
           });
           await confirmFiles(correction.id, fileParts);
           await storage.insertMessage(correction);
@@ -14122,6 +14180,7 @@ function createChatService(input) {
     liveDemos: input.agent.liveDemos === true,
     checksReplies: replyChecks.checks.length > 0,
     async createChat(userId, createOptions) {
+      const title = createOptions?.title === void 0 ? void 0 : normalizeChatTitle(createOptions.title);
       if (createOptions?.data !== void 0) {
         assertChatData(createOptions.data);
         if (!storage.updateChatData) throw new Error("\u0414\u0430\u043D\u043D\u044B\u0435 \u0447\u0430\u0442\u0430 \u0442\u0440\u0435\u0431\u0443\u044E\u0442 \u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0430 \u0441 updateChatData: \u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0435 \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u044F \u0435\u0433\u043E \u043D\u0435 \u0443\u043C\u0435\u0435\u0442.");
@@ -14133,6 +14192,7 @@ function createChatService(input) {
           ownerId: userId,
           ...await choiceForNewChat(userId),
           ...createOptions?.origin && { origin: createOptions.origin },
+          ...title !== void 0 && { title },
           ...createOptions?.data !== void 0 && { data: createOptions.data }
         },
         createOptions?.greeting
@@ -14289,6 +14349,10 @@ function createChatService(input) {
       const chat = await ownChat(userId, chatId);
       return structuredClone(chatDataOfInput(chat) ?? {});
     },
+    async getChatImages(userId, chatId) {
+      await ownChat(userId, chatId);
+      return chatImageReferences(await currentBranch(chatId));
+    },
     async listChats(userId, listOptions) {
       if (listOptions?.data !== void 0) {
         assertChatDataFilter(listOptions.data);
@@ -14496,7 +14560,7 @@ function createChatService(input) {
             parentId: edited2.parentId,
             role: "user",
             parts: [
-              ...fileParts,
+              ...await filePartsWithNumbers(chatId, fileParts),
               ...text.trim().length > 0 ? [{ type: "text", text }] : [],
               ...editOptions?.voiceMode === true ? [
                 voiceModePart(
@@ -15212,6 +15276,8 @@ export {
   voiceChangeNote,
   DEFAULT_VOICE_MODE_HINT,
   DEFAULT_TEXT_MODE_NOTE,
+  CHAT_IMAGE_NUMBER_PART,
+  chatImageReferences,
   SUBJECT_KEY_MAX_LENGTH,
   SUBJECT_DATA_MAX_BYTES,
   GREETING_MAX_LENGTH,
@@ -15237,4 +15303,4 @@ export {
   InvalidWidgetAnswerError,
   createChatService
 };
-//# sourceMappingURL=chunk-BQTUOC3T.js.map
+//# sourceMappingURL=chunk-AJSRGBVM.js.map