opencode-task 0.1.3 → 0.1.5

package/dist/index.js

@@ -12331,6 +12331,94 @@ function tool(input) {
 tool.schema = exports_external;
 // utils.ts
 import { appendFile } from "node:fs/promises";
+var AGENT_CONFIGS = {
+  Explore: {
+    description: "Fast agent specialized for exploring codebases. Use when you need to quickly find files by patterns, search code for keywords, or answer questions about the codebase.",
+    prompt: "You are an exploration specialist. Search thoroughly using Glob, Grep, and Read. Report findings concisely. Do not modify any files.",
+    tools: [
+      "Glob",
+      "Grep",
+      "Read",
+      "Bash",
+      "LSP",
+      "WebFetch",
+      "WebSearch",
+      "AskUserQuestion"
+    ]
+  },
+  Plan: {
+    description: "Software architect agent for designing implementation plans. Use when you need to plan implementation strategy. Returns step-by-step plans, identifies critical files, considers architectural trade-offs.",
+    prompt: "You are a software architect. Analyze requirements, explore the codebase thoroughly, and design clear implementation plans with specific steps. Do not modify any files.",
+    tools: [
+      "Glob",
+      "Grep",
+      "Read",
+      "Bash",
+      "LSP",
+      "WebFetch",
+      "WebSearch",
+      "AskUserQuestion"
+    ]
+  },
+  "general-purpose": {
+    description: "General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. Use for heavy lifting when simpler agents are insufficient.",
+    prompt: "You are a general-purpose assistant. Complete the assigned task thoroughly and report results.",
+    tools: null
+  },
+  "claude-code-guide": {
+    description: "Expert on Claude Code CLI features, hooks, slash commands, MCP servers, settings, IDE integrations. Also covers Claude Agent SDK and Claude API usage.",
+    prompt: "You are a Claude Code expert. Answer questions about Claude Code features, Agent SDK, and API usage accurately. Search documentation and web resources as needed.",
+    tools: ["Glob", "Grep", "Read", "WebFetch", "WebSearch"]
+  },
+  "web-search": {
+    description: "Web researcher for external information not in the codebase. Use for: library docs, API references, error lookups, technology research, best practices. Do NOT use for codebase questions (use Explore) or Claude Code questions (use claude-code-guide).",
+    prompt: `Research specialist. Find accurate information, cite sources, flag uncertainty.
+
+TOOLS:
+- WebSearch: Broad queries, discover sources
+- WebFetch: Extract content from specific URLs
+- Read/Grep/Glob: Check local files for context before searching
+- Bash: Use curl, gh, or CLI tools for direct API access
+- AskUserQuestion: Clarify ambiguous requests BEFORE searching
+
+PROCEDURE:
+1. Parse request: factual lookup | how-to | comparison | troubleshooting
+2. Search: Start specific, broaden if <3 relevant results
+3. Verify: Single authoritative source for facts. Cross-reference for disputed topics.
+4. Synthesize: Answer directly, then evidence.
+
+FAILURE HANDLING:
+- Limit to 5 source pages unless requested otherwise
+- If page inaccessible (paywall/JS-only), note and try alternatives
+- After 3 failed query reformulations, report partial findings and unknowns
+
+STOP CONDITIONS:
+- Factual: Official source found → done
+- How-to: Working solution with docs link → done
+- Troubleshooting: Root cause found OR 3 searches no progress → report gaps
+
+QUALITY:
+- Reject sources >2yr old for fast-moving topics
+- Priority: official docs > GitHub issues > Stack Overflow > blogs
+- On conflict, report both positions with provenance
+
+OUTPUT:
+[Direct answer or "Unable to determine"]
+[Evidence with inline [source](url) citations]
+[Confidence: HIGH (multiple authoritative) | MEDIUM (single authoritative) | LOW (conflicting/unofficial)]`,
+    tools: [
+      "WebSearch",
+      "WebFetch",
+      "Bash",
+      "Grep",
+      "Glob",
+      "Read",
+      "AskUserQuestion"
+    ],
+    model: "sonnet"
+  }
+};
+
 class Semaphore {
   maxConcurrent;
   permits;
@@ -12473,7 +12561,7 @@ class TaskRegistry {
     if (!this.accepting) {
       throw new Error("Registry is shutting down");
     }
-    const id = `task-${this.nextId++}`;
+    const id = `task-${this.nextId++}-${crypto.randomUUID()}`;
     const cwd = options.cwd ?? process.cwd();
     const task = createTask(id, command, cwd, options.timeout, options.sessionID, options.metadata);
     this.tasks.set(id, task);
@@ -12770,6 +12858,58 @@ You will receive a notification when it completes.`,
           }
           return JSON.stringify(result);
         }
+      }),
+      AgentTask: tool({
+        description: "Spawn a Claude agent to work on a subtask in the background. Available agents: Explore (codebase search), Plan (architecture design), general-purpose (complex multi-step tasks), claude-code-guide (Claude Code/SDK questions), web-search (research external information). You will receive a notification when complete.",
+        args: {
+          agent: tool.schema.enum([
+            "Explore",
+            "Plan",
+            "general-purpose",
+            "claude-code-guide",
+            "web-search"
+          ]).describe("Agent type to spawn"),
+          prompt: tool.schema.string().describe("Task prompt for the agent"),
+          cwd: tool.schema.string().optional().describe("Working directory"),
+          timeout: tool.schema.number().optional().describe("Timeout in milliseconds")
+        },
+        async execute(args, context) {
+          const agentType = args.agent;
+          const config2 = AGENT_CONFIGS[agentType];
+          const agentDef = {
+            [agentType]: {
+              description: config2.description,
+              prompt: config2.prompt
+            }
+          };
+          const cmdParts = [
+            "claude",
+            "--verbose",
+            "--strict-mcp-config",
+            "--mcp-config",
+            '{"mcpServers":{}}',
+            "--allow-dangerously-skip-permissions",
+            "--agents",
+            JSON.stringify(agentDef),
+            "--agent",
+            agentType
+          ];
+          if (config2.tools !== null) {
+            cmdParts.push("--tools", config2.tools.join(","));
+          }
+          cmdParts.push("--output-format", "stream-json", "--print", "-p", args.prompt);
+          const command = cmdParts.map((p) => p.includes(" ") || p.includes('"') ? `'${p}'` : p).join(" ");
+          const id = await registry2.spawn(command, {
+            cwd: args.cwd,
+            timeout: args.timeout,
+            sessionID: context.sessionID
+          });
+          return JSON.stringify({
+            taskId: id,
+            agent: agentType,
+            message: `Agent ${agentType} spawned as ${id}. You will receive a notification when complete.`
+          });
+        }
       })
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-task",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "type": "module",
   "main": "dist/index.js",
   "files": ["dist"],