claude-code-swarm 0.3.20 → 0.3.21

package/.claude-plugin/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-swarm",
-  "version": "0.3.20",
+  "version": "0.3.21",
   "description": "Launch Claude Code with swarmkit capabilities, including team orchestration, MAP observability, and session tracking.",
   "owner": {
     "name": "alexngai"

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-swarm",
   "description": "Spin up Claude Code agent teams from openteams YAML topologies with optional MAP (Multi-Agent Protocol) observability and coordination. Provides hooks for session lifecycle, agent spawn/complete tracking, and a /swarm skill to launch team configurations.",
-  "version": "0.3.20",
+  "version": "0.3.21",
   "author": {
     "name": "alexngai"
   },

package/CLAUDE.md

@@ -398,6 +398,15 @@ Both modes:
 - Report trajectory checkpoints via `trajectory/checkpoint` (with broadcast fallback)
 - Self-terminate after 30 minutes of inactivity (session mode)
 
+**MAP capabilities declared** (in `src/map-connection.mjs`):
+- `messaging: { canSend: true, canReceive: true }` — can exchange MAP scope messages
+- `mail: { canCreate: true, canJoin: true, canViewHistory: true }` — supports agent-inbox conversations (enables Mail chat mode in OpenHive session view)
+- `trajectory: { canReport: true, canServeContent: true }` — reports checkpoints, serves transcript content on demand
+- `tasks: { canCreate, canAssign, canUpdate, canList }` — task management
+- `opentasks: { canQuery, canLink, canAnnotate, canTask }` — conditional, when task_graph configured
+
+Message delivery is **pull-based**: the `UserPromptSubmit` hook reads the inbox on each turn and injects messages into Claude Code's prompt context. No real-time push delivery.
+
 The hook helper (`scripts/map-hook.mjs`) includes best-effort auto-recovery: if the sidecar is down, it attempts to restart it, with a fire-and-forget fallback (mesh or direct WebSocket) if recovery fails.
 
 ### OpenTasks integration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-swarm",
-  "version": "0.3.20",
+  "version": "0.3.21",
   "description": "Claude Code plugin for launching agent teams from openteams topologies with MAP observability",
   "type": "module",
   "exports": {

package/scripts/map-sidecar.mjs

@@ -224,6 +224,7 @@ function startSlowReconnectLoop() {
         systemId: SYSTEM_ID,
         credential: AUTH_CREDENTIAL || undefined,
         projectContext: PROJECT_CONTEXT,
+        inboxEnabled: !!INBOX_CONFIG || MESH_ENABLED,
         onMessage: () => resetInactivityTimer(),
       });
 
@@ -409,6 +410,7 @@ async function startWebSocketTransport() {
     systemId: SYSTEM_ID,
     credential: AUTH_CREDENTIAL || undefined,
     projectContext: PROJECT_CONTEXT,
+    inboxEnabled: !!INBOX_CONFIG || MESH_ENABLED,
     onMessage: () => {
       resetInactivityTimer();
     },

package/src/map-connection.mjs

@@ -24,7 +24,7 @@ const log = createLogger("map");
  *   authRequired challenge with the server's preferred method + this credential.
  *   When absent, uses the standard SDK connect() for open mode servers.
  */
-export async function connectToMAP({ server, scope, systemId, onMessage, credential, projectContext }) {
+export async function connectToMAP({ server, scope, systemId, onMessage, credential, projectContext, inboxEnabled }) {
   try {
     const mapSdk = await resolvePackage("@multi-agent-protocol/sdk");
     if (!mapSdk) throw new Error("@multi-agent-protocol/sdk not available");
@@ -38,6 +38,12 @@ export async function connectToMAP({ server, scope, systemId, onMessage, credent
       role: "sidecar",
       scopes: [scope],
       capabilities: {
+        // Messaging and mail capabilities are conditional on agent-inbox being available.
+        // Without inbox, the sidecar can't receive messages or participate in conversations.
+        ...(inboxEnabled ? {
+          messaging: { canSend: true, canReceive: true },
+          mail: { canCreate: true, canJoin: true, canViewHistory: true },
+        } : {}),
         trajectory: { canReport: true, canServeContent: true },
         tasks: { canCreate: true, canAssign: true, canUpdate: true, canList: true },
         ...(projectContext?.task_graph ? {