npm - @coralai/sps-cli - Versions diffs - 0.65.32 → 0.65.34 - Mend

@coralai/sps-cli 0.65.32 → 0.65.34

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (57) hide show

package/dist/chat-protocol/events.d.ts +131 -0
package/dist/chat-protocol/events.d.ts.map +1 -0
package/dist/chat-protocol/events.js +134 -0
package/dist/chat-protocol/events.js.map +1 -0
package/dist/chat-protocol/form.d.ts +66 -0
package/dist/chat-protocol/form.d.ts.map +1 -0
package/dist/chat-protocol/form.js +25 -0
package/dist/chat-protocol/form.js.map +1 -0
package/dist/chat-protocol/index.d.ts +21 -0
package/dist/chat-protocol/index.d.ts.map +1 -0
package/dist/chat-protocol/index.js +17 -0
package/dist/chat-protocol/index.js.map +1 -0
package/dist/chat-protocol/reduce.d.ts +33 -0
package/dist/chat-protocol/reduce.d.ts.map +1 -0
package/dist/chat-protocol/reduce.js +204 -0
package/dist/chat-protocol/reduce.js.map +1 -0
package/dist/chat-protocol/types.d.ts +85 -0
package/dist/chat-protocol/types.d.ts.map +1 -0
package/dist/chat-protocol/types.js +9 -0
package/dist/chat-protocol/types.js.map +1 -0
package/dist/chat-protocol/typewriter.d.ts +25 -0
package/dist/chat-protocol/typewriter.d.ts.map +1 -0
package/dist/chat-protocol/typewriter.js +36 -0
package/dist/chat-protocol/typewriter.js.map +1 -0
package/dist/console/chatEventLog.d.ts +47 -0
package/dist/console/chatEventLog.d.ts.map +1 -0
package/dist/console/chatEventLog.js +79 -0
package/dist/console/chatEventLog.js.map +1 -0
package/dist/console/routes/chat.d.ts +3 -0
package/dist/console/routes/chat.d.ts.map +1 -1
package/dist/console/routes/chat.js +173 -114
package/dist/console/routes/chat.js.map +1 -1
package/dist/console/routes/workers.d.ts.map +1 -1
package/dist/console/routes/workers.js +19 -0
package/dist/console/routes/workers.js.map +1 -1
package/dist/console-assets/assets/{ShowcasePage-NmXybDqC.js → ShowcasePage-x-qRvSx_.js} +1 -1
package/dist/console-assets/assets/{index-DCAnGMiQ.js → index-Ifjq4orx.js} +216 -216
package/dist/console-assets/index.html +1 -1
package/dist/core/activityStream.d.ts +42 -0
package/dist/core/activityStream.d.ts.map +1 -0
package/dist/core/activityStream.js +213 -0
package/dist/core/activityStream.js.map +1 -0
package/dist/core/agents/AgentBackend.d.ts +11 -1
package/dist/core/agents/AgentBackend.d.ts.map +1 -1
package/dist/core/agents/AgentBackend.js.map +1 -1
package/dist/core/interactions/formSpec.d.ts +57 -0
package/dist/core/interactions/formSpec.d.ts.map +1 -0
package/dist/core/interactions/formSpec.js +123 -0
package/dist/core/interactions/formSpec.js.map +1 -0
package/dist/openai-agent/interactions/broker.d.ts.map +1 -1
package/dist/openai-agent/interactions/broker.js +38 -77
package/dist/openai-agent/interactions/broker.js.map +1 -1
package/dist/services/WorkerService.d.ts +21 -0
package/dist/services/WorkerService.d.ts.map +1 -1
package/dist/services/WorkerService.js +35 -0
package/dist/services/WorkerService.js.map +1 -1
package/package.json +1 -1

package/dist/console-assets/index.html CHANGED Viewed

@@ -8,7 +8,7 @@
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
-  <script type="module" crossorigin src="/assets/index-DCAnGMiQ.js"></script>
+  <script type="module" crossorigin src="/assets/index-Ifjq4orx.js"></script>
   <link rel="stylesheet" crossorigin href="/assets/index-cxN7rD-p.css">
 </head>
 <body>

package/dist/core/activityStream.d.ts ADDED Viewed

