@mono-agent/operator-adapter 0.4.1

package/README.md

@@ -0,0 +1,95 @@
+# @mono-agent/operator-adapter
+
+## Category
+
+Category: `communication`
+
+## Responsibility
+
+Loopback operator endpoints for local mono-agent surfaces:
+
+- the TUI NDJSON turn endpoint, which lets `mono-agent tui` chat with a running
+  agent at full `AgentStreamEvent` fidelity.
+- the live SSE event relay, which streams the host's in-process run-event bus to
+  read-only operator surfaces such as `mono-agent web`.
+
+Both endpoints keep their existing wire contracts, routes, env vars, defaults,
+auth behavior, and error behavior.
+
+## Install / Usage
+
+```bash
+pnpm --filter @mono-agent/operator-adapter run build
+```
+
+```ts
+import {
+  createLiveEventBus,
+  startLiveAdapter,
+  startTuiAdapter,
+} from "@mono-agent/operator-adapter";
+
+const tui = await startTuiAdapter({
+  responder,
+  info: { label: "personal-agent", model: "claude-fable-5" },
+});
+
+const bus = createLiveEventBus();
+const live = await startLiveAdapter({ bus, host: "127.0.0.1", port: 0 });
+
+await tui.stop();
+await live.stop();
+```
+
+### TUI Endpoints
+
+- `GET {basePath}/v1/info` - `{ schema, pid, label?, model?, effort? }`.
+- `POST {basePath}/v1/turns` - body `{ conversationId, text, metadata? }`;
+  responds with chunked `application/x-ndjson` frames
+  (`status | append | replace | event | finish | error`). Closing the socket
+  aborts the in-flight turn.
+- `POST {basePath}/v1/conversations/:id/cancel` - explicit cancel (202; 501
+  when the responder has no `cancel`).
+
+### Live Endpoints
+
+- `GET {basePath}/v1/info` - `{ schema, pid, label? }`.
+- `GET {basePath}/v1/events` - `text/event-stream` replaying recent
+  `RunEventFrame` values and streaming future frames.
+
+## Public API
+
+- TUI: `startTuiAdapter`, `loadTuiAdapterConfig`,
+  `redactTuiAdapterConfig`, `TUI_CONFIG_FIELDS`, `MAX_FRAME_BYTES`,
+  `DEFAULT_TUI_BASE_PATH`, `TUI_WIRE_SCHEMA`, `TuiAdapterError`, and the TUI
+  option/config/result/error types.
+- Live: `startLiveAdapter`, `loadLiveAdapterConfig`,
+  `redactLiveAdapterConfig`, `LIVE_CONFIG_FIELDS`, `DEFAULT_LIVE_BASE_PATH`,
+  `LIVE_ADAPTER_INFO_SCHEMA`, `LiveAdapterError`, and the live
+  option/config/result/error types.
+- Live bus/contracts re-exported from `@mono-agent/agent-contracts`:
+  `createLiveEventBus`, `LIVE_EVENT_SCHEMA`, `RunEventBus`, `RunEventFrame`,
+  `RunEventSink`, and `CreateLiveEventBusOptions`.
+
+## Dependency Boundary
+
+This adapter depends on Express plus shared `@mono-agent/agent-contracts`
+primitives. It must not depend on the agent harness, runtime adapter, operator
+surfaces, memory, observability, other communication adapters, or host/demo
+code. Hosts compose it with structural responders and an optional run-event bus.
+
+## What This Package Does Not Own
+
+It does not build prompts, run models, persist conversations, discover running
+agents, render operator UIs, interpret live events, implement replay/config
+views, or own TLS/public deployment policy. Both servers bind loopback-only by
+default; exposing either endpoint beyond loopback is a host decision guarded by
+`allowNonLoopback`.
+
+## Verification
+
+```bash
+pnpm --filter @mono-agent/operator-adapter run build
+pnpm --filter @mono-agent/operator-adapter run typecheck
+pnpm --filter @mono-agent/operator-adapter run test
+```

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { TuiAdapterError } from "./tui/index.js";
+export type { TuiAdapterErrorCode, TuiAdapterErrorDetails } from "./tui/index.js";
+export { startTuiAdapter } from "./tui/index.js";
+export type { TuiAdapterInfo, TuiAdapterLogger, TuiAdapterOptions, TuiAdapterStartResult, } from "./tui/index.js";
+export { loadTuiAdapterConfig, redactTuiAdapterConfig, TUI_CONFIG_FIELDS, } from "./tui/index.js";
+export type { LoadTuiAdapterConfigInput, RedactedTuiAdapterConfig, TuiAdapterConfig, } from "./tui/index.js";
+export { DEFAULT_BASE_PATH as DEFAULT_TUI_BASE_PATH, DEFAULT_HOST as DEFAULT_TUI_HOST, DEFAULT_PORT as DEFAULT_TUI_PORT, MAX_FRAME_BYTES, TUI_WIRE_SCHEMA, } from "./tui/constants.js";
+export { startLiveAdapter } from "./live/index.js";
+export type { LiveAdapterHandle, LiveAdapterLogger, LiveAdapterOptions, } from "./live/index.js";
+export { LiveAdapterError } from "./live/index.js";
+export type { LiveAdapterErrorCode, LiveAdapterErrorDetails } from "./live/index.js";
+export { loadLiveAdapterConfig, redactLiveAdapterConfig, LIVE_CONFIG_FIELDS } from "./live/index.js";
+export type { LiveAdapterConfig, RedactedLiveAdapterConfig, LoadLiveAdapterConfigInput, } from "./live/index.js";
+export { DEFAULT_LIVE_BASE_PATH, DEFAULT_LIVE_HOST, DEFAULT_LIVE_PORT, LIVE_ADAPTER_INFO_SCHEMA, LIVE_HEARTBEAT_INTERVAL_MS, } from "./live/index.js";
+export { LIVE_EVENT_SCHEMA, createLiveEventBus } from "./live/index.js";
+export type { CreateLiveEventBusOptions, RunEventBus, RunEventFrame, RunEventSink, } from "./live/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,yBAAyB,EACzB,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,IAAI,qBAAqB,EAC1C,YAAY,IAAI,gBAAgB,EAChC,YAAY,IAAI,gBAAgB,EAChC,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrG,YAAY,EACV,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACxE,YAAY,EACV,yBAAyB,EACzB,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { TuiAdapterError } from "./tui/index.js";
+export { startTuiAdapter } from "./tui/index.js";
+export { loadTuiAdapterConfig, redactTuiAdapterConfig, TUI_CONFIG_FIELDS, } from "./tui/index.js";
+export { DEFAULT_BASE_PATH as DEFAULT_TUI_BASE_PATH, DEFAULT_HOST as DEFAULT_TUI_HOST, DEFAULT_PORT as DEFAULT_TUI_PORT, MAX_FRAME_BYTES, TUI_WIRE_SCHEMA, } from "./tui/constants.js";
+export { startLiveAdapter } from "./live/index.js";
+export { LiveAdapterError } from "./live/index.js";
+export { loadLiveAdapterConfig, redactLiveAdapterConfig, LIVE_CONFIG_FIELDS } from "./live/index.js";
+export { DEFAULT_LIVE_BASE_PATH, DEFAULT_LIVE_HOST, DEFAULT_LIVE_PORT, LIVE_ADAPTER_INFO_SCHEMA, LIVE_HEARTBEAT_INTERVAL_MS, } from "./live/index.js";
+export { LIVE_EVENT_SCHEMA, createLiveEventBus } from "./live/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAOjD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EACL,iBAAiB,IAAI,qBAAqB,EAC1C,YAAY,IAAI,gBAAgB,EAChC,YAAY,IAAI,gBAAgB,EAChC,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAMnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAMrG,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/live/config.d.ts

