bitfab 0.67.0 → 0.68.1

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.
Files changed (54) hide show
  1. package/dist/{autoTrace-CQw0qMBt.cjs → autoTrace-D3-OZcmR.cjs} +265 -4
  2. package/dist/autoTrace-D3-OZcmR.cjs.map +1 -0
  3. package/dist/{autoTrace-O40k8f5M.js → autoTrace-ghnojSj9.js} +230 -5
  4. package/dist/autoTrace-ghnojSj9.js.map +1 -0
  5. package/dist/autoTrace.cjs +4 -1
  6. package/dist/autoTrace.d.cts +36 -0
  7. package/dist/autoTrace.d.ts +36 -0
  8. package/dist/autoTrace.js +1 -1
  9. package/dist/{babelPlugin-ZR9ilYct.cjs → babelPlugin-0uOq-j1Q.cjs} +86 -2
  10. package/dist/babelPlugin-0uOq-j1Q.cjs.map +1 -0
  11. package/dist/{babelPlugin-CBjx6aJe.js → babelPlugin-Muq0uuuu.js} +86 -2
  12. package/dist/babelPlugin-Muq0uuuu.js.map +1 -0
  13. package/dist/{http-CcYPHER5.js → http-f8Rl8oRa.js} +3 -3
  14. package/dist/{http-CcYPHER5.js.map → http-f8Rl8oRa.js.map} +1 -1
  15. package/dist/{http-CxT_WDAh.cjs → http-r1r6injY.cjs} +3 -3
  16. package/dist/{http-CxT_WDAh.cjs.map → http-r1r6injY.cjs.map} +1 -1
  17. package/dist/{index-BFgtvRni.d.cts → index-BQV7zzJx.d.cts} +98 -2
  18. package/dist/{index-BFgtvRni.d.ts → index-BQV7zzJx.d.ts} +98 -2
  19. package/dist/index.cjs +2 -2
  20. package/dist/index.d.cts +2 -2
  21. package/dist/index.d.ts +2 -2
  22. package/dist/index.js +2 -2
  23. package/dist/node.cjs +3 -3
  24. package/dist/node.d.cts +2 -2
  25. package/dist/node.d.ts +2 -2
  26. package/dist/node.js +3 -3
  27. package/dist/registryCommand-Dk4Y1ZgW.js.map +1 -1
  28. package/dist/{src-DXmdXbOL.cjs → src-BYXxPnpE.cjs} +138 -8
  29. package/dist/src-BYXxPnpE.cjs.map +1 -0
  30. package/dist/{src-CFDoTgXw.js → src-Cps3Xs_J.js} +138 -8
  31. package/dist/src-Cps3Xs_J.js.map +1 -0
  32. package/dist/transform/babel.cjs +1 -1
  33. package/dist/transform/babel.d.cts +9 -0
  34. package/dist/transform/babel.d.ts +9 -0
  35. package/dist/transform/babel.js +1 -1
  36. package/dist/transform/loaderRuntime.cjs +2 -2
  37. package/dist/transform/loaderRuntime.js +2 -2
  38. package/dist/transform/nodeLoader.js +85 -1
  39. package/dist/transform/nodeLoader.js.map +1 -1
  40. package/dist/transform/swc.cjs +1 -1
  41. package/dist/transform/swc.js +1 -1
  42. package/dist/transform/unplugin.cjs +2 -2
  43. package/dist/transform/unplugin.js +2 -2
  44. package/dist/{transform-DP1qnD8u.js → transform-CAJyLLe2.js} +2 -2
  45. package/dist/{transform-DP1qnD8u.js.map → transform-CAJyLLe2.js.map} +1 -1
  46. package/dist/{transform-D_pSvPJc.cjs → transform-ClCOpCZ2.cjs} +2 -2
  47. package/dist/{transform-D_pSvPJc.cjs.map → transform-ClCOpCZ2.cjs.map} +1 -1
  48. package/package.json +3 -1
  49. package/dist/autoTrace-CQw0qMBt.cjs.map +0 -1
  50. package/dist/autoTrace-O40k8f5M.js.map +0 -1
  51. package/dist/babelPlugin-CBjx6aJe.js.map +0 -1
  52. package/dist/babelPlugin-ZR9ilYct.cjs.map +0 -1
  53. package/dist/src-CFDoTgXw.js.map +0 -1
  54. package/dist/src-DXmdXbOL.cjs.map +0 -1
@@ -61,6 +61,133 @@ function writeOnce(key, line, write = console.warn) {
61
61
  } catch {}
62
62
  }
63
63
  //#endregion
64
+ //#region src/openrouter.ts
65
+ const OPENROUTER_PROVIDER = "openrouter";
66
+ const OPENROUTER_HOSTNAME = "openrouter.ai";
67
+ const OPENROUTER_WATCH_STORAGE_SYMBOL = Symbol.for("bitfab.openRouterWatchStorage");
68
+ const completionsRecordedByAutoTrace = /* @__PURE__ */ new WeakSet();
69
+ function isRecord(value) {
70
+ return typeof value === "object" && value !== null;
71
+ }
72
+ function field(value, name) {
73
+ return isRecord(value) ? value[name] : void 0;
74
+ }
75
+ function numberField(value, name) {
76
+ const found = field(value, name);
77
+ return typeof found === "number" && Number.isFinite(found) ? found : void 0;
78
+ }
79
+ function nonEmptyString(value) {
80
+ return typeof value === "string" && value !== "" ? value : void 0;
81
+ }
82
+ function isOpenRouterBaseUrl(baseUrl) {
83
+ if (typeof baseUrl !== "string") return false;
84
+ try {
85
+ const host = new URL(baseUrl).hostname;
86
+ return host === OPENROUTER_HOSTNAME || host.endsWith(`.${OPENROUTER_HOSTNAME}`);
87
+ } catch {
88
+ return false;
89
+ }
90
+ }
91
+ function isOpenRouterCompletions(receiver) {
92
+ try {
93
+ return isOpenRouterBaseUrl(field(field(receiver, "_client"), "baseURL"));
94
+ } catch {
95
+ return false;
96
+ }
97
+ }
98
+ function isStreamingRequest(body) {
99
+ return field(body, "stream") === true;
100
+ }
101
+ function isChatCompletion(value) {
102
+ return isRecord(value) && Array.isArray(value.choices);
103
+ }
104
+ function openRouterPrompt(body) {
105
+ const messages = field(body, "messages");
106
+ if (!Array.isArray(messages)) return;
107
+ const rendered = messages.flatMap((message) => {
108
+ const role = field(message, "role");
109
+ if (typeof role !== "string") return [];
110
+ const content = field(message, "content");
111
+ return [{
112
+ role,
113
+ content: typeof content === "string" ? content : JSON.stringify(content)
114
+ }];
115
+ });
116
+ return rendered.length > 0 ? JSON.stringify(rendered) : void 0;
117
+ }
118
+ function openRouterContext(body, response, durationMs) {
119
+ const usage = field(response, "usage");
120
+ const context = { provider: OPENROUTER_PROVIDER };
121
+ const values = {
122
+ model: nonEmptyString(field(response, "model")) ?? nonEmptyString(field(body, "model")),
123
+ upstreamProvider: nonEmptyString(field(response, "provider")),
124
+ inputTokens: numberField(usage, "prompt_tokens"),
125
+ outputTokens: numberField(usage, "completion_tokens"),
126
+ cachedInputTokens: numberField(field(usage, "prompt_tokens_details"), "cached_tokens"),
127
+ reasoningTokens: numberField(field(usage, "completion_tokens_details"), "reasoning_tokens"),
128
+ costUsd: numberField(usage, "cost")
129
+ };
130
+ for (const [key, value] of Object.entries(values)) if (value !== void 0) context[key] = value;
131
+ context.durationMs = durationMs;
132
+ return context;
133
+ }
134
+ function recordOpenRouterCompletion(span, body, response, durationMs) {
135
+ try {
136
+ const prompt = openRouterPrompt(body);
137
+ if (prompt !== void 0) span.setPrompt(prompt);
138
+ span.addContext(openRouterContext(body, response, durationMs));
139
+ } catch {}
140
+ }
141
+ let openRouterWatchStorage = null;
142
+ function watchStorage() {
143
+ if (openRouterWatchStorage) return openRouterWatchStorage;
144
+ const shared = globalThis;
145
+ const existing = shared[OPENROUTER_WATCH_STORAGE_SYMBOL];
146
+ openRouterWatchStorage = existing ?? createAsyncLocalStorage();
147
+ if (openRouterWatchStorage && !existing) shared[OPENROUTER_WATCH_STORAGE_SYMBOL] = openRouterWatchStorage;
148
+ return openRouterWatchStorage;
149
+ }
150
+ function watchOpenRouterUsage(fn) {
151
+ const storage = watchStorage();
152
+ const watch = {
153
+ recorded: false,
154
+ parent: storage?.getStore() ?? null
155
+ };
156
+ return {
157
+ watch,
158
+ result: storage ? storage.run(watch, fn) : fn()
159
+ };
160
+ }
161
+ function markEnclosingWatches(watch) {
162
+ for (let current = watch.parent; current; current = current.parent) current.recorded = true;
163
+ }
164
+ function isRecordedByAutoTrace(response) {
165
+ return isRecord(response) && completionsRecordedByAutoTrace.has(response);
166
+ }
167
+ function recordWatchedOpenRouterCompletion(span, watch, body, response, durationMs) {
168
+ if (watch.recorded || isRecordedByAutoTrace(response)) {
169
+ markEnclosingWatches(watch);
170
+ return;
171
+ }
172
+ if (!isChatCompletion(response)) return;
173
+ recordOpenRouterCompletion(span, body, response, durationMs);
174
+ completionsRecordedByAutoTrace.add(response);
175
+ markEnclosingWatches(watch);
176
+ }
177
+ function recordAutoTracedOpenRouter(invokeFn, body, span) {
178
+ const startedAt = Date.now();
179
+ const { watch, result } = watchOpenRouterUsage(invokeFn);
180
+ const settle = (response) => {
181
+ recordWatchedOpenRouterCompletion(span, watch, body, response, Date.now() - startedAt);
182
+ };
183
+ if (result instanceof Promise) return result.then((response) => {
184
+ settle(response);
185
+ return response;
186
+ });
187
+ settle(result);
188
+ return result;
189
+ }
190
+ //#endregion
64
191
  //#region src/autoTrace.ts
