@mclawnet/swarm 0.1.0

package/dist/action-parser.d.ts

@@ -0,0 +1,16 @@
+import type { SwarmAction } from "./types.js";
+/**
+ * Parse ```swarm code blocks from Claude output text.
+ * Returns extracted actions and the text with swarm blocks removed.
+ */
+export declare function parseSwarmActions(text: string): {
+    actions: SwarmAction[];
+    cleanText: string;
+};
+/**
+ * Extract a plan object from Queen's output text.
+ * Queen outputs plans in ```json code blocks with { "plan": { ... } } format.
+ * Also handles inline JSON (no code block) containing a "plan" key.
+ */
+export declare function parsePlanFromText(text: string): unknown | null;
+//# sourceMappingURL=action-parser.d.ts.map

package/dist/action-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-parser.d.ts","sourceRoot":"","sources":["../src/action-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAC/C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAqBA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAqC9D"}

package/dist/action-parser.js

@@ -0,0 +1,81 @@
+/**
+ * Parse ```swarm code blocks from Claude output text.
+ * Returns extracted actions and the text with swarm blocks removed.
+ */
+export function parseSwarmActions(text) {
+    const actions = [];
+    const swarmBlockRegex = /```swarm\s*\n([\s\S]*?)```/g;
+    let match;
+    while ((match = swarmBlockRegex.exec(text)) !== null) {
+        const jsonStr = match[1].trim();
+        try {
+            const parsed = JSON.parse(jsonStr);
+            if (parsed && typeof parsed.action === "string") {
+                actions.push(parsed);
+            }
+        }
+        catch {
+            // Malformed JSON in swarm block — skip
+        }
+    }
+    // Remove swarm blocks from text for clean display
+    const cleanText = text.replace(swarmBlockRegex, "").trim();
+    return { actions, cleanText };
+}
+/**
+ * Extract a plan object from Queen's output text.
+ * Queen outputs plans in ```json code blocks with { "plan": { ... } } format.
+ * Also handles inline JSON (no code block) containing a "plan" key.
+ */
+export function parsePlanFromText(text) {
+    // Try ```json code blocks first
+    const jsonBlockRegex = /```json\s*\n([\s\S]*?)```/g;
+    let match;
+    while ((match = jsonBlockRegex.exec(text)) !== null) {
+        const plan = tryExtractPlan(match[1].trim());
+        if (plan)
+            return plan;
+    }
+    // Try inline JSON containing "plan" key (Queen sometimes outputs without code block)
+    // Use a bracket-balancing approach to extract complete JSON objects
+    const planKeyIdx = text.indexOf('"plan"');
+    if (planKeyIdx !== -1) {
+        // Find the opening brace before "plan"
+        let startIdx = text.lastIndexOf("{", planKeyIdx);
+        if (startIdx !== -1) {
+            // Balance braces to find the complete JSON object
+            let depth = 0;
+            let endIdx = startIdx;
+            for (let i = startIdx; i < text.length; i++) {
+                if (text[i] === "{")
+                    depth++;
+                else if (text[i] === "}") {
+                    depth--;
+                    if (depth === 0) {
+                        endIdx = i + 1;
+                        break;
+                    }
+                }
+            }
+            if (depth === 0 && endIdx > startIdx) {
+                const plan = tryExtractPlan(text.slice(startIdx, endIdx));
+                if (plan)
+                    return plan;
+            }
+        }
+    }
+    return null;
+}
+function tryExtractPlan(jsonStr) {
+    try {
+        const parsed = JSON.parse(jsonStr);
+        if (parsed && typeof parsed === "object" && parsed.plan && typeof parsed.plan === "object") {
+            return parsed.plan;
+        }
+    }
+    catch {
+        // Not valid JSON — skip
+    }
+    return null;
+}
+//# sourceMappingURL=action-parser.js.map

