@schlessera/brain-ui-server 0.15.0 → 0.17.0

package/dist/observability/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Observability for the chat-UI server: what it reports, and who receives it.
+ *
+ * The split is deliberate and is the whole design. The PRODUCING side is the
+ * standard OpenTelemetry API — `logger.emit(...)`, `counter.add(...)` — so
+ * instrumentation is portable and a real SDK can take over later without a
+ * single call site changing. The CONSUMING side is ours: a console consumer in
+ * production, a recording consumer in tests, an in-memory meter feeding
+ * `/api/status`. That is what keeps the dependency surface to two packages and
+ * makes "what did the server report?" answerable as data.
+ *
+ * An `Observability` is a value you construct and own, like the app's database
+ * handle or a `ScrapeClient`'s rate limiter — NOT a process-global. The
+ * OpenTelemetry globals are supported (`installGlobally`) for instrumentation
+ * that cannot be reached with an argument, but nothing in this package
+ * requires them, so two differently-configured apps can share a process and a
+ * test never inherits the previous test's sinks.
+ */
+import { type Meter, type MeterProvider } from "@opentelemetry/api";
+import { type Logger, type LoggerProvider } from "@opentelemetry/api-logs";
+import { type LogReader, type RecordingLoggerProvider } from "./loggers.js";
+import { type InMemoryMeterProvider, type MetricsReader } from "./meter.js";
+import type { Severity } from "./types.js";
+export interface ObservabilityOptions {
+    /** Where logs go. Default: the console consumer at `minSeverity`. */
+    loggerProvider?: LoggerProvider;
+    /** Where metrics go. Default: an in-memory recorder (what /api/status reads). */
+    meterProvider?: MeterProvider;
+    /** Threshold for the DEFAULT console consumer; ignored if one is passed in. */
+    minSeverity?: Severity;
+}
+/** What the app holds, and hands to anything that reports. */
+export interface Observability {
+    /** A logger for one instrumentation scope — the `[ws]` / `[auth]` prefix. */
+    logger(scope: string): Logger;
+    /** A meter for one instrumentation scope. */
+    meter(scope: string): Meter;
+    /** Recorded metrics, when the meter provider supports reading. */
+    metrics?: MetricsReader;
+    /** Captured logs, when the logger provider supports reading (tests). */
+    logs?: LogReader;
+    /**
+     * Register these providers as the OpenTelemetry globals, so code that cannot
+     * be handed an argument still reports somewhere. Returns a function that
+     * restores whatever was there before — a test that installs globally must be
+     * able to put the process back.
+     */
+    installGlobally(): () => void;
+}
+export declare function createObservability(options?: ObservabilityOptions): Observability;
+/**
+ * The test flavour: recording consumers on both signals, with the read APIs
+ * guaranteed present so a test does not have to narrow them.
+ *
+ * Same code path as production — only the sink differs — so an assertion here
+ * is an assertion about the real emission, not about a double.
+ */
+export interface RecordingObservability extends Observability {
+    metrics: InMemoryMeterProvider;
+    logs: RecordingLoggerProvider;
+    /** Forget everything captured so far. */
+    reset(): void;
+}
+export declare function createRecordingObservability(): RecordingObservability;
+/** An observability that reports nowhere — for a consumer that wants silence. */
+export declare function createSilentObservability(): Observability;
+export { createConsoleLoggerProvider, createRecordingLoggerProvider, createSilentLoggerProvider, } from "./loggers.js";
+export type { ConsoleLoggerProviderOptions, RecordingLoggerProviderOptions, RecordingLoggerProvider, LogReader, LogWriter, } from "./loggers.js";
+export { createInMemoryMeterProvider } from "./meter.js";
+export type { InMemoryMeterProvider, MetricsReader } from "./meter.js";
+export { SEVERITIES, severityRank, seriesKey } from "./types.js";
+export type { Severity, CapturedLog, LogQuery, MetricPoint, MetricSnapshot, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAW,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAQ,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAA+B,KAAK,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AACzG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iFAAiF;IACjF,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,QAAQ,CAAC;CACxB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,kEAAkE;IAClE,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,wEAAwE;IACxE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;OAKG;IACH,eAAe,IAAI,MAAM,IAAI,CAAC;CAC/B;AAUD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAsBrF;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D,OAAO,EAAE,qBAAqB,CAAC;IAC/B,IAAI,EAAE,uBAAuB,CAAC;IAC9B,yCAAyC;IACzC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAarE;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,IAAI,aAAa,CAKzD;AAED,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,SAAS,EACT,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACV,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,74 @@
+/**
+ * Observability for the chat-UI server: what it reports, and who receives it.
+ *
+ * The split is deliberate and is the whole design. The PRODUCING side is the
+ * standard OpenTelemetry API — `logger.emit(...)`, `counter.add(...)` — so
+ * instrumentation is portable and a real SDK can take over later without a
+ * single call site changing. The CONSUMING side is ours: a console consumer in
+ * production, a recording consumer in tests, an in-memory meter feeding
+ * `/api/status`. That is what keeps the dependency surface to two packages and
+ * makes "what did the server report?" answerable as data.
+ *
+ * An `Observability` is a value you construct and own, like the app's database
+ * handle or a `ScrapeClient`'s rate limiter — NOT a process-global. The
+ * OpenTelemetry globals are supported (`installGlobally`) for instrumentation
+ * that cannot be reached with an argument, but nothing in this package
+ * requires them, so two differently-configured apps can share a process and a
+ * test never inherits the previous test's sinks.
+ */
+import { metrics } from "@opentelemetry/api";
+import { logs } from "@opentelemetry/api-logs";
+import { createConsoleLoggerProvider, createRecordingLoggerProvider, createSilentLoggerProvider, } from "./loggers.js";
+import { createInMemoryMeterProvider } from "./meter.js";
+function hasMetricsReader(p) {
+    return typeof p.snapshot === "function";
+}
+function hasLogReader(p) {
+    return typeof p.records === "function";
+}
+export function createObservability(options = {}) {
+    const loggerProvider = options.loggerProvider ?? createConsoleLoggerProvider({ minSeverity: options.minSeverity });
+    const meterProvider = options.meterProvider ?? createInMemoryMeterProvider();
+    return {
+        logger: (scope) => loggerProvider.getLogger(scope),
+        meter: (scope) => meterProvider.getMeter(scope),
+        metrics: hasMetricsReader(meterProvider) ? meterProvider : undefined,
+        logs: hasLogReader(loggerProvider) ? loggerProvider : undefined,
+        installGlobally() {
+            // The API exposes no "read the current provider object" that round-trips
+            // through disable(), so restoration is a disable rather than a swap-back.
+            // Good enough for the one case that needs it — a test cleaning up.
+            logs.setGlobalLoggerProvider(loggerProvider);
+            metrics.setGlobalMeterProvider(meterProvider);
+            return () => {
+                logs.disable();
+                metrics.disable();
+            };
+        },
+    };
+}
+export function createRecordingObservability() {
+    const loggerProvider = createRecordingLoggerProvider();
+    const meterProvider = createInMemoryMeterProvider();
+    const base = createObservability({ loggerProvider, meterProvider });
+    return {
+        ...base,
+        metrics: meterProvider,
+        logs: loggerProvider,
+        reset() {
+            loggerProvider.clear();
+            meterProvider.reset();
+        },
+    };
+}
+/** An observability that reports nowhere — for a consumer that wants silence. */
+export function createSilentObservability() {
+    return createObservability({
+        loggerProvider: createSilentLoggerProvider(),
+        meterProvider: createInMemoryMeterProvider(),
+    });
+}
+export { createConsoleLoggerProvider, createRecordingLoggerProvider, createSilentLoggerProvider, } from "./loggers.js";
+export { createInMemoryMeterProvider } from "./meter.js";
+export { SEVERITIES, severityRank, seriesKey } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,OAAO,EAAkC,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAoC,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,GAG3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,2BAA2B,EAAkD,MAAM,YAAY,CAAC;AA+BzG,SAAS,gBAAgB,CAAC,CAAgB;IACxC,OAAO,OAAQ,CAA4B,CAAC,QAAQ,KAAK,UAAU,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,CAAiB;IACrC,OAAO,OAAQ,CAAwB,CAAC,OAAO,KAAK,UAAU,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAgC,EAAE;IACpE,MAAM,cAAc,GAClB,OAAO,CAAC,cAAc,IAAI,2BAA2B,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9F,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,2BAA2B,EAAE,CAAC;IAE7E,OAAO;QACL,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC;QAClD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC/C,OAAO,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACpE,IAAI,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;QAC/D,eAAe;YACb,yEAAyE;YACzE,0EAA0E;YAC1E,mEAAmE;YACnE,IAAI,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAC;YAC7C,OAAO,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;YAC9C,OAAO,GAAG,EAAE;gBACV,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAgBD,MAAM,UAAU,4BAA4B;IAC1C,MAAM,cAAc,GAAG,6BAA6B,EAAE,CAAC;IACvD,MAAM,aAAa,GAAG,2BAA2B,EAAE,CAAC;IACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,CAAC;IACpE,OAAO;QACL,GAAG,IAAI;QACP,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,cAAc;QACpB,KAAK;YACH,cAAc,CAAC,KAAK,EAAE,CAAC;YACvB,aAAa,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,yBAAyB;IACvC,OAAO,mBAAmB,CAAC;QACzB,cAAc,EAAE,0BAA0B,EAAE;QAC5C,aAAa,EAAE,2BAA2B,EAAE;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAQtB,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/observability/loggers.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The two log consumers: one that writes, one that remembers.
+ *
+ * Both implement `LoggerProvider` from `@opentelemetry/api-logs`, so they are
+ * interchangeable at the one call site that installs them, and so a real
+ * OpenTelemetry SDK is a third option that needs no change to any
+ * instrumentation.
+ *
+ * Why `@opentelemetry/api-logs` is pinned to an EXACT version in package.json
+ * rather than caretted: the logs API is still 0.x. That was checked rather
+ * than assumed — the producing surface used here (`getLogger().emit()`) is
+ * unchanged across the 0.57 → 0.221 range, and the global registration
+ * handshake is keyed on a backwards-compatibility constant that has stayed at
+ * 1 throughout, so two copies at different versions still interoperate. The
+ * churn that does exist is in `@opentelemetry/sdk-logs`, whose
+ * `SimpleLogRecordProcessor` changed constructor shape — which is precisely
+ * why the consumers below are ours and that package is not a dependency. If
+ * upstream ever breaks the producing surface, the whole API is ~137 lines and
+ * forking it is the stated fallback.
+ */
+import type { LoggerProvider } from "@opentelemetry/api-logs";
+import { type CapturedLog, type LogQuery, type Severity } from "./types.js";
+/** Where a console consumer sends a formatted line. Injected so tests capture it. */
+export interface LogWriter {
+    (severity: Severity, line: string): void;
+}
+export interface ConsoleLoggerProviderOptions {
+    /** Records below this severity are dropped before formatting. Default INFO. */
+    minSeverity?: Severity;
+    write?: LogWriter;
+}
+/** The production consumer: severity-filtered lines on stdout/stderr. */
+export declare function createConsoleLoggerProvider(options?: ConsoleLoggerProviderOptions): LoggerProvider;
+/** Read side of the recording consumer. */
+export interface LogReader {
+    /** Everything captured, in emit order. */
+    records(): CapturedLog[];
+    /** Records matching every field of the query. */
+    find(query?: LogQuery): CapturedLog[];
+    /** How many records match — the common assertion. */
+    count(query?: LogQuery): number;
+    clear(): void;
+}
+export interface RecordingLoggerProvider extends LoggerProvider, LogReader {
+}
+export interface RecordingLoggerProviderOptions {
+    /**
+     * Cap on retained records. A test asserts on a handful; a long-lived process
+     * that installed this by accident should not grow without bound. Oldest are
+     * dropped first. Default 1000.
+     */
+    limit?: number;
+}
+/**
+ * The consumer a test installs. Because it implements the same interface the
+ * production consumer does, a test asserts against the real emission path —
+ * the instrumentation under test cannot tell the difference.
+ */
+export declare function createRecordingLoggerProvider(options?: RecordingLoggerProviderOptions): RecordingLoggerProvider;
+/** A consumer that discards everything — the default when nothing is installed. */
+export declare function createSilentLoggerProvider(): LoggerProvider;
+//# sourceMappingURL=loggers.d.ts.map

package/dist/observability/loggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggers.d.ts","sourceRoot":"","sources":["../../src/observability/loggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAU,cAAc,EAAa,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAQD,MAAM,WAAW,4BAA4B;IAC3C,+EAA+E;IAC/E,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAwBD,yEAAyE;AACzE,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,4BAAiC,GACzC,cAAc,CAmBhB;AAED,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,OAAO,IAAI,WAAW,EAAE,CAAC;IACzB,iDAAiD;IACjD,IAAI,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,EAAE,CAAC;IACtC,qDAAqD;IACrD,KAAK,CAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAChC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,uBAAwB,SAAQ,cAAc,EAAE,SAAS;CAAG;AAe7E,MAAM,WAAW,8BAA8B;IAC7C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,GAAE,8BAAmC,GAC3C,uBAAuB,CAuBzB;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,IAAI,cAAc,CAW3D"}

package/dist/observability/loggers.js

@@ -0,0 +1,109 @@
+import { bodyToString, flattenAttributes, severityRank, } from "./types.js";
+const defaultWriter = (severity, line) => {
+    if (severity === "ERROR" || severity === "FATAL")
+        console.error(line);
+    else if (severity === "WARN")
+        console.warn(line);
+    else
+        console.log(line);
+};
+/**
+ * Formats to the `[scope] message key=value` shape this repo already logs in,
+ * so adopting structured emission does not churn every existing log line's
+ * appearance at the same time.
+ */
+function formatLine(record) {
+    const attrs = Object.entries(record.attributes)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `${k}=${String(v)}`);
+    return `[${record.scope}] ${record.body}${attrs.length ? ` ${attrs.join(" ")}` : ""}`;
+}
+function toCaptured(scope, record) {
+    return {
+        scope,
+        severity: (record.severityText ?? "INFO"),
+        body: bodyToString(record.body),
+        attributes: flattenAttributes(record.attributes),
+        timestamp: Date.now(),
+    };
+}
+/** The production consumer: severity-filtered lines on stdout/stderr. */
+export function createConsoleLoggerProvider(options = {}) {
+    const threshold = severityRank(options.minSeverity ?? "INFO");
+    const write = options.write ?? defaultWriter;
+    return {
+        getLogger(name) {
+            return {
+                emit(record) {
+                    if (severityRank(record.severityText) < threshold)
+                        return;
+                    const captured = toCaptured(name, record);
+                    write(captured.severity, formatLine(captured));
+                },
+                enabled(opts) {
+                    void opts;
+                    return true;
+                },
+            };
+        },
+    };
+}
+function matches(record, query) {
+    if (query.scope !== undefined && record.scope !== query.scope)
+        return false;
+    if (query.severity !== undefined && record.severity !== query.severity)
+        return false;
+    if (query.minSeverity !== undefined && severityRank(record.severity) < severityRank(query.minSeverity)) {
+        return false;
+    }
+    if (query.body !== undefined && !record.body.includes(query.body))
+        return false;
+    for (const [key, value] of Object.entries(query.attributes ?? {})) {
+        if (record.attributes[key] !== value)
+            return false;
+    }
+    return true;
+}
+/**
+ * The consumer a test installs. Because it implements the same interface the
+ * production consumer does, a test asserts against the real emission path —
+ * the instrumentation under test cannot tell the difference.
+ */
+export function createRecordingLoggerProvider(options = {}) {
+    const limit = options.limit ?? 1000;
+    const captured = [];
+    return {
+        getLogger(name) {
+            return {
+                emit(record) {
+                    captured.push(toCaptured(name, record));
+                    if (captured.length > limit)
+                        captured.splice(0, captured.length - limit);
+                },
+                enabled() {
+                    return true;
+                },
+            };
+        },
+        records: () => [...captured],
+        find: (query = {}) => captured.filter((r) => matches(r, query)),
+        count: (query = {}) => captured.reduce((n, r) => n + (matches(r, query) ? 1 : 0), 0),
+        clear: () => {
+            captured.length = 0;
+        },
+    };
+}
+/** A consumer that discards everything — the default when nothing is installed. */
+export function createSilentLoggerProvider() {
+    return {
+        getLogger() {
+            return {
+                emit() { },
+                enabled() {
+                    return false;
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=loggers.js.map

package/dist/observability/loggers.js.map

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

package/dist/observability/meter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * An in-process `MeterProvider` — the counters behind `/api/status`, and the
+ * assertion surface for tests.
+ *
+ * One implementation serves both on purpose. A test double that is a different
+ * implementation from the production one only proves the double works; this
+ * way, the thing a test asserts against is the thing that actually counts in
+ * production.
+ *
+ * It is NOT `@opentelemetry/sdk-metrics`. The producing side is the standard
+ * API, so instrumentation is portable and a real SDK can replace this without
+ * touching a single `counter.add()` call — but the consuming side is ours,
+ * which is what keeps the dependency surface to one stable package.
+ *
+ * Synchronous instruments (counter, up-down counter, histogram, gauge) record.
+ * The observable/async instruments satisfy the interface and do nothing: they
+ * require a collection cycle to be meaningful, and nothing here runs one. A
+ * caller reaching for one is a signal to bring in a real SDK, not to grow this.
+ */
+import type { Attributes, MeterProvider } from "@opentelemetry/api";
+import { type MetricSnapshot } from "./types.js";
+/** Read side of the recorded metrics. */
+export interface MetricsReader {
+    /** Every recorded series, sorted by name then attribute key. */
+    snapshot(): MetricSnapshot;
+    /** One series' value, or undefined when nothing recorded it. */
+    value(name: string, attributes?: Attributes): number | undefined;
+    /** Summed across every attribute combination of an instrument. */
+    total(name: string): number;
+    reset(): void;
+}
+export interface InMemoryMeterProvider extends MeterProvider, MetricsReader {
+}
+/**
+ * A provider whose meters all write into one recorder, so a snapshot spans
+ * every instrumentation scope in the process.
+ */
+export declare function createInMemoryMeterProvider(): InMemoryMeterProvider;
+//# sourceMappingURL=meter.d.ts.map

package/dist/observability/meter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meter.d.ts","sourceRoot":"","sources":["../../src/observability/meter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EACV,UAAU,EAOV,aAAa,EAOd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,QAAQ,IAAI,cAAc,CAAC;IAC3B,gEAAgE;IAChE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IACjE,kEAAkE;IAClE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAuHD,MAAM,WAAW,qBAAsB,SAAQ,aAAa,EAAE,aAAa;CAAG;AAE9E;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAYnE"}

package/dist/observability/meter.js

@@ -0,0 +1,95 @@
+import { flattenAttributes, seriesKey, } from "./types.js";
+class Recorder {
+    series = new Map();
+    record(name, kind, value, attributes) {
+        const key = seriesKey(name, attributes);
+        const existing = this.series.get(key);
+        if (existing) {
+            // A gauge is a level, not an accumulation.
+            existing.value = kind === "gauge" ? value : existing.value + value;
+            return;
+        }
+        this.series.set(key, { key, name, kind, value, attributes: flattenAttributes(attributes) });
+    }
+    snapshot() {
+        return [...this.series.values()]
+            .sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0))
+            .map(({ name, attributes, value, kind }) => ({ name, attributes, value, kind }));
+    }
+    value(name, attributes) {
+        return this.series.get(seriesKey(name, attributes))?.value;
+    }
+    total(name) {
+        let sum = 0;
+        for (const s of this.series.values())
+            if (s.name === name)
+                sum += s.value;
+        return sum;
+    }
+    reset() {
+        this.series.clear();
+    }
+}
+/** Instruments that do nothing, for the async half of the Meter interface. */
+function noopObservable() {
+    return {
+        addCallback() { },
+        removeCallback() { },
+    };
+}
+class InMemoryMeter {
+    recorder;
+    constructor(recorder) {
+        this.recorder = recorder;
+    }
+    createCounter(name, _options) {
+        return {
+            add: (value, attributes) => this.recorder.record(name, "counter", value, attributes),
+        };
+    }
+    createUpDownCounter(name, _options) {
+        return {
+            add: (value, attributes) => this.recorder.record(name, "updowncounter", value, attributes),
+        };
+    }
+    createHistogram(name, _options) {
+        return {
+            // Count of observations, not the distribution: a real SDK owns buckets.
+            record: (_value, attributes) => this.recorder.record(name, "histogram", 1, attributes),
+        };
+    }
+    createGauge(name, _options) {
+        return {
+            record: (value, attributes) => this.recorder.record(name, "gauge", value, attributes),
+        };
+    }
+    createObservableGauge() {
+        return noopObservable();
+    }
+    createObservableCounter() {
+        return noopObservable();
+    }
+    createObservableUpDownCounter() {
+        return noopObservable();
+    }
+    addBatchObservableCallback(_callback, _observables) { }
+    removeBatchObservableCallback(_callback, _observables) { }
+}
+/**
+ * A provider whose meters all write into one recorder, so a snapshot spans
+ * every instrumentation scope in the process.
+ */
+export function createInMemoryMeterProvider() {
+    const recorder = new Recorder();
+    const meter = new InMemoryMeter(recorder);
+    return {
+        getMeter(_name, _version, _options) {
+            return meter;
+        },
+        snapshot: () => recorder.snapshot(),
+        value: (name, attributes) => recorder.value(name, attributes),
+        total: (name) => recorder.total(name),
+        reset: () => recorder.reset(),
+    };
+}
+//# sourceMappingURL=meter.js.map

package/dist/observability/meter.js.map

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

package/dist/observability/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shapes the observability consumers expose for inspection.
+ *
+ * These exist so that "what did the server report?" is answerable as DATA — by
+ * a test, by `/api/status`, by a future exporter — rather than by scraping
+ * stdout. Every consumer in this directory implements a standard OpenTelemetry
+ * provider interface, so swapping one for another is an argument change and
+ * never a change to instrumentation.
+ */
+import type { Attributes } from "@opentelemetry/api";
+import type { LogRecord } from "@opentelemetry/api-logs";
+/**
+ * Attributes as this package retains them.
+ *
+ * Log attributes upstream are `AnyValue` — nested maps, arrays, null. Metric
+ * attributes are narrower. Both are normalized to scalars on capture so one
+ * query shape works over either, `/api/status` stays JSON-safe, and a
+ * formatted line never prints `[object Object]`.
+ */
+export type FlatAttributes = Record<string, string | number | boolean>;
+/** Coerce either attribute flavour to scalars, dropping empty values. */
+export declare function flattenAttributes(attributes: unknown): FlatAttributes;
+/** Severities this codebase uses, ordered. Anything below the configured
+ *  threshold is dropped by the console consumer before it is formatted. */
+export declare const SEVERITIES: readonly ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL"];
+export type Severity = (typeof SEVERITIES)[number];
+export declare function severityRank(severity: string | undefined): number;
+/** One emitted record, with the scope that produced it. */
+export interface CapturedLog {
+    /** Instrumentation scope — the `[ws]` / `[auth]` prefix this repo already uses. */
+    scope: string;
+    severity: Severity;
+    body: string;
+    attributes: FlatAttributes;
+    /** Wall clock at emit, in ms. */
+    timestamp: number;
+}
+/** A query over captured logs. Every field is an AND, every field optional. */
+export interface LogQuery {
+    scope?: string;
+    severity?: Severity;
+    /** Minimum severity, inclusive. */
+    minSeverity?: Severity;
+    /** Substring match against the body. */
+    body?: string;
+    /** Every listed attribute must be present and equal. */
+    attributes?: FlatAttributes;
+}
+/** One counter/histogram series: an instrument plus one attribute combination. */
+export interface MetricPoint {
+    name: string;
+    /** The attribute set that identifies this series. */
+    attributes: FlatAttributes;
+    /** Sum for counters, count of observations for histograms. */
+    value: number;
+    kind: "counter" | "updowncounter" | "histogram" | "gauge";
+}
+/** Serializable metric state, for `/api/status` and for assertions. */
+export type MetricSnapshot = MetricPoint[];
+/**
+ * Stable key for a series. Attributes are sorted, so two calls with the same
+ * attributes in a different literal order land on the same series.
+ */
+export declare function seriesKey(name: string, attributes: Attributes | undefined): string;
+/** Convert a `LogRecord` body — typed as unknown-ish upstream — to a string. */
+export declare function bodyToString(body: LogRecord["body"]): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/observability/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEvE,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,OAAO,GAAG,cAAc,CAYrE;AAED;2EAC2E;AAC3E,eAAO,MAAM,UAAU,+DAAgE,CAAC;AACxF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGjE;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,mFAAmF;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,CAAC;IAC3B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mCAAmC;IACnC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,cAAc,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,eAAe,GAAG,WAAW,GAAG,OAAO,CAAC;CAC3D;AAED,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,WAAW,EAAE,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAMlF;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAI5D"}

package/dist/observability/types.js

@@ -0,0 +1,44 @@
+/** Coerce either attribute flavour to scalars, dropping empty values. */
+export function flattenAttributes(attributes) {
+    const flat = {};
+    if (!attributes || typeof attributes !== "object")
+        return flat;
+    for (const [key, value] of Object.entries(attributes)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            flat[key] = value;
+        }
+        else {
+            flat[key] = JSON.stringify(value);
+        }
+    }
+    return flat;
+}
+/** Severities this codebase uses, ordered. Anything below the configured
+ *  threshold is dropped by the console consumer before it is formatted. */
+export const SEVERITIES = ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL"];
+export function severityRank(severity) {
+    const index = SEVERITIES.indexOf((severity ?? "INFO"));
+    return index === -1 ? SEVERITIES.indexOf("INFO") : index;
+}
+/**
+ * Stable key for a series. Attributes are sorted, so two calls with the same
+ * attributes in a different literal order land on the same series.
+ */
+export function seriesKey(name, attributes) {
+    const entries = Object.entries(attributes ?? {})
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .map(([k, v]) => `${k}=${String(v)}`);
+    return entries.length ? `${name}|${entries.join(",")}` : name;
+}
+/** Convert a `LogRecord` body — typed as unknown-ish upstream — to a string. */
+export function bodyToString(body) {
+    if (typeof body === "string")
+        return body;
+    if (body === undefined || body === null)
+        return "";
+    return typeof body === "object" ? JSON.stringify(body) : String(body);
+}
+//# sourceMappingURL=types.js.map

package/dist/observability/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAsBA,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,UAAmB;IACnD,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAqC,CAAC,EAAE,CAAC;QACjF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACzF,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;2EAC2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAGxF,MAAM,UAAU,YAAY,CAAC,QAA4B;IACvD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,IAAI,MAAM,CAAa,CAAC,CAAC;IACnE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC3D,CAAC;AAsCD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,UAAkC;IACxE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;SAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAChD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,IAAuB;IAClD,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACnD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACxE,CAAC"}

package/dist/routes/brain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/routes/brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAqBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA4Q7D"}
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/routes/brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAqBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAqR7D"}

package/dist/routes/brain.js

@@ -89,6 +89,14 @@ export function createBrainRoutes(deps) {
                     stderr: "pipe",
                     env: subprocessEnv({ NO_COLOR: "1" }),
                 });
+                // Start draining stderr NOW, not after the process exits.
+                //
+                // The stdout loop below can run for minutes. Meanwhile stderr fills an
+                // OS pipe buffer that nothing is reading — and once it is full the
+                // child blocks on write, never exits, and `await proc.exited` never
+                // resolves. A chatty run deadlocked the request; a quiet one looked
+                // fine, which is why this survived.
+                const stderrText = new Response(proc.stderr).text();
                 const reader = proc.stdout.getReader();
                 const decoder = new TextDecoder();
                 let buffer = "";
@@ -110,7 +118,7 @@ export function createBrainRoutes(deps) {
                 }
                 catch { }
                 const exitCode = await proc.exited;
-                const stderr = await new Response(proc.stderr).text();
+                const stderr = await stderrText;
                 if (stderr.trim()) {
                     for (const line of stderr.split("\n")) {
                         if (line.trim())