@bitfab/sdk 0.26.1 → 0.27.0

package/dist/index.d.cts

@@ -579,9 +579,9 @@ declare class ReplayEnvironment {
  * Replay historical traces through a function and create a test run.
  *
  * The replay flow has three phases:
- * 1. Start — fetches historical traces from the server and creates a test run
- * 2. Execute — re-runs each trace's inputs through the provided function locally
- * 3. Complete — marks the test run as completed on the server
+ * 1. Start: fetches historical traces from the server and creates a test run
+ * 2. Execute: re-runs each trace's inputs through the provided function locally
+ * 3. Complete: marks the test run as completed on the server
  */
 
 type MockStrategy = "none" | "all" | "marked";
@@ -603,7 +603,7 @@ interface ReplayOptions {
     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 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`).
      */
@@ -675,7 +675,44 @@ interface ReplayProgress {
     succeeded: number;
     /** Of the completed items, how many threw (their `item.error` is set). */
     errored: number;
+    /**
+     * The single item that just settled to produce this event. `traceId` is the
+     * source (historical) trace that was replayed (so a UI can identify or link
+     * it); `error` is its replay error, or null when it ran ok; `durationMs` is how
+     * long this one trace took to replay. Lets a progress UI show per-trace
+     * pass/fail and timing as the run streams, without waiting for the full
+     * {@link ReplayResult}.
+     */
+    item?: {
+        traceId: string | null;
+        error: string | null;
+        durationMs: number | null;
+    };
 }
+/**
+ * Wire prefix the Bitfab plugin scans for. Each line {@link reportReplayProgress}
+ * writes is this prefix followed by the JSON of the running totals (plus the
+ * settled `item`). The plugin polls these lines to report live progress while a
+ * replay runs in the background; keep the SDK emitter and the plugin parser in
+ * sync.
+ */
+declare const BITFAB_PROGRESS_PREFIX = "@@bitfab:progress ";
+/**
+ * A ready-made {@link ReplayOptions.onProgress} callback for replay scripts.
+ * Pass it straight in:
+ *
+ * ```ts
+ * await bitfab.replay("my-fn", fn, { limit, onProgress: reportReplayProgress })
+ * ```
+ *
+ * It writes one `@@bitfab:progress` line per trace to stderr, which the Bitfab
+ * plugin polls to report live progress while the replay runs in the background,
+ * so scripts never hand-format the wire protocol.
+ * stdout is left untouched for the ReplayResult JSON. Outside Node (no
+ * `process.stderr`, e.g. a browser) it is a no-op, and a write failure is
+ * swallowed so progress can never crash a run.
+ */
+declare function reportReplayProgress(progress: ReplayProgress): void;
 /** Per-trace context passed to {@link ReplayOptions.adaptInputs}. */
 interface AdaptContext {
     /** Bitfab trace ID of the historical trace being replayed. */
@@ -1491,7 +1528,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.26.1";
+declare const __version__ = "0.27.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -1559,4 +1596,4 @@ declare const finalizers: {
     readableStream: typeof readableStream;
 };
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentSpan, getCurrentTrace, reportReplayProgress };

package/dist/index.d.ts

@@ -579,9 +579,9 @@ declare class ReplayEnvironment {
  * Replay historical traces through a function and create a test run.
  *
  * The replay flow has three phases:
- * 1. Start — fetches historical traces from the server and creates a test run
- * 2. Execute — re-runs each trace's inputs through the provided function locally
- * 3. Complete — marks the test run as completed on the server
+ * 1. Start: fetches historical traces from the server and creates a test run
+ * 2. Execute: re-runs each trace's inputs through the provided function locally
+ * 3. Complete: marks the test run as completed on the server
  */
 
 type MockStrategy = "none" | "all" | "marked";
@@ -603,7 +603,7 @@ interface ReplayOptions {
     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 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`).
      */
@@ -675,7 +675,44 @@ interface ReplayProgress {
     succeeded: number;
     /** Of the completed items, how many threw (their `item.error` is set). */
     errored: number;
+    /**
+     * The single item that just settled to produce this event. `traceId` is the
+     * source (historical) trace that was replayed (so a UI can identify or link
+     * it); `error` is its replay error, or null when it ran ok; `durationMs` is how
+     * long this one trace took to replay. Lets a progress UI show per-trace
+     * pass/fail and timing as the run streams, without waiting for the full
+     * {@link ReplayResult}.
+     */
+    item?: {
+        traceId: string | null;
+        error: string | null;
+        durationMs: number | null;
+    };
 }
+/**
+ * Wire prefix the Bitfab plugin scans for. Each line {@link reportReplayProgress}
+ * writes is this prefix followed by the JSON of the running totals (plus the
+ * settled `item`). The plugin polls these lines to report live progress while a
+ * replay runs in the background; keep the SDK emitter and the plugin parser in
+ * sync.
+ */
+declare const BITFAB_PROGRESS_PREFIX = "@@bitfab:progress ";
+/**
+ * A ready-made {@link ReplayOptions.onProgress} callback for replay scripts.
+ * Pass it straight in:
+ *
+ * ```ts
+ * await bitfab.replay("my-fn", fn, { limit, onProgress: reportReplayProgress })
+ * ```
+ *
+ * It writes one `@@bitfab:progress` line per trace to stderr, which the Bitfab
+ * plugin polls to report live progress while the replay runs in the background,
+ * so scripts never hand-format the wire protocol.
+ * stdout is left untouched for the ReplayResult JSON. Outside Node (no
+ * `process.stderr`, e.g. a browser) it is a no-op, and a write failure is
+ * swallowed so progress can never crash a run.
+ */
+declare function reportReplayProgress(progress: ReplayProgress): void;
 /** Per-trace context passed to {@link ReplayOptions.adaptInputs}. */
 interface AdaptContext {
     /** Bitfab trace ID of the historical trace being replayed. */
@@ -1491,7 +1528,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.26.1";
+declare const __version__ = "0.27.0";
 
 /**
  * Constants for the Bitfab SDK.
@@ -1559,4 +1596,4 @@ declare const finalizers: {
     readableStream: typeof readableStream;
 };
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentSpan, getCurrentTrace };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AllowedEnvVars, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabVercelAiHandler, type CodeChangeFile, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type MockStrategy, type ProviderDefinition, ReplayEnvironment, type ReplayEnvironmentSnapshot, type ReplayItem, type ReplayOptions, type ReplayProgress, type ReplayResult, SUPPORTED_PROVIDERS, type SpanOptions, type SpanType, type TokenUsage, type TraceResponse, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, finalizers, flushTraces, getCurrentSpan, getCurrentTrace, reportReplayProgress };

package/dist/index.js

@@ -14,11 +14,14 @@ import {
   flushTraces,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-SJFOTDP3.js";
+} from "./chunk-PFV4MPNS.js";
 import {
-  BitfabError
-} from "./chunk-26MUT4IP.js";
+  BITFAB_PROGRESS_PREFIX,
+  BitfabError,
+  reportReplayProgress
+} from "./chunk-RNTDM6WM.js";
 export {
+  BITFAB_PROGRESS_PREFIX,
   Bitfab,
   BitfabClaudeAgentHandler,
   BitfabError,
@@ -35,6 +38,7 @@ export {
   finalizers,
   flushTraces,
   getCurrentSpan,
-  getCurrentTrace
+  getCurrentTrace,
+  reportReplayProgress
 };
 //# sourceMappingURL=index.js.map

package/dist/node.cjs

@@ -110,35 +110,6 @@ var init_warnOnce = __esm({
   }
 });
 
-// src/randomUuid.ts
-function randomUuid() {
-  const globalCrypto = globalThis.crypto;
-  if (typeof globalCrypto?.randomUUID === "function") {
-    try {
-      return globalCrypto.randomUUID();
-    } catch {
-    }
-  }
-  warnOnce(
-    "crypto-unavailable",
-    "global crypto.randomUUID is unavailable; using a non-cryptographic fallback for trace/span ids. Tracing works normally (ids are correlation-only, not security-sensitive)."
-  );
-  return fallbackUuidV4();
-}
-function fallbackUuidV4() {
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (char) => {
-    const rand = Math.random() * 16 | 0;
-    const value = char === "x" ? rand : rand & 3 | 8;
-    return value.toString(16);
-  });
-}
-var init_randomUuid = __esm({
-  "src/randomUuid.ts"() {
-    "use strict";
-    init_warnOnce();
-  }
-});
-
 // src/serialize.ts
 function describeValue(value) {
   try {
@@ -194,7 +165,11 @@ function deserializeValue(serialized) {
   });
 }
 function toJsonSafe(value) {
-  const safe = toJsonSafeInner(value, 0, /* @__PURE__ */ new WeakSet());
+  return toJsonSafeReport(value).safe;
+}
+function toJsonSafeReport(value) {
+  const dropped = [];
+  const safe = toJsonSafeInner(value, 0, /* @__PURE__ */ new WeakSet(), dropped);
   try {
     const size = JSON.stringify(safe)?.length ?? 0;
     if (size > MAX_FRAMEWORK_SERIALIZED_BYTES) {
@@ -202,13 +177,16 @@ function toJsonSafe(value) {
         "toJsonSafe:too_large",
         `a framework payload exceeded ${MAX_FRAMEWORK_SERIALIZED_BYTES} bytes and was replaced with a placeholder so the span still ships. The captured state for this span is incomplete.`
       );
-      return `<unserializable: too_large_${size}_bytes>`;
+      return {
+        safe: `<unserializable: too_large_${size}_bytes>`,
+        dropped: [...dropped, `too_large_${size}_bytes`]
+      };
     }
   } catch {
   }
-  return safe;
+  return { safe, dropped };
 }
