opencode-swarm-plugin 0.57.6 → 0.58.4

package/dist/swarm-prompts.js

@@ -17875,13 +17875,13 @@ Scripts run in the skill's directory with the project directory as an argument.`
       }
       const scriptPath = join3(skill.directory, "scripts", args.script);
       const scriptArgs = args.args || [];
+      const TIMEOUT_MS = 60000;
+      const proc = Bun.spawn([scriptPath, skillsProjectDirectory, ...scriptArgs], {
+        cwd: skill.directory,
+        stdout: "pipe",
+        stderr: "pipe"
+      });
       try {
-        const TIMEOUT_MS = 60000;
-        const proc = Bun.spawn([scriptPath, skillsProjectDirectory, ...scriptArgs], {
-          cwd: skill.directory,
-          stdout: "pipe",
-          stderr: "pipe"
-        });
         const timeoutPromise = new Promise((resolve2) => {
           setTimeout(() => resolve2({ timedOut: true }), TIMEOUT_MS);
         });
@@ -17895,7 +17895,6 @@ Scripts run in the skill's directory with the project directory as an argument.`
         })();
         const result = await Promise.race([resultPromise, timeoutPromise]);
         if (result.timedOut) {
-          proc.kill();
           return `Script timed out after ${TIMEOUT_MS / 1000} seconds.`;
         }
         const output = result.stdout + result.stderr;
