@coralai/sps-cli 0.65.33 → 0.65.35

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":"AAgBA;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAmEvC,gEAAgE;AAEhE,yBAAyB;AACzB,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc;IACd,sBAAsB;IACtB,uBAAuB;IACvB,yBAAyB;IACzB,6BAA6B;IAC7B,gCAAgC;IAChC,gCAAgC;IAChC,kCAAkC;IAClC,uBAAuB;IACvB,oBAAoB;IACpB,sBAAsB;CACd,CAAC;AAIX,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AACD,SAAS,GAAG,CAAC,CAAU,EAAE,QAAgB;IACvC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,IAAa,EACb,eAAuB;IAEvB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,eAAe;QAAE,OAAO,IAAI,CAAC;IACvE,MAAM,CAAC,GAAG,IAAgB,CAAC;IAC3B,MAAM,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,cAAc,IAAI,cAAc,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IACtE,MAAM,SAAS,GAAG,eAAe,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAEnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAsB,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE5G,KAAK,sBAAsB;YACzB,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE1E,KAAK,uBAAuB;YAC1B,OAAO,MAAM;gBACX,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAG,CAAC,CAAC,MAAsB,IAAI,EAAE,EAAE,GAAG,EAAE;gBAC5F,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,yBAAyB;YAC5B,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBACzC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE;gBAC9D,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,6BAA6B;YAChC,OAAO,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,CAAC,CAAC;oBACE,IAAI,EAAE,kBAAkB;oBACxB,SAAS;oBACT,MAAM;oBACN,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;oBACnB,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjB,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;oBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,GAAG;iBACJ;gBACH,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,gCAAgC;YACnC,OAAO,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,CAAC,CAAC;oBACE,IAAI,EAAE,kBAAkB;oBACxB,SAAS;oBACT,MAAM;oBACN,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;oBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,GAAG;iBACJ;gBACH,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,gCAAgC;YACnC,OAAO,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxB,CAAC,CAAC;oBACE,IAAI,EAAE,sBAAsB;oBAC5B,SAAS;oBACT,MAAM;oBACN,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACb,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjB,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;oBACnB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACtF,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC5B,GAAG;iBACJ;gBACH,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,kCAAkC;YACrC,OAAO,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;gBACzB,CAAC,CAAC;oBACE,IAAI,EAAE,qBAAqB;oBAC3B,SAAS;oBACT,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;oBACnC,MAAM,EAAE,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU;oBAC3D,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,GAAG;iBACJ;gBACH,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,uBAAuB;YAC1B,OAAO,MAAM,IAAI,CAAC,CAAC,OAAO;gBACxB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAsB,EAAE,GAAG,EAAE;gBACvF,CAAC,CAAC,IAAI,CAAC;QAEX,KAAK,sBAAsB;YACzB,OAAO;gBACL,IAAI,EAAE,iBAAiB;gBACvB,SAAS;gBACT,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9D,CAAC;QAEJ,KAAK,oBAAoB;YACvB,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,SAAS;gBACT,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,GAAG;aACJ,CAAC;QAEJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

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/formValues.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @module        chat-protocol/formValues
+ * @description   `FormSpec` 的**取值语义**:初值、显隐、校验、答案组装。纯函数,不碰 UI。
+ *
+ * 🔴 为什么这层必须共享:光给产品一份 `FormSpec` 还不够 —— 从 spec 到最终提交的 JSON,
+ * 中间这些规则各写各的一定会散,而散掉的后果**不是难看,是数据形状不一致**:
+ * 同一张表单,A 端交上来 `{count: "3"}`、B 端 `{count: 3}`、C 端漏掉被隐藏的字段,
+ * **模型收到三种不同的 JSON**。这是正确性问题。
+ *
+ * 而且这个分叉在本仓已经发生过:`ConfigFormPanel` 有一份按类型定初值的实现,
+ * `MessageBlocks` 另有一份做数字转换的实现,规则并不完全一致。一个仓两份,
+ * 再接两个平台就是四份 —— 和生图模板当初一模一样的剧本。
+ *
+ * 产品端拿到这四个函数后,真正要写的只剩控件的样子和事件绑定。
+ *
+ * 零依赖规则见 `./types.ts` 头注释。
+ * @layer         contract
+ * @boundedContext chat
+ */
+import type { FormFieldSpec, FormSpec } from './form.js';
+export type FormValues = Record<string, unknown>;
+/**
+ * 单个字段的初值。**按类型定死**,不让各端自己发挥:
+ * 多值 = `[]`、开关 = `false`、数值 = `min ?? 0`、其余 = 空串。给了 `default` 就用它。
+ */
+export declare function initialValue(field: FormFieldSpec): unknown;
+/** 整张表单的初值。`preset`(只读回看已提交表单时)按字段覆盖。 */
+export declare function initialValues(spec: FormSpec, preset?: FormValues): FormValues;
+/**
+ * 当前可见的字段(处理 `dependsOn` 条件显隐)。
+ * 依赖的字段自己不可见时,本字段也不可见——否则会出现"看不见的必填项"卡住提交。
+ */
+export declare function visibleFields(spec: FormSpec, values: FormValues): FormFieldSpec[];
+/** 一个值算不算"没填"。空串 / null / undefined / 空数组都算。 */
+export declare function isBlank(value: unknown): boolean;
+/**
+ * 校验,返回**缺失的必填字段**(按 spec 顺序)。
+ * 只校验可见字段:被 `dependsOn` 隐藏的必填项不该挡住提交。
+ */
+export declare function validate(spec: FormSpec, values: FormValues): FormFieldSpec[];
+/**
+ * 组装最终答案。规则(定死,别各端发挥):
+ *  - 只收**可见**字段——被条件隐藏的不进答案,否则模型会收到用户根本没看见的值;
+ *  - 数值字段从输入框的字符串转回 `number`(转不动就原样保留,不猜);
+ *  - 多值字段保证是数组;
+ *  - 没填的字段**不进答案**(而不是塞空串)——"没填"和"填了空"对模型是两件事。
+ */
+export declare function buildAnswer(spec: FormSpec, values: FormValues): FormValues;
+/**
+ * 把答案渲染成**一句人话**,用作用户侧的指令文本。
+ *
+ * 🔴 为什么要共享:交互确认后内容会落进**用户气泡**——历史里读到的是"要!金块加时间 +
+ * 炸弹扣分",而不是一坨 JSON。三端各渲染各的,同一次确认在不同平台读起来就不一样,
+ * 而这是**同一段对话历史**。
+ *
+ * 规则:按 spec 顺序取可见且已填的字段,`选项标签`优先于原始值(用户看见的是标签),
+ * 多值用顿号连接,字段之间用 ` · ` 分隔。单字段(典型:选择器)不加标签前缀,直接就是那句话。
+ */
+export declare function renderAnswer(spec: FormSpec, answer: FormValues): string;
+//# sourceMappingURL=formValues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formValues.d.ts","sourceRoot":"","sources":["../../src/chat-protocol/formValues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAYjD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAM1D;AAED,yCAAyC;AACzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,CAM7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,EAAE,CASjF;AAED,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG/C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,aAAa,EAAE,CAE5E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,UAAU,CAe1E;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAcvE"}

