@bitfab/sdk 0.58.3 → 0.58.5

package/dist/index.d.cts

@@ -3372,6 +3372,8 @@ declare class Bitfab {
      * Queued on the client's span transport; delivery is the transport's job.
      */
     private sendTraceCompletion;
+    private sendsSpanOnCompletion;
+    private nearestCapturedAncestorSpanIdOf;
     private contentOffBySimulationPlan;
     /**
      * Send a wrapper span from function execution.
@@ -3657,7 +3659,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.58.3";
+declare const __version__ = "0.58.5";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -3372,6 +3372,8 @@ declare class Bitfab {
      * Queued on the client's span transport; delivery is the transport's job.
      */
     private sendTraceCompletion;
+    private sendsSpanOnCompletion;
+    private nearestCapturedAncestorSpanIdOf;
     private contentOffBySimulationPlan;
     /**
      * Send a wrapper span from function execution.
@@ -3657,7 +3659,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.58.3";
+declare const __version__ = "0.58.5";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -22,8 +22,8 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-XBZO7PFX.js";
-import "./chunk-RCHSYWKI.js";
+} from "./chunk-Y47DQCCK.js";
+import "./chunk-ETZUSSF6.js";
 import {
   BITFAB_PROGRESS_PREFIX,
   DbBranchReplayError,
@@ -31,7 +31,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-KOWM65AV.js";
+} from "./chunk-YGZA3H67.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -39,8 +39,8 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-WVFMRMV4.js";
-import "./chunk-VCRFFCLY.js";
+} from "./chunk-IP2AYKT7.js";
+import "./chunk-BAOIRE5T.js";
 export {
   AssertionCategoriesClient,
   BITFAB_PROGRESS_PREFIX,

package/dist/node.cjs

@@ -88,7 +88,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.58.3";
+    __version__ = "0.58.5";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -5111,6 +5111,7 @@ init_asyncStorage();
 // src/autoTrace.ts
 init_asyncStorage();
 init_captureSuppression();
+init_warnOnce();
 var autoTraceGlobal = globalThis;
 var autoTraceState = autoTraceGlobal.__bitfabAutoTraceStateV4 ?? {
   storage: null,
@@ -5178,6 +5179,26 @@ function runWithAutoTraceNodeConfiguration(nodeConfiguration, fn) {
   }
   return result;
 }
+var SUBTREE_TRACING_DOCS_URL = "https://docs.bitfab.ai/typescript-sdk#experimental-subtree-tracing";
+function transformInstalled() {
+  return autoTraceGlobal.__bitfab_auto_trace_transformed_v1__ === true;
+}
+function runsOnNode() {
+  return typeof process !== "undefined" && Boolean(process.versions?.node);
+}
+function closeAutoTraceRoot() {
+  autoTraceState.activeRoots -= 1;
+}
+function settleAutoTraceRoot(context) {
+  closeAutoTraceRoot();
+  if (transformInstalled() || !runsOnNode()) {
+    return;
+  }
+  warnOnce(
+    "auto-trace-transform-missing",
+    `trace root "${context.traceFunctionKey}" recorded only its own span. No module in this build was compiled by @bitfab/transform, so calls beneath the root were not discovered. Install @bitfab/transform and add its adapter to the server build: ${SUBTREE_TRACING_DOCS_URL}`
+  );
+}
 function runWithAutoTraceRootContext(context, spanStack, fn) {
   autoTraceState.activeRoots += 1;
   const entries = [
@@ -5188,19 +5209,19 @@ function runWithAutoTraceRootContext(context, spanStack, fn) {
   try {
     result = runWithAutoTraceScope({ entries }, fn);
   } catch (error) {
-    autoTraceState.activeRoots -= 1;
+    settleAutoTraceRoot(context);
     throw error;
   }
   if (isAutoTraceAsyncGenerator(result)) {
-    autoTraceState.activeRoots -= 1;
+    closeAutoTraceRoot();
     return wrapAutoTraceAsyncGenerator(context, spanStack, result);
   }
   if (result instanceof Promise) {
     return result.finally(() => {
-      autoTraceState.activeRoots -= 1;
+      settleAutoTraceRoot(context);
     });
   }
-  autoTraceState.activeRoots -= 1;
+  settleAutoTraceRoot(context);
   return result;
 }
 function invokeThroughAutoTraceEntries(entries, step, fn) {
@@ -9823,13 +9844,23 @@ var Bitfab = class {
           traceFunctionKey
         );
         const openAiAgentsSpanIds = openAiAgentsSpanChain();
+        const functionNameAtOpen = fn.name !== "" ? fn.name : void 0;
         const newContext = {
           traceId,
           spanId,
           contexts: [],
+          spanName: options.name ?? options.nameFor?.(this) ?? qualifiedSpanName(this, functionNameAtOpen) ?? traceFunctionKey,
+          rootTraceFunctionKey: rootTraceFunctionKeyOfTrace(
+            traceId,
+            traceFunctionKey
+          ),
+          instrumentation: options.instrumentation ?? "span",
+          declaredNode: options.declaredNode === true,
+          isRoot: isRootSpan,
           ...surface !== void 0 && { surface },
           ...openAiAgentsSpanIds.length > 0 && { openAiAgentsSpanIds }
         };
+        const nearestCapturedAncestorSpanId = self.nearestCapturedAncestorSpanIdOf(currentStack);
         newStack = [...currentStack, newContext];
         const inputs = args;
         const startedAt = nowIsoTimestamp();
@@ -9856,19 +9887,16 @@ var Bitfab = class {
         }
         self.httpClient.traceCompletion.start(traceId, spanId);
         startedSpan = { traceId, spanId };
-        const functionName = fn.name !== "" ? fn.name : void 0;
-        const rootTraceFunctionKey = rootTraceFunctionKeyOfTrace(
-          traceId,
-          traceFunctionKey
-        );
+        const functionName = functionNameAtOpen;
         const baseSpanParams = {
           traceFunctionKey,
-          rootTraceFunctionKey,
+          rootTraceFunctionKey: newContext.rootTraceFunctionKey,
           functionName,
-          spanName: options.name ?? options.nameFor?.(this) ?? qualifiedSpanName(this, functionName) ?? traceFunctionKey,
+          spanName: newContext.spanName,
           traceId,
           spanId,
           parentSpanId,
+          nearestCapturedAncestorSpanId,
           inputs,
           startedAt,
           spanType: options.type ?? "custom",
@@ -10387,6 +10415,21 @@ var Bitfab = class {
       ...params.testRunId && { testRunId: params.testRunId }
     });
   }
+  sendsSpanOnCompletion(context) {
+    return context.isRoot || context.declaredNode || isFrameworkInstrumentation(context.instrumentation) || !this.simulationPlan.contentOffNow(
+      context.rootTraceFunctionKey,
+      context.spanName
+    );
+  }
+  nearestCapturedAncestorSpanIdOf(stack) {
+    for (let index = stack.length - 1; index >= 0; index -= 1) {
+      const candidate = stack[index];
+      if (candidate !== void 0 && this.sendsSpanOnCompletion(candidate)) {
+        return candidate.spanId;
+      }
+    }
+    return null;
+  }
   contentOffBySimulationPlan(params) {
     if (params.rootTraceFunctionKey === void 0 || isFrameworkInstrumentation(params.instrumentation)) {
       return false;
@@ -10463,6 +10506,9 @@ var Bitfab = class {
     if (params.parentSpanId) {
       externalSpan.parent_id = params.parentSpanId;
     }
+    if (params.nearestCapturedAncestorSpanId !== void 0 && params.nearestCapturedAncestorSpanId !== null && params.nearestCapturedAncestorSpanId !== params.parentSpanId) {
+      externalSpan.nearest_captured_ancestor_id = params.nearestCapturedAncestorSpanId;
+    }
     if (params.inputSourceSpanId) {
       externalSpan.input_source_span_id = params.inputSourceSpanId;
     }