opencode-swarm-plugin 0.23.4 → 0.23.6

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 $ bun build ./src/index.ts --outdir ./dist --target node --external @electric-sql/pglite --external swarm-mail && bun build ./src/plugin.ts --outfile ./dist/plugin.js --target node --external @electric-sql/pglite --external swarm-mail && tsc
-Bundled 195 modules in 33ms
+Bundled 195 modules in 36ms
 
   index.js  1.14 MB  (entry point)
 
-Bundled 196 modules in 31ms
+Bundled 196 modules in 34ms
 
   plugin.js  1.12 MB  (entry point)
 

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # opencode-swarm-plugin
 
+## 0.23.6
+
+### Patch Changes
+
+- Updated dependencies [[`22befbf`](https://github.com/joelhooks/opencode-swarm-plugin/commit/22befbfa120a37a585cfec0709597172efda92a4)]:
+  - swarm-mail@0.1.3
+
+## 0.23.5
+
+### Patch Changes
+
+- [`3826c6d`](https://github.com/joelhooks/opencode-swarm-plugin/commit/3826c6d887f937ccb201b7c4322cbc7b46823658) Thanks [@joelhooks](https://github.com/joelhooks)! - Fix workspace:\* resolution by running bun install before pack
+
+  The lockfile was stale, causing bun pack to resolve workspace:\* to old versions.
+  Now runs bun install first to ensure lockfile matches current package.json versions.
+
 ## 0.23.4
 
 ### Patch Changes

package/dist/index.js

@@ -12675,7 +12675,7 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@opencode-ai+plugin@1.0.134/node_modules/@opencode-ai/plugin/dist/tool.js
+// ../../node_modules/.bun/@opencode-ai+plugin@1.0.153/node_modules/@opencode-ai/plugin/dist/tool.js
 function tool(input) {
   return input;
 }
@@ -12684,7 +12684,7 @@ var init_tool = __esm(() => {
   tool.schema = exports_external;
 });
 
-// ../../node_modules/.bun/@opencode-ai+plugin@1.0.134/node_modules/@opencode-ai/plugin/dist/index.js
+// ../../node_modules/.bun/@opencode-ai+plugin@1.0.153/node_modules/@opencode-ai/plugin/dist/index.js
 var init_dist = __esm(() => {
   init_tool();
 });
@@ -31853,7 +31853,23 @@ Continuing with completion, but this should be fixed for future subtasks.`;
       }
       const closeResult = await Bun.$`bd close ${args.bead_id} --reason ${args.summary} --json`.quiet().nothrow();
       if (closeResult.exitCode !== 0) {
-        throw new Error(`Failed to close bead because bd close command failed: ${closeResult.stderr.toString()}. Try: Verify bead exists and is not already closed with 'bd show ${args.bead_id}', check if bead ID is correct with 'beads_query()', or use beads_close tool directly.`);
+        const stderrOutput = closeResult.stderr.toString().trim();
+        return JSON.stringify({
+          success: false,
+          error: "Failed to close bead",
+          failed_step: "bd close",
+          details: stderrOutput || "Unknown error from bd close command",
+          bead_id: args.bead_id,
+          recovery: {
+            steps: [
+              `1. Check bead exists: bd show ${args.bead_id}`,
+              `2. Check bead status (might already be closed): beads_query()`,
+              `3. If bead is blocked, unblock first: beads_update(id="${args.bead_id}", status="in_progress")`,
+              `4. Try closing directly: beads_close(id="${args.bead_id}", reason="...")`
+            ],
+            hint: "If bead is in 'blocked' status, you must change it to 'in_progress' or 'open' before closing."
+          }
+        }, null, 2);
       }
       try {
         const epicId3 = args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id;
@@ -32026,6 +32042,7 @@ ${errorStack.slice(0, 1000)}
         "4. Retry swarm_complete after fixing"
       ].filter(Boolean).join(`
 `);
+      let notificationSent = false;
       try {
         await sendSwarmMessage2({
           projectPath: args.project_key,
@@ -32036,11 +32053,40 @@ ${errorStack.slice(0, 1000)}
           threadId: epicId,
           importance: "urgent"
         });
+        notificationSent = true;
       } catch (mailError) {
         console.error(`[swarm_complete] CRITICAL: Failed to notify coordinator of failure for ${args.bead_id}:`, mailError);
         console.error(`[swarm_complete] Original error:`, error45);
       }
-      throw error45;
+      return JSON.stringify({
+        success: false,
+        error: errorMessage,
+        failed_step: failedStep,
+        bead_id: args.bead_id,
+        agent_name: args.agent_name,
+        coordinator_notified: notificationSent,
+        stack_trace: errorStack?.slice(0, 500),
+        context: {
+          summary: args.summary,
+          files_touched: args.files_touched || [],
+          skip_ubs_scan: args.skip_ubs_scan ?? false,
+          skip_verification: args.skip_verification ?? false
+        },
+        recovery: {
+          steps: [
+            "1. Check the error message above for specific issue",
+            `2. Review failed step: ${failedStep}`,
+            "3. Fix underlying issue or use skip flags if appropriate",
+            "4. Retry swarm_complete after fixing"
+          ],
+          common_fixes: {
+            "Verification Gate": "Use skip_verification=true to bypass (not recommended)",
+            "UBS scan": "Use skip_ubs_scan=true to bypass",
+            "Bead close": "Check bead status with beads_query(), may need beads_update() first",
+            "Self-evaluation": "Check evaluation JSON format matches EvaluationSchema"
+          }
+        }
+      }, null, 2);
     }
   }
 });

package/dist/plugin.js

@@ -12675,7 +12675,7 @@ var init_zod = __esm(() => {
   init_external();
 });
 
-// ../../node_modules/.bun/@opencode-ai+plugin@1.0.134/node_modules/@opencode-ai/plugin/dist/tool.js
+// ../../node_modules/.bun/@opencode-ai+plugin@1.0.153/node_modules/@opencode-ai/plugin/dist/tool.js
 function tool(input) {
   return input;
 }
@@ -12684,7 +12684,7 @@ var init_tool = __esm(() => {
   tool.schema = exports_external;
 });
 
-// ../../node_modules/.bun/@opencode-ai+plugin@1.0.134/node_modules/@opencode-ai/plugin/dist/index.js
+// ../../node_modules/.bun/@opencode-ai+plugin@1.0.153/node_modules/@opencode-ai/plugin/dist/index.js
 var init_dist = __esm(() => {
   init_tool();
 });
@@ -31689,7 +31689,23 @@ Continuing with completion, but this should be fixed for future subtasks.`;
       }
       const closeResult = await Bun.$`bd close ${args.bead_id} --reason ${args.summary} --json`.quiet().nothrow();
       if (closeResult.exitCode !== 0) {
-        throw new Error(`Failed to close bead because bd close command failed: ${closeResult.stderr.toString()}. Try: Verify bead exists and is not already closed with 'bd show ${args.bead_id}', check if bead ID is correct with 'beads_query()', or use beads_close tool directly.`);
+        const stderrOutput = closeResult.stderr.toString().trim();
+        return JSON.stringify({
+          success: false,
+          error: "Failed to close bead",
+          failed_step: "bd close",
+          details: stderrOutput || "Unknown error from bd close command",
+          bead_id: args.bead_id,
+          recovery: {
+            steps: [
+              `1. Check bead exists: bd show ${args.bead_id}`,
+              `2. Check bead status (might already be closed): beads_query()`,
+              `3. If bead is blocked, unblock first: beads_update(id="${args.bead_id}", status="in_progress")`,
+              `4. Try closing directly: beads_close(id="${args.bead_id}", reason="...")`
+            ],
+            hint: "If bead is in 'blocked' status, you must change it to 'in_progress' or 'open' before closing."
+          }
+        }, null, 2);
       }
       try {
         const epicId3 = args.bead_id.includes(".") ? args.bead_id.split(".")[0] : args.bead_id;
@@ -31862,6 +31878,7 @@ ${errorStack.slice(0, 1000)}
         "4. Retry swarm_complete after fixing"
       ].filter(Boolean).join(`
 `);
+      let notificationSent = false;
       try {
         await sendSwarmMessage2({
           projectPath: args.project_key,
@@ -31872,11 +31889,40 @@ ${errorStack.slice(0, 1000)}
           threadId: epicId,
           importance: "urgent"
         });
+        notificationSent = true;
       } catch (mailError) {
         console.error(`[swarm_complete] CRITICAL: Failed to notify coordinator of failure for ${args.bead_id}:`, mailError);
         console.error(`[swarm_complete] Original error:`, error45);
       }
-      throw error45;
+      return JSON.stringify({
+        success: false,
+        error: errorMessage,
+        failed_step: failedStep,
+        bead_id: args.bead_id,
+        agent_name: args.agent_name,
+        coordinator_notified: notificationSent,
+        stack_trace: errorStack?.slice(0, 500),
+        context: {
+          summary: args.summary,
+          files_touched: args.files_touched || [],
+          skip_ubs_scan: args.skip_ubs_scan ?? false,
+          skip_verification: args.skip_verification ?? false
+        },
+        recovery: {
+          steps: [
+            "1. Check the error message above for specific issue",
+            `2. Review failed step: ${failedStep}`,
+            "3. Fix underlying issue or use skip flags if appropriate",
+            "4. Retry swarm_complete after fixing"
+          ],
+          common_fixes: {
+            "Verification Gate": "Use skip_verification=true to bypass (not recommended)",
+            "UBS scan": "Use skip_ubs_scan=true to bypass",
+            "Bead close": "Check bead status with beads_query(), may need beads_update() first",
+            "Self-evaluation": "Check evaluation JSON format matches EvaluationSchema"
+          }
+        }
+      }, null, 2);
     }
   }
 });

