bitfab 0.57.5 → 0.57.7

package/dist/index.d.cts

@@ -440,7 +440,8 @@ declare class HttpClient {
     readonly traceCompletion: TraceCompletion;
     private closed;
     private closing;
-    externalSpanTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
+    externalSpanTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit, drop: () => void) => void) | undefined;
+    frameworkSpanStart: ((traceId: string, spanId: string, parentSpanId: string | null) => void) | undefined;
     externalTraceTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
     releaseHeldExternalSpans: ((timeoutMs: number) => Promise<boolean> | Promise<void>) | undefined;
     stopSimulationPlan: (() => void) | undefined;
@@ -570,6 +571,7 @@ declare class HttpClient {
      * the OTLP carrier has no path to carry it.
      */
     sendInternalTrace(functionId: string, payload: Record<string, unknown>): void;
+    reserveFrameworkSpan(traceId: string, spanId: string, parentSpanId: string | null | undefined): void;
     sendExternalSpan(payload: Record<string, unknown>): void;
     submitExternalSpan(payload: Record<string, unknown>): void;
     /**
@@ -1303,6 +1305,123 @@ declare class DatasetsClient {
     getGraderRerun(datasetId: string, runId?: string): Promise<GraderRerun | null>;
 }
 
+type TraceTargetOccurrence = "first" | "last" | number;
+type TraceTarget = {
+    kind: "output";
+} | {
+    kind: "span";
+    name: string;
+    occurrence?: TraceTargetOccurrence;
+};
+type TraceAssertionSource = "human" | "agent";
+type TraceSearchFilters = {
+    callerMetadata?: Record<string, string>;
+    name?: string;
+    nameContains?: string;
+};
+type TraceSearchParams = TraceSearchFilters & ({
+    callerMetadata: Record<string, string>;
+} | {
+    name: string;
+} | {
+    nameContains: string;
+}) & {
+    traceFunctionKey?: string;
+    cursor?: string | null;
+    limit?: number;
+};
+type TraceSearchResult = {
+    traces: Array<{
+        id: string;
+        traceFunctionKey: string | null;
+        name: string | null;
+        status: "pending" | "completed" | "failed" | "dropped";
+        createdAt: string;
+        callerMetadata: Record<string, string>;
+    }>;
+    nextCursor: string | null;
+    hasMore: boolean;
+};
+type TraceAssertion = {
+    id: string;
+    traceId: string;
+    assertion: string;
+    humanNote: string | null;
+    category_assertion_id: string | null;
+    category: AssertionCategorySummary | null;
+    passCriteria: string | null;
+    failCriteria: string | null;
+    targetOnEvaluatedTrace: TraceTarget | null;
+    source: TraceAssertionSource;
+    /** Why this assertion is right for its trace, span by span. */
+    justification: Justification | null;
+    /** Why its assigned category is the right one, span by span. */
+    categoryJustification: Justification | null;
+    createdAt: string;
+    updatedAt: string;
+} & ApprovalFields;
+type AssertionEvidenceParameter = {
+    name: string;
+    type: "string" | "number" | "boolean" | "object" | "array" | "null" | "unknown";
+};
+type PotentialAssertionEvidence = {
+    spanId: string;
+    text: string;
+    spanName: string | null;
+    parameters: AssertionEvidenceParameter[];
+    spanType: "llm" | "agent" | "function" | "guardrail" | "handoff" | "custom";
+    isMocked: boolean;
+};
+type SaveAssertion = {
+    /** Omit to preserve the category, or pass null to clear it. */
+    category_assertion_id?: string | null;
+    id?: string;
+    assertion: string;
+    passCriteria?: string | null;
+    failCriteria?: string | null;
+    targetOnEvaluatedTrace?: TraceTarget | null;
+    /**
+     * Why this assertion is right for this trace, one entry per span it rests on.
+     * Cite spans on this trace only. Omit on an edit to preserve it.
+     */
+    justification?: Justification | null;
+    /**
+     * Why `category_assertion_id` is the right category. Changing the category
+     * clears it. Omit on an edit to preserve it.
+     */
+    categoryJustification?: Justification | null;
+};
+type TraceAssertionsResult = {
+    assertions: TraceAssertion[];
+    inheritedFrom: string | null;
+};
+type TraceAssertionsUpdate = {
+    traceId: string;
+    assertions: SaveAssertion[];
+};
+type SaveAssertionsParams = {
+    traceId: string;
+    assertions: SaveAssertion[];
+    source?: TraceAssertionSource;
+};
+type SaveAssertionsAllParams = {
+    updates: TraceAssertionsUpdate[];
+    source?: TraceAssertionSource;
+};
+type ArchiveAssertionsParams = {
+    traceId: string;
+    assertionIds: string[];
+};
+declare class TracesClient {
+    private readonly httpClient;
+    constructor(httpClient: HttpClient);
+    search(params: TraceSearchParams): Promise<TraceSearchResult>;
+    getAssertions(traceId: string): Promise<TraceAssertionsResult>;
+    saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
+    saveAssertionsAll(params: SaveAssertionsAllParams): Promise<TraceAssertion[]>;
+    archiveAssertions(params: ArchiveAssertionsParams): Promise<string[]>;
+}
+
 type LabelConfidence = "VeryLow" | "Low" | "Medium" | "High" | "VeryHigh";
 type LabelAction = "set" | "archived" | "no-active-label" | "skipped";
 type LabelStatus = "labeled" | "skipped" | "unlabeled";
