mcp-subagents-opencode 1.0.0

package/build/tools/spawn-researcher.d.ts

@@ -0,0 +1,70 @@
+export declare const spawnResearcherTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            prompt: {
+                type: string;
+                description: string;
+            };
+            context_files: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        path: {
+                            type: string;
+                            description: string;
+                        };
+                        description: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            research_type: {
+                type: string;
+                enum: ("general" | "architecture" | "performance" | "security" | "library")[];
+                description: string;
+            };
+            model: {
+                type: string;
+                enum: ("claude-opus-4.6" | "claude-haiku-4.5" | "claude-sonnet-4.5")[];
+                description: string;
+            };
+            cwd: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+            autonomous: {
+                type: string;
+                description: string;
+            };
+            depends_on: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const handleSpawnResearcher: (args: unknown, ctx?: import("../types.js").ToolContext) => import("./shared-spawn.js").SpawnHandlerResult;
+//# sourceMappingURL=spawn-researcher.d.ts.map

package/build/tools/spawn-researcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-researcher.d.ts","sourceRoot":"","sources":["../../src/tools/spawn-researcher.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2D/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,4GAMhC,CAAC"}

package/build/tools/spawn-researcher.js

@@ -0,0 +1,70 @@
+import { SpawnResearcherSchema, RESEARCH_TYPES } from '../utils/sanitize.js';
+import { MODEL_IDS, DEFAULT_MODEL } from '../models.js';
+import { createSpawnHandler } from './shared-spawn.js';
+export const spawnResearcherTool = {
+    name: 'spawn_researcher',
+    description: `Spawn an autonomous research agent. Searches web, scrapes docs, analyzes Reddit, explores codebase. Evidence-based — every finding traces to a source.
+
+**Required:** prompt (min 200 chars) with specific questions.
+
+**Prompt must include:** WHAT TO RESEARCH (specific question), WHY IT MATTERS, WHAT'S ALREADY KNOWN, SPECIFIC QUESTIONS (2-5), HANDOFF TARGET.
+
+**Creates:** \`.agent-workspace/researches/[topic]/\` with HANDOFF.md, recommendation, action-items.
+Use HANDOFF.md as context_file when spawning planner/coder.
+
+**Workflow:** spawn_researcher → spawn_planner → spawn_coder → spawn_tester. Use \`depends_on\` to chain.
+Check status: \`task:///all\` or \`task:///{id}\``,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            prompt: {
+                type: 'string',
+                description: `Min 200 chars. Research brief with specific questions: WHAT TO RESEARCH, WHY IT MATTERS, WHAT'S KNOWN, SPECIFIC QUESTIONS (2-5), HANDOFF TARGET.`,
+            },
+            context_files: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        path: { type: 'string', description: 'Absolute path to file.' },
+                        description: { type: 'string', description: 'What this file is.' },
+                    },
+                    required: ['path'],
+                },
+                description: `Optional. Attach code or docs for analysis. Max 20 files, 200KB each, 500KB total.`,
+            },
+            research_type: {
+                type: 'string',
+                enum: [...RESEARCH_TYPES],
+                description: `Specialization: security (OWASP/CVE/STRIDE), library (comparison matrix, health signals), performance (benchmarks, profiling), architecture (design patterns). Default: general.`,
+            },
+            model: {
+                type: 'string',
+                enum: MODEL_IDS,
+                description: `Default: ${DEFAULT_MODEL}.`,
+            },
+            cwd: { type: 'string', description: 'Absolute path to working directory.' },
+            timeout: { type: 'number', description: 'Max ms. Default: 1800000 (30min).' },
+            autonomous: { type: 'boolean', description: 'Default: true.' },
+            depends_on: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Task IDs that must complete first.',
+            },
+            labels: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Labels for grouping (max 10).',
+            },
+        },
+        required: ['prompt'],
+    },
+};
+export const handleSpawnResearcher = createSpawnHandler({
+    schema: SpawnResearcherSchema,
+    toolName: 'spawn_researcher',
+    taskType: 'super-researcher',
+    validationHint: 'Required: `prompt` (min 200 chars) with specific questions to answer.',
+    getSpecialization: (parsed) => parsed.research_type,
+});
+//# sourceMappingURL=spawn-researcher.js.map

