@coralai/sps-cli 0.65.33 → 0.65.34

package/dist/chat-protocol/reduce.js

@@ -0,0 +1,204 @@
+import { OPTIMISTIC_ID_PREFIX } from './types.js';
+function freshPending(sessionId, turnId) {
+    return { sessionId, turnId, blocks: [], done: false, finalMessage: null };
+}
+/**
+ * 取当前回合作为基底;回合对不上(没收到 turn.pending、或新回合直接来了内容)就自建,
+ * **不丢第一个 chunk**。
+ */
+function baseFor(state, turnId) {
+    return state.pending && state.pending.turnId === turnId
+        ? state.pending
+        : freshPending(state.sessionId, turnId);
+}
+function appendMessage(messages, message) {
+    if (messages.some((m) => m.id === message.id))
+        return messages;
+    // 乐观发送的用户消息:用服务端权威版本替换,而不是并排显示两条。
+    const optIdx = messages.findIndex((m) => m.role === 'user' &&
+        m.id.startsWith(OPTIMISTIC_ID_PREFIX) &&
+        m.role === message.role &&
+        m.content === message.content);
+    if (optIdx >= 0) {
+        const next = [...messages];
+        next[optIdx] = message;
+        return next;
+    }
+    return [...messages, message];
+}
+/** 把交互块的结果落到一组消息里(已提交的历史消息)。 */
+function applyInteractionToMessages(messages, interactionId, patch) {
+    let touched = false;
+    const next = messages.map((message) => {
+        if (!message.blocks?.some((b) => b.type === 'interaction' && b.id === interactionId))
+            return message;
+        touched = true;
+        return {
+            ...message,
+            blocks: message.blocks.map((block) => block.type === 'interaction' && block.id === interactionId ? { ...block, ...patch } : block),
+        };
+    });
+    return touched ? next : messages;
+}
+/**
+ * 唯一的状态归并入口。纯函数:同样的 (state, event) 永远得到同样的结果。
+ *
+ * 事件不属于本会话 → 原样返回(切会话时别的会话的事件不该污染当前状态)。
+ */
+export function reduceChatEvent(state, event) {
+    if (event.sessionId !== state.sessionId)
+        return state;
+    // 幂等:重放/重复投递的旧事件直接丢(阶段 2 的 Last-Event-ID 补发会真的产生重复)。
+    // 🔴 只对 **> 0** 的 seq 生效:`chat.message.pending` 固定发 seq:0、用户消息干脆不带 seq,
+    // 把它们纳入游标会在回合一开始就把 pending 丢掉(lastSeq 初值也是 0)。
+    if (typeof event.seq === 'number' && event.seq > 0) {
+        if (event.seq <= state.lastSeq)
+            return state;
+        if (state.lastSeq > 0 && event.seq > state.lastSeq + 1) {
+            state = { ...state, gapDetected: true };
+        }
+        state = { ...state, lastSeq: event.seq };
+    }
+    switch (event.type) {
+        case 'message.appended':
+            return { ...state, messages: appendMessage(state.messages, event.message) };
+        case 'turn.pending':
+            return { ...state, pending: freshPending(state.sessionId, event.turnId) };
+        case 'turn.snapshot':
+            return {
+                ...state,
+                pending: { ...freshPending(state.sessionId, event.turnId), blocks: [...event.blocks] },
+            };
+        case 'text.delta': {
+            const base = baseFor(state, event.turnId);
+            const blocks = [...base.blocks];
+            const last = blocks[blocks.length - 1];
+            if (last && last.type === 'text') {
+                blocks[blocks.length - 1] = { ...last, text: last.text + event.text };
+            }
+            else {
+                blocks.push({ type: 'text', text: event.text });
+            }
+            return { ...state, pending: { ...base, blocks } };
+        }
+        case 'tool_use.started': {
+            const base = baseFor(state, event.turnId);
+            return {
+                ...state,
+                pending: {
+                    ...base,
+                    blocks: [
+                        ...base.blocks,
+                        {
+                            type: 'tool_use',
+                            id: event.id,
+                            title: event.title,
+                            kind: event.kind,
+                            status: event.status,
+                            input: event.input,
+                            locations: event.locations,
+                        },
+                    ],
+                },
+            };
+        }
+        case 'tool_use.updated': {
+            // 更新只作用于**已存在**的回合 —— 凭空自建一个只有 update 的回合没有意义。
+            if (!state.pending || state.pending.turnId !== event.turnId)
+                return state;
+            const pending = state.pending;
+            return {
+                ...state,
+                pending: {
+                    ...pending,
+                    blocks: pending.blocks.map((b) => b.type === 'tool_use' && b.id === event.id
+                        ? {
+                            ...b,
+                            status: event.status,
+                            // 首帧的 input 常为空,后续 update 才带全 —— 已有值不覆盖。
+                            input: b.input ?? event.input,
+                            locations: b.locations ?? event.locations,
+                        }
+                        : b),
+                },
+            };
+        }
+        case 'interaction.required': {
+            const base = baseFor(state, event.turnId);
+            // 同一 interactionId 重复下发(重连/重放)→ 就地更新,不叠出两张表单。
+            const existing = base.blocks.findIndex((b) => b.type === 'interaction' && b.id === event.id);
+            const block = {
+                type: 'interaction',
+                id: event.id,
+                kind: event.kind,
+                title: event.title,
+                schema: event.schema,
+                ...(event.respond ? { respond: event.respond } : {}),
+                revision: event.revision,
+                status: 'pending',
+            };
+            const blocks = [...base.blocks];
+            if (existing >= 0)
+                blocks[existing] = block;
+            else
+                blocks.push(block);
+            return { ...state, pending: { ...base, blocks } };
+        }
+        case 'interaction.updated': {
+            const patch = {
+                status: event.status,
+                revision: event.revision,
+                ...(event.answer !== undefined ? { answer: event.answer } : {}),
+            };
+            // 🔴 在途回合也要更新:表单几乎总是在回合还没结束时被提交的。
+            // (此前只更新了已提交消息,导致在途那张表单永远停在 pending。)
+            const pending = state.pending;
+            const nextPending = pending && pending.blocks.some((b) => b.type === 'interaction' && b.id === event.interactionId)
+                ? {
+                    ...pending,
+                    blocks: pending.blocks.map((b) => b.type === 'interaction' && b.id === event.interactionId ? { ...b, ...patch } : b),
+                }
+                : pending;
+            return {
+                ...state,
+                pending: nextPending,
+                messages: applyInteractionToMessages(state.messages, event.interactionId, patch),
+            };
+        }
+        case 'turn.completed': {
+            const base = baseFor(state, event.turnId);
+            // 只标记终态,**不立即提交** —— 带打字机的产品要等文本追齐;不带的收到 done 立刻 commitTurn。
+            return { ...state, pending: { ...base, done: true, finalMessage: event.message } };
+        }
+        case 'resync.required':
+            // reducer 不擅自补数据 —— 只打标记,由产品去拉快照重建(和 seq 断档同一套处理)。
+            return { ...state, gapDetected: true };
+        case 'turn.failed': {
+            const matches = !!state.pending && (!event.turnId || state.pending.turnId === event.turnId);
+            return {
+                ...state,
+                pending: matches ? null : state.pending,
+                messages: event.message ? appendMessage(state.messages, event.message) : state.messages,
+            };
+        }
+        default:
+            return state;
+    }
+}
+/**
+ * 把已收尾的回合提交进消息列表并清空在途态。
+ *
+ * 由**产品**决定时机:带打字机的等追齐后调(见 `./typewriter.ts` 的 `isDrained`),
+ * 不带的收到 `pending.done` 就调。未收尾时调用是安全的空操作。
+ */
+export function commitTurn(state) {
+    const pending = state.pending;
+    if (!pending?.done || !pending.finalMessage)
+        return state;
+    return {
+        ...state,
+        messages: appendMessage(state.messages, pending.finalMessage),
+        pending: null,
+    };
+}
+//# sourceMappingURL=reduce.js.map