@@ -1383,6 +1502,8 @@ declare class LabelsClient {
     saveHumanAll(updates: HumanLabelUpdate[]): Promise<HumanLabelOutcome[]>;
     get(traceId: string): Promise<TraceLabels | null>;
     getAll(traceIds: string[]): Promise<TraceLabels[]>;
+    /** Generate suggested evidence for an assertion on an original or replay trace. */
+    generateLabelEvidence(traceId: string, assertionId: string): Promise<PotentialAssertionEvidence[]>;
 }
 
 type GraderLabelSource = "human" | "live_grader";
@@ -2294,130 +2415,6 @@ declare class BitfabRivetIntegration<TContext extends object = RivetContextLike>
     private createQueueIterator;
 }
 
-type TraceTargetOccurrence = "first" | "last" | number;
-type TraceTarget = {
-    kind: "output";
-} | {
-    kind: "span";
-    name: string;
-    occurrence?: TraceTargetOccurrence;
-};
-type TraceAssertionSource = "human" | "agent";
-type TraceSearchFilters = {
-    callerMetadata?: Record<string, string>;
-    name?: string;
-    nameContains?: string;
-};
-type TraceSearchParams = TraceSearchFilters & ({
-    callerMetadata: Record<string, string>;
-} | {
-    name: string;
-} | {
-    nameContains: string;
-}) & {
-    traceFunctionKey?: string;
-    cursor?: string | null;
-    limit?: number;
-};
-type TraceSearchResult = {
-    traces: Array<{
-        id: string;
-        traceFunctionKey: string | null;
-        name: string | null;
-        status: "pending" | "completed" | "failed" | "dropped";
-        createdAt: string;
-        callerMetadata: Record<string, string>;
-    }>;
-    nextCursor: string | null;
-    hasMore: boolean;
-};
-type TraceAssertion = {
-    id: string;
-    traceId: string;
-    assertion: string;
-    humanNote: string | null;
-    category_assertion_id: string | null;
-    category: AssertionCategorySummary | null;
-    passCriteria: string | null;
-    failCriteria: string | null;
-    targetOnEvaluatedTrace: TraceTarget | null;
-    source: TraceAssertionSource;
-    /** Why this assertion is right for its trace, span by span. */
-    justification: Justification | null;
-    /** Why its assigned category is the right one, span by span. */
-    categoryJustification: Justification | null;
-    createdAt: string;
-    updatedAt: string;
-} & ApprovalFields;
-type AssertionEvidenceParameter = {
-    name: string;
-    type: "string" | "number" | "boolean" | "object" | "array" | "null" | "unknown";
-};
-type PotentialAssertionEvidence = {
-    spanId: string;
-    text: string;
-    spanName: string | null;
-    parameters: AssertionEvidenceParameter[];
-    spanType: "llm" | "agent" | "function" | "guardrail" | "handoff" | "custom";
-    isMocked: boolean;
-};
-type SaveAssertion = {
-    /** Omit to preserve the category, or pass null to clear it. */
-    category_assertion_id?: string | null;
-    id?: string;
-    assertion: string;
-    passCriteria?: string | null;
-    failCriteria?: string | null;
-    targetOnEvaluatedTrace?: TraceTarget | null;
-    /**
-     * Why this assertion is right for this trace, one entry per span it rests on.
-     * Cite spans on this trace only. Omit on an edit to preserve it.
-     */
-    justification?: Justification | null;
-    /**
-     * Why `category_assertion_id` is the right category. Changing the category
-     * clears it. Omit on an edit to preserve it.
-     */
-    categoryJustification?: Justification | null;
-};
-type TraceAssertionsResult = {
-    assertions: TraceAssertion[];
-    inheritedFrom: string | null;
-};
-type TraceAssertionsUpdate = {
-    traceId: string;
-    assertions: SaveAssertion[];
-};
-type SaveAssertionsParams = {
-    traceId: string;
-    assertions: SaveAssertion[];
-    source?: TraceAssertionSource;
-};
-type SaveAssertionsAllParams = {
-    updates: TraceAssertionsUpdate[];
-    source?: TraceAssertionSource;
-};
-type ArchiveAssertionsParams = {
-    traceId: string;
-    assertionIds: string[];
-};
-declare class TraceAssertionsClient {
-    private readonly httpClient;
-    constructor(httpClient: HttpClient);
-    /** Suggest evidence for an assertion, enriched with its span context. */
-    getAssertionEvidence(assertionId: string): Promise<PotentialAssertionEvidence[]>;
-}
-declare class TracesClient {
-    private readonly httpClient;
-    readonly assertions: TraceAssertionsClient;
-    constructor(httpClient: HttpClient);
-    search(params: TraceSearchParams): Promise<TraceSearchResult>;
-    getAssertions(traceId: string): Promise<TraceAssertionsResult>;
-    saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
-    saveAssertionsAll(params: SaveAssertionsAllParams): Promise<TraceAssertion[]>;
-    archiveAssertions(params: ArchiveAssertionsParams): Promise<string[]>;
-}
-
 /**
  * Tracing utilities for external trace submission to Bitfab.
  *
@@ -2432,6 +2429,7 @@ interface Trace {
 interface Span<_T = any> {
     spanId?: string;
     traceId?: string;
+    parentId?: string | null;
     toJSON(): unknown;
     spanData?: {
         type?: string;
@@ -3627,7 +3625,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.57.5";
+declare const __version__ = "0.57.7";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3766,4 +3764,4 @@ declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, ca
     run?: boolean;
 }): Promise<SeedResult>;
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ApprovalFields, type ApprovalState, type Approver, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionEvidenceParameter, type AssertionVerdict, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabRivetIntegration, BitfabVercelAiHandler, type CaptureSurface, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CommitRef, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type Justification, type JustificationSpan, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelTarget, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type PotentialAssertionEvidence, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, type RivetContextLike, type RivetEffectType, type RivetIntegrationOptions, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedCaseOptions, type SeedResult, type SeedRunOptions, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceAssertion, type TraceAssertionSource, TraceAssertionsClient, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchFilters, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ApprovalFields, type ApprovalState, type Approver, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionEvidenceParameter, type AssertionVerdict, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabRivetIntegration, BitfabVercelAiHandler, type CaptureSurface, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CommitRef, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type Justification, type JustificationSpan, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelTarget, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type PotentialAssertionEvidence, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, type RivetContextLike, type RivetEffectType, type RivetIntegrationOptions, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedCaseOptions, type SeedResult, type SeedRunOptions, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceAssertion, type TraceAssertionSource, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchFilters, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };

package/dist/index.d.ts

@@ -440,7 +440,8 @@ declare class HttpClient {
     readonly traceCompletion: TraceCompletion;
     private closed;
     private closing;
-    externalSpanTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
+    externalSpanTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit, drop: () => void) => void) | undefined;
+    frameworkSpanStart: ((traceId: string, spanId: string, parentSpanId: string | null) => void) | undefined;
     externalTraceTransform: ((payload: Record<string, unknown>, submit: SimulationPlanSubmit) => void) | undefined;
     releaseHeldExternalSpans: ((timeoutMs: number) => Promise<boolean> | Promise<void>) | undefined;
     stopSimulationPlan: (() => void) | undefined;
@@ -570,6 +571,7 @@ declare class HttpClient {
      * the OTLP carrier has no path to carry it.
      */
     sendInternalTrace(functionId: string, payload: Record<string, unknown>): void;
