@ykurilov/agent-chat-flows 0.76.0 → 0.77.0

package/dist/react.js

@@ -3,7 +3,7 @@ import {
   FLOW_DEADLINE_NOTICE,
   FLOW_TIMER_NOTICE,
   fieldValueText
-} from "./chunk-DQQ2GCQ2.js";
+} from "./chunk-CZ3EDVYW.js";
 import {
   ANY_STATE_LAYOUT_KEY,
   DEFAULT_LATE_START_HOURS,
@@ -31,7 +31,7 @@ import {
   startRun,
   stateById,
   timerDueAt
-} from "./chunk-2LAVG3YR.js";
+} from "./chunk-RMWVLMGY.js";
 
 // src/react/flow-labels.ts
 import { createContext, createElement, useContext } from "react";

package/dist/types/engine/confirmation.d.ts

@@ -0,0 +1,35 @@
+/** Ссылка на проверку, зарегистрированную сервером приложения, а не моделью или JSON сценария. */
+export interface FlowConfirmationRef {
+    key: string;
+    revision: string;
+}
+export interface FlowConfirmationScope {
+    ownerId: string;
+    chatId: string;
+    flowId: string;
+}
+export interface FlowConfirmationReceipt extends FlowConfirmationRef {
+    status: "confirmed";
+    scope: FlowConfirmationScope;
+    criterionHash: string;
+    checkedAt: number;
+    source: {
+        kind: "judge";
+        versionId: string;
+        answerId: string;
+        humanMessageId: string;
+        probability: number;
+    };
+}
+/** Tombstone: прежнее доказательство не используется для повторного подтверждения после исправления. */
+export interface FlowConfirmationRevocation extends FlowConfirmationRef {
+    status: "revoked";
+    versionId: string;
+    scope: FlowConfirmationScope;
+    criterionHash: string;
+    revokedAt: number;
+    afterMessageId: string | null;
+    reason: string;
+    operationKey: string;
+}
+export type FlowConfirmationRecord = FlowConfirmationReceipt | FlowConfirmationRevocation;

package/dist/types/engine/flow-run.d.ts

@@ -1,3 +1,4 @@
+import type { FlowConfirmationRecord, FlowConfirmationRef } from "./confirmation.js";
 /** Ключ в состоянии чата (`ChatState`), под которым лежит `FlowRun`. */
 export declare const FLOW_STATE_KEY = "flow";
 /** Сколько последних шагов пути хранить в чате. */