package/dist/chat-protocol/reduce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reduce.js","sourceRoot":"","sources":["../../src/chat-protocol/reduce.ts"],"names":[],"mappings":"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"}

package/dist/chat-protocol/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @module        chat-protocol/types
+ * @description   对话流的**状态类型**——消息、块、进行中回合。
+ *
+ * 🔴 本目录(`src/chat-protocol/`)是**零依赖叶子模块**:不许 import 目录外的任何东西
+ * (包括 node 内置模块、sps 其它模块、任何 npm 包)。因为它要被打进三个浏览器 bundle
+ * (sps-console / coral-platform/web / gameforge/web),任何依赖都会被一起拖进去。
+ * 这条规则由 `chat-protocol.deps.test.ts` 卡死。
+ *
+ * @layer         contract
+ * @boundedContext chat
+ */
+import type { InteractionRespond } from './form.js';
+/** 消息块。与服务端持久化格式(`console/routes/chat.ts` 的 ChatMessageBlock)保持一致。 */
+export type ChatBlock = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    /** ⚠️ 历史命名:这里装的是**工具名**(如 `Read` / `exec_command`),不是标题。
+     *  改名要迁移已落盘的会话文件,不值当;产品端按工具名消费即可。 */
+    title: string;
+    kind: string;
+    status: string;
+    input?: unknown;
+    locations?: unknown;
+} | {
+    type: 'interaction';
+    id: string;
+    /** `approval` | `choices` | `form` | …(引擎侧 InteractionKind) */
+    kind: string;
+    title: string;
+    /**
+     * 已**完全展开**的规范 `FormSpec`(见 `./form.ts`)——产品端不需要认识任何模板名。
+     * 选择器(`kind:'choices'`)也是 FormSpec,只是字段都是 radio;产品可按 kind 决定
+     * 渲染成一键选项还是表单。旧会话里可能是 JSON Schema,用 `isFormSpec` 判别。
+     */
+    schema: unknown;
+    /** 答案怎么送回去;缺省(旧数据)按 'endpoint' 处理。 */
+    respond?: InteractionRespond;
+    revision: number;
+    status: 'pending' | 'answered' | 'cancelled';
+    resumeAfterSequence?: number;
+    answer?: unknown;
+};
+/** 与服务端 `console/routes/chat.ts` 的 ChatMessage 逐字段对齐(服务端是权威)。 */
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'error';
+    content: string;
+    blocks?: ChatBlock[];
+    /** 服务端按字节上限截断过正文。 */
+    truncated?: boolean;
+    ts: string;
+    status?: 'streaming' | 'complete' | 'error';
+    /** 附件绝对路径列表(仅 user 消息有)。 */
+    attachments?: string[];
+}
+/** 进行中的回合。**绑 sessionId** —— 切会话时别的会话的在途回合不该被误提交。 */
+export interface PendingTurn {
+    sessionId: string;
+    /** 服务端的 assistantId(等同 turnId)。 */
+    turnId: string;
+    blocks: ChatBlock[];
+    /** 已收到 turn.completed —— 但**尚未提交**,等产品端(打字机)追齐后调 `commitTurn`。 */
+    done: boolean;
+    finalMessage: ChatMessage | null;
+}
+export interface ChatStreamState {
+    sessionId: string;
+    messages: ChatMessage[];
+    pending: PendingTurn | null;
+    /** 最后处理的事件序号(用于幂等丢重复,见 reduce)。 */
+    lastSeq: number;
+    /** 检测到 seq 断档 —— 产品端应触发一次快照/补拉对账。reducer 不自动处理。 */
+    gapDetected: boolean;
+}
+export declare function initialChatStreamState(sessionId: string): ChatStreamState;
+/**
+ * 乐观发送的消息 id 前缀。收到服务端权威 user 消息时按此前缀 + 同 role/content 替换。
+ * 三端共用这个约定,别各造各的。
+ */
+export declare const OPTIMISTIC_ID_PREFIX = "optim-";
+//# sourceMappingURL=types.d.ts.map