@@ -0,0 +1,27 @@
+import type { JsonEnvFieldSpec, RedactedSecretValue, SettingsJson } from "@mono-agent/agent-contracts";
+export interface LiveAdapterConfig {
+    readonly enabled: boolean;
+    readonly host: string;
+    readonly port: number;
+    readonly basePath: string;
+    readonly allowNonLoopback: boolean;
+    readonly apiKey?: string;
+}
+export interface RedactedLiveAdapterConfig extends Omit<LiveAdapterConfig, "apiKey"> {
+    readonly apiKey: RedactedSecretValue;
+}
+export interface LoadLiveAdapterConfigInput {
+    readonly env: Record<string, string | undefined>;
+    readonly json?: SettingsJson;
+    readonly jsonPath?: string;
+}
+export declare function loadLiveAdapterConfig(input: LoadLiveAdapterConfigInput): Promise<LiveAdapterConfig>;
+export declare function redactLiveAdapterConfig(config: LiveAdapterConfig): RedactedLiveAdapterConfig;
+/**
+ * The `live` section's field registry: the single source of truth for JSON→env
+ * layering and the app's config provenance view. The `live.apiKey` id doubles as
+ * a cross-package contract — `mono-agent web` resolves a running agent's key by
+ * reading this field from the agent's config file (the registry carries no secrets).
+ */
+export declare const LIVE_CONFIG_FIELDS: readonly JsonEnvFieldSpec[];
+//# sourceMappingURL=config.d.ts.map

