@bitfab/sdk 0.13.6 → 0.13.8

package/dist/index.d.cts

@@ -151,14 +151,8 @@ declare class BitfabClaudeAgentHandler {
  * `DbSnapshotRef` that pins the DB state at trace open by wall-clock
  * timestamp. The Bitfab service uses that timestamp at replay time to
  * materialize an ephemeral branch from `customer-main`.
- *
- * v0 is timestamp-only. LSN-based pinning is intentionally not exposed
- * yet — the customer-LSN to replica-LSN mapping isn't built, so the
- * mapping primitive would have no resolver to consume it. The
- * `DbSnapshotRef.ref` field is reserved for that future use.
  */
-/** Providers the SDK accepts for `dbSnapshot.provider`. Server-side resolver dispatches on this. */
-declare const SUPPORTED_PROVIDERS: readonly ["neon", "ardent", "dolt", "gfs", "mongodb-atlas", "dynamodb", "snowflake", "bigquery"];
+declare const SUPPORTED_PROVIDERS: readonly ["neon"];
 type DbSnapshotProvider = (typeof SUPPORTED_PROVIDERS)[number];
 interface DbSnapshotConfig {
     /** Discriminator for the server-side resolver. */
@@ -168,18 +162,11 @@ interface DbSnapshotRef {
     provider: DbSnapshotProvider;
     /**
      * The wall-clock ISO timestamp the SDK observed immediately before
-     * invoking the wrapped function. This is the moment used as the
-     * "snapshot pin" by the timestamp-based resolver path. The name encodes
-     * its provenance: SDK-observed, wall clock (not monotonic), captured
-     * before user code began executing — distinct from server-side or
-     * DB-side timestamps recorded elsewhere on the trace.
+     * invoking the wrapped function. The name encodes its provenance:
+     * SDK-observed, wall clock (not monotonic), captured before user code
+     * began executing.
      */
     sdkWallClockBeforeFn: string;
-    /**
-     * Reserved for future provider-specific opaque payload (e.g. customer
-     * LSN once a source-to-replica mapping exists). Unused in v0.
-     */
-    ref?: Record<string, unknown>;
 }
 
 /**
@@ -317,7 +304,6 @@ interface ReplayEnvironmentSnapshot {
     providerConsoleUrl?: string;
     readOnly?: boolean;
     traceId: string;
-    precision: "timestamp" | "lsn";
 }
 declare class ReplayEnvironment {
     /**
@@ -337,12 +323,6 @@ declare class ReplayEnvironment {
     get readOnly(): boolean | undefined;
     /** The historical trace ID that produced the input for this replay item. */
     get traceId(): string;
-    /**
-     * How the resolver pinned this branch.
-     * - "timestamp": snapshot at SDK wall clock; bounded by replication lag.
-     * - "lsn": customer LSN mapped to a replica snapshot (future).
-     */
-    get precision(): "timestamp" | "lsn";
     /** True when read inside a replay item that has a resolved branch. */
     get active(): boolean;
     /** Non-throwing variant for callers that handle the inactive case. */
@@ -1010,7 +990,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.13.6";
+declare const __version__ = "0.13.8";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.d.ts

@@ -151,14 +151,8 @@ declare class BitfabClaudeAgentHandler {
  * `DbSnapshotRef` that pins the DB state at trace open by wall-clock
  * timestamp. The Bitfab service uses that timestamp at replay time to
  * materialize an ephemeral branch from `customer-main`.
- *
- * v0 is timestamp-only. LSN-based pinning is intentionally not exposed
- * yet — the customer-LSN to replica-LSN mapping isn't built, so the
- * mapping primitive would have no resolver to consume it. The
- * `DbSnapshotRef.ref` field is reserved for that future use.
  */
-/** Providers the SDK accepts for `dbSnapshot.provider`. Server-side resolver dispatches on this. */
-declare const SUPPORTED_PROVIDERS: readonly ["neon", "ardent", "dolt", "gfs", "mongodb-atlas", "dynamodb", "snowflake", "bigquery"];
+declare const SUPPORTED_PROVIDERS: readonly ["neon"];
 type DbSnapshotProvider = (typeof SUPPORTED_PROVIDERS)[number];
 interface DbSnapshotConfig {
     /** Discriminator for the server-side resolver. */
@@ -168,18 +162,11 @@ interface DbSnapshotRef {
     provider: DbSnapshotProvider;
     /**
      * The wall-clock ISO timestamp the SDK observed immediately before
-     * invoking the wrapped function. This is the moment used as the
-     * "snapshot pin" by the timestamp-based resolver path. The name encodes
-     * its provenance: SDK-observed, wall clock (not monotonic), captured
-     * before user code began executing — distinct from server-side or
-     * DB-side timestamps recorded elsewhere on the trace.
+     * invoking the wrapped function. The name encodes its provenance:
+     * SDK-observed, wall clock (not monotonic), captured before user code
+     * began executing.
      */
     sdkWallClockBeforeFn: string;
-    /**
-     * Reserved for future provider-specific opaque payload (e.g. customer
-     * LSN once a source-to-replica mapping exists). Unused in v0.
-     */
-    ref?: Record<string, unknown>;
 }
 
 /**
@@ -317,7 +304,6 @@ interface ReplayEnvironmentSnapshot {
     providerConsoleUrl?: string;
     readOnly?: boolean;
     traceId: string;
-    precision: "timestamp" | "lsn";
 }
 declare class ReplayEnvironment {
     /**
@@ -337,12 +323,6 @@ declare class ReplayEnvironment {
     get readOnly(): boolean | undefined;
     /** The historical trace ID that produced the input for this replay item. */
     get traceId(): string;
-    /**
-     * How the resolver pinned this branch.
-     * - "timestamp": snapshot at SDK wall clock; bounded by replication lag.
-     * - "lsn": customer LSN mapped to a replica snapshot (future).
-     */
-    get precision(): "timestamp" | "lsn";
     /** True when read inside a replay item that has a resolved branch. */
     get active(): boolean;
     /** Non-throwing variant for callers that handle the inactive case. */
@@ -1010,7 +990,7 @@ declare class BitfabFunction {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.13.6";
+declare const __version__ = "0.13.8";
 
 /**
  * Constants for the Bitfab SDK.

package/dist/index.js

@@ -8,13 +8,13 @@ import {
   SUPPORTED_PROVIDERS,
   getCurrentSpan,
   getCurrentTrace
-} from "./chunk-6757PVPS.js";
+} from "./chunk-4ANYHNQJ.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
   __version__,
   flushTraces
-} from "./chunk-TMSVIA5J.js";
+} from "./chunk-VFGUZWAV.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.13.6";
+    __version__ = "0.13.8";
   }
 });
 
@@ -188,7 +188,9 @@ var init_http = __esm({
               )
             ),
             rawSpan: {},
-            errors: [{ step: "json_serialize", error: serializationError }]
+            errors: [
+              { source: "sdk", step: "json_serialize", error: serializationError }
+            ]
           });
         }
         try {
@@ -430,11 +432,11 @@ var init_http = __esm({
           { timeout: 9e4 }
         );
       }
-      /** Release a previously-resolved DB branch lease. Idempotent server-side. */
-      async releaseDbBranchLease(leaseId) {
+      /** Release a previously-resolved DB branch by deleting its Neon branch. Idempotent server-side. */
+      async releaseDbBranchLease(neonBranchId) {
         await this.request(
           "/api/sdk/replay/releaseDbBranchLease",
-          { leaseId },
+          { neonBranchId },
           { timeout: 3e4 }
         );
       }
@@ -615,11 +617,11 @@ async function processItem(httpClient, serverItem, fn, testRunId, mockStrategy,
   } finally {
     if (lease) {
       try {
-        await httpClient.releaseDbBranchLease(lease.leaseId);
+        await httpClient.releaseDbBranchLease(lease.neonBranchId);
       } catch (e) {
         try {
           console.warn(
-            `Bitfab: failed to release DB branch lease ${lease.leaseId} (TTL janitor will catch it): ${e instanceof Error ? e.message : String(e)}`
+            `Bitfab: failed to release DB branch ${lease.neonBranchId} (TTL janitor will catch it): ${e instanceof Error ? e.message : String(e)}`
           );
         } catch {
         }
@@ -1512,16 +1514,7 @@ init_constants();
 
 // src/dbSnapshot.ts
 init_errors();
-var SUPPORTED_PROVIDERS = [
-  "neon",
-  "ardent",
-  "dolt",
-  "gfs",
-  "mongodb-atlas",
-  "dynamodb",
-  "snowflake",
-  "bigquery"
-];
+var SUPPORTED_PROVIDERS = ["neon"];
 function validateDbSnapshotConfig(config) {
   if (!SUPPORTED_PROVIDERS.includes(config.provider)) {
     throw new BitfabError(
@@ -2048,14 +2041,6 @@ var ReplayEnvironment = class {
   get traceId() {
     return this.require().traceId;
   }
-  /**
-   * How the resolver pinned this branch.
-   * - "timestamp": snapshot at SDK wall clock; bounded by replication lag.
-   * - "lsn": customer LSN mapped to a replica snapshot (future).
-   */
-  get precision() {
-    return this.require().precision;
-  }
   /** True when read inside a replay item that has a resolved branch. */
   get active() {
     return this.read() !== null;
@@ -2079,8 +2064,7 @@ var ReplayEnvironment = class {
       expiresAt: lease.expiresAt,
       providerConsoleUrl: lease.providerConsoleUrl,
       readOnly: lease.readOnly,
-      traceId,
-      precision: lease.precision
+      traceId
     };
   }
   require() {
@@ -2200,6 +2184,7 @@ var BitfabOpenAITracingProcessor = class {
       const jsonResult = span.toJSON();
       if (typeof jsonResult !== "object" || jsonResult === null) {
         errors.push({
+          source: "sdk",
           step: "span.toJSON()",
           error: `Returned unexpected type: ${typeof jsonResult}`
         });
@@ -2209,6 +2194,7 @@ var BitfabOpenAITracingProcessor = class {
       }
     } catch (error) {
       errors.push({
+        source: "sdk",
         step: "span.toJSON()",
         error: error instanceof Error ? error.message : String(error)
       });
@@ -2228,6 +2214,7 @@ var BitfabOpenAITracingProcessor = class {
       spanData.input = span.spanData?._input || [];
     } catch (error) {
       errors.push({
+        source: "sdk",
         step: "access_input",
         error: error instanceof Error ? error.message : String(error)
       });
@@ -2236,6 +2223,7 @@ var BitfabOpenAITracingProcessor = class {
       spanData.response = span.spanData?._response || null;
     } catch (error) {
       errors.push({
+        source: "sdk",
         step: "access_response",
         error: error instanceof Error ? error.message : String(error)
       });
@@ -2932,7 +2920,6 @@ var Bitfab = class {
         try {
           const endedAt = (/* @__PURE__ */ new Date()).toISOString();
           const replayCtx = getReplayContext();
-          const dbSnapshotRefForSpan = isRootSpan ? activeTraceStates.get(traceId)?.dbSnapshotRef : void 0;
           const spanPromise = self.sendWrapperSpan({
             ...baseSpanParams,
             ...params,
@@ -2942,9 +2929,6 @@ var Bitfab = class {
             ...replayCtx?.testRunId && { testRunId: replayCtx.testRunId },
             ...replayCtx?.inputSourceSpanId && {
               inputSourceSpanId: replayCtx.inputSourceSpanId
-            },
-            ...dbSnapshotRefForSpan && {
-              dbSnapshotRef: dbSnapshotRefForSpan
             }
           });
           if (isRootSpan) {
@@ -3168,14 +3152,14 @@ var Bitfab = class {
         ...params.functionName !== void 0 && {
           function_name: params.functionName
         },
-        ...params.error !== void 0 && { error: params.error },
+        ...params.error !== void 0 && {
+          error: params.error,
+          error_source: "code"
+        },
         ...params.contexts && params.contexts.length > 0 && {
           contexts: params.contexts
         },
-        ...params.prompt !== void 0 && { prompt: params.prompt },
-        ...params.dbSnapshotRef && {
-          db_snapshot_ref: params.dbSnapshotRef
-        }
+        ...params.prompt !== void 0 && { prompt: params.prompt }
       }
     };
     if (params.parentSpanId) {