@spinabot/brigade 0.1.1 → 1.0.0

package/dist/agents/session-inbox.js

@@ -0,0 +1,492 @@
+/**
+ * Per-session system-event inbox.
+ *
+ * Brand-scrubbed verbatim lift of upstream's `src/infra/system-events.ts`.
+ * Lightweight, in-memory, ephemeral queue of human-readable events that
+ * the next turn for a session prefixes onto the prompt. Persistence is
+ * intentionally NOT supported — events are wake-up signals, not history.
+ *
+ * Producers (planned):
+ *   - Channel manager (Step 16) → inbound messages while a turn is busy
+ *   - Cron service (later) → fired-job reminders + payloads
+ *   - Sub-agent completion handler (Step 20) → child-result notifications
+ *   - Approval router (Step 17) → operator decisions on tool gates
+ *   - Heartbeat layer (Steps 13-14) → wake signals scoped per session
+ *
+ * Consumer (always one):
+ *   - The session's main turn loop, which calls `drainSystemEventEntries`
+ *     before composing the next user message.
+ *
+ * Concurrency:
+ *   - Map is a global singleton, shared across the gateway process.
+ *   - Mutations are NOT lock-guarded; producers run on the JS event loop
+ *     and the consumer drains under the per-session lane lock that
+ *     `command-queue.ts` already enforces, so the only "drain mid-write"
+ *     race is one producer racing one drainer — and the drainer atomically
+ *     snapshots-then-truncates so the worst case is "next call sees the
+ *     latecomer".
+ *   - 20-event soft cap per session (oldest dropped) prevents a runaway
+ *     producer from starving memory.
+ *   - Consecutive identical `text` is suppressed (returns `false` from
+ *     `enqueueSystemEvent`) so a noisy producer can't fill the queue with
+ *     duplicates.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveAgentDir } from "../config/paths.js";
+import { tryGetRuntimeContext } from "../storage/runtime-context.js";
+import { createSubsystemLogger } from "../logging/subsystem-logger.js";
+import { resolveGlobalSingleton } from "../shared/global-singleton.js";
+import { normalizeOptionalLowercaseString, normalizeOptionalString, } from "../shared/string-coerce.js";
+import { mergeDeliveryContext, normalizeDeliveryContext } from "../utils/delivery-context.js";
+import { resolveAgentIdFromSessionKey } from "./routing/session-key.js";
+const log = createSubsystemLogger("agents/session-inbox");
+const MAX_EVENTS = 20;
+const SESSION_INBOX_QUEUES_KEY = Symbol.for("brigade.sessionInbox.queues");
+const queues = resolveGlobalSingleton(SESSION_INBOX_QUEUES_KEY, () => new Map());
+function requireSessionKey(key) {
+    const trimmed = normalizeOptionalString(key) ?? "";
+    if (!trimmed) {
+        throw new Error("system events require a sessionKey");
+    }
+    return trimmed;
+}
+function normalizeContextKey(key) {
+    return normalizeOptionalLowercaseString(key) ?? null;
+}
+function getSessionQueue(sessionKey) {
+    return queues.get(requireSessionKey(sessionKey));
+}
+function getOrCreateSessionQueue(sessionKey) {
+    const key = requireSessionKey(sessionKey);
+    const existing = queues.get(key);
+    if (existing)
+        return existing;
+    const created = {
+        queue: [],
+        lastText: null,
+        lastContextKey: null,
+    };
+    queues.set(key, created);
+    return created;
+}
+function cloneSystemEvent(event) {
+    return {
+        ...event,
+        ...(event.deliveryContext ? { deliveryContext: { ...event.deliveryContext } } : {}),
+    };
+}
+/* ─── Wave O0.8 GAP 11 — JSONL persistence helpers ───────────────────────
+ *
+ * Persists each enqueued system event to `<agentDir>/inbox/<sessionKey>.jsonl`
+ * so a gateway restart between child completion and parent next turn does
+ * not lose the announce. Append on enqueue, delete on drain, capped at the
+ * same 20-entry soft cap as the in-memory queue.
+ *
+ * Enabled when BRIGADE_ENABLE_INBOX_PERSIST is set. The gateway boot path
+ * flips this on for production runs; existing tests (which already write
+ * to the singleton in-memory Map) inherit a no-op disk path so they don't
+ * pollute `~/.brigade`. New tests that need persistence opt in by setting
+ * the env var alongside a tempdir-scoped BRIGADE_STATE_DIR.
+ */
+const INBOX_FILE_EXT = ".jsonl";
+function isPersistDisabled() {
+    // Operator opt-out always wins so production deployments can disable
+    // the disk write surface entirely.
+    if (process.env.BRIGADE_DISABLE_INBOX_PERSIST === "1")
+        return true;
+    // Default-off so existing tests that don't tempdir-isolate keep
+    // passing. The gateway entry point flips ENABLE on for production.
+    return process.env.BRIGADE_ENABLE_INBOX_PERSIST !== "1";
+}
+/** Replace any character outside `[A-Za-z0-9._-]` with `_` for cross-platform-safe filenames. */
+function sanitizeSessionKeyForFile(sessionKey) {
+    return sessionKey.replace(/[^A-Za-z0-9._-]/g, "_");
+}
+function resolveInboxFilePath(sessionKey) {
+    const agentId = resolveAgentIdFromSessionKey(sessionKey);
+    const safeName = sanitizeSessionKeyForFile(sessionKey);
+    return path.join(resolveAgentDir(agentId), "inbox", `${safeName}${INBOX_FILE_EXT}`);
+}
+function ensureInboxDir(filePath) {
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    }
+    catch (err) {
+        log.warn("inbox dir create failed", {
+            dir: path.dirname(filePath),
+            error: err?.message,
+        });
+    }
+}
+// Convex mode: the in-memory `queues` Map remains the working store (the
+// per-turn drains read it synchronously); these helpers mirror to the
+// sessionInboxEvents table for cross-restart durability instead of writing
+// JSONL under ~/.brigade. Fire-and-forget on a serial chain — a failed
+// mirror never blocks event delivery (the in-memory copy is authoritative
+// within a gateway lifetime).
+let inboxMirrorChain = Promise.resolve();
+function inConvexMode() {
+    return tryGetRuntimeContext()?.mode === "convex";
+}
+function enqueueInboxMirror(work) {
+    inboxMirrorChain = inboxMirrorChain.then(work).then(() => { }, (err) => log.warn("inbox convex mirror failed", { error: err?.message }));
+}
+export function awaitInboxMirrorFlush() {
+    return inboxMirrorChain;
+}
+function appendEventToDisk(sessionKey, event) {
+    if (inConvexMode()) {
+        const store = tryGetRuntimeContext().store;
+        enqueueInboxMirror(() => store.messages.inboxEnqueue(sessionKey, event));
+        return;
+    }
+    if (isPersistDisabled())
+        return;
+    try {
+        const filePath = resolveInboxFilePath(sessionKey);
+        ensureInboxDir(filePath);
+        fs.appendFileSync(filePath, `${JSON.stringify(event)}\n`, "utf8");
+    }
+    catch (err) {
+        log.warn("inbox JSONL append failed", {
+            sessionKey,
+            error: err?.message,
+        });
+    }
+}
+function truncateInboxFile(sessionKey) {
+    if (inConvexMode()) {
+        const store = tryGetRuntimeContext().store;
+        enqueueInboxMirror(() => store.messages.inboxDrain(sessionKey));
+        return;
+    }
+    if (isPersistDisabled())
+        return;
+    try {
+        const filePath = resolveInboxFilePath(sessionKey);
+        if (fs.existsSync(filePath))
+            fs.unlinkSync(filePath);
+    }
+    catch (err) {
+        log.warn("inbox JSONL truncate failed", {
+            sessionKey,
+            error: err?.message,
+        });
+    }
+}
+function rewriteInboxFile(sessionKey, events) {
+    if (inConvexMode()) {
+        // Replace semantics (cap-overflow path): drain then re-enqueue the
+        // kept tail. The in-memory cap already applied, so `events` is small.
+        const store = tryGetRuntimeContext().store;
+        const kept = events.map(cloneSystemEvent);
+        enqueueInboxMirror(async () => {
+            await store.messages.inboxDrain(sessionKey);
+            for (const e of kept)
+                await store.messages.inboxEnqueue(sessionKey, e);
+        });
+        return;
+    }
+    if (isPersistDisabled())
+        return;
+    try {
+        const filePath = resolveInboxFilePath(sessionKey);
+        if (events.length === 0) {
+            if (fs.existsSync(filePath))
+                fs.unlinkSync(filePath);
+            return;
+        }
+        ensureInboxDir(filePath);
+        const body = events.map((e) => JSON.stringify(e)).join("\n") + "\n";
+        fs.writeFileSync(filePath, body, "utf8");
+    }
+    catch (err) {
+        log.warn("inbox JSONL rewrite failed", {
+            sessionKey,
+            error: err?.message,
+        });
+    }
+}
+function readInboxFromDisk(sessionKey) {
+    if (isPersistDisabled())
+        return [];
+    try {
+        const filePath = resolveInboxFilePath(sessionKey);
+        if (!fs.existsSync(filePath))
+            return [];
+        const raw = fs.readFileSync(filePath, "utf8");
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        const out = [];
+        for (const line of lines) {
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed && typeof parsed.text === "string" && typeof parsed.ts === "number") {
+                    out.push(parsed);
+                }
+            }
+            catch {
+                // Skip a corrupt line — the rest of the file is still useful.
+            }
+        }
+        // Honour the cap so a runaway producer's persisted file can't blow
+        // the in-memory queue on restore.
+        if (out.length > MAX_EVENTS)
+            return out.slice(out.length - MAX_EVENTS);
+        return out;
+    }
+    catch (err) {
+        log.warn("inbox JSONL read failed", {
+            sessionKey,
+            error: err?.message,
+        });
+        return [];
+    }
+}
+/**
+ * Hydrate the in-memory queue for `sessionKey` from any unconsumed JSONL
+ * entries on disk. Called lazily on first access so we only pay the read
+ * cost when the session is actually used. Idempotent — repeat calls after
+ * the first hydration are no-ops because the queue is already in-memory.
+ */
+function hydrateFromDiskIfNeeded(sessionKey) {
+    if (isPersistDisabled())
+        return;
+    const existing = queues.get(sessionKey);
+    if (existing)
+        return;
+    const persisted = readInboxFromDisk(sessionKey);
+    if (persisted.length === 0)
+        return;
+    const tail = persisted[persisted.length - 1];
+    const created = {
+        queue: persisted.map(cloneSystemEvent),
+        lastText: tail?.text ?? null,
+        lastContextKey: tail?.contextKey ?? null,
+    };
+    queues.set(sessionKey, created);
+}
+/**
+ * `true` iff `contextKey` differs from the most-recently-enqueued event's
+ * key for this session. Used by producers that want to suppress a follow-up
+ * notification when the operator is still inside the same logical context
+ * (e.g. a long-running exec emitting periodic status — only the first
+ * status text needs to wake the session).
+ */
+export function isSystemEventContextChanged(sessionKey, contextKey) {
+    hydrateFromDiskIfNeeded(requireSessionKey(sessionKey));
+    const existing = getSessionQueue(sessionKey);
+    const normalized = normalizeContextKey(contextKey);
+    return normalized !== (existing?.lastContextKey ?? null);
+}
+/**
+ * Enqueue a human-readable system event for the next turn on `sessionKey`.
+ *
+ * Returns:
+ *   - `true`  → event accepted (queued or replaced a duplicate's metadata)
+ *   - `false` → event dropped (empty text OR consecutive duplicate text)
+ *
+ * Empty-string `text` is dropped silently. Consecutive duplicates by `text`
+ * are suppressed so a noisy producer can't flood the queue.
+ */
+export function enqueueSystemEvent(text, options) {
+    const key = requireSessionKey(options?.sessionKey);
+    // Wave O0.8 GAP 11 — restore any disk-persisted events before mutating
+    // the in-memory queue so a post-restart enqueue doesn't strand the
+    // pre-restart events.
+    hydrateFromDiskIfNeeded(key);
+    const entry = getOrCreateSessionQueue(key);
+    const cleaned = text.trim();
+    if (!cleaned)
+        return false;
+    const normalizedContextKey = normalizeContextKey(options?.contextKey);
+    const normalizedDeliveryContext = normalizeDeliveryContext(options?.deliveryContext);
+    entry.lastContextKey = normalizedContextKey;
+    if (entry.lastText === cleaned)
+        return false;
+    entry.lastText = cleaned;
+    const event = {
+        text: cleaned,
+        ts: Date.now(),
+        contextKey: normalizedContextKey,
+        deliveryContext: normalizedDeliveryContext,
+        trusted: options.trusted !== false,
+    };
+    entry.queue.push(event);
+    if (entry.queue.length > MAX_EVENTS) {
+        entry.queue.shift();
+        // Persisted file's tail-N rewrite keeps disk + memory in sync.
+        rewriteInboxFile(key, entry.queue);
+    }
+    else {
+        appendEventToDisk(key, event);
+    }
+    return true;
+}
+/**
+ * Atomic snapshot-and-truncate: returns every queued event for the session
+ * in FIFO order and resets the queue.
+ *
+ * Empty queues return `[]` (NOT `undefined`). The session's queue entry is
+ * deleted from the global Map after a successful drain so the registry
+ * doesn't grow unbounded under churn.
+ */
+export function drainSystemEventEntries(sessionKey) {
+    const key = requireSessionKey(sessionKey);
+    // Hydrate first so post-restart drains see the pre-restart events.
+    hydrateFromDiskIfNeeded(key);
+    const entry = getSessionQueue(key);
+    if (!entry || entry.queue.length === 0)
+        return [];
+    const out = entry.queue.map(cloneSystemEvent);
+    entry.queue.length = 0;
+    entry.lastText = null;
+    entry.lastContextKey = null;
+    queues.delete(key);
+    // Wave O0.8 GAP 11 — clear persisted file once memory is drained so a
+    // later restart-then-drain does not re-emit the same entries.
+    truncateInboxFile(key);
+    return out;
+}
+function areDeliveryContextsEqual(left, right) {
+    if (!left && !right)
+        return true;
+    if (!left || !right)
+        return false;
+    return ((left.channel ?? undefined) === (right.channel ?? undefined) &&
+        (left.to ?? undefined) === (right.to ?? undefined) &&
+        (left.threadId ?? undefined) === (right.threadId ?? undefined));
+}
+function areSystemEventsEqual(left, right) {
+    return (left.text === right.text &&
+        left.ts === right.ts &&
+        (left.contextKey ?? null) === (right.contextKey ?? null) &&
+        (left.trusted ?? true) === (right.trusted ?? true) &&
+        areDeliveryContextsEqual(left.deliveryContext, right.deliveryContext));
+}
+/**
+ * Partial drain. Removes ONLY the events that match the leading prefix of
+ * `consumedEntries` (compared field-wise). If the caller's prefix doesn't
+ * match (events arrived out of order, or were already drained), the queue
+ * is left intact and `[]` is returned.
+ *
+ * Used by Step 12's pending-system-events partial drain: the prompt
+ * assembler peeks at events, formats them, then consumes the exact set it
+ * was about to render — guarantees no event is rendered AND queued at the
+ * same time, even under concurrent writes.
+ */
+export function consumeSystemEventEntries(sessionKey, consumedEntries) {
+    const key = requireSessionKey(sessionKey);
+    hydrateFromDiskIfNeeded(key);
+    const entry = getSessionQueue(key);
+    if (!entry || entry.queue.length === 0 || consumedEntries.length === 0)
+        return [];
+    if (consumedEntries.length > entry.queue.length ||
+        !consumedEntries.every((event, index) => {
+            const queued = entry.queue[index];
+            return queued !== undefined && areSystemEventsEqual(queued, event);
+        })) {
+        return [];
+    }
+    const removed = entry.queue.splice(0, consumedEntries.length).map(cloneSystemEvent);
+    if (entry.queue.length === 0) {
+        entry.lastText = null;
+        entry.lastContextKey = null;
+        queues.delete(key);
+        // Wave O0.8 GAP 11 — partial-drain that empties memory also clears disk.
+        truncateInboxFile(key);
+    }
+    else {
+        const newest = entry.queue[entry.queue.length - 1];
+        if (newest) {
+            entry.lastText = newest.text;
+            entry.lastContextKey = newest.contextKey ?? null;
+        }
+        // Wave O0.8 GAP 11 — keep persisted file in sync with the trimmed memory queue.
+        rewriteInboxFile(key, entry.queue);
+    }
+    return removed;
+}
+/** Drain just the text strings (legacy compatible). */
+export function drainSystemEvents(sessionKey) {
+    return drainSystemEventEntries(sessionKey).map((event) => event.text);
+}
+/** Read-only peek at the queued events for a session. */
+export function peekSystemEventEntries(sessionKey) {
+    hydrateFromDiskIfNeeded(requireSessionKey(sessionKey));
+    return getSessionQueue(sessionKey)?.queue.map(cloneSystemEvent) ?? [];
+}
+/** Read-only peek at the queued event texts for a session. */
+export function peekSystemEvents(sessionKey) {
+    return peekSystemEventEntries(sessionKey).map((event) => event.text);
+}
+/** `true` iff the session has at least one queued event. */
+export function hasSystemEvents(sessionKey) {
+    hydrateFromDiskIfNeeded(requireSessionKey(sessionKey));
+    return (getSessionQueue(sessionKey)?.queue.length ?? 0) > 0;
+}
+/**
+ * Remove the FIRST queued event matching `text` + `contextKey` exactly,
+ * wherever it sits in the queue. Returns true when one was removed.
+ *
+ * Exists for producers that enqueue an event BEFORE a dispatch that can
+ * fail (sessions_send enqueues the A2A attribution event, then dispatches
+ * the peer turn): on a failed dispatch the event must be withdrawn or it
+ * ghosts into the peer's NEXT unrelated turn ("A2A from X: …" acted on
+ * hours later). `consumeSystemEventEntries` can't do this — it only
+ * removes exact queue PREFIXES (its drain contract).
+ */
+export function removeMatchingSystemEvent(sessionKey, match) {
+    const key = requireSessionKey(sessionKey);
+    hydrateFromDiskIfNeeded(key);
+    const entry = getSessionQueue(key);
+    if (!entry || entry.queue.length === 0)
+        return false;
+    const idx = entry.queue.findIndex((e) => e.text === match.text &&
+        (match.contextKey === undefined || e.contextKey === match.contextKey));
+    if (idx < 0)
+        return false;
+    entry.queue.splice(idx, 1);
+    if (entry.queue.length === 0) {
+        entry.lastText = null;
+        entry.lastContextKey = null;
+        queues.delete(key);
+        truncateInboxFile(key);
+    }
+    else {
+        const newest = entry.queue[entry.queue.length - 1];
+        if (newest) {
+            entry.lastText = newest.text;
+            entry.lastContextKey = newest.contextKey ?? null;
+        }
+        rewriteInboxFile(key, entry.queue);
+    }
+    return true;
+}
+/**
+ * Merge the delivery contexts of `events` into a single context. Later
+ * events override earlier ones field-by-field. Used by the dispatcher to
+ * pick a delivery target when multiple events fired for the same session.
+ */
+export function resolveSystemEventDeliveryContext(events) {
+    let resolved;
+    for (const event of events) {
+        resolved = mergeDeliveryContext(event.deliveryContext, resolved);
+    }
+    return resolved;
+}
+/** Test-only — clear every queued event across every session. */
+export function resetSessionInboxForTest() {
+    queues.clear();
+}
+/**
+ * Wave O0.8 GAP 11 — explicit "force re-hydrate from disk" for the
+ * post-restart replay path. Production callers don't need this (hydration
+ * is lazy on first access of every public read/write entry), but tests
+ * that simulate a gateway restart by clearing the in-memory Map need to
+ * trigger hydration without touching one of the public APIs first.
+ */
+export function forceHydrateFromDiskForTests(sessionKey) {
+    hydrateFromDiskIfNeeded(requireSessionKey(sessionKey));
+}
+//# sourceMappingURL=session-inbox.js.map

