@zhushanwen/subagent-core 0.2.0 → 0.5.1

package/dist/{types-BxyAidGf.d.cts → types-Dv4QhSJ_.d.cts}

@@ -1,3 +1,69 @@
+import { GuiRenderResult } from '@xyz-agent/extension-protocol';
+
+/**
+ * ModelRegistry 的最小接口（duck-typed，测试可 mock）。
+ * 字段结构与 Pi SDK 的 ctx.modelRegistry 对齐。
+ */
+interface ModelRegistryLike {
+    /** 返回所有已配置鉴权的可用模型。 */
+    getAvailable(): ModelInfo[];
+    /** 按 (provider, modelId) 查找。 */
+    find(provider: string, modelId: string): ModelInfo | undefined;
+    /** 校验模型鉴权是否就绪。 */
+    hasConfiguredAuth(model: unknown): boolean;
+}
+/**
+ * 模型信息（registry 返回元素 / ctx.model 鸭子类型兼容）。
+ * ctx.model（SDK Model<Api>）是此类型的超集，运行时直接当 ModelInfo 用。
+ */
+interface ModelInfo {
+    id: string;
+    name: string;
+    provider: string;
+    reasoning: boolean;
+    thinkingLevelMap?: Record<string, unknown>;
+    contextWindow?: number;
+}
+/** agent .md frontmatter 解析结果。 */
+interface AgentConfig {
+    /** agent 名（文件名 basename）。 */
+    name: string;
+    /** system prompt（markdown 正文）。 */
+    systemPrompt: string;
+    /** tool allowlist（三层过滤之一）。 */
+    tools?: string[];
+    /** 默认模型 override（"provider/modelId"）。agent 作者显式指定。 */
+    model?: string;
+    /** 默认 thinkingLevel override。 */
+    thinkingLevel?: string;
+    /** 默认 background 模式（true 时无显式 wait 走 background）。 */
+    defaultBackground?: boolean;
+    /**
+     * 执行引擎 id（agent .md frontmatter engine 字段，D9 per-agent 主通道）。
+     * 解析期已对注册表校验（未注册 id 在 agent-registry 抛 EngineNotFoundError）；
+     * 执行侧（P4 路由层）按 调用参数 > 本字段 > 全局默认 三层取值。
+     */
+    engine?: string;
+}
+/** 解析结果（model 实例 + 生效的 thinkingLevel）。 */
+interface ResolvedModel {
+    model: ModelInfo;
+    thinkingLevel: string | undefined;
+}
+
+/**
+ * 未显式指定 agent 时的兜底名。
+ *
+ * 必须是真实存在、可被 agentRegistry 发现的 agent（用户 agentDir 内置的通用 agent）。
+ * Service 层（resolveIdentity）与 TUI 层（extractAgentName）共用此常量，保证
+ * 「调用时显示的名」与「实际加载的 agent.md」一致。
+ *
+ * [HISTORICAL] 旧实现两处各硬编码：service 用 "default"（虚构名），format 用
+ * "worker"（真实但不是兜底语义，worker agent 已在 2026-08 agent 重构中删除）。
+ * 导致不传 agent 时，block 标题显示 worker，但实际执行兜底逻辑不一致。统一为
+ * general-purpose 后名实相符。
+ */
+declare const DEFAULT_AGENT_NAME = "general-purpose";
 /**
  * 唯一执行状态。所有路径共用。v4 B-1 两态收敛：旧 idle 折入 running、
  * 旧 cancelled 折入 closed（closedReason='cancelled' 区分）。
@@ -28,6 +94,15 @@ type ExecutionStatus = "running" | "closed";
  *                     不分），message/fork-from 据此给出可行动指引。
  */
 type ClosedReason = 'parent-shutdown' | 'parent-fork' | 'parent-new' | 'user-close' | 'cancelled' | 'gc' | 'disconnected';
+/**
+ * [v8.5 D] 透明重生守卫拒绝专用错误：messageHandler 的 endedMessageGuard 必须原样
+ * 透传本类错误（自带完整行动语言），不得按 A1 分流规则改写——否则 worktree/异进程
+ * 占用文案会被「fork-from 指引」覆盖，误导 agent 走已被判死的通道。
+ */
+declare class ResurrectDeniedError extends Error {
+}
+/** ClosedReason 全枚举值（运行时守卫用——防御性解析外部输入时校验成员资格）。 */
+declare const CLOSED_REASONS: readonly ClosedReason[];
 /**
  * 终态三态对外语义（U3 C-outcome 一等披露）。
  *
@@ -40,6 +115,27 @@ type ClosedReason = 'parent-shutdown' | 'parent-fork' | 'parent-new' | 'user-clo
  * 「父进程关闭时子 agent 未完成即失败」，选定行为而非疏漏，勿当 bug 改回 cancelled。
  */
 type ExecutionOutcome = "completed" | "failed" | "cancelled";
+/**
+ * 对外投影的 outcome 联合：含历史 record（outcome 字段诞生前的存量数据）兼容态。
+ * 投影层（projectOutcome 唯一出口）对无 outcome 字段的 closed record 按
+ * deriveOutcome(closedReason, error) 兜底派生；"closed-legacy" 预留给连派生输入都
+ * 不足以判读的存量形态，消费方必须处理该成员（不得因未知值崩溃）。
+ */
+type ProjectedOutcome = ExecutionOutcome | "closed-legacy";
+/**
+ * 对外四态（设计决策 10 细则 3）：内部 ExecutionStatus（v4 B-1 两态）收敛为 agent
+ * 可理解的状态语义。真实映射只有两条：
+ *   running → active / closed → ended（closed 统一终态，含 cancelled）。
+ * mapExternalState 不消费 ClosedReason——closed 恒映射 ended。
+ *
+ * waiting / error 是历史多态映射（idle→waiting / failed+crashed→error）的遗留声明：
+ * 对外四态联合契约不变，但当前状态机不产生这两个值。
+ *
+ * 原始 ExecutionStatus 进 list item 的 status 字段供调试；state 是对外主字段。
+ * 映射实现见 subagent-actions.ts mapExternalState——未来内部加态必须扩展该处，
+ * 漏加会在 default 分支编译报错，不影响对外契约。
+ */
+type ExternalState = "active" | "waiting" | "ended" | "error";
 /** 执行模式。background = 调用方立即拿 handle 返回，子 agent 在 detached promise 里跑。 */
 type ExecutionMode = "background";
 /**
@@ -101,6 +197,39 @@ interface AgentUsageTotal extends AgentUsage$1 {
     /** 累计成本（USD，来自 SdkEvent.message.usage.cost.total 求和）。无成本数据时为 0。 */
     cost: number;
 }