@@ -17907,6 +17906,8 @@ ${output}`;
         }
       } catch (error45) {
         return `Failed to execute script: ${error45 instanceof Error ? error45.message : String(error45)}`;
+      } finally {
+        proc.kill();
       }
     }
   });
@@ -18809,9 +18810,11 @@ async function execSemanticMemory(args) {
       stderr: "pipe"
     });
     try {
+      const TIMEOUT_MS = 30000;
+      const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error("Process timed out after 30s")), TIMEOUT_MS));
       const stdout = Buffer.from(await new Response(proc.stdout).arrayBuffer());
       const stderr = Buffer.from(await new Response(proc.stderr).arrayBuffer());
-      const exitCode = await proc.exited;
+      const exitCode = await Promise.race([proc.exited, timeoutPromise]);
       return { exitCode, stdout, stderr };
     } finally {
       proc.kill();
@@ -39785,13 +39788,17 @@ var toolCheckers = {
         stderr: "pipe"
       });
       const timeout = setTimeout(() => proc.kill(), BUNX_TIMEOUT_MS);
-      const exitCode = await proc.exited;
-      clearTimeout(timeout);
-      return {
-        available: exitCode === 0,
-        checkedAt: new Date().toISOString(),
-        version: "bunx"
-      };
+      try {
+        const exitCode = await proc.exited;
+        return {
+          available: exitCode === 0,
+          checkedAt: new Date().toISOString(),
+          version: "bunx"
+        };
+      } finally {
+        clearTimeout(timeout);
+        proc.kill();
+      }
     } catch (e) {
       return {
         available: false,
@@ -39864,13 +39871,17 @@ var toolCheckers = {
         stderr: "pipe"
       });
       const timeout = setTimeout(() => proc.kill(), BUNX_TIMEOUT_MS);
-      const exitCode = await proc.exited;
-      clearTimeout(timeout);
-      return {
-        available: exitCode === 0,
-        checkedAt: new Date().toISOString(),
-        version: "bunx-semantic-memory"
-      };
+      try {
+        const exitCode = await proc.exited;
+        return {
+          available: exitCode === 0,
+          checkedAt: new Date().toISOString(),
+          version: "bunx-semantic-memory"
+        };
+      } finally {
+        clearTimeout(timeout);
+        proc.kill();
+      }
     } catch (e) {
       return {
         available: false,
@@ -40034,12 +40045,16 @@ async function runGitCommand(args) {
     stdout: "pipe",
     stderr: "pipe"
   });
-  const [stdout, stderr] = await Promise.all([
-    new Response(proc.stdout).text(),
-    new Response(proc.stderr).text()
-  ]);
-  const exitCode = await proc.exited;
-  return { exitCode, stdout, stderr };
+  try {
+    const [stdout, stderr] = await Promise.all([
+      new Response(proc.stdout).text(),
+      new Response(proc.stderr).text()
+    ]);
+    const exitCode = await proc.exited;
+    return { exitCode, stdout, stderr };
+  } finally {
+    proc.kill();
+  }
 }
 
 class HiveError extends Error {
@@ -40196,9 +40211,9 @@ var hive_create = tool({
   }
 });
 var hive_create_epic = tool({
-  description: "Create epic with subtasks in one atomic operation",
+  description: "Create epic with subtasks atomically. REQUIRED: epic_title, subtasks (array with {title, files?}). Use after swarm_validate_decomposition confirms your decomposition is valid. Each subtask should list files it will modify to enable parallel work without conflicts.",
   args: {
-    epic_title: tool.schema.string().describe("Epic title"),
+    epic_title: tool.schema.string().describe("Epic title (e.g., 'Implement user auth')"),
     epic_description: tool.schema.string().optional().describe("Epic description"),
     epic_id: tool.schema.string().optional().describe("Custom ID for the epic (e.g., 'phase-0')"),
     subtasks: tool.schema.array(tool.schema.object({
@@ -40217,6 +40232,28 @@ var hive_create_epic = tool({
     }).optional().describe("Recovery context from checkpoint compaction")
   },
   async execute(args, ctx) {
+    const missing = [];
+    if (!args.epic_title)
+      missing.push("epic_title");
+    if (!args.subtasks || args.subtasks.length === 0)
+      missing.push("subtasks (array of subtask objects)");
+    if (missing.length > 0) {
+      return JSON.stringify({
+        success: false,
+        error: `Missing required parameters: ${missing.join(", ")}`,
+        hint: "hive_create_epic creates an epic with subtasks atomically.",
+        example: {
+          epic_title: "Implement user authentication",
+          epic_description: "Add login, logout, and session management",
+          subtasks: [
+            { title: "Create auth service", files: ["src/auth/service.ts"] },
+            { title: "Add login endpoint", files: ["src/api/login.ts"] },
+            { title: "Add session middleware", files: ["src/middleware/session.ts"] }
+          ]
+        },
+        tip: "Each subtask should have a title and optionally files it will modify. This helps with file reservation and parallel execution."
+      }, null, 2);
+    }
     const validated = EpicCreateArgsSchema.parse(args);
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
@@ -42207,17 +42244,41 @@ var swarm_status = tool({
   }
 });
 var swarm_progress = tool({
-  description: "Report progress on a subtask to coordinator",
+  description: "Report progress on a subtask to coordinator. REQUIRED: project_key, agent_name, bead_id, status. Call periodically (every 25% or when blocked) to keep coordinator informed. Use status='blocked' with message explaining the blocker if you're stuck.",
   args: {
-    project_key: tool.schema.string().describe("Project path"),
-    agent_name: tool.schema.string().describe("Your Agent Mail name"),
-    bead_id: tool.schema.string().describe("Subtask bead ID"),
+    project_key: tool.schema.string().describe("Project path (e.g., '/Users/name/project')"),
+    agent_name: tool.schema.string().describe("Your agent name from swarmmail_init"),
+    bead_id: tool.schema.string().describe("Task ID from your spawn prompt or hive cell"),
     status: tool.schema.enum(["in_progress", "blocked", "completed", "failed"]).describe("Current status"),
     message: tool.schema.string().optional().describe("Progress message or blockers"),
     progress_percent: tool.schema.number().min(0).max(100).optional().describe("Completion percentage"),
     files_touched: tool.schema.array(tool.schema.string()).optional().describe("Files modified so far")
   },
   async execute(args) {
+    const missing = [];
+    if (!args.bead_id)
+      missing.push("bead_id");
+    if (!args.project_key)
+      missing.push("project_key");
+    if (!args.agent_name)
+      missing.push("agent_name");
+    if (!args.status)
+      missing.push("status");
+    if (missing.length > 0) {
+      return JSON.stringify({
+        success: false,
+        error: `Missing required parameters: ${missing.join(", ")}`,
+        hint: "swarm_progress reports task progress to the coordinator.",
+        example: {
+          project_key: "/path/to/project",
+          agent_name: "your-agent-name",
+          bead_id: "your-task-id from spawn",
+          status: "in_progress",
+          progress_percent: 50,
+          message: "Completed X, working on Y"
+        }
+      }, null, 2);
+    }
     const progress = {
       bead_id: args.bead_id,
       agent_name: args.agent_name,
@@ -42343,12 +42404,12 @@ ${args.files_affected.map((f) => `- \`${f}\``).join(`
   }
 });
 var swarm_complete = tool({
-  description: "Mark subtask complete with Verification Gate. Runs typecheck and tests before allowing completion.",
+  description: "Mark subtask complete with Verification Gate. REQUIRED: project_key, agent_name, bead_id (from your task assignment), summary, start_time (Date.now() from when you started). Before calling: 1) hivemind_store your learnings, 2) list files_touched for verification. Runs typecheck/tests before finalizing.",
   args: {
-    project_key: tool.schema.string().describe("Project path"),
-    agent_name: tool.schema.string().describe("Your Agent Mail name"),
-    bead_id: tool.schema.string().describe("Subtask bead ID"),
-    summary: tool.schema.string().describe("Brief summary of work done"),
+    project_key: tool.schema.string().describe("Project path (e.g., '/Users/name/project')"),
+    agent_name: tool.schema.string().describe("Your agent name from swarmmail_init"),
+    bead_id: tool.schema.string().describe("Task ID from your spawn prompt or hive cell"),
+    summary: tool.schema.string().describe("What you accomplished (1-3 sentences)"),
     evaluation: tool.schema.string().optional().describe("Self-evaluation JSON (Evaluation schema)"),
     files_touched: tool.schema.array(tool.schema.string()).optional().describe("Files modified - will be verified (typecheck, tests)"),
     skip_verification: tool.schema.boolean().optional().describe("Skip ALL verification (typecheck, tests). Use sparingly! (default: false)"),
@@ -42359,6 +42420,33 @@ var swarm_complete = tool({
     skip_review: tool.schema.boolean().optional().describe("Skip review gate check (default: false). Use only for tasks that don't require coordinator review.")
   },
   async execute(args, _ctx) {
+    const missing = [];
+    if (!args.bead_id)
+      missing.push("bead_id");
+    if (!args.project_key)
+      missing.push("project_key");
+    if (!args.agent_name)
+      missing.push("agent_name");
+    if (!args.summary)
+      missing.push("summary");
+    if (args.start_time === undefined)
+      missing.push("start_time");
+    if (missing.length > 0) {
+      return JSON.stringify({
+        success: false,
+        error: `Missing required parameters: ${missing.join(", ")}`,
+        hint: "swarm_complete marks a subtask as done. All parameters are required.",
+        example: {
+          project_key: "/path/to/project",
+          agent_name: "your-agent-name",
+          bead_id: "epic-id.subtask-num OR cell-id from hive",
+          summary: "Brief description of what you completed",
+          start_time: Date.now(),
+          files_touched: ["src/file1.ts", "src/file2.ts"]
+        },
+        tip: "The bead_id comes from swarm_spawn_subtask or hive_create. Check your task assignment for the correct ID."
+      }, null, 2);
+    }
     const epicId = args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id;
     if (!args.skip_review) {
       const reviewStatusResult = getReviewStatus(args.bead_id);
@@ -43746,6 +43834,26 @@ Before writing code:
 Begin work on your subtask now.`;
 var SUBTASK_PROMPT_V2 = `You are a swarm agent working on: **{subtask_title}**
 
+╔═══════════════════════════════════════════════════════════════════════════════╗
+║                                                                               ║
+║   \uD83D\uDED1  STOP - READ THIS FIRST - BEFORE ANY EDIT OR WRITE  \uD83D\uDED1                  ║
+║                                                                               ║
+║   You MUST do these 3 things BEFORE your first Edit/Write call:              ║
+║                                                                               ║
+║   1️⃣  hivemind_find(query="<your task keywords>", limit=5, expand=true)      ║
+║       → Check if past agents already solved this                              ║
+║       → Find gotchas, patterns, warnings                                      ║
+║                                                                               ║
+║   2️⃣  skills_list() then skills_use(name="<relevant>")                       ║
+║       → testing-patterns, swarm-coordination, system-design                   ║
+║                                                                               ║
+║   3️⃣  swarmmail_send(to=["coordinator"], ...) when blocked                   ║
+║       → Don't spin >5min - ASK FOR HELP                                       ║
+║                                                                               ║
+║   SKIPPING THESE = wasted time repeating solved problems                      ║
+║                                                                               ║
+╚═══════════════════════════════════════════════════════════════════════════════╝
+
 ## [IDENTITY]
 Agent: (assigned at spawn)
 Cell: {bead_id}

package/dist/tool-availability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../src/tool-availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAuRD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAWnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAC5C,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAChC,CA0BA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAQpD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAC5C,MAAM,CAWR"}
+{"version":3,"file":"tool-availability.d.ts","sourceRoot":"","sources":["../src/tool-availability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,MAAM,QAAQ,GAChB,iBAAiB,GACjB,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,YAAY,GACZ,YAAY,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA6RD;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAWnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,gBAAgB,CAAC,CAO3B;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAC5C,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAChC,CA0BA;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAQpD;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO/D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACxB,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAGrC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,GAC5C,MAAM,CAWR"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.57.6",
+  "version": "0.58.4",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",