opensquid 0.5.395

package/dist/runtime/agent_bridge/event_bus.js

@@ -0,0 +1,56 @@
+/**
+ * agent_bridge — typed in-process event bus (WAB.2, 0.5.94).
+ *
+ * Authoritative source: `docs/tasks/WAB.1-architecture.md` decision (a) —
+ * in-process `EventEmitter` wrapper for v1; UDS deferred indefinitely.
+ * The chat-daemon already owns the inter-process boundary (its RPC
+ * server at `src/channels/daemon/rpc_server.ts`); the warm-agent
+ * needs only an INTRA-process bus to wire transport_bridge →
+ * batch_coordinator → session_manager → agent_loop.
+ *
+ * Why a typed wrapper, not raw EventEmitter:
+ *   - The base `events.EventEmitter` types listeners as `(...args: any[])`.
+ *     Forcing the event-map shape at the type layer eliminates a
+ *     whole class of "I emitted but the listener never fired" bugs that
+ *     come from typos in event names or mismatched payload shapes.
+ *   - The `emit` overload returns `boolean` (whether any listener fired);
+ *     we preserve that contract so callers can react to "nobody listening
+ *     yet" (e.g. drop the event vs buffer it).
+ *
+ * Listener error policy (per WAB.1 (a) risk callout):
+ *   EventEmitter is synchronous-emit; if a listener throws, the rest of
+ *   the listener chain still runs (since Node 14). Async listener
+ *   rejections do NOT propagate to the emitter — callers MUST wrap their
+ *   own async work in try/catch and surface failures via their own
+ *   audit/log sink. This bus does NOT install a global error handler
+ *   because every listener has different failure semantics (transport
+ *   parse error vs agent-loop timeout vs ack ordering).
+ *
+ * Imports from: node:events, ./types.js.
+ * Imported by: transport_bridge.ts, (future) batch.ts, dispatcher.ts.
+ */
+import { EventEmitter } from 'node:events';
+// ---------------------------------------------------------------------------
+// AgentEventBus — typed EventEmitter facade.
+//
+// Subclassing `EventEmitter` (rather than composing) is intentional:
+//   - Inheriting the well-tested `removeAllListeners` / `listenerCount` /
+//     etc. surface without re-implementing or proxying every method.
+//   - The `on` / `off` / `emit` overrides narrow the inherited signatures
+//     to the typed event map; consumers see only `K extends keyof AgentBridgeEvents`.
+// ---------------------------------------------------------------------------
+export class AgentEventBus extends EventEmitter {
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+}
+//# sourceMappingURL=event_bus.js.map

package/dist/runtime/agent_bridge/event_bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event_bus.js","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/event_bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgB3C,8EAA8E;AAC9E,6CAA6C;AAC7C,EAAE;AACF,qEAAqE;AACrE,0EAA0E;AAC1E,qEAAqE;AACrE,0EAA0E;AAC1E,sFAAsF;AACtF,8EAA8E;AAE9E,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,EAAE,CAAoC,KAAQ,EAAE,QAA8B;QAC5E,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAoC,KAAQ,EAAE,QAA8B;QAC9E,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACrE,CAAC;IAED,GAAG,CAAoC,KAAQ,EAAE,QAA8B;QAC7E,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAwC,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,CACF,KAAQ,EACR,GAAG,IAAsC;QAEzC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/runtime/agent_bridge/headless_lease.d.ts

