@bitfab/sdk 0.23.3 → 0.24.1

package/dist/index.d.cts

@@ -1,5 +1,3 @@
-import { Agent, AgentInputItem, RunState, NonStreamRunOptions, RunResult, StreamRunOptions, StreamedRunResult } from '@openai/agents';
-
 /**
  * BAML execution utilities for the Bitfab TypeScript SDK.
  * This module provides functions to execute BAML prompts dynamically on the client side.
@@ -457,14 +455,21 @@ declare class BitfabLangGraphCallbackHandler {
  * Use both together: register the processor once at startup, then call
  * `handler.wrapRun(agent, input)` instead of `run(agent, input)`.
  */
-
+type AgentLike = any;
+type RunInput = string | unknown[] | Record<string, unknown>;
+type RunOptions = {
+    stream?: boolean;
+} & Record<string, unknown>;
+type RunResultLike = {
+    finalOutput?: unknown;
+    completed?: Promise<void>;
+};
 type RootSpanOptions = {
     type: "agent";
     finalize: (result: unknown) => unknown | Promise<unknown>;
 };
 type WithSpanFn = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: RootSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 type GetActiveSpanContextFn = () => unknown | null;
-type RunInput<TContext, TAgent extends Agent<any, any>> = string | AgentInputItem[] | RunState<TContext, TAgent>;
 /**
  * OpenAI Agents SDK handler that records a replayable root span around a run.
  *
@@ -506,8 +511,7 @@ declare class BitfabOpenAIAgentHandler {
      * be registered: it captures the LLM/tool/handoff spans that nest beneath
      * this root.
      */
-    wrapRun<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: RunInput<TContext, TAgent>, options?: NonStreamRunOptions<TContext>): Promise<RunResult<TContext, TAgent>>;
-    wrapRun<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: RunInput<TContext, TAgent>, options: StreamRunOptions<TContext>): Promise<StreamedRunResult<TContext, TAgent>>;
+    wrapRun(agent: AgentLike, input: RunInput, options?: RunOptions): Promise<RunResultLike>;
 }
 
 /**
@@ -680,7 +684,13 @@ interface ReplayItem<T> {
     error: string | null;
     /** Original trace duration in milliseconds, or null if timestamps are missing. */
     durationMs: number | null;
-    /** Token usage from the original trace, or null if not captured. */
+    /**
+     * Token usage from the REPLAYED run (this item's new execution), aggregated
+     * server-side from the spans it produced, or null if the run captured no
+     * token data. This is the "new" side of a token delta: compare it against
+     * the original trace's recorded usage to see how the code change moved cost.
+     * Matches what Studio's experiments view shows.
+     */
     tokens: TokenUsage | null;
     /** Model name from the original trace, or null if not captured. */
     model: string | null;
@@ -1370,7 +1380,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.23.3";
+declare const __version__ = "0.24.1";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import { Agent, AgentInputItem, RunState, NonStreamRunOptions, RunResult, StreamRunOptions, StreamedRunResult } from '@openai/agents';
-
 /**
  * BAML execution utilities for the Bitfab TypeScript SDK.
  * This module provides functions to execute BAML prompts dynamically on the client side.
@@ -457,14 +455,21 @@ declare class BitfabLangGraphCallbackHandler {
  * Use both together: register the processor once at startup, then call
  * `handler.wrapRun(agent, input)` instead of `run(agent, input)`.
  */
-
+type AgentLike = any;
+type RunInput = string | unknown[] | Record<string, unknown>;
+type RunOptions = {
+    stream?: boolean;
+} & Record<string, unknown>;
+type RunResultLike = {
+    finalOutput?: unknown;
+    completed?: Promise<void>;
+};
 type RootSpanOptions = {
     type: "agent";
     finalize: (result: unknown) => unknown | Promise<unknown>;
 };
 type WithSpanFn = <TArgs extends unknown[], TReturn>(traceFunctionKey: string, options: RootSpanOptions, fn: (...args: TArgs) => TReturn) => (...args: TArgs) => TReturn;
 type GetActiveSpanContextFn = () => unknown | null;
-type RunInput<TContext, TAgent extends Agent<any, any>> = string | AgentInputItem[] | RunState<TContext, TAgent>;
 /**
  * OpenAI Agents SDK handler that records a replayable root span around a run.
  *
@@ -506,8 +511,7 @@ declare class BitfabOpenAIAgentHandler {
      * be registered: it captures the LLM/tool/handoff spans that nest beneath
      * this root.
      */
-    wrapRun<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: RunInput<TContext, TAgent>, options?: NonStreamRunOptions<TContext>): Promise<RunResult<TContext, TAgent>>;
-    wrapRun<TAgent extends Agent<any, any>, TContext = undefined>(agent: TAgent, input: RunInput<TContext, TAgent>, options: StreamRunOptions<TContext>): Promise<StreamedRunResult<TContext, TAgent>>;
+    wrapRun(agent: AgentLike, input: RunInput, options?: RunOptions): Promise<RunResultLike>;
 }
 
 /**
@@ -680,7 +684,13 @@ interface ReplayItem<T> {
     error: string | null;
     /** Original trace duration in milliseconds, or null if timestamps are missing. */
     durationMs: number | null;
-    /** Token usage from the original trace, or null if not captured. */
+    /**
+     * Token usage from the REPLAYED run (this item's new execution), aggregated
+     * server-side from the spans it produced, or null if the run captured no
+     * token data. This is the "new" side of a token delta: compare it against
+     * the original trace's recorded usage to see how the code change moved cost.
+     * Matches what Studio's experiments view shows.
+     */
     tokens: TokenUsage | null;
     /** Model name from the original trace, or null if not captured. */
     model: string | null;
@@ -1370,7 +1380,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.23.3";
+declare const __version__ = "0.24.1";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -14,10 +14,10 @@ import {
   flushTraces,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-CG6LVLBK.js";
+} from "./chunk-J4D6PRM4.js";
 import {
   BitfabError
-} from "./chunk-EQI6ZJC3.js";
+} from "./chunk-26MUT4IP.js";
 export {
   Bitfab,
   BitfabClaudeAgentHandler,