@mclawnet/swarm 0.1.4 → 0.1.6

package/dist/inbox-relay.js

@@ -0,0 +1,168 @@
+import { InboxStore } from "./inbox-store.js";
+import { createLogger } from "@mclawnet/logger";
+const log = createLogger({ module: "swarm/inbox-relay" });
+/**
+ * Escape a string for safe inclusion as an XML/HTML attribute value
+ * (between double quotes). Order matters: `&` must be replaced first.
+ */
+function escapeXmlAttr(s) {
+    return s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/**
+ * Escape body text so embedded `</message>` / `</info_for_agent>` cannot
+ * close the wrapping envelope. Only `<` and `&` need escaping for that.
+ */
+function escapeXmlText(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;");
+}
+/**
+ * Wrap a batch of inbox messages into a single <info_for_agent> envelope.
+ * Host→agent direction; message body is free-form text per design §6.
+ */
+function wrapAgentBlock(msgs) {
+    const body = msgs
+        .map((m) => {
+        const taskAttr = m.taskId ? ` taskId="${escapeXmlAttr(m.taskId)}"` : "";
+        return `<message from="${escapeXmlAttr(m.from)}" type="${escapeXmlAttr(m.type)}"${taskAttr} id="${escapeXmlAttr(m.id)}">\n${escapeXmlText(m.data)}\n</message>`;
+    })
+        .join("\n");
+    return `\n<info_for_agent>\n${body}\n</info_for_agent>\n`;
+}
+/**
+ * InboxRelay: pushes inbox messages to the target agent.
+ *
+ * Task 7: 4 gates implemented in runDeliver (liveness, lifecycle, single-flight,
+ * pending-echo). Single-flight gate sits in deliver(); the other three live
+ * inside runDeliver().
+ *
+ * Task 8 will fill in onAgentTurnSettled() to flush pendingEchoes and
+ * markDelivered() in the InboxStore.
+ */
+export class InboxRelay {
+    sessionAdapter;
+    getSwarm;
+    messageInterceptor;
+    home;
+    inFlight = new Map();
+    // key → set of messageIds already pushed but awaiting turn-settled ack.
+    pendingEchoes = new Map();
+    constructor(sessionAdapter, getSwarm, messageInterceptor, 
+    // Optional override for the user-home root (no `.clawnet` suffix).
+    // Threaded down to InboxStore so tests pinned to a tmpdir don't fall
+    // through to `homedir()` and write inbox files into the real `~/.clawnet`.
+    home) {
+        this.sessionAdapter = sessionAdapter;
+        this.getSwarm = getSwarm;
+        this.messageInterceptor = messageInterceptor;
+        this.home = home;
+    }
+    key(swarmId, instanceId) {
+        return `${swarmId}::${instanceId}`;
+    }
+    async deliver(swarmId, instanceId) {
+        const k = this.key(swarmId, instanceId);
+        const cur = this.inFlight.get(k);
+        if (cur)
+            return cur;
+        const p = this.runDeliver(swarmId, instanceId).finally(() => {
+            this.inFlight.delete(k);
+        });
+        this.inFlight.set(k, p);
+        return p;
+    }
+    async runDeliver(swarmId, instanceId) {
+        // Gate 1: liveness — swarm and role must exist with a workDir.
+        const swarm = this.getSwarm(swarmId);
+        if (!swarm || !swarm.workDir)
+            return;
+        const role = swarm.roles.get(instanceId);
+        if (!role)
+            return;
+        // Gate 2: lifecycle — skip agents that are still spawning or already stopped.
+        if (role.status === "spawning" || role.status === "stopped")
+            return;
+        // Read undelivered inbox.
+        const store = new InboxStore(swarm.workDir, swarmId, this.home);
+        const undelivered = await store.readUndelivered(instanceId);
+        if (undelivered.length === 0)
+            return;
+        // Interceptor pass — give the coordinator a chance to consume system
+        // envelopes (plan_review_result etc.) before they reach the LLM. A
+        // consumed message is filtered out of the LLM payload AND marked
+        // delivered so it does not re-fire on subsequent passes. Throwing
+        // interceptors are demoted to no-ops (fail open: message still flows).
+        const consumedIds = [];
+        const survived = [];
+        for (const m of undelivered) {
+            let consumed = false;
+            if (this.messageInterceptor) {
+                try {
+                    consumed = await this.messageInterceptor(swarmId, instanceId, m);
+                }
+                catch (err) {
+                    log.warn({ err, swarmId, instanceId, msgId: m.id, msgType: m.type }, "messageInterceptor threw — falling back to default delivery");
+                    consumed = false;
+                }
+            }
+            if (consumed)
+                consumedIds.push(m.id);
+            else
+                survived.push(m);
+        }
+        // Persist consumption so consumed messages don't re-fire next pass.
+        if (consumedIds.length > 0) {
+            try {
+                await store.markDelivered(instanceId, consumedIds);
+            }
+            catch (err) {
+                log.warn({ err, swarmId, instanceId, count: consumedIds.length }, "markDelivered for consumed messages failed (best-effort)");
+            }
+        }
+        if (survived.length === 0)
+            return;
+        // Gate 3: pending-echo — drop messages already pushed but not yet ack'd.
+        const k = this.key(swarmId, instanceId);
+        const pending = this.pendingEchoes.get(k) ?? new Set();
+        const toPush = survived.filter((m) => !pending.has(m.id));
+        if (toPush.length === 0)
+            return;
+        // Push as a single <info_for_agent> envelope.
+        const payload = wrapAgentBlock(toPush);
+        this.sessionAdapter.sendInput(role.roleSessionId, payload);
+        for (const m of toPush)
+            pending.add(m.id);
+        this.pendingEchoes.set(k, pending);
+    }
+    /**
+     * Called when the host receives a `result` event signalling the agent
+     * finished a turn. Marks all messages currently in pendingEchoes as
+     * `delivered=true` in the InboxStore, clears the pending set, then triggers
+     * another deliver pass to flush any messages that arrived during the turn.
+     *
+     * Order: delete-before-mark — protects against (a) the next runDeliver
+     * stealing entries from pendingEchoes mid-flight, and (b) markDelivered
+     * throwing leaving stale ids in pendingEchoes (the inbox stays
+     * delivered=false so the next deliver re-pushes; markDelivered is idempotent).
+     */
+    async onAgentTurnSettled(swarmId, instanceId) {
+        const k = this.key(swarmId, instanceId);
+        const pending = this.pendingEchoes.get(k);
+        if (!pending || pending.size === 0)
+            return;
+        const swarm = this.getSwarm(swarmId);
+        if (!swarm?.workDir) {
+            this.pendingEchoes.delete(k);
+            return;
+        }
+        const ids = [...pending];
+        this.pendingEchoes.delete(k);
+        const store = new InboxStore(swarm.workDir, swarmId, this.home);
+        await store.markDelivered(instanceId, ids);
+        void this.deliver(swarmId, instanceId);
+    }
+}
+//# sourceMappingURL=inbox-relay.js.map

package/dist/inbox-relay.js.map

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

package/dist/inbox-store.d.ts

@@ -0,0 +1,25 @@
+export interface InboxMessage {
+    id: string;
+    from: string;
+    type: string;
+    data: string;
+    taskId?: string;
+    timestamp: number;
+    delivered: boolean;
+    deliveredAt?: number;
+}
+export declare class InboxStore {
+    private workDir;
+    private swarmId;
+    private homeOverride?;
+    constructor(workDir: string, swarmId: string, homeOverride?: string | undefined);
+    private home;
+    private inboxesDir;
+    private validateInstanceId;
+    inboxFile(instanceId: string): string;
+    readAll(instanceId: string): Promise<InboxMessage[]>;
+    append(instanceId: string, msg: InboxMessage): Promise<void>;
+    readUndelivered(instanceId: string): Promise<InboxMessage[]>;
+    markDelivered(instanceId: string, ids: string[]): Promise<void>;
+}
+//# sourceMappingURL=inbox-store.d.ts.map

package/dist/inbox-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-store.d.ts","sourceRoot":"","sources":["../src/inbox-store.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,UAAU;IAQnB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,YAAY,CAAC;gBAFb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,YAAA;IAG/B,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,kBAAkB;IAM1B,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAK/B,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUpD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI5D,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBtE"}

package/dist/inbox-store.js

@@ -0,0 +1,95 @@
+import { join } from "node:path";
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { projectRoot } from "@mclawnet/task";
+import lockfile from "proper-lockfile";
+const LOCK_OPTS = {
+    realpath: false,
+    retries: { retries: 50, minTimeout: 20, maxTimeout: 200 },
+};
+export class InboxStore {
+    workDir;
+    swarmId;
+    homeOverride;
+    // `home` is the user-home root (no `.clawnet` suffix). projectRoot() adds
+    // `.clawnet/projects/...` itself. When omitted we honour CLAWNET_HOME first,
+    // then fall back to the OS home — matches TaskStore for symmetry. Callers
+    // that already plumb a `rootDir` through ToolContext should pass it here so
+    // their writes land inside the test harness's tempdir instead of the real
+    // `~/.clawnet/projects/...`.
+    constructor(workDir, swarmId, homeOverride) {
+        this.workDir = workDir;
+        this.swarmId = swarmId;
+        this.homeOverride = homeOverride;
+    }
+    home() {
+        return this.homeOverride ?? process.env.CLAWNET_HOME ?? homedir();
+    }
+    inboxesDir() {
+        return join(projectRoot(this.workDir, this.home()), "swarms", this.swarmId, "inboxes");
+    }
+    validateInstanceId(id) {
+        if (!id || /[\\/]|\.\./.test(id) || id.includes("\0")) {
+            throw new Error(`InboxStore: invalid instanceId: ${JSON.stringify(id)}`);
+        }
+    }
+    inboxFile(instanceId) {
+        this.validateInstanceId(instanceId);
+        return join(this.inboxesDir(), `${instanceId}.json`);
+    }
+    async readAll(instanceId) {
+        const fp = this.inboxFile(instanceId);
+        if (!existsSync(fp))
+            return [];
+        try {
+            return JSON.parse(readFileSync(fp, "utf-8"));
+        }
+        catch {
+            return [];
+        }
+    }
+    async append(instanceId, msg) {
+        mkdirSync(this.inboxesDir(), { recursive: true });
+        const fp = this.inboxFile(instanceId);
+        if (!existsSync(fp))
+            writeFileSync(fp, "[]");
+        const release = await lockfile.lock(fp, LOCK_OPTS);
+        try {
+            const cur = JSON.parse(readFileSync(fp, "utf-8"));
+            if (cur.some(m => m.id === msg.id))
+                return;
+            cur.push(msg);
+            writeFileSync(fp, JSON.stringify(cur, null, 2));
+        }
+        finally {
+            await release();
+        }
+    }
+    async readUndelivered(instanceId) {
+        return (await this.readAll(instanceId)).filter(m => !m.delivered);
+    }
+    async markDelivered(instanceId, ids) {
+        if (ids.length === 0)
+            return;
+        const fp = this.inboxFile(instanceId);
+        if (!existsSync(fp))
+            return;
+        const release = await lockfile.lock(fp, LOCK_OPTS);
+        try {
+            const cur = JSON.parse(readFileSync(fp, "utf-8"));
+            const set = new Set(ids);
+            const now = Date.now();
+            for (const m of cur) {
+                if (set.has(m.id) && !m.delivered) {
+                    m.delivered = true;
+                    m.deliveredAt = now;
+                }
+            }
+            writeFileSync(fp, JSON.stringify(cur, null, 2));
+        }
+        finally {
+            await release();
+        }
+    }
+}
+//# sourceMappingURL=inbox-store.js.map

package/dist/inbox-store.js.map

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

package/dist/inbox-watcher.d.ts

@@ -0,0 +1,13 @@
+export interface InboxRelayLike {
+    deliver(swarmId: string, instanceId: string): Promise<void> | void;
+}
+export declare class InboxWatcher {
+    private relay;
+    private swarms;
+    constructor(relay: InboxRelayLike);
+    watch(swarmId: string, workDir: string): void;
+    unwatch(swarmId: string): void;
+    close(): void;
+    private schedule;
+}
+//# sourceMappingURL=inbox-watcher.d.ts.map

package/dist/inbox-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-watcher.d.ts","sourceRoot":"","sources":["../src/inbox-watcher.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpE;AAiBD,qBAAa,YAAY;IAGX,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,MAAM,CAAiC;gBAE3B,KAAK,EAAE,cAAc;IAEzC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA6B7C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS9B,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/inbox-watcher.js

@@ -0,0 +1,89 @@
+import { mkdirSync, watch } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { createLogger } from "@mclawnet/logger";
+import { projectRoot as taskProjectRoot } from "@mclawnet/task";
+const log = createLogger({ module: "swarm/inbox-watcher" });
+const DEBOUNCE_MS = 50;
+const VALID_ID_RE = /^[A-Za-z0-9_.-]+$/;
+// Use the canonical layout from @mclawnet/task so the watcher observes the
+// same directory the InboxStore writes into. Previously this used a local
+// `join(home, "projects", ...)` (missing `.clawnet`), which silently created
+// phantom dirs at ~/projects/... while real inboxes lived at ~/.clawnet/...,
+// so fs.watch never fired and task_assigned messages stayed delivered:false.
+function projectRoot(workDir) {
+    const home = process.env.CLAWNET_HOME ?? homedir();
+    return taskProjectRoot(workDir, home);
+}
+export class InboxWatcher {
+    relay;
+    swarms = new Map();
+    constructor(relay) {
+        this.relay = relay;
+    }
+    watch(swarmId, workDir) {
+        if (this.swarms.has(swarmId))
+            return;
+        const dir = join(projectRoot(workDir), "swarms", swarmId, "inboxes");
+        try {
+            mkdirSync(dir, { recursive: true });
+        }
+        catch (err) {
+            log.warn({ err, swarmId, dir }, "inbox-watcher: mkdir failed");
+            return;
+        }
+        let fsw;
+        try {
+            fsw = watch(dir, { persistent: false }, (_evt, filename) => {
+                if (!filename)
+                    return;
+                const name = String(filename);
+                if (!name.endsWith(".json"))
+                    return;
+                const id = name.slice(0, -".json".length);
+                if (!VALID_ID_RE.test(id))
+                    return;
+                this.schedule(swarmId, id);
+            });
+        }
+        catch (err) {
+            log.warn({ err, swarmId, dir }, "inbox-watcher: fs.watch failed");
+            return;
+        }
+        fsw.on("error", (err) => {
+            log.warn({ err, swarmId }, "inbox-watcher: fs.watch error");
+        });
+        this.swarms.set(swarmId, { watcher: fsw, timers: new Map() });
+    }
+    unwatch(swarmId) {
+        const entry = this.swarms.get(swarmId);
+        if (!entry)
+            return;
+        for (const t of entry.timers.values())
+            clearTimeout(t);
+        entry.timers.clear();
+        try {
+            entry.watcher.close();
+        }
+        catch { /* ignore */ }
+        this.swarms.delete(swarmId);
+    }
+    close() {
+        for (const swarmId of [...this.swarms.keys()])
+            this.unwatch(swarmId);
+    }
+    schedule(swarmId, instanceId) {
+        const entry = this.swarms.get(swarmId);
+        if (!entry)
+            return;
+        const existing = entry.timers.get(instanceId);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            entry.timers.delete(instanceId);
+            Promise.resolve(this.relay.deliver(swarmId, instanceId)).catch(() => { });
+        }, DEBOUNCE_MS);
+        entry.timers.set(instanceId, timer);
+    }
+}
+//# sourceMappingURL=inbox-watcher.js.map

