opencode-swarm-plugin 0.13.1 → 0.14.0

package/.beads/issues.jsonl

@@ -1428,6 +1428,10 @@
 {"id":"opencode-swarm-plugin-qgd2n","title":"Update test bead","description":"Updated description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-13T11:16:36.35338-08:00","updated_at":"2025-12-13T11:16:40.1931-08:00","closed_at":"2025-12-13T11:16:40.1931-08:00"}
 {"id":"opencode-swarm-plugin-qgt38","title":"Document SubtaskSpec estimated_complexity scale","description":"src/schemas/bead.ts:106 - `estimated_complexity: z.number().int().min(1).max(5)` - scale meaning not documented. Add JSDoc: \"/** Complexity estimate (1=trivial, 5=very complex) */\"","status":"open","priority":3,"issue_type":"chore","created_at":"2025-12-10T09:06:10.789511-08:00","updated_at":"2025-12-10T09:06:10.789511-08:00"}
 {"id":"opencode-swarm-plugin-qhr0","title":"Cleanup task","description":"","status":"closed","priority":3,"issue_type":"chore","created_at":"2025-12-08T08:22:16.521307-08:00","updated_at":"2025-12-08T08:22:19.112363-08:00","closed_at":"2025-12-08T08:22:19.112363-08:00"}
+{"id":"opencode-swarm-plugin-qkscs","title":"Production Hardening: Logging, Cleanup, and N+1 Fixes","description":"Fix 3 production readiness gaps in Swarm Mail to improve reliability and debuggability","status":"open","priority":1,"issue_type":"epic","created_at":"2025-12-13T13:27:21.122378-08:00","updated_at":"2025-12-13T13:27:21.122378-08:00"}
+{"id":"opencode-swarm-plugin-qkscs.1","title":"Fix N+1 queries in store.ts message and reservation handlers","description":"","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-13T13:27:21.179002-08:00","updated_at":"2025-12-13T13:27:21.179002-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-qkscs.1","depends_on_id":"opencode-swarm-plugin-qkscs","type":"parent-child","created_at":"2025-12-13T13:27:21.180631-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-qkscs.2","title":"Implement expired reservation cleanup in projections.ts","description":"","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-13T13:27:21.234033-08:00","updated_at":"2025-12-13T13:27:21.234033-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-qkscs.2","depends_on_id":"opencode-swarm-plugin-qkscs","type":"parent-child","created_at":"2025-12-13T13:27:21.235438-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-qkscs.3","title":"Add structured logging for critical operations","description":"","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-13T13:27:21.287551-08:00","updated_at":"2025-12-13T13:27:21.287551-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-qkscs.3","depends_on_id":"opencode-swarm-plugin-qkscs","type":"parent-child","created_at":"2025-12-13T13:27:21.288503-08:00","created_by":"daemon"}]}
 {"id":"opencode-swarm-plugin-ql5z","title":"Test bug with priority","description":"This is a critical bug","status":"closed","priority":0,"issue_type":"bug","created_at":"2025-12-08T08:14:28.392972-08:00","updated_at":"2025-12-08T08:14:30.889299-08:00","closed_at":"2025-12-08T08:14:30.889299-08:00"}
 {"id":"opencode-swarm-plugin-qlrp","title":"Update test bead","description":"Updated description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:56:55.899992-08:00","updated_at":"2025-12-08T08:56:58.219456-08:00","closed_at":"2025-12-08T08:56:58.219456-08:00"}
 {"id":"opencode-swarm-plugin-qlzm","title":"Update test bead","description":"Updated description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T11:10:25.282262-08:00","updated_at":"2025-12-08T11:10:27.598379-08:00","closed_at":"2025-12-08T11:10:27.598379-08:00"}

package/dist/index.js

