bitfab 0.53.0 → 0.53.2

package/dist/index.d.cts

@@ -317,6 +317,16 @@ interface ReplayContext {
     dbSnapshotAccessed?: boolean;
 }
 
+interface SimulationPlanNode {
+    traceFunctionKey: string;
+    name: string;
+    captureContent: boolean;
+}
+interface SimulationPlanResponse {
+    nodes: SimulationPlanNode[];
+}
+type SimulationPlanSubmit = (payload: Record<string, unknown>) => void;
+
 /**
  * HTTP client utilities for Bitfab API requests.
  *
@@ -399,6 +409,10 @@ declare class HttpClient {
     private readonly deferredWork;
     private closed;
     private closing;
+    externalSpanTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
+    externalTraceTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
+    releaseHeldExternalSpans: ((timeoutMs: number) => Promise<void>) | undefined;
+    stopSimulationPlan: (() => void) | undefined;
     constructor(config: HttpClientConfig);
     /**
      * Resolve the API key at the moment it is needed (request time), invoking
@@ -511,25 +525,21 @@ declare class HttpClient {
      */
     lookupFunction<T>(name: string): Promise<T>;
     getAutoTracePolicy<T>(traceFunctionKey: string, protocol: string): Promise<T>;
+    getSimulationPlan(): Promise<SimulationPlanResponse>;
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
     /**
      * GET a JSON endpoint on the service with the client's API key. Throws a
      * `BitfabError` carrying the status text for any non-2xx response.
      */
-    get<T>(endpoint: string): Promise<T>;
+    get<T>(endpoint: string, timeoutMs?: number, extraHeaders?: Record<string, string>): Promise<T>;
     /**
      * Queue an internal trace (from local BAML execution via `call()`) onto this
      * client's batching transport. `functionId` moves into the payload because
      * the OTLP carrier has no path to carry it.
      */
     sendInternalTrace(functionId: string, payload: Record<string, unknown>): void;
-    /**
-     * Queue an external span (from withSpan wrapper or OpenAI tracing) onto this
-     * client's batching transport. Fire-and-forget: the transport owns delivery,
-     * so callers await `flushTraces()` or `close()` rather than a per-span
-     * promise.
-     */
     sendExternalSpan(payload: Record<string, unknown>): void;
+    submitExternalSpan(payload: Record<string, unknown>): void;
     /**
      * Queue an external trace completion (from OpenAI tracing) onto this
      * client's batching transport. Fire-and-forget for the same reason as
@@ -537,6 +547,7 @@ declare class HttpClient {
      * server-authoritative barrier in `replay.ts`, not by awaiting this call.
      */
     sendExternalTrace(rawPayload: Record<string, unknown>): void;
