@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/daemon/lease-broker.js

@@ -0,0 +1,504 @@
+import { randomUUID } from "node:crypto";
+const LEASE_TRANSFERRED_CLOSE_REASON = "lease_transferred";
+function getLeaseKey(workspaceName, sessionId) {
+    return `${workspaceName}\0${sessionId}`;
+}
+export class LeaseBroker {
+    effects;
+    records = new Map();
+    constructor(effects) {
+        this.effects = effects;
+    }
+    lookup(workspaceName, sessionId) {
+        return this.records.get(getLeaseKey(workspaceName, sessionId));
+    }
+    list() {
+        return Array.from(this.records.values());
+    }
+    getOrCreateRecord(workspaceName, sessionId) {
+        const key = getLeaseKey(workspaceName, sessionId);
+        let record = this.records.get(key);
+        if (!record) {
+            record = {
+                key,
+                workspaceName,
+                sessionId,
+                state: "unowned",
+                streamCount: 0,
+                relayIds: new Set(),
+                pendingDaemonAttaches: 0,
+            };
+            this.records.set(key, record);
+        }
+        return record;
+    }
+    dropIfUnowned(record) {
+        if (record.state === "unowned" &&
+            record.relayIds.size === 0 &&
+            record.streamCount === 0 &&
+            record.pendingDaemonAttaches === 0) {
+            this.records.delete(record.key);
+        }
+    }
+    beginDaemonAttach(workspaceName, sessionId) {
+        const claim = {
+            id: randomUUID(),
+            workspaceName,
+            ...(sessionId === undefined ? {} : { sessionId }),
+        };
+        if (sessionId === undefined) {
+            return { kind: "proceed", claim };
+        }
+        const record = this.getOrCreateRecord(workspaceName, sessionId);
+        if (record.state === "tui-owned" && record.tuiConnectionId) {
+            this.dropIfUnowned(record);
+            return { kind: "relay", tuiConnectionId: record.tuiConnectionId };
+        }
+        if (record.state === "daemon-draining") {
+            this.dropIfUnowned(record);
+            return { kind: "retry", retryAfterMs: 1000 };
+        }
+        record.pendingDaemonAttaches++;
+        return { kind: "proceed", claim };
+    }
+    abortDaemonAttach(claim) {
+        if (claim.sessionId === undefined) {
+            return;
+        }
+        const record = this.lookup(claim.workspaceName, claim.sessionId);
+        if (!record) {
+            return;
+        }
+        record.pendingDaemonAttaches = Math.max(0, record.pendingDaemonAttaches - 1);
+        this.dropIfUnowned(record);
+    }
+    commitDaemonRuntime(claim, workspaceName, sessionId) {
+        this.abortDaemonAttach(claim);
+        const record = this.getOrCreateRecord(workspaceName, sessionId);
+        if (record.state === "tui-owned") {
+            return {
+                ok: false,
+                reason: "tui_owned",
+                ...(record.tuiConnectionId ? { tuiConnectionId: record.tuiConnectionId } : {}),
+            };
+        }
+        if (record.state === "daemon-draining") {
+            return { ok: false, reason: "draining" };
+        }
+        const previousState = record.state;
+        if (record.state === "unowned" || record.state === "daemon-detached") {
+            record.state = "daemon-active";
+            this.effects.audit({
+                type: "lease_acquired",
+                workspaceName,
+                sessionId,
+                details: { owner: "daemon", handoff: "none" },
+            });
+        }
+        else if (record.state === "daemon-active") {
+            record.state = "daemon-active";
+        }
+        return { ok: true, previousState };
+    }
+    rollbackDaemonRuntimeCommit(workspaceName, sessionId, previousState) {
+        const record = this.lookup(workspaceName, sessionId);
+        if (!record || record.state === "tui-owned" || record.state === "daemon-draining") {
+            return;
+        }
+        record.state = previousState;
+        if (previousState === "unowned") {
+            record.streamCount = 0;
+            this.dropIfUnowned(record);
+        }
+    }
+    // ==========================================================================
+    // TUI acquire / release / rekey
+    // ==========================================================================
+    async acquireForTui(request) {
+        const { connectionId, workspaceName, sessionId } = request;
+        if (request.force) {
+            this.effects.audit({
+                type: "lease_denied",
+                workspaceName,
+                sessionId,
+                details: { requester: connectionId, reason: "force_unsupported" },
+            });
+            return { kind: "denied", reason: "force_unsupported" };
+        }
+        const record = this.getOrCreateRecord(workspaceName, sessionId);
+        switch (record.state) {
+            case "unowned": {
+                record.state = "tui-owned";
+                record.tuiConnectionId = connectionId;
+                this.effects.audit({
+                    type: "lease_acquired",
+                    workspaceName,
+                    sessionId,
+                    details: { owner: "tui", handoff: "none", connectionId },
+                });
+                return { kind: "granted", handoff: "none" };
+            }
+            case "tui-owned": {
+                if (record.tuiConnectionId === connectionId) {
+                    return { kind: "granted", handoff: "none" };
+                }
+                this.effects.audit({
+                    type: "lease_denied",
+                    workspaceName,
+                    sessionId,
+                    details: { requester: connectionId, reason: "held_by_tui" },
+                });
+                return { kind: "denied", reason: "held_by_tui" };
+            }
+            case "daemon-draining": {
+                if (record.tuiConnectionId === connectionId && record.drain) {
+                    const drain = record.drain;
+                    return {
+                        kind: "pending",
+                        viewerFeedId: drain.viewerFeedId,
+                        granted: new Promise((resolve, reject) => {
+                            const previousResolve = drain.resolveGranted;
+                            const previousReject = drain.rejectGranted;
+                            drain.resolveGranted = (result) => {
+                                previousResolve(result);
+                                resolve(result);
+                            };
+                            drain.rejectGranted = (error) => {
+                                previousReject(error);
+                                reject(error);
+                            };
+                        }),
+                    };
+                }
+                this.effects.audit({
+                    type: "lease_denied",
+                    workspaceName,
+                    sessionId,
+                    details: { requester: connectionId, reason: "draining_elsewhere" },
+                });
+                return { kind: "denied", reason: "draining_elsewhere" };
+            }
+            case "daemon-detached":
+            case "daemon-active": {
+                if (this.effects.isRuntimeStreaming(workspaceName, sessionId)) {
+                    // A mid-turn runtime ALWAYS drains before the handoff, even when
+                    // every phone has detached. Disposing a busy runtime abandons the
+                    // turn: its results (including completed subagent work buffered in
+                    // an in-flight tool call) are never persisted, and the transcript
+                    // is left with a dangling tool call. The acquiring TUI watches the
+                    // rest of the turn through the drain viewer feed and is granted
+                    // ownership once the runtime goes idle; it can cancel the drain by
+                    // releasing (Esc/quit), which leaves the turn running on the daemon.
+                    return this.beginDrain(record, connectionId);
+                }
+                // Idle: dispose and grant immediately.
+                // The flip to tui-owned happens BEFORE disposal so the disposal's
+                // onDaemonRuntimeDisposed callback no-ops (it is part of this grant).
+                record.state = "tui-owned";
+                record.tuiConnectionId = connectionId;
+                try {
+                    await this.effects.disposeRuntime(workspaceName, sessionId, "lease_transferred_to_tui");
+                    await this.effects.closePhoneStreams(workspaceName, sessionId, LEASE_TRANSFERRED_CLOSE_REASON);
+                }
+                catch (error) {
+                    // Disposal failed after the premature tui-owned flip. Leaving the
+                    // lease tui-owned would strand the still-alive daemon runtime and
+                    // phone streams. Revert to a daemon-owned state and fail the acquire
+                    // (unless the connection already died and released the lease).
+                    if (record.state === "tui-owned" && record.tuiConnectionId === connectionId) {
+                        record.state = record.streamCount > 0 ? "daemon-active" : "daemon-detached";
+                        record.tuiConnectionId = undefined;
+                    }
+                    throw error;
+                }
+                record.streamCount = 0;
+                if (record.state !== "tui-owned" || record.tuiConnectionId !== connectionId) {
+                    // The connection died while the disposal effects ran and the lease
+                    // was already released (releaseAllForConnection). The release path
+                    // audited; there is no live owner left to grant to.
+                    this.dropIfUnowned(record);
+                    return { kind: "granted", handoff: "warm" };
+                }
+                this.effects.audit({
+                    type: "lease_acquired",
+                    workspaceName,
+                    sessionId,
+                    details: { owner: "tui", handoff: "warm", connectionId },
+                });
+                return { kind: "granted", handoff: "warm" };
+            }
+        }
+    }
+    beginDrain(record, connectionId) {
+        const viewerFeedId = this.effects.generateViewerFeedId?.() ?? `vf-${randomUUID()}`;
+        record.state = "daemon-draining";
+        record.tuiConnectionId = connectionId;
+        let resolveGranted = () => { };
+        let rejectGranted = () => { };
+        const granted = new Promise((resolve, reject) => {
+            resolveGranted = resolve;
+            rejectGranted = reject;
+        });
+        granted.catch(() => { });
+        record.drain = {
+            viewerFeedId,
+            startedAtMs: Date.now(),
+            cancelled: false,
+            disposing: false,
+            resolveGranted,
+            rejectGranted,
+        };
+        this.effects.onDrainStarted?.(record, viewerFeedId);
+        void this.runDrain(record);
+        return { kind: "pending", viewerFeedId, granted };
+    }
+    async runDrain(record) {
+        const drain = record.drain;
+        if (!drain) {
+            return;
+        }
+        try {
+            await this.effects.waitForRuntimeIdle(record.workspaceName, record.sessionId);
+        }
+        catch (error) {
+            if (!drain.cancelled && record.drain === drain) {
+                record.drain = undefined;
+                record.state = record.streamCount > 0 ? "daemon-active" : "daemon-detached";
+                record.tuiConnectionId = undefined;
+                this.effects.onDrainEnded?.(record, drain.viewerFeedId, "error");
+                drain.rejectGranted(error instanceof Error ? error : new Error(String(error)));
+            }
+            return;
+        }
+        if (drain.cancelled || record.drain !== drain) {
+            return;
+        }
+        // From here disposal is irreversible: record.drain stays set so a
+        // cancellation landing during these awaits is visible afterwards, and
+        // cancelDrain defers the final transition to this continuation.
+        drain.disposing = true;
+        try {
+            await this.effects.disposeRuntime(record.workspaceName, record.sessionId, "lease_transferred_to_tui");
+            await this.effects.closePhoneStreams(record.workspaceName, record.sessionId, LEASE_TRANSFERRED_CLOSE_REASON);
+        }
+        catch (error) {
+            // This phase is otherwise unguarded, so a disposal failure (e.g. a
+            // state-manager IO error) would wedge the lease in daemon-draining forever
+            // and leave the acquiring TUI's grant promise unsettled. Recover: clear the
+            // drain, settle the grant, and move to a state a later acquire can retry
+            // from (unowned when the requester already gave up, else daemon-owned).
+            if (record.drain === drain) {
+                record.drain = undefined;
+                record.tuiConnectionId = undefined;
+            }
+            if (drain.cancelled) {
+                // Zero the stream count before dropping. dropIfUnowned requires
+                // streamCount === 0, so leaving it stale here (the success path resets it
+                // at the bottom of runDrain, but this early return skips that) would
+                // strand the record in `records` as an undroppable "unowned" ghost that
+                // then hands a phantom stream count to the next acquire.
+                record.streamCount = 0;
+                record.state = "unowned";
+                this.dropIfUnowned(record);
+            }
+            else {
+                record.state = record.streamCount > 0 ? "daemon-active" : "daemon-detached";
+                this.effects.onDrainEnded?.(record, drain.viewerFeedId, "error");
+                drain.rejectGranted(error instanceof Error ? error : new Error(String(error)));
+            }
+            return;
+        }
+        record.drain = undefined;
+        record.streamCount = 0;
+        if (drain.cancelled) {
+            // The requesting connection died mid-disposal. The runtime is gone, so
+            // the lease returns to unowned instead of granting to a dead owner.
+            record.state = "unowned";
+            record.tuiConnectionId = undefined;
+            this.effects.audit({
+                type: "lease_released",
+                workspaceName: record.workspaceName,
+                sessionId: record.sessionId,
+                details: { owner: "daemon", reason: "connection_lost", drainCancelledDuringDisposal: true },
+            });
+            this.dropIfUnowned(record);
+            return;
+        }
+        record.state = "tui-owned";
+        this.effects.onDrainEnded?.(record, drain.viewerFeedId, "granted");
+        this.effects.audit({
+            type: "lease_acquired",
+            workspaceName: record.workspaceName,
+            sessionId: record.sessionId,
+            details: { owner: "tui", handoff: "warm", connectionId: record.tuiConnectionId },
+        });
+        drain.resolveGranted({ handoff: "warm" });
+    }
+    cancelDrain(record) {
+        const drain = record.drain;
+        if (!drain || drain.cancelled) {
+            return;
+        }
+        drain.cancelled = true;
+        if (drain.disposing) {
+            // Runtime disposal already started and cannot be reverted; fail the
+            // grant now and let runDrain's continuation finish the transition
+            // (to unowned) once the disposal effects settle.
+            this.effects.onDrainEnded?.(record, drain.viewerFeedId, "cancelled");
+            drain.rejectGranted(new Error("drain cancelled"));
+            return;
+        }
+        record.drain = undefined;
+        record.tuiConnectionId = undefined;
+        record.state = record.streamCount > 0 ? "daemon-active" : "daemon-detached";
+        this.effects.onDrainEnded?.(record, drain.viewerFeedId, "cancelled");
+        drain.rejectGranted(new Error("drain cancelled"));
+    }
+    releaseFromTui(connectionId, workspaceName, sessionId, reason = "quit") {
+        const record = this.lookup(workspaceName, sessionId);
+        if (record?.state === "daemon-draining" && record.tuiConnectionId === connectionId) {
+            // The requesting TUI is abandoning its own pending drain (a change of
+            // mind). Cancel it rather than letting runDrain complete and force-grant
+            // an unwanted warm lease — which would needlessly dispose the daemon
+            // runtime and close every phone stream for a handoff no one wants.
+            this.cancelDrain(record);
+            this.dropIfUnowned(record);
+            return { ok: true };
+        }
+        if (!record || record.state !== "tui-owned" || record.tuiConnectionId !== connectionId) {
+            return { ok: false, code: "not_held" };
+        }
+        this.effects.closeRelays(record, "lease_transferred");
+        record.relayIds.clear();
+        record.state = "unowned";
+        record.tuiConnectionId = undefined;
+        this.effects.audit({
+            type: "lease_released",
+            workspaceName,
+            sessionId,
+            details: { owner: "tui", reason, connectionId },
+        });
+        this.dropIfUnowned(record);
+        return { ok: true };
+    }
+    /** Connection died: implicit release of ALL leases held by connectionId. */
+    releaseAllForConnection(connectionId) {
+        for (const record of Array.from(this.records.values())) {
+            if (record.state === "tui-owned" && record.tuiConnectionId === connectionId) {
+                this.releaseFromTui(connectionId, record.workspaceName, record.sessionId, "connection_lost");
+                continue;
+            }
+            if (record.state === "daemon-draining" && record.tuiConnectionId === connectionId) {
+                this.cancelDrain(record);
+            }
+        }
+    }
+    rekey(workspaceName, oldSessionId, newSessionId) {
+        if (oldSessionId === newSessionId) {
+            return;
+        }
+        const record = this.lookup(workspaceName, oldSessionId);
+        if (!record) {
+            return;
+        }
+        const newKey = getLeaseKey(workspaceName, newSessionId);
+        const displaced = this.records.get(newKey);
+        if (displaced) {
+            // The target session id already has its own lease record. A destructive
+            // rekey would either orphan `record` (its old key removed but never
+            // re-inserted) or silently drop the live `displaced` record from all
+            // lease accounting, stranding its runtime/streams/relays. Refuse instead
+            // and leave both records on their current keys; the caller re-acquires
+            // under the new id on its next reconnect.
+            this.effects.audit({
+                type: "lease_denied",
+                workspaceName,
+                sessionId: newSessionId,
+                details: { reason: "rekey_target_in_use", oldSessionId, displacedState: displaced.state },
+            });
+            return;
+        }
+        this.records.delete(record.key);
+        record.sessionId = newSessionId;
+        record.key = newKey;
+        this.records.set(newKey, record);
+        if (record.state === "tui-owned" && record.relayIds.size > 0) {
+            this.effects.closeRelays(record, "session_rekeyed_reconnect");
+            record.relayIds.clear();
+        }
+    }
+    // ==========================================================================
+    // Relay bookkeeping (tui-owned)
+    // ==========================================================================
+    registerRelay(workspaceName, sessionId, relayId) {
+        const record = this.lookup(workspaceName, sessionId);
+        if (record?.state === "tui-owned") {
+            record.relayIds.add(relayId);
+        }
+    }
+    unregisterRelay(workspaceName, sessionId, relayId) {
+        const record = this.lookup(workspaceName, sessionId);
+        if (record) {
+            record.relayIds.delete(relayId);
+            this.dropIfUnowned(record);
+        }
+    }
+    // ==========================================================================
+    // Daemon runtime lifecycle notifications
+    // ==========================================================================
+    onDaemonRuntimeAttached(workspaceName, sessionId) {
+        const record = this.getOrCreateRecord(workspaceName, sessionId);
+        if (record.state === "unowned" || record.state === "daemon-detached") {
+            record.state = "daemon-active";
+            this.effects.audit({
+                type: "lease_acquired",
+                workspaceName,
+                sessionId,
+                details: { owner: "daemon", handoff: "none" },
+            });
+        }
+    }
+    onDaemonRuntimeStreamCountChanged(workspaceName, sessionId, liveStreams) {
+        const record = this.lookup(workspaceName, sessionId);
+        if (!record) {
+            return;
+        }
+        record.streamCount = liveStreams;
+        if (record.state === "daemon-draining" || record.state === "tui-owned" || record.state === "unowned") {
+            // Drain completes regardless of stream count; tui-owned counts relays instead.
+            return;
+        }
+        record.state = liveStreams > 0 ? "daemon-active" : "daemon-detached";
+    }
+    onDaemonRuntimeDisposed(workspaceName, sessionId, reason) {
+        const record = this.lookup(workspaceName, sessionId);
+        if (!record) {
+            return;
+        }
+        if (record.state === "daemon-draining") {
+            // Disposal is part of the drain flow (or shutdown subsumed it); the drain
+            // path handles its own transition.
+            return;
+        }
+        if (record.state === "tui-owned") {
+            // The runtime disposal that accompanies an immediate grant.
+            return;
+        }
+        record.streamCount = 0;
+        record.state = "unowned";
+        this.effects.audit({
+            type: "lease_released",
+            workspaceName,
+            sessionId,
+            details: {
+                owner: "daemon",
+                reason: reason === "detached_runtime_ttl_expired" ? "retention_expired" : reason,
+            },
+        });
+        this.dropIfUnowned(record);
+    }
+    isDraining(workspaceName, sessionId) {
+        return this.lookup(workspaceName, sessionId)?.state === "daemon-draining";
+    }
+}
+//# sourceMappingURL=lease-broker.js.map