package/dist/action-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-parser.js","sourceRoot":"","sources":["../src/action-parser.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { SwarmCoordinator } from "./swarm-coordinator.js";
+export { LocalMessageRouter } from "./message-router.js";
+export type { MessageRouter } from "./message-router.js";
+export { parseSwarmActions } from "./action-parser.js";
+export { initRoles, loadRole, listRoles, buildRolePrompt } from "./roles/role-loader.js";
+export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, listRecoverableSwarmIds, } from "./persistence.js";
+export type { SwarmSnapshot } from "./persistence.js";
+export { listRecoverableSwarms, recoverSwarm } from "./recovery.js";
+export type { SessionAdapter, HubAdapter, SwarmInstance, RoleInstance, SwarmAction, SwarmMessage, SwarmCreateOptions, RouteEndpoint, SwarmStatus, PlanStatus, } from "./types.js";
+export type { RoleDefinition } from "./roles/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEpE,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// @mclawnet/swarm — Swarm coordination, message routing, and role management
+export { SwarmCoordinator } from "./swarm-coordinator.js";
+export { LocalMessageRouter } from "./message-router.js";
+export { parseSwarmActions } from "./action-parser.js";
+export { initRoles, loadRole, listRoles, buildRolePrompt } from "./roles/role-loader.js";
+export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, listRecoverableSwarmIds, } from "./persistence.js";
+export { listRecoverableSwarms, recoverSwarm } from "./recovery.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/message-router.d.ts

@@ -0,0 +1,33 @@
+import type { SessionAdapter } from "./types.js";
+import type { SwarmMessage, RouteEndpoint } from "./types.js";
+/**
+ * Abstract message router — decouples communication from transport.
+ * LocalMessageRouter uses stdin/stdout via SessionAdapter.
+ * Future RemoteMessageRouter can use Hub WebSocket relay.
+ */
+export interface MessageRouter {
+    /** Send a message to a specific role instance */
+    send(targetInstanceId: string, message: SwarmMessage): void;
+    /** Broadcast a message to all active role instances */
+    broadcast(message: SwarmMessage, excludeInstanceId?: string): void;
+    /** Register a role instance in the routing table */
+    register(instanceId: string, endpoint: RouteEndpoint): void;
+    /** Unregister a role instance */
+    unregister(instanceId: string): void;
+    /** Check if a route exists */
+    has(instanceId: string): boolean;
+}
+/**
+ * Routes messages to local Claude CLI processes via SessionAdapter.sendInput().
+ */
+export declare class LocalMessageRouter implements MessageRouter {
+    private sessionAdapter;
+    private routes;
+    constructor(sessionAdapter: SessionAdapter);
+    send(targetInstanceId: string, message: SwarmMessage): void;
+    broadcast(message: SwarmMessage, excludeInstanceId?: string): void;
+    register(instanceId: string, endpoint: RouteEndpoint): void;
+    unregister(instanceId: string): void;
+    has(instanceId: string): boolean;
+}
+//# sourceMappingURL=message-router.d.ts.map

package/dist/message-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.d.ts","sourceRoot":"","sources":["../src/message-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAO9D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5D,uDAAuD;IACvD,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnE,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAE5D,iCAAiC;IACjC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,8BAA8B;IAC9B,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAID;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAG1C,OAAO,CAAC,cAAc;IAFlC,OAAO,CAAC,MAAM,CAAoC;gBAE9B,cAAc,EAAE,cAAc;IAElD,IAAI,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAgB3D,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI;IAQlE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI3D,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIpC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAGjC"}

package/dist/message-router.js

@@ -0,0 +1,54 @@
+import { createLogger } from "@mclawnet/logger";
+const log = createLogger({ module: "swarm/router" });
+// ── Local Implementation ────────────────────────────────────────────
+/**
+ * Routes messages to local Claude CLI processes via SessionAdapter.sendInput().
+ */
+export class LocalMessageRouter {
+    sessionAdapter;
+    routes = new Map();
+    constructor(sessionAdapter) {
+        this.sessionAdapter = sessionAdapter;
+    }
+    send(targetInstanceId, message) {
+        const endpoint = this.routes.get(targetInstanceId);
+        if (!endpoint) {
+            log.warn({ targetInstanceId }, "no route found");
+            return;
+        }
+        if (endpoint.kind === "local") {
+            const formatted = formatMessageForClaude(message);
+            this.sessionAdapter.sendInput(endpoint.roleSessionId, formatted);
+        }
+        else {
+            // Remote routing — not yet implemented
+            log.warn({ targetInstanceId }, "remote routing not yet implemented");
+        }
+    }
+    broadcast(message, excludeInstanceId) {
+        for (const [instanceId] of this.routes) {
+            if (instanceId !== excludeInstanceId) {
+                this.send(instanceId, message);
+            }
+        }
+    }
+    register(instanceId, endpoint) {
+        this.routes.set(instanceId, endpoint);
+    }
+    unregister(instanceId) {
+        this.routes.delete(instanceId);
+    }
+    has(instanceId) {
+        return this.routes.has(instanceId);
+    }
+}
+// ── Formatting ──────────────────────────────────────────────────────
+function formatMessageForClaude(message) {
+    const parts = [];
+    parts.push(`[来自 ${message.from}]`);
+    if (message.taskId)
+        parts.push(`(任务: ${message.taskId})`);
+    parts.push(message.data);
+    return parts.join(" ");
+}
+//# sourceMappingURL=message-router.js.map