package/dist/chat-protocol/formValues.js

@@ -0,0 +1,114 @@
+/** 多值控件(值恒为数组)。 */
+function isMultiValue(type) {
+    return type === 'multiselect' || type === 'checkbox';
+}
+/** 数值控件(提交前要从输入框的字符串转回 number)。 */
+function isNumeric(type) {
+    return type === 'number' || type === 'slider';
+}
+/**
+ * 单个字段的初值。**按类型定死**,不让各端自己发挥:
+ * 多值 = `[]`、开关 = `false`、数值 = `min ?? 0`、其余 = 空串。给了 `default` 就用它。
+ */
+export function initialValue(field) {
+    if (field.default !== undefined)
+        return field.default;
+    if (isMultiValue(field.type))
+        return [];
+    if (field.type === 'toggle')
+        return false;
+    if (isNumeric(field.type))
+        return field.min ?? 0;
+    return '';
+}
+/** 整张表单的初值。`preset`(只读回看已提交表单时)按字段覆盖。 */
+export function initialValues(spec, preset) {
+    const out = {};
+    for (const field of spec.fields) {
+        out[field.id] = preset && field.id in preset ? preset[field.id] : initialValue(field);
+    }
+    return out;
+}
+/**
+ * 当前可见的字段(处理 `dependsOn` 条件显隐)。
+ * 依赖的字段自己不可见时,本字段也不可见——否则会出现"看不见的必填项"卡住提交。
+ */
+export function visibleFields(spec, values) {
+    const byId = new Map(spec.fields.map((f) => [f.id, f]));
+    const visible = (field, depth) => {
+        if (!field.dependsOn || depth > 16)
+            return true;
+        const parent = byId.get(field.dependsOn.field);
+        if (!parent || !visible(parent, depth + 1))
+            return false;
+        return values[field.dependsOn.field] === field.dependsOn.equals;
+    };
+    return spec.fields.filter((f) => visible(f, 0));
+}
+/** 一个值算不算"没填"。空串 / null / undefined / 空数组都算。 */
+export function isBlank(value) {
+    if (value === undefined || value === null || value === '')
+        return true;
+    return Array.isArray(value) && value.length === 0;
+}
+/**
+ * 校验,返回**缺失的必填字段**(按 spec 顺序)。
+ * 只校验可见字段:被 `dependsOn` 隐藏的必填项不该挡住提交。
+ */
+export function validate(spec, values) {
+    return visibleFields(spec, values).filter((f) => f.required && isBlank(values[f.id]));
+}
+/**
+ * 组装最终答案。规则(定死,别各端发挥):
+ *  - 只收**可见**字段——被条件隐藏的不进答案,否则模型会收到用户根本没看见的值;
+ *  - 数值字段从输入框的字符串转回 `number`(转不动就原样保留,不猜);
+ *  - 多值字段保证是数组;
+ *  - 没填的字段**不进答案**(而不是塞空串)——"没填"和"填了空"对模型是两件事。
+ */
+export function buildAnswer(spec, values) {
+    const answer = {};
+    for (const field of visibleFields(spec, values)) {
+        const raw = values[field.id];
+        if (isBlank(raw) && field.type !== 'toggle')
+            continue;
+        if (isNumeric(field.type) && typeof raw === 'string') {
+            const n = Number(raw);
+            answer[field.id] = Number.isFinite(n) ? n : raw;
+        }
+        else if (isMultiValue(field.type)) {
+            answer[field.id] = Array.isArray(raw) ? raw : [raw];
+        }
+        else {
+            answer[field.id] = raw;
+        }
+    }
+    return answer;
+}
+/**
+ * 把答案渲染成**一句人话**,用作用户侧的指令文本。
+ *
+ * 🔴 为什么要共享:交互确认后内容会落进**用户气泡**——历史里读到的是"要!金块加时间 +
+ * 炸弹扣分",而不是一坨 JSON。三端各渲染各的,同一次确认在不同平台读起来就不一样,
+ * 而这是**同一段对话历史**。
+ *
+ * 规则:按 spec 顺序取可见且已填的字段,`选项标签`优先于原始值(用户看见的是标签),
+ * 多值用顿号连接,字段之间用 ` · ` 分隔。单字段(典型:选择器)不加标签前缀,直接就是那句话。
+ */
+export function renderAnswer(spec, answer) {
+    const parts = [];
+    for (const field of spec.fields) {
+        const raw = answer[field.id];
+        if (raw === undefined)
+            continue;
+        const label = (v) => {
+            const hit = field.options?.find((o) => o.value === v);
+            return hit ? hit.label : String(v);
+        };
+        const text = Array.isArray(raw) ? raw.map(label).join('、') : label(raw);
+        if (!text)
+            continue;
+        parts.push(spec.fields.length === 1 ? text : `${field.label}:${text}`);
+    }
+    return parts.join(' · ');
+}
+//# sourceMappingURL=formValues.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * @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 { buildAnswer, initialValue, initialValues, isBlank, renderAnswer, validate, visibleFields, } from './formValues.js';
+export type { FormValues } from './formValues.js';
+export { activeInteraction, supersededInteractions } from './selectors.js';
+export type { InteractionBlock } from './selectors.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,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,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,19 @@
+/**
+ * @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 { buildAnswer, initialValue, initialValues, isBlank, renderAnswer, validate, visibleFields, } from './formValues.js';
+export { activeInteraction, supersededInteractions } from './selectors.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;AACvC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACb,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}