opencode-swarm-plugin 0.12.6 → 0.12.8

package/.beads/issues.jsonl

@@ -466,6 +466,13 @@
 {"id":"opencode-swarm-plugin-97yt8","title":"Query test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-10T09:06:06.460876-08:00","updated_at":"2025-12-10T09:06:10.054925-08:00","closed_at":"2025-12-10T09:06:10.054925-08:00"}
 {"id":"opencode-swarm-plugin-98oh","title":"Thread link test bead","description":"[thread:test-thread-456]","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T09:09:32.231853-08:00","updated_at":"2025-12-08T09:09:33.887506-08:00","closed_at":"2025-12-08T09:09:33.887506-08:00"}
 {"id":"opencode-swarm-plugin-99kl","title":"Test bug with priority","description":"This is a critical bug","status":"closed","priority":0,"issue_type":"bug","created_at":"2025-12-08T08:25:09.19481-08:00","updated_at":"2025-12-08T08:25:11.989888-08:00","closed_at":"2025-12-08T08:25:11.989888-08:00"}
+{"id":"opencode-swarm-plugin-9bwp7","title":"Swarm Plugin Improvements from AI Agent Pattern Research","description":"Improvements derived from PDF library research (Patterns for Building AI Agents, Principles of Building AI Agents). Focus on context engineering, error handling, and coordination patterns.","status":"open","priority":1,"issue_type":"epic","created_at":"2025-12-10T10:02:46.552187-08:00","updated_at":"2025-12-10T10:02:46.552187-08:00"}
+{"id":"opencode-swarm-plugin-9bwp7.1","title":"Add swarm_compress_context tool for inter-subtask context pruning","description":"","status":"closed","priority":1,"issue_type":"task","created_at":"2025-12-10T10:02:46.602046-08:00","updated_at":"2025-12-10T10:09:07.1119-08:00","closed_at":"2025-12-10T10:09:07.1119-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-9bwp7.1","depends_on_id":"opencode-swarm-plugin-9bwp7","type":"parent-child","created_at":"2025-12-10T10:02:46.603062-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-9bwp7.2","title":"Add error accumulator that feeds errors into retry prompts","description":"","status":"closed","priority":1,"issue_type":"task","created_at":"2025-12-10T10:02:46.646473-08:00","updated_at":"2025-12-10T10:14:05.802245-08:00","closed_at":"2025-12-10T10:14:05.802245-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-9bwp7.2","depends_on_id":"opencode-swarm-plugin-9bwp7","type":"parent-child","created_at":"2025-12-10T10:02:46.647689-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-9bwp7.3","title":"Add failure mode taxonomy to swarm_record_outcome","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-10T10:02:46.693562-08:00","updated_at":"2025-12-10T10:02:46.693562-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-9bwp7.3","depends_on_id":"opencode-swarm-plugin-9bwp7","type":"parent-child","created_at":"2025-12-10T10:02:46.695053-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-9bwp7.4","title":"Add swarm_broadcast for mid-task context sharing between agents","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-10T10:02:46.743428-08:00","updated_at":"2025-12-10T10:02:46.743428-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-9bwp7.4","depends_on_id":"opencode-swarm-plugin-9bwp7","type":"parent-child","created_at":"2025-12-10T10:02:46.744327-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-9bwp7.5","title":"Restructure SUBTASK_PROMPT with explicit context sections","description":"","status":"open","priority":2,"issue_type":"task","created_at":"2025-12-10T10:02:46.790385-08:00","updated_at":"2025-12-10T10:02:46.790385-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-9bwp7.5","depends_on_id":"opencode-swarm-plugin-9bwp7","type":"parent-child","created_at":"2025-12-10T10:02:46.791322-08:00","created_by":"daemon"}]}
+{"id":"opencode-swarm-plugin-9bwp7.6","title":"Audit tool descriptions for semantic clarity","description":"","status":"open","priority":3,"issue_type":"task","created_at":"2025-12-10T10:02:46.835414-08:00","updated_at":"2025-12-10T10:02:46.835414-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-9bwp7.6","depends_on_id":"opencode-swarm-plugin-9bwp7","type":"parent-child","created_at":"2025-12-10T10:02:46.836428-08:00","created_by":"daemon"}]}
 {"id":"opencode-swarm-plugin-9c51","title":"Thread link test bead","description":"[thread:test-thread-456]","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:25:11.111119-08:00","updated_at":"2025-12-08T08:25:12.950452-08:00","closed_at":"2025-12-08T08:25:12.950452-08:00"}
 {"id":"opencode-swarm-plugin-9c6","title":"Cleanup task","description":"","status":"closed","priority":3,"issue_type":"chore","created_at":"2025-12-07T19:34:52.310497-08:00","updated_at":"2025-12-07T19:34:54.508737-08:00","closed_at":"2025-12-07T19:34:54.508737-08:00"}
 {"id":"opencode-swarm-plugin-9csf","title":"Limit test bead 1","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:11:39.347968-08:00","updated_at":"2025-12-08T08:11:41.877049-08:00","closed_at":"2025-12-08T08:11:41.877049-08:00"}
