@coralai/sps-cli 0.65.33 → 0.65.34

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

@@ -0,0 +1,131 @@
+/**
+ * @module        chat-protocol/events
+ * @description   对话流的**唯一页面协议** `ChatStreamEvent`,以及现网 SSE 事件名 → 规范事件
+ *                的适配器。
+ *
+ * 为什么留适配器而不是直接改 SSE 事件名:现网三个前端都在监听 `chat.message.*`,
+ * 一次性改名会同时打断三端。适配器让**协议先统一、线上名后收敛**——先把三端搬到同一个
+ * reducer 上,线协议的清理是之后一个纯服务端动作。
+ *
+ * 零依赖规则见 `./types.ts` 头注释。
+ * @layer         contract
+ * @boundedContext chat
+ */
+import type { InteractionRespond } from './form.js';
+import type { ChatBlock, ChatMessage } from './types.js';
+/**
+ * 协议版本。**不认识的版本要大声报错,不许静默降级**——版本不齐必须是一个明确的错误,
+ * 而不是又一个"两个页面显示不一样"的幽灵。
+ */
+export declare const CHAT_PROTOCOL_VERSION = 1;
+/** 规范事件。名字按 `<名词>.<动作>`,名词与消息块类型一致。 */
+export type ChatStreamEvent = 
+/** 回合开始(还没有任何内容)。 */
+{
+    type: 'turn.pending';
+    sessionId: string;
+    turnId: string;
+    seq?: number;
+}
+/** 断线重连/切回时的在途快照:blocks 是当前完整状态,直接覆盖。 */
+ | {
+    type: 'turn.snapshot';
+    sessionId: string;
+    turnId: string;
+    blocks: ChatBlock[];
+    seq?: number;
+} | {
+    type: 'text.delta';
+    sessionId: string;
+    turnId: string;
+    text: string;
+    seq?: number;
+} | {
+    type: 'tool_use.started';
+    sessionId: string;
+    turnId: string;
+    id: string;
+    title: string;
+    kind: string;
+    status: string;
+    input?: unknown;
+    locations?: unknown;
+    seq?: number;
+} | {
+    type: 'tool_use.updated';
+    sessionId: string;
+    turnId: string;
+    id: string;
+    status: string;
+    input?: unknown;
+    locations?: unknown;
+    seq?: number;
+}
+/** 需要用户交互(表单 / 选择器 / 审批)。schema 已在引擎侧完全展开。 */
+ | {
+    type: 'interaction.required';
+    sessionId: string;
+    turnId: string;
+    id: string;
+    kind: string;
+    title: string;
+    schema: unknown;
+    /** 答案怎么送回去(见 ./form 的 InteractionRespond)。 */
+    respond?: InteractionRespond;
+    revision: number;
+    seq?: number;
+}
+/** 交互有了结果。**同时作用于在途回合与已提交消息**——用户常在回合仍在跑时提交表单。 */
+ | {
+    type: 'interaction.updated';
+    sessionId: string;
+    interactionId: string;
+    status: 'answered' | 'cancelled';
+    revision: number;
+    answer?: unknown;
+    seq?: number;
+}
+/** 一条权威消息落库(用户消息,或补拉到的历史)。 */
+ | {
+    type: 'message.appended';
+    sessionId: string;
+    message: ChatMessage;
+    seq?: number;
+}
+/** 回合成功收尾,携带完整权威消息(增量丢失也能靠它自愈)。 */
+ | {
+    type: 'turn.completed';
+    sessionId: string;
+    turnId: string;
+    message: ChatMessage;
+    seq?: number;
+}
+/** 回合以错误/中断收尾。 */
+ | {
+    type: 'turn.failed';
+    sessionId: string;
+    turnId?: string;
+    message?: ChatMessage;
+    seq?: number;
+}
+/**
+ * 续传游标已失效(断点滚出服务端事件窗口)。**不能装作无缝续上** —— 客户端必须重新
+ * 拉取会话快照重建,否则会拿着一段有洞的序列以为自己是完整的。
+ */
+ | {
+    type: 'resync.required';
+    sessionId: string;
+    reason?: string;
+    seq?: number;
+};
+/** 现网 SSE 事件名清单(订阅用)。 */
+export declare const WIRE_EVENT_NAMES: readonly ["chat.message", "chat.message.pending", "chat.message.snapshot", "chat.message.chunk.text", "chat.message.chunk.tool_use", "chat.message.chunk.tool_update", "chat.message.chunk.interaction", "chat.message.interaction.updated", "chat.message.complete", "chat.message.error", "chat.resync.required"];
+/**
+ * 把一条现网 SSE 事件翻成规范事件。不认识 / 字段缺失 → 返回 null(调用方忽略即可)。
+ * 解析 JSON 失败由调用方处理。
+ *
+ * `streamSessionId` = 这条 SSE 流所属的会话。**流的归属以 URL 为准**(`/stream/chat/:id`),
+ * payload 里的 `sessionId` 只作交叉校验:两者都在且不一致 → 丢弃(串台防线)。
+ */
+export declare function fromWireEvent(name: string, data: unknown, streamSessionId: string): ChatStreamEvent | null;
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/chat-protocol/events.js

