@bitfab/sdk 0.64.19 → 0.64.20

package/dist/{http-MAYDYAUH.js → http-GX4NROD3.js}

@@ -1,17 +1,19 @@
 import {
   BitfabError,
   HttpClient,
+  SPAN_TYPES,
   awaitOnExit,
   awaitPendingRequests,
   experimentIdWireFields,
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-UIKFZWVQ.js";
+} from "./chunk-JXZHAIXA.js";
 import "./chunk-MT36GJMW.js";
 export {
   BitfabError,
   HttpClient,
+  SPAN_TYPES,
   awaitOnExit,
   awaitPendingRequests,
   experimentIdWireFields,
@@ -19,4 +21,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-MAYDYAUH.js.map
+//# sourceMappingURL=http-GX4NROD3.js.map

package/dist/{http-A64VT2NH.js → http-OEYRIJZM.js}

@@ -1,16 +1,18 @@
 import {
   BitfabError,
   HttpClient,
+  SPAN_TYPES,
   awaitOnExit,
   awaitPendingRequests,
   experimentIdWireFields,
   flushTraces,
   parseRetryAfterMs,
   serializePayloadBody
-} from "./chunk-2S6LDAYM.js";
+} from "./chunk-U2NAI4RU.js";
 export {
   BitfabError,
   HttpClient,
+  SPAN_TYPES,
   awaitOnExit,
   awaitPendingRequests,
   experimentIdWireFields,
@@ -18,4 +20,4 @@ export {
   parseRetryAfterMs,
   serializePayloadBody
 };
-//# sourceMappingURL=http-A64VT2NH.js.map
+//# sourceMappingURL=http-OEYRIJZM.js.map

package/dist/index.cjs

@@ -42,7 +42,7 @@ var __version__, __packageName__;
 var init_version_generated = __esm({
   "src/version.generated.ts"() {
     "use strict";
-    __version__ = "0.64.19";
+    __version__ = "0.64.20";
     __packageName__ = "@bitfab/sdk";
   }
 });
@@ -2114,6 +2114,7 @@ var http_exports = {};
 __export(http_exports, {
   BitfabError: () => BitfabError,
   HttpClient: () => HttpClient,
+  SPAN_TYPES: () => SPAN_TYPES,
   awaitOnExit: () => awaitOnExit,
   awaitPendingRequests: () => awaitPendingRequests,
   experimentIdWireFields: () => experimentIdWireFields,
@@ -2288,7 +2289,7 @@ function warnDroppedExternalTrace(error) {
 function experimentIdWireFields(experimentId) {
   return { experimentId, testRunId: experimentId };
 }
-var REPLAY_DB_BRANCH_REQUEST_TIMEOUT_MS, REPLAY_COMPLETE_REQUEST_TIMEOUT_MS, REPLAY_INTERRUPT_REQUEST_TIMEOUT_MS, REPLAY_HEARTBEAT_REQUEST_TIMEOUT_MS, OTLP_TRACES_ENDPOINT, RETRYABLE_STATUSES, EXIT_FLUSH_TIMEOUT_MS, DEFAULT_LIFECYCLE_TIMEOUT_MS2, pendingTracePromises, liveHttpClients, carrierSeq, HttpClient;
+var REPLAY_DB_BRANCH_REQUEST_TIMEOUT_MS, REPLAY_COMPLETE_REQUEST_TIMEOUT_MS, REPLAY_INTERRUPT_REQUEST_TIMEOUT_MS, REPLAY_HEARTBEAT_REQUEST_TIMEOUT_MS, OTLP_TRACES_ENDPOINT, RETRYABLE_STATUSES, EXIT_FLUSH_TIMEOUT_MS, DEFAULT_LIFECYCLE_TIMEOUT_MS2, pendingTracePromises, liveHttpClients, SPAN_TYPES, carrierSeq, HttpClient;
 var init_http = __esm({
   "src/http.ts"() {
     "use strict";
@@ -2346,6 +2347,14 @@ var init_http = __esm({
         });
       });
     }
+    SPAN_TYPES = [
+      "llm",
+      "agent",
+      "function",
+      "guardrail",
+      "handoff",
+      "custom"
+    ];
     carrierSeq = 0;
     HttpClient = class {
       constructor(config) {
@@ -2730,7 +2739,12 @@ var init_http = __esm({
         if (lookup.id !== void 0) {
           searchParams.set("id", lookup.id);
         } else {
-          searchParams.set("name", lookup.name);
+          if (lookup.name !== void 0) {
+            searchParams.set("name", lookup.name);
+          }
+          if (lookup.type !== void 0) {
+            searchParams.set("type", lookup.type);
+          }
           searchParams.set("occurrence", String(lookup.occurrence ?? "last"));
         }
         const endpoint = `/api/sdk/traces/${encodeURIComponent(traceId)}/span?${searchParams.toString()}`;
@@ -5357,6 +5371,7 @@ __export(index_exports, {
   OrganizationMembersClient: () => OrganizationMembersClient,
   ReplayError: () => ReplayError,
   SUPPORTED_PROVIDERS: () => SUPPORTED_PROVIDERS,
+  SpansClient: () => SpansClient,
   TracesClient: () => TracesClient,
   __version__: () => __version__,
   defineReplayRegistry: () => defineReplayRegistry,
@@ -6509,6 +6524,20 @@ async function runFunctionWithBaml(bamlSource, inputs, providers, envVars) {
   };
 }
 
+// src/bitfabIds.ts
+init_errors();
+var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function validateTraceId(traceId) {
+  if (typeof traceId !== "string" || !UUID_PATTERN.test(traceId)) {
+    throw new BitfabError("traceId must be a valid Bitfab trace ID");
+  }
+}
+function validateSpanId(id) {
+  if (typeof id !== "string" || !UUID_PATTERN.test(id)) {
+    throw new BitfabError("id must be a valid Bitfab span ID");
+  }
+}
+
 // src/client.ts
 init_captureSuppression();
 
@@ -8881,6 +8910,35 @@ function runWithSeedContext(ctx, fn) {
 init_serialize();
 init_simulationPlan();
 init_spanOrigin();
+
+// src/spans.ts
+var LIST_PATH = "/api/sdk/spans/list";
+function withoutUndefined(params) {
+  return Object.fromEntries(
+    Object.entries(params).filter(([, value]) => value !== void 0)
+  );
+}
+var SpansClient = class {
+  constructor(httpClient) {
+    this.httpClient = httpClient;
+  }
+  /**
+   * List one trace's spans in the order they ran, one page at a time. No
+   * filter is required: omit `spanType` and `spanName` to page through every
+   * span. Each span carries one extra key per requested `fields` entry. Pass
+   * the returned `nextCursor` back as `cursor` for the next page. Throws a
+   * `BitfabError` with status 404 when the trace is not in your organization.
+   */
+  async list(traceId, params = {}) {
+    validateTraceId(traceId);
+    return this.httpClient.request(
+      LIST_PATH,
+      withoutUndefined({ traceId, ...params })
+    );
+  }
+};
+
+// src/client.ts
 init_traceMetadata();
 
 // src/traces.ts
@@ -9761,16 +9819,8 @@ function extractContextFromCollector(collector) {
     return null;
   }
 }
-var UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-function validateTraceId(traceId) {
-  if (typeof traceId !== "string" || !UUID_PATTERN.test(traceId)) {
-    throw new BitfabError("traceId must be a valid Bitfab trace ID");
-  }
-}
-function validateSpanId(id) {
-  if (typeof id !== "string" || !UUID_PATTERN.test(id)) {
-    throw new BitfabError("id must be a valid Bitfab span ID");
-  }
+function isSpanType(value) {
+  return SPAN_TYPES.some((spanType) => spanType === value);
 }
 var noOpSpan = {
   id: "",
@@ -10004,6 +10054,7 @@ var Bitfab = class {
     this.assertionCategories = new AssertionCategoriesClient(this.httpClient);
     this.organizationMembers = new OrganizationMembersClient(this.httpClient);
     this.traces = new TracesClient(this.httpClient);
+    this.spans = new SpansClient(this.httpClient);
     this.labels = new LabelsClient(this.httpClient);
     this.graders = new GradersClient(this.httpClient);
     this.experiments = new ExperimentsClient(this.httpClient);
@@ -11482,22 +11533,27 @@ var Bitfab = class {
   }
   /**
    * Fetch one persisted span from a trace without loading the full trace.
-   * Name lookups return the last matching span by default. Pass `occurrence`
-   * as `"first"` or a zero-based index to select a different match.
+   * Look up by `id` alone, or by `name` and/or `type` (both must match when
+   * both are given). Name and type lookups return the last matching span by
+   * default. Pass `occurrence` as `"first"` or a zero-based index to select a
+   * different match. Returns `null` when no span matches.
    */
   async getTraceSpan(traceId, lookup) {
     validateTraceId(traceId);
     const hasId = lookup.id !== void 0;
-    const hasName = lookup.name !== void 0;
-    if (hasId === hasName) {
-      throw new BitfabError("Provide exactly one of id or name");
+    const hasNameOrType = lookup.name !== void 0 || lookup.type !== void 0;
+    if (hasId === hasNameOrType) {
+      throw new BitfabError("Provide id, or name and/or type");
     }
     if (hasId) {
       validateSpanId(lookup.id);
     } else {
-      if (lookup.name.length === 0) {
+      if (lookup.name !== void 0 && lookup.name.length === 0) {
         throw new BitfabError("name must be a non-empty string");
       }
+      if (lookup.type !== void 0 && !isSpanType(lookup.type)) {
+        throw new BitfabError(`type must be one of ${SPAN_TYPES.join(", ")}`);
+      }
       const occurrence = lookup.occurrence ?? "last";
       if (occurrence !== "first" && occurrence !== "last" && (!Number.isInteger(occurrence) || occurrence < 0)) {
         throw new BitfabError(
@@ -12328,6 +12384,7 @@ function resolveTraceFunctionKey(registration) {
   OrganizationMembersClient,
   ReplayError,
   SUPPORTED_PROVIDERS,
+  SpansClient,
   TracesClient,
   __version__,
   defineReplayRegistry,