bitfab 0.52.5 → 0.53.0

package/dist/{chunk-3QXNM62Y.js → chunk-DTC6SIXW.js}

@@ -1,6 +1,6 @@
 import {
   BitfabError
-} from "./chunk-3D7FNJ5R.js";
+} from "./chunk-CBRO6BP7.js";
 
 // src/codeChange.ts
 var NUL = String.fromCharCode(0);
@@ -207,7 +207,7 @@ async function seedFromRegistry(registry, pipeline, cases, options = {}) {
       sessionId: seedCase.sessionId
     })
   );
-  const { flushTraces: flushTraces2 } = await import("./http-UQT6QVBC.js");
+  const { flushTraces: flushTraces2 } = await import("./http-KP7DVTOD.js");
   await flushTraces2(3e4);
   return { pipeline, traceFunctionKey, traceIds };
 }
@@ -744,4 +744,4 @@ export {
   runRegistryMain,
   runIfEntrypoint
 };
-//# sourceMappingURL=chunk-3QXNM62Y.js.map
+//# sourceMappingURL=chunk-DTC6SIXW.js.map

package/dist/{chunk-ZUD7OFYB.js → chunk-E5BLYL5X.js}

@@ -4,19 +4,18 @@ import {
 
 // src/autoTrace.ts
 var autoTraceGlobal = globalThis;
-var autoTraceState = autoTraceGlobal.__bitfabAutoTraceStateV3 ?? {
+var autoTraceState = autoTraceGlobal.__bitfabAutoTraceStateV4 ?? {
   storage: null,
   browserScope: void 0,
   capturePolicies: /* @__PURE__ */ new WeakMap(),
   activeRoots: 0
 };
-autoTraceGlobal.__bitfabAutoTraceStateV3 = autoTraceState;
+autoTraceGlobal.__bitfabAutoTraceStateV4 = autoTraceState;
 function initializeAutoTraceStorage() {
   autoTraceState.storage ?? (autoTraceState.storage = createAsyncLocalStorage());
 }
-function runWithAutoTraceContext(context, fn, depth = 0) {
+function runWithAutoTraceScope(scope, fn) {
   initializeAutoTraceStorage();
-  const scope = { context, depth };
   if (autoTraceState.storage) {
     return autoTraceState.storage.run(scope, fn);
   }
@@ -28,41 +27,65 @@ function runWithAutoTraceContext(context, fn, depth = 0) {
     autoTraceState.browserScope = previous;
   }
 }
+function currentAutoTraceEntries() {
+  return currentAutoTraceScope()?.entries ?? [];
+}
+function replaceEntry(entries, previous, updated) {
+  return entries.map((entry) => entry === previous ? updated : entry);
+}
+function runWithAutoTraceEntry(previous, updated, fn) {
+  const result = runWithAutoTraceScope(
+    { entries: replaceEntry(currentAutoTraceEntries(), previous, updated) },
+    fn
+  );
+  if (isAutoTraceAsyncGenerator(result)) {
+    return wrapAutoTraceEntryAsyncGenerator(previous, updated, result);
+  }
+  return result;
+}
+function wrapAutoTraceEntryAsyncGenerator(previous, updated, source) {
+  const step = (method, value) => runWithAutoTraceScope(
+    { entries: replaceEntry(currentAutoTraceEntries(), previous, updated) },
+    () => source[method](value)
+  );
+  const wrapped = {
+    next: (value) => step("next", value),
+    return: (value) => step("return", value),
+    throw: (error) => step("throw", error),
+    [Symbol.asyncIterator]: () => wrapped
+  };
+  return wrapped;
+}
+function clearAutoTraceNodeConfiguration(fn) {
+  return runWithAutoTraceScope({ entries: currentAutoTraceEntries() }, fn);
+}
 function runWithAutoTraceNodeConfiguration(nodeConfiguration, fn) {
   const scope = currentAutoTraceScope();
-  if (!scope) {
+  if (!scope || scope.entries.length === 0) {
     return fn();
   }
-  const configuredScope = { ...scope, nodeConfiguration };
-  let result;
-  if (autoTraceState.storage) {
-    result = autoTraceState.storage.run(configuredScope, fn);
-  } else {
-    const previous = autoTraceState.browserScope;
-    autoTraceState.browserScope = configuredScope;
-    try {
-      result = fn();
-    } finally {
-      autoTraceState.browserScope = previous;
-    }
-  }
+  const result = runWithAutoTraceScope({ ...scope, nodeConfiguration }, fn);
   if (isAutoTraceAsyncGenerator(result)) {
     return wrapAutoTraceNodeAsyncGenerator(nodeConfiguration, result);
   }
   return result;
 }
-function runWithAutoTraceRootContext(context, fn) {
+function runWithAutoTraceRootContext(context, spanStack, fn) {
   autoTraceState.activeRoots += 1;
+  const entries = [
+    ...currentAutoTraceEntries(),
+    { context, depth: 0, spanStack }
+  ];
   let result;
   try {
-    result = runWithAutoTraceContext(context, fn);
+    result = runWithAutoTraceScope({ entries }, fn);
   } catch (error) {
     autoTraceState.activeRoots -= 1;
     throw error;
   }
   if (isAutoTraceAsyncGenerator(result)) {
     autoTraceState.activeRoots -= 1;
-    return wrapAutoTraceAsyncGenerator(context, result);
+    return wrapAutoTraceAsyncGenerator(context, spanStack, result);
   }
   if (result instanceof Promise) {
     return result.finally(() => {
@@ -72,6 +95,15 @@ function runWithAutoTraceRootContext(context, fn) {
   autoTraceState.activeRoots -= 1;
   return result;
 }
+function invokeThroughAutoTraceEntries(entries, step, fn) {
+  let run = fn;
+  for (let index = entries.length - 1; index >= 0; index -= 1) {
+    const entry = entries[index];
+    const next = run;
+    run = () => step(entry, next);
+  }
+  return run();
+}
 function isAutoTraceAsyncGenerator(value) {
   if (value === null || typeof value !== "object") {
     return false;
@@ -79,8 +111,8 @@ function isAutoTraceAsyncGenerator(value) {
   const candidate = value;
   return typeof candidate.next === "function" && typeof candidate.return === "function" && typeof candidate.throw === "function" && typeof candidate[Symbol.asyncIterator] === "function";
 }
-function wrapAutoTraceAsyncGenerator(context, source) {
-  const step = (method, value) => runWithAutoTraceRootContext(context, () => source[method](value));
+function wrapAutoTraceAsyncGenerator(context, spanStack, source) {
+  const step = (method, value) => runWithAutoTraceRootContext(context, spanStack, () => source[method](value));
   const wrapped = {
     next: (value) => step("next", value),
     return: (value) => step("return", value),
@@ -102,20 +134,32 @@ function wrapAutoTraceNodeAsyncGenerator(nodeConfiguration, source) {
   };
   return wrapped;
 }
+function shareFinalize(configuration) {
+  const finalize = configuration.finalize;
+  if (finalize === void 0) {
+    return configuration;
+  }
+  let settled;
+  return {
+    ...configuration,
+    finalize: (result) => {
+      settled ?? (settled = Promise.resolve().then(() => finalize(result)));
+      return settled;
+    }
+  };
+}
 function __bitfabAutoSpan(definition, inputs, fn) {
   const scope = currentAutoTraceScope();
-  if (!scope) {
+  if (!scope || scope.entries.length === 0) {
     return fn();
   }
   const nameParts = definition.name.split(".");
   const simpleName = nameParts[nameParts.length - 1];
-  const nodeConfiguration = simpleName === scope.nodeConfiguration?.functionName ? scope.nodeConfiguration : void 0;
-  return scope.context.invoke(
-    definition,
-    inputs,
-    fn,
-    scope.depth,
-    nodeConfiguration
+  const nodeConfiguration = simpleName === scope.nodeConfiguration?.functionName ? shareFinalize(scope.nodeConfiguration) : void 0;
+  return invokeThroughAutoTraceEntries(
+    scope.entries,
+    (entry, next) => entry.context.invoke(definition, inputs, next, entry, nodeConfiguration),
+    fn
   );
 }
 function __bitfabAutoWrap(definition, fn) {
@@ -147,7 +191,7 @@ function __bitfabAutoTraceActive() {
   if (autoTraceState.activeRoots === 0) {
     return false;
   }
-  return currentAutoTraceScope() !== void 0;
+  return currentAutoTraceEntries().length > 0;
 }
 function currentAutoTraceScope() {
   initializeAutoTraceStorage();
@@ -170,13 +214,16 @@ function getAutoTraceCapturePolicy(client, traceFunctionKey) {
 }
 
 export {
-  runWithAutoTraceContext,
+  currentAutoTraceEntries,
+  runWithAutoTraceEntry,
+  clearAutoTraceNodeConfiguration,
   runWithAutoTraceNodeConfiguration,
   runWithAutoTraceRootContext,
+  invokeThroughAutoTraceEntries,
   __bitfabAutoSpan,
   __bitfabAutoWrap,
   __bitfabAutoTraceActive,
   __setBitfabAutoTraceCapturePolicy,
   getAutoTraceCapturePolicy
 };
-//# sourceMappingURL=chunk-ZUD7OFYB.js.map
+//# sourceMappingURL=chunk-E5BLYL5X.js.map

package/dist/chunk-E5BLYL5X.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/autoTrace.ts"],"sourcesContent":["import {\n  type AsyncLocalStorageLike,\n  createAsyncLocalStorage,\n} from \"./asyncStorage.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}\n\nexport interface AutoTraceNodeConfiguration {\n  functionName: string\n  name?: string\n  type?: \"llm\" | \"agent\" | \"function\" | \"guardrail\" | \"handoff\" | \"custom\"\n  capture: boolean\n  testRunId?: string\n  mockOnReplay?: 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 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    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  ): T\n}\n\ninterface AutoTraceScope {\n  entries: readonly AutoTraceEntry[]\n  nodeConfiguration?: AutoTraceNodeConfiguration\n}\n\ninterface AutoTraceState {\n  storage: AsyncLocalStorageLike<AutoTraceScope> | null\n  browserScope: AutoTraceScope | undefined\n  capturePolicies: WeakMap<object, Map<string, ReadonlySet<string>>>\n  activeRoots: number\n}\n\ninterface AutoTraceGlobal {\n  __bitfabAutoTraceStateV4?: AutoTraceState\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 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  let result: T\n  try {\n    result = runWithAutoTraceScope({ entries }, fn)\n  } catch (error) {\n    autoTraceState.activeRoots -= 1\n    throw error\n  }\n\n  if (isAutoTraceAsyncGenerator(result)) {\n    autoTraceState.activeRoots -= 1\n    return wrapAutoTraceAsyncGenerator(context, spanStack, result) as T\n  }\n\n  if (result instanceof Promise) {\n    return result.finally(() => {\n      autoTraceState.activeRoots -= 1\n    }) as T\n  }\n\n  autoTraceState.activeRoots -= 1\n  return result\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  const scope = currentAutoTraceScope()\n  if (!scope || scope.entries.length === 0) {\n    return fn()\n  }\n  const nameParts = definition.name.split(\".\")\n  const simpleName = nameParts[nameParts.length - 1]\n  const nodeConfiguration =\n    simpleName === scope.nodeConfiguration?.functionName\n      ? shareFinalize(scope.nodeConfiguration)\n      : undefined\n  return invokeThroughAutoTraceEntries(\n    scope.entries,\n    (entry, next) =>\n      entry.context.invoke(definition, inputs, next, entry, nodeConfiguration),\n    fn,\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  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) {\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 __setBitfabAutoTraceCapturePolicy(\n  client: object,\n  traceFunctionKey: string,\n  functionIds: Iterable<string> | undefined,\n): void {\n  const policies = autoTraceState.capturePolicies.get(client) ?? new Map()\n  if (functionIds === undefined) {\n    policies.delete(traceFunctionKey)\n    if (policies.size === 0) {\n      autoTraceState.capturePolicies.delete(client)\n    }\n    return\n  }\n  policies.set(traceFunctionKey, new Set(functionIds))\n  autoTraceState.capturePolicies.set(client, policies)\n}\n\nexport function getAutoTraceCapturePolicy(\n  client: object,\n  traceFunctionKey: string,\n): ReadonlySet<string> | undefined {\n  return autoTraceState.capturePolicies.get(client)?.get(traceFunctionKey)\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-EMRHO6YW.js → chunk-SCXR43UF.js}

@@ -1,11 +1,14 @@
 import {
   __bitfabAutoTraceActive,
   __setBitfabAutoTraceCapturePolicy,
+  clearAutoTraceNodeConfiguration,
+  currentAutoTraceEntries,
   getAutoTraceCapturePolicy,
-  runWithAutoTraceContext,
+  invokeThroughAutoTraceEntries,
+  runWithAutoTraceEntry,
   runWithAutoTraceNodeConfiguration,
   runWithAutoTraceRootContext
-} from "./chunk-ZUD7OFYB.js";
+} from "./chunk-E5BLYL5X.js";
 import {
   NO_MOCK_OVERRIDE,
   deserializeInputs,
@@ -16,7 +19,7 @@ import {
   serializeValue,
   toJsonSafe,
   toJsonSafeReport
-} from "./chunk-6DRFQJ75.js";
+} from "./chunk-SJKWUQ3G.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -28,7 +31,7 @@ import {
   recordCallerTraceMetadata,
   retireTraceMetadata,
   warnOnce
-} from "./chunk-CAE7HE4C.js";
+} from "./chunk-6IMGAODW.js";
 import {
   __privateAdd,
   __privateGet,
@@ -3174,6 +3177,26 @@ var DEFAULT_AUTO_TRACE_MAX_SPANS = 500;
 var AUTO_TRACE_PROTOCOL = "ts-auto-v1";
 var AUTO_TRACE_POLICY_REFRESH_MS = 6e4;
 var AUTO_TRACE_POLICY_RETRY_MS = 1e4;
+function spanOwnerName(receiver) {
+  if (typeof receiver === "function") {
+    return receiver.name !== "" ? receiver.name : void 0;
+  }
+  if (typeof receiver !== "object" || receiver === null) {
+    return void 0;
+  }
+  const owner = receiver.constructor;
+  if (typeof owner !== "function" || owner === Object || owner.name === "") {
+    return void 0;
+  }
+  return owner.name;
+}
+function qualifiedSpanName(receiver, functionName) {
+  if (functionName === void 0) {
+    return void 0;
+  }
+  const owner = spanOwnerName(receiver);
+  return owner === void 0 ? functionName : `${owner}.${functionName}`;
+}
 function autoTraceLimit(value, fallback) {
   return value !== void 0 && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
 }
@@ -3376,16 +3399,21 @@ var Bitfab = class {
     );
     const excluded = new Set(options.exclude ?? []);
     const includeWrappers = options.includeWrappers ?? false;
+    const rootNameFor = (receiver) => options.name ?? (fn.name !== "" ? qualifiedSpanName(receiver, name) ?? name : name);
     const rootOptions = {
-      name: options.name ?? name,
+      name: options.name,
+      nameFor: rootNameFor,
       type: options.type ?? "custom",
       surface: "opt-out"
     };
-    const tracedRoot = this.withSpan(
+    const buildTracedRoot = (spanOptions) => this.withSpan(
       traceFunctionKey,
-      rootOptions,
+      spanOptions,
       function(...args) {
-        const capturePolicy = getAutoTraceCapturePolicy(self, traceFunctionKey);
+        const capturePolicy = getAutoTraceCapturePolicy(
+          self,
+          traceFunctionKey
+        );
         self.refreshAutoTraceCapturePolicy(traceFunctionKey);
         let spansUsed = 0;
         let truncated = false;
@@ -3406,19 +3434,54 @@ var Bitfab = class {
             `"${traceFunctionKey}" hit an automatic subtree capture limit (maxDepth=${maxDepth}, maxSpans=${maxSpans}); its trace is incomplete. Raise the limits or narrow the subtree with exclude.`
           );
         };
+        const spanStackOf = (entry) => entry.spanStack;
+        const openChild = (entry, childOptions, inputs, isAsync, invokeFn) => {
+          const runInside = () => runWithAutoTraceEntry(
+            entry,
+            {
+              context: autoTraceContext,
+              depth: entry.depth + 1,
+              spanStack: getSpanStack()
+            },
+            invokeFn
+          );
+          return runWithSpanStack(spanStackOf(entry), () => {
+            if (isAsync) {
+              const tracedAsyncChild = self.withSpan(
+                traceFunctionKey,
+                childOptions,
+                async (..._inputs) => await runInside()
+              );
+              return tracedAsyncChild(...inputs);
+            }
+            const tracedChild = self.withSpan(
+              traceFunctionKey,
+              childOptions,
+              (..._inputs) => runInside()
+            );
+            return tracedChild(...inputs);
+          });
+        };
+        const overBudget = (entry) => {
+          if (entry.depth < maxDepth && spansUsed < maxSpans) {
+            return false;
+          }
+          runWithSpanStack(spanStackOf(entry), warnTruncated);
+          return true;
+        };
         const autoTraceContext = {
-          invoke(definition, inputs, invokeFn, depth, nodeConfiguration) {
+          traceFunctionKey,
+          invoke(definition, inputs, invokeFn, entry, nodeConfiguration) {
             const nameParts = definition.name.split(".");
             const simpleName = nameParts[nameParts.length - 1];
-            const invokeWithoutNode = () => nodeConfiguration === void 0 ? invokeFn() : runWithAutoTraceContext(autoTraceContext, invokeFn, depth);
+            const invokeWithoutNode = () => nodeConfiguration === void 0 ? invokeFn() : clearAutoTraceNodeConfiguration(invokeFn);
             if (excluded.has(definition.name) || simpleName !== void 0 && excluded.has(simpleName) || nodeConfiguration === void 0 && definition.wrapper === true && !includeWrappers) {
               return invokeWithoutNode();
             }
             if (nodeConfiguration?.capture === false) {
-              return runWithAutoTraceContext(autoTraceContext, invokeFn, depth);
+              return clearAutoTraceNodeConfiguration(invokeFn);
             }
-            if (depth >= maxDepth || spansUsed >= maxSpans) {
-              warnTruncated();
+            if (overBudget(entry)) {
               return invokeWithoutNode();
             }
             spansUsed += 1;
@@ -3441,34 +3504,82 @@ var Bitfab = class {
                 finalize: nodeConfiguration.finalize
               }
             };
-            const invokeWithAutoTraceContext = () => runWithAutoTraceContext(autoTraceContext, invokeFn, depth + 1);
-            if (definition.async === true) {
-              const tracedAsyncChild = self.withSpan(
-                traceFunctionKey,
-                childOptions,
-                async (..._inputs) => await invokeWithAutoTraceContext()
-              );
-              return tracedAsyncChild(...inputs);
-            }
-            const tracedChild = self.withSpan(
-              traceFunctionKey,
+            return openChild(
+              entry,
               childOptions,
-              (..._inputs) => invokeWithAutoTraceContext()
+              inputs,
+              definition.async === true,
+              invokeFn
             );
-            return tracedChild(...inputs);
+          },
+          invokeNestedRoot(nestedName, nestedFunctionName, inputs, invokeFn, entry, link) {
+            if (excluded.has(nestedName) || excluded.has(nestedFunctionName) || overBudget(entry)) {
+              return invokeFn();
+            }
+            spansUsed += 1;
+            const childOptions = {
+              name: nestedName,
+              type: "function",
+              captureWhen: "nested",
+              surface: "opt-out",
+              captureContent: true,
+              ...link !== void 0 && { nestedTrace: link }
+            };
+            return openChild(entry, childOptions, inputs, false, invokeFn);
           }
         };
         return runWithAutoTraceRootContext(
           autoTraceContext,
+          getSpanStack(),
           () => fn.apply(this, args)
         );
       }
     );
+    const tracedRoot = buildTracedRoot(rootOptions);
     const autoTraceRoot = function(...args) {
       if (!self.shouldRecord()) {
         return fn.apply(this, args);
       }
-      return tracedRoot.apply(this, args);
+      const enclosing = currentAutoTraceEntries();
+      if (enclosing.length === 0) {
+        return tracedRoot.apply(this, args);
+      }
+      const link = getReplayContext() || inSeedScope() ? void 0 : { traceFunctionKey };
+      const rootName = rootNameFor(this);
+      return invokeThroughAutoTraceEntries(
+        enclosing,
+        (entry, next) => entry.context.invokeNestedRoot(
+          rootName,
+          name,
+          args,
+          next,
+          entry,
+          link
+        ),
+        () => {
+          if (link === void 0) {
+            return fn.apply(this, args);
+          }
+          const innermost = enclosing[enclosing.length - 1];
+          const innermostNow = currentAutoTraceEntries().find(
+            (entry) => entry.context === innermost.context
+          ) ?? innermost;
+          const innermostStack = innermostNow.spanStack;
+          const copy = innermostStack[innermostStack.length - 1];
+          const detachedRoot = buildTracedRoot({
+            ...rootOptions,
+            ...copy !== void 0 && {
+              enclosingTrace: {
+                traceId: copy.traceId,
+                spanId: copy.spanId,
+                traceFunctionKey: innermost.context.traceFunctionKey,
+                link
+              }
+            }
+          });
+          return runWithSpanStack([], () => detachedRoot.apply(this, args));
+        }
+      );
     };
     Object.defineProperty(autoTraceRoot, "_bitfabTraceFunctionKey", {
       value: traceFunctionKey
@@ -4057,6 +4168,10 @@ var Bitfab = class {
         const spanId = randomUuid();
         const parentSpanId = parentContext?.spanId ?? null;
         const isRootSpan = parentSpanId === null;
+        if (options.enclosingTrace !== void 0) {
+          options.enclosingTrace.link.traceId = traceId;
+          options.enclosingTrace.link.rootSpanId = spanId;
+        }
         const requestedSurface = options.surface ?? DEFAULT_SURFACE;
         const surface = resolveSurface(requestedSurface, parentContext?.surface);
         assertSurfacesCompatible(
@@ -4097,7 +4212,7 @@ var Bitfab = class {
         const baseSpanParams = {
           traceFunctionKey,
           functionName,
-          spanName: options.name ?? functionName ?? traceFunctionKey,
+          spanName: options.name ?? options.nameFor?.(this) ?? qualifiedSpanName(this, functionName) ?? traceFunctionKey,
           traceId,
           spanId,
           parentSpanId,
@@ -4106,7 +4221,9 @@ var Bitfab = class {
           spanType: options.type ?? "custom",
           functionId: options.functionId,
           captureContent: options.captureContent ?? true,
-          autoTraceDefinition: options.autoTraceDefinition
+          autoTraceDefinition: options.autoTraceDefinition,
+          nestedTrace: options.nestedTrace,
+          enclosingTrace: options.enclosingTrace
         };
         const sendSpan = async (params) => {
           const replayCtx = getReplayContext();
@@ -4616,6 +4733,16 @@ var Bitfab = class {
           function_line: params.autoTraceDefinition.line,
           function_column: params.autoTraceDefinition.column
         },
+        ...params.nestedTrace?.traceId !== void 0 && {
+          nested_trace_id: params.nestedTrace.traceId,
+          nested_trace_function_key: params.nestedTrace.traceFunctionKey,
+          nested_root_span_id: params.nestedTrace.rootSpanId
+        },
+        ...params.enclosingTrace !== void 0 && {
+          enclosing_trace_id: params.enclosingTrace.traceId,
+          enclosing_trace_function_key: params.enclosingTrace.traceFunctionKey,
+          enclosing_span_id: params.enclosingTrace.spanId
+        },
         ...serializedInputs !== void 0 && {
           input: serializedInputs.json,
           ...serializedInputs.meta !== void 0 && {
@@ -4797,7 +4924,7 @@ var Bitfab = class {
       await runWithSeedContext({ traceId }, async () => target(...args));
     } finally {
       try {
-        const { flushTraces: flushTraces2 } = await import("./http-Q6UEKZRF.js");
+        const { flushTraces: flushTraces2 } = await import("./http-SEN3PUXX.js");
         await flushTraces2(3e4);
       } finally {
         unrecorded = activeTraceStates.delete(traceId);
@@ -4856,7 +4983,7 @@ var Bitfab = class {
         `Function is wrapped with trace function key '${wrappedKey}' but replay was called with '${traceFunctionKey}'. Pass matching keys, or pass the unwrapped function to replay it under the explicit key.`
       );
     }
-    const { replay: doReplay } = await import("./replay-UVSZFZW7.js");
+    const { replay: doReplay } = await import("./replay-Y5RIJOWE.js");
     return doReplay(
       this.httpClient,
       this.serviceUrl,
@@ -5140,7 +5267,7 @@ async function seedFromRegistry(registry, pipeline, cases, options = {}) {
       sessionId: seedCase.sessionId
     })
   );
-  const { flushTraces: flushTraces2 } = await import("./http-Q6UEKZRF.js");
+  const { flushTraces: flushTraces2 } = await import("./http-SEN3PUXX.js");
   await flushTraces2(3e4);
   return { pipeline, traceFunctionKey, traceIds };
 }
@@ -5177,4 +5304,4 @@ export {
   reseedFromRegistry,
   seedFromRegistry
 };
-//# sourceMappingURL=chunk-EMRHO6YW.js.map
+//# sourceMappingURL=chunk-SCXR43UF.js.map