claude-code-swarm 0.3.3 → 0.3.5

package/src/context-output.mjs

@@ -12,9 +12,14 @@ import fs from "fs";
  */
 export function formatBootstrapContext({
   template,
+  team,
   mapStatus,
   sessionlogStatus,
   sessionlogSync,
+  opentasksStatus,
+  inboxEnabled,
+  minimemStatus,
+  skilltreeStatus,
 }) {
   const lines = ["## Claude Code Swarm", ""];
 
@@ -40,7 +45,45 @@ export function formatBootstrapContext({
     }
   }
 
+  if (opentasksStatus) {
+    lines.push(`Opentasks: ${opentasksStatus}`);
+    if (opentasksStatus === "connected" || opentasksStatus === "enabled") {
+      lines.push("Use **opentasks MCP tools** (opentasks__create_task, opentasks__update_task, opentasks__list_tasks) for task management instead of native TaskCreate/TaskUpdate/TaskList.");
+    }
+  }
+
+  if (inboxEnabled) {
+    lines.push("Inbox: enabled (agent-inbox messaging)");
+  }
+
+  if (minimemStatus && minimemStatus !== "disabled") {
+    lines.push(`Memory: ${minimemStatus}`);
+    if (minimemStatus === "ready") {
+      lines.push("Use **minimem MCP tools** (minimem__memory_search, minimem__knowledge_search) to recall past decisions and context.");
+    }
+  }
+
+  if (skilltreeStatus && skilltreeStatus !== "disabled") {
+    lines.push(`Skills: ${skilltreeStatus} (per-role loadouts from team.yaml)`);
+  }
+
   lines.push("");
+
+  if (team) {
+    // Embed the SKILL.md content directly so the agent has the topology immediately
+    const skillPath = `${team.outputDir}/SKILL.md`;
+    try {
+      const skillContent = fs.readFileSync(skillPath, "utf-8");
+      lines.push(skillContent);
+      lines.push("");
+    } catch {
+      // SKILL.md not readable — just show the path
+    }
+
+    lines.push(`Agent prompts: \`${team.outputDir}/agents/<role>.md\``);
+    lines.push("");
+  }
+
   lines.push(
     "Use `/swarm` to launch the team (creates a native Claude Code team)."
   );
@@ -53,7 +96,7 @@ export function formatBootstrapContext({
 /**
  * Format the team-loaded context output.
  */
-export function formatTeamLoadedContext(generatedDir, templatePath, teamName) {
+export function formatTeamLoadedContext(generatedDir, templatePath, teamName, { opentasksStatus } = {}) {
   const lines = ["## Claude Code Swarm — Team Loaded", ""];
 
   // Include the catalog if available
@@ -78,13 +121,13 @@ export function formatTeamLoadedContext(generatedDir, templatePath, teamName) {
     "1. Call **TeamCreate** to set up a native Claude Code team"
   );
   lines.push(
-    "2. Spawn a **coordinator agent** (the root role) as a team member with `team_name`"
+    "2. Create tasks via **TaskCreate** based on the user's goal"
   );
   lines.push(
-    "3. The coordinator creates tasks via **TaskCreate** and spawns agents with `team_name`"
+    "3. Spawn agents directly as teammates (only you can spawn — teammates cannot spawn other teammates)"
   );
   lines.push(
-    "4. All agents coordinate via **SendMessage** and track progress via **TaskUpdate**"
+    "4. Coordinate the team via **SendMessage** and track progress via **TaskUpdate**"
   );
   lines.push("");
   lines.push(
@@ -96,10 +139,17 @@ export function formatTeamLoadedContext(generatedDir, templatePath, teamName) {
   lines.push("");
   lines.push("### Coordination");
   lines.push("");
-  lines.push("This team uses Claude Code's native team features:");
-  lines.push("- **TaskCreate/TaskUpdate** for task lifecycle");
-  lines.push("- **SendMessage** for agent-to-agent communication");
-  lines.push("- **TeamCreate** for team setup");
+  if (opentasksStatus === "connected" || opentasksStatus === "enabled") {
+    lines.push("This team uses **opentasks MCP tools** for task management:");
+    lines.push("- **opentasks__create_task / opentasks__update_task / opentasks__list_tasks** for task lifecycle");
+    lines.push("- **SendMessage** for agent-to-agent communication");
+    lines.push("- **TeamCreate** for team setup");
+  } else {
+    lines.push("This team uses Claude Code's native team features:");
+    lines.push("- **TaskCreate/TaskUpdate** for task lifecycle");
+    lines.push("- **SendMessage** for agent-to-agent communication");
+    lines.push("- **TeamCreate** for team setup");
+  }
   lines.push("");
   lines.push(
     "**MAP (if enabled):** Lifecycle events are emitted for external observability."

package/src/inbox.mjs

@@ -1,56 +1,9 @@
 /**
- * inbox.mjs — MAP inbox management for claude-code-swarm
+ * inbox.mjs — Inbox formatting for claude-code-swarm
  *
- * Handles reading, formatting, clearing, and writing the inbox.jsonl file
- * that bridges MAP messages into Claude's context.
+ * Provides markdown formatting for messages retrieved via agent-inbox IPC.
  */
 
-import fs from "fs";
-import { INBOX_PATH } from "./paths.mjs";
-
-/**
- * Read and parse all messages from the inbox.
- * Returns an array of parsed message objects. Never throws.
- */
-export function readInbox(inboxPath = INBOX_PATH) {
-  try {
-    const content = fs.readFileSync(inboxPath, "utf-8").trim();
-    if (!content) return [];
-
-    const messages = [];
-    for (const line of content.split("\n")) {
-      if (!line.trim()) continue;
-      try {
-        messages.push(JSON.parse(line));
-      } catch {
-        // Skip malformed lines
-      }
-    }
-    return messages;
-  } catch {
-    return [];
-  }
-}
-
-/**
- * Clear the inbox file.
- */
-export function clearInbox(inboxPath = INBOX_PATH) {
-  try {
-    fs.writeFileSync(inboxPath, "");
-  } catch {
-    // Non-critical
-  }
-}
-
-/**
- * Append a message to the inbox as an NDJSON line.
- * Used by the sidecar to write incoming MAP messages.
- */
-export function writeToInbox(message, inboxPath = INBOX_PATH) {
-  fs.appendFileSync(inboxPath, JSON.stringify(message) + "\n");
-}
-
 /**
  * Format inbox messages as markdown for injection into Claude's context.
  * Returns empty string if no messages.
@@ -65,17 +18,19 @@ export function formatInboxAsMarkdown(messages) {
   ];
 
   for (const msg of messages) {
-    const from = msg.from || "unknown";
-    const age = msg.timestamp
-      ? formatAge(now - new Date(msg.timestamp).getTime())
+    const from = msg.from || msg.sender_id || "unknown";
+    const age = msg.timestamp || msg.created_at
+      ? formatAge(now - new Date(msg.timestamp || msg.created_at).getTime())
       : "unknown";
-    const priority = msg.meta?.priority;
-    const payload = msg.payload || {};
+    const priority = msg.meta?.priority || msg.importance;
+    const payload = msg.payload || msg.content || {};
 
     lines.push(`**From ${from}** (${age} ago)`);
 
     if (typeof payload === "string") {
       lines.push(`> ${payload}`);
+    } else if (payload.type === "text" && payload.text) {
+      lines.push(`> ${payload.text}`);
     } else if (payload.type) {
       lines.push(
         `> [${payload.type}] ${payload.description || payload.message || JSON.stringify(payload)}`

package/src/index.mjs

@@ -3,33 +3,41 @@
  */
 
 // Config
-export { readConfig, resolveScope, resolveTeamName, DEFAULTS } from "./config.mjs";
+export { readConfig, resolveScope, resolveTeamName, resolveMapServer, DEFAULTS } from "./config.mjs";
 
 // Paths
 export {
   SWARM_DIR,
   SOCKET_PATH,
-  INBOX_PATH,
   PID_PATH,
   ROLES_PATH,
   SESSIONLOG_STATE_PATH,
   CONFIG_PATH,
+  GLOBAL_CONFIG_DIR,
+  GLOBAL_CONFIG_PATH,
   SESSIONLOG_DIR,
   TMP_DIR,
   TEAMS_DIR,
   MAP_DIR,
   SIDECAR_LOG_PATH,
+  IS_GLOBAL_PATHS,
+  OPENTASKS_DIR,
+  OPENTASKS_SYNC_STATE_PATH,
   teamDir,
   ensureSwarmDir,
   ensureMapDir,
+  ensureOpentasksDir,
   pluginDir,
+  sessionPaths,
+  ensureSessionDir,
+  listSessionDirs,
 } from "./paths.mjs";
 
 // Roles
 export { readRoles, matchRole, writeRoles } from "./roles.mjs";
 
 // Inbox
-export { readInbox, clearInbox, writeToInbox, formatInboxAsMarkdown, formatAge } from "./inbox.mjs";
+export { formatInboxAsMarkdown, formatAge } from "./inbox.mjs";
 
 // Context output
 export {
@@ -42,6 +50,9 @@ export {
 // MAP connection
 export { connectToMAP, fireAndForget, fireAndForgetTrajectory } from "./map-connection.mjs";
 
+// Mesh connection
+export { createMeshPeer, createMeshInbox, meshFireAndForget } from "./mesh-connection.mjs";
+
 // Sidecar client
 export { sendToSidecar, isSidecarAlive, startSidecar, killSidecar, ensureSidecar } from "./sidecar-client.mjs";
 
@@ -52,14 +63,17 @@ export { createSocketServer, createCommandHandler, respond } from "./sidecar-ser
 export {
   sendCommand,
   emitPayload,
-  buildSpawnCommand,
-  buildDoneCommand,
   buildSubagentSpawnCommand,
   buildSubagentDoneCommand,
   buildStateCommand,
-  buildTaskDispatchedPayload,
-  buildTaskCompletedPayload,
-  buildTaskStatusPayload,
+  handleTaskCreated,
+  handleTaskCompleted,
+  handleTaskStatusCompleted,
+  buildTaskSyncPayload,
+  buildOpentasksBridgeCommands,
+  mapNativeTaskStatus,
+  handleNativeTaskCreatedEvent,
+  handleNativeTaskUpdatedEvent,
 } from "./map-events.mjs";
 
 // Sessionlog
@@ -76,6 +90,7 @@ export {
   listAvailableTemplates,
   readTeamManifest,
   generateTeamArtifacts,
+  loadTeam,
 } from "./template.mjs";
 
 // Agent generator
@@ -94,5 +109,21 @@ export {
   resolveSwarmkit,
 } from "./swarmkit-resolver.mjs";
 
+// opentasks client
+export {
+  findSocketPath,
+  rpcRequest,
+  isDaemonAlive,
+  ensureDaemon,
+  pushSyncEvent,
+} from "./opentasks-client.mjs";
+
+// Skill-tree client
+export {
+  parseSkillTreeExtension,
+  compileRoleLoadout,
+  compileAllRoleLoadouts,
+} from "./skilltree-client.mjs";
+
 // Bootstrap
 export { bootstrap } from "./bootstrap.mjs";

package/src/map-connection.mjs

@@ -5,7 +5,7 @@
  * for when the sidecar is unavailable.
  */
 
-import { resolveScope, resolveTeamName, DEFAULTS } from "./config.mjs";
+import { resolveScope, resolveTeamName, resolveMapServer, DEFAULTS } from "./config.mjs";
 
 /**
  * Connect to a MAP server as an agent.
@@ -24,6 +24,7 @@ export async function connectToMAP({ server, scope, systemId, onMessage }) {
       scopes: [scope],
       capabilities: {
         trajectory: { canReport: true },
+        tasks: { canCreate: true, canAssign: true, canUpdate: true, canList: true },
       },
       metadata: {
         systemId,
@@ -60,7 +61,7 @@ export async function connectToMAP({ server, scope, systemId, onMessage }) {
 export async function fireAndForget(config, event) {
   try {
     const { AgentConnection } = await import("@multi-agent-protocol/sdk");
-    const server = config.map?.server || DEFAULTS.mapServer;
+    const server = resolveMapServer(config);
     const scope = resolveScope(config);
     const teamName = resolveTeamName(config);
 
@@ -84,7 +85,7 @@ export async function fireAndForget(config, event) {
 export async function fireAndForgetTrajectory(config, checkpoint) {
   try {
     const { AgentConnection } = await import("@multi-agent-protocol/sdk");
-    const server = config.map?.server || DEFAULTS.mapServer;
+    const server = resolveMapServer(config);
     const scope = resolveScope(config);
     const teamName = resolveTeamName(config);