package/dist/daemon/lease-broker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-broker.js","sourceRoot":"","sources":["../../src/daemon/lease-broker.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\n\n/**\n * Conversation lease broker: the single authority on which process owns the\n * live runtime for a (workspaceName, sessionId). Runtimes and relays are\n * effects driven by its transitions. Runs single-threaded on the daemon event\n * loop; every transition is a synchronous state mutation followed by async\n * effects.\n */\n\nexport type LeaseState = \"unowned\" | \"daemon-active\" | \"daemon-detached\" | \"daemon-draining\" | \"tui-owned\";\n\nexport type LeaseHandoff = \"cold\" | \"warm\" | \"none\";\n\nexport type LeaseDenyReason = \"held_by_tui\" | \"force_unsupported\" | \"draining_elsewhere\";\nexport type DaemonAttachRejectionReason = \"tui_owned\" | \"draining\";\n\nexport type LeaseReleaseReason = \"quit\" | \"switch\" | \"connection_lost\" | \"rekey\" | \"shutdown\" | \"retention_expired\";\n\nexport interface LeaseRecord {\n\tkey: string;\n\tworkspaceName: string;\n\tsessionId: string;\n\tstate: LeaseState;\n\t/** control connectionId of owning TUI when tui-owned / target of daemon-draining */\n\ttuiConnectionId?: string;\n\t/** live phone stream count when daemon-* */\n\tstreamCount: number;\n\t/** active relayIds when tui-owned */\n\trelayIds: Set<string>;\n\t/** drain bookkeeping when daemon-draining */\n\tdrain?: {\n\t\tviewerFeedId: string;\n\t\tstartedAtMs: number;\n\t\tcancelled: boolean;\n\t\t/**\n\t\t * Runtime disposal has started; the drain can no longer revert to a\n\t\t * daemon-owned state, so a cancellation must defer the final transition\n\t\t * to runDrain's continuation.\n\t\t */\n\t\tdisposing: boolean;\n\t\tresolveGranted: (result: { handoff: \"warm\" }) => void;\n\t\trejectGranted: (error: Error) => void;\n\t};\n\t/** Provisional daemon runtime creations that have not committed ownership. */\n\tpendingDaemonAttaches: number;\n\t/** pending lazy-resume shared by racing attaches (daemon-active sub-flag) */\n\tresuming?: Promise<void>;\n}\n\nexport interface DaemonAttachClaim {\n\treadonly id: string;\n\treadonly workspaceName: string;\n\treadonly sessionId?: string;\n}\n\nexport type DaemonAttachBeginOutcome =\n\t| { kind: \"proceed\"; claim: DaemonAttachClaim }\n\t| { kind: \"relay\"; tuiConnectionId: string }\n\t| { kind: \"retry\"; retryAfterMs: number };\n\nexport type DaemonAttachCommitOutcome =\n\t| { ok: true; previousState: LeaseState }\n\t| { ok: false; reason: DaemonAttachRejectionReason; tuiConnectionId?: string };\n\nexport type LeaseAcquireOutcome =\n\t| { kind: \"granted\"; handoff: LeaseHandoff }\n\t| { kind: \"pending\"; viewerFeedId: string; granted: Promise<{ handoff: \"warm\" }> }\n\t| { kind: \"denied\"; reason: LeaseDenyReason };\n\nexport interface LeaseBrokerEffects {\n\t/** True when the daemon runtime for the key is mid-turn. */\n\tisRuntimeStreaming(workspaceName: string, sessionId: string): boolean;\n\t/** Resolves when the daemon runtime's current turn ends. */\n\twaitForRuntimeIdle(workspaceName: string, sessionId: string): Promise<void>;\n\t/** Dispose the daemon runtime through the normal dispose path (session_shutdown \"quit\"). */\n\tdisposeRuntime(workspaceName: string, sessionId: string, reason: string): Promise<void>;\n\t/** Close daemon-attached phone streams for the key with the given reason. */\n\tclosePhoneStreams(workspaceName: string, sessionId: string, reason: string): Promise<void> | void;\n\t/** Close open relays for a tui-owned lease. */\n\tcloseRelays(\n\t\trecord: LeaseRecord,\n\t\treason: \"lease_transferred\" | \"session_rekeyed_reconnect\" | \"host_shutdown\" | \"error\",\n\t): void;\n\tonDrainStarted?(record: LeaseRecord, viewerFeedId: string): void;\n\tonDrainEnded?(record: LeaseRecord, viewerFeedId: string, reason: \"granted\" | \"cancelled\" | \"error\"): void;\n\taudit(event: {\n\t\ttype: \"lease_acquired\" | \"lease_released\" | \"lease_denied\";\n\t\tworkspaceName: string;\n\t\tsessionId: string;\n\t\tdetails: Record<string, unknown>;\n\t}): void;\n\tgenerateViewerFeedId?(): string;\n}\n\nconst LEASE_TRANSFERRED_CLOSE_REASON = \"lease_transferred\";\n\nfunction getLeaseKey(workspaceName: string, sessionId: string): string {\n\treturn `${workspaceName}\\0${sessionId}`;\n}\n\nexport class LeaseBroker {\n\tprivate readonly effects: LeaseBrokerEffects;\n\tprivate readonly records = new Map<string, LeaseRecord>();\n\n\tconstructor(effects: LeaseBrokerEffects) {\n\t\tthis.effects = effects;\n\t}\n\n\tlookup(workspaceName: string, sessionId: string): LeaseRecord | undefined {\n\t\treturn this.records.get(getLeaseKey(workspaceName, sessionId));\n\t}\n\n\tlist(): LeaseRecord[] {\n\t\treturn Array.from(this.records.values());\n\t}\n\n\tprivate getOrCreateRecord(workspaceName: string, sessionId: string): LeaseRecord {\n\t\tconst key = getLeaseKey(workspaceName, sessionId);\n\t\tlet record = this.records.get(key);\n\t\tif (!record) {\n\t\t\trecord = {\n\t\t\t\tkey,\n\t\t\t\tworkspaceName,\n\t\t\t\tsessionId,\n\t\t\t\tstate: \"unowned\",\n\t\t\t\tstreamCount: 0,\n\t\t\t\trelayIds: new Set(),\n\t\t\t\tpendingDaemonAttaches: 0,\n\t\t\t};\n\t\t\tthis.records.set(key, record);\n\t\t}\n\t\treturn record;\n\t}\n\n\tprivate dropIfUnowned(record: LeaseRecord): void {\n\t\tif (\n\t\t\trecord.state === \"unowned\" &&\n\t\t\trecord.relayIds.size === 0 &&\n\t\t\trecord.streamCount === 0 &&\n\t\t\trecord.pendingDaemonAttaches === 0\n\t\t) {\n\t\t\tthis.records.delete(record.key);\n\t\t}\n\t}\n\n\tbeginDaemonAttach(workspaceName: string, sessionId: string | undefined): DaemonAttachBeginOutcome {\n\t\tconst claim: DaemonAttachClaim = {\n\t\t\tid: randomUUID(),\n\t\t\tworkspaceName,\n\t\t\t...(sessionId === undefined ? {} : { sessionId }),\n\t\t};\n\t\tif (sessionId === undefined) {\n\t\t\treturn { kind: \"proceed\", claim };\n\t\t}\n\t\tconst record = this.getOrCreateRecord(workspaceName, sessionId);\n\t\tif (record.state === \"tui-owned\" && record.tuiConnectionId) {\n\t\t\tthis.dropIfUnowned(record);\n\t\t\treturn { kind: \"relay\", tuiConnectionId: record.tuiConnectionId };\n\t\t}\n\t\tif (record.state === \"daemon-draining\") {\n\t\t\tthis.dropIfUnowned(record);\n\t\t\treturn { kind: \"retry\", retryAfterMs: 1000 };\n\t\t}\n\t\trecord.pendingDaemonAttaches++;\n\t\treturn { kind: \"proceed\", claim };\n\t}\n\n\tabortDaemonAttach(claim: DaemonAttachClaim): void {\n\t\tif (claim.sessionId === undefined) {\n\t\t\treturn;\n\t\t}\n\t\tconst record = this.lookup(claim.workspaceName, claim.sessionId);\n\t\tif (!record) {\n\t\t\treturn;\n\t\t}\n\t\trecord.pendingDaemonAttaches = Math.max(0, record.pendingDaemonAttaches - 1);\n\t\tthis.dropIfUnowned(record);\n\t}\n\n\tcommitDaemonRuntime(claim: DaemonAttachClaim, workspaceName: string, sessionId: string): DaemonAttachCommitOutcome {\n\t\tthis.abortDaemonAttach(claim);\n\t\tconst record = this.getOrCreateRecord(workspaceName, sessionId);\n\t\tif (record.state === \"tui-owned\") {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\treason: \"tui_owned\",\n\t\t\t\t...(record.tuiConnectionId ? { tuiConnectionId: record.tuiConnectionId } : {}),\n\t\t\t};\n\t\t}\n\t\tif (record.state === \"daemon-draining\") {\n\t\t\treturn { ok: false, reason: \"draining\" };\n\t\t}\n\t\tconst previousState = record.state;\n\t\tif (record.state === \"unowned\" || record.state === \"daemon-detached\") {\n\t\t\trecord.state = \"daemon-active\";\n\t\t\tthis.effects.audit({\n\t\t\t\ttype: \"lease_acquired\",\n\t\t\t\tworkspaceName,\n\t\t\t\tsessionId,\n\t\t\t\tdetails: { owner: \"daemon\", handoff: \"none\" },\n\t\t\t});\n\t\t} else if (record.state === \"daemon-active\") {\n\t\t\trecord.state = \"daemon-active\";\n\t\t}\n\t\treturn { ok: true, previousState };\n\t}\n\n\trollbackDaemonRuntimeCommit(workspaceName: string, sessionId: string, previousState: LeaseState): void {\n\t\tconst record = this.lookup(workspaceName, sessionId);\n\t\tif (!record || record.state === \"tui-owned\" || record.state === \"daemon-draining\") {\n\t\t\treturn;\n\t\t}\n\t\trecord.state = previousState;\n\t\tif (previousState === \"unowned\") {\n\t\t\trecord.streamCount = 0;\n\t\t\tthis.dropIfUnowned(record);\n\t\t}\n\t}\n\n\t// ==========================================================================\n\t// TUI acquire / release / rekey\n\t// ==========================================================================\n\n\tasync acquireForTui(request: {\n\t\tconnectionId: string;\n\t\tworkspaceName: string;\n\t\tsessionId: string;\n\t\tforce?: boolean;\n\t}): Promise<LeaseAcquireOutcome> {\n\t\tconst { connectionId, workspaceName, sessionId } = request;\n\t\tif (request.force) {\n\t\t\tthis.effects.audit({\n\t\t\t\ttype: \"lease_denied\",\n\t\t\t\tworkspaceName,\n\t\t\t\tsessionId,\n\t\t\t\tdetails: { requester: connectionId, reason: \"force_unsupported\" },\n\t\t\t});\n\t\t\treturn { kind: \"denied\", reason: \"force_unsupported\" };\n\t\t}\n\t\tconst record = this.getOrCreateRecord(workspaceName, sessionId);\n\t\tswitch (record.state) {\n\t\t\tcase \"unowned\": {\n\t\t\t\trecord.state = \"tui-owned\";\n\t\t\t\trecord.tuiConnectionId = connectionId;\n\t\t\t\tthis.effects.audit({\n\t\t\t\t\ttype: \"lease_acquired\",\n\t\t\t\t\tworkspaceName,\n\t\t\t\t\tsessionId,\n\t\t\t\t\tdetails: { owner: \"tui\", handoff: \"none\", connectionId },\n\t\t\t\t});\n\t\t\t\treturn { kind: \"granted\", handoff: \"none\" };\n\t\t\t}\n\t\t\tcase \"tui-owned\": {\n\t\t\t\tif (record.tuiConnectionId === connectionId) {\n\t\t\t\t\treturn { kind: \"granted\", handoff: \"none\" };\n\t\t\t\t}\n\t\t\t\tthis.effects.audit({\n\t\t\t\t\ttype: \"lease_denied\",\n\t\t\t\t\tworkspaceName,\n\t\t\t\t\tsessionId,\n\t\t\t\t\tdetails: { requester: connectionId, reason: \"held_by_tui\" },\n\t\t\t\t});\n\t\t\t\treturn { kind: \"denied\", reason: \"held_by_tui\" };\n\t\t\t}\n\t\t\tcase \"daemon-draining\": {\n\t\t\t\tif (record.tuiConnectionId === connectionId && record.drain) {\n\t\t\t\t\tconst drain = record.drain;\n\t\t\t\t\treturn {\n\t\t\t\t\t\tkind: \"pending\",\n\t\t\t\t\t\tviewerFeedId: drain.viewerFeedId,\n\t\t\t\t\t\tgranted: new Promise((resolve, reject) => {\n\t\t\t\t\t\t\tconst previousResolve = drain.resolveGranted;\n\t\t\t\t\t\t\tconst previousReject = drain.rejectGranted;\n\t\t\t\t\t\t\tdrain.resolveGranted = (result) => {\n\t\t\t\t\t\t\t\tpreviousResolve(result);\n\t\t\t\t\t\t\t\tresolve(result);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\tdrain.rejectGranted = (error) => {\n\t\t\t\t\t\t\t\tpreviousReject(error);\n\t\t\t\t\t\t\t\treject(error);\n\t\t\t\t\t\t\t};\n\t\t\t\t\t\t}),\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tthis.effects.audit({\n\t\t\t\t\ttype: \"lease_denied\",\n\t\t\t\t\tworkspaceName,\n\t\t\t\t\tsessionId,\n\t\t\t\t\tdetails: { requester: connectionId, reason: \"draining_elsewhere\" },\n\t\t\t\t});\n\t\t\t\treturn { kind: \"denied\", reason: \"draining_elsewhere\" };\n\t\t\t}\n\t\t\tcase \"daemon-detached\":\n\t\t\tcase \"daemon-active\": {\n\t\t\t\tif (this.effects.isRuntimeStreaming(workspaceName, sessionId)) {\n\t\t\t\t\t// A mid-turn runtime ALWAYS drains before the handoff, even when\n\t\t\t\t\t// every phone has detached. Disposing a busy runtime abandons the\n\t\t\t\t\t// turn: its results (including completed subagent work buffered in\n\t\t\t\t\t// an in-flight tool call) are never persisted, and the transcript\n\t\t\t\t\t// is left with a dangling tool call. The acquiring TUI watches the\n\t\t\t\t\t// rest of the turn through the drain viewer feed and is granted\n\t\t\t\t\t// ownership once the runtime goes idle; it can cancel the drain by\n\t\t\t\t\t// releasing (Esc/quit), which leaves the turn running on the daemon.\n\t\t\t\t\treturn this.beginDrain(record, connectionId);\n\t\t\t\t}\n\t\t\t\t// Idle: dispose and grant immediately.\n\t\t\t\t// The flip to tui-owned happens BEFORE disposal so the disposal's\n\t\t\t\t// onDaemonRuntimeDisposed callback no-ops (it is part of this grant).\n\t\t\t\trecord.state = \"tui-owned\";\n\t\t\t\trecord.tuiConnectionId = connectionId;\n\t\t\t\ttry {\n\t\t\t\t\tawait this.effects.disposeRuntime(workspaceName, sessionId, \"lease_transferred_to_tui\");\n\t\t\t\t\tawait this.effects.closePhoneStreams(workspaceName, sessionId, LEASE_TRANSFERRED_CLOSE_REASON);\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Disposal failed after the premature tui-owned flip. Leaving the\n\t\t\t\t\t// lease tui-owned would strand the still-alive daemon runtime and\n\t\t\t\t\t// phone streams. Revert to a daemon-owned state and fail the acquire\n\t\t\t\t\t// (unless the connection already died and released the lease).\n\t\t\t\t\tif (record.state === \"tui-owned\" && record.tuiConnectionId === connectionId) {\n\t\t\t\t\t\trecord.state = record.streamCount > 0 ? \"daemon-active\" : \"daemon-detached\";\n\t\t\t\t\t\trecord.tuiConnectionId = undefined;\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t\trecord.streamCount = 0;\n\t\t\t\tif ((record.state as LeaseState) !== \"tui-owned\" || record.tuiConnectionId !== connectionId) {\n\t\t\t\t\t// The connection died while the disposal effects ran and the lease\n\t\t\t\t\t// was already released (releaseAllForConnection). The release path\n\t\t\t\t\t// audited; there is no live owner left to grant to.\n\t\t\t\t\tthis.dropIfUnowned(record);\n\t\t\t\t\treturn { kind: \"granted\", handoff: \"warm\" };\n\t\t\t\t}\n\t\t\t\tthis.effects.audit({\n\t\t\t\t\ttype: \"lease_acquired\",\n\t\t\t\t\tworkspaceName,\n\t\t\t\t\tsessionId,\n\t\t\t\t\tdetails: { owner: \"tui\", handoff: \"warm\", connectionId },\n\t\t\t\t});\n\t\t\t\treturn { kind: \"granted\", handoff: \"warm\" };\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate beginDrain(record: LeaseRecord, connectionId: string): LeaseAcquireOutcome {\n\t\tconst viewerFeedId = this.effects.generateViewerFeedId?.() ?? `vf-${randomUUID()}`;\n\t\trecord.state = \"daemon-draining\";\n\t\trecord.tuiConnectionId = connectionId;\n\t\tlet resolveGranted: (result: { handoff: \"warm\" }) => void = () => {};\n\t\tlet rejectGranted: (error: Error) => void = () => {};\n\t\tconst granted = new Promise<{ handoff: \"warm\" }>((resolve, reject) => {\n\t\t\tresolveGranted = resolve;\n\t\t\trejectGranted = reject;\n\t\t});\n\t\tgranted.catch(() => {});\n\t\trecord.drain = {\n\t\t\tviewerFeedId,\n\t\t\tstartedAtMs: Date.now(),\n\t\t\tcancelled: false,\n\t\t\tdisposing: false,\n\t\t\tresolveGranted,\n\t\t\trejectGranted,\n\t\t};\n\t\tthis.effects.onDrainStarted?.(record, viewerFeedId);\n\t\tvoid this.runDrain(record);\n\t\treturn { kind: \"pending\", viewerFeedId, granted };\n\t}\n\n\tprivate async runDrain(record: LeaseRecord): Promise<void> {\n\t\tconst drain = record.drain;\n\t\tif (!drain) {\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\tawait this.effects.waitForRuntimeIdle(record.workspaceName, record.sessionId);\n\t\t} catch (error) {\n\t\t\tif (!drain.cancelled && record.drain === drain) {\n\t\t\t\trecord.drain = undefined;\n\t\t\t\trecord.state = record.streamCount > 0 ? \"daemon-active\" : \"daemon-detached\";\n\t\t\t\trecord.tuiConnectionId = undefined;\n\t\t\t\tthis.effects.onDrainEnded?.(record, drain.viewerFeedId, \"error\");\n\t\t\t\tdrain.rejectGranted(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\tif (drain.cancelled || record.drain !== drain) {\n\t\t\treturn;\n\t\t}\n\t\t// From here disposal is irreversible: record.drain stays set so a\n\t\t// cancellation landing during these awaits is visible afterwards, and\n\t\t// cancelDrain defers the final transition to this continuation.\n\t\tdrain.disposing = true;\n\t\ttry {\n\t\t\tawait this.effects.disposeRuntime(record.workspaceName, record.sessionId, \"lease_transferred_to_tui\");\n\t\t\tawait this.effects.closePhoneStreams(record.workspaceName, record.sessionId, LEASE_TRANSFERRED_CLOSE_REASON);\n\t\t} catch (error) {\n\t\t\t// This phase is otherwise unguarded, so a disposal failure (e.g. a\n\t\t\t// state-manager IO error) would wedge the lease in daemon-draining forever\n\t\t\t// and leave the acquiring TUI's grant promise unsettled. Recover: clear the\n\t\t\t// drain, settle the grant, and move to a state a later acquire can retry\n\t\t\t// from (unowned when the requester already gave up, else daemon-owned).\n\t\t\tif (record.drain === drain) {\n\t\t\t\trecord.drain = undefined;\n\t\t\t\trecord.tuiConnectionId = undefined;\n\t\t\t}\n\t\t\tif (drain.cancelled) {\n\t\t\t\t// Zero the stream count before dropping. dropIfUnowned requires\n\t\t\t\t// streamCount === 0, so leaving it stale here (the success path resets it\n\t\t\t\t// at the bottom of runDrain, but this early return skips that) would\n\t\t\t\t// strand the record in `records` as an undroppable \"unowned\" ghost that\n\t\t\t\t// then hands a phantom stream count to the next acquire.\n\t\t\t\trecord.streamCount = 0;\n\t\t\t\trecord.state = \"unowned\";\n\t\t\t\tthis.dropIfUnowned(record);\n\t\t\t} else {\n\t\t\t\trecord.state = record.streamCount > 0 ? \"daemon-active\" : \"daemon-detached\";\n\t\t\t\tthis.effects.onDrainEnded?.(record, drain.viewerFeedId, \"error\");\n\t\t\t\tdrain.rejectGranted(error instanceof Error ? error : new Error(String(error)));\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\t\trecord.drain = undefined;\n\t\trecord.streamCount = 0;\n\t\tif (drain.cancelled) {\n\t\t\t// The requesting connection died mid-disposal. The runtime is gone, so\n\t\t\t// the lease returns to unowned instead of granting to a dead owner.\n\t\t\trecord.state = \"unowned\";\n\t\t\trecord.tuiConnectionId = undefined;\n\t\t\tthis.effects.audit({\n\t\t\t\ttype: \"lease_released\",\n\t\t\t\tworkspaceName: record.workspaceName,\n\t\t\t\tsessionId: record.sessionId,\n\t\t\t\tdetails: { owner: \"daemon\", reason: \"connection_lost\", drainCancelledDuringDisposal: true },\n\t\t\t});\n\t\t\tthis.dropIfUnowned(record);\n\t\t\treturn;\n\t\t}\n\t\trecord.state = \"tui-owned\";\n\t\tthis.effects.onDrainEnded?.(record, drain.viewerFeedId, \"granted\");\n\t\tthis.effects.audit({\n\t\t\ttype: \"lease_acquired\",\n\t\t\tworkspaceName: record.workspaceName,\n\t\t\tsessionId: record.sessionId,\n\t\t\tdetails: { owner: \"tui\", handoff: \"warm\", connectionId: record.tuiConnectionId },\n\t\t});\n\t\tdrain.resolveGranted({ handoff: \"warm\" });\n\t}\n\n\tprivate cancelDrain(record: LeaseRecord): void {\n\t\tconst drain = record.drain;\n\t\tif (!drain || drain.cancelled) {\n\t\t\treturn;\n\t\t}\n\t\tdrain.cancelled = true;\n\t\tif (drain.disposing) {\n\t\t\t// Runtime disposal already started and cannot be reverted; fail the\n\t\t\t// grant now and let runDrain's continuation finish the transition\n\t\t\t// (to unowned) once the disposal effects settle.\n\t\t\tthis.effects.onDrainEnded?.(record, drain.viewerFeedId, \"cancelled\");\n\t\t\tdrain.rejectGranted(new Error(\"drain cancelled\"));\n\t\t\treturn;\n\t\t}\n\t\trecord.drain = undefined;\n\t\trecord.tuiConnectionId = undefined;\n\t\trecord.state = record.streamCount > 0 ? \"daemon-active\" : \"daemon-detached\";\n\t\tthis.effects.onDrainEnded?.(record, drain.viewerFeedId, \"cancelled\");\n\t\tdrain.rejectGranted(new Error(\"drain cancelled\"));\n\t}\n\n\treleaseFromTui(\n\t\tconnectionId: string,\n\t\tworkspaceName: string,\n\t\tsessionId: string,\n\t\treason: LeaseReleaseReason = \"quit\",\n\t): { ok: true } | { ok: false; code: \"not_held\" } {\n\t\tconst record = this.lookup(workspaceName, sessionId);\n\t\tif (record?.state === \"daemon-draining\" && record.tuiConnectionId === connectionId) {\n\t\t\t// The requesting TUI is abandoning its own pending drain (a change of\n\t\t\t// mind). Cancel it rather than letting runDrain complete and force-grant\n\t\t\t// an unwanted warm lease — which would needlessly dispose the daemon\n\t\t\t// runtime and close every phone stream for a handoff no one wants.\n\t\t\tthis.cancelDrain(record);\n\t\t\tthis.dropIfUnowned(record);\n\t\t\treturn { ok: true };\n\t\t}\n\t\tif (!record || record.state !== \"tui-owned\" || record.tuiConnectionId !== connectionId) {\n\t\t\treturn { ok: false, code: \"not_held\" };\n\t\t}\n\t\tthis.effects.closeRelays(record, \"lease_transferred\");\n\t\trecord.relayIds.clear();\n\t\trecord.state = \"unowned\";\n\t\trecord.tuiConnectionId = undefined;\n\t\tthis.effects.audit({\n\t\t\ttype: \"lease_released\",\n\t\t\tworkspaceName,\n\t\t\tsessionId,\n\t\t\tdetails: { owner: \"tui\", reason, connectionId },\n\t\t});\n\t\tthis.dropIfUnowned(record);\n\t\treturn { ok: true };\n\t}\n\n\t/** Connection died: implicit release of ALL leases held by connectionId. */\n\treleaseAllForConnection(connectionId: string): void {\n\t\tfor (const record of Array.from(this.records.values())) {\n\t\t\tif (record.state === \"tui-owned\" && record.tuiConnectionId === connectionId) {\n\t\t\t\tthis.releaseFromTui(connectionId, record.workspaceName, record.sessionId, \"connection_lost\");\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (record.state === \"daemon-draining\" && record.tuiConnectionId === connectionId) {\n\t\t\t\tthis.cancelDrain(record);\n\t\t\t}\n\t\t}\n\t}\n\n\trekey(workspaceName: string, oldSessionId: string, newSessionId: string): void {\n\t\tif (oldSessionId === newSessionId) {\n\t\t\treturn;\n\t\t}\n\t\tconst record = this.lookup(workspaceName, oldSessionId);\n\t\tif (!record) {\n\t\t\treturn;\n\t\t}\n\t\tconst newKey = getLeaseKey(workspaceName, newSessionId);\n\t\tconst displaced = this.records.get(newKey);\n\t\tif (displaced) {\n\t\t\t// The target session id already has its own lease record. A destructive\n\t\t\t// rekey would either orphan `record` (its old key removed but never\n\t\t\t// re-inserted) or silently drop the live `displaced` record from all\n\t\t\t// lease accounting, stranding its runtime/streams/relays. Refuse instead\n\t\t\t// and leave both records on their current keys; the caller re-acquires\n\t\t\t// under the new id on its next reconnect.\n\t\t\tthis.effects.audit({\n\t\t\t\ttype: \"lease_denied\",\n\t\t\t\tworkspaceName,\n\t\t\t\tsessionId: newSessionId,\n\t\t\t\tdetails: { reason: \"rekey_target_in_use\", oldSessionId, displacedState: displaced.state },\n\t\t\t});\n\t\t\treturn;\n\t\t}\n\t\tthis.records.delete(record.key);\n\t\trecord.sessionId = newSessionId;\n\t\trecord.key = newKey;\n\t\tthis.records.set(newKey, record);\n\t\tif (record.state === \"tui-owned\" && record.relayIds.size > 0) {\n\t\t\tthis.effects.closeRelays(record, \"session_rekeyed_reconnect\");\n\t\t\trecord.relayIds.clear();\n\t\t}\n\t}\n\n\t// ==========================================================================\n\t// Relay bookkeeping (tui-owned)\n\t// ==========================================================================\n\n\tregisterRelay(workspaceName: string, sessionId: string, relayId: string): void {\n\t\tconst record = this.lookup(workspaceName, sessionId);\n\t\tif (record?.state === \"tui-owned\") {\n\t\t\trecord.relayIds.add(relayId);\n\t\t}\n\t}\n\n\tunregisterRelay(workspaceName: string, sessionId: string, relayId: string): void {\n\t\tconst record = this.lookup(workspaceName, sessionId);\n\t\tif (record) {\n\t\t\trecord.relayIds.delete(relayId);\n\t\t\tthis.dropIfUnowned(record);\n\t\t}\n\t}\n\n\t// ==========================================================================\n\t// Daemon runtime lifecycle notifications\n\t// ==========================================================================\n\n\tonDaemonRuntimeAttached(workspaceName: string, sessionId: string): void {\n\t\tconst record = this.getOrCreateRecord(workspaceName, sessionId);\n\t\tif (record.state === \"unowned\" || record.state === \"daemon-detached\") {\n\t\t\trecord.state = \"daemon-active\";\n\t\t\tthis.effects.audit({\n\t\t\t\ttype: \"lease_acquired\",\n\t\t\t\tworkspaceName,\n\t\t\t\tsessionId,\n\t\t\t\tdetails: { owner: \"daemon\", handoff: \"none\" },\n\t\t\t});\n\t\t}\n\t}\n\n\tonDaemonRuntimeStreamCountChanged(workspaceName: string, sessionId: string, liveStreams: number): void {\n\t\tconst record = this.lookup(workspaceName, sessionId);\n\t\tif (!record) {\n\t\t\treturn;\n\t\t}\n\t\trecord.streamCount = liveStreams;\n\t\tif (record.state === \"daemon-draining\" || record.state === \"tui-owned\" || record.state === \"unowned\") {\n\t\t\t// Drain completes regardless of stream count; tui-owned counts relays instead.\n\t\t\treturn;\n\t\t}\n\t\trecord.state = liveStreams > 0 ? \"daemon-active\" : \"daemon-detached\";\n\t}\n\n\tonDaemonRuntimeDisposed(workspaceName: string, sessionId: string, reason: string): void {\n\t\tconst record = this.lookup(workspaceName, sessionId);\n\t\tif (!record) {\n\t\t\treturn;\n\t\t}\n\t\tif (record.state === \"daemon-draining\") {\n\t\t\t// Disposal is part of the drain flow (or shutdown subsumed it); the drain\n\t\t\t// path handles its own transition.\n\t\t\treturn;\n\t\t}\n\t\tif (record.state === \"tui-owned\") {\n\t\t\t// The runtime disposal that accompanies an immediate grant.\n\t\t\treturn;\n\t\t}\n\t\trecord.streamCount = 0;\n\t\trecord.state = \"unowned\";\n\t\tthis.effects.audit({\n\t\t\ttype: \"lease_released\",\n\t\t\tworkspaceName,\n\t\t\tsessionId,\n\t\t\tdetails: {\n\t\t\t\towner: \"daemon\",\n\t\t\t\treason: reason === \"detached_runtime_ttl_expired\" ? \"retention_expired\" : reason,\n\t\t\t},\n\t\t});\n\t\tthis.dropIfUnowned(record);\n\t}\n\n\tisDraining(workspaceName: string, sessionId: string): boolean {\n\t\treturn this.lookup(workspaceName, sessionId)?.state === \"daemon-draining\";\n\t}\n}\n"]}

