@ykurilov/agent-chat-core 0.100.1 → 0.101.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,15 @@
1
1
  # @ykurilov/agent-chat-core
2
2
 
3
+ ## 0.101.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 7400938: Новая серверная операция `service.replaceGreeting({ ownerId, chatId, text, previousText?, dryRun? })` меняет текст приветствия (`greeting.text`) в уже созданном чате. Вся переписка после него, id сообщения и даты не меняются. Итог по каждому чату — `status`: `replaced`, `would_replace` (пробный прогон `dryRun`), `unchanged` (текст уже такой), `not_a_greeting` (с `reason`), `chat_not_found`, `busy` (идёт ход — ничего не записано, повторить позже). Меняется только сообщение, которое точно приветствие. Новые приветствия помечены началом id `greeting-` (`GREETING_ID_PREFIX`); приветствия старых чатов узнаются по строгим признакам (`recognizedBy: "signs"`), для них есть страховка `previousText`.
8
+
9
+ Открытые вкладки получают событие наблюдения `greeting-replaced` и перечитывают историю без перезагрузки; клиенты до 0.101.0 это событие пропускают. Модель видит новый текст со следующего хода, кэш модели один раз читается заново; приветствие внутри сводки автосжатия (`compacted: true`) модель видит сводкой. Хранилища получили необязательный метод `replaceFinishedMessageParts` (в памяти, SQLite, PostgreSQL — без новой схемы и миграций; флаг общих тестов `finishedPartsReplace`).
10
+
11
+ Обновление ничего не требует. Чтобы обновить приветствие в старых чатах: обновить все пакеты SDK одной версией, пройти по своим чатам скриптом с `dryRun: true`, проверить итоги, затем без `dryRun`. Своё хранилище реализует `replaceFinishedMessageParts`. Подробно: docs/in-product-agent.md, раздел «Замена приветствия в готовых чатах».
12
+
3
13
  ## 0.100.1
4
14
 
5
15
  No changes in this release.
package/README.md CHANGED
@@ -92,7 +92,7 @@ import type { ChatStorage } from "@ykurilov/agent-chat-core";
92
92
  - Закрытый чат: `service.closeChat({ ownerId, chatId, code, message })` и `reopenChat({ ownerId, chatId })` (события `chat-closed`, `chat-reopened`), из инструмента — `model.closeChat({ code, message })`. Закрытие — запись `$closed` на ветке: из инструмента — в ответе сразу при вызове, из кода — служебной записью в конце ветки (идёт ход — после него). Правка, «Переделать», выбор ветки и правка ответа до точки закрытия открывают чат; закрыть навсегда — правами (`chatCapabilities` видит `chat.closed`). Закрытие побеждает паузу: ждущие подтверждения и виджеты закрываются отказом, как при «Стопе». В закрытом чате отправка, «Повторить», подтверждения и виджеты — `ChatClosedError`; служебные сообщения пишутся без хода. `listChats` отдаёт `closed` — копию закрытия текущей ветки (`setChatClosed`); права и история берут закрытие с ветки, не записавшуюся копию дописывает следующее открытие истории. Закрытие чатов 0.27 переносится в запись лениво, при первой правке или смене ветки.
93
93
  - `beforeCreateChat({ userId, origin? })` — можно ли человеку завести новый чат (`createChat`): `{ code, message }` → `ChatCreationRefusedError`. Чаты объектов и импорт хук не спрашивают. У чата `closed?: { code, message }`, хранилище — необязательный `setChatClosed(chatId, closed | null)`.
94
94
  - Чат объекта: `service.openSubjectChat({ ownerId, key, data?, title?, greeting? })` → `{ chat, created }`, один чат на ключ у человека. Инструменты получают `model.subject`, итог хода — `turn.subject`. `listChats(userId, { subjects })` — по умолчанию без чатов объектов.
