@ykurilov/agent-chat-core 0.110.1 → 0.112.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,29 @@
1
1
  # @ykurilov/agent-chat-core
2
2
 
3
+ ## 0.112.0
4
+
5
+ ### Minor Changes
6
+
7
+ - ca34740: Пустых карточек ответа больше нет. Ответ без текста раньше рисовался одинаково — «Модель не дала ответа» или пустой карточкой, хотя причины разные.
8
+
9
+ - Ответ, закрытый ради поправки на лету, показывает только свои шаги, без «Скопировать» и подписи модели. Если показать нечего, его нет в ленте совсем: продолжение — следующий ответ.
10
+ - «Стоп» до первого слова — строка «Ответ остановлен до начала», обрыв связи или перезапуск до первого слова — «Ответ оборвался до начала». «Повторить» на месте. Остановленный на шагах ответ — шаги и отметка «Остановлено», без лишней строки.
11
+ - Диктор говорит то же, что видно, и молчит у ответа, закрытого ради поправки.
12
+
13
+ Договор скина 34: необязательное `AgentMessage.emptyText` — строка вместо ответа без текста (`""` — без строки, без копирования). Скины до 34 работают по `empty`, как раньше. Новые необязательные надписи `answerStoppedEmpty` и `answerInterruptedEmpty`. [Договор 34](docs/skin-v34.md).
14
+
15
+ Ядро: ход ответа на поправку знает, какие закрытые ответы он продолжает — `continuedAnswerIds` (от ближнего к дальнему) в модели инструментов, в `prepareTurn` и в событии `turn-started`; у обычного хода поля нет. Приложение может считать результаты инструментов закрытого ответа своими для нового хода: `output.turnId` из `[model.turnId, ...model.continuedAnswerIds]`. Список считается по ветке хранилища (`continuedAnswerIdsOf(branch)`), поэтому «Повторить», «Переделать» и перезапуск дают тот же результат. История модели и кэш не меняются.
16
+
17
+ ## 0.111.0
18
+
19
+ ### Minor Changes
20
+
21
+ - 569661f: Фоновую задачу теперь может запустить сам сервер приложения, без хода модели: `background.start({ ownerId, chatId, name, input, title? })`. Пример — человек загрузил видео, и сервер сразу ставит разбор. Раньше для этого приходилось будить агента служебным сообщением и надеяться, что модель вызовет инструмент.
22
+
23
+ Задача идёт тем же путём, что вызов модели: вход проверяется схемой инструмента, предел `maxRunningPerUser` общий с задачами модели и между копиями сервера, карточка с «Отменить» и ходом появляется в открытой вкладке без перезагрузки, задача переживает перезапуск, итог приходит служебным сообщением с ходом агента. Ответ — `{ status: "started", taskId, title }` или `{ status: "too_many_tasks", message }`. Отказы без записи: нет инструмента или вход не по схеме — `TypeError`, чата нет или он чужой — `ChatNotFoundError`. Чат занят ходом — задача запускается, итог придёт после хода. `createBackgroundTasks` теперь возвращает `BackgroundTaskService` (это `BackgroundTasks` плюс `start`).
24
+
25
+ Ядро: служебное сообщение о задаче несёт `startedBy: "app"`, и модель читает «Фоновая задача "…" (её запустило приложение, не ты) …». Тексты о задачах модели не изменились, кэш истории цел. `BackgroundPort` получил `assertOwnChat`. Хранилища задач SQLite и Postgres получают колонку `started_by` (миграция применяется сама при открытии хранилища).
26
+
3
27
  ## 0.110.1
4
28
 
5
29
  No changes in this release.
package/README.md CHANGED
@@ -63,7 +63,9 @@ import type { ChatStorage } from "@ykurilov/agent-chat-core";
63
63
  (отметка `data-agent-steer`, модели не уходит), агент берёт его на ближайшей границе шага: ответ закрывается, ход продолжается новым
64
64
  ответом на поправки (поток — `subscribe`). Поправки подряд уходят модели одним сообщением человека. Хода нет — обычный ход (`started`);
65
65
  ход на другой копии — `ChatBusyError`. Проверки — как у `sendMessage`. Ждущие поправки — `pendingMessages` в истории; `isCorrection`,