@@ -0,0 +1,134 @@
+/**
+ * 协议版本。**不认识的版本要大声报错,不许静默降级**——版本不齐必须是一个明确的错误,
+ * 而不是又一个"两个页面显示不一样"的幽灵。
+ */
+export const CHAT_PROTOCOL_VERSION = 1;
+// ── 现网 SSE 事件名 → 规范事件 ────────────────────────────────────────
+/** 现网 SSE 事件名清单(订阅用)。 */
+export const WIRE_EVENT_NAMES = [
+    'chat.message',
+    'chat.message.pending',
+    'chat.message.snapshot',
+    'chat.message.chunk.text',
+    'chat.message.chunk.tool_use',
+    'chat.message.chunk.tool_update',
+    'chat.message.chunk.interaction',
+    'chat.message.interaction.updated',
+    'chat.message.complete',
+    'chat.message.error',
+    'chat.resync.required',
+];
+function str(v) {
+    return typeof v === 'string' ? v : '';
+}
+function num(v, fallback) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : fallback;
+}
+/**
+ * 把一条现网 SSE 事件翻成规范事件。不认识 / 字段缺失 → 返回 null(调用方忽略即可)。
+ * 解析 JSON 失败由调用方处理。
+ *
+ * `streamSessionId` = 这条 SSE 流所属的会话。**流的归属以 URL 为准**(`/stream/chat/:id`),
+ * payload 里的 `sessionId` 只作交叉校验:两者都在且不一致 → 丢弃(串台防线)。
+ */
+export function fromWireEvent(name, data, streamSessionId) {
+    if (!data || typeof data !== 'object' || !streamSessionId)
+        return null;
+    const d = data;
+    const payloadSession = str(d.sessionId);
+    if (payloadSession && payloadSession !== streamSessionId)
+        return null;
+    const sessionId = streamSessionId;
+    const seq = typeof d.seq === 'number' ? d.seq : undefined;
+    const turnId = str(d.assistantId) || str(d.turnId);
+    switch (name) {
+        case 'chat.message':
+            return d.message ? { type: 'message.appended', sessionId, message: d.message, seq } : null;
+        case 'chat.message.pending':
+            return turnId ? { type: 'turn.pending', sessionId, turnId, seq } : null;
+        case 'chat.message.snapshot':
+            return turnId
+                ? { type: 'turn.snapshot', sessionId, turnId, blocks: d.blocks ?? [], seq }
+                : null;
+        case 'chat.message.chunk.text':
+            return turnId && typeof d.text === 'string'
+                ? { type: 'text.delta', sessionId, turnId, text: d.text, seq }
+                : null;
+        case 'chat.message.chunk.tool_use':
+            return turnId && str(d.id)
+                ? {
+                    type: 'tool_use.started',
+                    sessionId,
+                    turnId,
+                    id: str(d.id),
+                    title: str(d.title),
+                    kind: str(d.kind),
+                    status: str(d.status),
+                    input: d.input,
+                    locations: d.locations,
+                    seq,
+                }
+                : null;
+        case 'chat.message.chunk.tool_update':
+            return turnId && str(d.id)
+                ? {
+                    type: 'tool_use.updated',
+                    sessionId,
+                    turnId,
+                    id: str(d.id),
+                    status: str(d.status),
+                    input: d.input,
+                    locations: d.locations,
+                    seq,
+                }
+                : null;
+        case 'chat.message.chunk.interaction':
+            return turnId && str(d.id)
+                ? {
+                    type: 'interaction.required',
+                    sessionId,
+                    turnId,
+                    id: str(d.id),
+                    kind: str(d.kind),
+                    title: str(d.title),
+                    schema: d.schema,
+                    ...(d.respond === 'message' || d.respond === 'endpoint' ? { respond: d.respond } : {}),
+                    revision: num(d.revision, 1),
+                    seq,
+                }
+                : null;
+        case 'chat.message.interaction.updated':
+            return str(d.interactionId)
+                ? {
+                    type: 'interaction.updated',
+                    sessionId,
+                    interactionId: str(d.interactionId),
+                    status: d.status === 'cancelled' ? 'cancelled' : 'answered',
+                    revision: num(d.revision, 1),
+                    answer: d.answer,
+                    seq,
+                }
+                : null;
+        case 'chat.message.complete':
+            return turnId && d.message
+                ? { type: 'turn.completed', sessionId, turnId, message: d.message, seq }
+                : null;
+        case 'chat.resync.required':
+            return {
+                type: 'resync.required',
+                sessionId,
+                ...(typeof d.reason === 'string' ? { reason: d.reason } : {}),
+            };
+        case 'chat.message.error':
+            return {
+                type: 'turn.failed',
+                sessionId,
+                ...(turnId ? { turnId } : {}),
+                ...(d.message ? { message: d.message } : {}),
+                seq,
+            };
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=events.js.map

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * @module        chat-protocol/form
+ * @description   **规范表单描述** `FormSpec` —— 交互块(`kind: 'form'`)的 schema 就是它。
+ *
+ * 为什么要有:此前同一个 `present_form`,claude 路发的是 fields 数组 DSL、openai 路发的是
+ * JSON Schema,于是每个产品要写**两个**表单渲染器;更糟的是生图模板
+ * (`IMAGE_FORM_SPEC`)被复制在引擎和 console 两处,靠注释提醒手工同步——再接两个平台
+ * 就是四份。规范化成一种语言之后,产品只写一个渲染器,且**完全不需要认识任何模板名**:
+ * 展开发生在引擎侧,事件里永远是完整字段表。
+ *
+ * 选 fields DSL 而不是 JSON Schema:它能表达 slider / multiselect / image-ref / 分组 /
+ * 折叠高级项 / 条件显隐,JSON Schema 表达这些是有损的。
+ *
+ * 零依赖规则见 `./types.ts` 头注释。
+ * @layer         contract
+ * @boundedContext chat
+ */
+export type FormFieldType = 'text' | 'textarea' | 'number' | 'slider' | 'select' | 'radio' | 'multiselect' | 'checkbox' | 'toggle' | 'color' | 'image-ref' | 'file';
+export interface FormFieldSpec {
+    /** 回流 JSON 的键。 */
+    id: string;
+    label: string;
+    /** 一次定死:渲染控件 + 返回值类型 + 校验。 */
+    type: FormFieldType;
+    default?: unknown;
+    required?: boolean;
+    /** 字段下方灰字说明。 */
+    hint?: string;
+    /** 分组名(同 group 归一栏)。 */
+    group?: string;
+    /** true = 默认折叠进「高级」。 */
+    advanced?: boolean;
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    min?: number;
+    max?: number;
+    step?: number;
+    placeholder?: string;
+    /** file / image-ref:如 `image/*`。 */
+    accept?: string;
+    /** 条件显隐。 */
+    dependsOn?: {
+        field: string;
+        equals: unknown;
+    };
+}
+export interface FormSpec {
+    title: string;
+    description?: string;
+    submitLabel?: string;
+    skipLabel?: string;
+    fields: FormFieldSpec[];
+}
+/**
+ * 答案怎么送回去。**两条后端路径的往返语义本身不同**,与其让客户端去猜"这是哪个后端",
+ * 不如在块上显式说清楚:
+ *  - `message` —— 作为一条**新的用户消息**发回(claude/MCP 路:工具立即返回,回合不挂起);
+ *  - `endpoint` —— `POST /sessions/:id/interactions/:interactionId`(openai/broker 路:
+ *    run 真的挂起,提交后恢复)。
+ */
+export type InteractionRespond = 'message' | 'endpoint';
+/** 运行时判别:交互块的 schema 是不是规范 FormSpec(而非旧的 JSON Schema)。 */
+export declare function isFormSpec(schema: unknown): schema is FormSpec;
+//# sourceMappingURL=form.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,OAAO,GACP,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY;IACZ,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,UAAU,CAAC;AAExD,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,QAAQ,CAI9D"}

package/dist/chat-protocol/form.js

@@ -0,0 +1,25 @@
+/**
+ * @module        chat-protocol/form
+ * @description   **规范表单描述** `FormSpec` —— 交互块(`kind: 'form'`)的 schema 就是它。
+ *
+ * 为什么要有:此前同一个 `present_form`,claude 路发的是 fields 数组 DSL、openai 路发的是
+ * JSON Schema,于是每个产品要写**两个**表单渲染器;更糟的是生图模板
+ * (`IMAGE_FORM_SPEC`)被复制在引擎和 console 两处,靠注释提醒手工同步——再接两个平台
+ * 就是四份。规范化成一种语言之后,产品只写一个渲染器,且**完全不需要认识任何模板名**:
+ * 展开发生在引擎侧,事件里永远是完整字段表。
+ *
+ * 选 fields DSL 而不是 JSON Schema:它能表达 slider / multiselect / image-ref / 分组 /
+ * 折叠高级项 / 条件显隐,JSON Schema 表达这些是有损的。
+ *
+ * 零依赖规则见 `./types.ts` 头注释。
+ * @layer         contract
+ * @boundedContext chat
+ */
+/** 运行时判别:交互块的 schema 是不是规范 FormSpec(而非旧的 JSON Schema)。 */
+export function isFormSpec(schema) {
+    if (!schema || typeof schema !== 'object')
+        return false;
+    const s = schema;
+    return typeof s.title === 'string' && Array.isArray(s.fields);
+}
+//# sourceMappingURL=form.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/chat-protocol/form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA0DH,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,MAAe;IACxC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,CAAC,GAAG,MAA+C,CAAC;IAC1D,OAAO,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * @module        chat-protocol
+ * @description   对话流协议 + 共享状态机的**唯一入口**。三个前端都从这里进。
+ *
+ * 🔴 零依赖叶子模块:本目录不许 import 目录外任何东西(含 node 内置与 npm 包)。
+ * 规则由 `chat-protocol.deps.test.ts` 卡死。将来抽成独立包 `@coralai/chat-protocol`
+ * 时只是移文件 + 加一个 package.json,代码零改。
+ *
+ * @layer         contract
+ * @boundedContext chat
+ */
+export { CHAT_PROTOCOL_VERSION, WIRE_EVENT_NAMES, fromWireEvent } from './events.js';
+export type { ChatStreamEvent } from './events.js';
+export { OPTIMISTIC_ID_PREFIX, initialChatStreamState } from './types.js';
+export type { ChatBlock, ChatMessage, ChatStreamState, PendingTurn } from './types.js';
+export { commitTurn, reduceChatEvent } from './reduce.js';
+export { isFormSpec } from './form.js';
+export type { FormFieldSpec, FormFieldType, FormSpec, InteractionRespond } from './form.js';
+export { advanceTypewriter, isDrained, renderBlocks } from './typewriter.js';
+export type { TypewriterProgress } from './typewriter.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/chat-protocol/index.js

@@ -0,0 +1,17 @@
+/**
+ * @module        chat-protocol
+ * @description   对话流协议 + 共享状态机的**唯一入口**。三个前端都从这里进。
+ *
+ * 🔴 零依赖叶子模块:本目录不许 import 目录外任何东西(含 node 内置与 npm 包)。
+ * 规则由 `chat-protocol.deps.test.ts` 卡死。将来抽成独立包 `@coralai/chat-protocol`
+ * 时只是移文件 + 加一个 package.json,代码零改。
+ *
+ * @layer         contract
+ * @boundedContext chat
+ */
+export { CHAT_PROTOCOL_VERSION, WIRE_EVENT_NAMES, fromWireEvent } from './events.js';
+export { OPTIMISTIC_ID_PREFIX, initialChatStreamState } from './types.js';
+export { commitTurn, reduceChatEvent } from './reduce.js';
+export { isFormSpec } from './form.js';
+export { advanceTypewriter, isDrained, renderBlocks } from './typewriter.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/chat-protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * @module        chat-protocol/reduce
+ * @description   **共享对话状态机**——三个前端(sps-console / coral-platform / gameforge)
+ *                喂同一串事件必须得到深度相等的状态。
+ *
+ * 本文件是从 `console/src/shared/hooks/useChatStream.ts` **忠实抽出**的纯函数,不是重写:
+ * 那里每条分支背后都有历史修复(丢首个 chunk、切会话误提交、断线补偿快照…),
+ * 重写等于把踩过的坑再踩一遍。
+ *
+ * 不在本文件的东西(**故意的**):
+ *  - 打字机(displayed/target):那是**展示**,见 `./typewriter.ts`,产品可选可不选;
+ *  - 传输(EventSource/fetch)、缓存(react-query)、定时器:各产品自己的事。
+ *
+ * 零依赖规则见 `./types.ts` 头注释。
+ * @layer         contract
+ * @boundedContext chat
+ */
+import type { ChatStreamEvent } from './events.js';
+import type { ChatStreamState } from './types.js';
+/**
+ * 唯一的状态归并入口。纯函数:同样的 (state, event) 永远得到同样的结果。
+ *
+ * 事件不属于本会话 → 原样返回(切会话时别的会话的事件不该污染当前状态)。
+ */
+export declare function reduceChatEvent(state: ChatStreamState, event: ChatStreamEvent): ChatStreamState;
+/**
+ * 把已收尾的回合提交进消息列表并清空在途态。
+ *
+ * 由**产品**决定时机:带打字机的等追齐后调(见 `./typewriter.ts` 的 `isDrained`),
+ * 不带的收到 `pending.done` 就调。未收尾时调用是安全的空操作。
+ */
+export declare function commitTurn(state: ChatStreamState): ChatStreamState;
+//# sourceMappingURL=reduce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reduce.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/reduce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAA0B,eAAe,EAAe,MAAM,YAAY,CAAC;AAuDvF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,CAwJ/F;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAQlE"}