paseo-plugin-zcode-provider 0.3.0 → 0.4.1

package/server/vendor/zcode/packages/shared/src/zcode-protocol/trace.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+
+export const zcodeProtocolTraceSchema = z
+  .object({
+    traceId: z.string().min(1).optional(),
+    parentId: z.string().min(1).optional(),
+    spanId: z.string().min(1).optional(),
+    traceparent: z.string().min(1).optional(),
+  })
+  .strict();
+export type ZCodeProtocolTrace = z.infer<typeof zcodeProtocolTraceSchema>;

package/server/vendor/zcode/packages/shared/src/zcode-protocol-legacy-types.ts

@@ -14,11 +14,13 @@ const timestampMsSchema = z.number().int().nonnegative();
 export const zcodeDeliveryKindSchema = z.enum(["desktop-continuous", "web-remote-replayable"]);
 export const zcodeMessageVisibilitySchema = z.enum(["user-visible", "model-only"]);
 export const zcodeSyntheticUserMessageSourceSchema = z.enum([
+  "agent_listing_delta",
   "background_task",
   "fork",
   "goal_state_change",
   "goal-continuation",
   "plugin_reference",
+  "bot_topic_context",
   "rewind",
   "selection_side_chat",
   "subagent",
@@ -71,7 +73,7 @@ export const zcodePermissionResponseSchema = z
   })
   .strict();
 export type ZCodePermissionResponse = z.infer<typeof zcodePermissionResponseSchema>;
-export const zcodeSessionModeSchema = z.enum(["plan", "build", "edit", "yolo", "auto"]);
+export const zcodeSessionModeSchema = z.enum(["plan", "build", "edit", "yolo", "guarded", "auto"]);
 export const zcodeSessionStatusSchema = z.enum([
   "idle",
   "running",
@@ -89,6 +91,17 @@ export const zcodeSessionKindSchema = z.enum([
   "subagent_child",
   "nested_workflow_child",
 ]);
+// 修复原因：只识别 subagent_child 会漏掉工作流与辅助对话的父归属、隐藏索引规则。
+// fork 和 workflow_parent 是独立任务，即使有 parentSessionId 也不能沿父链改写项目。
+export function isAuxiliarySessionKind(kind: string | undefined): boolean {
+  return isReadonlyAgentSessionKind(kind) || kind === "selection_side_chat";
+}
+
+// 辅助对话可继续输入；只有由 Agent / 工作流驱动的子会话对用户只读。
+export function isReadonlyAgentSessionKind(kind: string | undefined): boolean {
+  return kind === "subagent_child" || kind === "workflow_child" || kind === "nested_workflow_child";
+}
+
 export const zcodeSessionGoalSchema = z
   .object({
     sessionId: nonEmptyString,
@@ -147,7 +160,6 @@ export const zcodeSessionInfoSchema = z
     target: zcodeSessionGoalSchema.nullable().optional(),
     createdAt: timestampMsSchema,
     updatedAt: timestampMsSchema,
-    archivedAt: timestampMsSchema.optional(),
   })
   .strict();
 export type ZCodeSessionInfo = z.infer<typeof zcodeSessionInfoSchema>;

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/apply.ts

@@ -2,10 +2,10 @@
 // 这是协议语义的一部分：coalesce 的「语义保持」就以本函数为裁判——
 // applyAll(s, coalesce(ds)) 必须与 applyAll(s, ds) 逐字节一致（黄金测试）。
 // 客户端 store 的 apply 逻辑是本函数的宿主化改写，不得引入额外分支。
+import type { StreamablePath } from "./core.js";
 import type { ConversationDelta } from "./delta.js";
-import type { ConversationSnapshot } from "./snapshot.js";
 import type { ConversationRow } from "./rows.js";
-import type { StreamablePath } from "./core.js";
+import type { ConversationSnapshot } from "./snapshot.js";
 import { applyWorkflowRunRemoved, applyWorkflowRunUpdated } from "./workflow-runs-delta.js";
 
 /**
@@ -34,9 +34,13 @@ export function createMutableConversationSnapshotAccumulator(
   };
 }
 
-// row.delta 只允许作用于流式态行（不变量，服务端保证）。
-// 本函数按协议语义实现为：路径不存在/行不存在时 no-op（patch 命中未加载行 = no-op）。
-function appendToRow(row: ConversationRow, path: StreamablePath, append: string): ConversationRow {
+// row.delta 只允许作用于流式态行（§4.4.4 不变量，服务端保证）。
+// 本函数按协议语义实现为：路径不存在/行不存在时 no-op（§4.3：patch 命中未加载行 = no-op）。
+function appendToRow(
+  row: ConversationRow,
+  path: StreamablePath,
+  append: string,
+): ConversationRow {
   switch (path) {
     case "text":
       if (row.kind === "assistantText" || row.kind === "reasoning") {
@@ -81,15 +85,19 @@ export function applyConversationDelta(
         },
       };
     case "row.upserted": {
-      const index = snapshot.rows.window.findIndex((row) => row.rowId === delta.row.rowId);
-      // 未加载 rowId = no-op（被逐出的行只能经 rows/range 取回）。
+      const index = snapshot.rows.window.findIndex(
+        (row) => row.rowId === delta.row.rowId,
+      );
+      // §4.3：未加载 rowId = no-op（被逐出的行只能经 rows/range 取回）。
       if (index === -1) return snapshot;
       const window = [...snapshot.rows.window];
       window[index] = delta.row;
       return { ...snapshot, rows: { ...snapshot.rows, window } };
     }
     case "row.removed": {
-      const window = snapshot.rows.window.filter((row) => row.rowId < delta.fromRowId);
+      const window = snapshot.rows.window.filter(
+        (row) => row.rowId < delta.fromRowId,
+      );
       const removed = snapshot.rows.window.length - window.length;
       const removesEntireActiveBranch =
         snapshot.rows.firstRowId !== null && delta.fromRowId <= snapshot.rows.firstRowId;
@@ -109,7 +117,9 @@ export function applyConversationDelta(
       };
     }
     case "row.delta": {
-      const index = snapshot.rows.window.findIndex((row) => row.rowId === delta.rowId);
+      const index = snapshot.rows.window.findIndex(
+        (row) => row.rowId === delta.rowId,
+      );
       const target = snapshot.rows.window[index];
       if (index === -1 || target === undefined) return snapshot;
       const window = [...snapshot.rows.window];
@@ -119,6 +129,12 @@ export function applyConversationDelta(
     case "state.updated":
       // 键级整体替换：patch 中在场的键覆盖，绝不深合并。
       return { ...snapshot, ...delta.patch };
+    case "pluginUi.resourceUpdated":
+    case "pluginUi.resourceListChanged":
+    case "pluginUi.instanceClosed":
+    case "pluginUi.appToolCall":
+      // live-only 通知 / 信箱投递：不改变快照，由 renderer 另行派发。
+      return snapshot;
     // workflowRuns 是唯一开了增量口子的状态键（delta.ts 的注释讲了为什么）。规则整份住在
     // workflow-runs-delta.ts：两个 twin 都只转调它，两边的语义因此没有走散的余地。
     case "workflowRun.updated":
@@ -199,6 +215,9 @@ export function applyConversationDeltaMutable(
       // 与不可变实现相同：patch 在场键整体替换，不能深合并。
       Object.assign(snapshot, delta.patch);
       return;
+    case "pluginUi.resourceUpdated":
+    case "pluginUi.resourceListChanged":
+      return;
     // 与不可变实现调同一个纯函数：workflowRuns 是状态键不是 rows 窗口，没有「原地追加」可优化，
     // 而 accumulator.snapshot 本来就是候选快照自己的对象，赋一个新容器不会碰到已发布的快照。
     case "workflowRun.updated":

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/attachment-ref.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { attachmentSourceKindSchema } from "../attachment-source.js";
 
 /** 仅承载已提交内容引用与展示元信息；内容本体不进入 command/topic frame。 */
 export const attachmentRefSchema = z
@@ -7,6 +8,8 @@ export const attachmentRefSchema = z
     fileName: z.string(),
     mime: z.string(),
     bytes: z.number(),
+    sourceKind: attachmentSourceKindSchema.optional(),
+    messageCount: z.number().int().nonnegative().optional(),
     previewRef: z.string().optional(),
   })
   .strict();

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/command.ts

@@ -1,4 +1,6 @@
+import { createSessionRequestedConfigSchema } from "./create-session-config.js";
 import { localTtftContextSchema, localTtftClockSchema } from "../localTtft.js";
+import { conversationQuotesSchema } from "../conversationSelection.js";
 // Command 层：信封 / ACK / 命令全集 payload。
 // conversation rewind 无独立命令（裁决：= editUserQuery 的 UI 入口）；
 // workspace-only 文件撤销走 applyFileRewind，不截断聊天历史。
@@ -9,7 +11,8 @@ import { v4ConversationFileRewindPreviewResultSchema } from "./transport.js";
 import { modelSelectionSchema } from "../model-selection.js";
 import { modelExecutionSchema } from "../model-execution.js";
 import { submissionModeSchema } from "./submission.js";
-import { zcodeAutomationBotDeliveryTargetSchema } from "../bots.js";
+import { botGroupInputSourceSchema, zcodeAutomationBotDeliveryTargetSchema } from "../bots.js";
+import { DYNAMIC_WORKFLOW_MODES } from "../dynamic-workflow-feature.js";
 import {
   amendWorkflowRunSettingsPayloadSchema,
   amendWorkflowRunSettingsResultSchema,
@@ -24,27 +27,36 @@ import {
   zcodeBrowserAmbientContextSchema,
   zcodeProtocolMcpServerSchema,
 } from "../zcode-protocol/index.js";
+import { highspeedMessageMetaSchema } from "../highspeed.js";
 import { sharedContextRefSchema } from "./shared-context-ref.js";
+import { conversationInputSourceSchema } from "./input-intent.js";
 export type { SharedContextRef } from "./shared-context-ref.js";
+export * from "./workflow-command-rejections.js";
 
-const createSessionRequestedConfigSchema = z.object({
-  modelSelection: modelSelectionSchema.optional(),
-  provider: z.string().optional(),
-  model: z.string().optional(),
-  thought: z.string().optional(),
-  followupMode: z.enum(["queue", "guide"]).optional(),
-  // createSession.config 表达“请求覆盖字段”，不能复用 snapshot 的
-  // sessionConfigStateSchema.partial()；snapshot 为兼容旧快照给 mode 设了 default("build")，
-  // 会把“没传 mode”误变成“请求切回 build”，覆盖 workspace 默认 yolo。
-  mode: z.string().optional(),
-  planEnabled: z.boolean().optional(),
-});
+// sendText / editUserQuery / sendQueuedNow 共用的执行材料不变量：modelExecution 只能依附
+// 本次 modelSelection，禁止在缺 Selection 时单独补供凭据（历史消息 rewind 后不复用旧凭据）。
+function requireModelSelectionForExecution(
+  payload: { modelSelection?: unknown; modelExecution?: unknown },
+  context: z.RefinementCtx,
+): void {
+  if (payload.modelExecution && !payload.modelSelection) {
+    context.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: "modelExecution requires modelSelection",
+      path: ["modelExecution"],
+    });
+  }
+}
 
