hoomanjs 1.58.1 → 1.60.0

package/dist/daemon/mcproxy/index.js

@@ -0,0 +1,23 @@
+import { DaemonToolCatalog } from "./catalog.js";
+import { startDaemonMcpHttpServer } from "./http-server.js";
+import { createDaemonProxyServer } from "./session.js";
+/**
+ * Starts the daemon's local, loopback-only aggregate MCP tool proxy in front
+ * of the parent `Manager`'s already-connected upstream servers. Call once,
+ * after the parent has connected/subscribed to channels and before creating
+ * any ACP session; every daemon-hosted ACP session gets the one returned
+ * `mcpServer` entry instead of loading local `mcp.json`.
+ */
+export async function startDaemonMcpProxy(manager, options = {}) {
+    const catalog = new DaemonToolCatalog(manager);
+    const instructions = (await manager.listServerInstructions()).join("\n\n");
+    const handle = await startDaemonMcpHttpServer({
+        port: options.port ?? 0,
+        createSession: () => createDaemonProxyServer(catalog, instructions),
+    });
+    return {
+        mcpServer: { name: "daemon", type: "http", url: handle.url, headers: [] },
+        close: handle.close,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/daemon/mcproxy/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/daemon/mcproxy/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAgBvD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmB,EACnB,UAA6B,EAAE;IAE/B,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,CAAC,MAAM,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC;QAC5C,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;QACvB,aAAa,EAAE,GAAG,EAAE,CAAC,uBAAuB,CAAC,OAAO,EAAE,YAAY,CAAC;KACpE,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE;QACzE,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/daemon/mcproxy/session.d.ts

@@ -0,0 +1,9 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { DaemonToolCatalog } from "./catalog.js";
+/**
+ * One frontend MCP session for a daemon-hosted ACP child: a fresh low-level
+ * `Server` per HTTP initialize handshake, exposing only the aggregate tool
+ * catalog (no experimental channel capabilities — those stay on the parent's
+ * singleton upstream connections).
+ */
+export declare function createDaemonProxyServer(catalog: DaemonToolCatalog, instructions: string): Server;

package/dist/daemon/mcproxy/session.js

@@ -0,0 +1,24 @@
+import { readFileSync } from "node:fs";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const packageUrl = new URL("../../../package.json", import.meta.url);
+const packageVersion = JSON.parse(readFileSync(packageUrl, "utf8"))
+    .version ?? "0.0.0";
+/**
+ * One frontend MCP session for a daemon-hosted ACP child: a fresh low-level
+ * `Server` per HTTP initialize handshake, exposing only the aggregate tool
+ * catalog (no experimental channel capabilities — those stay on the parent's
+ * singleton upstream connections).
+ */
+export function createDaemonProxyServer(catalog, instructions) {
+    const server = new Server({ name: "hooman-daemon-mcproxy", version: packageVersion }, {
+        capabilities: { tools: {} },
+        instructions: instructions.length > 0 ? instructions : undefined,
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: await catalog.listTools(),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request, extra) => catalog.callTool(request.params.name, request.params.arguments, extra.signal));
+    return server;
+}
+//# sourceMappingURL=session.js.map

package/dist/daemon/mcproxy/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/daemon/mcproxy/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAG5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrE,MAAM,cAAc,GACjB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA0B;KACnE,OAAO,IAAI,OAAO,CAAC;AAExB;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA0B,EAC1B,YAAoB;IAEpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,cAAc,EAAE,EAC1D;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;KACjE,CACF,CAAC;IACF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE;KACjC,CAAC,CAAC,CAAC;IACJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACvE,OAAO,CAAC,QAAQ,CACd,OAAO,CAAC,MAAM,CAAC,IAAI,EACnB,OAAO,CAAC,MAAM,CAAC,SAAS,EACxB,KAAK,CAAC,MAAM,CACb,CACF,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/daemon/queue.d.ts

@@ -1,5 +1,14 @@
-import fastq from "fastq";
-import type { ChannelMessage } from "../core/mcp/index.js";
-type MessageQueue = fastq.queueAsPromised<ChannelMessage, void>;
-export declare function createQueue(handler: (message: ChannelMessage) => Promise<void>, cleanup: () => void): Promise<[MessageQueue, () => Promise<void>, () => void]>;
-export {};
+/**
+ * Serializes turns per external conversation key while allowing unrelated
+ * keys to run fully concurrently — replaces the old single global-concurrency
+ * queue now that many ACP sessions may be active at once.
+ */
+export declare class KeyedTurnQueue {
+    #private;
+    /** Number of tasks currently queued (including the one running, if any) for `key`. */
+    length(key: string): number;
+    /** Enqueues `task` behind any already-running/queued task for the same `key`. */
+    push(key: string, task: () => Promise<void>): void;
+    /** Waits for every currently queued task (across every key) to settle. */
+    drain(): Promise<void>;
+}

package/dist/daemon/queue.js

@@ -1,39 +1,46 @@
-import fastq from "fastq";
-export async function createQueue(handler, cleanup) {
-    let stopping = false;
-    let resolver = null;
-    const queue = fastq.promise(async (message) => {
-        await handler(message);
-    }, 1);
-    const stopper = new Promise((resolve) => {
-        resolver = resolve;
-    });
-    const shutdown = () => {
-        if (stopping) {
-            return;
-        }
-        stopping = true;
-        queue.kill();
-        resolver?.();
-    };
-    const onSigInt = () => shutdown();
-    const onSigTerm = () => shutdown();
-    process.on("SIGINT", onSigInt);
-    process.on("SIGTERM", onSigTerm);
-    return [
-        queue,
-        async () => {
+/**
+ * Serializes turns per external conversation key while allowing unrelated
+ * keys to run fully concurrently — replaces the old single global-concurrency
+ * queue now that many ACP sessions may be active at once.
+ */
+export class KeyedTurnQueue {
+    #tails = new Map();
+    /** Number of tasks currently queued (including the one running, if any) for `key`. */
+    length(key) {
+        return this.#tails.get(key)?.length ?? 0;
+    }
+    /** Enqueues `task` behind any already-running/queued task for the same `key`. */
+    push(key, task) {
+        const state = this.#tails.get(key) ?? {
+            length: 0,
+            tail: Promise.resolve(),
+        };
+        state.length += 1;
+        this.#tails.set(key, state);
+        // Swallow task rejections here: `state.tail` is chained with `.then()`,
+        // so a rejected tail would skip every subsequent `.then()` callback for
+        // this key, permanently poisoning the queue instead of just failing one
+        // turn. Callers that care about per-task failure (e.g. `runTurn`) already
+        // catch their own errors; this is a backstop against anything that slips
+        // past that.
+        state.tail = state.tail.then(async () => {
             try {
-                await stopper;
+                await task();
+            }
+            catch {
+                /* ignore: never poison the chain for this key */
             }
             finally {
-                cleanup();
-                await queue.drained().catch(() => { });
-                process.off("SIGINT", onSigInt);
-                process.off("SIGTERM", onSigTerm);
+                state.length -= 1;
+                if (state.length === 0) {
+                    this.#tails.delete(key);
+                }
             }
-        },
-        shutdown,
-    ];
+        });
+    }
+    /** Waits for every currently queued task (across every key) to settle. */
+    async drain() {
+        await Promise.allSettled([...this.#tails.values()].map((s) => s.tail));
+    }
 }
 //# sourceMappingURL=queue.js.map

package/dist/daemon/queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/daemon/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAmD,EACnD,OAAmB;IAEnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,QAAQ,GAAwB,IAAI,CAAC;IACzC,MAAM,KAAK,GAAiB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAuB,EAAE,EAAE;QAC1E,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC5C,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,QAAQ,EAAE,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IAEnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjC,OAAO;QACL,KAAK;QACL,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC;YAChB,CAAC;oBAAS,CAAC;gBACT,OAAO,EAAE,CAAC;gBACV,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,QAAQ;KACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/daemon/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IACzB,MAAM,GAAG,IAAI,GAAG,EAAmD,CAAC;IAEpE,sFAAsF;IAC/E,MAAM,CAAC,GAAW;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,iFAAiF;IAC1E,IAAI,CAAC,GAAW,EAAE,IAAyB;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI;YACpC,MAAM,EAAE,CAAC;YACT,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;SACxB,CAAC;QACF,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC5B,wEAAwE;QACxE,wEAAwE;QACxE,wEAAwE;QACxE,0EAA0E;QAC1E,yEAAyE;QACzE,aAAa;QACb,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YACtC,IAAI,CAAC;gBACH,MAAM,IAAI,EAAE,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;gBAClB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IACnE,KAAK,CAAC,KAAK;QAChB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/daemon/session-registry.d.ts

@@ -0,0 +1,112 @@
+import type { ChannelOrigin } from "../core/approvals/channel-ask.js";
+/** Why a runtime session's pool slot was released. */
+export type DaemonDisposeReason = "idle_timeout" | "pool_pressure" | "shutdown" | "child_exit";
+export type DaemonRegistryEvent = {
+    type: "slot_waiting";
+    externalKey: string;
+} | {
+    type: "slot_acquired";
+    externalKey: string;
+} | {
+    type: "active";
+    externalKey: string;
+    acpSessionId: string;
+    userId?: string;
+} | {
+    type: "idle";
+    externalKey: string;
+} | {
+    type: "disposed";
+    externalKey: string;
+    acpSessionId: string;
+    reason: DaemonDisposeReason;
+};
+export type DaemonSessionRegistryOptions = {
+    /** Bound on concurrently active ACP sessions. Must be a positive integer. */
+    maxActiveSessions: number;
+    /** Ordinary idle-close delay after a session becomes non-busy. `0` disables it (pressure eviction still applies). */
+    idleTimeoutMs: number;
+    /** Called to close an ACP session (idle timeout, pool pressure, or shutdown). May throw; cleanup still runs. */
+    onClose: (externalKey: string, acpSessionId: string) => Promise<void>;
+    /** Notified on every pool/lifecycle transition, for dashboard/diagnostics consumers. */
+    onEvent?: (event: DaemonRegistryEvent) => void;
+};
+/**
+ * Tracks the daemon's channel-conversation → ACP-session bindings, the
+ * durable JSONL mapping, and a bounded pool of concurrently active ACP
+ * sessions: idle sessions are evicted LRU under pressure, callers otherwise
+ * wait FIFO for a slot, and a non-busy session with pool waiters closes
+ * immediately instead of waiting out the ordinary idle timeout.
+ */
+export declare class DaemonSessionRegistry {
+    #private;
+    private readonly options;
+    constructor(options: DaemonSessionRegistryOptions);
+    hydrate(): Promise<void>;
+    /** Persisted ACP session ID for a key from a prior daemon run, if any. */
+    persistedAcpSessionId(externalKey: string): string | undefined;
+    isActive(externalKey: string): boolean;
+    /** Whether an ACP session is already registered (created/resumed) for `externalKey` in this process. */
+    hasRuntime(externalKey: string): boolean;
+    acpSessionIdFor(externalKey: string): string | undefined;
+    /**
+     * Acquires one pool slot for `externalKey`. Reuses the caller's own slot
+     * if already held. Otherwise joins the FIFO waiter queue and, if a slot
+     * exists, immediately requests one idle LRU session be evicted to make
+     * room — but never grants the freed slot directly, so fairness holds even
+     * when eviction and waiting happen concurrently.
+     */
+    acquireSlot(externalKey: string): Promise<void>;
+    /**
+     * Releases a pool slot acquired via {@link acquireSlot} when session setup
+     * fails *before* a runtime was ever registered — otherwise the key would
+     * stay parked in `#activeKeys` forever (no runtime for `markIdle` to find),
+     * slowly exhausting the pool across repeated failures.
+     */
+    releaseFailedSlot(externalKey: string): void;
+    /**
+     * Drops every runtime entry (but keeps pool slots reserved) after the
+     * shared ACP child process exits unexpectedly. `hasRuntime()` then returns
+     * `false` for every key, so the next turn for each falls back to
+     * `resumeSession()` against the persisted ACP session ID on the fresh
+     * child, instead of silently prompting a runtime the new child never
+     * created.
+     */
+    invalidateRuntimes(): void;
+    /** Registers a newly created/resumed active session and marks it busy for the in-flight turn. */
+    registerActive(binding: {
+        externalKey: string;
+        acpSessionId: string;
+        cwd: string;
+        userId?: string;
+        origin: ChannelOrigin | null;
+    }): void;
+    /** Persists the external-key → ACP-session-ID binding (create, or replacement after a missing-session resume failure). */
+    persistBinding(params: {
+        externalKey: string;
+        acpSessionId: string;
+        cwd: string;
+        userId?: string | null;
+    }): Promise<void>;
+    updateOrigin(externalKey: string, origin: ChannelOrigin | null): void;
+    originForAcpSession(acpSessionId: string): ChannelOrigin | null;
+    externalKeyForAcpSession(acpSessionId: string): string | undefined;
+    /** Marks a session busy for the duration of one `session/prompt` call, cancelling any armed idle timer. */
+    markBusy(externalKey: string): void;
+    /**
+     * Marks a session non-busy after its turn settles. When more work for the
+     * same key is already queued, the caller keeps its slot untouched. When
+     * pool waiters exist, the session closes immediately instead of arming the
+     * ordinary idle timer.
+     */
+    markIdle(externalKey: string, hasQueuedWork: boolean): void;
+    /** Rejects queued waiters, closes every active session, and stops granting new slots. */
+    shutdown(): Promise<void>;
+    /** Snapshot pool occupancy for dashboard/diagnostics consumers. */
+    poolStats(): {
+        active: number;
+        max: number;
+        waiting: number;
+    };
+    get isShuttingDown(): boolean;
+}

package/dist/daemon/session-registry.js

@@ -0,0 +1,272 @@
+import { patchDaemonSessionBinding, readDaemonSessionBindings, } from "./session-store.js";
+/**
+ * Tracks the daemon's channel-conversation → ACP-session bindings, the
+ * durable JSONL mapping, and a bounded pool of concurrently active ACP
+ * sessions: idle sessions are evicted LRU under pressure, callers otherwise
+ * wait FIFO for a slot, and a non-busy session with pool waiters closes
+ * immediately instead of waiting out the ordinary idle timeout.
+ */
+export class DaemonSessionRegistry {
+    options;
+    #persisted = new Map();
+    #runtime = new Map();
+    #reverse = new Map();
+    #activeKeys = new Set();
+    #waiters = [];
+    #shuttingDown = false;
+    constructor(options) {
+        this.options = options;
+        if (!Number.isInteger(options.maxActiveSessions) ||
+            options.maxActiveSessions < 1) {
+            throw new Error("maxActiveSessions must be a positive integer.");
+        }
+    }
+    async hydrate() {
+        this.#persisted = await readDaemonSessionBindings();
+    }
+    /** Persisted ACP session ID for a key from a prior daemon run, if any. */
+    persistedAcpSessionId(externalKey) {
+        return this.#persisted.get(externalKey)?.acpSessionId;
+    }
+    isActive(externalKey) {
+        return this.#activeKeys.has(externalKey);
+    }
+    /** Whether an ACP session is already registered (created/resumed) for `externalKey` in this process. */
+    hasRuntime(externalKey) {
+        return this.#runtime.has(externalKey);
+    }
+    acpSessionIdFor(externalKey) {
+        return this.#runtime.get(externalKey)?.acpSessionId;
+    }
+    /**
+     * Acquires one pool slot for `externalKey`. Reuses the caller's own slot
+     * if already held. Otherwise joins the FIFO waiter queue and, if a slot
+     * exists, immediately requests one idle LRU session be evicted to make
+     * room — but never grants the freed slot directly, so fairness holds even
+     * when eviction and waiting happen concurrently.
+     */
+    async acquireSlot(externalKey) {
+        if (this.#activeKeys.has(externalKey)) {
+            return;
+        }
+        if (this.#activeKeys.size < this.options.maxActiveSessions) {
+            this.#activeKeys.add(externalKey);
+            this.options.onEvent?.({ type: "slot_acquired", externalKey });
+            return;
+        }
+        this.options.onEvent?.({ type: "slot_waiting", externalKey });
+        const waiterPromise = new Promise((resolve) => {
+            this.#waiters.push({ key: externalKey, resolve });
+        });
+        const idleKey = this.#pickIdleLru();
+        if (idleKey) {
+            void this.#closeRuntime(idleKey, "pool_pressure");
+        }
+        await waiterPromise;
+        this.options.onEvent?.({ type: "slot_acquired", externalKey });
+    }
+    /**
+     * Releases a pool slot acquired via {@link acquireSlot} when session setup
+     * fails *before* a runtime was ever registered — otherwise the key would
+     * stay parked in `#activeKeys` forever (no runtime for `markIdle` to find),
+     * slowly exhausting the pool across repeated failures.
+     */
+    releaseFailedSlot(externalKey) {
+        if (this.#runtime.has(externalKey)) {
+            return;
+        }
+        if (!this.#activeKeys.delete(externalKey)) {
+            return;
+        }
+        const waiter = this.#waiters.shift();
+        if (waiter) {
+            this.#activeKeys.add(waiter.key);
+            waiter.resolve();
+        }
+    }
+    /**
+     * Drops every runtime entry (but keeps pool slots reserved) after the
+     * shared ACP child process exits unexpectedly. `hasRuntime()` then returns
+     * `false` for every key, so the next turn for each falls back to
+     * `resumeSession()` against the persisted ACP session ID on the fresh
+     * child, instead of silently prompting a runtime the new child never
+     * created.
+     */
+    invalidateRuntimes() {
+        for (const runtime of this.#runtime.values()) {
+            if (runtime.idleTimer) {
+                clearTimeout(runtime.idleTimer);
+            }
+            this.options.onEvent?.({
+                type: "disposed",
+                externalKey: runtime.externalKey,
+                acpSessionId: runtime.acpSessionId,
+                reason: "child_exit",
+            });
+        }
+        this.#runtime.clear();
+        this.#reverse.clear();
+    }
+    /** Registers a newly created/resumed active session and marks it busy for the in-flight turn. */
+    registerActive(binding) {
+        this.#runtime.set(binding.externalKey, {
+            externalKey: binding.externalKey,
+            acpSessionId: binding.acpSessionId,
+            cwd: binding.cwd,
+            userId: binding.userId,
+            origin: binding.origin,
+            busy: true,
+            closing: false,
+            lastActiveAt: Date.now(),
+            idleTimer: null,
+        });
+        this.#reverse.set(binding.acpSessionId, binding.externalKey);
+        this.options.onEvent?.({
+            type: "active",
+            externalKey: binding.externalKey,
+            acpSessionId: binding.acpSessionId,
+            userId: binding.userId,
+        });
+    }
+    /** Persists the external-key → ACP-session-ID binding (create, or replacement after a missing-session resume failure). */
+    async persistBinding(params) {
+        const now = new Date().toISOString();
+        const existing = this.#persisted.get(params.externalKey);
+        const entry = {
+            externalKey: params.externalKey,
+            acpSessionId: params.acpSessionId,
+            cwd: params.cwd,
+            userId: params.userId ?? null,
+            createdAt: existing?.createdAt ?? now,
+            updatedAt: now,
+        };
+        this.#persisted.set(params.externalKey, entry);
+        await patchDaemonSessionBinding(entry);
+    }
+    updateOrigin(externalKey, origin) {
+        const runtime = this.#runtime.get(externalKey);
+        if (runtime) {
+            runtime.origin = origin;
+        }
+    }
+    originForAcpSession(acpSessionId) {
+        const key = this.#reverse.get(acpSessionId);
+        if (!key) {
+            return null;
+        }
+        return this.#runtime.get(key)?.origin ?? null;
+    }
+    externalKeyForAcpSession(acpSessionId) {
+        return this.#reverse.get(acpSessionId);
+    }
+    /** Marks a session busy for the duration of one `session/prompt` call, cancelling any armed idle timer. */
+    markBusy(externalKey) {
+        const runtime = this.#runtime.get(externalKey);
+        if (!runtime) {
+            return;
+        }
+        runtime.busy = true;
+        if (runtime.idleTimer) {
+            clearTimeout(runtime.idleTimer);
+            runtime.idleTimer = null;
+        }
+    }
+    /**
+     * Marks a session non-busy after its turn settles. When more work for the
+     * same key is already queued, the caller keeps its slot untouched. When
+     * pool waiters exist, the session closes immediately instead of arming the
+     * ordinary idle timer.
+     */
+    markIdle(externalKey, hasQueuedWork) {
+        const runtime = this.#runtime.get(externalKey);
+        if (!runtime || runtime.closing) {
+            return;
+        }
+        runtime.busy = false;
+        runtime.lastActiveAt = Date.now();
+        if (hasQueuedWork) {
+            return;
+        }
+        this.options.onEvent?.({ type: "idle", externalKey });
+        if (this.#waiters.length > 0) {
+            void this.#closeRuntime(externalKey, "pool_pressure");
+            return;
+        }
+        if (this.options.idleTimeoutMs > 0) {
+            runtime.idleTimer = setTimeout(() => {
+                runtime.idleTimer = null;
+                if (!runtime.busy && !runtime.closing) {
+                    void this.#closeRuntime(externalKey, "idle_timeout");
+                }
+            }, this.options.idleTimeoutMs);
+            runtime.idleTimer.unref?.();
+        }
+    }
+    #pickIdleLru() {
+        let best;
+        for (const runtime of this.#runtime.values()) {
+            if (runtime.busy || runtime.closing) {
+                continue;
+            }
+            if (!best || runtime.lastActiveAt < best.lastActiveAt) {
+                best = runtime;
+            }
+        }
+        return best?.externalKey;
+    }
+    async #closeRuntime(externalKey, reason) {
+        const runtime = this.#runtime.get(externalKey);
+        if (!runtime || runtime.closing) {
+            return;
+        }
+        runtime.closing = true;
+        if (runtime.idleTimer) {
+            clearTimeout(runtime.idleTimer);
+            runtime.idleTimer = null;
+        }
+        try {
+            await this.options.onClose(externalKey, runtime.acpSessionId);
+        }
+        catch {
+            /* `onClose` is documented not to throw, but cleanup below must still
+             * run so the slot and waiter queue never leak on a misbehaving caller. */
+        }
+        finally {
+            this.#runtime.delete(externalKey);
+            this.#reverse.delete(runtime.acpSessionId);
+            this.#activeKeys.delete(externalKey);
+            this.options.onEvent?.({
+                type: "disposed",
+                externalKey,
+                acpSessionId: runtime.acpSessionId,
+                reason,
+            });
+            const waiter = this.#waiters.shift();
+            if (waiter) {
+                this.#activeKeys.add(waiter.key);
+                waiter.resolve();
+            }
+        }
+    }
+    /** Rejects queued waiters, closes every active session, and stops granting new slots. */
+    async shutdown() {
+        this.#shuttingDown = true;
+        const pending = this.#waiters.splice(0, this.#waiters.length);
+        for (const waiter of pending) {
+            waiter.resolve();
+        }
+        await Promise.all([...this.#runtime.keys()].map((key) => this.#closeRuntime(key, "shutdown")));
+    }
+    /** Snapshot pool occupancy for dashboard/diagnostics consumers. */
+    poolStats() {
+        return {
+            active: this.#activeKeys.size,
+            max: this.options.maxActiveSessions,
+            waiting: this.#waiters.length,
+        };
+    }
+    get isShuttingDown() {
+        return this.#shuttingDown;
+    }
+}
+//# sourceMappingURL=session-registry.js.map

package/dist/daemon/session-registry.js.map

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

package/dist/daemon/session-store.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Persisted external-conversation-key → ACP-session-ID binding, so daemon
+ * restarts can `session/resume` prior conversations instead of losing them.
+ * Append-only JSONL patch log (same fold/tombstone shape as
+ * `src/acp/sessions/store.ts`), scoped to the current project.
+ */
+export type DaemonSessionBinding = {
+    externalKey: string;
+    acpSessionId: string;
+    cwd: string;
+    userId?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** Reads and folds the append-only bindings log; unparseable (torn) lines are skipped. */
+export declare function readDaemonSessionBindings(): Promise<Map<string, DaemonSessionBinding>>;
+/** Appends a full or partial binding patch; `updatedAt` is bumped unless the patch sets it. */
+export declare function patchDaemonSessionBinding(patch: Partial<Omit<DaemonSessionBinding, "externalKey">> & {
+    externalKey: string;
+}): Promise<void>;