@bitfab/sdk 0.26.1 → 0.27.0

package/dist/{chunk-SJFOTDP3.js → chunk-PFV4MPNS.js}

@@ -8,11 +8,12 @@ import {
   randomUuid,
   serializeValue,
   toJsonSafe,
+  toJsonSafeReport,
   warnOnce
-} from "./chunk-26MUT4IP.js";
+} from "./chunk-RNTDM6WM.js";
 
 // src/version.generated.ts
-var __version__ = "0.26.1";
+var __version__ = "0.27.0";
 
 // src/constants.ts
 var DEFAULT_SERVICE_URL = "https://bitfab.ai";
@@ -450,6 +451,60 @@ var HttpClient = class {
   }
 };
 
+// src/processorPayload.ts
+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
 function nowIso() {
   return (/* @__PURE__ */ new Date()).toISOString();
@@ -577,6 +632,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,
@@ -584,9 +640,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;
   }
@@ -597,7 +656,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;
     }
@@ -640,8 +703,9 @@ var BitfabClaudeAgentHandler = class {
       sourceTraceId: spanInfo.traceId,
       rawSpan
     };
+    const finalized = finalizeSpanPayload(payload, spanInfo.dropped);
     try {
-      this.httpClient.sendExternalSpan(payload);
+      this.httpClient.sendExternalSpan(finalized);
     } catch {
     }
   }
@@ -668,8 +732,9 @@ var BitfabClaudeAgentHandler = class {
       externalTrace,
       completed
     };
+    const finalized = finalizeTracePayload(traceData);
     try {
-      this.httpClient.sendExternalTrace(traceData);
+      this.httpClient.sendExternalTrace(finalized);
     } catch {
     }
   }
@@ -1301,7 +1366,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) };
@@ -1546,6 +1610,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,
@@ -1554,9 +1619,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;
     }
@@ -1570,7 +1638,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;
     }
@@ -1621,8 +1693,9 @@ var BitfabLangGraphCallbackHandler = class {
       sourceTraceId: spanInfo.traceId,
       rawSpan
     };
+    const finalized = finalizeSpanPayload(payload, spanInfo.dropped);
     try {
-      this.httpClient.sendExternalSpan(payload);
+      this.httpClient.sendExternalSpan(finalized);
     } catch {
     }
   }
@@ -1640,8 +1713,9 @@ var BitfabLangGraphCallbackHandler = class {
       },
       completed
     };
+    const finalized = finalizeTracePayload(traceData);
     try {
-      this.httpClient.sendExternalTrace(traceData);
+      this.httpClient.sendExternalTrace(finalized);
     } catch {
     }
   }
@@ -2148,7 +2222,7 @@ var BitfabOpenAITracingProcessor = class {
     if (errors.length > 0) {
       payload.errors = errors;
     }
-    return payload;
+    return finalizeSpanPayload(payload);
   }
   /**
    * Send span to Bitfab API (fire-and-forget).
@@ -3450,7 +3524,7 @@ var Bitfab = class {
         `Function is wrapped with trace function key '${wrappedKey}' but replay was called with '${traceFunctionKey}'. Pass matching keys, or pass the unwrapped function to replay it under the explicit key.`
       );
     }
-    const { replay: doReplay } = await import("./replay-KYGI6LJY.js");
+    const { replay: doReplay } = await import("./replay-66KNEAMO.js");
     return doReplay(
       this.httpClient,
       this.serviceUrl,
@@ -3675,4 +3749,4 @@ export {
   BitfabFunction,
   finalizers
 };
-//# sourceMappingURL=chunk-SJFOTDP3.js.map
+//# sourceMappingURL=chunk-PFV4MPNS.js.map