@ykurilov/agent-chat-core 0.76.0 → 0.77.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ykurilov/agent-chat-core
 
+## 0.77.0
+
+### Patch Changes
+
+- f4c13da: Сценарий может сохранить подтверждённую судьёй веху отдельно от перехода и потребовать её вместе с актуальным вопросом человека. Например, публикация своего приложения больше не забывается после шести реплик, а старый интерес к курсу не запускает переход при поздней публикации.
+  
+  Серверные `confirmations` и `exitGuards` включаются по желанию. Квитанция привязана к человеку, чату, сценарию, ветке и revision критерия; модельные факты её не устанавливают. Поля `flow.confirmations`, `flow.confirmationCheck` и `flow.checkedTransition` защищены от записи и удаления через `model.state`, включая замену родительского `flow`. `revokeConfirmation` позволяет backend исправить атрибуцию. Положительная проверка и решение сохраняются вместе до перехода с защитой от устаревших записей и повторов. Стабильные инструкции и инструменты модели не меняются.
+  
+  `previewMigration` и опция `requiresConfirmation` у `migrateChats` оставляют разговоры без подходящей квитанции на прежней версии. Старый путь или поле карточки не считаются доказательством. Увеличения контекста судьи, автоматической проверки владения доменом и изменений JSON редактора нет.
+  
+  Подключение, отмена, миграция и ограничения: [docs/flow-confirmations.md](../../docs/flow-confirmations.md). Без новых опций поведение прежнее; SQL-миграций нет. Приложение обрабатывает `busy`/`stale` при отмене и само определяет доверенный маршрут исправления атрибуции.
+
 ## 0.76.0
 
 No changes in this release.

package/dist/{chunk-6KHSUGHE.js → chunk-BQTUOC3T.js}

@@ -258,6 +258,13 @@ function createAppStateWriter(context) {
     return keys;
   }
   function commit(record, next) {
+    if (!context.serverFlowChecks) {
+      for (const field of ["confirmations", "confirmationCheck", "checkedTransition"]) {
+        if (JSON.stringify(valueAt(current, ["flow", field])) !== JSON.stringify(valueAt(next, ["flow", field]))) {
+          throw new TypeError(`state: flow.${field} \u2014 \u0440\u0435\u0437\u0443\u043B\u044C\u0442\u0430\u0442 \u0441\u0435\u0440\u0432\u0435\u0440\u043D\u043E\u0439 \u043F\u0440\u043E\u0432\u0435\u0440\u043A\u0438 SDK; \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442 \u043C\u043E\u0434\u0435\u043B\u0438 \u043D\u0435 \u043C\u0435\u043D\u044F\u0435\u0442 \u0438 \u043D\u0435 \u0443\u0434\u0430\u043B\u044F\u0435\u0442 \u0435\u0433\u043E`);
+        }
+      }
+    }
     context.write(record);
     current = next;
   }
@@ -10022,6 +10029,15 @@ async function callWithRetries2(handler, input, timeoutMs, attempts) {
   }
 }
 
