@bitfab/sdk 0.26.0 → 0.26.2

package/dist/index.d.cts

@@ -1491,7 +1491,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.26.0";
+declare const __version__ = "0.26.2";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -1491,7 +1491,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.26.0";
+declare const __version__ = "0.26.2";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

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

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;
@@ -601,7 +619,7 @@ registerAsyncLocalStorageClass(
 );
 
 // src/version.generated.ts
-var __version__ = "0.26.0";
+var __version__ = "0.26.2";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -1043,6 +1061,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 +1246,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 +1254,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 +1270,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 +1317,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 +1346,9 @@ var BitfabClaudeAgentHandler = class {
       externalTrace,
       completed
     };
+    const finalized = finalizeTracePayload(traceData);
     try {
-      this.httpClient.sendExternalTrace(traceData);
+      this.httpClient.sendExternalTrace(finalized);
     } catch {
     }
   }
@@ -1902,7 +1986,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 +2230,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 +2239,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 +2258,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 +2313,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 +2333,9 @@ var BitfabLangGraphCallbackHandler = class {
       },
       completed
     };
+    const finalized = finalizeTracePayload(traceData);
     try {
-      this.httpClient.sendExternalTrace(traceData);
+      this.httpClient.sendExternalTrace(finalized);
     } catch {
     }
   }
@@ -2757,7 +2850,7 @@ var BitfabOpenAITracingProcessor = class {
     if (errors.length > 0) {
       payload.errors = errors;
     }
-    return payload;
+    return finalizeSpanPayload(payload);
   }
   /**
    * Send span to Bitfab API (fire-and-forget).