@bitfab/sdk 0.64.19 → 0.64.20

package/dist/{chunk-THOWQGGK.js → chunk-KC6CJUMD.js}

@@ -17,7 +17,7 @@ import {
   serializeValue,
   toJsonSafe,
   toJsonSafeReport
-} from "./chunk-BWPW6I3Z.js";
+} from "./chunk-SR2WNZCW.js";
 import {
   BitfabError,
   CONTENT_OFF_KEY,
@@ -26,6 +26,7 @@ import {
   HttpClient,
   MixedTracingError,
   ROOT_TRACE_FUNCTION_KEY_FIELD,
+  SPAN_TYPES,
   SimulationPlan,
   callerTraceMetadata,
   experimentIdWireFields,
@@ -36,7 +37,7 @@ import {
   readEnv,
   recordCallerTraceMetadata,
   retireTraceMetadata
-} from "./chunk-UIKFZWVQ.js";
+} from "./chunk-JXZHAIXA.js";
 import {
   __privateAdd,
   __privateGet,
@@ -1005,6 +1006,19 @@ async function runFunctionWithBaml(bamlSource, inputs, providers, envVars) {
   };
 }
 
+// src/bitfabIds.ts
+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/captureSurface.ts
 var DEFAULT_SURFACE = "opt-in";
 var SURFACE_API = {
@@ -3330,6 +3344,33 @@ function runWithSeedContext(ctx, fn) {
   return fn();
 }
 
+// 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/traces.ts
 var ASSERTIONS_PATH = "/api/sdk/traces/assertions";
 var SEARCH_PATH = "/api/sdk/traces/search";
@@ -4203,16 +4244,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: "",
@@ -4446,6 +4479,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);
@@ -5924,22 +5958,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(
@@ -6307,7 +6346,7 @@ var Bitfab = class {
       await runWithSeedContext({ traceId }, async () => target(...args));
     } finally {
       try {
-        const { flushTraces: flushTraces2 } = await import("./http-MAYDYAUH.js");
+        const { flushTraces: flushTraces2 } = await import("./http-GX4NROD3.js");
         await flushTraces2(3e4);
       } finally {
         unrecorded = activeTraceStates.delete(traceId);
@@ -6366,7 +6405,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-RWZSRTHU.js");
+    const { replay: doReplay } = await import("./replay-SZTY5TYU.js");
     return doReplay(
       this.httpClient,
       this.serviceUrl,
@@ -6712,7 +6751,7 @@ async function seedFromRegistry(registry, pipeline, cases, options = {}) {
       sessionId: seedCase.sessionId
     })
   );
-  const { flushTraces: flushTraces2 } = await import("./http-MAYDYAUH.js");
+  const { flushTraces: flushTraces2 } = await import("./http-GX4NROD3.js");
   await flushTraces2(3e4);
   return { pipeline, traceFunctionKey, traceIds };
 }
@@ -6742,6 +6781,7 @@ export {
   BitfabOpenAIAgentHandler,
   OrganizationMembersClient,
   BitfabRivetIntegration,
+  SpansClient,
   AssertionGenerationError,
   AssertionGenerationTimeoutError,
   TracesClient,
@@ -6757,4 +6797,4 @@ export {
   reseedFromRegistry,
   seedFromRegistry
 };
-//# sourceMappingURL=chunk-THOWQGGK.js.map
+//# sourceMappingURL=chunk-KC6CJUMD.js.map