package/dist/daemon/log.d.ts

@@ -0,0 +1,16 @@
+export type DaemonLogLevel = "debug" | "info" | "warn" | "error";
+export interface DaemonLogger {
+    log(level: DaemonLogLevel, subsystem: string, message: string, details?: Record<string, unknown>): void;
+    child(subsystem: string): (level: DaemonLogLevel, message: string, details?: Record<string, unknown>) => void;
+}
+export interface DaemonLoggerOptions {
+    logPath: string;
+    /** Also echo to stderr (foreground runs launched by hand). */
+    echoToStderr?: boolean;
+}
+/**
+ * Plain-text, greppable daemon log: `<iso8601> <level> <subsystem> <message> <json-details?>`.
+ * Rotates at 10 MiB keeping exactly one rotated file (voltd.log.1).
+ */
+export declare function createDaemonLogger(options: DaemonLoggerOptions): DaemonLogger;
+//# sourceMappingURL=log.d.ts.map

package/dist/daemon/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/daemon/log.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC5B,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC9G;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAkC7E","sourcesContent":["import { appendFileSync, existsSync, mkdirSync, renameSync, statSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nconst MAX_LOG_BYTES = 10 * 1024 * 1024;\n\nexport type DaemonLogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport interface DaemonLogger {\n\tlog(level: DaemonLogLevel, subsystem: string, message: string, details?: Record<string, unknown>): void;\n\tchild(subsystem: string): (level: DaemonLogLevel, message: string, details?: Record<string, unknown>) => void;\n}\n\nexport interface DaemonLoggerOptions {\n\tlogPath: string;\n\t/** Also echo to stderr (foreground runs launched by hand). */\n\techoToStderr?: boolean;\n}\n\n/**\n * Plain-text, greppable daemon log: `<iso8601> <level> <subsystem> <message> <json-details?>`.\n * Rotates at 10 MiB keeping exactly one rotated file (voltd.log.1).\n */\nexport function createDaemonLogger(options: DaemonLoggerOptions): DaemonLogger {\n\tmkdirSync(dirname(options.logPath), { recursive: true, mode: 0o700 });\n\n\tconst rotateIfNeeded = () => {\n\t\ttry {\n\t\t\tif (existsSync(options.logPath) && statSync(options.logPath).size >= MAX_LOG_BYTES) {\n\t\t\t\trenameSync(options.logPath, `${options.logPath}.1`);\n\t\t\t}\n\t\t} catch {\n\t\t\t// Rotation is best-effort; keep logging to the current file.\n\t\t}\n\t};\n\n\tconst log = (level: DaemonLogLevel, subsystem: string, message: string, details?: Record<string, unknown>) => {\n\t\tconst line = `${new Date().toISOString()} ${level} ${subsystem} ${message}${\n\t\t\tdetails === undefined ? \"\" : ` ${JSON.stringify(details)}`\n\t\t}\\n`;\n\t\ttry {\n\t\t\trotateIfNeeded();\n\t\t\tappendFileSync(options.logPath, line, { mode: 0o600 });\n\t\t} catch {\n\t\t\t// Logging must never crash the daemon.\n\t\t}\n\t\tif (options.echoToStderr) {\n\t\t\tprocess.stderr.write(line);\n\t\t}\n\t};\n\n\treturn {\n\t\tlog,\n\t\tchild(subsystem: string) {\n\t\t\treturn (level, message, details) => log(level, subsystem, message, details);\n\t\t},\n\t};\n}\n"]}