opensquid 0.5.395

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

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

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

@@ -0,0 +1,84 @@
+/**
+ * agent_bridge — pack binding (WAB.6 + WAB-SUB.2 mode dispatcher, 0.5.106).
+ *
+ * Specs: `docs/tasks/T-warm-agent-chat-bridge.md` WAB.6 §"pack_binding.ts"
+ * + WAB-SUB.2 §"mode dispatcher". Architecture: `WAB.1-architecture.md`
+ * decisions (e) + (g).
+ *
+ * Responsibility:
+ *   `buildChatToolDispatcher` reads the pack's `chat_agent.yaml` (or a
+ *   built-in fallback), resolves the model alias to a discriminated
+ *   `runner` descriptor (api vs subscription), loads the system prompt,
+ *   filters built-in tools per `disable_builtins`, opts in skills
+ *   (warn-and-skip on unknown), and returns a `SimpleToolDispatcher` +
+ *   the runtime tunables.
+ *
+ * Mode dispatch (WAB-SUB.2): both `api` and `subscription` are first-class.
+ * The dispatcher switches on `runner.mode` once per turn — `api` calls
+ * `runAgentTurn`, `subscription` calls `runAgentTurnSubscription`. Future
+ * modes (local, mcp) throw "mode not yet implemented" with a setup-chat hint.
+ *
+ * Hard-fails: alias missing from modelsConfig; api mode missing `model`;
+ * subscription mode missing `cli`; mode = local | mcp (unimplemented).
+ *
+ * Non-responsibility: does NOT construct the Anthropic SDK client (lazy in
+ * daemon.ts), does NOT instantiate RagBackend (daemon-owned), does NOT call
+ * setup (misconfiguration surfaces as a thrown error).
+ *
+ * Imports from: ../../models/dispatcher.js, ../../packs/schemas/chat_agent.js,
+ *   ./tool_dispatcher.js, ./tools/index.js, ./types.js, node:fs/promises,
+ *   node:path.
+ * Imported by: daemon.ts, test sibling.
+ */
+import type { ModelAliasConfig } from '../../models/types.js';
+import type { Pack } from '../../runtime/types.js';
+import type { RagBackend } from '../../rag/types.js';
+import type { SecretResolver } from '../../secrets/types.js';
+import { type DaemonSendFn, type MakeStoreLessonHandlerOptions } from './tools/index.js';
+import type { ToolDispatcher } from './types.js';
+export interface BuildChatToolDispatcherOptions {
+    /** The loaded pack (output of `loadPack`). */
+    pack: Pack;
+    /** Absolute path to the pack folder (for resolving `system_prompt` files). */
+    packRoot: string;
+    /** User's `models.yaml` content (alias → ModelAliasConfig). */
+    modelsConfig: Record<string, ModelAliasConfig>;
+    /** RAG backend shared across all sessions for the `recall` tool. */
+    ragBackend: RagBackend;
+    /** Required by `api` mode strategies — throws if absent and alias is api. */
+    secrets?: SecretResolver;
+    /** Override daemon-send for `chat_send` (tests). */
+    daemonSend?: DaemonSendFn;
+    /** Override store_lesson clock + path resolution (tests). */
+    storeLessonOpts?: MakeStoreLessonHandlerOptions;
+    /** Structured warn sink — unknown skill names + future degraded signals. */
+    onWarn?: (message: string) => void;
+}
+/**
+ * Resolved agent-turn runner — discriminated union the dispatcher branches
+ * on. `api` carries the concrete model id; `subscription` carries the CLI
+ * binary + base args from `models.yaml`. Both modes are first-class.
+ */
+export type ResolvedAgentTurn = {
+    mode: 'api';
+    model: string;
+} | {
+    mode: 'subscription';
+    cli: string;
+    args: string[];
+};
+export interface BuildChatToolDispatcherResult {
+    dispatcher: ToolDispatcher;
+    systemPrompt: string;
+    /** Daemon + dispatcher switch on `.mode` to pick runAgentTurn vs runAgentTurnSubscription. */
+    runner: ResolvedAgentTurn;
+    /** Human-readable model label: concrete model id (api) or cli name (subscription).
+     *  Convenience for telemetry/session-manager so they don't switch on the union. */
+    resolvedModel: string;
+    tunables: {
+        maxToolIterations: number;
+        maxTokens: number;
+    };
+}
+export declare function buildChatToolDispatcher(opts: BuildChatToolDispatcherOptions): Promise<BuildChatToolDispatcherResult>;
+//# sourceMappingURL=pack_binding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack_binding.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/pack_binding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EASL,KAAK,YAAY,EACjB,KAAK,6BAA6B,EACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAyB,MAAM,YAAY,CAAC;AAgCxE,MAAM,WAAW,8BAA8B;IAC7C,8CAA8C;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC/C,oEAAoE;IACpE,UAAU,EAAE,UAAU,CAAC;IACvB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,oDAAoD;IACpD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,6DAA6D;IAC7D,eAAe,CAAC,EAAE,6BAA6B,CAAC;IAChD,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,MAAM,EAAE,iBAAiB,CAAC;IAC1B;uFACmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAMD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAqCxC"}