65
192
  const autoTraceGlobal = globalThis;
66
193
  const autoTraceState = autoTraceGlobal.__bitfabAutoTraceStateV4 ?? {
@@ -158,6 +285,7 @@ function settleAutoTraceRoot(context) {
158
285
  if (transformInstalled() || !runsOnNode()) return;
159
286
  warnOnce("auto-trace-transform-missing", `trace root "${context.traceFunctionKey}" recorded only its own span. No module in this build was compiled by @bitfab/sdk/transform, so calls beneath the root were not discovered. Add the SDK's transform adapter to the server build: ${SUBTREE_TRACING_DOCS_URL}`);
160
287
  }
288
+ const heldRootWork = /* @__PURE__ */ new WeakMap();
161
289
  function runWithAutoTraceRootContext(context, spanStack, fn) {
162
290
  autoTraceState.activeRoots += 1;
163
291
  const entries = [...currentAutoTraceEntries(), {
@@ -165,23 +293,41 @@ function runWithAutoTraceRootContext(context, spanStack, fn) {
165
293
  depth: 0,
166
294
  spanStack
167
295
  }];
296
+ const held = [];
297
+ heldRootWork.set(context, held);
168
298
  let result;
169
299
  try {
170
300
  result = runWithAutoTraceScope({ entries }, fn);
171
301
  } catch (error) {
302
+ heldRootWork.delete(context);
172
303
  settleAutoTraceRoot(context);
173
304
  throw error;
174
305
  }
175
306
  if (isAutoTraceAsyncGenerator(result)) {
307
+ heldRootWork.delete(context);
176
308
  closeAutoTraceRoot();
177
309
  return wrapAutoTraceAsyncGenerator(context, spanStack, result);
178
310
  }
179
- if (result instanceof Promise) return result.finally(() => {
180
- settleAutoTraceRoot(context);
181
- });
311
+ if (result instanceof Promise) return result.then((value) => finishAfterHeldWork(context, held, () => value), (error) => finishAfterHeldWork(context, held, () => {
312
+ throw error;
313
+ }));
314
+ heldRootWork.delete(context);
182
315
  settleAutoTraceRoot(context);
183
316
  return result;
184
317
  }
318
+ function finishAfterHeldWork(context, held, finish) {
319
+ const pending = held.splice(0);
320
+ if (pending.length === 0) {
321
+ heldRootWork.delete(context);
322
+ settleAutoTraceRoot(context);
323
+ return finish();
324
+ }
325
+ return Promise.all(pending).then(() => finishAfterHeldWork(context, held, finish));
326
+ }
327
+ function holdAutoTraceRoots(work) {
328
+ const settled = work.then(() => void 0, () => void 0);
329
+ for (const entry of currentAutoTraceEntries()) heldRootWork.get(entry.context)?.push(settled);
330
+ }
185
331
  function invokeThroughAutoTraceEntries(entries, step, fn) {
186
332
  let run = fn;
187
333
  for (let index = entries.length - 1; index >= 0; index -= 1) {
@@ -230,6 +376,9 @@ function shareFinalize(configuration) {
230
376
  }
231
377
  function __bitfabAutoSpan(definition, inputs, fn) {
232
378
  noteTransformedModule();
379
+ return invokeAsDiscoveredCall(definition, inputs, fn);
380
+ }
381
+ function invokeAsDiscoveredCall(definition, inputs, fn) {
233
382
  const scope = currentAutoTraceScope();
234
383
  if (!scope || scope.entries.length === 0 || isCaptureSuppressed()) return fn();
235
384
  const nameParts = definition.name.split(".");
@@ -239,6 +388,82 @@ function __bitfabAutoSpan(definition, inputs, fn) {
239
388
  const spanDetails = { contexts: [] };
240
389
  return invokeThroughAutoTraceEntries(scope.entries, (entry, next) => entry.context.invoke(definition, inputs, next, entry, spanDetails, nodeConfiguration), fn);
241
390
  }
391
+ const JEV_METHOD = "systemOne";
392
+ const jevDefinitions = /* @__PURE__ */ new Map();
393
+ function receiverClassName(receiver) {
394
+ try {
395
+ const name = receiver.constructor?.name;
396
+ return typeof name === "string" && name !== "" && name !== "Object" ? name : void 0;
397
+ } catch {
398
+ return;
399
+ }
400
+ }
401
+ function invokeRecordedClientCall(definition, args, call) {
402
+ let outcome;
403
+ const traced = invokeAsDiscoveredCall(definition, args, () => {
404
+ try {
405
+ const value = call();
406
+ outcome = { value };
407
+ return value;
408
+ } catch (error) {
409
+ outcome = { error };
410
+ throw error;
411
+ }
412
+ });
413
+ if (outcome === void 0) return traced;
414
+ if ("value" in outcome && traced === outcome.value) return traced;
415
+ if (traced instanceof Promise) holdAutoTraceRoots(traced);
416
+ if ("error" in outcome) throw outcome.error;
417
+ return outcome.value;
418
+ }
419
+ function jevDefinition(receiver) {
420
+ const className = receiverClassName(receiver);
421
+ const name = className === void 0 ? JEV_METHOD : `${className}.${JEV_METHOD}`;
422
+ let definition = jevDefinitions.get(name);
423
+ if (definition === void 0) {
424
+ definition = {
425
+ id: `ts-auto-v1:jev#${name}`,
426
+ name,
427
+ file: "@typesafe-ai/sdk",
428
+ line: 0,
429
+ column: 0,
430
+ async: true,
431
+ jev: true
432
+ };
433
+ jevDefinitions.set(name, definition);
434
+ }
435
+ return definition;
436
+ }
437
+ function __bitfabAutoJev(receiver, ...args) {
438
+ const target = receiver;
439
+ if (!__bitfabAutoTraceActive()) return target.systemOne(...args);
440
+ return invokeRecordedClientCall(jevDefinition(receiver), args, () => target.systemOne(...args));
441
+ }
442
+ const OPENROUTER_METHOD = "create";
443
+ const openRouterDefinitions = /* @__PURE__ */ new Map();
444
+ function openRouterDefinition(receiver) {
445
+ const className = receiverClassName(receiver);
446
+ const name = className === void 0 ? OPENROUTER_METHOD : `${className}.${OPENROUTER_METHOD}`;
447
+ let definition = openRouterDefinitions.get(name);
448
+ if (definition === void 0) {
449
+ definition = {
450
+ id: `ts-auto-v1:openrouter#${name}`,
451
+ name,
452
+ file: "openai",
453
+ line: 0,
454
+ column: 0,
455
+ async: true,
456
+ openrouter: true
457
+ };
458
+ openRouterDefinitions.set(name, definition);
459
+ }
460
+ return definition;
461
+ }
462
+ function __bitfabAutoOpenRouter(receiver, ...args) {
463
+ const target = receiver;
464
+ if (!__bitfabAutoTraceActive() || isStreamingRequest(args[0]) || !isOpenRouterCompletions(receiver)) return target.create(...args);
465
+ return invokeRecordedClientCall(openRouterDefinition(receiver), args, () => target.create(...args));
466
+ }
242
467
  function __bitfabAutoWrap(definition, fn) {
243
468
  noteTransformedModule();
244
469
  if (fn.name === "") {
@@ -266,6 +491,6 @@ function _resetAutoTraceTransformDetection() {
266
491
  autoTraceGlobal.__bitfab_auto_trace_transformed_v1__ = void 0;
267
492
  }
268
493
  //#endregion
269
- export { assertAsyncStorageRegistered as _, clearAutoTraceNodeConfiguration as a, isAsyncStorageInitDone as b, runAsAutoTraceRootFunction as c, runWithAutoTraceRootContext as d, warn as f, runWithCaptureSuppressed as g, isCaptureSuppressed as h, _resetAutoTraceTransformDetection as i, runWithAutoTraceEntry as l, writeOnce as m, __bitfabAutoTraceActive as n, currentAutoTraceEntries as o, warnOnce as p, __bitfabAutoWrap as r, invokeThroughAutoTraceEntries as s, __bitfabAutoSpan as t, runWithAutoTraceNodeConfiguration as u, asyncStorageReady as v, registerAsyncLocalStorageClass as x, createAsyncLocalStorage as y };
494
+ export { assertAsyncStorageRegistered as C, registerAsyncLocalStorageClass as D, isAsyncStorageInitDone as E, runWithCaptureSuppressed as S, createAsyncLocalStorage as T, watchOpenRouterUsage as _, __bitfabAutoWrap as a, writeOnce as b, currentAutoTraceEntries as c, runAsAutoTraceRootFunction as d, runWithAutoTraceEntry as f, recordWatchedOpenRouterCompletion as g, recordAutoTracedOpenRouter as h, __bitfabAutoTraceActive as i, invokeAsDiscoveredCall as l, runWithAutoTraceRootContext as m, __bitfabAutoOpenRouter as n, _resetAutoTraceTransformDetection as o, runWithAutoTraceNodeConfiguration as p, __bitfabAutoSpan as r, clearAutoTraceNodeConfiguration as s, __bitfabAutoJev as t, invokeThroughAutoTraceEntries as u, warn as v, asyncStorageReady as w, isCaptureSuppressed as x, warnOnce as y };
270
495
 
271
- //# sourceMappingURL=autoTrace-O40k8f5M.js.map
496
+ //# sourceMappingURL=autoTrace-ghnojSj9.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"autoTrace-ghnojSj9.js","names":["target"],"sources":["../src/asyncStorage.ts","../src/captureSuppression.ts","../src/warnOnce.ts","../src/openrouter.ts","../src/autoTrace.ts"],"sourcesContent":["/**\n * Shared AsyncLocalStorage loader.\n *\n * Provides two ways to initialize AsyncLocalStorage:\n *\n * 1. **Synchronous registration** (preferred for Node.js):\n * `asyncStorageNode.ts` calls `registerAsyncLocalStorageClass()` at module\n * evaluation time, so the class is available immediately - no async gap.\n * The `node.ts` entry point imports it before anything else.\n *\n * 2. **Async dynamic import** (fallback for the default entry point):\n * Loads `node:async_hooks` via a bundler-safe dynamic import. This is used\n * by the default `index.ts` entry point so the SDK works in browsers\n * (where the import silently fails) and in Node.js when imported via the\n * default entry point.\n *\n * ## Why the dynamic import looks like this\n *\n * We need to handle three environments:\n *\n * 1. **Pure Node.js** - `import(\"node:async_hooks\")` works natively.\n * 2. **Webpack/Turbopack (Next.js server)** - The bundler processes\n * `import()` calls at build time. The `webpackIgnore` magic comment tells\n * webpack (and turbopack) to emit a native `import()` call instead of\n * trying to resolve it, so Node.js handles it at runtime.\n * 3. **Browsers / Edge** - The `process.versions?.node` guard prevents\n * execution entirely. If it somehow runs, `.catch(() => {})` swallows\n * the failure.\n */\n\nexport interface AsyncLocalStorageLike<T> {\n getStore(): T | undefined\n run<R>(store: T, fn: () => R): R\n}\n\nlet AsyncLocalStorageClass: (new () => AsyncLocalStorageLike<unknown>) | null =\n null\nlet initDone = false\n\n/**\n * Register the AsyncLocalStorage class synchronously.\n *\n * Called by `asyncStorageNode.ts` at module evaluation time so the class\n * is available before any span is created - no async gap, no race condition.\n *\n * Safe to call multiple times; subsequent calls are no-ops.\n */\nexport function registerAsyncLocalStorageClass(\n cls: new () => AsyncLocalStorageLike<unknown>,\n): void {\n if (!AsyncLocalStorageClass) {\n AsyncLocalStorageClass = cls\n }\n initDone = true\n}\n\n/**\n * Assert that AsyncLocalStorage was registered successfully.\n *\n * Called by `node.ts` after importing `asyncStorageNode.ts` to catch\n * import-order bugs at startup rather than silently degrading to the\n * browser fallback (flat spans with no nesting).\n *\n * This should ONLY be called from the Node.js entry point where we\n * know `node:async_hooks` must be available.\n */\nexport function assertAsyncStorageRegistered(): void {\n if (!AsyncLocalStorageClass) {\n console.warn(\n \"Bitfab: AsyncLocalStorage not available - nested span context will not propagate.\",\n )\n }\n}\n\nexport const asyncStorageReady: Promise<void> = (\n typeof process !== \"undefined\" && process.versions?.node\n ? // The join trick hides \"node:async_hooks\" from static analysis so\n // bundlers that ban Node.js built-ins don't fail at build time.\n // webpackIgnore tells webpack/turbopack to emit a native import()\n // so Node.js can resolve the module at runtime.\n import(\n /* webpackIgnore: true */\n [\"node\", \"async_hooks\"].join(\":\")\n )\n .then(\n (mod: {\n AsyncLocalStorage: new () => AsyncLocalStorageLike<unknown>\n }) => {\n registerAsyncLocalStorageClass(mod.AsyncLocalStorage)\n },\n )\n .catch(() => {})\n : Promise.resolve()\n).then(() => {\n initDone = true\n})\n\nexport function isAsyncStorageInitDone(): boolean {\n return initDone\n}\n\nexport function createAsyncLocalStorage<T>(): AsyncLocalStorageLike<T> | null {\n return AsyncLocalStorageClass\n ? (new AsyncLocalStorageClass() as AsyncLocalStorageLike<T>)\n : null\n}\n","interface CaptureSuppressionState {\n depth: number\n}\n\ninterface CaptureSuppressionGlobal {\n __bitfabCaptureSuppressionV1?: CaptureSuppressionState\n}\n\nconst suppressionGlobal = globalThis as unknown as CaptureSuppressionGlobal\nconst suppressionState: CaptureSuppressionState =\n suppressionGlobal.__bitfabCaptureSuppressionV1 ?? { depth: 0 }\nsuppressionGlobal.__bitfabCaptureSuppressionV1 = suppressionState\n\nexport function isCaptureSuppressed(): boolean {\n return suppressionState.depth > 0\n}\n\nexport function runWithCaptureSuppressed<T>(fn: () => T): T {\n suppressionState.depth += 1\n try {\n return fn()\n } finally {\n suppressionState.depth -= 1\n }\n}\n","/**\n * Emit a `console.warn` at most once per distinct `key` for the life of the\n * process.\n *\n * The SDK must NEVER crash a host app, so every failure on the user's path\n * degrades silently (a span is dropped, a call runs untraced, a payload is\n * stubbed). Silent is safe but undebuggable: a user who suddenly has no traces,\n * or sees `<unserializable>` in a span, has no signal as to why. A one-time\n * warning per distinct issue restores that signal without spamming the console\n * from a hot path.\n *\n * Keys should identify the specific degradation (e.g. include the traced\n * function key) so each distinct issue warns once, not just the first one seen.\n */\nconst warned = new Set<string>()\n\nexport function warn(message: string): void {\n try {\n console.warn(`[bitfab] ${message}`)\n } catch {\n // Logging must never crash the host app (e.g. a closed/replaced console).\n }\n}\n\nexport function warnOnce(key: string, message: string): void {\n if (warned.has(key)) {\n return\n }\n warned.add(key)\n warn(message)\n}\n\nexport function writeOnce(\n key: string,\n line: string,\n write: (line: string) => void = console.warn,\n): void {\n if (warned.has(key)) {\n return\n }\n warned.add(key)\n try {\n write(line)\n } catch {}\n}\n\n/** Test-only: clear the dedup set so a warning can fire again. */\nexport function _resetWarnOnce(): void {\n warned.clear()\n}\n","import {\n type AsyncLocalStorageLike,\n createAsyncLocalStorage,\n} from \"./asyncStorage.js\"\n\nexport const OPENROUTER_PROVIDER = \"openrouter\"\n\nconst OPENROUTER_HOSTNAME = \"openrouter.ai\"\nconst OPENROUTER_WATCH_STORAGE_SYMBOL = Symbol.for(\n \"bitfab.openRouterWatchStorage\",\n)\n\ninterface OpenRouterWatch {\n recorded: boolean\n parent: OpenRouterWatch | null\n}\n\ninterface OpenRouterSpan {\n addContext(context: Record<string, unknown>): void\n setPrompt(prompt: string): void\n}\n\nconst completionsRecordedByAutoTrace = new WeakSet<object>()\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null\n}\n\nfunction field(value: unknown, name: string): unknown {\n return isRecord(value) ? value[name] : undefined\n}\n\nfunction numberField(value: unknown, name: string): number | undefined {\n const found = field(value, name)\n return typeof found === \"number\" && Number.isFinite(found) ? found : undefined\n}\n\nfunction nonEmptyString(value: unknown): string | undefined {\n return typeof value === \"string\" && value !== \"\" ? value : undefined\n}\n\nfunction isOpenRouterBaseUrl(baseUrl: unknown): boolean {\n if (typeof baseUrl !== \"string\") {\n return false\n }\n try {\n const host = new URL(baseUrl).hostname\n return (\n host === OPENROUTER_HOSTNAME || host.endsWith(`.${OPENROUTER_HOSTNAME}`)\n )\n } catch {\n return false\n }\n}\n\nexport function isOpenRouterCompletions(receiver: unknown): boolean {\n try {\n return isOpenRouterBaseUrl(field(field(receiver, \"_client\"), \"baseURL\"))\n } catch {\n return false\n }\n}\n\nexport function isStreamingRequest(body: unknown): boolean {\n return field(body, \"stream\") === true\n}\n\nfunction isChatCompletion(value: unknown): boolean {\n return isRecord(value) && Array.isArray(value.choices)\n}\n\nexport function openRouterPrompt(body: unknown): string | undefined {\n const messages = field(body, \"messages\")\n if (!Array.isArray(messages)) {\n return undefined\n }\n const rendered = messages.flatMap((message) => {\n const role = field(message, \"role\")\n if (typeof role !== \"string\") {\n return []\n }\n const content = field(message, \"content\")\n return [\n {\n role,\n content:\n typeof content === \"string\" ? content : JSON.stringify(content),\n },\n ]\n })\n return rendered.length > 0 ? JSON.stringify(rendered) : undefined\n}\n\nexport function openRouterContext(\n body: unknown,\n response: unknown,\n durationMs: number,\n): Record<string, unknown> {\n const usage = field(response, \"usage\")\n const context: Record<string, unknown> = { provider: OPENROUTER_PROVIDER }\n const values: Record<string, unknown> = {\n model:\n nonEmptyString(field(response, \"model\")) ??\n nonEmptyString(field(body, \"model\")),\n upstreamProvider: nonEmptyString(field(response, \"provider\")),\n inputTokens: numberField(usage, \"prompt_tokens\"),\n outputTokens: numberField(usage, \"completion_tokens\"),\n cachedInputTokens: numberField(\n field(usage, \"prompt_tokens_details\"),\n \"cached_tokens\",\n ),\n reasoningTokens: numberField(\n field(usage, \"completion_tokens_details\"),\n \"reasoning_tokens\",\n ),\n costUsd: numberField(usage, \"cost\"),\n }\n for (const [key, value] of Object.entries(values)) {\n if (value !== undefined) {\n context[key] = value\n }\n }\n context.durationMs = durationMs\n return context\n}\n\nfunction recordOpenRouterCompletion(\n span: OpenRouterSpan,\n body: unknown,\n response: unknown,\n durationMs: number,\n): void {\n try {\n const prompt = openRouterPrompt(body)\n if (prompt !== undefined) {\n span.setPrompt(prompt)\n }\n span.addContext(openRouterContext(body, response, durationMs))\n } catch {}\n}\n\nlet openRouterWatchStorage: AsyncLocalStorageLike<OpenRouterWatch> | null = null\n\nfunction watchStorage(): AsyncLocalStorageLike<OpenRouterWatch> | null {\n if (openRouterWatchStorage) {\n return openRouterWatchStorage\n }\n const shared = globalThis as typeof globalThis & Record<symbol, unknown>\n const existing = shared[OPENROUTER_WATCH_STORAGE_SYMBOL] as\n | AsyncLocalStorageLike<OpenRouterWatch>\n | undefined\n openRouterWatchStorage =\n existing ?? createAsyncLocalStorage<OpenRouterWatch>()\n if (openRouterWatchStorage && !existing) {\n shared[OPENROUTER_WATCH_STORAGE_SYMBOL] = openRouterWatchStorage\n }\n return openRouterWatchStorage\n}\n\nexport function watchOpenRouterUsage<T>(fn: () => T): {\n watch: OpenRouterWatch\n result: T\n} {\n const storage = watchStorage()\n const watch: OpenRouterWatch = {\n recorded: false,\n parent: storage?.getStore() ?? null,\n }\n const result = storage ? storage.run(watch, fn) : fn()\n return { watch, result }\n}\n\nfunction markEnclosingWatches(watch: OpenRouterWatch): void {\n for (let current = watch.parent; current; current = current.parent) {\n current.recorded = true\n }\n}\n\nfunction isRecordedByAutoTrace(response: unknown): boolean {\n return isRecord(response) && completionsRecordedByAutoTrace.has(response)\n}\n\nexport function recordWatchedOpenRouterCompletion(\n span: OpenRouterSpan,\n watch: OpenRouterWatch,\n body: unknown,\n response: unknown,\n durationMs: number,\n): void {\n if (watch.recorded || isRecordedByAutoTrace(response)) {\n markEnclosingWatches(watch)\n return\n }\n if (!isChatCompletion(response)) {\n return\n }\n recordOpenRouterCompletion(span, body, response, durationMs)\n completionsRecordedByAutoTrace.add(response as object)\n markEnclosingWatches(watch)\n}\n\nexport function recordAutoTracedOpenRouter<T>(\n invokeFn: () => T,\n body: unknown,\n span: OpenRouterSpan,\n): T {\n const startedAt = Date.now()\n const { watch, result } = watchOpenRouterUsage(invokeFn)\n const settle = (response: unknown): void => {\n recordWatchedOpenRouterCompletion(\n span,\n watch,\n body,\n response,\n Date.now() - startedAt,\n )\n }\n if (result instanceof Promise) {\n return result.then((response) => {\n settle(response)\n return response\n }) as T\n }\n settle(result)\n return result\n}\n","import {\n type AsyncLocalStorageLike,\n createAsyncLocalStorage,\n} from \"./asyncStorage.js\"\nimport { isCaptureSuppressed } from \"./captureSuppression.js\"\nimport { isOpenRouterCompletions, isStreamingRequest } from \"./openrouter.js\"\nimport { warnOnce } from \"./warnOnce.js\"\n\nexport interface AutoTraceFunctionDefinition {\n id: string\n name: string\n file: string\n line: number\n column: number\n async?: boolean\n wrapper?: boolean\n baml?: boolean\n jev?: boolean\n openrouter?: boolean\n}\n\nexport interface AutoTraceNodeConfiguration {\n functionName: string\n name?: string\n type?: \"llm\" | \"agent\" | \"function\" | \"guardrail\" | \"handoff\" | \"custom\"\n defaultType?: boolean\n capture: boolean\n experimentId?: string\n /** @deprecated Use experimentId. */\n testRunId?: string\n mockOnReplay?: boolean\n replayReusable?: boolean\n // biome-ignore lint/suspicious/noExplicitAny: node finalizers receive the configured function's result, whose type is owned by the caller\n finalize?: (result: any) => unknown | Promise<unknown>\n}\n\nexport interface NestedTraceLink {\n traceFunctionKey: string\n traceId?: string\n rootSpanId?: string\n}\n\nexport interface SpanDetails {\n contexts: Record<string, unknown>[]\n prompt?: string\n}\n\nexport interface AutoTraceEntry {\n context: AutoTraceContext\n depth: number\n spanStack: unknown\n}\n\nexport interface AutoTraceContext {\n readonly traceFunctionKey: string\n invoke<T>(\n definition: AutoTraceFunctionDefinition,\n inputs: unknown[],\n fn: () => T,\n entry: AutoTraceEntry,\n spanDetails: SpanDetails,\n nodeConfiguration?: AutoTraceNodeConfiguration,\n ): T\n invokeNestedRoot<T>(\n name: string,\n functionName: string,\n inputs: unknown[],\n fn: () => T,\n entry: AutoTraceEntry,\n link: NestedTraceLink | undefined,\n spanDetails: SpanDetails,\n ): T\n}\n\ninterface AutoTraceRootFunction {\n name: string\n entering: boolean\n}\n\ninterface AutoTraceScope {\n entries: readonly AutoTraceEntry[]\n nodeConfiguration?: AutoTraceNodeConfiguration\n rootFunction?: AutoTraceRootFunction\n}\n\ninterface AutoTraceState {\n storage: AsyncLocalStorageLike<AutoTraceScope> | null\n browserScope: AutoTraceScope | undefined\n // Older SDK copies read this field when sharing the process-wide V4 state.\n capturePolicies: WeakMap<object, Map<string, ReadonlySet<string>>>\n activeRoots: number\n}\n\ninterface AutoTraceGlobal {\n __bitfabAutoTraceStateV4?: AutoTraceState\n __bitfab_auto_trace_transformed_v1__?: boolean\n}\n\ninterface AutoTraceAsyncGenerator {\n next(value?: unknown): Promise<IteratorResult<unknown, unknown>>\n return(value?: unknown): Promise<IteratorResult<unknown, unknown>>\n throw(error?: unknown): Promise<IteratorResult<unknown, unknown>>\n [Symbol.asyncIterator](): AutoTraceAsyncGenerator\n}\n\nconst autoTraceGlobal = globalThis as unknown as AutoTraceGlobal\nconst autoTraceState: AutoTraceState =\n autoTraceGlobal.__bitfabAutoTraceStateV4 ?? {\n storage: null,\n browserScope: undefined,\n capturePolicies: new WeakMap(),\n activeRoots: 0,\n }\nautoTraceGlobal.__bitfabAutoTraceStateV4 = autoTraceState\n\nfunction initializeAutoTraceStorage(): void {\n autoTraceState.storage ??= createAsyncLocalStorage<AutoTraceScope>()\n}\n\nfunction runWithAutoTraceScope<T>(scope: AutoTraceScope, fn: () => T): T {\n initializeAutoTraceStorage()\n if (autoTraceState.storage) {\n return autoTraceState.storage.run(scope, fn)\n }\n\n const previous = autoTraceState.browserScope\n autoTraceState.browserScope = scope\n try {\n return fn()\n } finally {\n autoTraceState.browserScope = previous\n }\n}\n\nexport function currentAutoTraceEntries(): readonly AutoTraceEntry[] {\n return currentAutoTraceScope()?.entries ?? []\n}\n\nfunction replaceEntry(\n entries: readonly AutoTraceEntry[],\n previous: AutoTraceEntry,\n updated: AutoTraceEntry,\n): readonly AutoTraceEntry[] {\n return entries.map((entry) => (entry === previous ? updated : entry))\n}\n\nexport function runWithAutoTraceEntry<T>(\n previous: AutoTraceEntry,\n updated: AutoTraceEntry,\n fn: () => T,\n): T {\n const result = runWithAutoTraceScope(\n { entries: replaceEntry(currentAutoTraceEntries(), previous, updated) },\n fn,\n )\n if (isAutoTraceAsyncGenerator(result)) {\n return wrapAutoTraceEntryAsyncGenerator(previous, updated, result) as T\n }\n return result\n}\n\nfunction wrapAutoTraceEntryAsyncGenerator(\n previous: AutoTraceEntry,\n updated: AutoTraceEntry,\n source: AutoTraceAsyncGenerator,\n): AutoTraceAsyncGenerator {\n const step = (\n method: \"next\" | \"return\" | \"throw\",\n value?: unknown,\n ): Promise<IteratorResult<unknown, unknown>> =>\n runWithAutoTraceScope(\n { entries: replaceEntry(currentAutoTraceEntries(), previous, updated) },\n () => source[method](value),\n )\n const wrapped: AutoTraceAsyncGenerator = {\n next: (value) => step(\"next\", value),\n return: (value) => step(\"return\", value),\n throw: (error) => step(\"throw\", error),\n [Symbol.asyncIterator]: () => wrapped,\n }\n return wrapped\n}\n\nexport function clearAutoTraceNodeConfiguration<T>(fn: () => T): T {\n return runWithAutoTraceScope({ entries: currentAutoTraceEntries() }, fn)\n}\n\nexport function runWithAutoTraceNodeConfiguration<T>(\n nodeConfiguration: AutoTraceNodeConfiguration,\n fn: () => T,\n): T {\n const scope = currentAutoTraceScope()\n if (!scope || scope.entries.length === 0) {\n return fn()\n }\n\n const result = runWithAutoTraceScope({ ...scope, nodeConfiguration }, fn)\n if (isAutoTraceAsyncGenerator(result)) {\n return wrapAutoTraceNodeAsyncGenerator(nodeConfiguration, result) as T\n }\n return result\n}\n\nexport function runAsAutoTraceRootFunction<T>(\n functionName: string,\n fn: () => T,\n): T {\n const scope = currentAutoTraceScope()\n if (!scope || scope.entries.length === 0 || functionName === \"\") {\n return fn()\n }\n const rootFunction: AutoTraceRootFunction = {\n name: functionName,\n entering: true,\n }\n try {\n return runWithAutoTraceScope({ ...scope, rootFunction }, fn)\n } finally {\n rootFunction.entering = false\n }\n}\n\nfunction isRootFunctionEntry(\n scope: AutoTraceScope,\n simpleName: string | undefined,\n): boolean {\n const rootFunction = scope.rootFunction\n if (rootFunction === undefined || !rootFunction.entering) {\n return false\n }\n rootFunction.entering = false\n return rootFunction.name === simpleName\n}\n\nconst SUBTREE_TRACING_DOCS_URL =\n \"https://docs.bitfab.ai/typescript-sdk#experimental-subtree-tracing\"\n\nfunction noteTransformedModule(): void {\n autoTraceGlobal.__bitfab_auto_trace_transformed_v1__ = true\n}\n\nfunction transformInstalled(): boolean {\n return autoTraceGlobal.__bitfab_auto_trace_transformed_v1__ === true\n}\n\nfunction runsOnNode(): boolean {\n return typeof process !== \"undefined\" && Boolean(process.versions?.node)\n}\n\nfunction closeAutoTraceRoot(): void {\n autoTraceState.activeRoots -= 1\n}\n\nfunction settleAutoTraceRoot(context: AutoTraceContext): void {\n closeAutoTraceRoot()\n if (transformInstalled() || !runsOnNode()) {\n return\n }\n warnOnce(\n \"auto-trace-transform-missing\",\n `trace root \"${context.traceFunctionKey}\" recorded only its own span. ` +\n \"No module in this build was compiled by @bitfab/sdk/transform, so calls \" +\n \"beneath the root were not discovered. Add the SDK's transform adapter \" +\n `to the server build: ${SUBTREE_TRACING_DOCS_URL}`,\n )\n}\n\nconst heldRootWork = new WeakMap<AutoTraceContext, Promise<unknown>[]>()\n\nexport function runWithAutoTraceRootContext<T>(\n context: AutoTraceContext,\n spanStack: unknown,\n fn: () => T,\n): T {\n autoTraceState.activeRoots += 1\n const entries = [\n ...currentAutoTraceEntries(),\n { context, depth: 0, spanStack },\n ]\n const held: Promise<unknown>[] = []\n heldRootWork.set(context, held)\n let result: T\n try {\n result = runWithAutoTraceScope({ entries }, fn)\n } catch (error) {\n heldRootWork.delete(context)\n settleAutoTraceRoot(context)\n throw error\n }\n\n if (isAutoTraceAsyncGenerator(result)) {\n heldRootWork.delete(context)\n closeAutoTraceRoot()\n return wrapAutoTraceAsyncGenerator(context, spanStack, result) as T\n }\n\n if (result instanceof Promise) {\n return result.then(\n (value) => finishAfterHeldWork(context, held, () => value),\n (error) =>\n finishAfterHeldWork(context, held, () => {\n throw error\n }),\n ) as T\n }\n\n heldRootWork.delete(context)\n settleAutoTraceRoot(context)\n return result\n}\n\nfunction finishAfterHeldWork<T>(\n context: AutoTraceContext,\n held: Promise<unknown>[],\n finish: () => T,\n): T | Promise<T> {\n const pending = held.splice(0)\n if (pending.length === 0) {\n heldRootWork.delete(context)\n settleAutoTraceRoot(context)\n return finish()\n }\n return Promise.all(pending).then(() =>\n finishAfterHeldWork(context, held, finish),\n )\n}\n\nfunction holdAutoTraceRoots(work: Promise<unknown>): void {\n const settled = work.then(\n () => undefined,\n () => undefined,\n )\n for (const entry of currentAutoTraceEntries()) {\n heldRootWork.get(entry.context)?.push(settled)\n }\n}\n\nexport function invokeThroughAutoTraceEntries<T>(\n entries: readonly AutoTraceEntry[],\n step: (entry: AutoTraceEntry, next: () => T) => T,\n fn: () => T,\n): T {\n let run = fn\n for (let index = entries.length - 1; index >= 0; index -= 1) {\n const entry = entries[index] as AutoTraceEntry\n const next = run\n run = () => step(entry, next)\n }\n return run()\n}\n\nfunction isAutoTraceAsyncGenerator(\n value: unknown,\n): value is AutoTraceAsyncGenerator {\n if (value === null || typeof value !== \"object\") {\n return false\n }\n const candidate = value as Record<PropertyKey, unknown>\n return (\n typeof candidate.next === \"function\" &&\n typeof candidate.return === \"function\" &&\n typeof candidate.throw === \"function\" &&\n typeof candidate[Symbol.asyncIterator] === \"function\"\n )\n}\n\nfunction wrapAutoTraceAsyncGenerator(\n context: AutoTraceContext,\n spanStack: unknown,\n source: AutoTraceAsyncGenerator,\n): AutoTraceAsyncGenerator {\n const step = (\n method: \"next\" | \"return\" | \"throw\",\n value?: unknown,\n ): Promise<IteratorResult<unknown, unknown>> =>\n runWithAutoTraceRootContext(context, spanStack, () => source[method](value))\n const wrapped: AutoTraceAsyncGenerator = {\n next: (value) => step(\"next\", value),\n return: (value) => step(\"return\", value),\n throw: (error) => step(\"throw\", error),\n [Symbol.asyncIterator]: () => wrapped,\n }\n return wrapped\n}\n\nfunction wrapAutoTraceNodeAsyncGenerator(\n nodeConfiguration: AutoTraceNodeConfiguration,\n source: AutoTraceAsyncGenerator,\n): AutoTraceAsyncGenerator {\n const step = (\n method: \"next\" | \"return\" | \"throw\",\n value?: unknown,\n ): Promise<IteratorResult<unknown, unknown>> =>\n runWithAutoTraceNodeConfiguration(nodeConfiguration, () =>\n source[method](value),\n )\n const wrapped: AutoTraceAsyncGenerator = {\n next: (value) => step(\"next\", value),\n return: (value) => step(\"return\", value),\n throw: (error) => step(\"throw\", error),\n [Symbol.asyncIterator]: () => wrapped,\n }\n return wrapped\n}\n\nfunction shareFinalize(\n configuration: AutoTraceNodeConfiguration,\n): AutoTraceNodeConfiguration {\n const finalize = configuration.finalize\n if (finalize === undefined) {\n return configuration\n }\n let settled: Promise<unknown> | undefined\n return {\n ...configuration,\n finalize: (result: unknown) => {\n settled ??= Promise.resolve().then(() => finalize(result))\n return settled\n },\n }\n}\n\nexport function __bitfabAutoSpan<T>(\n definition: AutoTraceFunctionDefinition,\n inputs: unknown[],\n fn: () => T,\n): T {\n noteTransformedModule()\n return invokeAsDiscoveredCall(definition, inputs, fn)\n}\n\n/**\n * Record a call the build transform did not wrap as a function, such as a\n * rewritten call site, as if the transform had discovered it. It is internal\n * runtime protocol, not a supported application API.\n *\n * @experimental The automatic tracing protocol may change.\n */\nexport function invokeAsDiscoveredCall<T>(\n definition: AutoTraceFunctionDefinition,\n inputs: unknown[],\n fn: () => T,\n): T {\n const scope = currentAutoTraceScope()\n if (!scope || scope.entries.length === 0 || isCaptureSuppressed()) {\n return fn()\n }\n const nameParts = definition.name.split(\".\")\n const simpleName = nameParts[nameParts.length - 1]\n if (isRootFunctionEntry(scope, simpleName)) {\n return fn()\n }\n const nodeConfiguration =\n simpleName === scope.nodeConfiguration?.functionName\n ? shareFinalize(scope.nodeConfiguration)\n : undefined\n const spanDetails: SpanDetails = { contexts: [] }\n return invokeThroughAutoTraceEntries(\n scope.entries,\n (entry, next) =>\n entry.context.invoke(\n definition,\n inputs,\n next,\n entry,\n spanDetails,\n nodeConfiguration,\n ),\n fn,\n )\n}\n\nconst JEV_METHOD = \"systemOne\"\n\nconst jevDefinitions = new Map<string, AutoTraceFunctionDefinition>()\n\ntype JevReceiver = Record<typeof JEV_METHOD, (...args: unknown[]) => unknown>\n\ntype RecordedCallOutcome = { value: unknown } | { error: unknown }\n\nfunction receiverClassName(receiver: unknown): string | undefined {\n try {\n const name = (receiver as { constructor?: { name?: unknown } }).constructor\n ?.name\n return typeof name === \"string\" && name !== \"\" && name !== \"Object\"\n ? name\n : undefined\n } catch {\n return undefined\n }\n}\n\nfunction invokeRecordedClientCall(\n definition: AutoTraceFunctionDefinition,\n args: unknown[],\n call: () => unknown,\n): unknown {\n let outcome: RecordedCallOutcome | undefined\n const traced = invokeAsDiscoveredCall(definition, args, () => {\n try {\n const value = call()\n outcome = { value }\n return value\n } catch (error) {\n outcome = { error }\n throw error\n }\n })\n if (outcome === undefined) {\n return traced\n }\n if (\"value\" in outcome && traced === outcome.value) {\n return traced\n }\n if (traced instanceof Promise) {\n holdAutoTraceRoots(traced)\n }\n if (\"error\" in outcome) {\n throw outcome.error\n }\n return outcome.value\n}\n\nfunction jevDefinition(receiver: unknown): AutoTraceFunctionDefinition {\n const className = receiverClassName(receiver)\n const name =\n className === undefined ? JEV_METHOD : `${className}.${JEV_METHOD}`\n let definition = jevDefinitions.get(name)\n if (definition === undefined) {\n definition = {\n id: `ts-auto-v1:jev#${name}`,\n name,\n file: \"@typesafe-ai/sdk\",\n line: 0,\n column: 0,\n async: true,\n jev: true,\n }\n jevDefinitions.set(name, definition)\n }\n return definition\n}\n\n/**\n * Call `receiver.systemOne(...args)` from a call site rewritten by the build\n * transform. Beneath an automatic trace root the call is recorded as one `llm`\n * span with Jev's model and token usage, and the client's own returned value\n * is handed back unchanged. Outside a root it is a plain method call.\n *\n * This helper is internal transform/runtime protocol, not a supported\n * application API.\n *\n * @experimental The automatic tracing protocol may change.\n */\nexport function __bitfabAutoJev(\n receiver: unknown,\n ...args: unknown[]\n): unknown {\n const target = receiver as JevReceiver\n if (!__bitfabAutoTraceActive()) {\n return target.systemOne(...args)\n }\n return invokeRecordedClientCall(jevDefinition(receiver), args, () =>\n target.systemOne(...args),\n )\n}\n\nconst OPENROUTER_METHOD = \"create\"\n\nconst openRouterDefinitions = new Map<string, AutoTraceFunctionDefinition>()\n\ntype OpenRouterReceiver = Record<\n typeof OPENROUTER_METHOD,\n (...args: unknown[]) => unknown\n>\n\nfunction openRouterDefinition(receiver: unknown): AutoTraceFunctionDefinition {\n const className = receiverClassName(receiver)\n const name =\n className === undefined\n ? OPENROUTER_METHOD\n : `${className}.${OPENROUTER_METHOD}`\n let definition = openRouterDefinitions.get(name)\n if (definition === undefined) {\n definition = {\n id: `ts-auto-v1:openrouter#${name}`,\n name,\n file: \"openai\",\n line: 0,\n column: 0,\n async: true,\n openrouter: true,\n }\n openRouterDefinitions.set(name, definition)\n }\n return definition\n}\n\n/**\n * Call `receiver.create(...args)` from a `.chat.completions.create(...)` call\n * site rewritten by the build transform. Beneath an automatic trace root, when\n * the client's base URL is `openrouter.ai` and the request does not stream,\n * the call is recorded as one `llm` span with the prompt, model, token usage,\n * and the cost OpenRouter reports, and the client's own returned value is\n * handed back unchanged. Otherwise it is a plain method call.\n *\n * This helper is internal transform/runtime protocol, not a supported\n * application API.\n *\n * @experimental The automatic tracing protocol may change.\n */\nexport function __bitfabAutoOpenRouter(\n receiver: unknown,\n ...args: unknown[]\n): unknown {\n const target = receiver as OpenRouterReceiver\n if (\n !__bitfabAutoTraceActive() ||\n isStreamingRequest(args[0]) ||\n !isOpenRouterCompletions(receiver)\n ) {\n return target.create(...args)\n }\n return invokeRecordedClientCall(openRouterDefinition(receiver), args, () =>\n target.create(...args),\n )\n}\n\n/**\n * Preserve a function's original call arguments for transform cases where\n * parameter bindings discard them, such as destructured arrow parameters.\n *\n * This helper is internal transform/runtime protocol. The proxy preserves the\n * target's callability, arity, async identity, and non-constructibility while\n * only allocating a trace closure beneath an active automatic trace root.\n *\n * @experimental The automatic tracing protocol may change.\n */\nexport function __bitfabAutoWrap<T extends (...args: never[]) => unknown>(\n definition: AutoTraceFunctionDefinition,\n fn: T,\n): T {\n noteTransformedModule()\n if (fn.name === \"\") {\n const nameParts = definition.name.split(\".\")\n const inferredName = nameParts[nameParts.length - 1]\n if (inferredName !== undefined) {\n Object.defineProperty(fn, \"name\", {\n configurable: true,\n value: inferredName,\n })\n }\n }\n\n const target = fn as unknown as (...args: unknown[]) => unknown\n return new Proxy(target, {\n apply(callTarget, thisArg, args) {\n if (!__bitfabAutoTraceActive()) {\n return Reflect.apply(callTarget, thisArg, args)\n }\n return __bitfabAutoSpan(definition, args, () =>\n Reflect.apply(callTarget, thisArg, args),\n )\n },\n }) as unknown as T\n}\n\n/**\n * Return whether the current call is inside an automatic trace root.\n *\n * Build transforms use this before allocating function metadata, captured\n * inputs, or an invocation closure. It is internal transform/runtime protocol,\n * not a supported application API.\n *\n * @experimental The automatic tracing protocol may change.\n */\nexport function __bitfabAutoTraceActive(): boolean {\n if (autoTraceState.activeRoots === 0 || isCaptureSuppressed()) {\n return false\n }\n return currentAutoTraceEntries().length > 0\n}\n\nfunction currentAutoTraceScope(): AutoTraceScope | undefined {\n initializeAutoTraceStorage()\n return autoTraceState.storage?.getStore() ?? autoTraceState.browserScope\n}\n\nexport function _resetAutoTraceTransformDetection(): void {\n autoTraceGlobal.__bitfab_auto_trace_transformed_v1__ = undefined\n}\n"],"mappings":"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"}
@@ -2,13 +2,16 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_autoTrace = require("./autoTrace-CQw0qMBt.cjs");
5
+ const require_autoTrace = require("./autoTrace-D3-OZcmR.cjs");
6
+ exports.__bitfabAutoJev = require_autoTrace.__bitfabAutoJev;
7
+ exports.__bitfabAutoOpenRouter = require_autoTrace.__bitfabAutoOpenRouter;
6
8
  exports.__bitfabAutoSpan = require_autoTrace.__bitfabAutoSpan;
7
9
  exports.__bitfabAutoTraceActive = require_autoTrace.__bitfabAutoTraceActive;
8
10
  exports.__bitfabAutoWrap = require_autoTrace.__bitfabAutoWrap;
9
11
  exports._resetAutoTraceTransformDetection = require_autoTrace._resetAutoTraceTransformDetection;
10
12
  exports.clearAutoTraceNodeConfiguration = require_autoTrace.clearAutoTraceNodeConfiguration;
11
13
  exports.currentAutoTraceEntries = require_autoTrace.currentAutoTraceEntries;
14
+ exports.invokeAsDiscoveredCall = require_autoTrace.invokeAsDiscoveredCall;
12
15
  exports.invokeThroughAutoTraceEntries = require_autoTrace.invokeThroughAutoTraceEntries;
13
16
  exports.runAsAutoTraceRootFunction = require_autoTrace.runAsAutoTraceRootFunction;
14
17
  exports.runWithAutoTraceEntry = require_autoTrace.runWithAutoTraceEntry;
@@ -8,6 +8,8 @@ export interface AutoTraceFunctionDefinition {
8
8
  async?: boolean;
9
9
  wrapper?: boolean;
10
10
  baml?: boolean;
11
+ jev?: boolean;
12
+ openrouter?: boolean;
11
13
  }
12
14
  export interface AutoTraceNodeConfiguration {
13
15
  functionName: string;
@@ -49,6 +51,40 @@ export declare function runAsAutoTraceRootFunction<T>(functionName: string, fn:
49
51
  export declare function runWithAutoTraceRootContext<T>(context: AutoTraceContext, spanStack: unknown, fn: () => T): T;
50
52
  export declare function invokeThroughAutoTraceEntries<T>(entries: readonly AutoTraceEntry[], step: (entry: AutoTraceEntry, next: () => T) => T, fn: () => T): T;
51
53
  export declare function __bitfabAutoSpan<T>(definition: AutoTraceFunctionDefinition, inputs: unknown[], fn: () => T): T;
54
+ /**
55
+ * Record a call the build transform did not wrap as a function, such as a
56
+ * rewritten call site, as if the transform had discovered it. It is internal
57
+ * runtime protocol, not a supported application API.
58
+ *
59
+ * @experimental The automatic tracing protocol may change.
60
+ */
61
+ export declare function invokeAsDiscoveredCall<T>(definition: AutoTraceFunctionDefinition, inputs: unknown[], fn: () => T): T;
62
+ /**
63
+ * Call `receiver.systemOne(...args)` from a call site rewritten by the build
64
+ * transform. Beneath an automatic trace root the call is recorded as one `llm`
65
+ * span with Jev's model and token usage, and the client's own returned value
66
+ * is handed back unchanged. Outside a root it is a plain method call.
67
+ *
68
+ * This helper is internal transform/runtime protocol, not a supported
69
+ * application API.
70
+ *
71
+ * @experimental The automatic tracing protocol may change.
72
+ */
73
+ export declare function __bitfabAutoJev(receiver: unknown, ...args: unknown[]): unknown;
74
+ /**
75
+ * Call `receiver.create(...args)` from a `.chat.completions.create(...)` call
76
+ * site rewritten by the build transform. Beneath an automatic trace root, when
77
+ * the client's base URL is `openrouter.ai` and the request does not stream,
78
+ * the call is recorded as one `llm` span with the prompt, model, token usage,
79
+ * and the cost OpenRouter reports, and the client's own returned value is
80
+ * handed back unchanged. Otherwise it is a plain method call.
81
+ *
82
+ * This helper is internal transform/runtime protocol, not a supported
83
+ * application API.
84
+ *
85
+ * @experimental The automatic tracing protocol may change.
86
+ */
87
+ export declare function __bitfabAutoOpenRouter(receiver: unknown, ...args: unknown[]): unknown;
52
88
  /**
53
89
  * Preserve a function's original call arguments for transform cases where
54
90
  * parameter bindings discard them, such as destructured arrow parameters.
@@ -8,6 +8,8 @@ export interface AutoTraceFunctionDefinition {
8
8
  async?: boolean;
9
9
  wrapper?: boolean;
10
10
  baml?: boolean;
11
+ jev?: boolean;
12
+ openrouter?: boolean;
11
13
  }
12
14
  export interface AutoTraceNodeConfiguration {
13
15
  functionName: string;
@@ -49,6 +51,40 @@ export declare function runAsAutoTraceRootFunction<T>(functionName: string, fn:
49
51
  export declare function runWithAutoTraceRootContext<T>(context: AutoTraceContext, spanStack: unknown, fn: () => T): T;
50
52
  export declare function invokeThroughAutoTraceEntries<T>(entries: readonly AutoTraceEntry[], step: (entry: AutoTraceEntry, next: () => T) => T, fn: () => T): T;
51
53
  export declare function __bitfabAutoSpan<T>(definition: AutoTraceFunctionDefinition, inputs: unknown[], fn: () => T): T;
54
+ /**
55
+ * Record a call the build transform did not wrap as a function, such as a
56
+ * rewritten call site, as if the transform had discovered it. It is internal
57
+ * runtime protocol, not a supported application API.
58
+ *
59
+ * @experimental The automatic tracing protocol may change.
60
+ */
61
+ export declare function invokeAsDiscoveredCall<T>(definition: AutoTraceFunctionDefinition, inputs: unknown[], fn: () => T): T;
62
+ /**
63
+ * Call `receiver.systemOne(...args)` from a call site rewritten by the build
64
+ * transform. Beneath an automatic trace root the call is recorded as one `llm`
65
+ * span with Jev's model and token usage, and the client's own returned value
66
+ * is handed back unchanged. Outside a root it is a plain method call.
67
+ *
68
+ * This helper is internal transform/runtime protocol, not a supported
69
+ * application API.
70
+ *
71
+ * @experimental The automatic tracing protocol may change.
72
+ */
73
+ export declare function __bitfabAutoJev(receiver: unknown, ...args: unknown[]): unknown;
74
+ /**
75
+ * Call `receiver.create(...args)` from a `.chat.completions.create(...)` call
76
+ * site rewritten by the build transform. Beneath an automatic trace root, when
77
+ * the client's base URL is `openrouter.ai` and the request does not stream,
78
+ * the call is recorded as one `llm` span with the prompt, model, token usage,
79
+ * and the cost OpenRouter reports, and the client's own returned value is
80
+ * handed back unchanged. Otherwise it is a plain method call.
81
+ *
82
+ * This helper is internal transform/runtime protocol, not a supported
83
+ * application API.
84
+ *
85
+ * @experimental The automatic tracing protocol may change.
86
+ */
87
+ export declare function __bitfabAutoOpenRouter(receiver: unknown, ...args: unknown[]): unknown;
52
88
  /**
53
89
  * Preserve a function's original call arguments for transform cases where
54
90
  * parameter bindings discard them, such as destructured arrow parameters.
package/dist/autoTrace.js CHANGED
@@ -1 +1 @@
1
- export { t as __bitfabAutoSpan, n as __bitfabAutoTraceActive, r as __bitfabAutoWrap, i as _resetAutoTraceTransformDetection, a as clearAutoTraceNodeConfiguration, o as currentAutoTraceEntries, s as invokeThroughAutoTraceEntries, c as runAsAutoTraceRootFunction, l as runWithAutoTraceEntry, u as runWithAutoTraceNodeConfiguration, d as runWithAutoTraceRootContext } from "./autoTrace-O40k8f5M.js";
1
+ export { t as __bitfabAutoJev, n as __bitfabAutoOpenRouter, r as __bitfabAutoSpan, i as __bitfabAutoTraceActive, a as __bitfabAutoWrap, o as _resetAutoTraceTransformDetection, s as clearAutoTraceNodeConfiguration, c as currentAutoTraceEntries, l as invokeAsDiscoveredCall, u as invokeThroughAutoTraceEntries, d as runAsAutoTraceRootFunction, f as runWithAutoTraceEntry, p as runWithAutoTraceNodeConfiguration, m as runWithAutoTraceRootContext } from "./autoTrace-ghnojSj9.js";
@@ -44,6 +44,11 @@ function functionName(path, types) {
44
44
  const { line, column } = sourcePosition(path);
45
45
  return `anonymous-${line}-${column}`;
46
46
  }
47
+ const JEV_METHOD = "systemOne";
48
+ function isJevMethodDefinition(path, types) {
49
+ const parent = path.parentPath?.node;
50
+ return (types.isClassMethod(path.node) || types.isObjectMethod(path.node) || types.isObjectProperty(parent) || types.isClassProperty(parent)) && functionName(path, types) === JEV_METHOD;
51
+ }
47
52
  function isInstrumentableFunction(node, types) {
48
53
  if (node.generator || types.isClassPrivateMethod(node)) return false;
49
54
  return !(types.isClassMethod(node) || types.isObjectMethod(node)) || node.kind === "method";
@@ -146,6 +151,71 @@ function isRestWrapper(path, types) {
146
151
  const parameters = runtimeParameters(path.node, types);
147
152
  return parameters.length === 1 && types.isRestElement(parameters[0]);
148
153
  }
154
+ function isNamedMember(node, name, types) {
155
+ return (types.isMemberExpression(node) || types.isOptionalMemberExpression(node)) && !node.computed && types.isIdentifier(node.property, { name });
156
+ }
157
+ function isChatCompletionsReceiver(receiver, types) {
158
+ return isNamedMember(receiver, "completions", types) && isNamedMember(receiver.object, "chat", types);
159
+ }
160
+ const RECORDED_CLIENT_CALLS = [{
161
+ method: JEV_METHOD,
162
+ runtimeExport: "__bitfabAutoJev",
163
+ identifierHint: "bitfabAutoJev",
164
+ receiverHint: "bitfabJevReceiver",
165
+ matchesReceiver: () => true
166
+ }, {
167
+ method: "create",
168
+ runtimeExport: "__bitfabAutoOpenRouter",
169
+ identifierHint: "bitfabAutoOpenRouter",
170
+ receiverHint: "bitfabOpenRouterReceiver",
171
+ matchesReceiver: isChatCompletionsReceiver
172
+ }];
173
+ function recordedCallTarget(node, types) {
174
+ const callee = node.callee;
175
+ if (!(types.isMemberExpression(callee) || types.isOptionalMemberExpression(callee)) || callee.computed || !types.isIdentifier(callee.property) || types.isSuper(callee.object)) return null;
176
+ const method = callee.property.name;
177
+ const receiver = callee.object;
178
+ const call = RECORDED_CLIENT_CALLS.find((candidate) => candidate.method === method && candidate.matchesReceiver(receiver, types));
179
+ return call === void 0 ? null : {
180
+ call,
181
+ receiver
182
+ };
183
+ }
184
+ function isOptionalChain(node, types) {
185
+ return types.isOptionalMemberExpression(node) || types.isOptionalCallExpression(node);
186
+ }
187
+ function continuesOptionalChain(path, types) {
188
+ const parent = path.parent;
189
+ return types.isOptionalMemberExpression(parent) && parent.object === path.node || types.isOptionalCallExpression(parent) && parent.callee === path.node;
190
+ }
191
+ function rewriteRecordedClientCall(path, state, types) {
192
+ if (state.skipFile || state.bamlGenerated) return;
193
+ const node = path.node;
194
+ const target = recordedCallTarget(node, types);
195
+ const identifier = target === null ? void 0 : state.recordedCallIdentifiers?.get(target.call);
196
+ if (target === null || identifier === void 0) return;
197
+ const { call: recordedCall, receiver } = target;
198
+ const optionalReceiver = types.isOptionalMemberExpression(node.callee) && node.callee.optional;
199
+ const optionalMethod = types.isOptionalCallExpression(node) && node.optional;
200
+ if (types.isOptionalCallExpression(node)) {
201
+ if (continuesOptionalChain(path, types) || !optionalReceiver && isOptionalChain(receiver, types)) return;
202
+ }
203
+ const guarded = optionalReceiver || optionalMethod;
204
+ const receiverReference = guarded && !path.scope.isStatic(receiver) ? path.scope.generateDeclaredUidIdentifier(recordedCall.receiverHint) : null;
205
+ const receiverValue = () => receiverReference === null ? types.cloneNode(receiver) : types.cloneNode(receiverReference);
206
+ const call = types.callExpression(types.cloneNode(identifier), [receiverValue(), ...node.arguments]);
207
+ state.usedRuntime = true;
208
+ state.usedRecordedCalls?.add(recordedCall);
209
+ if (!guarded) {
210
+ path.replaceWith(call);
211
+ return;
212
+ }
213
+ const firstReceiver = receiverReference === null ? types.cloneNode(receiver) : types.assignmentExpression("=", types.cloneNode(receiverReference), receiver);
214
+ const missing = (value) => types.binaryExpression("==", value, types.nullLiteral());
215
+ const methodOf = (value) => types.memberExpression(value, types.identifier(recordedCall.method));
216
+ const test = optionalReceiver ? optionalMethod ? types.logicalExpression("||", missing(firstReceiver), missing(methodOf(receiverValue()))) : missing(firstReceiver) : missing(methodOf(firstReceiver));
217
+ path.replaceWith(types.conditionalExpression(test, types.unaryExpression("void", types.numericLiteral(0)), call));
218
+ }
149
219
  function bitfabBabelPlugin(api) {
150
220
  const { types } = api;
151
221
  return {
@@ -157,10 +227,12 @@ function bitfabBabelPlugin(api) {
157
227
  state.runtimeIdentifier = path.scope.generateUidIdentifier("bitfabAutoSpan");
158
228
  state.activeIdentifier = path.scope.generateUidIdentifier("bitfabAutoTraceActive");
159
229
  state.wrapperIdentifier = path.scope.generateUidIdentifier("bitfabAutoWrap");
230
+ state.recordedCallIdentifiers = new Map(RECORDED_CLIENT_CALLS.map((call) => [call, path.scope.generateUidIdentifier(call.identifierHint)]));
160
231
  state.bamlGenerated = isBamlGeneratedSource(state.file.code ?? "");
161
232
  state.definitions = [];
162
233
  state.usedRuntime = false;
163
234
  state.usedWrapper = false;
235
+ state.usedRecordedCalls = /* @__PURE__ */ new Set();
164
236
  },
165
237
  exit(path, state) {
166
238
  if (state.skipFile || !state.usedRuntime || !state.runtimeIdentifier || !state.activeIdentifier || !state.wrapperIdentifier) return;
@@ -169,7 +241,11 @@ function bitfabBabelPlugin(api) {
169
241
  types.importDeclaration([
170
242
  types.importSpecifier(state.runtimeIdentifier, types.identifier("__bitfabAutoSpan")),
171
243
  types.importSpecifier(state.activeIdentifier, types.identifier("__bitfabAutoTraceActive")),
172
- ...state.usedWrapper ? [types.importSpecifier(state.wrapperIdentifier, types.identifier("__bitfabAutoWrap"))] : []
244
+ ...state.usedWrapper ? [types.importSpecifier(state.wrapperIdentifier, types.identifier("__bitfabAutoWrap"))] : [],
245
+ ...RECORDED_CLIENT_CALLS.flatMap((call) => {
246
+ const identifier = state.recordedCallIdentifiers?.get(call);
247
+ return state.usedRecordedCalls?.has(call) && identifier ? [types.importSpecifier(identifier, types.identifier(call.runtimeExport))] : [];
248
+ })
173
249
  ], types.stringLiteral(state.opts.runtimeModule ?? "bitfab/auto")),
174
250
  types.variableDeclaration("const", [types.variableDeclarator(types.identifier(AUTO_TRACE_TRANSFORM_MARKER), types.assignmentExpression("=", types.memberExpression(types.identifier("globalThis"), types.identifier(AUTO_TRACE_TRANSFORM_MARKER)), types.booleanLiteral(true)))]),
175
251
  ...state.definitions ?? []
@@ -178,16 +254,24 @@ function bitfabBabelPlugin(api) {
178
254
  },
179
255
  CallExpression: { exit(path, state) {
180
256
  if (state.skipFile) return;
257
+ if (recordedCallTarget(path.node, types) !== null) {
258
+ rewriteRecordedClientCall(path, state, types);
259
+ return;
260
+ }
181
261
  const configuredName = withNodeFunctionName(path, types);
182
262
  if (configuredName === null) return;
183
263
  if (path.node.arguments.length === 1) path.node.arguments.push(types.identifier("undefined"));
184
264
  path.node.arguments.push(types.stringLiteral(configuredName));
185
265
  } },
266
+ OptionalCallExpression: { exit(path, state) {
267
+ rewriteRecordedClientCall(path, state, types);
268
+ } },
186
269
  Function: { exit(path, state) {
187
270
  const node = path.node;
188
271
  if (state.skipFile || node._bitfabInstrumented || !isInstrumentableFunction(node, types) || isTraceDecoratorRoot(path, types) || !state.runtimeIdentifier || !state.activeIdentifier || !state.wrapperIdentifier) return;
189
272
  const bamlMethod = state.bamlGenerated === true && isBamlClientMethod(path, types);
190
273
  if (state.bamlGenerated && !bamlMethod) return;
274
+ if (isJevMethodDefinition(path, types)) return;
191
275
  const name = qualifiedFunctionName(path, types);
192
276
  if (name.startsWith("anonymous-")) return;
193
277
  const normalizedFilename = autoTraceFilename(state.file.opts.filename ?? "unknown", state.opts.cwd ?? state.file.opts.cwd ?? process.cwd());
@@ -254,4 +338,4 @@ Object.defineProperty(exports, "sourceFilename", {
254
338
  }
255
339
  });
256
340
 
257
- //# sourceMappingURL=babelPlugin-ZR9ilYct.cjs.map
341
+ //# sourceMappingURL=babelPlugin-0uOq-j1Q.cjs.map