+    reserveFrameworkSpan(traceId: string, spanId: string, parentSpanId: string | null | undefined): void;
     sendExternalSpan(payload: Record<string, unknown>): void;
     submitExternalSpan(payload: Record<string, unknown>): void;
     /**
@@ -1303,6 +1305,123 @@ declare class DatasetsClient {
     getGraderRerun(datasetId: string, runId?: string): Promise<GraderRerun | null>;
 }
 
+type TraceTargetOccurrence = "first" | "last" | number;
+type TraceTarget = {
+    kind: "output";
+} | {
+    kind: "span";
+    name: string;
+    occurrence?: TraceTargetOccurrence;
+};
+type TraceAssertionSource = "human" | "agent";
+type TraceSearchFilters = {
+    callerMetadata?: Record<string, string>;
+    name?: string;
+    nameContains?: string;
+};
+type TraceSearchParams = TraceSearchFilters & ({
+    callerMetadata: Record<string, string>;
+} | {
+    name: string;
+} | {
+    nameContains: string;
+}) & {
+    traceFunctionKey?: string;
+    cursor?: string | null;
+    limit?: number;
+};
+type TraceSearchResult = {
+    traces: Array<{
+        id: string;
+        traceFunctionKey: string | null;
+        name: string | null;
+        status: "pending" | "completed" | "failed" | "dropped";
+        createdAt: string;
+        callerMetadata: Record<string, string>;
+    }>;
+    nextCursor: string | null;
+    hasMore: boolean;
+};
+type TraceAssertion = {
+    id: string;
+    traceId: string;
+    assertion: string;
+    humanNote: string | null;
+    category_assertion_id: string | null;
+    category: AssertionCategorySummary | null;
+    passCriteria: string | null;
+    failCriteria: string | null;
+    targetOnEvaluatedTrace: TraceTarget | null;
+    source: TraceAssertionSource;
+    /** Why this assertion is right for its trace, span by span. */
+    justification: Justification | null;
+    /** Why its assigned category is the right one, span by span. */
+    categoryJustification: Justification | null;
+    createdAt: string;
+    updatedAt: string;
+} & ApprovalFields;
+type AssertionEvidenceParameter = {
+    name: string;
+    type: "string" | "number" | "boolean" | "object" | "array" | "null" | "unknown";
+};
+type PotentialAssertionEvidence = {
+    spanId: string;
+    text: string;
+    spanName: string | null;
+    parameters: AssertionEvidenceParameter[];
+    spanType: "llm" | "agent" | "function" | "guardrail" | "handoff" | "custom";
+    isMocked: boolean;
+};
+type SaveAssertion = {
+    /** Omit to preserve the category, or pass null to clear it. */
+    category_assertion_id?: string | null;
+    id?: string;
+    assertion: string;
+    passCriteria?: string | null;
+    failCriteria?: string | null;
+    targetOnEvaluatedTrace?: TraceTarget | null;
+    /**
+     * Why this assertion is right for this trace, one entry per span it rests on.
+     * Cite spans on this trace only. Omit on an edit to preserve it.
+     */
+    justification?: Justification | null;
+    /**
+     * Why `category_assertion_id` is the right category. Changing the category
+     * clears it. Omit on an edit to preserve it.
+     */
+    categoryJustification?: Justification | null;
+};
+type TraceAssertionsResult = {
+    assertions: TraceAssertion[];
+    inheritedFrom: string | null;
+};
+type TraceAssertionsUpdate = {
+    traceId: string;
+    assertions: SaveAssertion[];
+};
+type SaveAssertionsParams = {
+    traceId: string;
+    assertions: SaveAssertion[];
+    source?: TraceAssertionSource;
+};
+type SaveAssertionsAllParams = {
+    updates: TraceAssertionsUpdate[];
+    source?: TraceAssertionSource;
+};
+type ArchiveAssertionsParams = {
+    traceId: string;
+    assertionIds: string[];
+};
+declare class TracesClient {
+    private readonly httpClient;
+    constructor(httpClient: HttpClient);
+    search(params: TraceSearchParams): Promise<TraceSearchResult>;
+    getAssertions(traceId: string): Promise<TraceAssertionsResult>;
+    saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
+    saveAssertionsAll(params: SaveAssertionsAllParams): Promise<TraceAssertion[]>;
+    archiveAssertions(params: ArchiveAssertionsParams): Promise<string[]>;
+}
+
 type LabelConfidence = "VeryLow" | "Low" | "Medium" | "High" | "VeryHigh";
 type LabelAction = "set" | "archived" | "no-active-label" | "skipped";
 type LabelStatus = "labeled" | "skipped" | "unlabeled";