package/dist/inbox-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-watcher.js","sourceRoot":"","sources":["../src/inbox-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAkB,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;AAE5D,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAWxC,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC;IACnD,OAAO,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,OAAO,YAAY;IAGH;IAFZ,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE/C,YAAoB,KAAqB;QAArB,UAAK,GAAL,KAAK,CAAgB;IAAG,CAAC;IAE7C,KAAK,CAAC,OAAe,EAAE,OAAe;QACpC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,OAAO;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,6BAA6B,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QACD,IAAI,GAAc,CAAC;QACnB,IAAI,CAAC;YACH,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;gBACzD,IAAI,CAAC,QAAQ;oBAAE,OAAO;gBACtB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,OAAO;gBACpC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC1C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBAAE,OAAO;gBAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,gCAAgC,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QACD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACtB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,+BAA+B,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACvD,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC;YAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,CAAC;IAEO,QAAQ,CAAC,OAAe,EAAE,UAAkB;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAChC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC3E,CAAC,EAAE,WAAW,CAAC,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,15 +1,20 @@
 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, parseRoleFile } from "./roles/role-loader.js";
 export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, readMessageLog, listRecoverableSwarmIds, } from "./persistence.js";
 export type { SwarmSnapshot } from "./persistence.js";
 export { runRetrospective } from "./retrospective.js";
 export type { RetrospectiveResult, RoleEvaluation } from "./retrospective.js";
 export { listRecoverableSwarms, recoverSwarm } from "./recovery.js";