package/dist/runtime/agent_bridge/pack_binding.js

@@ -0,0 +1,202 @@
+/**
+ * agent_bridge — pack binding (WAB.6 + WAB-SUB.2 mode dispatcher, 0.5.106).
+ *
+ * Specs: `docs/tasks/T-warm-agent-chat-bridge.md` WAB.6 §"pack_binding.ts"
+ * + WAB-SUB.2 §"mode dispatcher". Architecture: `WAB.1-architecture.md`
+ * decisions (e) + (g).
+ *
+ * Responsibility:
+ *   `buildChatToolDispatcher` reads the pack's `chat_agent.yaml` (or a
+ *   built-in fallback), resolves the model alias to a discriminated
+ *   `runner` descriptor (api vs subscription), loads the system prompt,
+ *   filters built-in tools per `disable_builtins`, opts in skills
+ *   (warn-and-skip on unknown), and returns a `SimpleToolDispatcher` +
+ *   the runtime tunables.
+ *
+ * Mode dispatch (WAB-SUB.2): both `api` and `subscription` are first-class.
+ * The dispatcher switches on `runner.mode` once per turn — `api` calls
+ * `runAgentTurn`, `subscription` calls `runAgentTurnSubscription`. Future
+ * modes (local, mcp) throw "mode not yet implemented" with a setup-chat hint.
+ *
+ * Hard-fails: alias missing from modelsConfig; api mode missing `model`;
+ * subscription mode missing `cli`; mode = local | mcp (unimplemented).
+ *
+ * Non-responsibility: does NOT construct the Anthropic SDK client (lazy in
+ * daemon.ts), does NOT instantiate RagBackend (daemon-owned), does NOT call
+ * setup (misconfiguration surfaces as a thrown error).
+ *
+ * Imports from: ../../models/dispatcher.js, ../../packs/schemas/chat_agent.js,
+ *   ./tool_dispatcher.js, ./tools/index.js, ./types.js, node:fs/promises,
+ *   node:path.
+ * Imported by: daemon.ts, test sibling.
+ */
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, resolve } from 'node:path';
+import { resolveStrategy } from '../../models/dispatcher.js';
+import { SimpleToolDispatcher } from './tool_dispatcher.js';
+import { BUILT_INS, chatSendSpec, defaultDaemonSend, makeChatSendHandler, makeRecallHandler, makeStoreLessonHandler, recallSpec, storeLessonSpec, } from './tools/index.js';
+// ---------------------------------------------------------------------------
+// Built-in defaults — used when the pack ships no `chat_agent.yaml`.
+//
+// `default_model` defaults to `fast_chat` (the suggested alias name in
+// the WIZ.4 setup wizard and the WAB.6 spec). If the user's
+// `models.yaml` does not declare that alias, the resolver throws — the
+// no-side-file path still requires a valid alias to function. Built-ins
+// listed are the three sealed names with all bounds at the schema's
+// defaults.
+// ---------------------------------------------------------------------------
+const FALLBACK_CHAT_AGENT = {
+    default_model: 'fast_chat',
+    skills: [],
+    disable_builtins: [],
+    max_tool_iterations: 8,
+    max_tokens: 1024,
+};
+/** Terse built-in system prompt — used when no `system_prompt` path declared. */
+const DEFAULT_SYSTEM_PROMPT = "You are a chat-agent embedded in opensquid's warm-agent loop. " +
+    'Reply concisely. Use the `chat_send` tool to deliver your final answer to the user. ' +
+    'Use `recall` to look up project memories when relevant. Use `store_lesson` ' +
+    'to capture user-validated workflow / preference / skill_upgrade lessons for later review.';
+// ---------------------------------------------------------------------------
+// buildChatToolDispatcher — public entry point.
+// ---------------------------------------------------------------------------
+export async function buildChatToolDispatcher(opts) {
+    const chatAgent = opts.pack.chatAgent ?? FALLBACK_CHAT_AGENT;
+    const warn = opts.onWarn ?? noopWarn;
+    // 1. Resolve model alias to a discriminated runner descriptor. Both api
+    //    and subscription modes are first-class; local/mcp throw with the
+    //    setup-chat hint per WAB-SUB.2.
+    const runner = resolveRunnerOrThrow(chatAgent.default_model, opts.modelsConfig, opts.secrets);
+    const resolvedModel = runner.mode === 'api' ? runner.model : runner.cli;
+    // 2. Load system prompt — pack-relative file, or built-in default.
+    const systemPrompt = await loadSystemPrompt(chatAgent.system_prompt, opts.packRoot);
+    // 3. Build the tool list:
+    //    - Built-ins minus `disable_builtins`.
+    //    - Plus any pack-declared `skills` that map to known well-known
+    //      tool names (currently none — schema accepts arbitrary strings;
+    //      warn-and-skip on every entry today). Reserved for future opt-in
+    //      skill tools (e.g. `subagent_call`, `llm_classify` exposed as
+    //      tools rather than internal primitives).
+    const registrations = collectBuiltIns(chatAgent, opts);
+    for (const skillName of chatAgent.skills) {
+        warn(`[agent_bridge.pack_binding] unknown opt-in skill name '${skillName}' — skipping`);
+    }
+    const dispatcher = new SimpleToolDispatcher(registrations);
+    return {
+        dispatcher,
+        systemPrompt,
+        runner,
+        resolvedModel,
+        tunables: {
+            maxToolIterations: chatAgent.max_tool_iterations,
+            maxTokens: chatAgent.max_tokens,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// resolveRunnerOrThrow — alias → discriminated runner descriptor.
+//
+// api → validate `model` non-empty + resolveStrategy() for provider check.
+// subscription → validate `cli` non-empty + resolveStrategy() for impl check.
+// local | mcp → throws "mode not yet implemented" + setup-chat hint.
+//
+// resolveStrategy's return value is discarded — we call it for its side-
+// effect of validating strategy preconditions (provider for api, impl for
+// subscription). The actual SDK client (api) / spawn (subscription) is
+// constructed downstream in daemon.ts / agent_loop_subscription.ts.
+// ---------------------------------------------------------------------------
+function resolveRunnerOrThrow(alias, modelsConfig, secrets) {
+    const cfg = modelsConfig[alias];
+    if (cfg === undefined) {
+        throw new Error(`Chat agent uses model alias '${alias}' which is not declared in models.yaml. ` +
+            `Run \`opensquid setup chat\` to configure an api or subscription model alias.`);
+    }
+    if (cfg.mode === 'api') {
+        if (cfg.model === undefined || cfg.model.length === 0) {
+            throw new Error(`Chat agent uses model alias '${alias}' (mode=api) but \`model\` field is missing — ` +
+                `api strategies require a concrete model id. ` +
+                `Run \`opensquid setup chat\` to fix the alias.`);
+        }
+        // Validate strategy-constructor preconditions (e.g. provider field).
+        resolveStrategy(alias, cfg, secrets);
+        return { mode: 'api', model: cfg.model };
+    }
+    if (cfg.mode === 'subscription') {
+        if (cfg.cli === undefined || cfg.cli.length === 0) {
+            throw new Error(`Chat agent uses model alias '${alias}' (mode=subscription) but \`cli\` field is missing — ` +
+                `subscription strategies require a binary name or path. ` +
+                `Run \`opensquid setup chat\` to fix the alias.`);
+        }
+        // Validate strategy-constructor preconditions (impl branch).
+        resolveStrategy(alias, cfg, secrets);
+        return { mode: 'subscription', cli: cfg.cli, args: cfg.args ?? [] };
+    }
+    // Future modes (local, mcp) reserved — emit the setup-chat hint.
+    throw new Error(`Chat agent uses model alias '${alias}' (mode='${cfg.mode}'): mode not yet implemented ` +
+        `in v1. Run \`opensquid setup chat\` to choose api or subscription.`);
+}
+// ---------------------------------------------------------------------------
+// loadSystemPrompt — pack-relative file read, or built-in default.
+//
+// Empty / undefined path → built-in default prompt. An absolute path is
+// honored as-is (escape hatch for shared system prompts living outside
+// the pack root); a relative path is joined against `packRoot`. File
+// errors propagate verbatim — a `system_prompt:` declaration that points
+// at a missing file is a configuration bug we want to surface loudly.
+// ---------------------------------------------------------------------------
+async function loadSystemPrompt(promptPath, packRoot) {
+    if (promptPath === undefined || promptPath.length === 0)
+        return DEFAULT_SYSTEM_PROMPT;
+    const abs = isAbsolute(promptPath) ? promptPath : resolve(packRoot, promptPath);
+    const raw = await readFile(abs, 'utf8');
+    return raw.trim();
+}
+// ---------------------------------------------------------------------------
+// collectBuiltIns — apply `disable_builtins` filter, return ToolRegistrations.
+//
+// Ordering matches `BUILT_INS` (chat_send, recall, store_lesson) so
+// `dispatcher.list()` returns them in that order — matching the schema's
+// enum order so docs + setup-UI prompts stay aligned.
+// ---------------------------------------------------------------------------
+function collectBuiltIns(chatAgent, opts) {
+    const disabled = new Set(chatAgent.disable_builtins);
+    const out = [];
+    for (const name of BUILT_INS) {
+        if (disabled.has(name))
+            continue;
+        out.push(buildBuiltIn(name, opts));
+    }
+    return out;
+}
+function buildBuiltIn(name, opts) {
+    switch (name) {
+        case 'chat_send':
+            return {
+                spec: chatSendSpec,
+                handler: makeChatSendHandler(opts.daemonSend ?? defaultDaemonSend),
+            };
+        case 'recall':
+            return {
+                spec: recallSpec,
+                handler: makeRecallHandler(opts.ragBackend),
+            };
+        case 'store_lesson':
+            return {
+                spec: storeLessonSpec,
+                handler: makeStoreLessonHandler(opts.storeLessonOpts ?? {}),
+            };
+        default:
+            // Compile-time exhaustiveness: `BUILT_INS` is `readonly BuiltinToolName[]`,
+            // and the switch covers all three enum values. A future addition to
+            // the enum would trip this and force the maintainer to update the
+            // factory map alongside the schema.
+            throw new Error(`pack_binding: built-in '${name}' has no factory registered`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const noopWarn = () => {
+    /* default sink */
+};
+//# sourceMappingURL=pack_binding.js.map

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

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

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

@@ -0,0 +1,133 @@
+/**
+ * agent_bridge — warm-pool session manager (WAB.3, 0.5.95).
+ *
+ * Authoritative spec: `docs/tasks/T-warm-agent-chat-bridge.md` WAB.3.
+ * Architecture: `docs/tasks/WAB.1-architecture.md` decisions (b) + (c) +
+ * Section 2 module layout (≤350 LOC budget for this file).
+ *
+ * Responsibility:
+ *   1. Maintain an LRU of `SessionState` objects keyed by canonical session
+ *      slug — Hermes-derived caps (`max=128`, `ttl=3_600_000ms`, verified
+ *      against `gateway/run.py:55-65`).
+ *   2. Lazy-construct a `SessionState` on first `getOrCreate`, hydrating
+ *      `history` from persisted JSONL (WAB.3 `SessionPersistence`).
+ *   3. On eviction (LRU cap hit, idle TTL expire, or shutdown), notify the
+ *      caller via the optional `onEvict` callback so any unfinished work
+ *      (e.g. a final flush) can be performed before the entry vanishes.
+ *      The state's `history` is already on disk — eviction is a memory
+ *      release, not a data loss.
+ *   4. `appendTurn` is the only mutation API — it APPEND-WRITES the new
+ *      entries to disk FIRST, then mutates the in-memory `history`, so a
+ *      persistence failure leaves the in-memory state cleanly unchanged
+ *      (the caller's catch can decide to retry or escalate).
+ *
+ * Non-responsibility (per WAB.1 (c)):
+ *   - Does NOT store an Anthropic SDK client per session. One daemon-wide
+ *     client is shared.
+ *   - Does NOT compute cache-control breakpoints. Those are derived from
+ *     `history` positions at request-time by the agent loop (WAB.4).
+ *   - Does NOT serialize concurrent appends to the same session. This is
+ *     intentional: the manager is the unsynchronized data plane; the
+ *     control plane (`ChatDispatcher` in `dispatcher.ts`) owns the
+ *     per-session mutex+queue policy and is the sole production caller of
+ *     `appendTurn` (regression-locked by `appendturn_sole_caller.test.ts`).
+ *     See the `Concurrency contract:` paragraph on `appendTurn` below for
+ *     the policy details.
+ *
+ * Imports from: lru-cache, ./session_persistence.js, ./types.js.
+ * Imported by: (future) dispatcher.ts, daemon.ts.
+ */
+import { type SessionPersistence } from './session_persistence.js';
+import { type ChatHistoryEntry, type SessionKey, type SessionState } from './types.js';
+/** Max warm sessions in memory. Hermes `_AGENT_CACHE_MAX_SIZE`. */
+export declare const AGENT_CACHE_MAX_SIZE = 128;
+/** Idle TTL after which an untouched session is evicted. Hermes
+ *  `_AGENT_CACHE_IDLE_TTL_SECS = 3600.0` → 3_600_000 ms. */
+export declare const AGENT_CACHE_IDLE_TTL_MS = 3600000;
+export type EvictionReason = 'lru' | 'idle' | 'shutdown';
+export interface SessionManagerOptions {
+    persistence: SessionPersistence;
+    /** Fallback pack id stamped onto newly-created `SessionState`s when the
+     *  caller does not override it. WAB.6 will replace this with a per-call
+     *  override (different sessions can run different packs). */
+    defaultPackId: string;
+    /** Fallback resolved model id stamped onto newly-created states. */
+    defaultModelAlias: string;
+    /** Override cache cap (tests). Defaults to `AGENT_CACHE_MAX_SIZE`. */
+    maxSessions?: number;
+    /** Override idle TTL ms (tests). Defaults to `AGENT_CACHE_IDLE_TTL_MS`. */
+    idleTtlMs?: number;
+    /** Injected clock (tests). Defaults to `Date.now`. */
+    nowMs?: () => number;
+    /**
+     * Fired when a session leaves the cache. Synchronous-return; the
+     * implementation may kick an async flush — the SessionManager does not
+     * await it (lru-cache's dispose is sync). Callers that need a barrier
+     * should track outstanding flushes themselves.
+     *
+     * For 'lru' / 'idle' reasons: invoked from the LRU dispose hook.
+     * For 'shutdown' reason: invoked from `shutdown()` for each remaining
+     * entry before the cache is cleared.
+     */
+    onEvict?: (state: SessionState, reason: EvictionReason) => void;
+}
+export declare class SessionManager {
+    private readonly cache;
+    private readonly persistence;
+    private readonly defaultPackId;
+    private readonly defaultModelAlias;
+    private readonly nowMs;
+    private readonly onEvict;
+    private shutdownInProgress;
+    constructor(opts: SessionManagerOptions);
+    /**
+     * Look up an existing warm session, or create one (hydrating its
+     * `history` from persisted JSONL). Cache-hit path is a single LRU
+     * lookup + sync return inside an awaited promise — no extra I/O.
+     *
+     * `projectUuid` is required (sessions are project-scoped); pack id +
+     * model alias use the manager-level defaults at creation time. WAB.6
+     * will add per-call overrides.
+     */
+    getOrCreate(key: SessionKey, projectUuid: string): Promise<SessionState>;
+    /**
+     * Append entries from a completed turn. Persistence happens BEFORE
+     * in-memory mutation so a write failure leaves the state untouched
+     * (the caller can catch and decide).
+     *
+     * If the session was evicted between turn-start and turn-completion
+     * (race against LRU cap or idle TTL), the method is a no-op — there is
+     * no warm state to update, and re-creating it just to attach orphan
+     * entries would corrupt the order on disk (the evicted state's flush
+     * already covers it).
+     *
+     * Concurrency contract: this method ASSUMES the caller has serialized
+     * concurrent calls for the same session. The control plane —
+     * `ChatDispatcher.handleFlush` + `runTurnChain` in `dispatcher.ts` —
+     * enforces this via a per-session `inFlight` map (depth 1) plus a
+     * `pendingQueue` map (depth 1, coalesce up to MAX_QUEUE_COALESCE_ATTEMPTS,
+     * then DROP + warn). Adding a SECOND production caller would violate
+     * the contract; the `appendturn_sole_caller.test.ts` regression net
+     * catches that drift.
+     */
+    appendTurn(key: SessionKey, entries: ChatHistoryEntry[]): Promise<void>;
+    /**
+     * Mark a session's turn as in-flight. Pure in-memory; intended for the
+     * batch coordinator (WAB.5) to set BEFORE issuing the agent turn so
+     * other inbound batches buffer.
+     */
+    beginTurn(key: SessionKey): void;
+    /** Test/admin: returns the live entry without resetting age. */
+    peek(key: SessionKey): SessionState | undefined;
+    /** Live entry count — for telemetry + tests. */
+    get size(): number;
+    /**
+     * Drain the cache: emit `onEvict(state, 'shutdown')` for each live
+     * session, then clear. Idempotent. After shutdown, the manager is
+     * single-use — re-using it would silently start a fresh cache; we
+     * surface that as a recoverable no-op rather than throw (matches
+     * `InboxTransportBridge.shutdown` semantics).
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=session_manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session_manager.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/session_manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAMpB,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;4DAC4D;AAC5D,eAAO,MAAM,uBAAuB,UAAY,CAAC;AAoBjD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAMzD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,kBAAkB,CAAC;IAChC;;iEAE6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;CACjE;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsE;IAC9F,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,IAAI,EAAE,qBAAqB;IAmCvC;;;;;;;;OAQG;IACG,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAuB9E;;;;;;;;;;;;;;;;;;;OAmBG;IACG,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI;IAKhC,gEAAgE;IAChE,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS;IAI/C,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;OAMG;IACH,QAAQ,IAAI,IAAI;CAgBjB"}