-function toJsonSafeInner(value, depth, seen) {
+function toJsonSafeInner(value, depth, seen, dropped) {
   if (value === null || value === void 0) {
     return value;
   }
@@ -217,30 +195,40 @@ function toJsonSafeInner(value, depth, seen) {
   }
   const className = value?.constructor?.name ?? typeof value;
   if (depth > MAX_SAFE_DEPTH) {
+    dropped.push(className);
     return `<${className}>`;
   }
   if (typeof value !== "object") {
+    if (typeof value === "function" || typeof value === "symbol") {
+      dropped.push(className);
+    }
     try {
       return String(value);
     } catch {
+      dropped.push(className);
       return `<${className}>`;
     }
   }
   if (seen.has(value)) {
+    dropped.push(className);
     return `<cycle ${className}>`;
   }
   seen.add(value);
   let result;
   if (Array.isArray(value)) {
-    result = value.map((item) => toJsonSafeInner(item, depth + 1, seen));
+    result = value.map(
+      (item) => toJsonSafeInner(item, depth + 1, seen, dropped)
+    );
   } else if (typeof value.toJSON === "function") {
     try {
       result = toJsonSafeInner(
         value.toJSON(),
         depth + 1,
-        seen
+        seen,
+        dropped
       );
     } catch {
+      dropped.push(className);
       result = `<${className}>`;
     }
   } else {
@@ -248,11 +236,12 @@ function toJsonSafeInner(value, depth, seen) {
       const obj = {};
       for (const [k, v] of Object.entries(value)) {
         if (!k.startsWith("_")) {
-          obj[k] = toJsonSafeInner(v, depth + 1, seen);
+          obj[k] = toJsonSafeInner(v, depth + 1, seen, dropped);
         }
       }
       result = obj;
     } catch {
+      dropped.push(className);
       result = `<${className}>`;
     }
   }
@@ -271,6 +260,35 @@ var init_serialize = __esm({
   }
 });
 
+// src/randomUuid.ts
+function randomUuid() {
+  const globalCrypto = globalThis.crypto;
+  if (typeof globalCrypto?.randomUUID === "function") {
+    try {
+      return globalCrypto.randomUUID();
+    } catch {
+    }
+  }
+  warnOnce(
+    "crypto-unavailable",
+    "global crypto.randomUUID is unavailable; using a non-cryptographic fallback for trace/span ids. Tracing works normally (ids are correlation-only, not security-sensitive)."
+  );
+  return fallbackUuidV4();
+}
+function fallbackUuidV4() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (char) => {
+    const rand = Math.random() * 16 | 0;
+    const value = char === "x" ? rand : rand & 3 | 8;
+    return value.toString(16);
+  });
+}
+var init_randomUuid = __esm({
+  "src/randomUuid.ts"() {
+    "use strict";
+    init_warnOnce();
+  }
+});
+
 // src/replayContext.ts
 function getReplayContext() {
   return replayContextStorage?.getStore() ?? null;
@@ -296,8 +314,21 @@ var init_replayContext = __esm({
 // src/replay.ts
 var replay_exports = {};
 __export(replay_exports, {
-  replay: () => replay
+  BITFAB_PROGRESS_PREFIX: () => BITFAB_PROGRESS_PREFIX,
+  replay: () => replay,
+  reportReplayProgress: () => reportReplayProgress
 });
+function reportReplayProgress(progress) {
+  const stderr = typeof process !== "undefined" ? process.stderr : void 0;
+  if (!stderr) {
+    return;
+  }
+  try {
+    stderr.write(`${BITFAB_PROGRESS_PREFIX}${JSON.stringify(progress)}
+`);
+  } catch {
+  }
+}
 function deserializeInputs(spanData) {
   const inputMeta = spanData.input_meta;
   const rawInput = spanData.input;
@@ -495,7 +526,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
   const resultItems = await mapWithConcurrency(
     tasks,
     maxConcurrency,
-    options?.onProgress ? (item) => {
+    options?.onProgress ? (item, index) => {
       completed += 1;
       if (item.error === null) {
         succeeded += 1;
@@ -503,7 +534,20 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
         errored += 1;
       }
       try {
-        options?.onProgress?.({ completed, total, succeeded, errored });
+        options?.onProgress?.({
+          completed,
+          total,
+          succeeded,
+          errored,
+          item: {
+            // Source (historical) trace id, so a UI can identify the trace
+            // that just settled. The item's own traceId is the new replay
+            // trace and is assigned later (below), so use the server item.
+            traceId: serverItems[index]?.traceId ?? null,
+            error: item.error,
+            durationMs: item.durationMs
+          }
+        });
       } catch {
       }
     } : void 0
@@ -560,6 +604,7 @@ async function replay(httpClient, serviceUrl, traceFunctionKey, fn, options) {
     testRunUrl: `${serviceUrl}${testRunUrl}`
   };
 }
+var BITFAB_PROGRESS_PREFIX;
 var init_replay = __esm({
   "src/replay.ts"() {
     "use strict";
@@ -567,12 +612,14 @@ var init_replay = __esm({
     init_randomUuid();
     init_replayContext();
     init_serialize();
+    BITFAB_PROGRESS_PREFIX = "@@bitfab:progress ";
   }
 });
 
 // src/node.ts
 var node_exports = {};
 __export(node_exports, {
+  BITFAB_PROGRESS_PREFIX: () => BITFAB_PROGRESS_PREFIX,
   Bitfab: () => Bitfab,
   BitfabClaudeAgentHandler: () => BitfabClaudeAgentHandler,
   BitfabError: () => BitfabError,
@@ -589,7 +636,8 @@ __export(node_exports, {
   finalizers: () => finalizers,
   flushTraces: () => flushTraces,
   getCurrentSpan: () => getCurrentSpan,
-  getCurrentTrace: () => getCurrentTrace
+  getCurrentTrace: () => getCurrentTrace,
+  reportReplayProgress: () => reportReplayProgress
 });
 module.exports = __toCommonJS(node_exports);
 
@@ -601,7 +649,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.26.1";
+var __version__ = "0.27.0";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -1043,6 +1091,62 @@ var HttpClient = class {
   }
 };
 
+// src/processorPayload.ts
+init_serialize();
+init_warnOnce();
+var SERIALIZATION_DEGRADED_STEP = "serialization_degraded";
+function degradedError(dropped) {
+  const names = [...new Set(dropped)].sort().join(", ");
+  return {
+    source: "sdk",
+    step: SERIALIZATION_DEGRADED_STEP,
+    error: `non-replayable: could not faithfully capture ${names}`
+  };
+}
+var ENVELOPE_FIELDS = [
+  "type",
+  "source",
+  "traceFunctionKey",
+  "sourceTraceId",
+  "completed"
+];
+function rebuildEnvelope(payload, bodyKey, placeholder) {
+  const rebuilt = {};
+  for (const k of ENVELOPE_FIELDS) {
+    if (k in payload) {
+      rebuilt[k] = payload[k];
+    }
+  }
+  rebuilt[bodyKey] = { serialized: placeholder };
+  return rebuilt;
+}
+function finalizeSpanPayload(payload, extraDropped) {
+  const { safe, dropped } = toJsonSafeReport(payload);
+  const allDropped = [...extraDropped ?? [], ...dropped];
+  const collapsed = safe === null || typeof safe !== "object" || Array.isArray(safe);
+  const result = collapsed ? rebuildEnvelope(payload, "rawSpan", safe) : safe;
+  if (allDropped.length > 0) {
+    const existing = result.errors;
+    const errors = Array.isArray(existing) ? existing : [];
+    errors.push(degradedError(allDropped));
+    result.errors = errors;
+  }
+  return result;
+}
+function finalizeTracePayload(payload) {
+  const { safe, dropped } = toJsonSafeReport(payload);
+  const collapsed = safe === null || typeof safe !== "object" || Array.isArray(safe);
+  const result = collapsed ? rebuildEnvelope(payload, "externalTrace", safe) : safe;
+  if (dropped.length > 0 || collapsed) {
+    const names = dropped.length > 0 ? [...new Set(dropped)].sort().join(", ") : "trace";
+    warnOnce(
+      `finalizeTrace:${names.replace(/\d+/g, "N")}`,
+      `a trace held non-serializable value(s) (${names}); they were captured as placeholders, so the trace may not be replayable.`
+    );
+  }
+  return result;
+}
+
 // src/claudeAgentSdk.ts
 init_randomUuid();
 init_serialize();
@@ -1172,6 +1276,7 @@ var BitfabClaudeAgentHandler = class {
   // ── span helpers ─────────────────────────────────────────────
   startSpan(spanId, name, spanType, inputData, parentId) {
     const traceId = this.ensureTrace();
+    const { safe: safeInput, dropped: inputDropped } = toJsonSafeReport(inputData);
     const spanInfo = {
       spanId,
       traceId,
@@ -1179,9 +1284,12 @@ var BitfabClaudeAgentHandler = class {
       startedAt: nowIso(),
       name,
       type: spanType,
-      input: safeSerialize(inputData),
+      input: safeInput,
       contexts: []
     };
+    if (inputDropped.length > 0) {
+      spanInfo.dropped = [...inputDropped];
+    }
     this.runToSpan.set(spanId, spanInfo);
     return spanInfo;
   }
@@ -1192,7 +1300,11 @@ var BitfabClaudeAgentHandler = class {
     }
     this.runToSpan.delete(spanId);
     spanInfo.endedAt = nowIso();
-    spanInfo.output = safeSerialize(output);
+    const { safe: safeOutput, dropped: outputDropped } = toJsonSafeReport(output);
+    spanInfo.output = safeOutput;
+    if (outputDropped.length > 0) {
+      spanInfo.dropped = [...spanInfo.dropped ?? [], ...outputDropped];
+    }
     if (error !== void 0) {
       spanInfo.error = error;
     }
@@ -1235,8 +1347,9 @@ var BitfabClaudeAgentHandler = class {
       sourceTraceId: spanInfo.traceId,
       rawSpan
     };
+    const finalized = finalizeSpanPayload(payload, spanInfo.dropped);
     try {
-      this.httpClient.sendExternalSpan(payload);
+      this.httpClient.sendExternalSpan(finalized);
     } catch {
     }
   }
@@ -1263,8 +1376,9 @@ var BitfabClaudeAgentHandler = class {
       externalTrace,
       completed
     };
+    const finalized = finalizeTracePayload(traceData);
     try {
-      this.httpClient.sendExternalTrace(traceData);
+      this.httpClient.sendExternalTrace(finalized);
     } catch {
     }
   }
@@ -1902,7 +2016,6 @@ var LANGGRAPH_METADATA_KEYS = [
 function nowIso2() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
-var safeSerialize2 = toJsonSafe;
 function convertMessage(message) {
   if (typeof message !== "object" || message === null) {
     return { role: "unknown", content: String(message) };
@@ -2147,6 +2260,7 @@ var BitfabLangGraphCallbackHandler = class {
     }
     const lgMetadata = extractLangGraphMetadata(metadata);
     const contexts = Object.keys(lgMetadata).length > 0 ? [lgMetadata] : [];
+    const { safe: safeInput, dropped: inputDropped } = toJsonSafeReport(inputData);
     const spanInfo = {
       spanId: runId,
       traceId: invocation.traceId,
@@ -2155,9 +2269,12 @@ var BitfabLangGraphCallbackHandler = class {
       startedAt: nowIso2(),
       name,
       type: spanType,
-      input: safeSerialize2(inputData),
+      input: safeInput,
       contexts
     };
+    if (inputDropped.length > 0) {
+      spanInfo.dropped = [...inputDropped];
+    }
     if (willHide) {
       spanInfo.hidden = true;
     }
@@ -2171,7 +2288,11 @@ var BitfabLangGraphCallbackHandler = class {
     }
     this.runToSpan.delete(runId);
     spanInfo.endedAt = nowIso2();
-    spanInfo.output = safeSerialize2(output);
+    const { safe: safeOutput, dropped: outputDropped } = toJsonSafeReport(output);
+    spanInfo.output = safeOutput;
+    if (outputDropped.length > 0) {
+      spanInfo.dropped = [...spanInfo.dropped ?? [], ...outputDropped];
+    }
     if (error !== void 0) {
       spanInfo.error = error;
     }
@@ -2222,8 +2343,9 @@ var BitfabLangGraphCallbackHandler = class {
       sourceTraceId: spanInfo.traceId,
       rawSpan
     };
+    const finalized = finalizeSpanPayload(payload, spanInfo.dropped);
     try {
-      this.httpClient.sendExternalSpan(payload);
+      this.httpClient.sendExternalSpan(finalized);
     } catch {
     }
   }
@@ -2241,8 +2363,9 @@ var BitfabLangGraphCallbackHandler = class {
       },
       completed
     };
+    const finalized = finalizeTracePayload(traceData);
     try {
-      this.httpClient.sendExternalTrace(traceData);
+      this.httpClient.sendExternalTrace(finalized);
     } catch {
     }
   }
@@ -2757,7 +2880,7 @@ var BitfabOpenAITracingProcessor = class {
     if (errors.length > 0) {
       payload.errors = errors;
     }
-    return payload;
+    return finalizeSpanPayload(payload);
   }
   /**
    * Send span to Bitfab API (fire-and-forget).
@@ -4268,11 +4391,15 @@ var finalizers = {
   readableStream
 };
 
+// src/index.ts
+init_replay();
+
 // src/node.ts
 init_asyncStorage();
 assertAsyncStorageRegistered();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BITFAB_PROGRESS_PREFIX,
   Bitfab,
   BitfabClaudeAgentHandler,
   BitfabError,
@@ -4289,6 +4416,7 @@ assertAsyncStorageRegistered();
   finalizers,
   flushTraces,
   getCurrentSpan,
-  getCurrentTrace
+  getCurrentTrace,
+  reportReplayProgress
 });
 //# sourceMappingURL=node.cjs.map