@pellux/goodvibes-sdk 0.21.30 → 0.21.34

package/dist/_internal/platform/runtime/events/index.js

@@ -7,7 +7,9 @@
  * ```
  */
 import { logger } from '../../utils/logger.js';
+import { createEventEnvelope } from './envelope.js';
 import { summarizeError } from '../../utils/error-display.js';
+import { listenerErrorsTotal } from '../metrics.js';
 export { createEventEnvelope } from './envelope.js';
 export { RUNTIME_EVENT_DOMAINS, isRuntimeEventDomain } from './domain-map.js';
 export { AUTOMATION_SCHEDULE_KINDS, AUTOMATION_RUN_OUTCOMES } from './automation.js';
@@ -23,7 +25,15 @@ export { SURFACE_KINDS } from './surfaces.js';
  * rarely exceeds single-digit listeners. Exceeding this strongly suggests a
  * subscriber is being registered without a corresponding unsubscribe.
  */
-const MAX_LISTENERS = 100;
+export const MAX_LISTENERS = 100;
+/** Extract a plain string error message from an unknown thrown value. */
+function extractErrorMessage(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    return summarizeError(err);
+}
 /**
  * RuntimeEventBus — typed event bus for domain-structured runtime events.
  *
@@ -41,6 +51,15 @@ export class RuntimeEventBus {
     _listeners = new Map();
     /** Per-domain listener sets. Keyed by RuntimeEventDomain. */
     _domainListeners = new Map();
+    /** Effective listener cap for this instance. */
+    _maxListeners;
+    /** Track per-listener error counts for misbehaving-listener dedup. */
+    _listenerErrorCounts = new WeakMap();
+    /** Number of errors a listener must throw before OPS_LISTENER_MISBEHAVING is emitted. */
+    static _MISBEHAVE_DEDUP_THRESHOLD = 1;
+    constructor(opts) {
+        this._maxListeners = opts?.maxListeners ?? MAX_LISTENERS;
+    }
     /**
      * Subscribe to a specific event type.
      *
@@ -54,11 +73,18 @@ export class RuntimeEventBus {
         }
         const set = this._listeners.get(eventType);
         set.add(callback);
-        if (set.size > MAX_LISTENERS) {
+        if (set.size > this._maxListeners) {
+            if (process.env['NODE_ENV'] === 'development') {
+                // Remove the just-added listener before throwing to maintain state consistency.
+                set.delete(callback);
+                if (set.size === 0)
+                    this._listeners.delete(eventType);
+                throw new RangeError(`[RuntimeEventBus] listener cap exceeded — maxListeners=${this._maxListeners} eventType=${String(eventType)}`);
+            }
             logger.warn('[RuntimeEventBus] possible listener leak detected', {
                 eventType,
                 count: set.size,
-                max: MAX_LISTENERS,
+                max: this._maxListeners,
             });
         }
         return () => this._off(eventType, callback);
@@ -76,11 +102,18 @@ export class RuntimeEventBus {
         }
         const set = this._domainListeners.get(domain);
         set.add(callback);
-        if (set.size > MAX_LISTENERS) {
+        if (set.size > this._maxListeners) {
+            if (process.env['NODE_ENV'] === 'development') {
+                // Remove the just-added listener before throwing to maintain state consistency.
+                set.delete(callback);
+                if (set.size === 0)
+                    this._domainListeners.delete(domain);
+                throw new RangeError(`[RuntimeEventBus] domain listener cap exceeded — maxListeners=${this._maxListeners} domain=${String(domain)}`);
+            }
             logger.warn('[RuntimeEventBus] possible domain listener leak detected', {
                 domain,
                 count: set.size,
-                max: MAX_LISTENERS,
+                max: this._maxListeners,
             });
         }
         return () => this._offDomain(domain, callback);
@@ -105,10 +138,7 @@ export class RuntimeEventBus {
                     h(ev);
                 }
                 catch (err) {
-                    logger.error('[RuntimeEventBus] listener error', {
-                        eventType: evType,
-                        error: summarizeError(err),
-                    });
+                    this._recordListenerError(h, evType, err);
                 }
             });
         }
@@ -123,15 +153,79 @@ export class RuntimeEventBus {
                     h(ev);
                 }
                 catch (err) {
-                    logger.error('[RuntimeEventBus] domain listener error', {
-                        domain: d,
-                        eventType: evType,
-                        error: summarizeError(err),
-                    });
+                    this._recordListenerError(h, evType, err, String(d));
                 }
             });
         }
     }
+    /**
+     * Record a listener error: increment metrics, update error count, emit
+     * OPS_LISTENER_MISBEHAVING once the dedup threshold is reached, and log.
+     *
+     * @param listener - The misbehaving listener function.
+     * @param eventType - The event type that triggered the listener.
+     * @param err - The thrown value caught from the listener.
+     * @param domain - Optional domain name, present when the listener was a domain subscriber.
+     */
+    _recordListenerError(listener, eventType, err, domain) {
+        const errMsg = extractErrorMessage(err);
+        listenerErrorsTotal.add(1, { event_type: eventType });
+        const prev = this._listenerErrorCounts.get(listener) ?? 0;
+        const next = prev + 1;
+        this._listenerErrorCounts.set(listener, next);
+        if (next === RuntimeEventBus._MISBEHAVE_DEDUP_THRESHOLD) {
+            this._emitListenerMisbehaving(listener, String(eventType), errMsg, next);
+        }
+        if (domain !== undefined) {
+            logger.error('[RuntimeEventBus] domain listener error', {
+                domain,
+                eventType,
+                error: summarizeError(err),
+            });
+        }
+        else {
+            logger.error('[RuntimeEventBus] listener error', {
+                eventType,
+                error: summarizeError(err),
+            });
+        }
+    }
+    /**
+     * Directly dispatch an OPS_LISTENER_MISBEHAVING envelope to any registered
+     * OPS_LISTENER_MISBEHAVING and 'ops' domain listeners.
+     *
+     * Bypasses emit() to avoid potential recursion: a listener watching for
+     * misbehaving events itself misbehaving would otherwise cause infinite loops.
+     */
+    _emitListenerMisbehaving(listener, eventType, errorMessage, errorCount) {
+        const payload = {
+            type: 'OPS_LISTENER_MISBEHAVING',
+            listenerId: listener.name || '(anonymous)',
+            eventType,
+            errorMessage,
+            errorCount,
+        };
+        const envelope = createEventEnvelope('OPS_LISTENER_MISBEHAVING', payload, { sessionId: 'runtime-bus', source: 'runtime-bus' });
+        // Dispatch directly — no queueMicrotask, no recursion path through emit().
+        const typeListeners = this._listeners.get('OPS_LISTENER_MISBEHAVING');
+        if (typeListeners) {
+            for (const h of Array.from(typeListeners)) {
+                try {
+                    h(envelope);
+                }
+                catch { /* suppress secondary errors */ }
+            }
+        }
+        const domainListeners = this._domainListeners.get('ops');
+        if (domainListeners) {
+            for (const h of Array.from(domainListeners)) {
+                try {
+                    h(envelope);
+                }
+                catch { /* suppress secondary errors */ }
+            }
+        }
+    }
     _off(eventType, callback) {
         const set = this._listeners.get(eventType);
         set?.delete(callback);

package/dist/_internal/platform/runtime/events/ops.d.ts

@@ -76,6 +76,14 @@ export type OpsEvent =
     note?: string;
     outcome: 'success' | 'rejected' | 'error';
     errorMessage?: string;
+}
+/** A subscriber threw an error during event dispatch; emitted after dedup threshold. */
+ | {
+    type: 'OPS_LISTENER_MISBEHAVING';
+    listenerId: string;
+    eventType: string;
+    errorMessage: string;
+    errorCount: number;
 };
 /** All ops event type literals as a union. */
 export type OpsEventType = OpsEvent['type'];

package/dist/_internal/platform/runtime/events/ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/ops.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;GAMG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,WAAW,GACX,kBAAkB,CAAC;AAEvB,MAAM,MAAM,QAAQ;AAClB,iDAAiD;AAC/C;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,8CAA8C;GAC5C;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,mDAAmD;GACjD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,+DAA+D;GAC7D;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,uCAAuC;GACrC;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,mDAAmD;GACjD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,0CAA0C;GACxC;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,kDAAkD;GAChD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/ops.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;;GAMG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,YAAY,GACZ,WAAW,GACX,kBAAkB,CAAC;AAEvB,MAAM,MAAM,QAAQ;AAClB,iDAAiD;AAC/C;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,8CAA8C;GAC5C;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,mDAAmD;GACjD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,+DAA+D;GAC7D;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,uCAAuC;GACrC;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,mDAAmD;GACjD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,0CAA0C;GACxC;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AACH,kDAAkD;GAChD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AACH,wFAAwF;GACtF;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC"}

package/dist/_internal/platform/runtime/events/security.d.ts

@@ -38,6 +38,53 @@ export type SecurityEvent =
     tokenId: string;
     label: string;
     reason: 'scope_violation' | 'rotation_overdue' | 'scope_violation_and_rotation_overdue';
+}
+/** Emitted when a user authenticates successfully. Never includes credentials. */
+ | {
+    type: 'AUTH_SUCCEEDED';
+    /** Authenticated username (display-safe). */
+    username: string;
+    /** Session token ID (not the token value). */
+    sessionId: string;
+    /** Client IP address. */
+    clientIp: string;
+    /** Authentication method used. */
+    method: 'password' | 'cookie' | 'token';
+}
+/** Emitted when an authentication attempt fails. Never includes credential values. */
+ | {
+    type: 'AUTH_FAILED';
+    /** The username that was attempted (may be blank or spoofed). */
+    usernameAttempted: string;
+    /** Client IP address. */
+    clientIp: string;
+    /** Machine-readable failure reason. */
+    reason: 'invalid_credentials' | 'rate_limited' | 'session_expired' | 'origin_denied' | 'unknown';
+}
+/** Emitted when a companion pairing request is initiated. */
+ | {
+    type: 'COMPANION_PAIR_REQUESTED';
+    clientIp: string;
+}
+/** Emitted when a companion pairing is successfully verified. */
+ | {
+    type: 'COMPANION_PAIR_VERIFIED';
+    /** Opaque token ID (not the token value). */
+    tokenId: string;
+    clientIp: string;
+}
+/** Emitted when a companion token is rotated. */
+ | {
+    type: 'COMPANION_TOKEN_ROTATED';
+    /** New opaque token ID (not the token value). */
+    newTokenId: string;
+    clientIp: string;
+}
+/** Emitted when a companion token is revoked. */
+ | {
+    type: 'COMPANION_TOKEN_REVOKED';
+    clientIp: string;
+    reason?: string;
 };
 /** All security event type literals as a union. */
 export type SecurityEventType = SecurityEvent['type'];

package/dist/_internal/platform/runtime/events/security.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/security.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa;AACvB,0EAA0E;AACxE;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AACH,+EAA+E;GAC7E;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AACH,sEAAsE;GACpE;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,+DAA+D;GAC7D;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,sCAAsC,CAAC;CACzF,CAAC;AAEN,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/security.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa;AACvB,0EAA0E;AACxE;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AACH,+EAA+E;GAC7E;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AACH,sEAAsE;GACpE;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AACH,+DAA+D;GAC7D;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,sCAAsC,CAAC;CACzF;AAEH,kFAAkF;GAChF;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;CACzC;AACH,sFAAsF;GACpF;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,MAAM,EAAE,qBAAqB,GAAG,cAAc,GAAG,iBAAiB,GAAG,eAAe,GAAG,SAAS,CAAC;CAClG;AAEH,6DAA6D;GAC3D;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;CAClB;AACH,iEAAiE;GAC/D;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AACH,iDAAiD;GAC/C;IACE,IAAI,EAAE,yBAAyB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/_internal/platform/runtime/events/tools.d.ts

@@ -4,6 +4,18 @@
  *
  * Covers tool execution lifecycle events for the runtime event bus.
  */
+/**
+ * OBS-05: Structured summary of a tool result — avoids leaking raw `unknown` payloads
+ * into the event stream while still providing enough context for observability.
+ */
+export interface ToolResultSummary {
+    /** Discriminant for the result shape (e.g. 'text', 'json', 'error', 'binary'). */
+    kind: string;
+    /** Approximate byte size of the raw result. */
+    byteSize: number;
+    /** Optional short preview (first N chars, no credentials). */
+    preview?: string;
+}
 export type ToolEvent = 
 /** A tool call request was received from the LLM. */
 {
@@ -64,7 +76,7 @@ export type ToolEvent =
     turnId: string;
     tool: string;
     durationMs: number;
-    result?: unknown;
+    result?: ToolResultSummary;
 }
 /** Tool call failed with an error. */
  | {
@@ -74,7 +86,7 @@ export type ToolEvent =
     tool: string;
     error: string;
     durationMs: number;
-    result?: unknown;
+    result?: ToolResultSummary;
 }
 /** Tool results were synthesized to reconcile unresolved calls. */
  | {

package/dist/_internal/platform/runtime/events/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/tools.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/runtime/events/transport.d.ts

@@ -52,6 +52,37 @@ export type TransportEvent =
     type: 'TRANSPORT_TERMINAL_FAILURE';
     transportId: string;
     error: string;
+}
+/** OBS-18: A retry has been scheduled after a transient failure. */
+ | {
+    type: 'TRANSPORT_RETRY_SCHEDULED';
+    transportId: string;
+    attempt: number;
+    maxAttempts: number;
+    backoffMs: number;
+    reason: string;
+}
+/** OBS-18: A scheduled retry is now being executed. */
+ | {
+    type: 'TRANSPORT_RETRY_EXECUTED';
+    transportId: string;
+    attempt: number;
+    maxAttempts: number;
+}
+/** OBS-19: An SSE subscriber connected to the event stream. */
+ | {
+    type: 'STREAM_SUBSCRIBER_CONNECTED';
+    streamId: string;
+    subscriberId: string;
+    streamType: string;
+}
+/** OBS-19: An SSE subscriber disconnected from the event stream. */
+ | {
+    type: 'STREAM_SUBSCRIBER_DISCONNECTED';
+    streamId: string;
+    subscriberId: string;
+    streamType: string;
+    reason?: string;
 };
 /** All transport event type literals as a union. */
 export type TransportEventType = TransportEvent['type'];

package/dist/_internal/platform/runtime/events/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/transport.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;GAIG;AAEH,MAAM,MAAM,cAAc;AACxB,4CAA4C;AAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC3E,4DAA4D;GAC1D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC3D,qDAAqD;GACnD;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACxE,wDAAwD;GACtD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACpD,qEAAqE;GACnE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrE,4DAA4D;GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC/F,4CAA4C;GAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;AAC9F,6DAA6D;GAC3D;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/transport.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;GAIG;AAEH,MAAM,MAAM,cAAc;AACxB,4CAA4C;AAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AAC3E,4DAA4D;GAC1D;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC3D,qDAAqD;GACnD;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACxE,wDAAwD;GACtD;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACpD,qEAAqE;GACnE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrE,4DAA4D;GAC1D;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAC/F,4CAA4C;GAC1C;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE;AAC9F,6DAA6D;GAC3D;IAAE,IAAI,EAAE,4BAA4B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAC5E,oEAAoE;GAClE;IAAE,IAAI,EAAE,2BAA2B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACrI,uDAAuD;GACrD;IAAE,IAAI,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AACjG,+DAA+D;GAC7D;IAAE,IAAI,EAAE,6BAA6B,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACrG,oEAAoE;GAClE;IAAE,IAAI,EAAE,gCAAgC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5H,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/_internal/platform/runtime/events/turn.d.ts

@@ -43,18 +43,42 @@ export type TurnEvent =
     type: 'STREAM_END';
     turnId: string;
 }
+/** OBS-04: An LLM request is about to be dispatched to the provider. */
+ | {
+    type: 'LLM_REQUEST_STARTED';
+    turnId: string;
+    provider: string;
+    model: string;
+    /** Redacted prompt summary: {length, sha256, first100chars} unless telemetry.includeRawPrompts is true. */
+    promptSummary: {
+        length: number;
+        sha256: string;
+        first100chars: string;
+    } | string;
+}
 /** A provider chat call completed within the current turn iteration. */
  | {
     type: 'LLM_RESPONSE_RECEIVED';
     turnId: string;
     provider: string;
     model: string;
-    content: string;
+    /** Redacted response summary: {length, sha256, first100chars} unless telemetry.includeRawPrompts is true. */
+    contentSummary: {
+        length: number;
+        sha256: string;
+        first100chars: string;
+    } | string;
     toolCallCount: number;
     inputTokens: number;
     outputTokens: number;
     cacheReadTokens?: number;
     cacheWriteTokens?: number;
+    /** OBS-04 enrichments */
+    durationMs?: number;
+    retries?: number;
+    costUsdCents?: number;
+    finishReason?: string;
+    providerRequestId?: string;
 }
 /** A batch of tool calls is ready for execution. */
  | {

package/dist/_internal/platform/runtime/events/turn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/turn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"turn.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/turn.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/runtime/events/workspace.d.ts

@@ -51,6 +51,22 @@ export type WorkspaceEvent =
     sourcePath: string;
     /** Human-readable reason (e.g. JSON parse error message). */
     reason: string;
+}
+/**
+ * Emitted when a workspace swap fails (mkdir or rerootStores threw).
+ * Any subscriber that saw WORKSPACE_SWAP_STARTED without a subsequent
+ * WORKSPACE_SWAP_COMPLETED should watch for this event. (OBS-08)
+ */
+ | {
+    type: 'WORKSPACE_SWAP_FAILED';
+    /** Original working directory (swap source). */
+    from: string;
+    /** Target path that was attempted. */
+    to: string;
+    /** Machine-readable failure code. */
+    code: 'INVALID_PATH' | 'REROOT_FAILED' | 'UNKNOWN';
+    /** Human-readable reason. */
+    reason: string;
 };
 export type WorkspaceEventType = WorkspaceEvent['type'];
 //# sourceMappingURL=workspace.d.ts.map

package/dist/_internal/platform/runtime/events/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/workspace.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;GAKG;AAEH,MAAM,MAAM,cAAc;AACxB,4DAA4D;AAC1D;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AACH,iFAAiF;GAC/E;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,yBAAyB,EAAE,OAAO,CAAC;CACpC;AACH,sFAAsF;GACpF;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AACH;;;GAGG;GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;CACZ;AACH;;;GAGG;GACD;IACE,IAAI,EAAE,qCAAqC,CAAC;IAC5C,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/events/workspace.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;GAKG;AAEH,MAAM,MAAM,cAAc;AACxB,4DAA4D;AAC1D;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AACH,iFAAiF;GAC/E;IACE,IAAI,EAAE,0BAA0B,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,yBAAyB,EAAE,OAAO,CAAC;CACpC;AACH,sFAAsF;GACpF;IACE,IAAI,EAAE,wBAAwB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AACH;;;GAGG;GACD;IACE,IAAI,EAAE,6BAA6B,CAAC;IACpC,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;CACZ;AACH;;;GAGG;GACD;IACE,IAAI,EAAE,qCAAqC,CAAC;IAC5C,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;CAChB;AACH;;;;GAIG;GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,IAAI,EAAE,cAAc,GAAG,eAAe,GAAG,SAAS,CAAC;IACnD,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC"}

package/dist/_internal/platform/runtime/llm-observability.d.ts

@@ -0,0 +1,43 @@
+/** Structured prompt summary emitted in telemetry events (default: redacted). */
+export interface PromptSummary {
+    /** Byte length of the raw content. */
+    length: number;
+    /** SHA-256 hex digest of the raw content (for deduplication without exposure). */
+    sha256: string;
+    /** First 100 chars of the raw content (safe preview). */
+    first100chars: string;
+}
+/**
+ * OBS-06: Summarize prompt/response content for telemetry emission.
+ * When includeRawPrompts is true, returns the raw string.
+ * Default (false): returns a PromptSummary with length, sha256, first100chars.
+ */
+export declare function summarizePromptContent(content: string, includeRaw: boolean): PromptSummary | string;
+/**
+ * OBS-04: Result from an instrumented LLM call.
+ * Adds durationMs and retries tracking to the provider response.
+ */
+export interface InstrumentedLlmResult<T> {
+    result: T;
+    durationMs: number;
+    retries: number;
+}
+export declare function instrumentedLlmCall<T>(fn: () => Promise<T>, opts?: {
+    maxRetries?: number;
+    retryDelayMs?: number;
+    /** Provider name for metric labels (e.g. 'anthropic'). */
+    provider?: string;
+    /** Model name for metric labels (e.g. 'claude-opus-4-5'). */
+    model?: string;
+    /** Extract token usage from a successful result to record histogram instruments. */
+    extractTokens?: (result: T) => {
+        inputTokens?: number;
+        outputTokens?: number;
+    } | undefined;
+    /**
+     * M-2: Optional callback invoked on entry before the first attempt.
+     * Callers that have bus/ctx access can wire emitLlmRequestStarted here.
+     */
+    onStarted?: () => void;
+}): Promise<InstrumentedLlmResult<T>>;
+//# sourceMappingURL=llm-observability.d.ts.map

package/dist/_internal/platform/runtime/llm-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-observability.d.ts","sourceRoot":"","sources":["../../../../src/_internal/platform/runtime/llm-observability.ts"],"names":[],"mappings":"AAiBA,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,OAAO,GAClB,aAAa,GAAG,MAAM,CAOxB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC;IACV,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AA+BD,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,CAAC,EAAE;IACL,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,GACA,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAkDnC"}

package/dist/_internal/platform/runtime/llm-observability.js

@@ -0,0 +1,107 @@
+/**
+ * OBS-04/OBS-06: LLM observability utilities.
+ *
+ * Provides:
+ * - Prompt/response content summarization for redaction-by-default telemetry
+ * - instrumentedLlmCall() wrapper that emits LLM_REQUEST_STARTED + enriched LLM_RESPONSE_RECEIVED
+ * - includeRawPrompts config awareness
+ */
+import { createHash } from 'node:crypto';
+import { llmRequestsTotal, llmRequestDurationMs, llmTokensInput, llmTokensOutput, llmRequestsStarted, } from './metrics.js';
+/**
+ * OBS-06: Summarize prompt/response content for telemetry emission.
+ * When includeRawPrompts is true, returns the raw string.
+ * Default (false): returns a PromptSummary with length, sha256, first100chars.
+ */
+export function summarizePromptContent(content, includeRaw) {
+    if (includeRaw)
+        return content;
+    return {
+        length: content.length,
+        sha256: createHash('sha256').update(content).digest('hex'),
+        first100chars: content.slice(0, 100),
+    };
+}
+/**
+ * OBS-04: Wrap any LLM provider call to track duration, retry count, and
+ * record platformMeter instruments (llmRequestsTotal, llmRequestDurationMs,
+ * llmTokensInput, llmTokensOutput).
+ *
+ * Providers wrap their .chat() / .generate() calls with this helper.
+ *
+ * Usage:
+ * ```ts
+ * const { result, durationMs, retries } = await instrumentedLlmCall(
+ *   async () => await this.chat(params),
+ *   { provider: this.name, model: params.model ?? this.defaultModel },
+ * );
+ * ```
+ */
+/**
+ * OBS-04: Emit LLM_REQUEST_STARTED metric at the llm-observability layer.
+ *
+ * Records the llmRequestsStarted counter so callers without bus access still
+ * get per-provider/model observability. Callers that also hold a RuntimeEventBus
+ * should additionally call emitLlmRequestStarted(bus, ctx, data) from emitters/turn.
+ */
+function recordLlmRequestStartedMetric(opts) {
+    const labels = {};
+    if (opts.provider)
+        labels.provider = opts.provider;
+    if (opts.model)
+        labels.model = opts.model;
+    llmRequestsStarted.add(1, labels);
+}
+export async function instrumentedLlmCall(fn, opts) {
+    const maxRetries = opts?.maxRetries ?? 0;
+    const retryDelayMs = opts?.retryDelayMs ?? 0;
+    const startedAt = Date.now();
+    // Auto-emit LLM_REQUEST_STARTED metric on entry (no bus required)
+    recordLlmRequestStartedMetric({ provider: opts?.provider, model: opts?.model });
+    // M-2: fire onStarted callback if provided (e.g. to emit LLM_REQUEST_STARTED on the event bus)
+    opts?.onStarted?.();
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const result = await fn();
+            const durationMs = Date.now() - startedAt;
+            // C-1: record LLM metric instruments
+            if (opts?.provider !== undefined || opts?.model !== undefined) {
+                const labels = {};
+                if (opts.provider)
+                    labels.provider = opts.provider;
+                if (opts.model)
+                    labels.model = opts.model;
+                llmRequestsTotal.add(1, { ...labels, status: 'success' });
+                llmRequestDurationMs.record(durationMs, labels);
+                if (opts.extractTokens) {
+                    const tokens = opts.extractTokens(result);
+                    if (tokens?.inputTokens !== undefined && tokens.inputTokens > 0) {
+                        llmTokensInput.record(tokens.inputTokens, labels);
+                    }
+                    if (tokens?.outputTokens !== undefined && tokens.outputTokens > 0) {
+                        llmTokensOutput.record(tokens.outputTokens, labels);
+                    }
+                }
+            }
+            return { result, durationMs, retries: attempt };
+        }
+        catch (err) {
+            lastError = err;
+            if (attempt < maxRetries && retryDelayMs > 0) {
+                await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
+            }
+        }
+    }
+    // Record error metric on final failure
+    if (opts?.provider !== undefined || opts?.model !== undefined) {
+        const labels = {};
+        if (opts?.provider)
+            labels.provider = opts.provider;
+        if (opts?.model)
+            labels.model = opts.model;
+        llmRequestsTotal.add(1, { ...labels, status: 'error' });
+        llmRequestDurationMs.record(Date.now() - startedAt, labels);
+    }
+    throw lastError;
+}