package/dist/swarm-orchestrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swarm-orchestrate.d.ts","sourceRoot":"","sources":["../src/swarm-orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgiBxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;CAuGrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAoFvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAoIzB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CA6E1B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ezB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJ/B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;CA6CjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;CAmClC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAmB9B,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;CAoJ9B,CAAC;AA4BH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyH3B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;CAgGxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgMtB,CAAC;AAMH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAc5B,CAAC"}
+{"version":3,"file":"swarm-orchestrate.d.ts","sourceRoot":"","sources":["../src/swarm-orchestrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgiBxB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;;;;;;;;CAuGrB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;CAoFvB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAoIzB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;CA6E1B,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiiBzB,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkJ/B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;CA6CjC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;CAmClC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;CAmB9B,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;CAoJ9B,CAAC;AA4BH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyH3B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;CAgGxB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgMtB,CAAC;AAMH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAc5B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.23.4",
+  "version": "0.23.6",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,7 +33,7 @@
     "@opencode-ai/plugin": "^1.0.134",
     "gray-matter": "^4.0.3",
     "ioredis": "^5.4.1",
-    "swarm-mail": "0.1.0",
+    "swarm-mail": "0.1.3",
     "zod": "4.1.8"
   },
   "devDependencies": {

package/src/swarm-orchestrate.ts

@@ -1218,8 +1218,26 @@ Continuing with completion, but this should be fixed for future subtasks.`;
           .nothrow();
 
       if (closeResult.exitCode !== 0) {
-        throw new Error(
-          `Failed to close bead because bd close command failed: ${closeResult.stderr.toString()}. Try: Verify bead exists and is not already closed with 'bd show ${args.bead_id}', check if bead ID is correct with 'beads_query()', or use beads_close tool directly.`,
+        const stderrOutput = closeResult.stderr.toString().trim();
+        return JSON.stringify(
+          {
+            success: false,
+            error: "Failed to close bead",
+            failed_step: "bd close",
+            details: stderrOutput || "Unknown error from bd close command",
+            bead_id: args.bead_id,
+            recovery: {
+              steps: [
+                `1. Check bead exists: bd show ${args.bead_id}`,
+                `2. Check bead status (might already be closed): beads_query()`,
+                `3. If bead is blocked, unblock first: beads_update(id="${args.bead_id}", status="in_progress")`,
+                `4. Try closing directly: beads_close(id="${args.bead_id}", reason="...")`,
+              ],
+              hint: "If bead is in 'blocked' status, you must change it to 'in_progress' or 'open' before closing.",
+            },
+          },
+          null,
+          2,
         );
       }
 
@@ -1479,6 +1497,7 @@ Files touched: ${args.files_touched?.join(", ") || "none recorded"}`,
         .join("\n");
 
       // Send urgent notification to coordinator
+      let notificationSent = false;
       try {
         await sendSwarmMessage({
           projectPath: args.project_key,
@@ -1489,6 +1508,7 @@ Files touched: ${args.files_touched?.join(", ") || "none recorded"}`,
           threadId: epicId,
           importance: "urgent",
         });
+        notificationSent = true;
       } catch (mailError) {
         // Even swarm mail failed - log to console as last resort
         console.error(
@@ -1498,8 +1518,41 @@ Files touched: ${args.files_touched?.join(", ") || "none recorded"}`,
         console.error(`[swarm_complete] Original error:`, error);
       }
 
-      // Re-throw the original error after notifying
-      throw error;
+      // Return structured error instead of throwing
+      // This ensures the agent sees the actual error message
+      return JSON.stringify(
+        {
+          success: false,
+          error: errorMessage,
+          failed_step: failedStep,
+          bead_id: args.bead_id,
+          agent_name: args.agent_name,
+          coordinator_notified: notificationSent,
+          stack_trace: errorStack?.slice(0, 500),
+          context: {
+            summary: args.summary,
+            files_touched: args.files_touched || [],
+            skip_ubs_scan: args.skip_ubs_scan ?? false,
+            skip_verification: args.skip_verification ?? false,
+          },
+          recovery: {
+            steps: [
+              "1. Check the error message above for specific issue",
+              `2. Review failed step: ${failedStep}`,
+              "3. Fix underlying issue or use skip flags if appropriate",
+              "4. Retry swarm_complete after fixing",
+            ],
+            common_fixes: {
+              "Verification Gate": "Use skip_verification=true to bypass (not recommended)",
+              "UBS scan": "Use skip_ubs_scan=true to bypass",
+              "Bead close": "Check bead status with beads_query(), may need beads_update() first",
+              "Self-evaluation": "Check evaluation JSON format matches EvaluationSchema",
+            },
+          },
+        },
+        null,
+        2,
+      );
     }
   },
 });