+export { InboxStore } from "./inbox-store.js";
+export type { InboxMessage } from "./inbox-store.js";
+export { InboxRelay } from "./inbox-relay.js";
+export { InboxWatcher, type InboxRelayLike as InboxWatcherRelayLike } from "./inbox-watcher.js";
 export type { SessionAdapter, HubAdapter, SwarmInstance, RoleInstance, SwarmAction, SwarmMessage, SwarmCreateOptions, RouteEndpoint, SwarmStatus, PlanStatus, } from "./types.js";
 export type { RoleDefinition, DelegationMap, DelegationEntry } from "./roles/types.js";
 export { initTemplates, listTemplates, loadTemplate } from "./templates/template-loader.js";
 export type { TemplateDefinition, TemplateRoleSpec } from "./templates/types.js";
+export { listProjectDirs, resolveWorkDir, loadProjectSummary, loadSwarmSummaries, listAllProjectSummaries, } from "./projects-fs.js";
+export type { TaskStatus, TaskCounts, ProjectSummary, SwarmSummary, } from "./projects-fs.js";
+export { PROJECT_FILE_WHITELIST, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, ProjectFilesError, } from "./project-files.js";
+export type { ProjectFileRelPath, ProjectFileEntry, ProjectFileContent, } from "./project-files.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,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,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,IAAI,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhG,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,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC5F,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,10 +1,13 @@
 // @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, parseRoleFile } from "./roles/role-loader.js";
 export { saveSwarmSnapshot, loadSwarmSnapshot, deleteSwarmSnapshot, appendMessageLog, readMessageLog, listRecoverableSwarmIds, } from "./persistence.js";
 export { runRetrospective } from "./retrospective.js";
 export { listRecoverableSwarms, recoverSwarm } from "./recovery.js";