@@ -533,6 +540,7 @@
 {"id":"opencode-swarm-plugin-ai2p","title":"Update test bead","description":"Original description","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:22:17.302997-08:00","updated_at":"2025-12-08T08:22:19.488446-08:00","closed_at":"2025-12-08T08:22:19.488446-08:00"}
 {"id":"opencode-swarm-plugin-ajqu","title":"Query test bead","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:41:10.735824-08:00","updated_at":"2025-12-07T19:41:13.322607-08:00","closed_at":"2025-12-07T19:41:13.322607-08:00"}
 {"id":"opencode-swarm-plugin-am6b","title":"Single subtask epic","description":"","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-08T08:11:40.362506-08:00","updated_at":"2025-12-08T08:11:42.362957-08:00","closed_at":"2025-12-08T08:11:42.362957-08:00"}
+{"id":"opencode-swarm-plugin-anlp2","title":"AI Agent Pattern Research: Plugin Improvement Analysis","description":"Research synthesis from PDF library (Patterns for Building AI Agents, Principles of Building AI Agents, Training Complex Cognitive Skills) applied to opencode-swarm-plugin improvements.\n\n## Key Patterns Identified\n\n### 1. Context Engineering (from Patterns for Building AI Agents)\n- **Current gap**: Our SUBTASK_PROMPT is verbose but lacks structured context sections\n- **Pattern**: \"Context engineering is both art and science\" - Karpathy\n- **Improvement**: Add explicit context sections: [IDENTITY] [TASK] [CONSTRAINTS] [TOOLS] [OUTPUT]\n\n### 2. Context Compression (p.37-39)\n- **Current gap**: No automatic context pruning between agent tasks\n- **Pattern**: \"Periodic context compression can prune irrelevant context\"\n- **Improvement**: Add `swarm_compress_context` tool that summarizes completed work\n\n### 3. Feed Errors Into Context (p.40)\n- **Current gap**: Errors are logged but not fed back into agent context\n- **Pattern**: \"Good agents examine and correct errors when something goes wrong\"\n- **Improvement**: Add error accumulator that feeds into retry prompts\n\n### 4. Parallelize Carefully (p.31)\n- **Current gap**: We spawn parallel agents but don't ensure context sharing\n- **Pattern**: \"Ensure subagents can share context along the way\"\n- **Improvement**: Add `swarm_broadcast` for mid-task context updates\n\n### 5. List Failure Modes (p.46)\n- **Current gap**: No classification of why agent failures occur\n- **Pattern**: \"Create classification process for agent failures\"\n- **Improvement**: Add failure taxonomy to swarm_record_outcome\n\n### 6. Tool Calling Best Practices (Principles p.36)\n- **Current gap**: Tool descriptions are functional but not semantic\n- **Pattern**: \"Use semantic naming that matches tool's purpose\"\n- **Improvement**: Audit all tool descriptions for semantic clarity\n\n### 7. Workflows as Tools (Principles p.109)\n- **Current gap**: Swarm is a command, not composable\n- **Pattern**: \"Multi-agent architecture = primitives + arrangement\"\n- **Improvement**: Make swarm_decompose callable from other workflows\n\n### 8. Implicit Feedback Scoring (already implemented)\n- **Current strength**: swarm_record_outcome tracks duration/errors/retries\n- **Enhancement**: Add strategy-specific scoring (file-based vs feature-based)\n\n## Recommended Improvements (Priority Order)\n\n1. **HIGH**: Context compression between subtasks\n2. **HIGH**: Error accumulator for retry prompts  \n3. **MEDIUM**: Failure mode taxonomy\n4. **MEDIUM**: Mid-task context broadcast\n5. **LOW**: Semantic tool description audit\n6. **LOW**: Composable workflow primitives","status":"open","priority":1,"issue_type":"task","created_at":"2025-12-10T10:02:37.4266-08:00","updated_at":"2025-12-10T10:02:37.4266-08:00"}
 {"id":"opencode-swarm-plugin-anuj","title":"New feature request","description":"","status":"closed","priority":1,"issue_type":"feature","created_at":"2025-12-07T19:57:05.6861-08:00","updated_at":"2025-12-07T19:57:08.122037-08:00","closed_at":"2025-12-07T19:57:08.122037-08:00"}
 {"id":"opencode-swarm-plugin-aoed","title":"Workflow test epic","description":"","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-07T19:39:30.83873-08:00","updated_at":"2025-12-07T19:39:31.011277-08:00","closed_at":"2025-12-07T19:39:31.011277-08:00"}
 {"id":"opencode-swarm-plugin-aoed.1","title":"Step 1","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:39:30.870528-08:00","updated_at":"2025-12-07T19:39:30.943621-08:00","closed_at":"2025-12-07T19:39:30.943621-08:00","dependencies":[{"issue_id":"opencode-swarm-plugin-aoed.1","depends_on_id":"opencode-swarm-plugin-aoed","type":"parent-child","created_at":"2025-12-07T19:39:30.870831-08:00","created_by":"daemon"}]}
