opencode-swarm-plugin 0.9.0 → 0.10.0

package/README.md

@@ -3,7 +3,21 @@
 [![npm version](https://img.shields.io/npm/v/opencode-swarm-plugin.svg)](https://www.npmjs.com/package/opencode-swarm-plugin)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Multi-agent swarm coordination for [OpenCode](https://opencode.ai). Break complex tasks into parallel subtasks, spawn agents, coordinate via messaging. The plugin learns from outcomes to improve future decompositions.
+```
+ ███████╗██╗    ██╗ █████╗ ██████╗ ███╗   ███╗
+ ██╔════╝██║    ██║██╔══██╗██╔══██╗████╗ ████║
+ ███████╗██║ █╗ ██║███████║██████╔╝██╔████╔██║
+ ╚════██║██║███╗██║██╔══██║██╔══██╗██║╚██╔╝██║
+ ███████║╚███╔███╔╝██║  ██║██║  ██║██║ ╚═╝ ██║
+ ╚══════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝
+
+    \ ` - ' /
+   - .(o o). -
+    (  >.<  )        Multi-agent coordination for OpenCode
+     /|   |\         Break complex tasks into parallel subtasks,
+    (_|   |_)        spawn agents, coordinate via messaging.
+      bzzzz...       The plugin learns from outcomes.
+```
 
 ## Install
 
@@ -12,10 +26,10 @@ npm install -g opencode-swarm-plugin
 swarm setup
 ```
 
-That's it. The setup wizard handles everything:
+The setup wizard handles everything:
 
 ```
-┌  opencode-swarm-plugin v0.9.0
+┌  opencode-swarm-plugin v0.10.0
 │
 ◇  Checking dependencies...
 │
@@ -51,72 +65,138 @@ swarm init
 swarm setup     Interactive installer - checks and installs all dependencies
 swarm doctor    Health check - shows status of all dependencies
 swarm init      Initialize beads in current project
-swarm version   Show version
+swarm config    Show paths to generated config files
+swarm version   Show version and banner
 swarm help      Show help
 ```
 
-### swarm doctor
+## Usage
+
+In OpenCode:
 
 ```
-┌  swarm doctor v0.9.0
-│
-◇  Required dependencies:
-│
-◆  OpenCode v1.0.134
-◆  Beads v0.29.0
-│
-◇  Optional dependencies:
-│
-◆  Go v1.25.2 - Required for Agent Mail
-▲  Agent Mail - not found
-◆  Redis - Rate limiting
-│
-└  All required dependencies installed. 1 optional missing.
+/swarm "Add user authentication with OAuth"
 ```
 
-### swarm init
+Or invoke the planner directly:
 
 ```
-┌  swarm init v0.9.0
-│
-◇  Initializing beads...
-◆  Created .beads/ directory
-│
-◆  Create your first bead?
-│  ● Yes / ○ No
-│
-◇  Bead title: Implement user authentication
-◇  Type: Feature
-│
-└  Project initialized!
+@swarm-planner "Refactor all components to use hooks"
 ```
 
-## Usage
+## Customization
 
-In OpenCode:
+Run `swarm config` to see your config file paths:
 
 ```
-/swarm "Add user authentication with OAuth"
+🔌 Plugin loader
+   ~/.config/opencode/plugins/swarm.ts
+
+📜 /swarm command prompt
+   ~/.config/opencode/commands/swarm.md
+
+🤖 @swarm-planner agent
+   ~/.config/opencode/agents/swarm-planner.md
 ```
 
-Or invoke the planner directly:
+### /swarm Command
+
+The `/swarm` command is defined in `~/.config/opencode/commands/swarm.md`:
+
+```markdown
+---
+description: Decompose task into parallel subtasks and coordinate agents
+---
+
+You are a swarm coordinator. Take a complex task, break it into beads,
+and unleash parallel agents.
+
+## Usage
+
+/swarm <task description or bead-id>
+
+## Workflow
 
+1. **Initialize**: `agentmail_init` with project_path and task_description
+2. **Decompose**: Use `swarm_select_strategy` then `swarm_plan_prompt`
+3. **Create beads**: `beads_create_epic` with subtasks and file assignments
+4. **Reserve files**: `agentmail_reserve` for each subtask's files
+5. **Spawn agents**: Use Task tool with `swarm_spawn_subtask` prompts
+6. **Monitor**: Check `agentmail_inbox` for progress
+7. **Complete**: `swarm_complete` when done, then `beads_sync` to push
+
+## Strategy Selection
+
+| Strategy      | Best For                | Keywords                              |
+| ------------- | ----------------------- | ------------------------------------- |
+| file-based    | Refactoring, migrations | refactor, migrate, rename, update all |
+| feature-based | New features            | add, implement, build, create         |
+| risk-based    | Bug fixes, security     | fix, bug, security, critical, urgent  |
+
+Begin decomposition now.
 ```
-@swarm-planner "Refactor all components to use hooks"
+
+### @swarm-planner Agent
+
+The `@swarm-planner` agent is defined in `~/.config/opencode/agents/swarm-planner.md`:
+
+````markdown
+---
+name: swarm-planner
+description: Strategic task decomposition for swarm coordination
+model: claude-sonnet-4-5
+---
+
+You are a swarm planner. Decompose tasks into optimal parallel subtasks.
+
+## Workflow
+
+1. Call `swarm_select_strategy` to analyze the task
+2. Call `swarm_plan_prompt` to get strategy-specific guidance
+3. Create a BeadTree following the guidelines
+4. Return ONLY valid JSON - no markdown, no explanation
+
+## Output Format
+
+```json
+{
+  "epic": { "title": "...", "description": "..." },
+  "subtasks": [
+    {
+      "title": "...",
+      "description": "...",
+      "files": ["src/..."],
+      "dependencies": [],
+      "estimated_complexity": 2
+    }
+  ]
+}
 ```
+````
+
+## Rules
+
+- 2-7 subtasks (too few = not parallel, too many = overhead)
+- No file overlap between subtasks
+- Include tests with the code they test
+- Order by dependency (if B needs A, A comes first)
+
+````
+
+Edit these files to customize behavior. Run `swarm setup` to regenerate defaults.
 
 ## Dependencies
 
-| Dependency                                                      | Purpose                                     | Required |
-| --------------------------------------------------------------- | ------------------------------------------- | -------- |
-| [OpenCode](https://opencode.ai)                                 | Plugin host                                 | Yes      |
-| [Beads](https://github.com/steveyegge/beads)                    | Git-backed issue tracking                   | Yes      |
-| [Go](https://go.dev)                                            | Required for Agent Mail                     | No       |
-| [Agent Mail](https://github.com/joelhooks/agent-mail)           | Multi-agent coordination, file reservations | No       |
-| [CASS](https://github.com/Dicklesworthstone/cass)               | Historical context from past sessions       | No       |
-| [UBS](https://github.com/joelhooks/ubs)                         | Pre-completion bug scanning                 | No       |
-| [semantic-memory](https://github.com/joelhooks/semantic-memory) | Learning persistence                        | No       |
-| [Redis](https://redis.io)                                       | Rate limiting (SQLite fallback available)   | No       |
+| Dependency | Purpose | Required |
+|------------|---------|----------|
+| [OpenCode](https://opencode.ai) | Plugin host | Yes |
+| [Beads](https://github.com/steveyegge/beads) | Git-backed issue tracking | Yes |
+| [Go](https://go.dev) | Required for Agent Mail | No |
+| [Agent Mail](https://github.com/joelhooks/agent-mail) | Multi-agent coordination, file reservations | No |
+| [CASS](https://github.com/Dicklesworthstone/cass) | Historical context from past sessions | No |
+| [UBS](https://github.com/joelhooks/ubs) | Pre-completion bug scanning | No |
+| [semantic-memory](https://github.com/joelhooks/semantic-memory) | Learning persistence | No |
+| [Redis](https://redis.io) | Rate limiting (SQLite fallback available) | No |
 
 All dependencies are checked and can be installed via `swarm setup`.
 
@@ -124,58 +204,57 @@ All dependencies are checked and can be installed via `swarm setup`.
 
 ### Swarm
 
-| Tool                           | Description                                                              |
-| ------------------------------ | ------------------------------------------------------------------------ |
-| `swarm_init`                   | Initialize swarm session                                                 |
-| `swarm_select_strategy`        | Analyze task, recommend decomposition strategy (file/feature/risk-based) |
-| `swarm_plan_prompt`            | Generate strategy-specific planning prompt with CASS history             |
-| `swarm_decompose`              | Generate decomposition prompt                                            |
-| `swarm_validate_decomposition` | Validate response, detect file conflicts                                 |
-| `swarm_spawn_subtask`          | Generate worker agent prompt with Agent Mail/beads instructions          |
-| `swarm_subtask_prompt`         | Alias for spawn_subtask                                                  |
-| `swarm_status`                 | Get swarm progress by epic ID                                            |
-| `swarm_progress`               | Report subtask progress to coordinator                                   |
-| `swarm_complete`               | Complete subtask - runs UBS scan, releases reservations                  |
-| `swarm_record_outcome`         | Record outcome for learning (duration, errors, retries)                  |
+| Tool | Description |
+|------|-------------|
+| `swarm_init` | Initialize swarm session |
+| `swarm_select_strategy` | Analyze task, recommend decomposition strategy (file/feature/risk-based) |
+| `swarm_plan_prompt` | Generate strategy-specific planning prompt with CASS history |
+| `swarm_decompose` | Generate decomposition prompt |
+| `swarm_validate_decomposition` | Validate response, detect file conflicts |
+| `swarm_spawn_subtask` | Generate worker agent prompt with Agent Mail/beads instructions |
+| `swarm_status` | Get swarm progress by epic ID |
+| `swarm_progress` | Report subtask progress to coordinator |
+| `swarm_complete` | Complete subtask - runs UBS scan, releases reservations |
+| `swarm_record_outcome` | Record outcome for learning (duration, errors, retries) |
 
 ### Beads
 
-| Tool                | Description                                    |
-| ------------------- | ---------------------------------------------- |
-| `beads_create`      | Create bead with type-safe validation          |
-| `beads_create_epic` | Create epic + subtasks atomically              |
-| `beads_query`       | Query beads with filters (status, type, ready) |
-| `beads_update`      | Update status/description/priority             |
-| `beads_close`       | Close bead with reason                         |
-| `beads_start`       | Mark bead as in-progress                       |
-| `beads_ready`       | Get next unblocked bead                        |
-| `beads_sync`        | Sync to git and push                           |
-| `beads_link_thread` | Link bead to Agent Mail thread                 |
+| Tool | Description |
+|------|-------------|
+| `beads_create` | Create bead with type-safe validation |
+| `beads_create_epic` | Create epic + subtasks atomically |
+| `beads_query` | Query beads with filters (status, type, ready) |
+| `beads_update` | Update status/description/priority |
+| `beads_close` | Close bead with reason |
+| `beads_start` | Mark bead as in-progress |
+| `beads_ready` | Get next unblocked bead |
+| `beads_sync` | Sync to git and push |
+| `beads_link_thread` | Link bead to Agent Mail thread |
 
 ### Agent Mail
 
-| Tool                         | Description                                    |
-| ---------------------------- | ---------------------------------------------- |
-| `agentmail_init`             | Initialize session, register agent             |
-| `agentmail_send`             | Send message to agents                         |
-| `agentmail_inbox`            | Fetch inbox (max 5, no bodies - context safe)  |
-| `agentmail_read_message`     | Fetch single message body by ID                |
+| Tool | Description |
+|------|-------------|
+| `agentmail_init` | Initialize session, register agent |
+| `agentmail_send` | Send message to agents |
+| `agentmail_inbox` | Fetch inbox (max 5, no bodies - context safe) |
+| `agentmail_read_message` | Fetch single message body by ID |
 | `agentmail_summarize_thread` | Summarize thread (preferred over fetching all) |
-| `agentmail_reserve`          | Reserve file paths for exclusive editing       |
-| `agentmail_release`          | Release file reservations                      |
-| `agentmail_ack`              | Acknowledge message                            |
-| `agentmail_search`           | Search messages by keyword                     |
-| `agentmail_health`           | Check if Agent Mail server is running          |
+| `agentmail_reserve` | Reserve file paths for exclusive editing |
+| `agentmail_release` | Release file reservations |
+| `agentmail_ack` | Acknowledge message |
+| `agentmail_search` | Search messages by keyword |
+| `agentmail_health` | Check if Agent Mail server is running |
 
 ### Structured Output
 
-| Tool                             | Description                                           |
-| -------------------------------- | ----------------------------------------------------- |
-| `structured_extract_json`        | Extract JSON from markdown/text (multiple strategies) |
-| `structured_validate`            | Validate response against schema                      |
-| `structured_parse_evaluation`    | Parse self-evaluation response                        |
-| `structured_parse_decomposition` | Parse task decomposition response                     |
-| `structured_parse_bead_tree`     | Parse bead tree for epic creation                     |
+| Tool | Description |
+|------|-------------|
+| `structured_extract_json` | Extract JSON from markdown/text (multiple strategies) |
+| `structured_validate` | Validate response against schema |
+| `structured_parse_evaluation` | Parse self-evaluation response |
+| `structured_parse_decomposition` | Parse task decomposition response |
+| `structured_parse_bead_tree` | Parse bead tree for epic creation |
 
 ## Decomposition Strategies
 
@@ -213,32 +292,32 @@ Best for: bug fixes, security issues
 
 The plugin learns from outcomes:
 
-| Mechanism         | How It Works                                                |
-| ----------------- | ----------------------------------------------------------- |
-| Confidence decay  | Criteria weights fade unless revalidated (90-day half-life) |
-| Implicit feedback | Fast + success = helpful signal, slow + errors = harmful    |
-| Pattern maturity  | candidate → established → proven (or deprecated)            |
-| Anti-patterns     | Patterns with >60% failure rate auto-invert                 |
+| Mechanism | How It Works |
+|-----------|--------------|
+| Confidence decay | Criteria weights fade unless revalidated (90-day half-life) |
+| Implicit feedback | Fast + success = helpful signal, slow + errors = harmful |
+| Pattern maturity | candidate → established → proven (or deprecated) |
+| Anti-patterns | Patterns with >60% failure rate auto-invert |
 
 ## Context Preservation
 
 Hard limits to prevent context exhaustion:
 
-| Constraint          | Default    | Reason                         |
-| ------------------- | ---------- | ------------------------------ |
-| Inbox limit         | 5 messages | Prevents token burn            |
-| Bodies excluded     | Always     | Fetch individually when needed |
-| Summarize preferred | Yes        | Key points, not raw dump       |
+| Constraint | Default | Reason |
+|------------|---------|--------|
+| Inbox limit | 5 messages | Prevents token burn |
+| Bodies excluded | Always | Fetch individually when needed |
+| Summarize preferred | Yes | Key points, not raw dump |
 
 ## Rate Limiting
 
 Client-side limits (Redis primary, SQLite fallback):
 
 | Endpoint | Per Minute | Per Hour |
-| -------- | ---------- | -------- |
-| send     | 20         | 200      |
-| reserve  | 10         | 100      |
-| inbox    | 60         | 600      |
+|----------|------------|----------|
+| send | 20 | 200 |
+| reserve | 10 | 100 |
+| inbox | 60 | 600 |
 
 Configure via `OPENCODE_RATE_LIMIT_{ENDPOINT}_PER_MIN` env vars.
 
@@ -249,7 +328,7 @@ bun install
 bun run typecheck
 bun test
 bun run build
-```
+````
 
 ## License
 

package/bin/swarm.ts

@@ -17,7 +17,34 @@ import { existsSync, mkdirSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
 
-const VERSION = "0.9.0";
+const VERSION = "0.10.0";
+
+// ============================================================================
+// ASCII Art & Branding
+// ============================================================================
+
+const BEE = `
+    \\ \` - ' /
+   - .(o o). -
+    (  >.<  )
+     /|   |\\
+    (_|   |_)  bzzzz...
+`;
+
+const BANNER = `
+ ███████╗██╗    ██╗ █████╗ ██████╗ ███╗   ███╗
+ ██╔════╝██║    ██║██╔══██╗██╔══██╗████╗ ████║
+ ███████╗██║ █╗ ██║███████║██████╔╝██╔████╔██║
+ ╚════██║██║███╗██║██╔══██║██╔══██╗██║╚██╔╝██║
+ ███████║╚███╔███╔╝██║  ██║██║  ██║██║ ╚═╝ ██║
+ ╚══════╝ ╚══╝╚══╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝
+`;
+
+const TAGLINE = "Multi-agent coordination for OpenCode";
+
+const dim = (s: string) => `\x1b[2m${s}\x1b[0m`;
+const yellow = (s: string) => `\x1b[33m${s}\x1b[0m`;
+const cyan = (s: string) => `\x1b[36m${s}\x1b[0m`;
 
 // ============================================================================
 // Types
@@ -560,27 +587,70 @@ async function init() {
 }
 
 function version() {
-  console.log("opencode-swarm-plugin v" + VERSION);
+  console.log(yellow(BANNER));
+  console.log(dim("  " + TAGLINE));
+  console.log();
+  console.log("  Version: " + VERSION);
+  console.log("  Docs:    https://github.com/joelhooks/opencode-swarm-plugin");
+  console.log();
 }
 
-function help() {
-  console.log(`
-opencode-swarm-plugin v${VERSION}
-
-Multi-agent swarm coordination for OpenCode.
+function config() {
+  const configDir = join(homedir(), ".config", "opencode");
+  const pluginPath = join(configDir, "plugins", "swarm.ts");
+  const commandPath = join(configDir, "commands", "swarm.md");
+  const agentPath = join(configDir, "agents", "swarm-planner.md");
+
+  console.log(yellow(BANNER));
+  console.log(dim("  " + TAGLINE + " v" + VERSION));
+  console.log();
+  console.log(cyan("Config Files:"));
+  console.log();
+
+  const files = [
+    { path: pluginPath, desc: "Plugin loader", emoji: "🔌" },
+    { path: commandPath, desc: "/swarm command prompt", emoji: "📜" },
+    { path: agentPath, desc: "@swarm-planner agent", emoji: "🤖" },
+  ];
+
+  for (const { path, desc, emoji } of files) {
+    const exists = existsSync(path);
+    const status = exists ? "✓" : "✗";
+    const color = exists ? "\x1b[32m" : "\x1b[31m";
+    console.log(`  ${emoji} ${desc}`);
+    console.log(`     ${color}${status}\x1b[0m ${dim(path)}`);
+    console.log();
+  }
 
-Commands:
-  swarm setup    Interactive installer - checks and installs dependencies
-  swarm doctor   Health check - shows status of all dependencies  
-  swarm init     Initialize beads in current project
-  swarm version  Show version
-  swarm help     Show this help
+  console.log(dim("Edit these files to customize swarm behavior."));
+  console.log(dim("Run 'swarm setup' to regenerate defaults."));
+  console.log();
+}
 
-After setup, use in OpenCode:
+function help() {
+  console.log(yellow(BANNER));
+  console.log(dim("  " + TAGLINE + " v" + VERSION));
+  console.log(cyan(BEE));
+  console.log(`
+${cyan("Commands:")}
+  swarm setup     Interactive installer - checks and installs dependencies
+  swarm doctor    Health check - shows status of all dependencies
+  swarm init      Initialize beads in current project
+  swarm config    Show paths to generated config files
+  swarm version   Show version and banner
+  swarm help      Show this help
+
+${cyan("Usage in OpenCode:")}
   /swarm "Add user authentication with OAuth"
-  @swarm-planner "Refactor components to use hooks"
+  @swarm-planner "Refactor all components to use hooks"
 
-Documentation: https://github.com/joelhooks/opencode-swarm-plugin
+${cyan("Customization:")}
+  Edit the generated files to customize behavior:
+  ${dim("~/.config/opencode/commands/swarm.md")}    - /swarm command prompt
+  ${dim("~/.config/opencode/agents/swarm-planner.md")} - @swarm-planner agent
+  ${dim("~/.config/opencode/plugins/swarm.ts")}     - Plugin loader
+
+${dim("Docs: https://github.com/joelhooks/opencode-swarm-plugin")}
 `);
 }
 
@@ -600,6 +670,9 @@ switch (command) {
   case "init":
     await init();
     break;
+  case "config":
+    config();
+    break;
   case "version":
   case "--version":
   case "-v":

package/dist/index.js

@@ -22593,6 +22593,18 @@ async function getRateLimiter() {
 var AGENT_MAIL_URL = "http://127.0.0.1:8765";
 var DEFAULT_TTL_SECONDS = 3600;
 var MAX_INBOX_LIMIT = 5;
+var RETRY_CONFIG = {
+  maxRetries: parseInt(process.env.OPENCODE_AGENT_MAIL_MAX_RETRIES || "3"),
+  baseDelayMs: parseInt(process.env.OPENCODE_AGENT_MAIL_BASE_DELAY_MS || "100"),
+  maxDelayMs: parseInt(process.env.OPENCODE_AGENT_MAIL_MAX_DELAY_MS || "5000"),
+  timeoutMs: parseInt(process.env.OPENCODE_AGENT_MAIL_TIMEOUT_MS || "10000"),
+  jitterPercent: 20
+};
+var RECOVERY_CONFIG = {
+  failureThreshold: 2,
+  restartCooldownMs: 30000,
+  enabled: process.env.OPENCODE_AGENT_MAIL_AUTO_RESTART !== "false"
+};
 var sessionStates = new Map;
 
 class AgentMailError extends Error {
@@ -22639,6 +22651,151 @@ class RateLimitExceededError extends Error {
     this.name = "RateLimitExceededError";
   }
 }
+var consecutiveFailures = 0;
+var lastRestartAttempt = 0;
+var isRestarting = false;
+async function isServerHealthy() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    const response = await fetch(`${AGENT_MAIL_URL}/health/liveness`, {
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function isServerFunctional() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const response = await fetch(`${AGENT_MAIL_URL}/mcp/`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: "health-test",
+        method: "tools/call",
+        params: { name: "health_check", arguments: {} }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!response.ok)
+      return false;
+    const json2 = await response.json();
+    if (json2.result?.isError)
+      return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function restartServer() {
+  if (!RECOVERY_CONFIG.enabled) {
+    console.warn("[agent-mail] Auto-restart disabled via OPENCODE_AGENT_MAIL_AUTO_RESTART=false");
+    return false;
+  }
+  if (isRestarting) {
+    console.warn("[agent-mail] Restart already in progress");
+    return false;
+  }
+  const now = Date.now();
+  if (now - lastRestartAttempt < RECOVERY_CONFIG.restartCooldownMs) {
+    const waitSec = Math.ceil((RECOVERY_CONFIG.restartCooldownMs - (now - lastRestartAttempt)) / 1000);
+    console.warn(`[agent-mail] Restart cooldown active, wait ${waitSec}s`);
+    return false;
+  }
+  isRestarting = true;
+  lastRestartAttempt = now;
+  try {
+    console.warn("[agent-mail] Attempting server restart...");
+    const findProc = Bun.spawn(["lsof", "-i", ":8765", "-t"], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const findOutput = await new Response(findProc.stdout).text();
+    await findProc.exited;
+    const pids = findOutput.trim().split(`
+`).filter(Boolean);
+    if (pids.length > 0) {
+      for (const pid of pids) {
+        console.warn(`[agent-mail] Killing process ${pid}`);
+        Bun.spawn(["kill", pid]);
+      }
+      await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+    const possiblePaths = [
+      `${process.env.HOME}/Code/Dicklesworthstone/mcp_agent_mail`,
+      `${process.env.HOME}/.local/share/agent-mail`,
+      `${process.env.HOME}/mcp_agent_mail`
+    ];
+    let serverDir = null;
+    for (const path of possiblePaths) {
+      try {
+        const stat = await Bun.file(`${path}/pyproject.toml`).exists();
+        if (stat) {
+          serverDir = path;
+          break;
+        }
+      } catch {
+        continue;
+      }
+    }
+    if (!serverDir) {
+      console.error("[agent-mail] Could not find agent-mail installation directory");
+      return false;
+    }
+    console.warn(`[agent-mail] Starting server from ${serverDir}`);
+    Bun.spawn(["python", "-m", "mcp_agent_mail.cli", "serve-http"], {
+      cwd: serverDir,
+      stdout: "ignore",
+      stderr: "ignore",
+      detached: true
+    });
+    for (let i = 0;i < 10; i++) {
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      if (await isServerHealthy()) {
+        console.warn("[agent-mail] Server restarted successfully");
+        consecutiveFailures = 0;
+        return true;
+      }
+    }
+    console.error("[agent-mail] Server failed to start after restart");
+    return false;
+  } catch (error45) {
+    console.error("[agent-mail] Restart failed:", error45);
+    return false;
+  } finally {
+    isRestarting = false;
+  }
+}
+function calculateBackoffDelay(attempt) {
+  if (attempt === 0)
+    return 0;
+  const exponentialDelay = RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt - 1);
+  const cappedDelay = Math.min(exponentialDelay, RETRY_CONFIG.maxDelayMs);
+  const jitterRange = cappedDelay * (RETRY_CONFIG.jitterPercent / 100);
+  const jitter = (Math.random() * 2 - 1) * jitterRange;
+  return Math.round(cappedDelay + jitter);
+}
+function isRetryableError(error45) {
+  if (error45 instanceof Error) {
+    const message = error45.message.toLowerCase();
+    if (message.includes("econnrefused") || message.includes("econnreset") || message.includes("socket") || message.includes("network") || message.includes("timeout") || message.includes("aborted")) {
+      return true;
+    }
+    if (error45 instanceof AgentMailError && error45.code) {
+      return error45.code === 502 || error45.code === 503 || error45.code === 504;
+    }
+    if (message.includes("unexpected error")) {
+      return true;
+    }
+  }
+  return false;
+}
 var agentMailAvailable = null;
 async function checkAgentMailAvailable() {
   if (agentMailAvailable !== null) {
@@ -22670,36 +22827,85 @@ async function recordRateLimitedRequest(agentName, endpoint) {
   }
   await rateLimiter.recordRequest(agentName, endpoint);
 }
-async function mcpCall(toolName, args) {
-  const response = await fetch(`${AGENT_MAIL_URL}/mcp/`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      jsonrpc: "2.0",
-      id: crypto.randomUUID(),
-      method: "tools/call",
-      params: { name: toolName, arguments: args }
-    })
-  });
-  if (!response.ok) {
-    throw new AgentMailError(`HTTP ${response.status}: ${response.statusText}`, toolName);
-  }
-  const json2 = await response.json();
-  if (json2.error) {
-    throw new AgentMailError(json2.error.message, toolName, json2.error.code, json2.error.data);
+async function mcpCallOnce(toolName, args) {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), RETRY_CONFIG.timeoutMs);
+  try {
+    const response = await fetch(`${AGENT_MAIL_URL}/mcp/`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tools/call",
+        params: { name: toolName, arguments: args }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!response.ok) {
+      throw new AgentMailError(`HTTP ${response.status}: ${response.statusText}`, toolName, response.status);
+    }
+    const json2 = await response.json();
+    if (json2.error) {
+      throw new AgentMailError(json2.error.message, toolName, json2.error.code, json2.error.data);
+    }
+    const result = json2.result;
+    if (result && typeof result === "object") {
+      const wrapped = result;
+      if (wrapped.isError) {
+        const errorText = wrapped.content?.[0]?.text || "Unknown error";
+        throw new AgentMailError(errorText, toolName);
+      }
+      if ("structuredContent" in wrapped) {
+        return wrapped.structuredContent;
+      }
+    }
+    return result;
+  } catch (error45) {
+    clearTimeout(timeout);
+    throw error45;
   }
-  const result = json2.result;
-  if (result && typeof result === "object") {
-    const wrapped = result;
-    if (wrapped.isError) {
-      const errorText = wrapped.content?.[0]?.text || "Unknown error";
-      throw new AgentMailError(errorText, toolName);
+}
+async function mcpCall(toolName, args) {
+  let lastError = null;
+  for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+    if (attempt > 0) {
+      const delay = calculateBackoffDelay(attempt);
+      console.warn(`[agent-mail] Retry ${attempt}/${RETRY_CONFIG.maxRetries} for ${toolName} after ${delay}ms`);
+      await new Promise((resolve) => setTimeout(resolve, delay));
     }
-    if ("structuredContent" in wrapped) {
-      return wrapped.structuredContent;
+    try {
+      const result = await mcpCallOnce(toolName, args);
+      consecutiveFailures = 0;
+      return result;
+    } catch (error45) {
+      lastError = error45 instanceof Error ? error45 : new Error(String(error45));
+      consecutiveFailures++;
+      if (consecutiveFailures >= RECOVERY_CONFIG.failureThreshold && RECOVERY_CONFIG.enabled) {
+        console.warn(`[agent-mail] ${consecutiveFailures} consecutive failures, checking server health...`);
+        const healthy = await isServerFunctional();
+        if (!healthy) {
+          console.warn("[agent-mail] Server unhealthy, attempting restart...");
+          const restarted = await restartServer();
+          if (restarted) {
+            agentMailAvailable = null;
+            attempt--;
+            continue;
+          }
+        }
+      }
+      if (!isRetryableError(error45)) {
+        console.warn(`[agent-mail] Non-retryable error for ${toolName}: ${lastError.message}`);
+        throw lastError;
+      }
+      if (attempt === RETRY_CONFIG.maxRetries) {
+        console.error(`[agent-mail] All ${RETRY_CONFIG.maxRetries} retries exhausted for ${toolName}`);
+        throw lastError;
+      }
     }
   }
-  return result;
+  throw lastError || new Error("Unknown error in mcpCall");
 }
 function requireState(sessionID) {
   const state = sessionStates.get(sessionID);

package/dist/plugin.js

@@ -22567,6 +22567,18 @@ async function getRateLimiter() {
 var AGENT_MAIL_URL = "http://127.0.0.1:8765";
 var DEFAULT_TTL_SECONDS = 3600;
 var MAX_INBOX_LIMIT = 5;
+var RETRY_CONFIG = {
+  maxRetries: parseInt(process.env.OPENCODE_AGENT_MAIL_MAX_RETRIES || "3"),
+  baseDelayMs: parseInt(process.env.OPENCODE_AGENT_MAIL_BASE_DELAY_MS || "100"),
+  maxDelayMs: parseInt(process.env.OPENCODE_AGENT_MAIL_MAX_DELAY_MS || "5000"),
+  timeoutMs: parseInt(process.env.OPENCODE_AGENT_MAIL_TIMEOUT_MS || "10000"),
+  jitterPercent: 20
+};
+var RECOVERY_CONFIG = {
+  failureThreshold: 2,
+  restartCooldownMs: 30000,
+  enabled: process.env.OPENCODE_AGENT_MAIL_AUTO_RESTART !== "false"
+};
 var sessionStates = new Map;
 
 class AgentMailError extends Error {
@@ -22613,6 +22625,151 @@ class RateLimitExceededError extends Error {
     this.name = "RateLimitExceededError";
   }
 }
+var consecutiveFailures = 0;
+var lastRestartAttempt = 0;
+var isRestarting = false;
+async function isServerHealthy() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    const response = await fetch(`${AGENT_MAIL_URL}/health/liveness`, {
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function isServerFunctional() {
+  try {
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const response = await fetch(`${AGENT_MAIL_URL}/mcp/`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: "health-test",
+        method: "tools/call",
+        params: { name: "health_check", arguments: {} }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!response.ok)
+      return false;
+    const json2 = await response.json();
+    if (json2.result?.isError)
+      return false;
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function restartServer() {
+  if (!RECOVERY_CONFIG.enabled) {
+    console.warn("[agent-mail] Auto-restart disabled via OPENCODE_AGENT_MAIL_AUTO_RESTART=false");
+    return false;
+  }
+  if (isRestarting) {
+    console.warn("[agent-mail] Restart already in progress");
+    return false;
+  }
+  const now = Date.now();
+  if (now - lastRestartAttempt < RECOVERY_CONFIG.restartCooldownMs) {
+    const waitSec = Math.ceil((RECOVERY_CONFIG.restartCooldownMs - (now - lastRestartAttempt)) / 1000);
+    console.warn(`[agent-mail] Restart cooldown active, wait ${waitSec}s`);
+    return false;
+  }
+  isRestarting = true;
+  lastRestartAttempt = now;
+  try {
+    console.warn("[agent-mail] Attempting server restart...");
+    const findProc = Bun.spawn(["lsof", "-i", ":8765", "-t"], {
+      stdout: "pipe",
+      stderr: "pipe"
+    });
+    const findOutput = await new Response(findProc.stdout).text();
+    await findProc.exited;
+    const pids = findOutput.trim().split(`
+`).filter(Boolean);
+    if (pids.length > 0) {
+      for (const pid of pids) {
+        console.warn(`[agent-mail] Killing process ${pid}`);
+        Bun.spawn(["kill", pid]);
+      }
+      await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+    const possiblePaths = [
+      `${process.env.HOME}/Code/Dicklesworthstone/mcp_agent_mail`,
+      `${process.env.HOME}/.local/share/agent-mail`,
+      `${process.env.HOME}/mcp_agent_mail`
+    ];
+    let serverDir = null;
+    for (const path of possiblePaths) {
+      try {
+        const stat = await Bun.file(`${path}/pyproject.toml`).exists();
+        if (stat) {
+          serverDir = path;
+          break;
+        }
+      } catch {
+        continue;
+      }
+    }
+    if (!serverDir) {
+      console.error("[agent-mail] Could not find agent-mail installation directory");
+      return false;
+    }
+    console.warn(`[agent-mail] Starting server from ${serverDir}`);
+    Bun.spawn(["python", "-m", "mcp_agent_mail.cli", "serve-http"], {
+      cwd: serverDir,
+      stdout: "ignore",
+      stderr: "ignore",
+      detached: true
+    });
+    for (let i = 0;i < 10; i++) {
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      if (await isServerHealthy()) {
+        console.warn("[agent-mail] Server restarted successfully");
+        consecutiveFailures = 0;
+        return true;
+      }
+    }
+    console.error("[agent-mail] Server failed to start after restart");
+    return false;
+  } catch (error45) {
+    console.error("[agent-mail] Restart failed:", error45);
+    return false;
+  } finally {
+    isRestarting = false;
+  }
+}
+function calculateBackoffDelay(attempt) {
+  if (attempt === 0)
+    return 0;
+  const exponentialDelay = RETRY_CONFIG.baseDelayMs * Math.pow(2, attempt - 1);
+  const cappedDelay = Math.min(exponentialDelay, RETRY_CONFIG.maxDelayMs);
+  const jitterRange = cappedDelay * (RETRY_CONFIG.jitterPercent / 100);
+  const jitter = (Math.random() * 2 - 1) * jitterRange;
+  return Math.round(cappedDelay + jitter);
+}
+function isRetryableError(error45) {
+  if (error45 instanceof Error) {
+    const message = error45.message.toLowerCase();
+    if (message.includes("econnrefused") || message.includes("econnreset") || message.includes("socket") || message.includes("network") || message.includes("timeout") || message.includes("aborted")) {
+      return true;
+    }
+    if (error45 instanceof AgentMailError && error45.code) {
+      return error45.code === 502 || error45.code === 503 || error45.code === 504;
+    }
+    if (message.includes("unexpected error")) {
+      return true;
+    }
+  }
+  return false;
+}
 var agentMailAvailable = null;
 async function checkAgentMailAvailable() {
   if (agentMailAvailable !== null) {
@@ -22644,36 +22801,85 @@ async function recordRateLimitedRequest(agentName, endpoint) {
   }
   await rateLimiter.recordRequest(agentName, endpoint);
 }
-async function mcpCall(toolName, args) {
-  const response = await fetch(`${AGENT_MAIL_URL}/mcp/`, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify({
-      jsonrpc: "2.0",
-      id: crypto.randomUUID(),
-      method: "tools/call",
-      params: { name: toolName, arguments: args }
-    })
-  });
-  if (!response.ok) {
-    throw new AgentMailError(`HTTP ${response.status}: ${response.statusText}`, toolName);
-  }
-  const json2 = await response.json();
-  if (json2.error) {
-    throw new AgentMailError(json2.error.message, toolName, json2.error.code, json2.error.data);
+async function mcpCallOnce(toolName, args) {
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), RETRY_CONFIG.timeoutMs);
+  try {
+    const response = await fetch(`${AGENT_MAIL_URL}/mcp/`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        jsonrpc: "2.0",
+        id: crypto.randomUUID(),
+        method: "tools/call",
+        params: { name: toolName, arguments: args }
+      }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    if (!response.ok) {
+      throw new AgentMailError(`HTTP ${response.status}: ${response.statusText}`, toolName, response.status);
+    }
+    const json2 = await response.json();
+    if (json2.error) {
+      throw new AgentMailError(json2.error.message, toolName, json2.error.code, json2.error.data);
+    }
+    const result = json2.result;
+    if (result && typeof result === "object") {
+      const wrapped = result;
+      if (wrapped.isError) {
+        const errorText = wrapped.content?.[0]?.text || "Unknown error";
+        throw new AgentMailError(errorText, toolName);
+      }
+      if ("structuredContent" in wrapped) {
+        return wrapped.structuredContent;
+      }
+    }
+    return result;
+  } catch (error45) {
+    clearTimeout(timeout);
+    throw error45;
   }
-  const result = json2.result;
-  if (result && typeof result === "object") {
-    const wrapped = result;
-    if (wrapped.isError) {
-      const errorText = wrapped.content?.[0]?.text || "Unknown error";
-      throw new AgentMailError(errorText, toolName);
+}
+async function mcpCall(toolName, args) {
+  let lastError = null;
+  for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
+    if (attempt > 0) {
+      const delay = calculateBackoffDelay(attempt);
+      console.warn(`[agent-mail] Retry ${attempt}/${RETRY_CONFIG.maxRetries} for ${toolName} after ${delay}ms`);
+      await new Promise((resolve) => setTimeout(resolve, delay));
     }
-    if ("structuredContent" in wrapped) {
-      return wrapped.structuredContent;
+    try {
+      const result = await mcpCallOnce(toolName, args);
+      consecutiveFailures = 0;
+      return result;
+    } catch (error45) {
+      lastError = error45 instanceof Error ? error45 : new Error(String(error45));
+      consecutiveFailures++;
+      if (consecutiveFailures >= RECOVERY_CONFIG.failureThreshold && RECOVERY_CONFIG.enabled) {
+        console.warn(`[agent-mail] ${consecutiveFailures} consecutive failures, checking server health...`);
+        const healthy = await isServerFunctional();
+        if (!healthy) {
+          console.warn("[agent-mail] Server unhealthy, attempting restart...");
+          const restarted = await restartServer();
+          if (restarted) {
+            agentMailAvailable = null;
+            attempt--;
+            continue;
+          }
+        }
+      }
+      if (!isRetryableError(error45)) {
+        console.warn(`[agent-mail] Non-retryable error for ${toolName}: ${lastError.message}`);
+        throw lastError;
+      }
+      if (attempt === RETRY_CONFIG.maxRetries) {
+        console.error(`[agent-mail] All ${RETRY_CONFIG.maxRetries} retries exhausted for ${toolName}`);
+        throw lastError;
+      }
     }
   }
-  return result;
+  throw lastError || new Error("Unknown error in mcpCall");
 }
 function requireState(sessionID) {
   const state = sessionStates.get(sessionID);

package/package.json

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