package/dist/message-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.js","sourceRoot":"","sources":["../src/message-router.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;AA0BrD,uEAAuE;AAEvE;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAGT;IAFZ,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;IAElD,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,IAAI,CAAC,gBAAwB,EAAE,OAAqB;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,gBAAgB,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,uCAAuC;YACvC,GAAG,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,EAAE,oCAAoC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAED,SAAS,CAAC,OAAqB,EAAE,iBAA0B;QACzD,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvC,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,UAAkB,EAAE,QAAuB;QAClD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAC,UAAkB;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,UAAkB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;CACF;AAED,uEAAuE;AAEvE,SAAS,sBAAsB,CAAC,OAAqB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/persistence.d.ts

@@ -0,0 +1,23 @@
+import type { SwarmInstance, SwarmStatus, PlanStatus } from "./types.js";
+export interface SwarmSnapshot {
+    id: string;
+    hubSessionId: string;
+    workDir?: string;
+    roles: Array<{
+        instanceId: string;
+        roleName: string;
+        status: string;
+        currentTask?: string;
+    }>;
+    plan: unknown;
+    nextInstanceSeq: Record<string, number>;
+    savedAt: number;
+    status?: SwarmStatus;
+    planStatus?: PlanStatus;
+}
+export declare function saveSwarmSnapshot(swarm: SwarmInstance): void;
+export declare function loadSwarmSnapshot(swarmId: string): SwarmSnapshot | null;
+export declare function deleteSwarmSnapshot(swarmId: string): void;
+export declare function appendMessageLog(swarmId: string, entry: object): void;
+export declare function listRecoverableSwarmIds(): string[];
+//# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAUzE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAoB5D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQvE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAKzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAMlD"}

package/dist/persistence.js

