bitfab 0.28.1 → 0.28.3

package/dist/index.cjs

@@ -360,7 +360,7 @@ function buildMockTree(rootNode) {
   function walk(node) {
     const key = node.traceFunctionKey;
     if (key) {
-      const name = node.spanName;
+      const name = node.spanName || key;
       const counterKey = `${key}:${name}`;
       const index = counters.get(counterKey) ?? 0;
       counters.set(counterKey, index + 1);
@@ -653,7 +653,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/version.generated.ts
-var __version__ = "0.28.1";
+var __version__ = "0.28.3";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -966,7 +966,7 @@ var HttpClient = class {
   }
   /**
    * Start a replay session by fetching historical traces.
-   * Blocking call — creates a test run and returns lightweight item references.
+   * Blocking call - creates a test run and returns lightweight item references.
    */
   async startReplay(traceFunctionKey, limit, traceIds, name, codeChangeDescription, codeChangeFiles, includeDbBranchLease, experimentGroupId, datasetId) {
     const payload = { traceFunctionKey };
@@ -1084,7 +1084,7 @@ var HttpClient = class {
   }
   /**
    * Ask the server to materialize a per-trace DB branch lease from a
-   * captured `dbSnapshotRef`. Blocking — the resolver creates a Neon
+   * captured `dbSnapshotRef`. Blocking - the resolver creates a Neon
    * snapshot + preview branch and polls operations to readiness, which
    * can take seconds.
    */
@@ -1224,7 +1224,7 @@ var BitfabClaudeAgentHandler = class {
     // Synthetic root span (handler-only replay). When an `input` is supplied to
     // wrapQuery/wrapResponse, the handler emits a root `agent` span carrying that
     // input, so a handler-instrumented run is replayable WITHOUT an enclosing
-    // withSpan — matching the LangGraph handler, which records the graph input as
+    // withSpan - matching the LangGraph handler, which records the graph input as
     // its root. The prompt is not present anywhere in the message stream, so it
     // must be handed in explicitly.
     this.hasRootInput = false;
@@ -1498,7 +1498,7 @@ var BitfabClaudeAgentHandler = class {
    * SDK's `wrapResponse` (which wraps `ClaudeSDKClient.receiveResponse()`);
    * in TypeScript, prefer `wrapQuery` around `query()`.
    *
-   * Pass `{ input }` (the prompt) to record a replayable root span — see
+   * Pass `{ input }` (the prompt) to record a replayable root span - see
    * `wrapQuery`.
    */
   async *wrapResponse(stream, opts) {
@@ -1511,8 +1511,8 @@ var BitfabClaudeAgentHandler = class {
    * Tool and subagent spans are captured separately via the hooks injected
    * by `instrumentOptions` into the `options` passed to `query()`.
    *
-   * Pass `{ input }` — the prompt (or the serializable args that produced it)
-   * — to make a handler-only run replayable: the handler records a root `agent`
+   * Pass `{ input }` - the prompt (or the serializable args that produced it)
+   * - to make a handler-only run replayable: the handler records a root `agent`
    * span with that input, so `replay(key, fn)` can re-feed it. Omit it only
    * when an enclosing `withSpan` already supplies the replayable root.
    *
@@ -2624,7 +2624,7 @@ var BitfabOpenAIAgentHandler = class {
    * argument, so `replay(key, fn)` re-feeds it), and the run's `finalOutput`
    * is recorded as the root output. For streaming runs (`{ stream: true }`),
    * the result is handed back immediately and the final output is recorded
-   * once the stream completes — first-byte latency is untouched.
+   * once the stream completes - first-byte latency is untouched.
    *
    * The process-wide tracing processor (`getOpenAiTracingProcessor`) must still
    * be registered: it captures the LLM/tool/handoff spans that nest beneath
@@ -2717,7 +2717,7 @@ var ReplayEnvironment = class {
   }
   /**
    * Record on the replay context that customer code obtained the branch
-   * URL. Only `databaseUrl` and `snapshot()` count — `active`, `readOnly`
+   * URL. Only `databaseUrl` and `snapshot()` count - `active`, `readOnly`
    * and friends inspect the lease without exposing the connection string,
    * so they don't prove the replayed code could have connected to the
    * branch.
@@ -3442,7 +3442,7 @@ var Bitfab = class {
     if (this.explicitlyEnabled && !this.apiKeyWarned) {
       this.apiKeyWarned = true;
       console.warn(
-        "Bitfab: apiKey is empty \u2014 tracing is disabled. Provide a valid API key to enable tracing."
+        "Bitfab: apiKey is empty - tracing is disabled. Provide a valid API key to enable tracing."
       );
     }
     return void 0;
@@ -3706,7 +3706,7 @@ var Bitfab = class {
    * Wrap a BAML client method to automatically capture prompt and LLM metadata.
    *
    * Creates a BAML Collector, calls the method through a tracked client,
-   * then extracts rendered messages and token usage — calling setPrompt()
+   * then extracts rendered messages and token usage - calling setPrompt()
    * and addContext() on the current span automatically.
    *
    * The BAML client can be provided in the constructor or passed explicitly:
@@ -4093,7 +4093,7 @@ var Bitfab = class {
    * Get a detached handle to a previously-created trace, looked up by the
    * caller-supplied id (the same id passed at trace creation).
    *
-   * The returned handle is not tied to AsyncLocalStorage — each method sends
+   * The returned handle is not tied to AsyncLocalStorage - each method sends
    * to the server immediately. Useful for adding context to a trace from a
    * different process or thread than the one that created it.
    *
@@ -4274,7 +4274,7 @@ var Bitfab = class {
    * plain callable: plain callables are wrapped internally so each replayed
    * invocation records a trace tied to the test run. The plain-callable form
    * is how handler-instrumented workflows (LangGraph/LangChain, Claude Agent
-   * SDK) replay — those record traces under a key with no `withSpan`-wrapped
+   * SDK) replay - those record traces under a key with no `withSpan`-wrapped
    * root in the app.
    *
    * @param traceFunctionKey - The trace function key to replay
@@ -4426,7 +4426,7 @@ var BitfabFunction = class {
     return this.client.getLangGraphCallbackHandler(this.traceFunctionKey);
   }
   /**
-   * Alias of {@link getLangGraphCallbackHandler} — LangChain and LangGraph
+   * Alias of {@link getLangGraphCallbackHandler} - LangChain and LangGraph
    * share one callback system, so the same bound handler serves both.
    *
    * @returns A LangChain callback handler for this client and key
@@ -4441,7 +4441,7 @@ var BitfabFunction = class {
    * Unlike the other methods on this handle, `wrapBAML` does NOT use the bound
    * key: it opens no span of its own. It enriches the *current* span (via
    * `getCurrentSpan().setPrompt()` / `addContext()`), so call it inside a
-   * function wrapped by this handle's `withSpan` — the bound key keys that
+   * function wrapped by this handle's `withSpan` - the bound key keys that
    * wrapper, and the BAML prompt/metadata attach to it.
    *
    * @param methodOrClient - Either a BAML method (uses constructor bamlClient) or the BAML client instance