+    submitExternalTrace(payload: Record<string, unknown>): void;
     /**
      * Partial update of an existing trace identified by its Bitfab trace ID.
      * Used by the detached `client.getTrace(id)` handle.
@@ -1058,9 +1069,9 @@ declare class BitfabClaudeAgentHandler {
  * The span records the call parameters (the prompt/messages) as its input and a
  * serializable summary (`{ text, toolCalls, usage, finishReason }`) as its
  * output. Streaming is handled by passing the model's stream through a
- * transform that accumulates the assembled text/usage as the caller consumes
- * it: the live stream is handed back unchanged (first-byte latency untouched)
- * and the span is finalized once the stream completes.
+ * reader that accumulates text and usage as the caller consumes it. Parts,
+ * upstream errors, and cancellation propagate to the caller unchanged; the
+ * span finalizes on completion, error, or cancellation with partial output.
  *
  * The middleware is fully duck-typed (no static or dynamic `ai` import), so it
  * adds no dependency and is browser-safe. It works with `ai` v5 and v6.
@@ -1069,6 +1080,7 @@ type LlmSpanOptions = {
     type: "llm";
     finalize: (result: unknown) => unknown | Promise<unknown>;
     surface: "inherit";
+    instrumentation: "vercel-ai";
 };
 type WithSpanFn$1 = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: LlmSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 /**
@@ -1100,6 +1112,7 @@ interface VercelGenerateResult {
 /** Duck-typed subset of a single streaming part from `doStream`. */
 interface VercelStreamPart {
     type: string;
+    error?: unknown;
     delta?: string;
     textDelta?: string;
     toolCallId?: string;
@@ -1473,6 +1486,7 @@ interface SpanClient {
         mockOnReplay?: boolean;
         finalize?: (result: unknown) => unknown | Promise<unknown>;
         surface?: "inherit";
+        instrumentation?: "langgraph";
     }, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
 }
 interface LangGraphTool {
@@ -1580,6 +1594,7 @@ type RootSpanOptions = {
     type: "agent";
     finalize: (result: unknown) => unknown | Promise<unknown>;
     surface: "inherit";
+    instrumentation: "openai-agents";
 };
 type WithSpanFn = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: RootSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 type GetActiveSpanContextFn = () => unknown | null;
@@ -2522,6 +2537,7 @@ interface BitfabConfig {
      * a branch materialized from that point.
      */
     dbSnapshot?: DbSnapshotConfig;
+    simulationPlan?: boolean;
 }
 /**
  * Span types matching the backend enum.
@@ -2675,6 +2691,7 @@ declare class Bitfab {
     private readonly bamlClient;
     private readonly dbSnapshot;
     private readonly autoTracePolicyRefreshes;
+    private readonly simulationPlan;
     /**
      * Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
      * to every `replay` on this client (after any per-call `mockOverride`). In
@@ -2750,6 +2767,7 @@ declare class Bitfab {
     private resolveNodeConfiguration;
     private createAutoTraceNode;
     private createAutoTraceRoot;
+    private applySimulationPlan;
     private refreshAutoTraceCapturePolicy;
     /**
      * Flush and permanently close this client's tracing resources: its pending
@@ -3326,7 +3344,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.53.0";
+declare const __version__ = "0.53.2";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -317,6 +317,16 @@ interface ReplayContext {
     dbSnapshotAccessed?: boolean;
 }
 
+interface SimulationPlanNode {
+    traceFunctionKey: string;
+    name: string;
+    captureContent: boolean;
+}
+interface SimulationPlanResponse {
+    nodes: SimulationPlanNode[];
+}
+type SimulationPlanSubmit = (payload: Record<string, unknown>) => void;
+
 /**
  * HTTP client utilities for Bitfab API requests.
  *
@@ -399,6 +409,10 @@ declare class HttpClient {
     private readonly deferredWork;
     private closed;
     private closing;
+    externalSpanTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
+    externalTraceTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
+    releaseHeldExternalSpans: ((timeoutMs: number) => Promise<void>) | undefined;
+    stopSimulationPlan: (() => void) | undefined;
     constructor(config: HttpClientConfig);
     /**
      * Resolve the API key at the moment it is needed (request time), invoking
@@ -511,25 +525,21 @@ declare class HttpClient {
      */
     lookupFunction<T>(name: string): Promise<T>;
     getAutoTracePolicy<T>(traceFunctionKey: string, protocol: string): Promise<T>;
+    getSimulationPlan(): Promise<SimulationPlanResponse>;
     getTraceSpan(traceId: string, lookup: SpanLookup): Promise<CapturedSpan | null>;
     /**
      * GET a JSON endpoint on the service with the client's API key. Throws a
      * `BitfabError` carrying the status text for any non-2xx response.
      */
-    get<T>(endpoint: string): Promise<T>;
+    get<T>(endpoint: string, timeoutMs?: number, extraHeaders?: Record<string, string>): Promise<T>;
     /**
      * Queue an internal trace (from local BAML execution via `call()`) onto this
      * client's batching transport. `functionId` moves into the payload because
      * the OTLP carrier has no path to carry it.
      */
     sendInternalTrace(functionId: string, payload: Record<string, unknown>): void;
-    /**
-     * Queue an external span (from withSpan wrapper or OpenAI tracing) onto this
-     * client's batching transport. Fire-and-forget: the transport owns delivery,
-     * so callers await `flushTraces()` or `close()` rather than a per-span
-     * promise.
-     */
     sendExternalSpan(payload: Record<string, unknown>): void;
+    submitExternalSpan(payload: Record<string, unknown>): void;
     /**
      * Queue an external trace completion (from OpenAI tracing) onto this
      * client's batching transport. Fire-and-forget for the same reason as
@@ -537,6 +547,7 @@ declare class HttpClient {
      * server-authoritative barrier in `replay.ts`, not by awaiting this call.
      */
     sendExternalTrace(rawPayload: Record<string, unknown>): void;
+    submitExternalTrace(payload: Record<string, unknown>): void;
     /**
      * Partial update of an existing trace identified by its Bitfab trace ID.
      * Used by the detached `client.getTrace(id)` handle.
@@ -1058,9 +1069,9 @@ declare class BitfabClaudeAgentHandler {
  * The span records the call parameters (the prompt/messages) as its input and a
  * serializable summary (`{ text, toolCalls, usage, finishReason }`) as its
  * output. Streaming is handled by passing the model's stream through a
- * transform that accumulates the assembled text/usage as the caller consumes
- * it: the live stream is handed back unchanged (first-byte latency untouched)
- * and the span is finalized once the stream completes.
+ * reader that accumulates text and usage as the caller consumes it. Parts,
+ * upstream errors, and cancellation propagate to the caller unchanged; the
+ * span finalizes on completion, error, or cancellation with partial output.
  *
  * The middleware is fully duck-typed (no static or dynamic `ai` import), so it
  * adds no dependency and is browser-safe. It works with `ai` v5 and v6.
@@ -1069,6 +1080,7 @@ type LlmSpanOptions = {
     type: "llm";
     finalize: (result: unknown) => unknown | Promise<unknown>;
     surface: "inherit";
+    instrumentation: "vercel-ai";
 };
 type WithSpanFn$1 = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: LlmSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 /**
@@ -1100,6 +1112,7 @@ interface VercelGenerateResult {
 /** Duck-typed subset of a single streaming part from `doStream`. */
 interface VercelStreamPart {
     type: string;
+    error?: unknown;
     delta?: string;
     textDelta?: string;
     toolCallId?: string;
@@ -1473,6 +1486,7 @@ interface SpanClient {
         mockOnReplay?: boolean;
         finalize?: (result: unknown) => unknown | Promise<unknown>;
         surface?: "inherit";
+        instrumentation?: "langgraph";
     }, fn: (...args: TArgs) => TReturn): (...args: TArgs) => TReturn;
 }
 interface LangGraphTool {
@@ -1580,6 +1594,7 @@ type RootSpanOptions = {
     type: "agent";
     finalize: (result: unknown) => unknown | Promise<unknown>;
     surface: "inherit";
+    instrumentation: "openai-agents";
 };
 type WithSpanFn = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: RootSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 type GetActiveSpanContextFn = () => unknown | null;
@@ -2522,6 +2537,7 @@ interface BitfabConfig {
      * a branch materialized from that point.
      */
     dbSnapshot?: DbSnapshotConfig;
+    simulationPlan?: boolean;
 }
 /**
  * Span types matching the backend enum.
@@ -2675,6 +2691,7 @@ declare class Bitfab {
     private readonly bamlClient;
     private readonly dbSnapshot;
     private readonly autoTracePolicyRefreshes;
+    private readonly simulationPlan;
     /**
      * Mock overrides registered via {@link Bitfab.registerMockOverride}, applied
      * to every `replay` on this client (after any per-call `mockOverride`). In
@@ -2750,6 +2767,7 @@ declare class Bitfab {
     private resolveNodeConfiguration;
     private createAutoTraceNode;
     private createAutoTraceRoot;
+    private applySimulationPlan;
     private refreshAutoTraceCapturePolicy;
     /**
      * Flush and permanently close this client's tracing resources: its pending
@@ -3326,7 +3344,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.53.0";
+declare const __version__ = "0.53.2";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-SCXR43UF.js";
+} from "./chunk-6SPWEVFD.js";
 import "./chunk-E5BLYL5X.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -37,7 +37,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-SJKWUQ3G.js";
+} from "./chunk-V3KD7B3B.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -45,7 +45,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-6IMGAODW.js";
+} from "./chunk-JZAKQDGR.js";
 import "./chunk-H6LZRFMN.js";
 export {
   BITFAB_PROGRESS_PREFIX,