+// src/app-state/flow-state-commit.ts
+var ports = /* @__PURE__ */ new WeakMap();
+function registerFlowStateCommit(service, commit) {
+  ports.set(service, commit);
+}
+function flowStateCommitter(service) {
+  return ports.get(service);
+}
+
 // src/agent-run/reply-check-types.ts
 var DEFAULT_REPLY_CHECKS_WEB = "replace";
 function resolveReplyChecks(setting) {
@@ -12552,6 +12568,7 @@ function checkedResult(result, state, chatId) {
   const records = [];
   const writer = createAppStateWriter({
     base: state,
+    serverFlowChecks: true,
     write: (record) => records.push(record),
     logError: () => {
     },
@@ -14906,6 +14923,43 @@ function createChatService(input) {
     };
   }
   abandonedBurstReceivers.set(service, receivingAbandonedBurst);
+  registerFlowStateCommit(service, async (input2) => {
+    if (![input2.flowId, input2.revision].every((value) => typeof value === "string" && value.trim().length > 0 && value.length <= 200)) throw new TypeError("flow commit: flowId/revision \u2014 \u043D\u0435\u043F\u0443\u0441\u0442\u044B\u0435 \u0441\u0442\u0440\u043E\u043A\u0438 \u0434\u043E 200 \u0437\u043D\u0430\u043A\u043E\u0432");
+    if (typeof input2.idempotencyKey !== "string" || !input2.idempotencyKey.trim() || input2.idempotencyKey.length > 200) {
+      throw new TypeError("flow commit: idempotencyKey \u2014 \u043D\u0435\u043F\u0443\u0441\u0442\u0430\u044F \u0441\u0442\u0440\u043E\u043A\u0430 \u0434\u043E 200 \u0437\u043D\u0430\u043A\u043E\u0432");
+    }
+    if (!input2.flow || typeof input2.flow !== "object" || Array.isArray(input2.flow)) throw new TypeError("flow commit: flow \u2014 JSON-\u043E\u0431\u044A\u0435\u043A\u0442");
+    const chat = await storage.getChat(input2.chatId);
+    if (!chat || chat.ownerId !== input2.ownerId || deleting.has(input2.chatId)) return { status: "not_found" };
+    if (closing) return { status: "busy" };
+    const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([input2.ownerId, input2.chatId, input2.flowId, input2.revision, input2.idempotencyKey])));
+    const operationId = `flow-state:${Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("")}`;
+    try {
+      return await whileStarting(input2.chatId, async () => {
+        const { branch } = await loadTree(input2.chatId);
+        const before = foldAppState(branch);
+        const writer = createAppStateWriter({ base: before, write: () => {
+        }, logError, chatId: input2.chatId, serverFlowChecks: true });
+        writer.set("flow", input2.flow);
+        writer.close();
+        const record = { set: { flow: writer.values().flow } };
+        const earlier = await storage.getMessage(operationId);
+        if (earlier) {
+          if (JSON.stringify(earlier.parts) !== JSON.stringify([appStatePart(record)])) throw new TypeError("flow commit: idempotencyKey \u0443\u0436\u0435 \u0438\u0441\u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u043D \u0441 \u0434\u0440\u0443\u0433\u0438\u043C payload");
+          return branch.at(-1)?.id === operationId ? { status: "same", atMessageId: operationId } : { status: "stale" };
+        }
+        const head = branch.at(-1)?.id ?? null;
+        if (head !== input2.expectedAtMessageId) return { status: "stale" };
+        const message = stateMessage({ chatId: input2.chatId, parentId: head, record });
+        await storage.insertMessage({ ...message, id: operationId });
+        await branchChanged(input2.ownerId, input2.chatId, "flowCommit", before);
+        return { status: "applied", atMessageId: operationId };
+      });
+    } catch (error) {
+      if (error instanceof ChatBusyError) return { status: "busy" };
+      throw error;
+    }
+  });
   return service;
   function isDetachedAnswer(last, runningId) {
     return runningId === null && last?.status === "streaming" && !liveAnswerIds.has(last.id);
@@ -15135,6 +15189,7 @@ export {
   DEFAULT_AFTER_TURN_ATTEMPTS,
   DEFAULT_STATE_CHANGED_TIMEOUT_MS,
   DEFAULT_STATE_CHANGED_ATTEMPTS,
+  flowStateCommitter,
   DEFAULT_REPLY_CHECKS_WEB,
   resolveReplyChecks,
   THOUGHT_TITLE_USAGE_SOURCE,
@@ -15182,4 +15237,4 @@ export {
   InvalidWidgetAnswerError,
   createChatService
 };
-//# sourceMappingURL=chunk-6KHSUGHE.js.map
+//# sourceMappingURL=chunk-BQTUOC3T.js.map