package/build/tools/spawn-researcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-researcher.js","sourceRoot":"","sources":["../../src/tools/spawn-researcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;kDAUmC;IAEhD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kJAAkJ;aAChK;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;wBAC/D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;qBACnE;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;gBACD,WAAW,EAAE,oFAAoF;aAClG;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,GAAG,cAAc,CAAC;gBACzB,WAAW,EAAE,kLAAkL;aAChM;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,YAAY,aAAa,GAAG;aAC1C;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;YAC7E,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE;YAC9D,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,oCAAoC;aAClD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;IACtD,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,kBAAkB;IAC5B,cAAc,EAAE,uEAAuE;IACvF,iBAAiB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa;CACpD,CAAC,CAAC"}

package/build/tools/spawn-task.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Legacy spawn_task tool — kept for backward compatibility.
+ * New clients should use the specialized tools: spawn_coder, spawn_planner, spawn_tester, spawn_researcher.
+ */
+export declare const spawnTaskTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            prompt: {
+                type: string;
+                description: string;
+            };
+            task_type: {
+                type: string;
+                enum: ("super-planner" | "super-coder" | "super-researcher" | "super-tester")[];
+                description: string;
+            };
+            context_files: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        path: {
+                            type: string;
+                            description: string;
+                        };
+                        description: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            model: {
+                type: string;
+                enum: ("claude-opus-4.6" | "claude-haiku-4.5" | "claude-sonnet-4.5")[];
+                description: string;
+            };
+            cwd: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+            autonomous: {
+                type: string;
+                description: string;
+            };
+            depends_on: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const handleSpawnTask: (args: unknown, ctx?: import("../types.js").ToolContext) => import("./shared-spawn.js").SpawnHandlerResult;
+//# sourceMappingURL=spawn-task.d.ts.map

package/build/tools/spawn-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-task.d.ts","sourceRoot":"","sources":["../../src/tools/spawn-task.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FzB,CAAC;AAEF,eAAO,MAAM,eAAe,4GAK1B,CAAC"}

package/build/tools/spawn-task.js