66
- `STEER_PART_TYPE` — для своей ленты.
66
+ `STEER_PART_TYPE` — для своей ленты. Ход ответа на поправку получает `continuedAnswerIds` — id закрытых ответов, которые он продолжает
67
+ (от ближнего к дальнему): в модели инструментов, в `prepareTurn` и в событии `turn-started`. По нему приложение считает результаты
68
+ инструментов закрытого ответа своими для нового хода (`continuedAnswerIdsOf(branch)` — то же по ветке).
67
69
  - `@ykurilov/agent-chat-core/storage-contract` — общие тесты `describeChatStorageContract`
68
70
  для своей реализации хранилища (нужен `vitest`). Их проходят память, SQLite и PostgreSQL.
69
71
  - Список чатов: `chat.listChats(userId)`, `chat.renameChat(userId, chatId, title)`, `chat.deleteChat(userId, chatId)`. Хранилище для этого реализует `listChats`, `renameChat`, `deleteChat`. Название чата берётся из первого сообщения (`deriveChatTitle`, до 60 знаков), вручную — до 100 (`normalizeChatTitle`, `InvalidChatTitleError`). Удаление настоящее: идущий ответ и сжатие останавливаются, затем уходят файлы вложений, сообщения, записи сжатия и чат.
@@ -1483,7 +1483,7 @@ function endTurnModel(text) {
1483
1483
 
1484
1484
  // src/notices/notices-for-model.ts
1485
1485
  function noticeText(notice) {
1486
- const task = `\u0424\u043E\u043D\u043E\u0432\u0430\u044F \u0437\u0430\u0434\u0430\u0447\u0430 "${notice.title}"`;
1486
+ const task = `\u0424\u043E\u043D\u043E\u0432\u0430\u044F \u0437\u0430\u0434\u0430\u0447\u0430 "${notice.title}"${notice.startedBy === "app" ? " (\u0435\u0451 \u0437\u0430\u043F\u0443\u0441\u0442\u0438\u043B\u043E \u043F\u0440\u0438\u043B\u043E\u0436\u0435\u043D\u0438\u0435, \u043D\u0435 \u0442\u044B)" : ""}`;
1487
1487
  switch (notice.kind) {
1488
1488
  case "task_done":
1489
1489
  return `${task} \u0437\u0430\u043A\u043E\u043D\u0447\u0438\u043B\u0430\u0441\u044C: ${notice.result ?? ""}`;
@@ -1761,6 +1761,18 @@ function steerPart() {
1761
1761
  function isCorrection(message) {
1762
1762
  return message.role === "user" && message.parts.some((part) => part.type === STEER_PART_TYPE);
1763
1763
  }
1764
+ function continuedAnswerIdsOf(branch) {
1765
+ const answerIds = [];
1766
+ let index = branch.length - 1;
1767
+ while (index >= 0 && isCorrection(branch[index])) {
1768
+ while (index >= 0 && isCorrection(branch[index])) index--;
1769
+ const answer = branch[index];
1770
+ if (answer?.role !== "assistant") break;
1771
+ answerIds.push(answer.id);
1772
+ index--;
1773
+ }
1774
+ return answerIds;
1775
+ }
1764
1776
  function withCorrectionsJoined(history) {
1765
1777
  const joined = [];
1766
1778
  for (const message of history) {
@@ -8654,6 +8666,7 @@ function turnToolsModel(input, found, turn) {
8654
8666
  ownerId: input.ownerId ?? "",
8655
8667
  place: input.place ?? null,
8656
8668
  turnId: input.messageId,
8669
+ ...input.continuedAnswerIds?.length && { continuedAnswerIds: [...input.continuedAnswerIds] },
8657
8670
  notifyDataChanged: turn.dataChanges.notify,
8658
8671
  emitAppEvent: turn.appEvents.emit,
8659
8672
  channel: input.channel ?? "web",
@@ -14406,6 +14419,7 @@ function createChatService(input) {
14406
14419
  const sentTimeZone = resolveTimeZone(launch.timeZone) ?? resolveTimeZone(launch.page?.timeZone);
14407
14420
  const timeZone = sentTimeZone ?? fallbackTimeZone;
14408
14421
  const resumeMessage = launch.resume && toAgentChatMessage(launch.resume);
14422
+ const continuedAnswerIds = continuedAnswerIdsOf(launch.resume ? branch.slice(0, -1) : branch);
14409
14423
  if (resumeMessage && !launch.replay) resumeBases.set(chatId, resumeMessage);
14410
14424
  const toolQueue = chatToolQueues.get(chatId) ?? createToolQueue();
14411
14425
  chatToolQueues.set(chatId, toolQueue);
@@ -14430,6 +14444,7 @@ function createChatService(input) {
14430
14444
  ownerId: chat.ownerId,
14431
14445
  messageId: answerId,
14432
14446
  parentId: launch.parentId,
14447
+ ...continuedAnswerIds.length > 0 && { continuedAnswerIds },
14433
14448
  ...model,
14434
14449
  ...agentSettings,
14435
14450
  ...instructions !== void 0 && { instructions },
@@ -14467,6 +14482,7 @@ function createChatService(input) {
14467
14482
  chat: structuredClone(chat),
14468
14483
  action: launch.action,
14469
14484
  resumed: launch.resume !== void 0,
14485
+ ...continuedAnswerIds.length > 0 && { continuedAnswerIds: [...continuedAnswerIds] },
14470
14486
  audience: group ? "group" : "private",
14471
14487
  ...staff && { staff: structuredClone(staff) },
14472
14488
  // Ход по служебному сообщению — с ним; у остальных ходов пусто.
@@ -14576,7 +14592,8 @@ function createChatService(input) {
14576
14592
  type: "turn-started",
14577
14593
  ...turnEvent,
14578
14594
  ...launch.deliveredByApp && { deliveredByApp: true },
14579
- ...launch.unattended && { unattended: true }
14595
+ ...launch.unattended && { unattended: true },
14596
+ ...continuedAnswerIds.length > 0 && { continuedAnswerIds: [...continuedAnswerIds] }
14580
14597
  });
14581
14598
  if (launch.unattended && chatEvents.hasListeners?.() === false) {
14582
14599
  logError(`\u0425\u043E\u0434 \u0431\u0435\u0437 \u0432\u044B\u0437\u043E\u0432\u0430 \u043D\u0430 \u043F\u0430\u0447\u043A\u0443 \u0447\u0430\u0442\u0430 ${chatId}: \u043D\u0430 \u0441\u043E\u0431\u044B\u0442\u0438\u044F \u0447\u0430\u0442\u0430 \u043D\u0438\u043A\u0442\u043E \u043D\u0435 \u043F\u043E\u0434\u043F\u0438\u0441\u0430\u043D \u2014 \u043E\u0442\u0432\u0435\u0442 \u0431\u0443\u0434\u0435\u0442 \u0442\u043E\u043B\u044C\u043A\u043E \u0432 \u0438\u0441\u0442\u043E\u0440\u0438\u0438`);
@@ -15872,6 +15889,9 @@ function createChatService(input) {
15872
15889
  });
15873
15890
  },
15874
15891
  assertWithinLimit: (ownerId, chatId) => assertWithinSpendingLimit(ownerId, chatId),
15892
+ async assertOwnChat(ownerId, chatId) {
15893
+ await ownChat(ownerId, chatId);
15894
+ },
15875
15895
  logError: (error) => logError(`\u0424\u043E\u043D: ${error instanceof Error ? error.message : String(error)}`, error),
15876
15896
  helpers: backgroundHelpers
15877
15897
  };
@@ -16080,6 +16100,7 @@ export {
16080
16100
  GREETING_LEAD,
16081
16101
  STEER_PART_TYPE,
16082
16102
  isCorrection,
16103
+ continuedAnswerIdsOf,
16083
16104
  BURST_PART_TYPE,
16084
16105
  DEFAULT_BURST_QUIET_MS,
16085
16106
  BURST_HOLD_MS,
@@ -16209,4 +16230,4 @@ export {
16209
16230
  InvalidWidgetAnswerError,
16210
16231
  createChatService
16211
16232
  };
16212
- //# sourceMappingURL=chunk-WMVDYLNE.js.map
16233
+ //# sourceMappingURL=chunk-56RGTTJG.js.map