@@ -1383,6 +1502,8 @@ declare class LabelsClient {
     saveHumanAll(updates: HumanLabelUpdate[]): Promise<HumanLabelOutcome[]>;
     get(traceId: string): Promise<TraceLabels | null>;
     getAll(traceIds: string[]): Promise<TraceLabels[]>;
+    /** Generate suggested evidence for an assertion on an original or replay trace. */
+    generateLabelEvidence(traceId: string, assertionId: string): Promise<PotentialAssertionEvidence[]>;
 }
 
 type GraderLabelSource = "human" | "live_grader";
@@ -2294,130 +2415,6 @@ declare class BitfabRivetIntegration<TContext extends object = RivetContextLike>
     private createQueueIterator;
 }
 
-type TraceTargetOccurrence = "first" | "last" | number;
-type TraceTarget = {
-    kind: "output";
-} | {
-    kind: "span";
-    name: string;
-    occurrence?: TraceTargetOccurrence;
-};
-type TraceAssertionSource = "human" | "agent";
-type TraceSearchFilters = {
-    callerMetadata?: Record<string, string>;
-    name?: string;
-    nameContains?: string;
-};
-type TraceSearchParams = TraceSearchFilters & ({
-    callerMetadata: Record<string, string>;
-} | {
-    name: string;
-} | {
-    nameContains: string;
-}) & {
-    traceFunctionKey?: string;
-    cursor?: string | null;
-    limit?: number;
-};
-type TraceSearchResult = {
-    traces: Array<{
-        id: string;
-        traceFunctionKey: string | null;
-        name: string | null;
-        status: "pending" | "completed" | "failed" | "dropped";
-        createdAt: string;
-        callerMetadata: Record<string, string>;
-    }>;
-    nextCursor: string | null;
-    hasMore: boolean;
-};
-type TraceAssertion = {
-    id: string;
-    traceId: string;
-    assertion: string;
-    humanNote: string | null;
-    category_assertion_id: string | null;
-    category: AssertionCategorySummary | null;
-    passCriteria: string | null;
-    failCriteria: string | null;
-    targetOnEvaluatedTrace: TraceTarget | null;
-    source: TraceAssertionSource;
-    /** Why this assertion is right for its trace, span by span. */
-    justification: Justification | null;
-    /** Why its assigned category is the right one, span by span. */
-    categoryJustification: Justification | null;
-    createdAt: string;
-    updatedAt: string;
-} & ApprovalFields;
-type AssertionEvidenceParameter = {
-    name: string;
-    type: "string" | "number" | "boolean" | "object" | "array" | "null" | "unknown";
-};
-type PotentialAssertionEvidence = {
-    spanId: string;
-    text: string;
-    spanName: string | null;
-    parameters: AssertionEvidenceParameter[];
-    spanType: "llm" | "agent" | "function" | "guardrail" | "handoff" | "custom";
-    isMocked: boolean;
-};
-type SaveAssertion = {
-    /** Omit to preserve the category, or pass null to clear it. */
-    category_assertion_id?: string | null;
-    id?: string;
-    assertion: string;
-    passCriteria?: string | null;
-    failCriteria?: string | null;
-    targetOnEvaluatedTrace?: TraceTarget | null;
-    /**
-     * Why this assertion is right for this trace, one entry per span it rests on.
-     * Cite spans on this trace only. Omit on an edit to preserve it.
-     */
-    justification?: Justification | null;
-    /**
-     * Why `category_assertion_id` is the right category. Changing the category
-     * clears it. Omit on an edit to preserve it.
-     */
-    categoryJustification?: Justification | null;
-};
-type TraceAssertionsResult = {
-    assertions: TraceAssertion[];
-    inheritedFrom: string | null;
-};
-type TraceAssertionsUpdate = {
-    traceId: string;
-    assertions: SaveAssertion[];
-};
-type SaveAssertionsParams = {
-    traceId: string;
-    assertions: SaveAssertion[];
-    source?: TraceAssertionSource;
-};
-type SaveAssertionsAllParams = {
-    updates: TraceAssertionsUpdate[];
-    source?: TraceAssertionSource;
-};
-type ArchiveAssertionsParams = {
-    traceId: string;
-    assertionIds: string[];
-};
-declare class TraceAssertionsClient {
-    private readonly httpClient;
-    constructor(httpClient: HttpClient);
-    /** Suggest evidence for an assertion, enriched with its span context. */
-    getAssertionEvidence(assertionId: string): Promise<PotentialAssertionEvidence[]>;
-}
-declare class TracesClient {
-    private readonly httpClient;
-    readonly assertions: TraceAssertionsClient;
-    constructor(httpClient: HttpClient);
-    search(params: TraceSearchParams): Promise<TraceSearchResult>;
-    getAssertions(traceId: string): Promise<TraceAssertionsResult>;
-    saveAssertions(params: SaveAssertionsParams): Promise<TraceAssertion[]>;
-    saveAssertionsAll(params: SaveAssertionsAllParams): Promise<TraceAssertion[]>;
-    archiveAssertions(params: ArchiveAssertionsParams): Promise<string[]>;
-}
-
 /**
  * Tracing utilities for external trace submission to Bitfab.
  *
@@ -2432,6 +2429,7 @@ interface Trace {
 interface Span<_T = any> {
     spanId?: string;
     traceId?: string;
+    parentId?: string | null;
     toJSON(): unknown;
     spanData?: {
         type?: string;
@@ -3627,7 +3625,7 @@ interface CommitRef {
 /**
  * SDK version from package.json (injected at build time)
  */
