@ai-agent-forge/plugin-subagent-delegate 0.86.7 → 0.87.0

package/dist/delegate.js

@@ -67,34 +67,9 @@ export const capabilityManifest = {
 };
 // 通信面的宿主接线 `SubagentCommunicationWiringV1`（含信箱消息形状）是 plugin-sdk
 // 公共契约（D-075 S4 第三批迁入 SDK），本包经上方 import 消费并在 index 再导出。
-const COMMUNICATION_FLAG_KEYS = ["resume", "escalate", "sibling"];
-/**
- * 配置通道解析（`api.config.communication`）：缺省对象 = 全关；字段只接受 `true` 或省略，
- * 未知键与错误类型装载期 fail fast，不让"配置了但没生效"的假象存在。
- */
-function readCommunicationConfig(raw) {
-    if (raw === undefined)
-        return {};
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-        throw new Error("subagent-delegate config communication must be an object");
-    }
-    const record = raw;
-    const known = COMMUNICATION_FLAG_KEYS;
-    const unknown = Object.keys(record).filter((key) => !known.includes(key));
-    if (unknown.length > 0) {
-        throw new Error(`subagent-delegate config communication has unknown key(s): ${unknown.join(", ")}`);
-    }
-    const config = {};
-    for (const key of COMMUNICATION_FLAG_KEYS) {
-        const value = record[key];
-        if (value === undefined)
-            continue;
-        if (value !== true)
-            throw new Error(`subagent-delegate config communication.${key} must be true or omitted`);
-        config[key] = true;
-    }
-    return config;
-}
+// 通信面配置键已移除（D-060 裁决 15，2026-10-03）：resume/escalate/sibling 曾是
+// 出厂默认全开的显式开关（裁决 13/14 翻转后仅剩"显式 false 关闭"形态），随开关
+// 形态一并退役——功能基本面只有"有"与"没有"，配置键出现即装载期失败。
 /** 把宿主/调度器/信箱的结构化错误映射为工具面的同码委托错误（保留原始 message）。 */
 function mapCommunicationError(error) {
     if (error instanceof SubagentMailboxErrorV1) {
@@ -513,6 +488,11 @@ const RESULT_READ_DEFAULT_MESSAGES = 20;
 const RESULT_READ_MAX_MESSAGES = 50;
 /** `subagent_result` 的有界等待上限（后台结算收割），默认 0 = 只查一次。 */
 const RESULT_READ_MAX_WAIT_MS = 120_000;
+/**
+ * 每任务随结算投影/信封返回的兄弟流量摘录条数（D-060 裁决 14 父可见性）：有界——
+ * 这是审计摘录不是消息回灌，全量以信箱审计日志为准。
+ */
+const SIBLING_TRAFFIC_EXCERPTS = 8;
 /** UTF-8 字节数（回读信封如实报告体积）。 */
 function utf8ByteLength(text) {
     return Buffer.byteLength(text, "utf8");
@@ -668,14 +648,16 @@ export function createCapability(api, options) {
     const agents = api.agents;
     if (!session)
         throw new Error("subagent-delegate requires the session capability");
-    // 通信面配置在装载期 fail fast（两个上下文都读同一份 agent-dir 配置文件）。
-    const communication = readCommunicationConfig(api.config.communication);
+    // 通信面配置键已移除（D-060 裁决 15）：出现即装载期失败，不留"配置了但没生效"的假象。
+    if (api.config.communication !== undefined) {
+        throw new Error("subagent-delegate config communication was removed (D-060 ruling 15): communication tools register unconditionally; remove the key");
+    }
     const wiring = options?.communicationWiring;
-    // 子侧通信面（子→父 / 子↔子）：只要宿主接线了 post 通道且配置开启就注册——
+    // 子侧通信面（子→父 / 子↔子）：只要宿主接线了 post 通道就注册——
     // 叶子会话（无 agents）只拿这一面；获准自建会话（D-060 S5，agents 在场）两面都要：
     // 它既能向下委派（parent face），也仍能向自己的父上抛/收兄弟消息（child face）。
     const childTools = [];
-    if (wiring?.postEscalate !== undefined && communication.escalate === true) {
+    if (wiring?.postEscalate !== undefined) {
         childTools.push(api.registerTool({
             name: "subagent_escalate",
             label: "Escalate to parent",
@@ -703,12 +685,14 @@ export function createCapability(api, options) {
             },
         }));
     }
-    if (wiring?.sendSibling !== undefined && communication.sibling === true) {
+    if (wiring?.sendSibling !== undefined) {
         childTools.push(api.registerTool({
             name: "subagent_send",
             label: "Message a sibling",
             description: "Send one bounded message to a sibling subagent (a child of the same parent), addressed by its sessionId. " +
-                "Cross-family addressing is rejected.",
+                "Cross-family addressing is rejected. This channel is for data and intermediate artifacts only: task " +
+                "assignment and result acceptance stay with the parent agent. Sibling messages are visible to the parent " +
+                "(audited as excerpts with task results).",
             parameters: Type.Object({
                 to: Type.String({ description: "Recipient child session id" }),
                 text: Type.String({
@@ -735,7 +719,8 @@ export function createCapability(api, options) {
             name: "subagent_inbox",
             label: "Read sibling inbox",
             description: "Read and clear the earliest bounded messages your siblings sent you (subagent_send). Messages are " +
-                "consumed by this call; poll it when coordination is expected.",
+                "consumed by this call; poll it when coordination is expected. The sibling channel carries data and " +
+                "intermediate artifacts only — assignment and acceptance stay with the parent, which can audit this traffic.",
             parameters: Type.Object({
                 limit: Type.Optional(Type.Number({ description: "Max messages to take (1..20, default 10)", minimum: 1, maximum: 20 })),
             }),
@@ -875,12 +860,12 @@ export function createCapability(api, options) {
     // 100）：对**非 resume** 的每次 submit 计数，超限按 `subagent_child_quota` 拒绝。
     const maxTotalPerParent = resolveInt(undefined, configInt(api, "maxTotalPerParent", 0), 100, 0, "maxTotalPerParent");
     let createdSubagentCount = 0;
-    // 后台委派开关（D-060 S6）：默认关；显式 `true` 才给 `subagent_run` 加 `background`
-    // 参数（提交即返回票据，不阻塞父回合；结算摘要经宿主 sink 进父的下一次模型轮次）。
-    if (api.config.background !== undefined && api.config.background !== true) {
-        throw new Error("subagent-delegate config background must be true or omitted");
+    // background 配置键已移除（D-060 裁决 15，2026-10-03）：后台委派是功能基本面，
+    // 无条件注册（`subagent_run` 的 background 参数与 subagent_cancel / subagent_steer
+    // 随之常在）；键出现即装载期失败，不留"配置了但没生效"的假象。
+    if (api.config.background !== undefined) {
+        throw new Error("subagent-delegate config background was removed (D-060 ruling 15): background delegation registers unconditionally; remove the key");
     }
-    const backgroundEnabled = api.config.background === true;
     // 角色目录 + 方案关联在装载期解析：非法文件/非法关联直接失败，不留"配置了但没生效"的假象。
     const roleCatalog = options?.roles === undefined
         ? { roles: new Map(), dangling: [], brokenUnassociated: [] }
@@ -935,6 +920,7 @@ export function createCapability(api, options) {
         parentSessionId: session.getSessionId(),
         ...(sessionAbortSignal === undefined ? {} : { parentSignal: sessionAbortSignal }),
         ...(limits === undefined ? {} : { limits }),
+        ...(api.logger === undefined ? {} : { logger: api.logger }),
     });
     const parameters = Type.Object({
         prompts: Type.Array(Type.String({
@@ -977,6 +963,14 @@ export function createCapability(api, options) {
                         "Omit for a generic task. Roles frame the task; they do not change the child's model or tools.",
                 })),
             }),
+        // background（D-060 S6）在 properties 内组合：此前的 `{...parameters, background}`
+        // 顶层展开把键放在 properties 之外，模型面 schema（anthropic 只取 schema.properties、
+        // openai 原样透传）从未真正声明该参数——D-060 裁决 13 翻转后随默认注册修正，
+        // 裁决 15 起开关形态退役、参数无条件声明。
+        background: Type.Optional(Type.Boolean({
+            description: "Submit without waiting: return task tickets immediately and keep working; settled results are " +
+                "announced at your next model round and can be read with subagent_result (optionally waiting).",
+        })),
     });
     const tool = api.registerTool({
         name: "subagent_run",
@@ -986,21 +980,19 @@ export function createCapability(api, options) {
             "final-assistant summary come back; ask a child for more detail in its prompt if you need it." +
             " Optionally pass `context` — file:line anchors and commands already tried and failed are rendered as a " +
             "header block at the top of each child prompt (pointers only)." +
+            // fork-join 推荐模式（D-060 裁决 14）：大任务拆并行块 + 最终组合任务，中间产物
+            // 留子层、主上下文不膨胀；通知粒度——结算必然回注但只有组合任务的报告需验收。
+            " For large splittable work prefer fork-join: launch the parallel chunk tasks with background:true, then submit " +
+            "one final assembly task (a separate background call) that gathers the chunks with subagent_result({taskId, waitMs}) " +
+            "— intermediate results stay in the child layer and only the assembled final report enters your context. Every " +
+            "task's settlement is announced to you (agent-task-settled), but notifications are not per-task acceptances: " +
+            "accept and act on (todos/goals/next steps) only the final assembly task's report; other settled lines are " +
+            "status only." +
             (roles.size === 0
                 ? ""
                 : ` Configured subagent roles (pass \`role\`): ${roleSummary}. A role's instructions frame every task in the call; ` +
                     "child model and tools stay inherited from this session."),
-        parameters: {
-            ...parameters,
-            ...(backgroundEnabled
-                ? {
-                    background: Type.Optional(Type.Boolean({
-                        description: "Submit without waiting: return task tickets immediately and keep working; settled results are " +
-                            "announced at your next model round and can be read with subagent_result (optionally waiting).",
-                    })),
-                }
-                : {}),
-        },
+        parameters,
         execute: async (first, second, _signal, onUpdate) => {
             const input = objectInput(first, second);
             const prompts = readPrompts(input.prompts, maxTasksPerCall);
@@ -1008,7 +1000,7 @@ export function createCapability(api, options) {
             // context 注入（设计 §2.3）：形状/边界违规在此整体拒绝；两个列表皆空归一化为
             // undefined，后续路径与 context 缺省完全一致。
             const contextBlock = renderDelegateContext(parseDelegateContext(input.context));
-            const background = backgroundEnabled && input.background === true;
+            const background = input.background === true;
             // 嵌套深度硬限（退役切片 2，Option A）：沿 S2 血缘头回溯本会话层级，已达
             // maxNestedDepth 层时整次调用结构化拒绝——递归的兜底边界（不依赖模型自觉）。
             // resume 不涉深度（S5 裁定：续写既有会话不计新层级，走 subagent_resume）。
@@ -1120,9 +1112,12 @@ export function createCapability(api, options) {
                     const record = await handle.drain({ timeoutMs: taskTimeoutMs });
                     // escalate 上抛（D-060 S4）：随任务投影一起交回父模型（取后即清）。
                     const escalations = wiring?.drainEscalations?.(record.sessionId) ?? [];
+                    // 兄弟流量摘录（D-060 裁决 14）：只读审计面，随同一信封对父可见。
+                    const siblingTraffic = wiring?.readSiblingTraffic?.(record.sessionId, SIBLING_TRAFFIC_EXCERPTS) ?? [];
                     tasks[item.index] = {
                         ...projectRecord(record),
                         ...(escalations.length === 0 ? {} : { escalations }),
+                        ...(siblingTraffic.length === 0 ? {} : { siblingTraffic }),
                     };
                 }
                 catch (error) {
@@ -1200,6 +1195,7 @@ export function createCapability(api, options) {
                 const messages = record.messages.slice(-requested);
                 // escalate 上抛（D-060 S4）：按子会话 id 取走并随信封返回（取后即清）。
                 const escalations = wiring?.drainEscalations?.(record.sessionId) ?? [];
+                const siblingTraffic = wiring?.readSiblingTraffic?.(record.sessionId, SIBLING_TRAFFIC_EXCERPTS) ?? [];
                 return {
                     found: true,
                     source: "record",
@@ -1214,6 +1210,7 @@ export function createCapability(api, options) {
                     truncated: record.truncated || messages.length < record.messages.length,
                     messages: messages.map((message) => detachedSessionSnapshot(message)),
                     ...(escalations.length === 0 ? {} : { escalations }),
+                    ...(siblingTraffic.length === 0 ? {} : { siblingTraffic }),
                 };
             }
             const reader = agents?.session;
@@ -1225,6 +1222,7 @@ export function createCapability(api, options) {
                 return { found: false, source: "session", sessionId };
             const entries = view.entries.slice(-requested);
             const escalations = wiring?.drainEscalations?.(view.sessionId) ?? [];
+            const siblingTraffic = wiring?.readSiblingTraffic?.(view.sessionId, SIBLING_TRAFFIC_EXCERPTS) ?? [];
             return {
                 found: true,
                 source: "session",
@@ -1236,96 +1234,137 @@ export function createCapability(api, options) {
                 truncated: view.truncated || entries.length < view.entryCount,
                 messages: entries.map((entry) => detachedSessionSnapshot(entry)),
                 ...(escalations.length === 0 ? {} : { escalations }),
+                ...(siblingTraffic.length === 0 ? {} : { siblingTraffic }),
             };
         },
     });
-    // steer 不设模型面工具（D-060 S4）：`subagent_run` 是阻塞式 drain-to-terminal，
-    // 父模型在工具调用期间不存在"运行中的子任务"窗口——暴露即死 affordance（与
-    // `deadlineMs` 同一纪律）。父→子 steer 走程序面：agents 桥的 `steer`（运行中
-    // 的后台任务）与本调度器的 `steer`/`findBySession` 原语，供编排插件组合。
-    // subagent_cancel（S4 补充裁决，2026-10-01）：仅 background 委派启用时注册——
-    // 前台 drain 下父模型在 subagent_run 阻塞中不存在运行中窗口（与 steer 的 S4
-    // 裁决同前提），cancel 只在 background 委派返回票据后才有可达窗口。
-    const cancelTool = backgroundEnabled
-        ? api.registerTool({
-            name: "subagent_cancel",
-            label: "Cancel a background subagent",
-            description: "Cancel a running background subagent task by its taskId (the ticket returned by subagent_run with " +
-                "background: true). Only background delegation tickets are cancellable: a foreground subagent_run call " +
-                "blocks until its tasks finish, so it never leaves a running task behind. Terminal statuses (including a " +
-                "task cancelled by something else) come back as already_terminal; unknown taskIds as not_found.",
-            parameters: Type.Object({
-                taskId: Type.String({ description: "Task id from a background subagent_run ticket" }),
-                reason: Type.Optional(Type.String({ description: "Short reason recorded on the cancellation fence" })),
+    // steer 的模型面（D-060 裁决 13，2026-10-02 用户裁决）：`subagent_steer` 随
+    // background 面注册。原 S4 裁决"steer 不设模型面工具"的前提——前台阻塞 drain 下
+    // 父模型无"运行中窗口"——在 background 默认开后失效（提交即返回票据，运行中窗口
+    // 存在），该论证保留为背景说明。语义对齐主流取证（codex v2 send_message /
+    // ZCode SendMessage 均为模型面排队投递）：不打断子代理当前回合，在其下一个模型
+    // 请求前生效。程序面（agents 桥的 steer 与本调度器的 steer/findBySession 原语）
+    // 保持不变，供编排插件组合。
+    // subagent_cancel（S4 补充裁决，2026-10-01）：原"仅 background 委派启用时注册"
+    // 的前提（前台 drain 下父模型在 subagent_run 阻塞中不存在运行中窗口）保留为
+    // 背景说明——cancel 只在 background 委派返回票据后才有可达窗口。
+    // 两个工具自 D-060 裁决 15（2026-10-03）起无条件注册（开关形态退役）。
+    const cancelTool = api.registerTool({
+        name: "subagent_cancel",
+        label: "Cancel a background subagent",
+        description: "Cancel a running background subagent task by its taskId (the ticket returned by subagent_run with " +
+            "background: true). Only background delegation tickets are cancellable: a foreground subagent_run call " +
+            "blocks until its tasks finish, so it never leaves a running task behind. Terminal statuses (including a " +
+            "task cancelled by something else) come back as already_terminal; unknown taskIds as not_found.",
+        parameters: Type.Object({
+            taskId: Type.String({ description: "Task id from a background subagent_run ticket" }),
+            reason: Type.Optional(Type.String({ description: "Short reason recorded on the cancellation fence" })),
+        }),
+        execute: async (first, second) => {
+            const input = objectInput(first, second);
+            const taskId = typeof input.taskId === "string" ? input.taskId : "";
+            if (taskId.trim() === "") {
+                throw new SubagentDelegateError("subagent_invalid_input", "subagent_cancel requires a taskId");
+            }
+            const reason = typeof input.reason === "string" && input.reason.trim() !== "" ? input.reason : undefined;
+            const result = await runtime.cancelById(taskId, { owner: capabilityManifest.id, parentSessionId: session.getSessionId() }, reason);
+            return result.outcome === "not_found"
+                ? { outcome: "not_found", taskId }
+                : { outcome: result.outcome, taskId, status: result.status };
+        },
+    });
+    // subagent_steer（D-060 裁决 13）：与 cancelTool 同属 background 面——有界引导消息
+    // 投递给运行中的后台子任务（排队语义），需要硬终止时模型仍走 subagent_cancel。
+    // D-060 裁决 15（2026-10-03）起无条件注册（开关形态退役）。
+    const steerTool = api.registerTool({
+        name: "subagent_steer",
+        label: "Steer a background subagent",
+        description: "Deliver one bounded steering message to a running background subagent task by its taskId (the ticket " +
+            "returned by subagent_run with background: true). Queued delivery: it does NOT interrupt the subagent's " +
+            "current turn — it takes effect before the task's next model request. Use it when user feedback or new " +
+            "information should change the subtask's direction. Use subagent_cancel when the task must stop instead.",
+        parameters: Type.Object({
+            taskId: Type.String({ description: "Task id from a background subagent_run ticket" }),
+            text: Type.String({
+                minLength: 1,
+                description: `Bounded steering message (at most ${SUBAGENT_MAILBOX_MAX_MESSAGE_BYTES} utf-8 bytes), delivered before the task's next model request`,
             }),
-            execute: async (first, second) => {
-                const input = objectInput(first, second);
-                const taskId = typeof input.taskId === "string" ? input.taskId : "";
-                if (taskId.trim() === "") {
-                    throw new SubagentDelegateError("subagent_invalid_input", "subagent_cancel requires a taskId");
-                }
-                const reason = typeof input.reason === "string" && input.reason.trim() !== "" ? input.reason : undefined;
-                const result = await runtime.cancelById(taskId, { owner: capabilityManifest.id, parentSessionId: session.getSessionId() }, reason);
-                return result.outcome === "not_found"
-                    ? { outcome: "not_found", taskId }
-                    : { outcome: result.outcome, taskId, status: result.status };
-            },
-        })
-        : undefined;
+        }),
+        execute: async (first, second) => {
+            const input = objectInput(first, second);
+            const taskId = typeof input.taskId === "string" ? input.taskId : "";
+            const text = typeof input.text === "string" ? input.text : "";
+            if (taskId.trim() === "" || text.trim() === "") {
+                throw new SubagentDelegateError("subagent_invalid_input", "subagent_steer requires a taskId and non-empty text");
+            }
+            if (Buffer.byteLength(text, "utf8") > SUBAGENT_MAILBOX_MAX_MESSAGE_BYTES) {
+                throw new SubagentDelegateError("subagent_message_too_large", `subagent_steer text exceeds ${SUBAGENT_MAILBOX_MAX_MESSAGE_BYTES} utf-8 bytes`);
+            }
+            try {
+                await runtime.steer(taskId, text, {
+                    owner: capabilityManifest.id,
+                    parentSessionId: session.getSessionId(),
+                });
+            }
+            catch (error) {
+                mapCommunicationError(error);
+            }
+            return { delivered: true, taskId };
+        },
+    });
     /**
-     * 父→子续跑（D-060 S4，默认关）：对**已终态且已落盘**的子会话按 sessionId 继续
-     * 提交一轮任务（同一份 JSONL 续写，多轮子任务）。血缘作用域由宿主会话回读器判定，
-     * 活跃任务占用以 `subagent_session_busy` 拒绝。shared 与 pooled 都支持——pooled 下
+     * 父→子续跑（D-060 S4）：对**已终态且已落盘**的子会话按 sessionId 继续提交一轮
+     * 任务（同一份 JSONL 续写，多轮子任务）。血缘作用域由宿主会话回读器判定，活跃
+     * 任务占用以 `subagent_session_busy` 拒绝。shared 与 pooled 都支持——pooled 下
      * resume 键随 metadata 过线，runner 打开既有会话文件续写。
+     * D-060 裁决 15（2026-10-03）起无条件注册（开关形态退役）。
      */
-    const resumeTool = communication.resume === true
-        ? api.registerTool({
-            name: "subagent_resume",
-            label: "Resume a subagent",
-            description: "Continue a finished subagent session by its sessionId: submit one more prompt into the same persisted " +
-                "transcript (multi-turn subtask) and get the bounded terminal projection, like subagent_run for one task.",
-            parameters: Type.Object({
-                sessionId: Type.String({ description: "Child session id of a finished subagent task" }),
-                prompt: Type.String({ minLength: 1, description: "Follow-up prompt for the continued session" }),
-            }),
-            execute: async (first, second) => {
-                const input = objectInput(first, second);
-                const sessionId = typeof input.sessionId === "string" ? input.sessionId : "";
-                const prompt = typeof input.prompt === "string" ? input.prompt : "";
-                if (sessionId === "" || prompt.trim() === "") {
-                    throw new SubagentDelegateError("subagent_invalid_input", "subagent_resume requires sessionId and prompt");
-                }
-                const reader = agents?.session;
-                if (reader === undefined) {
-                    throw new SubagentDelegateError("subagent_profile_not_applied", "this host exposes no session reader; resume cannot verify the session scope");
-                }
-                const view = await reader(sessionId);
-                if (view === undefined) {
-                    throw new SubagentDelegateError("subagent_unknown_session", `no child session ${sessionId} under this parent`);
-                }
-                const requester = { owner: capabilityManifest.id, parentSessionId: session.getSessionId() };
-                const active = runtime.findBySession(sessionId, requester);
-                if (active !== undefined && !active.settled) {
-                    throw new SubagentDelegateError("subagent_session_busy", `session ${sessionId} still has an unsettled task (${active.taskId}); steer or wait instead`);
-                }
-                let handle;
-                try {
-                    handle = await runtime.submit({
-                        prompt,
-                        metadata: {
-                            [AGENT_TASK_PARENT_SESSION_KEY]: session.getSessionId(),
-                            [AGENT_TASK_RESUME_SESSION_KEY]: sessionId,
-                        },
-                    });
-                }
-                catch (error) {
-                    throw new SubagentDelegateError("subagent_submit_rejected", errorText(error));
-                }
-                const record = await handle.drain({ timeoutMs: taskTimeoutMs });
-                return { tasks: [projectRecord(record)] };
-            },
-        })
-        : undefined;
+    const resumeTool = api.registerTool({
+        name: "subagent_resume",
+        label: "Resume a subagent",
+        description: "Continue a finished subagent session by its sessionId: submit one more prompt into the same persisted " +
+            "transcript (multi-turn subtask) and get the bounded terminal projection, like subagent_run for one task.",
+        parameters: Type.Object({
+            sessionId: Type.String({ description: "Child session id of a finished subagent task" }),
+            prompt: Type.String({ minLength: 1, description: "Follow-up prompt for the continued session" }),
+        }),
+        execute: async (first, second) => {
+            const input = objectInput(first, second);
+            const sessionId = typeof input.sessionId === "string" ? input.sessionId : "";
+            const prompt = typeof input.prompt === "string" ? input.prompt : "";
+            if (sessionId === "" || prompt.trim() === "") {
+                throw new SubagentDelegateError("subagent_invalid_input", "subagent_resume requires sessionId and prompt");
+            }
+            const reader = agents?.session;
+            if (reader === undefined) {
+                throw new SubagentDelegateError("subagent_profile_not_applied", "this host exposes no session reader; resume cannot verify the session scope");
+            }
+            const view = await reader(sessionId);
+            if (view === undefined) {
+                throw new SubagentDelegateError("subagent_unknown_session", `no child session ${sessionId} under this parent`);
+            }
+            const requester = { owner: capabilityManifest.id, parentSessionId: session.getSessionId() };
+            const active = runtime.findBySession(sessionId, requester);
+            if (active !== undefined && !active.settled) {
+                throw new SubagentDelegateError("subagent_session_busy", `session ${sessionId} still has an unsettled task (${active.taskId}); steer or wait instead`);
+            }
+            let handle;
+            try {
+                handle = await runtime.submit({
+                    prompt,
+                    metadata: {
+                        [AGENT_TASK_PARENT_SESSION_KEY]: session.getSessionId(),
+                        [AGENT_TASK_RESUME_SESSION_KEY]: sessionId,
+                    },
+                });
+            }
+            catch (error) {
+                throw new SubagentDelegateError("subagent_submit_rejected", errorText(error));
+            }
+            const record = await handle.drain({ timeoutMs: taskTimeoutMs });
+            return { tasks: [projectRecord(record)] };
+        },
+    });
     /**
      * 子会话盘点（D-060 模型面）：列出**本会话自己的**子代理会话（最近活动倒序、
      * 有界），并用调度器记录富化活跃/终态信息。宿主注入 `agents.list` 才注册；
@@ -1379,8 +1418,9 @@ export function createCapability(api, options) {
     return [
         tool,
         resultTool,
-        ...(cancelTool === undefined ? [] : [cancelTool]),
-        ...(resumeTool === undefined ? [] : [resumeTool]),
+        cancelTool,
+        steerTool,
+        resumeTool,
         ...(listTool === undefined ? [] : [listTool]),
         // 子侧通信面（D-060 S4/S5）：获准自建会话两面并存（向下委派 + 向父上抛/兄弟消息）。
         ...childTools,