95
- - Приветствие: `createChat(userId, { greeting: { text } })` — первое сообщение от агента без вызова модели.
95
+ - Приветствие: `createChat(userId, { greeting: { text } })` — первое сообщение от агента без вызова модели. Заменить текст приветствия в готовом чате — `service.replaceGreeting({ ownerId, chatId, text, previousText?, dryRun? })` → `status`: `replaced`, `would_replace`, `unchanged`, `not_a_greeting`, `chat_not_found`, `busy`; событие `greeting-replaced` ([подробнее](../../docs/in-product-agent.md#замена-приветствия-в-готовых-чатах-с-01010)).
96
96
  - Импорт: `service.importChat({ ownerId, chat, messages })` → `{ chatId }`; без хода, памяти, расхода и лимитов. `chat.state` и `chat.closed` переносят состояние чата и закрытие: `getChatState` видит их сразу.
97
97
  - `staffOfChat` и `model.staff` — для песочницы: при `model.staff` инструменты не пишут в данные `ownerId`.
98
98
  - Своё хранилище: `findChatBySubject`, `importChat`, `setAfterTurnState`, `listPendingAfterTurn` — только для включённых возможностей; общие тесты с флагами `subjectChats`, `importChat`, `afterTurnState`.
@@ -10837,6 +10837,22 @@ function numberedImageParts(history, parts) {
10837
10837
  });
10838
10838
  }
10839
10839
 
10840
+ // src/subject-chats/greeting-replacement.ts
10841
+ var GREETING_ID_PREFIX = "greeting-";
10842
+ function findGreeting(chat, messages, branch) {
10843
+ const first = branch[0];
10844
+ if (!first) return { ok: false, reason: "empty_chat" };
10845
+ const [part, ...extra] = first.parts;
10846
+ const plainAnswer = first.role === "assistant" && first.parentId === null && first.status === "complete" && first.modelId === null && first.providerId === null && first.usage === null && first.error === null && extra.length === 0 && part?.type === "text" && typeof part.text === "string";
10847
+ if (!plainAnswer) return { ok: false, reason: "first_message_not_greeting" };
10848
+ const text = part.text;
10849
+ if (first.id.startsWith(GREETING_ID_PREFIX)) return { ok: true, message: first, text, recognizedBy: "marker" };
10850
+ const sameDateAsChat = Date.parse(first.createdAt) === Date.parse(chat.createdAt);
10851
+ const onlyRoot = messages.every((message) => message.parentId !== null || message.id === first.id);
10852
+ if (!sameDateAsChat || !onlyRoot) return { ok: false, reason: "first_message_not_greeting" };
10853
+ return { ok: true, message: first, text, recognizedBy: "signs" };
10854
+ }
10855
+
10840
10856
  // src/subject-chats/subject-chats.ts
10841
10857
  var SUBJECT_KEY_MAX_LENGTH = 200;
10842
10858
  var SUBJECT_DATA_MAX_BYTES = CHAT_DATA_MAX_BYTES;
@@ -11008,7 +11024,7 @@ function importedStateRecords(state, logError) {
11008
11024
  return records;
11009
11025
  }
11010
11026
  function greetingMessage(chatId, greeting, createdAt) {
11011
- return newStoredMessage({ id: crypto.randomUUID(), chatId, role: "assistant", parts: [{ type: "text", text: greeting.text }], createdAt });
11027
+ return newStoredMessage({ id: `${GREETING_ID_PREFIX}${crypto.randomUUID()}`, chatId, role: "assistant", parts: [{ type: "text", text: greeting.text }], createdAt });
11012
11028
  }