@@ -31,6 +32,22 @@ export interface FlowPathEntry {
 }
 /** Где чат в сценарии. Хранится в состоянии чата под `FLOW_STATE_KEY`; все времена — мс с 1970 года. */
 export interface FlowRun {
+    /** Проверки сервера: на этой ветке, для этого человека/чата/сценария. Модель их не устанавливает. */
+    confirmations?: Record<string, FlowConfirmationRecord>;
+    /** Идемпотентность полного afterTurn check; отрицательный результат не переносится на следующий human turn. */
+    confirmationCheck?: {
+        answerId: string;
+        configurationHash: string;
+    };
+    /** Receipt и решение сохраняются одной записью до применения перехода. */
+    checkedTransition?: {
+        versionId: string;
+        transition: Transition;
+        requires: FlowConfirmationRef;
+        criterionHash: string;
+        answerId: string;
+        humanMessageId: string;
+    };
     state: string;
     /** Когда вошли в текущее состояние. */
     enteredAt: number;

package/dist/types/engine/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./flow-run.js";
+export type * from "./confirmation.js";
 export { nextTransition, type FlowEvent } from "./next-transition.js";
 export { startRun, applyTransition, noteHumanMessage, noteAgentAnswer, noteRejectedClaim, claimAllowed, noteSideQuestion, } from "./run-updates.js";
 export { dataConditionHolds, fieldValueFits } from "./data-conditions.js";

package/dist/types/runtime/confirmation-judge.d.ts

@@ -0,0 +1,26 @@
+import { type TurnResult } from "@ykurilov/agent-chat-core";
+import type { FlowRun, Transition } from "../engine/flow-run.js";
+import { type FlowConfirmations } from "./confirmations.js";
+import type { FlowJudge, FlowPort, JudgeMessage } from "./flow-types.js";
+import type { PinnedFlow } from "./flow-events.js";
+/** Положительный check и guarded decision — одна служебная запись до исполнения перехода. */
+export declare function judgeConfirmations(input: {
+    confirmations: FlowConfirmations;
+    pinned: PinnedFlow;
+    run: FlowRun;
+    result: TurnResult;
+    port: FlowPort;
+    atMessageId: string | null;
+    judge: FlowJudge;
+    threshold: number;
+    now: number;
+    conditions: Array<{
+        exitId: string;
+        text: string;
+    }>;
+    messages: JudgeMessage[];
+    goal?: string;
+}): Promise<{
+    transition?: Transition;
+    saved: boolean;
+}>;

package/dist/types/runtime/confirmation-migration.d.ts

@@ -0,0 +1,12 @@
+import type { FlowStore } from "../store/flow-store.js";
+import type { AgentFlowHandle, FlowPort } from "./flow-types.js";
+import { type FlowConfirmations } from "./confirmations.js";
+/** Strict preview читает исходный run до map. Legacy path/card не являются квитанцией SDK. */
+export declare function previewConfirmedMigration(input: Parameters<AgentFlowHandle["previewMigration"]>[0], deps: {
+    store: FlowStore;
+    confirmations: FlowConfirmations;
+    portFor: (chat: {
+        ownerId: string;
+        chatId: string;
+    }) => Promise<FlowPort>;
+}): ReturnType<AgentFlowHandle["previewMigration"]>;

package/dist/types/runtime/confirmations.d.ts

@@ -0,0 +1,40 @@
+import type { FlowConfirmationRecord, FlowConfirmationRef, FlowConfirmationScope } from "../engine/confirmation.js";
+import type { FlowRun } from "../engine/flow-run.js";
+import type { AgentFlow } from "../format/flow-format.js";
+/** Server-only: условие проверяется независимо от выхода и сохраняется только после положительного judge. */
+export interface FlowConfirmationSpec extends FlowConfirmationRef {
+    flowId: string;
+    states: readonly string[];
+    judge: string;
+}
+/** Серверный guard одного judge-выхода. Свежий интерес не превращается в durable флаг. */
+export interface FlowExitGuard {
+    flowId: string;
+    state: string;
+    exitId: string;
+    requires: FlowConfirmationRef;
+    judgeWindow: "current-human-turn";
+}
+export declare const confirmationHash: (spec: FlowConfirmationSpec) => string;
+export declare function confirmationHolds(record: FlowConfirmationRecord | undefined, spec: FlowConfirmationSpec, scope: FlowConfirmationScope): boolean;
+/** Настройка фиксируется на сервере. Отсутствующая/устаревшая revision означает unknown. */
+export declare function createConfirmations(specs?: readonly FlowConfirmationSpec[], guards?: readonly FlowExitGuard[]): {
+    validate(flowId: string, flow: AgentFlow): void;
+    forState: (flowId: string, state: string) => FlowConfirmationSpec[];
+    specFor: (flowId: string, ref: FlowConfirmationRef) => FlowConfirmationSpec | undefined;
+    guardFor: (flowId: string, state: string, exitId: string) => FlowExitGuard | undefined;
+    revision: (flowId: string) => string;
+    allows(scope: FlowConfirmationScope, run: FlowRun, exitId: string): boolean;
+};
+export type FlowConfirmations = ReturnType<typeof createConfirmations>;
+export interface FlowRevokeConfirmationInput extends FlowConfirmationRef, FlowConfirmationScope {
+    expectedAtMessageId: string | null;
+    idempotencyKey: string;
+    reason: string;
+}
+export type FlowRevokeConfirmationResult = {
+    status: "applied" | "same";
+    atMessageId: string;
+} | {
+    status: "stale" | "busy" | "not_found";
+};

package/dist/types/runtime/flow-events.d.ts

@@ -24,6 +24,7 @@ export interface PinnedFlow {
 }
 /** Что общего у частей сценария в службе чата: хранилище, часы, сценарий чата и отчёт о переходах. */
 export interface FlowRuntime {
+    confirmations?: import("./confirmations.js").FlowConfirmations;
     store: FlowStore;
     now(): number;
     logError(message: string): void;

package/dist/types/runtime/flow-types.d.ts

@@ -537,6 +537,8 @@ export interface ChatsByStateOptions extends FlowChatSelection {
     exceptVersionId?: string;
 }
 export interface MigrateChatsInput extends FlowChatSelection {
+    /** Strict: без подходящего SDK receipt чат остаётся на исходной immutable версии. */
+    requiresConfirmation?: import("../engine/confirmation.js").FlowConfirmationRef;
     flowId: string;
     toVersionId: string;
     /** Куда перевести чаты из состояний, которых нет в новой версии: id старого → id нового. */
@@ -580,6 +582,9 @@ export interface FlowChatOptions {
     appNoticeViews?: AppNoticeViews;
 }
 export interface AgentFlowOptions {
+    /** Серверные подтверждения. Не поля карточки, не инструменты записи фактов и не JSON редактора. */
+    confirmations?: readonly import("./confirmations.js").FlowConfirmationSpec[];
+    exitGuards?: readonly import("./confirmations.js").FlowExitGuard[];
     /** Какой сценарий у чата; `null` — чат без сценария. Зовётся, пока чат не закреплён за версией. */
     loadFlow: (input: {
         ownerId: string;
@@ -628,6 +633,19 @@ export interface FlowSignalInput {
     wakeAgent?: boolean;
 }
 export interface AgentFlowHandle {
+    /** Read-only strict preview. Старый path/card/currentState не восстанавливают proof. */
+    previewMigration(input: Pick<MigrateChatsInput, "flowId" | "toVersionId" | "requiresConfirmation" | "chatIds" | "filter" | "includeEnded" | "includeTestChats"> & {
+        requiresConfirmation: import("../engine/confirmation.js").FlowConfirmationRef;
+    }): Promise<{
+        eligible: string[];
+        keepOriginal: Array<{
+            chatId: string;
+            status: "ambiguous";
+            reason: string;
+        }>;
+    }>;
+    /** Только доверенный backend: исправление атрибуции. busy/stale требуют обработки приложением. */
+    revokeConfirmation(input: import("./confirmations.js").FlowRevokeConfirmationInput): Promise<import("./confirmations.js").FlowRevokeConfirmationResult>;
     /** Склеивает сценарий с настройками службы чата: инструкция, инструменты, блоки, `prepareTurn`, `afterTurn`. */
     withChat<T extends FlowChatOptions>(options: T): T;
     /** Служба чата (`attach(service)`, как в 0.48) или служба на чат и своя доставка. */

package/dist/types/runtime/index.d.ts

@@ -1,4 +1,6 @@
 export { createAgentFlow } from "./agent-flow.js";
+export type { FlowConfirmationSpec, FlowExitGuard, FlowRevokeConfirmationInput, FlowRevokeConfirmationResult } from "./confirmations.js";
+export type * from "../engine/confirmation.js";
 export { FLOW_SERVICE_BLOCKS } from "./flow-service-blocks.js";
 export type * from "./flow-types.js";
 export { DEFAULT_JUDGE_MODEL, DEFAULT_JUDGE_THRESHOLD, DEFAULT_JUDGE_TIMEOUT_MS } from "./judge.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykurilov/agent-chat-flows",
-  "version": "0.76.0",
+  "version": "0.77.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -56,13 +56,13 @@
     "ai": "7.0.122",
     "drizzle-orm": "^0.45.3",
     "zod": "^4.6.5",
-    "@ykurilov/agent-chat-core": "0.76.0"
+    "@ykurilov/agent-chat-core": "0.77.0"
   },
   "peerDependencies": {
     "better-sqlite3": "^13.0.3",
     "pg": "^8.23.0",
     "react": "^19.3.0",
-    "@ykurilov/agent-chat-react": "^0.76.0"
+    "@ykurilov/agent-chat-react": "^0.77.0"
   },
   "peerDependenciesMeta": {
     "@ykurilov/agent-chat-react": {
@@ -90,7 +90,7 @@
     "pg": "^8.23.0",
     "react": "^19.3.0",
     "tsx": "4.23.15",
-    "@ykurilov/agent-chat-react": "0.76.0"
+    "@ykurilov/agent-chat-react": "0.77.0"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs",