@zhushanwen/pi-subagent-workflow 8.5.0 → 8.7.0

package/src/interface/subagent-tool.ts

@@ -9,19 +9,19 @@
 // Theme、ExtensionContext）会触发 TS2307 误报（probe5d/5f 验证）。
 // 抽到顶层后参数类型由 alias 提供，绕过该 quirk。
 
+import { isAbsolute } from "node:path";
+
 import type { Component } from "@earendil-works/pi-tui";
-import { StringEnum } from "@earendil-works/pi-ai";
 import type { AgentToolResult, ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 import { getLogger } from "@zhushanwen/pi-extension-logger";
-import { type Static, Type } from "typebox";
+import type { Static } from "typebox";
 
-import { SLUG_MAX_LENGTH } from "../execution/execute-options-mapper.ts";
-import { THINKING_ORDER } from "../execution/model-resolver.ts";
-import { getSubagentService } from "../execution/subagent-service.ts";
-import type { SubagentToolResult } from "../execution/types.ts";
+import { getSubagentService } from "@zhushanwen/subagent-core/execution/subagent-service.ts";
+import type { SubagentToolResult } from "@zhushanwen/subagent-core/execution/types.ts";
 import { extractAgentName } from "./format.ts";
 import { toGuiCtx } from "./gui-mappers.ts";
-import { adapter, cancelHandler, closeHandler, listHandler, messageHandler, startHandler } from "./subagent-actions.ts";
+import { adapter, cancelHandler, closeHandler, forkFromHandler, listHandler, messageHandler, startHandler } from "./subagent-actions.ts";
+import { SubagentParams } from "./subagent-tool-schema.ts";
 import { type RenderContext,renderSubagentCall, renderSubagentResult } from "./tool-render.ts";
 
 // ============================================================
@@ -54,128 +54,14 @@ type SubagentRenderResultCb = (
   ctx: RenderContext,
 ) => Component;
 
-// ============================================================
-// Params schema
-// ============================================================
-
-// Params schema（模块内消费，未导出）。
-//
-// action:"start" 的 13 字段（task/slug/agent/model/...）拍平在顶层，不再用 startParam
-// 嵌套容器包。原因：弱模型（GLM/DeepSeek）信任 schema 结构信号 > 文本信号，经常省略
-// startParam 嵌套层把 task/slug 直接平铺到顶层导致调用失败。拍平后 schema 结构与模型
-// 的自然倾向一致，消除这层误用。task/slug 必填性由 startHandler runtime 校验（flat
-// JSON Schema 无法表达「action 条件必填」）。
-//
-// TODO(long-term, option-A): listParam/cancelParam 仍标 Optional 也是 flat JSON Schema
-// 表达「action 分发条件必填」的妥协——长期方案是拆成 3 个独立 tool
-// （subagent_start / subagent_list / subagent_cancel），让每个 tool 的 schema 真实
-// 反映必填性。勿在此基础上继续堆 action 条件逻辑——要加就拆 tool。
-const SubagentParams = Type.Object({
-  action: StringEnum(["start", "list", "cancel", "message", "close"], {
-    description: "Operation: 'start' runs a subagent, 'list' shows subagents, 'cancel' stops a background subagent, 'message' sends a follow-up to a running subagent (one-shot subagents are auto-upgraded to conversation mode on first message), 'close' ends a running subagent (conversation-mode or one-shot).",
-  }),
-  // ── action:"start" fields (flattened to top level). task/slug REQUIRED for start. ──
-  // Missing/empty task or slug throws at runtime (startHandler).
-  // (flat JSON Schema can't express conditional requirement — see file-level TODO.)
-  task: Type.Optional(Type.String({
-    description: "REQUIRED for action:'start'. The task for the subagent to execute. Throws if missing or whitespace-only.",
-  })),
-  slug: Type.Optional(Type.String({
-    description:
-      "REQUIRED for action:'start'. Short label (≤35 chars) for this subagent, e.g. 'fix-login', 'extract-urls'. " +
-      "Shown in TUI to distinguish concurrent subagents.",
-    maxLength: SLUG_MAX_LENGTH,
-  })),
-  agent: Type.Optional(Type.String({
-    description: 'Agent ref: absolute path to the agent .md file (use <location> from <available_subagents>). If omitted, defaults to "general-purpose" — a generic agent that inherits the main agent\'s model and project context. Do not invent names — only use paths from the injected list.',
-  })),
-  model: Type.Optional(Type.String({
-    description: 'Model override in "provider/modelId" format. Resolution order (top wins): (1) this param, (2) agent .md frontmatter model, (3) the main agent\'s current model (zero-config default). An explicit model (param or frontmatter) that is missing or unauthorized THROWS — there is no silent fallback to the main model. Omit this param to inherit the main model.',
-  })),
-  thinkingLevel: Type.Optional(StringEnum(THINKING_ORDER, {
-    description: "Thinking depth override (derived from THINKING_ORDER SSOT, includes 'max'). Omit to default to the model's highest available level (not the main agent's level).",
-  })),
-  skillPath: Type.Optional(Type.String()),
-  appendSystemPrompt: Type.Optional(Type.Array(Type.String())),
-  schema: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
-  maxTurns: Type.Optional(Type.Number({
-    description: "Turn limit. The subagent is terminated via SIGTERM after maxTurns turn_end events + graceTurns of slack. There is no graceful wrap-up message — the process is killed. 0 or omitted = unlimited.",
-  })),
-  graceTurns: Type.Optional(Type.Number({
-    description: "Extra turns allowed after maxTurns is reached before SIGTERM (default 2). Only meaningful when maxTurns is set.",
-  })),
-  fork: Type.Optional(Type.Boolean({
-    description: "Fork mode: inherit the parent's conversation context. When true, the subagent receives the parent's session file via --fork and builds a branched conversation (it sees prior turns/messages). The subagent still runs in a separate spawned child process (process isolation) — fork is about context inheritance, not process sharing; independent of worktree (file-system isolation, see worktree param). When to use: only when the task extends from the parent and genuinely needs key information from the parent's conversation history that a self-contained task prompt cannot carry — most tasks a plain prompt can describe do NOT need fork, so keep false by default and enable only when the user explicitly asks or the task truly depends on seeing prior turns. Caveat: fork drags in the parent's dispatch records and unrelated task context, polluting the subagent (it cannot tell 'context meant for me' from 'parent dispatching me'); when state lives in an external store the subagent can query (e.g., cw handoff), prefer that over fork.",
-  })),
-  worktree: Type.Optional(Type.Boolean({
-    description: "Worktree isolation: run the subagent in a dedicated git worktree, providing file-system level isolation from the parent session (prevents concurrent file-write conflicts). Independent of fork — worktree may be combined with fork:false (file isolation does not require context inheritance). When to use: parallel development scenarios where multiple agents write files concurrently and need isolated working directories (each gets its own checkout; merge later); leave false for single-agent or read-only tasks.",
-  })),
-  cwd: Type.Optional(Type.String({
-    description: 'Override the working directory for the subagent execution. Must be an absolute path. Defaults to the parent session\'s cwd.',
-  })),
-  conversation: Type.Optional(Type.Boolean({
-    description:
-      "Enable continuous chat with this subagent. When true, the subagent stays available after each reply — you can send follow-up messages (action:'message') and it keeps the full conversation context across rounds, with no need to re-spawn or re-explain. " +
-      "\nUse conversation:true for: multi-round collaboration (iterative review-fix loops, back-and-forth refinement), any task where you expect to send follow-up messages after the initial result. " +
-      "\nOmit (or false) for: one-shot tasks — single exploration, lookup, file read, code generation that needs no follow-up. The subagent runs once, notifies on completion, and is cleaned up automatically (default). " +
-      "\nFor long-interval collaboration (each round spaced >5min apart), set conversation:true AND increase idleTimeoutMs to avoid premature timeout. " +
-      "Cost: a conversation-mode subagent holds resources (memory, and a worktree if enabled) until you explicitly end it with action:'close'. Always close when done.",
-  })),
-  idleTimeoutMs: Type.Optional(Type.Number({
-    description:
-      "Idle timeout in milliseconds for conversation-mode subagents. Controls how long an idle subagent (between rounds) stays alive before automatic cleanup. " +
-      "Default: 300000 (5min). Override for long-interval collaboration where each round is spaced >5min apart. " +
-      "Only meaningful with conversation:true; ignored for one-shot subagents.",
-  })),
-  engine: Type.Optional(StringEnum(["pi", "zcode"], {
-    description:
-      "Execution engine for this subagent. Omit to inherit the global config. " +
-      "Three-layer priority: this parameter > agent .md frontmatter engine > config.json defaultEngine. " +
-      "Non-pi engines do not support conversation/fork/worktree (rejected before the subagent is created).",
-  })),
-  // action:"list" → listParam OPTIONAL (all fields optional, defaults apply). Ignored by other actions.
-  listParam: Type.Optional(Type.Object({
-    includeFinished: Type.Optional(Type.Boolean({
-      description: "Include finished (done/failed/cancelled) records. Default false (running only).",
-    })),
-    limit: Type.Optional(Type.Number({
-      description: "Max items to return. Default 20, clamped to [1, 100].",
-    })),
-  })),
-  // action:"cancel" → cancelParam.subagentId REQUIRED. Throws if missing. Ignored by other actions.
-  cancelParam: Type.Optional(Type.Object({
-    subagentId: Type.String({
-      description: "REQUIRED for action:'cancel'. The subagentId to cancel. Throws if missing. Only background subagents can be cancelled.",
-    }),
-  })),
-  // action:"message" → messageParam.subagentId + text REQUIRED. Any RUNNING subagent works —
-  // one-shot subagents are auto-upgraded to conversation mode on first message (SP-5); ended ones throw.
-  messageParam: Type.Optional(Type.Object({
-    subagentId: Type.String({
-      description: "REQUIRED for action:'message'. The subagentId to message (any running subagent; a one-shot subagent is auto-upgraded to conversation mode on first message, so you may also message one-shot subagents that are still running).",
-    }),
-    text: Type.String({
-      description: "REQUIRED for action:'message'. The message to send. Whitespace-only throws.",
-    }),
-    interrupt: Type.Optional(Type.Boolean({
-      description: "If true, interrupt the subagent's current work immediately (in-progress output stops, it switches to your new message). If false (default), the message is queued and processed after the current round completes. When the subagent is idle (between rounds), interrupt has no effect — the message always starts a new round.",
-    })),
-  })),
-  // action:"close" → closeParam.subagentId REQUIRED. Ends a running subagent (conversation-mode
-  // or one-shot — closeSubagent behavior split covers both).
-  closeParam: Type.Optional(Type.Object({
-    subagentId: Type.String({
-      description: "REQUIRED for action:'close'. The subagentId to close (any running subagent, conversation-mode or one-shot).",
-    }),
-    force: Type.Optional(Type.Boolean({
-      description: "If true, terminate immediately even if mid-round (in-progress work is lost). If false (default), let the current round finish, then close. When idle, the subagent closes immediately regardless.",
-    })),
-  })),
-});
-
 // ============================================================
 // renderCall 预解析 helper
 // ============================================================
+//
+// Params schema（SubagentParams）定义在 ./subagent-tool-schema.ts 纯常量叶子：
+// subagent-tool 依赖树沉重，structured-output 侧跨包契约测试需要零依赖 import
+// schema 常量经真实 typebox 编译校验（SW 自身 vitest 把 typebox alias 到 mock，
+// 丢 options——required/description 断言必须以真实构造为基准）。
 
 // extractAgentName 已上移到 ../tui/format.ts 共享（tool-render / subagent-tool 复用）。
 
@@ -185,13 +71,14 @@ function assertNever(value: never): string {
 }
 
 /** Subagent action 字面量联合（与 parameters schema 的 StringEnum 取值一致）。 */
-type SubagentAction = "start" | "list" | "cancel" | "message" | "close";
+type SubagentAction = "start" | "list" | "cancel" | "message" | "close" | "fork-from";
 
 /** 类型守卫：把 schema 投影出的 string 形式 action 收窄回字面量联合。
  *  typebox v1 的 StringEnum Static 退化为 string，需运行时校验 + 类型收窄
  *  才能恢复 switch 的 exhaustiveness 约束。 */
 function isSubagentAction(value: string): value is SubagentAction {
-  return value === "start" || value === "list" || value === "cancel" || value === "message" || value === "close";
+  return value === "start" || value === "list" || value === "cancel" || value === "message"
+    || value === "close" || value === "fork-from";
 }
 
 /** unknown 是否为含 model/thinkingLevel 的对象（类型守卫，替代全可选结构 `as`）。 */
@@ -199,6 +86,47 @@ function isModelOverrideObj(a: unknown): a is { model?: unknown; thinkingLevel?:
   return typeof a === "object" && a !== null;
 }
 
+/**
+ * start 路径类参数（skillPath / cwd）运行时守卫：绝对路径 + 禁 `..` 穿越。
+ *
+ * 校验链事实（pi 0.84.1 实装，登记 PS-20）：pi agent-loop 对注册 typebox schema
+ * 有运行时强校验——agent-loop.js:403-404 在 beforeToolCall / execute 之前调
+ * validateToolArguments（pi-ai validation.js:247：Value.Convert :249 + Compile :210
+ * + Check :265，失败 throw `Validation failed for tool` :272-273）→ catch 走
+ * immediate error（agent-loop.js:445-451），execute 不被调用。schema 的
+ * pattern（skillPath/cwd `^/`）/ maxLength（slug 35）是运行时强制而非仅模型可见
+ * 契约；tool-definition-wrapper.js:11 只原样透传 params，校验发生在上游 agent-loop 层。
+ *
+ * 工具层守卫定位 = defense-in-depth + schema 表达力缺口，非「pi 无校验」：
+ *   - action 条件必填（task/slug 仅 action=start 必填）flat JSON Schema 表达不了，
+ *     只能在 startHandler 运行时校验
+ *   - `..` 穿越段拒绝超出 pattern 能力（`^/` 放行 "/a/../b"），穿越语义只能在
+ *     工具层判——与 slug maxLength 双闸同理（schema 强制之上再叠 handler 兜底）
+ *
+ * 规则：
+ *   - 绝对路径（isAbsolute；`~` 缩写不是绝对路径，拒绝并指引展开后重试——
+ *     下游 session-runner 把该值原样拼进 `--skill <path>` / spawn cwd，不展开 `~`）
+ *   - 任意 `..` 路径段拒绝（按 /[\\/] 分段判断而非子串——"a..b" 不是穿越）：
+ *     相对穿越让子进程读到意图外的目录
+ *
+ * 校验失败 immediate throw（与 action 枚举守卫同风格）：pi 只对 execute throw 置
+ * isError:true，错误文案原样进 toolResult。
+ */
+function assertSafeStartPath(value: string, param: "skillPath" | "cwd"): void {
+  if (value.split(/[\\/]/).includes("..")) {
+    throw new Error(
+      `${param} must not contain '..' path segments (got "${value}"). ` +
+      `Pass a normalized absolute path — traversal segments are rejected.`,
+    );
+  }
+  if (!isAbsolute(value)) {
+    throw new Error(
+      `${param} must be an absolute path (got "${value}"). ` +
+      `Expand '~' yourself and pass the full path, e.g. "/Users/me/project".`,
+    );
+  }
+}
+
 /** 从 unknown args 安全提取 model/thinkingLevel override（传给 resolveModel）。
  *  拍平后 args 已是顶层平铺结构（model/thinkingLevel 直接在 args 上）。 */
 function extractModelOverride(args: unknown): { model?: string; thinkingLevel?: string } | undefined {
@@ -238,18 +166,20 @@ action:"list" before action:"start" — a reusable running subagent may exist; c
 - action:"close" — end a running subagent and release its resources. REQUIRED closeParam: { subagentId }. Optional: force (default false; true terminates mid-round immediately). Always close when done.
 - action:"list" — list subagents. Pass listParam: { includeFinished?, limit? } (all optional). Read an item's sessionFile for full detail.
 - action:"cancel" — stop a background subagent (legacy verb; for conversation-mode use close). REQUIRED cancelParam: { subagentId }.
+- action:"fork-from" — recovery for subagents disconnected by a session restart/exit: spawns a NEW subagent inheriting the old one's full history via --fork (source read-only, old record untouched). REQUIRED forkFromParam: { sourceSubagentId }. Optional: prompt (continuation instruction; handover frame injected if omitted). Returns { newSubagentId, sourceSessionFile }. Rejected with guidance: cancelled / worktree-bound / still-running sources.
 
 ## Examples
 
 \`\`\`
 {"action":"start","task":"<your task>","slug":"<kebab-case>"}
-{"action":"start","task":"...","slug":"fix-login","agent":"coder","model":"anthropic/claude-3.5-sonnet","fork":true}
+{"action":"start","task":"...","slug":"fix-login","agent":"/abs/path/coder.md","model":"anthropic/claude-3.5-sonnet","fork":true}
 {"action":"start","task":"review iteratively","slug":"review","conversation":true}
 {"action":"message","messageParam":{"subagentId":"sa-550e8400","text":"now also handle the empty-list case"}}
 {"action":"message","messageParam":{"subagentId":"sa-550e8400","text":"stop, switch direction to X","interrupt":true}}
 {"action":"close","closeParam":{"subagentId":"sa-550e8400"}}
 {"action":"list","listParam":{"includeFinished":false,"limit":20}}
 {"action":"cancel","cancelParam":{"subagentId":"sa-550e8400"}}
+{"action":"fork-from","forkFromParam":{"sourceSubagentId":"sa-550e8400","prompt":"continue from where it stopped; verify tests first"}}
 \`\`\`
 
 ## After launching — do NOT wait
@@ -381,6 +311,10 @@ const executeSubagent: SubagentExecuteCb = async (
   }
   switch (params.action) {
     case "start":
+      // 路径类参数守卫（三通道对称审查 + MF-13）：skillPath/cwd 在进入 handler 前
+      // immediate throw，不产生半启动 record（与 action 枚举守卫同风格）。
+      if (params.skillPath !== undefined) assertSafeStartPath(params.skillPath, "skillPath");
+      if (params.cwd !== undefined) assertSafeStartPath(params.cwd, "cwd");
       // 拍平后直接传顶层 params（StartHandlerInput 是 SubagentExecuteParams 子集，
       // action/listParam/cancelParam 被忽略；task/slug 必填性由 startHandler 校验）。
       return adapter({ action: "start", domain: await startHandler(service, params, signal, _ctx?.model) }, toGuiCtx(_ctx));
@@ -392,6 +326,8 @@ const executeSubagent: SubagentExecuteCb = async (
       return adapter({ action: "message", domain: await messageHandler(service, params.messageParam) }, toGuiCtx(_ctx));
     case "close":
       return adapter({ action: "close", domain: await closeHandler(service, params.closeParam) }, toGuiCtx(_ctx));
+    case "fork-from":
+      return adapter({ action: "fork-from", domain: await forkFromHandler(service, params.forkFromParam) }, toGuiCtx(_ctx));
     default:
       // assertNever：让 exhaustiveness 成为承重约束——新增 action 时 tsc 报错，
       // 而非悄悄落入此分支。

package/src/interface/subagents.ts

@@ -9,9 +9,9 @@
 
 import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 
-import { getSubagentService } from "../execution/subagent-service.ts";
-import type { SubagentService } from "../execution/subagent-service.ts";
-import { displayAgentName } from "../shared/agent-ref.ts";
+import { getSubagentService } from "@zhushanwen/subagent-core/execution/subagent-service.ts";
+import type { SubagentService } from "@zhushanwen/subagent-core/execution/subagent-service.ts";
+import { displayAgentName } from "@zhushanwen/subagent-core/shared/agent-ref.ts";
 import { messageHandler, startHandler } from "./subagent-actions.ts";
 import { parseSubagentRpcCommand } from "./command-actions.ts";
 import type { SubagentRpcAction } from "./command-actions.ts";
@@ -45,7 +45,7 @@ export interface SubagentDirectiveDetails {
  * 定向消息注入正在运行的主 agent LLM turn，违反「不经主 agent LLM 直达 subagent」。
  * 故按调用时刻的权威 streaming 状态（ctx.isIdle()，与 sendCustomMessage 内部
  * isStreaming 判据精确互补，含 agent_end 后 retry/continuation 窗口）分流：
- * - streaming（isMainAgentIdle=false）：传 { deliverAs: "nextTurn" }——消息入
+ * - streaming（isMainAgentIdle=false）：传 { deliverAs: "nextTurn" }——消息入（g4-allow: 交互注入——GUI 定向消息留痕分流，非结果语义通知）
  *   pi 内存 _pendingNextTurnMessages 队列，下个 turn 注入主 agent 上下文；不打断、
  *   不 steer 当前 turn。注意：该队列不落 entry，留痕延迟到下个 turn
  * - 非 streaming（isMainAgentIdle=true）：不传 options——立即 append entry 留痕
@@ -66,7 +66,7 @@ function emitSubagentDirective(
       display: false,
       details,
     },
-    isMainAgentIdle ? undefined : { deliverAs: "nextTurn" },
+    isMainAgentIdle ? undefined : { deliverAs: "nextTurn" }, // g4-allow: 交互注入——/subagents GUI 定向消息留痕，非结果语义（C-ext-19 禁令边界，见 emitSubagentDirective JSDoc）
   );
 }
 

package/src/interface/tool-render.ts

@@ -24,8 +24,8 @@ import type { AgentToolResult, Theme } from "@earendil-works/pi-coding-agent";
 import type {
   ListResponse,
   SubagentToolResult,
-} from "../execution/types.ts";
-import { displayAgentName } from "../shared/agent-ref.ts";
+} from "@zhushanwen/subagent-core/execution/types.ts";
+import { displayAgentName } from "@zhushanwen/subagent-core/shared/agent-ref.ts";
 import {
   extractAgentName,
   firstLine,
@@ -208,6 +208,15 @@ function buildCompactLines(d: SubagentToolResult, theme: ThemeLike): string[] {
       width,
     )];
   }
+  // ── fork-from 分支：接续确认行（[v8.5 B]）──
+  if (d.action === "fork-from" && d.forkFromResponse) {
+    const src = shortSessionLabel(d.forkFromResponse.sourceSessionFile);
+    return [truncLine(
+      `${theme.fg("accent", "⑂")} ${theme.fg("dim", "forked-from ")}${theme.fg("accent", src)}` +
+      ` ${theme.fg("dim", "→ new: ")}${theme.fg("accent", d.subagentId ?? "?")}`,
+      width,
+    )];
+  }
   // ── start 分支：background ──
   if ("bgResponse" in d) {
     return [truncLine(
@@ -234,6 +243,16 @@ function buildExpandedLines(d: SubagentToolResult, theme: ThemeLike): string[] {
       width,
     )];
   }
+  if (d.action === "fork-from" && d.forkFromResponse) {
+    // expanded 与 compact 同形（一次性 block 无细节可展开），另附源文件完整路径行。
+    return [
+      truncLine(
+        `${theme.fg("accent", "⑂")} ${theme.fg("dim", "forked-from ")}${theme.fg("accent", d.forkFromResponse.sourceSessionFile)}` +
+        ` ${theme.fg("dim", "→ new: ")}${theme.fg("accent", d.subagentId ?? "?")}`,
+        width,
+      ),
+    ];
+  }
 
   const lines: string[] = [];
   // bg 占位 expanded 与 compact 同（一次性 block 无细节可展开）
@@ -261,11 +280,24 @@ function isDetailsStructurallyComplete(d: SubagentToolResult): boolean {
       return "listResponse" in d;
     case "cancel":
       return "cancelResponse" in d;
+    case "fork-from":
+      // [v8.5 B] 新 action 直接纳入 guard：缺内层分组才 fallback。
+      // message/close 维持历史现状（不落此 switch 显式分支，走 extractResultError
+      // 回显 content 首行）不变，避免触碰现有渲染回归面——review MF-13 曾引入
+      // message/close 显式分支后回退：无对应渲染分支却判「结构完整」会改走
+      // generic 无响应渲染，属静默行为变更。
+      return "forkFromResponse" in d;
     default:
       return false;
   }
 }
 
+/** fork-from 渲染用的源文件短标签（basename；失败时原样返回——渲染不应抛错）。 */
+function shortSessionLabel(file: string): string {
+  const idx = file.lastIndexOf("/");
+  return idx >= 0 ? file.slice(idx + 1) : file;
+}
+
 /**
  * 从 tool result 的 content 里提取错误文本。
  *

package/src/interface/tool-workflow-script.ts

@@ -30,12 +30,12 @@ import {
   guiResult,
   isGuiCapable,
 } from "@xyz-agent/extension-protocol";
-import type { WorkflowScriptRegistry } from "../orchestration/models/workflow-script-registry.ts";
-import { lintScript } from "../orchestration/script-lint.ts";
-import { deleteWorkflow, saveWorkflow } from "../orchestration/workflow-files.ts";
+import type { WorkflowScriptRegistry } from "@zhushanwen/subagent-core/orchestration/models/workflow-script-registry.ts";
+import { lintScript } from "@zhushanwen/subagent-core/orchestration/script-lint.ts";
+import { deleteWorkflow, saveWorkflow } from "@zhushanwen/subagent-core/orchestration/workflow-files.ts";
 import { toGuiCtx } from "./gui-mappers.ts";
 import { renderTextFallback } from "./views/format.ts";
-import { parseResourceMetaDetailed } from "../shared/meta-parser.ts";
+import { parseResourceMetaDetailed } from "@zhushanwen/subagent-core/shared/meta-parser.ts";
 
 // ── Parameter schema ─────────────────────────────────────────
 

package/src/interface/tool-workflow.ts

@@ -31,12 +31,12 @@ import {
 } from "@xyz-agent/extension-protocol";
 import { type Static, Type } from "typebox";
 
-import { SLUG_MAX_LENGTH } from "../execution/execute-options-mapper.ts";
-import { THINKING_ORDER } from "../execution/model-resolver.ts";
-import type { LauncherDeps } from "../orchestration/launcher.ts";
-import { abortRun, runWorkflow } from "../orchestration/lifecycle.ts";
-import type { RunStore } from "../orchestration/models/ports.ts";
-import type { WorkflowRun } from "../orchestration/models/workflow-run.ts";
+import { SLUG_MAX_LENGTH } from "@zhushanwen/subagent-core/execution/execute-options-mapper.ts";
+import { THINKING_ORDER } from "@zhushanwen/subagent-core/execution/model-resolver.ts";
+import type { LauncherDeps } from "@zhushanwen/subagent-core/orchestration/launcher.ts";
+import { abortRun, runWorkflow } from "@zhushanwen/subagent-core/orchestration/lifecycle.ts";
+import type { RunStore } from "@zhushanwen/subagent-core/orchestration/models/ports.ts";
+import type { WorkflowRun } from "@zhushanwen/subagent-core/orchestration/models/workflow-run.ts";
 import { mapRunIcon, mapRunStatus, toGuiCtx } from "./gui-mappers.ts";
 import {
   acquireReentryGuard,

package/src/interface/views/WorkflowsView.ts

@@ -33,11 +33,11 @@ import {
   countAllToolCalls,
   getAllToolCalls,
   projectLiveProgress,
-} from "../../execution/execution-record.ts";
-import type { ExecutionTraceNode } from "../../orchestration/models/types.ts";
-import type { WorkflowRun } from "../../orchestration/models/workflow-run.ts";
-import { saveWorkflow } from "../../orchestration/workflow-files.ts";
-import { displayAgentName } from "../../shared/agent-ref.ts";
+} from "@zhushanwen/subagent-core/execution/execution-record.ts";
+import type { ExecutionTraceNode } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
+import type { WorkflowRun } from "@zhushanwen/subagent-core/orchestration/models/workflow-run.ts";
+import { saveWorkflow } from "@zhushanwen/subagent-core/orchestration/workflow-files.ts";
+import { displayAgentName } from "@zhushanwen/subagent-core/shared/agent-ref.ts";
 import {
   BOX_BORDER_CHARS,
   BUDGET_TOKENS_DIVISOR,

package/src/interface/views/__tests__/WorkflowsView-signature.test.ts

@@ -13,9 +13,9 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 
 import { computeRenderSignature } from "../WorkflowsView.ts";
-import type { ExecutionRecord } from "../../../execution/types.ts";
-import type { ExecutionTraceNode, WorkerLogEntry } from "../../../orchestration/models/types.ts";
-import type { WorkflowRun } from "../../../orchestration/models/workflow-run.ts";
+import type { ExecutionRecord } from "@zhushanwen/subagent-core/execution/types.ts";
+import type { ExecutionTraceNode, WorkerLogEntry } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
+import type { WorkflowRun } from "@zhushanwen/subagent-core/orchestration/models/workflow-run.ts";
 
 // ── Fixtures（duck typing，对齐 detail-content-session-file.test.ts 先例）──
 

package/src/interface/views/__tests__/detail-content-session-file.test.ts

@@ -9,8 +9,8 @@ import { describe, expect, it } from "vitest";
 
 import { buildDetailContent } from "../detail-content.ts";
 import type { ThemeLike } from "../format.ts";
-import type { ExecutionTraceNode } from "../../../orchestration/models/types.ts";
-import type { WorkflowRun } from "../../../orchestration/models/workflow-run.ts";
+import type { ExecutionTraceNode } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
+import type { WorkflowRun } from "@zhushanwen/subagent-core/orchestration/models/workflow-run.ts";
 
 /** plain theme: fg/bold 直接返回原文，无 ANSI 色码——测试断言纯文本。 */
 const plainTheme: ThemeLike = {

package/src/interface/views/detail-content.ts

@@ -12,10 +12,10 @@
 
 import { Key, matchesKey } from "@earendil-works/pi-tui";
 
-import { getAllToolCalls, projectLiveProgress } from "../../execution/execution-record.ts";
-import type { AgentEventLogEntry } from "../../execution/types.ts";
-import type { ExecutionTraceNode } from "../../orchestration/models/types.ts";
-import type { WorkflowRun } from "../../orchestration/models/workflow-run.ts";
+import { getAllToolCalls, projectLiveProgress } from "@zhushanwen/subagent-core/execution/execution-record.ts";
+import type { AgentEventLogEntry } from "@zhushanwen/subagent-core/execution/types.ts";
+import type { ExecutionTraceNode } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
+import type { WorkflowRun } from "@zhushanwen/subagent-core/orchestration/models/workflow-run.ts";
 import {
   BOX_BORDER_CHARS,
   BUDGET_TOKENS_DIVISOR,

package/src/interface/views/format.ts

@@ -7,10 +7,10 @@
 
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
-import type { AgentEventLogEntry } from "../../execution/types.ts";
-import type { ExecutionTraceNode, ToolCallEntry } from "../../orchestration/models/types.ts";
-import type { DoneReason, RunStatus } from "../../orchestration/models/types.ts";
-import { displayAgentName } from "../../shared/agent-ref.ts";
+import type { AgentEventLogEntry } from "@zhushanwen/subagent-core/execution/types.ts";
+import type { ExecutionTraceNode, ToolCallEntry } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
+import type { DoneReason, RunStatus } from "@zhushanwen/subagent-core/orchestration/models/types.ts";
+import { displayAgentName } from "@zhushanwen/subagent-core/shared/agent-ref.ts";
 
 // ── Constants ─────────────────────────────────────────────────