@@ -0,0 +1,42 @@
+/** 归一后的原始活动事件。字段稳定;不含任何展示语义。 */
+export type ActivityEvent = {
+    seq: number;
+    ts: string | null;
+    type: 'text';
+    text: string;
+} | {
+    seq: number;
+    ts: string | null;
+    type: 'thinking';
+    text: string;
+} | {
+    seq: number;
+    ts: string | null;
+    type: 'tool_use';
+    /** 配对用;与后续 tool_result 的 toolId 相同。 */
+    toolId: string;
+    /** **后端原生**工具名(Read / Edit / Bash / exec_command / apply_patch …),不翻译。 */
+    name: string;
+    /** 原始入参(已脱敏/截断超大值),不美化。 */
+    input: unknown;
+} | {
+    seq: number;
+    ts: string | null;
+    type: 'tool_result';
+    toolId: string;
+    ok: boolean;
+    /** 结果摘要文本(可能为空);产品自行决定展示与否。 */
+    text?: string;
+};
+export type ActivityBackend = 'claude' | 'openai';
+export interface ReadActivityInput {
+    backend: ActivityBackend;
+    /** claude 需要(用于定位 transcript);openai 不需要。 */
+    cwd?: string | null;
+    sessionId: string;
+    /** 只取最后 N 条(默认 500;0 = 不限)。 */
+    limit?: number;
+}
+/** 按后端读取归一活动流。未知/缺数据一律返回空数组,不抛。 */
+export declare function readActivity(input: ReadActivityInput): ActivityEvent[];
+//# sourceMappingURL=activityStream.d.ts.map

package/dist/core/activityStream.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"activityStream.d.ts","sourceRoot":"","sources":["../../src/core/activityStream.ts"],"names":[],"mappings":"AAiCA,gCAAgC;AAChC,MAAM,MAAM,aAAa,GACrB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClE;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAC;CAChB,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsMD,mCAAmC;AACnC,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAStE"}

package/dist/core/activityStream.js ADDED Viewed