@@ -0,0 +1,61 @@
+import { writeFileSync, readFileSync, existsSync, mkdirSync, appendFileSync, rmSync, readdirSync, } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+function getSwarmsDir() {
+    return join(homedir(), ".clawnet", "swarms");
+}
+function getSwarmDir(swarmId) {
+    return join(getSwarmsDir(), swarmId);
+}
+export function saveSwarmSnapshot(swarm) {
+    const dir = getSwarmDir(swarm.id);
+    mkdirSync(dir, { recursive: true });
+    const snapshot = {
+        id: swarm.id,
+        hubSessionId: swarm.hubSessionId,
+        workDir: swarm.workDir,
+        roles: Array.from(swarm.roles.values()).map((r) => ({
+            instanceId: r.instanceId,
+            roleName: r.roleName,
+            status: r.status,
+            currentTask: r.currentTask,
+        })),
+        plan: swarm.plan,
+        nextInstanceSeq: Object.fromEntries(swarm.nextInstanceSeq),
+        savedAt: Date.now(),
+        status: swarm.status,
+        planStatus: swarm.planStatus,
+    };
+    writeFileSync(join(dir, "recovery.json"), JSON.stringify(snapshot, null, 2));
+}
+export function loadSwarmSnapshot(swarmId) {
+    const filePath = join(getSwarmDir(swarmId), "recovery.json");
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function deleteSwarmSnapshot(swarmId) {
+    const dir = getSwarmDir(swarmId);
+    if (existsSync(dir)) {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+export function appendMessageLog(swarmId, entry) {
+    const dir = getSwarmDir(swarmId);
+    mkdirSync(dir, { recursive: true });
+    appendFileSync(join(dir, "messages.jsonl"), JSON.stringify(entry) + "\n");
+}
+export function listRecoverableSwarmIds() {
+    const dir = getSwarmsDir();
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((e) => e.isDirectory() && existsSync(join(dir, e.name, "recovery.json")))
+        .map((e) => e.name);
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"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"}

package/dist/recovery.d.ts

@@ -0,0 +1,5 @@
+import type { SwarmCoordinator } from "./swarm-coordinator.js";
+import { type SwarmSnapshot } from "./persistence.js";
+export declare function listRecoverableSwarms(): SwarmSnapshot[];
+export declare function recoverSwarm(coordinator: SwarmCoordinator, snapshot: SwarmSnapshot): Promise<void>;
+//# sourceMappingURL=recovery.d.ts.map

package/dist/recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAI1B,wBAAgB,qBAAqB,IAAI,aAAa,EAAE,CAUvD;AAED,wBAAsB,YAAY,CAChC,WAAW,EAAE,gBAAgB,EAC7B,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/recovery.js

@@ -0,0 +1,36 @@
+import { loadSwarmSnapshot, listRecoverableSwarmIds, } from "./persistence.js";
+const RECOVERY_TTL_MS = 24 * 60 * 60 * 1000; // 24h
+export function listRecoverableSwarms() {
+    const now = Date.now();
+    return listRecoverableSwarmIds()
+        .map((id) => loadSwarmSnapshot(id))
+        .filter((s) => {
+        if (!s)
+            return false;
+        if (now - s.savedAt > RECOVERY_TTL_MS)
+            return false;
+        const status = s.status ?? "running"; // old snapshots default to running
+        return status === "running" || status === "paused";
+    });
+}
+export async function recoverSwarm(coordinator, snapshot) {
+    await coordinator.create(snapshot.hubSessionId, {
+        workDir: snapshot.workDir,
+        roles: snapshot.roles.map((r) => ({ roleName: r.roleName })),
+    });
+    const swarm = coordinator.getSwarm(snapshot.hubSessionId);
+    if (swarm) {
+        if (snapshot.plan) {
+            swarm.plan = snapshot.plan;
+        }
+        // Recovered swarms start paused — user must explicitly resume
+        swarm.status = "paused";
+        swarm.isPaused = true;
+        // Clear the timer that create() started — paused swarms don't need checks
+        if (swarm.checkTimer) {
+            clearTimeout(swarm.checkTimer);
+            swarm.checkTimer = undefined;
+        }
+    }
+}
+//# sourceMappingURL=recovery.js.map

package/dist/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../src/recovery.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,MAAM;AAEnD,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,uBAAuB,EAAE;SAC7B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;SAClC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE;QAChC,IAAI,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACrB,IAAI,GAAG,GAAG,CAAC,CAAC,OAAO,GAAG,eAAe;YAAE,OAAO,KAAK,CAAC;QACpD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,mCAAmC;QACzE,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,CAAC;IACrD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAA6B,EAC7B,QAAuB;IAEvB,MAAM,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE;QAC9C,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;KAC7D,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,8DAA8D;QAC9D,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;QACxB,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;QACtB,0EAA0E;QAC1E,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/roles/role-loader.d.ts

@@ -0,0 +1,16 @@
+import type { RoleDefinition } from "./types.js";
+/**
+ * Ensure user role directory exists and preset templates are copied.
+ * Returns the user roles directory path.
+ */
+export declare function initRoles(): string;
+/** Load a role definition by name. Reads from ~/.clawnet/roles/{name}/CLAUDE.md first, falls back to preset. */
+export declare function loadRole(roleName: string): RoleDefinition;
+/** List all available role names (from user dir + presets). */
+export declare function listRoles(): string[];
+/**
+ * Build the full system prompt for a role instance.
+ * Substitutes {instanceId} and {roleList} placeholders.
+ */
+export declare function buildRolePrompt(definition: RoleDefinition, instanceId: string, roleList: string): string;
+//# sourceMappingURL=role-loader.d.ts.map

package/dist/roles/role-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-loader.d.ts","sourceRoot":"","sources":["../../src/roles/role-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0CjD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAmBlC;AAED,gHAAgH;AAChH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAYzD;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAoBpC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,cAAc,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR"}

package/dist/roles/role-loader.js

@@ -0,0 +1,103 @@
+import { readFileSync, existsSync, mkdirSync, writeFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const PRESET_DIR = join(import.meta.dirname ?? __dirname, "../../roles");
+const USER_ROLES_DIR = join(homedir(), ".clawnet", "roles");
+/** Parse YAML frontmatter + markdown body from a role file. */
+function parseRoleFile(content) {
+    const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!fmMatch) {
+        throw new Error("Invalid role file: missing YAML frontmatter");
+    }
+    const frontmatter = fmMatch[1];
+    const body = fmMatch[2].trim();
+    // Simple YAML parser (no dependency) — handles flat key: value + arrays
+    const meta = {};
+    for (const line of frontmatter.split("\n")) {
+        const m = line.match(/^(\w+):\s*(.+)$/);
+        if (!m)
+            continue;
+        const [, key, rawVal] = m;
+        // Array value: [a, b, c]
+        const arrMatch = rawVal.match(/^\[(.*)\]$/);
+        if (arrMatch) {
+            meta[key] = arrMatch[1].split(",").map((s) => s.trim());
+        }
+        else {
+            // Strip surrounding quotes
+            meta[key] = rawVal.replace(/^["']|["']$/g, "");
+        }
+    }
+    return {
+        name: meta.name ?? "unknown",
+        shortName: meta.shortName ?? meta.name?.slice(0, 3) ?? "unk",
+        type: meta.type ?? "worker",
+        description: meta.description ?? "",
+        capabilities: Array.isArray(meta.capabilities) ? meta.capabilities : [],
+        color: meta.color ?? "#888888",
+        promptBody: body,
+    };
+}
+/**
+ * Ensure user role directory exists and preset templates are copied.
+ * Returns the user roles directory path.
+ */
+export function initRoles() {
+    mkdirSync(USER_ROLES_DIR, { recursive: true });
+    if (!existsSync(PRESET_DIR))
+        return USER_ROLES_DIR;
+    for (const file of readdirSync(PRESET_DIR)) {
+        if (!file.endsWith(".md"))
+            continue;
+        const roleName = file.replace(/\.md$/, "");
+        const userRoleDir = join(USER_ROLES_DIR, roleName);
+        const userFile = join(userRoleDir, "CLAUDE.md");
+        if (!existsSync(userFile)) {
+            mkdirSync(userRoleDir, { recursive: true });
+            const content = readFileSync(join(PRESET_DIR, file), "utf-8");
+            writeFileSync(userFile, content, "utf-8");
+        }
+    }
+    return USER_ROLES_DIR;
+}
+/** Load a role definition by name. Reads from ~/.clawnet/roles/{name}/CLAUDE.md first, falls back to preset. */
+export function loadRole(roleName) {
+    const userFile = join(USER_ROLES_DIR, roleName, "CLAUDE.md");
+    if (existsSync(userFile)) {
+        return parseRoleFile(readFileSync(userFile, "utf-8"));
+    }
+    const presetFile = join(PRESET_DIR, `${roleName}.md`);
+    if (existsSync(presetFile)) {
+        return parseRoleFile(readFileSync(presetFile, "utf-8"));
+    }
+    throw new Error(`Role not found: ${roleName}`);
+}
+/** List all available role names (from user dir + presets). */
+export function listRoles() {
+    const roles = new Set();
+    if (existsSync(USER_ROLES_DIR)) {
+        for (const entry of readdirSync(USER_ROLES_DIR, { withFileTypes: true })) {
+            if (entry.isDirectory() && existsSync(join(USER_ROLES_DIR, entry.name, "CLAUDE.md"))) {
+                roles.add(entry.name);
+            }
+        }
+    }
+    if (existsSync(PRESET_DIR)) {
+        for (const file of readdirSync(PRESET_DIR)) {
+            if (file.endsWith(".md")) {
+                roles.add(file.replace(/\.md$/, ""));
+            }
+        }
+    }
+    return [...roles].sort();
+}
+/**
+ * Build the full system prompt for a role instance.
+ * Substitutes {instanceId} and {roleList} placeholders.
+ */
+export function buildRolePrompt(definition, instanceId, roleList) {
+    return definition.promptBody
+        .replace(/\{instanceId\}/g, instanceId)
+        .replace(/\{roleList\}/g, roleList);
+}
+//# sourceMappingURL=role-loader.js.map

package/dist/roles/role-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-loader.js","sourceRoot":"","sources":["../../src/roles/role-loader.ts"],"names":[],"mappings":"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"}

package/dist/roles/types.d.ts

@@ -0,0 +1,18 @@
+/** Parsed role definition from a markdown + YAML frontmatter file. */
+export interface RoleDefinition {
+    /** Role template name, e.g. "developer" */
+    name: string;
+    /** Short name for instanceId prefix, e.g. "dev" */
+    shortName: string;
+    /** Role type */
+    type: "queen" | "worker";
+    /** Human-readable description */
+    description: string;
+    /** Capability tags */
+    capabilities: string[];
+    /** Badge color for UI */
+    color: string;
+    /** Full prompt body (markdown after frontmatter) */
+    promptBody: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/roles/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/roles/types.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/roles/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/roles/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/roles/types.ts"],"names":[],"mappings":""}

package/dist/swarm-coordinator.d.ts

@@ -0,0 +1,69 @@
+import type { SessionAdapter, HubAdapter } from "./types.js";
+import type { MessageRouter } from "./message-router.js";
+import type { SwarmInstance, RoleInstance, SwarmCreateOptions, CustomRoleDefinition } from "./types.js";
+/**
+ * SwarmCoordinator — orchestrates multi-role Claude CLI swarms.
+ *
+ * Composes (not replaces) SessionAdapter. Each role instance is a separate
+ * session in SessionAdapter. Communication between roles goes through
+ * MessageRouter (currently LocalMessageRouter using stdin/stdout).
+ */
+export declare class SwarmCoordinator {
+    private sessionAdapter;
+    private hub;
+    private swarms;
+    constructor(sessionAdapter: SessionAdapter, hub: HubAdapter);
+    /** Create a new swarm and spawn initial roles. */
+    create(swarmSessionId: string, options: SwarmCreateOptions): Promise<void>;
+    /** Handle user message directed at the swarm. */
+    handleUserMessage(swarmSessionId: string, content: string, targetInstance?: string): Promise<void>;
+    /**
+     * Handle output from a role's Claude CLI process.
+     * Called by the onOutput callback wired in start.ts.
+     *
+     * Returns true if the sessionId belongs to a swarm role.
+     */
+    handleRoleOutput(roleSessionId: string, data: unknown): boolean;
+    /**
+     * Handle turn completion from a role's Claude CLI process.
+     * Returns true if the sessionId belongs to a swarm role.
+     */
+    handleRoleTurnComplete(roleSessionId: string, info: {
+        claudeSessionId?: string;
+        cost?: number;
+        duration?: number;
+        contextUsage?: {
+            used: number;
+            total: number;
+        };
+    }): boolean;
+    /** Spawn a new role instance in a swarm. */
+    spawnRole(swarmId: string, roleName: string, router?: MessageRouter, taskPrompt?: string, customPrompt?: string, customDefinition?: CustomRoleDefinition): Promise<RoleInstance>;
+    /** Stop a role instance. */
+    stopRole(swarmId: string, instanceId: string): Promise<void>;
+    /** Destroy an entire swarm. */
+    destroy(swarmId: string): Promise<void>;
+    /** Check if a session ID belongs to any swarm. */
+    isSwarmSession(sessionId: string): boolean;
+    /** Check if a hub session ID is a swarm. */
+    hasSwarm(swarmSessionId: string): boolean;
+    /** Get a swarm instance by hub session ID. */
+    getSwarm(swarmSessionId: string): SwarmInstance | undefined;
+    /** Mark a swarm as completed. Releases all resources — closes sessions, deletes snapshot, removes from memory. */
+    complete(swarmId: string): Promise<void>;
+    /** Mark a swarm as failed. Releases all resources — closes sessions, deletes snapshot, removes from memory. */
+    fail(swarmId: string): Promise<void>;
+    private findQueen;
+    private findReviewer;
+    /** Send plan to reviewer for review. Auto-approves if no reviewer available. */
+    private requestPlanReview;
+    /** Handle plan review result from reviewer. */
+    private handlePlanReviewResult;
+    private findByRoleSessionId;
+    private executeAction;
+    private startQueenCheck;
+    private buildRoleListString;
+    private buildStatusPayload;
+    private sendStatusUpdate;
+}
+//# sourceMappingURL=swarm-coordinator.d.ts.map

package/dist/swarm-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-coordinator.d.ts","sourceRoot":"","sources":["../src/swarm-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EAGlB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAOpB;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,GAAG;IAJb,OAAO,CAAC,MAAM,CAAoC;gBAGxC,cAAc,EAAE,cAAc,EAC9B,GAAG,EAAE,UAAU;IAKzB,kDAAkD;IAC5C,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDhF,iDAAiD;IAC3C,iBAAiB,CACrB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;OAKG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAwD/D;;;OAGG;IACH,sBAAsB,CACpB,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACnH,OAAO;IAoBV,4CAA4C;IACtC,SAAS,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,aAAa,EACtB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,CAAC,EAAE,oBAAoB,GACtC,OAAO,CAAC,YAAY,CAAC;IAsExB,4BAA4B;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBlE,+BAA+B;IACzB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7C,kDAAkD;IAClD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI1C,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIzC,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3D,kHAAkH;IAC5G,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9C,+GAA+G;IACzG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1C,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,YAAY;IAOpB,gFAAgF;IAChF,OAAO,CAAC,iBAAiB;IA2CzB,+CAA+C;IAC/C,OAAO,CAAC,sBAAsB;IAyC9B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,aAAa;IAkHrB,OAAO,CAAC,eAAe;IA8DvB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,gBAAgB;CAWzB"}