-// ── 命令 payload 全集 ──
+// ── §6.4 命令 payload 全集 ──
 export const commandPayloadSchemas = {
   // firstInput 缺省 → phase=draft 空会话；携带 → 直接 turnHeader+userInput rows。
   createSession: z.object({
+    // Host 预留归属使用稳定 ID；CLI 仍负责拒绝覆盖既有会话。
+    sessionId: z.string().min(1).optional(),
+    additionalDirectories: z.array(z.string().min(1)).max(256).optional(),
     workspaceId: z.string(),
+    permissionScope: z.literal("session").optional(),
     firstInput: z
       .object({
         text: z.string(),
@@ -63,6 +75,8 @@ export const commandPayloadSchemas = {
     offPeakToolEnabled: z.boolean().optional(),
     // 动态工作流灰度 flag，与 offPeakToolEnabled 同一模式。
     dynamicWorkflowEnabled: z.boolean().optional(),
+    // 灰度 mode 与布尔同行（launch.md「On demand: activation」）；旧 CLI 的 z.object 静默丢弃。
+    dynamicWorkflowMode: z.enum(DYNAMIC_WORKFLOW_MODES).optional(),
   }),
   // 父会话由 envelope.sessionId 指定；服务端从父 record 派生完整运行配置。
   // firstInput 存在时，child 创建完成后立即启动首条普通输入；缺省则保持空副屏。
@@ -89,6 +103,8 @@ export const commandPayloadSchemas = {
       // Share handover 只允许当前 session 的一个已导入上下文；完整正文由 runtime 从
       // 持久化 provenance 解析，不能随 command 从 renderer 传入。
       context_refs: z.array(sharedContextRefSchema).max(1).optional(),
+      // 插件 UI 代发（ui/message）时的来源标记；随 intent 持久化并投影到 userInput row。
+      source: conversationInputSourceSchema.optional(),
       heldQueueDisposition: z.enum(["clearQueueAndSend", "keepQueueAndSend"]).optional(),
       // 暂停队列确认框打开时看到的 queueItemId 集合。CLI 在执行 clear/keep 前校验，
       // 防止桌面/手机并发增删后把用户没确认过的新队列一并处置。
@@ -101,11 +117,18 @@ export const commandPayloadSchemas = {
       // 本次执行仍使用上面的标准 Selection；这里只携带不持久化语义、动态鉴权和 child 策略。
       // 仅 idle startNow 接受，防止 Secret/Ticket 进入普通 CommandInbox。
       modelExecution: modelExecutionSchema.optional(),
+      // Highspeed 卡快照随输入事实进入 message.data；不包含 runtime 凭据或 header。
+      // 加速本轮的模型与凭据走上面的 modelSelection + modelExecution，见
+      // docs/highspeed/highspeed-access-mode-migration.md。
+      highspeedMeta: highspeedMessageMetaSchema.optional(),
       automationId: z.string().min(1).optional(),
       offPeakTaskId: z.string().min(1).optional(),
       offPeakRunType: z.enum(["init", "resume"]).optional(),
       // Bot 来源只由 Host 注入，用于 CronCreate 在当前 turn 内读取并持久化回推地址。
       botDeliveryTarget: zcodeAutomationBotDeliveryTargetSchema.optional(),
+      inputOrigin: z.enum(["desktop", "mobile"]).optional(),
+      botGroupSource: botGroupInputSourceSchema.optional(),
+      conversationQuotes: conversationQuotesSchema.optional(),
       // 定时任务会话的后续用户输入也必须保持 turn-scoped 工具面隔离；不能借用
       // automationId，否则会把普通用户输入误标成一次 automation 派发。
       toolDisallowlist: z.array(z.string().min(1)).optional(),
@@ -124,13 +147,7 @@ export const commandPayloadSchemas = {
           path: ["offPeakRunType"],
         });
       }
-      if (payload.modelExecution && !payload.modelSelection) {
-        context.addIssue({
-          code: z.ZodIssueCode.custom,
-          message: "modelExecution requires modelSelection",
-          path: ["modelExecution"],
-        });
-      }
+      requireModelSelectionForExecution(payload, context);
     }),
   sendGoalCommand: z.object({
     text: z.string(),
@@ -151,19 +168,48 @@ export const commandPayloadSchemas = {
   // running 时对稳定 assistant row 可用。
   forkAssistant: z.object({ target: conversationRowTargetSchema }),
   applyFileRewind: z.object({ target: conversationRowTargetSchema }),
-  editUserQuery: z.object({
+  editUserQuery: z
+    .object({
     target: conversationRowTargetSchema,
     newText: z.string(),
+      conversationQuotes: conversationQuotesSchema.optional(),
     attachments: z.array(attachmentRefSchema).optional(),
+      // 编辑重发按新的主动发送处理：只接受本次重新 prepare 得到的卡与执行材料，
+      // 不从被 rewind 的历史消息复用旧凭据。
+      modelSelection: modelSelectionSchema.optional(),
+      modelExecution: modelExecutionSchema.optional(),
+      highspeedMeta: highspeedMessageMetaSchema.optional(),
     // 缺省 preserve：仅切 conversation branch；rewind 会先安全恢复该轮文件。
     workspaceMode: z.enum(["preserve", "rewind"]).optional(),
-  }),
+    })
+    .superRefine(requireModelSelectionForExecution),
   retryTurn: z.object({ target: conversationRowTargetSchema }),
+  // （2026-09-12）：原 setToolWidgetState / setSessionPluginUiState 已删除——插件 UI widgetState
+  // 回退为宿主 renderer 内存保存，不再写 CLI 会话存储；模型可见信息改走 ui/update-model-context。
   setAssistantFeedback: z.object({
     target: conversationRowTargetSchema,
     feedback: z.enum(["like", "dislike"]).nullable(),
   }),
-  sendQueuedNow: z.object({ queueItemId: z.string() }),
+  setHighspeedMetrics: z.object({
+    target: conversationRowTargetSchema,
+    regularTps: z.number().positive(),
+    outputTokens: z.number().int().nonnegative(),
+    durationMs: z.number().nonnegative(),
+    highspeedTps: z.number().positive(),
+    savedDurationMs: z.number().nonnegative(),
+    modelDurationMs: z.number().nonnegative().optional(),
+    toolDurationMs: z.number().nonnegative().optional(),
+    otherDurationMs: z.number().nonnegative().optional(),
+  }),
+  sendQueuedNow: z
+    .object({
+      queueItemId: z.string(),
+      // 手动提升允许 Renderer 为原队列项补充同卡执行材料；凭据不入队列持久化面。
+      modelSelection: modelSelectionSchema.optional(),
+      modelExecution: modelExecutionSchema.optional(),
+      highspeedMeta: highspeedMessageMetaSchema.optional(),
+    })
+    .superRefine(requireModelSelectionForExecution),
   editQueueItem: z.object({ queueItemId: z.string(), newText: z.string() }),
   // beforeQueueItemId = null → 移到队尾。
   reorderQueueItem: z.object({
@@ -213,7 +259,7 @@ export const commandPayloadSchemas = {
   // additive（冻结面按黄金测试背书演进）：agent 协作模式切换。
   // 值域 = core CollaborationMode 的可切换子集（auto 非用户可切，不进 UI 命令面）。
   switchCollaborationMode: z.object({
-    mode: z.enum(["build", "edit", "plan", "yolo"]),
+    mode: z.enum(["build", "edit", "plan", "yolo", "guarded"]),
   }),
   setFollowupMode: z.object({ mode: z.enum(["queue", "guide"]) }),
   pauseGoal: z.object({}),
@@ -231,7 +277,7 @@ export const commandPayloadSchemas = {
   // 同类：不携 baseRevision（workflowRuns 面免 revision，假 CAS 失败只会误伤）。name 由 agent 从
   // 解析结果填（不变式 6），命令不收 name 覆盖。
   // 拒绝以 fault.command.savedWorkflowStartRejected.<reason> 回 ACK（词表见下方
-  // savedWorkflowStartRejectionReasonSchema）；能力缺席（无 dwf 端口）→ V4CapabilityUnsupportedError
+  // workflow-command-rejections.ts 的 savedWorkflowStartRejectionReasonSchema）；能力缺席（无 dwf 端口）→ V4CapabilityUnsupportedError
   // （与 resumeWorkflowRun 同一条错误）。
   startSavedWorkflow: z.object({
     name: z.string().min(1),
@@ -258,33 +304,6 @@ export const commandTypeSchema = z.enum(
   Object.keys(commandPayloadSchemas) as [CommandType, ...CommandType[]],
 );
 
-// startSavedWorkflow 拒绝词表：
-// bootstrap handler 铸造 fault code，ui launcher 反查 i18n 文案，两侧共享此枚举避免漂移。
-// invalid_name / not_found：解析阶段；invalid_args：实参校验；compile_failed：analyzeScript 诊断；
-// session_busy：会话有活动 turn；start_failed：port.submit 之前的其它启动失败。
-export const savedWorkflowStartRejectionReasonSchema = z.enum([
-  "invalid_name",
-  "not_found",
-  "invalid_args",
-  "compile_failed",
-  "session_busy",
-  "start_failed",
-]);
-export type SavedWorkflowStartRejectionReason = z.infer<
-  typeof savedWorkflowStartRejectionReasonSchema
->;
-
-// 完整 fault code = 前缀 + reason（如 fault.command.savedWorkflowStartRejected.not_found）。
-// 与 workflowRunResumeRejected 命名空间同族；导出常量供 bootstrap 拼接、ui 前缀匹配。
-export const SAVED_WORKFLOW_START_REJECTED_FAULT_PREFIX =
-  "fault.command.savedWorkflowStartRejected." as const;
-
-// resumeWorkflowRun 的拒绝：前缀 + 端口 reason（not_found / not_resumable / superseded /
-// already_running / script_missing / script_mismatch / compile_failed）；`ack.message` 携带
-// compile_failed 的有界诊断。
-export const WORKFLOW_RUN_RESUME_REJECTED_FAULT_PREFIX =
-  "fault.command.workflowRunResumeRejected." as const;
-
 // cancelBackgroundWork 的拒绝：core 明确回「没有取消任何东西」时（任务不存在 / 已终结 / 类型不支持）
 // 以前缀 + reason 上行，而不是一个假装成功的 accepted——详情页据此告诉用户这个 run 并不在跑。
 // reason 即 core 的 stopBackgroundTask reason 去掉 `background_task_` 前缀：not_found /
@@ -317,6 +336,7 @@ export const ROW_TARGETING_COMMANDS: ReadonlySet<CommandType> = new Set([
   "editUserQuery",
   "retryTurn",
   "setAssistantFeedback",
+  "setHighspeedMetrics",
 ]);
 
 // ── 信封 ──

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/create-session-config.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import { modelSelectionSchema } from "../model-selection.js";
+
+export const createSessionRequestedConfigSchema = z.object({
+  modelSelection: modelSelectionSchema.optional(),
+  provider: z.string().optional(),
+  model: z.string().optional(),
+  thought: z.string().optional(),
+  followupMode: z.enum(["queue", "guide"]).optional(),
+  // Bugfix：createSession.config 表达“请求覆盖字段”，不能复用 snapshot 的
+  // sessionConfigStateSchema.partial()；snapshot 为兼容旧快照给 mode 设了 default("build")，
+  // 会把“没传 mode”误变成“请求切回 build”，覆盖 workspace 默认 yolo。
+  mode: z.string().optional(),
+  planEnabled: z.boolean().optional(),
+});

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/create-workflow-display.ts

@@ -41,7 +41,10 @@ const toolCallCreateWorkflowCausalityGraphSchema = z
         z
           .object({
             id: z.string().min(1).max(64),
-            kind: z.enum(["ask", "world-read"]),
+            // `hole`：开着的留白自己的站点（docs/dynamic-workflow/presentation.md「Holes on the timeline」），
+            // 车道恒为 `main`、阶段是留白自己的阶段（无成员）；run 的 `holes[]` 按 siteId 与它相接。
+            // 与 contracts 的 CREATE_WORKFLOW_STEP_KINDS 同步。
+            kind: z.enum(["ask", "world-read", "hole"]),
             label: z.string().min(1).max(128),
             // 内联 `agent()` receiver 让 label 落到兜底串时，那个名字的静态形状。
             labelPattern: namePatternSchema.optional(),
@@ -56,6 +59,11 @@ const toolCallCreateWorkflowCausalityGraphSchema = z
             // 与图的 phases / phaseEdges / exits 同进同退：全在场或全缺席。
             phase: z.string().min(1).max(64).optional(),
             repeat: z.enum(["stack", "serial"]).optional(),
+            // 这个站点是某次补全写进来的（docs/dynamic-workflow/presentation.md「Holes on the timeline」）：
+            // 值是那个留白的站点 id（名字键 `hole#<8 位十六进制>`）；留白**自己的**阶段 / 站上是包着它的
+            // 留白（嵌套关系只在这里，id 里没有）。时间线据阶段上的同名键画补全的头与区域，step 上的这一份
+            // 是检视器素材。additive：旧载荷不带它照常通过 .strict()。
+            fill: z.string().min(1).max(64).optional(),
           })
           .strict(),
       )
@@ -116,12 +124,38 @@ const toolCallCreateWorkflowCausalityGraphSchema = z
             // 为空时缺席。是节点事实而不是边——控制没有从那里转移过来，所以不进 phaseEdges。
             // 时间轴据此把相邻阶段折成一条分叉的「带」，侧栏迷你轨道画成双线段。
             alongside: z.array(z.string().min(1).max(64)).min(1).max(32).optional(),
+            // 这个阶段是某次补全写进来的：值是那个留白的站点 id。时间线把同一个 `fill` 的连续几站折成
+            // 一段「补全的头 + 区域」（docs/dynamic-workflow/presentation.md「Holes on the timeline」）。
+            fill: z.string().min(1).max(64).optional(),
           })
           .strict(),
       )
       .max(32)
       .optional(),
     phaseEdges: z.array(workflowEdgeSchema).max(128).optional(),
+    // 阶段流（docs/dynamic-workflow/presentation.md「Streams」）：两端互为 alongside 的 data 边，
+    // 只有 {from, to}——不是 runs after，不进 phaseEdges、不带 back。与词汇表同进同退。
+    phaseStreams: z
+      .array(z.object({ from: z.string().min(1).max(64), to: z.string().min(1).max(64) }).strict())
+      .max(128)
+      .optional(),
+    // 还开着的留白，源码序（docs/dynamic-workflow/authoring.md「Holes」）：一个留白就是一个阶段（id =
+    // 站点 id、name = 字面量），所以它同时在 `phases` 里；这张表只补阶段表说不出的两件事——它是留白、
+    // 它的类型原文——外加 `tail`（它是脚本的尾巴：轨道要在它之后多跑 40px 再淡出）。补全过的留白不在这里。
+    holes: z
+      .array(
+        z
+          .object({
+            siteId: z.string().min(1).max(64),
+            name: z.string().min(1).max(128),
+            type: z.string().min(1).max(128),
+            phase: z.string().min(1).max(64).optional(),
+            tail: z.boolean().optional(),
+          })
+          .strict(),
+      )
+      .max(32)
+      .optional(),
     // 控制流可在其后正常完成的阶段（阶段视图的「阶段 → 返回物」箭头）；组内可为空数组。
     exits: z.array(z.string().min(1).max(64)).max(32).optional(),
     sink: z.array(z.string().min(1).max(64)).max(64).optional(),
@@ -151,6 +185,18 @@ export const toolCallCreateWorkflowDisplaySchema = z
       .max(100),
     causalityGraph: toolCallCreateWorkflowCausalityGraphSchema.optional(),
     truncated: z.boolean().optional(),
+    // FillWorkflowHole 行补的是哪处留白（docs/dynamic-workflow/presentation.md「The fill row」）：站点 id、
+    // **名字**、草稿路径与行号。行靠它给自己起名、卡的联接靠它累积头的标签——transcript 只存模型自己的
+    // 入参，resolveInput 回填的 `hole` 块到不了行，所以名字必须随 display 走。成功与被拒都在场。
+    fill: z
+      .object({
+        siteId: z.string().min(1).max(64),
+        name: z.string().min(1).max(128),
+        draftPath: z.string().min(1).max(1_024).optional(),
+        line: z.number().int().positive().optional(),
+      })
+      .strict()
+      .optional(),
   })
   .strict();
 export type ToolCallCreateWorkflowDisplay = z.infer<typeof toolCallCreateWorkflowDisplaySchema>;

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/delta.ts

@@ -1,4 +1,5 @@
-// ConversationDelta：七个操作，封闭集合。
+import { mcpAppInstanceSchema } from "../mcp-apps/instance.js";
+// ConversationDelta：快照增量与插件 UI 的 live-only 通知，操作集合封闭（10-protocol-spec §4.5）。
 // 没有 row.inserted（中间插入）、没有 row.moved、没有字段级 JSON patch——
 // 凡此模型表达不了的结构变化，服务端一律发 snapshot resync，刻意压缩客户端错误面。
 //
@@ -18,6 +19,7 @@ import {
   pendingInteractionSchema,
   planStateSchema,
   queueStateSchema,
+  runtimeInitializationSchema,
   sessionActionAvailabilitySchema,
   sessionConfigStateSchema,
   sessionControlSchema,
@@ -37,6 +39,7 @@ import {
 
 // StatePatch：键级整体替换（Object.assign），键集合封闭。键内绝不深合并。
 export const statePatchSchema = z.object({
+  runtimeInitialization: runtimeInitializationSchema.optional(),
   revision: z.number().optional(),
   control: sessionControlSchema.optional(),
   sharedContextImport: sharedContextImportStateSchema.optional(),
@@ -61,10 +64,19 @@ export const statePatchSchema = z.object({
 });
 export type StatePatch = z.infer<typeof statePatchSchema>;
 
+export const pluginUiResourceSubscriberSchema = z
+  .object({
+    scopeId: z.string(),
+    generation: z.number().int().nonnegative(),
+    instance: mcpAppInstanceSchema,
+  })
+  .strict();
+
 /**
  * run 的 **header** = `workflowRunSchema` 减去 actors / nodes 两张按实例增量同步的表。
  *
- * 使用 `.omit` 从同一 schema 派生，避免独立维护的字段表不一致导致订阅解析失败。小集合（reports / artifacts / phases / pendingQuestions…）留在 header 里整键替换——
+ * `.omit` 派生而不是手抄一份字段表：2026-09-04 的那次订阅永久失效就是「两处各写一份 run 词汇表」
+ * 的后果。小集合（reports / artifacts / phases / pendingQuestions…）留在 header 里整键替换——
  * 它们的上界都是几十条，为它们再开一套增量语法只会多一套能写错的东西。
  */
 export const workflowRunHeaderSchema = workflowRunSchema.omit({ actors: true, nodes: true });
@@ -106,6 +118,40 @@ export const conversationDeltaSchema = z.discriminatedUnion("op", [
     append: z.string(),
   }),
   z.object({ op: z.literal("state.updated"), patch: statePatchSchema }),
+  // 插件 UI 订阅的 MCP 资源通知。live-only：不改快照（apply 为 no-op）、不进冷恢复；
+  // renderer 按 subscribers 派发给对应沙箱实例。
+  z.object({
+    op: z.literal("pluginUi.resourceUpdated"),
+    pluginId: z.string(),
+    serverName: z.string(),
+    uri: z.string(),
+    subscribers: z.array(pluginUiResourceSubscriberSchema),
+  }),
+  z.object({
+    op: z.literal("pluginUi.resourceListChanged"),
+    pluginId: z.string(),
+    serverName: z.string(),
+    subscribers: z.array(pluginUiResourceSubscriberSchema),
+  }),
+  z.object({
+    op: z.literal("pluginUi.instanceClosed"),
+    pluginId: z.string(),
+    serverName: z.string(),
+    subscribers: z.array(pluginUiResourceSubscriberSchema),
+  }),
+  // App-Provided Tools 的"实例信箱"：模型发起的页面工具调用，live-only 投递给唯一实例（subscribers 恰一项）；
+  // 渲染端认领后页面 tools/call，结果经 mcp/uiResolveAppToolCall 回传。不改快照、不进冷恢复。
+  z.object({
+    op: z.literal("pluginUi.appToolCall"),
+    activity: z.boolean().optional(),
+    cancelled: z.boolean().optional(),
+    pluginId: z.string(),
+    serverName: z.string(),
+    subscribers: z.array(pluginUiResourceSubscriberSchema),
+    callId: z.string(),
+    toolName: z.string(),
+    arguments: z.record(z.string(), z.unknown()),
+  }),
   /**
    * 一条 dwf run 的键级增量。`revision` 是**这次变化之后**的 `workflowRuns.revision`（绝对值）；
    * 一条引擎事件最多产生一条本 op（节点相位、派生的 actor 状态、用量、水位一起落地，原子）。
@@ -143,5 +189,15 @@ export const conversationDeltaSchema = z.discriminatedUnion("op", [
   }),
 ]);
 export type ConversationDelta = z.infer<typeof conversationDeltaSchema>;
+export type PluginUiResourceDelta = Extract<
+  ConversationDelta,
+  { op: "pluginUi.resourceUpdated" | "pluginUi.resourceListChanged" }
+>;
+export type PluginUiAppToolCallDelta = Extract<ConversationDelta, { op: "pluginUi.appToolCall" }>;
+/** 按沙箱实例投递的全部 live-only 增量。 */
+export type PluginUiInstanceDelta =
+  | Extract<ConversationDelta, { op: "pluginUi.instanceClosed" }>
+  | PluginUiResourceDelta
+  | PluginUiAppToolCallDelta;
 export type WorkflowRunUpdatedDelta = Extract<ConversationDelta, { op: "workflowRun.updated" }>;
 export type WorkflowRunRemovedDelta = Extract<ConversationDelta, { op: "workflowRun.removed" }>;

package/server/vendor/zcode/packages/shared/src/zcode-protocol-v4/input-intent.ts

@@ -1,12 +1,38 @@
+import { conversationQuotesSchema } from "../conversationSelection.js";
+import { botGroupInputSourceSchema } from "../bots.js";
 // CLI admission 后的自包含输入事实。
 // queue / guide / runtime / transcript 只能携带同一个 intent，不允许各层重建字段。
 import { z } from "zod";
 import { timestampSchema } from "./core.js";
 import { attachmentRefSchema } from "./attachment-ref.js";
+import { highspeedMessageMetaSchema } from "../highspeed.js";
 import { modelSelectionSchema } from "../model-selection.js";
 import { submissionModeSchema } from "./submission.js";
 import { sharedContextRefSchema } from "./shared-context-ref.js";
 
+/**
+ * 用户输入的结构化来源：插件 UI 经 `ui/message`
+ * 代用户发送时带上，落库后卡片显示"来自插件 X"。缺省即用户亲自输入。
+ */
+const pluginUiInputSourceSchema = z
+  .object({
+    kind: z.literal("pluginUi"),
+    pluginId: z.string().min(1),
+    toolCallId: z.string().min(1),
+  })
+  .strict();
+export const conversationInputSourceSchema = z.discriminatedUnion("kind", [
+  pluginUiInputSourceSchema,
+  z
+    .object({
+      kind: z.literal("genUi"),
+      path: z.string().min(1).max(4096),
+      title: z.string().max(250).optional(),
+    })
+    .strict(),
+]);
+export type ConversationInputSource = z.infer<typeof conversationInputSourceSchema>;
+
 export const conversationInputDeliverySchema = z
   .object({
     requested: z.enum(["auto", "startNow", "queue", "guide"]),
@@ -38,6 +64,9 @@ export const conversationInputDispatchSchema = z
 
 export const conversationInputIntentSchema = z
   .object({
+    inputOrigin: z.enum(["desktop", "mobile"]).optional(),
+    botGroupSource: botGroupInputSourceSchema.optional(),
+    conversationQuotes: conversationQuotesSchema.optional(),
     sourceCommandId: z.string().min(1),
     queueItemId: z.string().min(1),
     clientId: z.string().min(1),
@@ -55,6 +84,7 @@ export const conversationInputIntentSchema = z
     steer: conversationInputSteerSchema,
     dispatch: conversationInputDispatchSchema,
     admittedAt: timestampSchema,
+    highspeed: highspeedMessageMetaSchema.optional(),
     provenance: z
       .object({
         sourceCommandId: z.string().min(1),
@@ -63,6 +93,7 @@ export const conversationInputIntentSchema = z
       })
       .strict()
       .optional(),
+    source: conversationInputSourceSchema.optional(),
   })
   .strict();