package/dist/chat-protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,sEAAsE;AACtE,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX;yCACqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GACD;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEN,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,qBAAqB;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,kEAAkE;IAClE,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAEzE;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC"}

package/dist/chat-protocol/types.js

@@ -0,0 +1,9 @@
+export function initialChatStreamState(sessionId) {
+    return { sessionId, messages: [], pending: null, lastSeq: 0, gapDetected: false };
+}
+/**
+ * 乐观发送的消息 id 前缀。收到服务端权威 user 消息时按此前缀 + 同 role/content 替换。
+ * 三端共用这个约定,别各造各的。
+ */
+export const OPTIMISTIC_ID_PREFIX = 'optim-';
+//# sourceMappingURL=types.js.map

package/dist/chat-protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/chat-protocol/types.ts"],"names":[],"mappings":"AAmFA,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC"}

package/dist/chat-protocol/typewriter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @module        chat-protocol/typewriter
+ * @description   打字机效果的**可选**纯函数 helper。
+ *
+ * 为什么不放进 reducer:打字机是**展示**,不是状态语义。coral 的语音页可能想让文字跟着
+ * TTS 走,gameforge 可能压根不要动效。硬塞进 reducer 就等于强迫三端接受 console 的审美。
+ * 需要的产品调这里,不需要的直接渲染 `pending.blocks`。
+ *
+ * 状态外置成一个 `number[]`(每个块已显示的字符数),因为 reducer 的状态必须保持可比较
+ * (「同一串事件 → 深度相等」的验收标准不该被动效进度污染)。
+ *
+ * 零依赖规则见 `./types.ts` 头注释。
+ * @layer         contract
+ * @boundedContext chat
+ */
+import type { ChatBlock } from './types.js';
+/** 每个块已显示的字符数(非 text 块的位置恒为 0,占位保持下标对齐)。 */
+export type TypewriterProgress = readonly number[];
+/** 全部文本都已显示完? */
+export declare function isDrained(blocks: readonly ChatBlock[], progress: TypewriterProgress): boolean;
+/** 推进一个 tick,返回新的进度数组。已追齐时返回原数组(引用不变,便于跳过重渲染)。 */
+export declare function advanceTypewriter(blocks: readonly ChatBlock[], progress: TypewriterProgress): number[] | TypewriterProgress;
+/** 按进度裁剪出可直接渲染的块(text 块只保留已显示部分,其余原样)。 */
+export declare function renderBlocks(blocks: readonly ChatBlock[], progress: TypewriterProgress): ChatBlock[];
+//# sourceMappingURL=typewriter.d.ts.map