@@ -35192,7 +35192,6 @@ var SwarmPlugin = async (input) => {
   return {
     tool: {
       ...beadsTools,
-      ...agentMailTools,
       ...swarmMailTools,
       ...structuredTools,
       ...swarmTools,
@@ -35240,7 +35239,6 @@ var SwarmPlugin = async (input) => {
 var src_default = SwarmPlugin;
 var allTools = {
   ...beadsTools,
-  ...agentMailTools,
   ...swarmMailTools,
   ...structuredTools,
   ...swarmTools,

package/dist/plugin.js

@@ -31340,19 +31340,6 @@ var agentmail_restart = tool({
     }, null, 2);
   }
 });
-var agentMailTools = {
-  agentmail_init,
-  agentmail_send,
-  agentmail_inbox,
-  agentmail_read_message,
-  agentmail_summarize_thread,
-  agentmail_reserve,
-  agentmail_release,
-  agentmail_ack,
-  agentmail_search,
-  agentmail_health,
-  agentmail_restart
-};
 
 // src/swarm-mail.ts
 init_dist();
@@ -34723,7 +34710,6 @@ var SwarmPlugin = async (input) => {
   return {
     tool: {
       ...beadsTools,
-      ...agentMailTools,
       ...swarmMailTools,
       ...structuredTools,
       ...swarmTools,
@@ -34770,7 +34756,6 @@ var SwarmPlugin = async (input) => {
 };
 var allTools = {
   ...beadsTools,
-  ...agentMailTools,
   ...swarmMailTools,
   ...structuredTools,
   ...swarmTools,

package/examples/plugin-wrapper-template.ts

@@ -252,11 +252,11 @@ const beads_link_thread = tool({
 });
 
 // =============================================================================
-// Agent Mail Tools
+// Swarm Mail Tools (Embedded)
 // =============================================================================
 
-const agentmail_init = tool({
-  description: "Initialize Agent Mail session",
+const swarmmail_init = tool({
+  description: "Initialize Swarm Mail session (REQUIRED FIRST)",
   args: {
     project_path: tool.schema.string().describe("Absolute path to the project"),
     agent_name: tool.schema.string().optional().describe("Custom agent name"),
@@ -265,11 +265,11 @@ const agentmail_init = tool({
       .optional()
       .describe("Task description"),
   },
-  execute: (args, ctx) => execTool("agentmail_init", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_init", args, ctx),
 });
 
-const agentmail_send = tool({
-  description: "Send message to other agents",
+const swarmmail_send = tool({
+  description: "Send message to other agents via Swarm Mail",
   args: {
     to: tool.schema
       .array(tool.schema.string())
@@ -289,11 +289,11 @@ const agentmail_send = tool({
       .optional()
       .describe("Require acknowledgment"),
   },
-  execute: (args, ctx) => execTool("agentmail_send", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_send", args, ctx),
 });
 
-const agentmail_inbox = tool({
-  description: "Fetch inbox (CONTEXT-SAFE: bodies excluded, limit 5)",
+const swarmmail_inbox = tool({
+  description: "Fetch inbox (CONTEXT-SAFE: bodies excluded, max 5 messages)",
   args: {
     limit: tool.schema
       .number()
@@ -304,35 +304,19 @@ const agentmail_inbox = tool({
       .boolean()
       .optional()
       .describe("Only urgent messages"),
-    since_ts: tool.schema
-      .string()
-      .optional()
-      .describe("Messages since timestamp"),
   },
-  execute: (args, ctx) => execTool("agentmail_inbox", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_inbox", args, ctx),
 });
 
-const agentmail_read_message = tool({
+const swarmmail_read_message = tool({
   description: "Fetch ONE message body by ID",
   args: {
     message_id: tool.schema.number().describe("Message ID"),
   },
-  execute: (args, ctx) => execTool("agentmail_read_message", args, ctx),
-});
-
-const agentmail_summarize_thread = tool({
-  description: "Summarize thread (PREFERRED over fetching all messages)",
-  args: {
-    thread_id: tool.schema.string().describe("Thread ID"),
-    include_examples: tool.schema
-      .boolean()
-      .optional()
-      .describe("Include example messages"),
-  },
-  execute: (args, ctx) => execTool("agentmail_summarize_thread", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_read_message", args, ctx),
 });
 
-const agentmail_reserve = tool({
+const swarmmail_reserve = tool({
   description: "Reserve file paths for exclusive editing",
   args: {
     paths: tool.schema
@@ -342,10 +326,10 @@ const agentmail_reserve = tool({
     exclusive: tool.schema.boolean().optional().describe("Exclusive lock"),
     reason: tool.schema.string().optional().describe("Reservation reason"),
   },
-  execute: (args, ctx) => execTool("agentmail_reserve", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_reserve", args, ctx),
 });
 
-const agentmail_release = tool({
+const swarmmail_release = tool({
   description: "Release file reservations",
   args: {
     paths: tool.schema
@@ -357,30 +341,21 @@ const agentmail_release = tool({
       .optional()
       .describe("Reservation IDs"),
   },
-  execute: (args, ctx) => execTool("agentmail_release", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_release", args, ctx),
 });
 
-const agentmail_ack = tool({
+const swarmmail_ack = tool({
   description: "Acknowledge a message",
   args: {
     message_id: tool.schema.number().describe("Message ID"),
   },
-  execute: (args, ctx) => execTool("agentmail_ack", args, ctx),
-});
-
-const agentmail_search = tool({
-  description: "Search messages by keyword",
-  args: {
-    query: tool.schema.string().describe("Search query"),
-    limit: tool.schema.number().optional().describe("Max results"),
-  },
-  execute: (args, ctx) => execTool("agentmail_search", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_ack", args, ctx),
 });
 
-const agentmail_health = tool({
-  description: "Check if Agent Mail server is running",
+const swarmmail_health = tool({
+  description: "Check Swarm Mail database health",
   args: {},
-  execute: (args, ctx) => execTool("agentmail_health", args, ctx),
+  execute: (args, ctx) => execTool("swarmmail_health", args, ctx),
 });
 
 // =============================================================================
@@ -794,17 +769,15 @@ export const SwarmPlugin: Plugin = async (
       beads_ready,
       beads_sync,
       beads_link_thread,
-      // Agent Mail
-      agentmail_init,
-      agentmail_send,
-      agentmail_inbox,
-      agentmail_read_message,
-      agentmail_summarize_thread,
-      agentmail_reserve,
-      agentmail_release,
-      agentmail_ack,
-      agentmail_search,
-      agentmail_health,
+      // Swarm Mail (Embedded)
+      swarmmail_init,
+      swarmmail_send,
+      swarmmail_inbox,
+      swarmmail_read_message,
+      swarmmail_reserve,
+      swarmmail_release,
+      swarmmail_ack,
+      swarmmail_health,
       // Structured
       structured_extract_json,
       structured_validate,

package/package.json

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

package/src/index.ts

@@ -135,7 +135,6 @@ export const SwarmPlugin: Plugin = async (
      */
     tool: {
       ...beadsTools,
-      ...agentMailTools,
       ...swarmMailTools,
       ...structuredTools,
       ...swarmTools,
@@ -357,7 +356,6 @@ export {
  */
 export const allTools = {
   ...beadsTools,
-  ...agentMailTools,
   ...swarmMailTools,
   ...structuredTools,
   ...swarmTools,