@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/platform/runtime/telemetry/exporters/local-ledger.js

@@ -2,8 +2,8 @@
  * LocalLedgerExporter — append-only JSON lines span exporter.
  *
  * Writes completed spans to a rotating JSON Lines (.jsonl) file.
- * Writes are fire-and-forget (non-blocking). Export failures are
- * logged but never thrown — they must not block the runtime.
+ * Export failures are isolated from the runtime and reported through
+ * structured logger entries.
  *
  * Also provides typed event ledger recording for deterministic replay.
  * Call `recordEvent()` to append a `LedgerEntry` to the ledger file.
@@ -34,42 +34,60 @@ export class LocalLedgerExporter {
         this.ledgerFilePath = config.ledgerFilePath ?? `${config.filePath}.ledger.jsonl`;
     }
     /**
-     * Export a batch of spans as JSON lines (fire-and-forget).
+     * Export a batch of spans as JSON lines.
      *
-     * Intentionally not awaited by the tracer — failures are swallowed here
-     * and logged to avoid any runtime impact.
+     * Failures are logged and isolated from callers so exporter I/O cannot break
+     * runtime work.
      */
     async export(spans) {
         if (spans.length === 0)
             return;
-        // Build the JSON lines payload synchronously (cheap, in-memory).
-        const lines = spans
-            .map((span) => {
+        const lines = [];
+        let droppedSpans = 0;
+        for (const span of spans) {
             try {
-                return JSON.stringify(span);
+                lines.push(JSON.stringify(span));
             }
-            catch {
-                return null;
+            catch (err) {
+                droppedSpans++;
+                logger.warn('[local-ledger] span serialization failed', {
+                    error: summarizeError(err),
+                    spanName: span.name,
+                    traceId: span.spanContext.traceId,
+                    spanId: span.spanContext.spanId,
+                });
             }
-        })
-            .filter((line) => line !== null)
-            .join('\n') + '\n';
+        }
+        if (lines.length === 0) {
+            logger.warn('[local-ledger] export produced no serializable spans', {
+                spanCount: spans.length,
+                droppedSpans,
+            });
+            return;
+        }
+        const payload = `${lines.join('\n')}\n`;
         // All I/O in a microtask to keep the call non-blocking.
         await Promise.resolve().then(() => {
             try {
                 this._rotateIfNeeded();
-                appendFileSync(this.filePath, lines, 'utf8');
+                appendFileSync(this.filePath, payload, 'utf8');
             }
             catch (err) {
-                logger.debug(`[local-ledger] export failed: ${summarizeError(err)}`);
+                logger.warn('[local-ledger] export failed', {
+                    error: summarizeError(err),
+                    filePath: this.filePath,
+                    spanCount: spans.length,
+                    writtenSpans: lines.length,
+                    droppedSpans,
+                });
             }
         });
     }
     /**
-     * Record a typed event entry to the ledger file (fire-and-forget).
+     * Record a typed event entry to the ledger file.
      *
      * Used by the deterministic replay engine to build a per-run event log.
-     * Failures are logged but never thrown.
+     * Failures are logged and isolated from callers.
      *
      * @param entry - The ledger entry to append.
      *
@@ -86,8 +104,13 @@ export class LocalLedgerExporter {
             appendFileSync(this.ledgerFilePath, line, 'utf8');
         }
         catch (err) {
-            // Non-fatal — ledger recording must not block the runtime.
-            logger.debug(`[local-ledger] ledger write failed: ${summarizeError(err)}`);
+            logger.warn('[local-ledger] ledger write failed', {
+                error: summarizeError(err),
+                ledgerFilePath: this.ledgerFilePath,
+                runId: entry.runId,
+                rev: entry.rev,
+                eventName: entry.eventName,
+            });
         }
     }
     /**
@@ -108,7 +131,11 @@ export class LocalLedgerExporter {
             raw = readFileSync(this.ledgerFilePath, 'utf8');
         }
         catch (err) {
-            logger.debug(`[local-ledger] ledger read failed: ${summarizeError(err)}`);
+            logger.warn('[local-ledger] ledger read failed', {
+                error: summarizeError(err),
+                ledgerFilePath: this.ledgerFilePath,
+                runId,
+            });
             return [];
         }
         for (const line of raw.split('\n')) {
@@ -138,7 +165,10 @@ export class LocalLedgerExporter {
             raw = readFileSync(this.ledgerFilePath, 'utf8');
         }
         catch (err) {
-            logger.debug(`[local-ledger] ledger read failed: ${summarizeError(err)}`);
+            logger.warn('[local-ledger] ledger read failed', {
+                error: summarizeError(err),
+                ledgerFilePath: this.ledgerFilePath,
+            });
             return [];
         }
         const seen = new Set();
@@ -178,8 +208,17 @@ export class LocalLedgerExporter {
                 logger.debug(`[local-ledger] rotated ${this.filePath}`);
             }
         }
-        catch {
-            // File may not exist yet — first write will create it via appendFileSync.
+        catch (err) {
+            if (isNodeErrorCode(err, 'ENOENT')) {
+                return;
+            }
+            logger.warn('[local-ledger] rotation check failed', {
+                error: summarizeError(err),
+                filePath: this.filePath,
+            });
         }
     }
 }
+function isNodeErrorCode(error, code) {
+    return typeof error === 'object' && error !== null && 'code' in error && error.code === code;
+}

package/dist/platform/runtime/telemetry/exporters/otlp.d.ts

@@ -49,13 +49,13 @@ export declare class OtlpExporter implements SpanExporter {
     flush(): Promise<void>;
     /**
      * Flush remaining spans and shut down the export queue.
-     * Best-effort — waits up to drainTimeoutMs.
+     * Waits up to drainTimeoutMs for pending queue entries to clear.
      * Never throws.
      */
     shutdown(): Promise<void>;
     /**
      * Performs the actual HTTP POST to the OTLP endpoint.
-     * Called exclusively by the ExportQueue — must not throw.
+     * Called exclusively by the ExportQueue, which records failures and retries.
      */
     private _httpExport;
     /**

package/dist/platform/runtime/telemetry/exporters/otlp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/exporters/otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAoF3D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,MAAM,EAAE,UAAU;IAyB9B;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B;;;OAGG;YACW,WAAW;IA8BzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB"}
+{"version":3,"file":"otlp.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/exporters/otlp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,YAAY,CAAC;AAqF3D;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,YAAW,YAAY;IAC/C,QAAQ,CAAC,IAAI,UAAU;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;gBAEnC,MAAM,EAAE,UAAU;IAyB9B;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAe/B;;;OAGG;YACW,WAAW;IA8BzB;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB"}

package/dist/platform/runtime/telemetry/exporters/otlp.js

@@ -2,6 +2,7 @@ import { DEFAULT_OTLP_CONFIG, DEFAULT_QUEUE_CONFIG } from './types.js';
 import { ExportQueue } from './queue.js';
 import { logger } from '../../../utils/logger.js';
 import { instrumentedFetch } from '../../../utils/fetch-with-timeout.js';
+import { summarizeError } from '../../../utils/error-display.js';
 /**
  * Serialises a ReadableSpan[] into OTLP/HTTP JSON format (simplified).
  *
@@ -20,7 +21,7 @@ function serialiseSpans(spans) {
             },
             scopeSpans: [
                 {
-                    scope: { name: spans[0].instrumentationScope ?? 'goodvibes-sdk' },
+                    scope: { name: spans[0]?.instrumentationScope ?? 'goodvibes-sdk' },
                     spans: spans.map((s) => ({
                         traceId: s.spanContext.traceId,
                         spanId: s.spanContext.spanId,
@@ -139,8 +140,8 @@ export class OtlpExporter {
             }
         }
         catch (err) {
-            // OBS-07: use structured logger, not console
-            logger.error('[OtlpExporter] export() error (non-fatal)', { error: err instanceof Error ? err.message : String(err) });
+            // use structured logger, not console
+            logger.error('[OtlpExporter] export() failed', { error: summarizeError(err) });
         }
     }
     /**
@@ -156,13 +157,13 @@ export class OtlpExporter {
             await this._queue.drain();
         }
         catch (err) {
-            // OBS-07: use structured logger, not console
-            logger.error('[OtlpExporter] flush() error (non-fatal)', { error: err instanceof Error ? err.message : String(err) });
+            // use structured logger, not console
+            logger.error('[OtlpExporter] flush() failed', { error: summarizeError(err) });
         }
     }
     /**
      * Flush remaining spans and shut down the export queue.
-     * Best-effort — waits up to drainTimeoutMs.
+     * Waits up to drainTimeoutMs for pending queue entries to clear.
      * Never throws.
      */
     async shutdown() {
@@ -174,14 +175,14 @@ export class OtlpExporter {
             await this._queue.shutdown();
         }
         catch (err) {
-            // OBS-07: use structured logger, not console
-            logger.error('[OtlpExporter] shutdown() error (non-fatal)', { error: err instanceof Error ? err.message : String(err) });
+            // use structured logger, not console
+            logger.error('[OtlpExporter] shutdown() failed', { error: summarizeError(err) });
         }
     }
     // ── Private HTTP transport ────────────────────────────────────────────────
     /**
      * Performs the actual HTTP POST to the OTLP endpoint.
-     * Called exclusively by the ExportQueue — must not throw.
+     * Called exclusively by the ExportQueue, which records failures and retries.
      */
     async _httpExport(batch) {
         const controller = new AbortController();
@@ -211,7 +212,7 @@ export class OtlpExporter {
      */
     _onExportResult(result) {
         if (result.code === 'failure') {
-            // OBS-07: use structured logger so OTLP exporter failures appear in activity log
+            // use structured logger so OTLP exporter failures appear in activity log
             logger.error('[OtlpExporter] Export failed permanently — spans lost', {
                 spanCount: result.spanCount,
                 attempts: result.attempts,
@@ -219,7 +220,7 @@ export class OtlpExporter {
             });
         }
         else if (result.code === 'dropped') {
-            // OBS-07: use structured logger
+            // use structured logger
             logger.warn('[OtlpExporter] Dropped spans due to queue overflow', {
                 spanCount: result.spanCount,
             });

package/dist/platform/runtime/telemetry/exporters/queue.d.ts

@@ -1,12 +1,3 @@
-/**
- * Fail-safe, bounded export queue with exponential-backoff retry.
- *
- * Guarantees:
- * - Never blocks the caller — all export work is dequeued asynchronously.
- * - Never throws — all errors are caught and logged.
- * - Drops oldest entries when full (back-pressure relief).
- * - Drains best-effort on shutdown with a configurable timeout.
- */
 import type { ReadableSpan } from '../types.js';
 import type { ExportQueueConfig, ExportResultCallback, ExportFn } from './types.js';
 /**
@@ -60,8 +51,7 @@ export declare class ExportQueue {
      */
     enqueue(batch: ReadableSpan[]): void;
     /**
-     * Drain all queued batches best-effort, honouring drainTimeoutMs.
-     * Waits until the queue is empty or the timeout elapses.
+     * Wait until no queued entries remain or drainTimeoutMs elapses.
      */
     drain(): Promise<void>;
     /**

package/dist/platform/runtime/telemetry/exporters/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/exporters/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,iBAAiB,EAEjB,oBAAoB,EACpB,QAAQ,EAET,MAAM,YAAY,CAAC;AA+BpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAuB;IAElD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAElB,0CAA0C;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,kEAAkE;IAClE,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;OAIG;gBAED,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAChC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,QAAQ,CAAC,EAAE,oBAAoB;IAYjC,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI;IA4BpC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,0DAA0D;IAC1D,OAAO,CAAC,eAAe;IAWvB,4DAA4D;YAC9C,UAAU;IAgBxB,oEAAoE;IACpE,OAAO,CAAC,QAAQ;IAShB;;;OAGG;YACW,aAAa;IA0C3B,2DAA2D;IAC3D,OAAO,CAAC,WAAW;CAUpB"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/exporters/queue.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,iBAAiB,EAEjB,oBAAoB,EACpB,QAAQ,EAET,MAAM,YAAY,CAAC;AAgCpB;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAmC;IAE9D,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAK;IAElB,0CAA0C;IAC1C,OAAO,CAAC,SAAS,CAAS;IAC1B,kEAAkE;IAClE,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;OAIG;gBAED,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAChC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,QAAQ,CAAC,EAAE,oBAAoB;IAYjC,gDAAgD;IAChD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+CAA+C;IAC/C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI;IA4BpC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,0DAA0D;IAC1D,OAAO,CAAC,eAAe;IAWvB,4DAA4D;YAC9C,UAAU;IAgBxB,oEAAoE;IACpE,OAAO,CAAC,QAAQ;IAShB;;;OAGG;YACW,aAAa;IA0C3B,2DAA2D;IAC3D,OAAO,CAAC,WAAW;CAUpB"}

package/dist/platform/runtime/telemetry/exporters/queue.js

@@ -1,3 +1,13 @@
+/**
+ * Fail-safe, bounded export queue with exponential-backoff retry.
+ *
+ * Guarantees:
+ * - Never blocks the caller — all export work is dequeued asynchronously.
+ * - Never throws — all errors are caught and logged.
+ * - Drops oldest entries when full (back-pressure relief).
+ * - Shutdown drain waits up to the configured timeout before returning.
+ */
+import { randomInt } from 'node:crypto';
 import { DEFAULT_QUEUE_CONFIG } from './types.js';
 import { summarizeError } from '../../../utils/error-display.js';
 import { logger } from '../../../utils/logger.js';
@@ -9,7 +19,8 @@ function computeDelay(attempt, config) {
     const base = config.baseDelayMs * Math.pow(config.backoffFactor, attempt);
     const capped = Math.min(base, config.maxDelayMs);
     // Add ±10% jitter to avoid thundering-herd
-    const jitter = capped * 0.1 * (Math.random() * 2 - 1);
+    const jitterWindow = Math.max(1, Math.floor(capped * 0.1));
+    const jitter = randomInt(-jitterWindow, jitterWindow + 1);
     return Math.max(0, Math.round(capped + jitter));
 }
 /** Awaitable sleep. */
@@ -99,7 +110,7 @@ export class ExportQueue {
                     completedAt: Date.now(),
                 });
             }
-            // OBS-07: structured logger, not console
+            // structured logger, not console
             logger.warn('[ExportQueue] Queue overflow — dropped oldest batch', { maxSize: this._config.maxSize });
         }
         this._ring[this._tail] = { batch, enqueuedAt: Date.now() };
@@ -108,8 +119,7 @@ export class ExportQueue {
         this._startDrainLoop();
     }
     /**
-     * Drain all queued batches best-effort, honouring drainTimeoutMs.
-     * Waits until the queue is empty or the timeout elapses.
+     * Wait until no queued entries remain or drainTimeoutMs elapses.
      */
     async drain() {
         if (this._size === 0)
@@ -118,6 +128,12 @@ export class ExportQueue {
         while (this._size > 0 && Date.now() < deadline) {
             await sleep(10);
         }
+        if (this._size > 0) {
+            logger.warn('[ExportQueue] Drain timed out with queued batches remaining', {
+                remainingBatches: this._size,
+                drainTimeoutMs: this._config.drainTimeoutMs,
+            });
+        }
     }
     /**
      * Stop accepting new entries and drain remaining batches.
@@ -192,13 +208,13 @@ export class ExportQueue {
                 lastError = summarizeError(err);
                 if (attempt < maxRetries) {
                     const delay = computeDelay(attempt, this._config.retry);
-                    // OBS-07: structured logger, not console
+                    // structured logger, not console
                     logger.warn('[ExportQueue] Export attempt failed — retrying', { attempt: attempt + 1, delayMs: delay, error: lastError });
                     await sleep(delay);
                 }
             }
         }
-        // All retries exhausted — OBS-07: structured logger
+        // All retries exhausted; use structured logging.
         logger.error('[ExportQueue] Export failed after all retries — batch dropped', {
             attempts,
             spanCount: entry.batch.length,

package/dist/platform/runtime/telemetry/exporters/types.d.ts

@@ -46,7 +46,7 @@ export interface ExportResult {
     /** Number of retry attempts made (0 = first attempt succeeded). */
     readonly attempts: number;
     /** Error message if the export failed after all retries. */
-    readonly error?: string;
+    readonly error?: string | undefined;
     /** Epoch ms when the export completed. */
     readonly completedAt: number;
 }
@@ -71,11 +71,11 @@ export interface OtlpConfig {
      * Optional HTTP headers to include in OTLP requests
      * (e.g. authentication tokens).
      */
-    readonly headers?: Record<string, string>;
+    readonly headers?: Record<string, string> | undefined;
     /** Export queue configuration. Defaults to DEFAULT_QUEUE_CONFIG. */
-    readonly queue?: Partial<ExportQueueConfig>;
+    readonly queue?: Partial<ExportQueueConfig> | undefined;
     /** Retry configuration. Overrides queue.retry when provided. */
-    readonly retry?: Partial<RetryConfig>;
+    readonly retry?: Partial<RetryConfig> | undefined;
 }
 /** Default OTLP exporter configuration. */
 export declare const DEFAULT_OTLP_CONFIG: {

package/dist/platform/runtime/telemetry/exporters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/exporters/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;GAKG;AAIH,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,EAAE,WAKzB,CAAC;AAIX,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,iBAIzB,CAAC;AAIX,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5C,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACvC;AAED,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAIX;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExD,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/exporters/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AAErF;;;;;GAKG;AAIH,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,mCAAmC;AACnC,eAAO,MAAM,oBAAoB,EAAE,WAKzB,CAAC;AAIX,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,EAAE,iBAIzB,CAAC;AAIX,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAID,0CAA0C;AAC1C,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACtD,oEAAoE;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;IACxD,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;CACnD;AAED,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAIX;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExD,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC"}

package/dist/platform/runtime/telemetry/index.d.ts

@@ -39,8 +39,8 @@ export { DomainBridge, createInstrumentation } from './instrumentation/index.js'
 /** Alias for TelemetryProviderConfig to match the factory parameter name. */
 export type TelemetryConfig = TelemetryProviderConfig;
 export interface TelemetryProviderOptions {
-    readonly featureFlags?: Pick<FeatureFlagManager, 'isEnabled'> | null;
-    readonly otlp?: OtlpConfig;
+    readonly featureFlags?: Pick<FeatureFlagManager, 'isEnabled'> | null | undefined;
+    readonly otlp?: OtlpConfig | undefined;
 }
 /**
  * Create a telemetry provider — a paired RuntimeTracer and RuntimeMeter.

package/dist/platform/runtime/telemetry/index.d.ts.map

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

package/dist/platform/runtime/telemetry/instrumentation/domain-bridge-agent-session.js

@@ -10,7 +10,7 @@ export function attachAgentDomain({ bus, helpers }, agentSpans) {
                 agentId: env.payload.agentId,
                 taskId: env.payload.taskId,
                 task: env.payload.task,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             agentSpans.set(env.payload.agentId, span);
         });
@@ -82,7 +82,7 @@ export function attachPermissionDomain({ bus, helpers }, permissionSpans) {
                 callId: env.payload.callId,
                 tool: env.payload.tool,
                 category: env.payload.category,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             permissionSpans.set(env.payload.callId, span);
         });
@@ -157,7 +157,7 @@ export function attachSessionDomain({ bus, helpers }, sessionSpans) {
         helpers.safe(() => {
             const span = startSessionSpan(helpers.tracer, {
                 sessionId: env.payload.sessionId,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
                 profileId: env.payload.profileId,
                 workingDir: env.payload.workingDir,
             });
@@ -169,7 +169,7 @@ export function attachSessionDomain({ bus, helpers }, sessionSpans) {
             if (!sessionSpans.has(env.payload.sessionId)) {
                 const span = startSessionSpan(helpers.tracer, {
                     sessionId: env.payload.sessionId,
-                    traceId: env.traceId,
+                    traceId: env.traceId ?? '',
                     path: env.payload.path,
                 });
                 sessionSpans.set(env.payload.sessionId, span);
@@ -235,7 +235,7 @@ export function attachCompactionDomain({ bus, helpers }, compactionSpans) {
                 strategy: 'check',
                 tokenCount: env.payload.tokenCount,
                 threshold: env.payload.threshold,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             compactionSpans.set(env.payload.sessionId, span);
         });
@@ -248,7 +248,7 @@ export function attachCompactionDomain({ bus, helpers }, compactionSpans) {
                 sessionId: env.payload.sessionId,
                 strategy: env.payload.strategy,
                 tokenCount: env.payload.tokensBefore,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             compactionSpans.set(env.payload.sessionId, span);
         });
@@ -262,7 +262,7 @@ export function attachCompactionDomain({ bus, helpers }, compactionSpans) {
                 strategy: 'reactive',
                 tokenCount: env.payload.tokenCount,
                 limit: env.payload.limit,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             compactionSpans.set(env.payload.sessionId, span);
         });

package/dist/platform/runtime/telemetry/instrumentation/domain-bridge-plugin-mcp.js

@@ -8,7 +8,7 @@ export function attachPluginDomain({ bus, helpers }, pluginSpans) {
                 pluginId: env.payload.pluginId,
                 path: env.payload.path,
                 version: env.payload.version,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             pluginSpans.set(env.payload.pluginId, span);
         });
@@ -77,7 +77,7 @@ export function attachMcpDomain({ bus, helpers }, mcpSpans) {
                 serverId: env.payload.serverId,
                 transport: env.payload.transport,
                 url: env.payload.url,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             mcpSpans.set(env.payload.serverId, span);
         });

package/dist/platform/runtime/telemetry/instrumentation/domain-bridge-transport-task.js

@@ -7,7 +7,7 @@ export function attachTransportDomain({ bus, helpers }, transportSpans) {
             const span = startTransportSpan(helpers.tracer, {
                 transportId: env.payload.transportId,
                 protocol: env.payload.protocol,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             transportSpans.set(env.payload.transportId, span);
         });
@@ -82,7 +82,7 @@ export function attachTaskDomain({ bus, helpers }, taskSpans) {
                 agentId: env.payload.agentId,
                 description: env.payload.description,
                 priority: env.payload.priority,
-                traceId: env.traceId,
+                traceId: env.traceId ?? '',
             });
             taskSpans.set(env.payload.taskId, span);
         });

package/dist/platform/runtime/telemetry/meter.d.ts

@@ -46,5 +46,11 @@ export declare class RuntimeMeter {
      * Repeated calls with the same name return the same instrument.
      */
     gauge(name: string): Gauge;
+    /**
+     * Reset all accumulated values on every registered instrument.
+     * Intended for test isolation only — clears counter sums, histogram accumulators,
+     * and gauge values on the singleton meter so tests do not bleed state.
+     */
+    reset(): void;
 }
 //# sourceMappingURL=meter.d.ts.map

package/dist/platform/runtime/telemetry/meter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meter.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/telemetry/meter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,SAAS,EAET,WAAW,EAEZ,MAAM,YAAY,CAAC;AA4FpB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,MAAM,EAAE,WAAW;IAI/B,qDAAqD;IACrD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS9B;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IASlC;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;CAQ3B"}
+{"version":3,"file":"meter.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/telemetry/meter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EACV,OAAO,EACP,KAAK,EACL,SAAS,EAET,WAAW,EAEZ,MAAM,YAAY,CAAC;AA2GpB;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,MAAM,EAAE,WAAW;IAI/B,qDAAqD;IACrD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS9B;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IASlC;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAS1B;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAWd"}

package/dist/platform/runtime/telemetry/meter.js

@@ -25,6 +25,10 @@ class CounterImpl {
     value(labels) {
         return this._values.get(labelKey(labels)) ?? 0;
     }
+    /** reset all accumulated values (for test isolation). */
+    _clear() {
+        this._values.clear();
+    }
 }
 class HistogramImpl {
     _accumulators = new Map();
@@ -57,6 +61,10 @@ class HistogramImpl {
             mean: acc.count > 0 ? acc.sum / acc.count : 0,
         };
     }
+    /** reset all accumulated values (for test isolation). */
+    _clear() {
+        this._accumulators.clear();
+    }
 }
 // ── GaugeImpl ───────────────────────────────────────────────────────────────────
 class GaugeImpl {
@@ -68,6 +76,10 @@ class GaugeImpl {
     value(labels) {
         return this._values.get(labelKey(labels)) ?? 0;
     }
+    /** reset all accumulated values (for test isolation). */
+    _clear() {
+        this._values.clear();
+    }
 }
 // ── RuntimeMeter ────────────────────────────────────────────────────────────
 /**
@@ -133,4 +145,20 @@ export class RuntimeMeter {
         }
         return g;
     }
+    /**
+     * Reset all accumulated values on every registered instrument.
+     * Intended for test isolation only — clears counter sums, histogram accumulators,
+     * and gauge values on the singleton meter so tests do not bleed state.
+     */
+    reset() {
+        for (const c of this._counters.values()) {
+            c._clear();
+        }
+        for (const h of this._histograms.values()) {
+            h._clear();
+        }
+        for (const g of this._gauges.values()) {
+            g._clear();
+        }
+    }
 }

package/dist/platform/runtime/telemetry/redaction-config.js

@@ -1,9 +1,9 @@
 /**
- * OBS-06: Telemetry prompt/response redaction configuration.
+ * Telemetry prompt/response redaction configuration.
  *
  * Privacy model (what actually ships):
  *
- * - Internal RuntimeEventBus carries RAW prompt/response strings. Internal
+ * - RuntimeEventBus carries raw prompt/response strings. In-process
  *   consumers (conversation reducer, channel reply pipeline, stream UI)
  *   require raw content to render and advance state.
  *

package/dist/platform/runtime/telemetry/spans/agent.d.ts

@@ -16,7 +16,7 @@ export interface AgentSpanContext {
     /** Agent ID (unique per spawn). */
     readonly agentId: string;
     /** Task ID this agent is executing (if any). */
-    readonly taskId?: string;
+    readonly taskId?: string | undefined;
     /** Human-readable description of the agent task. */
     readonly task: string;
     /** Trace ID for cross-span correlation. */
@@ -25,7 +25,7 @@ export interface AgentSpanContext {
      * Optional parent span ID for nesting under a turn span.
      * When provided, this agent span becomes a child of the parent.
      */
-    readonly parentSpanId?: string;
+    readonly parentSpanId?: string | undefined;
 }
 /** Phase transitions recordable on an agent lifecycle span. */
 export type AgentPhase = 'running' | 'awaiting_message' | 'awaiting_tool' | 'finalizing';
@@ -36,9 +36,9 @@ export interface AgentSpanEndContext {
     /** Duration of the agent run in milliseconds. */
     readonly durationMs: number;
     /** Error description when outcome is 'failed'. */
-    readonly error?: string;
+    readonly error?: string | undefined;
     /** Cancel reason when outcome is 'cancelled'. */
-    readonly reason?: string;
+    readonly reason?: string | undefined;
 }
 /**
  * Start an agent lifecycle span.

package/dist/platform/runtime/telemetry/spans/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/spans/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,kBAAkB,GAClB,eAAe,GACf,YAAY,CAAC;AAEjB,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACvD,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAgBjF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAuBvE"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../../../src/platform/runtime/telemetry/spans/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,kBAAkB,GAClB,eAAe,GACf,YAAY,CAAC;AAEjB,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACvD,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAgBjF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,cAAc,GACrB,IAAI,CAGN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAuBvE"}