package/dist/chat-protocol/typewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typewriter.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/typewriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,SAAS,MAAM,EAAE,CAAC;AAenD,iBAAiB;AACjB,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAE7F;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,QAAQ,EAAE,kBAAkB,GAC3B,MAAM,EAAE,GAAG,kBAAkB,CAc/B;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,QAAQ,EAAE,kBAAkB,GAC3B,SAAS,EAAE,CAIb"}

package/dist/chat-protocol/typewriter.js

@@ -0,0 +1,36 @@
+/** 一次 tick 最多推进整体差额的 1/40(与 console 既有手感一致),至少 1 个字符。 */
+const TICK_DIVISOR = 40;
+function gapOf(block, shown) {
+    return block.type === 'text' ? Math.max(0, block.text.length - shown) : 0;
+}
+/** 块数变化时补齐/裁剪进度数组。 */
+function align(blocks, progress) {
+    const next = blocks.map((_, i) => progress[i] ?? 0);
+    return next;
+}
+/** 全部文本都已显示完? */
+export function isDrained(blocks, progress) {
+    return blocks.every((b, i) => gapOf(b, progress[i] ?? 0) === 0);
+}
+/** 推进一个 tick,返回新的进度数组。已追齐时返回原数组(引用不变,便于跳过重渲染)。 */
+export function advanceTypewriter(blocks, progress) {
+    const aligned = align(blocks, progress);
+    const totalGap = blocks.reduce((sum, b, i) => sum + gapOf(b, aligned[i] ?? 0), 0);
+    if (totalGap <= 0)
+        return progress.length === aligned.length ? progress : aligned;
+    let remaining = Math.max(1, Math.ceil(totalGap / TICK_DIVISOR));
+    return blocks.map((b, i) => {
+        const shown = aligned[i] ?? 0;
+        const gap = gapOf(b, shown);
+        if (gap <= 0 || remaining <= 0)
+            return shown;
+        const step = Math.min(gap, remaining);
+        remaining -= step;
+        return shown + step;
+    });
+}
+/** 按进度裁剪出可直接渲染的块(text 块只保留已显示部分,其余原样)。 */
+export function renderBlocks(blocks, progress) {
+    return blocks.map((b, i) => b.type === 'text' ? { ...b, text: b.text.slice(0, progress[i] ?? 0) } : b);
+}
+//# sourceMappingURL=typewriter.js.map