@@ -0,0 +1,107 @@
+import { SpawnTaskSchema } from '../utils/sanitize.js';
+import { MODEL_IDS, DEFAULT_MODEL, OPUS_MODEL } from '../models.js';
+import { TASK_TYPE_IDS } from '../templates/index.js';
+import { createSpawnHandler } from './shared-spawn.js';
+/**
+ * Legacy spawn_task tool — kept for backward compatibility.
+ * New clients should use the specialized tools: spawn_coder, spawn_planner, spawn_tester, spawn_researcher.
+ */
+export const spawnTaskTool = {
+    name: 'spawn_task',
+    description: `Spawn an autonomous agent task. The agent runs isolated with NO shared memory -- your prompt is its ONLY context.
+
+⚠️ **PREFER THE SPECIALIZED TOOLS** for better guidance and validation:
+• \`spawn_coder\` — Implementation tasks (requires detailed brief + .md context files)
+• \`spawn_planner\` — Architecture & planning (always uses opus model)
+• \`spawn_tester\` — QA & testing (requires context files)
+• \`spawn_researcher\` — Investigation & research
+
+This generic tool applies lighter validation. The specialized tools enforce structured briefs, mandatory context files, and provide task-specific guidance that produces dramatically better results.
+
+**After spawning:** Check status via MCP Resources (not tools):
+- \`task:///all\` → List all tasks with status
+- \`task:///{id}\` → Full task details, output, metrics
+- \`task:///{id}/session\` → Execution log with tool calls
+
+**Task types:** super-coder (implementation), super-planner (architecture), super-researcher (investigation), super-tester (QA).
+**Models:** ${MODEL_IDS.join(', ')}. Default: ${DEFAULT_MODEL}.
+
+Account rotation and rate limit recovery happen automatically -- no manual intervention needed.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            prompt: {
+                type: 'string',
+                description: `The complete, self-contained instructions for the spawned agent. This is the ONLY context the agent will have.
+
+Your prompt MUST include:
+- WHAT to do: Clear, specific objective
+- WHERE to do it: All relevant file paths as absolute paths
+- HOW to verify: What does "done" look like?
+- CONTEXT: Background the agent needs
+
+⚠️ For better results, use the specialized tools instead:
+• spawn_coder (min 1,000 chars + .md files)
+• spawn_planner (min 300 chars + problem description)
+• spawn_tester (min 300 chars + context files)
+• spawn_researcher (min 200 chars + specific questions)`,
+            },
+            task_type: {
+                type: 'string',
+                enum: TASK_TYPE_IDS,
+                description: `Agent template. Use specialized tools (spawn_coder, etc.) for better validation.
+- super-coder: Implementation — writing, editing, refactoring code
+- super-planner: Architecture — planning implementations, evaluating tradeoffs
+- super-researcher: Investigation — answering questions, analyzing behavior
+- super-tester: QA — testing, running test suites, verifying behavior`,
+            },
+            context_files: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        path: { type: 'string', description: 'Absolute path to a context file.' },
+                        description: { type: 'string', description: 'What this file is and why it matters.' },
+                    },
+                    required: ['path'],
+                },
+                description: 'Optional context files. Their contents are read and injected into the prompt.',
+            },
+            model: {
+                type: 'string',
+                enum: MODEL_IDS,
+                description: `Model to use. Default: ${DEFAULT_MODEL}. super-planner always uses ${OPUS_MODEL}.`,
+            },
+            cwd: {
+                type: 'string',
+                description: 'Absolute path to the working directory.',
+            },
+            timeout: {
+                type: 'number',
+                description: 'Max execution time in ms. Default: 1800000 (30 min).',
+            },
+            autonomous: {
+                type: 'boolean',
+                description: 'Run without interactive prompts. Default: true.',
+            },
+            depends_on: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Task IDs that must complete before this task starts.',
+            },
+            labels: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Labels for grouping and filtering tasks (max 10).',
+            },
+        },
+        required: ['prompt'],
+    },
+};
+export const handleSpawnTask = createSpawnHandler({
+    schema: SpawnTaskSchema,
+    toolName: 'spawn_task',
+    validationHint: '💡 **TIP:** Use the specialized tools for better guidance:\n• `spawn_coder` — Implementation tasks\n• `spawn_planner` — Planning tasks\n• `spawn_tester` — Testing tasks\n• `spawn_researcher` — Research tasks',
+    getTaskType: (parsed) => parsed.task_type ? parsed.task_type : undefined,
+});
+//# sourceMappingURL=spawn-task.js.map

package/build/tools/spawn-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-task.js","sourceRoot":"","sources":["../../src/tools/spawn-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,aAAa,EAAiB,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE;;;;;;;;;;;;;;;;cAgBD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,aAAa;;gGAEmC;IAC9F,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;wDAYmC;aACjD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE;;;;sEAIiD;aAC/D;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;wBACzE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;qBACtF;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;gBACD,WAAW,EAAE,+EAA+E;aAC7F;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0BAA0B,aAAa,+BAA+B,UAAU,GAAG;aACjG;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sDAAsD;aACpE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iDAAiD;aAC/D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,sDAAsD;aACpE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;IAChD,MAAM,EAAE,eAAe;IACvB,QAAQ,EAAE,YAAY;IACtB,cAAc,EAAE,iNAAiN;IACjO,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAE,MAAM,CAAC,SAAsB,CAAC,CAAC,CAAC,SAAS;CACvF,CAAC,CAAC"}

package/build/tools/spawn-tester.d.ts

@@ -0,0 +1,70 @@
+export declare const spawnTesterTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            prompt: {
+                type: string;
+                description: string;
+            };
+            context_files: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        path: {
+                            type: string;
+                            description: string;
+                        };
+                        description: {
+                            type: string;
+                            description: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            testing_type: {
+                type: string;
+                enum: ("rest" | "general" | "playwright" | "graphql" | "suite" | "accessibility" | "performance" | "security")[];
+                description: string;
+            };
+            model: {
+                type: string;
+                enum: ("claude-opus-4.6" | "claude-haiku-4.5" | "claude-sonnet-4.5")[];
+                description: string;
+            };
+            cwd: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+            autonomous: {
+                type: string;
+                description: string;
+            };
+            depends_on: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare const handleSpawnTester: (args: unknown, ctx?: import("../types.js").ToolContext) => import("./shared-spawn.js").SpawnHandlerResult;
+//# sourceMappingURL=spawn-tester.d.ts.map

package/build/tools/spawn-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-tester.d.ts","sourceRoot":"","sources":["../../src/tools/spawn-tester.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0D3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,4GAM5B,CAAC"}

package/build/tools/spawn-tester.js

@@ -0,0 +1,69 @@
+import { SpawnTesterSchema, TESTING_TYPES } from '../utils/sanitize.js';
+import { MODEL_IDS, DEFAULT_MODEL } from '../models.js';
+import { createSpawnHandler } from './shared-spawn.js';
+export const spawnTesterTool = {
+    name: 'spawn_tester',
+    description: `Spawn an autonomous QA agent. Tests via curl, Playwright, or existing test suites. Proves things work end-to-end.
+
+**Required:** prompt (min 300 chars) + context_files (min 1 file).
+
+**Prompt must include:** WHAT WAS BUILT, FILES CHANGED, SUCCESS CRITERIA (testable), TEST SUGGESTIONS, EDGE CASES, BASE URL/SETUP.
+
+**Cross-reference:** Attach coder's HANDOFF.md or planner's tester-checklist.md as context_files.
+
+**Workflow:** spawn_planner → spawn_coder → spawn_tester. Use \`depends_on\` to chain.
+Check status: \`task:///all\` or \`task:///{id}\``,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            prompt: {
+                type: 'string',
+                description: `Min 300 chars. Testing brief: WHAT WAS BUILT, FILES CHANGED, SUCCESS CRITERIA, TEST SUGGESTIONS, EDGE CASES, BASE URL/SETUP.`,
+            },
+            context_files: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        path: { type: 'string', description: 'Absolute path to file.' },
+                        description: { type: 'string', description: 'What this file is.' },
+                    },
+                    required: ['path'],
+                },
+                description: `Min 1 file. Attach code, handoffs, or test checklists. Any file type accepted. Max 20 files, 200KB each, 500KB total.`,
+            },
+            testing_type: {
+                type: 'string',
+                enum: [...TESTING_TYPES],
+                description: `Specialization: playwright (browser/UI), rest (REST API curl), graphql (GraphQL API), suite (run existing tests), accessibility, performance, security. Default: general (auto-selects method).`,
+            },
+            model: {
+                type: 'string',
+                enum: MODEL_IDS,
+                description: `Default: ${DEFAULT_MODEL}.`,
+            },
+            cwd: { type: 'string', description: 'Absolute path to working directory.' },
+            timeout: { type: 'number', description: 'Max ms. Default: 1800000 (30min).' },
+            autonomous: { type: 'boolean', description: 'Default: true.' },
+            depends_on: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Task IDs that must complete first.',
+            },
+            labels: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Labels for grouping (max 10).',
+            },
+        },
+        required: ['prompt', 'context_files'],
+    },
+};
+export const handleSpawnTester = createSpawnHandler({
+    schema: SpawnTesterSchema,
+    toolName: 'spawn_tester',
+    taskType: 'super-tester',
+    validationHint: 'Required: `prompt` (min 300 chars) + `context_files` (min 1 file).',
+    getSpecialization: (parsed) => parsed.testing_type,
+});
+//# sourceMappingURL=spawn-tester.js.map