+export { InboxStore } from "./inbox-store.js";
+export { InboxRelay } from "./inbox-relay.js";
+export { InboxWatcher } from "./inbox-watcher.js";
 export { initTemplates, listTemplates, loadTemplate } from "./templates/template-loader.js";
+export { listProjectDirs, resolveWorkDir, loadProjectSummary, loadSwarmSummaries, listAllProjectSummaries, } from "./projects-fs.js";
+export { PROJECT_FILE_WHITELIST, isWhitelistedRelPath, listProjectFiles, readProjectFile, writeProjectFile, ProjectFilesError, } from "./project-files.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiBpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC"}
+{"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,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAgD,MAAM,oBAAoB,CAAC;AAiBhG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG5F,OAAO,EACL,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/persistence.d.ts

@@ -3,22 +3,36 @@ export interface SwarmSnapshot {
     id: string;
     hubSessionId: string;
     workDir?: string;
+    teamName: string;
     roles: Array<{
         instanceId: string;
         roleName: string;
         status: string;
         currentTask?: string;
+        claudeSessionId?: string;
+        type?: "queen" | "worker";
     }>;
     plan: unknown;
     nextInstanceSeq: Record<string, number>;
     savedAt: number;
     status?: SwarmStatus;
     planStatus?: PlanStatus;
+    partialRecover?: boolean;
 }
 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 readMessageLog(swarmId: string): object[];
-export declare function appendMessageLog(swarmId: string, entry: object): void;
-export declare function listRecoverableSwarmIds(): string[];
+export declare function loadSwarmSnapshot(workDir: string, swarmId: string): SwarmSnapshot | null;
+export declare function deleteSwarmSnapshot(workDir: string, swarmId: string): void;
+export declare function readMessageLog(workDir: string, swarmId: string): object[];
+export declare function appendMessageLog(workDir: string, swarmId: string, entry: object): void;
+/**
+ * List recoverable swarms across all per-project roots. The authoritative
+ * `workDir` is read from each snapshot's `workDir` field (snapshots written
+ * since 0.1.6 always include it). Falling back on the encoded directory
+ * name is lossy for paths whose segments contain `-`, so we deliberately
+ * skip entries whose snapshot can't be parsed or doesn't carry `workDir`.
+ */
+export declare function listRecoverableSwarmIds(): Array<{
+    workDir: string;
+    swarmId: string;
+}>;
 //# sourceMappingURL=persistence.d.ts.map

package/dist/persistence.d.ts.map

@@ -1 +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,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAMlD"}
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgBzE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,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;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;KAC3B,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;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CA2C5D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAgBxF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAK1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBzE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAItF;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAyCrF"}