@@ -0,0 +1,213 @@
+/**
+ * @module        core/activityStream
+ * @description   **后端无关的 worker 活动流**——把 claude / openai 各自的产出归一成同一套
+ *                原始事件,供上层产品(gameforge 的「制作过程」、console 等)消费。
+ *
+ * 🔴 为什么要有这层:此前 gameforge 只拿到 `currentTranscriptPath`,然后**自己去解析 Claude Code
+ * 的原生 jsonl**(按 claude 的 schema 拆 assistant/tool_use/tool_result)。这既让产品侧耦合了
+ * 某个后端的内部格式,也让 openai worker 的产出**完全看不见**(格式和位置都不同)。
+ * CLAUDE.md 的红线写着:"读 worker 产出要走 service API,别新写扫 jsonl;现存直读是历史遗留,
+ * 只减不增" —— 本模块就是那个 service 侧的归一层。
+ *
+ * 🔴 契约只定在「原始事件层」,不定在「展示层」:
+ *  - 归一化(懂各后端 schema)= 引擎的事 → 本模块
+ *  - 中文标签 / 标题截断 / 取 basename / 图标 = 产品的展示逻辑 → **不进契约,引擎不碰**
+ * 因此这里的工具名是**后端原生名**(`Read`/`Edit`/`exec_command`/`apply_patch`…),入参是**原始入参**,
+ * 不翻译、不美化。产品各自维护自己的展示映射,引擎改归一不会动到任何产品的 UI。
+ *
+ * 词汇与实时对话流对齐:块名词与 `src/chat-protocol/` 的 `ChatBlock` 同名(`text` /
+ * `tool_use`),差异都是真实的而非随意的 —— 活动流有 `thinking`(claude 有、openai 没有)
+ * 且它的 `tool_result` 是**已定型**的结果,而对话流里那表现为 `tool_use` 块的状态变化。
+ * 契约见 `docs/design/chat-stream-protocol.md`。
+ *
+ * 已知限制(如实标注,不伪造):**openai 侧没有 thinking 事件** —— 其进程协议
+ * (AgentProcessEventPayloadsV1)只有 assistant.delta / assistant.message / tool.call /
+ * tool.result,不含思考过程。claude 侧有。产品端需按"可能缺失"处理,而不是假定两边对称。
+ * @layer         core
+ * @boundedContext agents
+ */
+import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { claudeJsonlFile, sessionsDir } from '../shared/runtimePaths.js';
+import { sanitizeToolInput } from './claudeJsonl.js';
+const DEFAULT_LIMIT = 500;
+const MAX_TEXT = 20_000;
+function clip(text) {
+    return text.length > MAX_TEXT ? `${text.slice(0, MAX_TEXT)}…` : text;
+}
+/** 把 JsonValue 结果压成一段可读摘要(产品要不要展示由它自己定)。 */
+function summarize(output) {
+    if (output == null)
+        return undefined;
+    if (typeof output === 'string')
+        return clip(output);
+    try {
+        return clip(JSON.stringify(output));
+    }
+    catch {
+        return undefined;
+    }
+}
+function readClaudeActivity(cwd, sessionId) {
+    const path = claudeJsonlFile(cwd, sessionId);
+    if (!existsSync(path))
+        return [];
+    let raw;
+    try {
+        raw = readFileSync(path, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    let seq = 0;
+    for (const line of raw.split('\n')) {
+        if (!line.trim())
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(line);
+        }
+        catch {
+            continue; // 半截行(正在写)跳过
+        }
+        const ts = rec.timestamp ?? null;
+        for (const block of rec.message?.content ?? []) {
+            if (rec.type === 'assistant' && block.type === 'text' && block.text) {
+                out.push({ seq: seq++, ts, type: 'text', text: clip(block.text) });
+            }
+            else if (rec.type === 'assistant' && block.type === 'thinking' && block.thinking) {
+                out.push({ seq: seq++, ts, type: 'thinking', text: clip(block.thinking) });
+            }
+            else if (rec.type === 'assistant' && block.type === 'tool_use' && block.id && block.name) {
+                out.push({
+                    seq: seq++,
+                    ts,
+                    type: 'tool_use',
+                    toolId: block.id,
+                    name: block.name,
+                    input: sanitizeToolInput(block.input),
+                });
+            }
+            else if (rec.type === 'user' && block.type === 'tool_result' && block.tool_use_id) {
+                out.push({
+                    seq: seq++,
+                    ts,
+                    type: 'tool_result',
+                    toolId: block.tool_use_id,
+                    ok: block.is_error !== true,
+                    ...(summarize(block.content) ? { text: summarize(block.content) } : {}),
+                });
+            }
+        }
+    }
+    return out;
+}
+function readOpenAiActivity(sessionId) {
+    if (!/^[A-Za-z0-9_-]+$/.test(sessionId))
+        return [];
+    const runsDir = resolve(sessionsDir(), 'openai', sessionId, 'runs');
+    if (!existsSync(runsDir))
+        return [];
+    let runDirs;
+    try {
+        runDirs = readdirSync(runsDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => resolve(runsDir, d.name))
+            .sort((a, b) => statSync(a).mtimeMs - statSync(b).mtimeMs);
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    let seq = 0;
+    // assistant.delta 是逐段的:合并连续的 delta 成一条 text,避免产品端拿到几百个碎片。
+    let pendingText = '';
+    let pendingTs = null;
+    const flushText = () => {
+        if (!pendingText)
+            return;
+        out.push({ seq: seq++, ts: pendingTs, type: 'text', text: clip(pendingText) });
+        pendingText = '';
+        pendingTs = null;
+    };
+    for (const dir of runDirs) {
+        const file = resolve(dir, 'events.jsonl');
+        if (!existsSync(file))
+            continue;
+        let raw;
+        try {
+            raw = readFileSync(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        for (const line of raw.split('\n')) {
+            if (!line.trim())
+                continue;
+            let ev;
+            try {
+                ev = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            const ts = ev.timestamp ?? null;
+            switch (ev.type) {
+                case 'assistant.delta':
+                    if (ev.payload?.delta) {
+                        pendingTs ??= ts;
+                        pendingText += ev.payload.delta;
+                    }
+                    break;
+                case 'assistant.message':
+                    flushText();
+                    if (ev.payload?.text) {
+                        out.push({ seq: seq++, ts, type: 'text', text: clip(ev.payload.text) });
+                    }
+                    break;
+                case 'tool.call':
+                    flushText();
+                    if (ev.payload?.toolCallId && ev.payload.toolName) {
+                        out.push({
+                            seq: seq++,
+                            ts,
+                            type: 'tool_use',
+                            toolId: ev.payload.toolCallId,
+                            name: ev.payload.toolName,
+                            input: sanitizeToolInput(ev.payload.input),
+                        });
+                    }
+                    break;
+                case 'tool.result':
+                    flushText();
+                    if (ev.payload?.toolCallId) {
+                        out.push({
+                            seq: seq++,
+                            ts,
+                            type: 'tool_result',
+                            toolId: ev.payload.toolCallId,
+                            ok: ev.payload.status !== 'failed',
+                            ...(summarize(ev.payload.output) ? { text: summarize(ev.payload.output) } : {}),
+                        });
+                    }
+                    break;
+                default:
+                    break; // session.started / capabilities / usage / run.* 不属于活动流
+            }
+        }
+    }
+    flushText();
+    return out;
+}
+/** 按后端读取归一活动流。未知/缺数据一律返回空数组,不抛。 */
+export function readActivity(input) {
+    const all = input.backend === 'openai'
+        ? readOpenAiActivity(input.sessionId)
+        : input.cwd
+            ? readClaudeActivity(input.cwd, input.sessionId)
+            : [];
+    const limit = input.limit ?? DEFAULT_LIMIT;
+    return limit > 0 && all.length > limit ? all.slice(-limit) : all;
+}
+//# sourceMappingURL=activityStream.js.map

package/dist/core/activityStream.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"activityStream.js","sourceRoot":"","sources":["../../src/core/activityStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAsCrD,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC;AAExB,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED,4CAA4C;AAC5C,SAAS,SAAS,CAAC,MAAe;IAChC,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAuBD,SAAS,kBAAkB,CAAC,GAAW,EAAE,SAAiB;IACxD,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,GAAe,CAAC;QACpB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS,CAAC,aAAa;QACzB,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC;QACjC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;YAC/C,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACpE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrE,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnF,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC7E,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC3F,GAAG,CAAC,IAAI,CAAC;oBACP,GAAG,EAAE,GAAG,EAAE;oBACV,EAAE;oBACF,IAAI,EAAE,UAAU;oBAChB,MAAM,EAAE,KAAK,CAAC,EAAE;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC;iBACtC,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACpF,GAAG,CAAC,IAAI,CAAC;oBACP,GAAG,EAAE,GAAG,EAAE;oBACV,EAAE;oBACF,IAAI,EAAE,aAAa;oBACnB,MAAM,EAAE,KAAK,CAAC,WAAW;oBACzB,EAAE,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI;oBAC3B,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAkBD,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACpD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;aACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,0DAA0D;IAC1D,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC/E,WAAW,GAAG,EAAE,CAAC;QACjB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC3B,IAAI,EAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;YAC3C,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC;YAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,iBAAiB;oBACpB,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;wBACtB,SAAS,KAAK,EAAE,CAAC;wBACjB,WAAW,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;oBAClC,CAAC;oBACD,MAAM;gBACR,KAAK,mBAAmB;oBACtB,SAAS,EAAE,CAAC;oBACZ,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;wBACrB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAC1E,CAAC;oBACD,MAAM;gBACR,KAAK,WAAW;oBACd,SAAS,EAAE,CAAC;oBACZ,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;wBAClD,GAAG,CAAC,IAAI,CAAC;4BACP,GAAG,EAAE,GAAG,EAAE;4BACV,EAAE;4BACF,IAAI,EAAE,UAAU;4BAChB,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU;4BAC7B,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ;4BACzB,KAAK,EAAE,iBAAiB,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;yBAC3C,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM;gBACR,KAAK,aAAa;oBAChB,SAAS,EAAE,CAAC;oBACZ,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;wBAC3B,GAAG,CAAC,IAAI,CAAC;4BACP,GAAG,EAAE,GAAG,EAAE;4BACV,EAAE;4BACF,IAAI,EAAE,aAAa;4BACnB,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU;4BAC7B,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ;4BAClC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBAChF,CAAC,CAAC;oBACL,CAAC;oBACD,MAAM;gBACR;oBACE,MAAM,CAAC,wDAAwD;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IACD,SAAS,EAAE,CAAC;IACZ,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,GAAG,GACP,KAAK,CAAC,OAAO,KAAK,QAAQ;QACxB,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,SAAS,CAAC;QACrC,CAAC,CAAC,KAAK,CAAC,GAAG;YACT,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC;YAChD,CAAC,CAAC,EAAE,CAAC;IACX,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC;IAC3C,OAAO,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACnE,CAAC"}

package/dist/core/agents/AgentBackend.d.ts CHANGED Viewed

@@ -10,7 +10,17 @@
  */
 /** run 状态(终态:completed/failed/cancelled/lost;非终态:running/idle)。 */
 export type AgentRunState = 'running' | 'awaiting_input' | 'completed' | 'failed' | 'cancelled' | 'lost' | 'idle';
-/** 统一观测事件(§9):各后端把原生流翻译成这一种,上层一个 sink 落统一日志,workers 页不再 per-backend 分支。 */
+/**
+ * @deprecated **兼容视图,新代码不要依赖**(阶段 3 收敛)。
+ *
+ * 这是早期的四事件观测流。权威的统一事件流是 `src/runtime/contract/events.ts` 的同名类型
+ * (带 session / thinking / tool_use / tool_update / run_state / process / raw 与完整生命周期),
+ * 页面协议则是 `src/chat-protocol/`。两套并存曾导致"同一件事在不同层长得不一样"。
+ *
+ * 目前仍被 `OpenAiAgentBackend` 与统一日志 sink 使用,所以保留而非删除;
+ * 收口方向是让这些消费者改吃 runtime 契约,之后本类型即可移除。
+ * 契约全貌见 `docs/design/chat-stream-protocol.md`。
+ */
 export type WorkerOutputEvent = {
     kind: 'text';
     text: string;

package/dist/core/agents/AgentBackend.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AgentBackend.d.ts","sourceRoot":"","sources":["../../../src/core/agents/AgentBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mEAAmE;AACnE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,CAAC;AAEX~~,2EAA2E~~;~~AAC3E~~,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,aAAa,CAKzD,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;kEAC8D;IAC9D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;4DACwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,wCAAwC;IACxC,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnC,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;yGACqG;IACrG,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,0CAA0C;IAC1C,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,sFAAsF;IACtF,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnE;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}
1	+ {"version":3,"file":"AgentBackend.d.ts","sourceRoot":"","sources":["../../../src/core/agents/AgentBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,mEAAmE;AACnE,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,CAAC;AAEX;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,aAAa,CAKzD,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;kEAC8D;IAC9D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;4DACwD;IACxD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,wCAAwC;IACxC,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEnC,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;yGACqG;IACrG,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,0CAA0C;IAC1C,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,sFAAsF;IACtF,SAAS,CAAC,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACnE;AAED,6BAA6B;AAC7B,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/core/agents/AgentBackend.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"AgentBackend.js","sourceRoot":"","sources":["../../../src/core/agents/AgentBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;~~AAmBH~~,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAA+B,IAAI,GAAG,CAAC;IACrE,WAAW;IACX,QAAQ;IACR,WAAW;IACX,MAAM;CACP,CAAC,CAAC"}
1	+ {"version":3,"file":"AgentBackend.js","sourceRoot":"","sources":["../../../src/core/agents/AgentBackend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA6BH,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAA+B,IAAI,GAAG,CAAC;IACrE,WAAW;IACX,QAAQ;IACR,WAAW;IACX,MAAM;CACP,CAAC,CAAC"}

package/dist/core/interactions/formSpec.d.ts ADDED Viewed

@@ -0,0 +1,57 @@
+/**
+ * @module        core/interactions/formSpec
+ * @description   `present_form` 的**模板单一真源 + 服务端展开**。
+ *
+ * 🔴 为什么在引擎侧展开:此前 `template:'image'` 是**客户端**展开的——console 自带一份
+ * `IMAGE_FORM_TEMPLATE`,openai broker 里另有一份,注释互相提醒"要手工同步"。coral 与
+ * gameforge 接生图表单就是第三、第四份。展开挪到工具边界之后,发给前端的事件永远携带
+ * **完整字段表**,产品端零模板知识,新接平台不需要复制任何东西。
+ *
+ * 省 token 的初衷不受影响:模板名只在**模型 ↔ 工具**之间传,展开发生在工具返回之后。
+ *
+ * @layer         core
+ * @boundedContext chat
+ */
+import type { FormSpec } from '../../chat-protocol/form.js';
+/**
+ * 内置生图表单模板(快路径):agent 只需 `present_form({template:'image', defaults:{…}})`,
+ * 不必手写整份 fields(省几百 token、面板弹得快)。
+ *
+ * **这是这份模板在全仓的唯一定义。**
+ */
+export declare const IMAGE_FORM_SPEC: FormSpec;
+/** `present_form` 的原始工具入参(模型给的)。 */
+export interface RawFormInput {
+    title?: string;
+    description?: string;
+    submitLabel?: string;
+    skipLabel?: string;
+    template?: string;
+    defaults?: Record<string, unknown>;
+    fields?: FormSpec['fields'];
+}
+/**
+ * 把原始入参展开成完整 `FormSpec`。
+ * - 给了 `fields` → 用它;否则按 `template` 取内置模板;两者都没有 → null(工具会让模型重试)。
+ * - `defaults` 按字段 id 覆盖各字段的 `default`。
+ * - `title` 等文案:入参优先,回落模板。
+ */
+export declare function expandFormSpec(input: RawFormInput | undefined): FormSpec | null;
+/** `present_choices` 的原始工具入参。 */
+export interface RawChoicesInput {
+    question?: string;
+    groups?: Array<{
+        label?: string;
+        options?: string[];
+    }>;
+}
+/**
+ * 把选择器归一成 `FormSpec` —— **选择器本质就是一张只有 radio 的表单**。
+ * 两种交互共用一套 schema 语言,产品只需要一个渲染器;要不要把它画成"一键选项"
+ * 而不是"表单 + 提交",按交互块的 `kind` 决定,那是展示,不进契约。
+ *
+ * 字段 id 与 openai broker 既有约定一致(单组 `choice`,多组 `choice_1..n`),
+ * 免得同一个交互在两条路上回流的键名不同。
+ */
+export declare function expandChoicesSpec(input: RawChoicesInput | undefined): FormSpec | null;
+//# sourceMappingURL=formSpec.d.ts.map

package/dist/core/interactions/formSpec.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"formSpec.d.ts","sourceRoot":"","sources":["../../../src/core/interactions/formSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,QA2D7B,CAAC;AAIF,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAyB/E;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,CAcrF"}

package/dist/core/interactions/formSpec.js ADDED Viewed

@@ -0,0 +1,123 @@
+/**
+ * 内置生图表单模板(快路径):agent 只需 `present_form({template:'image', defaults:{…}})`,
+ * 不必手写整份 fields(省几百 token、面板弹得快)。
+ *
+ * **这是这份模板在全仓的唯一定义。**
+ */
+export const IMAGE_FORM_SPEC = {
+    title: '生图配置',
+    description: '填好点「开始生成」;懒得填就点「让 AI 来填」,我按你说的补全。',
+    submitLabel: '开始生成',
+    fields: [
+        {
+            id: 'prompt',
+            label: '画面描述',
+            type: 'textarea',
+            required: true,
+            placeholder: '主体 + 场景 + 动作 + 细节,越具体越好',
+            hint: '想画什么',
+        },
+        {
+            id: 'style',
+            label: '风格',
+            type: 'select',
+            default: 'realistic',
+            options: [
+                { value: 'realistic', label: '写实' },
+                { value: '3d-render', label: '3D 渲染' },
+                { value: 'anime', label: '动漫/二次元' },
+                { value: 'oil-painting', label: '油画' },
+                { value: 'watercolor', label: '水彩' },
+                { value: 'cyberpunk', label: '赛博朋克' },
+                { value: 'flat-illustration', label: '扁平插画' },
+                { value: 'cinematic', label: '电影感' },
+            ],
+        },
+        {
+            id: 'aspect',
+            label: '画幅',
+            type: 'select',
+            default: '1:1',
+            options: [
+                { value: '1:1', label: '正方形 1:1' },
+                { value: '16:9', label: '横屏 16:9' },
+                { value: '9:16', label: '竖屏 9:16' },
+                { value: '4:3', label: '4:3' },
+                { value: '3:4', label: '3:4' },
+            ],
+        },
+        // 生图一次一张(单 outPath 契约,不走并行);要多张让用户再说一句、agent 按需再生。
+        {
+            id: 'lighting',
+            label: '光线 / 氛围',
+            type: 'text',
+            advanced: true,
+            placeholder: '如 柔和逆光、霓虹夜色、清晨薄雾',
+        },
+        { id: 'mood', label: '情绪基调', type: 'text', advanced: true, placeholder: '如 宁静、孤独、热烈' },
+        {
+            id: 'reference',
+            label: '参考图',
+            type: 'image-ref',
+            advanced: true,
+            hint: '可选:上传或贴 URL,做 img2img 风格参考',
+        },
+    ],
+};
+const TEMPLATES = { image: IMAGE_FORM_SPEC };
+/**
+ * 把原始入参展开成完整 `FormSpec`。
+ * - 给了 `fields` → 用它;否则按 `template` 取内置模板;两者都没有 → null(工具会让模型重试)。
+ * - `defaults` 按字段 id 覆盖各字段的 `default`。
+ * - `title` 等文案:入参优先,回落模板。
+ */
+export function expandFormSpec(input) {
+    if (!input)
+        return null;
+    const template = input.template ? TEMPLATES[input.template] : undefined;
+    const fields = input.fields?.length ? input.fields : template?.fields;
+    if (!fields?.length)
+        return null;
+    const defaults = input.defaults;
+    const merged = defaults && typeof defaults === 'object'
+        ? fields.map((f) => (f.id in defaults ? { ...f, default: defaults[f.id] } : f))
+        : fields.map((f) => ({ ...f }));
+    return {
+        title: input.title || template?.title || '配置',
+        ...(input.description ?? template?.description
+            ? { description: input.description ?? template?.description }
+            : {}),
+        ...(input.submitLabel ?? template?.submitLabel
+            ? { submitLabel: input.submitLabel ?? template?.submitLabel }
+            : {}),
+        ...(input.skipLabel ?? template?.skipLabel
+            ? { skipLabel: input.skipLabel ?? template?.skipLabel }
+            : {}),
+        fields: merged,
+    };
+}
+/**
+ * 把选择器归一成 `FormSpec` —— **选择器本质就是一张只有 radio 的表单**。
+ * 两种交互共用一套 schema 语言,产品只需要一个渲染器;要不要把它画成"一键选项"
+ * 而不是"表单 + 提交",按交互块的 `kind` 决定,那是展示,不进契约。
+ *
+ * 字段 id 与 openai broker 既有约定一致(单组 `choice`,多组 `choice_1..n`),
+ * 免得同一个交互在两条路上回流的键名不同。
+ */
+export function expandChoicesSpec(input) {
+    const groups = input?.groups?.filter((g) => (g.options?.length ?? 0) > 0);
+    if (!groups?.length)
+        return null;
+    const question = input?.question?.trim() || '请选择';
+    return {
+        title: question,
+        fields: groups.map((g, i) => ({
+            id: groups.length === 1 ? 'choice' : `choice_${i + 1}`,
+            label: g.label ?? question,
+            type: 'radio',
+            required: true,
+            options: (g.options ?? []).map((o) => ({ value: o, label: o })),
+        })),
+    };
+}
+//# sourceMappingURL=formSpec.js.map

package/dist/core/interactions/formSpec.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"formSpec.js","sourceRoot":"","sources":["../../../src/core/interactions/formSpec.ts"],"names":[],"mappings":"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"}

package/dist/openai-agent/interactions/broker.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/openai-agent/interactions/broker.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,wBAAwB,CAAC;~~AAEhC~~,OAAO,EACL,gBAAgB,EAEhB,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;~~AAiEnC~~,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,KAAK,EAAE,gBAAgB;IALlC,gEAAgE;IAChE,OAAO,CAAC,aAAa,CAAC,CAAS;gBAGZ,KAAK,EAAE,0BAA0B,EACzC,KAAK,EAAE,gBAAgB;IAGlC;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,KAAK,IAAI,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IAoCtC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE;IAoCnD,mBAAmB,CACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI9B,qBAAqB,CACzB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IAoBvB,eAAe,CACnB,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACzB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAmCtC;;;;;OAKG;IACG,oBAAoB,CACxB,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACzB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;YA8BxB,aAAa;~~YA8Bb~~,UAAU;~~IAqCxB~~,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,MAAM;YA0BA,aAAa;CAgC5B"}
1	+ {"version":3,"file":"broker.d.ts","sourceRoot":"","sources":["../../../src/openai-agent/interactions/broker.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EACL,gBAAgB,EAEhB,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAkDnC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,KAAK,EAAE,gBAAgB;IALlC,gEAAgE;IAChE,OAAO,CAAC,aAAa,CAAC,CAAS;gBAGZ,KAAK,EAAE,0BAA0B,EACzC,KAAK,EAAE,gBAAgB;IAGlC;;;;;OAKG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,KAAK,IAAI,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE;IAoCtC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE;IAoCnD,mBAAmB,CACvB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAI9B,qBAAqB,CACzB,YAAY,EAAE,mBAAmB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IAoBvB,eAAe,CACnB,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACzB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAmCtC;;;;;OAKG;IACG,oBAAoB,CACxB,KAAK,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,EACzB,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;YA8BxB,aAAa;YAiBb,UAAU;IAoBxB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,MAAM;YA0BA,aAAa;CAgC5B"}