package/build/tools/spawn-tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-tester.js","sourceRoot":"","sources":["../../src/tools/spawn-tester.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;;kDASmC;IAEhD,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8HAA8H;aAC5I;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;wBAC/D,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;qBACnE;oBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;iBACnB;gBACD,WAAW,EAAE,uHAAuH;aACrI;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC;gBACxB,WAAW,EAAE,iMAAiM;aAC/M;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,YAAY,aAAa,GAAG;aAC1C;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC3E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;YAC7E,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,EAAE;YAC9D,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,oCAAoC;aAClD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;KACtC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;IAClD,MAAM,EAAE,iBAAiB;IACzB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc;IACxB,cAAc,EAAE,oEAAoE;IACpF,iBAAiB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY;CACnD,CAAC,CAAC"}

package/build/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Core types for mcp-subagents-opencode.
+ * Core types for mcp-subagents-opencode.
+ */
+import type { ServerNotification } from '@modelcontextprotocol/sdk/types.js';
+export type Provider = 'opencode';
+export declare enum TaskStatus {
+    PENDING = "pending",
+    WAITING = "waiting",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled",
+    RATE_LIMITED = "rate_limited",
+    TIMED_OUT = "timed_out"
+}
+export declare const TERMINAL_STATUSES: ReadonlySet<TaskStatus>;
+export declare function isTerminalStatus(status: TaskStatus): boolean;
+/** HTTP status codes that trigger retry/rotation. */
+export declare const ROTATABLE_STATUS_CODES: ReadonlySet<number>;
+export declare const RATE_LIMIT_STATUS_CODE = 429;
+export interface RetryInfo {
+    reason: string;
+    retryCount: number;
+    nextRetryTime: string;
+    maxRetries: number;
+    originalTaskId?: string;
+}
+export interface PendingQuestion {
+    question: string;
+    choices?: string[];
+    allowFreeform: boolean;
+    askedAt: string;
+    sessionId: string;
+}
+export interface FailureContext {
+    errorType?: string;
+    statusCode?: number;
+    errorContext?: string;
+    recoverable?: boolean;
+    message?: string;
+}
+export interface QuotaInfo {
+    remainingPercentage?: number;
+    resetDate?: string;
+}
+export interface TaskState {
+    id: string;
+    status: TaskStatus;
+    prompt: string;
+    output: string[];
+    startTime: string;
+    endTime?: string;
+    lastHeartbeatAt?: string;
+    lastOutputAt?: string;
+    cwd?: string;
+    model?: string;
+    autonomous?: boolean;
+    isResume?: boolean;
+    retryInfo?: RetryInfo;
+    dependsOn?: string[];
+    labels?: string[];
+    provider?: Provider;
+    fallbackAttempted?: boolean;
+    switchAttempted?: boolean;
+    timeout?: number;
+    timeoutAt?: string;
+    timeoutReason?: string;
+    timeoutContext?: Record<string, unknown>;
+    sessionId?: string;
+    exitCode?: number;
+    error?: string;
+    pendingQuestion?: PendingQuestion;
+    outputFilePath?: string;
+    failureContext?: FailureContext;
+    quotaInfo?: QuotaInfo;
+    /** Runtime session reference (not serialized) */
+    session?: {
+        abort: () => void | Promise<void>;
+    };
+}
+export interface SpawnOptions {
+    prompt: string;
+    timeout?: number;
+    cwd?: string;
+    model?: string;
+    taskType?: string;
+    autonomous?: boolean;
+    resumeSessionId?: string;
+    dependsOn?: string[];
+    labels?: string[];
+    provider?: Provider;
+    fallbackAttempted?: boolean;
+    switchAttempted?: boolean;
+    retryInfo?: RetryInfo;
+}
+export interface ToolContext {
+    progressToken?: string | number;
+    sendNotification: (notification: ServerNotification) => Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC;AAElC,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,YAAY,iBAAiB;IAC7B,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,UAAU,CAKpD,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE5D;AAED,qDAAqD;AACrD,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAsC,CAAC;AAC9F,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iDAAiD;IACjD,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,gBAAgB,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE"}

package/build/types.js

@@ -0,0 +1,28 @@
+/**
+ * Core types for mcp-subagents-opencode.
+ * Core types for mcp-subagents-opencode.
+ */
+export var TaskStatus;
+(function (TaskStatus) {
+    TaskStatus["PENDING"] = "pending";
+    TaskStatus["WAITING"] = "waiting";
+    TaskStatus["RUNNING"] = "running";
+    TaskStatus["COMPLETED"] = "completed";
+    TaskStatus["FAILED"] = "failed";
+    TaskStatus["CANCELLED"] = "cancelled";
+    TaskStatus["RATE_LIMITED"] = "rate_limited";
+    TaskStatus["TIMED_OUT"] = "timed_out";
+})(TaskStatus || (TaskStatus = {}));
+export const TERMINAL_STATUSES = new Set([
+    TaskStatus.COMPLETED,
+    TaskStatus.FAILED,
+    TaskStatus.CANCELLED,
+    TaskStatus.TIMED_OUT,
+]);
+export function isTerminalStatus(status) {
+    return TERMINAL_STATUSES.has(status);
+}
+/** HTTP status codes that trigger retry/rotation. */
+export const ROTATABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
+export const RATE_LIMIT_STATUS_CODE = 429;
+//# sourceMappingURL=types.js.map

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,CAAN,IAAY,UASX;AATD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,iCAAmB,CAAA;IACnB,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;IACjB,qCAAuB,CAAA;IACvB,2CAA6B,CAAA;IAC7B,qCAAuB,CAAA;AACzB,CAAC,EATW,UAAU,KAAV,UAAU,QASrB;AAED,MAAM,CAAC,MAAM,iBAAiB,GAA4B,IAAI,GAAG,CAAC;IAChE,UAAU,CAAC,SAAS;IACpB,UAAU,CAAC,MAAM;IACjB,UAAU,CAAC,SAAS;IACpB,UAAU,CAAC,SAAS;CACrB,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,sBAAsB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC"}

package/build/utils/brief-validator.d.ts

@@ -0,0 +1,30 @@
+export interface ContextFile {
+    path: string;
+    description?: string;
+}
+export interface ValidationError {
+    code: string;
+    message: string;
+    detail?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+}
+interface ToolValidationRules {
+    toolName: string;
+    minPromptLength: number;
+    requireContextFiles: boolean;
+    minContextFiles: number;
+    requireMdExtension: boolean;
+    maxFileSizeBytes: number;
+    maxTotalSizeBytes: number;
+    briefTemplate: string;
+    workflowHint: string;
+}
+export declare const VALIDATION_RULES: Record<string, ToolValidationRules>;
+export declare function validateBrief(toolName: string, prompt: string, contextFiles?: ContextFile[]): ValidationResult;
+export declare function formatValidationError(toolName: string, errors: ValidationError[]): string;
+export declare function assemblePromptWithContext(prompt: string, contextFiles?: ContextFile[]): string;
+export {};
+//# sourceMappingURL=brief-validator.d.ts.map

package/build/utils/brief-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief-validator.d.ts","sourceRoot":"","sources":["../../src/utils/brief-validator.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAoGD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAKhE,CAAC;AAIF,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,WAAW,EAAE,GAC3B,gBAAgB,CAuGlB;AAID,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CA4BzF;AAID,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,CA4B9F"}