@mono-agent/session-web 0.4.1

package/dist/live-client.d.ts

@@ -0,0 +1,50 @@
+/**
+ * A read-only client for a running agent's operator-adapter live SSE endpoint
+ * (`GET <baseUrl>/v1/events`). Modeled on the TUI's `RemoteAgentResponder` reader
+ * loop (`packages/tui/src/remote/client.ts`): `fetch` with a streaming body,
+ * consumed via `res.body.getReader()` + `TextDecoder`, split into SSE frames on
+ * the blank-line separator. `data:` payloads are parsed as {@link RunEventFrame};
+ * `: ping` heartbeat comments are ignored. A dropped connection triggers bounded
+ * exponential-backoff reconnection until `close()`.
+ *
+ * HTTP only — this is how the `operator-surface` package reaches a `communication`
+ * adapter without importing it.
+ */
+import { type RunEventFrame } from "@mono-agent/agent-contracts";
+export type LiveStreamStatus = "connected" | "disconnected";
+export interface LiveStreamLogger {
+    warn?(message: string, metadata?: unknown): void;
+    error?(message: string, metadata?: unknown): void;
+}
+export interface ConnectLiveStreamOptions {
+    /** The agent's `live` SSE base URL, e.g. `http://127.0.0.1:52789/live`. `/v1/events` hangs off it. */
+    readonly baseUrl: string;
+    readonly apiKey?: string;
+    /** Called for each parsed frame, in arrival order. */
+    readonly onFrame: (frame: RunEventFrame) => void;
+    /** Called on every connect ("connected") and drop ("disconnected"). */
+    readonly onStatus: (status: LiveStreamStatus) => void;
+    readonly logger?: LiveStreamLogger;
+    readonly fetchImpl?: typeof fetch;
+    /** Reconnect backoff floor (ms). Default 500. */
+    readonly baseDelayMs?: number;
+    /** Reconnect backoff ceiling (ms). Default 10_000. */
+    readonly maxDelayMs?: number;
+    /**
+     * Max consecutive failed reconnect attempts before giving up. Default: unbounded
+     * — a live viewer should reconnect for as long as the instance is discovered;
+     * the aggregator closes this connection when the instance vanishes. Tests set a
+     * small value to bound the loop.
+     */
+    readonly maxRetries?: number;
+}
+export interface LiveStreamConnection {
+    /** Idempotent: abort the in-flight request and stop reconnecting. */
+    close(): void;
+}
+/**
+ * Open a live SSE stream and keep it open (reconnecting on drop) until `close()`.
+ * Returns synchronously; the connection is driven by a detached async loop.
+ */
+export declare function connectLiveStream(options: ConnectLiveStreamOptions): LiveStreamConnection;
+//# sourceMappingURL=live-client.d.ts.map

package/dist/live-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-client.d.ts","sourceRoot":"","sources":["../src/live-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEpG,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,cAAc,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,wBAAwB;IACvC,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,KAAK,IAAI,IAAI,CAAC;CACf;AAKD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,oBAAoB,CAkEzF"}

package/dist/live-client.js