11013
11029
  function withoutSubjectData(chat) {
11014
11030
  if (!("subjectData" in chat) && !("data" in chat)) return chat;
@@ -12315,6 +12331,9 @@ function createCacheMissWatch(options2) {
12315
12331
  if (chats.size > MAX_REMEMBERED_CHATS) chats.delete(chats.keys().next().value);
12316
12332
  }
12317
12333
  return {
12334
+ forget(chatId) {
12335
+ chats.delete(chatId);
12336
+ },
12318
12337
  forRequest(request) {
12319
12338
  const modelKey = `${request.providerId}/${request.modelId}`;
12320
12339
  const earlier = chats.get(request.chatId);
@@ -14823,6 +14842,36 @@ function createChatService(input) {
14823
14842
  chatEvents.emit({ type: "chat-data-changed", ownerId: updated.ownerId, chatId });
14824
14843
  return structuredClone(chatDataOfInput(updated) ?? {});
14825
14844
  },
14845
+ async replaceGreeting({ ownerId, chatId, text, previousText, dryRun }) {
14846
+ assertGreeting({ text });
14847
+ if (!storage.replaceFinishedMessageParts) throw new Error("\u0417\u0430\u043C\u0435\u043D\u0430 \u043F\u0440\u0438\u0432\u0435\u0442\u0441\u0442\u0432\u0438\u044F \u0442\u0440\u0435\u0431\u0443\u0435\u0442 \u0445\u0440\u0430\u043D\u0438\u043B\u0438\u0449\u0430 \u0441 replaceFinishedMessageParts: \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.");
14848
+ const chat = await storage.getChat(chatId);
14849
+ if (!chat || chat.ownerId !== ownerId) return { status: "chat_not_found", chatId };
14850
+ let replaced;
14851
+ try {
14852
+ const result = await whileStarting(chatId, async () => {
14853
+ const [{ messages, branch }, compactions] = await Promise.all([loadTree(chatId), storage.listCompactions(chatId)]);
14854
+ const found = findGreeting(chat, messages, branch);
14855
+ if (!found.ok) return { status: "not_a_greeting", chatId, reason: found.reason };
14856
+ if (previousText !== void 0 && previousText !== found.text) return { status: "not_a_greeting", chatId, reason: "previous_text_mismatch" };
14857
+ const known = { chatId, messageId: found.message.id, recognizedBy: found.recognizedBy, compacted: activeCompaction(branch, compactions) !== null };
14858
+ if (found.text === text) return { status: "unchanged", ...known };
14859
+ if (dryRun) return { status: "would_replace", ...known, previousText: found.text };
14860
+ const written = await storage.replaceFinishedMessageParts(found.message.id, { expectedParts: found.message.parts, parts: [{ type: "text", text }] });
14861
+ if (!written) return { status: "busy", chatId };
14862
+ replaced = found.message.id;
14863
+ return { status: "replaced", ...known, previousText: found.text };
14864
+ }, "required");
14865
+ if (replaced) {
14866
+ cacheMissWatch?.forget(chatId);
14867
+ chatEvents.emit({ type: "greeting-replaced", ownerId, chatId, messageId: replaced });
14868
+ }
14869
+ return result;
14870
+ } catch (error) {
14871
+ if (error instanceof ChatBusyError) return { status: "busy", chatId };
14872
+ throw error;
14873
+ }
14874
+ },
14826
14875
  async getChatData(userId, chatId) {
14827
14876
  const chat = await ownChat(userId, chatId);
14828
14877
  return structuredClone(chatDataOfInput(chat) ?? {});
@@ -15781,6 +15830,7 @@ export {
15781
15830
  DEFAULT_TEXT_MODE_NOTE,
15782
15831
  CHAT_IMAGE_NUMBER_PART,
15783
15832
  chatImageReferences,
15833
+ GREETING_ID_PREFIX,
15784
15834
  SUBJECT_KEY_MAX_LENGTH,
15785
15835
  SUBJECT_DATA_MAX_BYTES,
15786
15836
  GREETING_MAX_LENGTH,
@@ -15806,4 +15856,4 @@ export {
15806
15856
  InvalidWidgetAnswerError,
15807
15857
  createChatService
15808
15858
  };
15809
- //# sourceMappingURL=chunk-YVM6GGKN.js.map
15859
+ //# sourceMappingURL=chunk-ITXLUAPJ.js.map