@@ -600,6 +608,7 @@
 {"id":"opencode-swarm-plugin-c3ut","title":"Single subtask epic","description":"","status":"closed","priority":1,"issue_type":"epic","created_at":"2025-12-08T08:25:10.733148-08:00","updated_at":"2025-12-08T08:25:12.718944-08:00","closed_at":"2025-12-08T08:25:12.718944-08:00"}
 {"id":"opencode-swarm-plugin-c3x","title":"Limit test bead 3","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:37:34.169277-08:00","updated_at":"2025-12-07T19:37:36.225991-08:00","closed_at":"2025-12-07T19:37:36.225991-08:00"}
 {"id":"opencode-swarm-plugin-c40t","title":"Update test bead","description":"Blocked on dependency","status":"closed","priority":1,"issue_type":"task","created_at":"2025-12-08T11:11:23.290111-08:00","updated_at":"2025-12-08T11:11:25.615728-08:00","closed_at":"2025-12-08T11:11:25.615728-08:00"}
+{"id":"opencode-swarm-plugin-c4zjn","title":"Make Agent Mail auto-restart more aggressive","description":"Agent Mail server frequently gets into bad state with \"Server encountered an unexpected error\" but auto-restart is too conservative.\n\nCurrent config:\n- failureThreshold: 2 (needs 2 failures before restart)\n- restartCooldownMs: 30000 (30 second cooldown)\n\nProblems:\n1. First failure doesn't trigger restart, just retries\n2. 30s cooldown is too long when server is truly broken\n3. After restart, availability cache isn't cleared aggressively enough\n\nProposed fix:\n1. Reduce failureThreshold to 1 (restart on first \"unexpected error\")\n2. Reduce restartCooldownMs to 10000 (10 seconds)\n3. Add proactive health check on agentmail_init that triggers restart if server is unhealthy\n4. Clear availability cache after any restart attempt\n5. Add `agentmail_restart` tool for manual restart\n\nFiles: src/agent-mail.ts","status":"closed","priority":1,"issue_type":"bug","created_at":"2025-12-10T10:14:48.242736-08:00","updated_at":"2025-12-10T10:16:17.53306-08:00","closed_at":"2025-12-10T10:16:17.53306-08:00"}
 {"id":"opencode-swarm-plugin-c540","title":"Limit test bead 2","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-08T08:22:16.856145-08:00","updated_at":"2025-12-08T08:22:19.29045-08:00","closed_at":"2025-12-08T08:22:19.29045-08:00"}
 {"id":"opencode-swarm-plugin-c591c","title":"swarm.ts:1774-1777 - File reservation release without verification","description":"swarm.ts:1774-1777 - swarm_complete calls release_file_reservations but doesn't check if it succeeds. If release fails, reservations leak and block other agents. Suggested fix: Check mcpCall result and log/retry on failure.","status":"open","priority":2,"issue_type":"bug","created_at":"2025-12-10T09:06:38.089086-08:00","updated_at":"2025-12-10T09:06:38.089086-08:00"}
 {"id":"opencode-swarm-plugin-c5l","title":"Bead to close","description":"","status":"closed","priority":2,"issue_type":"task","created_at":"2025-12-07T19:37:34.574305-08:00","updated_at":"2025-12-07T19:37:34.598352-08:00","closed_at":"2025-12-07T19:37:34.598352-08:00"}