@@ -0,0 +1,159 @@
+/**
+ * A read-only client for a running agent's operator-adapter live SSE endpoint
+ * (`GET <baseUrl>/v1/events`). Modeled on the TUI's `RemoteAgentResponder` reader
+ * loop (`packages/tui/src/remote/client.ts`): `fetch` with a streaming body,
+ * consumed via `res.body.getReader()` + `TextDecoder`, split into SSE frames on
+ * the blank-line separator. `data:` payloads are parsed as {@link RunEventFrame};
+ * `: ping` heartbeat comments are ignored. A dropped connection triggers bounded
+ * exponential-backoff reconnection until `close()`.
+ *
+ * HTTP only — this is how the `operator-surface` package reaches a `communication`
+ * adapter without importing it.
+ */
+import { DEFAULT_RUN_EVENT_MAX_FRAME_BYTES } from "@mono-agent/agent-contracts";
+const SSE_FRAME_SEPARATOR = "\n\n";
+const SSE_ENCODER = new TextEncoder();
+/**
+ * Open a live SSE stream and keep it open (reconnecting on drop) until `close()`.
+ * Returns synchronously; the connection is driven by a detached async loop.
+ */
+export function connectLiveStream(options) {
+    const baseUrl = options.baseUrl.replace(/\/+$/u, "");
+    const url = `${baseUrl}/v1/events`;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const baseDelayMs = options.baseDelayMs ?? 500;
+    const maxDelayMs = options.maxDelayMs ?? 10_000;
+    const maxRetries = options.maxRetries;
+    const headers = options.apiKey === undefined ? {} : { authorization: `Bearer ${options.apiKey}` };
+    let closed = false;
+    let controller;
+    let wakeDelay;
+    const stop = () => {
+        if (closed) {
+            return;
+        }
+        closed = true;
+        controller?.abort();
+        wakeDelay?.();
+    };
+    const loop = async () => {
+        let attempt = 0;
+        while (!closed) {
+            controller = new AbortController();
+            let connected = false;
+            try {
+                const response = await fetchImpl(url, { headers, signal: controller.signal });
+                if (!response.ok || response.body === null) {
+                    throw new Error(`live endpoint returned ${response.status}${response.body === null ? " (empty body)" : ""}.`);
+                }
+                connected = true;
+                attempt = 0;
+                options.onStatus("connected");
+                await readFrames(response.body, options.onFrame, options.logger);
+                // A clean end means the server closed the stream — fall through to reconnect.
+            }
+            catch (error) {
+                if (!closed) {
+                    options.logger?.warn?.("Live stream connection dropped.", {
+                        baseUrl,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+            if (connected) {
+                options.onStatus("disconnected");
+            }
+            if (closed) {
+                break;
+            }
+            attempt += 1;
+            if (maxRetries !== undefined && attempt > maxRetries) {
+                options.logger?.error?.("Live stream giving up after exhausting reconnect attempts.", { baseUrl, attempt });
+                break;
+            }
+            await sleep(backoffDelay(attempt, baseDelayMs, maxDelayMs), (wake) => {
+                wakeDelay = wake;
+            });
+            wakeDelay = undefined;
+        }
+    };
+    void loop();
+    return { close: stop };
+}
+/**
+ * Drain a streaming SSE body, invoking `onFrame` for each `data:` frame. Splits on
+ * the SSE blank-line separator; within a frame, concatenates `data:` lines (per
+ * the SSE spec) and ignores comment lines (`:` — the heartbeat). A `data:` payload
+ * that fails to parse as JSON is logged and skipped rather than tearing the stream.
+ */
+async function readFrames(body, onFrame, logger) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffered = "";
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            buffered += done ? decoder.decode() : decoder.decode(value, { stream: true });
+            let separator = buffered.indexOf(SSE_FRAME_SEPARATOR);
+            while (separator !== -1) {
+                const block = buffered.slice(0, separator);
+                buffered = buffered.slice(separator + SSE_FRAME_SEPARATOR.length);
+                emitBlock(block, onFrame, logger);
+                separator = buffered.indexOf(SSE_FRAME_SEPARATOR);
+            }
+            if (!done && SSE_ENCODER.encode(buffered).length > DEFAULT_RUN_EVENT_MAX_FRAME_BYTES) {
+                logger?.warn?.("Discarding oversized live SSE buffer.", { maxFrameBytes: DEFAULT_RUN_EVENT_MAX_FRAME_BYTES });
+                buffered = "";
+            }
+            if (done) {
+                break;
+            }
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+    }
+}
+function emitBlock(block, onFrame, logger) {
+    const dataParts = [];
+    for (const rawLine of block.split("\n")) {
+        const line = rawLine.replace(/\r$/u, "");
+        if (line.startsWith("data:")) {
+            dataParts.push(line.slice("data:".length).replace(/^ /u, ""));
+        }
+        // Comment lines (": ping") and field lines we don't consume are ignored.
+    }
+    if (dataParts.length === 0) {
+        return;
+    }
+    const payload = dataParts.join("\n");
+    if (SSE_ENCODER.encode(payload).length > DEFAULT_RUN_EVENT_MAX_FRAME_BYTES) {
+        logger?.warn?.("Discarding oversized live SSE frame.", { maxFrameBytes: DEFAULT_RUN_EVENT_MAX_FRAME_BYTES });
+        return;
+    }
+    try {
+        onFrame(JSON.parse(payload));
+    }
+    catch (error) {
+        logger?.warn?.("Discarding unparseable live SSE frame.", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/** Exponential backoff with full jitter, capped at `maxDelayMs`. */
+function backoffDelay(attempt, baseDelayMs, maxDelayMs) {
+    const exponential = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));
+    return Math.round(Math.random() * exponential);
+}
+/** A cancelable delay: resolves after `ms`, or immediately once `register`ed waker fires. */
+function sleep(ms, register) {
+    return new Promise((resolvePromise) => {
+        const timer = setTimeout(() => resolvePromise(), ms);
+        timer.unref?.();
+        register(() => {
+            clearTimeout(timer);
+            resolvePromise();
+        });
+    });
+}
+//# sourceMappingURL=live-client.js.map

package/dist/live-client.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,30 @@
+export interface StartSessionWebServerOptions {
+    readonly registryDirs: readonly string[];
+    readonly host?: string;
+    readonly port?: number;
+    readonly allowNonLoopback?: boolean;
+    readonly staleAfterMs?: number;
+    readonly maxRunsPerInstance?: number;
+    readonly env?: Record<string, string | undefined>;
+    readonly staticDir?: string;
+    /**
+     * Bearer token required for /api/* when present. Mandatory for non-loopback
+     * binds so the read-only operator API is not published unauthenticated.
+     */
+    readonly authToken?: string;
+    readonly logger?: {
+        info?(message: string, metadata?: unknown): void;
+        warn?(message: string, metadata?: unknown): void;
+        error?(message: string, metadata?: unknown): void;
+    };
+    /** Include memory-maintenance runs in history, API responses, and live frames. Default false. */
+    readonly includeMemory?: boolean;
+    /** Injectable clock for deterministic stale-running projection. Defaults to Date.now. */
+    readonly clock?: () => number;
+}
+export interface SessionWebServerHandle {
+    readonly url: string;
+    stop(): Promise<void>;
+}
+export declare function startSessionWebServer(options: StartSessionWebServerOptions): Promise<SessionWebServerHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACjD,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACjD,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACnD,CAAC;IACF,iGAAiG;IACjG,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,yFAAyF;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAYD,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAoIjC"}

package/dist/server.js

@@ -0,0 +1,359 @@
+/**
+ * The single HTTP backend the browser PWA talks to. Serves the built SPA
+ * (`express.static`), a read-only JSON API, and a browser SSE stream — all backed
+ * by one {@link SessionAggregator}. Binds loopback-only unless `allowNonLoopback`,
+ * via the shared `assertSafeBind`/`listen`/`close` host-safety helpers.
+ */
+import { createServer } from "node:http";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assertSafeBind, bearerTokensEqual, close, hostForUrl, isLoopbackHost, listen, normalizeOptionalString, readAuthorizationBearer, } from "@mono-agent/agent-contracts";
+import express, {} from "express";
+import { SessionAggregator } from "./aggregator.js";
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_PORT = 4599;
+const DEFAULT_MAX_RUNS_PER_INSTANCE = 200;
+/** Browser SSE heartbeat interval — a comment frame that keeps the connection warm through proxies. */
+const HEARTBEAT_INTERVAL_MS = 15_000;
+const MAX_BROWSER_SSE_QUEUE_FRAMES = 10_000;
+const MAX_BROWSER_SSE_FRAME_BYTES = 1_000_000;
+const BROWSER_FRAME_ENCODER = new TextEncoder();
+class SessionWebServerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "SessionWebServerError";
+        this.code = code;
+    }
+}
+export async function startSessionWebServer(options) {
+    const host = options.host ?? DEFAULT_HOST;
+    const port = options.port ?? DEFAULT_PORT;
+    const maxRunsPerInstance = options.maxRunsPerInstance ?? DEFAULT_MAX_RUNS_PER_INSTANCE;
+    const staticDir = options.staticDir ?? defaultStaticDir();
+    const logger = options.logger;
+    const authToken = normalizeOptionalString(options.authToken);
+    assertSafeBind(host, options.allowNonLoopback === true, (boundHost) => new SessionWebServerError("unsafe_host", `Session web server refuses to bind a non-loopback host (${boundHost}) unless allowNonLoopback is true.`));
+    if (!isLoopbackHost(host) && authToken === undefined) {
+        throw new SessionWebServerError("missing_auth_token", "Session web server requires an auth token when binding a non-loopback host.");
+    }
+    const aggregator = new SessionAggregator({
+        registryDirs: options.registryDirs,
+        maxRunsPerInstance,
+        ...(options.staleAfterMs === undefined ? {} : { staleAfterMs: options.staleAfterMs }),
+        ...(options.env === undefined ? {} : { env: options.env }),
+        ...(logger === undefined ? {} : { logger: logger }),
+        ...(options.includeMemory === undefined ? {} : { includeMemory: options.includeMemory }),
+        ...(options.clock === undefined ? {} : { clock: options.clock }),
+    });
+    await aggregator.start();
+    const app = express();
+    const server = createServer(app);
+    const activeStreams = new Set();
+    if (authToken !== undefined) {
+        app.use("/api", requireApiAuth(authToken));
+    }
+    app.get("/api/instances", (_req, res) => {
+        res.json({ instances: aggregator.getInstances() });
+    });
+    app.get("/api/sessions", (req, res, next) => {
+        const instance = firstString(req.query.instance) ?? "all";
+        const offset = parseOffset(firstString(req.query.offset));
+        const limit = parseLimit(firstString(req.query.limit));
+        if (offset > 0 || limit !== undefined) {
+            const pageLimit = limit ?? maxRunsPerInstance;
+            aggregator
+                .getSessionSummariesPage(instance, { offset, limit: pageLimit })
+                .then((page) => {
+                res.json(page);
+            })
+                .catch((error) => next(error));
+            return;
+        }
+        const sessions = aggregator.getSessionSummaries(instance);
+        res.json({ sessions, total: sessions.length, offset: 0, limit: sessions.length, hasMore: false });
+    });
+    app.get("/api/sessions/:sourceId/:runId", (req, res, next) => {
+        const sourceId = req.params.sourceId;
+        const runId = req.params.runId;
+        aggregator
+            .getSession(sourceId, runId)
+            .then((session) => {
+            if (session === undefined) {
+                res.status(404).json({ error: { message: "Session not found.", code: "not_found" } });
+                return;
+            }
+            res.json({ session });
+        })
+            .catch((error) => next(error));
+    });
+    app.get("/api/stream", (_req, res) => {
+        handleStream(aggregator, res, activeStreams, logger);
+    });
+    // Any other /api/* path is a genuine 404 (never falls through to the SPA).
+    app.use("/api", (_req, res) => {
+        res.status(404).json({ error: { message: "Not found.", code: "not_found" } });
+    });
+    // Static SPA assets, then a catch-all that returns index.html for client-side
+    // routes (unknown non-/api GETs). Any file that exists is served by static; the
+    // fallback only fires for paths static didn't resolve.
+    app.use(express.static(staticDir));
+    app.use((req, res, next) => {
+        if (req.method !== "GET") {
+            next();
+            return;
+        }
+        res.sendFile(join(staticDir, "index.html"), (error) => {
+            if (error !== undefined && error !== null) {
+                next();
+            }
+        });
+    });
+    app.use((error, _req, res, next) => {
+        if (res.headersSent) {
+            next(error);
+            return;
+        }
+        logger?.error?.("Session web request failed.", { error: error instanceof Error ? error.message : String(error) });
+        res.status(500).json({ error: { message: "Internal server error.", code: "internal_error" } });
+    });
+    try {
+        const address = await listen(server, port, host, {
+            listenFailed: (reason) => new SessionWebServerError("start_failed", `Session web server failed to listen: ${reason}`),
+            noAddress: () => new SessionWebServerError("start_failed", "Session web server did not receive a TCP address."),
+        });
+        const url = `http://${hostForUrl(host)}:${address.port}/`;
+        return {
+            url,
+            async stop() {
+                for (const closeStream of [...activeStreams]) {
+                    closeStream();
+                }
+                activeStreams.clear();
+                await close(server);
+                await aggregator.stop();
+            },
+        };
+    }
+    catch (error) {
+        // Don't leak the aggregator's watchers/live connections if we never bound.
+        await aggregator.stop();
+        throw error;
+    }
+}
+function handleStream(aggregator, res, activeStreams, logger) {
+    res.status(200);
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache, no-transform");
+    res.setHeader("Connection", "keep-alive");
+    res.setHeader("X-Accel-Buffering", "no");
+    res.socket?.setNoDelay(true);
+    res.flushHeaders();
+    const queue = [];
+    const pendingUpserts = new Map();
+    const pendingRemovals = new Map();
+    let pendingInstances;
+    let draining = false;
+    let closed = false;
+    let unsubscribe;
+    let heartbeat;
+    const closeStream = () => {
+        if (closed) {
+            return;
+        }
+        closed = true;
+        if (heartbeat !== undefined) {
+            clearInterval(heartbeat);
+            heartbeat = undefined;
+        }
+        unsubscribe?.();
+        unsubscribe = undefined;
+        queue.length = 0;
+        pendingUpserts.clear();
+        pendingRemovals.clear();
+        pendingInstances = undefined;
+        activeStreams.delete(closeStream);
+        if (!res.writableEnded) {
+            res.end();
+        }
+    };
+    activeStreams.add(closeStream);
+    const flush = () => {
+        while (!closed && !draining && queue.length > 0) {
+            const entry = queue.shift();
+            if (entry === undefined) {
+                break;
+            }
+            if (entry.frame.t === "session_upsert") {
+                pendingUpserts.delete(sessionQueueKey(entry.frame.session));
+            }
+            else if (entry.frame.t === "session_removed") {
+                pendingRemovals.delete(sessionQueueKey({ id: entry.frame.runId, sourceId: entry.frame.sourceId }));
+            }
+            else if (entry === pendingInstances) {
+                pendingInstances = undefined;
+            }
+            if (res.writableEnded) {
+                closed = true;
+                return;
+            }
+            const payload = serializeBrowserFrame(entry.frame, logger);
+            if (payload === undefined) {
+                continue;
+            }
+            const ok = res.write(payload);
+            if (!ok) {
+                draining = true;
+                res.once("drain", () => {
+                    draining = false;
+                    flush();
+                });
+                return;
+            }
+        }
+    };
+    const enqueue = (frame) => {
+        if (closed || res.writableEnded) {
+            return;
+        }
+        if (frame.t === "session_upsert") {
+            const queueKey = sessionQueueKey(frame.session);
+            const existing = pendingUpserts.get(queueKey);
+            if (existing !== undefined) {
+                // Coalesce by REMOVING the stale queued upsert and re-appending the latest
+                // at the tail — not overwriting in place. If a session_removed for the same
+                // id was enqueued between the two upserts, the removed frame keeps its slot
+                // and the newer upsert lands AFTER it, so last-write-wins (run present) is
+                // preserved on drain rather than the browser ending on a stale removal.
+                const idx = queue.indexOf(existing);
+                if (idx >= 0) {
+                    queue.splice(idx, 1);
+                }
+            }
+            const entry = { frame };
+            pendingUpserts.set(queueKey, entry);
+            queue.push(entry);
+        }
+        else if (frame.t === "session_removed") {
+            const queueKey = sessionQueueKey({ id: frame.runId, sourceId: frame.sourceId });
+            const staleUpsert = pendingUpserts.get(queueKey);
+            if (staleUpsert !== undefined) {
+                const idx = queue.indexOf(staleUpsert);
+                if (idx >= 0) {
+                    queue.splice(idx, 1);
+                }
+                pendingUpserts.delete(queueKey);
+            }
+            const existing = pendingRemovals.get(queueKey);
+            if (existing !== undefined) {
+                const idx = queue.indexOf(existing);
+                if (idx >= 0) {
+                    queue.splice(idx, 1);
+                }
+            }
+            const entry = { frame };
+            pendingRemovals.set(queueKey, entry);
+            queue.push(entry);
+        }
+        else if (frame.t === "instances") {
+            if (pendingInstances !== undefined) {
+                const idx = queue.indexOf(pendingInstances);
+                if (idx >= 0) {
+                    queue.splice(idx, 1);
+                }
+            }
+            pendingInstances = { frame };
+            queue.push(pendingInstances);
+        }
+        else {
+            queue.push({ frame });
+        }
+        if (queue.length > MAX_BROWSER_SSE_QUEUE_FRAMES) {
+            closeStream();
+            return;
+        }
+        flush();
+    };
+    // Initial snapshot: the instance list, then one upsert per current session, so a
+    // fresh browser reconstructs full state before any live frame arrives. It flows
+    // through the same backpressure-aware queue; the aggregator's per-instance
+    // eviction cap bounds how large the snapshot can grow.
+    enqueue({ t: "instances", instances: aggregator.getInstances() });
+    for (const session of aggregator.getSessionSummaries("all")) {
+        enqueue({ t: "session_upsert", session });
+    }
+    unsubscribe = aggregator.subscribe(enqueue);
+    heartbeat = setInterval(() => {
+        // Skip the keep-alive while draining so we don't pile onto a full buffer.
+        if (!closed && !draining && !res.writableEnded) {
+            res.write(": ping\n\n");
+        }
+    }, HEARTBEAT_INTERVAL_MS);
+    heartbeat.unref?.();
+    res.on("close", () => {
+        closeStream();
+    });
+}
+function sessionQueueKey(session) {
+    return `${session.sourceId ?? session.instance ?? ""}:${session.id}`;
+}
+/**
+ * Resolve the built SPA directory relative to this module. The dist layout is
+ * `dist/server.js` alongside a sibling `webapp/dist`, so `../webapp/dist` from the
+ * module dir. Overridable by `options.staticDir`.
+ */
+function defaultStaticDir() {
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    return resolve(moduleDir, "../webapp/dist");
+}
+function firstString(value) {
+    if (Array.isArray(value)) {
+        return firstString(value[0]);
+    }
+    return normalizeOptionalString(typeof value === "string" ? value : undefined);
+}
+function parseLimit(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isInteger(parsed) && parsed >= 0 ? parsed : undefined;
+}
+function parseOffset(value) {
+    if (value === undefined) {
+        return 0;
+    }
+    const parsed = Number.parseInt(value, 10);
+    return Number.isInteger(parsed) && parsed >= 0 ? parsed : 0;
+}
+function requireApiAuth(authToken) {
+    return (req, res, next) => {
+        const supplied = readAuthorizationBearer(req.headers.authorization) ?? firstString(req.query.token);
+        if (supplied !== undefined && bearerTokensEqual(supplied, authToken)) {
+            next();
+            return;
+        }
+        res.status(401).json({ error: { message: "Unauthorized.", code: "unauthorized" } });
+    };
+}
+function serializeBrowserFrame(frame, logger) {
+    try {
+        const json = JSON.stringify(frame);
+        if (BROWSER_FRAME_ENCODER.encode(json).length > MAX_BROWSER_SSE_FRAME_BYTES) {
+            logger?.warn?.("Dropped oversized browser SSE frame.", {
+                maxFrameBytes: MAX_BROWSER_SSE_FRAME_BYTES,
+                frameType: frame.t,
+            });
+            return undefined;
+        }
+        return `data: ${json}\n\n`;
+    }
+    catch (error) {
+        logger?.warn?.("Dropped unserializable browser SSE frame.", {
+            reason: error instanceof Error ? error.message : String(error),
+            frameType: frame.t,
+        });
+        return undefined;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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