package/dist/live/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/live/config.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAKvG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC;IAClF,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAcD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,yBAAyB,CAS5F;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAOzD,CAAC"}

package/dist/live/config.js

@@ -0,0 +1,67 @@
+import { fieldSpecMappings, layerJsonOntoEnv, normalizeOptionalString, readBoolean, readInteger, readJsonSection, readSettingsJson, readString, redactedSecret, } from "@mono-agent/agent-contracts";
+import { DEFAULT_LIVE_BASE_PATH, DEFAULT_LIVE_HOST, DEFAULT_LIVE_PORT } from "./constants.js";
+import { LiveAdapterError } from "./errors.js";
+/**
+ * Like the TUI endpoint (and unlike every chat channel, default OFF), the live
+ * event relay is ON by default: it is a read-only operator surface, binds
+ * loopback-only on an ephemeral port, and needs no credentials — so
+ * `mono-agent web` can observe any running agent without a per-agent config edit.
+ * Set `"live": { "enabled": false }` to opt out.
+ */
+const DEFAULT_ENABLED = true;
+const invalidConfig = (message, details) => new LiveAdapterError("invalid_config", message, details);
+export async function loadLiveAdapterConfig(input) {
+    const json = input.json ?? (input.jsonPath === undefined ? {} : (await readSettingsJson(input.jsonPath)).json);
+    const env = layerLiveJsonOntoEnv(json, input.env);
+    const apiKey = normalizeOptionalString(env.MONO_AGENT_LIVE_API_KEY);
+    return {
+        enabled: readBoolean(env.MONO_AGENT_LIVE_ENABLED, "MONO_AGENT_LIVE_ENABLED", DEFAULT_ENABLED, invalidConfig),
+        host: readString(env.MONO_AGENT_LIVE_HOST, DEFAULT_LIVE_HOST),
+        port: readInteger(env.MONO_AGENT_LIVE_PORT, "MONO_AGENT_LIVE_PORT", DEFAULT_LIVE_PORT, invalidConfig, {
+            min: 0,
+            max: 65535,
+        }),
+        basePath: readBasePath(env.MONO_AGENT_LIVE_BASE_PATH),
+        allowNonLoopback: readBoolean(env.MONO_AGENT_LIVE_ALLOW_NON_LOOPBACK, "MONO_AGENT_LIVE_ALLOW_NON_LOOPBACK", false, invalidConfig),
+        ...(apiKey === undefined ? {} : { apiKey }),
+    };
+}
+export function redactLiveAdapterConfig(config) {
+    return {
+        enabled: config.enabled,
+        host: config.host,
+        port: config.port,
+        basePath: config.basePath,
+        allowNonLoopback: config.allowNonLoopback,
+        apiKey: redactedSecret(config.apiKey),
+    };
+}
+/**
+ * The `live` section's field registry: the single source of truth for JSON→env
+ * layering and the app's config provenance view. The `live.apiKey` id doubles as
+ * a cross-package contract — `mono-agent web` resolves a running agent's key by
+ * reading this field from the agent's config file (the registry carries no secrets).
+ */
+export const LIVE_CONFIG_FIELDS = [
+    { id: "live.enabled", env: "MONO_AGENT_LIVE_ENABLED", kind: "boolean", fromJson: (s) => s.enabled },
+    { id: "live.host", env: "MONO_AGENT_LIVE_HOST", fromJson: (s) => s.host },
+    { id: "live.port", env: "MONO_AGENT_LIVE_PORT", kind: "integer", fromJson: (s) => s.port },
+    { id: "live.basePath", env: "MONO_AGENT_LIVE_BASE_PATH", fromJson: (s) => s.basePath },
+    { id: "live.allowNonLoopback", env: "MONO_AGENT_LIVE_ALLOW_NON_LOOPBACK", kind: "boolean", fromJson: (s) => s.allowNonLoopback },
+    { id: "live.apiKey", env: "MONO_AGENT_LIVE_API_KEY", secret: true, fromJson: (s) => s.apiKey },
+];
+function layerLiveJsonOntoEnv(json, env) {
+    return layerJsonOntoEnv(env, fieldSpecMappings(readJsonSection(json, "live"), LIVE_CONFIG_FIELDS));
+}
+function readBasePath(raw) {
+    const value = readString(raw, DEFAULT_LIVE_BASE_PATH);
+    if (!isLiteralBasePath(value)) {
+        throw invalidConfig("MONO_AGENT_LIVE_BASE_PATH must be an absolute literal path made of slash-separated URL path segments.");
+    }
+    const stripped = value.replace(/\/+$/u, "");
+    return stripped.length === 0 ? "/" : stripped;
+}
+function isLiteralBasePath(basePath) {
+    return basePath === "/" || /^\/[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*\/?$/u.test(basePath);
+}
+//# sourceMappingURL=config.js.map

package/dist/live/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/live/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,cAAc,GACf,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAqB/C;;;;;;GAMG;AACH,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,OAAiC,EAAoB,EAAE,CAC7F,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAiC;IAEjC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/G,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACpE,OAAO;QACL,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,uBAAuB,EAAE,yBAAyB,EAAE,eAAe,EAAE,aAAa,CAAC;QAC5G,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;QAC7D,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,aAAa,EAAE;YACpG,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,KAAK;SACX,CAAC;QACF,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,yBAAyB,CAAC;QACrD,gBAAgB,EAAE,WAAW,CAC3B,GAAG,CAAC,kCAAkC,EACtC,oCAAoC,EACpC,KAAK,EACL,aAAa,CACd;QACD,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAyB;IAC/D,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,yBAAyB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;IACnG,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,sBAAsB,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;IACzE,EAAE,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,sBAAsB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;IAC1F,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,2BAA2B,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtF,EAAE,EAAE,EAAE,uBAAuB,EAAE,GAAG,EAAE,oCAAoC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE;IAChI,EAAE,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,yBAAyB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;CAC/F,CAAC;AAEF,SAAS,oBAAoB,CAC3B,IAAkB,EAClB,GAAuC;IAEvC,OAAO,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC;AACrG,CAAC;AAED,SAAS,YAAY,CAAC,GAAuB;IAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;IACtD,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,aAAa,CAAC,uGAAuG,CAAC,CAAC;IAC/H,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChD,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,QAAQ,KAAK,GAAG,IAAI,iDAAiD,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC9F,CAAC"}

package/dist/live/constants.d.ts

@@ -0,0 +1,18 @@
+/** Loopback-only default bind host — the adapter refuses non-loopback unless explicitly allowed. */
+export declare const DEFAULT_LIVE_HOST = "127.0.0.1";
+/** Default TCP port. `0` lets the OS pick a free ephemeral port (read back from the handle's baseUrl). */
+export declare const DEFAULT_LIVE_PORT = 0;
+/** Default URL prefix under which the adapter mounts `/v1/info` and `/v1/events`. */
+export declare const DEFAULT_LIVE_BASE_PATH = "/live";
+/**
+ * Schema tag surfaced by GET /v1/info so a discovery probe can identify the
+ * adapter and its wire version before subscribing to the event stream.
+ */
+export declare const LIVE_ADAPTER_INFO_SCHEMA = "live-adapter.v1";
+/**
+ * Interval between SSE heartbeat comment lines (`: ping\n\n`). Heartbeats keep
+ * idle proxies/clients from dropping the connection between runs; the comment
+ * form carries no data and is ignored by SSE parsers.
+ */
+export declare const LIVE_HEARTBEAT_INTERVAL_MS = 15000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/live/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/live/constants.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,0GAA0G;AAC1G,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC"}

package/dist/live/constants.js

@@ -0,0 +1,18 @@
+/** Loopback-only default bind host — the adapter refuses non-loopback unless explicitly allowed. */
+export const DEFAULT_LIVE_HOST = "127.0.0.1";
+/** Default TCP port. `0` lets the OS pick a free ephemeral port (read back from the handle's baseUrl). */
+export const DEFAULT_LIVE_PORT = 0;
+/** Default URL prefix under which the adapter mounts `/v1/info` and `/v1/events`. */
+export const DEFAULT_LIVE_BASE_PATH = "/live";
+/**
+ * Schema tag surfaced by GET /v1/info so a discovery probe can identify the
+ * adapter and its wire version before subscribing to the event stream.
+ */
+export const LIVE_ADAPTER_INFO_SCHEMA = "live-adapter.v1";
+/**
+ * Interval between SSE heartbeat comment lines (`: ping\n\n`). Heartbeats keep
+ * idle proxies/clients from dropping the connection between runs; the comment
+ * form carries no data and is ignored by SSE parsers.
+ */
+export const LIVE_HEARTBEAT_INTERVAL_MS = 15_000;
+//# sourceMappingURL=constants.js.map

package/dist/live/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/live/constants.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE7C,0GAA0G;AAC1G,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,qFAAqF;AACrF,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC"}

package/dist/live/errors.d.ts

@@ -0,0 +1,12 @@
+import { CodedError } from "@mono-agent/agent-contracts";
+export type LiveAdapterErrorCode = "invalid_config" | "unsafe_host" | "start_failed";
+export interface LiveAdapterErrorDetails {
+    readonly code?: LiveAdapterErrorCode;
+    readonly reason?: string;
+    readonly [key: string]: unknown;
+}
+export declare class LiveAdapterError extends CodedError<LiveAdapterErrorCode> {
+    readonly details: LiveAdapterErrorDetails;
+    constructor(code: LiveAdapterErrorCode, message: string, details?: LiveAdapterErrorDetails);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/live/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/live/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,gBAAiB,SAAQ,UAAU,CAAC,oBAAoB,CAAC;IACpE,SAAiB,OAAO,EAAE,uBAAuB,CAAC;gBAGhD,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B;CAIxC"}

package/dist/live/errors.js

@@ -0,0 +1,7 @@
+import { CodedError } from "@mono-agent/agent-contracts";
+export class LiveAdapterError extends CodedError {
+    constructor(code, message, details = {}) {
+        super(code, message, details);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/live/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/live/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAazD,MAAM,OAAO,gBAAiB,SAAQ,UAAgC;IAGpE,YACE,IAA0B,EAC1B,OAAe,EACf,UAAmC,EAAE;QAErC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/live/index.d.ts

@@ -0,0 +1,10 @@
+export { startLiveAdapter } from "./server.js";
+export type { LiveAdapterHandle, LiveAdapterLogger, LiveAdapterOptions, } from "./server.js";
+export { LiveAdapterError } from "./errors.js";
+export type { LiveAdapterErrorCode, LiveAdapterErrorDetails } from "./errors.js";
+export { loadLiveAdapterConfig, redactLiveAdapterConfig, LIVE_CONFIG_FIELDS } from "./config.js";
+export type { LiveAdapterConfig, RedactedLiveAdapterConfig, LoadLiveAdapterConfigInput, } from "./config.js";
+export { DEFAULT_LIVE_BASE_PATH, DEFAULT_LIVE_HOST, DEFAULT_LIVE_PORT, LIVE_ADAPTER_INFO_SCHEMA, LIVE_HEARTBEAT_INTERVAL_MS, } from "./constants.js";
+export { LIVE_EVENT_SCHEMA, createLiveEventBus } from "@mono-agent/agent-contracts";
+export type { CreateLiveEventBusOptions, RunEventBus, RunEventFrame, RunEventSink, } from "@mono-agent/agent-contracts";
+//# sourceMappingURL=index.d.ts.map

package/dist/live/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjG,YAAY,EACV,iBAAiB,EACjB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAIxB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACpF,YAAY,EACV,yBAAyB,EACzB,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,6BAA6B,CAAC"}

package/dist/live/index.js

@@ -0,0 +1,8 @@
+export { startLiveAdapter } from "./server.js";
+export { LiveAdapterError } from "./errors.js";
+export { loadLiveAdapterConfig, redactLiveAdapterConfig, LIVE_CONFIG_FIELDS } from "./config.js";
+export { DEFAULT_LIVE_BASE_PATH, DEFAULT_LIVE_HOST, DEFAULT_LIVE_PORT, LIVE_ADAPTER_INFO_SCHEMA, LIVE_HEARTBEAT_INTERVAL_MS, } from "./constants.js";
+// Re-export the shared live-event contract + the in-process bus factory (both live
+// in core) so consumers can build/type producers and subscribers from one import.
+export { LIVE_EVENT_SCHEMA, createLiveEventBus } from "@mono-agent/agent-contracts";
+//# sourceMappingURL=index.js.map

package/dist/live/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAM/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMjG,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAExB,mFAAmF;AACnF,kFAAkF;AAClF,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/live/server.d.ts

@@ -0,0 +1,40 @@
+import { type RunEventBus } from "@mono-agent/agent-contracts";
+export interface LiveAdapterLogger {
+    debug?(message: string, metadata?: Record<string, unknown>): void;
+    info?(message: string, metadata?: Record<string, unknown>): void;
+    warn?(message: string, metadata?: Record<string, unknown>): void;
+    error?(message: string, metadata?: Record<string, unknown>): void;
+}
+export interface LiveAdapterOptions {
+    /** In-process bus the adapter subscribes to and replays. Read-only — never written. */
+    readonly bus: RunEventBus;
+    readonly host?: string;
+    readonly port?: number;
+    readonly basePath?: string;
+    readonly allowNonLoopback?: boolean;
+    /** When set, both routes require `Authorization: Bearer <apiKey>`; a mismatch is a 401. */
+    readonly apiKey?: string;
+    /** Human label surfaced by GET /v1/info so a discovery probe can name the instance. */
+    readonly label?: string;
+    /**
+     * Invoked when the already-listening HTTP server dies (e.g. a socket-level
+     * failure appearing later). The hosting channel driver maps this to its
+     * onFailure hook so the channel flips to "failed" instead of silently serving
+     * nothing.
+     */
+    readonly onServerError?: (reason: string) => void;
+    readonly logger?: LiveAdapterLogger;
+}
+export interface LiveAdapterHandle {
+    /** SSE root: `http://<host>:<actualPort><basePath>`. `/v1/events` and `/v1/info` hang off it. */
+    readonly baseUrl: string;
+    /** Tear down every open SSE connection and close the HTTP server. */
+    stop(): Promise<void>;
+}
+/**
+ * Start a loopback, read-only SSE server that relays a {@link RunEventBus} to
+ * operator surfaces. It observes only: there is no turn-driving endpoint and no
+ * reference to a responder.
+ */
+export declare function startLiveAdapter(options: LiveAdapterOptions): Promise<LiveAdapterHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/live/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/live/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqC,KAAK,WAAW,EAAsB,MAAM,6BAA6B,CAAC;AAwBtH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAClE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,2FAA2F;IAC3F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AASD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmL9F"}

package/dist/live/server.js

@@ -0,0 +1,219 @@
+import { createServer } from "node:http";
+import { DEFAULT_RUN_EVENT_MAX_FRAME_BYTES } from "@mono-agent/agent-contracts";
+import { assertSafeBind, bearerTokensEqual, close, hostForUrl, listen, normalizeOptionalString, readAuthorizationBearer, } from "@mono-agent/agent-contracts";
+import express, {} from "express";
+import { DEFAULT_LIVE_BASE_PATH, DEFAULT_LIVE_HOST, DEFAULT_LIVE_PORT, LIVE_ADAPTER_INFO_SCHEMA, LIVE_HEARTBEAT_INTERVAL_MS, } from "./constants.js";
+import { LiveAdapterError } from "./errors.js";
+const MAX_SSE_QUEUE_FRAMES = 1_000;
+const FRAME_ENCODER = new TextEncoder();
+/**
+ * Start a loopback, read-only SSE server that relays a {@link RunEventBus} to
+ * operator surfaces. It observes only: there is no turn-driving endpoint and no
+ * reference to a responder.
+ */
+export async function startLiveAdapter(options) {
+    if (options.bus === undefined || typeof options.bus.subscribe !== "function") {
+        throw new LiveAdapterError("invalid_config", "startLiveAdapter requires a RunEventBus.");
+    }
+    const host = options.host ?? DEFAULT_LIVE_HOST;
+    const port = options.port ?? DEFAULT_LIVE_PORT;
+    const basePath = normalizeBasePath(options.basePath ?? DEFAULT_LIVE_BASE_PATH);
+    const apiKey = normalizeOptionalString(options.apiKey);
+    const label = normalizeOptionalString(options.label);
+    assertSafeBind(host, options.allowNonLoopback === true, (boundHost) => new LiveAdapterError("unsafe_host", "Live adapter refuses to bind a non-loopback host unless allowNonLoopback is true.", { host: boundHost }));
+    const app = express();
+    const server = createServer(app);
+    const infoPath = `${basePath}/v1/info`;
+    const eventsPath = `${basePath}/v1/events`;
+    const connections = new Set();
+    app.get(infoPath, (req, res) => {
+        if (!authorize(req, res, apiKey)) {
+            return;
+        }
+        res.status(200).json({
+            schema: LIVE_ADAPTER_INFO_SCHEMA,
+            pid: process.pid,
+            ...(label === undefined ? {} : { label }),
+        });
+    });
+    app.get(eventsPath, (req, res) => {
+        if (!authorize(req, res, apiKey)) {
+            return;
+        }
+        handleEvents(res);
+    });
+    const address = await listen(server, port, host, {
+        listenFailed: (reason) => new LiveAdapterError("start_failed", "Live adapter failed to listen.", { reason }),
+        noAddress: () => new LiveAdapterError("start_failed", "Live adapter did not receive a TCP address."),
+    });
+    server.on("error", (error) => {
+        options.onServerError?.(errorToMessage(error));
+    });
+    const baseUrl = `http://${hostForUrl(host)}:${address.port}${basePath}`;
+    function handleEvents(res) {
+        // SSE handshake. Mirror the openai-api-adapter header set; disable Nagle so
+        // each frame flushes immediately, and flush headers before subscribing so
+        // the client sees the stream open promptly.
+        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 = [];
+        let draining = false;
+        let closed = false;
+        let teardown;
+        const flush = () => {
+            while (!closed && !draining && queue.length > 0) {
+                const payload = queue.shift();
+                if (payload === undefined) {
+                    break;
+                }
+                if (res.writableEnded) {
+                    closed = true;
+                    return;
+                }
+                const ok = res.write(payload);
+                if (!ok) {
+                    draining = true;
+                    res.once("drain", () => {
+                        draining = false;
+                        flush();
+                    });
+                    return;
+                }
+            }
+        };
+        const closeSlowClient = () => {
+            if (closed) {
+                return;
+            }
+            options.logger?.warn?.("Closing slow live SSE client after queue overflow.", {
+                queuedFrames: queue.length,
+                maxQueuedFrames: MAX_SSE_QUEUE_FRAMES,
+            });
+            teardown?.();
+            closed = true;
+            queue.length = 0;
+            if (!res.writableEnded) {
+                res.end();
+            }
+        };
+        const enqueue = (payload) => {
+            if (closed || res.writableEnded) {
+                return;
+            }
+            queue.push(payload);
+            if (queue.length > MAX_SSE_QUEUE_FRAMES) {
+                closeSlowClient();
+                return;
+            }
+            flush();
+        };
+        const write = (frame) => {
+            const payload = serializeFrame(frame, options.logger);
+            if (payload !== undefined) {
+                enqueue(payload);
+            }
+        };
+        // Replay the ring buffer (oldest-first) so a late joiner can reconstruct
+        // in-flight runs, then stream every subsequent frame the same way.
+        for (const frame of options.bus.recentFrames()) {
+            write(frame);
+        }
+        if (closed) {
+            return;
+        }
+        const unsubscribe = options.bus.subscribe(write);
+        const heartbeat = setInterval(() => {
+            if (closed || draining || res.writableEnded) {
+                return;
+            }
+            enqueue(": ping\n\n");
+        }, LIVE_HEARTBEAT_INTERVAL_MS);
+        // Never keep the process alive solely for the heartbeat timer.
+        heartbeat.unref?.();
+        let torn = false;
+        teardown = () => {
+            if (torn) {
+                return;
+            }
+            torn = true;
+            closed = true;
+            clearInterval(heartbeat);
+            unsubscribe();
+            queue.length = 0;
+        };
+        const connection = { res, teardown };
+        connections.add(connection);
+        res.once("close", () => {
+            connections.delete(connection);
+            teardown();
+        });
+    }
+    return {
+        baseUrl,
+        async stop() {
+            // SSE connections never end on their own, so `server.close()` would hang
+            // waiting for them — tear each down and end the response first.
+            for (const connection of [...connections]) {
+                connection.teardown();
+                if (!connection.res.writableEnded) {
+                    connection.res.end();
+                }
+            }
+            connections.clear();
+            await close(server);
+        },
+    };
+}
+function authorize(req, res, apiKey) {
+    if (apiKey === undefined) {
+        return true;
+    }
+    const presented = readAuthorizationBearer(req.header("authorization"));
+    if (presented !== undefined && bearerTokensEqual(presented, apiKey)) {
+        return true;
+    }
+    res.status(401).json({ error: { message: "Invalid API key.", code: "invalid_api_key" } });
+    return false;
+}
+function errorToMessage(error) {
+    if (error instanceof Error && error.message.length > 0) {
+        return error.message;
+    }
+    return String(error);
+}
+function normalizeBasePath(basePath) {
+    if (!isLiteralBasePath(basePath)) {
+        throw new LiveAdapterError("invalid_config", "basePath must be an absolute literal path made of slash-separated URL path segments.");
+    }
+    return basePath.length === 1 ? "" : basePath.replace(/\/+$/u, "");
+}
+function serializeFrame(frame, logger) {
+    try {
+        // JSON.stringify is single-line, so the only newlines are the SSE terminator.
+        const json = JSON.stringify(frame);
+        if (FRAME_ENCODER.encode(json).length > DEFAULT_RUN_EVENT_MAX_FRAME_BYTES) {
+            logger?.warn?.("Dropped oversized live event frame.", {
+                maxFrameBytes: DEFAULT_RUN_EVENT_MAX_FRAME_BYTES,
+                runId: "runId" in frame ? frame.runId : undefined,
+            });
+            return undefined;
+        }
+        return `data: ${json}\n\n`;
+    }
+    catch (error) {
+        logger?.warn?.("Dropped unserializable live event frame.", {
+            reason: error instanceof Error ? error.message : String(error),
+            runId: "runId" in frame ? frame.runId : undefined,
+        });
+        return undefined;
+    }
+}
+function isLiteralBasePath(basePath) {
+    return basePath === "/" || /^\/[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*\/?$/u.test(basePath);
+}
+//# sourceMappingURL=server.js.map

package/dist/live/server.js.map

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