@dipoleml/dcode-cli 1.0.0 → 1.2.0

package/node_modules/@dcode/shared/dist/dcode-protocol-v4/toolDisplay.d.ts

@@ -20,8 +20,8 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"local_agent_message">;
     status: z.ZodEnum<{
-        failed: "failed";
         success: "success";
+        failed: "failed";
     }>;
     error: z.ZodOptional<z.ZodString>;
     message: z.ZodOptional<z.ZodString>;
@@ -45,16 +45,16 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"respond_to_coordinator">;
     status: z.ZodEnum<{
-        failed: "failed";
         success: "success";
+        failed: "failed";
     }>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"cua">;
     schemaVersion: z.ZodLiteral<1>;
     toolName: z.ZodString;
     status: z.ZodEnum<{
-        failed: "failed";
         success: "success";
+        failed: "failed";
     }>;
     input: z.ZodOptional<z.ZodString>;
     structuredContent: z.ZodOptional<z.ZodString>;
@@ -107,6 +107,30 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             coding_plan_required: "coding_plan_required";
         }>;
     }, z.core.$strict>>;
+    ui: z.ZodOptional<z.ZodObject<{
+        pluginId: z.ZodString;
+        resourceUri: z.ZodString;
+        preferredDisplayMode: z.ZodOptional<z.ZodEnum<{
+            inline: "inline";
+            fullscreen: "fullscreen";
+            pip: "pip";
+        }>>;
+        prefersBorder: z.ZodOptional<z.ZodBoolean>;
+        csp: z.ZodOptional<z.ZodObject<{
+            connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            frameDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            baseUriDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        structuredContent: z.ZodOptional<z.ZodString>;
+        widgetMeta: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+        truncatedBytes: z.ZodOptional<z.ZodNumber>;
+        isError: z.ZodOptional<z.ZodLiteral<true>>;
+        showInline: z.ZodOptional<z.ZodLiteral<true>>;
+        surface: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"create_workflow">;
     ok: z.ZodBoolean;
@@ -123,6 +147,7 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodEnum<{
                 ask: "ask";
                 "world-read": "world-read";
+                hole: "hole";
             }>;
             label: z.ZodString;
             labelPattern: z.ZodOptional<z.ZodObject<{
@@ -139,6 +164,7 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 stack: "stack";
                 serial: "serial";
             }>>;
+            fill: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
         lanes: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -173,33 +199,51 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             line: z.ZodOptional<z.ZodNumber>;
             column: z.ZodOptional<z.ZodNumber>;
             alongside: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fill: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
         phaseEdges: z.ZodOptional<z.ZodArray<z.ZodObject<{
             from: z.ZodString;
             to: z.ZodString;
             back: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>>>;
+        phaseStreams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$strict>>>;
+        holes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            siteId: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+            phase: z.ZodOptional<z.ZodString>;
+            tail: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         exits: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sink: z.ZodOptional<z.ZodArray<z.ZodString>>;
         truncated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     truncated: z.ZodOptional<z.ZodBoolean>;
+    fill: z.ZodOptional<z.ZodObject<{
+        siteId: z.ZodString;
+        name: z.ZodString;
+        draftPath: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"get_workflow_run">;
     runId: z.ZodString;
     label: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
         running: "running";
         completed: "completed";
-        stopped: "stopped";
+        pending: "pending";
         errored: "errored";
+        stopped: "stopped";
     }>;
     stopReason: z.ZodOptional<z.ZodEnum<{
-        interrupted: "interrupted";
-        user: "user";
-        model: "model";
         provider: "provider";
+        model: "model";
+        user: "user";
+        interrupted: "interrupted";
         superseded: "superseded";
     }>>;
     possiblyInterrupted: z.ZodOptional<z.ZodBoolean>;
@@ -232,11 +276,11 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         state: z.ZodEnum<{
             failed: "failed";
-            done: "done";
-            unfinished: "unfinished";
             idle: "idle";
-            executing: "executing";
             waiting: "waiting";
+            executing: "executing";
+            done: "done";
+            unfinished: "unfinished";
             parked: "parked";
         }>;
         phaseName: z.ZodOptional<z.ZodString>;
@@ -297,21 +341,21 @@ declare const toolResultDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         runId: z.ZodString;
         label: z.ZodString;
         labelSource: z.ZodEnum<{
-            script: "script";
             name: "name";
+            script: "script";
         }>;
         status: z.ZodEnum<{
-            pending: "pending";
             running: "running";
             completed: "completed";
-            stopped: "stopped";
+            pending: "pending";
             errored: "errored";
+            stopped: "stopped";
         }>;
         stopReason: z.ZodOptional<z.ZodEnum<{
-            interrupted: "interrupted";
-            user: "user";
-            model: "model";
             provider: "provider";
+            model: "model";
+            user: "user";
+            interrupted: "interrupted";
             superseded: "superseded";
         }>>;
         ownedByThisSession: z.ZodBoolean;
@@ -391,8 +435,8 @@ export declare const toolOutputSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"local_agent_message">;
         status: z.ZodEnum<{
-            failed: "failed";
             success: "success";
+            failed: "failed";
         }>;
         error: z.ZodOptional<z.ZodString>;
         message: z.ZodOptional<z.ZodString>;
@@ -416,16 +460,16 @@ export declare const toolOutputSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"respond_to_coordinator">;
         status: z.ZodEnum<{
-            failed: "failed";
             success: "success";
+            failed: "failed";
         }>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"cua">;
         schemaVersion: z.ZodLiteral<1>;
         toolName: z.ZodString;
         status: z.ZodEnum<{
-            failed: "failed";
             success: "success";
+            failed: "failed";
         }>;
         input: z.ZodOptional<z.ZodString>;
         structuredContent: z.ZodOptional<z.ZodString>;
@@ -478,6 +522,30 @@ export declare const toolOutputSchema: z.ZodObject<{
                 coding_plan_required: "coding_plan_required";
             }>;
         }, z.core.$strict>>;
+        ui: z.ZodOptional<z.ZodObject<{
+            pluginId: z.ZodString;
+            resourceUri: z.ZodString;
+            preferredDisplayMode: z.ZodOptional<z.ZodEnum<{
+                inline: "inline";
+                fullscreen: "fullscreen";
+                pip: "pip";
+            }>>;
+            prefersBorder: z.ZodOptional<z.ZodBoolean>;
+            csp: z.ZodOptional<z.ZodObject<{
+                connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                frameDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                baseUriDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            structuredContent: z.ZodOptional<z.ZodString>;
+            widgetMeta: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+            truncated: z.ZodOptional<z.ZodBoolean>;
+            truncatedBytes: z.ZodOptional<z.ZodNumber>;
+            isError: z.ZodOptional<z.ZodLiteral<true>>;
+            showInline: z.ZodOptional<z.ZodLiteral<true>>;
+            surface: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"create_workflow">;
         ok: z.ZodBoolean;
@@ -494,6 +562,7 @@ export declare const toolOutputSchema: z.ZodObject<{
                 kind: z.ZodEnum<{
                     ask: "ask";
                     "world-read": "world-read";
+                    hole: "hole";
                 }>;
                 label: z.ZodString;
                 labelPattern: z.ZodOptional<z.ZodObject<{
@@ -510,6 +579,7 @@ export declare const toolOutputSchema: z.ZodObject<{
                     stack: "stack";
                     serial: "serial";
                 }>>;
+                fill: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>;
             lanes: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
@@ -544,33 +614,51 @@ export declare const toolOutputSchema: z.ZodObject<{
                 line: z.ZodOptional<z.ZodNumber>;
                 column: z.ZodOptional<z.ZodNumber>;
                 alongside: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                fill: z.ZodOptional<z.ZodString>;
             }, z.core.$strict>>>;
             phaseEdges: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 from: z.ZodString;
                 to: z.ZodString;
                 back: z.ZodOptional<z.ZodLiteral<true>>;
             }, z.core.$strict>>>;
+            phaseStreams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                from: z.ZodString;
+                to: z.ZodString;
+            }, z.core.$strict>>>;
+            holes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                siteId: z.ZodString;
+                name: z.ZodString;
+                type: z.ZodString;
+                phase: z.ZodOptional<z.ZodString>;
+                tail: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>>;
             exits: z.ZodOptional<z.ZodArray<z.ZodString>>;
             sink: z.ZodOptional<z.ZodArray<z.ZodString>>;
             truncated: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strict>>;
         truncated: z.ZodOptional<z.ZodBoolean>;
+        fill: z.ZodOptional<z.ZodObject<{
+            siteId: z.ZodString;
+            name: z.ZodString;
+            draftPath: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"get_workflow_run">;
         runId: z.ZodString;
         label: z.ZodString;
         status: z.ZodEnum<{
-            pending: "pending";
             running: "running";
             completed: "completed";
-            stopped: "stopped";
+            pending: "pending";
             errored: "errored";
+            stopped: "stopped";
         }>;
         stopReason: z.ZodOptional<z.ZodEnum<{
-            interrupted: "interrupted";
-            user: "user";
-            model: "model";
             provider: "provider";
+            model: "model";
+            user: "user";
+            interrupted: "interrupted";
             superseded: "superseded";
         }>>;
         possiblyInterrupted: z.ZodOptional<z.ZodBoolean>;
@@ -603,11 +691,11 @@ export declare const toolOutputSchema: z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
             state: z.ZodEnum<{
                 failed: "failed";
-                done: "done";
-                unfinished: "unfinished";
                 idle: "idle";
-                executing: "executing";
                 waiting: "waiting";
+                executing: "executing";
+                done: "done";
+                unfinished: "unfinished";
                 parked: "parked";
             }>;
             phaseName: z.ZodOptional<z.ZodString>;
@@ -668,21 +756,21 @@ export declare const toolOutputSchema: z.ZodObject<{
             runId: z.ZodString;
             label: z.ZodString;
             labelSource: z.ZodEnum<{
-                script: "script";
                 name: "name";
+                script: "script";
             }>;
             status: z.ZodEnum<{
-                pending: "pending";
                 running: "running";
                 completed: "completed";
-                stopped: "stopped";
+                pending: "pending";
                 errored: "errored";
+                stopped: "stopped";
             }>;
             stopReason: z.ZodOptional<z.ZodEnum<{
-                interrupted: "interrupted";
-                user: "user";
-                model: "model";
                 provider: "provider";
+                model: "model";
+                user: "user";
+                interrupted: "interrupted";
                 superseded: "superseded";
             }>>;
             ownedByThisSession: z.ZodBoolean;
@@ -745,8 +833,11 @@ export declare const toolOutputSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type ToolOutput = z.infer<typeof toolOutputSchema>;
 export declare const toolProgressSchema: z.ZodObject<{
-    bytes: z.ZodNumber;
+    bytes: z.ZodOptional<z.ZodNumber>;
     previewLine: z.ZodOptional<z.ZodString>;
+    fraction: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
     updatedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type ToolProgress = z.infer<typeof toolProgressSchema>;
@@ -775,8 +866,8 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"respond_to_coordinator">;
     status: z.ZodEnum<{
-        failed: "failed";
         success: "success";
+        failed: "failed";
     }>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"mcp_tool">;
@@ -789,6 +880,30 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
             coding_plan_required: "coding_plan_required";
         }>;
     }, z.core.$strict>>;
+    ui: z.ZodOptional<z.ZodObject<{
+        pluginId: z.ZodString;
+        resourceUri: z.ZodString;
+        preferredDisplayMode: z.ZodOptional<z.ZodEnum<{
+            inline: "inline";
+            fullscreen: "fullscreen";
+            pip: "pip";
+        }>>;
+        prefersBorder: z.ZodOptional<z.ZodBoolean>;
+        csp: z.ZodOptional<z.ZodObject<{
+            connectDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            resourceDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            frameDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            baseUriDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        structuredContent: z.ZodOptional<z.ZodString>;
+        widgetMeta: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        truncated: z.ZodOptional<z.ZodBoolean>;
+        truncatedBytes: z.ZodOptional<z.ZodNumber>;
+        isError: z.ZodOptional<z.ZodLiteral<true>>;
+        showInline: z.ZodOptional<z.ZodLiteral<true>>;
+        surface: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"create_workflow">;
     ok: z.ZodBoolean;
@@ -805,6 +920,7 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
             kind: z.ZodEnum<{
                 ask: "ask";
                 "world-read": "world-read";
+                hole: "hole";
             }>;
             label: z.ZodString;
             labelPattern: z.ZodOptional<z.ZodObject<{
@@ -821,6 +937,7 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
                 stack: "stack";
                 serial: "serial";
             }>>;
+            fill: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
         lanes: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -855,33 +972,51 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
             line: z.ZodOptional<z.ZodNumber>;
             column: z.ZodOptional<z.ZodNumber>;
             alongside: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            fill: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
         phaseEdges: z.ZodOptional<z.ZodArray<z.ZodObject<{
             from: z.ZodString;
             to: z.ZodString;
             back: z.ZodOptional<z.ZodLiteral<true>>;
         }, z.core.$strict>>>;
+        phaseStreams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+        }, z.core.$strict>>>;
+        holes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            siteId: z.ZodString;
+            name: z.ZodString;
+            type: z.ZodString;
+            phase: z.ZodOptional<z.ZodString>;
+            tail: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>>;
         exits: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sink: z.ZodOptional<z.ZodArray<z.ZodString>>;
         truncated: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>;
     truncated: z.ZodOptional<z.ZodBoolean>;
+    fill: z.ZodOptional<z.ZodObject<{
+        siteId: z.ZodString;
+        name: z.ZodString;
+        draftPath: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"get_workflow_run">;
     runId: z.ZodString;
     label: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
         running: "running";
         completed: "completed";
-        stopped: "stopped";
+        pending: "pending";
         errored: "errored";
+        stopped: "stopped";
     }>;
     stopReason: z.ZodOptional<z.ZodEnum<{
-        interrupted: "interrupted";
-        user: "user";
-        model: "model";
         provider: "provider";
+        model: "model";
+        user: "user";
+        interrupted: "interrupted";
         superseded: "superseded";
     }>>;
     possiblyInterrupted: z.ZodOptional<z.ZodBoolean>;
@@ -914,11 +1049,11 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
         name: z.ZodOptional<z.ZodString>;
         state: z.ZodEnum<{
             failed: "failed";
-            done: "done";
-            unfinished: "unfinished";
             idle: "idle";
-            executing: "executing";
             waiting: "waiting";
+            executing: "executing";
+            done: "done";
+            unfinished: "unfinished";
             parked: "parked";
         }>;
         phaseName: z.ZodOptional<z.ZodString>;
@@ -979,21 +1114,21 @@ export declare const toolCallDisplaySchema: z.ZodDiscriminatedUnion<[z.ZodObject
         runId: z.ZodString;
         label: z.ZodString;
         labelSource: z.ZodEnum<{
-            script: "script";
             name: "name";
+            script: "script";
         }>;
         status: z.ZodEnum<{
-            pending: "pending";
             running: "running";
             completed: "completed";
-            stopped: "stopped";
+            pending: "pending";
             errored: "errored";
+            stopped: "stopped";
         }>;
         stopReason: z.ZodOptional<z.ZodEnum<{
-            interrupted: "interrupted";
-            user: "user";
-            model: "model";
             provider: "provider";
+            model: "model";
+            user: "user";
+            interrupted: "interrupted";
             superseded: "superseded";
         }>>;
         ownedByThisSession: z.ZodBoolean;

package/node_modules/@dcode/shared/dist/dcode-protocol-v4/toolDisplay.js

@@ -6,6 +6,7 @@ import { bashOutputDisplaySchema } from "../bash-output-display.js";
 import { timestampSchema } from "./core.js";
 import { OFFICIAL_MCP_TOOL_ERROR_CODES } from "../official-mcp-tool-error.js";
 import { cuaRequestAccessStatusSchema } from "./cuaPermission.js";
+import { mcpToolDisplayUiSchema } from "../mcp-apps/schemas.js";
 import { toolCallCreateWorkflowDisplaySchema } from "./create-workflow-display.js";
 import { toolCallEvalWorkflowSnippetDisplaySchema, toolCallGetWorkflowRunDisplaySchema, toolCallListModelsDisplaySchema, toolCallListWorkflowRunsDisplaySchema, toolCallSavedWorkflowListDisplaySchema, toolCallResumeWorkflowRunDisplaySchema, } from "./workflow-observation-display.js";
 // toolCall 终态 output 的结构化展示模型（port 自 feat；CUA 工具靠 kind:"cua" 分支把
@@ -119,6 +120,8 @@ const toolResultDisplaySchema = z.discriminatedUnion("kind", [
             .object({ code: z.enum(OFFICIAL_MCP_TOOL_ERROR_CODES) })
             .strict()
             .optional(),
+        // 插件 UI 元数据；与 CLI contracts 的 mcpToolResultDisplayPayloadSchema 同源复用，见 mcp-apps/schemas.ts。
+        ui: mcpToolDisplayUiSchema.optional(),
     }),
     // buildToolOutput 把 CLI 侧 ToolResultDisplayPayload 原样塞进 toolOutput.display，
     // 而这条 union 是 strict 的——create_workflow 不在成员里，CreateWorkflow 的 display 会被整段
@@ -134,8 +137,27 @@ const toolResultDisplaySchema = z.discriminatedUnion("kind", [
     toolCallListModelsDisplaySchema,
     toolCallResumeWorkflowRunDisplaySchema,
 ]);
-// toolCall。终态 output 全档统一 head+tail 截断，超出走 truncated.ref 按需拉。
-// display 是展示载荷；版本不兼容时降级为无卡片，避免同一内容导致整条订阅反复恢复失败。
+// §4.4.5 toolCall。终态 output 全档统一 head+tail 截断（R-10），超出走 truncated.ref 按需拉。
+//
+// ⚠ display 在信封层**不设门**（`.optional().catch(undefined)`）：解析不过就退化成「这张卡没有
+// 载荷」，而不是让整条 row、整帧、整条订阅失败。四个嵌入点共用这条规则——本文件的
+// toolOutputSchema、rows.ts 的 toolCallRow、snapshot.ts 的确认预览、workflow-row-meta.ts 的
+// 启动行图；spec 见 docs/v4-refactor/10-protocol-spec.md §4.4.5 与
+// docs/v4-refactor/04-sync-and-recovery.md 封闭规则 11。
+//
+// 根因（2026-09-21，sess_4142de31）：display 是装饰载荷，却长在 liveness 关键的信封里。CLI 给
+// `list_workflow_runs` 的 run 行加了两个 lineage 键，本侧镜像没跟上 → 整帧被
+// `proto.frameAssemblyInvalidPayload` 拒 → 恢复阶梯在同一份内容上重试 → 会话停在
+// `fault.subscription.recoveryFailed`；而每次快照都重放同一份存量载荷，会话永不自愈。同款事故
+// 2026-09-17 已经发生过一次（`get_workflow_run` 的 `providerStop`），当时只修了那一个字段。
+//
+// 严格性没有丢，只是回到该在的那一层：渲染侧 readToolResultDisplay
+// （packages/ui/src/ToolCallBlocks/toolResultDisplay.ts）本来就按 kind 逐个 strict 解析，失败即
+// 回 undefined、卡片退化成纯文本——这正是各 spec 一直承诺的行为。信封层那道门是重复的第二道
+// 门，唯一的独有效果是杀死会话。
+//
+// 成员 schema 仍然 `.strict()`：它们定义「本端认得的形状」，catch 只把「不认得」从致命降级为
+// 无卡。代价是 skew 变静默，补偿手段是构造侧与镜像侧的 parity 测试，而不是让线上订阅去发现。
 export const toolOutputSchema = z.object({
     text: z.string(),
     display: toolResultDisplaySchema.optional().catch(undefined),
@@ -146,9 +168,14 @@ export const toolOutputSchema = z.object({
     })
         .optional(),
 });
+// 工具运行中的进度（）：MCP `notifications/progress` 经 ToolCallProgress 事件投影到行上。
+// fraction 由 payload progress/total 推得（total 缺失时不填）；bytes / previewLine 保留给 shell 输出型进度。
 export const toolProgressSchema = z.object({
-    bytes: z.number(),
+    bytes: z.number().optional(),
     previewLine: z.string().optional(),
+    fraction: z.number().min(0).max(1).optional(),
+    total: z.number().optional(),
+    message: z.string().max(200).optional(),
     updatedAt: timestampSchema,
 });
 /**
@@ -219,6 +246,7 @@ const toolCallMcpDisplaySchema = z
         .object({ code: z.enum(OFFICIAL_MCP_TOOL_ERROR_CODES) })
         .strict()
         .optional(),
+    ui: mcpToolDisplayUiSchema.optional(),
 })
     .strict();
 export const toolCallDisplaySchema = z.discriminatedUnion("kind", [