@@ -0,0 +1,113 @@
+/**
+ * agent_bridge — headless lease handoff (T-CHAT-AS-TERMINAL CAT.5).
+ *
+ * North star (invariant #7): when an umbrella has NO live human session, the
+ * always-on agent-bridge daemon runs HEADLESS — it holds the umbrella's chat
+ * lease, resumes the SAME session, and answers chat. When a human session's
+ * lease appears, the headless daemon STANDS DOWN (stops answering) but the
+ * process stays alive; when the human lease goes stale again, the daemon
+ * RE-ACQUIRES. Exactly one chat-answering session per umbrella → no
+ * double-answer / 409.
+ *
+ * State machine (one umbrella):
+ *
+ *        ┌─────────────── acquire ────────────────┐
+ *        │  (no fresh lease, or the fresh lease    │
+ *        │   is already OUR headless id)           │
+ *        ▼                                          │
+ *   ┌─────────┐   human lease appears (fresh,     ┌─────────────┐
+ *   │  HELD   │── owned by someone else) ───────▶ │  STOOD-DOWN  │
+ *   │ (ours)  │                                   │ (not ours)   │
+ *   └─────────┘ ◀── that lease goes STALE ─────── └─────────────┘
+ *        │ heartbeat (30s, fs touch) while HELD        │ reclaimCheck (60s) re-attempts acquire
+ *        ▼                                              ▼ when the foreign lease lapses
+ *
+ * ZERO IDLE TOKEN COST: the heartbeat is a pure `refreshLease` (one fs write).
+ * There is NO keep-warm / ping loop here and none anywhere in the bridge — the
+ * only model call happens on a real inbound (the dispatcher), never on the
+ * heartbeat/reclaim ticks. The process simply parks between turns.
+ *
+ * Holder identity: the headless session id is `headless-<umbrellaId>` — stable
+ * across the daemon's lifetime so (a) the lease's `session_id` reliably tells
+ * "ours vs theirs" for the double-holder guard, and (b) subscription resume
+ * (`--resume headless-<umbrellaId>`) always threads the SAME claude session.
+ *
+ * Imports from: node:timers, ../chat/live_session_lease, ../paths.
+ * Imported by: ./daemon.ts (wires acquire + start on daemon start, stop on
+ *   shutdown), tests.
+ */
+/** Heartbeat cadence — refresh OUR lease so a live `chat watch` never sees us
+ *  as stale. Matches the chat-watch HEARTBEAT_MS (well under STALE_MS=90s). */
+export declare const HEADLESS_HEARTBEAT_MS = 30000;
+/** Reclaim cadence — re-check whether a foreign lease has gone stale so we can
+ *  re-acquire. Folded into the same ticker as the heartbeat for simplicity. */
+export declare const HEADLESS_RECLAIM_MS = 60000;
+/** Stable headless holder id for an umbrella. */
+export declare function headlessSessionId(umbrellaId: string): string;
+export interface HeadlessLeaseManagerOptions {
+    umbrellaId: string;
+    /** Injected timers (tests). Default node setInterval/clearInterval. */
+    setIntervalFn?: (handler: () => void, ms: number) => ReturnType<typeof setInterval>;
+    clearIntervalFn?: (handle: ReturnType<typeof setInterval>) => void;
+    /** Injected clock (tests). Default `() => new Date()`. */
+    now?: () => Date;
+    /** Heartbeat/reclaim cadence override (tests). Default HEADLESS_HEARTBEAT_MS. */
+    tickMs?: number;
+    /** Structured warn sink for lease-io failures. Default no-op. */
+    onWarn?: (message: string) => void;
+}
+/**
+ * Owns the headless lease lifecycle for ONE umbrella. The daemon constructs
+ * one, `start()`s it (acquire-if-free + begin the heartbeat ticker), and
+ * `stop()`s it on shutdown (release our hold + stop the ticker). The dispatcher
+ * reads the SAME lease file (ownership-aware) at flush time — this manager
+ * never gates the dispatcher directly; it only keeps the on-disk lease correct.
+ */
+export declare class HeadlessLeaseManager {
+    private readonly umbrellaId;
+    private readonly leasePath;
+    private readonly sessionId;
+    private readonly setIntervalFn;
+    private readonly clearIntervalFn;
+    private readonly now;
+    private readonly tickMs;
+    private readonly warn;
+    private timer;
+    /** True while WE currently hold the lease (our id, fresh). Drives whether
+     *  the heartbeat refreshes (HELD) vs. the reclaim re-attempts (STOOD-DOWN). */
+    private held;
+    private stopped;
+    constructor(opts: HeadlessLeaseManagerOptions);
+    /** This daemon's stable headless session id (`headless-<umbrellaId>`). */
+    get headlessId(): string;
+    /** True iff we currently hold the lease. */
+    get isHolding(): boolean;
+    /**
+     * Try to acquire the lease IFF it is free for us. Returns true ⇒ we now hold
+     * (the on-disk lease carries our headless id). Returns false ⇒ a DIFFERENT
+     * fresh lease exists (human or other) → we stand down.
+     *
+     *   - no fresh lease (absent / stale)                → writeLease(ours) + true
+     *   - fresh lease ALREADY ours (idempotent re-acq)   → refresh + true
+     *   - fresh lease owned by someone else              → false (stand down)
+     */
+    acquireIfFree(): Promise<boolean>;
+    /**
+     * One heartbeat+reclaim tick. fs-only — NO model/SDK call.
+     *   - HELD (our lease still fresh + ours)        → refresh the timestamp.
+     *   - HELD but the lease flipped to someone else → stand down (stop holding).
+     *   - NOT held + the foreign lease is now stale  → re-acquire.
+     *   - NOT held + a fresh foreign lease remains   → stay stood-down.
+     */
+    tick(): Promise<void>;
+    /** Acquire-if-free, then start the heartbeat/reclaim ticker. Idempotent. */
+    start(): Promise<void>;
+    /**
+     * Stop the ticker and RELEASE our hold (best-effort) so a freshly-opened
+     * terminal isn't blocked by a stale headless lease on clean shutdown. We
+     * only remove the lease if it is still OURS — never clobber a human's lease.
+     * Idempotent.
+     */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=headless_lease.d.ts.map

package/dist/runtime/agent_bridge/headless_lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless_lease.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/headless_lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAYH;+EAC+E;AAC/E,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C;+EAC+E;AAC/E,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACpF,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,KAAK,IAAI,CAAC;IACnE,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAGM;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmD;IACnF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,KAAK,CAA+C;IAC5D;mFAC+E;IAC/E,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,2BAA2B;IAW7C,0EAA0E;IAC1E,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,4CAA4C;IAC5C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;;;OAQG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAsBvC;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,4EAA4E;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAa5B"}

package/dist/runtime/agent_bridge/headless_lease.js

@@ -0,0 +1,190 @@
+/**
+ * agent_bridge — headless lease handoff (T-CHAT-AS-TERMINAL CAT.5).
+ *
+ * North star (invariant #7): when an umbrella has NO live human session, the
+ * always-on agent-bridge daemon runs HEADLESS — it holds the umbrella's chat
+ * lease, resumes the SAME session, and answers chat. When a human session's
+ * lease appears, the headless daemon STANDS DOWN (stops answering) but the
+ * process stays alive; when the human lease goes stale again, the daemon
+ * RE-ACQUIRES. Exactly one chat-answering session per umbrella → no
+ * double-answer / 409.
+ *
+ * State machine (one umbrella):
+ *
+ *        ┌─────────────── acquire ────────────────┐
+ *        │  (no fresh lease, or the fresh lease    │
+ *        │   is already OUR headless id)           │
+ *        ▼                                          │
+ *   ┌─────────┐   human lease appears (fresh,     ┌─────────────┐
+ *   │  HELD   │── owned by someone else) ───────▶ │  STOOD-DOWN  │
+ *   │ (ours)  │                                   │ (not ours)   │
+ *   └─────────┘ ◀── that lease goes STALE ─────── └─────────────┘
+ *        │ heartbeat (30s, fs touch) while HELD        │ reclaimCheck (60s) re-attempts acquire
+ *        ▼                                              ▼ when the foreign lease lapses
+ *
+ * ZERO IDLE TOKEN COST: the heartbeat is a pure `refreshLease` (one fs write).
+ * There is NO keep-warm / ping loop here and none anywhere in the bridge — the
+ * only model call happens on a real inbound (the dispatcher), never on the
+ * heartbeat/reclaim ticks. The process simply parks between turns.
+ *
+ * Holder identity: the headless session id is `headless-<umbrellaId>` — stable
+ * across the daemon's lifetime so (a) the lease's `session_id` reliably tells
+ * "ours vs theirs" for the double-holder guard, and (b) subscription resume
+ * (`--resume headless-<umbrellaId>`) always threads the SAME claude session.
+ *
+ * Imports from: node:timers, ../chat/live_session_lease, ../paths.
+ * Imported by: ./daemon.ts (wires acquire + start on daemon start, stop on
+ *   shutdown), tests.
+ */
+import { isLeaseFresh, isLeaseFreshAndOwnedBy, readLease, refreshLease, removeLease, writeLease, } from '../chat/live_session_lease.js';
+import { umbrellaLiveSessionLease } from '../paths.js';
+/** Heartbeat cadence — refresh OUR lease so a live `chat watch` never sees us
+ *  as stale. Matches the chat-watch HEARTBEAT_MS (well under STALE_MS=90s). */
+export const HEADLESS_HEARTBEAT_MS = 30_000;
+/** Reclaim cadence — re-check whether a foreign lease has gone stale so we can
+ *  re-acquire. Folded into the same ticker as the heartbeat for simplicity. */
+export const HEADLESS_RECLAIM_MS = 60_000;
+/** Stable headless holder id for an umbrella. */
+export function headlessSessionId(umbrellaId) {
+    return `headless-${umbrellaId}`;
+}
+/**
+ * Owns the headless lease lifecycle for ONE umbrella. The daemon constructs
+ * one, `start()`s it (acquire-if-free + begin the heartbeat ticker), and
+ * `stop()`s it on shutdown (release our hold + stop the ticker). The dispatcher
+ * reads the SAME lease file (ownership-aware) at flush time — this manager
+ * never gates the dispatcher directly; it only keeps the on-disk lease correct.
+ */
+export class HeadlessLeaseManager {
+    umbrellaId;
+    leasePath;
+    sessionId;
+    setIntervalFn;
+    clearIntervalFn;
+    now;
+    tickMs;
+    warn;
+    timer = null;
+    /** True while WE currently hold the lease (our id, fresh). Drives whether
+     *  the heartbeat refreshes (HELD) vs. the reclaim re-attempts (STOOD-DOWN). */
+    held = false;
+    stopped = false;
+    constructor(opts) {
+        this.umbrellaId = opts.umbrellaId;
+        this.leasePath = umbrellaLiveSessionLease(opts.umbrellaId);
+        this.sessionId = headlessSessionId(opts.umbrellaId);
+        this.setIntervalFn = opts.setIntervalFn ?? ((h, ms) => setInterval(h, ms));
+        this.clearIntervalFn = opts.clearIntervalFn ?? ((t) => clearInterval(t));
+        this.now = opts.now ?? (() => new Date());
+        this.tickMs = opts.tickMs ?? HEADLESS_HEARTBEAT_MS;
+        this.warn = opts.onWarn ?? noop;
+    }
+    /** This daemon's stable headless session id (`headless-<umbrellaId>`). */
+    get headlessId() {
+        return this.sessionId;
+    }
+    /** True iff we currently hold the lease. */
+    get isHolding() {
+        return this.held;
+    }
+    /**
+     * Try to acquire the lease IFF it is free for us. Returns true ⇒ we now hold
+     * (the on-disk lease carries our headless id). Returns false ⇒ a DIFFERENT
+     * fresh lease exists (human or other) → we stand down.
+     *
+     *   - no fresh lease (absent / stale)                → writeLease(ours) + true
+     *   - fresh lease ALREADY ours (idempotent re-acq)   → refresh + true
+     *   - fresh lease owned by someone else              → false (stand down)
+     */
+    async acquireIfFree() {
+        const now = this.now();
+        const lease = await readLease(this.leasePath);
+        if (lease !== null && isLeaseFresh(lease, now) && lease.session_id !== this.sessionId) {
+            // Someone else holds a fresh lease — stand down.
+            this.held = false;
+            return false;
+        }
+        // Free (absent/stale) OR already ours → (re)write our lease.
+        try {
+            await writeLease(this.leasePath, this.sessionId, now);
+            this.held = true;
+            return true;
+        }
+        catch (err) {
+            this.warn(`[agent_bridge.headless_lease] acquire failed (${this.umbrellaId}): ${describe(err)}`);
+            this.held = false;
+            return false;
+        }
+    }
+    /**
+     * One heartbeat+reclaim tick. fs-only — NO model/SDK call.
+     *   - HELD (our lease still fresh + ours)        → refresh the timestamp.
+     *   - HELD but the lease flipped to someone else → stand down (stop holding).
+     *   - NOT held + the foreign lease is now stale  → re-acquire.
+     *   - NOT held + a fresh foreign lease remains   → stay stood-down.
+     */
+    async tick() {
+        if (this.stopped)
+            return;
+        const now = this.now();
+        const lease = await readLease(this.leasePath);
+        if (this.held) {
+            if (isLeaseFreshAndOwnedBy(lease, this.sessionId, now)) {
+                // Still ours → keep it warm (single fs write).
+                try {
+                    await refreshLease(this.leasePath, now);
+                }
+                catch (err) {
+                    this.warn(`[agent_bridge.headless_lease] heartbeat failed (${this.umbrellaId}): ${describe(err)}`);
+                }
+                return;
+            }
+            // A human (or other) took the lease while we held it → stand down.
+            this.held = false;
+            return;
+        }
+        // Not holding → re-acquire only if the lease is free (absent/stale/ours).
+        await this.acquireIfFree();
+    }
+    /** Acquire-if-free, then start the heartbeat/reclaim ticker. Idempotent. */
+    async start() {
+        if (this.stopped)
+            throw new Error('HeadlessLeaseManager.start: cannot restart after stop');
+        if (this.timer !== null)
+            return;
+        await this.acquireIfFree();
+        this.timer = this.setIntervalFn(() => {
+            void this.tick();
+        }, this.tickMs);
+        // Don't keep the event loop alive solely for the heartbeat — the daemon's
+        // transport watcher is the process's anchor.
+        this.timer.unref?.();
+    }
+    /**
+     * Stop the ticker and RELEASE our hold (best-effort) so a freshly-opened
+     * terminal isn't blocked by a stale headless lease on clean shutdown. We
+     * only remove the lease if it is still OURS — never clobber a human's lease.
+     * Idempotent.
+     */
+    async stop() {
+        if (this.stopped)
+            return;
+        this.stopped = true;
+        if (this.timer !== null) {
+            this.clearIntervalFn(this.timer);
+            this.timer = null;
+        }
+        const lease = await readLease(this.leasePath);
+        if (lease !== null && lease.session_id === this.sessionId) {
+            await removeLease(this.leasePath);
+        }
+        this.held = false;
+    }
+}
+const noop = () => {
+    /* default sink */
+};
+function describe(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=headless_lease.js.map

package/dist/runtime/agent_bridge/headless_lease.js.map

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

package/dist/runtime/agent_bridge/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * agent_bridge — warm-pool chat-agent shell.
+ *
+ * Authoritative spec: `docs/tasks/T-warm-agent-chat-bridge.md` +
+ * `docs/tasks/WAB.1-architecture.md`. Currently shipped slices:
+ *   - WAB.2 (0.5.94): types, typed event bus, transport bridge.
+ *   - WAB.3 (0.5.95): SessionManager + SessionPersistence + history types.
+ *   - WAB.4 (0.5.97): runAgentTurn + SimpleToolDispatcher (skipped
+ *     0.5.96 — burned in a parallel WIZ.2 slice that WAB.3 reset over).
+ *   - WAB.5 (0.5.99): BatchCoordinator + ChatDispatcher (adaptive
+ *     batching window + per-session mutex/queue glue).
+ *   - WAB.6 (0.5.100): pack_binding + 3 built-in tools (chat_send,
+ *     recall, store_lesson) + chat_agent.yaml pack side-file load.
+ * WAB.7+ will add daemon + CLI.
+ *
+ * Re-exports are flat (no nested namespaces) so consumers can write
+ * `import { InboxTransportBridge, AgentEventBus, ... } from '<root>/runtime'`.
+ *
+ * Imports from: ./types.js, ./event_bus.js, ./transport_bridge.js,
+ *   ./session_manager.js, ./session_persistence.js, ./agent_loop.js,
+ *   ./tool_dispatcher.js, ./batch.js, ./dispatcher.js.
+ * Imported by: src/runtime/index.ts (barrel).
+ */
+export { SessionPlatform, sessionKeySchema, type SessionKey, sessionKeyString, inboundChatEventSchema, type InboundChatEvent, outboundChatReplySchema, type OutboundChatReply, chatHistoryContentBlockSchema, type ChatHistoryContentBlock, chatHistoryEntrySchema, type ChatHistoryEntry, type SessionState, type ToolSpec, type ToolContext, type ToolHandler, type ToolDispatcher, } from './types.js';
+export { type AgentBridgeEvents, AgentEventBus } from './event_bus.js';
+export { InboxTransportBridge, type TransportBridgeOptions } from './transport_bridge.js';
+export { SessionPersistence, type SessionPersistenceOptions, encodeSessionSlug, } from './session_persistence.js';
+export { AGENT_CACHE_MAX_SIZE, AGENT_CACHE_IDLE_TTL_MS, type EvictionReason, SessionManager, type SessionManagerOptions, } from './session_manager.js';
+export { SimpleToolDispatcher, type ToolRegistration } from './tool_dispatcher.js';
+export { DEFAULT_SUBSCRIPTION_TIMEOUT_MS, SUBSCRIPTION_HISTORY_SNIPPET_LEN, buildPromptBody, defaultClaudeCliClient, runAgentTurnSubscription, type ClaudeCliClient, type ClaudeCliRunRequest, type RunAgentTurnSubscriptionOptions, type RunAgentTurnSubscriptionResult, } from './agent_loop_subscription.js';
+export { MAX_TOOL_ITERATIONS, DEFAULT_MAX_TOKENS, CACHE_BREAKPOINT_USER_MSGS, runAgentTurn, type RunAgentTurnOptions, type RunAgentTurnResult, type AnthropicCacheControl, type AnthropicTextBlockParam, type AnthropicToolUseBlockParam, type AnthropicToolResultBlockParam, type AnthropicContentBlockParam, type AnthropicMessageParam, type AnthropicSystemBlock, type AnthropicResponseTextBlock, type AnthropicResponseToolUseBlock, type AnthropicResponseBlock, type AnthropicMessageResponse, type AnthropicMessageCreateParams, type AnthropicMessageClient, } from './agent_loop.js';
+export { BatchCoordinator, type BatchCoordinatorOptions, TG_SPLIT_THRESHOLD, TEXT_BATCH_FAST_LEN, TEXT_BATCH_SHORT_LEN, TEXT_BATCH_FAST_DELAY_MS, TEXT_BATCH_SHORT_DELAY_MS, TEXT_BATCH_DELAY_MS_DEFAULT, TEXT_BATCH_SPLIT_DELAY_MS, } from './batch.js';
+export { ChatDispatcher, type ChatDispatcherOptions, type DispatcherAgentLoopOptions, } from './dispatcher.js';
+export { HeadlessLeaseManager, type HeadlessLeaseManagerOptions, headlessSessionId, HEADLESS_HEARTBEAT_MS, HEADLESS_RECLAIM_MS, } from './headless_lease.js';
+export { buildChatToolDispatcher, type BuildChatToolDispatcherOptions, type BuildChatToolDispatcherResult, type ResolvedAgentTurn, } from './pack_binding.js';
+export { defaultMcpConfigPath, defaultMcpServers, materializeDefaultMcpConfig, resolveMcpConfigPath, type McpConfigDocument, type McpServerEntry, type MaterializeMcpConfigOptions, type ResolveMcpConfigOptions, } from './mcp_config.js';
+export { BUILT_INS, chatSendSpec, defaultDaemonSend, makeChatSendHandler, makeRecallHandler, makeStoreLessonHandler, recallSpec, storeLessonBufferPath, storeLessonSpec, type DaemonSendFn, type DaemonSendParams, type MakeStoreLessonHandlerOptions, } from './tools/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/agent_bridge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,UAAU,EACf,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,eAAe,EACf,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,EACpC,KAAK,8BAA8B,GACpC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EAClC,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,GAChC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,EACvB,KAAK,8BAA8B,EACnC,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC"}

package/dist/runtime/agent_bridge/index.js

@@ -0,0 +1,38 @@
+/**
+ * agent_bridge — warm-pool chat-agent shell.
+ *
+ * Authoritative spec: `docs/tasks/T-warm-agent-chat-bridge.md` +
+ * `docs/tasks/WAB.1-architecture.md`. Currently shipped slices:
+ *   - WAB.2 (0.5.94): types, typed event bus, transport bridge.
+ *   - WAB.3 (0.5.95): SessionManager + SessionPersistence + history types.
+ *   - WAB.4 (0.5.97): runAgentTurn + SimpleToolDispatcher (skipped
+ *     0.5.96 — burned in a parallel WIZ.2 slice that WAB.3 reset over).
+ *   - WAB.5 (0.5.99): BatchCoordinator + ChatDispatcher (adaptive
+ *     batching window + per-session mutex/queue glue).
+ *   - WAB.6 (0.5.100): pack_binding + 3 built-in tools (chat_send,
+ *     recall, store_lesson) + chat_agent.yaml pack side-file load.
+ * WAB.7+ will add daemon + CLI.
+ *
+ * Re-exports are flat (no nested namespaces) so consumers can write
+ * `import { InboxTransportBridge, AgentEventBus, ... } from '<root>/runtime'`.
+ *
+ * Imports from: ./types.js, ./event_bus.js, ./transport_bridge.js,
+ *   ./session_manager.js, ./session_persistence.js, ./agent_loop.js,
+ *   ./tool_dispatcher.js, ./batch.js, ./dispatcher.js.
+ * Imported by: src/runtime/index.ts (barrel).
+ */
+export { SessionPlatform, sessionKeySchema, sessionKeyString, inboundChatEventSchema, outboundChatReplySchema, chatHistoryContentBlockSchema, chatHistoryEntrySchema, } from './types.js';
+export { AgentEventBus } from './event_bus.js';
+export { InboxTransportBridge } from './transport_bridge.js';
+export { SessionPersistence, encodeSessionSlug, } from './session_persistence.js';
+export { AGENT_CACHE_MAX_SIZE, AGENT_CACHE_IDLE_TTL_MS, SessionManager, } from './session_manager.js';
+export { SimpleToolDispatcher } from './tool_dispatcher.js';
+export { DEFAULT_SUBSCRIPTION_TIMEOUT_MS, SUBSCRIPTION_HISTORY_SNIPPET_LEN, buildPromptBody, defaultClaudeCliClient, runAgentTurnSubscription, } from './agent_loop_subscription.js';
+export { MAX_TOOL_ITERATIONS, DEFAULT_MAX_TOKENS, CACHE_BREAKPOINT_USER_MSGS, runAgentTurn, } from './agent_loop.js';
+export { BatchCoordinator, TG_SPLIT_THRESHOLD, TEXT_BATCH_FAST_LEN, TEXT_BATCH_SHORT_LEN, TEXT_BATCH_FAST_DELAY_MS, TEXT_BATCH_SHORT_DELAY_MS, TEXT_BATCH_DELAY_MS_DEFAULT, TEXT_BATCH_SPLIT_DELAY_MS, } from './batch.js';
+export { ChatDispatcher, } from './dispatcher.js';
+export { HeadlessLeaseManager, headlessSessionId, HEADLESS_HEARTBEAT_MS, HEADLESS_RECLAIM_MS, } from './headless_lease.js';
+export { buildChatToolDispatcher, } from './pack_binding.js';
+export { defaultMcpConfigPath, defaultMcpServers, materializeDefaultMcpConfig, resolveMcpConfigPath, } from './mcp_config.js';
+export { BUILT_INS, chatSendSpec, defaultDaemonSend, makeChatSendHandler, makeRecallHandler, makeStoreLessonHandler, recallSpec, storeLessonBufferPath, storeLessonSpec, } from './tools/index.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/agent_bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EACL,eAAe,EACf,gBAAgB,EAEhB,gBAAgB,EAChB,sBAAsB,EAEtB,uBAAuB,EAEvB,6BAA6B,EAE7B,sBAAsB,GAOvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAA0B,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAA+B,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EACL,kBAAkB,EAElB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EAEvB,cAAc,GAEf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAyB,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,EAChC,eAAe,EACf,sBAAsB,EACtB,wBAAwB,GAKzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,YAAY,GAgBb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAEhB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,cAAc,GAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EAEpB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,GAIxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,GAKrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,EACV,qBAAqB,EACrB,eAAe,GAIhB,MAAM,kBAAkB,CAAC"}

package/dist/runtime/agent_bridge/mcp_config.d.ts

@@ -0,0 +1,68 @@
+/**
+ * agent_bridge — MCP config materialization helper (WAB-SUB.2, 0.5.106).
+ *
+ * Spec: WAB-SUB.2 task — "Pass MCP config path through to subscription-mode
+ * opts so spawned claude can find opensquid's tools".
+ *
+ * Responsibility:
+ *   When the agent-bridge daemon runs in subscription mode, the spawned
+ *   `claude --print` subprocess needs to know how to reach opensquid's MCP
+ *   servers (`opensquid-mcp` read-only inspection + `opensquid-chat-bridge-mcp`
+ *   mutation surface). We materialize a JSON file at a known path with the
+ *   stdio-transport entries the host expects (`mcpServers: { name: { command,
+ *   args, env } }` shape — matches `.mcp.json` / `claude_desktop_config.json`
+ *   convention).
+ *
+ * Default path: `${OPENSQUID_HOME()}/agent-bridge/mcp-config.json`. The
+ * file is OWNED by the daemon — overwritten on every start so a stale
+ * config from a previous opensquid install never silently misroutes the
+ * subscription subprocess. Users who want a custom config can point
+ * `OPENSQUID_AGENT_BRIDGE_MCP_CONFIG` at their own file; the materializer
+ * skips writing in that case (custom config is the user's responsibility).
+ *
+ * Why JSON not YAML: the MCP host convention (Anthropic + others) reads
+ * JSON. We emit what claude --mcp-config will accept verbatim.
+ *
+ * Why an opt-in helper not always-on: keeps api-mode daemons from paying
+ * the I/O cost for nothing; keeps test fixtures clean.
+ *
+ * Tool enumeration: we ship BOTH `opensquid-mcp` (read-only) and
+ * `opensquid-chat-bridge-mcp` (chat_send + chat_poll_inbox) so the spawned
+ * agent has full read+chat surface. Both bins live under `node_modules/.bin/`
+ * after `pnpm add opensquid`; the resolver below tries node_modules then
+ * falls back to PATH lookup so a globally-installed opensquid works too.
+ *
+ * Imports from: node:fs/promises, node:path, ../paths.js.
+ * Imported by: ./daemon.ts (subscription-mode start path),
+ *   ./mcp_config.test.ts.
+ */
+export interface McpServerEntry {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface McpConfigDocument {
+    mcpServers: Record<string, McpServerEntry>;
+}
+export interface MaterializeMcpConfigOptions {
+    /** Override target path (tests + custom-config users). */
+    targetPath?: string;
+    /** Override the OPENSQUID_HOME base (tests). */
+    daemonHome?: string;
+    /** Override env passthrough (e.g. forward OPENSQUID_HOME to the child). */
+    envPassthrough?: Record<string, string>;
+}
+/** Default location for the agent-bridge MCP config. */
+export declare const defaultMcpConfigPath: (home?: string) => string;
+export declare function defaultMcpServers(env?: Record<string, string>): Record<string, McpServerEntry>;
+export declare function materializeDefaultMcpConfig(opts?: MaterializeMcpConfigOptions): Promise<string>;
+export interface ResolveMcpConfigOptions {
+    /** Caller-supplied path override (skips materialization). */
+    explicitPath?: string;
+    /** Override env source (tests). Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Override daemon home (tests). */
+    daemonHome?: string;
+}
+export declare function resolveMcpConfigPath(opts?: ResolveMcpConfigOptions): Promise<string>;
+//# sourceMappingURL=mcp_config.d.ts.map

package/dist/runtime/agent_bridge/mcp_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_config.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/mcp_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAWH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAMD,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MACc,CAAC;AAapE,wBAAgB,iBAAiB,CAC/B,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAC/B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAWhC;AAaD,wBAAsB,2BAA2B,CAC/C,IAAI,GAAE,2BAAgC,GACrC,OAAO,CAAC,MAAM,CAAC,CASjB;AAeD,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,CAU9F"}

package/dist/runtime/agent_bridge/mcp_config.js

@@ -0,0 +1,102 @@
+/**
+ * agent_bridge — MCP config materialization helper (WAB-SUB.2, 0.5.106).
+ *
+ * Spec: WAB-SUB.2 task — "Pass MCP config path through to subscription-mode
+ * opts so spawned claude can find opensquid's tools".
+ *
+ * Responsibility:
+ *   When the agent-bridge daemon runs in subscription mode, the spawned
+ *   `claude --print` subprocess needs to know how to reach opensquid's MCP
+ *   servers (`opensquid-mcp` read-only inspection + `opensquid-chat-bridge-mcp`
+ *   mutation surface). We materialize a JSON file at a known path with the
+ *   stdio-transport entries the host expects (`mcpServers: { name: { command,
+ *   args, env } }` shape — matches `.mcp.json` / `claude_desktop_config.json`
+ *   convention).
+ *
+ * Default path: `${OPENSQUID_HOME()}/agent-bridge/mcp-config.json`. The
+ * file is OWNED by the daemon — overwritten on every start so a stale
+ * config from a previous opensquid install never silently misroutes the
+ * subscription subprocess. Users who want a custom config can point
+ * `OPENSQUID_AGENT_BRIDGE_MCP_CONFIG` at their own file; the materializer
+ * skips writing in that case (custom config is the user's responsibility).
+ *
+ * Why JSON not YAML: the MCP host convention (Anthropic + others) reads
+ * JSON. We emit what claude --mcp-config will accept verbatim.
+ *
+ * Why an opt-in helper not always-on: keeps api-mode daemons from paying
+ * the I/O cost for nothing; keeps test fixtures clean.
+ *
+ * Tool enumeration: we ship BOTH `opensquid-mcp` (read-only) and
+ * `opensquid-chat-bridge-mcp` (chat_send + chat_poll_inbox) so the spawned
+ * agent has full read+chat surface. Both bins live under `node_modules/.bin/`
+ * after `pnpm add opensquid`; the resolver below tries node_modules then
+ * falls back to PATH lookup so a globally-installed opensquid works too.
+ *
+ * Imports from: node:fs/promises, node:path, ../paths.js.
+ * Imported by: ./daemon.ts (subscription-mode start path),
+ *   ./mcp_config.test.ts.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { OPENSQUID_HOME } from '../paths.js';
+// ---------------------------------------------------------------------------
+// Default path
+// ---------------------------------------------------------------------------
+/** Default location for the agent-bridge MCP config. */
+export const defaultMcpConfigPath = (home) => join(home ?? OPENSQUID_HOME(), 'agent-bridge', 'mcp-config.json');
+// ---------------------------------------------------------------------------
+// Default servers — read-only opensquid-mcp + chat-bridge mutation surface.
+//
+// Both bins are exposed via package.json `bin` (`opensquid-mcp` +
+// `opensquid-chat-bridge-mcp`). We rely on PATH resolution by default —
+// when opensquid is installed (npm/pnpm), the bins land in node_modules/.bin
+// (project-local) or the global bin dir. Either way, `command: 'opensquid-mcp'`
+// resolves correctly from a spawned subprocess that inherits PATH from the
+// daemon's environment.
+// ---------------------------------------------------------------------------
+export function defaultMcpServers(env = {}) {
+    return {
+        opensquid: {
+            command: 'opensquid-mcp',
+            ...(Object.keys(env).length > 0 ? { env } : {}),
+        },
+        'opensquid-chat': {
+            command: 'opensquid-chat-bridge-mcp',
+            ...(Object.keys(env).length > 0 ? { env } : {}),
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// materializeDefaultMcpConfig — write the default doc to disk.
+//
+// Returns the absolute path to the written file. Idempotent — overwrites
+// every call so a fresh daemon start always has a known-good doc. Creates
+// parent dirs as needed.
+//
+// Caller (daemon.ts) decides WHEN to call (only on subscription-mode start
+// when no override path is supplied).
+// ---------------------------------------------------------------------------
+export async function materializeDefaultMcpConfig(opts = {}) {
+    const target = opts.targetPath ?? defaultMcpConfigPath(opts.daemonHome);
+    const dir = target.slice(0, target.lastIndexOf('/'));
+    if (dir.length > 0)
+        await mkdir(dir, { recursive: true });
+    const doc = {
+        mcpServers: defaultMcpServers(opts.envPassthrough ?? {}),
+    };
+    await writeFile(target, JSON.stringify(doc, null, 2), 'utf8');
+    return target;
+}
+export async function resolveMcpConfigPath(opts = {}) {
+    const env = opts.env ?? process.env;
+    const fromEnv = env.OPENSQUID_AGENT_BRIDGE_MCP_CONFIG;
+    if (fromEnv !== undefined && fromEnv.length > 0)
+        return fromEnv;
+    if (opts.explicitPath !== undefined && opts.explicitPath.length > 0) {
+        return opts.explicitPath;
+    }
+    return materializeDefaultMcpConfig({
+        ...(opts.daemonHome !== undefined ? { daemonHome: opts.daemonHome } : {}),
+    });
+}
+//# sourceMappingURL=mcp_config.js.map