package/dist/chat-protocol/typewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typewriter.js","sourceRoot":"","sources":["../../src/chat-protocol/typewriter.ts"],"names":[],"mappings":"AAoBA,yDAAyD;AACzD,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,SAAS,KAAK,CAAC,KAAgB,EAAE,KAAa;IAC5C,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,sBAAsB;AACtB,SAAS,KAAK,CAAC,MAA4B,EAAE,QAA4B;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,SAAS,CAAC,MAA4B,EAAE,QAA4B;IAClF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,iBAAiB,CAC/B,MAA4B,EAC5B,QAA4B;IAE5B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClF,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IAElF,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACtC,SAAS,IAAI,IAAI,CAAC;QAClB,OAAO,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,YAAY,CAC1B,MAA4B,EAC5B,QAA4B;IAE5B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAC1E,CAAC;AACJ,CAAC"}

package/dist/console/chatEventLog.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @module        console/chatEventLog
+ * @description   每会话的**有限事件日志**,支撑 SSE 的 `id:` + `Last-Event-ID` 逐事件续传。
+ *
+ * 在此之前,chat 的 SSE 断线只能靠 snapshot / complete / 消息补拉**最终收敛**——中间那些
+ * 增量是真丢了,表现为"刷新后少一段文字"。有了游标之后,重连能从断点精确补发;
+ * 只有当断点已经滚出窗口时,才退回快照重建(`chat.resync.required`)。
+ *
+ * 边界(有意为之):
+ *  - **进程内**。多实例部署要换成 Redis Streams / 持久事件表,那是阶段 4。
+ *  - 只保 `MAX_FRAMES_PER_SESSION` 条 / `MAX_SESSIONS` 个会话,超出即淘汰——它是**传输层
+ *    补偿**,不是审计日志;权威数据始终是持久化的消息。
+ *
+ * @layer         delivery
+ * @boundedContext chat
+ */
+export interface ChatFrame {
+    /** 会话内单调递增,SSE 的 `id:` 就是它。 */
+    id: number;
+    event: string;
+    data: unknown;
+}
+/** 记一帧,返回分配到的帧号。 */
+export declare function appendFrame(sessionId: string, event: string, data: unknown): number;
+export type ReplayResult = 
+/** 断点还在窗口内:按序补发这些帧即可。 */
+{
+    kind: 'frames';
+    frames: ChatFrame[];
+}
+/** 断点已滚出窗口:客户端必须靠快照/补拉重建,不能装作无缝续上。 */
+ | {
+    kind: 'resync';
+};
+/**
+ * 取 `lastEventId` 之后的帧。
+ *
+ * 判定"滚出窗口"要**严格**:窗口里最老的帧号若已经大于 `lastEventId + 1`,说明中间那段
+ * 被淘汰了 —— 这时候宁可让客户端重建,也不能补发一段有洞的序列(有洞比没有更危险,
+ * 客户端会以为自己是完整的)。
+ */
+export declare function framesSince(sessionId: string, lastEventId: number): ReplayResult;
+/** 会话删除时清掉,别把日志留成孤儿。 */
+export declare function dropSessionLog(sessionId: string): void;
+/** 仅测试用:清空全部。 */
+export declare function resetChatEventLog(): void;
+//# sourceMappingURL=chatEventLog.d.ts.map