-declare const __version__ = "0.57.5";
+declare const __version__ = "0.57.7";
 
 /**
  * Constants for the Bitfab SDK.
@@ -3766,4 +3764,4 @@ declare function seedFromRegistry(registry: ReplayRegistry, pipeline: string, ca
     run?: boolean;
 }): Promise<SeedResult>;
 
-export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ApprovalFields, type ApprovalState, type Approver, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionEvidenceParameter, type AssertionVerdict, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabRivetIntegration, BitfabVercelAiHandler, type CaptureSurface, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CommitRef, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type Justification, type JustificationSpan, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelTarget, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type PotentialAssertionEvidence, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, type RivetContextLike, type RivetEffectType, type RivetIntegrationOptions, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedCaseOptions, type SeedResult, type SeedRunOptions, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceAssertion, type TraceAssertionSource, TraceAssertionsClient, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchFilters, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };
+export { type ActiveSpanContext, type AdaptContext, type AdaptInputsFn, type AddDatasetGradersResult, type AddDatasetTracesResult, type AllowedEnvVars, type ApprovalFields, type ApprovalState, type Approver, type ArchiveAssertionsParams, AssertionCategoriesClient, type AssertionCategory, type AssertionCategorySummary, type AssertionEvidenceParameter, type AssertionVerdict, BITFAB_PROGRESS_PREFIX, type BamlExecutionResult, Bitfab, BitfabClaudeAgentHandler, type BitfabConfig, BitfabError, BitfabFunction, BitfabLangGraphCallbackHandler as BitfabLangChainCallbackHandler, BitfabLangGraphCallbackHandler, BitfabLangGraphIntegration, type BitfabLanguageModelMiddleware, BitfabOpenAIAgentHandler, BitfabOpenAITracingProcessor, BitfabRivetIntegration, BitfabVercelAiHandler, type CaptureSurface, type CaptureWhen, type CapturedSpan, type CodeChangeFile, type CommitRef, type CurrentSpan, type CurrentTrace, DEFAULT_SERVICE_URL, type Dataset, type DatasetGraderRef, type DatasetTraceIds, DatasetsClient, type DbBranchOptions, DbBranchReplayError, type DbBranchTimings, type DbSnapshotConfig, type DbSnapshotProvider, type DbSnapshotRef, type DetachedTrace, type GetGraderLabelsParams, type GraderLabel, type GraderLabelSource, type GraderRerun, type GraderRerunProgress, type GraderRerunResult, type GraderRerunStatus, GradersClient, HttpClient, type HumanLabelOutcome, type HumanLabelUpdate, type Justification, type JustificationSpan, type LabelAction, type LabelConfidence, type LabelOutcome, type LabelSource, type LabelStatus, type LabelTarget, type LabelUpdate, LabelsClient, type LangGraphIntegrationOptions, type ListDatasetsParams, MixedTracingError, type MockOverride, type MockOverrideCtx, type MockOverrideInput, type MockOverrideResolver, type MockStrategy, type MockValue, NO_MOCK_OVERRIDE, type NodeMatcher, type NodeMethodDecorator, type NodeOptions, type PotentialAssertionEvidence, type ProviderDefinition, type RemoveDatasetGradersResult, type RemoveDatasetTracesResult, ReplayBranch, ReplayError, type ReplayItem, type ReplayItemFinishProgress, type ReplayItemStartProgress, type ReplayOptions, type ReplayOptionsFactory, type ReplayProgress, type ReplayProgressItem, type ReplayRegistration, type ReplayRegistry, type ReplayRegistryContext, type ReplayRegistryOptions, type ReplayResult, type RerunGradersOptions, type RerunGradersResult, type ReseedOptions, type ReseedRegistryResult, type ReseedResult, type RivetContextLike, type RivetEffectType, type RivetIntegrationOptions, SUPPORTED_PROVIDERS, type SaveAssertion, type SaveAssertionCategoryParams, type SaveAssertionsAllParams, type SaveAssertionsParams, type SaveDatasetParams, type SaveDatasetResult, type SeedCase, type SeedCaseOptions, type SeedResult, type SeedRunOptions, type SpanLookup, type SpanMethodDecorator, type SpanMethodDecoratorContext, type SpanNodeMeta, type SpanOccurrence, type SpanOptions, type SpanType, type TokenUsage, type TraceAssertion, type TraceAssertionSource, type TraceAssertionsResult, type TraceAssertionsUpdate, type TraceIngestionType, type TraceLabels, type TraceOutline, type TraceOutlineSpan, type TraceOutlineSpanError, type TraceResponse, type TraceSearchFilters, type TraceSearchParams, type TraceSearchResult, type TraceTarget, type TraceTargetOccurrence, TracesClient, type TracingProcessor, type VercelCallParams, type VercelGenerateResult, type VercelStreamResult, type WrapBAMLOptions, type WrappedBamlFn, __version__, defineReplayRegistry, finalizers, flushTraces, getCurrentReplayBranch, getCurrentSpan, getCurrentTrace, reportReplayProgress, reseedFromRegistry, seedFromRegistry, serializeReplayResult };

package/dist/index.js

@@ -22,7 +22,6 @@ import {
   GradersClient,
   LabelsClient,
   SUPPORTED_PROVIDERS,
-  TraceAssertionsClient,
   TracesClient,
   defineReplayRegistry,
   finalizers,
@@ -31,7 +30,7 @@ import {
   getCurrentTrace,
   reseedFromRegistry,
   seedFromRegistry
-} from "./chunk-YO3HKQX6.js";
+} from "./chunk-W3HLGZBO.js";
 import "./chunk-RCHSYWKI.js";
 import {
   BITFAB_PROGRESS_PREFIX,
@@ -40,7 +39,7 @@ import {
   ReplayError,
   reportReplayProgress,
   serializeReplayResult
-} from "./chunk-VPZ2LTU6.js";
+} from "./chunk-VPU6U4WM.js";
 import {
   BitfabError,
   DEFAULT_SERVICE_URL,
@@ -48,7 +47,7 @@ import {
   MixedTracingError,
   __version__,
   flushTraces
-} from "./chunk-255I4PN4.js";
+} from "./chunk-P4R3NY2U.js";
 import "./chunk-VCRFFCLY.js";
 export {
   AssertionCategoriesClient,
@@ -74,7 +73,6 @@ export {
   NO_MOCK_OVERRIDE,
   ReplayError,
   SUPPORTED_PROVIDERS,
-  TraceAssertionsClient,
   TracesClient,
   __version__,
   defineReplayRegistry,