package/dist/agents/session-inbox.js.map

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

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

@@ -0,0 +1,148 @@
+/**
+ * In-process live-session registry.
+ *
+ * Tracks the sessions Brigade's gateway is actively running a turn for —
+ * the orthogonal counterpart to `session-store.ts` (which persists per-
+ * session metadata to disk) and `subagent-registry.ts` (which tracks
+ * sub-agent runs spawned BY sessions).
+ *
+ * Why have a separate live registry at all: the heartbeat runner (Step 14),
+ * the channel manager (Step 16), the approval router (Step 17), and the
+ * gateway dispatcher (Step 25) all need ONE place to ask "is X live?" —
+ * and ONE place to abort it on graceful shutdown.
+ *
+ * Backing store: a `resolveGlobalSingleton`-pinned Map keyed by `runId`.
+ * Lives for the process lifetime; never persisted. A fresh process boots
+ * with an empty Map.
+ *
+ * P2#1 (Wave H) — keyed by runId, not sessionKey. A single sessionKey can
+ * host MULTIPLE live entries when, for example, a heartbeat synthetic
+ * turn fires while the operator's prompt is still streaming, or when a
+ * crash-recovery race re-registers before unregister. Previously the
+ * Map-by-sessionKey silently REPLACED the prior entry, dropping its
+ * abort controller and losing the original turn's lifecycle stamp. Now:
+ *
+ *   - Each `registerLiveSession` mints a unique entry keyed by `runId`.
+ *   - `hasLiveSession(sessionKey)` looks up by sessionKey via secondary
+ *     index (sessionKey → Set<runId>).
+ *   - `abortLiveSession(sessionKey)` aborts ALL non-terminated entries
+ *     for that sessionKey (channels can no longer leak across turn
+ *     boundaries).
+ *
+ * Hook surface:
+ *   - `onStateChange(listener)` for observers (Step 18 agent-events fan-out).
+ *   - Abort propagation: each entry carries the turn's `AbortController`,
+ *     so a graceful shutdown can call `abortAllSessions("shutdown")`
+ *     and every in-flight turn unwinds promptly.
+ */
+export type SessionLifecycleState = "running" | "idle" | "draining" | "terminated";
+export type LiveSessionRecord = {
+    sessionKey: string;
+    sessionId: string;
+    agentId: string;
+    runId: string;
+    lane: string;
+    state: SessionLifecycleState;
+    createdAt: number;
+    lastStateChangeAt: number;
+    lastActivityAt: number;
+    abortController?: AbortController;
+    /** Free-form per-session metadata. Never persisted. */
+    metadata?: Record<string, unknown>;
+};
+export type SessionStateChangeEvent = {
+    sessionKey: string;
+    previousState: SessionLifecycleState | "registered";
+    newState: SessionLifecycleState;
+    timestamp: number;
+    runId?: string;
+};
+type SessionStateListener = (event: SessionStateChangeEvent) => void;
+export interface RegisterSessionParams {
+    sessionKey: string;
+    sessionId: string;
+    agentId: string;
+    runId: string;
+    lane: string;
+    abortController?: AbortController;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Register a fresh live session. Each call mints a distinct entry keyed by
+ * `runId`; multiple live entries for the same sessionKey are allowed (e.g.
+ * a heartbeat turn racing the operator's prompt). The dispatcher should
+ * still pass DISTINCT runIds per turn — colliding runIds replace the
+ * existing entry (logged) the same way the old Map-by-sessionKey did.
+ */
+export declare function registerLiveSession(params: RegisterSessionParams): LiveSessionRecord;
+/** Lookup the newest live entry for a session key (or undefined). */
+export declare function getLiveSession(sessionKey: string): LiveSessionRecord | undefined;
+/** Lookup a specific live entry by runId. */
+export declare function getLiveSessionByRunId(runId: string): LiveSessionRecord | undefined;
+/** Every live entry for a session key (every non-terminated runId). */
+export declare function getLiveSessionsForKey(sessionKey: string): LiveSessionRecord[];
+/** `true` while at least one entry for the sessionKey is in a non-terminated state. */
+export declare function hasLiveSession(sessionKey: string): boolean;
+/** Snapshot every currently registered session. */
+export declare function listLiveSessions(): LiveSessionRecord[];
+/**
+ * Filter to sessions matching a predicate. Common shapes:
+ *   - by agent: `listLiveSessionsWhere((s) => s.agentId === "main")`
+ *   - by lane:  `listLiveSessionsWhere((s) => s.lane.startsWith("session:"))`
+ */
+export declare function listLiveSessionsWhere(predicate: (entry: LiveSessionRecord) => boolean): LiveSessionRecord[];
+/** Count of currently-running (non-idle, non-draining, non-terminated) sessions. */
+export declare function countActiveLiveSessions(): number;
+/** Per-agent variant — only counts entries whose `agentId` matches. Wave K. */
+export declare function countActiveLiveSessionsForAgent(agentIdValue: string): number;
+/** Mark every live entry for `sessionKey` idle (waiting on inbound). */
+export declare function markSessionIdle(sessionKey: string): boolean;
+/** Move every live entry for `sessionKey` into draining state. */
+export declare function markSessionDraining(sessionKey: string): boolean;
+/** Mark every live entry for `sessionKey` running again after an idle/draining pause. */
+export declare function markSessionRunning(sessionKey: string): boolean;
+/** Touch `lastActivityAt` on every entry for `sessionKey` without changing state. */
+export declare function touchSessionActivity(sessionKey: string): boolean;
+/**
+ * Abort EVERY live entry for the sessionKey (a single sessionKey may host
+ * multiple in-flight turns — heartbeat racing operator, retry races, etc.).
+ * Each matching entry's abort controller fires; each is transitioned to
+ * `terminated`. Returns `true` if at least one entry was found.
+ */
+export declare function abortLiveSession(sessionKey: string, reason?: string): boolean;
+/**
+ * Abort a single live entry by runId. Used when the caller knows the
+ * specific turn (not just the sessionKey) to cancel — heartbeat dispatcher
+ * cancelling its own synthetic turn, sub-agent runner cancelling a child.
+ */
+export declare function abortLiveSessionByRunId(runId: string, reason?: string): boolean;
+/**
+ * Remove a live entry from the registry. Resolves by runId when there's a
+ * unique entry, otherwise by sessionKey (when only one live entry exists).
+ * Does NOT call `abort()` — the caller is expected to have completed the
+ * turn (or to call `abortLiveSession` first). Returns `true` if the entry
+ * was present.
+ *
+ * Callers that hold a specific `runId` should prefer
+ * `unregisterLiveSessionByRunId` to avoid the ambiguity branch.
+ */
+export declare function unregisterLiveSession(sessionKey: string): boolean;
+/** Remove a single live entry by runId. Returns `true` if the entry was present. */
+export declare function unregisterLiveSessionByRunId(runId: string): boolean;
+/**
+ * Graceful shutdown: abort every session's turn + transition them all to
+ * `terminated`. Returns the count of sessions that received an abort.
+ * Doesn't unregister — entries linger until explicit `unregisterLiveSession`
+ * or `resetSessionRegistryForTests`.
+ */
+export declare function abortAllSessions(reason?: string): number;
+/**
+ * Subscribe to lifecycle transitions. Returns a disposer that removes the
+ * listener. Listener exceptions are logged + swallowed (a misbehaving
+ * subscriber must not crash the dispatcher).
+ */
+export declare function onSessionStateChange(listener: SessionStateListener): () => void;
+/** Test-only — drop every entry + every listener. */
+export declare function resetSessionRegistryForTests(): void;
+export {};
+//# sourceMappingURL=session-registry.d.ts.map

package/dist/agents/session-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-registry.d.ts","sourceRoot":"","sources":["../../src/agents/session-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAOH,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;AAEnF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,qBAAqB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,qBAAqB,GAAG,YAAY,CAAC;IACpD,QAAQ,EAAE,qBAAqB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;AAkDrE,MAAM,WAAW,qBAAqB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,iBAAiB,CAyCpF;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAYhF;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAGlF;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAW7E;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAK1D;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,GAC9C,iBAAiB,EAAE,CAErB;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,+EAA+E;AAC/E,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO5E;AAiCD,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAMhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAgB7E;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAc/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAmBjE;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAenE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBxD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAM/E;AAED,qDAAqD;AACrD,wBAAgB,4BAA4B,IAAI,IAAI,CAKnD"}