package/dist/index.js

@@ -22632,8 +22632,8 @@ var RETRY_CONFIG = {
   jitterPercent: 20
 };
 var RECOVERY_CONFIG = {
-  failureThreshold: 2,
-  restartCooldownMs: 30000,
+  failureThreshold: 1,
+  restartCooldownMs: 1e4,
   enabled: process.env.OPENCODE_AGENT_MAIL_AUTO_RESTART !== "false"
 };
 var SESSION_STATE_DIR = process.env.SWARM_STATE_DIR || join2(tmpdir(), "swarm-sessions");
@@ -22931,6 +22931,7 @@ async function mcpCallOnce(toolName, args) {
 }
 async function mcpCall(toolName, args) {
   let lastError = null;
+  let restartAttempted = false;
   for (let attempt = 0;attempt <= RETRY_CONFIG.maxRetries; attempt++) {
     if (attempt > 0) {
       const delay = calculateBackoffDelay(attempt);
@@ -22943,13 +22944,28 @@ async function mcpCall(toolName, args) {
       return result;
     } catch (error45) {
       lastError = error45 instanceof Error ? error45 : new Error(String(error45));
+      const errorMessage = lastError.message.toLowerCase();
       consecutiveFailures++;
       const retryable = isRetryableError(error45);
-      if (consecutiveFailures >= RECOVERY_CONFIG.failureThreshold && RECOVERY_CONFIG.enabled) {
+      const isUnexpectedError = errorMessage.includes("unexpected error");
+      if (isUnexpectedError && !restartAttempted && RECOVERY_CONFIG.enabled) {
+        console.warn(`[agent-mail] "${toolName}" got unexpected error, restarting server immediately...`);
+        restartAttempted = true;
+        const restarted = await restartServer();
+        if (restarted) {
+          agentMailAvailable = null;
+          consecutiveFailures = 0;
+          await new Promise((resolve) => setTimeout(resolve, 1000));
+          attempt--;
+          continue;
+        }
+      }
+      if (!isUnexpectedError && consecutiveFailures >= RECOVERY_CONFIG.failureThreshold && RECOVERY_CONFIG.enabled && !restartAttempted) {
         console.warn(`[agent-mail] ${consecutiveFailures} consecutive failures, checking server health...`);
         const healthy = await isServerFunctional();
         if (!healthy) {
           console.warn("[agent-mail] Server unhealthy, attempting restart...");
+          restartAttempted = true;
           const restarted = await restartServer();
           if (restarted) {
             agentMailAvailable = null;
@@ -23007,24 +23023,57 @@ var agentmail_init = tool({
         fallback: "Swarm will continue without multi-agent coordination. File conflicts possible if multiple agents active."
       }, null, 2);
     }
-    const project = await mcpCall("ensure_project", {
-      human_key: args.project_path
-    });
-    const agent = await mcpCall("register_agent", {
-      project_key: args.project_path,
-      program: "opencode",
-      model: "claude-opus-4",
-      name: args.agent_name,
-      task_description: args.task_description || ""
-    });
-    const state = {
-      projectKey: args.project_path,
-      agentName: agent.name,
-      reservations: [],
-      startedAt: new Date().toISOString()
-    };
-    setState(ctx.sessionID, state);
-    return JSON.stringify({ project, agent, available: true }, null, 2);
+    const MAX_INIT_RETRIES = 3;
+    let lastError = null;
+    for (let attempt = 1;attempt <= MAX_INIT_RETRIES; attempt++) {
+      try {
+        const project = await mcpCall("ensure_project", {
+          human_key: args.project_path
+        });
+        const agent = await mcpCall("register_agent", {
+          project_key: args.project_path,
+          program: "opencode",
+          model: "claude-opus-4",
+          name: args.agent_name,
+          task_description: args.task_description || ""
+        });
+        const state = {
+          projectKey: args.project_path,
+          agentName: agent.name,
+          reservations: [],
+          startedAt: new Date().toISOString()
+        };
+        setState(ctx.sessionID, state);
+        if (attempt > 1) {
+          console.warn(`[agent-mail] Init succeeded on attempt ${attempt} after restart`);
+        }
+        return JSON.stringify({ project, agent, available: true }, null, 2);
+      } catch (error45) {
+        lastError = error45 instanceof Error ? error45 : new Error(String(error45));
+        const isUnexpectedError = lastError.message.toLowerCase().includes("unexpected error");
+        console.warn(`[agent-mail] Init attempt ${attempt}/${MAX_INIT_RETRIES} failed: ${lastError.message}`);
+        if (isUnexpectedError && attempt < MAX_INIT_RETRIES) {
+          console.warn("[agent-mail] Detected 'unexpected error', restarting server...");
+          const restarted = await restartServer();
+          if (restarted) {
+            agentMailAvailable = null;
+            consecutiveFailures = 0;
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+            continue;
+          }
+        }
+        if (!isUnexpectedError) {
+          break;
+        }
+      }
+    }
+    return JSON.stringify({
+      error: `Agent Mail init failed after ${MAX_INIT_RETRIES} attempts`,
+      available: false,
+      lastError: lastError?.message,
+      hint: "Manually restart Agent Mail: pkill -f agent-mail && agent-mail serve",
+      fallback: "Swarm will continue without multi-agent coordination."
+    }, null, 2);
   }
 });
 var agentmail_send = tool({
@@ -23230,7 +23279,11 @@ var agentmail_health = tool({
     try {
       const response = await fetch(`${AGENT_MAIL_URL}/health/liveness`);
       if (response.ok) {
-        return "Agent Mail is running";
+        const functional = await isServerFunctional();
+        if (functional) {
+          return "Agent Mail is running and functional";
+        }
+        return "Agent Mail health OK but MCP not responding - consider restart";
       }
       return `Agent Mail returned status ${response.status}`;
     } catch (error45) {
@@ -23238,6 +23291,41 @@ var agentmail_health = tool({
     }
   }
 });
+var agentmail_restart = tool({
+  description: "Manually restart Agent Mail server (use when getting 'unexpected error')",
+  args: {
+    force: tool.schema.boolean().optional().describe("Force restart even if server appears healthy (default: false)")
+  },
+  async execute(args) {
+    if (!args.force) {
+      const functional = await isServerFunctional();
+      if (functional) {
+        return JSON.stringify({
+          restarted: false,
+          reason: "Server is functional, no restart needed",
+          hint: "Use force=true to restart anyway"
+        }, null, 2);
+      }
+    }
+    console.warn("[agent-mail] Manual restart requested...");
+    const success2 = await restartServer();
+    agentMailAvailable = null;
+    consecutiveFailures = 0;
+    if (success2) {
+      return JSON.stringify({
+        restarted: true,
+        success: true,
+        message: "Agent Mail server restarted successfully"
+      }, null, 2);
+    }
+    return JSON.stringify({
+      restarted: true,
+      success: false,
+      error: "Restart attempted but server did not come back up",
+      hint: "Check server logs or manually start: agent-mail serve"
+    }, null, 2);
+  }
+});
 var agentMailTools = {
   agentmail_init,
   agentmail_send,
@@ -23248,7 +23336,8 @@ var agentMailTools = {
   agentmail_release,
   agentmail_ack,
   agentmail_search,
-  agentmail_health
+  agentmail_health,
+  agentmail_restart
 };
 
 // src/structured.ts
@@ -23664,6 +23753,24 @@ var CriterionWeightSchema = exports_external.object({
   last_validated: exports_external.string().optional(),
   half_life_days: exports_external.number().positive().default(90)
 });
+var ErrorTypeSchema = exports_external.enum([
+  "validation",
+  "timeout",
+  "conflict",
+  "tool_failure",
+  "unknown"
+]);
+var ErrorEntrySchema = exports_external.object({
+  id: exports_external.string(),
+  bead_id: exports_external.string(),
+  error_type: ErrorTypeSchema,
+  message: exports_external.string(),
+  stack_trace: exports_external.string().optional(),
+  tool_name: exports_external.string().optional(),
+  timestamp: exports_external.string(),
+  resolved: exports_external.boolean().default(false),
+  context: exports_external.string().optional()
+});
 var DecompositionStrategySchema = exports_external.enum([
   "file-based",
   "feature-based",
@@ -23753,6 +23860,118 @@ class InMemoryFeedbackStorage {
   }
 }
 
+class InMemoryErrorStorage {
+  errors = [];
+  async store(entry) {
+    this.errors.push(entry);
+  }
+  async getByBead(beadId) {
+    return this.errors.filter((e) => e.bead_id === beadId);
+  }
+  async getUnresolvedByBead(beadId) {
+    return this.errors.filter((e) => e.bead_id === beadId && !e.resolved);
+  }
+  async markResolved(id) {
+    const error45 = this.errors.find((e) => e.id === id);
+    if (error45) {
+      error45.resolved = true;
+    }
+  }
+  async getAll() {
+    return [...this.errors];
+  }
+}
+
+class ErrorAccumulator {
+  storage;
+  constructor(storage) {
+    this.storage = storage ?? new InMemoryErrorStorage;
+  }
+  async recordError(beadId, errorType, message, options) {
+    const entry = {
+      id: `${beadId}-${errorType}-${Date.now()}`,
+      bead_id: beadId,
+      error_type: errorType,
+      message,
+      stack_trace: options?.stack_trace,
+      tool_name: options?.tool_name,
+      timestamp: new Date().toISOString(),
+      resolved: false,
+      context: options?.context
+    };
+    const validated = ErrorEntrySchema.parse(entry);
+    await this.storage.store(validated);
+    return validated;
+  }
+  async getErrors(beadId) {
+    return this.storage.getByBead(beadId);
+  }
+  async getUnresolvedErrors(beadId) {
+    return this.storage.getUnresolvedByBead(beadId);
+  }
+  async resolveError(errorId) {
+    await this.storage.markResolved(errorId);
+  }
+  async getErrorContext(beadId, includeResolved = false) {
+    const errors3 = includeResolved ? await this.getErrors(beadId) : await this.getUnresolvedErrors(beadId);
+    if (errors3.length === 0) {
+      return "";
+    }
+    const byType = errors3.reduce((acc, err) => {
+      const type = err.error_type;
+      if (!acc[type]) {
+        acc[type] = [];
+      }
+      acc[type].push(err);
+      return acc;
+    }, {});
+    const lines = [
+      "## Previous Errors",
+      "",
+      "The following errors were encountered during execution:",
+      ""
+    ];
+    for (const [type, typeErrors] of Object.entries(byType)) {
+      lines.push(`### ${type} (${typeErrors.length} error${typeErrors.length > 1 ? "s" : ""})`);
+      lines.push("");
+      for (const err of typeErrors) {
+        lines.push(`- **${err.message}**`);
+        if (err.context) {
+          lines.push(`  - Context: ${err.context}`);
+        }
+        if (err.tool_name) {
+          lines.push(`  - Tool: ${err.tool_name}`);
+        }
+        if (err.stack_trace) {
+          lines.push(`  - Stack: \`${err.stack_trace.slice(0, 100)}...\``);
+        }
+        lines.push(`  - Time: ${new Date(err.timestamp).toLocaleString()}${err.resolved ? " (resolved)" : ""}`);
+        lines.push("");
+      }
+    }
+    lines.push("**Action Required**: Address these errors before proceeding. Consider:");
+    lines.push("- What caused each error?");
+    lines.push("- How can you prevent similar errors?");
+    lines.push("- Are there patterns across error types?");
+    lines.push("");
+    return lines.join(`
+`);
+  }
+  async getErrorStats(beadId) {
+    const allErrors = await this.getErrors(beadId);
+    const unresolved = await this.getUnresolvedErrors(beadId);
+    const byType = allErrors.reduce((acc, err) => {
+      acc[err.error_type] = (acc[err.error_type] || 0) + 1;
+      return acc;
+    }, {});
+    return {
+      total: allErrors.length,
+      unresolved: unresolved.length,
+      by_type: byType
+    };
+  }
+}
+
 // src/swarm.ts
 var POSITIVE_MARKERS = [
   "always",
@@ -24163,6 +24382,10 @@ Only modify these files. Need others? Message the coordinator.
 ## Context
 {shared_context}
 
+{compressed_context}
+
+{error_context}
+
 ## MANDATORY: Use These Tools
 
 ### Agent Mail - communicate with the swarm
@@ -24196,7 +24419,9 @@ Begin now.`;
 function formatSubtaskPromptV2(params) {
   const fileList = params.files.length > 0 ? params.files.map((f) => `- \`${f}\``).join(`
 `) : "(no specific files - use judgment)";
-  return SUBTASK_PROMPT_V2.replace(/{bead_id}/g, params.bead_id).replace(/{epic_id}/g, params.epic_id).replace("{subtask_title}", params.subtask_title).replace("{subtask_description}", params.subtask_description || "(see title)").replace("{file_list}", fileList).replace("{shared_context}", params.shared_context || "(none)");
+  const compressedSection = params.compressed_context ? params.compressed_context : "";
+  const errorSection = params.error_context ? params.error_context : "";
+  return SUBTASK_PROMPT_V2.replace(/{bead_id}/g, params.bead_id).replace(/{epic_id}/g, params.epic_id).replace("{subtask_title}", params.subtask_title).replace("{subtask_description}", params.subtask_description || "(see title)").replace("{file_list}", fileList).replace("{shared_context}", params.shared_context || "(none)").replace("{compressed_context}", compressedSection).replace("{error_context}", errorSection);
 }
 var EVALUATION_PROMPT = `Evaluate the work completed for this subtask.
 
@@ -24902,6 +25127,7 @@ var swarm_record_outcome = tool({
     };
     const validated = OutcomeSignalsSchema.parse(signals);
     const scored = scoreImplicitFeedback(validated, DEFAULT_LEARNING_CONFIG);
+    const errorStats = await globalErrorAccumulator.getErrorStats(args.bead_id);
     const criteriaToScore = args.criteria ?? [
       "type_safe",
       "no_bugs",
@@ -24913,6 +25139,10 @@ var swarm_record_outcome = tool({
       if (args.strategy) {
         event.context = `${event.context || ""} [strategy: ${args.strategy}]`.trim();
       }
+      if (errorStats.total > 0) {
+        const errorSummary = Object.entries(errorStats.by_type).map(([type, count]) => `${type}:${count}`).join(", ");
+        event.context = `${event.context || ""} [errors: ${errorSummary}]`.trim();
+      }
       return event;
     });
     return JSON.stringify({
@@ -24926,13 +25156,16 @@ var swarm_record_outcome = tool({
         }
       },
       feedback_events: feedbackEvents,
+      error_patterns: errorStats,
       summary: {
         feedback_type: scored.type,
         duration_seconds: Math.round(args.duration_ms / 1000),
         error_count: args.error_count ?? 0,
         retry_count: args.retry_count ?? 0,
         success: args.success,
-        strategy: args.strategy
+        strategy: args.strategy,
+        accumulated_errors: errorStats.total,
+        unresolved_errors: errorStats.unresolved
       },
       note: "Feedback events should be stored for criterion weight calculation. Use learning.ts functions to apply weights."
     }, null, 2);
@@ -25102,6 +25335,70 @@ var swarm_evaluation_prompt = tool({
     }, null, 2);
   }
 });
+var globalErrorAccumulator = new ErrorAccumulator;
+var swarm_accumulate_error = tool({
+  description: "Record an error during subtask execution. Errors feed into retry prompts.",
+  args: {
+    bead_id: tool.schema.string().describe("Bead ID where error occurred"),
+    error_type: tool.schema.enum(["validation", "timeout", "conflict", "tool_failure", "unknown"]).describe("Category of error"),
+    message: tool.schema.string().describe("Human-readable error message"),
+    stack_trace: tool.schema.string().optional().describe("Stack trace for debugging"),
+    tool_name: tool.schema.string().optional().describe("Tool that failed"),
+    context: tool.schema.string().optional().describe("What was happening when error occurred")
+  },
+  async execute(args) {
+    const entry = await globalErrorAccumulator.recordError(args.bead_id, args.error_type, args.message, {
+      stack_trace: args.stack_trace,
+      tool_name: args.tool_name,
+      context: args.context
+    });
+    return JSON.stringify({
+      success: true,
+      error_id: entry.id,
+      bead_id: entry.bead_id,
+      error_type: entry.error_type,
+      message: entry.message,
+      timestamp: entry.timestamp,
+      note: "Error recorded for retry context. Use swarm_get_error_context to retrieve accumulated errors."
+    }, null, 2);
+  }
+});
+var swarm_get_error_context = tool({
+  description: "Get accumulated errors for a bead. Returns formatted context for retry prompts.",
+  args: {
+    bead_id: tool.schema.string().describe("Bead ID to get errors for"),
+    include_resolved: tool.schema.boolean().optional().describe("Include resolved errors (default: false)")
+  },
+  async execute(args) {
+    const errorContext = await globalErrorAccumulator.getErrorContext(args.bead_id, args.include_resolved ?? false);
+    const stats = await globalErrorAccumulator.getErrorStats(args.bead_id);
+    return JSON.stringify({
+      bead_id: args.bead_id,
+      error_context: errorContext,
+      stats: {
+        total_errors: stats.total,
+        unresolved: stats.unresolved,
+        by_type: stats.by_type
+      },
+      has_errors: errorContext.length > 0,
+      usage: "Inject error_context into retry prompt using {error_context} placeholder"
+    }, null, 2);
+  }
+});
+var swarm_resolve_error = tool({
+  description: "Mark an error as resolved after fixing it. Updates error accumulator state.",
+  args: {
+    error_id: tool.schema.string().describe("Error ID to mark as resolved")
+  },
+  async execute(args) {
+    await globalErrorAccumulator.resolveError(args.error_id);
+    return JSON.stringify({
+      success: true,
+      error_id: args.error_id,
+      resolved: true
+    }, null, 2);
+  }
+});
 var swarm_init = tool({
   description: "Initialize swarm session and check tool availability. Call at swarm start to see what features are available.",
   args: {
@@ -25163,7 +25460,10 @@ var swarmTools = {
   swarm_subtask_prompt,
   swarm_spawn_subtask,
   swarm_complete_subtask,
-  swarm_evaluation_prompt
+  swarm_evaluation_prompt,
+  swarm_accumulate_error,
+  swarm_get_error_context,
+  swarm_resolve_error
 };
 // src/anti-patterns.ts
 var PatternKindSchema = exports_external.enum(["pattern", "anti_pattern"]);