+/**
+ * eventLog 条目（getEventLog 派生产出的元素）。所有字段 readonly。
+ *
+ * text_output / thinking 类型已移除——它们是 100 字切片的碎片副产物，
+ * 现在完整内容收口在 record.turns[] 里，eventLog 只承载离散语义事件
+ * （tool 调用 / turn 边界 / error）。
+ */
+interface AgentEventLogEntry {
+    readonly type: "tool_start" | "tool_end" | "turn_end" | "error";
+    readonly label: string;
+    /** 事件发生的墙钟时间戳（Date.now()，ms）。由 getEventLog 从 turns[] 派生时记录。 */
+    readonly ts: number;
+    readonly status?: "running" | "done" | "failed";
+}
+/**
+ * [STEP3] displayItem：从 turns[] 派生的展示项（对齐 nicobailon getDisplayItems）。
+ *
+ * 与 eventLog 的区别：eventLog 承载离散语义事件（tool_start/tool_end/turn_end），
+ * displayItem 承载「可渲染单元」（toolCall 含完整 name+args 供 formatToolCall 格式化；
+ * text 含 assistant 正文）。renderResult compact 分支改用 displayItems 后，
+ * 行格式与 nicobailon 完全一致（→ formatToolCall）。
+ */
+interface DisplayItem {
+    readonly type: "toolCall" | "text";
+    /** toolCall：tool 名称（bash/read/edit...）；text：无。 */
+    readonly name?: string;
+    /** toolCall：tool 原始 args（供 formatToolCall 提取路径/命令）；text：无。 */
+    readonly args?: Record<string, unknown>;
+    /** toolCall：执行状态（running 时无✓/✗标记）；text：正文文本。 */
+    readonly status?: "running" | "done" | "failed";
+    /** text：assistant 正文（compact 时取首行/截断）。 */
+    readonly text?: string;
+}
 /** tool 调用结果（tool_execution_end 时累积，含 structured-output 的 details）。 */
 interface ToolCallResult {
     content?: unknown[];
@@ -167,6 +296,12 @@ interface AgentResult$1 {
     durationMs: number;
     success: boolean;
     error?: string;
+    /**
+     * [D5-③] 失败分诊结构化标签（类型 SSOT 在 orchestration/models/types.ts 的
+     * AgentFailureKind——消费语义「unknown=可重试」与其文档同源）。collectResult 对
+     * 最终 error 分类后写入；缺省 = unknown（可重试）。type-only 引用零运行时依赖。
+     */
+    failureKind?: AgentFailureKind;
     sessionId: string;
     toolCalls: ToolCall[];
     usage?: AgentUsageTotal;
@@ -188,6 +323,28 @@ interface WorktreeHandle {
     /** 主仓库根目录（cleanup/scan 需要，不再靠路径反推）。 */
     readonly mainCwd: string;
 }
+/** alive marker：子进程存活标记，用于心跳检测和 crash 推断。 */
+interface AliveMarker {
+    readonly pid: number;
+    readonly id: string;
+    readonly startedAt: number;
+}
+/** git diff patch 结果。 */
+interface PatchResult {
+    readonly patchFile: string;
+    readonly failed: boolean;
+    /** patch 是否实际写入 patchFile。true=diff 非空且写盘成功；false=空 diff 或写失败。
+     *  调用方据此回填 record.patchFile，避免悬空路径（`git apply` 不存在的文件）。 */
+    readonly written: boolean;
+}
+/** fork depth 超限错误。 */
+declare class ForkDepthExceededError extends Error {
+    constructor(message: string);
+}
+/** worktree 有未提交变更错误。 */
+declare class DirtyWorktreeError extends Error {
+    constructor(message: string);
+}
 /**
  * 所有执行路径的唯一状态源。
  *
@@ -354,6 +511,394 @@ interface ExecutionRecord {
     hadWorktree?: boolean;
     controller: AbortController | undefined;
 }
+/**
+ * Tool 返回的 details（内层扁平结构）。
+ * 由 project(record) 唯一产出——sync/bg 两路径字段一致。
+ * 含 mode + sessionFile（供外层 SubagentToolResult 分组 + spinner 判断）。
+ *
+ * 分层（spec FR-3）：此为**内层**，不感知 action/外层分组。
+ * 外层 SubagentToolResult 由 adapter 包裹产出（加 action/subagentId/sessionFile + 分组）。
+ */
+interface SubagentToolDetails {
+    status: ExecutionStatus;
+    /**
+     * 终态三态对外语义（U3 C-outcome，projectOutcome 唯一出口）。running → undefined；
+     * 历史数据无 outcome 字段时兜底派生（见 ProjectedOutcome）。
+     */
+    outcome?: ProjectedOutcome;
+    mode: ExecutionMode;
+    agent: string;
+    model: string;
+    thinkingLevel: string | undefined;
+    /** 短标签（≤35 字符），来自 record.slug。旧 record 反序列化时为空串。 */
+    slug: string;
+    turns: number;
+    totalTokens: number;
+    elapsedSeconds: number;
+    eventLog: AgentEventLogEntry[];
+    /** [STEP3] 从 turns[] 派生的展示项（对齐 nicobailon getDisplayItems）。 */
+    displayItems: DisplayItem[];
+    result?: string;
+    error?: string;
+    /** running 时的当前活动行（tool/thinking/text 优先级）。 */
+    currentActivity?: {
+        type: "tool" | "text" | "thinking";
+        label: string;
+    };
+    /** schema 模式下，structured-output tool 的 result.details（对齐 workflow agent-pool）。 */
+    parsedOutput?: unknown;
+    /** session jsonl 文件名（不含目录）。窗口期内可能 undefined（session 尚未创建成功）。 */
+    sessionFile?: string;
+    /** [MF#3] worktree 模式下子 agent 改动的 patch 文件路径（worktree 外，供调用方应用）。 */
+    patchFile?: string;
+}
+/** Hub.execute 的入参（sync/bg 共用）。mode 由 Hub 内部判定，不暴露给调用方。 */
+interface ExecuteOptions {
+    task: string;
+    /**
+     * 短标签（≤35 字符），简述本次执行用途，展示在 TUI。必填。
+     * workflow 内 agent() 调用时从 AgentCallOpts.description 透传而来。
+     */
+    slug: string;
+    agent?: string;
+    model?: string;
+    thinkingLevel?: string;
+    skillPath?: string;
+    appendSystemPrompt?: string[];
+    schema?: Record<string, unknown>;
+    /** D-A6 bridge: workflow schemaEnv 经 ExecuteOptions 透传到 runSpawn childEnv。 */
+    schemaEnv?: string;
+    /**
+     * Turn 上限 limiter。显式 0/负 = 显式不限：压过 SPAWN_WATCHDOG_ENV 兑底不挂
+     * watchdog（SP-6 参数 > env，U5）；undefined 未传才由 env 兑底。
+     */
+    maxTurns?: number;
+    graceTurns?: number;
+    /** sync 模式来自 Pi tool 框架；background 模式 hub 忽略，自建 controller。 */
+    signal?: AbortSignal;
+    /** 主 agent 当前模型（模型解析第三层兼底）。execute 调用方从 ctx.model 传入。 */
+    ctxModel?: ModelInfo;
+    /** background 完成回调（sync 不调）。 */
+    onComplete?: (record: RecordSnapshot) => void;
+    /** 是否继承父会话上下文（fork 模式，只继承上下文）。 */
+    fork?: boolean;
+    /**
+     * [v8.5 B] fork-from 显式指定继承源 session 文件（非主 session）。
+     * 与 fork:true 的区别：fork:true 用主 session 作 --fork 源；本字段用任意已有
+     * session 文件（断联 subagent 接续场景）作源。优先级高于 fork；传了本字段时
+     * fork 取值不影响 spawn 参数。仅 pi 引擎支持（同 fork）。仅 background tool
+     * 层 fork-from action 使用；workflow / executeAndAwait 不消费。
+     */
+    forkFromSessionFile?: string;
+    /** 文件系统隔离：true=创建新 git worktree，WorktreeHandle=复用外部已创建的；undefined=不隔离（parent cwd）。 */
+    worktree?: boolean | WorktreeHandle;
+    /** 覆盖执行 cwd（默认 mainCwd）。 */
+    cwd?: string;
+    /**
+     * 可持续对话模式（决策 8：独立 chatMode 标志，不扩展 ExecutionMode）。
+     * true = record 标记 chatMode，轮次完成进 idle 态（保留 record + worktree，等待 message 续聊）；
+     * undefined/false = 一次性模式（默认，行为完全不变）。service.execute 透传到 createRecordForMode。
+     */
+    conversation?: boolean;
+    /**
+     * 空闲超时毫秒数（仅 conversation 模式有意义）。覆盖默认 5min idle timeout。
+     * 优先级：参数 > env XYZ_SUBAGENT_IDLE_TIMEOUT_MS > 默认 300000ms。
+     * 显式传 0/负数 = 禁用 idle GC（不挂 timer；旧实现 0 会落成 setTimeout(0) 立即 kill）。
+     */
+    idleTimeoutMs?: number;
+    /**
+     * 实际执行引擎 id（P4 路由留痕）：pi 引擎由 PiEngine.run 在还原 opts 时写入；
+     * 缺省（历史调用方不设）= pi 投影。createRecordForMode 读入 record identity。
+     */
+    engine?: string;
+    /**
+     * 引擎 fallback 留痕（D9①：probe 失败路由回默认引擎时由路由层写入）。
+     * from = 请求引擎 id，reason 恒 'engine_probe_failed'（GUI 警告条数据源）。
+     */
+    engineFallback?: {
+        from: string;
+        reason: string;
+    };
+}
+/**
+ * execute 返回值。
+ *   background: { mode:"background", subagentId, sessionFile, details } —— 立即返回。
+ *            subagentId 供后续 cancel/list 用；sessionFile 窗口期可能 undefined。
+ */
+type ExecutionHandle = {
+    mode: "background";
+    subagentId: string;
+    sessionFile: string | undefined;
+    details: SubagentToolDetails;
+};
+/** list 的 item 结构。 */
+interface SubagentListItem {
+    subagentId: string;
+    agent: string;
+    /** 短标签（≤35 字符），来自 record.slug。旧 record 反序列化时为空串。 */
+    slug: string;
+    /** 对外四态（决策 10 细则 3，主字段）。由 mapExternalState(status) 派生。 */
+    state: ExternalState;
+    /** 原始内部状态（调试用，供 details 展示）。 */
+    status: ExecutionStatus;
+    mode: ExecutionMode;
+    /** 运行秒数（running 态实时计算，终态 endedAt-startedAt）。 */
+    duration: number;
+    model: string;
+    totalTokens: number;
+    /** session jsonl 文件名（窗口期内可能 undefined）。 */
+    sessionFile?: string;
+    /** 直接父 subagent record ID（顶层 record 为 undefined）。[v4 A-6] 从
+     *  record.parentRecordId 派生，配合 A-5 直接父守卫（message/close 仅作用于直接子）。 */
+    parent?: string;
+    /** 可冷路径 resume（running 且无活进程句柄）。[v4 A-6] B-1「可续聊」对外表达，
+     *  agent 据 list 判断哪些 running subagent 实际可续聊（vs 正在忙）。 */
+    resumable?: boolean;
+    /**
+     * 终态三态对外语义（U3 C-outcome 一等披露，projectOutcome 唯一出口）：
+     * completed / failed / cancelled，历史 record 无 outcome 字段时兜底派生，
+     * 不可判读的存量形态为 "closed-legacy"。GUI pane / agent 据此判读成败，
+     * 无需翻 error 字段原文（S5）。
+     */
+    outcome?: ProjectedOutcome;
+}
+/** background 启动的内层响应（挂在 SubagentToolResult.bgResponse）。 */
+interface BgResponse {
+    status: "running";
+    mode: "background";
+    /** 启动提示文案（"detached, will notify on completion"）。 */
+    message: string;
+    /**
+     * 终态三态语义（U3 C-outcome 对外 JSON 契约完备位）。start 时点 record 尚未终态，
+     * 恒 undefined（JSON.stringify 落键省略）；终态成败语义经 list items[].outcome
+     * 披露。旧字段 status/mode/message 原样保留（向后兼容）。
+     */
+    outcome?: ProjectedOutcome;
+    /**
+     * 通知投递契约回显位（U1 预置，U2 通知账本的契约声明）。恒值
+     * "ledger+at-least-once"：主 agent 在当前 run 结束或有限延迟内收到完成通知，
+     * 送达保证为 at-least-once + notifyId 幂等可识别。字段与填充由 U1 负责，
+     * 值语义由 U2（execution/notify-ledger.ts）兑现。
+     */
+    notifyContract: "ledger+at-least-once";
+}
+/** list 的内层响应（挂在 SubagentToolResult.listResponse）。 */
+interface ListResponse {
+    /** items 中 status==="running" 的计数（受 limit 截断如实反映，非全局总数）。 */
+    running: number;
+    items: SubagentListItem[];
+}
+/** cancel 的内层响应（挂在 SubagentToolResult.cancelResponse）。 */
+interface CancelResponse {
+    cancelled: true;
+}
+/**
+ * message 的内层响应（挂在 SubagentToolResult.messageResponse，决策 10 瘦身）。
+ *
+ * [R1 删除记录] 旧 PendingMessage（在途消息缓存条目，消费确认制，设计决策 6 状态×
+ * interrupt 映射）已随 deliverToRunning 一并删除——SP-5 upgrade 后无生产调用方，
+ * 配套三段消费链（push / message_start shift / redeliverPending 补投）全部不可达。
+ * 详见 subagent-service.ts 的删除记录注释。
+ */
+interface MessageResponse {
+    delivered: true;
+}
+/** close 的内层响应（挂在 SubagentToolResult.closeResponse，决策 10 瘦身）。 */
+interface CloseResponse {
+    closed: true;
+}
+/**
+ * Tool 外层出参（renderResult + LLM content JSON 同源）。
+ * adapter 唯一产出：领域对象（bg/list/cancel/message/close 五选一）+ action/subagentId/sessionFile。
+ *
+ *   - background 启动 → bgResponse（subagentId 有值；sessionFile 窗口期可能 undefined）
+ *   - list → listResponse（最外层 subagentId/sessionFile 为 null，sessionFile 在各 item 内）
+ *   - cancel → cancelResponse（subagentId 有值；sessionFile 无意义，可为 null）
+ *   - message → messageResponse（subagentId 有值；sessionFile 无意义，可为 null）
+ *   - close → closeResponse（subagentId 有值；sessionFile 无意义，可为 null）
+ */
+type SubagentToolResult = {
+    action: "start";
+    subagentId: string;
+    sessionFile: string | null;
+    slug: string; /** registry 全等回显（U1）：放行即与 registry 条目全等，"provider/id" 形态。 */
+    model: string;
+    bgResponse: BgResponse;
+    __gui__?: GuiRenderResult;
+} | {
+    action: "list";
+    subagentId: null;
+    sessionFile: null;
+    listResponse: ListResponse;
+    __gui__?: GuiRenderResult;
+} | {
+    action: "cancel";
+    subagentId: string;
+    sessionFile: null;
+    cancelResponse: CancelResponse;
+    __gui__?: GuiRenderResult;
+} | {
+    action: "message";
+    subagentId: string;
+    sessionFile: null;
+    messageResponse: MessageResponse;
+    __gui__?: GuiRenderResult;
+} | {
+    action: "close";
+    subagentId: string;
+    sessionFile: null;
+    closeResponse: CloseResponse;
+    __gui__?: GuiRenderResult;
+} | {
+    action: "fork-from";
+    subagentId: string;
+    sessionFile: string | null;
+    forkFromResponse: ForkFromResponse;
+    __gui__?: GuiRenderResult;
+};
+/** fork-from 的内层响应：新 subagent id + 作为继承源的旧记录 session 文件。
+ *  [v8.5 B] 断联恢复通道——新 subagent 以 --fork 方式继承旧会话历史，源文件只读
+ *  不续写（pi fork 建 branched session，copy-on-write）。 */
+interface ForkFromResponse {
+    /** 新 subagent record id（接续对话用 action:'message'）。 */
+    newSubagentId: string;
+    /** 作为继承源的旧 subagent session jsonl 绝对路径。 */
+    sourceSessionFile: string;
+}
+/** /subagents list 左列展示单元。来自内存(running) 或 session.jsonl 重建(终态)。 */
+interface SubagentRecord {
+    id: string;
+    agent: string;
+    /** 任务提示词（详情面板置顶展示）。磁盘/内存源均有。 */
+    task: string;
+    /** 短标签（≤35 字符）。磁盘重建源旧文件可能缺失→兜底空串。 */
+    slug: string;
+    status: ExecutionStatus;
+    /** L2 关闭原因子枚举（仅 status="closed" 时有意义）。SP-1 新增。 */
+    closedReason?: ClosedReason;
+    /** 终态三态对外语义（U3 C-outcome）。磁盘重建源一等直读；无字段的存量兜底走 projectOutcome。 */
+    outcome?: ExecutionOutcome;
+    mode: ExecutionMode;
+    startedAt: number;
+    /** 根 Pi session ID（session 隔离过滤用）。递归链上所有层 record 同值。 */
+    rootSessionId: string | undefined;
+    /** 直接父 subagent record ID（层级树构建用）。顶层 record 为 undefined。 */
+    parentRecordId: string | undefined;
+    /** subagent 递归深度。顶层 =0，每层嵌套 +1。 */
+    depth: number;
+    endedAt: number | undefined;
+    turns: number;
+    totalTokens: number;
+    model: string;
+    thinkingLevel: string | undefined;
+    eventLog: AgentEventLogEntry[];
+    /** [STEP3] 从 turns[] 派生的展示项（对齐 nicobailon getDisplayItems）。 */
+    displayItems: DisplayItem[];
+    /** running 时的当前活动行（仅内存源；磁盘重建无此数据）。streaming 可观测性用。 */
+    currentActivity?: {
+        type: "tool" | "text" | "thinking";
+        label: string;
+    };
+    result?: string;
+    error?: string;
+    sessionFile?: string;
+    /** [MF#3] worktree 模式下子 agent 改动的 patch 文件路径（worktree 外，供调用方应用）。 */
+    patchFile?: string;
+    /**
+     * [review round2] 创建时启用 worktree 隔离（磁盘重建源从 session entry 恢复；内存源由
+     * recordToSubagent 从 worktreeHandle 投影）。getRecordForAction 跨重启重建时据此拒绝续聊。
+     */
+    worktree?: boolean;
+    /**
+     * 对话轮次计数（仅 chatMode idle record 有意义）。round 仅在内存维护（doFinalizeRoundToIdle
+     * 递增），跨重启不恢复（round 无磁盘持久化）；非对话模式 / 非 idle record 为 undefined。内存源由 recordToSubagent 从
+     * ExecutionRecord.round 投影。
+     */
+    round?: number;
+    /**
+     * 对话模式标志（与 ExecutionRecord.chatMode 同义；投影给 GUI 侧 streaming/waiting/done
+     * 细分判据——one-shot 轮终（chatMode 非 true + result 有值）显示完成态，chat 轮终显示
+     * 等续聊。内存源由 recordToSubagent 投影，磁盘源经 subagent-record entry 重建）。
+     */
+    chatMode?: boolean;
+    /**
+     * 执行态信号（与 ExecutionRecord.resumable 同义）：true = 无活进程驱动的 running
+     * （轮终 idle / 重建孤儿兜底），GUI 侧据此排除「真在跑」判定。
+     */
+    resumable?: boolean;
+    /** 外部 Pi 实例（进程隔离模式下由外部启动的子进程）。 */
+    externalInstance?: AliveMarker;
+    /** fork 模式下的 worktree handle。 */
+    worktreeHandle?: WorktreeHandle;
+    /**
+     * 实际执行引擎 id（P4 路由留痕）。缺省 = pi 投影（存量 record 零迁移）；
+     * GUI 警告条/引擎标记的数据源之一。
+     */
+    engine?: string;
+    /** 引擎 fallback 留痕（D9①：probe 失败路由回默认引擎）。GUI 警告条数据源。 */
+    engineFallback?: {
+        from: string;
+        reason: string;
+    };
+    /**
+     * 引擎自描述定位符（U1：EngineHandleData 的持久化消费面子集，引擎无关——
+     * sessionRef 整体透传不枚举内部键）。read 降级链①②级的数据源（runtime
+     * subagent-engine-history）；缺省 = pi（走 JSONL 直读链）。
+     */
+    engineHandle?: {
+        sessionRef: Record<string, string>;
+        journalPath?: string;
+        poolKey: string;
+    };
+}
+/**
+ * 全局配置（~/.pi/agent/subagents/config.json）。
+ *
+ * 模型解析已退化为「主 agent model 优先，仅 override 时查 registry」——
+ * 不再有 category/fallback/yolo 字段。config.json 只保留 maxConcurrent
+ * （pool 大小）。旧 config.json 中的 categories/fallback 等字段读取时忽略。
+ */
+interface SubagentsGlobalConfig {
+    version: number;
+    maxConcurrent: number;
+    /**
+     * 全局默认执行引擎（D9 三层优先级的最底层：调用参数 > agent frontmatter > 本值）。
+     * 缺省 'pi'（P4 路由层 DEFAULT_ENGINE_ID）。加载期只做类型校验，注册表校验归路由层。
+     */
+    defaultEngine?: string;
+    /** 引擎路由策略（D9①）：strict=true 时一切 probe 失败直接报错（不 fallback）。 */
+    engineRouting?: {
+        strict: boolean;
+    };
+}
+/**
+ * Record 的只读视图。store.snapshot() 返回。
+ * TUI 拿到此类型，保证不会回写 Core 状态。
+ *
+ * 不含 eventLog——snapshot 的消费点（cancel 判 mode/status、hasRunning 判 mode、
+ * toNotifyRecord 取 result/error）均不读 eventLog。需要 eventLog 的场景用 project()
+ * 投影的 SubagentToolDetails。需要完整内容用 record.turns[]（Core 内部）。
+ */
+interface RecordSnapshot {
+    readonly id: string;
+    readonly agent: string;
+    readonly model: string;
+    readonly thinkingLevel: string | undefined;
+    readonly mode: ExecutionMode;
+    readonly task: string;
+    /** 短标签（≤35 字符）。来自 record.slug。 */
+    readonly slug: string;
+    readonly status: ExecutionStatus;
+    /** 对话模式标志（与 ExecutionRecord.chatMode 同源）。cancel 别名判定用。 */
+    readonly chatMode?: boolean;
+    readonly turns: number;
+    readonly totalTokens: number;
+    readonly startedAt: number;
+    readonly endedAt: number | undefined;
+    readonly result: string | undefined;
+    readonly error: string | undefined;
+    readonly sessionFile: string | undefined;
+}
 
 /**
  * Workflow Extension — Engine 共享类型
@@ -381,7 +926,36 @@ type RunStatus = "running" | "done";
 /** 终态原因。done 时必有（WorkflowRun 不变式）。 */
 type DoneReason = "completed" | "failed" | "aborted" | "budget_limited" | "time_limited" | "invalid_args";
 /**
- * 单次 agent 调用的输入选项。
+ * slug 最大长度（D6 合流迁入本文件，原权威定义在已删除的 execution/execute-options-mapper.ts）。
+ * 历史值 20 偏紧——描述性 slug 如 "audit-structured-output"（23）/ "fix-subagent-wf-tools"（21）
+ * 会撞上限，放宽到 35 兼顾「短到能塞进 TUI 标题行」与「容纳合理描述性 kebab-case 名」。
+ * 放本文件的原因：约束对象是 AgentCallOpts.description（slug 的源字段，见下方 slug 派生说明），
+ * 与字段同文件；worker-message-pump（live record slug 截断）与壳侧 tool schema maxLength 共享引用。
+ */
+declare const SLUG_MAX_LENGTH = 35;
+/**
+ * 单次 agent 调用的任务声明（D6 任务形状合流后的单一形状）。
+ *
+ * [D6 合流裁决] 本类型 = 原 AgentCallOpts（workflow 调用方声明，18 字段）与原
+ * AgentTaskSpec（engine 中立任务声明，已删除）的合流形态，从模型脚本 agent() API
+ * 到 EnginePort.run 直达 pi 边界一次映射——SAR 链路上的 ExecuteOptions/AgentTaskSpec
+ * 中间态消除（设计 docs/design/subagent-dual-track-convergence.md §3.3 D6 / 终态四）。
+ *
+ * 终态命名按变化轴裁定为 AgentCallOpts，理由：
+ *   - 字段演进的首要驱动轴是「调用方要表达的任务语义」（agent() API 是唯一生产写入方，
+ *     合流字段中 prompt/description/skill/skillPath/schemaEnv/thinkingLevel 等多数派
+ *     已是调用方命名）；
+ *   - 原 AgentTaskSpec 的中立重命名层（task/slug/effort/persona）与调用方命名是
+ *     形式同构、语义同构的假差异（prompt≡task、slug=description 截断、effort≡thinkingLevel、
+ *     persona≡skillPath+appendSystemPrompt 平铺），按「消假差异」原则并入调用方命名；
+ *   - 持久化兼容反向锁定 prompt 形态：jsonl run 快照的 AgentCall.opts 与 worker 消息
+ *     opts 均以 prompt 字段落盘，改名会破坏旧快照重水合。
+ *
+ * 引擎中立字段的并入方式（可选字段，原 AgentTaskSpec 独有字段去向）：
+ *   - graceTurns / conversation / idleTimeoutMs / denyTools / permissionMode：可选并入；
+ *   - persona.agentRef：裁撤（无生产写入方、无消费者——pi 走 agent 字段解析身份）；
+ *   - requires：裁撤（P4 形状预留、无生产写入方；且并入需 import EngineCapabilities
+ *     形成 orchestration↔engine 类型环）。将来能力依赖声明下钻时在本形状上加回。
  *
  * D-12 仅重组执行编排，AgentCallOpts 形状保持兼容。
  */
@@ -417,14 +991,20 @@ interface AgentCallOpts {
     */
     timeoutMs?: number;
     /**
-    * Turn 上限（turn limiter 用）。
-    *
-    * [预算语义对齐] 未传或 <=0 = 不限 turn；此时也不按 turns 估算 spawn watchdog——
-    * 仅当 env XYZ_SUBAGENT_SPAWN_WATCHDOG_MS 设置时才按绝对时限挂 watchdog（见
-    * session-runner.resolveSpawnWatchdogMs）。mapToExecuteOptions 原样透传到
-    * ExecuteOptions.maxTurns → 引擎 task-spec → runSpawn。
-    */
+     * Turn 上限（turn limiter 用）。
+     *
+     * [预算语义对齐] 未传或 <=0 = 不限 turn；此时也不按 turns 估算 spawn watchdog——
+     * 仅当 env XYZ_SUBAGENT_SPAWN_WATCHDOG_MS 设置时才按绝对时限挂 watchdog（见
+     * session-runner.resolveSpawnWatchdogMs）。pi 边界直出为 ExecuteOptions.maxTurns
+     * → runSpawn（D6 合流后无中间映射层）。
+     */
     maxTurns?: number;
+    /**
+     * Turn limiter 的宽限轮数（原 AgentTaskSpec.graceTurns 并入）：超 maxTurns 后
+     * 允许继续的轮数（等待在途工具收尾）。pi 引擎消费；workflow agent() 无写入方，
+     * chat 域（ExecuteOptions.graceTurns 同名透传）经 host-task-spec 填充。
+     */
+    graceTurns?: number;
     /**
     * Skill name to load (e.g. "code-review"). Resolved to SKILL.md path
     * and injected via --skill flag in the subprocess.
@@ -445,18 +1025,18 @@ interface AgentCallOpts {
     */
     agent?: string;
     /**
-    * System prompt injection CONTENT (not file paths).
-    * Set by agent-opts-resolver: schema structured-output instruction string.
-    * Agent systemPrompt is NOT included here (handled by resolveIdentity/agentConfig).
-    * mapToExecuteOptions passes this through to ExecuteOptions.appendSystemPrompt
-    * (same name/semantics, transparent passthrough).
-    */
+     * System prompt injection CONTENT (not file paths).
+     * Set by agent-opts-resolver: schema structured-output instruction string.
+     * Agent systemPrompt is NOT included here (handled by resolveIdentity/agentConfig).
+     * pi 边界直出为 ExecuteOptions.appendSystemPrompt（同名同义透传，D6 合流后无中间映射层）。
+     */
     appendSystemPrompt?: string[];
     /**
-    * Schema JSON for PI_WORKFLOW_SCHEMA env var.
-    * Set by agent-opts-resolver when opts.schema is present; passed as env var
-    * to activate the structured-output tool + hook.
-    */
+     * Schema JSON for PI_WORKFLOW_SCHEMA env var.
+     * Set by agent-opts-resolver when opts.schema is present (值 = stringifySchemaCached
+     * compact，与 schema 派生等值); passed as env var to activate the structured-output
+     * tool + hook. pi 边界直出时 schema 派生优先、本字段兜底（解耦形态通道，生产不可达）。
+     */
     schemaEnv?: string;
     /**
     * Per-call 工作目录（ADR-029 决策 1）。传给 child_process.spawn 的 cwd option。
@@ -475,11 +1055,36 @@ interface AgentCallOpts {
      * agent() → execute-agent-call → SAR 路由层。
      */
     engine?: string;
-    /** Filesystem isolation: when true, creates a new git worktree for the agent. Independent of fork. */
-    worktree?: boolean;
+    /** Filesystem isolation: when true, creates a new git worktree for the agent. Independent of fork.
+     * [D6 合流] 类型扩展为 boolean | WorktreeHandle（原 AgentTaskSpec.worktree 的超集）——
+     * WorktreeHandle 形态仅在 chat 域（复用外部已创建的 worktree）出现，workflow agent()
+     * 恒传 boolean。 */
+    worktree?: boolean | WorktreeHandle;
     /** When true, agent() resolves {value, sessionFile, worktreePath, error} instead of a bare value.
-     * Worker-layer flag only — not forwarded to ExecuteOptions (mapToExecuteOptions drops it). */
+     * Worker-layer flag only — not consumed by any engine (dropped at the pi boundary). */
     returnMeta?: boolean;
+    /**
+     * 可持续对话模式（原 AgentTaskSpec.conversation 并入）：true = record 标记 chatMode，
+     * 轮次完成进 idle 态等待 message 续聊。chat 域（ExecuteOptions.conversation 同名）经
+     * host-task-spec 填充；workflow agent() 无写入方。
+     */
+    conversation?: boolean;
+    /**
+     * 空闲超时毫秒数（原 AgentTaskSpec.idleTimeoutMs 并入，仅 conversation 模式有意义）。
+     * 优先级：参数 > env XYZ_SUBAGENT_IDLE_TIMEOUT_MS > 默认 300000ms；显式 0/负 = 禁用
+     * idle GC。chat 域经 host-task-spec 填充。
+     */
+    idleTimeoutMs?: number;
+    /**
+     * 工具 denylist（原 AgentTaskSpec.denyTools 并入，中立新增面）：各引擎做语法映射
+     * （zcode buildZcodeArgv 消费；pi 链路暂无对应面）。无 workflow 写入方，预留形状。
+     */
+    denyTools?: string[];
+    /**
+     * 中立权限模式（原 AgentTaskSpec.permissionMode 并入，预留形状）：映射按各引擎
+     * capabilities.permissionMode。无生产写入方/消费者。
+     */
+    permissionMode?: string;
 }
 /**
  * 单次 agent 调用的资源用量（FR-7 跨 turn 累积）。
@@ -502,6 +1107,23 @@ interface ToolCallEntry {
     /** Args preview string. */
     input: string;
 }
+/**
+ * 失败分诊结构化标签（D5-③，r1 MF4 钉正语义）。
+ *
+ * - stale_context：pi session context 被 compact/cancel/替换——重试无意义（同 call
+ *   再次失败），不重试。
+ * - schema_deterministic：确定性 schema 失败（SO tool 从未调用 / gate 终止 /
+ *   不可满足 schema）——同 schema 重试必同结果，不重试。
+ * - unknown：其余一切失败（瞬态 provider 错误、spawn 失败等）——**默认可重试**。
+ *
+ * **语义守恒（最高优先约束）**：unknown（含字段缺省）= 可重试——保持收敛前的
+ * 默认重试语义；仅 stale_context 与 schema_deterministic 两态维持不重试特判。
+ * 词表归属（产出侧单点识别）：stale_context / schema_deterministic 的识别词表
+ * （stale 词表与确定性 schema 失败标记前缀）保留在产出侧
+ * execution/engine/engines/pi/output-collector.ts 包内——词表漂移的失效模式是
+ * failureKind=unknown → 保守重试（安全默认），不再是静默漏诊。
+ */
+type AgentFailureKind = "stale_context" | "schema_deterministic" | "unknown";
 /**
  * 单次 agent 调用的结果（统一形态）。
  *
@@ -512,6 +1134,16 @@ interface AgentResult {
     /** Raw text output from the agent. */
     content: string;
     /**
+    * [D5-③] 失败分诊结构化标签（AgentFailureKind）。产出侧唯一识别点 =
+    * execution/engine/engines/pi/output-collector.ts（collectResult 对最终 error
+    * 分类后写入，经 agent-result-mapper / AgentOutcome 透传到本形态）；消费侧
+    * execute-agent-call 读本字段分诊，不再扫 error 文案子串。
+    *
+    * 仅在 error !== undefined 时有意义（成功时缺省）；缺省视为 unknown = 可重试
+    * （语义守恒，见 AgentFailureKind）。
+    */
+    failureKind?: AgentFailureKind;
+    /**
     * Parsed structured output.
     * Present when `schema` was provided and the output was valid JSON.
     * Source: tool_execution_end.result.details（validated data object）。
@@ -606,95 +1238,6 @@ interface WorkerLogEntry {
     message: string;
 }
 
-/** 人设（persona）注入规格：原 skillPath + appendSystemPrompt 收拢进一个语义单元（D2）。 */
-interface PersonaSpec {
-    /**
-     * agent 名/路径。与 AgentTaskSpec.agent 的分工：agent 是 resolveIdentity 的身份解析
-     * 键（模型/系统提示等身份语义）；agentRef 是 persona 注入通道的定位符——引擎按
-     * capabilities.personaInjection 决定注入通道（file/flag/prompt）时用它定位人设。
-     * pi 引擎不消费此字段（身份解析走 spec.agent），留给 flag/file 通道的引擎。
-     */
-    agentRef?: string;
-    /**
-     * 原 ExecuteOptions.skillPath。公共 persona 路由三策略（file/flag/prompt）的分流
-     * 载体（D4）——超长 prompt 时优先 file/flag 通道分流的落点。
-     */
-    skillPath?: string;
-    /** 追加系统提示内容数组（原样透传；schema 仿真段由公共降级层拼装后放入，P2）。 */
-    appendSystemPrompt?: string[];
-}
-/**
- * 引擎无关的 agent 任务声明（= ExecuteOptions 泛化，字段逐条锚定设计 §3.3.5）。
- *
- * 与 ExecuteOptions 的差异（泛化点）：
- *   - thinkingLevel（pi 7 档枚举语义）→ effort?: string，各引擎自行映射或忽略；
- *   - skillPath + appendSystemPrompt → persona（PersonaSpec）；
- *   - conversation/idleTimeoutMs 保留原名透传——属 interact 交互控制面的 task 标志（D1），
- *     不是 pi 专有语义的泄漏，而是「任务声明里声明交互模式」的中立表达；
- *   - 删字段去向：signal/ctxModel/onComplete 是运行期句柄，移入 RunContext（port.ts）；
- *     schemaEnv 内化到 PiEngine（从 task.schema 派生，见 engines/pi/task-spec-mapper.ts）。
- *
- * 新增（为后续 wave 预留形状，P1 无生产写入方）：
- *   - denyTools：中立工具 denylist（附录 A 该行的载体）；
- *   - permissionMode：中立权限模式（映射按 capabilities.permissionMode）。
- */
-interface AgentTaskSpec {
-    /** 原样（ExecuteOptions.task）。 */
-    task: string;
-    /** 原样（ExecuteOptions.slug，≤35 字符）。 */
-    slug: string;
-    /** 原样（ExecuteOptions.agent，resolveIdentity 的 agent ref）。 */
-    agent?: string;
-    /** 原样（ExecuteOptions.model；在引擎 provider 体系内解释，D9②）。 */
-    model?: string;
-    /**
-     * 泛化：原 ExecuteOptions.thinkingLevel。引擎无关的推理投入档位字符串——
-     * pi 引擎把它原值映射回 thinkingLevel 7 档；其他引擎自行映射（CC 5 档）或忽略
-     * （kimi ❌）。不定义联合枚举：档位集合是引擎私有语义，中立层只透传字符串。
-     */
-    effort?: string;
-    /** 泛化：原 skillPath + appendSystemPrompt 收拢（D2）。 */
-    persona?: PersonaSpec;
-    /**
-     * 原样（ExecuteOptions.schema）。native/emulated 分流依据（D4 硬边界）：pi 的
-     * PI_WORKFLOW_SCHEMA env 注入链路按 native 直传，公共仿真层只服务 emulated 引擎。
-     */
-    schema?: Record<string, unknown>;
-    /**
-     * 原样（ExecuteOptions.maxTurns）。pi 引擎专属（turn limiter + spawn watchdog
-     * 估算依赖 pi 的 turn_end 事件流）；其他引擎 prepare 期显式拒绝（U4，同 fork 模式）。
-     * 显式 0 压过 SPAWN_WATCHDOG_ENV 兑底（SP-6 参数 > env，U5）；undefined 未传才由
-     * env 兑底。
-     */
-    maxTurns?: number;
-    /** 原样（ExecuteOptions.graceTurns）。 */
-    graceTurns?: number;
-    /** 原样（ExecuteOptions.fork）。pi 专属；其他引擎 prepare 期按 capabilities 拒绝。 */
-    fork?: boolean;
-    /**
-     * 原样（ExecuteOptions.worktree）。公共层职责（worktree-manager），非引擎职责——
-     * 引擎只把它当 spawn cwd 的来源之一。
-     */
-    worktree?: boolean | WorktreeHandle;
-    /** 原样（ExecuteOptions.cwd）。 */
-    cwd?: string;
-    /** 原样（ExecuteOptions.conversation，interact 控制面的 task 标志，D1）。 */
-    conversation?: boolean;
-    /** 原样（ExecuteOptions.idleTimeoutMs，同上）。 */
-    idleTimeoutMs?: number;
-    /** 新增：中立工具 denylist。各引擎做语法映射（附录 A「工具 denylist」行的载体）。 */
-    denyTools?: string[];
-    /** 新增：中立权限模式。映射按 capabilities.permissionMode（kimi fixed auto = ignored）。 */
-    permissionMode?: string;
-    /**
-     * [P4 形状预留，D9① 守卫 b 的独立载体] 任务对引擎能力的显式依赖声明。
-     * 首期无生产写入方：守卫 b 与守卫 a 合流（显式 engine 即能力依赖声明）——调用方
-     * 按引擎 id 表达依赖。下钻时机（AgentTaskSpec 泛化成熟后）：调用方改按能力表达
-     * （如 requires: { sandbox: 'native' }），路由层将本字段与各引擎 capabilities()
-     * 对照，无引擎满足时报 engine_capability_unsupported（调用前拒绝，D11 处置三级）。
-     */
-    requires?: Partial<EngineCapabilities>;
-}
 /**
  * 一次引擎执行的终态。锚定 orchestration/models/types.ts 的 AgentResult（workflow
  * 引擎消费的那份——content/parsedOutput/usage/error）并追加引擎层字段；见文件头消歧说明。
@@ -702,6 +1245,13 @@ interface AgentTaskSpec {
 interface AgentOutcome {
     /** 原样（AgentResult.content）。 */
     content: string;
+    /**
+     * 原样（AgentResult.failureKind，D5-③ 失败分诊结构化标签）。产出侧唯一识别点 =
+     * engines/pi/output-collector（collectResult 分类写入）；缺省 = unknown = 可重试
+     * （消费侧 executeAgentCall 只读字段分诊，不扫 error 文案）。非 pi 引擎不产出，
+     * 恒缺省（unknown 语义）。
+     */
+    failureKind?: AgentFailureKind;
     /**
      * 原样（AgentResult.parsedOutput）。native 引擎直传 / 仿真层 ajv 产出（D4 硬分流：
      * native 路径公共层不做二次校验、不改写其结果）。
@@ -826,6 +1376,15 @@ interface EngineCapabilities {
     interrupt: "native" | "kill-only";
     /** kimi headless 固定 auto = ignored；GUI 据此隐藏/提示。 */
     permissionMode: "native" | "fixed" | "ignored";
+    /**
+     * [D3-④ r3 裁定] maxTurns 轮数上限的执行能力位（pi = true：turn limiter + spawn
+     * watchdog 估算兑现；zcode = false：无 turn_end 语义，静默丢弃会造成「传了上限却
+     * 失控」假象）。调用前预检（common/capability-gate）按本位拦「声明不支持的能力」
+     * ——pi 不拦 maxTurns（已支持能力，由 turn-limiter 执行）、zcode 同步拒绝。
+     * 现状 11 个能力位无可承载 maxTurns 的语义位（fork 拦截可借 session 分叉通道族判，
+     * maxTurns 无可借位），故扩位而非保留引擎内硬编码 shape 检查。
+     */
+    maxTurns: boolean;
 }
 /** 引擎探针报告（probe() 返回）。探针在引擎 factory 初始化与版本变化检测时触发（P4 接线）。 */
 interface ProbeReport {
@@ -848,9 +1407,16 @@ interface ProbeReport {
  * interact 的 action（D1 交互控制面）。pi 首期原生实现（现有 chatMode 行为直通）；
  * 声明 conversation unsupported 的引擎调用前拒绝（engine_capability_unsupported）。
  */
-type InteractAction = {
+type InteractAction = 
+/**
+ * interrupt：true = steer（抢占）/ false|缺省 = followUp（排队）——pi streamingBehavior
+ * 语义的中立承载（D1 §3.3.5「后续 wave 如需抢占语义再扩展 InteractAction」的兑现，
+ * chat 域投递经 engine.interact 接通时落地；不支持抢占的引擎忽略）。
+ */
+{
     kind: "message";
     payload: string;
+    interrupt?: boolean;
 } | {
     kind: "close";
     payload?: {
@@ -872,4 +1438,4 @@ type InteractResult = {
     message: string;
 };
 
-export type { AgentTaskSpec as A, DoneReason as D, EngineCapabilities as E, InteractAction as I, ProbeReport as P, RunStatus as R, SessionView as S, TracePatch as T, WorkerLogEntry as W, AgentEvent as a, EngineHandle as b, AgentOutcome as c, InteractResult as d, AgentUsage as e, AgentCallOpts as f, AgentResult as g, ExecutionTraceNode as h, EngineHandleData as i, PersonaSpec as j, ReplayedTurn as k };
+export { type SubagentToolResult as $, type AgentCallOpts as A, type DisplayItem as B, type ClosedReason as C, type DoneReason as D, type EngineCapabilities as E, type CancelResponse as F, type CloseResponse as G, type ForkFromResponse as H, type InteractAction as I, type MessageResponse as J, type BgResponse as K, type ListResponse as L, type ModelInfo as M, type ExternalState as N, type SubagentListItem as O, type ProbeReport as P, CLOSED_REASONS as Q, type RecordSnapshot as R, type SessionView as S, type ToolCall as T, DEFAULT_AGENT_NAME as U, DirtyWorktreeError as V, type WorktreeHandle as W, ForkDepthExceededError as X, type ReplayedTurn as Y, ResurrectDeniedError as Z, SLUG_MAX_LENGTH as _, type AgentEvent as a, type ToolCallEntry as a0, type EngineHandleData as b, type EngineHandle as c, type AgentOutcome as d, type InteractResult as e, type ExecutionRecord as f, type SubagentRecord as g, type ExecuteOptions as h, type AgentResult as i, type AgentConfig as j, type ResolvedModel as k, type AgentResult$1 as l, type ExecutionOutcome as m, type AgentEventLogEntry as n, type ExecutionStatus as o, type ProjectedOutcome as p, type SubagentsGlobalConfig as q, type ModelRegistryLike as r, type ExecutionHandle as s, type ExecutionMode as t, type PatchResult as u, type AgentUsage as v, type ExecutionTraceNode as w, type TracePatch as x, type RunStatus as y, type WorkerLogEntry as z };