bitfab 0.11.4 → 0.11.6

package/dist/index.d.cts

@@ -171,6 +171,18 @@ interface TokenUsage {
     cached: number | null;
     total: number | null;
 }
+/**
+ * Describes a single file edited as part of a code change.
+ *
+ * - `path`: file path (relative to the repo root, or any consistent root)
+ * - `before`: file contents before the change ("" for newly created files)
+ * - `after`: file contents after the change ("" for deleted files)
+ */
+interface CodeChangeFile {
+    path: string;
+    before: string;
+    after: string;
+}
 
 /**
  * LangGraph/LangChain callback handler for Bitfab tracing.
@@ -253,6 +265,18 @@ interface ReplayOptions {
     traceIds?: string[];
     /** Maximum number of items to process in parallel. Set to 1 for sequential. Default 10. */
     maxConcurrency?: number;
+    /**
+     * Description of the code change being tested in this replay. Stored on
+     * the resulting experiment so the change can be reviewed alongside results.
+     */
+    codeChangeDescription?: string;
+    /**
+     * Files edited as part of this code change. Each entry holds the file path
+     * and the full `before`/`after` contents — the agent reads each file before
+     * and after editing and passes the two strings. Use `""` for newly created
+     * files (`before`) or deleted files (`after`).
+     */
+    codeChangeFiles?: CodeChangeFile[];
 }
 interface ReplayItem<T> {
     /** Deserialized inputs from the original trace. */
@@ -714,6 +738,8 @@ declare class Bitfab {
         limit?: number;
         traceIds?: string[];
         maxConcurrency?: number;
+        codeChangeDescription?: string;
+        codeChangeFiles?: CodeChangeFile[];
     }): Promise<ReplayResult<TReturn>>;
 }
 /**
@@ -777,7 +803,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.11.4";
+declare const __version__ = "0.11.6";
 
 /**
  * Constants for the Bitfab SDK.
@@ -787,4 +813,4 @@ declare const __version__ = "0.11.4";
  */
 declare const DEFAULT_SERVICE_URL = "https://bitfab.ai";
 
-export { type ActiveSpanContext, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type ProviderDefinition, type ReplayItem, type ReplayOptions, type ReplayResult, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type ProviderDefinition, type ReplayItem, type ReplayOptions, type ReplayResult, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };

package/dist/index.d.ts

@@ -171,6 +171,18 @@ interface TokenUsage {
     cached: number | null;
     total: number | null;
 }
+/**
+ * Describes a single file edited as part of a code change.
+ *
+ * - `path`: file path (relative to the repo root, or any consistent root)
+ * - `before`: file contents before the change ("" for newly created files)
+ * - `after`: file contents after the change ("" for deleted files)
+ */
+interface CodeChangeFile {
+    path: string;
+    before: string;
+    after: string;
+}
 
 /**
  * LangGraph/LangChain callback handler for Bitfab tracing.
@@ -253,6 +265,18 @@ interface ReplayOptions {
     traceIds?: string[];
     /** Maximum number of items to process in parallel. Set to 1 for sequential. Default 10. */
     maxConcurrency?: number;
+    /**
+     * Description of the code change being tested in this replay. Stored on
+     * the resulting experiment so the change can be reviewed alongside results.
+     */
+    codeChangeDescription?: string;
+    /**
+     * Files edited as part of this code change. Each entry holds the file path
+     * and the full `before`/`after` contents — the agent reads each file before
+     * and after editing and passes the two strings. Use `""` for newly created
+     * files (`before`) or deleted files (`after`).
+     */
+    codeChangeFiles?: CodeChangeFile[];
 }
 interface ReplayItem<T> {
     /** Deserialized inputs from the original trace. */
@@ -714,6 +738,8 @@ declare class Bitfab {
         limit?: number;
         traceIds?: string[];
         maxConcurrency?: number;
+        codeChangeDescription?: string;
+        codeChangeFiles?: CodeChangeFile[];
     }): Promise<ReplayResult<TReturn>>;
 }
 /**
@@ -777,7 +803,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.11.4";
+declare const __version__ = "0.11.6";
 
 /**
  * Constants for the Bitfab SDK.
@@ -787,4 +813,4 @@ declare const __version__ = "0.11.4";
  */
 declare const DEFAULT_SERVICE_URL = "https://bitfab.ai";
 
