risicare 0.6.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +26 -0
- package/README.md +308 -61
- package/dist/frameworks/instructor.cjs +790 -5
- package/dist/frameworks/instructor.cjs.map +1 -1
- package/dist/frameworks/instructor.js +780 -5
- package/dist/frameworks/instructor.js.map +1 -1
- package/dist/frameworks/langchain.cjs +790 -5
- package/dist/frameworks/langchain.cjs.map +1 -1
- package/dist/frameworks/langchain.d.cts +3 -2
- package/dist/frameworks/langchain.d.ts +3 -2
- package/dist/frameworks/langchain.js +780 -5
- package/dist/frameworks/langchain.js.map +1 -1
- package/dist/frameworks/langgraph.cjs +790 -5
- package/dist/frameworks/langgraph.cjs.map +1 -1
- package/dist/frameworks/langgraph.js +780 -5
- package/dist/frameworks/langgraph.js.map +1 -1
- package/dist/frameworks/llamaindex.cjs +801 -5
- package/dist/frameworks/llamaindex.cjs.map +1 -1
- package/dist/frameworks/llamaindex.d.cts +3 -2
- package/dist/frameworks/llamaindex.d.ts +3 -2
- package/dist/frameworks/llamaindex.js +791 -5
- package/dist/frameworks/llamaindex.js.map +1 -1
- package/dist/index.cjs +1259 -175
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +245 -39
- package/dist/index.d.ts +245 -39
- package/dist/index.js +1259 -175
- package/dist/index.js.map +1 -1
- package/dist/providers/anthropic/index.cjs +1601 -36
- package/dist/providers/anthropic/index.cjs.map +1 -1
- package/dist/providers/anthropic/index.d.cts +3 -1
- package/dist/providers/anthropic/index.d.ts +3 -1
- package/dist/providers/anthropic/index.js +1591 -36
- package/dist/providers/anthropic/index.js.map +1 -1
- package/dist/providers/bedrock/index.cjs +850 -32
- package/dist/providers/bedrock/index.cjs.map +1 -1
- package/dist/providers/bedrock/index.js +840 -32
- package/dist/providers/bedrock/index.js.map +1 -1
- package/dist/providers/cerebras/index.cjs +1534 -30
- package/dist/providers/cerebras/index.cjs.map +1 -1
- package/dist/providers/cerebras/index.js +1524 -30
- package/dist/providers/cerebras/index.js.map +1 -1
- package/dist/providers/cohere/index.cjs +1557 -102
- package/dist/providers/cohere/index.cjs.map +1 -1
- package/dist/providers/cohere/index.js +1547 -102
- package/dist/providers/cohere/index.js.map +1 -1
- package/dist/providers/google/index.cjs +1562 -60
- package/dist/providers/google/index.cjs.map +1 -1
- package/dist/providers/google/index.js +1552 -60
- package/dist/providers/google/index.js.map +1 -1
- package/dist/providers/groq/index.cjs +1534 -30
- package/dist/providers/groq/index.cjs.map +1 -1
- package/dist/providers/groq/index.js +1524 -30
- package/dist/providers/groq/index.js.map +1 -1
- package/dist/providers/huggingface/index.cjs +1622 -25
- package/dist/providers/huggingface/index.cjs.map +1 -1
- package/dist/providers/huggingface/index.d.cts +0 -9
- package/dist/providers/huggingface/index.d.ts +0 -9
- package/dist/providers/huggingface/index.js +1612 -25
- package/dist/providers/huggingface/index.js.map +1 -1
- package/dist/providers/mistral/index.cjs +1535 -54
- package/dist/providers/mistral/index.cjs.map +1 -1
- package/dist/providers/mistral/index.js +1525 -54
- package/dist/providers/mistral/index.js.map +1 -1
- package/dist/providers/ollama/index.cjs +1559 -93
- package/dist/providers/ollama/index.cjs.map +1 -1
- package/dist/providers/ollama/index.js +1549 -93
- package/dist/providers/ollama/index.js.map +1 -1
- package/dist/providers/openai/index.cjs +1598 -61
- package/dist/providers/openai/index.cjs.map +1 -1
- package/dist/providers/openai/index.d.cts +6 -1
- package/dist/providers/openai/index.d.ts +6 -1
- package/dist/providers/openai/index.js +1588 -61
- package/dist/providers/openai/index.js.map +1 -1
- package/dist/providers/together/index.cjs +1534 -30
- package/dist/providers/together/index.cjs.map +1 -1
- package/dist/providers/together/index.js +1524 -30
- package/dist/providers/together/index.js.map +1 -1
- package/dist/providers/vercel-ai/index.cjs +1288 -17
- package/dist/providers/vercel-ai/index.cjs.map +1 -1
- package/dist/providers/vercel-ai/index.d.cts +0 -6
- package/dist/providers/vercel-ai/index.d.ts +0 -6
- package/dist/providers/vercel-ai/index.js +1278 -17
- package/dist/providers/vercel-ai/index.js.map +1 -1
- package/package.json +5 -12
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/client.ts","../src/globals.ts","../src/utils/log.ts","../src/masking.ts","../src/exporters/batch.ts","../src/config.ts","../src/ids.ts","../src/types.ts","../src/utils/clock.ts","../src/span.ts","../src/noop.ts","../src/utils/sampling.ts","../src/runtime/config.ts","../src/runtime/taxonomy.generated.ts","../src/runtime/interceptors.ts","../src/context/storage.ts","../src/tracer.ts","../src/version.ts","../src/exporters/http.ts","../src/exporters/console.ts","../src/runtime/cache.ts","../src/runtime/applier.ts","../src/runtime/loader.ts","../src/runtime/runtime.ts","../src/context/agent.ts","../src/lifecycle.ts","../src/decorators/agent.ts","../src/context/session.ts","../src/decorators/session.ts","../src/context/phase.ts","../src/decorators/phase.ts","../src/decorators/multi-agent.ts","../src/context/trace-context.ts","../src/context/registry.ts","../src/streaming.ts","../src/context/dedup.ts","../src/frameworks/langchain.ts","../src/frameworks/langgraph.ts","../src/utils/assert-client.ts","../src/frameworks/instructor.ts","../src/frameworks/llamaindex.ts","../src/webhooks.ts"],"sourcesContent":["/**\n * RisicareClient — singleton client managing SDK lifecycle.\n *\n * Handles initialization, shutdown, and the connection between\n * the Tracer and the export pipeline (batch processor + HTTP exporter).\n *\n * Usage:\n * import { init, shutdown } from 'risicare';\n * init({ apiKey: 'rsk-...' }); // API key determines project\n * // ... instrument code ...\n * await shutdown(); // flush remaining spans\n */\n\n// ⚠ F-SDKJSREPORTERROR-001 (W20, 2026-08-14) — STATIC, and it must stay static.\n// This was `require('node:crypto')` INSIDE `_errorFingerprint()`. esbuild\n// rewrites a bare `require` in an ESM output bundle to `__require(\"crypto\")`,\n// whose shim THROWS at call time; `reportError`'s catch-all then swallowed it\n// (`client.ts` ~:597, \"Never crash the host application\"). Net effect measured\n// on clean tarball installs of the PUBLISHED 0.4.2: reportError() delivered\n// ZERO spans under ESM and one under CJS — a silent no-op for every ESM\n// customer, which is the default for modern Node apps.\n//\n// A static import adds NO new environmental constraint: the package's main\n// entry already pulls `node:crypto` statically, because `src/index.ts` re-\n// exports `./webhooks.js`, which does `import { createHmac, timingSafeEqual }\n// from 'node:crypto'` at `webhooks.ts:53`. Same precedent, same module.\n//\n// ⚠ Do NOT \"optimise\" this back to a lazy require to keep the module edge-safe.\n// It would not achieve that (see above) and it silently re-breaks ESM. Verify\n// with `bash fix-workstream/perf/sdkjs/reporterror_module_system_probe.sh`,\n// whose CJS arm is the non-vacuity control and gates the exit code.\nimport { createHash } from 'node:crypto';\nimport { type RisicareConfig, resolveConfig } from './config.js';\nimport { Tracer, attachErrorCode } from './tracer.js';\nimport { SDK_VERSION } from './version.js';\nimport { BatchSpanProcessor, SHUTDOWN_BUDGET_MS } from './exporters/batch.js';\nimport { HttpExporter } from './exporters/http.js';\nimport { ConsoleExporter } from './exporters/console.js';\nimport { SpanKind, SpanStatus } from './types.js';\nimport type { SpanExporter } from './exporters/base.js';\nimport { setDebug, debug } from './utils/log.js';\nimport { maskText, SCORE_COMMENT_KEY } from './masking.js';\nimport {\n getClient as getGlobalClient,\n setClient as setGlobalClient,\n getTracer as getGlobalTracer,\n setTracer as setGlobalTracer,\n} from './globals.js';\n// PR-4+5 review NIT (2026-05-25): static ESM import. Pre-fix this was a\n// CJS `require('./runtime/runtime.js')` inside the constructor, which\n// dies in TS-source consumers (vitest, ts-node ESM) because the .js\n// resolution fails — tripping the FixRuntime catch and emitting a\n// spurious \"auto-fix is OFFLINE\" warning on EVERY test that calls init().\n// Static import resolves at module-load time and works identically under\n// ESM and CJS bundles produced by tsup. The CON-194 test still exercises\n// the failure path via vi.mock() (which intercepts ES imports correctly).\nimport { initFixRuntime, shutdownFixRuntime } from './runtime/runtime.js';\n\n/**\n * Signals whose default disposition is TERMINATE, with their numbers — needed\n * for the conventional `128 + signum` exit code (SIGTERM 143, SIGINT 130).\n * SDK-RELEASE-RULING.md §3.\n */\nconst TERMINATING_SIGNALS: ReadonlyArray<readonly [string, number]> = [\n ['SIGTERM', 15],\n ['SIGINT', 2],\n];\n\n/**\n * Headroom between the shutdown budget and the backstop that force-exits if\n * shutdown never resolves. It must be > 0 or the backstop races the drain; it\n * is small because it buys nothing but the difference between \"the drain\n * finished\" and \"the drain is wedged\". 500 ms covers the up-to-one-RTT overrun\n * the between-rounds deadline check permits (ruling §4.4).\n */\nconst BACKSTOP_MARGIN_MS = 500;\n\n/**\n * SDK-RELEASE-RULING.md §5 — the final tally survives the teardown.\n *\n * `shutdown()` clears the global client, so without this the natural pattern\n * `await shutdown(); console.log(getMetrics())` reported `droppedSpans: 0` from\n * a hardcoded literal, in the exact process that had just discarded spans.\n *\n * Written once per shutdown; cleared by `init()` so a second lifecycle never\n * serves the first's tally. Mirrors `_final_metrics` in `client.py`.\n */\nlet _finalMetrics: ReturnType<BatchSpanProcessor['getMetrics']> | undefined;\n\n// ─── Client Class ───────────────────────────────────────────────────────────\n\nclass RisicareClient {\n readonly config: ReturnType<typeof resolveConfig>;\n readonly processor: BatchSpanProcessor;\n readonly tracer: Tracer;\n /** RULING §5. The signal path does NOT clear the global client, so without\n * this flag `getMetrics()` would keep reporting `\"running\"` over a processor\n * that has already been torn down. */\n isShutdown = false;\n private _shutdownPromise: Promise<void> | undefined;\n private _shutdownHandlers: { signal: string; handler: () => void }[] = [];\n\n constructor(config?: Partial<RisicareConfig>) {\n this.config = resolveConfig(config);\n\n // API key format validation\n if (this.config.apiKey && !this.config.apiKey.startsWith('rsk-')) {\n debug('Warning: API key should start with \"rsk-\". Got: ' + this.config.apiKey.slice(0, 4) + '...');\n }\n\n // Build exporter chain\n //\n // ⚠ F-SDKJSCONSOLE-001 (fixed 2026-08-15, W23). The `else` arm below used to\n // read `exporter = new ConsoleExporter()` — \"No API key and not debug — use\n // console as fallback\". `exporters/console.ts` writes\n // `JSON.stringify(span.toPayload())` to `process.stderr`: the WHOLE payload,\n // every attribute, every event, every exception, with NO redaction of any\n // kind. Neither Tier-1 (credentials) nor Tier-2 (email/phone/SSN/card/IPv4)\n // exists in the SDK — both run server-side, one hop later — so there is\n // nothing to fall back on and the only safe action is not to write.\n //\n // A falsy API key is not an exotic state: it is a missing, mistyped or\n // not-injected `RISICARE_API_KEY` — CI, staging, a new dev's laptop, a\n // container whose secret failed to mount. Measured from the extracted,\n // PUBLISHED `risicare-0.4.2.tgz` in BOTH module systems (W20-P2, re-derived\n // W23): `RISICARE_TRACING=true` with no key printed a synthetic email, SSN,\n // Visa test PAN and RFC-5737 address to the customer's own stderr. No debug\n // flag was required and no warning was emitted.\n //\n // Python in the identical state WARNS AND DROPS (`client.py:941-947`) and\n // attaches its ConsoleExporter only under `if config.debug`\n // (`client.py:868-875`). This makes JS match Python rather than inventing a\n // third behaviour: the explicit debug opt-in below is UNCHANGED — a customer\n // who asks for console output still gets it — and the accidental state now\n // configures NO exporter at all, which is exactly what Python does.\n //\n // Consequence, deliberate and honest: with an empty exporter array the\n // processor's existing accounting takes over — spans are re-queued to the\n // MAX_RETRIES bound and then discarded as `transport_refused`, COUNTED and\n // WARNED (\"check the api_key and the endpoint\"), instead of being reported\n // as delivered. A DropExporter returning SUCCESS would have been the smaller\n // diff and would have inflated `exportedSpans` for spans that reached\n // nothing — the F-HONEST-001 defect, re-introduced in the SDK.\n let exporter: SpanExporter | undefined;\n if (this.config.debug && !this.config.apiKey) {\n exporter = new ConsoleExporter();\n } else if (this.config.apiKey) {\n exporter = new HttpExporter({\n endpoint: this.config.endpoint,\n apiKey: this.config.apiKey,\n projectId: this.config.projectId || undefined,\n environment: this.config.environment || undefined,\n compress: this.config.compress,\n });\n } else {\n // No API key and not debug — configure NO exporter, and say so. Spans are\n // created and then dropped, exactly as in Python.\n exporter = undefined;\n if (this.config.enabled) {\n // console.warn, not debug() — `debug` is off by default, which is how\n // F-SDKJSREPORTERROR-001 stayed invisible in a shipped release. Same\n // defensive wrapper as the FixRuntime warning below: some sandboxed and\n // edge runtimes have a closed stderr, and a logging call must never be\n // the thing that crashes a customer's process.\n try {\n console.warn(\n `[risicare] tracing is enabled but NO API key is configured — spans are ` +\n `created and then DROPPED, not sent to ${this.config.endpoint}. ` +\n `Pass apiKey to init() (or set the RISICARE_API_KEY env var). ` +\n `Span data is NOT written to the console: it would be unredacted. ` +\n `Pass debug:true if you want console output for local development.`\n );\n } catch {\n // Prefer silent over crash.\n }\n }\n }\n\n this.processor = new BatchSpanProcessor({\n exporters: exporter ? [exporter] : [],\n batchSize: this.config.batchSize,\n batchTimeoutMs: this.config.batchTimeoutMs,\n maxQueueSize: this.config.maxQueueSize,\n debug: this.config.debug,\n // The processor is the ONE choke point every exporter is behind. Masking\n // anywhere downstream (in the HTTP exporter, say) would leave a hole for\n // any other exporter; masking upstream would put customer code on the\n // span-end call path.\n mask: this.config.mask,\n // Same argument as `mask`: the processor is the ONE choke point every\n // exporter is behind, and the only place BOTH content paths — provider\n // capture and hand-set attributes — can be gated together. The Tracer\n // still carries `traceContent` for the provider patches to read; that is\n // now a convenience, not the enforcement point.\n traceContent: this.config.traceContent,\n });\n\n this.tracer = new Tracer({\n onSpanEnd: (span) => this.processor.onSpanEnd(span),\n sampleRate: this.config.sampleRate,\n enabled: this.config.enabled,\n traceContent: this.config.traceContent,\n // F-SDKJSSVCNAME-001 — these were resolved into `config` and then read by\n // nothing. The Tracer is where Python emits them, so JS emits them there\n // too rather than inventing a second site.\n serviceName: this.config.serviceName,\n serviceVersion: this.config.serviceVersion,\n });\n\n // Start the batch processor (enables span queuing and periodic flushing)\n this.processor.start();\n\n // Start FixRuntime for runtime fix application (preparatory\n // infrastructure for Stage 4 deployment; today /v1/fixes/active\n // always returns empty since no fix is promoted past status=draft).\n // Loads active fixes from /api/v1/fixes/active, caches with TTL,\n // background-refreshes every 60s. Provider patches call interceptCall()\n // to apply fixes before LLM calls.\n //\n // CON-194: previously the catch was an empty-body silent swallow,\n // which meant a customer whose FixRuntime failed to initialize\n // (network unreachable, bad API key, server 5xx, etc.) saw ZERO\n // signal and assumed auto-fix was running. Now the catch logs\n // console.warn with an actionable message — visible at default\n // console output, including the endpoint so customers can verify\n // reachability. Mirrors the Python SDK fix at client.py:520-528.\n if (this.config.apiKey && this.config.enabled) {\n try {\n initFixRuntime({\n apiEndpoint: this.config.endpoint,\n apiKey: this.config.apiKey,\n enabled: true,\n debug: this.config.debug,\n });\n } catch (e) {\n // FixRuntime failure is non-fatal — tracing still works.\n // Surface a one-time console.warn so the customer knows.\n const errName = e instanceof Error ? e.name : 'Error';\n const errMsg = e instanceof Error ? e.message : String(e);\n try {\n console.warn(\n `[risicare] FixRuntime initialization failed — auto-fix is OFFLINE for this process. ` +\n `endpoint=${this.config.endpoint} error=${errName}: ${errMsg}. ` +\n `Tracing + reporting still work; only fix application is disabled. ` +\n `Pass debug:true in init() options for the full traceback.`\n );\n } catch {\n // Defensive: if console.warn itself throws (closed stderr in\n // some sandboxed/edge environments), prefer silent over crash.\n }\n if (this.config.debug) {\n debug(`FixRuntime init traceback: ${e instanceof Error && e.stack ? e.stack : String(e)}`);\n }\n }\n }\n\n // Register shutdown hooks\n this._registerShutdownHooks();\n\n // Enable internal debug logging if configured\n setDebug(this.config.debug);\n debug(`Initialized: enabled=${this.config.enabled}, endpoint=${this.config.endpoint}`);\n }\n\n get enabled(): boolean {\n return this.tracer.enabled;\n }\n\n set enabled(value: boolean) {\n this.tracer.enabled = value;\n }\n\n // Audit #6: Promise-based shutdown dedup (fixes TOCTOU race condition)\n async shutdown(): Promise<void> {\n if (this._shutdownPromise) return this._shutdownPromise;\n this._shutdownPromise = this._doShutdown();\n return this._shutdownPromise;\n }\n\n private async _doShutdown(): Promise<void> {\n debug('Shutting down...');\n\n // Audit #3: Remove process listeners to prevent leak\n for (const { signal, handler } of this._shutdownHandlers) {\n process.removeListener(signal, handler);\n }\n this._shutdownHandlers = [];\n\n await this.processor.shutdown();\n\n // RULING §5: snapshot HERE, in the one place every teardown path passes\n // through.\n //\n // ⚠ THIS SITE IS THE WHOLE POINT, and the obvious site is wrong. A first\n // implementation snapshotted in the module-level `shutdown()` — which the\n // SIGTERM/SIGINT handlers never call. They call THIS method, so on exactly\n // the path a container redeploy takes, `getMetrics()` would have reported\n // a live-looking reading over a torn-down processor. The Python SDK had the\n // identical trap on its own signal path; one rule, two languages, both\n // instrumented at the shared site rather than the canonical one.\n this.isShutdown = true;\n _finalMetrics = this.processor.getMetrics();\n }\n\n /**\n * Flush pending spans.\n *\n * @returns `true` only if everything queued at entry was DELIVERED.\n *\n * RULING §6: this used to discard the processor's boolean and return\n * `Promise<void>`, which resolves without throwing and reads to a caller\n * exactly like success. A discarded answer is not meaningfully better than a\n * false one — both leave the customer unable to tell *drained* from\n * *discarded*.\n */\n async flush(): Promise<boolean> {\n return this.processor.flush();\n }\n\n /**\n * SDK-RELEASE-RULING.md §3 — who decides whether the process dies.\n *\n * The contract, and it is the same one the Python SDK now satisfies:\n *\n * the SDK's signal handler never CHANGES whether the signal\n * terminates the process.\n *\n * Registering ANY listener for SIGTERM/SIGINT displaces Node's default\n * terminate. Before this, the SDK registered one unconditionally, and on the\n * success path `clearTimeout` removed the 5 s `process.exit(1)` backstop —\n * so a JS app with a live event loop drained, cleared its own only exit, and\n * **ran forever**. The orchestrator waited out the whole grace period and\n * SIGKILLed, which exits **137** and reads as OOM-killed in every dashboard.\n * Measured >25 s alive on both 0.5.0 and a clean-rebuilt 0.4.2, so this is\n * PRE-EXISTING (`F-SDKJSEXIT-001`), not a regression of the data-loss fix.\n *\n * The rule splits on one question — did the signal already have an owner?\n *\n * * **No prior listener.** Node's default was termination and OUR\n * registration displaced it. We owe the process that death.\n * * **A prior listener exists.** The application took ownership before the\n * SDK loaded. We drain and RETURN; termination was never ours to decide,\n * and forcing it would cut off the app's own graceful shutdown.\n *\n * ⚠ `beforeExit` is deliberately NOT in that logic. It is not a signal and\n * carries no termination the SDK could displace — the loop has already\n * drained and the process is leaving on its own.\n */\n private _registerShutdownHooks(): void {\n // `beforeExit` first: no ownership question, no backstop, no exit.\n const onBeforeExit = () => {\n this.shutdown().catch(() => {});\n };\n process.once('beforeExit', onBeforeExit);\n this._shutdownHandlers.push({ signal: 'beforeExit', handler: onBeforeExit });\n\n for (const [signal, signum] of TERMINATING_SIGNALS) {\n // Captured ONCE, at registration — asking later would count our own.\n const weDisplacedDefault = process.listenerCount(signal) === 0;\n\n const handler = () => {\n // Backstop: DERIVED from the shutdown budget, never a second literal.\n // The two used to be an independent `5000` each, so a drain allowed\n // 5,000 ms raced a `process.exit(1)` firing at 5,000 ms — killing the\n // drain at its deadline, with the wrong exit code, before the residue\n // WARNING (the previous ruling's primary remedy) could print.\n const backstop = setTimeout(\n () => process.exit(128 + signum),\n SHUTDOWN_BUDGET_MS + BACKSTOP_MARGIN_MS,\n );\n backstop.unref();\n\n this.shutdown()\n .catch(() => {})\n .finally(() => {\n clearTimeout(backstop);\n if (!weDisplacedDefault) return; // the app owns termination\n\n // Our listener is gone (`process.once` + `_doShutdown` removed\n // them), so re-raising reaches Node's default and terminates for\n // real — WIFSIGNALED, not merely an exit code that looks like one.\n try {\n process.kill(process.pid, signal as NodeJS.Signals);\n } catch {\n process.exit(128 + signum);\n }\n // Belt and braces: if the application added a listener DURING our\n // drain, the re-raise above went to it instead of terminating and\n // we would hang exactly as before. unref()'d, so it cannot itself\n // hold open a process that is already leaving.\n const failsafe = setTimeout(() => process.exit(128 + signum), 100);\n failsafe.unref();\n });\n };\n\n process.once(signal, handler);\n this._shutdownHandlers.push({ signal, handler });\n }\n }\n}\n\n// ─── Public API ─────────────────────────────────────────────────────────────\n\n/**\n * Initialize the Risicare SDK. Call once at application startup.\n *\n * @example\n * import { init } from 'risicare';\n * init({ apiKey: 'rsk-...', serviceName: 'my-agent', environment: 'production' });\n */\nexport function init(config?: Partial<RisicareConfig>): void {\n const existing = getGlobalClient() as RisicareClient | undefined;\n if (existing) {\n // F-359: warn loudly when re-init would silently discard a config change.\n // The first init wins; a second init with a different apiKey/endpoint/\n // environment is almost certainly a bug (e.g., a side-effect import that\n // calls init() in a library, then the app's own init() with real config\n // gets ignored).\n if (config) {\n const incoming = resolveConfig(config);\n const diffs: string[] = [];\n const checkedKeys: Array<keyof typeof incoming> = [\n 'apiKey',\n 'endpoint',\n 'environment',\n 'serviceName',\n 'serviceVersion',\n 'sampleRate',\n ];\n for (const k of checkedKeys) {\n if (incoming[k] !== existing.config[k]) {\n // Don't print apiKey contents — just say \"differs\".\n const newRender = k === 'apiKey' ? '<redacted>' : JSON.stringify(incoming[k]);\n const oldRender = k === 'apiKey' ? '<redacted>' : JSON.stringify(existing.config[k]);\n diffs.push(`${String(k)}: ${oldRender} → ${newRender}`);\n }\n }\n if (diffs.length > 0) {\n console.warn(\n '[risicare] init() called twice with different config; the FIRST call wins. ' +\n 'Call shutdown() before re-initializing. Differences ignored: ' +\n diffs.join(', '),\n );\n } else {\n debug('init() called twice with identical config; no-op');\n }\n } else {\n debug('init() called twice; no-op');\n }\n return;\n }\n\n // RULING §5: a NEW lifecycle starts with no retained tally — otherwise\n // `init(); shutdown(); init()` would serve the FIRST run's losses as if they\n // belonged to the second.\n _finalMetrics = undefined;\n\n const client = new RisicareClient(config);\n setGlobalClient(client);\n setGlobalTracer(client.tracer);\n}\n\n/**\n * Gracefully shut down the SDK. Flushes pending spans before resolving.\n */\nexport async function shutdown(): Promise<void> {\n // Stop FixRuntime first (stops background refresh)\n try {\n shutdownFixRuntime();\n } catch {\n // FixRuntime may not be initialized\n }\n\n const client = getGlobalClient() as RisicareClient | undefined;\n if (!client) return;\n // RULING §5: the final tally is snapshotted inside `_doShutdown()`, which\n // this reaches and which the signal handlers reach directly. Do NOT add a\n // second snapshot here.\n await client.shutdown();\n setGlobalClient(undefined);\n setGlobalTracer(undefined);\n}\n\n/**\n * Flush all pending spans without shutting down.\n *\n * @returns `true` only if everything queued at entry was DELIVERED — `false`\n * if the deadline expired with spans still queued, or if any span was\n * discarded during the window (F-SDKCB-001 §6). An uninitialised SDK returns\n * `true`: it was handed nothing, and it lost nothing.\n *\n * ⚠ Signature change in 0.5.0 — was `Promise<void>`. Existing callers that\n * ignore the result keep working unchanged.\n */\nexport async function flush(): Promise<boolean> {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (!client) return true;\n return client.flush();\n}\n\n/**\n * Enable tracing at runtime.\n */\nexport function enable(): void {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (client) client.enabled = true;\n}\n\n/**\n * Disable tracing at runtime. Spans will not be created or exported.\n */\nexport function disable(): void {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (client) client.enabled = false;\n}\n\n/**\n * Check whether tracing is currently enabled.\n */\nexport function isEnabled(): boolean {\n const client = getGlobalClient() as RisicareClient | undefined;\n return client?.enabled ?? false;\n}\n\n/**\n * Get the global tracer instance. Returns undefined if not initialized.\n */\nexport function getTracer(): Tracer | undefined {\n return getGlobalTracer() as Tracer | undefined;\n}\n\n/**\n * Get the global tracer, or throw if not initialized.\n * @internal Used by decorators and providers that require an active tracer.\n */\nexport function requireTracer(): Tracer {\n const tracer = getGlobalTracer() as Tracer | undefined;\n if (!tracer) {\n throw new Error(\n 'Risicare SDK not initialized. Call init() before using tracing features.',\n );\n }\n return tracer;\n}\n\n/**\n * Check whether content tracing (prompt/completion capture) is enabled.\n */\nexport function getTraceContent(): boolean {\n const tracer = getGlobalTracer() as Tracer | undefined;\n // Fail-closed, matching the 0.5.1 config default.\n return tracer?.traceContent ?? false;\n}\n\n/**\n * Get SDK metrics: exported spans, dropped spans, failed exports, queue stats.\n *\n * `sdkState` — SDK-RELEASE-RULING.md §5 — says WHICH of three different facts\n * the numbers are, because before it all three rendered as the same zeros:\n *\n * - `\"uninitialised\"` nothing was ever queued; the zeros are the truth\n * - `\"running\"` live readings from a live processor\n * - `\"shutdown\"` the RETAINED FINAL TALLY. Not live, and says so.\n *\n * The `\"shutdown\"` case is why this field exists. `shutdown()` clears the global\n * client, so this used to answer `droppedSpans: 0` from a hardcoded literal in\n * the very process that had just discarded spans — a guess presented\n * byte-identical to an authoritative answer, which is the W1/W3 class this\n * codebase already ruled against (`cost_source`, `settled`). The remedy there\n * and here is the same: do not hide the value and do not null it, LABEL it.\n * Every field of a retained tally is still true — the queue really is empty,\n * the capacity really is the configured one, and the drop counts describe the\n * whole life of the process, `shutdown_residue` included.\n *\n * ⚠ What it still CANNOT do: report loss to anything OUTSIDE the dying process.\n * A counter in memory about to be freed has no reader, and a SIGKILL takes this\n * and the WARNING together. The WARNING remains the primary signal.\n */\nexport function getMetrics() {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (client && !client.isShutdown) {\n return { ...client.processor.getMetrics(), sdkState: 'running' as const };\n }\n if (_finalMetrics) {\n // Copy: a caller mutating the object must not corrupt the one tally the\n // process has left.\n return {\n ..._finalMetrics,\n droppedSpansByReason: { ..._finalMetrics.droppedSpansByReason },\n sdkState: 'shutdown' as const,\n };\n }\n return {\n exportedSpans: 0,\n droppedSpans: 0,\n droppedSpansByReason: {\n queue_full: 0,\n transport_refused: 0,\n shutdown_residue: 0,\n },\n failedExports: 0,\n queueSize: 0,\n queueCapacity: 0,\n queueUtilization: 0,\n sdkState: 'uninitialised' as const,\n };\n}\n\n// ─── reportError ──────────────────────────────────────────────────────────\n\n// Error dedup: SHA256 fingerprint → timestamp. Prevents retry loops from\n// creating N duplicate diagnoses. Matches Python SDK's 5-minute TTL.\nconst _ERROR_DEDUP_TTL_MS = 5 * 60 * 1000; // 5 minutes\nconst _ERROR_DEDUP_MAX = 1000;\nconst _recentErrors = new Map<string, number>(); // fingerprint → Date.now()\n\nfunction _errorFingerprint(err: Error): string {\n const raw = `${err.constructor?.name ?? 'Error'}:${String(err.message ?? '').slice(0, 200)}`;\n return createHash('sha256').update(raw).digest('hex').slice(0, 16);\n}\n\nfunction _isDuplicateError(fingerprint: string): boolean {\n const now = Date.now();\n // Evict expired entries\n for (const [fp, ts] of _recentErrors) {\n if (now - ts > _ERROR_DEDUP_TTL_MS) _recentErrors.delete(fp);\n else break; // Map iterates in insertion order\n }\n if (_recentErrors.has(fingerprint)) return true;\n // Enforce max size\n if (_recentErrors.size >= _ERROR_DEDUP_MAX) {\n const oldest = _recentErrors.keys().next().value;\n if (oldest !== undefined) _recentErrors.delete(oldest);\n }\n _recentErrors.set(fingerprint, now);\n return false;\n}\n\n/**\n * Report a caught exception to the error diagnosis pipeline.\n *\n * Creates an error span that triggers diagnosis and fix generation.\n * Deduplicates identical errors within a 5-minute window (SHA256 fingerprint).\n * This function never throws and is non-blocking.\n *\n * @param error - The caught exception (Error object or string)\n * @param options - Optional attributes and context overrides\n */\nexport function reportError(\n error: unknown,\n options?: { name?: string; attributes?: Record<string, unknown> },\n): void {\n try {\n const tracer = getTracer();\n if (!tracer) return;\n\n const err = error instanceof Error ? error : new Error(String(error ?? 'unknown'));\n const spanName = options?.name ?? `error:${err.constructor.name}`;\n\n // Dedup: suppress identical errors within TTL (matches Python SDK)\n const fp = _errorFingerprint(err);\n if (_isDuplicateError(fp)) {\n debug(`reportError: duplicate suppressed (fp=${fp.slice(0, 8)})`);\n return;\n }\n\n tracer.startSpan({ name: spanName, kind: SpanKind.INTERNAL }, (span) => {\n span.setStatus(SpanStatus.ERROR, err.message);\n span.setAttribute('error', true);\n span.setAttribute('error.type', err.constructor.name);\n span.setAttribute('error.message', err.message.slice(0, 2000));\n if (err.stack) span.setAttribute('error.stack', err.stack.slice(0, 4000));\n span.setAttribute('risicare.reported_error', true);\n // F-R-REPORTERRCODE-001. `reportError` is the API our own docs name for\n // feeding the diagnosis pipeline, yet it attached error/type/message and\n // NO taxonomy code, while an uncaught throw through a traced frame did —\n // `tracer.ts::Tracer.startSpan` calls `attachErrorCode` on both of its\n // throw handlers. Measured on the published 0.5.2 against the lab: 4\n // uncaught spans carried TOOL.EXECUTION.CRASHED, the reportError span\n // carried none. Same shape as the Python asymmetry, same remedy — reuse\n // the ONE definition rather than re-classifying here.\n attachErrorCode(span, err);\n if (options?.attributes) {\n for (const [k, v] of Object.entries(options.attributes)) {\n span.setAttribute(k, v);\n }\n }\n });\n } catch {\n // Never crash the host application\n debug('reportError failed');\n }\n}\n\n// ─── score ─────────────────────────────────────────────────────────────────\n\n/**\n * Record a custom evaluation score on a trace.\n *\n * Sends the score to the server in a fire-and-forget fashion.\n * This function never throws and is non-blocking.\n *\n * If a `mask` is configured on `init()`, `options.comment` is passed to it under\n * the key `score.comment` before the request is built. `traceId`, `spanId` and\n * `name` are NOT masked — they are identifiers the platform joins and groups on.\n *\n * @param traceId - The trace to score\n * @param name - Score name (e.g., \"accuracy\", \"user_satisfaction\")\n * @param value - Score value between 0.0 and 1.0 inclusive\n * @param options - Optional span_id and comment\n */\nexport function score(\n traceId: string,\n name: string,\n value: number,\n options?: { spanId?: string; comment?: string },\n): void {\n try {\n if (typeof value !== 'number' || !Number.isFinite(value) || value < 0.0 || value > 1.0) {\n debug(`score: value must be in [0.0, 1.0], got ${value}. Score not sent.`);\n return;\n }\n if (!traceId || !name) {\n debug('score: traceId and name are required');\n return;\n }\n\n const client = getGlobalClient() as RisicareClient | undefined;\n if (!client?.enabled || !client.config.apiKey) return;\n\n const endpoint = client.config.endpoint.replace(/\\/$/, '');\n const url = `${endpoint}/api/v1/scores`;\n\n // ⚠ THE ONE NON-SPAN EGRESS THE MASK COVERS (F-SDKMASKSCORE-001).\n // This POST does not go through BatchSpanProcessor, so `applyMask` never\n // sees it — `comment` is free customer text on our wire and was uncovered\n // until this call. The ruling (why the same hook rather than a second one,\n // why `name` is deliberately NOT masked, and the caller-thread cost) is in\n // `risicare/masking.py`, \"THE NON-SPAN SURFACE\".\n //\n // Runs BEFORE `JSON.stringify`, so the unmasked value is never serialized.\n // `maskText` is the same primitive `statusMessage` uses, so a throwing mask\n // yields the same marker and the score is still sent.\n let comment = options?.comment;\n if (comment !== undefined && client.config.mask) {\n comment = maskText(client.config.mask, SCORE_COMMENT_KEY, comment);\n }\n\n const body = JSON.stringify({\n trace_id: traceId,\n name,\n score: value,\n source: 'sdk',\n ...(options?.spanId && { span_id: options.spanId }),\n ...(comment && { comment }),\n });\n\n // Fire-and-forget — never blocks caller\n fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Authorization': `Bearer ${client.config.apiKey}`,\n // F-SDKVER-001 — see the Python twin. `score()` reaches the FastAPI\n // server under /v1/, which `main.py::audit_logging_middleware` audits\n // into `audit_logs.user_agent`; ingest reaches the Rust gateway, which\n // discards it. This is the one client-identity visible with no gateway\n // change.\n 'User-Agent': `risicare-js/${SDK_VERSION} node/${process.version}`,\n 'X-Risicare-SDK-Version': SDK_VERSION,\n },\n body,\n }).catch((err) => debug(`score: send failed: ${err}`));\n } catch {\n // Never crash the host application\n debug('score failed');\n }\n}\n","/**\n * Shared state via globalThis — ensures all entry point bundles share\n * the same singleton instances.\n *\n * Problem: tsup with `splitting: false` gives each entry point (index,\n * openai, anthropic, vercel-ai) its own copy of module-level variables.\n * This means `init()` from 'risicare' sets a tracer that 'risicare/openai'\n * can't see — breaking all provider instrumentation silently.\n *\n * Solution: Store all mutable singletons on globalThis with a namespaced\n * prefix. Every bundle reads/writes the same global slots.\n *\n * This pattern is used by React, OpenTelemetry, and other SDKs that must\n * share state across independently bundled entry points.\n *\n * @internal\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst G = globalThis as any;\nconst PREFIX = '__risicare_';\n\n// ─── Client & Tracer ────────────────────────────────────────────────────────\n\nexport function getClient(): unknown {\n return G[PREFIX + 'client'];\n}\n\nexport function setClient(client: unknown): void {\n G[PREFIX + 'client'] = client;\n}\n\nexport function getTracer(): unknown {\n return G[PREFIX + 'tracer'];\n}\n\nexport function setTracer(tracer: unknown): void {\n G[PREFIX + 'tracer'] = tracer;\n}\n\n// ─── Context Storage ────────────────────────────────────────────────────────\n\nexport function getContextStorage(): AsyncLocalStorage<unknown> {\n if (!G[PREFIX + 'ctx']) {\n G[PREFIX + 'ctx'] = new AsyncLocalStorage();\n }\n return G[PREFIX + 'ctx'];\n}\n\n// ─── Span Registry ──────────────────────────────────────────────────────────\n\nexport function getRegistry(): Map<string, unknown> {\n if (!G[PREFIX + 'registry']) {\n G[PREFIX + 'registry'] = new Map();\n }\n return G[PREFIX + 'registry'];\n}\n\nexport function getOpCount(): number {\n return G[PREFIX + 'opcount'] ?? 0;\n}\n\nexport function setOpCount(n: number): void {\n G[PREFIX + 'opcount'] = n;\n}\n\n// ─── Debug Flag ─────────────────────────────────────────────────────────────\n\nexport function getDebug(): boolean {\n return G[PREFIX + 'debug'] ?? false;\n}\n\nexport function setDebugFlag(enabled: boolean): void {\n G[PREFIX + 'debug'] = enabled;\n}\n\n// ─── Fix Runtime ────────────────────────────────────────────────────────\n\nexport function getGlobalFixRuntime(): unknown {\n return G[PREFIX + 'fix_runtime'];\n}\n\nexport function setGlobalFixRuntime(runtime: unknown): void {\n G[PREFIX + 'fix_runtime'] = runtime;\n}\n","/**\n * Internal logger for the Risicare SDK.\n *\n * Centralizes all diagnostic output so that:\n * - Debug messages are gated by a single flag (zero-cost when disabled)\n * - Warnings always fire (operational alerts like queue full)\n * - All output goes to stderr with a consistent [risicare] prefix\n * - A future custom logger callback can be added in one place\n */\n\nimport { getDebug, setDebugFlag } from '../globals.js';\n\n/**\n * Enable or disable debug logging. Called once during init().\n * @internal\n */\nexport function setDebug(enabled: boolean): void {\n setDebugFlag(enabled);\n}\n\n/**\n * Log a debug message. Only outputs when debug mode is enabled.\n * @internal\n */\nexport function debug(msg: string): void {\n if (getDebug()) {\n process.stderr.write(`[risicare] ${msg}\\n`);\n }\n}\n\n/**\n * Log a warning. Always outputs regardless of debug mode.\n * Use sparingly — only for operational issues the user should see.\n * @internal\n */\nexport function warn(msg: string): void {\n process.stderr.write(`[risicare] WARNING: ${msg}\\n`);\n}\n","/**\n * Customer-supplied masking of span content, applied before anything leaves the process.\n *\n * The full rationale — why this is the ONLY layer rather than defence in depth,\n * why the hook carries the key, what is deliberately not masked, and the\n * fail-closed-per-field ruling — is written once, in the Python twin:\n * `packages/risicare-sdk/src/risicare/masking.py`. This file mirrors it. Where\n * the two languages diverge, the divergence is called out inline below; do not\n * \"align\" them without reading both.\n *\n * ── Mirrored from Python ─────────────────────────────────────────────────────\n * • signature `mask(key, value) => value` — the key is REQUIRED, because our\n * span model has no input/output fields: the prompt and the model name are\n * both plain entries of `span.attributes`, so a keyless hook cannot tell\n * them apart and `() => '***'` would erase every dashboard label.\n * • masked: every attribute value, `statusMessage`, every event-attribute\n * value, every link-attribute value — plus `score.comment`, the one key\n * that is NOT a span field (see {@link SCORE_COMMENT_KEY}).\n * • NOT masked: traceId / spanId / parentSpanId, `span.name`, `event.name`,\n * and the typed identity + llm columns (agentId, agentName, agentType,\n * sessionId, toolName, llmModel, …). Masking an identifier breaks the\n * customer's own joins — the F-39C lesson. The OTel-style attribute forms\n * (`agent.name`, `session.user_id`) live in `attributes` and ARE masked.\n * • no type narrowing: the hook sees numbers and booleans too. A card number\n * is representable as a number, and deciding otherwise on the customer's\n * behalf is the quiet narrowing this codebase keeps paying for.\n * • fail closed per FIELD: a throwing hook yields `MASK_ERROR_MARKER` for\n * that field and the span is exported intact. Never drop the span — the\n * SDK is the last place the data exists, so a drop here is permanent loss,\n * and it additionally orphans the span's children for zero extra safety.\n * • idempotent: `_exportBatch` can re-queue a refused batch, and a user\n * callback cannot be assumed idempotent, so a masked span is flagged.\n *\n * ── Where JS DIFFERS from Python, and it matters ─────────────────────────────\n * 1. There is no `exceptions[]` on the JS Span — `toPayload()` emits none — so\n * there are no `exceptions.{i}.*` keys here. A port that adds exceptions to\n * the JS span must add them here in the same change.\n * 2. ⚠ THE HOT-PATH COST IS STRICTLY WORSE THAN PYTHON'S. Python runs the mask\n * on a background worker THREAD, so a slow mask costs only drain rate. Node\n * has one thread: `_exportBatch` is `async`, but the mask itself is sync, so\n * while it runs NOTHING else in the customer's process runs — not their\n * request handlers, not their timers. In Python a slow mask degrades\n * throughput; in JS it degrades the whole application. The budget warning\n * below is not advisory decoration here.\n * 3. `_masked` is a real private field on `Span` (we own that class), rather\n * than Python's `setattr` — which Python needs only because its `Span`\n * lives in the separate `risicare-core` package.\n */\n\nimport { warn, debug } from './utils/log.js';\nimport type { Span } from './span.js';\n\n/**\n * A customer mask callback.\n *\n * @param key Fully-qualified path of the value: an attribute key as-is\n * (`\"gen_ai.prompt.0.content\"`), or a dotted path\n * (`\"statusMessage\"`, `\"events.0.attributes.foo\"`,\n * `\"links.0.attributes.bar\"`).\n * @param value The current value — any type, not just string.\n * @returns The replacement, or `value` unchanged.\n */\nexport type MaskFn = (key: string, value: unknown) => unknown;\n\n/** Called with `(key, error)` for every field whose mask threw. */\nexport type MaskErrorReporter = (key: string, error: unknown) => void;\n\n/**\n * Substituted for a value whose mask threw. Fixed, deliberately not\n * valid-looking, and greppable in a dashboard.\n */\nexport const MASK_ERROR_MARKER = '<risicare:mask-error>';\n\n/**\n * The masking hot-path budget, in ms per span. MEASURED and NAMED, never\n * ENFORCED — see the Python twin. A \"disable the mask because it is slow\" rule\n * would fail OPEN on a security control, silently, which is the worst outcome\n * available; so exceeding this warns and nothing else.\n *\n * 1 ms/span leaves a 500-span batch at 500 ms, under the 1,000 ms default\n * `batchTimeoutMs` — the last point at which one batch's masking still fits\n * inside one batch's period. Past that the queue provably grows, and in Node\n * the event loop is blocked for the excess.\n */\nexport const MASK_BUDGET_MS_PER_SPAN = 1.0;\n\n/** Rate-limit window for both mask warnings, in ms. */\nexport const MASK_WARN_WINDOW_MS = 300_000;\n\n/**\n * The key the hook receives for `score(traceId, name, value, { comment })`.\n *\n * ⚠ THE ONE KEY THAT IS NOT A SPAN FIELD. `score()` POSTs direct to\n * `/api/v1/scores` (`client.ts`), outside `BatchSpanProcessor` and therefore\n * outside {@link applyMask} — so its free-text `comment` was uncovered until\n * F-SDKMASKSCORE-001. The full ruling (why the same hook rather than a second\n * one, why the score's `name` is deliberately NOT masked, and why the cost lands\n * on the caller here rather than on the exporter) is written once in the Python\n * twin: `risicare/masking.py`, \"THE NON-SPAN SURFACE\".\n *\n * A constant, not a literal at the call site, so the two SDKs cannot drift and a\n * customer's `if (key === ...)` has something importable to compare against.\n */\nexport const SCORE_COMMENT_KEY = 'score.comment';\n\n/**\n * Mask ONE free-text value that reaches the wire raw, and coerce the result.\n *\n * The exported form of the same primitive {@link applyMask} uses for\n * `statusMessage`. It exists so a non-span egress (today: `score(comment)`) gets\n * byte-identical semantics to a span field — same marker, same\n * fail-closed-per-field rule, same coercion — rather than a second\n * implementation that drifts from this one.\n *\n * Never throws.\n */\nexport function maskText(\n mask: MaskFn,\n key: string,\n value: unknown,\n onError?: MaskErrorReporter,\n): string {\n return maskString(mask, key, value, onError);\n}\n\n/** Apply `mask` to one value. Never throws; fails closed to the marker. */\nfunction maskOne(\n mask: MaskFn,\n key: string,\n value: unknown,\n onError: MaskErrorReporter | undefined,\n): unknown {\n try {\n return mask(key, value);\n } catch (e) {\n onError?.(key, e);\n return MASK_ERROR_MARKER;\n }\n}\n\n/**\n * Apply `mask` to a field that reaches the wire as a raw JSON string, and\n * coerce the result.\n *\n * `HttpExporter` serializes the WHOLE batch in one `JSON.stringify`\n * (`exporters/http.ts:119`). Unlike Python's `json.dumps`, `JSON.stringify`\n * does not throw on most objects — but it DOES throw on a circular reference\n * or a BigInt, and it silently emits `null` for a function or `undefined`,\n * which would erase the field without saying so. Coercing here keeps one bad\n * return value from one field from taking out every other span in the batch.\n */\nfunction maskString(\n mask: MaskFn,\n key: string,\n value: unknown,\n onError: MaskErrorReporter | undefined,\n): string {\n const masked = maskOne(mask, key, value, onError);\n if (typeof masked === 'string') return masked;\n try {\n return String(masked);\n } catch (e) {\n // A `Symbol`, or an object with a hostile `toString`.\n onError?.(key, e);\n return MASK_ERROR_MARKER;\n }\n}\n\n/** Mask every value of an attribute record IN PLACE. */\nfunction maskAttributes(\n mask: MaskFn,\n prefix: string,\n attrs: Record<string, unknown>,\n onError: MaskErrorReporter | undefined,\n): void {\n // Snapshot the keys: the hook is customer code and must not be able to make\n // us iterate a record it is concurrently reshaping.\n for (const k of Object.keys(attrs)) {\n attrs[k] = maskOne(mask, prefix + k, attrs[k], onError);\n }\n}\n\n/** Whether `applyMask` has already run over this span. */\nexport function isMasked(span: Span): boolean {\n return (span as unknown as { _risicareMasked?: boolean })._risicareMasked === true;\n}\n\nfunction markMasked(span: Span): void {\n try {\n (span as unknown as { _risicareMasked?: boolean })._risicareMasked = true;\n } catch {\n // Only reachable for a frozen/sealed stand-in. Degrade to \"may be masked\n // again on re-queue\", never to a throw inside the export path.\n debug('Could not mark span as masked; a re-queue may re-mask it');\n }\n}\n\n/**\n * Mask every content-bearing field of `span`, in place, exactly once.\n *\n * Never throws. A field whose mask throws is replaced with\n * {@link MASK_ERROR_MARKER}; the span is always preserved.\n */\nexport function applyMask(span: Span, mask: MaskFn, onError?: MaskErrorReporter): void {\n if (isMasked(span)) return;\n\n // ── attributes ─────────────────────────────────────────────────────────────\n if (span.attributes && typeof span.attributes === 'object') {\n maskAttributes(mask, '', span.attributes, onError);\n }\n\n // ── status message ─────────────────────────────────────────────────────────\n if (span.statusMessage !== undefined) {\n span.statusMessage = maskString(mask, 'statusMessage', span.statusMessage, onError);\n }\n\n // ── events ─────────────────────────────────────────────────────────────────\n // `event.name` is NOT masked — it is the timeline's grouping key, same\n // argument as `span.name`.\n if (Array.isArray(span.events)) {\n span.events.forEach((event, i) => {\n if (event?.attributes && typeof event.attributes === 'object') {\n maskAttributes(mask, `events.${i}.attributes.`, event.attributes, onError);\n }\n });\n }\n\n // ── links ──────────────────────────────────────────────────────────────────\n // `traceId` / `spanId` on a link are structural: masking them severs the\n // link, which is the one thing a link is for.\n if (Array.isArray(span.links)) {\n span.links.forEach((link, i) => {\n if (link?.attributes && typeof link.attributes === 'object') {\n maskAttributes(mask, `links.${i}.attributes.`, link.attributes, onError);\n }\n });\n }\n\n markMasked(span);\n}\n\n// ── content capture gate (traceContent) ───────────────────────────────────────\n//\n// ⚠ THIS IS A CAPTURE SWITCH, NOT A REDACTION FEATURE. `mask` above stays the\n// only pre-export redaction hook; nothing here inspects a VALUE. The gate is a\n// pure KEY-SHAPE filter, and it lives in this module because this module already\n// owns the one walk both content paths cross.\n//\n// The Python twin is `risicare/masking.py::strip_content` and the two are kept\n// character-for-character equivalent in RULE — same exact-match set, same suffix\n// rule, same marker, same walk. Four divergences of exactly this shape have been\n// measured in this campaign (`debug` gated differently; `deleted_at IS NULL` in\n// the gateway only; three Redis cache-clear sites; `reportError` dead in ESM\n// only), so a one-sided fix here would become the fifth.\n//\n// Before 0.5.1 `traceContent` was carried by the Tracer (`tracer.ts`) behind a\n// getter and consulted ONLY by the provider patches. Measured on the published\n// 0.5.0: `getTraceContent()` returned false and a hand-set\n// `gen_ai.prompt.0.content` still reached the wire byte-for-byte.\n\n/**\n * Attribute keys that carry customer content but do not match the suffix rule.\n *\n * ⚠ LOAD-BEARING. `gen_ai.system_prompt` (anthropic, bedrock) and\n * `gen_ai.prompt.message` (cohere) carry content and do NOT end in `content` —\n * a suffix rule alone silently leaks both. Matched EXACTLY rather than by\n * substring, because `framework.pydantic_ai.system_prompt_length` is a number\n * and must survive.\n */\nconst CONTENT_KEYS_EXACT: ReadonlySet<string> = new Set([\n 'gen_ai.system_prompt',\n 'gen_ai.prompt.message',\n]);\n\n/**\n * Replaces a stripped value, rather than deleting the key.\n *\n * Deleting would make \"the customer sent no prompt\" and \"the customer disabled\n * capture\" indistinguishable downstream — the W1/W3 honesty rule: label the\n * absence, never forge it.\n */\nexport const CONTENT_OMITTED_MARKER = '<risicare:content-omitted>';\n\n/**\n * Whether `key` names a customer-content attribute. Pure function of the KEY.\n *\n * Derived from what the PLATFORM treats as content — exactly the keys\n * `spans_worker._extract_input_preview` / `_extract_output_preview` read — plus\n * every `*.content` key the providers and integrations emit. Guards on the\n * SHAPE, not an enumeration (F-COMPATGUARD-001: an enumeration rots the moment\n * a provider adds a key).\n *\n * Deliberately does NOT match: `gen_ai.response.content_type` (a MIME type),\n * `gen_ai.response.content_blocks` / `gen_ai.prompt.parts` /\n * `gen_ai.response.choices` / `gen_ai.completion.tool_calls` (counts),\n * `gen_ai.prompt.{i}.role` (a role name).\n */\nexport function isContentKey(key: string): boolean {\n if (CONTENT_KEYS_EXACT.has(key)) return true;\n const lastSegment = key.slice(key.lastIndexOf('.') + 1);\n if (lastSegment === 'content') return true;\n return key.endsWith('_content');\n}\n\n/** Replace every content-keyed value in `attrs` IN PLACE. Returns the count. */\nfunction stripAttributes(attrs: Record<string, unknown>): number {\n let n = 0;\n for (const k of Object.keys(attrs)) {\n if (isContentKey(k)) {\n attrs[k] = CONTENT_OMITTED_MARKER;\n n++;\n }\n }\n return n;\n}\n\n/**\n * Remove customer prompt/completion content from `span`, in place.\n *\n * Walks the same surfaces as {@link applyMask} — span attributes, event\n * attributes, link attributes — because that is where content lives.\n *\n * `statusMessage` and exception text are deliberately NOT stripped: the\n * error-diagnosis product IS those fields, and this is a content-capture switch,\n * not a redaction feature.\n *\n * Returns the number of fields replaced. Never throws.\n */\nexport function stripContent(span: Span): number {\n let stripped = 0;\n\n if (span.attributes && typeof span.attributes === 'object') {\n stripped += stripAttributes(span.attributes);\n }\n\n if (Array.isArray(span.events)) {\n for (const event of span.events) {\n if (event?.attributes && typeof event.attributes === 'object') {\n stripped += stripAttributes(event.attributes);\n }\n }\n }\n\n if (Array.isArray(span.links)) {\n for (const link of span.links) {\n if (link?.attributes && typeof link.attributes === 'object') {\n stripped += stripAttributes(link.attributes);\n }\n }\n }\n\n return stripped;\n}\n\n/** Strip content from every span in a batch, in place. Never throws. */\nexport function stripContentBatch(spans: Span[]): number {\n let total = 0;\n for (const span of spans) {\n try {\n total += stripContent(span);\n } catch {\n // A span we cannot walk must not take the batch down with it. It is also\n // the one span we could not gate, so say so at debug level.\n debug('Could not strip content from a span');\n }\n }\n return total;\n}\n\n/**\n * Mask a whole batch in place and report what it cost.\n *\n * Returns the field-level error count and the elapsed wall time so the caller\n * (the batch processor) owns the metric and the rate-limited warning — the\n * same split Python uses.\n */\nexport function applyMaskBatch(\n spans: Span[],\n mask: MaskFn,\n onError?: MaskErrorReporter,\n): { errors: number; elapsedMs: number } {\n let errors = 0;\n let firstKey: string | undefined;\n let firstError: unknown;\n\n const report: MaskErrorReporter = (key, error) => {\n errors++;\n if (firstKey === undefined) {\n firstKey = key;\n firstError = error;\n }\n onError?.(key, error);\n };\n\n const started = Date.now();\n for (const span of spans) {\n applyMask(span, mask, report);\n }\n const elapsedMs = Date.now() - started;\n\n if (errors > 0 && firstKey !== undefined) {\n // Attach the first failure to the returned shape via a side channel would\n // be noise; the processor logs from its own rate-limiter, so surface the\n // detail here at debug level for the case where the window suppressed it.\n debug(`mask threw on ${errors} field(s); first: key=${firstKey} ${String(firstError)}`);\n }\n\n return { errors, elapsedMs };\n}\n\n/** Emit the rate-limited \"your mask is throwing\" warning. Exported for reuse. */\nexport function warnMaskErrors(batchErrors: number, totalErrors: number): void {\n warn(\n `the mask callback threw on ${batchErrors} field(s) in this batch ` +\n `(${totalErrors} since start). Those fields were replaced with ` +\n `\"${MASK_ERROR_MARKER}\" and the spans were exported intact — no span was ` +\n `dropped. Fix the callback; until then those fields carry no data.`,\n );\n}\n\n/** Emit the rate-limited \"your mask is slow\" warning. Exported for reuse. */\nexport function warnMaskSlow(spanCount: number, elapsedMs: number): void {\n warn(\n `masking ${spanCount} span(s) took ${elapsedMs} ms ` +\n `(budget ${MASK_BUDGET_MS_PER_SPAN * spanCount} ms, ` +\n `${MASK_BUDGET_MS_PER_SPAN} ms/span). Node is single-threaded: this time is ` +\n `taken from your event loop, so it delays your application as well as the ` +\n `export drain, and a queue that cannot drain drops spans (reason=queue_full). ` +\n `Keep the callback CPU-only: no I/O, no network, no unbounded retries.`,\n );\n}\n","/**\n * Batch span processor.\n *\n * Collects spans and exports them in batches based on:\n * - Batch size threshold (default: 500 spans — SDK-RELEASE-RULING.md §4.3 raised\n * this from 100; see `DEFAULT_BATCH_SIZE` below, which is the one true source)\n * - Time interval (default: 1000ms)\n * - Attribute product (`MAX_ATTRIBUTE_PAIRS_PER_BATCH`) and estimated serialized\n * size (`MAX_BATCH_BYTES`), both mirroring gateway constants\n *\n * Node.js is single-threaded — no locks needed.\n * Timer is unref()'d so it doesn't prevent process exit.\n */\n\nimport type { Span } from '../span.js';\nimport { ExportResult, type SpanExporter } from './base.js';\nimport { debug, warn } from '../utils/log.js';\nimport {\n applyMaskBatch,\n stripContentBatch,\n warnMaskErrors,\n warnMaskSlow,\n MASK_BUDGET_MS_PER_SPAN,\n MASK_WARN_WINDOW_MS,\n type MaskFn,\n} from '../masking.js';\n\nexport interface BatchProcessorOptions {\n exporters: SpanExporter[];\n batchSize?: number;\n batchTimeoutMs?: number;\n maxQueueSize?: number;\n debug?: boolean;\n /**\n * Customer masking callback, `mask(key, value) => value`. Applied to every\n * content-bearing field of every span in this processor, once, BEFORE any\n * exporter sees the batch. See `../masking.ts`.\n */\n mask?: MaskFn;\n /**\n * Whether customer prompt/completion content may leave the process.\n * **Defaults to `false`** — the same fail-closed default as `resolveConfig`.\n * When false, every content-keyed attribute is replaced on the export path\n * before any exporter runs. See `../masking.ts` `stripContent`.\n */\n traceContent?: boolean;\n}\n\n/**\n * F-SDKCB-001 §5 (option J) — reason labels for a discarded span.\n *\n * One integer conflating an under-provisioned queue, a dead gateway and a\n * redeploy is the ambiguity W1/W3 was written against: the three causes demand\n * three different operator responses. The server side already landed on this\n * shape as `dropped{stage,reason,project_id}` (F-HONEST-001). Mirrors the\n * Python `DROP_*` constants in `exporters/batch.py`.\n */\nexport type DropReason = 'queue_full' | 'transport_refused' | 'shutdown_residue';\n\n/** Outcome of one `_exportBatch()` round.\n *\n * `shutdown()`'s drain loop must tell \"the queue is empty\" from \"a batch was\n * taken and nobody accepted it\" — RULING §4's no-SUCCESS exit. Without that\n * distinction the loop would spin for the whole budget against a dead\n * transport, and (because the bounded re-queue keeps the queue non-empty)\n * would never terminate at all. */\nconst enum Round {\n Empty = 0,\n Delivered = 1,\n Failed = 2,\n /** an export was already in flight (`_flushing`); this call made no progress */\n Busy = 3,\n}\n\n/**\n * RULING §4 delegates this number with a derive-and-justify obligation.\n * `shutdown()` runs `exporter.shutdown()` AFTER the drain, so a drain that\n * spends the whole budget starves it.\n *\n * The built-in `HttpExporter.shutdown()` is a literal no-op — native fetch\n * needs no cleanup (`exporters/http.ts:159-161`) — so for the shipped exporter\n * the measured cost is ZERO. The reserve is therefore a policy allowance for a\n * CUSTOMER-supplied exporter, whose `shutdown(): Promise<void> | void`\n * (`exporters/base.ts:16`) we cannot measure. Held at 100 ms to match the\n * Python constant — the two SDKs must end with the same contract, and Python's\n * value is measured (see `_SHUTDOWN_RESERVE_MS` in `exporters/batch.py` and\n * `fix-workstream/perf/sdk_exporter_shutdown_cost_probe.py`). Against the\n * binding 2,000 ms SIGTERM budget this leaves 1,900 ms of drain.\n */\nconst SHUTDOWN_RESERVE_MS = 100;\n\n/**\n * SDK-RELEASE-RULING.md §4.3 — ONE shutdown budget, on every teardown path.\n *\n * 5,000 ms is bounded from ABOVE by something outside our control: the SDK's\n * shutdown runs inside the application's, which runs inside the container's\n * termination grace period. The tightest common default is `docker stop` at\n * 10 s (k8s `terminationGracePeriodSeconds` 30 s; systemd `TimeoutStopSec`\n * 90 s), and taking more than half of the tightest is hostile to the app's own\n * cleanup.\n *\n * ⚠ WHY A LONGER BUDGET IS NEARLY FREE: the drain exits on the FIRST round that\n * does not deliver (`Round.Delivered` check below). A dead transport costs one\n * round, not the budget. It is spent only while the transport is SUCCEEDING.\n *\n * ⚠ `client.ts` DERIVES its signal-handler backstop from this rather than\n * repeating a literal. Before the ruling both were an independent `5000`, so\n * the backstop's `process.exit(1)` raced the drain it exists to protect —\n * killing it at the deadline, with the wrong exit code, before the residue\n * warning could print. Do not re-introduce a second literal.\n *\n * Mirrors `SHUTDOWN_BUDGET_MS` in `client.py`.\n */\nexport const SHUTDOWN_BUDGET_MS = 5000;\n\n/**\n * The `transport_refused` warning is rate-limited to the exporter's existing\n * window (`exporters/http.ts`), so a flaky network cannot spam customer logs.\n * The `shutdown_residue` warning is NOT rate-limited (RULING §5): it fires at\n * most once per process lifetime by construction, so a window buys nothing and\n * would suppress the only signal in any process that had already warned about\n * the breaker — exactly the correlated case where the customer most needs it.\n */\nconst REFUSAL_WARN_WINDOW_MS = 300_000;\n\n/**\n * SDK-RELEASE-RULING.md §4.3 — the default batch size, raised 100 -> 500.\n *\n * DERIVED, not picked. `shutdown()`'s drain is strictly serial — one export per\n * round-trip — so the most it can save is\n * ceiling = floor((budget - reserve) / RTT) x batchSize\n * and the requirement is that it drain the SDK's OWN maximum queue\n * (`maxQueueSize` = 10,000, the most it can ever be holding) at the design\n * target RTT = 100 ms:\n * batchSize >= 10,000 x RTT / (5,000 - 100) -> 204 at 100 ms, 510 at 250 ms\n * 500 satisfies it to the 250 ms trans-Pacific tail and sits 1.55x under the\n * ceiling the gateway's attribute-product cap imposes (below).\n *\n * ⚠ NEITHER THIS NOR THE BUDGET IS SUFFICIENT ALONE — measured, ruling §2. At\n * 100 ms RTT: budget alone leaves 51 % lost, batch alone leaves 60 % lost at the\n * tail, both together lose nothing. Do not \"simplify\" one back.\n *\n * Mirrors `DEFAULT_BATCH_SIZE` in `exporters/batch.py` — the two SDKs must end\n * with the same contract.\n */\nexport const DEFAULT_BATCH_SIZE = 500;\n\n/**\n * The gateway refuses a request whose summed attribute count exceeds this\n * (`MAX_ATTRIBUTE_PAIRS_PER_REQUEST`, `handlers/ingest.rs`, F-ACKRSV-001) —\n * WHOLE request, never truncated, and the exporter treats that 4xx as a\n * failure, retries it futilely and finally discards the batch as\n * `transport_refused`. The cap is `sum(span.attributes.length)`, i.e. LINEAR in\n * batch size: at batch B a customer is refused above `24,000 / B` attributes\n * per span — 240 at B=100, but only 48 at B=500.\n *\n * Without this bound, raising the default would silently break every customer\n * between those two densities: accepted today, whole-request-refused tomorrow,\n * with no action on their part. So the batch is bounded on BOTH axes, and the\n * raise becomes strictly no-worse-than-today on the attribute axis.\n *\n * ⚠ COUPLING, DECLARED (ruling §4.5) — AND THE DIRECTIONS ARE NOT SYMMETRIC.\n * ⚠ CORRECTED 2026-07-27 (F-SDKBYTES-001 §4.1). This comment used to read\n * \"Stale in either direction is SAFE — too low means slightly smaller batches,\n * too high means the gateway refuses exactly as it does today.\" The second half\n * is FALSE, and the error mattered because it licenses a unilateral change on\n * the gateway side that this SDK cannot survive:\n *\n * • STALE LOW (SDK constant < gateway cap) — SAFE, unconditionally. The SDK\n * assembles smaller batches than it needed to; every one is accepted.\n * • STALE HIGH (SDK constant > gateway cap) — safe ONLY while the gateway's\n * cap does not DECREASE. If it is lowered, this SDK assembles batches the\n * gateway now refuses: requests that are accepted TODAY begin returning\n * 4xx, the exporter retries each one futilely and discards the whole batch\n * as `transport_refused`. That is a NEW refusal caused by the mismatch —\n * not \"exactly as it does today\".\n *\n * ⇒ RAISING the gateway cap is safe to do unilaterally. LOWERING it is not: the\n * SDK constant must move first and be adopted, and `F-SDKVER-001` records\n * that nothing pins or even observes an SDK version server-side, so \"adopted\"\n * is weeks-to-never rather than a deploy.\n *\n * The gateway remains the enforcer; this only stops OUR DEFAULT from moving a\n * customer across ITS boundary.\n */\nexport const MAX_ATTRIBUTE_PAIRS_PER_BATCH = 24_000;\n\n/**\n * The per-batch SERIALIZED-BYTE bound (F-SDKBYTES-001) — the third axis.\n *\n * `SDK-RELEASE-RULING.md` §4.5 bounded the batch on span COUNT and attribute\n * PRODUCT and explicitly left BYTES open: \"a customer putting a 1 MB string in\n * an attribute can exceed the body limit at *any* batch size, and B=500 makes\n * it 5x more reachable. I did not guard this.\"\n *\n * MEASURED (`perf/sdk_batch_byte_ceiling_probe.py`, raw\n * `perf/sdk-batch-byte-ceiling.json`; its JS cross-check arm compiles\n * `src/span.ts` itself rather than trusting `dist/`):\n *\n * batch=500 crosses max_body_size (10,485,760 B) at 20,971 B/span\n * batch=100 crosses it at 104,857 B/span\n *\n * and the ruling's \"16x headroom\" quoted only the measured FLOOR. Against the\n * measured MAXIMUM realistic span (13,487 B) a 500-span batch is 6,743,500 B —\n * 1.55x headroom, not 16x. The count raise spent most of the byte margin.\n *\n * WITHOUT IT, MEASURED (probe ARM 2): the gateway answers 413, and the exporter\n * does NOT treat 413 as permanent — `http.ts` maps every non-2xx that is not\n * 408/504 to FAILURE and retries it. On a permanently-413 batch: 12 HTTP\n * requests (4 re-queue rounds x 3 exporter attempts), then the ENTIRE batch\n * discarded as `transport_refused`. Counted and warned — but total loss.\n *\n * THE ESTIMATE, AND WHICH WAY IT ERRS. Serialized size is not knowable without\n * serializing, and serializing to measure would double the export cost. So the\n * batch is bounded on an ESTIMATE:\n *\n * string -> 2 + utf8ByteLength(s), the bytes `fetch` will send for\n * the raw characters\n * number/bool/null -> a fixed allowance; containers recurse to depth 4\n * anything else -> a fixed allowance (see `EST_OPAQUE_VALUE_BYTES`)\n *\n * ⚠ ASYMMETRY WITH PYTHON, DELIBERATE. Each SDK estimates against ITS OWN\n * encoder. `JSON.stringify` emits non-ASCII RAW (UTF-8 on the wire);\n * `json.dumps` escapes it to `\\uXXXX`. Measured: a 9,525-char CJK attribute is\n * 28,859 B from JS and ~2x that from Python. Mirroring Python's per-character\n * multiplier here would over-estimate every non-ASCII JS batch by ~4x.\n *\n * ⚠ THE ONE UNDER-ESTIMATE, NAMED: JSON escaping. A `\"` costs 2 bytes and a\n * control character 6; `utf8ByteLength` charges 1 for each. The 20 % margin\n * below is what absorbs it — a batch may be up to ~25 % escape characters BY\n * COUNT before the estimate stops covering the real body. Past that the gateway\n * refuses, exactly as it does today: no new failure mode, the bound is simply\n * not helping. Stated rather than engineered away because counting escapes is a\n * second O(bytes) scan.\n *\n * THE FRACTION: 8 MiB is 80 % of the gateway's 10 MiB default. Below it the\n * measured realistic corpus does not bind at batch 500 (1.24x under this\n * budget); above it, the 20 % is the escape margin.\n *\n * ⚠ COUPLING, DECLARED, with the SAME asymmetry as the attribute cap above:\n * stale LOW is unconditionally safe; stale HIGH is safe only while\n * `max_body_size` does not DECREASE.\n */\nexport const MAX_BATCH_BYTES = 8 * 1024 * 1024; // 8,388,608 B = 80 % of max_body_size\n\nconst SPAN_ENVELOPE_BYTES = 512; // typed camelCase fields; a minimal span is ~250 B\nconst CHILD_ENVELOPE_BYTES = 128; // per event / link, before its strings\nconst SCALAR_BYTES = 24; // widest JSON number repr\nconst LITERAL_BYTES = 5; // \"false\" / \"null\"\nconst EST_MAX_DEPTH = 4;\n/**\n * Charge for a value the ladder cannot walk (a class instance, a Map, anything\n * past `EST_MAX_DEPTH`). ⚠ Unlike Python — whose `_coerce_attribute_value`\n * truncates its `str()` fallback at 4,096 chars, making the same charge there a\n * genuine BOUND — JS has no truncation at all (`F-SDKATTRLEN-001`), so this is\n * an ALLOWANCE and a deeply-nested object can exceed it. The gateway refuses\n * that shape exactly as it does today.\n */\nconst EST_OPAQUE_VALUE_BYTES = 4_096;\n\n/**\n * UTF-8 byte length, without allocating the encoded copy.\n *\n * `Buffer.byteLength` is a single native scan and is what `fetch` will actually\n * put on the wire for the raw characters. The fallback multiplier 3 is a true\n * upper bound on UTF-8 bytes per UTF-16 code unit (a BMP code point is 1 unit\n * and at most 3 bytes; an astral one is 2 units and 4 bytes, i.e. 2 per unit),\n * so a Buffer-less runtime errs HIGH rather than low.\n */\nconst utf8ByteLength: (s: string) => number =\n typeof Buffer !== 'undefined' && typeof Buffer.byteLength === 'function'\n ? (s) => Buffer.byteLength(s, 'utf8')\n : (s) => s.length * 3;\n\nfunction estStringBytes(s: string): number {\n return 2 + utf8ByteLength(s);\n}\n\nfunction estValueBytes(v: unknown, depth = 0): number {\n if (typeof v === 'string') return estStringBytes(v);\n if (v === null || v === undefined || typeof v === 'boolean') return LITERAL_BYTES;\n if (typeof v === 'number' || typeof v === 'bigint') return SCALAR_BYTES;\n if (Array.isArray(v) && depth < EST_MAX_DEPTH) {\n let total = 2 + Math.max(0, v.length - 1);\n for (const item of v) total += estValueBytes(item, depth + 1);\n return total;\n }\n if (\n typeof v === 'object' &&\n depth < EST_MAX_DEPTH &&\n Object.getPrototypeOf(v as object) === Object.prototype\n ) {\n let total = 2;\n for (const [k, val] of Object.entries(v as Record<string, unknown>)) {\n total += estStringBytes(k) + 2 + estValueBytes(val, depth + 1);\n }\n return total;\n }\n return EST_OPAQUE_VALUE_BYTES;\n}\n\nfunction estMappingBytes(m: Record<string, unknown>): number {\n let total = 0;\n for (const [k, v] of Object.entries(m)) total += estStringBytes(k) + 2 + estValueBytes(v);\n return total;\n}\n\n/**\n * Estimated serialized bytes this span contributes to a request body, or the\n * fixed envelope if the object is not span-shaped.\n *\n * ⚠ Defensive in exactly the shape `spanAttrCount` is, and for the same reason:\n * TypeScript types `_queue` as `Span[]`, but nothing stops a JS caller or a test\n * double from queueing something else. Throwing from inside the export path\n * would break export for the whole batch. On any surprise this returns the\n * envelope, which can only make the bound LESS binding — never more, and never\n * a wedge.\n */\nfunction spanBytesEstimate(span: Span): number {\n try {\n const s = span as unknown as Record<string, unknown>;\n let total = SPAN_ENVELOPE_BYTES;\n for (const field of ['name', 'statusMessage'] as const) {\n if (typeof s[field] === 'string') total += estStringBytes(s[field] as string);\n }\n const attrs = s.attributes;\n if (attrs != null && typeof attrs === 'object' && !Array.isArray(attrs)) {\n total += estMappingBytes(attrs as Record<string, unknown>);\n }\n for (const key of ['events', 'links'] as const) {\n const coll = s[key];\n if (!Array.isArray(coll)) continue;\n for (const child of coll) {\n total += CHILD_ENVELOPE_BYTES;\n const ca = (child as Record<string, unknown> | null)?.attributes;\n if (ca != null && typeof ca === 'object' && !Array.isArray(ca)) {\n total += estMappingBytes(ca as Record<string, unknown>);\n }\n }\n }\n return total;\n } catch {\n return SPAN_ENVELOPE_BYTES;\n }\n}\n\n/**\n * Attribute count for the per-batch product bound, or 0 if unknowable.\n *\n * ⚠ Defensive for the same reason the Python `_span_attr_count` is: TypeScript\n * types `_queue` as `Span[]`, but nothing stops a JS caller (or a test double)\n * from queueing an object without `attributes`. Reading `.length` off\n * `undefined` would throw from inside the export path and break export for the\n * whole batch. An object with no countable attributes contributes 0, which can\n * only make the bound less binding, never more.\n */\nfunction spanAttrCount(span: Span): number {\n const attrs = (span as { attributes?: unknown }).attributes;\n if (attrs == null) return 0;\n if (attrs instanceof Map) return attrs.size;\n if (typeof attrs === 'object') return Object.keys(attrs as object).length;\n return 0;\n}\n\nexport class BatchSpanProcessor {\n private readonly _exporters: SpanExporter[];\n private readonly _batchSize: number;\n private readonly _batchTimeoutMs: number;\n private readonly _maxQueueSize: number;\n // ⚠ NO `_debug` FIELD. It existed, was assigned, and was read by NOTHING —\n // `tsc --noEmit` had been RED on this package at HEAD for it (TS6133), which\n // survived because `ci-local.sh` runs this package's vitest and never its\n // typecheck, and `prepublishOnly` runs `build && test` — also no typecheck.\n // Filed F-SDKJSTYPECHECK-001. Debug output here is gated globally by\n // `setDebug()` in `../utils/log.ts`, so a per-processor flag was always\n // redundant; Python's `self._debug` exists because `logging` has no such\n // global switch.\n\n private _queue: Span[] = [];\n private _timer: ReturnType<typeof setInterval> | null = null;\n private _started = false;\n private _flushing = false;\n private _beforeExitHandler: (() => void) | null = null;\n\n // Retry tracking for failed batches (Audit #5)\n private _retryCounts = new Map<string, number>();\n private static readonly MAX_RETRIES = 3;\n\n private _lastRefusalWarnAt = Number.NEGATIVE_INFINITY;\n\n // ── Masking (see `../masking.ts`) ──────────────────────────────────────────\n private readonly _mask: MaskFn | undefined;\n // ── Content capture gate (see `../masking.ts`) ─────────────────────────────\n // Fail-closed: an unspecified value means \"do not capture\". This is the ONE\n // place the gate runs for BOTH content paths — provider capture AND hand-set\n // attributes — so it must not be conditional on anything a caller might\n // forget to pass. Python twin: `BatchSpanProcessor._trace_content`.\n private readonly _traceContent: boolean;\n private _lastMaskWarnAt = Number.NEGATIVE_INFINITY;\n private _lastSlowMaskWarnAt = Number.NEGATIVE_INFINITY;\n\n // Metrics\n /** DEPRECATED flat total. Retained as the exact SUM of\n * `droppedSpansByReason` so existing readers keep working (RULING §5\n * back-compat — the same deprecate-and-alias shape this codebase used for\n * `complete`->`settled` and `spans_flushed_total`). Prefer the labelled\n * record: one integer cannot tell an under-provisioned queue from a dead\n * gateway from a redeploy. */\n droppedSpans = 0;\n droppedSpansByReason: Record<DropReason, number> = {\n queue_full: 0,\n transport_refused: 0,\n shutdown_residue: 0,\n };\n exportedSpans = 0;\n /** Export ATTEMPTS, not a span count. */\n failedExports = 0;\n /**\n * Fields whose mask callback threw and were replaced with\n * `MASK_ERROR_MARKER`. A FIELD count, not a span count — one span can\n * contribute several. Non-zero means those fields carry a marker instead of\n * data: a customer-code bug, not a transport one.\n */\n maskErrors = 0;\n\n constructor(options: BatchProcessorOptions) {\n this._exporters = [...options.exporters];\n\n // batchSize: clamp to [1, 10000] AND warn on out-of-range — silent\n // clamping is a debugging tar pit (CON-257 / P1-3). Mirrors Python.\n const requestedBatchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;\n const clampedBatchSize = Math.max(1, Math.min(requestedBatchSize, 10_000));\n if (clampedBatchSize !== requestedBatchSize) {\n warn(\n `batchSize=${requestedBatchSize} is outside the allowed range [1, 10000]; clamping to ${clampedBatchSize}`,\n );\n }\n this._batchSize = clampedBatchSize;\n\n this._batchTimeoutMs = options.batchTimeoutMs ?? 1000;\n this._maxQueueSize = options.maxQueueSize ?? 10000;\n this._mask = options.mask;\n this._traceContent = options.traceContent ?? false;\n }\n\n start(): void {\n if (this._started) return;\n this._started = true;\n\n // Periodic flush timer — unref so it doesn't keep process alive\n this._timer = setInterval(() => {\n void this._exportBatch();\n }, this._batchTimeoutMs);\n this._timer.unref();\n\n // Flush on process exit (Audit #3: use .once, not .on; await, not void)\n this._beforeExitHandler = () => {\n void this.shutdown();\n };\n process.once('beforeExit', this._beforeExitHandler);\n }\n\n /** Record `count` discarded spans under `reason`.\n *\n * `droppedSpans` is maintained as the exact sum of the labelled counters\n * (RULING §5 back-compat), so the locked pins — which read the flat\n * integer — stay meaningful. */\n private _recordDropped(reason: DropReason, count = 1): void {\n this.droppedSpans += count;\n this.droppedSpansByReason[reason] += count;\n }\n\n /**\n * Run the customer mask over a batch, in place. Never throws.\n *\n * Failure semantics are ruled in `../masking.ts`: a field whose mask throws\n * becomes `MASK_ERROR_MARKER` and the span is kept. The counter is per FIELD;\n * both warnings are rate-limited to one per window so a mask that throws on\n * every span cannot flood the customer's logs — the same shape as the\n * transport-refusal warning above.\n */\n private _applyMask(batch: Span[]): void {\n const mask = this._mask;\n if (mask === undefined) return;\n\n const { errors, elapsedMs } = applyMaskBatch(batch, mask);\n const now = Date.now();\n\n if (errors > 0) {\n this.maskErrors += errors;\n if (now - this._lastMaskWarnAt > MASK_WARN_WINDOW_MS) {\n this._lastMaskWarnAt = now;\n warnMaskErrors(errors, this.maskErrors);\n }\n }\n\n if (\n elapsedMs > MASK_BUDGET_MS_PER_SPAN * batch.length &&\n now - this._lastSlowMaskWarnAt > MASK_WARN_WINDOW_MS\n ) {\n this._lastSlowMaskWarnAt = now;\n warnMaskSlow(batch.length, elapsedMs);\n }\n }\n\n /**\n * Drain what we hold, or name what we could not (F-SDKDRAIN-001).\n *\n * Per RULING §4 (option E, hard-bounded) the drain loops until ONE of: the\n * queue is empty; the deadline expires; or a full round completes with no\n * exporter returning SUCCESS.\n *\n * ⚠ The `_flushing` handling is load-bearing, and `SDKDRAIN_JS_004` exists\n * to catch its absence. `_exportBatch()` returns immediately when an export\n * is already in flight (`:171`), so a loop that merely calls it again makes\n * NO progress and abandons the queue exactly as before — measured at 900 of\n * 1,000. We await a tick instead, the shape `flush()` already models.\n *\n * Anything still queued when the loop stops is COUNTED as `shutdown_residue`\n * and announced with a WARNING. The warning is the primary signal, not the\n * counter: a counter incremented inside `shutdown()` is written to memory\n * about to be freed and has no reader (RULING §2 / §8.2).\n */\n async shutdown(timeoutMs = SHUTDOWN_BUDGET_MS): Promise<void> {\n if (!this._started) return;\n this._started = false;\n\n if (this._timer) {\n clearInterval(this._timer);\n this._timer = null;\n }\n\n // Remove process listener to prevent leak (Audit #3)\n if (this._beforeExitHandler) {\n process.removeListener('beforeExit', this._beforeExitHandler);\n this._beforeExitHandler = null;\n }\n\n // Halve rather than underflow on a tiny budget: shutdown(200) still gets\n // 100 ms of drain instead of none.\n const reserveMs = Math.min(SHUTDOWN_RESERVE_MS, timeoutMs / 2);\n const drainDeadline = Date.now() + Math.max(0, timeoutMs - reserveMs);\n\n while (this._queue.length > 0 || this._flushing) {\n if (Date.now() >= drainDeadline) break;\n const outcome = await this._exportBatch();\n if (outcome === Round.Busy) {\n // An export is mid-await. Yield rather than spin on a no-op call.\n await new Promise((r) => setTimeout(r, 1));\n continue;\n }\n if (outcome !== Round.Delivered) {\n // Empty -> nothing left, we are done.\n // Failed -> no exporter accepted this round; a further round cannot\n // help and would spin to the deadline on precisely the path\n // where there is nothing to save.\n break;\n }\n }\n\n // Once shutdown() has returned, holding IS abandoning: the timer is\n // cleared, the exit listener is gone, nothing will ever export these.\n const residue = this._queue.length;\n if (residue > 0) {\n this._queue.length = 0;\n this._recordDropped('shutdown_residue', residue);\n // NOT rate-limited, by ruling. Names the count AND the reason.\n warn(\n `shutdown() gave up with ${residue} span(s) still queued ` +\n `(reason=shutdown_residue) — they were NOT delivered. The ${timeoutMs} ms ` +\n `shutdown budget expired or the transport stopped accepting. Raise the ` +\n `shutdown timeout, or your container's termination grace period, to lose less.`\n );\n }\n\n // Shutdown exporters\n for (const exporter of this._exporters) {\n try {\n await exporter.shutdown();\n } catch (e) {\n debug(`Error shutting down ${exporter.name}: ${e}`);\n }\n }\n\n // Clean up retry tracking — retry-map drain site 3 of 3\n this._retryCounts.clear();\n\n debug(\n `BatchSpanProcessor shutdown. Exported: ${this.exportedSpans}, ` +\n `Dropped: ${this.droppedSpans}, Failed: ${this.failedExports}`\n );\n }\n\n onSpanEnd(span: Span): void {\n if (!this._started) return;\n\n // Check queue capacity\n if (this._queue.length >= this._maxQueueSize) {\n this._recordDropped('queue_full');\n if (this.droppedSpans === 1 || this.droppedSpans % 1000 === 0) {\n warn(`Span queue full (${this._maxQueueSize}). ${this.droppedSpans} spans dropped so far.`);\n }\n return;\n }\n\n this._queue.push(span);\n\n // Trigger immediate flush if batch size reached\n if (this._queue.length >= this._batchSize) {\n void this._exportBatch();\n }\n }\n\n /**\n * Flush pending spans.\n *\n * @returns `true` only if everything queued at entry was DELIVERED.\n *\n * RULING §6. This used to answer a different question — \"is the queue\n * empty?\" — and those two diverge in exactly one case: when spans left the\n * queue WITHOUT reaching the transport. That case is the entire finding. A\n * customer who calls `flush()` before exit and gets `true` has done\n * everything right; silence lets them discover the problem, a false\n * affirmative forecloses it.\n *\n * Returns `false` when (a) the deadline expires with spans still queued,\n * (b) any span was discarded during the window — breaker refusal or retry\n * exhaustion — or (c) it is called after `shutdown()` and the shutdown\n * residue was non-zero.\n *\n * ⚠ (b) reads the flat total, so a concurrent `queue_full` drop of a span\n * that arrived DURING the window also answers `false`. That is the\n * conservative direction on purpose: a false negative costs a caller one\n * more flush, a false positive is the defect being fixed.\n */\n async flush(timeoutMs = SHUTDOWN_BUDGET_MS): Promise<boolean> {\n if (!this._started) {\n // (c) — the `!_started => true` early return was unconditional, so\n // `flush()` after `shutdown()` reported success over abandoned data.\n return this._queue.length === 0 && this.droppedSpansByReason.shutdown_residue === 0;\n }\n\n const start = Date.now();\n const discardedAtEntry = this.droppedSpans;\n\n // Wait for in-flight exports to complete AND queue to drain\n while (this._queue.length > 0 || this._flushing) {\n if (!this._flushing && this._queue.length > 0) {\n await this._exportBatch();\n } else {\n // Wait a tick for the in-flight export to finish\n await new Promise((r) => setTimeout(r, 1));\n }\n if (Date.now() - start > timeoutMs) return false;\n }\n\n return this.droppedSpans === discardedAtEntry;\n }\n\n getMetrics() {\n return {\n exportedSpans: this.exportedSpans,\n droppedSpans: this.droppedSpans,\n droppedSpansByReason: { ...this.droppedSpansByReason },\n failedExports: this.failedExports,\n maskErrors: this.maskErrors,\n queueSize: this._queue.length,\n queueCapacity: this._maxQueueSize,\n queueUtilization: this._queue.length / this._maxQueueSize,\n };\n }\n\n private async _exportBatch(): Promise<Round> {\n if (this._flushing) return Round.Busy;\n if (this._queue.length === 0) return Round.Empty;\n this._flushing = true;\n\n try {\n // Take up to batchSize spans — AND up to the attribute-product bound, AND\n // up to the serialized-byte bound; whichever binds first\n // (SDK-RELEASE-RULING.md §4.5 + F-SDKBYTES-001). `batchSize` is a CEILING,\n // not a fixed size, on all three axes.\n //\n // Take-at-least-one is unconditional on every axis: a single span that\n // alone exceeded a bound would otherwise be taken by no round ever,\n // wedging the queue permanently. One over-cap span is the gateway's\n // problem to refuse and the retry budget's to count; a wedged queue would\n // be ours forever.\n let take = 0;\n let pairs = 0;\n let nbytes = 0;\n const limit = Math.min(this._batchSize, this._queue.length);\n while (take < limit) {\n const head = this._queue[take];\n const spanPairs = spanAttrCount(head);\n const spanBytes = spanBytesEstimate(head);\n if (\n take > 0 &&\n (pairs + spanPairs > MAX_ATTRIBUTE_PAIRS_PER_BATCH ||\n nbytes + spanBytes > MAX_BATCH_BYTES)\n ) {\n break;\n }\n pairs += spanPairs;\n nbytes += spanBytes;\n take++;\n }\n const batch = this._queue.splice(0, take);\n if (batch.length === 0) return Round.Empty;\n\n // ⚠ MASK HERE — after the batch is off the queue, before any exporter.\n //\n // WHY NOT in `onSpanEnd()`: that runs on the call that ended the span,\n // i.e. inside the customer's own request path. This site is at least on\n // the export turn.\n //\n // ⚠ AND WHY THAT IS A WEAKER GUARANTEE THAN PYTHON'S: Node has one\n // thread. Python's mask runs on a background worker and costs only drain\n // rate; this one blocks the event loop for its duration. The budget\n // warning below is the whole of the protection, and it is a warning.\n //\n // ⚠ DECLARED RIPPLE, same as Python: the attribute-product and byte\n // bounds above are computed on PRE-mask values. Redaction shrinks, so the\n // estimate stays conservative for every realistic mask; a mask that GROWS\n // content can push the real body past the estimate, which the estimate\n // already declares for ASCII escaping and already answers the same way —\n // the gateway remains the enforcer.\n // ⚠ STRIP BEFORE MASK, and unconditionally when capture is off.\n //\n // Before mask because content the customer never wanted to leave the\n // process should not be handed to a customer callback either — and\n // because a mask never called over a stripped field costs nothing, which\n // matters more here than in Python: this runs on the ONE event loop.\n //\n // Unconditional (not `if this._mask !== undefined`) because THIS is the\n // gate: `_applyMask` runs only when a mask was supplied, and the whole\n // defect being closed is that content escaped when nobody had opted into\n // anything.\n if (!this._traceContent) {\n const stripped = stripContentBatch(batch);\n if (stripped > 0) {\n debug(\n `traceContent is off — omitted ${stripped} content field(s) from ${batch.length} span(s)`,\n );\n }\n }\n\n if (this._mask !== undefined) {\n this._applyMask(batch);\n }\n\n debug(`Exporting batch of ${batch.length} spans`);\n\n // Export to all exporters — count once, not per exporter\n let batchExported = false;\n for (const exporter of this._exporters) {\n try {\n const result = await exporter.export(batch);\n if (result === ExportResult.SUCCESS) {\n if (!batchExported) {\n this.exportedSpans += batch.length;\n batchExported = true;\n // Clear retry counts for successfully exported spans\n for (const span of batch) {\n this._retryCounts.delete(span.spanId);\n }\n }\n } else {\n this.failedExports++;\n }\n } catch (e) {\n this.failedExports++;\n debug(`Export to ${exporter.name} failed: ${e}`);\n }\n }\n\n // Audit #5: Re-queue failed batches with retry limit\n if (!batchExported) {\n let dropped = 0;\n const retryable = batch.filter(span => {\n const count = (this._retryCounts.get(span.spanId) ?? 0) + 1;\n if (count > BatchSpanProcessor.MAX_RETRIES) {\n // retry-map drain site 2 of 3\n this._retryCounts.delete(span.spanId);\n // The count is once per SPAN IDENTITY, at exhaustion — never once\n // per attempt. A span re-queued twice and then dropped is ONE lost\n // span; keying on spanId is what makes that true.\n this._recordDropped('transport_refused');\n dropped++;\n return false;\n }\n this._retryCounts.set(span.spanId, count);\n return true;\n });\n if (retryable.length > 0) {\n this._queue.unshift(...retryable);\n debug(`Re-queued ${retryable.length} spans for retry (${batch.length - retryable.length} dropped after max retries)`);\n }\n if (dropped > 0) {\n // RULING §2: the PRIMARY remedy is a default-visible WARNING at the\n // moment of discard, naming the count and the reason — not a counter.\n // The log line survives the process; the counter does not, and on the\n // shutdown path there is no reader for it at all. `debug()` above is\n // suppressed at default level, which is why this is `warn()`.\n const now = Date.now();\n if (now - this._lastRefusalWarnAt > REFUSAL_WARN_WINDOW_MS) {\n this._lastRefusalWarnAt = now;\n warn(\n `${dropped} span(s) DISCARDED (reason=transport_refused) after ` +\n `${BatchSpanProcessor.MAX_RETRIES} failed export attempts each — the endpoint is ` +\n `not accepting spans and the retry budget is spent. ` +\n `${this.droppedSpansByReason.transport_refused} span(s) discarded this way so far ` +\n `in this process. This data is gone; check the apiKey and the endpoint.`\n );\n }\n }\n }\n return batchExported ? Round.Delivered : Round.Failed;\n } finally {\n this._flushing = false;\n }\n }\n}\n","/**\n * SDK configuration with environment variable loading.\n *\n * Environment variables match the Python SDK exactly:\n * RISICARE_API_KEY, RISICARE_ENDPOINT, RISICARE_PROJECT_ID, etc.\n */\n\nimport { DEFAULT_BATCH_SIZE } from './exporters/batch.js';\nimport type { MaskFn } from './masking.js';\n\nexport interface RisicareConfig {\n /** API key for authentication (format: \"rsk-{random}\"). Each key is scoped to one project. */\n apiKey?: string;\n\n /** Gateway endpoint URL */\n endpoint?: string;\n\n /**\n * @deprecated Project is determined by your API key. This field is ignored\n * by the gateway and will be removed in v1.0. Use `serviceName` and\n * `environment` for within-project organization.\n */\n projectId?: string;\n\n /** Environment name (production, staging, development). Used for within-project organization. */\n environment?: string;\n\n /** Service name for within-project organization. */\n serviceName?: string;\n\n /** Service version */\n serviceVersion?: string;\n\n /** Whether tracing is enabled (default: true if apiKey provided) */\n enabled?: boolean;\n\n /**\n * Whether prompt/completion content may leave the process.\n *\n * **Default `false` since 0.5.1** (was `true`). When false, every\n * content-keyed attribute is replaced with `<risicare:content-omitted>` on\n * the export path — including content you set by hand, which 0.5.0 and\n * earlier did NOT gate.\n */\n traceContent?: boolean;\n\n /** Sample rate 0.0–1.0 (default: 1.0 = trace all) */\n sampleRate?: number;\n\n /** Batch size threshold before flush (default: 100) */\n batchSize?: number;\n\n /** Batch timeout in ms before flush (default: 1000) */\n batchTimeoutMs?: number;\n\n /** Maximum queue size (default: 10000) */\n maxQueueSize?: number;\n\n /** Enable debug logging (default: false) */\n debug?: boolean;\n\n /** Enable gzip compression for HTTP exports (default: false) */\n compress?: boolean;\n\n /** Custom metadata attached to all spans */\n metadata?: Record<string, unknown>;\n\n /**\n * Masking callback applied to every content-bearing field of every span\n * BEFORE the batch leaves the process — `mask(key, value) => value`.\n *\n * This is the only layer at which you can keep data off Risicare's wire, so\n * it applies to every exporter, including custom ones. `key` is the attribute\n * key (`\"gen_ai.prompt.0.content\"`) or a dotted path (`\"statusMessage\"`,\n * `\"events.0.attributes.x\"`). Identifiers and span/event names are NOT passed\n * to it — masking those breaks trace structure and your own joins.\n *\n * ⚠ Must be CPU-only and fast: Node is single-threaded, so this runs on your\n * event loop. No I/O, no network, no unbounded retries, no per-request state.\n * If it throws, that one field becomes `\"<risicare:mask-error>\"` and the span\n * is still exported. See `masking.ts`.\n *\n * ⚠ Has NO environment-variable form, deliberately: the shapes that would\n * make a callable env-resolvable are arbitrary code execution driven by the\n * process environment. Masking is configured in code, by the application that\n * owns the data.\n */\n mask?: MaskFn;\n}\n\nconst DEFAULT_ENDPOINT = 'https://app.risicare.ai';\n\n/**\n * Load configuration from environment variables, merged with explicit config.\n * Explicit config takes precedence over env vars.\n */\nexport function resolveConfig(\n config?: Partial<RisicareConfig>,\n): Required<Omit<RisicareConfig, 'metadata' | 'mask'>> & {\n metadata: Record<string, unknown>;\n // `mask` is excluded from `Required<>` on purpose: \"no mask\" is a real,\n // supported state and must stay expressible as `undefined`. Defaulting it to\n // an identity function would make \"is masking configured?\" unanswerable by\n // inspection — the processor skips the whole pass when this is undefined.\n mask: MaskFn | undefined;\n} {\n const env = process.env;\n\n const apiKey = config?.apiKey ?? env.RISICARE_API_KEY;\n const endpoint = config?.endpoint ?? env.RISICARE_ENDPOINT ?? DEFAULT_ENDPOINT;\n const projectId = config?.projectId ?? env.RISICARE_PROJECT_ID;\n\n // Deprecation warning for projectId\n if (config?.projectId || env.RISICARE_PROJECT_ID) {\n console.warn(\n '[risicare] projectId is deprecated and ignored by the gateway. ' +\n 'Your API key determines the project. ' +\n 'Use serviceName and environment for within-project organization. ' +\n 'projectId will be removed in v1.0.'\n );\n }\n const environment = config?.environment ?? env.RISICARE_ENVIRONMENT ?? 'development';\n const serviceName = config?.serviceName ?? env.RISICARE_SERVICE_NAME;\n const serviceVersion = config?.serviceVersion ?? env.RISICARE_SERVICE_VERSION;\n // ⚠ DEFAULT CHANGED 0.5.0 -> 0.5.1: was `true`. `RISICARE_TRACE_CONTENT=true`\n // (or `traceContent: true`) restores capture explicitly.\n const traceContent = config?.traceContent ?? parseBool(env.RISICARE_TRACE_CONTENT, false);\n const sampleRateRaw = config?.sampleRate ?? parseFloat(env.RISICARE_SAMPLE_RATE ?? '1.0');\n const debug = config?.debug ?? parseBool(env.RISICARE_DEBUG, false);\n const compress = config?.compress ?? parseBool(env.RISICARE_COMPRESS, false);\n // SDK-RELEASE-RULING.md §4.3: default raised 100 -> 500. Derived, and stated\n // once in `exporters/batch.ts` — imported rather than repeated so the env\n // default and the validation default cannot drift apart from the processor's.\n const batchSizeRaw = config?.batchSize ?? parseNumericEnv(env.RISICARE_BATCH_SIZE, DEFAULT_BATCH_SIZE);\n const batchTimeoutMsRaw = config?.batchTimeoutMs ?? parseNumericEnv(env.RISICARE_BATCH_TIMEOUT_MS, 1000);\n const maxQueueSizeRaw = config?.maxQueueSize ?? parseNumericEnv(env.RISICARE_MAX_QUEUE_SIZE, 10000);\n\n // F-355/F-356/F-357: numeric inputs must validate, clamp, and warn —\n // silent NaN/negative/string acceptance breaks the exporter unpredictably.\n const sampleRate = validateSampleRate(sampleRateRaw);\n // F-SDKSAMPRATEBLIND-001 — the rate never reaches the platform, so say so at\n // the one moment the customer chose it. Verified 2026-08-17 across 539\n // first-party server / worker / dashboard / gateway / schema files (controls:\n // 128 files match trace_id, 228 match project_id): no ingest field, no\n // column, no query and no W3C traceparent flag carries it — both emitters\n // hardcode `-01`, and `TraceFlags.SAMPLED` has zero call sites. So every\n // server-side count is a count of SAMPLED traces and nothing downstream can\n // scale it back up. Re-run: fix-workstream/perf/w34/sampling_wire_probe.sh\n if (sampleRate < 1.0) {\n console.warn(\n `[risicare] sampleRate=${sampleRate} — head sampling is applied in-process ` +\n `and the rate is NOT transmitted to the platform. Trace counts, error rates ` +\n `and cost figures in the dashboard will describe the sampled subset only, ` +\n `and cannot be scaled back to totals. Sampling is trace-coherent: a dropped ` +\n `trace drops whole.`,\n );\n }\n const batchSize = validatePositiveInt('batchSize', batchSizeRaw, DEFAULT_BATCH_SIZE, 1, 10_000);\n const batchTimeoutMs = validatePositiveInt('batchTimeoutMs', batchTimeoutMsRaw, 1000, 1, 600_000);\n const maxQueueSize = validatePositiveInt('maxQueueSize', maxQueueSizeRaw, 10_000, 1, 1_000_000);\n\n // Enabled logic: explicit > env RISICARE_TRACING > (true if apiKey present)\n let enabled: boolean;\n if (config?.enabled !== undefined) {\n enabled = config.enabled;\n } else if (env.RISICARE_TRACING !== undefined) {\n enabled = parseBool(env.RISICARE_TRACING, false);\n } else {\n enabled = !!apiKey;\n }\n\n return {\n apiKey: apiKey ?? '',\n endpoint,\n projectId: projectId ?? '',\n environment,\n serviceName: serviceName ?? '',\n serviceVersion: serviceVersion ?? '',\n enabled,\n traceContent,\n sampleRate,\n batchSize,\n batchTimeoutMs,\n maxQueueSize,\n debug,\n compress,\n metadata: config?.metadata ?? {},\n // No env fallback — see the field's note on RisicareConfig.\n mask: config?.mask,\n };\n}\n\nfunction parseBool(value: string | undefined, defaultValue: boolean): boolean {\n if (value === undefined) return defaultValue;\n const lower = value.toLowerCase();\n return lower === 'true' || lower === '1' || lower === 'yes';\n}\n\n/**\n * Parse a numeric env var with a fallback default. parseInt returns NaN on\n * non-numeric input — we want the default in that case, not NaN propagating.\n */\nfunction parseNumericEnv(value: string | undefined, defaultValue: number): number {\n if (value === undefined) return defaultValue;\n const n = Number(value);\n return Number.isFinite(n) ? n : defaultValue;\n}\n\n/**\n * F-355: sampleRate must be a finite number in [0, 1]. Anything else warns\n * and falls back to 1.0 (trace everything — safer default for an observability\n * platform than \"trace nothing\" on a typo).\n */\nfunction validateSampleRate(value: unknown): number {\n if (typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1) {\n return value;\n }\n // Try string→number coercion once for env vars that arrive as strings.\n if (typeof value === 'string') {\n const n = Number(value);\n if (Number.isFinite(n) && n >= 0 && n <= 1) return n;\n }\n console.warn(\n `[risicare] sampleRate must be a finite number in [0, 1], got ${typeof value}=${JSON.stringify(value)}; defaulting to 1.0`,\n );\n return 1.0;\n}\n\n/**\n * F-356/F-357: validate a positive-integer config knob. Coerces strings,\n * rejects NaN/negative/non-finite, clamps to [min, max] with a warning.\n */\nfunction validatePositiveInt(\n name: string,\n value: unknown,\n defaultValue: number,\n min: number,\n max: number,\n): number {\n let n: number;\n if (typeof value === 'number') {\n n = value;\n } else if (typeof value === 'string') {\n n = Number(value);\n if (Number.isFinite(n)) {\n console.warn(\n `[risicare] ${name} was a string (\"${value}\"); coerced to ${n}. Pass a number to avoid this warning.`,\n );\n }\n } else {\n console.warn(\n `[risicare] ${name} must be a positive integer, got ${typeof value}; defaulting to ${defaultValue}`,\n );\n return defaultValue;\n }\n if (!Number.isFinite(n) || n <= 0) {\n console.warn(\n `[risicare] ${name} must be > 0, got ${value}; defaulting to ${defaultValue}`,\n );\n return defaultValue;\n }\n if (n < min) {\n console.warn(`[risicare] ${name}=${n} below floor; clamping to ${min}`);\n return min;\n }\n if (n > max) {\n console.warn(`[risicare] ${name}=${n} above ceiling; clamping to ${max}`);\n return max;\n }\n return Math.floor(n);\n}\n","/**\n * ID generation for traces and spans.\n *\n * Trace IDs: 32 lowercase hex characters (16 random bytes)\n * Span IDs: 16 lowercase hex characters (8 random bytes)\n *\n * Uses crypto.randomBytes for cryptographically secure randomness.\n */\n\nimport { randomBytes } from 'node:crypto';\n\nconst HEX_REGEX_32 = /^[0-9a-f]{32}$/;\nconst HEX_REGEX_16 = /^[0-9a-f]{16}$/;\n\nexport function generateTraceId(): string {\n return randomBytes(16).toString('hex');\n}\n\nexport function generateSpanId(): string {\n return randomBytes(8).toString('hex');\n}\n\nexport function generateAgentId(prefix?: string): string {\n const suffix = randomBytes(8).toString('hex');\n return prefix ? `${prefix}-${suffix}` : suffix;\n}\n\nexport function validateTraceId(id: string): boolean {\n return HEX_REGEX_32.test(id);\n}\n\nexport function validateSpanId(id: string): boolean {\n return HEX_REGEX_16.test(id);\n}\n","/**\n * Core type definitions for the Risicare SDK.\n *\n * These enums and types mirror the Python SDK's risicare-core types\n * and align with the Rust gateway's SpanData struct.\n */\n\n// ─── Span Kind ───────────────────────────────────────────────────────────────\n\nexport enum SpanKind {\n INTERNAL = 'internal',\n CLIENT = 'client',\n SERVER = 'server',\n PRODUCER = 'producer',\n CONSUMER = 'consumer',\n AGENT = 'agent',\n LLM_CALL = 'llm_call',\n TOOL_CALL = 'tool_call',\n RETRIEVAL = 'retrieval',\n DECISION = 'decision',\n MESSAGE = 'message',\n DELEGATION = 'delegation',\n COORDINATION = 'coordination',\n THINK = 'think',\n DECIDE = 'decide',\n OBSERVE = 'observe',\n REFLECT = 'reflect',\n}\n\n// ─── Span Status ─────────────────────────────────────────────────────────────\n\nexport enum SpanStatus {\n UNSET = 'unset',\n OK = 'ok',\n ERROR = 'error',\n}\n\n// ─── Semantic Phase (Tier 4: Decision Tracking) ──────────────────────────────\n\nexport enum SemanticPhase {\n THINK = 'think',\n DECIDE = 'decide',\n ACT = 'act',\n OBSERVE = 'observe',\n REFLECT = 'reflect',\n COMMUNICATE = 'communicate',\n COORDINATE = 'coordinate',\n}\n\n// ─── Agent Role ──────────────────────────────────────────────────────────────\n\nexport enum AgentRole {\n // Primary roles\n ORCHESTRATOR = 'orchestrator',\n WORKER = 'worker',\n SUPERVISOR = 'supervisor',\n SPECIALIST = 'specialist',\n // Communication roles\n ROUTER = 'router',\n AGGREGATOR = 'aggregator',\n BROADCASTER = 'broadcaster',\n // Specialized roles\n CRITIC = 'critic',\n PLANNER = 'planner',\n EXECUTOR = 'executor',\n RETRIEVER = 'retriever',\n VALIDATOR = 'validator',\n // JS-specific (backwards compatibility)\n REVIEWER = 'reviewer',\n CUSTOM = 'custom',\n}\n\n// ─── Message Type (Tier 5: Multi-Agent) ──────────────────────────────────────\n\nexport enum MessageType {\n // Control messages\n TASK = 'task',\n RESULT = 'result',\n STATUS = 'status',\n ERROR = 'error',\n // Communication messages\n QUERY = 'query',\n RESPONSE = 'response',\n BROADCAST = 'broadcast',\n DIRECT = 'direct',\n // Coordination messages\n PROPOSAL = 'proposal',\n VOTE = 'vote',\n CONSENSUS = 'consensus',\n CONFLICT = 'conflict',\n // Lifecycle messages\n HEARTBEAT = 'heartbeat',\n SHUTDOWN = 'shutdown',\n HANDOFF = 'handoff',\n // JS-specific (backwards compatibility)\n REQUEST = 'request',\n DELEGATE = 'delegate',\n COORDINATE = 'coordinate',\n}\n\n// ─── Span Event ──────────────────────────────────────────────────────────────\n\nexport interface SpanEvent {\n name: string;\n timestamp: string;\n attributes?: Record<string, unknown>;\n}\n\n// ─── Span Link ───────────────────────────────────────────────────────────────\n\nexport interface SpanLink {\n traceId: string;\n spanId: string;\n attributes?: Record<string, unknown>;\n}\n\n// ─── Span Payload (Wire Format) ──────────────────────────────────────────────\n// Matches Rust gateway SpanData struct exactly (camelCase)\n\nexport interface SpanPayload {\n traceId: string;\n spanId: string;\n parentSpanId?: string;\n name: string;\n kind: string;\n startTime: string;\n endTime?: string;\n durationMs?: number;\n status: string;\n statusMessage?: string;\n attributes: Record<string, unknown>;\n events: SpanEvent[];\n links: SpanLink[];\n sessionId?: string;\n agentId?: string;\n agentName?: string;\n agentType?: string;\n semanticPhase?: string;\n llmProvider?: string;\n llmModel?: string;\n llmPromptTokens?: number;\n llmCompletionTokens?: number;\n llmTotalTokens?: number;\n llmCostUsd?: number;\n toolName?: string;\n toolSuccess?: boolean;\n}\n\n// ─── Ingest Request ──────────────────────────────────────────────────────────\n\nexport interface IngestRequest {\n spans: SpanPayload[];\n batchId?: string;\n projectId?: string;\n environment?: string;\n}\n","/**\n * High-resolution timing and ISO 8601 formatting utilities.\n */\n\n/**\n * Get current time as ISO 8601 string with millisecond precision.\n */\nexport function nowISO(): string {\n return new Date().toISOString();\n}\n\n/**\n * Get high-resolution monotonic time in milliseconds.\n * Uses process.hrtime.bigint() for sub-ms precision.\n */\nexport function hrtimeMs(): number {\n return Number(process.hrtime.bigint()) / 1_000_000;\n}\n\n/**\n * Compute duration in milliseconds between two hrtime values.\n */\nexport function durationMs(startHrtime: number, endHrtime: number): number {\n return Math.max(0, endHrtime - startHrtime);\n}\n\n/**\n * Format a Date or ISO string to ISO 8601 with millisecond precision.\n */\nexport function toISO(time: Date | string | number): string {\n if (typeof time === 'string') return time;\n if (typeof time === 'number') return new Date(time).toISOString();\n return time.toISOString();\n}\n","/**\n * Span class — the core unit of tracing.\n *\n * A span represents a single operation (LLM call, tool use, agent step).\n * Spans are mutable: attributes, events, and status can be set after creation.\n * Call end() to finalize the span and trigger export.\n */\n\nimport { generateSpanId, generateTraceId } from './ids.js';\nimport {\n SpanKind,\n SpanStatus,\n type SpanEvent,\n type SpanLink,\n type SpanPayload,\n} from './types.js';\nimport { nowISO, hrtimeMs } from './utils/clock.js';\n\nexport interface SpanOptions {\n name: string;\n kind?: SpanKind;\n traceId?: string;\n spanId?: string;\n parentSpanId?: string;\n attributes?: Record<string, unknown>;\n links?: SpanLink[];\n sessionId?: string;\n agentId?: string;\n agentName?: string;\n agentType?: string;\n semanticPhase?: string;\n}\n\nexport type SpanEndCallback = (span: Span) => void;\n\nexport class Span {\n readonly traceId: string;\n readonly spanId: string;\n readonly parentSpanId: string | undefined;\n readonly name: string;\n readonly kind: SpanKind;\n readonly startTime: string;\n readonly startHrtime: number;\n\n endTime: string | undefined;\n status: SpanStatus;\n statusMessage: string | undefined;\n attributes: Record<string, unknown>;\n events: SpanEvent[];\n links: SpanLink[];\n\n // Agent/session fields\n sessionId: string | undefined;\n agentId: string | undefined;\n agentName: string | undefined;\n agentType: string | undefined;\n semanticPhase: string | undefined;\n\n // LLM-specific fields\n llmProvider: string | undefined;\n llmModel: string | undefined;\n llmPromptTokens: number | undefined;\n llmCompletionTokens: number | undefined;\n llmTotalTokens: number | undefined;\n llmCostUsd: number | undefined;\n\n // Tool fields\n toolName: string | undefined;\n toolSuccess: boolean | undefined;\n\n private _ended = false;\n private _endHrtime: number | undefined;\n private _onEnd: SpanEndCallback | undefined;\n\n constructor(options: SpanOptions, onEnd?: SpanEndCallback) {\n this.traceId = options.traceId ?? generateTraceId();\n this.spanId = options.spanId ?? generateSpanId();\n this.parentSpanId = options.parentSpanId;\n this.name = options.name;\n this.kind = options.kind ?? SpanKind.INTERNAL;\n this.startTime = nowISO();\n this.startHrtime = hrtimeMs();\n\n this.status = SpanStatus.UNSET;\n this.attributes = options.attributes ? { ...options.attributes } : {};\n this.events = [];\n this.links = options.links ? [...options.links] : [];\n\n this.sessionId = options.sessionId;\n this.agentId = options.agentId;\n this.agentName = options.agentName;\n this.agentType = options.agentType;\n this.semanticPhase = options.semanticPhase;\n\n this._onEnd = onEnd;\n }\n\n get isEnded(): boolean {\n return this._ended;\n }\n\n get durationMs(): number {\n if (this._ended && this._endHrtime !== undefined) {\n return this._endHrtime - this.startHrtime;\n }\n return hrtimeMs() - this.startHrtime;\n }\n\n setAttribute(key: string, value: unknown): this {\n if (this._ended) return this;\n this.attributes[key] = value;\n return this;\n }\n\n setAttributes(attrs: Record<string, unknown>): this {\n if (this._ended) return this;\n Object.assign(this.attributes, attrs);\n return this;\n }\n\n setStatus(status: SpanStatus, message?: string): this {\n if (this._ended) return this;\n this.status = status;\n if (message !== undefined) {\n this.statusMessage = message;\n }\n return this;\n }\n\n addEvent(name: string, attributes?: Record<string, unknown>): this {\n if (this._ended) return this;\n this.events.push({\n name,\n timestamp: nowISO(),\n attributes,\n });\n return this;\n }\n\n addLink(traceId: string, spanId: string, attributes?: Record<string, unknown>): this {\n if (this._ended) return this;\n this.links.push({ traceId, spanId, attributes });\n return this;\n }\n\n recordException(error: Error | string): this {\n if (this._ended) return this;\n\n const message = typeof error === 'string' ? error : error.message;\n const stack = typeof error === 'string' ? undefined : error.stack;\n\n this.setStatus(SpanStatus.ERROR, message);\n this.addEvent('exception', {\n 'exception.type': typeof error === 'string' ? 'Error' : error.constructor.name,\n 'exception.message': message,\n ...(stack ? { 'exception.stacktrace': stack } : {}),\n });\n\n return this;\n }\n\n setLlmFields(fields: {\n provider?: string;\n model?: string;\n promptTokens?: number;\n completionTokens?: number;\n totalTokens?: number;\n costUsd?: number;\n }): this {\n if (this._ended) return this;\n if (fields.provider !== undefined) this.llmProvider = fields.provider;\n if (fields.model !== undefined) this.llmModel = fields.model;\n if (fields.promptTokens !== undefined) this.llmPromptTokens = fields.promptTokens;\n if (fields.completionTokens !== undefined) this.llmCompletionTokens = fields.completionTokens;\n if (fields.totalTokens !== undefined) this.llmTotalTokens = fields.totalTokens;\n if (fields.costUsd !== undefined) this.llmCostUsd = fields.costUsd;\n return this;\n }\n\n setToolFields(fields: { name?: string; success?: boolean }): this {\n if (this._ended) return this;\n if (fields.name !== undefined) this.toolName = fields.name;\n if (fields.success !== undefined) this.toolSuccess = fields.success;\n return this;\n }\n\n end(): void {\n if (this._ended) return;\n this._ended = true;\n this._endHrtime = hrtimeMs();\n this.endTime = nowISO();\n\n if (this.status === SpanStatus.UNSET) {\n this.status = SpanStatus.OK;\n }\n\n this._onEnd?.(this);\n }\n\n /**\n * Serialize to the wire format expected by the Rust gateway.\n */\n toPayload(): SpanPayload {\n const payload: SpanPayload = {\n traceId: this.traceId,\n spanId: this.spanId,\n name: this.name,\n kind: this.kind,\n startTime: this.startTime,\n status: this.status,\n attributes: this.attributes,\n events: this.events,\n links: this.links,\n };\n\n if (this.parentSpanId !== undefined) payload.parentSpanId = this.parentSpanId;\n if (this.endTime !== undefined) payload.endTime = this.endTime;\n if (this._ended) payload.durationMs = this.durationMs;\n if (this.statusMessage !== undefined) payload.statusMessage = this.statusMessage;\n if (this.sessionId !== undefined) payload.sessionId = this.sessionId;\n if (this.agentId !== undefined) payload.agentId = this.agentId;\n if (this.agentName !== undefined) payload.agentName = this.agentName;\n if (this.agentType !== undefined) payload.agentType = this.agentType;\n if (this.semanticPhase !== undefined) payload.semanticPhase = this.semanticPhase;\n if (this.llmProvider !== undefined) payload.llmProvider = this.llmProvider;\n if (this.llmModel !== undefined) payload.llmModel = this.llmModel;\n if (this.llmPromptTokens !== undefined) payload.llmPromptTokens = this.llmPromptTokens;\n if (this.llmCompletionTokens !== undefined) payload.llmCompletionTokens = this.llmCompletionTokens;\n if (this.llmTotalTokens !== undefined) payload.llmTotalTokens = this.llmTotalTokens;\n if (this.llmCostUsd !== undefined) payload.llmCostUsd = this.llmCostUsd;\n if (this.toolName !== undefined) payload.toolName = this.toolName;\n if (this.toolSuccess !== undefined) payload.toolSuccess = this.toolSuccess;\n\n return payload;\n }\n}\n","/**\n * No-op implementations for the disabled path.\n *\n * When tracing is disabled, all operations return these no-op objects\n * to maintain zero overhead. No allocations, no side effects.\n */\n\nimport { SpanKind, SpanStatus, type SpanPayload } from './types.js';\n\n/**\n * A frozen no-op span that silently ignores all operations.\n * Used when SDK is disabled to avoid overhead.\n */\nexport const NOOP_SPAN = Object.freeze({\n traceId: '00000000000000000000000000000000',\n spanId: '0000000000000000',\n parentSpanId: undefined,\n name: 'noop',\n kind: SpanKind.INTERNAL,\n startTime: '',\n startHrtime: 0,\n endTime: undefined,\n status: SpanStatus.UNSET,\n statusMessage: undefined,\n attributes: Object.freeze({}) as Record<string, unknown>,\n events: Object.freeze([]) as readonly [],\n links: Object.freeze([]) as readonly [],\n sessionId: undefined,\n agentId: undefined,\n agentName: undefined,\n semanticPhase: undefined,\n llmProvider: undefined,\n llmModel: undefined,\n llmPromptTokens: undefined,\n llmCompletionTokens: undefined,\n llmTotalTokens: undefined,\n llmCostUsd: undefined,\n toolName: undefined,\n toolSuccess: undefined,\n isEnded: true,\n durationMs: 0,\n\n setAttribute() { return this; },\n setAttributes() { return this; },\n setStatus() { return this; },\n addEvent() { return this; },\n addLink() { return this; },\n recordException() { return this; },\n setLlmFields() { return this; },\n setToolFields() { return this; },\n end() {},\n toPayload(): SpanPayload {\n return {\n traceId: this.traceId,\n spanId: this.spanId,\n name: this.name,\n kind: this.kind,\n startTime: this.startTime,\n status: this.status,\n attributes: {},\n events: [],\n links: [],\n };\n },\n});\n\nexport type NoopSpan = typeof NOOP_SPAN;\n","/**\n * Head-based deterministic sampling.\n *\n * Uses the first 8 hex characters of the trace ID as a hash\n * to make a deterministic sampling decision. This ensures:\n * - Same trace ID always produces the same decision\n * - Consistent across Python and JS/TS SDKs\n * - No external state needed\n */\n\n/**\n * Determine whether a trace should be sampled.\n *\n * @param traceId - 32-character hex trace ID\n * @param sampleRate - Rate between 0.0 (none) and 1.0 (all)\n * @returns true if the trace should be sampled\n */\nexport function shouldSample(traceId: string, sampleRate: number): boolean {\n if (sampleRate >= 1.0) return true;\n if (sampleRate <= 0.0) return false;\n\n // Parse first 8 hex chars as unsigned 32-bit integer\n const hash = parseInt(traceId.substring(0, 8), 16);\n return (hash / 0xFFFFFFFF) < sampleRate;\n}\n","/**\n * Fix Runtime Configuration.\n *\n * Settings for the fix runtime including caching, refresh intervals,\n * A/B testing, and fix application behavior.\n *\n * Port of Python SDK's runtime/config.py adapted for Node.js patterns.\n */\n\n// ─── Runtime Configuration ──────────────────────────────────────────────────\n\nexport interface FixRuntimeConfig {\n /** API endpoint URL (e.g., \"https://app.risicare.ai\") */\n apiEndpoint: string;\n\n /** API key for authentication (format: \"rsk-{random}\") */\n apiKey: string;\n\n /** Whether the fix runtime is enabled (default: true) */\n enabled?: boolean;\n\n /** Whether caching is enabled (default: true) */\n cacheEnabled?: boolean;\n\n /** Cache entry TTL in milliseconds (default: 300_000 = 5 min) */\n cacheTtlMs?: number;\n\n /** Maximum number of cache entries (default: 1000) */\n cacheMaxEntries?: number;\n\n /** Whether to auto-refresh fixes in background (default: true) */\n autoRefresh?: boolean;\n\n /** Background refresh interval in milliseconds (default: 60_000 = 1 min) */\n refreshIntervalMs?: number;\n\n /** Log but don't apply fixes (default: false) */\n dryRun?: boolean;\n\n /** Whether A/B testing bucketing is active (default: true) */\n abTestingEnabled?: boolean;\n\n /** Timeout for API requests in milliseconds (default: 1000) */\n timeoutMs?: number;\n\n /** Enable debug logging (default: false) */\n debug?: boolean;\n}\n\n/** Resolve config with defaults applied. */\nexport function resolveFixRuntimeConfig(\n config: FixRuntimeConfig,\n): Required<FixRuntimeConfig> {\n return {\n apiEndpoint: config.apiEndpoint,\n apiKey: config.apiKey,\n enabled: config.enabled ?? true,\n cacheEnabled: config.cacheEnabled ?? true,\n cacheTtlMs: config.cacheTtlMs ?? 300_000,\n cacheMaxEntries: config.cacheMaxEntries ?? 1000,\n autoRefresh: config.autoRefresh ?? true,\n refreshIntervalMs: config.refreshIntervalMs ?? 60_000,\n dryRun: config.dryRun ?? false,\n abTestingEnabled: config.abTestingEnabled ?? true,\n timeoutMs: config.timeoutMs ?? 1000,\n debug: config.debug ?? false,\n };\n}\n\n// ─── Fix Type ───────────────────────────────────────────────────────────────\n\nexport type FixType =\n | 'prompt'\n | 'parameter'\n | 'retry'\n | 'fallback'\n | 'guard'\n | 'routing'\n | 'tool';\n\n// ─── Active Fix ─────────────────────────────────────────────────────────────\n\nexport interface ActiveFix {\n fixId: string;\n deploymentId?: string;\n errorCode: string;\n fixType: FixType;\n config: Record<string, unknown>;\n trafficPercentage: number; // 0–100\n version: number;\n}\n\n/**\n * Check if a fix matches the given error code.\n *\n * Supports exact match and wildcard prefix matching:\n * - \"TOOL.EXECUTION.TIMEOUT\" matches \"TOOL.EXECUTION.TIMEOUT\"\n * - \"TOOL.EXECUTION.*\" matches \"TOOL.EXECUTION.TIMEOUT\", \"TOOL.EXECUTION.FAILURE\", etc.\n * - \"TOOL.*\" matches any TOOL error\n */\nexport function matchesError(fix: ActiveFix, errorCode: string): boolean {\n if (fix.errorCode === errorCode) {\n return true;\n }\n\n // Wildcard matching\n if (fix.errorCode.endsWith('*')) {\n const prefix = fix.errorCode.slice(0, -1);\n return errorCode.startsWith(prefix);\n }\n\n return false;\n}\n\n/**\n * Determine if fix should be applied based on A/B traffic percentage.\n *\n * Uses consistent hashing so the same session always gets the same\n * treatment (fix or no fix).\n */\nexport function shouldApply(fix: ActiveFix, sessionHash: number): boolean {\n if (fix.trafficPercentage >= 100) return true;\n if (fix.trafficPercentage <= 0) return false;\n\n const bucket = sessionHash % 100;\n return bucket < fix.trafficPercentage;\n}\n\n/**\n * Create an ActiveFix from an API response item.\n *\n * Handles both snake_case (server API) and camelCase field names.\n */\nexport function activeFixFromApiResponse(\n item: Record<string, unknown>,\n): ActiveFix {\n return {\n fixId: (item.id ?? item.fix_id ?? item.fixId ?? '') as string,\n deploymentId: (item.deployment_id ?? item.deploymentId ?? '') as string,\n errorCode: (item.error_code ?? item.errorCode ?? '') as string,\n fixType: (item.fix_type ?? item.fixType ?? 'prompt') as FixType,\n config: (item.config ?? {}) as Record<string, unknown>,\n trafficPercentage: (item.traffic_percentage ?? item.trafficPercentage ?? 100) as number,\n version: (item.version ?? 1) as number,\n };\n}\n","// ⚠ GENERATED FILE — DO NOT EDIT BY HAND.\n//\n// Source of truth: packages/risicare-sdk/src/risicare/runtime/_error_taxonomy.py\n// Generator: packages/risicare-sdk/scripts/gen_js_taxonomy.py\n// Verify: scripts/contracts/lint-taxonomy-parity.sh\n//\n// F-SDKTAXFORK-001. This SDK cannot import `risicare_core.taxonomy` —\n// `risicare-core` is not published to npm. Rather than hand-maintain a second\n// copy of one rule (a divergence this campaign has measured four times), the\n// rule table and the canonical code set are generated from the Python source\n// and a rail fails when the two drift.\n//\n// 154 canonical codes across 10 modules.\n\nexport const CANONICAL_ERROR_CODES: ReadonlySet<string> = new Set([\n \"COMMUNICATION.CONTENT.AMBIGUOUS\",\n \"COMMUNICATION.CONTENT.CORRUPTED\",\n \"COMMUNICATION.CONTENT.INCOMPATIBLE\",\n \"COMMUNICATION.CONTENT.MALFORMED\",\n \"COMMUNICATION.CONTENT.TOO_LARGE\",\n \"COMMUNICATION.DELIVERY.DELAYED\",\n \"COMMUNICATION.DELIVERY.DUPLICATED\",\n \"COMMUNICATION.DELIVERY.EXPIRED\",\n \"COMMUNICATION.DELIVERY.OUT_OF_ORDER\",\n \"COMMUNICATION.DELIVERY.UNDELIVERABLE\",\n \"COMMUNICATION.ROUTING.BROADCAST_STORM\",\n \"COMMUNICATION.ROUTING.LOOP\",\n \"COMMUNICATION.ROUTING.NO_ROUTE\",\n \"COMMUNICATION.ROUTING.PARTITION\",\n \"COMMUNICATION.ROUTING.WRONG_ROUTE\",\n \"CONSENSUS.AGREEMENT.INCONSISTENT\",\n \"CONSENSUS.AGREEMENT.QUORUM_FAILED\",\n \"CONSENSUS.AGREEMENT.REJECTED\",\n \"CONSENSUS.AGREEMENT.STALE_VOTE\",\n \"CONSENSUS.AGREEMENT.TIMEOUT\",\n \"CONSENSUS.CONFLICT.BIAS\",\n \"CONSENSUS.CONFLICT.CASCADING\",\n \"CONSENSUS.CONFLICT.DEADLOCK\",\n \"CONSENSUS.CONFLICT.RESOLUTION_REJECTED\",\n \"CONSENSUS.CONFLICT.UNRESOLVED\",\n \"CONSENSUS.VOTING.ABSTENTION_FLOOD\",\n \"CONSENSUS.VOTING.COERCED_VOTE\",\n \"CONSENSUS.VOTING.DUPLICATE_VOTE\",\n \"CONSENSUS.VOTING.INVALID_VOTE\",\n \"CONSENSUS.VOTING.SPLIT_VOTE\",\n \"COORDINATION.HANDOFF.DELAYED\",\n \"COORDINATION.HANDOFF.DUPLICATED\",\n \"COORDINATION.HANDOFF.INCOMPLETE\",\n \"COORDINATION.HANDOFF.LOST\",\n \"COORDINATION.HANDOFF.WRONG_RECIPIENT\",\n \"COORDINATION.SYNCHRONIZATION.CLOCK_SKEW\",\n \"COORDINATION.SYNCHRONIZATION.OUT_OF_ORDER\",\n \"COORDINATION.SYNCHRONIZATION.RACE_CONDITION\",\n \"COORDINATION.SYNCHRONIZATION.SPLIT_BRAIN\",\n \"COORDINATION.SYNCHRONIZATION.VERSION_MISMATCH\",\n \"COORDINATION.WORKFLOW.CYCLE\",\n \"COORDINATION.WORKFLOW.DEADLOCK\",\n \"COORDINATION.WORKFLOW.LIVELOCK\",\n \"COORDINATION.WORKFLOW.ORPHANED\",\n \"COORDINATION.WORKFLOW.STARVATION\",\n \"MEMORY.CONTEXT_WINDOW.DROPPED\",\n \"MEMORY.CONTEXT_WINDOW.EXCEEDED\",\n \"MEMORY.CONTEXT_WINDOW.FRAGMENTED\",\n \"MEMORY.CONTEXT_WINDOW.PRIORITY_ERROR\",\n \"MEMORY.RETRIEVAL.INCOMPLETE\",\n \"MEMORY.RETRIEVAL.NOT_FOUND\",\n \"MEMORY.RETRIEVAL.OUTDATED\",\n \"MEMORY.RETRIEVAL.TOO_MANY\",\n \"MEMORY.RETRIEVAL.WRONG_MATCH\",\n \"MEMORY.STATE.CORRUPTED\",\n \"MEMORY.STATE.INCONSISTENT\",\n \"MEMORY.STATE.LOST\",\n \"MEMORY.STATE.OVERFLOW\",\n \"MEMORY.STATE.STALE\",\n \"ORCHESTRATION.DELEGATION.CAPABILITY_MISMATCH\",\n \"ORCHESTRATION.DELEGATION.CIRCULAR_DELEGATION\",\n \"ORCHESTRATION.DELEGATION.EXCESSIVE_DEPTH\",\n \"ORCHESTRATION.DELEGATION.NO_AVAILABLE_AGENT\",\n \"ORCHESTRATION.DELEGATION.OVERLOADED_AGENT\",\n \"ORCHESTRATION.LIFECYCLE.CLEANUP_FAILED\",\n \"ORCHESTRATION.LIFECYCLE.CRASHED\",\n \"ORCHESTRATION.LIFECYCLE.HUNG\",\n \"ORCHESTRATION.LIFECYCLE.SPAWN_FAILED\",\n \"ORCHESTRATION.LIFECYCLE.ZOMBIE\",\n \"ORCHESTRATION.SCALING.OVERLOADED\",\n \"ORCHESTRATION.SCALING.QUOTA_EXCEEDED\",\n \"ORCHESTRATION.SCALING.SCALE_DOWN_FAILED\",\n \"ORCHESTRATION.SCALING.SCALE_UP_FAILED\",\n \"ORCHESTRATION.SCALING.UNDERUTILIZED\",\n \"OUTPUT.FORMAT.ENCODING\",\n \"OUTPUT.FORMAT.INVALID_JSON\",\n \"OUTPUT.FORMAT.MALFORMED\",\n \"OUTPUT.FORMAT.SCHEMA_VIOLATION\",\n \"OUTPUT.FORMAT.TRUNCATED\",\n \"OUTPUT.QUALITY.INCOMPLETE\",\n \"OUTPUT.QUALITY.IRRELEVANT\",\n \"OUTPUT.QUALITY.REPETITIVE\",\n \"OUTPUT.QUALITY.UNCLEAR\",\n \"OUTPUT.QUALITY.VERBOSE\",\n \"OUTPUT.SAFETY.BIAS\",\n \"OUTPUT.SAFETY.COPYRIGHT\",\n \"OUTPUT.SAFETY.HARMFUL_CONTENT\",\n \"OUTPUT.SAFETY.PII_LEAK\",\n \"OUTPUT.SAFETY.POLICY_VIOLATION\",\n \"PERCEPTION.CONTEXT.CONFLICTING\",\n \"PERCEPTION.CONTEXT.IRRELEVANT\",\n \"PERCEPTION.CONTEXT.MISSING\",\n \"PERCEPTION.CONTEXT.OVERFLOW\",\n \"PERCEPTION.CONTEXT.STALE\",\n \"PERCEPTION.INPUT.ENCODING\",\n \"PERCEPTION.INPUT.INJECTION\",\n \"PERCEPTION.INPUT.MALFORMED\",\n \"PERCEPTION.INPUT.SCHEMA_MISMATCH\",\n \"PERCEPTION.INPUT.TRUNCATED\",\n \"PERCEPTION.PARSING.DATE_FORMAT\",\n \"PERCEPTION.PARSING.JSON_INVALID\",\n \"PERCEPTION.PARSING.NUMBER_FORMAT\",\n \"PERCEPTION.PARSING.REFERENCE_BROKEN\",\n \"PERCEPTION.PARSING.XML_INVALID\",\n \"REASONING.DECISION.BIASED\",\n \"REASONING.DECISION.INDECISIVE\",\n \"REASONING.DECISION.OSCILLATING\",\n \"REASONING.DECISION.OVERCONFIDENT\",\n \"REASONING.DECISION.PREMATURE\",\n \"REASONING.HALLUCINATION.CAPABILITY\",\n \"REASONING.HALLUCINATION.CITATION\",\n \"REASONING.HALLUCINATION.ENTITY\",\n \"REASONING.HALLUCINATION.FACTUAL\",\n \"REASONING.HALLUCINATION.TEMPORAL\",\n \"REASONING.LOGIC.CIRCULAR\",\n \"REASONING.LOGIC.CONTRADICTION\",\n \"REASONING.LOGIC.INCOMPLETE\",\n \"REASONING.LOGIC.INVALID_INFERENCE\",\n \"REASONING.LOGIC.MISSING_PREMISE\",\n \"REASONING.PLANNING.INCOMPLETE\",\n \"REASONING.PLANNING.INFEASIBLE\",\n \"REASONING.PLANNING.SCOPE_CREEP\",\n \"REASONING.PLANNING.SUBOPTIMAL\",\n \"REASONING.PLANNING.UNSAFE\",\n \"RESOURCES.ACCESS.DENIED\",\n \"RESOURCES.ACCESS.EXPIRED\",\n \"RESOURCES.ACCESS.LOCKED\",\n \"RESOURCES.ACCESS.NOT_FOUND\",\n \"RESOURCES.ACCESS.REVOKED\",\n \"RESOURCES.CONTENTION.DEADLOCK\",\n \"RESOURCES.CONTENTION.OVERFLOW\",\n \"RESOURCES.CONTENTION.PRIORITY_INVERSION\",\n \"RESOURCES.CONTENTION.STARVATION\",\n \"RESOURCES.CONTENTION.THRASHING\",\n \"RESOURCES.QUOTA.ALLOCATION_FAILED\",\n \"RESOURCES.QUOTA.EXCEEDED\",\n \"RESOURCES.QUOTA.LEAK\",\n \"RESOURCES.QUOTA.STALE\",\n \"RESOURCES.QUOTA.UNFAIR_DISTRIBUTION\",\n \"TOOL.EXECUTION.CRASHED\",\n \"TOOL.EXECUTION.DEPENDENCY_FAILED\",\n \"TOOL.EXECUTION.RATE_LIMITED\",\n \"TOOL.EXECUTION.RESOURCE_EXHAUSTED\",\n \"TOOL.EXECUTION.TIMEOUT\",\n \"TOOL.INVOCATION.INVALID_ARGS\",\n \"TOOL.INVOCATION.MISSING_REQUIRED\",\n \"TOOL.INVOCATION.NOT_FOUND\",\n \"TOOL.INVOCATION.PERMISSION_DENIED\",\n \"TOOL.INVOCATION.TYPE_MISMATCH\",\n \"TOOL.RESULT.EMPTY\",\n \"TOOL.RESULT.ERROR_IN_RESULT\",\n \"TOOL.RESULT.PARTIAL\",\n \"TOOL.RESULT.UNEXPECTED_FORMAT\",\n \"TOOL.RESULT.UNPARSEABLE\",\n]);\n\nexport interface TaxonomyRule {\n re: RegExp;\n code: string;\n}\n\n/** Order matters: first match wins, most specific first. */\nexport const SUPPLEMENTAL_RULES: readonly TaxonomyRule[] = [\n { re: new RegExp(\"timeout|timedout|aborted\", 'i'), code: \"TOOL.EXECUTION.TIMEOUT\" },\n { re: new RegExp(\"rate.?limit|\\\\b429\\\\b|too many requests\", 'i'), code: \"TOOL.EXECUTION.RATE_LIMITED\" },\n { re: new RegExp(\"connection|econnrefused|econnreset|enotfound|fetch failed|unreachable|broken pipe\", 'i'), code: \"TOOL.EXECUTION.DEPENDENCY_FAILED\" },\n { re: new RegExp(\"\\\\bauth|unauthorized|forbidden|permission|\\\\b401\\\\b|\\\\b403\\\\b\", 'i'), code: \"TOOL.INVOCATION.PERMISSION_DENIED\" },\n { re: new RegExp(\"json|syntaxerror|unexpected token|decodeerror\", 'i'), code: \"PERCEPTION.PARSING.JSON_INVALID\" },\n];\n\nexport const GENERIC_FALLBACK = \"TOOL.EXECUTION.CRASHED\";\n","/**\n * Fix Interceptors — Hook into LLM/tool calls to apply fixes.\n *\n * Interceptors are registered with the runtime and called during agent\n * execution to apply relevant fixes at three interception points:\n * - preCall: Before the LLM/tool call (prompt/parameter/fallback fixes)\n * - postCall: After the call (output guard validation)\n * - onError: When an error occurs (retry/fallback decisions)\n *\n * Port of Python SDK's runtime/interceptors.py adapted for Node.js.\n */\n\nimport type { ApplyResult } from './applier.js';\nimport { FixApplier } from './applier.js';\nimport type { FixCache } from './cache.js';\nimport type { FixRuntimeConfig } from './config.js';\nimport { resolveFixRuntimeConfig } from './config.js';\nimport { debug, warn } from '../utils/log.js';\nimport {\n CANONICAL_ERROR_CODES,\n GENERIC_FALLBACK,\n SUPPLEMENTAL_RULES,\n} from './taxonomy.generated.js';\n\n// ─── Guard Rejection ────────────────────────────────────────────────────────\n\n/**\n * Thrown by the fix interceptor when a guard fix returns `passed: false`.\n *\n * PR-4+5 review B2 (2026-05-25): pre-fix, `applyGuardFix` returned\n * `passed:false` correctly but no caller read `passed` — the provider\n * patcher consumed `result.messages` / `result.params` and proceeded to the\n * LLM with the attacker payload anyway. The `fail-CLOSED` was advisory only.\n *\n * Now the interceptor THROWS this error on both pre-call and post-call\n * guard rejection. The provider patcher's surrounding span.startSpan\n * already catches and records exceptions, so the customer sees a\n * `GuardRejectedError` propagated out of their `openai.chat.completions.create`\n * call — the LLM is NEVER invoked.\n *\n * Customers who want to handle rejection gracefully can:\n * try { await openai.chat.completions.create({ ... }); }\n * catch (e) {\n * if (e instanceof GuardRejectedError) { ... fallback ... }\n * else throw e;\n * }\n */\nexport class GuardRejectedError extends Error {\n public readonly guardId: string;\n public readonly reason: string;\n public readonly phase: 'pre_call' | 'post_call';\n\n constructor(guardId: string, reason: string, phase: 'pre_call' | 'post_call') {\n super(`Risicare guard rejected operation: ${guardId} (${phase}) — ${reason}`);\n this.name = 'GuardRejectedError';\n this.guardId = guardId;\n this.reason = reason;\n this.phase = phase;\n }\n}\n\n// ─── Intercept Context ──────────────────────────────────────────────────────\n\nexport interface InterceptContext {\n /** Type of operation: \"llm_call\", \"tool_call\", \"agent_delegate\" */\n operationType: string;\n\n /** Name of the operation: model name, tool name, agent name */\n operationName: string;\n\n /** Session ID for A/B testing bucketing */\n sessionId?: string;\n\n /** Trace ID for correlation */\n traceId?: string;\n\n /** Error code (set when retrying after error) */\n errorCode?: string;\n\n /** Error message (set when retrying after error) */\n errorMessage?: string;\n\n /** Current attempt number (1-based) */\n attempt: number;\n\n /** Fixes applied during this intercept lifecycle */\n appliedFixes: ApplyResult[];\n}\n\n/** Create a fresh InterceptContext. */\nexport function createInterceptContext(\n operationType: string,\n operationName: string,\n options?: {\n sessionId?: string;\n traceId?: string;\n errorCode?: string;\n },\n): InterceptContext {\n return {\n operationType,\n operationName,\n sessionId: options?.sessionId,\n traceId: options?.traceId,\n errorCode: options?.errorCode,\n attempt: 1,\n appliedFixes: [],\n };\n}\n\n// ─── Interceptor Interface ──────────────────────────────────────────────────\n\nexport interface FixInterceptor {\n /**\n * Called before an LLM/tool call.\n * Returns modified messages and params.\n */\n preCall(\n ctx: InterceptContext,\n messages: unknown[] | null,\n params: Record<string, unknown>,\n ): { messages: unknown[] | null; params: Record<string, unknown> };\n\n /**\n * Called after an LLM/tool call.\n * Returns modified response and whether to continue.\n */\n postCall(\n ctx: InterceptContext,\n response: unknown,\n ): { response: unknown; shouldContinue: boolean };\n\n /**\n * Called when an error occurs.\n * Returns whether to retry and optional modified params.\n */\n onError(\n ctx: InterceptContext,\n error: Error,\n ): { shouldRetry: boolean; modifiedParams: Record<string, unknown> | null };\n}\n\n// ─── Default Fix Interceptor ────────────────────────────────────────────────\n\nexport class DefaultFixInterceptor implements FixInterceptor {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n private readonly _applier: FixApplier;\n\n constructor(config: FixRuntimeConfig, cache: FixCache, applier: FixApplier) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = cache;\n this._applier = applier;\n }\n\n /**\n * Apply pre-call fixes.\n *\n * - If retrying after error: look up fix by error_code, apply\n * prompt/parameter/fallback fixes\n * - Runs input guard fixes on all message content\n */\n preCall(\n ctx: InterceptContext,\n messages: unknown[] | null,\n params: Record<string, unknown>,\n ): { messages: unknown[] | null; params: Record<string, unknown> } {\n try {\n if (!this._config.enabled) {\n return { messages, params };\n }\n\n let modifiedMessages = messages;\n let modifiedParams = { ...params };\n\n // If retrying after error, check for applicable fixes\n if (ctx.errorCode) {\n const fix = this._applier.getFixForError(ctx.errorCode, ctx.sessionId);\n\n if (fix) {\n debug(`Applying fix ${fix.fixId} for ${ctx.errorCode}`);\n\n if (fix.fixType === 'prompt' && messages) {\n const msgRecords = messages as Record<string, unknown>[];\n const { messages: newMessages, result } =\n this._applier.applyPromptFix(fix, msgRecords);\n modifiedMessages = newMessages;\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n } else if (fix.fixType === 'parameter') {\n const { params: newParams, result } =\n this._applier.applyParameterFix(fix, modifiedParams);\n modifiedParams = newParams;\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n } else if (fix.fixType === 'fallback') {\n const { params: newParams, result } =\n this._applier.applyFallbackFix(fix, modifiedParams);\n modifiedParams = newParams;\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n }\n }\n }\n\n // Apply input guard fixes on all message content.\n // PR-4+5 review B2: when a guard returns passed:false (including the\n // F-731 fail-CLOSED-on-exception path), THROW a GuardRejectedError so\n // the provider patcher short-circuits BEFORE invoking the LLM. The\n // outer try/catch below explicitly re-raises GuardRejectedError so\n // the swallow-and-degrade behaviour for OTHER errors does NOT apply\n // to safety rejections.\n if (modifiedMessages && this._config.enabled) {\n for (const msg of modifiedMessages as Record<string, unknown>[]) {\n const content = msg.content;\n if (typeof content === 'string') {\n for (const fix of this._cache.getAll()) {\n if (fix.fixType === 'guard') {\n const { passed, result } = this._applier.applyGuardFix(\n fix,\n content,\n true,\n );\n if (result.applied) {\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n }\n if (!passed) {\n throw new GuardRejectedError(\n fix.fixId ?? 'unknown',\n result.reason ?? 'guard rejected input',\n 'pre_call',\n );\n }\n }\n }\n }\n }\n }\n\n return { messages: modifiedMessages, params: modifiedParams };\n } catch (e) {\n // PR-4+5 review B2: GuardRejectedError MUST propagate. The catch\n // below exists for unrelated failures (e.g., cache lookup explosion)\n // where degrading to the unmodified call is correct — but a safety\n // rejection MUST abort the LLM call, not silently let it through.\n if (e instanceof GuardRejectedError) throw e;\n debug(`DefaultFixInterceptor.preCall error: ${e}`);\n return { messages, params };\n }\n }\n\n /**\n * Apply post-call fixes (output validation).\n *\n * Runs output guard fixes on response content.\n */\n postCall(\n ctx: InterceptContext,\n response: unknown,\n ): { response: unknown; shouldContinue: boolean } {\n try {\n if (!this._config.enabled) {\n return { response, shouldContinue: true };\n }\n\n for (const fix of this._cache.getAll()) {\n if (fix.fixType !== 'guard') continue;\n\n const content = this._extractResponseContent(response);\n if (!content) continue;\n\n const { passed, result } = this._applier.applyGuardFix(\n fix,\n content,\n false,\n );\n\n if (result.applied) {\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n }\n\n if (!passed) {\n // PR-4+5 review B2: output guard failure must NOT be a warn-only\n // signal. Pre-fix the caller received the unredacted LLM response\n // alongside shouldContinue:true — the rejection was advisory only.\n // Now we throw GuardRejectedError so the caller surfaces the\n // safety violation to the customer instead of returning a payload\n // an output filter said is unsafe to emit.\n warn(`Output guard failed for fix ${fix.fixId}: ${result.reason ?? 'unknown'}`);\n throw new GuardRejectedError(\n fix.fixId ?? 'unknown',\n result.reason ?? 'guard rejected output',\n 'post_call',\n );\n }\n }\n\n return { response, shouldContinue: true };\n } catch (e) {\n // PR-4+5 review B2: GuardRejectedError MUST propagate (see preCall).\n if (e instanceof GuardRejectedError) throw e;\n debug(`DefaultFixInterceptor.postCall error: ${e}`);\n return { response, shouldContinue: true };\n }\n }\n\n /**\n * Handle errors and decide whether to retry.\n *\n * Classifies the error, looks up retry/fallback fixes, and returns\n * whether the caller should retry.\n */\n onError(\n ctx: InterceptContext,\n error: Error,\n ): { shouldRetry: boolean; modifiedParams: Record<string, unknown> | null } {\n try {\n if (!this._config.enabled) {\n return { shouldRetry: false, modifiedParams: null };\n }\n\n // Classify the error\n const errorCode = classifyError(error);\n ctx.errorCode = errorCode;\n ctx.errorMessage = error.message;\n\n // Check for retry fix\n const fix = this._applier.getFixForError(errorCode, ctx.sessionId);\n if (!fix) {\n return { shouldRetry: false, modifiedParams: null };\n }\n\n if (fix.fixType === 'retry') {\n const maxRetries = (fix.config.max_retries ?? fix.config.maxRetries ?? 3) as number;\n\n if (ctx.attempt <= maxRetries) {\n debug(\n `Retry fix ${fix.fixId}: attempt ${ctx.attempt}/${maxRetries}`,\n );\n\n const result: ApplyResult = {\n applied: true,\n fixId: fix.fixId,\n deploymentId: fix.deploymentId,\n fixType: 'retry',\n modifications: { attempt: ctx.attempt },\n };\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n\n return { shouldRetry: true, modifiedParams: null };\n }\n }\n\n // Check for fallback fix\n if (fix.fixType === 'fallback') {\n const { params: modifiedParams, result } =\n this._applier.applyFallbackFix(fix, {});\n if (result.applied) {\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n return { shouldRetry: true, modifiedParams };\n }\n }\n\n return { shouldRetry: false, modifiedParams: null };\n } catch (e) {\n debug(`DefaultFixInterceptor.onError error: ${e}`);\n return { shouldRetry: false, modifiedParams: null };\n }\n }\n\n // ─── Private ────────────────────────────────────────────────────────────\n\n /** Extract text content from a response object. */\n private _extractResponseContent(response: unknown): string | null {\n if (typeof response === 'string') return response;\n\n if (response && typeof response === 'object') {\n const resp = response as Record<string, unknown>;\n\n // OpenAI-style response: { choices: [{ message: { content: \"...\" } }] }\n const choices = resp.choices as unknown[];\n if (Array.isArray(choices) && choices.length > 0) {\n const first = choices[0] as Record<string, unknown>;\n const message = first?.message as Record<string, unknown>;\n if (typeof message?.content === 'string') {\n return message.content;\n }\n }\n\n // Anthropic-style response: { content: [{ text: \"...\" }] }\n const content = resp.content;\n if (typeof content === 'string') return content;\n if (Array.isArray(content) && content.length > 0) {\n const first = content[0] as Record<string, unknown>;\n if (typeof first?.text === 'string') return first.text;\n }\n }\n\n return null;\n }\n}\n\n// ─── Error Classification ───────────────────────────────────────────────────\n\n/**\n * Classify an error into an error code.\n *\n * Simple heuristic classification. In production, this would use the full\n * taxonomy from risicare-core (10 modules, 35+ categories).\n */\nexport function classifyError(error: Error): string {\n // F-SDKTAXFORK-001 — this used to be a private six-code vocabulary of which\n // exactly ONE code existed in the canonical 154-code taxonomy (measured\n // 2026-08-17: RATE_LIMIT vs canonical RATE_LIMITED, JSON_INVALID vs\n // INVALID_JSON, and three with no canonical sibling at all). The Python SDK\n // carried a byte-identical fork of the same wrong set.\n //\n // The rules and the canonical code set now come from ONE source\n // (packages/risicare-sdk/src/risicare/runtime/_error_taxonomy.py) and are\n // GENERATED into ./taxonomy.generated.ts, because `risicare-core` is not on\n // npm and this SDK cannot import the taxonomy directly. Drift is caught by\n // scripts/contracts/lint-taxonomy-parity.sh.\n //\n // Every code below is checked against CANONICAL_ERROR_CODES before it is\n // returned, so an invented code cannot reach the wire even if this file and\n // the generator ever disagree.\n const haystack = `${error?.constructor?.name ?? 'Error'} ${error?.message ?? ''}`;\n\n for (const rule of SUPPLEMENTAL_RULES) {\n // RegExp objects carry lastIndex state only with /g; these are built\n // without it, so .test() is safe to reuse across calls.\n if (rule.re.test(haystack)) {\n return CANONICAL_ERROR_CODES.has(rule.code) ? rule.code : GENERIC_FALLBACK;\n }\n }\n\n return CANONICAL_ERROR_CODES.has(GENERIC_FALLBACK) ? GENERIC_FALLBACK : '';\n}\n","/**\n * AsyncLocalStorage-based context propagation.\n *\n * Uses a single AsyncLocalStorage instance with a composite state object.\n * This is simpler and more performant than multiple separate stores.\n *\n * Node.js AsyncLocalStorage automatically propagates through:\n * - Promise / async-await\n * - setTimeout / setImmediate\n * - EventEmitter callbacks\n * - process.nextTick\n * - async generators (unlike Python's contextvars!)\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Span } from '../span.js';\nimport type { SemanticPhase } from '../types.js';\nimport { getContextStorage } from '../globals.js';\n\n// ─── Context Types ───────────────────────────────────────────────────────────\n\nexport interface SessionContext {\n sessionId: string;\n userId?: string;\n metadata?: Record<string, unknown>;\n parentSessionId?: string;\n turnNumber?: number;\n}\n\nexport interface AgentContext {\n agentId: string;\n agentName?: string;\n agentRole?: string;\n agentType?: string;\n parentAgentId?: string;\n version?: number;\n metadata?: Record<string, unknown>;\n}\n\nexport interface ContextState {\n session?: SessionContext;\n agent?: AgentContext;\n span?: Span;\n phase?: SemanticPhase;\n /** When true, provider instrumentors skip span creation (framework is handling it). */\n _suppressProviderInstrumentation?: boolean;\n /**\n * Pre-allocated trace ID from getTraceContext() when no span exists yet.\n * Ensures that getTraceContext().traceId matches the next span created\n * in this context — preventing the \"trace ID mismatch\" bug.\n */\n _rootTraceId?: string;\n /**\n * F-SDKSAMPORPHAN-001 — the trace's head-sampling decision, recorded ONLY\n * when it was `false`.\n *\n * A dropped root creates no Span, so `span` above stays undefined and every\n * nested call looks like a fresh root to the tracer. Without this flag it\n * re-rolls its own decision and the half that passes is delivered as a\n * root — a trace that never existed. This is the only carrier of \"you are\n * inside a trace we already decided to drop\".\n *\n * Scoped by runWithContext(), so unlike Python's ContextVar token it cannot\n * leak past the callback that set it.\n */\n _traceSampled?: boolean;\n}\n\n// ─── Storage Accessor ────────────────────────────────────────────────────────\n\nfunction storage(): AsyncLocalStorage<ContextState> {\n return getContextStorage() as AsyncLocalStorage<ContextState>;\n}\n\n// ─── Core Operations ─────────────────────────────────────────────────────────\n\n/**\n * Get the current context state, or empty object if outside any context.\n */\nexport function getContext(): ContextState {\n return storage().getStore() ?? {};\n}\n\n/**\n * Run a callback within a new context scope.\n * The new scope inherits from the parent, with overrides applied.\n */\nexport function runWithContext<T>(overrides: Partial<ContextState>, fn: () => T): T {\n const parent = getContext();\n const merged: ContextState = { ...parent, ...overrides };\n return storage().run(merged, fn);\n}\n\n/**\n * Run an async callback within a new context scope.\n */\nexport function runWithContextAsync<T>(overrides: Partial<ContextState>, fn: () => Promise<T>): Promise<T> {\n const parent = getContext();\n const merged: ContextState = { ...parent, ...overrides };\n return storage().run(merged, fn);\n}\n\n// ─── Context Accessors ───────────────────────────────────────────────────────\n\nexport function getCurrentSession(): SessionContext | undefined {\n return getContext().session;\n}\n\nexport function getCurrentAgent(): AgentContext | undefined {\n return getContext().agent;\n}\n\nexport function getCurrentSpan(): Span | undefined {\n return getContext().span;\n}\n\nexport function getCurrentPhase(): SemanticPhase | undefined {\n return getContext().phase;\n}\n\nexport function getCurrentSessionId(): string | undefined {\n return getContext().session?.sessionId;\n}\n\nexport function getCurrentAgentId(): string | undefined {\n return getContext().agent?.agentId;\n}\n\nexport function getCurrentTraceId(): string | undefined {\n return getContext().span?.traceId;\n}\n\nexport function getCurrentSpanId(): string | undefined {\n return getContext().span?.spanId;\n}\n\nexport function getCurrentParentSpanId(): string | undefined {\n return getContext().span?.parentSpanId;\n}\n\n/**\n * Get all current context as a plain object (for debugging/serialization).\n */\nexport function getCurrentContext(): Record<string, unknown> {\n const ctx = getContext();\n return {\n session: ctx.session ? {\n sessionId: ctx.session.sessionId,\n userId: ctx.session.userId,\n ...(ctx.session.parentSessionId !== undefined ? { parentSessionId: ctx.session.parentSessionId } : {}),\n ...(ctx.session.turnNumber !== undefined ? { turnNumber: ctx.session.turnNumber } : {}),\n ...(ctx.session.metadata !== undefined ? { metadata: ctx.session.metadata } : {}),\n } : null,\n agent: ctx.agent ? {\n agentId: ctx.agent.agentId,\n agentName: ctx.agent.agentName,\n agentRole: ctx.agent.agentRole,\n agentType: ctx.agent.agentType,\n ...(ctx.agent.parentAgentId !== undefined ? { parentAgentId: ctx.agent.parentAgentId } : {}),\n ...(ctx.agent.version !== undefined ? { version: ctx.agent.version } : {}),\n ...(ctx.agent.metadata !== undefined ? { metadata: ctx.agent.metadata } : {}),\n } : null,\n span: ctx.span ? { spanId: ctx.span.spanId, traceId: ctx.span.traceId } : null,\n phase: ctx.phase ?? null,\n };\n}\n","/**\n * Tracer — creates spans with automatic context nesting.\n *\n * The Tracer is the primary API for creating spans. It automatically:\n * - Links child spans to parent spans via parentSpanId\n * - Propagates the trace ID from the active context\n * - Injects session/agent/phase context into new spans\n * - Runs the callback within the span's context scope\n *\n * Usage:\n * const tracer = new Tracer(processor);\n * await tracer.startSpan('my-operation', async (span) => {\n * span.setAttribute('key', 'value');\n * // Nested spans automatically become children\n * await tracer.startSpan('sub-op', async (child) => { ... });\n * });\n */\n\nimport { Span, type SpanOptions, type SpanEndCallback } from './span.js';\nimport { NOOP_SPAN } from './noop.js';\nimport { SpanKind } from './types.js';\nimport { generateTraceId } from './ids.js';\nimport { shouldSample } from './utils/sampling.js';\nimport { classifyError } from './runtime/interceptors.js';\nimport {\n runWithContext,\n getContext,\n getCurrentSpan,\n getCurrentSession,\n getCurrentAgent,\n getCurrentPhase,\n} from './context/storage.js';\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nexport interface StartSpanOptions {\n name: string;\n kind?: SpanKind;\n attributes?: Record<string, unknown>;\n /** Override trace ID (default: inherit from parent or generate new) */\n traceId?: string;\n /** Override parent span ID (default: current span in context) */\n parentSpanId?: string;\n}\n\nexport interface TracerConfig {\n /** Called when a span ends (typically feeds into batch processor) */\n onSpanEnd: SpanEndCallback;\n /** Sample rate 0.0–1.0 (default: 1.0) */\n sampleRate?: number;\n /** Whether tracing is enabled */\n enabled?: boolean;\n /**\n * Whether prompt/completion content may leave the process (default: false).\n *\n * ⚠ The Tracer only CARRIES this for the provider patches to read via\n * `getTraceContent()`. It is NOT the enforcement point — the gate runs in the\n * batch processor, which is the one place both content paths cross. See\n * `masking.ts` `stripContent`.\n */\n traceContent?: boolean;\n /**\n * Service name, emitted as the OTel `service.name` span attribute.\n *\n * ⚠ F-SDKJSSVCNAME-001. `serviceName` was accepted by `init()`, typed in\n * `RisicareConfig`, documented, and recommended over the deprecated\n * `projectId` — and reached the wire NOWHERE. Measured on the published\n * 0.5.0: `serviceName: 'X'` at init, `X` absent from every request body,\n * while a sibling control attribute in the same span arrived. Python has\n * always emitted it (`tracer.py`, `service.name`); this makes JS match.\n */\n serviceName?: string;\n /**\n * Service version, emitted as `service.version`.\n *\n * ⚠ Was dropped by BOTH SDKs — same defect one field over, measured in the\n * same run. Unlike `service.name` it is NOT suppressed under an agent: a\n * version is a property of the deployed code, not of which agent owns the\n * span.\n */\n serviceVersion?: string;\n}\n\n/**\n * F-SDKTAXFORK-001 — attach the canonical taxonomy code to EVERY errored span,\n * whether or not a fix was applied.\n *\n * ⚠ The \"whether or not\" clause is the load-bearing one.\n * `risicare.fix.error_code` is written only inside the branch that also sets\n * `risicare.fix.applied` (providers/openai/patch.ts), so a span carrying an\n * error code has ALWAYS had a non-empty fix_applied — which makes the A/B\n * CONTROL predicate `fix_applied = '' AND error_code = X` unsatisfiable by\n * algebra, not merely empty. Emitting here is what makes that cohort populable.\n *\n * The worker already reads this key and has since before any producer existed\n * (`spans_worker.py:3744` — `risicare.fix.error_code` OR `error.code`; its own\n * comment calls it \"generic taxonomy code attached by any error\"). This is\n * attribute-first per .claude/rules/schema-contract.md: no gateway or worker\n * change is required.\n *\n * Guarded throughout: classification must never replace the customer's own\n * exception with ours, and must never write an empty attribute.\n */\nexport function attachErrorCode(span: Span, error: unknown): void {\n try {\n const err = error instanceof Error ? error : new Error(String(error));\n const code = classifyError(err);\n if (code) {\n span.setAttribute('error.code', code);\n }\n } catch {\n /* never let attribution break the customer's error path */\n }\n}\n\n// ─── Tracer Class ───────────────────────────────────────────────────────────\n\nexport class Tracer {\n private _onSpanEnd: SpanEndCallback;\n private _sampleRate: number;\n private _enabled: boolean;\n private _traceContent: boolean;\n private _serviceName: string | undefined;\n private _serviceVersion: string | undefined;\n\n constructor(config: TracerConfig) {\n this._onSpanEnd = config.onSpanEnd;\n this._sampleRate = config.sampleRate ?? 1.0;\n this._enabled = config.enabled ?? true;\n this._traceContent = config.traceContent ?? false;\n // Empty string is what `resolveConfig` uses for \"unset\" — treat it as unset\n // rather than emitting `service.name: \"\"`, which is worse than absent.\n this._serviceName = config.serviceName || undefined;\n this._serviceVersion = config.serviceVersion || undefined;\n }\n\n get enabled(): boolean {\n return this._enabled;\n }\n\n set enabled(value: boolean) {\n this._enabled = value;\n }\n\n get traceContent(): boolean {\n return this._traceContent;\n }\n\n /**\n * Start a span, run the callback within its context, and auto-end on completion.\n *\n * The span is automatically:\n * - Linked to the current parent span (if any)\n * - Given the current trace ID (or a new one for root spans)\n * - Enriched with session/agent/phase context\n * - Ended when the callback returns (or throws)\n * - Marked as ERROR if the callback throws\n *\n * @returns The callback's return value\n */\n startSpan<T>(options: StartSpanOptions | string, fn: (span: Span) => T): T {\n const opts = typeof options === 'string' ? { name: options } : options;\n\n // Fast path: disabled SDK\n if (!this._enabled) {\n return fn(NOOP_SPAN as unknown as Span);\n }\n\n // Resolve context\n const parentSpan = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n const phase = getCurrentPhase();\n\n // Determine trace ID: explicit > parent > pre-allocated (from getTraceContext) > new\n const ctx = getContext();\n const traceId = opts.traceId ?? parentSpan?.traceId ?? ctx._rootTraceId ?? generateTraceId();\n\n // Sampling: check once per trace (root span decides)\n //\n // F-SDKSAMPORPHAN-001 — CONSULT BEFORE ROLLING. A dropped root creates no\n // Span, so `getCurrentSpan()` stays undefined and every nested call\n // arrives here as though it were itself a root. Re-rolling there does not\n // subsample; it FABRICATES. Measured pre-fix from an installed 0.5.1\n // tarball, N=400 roots each wrapping one nested startSpan, sampleRate=0.5:\n // ESM 104 of 303 delivered traces (34.3%) and CJS 94 of 310 (30.3%)\n // contained no root span — they never existed as traces. Both arms at\n // sampleRate=1.0 fabricated 0 of 400.\n // ⚠ Downstream cannot repair this: the delivered count is N*r*(2-r), not\n // N*r, so scaling by 1/r overstates by 50% at r=0.5 and 90% at r=0.1.\n if (!parentSpan) {\n if (ctx._traceSampled === false) {\n return fn(NOOP_SPAN as unknown as Span);\n }\n if (this._sampleRate < 1.0 && !shouldSample(traceId, this._sampleRate)) {\n // Record the drop for the duration of the callback so nested calls\n // inherit it. runWithContext scopes the flag to exactly this callback,\n // so it cannot latch the way an un-reset ContextVar token can.\n return runWithContext({ _traceSampled: false }, () =>\n fn(NOOP_SPAN as unknown as Span),\n );\n }\n }\n\n // Parent span ID: explicit > current span in context\n const parentSpanId = opts.parentSpanId ?? parentSpan?.spanId;\n\n // Create the span\n const spanOptions: SpanOptions = {\n name: opts.name,\n kind: opts.kind ?? SpanKind.INTERNAL,\n traceId,\n parentSpanId,\n attributes: {\n ...opts.attributes,\n // Propagate context fields as attributes (matching Python SDK tracer.py:497-511)\n ...(agent?.agentRole ? { 'agent.role': agent.agentRole } : {}),\n ...(agent?.parentAgentId ? { 'parent_agent_id': agent.parentAgentId } : {}),\n ...(session?.userId ? { 'session.user_id': session.userId } : {}),\n // F-SDKJSSVCNAME-001 — `service.name` is suppressed when an agent\n // identity is present (the agent takes priority), matching Python;\n // `service.version` never is.\n ...(this._serviceName && !agent ? { 'service.name': this._serviceName } : {}),\n ...(this._serviceVersion ? { 'service.version': this._serviceVersion } : {}),\n },\n sessionId: session?.sessionId,\n agentId: agent?.agentId,\n agentName: agent?.agentName,\n agentType: agent?.agentType,\n semanticPhase: phase,\n };\n\n const span = new Span(spanOptions, this._onSpanEnd);\n\n // Run callback within span context\n try {\n const result = runWithContext({ span }, () => fn(span));\n\n // Handle async results (Promises)\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n span.end();\n return value;\n },\n (error) => {\n span.recordException(error instanceof Error ? error : String(error));\n attachErrorCode(span, error);\n span.end();\n throw error;\n },\n ) as T;\n }\n\n // Sync: end span immediately\n span.end();\n return result;\n } catch (error) {\n // Sync error: record and re-throw\n span.recordException(error instanceof Error ? error : String(error));\n attachErrorCode(span, error);\n span.end();\n throw error;\n }\n }\n\n /**\n * Create a span without auto-ending. Caller is responsible for calling span.end().\n *\n * Useful for long-running operations where you need manual control.\n * The span is still linked to context and enriched with session/agent/phase.\n */\n createSpan(options: StartSpanOptions | string): Span {\n const opts = typeof options === 'string' ? { name: options } : options;\n\n if (!this._enabled) {\n return NOOP_SPAN as unknown as Span;\n }\n\n const parentSpan = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n const phase = getCurrentPhase();\n\n const traceId = opts.traceId ?? parentSpan?.traceId ?? generateTraceId();\n\n // F-SDKSAMPORPHAN-001 — see the sibling site in startSpan(). Measured\n // pre-fix on this path (createSpan nested inside a startSpan root, the\n // streaming pattern), N=400, sampleRate=0.5: ESM 111 of 296 fabricated\n // (37.5%), CJS 105 of 294 (35.7%); both 0 of 400 at sampleRate=1.0.\n // ⚠ This site CONSULTS but does not RECORD: createSpan hands the span's\n // lifetime to the caller and owns no callback scope to unwind in, so\n // recording here would latch `_traceSampled` for the rest of the enclosing\n // context. Documented bound: a createSpan root that is itself dropped does\n // not suppress a re-roll by a following createSpan.\n if (!parentSpan) {\n if (getContext()._traceSampled === false) {\n return NOOP_SPAN as unknown as Span;\n }\n if (this._sampleRate < 1.0 && !shouldSample(traceId, this._sampleRate)) {\n return NOOP_SPAN as unknown as Span;\n }\n }\n\n const parentSpanId = opts.parentSpanId ?? parentSpan?.spanId;\n\n return new Span(\n {\n name: opts.name,\n kind: opts.kind ?? SpanKind.INTERNAL,\n traceId,\n parentSpanId,\n attributes: {\n ...opts.attributes,\n // Propagate context fields as attributes (matching Python SDK tracer.py:497-511)\n ...(agent?.agentRole ? { 'agent.role': agent.agentRole } : {}),\n ...(agent?.parentAgentId ? { 'parent_agent_id': agent.parentAgentId } : {}),\n ...(session?.userId ? { 'session.user_id': session.userId } : {}),\n // F-SDKJSSVCNAME-001 — see the sibling site above.\n ...(this._serviceName && !agent ? { 'service.name': this._serviceName } : {}),\n ...(this._serviceVersion ? { 'service.version': this._serviceVersion } : {}),\n },\n sessionId: session?.sessionId,\n agentId: agent?.agentId,\n agentName: agent?.agentName,\n agentType: agent?.agentType,\n semanticPhase: phase,\n },\n this._onSpanEnd,\n );\n }\n}\n","/**\n * Single source of truth for the SDK version on the wire.\n *\n * F-720/F-351: prior to this file, two separate `SDK_VERSION` constants\n * existed in `exporters/http.ts` (\"0.1.1\") and `runtime/loader.ts` (\"0.1.3\"),\n * while `package.json` declared \"0.4.0\". Three different versions on the\n * wire confused customer telemetry and dashboard SDK-version-cohort filters.\n *\n * This file MUST stay in lock-step with the `version` field in\n * `packages/risicare-sdk-js/package.json`. Bumping the version is a\n * two-file edit (`package.json` + this file). The `prepublishOnly` script\n * verifies the match before any npm publish.\n *\n * Kept as a plain TS constant (not a runtime read of package.json) because:\n * 1. tsup bundles to ESM AND CJS for both Node and Edge; runtime fs\n * reads of package.json break in bundled-Edge environments.\n * 2. A constant inlines at tree-shake time, so no extra bytes shipped.\n * 3. The version is read in the hot path (every export); a static value\n * avoids per-call import-meta-resolve overhead.\n */\nexport const SDK_VERSION = '0.6.0';\n","/**\n * HTTP exporter for sending spans to the Risicare gateway.\n *\n * Uses native fetch (Node.js 18+), with:\n * - Automatic retry with exponential backoff\n * - Circuit breaker with half-open probe state\n * - Gzip compression for large payloads\n * - Bearer token authentication\n */\n\nimport type { Span } from '../span.js';\nimport type { IngestRequest } from '../types.js';\nimport { ExportResult, type SpanExporter } from './base.js';\nimport { debug, warn } from '../utils/log.js';\nimport { SDK_VERSION } from '../version.js';\n\nexport interface HttpExporterOptions {\n endpoint: string;\n apiKey?: string;\n projectId?: string;\n environment?: string;\n timeoutMs?: number;\n maxRetries?: number;\n compress?: boolean;\n}\n\n/**\n * F-SDK503-001 · A CAPACITY REFUSAL IS NOT A SICK SERVER.\n *\n * ⚠ MEASURED ON THE PUBLISHED ARTEFACT (`risicare@0.5.0` from npm, clean install). The bundle\n * contains ZERO occurrences of `accepted`, one of `\"429\"` (which is TOOL-error classification,\n * not HTTP), and its export path is `if (response.status < 300) return SUCCESS` — so 429, 503\n * and 500 are byte-identical to it and `Retry-After` is never read. The Python twin measured\n * identically: `fix-workstream/perf/a3/sdk_python_refusal_probe.py`.\n *\n * ⚠ THE BREAKER IS THE DANGEROUS HALF. Five consecutive failing exports open it for 60 s, and\n * under sustained overload five refusals arrive in well under a second — so the SDK discards\n * everything the application emits for the next minute. A `503 QUEUE_NEAR_CAPACITY` is a\n * HEALTHY gateway shedding load whose backlog drains on its own; treating it as a dead sink\n * turns a transient server-side shed into total client-side loss.\n *\n * ⚠ THIS DOES NOT MAKE ANYTHING RETRY FOREVER. `maxRetries` still bounds the attempts and the\n * batch is still dropped when they are spent. A genuine 500 still opens the breaker — that is\n * the control arm, and losing it would turn our outage into the customer's retry loop.\n */\nconst CAPACITY_REFUSAL_STATUSES: ReadonlySet<number> = new Set([429, 503]);\n\n/** Ceiling on an honoured `Retry-After`, in ms. Matches the Python twin's 10 s. */\nconst RETRY_AFTER_CEILING_MS = 10_000;\n\n/** Backoff for a refusal carrying no `Retry-After` (1 s, 2 s, 4 s) — an order of magnitude\n * above the generic 100/200/400 ms ladder, because a queue needs time to drain. */\nconst REFUSAL_BACKOFF_BASE_MS = 1_000;\n\n/** Sentinel for \"refused, but the server named no delay\". */\nconst REFUSAL_NO_HINT = -1;\n\nexport class HttpExporter implements SpanExporter {\n readonly name = 'http';\n\n private readonly _endpoint: string;\n private readonly _apiKey: string | undefined;\n private readonly _projectId: string | undefined;\n private readonly _environment: string | undefined;\n private readonly _timeoutMs: number;\n private readonly _maxRetries: number;\n private readonly _compress: boolean;\n\n // Circuit breaker (CON-201 / B-16). Threshold and cooldown sized for\n // a \"30-second prod restart\" scenario: with default 1s batch flush a\n // 5-failure threshold opens the circuit ~5s into an outage and the 60s\n // cooldown gives the gateway time to come back before the half-open\n // probe fires. Lower numbers (was 3@30s) tripped on transient blips.\n private _consecutiveFailures = 0;\n /**\n * F-SDK503-001. Set by `_sendRequest` when a response is a CAPACITY REFUSAL, read by the\n * retry loop and the breaker. `null` = not a refusal; `REFUSAL_NO_HINT` = refused with no\n * `Retry-After`; otherwise the honoured delay in ms.\n *\n * ⚠ Node has ONE thread and `export()` is `async`, so two concurrent exports interleave on\n * this field at every `await`. It is written immediately after the awaited `fetch` resolves\n * and read on the very next statement, with no `await` between — so the value cannot be\n * clobbered mid-decision. The Python twin carries the same per-call state on `self` for the\n * same reason (its `_send_request` signature is pin-locked).\n */\n private _lastRefusalAfterMs: number | null = null;\n private _circuitOpenUntil = 0;\n private readonly _circuitBreakerThreshold = 5;\n private readonly _circuitBreakerCooldownMs = 60_000;\n\n constructor(options: HttpExporterOptions) {\n this._endpoint = options.endpoint.replace(/\\/+$/, '');\n this._apiKey = options.apiKey;\n this._projectId = options.projectId;\n this._environment = options.environment;\n this._timeoutMs = options.timeoutMs ?? 5000;\n this._maxRetries = options.maxRetries ?? 3;\n this._compress = options.compress ?? false;\n }\n\n async export(spans: Span[]): Promise<ExportResult> {\n if (spans.length === 0) return ExportResult.SUCCESS;\n\n // Circuit breaker: skip if open\n const now = Date.now();\n let isHalfOpen = false;\n if (this._consecutiveFailures >= this._circuitBreakerThreshold) {\n if (now < this._circuitOpenUntil) {\n return ExportResult.FAILURE;\n }\n // Cooldown expired — probe with single request (Audit #7: half-open state)\n isHalfOpen = true;\n }\n\n const body: IngestRequest = {\n spans: spans.map((s) => s.toPayload()),\n };\n if (this._projectId) body.projectId = this._projectId;\n if (this._environment) body.environment = this._environment;\n\n // Half-open: single probe request. Normal: full retry loop.\n const maxAttempts = isHalfOpen ? 1 : this._maxRetries;\n\n // Retry loop with exponential backoff\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n // F-SDK503-001: cleared before EVERY attempt, so a refusal recorded on attempt 1 cannot\n // be read as a refusal on attempt 2 (`_sendRequest` swallows transport errors and\n // returns FAILURE without touching the field).\n this._lastRefusalAfterMs = null;\n const result = await this._sendRequest(body);\n\n if (result === ExportResult.SUCCESS) {\n this._consecutiveFailures = 0;\n return result;\n }\n\n // Backoff. A generic failure is usually a blip worth retrying at once (100/200/400 ms);\n // a CAPACITY REFUSAL waits on the SERVER's terms when the server names them, and an\n // order of magnitude longer when it does not.\n if (attempt < maxAttempts - 1) {\n const refusal = this._lastRefusalAfterMs;\n const delay =\n refusal === null\n ? 100 * Math.pow(2, attempt)\n : refusal === REFUSAL_NO_HINT\n ? REFUSAL_BACKOFF_BASE_MS * Math.pow(2, attempt)\n : refusal;\n await sleep(delay);\n }\n }\n\n // ⚠ F-SDK503-001 — A CAPACITY REFUSAL DOES NOT COUNT TOWARD THE BREAKER.\n //\n // ⚠ THE COUNTER IS LEFT UNTOUCHED, NOT RESET. A refusal is not evidence of health either:\n // resetting would let an alternating 500/503 sequence hold the breaker open-ended at four.\n // It neither advances nor clears.\n const refusedForCapacity = this._lastRefusalAfterMs !== null;\n this._lastRefusalAfterMs = null;\n if (refusedForCapacity) {\n warn(\n `Risicare: the ingest endpoint refused this batch for capacity (HTTP 429/503) after ` +\n `${maxAttempts} attempt(s). This is a healthy server shedding load, not an outage — ` +\n `the batch is dropped but the exporter keeps sending. Reduce batch size or export ` +\n `rate if it persists.`\n );\n return ExportResult.FAILURE;\n }\n\n // All retries failed — update circuit breaker\n this._consecutiveFailures++;\n if (this._consecutiveFailures >= this._circuitBreakerThreshold) {\n this._circuitOpenUntil = Date.now() + this._circuitBreakerCooldownMs;\n warn(\n `HTTP exporter circuit breaker opened after ${this._consecutiveFailures} failures. ` +\n `Cooldown: ${this._circuitBreakerCooldownMs / 1000}s`\n );\n }\n\n return ExportResult.FAILURE;\n }\n\n /**\n * Record a CAPACITY REFUSAL for the retry loop. Returns true if it was one.\n *\n * `Retry-After` is honoured only in its delta-seconds form (RFC 9110 §10.2.3 also permits an\n * HTTP-date); anything else falls back to our own backoff rather than guessing at a date\n * parse.\n */\n private _noteRefusal(status: number, retryAfterRaw: string | null): boolean {\n if (!CAPACITY_REFUSAL_STATUSES.has(status)) return false;\n let delay = REFUSAL_NO_HINT;\n if (retryAfterRaw) {\n const secs = Number(retryAfterRaw);\n if (Number.isFinite(secs) && secs >= 0) {\n delay = Math.min(secs * 1000, RETRY_AFTER_CEILING_MS);\n }\n }\n this._lastRefusalAfterMs = delay;\n debug(`Ingest refused for capacity: HTTP ${status} (Retry-After=${retryAfterRaw})`);\n return true;\n }\n\n private async _sendRequest(body: IngestRequest): Promise<ExportResult> {\n const url = `${this._endpoint}/v1/spans`;\n const headers: Record<string, string> = {\n 'Content-Type': 'application/json',\n 'User-Agent': `risicare-js/${SDK_VERSION} node/${process.version}`,\n // F-SDKVER-001 parity. Python's ingest exporter has always sent\n // `X-Risicare-SDK-Version`; JS sent only a User-Agent, so the two SDKs\n // disagreed about how a client identifies itself. A parser-free header is\n // strictly easier for the gateway to consume than picking a version out of\n // a UA string.\n 'X-Risicare-SDK-Version': SDK_VERSION,\n };\n if (this._apiKey) {\n headers['Authorization'] = `Bearer ${this._apiKey}`;\n }\n\n let payload: string | Uint8Array = JSON.stringify(body);\n\n if (this._compress && payload.length > 1024) {\n try {\n const { gzipSync } = await import('node:zlib');\n payload = gzipSync(Buffer.from(payload));\n headers['Content-Encoding'] = 'gzip';\n } catch (e) {\n // Audit #16: log compression failures instead of silently swallowing\n debug(`Gzip compression failed, sending uncompressed: ${e}`);\n }\n }\n\n try {\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), this._timeoutMs);\n\n const response = await fetch(url, {\n method: 'POST',\n headers,\n body: payload,\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (response.status < 300) {\n return await checkAck(response);\n } else if (response.status === 408 || response.status === 504) {\n debug(`HTTP export timeout: ${response.status}`);\n return ExportResult.TIMEOUT;\n }\n // F-SDK503-001 — still a FAILURE for the return type (the batch did not land), but the\n // loop and the breaker treat it differently.\n this._noteRefusal(response.status, response.headers.get('Retry-After'));\n debug(`HTTP export failed: ${response.status}`);\n return ExportResult.FAILURE;\n } catch (e) {\n debug(`HTTP export error: ${e}`);\n return ExportResult.FAILURE;\n }\n }\n\n shutdown(): void {\n // Native fetch doesn't need cleanup\n }\n}\n\nfunction sleep(ms: number): Promise<void> {\n return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/** An integer that is not a `boolean` (JS `typeof true === 'boolean'`, but be explicit). */\nfunction asCount(v: unknown): number | undefined {\n return typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;\n}\n\n/**\n * Decide SUCCESS/FAILURE from a <300 response, reading the ACK body.\n *\n * ⚠ F-SDKACKBLIND-001. A 2xx is NOT delivery. The gateway answers\n * `StatusCode::OK` unconditionally on the ingest route (`routes/spans.rs`) and\n * reports per-span outcomes in the BODY — `{ accepted, rejected, errors[] }`,\n * camelCase, `errors` omitted when empty. Every span in a batch can be rejected\n * (bad trace-id hex, attribute-cardinality cap, clamps) and the status is still\n * 200. Before 0.5.1 this returned SUCCESS on any status below 300 and never\n * opened the body, so total loss looked like a clean export — and the retry, the\n * circuit breaker and `failedExports` all stayed silent.\n *\n * ⚠ FAIL SAFE, AND THAT IS THE WHOLE DESIGN CONSTRAINT. A body we cannot parse,\n * a body from something that is not our gateway, a field that is missing or not\n * an integer — every one returns SUCCESS, exactly as before. We only turn a 2xx\n * into a FAILURE on an AFFIRMATIVE, well-formed statement that nothing was\n * accepted. Anything less and a proxy that rewrites bodies, or a future gateway\n * that adds a field, becomes an outage.\n *\n * A PARTIAL rejection is deliberately NOT a failure: retrying the whole batch\n * would duplicate the accepted spans, and span-level rejects are permanent.\n * It is surfaced as a warning instead — the signal that was missing.\n *\n * Python twin: `exporters/http.py::_check_ack`. Same rule, same thresholds.\n */\nasync function checkAck(response: Response): Promise<ExportResult> {\n let payload: unknown;\n try {\n payload = await response.json();\n } catch {\n return ExportResult.SUCCESS; // not JSON, or not ours — unchanged behaviour\n }\n if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) {\n return ExportResult.SUCCESS;\n }\n\n const body = payload as Record<string, unknown>;\n const accepted = asCount(body.accepted);\n const rejected = asCount(body.rejected);\n if (accepted === undefined || rejected === undefined || rejected <= 0) {\n return ExportResult.SUCCESS;\n }\n\n const errors = body.errors;\n const detail =\n (typeof body.errorMessage === 'string' && body.errorMessage) ||\n (typeof body.error_message === 'string' && body.error_message) ||\n (Array.isArray(errors) && errors.length > 0 ? JSON.stringify(errors[0]) : '') ||\n 'No reason was returned.';\n\n const total = accepted + rejected;\n if (accepted === 0) {\n warn(\n `Risicare: the backend accepted 0 of ${total} span(s) and rejected ${rejected} — ` +\n `this batch was NOT stored. ${detail}`,\n );\n return ExportResult.FAILURE;\n }\n\n warn(\n `Risicare: the backend rejected ${rejected} of ${total} span(s); the remaining ` +\n `${accepted} were stored. Those ${rejected} are permanently lost and are NOT ` +\n `retried. ${detail}`,\n );\n return ExportResult.SUCCESS;\n}\n","/**\n * Console exporter for debugging.\n *\n * Prints span data to stderr in a readable format.\n */\n\nimport type { Span } from '../span.js';\nimport { ExportResult, type SpanExporter } from './base.js';\n\nexport class ConsoleExporter implements SpanExporter {\n readonly name = 'console';\n\n export(spans: Span[]): ExportResult {\n for (const span of spans) {\n const payload = span.toPayload();\n const line = JSON.stringify(payload);\n process.stderr.write(`[risicare] ${line}\\n`);\n }\n return ExportResult.SUCCESS;\n }\n\n shutdown(): void {\n // Nothing to clean up\n }\n}\n","/**\n * Fix Cache — Local cache for active fixes with TTL eviction.\n *\n * Provides fast lookup of fixes keyed by error code with exact match\n * and wildcard fallback. No locks needed — JS is single-threaded.\n *\n * Port of Python SDK's runtime/cache.py.\n */\n\nimport type { ActiveFix, FixRuntimeConfig } from './config.js';\nimport { matchesError } from './config.js';\nimport { debug } from '../utils/log.js';\n\n// ─── Cache Entry ────────────────────────────────────────────────────────────\n\ninterface CacheEntry {\n fix: ActiveFix;\n createdAt: number;\n expiresAt: number;\n}\n\n// ─── Cache Stats ────────────────────────────────────────────────────────────\n\nexport interface CacheStats {\n hits: number;\n misses: number;\n evictions: number;\n size: number;\n lastRefresh: number | null;\n}\n\n// ─── Fix Cache ──────────────────────────────────────────────────────────────\n\nexport class FixCache {\n private readonly _ttlMs: number;\n private readonly _maxEntries: number;\n private readonly _enabled: boolean;\n private _cache: Map<string, CacheEntry>;\n private _stats: CacheStats;\n\n constructor(config?: Pick<FixRuntimeConfig, 'cacheEnabled' | 'cacheTtlMs' | 'cacheMaxEntries'>) {\n this._enabled = config?.cacheEnabled ?? true;\n this._ttlMs = config?.cacheTtlMs ?? 300_000;\n this._maxEntries = config?.cacheMaxEntries ?? 1000;\n this._cache = new Map();\n this._stats = {\n hits: 0,\n misses: 0,\n evictions: 0,\n size: 0,\n lastRefresh: null,\n };\n }\n\n /** Whether caching is enabled. */\n get enabled(): boolean {\n return this._enabled;\n }\n\n /**\n * Get a fix by error code.\n *\n * Checks exact match first, then scans for wildcard matches.\n * Expired entries are evicted on access.\n */\n get(errorCode: string): ActiveFix | null {\n try {\n if (!this._enabled) return null;\n\n const now = Date.now();\n\n // Try exact match first (fast path)\n const exactEntry = this._cache.get(errorCode);\n if (exactEntry) {\n if (exactEntry.expiresAt > now) {\n this._stats.hits++;\n return exactEntry.fix;\n }\n // Expired — evict\n this._cache.delete(errorCode);\n this._stats.evictions++;\n }\n\n // Wildcard scan (slower path)\n for (const [key, entry] of this._cache) {\n if (entry.expiresAt <= now) {\n this._cache.delete(key);\n this._stats.evictions++;\n continue;\n }\n\n if (matchesError(entry.fix, errorCode)) {\n this._stats.hits++;\n return entry.fix;\n }\n }\n\n this._stats.misses++;\n return null;\n } catch (e) {\n debug(`FixCache.get error: ${e}`);\n return null;\n }\n }\n\n /**\n * Add a single fix to the cache.\n *\n * Evicts the oldest entry if at capacity.\n */\n set(fix: ActiveFix): void {\n try {\n if (!this._enabled) return;\n\n // Evict oldest if at capacity\n if (this._cache.size >= this._maxEntries) {\n this._evictOldest();\n }\n\n const now = Date.now();\n this._cache.set(fix.errorCode, {\n fix,\n createdAt: now,\n expiresAt: now + this._ttlMs,\n });\n this._stats.size = this._cache.size;\n } catch (e) {\n debug(`FixCache.set error: ${e}`);\n }\n }\n\n /**\n * Replace all cached fixes (bulk refresh).\n *\n * Clears the cache and populates with the given fixes.\n */\n setAll(fixes: ActiveFix[]): void {\n try {\n if (!this._enabled) return;\n\n this._cache.clear();\n const now = Date.now();\n\n for (const fix of fixes) {\n if (this._cache.size >= this._maxEntries) break;\n\n this._cache.set(fix.errorCode, {\n fix,\n createdAt: now,\n expiresAt: now + this._ttlMs,\n });\n }\n\n this._stats.size = this._cache.size;\n this._stats.lastRefresh = now;\n } catch (e) {\n debug(`FixCache.setAll error: ${e}`);\n }\n }\n\n /**\n * Get all non-expired fixes.\n */\n getAll(): ActiveFix[] {\n try {\n const now = Date.now();\n const valid: ActiveFix[] = [];\n const expired: string[] = [];\n\n for (const [key, entry] of this._cache) {\n if (entry.expiresAt > now) {\n valid.push(entry.fix);\n } else {\n expired.push(key);\n }\n }\n\n // Clean up expired entries\n for (const key of expired) {\n this._cache.delete(key);\n this._stats.evictions++;\n }\n\n this._stats.size = this._cache.size;\n return valid;\n } catch (e) {\n debug(`FixCache.getAll error: ${e}`);\n return [];\n }\n }\n\n /** Clear all cache entries. Returns the number of entries cleared. */\n clear(): number {\n const count = this._cache.size;\n this._cache.clear();\n this._stats.size = 0;\n return count;\n }\n\n /** Get cache statistics. */\n get stats(): CacheStats {\n this._stats.size = this._cache.size;\n return { ...this._stats };\n }\n\n /** Evict the oldest cache entry. */\n private _evictOldest(): void {\n if (this._cache.size === 0) return;\n\n let oldestKey: string | null = null;\n let oldestTime = Infinity;\n\n for (const [key, entry] of this._cache) {\n if (entry.createdAt < oldestTime) {\n oldestTime = entry.createdAt;\n oldestKey = key;\n }\n }\n\n if (oldestKey !== null) {\n this._cache.delete(oldestKey);\n this._stats.evictions++;\n }\n }\n}\n","/**\n * Fix Applier — Applies fixes to agent operations.\n *\n * Handles different fix types:\n * - PromptFix: Modify system/user prompts (prepend, append, replace, few_shot)\n * - ParameterFix: Adjust LLM parameters (temperature, model, etc.)\n * - RetryFix: Retry with exponential backoff + jitter\n * - FallbackFix: Switch to fallback model or default response\n * - GuardFix: Input/output validation (content filter, format check, length)\n *\n * Port of Python SDK's runtime/applier.py adapted for Node.js.\n */\n\nimport { createHash } from 'node:crypto';\nimport type { ActiveFix, FixRuntimeConfig } from './config.js';\nimport { shouldApply, resolveFixRuntimeConfig } from './config.js';\nimport type { FixCache } from './cache.js';\nimport { debug, warn } from '../utils/log.js';\n\n/**\n * Maximum length for fix content injected into prompts.\n * Prevents unbounded prompt injection from malicious/corrupted fix configs.\n */\nconst MAX_FIX_CONTENT_LENGTH = 10_000;\n\n// ─── Apply Result ───────────────────────────────────────────────────────────\n\nexport interface ApplyResult {\n applied: boolean;\n fixId?: string;\n deploymentId?: string;\n fixType?: string;\n modifications: Record<string, unknown>;\n error?: string;\n /**\n * Guard-only: human-readable reason a guard failed (passed=false). Used\n * by GuardRejectedError to surface an actionable message to the customer.\n * `error` carries the raw exception text; `reason` carries the audit\n * category ('guard_exception', 'content_filter', 'format_check', etc.).\n */\n reason?: string;\n}\n\nfunction emptyResult(fix: ActiveFix, fixType: string): ApplyResult {\n return {\n applied: false,\n fixId: fix.fixId,\n deploymentId: fix.deploymentId,\n fixType,\n modifications: {},\n };\n}\n\n// ─── Fix Applier ────────────────────────────────────────────────────────────\n\nexport class FixApplier {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n private _applicationLog: ApplyResult[] = [];\n\n constructor(config: FixRuntimeConfig, cache: FixCache) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = cache;\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // Fix Lookup\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Get applicable fix for an error code.\n *\n * Considers A/B testing bucket if sessionId is provided. Uses\n * crypto.createHash('md5') for deterministic bucketing across restarts.\n */\n getFixForError(\n errorCode: string,\n sessionId?: string,\n ): ActiveFix | null {\n try {\n const fix = this._cache.get(errorCode);\n if (!fix) return null;\n\n // Check A/B test bucketing\n if (sessionId && this._config.abTestingEnabled) {\n const hashHex = createHash('md5')\n .update(sessionId)\n .digest('hex')\n .substring(0, 8);\n const sessionHash = parseInt(hashHex, 16);\n\n if (!shouldApply(fix, sessionHash)) {\n debug(`Fix ${fix.fixId} not applied (A/B control group)`);\n return null;\n }\n }\n\n return fix;\n } catch (e) {\n debug(`getFixForError error: ${e}`);\n return null;\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 1. Prompt Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a prompt fix to messages.\n *\n * Supports 4 modification types:\n * - prepend: Add content before first system message\n * - append: Add content after first system message\n * - replace: Regex replace across all messages\n * - few_shot: Insert user/assistant example pairs after system message\n */\n applyPromptFix(\n fix: ActiveFix,\n messages: Record<string, unknown>[],\n ): { messages: Record<string, unknown>[]; result: ApplyResult } {\n try {\n const cfg = fix.config;\n const modificationType = (cfg.modification_type ?? cfg.modificationType ?? 'append') as string;\n const target = (cfg.target ?? 'system') as string;\n let content = (cfg.content ?? '') as string;\n\n // Truncate oversized content to prevent prompt injection\n if (content.length > MAX_FIX_CONTENT_LENGTH) {\n warn(\n `Fix ${fix.fixId} content truncated from ${content.length} to ${MAX_FIX_CONTENT_LENGTH} chars`,\n );\n content = content.slice(0, MAX_FIX_CONTENT_LENGTH);\n }\n\n const result = emptyResult(fix, 'prompt');\n\n if (this._config.dryRun) {\n result.modifications = {\n type: modificationType,\n target,\n contentPreview: content.slice(0, 100),\n };\n return { messages, result };\n }\n\n let modified = messages.map((m) => ({ ...m }));\n\n if (modificationType === 'prepend') {\n modified = this._prependToTarget(modified, target, content);\n result.applied = true;\n result.modifications = { type: 'prepend', target };\n } else if (modificationType === 'append') {\n modified = this._appendToTarget(modified, target, content);\n result.applied = true;\n result.modifications = { type: 'append', target };\n } else if (modificationType === 'replace') {\n const pattern = (cfg.pattern ?? '') as string;\n if (pattern) {\n modified = this._replaceInMessages(modified, pattern, content);\n result.applied = true;\n result.modifications = { type: 'replace', pattern };\n }\n } else if (modificationType === 'few_shot') {\n const examples = (cfg.examples ?? []) as Array<Record<string, string>>;\n if (examples.length > 0) {\n modified = this._addFewShotExamples(modified, examples);\n result.applied = true;\n result.modifications = { type: 'few_shot', count: examples.length };\n }\n }\n\n return { messages: modified, result };\n } catch (e) {\n debug(`applyPromptFix error: ${e}`);\n return {\n messages,\n result: {\n applied: false,\n fixId: fix.fixId,\n fixType: 'prompt',\n modifications: {},\n error: String(e),\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 2. Parameter Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a parameter fix — merge config.parameters into params.\n */\n applyParameterFix(\n fix: ActiveFix,\n params: Record<string, unknown>,\n ): { params: Record<string, unknown>; result: ApplyResult } {\n try {\n const newParams = (fix.config.parameters ?? {}) as Record<string, unknown>;\n const result = emptyResult(fix, 'parameter');\n\n if (this._config.dryRun) {\n result.modifications = { parameters: newParams };\n return { params, result };\n }\n\n const modified = { ...params, ...newParams };\n result.applied = true;\n result.modifications = { parameters: newParams };\n\n return { params: modified, result };\n } catch (e) {\n debug(`applyParameterFix error: ${e}`);\n return {\n params,\n result: {\n applied: false,\n fixId: fix.fixId,\n fixType: 'parameter',\n modifications: {},\n error: String(e),\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 3. Retry Fix (async — uses setTimeout for sleeping)\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a retry fix to an async operation.\n *\n * Retries with exponential backoff + jitter using\n * `await new Promise(r => setTimeout(r, delay))`.\n */\n async applyRetryFix<T>(\n fix: ActiveFix,\n operation: () => Promise<T>,\n ): Promise<{ value: T; result: ApplyResult }> {\n const cfg = fix.config;\n const maxRetries = (cfg.max_retries ?? cfg.maxRetries ?? 3) as number;\n const initialDelayMs = (cfg.initial_delay_ms ?? cfg.initialDelayMs ?? 1000) as number;\n const maxDelayMs = (cfg.max_delay_ms ?? cfg.maxDelayMs ?? 30_000) as number;\n const exponentialBase = (cfg.exponential_base ?? cfg.exponentialBase ?? 2.0) as number;\n const jitter = (cfg.jitter ?? true) as boolean;\n const retryOn = (cfg.retry_on ?? cfg.retryOn ?? []) as string[];\n\n const result = emptyResult(fix, 'retry');\n\n if (this._config.dryRun) {\n result.modifications = { maxRetries, initialDelayMs };\n const value = await operation();\n return { value, result };\n }\n\n let lastError: Error | null = null;\n let attempts = 0;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n attempts++;\n try {\n const value = await operation();\n result.applied = true;\n result.modifications = { attempts };\n return { value, result };\n } catch (e) {\n lastError = e instanceof Error ? e : new Error(String(e));\n const errorType = lastError.constructor.name;\n\n // Check if we should retry this specific error type\n if (retryOn.length > 0 && !retryOn.includes(errorType)) {\n throw lastError;\n }\n\n if (attempt < maxRetries) {\n // Calculate delay with exponential backoff\n let delayMs = Math.min(\n initialDelayMs * Math.pow(exponentialBase, attempt),\n maxDelayMs,\n );\n\n // Add jitter: multiply by random factor [0.5, 1.5)\n if (jitter) {\n delayMs *= 0.5 + Math.random();\n }\n\n debug(\n `Retry ${attempt + 1}/${maxRetries} after ${Math.round(delayMs)}ms`,\n );\n await new Promise<void>((r) => setTimeout(r, delayMs));\n }\n }\n }\n\n // All retries exhausted\n result.applied = true;\n result.error = lastError?.message;\n result.modifications = { attempts, exhausted: true };\n throw lastError;\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 4. Fallback Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a fallback fix.\n *\n * - 'model': Replace params.model with the fallback model\n * - 'default': Set params._fallbackResponse for the caller to use\n */\n applyFallbackFix(\n fix: ActiveFix,\n params: Record<string, unknown>,\n ): { params: Record<string, unknown>; result: ApplyResult } {\n try {\n const cfg = fix.config;\n const fallbackType = (cfg.fallback_type ?? cfg.fallbackType ?? 'model') as string;\n const fallbackConfig = (cfg.fallback_config ?? cfg.fallbackConfig ?? {}) as Record<string, unknown>;\n const result = emptyResult(fix, 'fallback');\n\n if (this._config.dryRun) {\n result.modifications = { fallbackType, fallbackConfig };\n return { params, result };\n }\n\n const modified = { ...params };\n\n if (fallbackType === 'model') {\n const fallbackModel = fallbackConfig.model as string | undefined;\n if (fallbackModel) {\n modified.model = fallbackModel;\n result.applied = true;\n result.modifications = { model: fallbackModel };\n }\n } else if (fallbackType === 'default') {\n const defaultResponse = fallbackConfig.response;\n if (defaultResponse !== undefined) {\n modified._fallbackResponse = defaultResponse;\n result.applied = true;\n result.modifications = { defaultResponse: true };\n }\n }\n\n return { params: modified, result };\n } catch (e) {\n debug(`applyFallbackFix error: ${e}`);\n return {\n params,\n result: {\n applied: false,\n fixId: fix.fixId,\n fixType: 'fallback',\n modifications: {},\n error: String(e),\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 5. Guard Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a guard fix (validation).\n *\n * Guard types:\n * - content_filter: Regex-based blocked patterns\n * - format_check: JSON.parse() validity\n * - input_validation / output_validation: min/max length\n */\n applyGuardFix(\n fix: ActiveFix,\n content: string,\n isInput = true,\n ): { content: string; passed: boolean; result: ApplyResult } {\n try {\n const cfg = fix.config;\n const guardType = (cfg.guard_type ?? cfg.guardType ?? 'output_validation') as string;\n const guardConfig = (cfg.guard_config ?? cfg.guardConfig ?? {}) as Record<string, unknown>;\n const result = emptyResult(fix, 'guard');\n\n // Check if guard applies to this direction\n if (isInput && guardType !== 'input_validation' && guardType !== 'content_filter') {\n return { content, passed: true, result };\n }\n if (!isInput && guardType !== 'output_validation' && guardType !== 'format_check') {\n return { content, passed: true, result };\n }\n\n if (this._config.dryRun) {\n result.modifications = { guardType };\n return { content, passed: true, result };\n }\n\n let passed = true;\n let reason: string | undefined;\n\n if (guardType === 'content_filter') {\n const blockedPatterns = (guardConfig.blocked_patterns ?? guardConfig.blockedPatterns ?? []) as string[];\n for (const pattern of blockedPatterns) {\n const regex = this._safeCompileRegex(pattern);\n if (regex && regex.test(content)) {\n passed = false;\n reason = `blocked pattern matched: ${pattern.slice(0, 80)}`;\n break;\n }\n }\n } else if (guardType === 'format_check') {\n const requiredFormat = guardConfig.format as string | undefined;\n if (requiredFormat === 'json') {\n try {\n JSON.parse(content);\n } catch {\n passed = false;\n reason = 'format_check: invalid JSON';\n }\n }\n } else if (guardType === 'input_validation' || guardType === 'output_validation') {\n const minLength = (guardConfig.min_length ?? guardConfig.minLength ?? 0) as number;\n const maxLength = (guardConfig.max_length ?? guardConfig.maxLength ?? Infinity) as number;\n if (content.length < minLength || content.length > maxLength) {\n passed = false;\n reason = `${guardType}: length ${content.length} outside [${minLength}, ${maxLength}]`;\n }\n }\n\n result.applied = true;\n result.modifications = { passed, guardType };\n if (reason !== undefined) result.reason = reason;\n\n return { content, passed, result };\n } catch (e) {\n // F-731: Fail-CLOSED on guard error. An unexpected exception in a\n // safety-validation path MUST NOT silently pass content through —\n // that would defeat the entire purpose of input/output validation.\n // PR-4+5 review B2 (2026-05-25): the interceptor LAYER now reads\n // `passed:false` and throws GuardRejectedError to short-circuit the\n // LLM call. Before B2 this `passed:false` was advisory only — the\n // provider patcher consumed `modifications` / `messages` but never\n // read `passed`, so a thrown-getter attack still hit the LLM with\n // the attacker payload. The applier's job is to TELL the truth;\n // the interceptor's job is to ACT on it.\n warn(`applyGuardFix error (failing CLOSED): ${e}`);\n return {\n content,\n passed: false,\n result: {\n applied: true,\n fixId: fix.fixId,\n fixType: 'guard',\n modifications: { passed: false, reason: 'guard_exception' },\n error: String(e),\n reason: 'guard_exception',\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // Application Log\n // ═══════════════════════════════════════════════════════════════════════════\n\n /** Log a fix application result. */\n logApplication(result: ApplyResult): void {\n this._applicationLog.push(result);\n\n // Limit log size\n if (this._applicationLog.length > 1000) {\n this._applicationLog = this._applicationLog.slice(-500);\n }\n }\n\n /** Get the application log. */\n getApplicationLog(): ApplyResult[] {\n return [...this._applicationLog];\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // Private Helpers\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Safely compile a regex pattern from untrusted input.\n * Returns null if invalid or too long.\n */\n private _safeCompileRegex(\n pattern: string,\n maxLength = 500,\n ): RegExp | null {\n if (!pattern || pattern.length > maxLength) return null;\n try {\n return new RegExp(pattern, 'i');\n } catch {\n debug(`Invalid regex pattern (length=${pattern.length})`);\n return null;\n }\n }\n\n /** Prepend content to the first message matching the target role. */\n private _prependToTarget(\n messages: Record<string, unknown>[],\n target: string,\n content: string,\n ): Record<string, unknown>[] {\n return messages.map((msg) => {\n if (msg.role === target) {\n return {\n ...msg,\n content: content + '\\n\\n' + ((msg.content as string) ?? ''),\n };\n }\n return msg;\n });\n }\n\n /** Append content to the first message matching the target role. */\n private _appendToTarget(\n messages: Record<string, unknown>[],\n target: string,\n content: string,\n ): Record<string, unknown>[] {\n return messages.map((msg) => {\n if (msg.role === target) {\n return {\n ...msg,\n content: ((msg.content as string) ?? '') + '\\n\\n' + content,\n };\n }\n return msg;\n });\n }\n\n /** Regex replace across all messages. */\n private _replaceInMessages(\n messages: Record<string, unknown>[],\n pattern: string,\n replacement: string,\n ): Record<string, unknown>[] {\n const regex = this._safeCompileRegex(pattern);\n if (!regex) {\n debug('Skipping invalid regex pattern in prompt fix');\n return messages;\n }\n\n return messages.map((msg) => {\n const msgContent = msg.content;\n if (typeof msgContent === 'string') {\n return { ...msg, content: msgContent.replace(regex, replacement) };\n }\n return msg;\n });\n }\n\n /** Add few-shot examples after the first system message. */\n private _addFewShotExamples(\n messages: Record<string, unknown>[],\n examples: Array<Record<string, string>>,\n ): Record<string, unknown>[] {\n const result: Record<string, unknown>[] = [];\n let systemFound = false;\n\n for (const msg of messages) {\n result.push(msg);\n\n if (msg.role === 'system' && !systemFound) {\n systemFound = true;\n for (const example of examples) {\n if (example.user) {\n result.push({ role: 'user', content: example.user });\n }\n if (example.assistant) {\n result.push({ role: 'assistant', content: example.assistant });\n }\n }\n }\n }\n\n return result;\n }\n}\n","/**\n * Fix Loader — Fetches active fixes from the Risicare API.\n *\n * Handles:\n * - Initial loading of fixes on startup\n * - Periodic background refresh via setInterval (unref'd)\n * - Exponential backoff on failure\n * - Circuit breaker: after 3 consecutive failures, stop trying for 30s\n *\n * Uses native fetch (Node.js 18+) with AbortController for timeouts.\n *\n * Port of Python SDK's runtime/loader.py adapted for Node.js.\n */\n\nimport type { ActiveFix } from './config.js';\nimport { activeFixFromApiResponse } from './config.js';\nimport type { FixRuntimeConfig } from './config.js';\nimport { resolveFixRuntimeConfig } from './config.js';\nimport type { FixCache } from './cache.js';\nimport { debug, warn } from '../utils/log.js';\nimport { SDK_VERSION } from '../version.js';\n\nexport class FixLoader {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n\n private _refreshTimer: ReturnType<typeof setInterval> | null = null;\n private _lastLoadTime: number | null = null;\n private _consecutiveFailures = 0;\n private _circuitOpenUntil = 0;\n private _onLoadCallbacks: Array<(fixes: ActiveFix[]) => void> = [];\n\n // Circuit breaker settings\n private static readonly CIRCUIT_BREAKER_THRESHOLD = 3;\n private static readonly CIRCUIT_BREAKER_COOLDOWN_MS = 30_000;\n\n constructor(config: FixRuntimeConfig, cache: FixCache) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = cache;\n }\n\n /** Timestamp of last successful load. */\n get lastLoadTime(): number | null {\n return this._lastLoadTime;\n }\n\n /**\n * Start the loader: perform initial load and start background refresh.\n *\n * Never throws — failures are logged and the runtime degrades gracefully.\n */\n start(): void {\n try {\n if (!this._config.enabled) {\n debug('Fix runtime disabled, skipping loader start');\n return;\n }\n\n if (!this._config.apiKey) {\n warn('No API key configured, fixes will not be loaded');\n return;\n }\n\n // Initial load (fire-and-forget — don't block startup)\n this.loadSync().catch((e) => {\n debug(`Initial fix load failed: ${e}`);\n });\n\n // Start background refresh\n if (this._config.autoRefresh) {\n this._startRefreshInterval();\n }\n } catch (e) {\n debug(`FixLoader.start error: ${e}`);\n }\n }\n\n /** Stop the loader: clear the refresh interval. */\n stop(): void {\n try {\n if (this._refreshTimer !== null) {\n clearInterval(this._refreshTimer);\n this._refreshTimer = null;\n }\n } catch (e) {\n debug(`FixLoader.stop error: ${e}`);\n }\n }\n\n /**\n * Register a callback invoked after each successful load.\n */\n onLoad(callback: (fixes: ActiveFix[]) => void): void {\n this._onLoadCallbacks.push(callback);\n }\n\n /**\n * Load fixes from the API.\n *\n * Name kept as \"loadSync\" for parity with the Python SDK, but this\n * returns a Promise in JS (there's no synchronous fetch in Node.js).\n */\n async loadSync(): Promise<ActiveFix[]> {\n if (!this._config.apiKey) {\n return [];\n }\n\n // Circuit breaker: skip if circuit is open\n const now = Date.now();\n if (\n this._consecutiveFailures >= FixLoader.CIRCUIT_BREAKER_THRESHOLD &&\n now < this._circuitOpenUntil\n ) {\n debug('Fix loader circuit breaker open — skipping load');\n return this._cache.getAll();\n }\n\n try {\n // Build URL: /api/v1/ routes to FastAPI via Caddy (NOT /v1/ which is the Rust gateway)\n const endpoint = this._config.apiEndpoint.replace(/\\/+$/, '');\n const url = `${endpoint}/api/v1/fixes/active`;\n\n // AbortController for timeout\n const controller = new AbortController();\n const timeoutId = setTimeout(\n () => controller.abort(),\n this._config.timeoutMs,\n );\n\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Authorization': `Bearer ${this._config.apiKey}`,\n 'Content-Type': 'application/json',\n 'X-Risicare-SDK-Version': SDK_VERSION,\n },\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) {\n throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n }\n\n const data = (await response.json()) as Record<string, unknown>;\n const fixes = this._parseResponse(data);\n this._onLoadSuccess(fixes);\n return fixes;\n } catch (e) {\n this._onLoadFailure(e as Error);\n throw e;\n }\n }\n\n /** Get currently cached fixes without hitting the API. */\n getCached(): ActiveFix[] {\n return this._cache.getAll();\n }\n\n // ─── Private ────────────────────────────────────────────────────────────\n\n private _parseResponse(data: Record<string, unknown>): ActiveFix[] {\n const fixes: ActiveFix[] = [];\n const items =\n (data.fixes as unknown[]) ??\n (data.data as unknown[]) ??\n [];\n\n if (!Array.isArray(items)) return fixes;\n\n for (const item of items) {\n try {\n if (item && typeof item === 'object') {\n fixes.push(activeFixFromApiResponse(item as Record<string, unknown>));\n }\n } catch (e) {\n debug(`Failed to parse fix item: ${e}`);\n }\n }\n\n return fixes;\n }\n\n private _onLoadSuccess(fixes: ActiveFix[]): void {\n this._lastLoadTime = Date.now();\n this._consecutiveFailures = 0;\n\n // Update cache\n this._cache.setAll(fixes);\n\n // Notify callbacks\n for (const callback of this._onLoadCallbacks) {\n try {\n callback(fixes);\n } catch (e) {\n debug(`Load callback error: ${e}`);\n }\n }\n\n debug(`Loaded ${fixes.length} active fixes`);\n }\n\n private _onLoadFailure(error: Error): void {\n this._consecutiveFailures++;\n\n if (this._consecutiveFailures >= FixLoader.CIRCUIT_BREAKER_THRESHOLD) {\n this._circuitOpenUntil = Date.now() + FixLoader.CIRCUIT_BREAKER_COOLDOWN_MS;\n warn(\n `Fix loader circuit breaker opened after ${this._consecutiveFailures} failures. ` +\n `Cooldown: ${FixLoader.CIRCUIT_BREAKER_COOLDOWN_MS / 1000}s`,\n );\n } else {\n debug(\n `Fix load failed (attempt ${this._consecutiveFailures}): ${error.message}`,\n );\n }\n }\n\n private _startRefreshInterval(): void {\n // Use exponential backoff on the refresh interval after failures\n const tick = (): void => {\n this.loadSync().catch((e) => {\n debug(`Background fix refresh failed: ${e}`);\n });\n };\n\n this._refreshTimer = setInterval(\n () => {\n // Skip if circuit breaker is open (loadSync handles this,\n // but we also avoid the async overhead)\n if (\n this._consecutiveFailures >= FixLoader.CIRCUIT_BREAKER_THRESHOLD &&\n Date.now() < this._circuitOpenUntil\n ) {\n return;\n }\n tick();\n },\n this._config.refreshIntervalMs,\n );\n\n // unref() so the interval doesn't prevent Node.js process exit\n this._refreshTimer.unref();\n\n debug('Started fix refresh interval');\n }\n}\n","/**\n * Fix Runtime — Main orchestrator for the fix application system.\n *\n * Manages:\n * - Loading active fixes from the API (via FixLoader)\n * - Caching fixes locally (via FixCache)\n * - Applying fixes via interceptors (via DefaultFixInterceptor)\n * - Tracking fix effectiveness\n *\n * Singleton management via globalThis (same pattern as the tracer).\n *\n * Port of Python SDK's runtime/runtime.py adapted for Node.js.\n */\n\nimport { FixCache } from './cache.js';\nimport type { ActiveFix, FixRuntimeConfig } from './config.js';\nimport { resolveFixRuntimeConfig } from './config.js';\nimport { FixApplier } from './applier.js';\nimport { FixLoader } from './loader.js';\nimport {\n DefaultFixInterceptor,\n createInterceptContext,\n GuardRejectedError,\n type FixInterceptor,\n type InterceptContext,\n} from './interceptors.js';\nimport { debug, warn } from '../utils/log.js';\n\n// ─── globalThis singleton key ───────────────────────────────────────────────\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst G = globalThis as any;\nconst RUNTIME_KEY = '__risicare_fix_runtime';\n\n// ─── Fix Runtime ────────────────────────────────────────────────────────────\n\nexport class FixRuntime {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n private readonly _loader: FixLoader;\n private readonly _applier: FixApplier;\n private readonly _interceptor: DefaultFixInterceptor;\n private _started = false;\n\n // Effectiveness tracking\n private _fixApplications = new Map<string, number>();\n private _fixSuccesses = new Map<string, number>();\n\n constructor(config: FixRuntimeConfig) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = new FixCache(this._config);\n this._loader = new FixLoader(config, this._cache);\n this._applier = new FixApplier(config, this._cache);\n this._interceptor = new DefaultFixInterceptor(\n config,\n this._cache,\n this._applier,\n );\n }\n\n // ─── Accessors ──────────────────────────────────────────────────────────\n\n /** Runtime configuration (with defaults resolved). */\n get config(): Required<FixRuntimeConfig> {\n return this._config;\n }\n\n /** Whether the runtime is enabled and started. */\n get isEnabled(): boolean {\n return this._config.enabled && this._started;\n }\n\n /** The fix cache. */\n get cache(): FixCache {\n return this._cache;\n }\n\n /** The fix loader. */\n get loader(): FixLoader {\n return this._loader;\n }\n\n /** The fix applier. */\n get applier(): FixApplier {\n return this._applier;\n }\n\n /** The interceptor. */\n get interceptor(): FixInterceptor {\n return this._interceptor;\n }\n\n // ─── Lifecycle ──────────────────────────────────────────────────────────\n\n /**\n * Start the runtime.\n *\n * Triggers initial fix load and starts background refresh.\n * Never throws — failures degrade gracefully.\n */\n start(): void {\n try {\n if (this._started) return;\n\n if (!this._config.enabled) {\n debug('Fix runtime disabled');\n return;\n }\n\n debug('Starting fix runtime...');\n this._loader.start();\n this._started = true;\n debug('Fix runtime started');\n } catch (e) {\n warn(`Fix runtime start failed: ${e}`);\n }\n }\n\n /**\n * Stop the runtime.\n *\n * Stops background refresh and clears the cache.\n * Never throws.\n */\n stop(): void {\n try {\n if (!this._started) return;\n\n debug('Stopping fix runtime...');\n this._loader.stop();\n this._cache.clear();\n this._started = false;\n debug('Fix runtime stopped');\n } catch (e) {\n debug(`Fix runtime stop error: ${e}`);\n }\n }\n\n // ─── Intercept API ──────────────────────────────────────────────────────\n\n /**\n * Intercept a call: create context and run preCall fixes.\n *\n * Returns modified messages/params and the InterceptContext for\n * use in subsequent interceptResponse / interceptError calls.\n */\n interceptCall(\n operationType: string,\n operationName: string,\n messages: unknown[] | null,\n params: Record<string, unknown>,\n options?: {\n sessionId?: string;\n traceId?: string;\n errorCode?: string;\n },\n ): {\n messages: unknown[] | null;\n params: Record<string, unknown>;\n ctx: InterceptContext;\n } {\n const ctx = createInterceptContext(operationType, operationName, options);\n\n try {\n if (!this.isEnabled) {\n return { messages, params, ctx };\n }\n\n const result = this._interceptor.preCall(ctx, messages, params);\n return { messages: result.messages, params: result.params, ctx };\n } catch (e) {\n // PR-4+5 review B2: GuardRejectedError MUST surface to the provider\n // patcher so the LLM call is aborted. Everything else degrades to the\n // unmodified call (FixRuntime failures must never break customers).\n if (e instanceof GuardRejectedError) throw e;\n debug(`interceptCall error: ${e}`);\n return { messages, params, ctx };\n }\n }\n\n /**\n * Intercept a response: run postCall fixes (output validation).\n */\n interceptResponse(\n ctx: InterceptContext,\n response: unknown,\n ): { response: unknown; shouldContinue: boolean } {\n try {\n if (!this.isEnabled) {\n return { response, shouldContinue: true };\n }\n\n const result = this._interceptor.postCall(ctx, response);\n\n // Track success for effectiveness\n this._trackSuccess(ctx);\n\n return result;\n } catch (e) {\n // PR-4+5 review B2: same as interceptCall — output guard rejections\n // must surface; everything else degrades.\n if (e instanceof GuardRejectedError) throw e;\n debug(`interceptResponse error: ${e}`);\n return { response, shouldContinue: true };\n }\n }\n\n /**\n * Intercept an error: decide on retry/fallback.\n */\n interceptError(\n ctx: InterceptContext,\n error: Error,\n ): { shouldRetry: boolean; modifiedParams: Record<string, unknown> | null } {\n try {\n if (!this.isEnabled) {\n return { shouldRetry: false, modifiedParams: null };\n }\n\n ctx.attempt++;\n const result = this._interceptor.onError(ctx, error);\n\n // If not retrying, track failure for effectiveness\n if (!result.shouldRetry) {\n this._trackFailure(ctx);\n }\n\n return result;\n } catch (e) {\n debug(`interceptError error: ${e}`);\n return { shouldRetry: false, modifiedParams: null };\n }\n }\n\n // ─── Direct Fix Access ──────────────────────────────────────────────────\n\n /**\n * Get applicable fix for an error code.\n */\n getFix(errorCode: string, sessionId?: string): ActiveFix | null {\n try {\n if (!this.isEnabled) return null;\n return this._applier.getFixForError(errorCode, sessionId);\n } catch (e) {\n debug(`getFix error: ${e}`);\n return null;\n }\n }\n\n /**\n * Manually refresh fixes from the API.\n */\n async refreshFixes(): Promise<ActiveFix[]> {\n try {\n return await this._loader.loadSync();\n } catch (e) {\n debug(`refreshFixes error: ${e}`);\n return [];\n }\n }\n\n // ─── Effectiveness ──────────────────────────────────────────────────────\n\n /** Get effectiveness statistics for all fixes. */\n getEffectivenessStats(): Record<\n string,\n { applications: number; successes: number; successRate: number }\n > {\n const stats: Record<\n string,\n { applications: number; successes: number; successRate: number }\n > = {};\n\n for (const [fixId, applications] of this._fixApplications) {\n const successes = this._fixSuccesses.get(fixId) ?? 0;\n stats[fixId] = {\n applications,\n successes,\n successRate: applications > 0 ? successes / applications : 0,\n };\n }\n\n return stats;\n }\n\n // ─── Private ────────────────────────────────────────────────────────────\n\n private _trackSuccess(ctx: InterceptContext): void {\n for (const result of ctx.appliedFixes) {\n if (result.applied && result.fixId) {\n this._fixApplications.set(\n result.fixId,\n (this._fixApplications.get(result.fixId) ?? 0) + 1,\n );\n this._fixSuccesses.set(\n result.fixId,\n (this._fixSuccesses.get(result.fixId) ?? 0) + 1,\n );\n }\n }\n }\n\n private _trackFailure(ctx: InterceptContext): void {\n for (const result of ctx.appliedFixes) {\n if (result.applied && result.fixId) {\n this._fixApplications.set(\n result.fixId,\n (this._fixApplications.get(result.fixId) ?? 0) + 1,\n );\n // Don't increment success count\n }\n }\n }\n}\n\n// ─── Singleton Management ───────────────────────────────────────────────────\n\n/** Get the global FixRuntime instance, if initialized. */\nexport function getFixRuntime(): FixRuntime | undefined {\n return G[RUNTIME_KEY] as FixRuntime | undefined;\n}\n\n/** Set the global FixRuntime instance (for advanced use). */\nexport function setFixRuntime(runtime: FixRuntime): void {\n G[RUNTIME_KEY] = runtime;\n}\n\n/**\n * Initialize and start the global FixRuntime.\n *\n * If already initialized, returns the existing instance.\n * Never throws — initialization failures degrade gracefully.\n */\nexport function initFixRuntime(config: FixRuntimeConfig): FixRuntime {\n try {\n const existing = G[RUNTIME_KEY] as FixRuntime | undefined;\n if (existing) {\n debug('Fix runtime already initialized');\n return existing;\n }\n\n const runtime = new FixRuntime(config);\n runtime.start();\n G[RUNTIME_KEY] = runtime;\n return runtime;\n } catch (e) {\n warn(`initFixRuntime failed: ${e}`);\n // Return a disabled runtime so callers don't need null checks\n const fallback = new FixRuntime({ ...config, enabled: false });\n G[RUNTIME_KEY] = fallback;\n return fallback;\n }\n}\n\n/**\n * Shutdown and remove the global FixRuntime.\n *\n * Never throws.\n */\nexport function shutdownFixRuntime(): void {\n try {\n const runtime = G[RUNTIME_KEY] as FixRuntime | undefined;\n if (runtime) {\n runtime.stop();\n }\n G[RUNTIME_KEY] = undefined;\n } catch (e) {\n debug(`shutdownFixRuntime error: ${e}`);\n G[RUNTIME_KEY] = undefined;\n }\n}\n","/**\n * Agent context — identifies which agent is executing.\n * Supports nesting: inner agents automatically track parent.\n */\n\nimport { generateAgentId } from '../ids.js';\nimport { runWithContext, getCurrentAgent, type AgentContext } from './storage.js';\n\nexport interface AgentOptions {\n agentId?: string;\n name?: string;\n role?: string;\n agentType?: string;\n version?: number;\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Run a callback within an agent context.\n * If nested inside another agent, parentAgentId is set automatically.\n *\n * @example\n * await withAgent({ name: 'researcher', role: 'worker' }, async () => {\n * const result = await llm.invoke(query);\n * return result;\n * });\n */\nexport function withAgent<T>(options: AgentOptions, fn: () => T): T {\n const parent = getCurrentAgent();\n const agentName = options.name ?? 'agent';\n\n const agent: AgentContext = {\n agentId: options.agentId ?? generateAgentId(agentName),\n agentName: agentName,\n agentRole: options.role,\n agentType: options.agentType,\n parentAgentId: parent?.agentId,\n version: options.version,\n metadata: options.metadata,\n };\n\n return runWithContext({ agent }, fn);\n}\n","/**\n * Lifecycle end-marker (F-B-012) — the JS SDK's run-end signal.\n *\n * At agent() / session() / phase / multi-agent context-manager exit the SDK\n * emits a lifecycle-end marker so downstream (\"did this run finish or die?\")\n * is answerable. The marker is three attributes carried on a span via the open\n * `attributes` map (schema-contract.md \"attribute-first\") plus the typed status:\n *\n * risicare.lifecycle.event = \"end\"\n * risicare.lifecycle.entity = \"session\" | \"agent\" | \"trace\"\n * risicare.lifecycle.status = \"ok\" (normal exit) | \"error\" (the body threw)\n *\n * Mirrors the Python SDK (packages/risicare-sdk/src/risicare/decorators.py).\n * See fix-workstream/F-B-012-DESIGN-CONTRACT.md for the settled contract.\n */\n\nimport type { Span } from './span.js';\nimport { getTracer } from './client.js';\nimport { SpanKind, SpanStatus } from './types.js';\n\nexport const LIFECYCLE_EVENT = 'risicare.lifecycle.event';\nexport const LIFECYCLE_ENTITY = 'risicare.lifecycle.entity';\nexport const LIFECYCLE_STATUS = 'risicare.lifecycle.status';\n\n// Cap the exception summary so a huge message can't bloat the span.\nconst STATUS_MESSAGE_MAX = 500;\n\nexport type LifecycleEntity = 'session' | 'agent' | 'trace';\n\nfunction excSummary(error: unknown): string {\n if (error instanceof Error) {\n return `${error.constructor.name}: ${error.message}`.slice(0, STATUS_MESSAGE_MAX);\n }\n return String(error).slice(0, STATUS_MESSAGE_MAX);\n}\n\n/**\n * Stamp the three lifecycle-end marker attributes + typed status on a span.\n *\n * Best-effort: a marker failure must never crash the host. When `span` is the\n * NOOP span (tracer disabled) its setters are no-ops so nothing is exported\n * (zero-overhead).\n */\nexport function stampEndMarker(\n span: Span,\n entity: LifecycleEntity,\n error: unknown | undefined,\n): void {\n try {\n const statusValue = error !== undefined ? 'error' : 'ok';\n span.setAttribute(LIFECYCLE_EVENT, 'end');\n span.setAttribute(LIFECYCLE_ENTITY, entity);\n span.setAttribute(LIFECYCLE_STATUS, statusValue);\n if (error !== undefined) {\n span.setStatus(SpanStatus.ERROR, excSummary(error));\n }\n } catch {\n // Never crash the host application.\n }\n}\n\n/**\n * Run `body` and stamp the lifecycle end-marker on `span` at completion —\n * `ok` on normal return, `error` on throw (then re-throw; host semantics\n * unchanged). Handles both sync results and Promises (SDK-004 parity).\n *\n * Intended to wrap the inner-body callback of an entity-span decorator, e.g.\n * tracer.startSpan({ ... }, (span) => withEndMarker(span, 'agent', () => fn()))\n */\nexport function withEndMarker<T>(span: Span, entity: LifecycleEntity, body: () => T): T {\n let result: T;\n try {\n result = body();\n } catch (error) {\n stampEndMarker(span, entity, error);\n throw error;\n }\n\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n stampEndMarker(span, entity, undefined);\n return value;\n },\n (error) => {\n stampEndMarker(span, entity, error);\n throw error;\n },\n ) as unknown as T;\n }\n\n stampEndMarker(span, entity, undefined);\n return result;\n}\n\n/**\n * Emit a dedicated, near-zero-duration `session.end` marker span for the\n * session() path (which owns no span of its own).\n *\n * MUST be called INSIDE the active session context so the tracer auto-stamps\n * the span's `sessionId` from the current session — the worker needs that to\n * attribute the marker. Best-effort: never crashes the host. When the tracer\n * is disabled, startSpan runs over the NOOP span and nothing is exported.\n */\nexport function emitSessionEndMarker(error: unknown | undefined): void {\n try {\n const tracer = getTracer();\n if (!tracer) return;\n const statusValue = error !== undefined ? 'error' : 'ok';\n tracer.startSpan(\n {\n name: 'session.end',\n kind: SpanKind.INTERNAL,\n attributes: {\n [LIFECYCLE_EVENT]: 'end',\n [LIFECYCLE_ENTITY]: 'session',\n [LIFECYCLE_STATUS]: statusValue,\n },\n },\n (span) => {\n if (error !== undefined) {\n span.setStatus(SpanStatus.ERROR, excSummary(error));\n }\n },\n );\n } catch {\n // Never crash the host application.\n }\n}\n\n/**\n * Run `body` inside the active session context and emit the `session.end`\n * marker at completion — ok on normal return, error on throw (then re-throw).\n * Handles both sync results and Promises (SDK-004 parity).\n */\nexport function withSessionEndMarker<T>(body: () => T): T {\n let result: T;\n try {\n result = body();\n } catch (error) {\n emitSessionEndMarker(error);\n throw error;\n }\n\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n emitSessionEndMarker(undefined);\n return value;\n },\n (error) => {\n emitSessionEndMarker(error);\n throw error;\n },\n ) as unknown as T;\n }\n\n emitSessionEndMarker(undefined);\n return result;\n}\n","/**\n * agent() — Higher-order function wrapper for agent identity (Tier 2).\n *\n * Wraps a function to execute within an agent context. All spans created\n * inside will be tagged with the agent's identity.\n *\n * Two equivalent calling forms are supported:\n *\n * // 2-arg form\n * const research = agent({ name: 'researcher' }, async (q) => { ... });\n *\n * // Curried form (decorator factory)\n * const research = agent({ name: 'researcher' })(async (q) => { ... });\n *\n * Both return a wrapped function — call it to actually run the body inside\n * the agent context.\n *\n * @example\n * const research = agent({ name: 'researcher', role: 'worker' }, async (query: string) => {\n * const result = await openai.chat.completions.create({ ... });\n * return result.choices[0].message.content;\n * });\n *\n * const answer = await research('What is quantum computing?');\n */\n\nimport { withAgent, type AgentOptions } from '../context/agent.js';\nimport { generateAgentId } from '../ids.js';\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { withEndMarker } from '../lifecycle.js';\n\n// Type-narrowing helper for the wrapper produced by both calling forms.\nfunction _wrapAgent<TArgs extends unknown[], TReturn>(\n options: AgentOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const spanName = `agent:${options.name ?? 'agent'}`;\n // ── F-AGENTID-JS-001 (W36/session-1a): MINT THE ID AT WRAP TIME, NOT PER CALL ──\n // ⚠ THE TWO SDKs PUT THE SAME FIELD NAME ON TWO DIFFERENT SEMANTICS, AND ONLY ONE\n // OF THEM CAN BE RIGHT. Python mints inside `decorator(fn)` — ONE id per (function\n // x process), and its `agent_context()` will not mint at all (agent_id is a\n // REQUIRED positional there, so the decorator is Python's only minting site).\n // JS minted inside `withAgent`, i.e. on EVERY INVOCATION: measured by execution,\n // three calls to one wrapped function produced three distinct `agent_id`s.\n //\n // The consequence is server-side and it is not cosmetic. `agent_id` is the grain of\n // `agent_spans`, so a JS customer's agent cardinality grows with TRAFFIC, not with\n // how many agents they wrote — measured on the lab: 10 distinct `agent_name`\n // against 151,552 distinct `agent_id`. That is what made the KPI read \"151.6K\n // agents\" (F-AGENTCOUNT-001) and what made GET /v1/agents/topology materialise\n // 151,552 nodes and OOM the whole API (F-TOPOOM-001). Same root, three surfaces.\n //\n // `spanName` above was ALREADY computed here, at wrap time — this line simply gives\n // the identity the same lifetime the label already had.\n //\n // ⚠ BOUND, stated so nobody reads more into this than it does: a caller using the\n // exported `withAgent()` DIRECTLY still gets a fresh id per call when they pass no\n // `agentId`. That is deliberate — `withAgent` is the twin of Python's\n // `agent_context()`, which has no minting behaviour to match, and removing the\n // fallback would be a breaking change to a published API. `agent()` is the\n // documented Tier-2 surface and the one both READMEs show.\n //\n // ⚠ NOT IN SCOPE and NOT decided here: whether `agent_id` should be stable ACROSS\n // processes. That is an OTel-semantics ruling (`service.instance.id` vs logical\n // identity) and belongs to the lead. This change only makes JS behave the way\n // Python already does.\n const agentId = options.agentId ?? generateAgentId(options.name ?? 'agent');\n const boundOptions: AgentOptions = { ...options, agentId };\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) {\n // Graceful degradation: run user code without tracing\n return fn(...args);\n }\n return withAgent(boundOptions, () => {\n // F-B-012: stamp the lifecycle end-marker (entity=\"agent\") on the entity\n // span — ok on normal exit, error on throw (then re-throw).\n return tracer.startSpan({ name: spanName, kind: SpanKind.AGENT }, (span) =>\n withEndMarker(span, 'agent', () => fn(...args)),\n );\n });\n };\n}\n\n// Overloads — typed for both calling forms.\nexport function agent<TArgs extends unknown[], TReturn>(\n options: AgentOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\nexport function agent(\n options: AgentOptions,\n): <TArgs extends unknown[], TReturn>(\n fn: (...args: TArgs) => TReturn,\n) => (...args: TArgs) => TReturn;\nexport function agent<TArgs extends unknown[], TReturn>(\n options: AgentOptions,\n fn?: (...args: TArgs) => TReturn,\n): unknown {\n // Curried form: agent(options)(fn). Return a factory that accepts fn.\n if (fn === undefined) {\n return <TA extends unknown[], TR>(realFn: (...args: TA) => TR) =>\n _wrapAgent(options, realFn);\n }\n // 2-arg form: agent(options, fn). Wrap directly.\n return _wrapAgent(options, fn);\n}\n","/**\n * Session context — groups multiple traces from the same user interaction.\n */\n\nimport { runWithContext, type SessionContext } from './storage.js';\nimport { withSessionEndMarker } from '../lifecycle.js';\n\nexport interface SessionOptions {\n sessionId: string;\n userId?: string;\n metadata?: Record<string, unknown>;\n parentSessionId?: string;\n turnNumber?: number;\n}\n\n/**\n * Run a callback within a session context.\n *\n * @example\n * await withSession({ sessionId: 'sess-123', userId: 'user-1' }, async () => {\n * const result = await agent.run(query);\n * return result;\n * });\n */\nexport function withSession<T>(options: SessionOptions, fn: () => T): T {\n const session: SessionContext = {\n sessionId: options.sessionId,\n userId: options.userId,\n metadata: options.metadata,\n parentSessionId: options.parentSessionId,\n turnNumber: options.turnNumber ?? 1,\n };\n // F-R-SESSIONCMEND-001. `withSession` and `session()` are both exported from\n // index.ts, side by side under one \"Tier 3: Sessions\" heading, as\n // alternatives. Until this line the decorator emitted the `session.end`\n // lifecycle marker and this — the plainer, more obvious spelling — emitted\n // nothing, so which behaviour a customer got depended only on which name they\n // reached for. `routers/sessions.py::_SESSION_AGG_SELECT` computes\n // `is_active` as NOT(a span carrying BOTH `risicare.lifecycle.event='end'`\n // AND `.entity='session'`), so a `withSession` session read ACTIVE FOREVER.\n //\n // The marker is emitted INSIDE `runWithContext` so the tracer stamps\n // sessionId from the active context. `withSessionEndMarker` is now the ONE\n // definition — `decorators/session.ts` no longer wraps separately, so the two\n // paths cannot drift apart again.\n return runWithContext({ session }, () => withSessionEndMarker(fn));\n}\n","/**\n * session() — Higher-order function wrapper for session context (Tier 3).\n *\n * Wraps a function to execute within a session context. All spans created\n * inside will be tagged with the session identity.\n *\n * @example\n * const handleRequest = session(\n * (req) => ({ sessionId: req.sessionId, userId: req.userId }),\n * async (req: Request) => {\n * return await agent.run(req.query);\n * },\n * );\n */\n\nimport { withSession, type SessionOptions } from '../context/session.js';\n\nfunction _wrapSession<TArgs extends unknown[], TReturn>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const options =\n typeof optionsOrResolver === 'function'\n ? optionsOrResolver(...args)\n : optionsOrResolver;\n // F-B-012 / F-R-SESSIONCMEND-001: the `session.end` marker is emitted by\n // `withSession` itself, so both public session APIs share ONE definition.\n // Wrapping again here would emit the marker twice.\n return withSession(options, () => fn(...args));\n };\n}\n\n/**\n * Wrap a function with session context.\n *\n * Two equivalent calling forms are supported (F-54 ergonomics):\n *\n * // 2-arg form\n * const handle = session({ sessionId: 's1' }, async (req) => { ... });\n *\n * // Curried form (decorator factory)\n * const handle = session({ sessionId: 's1' })(async (req) => { ... });\n *\n * @param optionsOrResolver - Static session options, or a function that derives them from args\n * @param fn - The function to wrap. If omitted, returns a decorator factory.\n */\nexport function session<TArgs extends unknown[], TReturn>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\nexport function session<TArgs extends unknown[]>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n): <TR>(fn: (...args: TArgs) => TR) => (...args: TArgs) => TR;\nexport function session<TArgs extends unknown[], TReturn>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n fn?: (...args: TArgs) => TReturn,\n): unknown {\n if (fn === undefined) {\n return <TR>(realFn: (...args: TArgs) => TR) =>\n _wrapSession(optionsOrResolver, realFn);\n }\n return _wrapSession(optionsOrResolver, fn);\n}\n","/**\n * Phase context — cognitive phase tracking (THINK/DECIDE/ACT/OBSERVE).\n */\n\nimport { SemanticPhase } from '../types.js';\nimport { runWithContext } from './storage.js';\n\n/**\n * Run a callback within a semantic phase context.\n */\nexport function withPhase<T>(phase: SemanticPhase, fn: () => T): T {\n return runWithContext({ phase }, fn);\n}\n","/**\n * Phase decorators — decision phase tracking (Tier 4).\n *\n * Wraps functions to execute within a semantic phase context (THINK/DECIDE/ACT/OBSERVE).\n * Each creates a span named after the phase.\n *\n * @example\n * const analyze = traceThink(async (data: string) => {\n * return await llm.invoke(`Analyze: ${data}`);\n * });\n *\n * const decide = traceDecide(async (analysis: string) => {\n * return await llm.invoke(`Decide action: ${analysis}`);\n * });\n */\n\nimport { withPhase } from '../context/phase.js';\nimport { getTracer } from '../client.js';\nimport { SemanticPhase, SpanKind } from '../types.js';\nimport { withEndMarker } from '../lifecycle.js';\n\nfunction phaseWrapper<TArgs extends unknown[], TReturn>(\n phase: SemanticPhase,\n kind: SpanKind,\n name: string,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) {\n return fn(...args);\n }\n return withPhase(phase, () => {\n // F-B-012: phase decorators are @trace-family — stamp the lifecycle\n // end-marker (entity=\"trace\") for uniform emission.\n return tracer.startSpan({ name, kind }, (span) =>\n withEndMarker(span, 'trace', () => fn(...args)),\n );\n });\n };\n}\n\n/**\n * Wrap a function in a THINK phase context with auto-span.\n *\n * @example traceThink(async () => { ... })\n * @example traceThink(\"analyze-data\", async () => { ... })\n */\nexport function traceThink<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : `phase:think`;\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.THINK, SpanKind.THINK, name, fn);\n}\n\n/**\n * Wrap a function in a DECIDE phase context with auto-span.\n *\n * @example traceDecide(async () => { ... })\n * @example traceDecide(\"choose-action\", async () => { ... })\n */\nexport function traceDecide<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : `phase:decide`;\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.DECIDE, SpanKind.DECIDE, name, fn);\n}\n\n/**\n * Wrap a function in an ACT phase context with auto-span.\n *\n * @example traceAct(async () => { ... })\n * @example traceAct(\"execute-tool\", async () => { ... })\n */\nexport function traceAct<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : `phase:act`;\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.ACT, SpanKind.TOOL_CALL, name, fn);\n}\n\n/**\n * Wrap a function in an OBSERVE phase context with auto-span.\n *\n * @example traceObserve(async () => { ... })\n * @example traceObserve(\"check-result\", async () => { ... })\n */\nexport function traceObserve<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : `phase:observe`;\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.OBSERVE, SpanKind.OBSERVE, name, fn);\n}\n","/**\n * Multi-agent communication decorators (Tier 5).\n *\n * Track inter-agent messages, delegations, and coordination.\n *\n * @example\n * const sendToWorker = traceMessage({ to: 'worker-1', type: MessageType.DELEGATE },\n * async (task: string) => { ... }\n * );\n */\n\nimport { getTracer } from '../client.js';\nimport { MessageType, SpanKind } from '../types.js';\nimport { withEndMarker } from '../lifecycle.js';\n\ninterface MessageOptions {\n to: string;\n type?: MessageType;\n metadata?: Record<string, unknown>;\n}\n\ninterface DelegateOptions {\n to: string;\n metadata?: Record<string, unknown>;\n}\n\ninterface CoordinateOptions {\n participants: string[];\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Namespace user metadata under 'metadata.*' to prevent overwriting\n * critical span attributes like message.type, message.to, etc.\n */\nfunction namespacedMetadata(metadata?: Record<string, unknown>): Record<string, unknown> {\n if (!metadata) return {};\n const result: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(metadata)) {\n result[`metadata.${key}`] = value;\n }\n return result;\n}\n\n/**\n * Wrap a function that sends a message to another agent.\n */\nexport function traceMessage<TArgs extends unknown[], TReturn>(\n options: MessageOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const msgType = options.type ?? MessageType.REQUEST;\n\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) return fn(...args);\n return tracer.startSpan(\n {\n name: `message:${msgType}→${options.to}`,\n kind: SpanKind.MESSAGE,\n attributes: {\n ...namespacedMetadata(options.metadata),\n 'message.to': options.to,\n 'message.type': msgType,\n 'message.target_agent_id': options.to,\n },\n },\n // F-B-012: multi-agent decorators are @trace-family — entity=\"trace\".\n (span) => withEndMarker(span, 'trace', () => fn(...args)),\n );\n };\n}\n\n/**\n * Wrap a function that delegates work to a sub-agent.\n */\nexport function traceDelegate<TArgs extends unknown[], TReturn>(\n options: DelegateOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) return fn(...args);\n return tracer.startSpan(\n {\n name: `delegate→${options.to}`,\n kind: SpanKind.DELEGATION,\n attributes: {\n ...namespacedMetadata(options.metadata),\n 'delegate.to': options.to,\n 'message.type': MessageType.DELEGATE,\n 'message.target_agent_id': options.to,\n },\n },\n // F-B-012: multi-agent decorators are @trace-family — entity=\"trace\".\n (span) => withEndMarker(span, 'trace', () => fn(...args)),\n );\n };\n}\n\n/**\n * Wrap a function that coordinates multiple agents.\n */\nexport function traceCoordinate<TArgs extends unknown[], TReturn>(\n options: CoordinateOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) return fn(...args);\n return tracer.startSpan(\n {\n name: `coordinate:[${options.participants.join(',')}]`,\n kind: SpanKind.COORDINATION,\n attributes: {\n ...namespacedMetadata(options.metadata),\n 'coordinate.participants': options.participants.join(','),\n 'message.type': MessageType.COORDINATE,\n },\n },\n // F-B-012: multi-agent decorators are @trace-family — entity=\"trace\".\n (span) => withEndMarker(span, 'trace', () => fn(...args)),\n );\n };\n}\n","/**\n * Serializable trace context + W3C Trace Context headers.\n *\n * TraceContext is a plain object that can be passed across process\n * boundaries (JSON serialization, HTTP headers, message queues).\n *\n * W3C Trace Context:\n * traceparent: {version}-{trace_id}-{span_id}-{flags}\n * tracestate: risicare=session_id={...};agent_id={...}\n */\n\nimport { generateTraceId, generateSpanId, validateTraceId, validateSpanId } from '../ids.js';\nimport { getCurrentSpan, getCurrentSession, getCurrentAgent, getContext } from './storage.js';\n\n// ─── Serializable Trace Context ──────────────────────────────────────────────\n\nexport interface TraceContext {\n traceId: string;\n spanId: string;\n sessionId?: string;\n agentId?: string;\n}\n\n/**\n * Get the current trace context as a serializable object.\n *\n * When called inside a span context, returns the active span's IDs.\n * When called outside a span (e.g. inside session() but before agent()),\n * pre-allocates a trace ID and stores it in context so the next\n * startSpan() call inherits it — preventing trace ID mismatch.\n */\nexport function getTraceContext(): TraceContext {\n const span = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n\n let traceId: string;\n if (span) {\n traceId = span.traceId;\n } else {\n // No active span — check for a previously pre-allocated root trace ID\n const ctx = getContext();\n if (ctx._rootTraceId) {\n traceId = ctx._rootTraceId;\n } else {\n // Pre-allocate and store so startSpan() will inherit this ID\n traceId = generateTraceId();\n // Store in the current context scope (if one exists)\n // This is a no-op if we're outside any runWithContext scope\n if (ctx.session || ctx.agent) {\n // We're inside a session/agent scope — store the pre-allocated ID\n // by mutating the existing context object (safe because AsyncLocalStorage\n // gives each scope its own copy via spread in runWithContext)\n (ctx as Record<string, unknown>)._rootTraceId = traceId;\n }\n }\n }\n\n return {\n traceId,\n spanId: span?.spanId ?? generateSpanId(),\n sessionId: session?.sessionId,\n agentId: agent?.agentId,\n };\n}\n\n// ─── W3C Trace Context Headers ───────────────────────────────────────────────\n\nconst TRACEPARENT_HEADER = 'traceparent';\nconst TRACESTATE_HEADER = 'tracestate';\nconst RISICARE_STATE_DELIMITER = ';';\n\n/**\n * Inject trace context into HTTP headers (W3C format).\n */\nexport function injectTraceContext(headers: Record<string, string>): Record<string, string> {\n const span = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n\n if (span) {\n // W3C traceparent: version-trace_id-span_id-flags\n headers[TRACEPARENT_HEADER] = `00-${span.traceId}-${span.spanId}-01`;\n\n // Custom tracestate for Risicare (uses ';' as internal delimiter)\n // Preserve other vendors' tracestate entries per W3C spec\n const parts: string[] = [];\n if (session) parts.push(`session_id=${session.sessionId}`);\n if (agent) parts.push(`agent_id=${agent.agentId}`);\n\n if (parts.length > 0) {\n const riscareEntry = `risicare=${parts.join(RISICARE_STATE_DELIMITER)}`;\n const existing = headers[TRACESTATE_HEADER] ?? '';\n // Keep non-risicare vendor entries from any existing tracestate\n const otherEntries = existing\n .split(',')\n .map((e) => e.trim())\n .filter((e) => e && !e.startsWith('risicare='));\n headers[TRACESTATE_HEADER] = [riscareEntry, ...otherEntries].join(',');\n }\n }\n\n return headers;\n}\n\n/**\n * Extract trace context from HTTP headers (W3C format).\n */\nexport function extractTraceContext(headers: Record<string, string>): Record<string, string | undefined> {\n const result: Record<string, string | undefined> = {};\n\n // Normalize header keys to lowercase (HTTP headers are case-insensitive)\n const normalizedHeaders: Record<string, string> = {};\n for (const [key, value] of Object.entries(headers)) {\n normalizedHeaders[key.toLowerCase()] = value;\n }\n\n // Parse traceparent\n const traceparent = normalizedHeaders[TRACEPARENT_HEADER] ?? '';\n if (traceparent) {\n const parts = traceparent.split('-');\n if (parts.length >= 4) {\n const traceId = parts[1].toLowerCase();\n const spanId = parts[2].toLowerCase();\n if (validateTraceId(traceId)) result.traceId = traceId;\n if (validateSpanId(spanId)) result.parentSpanId = spanId;\n result.flags = parts[3];\n }\n }\n\n // Parse tracestate\n const tracestate = normalizedHeaders[TRACESTATE_HEADER] ?? '';\n if (tracestate) {\n for (const entry of tracestate.split(',')) {\n const trimmed = entry.trim();\n if (trimmed.startsWith('risicare=')) {\n const state = trimmed.slice(9); // len(\"risicare=\")\n for (const kv of state.split(RISICARE_STATE_DELIMITER)) {\n const eqIdx = kv.indexOf('=');\n if (eqIdx > 0) {\n const key = kv.slice(0, eqIdx).trim();\n const value = kv.slice(eqIdx + 1).trim();\n if (key && value) {\n // Normalize known tracestate keys to camelCase\n const camelKey = key === 'session_id' ? 'sessionId'\n : key === 'agent_id' ? 'agentId'\n : key;\n result[camelKey] = value;\n }\n }\n }\n }\n }\n }\n\n return result;\n}\n","/**\n * Span registry — TTL-based span store for edge cases.\n *\n * While AsyncLocalStorage handles most context propagation in Node.js,\n * the registry is useful for:\n * - Cross-process span tracking\n * - Explicit span passing via ID\n * - Long-running operations that outlive their original context\n */\n\nimport type { Span } from '../span.js';\nimport { getRegistry, getOpCount, setOpCount } from '../globals.js';\n\ninterface RegistryEntry {\n span: Span;\n registeredAt: number;\n ttlMs: number;\n}\n\nconst DEFAULT_TTL_MS = 60_000;\nconst MAX_ENTRIES = 10_000;\nconst CLEANUP_INTERVAL = 100;\n\nfunction entries(): Map<string, RegistryEntry> {\n return getRegistry() as Map<string, RegistryEntry>;\n}\n\nexport function registerSpan(span: Span, ttlMs = DEFAULT_TTL_MS): void {\n entries().set(span.spanId, {\n span,\n registeredAt: Date.now(),\n ttlMs,\n });\n setOpCount(getOpCount() + 1);\n maybeCleanup();\n}\n\nexport function getSpanById(spanId: string): Span | undefined {\n const entry = entries().get(spanId);\n if (!entry) return undefined;\n\n if (Date.now() - entry.registeredAt > entry.ttlMs) {\n entries().delete(spanId);\n return undefined;\n }\n\n return entry.span;\n}\n\nexport function unregisterSpan(spanId: string): void {\n entries().delete(spanId);\n}\n\nexport function extendSpanTtl(spanId: string, additionalMs: number): boolean {\n const entry = entries().get(spanId);\n if (!entry) return false;\n\n if (Date.now() - entry.registeredAt > entry.ttlMs) {\n entries().delete(spanId);\n return false;\n }\n\n entry.ttlMs += additionalMs;\n return true;\n}\n\nexport function getRegistryStats(): { totalEntries: number; operationCount: number } {\n return {\n totalEntries: entries().size,\n operationCount: getOpCount(),\n };\n}\n\nexport function clearRegistry(): void {\n entries().clear();\n setOpCount(0);\n}\n\nfunction maybeCleanup(): void {\n if (getOpCount() % CLEANUP_INTERVAL !== 0) return;\n if (entries().size <= MAX_ENTRIES) return;\n\n const now = Date.now();\n for (const [id, entry] of entries()) {\n if (now - entry.registeredAt > entry.ttlMs) {\n entries().delete(id);\n }\n }\n}\n","/**\n * tracedStream — Wrap an async iterable in a trace span.\n *\n * Creates a span that starts when iteration begins and ends when\n * iteration completes (or errors). Chunks pass through UNCHANGED.\n *\n * This is the user-level streaming utility. For provider-level streaming\n * enrichment (token counts, cost), see individual provider instrumentors.\n *\n * Usage:\n * const stream = await openai.chat.completions.create({ stream: true, ... });\n * for await (const chunk of tracedStream(stream, { name: 'llm-stream' })) {\n * process(chunk);\n * }\n */\n\nimport { getTracer } from './client.js';\nimport { SpanKind } from './types.js';\n\nexport interface TracedStreamOptions {\n /** Span name */\n name: string;\n /** Span kind (default: INTERNAL) */\n kind?: SpanKind;\n /** Additional span attributes */\n attributes?: Record<string, unknown>;\n}\n\n/**\n * Wrap an async iterable in a trace span.\n *\n * - Span starts on first iteration\n * - chunk_count attribute set when iteration ends\n * - On error: span records exception, error re-thrown to caller\n * - On early break: span ended cleanly via finally\n * - If SDK not initialized: chunks pass through without wrapping\n */\nexport async function* tracedStream<T>(\n source: AsyncIterable<T>,\n options: TracedStreamOptions | string,\n): AsyncGenerator<T, void, undefined> {\n const opts = typeof options === 'string' ? { name: options } : options;\n\n // Graceful degradation: if SDK not initialized, pass through\n const tracer = getTracer();\n if (!tracer || !tracer.enabled) {\n yield* source;\n return;\n }\n\n const span = tracer.createSpan({\n name: opts.name,\n kind: opts.kind ?? SpanKind.INTERNAL,\n attributes: opts.attributes,\n });\n\n let chunkCount = 0;\n\n try {\n for await (const chunk of source) {\n chunkCount++;\n yield chunk;\n }\n\n span.setAttribute('stream.chunk_count', chunkCount);\n span.setAttribute('stream.completed', true);\n } catch (error) {\n span.setAttribute('stream.chunk_count', chunkCount);\n span.setAttribute('stream.completed', false);\n span.recordException(error instanceof Error ? error : String(error));\n throw error;\n } finally {\n span.end();\n }\n}\n","/**\n * Double-tracing prevention for framework integrations.\n *\n * When a framework integration (e.g., LlamaIndex handler) creates its own\n * LLM span, the underlying provider proxy (e.g., patchOpenAI) would also\n * create a duplicate span. This module provides suppression:\n *\n * - Framework integrations SET suppression via suppressProviderInstrumentation()\n * - Provider proxies CHECK via isProviderInstrumentationSuppressed() and skip\n *\n * Scoped to AsyncLocalStorage — concurrent calls are independent.\n */\n\nimport { getContext, runWithContext } from './storage.js';\n\n/**\n * Run a callback with provider instrumentation suppressed.\n *\n * During this callback, all provider instrumentors (patchOpenAI, etc.) will\n * skip span creation. The framework is responsible for creating the span.\n *\n * @param fn - The function to run with suppression active\n * @returns The function's return value\n */\nexport function suppressProviderInstrumentation<T>(fn: () => T): T {\n return runWithContext({ _suppressProviderInstrumentation: true }, fn);\n}\n\n/**\n * Check if provider instrumentation should be suppressed.\n *\n * Called by provider instrumentors as an early-exit guard. When true,\n * the provider calls the original method directly without creating a span.\n */\nexport function isProviderInstrumentationSuppressed(): boolean {\n return getContext()._suppressProviderInstrumentation === true;\n}\n","/**\n * LangChain.js integration via callback handler.\n *\n * LangChain.js uses BaseCallbackHandler from @langchain/core/callbacks/base.\n * F-628/F-729: prior versions of this handler did NOT extend BaseCallbackHandler\n * — LangChain v0.2+ tightened its callback registration to do `instanceof\n * BaseCallbackHandler` checks, silently dropping any handler that does not\n * inherit. Zero spans fired from any LCEL chain.\n *\n * PR-4+5 review B1 (2026-05-25): even with `extends BaseCallbackHandler`,\n * `instanceof` would fail for ESM consumers because we resolve via\n * `createRequire()` (CJS) — the two module instances are DIFFERENT class\n * identities. LangChain v0.3 ships `isBaseCallbackHandler(x)` which checks\n * duck-type markers (`x.copy` function, `x.name` string, `x.awaitHandlers`\n * boolean). We now set those markers explicitly so we pass the duck-typed\n * check regardless of which class identity ends up resolving in the customer\n * environment. We ALSO still extend the resolved BaseCallbackHandler when\n * available — that satisfies any remaining v0.2 `instanceof` callsite in\n * the customer's bundle AND inherits the real `copy()` method.\n *\n * Usage:\n * import { RisicareCallbackHandler } from 'risicare/langchain';\n * const handler = new RisicareCallbackHandler();\n * const result = await handler.withSuppression(() =>\n * chain.invoke(input, { callbacks: [handler] })\n * );\n *\n * SUPPRESSES provider instrumentation — LangChain handler creates LLM spans,\n * so provider-level spans (patchOpenAI, etc.) would duplicate without suppression.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { suppressProviderInstrumentation } from '../context/dedup.js';\nimport { debug } from '../utils/log.js';\nimport type { Span } from '../span.js';\n\ninterface SpanEntry {\n span: Span;\n startTime: number;\n}\n\n/**\n * Resolve BaseCallbackHandler lazily. We cannot `import` it statically because\n * @langchain/core is an OPTIONAL peer dep — a bare `import` would fail at\n * load time for customers who don't have LangChain. The dynamic require is\n * wrapped in try/catch; on failure we fall back to `Object` so the handler\n * still constructs (it just won't satisfy LangChain v0.2+'s instanceof check).\n */\nfunction resolveBaseCallbackHandler(): new (...args: unknown[]) => object {\n try {\n // Use createRequire so this works under both CJS and ESM.\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n const { createRequire } = require('node:module') as typeof import('node:module');\n const req = createRequire(import.meta.url);\n const mod = req('@langchain/core/callbacks/base') as {\n BaseCallbackHandler?: new (...args: unknown[]) => object;\n };\n if (mod?.BaseCallbackHandler) {\n return mod.BaseCallbackHandler;\n }\n } catch {\n // Either ESM context without createRequire, or peer dep not installed.\n // Fall through to the require fallback below.\n }\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n const mod = require('@langchain/core/callbacks/base') as {\n BaseCallbackHandler?: new (...args: unknown[]) => object;\n };\n if (mod?.BaseCallbackHandler) {\n return mod.BaseCallbackHandler;\n }\n } catch {\n debug('RisicareCallbackHandler: @langchain/core not installed; handler will not satisfy LangChain v0.2+ instanceof check');\n }\n return Object as unknown as new (...args: unknown[]) => object;\n}\n\nconst _BaseCallbackHandler = resolveBaseCallbackHandler();\n\n/**\n * RisicareCallbackHandler — emits Risicare spans for every LangChain callback.\n *\n * Extends BaseCallbackHandler at runtime when @langchain/core is installed,\n * which is required for LangChain v0.2+ to accept it.\n *\n * F-882/F-883: chat-model and agent events are NEW in v0.2; older handlers\n * that only implement handleLLMStart get zero spans from `ChatModel`s (every\n * modern LangChain LLM is a ChatModel). The full chat / agent / custom-event\n * surface is now covered.\n */\nexport class RisicareCallbackHandler extends _BaseCallbackHandler {\n // PR-4+5 review B1: duck-type markers that LangChain v0.3's\n // `isBaseCallbackHandler(x)` checks. This is the ONLY reliable way to be\n // recognised across the CJS↔ESM identity split — `instanceof` cannot work\n // when our `createRequire`-loaded BaseCallbackHandler is a different\n // class object from the customer's ESM-imported BaseCallbackHandler.\n // Keep these as instance properties (not prototype) so they survive any\n // Object-fallback path when @langchain/core is absent.\n name = 'RisicareCallbackHandler';\n awaitHandlers = true;\n ignoreLLM = false;\n ignoreChain = false;\n ignoreAgent = false;\n ignoreRetriever = false;\n ignoreCustomEvent = false;\n raiseError = false;\n lc_serializable = false;\n lc_kwargs: Record<string, unknown> = {};\n\n private _spans = new Map<string, SpanEntry>();\n\n constructor() {\n // Call super() even if BaseCallbackHandler is the Object fallback.\n super();\n }\n\n /**\n * Required by LangChain's `isBaseCallbackHandler(x)` duck-type check\n * (`typeof x.copy === 'function'`). When @langchain/core is installed\n * BaseCallbackHandler's prototype provides its own `copy()`; this\n * declaration overrides with a Risicare-aware copy that re-instantiates\n * — sufficient for the handler-cloning paths LangChain uses internally\n * (e.g., per-run isolation in concurrent chains). Spans map starts empty\n * because a fresh handler should not share span state with its parent.\n */\n copy(): RisicareCallbackHandler {\n return new RisicareCallbackHandler();\n }\n\n /**\n * Run a function with provider instrumentation suppressed.\n *\n * Wrap your chain.invoke() call with this to prevent duplicate spans.\n * The handler creates LLM/tool spans, so provider proxies (patchOpenAI, etc.)\n * should be suppressed during chain execution.\n *\n * @example\n * const handler = new RisicareCallbackHandler();\n * const result = await handler.withSuppression(() =>\n * chain.invoke(input, { callbacks: [handler] })\n * );\n */\n withSuppression<T>(fn: () => T): T {\n return suppressProviderInstrumentation(fn);\n }\n\n // ── Internal helpers ──────────────────────────────────────────────────────\n\n private _startSpan(\n runId: string,\n parentRunId: string | undefined,\n name: string,\n kind: SpanKind,\n extraAttrs: Record<string, unknown> = {},\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n\n const parentEntry = parentRunId ? this._spans.get(parentRunId) : undefined;\n const span = tracer.createSpan({\n name,\n kind,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'langchain',\n 'langchain.run_id': runId,\n ...(parentRunId ? { 'langchain.parent_run_id': parentRunId } : {}),\n ...extraAttrs,\n },\n });\n\n this._spans.set(runId, { span, startTime: Date.now() });\n }\n\n private _endSpan(runId: string, extraAttrs: Record<string, unknown> = {}): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n for (const [k, v] of Object.entries(extraAttrs)) {\n entry.span.setAttribute(k, v);\n }\n entry.span.setAttribute('gen_ai.latency_ms', Date.now() - entry.startTime);\n entry.span.end();\n this._spans.delete(runId);\n }\n\n private _errorSpan(runId: string, error: Error): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n entry.span.recordException(error);\n entry.span.end();\n this._spans.delete(runId);\n }\n\n // ── Chain lifecycle ────────────────────────────────────────────────────────\n\n handleChainStart(\n chain: { name?: string; _type?: string },\n _inputs: Record<string, unknown>,\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, chain.name || chain._type || 'chain', SpanKind.INTERNAL, {\n ...(chain._type ? { 'langchain.chain_type': chain._type } : {}),\n });\n }\n\n handleChainEnd(_outputs: Record<string, unknown>, runId: string): void {\n this._endSpan(runId);\n }\n\n handleChainError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n // ── LLM lifecycle ─────────────────────────────────────────────────────────\n\n handleLLMStart(\n llm: { name?: string; _type?: string },\n _prompts: string[],\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, llm.name || llm._type || 'llm', SpanKind.LLM_CALL, {\n 'gen_ai.system': 'langchain',\n 'gen_ai.prompt.count': _prompts.length,\n });\n }\n\n /**\n * F-882: chat-model lifecycle — LangChain v0.2+ emits this for any\n * ChatModel (which is EVERY production LLM today). Without this method,\n * not a single `langchain` LLM span fires when used via LCEL.\n *\n * The messages payload is an array-of-arrays (one inner array per prompt);\n * we just count rather than materialize content (PII boundary).\n */\n handleChatModelStart(\n llm: { name?: string; _type?: string },\n messages: unknown[][],\n runId: string,\n parentRunId?: string,\n ): void {\n const messageCount = Array.isArray(messages)\n ? messages.reduce((sum, arr) => sum + (Array.isArray(arr) ? arr.length : 0), 0)\n : 0;\n this._startSpan(runId, parentRunId, llm.name || llm._type || 'chat_model', SpanKind.LLM_CALL, {\n 'gen_ai.system': 'langchain',\n 'gen_ai.message.count': messageCount,\n });\n }\n\n handleLLMEnd(\n output: {\n generations?: unknown[][];\n llmOutput?: Record<string, unknown>;\n },\n runId: string,\n ): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n\n // Extract token usage from llmOutput\n const usage = output.llmOutput?.tokenUsage as\n | Record<string, number>\n | undefined;\n if (usage) {\n entry.span.setLlmFields({\n promptTokens: usage.promptTokens ?? usage.prompt_tokens,\n completionTokens: usage.completionTokens ?? usage.completion_tokens,\n totalTokens: usage.totalTokens ?? usage.total_tokens,\n });\n }\n\n const model = (output.llmOutput?.model ??\n output.llmOutput?.modelName) as string | undefined;\n if (model) {\n entry.span.setLlmFields({ model });\n }\n\n entry.span.setAttribute('gen_ai.latency_ms', Date.now() - entry.startTime);\n entry.span.end();\n this._spans.delete(runId);\n }\n\n handleLLMError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n /**\n * F-883: streaming-token event. We do NOT create a new span (the LLM span\n * already exists from handleLLMStart/handleChatModelStart) — just count tokens\n * on the existing span. This is a HIGH-FREQUENCY event; do the cheap work only.\n */\n handleLLMNewToken(_token: string, _idx: unknown, runId: string): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n const prior = (entry.span.attributes?.['gen_ai.stream.token_count'] as number) ?? 0;\n entry.span.setAttribute('gen_ai.stream.token_count', prior + 1);\n }\n\n // ── Tool lifecycle ────────────────────────────────────────────────────────\n\n handleToolStart(\n tool: { name?: string },\n input: string,\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, tool.name || 'tool', SpanKind.TOOL_CALL, {\n 'tool.name': tool.name || 'unknown',\n 'tool.input_length': input?.length ?? 0,\n });\n }\n\n handleToolEnd(output: string, runId: string): void {\n this._endSpan(runId, { 'tool.output_length': output?.length ?? 0 });\n }\n\n handleToolError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n // ── Retriever lifecycle ───────────────────────────────────────────────────\n\n handleRetrieverStart(\n retriever: { name?: string },\n _query: string,\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, retriever.name || 'retriever', SpanKind.RETRIEVAL);\n }\n\n handleRetrieverEnd(documents: unknown[], runId: string): void {\n this._endSpan(runId, { 'retriever.document_count': documents?.length ?? 0 });\n }\n\n handleRetrieverError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n // ── Agent lifecycle (F-882) ───────────────────────────────────────────────\n\n /**\n * Agent decided to take an action (call a tool). LangChain v0.2 agents emit\n * this between LLM calls. Cheap span, no parent change.\n */\n handleAgentAction(\n action: { tool?: string; toolInput?: unknown; log?: string },\n runId: string,\n parentRunId?: string,\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n const parentEntry = parentRunId ? this._spans.get(parentRunId) : undefined;\n const span = tracer.createSpan({\n name: `agent.action:${action.tool ?? 'unknown'}`,\n kind: SpanKind.INTERNAL,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'langchain',\n 'langchain.run_id': runId,\n 'agent.action.tool': action.tool ?? '',\n },\n });\n // Agent actions are point-in-time events, not durations — end immediately.\n span.end();\n }\n\n /**\n * Agent finished (final answer produced). Mirror of handleAgentAction.\n */\n handleAgentEnd(\n action: { returnValues?: Record<string, unknown>; log?: string },\n runId: string,\n parentRunId?: string,\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n const parentEntry = parentRunId ? this._spans.get(parentRunId) : undefined;\n const span = tracer.createSpan({\n name: 'agent.end',\n kind: SpanKind.INTERNAL,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'langchain',\n 'langchain.run_id': runId,\n 'agent.return_keys': action.returnValues\n ? Object.keys(action.returnValues).length\n : 0,\n },\n });\n span.end();\n }\n\n // ── Misc (F-882) ──────────────────────────────────────────────────────────\n\n /**\n * Free-text emission (logging-style). Used by ConversationalRetrievalChain\n * and verbose prints. Adds an event to the current chain span if one exists.\n */\n handleText(text: string, runId: string, _parentRunId?: string): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n entry.span.addEvent('langchain.text', {\n 'text.length': text?.length ?? 0,\n });\n }\n\n /**\n * Custom event hook (introduced in @langchain/core 0.2.14). Customer code can\n * `dispatchCustomEvent(name, payload)` from inside a runnable. We surface as\n * a span event on the closest enclosing run so it shows up in the trace.\n */\n handleCustomEvent(\n eventName: string,\n _payload: unknown,\n runId: string,\n _tags?: string[],\n _metadata?: Record<string, unknown>,\n ): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n entry.span.addEvent('langchain.custom_event', { name: eventName });\n }\n}\n","/**\n * LangGraph.js integration via Proxy wrapping.\n *\n * LangGraph uses LangChain callbacks under the hood. This integration wraps\n * a compiled graph's invoke/stream methods to:\n * 1. Create a parent \"langgraph.invoke\" or \"langgraph.stream\" span\n * 2. Inject a RisicareCallbackHandler into the config so all internal\n * chain/LLM/tool calls are also traced\n *\n * Usage:\n * import { instrumentLangGraph } from 'risicare/frameworks/langgraph';\n * const graph = instrumentLangGraph(compiledGraph);\n * const result = await graph.invoke(input);\n *\n * Does NOT suppress provider instrumentation.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { RisicareCallbackHandler } from './langchain.js';\n\n/**\n * Wrap a compiled LangGraph graph with Risicare tracing.\n *\n * Returns a Proxy that intercepts `invoke` and `stream` calls to create\n * a parent span and inject the LangChain callback handler.\n *\n * @param graph - A compiled LangGraph graph object with invoke/stream methods\n * @returns A proxied graph with tracing enabled\n */\nexport function instrumentLangGraph<T extends object>(graph: T): T {\n return new Proxy(graph, {\n get(target, prop, receiver) {\n const value = Reflect.get(target, prop, receiver);\n\n if (\n (prop === 'invoke' || prop === 'stream') &&\n typeof value === 'function'\n ) {\n return function patchedMethod(\n this: unknown,\n ...args: unknown[]\n ): unknown {\n const tracer = getTracer();\n if (!tracer?.enabled) return value.apply(this, args);\n\n return tracer.startSpan(\n {\n name: `langgraph.${String(prop)}`,\n kind: SpanKind.AGENT,\n attributes: { framework: 'langgraph' },\n },\n (_span) => {\n // Inject RisicareCallbackHandler into config (second argument)\n const config = (args[1] ?? {}) as Record<string, unknown>;\n const callbacks = (config.callbacks ?? []) as unknown[];\n callbacks.push(new RisicareCallbackHandler());\n args[1] = { ...config, callbacks };\n\n const result = value.apply(this, args);\n\n // Handle async results (Promises)\n if (\n result &&\n typeof (result as Promise<unknown>).then === 'function'\n ) {\n return (result as Promise<unknown>).then((r) => r);\n }\n return result;\n },\n );\n };\n }\n\n return value;\n },\n });\n}\n","/**\n * Provider patcher input validation.\n *\n * F-722/F-620: every `patchX(client)` entry point creates `new Proxy(client, ...)`.\n * Proxy constructors throw an opaque `TypeError: Cannot create proxy with a non-object\n * as target or handler` when handed `null`, `undefined`, a primitive, or `false`.\n * That error happens deep in the SDK with no actionable message — and it crashes\n * the customer's app startup the moment they pass a maybe-null client.\n *\n * We fail-fast with a clear, named TypeError so the customer sees:\n * \"patchOpenAI requires a client object, got null\"\n * instead of:\n * \"Cannot create proxy with a non-object as target or handler\"\n *\n * Rationale for throwing (not returning the input):\n * - Returning the input would silently disable instrumentation; a customer who\n * expects spans would see \"no traces\" and have to root-cause it themselves.\n * - Throwing surfaces the bug at the call-site (their `patchOpenAI(maybeNull)`).\n * - It happens at init/setup time, not in the request hot path, so no latency cost.\n */\n// PR-4+5 review NIT (2026-05-25): asserts-style narrowing. Pre-fix the\n// signature returned `void` with an `unknown` client parameter, forcing\n// every patcher's `new Proxy(client, ...)` call to keep the `unknown` /\n// loose `T` type — TS could not prove the Proxy target was non-null.\n// `asserts client is NonNullable<T>` means TS narrows the caller's\n// variable after assertClient returns, so the surrounding code is\n// type-safe without redundant runtime checks.\nexport function assertClient<T>(\n patcherName: string,\n client: T,\n): asserts client is NonNullable<T> {\n if (client === null || client === undefined) {\n throw new TypeError(\n `${patcherName} requires a client object, got ${client === null ? 'null' : 'undefined'}`,\n );\n }\n const t = typeof client;\n if (t !== 'object' && t !== 'function') {\n throw new TypeError(\n `${patcherName} requires a client object, got ${t}`,\n );\n }\n}\n","/**\n * Instructor integration via Proxy wrapping.\n *\n * Instructor wraps an LLM client's create() method to extract structured\n * data from completions using a response model (Zod schema, etc.).\n *\n * F-884: The Instructor JS client (`@instructor-ai/instructor`) exposes the\n * structured-extraction method at `client.chat.completions.create(...)` —\n * mirroring the underlying OpenAI shape — NOT at a top-level `client.create`.\n * The previous patcher hooked the top-level `create`, which Instructor JS does\n * not have, so no spans ever fired. We now walk the nested path (chat →\n * completions → create) AND keep a top-level `create` intercept for forward-\n * compatibility with API shapes that may expose both.\n *\n * Usage:\n * import { patchInstructor } from 'risicare/instructor';\n * import Instructor from '@instructor-ai/instructor';\n * const client = patchInstructor(Instructor({ client: openai, mode: 'TOOLS' }));\n * const result = await client.chat.completions.create({\n * model: 'gpt-4o-mini',\n * messages: [...],\n * response_model: { schema: MySchema, name: 'MyExtraction' },\n * });\n *\n * Does NOT suppress provider instrumentation -- Instructor delegates to the\n * underlying LLM client, which should produce its own provider span.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { debug } from '../utils/log.js';\nimport { assertClient } from '../utils/assert-client.js';\n\n/**\n * Build the wrapped `create` function. Shared between top-level (legacy) and\n * nested (`chat.completions.create`, the real Instructor JS shape) intercepts.\n */\nfunction makePatchedCreate(originalCreate: Function): Function {\n return function patchedCreate(this: unknown, ...args: unknown[]): unknown {\n const tracer = getTracer();\n if (!tracer?.enabled) {\n debug('Tracer not initialized — call init() before using patchInstructor()');\n return originalCreate.apply(this, args);\n }\n\n const params = (args[0] ?? {}) as Record<string, unknown>;\n // Instructor JS accepts response_model as { schema, name } or a Zod schema\n const responseModel = params.response_model ?? params.responseModel;\n\n let modelName = 'unknown';\n if (responseModel && typeof responseModel === 'function') {\n modelName = (responseModel as { name?: string }).name || 'unknown';\n } else if (responseModel && typeof responseModel === 'object') {\n const rm = responseModel as Record<string, unknown>;\n modelName =\n (rm.name as string) ??\n (rm.description as string) ??\n ((rm.schema as { name?: string } | undefined)?.name) ??\n 'schema';\n } else if (typeof responseModel === 'string') {\n modelName = responseModel;\n }\n\n return tracer.startSpan(\n {\n name: 'instructor.create',\n kind: SpanKind.LLM_CALL,\n attributes: {\n framework: 'instructor',\n 'framework.span_kind': 'extraction',\n 'instructor.response_model': modelName,\n ...(params.max_retries != null\n ? { 'instructor.max_retries': params.max_retries }\n : {}),\n ...(params.model != null\n ? { 'gen_ai.request.model': params.model }\n : {}),\n },\n },\n (_span) => {\n const result = originalCreate.apply(this, args);\n if (result && typeof (result as Promise<unknown>).then === 'function') {\n return (result as Promise<unknown>).then((r) => r);\n }\n return result;\n },\n );\n };\n}\n\n/**\n * Wrap an Instructor client with Risicare tracing.\n *\n * Intercepts BOTH:\n * - `client.chat.completions.create` (the real Instructor JS shape)\n * - `client.create` (legacy top-level shape, if present)\n *\n * @param client - An Instructor client\n * @returns A proxied client with tracing enabled\n */\nexport function patchInstructor<T extends object>(client: T): T {\n assertClient('patchInstructor', client);\n return new Proxy(client, {\n get(target, prop, receiver) {\n const value = Reflect.get(target, prop, receiver);\n\n // Legacy top-level create (rare, but harmless to keep for compat).\n if (prop === 'create' && typeof value === 'function') {\n return makePatchedCreate(value.bind(target));\n }\n\n // F-884: REAL Instructor JS shape — walk into `.chat.completions.create`.\n if (prop === 'chat' && value && typeof value === 'object') {\n return new Proxy(value as object, {\n get(chatTarget, chatProp, chatReceiver) {\n const chatValue = Reflect.get(chatTarget, chatProp, chatReceiver);\n if (chatProp === 'completions' && chatValue && typeof chatValue === 'object') {\n return new Proxy(chatValue as object, {\n get(compTarget, compProp, compReceiver) {\n const compValue = Reflect.get(compTarget, compProp, compReceiver);\n if (compProp === 'create' && typeof compValue === 'function') {\n return makePatchedCreate(compValue.bind(compTarget));\n }\n return compValue;\n },\n });\n }\n return chatValue;\n },\n });\n }\n\n return value;\n },\n });\n}\n","/**\n * LlamaIndex.TS integration via event handler.\n *\n * LlamaIndex.TS emits CustomEvent-shaped events through the global\n * `Settings.callbackManager` (a DOM-style EventTarget). F-880/F-881:\n * - Event NAMES use hyphens (`llm-start`, `llm-end`, `retrieve-start`,\n * `retrieve-end`, `query-start`, `query-end`, `embedding-start`, etc.),\n * NOT dotted suffixes (`.start` / `.end`). The previous handler used\n * `event.type.endsWith('.start')` and silently matched nothing.\n * - Payload lives on `event.detail` (DOM CustomEvent convention), NOT\n * `event.data` — the prior code was reading from `undefined`.\n *\n * We support both the hyphenated DOM CustomEvent shape (the real LlamaIndex.TS\n * format) and the dotted-suffix shape (the form the old code expected, kept\n * for back-compat with any customer who already wrote integration code\n * against the buggy contract).\n *\n * Usage:\n * import { RisicareLlamaIndexHandler } from 'risicare/llamaindex';\n * import { Settings } from 'llamaindex';\n * const handler = new RisicareLlamaIndexHandler();\n *\n * // Register every event we care about:\n * for (const name of RisicareLlamaIndexHandler.EVENT_NAMES) {\n * Settings.callbackManager.on(name, (e) => handler.onEvent(e));\n * }\n *\n * // For LLM/embedding calls, suppress provider instrumentation:\n * const result = handler.withSuppression(() => query(...));\n *\n * SUPPRESSES provider instrumentation -- LlamaIndex creates its own LLM spans,\n * so provider-level spans (patchOpenAI, etc.) would duplicate.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { suppressProviderInstrumentation } from '../context/dedup.js';\nimport type { Span } from '../span.js';\n\ninterface SpanEntry {\n span: Span;\n startTime: number;\n componentKind: string;\n}\n\n/**\n * Loose event shape. LlamaIndex.TS dispatches `CustomEvent`s where the payload\n * is on `.detail`. We also accept `.data` for back-compat with the older buggy\n * contract.\n */\nexport interface LlamaIndexEvent {\n type: string;\n // DOM CustomEvent payload (the real LlamaIndex.TS shape)\n detail?: Record<string, unknown>;\n // Back-compat fallback (the shape the old handler expected)\n data?: Record<string, unknown>;\n // Some payloads carry id/parentId at the top level instead of in detail\n id?: string;\n parentId?: string;\n}\n\n/**\n * Registry of (event-name → lifecycle-phase) for the events LlamaIndex.TS\n * actually emits. Maintained explicitly so the handler doesn't false-match\n * on customer-defined custom events that happen to end with `-start`.\n */\nconst EVENT_PHASE: Record<string, 'start' | 'end' | 'error'> = {\n // LLM\n 'llm-start': 'start',\n 'llm-end': 'end',\n 'llm-error': 'error',\n 'llm-tool-call': 'start',\n 'llm-tool-result': 'end',\n 'llm-stream': 'end',\n // Chat\n 'chat-start': 'start',\n 'chat-end': 'end',\n // Embeddings\n 'embedding-start': 'start',\n 'embedding-end': 'end',\n // Retrieval\n 'retrieve-start': 'start',\n 'retrieve-end': 'end',\n // Query / synthesis\n 'query-start': 'start',\n 'query-end': 'end',\n 'synthesize-start': 'start',\n 'synthesize-end': 'end',\n // Agent\n 'agent-start': 'start',\n 'agent-end': 'end',\n 'agent-step-start': 'start',\n 'agent-step-end': 'end',\n};\n\nexport class RisicareLlamaIndexHandler {\n /**\n * Public, iterable list of all event names this handler responds to.\n * Customers should subscribe to each on the LlamaIndex callback manager:\n * for (const n of RisicareLlamaIndexHandler.EVENT_NAMES) Settings.callbackManager.on(n, ...)\n */\n static readonly EVENT_NAMES = Object.keys(EVENT_PHASE);\n\n private _spans = new Map<string, SpanEntry>();\n\n /**\n * Handle a LlamaIndex lifecycle event.\n */\n onEvent(event: LlamaIndexEvent): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n\n // F-881: prefer .detail (DOM CustomEvent convention); fall back to .data.\n const payload = event.detail ?? event.data ?? {};\n\n // F-880: lookup by exact event name first (real LlamaIndex format).\n let phase = EVENT_PHASE[event.type];\n\n // Back-compat: accept legacy dotted suffix form (`*.start`/`*.end`/`*.error`).\n if (!phase) {\n if (event.type.endsWith('.start') || event.type.endsWith('.begin')) {\n phase = 'start';\n } else if (event.type.endsWith('.end') || event.type.endsWith('.complete')) {\n phase = 'end';\n } else if (event.type.endsWith('.error')) {\n phase = 'error';\n }\n }\n\n if (!phase) return;\n\n const id = (payload.id as string) ?? event.id ?? '';\n const parentId = (payload.parentId as string) ?? event.parentId;\n if (!id) return; // can't track spans without an id\n\n if (phase === 'start') {\n this._handleStart(event.type, id, parentId, payload);\n } else if (phase === 'end') {\n this._handleEnd(id, payload);\n } else {\n this._handleError(id, payload);\n }\n }\n\n /**\n * Run a function with provider instrumentation suppressed.\n */\n withSuppression<T>(fn: () => T): T {\n return suppressProviderInstrumentation(fn);\n }\n\n // ── Internal event handlers ───────────────────────────────────────────────\n\n private _handleStart(\n eventType: string,\n id: string,\n parentId: string | undefined,\n payload: Record<string, unknown>,\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n\n const componentKind = this._classifyComponent(eventType);\n const parentEntry = parentId ? this._spans.get(parentId) : undefined;\n\n const spanKind =\n componentKind === 'llm'\n ? SpanKind.LLM_CALL\n : componentKind === 'retrieval'\n ? SpanKind.RETRIEVAL\n : componentKind === 'embedding'\n ? SpanKind.LLM_CALL\n : SpanKind.INTERNAL;\n\n // Strip both shapes of suffix so the span name is just the component.\n const spanName = eventType\n .replace(/\\.(start|begin)$/, '')\n .replace(/-(start|begin)$/, '');\n\n const span = tracer.createSpan({\n name: spanName,\n kind: spanKind,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'llamaindex',\n 'framework.span_kind': componentKind,\n ...(payload.model ? { 'gen_ai.request.model': payload.model } : {}),\n },\n });\n\n this._spans.set(id, { span, startTime: Date.now(), componentKind });\n }\n\n private _handleEnd(id: string, payload: Record<string, unknown>): void {\n const entry = this._spans.get(id);\n if (!entry) return;\n\n entry.span.setAttribute('gen_ai.latency_ms', Date.now() - entry.startTime);\n\n // Extract token usage if available\n const usage = payload.usage as Record<string, number> | undefined;\n if (usage) {\n entry.span.setLlmFields({\n promptTokens: usage.promptTokens ?? usage.prompt_tokens,\n completionTokens: usage.completionTokens ?? usage.completion_tokens,\n });\n }\n\n if (payload.documentCount != null) {\n entry.span.setAttribute(\n 'retriever.document_count',\n payload.documentCount,\n );\n } else if (Array.isArray(payload.nodes)) {\n // LlamaIndex retrieve-end emits a `nodes` array; fall back to length.\n entry.span.setAttribute('retriever.document_count', payload.nodes.length);\n }\n\n entry.span.end();\n this._spans.delete(id);\n }\n\n private _handleError(id: string, payload: Record<string, unknown>): void {\n const entry = this._spans.get(id);\n if (!entry) return;\n\n const error = payload.error;\n entry.span.recordException(\n error instanceof Error ? error : String(error ?? 'Unknown error'),\n );\n entry.span.end();\n this._spans.delete(id);\n }\n\n /**\n * Classify a LlamaIndex event type into a component kind.\n */\n private _classifyComponent(eventType: string): string {\n const lower = eventType.toLowerCase();\n if (lower.includes('llm') || lower.includes('chat')) return 'llm';\n if (lower.includes('embed')) return 'embedding';\n if (lower.includes('retriev') || lower.includes('vector')) return 'retrieval';\n if (lower.includes('synth') || lower.includes('response')) return 'synthesis';\n if (lower.includes('query')) return 'query';\n if (lower.includes('agent')) return 'agent';\n return 'component';\n }\n}\n","/**\n * Webhook signature verification helpers (CON-195 / B-7, F-34).\n *\n * Customers receive Risicare webhooks at endpoints they configure. Each\n * delivery is signed by the sender (`packages/workers/src/workers/\n * webhook_dispatch.py`) with HMAC-SHA256 over `<timestamp>.<payload_bytes>`\n * using the per-webhook shared secret. The signature is delivered in the\n * `X-Risicare-Signature` header in Stripe-style format `t=<unix>,v1=<hex>`,\n * and the timestamp is also exposed verbatim as `X-Risicare-Timestamp`.\n *\n * This module is the TypeScript port of `risicare-sdk/src/risicare/\n * webhooks.py`. It enforces THREE checks (all must pass):\n *\n * 1. Header parsing — both headers must be present and well-formed.\n * 2. Time skew — `Math.abs(now - timestamp) <= toleranceS` (default\n * 5 minutes). This is what makes captured signed payloads\n * non-replayable past the tolerance window.\n * 3. HMAC equality — constant-time compare against a fresh signature\n * computed from the secret + the SAME timestamp + the raw body.\n *\n * Example (Express/Node receiver):\n *\n * import express from 'express';\n * import { verifyWebhookSignature, WebhookVerificationError } from 'risicare';\n *\n * const app = express();\n * // IMPORTANT: use raw body, not parsed JSON — the signature is\n * // over the EXACT bytes received; JSON re-serialization changes\n * // key ordering / whitespace and the signature will not match.\n * app.post('/risicare-webhook', express.raw({ type: '*\\/*' }), (req, res) => {\n * try {\n * verifyWebhookSignature(req.body, req.headers, YOUR_WEBHOOK_SECRET);\n * } catch (e) {\n * if (e instanceof WebhookVerificationError) {\n * return res.status(401).send(e.message);\n * }\n * throw e;\n * }\n * // ... process the verified event ...\n * res.status(200).end();\n * });\n *\n * The helper is dependency-light (Node `crypto` stdlib only) so customers\n * can use it without pulling in the rest of the SDK if they only need\n * verification.\n *\n * Edge runtime note: this verifier is synchronous and uses Node's\n * `crypto.timingSafeEqual` + `crypto.createHmac`. It will not run in\n * Cloudflare Workers / Vercel Edge / Deno Deploy as-is. An async Web\n * Crypto variant can be added if customers request it.\n */\n\nimport { createHmac, timingSafeEqual } from 'node:crypto';\nimport { Buffer } from 'node:buffer';\n\n/**\n * Default skew window (seconds). 5 minutes matches Stripe / GitHub /\n * common industry practice. Customers can override per-call if their\n * clock infrastructure warrants a tighter or looser bound.\n *\n * Mirrors `DEFAULT_TIMESTAMP_TOLERANCE_S` in the Python SDK.\n */\nexport const DEFAULT_TIMESTAMP_TOLERANCE_S = 300;\n\nconst SIGNATURE_HEADER = 'X-Risicare-Signature';\nconst TIMESTAMP_HEADER = 'X-Risicare-Timestamp';\n\n// The Python sender emits exactly one supported scheme today (`v1`). The\n// parser is structured so adding `v2` later is a non-breaking change:\n// list newer schemes first; the first match wins.\nconst SUPPORTED_SCHEMES = ['v1'] as const;\n\n// SHA-256 hex digest is always 64 lowercase hex chars. We pre-validate\n// the parsed signature against this shape BEFORE constant-time compare\n// so `Buffer.from(s, 'hex')` cannot silently truncate non-hex chars\n// (Node's Buffer.from 'hex' parser is lenient — it stops at the first\n// invalid character without raising).\nconst HEX_SHA256_RE = /^[0-9a-f]{64}$/;\n\n/**\n * Raised when a webhook delivery fails any verification check.\n *\n * Customers should catch this specifically rather than a generic `Error`\n * so verification failures are not conflated with other input problems\n * (e.g. body-parsing errors at the framework layer).\n *\n * The `message` is safe to log — it never includes the secret, the\n * expected signature, or the computed signature.\n */\nexport class WebhookVerificationError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'WebhookVerificationError';\n // Preserve prototype chain across the ES5/ES2022 transpilation\n // boundary so `instanceof` works for callers compiled to older\n // targets that interact with this library.\n Object.setPrototypeOf(this, WebhookVerificationError.prototype);\n }\n}\n\n/**\n * Options for `verifyWebhookSignature`. All fields are optional.\n */\nexport interface VerifyWebhookOptions {\n /**\n * Maximum clock-skew tolerance in seconds. Defaults to\n * `DEFAULT_TIMESTAMP_TOLERANCE_S` (300). Setting to 0 is supported\n * (strict same-second match) but discouraged in distributed\n * deployments.\n */\n toleranceS?: number;\n /**\n * Test hook — override \"current time\" in unix seconds.\n * Customers should not pass this.\n */\n _now?: number;\n}\n\n/**\n * Header-like inputs accepted by `verifyWebhookSignature`.\n *\n * Covers (a) Web API `Headers` (case-insensitive `.get`), (b) Node\n * `IncomingHttpHeaders` (plain object with lowercase keys, possibly\n * array-valued for multi-set headers), (c) `Map<string, string>`\n * (case-sensitive `.get`), and (d) plain `Record` (case-sensitive\n * property lookup, possibly array-valued).\n *\n * Lookup strategy: try the canonical mixed-case name first\n * (`X-Risicare-Signature`). If that returns undefined, fall back to the\n * lowercased form (`x-risicare-signature`). Mirrors the Python\n * `_get_header` helper.\n */\nexport type HeaderLookup =\n | Headers\n | Map<string, string>\n | Record<string, string | string[] | undefined>;\n\n/**\n * Payload shapes accepted by `verifyWebhookSignature`.\n *\n * `Buffer extends Uint8Array` in Node, so callers passing `Buffer`\n * satisfy the `Uint8Array` arm. `ArrayBuffer` is explicitly accepted\n * for callers using Web-API request bodies. `string` is UTF-8 encoded\n * internally.\n *\n * Crucially, callers must pass the EXACT bytes received over the\n * wire. Parsing JSON and re-serializing changes byte order and\n * whitespace; the signature will not match.\n */\nexport type WebhookPayload = Uint8Array | ArrayBuffer | string;\n\n/**\n * Look up a header by name, trying canonical mixed-case first, then\n * lowercase. Returns `undefined` if neither lookup yields a value.\n *\n * Web `Headers` and Node `IncomingHttpHeaders` are case-insensitive\n * lookups by spec; a plain `Record` is case-sensitive. We try both to\n * support either.\n */\nfunction getHeader(headers: HeaderLookup, name: string): string | undefined {\n const lower = name.toLowerCase();\n\n // Anything with a `.get(name)` method — covers Web `Headers`\n // (case-insensitive by spec, so the lowercase fallback is a no-op)\n // AND `Map<string, string>` (case-sensitive, so the fallback DOES\n // matter when the caller set lowercase keys). Web `Headers.get`\n // returns `null` for missing keys; Map returns `undefined`. Both\n // are normalised to `undefined` here.\n if (\n typeof (headers as { get?: (k: string) => unknown }).get === 'function'\n ) {\n const accessor = headers as { get: (k: string) => string | null | undefined };\n const v = accessor.get(name) ?? accessor.get(lower);\n return v ?? undefined;\n }\n\n // Plain object / IncomingHttpHeaders. IncomingHttpHeaders values\n // can be `string | string[] | undefined` (multi-set headers). For\n // a signature header there should only ever be one — but if a\n // client genuinely sets the same header twice, joining with `, `\n // would corrupt the signature. Take the first element only and let\n // a malformed-segment error surface downstream if the duplication\n // produced a problem.\n const dict = headers as Record<string, string | string[] | undefined>;\n const raw = dict[name] ?? dict[lower];\n if (raw === undefined) {\n return undefined;\n }\n if (Array.isArray(raw)) {\n return raw[0];\n }\n return raw;\n}\n\n/**\n * Coerce any accepted payload shape to a `Buffer` for HMAC consumption.\n *\n * `string` → UTF-8 encode.\n * `Uint8Array` (including `Buffer`) → `Buffer.from(uint8)` shares the\n * underlying ArrayBuffer with no copy.\n * `ArrayBuffer` → `Buffer.from(ab)` copies into a Node Buffer.\n *\n * Anything else throws `WebhookVerificationError`.\n */\nfunction coercePayload(payload: WebhookPayload): Buffer {\n if (typeof payload === 'string') {\n return Buffer.from(payload, 'utf-8');\n }\n // `Buffer` is a subclass of `Uint8Array`, so this arm covers both.\n if (payload instanceof Uint8Array) {\n return Buffer.from(\n payload.buffer,\n payload.byteOffset,\n payload.byteLength,\n );\n }\n if (payload instanceof ArrayBuffer) {\n return Buffer.from(payload);\n }\n throw new WebhookVerificationError(\n `payload must be Uint8Array, ArrayBuffer, Buffer, or string, got ${typeof payload}`,\n );\n}\n\n/**\n * Parse `t=<int>,v1=<hex>` (with possible additional unknown `kN=v`\n * segments) into `[timestamp, hex_signature]`.\n *\n * Tolerates extra segments for forward-compat: future scheme versions\n * may add new k=v pairs and this parser must not break.\n *\n * Mirrors `_parse_signature_header` in the Python SDK.\n */\nfunction parseSignatureHeader(raw: string): [number, string] {\n // Use a null-prototype object so a malicious segment like\n // `__proto__=v1=<hex>` or `constructor=...` cannot pollute the\n // global Object prototype via bracket-assignment, and so that\n // `'t' in parts` cannot return a false positive from inherited\n // properties like `toString` or `hasOwnProperty`. Python uses a\n // plain dict which has no equivalent prototype chain; this is a\n // JS-specific hardening with no Python counterpart.\n const parts: Record<string, string> = Object.create(null);\n\n for (const rawSegment of raw.split(',')) {\n const segment = rawSegment.trim();\n if (segment === '') {\n continue;\n }\n const eqIdx = segment.indexOf('=');\n if (eqIdx === -1) {\n throw new WebhookVerificationError(\n `Malformed segment in ${SIGNATURE_HEADER}: ${JSON.stringify(segment)}`,\n );\n }\n const key = segment.slice(0, eqIdx).trim();\n const value = segment.slice(eqIdx + 1).trim();\n parts[key] = value;\n }\n\n if (!('t' in parts)) {\n throw new WebhookVerificationError(\n `Missing \\`t=\\` (timestamp) in ${SIGNATURE_HEADER}`,\n );\n }\n\n // Pick the first supported scheme present. Today only `v1` exists.\n let scheme: string | undefined;\n for (const candidate of SUPPORTED_SCHEMES) {\n if (candidate in parts) {\n scheme = candidate;\n break;\n }\n }\n if (scheme === undefined) {\n // Sorted keys so the error message is deterministic regardless\n // of segment order in the input header.\n const keys = Object.keys(parts).sort();\n throw new WebhookVerificationError(\n `No supported signature scheme in ${SIGNATURE_HEADER}; ` +\n `expected one of (${SUPPORTED_SCHEMES.map((s) => `'${s}'`).join(', ')}), ` +\n `got keys [${keys.map((k) => `'${k}'`).join(', ')}]`,\n );\n }\n\n // parts['t'] is guaranteed defined by the `'t' in parts` check above.\n const tRaw = parts['t'] as string;\n // The segment was already `.trim()`ed during parsing, so leading /\n // trailing whitespace cannot reach here. The strict regex rejects\n // (a) empty string, (b) sign-only (\"-\", \"+\"), and (c) numeric-\n // prefix-then-garbage like \"123abc\" that `parseInt` would\n // permissively coerce to 123. Note: a leading `+` is rejected here\n // for parity with the Python sender's output (which is always\n // `str(int(time.time()))` — never carries a sign).\n if (!/^-?\\d+$/.test(tRaw)) {\n throw new WebhookVerificationError(\n `Non-integer timestamp in ${SIGNATURE_HEADER}: ${JSON.stringify(tRaw)}`,\n );\n }\n const ts = parseInt(tRaw, 10);\n if (!Number.isFinite(ts)) {\n // Defensive: a 21+ digit decimal string would `parseInt` to a\n // value outside `Number.MAX_SAFE_INTEGER`, and while `parseInt`\n // returns Infinity only for very specific inputs, treating any\n // non-finite result as a parse failure is the safe move.\n throw new WebhookVerificationError(\n `Non-integer timestamp in ${SIGNATURE_HEADER}: ${JSON.stringify(tRaw)}`,\n );\n }\n\n // scheme is one of SUPPORTED_SCHEMES so it's a known key.\n const sigHex = parts[scheme];\n if (sigHex === undefined || sigHex === '') {\n throw new WebhookVerificationError(\n `Empty ${scheme}= value in ${SIGNATURE_HEADER}`,\n );\n }\n\n return [ts, sigHex];\n}\n\n/**\n * Constant-time HMAC-SHA256 hex compare with explicit length pre-check.\n *\n * `crypto.timingSafeEqual` throws if the two buffers have different\n * lengths. To avoid leaking length information via the exception path,\n * we pre-validate the expected hex against the canonical sha256-hex\n * shape (64 lowercase hex chars) BEFORE attempting comparison. A\n * malformed expected → generic mismatch with no detail.\n *\n * The `computed` value comes from `createHmac(...).digest('hex')` and\n * is therefore always 64-char lowercase hex by construction; we don't\n * re-validate it.\n */\nfunction safeHexEqual(computed: string, expected: string): boolean {\n if (!HEX_SHA256_RE.test(expected)) {\n return false;\n }\n const a = Buffer.from(computed, 'hex');\n const b = Buffer.from(expected, 'hex');\n // Defensive: both buffers must be exactly 32 bytes after the regex\n // check above. If the platform ever returns a different length, the\n // explicit check below makes the failure mode a benign `false`\n // rather than a thrown RangeError from timingSafeEqual.\n if (a.length !== b.length) {\n return false;\n }\n return timingSafeEqual(a, b);\n}\n\n/**\n * Verify a Risicare webhook delivery. Throws `WebhookVerificationError`\n * on any failure; returns `undefined` on success.\n *\n * @param payload Raw request body bytes — the EXACT bytes received over\n * the wire. Re-serializing parsed JSON will change byte ordering and\n * break the signature.\n * @param headers Header lookup. Web `Headers`, `Map<string,string>`,\n * Node `IncomingHttpHeaders`, or plain `Record` all work. Lookup is\n * case-insensitive (canonical mixed-case tried first, then lowercase).\n * @param secret The shared secret configured on the Risicare webhook\n * record. Returned by `POST /v1/webhooks` once at create time.\n * @param opts Optional overrides — `toleranceS` (default 300) and\n * `_now` (test hook).\n *\n * @throws WebhookVerificationError on any of: missing headers, malformed\n * signature, timestamp outside tolerance, HMAC mismatch, or invalid\n * payload type.\n */\nexport function verifyWebhookSignature(\n payload: WebhookPayload,\n headers: HeaderLookup,\n secret: string,\n opts: VerifyWebhookOptions = {},\n): void {\n const toleranceS =\n opts.toleranceS ?? DEFAULT_TIMESTAMP_TOLERANCE_S;\n\n // Validate payload type FIRST so a caller passing a clearly-wrong\n // type gets the most informative error (same ordering as Python).\n const payloadBytes = coercePayload(payload);\n\n const sigHeader = getHeader(headers, SIGNATURE_HEADER);\n if (sigHeader === undefined || sigHeader === '') {\n throw new WebhookVerificationError(\n `Missing ${SIGNATURE_HEADER} header`,\n );\n }\n const tsHeader = getHeader(headers, TIMESTAMP_HEADER);\n if (tsHeader === undefined || tsHeader === '') {\n throw new WebhookVerificationError(\n `Missing ${TIMESTAMP_HEADER} header`,\n );\n }\n\n const [tsInSig, expectedHex] = parseSignatureHeader(sigHeader);\n\n // Cross-check: the standalone X-Risicare-Timestamp header MUST agree\n // with the t= value baked into the signature. A discrepancy means\n // the sender is buggy or someone has split the request — either way\n // refuse. Mirrors Python webhooks.py:214-217.\n if (!/^-?\\d+$/.test(tsHeader)) {\n throw new WebhookVerificationError(\n `Non-integer ${TIMESTAMP_HEADER}: ${JSON.stringify(tsHeader)}`,\n );\n }\n const tsStandalone = parseInt(tsHeader, 10);\n if (!Number.isFinite(tsStandalone)) {\n throw new WebhookVerificationError(\n `Non-integer ${TIMESTAMP_HEADER}: ${JSON.stringify(tsHeader)}`,\n );\n }\n if (tsStandalone !== tsInSig) {\n throw new WebhookVerificationError(\n `Timestamp mismatch: ${TIMESTAMP_HEADER}=${tsStandalone}, signature t=${tsInSig}`,\n );\n }\n\n const now =\n opts._now !== undefined\n ? Math.trunc(opts._now)\n : Math.floor(Date.now() / 1000);\n const skew = Math.abs(now - tsInSig);\n if (skew > toleranceS) {\n throw new WebhookVerificationError(\n `Webhook timestamp outside tolerance: skew=${skew}s, max=${toleranceS}s`,\n );\n }\n\n // Compute the canonical-string HMAC: `<ts>.<payload_bytes>`.\n // Two .update() calls is equivalent to one .update(concatenated)\n // and avoids materializing a copy of the payload.\n const hmac = createHmac('sha256', secret);\n hmac.update(`${tsInSig}.`);\n hmac.update(payloadBytes);\n const computed = hmac.digest('hex');\n\n if (!safeHexEqual(computed, expectedHex)) {\n // Deliberately generic message — leaking \"computed != expected\"\n // or the expected value would assist an attacker doing oracle\n // attacks. Mirrors Python webhooks.py:228-231.\n throw new WebhookVerificationError('Webhook signature mismatch');\n }\n}\n"],"mappings":"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","names":["createHash","debug","SpanKind","SpanStatus","SemanticPhase","AgentRole","MessageType","session","agent","G","G","getTracer","createHash","getTracer","agent","getTracer","getTracer","session","getTracer","getTracer","session","agent","getTracer","getTracer","getTracer","getTracer","getTracer","Buffer"]}
|
|
1
|
+
{"version":3,"sources":["../src/client.ts","../src/globals.ts","../src/utils/log.ts","../src/utils/text.ts","../src/utils/scrub.ts","../src/masking.ts","../src/exporters/batch.ts","../src/config.ts","../src/ids.ts","../src/types.ts","../src/utils/clock.ts","../src/span.ts","../src/noop.ts","../src/utils/sampling.ts","../src/runtime/config.ts","../src/runtime/taxonomy.generated.ts","../src/runtime/interceptors.ts","../src/context/storage.ts","../src/tracer.ts","../src/version.ts","../src/exporters/http.ts","../src/exporters/console.ts","../src/utils/stream-proxy.ts","../src/runtime/cache.ts","../src/runtime/applier.ts","../src/runtime/loader.ts","../src/runtime/runtime.ts","../src/context/agent.ts","../src/lifecycle.ts","../src/decorators/agent.ts","../src/context/session.ts","../src/decorators/session.ts","../src/context/phase.ts","../src/decorators/phase.ts","../src/decorators/multi-agent.ts","../src/context/trace-context.ts","../src/context/registry.ts","../src/streaming.ts","../src/context/dedup.ts","../src/frameworks/langchain.ts","../src/frameworks/langgraph.ts","../src/utils/assert-client.ts","../src/frameworks/instructor.ts","../src/frameworks/llamaindex.ts","../src/webhooks.ts"],"sourcesContent":["/**\n * RisicareClient — singleton client managing SDK lifecycle.\n *\n * Handles initialization, shutdown, and the connection between\n * the Tracer and the export pipeline (batch processor + HTTP exporter).\n *\n * Usage:\n * import { init, shutdown } from 'risicare';\n * init({ apiKey: 'rsk-...' }); // API key determines project\n * // ... instrument code ...\n * await shutdown(); // flush remaining spans\n */\n\n// ⚠ F-SDKJSREPORTERROR-001 (W20, 2026-08-14) — STATIC, and it must stay static.\n// This was `require('node:crypto')` INSIDE `_errorFingerprint()`. esbuild\n// rewrites a bare `require` in an ESM output bundle to `__require(\"crypto\")`,\n// whose shim THROWS at call time; `reportError`'s catch-all then swallowed it\n// (`client.ts` ~:597, \"Never crash the host application\"). Net effect measured\n// on clean tarball installs of the PUBLISHED 0.4.2: reportError() delivered\n// ZERO spans under ESM and one under CJS — a silent no-op for every ESM\n// customer, which is the default for modern Node apps.\n//\n// A static import adds NO new environmental constraint: the package's main\n// entry already pulls `node:crypto` statically, because `src/index.ts` re-\n// exports `./webhooks.js`, which does `import { createHmac, timingSafeEqual }\n// from 'node:crypto'` at `webhooks.ts:53`. Same precedent, same module.\n//\n// ⚠ Do NOT \"optimise\" this back to a lazy require to keep the module edge-safe.\n// It would not achieve that (see above) and it silently re-breaks ESM. Verify\n// with `bash fix-workstream/perf/sdkjs/reporterror_module_system_probe.sh`,\n// whose CJS arm is the non-vacuity control and gates the exit code.\nimport { createHash } from 'node:crypto';\nimport { type RisicareConfig, resolveConfig, given } from './config.js';\nimport { Tracer, attachErrorCode } from './tracer.js';\nimport { SDK_VERSION } from './version.js';\nimport { BatchSpanProcessor, SHUTDOWN_BUDGET_MS, normalizeTimeoutMs } from './exporters/batch.js';\nimport { HttpExporter } from './exporters/http.js';\nimport { ConsoleExporter } from './exporters/console.js';\nimport { SpanKind, SpanStatus } from './types.js';\nimport type { SpanExporter } from './exporters/base.js';\nimport { setDebug, debug, warn } from './utils/log.js';\nimport { cutCodePoints } from './utils/text.js';\nimport { endOpenProviderSpans } from './utils/stream-proxy.js';\nimport { maskText, SCORE_COMMENT_KEY } from './masking.js';\nimport {\n getClient as getGlobalClient,\n setClient as setGlobalClient,\n getTracer as getGlobalTracer,\n setTracer as setGlobalTracer,\n} from './globals.js';\n// PR-4+5 review NIT (2026-05-25): static ESM import. Pre-fix this was a\n// CJS `require('./runtime/runtime.js')` inside the constructor, which\n// dies in TS-source consumers (vitest, ts-node ESM) because the .js\n// resolution fails — tripping the FixRuntime catch and emitting a\n// spurious \"auto-fix is OFFLINE\" warning on EVERY test that calls init().\n// Static import resolves at module-load time and works identically under\n// ESM and CJS bundles produced by tsup. The CON-194 test still exercises\n// the failure path via vi.mock() (which intercepts ES imports correctly).\nimport { initFixRuntime, shutdownFixRuntime } from './runtime/runtime.js';\nimport { safeUrl, scrubText } from './utils/scrub.js';\n\n/**\n * Signals whose default disposition is TERMINATE, with their numbers — needed\n * for the conventional `128 + signum` exit code (SIGTERM 143, SIGINT 130).\n * SDK-RELEASE-RULING.md §3.\n */\nconst TERMINATING_SIGNALS: ReadonlyArray<readonly [string, number]> = [\n ['SIGTERM', 15],\n ['SIGINT', 2],\n];\n\n/**\n * Headroom between the shutdown budget and the backstop that force-exits if\n * shutdown never resolves. It must be > 0 or the backstop races the drain; it\n * is small because it buys nothing but the difference between \"the drain\n * finished\" and \"the drain is wedged\". The drain itself is a hard wall-clock\n * bound: each round is raced against the budget, and an export that the drain\n * abandons is aborted. So 500 ms covers only timer delay and the exporters'\n * own `shutdown()` after the drain, not a round that overruns the budget.\n */\nconst BACKSTOP_MARGIN_MS = 500;\n\n/**\n * SDK-RELEASE-RULING.md §5 — the final tally survives the teardown.\n *\n * `shutdown()` clears the global client, so without this the natural pattern\n * `await shutdown(); console.log(getMetrics())` reported `droppedSpans: 0` from\n * a hardcoded literal, in the exact process that had just discarded spans.\n *\n * Written once per shutdown; cleared by `init()` so a second lifecycle never\n * serves the first's tally. Mirrors `_final_metrics` in `client.py`.\n */\nlet _finalMetrics: ReturnType<BatchSpanProcessor['getMetrics']> | undefined;\n\n/**\n * score() requests: the timeout, the ones not yet settled, and the number that\n * failed since `init()`. Root `flush()` waits for the pending ones inside its\n * deadline. Through 0.7.1 a score request had no timeout, followed redirects,\n * never read the status, and a failure was a debug line only.\n */\nconst SCORE_TIMEOUT_MS = 2000;\nconst _pendingScores = new Set<Promise<void>>();\nlet _failedScores = 0;\n// The failed-score count that the last finished flush() saw. A flush() answers\n// false when the count is above this mark, and then raises the mark: each\n// failed score makes one flush false, also when it failed with no flush running.\nlet _failedScoresFlushMark = 0;\n\n/**\n * The score slot rule (both SDKs; review of PR #44):\n * - at most SCORE_MAX_IN_FLIGHT score requests are in flight;\n * - a score that finds no free slot waits, with NO timer of its own: the 2000 ms\n * bound of a score starts when its request starts;\n * - at most SCORE_MAX_WAITING scores wait; one more fails at once and is counted;\n * - when a flush or shutdown bound ends, the scores that still wait are counted as\n * failed and never start a request.\n * With one connection for each score, 200 scores at once overflowed the accept\n * queue of a server (128 on macOS). With a timer that also covered the wait, 150 of\n * 200 scores to a sink that answers in 1 s were lost.\n */\nconst SCORE_MAX_IN_FLIGHT = 50;\nconst SCORE_MAX_WAITING = 1000;\nconst SCORE_CAP_REASON = `not sent: ${SCORE_MAX_WAITING} scores wait for a free slot`;\nconst SCORE_DEADLINE_REASON = 'not sent before the deadline';\nlet _scoresInFlight = 0;\ninterface ScoreWaiter {\n start: () => void;\n fail: (reason: string) => void;\n}\nconst _scoreWaiters: ScoreWaiter[] = [];\n\n/** Start waiting scores while a slot is free. */\nfunction _startWaitingScores(): void {\n while (_scoresInFlight < SCORE_MAX_IN_FLIGHT && _scoreWaiters.length > 0) {\n _scoreWaiters.shift()!.start();\n }\n}\n\n/** Count every waiting score as failed. None of them starts a request after this. */\nfunction _failWaitingScores(reason: string): void {\n for (const waiter of _scoreWaiters.splice(0)) waiter.fail(reason);\n}\n\n// One WARNING for a failed score, then at most one for each window. The\n// failures in the window are counted, and the next WARNING gives their number.\nlet _scoreWarnWindowMs = 10_000;\nconst SCORE_NAME_MAX = 200;\nlet _scoreWarnedAt: number | undefined;\nlet _scoreHeld = 0;\nlet _scoreHeldReason = '';\n\n/** @internal Tests only: change the WARNING window. */\nexport function _setScoreWarnWindowMsForTesting(ms: number): void {\n _scoreWarnWindowMs = ms;\n}\n\nfunction _resetScoreFailures(): void {\n _failedScores = 0;\n _failedScoresFlushMark = 0;\n _scoreWarnedAt = undefined;\n _scoreHeld = 0;\n _scoreHeldReason = '';\n}\n\nfunction _heldText(): string {\n return ` ${_scoreHeld} more scores failed after the last warning. The last reason: ${_scoreHeldReason}.`;\n}\n\n/**\n * Count one failed score request, and write a WARNING when the window lets it.\n * The first failure writes at once. A failure less than 10 s after the last\n * WARNING is counted and held; the next WARNING gives the number of held\n * failures and the last reason. The WARNING gives the score name (at most 200\n * characters) and the status or the error code only.\n */\nfunction _scoreFailed(name: string, reason: string): void {\n _failedScores += 1;\n const now = Date.now();\n if (_scoreWarnedAt !== undefined && now - _scoreWarnedAt < _scoreWarnWindowMs) {\n _scoreHeld += 1;\n _scoreHeldReason = reason;\n return;\n }\n let message = `score ${JSON.stringify(name.slice(0, SCORE_NAME_MAX))} failed: ${reason}.`;\n if (_scoreHeld > 0) message += _heldText();\n _scoreWarnedAt = now;\n _scoreHeld = 0;\n _scoreHeldReason = '';\n warn(message);\n}\n\n/** Write the held failures now, if there are any. Root `flush()` calls this. */\nfunction _warnHeldScores(): void {\n if (_scoreHeld === 0) return;\n const message = _heldText().trimStart();\n _scoreWarnedAt = Date.now();\n _scoreHeld = 0;\n _scoreHeldReason = '';\n warn(message);\n}\n\n/** Resolve `true` when no score request is pending, `false` at the timeout. */\nasync function _waitForPendingScores(timeoutMs: number): Promise<boolean> {\n if (_pendingScores.size === 0) return true;\n let timer: ReturnType<typeof setTimeout> | undefined;\n const expired = new Promise<boolean>((resolve) => {\n timer = setTimeout(() => resolve(false), Math.max(0, timeoutMs));\n });\n const settled = (async () => {\n while (_pendingScores.size > 0) await Promise.all([..._pendingScores]);\n return true;\n })();\n try {\n return await Promise.race([settled, expired]);\n } finally {\n clearTimeout(timer);\n }\n}\n\n// ─── Client Class ───────────────────────────────────────────────────────────\n\nclass RisicareClient {\n readonly config: ReturnType<typeof resolveConfig>;\n readonly processor: BatchSpanProcessor;\n readonly tracer: Tracer;\n /** RULING §5. The signal path does NOT clear the global client, so without\n * this flag `getMetrics()` would keep reporting `\"running\"` over a processor\n * that has already been torn down. */\n isShutdown = false;\n private _shutdownPromise: Promise<void> | undefined;\n private _shutdownHandlers: { signal: string; handler: () => void }[] = [];\n\n constructor(config?: Partial<RisicareConfig>) {\n this.config = resolveConfig(config);\n\n // API key format validation. `rsk-` is the legacy format (kept working\n // forever); `rski_` (Ingest) and `rsks_` (Secret) are the new checksummed\n // format — design: closure-plan-2026-09-25/org-project-ux/\n // 12-A2-A5-key-model-design.md §3. This is a hint only, never enforced.\n //\n // S14: `warn`, not `debug`. `setDebug()` runs at the end of this\n // constructor, so a `debug()` call here never printed for a customer. The\n // message never contains any part of the key.\n const hasKnownPrefix =\n this.config.apiKey?.startsWith('rsk-') ||\n this.config.apiKey?.startsWith('rski_') ||\n this.config.apiKey?.startsWith('rsks_');\n if (this.config.apiKey && !hasKnownPrefix) {\n warn(\n 'the API key does not look like a Risicare key: it should start with \"rsk-\", \"rski_\" or \"rsks_\". ' +\n 'Tracing continues with this key.',\n );\n }\n // No key (empty or unset) and tracing not set explicitly: tracing is off\n // (`enabled` defaults to `!!apiKey`). Say so once. An explicit\n // `enabled: false` or RISICARE_TRACING value is the caller's choice and\n // gets no WARNING; an explicit `enabled: true` gets the \"NO API key\"\n // WARNING further down instead.\n const tracingSetExplicitly =\n config?.enabled !== undefined || (process.env.RISICARE_TRACING ?? '').trim() !== '';\n if (!this.config.apiKey && !this.config.enabled && !tracingSetExplicitly) {\n warn(\n 'Risicare found no API key. Tracing is off and the SDK sends no span. ' +\n 'Pass apiKey to init() or set RISICARE_API_KEY.',\n );\n }\n\n // Build exporter chain\n //\n // ⚠ F-SDKJSCONSOLE-001 (fixed 2026-08-15, W23). The `else` arm below used to\n // read `exporter = new ConsoleExporter()` — \"No API key and not debug — use\n // console as fallback\". `exporters/console.ts` writes\n // `JSON.stringify(span.toPayload())` to `process.stderr`: the WHOLE payload,\n // every attribute, every event, every exception, with NO redaction of any\n // kind. Neither Tier-1 (credentials) nor Tier-2 (email/phone/SSN/card/IPv4)\n // exists in the SDK — both run server-side, one hop later — so there is\n // nothing to fall back on and the only safe action is not to write.\n //\n // A falsy API key is not an exotic state: it is a missing, mistyped or\n // not-injected `RISICARE_API_KEY` — CI, staging, a new dev's laptop, a\n // container whose secret failed to mount. Measured from the extracted,\n // PUBLISHED `risicare-0.4.2.tgz` in BOTH module systems (W20-P2, re-derived\n // W23): `RISICARE_TRACING=true` with no key printed a synthetic email, SSN,\n // Visa test PAN and RFC-5737 address to the customer's own stderr. No debug\n // flag was required and no warning was emitted.\n //\n // Python in the identical state WARNS AND DROPS (`client.py:941-947`) and\n // attaches its ConsoleExporter only under `if config.debug`\n // (`client.py:868-875`). This makes JS match Python rather than inventing a\n // third behaviour: the explicit debug opt-in below is UNCHANGED — a customer\n // who asks for console output still gets it — and the accidental state now\n // configures NO exporter at all, which is exactly what Python does.\n //\n // Consequence, deliberate and honest: with an empty exporter array the\n // processor's existing accounting takes over — spans are re-queued to the\n // MAX_RETRIES bound and then discarded as `transport_refused`, COUNTED and\n // WARNED (\"check the api_key and the endpoint\"), instead of being reported\n // as delivered. A DropExporter returning SUCCESS would have been the smaller\n // diff and would have inflated `exportedSpans` for spans that reached\n // nothing — the F-HONEST-001 defect, re-introduced in the SDK.\n let exporter: SpanExporter | undefined;\n if (this.config.debug && !this.config.apiKey) {\n exporter = new ConsoleExporter();\n } else if (this.config.apiKey) {\n exporter = new HttpExporter({\n endpoint: this.config.endpoint,\n apiKey: this.config.apiKey,\n projectId: this.config.projectId || undefined,\n environment: this.config.environment || undefined,\n compress: this.config.compress,\n });\n } else {\n // No API key and not debug — configure NO exporter, and say so. Spans are\n // created and then dropped, exactly as in Python.\n exporter = undefined;\n if (this.config.enabled) {\n // console.warn, not debug() — `debug` is off by default, which is how\n // F-SDKJSREPORTERROR-001 stayed invisible in a shipped release. Same\n // defensive wrapper as the FixRuntime warning below: some sandboxed and\n // edge runtimes have a closed stderr, and a logging call must never be\n // the thing that crashes a customer's process.\n try {\n console.warn(\n `[risicare] tracing is enabled but NO API key is configured — spans are ` +\n `created and then DROPPED, not sent to ${this.config.endpoint}. ` +\n `Pass apiKey to init() (or set the RISICARE_API_KEY env var). ` +\n `Span data is NOT written to the console: it would be unredacted. ` +\n `Pass debug:true if you want console output for local development.`\n );\n } catch {\n // Prefer silent over crash.\n }\n }\n }\n\n this.processor = new BatchSpanProcessor({\n exporters: exporter ? [exporter] : [],\n batchSize: this.config.batchSize,\n batchTimeoutMs: this.config.batchTimeoutMs,\n maxQueueSize: this.config.maxQueueSize,\n debug: this.config.debug,\n // The processor is the ONE choke point every exporter is behind. Masking\n // anywhere downstream (in the HTTP exporter, say) would leave a hole for\n // any other exporter; masking upstream would put customer code on the\n // span-end call path.\n mask: this.config.mask,\n // Same argument as `mask`: the processor is the ONE choke point every\n // exporter is behind, and the only place BOTH content paths — provider\n // capture and hand-set attributes — can be gated together. The Tracer\n // still carries `traceContent` for the provider patches to read; that is\n // now a convenience, not the enforcement point.\n traceContent: this.config.traceContent,\n });\n\n this.tracer = new Tracer({\n onSpanEnd: (span) => this.processor.onSpanEnd(span),\n sampleRate: this.config.sampleRate,\n enabled: this.config.enabled,\n traceContent: this.config.traceContent,\n // F-SDKJSSVCNAME-001 — these were resolved into `config` and then read by\n // nothing. The Tracer is where Python emits them, so JS emits them there\n // too rather than inventing a second site.\n serviceName: this.config.serviceName,\n serviceVersion: this.config.serviceVersion,\n });\n\n // Start the batch processor (enables span queuing and periodic flushing)\n this.processor.start();\n\n // Start FixRuntime for runtime fix application, ONLY ON OPT-IN (0.7.0;\n // see `RisicareConfig.fixRuntime`). Through 0.6.0 it started whenever an\n // apiKey was set, so the server could change the customer's agent by\n // default. When it starts, it loads active fixes from /v1/fixes/active,\n // caches with TTL and background-refreshes every 60s. The OpenAI chat patch\n // calls interceptCall() before the LLM call. It runs the input guards; with\n // no errorCode it applies no prompt, parameter or fallback fix. When it is\n // off, no runtime exists, so interceptCall() finds nothing to apply.\n //\n // CON-194: previously the catch was an empty-body silent swallow,\n // which meant a customer whose FixRuntime failed to initialize\n // (network unreachable, bad API key, server 5xx, etc.) saw ZERO\n // signal and assumed auto-fix was running. Now the catch logs\n // console.warn with an actionable message — visible at default\n // console output, including the api endpoint (fix reads go there, not to\n // the span endpoint) so customers can verify reachability. Mirrors the\n // Python SDK fix at client.py:520-528.\n //\n // ⚠ A failed LOAD of the fixes (network, 401, 5xx) does not reach this\n // catch: `initFixRuntime()` catches every fault. `FixLoader.start()` logs\n // its own WARNING for a failed first load. No known path makes\n // `initFixRuntime()` throw; the tests reach this catch through a mock.\n if (this.config.apiKey && this.config.enabled && this.config.fixRuntime) {\n try {\n initFixRuntime({\n apiEndpoint: this.config.apiEndpoint,\n apiKey: this.config.apiKey,\n enabled: true,\n debug: this.config.debug,\n });\n } catch (e) {\n // FixRuntime failure is non-fatal — tracing still works.\n // Surface a one-time console.warn so the customer knows.\n const errName = e instanceof Error ? e.name : 'Error';\n const errMsg = scrubText(e instanceof Error ? e.message : String(e), [this.config.apiKey]);\n try {\n console.warn(\n `[risicare] FixRuntime initialization failed — auto-fix is OFFLINE for this process. ` +\n `apiEndpoint=${safeUrl(this.config.apiEndpoint)} error=${errName}: ${errMsg}. ` +\n `Tracing + reporting still work; only fix application is disabled. ` +\n `Pass debug:true in init() options for the full traceback.`\n );\n } catch {\n // Defensive: if console.warn itself throws (closed stderr in\n // some sandboxed/edge environments), prefer silent over crash.\n }\n if (this.config.debug) {\n debug(\n `FixRuntime init traceback: ${scrubText(e instanceof Error && e.stack ? e.stack : String(e), [this.config.apiKey], 2000)}`,\n );\n }\n }\n }\n\n // Register shutdown hooks\n this._registerShutdownHooks();\n\n // Enable internal debug logging if configured\n setDebug(this.config.debug);\n debug(`Initialized: enabled=${this.config.enabled}, endpoint=${safeUrl(this.config.endpoint)}`);\n if (!this.config.fixRuntime) {\n debug(\n 'FixRuntime is off: nothing polls /fixes/active and no fix is applied. ' +\n 'Opt in with fixRuntime: true or RISICARE_FIX_RUNTIME=true.',\n );\n }\n }\n\n get enabled(): boolean {\n return this.tracer.enabled;\n }\n\n set enabled(value: boolean) {\n this.tracer.enabled = value;\n }\n\n // Audit #6: Promise-based shutdown dedup (fixes TOCTOU race condition)\n async shutdown(timeoutMs?: number): Promise<void> {\n if (this._shutdownPromise) return this._shutdownPromise;\n this._shutdownPromise = this._doShutdown(timeoutMs);\n return this._shutdownPromise;\n }\n\n private async _doShutdown(timeoutMs?: number): Promise<void> {\n debug('Shutting down...');\n\n // Audit #3: Remove process listeners to prevent leak\n for (const { signal, handler } of this._shutdownHandlers) {\n process.removeListener(signal, handler);\n }\n this._shutdownHandlers = [];\n\n // A provider span that is still open (for example a stream that nobody\n // read) ends now, so the processor exports it and it is not lost.\n endOpenProviderSpans();\n\n await this.processor.shutdown(timeoutMs);\n // The shutdown bound ended (also on SIGTERM and SIGINT, which reach this method):\n // a score that still waits for a slot is counted as failed and is not sent.\n _failWaitingScores(SCORE_DEADLINE_REASON);\n\n // RULING §5: snapshot HERE, in the one place every teardown path passes\n // through.\n //\n // ⚠ THIS SITE IS THE WHOLE POINT, and the obvious site is wrong. A first\n // implementation snapshotted in the module-level `shutdown()` — which the\n // SIGTERM/SIGINT handlers never call. They call THIS method, so on exactly\n // the path a container redeploy takes, `getMetrics()` would have reported\n // a live-looking reading over a torn-down processor. The Python SDK had the\n // identical trap on its own signal path; one rule, two languages, both\n // instrumented at the shared site rather than the canonical one.\n this.isShutdown = true;\n _finalMetrics = this.processor.getMetrics();\n }\n\n /**\n * Flush pending spans.\n *\n * @returns `true` only if everything queued at entry was DELIVERED.\n *\n * RULING §6: this used to discard the processor's boolean and return\n * `Promise<void>`, which resolves without throwing and reads to a caller\n * exactly like success. A discarded answer is not meaningfully better than a\n * false one — both leave the customer unable to tell *drained* from\n * *discarded*.\n */\n async flush(timeoutMs?: number): Promise<boolean> {\n return this.processor.flush(timeoutMs);\n }\n\n /**\n * SDK-RELEASE-RULING.md §3 — who decides whether the process dies.\n *\n * The contract, and it is the same one the Python SDK now satisfies:\n *\n * the SDK's signal handler never CHANGES whether the signal\n * terminates the process.\n *\n * Registering ANY listener for SIGTERM/SIGINT displaces Node's default\n * terminate. Before this, the SDK registered one unconditionally, and on the\n * success path `clearTimeout` removed the 5 s `process.exit(1)` backstop —\n * so a JS app with a live event loop drained, cleared its own only exit, and\n * **ran forever**. The orchestrator waited out the whole grace period and\n * SIGKILLed, which exits **137** and reads as OOM-killed in every dashboard.\n * Measured >25 s alive on both 0.5.0 and a clean-rebuilt 0.4.2, so this is\n * PRE-EXISTING (`F-SDKJSEXIT-001`), not a regression of the data-loss fix.\n *\n * The rule splits on one question — did the signal already have an owner?\n *\n * * **No prior listener.** Node's default was termination and OUR\n * registration displaced it. We owe the process that death.\n * * **A prior listener exists.** The application took ownership before the\n * SDK loaded. We drain and RETURN; termination was never ours to decide,\n * and forcing it would cut off the app's own graceful shutdown.\n *\n * ⚠ `beforeExit` is deliberately NOT in that logic. It is not a signal and\n * carries no termination the SDK could displace — the loop has already\n * drained and the process is leaving on its own.\n */\n private _registerShutdownHooks(): void {\n // `beforeExit` first: no ownership question, no backstop, no exit.\n const onBeforeExit = () => {\n this.shutdown().catch(() => {});\n };\n process.once('beforeExit', onBeforeExit);\n this._shutdownHandlers.push({ signal: 'beforeExit', handler: onBeforeExit });\n\n for (const [signal, signum] of TERMINATING_SIGNALS) {\n // Captured ONCE, at registration — asking later would count our own.\n const weDisplacedDefault = process.listenerCount(signal) === 0;\n\n const handler = () => {\n // Backstop: DERIVED from the shutdown budget, never a second literal.\n // The two used to be an independent `5000` each, so a drain allowed\n // 5,000 ms raced a `process.exit(1)` firing at 5,000 ms — killing the\n // drain at its deadline, with the wrong exit code, before the residue\n // WARNING (the previous ruling's primary remedy) could print.\n const backstop = setTimeout(\n () => process.exit(128 + signum),\n SHUTDOWN_BUDGET_MS + BACKSTOP_MARGIN_MS,\n );\n backstop.unref();\n\n this.shutdown()\n .catch(() => {})\n .finally(() => {\n clearTimeout(backstop);\n if (!weDisplacedDefault) return; // the app owns termination\n\n // Our listener is gone (`process.once` + `_doShutdown` removed\n // them), so re-raising reaches Node's default and terminates for\n // real — WIFSIGNALED, not merely an exit code that looks like one.\n try {\n process.kill(process.pid, signal as NodeJS.Signals);\n } catch {\n process.exit(128 + signum);\n }\n // Belt and braces: if the application added a listener DURING our\n // drain, the re-raise above went to it instead of terminating and\n // we would hang exactly as before. unref()'d, so it cannot itself\n // hold open a process that is already leaving.\n const failsafe = setTimeout(() => process.exit(128 + signum), 100);\n failsafe.unref();\n });\n };\n\n process.once(signal, handler);\n this._shutdownHandlers.push({ signal, handler });\n }\n }\n}\n\n// ─── Public API ─────────────────────────────────────────────────────────────\n\n/**\n * Initialize the Risicare SDK. Call once at application startup.\n *\n * @example\n * import { init } from 'risicare';\n * init({ apiKey: 'rsk-...', serviceName: 'my-agent', environment: 'production' });\n */\nexport function init(config?: Partial<RisicareConfig>): void {\n const existing = getGlobalClient() as RisicareClient | undefined;\n if (existing) {\n // F-359: warn loudly when re-init would silently discard a config change.\n // The first init wins; a second init with a different apiKey/endpoint/\n // environment is almost certainly a bug (e.g., a side-effect import that\n // calls init() in a library, then the app's own init() with real config\n // gets ignored).\n if (config) {\n const incoming = resolveConfig(config);\n const diffs: string[] = [];\n const checkedKeys: Array<keyof typeof incoming> = [\n 'apiKey',\n 'endpoint',\n 'environment',\n 'serviceName',\n 'serviceVersion',\n 'sampleRate',\n ];\n for (const k of checkedKeys) {\n if (incoming[k] !== existing.config[k]) {\n // Don't print apiKey contents — just say \"differs\".\n const newRender = k === 'apiKey' ? '<redacted>' : JSON.stringify(incoming[k]);\n const oldRender = k === 'apiKey' ? '<redacted>' : JSON.stringify(existing.config[k]);\n diffs.push(`${String(k)}: ${oldRender} → ${newRender}`);\n }\n }\n if (diffs.length > 0) {\n console.warn(\n '[risicare] init() called twice with different config; the FIRST call wins. ' +\n 'Call shutdown() before re-initializing. Differences ignored: ' +\n diffs.join(', '),\n );\n } else {\n debug('init() called twice with identical config; no-op');\n }\n } else {\n debug('init() called twice; no-op');\n }\n return;\n }\n\n // RULING §5: a NEW lifecycle starts with no retained tally — otherwise\n // `init(); shutdown(); init()` would serve the FIRST run's losses as if they\n // belonged to the second.\n _finalMetrics = undefined;\n _resetScoreFailures();\n\n const client = new RisicareClient(config);\n setGlobalClient(client);\n setGlobalTracer(client.tracer);\n}\n\n/**\n * Gracefully shut down the SDK. Flushes pending spans before resolving.\n *\n * @param timeoutMs - The shutdown budget in milliseconds (default 5000). It is a\n * hard wall-clock bound. A value that is not a finite number (NaN, Infinity, a\n * string, null) gives 5000. A negative value gives 0. The largest value is\n * 2**31 - 1.\n *\n * At the deadline, `shutdown()` stops the export in flight. Spans still queued\n * and spans in the stopped export are counted as `shutdown_residue`, with one\n * WARNING: they were not confirmed as delivered. The server may have received\n * the spans of the stopped export. Each exporter's own `shutdown()` gets only\n * the time that is left of the budget.\n *\n * Limit: the stop does not end a TLS handshake that stalls. Such a handshake\n * can keep the process alive about 10 s after `shutdown()` returns.\n */\nexport async function shutdown(timeoutMs?: number): Promise<void> {\n // Stop FixRuntime first (stops background refresh)\n try {\n shutdownFixRuntime();\n } catch {\n // FixRuntime may not be initialized\n }\n\n const client = getGlobalClient() as RisicareClient | undefined;\n if (!client) return;\n // RULING §5: the final tally is snapshotted inside `_doShutdown()`, which\n // this reaches and which the signal handlers reach directly. Do NOT add a\n // second snapshot here.\n await client.shutdown(timeoutMs);\n setGlobalClient(undefined);\n setGlobalTracer(undefined);\n}\n\n/**\n * Flush all pending spans without shutting down.\n *\n * @param timeoutMs - The budget in milliseconds (default 5000). It is a hard\n * wall-clock bound on the wait: at the deadline `flush()` resolves `false`.\n * A value that is not a finite number (NaN, Infinity, a string, null) gives\n * 5000. A negative value gives 0. The largest value is 2**31 - 1.\n * @returns `true` only if everything queued at entry was DELIVERED and no span\n * was lost since the previous `flush()` returned. A loss is reported by the next\n * `flush()`, one time. It returns `false` in these cases:\n * - the deadline expired with spans still queued or in flight;\n * - a span was discarded since the previous flush returned (F-SDKCB-001 §6);\n * - the backend rejected a span since the previous flush returned, or its ack\n * did not account for a span;\n * - it is called after a `shutdown()` that left spans undelivered\n * (`shutdown_residue`).\n * An uninitialised SDK returns `true`: it was handed nothing, and it lost nothing.\n *\n * `flush()` never stops a request that is already sent. At the deadline it stops\n * waiting; the export in flight continues and ends by its own rules.\n *\n * Limit: that export can keep the process alive after `flush()` returns `false`,\n * until its own timeouts end (measured on a silent server: 22 s). To end a\n * process within a bound, call `await shutdown(timeoutMs)`. It stops the export\n * in flight.\n *\n * Scores: `flush()` also waits, inside the same deadline, for each `score()`\n * request that is not complete. It returns `false` when a score is not complete\n * at the deadline, or when a score failed since the previous `flush()` returned.\n * Each failed score makes one flush `false`, as each lost span does.\n *\n * ⚠ Signature change in 0.5.0 — was `Promise<void>`. Existing callers that\n * ignore the result keep working unchanged.\n */\nexport async function flush(timeoutMs?: number): Promise<boolean> {\n // The same rule as the processor: a value that is not a finite number gives\n // the default, so the score wait and the span wait share one deadline.\n const budgetMs = normalizeTimeoutMs(timeoutMs);\n const deadline = Date.now() + budgetMs;\n // Read at entry: two flushes that overlap both report a score that failed\n // before either of them ended.\n const scoreMark = _failedScoresFlushMark;\n const client = getGlobalClient() as RisicareClient | undefined;\n let spansOk: boolean;\n if (!client) {\n // `shutdown()` clears the global client. Through 0.7.1 this answered `true`\n // even when that shutdown had just abandoned spans. The retained final tally\n // remembers the residue of the last shutdown; `init()` clears it.\n spansOk = (_finalMetrics?.droppedSpansByReason.shutdown_residue ?? 0) === 0;\n } else {\n spansOk = await client.flush(timeoutMs);\n }\n // Pending score requests run in parallel with the span flush. Wait for the\n // remaining scores inside the same deadline.\n const scoresDone = await _waitForPendingScores(deadline - Date.now());\n // The bound ended: the scores that still wait for a slot fail now, with no request.\n if (!scoresDone) _failWaitingScores(SCORE_DEADLINE_REASON);\n _warnHeldScores();\n const failedNow = _failedScores;\n if (failedNow > _failedScoresFlushMark) _failedScoresFlushMark = failedNow;\n return spansOk && scoresDone && failedNow <= scoreMark;\n}\n\n/**\n * Enable tracing at runtime.\n */\nexport function enable(): void {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (client) client.enabled = true;\n}\n\n/**\n * Disable tracing at runtime. Spans will not be created or exported.\n */\nexport function disable(): void {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (client) client.enabled = false;\n}\n\n/**\n * Check whether tracing is currently enabled.\n */\nexport function isEnabled(): boolean {\n const client = getGlobalClient() as RisicareClient | undefined;\n return client?.enabled ?? false;\n}\n\n/**\n * Get the global tracer instance. Returns undefined if not initialized.\n */\nexport function getTracer(): Tracer | undefined {\n return getGlobalTracer() as Tracer | undefined;\n}\n\n/**\n * Get the global tracer, or throw if not initialized.\n * @internal Used by decorators and providers that require an active tracer.\n */\nexport function requireTracer(): Tracer {\n const tracer = getGlobalTracer() as Tracer | undefined;\n if (!tracer) {\n throw new Error(\n 'Risicare SDK not initialized. Call init() before using tracing features.',\n );\n }\n return tracer;\n}\n\n/**\n * Check whether content tracing (prompt/completion capture) is enabled.\n */\nexport function getTraceContent(): boolean {\n const tracer = getGlobalTracer() as Tracer | undefined;\n // Fail-closed, matching the 0.5.1 config default.\n return tracer?.traceContent ?? false;\n}\n\n/**\n * Get SDK metrics: exported spans (accepted by the backend), `rejectedSpans`,\n * dropped spans and their reasons (`unacknowledged` included), failed exports,\n * queue stats, and `failedScores` (`score()` requests that failed since\n * `init()`).\n *\n * `sdkState` — SDK-RELEASE-RULING.md §5 — says WHICH of three different facts\n * the numbers are, because before it all three rendered as the same zeros:\n *\n * - `\"uninitialised\"` nothing was ever queued; the zeros are the truth\n * - `\"running\"` live readings from a live processor\n * - `\"shutdown\"` the RETAINED FINAL TALLY. Not live, and says so.\n *\n * The `\"shutdown\"` case is why this field exists. `shutdown()` clears the global\n * client, so this used to answer `droppedSpans: 0` from a hardcoded literal in\n * the very process that had just discarded spans — a guess presented\n * byte-identical to an authoritative answer, which is the W1/W3 class this\n * codebase already ruled against (`cost_source`, `settled`). The remedy there\n * and here is the same: do not hide the value and do not null it, LABEL it.\n * Every field of a retained tally is still true — the queue really is empty,\n * the capacity really is the configured one, and the drop counts describe the\n * whole life of the process, `shutdown_residue` included.\n *\n * ⚠ What it still CANNOT do: report loss to anything OUTSIDE the dying process.\n * A counter in memory about to be freed has no reader, and a SIGKILL takes this\n * and the WARNING together. The WARNING remains the primary signal.\n */\nexport function getMetrics() {\n const client = getGlobalClient() as RisicareClient | undefined;\n if (client && !client.isShutdown) {\n return {\n ...client.processor.getMetrics(),\n failedScores: _failedScores,\n sdkState: 'running' as const,\n };\n }\n if (_finalMetrics) {\n // Copy: a caller mutating the object must not corrupt the one tally the\n // process has left.\n return {\n ..._finalMetrics,\n failedScores: _failedScores,\n droppedSpansByReason: { ..._finalMetrics.droppedSpansByReason },\n sdkState: 'shutdown' as const,\n };\n }\n return {\n exportedSpans: 0,\n rejectedSpans: 0,\n failedScores: _failedScores,\n droppedSpans: 0,\n droppedSpansByReason: {\n queue_full: 0,\n transport_refused: 0,\n shutdown_residue: 0,\n unacknowledged: 0,\n },\n failedExports: 0,\n queueSize: 0,\n queueCapacity: 0,\n queueUtilization: 0,\n sdkState: 'uninitialised' as const,\n };\n}\n\n// ─── reportError ──────────────────────────────────────────────────────────\n\n// Error dedup: SHA256 fingerprint → timestamp. Prevents retry loops from\n// creating N duplicate diagnoses. Matches Python SDK's 5-minute TTL.\nconst _ERROR_DEDUP_TTL_MS = 5 * 60 * 1000; // 5 minutes\nconst _ERROR_DEDUP_MAX = 1000;\nconst _recentErrors = new Map<string, number>(); // fingerprint → Date.now()\n\nfunction _errorFingerprint(err: Error): string {\n const raw = `${err.constructor?.name ?? 'Error'}:${String(err.message ?? '').slice(0, 200)}`;\n return createHash('sha256').update(raw).digest('hex').slice(0, 16);\n}\n\nfunction _isDuplicateError(fingerprint: string): boolean {\n const now = Date.now();\n // Evict expired entries\n for (const [fp, ts] of _recentErrors) {\n if (now - ts > _ERROR_DEDUP_TTL_MS) _recentErrors.delete(fp);\n else break; // Map iterates in insertion order\n }\n if (_recentErrors.has(fingerprint)) return true;\n // Enforce max size\n if (_recentErrors.size >= _ERROR_DEDUP_MAX) {\n const oldest = _recentErrors.keys().next().value;\n if (oldest !== undefined) _recentErrors.delete(oldest);\n }\n _recentErrors.set(fingerprint, now);\n return false;\n}\n\n/**\n * Report a caught exception to the error diagnosis pipeline.\n *\n * Creates an error span that triggers diagnosis and fix generation.\n * Deduplicates identical errors within a 5-minute window (SHA256 fingerprint).\n * This function never throws and is non-blocking.\n *\n * @param error - The caught exception (Error object or string)\n * @param options - Optional attributes and context overrides\n */\nexport function reportError(\n error: unknown,\n options?: { name?: string; attributes?: Record<string, unknown> },\n): void {\n try {\n const tracer = getTracer();\n if (!tracer) return;\n\n const err = error instanceof Error ? error : new Error(String(error ?? 'unknown'));\n const spanName = options?.name ?? `error:${err.constructor.name}`;\n\n // Dedup: suppress identical errors within TTL (matches Python SDK)\n const fp = _errorFingerprint(err);\n if (_isDuplicateError(fp)) {\n debug(`reportError: duplicate suppressed (fp=${fp.slice(0, 8)})`);\n return;\n }\n\n tracer.startSpan({ name: spanName, kind: SpanKind.INTERNAL }, (span) => {\n span.setStatus(SpanStatus.ERROR, err.message);\n span.setAttribute('error', true);\n span.setAttribute('error.type', err.constructor.name);\n // Limits count code points, so a cut never splits a surrogate pair.\n span.setAttribute('error.message', cutCodePoints(err.message, 2000));\n if (err.stack) span.setAttribute('error.stack', cutCodePoints(err.stack, 4000));\n span.setAttribute('risicare.reported_error', true);\n // F-R-REPORTERRCODE-001. `reportError` is the API our own docs name for\n // feeding the diagnosis pipeline, yet it attached error/type/message and\n // NO taxonomy code, while an uncaught throw through a traced frame did —\n // `tracer.ts::Tracer.startSpan` calls `attachErrorCode` on both of its\n // throw handlers. Measured on the published 0.5.2 against the lab: 4\n // uncaught spans carried TOOL.EXECUTION.CRASHED, the reportError span\n // carried none. Same shape as the Python asymmetry, same remedy — reuse\n // the ONE definition rather than re-classifying here.\n attachErrorCode(span, err);\n if (options?.attributes) {\n for (const [k, v] of Object.entries(options.attributes)) {\n span.setAttribute(k, v);\n }\n }\n });\n } catch {\n // Never crash the host application\n debug('reportError failed');\n }\n}\n\n// ─── score ─────────────────────────────────────────────────────────────────\n\n/**\n * Record a custom evaluation score on a trace.\n *\n * Sends the score in the background. The root `flush()` waits for it.\n * This function never throws and does not block. At most 50 score requests\n * are in flight at once. Up to 1,000 scores wait for a free slot, with no timer;\n * the 2000 ms bound of a score starts when its request starts. A score that\n * comes when 1,000 already wait fails at once and is counted. When a `flush()`\n * or `shutdown()` bound ends, the scores that still wait fail and are not sent.\n *\n * Delivery: the request stops after 2000 ms and never follows a redirect. A\n * status of 300 or more, an error or the timeout is a failure, and it adds 1\n * to `failedScores` in `getMetrics()`. The first failure writes a WARNING with\n * the score name and the status or the error code. Later failures in the next\n * 10 s are counted, and the next WARNING gives their number. Root `flush()`\n * waits for pending scores inside its deadline, and returns `false` when a\n * score failed since the previous `flush()` returned. An out-of-range value, or an empty `traceId`\n * or `name`, writes one WARNING, and the SDK does not send the score. `true`\n * and `false` count as 1 and 0.\n *\n * If a `mask` is configured on `init()`, `options.comment` is passed to it under\n * the key `score.comment` before the request is built. `traceId`, `spanId` and\n * `name` are NOT masked — they are identifiers the platform joins and groups on.\n *\n * @param traceId - The trace to score\n * @param name - Score name (e.g., \"accuracy\", \"user_satisfaction\")\n * @param value - Score value between 0.0 and 1.0 inclusive\n * @param options - Optional span_id and comment\n */\nexport function score(\n traceId: string,\n name: string,\n value: number,\n options?: { spanId?: string; comment?: string },\n): void {\n try {\n // WARNING, as in the Python SDK. Through 0.7.1 these were debug lines, so\n // a rejected score was invisible without `debug: true`. The WARNING prints\n // the value only when it is a number: a string could forge a log line, and\n // an object's `toString()` could run. A boolean is a number here (true is\n // 1, false is 0), as in the Python SDK.\n const raw: unknown = value;\n if (typeof raw === 'boolean') value = raw ? 1 : 0;\n if (typeof value !== 'number') {\n warn(`score: the value must be a number, not ${typeof raw}. The SDK does not send this score.`);\n return;\n }\n if (!Number.isFinite(value) || value < 0.0 || value > 1.0) {\n warn(`score: the value must be in [0.0, 1.0], not ${value}. The SDK does not send this score.`);\n return;\n }\n if (typeof traceId !== 'string' || given(traceId) === undefined) {\n warn('score: traceId must be a non-empty string. The SDK does not send this score.');\n return;\n }\n if (typeof name !== 'string' || given(name) === undefined) {\n warn('score: name must be a non-empty string. The SDK does not send this score.');\n return;\n }\n\n const client = getGlobalClient() as RisicareClient | undefined;\n if (!client?.enabled || !client.config.apiKey) return;\n\n // ⚠ FIELD CHANGED 0.6.0 -> 0.7.0: this read `config.endpoint`, the SPAN\n // endpoint, and then composed an API path. That worked only while one\n // Caddy-fronted host served both services. It now reads `apiEndpoint`.\n // The order that sets it is in `config.ts`, `resolveEndpoints`. The\n // default ingest host never names an api host.\n // The `/api` prefix is gone with the proxy that stripped it.\n const endpoint = client.config.apiEndpoint.replace(/\\/+$/, '');\n const url = `${endpoint}/v1/scores`;\n\n // ⚠ THE ONE NON-SPAN EGRESS THE MASK COVERS (F-SDKMASKSCORE-001).\n // This POST does not go through BatchSpanProcessor, so `applyMask` never\n // sees it — `comment` is free customer text on our wire and was uncovered\n // until this call. The ruling (why the same hook rather than a second one,\n // why `name` is deliberately NOT masked, and the caller-thread cost) is in\n // `risicare/masking.py`, \"THE NON-SPAN SURFACE\".\n //\n // Runs BEFORE `JSON.stringify`, so the unmasked value is never serialized.\n // `maskText` is the same primitive `statusMessage` uses, so a throwing mask\n // yields the same marker and the score is still sent.\n let comment = options?.comment;\n if (comment !== undefined && client.config.mask) {\n comment = maskText(client.config.mask, SCORE_COMMENT_KEY, comment);\n }\n\n const body = JSON.stringify({\n trace_id: traceId,\n name,\n score: value,\n source: 'sdk',\n ...(options?.spanId && { span_id: options.spanId }),\n ...(comment && { comment }),\n });\n\n // The caller does not wait. The score is pending until its request settles,\n // or until it fails while it waits for a slot; root `flush()` waits for it.\n if (_scoresInFlight >= SCORE_MAX_IN_FLIGHT && _scoreWaiters.length >= SCORE_MAX_WAITING) {\n _scoreFailed(name, SCORE_CAP_REASON);\n return;\n }\n let settle!: () => void;\n const request = new Promise<void>((resolve) => (settle = resolve));\n const send = async (): Promise<void> => {\n // The 2000 ms bound starts here, when the request starts.\n const controller = new AbortController();\n const timer = setTimeout(() => controller.abort(), SCORE_TIMEOUT_MS);\n try {\n const response = await fetch(url, {\n method: 'POST',\n headers: {\n 'Content-Type': 'application/json',\n 'Authorization': `Bearer ${client.config.apiKey}`,\n // F-SDKVER-001 — see the Python twin. `score()` reaches the FastAPI\n // server under /v1/, which `main.py::audit_logging_middleware` audits\n // into `audit_logs.user_agent`; ingest reaches the Rust gateway, which\n // discards it. This is the one client-identity visible with no gateway\n // change.\n 'User-Agent': `risicare-js/${SDK_VERSION} node/${process.version}`,\n 'X-Risicare-SDK-Version': SDK_VERSION,\n },\n body,\n // Never follow: a redirect is a misroute, not a route. Through 0.7.1\n // fetch followed a 307 and re-POSTed the score to the login page.\n redirect: 'manual',\n signal: controller.signal,\n });\n if (response.type === 'opaqueredirect' || response.status >= 300) {\n _scoreFailed(name, `HTTP ${response.status || '3xx'}`);\n }\n try {\n await response.body?.cancel();\n } catch {\n // The body is not needed.\n }\n } catch (err) {\n // The cause code tells a refused port, a DNS failure and a reset apart\n // (fetch wraps each of them in the same TypeError).\n const cause = err instanceof Error ? (err as Error & { cause?: { code?: unknown } }).cause : undefined;\n const code = typeof cause?.code === 'string' ? cause.code : undefined;\n const reason = controller.signal.aborted\n ? `no answer within ${SCORE_TIMEOUT_MS} ms`\n : code ?? (err instanceof Error ? err.name : 'Error');\n _scoreFailed(name, reason);\n } finally {\n clearTimeout(timer);\n _scoresInFlight--;\n settle();\n _startWaitingScores();\n }\n };\n const start = (): void => {\n _scoresInFlight++;\n void send();\n };\n if (_scoresInFlight < SCORE_MAX_IN_FLIGHT) {\n start();\n } else {\n _scoreWaiters.push({\n start,\n fail: (reason) => {\n _scoreFailed(name, reason);\n settle();\n },\n });\n }\n _pendingScores.add(request);\n void request.finally(() => _pendingScores.delete(request));\n } catch {\n // Never crash the host application\n debug('score failed');\n }\n}\n","/**\n * Shared state via globalThis — ensures all entry point bundles share\n * the same singleton instances.\n *\n * Problem: tsup with `splitting: false` gives each entry point (index,\n * openai, anthropic, vercel-ai) its own copy of module-level variables.\n * This means `init()` from 'risicare' sets a tracer that 'risicare/openai'\n * can't see — breaking all provider instrumentation silently.\n *\n * Solution: Store all mutable singletons on globalThis with a namespaced\n * prefix. Every bundle reads/writes the same global slots.\n *\n * This pattern is used by React, OpenTelemetry, and other SDKs that must\n * share state across independently bundled entry points.\n *\n * @internal\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst G = globalThis as any;\nconst PREFIX = '__risicare_';\n\n// ─── Client & Tracer ────────────────────────────────────────────────────────\n\nexport function getClient(): unknown {\n return G[PREFIX + 'client'];\n}\n\nexport function setClient(client: unknown): void {\n G[PREFIX + 'client'] = client;\n}\n\nexport function getTracer(): unknown {\n return G[PREFIX + 'tracer'];\n}\n\nexport function setTracer(tracer: unknown): void {\n G[PREFIX + 'tracer'] = tracer;\n}\n\n// ─── Context Storage ────────────────────────────────────────────────────────\n\nexport function getContextStorage(): AsyncLocalStorage<unknown> {\n if (!G[PREFIX + 'ctx']) {\n G[PREFIX + 'ctx'] = new AsyncLocalStorage();\n }\n return G[PREFIX + 'ctx'];\n}\n\n// ─── Span Registry ──────────────────────────────────────────────────────────\n\nexport function getRegistry(): Map<string, unknown> {\n if (!G[PREFIX + 'registry']) {\n G[PREFIX + 'registry'] = new Map();\n }\n return G[PREFIX + 'registry'];\n}\n\nexport function getOpCount(): number {\n return G[PREFIX + 'opcount'] ?? 0;\n}\n\nexport function setOpCount(n: number): void {\n G[PREFIX + 'opcount'] = n;\n}\n\n// ─── Debug Flag ─────────────────────────────────────────────────────────────\n\nexport function getDebug(): boolean {\n return G[PREFIX + 'debug'] ?? false;\n}\n\nexport function setDebugFlag(enabled: boolean): void {\n G[PREFIX + 'debug'] = enabled;\n}\n\n// ─── Fix Runtime ────────────────────────────────────────────────────────\n\nexport function getGlobalFixRuntime(): unknown {\n return G[PREFIX + 'fix_runtime'];\n}\n\nexport function setGlobalFixRuntime(runtime: unknown): void {\n G[PREFIX + 'fix_runtime'] = runtime;\n}\n\n// ─── Open provider spans (utils/stream-proxy.ts) ────────────────────────────\n\n/** An observed provider span that is not ended yet. */\nexport interface OpenProviderSpan {\n end(reason: 'shutdown'): void;\n release(): void;\n}\n\nexport interface ProviderSpanState {\n /** The shape of this object. Change it when the shape or a method of OpenProviderSpan changes. */\n version: 1;\n /** Every observed provider span that is still open: `shutdown()` ends them. */\n open: Set<OpenProviderSpan>;\n /** Ends a span when nobody can reach its promise, stream or iterators. */\n registry: FinalizationRegistry<OpenProviderSpan> | undefined;\n}\n\nconst PROVIDER_SPANS = Symbol.for('risicare.providerSpans');\n\n/** True when `s` is a version-1 state that this copy of the SDK can use. */\nfunction usableProviderSpanState(s: unknown): s is ProviderSpanState {\n if (!s || typeof s !== 'object') return false;\n const { version, open, registry } = s as Record<string, unknown>;\n const o = open as Record<PropertyKey, unknown> | undefined;\n return (\n version === 1 &&\n !!o &&\n typeof o.add === 'function' &&\n typeof o.delete === 'function' &&\n typeof o[Symbol.iterator] === 'function' &&\n (registry === undefined || typeof (registry as { register?: unknown }).register === 'function')\n );\n}\n\n/**\n * ONE set and ONE registry for every bundle. Each provider entry point bundles\n * its own copy of stream-proxy.ts (`splitting: false`), and `shutdown()` in the\n * main bundle must see the spans that `risicare/openai` opened.\n *\n * Two installed copies of the SDK share this state too. A copy uses it only\n * when it is version 1 and its shape checks pass; else this function throws,\n * and the caller of this function (stream-proxy.ts) does not observe the call.\n * It never replaces a state that another copy made.\n */\nexport function getProviderSpanState(): ProviderSpanState {\n const found: unknown = G[PROVIDER_SPANS];\n if (found === undefined) {\n const s: ProviderSpanState = {\n version: 1,\n open: new Set(),\n registry:\n typeof FinalizationRegistry === 'function'\n ? new FinalizationRegistry<OpenProviderSpan>((o) => o.release())\n : undefined,\n };\n G[PROVIDER_SPANS] = s;\n return s;\n }\n if (!usableProviderSpanState(found)) {\n throw new TypeError('the shared provider span state is not version 1');\n }\n return found;\n}\n","/**\n * Internal logger for the Risicare SDK.\n *\n * Centralizes all diagnostic output so that:\n * - Debug messages are gated by a single flag (zero-cost when disabled)\n * - Warnings always fire (operational alerts like queue full)\n * - All output goes to stderr with a consistent [risicare] prefix\n * - A future custom logger callback can be added in one place\n */\n\nimport { getDebug, setDebugFlag } from '../globals.js';\n\n/**\n * Enable or disable debug logging. Called once during init().\n * @internal\n */\nexport function setDebug(enabled: boolean): void {\n setDebugFlag(enabled);\n}\n\n/**\n * Log a debug message. Only outputs when debug mode is enabled.\n * @internal\n */\nexport function debug(msg: string): void {\n if (getDebug()) {\n process.stderr.write(`[risicare] ${msg}\\n`);\n }\n}\n\n/**\n * Log a warning. Always outputs regardless of debug mode.\n * Use sparingly — only for operational issues the user should see.\n * @internal\n */\nexport function warn(msg: string): void {\n process.stderr.write(`[risicare] WARNING: ${msg}\\n`);\n}\n","/**\n * Text helpers for strings that go on the wire.\n *\n * @internal Not public API.\n */\n\n/**\n * The first `max` CODE POINTS of `text`, as Python's `text[:max]` gives.\n *\n * Not `text.slice(0, max)`: that counts UTF-16 code units and can keep the\n * first half of a surrogate pair. JSON.stringify writes a lone half as\n * `\\ud83d`, and a strict JSON parser refuses the whole request body, so the\n * whole batch is lost. The walk stops at `max` code points, so a very long\n * text costs no more than the part that is kept.\n */\nexport function cutCodePoints(text: string, max: number): string {\n // A text of at most `max` code units has at most `max` code points.\n if (text.length <= max) return text;\n let units = 0;\n for (let points = 0; points < max && units < text.length; points++) {\n units += (text.codePointAt(units) as number) > 0xffff ? 2 : 1;\n }\n return text.slice(0, units);\n}\n","/**\n * Text that is safe to put in a log line: THE one scrub function of the SDK.\n * Python twin: `risicare/_error_text.py` (`scrub_text`, `safe_url`).\n *\n * Every text that comes from the network (a header, a body, a redirect target) or\n * from an error, and that goes into a log line of the exporters, the fix loader or\n * `score()`, goes through `scrubText`. It:\n * 1. removes each key it is given, and `RISICARE_API_KEY`, in any case of letters\n * (a literal match: a key with regex metacharacters is not read as a pattern);\n * 2. also finds a key that is percent-encoded: when the URL-decoded copy of the\n * text holds a key, the DECODED text is printed, with the key removed;\n * 3. makes the text one line (each control character becomes a space);\n * 4. cuts the text at `limit` code points (default 200).\n *\n * @internal Not public API.\n */\nimport { cutCodePoints } from './text.js';\n\nexport const KEY_MARKER = '[REDACTED-KEY]';\n\nconst CONTROL = new RegExp('[\\\\u0000-\\\\u001f\\\\u007f-\\\\u009f\\\\u2028\\\\u2029]', 'g');\n\nfunction escapeRegExp(text: string): string {\n return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/** Decode %XX sequences. A sequence that is not valid UTF-8 is decoded byte by byte. */\nfunction percentDecode(text: string): string {\n try {\n return decodeURIComponent(text);\n } catch {\n return text.replace(/%([0-9A-Fa-f]{2})/g, (_m, hex: string) => String.fromCharCode(parseInt(hex, 16)));\n }\n}\n\nfunction keyPattern(keys: ReadonlyArray<string | undefined | null>): RegExp | null {\n const values = new Set<string>();\n for (const k of [...keys, process.env.RISICARE_API_KEY]) if (k) values.add(k);\n if (values.size === 0) return null;\n // The longest value first, so that a key that contains another key is removed whole.\n const ordered = [...values].sort((a, b) => b.length - a.length);\n return new RegExp(ordered.map(escapeRegExp).join('|'), 'gi');\n}\n\n/** `text` as one line, with every given key removed, at most `limit` code points. */\nexport function scrubText(text: unknown, keys: ReadonlyArray<string | undefined | null>, limit = 200): string {\n let out: string;\n try {\n out = text instanceof Error ? `${text.name}: ${text.message}` : String(text);\n } catch {\n out = typeof text;\n }\n const pattern = keyPattern(keys);\n if (pattern !== null) {\n if (out.includes('%')) {\n const decoded = percentDecode(out);\n pattern.lastIndex = 0;\n if (decoded !== out && pattern.test(decoded)) out = decoded;\n }\n pattern.lastIndex = 0;\n out = out.replace(pattern, KEY_MARKER);\n }\n return cutCodePoints(out.replace(CONTROL, ' '), limit);\n}\n\n/**\n * `url` without userinfo, query and fragment: scheme, host, port and path only. The SDK\n * prints an endpoint in WARNING and debug lines; a secret in its userinfo\n * (`http://user:secret@host`) or its query (`?k=secret`) must not reach the log.\n */\nexport function safeUrl(url: string): string {\n try {\n const u = new URL(url);\n const path = u.pathname === '/' && !/^[a-z][a-z0-9+.-]*:\\/\\/[^/?#]*\\//i.test(url) ? '' : u.pathname;\n return `${u.protocol}//${u.host}${path}`;\n } catch {\n return url.split('?')[0].split('#')[0].replace(/\\/\\/[^/@]*@/, '//');\n }\n}\n\n/** True when `url` holds userinfo (`user:password@host`). `fetch` refuses such a URL. */\nexport function hasCredentials(url: string): boolean {\n try {\n const u = new URL(url);\n return u.username !== '' || u.password !== '';\n } catch {\n return false;\n }\n}\n","/**\n * Customer-supplied masking of span content, applied before anything leaves the process.\n *\n * The full rationale — why this is the ONLY layer rather than defence in depth,\n * why the hook carries the key, what is deliberately not masked, and the\n * fail-closed-per-field ruling — is written once, in the Python twin:\n * `packages/risicare-sdk/src/risicare/masking.py`. This file mirrors it. Where\n * the two languages diverge, the divergence is called out inline below; do not\n * \"align\" them without reading both.\n *\n * ── Mirrored from Python ─────────────────────────────────────────────────────\n * • signature `mask(key, value) => value` — the key is REQUIRED, because our\n * span model has no input/output fields: the prompt and the model name are\n * both plain entries of `span.attributes`, so a keyless hook cannot tell\n * them apart and `() => '***'` would erase every dashboard label.\n * • masked: every attribute value, `statusMessage`, every event-attribute\n * value, every link-attribute value — plus `score.comment`, the one key\n * that is NOT a span field (see {@link SCORE_COMMENT_KEY}).\n * • NOT masked: traceId / spanId / parentSpanId, `span.name`, `event.name`,\n * and the typed identity + llm columns (agentId, agentName, agentType,\n * sessionId, toolName, llmModel, …). Masking an identifier breaks the\n * customer's own joins — the F-39C lesson. The OTel-style attribute forms\n * (`agent.name`, `session.user_id`) live in `attributes` and ARE masked.\n * • no type narrowing: the hook sees numbers and booleans too. A card number\n * is representable as a number, and deciding otherwise on the customer's\n * behalf is the quiet narrowing this codebase keeps paying for.\n * • fail closed per FIELD: a throwing hook yields `MASK_ERROR_MARKER` for\n * that field and the span is exported intact. Never drop the span — the\n * SDK is the last place the data exists, so a drop here is permanent loss,\n * and it additionally orphans the span's children for zero extra safety.\n * • idempotent: `_exportBatch` can re-queue a refused batch, and a user\n * callback cannot be assumed idempotent, so a masked span is flagged.\n *\n * ── Where JS DIFFERS from Python, and it matters ─────────────────────────────\n * 1. There is no `exceptions[]` on the JS Span — `toPayload()` emits none — so\n * there are no `exceptions.{i}.*` keys here. A port that adds exceptions to\n * the JS span must add them here in the same change.\n * 2. ⚠ THE HOT-PATH COST IS STRICTLY WORSE THAN PYTHON'S. Python runs the mask\n * on a background worker THREAD, so a slow mask costs only drain rate. Node\n * has one thread: `_exportBatch` is `async`, but the mask itself is sync, so\n * while it runs NOTHING else in the customer's process runs — not their\n * request handlers, not their timers. In Python a slow mask degrades\n * throughput; in JS it degrades the whole application. The budget warning\n * below is not advisory decoration here.\n * 3. `_masked` is a real private field on `Span` (we own that class), rather\n * than Python's `setattr` — which Python needs only because its `Span`\n * lives in the separate `risicare-core` package.\n */\n\nimport { warn, debug } from './utils/log.js';\nimport type { Span } from './span.js';\n\n/**\n * A customer mask callback.\n *\n * @param key Fully-qualified path of the value: an attribute key as-is\n * (`\"gen_ai.prompt.0.content\"`), or a dotted path\n * (`\"statusMessage\"`, `\"events.0.attributes.foo\"`,\n * `\"links.0.attributes.bar\"`).\n * @param value The current value — any type, not just string.\n * @returns The replacement, or `value` unchanged.\n */\nexport type MaskFn = (key: string, value: unknown) => unknown;\n\n/** Called with `(key, error)` for every field whose mask threw. */\nexport type MaskErrorReporter = (key: string, error: unknown) => void;\n\n/**\n * Substituted for a value whose mask threw. Fixed, deliberately not\n * valid-looking, and greppable in a dashboard.\n */\nexport const MASK_ERROR_MARKER = '<risicare:mask-error>';\n\n/**\n * The masking hot-path budget, in ms per span. MEASURED and NAMED, never\n * ENFORCED — see the Python twin. A \"disable the mask because it is slow\" rule\n * would fail OPEN on a security control, silently, which is the worst outcome\n * available; so exceeding this warns and nothing else.\n *\n * 1 ms/span leaves a 500-span batch at 500 ms, under the 1,000 ms default\n * `batchTimeoutMs` — the last point at which one batch's masking still fits\n * inside one batch's period. Past that the queue provably grows, and in Node\n * the event loop is blocked for the excess.\n */\nexport const MASK_BUDGET_MS_PER_SPAN = 1.0;\n\n/** Rate-limit window for both mask warnings, in ms. */\nexport const MASK_WARN_WINDOW_MS = 300_000;\n\n/**\n * The key the hook receives for `score(traceId, name, value, { comment })`.\n *\n * ⚠ THE ONE KEY THAT IS NOT A SPAN FIELD. `score()` POSTs direct to\n * `/api/v1/scores` (`client.ts`), outside `BatchSpanProcessor` and therefore\n * outside {@link applyMask} — so its free-text `comment` was uncovered until\n * F-SDKMASKSCORE-001. The full ruling (why the same hook rather than a second\n * one, why the score's `name` is deliberately NOT masked, and why the cost lands\n * on the caller here rather than on the exporter) is written once in the Python\n * twin: `risicare/masking.py`, \"THE NON-SPAN SURFACE\".\n *\n * A constant, not a literal at the call site, so the two SDKs cannot drift and a\n * customer's `if (key === ...)` has something importable to compare against.\n */\nexport const SCORE_COMMENT_KEY = 'score.comment';\n\n/**\n * Mask ONE free-text value that reaches the wire raw, and coerce the result.\n *\n * The exported form of the same primitive {@link applyMask} uses for\n * `statusMessage`. It exists so a non-span egress (today: `score(comment)`) gets\n * byte-identical semantics to a span field — same marker, same\n * fail-closed-per-field rule, same coercion — rather than a second\n * implementation that drifts from this one.\n *\n * Never throws.\n */\nexport function maskText(\n mask: MaskFn,\n key: string,\n value: unknown,\n onError?: MaskErrorReporter,\n): string {\n return maskString(mask, key, value, onError);\n}\n\n/** Apply `mask` to one value. Never throws; fails closed to the marker. */\nfunction maskOne(\n mask: MaskFn,\n key: string,\n value: unknown,\n onError: MaskErrorReporter | undefined,\n): unknown {\n try {\n return mask(key, value);\n } catch (e) {\n onError?.(key, e);\n return MASK_ERROR_MARKER;\n }\n}\n\n/**\n * Apply `mask` to a field that reaches the wire as a raw JSON string, and\n * coerce the result.\n *\n * `HttpExporter` serializes the WHOLE batch in one `JSON.stringify`\n * (`exporters/http.ts:119`). Unlike Python's `json.dumps`, `JSON.stringify`\n * does not throw on most objects — but it DOES throw on a circular reference\n * or a BigInt, and it silently emits `null` for a function or `undefined`,\n * which would erase the field without saying so. Coercing here keeps one bad\n * return value from one field from taking out every other span in the batch.\n */\nfunction maskString(\n mask: MaskFn,\n key: string,\n value: unknown,\n onError: MaskErrorReporter | undefined,\n): string {\n const masked = maskOne(mask, key, value, onError);\n if (typeof masked === 'string') return masked;\n try {\n return String(masked);\n } catch (e) {\n // A `Symbol`, or an object with a hostile `toString`.\n onError?.(key, e);\n return MASK_ERROR_MARKER;\n }\n}\n\n/** Mask every value of an attribute record IN PLACE. */\nfunction maskAttributes(\n mask: MaskFn,\n prefix: string,\n attrs: Record<string, unknown>,\n onError: MaskErrorReporter | undefined,\n): void {\n // Snapshot the keys: the hook is customer code and must not be able to make\n // us iterate a record it is concurrently reshaping.\n for (const k of Object.keys(attrs)) {\n attrs[k] = maskOne(mask, prefix + k, attrs[k], onError);\n }\n}\n\n/** Whether `applyMask` has already run over this span. */\nexport function isMasked(span: Span): boolean {\n return (span as unknown as { _risicareMasked?: boolean })._risicareMasked === true;\n}\n\nfunction markMasked(span: Span): void {\n try {\n (span as unknown as { _risicareMasked?: boolean })._risicareMasked = true;\n } catch {\n // Only reachable for a frozen/sealed stand-in. Degrade to \"may be masked\n // again on re-queue\", never to a throw inside the export path.\n debug('Could not mark span as masked; a re-queue may re-mask it');\n }\n}\n\n/**\n * Mask every content-bearing field of `span`, in place, exactly once.\n *\n * Never throws. A field whose mask throws is replaced with\n * {@link MASK_ERROR_MARKER}; the span is always preserved.\n */\nexport function applyMask(span: Span, mask: MaskFn, onError?: MaskErrorReporter): void {\n if (isMasked(span)) return;\n\n // ── attributes ─────────────────────────────────────────────────────────────\n if (span.attributes && typeof span.attributes === 'object') {\n maskAttributes(mask, '', span.attributes, onError);\n }\n\n // ── status message ─────────────────────────────────────────────────────────\n if (span.statusMessage !== undefined) {\n span.statusMessage = maskString(mask, 'statusMessage', span.statusMessage, onError);\n }\n\n // ── events ─────────────────────────────────────────────────────────────────\n // `event.name` is NOT masked — it is the timeline's grouping key, same\n // argument as `span.name`.\n if (Array.isArray(span.events)) {\n span.events.forEach((event, i) => {\n if (event?.attributes && typeof event.attributes === 'object') {\n maskAttributes(mask, `events.${i}.attributes.`, event.attributes, onError);\n }\n });\n }\n\n // ── links ──────────────────────────────────────────────────────────────────\n // `traceId` / `spanId` on a link are structural: masking them severs the\n // link, which is the one thing a link is for.\n if (Array.isArray(span.links)) {\n span.links.forEach((link, i) => {\n if (link?.attributes && typeof link.attributes === 'object') {\n maskAttributes(mask, `links.${i}.attributes.`, link.attributes, onError);\n }\n });\n }\n\n markMasked(span);\n}\n\n// ── content capture gate (traceContent) ───────────────────────────────────────\n//\n// ⚠ THIS IS A CAPTURE SWITCH, NOT A REDACTION FEATURE. `mask` above stays the\n// only pre-export redaction hook; nothing here inspects a VALUE. The gate is a\n// pure KEY-SHAPE filter, and it lives in this module because this module already\n// owns the one walk both content paths cross.\n//\n// The Python twin is `risicare/masking.py::strip_content` and the two are kept\n// character-for-character equivalent in RULE — same exact sets, same segment and\n// suffix rules, same marker, same walk. Four divergences of exactly this shape have been\n// measured in this campaign (`debug` gated differently; `deleted_at IS NULL` in\n// the gateway only; three Redis cache-clear sites; `reportError` dead in ESM\n// only), so a one-sided fix here would become the fifth.\n//\n// Before 0.5.1 `traceContent` was carried by the Tracer (`tracer.ts`) behind a\n// getter and consulted ONLY by the provider patches. Measured on the published\n// 0.5.0: `getTraceContent()` returned false and a hand-set\n// `gen_ai.prompt.0.content` still reached the wire byte-for-byte.\n\n// ⚠ THE RULE IS CANONICAL CONTENT-KEY SPEC v1, AND THE GATEWAY MUST MATCH IT (0.7.0).\n// `risicare-ingestion` `content_control.rs` holds a copy, and it is the only gate\n// for OTLP and for the SDKs already published. The rules and the shared corpus\n// `tests/fixtures/content-keys-v2.json` (the same file in both SDKs) are the\n// contract. Through 0.6.0 the rule was the last segment `content`, the suffix\n// `_content` and 2 exact keys, so `input.value`, `output.value`,\n// `gen_ai.input.messages`, `gen_ai.output.messages`, a bare `gen_ai.prompt` and\n// CrewAI's task description passed with traceContent off.\n// ⚠ FAIL CLOSED: E and C also hold third-party content keys (OTel GenAI,\n// OpenInference, OpenLLMetry) that no v1 rule matched at first. A doubtful key is\n// content. The full statement of the rule is in the Python twin, `masking.py`.\n\n/** E — matched EXACTLY. A substring match would eat `*_system_prompt_length`. */\nconst CONTENT_KEYS_EXACT: ReadonlySet<string> = new Set([\n // spec v1\n 'gen_ai.system_prompt', // anthropic, bedrock\n 'gen_ai.prompt.message', // cohere\n 'gen_ai.prompt', // OTel GenAI (deprecated form)\n 'gen_ai.completion',\n 'gen_ai.input.messages', // OTel GenAI\n 'gen_ai.output.messages',\n 'gen_ai.system_instructions',\n 'gen_ai.tool.call.arguments',\n // Corpus v2: the list of tool definitions of a request. The names,\n // descriptions and schemas in it are text that the customer wrote.\n 'gen_ai.tool.definitions',\n 'gen_ai.tool.call.result',\n 'input.value', // OpenInference\n 'output.value',\n 'llm.prompts',\n 'llm.prompt_template.template',\n 'llm.prompt_template.variables',\n 'task_description', // CrewAI\n // ⚠ EXTENSION to spec v1: content keys that the Python SDK's integrations emit\n // and that no v1 rule strips. Kept here too, so the two SDKs agree on the rule.\n 'framework.crewai.task_description',\n 'framework.crewai.agent_goal',\n 'framework.crewai.agent_output',\n 'framework.crewai.result',\n 'framework.autogen.last_message',\n 'framework.autogen.reply',\n 'framework.autogen.response',\n 'framework.openai_agents.input',\n 'framework.openai_agents.output',\n 'framework.dspy.signature',\n 'gen_ai.request.messages',\n 'agent.action.input',\n 'agent.action.log',\n 'agent.finish.output',\n 'tool.input',\n 'tool.output',\n 'retriever.query',\n 'retriever.first_doc',\n // ⚠ FAIL CLOSED: third-party content keys that no other rule strips.\n 'gen_ai.retrieval.query.text', // OTel GenAI\n 'gen_ai.retrieval.documents',\n 'gen_ai.evaluation.explanation',\n 'llm.function_call', // OpenInference\n 'llm.choices',\n 'reranker.query',\n 'audio.transcript',\n 'traceloop.entity.input', // OpenLLMetry\n 'traceloop.entity.output',\n]);\n\n/**\n * C — last segment -> the earlier segments that make it content (empty: always).\n * The last-segment KEEP rule does not override C.\n */\nconst CONTENT_LAST_SEGMENT_IN_CONTEXT: ReadonlyMap<string, ReadonlySet<string>> = new Map([\n ['function_call_arguments_json', new Set<string>()], // OpenInference `message.*`\n ['data', new Set(['message_content'])],\n ['url', new Set(['image'])], // `image.url` can hold base64 data\n ['metadata', new Set(['document', 'documents'])],\n]);\n\n/** S — with a last segment `text` or `arguments`, content when an earlier segment is one of these. */\nconst CONTENT_CONTAINER_SEGMENTS: ReadonlySet<string> = new Set([\n 'message',\n 'messages',\n 'message_content',\n 'contents',\n 'embedding',\n 'embeddings',\n 'document',\n 'documents',\n 'tool_call',\n 'tool_calls',\n 'function',\n]);\n\n/** Never content. Wins over every strip rule. */\nconst CONTENT_KEYS_KEEP_EXACT: ReadonlySet<string> = new Set([\n 'gen_ai.response.content_type',\n 'gen_ai.response.content_blocks',\n 'gen_ai.prompt.parts',\n 'gen_ai.prompt.count',\n 'gen_ai.response.choices',\n 'gen_ai.completion.tool_calls',\n]);\n\n/** Never content by the last segment. Wins over S only, never over E or X. */\nconst KEEP_LAST_SEGMENTS: ReadonlySet<string> = new Set([\n 'role',\n 'name',\n 'id',\n 'type',\n 'count',\n 'index',\n 'model',\n 'finish_reason',\n 'mime_type',\n]);\nconst KEEP_LAST_SUFFIXES = ['_length', '_tokens', '_count'] as const;\n\n/**\n * Replaces a stripped value, rather than deleting the key.\n *\n * Deleting would make \"the customer sent no prompt\" and \"the customer disabled\n * capture\" indistinguishable downstream — the W1/W3 honesty rule: label the\n * absence, never forge it.\n */\nexport const CONTENT_OMITTED_MARKER = '<risicare:content-omitted>';\n\n/**\n * Whether `key` names a customer-content attribute (content-key spec v1).\n * Pure function of the KEY. Never looks at the value.\n *\n * Content when ANY is true — E: an exact key; S: the last segment is `content`,\n * or it is `text` / `arguments` under a container segment; C: a last segment in\n * its context, such as `url` under `image`; X: the key ends in `_content`. Never\n * content: the exact-KEEP list (wins over all), or a last segment such as\n * `role`, `name`, `model`, `*_tokens` (wins over S only).\n */\nexport function isContentKey(key: string): boolean {\n if (CONTENT_KEYS_KEEP_EXACT.has(key)) return false;\n if (CONTENT_KEYS_EXACT.has(key) || key.endsWith('_content')) return true; // E, X\n const segments = key.split('.');\n const last = segments[segments.length - 1];\n const context = CONTENT_LAST_SEGMENT_IN_CONTEXT.get(last);\n if (context && (context.size === 0 || segments.slice(0, -1).some((s) => context.has(s)))) {\n return true; // C — `...message_content.image.image.url`\n }\n if (KEEP_LAST_SEGMENTS.has(last) || KEEP_LAST_SUFFIXES.some((x) => last.endsWith(x))) {\n return false; // `...tool_call.function.name` stays\n }\n if (last === 'content') return true; // S\n if (last === 'text' || last === 'arguments') {\n return segments.slice(0, -1).some((s) => CONTENT_CONTAINER_SEGMENTS.has(s)); // S\n }\n return false;\n}\n\n/** Replace every content-keyed value in `attrs` IN PLACE. Returns the count. */\nfunction stripAttributes(attrs: Record<string, unknown>): number {\n let n = 0;\n for (const k of Object.keys(attrs)) {\n if (isContentKey(k)) {\n attrs[k] = CONTENT_OMITTED_MARKER;\n n++;\n }\n }\n return n;\n}\n\n/**\n * Remove customer prompt/completion content from `span`, in place.\n *\n * Walks the same surfaces as {@link applyMask} — span attributes, event\n * attributes, link attributes — because that is where content lives.\n *\n * `statusMessage` and exception text are deliberately NOT stripped: the\n * error-diagnosis product IS those fields, and this is a content-capture switch,\n * not a redaction feature.\n *\n * Returns the number of fields replaced. Never throws.\n */\nexport function stripContent(span: Span): number {\n let stripped = 0;\n\n if (span.attributes && typeof span.attributes === 'object') {\n stripped += stripAttributes(span.attributes);\n }\n\n if (Array.isArray(span.events)) {\n for (const event of span.events) {\n if (event?.attributes && typeof event.attributes === 'object') {\n stripped += stripAttributes(event.attributes);\n }\n }\n }\n\n if (Array.isArray(span.links)) {\n for (const link of span.links) {\n if (link?.attributes && typeof link.attributes === 'object') {\n stripped += stripAttributes(link.attributes);\n }\n }\n }\n\n return stripped;\n}\n\n/** Strip content from every span in a batch, in place. Never throws. */\nexport function stripContentBatch(spans: Span[]): number {\n let total = 0;\n for (const span of spans) {\n try {\n total += stripContent(span);\n } catch {\n // A span we cannot walk must not take the batch down with it. It is also\n // the one span we could not gate, so say so at debug level.\n debug('Could not strip content from a span');\n }\n }\n return total;\n}\n\n/**\n * Mask a whole batch in place and report what it cost.\n *\n * Returns the field-level error count and the elapsed wall time so the caller\n * (the batch processor) owns the metric and the rate-limited warning — the\n * same split Python uses.\n */\nexport function applyMaskBatch(\n spans: Span[],\n mask: MaskFn,\n onError?: MaskErrorReporter,\n): { errors: number; elapsedMs: number } {\n let errors = 0;\n let firstKey: string | undefined;\n let firstError: unknown;\n\n const report: MaskErrorReporter = (key, error) => {\n errors++;\n if (firstKey === undefined) {\n firstKey = key;\n firstError = error;\n }\n onError?.(key, error);\n };\n\n const started = Date.now();\n for (const span of spans) {\n applyMask(span, mask, report);\n }\n const elapsedMs = Date.now() - started;\n\n if (errors > 0 && firstKey !== undefined) {\n // Attach the first failure to the returned shape via a side channel would\n // be noise; the processor logs from its own rate-limiter, so surface the\n // detail here at debug level for the case where the window suppressed it.\n let detail: string;\n try {\n detail = String(firstError);\n } catch {\n detail = typeof firstError; // a hostile `toString` must not break the export\n }\n debug(`mask threw on ${errors} field(s); first: key=${firstKey} ${detail}`);\n }\n\n return { errors, elapsedMs };\n}\n\n/** Emit the rate-limited \"your mask is throwing\" warning. Exported for reuse. */\nexport function warnMaskErrors(batchErrors: number, totalErrors: number): void {\n warn(\n `the mask callback threw on ${batchErrors} field(s) in this batch ` +\n `(${totalErrors} since start). Those fields were replaced with ` +\n `\"${MASK_ERROR_MARKER}\" and the spans were exported intact — no span was ` +\n `dropped. Fix the callback; until then those fields carry no data.`,\n );\n}\n\n/** Emit the rate-limited \"your mask is slow\" warning. Exported for reuse. */\nexport function warnMaskSlow(spanCount: number, elapsedMs: number): void {\n warn(\n `masking ${spanCount} span(s) took ${elapsedMs} ms ` +\n `(budget ${MASK_BUDGET_MS_PER_SPAN * spanCount} ms, ` +\n `${MASK_BUDGET_MS_PER_SPAN} ms/span). Node is single-threaded: this time is ` +\n `taken from your event loop, so it delays your application as well as the ` +\n `export drain, and a queue that cannot drain drops spans (reason=queue_full). ` +\n `Keep the callback CPU-only: no I/O, no network, no unbounded retries.`,\n );\n}\n","/**\n * Batch span processor.\n *\n * Collects spans and exports them in batches based on:\n * - Batch size threshold (default: 500 spans — SDK-RELEASE-RULING.md §4.3 raised\n * this from 100; see `DEFAULT_BATCH_SIZE` below, which is the one true source)\n * - Time interval (default: 1000ms)\n * - Attribute product (`MAX_ATTRIBUTE_PAIRS_PER_BATCH`) and estimated serialized\n * size (`MAX_BATCH_BYTES`), both mirroring gateway constants\n *\n * Node.js is single-threaded — no locks needed.\n * Timer is unref()'d so it doesn't prevent process exit.\n */\n\nimport type { Span } from '../span.js';\nimport { ExportResult, type AckCounts, type SpanExporter } from './base.js';\nimport { debug, warn } from '../utils/log.js';\nimport { scrubText } from '../utils/scrub.js';\nimport {\n applyMaskBatch,\n stripContentBatch,\n warnMaskErrors,\n warnMaskSlow,\n MASK_BUDGET_MS_PER_SPAN,\n MASK_WARN_WINDOW_MS,\n type MaskFn,\n} from '../masking.js';\n\nexport interface BatchProcessorOptions {\n exporters: SpanExporter[];\n batchSize?: number;\n batchTimeoutMs?: number;\n maxQueueSize?: number;\n debug?: boolean;\n /**\n * Customer masking callback, `mask(key, value) => value`. Applied to every\n * content-bearing field of every span in this processor, once, BEFORE any\n * exporter sees the batch. See `../masking.ts`.\n */\n mask?: MaskFn;\n /**\n * Whether customer prompt/completion content may leave the process.\n * **Defaults to `false`** — the same fail-closed default as `resolveConfig`.\n * When false, every content-keyed attribute is replaced on the export path\n * before any exporter runs. See `../masking.ts` `stripContent`.\n */\n traceContent?: boolean;\n}\n\n/**\n * F-SDKCB-001 §5 (option J) — reason labels for a discarded span.\n *\n * One integer conflating an under-provisioned queue, a dead gateway and a\n * redeploy is the ambiguity W1/W3 was written against: the three causes demand\n * three different operator responses. The server side already landed on this\n * shape as `dropped{stage,reason,project_id}` (F-HONEST-001). Mirrors the\n * Python `DROP_*` constants in `exporters/batch.py`.\n *\n * `unacknowledged`: the backend's ack accounts for fewer spans than the batch\n * sent (after the counts are clamped to the batch size). Those spans are in no\n * other counter, so they are counted here: exported + rejected + dropped then\n * equals the spans that ended.\n */\nexport type DropReason = 'queue_full' | 'transport_refused' | 'shutdown_residue' | 'unacknowledged';\n\n/** Outcome of one `_exportBatch()` round.\n *\n * `shutdown()`'s drain loop must tell \"the queue is empty\" from \"a batch was\n * taken and nobody accepted it\" — RULING §4's no-SUCCESS exit. Without that\n * distinction the loop would spin for the whole budget against a dead\n * transport, and (because the bounded re-queue keeps the queue non-empty)\n * would never terminate at all. */\nconst enum Round {\n Empty = 0,\n Delivered = 1,\n Failed = 2,\n /** an export was already in flight (`_flushing`); this call made no progress */\n Busy = 3,\n}\n\n/** The value `raceDeadline` gives when the deadline comes first. */\nconst DEADLINE = Symbol('deadline');\n\n/**\n * Wait for `p`, but not longer than `ms`. The timer is cleared on both paths, so\n * it never keeps the process alive. `p` is not cancelled: it continues, and the\n * caller decides what its late answer means.\n */\nasync function raceDeadline<T>(p: Promise<T>, ms: number): Promise<T | typeof DEADLINE> {\n let timer: ReturnType<typeof setTimeout> | undefined;\n const deadline = new Promise<typeof DEADLINE>((resolve) => {\n timer = setTimeout(() => resolve(DEADLINE), Math.max(0, ms));\n });\n try {\n return await Promise.race([p, deadline]);\n } finally {\n clearTimeout(timer);\n }\n}\n\n/** Describe a thrown value for a debug line. Never throws (a Symbol, a hostile `toString`). */\nfunction describeThrown(e: unknown): string {\n // An error text can hold a key: scrubbed (`utils/scrub.ts`; the processor does not\n // know the exporter's key, so RISICARE_API_KEY and the forms of it are removed).\n return scrubText(e, []);\n}\n\n/**\n * Wait for an exporter's own `shutdown()`, but not longer than `ms`. A rejection\n * or a synchronous throw is logged at debug level. The timer is cleared.\n */\nasync function shutdownExporter(exporter: SpanExporter, ms: number): Promise<void> {\n try {\n const outcome = await raceDeadline(Promise.resolve().then(() => exporter.shutdown()), ms);\n if (outcome === DEADLINE) debug(`${exporter.name}.shutdown() did not finish within ${ms} ms`);\n } catch (e) {\n debug(`Error shutting down ${exporter.name}: ${describeThrown(e)}`);\n }\n}\n\n/** The batch that an export round has taken off the queue and not yet settled. */\ninterface InFlight {\n /** The batch: the key that the exporter's `abort(spans)` uses. */\n spans: Span[];\n size: number;\n /** Set by `shutdown()` when it stops waiting. A late answer then changes nothing. */\n abandoned: boolean;\n}\n\n/**\n * RULING §4 delegates this number with a derive-and-justify obligation.\n * `shutdown()` runs `exporter.shutdown()` AFTER the drain, so a drain that\n * spends the whole budget starves it.\n *\n * The built-in `HttpExporter.shutdown()` is a literal no-op — native fetch\n * needs no cleanup (`exporters/http.ts:159-161`) — so for the shipped exporter\n * the measured cost is ZERO. The reserve is therefore a policy allowance for a\n * CUSTOMER-supplied exporter, whose `shutdown(): Promise<void> | void`\n * (`exporters/base.ts:16`) we cannot measure. Held at 100 ms to match the\n * Python constant — the two SDKs must end with the same contract, and Python's\n * value is measured (see `_SHUTDOWN_RESERVE_MS` in `exporters/batch.py` and\n * `fix-workstream/perf/sdk_exporter_shutdown_cost_probe.py`). Against the\n * binding 2,000 ms SIGTERM budget this leaves 1,900 ms of drain.\n */\nconst SHUTDOWN_RESERVE_MS = 100;\n\n/**\n * SDK-RELEASE-RULING.md §4.3 — ONE shutdown budget, on every teardown path.\n *\n * 5,000 ms is bounded from ABOVE by something outside our control: the SDK's\n * shutdown runs inside the application's, which runs inside the container's\n * termination grace period. The tightest common default is `docker stop` at\n * 10 s (k8s `terminationGracePeriodSeconds` 30 s; systemd `TimeoutStopSec`\n * 90 s), and taking more than half of the tightest is hostile to the app's own\n * cleanup.\n *\n * ⚠ WHY A LONGER BUDGET IS NEARLY FREE: the drain exits on the FIRST round that\n * does not deliver (`Round.Delivered` check below). A dead transport costs one\n * round, not the budget. It is spent only while the transport is SUCCEEDING.\n *\n * ⚠ `client.ts` DERIVES its signal-handler backstop from this rather than\n * repeating a literal. Before the ruling both were an independent `5000`, so\n * the backstop's `process.exit(1)` raced the drain it exists to protect —\n * killing it at the deadline, with the wrong exit code, before the residue\n * warning could print. Do not re-introduce a second literal.\n *\n * Mirrors `SHUTDOWN_BUDGET_MS` in `client.py`.\n */\nexport const SHUTDOWN_BUDGET_MS = 5000;\n\n/** The largest delay that `setTimeout` accepts (2**31 - 1 ms). A larger one fires at once. */\nconst MAX_TIMEOUT_MS = 2 ** 31 - 1;\n\n/**\n * The budget that `flush(timeoutMs)` and `shutdown(timeoutMs)` use.\n *\n * A value that is not a finite number (`undefined`, `NaN`, `Infinity`, a string,\n * `null`) gives the default, `SHUTDOWN_BUDGET_MS`. A negative value gives 0. A\n * value above 2**31 - 1 gives 2**31 - 1. Through 0.7.1 such values reached\n * `setTimeout` and string concatenation as they were: `flush(Infinity)` and\n * `flush('3000')` returned `false` at once, and `shutdown(NaN)` dropped every\n * span, on a healthy server.\n */\nexport function normalizeTimeoutMs(value: unknown): number {\n if (typeof value !== 'number' || !Number.isFinite(value)) return SHUTDOWN_BUDGET_MS;\n if (value < 0) return 0;\n return Math.min(value, MAX_TIMEOUT_MS);\n}\n\n/**\n * The `transport_refused` warning is rate-limited to the exporter's existing\n * window (`exporters/http.ts`), so a flaky network cannot spam customer logs.\n * The `shutdown_residue` warning is NOT rate-limited (RULING §5): it fires at\n * most once per process lifetime by construction, so a window buys nothing and\n * would suppress the only signal in any process that had already warned about\n * the breaker — exactly the correlated case where the customer most needs it.\n */\nconst REFUSAL_WARN_WINDOW_MS = 300_000;\n\n/**\n * SDK-RELEASE-RULING.md §4.3 — the default batch size, raised 100 -> 500.\n *\n * DERIVED, not picked. `shutdown()`'s drain is strictly serial — one export per\n * round-trip — so the most it can save is\n * ceiling = floor((budget - reserve) / RTT) x batchSize\n * and the requirement is that it drain the SDK's OWN maximum queue\n * (`maxQueueSize` = 10,000, the most it can ever be holding) at the design\n * target RTT = 100 ms:\n * batchSize >= 10,000 x RTT / (5,000 - 100) -> 204 at 100 ms, 510 at 250 ms\n * 500 satisfies it to the 250 ms trans-Pacific tail and sits 1.55x under the\n * ceiling the gateway's attribute-product cap imposes (below).\n *\n * ⚠ NEITHER THIS NOR THE BUDGET IS SUFFICIENT ALONE — measured, ruling §2. At\n * 100 ms RTT: budget alone leaves 51 % lost, batch alone leaves 60 % lost at the\n * tail, both together lose nothing. Do not \"simplify\" one back.\n *\n * Mirrors `DEFAULT_BATCH_SIZE` in `exporters/batch.py` — the two SDKs must end\n * with the same contract.\n */\nexport const DEFAULT_BATCH_SIZE = 500;\n\n/**\n * The gateway refuses a request whose summed attribute count exceeds this\n * (`MAX_ATTRIBUTE_PAIRS_PER_REQUEST`, `handlers/ingest.rs`, F-ACKRSV-001) —\n * WHOLE request, never truncated, and the exporter treats that 4xx as a\n * failure, retries it futilely and finally discards the batch as\n * `transport_refused`. The cap is `sum(span.attributes.length)`, i.e. LINEAR in\n * batch size: at batch B a customer is refused above `24,000 / B` attributes\n * per span — 240 at B=100, but only 48 at B=500.\n *\n * Without this bound, raising the default would silently break every customer\n * between those two densities: accepted today, whole-request-refused tomorrow,\n * with no action on their part. So the batch is bounded on BOTH axes, and the\n * raise becomes strictly no-worse-than-today on the attribute axis.\n *\n * ⚠ COUPLING, DECLARED (ruling §4.5) — AND THE DIRECTIONS ARE NOT SYMMETRIC.\n * ⚠ CORRECTED 2026-07-27 (F-SDKBYTES-001 §4.1). This comment used to read\n * \"Stale in either direction is SAFE — too low means slightly smaller batches,\n * too high means the gateway refuses exactly as it does today.\" The second half\n * is FALSE, and the error mattered because it licenses a unilateral change on\n * the gateway side that this SDK cannot survive:\n *\n * • STALE LOW (SDK constant < gateway cap) — SAFE, unconditionally. The SDK\n * assembles smaller batches than it needed to; every one is accepted.\n * • STALE HIGH (SDK constant > gateway cap) — safe ONLY while the gateway's\n * cap does not DECREASE. If it is lowered, this SDK assembles batches the\n * gateway now refuses: requests that are accepted TODAY begin returning\n * 4xx, the exporter retries each one futilely and discards the whole batch\n * as `transport_refused`. That is a NEW refusal caused by the mismatch —\n * not \"exactly as it does today\".\n *\n * ⇒ RAISING the gateway cap is safe to do unilaterally. LOWERING it is not: the\n * SDK constant must move first and be adopted, and `F-SDKVER-001` records\n * that nothing pins or even observes an SDK version server-side, so \"adopted\"\n * is weeks-to-never rather than a deploy.\n *\n * The gateway remains the enforcer; this only stops OUR DEFAULT from moving a\n * customer across ITS boundary.\n */\nexport const MAX_ATTRIBUTE_PAIRS_PER_BATCH = 24_000;\n\n/**\n * The per-batch SERIALIZED-BYTE bound (F-SDKBYTES-001) — the third axis.\n *\n * `SDK-RELEASE-RULING.md` §4.5 bounded the batch on span COUNT and attribute\n * PRODUCT and explicitly left BYTES open: \"a customer putting a 1 MB string in\n * an attribute can exceed the body limit at *any* batch size, and B=500 makes\n * it 5x more reachable. I did not guard this.\"\n *\n * MEASURED (`perf/sdk_batch_byte_ceiling_probe.py`, raw\n * `perf/sdk-batch-byte-ceiling.json`; its JS cross-check arm compiles\n * `src/span.ts` itself rather than trusting `dist/`):\n *\n * batch=500 crosses max_body_size (10,485,760 B) at 20,971 B/span\n * batch=100 crosses it at 104,857 B/span\n *\n * and the ruling's \"16x headroom\" quoted only the measured FLOOR. Against the\n * measured MAXIMUM realistic span (13,487 B) a 500-span batch is 6,743,500 B —\n * 1.55x headroom, not 16x. The count raise spent most of the byte margin.\n *\n * WITHOUT IT, MEASURED (probe ARM 2): the gateway answers 413, and the exporter\n * does NOT treat 413 as permanent — `http.ts` maps every non-2xx that is not\n * 408/504 to FAILURE and retries it. On a permanently-413 batch: 12 HTTP\n * requests (4 re-queue rounds x 3 exporter attempts), then the ENTIRE batch\n * discarded as `transport_refused`. Counted and warned — but total loss.\n *\n * THE ESTIMATE, AND WHICH WAY IT ERRS. Serialized size is not knowable without\n * serializing, and serializing to measure would double the export cost. So the\n * batch is bounded on an ESTIMATE:\n *\n * string -> 2 + utf8ByteLength(s), the bytes `fetch` will send for\n * the raw characters\n * number/bool/null -> a fixed allowance; containers recurse to depth 4\n * anything else -> a fixed allowance (see `EST_OPAQUE_VALUE_BYTES`)\n *\n * ⚠ ASYMMETRY WITH PYTHON, DELIBERATE. Each SDK estimates against ITS OWN\n * encoder. `JSON.stringify` emits non-ASCII RAW (UTF-8 on the wire);\n * `json.dumps` escapes it to `\\uXXXX`. Measured: a 9,525-char CJK attribute is\n * 28,859 B from JS and ~2x that from Python. Mirroring Python's per-character\n * multiplier here would over-estimate every non-ASCII JS batch by ~4x.\n *\n * ⚠ THE ONE UNDER-ESTIMATE, NAMED: JSON escaping. A `\"` costs 2 bytes and a\n * control character 6; `utf8ByteLength` charges 1 for each. The 20 % margin\n * below is what absorbs it — a batch may be up to ~25 % escape characters BY\n * COUNT before the estimate stops covering the real body. Past that the gateway\n * refuses, exactly as it does today: no new failure mode, the bound is simply\n * not helping. Stated rather than engineered away because counting escapes is a\n * second O(bytes) scan.\n *\n * THE FRACTION: 8 MiB is 80 % of the gateway's 10 MiB default. Below it the\n * measured realistic corpus does not bind at batch 500 (1.24x under this\n * budget); above it, the 20 % is the escape margin.\n *\n * ⚠ COUPLING, DECLARED, with the SAME asymmetry as the attribute cap above:\n * stale LOW is unconditionally safe; stale HIGH is safe only while\n * `max_body_size` does not DECREASE.\n */\nexport const MAX_BATCH_BYTES = 8 * 1024 * 1024; // 8,388,608 B = 80 % of max_body_size\n\nconst SPAN_ENVELOPE_BYTES = 512; // typed camelCase fields; a minimal span is ~250 B\nconst CHILD_ENVELOPE_BYTES = 128; // per event / link, before its strings\nconst SCALAR_BYTES = 24; // widest JSON number repr\nconst LITERAL_BYTES = 5; // \"false\" / \"null\"\nconst EST_MAX_DEPTH = 4;\n/**\n * Charge for a value the ladder cannot walk (a class instance, a Map, anything\n * past `EST_MAX_DEPTH`). ⚠ Unlike Python — whose `_coerce_attribute_value`\n * truncates its `str()` fallback at 4,096 chars, making the same charge there a\n * genuine BOUND — JS has no truncation at all (`F-SDKATTRLEN-001`), so this is\n * an ALLOWANCE and a deeply-nested object can exceed it. The gateway refuses\n * that shape exactly as it does today.\n */\nconst EST_OPAQUE_VALUE_BYTES = 4_096;\n\n/**\n * UTF-8 byte length, without allocating the encoded copy.\n *\n * `Buffer.byteLength` is a single native scan and is what `fetch` will actually\n * put on the wire for the raw characters. The fallback multiplier 3 is a true\n * upper bound on UTF-8 bytes per UTF-16 code unit (a BMP code point is 1 unit\n * and at most 3 bytes; an astral one is 2 units and 4 bytes, i.e. 2 per unit),\n * so a Buffer-less runtime errs HIGH rather than low.\n */\nconst utf8ByteLength: (s: string) => number =\n typeof Buffer !== 'undefined' && typeof Buffer.byteLength === 'function'\n ? (s) => Buffer.byteLength(s, 'utf8')\n : (s) => s.length * 3;\n\nfunction estStringBytes(s: string): number {\n return 2 + utf8ByteLength(s);\n}\n\nfunction estValueBytes(v: unknown, depth = 0): number {\n if (typeof v === 'string') return estStringBytes(v);\n if (v === null || v === undefined || typeof v === 'boolean') return LITERAL_BYTES;\n if (typeof v === 'number' || typeof v === 'bigint') return SCALAR_BYTES;\n if (Array.isArray(v) && depth < EST_MAX_DEPTH) {\n let total = 2 + Math.max(0, v.length - 1);\n for (const item of v) total += estValueBytes(item, depth + 1);\n return total;\n }\n if (\n typeof v === 'object' &&\n depth < EST_MAX_DEPTH &&\n Object.getPrototypeOf(v as object) === Object.prototype\n ) {\n let total = 2;\n for (const [k, val] of Object.entries(v as Record<string, unknown>)) {\n total += estStringBytes(k) + 2 + estValueBytes(val, depth + 1);\n }\n return total;\n }\n return EST_OPAQUE_VALUE_BYTES;\n}\n\nfunction estMappingBytes(m: Record<string, unknown>): number {\n let total = 0;\n for (const [k, v] of Object.entries(m)) total += estStringBytes(k) + 2 + estValueBytes(v);\n return total;\n}\n\n/**\n * Estimated serialized bytes this span contributes to a request body, or the\n * fixed envelope if the object is not span-shaped.\n *\n * ⚠ Defensive in exactly the shape `spanAttrCount` is, and for the same reason:\n * TypeScript types `_queue` as `Span[]`, but nothing stops a JS caller or a test\n * double from queueing something else. Throwing from inside the export path\n * would break export for the whole batch. On any surprise this returns the\n * envelope, which can only make the bound LESS binding — never more, and never\n * a wedge.\n */\nfunction spanBytesEstimate(span: Span): number {\n try {\n const s = span as unknown as Record<string, unknown>;\n let total = SPAN_ENVELOPE_BYTES;\n for (const field of ['name', 'statusMessage'] as const) {\n if (typeof s[field] === 'string') total += estStringBytes(s[field] as string);\n }\n const attrs = s.attributes;\n if (attrs != null && typeof attrs === 'object' && !Array.isArray(attrs)) {\n total += estMappingBytes(attrs as Record<string, unknown>);\n }\n for (const key of ['events', 'links'] as const) {\n const coll = s[key];\n if (!Array.isArray(coll)) continue;\n for (const child of coll) {\n total += CHILD_ENVELOPE_BYTES;\n const ca = (child as Record<string, unknown> | null)?.attributes;\n if (ca != null && typeof ca === 'object' && !Array.isArray(ca)) {\n total += estMappingBytes(ca as Record<string, unknown>);\n }\n }\n }\n return total;\n } catch {\n return SPAN_ENVELOPE_BYTES;\n }\n}\n\n/**\n * Attribute count for the per-batch product bound, or 0 if unknowable.\n *\n * ⚠ Defensive for the same reason the Python `_span_attr_count` is: TypeScript\n * types `_queue` as `Span[]`, but nothing stops a JS caller (or a test double)\n * from queueing an object without `attributes`. Reading `.length` off\n * `undefined` would throw from inside the export path and break export for the\n * whole batch. An object with no countable attributes contributes 0, which can\n * only make the bound less binding, never more.\n */\nfunction spanAttrCount(span: Span): number {\n const attrs = (span as { attributes?: unknown }).attributes;\n if (attrs == null) return 0;\n if (attrs instanceof Map) return attrs.size;\n if (typeof attrs === 'object') return Object.keys(attrs as object).length;\n return 0;\n}\n\nexport class BatchSpanProcessor {\n private readonly _exporters: SpanExporter[];\n private readonly _batchSize: number;\n private readonly _batchTimeoutMs: number;\n private readonly _maxQueueSize: number;\n // ⚠ NO `_debug` FIELD. It existed, was assigned, and was read by NOTHING —\n // `tsc --noEmit` had been RED on this package at HEAD for it (TS6133), which\n // survived because `ci-local.sh` runs this package's vitest and never its\n // typecheck, and `prepublishOnly` runs `build && test` — also no typecheck.\n // Filed F-SDKJSTYPECHECK-001. Debug output here is gated globally by\n // `setDebug()` in `../utils/log.ts`, so a per-processor flag was always\n // redundant; Python's `self._debug` exists because `logging` has no such\n // global switch.\n\n private _queue: Span[] = [];\n private _timer: ReturnType<typeof setInterval> | null = null;\n private _started = false;\n private _flushing = false;\n private _inFlight: InFlight | null = null;\n private _beforeExitHandler: (() => void) | null = null;\n\n // Retry tracking for failed batches (Audit #5)\n private _retryCounts = new Map<string, number>();\n private static readonly MAX_RETRIES = 3;\n\n private _lastRefusalWarnAt = Number.NEGATIVE_INFINITY;\n private _lastUnackWarnAt = Number.NEGATIVE_INFINITY;\n /**\n * The loss total (dropped + rejected) that the last finished `flush()` saw.\n * A flush reports a loss that is new since then, one time.\n */\n private _lossMark = 0;\n\n // ── Masking (see `../masking.ts`) ──────────────────────────────────────────\n private readonly _mask: MaskFn | undefined;\n // ── Content capture gate (see `../masking.ts`) ─────────────────────────────\n // Fail-closed: an unspecified value means \"do not capture\". This is the ONE\n // place the gate runs for BOTH content paths — provider capture AND hand-set\n // attributes — so it must not be conditional on anything a caller might\n // forget to pass. Python twin: `BatchSpanProcessor._trace_content`.\n private readonly _traceContent: boolean;\n private _lastMaskWarnAt = Number.NEGATIVE_INFINITY;\n private _lastSlowMaskWarnAt = Number.NEGATIVE_INFINITY;\n\n // Metrics\n /** DEPRECATED flat total. Retained as the exact SUM of\n * `droppedSpansByReason` so existing readers keep working (RULING §5\n * back-compat — the same deprecate-and-alias shape this codebase used for\n * `complete`->`settled` and `spans_flushed_total`). Prefer the labelled\n * record: one integer cannot tell an under-provisioned queue from a dead\n * gateway from a redeploy. */\n droppedSpans = 0;\n droppedSpansByReason: Record<DropReason, number> = {\n queue_full: 0,\n transport_refused: 0,\n shutdown_residue: 0,\n unacknowledged: 0,\n };\n exportedSpans = 0;\n /**\n * Spans that the backend acknowledged as REJECTED (the ack's `rejected`). They\n * are not stored and are not retried. An exporter without an ack adds nothing.\n */\n rejectedSpans = 0;\n /** Export ATTEMPTS, not a span count. */\n failedExports = 0;\n /**\n * Fields whose mask callback threw and were replaced with\n * `MASK_ERROR_MARKER`. A FIELD count, not a span count — one span can\n * contribute several. Non-zero means those fields carry a marker instead of\n * data: a customer-code bug, not a transport one.\n */\n maskErrors = 0;\n\n constructor(options: BatchProcessorOptions) {\n this._exporters = [...options.exporters];\n\n // batchSize: clamp to [1, 10000] AND warn on out-of-range — silent\n // clamping is a debugging tar pit (CON-257 / P1-3). Mirrors Python.\n const requestedBatchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;\n const clampedBatchSize = Math.max(1, Math.min(requestedBatchSize, 10_000));\n if (clampedBatchSize !== requestedBatchSize) {\n warn(\n `batchSize=${requestedBatchSize} is outside the allowed range [1, 10000]; clamping to ${clampedBatchSize}`,\n );\n }\n this._batchSize = clampedBatchSize;\n\n this._batchTimeoutMs = options.batchTimeoutMs ?? 1000;\n this._maxQueueSize = options.maxQueueSize ?? 10000;\n this._mask = options.mask;\n this._traceContent = options.traceContent ?? false;\n }\n\n start(): void {\n if (this._started) return;\n this._started = true;\n\n // Periodic flush timer — unref so it doesn't keep process alive\n this._timer = setInterval(() => {\n void this._exportBatch();\n }, this._batchTimeoutMs);\n this._timer.unref();\n\n // Flush on process exit (Audit #3: use .once, not .on; await, not void)\n this._beforeExitHandler = () => {\n void this.shutdown();\n };\n process.once('beforeExit', this._beforeExitHandler);\n }\n\n /** Record `count` discarded spans under `reason`.\n *\n * `droppedSpans` is maintained as the exact sum of the labelled counters\n * (RULING §5 back-compat), so the locked pins — which read the flat\n * integer — stay meaningful. */\n private _recordDropped(reason: DropReason, count = 1): void {\n this.droppedSpans += count;\n this.droppedSpansByReason[reason] += count;\n }\n\n /**\n * Run the customer mask over a batch, in place. Never throws.\n *\n * Failure semantics are ruled in `../masking.ts`: a field whose mask throws\n * becomes `MASK_ERROR_MARKER` and the span is kept. The counter is per FIELD;\n * both warnings are rate-limited to one per window so a mask that throws on\n * every span cannot flood the customer's logs — the same shape as the\n * transport-refusal warning above.\n */\n private _applyMask(batch: Span[]): void {\n const mask = this._mask;\n if (mask === undefined) return;\n\n const { errors, elapsedMs } = applyMaskBatch(batch, mask);\n const now = Date.now();\n\n if (errors > 0) {\n this.maskErrors += errors;\n if (now - this._lastMaskWarnAt > MASK_WARN_WINDOW_MS) {\n this._lastMaskWarnAt = now;\n warnMaskErrors(errors, this.maskErrors);\n }\n }\n\n if (\n elapsedMs > MASK_BUDGET_MS_PER_SPAN * batch.length &&\n now - this._lastSlowMaskWarnAt > MASK_WARN_WINDOW_MS\n ) {\n this._lastSlowMaskWarnAt = now;\n warnMaskSlow(batch.length, elapsedMs);\n }\n }\n\n /**\n * Drain what we hold, or name what we could not (F-SDKDRAIN-001).\n *\n * Per RULING §4 (option E, hard-bounded) the drain loops until ONE of: the\n * queue is empty; the deadline expires; or a full round completes with no\n * exporter returning SUCCESS.\n *\n * ⚠ The `_flushing` handling is load-bearing, and `SDKDRAIN_JS_004` exists\n * to catch its absence. `_exportBatch()` returns immediately when an export\n * is already in flight (`:171`), so a loop that merely calls it again makes\n * NO progress and abandons the queue exactly as before — measured at 900 of\n * 1,000. We await a tick instead, the shape `flush()` already models.\n *\n * The deadline is a hard wall-clock bound. Each round is raced against the\n * budget that remains. At the deadline, `shutdown()` stops the round in flight\n * through the exporter's optional `abort()`. That stopped round changes no\n * counter, does not move the circuit breaker and re-queues nothing. Through\n * 0.7.1 the deadline was checked only between rounds, so one round against a\n * silent server (3 attempts x 5 s) held a 5,000 ms shutdown for 15 s.\n *\n * Anything still queued when the loop stops, AND a batch whose export was\n * stopped, is COUNTED as `shutdown_residue` and announced with ONE WARNING\n * that gives both numbers. The server may have received the spans of the\n * stopped export. The warning is the primary signal, not the counter: a\n * counter incremented inside `shutdown()` is written to memory about to be\n * freed and has no reader (RULING §2 / §8.2).\n *\n * Each exporter's own `shutdown()` gets the time that is left of the budget.\n * An exporter that does not finish in that time is not awaited.\n *\n * Limit: the abort does not stop a TLS handshake that stalls. Measured, such a\n * handshake kept the process alive about 10 s after `shutdown()` returned.\n *\n * @param timeoutMs - The budget (default 5000). See `normalizeTimeoutMs` for\n * the values that are not a finite number.\n */\n async shutdown(timeoutMs: number = SHUTDOWN_BUDGET_MS): Promise<void> {\n if (!this._started) return;\n timeoutMs = normalizeTimeoutMs(timeoutMs);\n this._started = false;\n\n if (this._timer) {\n clearInterval(this._timer);\n this._timer = null;\n }\n\n // Remove process listener to prevent leak (Audit #3)\n if (this._beforeExitHandler) {\n process.removeListener('beforeExit', this._beforeExitHandler);\n this._beforeExitHandler = null;\n }\n\n // Halve rather than underflow on a tiny budget: shutdown(200) still gets\n // 100 ms of drain instead of none.\n const reserveMs = Math.min(SHUTDOWN_RESERVE_MS, timeoutMs / 2);\n const shutdownDeadline = Date.now() + timeoutMs;\n const drainDeadline = shutdownDeadline - reserveMs;\n\n while (this._queue.length > 0 || this._flushing) {\n const remaining = drainDeadline - Date.now();\n if (remaining <= 0) break;\n // A hard wall-clock bound: the round is raced against the budget. At the\n // deadline the round in flight is stopped below.\n const outcome = await raceDeadline(this._exportBatch(), remaining);\n if (outcome === DEADLINE) break;\n if (outcome === Round.Busy) {\n // An export is mid-await. Yield rather than spin on a no-op call.\n await new Promise((r) => setTimeout(r, 1));\n continue;\n }\n if (outcome !== Round.Delivered) {\n // Empty -> nothing left, we are done.\n // Failed -> no exporter accepted this round; a further round cannot\n // help and would spin to the deadline on precisely the path\n // where there is nothing to save.\n break;\n }\n }\n\n // Once shutdown() has returned, holding IS abandoning: the timer is\n // cleared, the exit listener is gone, nothing will ever export these.\n //\n // A batch whose export did not finish inside the budget is abandoned too. It\n // is counted HERE, and its late answer changes no counter and re-queues\n // nothing (see `_exportBatch`).\n const queued = this._queue.length;\n const flight = this._inFlight;\n const inFlight = flight !== null && !flight.abandoned ? flight.size : 0;\n if (flight !== null && !flight.abandoned) {\n flight.abandoned = true;\n // Stop the abandoned export, so that its request, retries and backoff do\n // not keep the process alive. Without this, it ran on for up to 3\n // attempts of 5 s after shutdown() returned. An exporter without\n // `abort()` is left alone.\n for (const exporter of this._exporters) {\n try {\n exporter.abort?.(flight.spans);\n } catch (e) {\n debug(`Error aborting ${exporter.name}: ${describeThrown(e)}`);\n }\n }\n }\n const residue = queued + inFlight;\n if (residue > 0) {\n this._queue.length = 0;\n this._recordDropped('shutdown_residue', residue);\n // NOT rate-limited, by ruling. Names the counts AND the reason.\n warn(\n `shutdown() gave up with ${residue} span(s) (reason=shutdown_residue): ` +\n `${queued} still queued and ${inFlight} in an export that shutdown() stopped. ` +\n (inFlight > 0\n ? `The server may have received the ${inFlight} span(s) of the stopped export. `\n : '') +\n `All ${residue} were not confirmed as delivered, and are counted as dropped. ` +\n `The ${timeoutMs} ms shutdown ` +\n `budget expired or the transport stopped accepting. Pass a larger timeout to ` +\n `shutdown(timeoutMs), or raise your container's termination grace period, to lose less.`\n );\n }\n\n // Shutdown exporters, inside the time that is left. An exporter whose own\n // shutdown() is slow or never settles must not hold the process: through\n // 0.7.1 a 4 s exporter shutdown held shutdown(1000) for 4 s.\n for (const exporter of this._exporters) {\n await shutdownExporter(exporter, Math.max(0, shutdownDeadline - Date.now()));\n }\n\n // Clean up retry tracking — retry-map drain site 3 of 3\n this._retryCounts.clear();\n\n debug(\n `BatchSpanProcessor shutdown. Exported: ${this.exportedSpans}, ` +\n `Dropped: ${this.droppedSpans}, Failed: ${this.failedExports}`\n );\n }\n\n onSpanEnd(span: Span): void {\n if (!this._started) return;\n\n // Check queue capacity\n if (this._queue.length >= this._maxQueueSize) {\n this._recordDropped('queue_full');\n if (this.droppedSpans === 1 || this.droppedSpans % 1000 === 0) {\n warn(`Span queue full (${this._maxQueueSize}). ${this.droppedSpans} spans dropped so far.`);\n }\n return;\n }\n\n this._queue.push(span);\n\n // Trigger immediate flush if batch size reached\n if (this._queue.length >= this._batchSize) {\n void this._exportBatch();\n }\n }\n\n /**\n * Flush pending spans.\n *\n * @returns `true` only if everything queued at entry was DELIVERED and no\n * span was lost since the previous flush returned.\n *\n * RULING §6. This used to answer a different question — \"is the queue\n * empty?\" — and those two diverge in exactly one case: when spans left the\n * queue WITHOUT reaching the transport. That case is the entire finding. A\n * customer who calls `flush()` before exit and gets `true` has done\n * everything right; silence lets them discover the problem, a false\n * affirmative forecloses it.\n *\n * A LOSS IS REPORTED BY THE NEXT `flush()`, ONE TIME (design section 0,\n * third revision). Returns `true` only when, at the moment it returns, the\n * queue is empty, no batch is in flight, and no span was discarded or\n * rejected since the previous `flush()` returned (or since start, for the\n * first call). Through 0.7.1 only a loss during the call counted: a script\n * whose spans the batch timer had discarded against a 401 sink got `true`\n * with nothing delivered. A failure that a retry repairs does not make it\n * `false`.\n *\n * Mechanics: the processor keeps a loss mark, the loss total (dropped +\n * rejected) that the last finished flush saw. A flush compares the total\n * with the mark it read at its start, then raises the mark to the total\n * (never lowers it). Two flushes that overlap both answer `false` for one\n * loss. The flush after that answers `true` when nothing new was lost.\n *\n * Returns `false` in these cases:\n * (a) the deadline expires with spans still queued or in flight;\n * (b) a span was discarded since the previous flush returned: queue full,\n * breaker refusal, retry exhaustion, or an ack that did not account\n * for it or a span that could not be serialized (`unacknowledged`);\n * (c) the backend rejected a span since the previous flush returned;\n * (d) it is called after `shutdown()`, and the shutdown residue was not 0.\n *\n * The deadline is a hard wall-clock bound on the WAIT. At the deadline\n * `flush()` returns `false`. Through 0.7.1 the deadline was checked only\n * between rounds.\n *\n * ⚠ `flush()` never stops a request that is already sent. The export round in\n * flight continues and ends by its own rules: its request timeout, its\n * retries, the circuit breaker. A short flush budget therefore costs no retry,\n * moves no breaker and sends nothing twice. Its result still counts.\n *\n * Limit: that round can keep the process alive after `flush()` returns\n * `false`, until its own timeouts end. Measured on a silent server: 22 s. To\n * end a process within a bound, call `await shutdown(timeoutMs)`: it stops\n * the round in flight.\n *\n * ⚠ (b) reads the flat total, so a concurrent `queue_full` drop of a span\n * that arrived during the call also answers `false`. That is the\n * conservative direction on purpose: a false negative costs a caller one\n * more flush, a false positive is the defect being fixed.\n */\n async flush(timeoutMs: number = SHUTDOWN_BUDGET_MS): Promise<boolean> {\n timeoutMs = normalizeTimeoutMs(timeoutMs);\n if (!this._started) {\n // (d) — the `!_started => true` early return was unconditional, so\n // `flush()` after `shutdown()` reported success over abandoned data.\n return this._queue.length === 0 && this.droppedSpansByReason.shutdown_residue === 0;\n }\n\n const deadline = Date.now() + timeoutMs;\n const mark = this._lossMark;\n // Report a loss once: compare with the mark, then raise the mark to the\n // total this flush saw (never lower it). Two flushes that overlap both\n // answer false for one loss.\n const finish = (settled: boolean): boolean => {\n const lost = this.droppedSpans + this.rejectedSpans;\n this._lossMark = Math.max(this._lossMark, lost);\n return settled && lost === mark;\n };\n\n // Wait for in-flight exports to complete AND queue to drain\n while (this._queue.length > 0 || this._flushing) {\n const remaining = deadline - Date.now();\n if (remaining <= 0) return finish(false);\n if (!this._flushing && this._queue.length > 0) {\n // Race the WAIT only. The round continues after the deadline.\n const outcome = await raceDeadline(this._exportBatch(), remaining);\n if (outcome === DEADLINE) return finish(false);\n } else {\n // Wait a tick for the in-flight export to finish\n await new Promise((r) => setTimeout(r, 1));\n }\n }\n\n return finish(true);\n }\n\n getMetrics() {\n return {\n exportedSpans: this.exportedSpans,\n rejectedSpans: this.rejectedSpans,\n droppedSpans: this.droppedSpans,\n droppedSpansByReason: { ...this.droppedSpansByReason },\n failedExports: this.failedExports,\n maskErrors: this.maskErrors,\n queueSize: this._queue.length,\n queueCapacity: this._maxQueueSize,\n queueUtilization: this._queue.length / this._maxQueueSize,\n };\n }\n\n /**\n * Count a delivered batch of `n` spans from the exporter's ack.\n *\n * The ack is not trusted. With r = min(rejected, n), a = min(accepted, n - r)\n * and u = n - a - r: `exportedSpans` rises by a, `rejectedSpans` by r, and the\n * u spans that no ack accounts for are dropped as `unacknowledged`, with one\n * rate-limited WARNING. Without an ack (console, custom exporter), the whole\n * batch counts as exported, as before. Python twin: the same clamp.\n */\n private _countDelivered(n: number, ack: AckCounts | null): void {\n if (ack === null) {\n this.exportedSpans += n;\n return;\n }\n // Pessimistic: a sink that says \"rejected\" is believed before one that says\n // \"accepted\" (design section 0, ack clamp REVISED).\n const rejected = Math.min(ack.rejected, n);\n const accepted = Math.min(ack.accepted, n - rejected);\n const unacknowledged = n - accepted - rejected;\n this.exportedSpans += accepted;\n this.rejectedSpans += rejected;\n if (unacknowledged > 0) {\n this._recordDropped('unacknowledged', unacknowledged);\n const now = Date.now();\n if (now - this._lastUnackWarnAt > REFUSAL_WARN_WINDOW_MS) {\n this._lastUnackWarnAt = now;\n warn(\n `Risicare: the backend's ack accounts for ${accepted + rejected} of ${n} span(s) ` +\n `in this batch. The other ${unacknowledged} are counted as dropped ` +\n `(reason=unacknowledged): they may not be stored. ` +\n `${this.droppedSpansByReason.unacknowledged} span(s) counted this way so far ` +\n `in this process.`,\n );\n }\n }\n }\n\n /** The requests in one export round, when every exporter that delivers states it. */\n private _requestsPerRound(): number | undefined {\n const delivering = this._exporters.filter((e) => e.countsAsDelivery !== false);\n if (delivering.length !== 1) return undefined;\n const n = delivering[0].attemptsPerExport;\n return typeof n === 'number' && Number.isFinite(n) && n > 0 ? n : undefined;\n }\n\n /**\n * One export round.\n *\n * Which results decide delivery: an exporter that only shows spans locally\n * (`countsAsDelivery === false`, the console exporter) decides only when no\n * other kind of exporter is present. Among the exporters that deliver, ANY\n * success counts the batch as delivered, once.\n */\n private async _exportBatch(): Promise<Round> {\n if (this._flushing) return Round.Busy;\n if (this._queue.length === 0) return Round.Empty;\n this._flushing = true;\n let flight: InFlight | null = null;\n\n try {\n // Take up to batchSize spans — AND up to the attribute-product bound, AND\n // up to the serialized-byte bound; whichever binds first\n // (SDK-RELEASE-RULING.md §4.5 + F-SDKBYTES-001). `batchSize` is a CEILING,\n // not a fixed size, on all three axes.\n //\n // Take-at-least-one is unconditional on every axis: a single span that\n // alone exceeded a bound would otherwise be taken by no round ever,\n // wedging the queue permanently. One over-cap span is the gateway's\n // problem to refuse and the retry budget's to count; a wedged queue would\n // be ours forever.\n let take = 0;\n let pairs = 0;\n let nbytes = 0;\n const limit = Math.min(this._batchSize, this._queue.length);\n while (take < limit) {\n const head = this._queue[take];\n const spanPairs = spanAttrCount(head);\n const spanBytes = spanBytesEstimate(head);\n if (\n take > 0 &&\n (pairs + spanPairs > MAX_ATTRIBUTE_PAIRS_PER_BATCH ||\n nbytes + spanBytes > MAX_BATCH_BYTES)\n ) {\n break;\n }\n pairs += spanPairs;\n nbytes += spanBytes;\n take++;\n }\n const batch = this._queue.splice(0, take);\n if (batch.length === 0) return Round.Empty;\n flight = { spans: batch, size: batch.length, abandoned: false };\n this._inFlight = flight;\n\n // ⚠ MASK HERE — after the batch is off the queue, before any exporter.\n //\n // WHY NOT in `onSpanEnd()`: that runs on the call that ended the span,\n // i.e. inside the customer's own request path. This site is at least on\n // the export turn.\n //\n // ⚠ AND WHY THAT IS A WEAKER GUARANTEE THAN PYTHON'S: Node has one\n // thread. Python's mask runs on a background worker and costs only drain\n // rate; this one blocks the event loop for its duration. The budget\n // warning below is the whole of the protection, and it is a warning.\n //\n // ⚠ DECLARED RIPPLE, same as Python: the attribute-product and byte\n // bounds above are computed on PRE-mask values. Redaction shrinks, so the\n // estimate stays conservative for every realistic mask; a mask that GROWS\n // content can push the real body past the estimate, which the estimate\n // already declares for ASCII escaping and already answers the same way —\n // the gateway remains the enforcer.\n // ⚠ STRIP BEFORE MASK, and unconditionally when capture is off.\n //\n // Before mask because content the customer never wanted to leave the\n // process should not be handed to a customer callback either — and\n // because a mask never called over a stripped field costs nothing, which\n // matters more here than in Python: this runs on the ONE event loop.\n //\n // Unconditional (not `if this._mask !== undefined`) because THIS is the\n // gate: `_applyMask` runs only when a mask was supplied, and the whole\n // defect being closed is that content escaped when nobody had opted into\n // anything.\n if (!this._traceContent) {\n const stripped = stripContentBatch(batch);\n if (stripped > 0) {\n debug(\n `traceContent is off — omitted ${stripped} content field(s) from ${batch.length} span(s)`,\n );\n }\n }\n\n if (this._mask !== undefined) {\n this._applyMask(batch);\n }\n\n debug(`Exporting batch of ${batch.length} spans`);\n\n // Export to all exporters — count once, not per exporter\n let batchExported = false;\n const anyDelivers = this._exporters.some((e) => e.countsAsDelivery !== false);\n // Spans that an exporter could not serialize: not sent, dropped at once.\n const unserializable = new Set<Span>();\n for (const exporter of this._exporters) {\n const decides = !anyDelivers || exporter.countsAsDelivery !== false;\n try {\n const result = await exporter.export(batch);\n // `shutdown()` stopped this batch and counted it as residue. Its late\n // answer changes no counter and re-queues nothing.\n if (flight.abandoned) return Round.Failed;\n if (!decides) continue;\n for (const span of exporter.takeUnserializable?.(batch) ?? []) unserializable.add(span);\n if (result === ExportResult.SUCCESS) {\n const ack = exporter.takeAck?.(batch) ?? null;\n if (!batchExported) {\n this._countDelivered(batch.length - unserializable.size, ack);\n batchExported = true;\n // Clear retry counts for successfully exported spans\n for (const span of batch) {\n this._retryCounts.delete(span.spanId);\n }\n }\n } else {\n this.failedExports++;\n }\n } catch (e) {\n if (flight.abandoned) return Round.Failed;\n if (!decides) continue;\n this.failedExports++;\n debug(`Export to ${exporter.name} failed: ${describeThrown(e)}`);\n }\n }\n if (unserializable.size > 0) this._recordDropped('unacknowledged', unserializable.size);\n\n // Audit #5: Re-queue failed batches with retry limit\n if (!batchExported) {\n let dropped = 0;\n const retryable = batch.filter(span => {\n if (unserializable.has(span)) return false;\n const count = (this._retryCounts.get(span.spanId) ?? 0) + 1;\n if (count > BatchSpanProcessor.MAX_RETRIES) {\n // retry-map drain site 2 of 3\n this._retryCounts.delete(span.spanId);\n // The count is once per SPAN IDENTITY, at exhaustion — never once\n // per attempt. A span re-queued twice and then dropped is ONE lost\n // span; keying on spanId is what makes that true.\n this._recordDropped('transport_refused');\n dropped++;\n return false;\n }\n this._retryCounts.set(span.spanId, count);\n return true;\n });\n if (retryable.length > 0) {\n this._queue.unshift(...retryable);\n debug(`Re-queued ${retryable.length} spans for retry (${batch.length - retryable.length} dropped after max retries)`);\n }\n if (dropped > 0) {\n // RULING §2: the PRIMARY remedy is a default-visible WARNING at the\n // moment of discard, naming the count and the reason — not a counter.\n // The log line survives the process; the counter does not, and on the\n // shutdown path there is no reader for it at all. `debug()` above is\n // suppressed at default level, which is why this is `warn()`.\n const now = Date.now();\n if (now - this._lastRefusalWarnAt > REFUSAL_WARN_WINDOW_MS) {\n this._lastRefusalWarnAt = now;\n const rounds = BatchSpanProcessor.MAX_RETRIES + 1;\n const perRound = this._requestsPerRound();\n warn(\n `${dropped} span(s) DISCARDED (reason=transport_refused) after ` +\n `${rounds} failed export rounds each` +\n (perRound !== undefined\n ? ` (up to ${rounds * perRound} HTTP requests: ${perRound} in each round)`\n : '') +\n ` — the endpoint is ` +\n `not accepting spans and the retry budget is spent. ` +\n `${this.droppedSpansByReason.transport_refused} span(s) discarded this way so far ` +\n `in this process. This data is gone; check the apiKey and the endpoint.`\n );\n }\n }\n }\n return batchExported ? Round.Delivered : Round.Failed;\n } finally {\n if (this._inFlight === flight) this._inFlight = null;\n this._flushing = false;\n }\n }\n}\n","/**\n * SDK configuration with environment variable loading.\n *\n * Environment variables match the Python SDK exactly:\n * RISICARE_API_KEY, RISICARE_ENDPOINT, RISICARE_PROJECT_ID, etc.\n */\n\nimport { DEFAULT_BATCH_SIZE } from './exporters/batch.js';\nimport type { MaskFn } from './masking.js';\nimport { warn } from './utils/log.js';\n\nexport interface RisicareConfig {\n /** API key for authentication (format: \"rsk-{random}\"). Each key is scoped to one project. */\n apiKey?: string;\n\n /** Ingest gateway URL. It receives spans only. */\n endpoint?: string;\n /**\n * Api URL. It serves active-fix reads and scores. The order is:\n * 1. this option;\n * 2. the `endpoint` option, when it is given and it is not the default ingest host;\n * 3. `RISICARE_API_ENDPOINT`;\n * 4. `RISICARE_ENDPOINT`, when no `endpoint` option is given and it is not the\n * default ingest host;\n * 5. the default api host.\n * The default ingest host (`https://ingest.risicare.ai`) never names an api\n * host. `RISICARE_ENDPOINT` alone keeps every URL shape on that one host. Each\n * value is trimmed of ASCII whitespace, and an empty value is not given.\n */\n apiEndpoint?: string;\n\n /**\n * @deprecated Project is determined by your API key. This field is ignored\n * by the gateway and will be removed in v1.0. Use `serviceName` and\n * `environment` for within-project organization.\n */\n projectId?: string;\n\n /** Environment name (production, staging, development). Used for within-project organization. */\n environment?: string;\n\n /** Service name for within-project organization. */\n serviceName?: string;\n\n /** Service version */\n serviceVersion?: string;\n\n /** Whether tracing is enabled (default: true if apiKey provided) */\n enabled?: boolean;\n\n /**\n * Whether prompt/completion content may leave the process.\n *\n * **Default `false` since 0.5.1** (was `true`). When false, every\n * content-keyed attribute is replaced with `<risicare:content-omitted>` on\n * the export path — including content you set by hand, which 0.5.0 and\n * earlier did NOT gate.\n */\n traceContent?: boolean;\n\n /** Sample rate 0.0–1.0 (default: 1.0 = trace all) */\n sampleRate?: number;\n\n /** Batch size threshold before flush (default: 500) */\n batchSize?: number;\n\n /** Batch timeout in ms before flush (default: 1000) */\n batchTimeoutMs?: number;\n\n /** Maximum queue size (default: 10000) */\n maxQueueSize?: number;\n\n /** Enable debug logging (default: false) */\n debug?: boolean;\n\n /** Enable gzip compression for HTTP exports (default: false) */\n compress?: boolean;\n\n /**\n * Whether FixRuntime starts (or `RISICARE_FIX_RUNTIME=true`).\n *\n * **Default `false` since 0.7.0** (it started whenever an `apiKey` was set).\n * During the beta, the Risicare service does not give fixes to customer\n * projects, so FixRuntime has no effect for them. When true, the SDK polls\n * `/fixes/active` every 60 s. The interceptor then enforces guard fixes on\n * the paths that call it, and a failed guard throws `GuardRejectedError`.\n * The provider path does not apply prompt, parameter or fallback fixes.\n * When false, nothing polls and nothing is applied.\n */\n fixRuntime?: boolean;\n\n /** Custom metadata attached to all spans */\n metadata?: Record<string, unknown>;\n\n /**\n * Masking callback applied to every content-bearing field of every span\n * BEFORE the batch leaves the process — `mask(key, value) => value`.\n *\n * This is the only layer at which you can keep data off Risicare's wire, so\n * it applies to every exporter, including custom ones. `key` is the attribute\n * key (`\"gen_ai.prompt.0.content\"`) or a dotted path (`\"statusMessage\"`,\n * `\"events.0.attributes.x\"`). Identifiers and span/event names are NOT passed\n * to it — masking those breaks trace structure and your own joins.\n *\n * ⚠ Must be CPU-only and fast: Node is single-threaded, so this runs on your\n * event loop. No I/O, no network, no unbounded retries, no per-request state.\n * If it throws, that one field becomes `\"<risicare:mask-error>\"` and the span\n * is still exported. See `masking.ts`.\n *\n * ⚠ Has NO environment-variable form, deliberately: the shapes that would\n * make a callable env-resolvable are arbitrary code execution driven by the\n * process environment. Masking is configured in code, by the application that\n * owns the data.\n */\n mask?: MaskFn;\n}\n\n// ⚠ TWO HOSTS SINCE 0.7.0, and the old single host did not work.\n// `app.risicare.ai` was the default through 0.6.0. It is the production\n// DASHBOARD: measured 2026-09-19 it resolves to 34.198.171.50 and the\n// connection times out, so it served none of this traffic. The change removes\n// a false promise, not a function.\n//\n// The gateway serves POST /v1/spans. The api serves /v1/fixes/active and\n// /v1/scores, with NO `/api` prefix — that prefix existed only because a Caddy\n// reverse proxy stripped it before forwarding, and there is no Caddy now.\nconst DEFAULT_ENDPOINT = 'https://ingest.risicare.ai';\nconst DEFAULT_API_ENDPOINT = 'https://api.risicare.ai';\n\n/**\n * The ASCII whitespace that every endpoint input is trimmed of: space, tab, LF,\n * CR, FF, VT. The Python SDK trims the same six characters. (`String.trim()`\n * also removes other characters, such as a BOM, so it is not used here.)\n */\nconst ASCII_WS_EDGES = /^[ \\t\\n\\r\\f\\v]+|[ \\t\\n\\r\\f\\v]+$/g;\n\n/** @internal The value trimmed of ASCII whitespace, or `undefined` when nothing is left. */\nexport function given(value: string | undefined): string | undefined {\n if (typeof value !== 'string') return undefined;\n const trimmed = value.replace(ASCII_WS_EDGES, '');\n return trimmed === '' ? undefined : trimmed;\n}\n\n/**\n * True when `value` (already trimmed) is the default ingest host: scheme https,\n * host `ingest.risicare.ai` in any ASCII case, port absent or 443, path empty or\n * only slashes. Nothing else: a look-alike host, another scheme, userinfo, a\n * query or a path such as `/v1` is not the default host. The Python SDK uses\n * the same pattern (`risicare/_endpoints.py`).\n */\nconst DEFAULT_INGEST_PATTERN = /^https:\\/\\/ingest\\.risicare\\.ai(?::443)?\\/*$/i;\n\nfunction isDefaultIngest(value: string): boolean {\n return DEFAULT_INGEST_PATTERN.test(value);\n}\n\n/**\n * The span host and the api host. Api host order (scores and fix reads):\n * 1. the `apiEndpoint` option;\n * 2. the `endpoint` option, when it is given and it is NOT the default ingest host;\n * 3. `RISICARE_API_ENDPOINT`;\n * 4. `RISICARE_ENDPOINT`, when NO `endpoint` option is given and its value is not\n * the default ingest host;\n * 5. the default api host.\n * The default ingest host never names an api host. It only declines to name\n * one, so a key never goes to a host that the caller did not name. Span host\n * order: the `endpoint` option, `RISICARE_ENDPOINT`, the default ingest host.\n */\nfunction resolveEndpoints(\n endpointOption: string | undefined,\n apiEndpointOption: string | undefined,\n envEndpoint: string | undefined,\n envApiEndpoint: string | undefined,\n): { endpoint: string; apiEndpoint: string } {\n const e = given(endpointOption);\n const a = given(apiEndpointOption);\n const ee = given(envEndpoint);\n const ea = given(envApiEndpoint);\n const endpoint = e ?? ee ?? DEFAULT_ENDPOINT;\n let apiEndpoint: string;\n if (a !== undefined) apiEndpoint = a;\n else if (e !== undefined && !isDefaultIngest(e)) apiEndpoint = e;\n else if (ea !== undefined) apiEndpoint = ea;\n else if (e === undefined && ee !== undefined && !isDefaultIngest(ee)) apiEndpoint = ee;\n else apiEndpoint = DEFAULT_API_ENDPOINT;\n return { endpoint, apiEndpoint };\n}\n\n/**\n * Load configuration from environment variables, merged with explicit config.\n * Explicit config takes precedence over env vars.\n */\nexport function resolveConfig(\n config?: Partial<RisicareConfig>,\n): Required<Omit<RisicareConfig, 'metadata' | 'mask'>> & {\n metadata: Record<string, unknown>;\n // `mask` is excluded from `Required<>` on purpose: \"no mask\" is a real,\n // supported state and must stay expressible as `undefined`. Defaulting it to\n // an identity function would make \"is masking configured?\" unanswerable by\n // inspection — the processor skips the whole pass when this is undefined.\n mask: MaskFn | undefined;\n} {\n const env = process.env;\n\n const apiKey = config?.apiKey ?? env.RISICARE_API_KEY;\n // ⚠ THE ONE-VAR FALLBACK, AND IT IS LOAD-BEARING. A lab or a self-hosted\n // deployment that sets only RISICARE_ENDPOINT keeps every URL shape on that\n // one host. Remove step 4 of `resolveEndpoints` and such a deployment silently\n // sends fix reads and scores to api.risicare.ai. `tests/endpoint-hosts.test.ts`\n // pins it.\n // Through 0.7.1 RISICARE_API_ENDPOINT came before the `endpoint` option, so\n // `init({endpoint: 'http://my-host'})` sent spans to my-host and scores and\n // fix reads to whatever the environment held, and `RISICARE_ENDPOINT=''` gave\n // `''` for both endpoints.\n const { endpoint, apiEndpoint } = resolveEndpoints(\n config?.endpoint,\n config?.apiEndpoint,\n env.RISICARE_ENDPOINT,\n env.RISICARE_API_ENDPOINT,\n );\n const projectId = config?.projectId ?? env.RISICARE_PROJECT_ID;\n\n // Deprecation warning for projectId\n if (config?.projectId || env.RISICARE_PROJECT_ID) {\n console.warn(\n '[risicare] projectId is deprecated and ignored by the gateway. ' +\n 'Your API key determines the project. ' +\n 'Use serviceName and environment for within-project organization. ' +\n 'projectId will be removed in v1.0.'\n );\n }\n // `||`, not `??`: an empty string is \"not set\", as in Python (D1).\n const environment = config?.environment || env.RISICARE_ENVIRONMENT || 'development';\n const serviceName = config?.serviceName ?? env.RISICARE_SERVICE_NAME;\n const serviceVersion = config?.serviceVersion ?? env.RISICARE_SERVICE_VERSION;\n // ⚠ DEFAULT CHANGED 0.5.0 -> 0.5.1: was `true`. `RISICARE_TRACE_CONTENT=true`\n // (or `traceContent: true`) restores capture explicitly.\n const traceContent = config?.traceContent ?? parseBool(env.RISICARE_TRACE_CONTENT, false);\n const sampleRateRaw = config?.sampleRate ?? parseFloat(env.RISICARE_SAMPLE_RATE ?? '1.0');\n const debug = config?.debug ?? parseBool(env.RISICARE_DEBUG, false);\n const compress = config?.compress ?? parseBool(env.RISICARE_COMPRESS, false);\n // ⚠ DEFAULT CHANGED 0.6.0 -> 0.7.0: FixRuntime is OPT-IN (see `fixRuntime`).\n const fixRuntime = config?.fixRuntime ?? parseBool(env.RISICARE_FIX_RUNTIME, false);\n // SDK-RELEASE-RULING.md §4.3: default raised 100 -> 500. Derived, and stated\n // once in `exporters/batch.ts` — imported rather than repeated so the env\n // default and the validation default cannot drift apart from the processor's.\n const batchSizeRaw = config?.batchSize ?? parseNumericEnv(env.RISICARE_BATCH_SIZE, DEFAULT_BATCH_SIZE);\n const batchTimeoutMsRaw = config?.batchTimeoutMs ?? parseNumericEnv(env.RISICARE_BATCH_TIMEOUT_MS, 1000);\n const maxQueueSizeRaw = config?.maxQueueSize ?? parseNumericEnv(env.RISICARE_MAX_QUEUE_SIZE, 10000);\n\n // F-355/F-356/F-357: numeric inputs must validate, clamp, and warn —\n // silent NaN/negative/string acceptance breaks the exporter unpredictably.\n const sampleRate = validateSampleRate(sampleRateRaw);\n // F-SDKSAMPRATEBLIND-001 — the rate never reaches the platform, so say so at\n // the one moment the customer chose it. Verified 2026-08-17 across 539\n // first-party server / worker / dashboard / gateway / schema files (controls:\n // 128 files match trace_id, 228 match project_id): no ingest field, no\n // column, no query and no W3C traceparent flag carries it — both emitters\n // hardcode `-01`, and `TraceFlags.SAMPLED` has zero call sites. So every\n // server-side count is a count of SAMPLED traces and nothing downstream can\n // scale it back up. Re-run: fix-workstream/perf/w34/sampling_wire_probe.sh\n if (sampleRate < 1.0) {\n console.warn(\n `[risicare] sampleRate=${sampleRate} — head sampling is applied in-process ` +\n `and the rate is NOT transmitted to the platform. Trace counts, error rates ` +\n `and cost figures in the dashboard will describe the sampled subset only, ` +\n `and cannot be scaled back to totals. Sampling is trace-coherent: a dropped ` +\n `trace drops whole.`,\n );\n }\n const batchSize = validatePositiveInt('batchSize', batchSizeRaw, DEFAULT_BATCH_SIZE, 1, 10_000);\n const batchTimeoutMs = validatePositiveInt('batchTimeoutMs', batchTimeoutMsRaw, 1000, 1, 600_000);\n const maxQueueSize = validatePositiveInt('maxQueueSize', maxQueueSizeRaw, 10_000, 1, 1_000_000);\n\n // Enabled logic: explicit > env RISICARE_TRACING > (true if apiKey present)\n let enabled: boolean;\n const tracingEnv = config?.enabled === undefined ? tracingFromEnv(env.RISICARE_TRACING) : undefined;\n if (config?.enabled !== undefined) {\n enabled = config.enabled;\n } else if (tracingEnv !== undefined) {\n enabled = tracingEnv;\n } else {\n enabled = !!apiKey;\n }\n\n return hideKeyFromInspect({\n apiKey: apiKey ?? '',\n endpoint,\n apiEndpoint,\n projectId: projectId ?? '',\n environment,\n serviceName: serviceName ?? '',\n serviceVersion: serviceVersion ?? '',\n enabled,\n traceContent,\n sampleRate,\n batchSize,\n batchTimeoutMs,\n maxQueueSize,\n debug,\n compress,\n fixRuntime,\n metadata: config?.metadata ?? {},\n // No env fallback — see the field's note on RisicareConfig.\n mask: config?.mask,\n });\n}\n\n/**\n * `util.inspect` and `console.log` of the config do not show the key. The method is\n * NOT enumerable, so a copy (`{ ...config }`) and `JSON.stringify` are not changed.\n * Python twin: `api_key` is `field(repr=False)`.\n */\nfunction hideKeyFromInspect<T extends { apiKey: string }>(config: T): T {\n Object.defineProperty(config, Symbol.for('nodejs.util.inspect.custom'), {\n enumerable: false,\n value(this: T, _depth: number, options: object, inspect: (v: unknown, o: object) => string) {\n const { apiKey, ...rest } = this;\n return `RisicareConfig ${inspect({ ...rest, apiKey: apiKey ? '<redacted>' : '' }, options)}`;\n },\n });\n return config;\n}\n\nfunction parseBool(value: string | undefined, defaultValue: boolean): boolean {\n if (value === undefined) return defaultValue;\n const lower = value.toLowerCase();\n return lower === 'true' || lower === '1' || lower === 'yes';\n}\n\nconst TRACING_ON = new Set(['true', '1', 'yes', 'on']);\nconst TRACING_OFF = new Set(['false', '0', 'no', 'off']);\n\n/**\n * Parse `RISICARE_TRACING`. The Python SDK uses the same value set.\n *\n * Whitespace is trimmed and case is ignored. `true`, `1`, `yes` and `on` turn\n * tracing on; `false`, `0`, `no` and `off` turn it off. An empty or\n * whitespace-only value is the same as unset: the return is `undefined`, and the\n * default applies. Any other value turns tracing OFF, with one WARNING; an\n * unrecognised value never turns tracing on.\n *\n * Through 0.7.1 the shared `parseBool` read this variable: only `true`, `1` and\n * `yes` turned tracing on, with no trim, so `on`, ` true` and an empty value\n * turned it off. `parseBool` still reads the other boolean variables, unchanged.\n */\nfunction tracingFromEnv(value: string | undefined): boolean | undefined {\n if (value === undefined) return undefined;\n const v = value.trim().toLowerCase();\n if (v === '') return undefined;\n if (TRACING_ON.has(v)) return true;\n if (TRACING_OFF.has(v)) return false;\n warn(\n `RISICARE_TRACING=${JSON.stringify(value.slice(0, 40))} is not a recognised value, so ` +\n `tracing is OFF. Use one of: true, 1, yes, on (tracing on) or false, 0, no, off ` +\n `(tracing off). Leave it unset or empty to use the default.`,\n );\n return false;\n}\n\n/**\n * Parse a numeric env var with a fallback default. parseInt returns NaN on\n * non-numeric input — we want the default in that case, not NaN propagating.\n */\nfunction parseNumericEnv(value: string | undefined, defaultValue: number): number {\n if (value === undefined) return defaultValue;\n const n = Number(value);\n return Number.isFinite(n) ? n : defaultValue;\n}\n\n/**\n * F-355: sampleRate must be a finite number in [0, 1]. Anything else warns\n * and falls back to 1.0 (trace everything — safer default for an observability\n * platform than \"trace nothing\" on a typo).\n */\nfunction validateSampleRate(value: unknown): number {\n if (typeof value === 'number' && Number.isFinite(value) && value >= 0 && value <= 1) {\n return value;\n }\n // Try string→number coercion once for env vars that arrive as strings.\n if (typeof value === 'string') {\n const n = Number(value);\n if (Number.isFinite(n) && n >= 0 && n <= 1) return n;\n }\n console.warn(\n `[risicare] sampleRate must be a finite number in [0, 1], got ${typeof value}=${JSON.stringify(value)}; defaulting to 1.0`,\n );\n return 1.0;\n}\n\n/**\n * F-356/F-357: validate a positive-integer config knob. Coerces strings,\n * rejects NaN/negative/non-finite, clamps to [min, max] with a warning.\n */\nfunction validatePositiveInt(\n name: string,\n value: unknown,\n defaultValue: number,\n min: number,\n max: number,\n): number {\n let n: number;\n if (typeof value === 'number') {\n n = value;\n } else if (typeof value === 'string') {\n n = Number(value);\n if (Number.isFinite(n)) {\n console.warn(\n `[risicare] ${name} was a string (\"${value}\"); coerced to ${n}. Pass a number to avoid this warning.`,\n );\n }\n } else {\n console.warn(\n `[risicare] ${name} must be a positive integer, got ${typeof value}; defaulting to ${defaultValue}`,\n );\n return defaultValue;\n }\n if (!Number.isFinite(n) || n <= 0) {\n console.warn(\n `[risicare] ${name} must be > 0, got ${value}; defaulting to ${defaultValue}`,\n );\n return defaultValue;\n }\n if (n < min) {\n console.warn(`[risicare] ${name}=${n} below floor; clamping to ${min}`);\n return min;\n }\n if (n > max) {\n console.warn(`[risicare] ${name}=${n} above ceiling; clamping to ${max}`);\n return max;\n }\n return Math.floor(n);\n}\n","/**\n * ID generation for traces and spans.\n *\n * Trace IDs: 32 lowercase hex characters (16 random bytes)\n * Span IDs: 16 lowercase hex characters (8 random bytes)\n *\n * Uses crypto.randomBytes for cryptographically secure randomness.\n */\n\nimport { randomBytes } from 'node:crypto';\n\nconst HEX_REGEX_32 = /^[0-9a-f]{32}$/;\nconst HEX_REGEX_16 = /^[0-9a-f]{16}$/;\n\nexport function generateTraceId(): string {\n return randomBytes(16).toString('hex');\n}\n\nexport function generateSpanId(): string {\n return randomBytes(8).toString('hex');\n}\n\nexport function generateAgentId(prefix?: string): string {\n const suffix = randomBytes(8).toString('hex');\n return prefix ? `${prefix}-${suffix}` : suffix;\n}\n\nexport function validateTraceId(id: string): boolean {\n return HEX_REGEX_32.test(id);\n}\n\nexport function validateSpanId(id: string): boolean {\n return HEX_REGEX_16.test(id);\n}\n","/**\n * Core type definitions for the Risicare SDK.\n *\n * These enums and types mirror the Python SDK's risicare-core types\n * and align with the Rust gateway's SpanData struct.\n */\n\n// ─── Span Kind ───────────────────────────────────────────────────────────────\n\nexport enum SpanKind {\n INTERNAL = 'internal',\n CLIENT = 'client',\n SERVER = 'server',\n PRODUCER = 'producer',\n CONSUMER = 'consumer',\n AGENT = 'agent',\n LLM_CALL = 'llm_call',\n TOOL_CALL = 'tool_call',\n RETRIEVAL = 'retrieval',\n DECISION = 'decision',\n MESSAGE = 'message',\n DELEGATION = 'delegation',\n COORDINATION = 'coordination',\n THINK = 'think',\n DECIDE = 'decide',\n OBSERVE = 'observe',\n REFLECT = 'reflect',\n}\n\n// ─── Span Status ─────────────────────────────────────────────────────────────\n\nexport enum SpanStatus {\n UNSET = 'unset',\n OK = 'ok',\n ERROR = 'error',\n}\n\n// ─── Semantic Phase (Tier 4: Decision Tracking) ──────────────────────────────\n\nexport enum SemanticPhase {\n THINK = 'think',\n DECIDE = 'decide',\n ACT = 'act',\n OBSERVE = 'observe',\n REFLECT = 'reflect',\n COMMUNICATE = 'communicate',\n COORDINATE = 'coordinate',\n}\n\n// ─── Agent Role ──────────────────────────────────────────────────────────────\n\nexport enum AgentRole {\n // Primary roles\n ORCHESTRATOR = 'orchestrator',\n WORKER = 'worker',\n SUPERVISOR = 'supervisor',\n SPECIALIST = 'specialist',\n // Communication roles\n ROUTER = 'router',\n AGGREGATOR = 'aggregator',\n BROADCASTER = 'broadcaster',\n // Specialized roles\n CRITIC = 'critic',\n PLANNER = 'planner',\n EXECUTOR = 'executor',\n RETRIEVER = 'retriever',\n VALIDATOR = 'validator',\n // JS-specific (backwards compatibility)\n REVIEWER = 'reviewer',\n CUSTOM = 'custom',\n}\n\n// ─── Message Type (Tier 5: Multi-Agent) ──────────────────────────────────────\n\nexport enum MessageType {\n // Control messages\n TASK = 'task',\n RESULT = 'result',\n STATUS = 'status',\n ERROR = 'error',\n // Communication messages\n QUERY = 'query',\n RESPONSE = 'response',\n BROADCAST = 'broadcast',\n DIRECT = 'direct',\n // Coordination messages\n PROPOSAL = 'proposal',\n VOTE = 'vote',\n CONSENSUS = 'consensus',\n CONFLICT = 'conflict',\n // Lifecycle messages\n HEARTBEAT = 'heartbeat',\n SHUTDOWN = 'shutdown',\n HANDOFF = 'handoff',\n // JS-specific (backwards compatibility)\n REQUEST = 'request',\n DELEGATE = 'delegate',\n COORDINATE = 'coordinate',\n}\n\n// ─── Span Event ──────────────────────────────────────────────────────────────\n\nexport interface SpanEvent {\n name: string;\n timestamp: string;\n attributes?: Record<string, unknown>;\n}\n\n// ─── Span Link ───────────────────────────────────────────────────────────────\n\nexport interface SpanLink {\n traceId: string;\n spanId: string;\n attributes?: Record<string, unknown>;\n}\n\n// ─── Span Payload (Wire Format) ──────────────────────────────────────────────\n// Matches Rust gateway SpanData struct exactly (camelCase)\n\nexport interface SpanPayload {\n traceId: string;\n spanId: string;\n parentSpanId?: string;\n name: string;\n kind: string;\n startTime: string;\n endTime?: string;\n durationMs?: number;\n status: string;\n statusMessage?: string;\n attributes: Record<string, unknown>;\n events: SpanEvent[];\n links: SpanLink[];\n sessionId?: string;\n agentId?: string;\n agentName?: string;\n agentType?: string;\n semanticPhase?: string;\n llmProvider?: string;\n llmModel?: string;\n llmPromptTokens?: number;\n llmCompletionTokens?: number;\n llmTotalTokens?: number;\n llmCostUsd?: number;\n toolName?: string;\n toolSuccess?: boolean;\n}\n\n// ─── Ingest Request ──────────────────────────────────────────────────────────\n\nexport interface IngestRequest {\n spans: SpanPayload[];\n batchId?: string;\n projectId?: string;\n environment?: string;\n}\n","/**\n * High-resolution timing and ISO 8601 formatting utilities.\n */\n\n/**\n * Get current time as ISO 8601 string with millisecond precision.\n */\nexport function nowISO(): string {\n return new Date().toISOString();\n}\n\n/**\n * Get high-resolution monotonic time in milliseconds.\n * Uses process.hrtime.bigint() for sub-ms precision.\n */\nexport function hrtimeMs(): number {\n return Number(process.hrtime.bigint()) / 1_000_000;\n}\n\n/**\n * Compute duration in milliseconds between two hrtime values.\n */\nexport function durationMs(startHrtime: number, endHrtime: number): number {\n return Math.max(0, endHrtime - startHrtime);\n}\n\n/**\n * Format a Date or ISO string to ISO 8601 with millisecond precision.\n */\nexport function toISO(time: Date | string | number): string {\n if (typeof time === 'string') return time;\n if (typeof time === 'number') return new Date(time).toISOString();\n return time.toISOString();\n}\n","/**\n * Span class — the core unit of tracing.\n *\n * A span represents a single operation (LLM call, tool use, agent step).\n * Spans are mutable: attributes, events, and status can be set after creation.\n * Call end() to finalize the span and trigger export.\n */\n\nimport { generateSpanId, generateTraceId } from './ids.js';\nimport {\n SpanKind,\n SpanStatus,\n type SpanEvent,\n type SpanLink,\n type SpanPayload,\n} from './types.js';\nimport { nowISO, hrtimeMs } from './utils/clock.js';\n\nexport interface SpanOptions {\n name: string;\n kind?: SpanKind;\n traceId?: string;\n spanId?: string;\n parentSpanId?: string;\n attributes?: Record<string, unknown>;\n links?: SpanLink[];\n sessionId?: string;\n agentId?: string;\n agentName?: string;\n agentType?: string;\n semanticPhase?: string;\n}\n\nexport type SpanEndCallback = (span: Span) => void;\n\nexport class Span {\n readonly traceId: string;\n readonly spanId: string;\n readonly parentSpanId: string | undefined;\n readonly name: string;\n readonly kind: SpanKind;\n readonly startTime: string;\n readonly startHrtime: number;\n\n endTime: string | undefined;\n status: SpanStatus;\n statusMessage: string | undefined;\n attributes: Record<string, unknown>;\n events: SpanEvent[];\n links: SpanLink[];\n\n // Agent/session fields\n sessionId: string | undefined;\n agentId: string | undefined;\n agentName: string | undefined;\n agentType: string | undefined;\n semanticPhase: string | undefined;\n\n // LLM-specific fields\n llmProvider: string | undefined;\n llmModel: string | undefined;\n llmPromptTokens: number | undefined;\n llmCompletionTokens: number | undefined;\n llmTotalTokens: number | undefined;\n llmCostUsd: number | undefined;\n\n // Tool fields\n toolName: string | undefined;\n toolSuccess: boolean | undefined;\n\n private _ended = false;\n private _endHrtime: number | undefined;\n private _onEnd: SpanEndCallback | undefined;\n\n constructor(options: SpanOptions, onEnd?: SpanEndCallback) {\n this.traceId = options.traceId ?? generateTraceId();\n this.spanId = options.spanId ?? generateSpanId();\n this.parentSpanId = options.parentSpanId;\n this.name = options.name;\n this.kind = options.kind ?? SpanKind.INTERNAL;\n this.startTime = nowISO();\n this.startHrtime = hrtimeMs();\n\n this.status = SpanStatus.UNSET;\n this.attributes = options.attributes ? { ...options.attributes } : {};\n this.events = [];\n this.links = options.links ? [...options.links] : [];\n\n this.sessionId = options.sessionId;\n this.agentId = options.agentId;\n this.agentName = options.agentName;\n this.agentType = options.agentType;\n this.semanticPhase = options.semanticPhase;\n\n this._onEnd = onEnd;\n }\n\n get isEnded(): boolean {\n return this._ended;\n }\n\n get durationMs(): number {\n if (this._ended && this._endHrtime !== undefined) {\n return this._endHrtime - this.startHrtime;\n }\n return hrtimeMs() - this.startHrtime;\n }\n\n setAttribute(key: string, value: unknown): this {\n if (this._ended) return this;\n this.attributes[key] = value;\n return this;\n }\n\n setAttributes(attrs: Record<string, unknown>): this {\n if (this._ended) return this;\n Object.assign(this.attributes, attrs);\n return this;\n }\n\n setStatus(status: SpanStatus, message?: string): this {\n if (this._ended) return this;\n this.status = status;\n if (message !== undefined) {\n this.statusMessage = message;\n }\n return this;\n }\n\n addEvent(name: string, attributes?: Record<string, unknown>): this {\n if (this._ended) return this;\n this.events.push({\n name,\n timestamp: nowISO(),\n attributes,\n });\n return this;\n }\n\n addLink(traceId: string, spanId: string, attributes?: Record<string, unknown>): this {\n if (this._ended) return this;\n this.links.push({ traceId, spanId, attributes });\n return this;\n }\n\n recordException(error: Error | string): this {\n if (this._ended) return this;\n\n const message = typeof error === 'string' ? error : error.message;\n const stack = typeof error === 'string' ? undefined : error.stack;\n\n this.setStatus(SpanStatus.ERROR, message);\n this.addEvent('exception', {\n 'exception.type': typeof error === 'string' ? 'Error' : error.constructor.name,\n 'exception.message': message,\n ...(stack ? { 'exception.stacktrace': stack } : {}),\n });\n\n return this;\n }\n\n setLlmFields(fields: {\n provider?: string;\n model?: string;\n promptTokens?: number;\n completionTokens?: number;\n totalTokens?: number;\n costUsd?: number;\n }): this {\n if (this._ended) return this;\n if (fields.provider !== undefined) this.llmProvider = fields.provider;\n if (fields.model !== undefined) this.llmModel = fields.model;\n if (fields.promptTokens !== undefined) this.llmPromptTokens = fields.promptTokens;\n if (fields.completionTokens !== undefined) this.llmCompletionTokens = fields.completionTokens;\n if (fields.totalTokens !== undefined) this.llmTotalTokens = fields.totalTokens;\n if (fields.costUsd !== undefined) this.llmCostUsd = fields.costUsd;\n return this;\n }\n\n setToolFields(fields: { name?: string; success?: boolean }): this {\n if (this._ended) return this;\n if (fields.name !== undefined) this.toolName = fields.name;\n if (fields.success !== undefined) this.toolSuccess = fields.success;\n return this;\n }\n\n end(): void {\n if (this._ended) return;\n this._ended = true;\n this._endHrtime = hrtimeMs();\n this.endTime = nowISO();\n\n if (this.status === SpanStatus.UNSET) {\n this.status = SpanStatus.OK;\n }\n\n this._onEnd?.(this);\n }\n\n /**\n * Serialize to the wire format expected by the Rust gateway.\n */\n toPayload(): SpanPayload {\n const payload: SpanPayload = {\n traceId: this.traceId,\n spanId: this.spanId,\n name: this.name,\n kind: this.kind,\n startTime: this.startTime,\n status: this.status,\n attributes: this.attributes,\n events: this.events,\n links: this.links,\n };\n\n if (this.parentSpanId !== undefined) payload.parentSpanId = this.parentSpanId;\n if (this.endTime !== undefined) payload.endTime = this.endTime;\n if (this._ended) payload.durationMs = this.durationMs;\n if (this.statusMessage !== undefined) payload.statusMessage = this.statusMessage;\n if (this.sessionId !== undefined) payload.sessionId = this.sessionId;\n if (this.agentId !== undefined) payload.agentId = this.agentId;\n if (this.agentName !== undefined) payload.agentName = this.agentName;\n if (this.agentType !== undefined) payload.agentType = this.agentType;\n if (this.semanticPhase !== undefined) payload.semanticPhase = this.semanticPhase;\n if (this.llmProvider !== undefined) payload.llmProvider = this.llmProvider;\n if (this.llmModel !== undefined) payload.llmModel = this.llmModel;\n if (this.llmPromptTokens !== undefined) payload.llmPromptTokens = this.llmPromptTokens;\n if (this.llmCompletionTokens !== undefined) payload.llmCompletionTokens = this.llmCompletionTokens;\n if (this.llmTotalTokens !== undefined) payload.llmTotalTokens = this.llmTotalTokens;\n if (this.llmCostUsd !== undefined) payload.llmCostUsd = this.llmCostUsd;\n if (this.toolName !== undefined) payload.toolName = this.toolName;\n if (this.toolSuccess !== undefined) payload.toolSuccess = this.toolSuccess;\n\n return payload;\n }\n}\n","/**\n * No-op implementations for the disabled path.\n *\n * When tracing is disabled, all operations return these no-op objects\n * to maintain zero overhead. No allocations, no side effects.\n */\n\nimport { SpanKind, SpanStatus, type SpanPayload } from './types.js';\n\n/**\n * A frozen no-op span that silently ignores all operations.\n * Used when SDK is disabled to avoid overhead.\n */\nexport const NOOP_SPAN = Object.freeze({\n traceId: '00000000000000000000000000000000',\n spanId: '0000000000000000',\n parentSpanId: undefined,\n name: 'noop',\n kind: SpanKind.INTERNAL,\n startTime: '',\n startHrtime: 0,\n endTime: undefined,\n status: SpanStatus.UNSET,\n statusMessage: undefined,\n attributes: Object.freeze({}) as Record<string, unknown>,\n events: Object.freeze([]) as readonly [],\n links: Object.freeze([]) as readonly [],\n sessionId: undefined,\n agentId: undefined,\n agentName: undefined,\n semanticPhase: undefined,\n llmProvider: undefined,\n llmModel: undefined,\n llmPromptTokens: undefined,\n llmCompletionTokens: undefined,\n llmTotalTokens: undefined,\n llmCostUsd: undefined,\n toolName: undefined,\n toolSuccess: undefined,\n isEnded: true,\n durationMs: 0,\n\n setAttribute() { return this; },\n setAttributes() { return this; },\n setStatus() { return this; },\n addEvent() { return this; },\n addLink() { return this; },\n recordException() { return this; },\n setLlmFields() { return this; },\n setToolFields() { return this; },\n end() {},\n toPayload(): SpanPayload {\n return {\n traceId: this.traceId,\n spanId: this.spanId,\n name: this.name,\n kind: this.kind,\n startTime: this.startTime,\n status: this.status,\n attributes: {},\n events: [],\n links: [],\n };\n },\n});\n\nexport type NoopSpan = typeof NOOP_SPAN;\n","/**\n * Head-based deterministic sampling.\n *\n * Uses the first 8 hex characters of the trace ID as a hash\n * to make a deterministic sampling decision. This ensures:\n * - Same trace ID always produces the same decision\n * - Consistent across Python and JS/TS SDKs\n * - No external state needed\n */\n\n/**\n * Determine whether a trace should be sampled.\n *\n * @param traceId - 32-character hex trace ID\n * @param sampleRate - Rate between 0.0 (none) and 1.0 (all)\n * @returns true if the trace should be sampled\n */\nexport function shouldSample(traceId: string, sampleRate: number): boolean {\n if (sampleRate >= 1.0) return true;\n if (sampleRate <= 0.0) return false;\n\n // Parse first 8 hex chars as unsigned 32-bit integer\n const hash = parseInt(traceId.substring(0, 8), 16);\n return (hash / 0xFFFFFFFF) < sampleRate;\n}\n","/**\n * Fix Runtime Configuration.\n *\n * Settings for the fix runtime including caching, refresh intervals,\n * A/B testing, and fix application behavior.\n *\n * Port of Python SDK's runtime/config.py adapted for Node.js patterns.\n */\n\n// ─── Runtime Configuration ──────────────────────────────────────────────────\n\nexport interface FixRuntimeConfig {\n /** Api URL, serving /v1/fixes/active (e.g., \"https://api.risicare.ai\") */\n apiEndpoint: string;\n\n /** API key for authentication (format: \"rsk-{random}\") */\n apiKey: string;\n\n /** Whether the fix runtime is enabled (default: true) */\n enabled?: boolean;\n\n /** Whether caching is enabled (default: true) */\n cacheEnabled?: boolean;\n\n /** Cache entry TTL in milliseconds (default: 300_000 = 5 min) */\n cacheTtlMs?: number;\n\n /** Maximum number of cache entries (default: 1000) */\n cacheMaxEntries?: number;\n\n /** Whether to auto-refresh fixes in background (default: true) */\n autoRefresh?: boolean;\n\n /** Background refresh interval in milliseconds (default: 60_000 = 1 min) */\n refreshIntervalMs?: number;\n\n /** Log but don't apply fixes (default: false) */\n dryRun?: boolean;\n\n /** Whether A/B testing bucketing is active (default: true) */\n abTestingEnabled?: boolean;\n\n /** Timeout for API requests in milliseconds (default: 1000) */\n timeoutMs?: number;\n\n /** Enable debug logging (default: false) */\n debug?: boolean;\n}\n\n/** Resolve config with defaults applied. */\nexport function resolveFixRuntimeConfig(\n config: FixRuntimeConfig,\n): Required<FixRuntimeConfig> {\n return {\n apiEndpoint: config.apiEndpoint,\n apiKey: config.apiKey,\n enabled: config.enabled ?? true,\n cacheEnabled: config.cacheEnabled ?? true,\n cacheTtlMs: config.cacheTtlMs ?? 300_000,\n cacheMaxEntries: config.cacheMaxEntries ?? 1000,\n autoRefresh: config.autoRefresh ?? true,\n refreshIntervalMs: config.refreshIntervalMs ?? 60_000,\n dryRun: config.dryRun ?? false,\n abTestingEnabled: config.abTestingEnabled ?? true,\n timeoutMs: config.timeoutMs ?? 1000,\n debug: config.debug ?? false,\n };\n}\n\n// ─── Fix Type ───────────────────────────────────────────────────────────────\n\nexport type FixType =\n | 'prompt'\n | 'parameter'\n | 'retry'\n | 'fallback'\n | 'guard'\n | 'routing'\n | 'tool';\n\n// ─── Active Fix ─────────────────────────────────────────────────────────────\n\nexport interface ActiveFix {\n fixId: string;\n deploymentId?: string;\n errorCode: string;\n fixType: FixType;\n config: Record<string, unknown>;\n trafficPercentage: number; // 0–100\n version: number;\n}\n\n/**\n * Check if a fix matches the given error code.\n *\n * Supports exact match and wildcard prefix matching:\n * - \"TOOL.EXECUTION.TIMEOUT\" matches \"TOOL.EXECUTION.TIMEOUT\"\n * - \"TOOL.EXECUTION.*\" matches \"TOOL.EXECUTION.TIMEOUT\", \"TOOL.EXECUTION.FAILURE\", etc.\n * - \"TOOL.*\" matches any TOOL error\n */\nexport function matchesError(fix: ActiveFix, errorCode: string): boolean {\n if (fix.errorCode === errorCode) {\n return true;\n }\n\n // Wildcard matching\n if (fix.errorCode.endsWith('*')) {\n const prefix = fix.errorCode.slice(0, -1);\n return errorCode.startsWith(prefix);\n }\n\n return false;\n}\n\n/**\n * Determine if fix should be applied based on A/B traffic percentage.\n *\n * Uses consistent hashing so the same session always gets the same\n * treatment (fix or no fix).\n */\nexport function shouldApply(fix: ActiveFix, sessionHash: number): boolean {\n if (fix.trafficPercentage >= 100) return true;\n if (fix.trafficPercentage <= 0) return false;\n\n const bucket = sessionHash % 100;\n return bucket < fix.trafficPercentage;\n}\n\n/**\n * Create an ActiveFix from an API response item.\n *\n * Handles both snake_case (server API) and camelCase field names.\n */\nexport function activeFixFromApiResponse(\n item: Record<string, unknown>,\n): ActiveFix {\n return {\n fixId: (item.id ?? item.fix_id ?? item.fixId ?? '') as string,\n deploymentId: (item.deployment_id ?? item.deploymentId ?? '') as string,\n errorCode: (item.error_code ?? item.errorCode ?? '') as string,\n fixType: (item.fix_type ?? item.fixType ?? 'prompt') as FixType,\n config: (item.config ?? {}) as Record<string, unknown>,\n trafficPercentage: (item.traffic_percentage ?? item.trafficPercentage ?? 100) as number,\n version: (item.version ?? 1) as number,\n };\n}\n","// ⚠ GENERATED FILE — DO NOT EDIT BY HAND.\n//\n// Source of truth: packages/risicare-sdk/src/risicare/runtime/_error_taxonomy.py\n// Generator: packages/risicare-sdk/scripts/gen_js_taxonomy.py\n// Core rules: packages/risicare-core/src/risicare_core/taxonomy.py (_KEYWORD_RULES)\n// Verify: just taxonomy (gen_js_taxonomy.py --check)\n//\n// F-SDKTAXFORK-001. This SDK cannot import `risicare_core.taxonomy` —\n// `risicare-core` is not published to npm. Rather than hand-maintain a second\n// copy of one rule (a divergence this campaign has measured four times), the\n// rule table and the canonical code set are generated from the Python source\n// and a rail fails when the two drift.\n//\n// Each pattern is a translation of the Python pattern for the `u` flag\n// (`.` -> `[^\\n]`, `\\b` -> a lookaround on [\\p{L}\\p{N}_]). The text is\n// lowercased before the match, as in Python, so no rule has a case flag.\n//\n// 154 canonical codes across 10 modules.\n\nexport const CANONICAL_ERROR_CODES: ReadonlySet<string> = new Set([\n \"COMMUNICATION.CONTENT.AMBIGUOUS\",\n \"COMMUNICATION.CONTENT.CORRUPTED\",\n \"COMMUNICATION.CONTENT.INCOMPATIBLE\",\n \"COMMUNICATION.CONTENT.MALFORMED\",\n \"COMMUNICATION.CONTENT.TOO_LARGE\",\n \"COMMUNICATION.DELIVERY.DELAYED\",\n \"COMMUNICATION.DELIVERY.DUPLICATED\",\n \"COMMUNICATION.DELIVERY.EXPIRED\",\n \"COMMUNICATION.DELIVERY.OUT_OF_ORDER\",\n \"COMMUNICATION.DELIVERY.UNDELIVERABLE\",\n \"COMMUNICATION.ROUTING.BROADCAST_STORM\",\n \"COMMUNICATION.ROUTING.LOOP\",\n \"COMMUNICATION.ROUTING.NO_ROUTE\",\n \"COMMUNICATION.ROUTING.PARTITION\",\n \"COMMUNICATION.ROUTING.WRONG_ROUTE\",\n \"CONSENSUS.AGREEMENT.INCONSISTENT\",\n \"CONSENSUS.AGREEMENT.QUORUM_FAILED\",\n \"CONSENSUS.AGREEMENT.REJECTED\",\n \"CONSENSUS.AGREEMENT.STALE_VOTE\",\n \"CONSENSUS.AGREEMENT.TIMEOUT\",\n \"CONSENSUS.CONFLICT.BIAS\",\n \"CONSENSUS.CONFLICT.CASCADING\",\n \"CONSENSUS.CONFLICT.DEADLOCK\",\n \"CONSENSUS.CONFLICT.RESOLUTION_REJECTED\",\n \"CONSENSUS.CONFLICT.UNRESOLVED\",\n \"CONSENSUS.VOTING.ABSTENTION_FLOOD\",\n \"CONSENSUS.VOTING.COERCED_VOTE\",\n \"CONSENSUS.VOTING.DUPLICATE_VOTE\",\n \"CONSENSUS.VOTING.INVALID_VOTE\",\n \"CONSENSUS.VOTING.SPLIT_VOTE\",\n \"COORDINATION.HANDOFF.DELAYED\",\n \"COORDINATION.HANDOFF.DUPLICATED\",\n \"COORDINATION.HANDOFF.INCOMPLETE\",\n \"COORDINATION.HANDOFF.LOST\",\n \"COORDINATION.HANDOFF.WRONG_RECIPIENT\",\n \"COORDINATION.SYNCHRONIZATION.CLOCK_SKEW\",\n \"COORDINATION.SYNCHRONIZATION.OUT_OF_ORDER\",\n \"COORDINATION.SYNCHRONIZATION.RACE_CONDITION\",\n \"COORDINATION.SYNCHRONIZATION.SPLIT_BRAIN\",\n \"COORDINATION.SYNCHRONIZATION.VERSION_MISMATCH\",\n \"COORDINATION.WORKFLOW.CYCLE\",\n \"COORDINATION.WORKFLOW.DEADLOCK\",\n \"COORDINATION.WORKFLOW.LIVELOCK\",\n \"COORDINATION.WORKFLOW.ORPHANED\",\n \"COORDINATION.WORKFLOW.STARVATION\",\n \"MEMORY.CONTEXT_WINDOW.DROPPED\",\n \"MEMORY.CONTEXT_WINDOW.EXCEEDED\",\n \"MEMORY.CONTEXT_WINDOW.FRAGMENTED\",\n \"MEMORY.CONTEXT_WINDOW.PRIORITY_ERROR\",\n \"MEMORY.RETRIEVAL.INCOMPLETE\",\n \"MEMORY.RETRIEVAL.NOT_FOUND\",\n \"MEMORY.RETRIEVAL.OUTDATED\",\n \"MEMORY.RETRIEVAL.TOO_MANY\",\n \"MEMORY.RETRIEVAL.WRONG_MATCH\",\n \"MEMORY.STATE.CORRUPTED\",\n \"MEMORY.STATE.INCONSISTENT\",\n \"MEMORY.STATE.LOST\",\n \"MEMORY.STATE.OVERFLOW\",\n \"MEMORY.STATE.STALE\",\n \"ORCHESTRATION.DELEGATION.CAPABILITY_MISMATCH\",\n \"ORCHESTRATION.DELEGATION.CIRCULAR_DELEGATION\",\n \"ORCHESTRATION.DELEGATION.EXCESSIVE_DEPTH\",\n \"ORCHESTRATION.DELEGATION.NO_AVAILABLE_AGENT\",\n \"ORCHESTRATION.DELEGATION.OVERLOADED_AGENT\",\n \"ORCHESTRATION.LIFECYCLE.CLEANUP_FAILED\",\n \"ORCHESTRATION.LIFECYCLE.CRASHED\",\n \"ORCHESTRATION.LIFECYCLE.HUNG\",\n \"ORCHESTRATION.LIFECYCLE.SPAWN_FAILED\",\n \"ORCHESTRATION.LIFECYCLE.ZOMBIE\",\n \"ORCHESTRATION.SCALING.OVERLOADED\",\n \"ORCHESTRATION.SCALING.QUOTA_EXCEEDED\",\n \"ORCHESTRATION.SCALING.SCALE_DOWN_FAILED\",\n \"ORCHESTRATION.SCALING.SCALE_UP_FAILED\",\n \"ORCHESTRATION.SCALING.UNDERUTILIZED\",\n \"OUTPUT.FORMAT.ENCODING\",\n \"OUTPUT.FORMAT.INVALID_JSON\",\n \"OUTPUT.FORMAT.MALFORMED\",\n \"OUTPUT.FORMAT.SCHEMA_VIOLATION\",\n \"OUTPUT.FORMAT.TRUNCATED\",\n \"OUTPUT.QUALITY.INCOMPLETE\",\n \"OUTPUT.QUALITY.IRRELEVANT\",\n \"OUTPUT.QUALITY.REPETITIVE\",\n \"OUTPUT.QUALITY.UNCLEAR\",\n \"OUTPUT.QUALITY.VERBOSE\",\n \"OUTPUT.SAFETY.BIAS\",\n \"OUTPUT.SAFETY.COPYRIGHT\",\n \"OUTPUT.SAFETY.HARMFUL_CONTENT\",\n \"OUTPUT.SAFETY.PII_LEAK\",\n \"OUTPUT.SAFETY.POLICY_VIOLATION\",\n \"PERCEPTION.CONTEXT.CONFLICTING\",\n \"PERCEPTION.CONTEXT.IRRELEVANT\",\n \"PERCEPTION.CONTEXT.MISSING\",\n \"PERCEPTION.CONTEXT.OVERFLOW\",\n \"PERCEPTION.CONTEXT.STALE\",\n \"PERCEPTION.INPUT.ENCODING\",\n \"PERCEPTION.INPUT.INJECTION\",\n \"PERCEPTION.INPUT.MALFORMED\",\n \"PERCEPTION.INPUT.SCHEMA_MISMATCH\",\n \"PERCEPTION.INPUT.TRUNCATED\",\n \"PERCEPTION.PARSING.DATE_FORMAT\",\n \"PERCEPTION.PARSING.JSON_INVALID\",\n \"PERCEPTION.PARSING.NUMBER_FORMAT\",\n \"PERCEPTION.PARSING.REFERENCE_BROKEN\",\n \"PERCEPTION.PARSING.XML_INVALID\",\n \"REASONING.DECISION.BIASED\",\n \"REASONING.DECISION.INDECISIVE\",\n \"REASONING.DECISION.OSCILLATING\",\n \"REASONING.DECISION.OVERCONFIDENT\",\n \"REASONING.DECISION.PREMATURE\",\n \"REASONING.HALLUCINATION.CAPABILITY\",\n \"REASONING.HALLUCINATION.CITATION\",\n \"REASONING.HALLUCINATION.ENTITY\",\n \"REASONING.HALLUCINATION.FACTUAL\",\n \"REASONING.HALLUCINATION.TEMPORAL\",\n \"REASONING.LOGIC.CIRCULAR\",\n \"REASONING.LOGIC.CONTRADICTION\",\n \"REASONING.LOGIC.INCOMPLETE\",\n \"REASONING.LOGIC.INVALID_INFERENCE\",\n \"REASONING.LOGIC.MISSING_PREMISE\",\n \"REASONING.PLANNING.INCOMPLETE\",\n \"REASONING.PLANNING.INFEASIBLE\",\n \"REASONING.PLANNING.SCOPE_CREEP\",\n \"REASONING.PLANNING.SUBOPTIMAL\",\n \"REASONING.PLANNING.UNSAFE\",\n \"RESOURCES.ACCESS.DENIED\",\n \"RESOURCES.ACCESS.EXPIRED\",\n \"RESOURCES.ACCESS.LOCKED\",\n \"RESOURCES.ACCESS.NOT_FOUND\",\n \"RESOURCES.ACCESS.REVOKED\",\n \"RESOURCES.CONTENTION.DEADLOCK\",\n \"RESOURCES.CONTENTION.OVERFLOW\",\n \"RESOURCES.CONTENTION.PRIORITY_INVERSION\",\n \"RESOURCES.CONTENTION.STARVATION\",\n \"RESOURCES.CONTENTION.THRASHING\",\n \"RESOURCES.QUOTA.ALLOCATION_FAILED\",\n \"RESOURCES.QUOTA.EXCEEDED\",\n \"RESOURCES.QUOTA.LEAK\",\n \"RESOURCES.QUOTA.STALE\",\n \"RESOURCES.QUOTA.UNFAIR_DISTRIBUTION\",\n \"TOOL.EXECUTION.CRASHED\",\n \"TOOL.EXECUTION.DEPENDENCY_FAILED\",\n \"TOOL.EXECUTION.RATE_LIMITED\",\n \"TOOL.EXECUTION.RESOURCE_EXHAUSTED\",\n \"TOOL.EXECUTION.TIMEOUT\",\n \"TOOL.INVOCATION.INVALID_ARGS\",\n \"TOOL.INVOCATION.MISSING_REQUIRED\",\n \"TOOL.INVOCATION.NOT_FOUND\",\n \"TOOL.INVOCATION.PERMISSION_DENIED\",\n \"TOOL.INVOCATION.TYPE_MISMATCH\",\n \"TOOL.RESULT.EMPTY\",\n \"TOOL.RESULT.ERROR_IN_RESULT\",\n \"TOOL.RESULT.PARTIAL\",\n \"TOOL.RESULT.UNEXPECTED_FORMAT\",\n \"TOOL.RESULT.UNPARSEABLE\",\n]);\n\nexport interface TaxonomyRule {\n re: RegExp;\n code: string;\n}\n\n/**\n * risicare-core's keyword rules (`classify_error`). Python applies them FIRST,\n * to the lowercased message only. Order matters: first match wins.\n */\nexport const CORE_RULES: readonly TaxonomyRule[] = [\n { re: new RegExp(\"json\", 'u'), code: \"PERCEPTION.PARSING.JSON_INVALID\" },\n { re: new RegExp(\"encoding\", 'u'), code: \"PERCEPTION.INPUT.ENCODING\" },\n { re: new RegExp(\"injection\", 'u'), code: \"PERCEPTION.INPUT.INJECTION\" },\n { re: new RegExp(\"malformed\", 'u'), code: \"PERCEPTION.INPUT.MALFORMED\" },\n { re: new RegExp(\"hallucin\", 'u'), code: \"REASONING.HALLUCINATION.FACTUAL\" },\n { re: new RegExp(\"contradict\", 'u'), code: \"REASONING.LOGIC.CONTRADICTION\" },\n { re: new RegExp(\"timeout\", 'u'), code: \"TOOL.EXECUTION.TIMEOUT\" },\n { re: new RegExp(\"rate[^\\\\n]?limit\", 'u'), code: \"TOOL.EXECUTION.RATE_LIMITED\" },\n { re: new RegExp(\"permission\", 'u'), code: \"TOOL.INVOCATION.PERMISSION_DENIED\" },\n { re: new RegExp(\"context[^\\\\n]+overflow\", 'u'), code: \"MEMORY.CONTEXT_WINDOW.EXCEEDED\" },\n { re: new RegExp(\"state[^\\\\n]+corrupt\", 'u'), code: \"MEMORY.STATE.CORRUPTED\" },\n { re: new RegExp(\"pii\", 'u'), code: \"OUTPUT.SAFETY.PII_LEAK\" },\n { re: new RegExp(\"deadlock\", 'u'), code: \"COORDINATION.WORKFLOW.DEADLOCK\" },\n { re: new RegExp(\"undeliverable\", 'u'), code: \"COMMUNICATION.DELIVERY.UNDELIVERABLE\" },\n { re: new RegExp(\"crash\", 'u'), code: \"ORCHESTRATION.LIFECYCLE.CRASHED\" },\n { re: new RegExp(\"quorum\", 'u'), code: \"CONSENSUS.AGREEMENT.QUORUM_FAILED\" },\n { re: new RegExp(\"quota[^\\\\n]+exceed\", 'u'), code: \"RESOURCES.QUOTA.EXCEEDED\" },\n];\n\n/** Order matters: first match wins, most specific first. */\nexport const SUPPLEMENTAL_RULES: readonly TaxonomyRule[] = [\n { re: new RegExp(\"timeout|timedout|aborted\", 'u'), code: \"TOOL.EXECUTION.TIMEOUT\" },\n { re: new RegExp(\"rate[^\\\\n]?limit|(?<![\\\\p{L}\\\\p{N}_])429(?![\\\\p{L}\\\\p{N}_])|too many requests\", 'u'), code: \"TOOL.EXECUTION.RATE_LIMITED\" },\n { re: new RegExp(\"connection|econnrefused|econnreset|enotfound|fetch failed|unreachable|broken pipe\", 'u'), code: \"TOOL.EXECUTION.DEPENDENCY_FAILED\" },\n { re: new RegExp(\"(?<![\\\\p{L}\\\\p{N}_])auth|unauthorized|forbidden|permission|(?<![\\\\p{L}\\\\p{N}_])401(?![\\\\p{L}\\\\p{N}_])|(?<![\\\\p{L}\\\\p{N}_])403(?![\\\\p{L}\\\\p{N}_])\", 'u'), code: \"TOOL.INVOCATION.PERMISSION_DENIED\" },\n { re: new RegExp(\"json|syntaxerror|unexpected token|decodeerror\", 'u'), code: \"PERCEPTION.PARSING.JSON_INVALID\" },\n];\n\nexport const GENERIC_FALLBACK = \"TOOL.EXECUTION.CRASHED\";\n","/**\n * Fix Interceptors — Hook into LLM/tool calls to apply fixes.\n *\n * FixRuntime is off by default. During the beta, the Risicare service does not\n * give fixes to customer projects, so FixRuntime has no effect for them.\n *\n * The interceptor enforces guard fixes only on the paths that call it:\n * `interceptCall` and `interceptResponse` on `FixRuntime`, and the OpenAI chat\n * patch (input guards only). Three interception points:\n * - preCall: Before the LLM/tool call. Input guards always; prompt,\n * parameter and fallback fixes only when the context has an\n * `errorCode`. The provider path supplies none, so it does not\n * apply them.\n * - postCall: After the call (output guard validation)\n * - onError: When an error occurs (retry/fallback decisions)\n *\n * Port of Python SDK's runtime/interceptors.py adapted for Node.js.\n */\n\nimport type { ApplyResult } from './applier.js';\nimport { FixApplier } from './applier.js';\nimport type { FixCache } from './cache.js';\nimport type { FixRuntimeConfig } from './config.js';\nimport { resolveFixRuntimeConfig } from './config.js';\nimport { debug, warn } from '../utils/log.js';\nimport {\n CANONICAL_ERROR_CODES,\n CORE_RULES,\n GENERIC_FALLBACK,\n SUPPLEMENTAL_RULES,\n} from './taxonomy.generated.js';\n\n// ─── Guard Rejection ────────────────────────────────────────────────────────\n\n/**\n * Thrown by the fix interceptor when a guard fix returns `passed: false`.\n *\n * PR-4+5 review B2 (2026-05-25): pre-fix, `applyGuardFix` returned\n * `passed:false` correctly but no caller read `passed` — the provider\n * patcher consumed `result.messages` / `result.params` and proceeded to the\n * LLM with the attacker payload anyway. The `fail-CLOSED` was advisory only.\n *\n * Now the interceptor THROWS this error on both pre-call and post-call\n * guard rejection. The OpenAI patcher calls the interceptor BEFORE it starts\n * the LLM span and re-throws this error, so the customer sees a\n * `GuardRejectedError` propagated out of their `openai.chat.completions.create`\n * call, and the LLM does not receive the call. No span records the rejection.\n *\n * Customers who want to handle rejection gracefully can:\n * try { await openai.chat.completions.create({ ... }); }\n * catch (e) {\n * if (e instanceof GuardRejectedError) { ... fallback ... }\n * else throw e;\n * }\n */\nexport class GuardRejectedError extends Error {\n public readonly guardId: string;\n public readonly reason: string;\n public readonly phase: 'pre_call' | 'post_call';\n\n constructor(guardId: string, reason: string, phase: 'pre_call' | 'post_call') {\n super(`Risicare guard rejected operation: ${guardId} (${phase}) — ${reason}`);\n this.name = 'GuardRejectedError';\n this.guardId = guardId;\n this.reason = reason;\n this.phase = phase;\n }\n}\n\n/**\n * Return the text that the input guards check, or null to skip the message.\n *\n * A non-empty string is checked as it is. For a list of parts, the `text` of\n * the parts whose `type` is `\"text\"` is joined with newlines. A message with\n * no `content`, `null`, an empty string or no text part has no text, so the\n * guards skip it. Python twin: `_guard_text` in `runtime/interceptors.py`.\n */\nfunction guardText(message: unknown): string | null {\n if (!message || typeof message !== 'object') return null;\n const content = (message as Record<string, unknown>).content;\n if (typeof content === 'string') return content === '' ? null : content;\n if (Array.isArray(content)) {\n const texts = content\n .filter((p): p is Record<string, unknown> =>\n !!p && typeof p === 'object' && (p as Record<string, unknown>).type === 'text' &&\n typeof (p as Record<string, unknown>).text === 'string')\n .map((p) => p.text as string);\n if (texts.length > 0) return texts.join('\\n');\n }\n return null;\n}\n\n// ─── Intercept Context ──────────────────────────────────────────────────────\n\nexport interface InterceptContext {\n /** Type of operation: \"llm_call\", \"tool_call\", \"agent_delegate\" */\n operationType: string;\n\n /** Name of the operation: model name, tool name, agent name */\n operationName: string;\n\n /** Session ID for A/B testing bucketing */\n sessionId?: string;\n\n /** Trace ID for correlation */\n traceId?: string;\n\n /** Error code (set when retrying after error) */\n errorCode?: string;\n\n /** Error message (set when retrying after error) */\n errorMessage?: string;\n\n /** Current attempt number (1-based) */\n attempt: number;\n\n /** Fixes applied during this intercept lifecycle */\n appliedFixes: ApplyResult[];\n}\n\n/** Create a fresh InterceptContext. */\nexport function createInterceptContext(\n operationType: string,\n operationName: string,\n options?: {\n sessionId?: string;\n traceId?: string;\n errorCode?: string;\n },\n): InterceptContext {\n return {\n operationType,\n operationName,\n sessionId: options?.sessionId,\n traceId: options?.traceId,\n errorCode: options?.errorCode,\n attempt: 1,\n appliedFixes: [],\n };\n}\n\n// ─── Interceptor Interface ──────────────────────────────────────────────────\n\nexport interface FixInterceptor {\n /**\n * Called before an LLM/tool call.\n * Returns modified messages and params.\n */\n preCall(\n ctx: InterceptContext,\n messages: unknown[] | null,\n params: Record<string, unknown>,\n ): { messages: unknown[] | null; params: Record<string, unknown> };\n\n /**\n * Called after an LLM/tool call.\n * Returns modified response and whether to continue.\n */\n postCall(\n ctx: InterceptContext,\n response: unknown,\n ): { response: unknown; shouldContinue: boolean };\n\n /**\n * Called when an error occurs.\n * Returns whether to retry and optional modified params.\n */\n onError(\n ctx: InterceptContext,\n error: Error,\n ): { shouldRetry: boolean; modifiedParams: Record<string, unknown> | null };\n}\n\n// ─── Default Fix Interceptor ────────────────────────────────────────────────\n\nexport class DefaultFixInterceptor implements FixInterceptor {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n private readonly _applier: FixApplier;\n\n constructor(config: FixRuntimeConfig, cache: FixCache, applier: FixApplier) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = cache;\n this._applier = applier;\n }\n\n /**\n * Apply pre-call fixes.\n *\n * - If retrying after error: look up fix by error_code, apply\n * prompt/parameter/fallback fixes\n * - Runs input guard fixes on all message content\n */\n preCall(\n ctx: InterceptContext,\n messages: unknown[] | null,\n params: Record<string, unknown>,\n ): { messages: unknown[] | null; params: Record<string, unknown> } {\n try {\n if (!this._config.enabled) {\n return { messages, params };\n }\n\n let modifiedMessages = messages;\n let modifiedParams = { ...params };\n\n // If retrying after error, check for applicable fixes\n if (ctx.errorCode) {\n const fix = this._applier.getFixForError(ctx.errorCode, ctx.sessionId);\n\n if (fix) {\n debug(`Applying fix ${fix.fixId} for ${ctx.errorCode}`);\n\n if (fix.fixType === 'prompt' && messages) {\n const msgRecords = messages as Record<string, unknown>[];\n const { messages: newMessages, result } =\n this._applier.applyPromptFix(fix, msgRecords);\n modifiedMessages = newMessages;\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n } else if (fix.fixType === 'parameter') {\n const { params: newParams, result } =\n this._applier.applyParameterFix(fix, modifiedParams);\n modifiedParams = newParams;\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n } else if (fix.fixType === 'fallback') {\n const { params: newParams, result } =\n this._applier.applyFallbackFix(fix, modifiedParams);\n modifiedParams = newParams;\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n }\n }\n }\n\n // Apply input guard fixes on all message content.\n // PR-4+5 review B2: when a guard returns passed:false (including the\n // F-731 fail-CLOSED-on-exception path), THROW a GuardRejectedError so\n // the provider patcher short-circuits BEFORE invoking the LLM. The\n // outer try/catch below explicitly re-raises GuardRejectedError so\n // the swallow-and-degrade behaviour for OTHER errors does NOT apply\n // to safety rejections.\n if (modifiedMessages && this._config.enabled) {\n // Only messages with text content are checked (see guardText): a\n // tool-call message has none.\n for (const msg of modifiedMessages as unknown[]) {\n const content = guardText(msg);\n if (content !== null) {\n for (const fix of this._cache.getAll()) {\n if (fix.fixType === 'guard') {\n const { passed, result } = this._applier.applyGuardFix(\n fix,\n content,\n true,\n );\n if (result.applied) {\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n }\n if (!passed) {\n throw new GuardRejectedError(\n fix.fixId ?? 'unknown',\n result.reason ?? 'guard rejected input',\n 'pre_call',\n );\n }\n }\n }\n }\n }\n }\n\n return { messages: modifiedMessages, params: modifiedParams };\n } catch (e) {\n // PR-4+5 review B2: GuardRejectedError MUST propagate. The catch\n // below exists for unrelated failures (e.g., cache lookup explosion)\n // where degrading to the unmodified call is correct — but a safety\n // rejection MUST abort the LLM call, not silently let it through.\n if (e instanceof GuardRejectedError) throw e;\n debug(`DefaultFixInterceptor.preCall error: ${e}`);\n return { messages, params };\n }\n }\n\n /**\n * Apply post-call fixes (output validation).\n *\n * Runs output guard fixes on response content.\n */\n postCall(\n ctx: InterceptContext,\n response: unknown,\n ): { response: unknown; shouldContinue: boolean } {\n try {\n if (!this._config.enabled) {\n return { response, shouldContinue: true };\n }\n\n for (const fix of this._cache.getAll()) {\n if (fix.fixType !== 'guard') continue;\n\n const content = this._extractResponseContent(response);\n if (!content) continue;\n\n const { passed, result } = this._applier.applyGuardFix(\n fix,\n content,\n false,\n );\n\n if (result.applied) {\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n }\n\n if (!passed) {\n // PR-4+5 review B2: output guard failure must NOT be a warn-only\n // signal. Pre-fix the caller received the unredacted LLM response\n // alongside shouldContinue:true — the rejection was advisory only.\n // Now we throw GuardRejectedError so the caller surfaces the\n // safety violation to the customer instead of returning a payload\n // an output filter said is unsafe to emit.\n warn(`Output guard failed for fix ${fix.fixId}: ${result.reason ?? 'unknown'}`);\n throw new GuardRejectedError(\n fix.fixId ?? 'unknown',\n result.reason ?? 'guard rejected output',\n 'post_call',\n );\n }\n }\n\n return { response, shouldContinue: true };\n } catch (e) {\n // PR-4+5 review B2: GuardRejectedError MUST propagate (see preCall).\n if (e instanceof GuardRejectedError) throw e;\n debug(`DefaultFixInterceptor.postCall error: ${e}`);\n return { response, shouldContinue: true };\n }\n }\n\n /**\n * Handle errors and decide whether to retry.\n *\n * Classifies the error, looks up retry/fallback fixes, and returns\n * whether the caller should retry.\n */\n onError(\n ctx: InterceptContext,\n error: Error,\n ): { shouldRetry: boolean; modifiedParams: Record<string, unknown> | null } {\n try {\n if (!this._config.enabled) {\n return { shouldRetry: false, modifiedParams: null };\n }\n\n // Classify the error\n const errorCode = classifyError(error);\n ctx.errorCode = errorCode;\n ctx.errorMessage = error.message;\n\n // Check for retry fix\n const fix = this._applier.getFixForError(errorCode, ctx.sessionId);\n if (!fix) {\n return { shouldRetry: false, modifiedParams: null };\n }\n\n if (fix.fixType === 'retry') {\n const maxRetries = (fix.config.max_retries ?? fix.config.maxRetries ?? 3) as number;\n\n if (ctx.attempt <= maxRetries) {\n debug(\n `Retry fix ${fix.fixId}: attempt ${ctx.attempt}/${maxRetries}`,\n );\n\n const result: ApplyResult = {\n applied: true,\n fixId: fix.fixId,\n deploymentId: fix.deploymentId,\n fixType: 'retry',\n modifications: { attempt: ctx.attempt },\n };\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n\n return { shouldRetry: true, modifiedParams: null };\n }\n }\n\n // Check for fallback fix\n if (fix.fixType === 'fallback') {\n const { params: modifiedParams, result } =\n this._applier.applyFallbackFix(fix, {});\n if (result.applied) {\n ctx.appliedFixes.push(result);\n this._applier.logApplication(result);\n return { shouldRetry: true, modifiedParams };\n }\n }\n\n return { shouldRetry: false, modifiedParams: null };\n } catch (e) {\n debug(`DefaultFixInterceptor.onError error: ${e}`);\n return { shouldRetry: false, modifiedParams: null };\n }\n }\n\n // ─── Private ────────────────────────────────────────────────────────────\n\n /** Extract text content from a response object. */\n private _extractResponseContent(response: unknown): string | null {\n if (typeof response === 'string') return response;\n\n if (response && typeof response === 'object') {\n const resp = response as Record<string, unknown>;\n\n // OpenAI-style response: { choices: [{ message: { content: \"...\" } }] }\n const choices = resp.choices as unknown[];\n if (Array.isArray(choices) && choices.length > 0) {\n const first = choices[0] as Record<string, unknown>;\n const message = first?.message as Record<string, unknown>;\n if (typeof message?.content === 'string') {\n return message.content;\n }\n }\n\n // Anthropic-style response: { content: [{ text: \"...\" }] }\n const content = resp.content;\n if (typeof content === 'string') return content;\n if (Array.isArray(content) && content.length > 0) {\n const first = content[0] as Record<string, unknown>;\n if (typeof first?.text === 'string') return first.text;\n }\n }\n\n return null;\n }\n}\n\n// ─── Error Classification ───────────────────────────────────────────────────\n\n/**\n * Classify an error into a canonical taxonomy code with the steps the Python\n * SDK uses. First, risicare-core's keyword rules on the lowercased message.\n * Then the supplemental rules on the lowercased error name and message. Then\n * GENERIC_FALLBACK. The two SDKs give the same code on every row of the shared\n * fixture (packages/risicare-sdk/tests/fixtures/error-code-parity.json).\n * Known difference: a character that only the newer Unicode version of one\n * engine knows can lowercase or count as a word character differently.\n */\nexport function classifyError(error: Error): string {\n // F-SDKTAXFORK-001 — this used to be a private six-code vocabulary of which\n // exactly ONE code existed in the canonical 154-code taxonomy (measured\n // 2026-08-17: RATE_LIMIT vs canonical RATE_LIMITED, JSON_INVALID vs\n // INVALID_JSON, and three with no canonical sibling at all). The Python SDK\n // carried a byte-identical fork of the same wrong set.\n //\n // The supplemental rules and the canonical code set come from\n // packages/risicare-sdk/src/risicare/runtime/_error_taxonomy.py, and core's\n // keyword rules from risicare_core/taxonomy.py (_KEYWORD_RULES). All are\n // GENERATED into ./taxonomy.generated.ts, because `risicare-core` is not on\n // npm and this SDK cannot import the taxonomy directly. Drift is caught by\n // `just taxonomy` (gen_js_taxonomy.py --check). That check reads the\n // generated file, the rule tables and the shared fixture, and runs a PYTHON\n // copy of these steps. It does not run TypeScript. The test of this\n // function is tests/error-code-parity.test.ts, on the same fixture.\n //\n // Every code below is checked against CANONICAL_ERROR_CODES before it is\n // returned, so an invented code cannot reach the wire even if this file and\n // the generator ever disagree.\n\n // 1. risicare-core's keyword rules, as Python's `classify` consults\n // `risicare_core.taxonomy.classify_error` first. Core reads the message\n // only, lowercased, never the error name.\n const message = String(error?.message ?? '').toLowerCase();\n for (const rule of CORE_RULES) {\n if (rule.re.test(message)) {\n return CANONICAL_ERROR_CODES.has(rule.code) ? rule.code : GENERIC_FALLBACK;\n }\n }\n\n // 2. The supplemental rules, on the error name and the message, lowercased\n // as Python lowercases them. The rules have no case flag.\n const haystack = `${error?.constructor?.name ?? 'Error'} ${String(error?.message ?? '')}`.toLowerCase();\n\n for (const rule of SUPPLEMENTAL_RULES) {\n // RegExp objects carry lastIndex state only with /g; these are built\n // without it, so .test() is safe to reuse across calls.\n if (rule.re.test(haystack)) {\n return CANONICAL_ERROR_CODES.has(rule.code) ? rule.code : GENERIC_FALLBACK;\n }\n }\n\n return CANONICAL_ERROR_CODES.has(GENERIC_FALLBACK) ? GENERIC_FALLBACK : '';\n}\n","/**\n * AsyncLocalStorage-based context propagation.\n *\n * Uses a single AsyncLocalStorage instance with a composite state object.\n * This is simpler and more performant than multiple separate stores.\n *\n * Node.js AsyncLocalStorage automatically propagates through:\n * - Promise / async-await\n * - setTimeout / setImmediate\n * - EventEmitter callbacks\n * - process.nextTick\n * - async generators (unlike Python's contextvars!)\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport type { Span } from '../span.js';\nimport type { SemanticPhase } from '../types.js';\nimport { getContextStorage } from '../globals.js';\n\n// ─── Context Types ───────────────────────────────────────────────────────────\n\nexport interface SessionContext {\n sessionId: string;\n userId?: string;\n metadata?: Record<string, unknown>;\n parentSessionId?: string;\n turnNumber?: number;\n}\n\nexport interface AgentContext {\n agentId: string;\n agentName?: string;\n agentRole?: string;\n agentType?: string;\n parentAgentId?: string;\n version?: number;\n metadata?: Record<string, unknown>;\n}\n\nexport interface ContextState {\n session?: SessionContext;\n agent?: AgentContext;\n span?: Span;\n phase?: SemanticPhase;\n /** When true, provider instrumentors skip span creation (framework is handling it). */\n _suppressProviderInstrumentation?: boolean;\n /**\n * Pre-allocated trace ID from getTraceContext() when no span exists yet.\n * Ensures that getTraceContext().traceId matches the next span created\n * in this context — preventing the \"trace ID mismatch\" bug.\n */\n _rootTraceId?: string;\n /**\n * F-SDKSAMPORPHAN-001 — the trace's head-sampling decision, recorded ONLY\n * when it was `false`.\n *\n * A dropped root creates no Span, so `span` above stays undefined and every\n * nested call looks like a fresh root to the tracer. Without this flag it\n * re-rolls its own decision and the half that passes is delivered as a\n * root — a trace that never existed. This is the only carrier of \"you are\n * inside a trace we already decided to drop\".\n *\n * Scoped by runWithContext(), so unlike Python's ContextVar token it cannot\n * leak past the callback that set it.\n */\n _traceSampled?: boolean;\n}\n\n// ─── Storage Accessor ────────────────────────────────────────────────────────\n\nfunction storage(): AsyncLocalStorage<ContextState> {\n return getContextStorage() as AsyncLocalStorage<ContextState>;\n}\n\n// ─── Core Operations ─────────────────────────────────────────────────────────\n\n/**\n * Get the current context state, or empty object if outside any context.\n */\nexport function getContext(): ContextState {\n return storage().getStore() ?? {};\n}\n\n/**\n * True when the caller runs inside a context scope (an async-local store\n * exists), even if that scope has no session, agent or span.\n */\nexport function hasContextScope(): boolean {\n return storage().getStore() !== undefined;\n}\n\n/**\n * Run a callback within a new context scope.\n * The new scope inherits from the parent, with overrides applied.\n */\nexport function runWithContext<T>(overrides: Partial<ContextState>, fn: () => T): T {\n const parent = getContext();\n const merged: ContextState = { ...parent, ...overrides };\n return storage().run(merged, fn);\n}\n\n/**\n * Run an async callback within a new context scope.\n */\nexport function runWithContextAsync<T>(overrides: Partial<ContextState>, fn: () => Promise<T>): Promise<T> {\n const parent = getContext();\n const merged: ContextState = { ...parent, ...overrides };\n return storage().run(merged, fn);\n}\n\n// ─── Context Accessors ───────────────────────────────────────────────────────\n\nexport function getCurrentSession(): SessionContext | undefined {\n return getContext().session;\n}\n\nexport function getCurrentAgent(): AgentContext | undefined {\n return getContext().agent;\n}\n\nexport function getCurrentSpan(): Span | undefined {\n return getContext().span;\n}\n\nexport function getCurrentPhase(): SemanticPhase | undefined {\n return getContext().phase;\n}\n\nexport function getCurrentSessionId(): string | undefined {\n return getContext().session?.sessionId;\n}\n\nexport function getCurrentAgentId(): string | undefined {\n return getContext().agent?.agentId;\n}\n\nexport function getCurrentTraceId(): string | undefined {\n return getContext().span?.traceId;\n}\n\nexport function getCurrentSpanId(): string | undefined {\n return getContext().span?.spanId;\n}\n\nexport function getCurrentParentSpanId(): string | undefined {\n return getContext().span?.parentSpanId;\n}\n\n/**\n * A plain-object snapshot of the current context, as `getCurrentContext()`\n * returns it. `session`, `agent` and `span` are `null` when not set.\n *\n * This is a type alias, not an interface, so that a value of this type is\n * still assignable to `Record<string, unknown>` (the return type through 0.7.1).\n * `getCurrentContext()` returns it joined with `Record<string, unknown>`, so\n * code that writes or reads other keys still compiles.\n */\nexport type ContextSnapshot = {\n session: {\n sessionId: string;\n userId?: string;\n parentSessionId?: string;\n turnNumber?: number;\n metadata?: Record<string, unknown>;\n } | null;\n agent: {\n agentId: string;\n agentName?: string;\n agentRole?: string;\n agentType?: string;\n parentAgentId?: string;\n version?: number;\n metadata?: Record<string, unknown>;\n } | null;\n span: { spanId: string; traceId: string } | null;\n phase: SemanticPhase | null;\n};\n\n/**\n * Get all current context as a plain object (for debugging/serialization).\n */\nexport function getCurrentContext(): ContextSnapshot & Record<string, unknown> {\n const ctx = getContext();\n return {\n session: ctx.session ? {\n sessionId: ctx.session.sessionId,\n userId: ctx.session.userId,\n ...(ctx.session.parentSessionId !== undefined ? { parentSessionId: ctx.session.parentSessionId } : {}),\n ...(ctx.session.turnNumber !== undefined ? { turnNumber: ctx.session.turnNumber } : {}),\n ...(ctx.session.metadata !== undefined ? { metadata: ctx.session.metadata } : {}),\n } : null,\n agent: ctx.agent ? {\n agentId: ctx.agent.agentId,\n agentName: ctx.agent.agentName,\n agentRole: ctx.agent.agentRole,\n agentType: ctx.agent.agentType,\n ...(ctx.agent.parentAgentId !== undefined ? { parentAgentId: ctx.agent.parentAgentId } : {}),\n ...(ctx.agent.version !== undefined ? { version: ctx.agent.version } : {}),\n ...(ctx.agent.metadata !== undefined ? { metadata: ctx.agent.metadata } : {}),\n } : null,\n span: ctx.span ? { spanId: ctx.span.spanId, traceId: ctx.span.traceId } : null,\n phase: ctx.phase ?? null,\n };\n}\n","/**\n * Tracer — creates spans with automatic context nesting.\n *\n * The Tracer is the primary API for creating spans. It automatically:\n * - Links child spans to parent spans via parentSpanId\n * - Propagates the trace ID from the active context\n * - Injects session/agent/phase context into new spans\n * - Runs the callback within the span's context scope\n *\n * Usage:\n * const tracer = new Tracer(processor);\n * await tracer.startSpan('my-operation', async (span) => {\n * span.setAttribute('key', 'value');\n * // Nested spans automatically become children\n * await tracer.startSpan('sub-op', async (child) => { ... });\n * });\n */\n\nimport { Span, type SpanOptions, type SpanEndCallback } from './span.js';\nimport { NOOP_SPAN } from './noop.js';\nimport { SpanKind } from './types.js';\nimport { generateTraceId } from './ids.js';\nimport { shouldSample } from './utils/sampling.js';\nimport { classifyError } from './runtime/interceptors.js';\nimport {\n runWithContext,\n getContext,\n getCurrentSpan,\n getCurrentSession,\n getCurrentAgent,\n getCurrentPhase,\n} from './context/storage.js';\n\n// ─── Types ──────────────────────────────────────────────────────────────────\n\nexport interface StartSpanOptions {\n name: string;\n kind?: SpanKind;\n attributes?: Record<string, unknown>;\n /** Override trace ID (default: inherit from parent or generate new) */\n traceId?: string;\n /** Override parent span ID (default: current span in context) */\n parentSpanId?: string;\n}\n\nexport interface TracerConfig {\n /** Called when a span ends (typically feeds into batch processor) */\n onSpanEnd: SpanEndCallback;\n /** Sample rate 0.0–1.0 (default: 1.0) */\n sampleRate?: number;\n /** Whether tracing is enabled */\n enabled?: boolean;\n /**\n * Whether prompt/completion content may leave the process (default: false).\n *\n * ⚠ The Tracer only CARRIES this for the provider patches to read via\n * `getTraceContent()`. It is NOT the enforcement point — the gate runs in the\n * batch processor, which is the one place both content paths cross. See\n * `masking.ts` `stripContent`.\n */\n traceContent?: boolean;\n /**\n * Service name, emitted as the OTel `service.name` span attribute.\n *\n * ⚠ F-SDKJSSVCNAME-001. `serviceName` was accepted by `init()`, typed in\n * `RisicareConfig`, documented, and recommended over the deprecated\n * `projectId` — and reached the wire NOWHERE. Measured on the published\n * 0.5.0: `serviceName: 'X'` at init, `X` absent from every request body,\n * while a sibling control attribute in the same span arrived. Python has\n * always emitted it (`tracer.py`, `service.name`); this makes JS match.\n */\n serviceName?: string;\n /**\n * Service version, emitted as `service.version`.\n *\n * ⚠ Was dropped by BOTH SDKs — same defect one field over, measured in the\n * same run. Unlike `service.name` it is NOT suppressed under an agent: a\n * version is a property of the deployed code, not of which agent owns the\n * span.\n */\n serviceVersion?: string;\n}\n\n/**\n * F-SDKTAXFORK-001 — attach the canonical taxonomy code to EVERY errored span,\n * whether or not a fix was applied.\n *\n * ⚠ The \"whether or not\" clause is the load-bearing one.\n * `risicare.fix.error_code` is written only inside the branch that also sets\n * `risicare.fix.applied` (providers/openai/patch.ts), so a span carrying an\n * error code has ALWAYS had a non-empty fix_applied — which makes the A/B\n * CONTROL predicate `fix_applied = '' AND error_code = X` unsatisfiable by\n * algebra, not merely empty. Emitting here is what makes that cohort populable.\n *\n * The worker already reads this key and has since before any producer existed\n * (`spans_worker.py:3744` — `risicare.fix.error_code` OR `error.code`; its own\n * comment calls it \"generic taxonomy code attached by any error\"). This is\n * attribute-first per .claude/rules/schema-contract.md: no gateway or worker\n * change is required.\n *\n * Guarded throughout: classification must never replace the customer's own\n * exception with ours, and must never write an empty attribute.\n */\nexport function attachErrorCode(span: Span, error: unknown): void {\n try {\n // A thrown value that is not an Error: use its own `message` when it is a\n // string (for example a thrown `{ message: '...' }`), else its text.\n const ownMessage =\n error !== null && typeof error === 'object' ? (error as { message?: unknown }).message : undefined;\n const err =\n error instanceof Error\n ? error\n : new Error(typeof ownMessage === 'string' ? ownMessage : String(error));\n const code = classifyError(err);\n if (code) {\n span.setAttribute('error.code', code);\n }\n } catch {\n /* never let attribution break the customer's error path */\n }\n}\n\n// ─── Tracer Class ───────────────────────────────────────────────────────────\n\nexport class Tracer {\n private _onSpanEnd: SpanEndCallback;\n private _sampleRate: number;\n private _enabled: boolean;\n private _traceContent: boolean;\n private _serviceName: string | undefined;\n private _serviceVersion: string | undefined;\n\n constructor(config: TracerConfig) {\n this._onSpanEnd = config.onSpanEnd;\n this._sampleRate = config.sampleRate ?? 1.0;\n this._enabled = config.enabled ?? true;\n this._traceContent = config.traceContent ?? false;\n // Empty string is what `resolveConfig` uses for \"unset\" — treat it as unset\n // rather than emitting `service.name: \"\"`, which is worse than absent.\n this._serviceName = config.serviceName || undefined;\n this._serviceVersion = config.serviceVersion || undefined;\n }\n\n get enabled(): boolean {\n return this._enabled;\n }\n\n set enabled(value: boolean) {\n this._enabled = value;\n }\n\n get traceContent(): boolean {\n return this._traceContent;\n }\n\n /**\n * Start a span, run the callback within its context, and auto-end on completion.\n *\n * The span is automatically:\n * - Linked to the current parent span (if any)\n * - Given the current trace ID (or a new one for root spans)\n * - Enriched with session/agent/phase context\n * - Ended when the callback returns (or throws)\n * - Marked as ERROR if the callback throws\n *\n * @returns The callback's return value\n */\n startSpan<T>(options: StartSpanOptions | string, fn: (span: Span) => T): T {\n const opts = typeof options === 'string' ? { name: options } : options;\n\n // Fast path: disabled SDK\n if (!this._enabled) {\n return fn(NOOP_SPAN as unknown as Span);\n }\n\n // Resolve context\n const parentSpan = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n const phase = getCurrentPhase();\n\n // Determine trace ID: explicit > parent > pre-allocated (from getTraceContext) > new\n const ctx = getContext();\n const traceId = opts.traceId ?? parentSpan?.traceId ?? ctx._rootTraceId ?? generateTraceId();\n\n // Sampling: check once per trace (root span decides)\n //\n // F-SDKSAMPORPHAN-001 — CONSULT BEFORE ROLLING. A dropped root creates no\n // Span, so `getCurrentSpan()` stays undefined and every nested call\n // arrives here as though it were itself a root. Re-rolling there does not\n // subsample; it FABRICATES. Measured pre-fix from an installed 0.5.1\n // tarball, N=400 roots each wrapping one nested startSpan, sampleRate=0.5:\n // ESM 104 of 303 delivered traces (34.3%) and CJS 94 of 310 (30.3%)\n // contained no root span — they never existed as traces. Both arms at\n // sampleRate=1.0 fabricated 0 of 400.\n // ⚠ Downstream cannot repair this: the delivered count is N*r*(2-r), not\n // N*r, so scaling by 1/r overstates by 50% at r=0.5 and 90% at r=0.1.\n if (!parentSpan) {\n if (ctx._traceSampled === false) {\n return fn(NOOP_SPAN as unknown as Span);\n }\n if (this._sampleRate < 1.0 && !shouldSample(traceId, this._sampleRate)) {\n // Record the drop for the duration of the callback so nested calls\n // inherit it. runWithContext scopes the flag to exactly this callback,\n // so it cannot latch the way an un-reset ContextVar token can.\n return runWithContext({ _traceSampled: false }, () =>\n fn(NOOP_SPAN as unknown as Span),\n );\n }\n }\n\n // Parent span ID: explicit > current span in context\n const parentSpanId = opts.parentSpanId ?? parentSpan?.spanId;\n\n // Create the span\n const spanOptions: SpanOptions = {\n name: opts.name,\n kind: opts.kind ?? SpanKind.INTERNAL,\n traceId,\n parentSpanId,\n attributes: {\n ...opts.attributes,\n // Propagate context fields as attributes (matching Python SDK tracer.py:497-511)\n ...(agent?.agentRole ? { 'agent.role': agent.agentRole } : {}),\n ...(agent?.parentAgentId ? { 'parent_agent_id': agent.parentAgentId } : {}),\n ...(session?.userId ? { 'session.user_id': session.userId } : {}),\n // F-SDKJSSVCNAME-001 — `service.name` is suppressed when an agent\n // identity is present (the agent takes priority), matching Python;\n // `service.version` never is.\n ...(this._serviceName && !agent ? { 'service.name': this._serviceName } : {}),\n ...(this._serviceVersion ? { 'service.version': this._serviceVersion } : {}),\n },\n sessionId: session?.sessionId,\n agentId: agent?.agentId,\n agentName: agent?.agentName,\n agentType: agent?.agentType,\n semanticPhase: phase,\n };\n\n const span = new Span(spanOptions, this._onSpanEnd);\n\n // Run callback within span context\n try {\n const result = runWithContext({ span }, () => fn(span));\n\n // Handle async results (Promises)\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n span.end();\n return value;\n },\n (error) => {\n span.recordException(error instanceof Error ? error : String(error));\n attachErrorCode(span, error);\n markCancel(span, error);\n span.end();\n throw error;\n },\n ) as T;\n }\n\n // Sync: end span immediately\n span.end();\n return result;\n } catch (error) {\n // Sync error: record and re-throw\n span.recordException(error instanceof Error ? error : String(error));\n attachErrorCode(span, error);\n markCancel(span, error);\n span.end();\n throw error;\n }\n }\n\n /**\n * Create a span without auto-ending. Caller is responsible for calling span.end().\n *\n * Useful for long-running operations where you need manual control.\n * The span is still linked to context and enriched with session/agent/phase.\n */\n createSpan(options: StartSpanOptions | string): Span {\n const opts = typeof options === 'string' ? { name: options } : options;\n\n if (!this._enabled) {\n return NOOP_SPAN as unknown as Span;\n }\n\n const parentSpan = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n const phase = getCurrentPhase();\n\n // `_rootTraceId` as in startSpan(): a root span created here also uses the\n // trace id that getTraceContext() pre-allocated in this scope. The provider\n // patches create their spans here.\n const traceId = opts.traceId ?? parentSpan?.traceId ?? getContext()._rootTraceId ?? generateTraceId();\n\n // F-SDKSAMPORPHAN-001 — see the sibling site in startSpan(). Measured\n // pre-fix on this path (createSpan nested inside a startSpan root, the\n // streaming pattern), N=400, sampleRate=0.5: ESM 111 of 296 fabricated\n // (37.5%), CJS 105 of 294 (35.7%); both 0 of 400 at sampleRate=1.0.\n // ⚠ This site CONSULTS but does not RECORD: createSpan hands the span's\n // lifetime to the caller and owns no callback scope to unwind in, so\n // recording here would latch `_traceSampled` for the rest of the enclosing\n // context. Documented bound: a createSpan root that is itself dropped does\n // not suppress a re-roll by a following createSpan.\n if (!parentSpan) {\n if (getContext()._traceSampled === false) {\n return NOOP_SPAN as unknown as Span;\n }\n if (this._sampleRate < 1.0 && !shouldSample(traceId, this._sampleRate)) {\n return NOOP_SPAN as unknown as Span;\n }\n }\n\n const parentSpanId = opts.parentSpanId ?? parentSpan?.spanId;\n\n return new Span(\n {\n name: opts.name,\n kind: opts.kind ?? SpanKind.INTERNAL,\n traceId,\n parentSpanId,\n attributes: {\n ...opts.attributes,\n // Propagate context fields as attributes (matching Python SDK tracer.py:497-511)\n ...(agent?.agentRole ? { 'agent.role': agent.agentRole } : {}),\n ...(agent?.parentAgentId ? { 'parent_agent_id': agent.parentAgentId } : {}),\n ...(session?.userId ? { 'session.user_id': session.userId } : {}),\n // F-SDKJSSVCNAME-001 — see the sibling site above.\n ...(this._serviceName && !agent ? { 'service.name': this._serviceName } : {}),\n ...(this._serviceVersion ? { 'service.version': this._serviceVersion } : {}),\n },\n sessionId: session?.sessionId,\n agentId: agent?.agentId,\n agentName: agent?.agentName,\n agentType: agent?.agentType,\n semanticPhase: phase,\n },\n this._onSpanEnd,\n );\n }\n}\n\n/**\n * An aborted call (`AbortError`) keeps status error (0.7.0) and also gets the cancel\n * marker that the Python SDK writes for a cancel (RULING 2026-10-03).\n */\nfunction markCancel(span: Span, error: unknown): void {\n if (error instanceof Error && error.name === 'AbortError') {\n span.setAttribute('risicare.cancelled', true);\n span.setAttribute('risicare.cancel_type', 'AbortError');\n }\n}\n","/**\n * Single source of truth for the SDK version on the wire.\n *\n * F-720/F-351: prior to this file, two separate `SDK_VERSION` constants\n * existed in `exporters/http.ts` (\"0.1.1\") and `runtime/loader.ts` (\"0.1.3\"),\n * while `package.json` declared \"0.4.0\". Three different versions on the\n * wire confused customer telemetry and dashboard SDK-version-cohort filters.\n *\n * This file MUST stay in lock-step with the `version` field in\n * `packages/risicare-sdk-js/package.json`. Bumping the version is a\n * two-file edit (`package.json` + this file). The `prepublishOnly` script\n * verifies the match before any npm publish.\n *\n * Kept as a plain TS constant (not a runtime read of package.json) because:\n * 1. tsup bundles to ESM AND CJS for both Node and Edge; runtime fs\n * reads of package.json break in bundled-Edge environments.\n * 2. A constant inlines at tree-shake time, so no extra bytes shipped.\n * 3. The version is read in the hot path (every export); a static value\n * avoids per-call import-meta-resolve overhead.\n */\nexport const SDK_VERSION = '0.8.0';\n","/**\n * HTTP exporter for sending spans to the Risicare gateway.\n *\n * Uses native fetch (Node.js 18+), with:\n * - Automatic retry with exponential backoff\n * - Circuit breaker with half-open probe state\n * - Never follows a redirect; a 3xx or a 2xx without a Risicare ack is a FAILURE\n * - Gzip compression for large payloads\n * - Bearer token authentication\n */\n\nimport type { Span } from '../span.js';\nimport { ExportResult, type AckCounts, type SpanExporter } from './base.js';\nimport { debug, warn } from '../utils/log.js';\nimport { SDK_VERSION } from '../version.js';\nimport { hasCredentials, safeUrl, scrubText } from '../utils/scrub.js';\n\nexport interface HttpExporterOptions {\n endpoint: string;\n apiKey?: string;\n projectId?: string;\n environment?: string;\n timeoutMs?: number;\n maxRetries?: number;\n compress?: boolean;\n}\n\n/**\n * F-SDK503-001 · A CAPACITY REFUSAL IS NOT A SICK SERVER.\n *\n * ⚠ MEASURED ON THE PUBLISHED ARTEFACT (`risicare@0.5.0` from npm, clean install). The bundle\n * contains ZERO occurrences of `accepted`, one of `\"429\"` (which is TOOL-error classification,\n * not HTTP), and its export path is `if (response.status < 300) return SUCCESS` — so 429, 503\n * and 500 are byte-identical to it and `Retry-After` is never read. The Python twin measured\n * identically: `fix-workstream/perf/a3/sdk_python_refusal_probe.py`.\n *\n * ⚠ THE BREAKER IS THE DANGEROUS HALF. Five consecutive failing exports open it for 60 s, and\n * under sustained overload five refusals arrive in well under a second — so the SDK discards\n * everything the application emits for the next minute. A `503 QUEUE_NEAR_CAPACITY` is a\n * HEALTHY gateway shedding load whose backlog drains on its own; treating it as a dead sink\n * turns a transient server-side shed into total client-side loss.\n *\n * ⚠ THIS DOES NOT MAKE ANYTHING RETRY FOREVER. `maxRetries` still bounds the attempts and the\n * batch is still dropped when they are spent. A genuine 500 still opens the breaker — that is\n * the control arm, and losing it would turn our outage into the customer's retry loop.\n */\nconst CAPACITY_REFUSAL_STATUSES: ReadonlySet<number> = new Set([429, 503]);\n\n/** Ceiling on an honoured `Retry-After`, in ms. Matches the Python twin's 10 s. */\nconst RETRY_AFTER_CEILING_MS = 10_000;\n\n/** Backoff for a refusal carrying no `Retry-After` (1 s, 2 s, 4 s) — an order of magnitude\n * above the generic 100/200/400 ms ladder, because a queue needs time to drain. */\nconst REFUSAL_BACKOFF_BASE_MS = 1_000;\n\n/** Sentinel for \"refused, but the server named no delay\". */\nconst REFUSAL_NO_HINT = -1;\n\n/**\n * ⚠ A MISROUTE IS A CONFIGURATION ERROR, NOT AN OUTAGE (0.7.0). Two answers mean that the\n * request did not reach the Risicare ingest gateway: a 3xx, and a 2xx whose body is not a\n * Risicare ack. Measured: the old default `https://app.risicare.ai` is the dashboard, and it\n * answers `POST /v1/spans` with `307 -> /login`. Through 0.6.0 `fetch` followed that\n * redirect, got the login page as an HTML 200, and `checkAck` returned SUCCESS. Now:\n * - `fetch` runs with `redirect: 'manual'`, so a 3xx comes back as the answer;\n * - the retry loop stops at the first misroute — no backoff, no second attempt;\n * - the failure COUNTS toward the circuit breaker, as a genuine failure does: 5 requests,\n * then the breaker opens, then one probe per cooldown (60 s);\n * - one warning names the endpoint and the answer, at most once per 5 minutes.\n * A capacity refusal (429/503) is different: it does not count toward the breaker.\n * Python twin: `exporters/http.py`, the block above `HttpExporter`.\n */\nconst MISROUTE_WARN_WINDOW_MS = 300_000;\n\n/**\n * An AUTH REFUSAL cannot change on a retry: the same key gets the same answer. So\n * `export()` sends it once (no retry inside that call). The batch processor still\n * re-queues the batch a bounded number of times, and the circuit breaker counts the\n * failure as before. The Python twin uses the same two statuses.\n */\nconst AUTH_REFUSAL_STATUSES: ReadonlySet<number> = new Set([401, 403]);\n\n/**\n * The WARNING for a failed export (\"spans are NOT reaching ...\") is written at the\n * first failure of an outage, and at most once in this window. Python twin:\n * `_failure_warn_window` (300 s).\n */\nconst FAILURE_WARN_WINDOW_MS = 300_000;\n\n/**\n * The state of one `export()` call: the answer of its last attempt and its cancel signal.\n * It is per call, not on the instance, so that concurrent calls (two processors that share\n * one exporter) cannot read each other's answers across an `await`.\n */\ninterface Call {\n cancel: AbortController;\n /** F-SDK503-001: a CAPACITY REFUSAL. `null` = none; `REFUSAL_NO_HINT` = no `Retry-After`. */\n refusalAfterMs: number | null;\n /** A MISROUTE: a short description of the answer. `null` = none. */\n misroute: string | null;\n /** The answer cannot change on a retry (an ack of 0 and 0). */\n noRetry: boolean;\n /** The HTTP status of the last answer. `null` = no answer. For the WARNING and the retry loop. */\n status: number | null;\n /** The error code or class when the last attempt got no answer. `null` = none. */\n error: string | null;\n}\n\nexport class HttpExporter implements SpanExporter {\n readonly name = 'http';\n\n private readonly _endpoint: string;\n private readonly _apiKey: string | undefined;\n private readonly _projectId: string | undefined;\n private readonly _environment: string | undefined;\n private readonly _timeoutMs: number;\n private readonly _maxRetries: number;\n private readonly _compress: boolean;\n\n // Circuit breaker (CON-201 / B-16). Threshold and cooldown sized for\n // a \"30-second prod restart\" scenario: with default 1s batch flush a\n // 5-failure threshold opens the circuit ~5s into an outage and the 60s\n // cooldown gives the gateway time to come back before the half-open\n // probe fires. Lower numbers (was 3@30s) tripped on transient blips.\n private _consecutiveFailures = 0;\n private _lastMisrouteWarnAt = -Infinity;\n private _lastFailureWarnAt = -Infinity;\n /**\n * The kind of failure that the last outage WARNING named ('auth', 'http', 'none',\n * 'unknown'). `null` after a success. A new kind in the same outage writes one more\n * WARNING, also inside the window.\n */\n private _failureKind: string | null = null;\n /** The endpoint as a log line may show it: no userinfo, no query (see `safeUrl`). */\n private readonly _safeEndpoint: string;\n /** The endpoint holds userinfo. `fetch` refuses such a URL. */\n private readonly _endpointHasCredentials: boolean;\n /** The calls in progress, by their batch, so that `abort(spans)` stops the right one. */\n private readonly _calls = new Map<Span[], Call>();\n /** The ack of each finished call, by its batch. Read once by `takeAck(spans)`. */\n private readonly _acks = new WeakMap<Span[], AckCounts>();\n /** The spans of each finished call that could not be serialized, by its batch. */\n private readonly _unserializable = new WeakMap<Span[], Span[]>();\n private _circuitOpenUntil = 0;\n private readonly _circuitBreakerThreshold = 5;\n private readonly _circuitBreakerCooldownMs = 60_000;\n\n constructor(options: HttpExporterOptions) {\n this._endpoint = options.endpoint.replace(/\\/+$/, '');\n this._apiKey = options.apiKey;\n this._projectId = options.projectId;\n this._environment = options.environment;\n this._timeoutMs = options.timeoutMs ?? 5000;\n this._maxRetries = options.maxRetries ?? 3;\n this._compress = options.compress ?? false;\n this._safeEndpoint = safeUrl(this._endpoint);\n this._endpointHasCredentials = hasCredentials(this._endpoint);\n }\n\n /**\n * Network or error text for a log line: the endpoint as `safeUrl` gives it, and no\n * form of the API key (`utils/scrub.ts`).\n */\n private _scrub(text: unknown, limit = 200): string {\n let out: string;\n try {\n out = text instanceof Error ? `${text.name}: ${text.message}` : String(text);\n } catch {\n out = typeof text;\n }\n if (this._safeEndpoint !== this._endpoint) out = out.split(this._endpoint).join(this._safeEndpoint);\n return scrubText(out, [this._apiKey], limit);\n }\n\n /** Hide the key from `util.inspect` and `console.log` of the exporter. */\n [Symbol.for('nodejs.util.inspect.custom')](): string {\n return `HttpExporter { endpoint: '${this._safeEndpoint}' }`;\n }\n\n /** The most requests that one `export()` call sends (`maxRetries`). */\n get attemptsPerExport(): number {\n return this._maxRetries;\n }\n\n /**\n * Returns the counts of the ack that the `export()` call for `spans` received, and clears\n * them. The answer is kept per batch, not on the instance: two processors that share this\n * exporter cannot read each other's ack across an `await`.\n */\n takeAck(spans: Span[]): AckCounts | null {\n const ack = this._acks.get(spans) ?? null;\n this._acks.delete(spans);\n return ack;\n }\n\n /** Returns the spans of `spans` that could not be serialized and were not sent, and clears them. */\n takeUnserializable(spans: Span[]): Span[] {\n const bad = this._unserializable.get(spans) ?? [];\n this._unserializable.delete(spans);\n return bad;\n }\n\n /**\n * Cancel the `export()` call for `spans` (all calls when `spans` is not given): its\n * request, its retries and its backoff sleep. The batch processor calls it when\n * `shutdown()` abandons the batch, so that the call does not keep the process alive. The\n * cancelled call returns FAILURE, changes no counter (the circuit breaker included) and\n * logs no WARNING.\n */\n abort(spans?: Span[]): void {\n if (spans !== undefined) this._calls.get(spans)?.cancel.abort();\n else for (const call of this._calls.values()) call.cancel.abort();\n }\n\n /**\n * Send one batch. The limits are the request timeout and `maxRetries`.\n *\n * ⚠ NO CALLER BUDGET. `flush(timeoutMs)` only stops WAITING at its deadline; it never\n * cuts a request that is already sent. A short flush budget that cut the request made a\n * healthy, slow server look like a failure: the span used a retry, the breaker moved, and\n * the server stored the same spans again. Only `abort()` stops the call, and only\n * `shutdown()` calls it.\n */\n async export(spans: Span[]): Promise<ExportResult> {\n if (spans.length === 0) return ExportResult.SUCCESS;\n const call: Call = {\n cancel: new AbortController(),\n refusalAfterMs: null,\n misroute: null,\n noRetry: false,\n status: null,\n error: null,\n };\n this._calls.set(spans, call);\n try {\n return await this._export(spans, call);\n } finally {\n this._calls.delete(spans);\n }\n }\n\n private async _export(spans: Span[], call: Call): Promise<ExportResult> {\n const cancelled = call.cancel.signal;\n // Serialize each span alone. A span that cannot be serialized (a BigInt, a circular\n // value) is not sent; the batch processor drops it as `unacknowledged`. Through 0.7.1\n // one such span made the whole batch fail every round, and the WARNING blamed the\n // endpoint.\n const parts: string[] = [];\n const bad: Span[] = [];\n let errorClass = '';\n for (const span of spans) {\n try {\n parts.push(JSON.stringify(span.toPayload()));\n } catch (e) {\n bad.push(span);\n errorClass ||= e instanceof Error ? e.name : typeof e;\n }\n }\n if (bad.length > 0) {\n this._unserializable.set(spans, bad);\n warn(\n `Risicare: ${bad.length} of ${spans.length} span(s) in this batch could not be ` +\n `serialized (${errorClass}), for example an attribute with a BigInt or a circular ` +\n `reference. They are not sent and are counted as dropped (reason=unacknowledged).`,\n );\n }\n if (parts.length === 0) return ExportResult.SUCCESS;\n const payload =\n `{\"spans\":[${parts.join(',')}]` +\n (this._projectId ? `,\"projectId\":${JSON.stringify(this._projectId)}` : '') +\n (this._environment ? `,\"environment\":${JSON.stringify(this._environment)}` : '') +\n '}';\n\n // Circuit breaker: skip if open\n const now = Date.now();\n let isHalfOpen = false;\n if (this._consecutiveFailures >= this._circuitBreakerThreshold) {\n if (now < this._circuitOpenUntil) {\n return ExportResult.FAILURE;\n }\n // Cooldown expired — probe with single request (Audit #7: half-open state)\n isHalfOpen = true;\n }\n\n // Half-open: single probe request. Normal: full retry loop.\n const maxAttempts = isHalfOpen ? 1 : this._maxRetries;\n let attempts = 0;\n\n // Retry loop with exponential backoff\n for (let attempt = 0; attempt < maxAttempts; attempt++) {\n // F-SDK503-001: cleared before EVERY attempt, so a refusal recorded on attempt 1 cannot\n // be read as a refusal on attempt 2 (`_sendRequest` swallows transport errors and\n // returns FAILURE without touching the field).\n call.refusalAfterMs = null;\n call.misroute = null;\n call.noRetry = false;\n call.status = null;\n call.error = null;\n attempts++;\n const result = await this._sendRequest(payload, parts.length, call, spans);\n // Cancelled by `abort()`: no counter, no breaker step, no WARNING.\n if (cancelled.aborted) {\n this._acks.delete(spans);\n return ExportResult.FAILURE;\n }\n\n if (result === ExportResult.SUCCESS) {\n this._consecutiveFailures = 0;\n this._failureKind = null;\n return result;\n }\n\n // A misroute, or an ack of 0 and 0, gets the same answer on every attempt. Do not\n // retry it.\n if (call.misroute !== null || call.noRetry) break;\n // A 401 or 403 cannot change on a retry either.\n if (call.status !== null && AUTH_REFUSAL_STATUSES.has(call.status)) break;\n\n // Backoff. A generic failure is usually a blip worth retrying at once (100/200/400 ms);\n // a CAPACITY REFUSAL waits on the SERVER's terms when the server names them, and an\n // order of magnitude longer when it does not.\n if (attempt < maxAttempts - 1) {\n const refusal = call.refusalAfterMs;\n const delay =\n refusal === null\n ? 100 * Math.pow(2, attempt)\n : refusal === REFUSAL_NO_HINT\n ? REFUSAL_BACKOFF_BASE_MS * Math.pow(2, attempt)\n : refusal;\n await sleep(delay, cancelled);\n if (cancelled.aborted) return ExportResult.FAILURE;\n }\n }\n\n // ⚠ F-SDK503-001 — A CAPACITY REFUSAL DOES NOT COUNT TOWARD THE BREAKER.\n //\n // ⚠ THE COUNTER IS LEFT UNTOUCHED, NOT RESET. A refusal is not evidence of health either:\n // resetting would let an alternating 500/503 sequence hold the breaker open-ended at four.\n // It neither advances nor clears.\n if (call.refusalAfterMs !== null) {\n warn(\n `Risicare: the ingest endpoint refused this batch for capacity (HTTP 429/503) after ` +\n `${attempts} attempt(s). This is a healthy server shedding load, not an outage. ` +\n `This export of the batch failed; the circuit breaker does not count it. Reduce ` +\n `batch size or export rate if it persists.`\n );\n return ExportResult.FAILURE;\n }\n\n const misroute = call.misroute;\n if (misroute !== null && Date.now() - this._lastMisrouteWarnAt > MISROUTE_WARN_WINDOW_MS) {\n this._lastMisrouteWarnAt = Date.now();\n warn(\n `Risicare: spans are NOT reaching ${this._safeEndpoint}. It answered POST /v1/spans with ` +\n `${misroute}. That is not the Risicare ingest gateway, so the endpoint is probably ` +\n `wrong (for example the dashboard URL instead of the ingest gateway URL). The SDK ` +\n `does not follow redirects, and this batch is counted as NOT delivered. Set ` +\n `endpoint or RISICARE_ENDPOINT to the ingest gateway URL.`,\n );\n }\n\n // All retries failed — update circuit breaker\n this._consecutiveFailures++;\n\n // The first failure of an outage writes one WARNING, at most once in the window\n // (as in Python). A misroute and an ack of 0 and 0 have their own WARNING. A new\n // kind of failure in the same outage (for example a 401, then no answer) writes one\n // more WARNING, also inside the window. The WARNING names the last HTTP status, or\n // the error code when there was no answer. It never names the key or the response\n // body, and names the API key as a cause only for a 401 or 403.\n if (misroute === null && !call.noRetry) {\n const status = call.status;\n const kind =\n status !== null && AUTH_REFUSAL_STATUSES.has(status)\n ? 'auth'\n : status !== null\n ? 'http'\n : call.error !== null\n ? 'none'\n : 'unknown';\n let write = false;\n if (this._consecutiveFailures === 1 || this._failureKind === null) {\n if (Date.now() - this._lastFailureWarnAt > FAILURE_WARN_WINDOW_MS) {\n this._lastFailureWarnAt = Date.now();\n write = true;\n }\n this._failureKind = kind;\n } else if (kind !== this._failureKind) {\n this._failureKind = kind;\n write = true;\n }\n if (write) this._warnOutage(kind, status, call.error);\n }\n if (this._consecutiveFailures >= this._circuitBreakerThreshold) {\n this._circuitOpenUntil = Date.now() + this._circuitBreakerCooldownMs;\n warn(\n `HTTP exporter circuit breaker opened after ${this._consecutiveFailures} failures. ` +\n `Cooldown: ${this._circuitBreakerCooldownMs / 1000}s`\n );\n }\n\n return ExportResult.FAILURE;\n }\n\n /** The outage WARNING for one kind of failure. */\n private _warnOutage(kind: string, status: number | null, error: string | null): void {\n const where = `Risicare: spans are NOT reaching ${this._safeEndpoint}`;\n const tail = 'Tracing continues, but the SDK drops the spans that it cannot send.';\n if (kind === 'auth') {\n warn(\n `${where}: it answered HTTP ${status}. The endpoint refused the API key. Check the ` +\n `apiKey (or RISICARE_API_KEY) and the project it belongs to. ${tail}`,\n );\n } else if (kind === 'http') {\n warn(\n `${where}: it answered HTTP ${status}. The server did not take the batch. Check the ` +\n `endpoint and the server. ${tail} Set debug: true to see each attempt.`,\n );\n } else if (kind === 'none' && this._endpointHasCredentials) {\n warn(\n `${where}: no answer (${error}). The endpoint URL holds credentials (a user name ` +\n `or a password before the host), and fetch does not send a request to such a URL. ` +\n `Remove the credentials from the endpoint URL. ${tail}`,\n );\n } else if (kind === 'none') {\n warn(\n `${where}: no answer (${error}). The endpoint cannot be reached, or it did not ` +\n `answer in time. Check the endpoint and the network. ${tail} Set debug: true to ` +\n `see each attempt.`,\n );\n } else {\n warn(\n `${where}: the export failed. Common causes: an invalid apiKey or an unreachable ` +\n `endpoint. ${tail} Set debug: true to see each attempt.`,\n );\n }\n }\n\n /** Record a MISROUTE for the retry loop and the breaker. Always returns FAILURE. */\n private _noteMisroute(call: Call, answer: string): ExportResult {\n // The answer holds network text (a redirect target, a Content-Type): scrubbed here,\n // once, for the debug line below and for the WARNING.\n call.misroute = this._scrub(answer, 300);\n debug(`Ingest misroute: ${call.misroute}`);\n return ExportResult.FAILURE;\n }\n\n /**\n * Record a CAPACITY REFUSAL for the retry loop. Returns true if it was one.\n *\n * `Retry-After` is honoured only in its delta-seconds form (RFC 9110 §10.2.3 also permits an\n * HTTP-date); anything else falls back to our own backoff rather than guessing at a date\n * parse.\n */\n private _noteRefusal(call: Call, status: number, retryAfterRaw: string | null): boolean {\n if (!CAPACITY_REFUSAL_STATUSES.has(status)) return false;\n let delay = REFUSAL_NO_HINT;\n if (retryAfterRaw) {\n const secs = Number(retryAfterRaw);\n if (Number.isFinite(secs) && secs >= 0) {\n delay = Math.min(secs * 1000, RETRY_AFTER_CEILING_MS);\n }\n }\n call.refusalAfterMs = delay;\n debug(`Ingest refused for capacity: HTTP ${status} (Retry-After=${this._scrub(retryAfterRaw)})`);\n return true;\n }\n\n private async _sendRequest(\n body: string,\n spansSent: number,\n call: Call,\n spans: Span[],\n ): Promise<ExportResult> {\n const cancelled = call.cancel.signal;\n const timeoutMs = this._timeoutMs;\n const url = `${this._endpoint}/v1/spans`;\n const headers: Record<string, string> = {\n 'Content-Type': 'application/json',\n 'User-Agent': `risicare-js/${SDK_VERSION} node/${process.version}`,\n // F-SDKVER-001 parity. Python's ingest exporter has always sent\n // `X-Risicare-SDK-Version`; JS sent only a User-Agent, so the two SDKs\n // disagreed about how a client identifies itself. A parser-free header is\n // strictly easier for the gateway to consume than picking a version out of\n // a UA string.\n 'X-Risicare-SDK-Version': SDK_VERSION,\n };\n if (this._apiKey) {\n headers['Authorization'] = `Bearer ${this._apiKey}`;\n }\n\n let payload: string | Uint8Array = body;\n\n if (this._compress && payload.length > 1024) {\n try {\n const { gzipSync } = await import('node:zlib');\n payload = gzipSync(Buffer.from(payload));\n headers['Content-Encoding'] = 'gzip';\n } catch (e) {\n // Audit #16: log compression failures instead of silently swallowing\n debug(`Gzip compression failed, sending uncompressed: ${this._scrub(e)}`);\n }\n }\n\n // ⚠ ONE TIMER FOR THE WHOLE REQUEST, BODY READ INCLUDED (A4). Through 0.7.1 the timer\n // was cleared as soon as `fetch` resolved, which is when the HEADERS arrive. A server\n // that sent 200 headers and then stalled the body held `checkAck` for 301 s (the\n // runtime's own body timeout). And the `catch` path never cleared the timer, so each\n // refused attempt kept the process alive for the full timeout. The timer now covers\n // the body read and is cleared in `finally` on every path.\n const controller = new AbortController();\n const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n // `abort()` on the exporter stops this request too.\n const onCancel = () => controller.abort();\n cancelled.addEventListener('abort', onCancel, { once: true });\n if (cancelled.aborted) controller.abort();\n try {\n const response = await fetch(url, {\n method: 'POST',\n headers,\n body: payload,\n signal: controller.signal,\n // Never follow: a redirect is a misroute (see MISROUTE_WARN_WINDOW_MS). Node returns\n // the 3xx itself; a browser-like runtime returns type 'opaqueredirect' with status 0.\n redirect: 'manual',\n });\n call.status = response.status;\n\n const redirected = response.type === 'opaqueredirect';\n if (redirected || (response.status >= 300 && response.status < 400)) {\n const location = response.headers?.get?.('Location');\n // The target comes from the server, and it can contain the API key.\n const target = location ? this._scrub(location, 1000) : 'no Location header';\n return this._noteMisroute(call, `HTTP ${response.status || '3xx'}, a redirect to ${target}`);\n }\n if (response.status >= 200 && response.status < 300) {\n const ack = await checkAck(response, spansSent, (t) => this._scrub(t, 1000));\n if (ack === null) {\n // The timer ended the body read: a timeout, not a misroute.\n if (controller.signal.aborted) {\n call.status = null;\n call.error = `timeout after ${timeoutMs} ms`;\n debug(`HTTP export timeout: the ack body did not arrive within ${timeoutMs} ms`);\n return ExportResult.TIMEOUT;\n }\n return this._noteMisroute(\n call,\n `HTTP ${response.status} and a body that is not a Risicare ack ` +\n `(content-type: ${response.headers?.get?.('Content-Type') || 'none'})`,\n );\n }\n if (ack.result === ExportResult.SUCCESS) this._acks.set(spans, ack.counts);\n if (ack.final) call.noRetry = true;\n return ack.result;\n } else if (response.status === 408 || response.status === 504) {\n debug(`HTTP export timeout: ${response.status}`);\n return ExportResult.TIMEOUT;\n }\n // F-SDK503-001 — still a FAILURE for the return type (the batch did not land), but the\n // loop and the breaker treat it differently.\n this._noteRefusal(call, response.status, response.headers.get('Retry-After'));\n debug(`HTTP export failed: ${response.status}`);\n return ExportResult.FAILURE;\n } catch (e) {\n // The cause code tells a refused port, a DNS failure and a reset apart (fetch\n // wraps each of them in the same TypeError). A class name only: never a message.\n const cause = e instanceof Error ? (e as Error & { cause?: { code?: unknown } }).cause : undefined;\n call.error = controller.signal.aborted\n ? `timeout after ${timeoutMs} ms`\n : typeof cause?.code === 'string'\n ? cause.code\n : e instanceof Error\n ? e.name\n : 'Error';\n debug(`HTTP export error: ${this._scrub(e)}`);\n return ExportResult.FAILURE;\n } finally {\n clearTimeout(timeoutId);\n cancelled.removeEventListener('abort', onCancel);\n }\n }\n\n shutdown(): void {\n // Native fetch doesn't need cleanup\n }\n}\n\n/** Sleep for `ms`, or less when `signal` aborts. The timer never outlives the sleep. */\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n return new Promise((resolve) => {\n if (signal?.aborted) return resolve();\n const done = () => {\n clearTimeout(timer);\n signal?.removeEventListener('abort', done);\n resolve();\n };\n const timer = setTimeout(done, ms);\n signal?.addEventListener('abort', done, { once: true });\n });\n}\n\n/** An integer that is not a `boolean` (JS `typeof true === 'boolean'`, but be explicit). */\nfunction asCount(v: unknown): number | undefined {\n return typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;\n}\n\n/**\n * Decide SUCCESS/FAILURE from a 2xx response, reading the ACK body. Returns `null` when the\n * body is not a well-formed Risicare ack. The caller records that as a misroute, or as a\n * timeout when the request timer stopped the body read.\n *\n * ⚠ F-SDKACKBLIND-001. A 2xx is NOT delivery. The gateway answers\n * `StatusCode::OK` unconditionally on the ingest route (`routes/spans.rs`) and\n * reports per-span outcomes in the BODY — `{ accepted, rejected, errors[] }`,\n * camelCase, `errors` omitted when empty. Every span in a batch can be rejected\n * (bad trace-id hex, attribute-cardinality cap, clamps) and the status is still\n * 200. Before 0.5.1 this returned SUCCESS on any status below 300 and never\n * opened the body, so total loss looked like a clean export — and the retry, the\n * circuit breaker and `failedExports` all stayed silent.\n *\n * ⚠ ONLY A WELL-FORMED ACK IS SUCCESS (0.7.0). The ack is a JSON object with\n * non-negative integer `accepted` and `rejected`; other fields are ignored.\n * Through 0.6.0 any other body returned SUCCESS, to fail safe against a proxy\n * that rewrites bodies. That hid TOTAL loss: the login page that the dashboard\n * host redirects to is an HTML 200. Any other 2xx body is now a misroute: a\n * FAILURE, with no retry. The cost, stated: behind a proxy that rewrites bodies,\n * stored spans are counted as lost, and the batch processor can send them again.\n * That failure is loud.\n *\n * ⚠ A REJECTION IS AN ANSWER, NOT A FAILURE (after 0.7.1). A well-formed ack with\n * `rejected` > 0 is SUCCESS for the transport, also when `accepted` is 0: span-level\n * rejects are permanent, so a retry sends the same spans to the same refusal. Through\n * 0.7.1 an ack with `accepted` 0 was a FAILURE: the batch went to the server up to 12\n * times, the circuit breaker moved, and the last WARNING blamed the API key. A PARTIAL\n * rejection was already not a failure: retrying the whole batch would duplicate the\n * accepted spans. The result carries the counts, so that the batch processor adds\n * `accepted` to `exportedSpans` and `rejected` to `rejectedSpans`, and `flush()` then\n * returns `false`. One WARNING gives the counts and the reasons.\n *\n * ⚠ AN ACK OF 0 AND 0 FOR A NON-EMPTY BATCH IS A FAILURE (after 0.7.1). The gateway's\n * ack accounts for every span it got (accepted + rejected = spans sent). An ack\n * that counts no span is not a delivery. Through 0.7.1 it was SUCCESS, and the\n * whole batch was counted as exported. It is not retried inside the same\n * `export()` call, because the answer cannot change. The batch processor treats it\n * as any other failure.\n *\n * Other ack counts are not trusted here either: the batch processor clamps them to\n * the batch size (see `BatchSpanProcessor`).\n *\n * A WARNING names the reasons only: the distinct `errors[].error` strings (or\n * `errorMessage` when there are none), at most 3. Each one is made one printable\n * line (control characters become spaces) and then cut at 200 characters, so a\n * server cannot write a false log line. A WARNING never names a span index or span\n * content.\n *\n * Python twin: `exporters/http.py::_check_ack`. Same rule, same thresholds.\n */\ninterface AckOutcome {\n result: ExportResult;\n counts: AckCounts;\n /** True when a retry inside the same `export()` call cannot change the answer. */\n final: boolean;\n}\n\nconst MAX_ACK_REASONS = 3;\nconst MAX_ACK_REASON_CHARS = 200;\n\n/** Make a reason from the server one printable line: control and line-break characters become spaces. */\nfunction oneLine(text: string): string {\n // eslint-disable-next-line no-control-regex\n return text.replace(/[\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029]/g, ' ');\n}\n\n/** The distinct reasons of an ack, for a WARNING. Never a span index, never span content. */\nfunction ackReasons(body: Record<string, unknown>): string {\n const reasons: string[] = [];\n const errors = body.errors;\n if (Array.isArray(errors)) {\n for (const entry of errors) {\n const text = (entry as { error?: unknown } | null)?.error;\n if (typeof text !== 'string' || text.length === 0) continue;\n const cut = oneLine(text).slice(0, MAX_ACK_REASON_CHARS);\n if (!reasons.includes(cut)) reasons.push(cut);\n if (reasons.length === MAX_ACK_REASONS) break;\n }\n }\n if (reasons.length === 0) {\n const message =\n (typeof body.errorMessage === 'string' && body.errorMessage) ||\n (typeof body.error_message === 'string' && body.error_message) ||\n '';\n if (message) reasons.push(oneLine(message).slice(0, MAX_ACK_REASON_CHARS));\n }\n return reasons.length === 0 ? 'No reason was returned.' : `Reasons: ${reasons.join('; ')}`;\n}\n\nasync function checkAck(\n response: Response,\n spansSent: number,\n scrub: (text: string) => string,\n): Promise<AckOutcome | null> {\n let payload: unknown;\n try {\n payload = await response.json();\n } catch {\n return null; // not JSON (or the body read was aborted): not a Risicare ack\n }\n if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) {\n return null;\n }\n\n const body = payload as Record<string, unknown>;\n const accepted = asCount(body.accepted);\n const rejected = asCount(body.rejected);\n if (accepted === undefined || rejected === undefined) return null;\n const counts: AckCounts = { accepted, rejected };\n\n if (accepted === 0 && rejected === 0 && spansSent > 0) {\n warn(\n `Risicare: the backend acknowledged 0 of ${spansSent} span(s): its ack counts no ` +\n `span as accepted or rejected. This batch is counted as NOT delivered.`,\n );\n return { result: ExportResult.FAILURE, counts, final: true };\n }\n if (rejected === 0) return { result: ExportResult.SUCCESS, counts, final: false };\n\n const total = accepted + rejected;\n if (accepted === 0) {\n warn(\n `Risicare: the backend accepted 0 of ${total} span(s) and rejected ${rejected} — ` +\n `this batch was NOT stored. Rejected spans are permanently lost and are NOT ` +\n `retried. ${scrub(ackReasons(body))}`,\n );\n return { result: ExportResult.SUCCESS, counts, final: false };\n }\n\n warn(\n `Risicare: the backend rejected ${rejected} of ${total} span(s); the remaining ` +\n `${accepted} were stored. Those ${rejected} are permanently lost and are NOT ` +\n `retried. ${scrub(ackReasons(body))}`,\n );\n return { result: ExportResult.SUCCESS, counts, final: false };\n}\n","/**\n * Console exporter for debugging.\n *\n * Prints span data to stderr in a readable format.\n */\n\nimport type { Span } from '../span.js';\nimport { ExportResult, type SpanExporter } from './base.js';\n\nexport class ConsoleExporter implements SpanExporter {\n readonly name = 'console';\n /**\n * It only shows spans locally, so its success is not a delivery. When another\n * exporter is present, the batch processor ignores this exporter's result.\n */\n readonly countsAsDelivery = false;\n\n export(spans: Span[]): ExportResult {\n for (const span of spans) {\n const payload = span.toPayload();\n const line = JSON.stringify(payload);\n process.stderr.write(`[risicare] ${line}\\n`);\n }\n return ExportResult.SUCCESS;\n }\n\n shutdown(): void {\n // Nothing to clean up\n }\n}\n","/**\n * Observe a provider call without changing what the caller gets.\n *\n * THE RULE (the same as the Python SDK's stream proxy). The caller gets the\n * provider's OWN objects: the promise the call returned (for example the\n * Stainless `APIPromise` with `withResponse()` and `asResponse()`, or Cohere's\n * `HttpResponsePromise`), and the stream object that promise gives (for example\n * `Stream`, `EventStream`, `AbortableAsyncIterator`). Each one is a `Proxy`\n * over the provider's object, so every method and property is the provider's,\n * `instanceof` is true, and the chunks are the same chunks in the same order.\n * The proxy intercepts only:\n * - `then` / `catch` / `finally` / `withResponse` / `withRawResponse` of the\n * promise, to see the value when the CALLER asks for it (never earlier:\n * `asResponse()` must get a body that nobody has read);\n * - `Symbol.asyncIterator` and `next` / `return` / `throw` of the stream and\n * of its iterator, to count the chunks the CALLER reads (no read-ahead);\n * - `cancel`, `tee`, `toReadableStream`, `getReader`, `pipeTo`, `pipeThrough`,\n * where the stream leaves our view.\n * The SDK's reading never throws into the caller (`read-safely.ts`).\n *\n * The span ends EXACTLY ONCE, with `stream.end_reason`:\n * done the caller read the stream to its end;\n * return the caller stopped (`break`, `return()`);\n * abort the provider's abort (`controller.abort()`, `abort()`, `cancel()`,\n * an `AbortError`): status error and `risicare.cancelled` = true,\n * `risicare.cancel_type` = \"AbortError\", as the non-stream path;\n * error an error reached the caller (the span records it);\n * handoff the caller took the data another way (`tee()`, `getReader()`,\n * `toReadableStream()`, `pipeTo()`, `asResponse()`); the chunk count\n * then covers only what passed through the proxy;\n * garbage nobody holds the promise, the stream or an iterator any more\n * (`FinalizationRegistry`; the engine decides when, maybe never);\n * shutdown `shutdown()` ends every span that is still open, so a stream that\n * nobody reads is not lost.\n * A non-stream call ends its span when the caller gets the value.\n *\n * @internal Not public API.\n */\n\nimport type { Span } from '../span.js';\nimport { SpanStatus } from '../types.js';\nimport { attachErrorCode } from '../tracer.js';\nimport { runWithContext } from '../context/storage.js';\nimport { readResponseSafely, responseReadFailed } from './read-safely.js';\nimport { getProviderSpanState, type OpenProviderSpan, type ProviderSpanState } from '../globals.js';\n\nexport type EndReason = 'done' | 'return' | 'abort' | 'error' | 'handoff' | 'garbage' | 'shutdown' | 'response';\n\nexport interface ObserveOptions {\n /**\n * The provider, for the read-failure marker and its debug line\n * (`read-safely.ts`): a fault in the SDK's own observation sets the span\n * attribute `risicare.observer_error`, keeps the status, and logs no message.\n */\n provider: string;\n /** True when the request asked for a stream. */\n stream?: boolean;\n /** Reads a non-stream response. */\n onValue?: (value: unknown) => void;\n /** Reads one chunk that the caller got. */\n onChunk?: (chunk: unknown) => void;\n /** Runs once before the span of a stream ends; reads only what onChunk kept. */\n beforeEnd?: () => void;\n /**\n * For a value that CONTAINS the stream (Google `{ stream, response }`):\n * return what the caller gets, using `trace` for the stream. Returning the\n * value itself means \"no stream here\": the span ends as a response. When absent, an\n * async-iterable value is the stream, and any other value is a response.\n *\n * `side` observes a promise in the value that gives the caller the data\n * without the stream (Google `response`, the aggregated response). While\n * the caller holds or awaits it, the span stays open. When it settles and\n * the caller never took the stream, the span ends: `done` after `onValue`\n * read the value, or `error`. When the caller took the stream, the stream\n * decides the end.\n */\n wrapValue?: (\n value: unknown,\n trace: <S extends object>(stream: S) => S,\n side: <Q extends object>(promise: Q, onValue: (value: unknown) => void) => Q,\n ) => unknown;\n /**\n * The signal whose abort really stops the provider's request, when it is\n * not the stream's own `controller` / `abortController`. Cohere: the\n * stream's `controller.abort()` does not stop the stream, the request\n * option `abortSignal` does. An abort that does not stop the stream must\n * not turn a `garbage` or `shutdown` end into `abort`.\n */\n abortSignal?: () => AbortSignal | undefined;\n}\n\nconst HANDOFF = new Set<PropertyKey>(['tee', 'toReadableStream', 'getReader', 'pipeTo', 'pipeThrough']);\n\n/** The same test as `markCancel` in tracer.ts. */\nfunction isAbortError(e: unknown): boolean {\n return e instanceof Error && e.name === 'AbortError';\n}\n\nclass CallObservation {\n ended = false;\n streamSeen = false;\n chunks = 0;\n /** Calls of `next()` that have not settled. */\n private pending = 0;\n /** The provider's abort signal fired; what the stream does next decides. */\n abortSeen = false;\n /** Subscriptions on the promise (`then`, `await`) that have not settled. */\n private subscriptions = 0;\n /** Removes the abort listener from the provider's signal. */\n unlisten: (() => void) | undefined;\n /** Held objects (promise, stream, iterators) that nobody collected yet. */\n private live = 0;\n /** True when the registry holds at least one object of this call. */\n private held = false;\n /** The shared state (globals.ts); read once, so that `end()` cannot throw on it. */\n private readonly state: ProviderSpanState;\n\n constructor(\n readonly span: Span,\n readonly opts: ObserveOptions,\n ) {\n this.state = getProviderSpanState();\n this.state.open.add(this);\n }\n\n hold(obj: object): void {\n const registry = this.state.registry;\n if (!registry) return;\n this.live++;\n this.held = true;\n registry.register(obj, this);\n }\n\n /** Nobody can reach one of the held objects any more. */\n release(): void {\n this.live--;\n this.endIfUnreachable();\n }\n\n /**\n * THE one check after a counter goes down. The span ends as `garbage` only\n * when nobody can reach ANY held object, no `next()` waits and no\n * subscription on the promise waits for the provider: an `await` keeps the\n * request, not our Proxy, so a call in flight must not end here. Every path\n * that lowers a counter calls this AFTER it records its facts. A `next()`\n * that settled with a chunk after the last proxy was collected left the\n * span open until `shutdown()` when only `release()` checked (PR #49,\n * second review: 2,000 of 2,000 spans open).\n */\n private endIfUnreachable(): void {\n if (this.held && this.live <= 0 && this.pending <= 0 && this.subscriptions <= 0) this.end('garbage');\n }\n\n /** A subscription on the promise (`then`, `withResponse`, `asResponse`) starts. */\n subscribed(): void {\n this.subscriptions++;\n }\n\n /** A subscription settled. Call it after the value or the error is recorded. */\n unsubscribed(): void {\n this.subscriptions--;\n this.endIfUnreachable();\n }\n\n /** A `next()` starts. */\n nextCalled(): void {\n this.pending++;\n }\n\n chunk(value: unknown): void {\n if (this.ended) return;\n this.chunks++;\n const onChunk = this.opts.onChunk;\n if (onChunk) readResponseSafely(this.opts.provider, 'stream chunk', this.span, () => onChunk(value));\n }\n\n value(value: unknown): void {\n const onValue = this.opts.onValue;\n if (onValue && !this.ended) readResponseSafely(this.opts.provider, 'response', this.span, () => onValue(value));\n this.end('response');\n }\n\n /**\n * The provider's abort signal fired. That alone does not end the span: a\n * provider may go on (Cohere's `controller.abort()` does not stop its\n * stream). What the stream does next decides: an `AbortError`, or the end\n * with no chunk after the abort, is an abort; a chunk after it means the\n * abort did nothing.\n */\n abortRequested(): void {\n this.abortSeen = true;\n }\n\n /** A `next()` settled with `r`. */\n settled(r: IteratorResult<unknown> | undefined): void {\n this.pending--;\n if (r && r.done) this.end(this.abortSeen ? 'abort' : 'done');\n else {\n this.abortSeen = false;\n this.chunk(r?.value);\n }\n this.endIfUnreachable();\n }\n\n /** A `next()` failed (it threw, or its promise rejected). */\n failed(e: unknown): void {\n this.pending--;\n this.end(isAbortError(e) ? 'abort' : 'error', e);\n this.endIfUnreachable();\n }\n\n end(reason: EndReason, error?: unknown): void {\n if (this.ended) return;\n this.ended = true;\n try {\n this.state.open.delete(this);\n } catch (e) {\n responseReadFailed(this.opts.provider, 'provider span state', e, this.span);\n }\n if (this.unlisten) {\n const unlisten = this.unlisten;\n this.unlisten = undefined;\n readResponseSafely(this.opts.provider, 'stream abort signal', this.span, unlisten);\n }\n // An abort stopped the stream and nobody read the stream again. The\n // signal is one that stops the request (ObserveOptions.abortSignal).\n if ((reason === 'garbage' || reason === 'shutdown') && this.abortSeen) reason = 'abort';\n try {\n const span = this.span;\n const isStream = this.streamSeen || this.opts.stream === true;\n if (isStream) {\n const beforeEnd = this.opts.beforeEnd;\n if (beforeEnd && this.streamSeen) readResponseSafely(this.opts.provider, 'stream end', span, beforeEnd);\n span.setAttribute('stream.chunk_count', this.chunks);\n }\n if (reason !== 'response' && (isStream || reason === 'garbage' || reason === 'shutdown' || reason === 'handoff')) {\n span.setAttribute('stream.end_reason', reason);\n }\n // An abort follows the rule of the non-stream path (tracer.ts\n // markCancel, RULING 2026-10-03): status error, as in 0.7.0, plus\n // risicare.cancelled and risicare.cancel_type. A consumer that stops\n // early (`break`, `return()`) is not an abort: no error, no marker.\n const aborted = reason === 'abort' || isAbortError(error);\n if (error !== undefined) {\n span.recordException(error instanceof Error ? error : String(error));\n attachErrorCode(span, error);\n } else if (aborted) {\n span.setStatus(SpanStatus.ERROR, 'AbortError: the stream was aborted');\n }\n if (aborted) {\n span.setAttribute('risicare.cancelled', true);\n span.setAttribute('risicare.cancel_type', 'AbortError');\n }\n span.end();\n } catch (e) {\n responseReadFailed(this.opts.provider, 'span end', e, this.span);\n }\n }\n}\n\n/** End every observed span that is still open. `shutdown()` calls this. Never throws. @internal */\nexport function endOpenProviderSpans(): void {\n let open: OpenProviderSpan[];\n try {\n open = [...getProviderSpanState().open];\n } catch {\n // A shared state of another version (globals.ts): this copy observed nothing in it.\n return;\n }\n for (const o of open) o.end('shutdown');\n}\n\n/**\n * The SDK could not build its observation of a call (for example, the shared\n * state on `globalThis` is of another SDK version). The call goes on,\n * unobserved: the caller gets the provider's own result. The span gets\n * `risicare.observer_error` and ends at once, so it is not lost. A debug line\n * says so (read-safely.ts: once for each provider and error class). Never throws.\n */\nfunction notObserved(provider: string, span: Span, error: unknown): void {\n responseReadFailed(provider, 'the provider span state; this call is not observed', error, span);\n}\n\nfunction endQuietly(span: Span): void {\n try {\n span.end();\n } catch {\n /* the span end must never throw into the caller */\n }\n}\n\n/**\n * Listen to the provider's abort signal. A top-level function on purpose: the\n * listener may capture only the observation, never the Proxy or the\n * provider's object. The signal lives as long as the provider's request; a\n * listener that held the Proxy kept every unread stream alive (276 MB for\n * 10,000 dropped streams) and its span never ended.\n */\nfunction listenForAbort(signal: AbortSignal, obs: CallObservation): void {\n if (signal.aborted) {\n obs.abortRequested();\n return;\n }\n const onAbort = (): void => obs.abortRequested();\n signal.addEventListener('abort', onAbort, { once: true });\n obs.unlisten = () => signal.removeEventListener('abort', onAbort);\n}\n\n/** The provider's abort signal, if its stream object has one. */\nfunction abortSignalOf(stream: object): AbortSignal | undefined {\n const s = stream as { controller?: { signal?: unknown }; abortController?: { signal?: unknown } };\n return usableSignal(s.controller?.signal ?? s.abortController?.signal);\n}\n\nfunction usableSignal(signal: unknown): AbortSignal | undefined {\n return signal && typeof (signal as AbortSignal).addEventListener === 'function' ? (signal as AbortSignal) : undefined;\n}\n\n// ── Forwarding ───────────────────────────────────────────────────────────────\n\n/** A non-configurable, non-writable own data property must be returned as it is (Proxy invariant). */\nfunction frozenOwn(target: object, prop: PropertyKey): boolean {\n const d = Object.getOwnPropertyDescriptor(target, prop);\n return !!d && d.configurable === false && 'value' in d && d.writable === false;\n}\n\n/**\n * A getter for every other property: the provider's value. A METHOD from the\n * prototype chain is bound to the provider's object, because native and\n * private-field methods refuse a Proxy as `this` (`getReader()` of a\n * ReadableStream). `constructor` and own function properties (closures, such\n * as the Stainless `iterator`) are returned as they are, so that\n * `stream.constructor === Stream` stays true.\n */\nfunction forwarder(target: object): (prop: PropertyKey) => unknown {\n const bound = new Map<Function, Function>();\n return (prop) => {\n const v = Reflect.get(target, prop, target);\n if (typeof v !== 'function' || prop === 'constructor' || Object.prototype.hasOwnProperty.call(target, prop)) return v;\n let b = bound.get(v);\n if (!b) {\n b = (v as Function).bind(target) as Function;\n bound.set(v, b);\n }\n return b;\n };\n}\n\n// ── Iterators and streams ────────────────────────────────────────────────────\n\n/** next/return/throw of `src`, observed. `undefined` when `src` has no such method. */\nfunction iteratorMethod(src: object, prop: 'next' | 'return' | 'throw', obs: CallObservation): Function | undefined {\n const fn = Reflect.get(src, prop, src);\n if (typeof fn !== 'function') return undefined;\n if (prop === 'next') {\n return (...a: unknown[]) => {\n obs.nextCalled();\n let p: unknown;\n try {\n p = Reflect.apply(fn, src, a);\n } catch (e) {\n obs.failed(e);\n throw e;\n }\n return Promise.resolve(p).then(\n (r) => {\n obs.settled(r as IteratorResult<unknown>);\n return r;\n },\n (e) => {\n obs.failed(e);\n throw e;\n },\n );\n };\n }\n if (prop === 'return') {\n return (...a: unknown[]) => {\n obs.end('return');\n return Reflect.apply(fn, src, a);\n };\n }\n return (...a: unknown[]) => {\n obs.end('error', a[0]);\n return Reflect.apply(fn, src, a);\n };\n}\n\nfunction traceIterator<I extends object>(it: I, obs: CallObservation): I {\n const forward = forwarder(it);\n const proxy: I = new Proxy(it, {\n get(target, prop) {\n if ((prop === 'next' || prop === 'return' || prop === 'throw') && !frozenOwn(target, prop)) {\n return iteratorMethod(target, prop, obs);\n }\n if (prop === Symbol.asyncIterator && !frozenOwn(target, prop)) {\n const own = Reflect.get(target, prop, target);\n return typeof own === 'function' ? () => proxy : own;\n }\n return forward(prop);\n },\n });\n obs.hold(proxy);\n return proxy;\n}\n\nfunction traceStream<S extends object>(stream: S, obs: CallObservation): S {\n obs.streamSeen = true;\n // The provider's own abort: Stainless and Cohere `controller`, Ollama\n // `abortController`. Listening reads nothing from the stream.\n let signal: AbortSignal | undefined;\n readResponseSafely(obs.opts.provider, 'stream abort signal', obs.span, () => {\n const own = obs.opts.abortSignal;\n signal = own ? usableSignal(own()) : abortSignalOf(stream);\n });\n if (signal) listenForAbort(signal, obs);\n const forward = forwarder(stream);\n const proxy: S = new Proxy(stream, {\n get(target, prop) {\n if (frozenOwn(target, prop)) return Reflect.get(target, prop, target);\n if (prop === Symbol.asyncIterator) {\n const fn = Reflect.get(target, prop, target);\n if (typeof fn !== 'function') return fn;\n return (...a: unknown[]) => {\n const it = Reflect.apply(fn, target, a) as object;\n // An async generator is its own iterator: keep handing out the proxy.\n return it === target ? proxy : traceIterator(it, obs);\n };\n }\n if (prop === 'next' || prop === 'return' || prop === 'throw') {\n return iteratorMethod(target, prop, obs);\n }\n if (prop === 'values') {\n const fn = Reflect.get(target, prop, target);\n if (typeof fn !== 'function') return fn;\n return (...a: unknown[]) => traceIterator(Reflect.apply(fn, target, a) as object, obs);\n }\n if (prop === 'cancel') {\n const fn = Reflect.get(target, prop, target);\n if (typeof fn !== 'function') return fn;\n return (...a: unknown[]) => {\n const r = Reflect.apply(fn, target, a);\n // The stream is cancelled only when the provider says so (a locked\n // ReadableStream refuses, and then nothing changes). A cancel that\n // resolved has stopped the stream: that is an abort now.\n Promise.resolve(r).then(\n () => obs.end('abort'),\n () => {},\n );\n return r;\n };\n }\n if (HANDOFF.has(prop)) {\n const fn = Reflect.get(target, prop, target);\n if (typeof fn !== 'function') return fn;\n return (...a: unknown[]) => {\n obs.end('handoff');\n return Reflect.apply(fn, target, a);\n };\n }\n return forward(prop);\n },\n });\n obs.hold(proxy);\n return proxy;\n}\n\n// ── The promise the call returned ────────────────────────────────────────────\n\nfunction isAsyncIterable(v: unknown): v is object {\n return (\n !!v &&\n (typeof v === 'object' || typeof v === 'function') &&\n typeof (v as { [Symbol.asyncIterator]?: unknown })[Symbol.asyncIterator] === 'function'\n );\n}\n\nfunction mapper(obs: CallObservation): (v: unknown) => unknown {\n let done = false;\n let mapped: unknown;\n return (v) => {\n if (done) return mapped;\n done = true;\n mapped = v;\n try {\n const trace = <S extends object>(s: S): S => (isAsyncIterable(s) ? traceStream(s, obs) : s);\n if (obs.opts.wrapValue) {\n mapped = obs.opts.wrapValue(v, trace, (q, onValue) => traceSidePromise(q, obs, onValue));\n // Nothing to wrap (for example a null result): it is a response.\n if (mapped === v) obs.value(v);\n // The caller holds the wrapper until it reads the stream in it: the\n // span must not end as garbage before that.\n else if (mapped && (typeof mapped === 'object' || typeof mapped === 'function')) obs.hold(mapped);\n }\n else if (isAsyncIterable(v)) mapped = traceStream(v, obs);\n else obs.value(v);\n } catch (e) {\n responseReadFailed(obs.opts.provider, 'stream proxy', e, obs.span);\n mapped = v;\n obs.end('response');\n }\n return mapped;\n };\n}\n\n/**\n * A promise in the value that gives the data without the stream (see\n * ObserveOptions.wrapValue `side`): the same Proxy as the call's promise, so\n * the caller's `await` is a subscription and the Proxy is held.\n */\nfunction traceSidePromise<Q extends object>(promise: Q, obs: CallObservation, onValue: (value: unknown) => void): Q {\n return tracePromise(\n promise,\n obs,\n (v) => {\n if (!obs.streamSeen && !obs.ended) {\n readResponseSafely(obs.opts.provider, 'response', obs.span, () => onValue(v));\n obs.end('done');\n }\n return v;\n },\n (e) => {\n if (!obs.streamSeen) obs.end('error', e);\n },\n );\n}\n\nfunction tracePromise<P extends object>(\n promise: P,\n obs: CallObservation,\n map: (v: unknown) => unknown = mapper(obs),\n fail: (e: unknown) => void = (e) => obs.end('error', e),\n): P {\n const forward = forwarder(promise);\n const t = promise as unknown as PromiseLike<unknown>;\n // The caller's `f` and `r` are the reactions of a SECOND promise: the one\n // that our observing reaction on the provider's promise gives. Not\n // `t.then(v => f(map(v)), ...)`: V8 builds the async stack trace of an error\n // (the caller's `at async <file>` frame) by following the promise chain,\n // and it cannot follow a call of `r` inside our function, so that form cut\n // the frame from a timeout, abort or 401 error (measured on openai,\n // anthropic and groq; PR #49 review, t4). It can follow `f` and `r` as the\n // reactions of a promise (an `await` gives promise resolving functions).\n // An async function that awaits `t`, or `Promise.resolve(t).then(...)`,\n // also keeps the frame, but it costs 2 more microtask ticks on a Stainless\n // or Cohere promise (a Promise subclass): `await` on a settled call resumes\n // after 4 ticks here, 3 without risicare (6 with the async function). On a\n // native promise all three forms cost 4 ticks (1 without risicare). The\n // unhandled-rejection events are those of the run without risicare\n // (measured on the real packages, PR #49 second review;\n // tests/provider-then-ticks.test.ts). The reaction is attached only when\n // the caller subscribes (never earlier: no read-ahead).\n const then = (f?: unknown, r?: unknown) => {\n obs.subscribed();\n let observed: PromiseLike<unknown>;\n try {\n observed = t.then(\n (v) => {\n const m = map(v);\n obs.unsubscribed();\n return m;\n },\n (e) => {\n fail(e);\n obs.unsubscribed();\n throw e;\n },\n );\n } catch (e) {\n // The provider's own `then` threw: the caller gets that throw, as without risicare.\n fail(e);\n obs.unsubscribed();\n throw e;\n }\n return observed.then(\n typeof f === 'function' ? (f as (v: unknown) => unknown) : undefined,\n typeof r === 'function' ? (r as (e: unknown) => unknown) : undefined,\n );\n };\n const proxy: P = new Proxy(promise, {\n get(target, prop) {\n if (frozenOwn(target, prop)) return Reflect.get(target, prop, target);\n if (prop === 'then') return then;\n if (prop === 'catch') return (r?: unknown) => then(undefined, r);\n if (prop === 'finally') {\n return (f?: unknown) =>\n typeof f !== 'function'\n ? then()\n : then(\n (v: unknown) => Promise.resolve(f()).then(() => v),\n (e: unknown) =>\n Promise.resolve(f()).then(() => {\n throw e;\n }),\n );\n }\n if (prop === 'withResponse' || prop === 'withRawResponse') {\n const fn = Reflect.get(target, prop, target);\n if (typeof fn !== 'function') return fn;\n return (...a: unknown[]) => {\n obs.subscribed();\n return (Reflect.apply(fn, target, a) as Promise<unknown>).then(\n (o) => {\n let out = o;\n if (o && typeof o === 'object' && 'data' in o) {\n try {\n out = { ...(o as object), data: map((o as { data: unknown }).data) };\n } catch (e) {\n responseReadFailed(obs.opts.provider, 'withResponse', e, obs.span);\n }\n }\n obs.unsubscribed();\n return out;\n },\n (e) => {\n obs.end('error', e);\n obs.unsubscribed();\n throw e;\n },\n );\n };\n }\n if (prop === 'asResponse') {\n const fn = Reflect.get(target, prop, target);\n if (typeof fn !== 'function') return fn;\n return (...a: unknown[]) => {\n const p = Reflect.apply(fn, target, a);\n obs.subscribed();\n Promise.resolve(p).then(\n () => {\n obs.end('handoff');\n obs.unsubscribed();\n },\n (e) => {\n obs.end('error', e);\n obs.unsubscribed();\n },\n );\n return p;\n };\n }\n return forward(prop);\n },\n });\n obs.hold(proxy);\n return proxy;\n}\n\n/**\n * Run the provider call inside the span's context and return what the caller\n * gets: the provider's own result, observed. A synchronous throw ends the span\n * with the error and reaches the caller unchanged.\n */\nexport function observeProviderCall(span: Span, opts: ObserveOptions, call: () => unknown): unknown {\n let obs: CallObservation;\n try {\n obs = new CallObservation(span, opts);\n } catch (e) {\n notObserved(opts.provider, span, e);\n try {\n return runWithContext({ span }, call);\n } finally {\n endQuietly(span);\n }\n }\n let result: unknown;\n try {\n result = runWithContext({ span }, call);\n } catch (e) {\n obs.end('error', e);\n throw e;\n }\n try {\n if (result && (typeof result === 'object' || typeof result === 'function') && typeof (result as PromiseLike<unknown>).then === 'function') {\n return tracePromise(result as object, obs);\n }\n return mapper(obs)(result);\n } catch (e) {\n responseReadFailed(opts.provider, 'stream proxy', e, span);\n obs.end('response');\n return result;\n }\n}\n\n/**\n * A provider span that ends through the provider's own callbacks, for a call\n * whose result is not a stream object (Vercel `streamText`: its streams are\n * getters, and `onFinish` / `onAbort` / `onError` say when the stream ends).\n * The same rules: the span ends once, `shutdown()` ends it when no callback\n * came, and a fault in the SDK's reading marks the span and never throws.\n */\nexport function trackProviderSpan(\n span: Span,\n opts: ObserveOptions,\n): {\n chunk(): void;\n read(site: string, fn: () => void): void;\n end(reason: 'done' | 'abort' | 'error', error?: unknown): void;\n hold(obj: object): void;\n} {\n let obs: CallObservation;\n try {\n obs = new CallObservation(span, opts);\n } catch (e) {\n notObserved(opts.provider, span, e);\n endQuietly(span);\n return { chunk: () => {}, read: () => {}, end: () => {}, hold: () => {} };\n }\n obs.streamSeen = opts.stream === true;\n return {\n chunk: () => {\n if (!obs.ended) obs.chunks++;\n },\n read: (site, fn) => readResponseSafely(opts.provider, site, span, fn),\n end: (reason, error) => obs.end(reason, error),\n hold: (obj) => obs.hold(obj),\n };\n}\n","/**\n * Fix Cache — Local cache for active fixes with TTL eviction.\n *\n * Provides fast lookup of fixes keyed by error code with exact match\n * and wildcard fallback. No locks needed — JS is single-threaded.\n *\n * Port of Python SDK's runtime/cache.py.\n */\n\nimport type { ActiveFix, FixRuntimeConfig } from './config.js';\nimport { matchesError } from './config.js';\nimport { debug } from '../utils/log.js';\n\n// ─── Cache Entry ────────────────────────────────────────────────────────────\n\ninterface CacheEntry {\n fix: ActiveFix;\n createdAt: number;\n expiresAt: number;\n}\n\n// ─── Cache Stats ────────────────────────────────────────────────────────────\n\nexport interface CacheStats {\n hits: number;\n misses: number;\n evictions: number;\n size: number;\n lastRefresh: number | null;\n}\n\n// ─── Fix Cache ──────────────────────────────────────────────────────────────\n\nexport class FixCache {\n private readonly _ttlMs: number;\n private readonly _maxEntries: number;\n private readonly _enabled: boolean;\n private _cache: Map<string, CacheEntry>;\n private _stats: CacheStats;\n\n constructor(config?: Pick<FixRuntimeConfig, 'cacheEnabled' | 'cacheTtlMs' | 'cacheMaxEntries'>) {\n this._enabled = config?.cacheEnabled ?? true;\n this._ttlMs = config?.cacheTtlMs ?? 300_000;\n this._maxEntries = config?.cacheMaxEntries ?? 1000;\n this._cache = new Map();\n this._stats = {\n hits: 0,\n misses: 0,\n evictions: 0,\n size: 0,\n lastRefresh: null,\n };\n }\n\n /** Whether caching is enabled. */\n get enabled(): boolean {\n return this._enabled;\n }\n\n /**\n * Get a fix by error code.\n *\n * Checks exact match first, then scans for wildcard matches.\n * Expired entries are evicted on access.\n */\n get(errorCode: string): ActiveFix | null {\n try {\n if (!this._enabled) return null;\n\n const now = Date.now();\n\n // Try exact match first (fast path)\n const exactEntry = this._cache.get(errorCode);\n if (exactEntry) {\n if (exactEntry.expiresAt > now) {\n this._stats.hits++;\n return exactEntry.fix;\n }\n // Expired — evict\n this._cache.delete(errorCode);\n this._stats.evictions++;\n }\n\n // Wildcard scan (slower path)\n for (const [key, entry] of this._cache) {\n if (entry.expiresAt <= now) {\n this._cache.delete(key);\n this._stats.evictions++;\n continue;\n }\n\n if (matchesError(entry.fix, errorCode)) {\n this._stats.hits++;\n return entry.fix;\n }\n }\n\n this._stats.misses++;\n return null;\n } catch (e) {\n debug(`FixCache.get error: ${e}`);\n return null;\n }\n }\n\n /**\n * Add a single fix to the cache.\n *\n * Evicts the oldest entry if at capacity.\n */\n set(fix: ActiveFix): void {\n try {\n if (!this._enabled) return;\n\n // Evict oldest if at capacity\n if (this._cache.size >= this._maxEntries) {\n this._evictOldest();\n }\n\n const now = Date.now();\n this._cache.set(fix.errorCode, {\n fix,\n createdAt: now,\n expiresAt: now + this._ttlMs,\n });\n this._stats.size = this._cache.size;\n } catch (e) {\n debug(`FixCache.set error: ${e}`);\n }\n }\n\n /**\n * Replace all cached fixes (bulk refresh).\n *\n * Clears the cache and populates with the given fixes.\n */\n setAll(fixes: ActiveFix[]): void {\n try {\n if (!this._enabled) return;\n\n this._cache.clear();\n const now = Date.now();\n\n for (const fix of fixes) {\n if (this._cache.size >= this._maxEntries) break;\n\n this._cache.set(fix.errorCode, {\n fix,\n createdAt: now,\n expiresAt: now + this._ttlMs,\n });\n }\n\n this._stats.size = this._cache.size;\n this._stats.lastRefresh = now;\n } catch (e) {\n debug(`FixCache.setAll error: ${e}`);\n }\n }\n\n /**\n * Get all non-expired fixes.\n */\n getAll(): ActiveFix[] {\n try {\n const now = Date.now();\n const valid: ActiveFix[] = [];\n const expired: string[] = [];\n\n for (const [key, entry] of this._cache) {\n if (entry.expiresAt > now) {\n valid.push(entry.fix);\n } else {\n expired.push(key);\n }\n }\n\n // Clean up expired entries\n for (const key of expired) {\n this._cache.delete(key);\n this._stats.evictions++;\n }\n\n this._stats.size = this._cache.size;\n return valid;\n } catch (e) {\n debug(`FixCache.getAll error: ${e}`);\n return [];\n }\n }\n\n /** Clear all cache entries. Returns the number of entries cleared. */\n clear(): number {\n const count = this._cache.size;\n this._cache.clear();\n this._stats.size = 0;\n return count;\n }\n\n /** Get cache statistics. */\n get stats(): CacheStats {\n this._stats.size = this._cache.size;\n return { ...this._stats };\n }\n\n /** Evict the oldest cache entry. */\n private _evictOldest(): void {\n if (this._cache.size === 0) return;\n\n let oldestKey: string | null = null;\n let oldestTime = Infinity;\n\n for (const [key, entry] of this._cache) {\n if (entry.createdAt < oldestTime) {\n oldestTime = entry.createdAt;\n oldestKey = key;\n }\n }\n\n if (oldestKey !== null) {\n this._cache.delete(oldestKey);\n this._stats.evictions++;\n }\n }\n}\n","/**\n * Fix Applier — Applies fixes to agent operations.\n *\n * Handles different fix types:\n * - PromptFix: Modify system/user prompts (prepend, append, replace, few_shot)\n * - ParameterFix: Adjust LLM parameters (temperature, model, etc.)\n * - RetryFix: Retry with exponential backoff + jitter\n * - FallbackFix: Switch to fallback model or default response\n * - GuardFix: Input/output validation (content filter, format check, length)\n *\n * Port of Python SDK's runtime/applier.py adapted for Node.js.\n */\n\nimport { createHash } from 'node:crypto';\nimport type { ActiveFix, FixRuntimeConfig } from './config.js';\nimport { shouldApply, resolveFixRuntimeConfig } from './config.js';\nimport type { FixCache } from './cache.js';\nimport { debug, warn } from '../utils/log.js';\n\n/**\n * Maximum length for fix content injected into prompts.\n * Prevents unbounded prompt injection from malicious/corrupted fix configs.\n */\nconst MAX_FIX_CONTENT_LENGTH = 10_000;\n\n// ─── Apply Result ───────────────────────────────────────────────────────────\n\nexport interface ApplyResult {\n applied: boolean;\n fixId?: string;\n deploymentId?: string;\n fixType?: string;\n modifications: Record<string, unknown>;\n error?: string;\n /**\n * Guard-only: human-readable reason a guard failed (passed=false). Used\n * by GuardRejectedError to surface an actionable message to the customer.\n * `error` carries the raw exception text; `reason` carries the audit\n * category ('guard_exception', 'content_filter', 'format_check', etc.).\n */\n reason?: string;\n}\n\nfunction emptyResult(fix: ActiveFix, fixType: string): ApplyResult {\n return {\n applied: false,\n fixId: fix.fixId,\n deploymentId: fix.deploymentId,\n fixType,\n modifications: {},\n };\n}\n\n/**\n * Escapes of a backslash and an ASCII letter that Python `re` and JavaScript\n * `RegExp` (without the `u` flag) read the same way. From the two grammars:\n * - Outside a class: `\\b \\B \\d \\D \\s \\S \\w \\W` (classes and word\n * boundaries) and `\\f \\n \\r \\t \\v` (control characters).\n * - Inside a class: the same, but not `\\B` (Python refuses it; JS reads B).\n * `[\\b]` is a backspace in both.\n * - `\\xHH` and `\\uHHHH` only with exactly 2 or 4 hex digits (Python refuses\n * a short one; JS reads it as the letter x or u).\n * - `\\A` and `\\Z` outside a class are translated (see below).\n * Every other letter fails closed. JS reads it as the letter itself; Python\n * refuses it (`\\e`, `\\q`, `\\z` before 3.14, `\\k`, `\\c`, `[\\A]`, `[\\Z]`) or\n * reads it differently (`\\a`, `\\N{...}`, `\\U........`, `\\z` from 3.14).\n */\nconst SAME_ESCAPES = 'bBdDsSwWfnrtv';\nconst SAME_ESCAPES_IN_CLASS = 'bdDsSwWfnrtv';\n\nconst LEADING_INLINE_FLAGS = /^\\(\\?([ims]+)\\)/;\nconst PY_NAMED_GROUP = /^\\(\\?P<([A-Za-z_][A-Za-z0-9_]*)>/;\nconst PY_NAMED_BACKREF = /^\\(\\?P=([A-Za-z_][A-Za-z0-9_]*)\\)/;\nconst JS_NAMED_GROUP = /^\\(\\?<([A-Za-z_][A-Za-z0-9_]*)>/;\n\n/**\n * Translate a Python `re` pattern to a JavaScript RegExp source and flags.\n *\n * - A leading inline-flag group `(?i)`, `(?s)`, `(?m)` or a combination such\n * as `(?is)` becomes RegExp flags. The `i` flag is always set.\n * - `\\A` becomes `(?<![\\s\\S])` and `\\Z` becomes `(?![\\s\\S])` (start and end\n * of the input, as in Python). Without the `u` flag, JavaScript reads `\\A`\n * and `\\Z` as the letters A and Z.\n * - `(?P<name>` becomes `(?<name>`, and `(?P=name)` becomes `\\k<name>`.\n *\n * It THROWS (the caller fails closed) on a backslash and a letter outside the\n * set above, and on a group name that occurs two times (Python refuses it).\n * Other escaped characters and the rest of a character class are copied\n * unchanged. Any other Python-only form stays as it is; if it does not\n * compile, the caller fails closed.\n * @internal\n */\nexport function translatePythonPattern(pattern: string): { source: string; flags: string } {\n let flags = 'i';\n let rest = pattern;\n const m = LEADING_INLINE_FLAGS.exec(rest);\n if (m) {\n for (const f of m[1]) if (!flags.includes(f)) flags += f;\n rest = rest.slice(m[0].length);\n }\n\n const names = new Set<string>();\n const addName = (name: string): void => {\n if (names.has(name)) throw new Error('a group name occurs two times');\n names.add(name);\n };\n\n let source = '';\n let inClass = false;\n for (let i = 0; i < rest.length; i++) {\n const c = rest[i];\n if (c === '\\\\' && i + 1 < rest.length) {\n const next = rest[i + 1];\n if (/[A-Za-z]/.test(next)) {\n if (!inClass && next === 'A') {\n source += '(?<![\\\\s\\\\S])';\n i++;\n continue;\n }\n if (!inClass && next === 'Z') {\n source += '(?![\\\\s\\\\S])';\n i++;\n continue;\n }\n if (next === 'x' || next === 'u') {\n const n = next === 'x' ? 2 : 4;\n const hex = rest.slice(i + 2, i + 2 + n);\n if (!new RegExp(`^[0-9A-Fa-f]{${n}}$`).test(hex)) throw new Error('short hex escape');\n source += c + next + hex;\n i += 1 + n;\n continue;\n }\n if (!(inClass ? SAME_ESCAPES_IN_CLASS : SAME_ESCAPES).includes(next)) {\n throw new Error('an escape that Python and JavaScript read differently');\n }\n }\n source += c + next;\n i++;\n continue;\n }\n if (inClass) {\n if (c === ']') inClass = false;\n source += c;\n continue;\n }\n if (c === '[') {\n inClass = true;\n source += c;\n continue;\n }\n const tail = rest.slice(i);\n let g: RegExpExecArray | null;\n if ((g = PY_NAMED_GROUP.exec(tail)) || (g = JS_NAMED_GROUP.exec(tail))) {\n addName(g[1]);\n source += `(?<${g[1]}>`;\n i += g[0].length - 1;\n continue;\n }\n if ((g = PY_NAMED_BACKREF.exec(tail))) {\n source += `\\\\k<${g[1]}>`;\n i += g[0].length - 1;\n continue;\n }\n source += c;\n }\n return { source, flags };\n}\n\n/** (fix id, pattern index) pairs whose \"not usable\" WARNING was written. */\nconst warnedGuardPatterns = new Set<string>();\n\n/** One WARNING per (fix id, pattern index) per process. Index -1: not a list. */\nfunction warnUnusablePattern(fixId: string | undefined, index: number): void {\n const key = `${fixId ?? 'unknown'}\\u0000${index}`;\n if (warnedGuardPatterns.has(key)) return;\n warnedGuardPatterns.add(key);\n warn(\n index < 0\n ? `Guard fix ${fixId ?? 'unknown'}: blocked_patterns is not a list. The guard rejects every call.`\n : `Guard fix ${fixId ?? 'unknown'}: blocked pattern ${index} is not usable (empty, not a ` +\n 'string, longer than 500 characters, or it does not compile). The guard rejects every call.',\n );\n}\n\n// ─── Fix Applier ────────────────────────────────────────────────────────────\n\nexport class FixApplier {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n private _applicationLog: ApplyResult[] = [];\n\n constructor(config: FixRuntimeConfig, cache: FixCache) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = cache;\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // Fix Lookup\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Get applicable fix for an error code.\n *\n * Considers A/B testing bucket if sessionId is provided. Uses\n * crypto.createHash('md5') for deterministic bucketing across restarts.\n */\n getFixForError(\n errorCode: string,\n sessionId?: string,\n ): ActiveFix | null {\n try {\n const fix = this._cache.get(errorCode);\n if (!fix) return null;\n\n // Check A/B test bucketing\n if (sessionId && this._config.abTestingEnabled) {\n const hashHex = createHash('md5')\n .update(sessionId)\n .digest('hex')\n .substring(0, 8);\n const sessionHash = parseInt(hashHex, 16);\n\n if (!shouldApply(fix, sessionHash)) {\n debug(`Fix ${fix.fixId} not applied (A/B control group)`);\n return null;\n }\n }\n\n return fix;\n } catch (e) {\n debug(`getFixForError error: ${e}`);\n return null;\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 1. Prompt Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a prompt fix to messages.\n *\n * Supports 4 modification types:\n * - prepend: Add content before first system message\n * - append: Add content after first system message\n * - replace: Regex replace across all messages\n * - few_shot: Insert user/assistant example pairs after system message\n */\n applyPromptFix(\n fix: ActiveFix,\n messages: Record<string, unknown>[],\n ): { messages: Record<string, unknown>[]; result: ApplyResult } {\n try {\n const cfg = fix.config;\n const modificationType = (cfg.modification_type ?? cfg.modificationType ?? 'append') as string;\n const target = (cfg.target ?? 'system') as string;\n let content = (cfg.content ?? '') as string;\n\n // Truncate oversized content to prevent prompt injection\n if (content.length > MAX_FIX_CONTENT_LENGTH) {\n warn(\n `Fix ${fix.fixId} content truncated from ${content.length} to ${MAX_FIX_CONTENT_LENGTH} chars`,\n );\n content = content.slice(0, MAX_FIX_CONTENT_LENGTH);\n }\n\n const result = emptyResult(fix, 'prompt');\n\n if (this._config.dryRun) {\n result.modifications = {\n type: modificationType,\n target,\n contentPreview: content.slice(0, 100),\n };\n return { messages, result };\n }\n\n let modified = messages.map((m) => ({ ...m }));\n\n if (modificationType === 'prepend') {\n modified = this._prependToTarget(modified, target, content);\n result.applied = true;\n result.modifications = { type: 'prepend', target };\n } else if (modificationType === 'append') {\n modified = this._appendToTarget(modified, target, content);\n result.applied = true;\n result.modifications = { type: 'append', target };\n } else if (modificationType === 'replace') {\n const pattern = (cfg.pattern ?? '') as string;\n if (pattern) {\n modified = this._replaceInMessages(modified, pattern, content);\n result.applied = true;\n result.modifications = { type: 'replace', pattern };\n }\n } else if (modificationType === 'few_shot') {\n const examples = (cfg.examples ?? []) as Array<Record<string, string>>;\n if (examples.length > 0) {\n modified = this._addFewShotExamples(modified, examples);\n result.applied = true;\n result.modifications = { type: 'few_shot', count: examples.length };\n }\n }\n\n return { messages: modified, result };\n } catch (e) {\n debug(`applyPromptFix error: ${e}`);\n return {\n messages,\n result: {\n applied: false,\n fixId: fix.fixId,\n fixType: 'prompt',\n modifications: {},\n error: String(e),\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 2. Parameter Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a parameter fix — merge config.parameters into params.\n */\n applyParameterFix(\n fix: ActiveFix,\n params: Record<string, unknown>,\n ): { params: Record<string, unknown>; result: ApplyResult } {\n try {\n const newParams = (fix.config.parameters ?? {}) as Record<string, unknown>;\n const result = emptyResult(fix, 'parameter');\n\n if (this._config.dryRun) {\n result.modifications = { parameters: newParams };\n return { params, result };\n }\n\n const modified = { ...params, ...newParams };\n result.applied = true;\n result.modifications = { parameters: newParams };\n\n return { params: modified, result };\n } catch (e) {\n debug(`applyParameterFix error: ${e}`);\n return {\n params,\n result: {\n applied: false,\n fixId: fix.fixId,\n fixType: 'parameter',\n modifications: {},\n error: String(e),\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 3. Retry Fix (async — uses setTimeout for sleeping)\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a retry fix to an async operation.\n *\n * Retries with exponential backoff + jitter using\n * `await new Promise(r => setTimeout(r, delay))`.\n */\n async applyRetryFix<T>(\n fix: ActiveFix,\n operation: () => Promise<T>,\n ): Promise<{ value: T; result: ApplyResult }> {\n const cfg = fix.config;\n const maxRetries = (cfg.max_retries ?? cfg.maxRetries ?? 3) as number;\n const initialDelayMs = (cfg.initial_delay_ms ?? cfg.initialDelayMs ?? 1000) as number;\n const maxDelayMs = (cfg.max_delay_ms ?? cfg.maxDelayMs ?? 30_000) as number;\n const exponentialBase = (cfg.exponential_base ?? cfg.exponentialBase ?? 2.0) as number;\n const jitter = (cfg.jitter ?? true) as boolean;\n const retryOn = (cfg.retry_on ?? cfg.retryOn ?? []) as string[];\n\n const result = emptyResult(fix, 'retry');\n\n if (this._config.dryRun) {\n result.modifications = { maxRetries, initialDelayMs };\n const value = await operation();\n return { value, result };\n }\n\n let lastError: Error | null = null;\n let attempts = 0;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n attempts++;\n try {\n const value = await operation();\n result.applied = true;\n result.modifications = { attempts };\n return { value, result };\n } catch (e) {\n lastError = e instanceof Error ? e : new Error(String(e));\n const errorType = lastError.constructor.name;\n\n // Check if we should retry this specific error type\n if (retryOn.length > 0 && !retryOn.includes(errorType)) {\n throw lastError;\n }\n\n if (attempt < maxRetries) {\n // Calculate delay with exponential backoff\n let delayMs = Math.min(\n initialDelayMs * Math.pow(exponentialBase, attempt),\n maxDelayMs,\n );\n\n // Add jitter: multiply by random factor [0.5, 1.5)\n if (jitter) {\n delayMs *= 0.5 + Math.random();\n }\n\n debug(\n `Retry ${attempt + 1}/${maxRetries} after ${Math.round(delayMs)}ms`,\n );\n await new Promise<void>((r) => setTimeout(r, delayMs));\n }\n }\n }\n\n // All retries exhausted\n result.applied = true;\n result.error = lastError?.message;\n result.modifications = { attempts, exhausted: true };\n throw lastError;\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 4. Fallback Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a fallback fix.\n *\n * - 'model': Replace params.model with the fallback model\n * - 'default': Set params._fallbackResponse for the caller to use\n */\n applyFallbackFix(\n fix: ActiveFix,\n params: Record<string, unknown>,\n ): { params: Record<string, unknown>; result: ApplyResult } {\n try {\n const cfg = fix.config;\n const fallbackType = (cfg.fallback_type ?? cfg.fallbackType ?? 'model') as string;\n const fallbackConfig = (cfg.fallback_config ?? cfg.fallbackConfig ?? {}) as Record<string, unknown>;\n const result = emptyResult(fix, 'fallback');\n\n if (this._config.dryRun) {\n result.modifications = { fallbackType, fallbackConfig };\n return { params, result };\n }\n\n const modified = { ...params };\n\n if (fallbackType === 'model') {\n const fallbackModel = fallbackConfig.model as string | undefined;\n if (fallbackModel) {\n modified.model = fallbackModel;\n result.applied = true;\n result.modifications = { model: fallbackModel };\n }\n } else if (fallbackType === 'default') {\n const defaultResponse = fallbackConfig.response;\n if (defaultResponse !== undefined) {\n modified._fallbackResponse = defaultResponse;\n result.applied = true;\n result.modifications = { defaultResponse: true };\n }\n }\n\n return { params: modified, result };\n } catch (e) {\n debug(`applyFallbackFix error: ${e}`);\n return {\n params,\n result: {\n applied: false,\n fixId: fix.fixId,\n fixType: 'fallback',\n modifications: {},\n error: String(e),\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // 5. Guard Fix\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Apply a guard fix (validation).\n *\n * Guard types:\n * - content_filter: Regex-based blocked patterns\n * - format_check: JSON.parse() validity\n * - input_validation / output_validation: min/max length\n *\n * `content_filter` searches the content for each entry of `blocked_patterns`\n * (case-insensitive, after `translatePythonPattern`). It fails CLOSED: when\n * `blocked_patterns` is not a list, or an entry is empty, is not a string,\n * is longer than 500 characters or cannot be used, the guard does not pass.\n * One WARNING names the fix id and the pattern index, once for each pair in\n * the process. The reason names the pattern index, never the pattern or the\n * content.\n *\n * Limits:\n * - The interceptor runs only on the OpenAI chat patch (input guards) and on\n * `interceptCall` / `interceptResponse`. It does not run when a framework\n * integration suppresses provider instrumentation.\n * - Each SDK uses its own regular-expression engine. These constructs can\n * give a different result in JavaScript and Python: `$` before a final\n * newline, Unicode case folding, `\\d` and `\\w` on non-ASCII text,\n * `\\N{...}` and `\\U........` (JavaScript fails closed), and a `]` first\n * in a class.\n * - A pattern has no time bound. A pattern with nested repeats can take a\n * very long time on a long input.\n */\n applyGuardFix(\n fix: ActiveFix,\n content: string,\n isInput = true,\n ): { content: string; passed: boolean; result: ApplyResult } {\n try {\n const cfg = fix.config;\n const guardType = (cfg.guard_type ?? cfg.guardType ?? 'output_validation') as string;\n const guardConfig = (cfg.guard_config ?? cfg.guardConfig ?? {}) as Record<string, unknown>;\n const result = emptyResult(fix, 'guard');\n\n // Check if guard applies to this direction\n if (isInput && guardType !== 'input_validation' && guardType !== 'content_filter') {\n return { content, passed: true, result };\n }\n if (!isInput && guardType !== 'output_validation' && guardType !== 'format_check') {\n return { content, passed: true, result };\n }\n\n if (this._config.dryRun) {\n result.modifications = { guardType };\n return { content, passed: true, result };\n }\n\n let passed = true;\n let reason: string | undefined;\n\n if (guardType === 'content_filter') {\n // A key that is present with null is \"not a list\" (as in Python); only\n // a missing key means \"no patterns\".\n const blockedPatterns: unknown = 'blocked_patterns' in guardConfig\n ? guardConfig.blocked_patterns\n : 'blockedPatterns' in guardConfig ? guardConfig.blockedPatterns : [];\n // F-029: a pattern that is not usable makes the guard FAIL CLOSED.\n // Through 0.7.1 it was skipped with a debug line and the guard passed.\n // The reason names the index only: a literal pattern IS the blocked text.\n if (!Array.isArray(blockedPatterns)) {\n warnUnusablePattern(fix.fixId, -1);\n passed = false;\n reason = 'blocked_patterns is not a list';\n } else {\n for (let index = 0; index < blockedPatterns.length; index++) {\n const regex = this._safeCompileRegex(blockedPatterns[index] as string);\n if (!regex) {\n warnUnusablePattern(fix.fixId, index);\n passed = false;\n reason = `blocked pattern ${index} is not usable`;\n break;\n }\n if (regex.test(content)) {\n passed = false;\n reason = `blocked pattern matched (pattern ${index})`;\n break;\n }\n }\n }\n } else if (guardType === 'format_check') {\n const requiredFormat = guardConfig.format as string | undefined;\n if (requiredFormat === 'json') {\n try {\n JSON.parse(content);\n } catch {\n passed = false;\n reason = 'format_check: invalid JSON';\n }\n }\n } else if (guardType === 'input_validation' || guardType === 'output_validation') {\n const minLength = (guardConfig.min_length ?? guardConfig.minLength ?? 0) as number;\n const maxLength = (guardConfig.max_length ?? guardConfig.maxLength ?? Infinity) as number;\n if (content.length < minLength || content.length > maxLength) {\n passed = false;\n reason = `${guardType}: length ${content.length} outside [${minLength}, ${maxLength}]`;\n }\n }\n\n result.applied = true;\n result.modifications = { passed, guardType };\n if (reason !== undefined) result.reason = reason;\n\n return { content, passed, result };\n } catch (e) {\n // F-731: Fail-CLOSED on guard error. An unexpected exception in a\n // safety-validation path MUST NOT silently pass content through —\n // that would defeat the entire purpose of input/output validation.\n // PR-4+5 review B2 (2026-05-25): the interceptor LAYER now reads\n // `passed:false` and throws GuardRejectedError to short-circuit the\n // LLM call. Before B2 this `passed:false` was advisory only — the\n // provider patcher consumed `modifications` / `messages` but never\n // read `passed`, so a thrown-getter attack still hit the LLM with\n // the attacker payload. The applier's job is to TELL the truth;\n // the interceptor's job is to ACT on it.\n warn(`applyGuardFix error (failing CLOSED): ${e}`);\n return {\n content,\n passed: false,\n result: {\n applied: true,\n fixId: fix.fixId,\n fixType: 'guard',\n modifications: { passed: false, reason: 'guard_exception' },\n error: String(e),\n reason: 'guard_exception',\n },\n };\n }\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // Application Log\n // ═══════════════════════════════════════════════════════════════════════════\n\n /** Log a fix application result. */\n logApplication(result: ApplyResult): void {\n this._applicationLog.push(result);\n\n // Limit log size\n if (this._applicationLog.length > 1000) {\n this._applicationLog = this._applicationLog.slice(-500);\n }\n }\n\n /** Get the application log. */\n getApplicationLog(): ApplyResult[] {\n return [...this._applicationLog];\n }\n\n // ═══════════════════════════════════════════════════════════════════════════\n // Private Helpers\n // ═══════════════════════════════════════════════════════════════════════════\n\n /**\n * Safely compile a regex pattern from untrusted input.\n * Returns null if invalid or too long.\n *\n * F-029: the fix patterns are written for Python `re`. Before it compiles\n * the pattern, this function translates the Python forms that have an exact\n * JavaScript equivalent (see `translatePythonPattern`). The `i` flag is\n * always on, as in the Python applier.\n */\n private _safeCompileRegex(\n pattern: string,\n maxLength = 500,\n ): RegExp | null {\n if (typeof pattern !== 'string' || !pattern || pattern.length > maxLength) return null;\n try {\n const { source, flags } = translatePythonPattern(pattern);\n return new RegExp(source, flags);\n } catch {\n debug(`Invalid regex pattern (length=${pattern.length})`);\n return null;\n }\n }\n\n /** Prepend content to the first message matching the target role. */\n private _prependToTarget(\n messages: Record<string, unknown>[],\n target: string,\n content: string,\n ): Record<string, unknown>[] {\n return messages.map((msg) => {\n if (msg.role === target) {\n return {\n ...msg,\n content: content + '\\n\\n' + ((msg.content as string) ?? ''),\n };\n }\n return msg;\n });\n }\n\n /** Append content to the first message matching the target role. */\n private _appendToTarget(\n messages: Record<string, unknown>[],\n target: string,\n content: string,\n ): Record<string, unknown>[] {\n return messages.map((msg) => {\n if (msg.role === target) {\n return {\n ...msg,\n content: ((msg.content as string) ?? '') + '\\n\\n' + content,\n };\n }\n return msg;\n });\n }\n\n /** Regex replace across all messages. */\n private _replaceInMessages(\n messages: Record<string, unknown>[],\n pattern: string,\n replacement: string,\n ): Record<string, unknown>[] {\n const regex = this._safeCompileRegex(pattern);\n if (!regex) {\n debug('Skipping invalid regex pattern in prompt fix');\n return messages;\n }\n\n return messages.map((msg) => {\n const msgContent = msg.content;\n if (typeof msgContent === 'string') {\n return { ...msg, content: msgContent.replace(regex, replacement) };\n }\n return msg;\n });\n }\n\n /** Add few-shot examples after the first system message. */\n private _addFewShotExamples(\n messages: Record<string, unknown>[],\n examples: Array<Record<string, string>>,\n ): Record<string, unknown>[] {\n const result: Record<string, unknown>[] = [];\n let systemFound = false;\n\n for (const msg of messages) {\n result.push(msg);\n\n if (msg.role === 'system' && !systemFound) {\n systemFound = true;\n for (const example of examples) {\n if (example.user) {\n result.push({ role: 'user', content: example.user });\n }\n if (example.assistant) {\n result.push({ role: 'assistant', content: example.assistant });\n }\n }\n }\n }\n\n return result;\n }\n}\n","/**\n * Fix Loader — Fetches active fixes from the Risicare API.\n *\n * Handles:\n * - Initial loading of fixes on startup\n * - Periodic background refresh via setInterval (unref'd)\n * - Exponential backoff on failure\n * - Circuit breaker: after 3 consecutive failures, stop trying for 30s\n *\n * Uses native fetch (Node.js 18+) with AbortController for timeouts.\n *\n * Port of Python SDK's runtime/loader.py adapted for Node.js.\n */\n\nimport type { ActiveFix } from './config.js';\nimport { activeFixFromApiResponse } from './config.js';\nimport type { FixRuntimeConfig } from './config.js';\nimport { resolveFixRuntimeConfig } from './config.js';\nimport type { FixCache } from './cache.js';\nimport { debug, warn } from '../utils/log.js';\nimport { safeUrl, scrubText } from '../utils/scrub.js';\nimport { SDK_VERSION } from '../version.js';\n\nexport class FixLoader {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n\n private _refreshTimer: ReturnType<typeof setInterval> | null = null;\n private _lastLoadTime: number | null = null;\n private _consecutiveFailures = 0;\n private _circuitOpenUntil = 0;\n private _onLoadCallbacks: Array<(fixes: ActiveFix[]) => void> = [];\n // The HTTP status of the last load that got a non-2xx answer; null otherwise.\n private _lastStatus: number | null = null;\n\n // Circuit breaker settings\n private static readonly CIRCUIT_BREAKER_THRESHOLD = 3;\n private static readonly CIRCUIT_BREAKER_COOLDOWN_MS = 30_000;\n\n constructor(config: FixRuntimeConfig, cache: FixCache) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = cache;\n }\n\n /** Error text for a log line: one line, the api endpoint as `safeUrl` gives it, no key. */\n private _scrub(error: unknown): string {\n let out: string;\n try {\n out = error instanceof Error ? `${error.name}: ${error.message}` : String(error);\n } catch {\n out = typeof error;\n }\n const endpoint = (this._config.apiEndpoint ?? '').replace(/\\/+$/, '');\n if (endpoint && safeUrl(endpoint) !== endpoint) out = out.split(endpoint).join(safeUrl(endpoint));\n return scrubText(out, [this._config.apiKey]);\n }\n\n /**\n * The WARNING for a failed first load: the request URL with no userinfo, no\n * query and no key, the HTTP status or the error class, and that tracing is\n * not affected. Never the error text: it can echo the URL with its query.\n */\n private _firstLoadWarning(error: unknown): string {\n let cause: string;\n if (this._lastStatus !== null) {\n cause = `HTTP ${this._lastStatus}`;\n } else {\n cause = error instanceof Error ? error.name : typeof error;\n const code = (error as { cause?: { code?: unknown } } | null)?.cause?.code;\n if (typeof code === 'string' && /^[A-Z][A-Z0-9_]*$/.test(code)) cause += ` (${code})`;\n }\n const endpoint = (this._config.apiEndpoint ?? '').replace(/\\/+$/, '');\n return scrubText(\n `The first load of the fixes from ${safeUrl(endpoint)}/v1/fixes/active failed (${cause}). ` +\n 'No fix is applied until a later load succeeds. Tracing is not affected.',\n [this._config.apiKey],\n 500,\n );\n }\n\n /** Hide the key from `util.inspect` and `console.log` of the loader. */\n [Symbol.for('nodejs.util.inspect.custom')](): string {\n return 'FixLoader {}';\n }\n\n /** Timestamp of last successful load. */\n get lastLoadTime(): number | null {\n return this._lastLoadTime;\n }\n\n /**\n * Start the loader: perform initial load and start background refresh.\n *\n * Never throws — failures are logged and the runtime degrades gracefully.\n */\n start(): void {\n try {\n if (!this._config.enabled) {\n debug('Fix runtime disabled, skipping loader start');\n return;\n }\n\n if (!this._config.apiKey) {\n warn('No API key configured, fixes will not be loaded');\n return;\n }\n\n // Initial load (fire-and-forget — don't block startup). A failure gives\n // ONE WARNING, as the Python loader does: `initFixRuntime()` catches\n // every fault, so this is the only signal that a customer sees for a\n // 5xx, a 401 or a refused connection.\n this.loadSync().catch((e) => {\n warn(this._firstLoadWarning(e));\n });\n\n // Start background refresh\n if (this._config.autoRefresh) {\n this._startRefreshInterval();\n }\n } catch (e) {\n debug(`FixLoader.start error: ${this._scrub(e)}`);\n }\n }\n\n /** Stop the loader: clear the refresh interval. */\n stop(): void {\n try {\n if (this._refreshTimer !== null) {\n clearInterval(this._refreshTimer);\n this._refreshTimer = null;\n }\n } catch (e) {\n debug(`FixLoader.stop error: ${this._scrub(e)}`);\n }\n }\n\n /**\n * Register a callback invoked after each successful load.\n */\n onLoad(callback: (fixes: ActiveFix[]) => void): void {\n this._onLoadCallbacks.push(callback);\n }\n\n /**\n * Load fixes from the API.\n *\n * Name kept as \"loadSync\" for parity with the Python SDK, but this\n * returns a Promise in JS (there's no synchronous fetch in Node.js).\n */\n async loadSync(): Promise<ActiveFix[]> {\n if (!this._config.apiKey) {\n return [];\n }\n\n // Circuit breaker: skip if circuit is open\n const now = Date.now();\n if (\n this._consecutiveFailures >= FixLoader.CIRCUIT_BREAKER_THRESHOLD &&\n now < this._circuitOpenUntil\n ) {\n debug('Fix loader circuit breaker open — skipping load');\n return this._cache.getAll();\n }\n\n this._lastStatus = null;\n try {\n // ⚠ PATH AND HOST CHANGED 0.6.0 -> 0.7.0. This was\n // `{apiEndpoint}/api/v1/fixes/active`, and the `/api` prefix existed\n // only because a Caddy reverse proxy stripped it before forwarding to\n // FastAPI. The split has two hosts and no Caddy: the api serves\n // /v1/fixes/active directly, and the gateway host serves only /v1/spans.\n const endpoint = this._config.apiEndpoint.replace(/\\/+$/, '');\n const url = `${endpoint}/v1/fixes/active`;\n\n // AbortController for timeout\n const controller = new AbortController();\n const timeoutId = setTimeout(\n () => controller.abort(),\n this._config.timeoutMs,\n );\n\n const response = await fetch(url, {\n method: 'GET',\n headers: {\n 'Authorization': `Bearer ${this._config.apiKey}`,\n 'Content-Type': 'application/json',\n 'X-Risicare-SDK-Version': SDK_VERSION,\n },\n signal: controller.signal,\n });\n\n clearTimeout(timeoutId);\n\n if (!response.ok) {\n this._lastStatus = response.status;\n throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n }\n\n const data = (await response.json()) as Record<string, unknown>;\n const fixes = this._parseResponse(data);\n this._onLoadSuccess(fixes);\n return fixes;\n } catch (e) {\n this._onLoadFailure(e as Error);\n throw e;\n }\n }\n\n /** Get currently cached fixes without hitting the API. */\n getCached(): ActiveFix[] {\n return this._cache.getAll();\n }\n\n // ─── Private ────────────────────────────────────────────────────────────\n\n private _parseResponse(data: Record<string, unknown>): ActiveFix[] {\n const fixes: ActiveFix[] = [];\n const items =\n (data.fixes as unknown[]) ??\n (data.data as unknown[]) ??\n [];\n\n if (!Array.isArray(items)) return fixes;\n\n for (const item of items) {\n try {\n if (item && typeof item === 'object') {\n fixes.push(activeFixFromApiResponse(item as Record<string, unknown>));\n }\n } catch (e) {\n debug(`Failed to parse fix item: ${this._scrub(e)}`);\n }\n }\n\n return fixes;\n }\n\n private _onLoadSuccess(fixes: ActiveFix[]): void {\n this._lastLoadTime = Date.now();\n this._consecutiveFailures = 0;\n\n // Update cache\n this._cache.setAll(fixes);\n\n // Notify callbacks\n for (const callback of this._onLoadCallbacks) {\n try {\n callback(fixes);\n } catch (e) {\n debug(`Load callback error: ${this._scrub(e)}`);\n }\n }\n\n debug(`Loaded ${fixes.length} active fixes`);\n }\n\n private _onLoadFailure(error: Error): void {\n this._consecutiveFailures++;\n\n if (this._consecutiveFailures >= FixLoader.CIRCUIT_BREAKER_THRESHOLD) {\n this._circuitOpenUntil = Date.now() + FixLoader.CIRCUIT_BREAKER_COOLDOWN_MS;\n warn(\n `Fix loader circuit breaker opened after ${this._consecutiveFailures} failures. ` +\n `Cooldown: ${FixLoader.CIRCUIT_BREAKER_COOLDOWN_MS / 1000}s`,\n );\n } else {\n debug(\n `Fix load failed (attempt ${this._consecutiveFailures}): ${this._scrub(error)}`,\n );\n }\n }\n\n private _startRefreshInterval(): void {\n // Use exponential backoff on the refresh interval after failures\n const tick = (): void => {\n this.loadSync().catch((e) => {\n debug(`Background fix refresh failed: ${this._scrub(e)}`);\n });\n };\n\n this._refreshTimer = setInterval(\n () => {\n // Skip if circuit breaker is open (loadSync handles this,\n // but we also avoid the async overhead)\n if (\n this._consecutiveFailures >= FixLoader.CIRCUIT_BREAKER_THRESHOLD &&\n Date.now() < this._circuitOpenUntil\n ) {\n return;\n }\n tick();\n },\n this._config.refreshIntervalMs,\n );\n\n // unref() so the interval doesn't prevent Node.js process exit\n this._refreshTimer.unref();\n\n debug('Started fix refresh interval');\n }\n}\n","/**\n * Fix Runtime — Main orchestrator for the fix application system.\n *\n * FixRuntime is off by default (`init({ fixRuntime: true })` turns it on).\n * During the beta, the Risicare service does not give fixes to customer\n * projects, so FixRuntime has no effect for them. Manages:\n * - Loading active fixes from the API (via FixLoader)\n * - Caching fixes locally (via FixCache)\n * - Running fixes via interceptors on the paths that call them\n * - Tracking fix effectiveness\n *\n * The interceptor enforces guard fixes on the paths that call it. The\n * interceptor applies prompt, parameter and fallback fixes only when the call\n * has an `errorCode`. The provider path does not supply one, so it does not\n * apply them.\n *\n * Singleton management via globalThis (same pattern as the tracer).\n *\n * Port of Python SDK's runtime/runtime.py adapted for Node.js.\n */\n\nimport { FixCache } from './cache.js';\nimport type { ActiveFix, FixRuntimeConfig } from './config.js';\nimport { resolveFixRuntimeConfig } from './config.js';\nimport { FixApplier } from './applier.js';\nimport { FixLoader } from './loader.js';\nimport {\n DefaultFixInterceptor,\n createInterceptContext,\n GuardRejectedError,\n type FixInterceptor,\n type InterceptContext,\n} from './interceptors.js';\nimport { debug, warn } from '../utils/log.js';\n\n// ─── globalThis singleton key ───────────────────────────────────────────────\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst G = globalThis as any;\nconst RUNTIME_KEY = '__risicare_fix_runtime';\n\n// ─── Fix Runtime ────────────────────────────────────────────────────────────\n\nexport class FixRuntime {\n private readonly _config: Required<FixRuntimeConfig>;\n private readonly _cache: FixCache;\n private readonly _loader: FixLoader;\n private readonly _applier: FixApplier;\n private readonly _interceptor: DefaultFixInterceptor;\n private _started = false;\n\n // Effectiveness tracking\n private _fixApplications = new Map<string, number>();\n private _fixSuccesses = new Map<string, number>();\n\n constructor(config: FixRuntimeConfig) {\n this._config = resolveFixRuntimeConfig(config);\n this._cache = new FixCache(this._config);\n this._loader = new FixLoader(config, this._cache);\n this._applier = new FixApplier(config, this._cache);\n this._interceptor = new DefaultFixInterceptor(\n config,\n this._cache,\n this._applier,\n );\n }\n\n // ─── Accessors ──────────────────────────────────────────────────────────\n\n /** Runtime configuration (with defaults resolved). */\n get config(): Required<FixRuntimeConfig> {\n return this._config;\n }\n\n /** Whether the runtime is enabled and started. */\n get isEnabled(): boolean {\n return this._config.enabled && this._started;\n }\n\n /** The fix cache. */\n get cache(): FixCache {\n return this._cache;\n }\n\n /** The fix loader. */\n get loader(): FixLoader {\n return this._loader;\n }\n\n /** The fix applier. */\n get applier(): FixApplier {\n return this._applier;\n }\n\n /** The interceptor. */\n get interceptor(): FixInterceptor {\n return this._interceptor;\n }\n\n // ─── Lifecycle ──────────────────────────────────────────────────────────\n\n /**\n * Start the runtime.\n *\n * Triggers initial fix load and starts background refresh.\n * Never throws — failures degrade gracefully.\n */\n start(): void {\n try {\n if (this._started) return;\n\n if (!this._config.enabled) {\n debug('Fix runtime disabled');\n return;\n }\n\n debug('Starting fix runtime...');\n this._loader.start();\n this._started = true;\n debug('Fix runtime started');\n } catch (e) {\n warn(`Fix runtime start failed: ${e}`);\n }\n }\n\n /**\n * Stop the runtime.\n *\n * Stops background refresh and clears the cache.\n * Never throws.\n */\n stop(): void {\n try {\n if (!this._started) return;\n\n debug('Stopping fix runtime...');\n this._loader.stop();\n this._cache.clear();\n this._started = false;\n debug('Fix runtime stopped');\n } catch (e) {\n debug(`Fix runtime stop error: ${e}`);\n }\n }\n\n // ─── Intercept API ──────────────────────────────────────────────────────\n\n /**\n * Intercept a call: create context and run preCall fixes.\n *\n * Returns modified messages/params and the InterceptContext for\n * use in subsequent interceptResponse / interceptError calls.\n */\n interceptCall(\n operationType: string,\n operationName: string,\n messages: unknown[] | null,\n params: Record<string, unknown>,\n options?: {\n sessionId?: string;\n traceId?: string;\n errorCode?: string;\n },\n ): {\n messages: unknown[] | null;\n params: Record<string, unknown>;\n ctx: InterceptContext;\n } {\n const ctx = createInterceptContext(operationType, operationName, options);\n\n try {\n if (!this.isEnabled) {\n return { messages, params, ctx };\n }\n\n const result = this._interceptor.preCall(ctx, messages, params);\n return { messages: result.messages, params: result.params, ctx };\n } catch (e) {\n // PR-4+5 review B2: GuardRejectedError MUST surface to the provider\n // patcher so the LLM call is aborted. Everything else degrades to the\n // unmodified call (FixRuntime failures must never break customers).\n if (e instanceof GuardRejectedError) throw e;\n debug(`interceptCall error: ${e}`);\n return { messages, params, ctx };\n }\n }\n\n /**\n * Intercept a response: run postCall fixes (output validation).\n */\n interceptResponse(\n ctx: InterceptContext,\n response: unknown,\n ): { response: unknown; shouldContinue: boolean } {\n try {\n if (!this.isEnabled) {\n return { response, shouldContinue: true };\n }\n\n const result = this._interceptor.postCall(ctx, response);\n\n // Track success for effectiveness\n this._trackSuccess(ctx);\n\n return result;\n } catch (e) {\n // PR-4+5 review B2: same as interceptCall — output guard rejections\n // must surface; everything else degrades.\n if (e instanceof GuardRejectedError) throw e;\n debug(`interceptResponse error: ${e}`);\n return { response, shouldContinue: true };\n }\n }\n\n /**\n * Intercept an error: decide on retry/fallback.\n */\n interceptError(\n ctx: InterceptContext,\n error: Error,\n ): { shouldRetry: boolean; modifiedParams: Record<string, unknown> | null } {\n try {\n if (!this.isEnabled) {\n return { shouldRetry: false, modifiedParams: null };\n }\n\n ctx.attempt++;\n const result = this._interceptor.onError(ctx, error);\n\n // If not retrying, track failure for effectiveness\n if (!result.shouldRetry) {\n this._trackFailure(ctx);\n }\n\n return result;\n } catch (e) {\n debug(`interceptError error: ${e}`);\n return { shouldRetry: false, modifiedParams: null };\n }\n }\n\n // ─── Direct Fix Access ──────────────────────────────────────────────────\n\n /**\n * Get applicable fix for an error code.\n */\n getFix(errorCode: string, sessionId?: string): ActiveFix | null {\n try {\n if (!this.isEnabled) return null;\n return this._applier.getFixForError(errorCode, sessionId);\n } catch (e) {\n debug(`getFix error: ${e}`);\n return null;\n }\n }\n\n /**\n * Manually refresh fixes from the API.\n */\n async refreshFixes(): Promise<ActiveFix[]> {\n try {\n return await this._loader.loadSync();\n } catch (e) {\n debug(`refreshFixes error: ${e}`);\n return [];\n }\n }\n\n // ─── Effectiveness ──────────────────────────────────────────────────────\n\n /** Get effectiveness statistics for all fixes. */\n getEffectivenessStats(): Record<\n string,\n { applications: number; successes: number; successRate: number }\n > {\n const stats: Record<\n string,\n { applications: number; successes: number; successRate: number }\n > = {};\n\n for (const [fixId, applications] of this._fixApplications) {\n const successes = this._fixSuccesses.get(fixId) ?? 0;\n stats[fixId] = {\n applications,\n successes,\n successRate: applications > 0 ? successes / applications : 0,\n };\n }\n\n return stats;\n }\n\n // ─── Private ────────────────────────────────────────────────────────────\n\n private _trackSuccess(ctx: InterceptContext): void {\n for (const result of ctx.appliedFixes) {\n if (result.applied && result.fixId) {\n this._fixApplications.set(\n result.fixId,\n (this._fixApplications.get(result.fixId) ?? 0) + 1,\n );\n this._fixSuccesses.set(\n result.fixId,\n (this._fixSuccesses.get(result.fixId) ?? 0) + 1,\n );\n }\n }\n }\n\n private _trackFailure(ctx: InterceptContext): void {\n for (const result of ctx.appliedFixes) {\n if (result.applied && result.fixId) {\n this._fixApplications.set(\n result.fixId,\n (this._fixApplications.get(result.fixId) ?? 0) + 1,\n );\n // Don't increment success count\n }\n }\n }\n}\n\n// ─── Singleton Management ───────────────────────────────────────────────────\n\n/** Get the global FixRuntime instance, if initialized. */\nexport function getFixRuntime(): FixRuntime | undefined {\n return G[RUNTIME_KEY] as FixRuntime | undefined;\n}\n\n/** Set the global FixRuntime instance (for advanced use). */\nexport function setFixRuntime(runtime: FixRuntime): void {\n G[RUNTIME_KEY] = runtime;\n}\n\n/**\n * Initialize and start the global FixRuntime.\n *\n * If already initialized, returns the existing instance.\n * Never throws — initialization failures degrade gracefully.\n */\nexport function initFixRuntime(config: FixRuntimeConfig): FixRuntime {\n try {\n const existing = G[RUNTIME_KEY] as FixRuntime | undefined;\n if (existing) {\n debug('Fix runtime already initialized');\n return existing;\n }\n\n const runtime = new FixRuntime(config);\n runtime.start();\n G[RUNTIME_KEY] = runtime;\n return runtime;\n } catch (e) {\n warn(`initFixRuntime failed: ${e}`);\n // Return a disabled runtime so callers don't need null checks\n const fallback = new FixRuntime({ ...config, enabled: false });\n G[RUNTIME_KEY] = fallback;\n return fallback;\n }\n}\n\n/**\n * Shutdown and remove the global FixRuntime.\n *\n * Never throws.\n */\nexport function shutdownFixRuntime(): void {\n try {\n const runtime = G[RUNTIME_KEY] as FixRuntime | undefined;\n if (runtime) {\n runtime.stop();\n }\n G[RUNTIME_KEY] = undefined;\n } catch (e) {\n debug(`shutdownFixRuntime error: ${e}`);\n G[RUNTIME_KEY] = undefined;\n }\n}\n","/**\n * Agent context — identifies which agent is executing.\n * Supports nesting: inner agents automatically track parent.\n */\n\nimport { generateAgentId } from '../ids.js';\nimport { runWithContext, getCurrentAgent, type AgentContext } from './storage.js';\n\nexport interface AgentOptions {\n agentId?: string;\n name?: string;\n role?: string;\n agentType?: string;\n version?: number;\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Run a callback within an agent context.\n * If nested inside another agent, parentAgentId is set automatically.\n *\n * @example\n * await withAgent({ name: 'researcher', role: 'worker' }, async () => {\n * const result = await llm.invoke(query);\n * return result;\n * });\n */\nexport function withAgent<T>(options: AgentOptions, fn: () => T): T {\n const parent = getCurrentAgent();\n const agentName = options.name ?? 'agent';\n\n const agent: AgentContext = {\n agentId: options.agentId ?? generateAgentId(agentName),\n agentName: agentName,\n agentRole: options.role,\n agentType: options.agentType,\n parentAgentId: parent?.agentId,\n version: options.version,\n metadata: options.metadata,\n };\n\n return runWithContext({ agent }, fn);\n}\n","/**\n * Lifecycle end-marker (F-B-012) — the JS SDK's run-end signal.\n *\n * At agent() / session() / phase / multi-agent context-manager exit the SDK\n * emits a lifecycle-end marker so downstream (\"did this run finish or die?\")\n * is answerable. The marker is three attributes carried on a span via the open\n * `attributes` map (schema-contract.md \"attribute-first\") plus the typed status:\n *\n * risicare.lifecycle.event = \"end\"\n * risicare.lifecycle.entity = \"session\" | \"agent\" | \"trace\"\n * risicare.lifecycle.status = \"ok\" (normal exit) | \"error\" (the body threw)\n *\n * Mirrors the Python SDK (packages/risicare-sdk/src/risicare/decorators.py).\n * See fix-workstream/F-B-012-DESIGN-CONTRACT.md for the settled contract.\n */\n\nimport type { Span } from './span.js';\nimport { getTracer } from './client.js';\nimport { SpanKind, SpanStatus } from './types.js';\nimport { cutCodePoints } from './utils/text.js';\n\nexport const LIFECYCLE_EVENT = 'risicare.lifecycle.event';\nexport const LIFECYCLE_ENTITY = 'risicare.lifecycle.entity';\nexport const LIFECYCLE_STATUS = 'risicare.lifecycle.status';\n\n// Cap the exception summary so a huge message can't bloat the span. The cap\n// counts code points, so it never cuts a surrogate pair (utils/text.ts).\nconst STATUS_MESSAGE_MAX = 500;\n\nexport type LifecycleEntity = 'session' | 'agent' | 'trace';\n\nfunction excSummary(error: unknown): string {\n if (error instanceof Error) {\n return cutCodePoints(`${error.constructor.name}: ${error.message}`, STATUS_MESSAGE_MAX);\n }\n return cutCodePoints(String(error), STATUS_MESSAGE_MAX);\n}\n\n/**\n * Stamp the three lifecycle-end marker attributes + typed status on a span.\n *\n * Best-effort: a marker failure must never crash the host. When `span` is the\n * NOOP span (tracer disabled) its setters are no-ops so nothing is exported\n * (zero-overhead).\n */\nexport function stampEndMarker(\n span: Span,\n entity: LifecycleEntity,\n error: unknown | undefined,\n): void {\n try {\n const statusValue = error !== undefined ? 'error' : 'ok';\n span.setAttribute(LIFECYCLE_EVENT, 'end');\n span.setAttribute(LIFECYCLE_ENTITY, entity);\n span.setAttribute(LIFECYCLE_STATUS, statusValue);\n if (error !== undefined) {\n span.setStatus(SpanStatus.ERROR, excSummary(error));\n }\n } catch {\n // Never crash the host application.\n }\n}\n\n/**\n * Run `body` and stamp the lifecycle end-marker on `span` at completion —\n * `ok` on normal return, `error` on throw (then re-throw; host semantics\n * unchanged). Handles both sync results and Promises (SDK-004 parity).\n *\n * Intended to wrap the inner-body callback of an entity-span decorator, e.g.\n * tracer.startSpan({ ... }, (span) => withEndMarker(span, 'agent', () => fn()))\n */\nexport function withEndMarker<T>(span: Span, entity: LifecycleEntity, body: () => T): T {\n let result: T;\n try {\n result = body();\n } catch (error) {\n stampEndMarker(span, entity, error);\n throw error;\n }\n\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n stampEndMarker(span, entity, undefined);\n return value;\n },\n (error) => {\n stampEndMarker(span, entity, error);\n throw error;\n },\n ) as unknown as T;\n }\n\n stampEndMarker(span, entity, undefined);\n return result;\n}\n\n/**\n * Emit a dedicated, near-zero-duration `session.end` marker span for the\n * session() path (which owns no span of its own).\n *\n * MUST be called INSIDE the active session context so the tracer auto-stamps\n * the span's `sessionId` from the current session — the worker needs that to\n * attribute the marker. Best-effort: never crashes the host. When the tracer\n * is disabled, startSpan runs over the NOOP span and nothing is exported.\n */\nexport function emitSessionEndMarker(error: unknown | undefined): void {\n try {\n const tracer = getTracer();\n if (!tracer) return;\n const statusValue = error !== undefined ? 'error' : 'ok';\n tracer.startSpan(\n {\n name: 'session.end',\n kind: SpanKind.INTERNAL,\n attributes: {\n [LIFECYCLE_EVENT]: 'end',\n [LIFECYCLE_ENTITY]: 'session',\n [LIFECYCLE_STATUS]: statusValue,\n },\n },\n (span) => {\n if (error !== undefined) {\n span.setStatus(SpanStatus.ERROR, excSummary(error));\n }\n },\n );\n } catch {\n // Never crash the host application.\n }\n}\n\n/**\n * Run `body` inside the active session context and emit the `session.end`\n * marker at completion — ok on normal return, error on throw (then re-throw).\n * Handles both sync results and Promises (SDK-004 parity).\n */\nexport function withSessionEndMarker<T>(body: () => T): T {\n let result: T;\n try {\n result = body();\n } catch (error) {\n emitSessionEndMarker(error);\n throw error;\n }\n\n if (result instanceof Promise) {\n return result.then(\n (value) => {\n emitSessionEndMarker(undefined);\n return value;\n },\n (error) => {\n emitSessionEndMarker(error);\n throw error;\n },\n ) as unknown as T;\n }\n\n emitSessionEndMarker(undefined);\n return result;\n}\n","/**\n * agent() — Higher-order function wrapper for agent identity (Tier 2).\n *\n * Wraps a function to execute within an agent context. All spans created\n * inside will be tagged with the agent's identity.\n *\n * Two equivalent calling forms are supported:\n *\n * // 2-arg form\n * const research = agent({ name: 'researcher' }, async (q) => { ... });\n *\n * // Curried form (decorator factory)\n * const research = agent({ name: 'researcher' })(async (q) => { ... });\n *\n * Both return a wrapped function — call it to actually run the body inside\n * the agent context.\n *\n * @example\n * const research = agent({ name: 'researcher', role: 'worker' }, async (query: string) => {\n * const result = await openai.chat.completions.create({ ... });\n * return result.choices[0].message.content;\n * });\n *\n * const answer = await research('What is quantum computing?');\n */\n\nimport { withAgent, type AgentOptions } from '../context/agent.js';\nimport { generateAgentId } from '../ids.js';\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { withEndMarker } from '../lifecycle.js';\n\n// Type-narrowing helper for the wrapper produced by both calling forms.\nfunction _wrapAgent<TArgs extends unknown[], TReturn>(\n options: AgentOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n // F-015: an unnamed agent takes the function's name, as in Python\n // (`fn.__name__`). An anonymous function keeps the name 'agent'. A bound\n // function is named \"bound foo\" (once for each bind); Python's bound method\n // is \"foo\", so the prefix is removed.\n const agentName = options.name ?? (fn.name.replace(/^(bound )+/, '') || 'agent');\n const spanName = `agent:${agentName}`;\n // ── F-AGENTID-JS-001 (W36/session-1a): MINT THE ID AT WRAP TIME, NOT PER CALL ──\n // ⚠ THE TWO SDKs PUT THE SAME FIELD NAME ON TWO DIFFERENT SEMANTICS, AND ONLY ONE\n // OF THEM CAN BE RIGHT. Python mints inside `decorator(fn)` — ONE id per (function\n // x process), and its `agent_context()` will not mint at all (agent_id is a\n // REQUIRED positional there, so the decorator is Python's only minting site).\n // JS minted inside `withAgent`, i.e. on EVERY INVOCATION: measured by execution,\n // three calls to one wrapped function produced three distinct `agent_id`s.\n //\n // The consequence is server-side and it is not cosmetic. `agent_id` is the grain of\n // `agent_spans`, so a JS customer's agent cardinality grows with TRAFFIC, not with\n // how many agents they wrote — measured on the lab: 10 distinct `agent_name`\n // against 151,552 distinct `agent_id`. That is what made the KPI read \"151.6K\n // agents\" (F-AGENTCOUNT-001) and what made GET /v1/agents/topology materialise\n // 151,552 nodes and OOM the whole API (F-TOPOOM-001). Same root, three surfaces.\n //\n // `spanName` above was ALREADY computed here, at wrap time — this line simply gives\n // the identity the same lifetime the label already had.\n //\n // ⚠ BOUND, stated so nobody reads more into this than it does: a caller using the\n // exported `withAgent()` DIRECTLY still gets a fresh id per call when they pass no\n // `agentId`. That is deliberate — `withAgent` is the twin of Python's\n // `agent_context()`, which has no minting behaviour to match, and removing the\n // fallback would be a breaking change to a published API. `agent()` is the\n // documented Tier-2 surface and the one both READMEs show.\n //\n // ⚠ NOT IN SCOPE and NOT decided here: whether `agent_id` should be stable ACROSS\n // processes. That is an OTel-semantics ruling (`service.instance.id` vs logical\n // identity) and belongs to the lead. This change only makes JS behave the way\n // Python already does.\n const agentId = options.agentId ?? generateAgentId(agentName);\n const boundOptions: AgentOptions = { ...options, name: agentName, agentId };\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) {\n // Graceful degradation: run user code without tracing\n return fn(...args);\n }\n return withAgent(boundOptions, () => {\n // F-B-012: stamp the lifecycle end-marker (entity=\"agent\") on the entity\n // span — ok on normal exit, error on throw (then re-throw).\n return tracer.startSpan({ name: spanName, kind: SpanKind.AGENT }, (span) =>\n withEndMarker(span, 'agent', () => fn(...args)),\n );\n });\n };\n}\n\n// Overloads — typed for both calling forms.\nexport function agent<TArgs extends unknown[], TReturn>(\n options: AgentOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\nexport function agent(\n options: AgentOptions,\n): <TArgs extends unknown[], TReturn>(\n fn: (...args: TArgs) => TReturn,\n) => (...args: TArgs) => TReturn;\nexport function agent<TArgs extends unknown[], TReturn>(\n options: AgentOptions,\n fn?: (...args: TArgs) => TReturn,\n): unknown {\n // Curried form: agent(options)(fn). Return a factory that accepts fn.\n if (fn === undefined) {\n return <TA extends unknown[], TR>(realFn: (...args: TA) => TR) =>\n _wrapAgent(options, realFn);\n }\n // 2-arg form: agent(options, fn). Wrap directly.\n return _wrapAgent(options, fn);\n}\n","/**\n * Session context — groups multiple traces from the same user interaction.\n */\n\nimport { runWithContext, type SessionContext } from './storage.js';\nimport { withSessionEndMarker } from '../lifecycle.js';\n\nexport interface SessionOptions {\n sessionId: string;\n userId?: string;\n metadata?: Record<string, unknown>;\n parentSessionId?: string;\n turnNumber?: number;\n}\n\n/**\n * Run a callback within a session context.\n *\n * @example\n * await withSession({ sessionId: 'sess-123', userId: 'user-1' }, async () => {\n * const result = await agent.run(query);\n * return result;\n * });\n */\nexport function withSession<T>(options: SessionOptions, fn: () => T): T {\n const session: SessionContext = {\n sessionId: options.sessionId,\n userId: options.userId,\n metadata: options.metadata,\n parentSessionId: options.parentSessionId,\n turnNumber: options.turnNumber ?? 1,\n };\n // F-R-SESSIONCMEND-001. `withSession` and `session()` are both exported from\n // index.ts, side by side under one \"Tier 3: Sessions\" heading, as\n // alternatives. Until this line the decorator emitted the `session.end`\n // lifecycle marker and this — the plainer, more obvious spelling — emitted\n // nothing, so which behaviour a customer got depended only on which name they\n // reached for. `routers/sessions.py::_SESSION_AGG_SELECT` computes\n // `is_active` as NOT(a span carrying BOTH `risicare.lifecycle.event='end'`\n // AND `.entity='session'`), so a `withSession` session read ACTIVE FOREVER.\n //\n // The marker is emitted INSIDE `runWithContext` so the tracer stamps\n // sessionId from the active context. `withSessionEndMarker` is now the ONE\n // definition — `decorators/session.ts` no longer wraps separately, so the two\n // paths cannot drift apart again.\n return runWithContext({ session }, () => withSessionEndMarker(fn));\n}\n","/**\n * session() — Higher-order function wrapper for session context (Tier 3).\n *\n * Wraps a function to execute within a session context. All spans created\n * inside will be tagged with the session identity.\n *\n * @example\n * const handleRequest = session(\n * (req) => ({ sessionId: req.sessionId, userId: req.userId }),\n * async (req: Request) => {\n * return await agent.run(req.query);\n * },\n * );\n */\n\nimport { withSession, type SessionOptions } from '../context/session.js';\n\nfunction _wrapSession<TArgs extends unknown[], TReturn>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const options =\n typeof optionsOrResolver === 'function'\n ? optionsOrResolver(...args)\n : optionsOrResolver;\n // F-B-012 / F-R-SESSIONCMEND-001: the `session.end` marker is emitted by\n // `withSession` itself, so both public session APIs share ONE definition.\n // Wrapping again here would emit the marker twice.\n return withSession(options, () => fn(...args));\n };\n}\n\n/**\n * Blocks inference from the resolver, so that the target function alone\n * decides `TArgs` (F-020). The resolver may declare fewer parameters than the\n * target, as the documented `(sessionId, userId) => ...` resolver does.\n * Written without the built-in `NoInfer` (TypeScript 5.4+) because the\n * package supports TypeScript 5.0.\n */\ntype NoInferArgs<T> = [T][T extends unknown ? 0 : never];\n\n/**\n * Wrap a function with session context.\n *\n * Two equivalent calling forms are supported (F-54 ergonomics):\n *\n * // 2-arg form\n * const handle = session({ sessionId: 's1' }, async (req) => { ... });\n *\n * // Curried form (decorator factory)\n * const handle = session({ sessionId: 's1' })(async (req) => { ... });\n *\n * @param optionsOrResolver - Static session options, or a function that derives them from args\n * @param fn - The function to wrap. If omitted, returns a decorator factory.\n */\nexport function session<TArgs extends unknown[], TReturn>(\n optionsOrResolver: SessionOptions | ((...args: NoInferArgs<TArgs>) => SessionOptions),\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn;\nexport function session(\n options: SessionOptions,\n): <TArgs extends unknown[], TR>(fn: (...args: TArgs) => TR) => (...args: TArgs) => TR;\nexport function session<TArgs extends unknown[]>(\n resolver: (...args: TArgs) => SessionOptions,\n): <TR>(fn: (...args: TArgs) => TR) => (...args: TArgs) => TR;\n// The 0.7.1 form, kept so that existing callers still compile: an argument\n// typed as the union, and an explicit type argument (`session<[string]>(...)`).\nexport function session<TArgs extends unknown[]>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n): <TR>(fn: (...args: TArgs) => TR) => (...args: TArgs) => TR;\nexport function session<TArgs extends unknown[], TReturn>(\n optionsOrResolver: SessionOptions | ((...args: TArgs) => SessionOptions),\n fn?: (...args: TArgs) => TReturn,\n): unknown {\n if (fn === undefined) {\n return <TR>(realFn: (...args: TArgs) => TR) =>\n _wrapSession(optionsOrResolver, realFn);\n }\n return _wrapSession(optionsOrResolver, fn);\n}\n","/**\n * Phase context — cognitive phase tracking (THINK/DECIDE/ACT/OBSERVE).\n */\n\nimport { SemanticPhase } from '../types.js';\nimport { runWithContext } from './storage.js';\n\n/**\n * Run a callback within a semantic phase context.\n */\nexport function withPhase<T>(phase: SemanticPhase, fn: () => T): T {\n return runWithContext({ phase }, fn);\n}\n","/**\n * Phase decorators — decision phase tracking (Tier 4).\n *\n * Wraps functions to execute within a semantic phase context (THINK/DECIDE/ACT/OBSERVE).\n * Each creates a span. The named form uses the given name. The bare form uses\n * `<phase>:<function name>` (for example `think:analyzeQuery`), as the Python\n * SDK does; an anonymous function gives `phase:<phase>` (for example `phase:think`).\n *\n * @example\n * const analyze = traceThink(async (data: string) => {\n * return await llm.invoke(`Analyze: ${data}`);\n * });\n *\n * const decide = traceDecide(async (analysis: string) => {\n * return await llm.invoke(`Decide action: ${analysis}`);\n * });\n */\n\nimport { withPhase } from '../context/phase.js';\nimport { getTracer } from '../client.js';\nimport { SemanticPhase, SpanKind } from '../types.js';\nimport { withEndMarker } from '../lifecycle.js';\n\n/**\n * F-016: the span name of the bare form, the same as Python's `<phase>:<fn>`.\n * The \"bound \" prefix of a bound function (once for each bind) is removed.\n */\nfunction bareName(phase: string, fn: unknown): string {\n const fnName = typeof fn === 'function' ? fn.name.replace(/^(bound )+/, '') : '';\n return fnName ? `${phase}:${fnName}` : `phase:${phase}`;\n}\n\nfunction phaseWrapper<TArgs extends unknown[], TReturn>(\n phase: SemanticPhase,\n kind: SpanKind,\n name: string,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) {\n return fn(...args);\n }\n return withPhase(phase, () => {\n // F-B-012: phase decorators are @trace-family — stamp the lifecycle\n // end-marker (entity=\"trace\") for uniform emission.\n return tracer.startSpan({ name, kind }, (span) =>\n withEndMarker(span, 'trace', () => fn(...args)),\n );\n });\n };\n}\n\n/**\n * Wrap a function in a THINK phase context with auto-span.\n *\n * @example traceThink(async () => { ... })\n * @example traceThink(\"analyze-data\", async () => { ... })\n */\nexport function traceThink<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : bareName('think', fnOrName);\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.THINK, SpanKind.THINK, name, fn);\n}\n\n/**\n * Wrap a function in a DECIDE phase context with auto-span.\n *\n * @example traceDecide(async () => { ... })\n * @example traceDecide(\"choose-action\", async () => { ... })\n */\nexport function traceDecide<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : bareName('decide', fnOrName);\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.DECIDE, SpanKind.DECIDE, name, fn);\n}\n\n/**\n * Wrap a function in an ACT phase context with auto-span.\n *\n * @example traceAct(async () => { ... })\n * @example traceAct(\"execute-tool\", async () => { ... })\n */\nexport function traceAct<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : bareName('act', fnOrName);\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.ACT, SpanKind.TOOL_CALL, name, fn);\n}\n\n/**\n * Wrap a function in an OBSERVE phase context with auto-span.\n *\n * @example traceObserve(async () => { ... })\n * @example traceObserve(\"check-result\", async () => { ... })\n */\nexport function traceObserve<TArgs extends unknown[], TReturn>(\n fnOrName: ((...args: TArgs) => TReturn) | string,\n maybeFn?: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const name = typeof fnOrName === 'string' ? fnOrName : bareName('observe', fnOrName);\n const fn = typeof fnOrName === 'function' ? fnOrName : maybeFn!;\n return phaseWrapper(SemanticPhase.OBSERVE, SpanKind.OBSERVE, name, fn);\n}\n","/**\n * Multi-agent communication decorators (Tier 5).\n *\n * Track inter-agent messages, delegations, and coordination.\n *\n * @example\n * const sendToWorker = traceMessage({ to: 'worker-1', type: MessageType.DELEGATE },\n * async (task: string) => { ... }\n * );\n */\n\nimport { getTracer } from '../client.js';\nimport { MessageType, SpanKind } from '../types.js';\nimport { withEndMarker } from '../lifecycle.js';\n\ninterface MessageOptions {\n to: string;\n type?: MessageType;\n metadata?: Record<string, unknown>;\n}\n\ninterface DelegateOptions {\n to: string;\n metadata?: Record<string, unknown>;\n}\n\ninterface CoordinateOptions {\n participants: string[];\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Namespace user metadata under 'metadata.*' to prevent overwriting\n * critical span attributes like message.type, message.to, etc.\n */\nfunction namespacedMetadata(metadata?: Record<string, unknown>): Record<string, unknown> {\n if (!metadata) return {};\n const result: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(metadata)) {\n result[`metadata.${key}`] = value;\n }\n return result;\n}\n\n/**\n * Wrap a function that sends a message to another agent.\n */\nexport function traceMessage<TArgs extends unknown[], TReturn>(\n options: MessageOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n const msgType = options.type ?? MessageType.REQUEST;\n\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) return fn(...args);\n return tracer.startSpan(\n {\n name: `message:${msgType}→${options.to}`,\n kind: SpanKind.MESSAGE,\n attributes: {\n ...namespacedMetadata(options.metadata),\n 'message.to': options.to,\n 'message.type': msgType,\n 'message.target_agent_id': options.to,\n },\n },\n // F-B-012: multi-agent decorators are @trace-family — entity=\"trace\".\n (span) => withEndMarker(span, 'trace', () => fn(...args)),\n );\n };\n}\n\n/**\n * Wrap a function that delegates work to a sub-agent.\n */\nexport function traceDelegate<TArgs extends unknown[], TReturn>(\n options: DelegateOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) return fn(...args);\n return tracer.startSpan(\n {\n name: `delegate→${options.to}`,\n kind: SpanKind.DELEGATION,\n attributes: {\n ...namespacedMetadata(options.metadata),\n 'delegate.to': options.to,\n 'message.type': MessageType.DELEGATE,\n 'message.target_agent_id': options.to,\n },\n },\n // F-B-012: multi-agent decorators are @trace-family — entity=\"trace\".\n (span) => withEndMarker(span, 'trace', () => fn(...args)),\n );\n };\n}\n\n/**\n * Wrap a function that coordinates multiple agents.\n */\nexport function traceCoordinate<TArgs extends unknown[], TReturn>(\n options: CoordinateOptions,\n fn: (...args: TArgs) => TReturn,\n): (...args: TArgs) => TReturn {\n return (...args: TArgs): TReturn => {\n const tracer = getTracer();\n if (!tracer) return fn(...args);\n return tracer.startSpan(\n {\n name: `coordinate:[${options.participants.join(',')}]`,\n kind: SpanKind.COORDINATION,\n attributes: {\n ...namespacedMetadata(options.metadata),\n 'coordinate.participants': options.participants.join(','),\n 'message.type': MessageType.COORDINATE,\n },\n },\n // F-B-012: multi-agent decorators are @trace-family — entity=\"trace\".\n (span) => withEndMarker(span, 'trace', () => fn(...args)),\n );\n };\n}\n","/**\n * Serializable trace context + W3C Trace Context headers.\n *\n * TraceContext is a plain object that can be passed across process\n * boundaries (JSON serialization, HTTP headers, message queues).\n *\n * W3C Trace Context:\n * traceparent: {version}-{trace_id}-{span_id}-{flags}\n * tracestate: risicare=session_id={...};agent_id={...}\n */\n\nimport { generateTraceId, generateSpanId, validateTraceId, validateSpanId } from '../ids.js';\nimport { getCurrentSpan, getCurrentSession, getCurrentAgent, getContext, hasContextScope } from './storage.js';\n\n// ─── Serializable Trace Context ──────────────────────────────────────────────\n\nexport interface TraceContext {\n traceId: string;\n spanId: string;\n sessionId?: string;\n agentId?: string;\n}\n\n/**\n * Get the current trace context as a serializable object.\n *\n * When called inside a span context, returns the active span's IDs.\n * When called outside a span but inside a context scope (for example inside\n * `withSession()`, `withAgent()` or `withPhase()`), pre-allocates a trace ID\n * and stores it in that scope. The ID stays in the scope. EVERY later root\n * span in that scope uses it: the next span, each span after it, and spans\n * that start at the same time (for example in `Promise.all`). So all root\n * spans of the scope are in one trace. Later calls return the same ID.\n *\n * Outside every context scope there is no place to store the ID: each call\n * returns a new trace ID, and the next span does not use it.\n */\nexport function getTraceContext(): TraceContext {\n const span = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n\n let traceId: string;\n if (span) {\n traceId = span.traceId;\n } else {\n // No active span — check for a previously pre-allocated root trace ID\n const ctx = getContext();\n if (ctx._rootTraceId) {\n traceId = ctx._rootTraceId;\n } else {\n // Pre-allocate and store so startSpan() will inherit this ID\n traceId = generateTraceId();\n // Store it in the current context scope, if one exists (F-014: any\n // scope, not only a session or agent scope). Mutating the store object\n // is safe: runWithContext gives each scope its own copy. Outside every\n // scope getContext() returns a new empty object, so nothing is kept.\n if (hasContextScope()) {\n (ctx as Record<string, unknown>)._rootTraceId = traceId;\n }\n }\n }\n\n return {\n traceId,\n spanId: span?.spanId ?? generateSpanId(),\n sessionId: session?.sessionId,\n agentId: agent?.agentId,\n };\n}\n\n// ─── W3C Trace Context Headers ───────────────────────────────────────────────\n\nconst TRACEPARENT_HEADER = 'traceparent';\nconst TRACESTATE_HEADER = 'tracestate';\nconst RISICARE_STATE_DELIMITER = ';';\n\n/**\n * Inject trace context into HTTP headers (W3C format).\n */\nexport function injectTraceContext(headers: Record<string, string>): Record<string, string> {\n const span = getCurrentSpan();\n const session = getCurrentSession();\n const agent = getCurrentAgent();\n\n if (span) {\n // W3C traceparent: version-trace_id-span_id-flags\n headers[TRACEPARENT_HEADER] = `00-${span.traceId}-${span.spanId}-01`;\n\n // Custom tracestate for Risicare (uses ';' as internal delimiter)\n // Preserve other vendors' tracestate entries per W3C spec\n const parts: string[] = [];\n if (session) parts.push(`session_id=${session.sessionId}`);\n if (agent) parts.push(`agent_id=${agent.agentId}`);\n\n if (parts.length > 0) {\n const riscareEntry = `risicare=${parts.join(RISICARE_STATE_DELIMITER)}`;\n const existing = headers[TRACESTATE_HEADER] ?? '';\n // Keep non-risicare vendor entries from any existing tracestate\n const otherEntries = existing\n .split(',')\n .map((e) => e.trim())\n .filter((e) => e && !e.startsWith('risicare='));\n headers[TRACESTATE_HEADER] = [riscareEntry, ...otherEntries].join(',');\n }\n }\n\n return headers;\n}\n\n/**\n * Extract trace context from HTTP headers (W3C format).\n *\n * Accepts a plain string record or Node's `IncomingHttpHeaders`\n * (`req.headers`). For a header with several values (`string[]`) the first\n * value is used. An `undefined` value is ignored.\n */\nexport function extractTraceContext(\n headers: Record<string, string | string[] | undefined>,\n): Record<string, string | undefined> {\n const result: Record<string, string | undefined> = {};\n\n // Normalize header keys to lowercase (HTTP headers are case-insensitive)\n const normalizedHeaders: Record<string, string> = {};\n for (const [key, value] of Object.entries(headers)) {\n const first = Array.isArray(value) ? value[0] : value;\n if (typeof first === 'string') normalizedHeaders[key.toLowerCase()] = first;\n }\n\n // Parse traceparent\n const traceparent = normalizedHeaders[TRACEPARENT_HEADER] ?? '';\n if (traceparent) {\n const parts = traceparent.split('-');\n if (parts.length >= 4) {\n const traceId = parts[1].toLowerCase();\n const spanId = parts[2].toLowerCase();\n if (validateTraceId(traceId)) result.traceId = traceId;\n if (validateSpanId(spanId)) result.parentSpanId = spanId;\n result.flags = parts[3];\n }\n }\n\n // Parse tracestate\n const tracestate = normalizedHeaders[TRACESTATE_HEADER] ?? '';\n if (tracestate) {\n for (const entry of tracestate.split(',')) {\n const trimmed = entry.trim();\n if (trimmed.startsWith('risicare=')) {\n const state = trimmed.slice(9); // len(\"risicare=\")\n for (const kv of state.split(RISICARE_STATE_DELIMITER)) {\n const eqIdx = kv.indexOf('=');\n if (eqIdx > 0) {\n const key = kv.slice(0, eqIdx).trim();\n const value = kv.slice(eqIdx + 1).trim();\n if (key && value) {\n // Normalize known tracestate keys to camelCase\n const camelKey = key === 'session_id' ? 'sessionId'\n : key === 'agent_id' ? 'agentId'\n : key;\n result[camelKey] = value;\n }\n }\n }\n }\n }\n }\n\n return result;\n}\n","/**\n * Span registry — TTL-based span store for edge cases.\n *\n * While AsyncLocalStorage handles most context propagation in Node.js,\n * the registry is useful for:\n * - Cross-process span tracking\n * - Explicit span passing via ID\n * - Long-running operations that outlive their original context\n */\n\nimport type { Span } from '../span.js';\nimport { getRegistry, getOpCount, setOpCount } from '../globals.js';\n\ninterface RegistryEntry {\n span: Span;\n registeredAt: number;\n ttlMs: number;\n}\n\nconst DEFAULT_TTL_MS = 60_000;\nconst MAX_ENTRIES = 10_000;\nconst CLEANUP_INTERVAL = 100;\n\nfunction entries(): Map<string, RegistryEntry> {\n return getRegistry() as Map<string, RegistryEntry>;\n}\n\nexport function registerSpan(span: Span, ttlMs = DEFAULT_TTL_MS): void {\n entries().set(span.spanId, {\n span,\n registeredAt: Date.now(),\n ttlMs,\n });\n setOpCount(getOpCount() + 1);\n maybeCleanup();\n}\n\nexport function getSpanById(spanId: string): Span | undefined {\n const entry = entries().get(spanId);\n if (!entry) return undefined;\n\n if (Date.now() - entry.registeredAt > entry.ttlMs) {\n entries().delete(spanId);\n return undefined;\n }\n\n return entry.span;\n}\n\nexport function unregisterSpan(spanId: string): void {\n entries().delete(spanId);\n}\n\nexport function extendSpanTtl(spanId: string, additionalMs: number): boolean {\n const entry = entries().get(spanId);\n if (!entry) return false;\n\n if (Date.now() - entry.registeredAt > entry.ttlMs) {\n entries().delete(spanId);\n return false;\n }\n\n entry.ttlMs += additionalMs;\n return true;\n}\n\nexport function getRegistryStats(): { totalEntries: number; operationCount: number } {\n return {\n totalEntries: entries().size,\n operationCount: getOpCount(),\n };\n}\n\nexport function clearRegistry(): void {\n entries().clear();\n setOpCount(0);\n}\n\nfunction maybeCleanup(): void {\n if (getOpCount() % CLEANUP_INTERVAL !== 0) return;\n if (entries().size <= MAX_ENTRIES) return;\n\n const now = Date.now();\n for (const [id, entry] of entries()) {\n if (now - entry.registeredAt > entry.ttlMs) {\n entries().delete(id);\n }\n }\n}\n","/**\n * tracedStream — Wrap an async iterable in a trace span.\n *\n * Creates a span that starts when iteration begins and ends when\n * iteration completes (or errors). Chunks pass through UNCHANGED.\n *\n * This is the user-level streaming utility. The OpenAI, Anthropic, Groq,\n * Cerebras and Together patches do not read a stream; the Google, Cohere,\n * Mistral and Ollama patches do (see each provider's patch).\n *\n * Usage:\n * const stream = await openai.chat.completions.create({ stream: true, ... });\n * for await (const chunk of tracedStream(stream, { name: 'llm-stream' })) {\n * process(chunk);\n * }\n */\n\nimport { getTracer } from './client.js';\nimport { SpanKind } from './types.js';\n\nexport interface TracedStreamOptions {\n /** Span name */\n name: string;\n /** Span kind (default: INTERNAL) */\n kind?: SpanKind;\n /** Additional span attributes */\n attributes?: Record<string, unknown>;\n}\n\n/**\n * Wrap an async iterable in a trace span.\n *\n * - Span starts on first iteration\n * - chunk_count attribute set when iteration ends\n * - On error: span records exception, error re-thrown to caller\n * - On early break: span ended cleanly via finally\n * - If SDK not initialized: chunks pass through without wrapping\n */\nexport async function* tracedStream<T>(\n source: AsyncIterable<T>,\n options: TracedStreamOptions | string,\n): AsyncGenerator<T, void, undefined> {\n const opts = typeof options === 'string' ? { name: options } : options;\n\n // Graceful degradation: if SDK not initialized, pass through\n const tracer = getTracer();\n if (!tracer || !tracer.enabled) {\n yield* source;\n return;\n }\n\n const span = tracer.createSpan({\n name: opts.name,\n kind: opts.kind ?? SpanKind.INTERNAL,\n attributes: opts.attributes,\n });\n\n let chunkCount = 0;\n\n try {\n for await (const chunk of source) {\n chunkCount++;\n yield chunk;\n }\n\n span.setAttribute('stream.chunk_count', chunkCount);\n span.setAttribute('stream.completed', true);\n } catch (error) {\n span.setAttribute('stream.chunk_count', chunkCount);\n span.setAttribute('stream.completed', false);\n span.recordException(error instanceof Error ? error : String(error));\n throw error;\n } finally {\n span.end();\n }\n}\n","/**\n * Double-tracing prevention for framework integrations.\n *\n * When a framework integration (e.g., LlamaIndex handler) creates its own\n * LLM span, the underlying provider proxy (e.g., patchOpenAI) would also\n * create a duplicate span. This module provides suppression:\n *\n * - Framework integrations SET suppression via suppressProviderInstrumentation()\n * - Provider proxies CHECK via isProviderInstrumentationSuppressed() and skip\n *\n * Scoped to AsyncLocalStorage — concurrent calls are independent.\n */\n\nimport { getContext, runWithContext } from './storage.js';\n\n/**\n * Run a callback with provider instrumentation suppressed.\n *\n * During this callback, all provider instrumentors (patchOpenAI, etc.) will\n * skip span creation. The framework is responsible for creating the span.\n *\n * @param fn - The function to run with suppression active\n * @returns The function's return value\n */\nexport function suppressProviderInstrumentation<T>(fn: () => T): T {\n return runWithContext({ _suppressProviderInstrumentation: true }, fn);\n}\n\n/**\n * Check if provider instrumentation should be suppressed.\n *\n * Called by provider instrumentors as an early-exit guard. When true,\n * the provider calls the original method directly without creating a span.\n */\nexport function isProviderInstrumentationSuppressed(): boolean {\n return getContext()._suppressProviderInstrumentation === true;\n}\n","/**\n * LangChain.js integration via callback handler.\n *\n * LangChain.js uses BaseCallbackHandler from @langchain/core/callbacks/base.\n * F-628/F-729: prior versions of this handler did NOT extend BaseCallbackHandler\n * — LangChain v0.2+ tightened its callback registration to do `instanceof\n * BaseCallbackHandler` checks, silently dropping any handler that does not\n * inherit. Zero spans fired from any LCEL chain.\n *\n * PR-4+5 review B1 (2026-05-25): even with `extends BaseCallbackHandler`,\n * `instanceof` would fail for ESM consumers because we resolve via\n * `createRequire()` (CJS) — the two module instances are DIFFERENT class\n * identities. LangChain v0.3 ships `isBaseCallbackHandler(x)` which checks\n * duck-type markers (`x.copy` function, `x.name` string, `x.awaitHandlers`\n * boolean). We now set those markers explicitly so we pass the duck-typed\n * check regardless of which class identity ends up resolving in the customer\n * environment. We ALSO still extend the resolved BaseCallbackHandler when\n * available — that satisfies any remaining v0.2 `instanceof` callsite in\n * the customer's bundle AND inherits the real `copy()` method.\n *\n * Usage:\n * import { RisicareCallbackHandler } from 'risicare/langchain';\n * const handler = new RisicareCallbackHandler();\n * const result = await handler.withSuppression(() =>\n * chain.invoke(input, { callbacks: [handler] })\n * );\n *\n * The handler does not suppress provider instrumentation by itself. Call\n * `handler.withSuppression(fn)` to run `fn` with provider spans (patchOpenAI,\n * etc.) suppressed, so that one LLM call does not give two LLM spans.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { suppressProviderInstrumentation } from '../context/dedup.js';\nimport { debug } from '../utils/log.js';\nimport type { Span } from '../span.js';\n\ninterface SpanEntry {\n span: Span;\n startTime: number;\n}\n\n/**\n * Resolve BaseCallbackHandler lazily. We cannot `import` it statically because\n * @langchain/core is an OPTIONAL peer dep — a bare `import` would fail at\n * load time for customers who don't have LangChain. The dynamic require is\n * wrapped in try/catch; on failure we fall back to `Object` so the handler\n * still constructs (it just won't satisfy LangChain v0.2+'s instanceof check).\n */\nfunction resolveBaseCallbackHandler(): new (...args: unknown[]) => object {\n try {\n // Use createRequire so this works under both CJS and ESM.\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n const { createRequire } = require('node:module') as typeof import('node:module');\n const req = createRequire(import.meta.url);\n const mod = req('@langchain/core/callbacks/base') as {\n BaseCallbackHandler?: new (...args: unknown[]) => object;\n };\n if (mod?.BaseCallbackHandler) {\n return mod.BaseCallbackHandler;\n }\n } catch {\n // Either ESM context without createRequire, or peer dep not installed.\n // Fall through to the require fallback below.\n }\n try {\n // eslint-disable-next-line @typescript-eslint/no-require-imports\n const mod = require('@langchain/core/callbacks/base') as {\n BaseCallbackHandler?: new (...args: unknown[]) => object;\n };\n if (mod?.BaseCallbackHandler) {\n return mod.BaseCallbackHandler;\n }\n } catch {\n debug('RisicareCallbackHandler: @langchain/core not installed; handler will not satisfy LangChain v0.2+ instanceof check');\n }\n return Object as unknown as new (...args: unknown[]) => object;\n}\n\nconst _BaseCallbackHandler = resolveBaseCallbackHandler();\n\n/**\n * RisicareCallbackHandler — emits Risicare spans for every LangChain callback.\n *\n * Extends BaseCallbackHandler at runtime when @langchain/core is installed,\n * which is required for LangChain v0.2+ to accept it.\n *\n * F-882/F-883: chat-model and agent events are NEW in v0.2; older handlers\n * that only implement handleLLMStart get zero spans from `ChatModel`s (every\n * modern LangChain LLM is a ChatModel). The full chat / agent / custom-event\n * surface is now covered.\n */\nexport class RisicareCallbackHandler extends _BaseCallbackHandler {\n // PR-4+5 review B1: duck-type markers that LangChain v0.3's\n // `isBaseCallbackHandler(x)` checks. This is the ONLY reliable way to be\n // recognised across the CJS↔ESM identity split — `instanceof` cannot work\n // when our `createRequire`-loaded BaseCallbackHandler is a different\n // class object from the customer's ESM-imported BaseCallbackHandler.\n // Keep these as instance properties (not prototype) so they survive any\n // Object-fallback path when @langchain/core is absent.\n name = 'RisicareCallbackHandler';\n awaitHandlers = true;\n ignoreLLM = false;\n ignoreChain = false;\n ignoreAgent = false;\n ignoreRetriever = false;\n ignoreCustomEvent = false;\n raiseError = false;\n lc_serializable = false;\n lc_kwargs: Record<string, unknown> = {};\n\n private _spans = new Map<string, SpanEntry>();\n\n constructor() {\n // Call super() even if BaseCallbackHandler is the Object fallback.\n super();\n }\n\n /**\n * Required by LangChain's `isBaseCallbackHandler(x)` duck-type check\n * (`typeof x.copy === 'function'`). When @langchain/core is installed\n * BaseCallbackHandler's prototype provides its own `copy()`; this\n * declaration overrides with a Risicare-aware copy that re-instantiates\n * — sufficient for the handler-cloning paths LangChain uses internally\n * (e.g., per-run isolation in concurrent chains). Spans map starts empty\n * because a fresh handler should not share span state with its parent.\n */\n copy(): RisicareCallbackHandler {\n return new RisicareCallbackHandler();\n }\n\n /**\n * Run a function with provider instrumentation suppressed.\n *\n * Wrap your chain.invoke() call with this to prevent duplicate spans.\n * The handler creates LLM/tool spans, so provider proxies (patchOpenAI, etc.)\n * should be suppressed during chain execution.\n *\n * @example\n * const handler = new RisicareCallbackHandler();\n * const result = await handler.withSuppression(() =>\n * chain.invoke(input, { callbacks: [handler] })\n * );\n */\n withSuppression<T>(fn: () => T): T {\n return suppressProviderInstrumentation(fn);\n }\n\n // ── Internal helpers ──────────────────────────────────────────────────────\n\n private _startSpan(\n runId: string,\n parentRunId: string | undefined,\n name: string,\n kind: SpanKind,\n extraAttrs: Record<string, unknown> = {},\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n\n const parentEntry = parentRunId ? this._spans.get(parentRunId) : undefined;\n const span = tracer.createSpan({\n name,\n kind,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'langchain',\n 'langchain.run_id': runId,\n ...(parentRunId ? { 'langchain.parent_run_id': parentRunId } : {}),\n ...extraAttrs,\n },\n });\n\n this._spans.set(runId, { span, startTime: Date.now() });\n }\n\n private _endSpan(runId: string, extraAttrs: Record<string, unknown> = {}): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n for (const [k, v] of Object.entries(extraAttrs)) {\n entry.span.setAttribute(k, v);\n }\n entry.span.setAttribute('gen_ai.latency_ms', Date.now() - entry.startTime);\n entry.span.end();\n this._spans.delete(runId);\n }\n\n private _errorSpan(runId: string, error: Error): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n entry.span.recordException(error);\n entry.span.end();\n this._spans.delete(runId);\n }\n\n // ── Chain lifecycle ────────────────────────────────────────────────────────\n\n handleChainStart(\n chain: { name?: string; _type?: string },\n _inputs: Record<string, unknown>,\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, chain.name || chain._type || 'chain', SpanKind.INTERNAL, {\n ...(chain._type ? { 'langchain.chain_type': chain._type } : {}),\n });\n }\n\n handleChainEnd(_outputs: Record<string, unknown>, runId: string): void {\n this._endSpan(runId);\n }\n\n handleChainError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n // ── LLM lifecycle ─────────────────────────────────────────────────────────\n\n handleLLMStart(\n llm: { name?: string; _type?: string },\n _prompts: string[],\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, llm.name || llm._type || 'llm', SpanKind.LLM_CALL, {\n 'gen_ai.system': 'langchain',\n 'gen_ai.prompt.count': _prompts.length,\n });\n }\n\n /**\n * F-882: chat-model lifecycle — LangChain v0.2+ emits this for any\n * ChatModel (which is EVERY production LLM today). Without this method,\n * not a single `langchain` LLM span fires when used via LCEL.\n *\n * The messages payload is an array-of-arrays (one inner array per prompt);\n * we just count rather than materialize content (PII boundary).\n */\n handleChatModelStart(\n llm: { name?: string; _type?: string },\n messages: unknown[][],\n runId: string,\n parentRunId?: string,\n ): void {\n const messageCount = Array.isArray(messages)\n ? messages.reduce((sum, arr) => sum + (Array.isArray(arr) ? arr.length : 0), 0)\n : 0;\n this._startSpan(runId, parentRunId, llm.name || llm._type || 'chat_model', SpanKind.LLM_CALL, {\n 'gen_ai.system': 'langchain',\n 'gen_ai.message.count': messageCount,\n });\n }\n\n handleLLMEnd(\n output: {\n generations?: unknown[][];\n llmOutput?: Record<string, unknown>;\n },\n runId: string,\n ): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n\n // Extract token usage from llmOutput\n const usage = output.llmOutput?.tokenUsage as\n | Record<string, number>\n | undefined;\n if (usage) {\n entry.span.setLlmFields({\n promptTokens: usage.promptTokens ?? usage.prompt_tokens,\n completionTokens: usage.completionTokens ?? usage.completion_tokens,\n totalTokens: usage.totalTokens ?? usage.total_tokens,\n });\n }\n\n const model = (output.llmOutput?.model ??\n output.llmOutput?.modelName) as string | undefined;\n if (model) {\n entry.span.setLlmFields({ model });\n }\n\n entry.span.setAttribute('gen_ai.latency_ms', Date.now() - entry.startTime);\n entry.span.end();\n this._spans.delete(runId);\n }\n\n handleLLMError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n /**\n * F-883: streaming-token event. We do NOT create a new span (the LLM span\n * already exists from handleLLMStart/handleChatModelStart) — just count tokens\n * on the existing span. This is a HIGH-FREQUENCY event; do the cheap work only.\n */\n handleLLMNewToken(_token: string, _idx: unknown, runId: string): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n const prior = (entry.span.attributes?.['gen_ai.stream.token_count'] as number) ?? 0;\n entry.span.setAttribute('gen_ai.stream.token_count', prior + 1);\n }\n\n // ── Tool lifecycle ────────────────────────────────────────────────────────\n\n handleToolStart(\n tool: { name?: string },\n input: string,\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, tool.name || 'tool', SpanKind.TOOL_CALL, {\n 'tool.name': tool.name || 'unknown',\n 'tool.input_length': input?.length ?? 0,\n });\n }\n\n handleToolEnd(output: string, runId: string): void {\n this._endSpan(runId, { 'tool.output_length': output?.length ?? 0 });\n }\n\n handleToolError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n // ── Retriever lifecycle ───────────────────────────────────────────────────\n\n handleRetrieverStart(\n retriever: { name?: string },\n _query: string,\n runId: string,\n parentRunId?: string,\n ): void {\n this._startSpan(runId, parentRunId, retriever.name || 'retriever', SpanKind.RETRIEVAL);\n }\n\n handleRetrieverEnd(documents: unknown[], runId: string): void {\n this._endSpan(runId, { 'retriever.document_count': documents?.length ?? 0 });\n }\n\n handleRetrieverError(error: Error, runId: string): void {\n this._errorSpan(runId, error);\n }\n\n // ── Agent lifecycle (F-882) ───────────────────────────────────────────────\n\n /**\n * Agent decided to take an action (call a tool). LangChain v0.2 agents emit\n * this between LLM calls. Cheap span, no parent change.\n */\n handleAgentAction(\n action: { tool?: string; toolInput?: unknown; log?: string },\n runId: string,\n parentRunId?: string,\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n const parentEntry = parentRunId ? this._spans.get(parentRunId) : undefined;\n const span = tracer.createSpan({\n name: `agent.action:${action.tool ?? 'unknown'}`,\n kind: SpanKind.INTERNAL,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'langchain',\n 'langchain.run_id': runId,\n 'agent.action.tool': action.tool ?? '',\n },\n });\n // Agent actions are point-in-time events, not durations — end immediately.\n span.end();\n }\n\n /**\n * Agent finished (final answer produced). Mirror of handleAgentAction.\n */\n handleAgentEnd(\n action: { returnValues?: Record<string, unknown>; log?: string },\n runId: string,\n parentRunId?: string,\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n const parentEntry = parentRunId ? this._spans.get(parentRunId) : undefined;\n const span = tracer.createSpan({\n name: 'agent.end',\n kind: SpanKind.INTERNAL,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'langchain',\n 'langchain.run_id': runId,\n 'agent.return_keys': action.returnValues\n ? Object.keys(action.returnValues).length\n : 0,\n },\n });\n span.end();\n }\n\n // ── Misc (F-882) ──────────────────────────────────────────────────────────\n\n /**\n * Free-text emission (logging-style). Used by ConversationalRetrievalChain\n * and verbose prints. Adds an event to the current chain span if one exists.\n */\n handleText(text: string, runId: string, _parentRunId?: string): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n entry.span.addEvent('langchain.text', {\n 'text.length': text?.length ?? 0,\n });\n }\n\n /**\n * Custom event hook (introduced in @langchain/core 0.2.14). Customer code can\n * `dispatchCustomEvent(name, payload)` from inside a runnable. We surface as\n * a span event on the closest enclosing run so it shows up in the trace.\n */\n handleCustomEvent(\n eventName: string,\n _payload: unknown,\n runId: string,\n _tags?: string[],\n _metadata?: Record<string, unknown>,\n ): void {\n const entry = this._spans.get(runId);\n if (!entry) return;\n entry.span.addEvent('langchain.custom_event', { name: eventName });\n }\n}\n","/**\n * LangGraph.js integration via Proxy wrapping.\n *\n * LangGraph uses LangChain callbacks under the hood. This integration wraps\n * a compiled graph's invoke/stream methods to:\n * 1. Create a parent \"langgraph.invoke\" or \"langgraph.stream\" span\n * 2. Inject a RisicareCallbackHandler into the config so all internal\n * chain/LLM/tool calls are also traced\n *\n * Usage:\n * import { instrumentLangGraph } from 'risicare/frameworks/langgraph';\n * const graph = instrumentLangGraph(compiledGraph);\n * const result = await graph.invoke(input);\n *\n * Does NOT suppress provider instrumentation.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { RisicareCallbackHandler } from './langchain.js';\n\n/**\n * Wrap a compiled LangGraph graph with Risicare tracing.\n *\n * Returns a Proxy that intercepts `invoke` and `stream` calls to create\n * a parent span and inject the LangChain callback handler.\n *\n * @param graph - A compiled LangGraph graph object with invoke/stream methods\n * @returns A proxied graph with tracing enabled\n */\nexport function instrumentLangGraph<T extends object>(graph: T): T {\n return new Proxy(graph, {\n get(target, prop, receiver) {\n const value = Reflect.get(target, prop, receiver);\n\n if (\n (prop === 'invoke' || prop === 'stream') &&\n typeof value === 'function'\n ) {\n return function patchedMethod(\n this: unknown,\n ...args: unknown[]\n ): unknown {\n const tracer = getTracer();\n if (!tracer?.enabled) return value.apply(this, args);\n\n return tracer.startSpan(\n {\n name: `langgraph.${String(prop)}`,\n kind: SpanKind.AGENT,\n attributes: { framework: 'langgraph' },\n },\n (_span) => {\n // Inject RisicareCallbackHandler into config (second argument)\n const config = (args[1] ?? {}) as Record<string, unknown>;\n const callbacks = (config.callbacks ?? []) as unknown[];\n callbacks.push(new RisicareCallbackHandler());\n args[1] = { ...config, callbacks };\n\n const result = value.apply(this, args);\n\n // Handle async results (Promises)\n if (\n result &&\n typeof (result as Promise<unknown>).then === 'function'\n ) {\n return (result as Promise<unknown>).then((r) => r);\n }\n return result;\n },\n );\n };\n }\n\n return value;\n },\n });\n}\n","/**\n * Provider patcher input validation.\n *\n * F-722/F-620: every `patchX(client)` entry point creates `new Proxy(client, ...)`.\n * Proxy constructors throw an opaque `TypeError: Cannot create proxy with a non-object\n * as target or handler` when handed `null`, `undefined`, a primitive, or `false`.\n * That error happens deep in the SDK with no actionable message — and it crashes\n * the customer's app startup the moment they pass a maybe-null client.\n *\n * We fail-fast with a clear, named TypeError so the customer sees:\n * \"patchOpenAI requires a client object, got null\"\n * instead of:\n * \"Cannot create proxy with a non-object as target or handler\"\n *\n * Rationale for throwing (not returning the input):\n * - Returning the input would silently disable instrumentation; a customer who\n * expects spans would see \"no traces\" and have to root-cause it themselves.\n * - Throwing surfaces the bug at the call-site (their `patchOpenAI(maybeNull)`).\n * - It happens at init/setup time, not in the request hot path, so no latency cost.\n */\n// PR-4+5 review NIT (2026-05-25): asserts-style narrowing. Pre-fix the\n// signature returned `void` with an `unknown` client parameter, forcing\n// every patcher's `new Proxy(client, ...)` call to keep the `unknown` /\n// loose `T` type — TS could not prove the Proxy target was non-null.\n// `asserts client is NonNullable<T>` means TS narrows the caller's\n// variable after assertClient returns, so the surrounding code is\n// type-safe without redundant runtime checks.\nexport function assertClient<T>(\n patcherName: string,\n client: T,\n): asserts client is NonNullable<T> {\n if (client === null || client === undefined) {\n throw new TypeError(\n `${patcherName} requires a client object, got ${client === null ? 'null' : 'undefined'}`,\n );\n }\n const t = typeof client;\n if (t !== 'object' && t !== 'function') {\n throw new TypeError(\n `${patcherName} requires a client object, got ${t}`,\n );\n }\n}\n","/**\n * Instructor integration via Proxy wrapping.\n *\n * Instructor wraps an LLM client's create() method to extract structured\n * data from completions using a response model (Zod schema, etc.).\n *\n * F-884: The Instructor JS client (`@instructor-ai/instructor`) exposes the\n * structured-extraction method at `client.chat.completions.create(...)` —\n * mirroring the underlying OpenAI shape — NOT at a top-level `client.create`.\n * The previous patcher hooked the top-level `create`, which Instructor JS does\n * not have, so no spans ever fired. We now walk the nested path (chat →\n * completions → create) AND keep a top-level `create` intercept for forward-\n * compatibility with API shapes that may expose both.\n *\n * Usage:\n * import { patchInstructor } from 'risicare/instructor';\n * import Instructor from '@instructor-ai/instructor';\n * const client = patchInstructor(Instructor({ client: openai, mode: 'TOOLS' }));\n * const result = await client.chat.completions.create({\n * model: 'gpt-4o-mini',\n * messages: [...],\n * response_model: { schema: MySchema, name: 'MyExtraction' },\n * });\n *\n * Does NOT suppress provider instrumentation -- Instructor delegates to the\n * underlying LLM client, which should produce its own provider span.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { debug } from '../utils/log.js';\nimport { assertClient } from '../utils/assert-client.js';\n\n/**\n * Build the wrapped `create` function. Shared between top-level (legacy) and\n * nested (`chat.completions.create`, the real Instructor JS shape) intercepts.\n */\nfunction makePatchedCreate(originalCreate: Function): Function {\n return function patchedCreate(this: unknown, ...args: unknown[]): unknown {\n const tracer = getTracer();\n if (!tracer?.enabled) {\n debug('Tracer not initialized — call init() before using patchInstructor()');\n return originalCreate.apply(this, args);\n }\n\n const params = (args[0] ?? {}) as Record<string, unknown>;\n // Instructor JS accepts response_model as { schema, name } or a Zod schema\n const responseModel = params.response_model ?? params.responseModel;\n\n let modelName = 'unknown';\n if (responseModel && typeof responseModel === 'function') {\n modelName = (responseModel as { name?: string }).name || 'unknown';\n } else if (responseModel && typeof responseModel === 'object') {\n const rm = responseModel as Record<string, unknown>;\n modelName =\n (rm.name as string) ??\n (rm.description as string) ??\n ((rm.schema as { name?: string } | undefined)?.name) ??\n 'schema';\n } else if (typeof responseModel === 'string') {\n modelName = responseModel;\n }\n\n return tracer.startSpan(\n {\n name: 'instructor.create',\n kind: SpanKind.LLM_CALL,\n attributes: {\n framework: 'instructor',\n 'framework.span_kind': 'extraction',\n 'instructor.response_model': modelName,\n ...(params.max_retries != null\n ? { 'instructor.max_retries': params.max_retries }\n : {}),\n ...(params.model != null\n ? { 'gen_ai.request.model': params.model }\n : {}),\n },\n },\n (_span) => {\n const result = originalCreate.apply(this, args);\n if (result && typeof (result as Promise<unknown>).then === 'function') {\n return (result as Promise<unknown>).then((r) => r);\n }\n return result;\n },\n );\n };\n}\n\n/**\n * Wrap an Instructor client with Risicare tracing.\n *\n * Intercepts BOTH:\n * - `client.chat.completions.create` (the real Instructor JS shape)\n * - `client.create` (legacy top-level shape, if present)\n *\n * @param client - An Instructor client\n * @returns A proxied client with tracing enabled\n */\nexport function patchInstructor<T extends object>(client: T): T {\n assertClient('patchInstructor', client);\n return new Proxy(client, {\n get(target, prop, receiver) {\n const value = Reflect.get(target, prop, receiver);\n\n // Legacy top-level create (rare, but harmless to keep for compat).\n if (prop === 'create' && typeof value === 'function') {\n return makePatchedCreate(value.bind(target));\n }\n\n // F-884: REAL Instructor JS shape — walk into `.chat.completions.create`.\n if (prop === 'chat' && value && typeof value === 'object') {\n return new Proxy(value as object, {\n get(chatTarget, chatProp, chatReceiver) {\n const chatValue = Reflect.get(chatTarget, chatProp, chatReceiver);\n if (chatProp === 'completions' && chatValue && typeof chatValue === 'object') {\n return new Proxy(chatValue as object, {\n get(compTarget, compProp, compReceiver) {\n const compValue = Reflect.get(compTarget, compProp, compReceiver);\n if (compProp === 'create' && typeof compValue === 'function') {\n return makePatchedCreate(compValue.bind(compTarget));\n }\n return compValue;\n },\n });\n }\n return chatValue;\n },\n });\n }\n\n return value;\n },\n });\n}\n","/**\n * LlamaIndex.TS integration via event handler.\n *\n * LlamaIndex.TS emits CustomEvent-shaped events through the global\n * `Settings.callbackManager` (a DOM-style EventTarget). F-880/F-881:\n * - Event NAMES use hyphens (`llm-start`, `llm-end`, `retrieve-start`,\n * `retrieve-end`, `query-start`, `query-end`, `embedding-start`, etc.),\n * NOT dotted suffixes (`.start` / `.end`). The previous handler used\n * `event.type.endsWith('.start')` and silently matched nothing.\n * - Payload lives on `event.detail` (DOM CustomEvent convention), NOT\n * `event.data` — the prior code was reading from `undefined`.\n *\n * We support both the hyphenated DOM CustomEvent shape (the real LlamaIndex.TS\n * format) and the dotted-suffix shape (the form the old code expected, kept\n * for back-compat with any customer who already wrote integration code\n * against the buggy contract).\n *\n * Usage:\n * import { RisicareLlamaIndexHandler } from 'risicare/llamaindex';\n * import { Settings } from 'llamaindex';\n * const handler = new RisicareLlamaIndexHandler();\n *\n * // Register every event we care about:\n * for (const name of RisicareLlamaIndexHandler.EVENT_NAMES) {\n * Settings.callbackManager.on(name, (e) => handler.onEvent(e));\n * }\n *\n * // For LLM/embedding calls, suppress provider instrumentation:\n * const result = handler.withSuppression(() => query(...));\n *\n * The handler does not suppress provider instrumentation by itself. Call\n * `handler.withSuppression(fn)` to run `fn` with provider spans (patchOpenAI,\n * etc.) suppressed, so that one LLM call does not give two LLM spans.\n */\n\nimport { getTracer } from '../client.js';\nimport { SpanKind } from '../types.js';\nimport { suppressProviderInstrumentation } from '../context/dedup.js';\nimport type { Span } from '../span.js';\n\ninterface SpanEntry {\n span: Span;\n startTime: number;\n componentKind: string;\n}\n\n/**\n * Loose event shape. LlamaIndex.TS dispatches `CustomEvent`s where the payload\n * is on `.detail`. We also accept `.data` for back-compat with the older buggy\n * contract.\n */\nexport interface LlamaIndexEvent {\n type: string;\n // DOM CustomEvent payload (the real LlamaIndex.TS shape)\n detail?: Record<string, unknown>;\n // Back-compat fallback (the shape the old handler expected)\n data?: Record<string, unknown>;\n // Some payloads carry id/parentId at the top level instead of in detail\n id?: string;\n parentId?: string;\n}\n\n/**\n * Registry of (event-name → lifecycle-phase) for the events LlamaIndex.TS\n * actually emits. Maintained explicitly so the handler doesn't false-match\n * on customer-defined custom events that happen to end with `-start`.\n */\nconst EVENT_PHASE: Record<string, 'start' | 'end' | 'error'> = {\n // LLM\n 'llm-start': 'start',\n 'llm-end': 'end',\n 'llm-error': 'error',\n 'llm-tool-call': 'start',\n 'llm-tool-result': 'end',\n 'llm-stream': 'end',\n // Chat\n 'chat-start': 'start',\n 'chat-end': 'end',\n // Embeddings\n 'embedding-start': 'start',\n 'embedding-end': 'end',\n // Retrieval\n 'retrieve-start': 'start',\n 'retrieve-end': 'end',\n // Query / synthesis\n 'query-start': 'start',\n 'query-end': 'end',\n 'synthesize-start': 'start',\n 'synthesize-end': 'end',\n // Agent\n 'agent-start': 'start',\n 'agent-end': 'end',\n 'agent-step-start': 'start',\n 'agent-step-end': 'end',\n};\n\nexport class RisicareLlamaIndexHandler {\n /**\n * Public, iterable list of all event names this handler responds to.\n * Customers should subscribe to each on the LlamaIndex callback manager:\n * for (const n of RisicareLlamaIndexHandler.EVENT_NAMES) Settings.callbackManager.on(n, ...)\n */\n static readonly EVENT_NAMES = Object.keys(EVENT_PHASE);\n\n private _spans = new Map<string, SpanEntry>();\n\n /**\n * Handle a LlamaIndex lifecycle event.\n */\n onEvent(event: LlamaIndexEvent): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n\n // F-881: prefer .detail (DOM CustomEvent convention); fall back to .data.\n const payload = event.detail ?? event.data ?? {};\n\n // F-880: lookup by exact event name first (real LlamaIndex format).\n let phase = EVENT_PHASE[event.type];\n\n // Back-compat: accept legacy dotted suffix form (`*.start`/`*.end`/`*.error`).\n if (!phase) {\n if (event.type.endsWith('.start') || event.type.endsWith('.begin')) {\n phase = 'start';\n } else if (event.type.endsWith('.end') || event.type.endsWith('.complete')) {\n phase = 'end';\n } else if (event.type.endsWith('.error')) {\n phase = 'error';\n }\n }\n\n if (!phase) return;\n\n const id = (payload.id as string) ?? event.id ?? '';\n const parentId = (payload.parentId as string) ?? event.parentId;\n if (!id) return; // can't track spans without an id\n\n if (phase === 'start') {\n this._handleStart(event.type, id, parentId, payload);\n } else if (phase === 'end') {\n this._handleEnd(id, payload);\n } else {\n this._handleError(id, payload);\n }\n }\n\n /**\n * Run a function with provider instrumentation suppressed.\n */\n withSuppression<T>(fn: () => T): T {\n return suppressProviderInstrumentation(fn);\n }\n\n // ── Internal event handlers ───────────────────────────────────────────────\n\n private _handleStart(\n eventType: string,\n id: string,\n parentId: string | undefined,\n payload: Record<string, unknown>,\n ): void {\n const tracer = getTracer();\n if (!tracer?.enabled) return;\n\n const componentKind = this._classifyComponent(eventType);\n const parentEntry = parentId ? this._spans.get(parentId) : undefined;\n\n const spanKind =\n componentKind === 'llm'\n ? SpanKind.LLM_CALL\n : componentKind === 'retrieval'\n ? SpanKind.RETRIEVAL\n : componentKind === 'embedding'\n ? SpanKind.LLM_CALL\n : SpanKind.INTERNAL;\n\n // Strip both shapes of suffix so the span name is just the component.\n const spanName = eventType\n .replace(/\\.(start|begin)$/, '')\n .replace(/-(start|begin)$/, '');\n\n const span = tracer.createSpan({\n name: spanName,\n kind: spanKind,\n parentSpanId: parentEntry?.span.spanId,\n traceId: parentEntry?.span.traceId,\n attributes: {\n framework: 'llamaindex',\n 'framework.span_kind': componentKind,\n ...(payload.model ? { 'gen_ai.request.model': payload.model } : {}),\n },\n });\n\n this._spans.set(id, { span, startTime: Date.now(), componentKind });\n }\n\n private _handleEnd(id: string, payload: Record<string, unknown>): void {\n const entry = this._spans.get(id);\n if (!entry) return;\n\n entry.span.setAttribute('gen_ai.latency_ms', Date.now() - entry.startTime);\n\n // Extract token usage if available\n const usage = payload.usage as Record<string, number> | undefined;\n if (usage) {\n entry.span.setLlmFields({\n promptTokens: usage.promptTokens ?? usage.prompt_tokens,\n completionTokens: usage.completionTokens ?? usage.completion_tokens,\n });\n }\n\n if (payload.documentCount != null) {\n entry.span.setAttribute(\n 'retriever.document_count',\n payload.documentCount,\n );\n } else if (Array.isArray(payload.nodes)) {\n // LlamaIndex retrieve-end emits a `nodes` array; fall back to length.\n entry.span.setAttribute('retriever.document_count', payload.nodes.length);\n }\n\n entry.span.end();\n this._spans.delete(id);\n }\n\n private _handleError(id: string, payload: Record<string, unknown>): void {\n const entry = this._spans.get(id);\n if (!entry) return;\n\n const error = payload.error;\n entry.span.recordException(\n error instanceof Error ? error : String(error ?? 'Unknown error'),\n );\n entry.span.end();\n this._spans.delete(id);\n }\n\n /**\n * Classify a LlamaIndex event type into a component kind.\n */\n private _classifyComponent(eventType: string): string {\n const lower = eventType.toLowerCase();\n if (lower.includes('llm') || lower.includes('chat')) return 'llm';\n if (lower.includes('embed')) return 'embedding';\n if (lower.includes('retriev') || lower.includes('vector')) return 'retrieval';\n if (lower.includes('synth') || lower.includes('response')) return 'synthesis';\n if (lower.includes('query')) return 'query';\n if (lower.includes('agent')) return 'agent';\n return 'component';\n }\n}\n","/**\n * Webhook signature verification helpers (CON-195 / B-7, F-34).\n *\n * Customers receive Risicare webhooks at endpoints they configure. Each\n * delivery is signed by the sender (`packages/workers/src/workers/\n * webhook_dispatch.py`) with HMAC-SHA256 over `<timestamp>.<payload_bytes>`\n * using the per-webhook shared secret. The signature is delivered in the\n * `X-Risicare-Signature` header in Stripe-style format `t=<unix>,v1=<hex>`,\n * and the timestamp is also exposed verbatim as `X-Risicare-Timestamp`.\n *\n * This module is the TypeScript port of `risicare-sdk/src/risicare/\n * webhooks.py`. It enforces THREE checks (all must pass):\n *\n * 1. Header parsing — both headers must be present and well-formed.\n * 2. Time skew — `Math.abs(now - timestamp) <= toleranceS` (default\n * 5 minutes). This is what makes captured signed payloads\n * non-replayable past the tolerance window.\n * 3. HMAC equality — constant-time compare against a fresh signature\n * computed from the secret + the SAME timestamp + the raw body.\n *\n * Example (Express/Node receiver):\n *\n * import express from 'express';\n * import { verifyWebhookSignature, WebhookVerificationError } from 'risicare';\n *\n * const app = express();\n * // IMPORTANT: use raw body, not parsed JSON — the signature is\n * // over the EXACT bytes received; JSON re-serialization changes\n * // key ordering / whitespace and the signature will not match.\n * app.post('/risicare-webhook', express.raw({ type: '*\\/*' }), (req, res) => {\n * try {\n * verifyWebhookSignature(req.body, req.headers, YOUR_WEBHOOK_SECRET);\n * } catch (e) {\n * if (e instanceof WebhookVerificationError) {\n * return res.status(401).send(e.message);\n * }\n * throw e;\n * }\n * // ... process the verified event ...\n * res.status(200).end();\n * });\n *\n * The helper is dependency-light (Node `crypto` stdlib only) so customers\n * can use it without pulling in the rest of the SDK if they only need\n * verification.\n *\n * Edge runtime note: this verifier is synchronous and uses Node's\n * `crypto.timingSafeEqual` + `crypto.createHmac`. It will not run in\n * Cloudflare Workers / Vercel Edge / Deno Deploy as-is. An async Web\n * Crypto variant can be added if customers request it.\n */\n\nimport { createHmac, timingSafeEqual } from 'node:crypto';\nimport { Buffer } from 'node:buffer';\n\n/**\n * Default skew window (seconds). 5 minutes matches Stripe / GitHub /\n * common industry practice. Customers can override per-call if their\n * clock infrastructure warrants a tighter or looser bound.\n *\n * Mirrors `DEFAULT_TIMESTAMP_TOLERANCE_S` in the Python SDK.\n */\nexport const DEFAULT_TIMESTAMP_TOLERANCE_S = 300;\n\nconst SIGNATURE_HEADER = 'X-Risicare-Signature';\nconst TIMESTAMP_HEADER = 'X-Risicare-Timestamp';\n\n// The Python sender emits exactly one supported scheme today (`v1`). The\n// parser is structured so adding `v2` later is a non-breaking change:\n// list newer schemes first; the first match wins.\nconst SUPPORTED_SCHEMES = ['v1'] as const;\n\n// SHA-256 hex digest is always 64 lowercase hex chars. We pre-validate\n// the parsed signature against this shape BEFORE constant-time compare\n// so `Buffer.from(s, 'hex')` cannot silently truncate non-hex chars\n// (Node's Buffer.from 'hex' parser is lenient — it stops at the first\n// invalid character without raising).\nconst HEX_SHA256_RE = /^[0-9a-f]{64}$/;\n\n/**\n * Raised when a webhook delivery fails any verification check.\n *\n * Customers should catch this specifically rather than a generic `Error`\n * so verification failures are not conflated with other input problems\n * (e.g. body-parsing errors at the framework layer).\n *\n * The `message` is safe to log — it never includes the secret, the\n * expected signature, or the computed signature.\n */\nexport class WebhookVerificationError extends Error {\n constructor(message: string) {\n super(message);\n this.name = 'WebhookVerificationError';\n // Preserve prototype chain across the ES5/ES2022 transpilation\n // boundary so `instanceof` works for callers compiled to older\n // targets that interact with this library.\n Object.setPrototypeOf(this, WebhookVerificationError.prototype);\n }\n}\n\n/**\n * Options for `verifyWebhookSignature`. All fields are optional.\n */\nexport interface VerifyWebhookOptions {\n /**\n * Maximum clock-skew tolerance in seconds. Defaults to\n * `DEFAULT_TIMESTAMP_TOLERANCE_S` (300). Setting to 0 is supported\n * (strict same-second match) but discouraged in distributed\n * deployments.\n */\n toleranceS?: number;\n /**\n * Test hook — override \"current time\" in unix seconds.\n * Customers should not pass this.\n */\n _now?: number;\n}\n\n/**\n * Header-like inputs accepted by `verifyWebhookSignature`.\n *\n * Covers (a) Web API `Headers` (case-insensitive `.get`), (b) Node\n * `IncomingHttpHeaders` (plain object with lowercase keys, possibly\n * array-valued for multi-set headers), (c) `Map<string, string>`\n * (case-sensitive `.get`), and (d) plain `Record` (case-sensitive\n * property lookup, possibly array-valued).\n *\n * Lookup strategy: try the canonical mixed-case name first\n * (`X-Risicare-Signature`). If that returns undefined, fall back to the\n * lowercased form (`x-risicare-signature`). Mirrors the Python\n * `_get_header` helper.\n */\nexport type HeaderLookup =\n | Headers\n | Map<string, string>\n | Record<string, string | string[] | undefined>;\n\n/**\n * Payload shapes accepted by `verifyWebhookSignature`.\n *\n * `Buffer extends Uint8Array` in Node, so callers passing `Buffer`\n * satisfy the `Uint8Array` arm. `ArrayBuffer` is explicitly accepted\n * for callers using Web-API request bodies. `string` is UTF-8 encoded\n * internally.\n *\n * Crucially, callers must pass the EXACT bytes received over the\n * wire. Parsing JSON and re-serializing changes byte order and\n * whitespace; the signature will not match.\n */\nexport type WebhookPayload = Uint8Array | ArrayBuffer | string;\n\n/**\n * Look up a header by name, trying canonical mixed-case first, then\n * lowercase. Returns `undefined` if neither lookup yields a value.\n *\n * Web `Headers` and Node `IncomingHttpHeaders` are case-insensitive\n * lookups by spec; a plain `Record` is case-sensitive. We try both to\n * support either.\n */\nfunction getHeader(headers: HeaderLookup, name: string): string | undefined {\n const lower = name.toLowerCase();\n\n // Anything with a `.get(name)` method — covers Web `Headers`\n // (case-insensitive by spec, so the lowercase fallback is a no-op)\n // AND `Map<string, string>` (case-sensitive, so the fallback DOES\n // matter when the caller set lowercase keys). Web `Headers.get`\n // returns `null` for missing keys; Map returns `undefined`. Both\n // are normalised to `undefined` here.\n if (\n typeof (headers as { get?: (k: string) => unknown }).get === 'function'\n ) {\n const accessor = headers as { get: (k: string) => string | null | undefined };\n const v = accessor.get(name) ?? accessor.get(lower);\n return v ?? undefined;\n }\n\n // Plain object / IncomingHttpHeaders. IncomingHttpHeaders values\n // can be `string | string[] | undefined` (multi-set headers). For\n // a signature header there should only ever be one — but if a\n // client genuinely sets the same header twice, joining with `, `\n // would corrupt the signature. Take the first element only and let\n // a malformed-segment error surface downstream if the duplication\n // produced a problem.\n const dict = headers as Record<string, string | string[] | undefined>;\n const raw = dict[name] ?? dict[lower];\n if (raw === undefined) {\n return undefined;\n }\n if (Array.isArray(raw)) {\n return raw[0];\n }\n return raw;\n}\n\n/**\n * Coerce any accepted payload shape to a `Buffer` for HMAC consumption.\n *\n * `string` → UTF-8 encode.\n * `Uint8Array` (including `Buffer`) → `Buffer.from(uint8)` shares the\n * underlying ArrayBuffer with no copy.\n * `ArrayBuffer` → `Buffer.from(ab)` copies into a Node Buffer.\n *\n * Anything else throws `WebhookVerificationError`.\n */\nfunction coercePayload(payload: WebhookPayload): Buffer {\n if (typeof payload === 'string') {\n return Buffer.from(payload, 'utf-8');\n }\n // `Buffer` is a subclass of `Uint8Array`, so this arm covers both.\n if (payload instanceof Uint8Array) {\n return Buffer.from(\n payload.buffer,\n payload.byteOffset,\n payload.byteLength,\n );\n }\n if (payload instanceof ArrayBuffer) {\n return Buffer.from(payload);\n }\n throw new WebhookVerificationError(\n `payload must be Uint8Array, ArrayBuffer, Buffer, or string, got ${typeof payload}`,\n );\n}\n\n/**\n * Parse `t=<int>,v1=<hex>` (with possible additional unknown `kN=v`\n * segments) into `[timestamp, hex_signature]`.\n *\n * Tolerates extra segments for forward-compat: future scheme versions\n * may add new k=v pairs and this parser must not break.\n *\n * Mirrors `_parse_signature_header` in the Python SDK.\n */\nfunction parseSignatureHeader(raw: string): [number, string] {\n // Use a null-prototype object so a malicious segment like\n // `__proto__=v1=<hex>` or `constructor=...` cannot pollute the\n // global Object prototype via bracket-assignment, and so that\n // `'t' in parts` cannot return a false positive from inherited\n // properties like `toString` or `hasOwnProperty`. Python uses a\n // plain dict which has no equivalent prototype chain; this is a\n // JS-specific hardening with no Python counterpart.\n const parts: Record<string, string> = Object.create(null);\n\n for (const rawSegment of raw.split(',')) {\n const segment = rawSegment.trim();\n if (segment === '') {\n continue;\n }\n const eqIdx = segment.indexOf('=');\n if (eqIdx === -1) {\n throw new WebhookVerificationError(\n `Malformed segment in ${SIGNATURE_HEADER}: ${JSON.stringify(segment)}`,\n );\n }\n const key = segment.slice(0, eqIdx).trim();\n const value = segment.slice(eqIdx + 1).trim();\n parts[key] = value;\n }\n\n if (!('t' in parts)) {\n throw new WebhookVerificationError(\n `Missing \\`t=\\` (timestamp) in ${SIGNATURE_HEADER}`,\n );\n }\n\n // Pick the first supported scheme present. Today only `v1` exists.\n let scheme: string | undefined;\n for (const candidate of SUPPORTED_SCHEMES) {\n if (candidate in parts) {\n scheme = candidate;\n break;\n }\n }\n if (scheme === undefined) {\n // Sorted keys so the error message is deterministic regardless\n // of segment order in the input header.\n const keys = Object.keys(parts).sort();\n throw new WebhookVerificationError(\n `No supported signature scheme in ${SIGNATURE_HEADER}; ` +\n `expected one of (${SUPPORTED_SCHEMES.map((s) => `'${s}'`).join(', ')}), ` +\n `got keys [${keys.map((k) => `'${k}'`).join(', ')}]`,\n );\n }\n\n // parts['t'] is guaranteed defined by the `'t' in parts` check above.\n const tRaw = parts['t'] as string;\n // The segment was already `.trim()`ed during parsing, so leading /\n // trailing whitespace cannot reach here. The strict regex rejects\n // (a) empty string, (b) sign-only (\"-\", \"+\"), and (c) numeric-\n // prefix-then-garbage like \"123abc\" that `parseInt` would\n // permissively coerce to 123. Note: a leading `+` is rejected here\n // for parity with the Python sender's output (which is always\n // `str(int(time.time()))` — never carries a sign).\n if (!/^-?\\d+$/.test(tRaw)) {\n throw new WebhookVerificationError(\n `Non-integer timestamp in ${SIGNATURE_HEADER}: ${JSON.stringify(tRaw)}`,\n );\n }\n const ts = parseInt(tRaw, 10);\n if (!Number.isFinite(ts)) {\n // Defensive: a 21+ digit decimal string would `parseInt` to a\n // value outside `Number.MAX_SAFE_INTEGER`, and while `parseInt`\n // returns Infinity only for very specific inputs, treating any\n // non-finite result as a parse failure is the safe move.\n throw new WebhookVerificationError(\n `Non-integer timestamp in ${SIGNATURE_HEADER}: ${JSON.stringify(tRaw)}`,\n );\n }\n\n // scheme is one of SUPPORTED_SCHEMES so it's a known key.\n const sigHex = parts[scheme];\n if (sigHex === undefined || sigHex === '') {\n throw new WebhookVerificationError(\n `Empty ${scheme}= value in ${SIGNATURE_HEADER}`,\n );\n }\n\n return [ts, sigHex];\n}\n\n/**\n * Constant-time HMAC-SHA256 hex compare with explicit length pre-check.\n *\n * `crypto.timingSafeEqual` throws if the two buffers have different\n * lengths. To avoid leaking length information via the exception path,\n * we pre-validate the expected hex against the canonical sha256-hex\n * shape (64 lowercase hex chars) BEFORE attempting comparison. A\n * malformed expected → generic mismatch with no detail.\n *\n * The `computed` value comes from `createHmac(...).digest('hex')` and\n * is therefore always 64-char lowercase hex by construction; we don't\n * re-validate it.\n */\nfunction safeHexEqual(computed: string, expected: string): boolean {\n if (!HEX_SHA256_RE.test(expected)) {\n return false;\n }\n const a = Buffer.from(computed, 'hex');\n const b = Buffer.from(expected, 'hex');\n // Defensive: both buffers must be exactly 32 bytes after the regex\n // check above. If the platform ever returns a different length, the\n // explicit check below makes the failure mode a benign `false`\n // rather than a thrown RangeError from timingSafeEqual.\n if (a.length !== b.length) {\n return false;\n }\n return timingSafeEqual(a, b);\n}\n\n/**\n * Verify a Risicare webhook delivery. Throws `WebhookVerificationError`\n * on any failure; returns `undefined` on success.\n *\n * @param payload Raw request body bytes — the EXACT bytes received over\n * the wire. Re-serializing parsed JSON will change byte ordering and\n * break the signature.\n * @param headers Header lookup. Web `Headers`, `Map<string,string>`,\n * Node `IncomingHttpHeaders`, or plain `Record` all work. Lookup is\n * case-insensitive (canonical mixed-case tried first, then lowercase).\n * @param secret The shared secret configured on the Risicare webhook\n * record. Returned by `POST /v1/webhooks` once at create time.\n * @param opts Optional overrides — `toleranceS` (default 300) and\n * `_now` (test hook).\n *\n * @throws WebhookVerificationError on any of: missing headers, malformed\n * signature, timestamp outside tolerance, HMAC mismatch, or invalid\n * payload type.\n */\nexport function verifyWebhookSignature(\n payload: WebhookPayload,\n headers: HeaderLookup,\n secret: string,\n opts: VerifyWebhookOptions = {},\n): void {\n const toleranceS =\n opts.toleranceS ?? DEFAULT_TIMESTAMP_TOLERANCE_S;\n\n // Validate payload type FIRST so a caller passing a clearly-wrong\n // type gets the most informative error (same ordering as Python).\n const payloadBytes = coercePayload(payload);\n\n const sigHeader = getHeader(headers, SIGNATURE_HEADER);\n if (sigHeader === undefined || sigHeader === '') {\n throw new WebhookVerificationError(\n `Missing ${SIGNATURE_HEADER} header`,\n );\n }\n const tsHeader = getHeader(headers, TIMESTAMP_HEADER);\n if (tsHeader === undefined || tsHeader === '') {\n throw new WebhookVerificationError(\n `Missing ${TIMESTAMP_HEADER} header`,\n );\n }\n\n const [tsInSig, expectedHex] = parseSignatureHeader(sigHeader);\n\n // Cross-check: the standalone X-Risicare-Timestamp header MUST agree\n // with the t= value baked into the signature. A discrepancy means\n // the sender is buggy or someone has split the request — either way\n // refuse. Mirrors Python webhooks.py:214-217.\n if (!/^-?\\d+$/.test(tsHeader)) {\n throw new WebhookVerificationError(\n `Non-integer ${TIMESTAMP_HEADER}: ${JSON.stringify(tsHeader)}`,\n );\n }\n const tsStandalone = parseInt(tsHeader, 10);\n if (!Number.isFinite(tsStandalone)) {\n throw new WebhookVerificationError(\n `Non-integer ${TIMESTAMP_HEADER}: ${JSON.stringify(tsHeader)}`,\n );\n }\n if (tsStandalone !== tsInSig) {\n throw new WebhookVerificationError(\n `Timestamp mismatch: ${TIMESTAMP_HEADER}=${tsStandalone}, signature t=${tsInSig}`,\n );\n }\n\n const now =\n opts._now !== undefined\n ? Math.trunc(opts._now)\n : Math.floor(Date.now() / 1000);\n const skew = Math.abs(now - tsInSig);\n if (skew > toleranceS) {\n throw new WebhookVerificationError(\n `Webhook timestamp outside tolerance: skew=${skew}s, max=${toleranceS}s`,\n );\n }\n\n // Compute the canonical-string HMAC: `<ts>.<payload_bytes>`.\n // Two .update() calls is equivalent to one .update(concatenated)\n // and avoids materializing a copy of the payload.\n const hmac = createHmac('sha256', secret);\n hmac.update(`${tsInSig}.`);\n hmac.update(payloadBytes);\n const computed = hmac.digest('hex');\n\n if (!safeHexEqual(computed, expectedHex)) {\n // Deliberately generic message — leaking \"computed != expected\"\n // or the expected value would assist an attacker doing oracle\n // attacks. Mirrors Python webhooks.py:228-231.\n throw new WebhookVerificationError('Webhook signature mismatch');\n }\n}\n"],"mappings":"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A,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAW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","names":["createHash","debug","SpanKind","SpanStatus","SemanticPhase","AgentRole","MessageType","session","agent","G","G","getTracer","createHash","getTracer","agent","getTracer","getTracer","session","getTracer","getTracer","session","agent","getTracer","getTracer","getTracer","getTracer","getTracer","Buffer"]}
|