package/dist/console/chatEventLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatEventLog.d.ts","sourceRoot":"","sources":["../../src/console/chatEventLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAgCD,oBAAoB;AACpB,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAQnF;AAED,MAAM,MAAM,YAAY;AACtB,yBAAyB;AACvB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,SAAS,EAAE,CAAA;CAAE;AACzC,sCAAsC;GACpC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAShF;AAED,wBAAwB;AACxB,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,iBAAiB;AACjB,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/console/chatEventLog.js

@@ -0,0 +1,79 @@
+/**
+ * @module        console/chatEventLog
+ * @description   每会话的**有限事件日志**,支撑 SSE 的 `id:` + `Last-Event-ID` 逐事件续传。
+ *
+ * 在此之前,chat 的 SSE 断线只能靠 snapshot / complete / 消息补拉**最终收敛**——中间那些
+ * 增量是真丢了,表现为"刷新后少一段文字"。有了游标之后,重连能从断点精确补发;
+ * 只有当断点已经滚出窗口时,才退回快照重建(`chat.resync.required`)。
+ *
+ * 边界(有意为之):
+ *  - **进程内**。多实例部署要换成 Redis Streams / 持久事件表,那是阶段 4。
+ *  - 只保 `MAX_FRAMES_PER_SESSION` 条 / `MAX_SESSIONS` 个会话,超出即淘汰——它是**传输层
+ *    补偿**,不是审计日志;权威数据始终是持久化的消息。
+ *
+ * @layer         delivery
+ * @boundedContext chat
+ */
+/** 单会话保留的帧数。一个长回合的增量大致在几百条量级,512 够覆盖常见的断线窗口。 */
+const MAX_FRAMES_PER_SESSION = 512;
+/** 同时保留日志的会话数上限(按最近活跃淘汰),防止长跑进程无界增长。 */
+const MAX_SESSIONS = 200;
+const logs = new Map();
+function touch(sessionId) {
+    const existing = logs.get(sessionId);
+    if (existing) {
+        // Map 保持插入序:删了再塞 = 提到最近位置,便于按最久未用淘汰。
+        logs.delete(sessionId);
+        logs.set(sessionId, existing);
+        return existing;
+    }
+    const created = { next: 1, frames: [] };
+    logs.set(sessionId, created);
+    while (logs.size > MAX_SESSIONS) {
+        const oldest = logs.keys().next().value;
+        if (oldest === undefined)
+            break;
+        logs.delete(oldest);
+    }
+    return created;
+}
+/** 记一帧,返回分配到的帧号。 */
+export function appendFrame(sessionId, event, data) {
+    const log = touch(sessionId);
+    const id = log.next++;
+    log.frames.push({ id, event, data });
+    if (log.frames.length > MAX_FRAMES_PER_SESSION) {
+        log.frames.splice(0, log.frames.length - MAX_FRAMES_PER_SESSION);
+    }
+    return id;
+}
+/**
+ * 取 `lastEventId` 之后的帧。
+ *
+ * 判定"滚出窗口"要**严格**:窗口里最老的帧号若已经大于 `lastEventId + 1`,说明中间那段
+ * 被淘汰了 —— 这时候宁可让客户端重建,也不能补发一段有洞的序列(有洞比没有更危险,
+ * 客户端会以为自己是完整的)。
+ */
+export function framesSince(sessionId, lastEventId) {
+    const log = logs.get(sessionId);
+    if (!log)
+        return { kind: 'resync' };
+    // 客户端游标比服务端还新(会话重建/进程重启后帧号从 1 重来)→ 重建。
+    if (lastEventId >= log.next)
+        return { kind: 'resync' };
+    const frames = log.frames.filter((f) => f.id > lastEventId);
+    if (frames.length === 0)
+        return { kind: 'frames', frames: [] };
+    if (frames[0].id > lastEventId + 1)
+        return { kind: 'resync' };
+    return { kind: 'frames', frames };
+}
+/** 会话删除时清掉,别把日志留成孤儿。 */
+export function dropSessionLog(sessionId) {
+    logs.delete(sessionId);
+}
+/** 仅测试用:清空全部。 */
+export function resetChatEventLog() {
+    logs.clear();
+}
+//# sourceMappingURL=chatEventLog.js.map

