opencode-swarm-plugin 0.18.0 → 0.20.0

package/package.json

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

package/src/agent-mail.ts

@@ -1,6 +1,19 @@
 /**
  * Agent Mail Module - MCP client for multi-agent coordination
  *
+ * ⚠️ DEPRECATED: This MCP-based implementation is deprecated as of v0.14.0.
+ *
+ * Use the embedded Swarm Mail implementation instead:
+ * - swarmmail_* tools in src/streams/swarm-mail.ts
+ * - No external MCP server required
+ * - Embedded PGLite with event sourcing
+ * - Better error messages and recovery
+ *
+ * This file remains for backward compatibility and will be removed in v1.0.0.
+ * See README.md "Migrating from MCP Agent Mail" section for migration guide.
+ *
+ * ---
+ *
  * This module provides type-safe wrappers around the Agent Mail MCP server.
  * It enforces context-preservation defaults to prevent session exhaustion.
  *
@@ -18,6 +31,7 @@ import { tool } from "@opencode-ai/plugin";
 import { z } from "zod";
 import { isToolAvailable, warnMissingTool } from "./tool-availability";
 import { getRateLimiter, type RateLimiter } from "./rate-limiter";
+import type { MailSessionState } from "./streams/events";
 
 // ============================================================================
 // Configuration
@@ -79,13 +93,12 @@ const RECOVERY_CONFIG = {
 // Types
 // ============================================================================
 
-/** Agent Mail session state */
-export interface AgentMailState {
-  projectKey: string;
-  agentName: string;
-  reservations: number[];
-  startedAt: string;
-}
+/**
+ * Agent Mail session state
+ * @deprecated Use MailSessionState from streams/events.ts instead
+ * This is kept for backward compatibility and re-exported as an alias
+ */
+export type AgentMailState = MailSessionState;
 
 // ============================================================================
 // Module-level state (keyed by sessionID)