opencode-swarm-plugin 0.28.0 → 0.28.2

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 200 modules in 32ms
+Bundled 200 modules in 35ms
 
   index.js  1.20 MB  (entry point)
 
-Bundled 201 modules in 31ms
+Bundled 201 modules in 32ms
 
   plugin.js  1.16 MB  (entry point)
 

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # opencode-swarm-plugin
 
+## 0.28.2
+
+### Patch Changes
+
+- Updated dependencies [[`90409ef`](https://github.com/joelhooks/swarm-tools/commit/90409ef4f353844b25fe04221bc80d6f930eced2)]:
+  - swarm-mail@0.3.4
+
+## 0.28.1
+
+### Patch Changes
+
+- [`0ee4f65`](https://github.com/joelhooks/swarm-tools/commit/0ee4f656c2fb2cf62d3ef06d329d9e093d124c33) Thanks [@joelhooks](https://github.com/joelhooks)! - Add postinstall hint and update repo URL
+
+  - Show "Run swarm setup" hint after npm install
+  - Update repo URL to github.com/joelhooks/swarm-tools
+  - Add "Get started" commands to version output
+
 ## 0.28.0
 
 ### Minor Changes

package/bin/swarm.ts

@@ -1966,7 +1966,11 @@ async function version() {
   console.log(dim("  " + TAGLINE));
   console.log();
   console.log("  Version: " + VERSION);
-  console.log("  Docs:    https://github.com/joelhooks/opencode-swarm-plugin");
+  console.log("  Docs:    https://github.com/joelhooks/swarm-tools");
+  console.log();
+  console.log(cyan("  Get started:"));
+  console.log("    swarm setup    " + dim("Configure OpenCode integration"));
+  console.log("    swarm doctor   " + dim("Check dependencies"));
   console.log();
 
   // Check for updates (non-blocking)

package/dist/hive.d.ts

@@ -301,11 +301,11 @@ export declare const hive_sync: {
 export declare const hive_link_thread: {
     description: string;
     args: {
-        cell_id: z.ZodString;
+        bead_id: z.ZodString;
         thread_id: z.ZodString;
     };
     execute(args: {
-        cell_id: string;
+        bead_id: string;
         thread_id: string;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
@@ -461,11 +461,11 @@ export declare const hiveTools: {
     hive_link_thread: {
         description: string;
         args: {
-            cell_id: z.ZodString;
+            bead_id: z.ZodString;
             thread_id: z.ZodString;
         };
         execute(args: {
-            cell_id: string;
+            bead_id: string;
             thread_id: string;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };
@@ -648,11 +648,11 @@ export declare const beads_sync: {
 export declare const beads_link_thread: {
     description: string;
     args: {
-        cell_id: z.ZodString;
+        bead_id: z.ZodString;
         thread_id: z.ZodString;
     };
     execute(args: {
-        cell_id: string;
+        bead_id: string;
         thread_id: string;
     }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
 };
@@ -811,11 +811,11 @@ export declare const beadsTools: {
     beads_link_thread: {
         description: string;
         args: {
-            cell_id: z.ZodString;
+            bead_id: z.ZodString;
             thread_id: z.ZodString;
         };
         execute(args: {
-            cell_id: string;
+            bead_id: string;
             thread_id: string;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };

package/dist/index.d.ts

@@ -1287,11 +1287,11 @@ export declare const allTools: {
     readonly hive_link_thread: {
         description: string;
         args: {
-            cell_id: import("zod").ZodString;
+            bead_id: import("zod").ZodString;
             thread_id: import("zod").ZodString;
         };
         execute(args: {
-            cell_id: string;
+            bead_id: string;
             thread_id: string;
         }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
     };

package/dist/index.js

@@ -28258,30 +28258,30 @@ var hive_sync = tool({
 var hive_link_thread = tool({
   description: "Add metadata linking cell to Agent Mail thread",
   args: {
-    cell_id: tool.schema.string().describe("Cell ID"),
+    bead_id: tool.schema.string().describe("Cell ID"),
     thread_id: tool.schema.string().describe("Agent Mail thread ID")
   },
   async execute(args, ctx) {
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
     try {
-      const cell = await adapter.getCell(projectKey, args.cell_id);
+      const cell = await adapter.getCell(projectKey, args.bead_id);
       if (!cell) {
-        throw new HiveError(`Cell not found: ${args.cell_id}`, "hive_link_thread");
+        throw new HiveError(`Cell not found: ${args.bead_id}`, "hive_link_thread");
       }
       const existingDesc = cell.description || "";
       const threadMarker = `[thread:${args.thread_id}]`;
       if (existingDesc.includes(threadMarker)) {
-        return `Cell ${args.cell_id} already linked to thread ${args.thread_id}`;
+        return `Cell ${args.bead_id} already linked to thread ${args.thread_id}`;
       }
       const newDesc = existingDesc ? `${existingDesc}
 
 ${threadMarker}` : threadMarker;
-      await adapter.updateCell(projectKey, args.cell_id, {
+      await adapter.updateCell(projectKey, args.bead_id, {
         description: newDesc
       });
-      await adapter.markDirty(projectKey, args.cell_id);
-      return `Linked cell ${args.cell_id} to thread ${args.thread_id}`;
+      await adapter.markDirty(projectKey, args.bead_id);
+      return `Linked cell ${args.bead_id} to thread ${args.thread_id}`;
     } catch (error45) {
       const message = error45 instanceof Error ? error45.message : String(error45);
       throw new HiveError(`Failed to link thread: ${message}`, "hive_link_thread");

package/dist/plugin.js

@@ -28015,30 +28015,30 @@ var hive_sync = tool({
 var hive_link_thread = tool({
   description: "Add metadata linking cell to Agent Mail thread",
   args: {
-    cell_id: tool.schema.string().describe("Cell ID"),
+    bead_id: tool.schema.string().describe("Cell ID"),
     thread_id: tool.schema.string().describe("Agent Mail thread ID")
   },
   async execute(args, ctx) {
     const projectKey = getHiveWorkingDirectory();
     const adapter = await getHiveAdapter(projectKey);
     try {
-      const cell = await adapter.getCell(projectKey, args.cell_id);
+      const cell = await adapter.getCell(projectKey, args.bead_id);
       if (!cell) {
-        throw new HiveError(`Cell not found: ${args.cell_id}`, "hive_link_thread");
+        throw new HiveError(`Cell not found: ${args.bead_id}`, "hive_link_thread");
       }
       const existingDesc = cell.description || "";
       const threadMarker = `[thread:${args.thread_id}]`;
       if (existingDesc.includes(threadMarker)) {
-        return `Cell ${args.cell_id} already linked to thread ${args.thread_id}`;
+        return `Cell ${args.bead_id} already linked to thread ${args.thread_id}`;
       }
       const newDesc = existingDesc ? `${existingDesc}
 
 ${threadMarker}` : threadMarker;
-      await adapter.updateCell(projectKey, args.cell_id, {
+      await adapter.updateCell(projectKey, args.bead_id, {
         description: newDesc
       });
-      await adapter.markDirty(projectKey, args.cell_id);
-      return `Linked cell ${args.cell_id} to thread ${args.thread_id}`;
+      await adapter.markDirty(projectKey, args.bead_id);
+      return `Linked cell ${args.bead_id} to thread ${args.thread_id}`;
     } catch (error45) {
       const message = error45 instanceof Error ? error45.message : String(error45);
       throw new HiveError(`Failed to link thread: ${message}`, "hive_link_thread");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-swarm-plugin",
-  "version": "0.28.0",
+  "version": "0.28.2",
   "description": "Multi-agent swarm coordination for OpenCode with learning capabilities, beads integration, and Agent Mail",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,14 +26,15 @@
     "test:all": "bun test --timeout 60000 src/",
     "test:watch": "bun test --watch src/",
     "typecheck": "tsc --noEmit",
-    "publish:pkg": "npm publish --access public --provenance"
+    "publish:pkg": "npm publish --access public --provenance",
+    "postinstall": "node -e \"console.log('\\n\\x1b[33m  Run \\x1b[36mswarm setup\\x1b[33m to configure OpenCode integration\\x1b[0m\\n')\""
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
     "@opencode-ai/plugin": "^1.0.134",
     "gray-matter": "^4.0.3",
     "ioredis": "^5.4.1",
-    "swarm-mail": "0.3.3",
+    "swarm-mail": "0.3.4",
     "zod": "4.1.8"
   },
   "devDependencies": {
@@ -65,6 +66,6 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/joelhooks/opencode-swarm-plugin"
+    "url": "https://github.com/joelhooks/swarm-tools"
   }
 }

package/src/hive.integration.test.ts

@@ -521,7 +521,7 @@ describe("beads integration", () => {
     it("links a bead to an Agent Mail thread", async () => {
       const threadId = "test-thread-123";
       const result = await beads_link_thread.execute(
-        { cell_id: testBeadId, thread_id: threadId },
+        { bead_id: testBeadId, thread_id: threadId },
         mockContext,
       );
 
@@ -540,13 +540,13 @@ describe("beads integration", () => {
 
       // Link once
       await beads_link_thread.execute(
-        { cell_id: testBeadId, thread_id: threadId },
+        { bead_id: testBeadId, thread_id: threadId },
         mockContext,
       );
 
       // Try to link again
       const result = await beads_link_thread.execute(
-        { cell_id: testBeadId, thread_id: threadId },
+        { bead_id: testBeadId, thread_id: threadId },
         mockContext,
       );
 
@@ -562,7 +562,7 @@ describe("beads integration", () => {
 
       const threadId = "test-thread-789";
       await beads_link_thread.execute(
-        { cell_id: testBeadId, thread_id: threadId },
+        { bead_id: testBeadId, thread_id: threadId },
         mockContext,
       );
 
@@ -576,7 +576,7 @@ describe("beads integration", () => {
     it("throws BeadError for invalid bead ID", async () => {
       await expect(
         beads_link_thread.execute(
-          { cell_id: "nonexistent-bead-xyz", thread_id: "thread-123" },
+          { bead_id: "nonexistent-bead-xyz", thread_id: "thread-123" },
           mockContext,
         ),
       ).rejects.toThrow(BeadError);

package/src/hive.ts

@@ -1094,7 +1094,7 @@ export const hive_sync = tool({
 export const hive_link_thread = tool({
   description: "Add metadata linking cell to Agent Mail thread",
   args: {
-    cell_id: tool.schema.string().describe("Cell ID"),
+    bead_id: tool.schema.string().describe("Cell ID"),
     thread_id: tool.schema.string().describe("Agent Mail thread ID"),
   },
   async execute(args, ctx) {
@@ -1102,11 +1102,11 @@ export const hive_link_thread = tool({
     const adapter = await getHiveAdapter(projectKey);
 
     try {
-      const cell = await adapter.getCell(projectKey, args.cell_id);
+      const cell = await adapter.getCell(projectKey, args.bead_id);
 
       if (!cell) {
         throw new HiveError(
-          `Cell not found: ${args.cell_id}`,
+          `Cell not found: ${args.bead_id}`,
           "hive_link_thread",
         );
       }
@@ -1115,20 +1115,20 @@ export const hive_link_thread = tool({
       const threadMarker = `[thread:${args.thread_id}]`;
 
       if (existingDesc.includes(threadMarker)) {
-        return `Cell ${args.cell_id} already linked to thread ${args.thread_id}`;
+        return `Cell ${args.bead_id} already linked to thread ${args.thread_id}`;
       }
 
       const newDesc = existingDesc
         ? `${existingDesc}\n\n${threadMarker}`
         : threadMarker;
 
-      await adapter.updateCell(projectKey, args.cell_id, {
+      await adapter.updateCell(projectKey, args.bead_id, {
         description: newDesc,
       });
 
-      await adapter.markDirty(projectKey, args.cell_id);
+      await adapter.markDirty(projectKey, args.bead_id);
 
-      return `Linked cell ${args.cell_id} to thread ${args.thread_id}`;
+      return `Linked cell ${args.bead_id} to thread ${args.thread_id}`;
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       throw new HiveError(