package/dist/console/chatEventLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatEventLog.js","sourceRoot":"","sources":["../../src/console/chatEventLog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AASH,gDAAgD;AAChD,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,wCAAwC;AACxC,MAAM,YAAY,GAAG,GAAG,CAAC;AAOzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE3C,SAAS,KAAK,CAAC,SAAiB;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,QAAQ,EAAE,CAAC;QACb,qCAAqC;QACrC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAe,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,KAAa,EAAE,IAAa;IACzE,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACtB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QAC/C,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,WAAmB;IAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpC,uCAAuC;IACvC,IAAI,WAAW,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACvD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC/D,IAAI,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,GAAG,WAAW,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC/D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC;AAED,iBAAiB;AACjB,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;AACf,CAAC"}

package/dist/console/routes/chat.d.ts

@@ -11,6 +11,7 @@
  *   - 干掉原 console/sse/eventBus.ts（所有 chat-specific publish 挪到 chatBus 里）
  */
 import { Hono } from 'hono';
+import type { InteractionRespond } from '../../chat-protocol/index.js';
 import type { Logger } from '../../core/logger.js';
 import { DaemonClient } from '../../daemon/daemonClient.js';
 import type { ChatService } from '../../services/ChatService.js';
@@ -34,6 +35,8 @@ export type ChatMessageBlock = {
     type: 'interaction';
     id: string;
     kind: string;
+    /** 答案怎么送回去(见 chat-protocol/form 的 InteractionRespond);旧数据缺省按 endpoint。 */
+    respond?: InteractionRespond;
     title: string;
     schema: unknown;
     revision: number;

package/dist/console/routes/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/console/routes/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAS5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAuBjE,KAAK,gBAAgB,GAAG,IAAI,CAC1B,YAAY,EACV,eAAe,GACf,UAAU,GACV,SAAS,GACT,aAAa,GACb,uBAAuB,GACvB,UAAU,GACV,mBAAmB,GACnB,mBAAmB,CACtB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,gBAAgB,CAAC;CAC7C;AAkDD,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnH;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAoBD,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AACtD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAoFD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGpD;AAgmCD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,YAAY,GAAE,qBAA0B,GACvC,IAAI,CA8kBN;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CA6G5C"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/console/routes/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAW5B,OAAO,KAAK,EAAY,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAMjF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAO5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAuBjE,KAAK,gBAAgB,GAAG,IAAI,CAC1B,YAAY,EACV,eAAe,GACf,UAAU,GACV,SAAS,GACT,aAAa,GACb,uBAAuB,GACvB,UAAU,GACV,mBAAmB,GACnB,mBAAmB,CACtB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,kBAAkB,CAAC,EAAE,MAAM,gBAAgB,CAAC;CAC7C;AAmED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GACnH;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC5C,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAoBD,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AACtD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAoFD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGpD;AAmnCD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,YAAY,GAAE,qBAA0B,GACvC,IAAI,CA+kBN;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CA+I5C"}