-export { type ActiveSpanContext, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type ProviderDefinition, type ReplayItem, type ReplayOptions, type ReplayResult, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler, BitfabOpenAITracingProcessor, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type ProviderDefinition, type ReplayItem, type ReplayOptions, type ReplayResult, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type WrapBAMLOptions, type WrappedBamlFn, __version__, flushTraces, getCurrentSpan, getCurrentTrace };

package/dist/index.js

@@ -6,13 +6,13 @@ import {
   BitfabOpenAITracingProcessor,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-I3OKZ2TF.js";
+} from "./chunk-MTHBHBOD.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
   __version__,
   flushTraces
-} from "./chunk-KAX2QQPS.js";
+} from "./chunk-VOSASRED.js";
 export {
   Bitfab,
   BitfabClaudeAgentHandler,

package/dist/node.cjs

@@ -81,7 +81,7 @@ var __version__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.11.4";
+    __version__ = "0.11.6";
   }
 });
 
@@ -285,11 +285,17 @@ var init_http = __esm({
        * Start a replay session by fetching historical traces.
        * Blocking call — creates a test run and returns lightweight item references.
        */
-      async startReplay(traceFunctionKey, limit, traceIds) {
+      async startReplay(traceFunctionKey, limit, traceIds, codeChangeDescription, codeChangeFiles) {
         const payload = { traceFunctionKey, limit };
         if (traceIds) {
           payload.traceIds = traceIds;
         }
+        if (codeChangeDescription !== void 0) {
+          payload.codeChangeDescription = codeChangeDescription;
+        }
+        if (codeChangeFiles !== void 0) {
+          payload.codeChangeFiles = codeChangeFiles;
+        }
         return this.request("/api/sdk/replay/start", payload, {
           timeout: 3e4
         });
@@ -434,7 +440,11 @@ async function processItem(httpClient, serverItem, fn, testRunId) {
   let error = null;
   try {
     const maybePromise = runWithReplayContext(
-      { testRunId, inputSourceSpanId: span.id },
+      {
+        testRunId,
+        inputSourceSpanId: span.id,
+        inputSourceTraceId: span.externalTraceId
+      },
       () => fn(...inputs)
     );
     result = maybePromise instanceof Promise ? await maybePromise : maybePromise;
@@ -476,7 +486,9 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
   } = await httpClient.startReplay(
     traceFunctionKey,
     options?.limit ?? 5,
-    options?.traceIds
+    options?.traceIds,
+    options?.codeChangeDescription,
+    options?.codeChangeFiles
   );
   const maxConcurrency = options?.maxConcurrency ?? 10;
   const tasks = serverItems.map(
@@ -2561,6 +2573,9 @@ var Bitfab = class {
           contexts: [],
           ...replayCtxAtRoot?.testRunId && {
             testRunId: replayCtxAtRoot.testRunId
+          },
+          ...replayCtxAtRoot?.inputSourceTraceId && {
+            inputSourceTraceId: replayCtxAtRoot.inputSourceTraceId
           }
         });
         pendingSpanPromises.set(traceId, []);
@@ -2609,7 +2624,8 @@ var Bitfab = class {
               sessionId: traceState?.sessionId,
               metadata: traceState?.metadata,
               contexts: traceState?.contexts ?? [],
-              testRunId: traceState?.testRunId
+              testRunId: traceState?.testRunId,
+              inputSourceTraceId: traceState?.inputSourceTraceId
             });
             activeTraceStates.delete(traceId);
           } else {
@@ -2686,6 +2702,9 @@ var Bitfab = class {
     if (params.contexts && params.contexts.length > 0) {
       rawTrace.contexts = params.contexts;
     }
+    if (params.inputSourceTraceId) {
+      rawTrace.input_source_trace_id = params.inputSourceTraceId;
+    }
     this.httpClient.sendExternalTrace({
       type: "sdk-function",
       source: "typescript-sdk-function",