@ai-agent-forge/plugin-subagent-delegate 0.88.16 → 0.88.18

package/dist/delegate.js

@@ -1078,7 +1078,7 @@ export function createCapability(api, options) {
                 "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 })),
+                limit: Type.Optional(Type.Integer({ description: "Max messages to take (1..20, default 10)", minimum: 1, maximum: 20 })),
             }),
             execute: async (first, second) => {
                 const input = objectInput(first, second, 'subagent_message type "inbox"');
@@ -1114,7 +1114,12 @@ export function createCapability(api, options) {
                 ].join("; ") +
                 "; task assignment and result acceptance stay with the parent agent, which can audit sibling traffic.",
             parameters: Type.Object({
-                type: Type.Union(messageOps.map((op) => Type.Literal(op)), { description: `Operation: ${messageOps.join(" | ")}` }),
+                type: Type.Union(messageOps.map((op) => Type.Literal(op)), {
+                    description: `Operation: ${messageOps.join(" | ")}. Per-operation contract: ` +
+                        '"escalate" needs non-empty text; "send" needs to and non-empty text; ' +
+                        '"inbox" takes only limit; "refuse" needs non-empty text. ' +
+                        "Parameters belonging to another operation are rejected",
+                }),
                 ...optionalParams(escalateSpec?.parameters.properties, sendSpec?.parameters.properties, inboxSpec?.parameters.properties, 
                 // refuse 无条件创建，属性总是合入：type 进了 messageOps 而 schema 漏合
                 // = 模型被 schema 约束永远发不出该 type 的合法参数（教形状也救不回）。
@@ -1449,6 +1454,10 @@ export function createCapability(api, options) {
             // 死线兜底（设计 §5.7）：后台任务缺省 60 分钟死线，挂死任务到点被强制 timed_out。
             " Background tasks carry a watchdog deadline by default (60 minutes; override per call with `deadlineMs`): " +
             "a task still running when its deadline passes is force-settled timed_out." +
+            // 前台 drain 预算与嵌套深度上限：两者都在长任务里会被真实撞到。
+            " Foreground calls wait at most 10 minutes per task; a task still running then settles timed_out with reasonCode " +
+            "subagent_drain_timeout — use background: true for longer work. Nested delegation is capped at depth 2: a subagent " +
+            "already two levels deep cannot delegate further." +
             (roles.size === 0
                 ? ""
                 : ` Configured subagent roles (pass \`role\`): ${renderRoleMenu()}. A role's instructions frame every task in the call; ` +
@@ -2043,8 +2052,8 @@ export function createCapability(api, options) {
             sessionId: Type.Optional(Type.String({
                 description: "Child session id (persisted transcript read; requires a host session reader)",
             })),
-            maxMessages: Type.Optional(Type.Number({ description: "Trailing entries to return (1..50, default 20)", minimum: 1, maximum: 50 })),
-            waitMs: Type.Optional(Type.Number({
+            maxMessages: Type.Optional(Type.Integer({ description: "Trailing entries to return (1..50, default 20)", minimum: 1, maximum: 50 })),
+            waitMs: Type.Optional(Type.Integer({
                 description: "Bounded wait for a background task to settle, in ms (0..120000, default 0 = check once; " +
                     "unsettled tasks come back with knownTask/taskStatus instead of the transcript)",
                 minimum: 0,
@@ -2270,7 +2279,11 @@ export function createCapability(api, options) {
                 "size; tasks still in flight are marked active, settled ones carry their terminal status. Read-only. " +
                 'Use a listed sessionId with subagent_task type "result" or "resume".',
             parameters: Type.Object({
-                limit: Type.Optional(Type.Number({ description: "Max entries to return (1..50, default 20)", minimum: 1, maximum: 50 })),
+                limit: Type.Optional(Type.Integer({
+                    description: "Max entries to return (1..50, default 20)",
+                    minimum: 1,
+                    maximum: 50,
+                })),
             }),
             execute: async (first, second) => {
                 const input = objectInput(first, second, 'subagent_task type "list"');
@@ -2324,12 +2337,22 @@ export function createCapability(api, options) {
             ].join("; ") +
             ". Task creation stays in subagent_run.",
         parameters: Type.Object({
-            type: Type.Union(taskOps.map((op) => Type.Literal(op)), { description: `Operation: ${taskOps.join(" | ")}` }),
+            type: Type.Union(taskOps.map((op) => Type.Literal(op)), {
+                description: `Operation: ${taskOps.join(" | ")}. Per-operation contract: ` +
+                    '"result" needs taskId or sessionId (optional maxMessages, waitMs); ' +
+                    '"cancel" needs taskId (optional reason); ' +
+                    '"steer" needs taskId and non-empty text; ' +
+                    '"resume" needs sessionId and prompt; ' +
+                    '"list" takes only limit. ' +
+                    "Parameters belonging to another operation are rejected, and a missing required parameter is an error",
+            }),
             ...optionalParams(resultSpec.parameters.properties, cancelSpec.parameters.properties, steerSpec.parameters.properties, resumeSpec.parameters.properties, listSpec?.parameters.properties),
             // Shared keys across operations: neutral descriptions instead of the
             // last merged spec's operation-specific wording.
-            taskId: Type.Optional(Type.String({ description: "Task id from subagent_run (result/cancel/steer)" })),
-            sessionId: Type.Optional(Type.String({ description: "Child session id (result reads its transcript, resume continues it)" })),
+            taskId: Type.Optional(Type.String({
+                description: "Task id from subagent_run (required for result without sessionId, cancel, steer)",
+            })),
+            sessionId: Type.Optional(Type.String({ description: "Child session id (required for resume; alternative to taskId for result)" })),
         }),
         execute: async (first, second) => {
             const input = objectInput(first, second, "subagent_task");