agent-inspect 6.20.0 → 6.22.0

package/packages/core/dist/{index-rVpX5PPh.d.cts → index-CR4CCRqP.d.cts}

@@ -1,8 +1,165 @@
-import { T as TraceReadWarning, a as TraceReadResult } from './index-vqr-g6ev.cjs';
+import { T as TraceMetadataStatus } from './types-VzKihKQo.cjs';
+import { h as TraceReadWarning, g as TraceReadResult } from './index-DLLz9sce.cjs';
 import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DRthdZlf.cjs';
 import { P as PersistedInspectEvent } from './persisted-inspect-event-CVZWZldL.cjs';
 import { O as ObservedOutcomeStatus } from './types-B562HgN_.cjs';
 
+/** Known session/workflow metadata keys (v2.4 RFC). */
+declare const SESSION_WORKFLOW_KEYS: readonly ["sessionId", "conversationId", "groupId", "parentGroupId", "attempt", "retryOf", "retryReason", "handoffFrom", "handoffTo", "subAgentId", "subAgentName", "jobId", "queueName", "workflowName", "workflowStep", "toolCallId", "mcpToolCallId", "linkedStepId", "operationId", "attemptId", "attemptNumber", "fallbackOf", "idempotencyKey", "correlationId", "requestId", "decisionId"];
+type SessionWorkflowKey = (typeof SESSION_WORKFLOW_KEYS)[number];
+type SessionConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
+type SessionEdgeSource = "manual" | "adapter" | "json-log" | "log4js" | "mcp-client" | "inferred";
+interface SessionWorkflowMetadata {
+    sessionId?: string;
+    conversationId?: string;
+    groupId?: string;
+    parentGroupId?: string;
+    attempt?: number;
+    retryOf?: string;
+    retryReason?: string;
+    handoffFrom?: string;
+    handoffTo?: string;
+    subAgentId?: string;
+    subAgentName?: string;
+    jobId?: string;
+    queueName?: string;
+    workflowName?: string;
+    workflowStep?: string;
+    toolCallId?: string;
+    mcpToolCallId?: string;
+    linkedStepId?: string;
+    operationId?: string;
+    attemptId?: string;
+    attemptNumber?: number;
+    fallbackOf?: string;
+    idempotencyKey?: string;
+    correlationId?: string;
+    requestId?: string;
+    decisionId?: string;
+}
+interface SessionRunRecord {
+    runId: string;
+    name?: string;
+    status?: TraceMetadataStatus;
+    startedAt?: number;
+    endedAt?: number;
+    durationMs?: number;
+    filePath?: string;
+    metadata?: Record<string, unknown>;
+}
+interface SessionWarning {
+    code: string;
+    message: string;
+    runId?: string;
+    sessionId?: string;
+}
+interface HandoffEdge {
+    from: string;
+    to: string;
+    source: SessionEdgeSource;
+    confidence: SessionConfidence;
+}
+interface RetryLink {
+    runId: string;
+    retryOf?: string;
+    attempt?: number;
+    source: SessionEdgeSource;
+    confidence: SessionConfidence;
+}
+interface SessionGroup {
+    groupId: string;
+    parentGroupId?: string;
+    runIds: string[];
+}
+interface CriticalPathStep {
+    runId: string;
+    name?: string;
+    startedAt?: number;
+    durationMs?: number;
+    source: SessionEdgeSource;
+    confidence: SessionConfidence;
+}
+/** Session lifecycle status (v4.2 RFC). */
+type SessionStatus = "running" | "waiting_input" | "idle" | "completed" | "error" | "stale" | "unknown";
+interface SessionLastError {
+    runId: string;
+    message: string;
+    code?: string;
+}
+interface SessionCheckSummary {
+    pass: number;
+    fail: number;
+    warn: number;
+}
+interface EnrichSessionSummaryOptions {
+    /** Reference clock for staleness (default Date.now()). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (default 24h). */
+    staleThresholdMs?: number;
+}
+interface ActivityEntry {
+    sessionId: string;
+    status: SessionStatus;
+    summary: string;
+    lastActivity: string;
+    runCount: number;
+}
+interface ActivitySummary {
+    since: string;
+    sessions: number;
+    failed: number;
+    stale: number;
+    guardrailWarnings: number;
+    entries: ActivityEntry[];
+}
+interface BuildActivitySummaryOptions {
+    /** Duration window (e.g. 7d, 24h). Default 7d. */
+    since?: string;
+    /** Reference clock (default Date.now()). */
+    nowMs?: number;
+    /** Max entries returned (default 20). */
+    limit?: number;
+}
+interface SessionSummary {
+    sessionId: string;
+    runIds: string[];
+    groups: SessionGroup[];
+    handoffs: HandoffEdge[];
+    retries: RetryLink[];
+    criticalPath: CriticalPathStep[];
+    /** Derived session status (v4.2+). */
+    status: SessionStatus;
+    /** Earliest run start time in the session. */
+    startedAt?: number;
+    /** Latest run end time when all runs have ended. */
+    endedAt?: number;
+    /** endedAt - startedAt when both are present. */
+    durationMs?: number;
+    correlationId?: string;
+    jobId?: string;
+    workflowId?: string;
+    lastError?: SessionLastError;
+    /** ISO-8601 timestamp of the most recent run activity. */
+    lastActivity: string;
+    retryCount: number;
+    observationSummary?: string;
+    checkSummary?: SessionCheckSummary;
+}
+interface SessionIndex {
+    runs: SessionRunRecord[];
+    sessions: SessionSummary[];
+    unscopedRunIds: string[];
+    warnings: SessionWarning[];
+}
+interface BuildSessionIndexOptions {
+    /** When true, group runs that share only `groupId` under a synthetic session key. */
+    correlateByGroupId?: boolean;
+    /** Reference clock for session staleness (v4.2+). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (v4.2+, default 24h). */
+    staleThresholdMs?: number;
+}
+
 /**
  * Logical lifecycle projection for trace checks.
  *
@@ -724,4 +881,4 @@ declare function createObservedOutcomeRule(options?: ObservedOutcomeRuleOptions)
  */
 declare function runTraceChecks(input: TraceCheckInput, options?: RunTraceChecksOptions): TraceCheckResult;
 
-export { createRetrievalRule as $, type TraceCheckFacts as A, type BaselineRegressionRuleOptions as B, type TraceCheckFinding as C, type DecisionRuleOptions as D, type TraceCheckFindingStatus as E, type TraceCheckRule as F, type GuardrailRuleOptions as G, type TraceCheckRuleCategory as H, type TraceCheckRuleExecution as I, type TraceCheckRuleExecutionStatus as J, type TraceCheckSeverity as K, type LogicalTraceEvent as L, type MaxStepDurationRuleOptions as M, type TraceCheckStatus as N, type ObservedOutcomeRuleOptions as O, type TraceCheckSummary as P, type TraceSignalRuleOptions as Q, type RetrievalRuleOptions as R, type SafetyFindingCategory as S, type TraceCheckInput as T, createBaselineRegressionRule as U, createDecisionRule as V, createGuardrailRule as W, createLlmUsageRule as X, createMaxStepDurationRule as Y, createObservedOutcomeRule as Z, createRequireCompletedRule as _, type LogicalProjectionDiagnostic as a, createRunDepthRule as a0, createRunDurationRule as a1, createRunEventCountRule as a2, createRunStatusRule as a3, createSafetyOversizedAttributeRule as a4, createSafetyRawContentRule as a5, createSafetyRedactionRule as a6, createSafetySecretPatternRule as a7, createStallDetectionRule as a8, createStructureCycleRule as a9, createStructureIncompleteRule as aa, createStructureOrphanRule as ab, createStructureParallelWidthRule as ac, createStructureRelationshipRule as ad, createToolFailureRule as ae, createToolOrderingRule as af, createToolUsageRule as ag, projectLogicalEvents as ah, resolveCanonicalToolName as ai, runTraceChecks as aj, type TraceCheckResult as b, type LlmUsageRuleOptions as c, type RunDepthRuleOptions as d, type RunDurationRuleOptions as e, type RunEventCountRuleOptions as f, type RunStatusRuleOptions as g, type RunTraceChecksOptions as h, type SafetyFindingConfidence as i, type SafetyOversizedAttributeRuleOptions as j, type SafetyRawContentRuleOptions as k, type SafetyRedactionRuleOptions as l, type SafetySecretPattern as m, type SafetySecretPatternRuleOptions as n, type StallDetectionRuleOptions as o, type StructureIncompleteRuleOptions as p, type StructureOrphanRuleOptions as q, type StructureParallelWidthRuleOptions as r, type StructureRelationshipRuleOptions as s, type ToolFailureRuleOptions as t, type ToolOrderingRuleOptions as u, type ToolUsageRuleOptions as v, type TraceCheckContext as w, type TraceCheckDiagnostic as x, type TraceCheckDiagnosticCode as y, type TraceCheckEvidence as z };
+export { createRequireCompletedRule as $, type TraceCheckEvidence as A, type BaselineRegressionRuleOptions as B, type TraceCheckFacts as C, type DecisionRuleOptions as D, type TraceCheckFinding as E, type TraceCheckFindingStatus as F, type GuardrailRuleOptions as G, type TraceCheckRule as H, type TraceCheckRuleCategory as I, type TraceCheckRuleExecution as J, type TraceCheckRuleExecutionStatus as K, type LogicalTraceEvent as L, type MaxStepDurationRuleOptions as M, type TraceCheckSeverity as N, type ObservedOutcomeRuleOptions as O, type TraceCheckStatus as P, type TraceCheckSummary as Q, type RetrievalRuleOptions as R, type SessionWorkflowMetadata as S, type TraceCheckInput as T, type TraceSignalRuleOptions as U, createBaselineRegressionRule as V, createDecisionRule as W, createGuardrailRule as X, createLlmUsageRule as Y, createMaxStepDurationRule as Z, createObservedOutcomeRule as _, type LogicalProjectionDiagnostic as a, createRetrievalRule as a0, createRunDepthRule as a1, createRunDurationRule as a2, createRunEventCountRule as a3, createRunStatusRule as a4, createSafetyOversizedAttributeRule as a5, createSafetyRawContentRule as a6, createSafetyRedactionRule as a7, createSafetySecretPatternRule as a8, createStallDetectionRule as a9, type SessionConfidence as aA, type SessionEdgeSource as aB, type SessionGroup as aC, type SessionLastError as aD, type SessionWorkflowKey as aE, createStructureCycleRule as aa, createStructureIncompleteRule as ab, createStructureOrphanRule as ac, createStructureParallelWidthRule as ad, createStructureRelationshipRule as ae, createToolFailureRule as af, createToolOrderingRule as ag, createToolUsageRule as ah, projectLogicalEvents as ai, resolveCanonicalToolName as aj, runTraceChecks as ak, type SessionRunRecord as al, type EnrichSessionSummaryOptions as am, type SessionStatus as an, type SessionSummary as ao, type SessionIndex as ap, type BuildActivitySummaryOptions as aq, type ActivitySummary as ar, type SessionWarning as as, type BuildSessionIndexOptions as at, type ActivityEntry as au, type CriticalPathStep as av, type HandoffEdge as aw, type RetryLink as ax, SESSION_WORKFLOW_KEYS as ay, type SessionCheckSummary as az, type TraceCheckDiagnostic as b, type TraceCheckResult as c, type LlmUsageRuleOptions as d, type RunDepthRuleOptions as e, type RunDurationRuleOptions as f, type RunEventCountRuleOptions as g, type RunStatusRuleOptions as h, type RunTraceChecksOptions as i, type SafetyFindingCategory as j, type SafetyFindingConfidence as k, type SafetyOversizedAttributeRuleOptions as l, type SafetyRawContentRuleOptions as m, type SafetyRedactionRuleOptions as n, type SafetySecretPattern as o, type SafetySecretPatternRuleOptions as p, type StallDetectionRuleOptions as q, type StructureIncompleteRuleOptions as r, type StructureOrphanRuleOptions as s, type StructureParallelWidthRuleOptions as t, type StructureRelationshipRuleOptions as u, type ToolFailureRuleOptions as v, type ToolOrderingRuleOptions as w, type ToolUsageRuleOptions as x, type TraceCheckContext as y, type TraceCheckDiagnosticCode as z };

package/packages/core/dist/{index-Bg9ZdsdS.d.ts → index-CtK_p-ps.d.ts}

@@ -1,8 +1,165 @@
-import { T as TraceReadWarning, a as TraceReadResult } from './index-AMAGuO_i.js';
+import { T as TraceMetadataStatus } from './types-Bx3mEZ04.js';
+import { h as TraceReadWarning, g as TraceReadResult } from './index-D72DPqAF.js';
 import { a as InspectRunTree, b as InspectNode, A as AttributionConfidence } from './inspect-event-DRthdZlf.js';
 import { P as PersistedInspectEvent } from './persisted-inspect-event-BVucFVrP.js';
 import { O as ObservedOutcomeStatus } from './types-B562HgN_.js';
 
+/** Known session/workflow metadata keys (v2.4 RFC). */
+declare const SESSION_WORKFLOW_KEYS: readonly ["sessionId", "conversationId", "groupId", "parentGroupId", "attempt", "retryOf", "retryReason", "handoffFrom", "handoffTo", "subAgentId", "subAgentName", "jobId", "queueName", "workflowName", "workflowStep", "toolCallId", "mcpToolCallId", "linkedStepId", "operationId", "attemptId", "attemptNumber", "fallbackOf", "idempotencyKey", "correlationId", "requestId", "decisionId"];
+type SessionWorkflowKey = (typeof SESSION_WORKFLOW_KEYS)[number];
+type SessionConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
+type SessionEdgeSource = "manual" | "adapter" | "json-log" | "log4js" | "mcp-client" | "inferred";
+interface SessionWorkflowMetadata {
+    sessionId?: string;
+    conversationId?: string;
+    groupId?: string;
+    parentGroupId?: string;
+    attempt?: number;
+    retryOf?: string;
+    retryReason?: string;
+    handoffFrom?: string;
+    handoffTo?: string;
+    subAgentId?: string;
+    subAgentName?: string;
+    jobId?: string;
+    queueName?: string;
+    workflowName?: string;
+    workflowStep?: string;
+    toolCallId?: string;
+    mcpToolCallId?: string;
+    linkedStepId?: string;
+    operationId?: string;
+    attemptId?: string;
+    attemptNumber?: number;
+    fallbackOf?: string;
+    idempotencyKey?: string;
+    correlationId?: string;
+    requestId?: string;
+    decisionId?: string;
+}
+interface SessionRunRecord {
+    runId: string;
+    name?: string;
+    status?: TraceMetadataStatus;
+    startedAt?: number;
+    endedAt?: number;
+    durationMs?: number;
+    filePath?: string;
+    metadata?: Record<string, unknown>;
+}
+interface SessionWarning {
+    code: string;
+    message: string;
+    runId?: string;
+    sessionId?: string;
+}
+interface HandoffEdge {
+    from: string;
+    to: string;
+    source: SessionEdgeSource;
+    confidence: SessionConfidence;
+}
+interface RetryLink {
+    runId: string;
+    retryOf?: string;
+    attempt?: number;
+    source: SessionEdgeSource;
+    confidence: SessionConfidence;
+}
+interface SessionGroup {
+    groupId: string;
+    parentGroupId?: string;
+    runIds: string[];
+}
+interface CriticalPathStep {
+    runId: string;
+    name?: string;
+    startedAt?: number;
+    durationMs?: number;
+    source: SessionEdgeSource;
+    confidence: SessionConfidence;
+}
+/** Session lifecycle status (v4.2 RFC). */
+type SessionStatus = "running" | "waiting_input" | "idle" | "completed" | "error" | "stale" | "unknown";
+interface SessionLastError {
+    runId: string;
+    message: string;
+    code?: string;
+}
+interface SessionCheckSummary {
+    pass: number;
+    fail: number;
+    warn: number;
+}
+interface EnrichSessionSummaryOptions {
+    /** Reference clock for staleness (default Date.now()). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (default 24h). */
+    staleThresholdMs?: number;
+}
+interface ActivityEntry {
+    sessionId: string;
+    status: SessionStatus;
+    summary: string;
+    lastActivity: string;
+    runCount: number;
+}
+interface ActivitySummary {
+    since: string;
+    sessions: number;
+    failed: number;
+    stale: number;
+    guardrailWarnings: number;
+    entries: ActivityEntry[];
+}
+interface BuildActivitySummaryOptions {
+    /** Duration window (e.g. 7d, 24h). Default 7d. */
+    since?: string;
+    /** Reference clock (default Date.now()). */
+    nowMs?: number;
+    /** Max entries returned (default 20). */
+    limit?: number;
+}
+interface SessionSummary {
+    sessionId: string;
+    runIds: string[];
+    groups: SessionGroup[];
+    handoffs: HandoffEdge[];
+    retries: RetryLink[];
+    criticalPath: CriticalPathStep[];
+    /** Derived session status (v4.2+). */
+    status: SessionStatus;
+    /** Earliest run start time in the session. */
+    startedAt?: number;
+    /** Latest run end time when all runs have ended. */
+    endedAt?: number;
+    /** endedAt - startedAt when both are present. */
+    durationMs?: number;
+    correlationId?: string;
+    jobId?: string;
+    workflowId?: string;
+    lastError?: SessionLastError;
+    /** ISO-8601 timestamp of the most recent run activity. */
+    lastActivity: string;
+    retryCount: number;
+    observationSummary?: string;
+    checkSummary?: SessionCheckSummary;
+}
+interface SessionIndex {
+    runs: SessionRunRecord[];
+    sessions: SessionSummary[];
+    unscopedRunIds: string[];
+    warnings: SessionWarning[];
+}
+interface BuildSessionIndexOptions {
+    /** When true, group runs that share only `groupId` under a synthetic session key. */
+    correlateByGroupId?: boolean;
+    /** Reference clock for session staleness (v4.2+). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (v4.2+, default 24h). */
+    staleThresholdMs?: number;
+}
+
 /**
  * Logical lifecycle projection for trace checks.
  *
@@ -724,4 +881,4 @@ declare function createObservedOutcomeRule(options?: ObservedOutcomeRuleOptions)
  */
 declare function runTraceChecks(input: TraceCheckInput, options?: RunTraceChecksOptions): TraceCheckResult;
 
-export { createRetrievalRule as $, type TraceCheckFacts as A, type BaselineRegressionRuleOptions as B, type TraceCheckFinding as C, type DecisionRuleOptions as D, type TraceCheckFindingStatus as E, type TraceCheckRule as F, type GuardrailRuleOptions as G, type TraceCheckRuleCategory as H, type TraceCheckRuleExecution as I, type TraceCheckRuleExecutionStatus as J, type TraceCheckSeverity as K, type LogicalTraceEvent as L, type MaxStepDurationRuleOptions as M, type TraceCheckStatus as N, type ObservedOutcomeRuleOptions as O, type TraceCheckSummary as P, type TraceSignalRuleOptions as Q, type RetrievalRuleOptions as R, type SafetyFindingCategory as S, type TraceCheckInput as T, createBaselineRegressionRule as U, createDecisionRule as V, createGuardrailRule as W, createLlmUsageRule as X, createMaxStepDurationRule as Y, createObservedOutcomeRule as Z, createRequireCompletedRule as _, type LogicalProjectionDiagnostic as a, createRunDepthRule as a0, createRunDurationRule as a1, createRunEventCountRule as a2, createRunStatusRule as a3, createSafetyOversizedAttributeRule as a4, createSafetyRawContentRule as a5, createSafetyRedactionRule as a6, createSafetySecretPatternRule as a7, createStallDetectionRule as a8, createStructureCycleRule as a9, createStructureIncompleteRule as aa, createStructureOrphanRule as ab, createStructureParallelWidthRule as ac, createStructureRelationshipRule as ad, createToolFailureRule as ae, createToolOrderingRule as af, createToolUsageRule as ag, projectLogicalEvents as ah, resolveCanonicalToolName as ai, runTraceChecks as aj, type TraceCheckResult as b, type LlmUsageRuleOptions as c, type RunDepthRuleOptions as d, type RunDurationRuleOptions as e, type RunEventCountRuleOptions as f, type RunStatusRuleOptions as g, type RunTraceChecksOptions as h, type SafetyFindingConfidence as i, type SafetyOversizedAttributeRuleOptions as j, type SafetyRawContentRuleOptions as k, type SafetyRedactionRuleOptions as l, type SafetySecretPattern as m, type SafetySecretPatternRuleOptions as n, type StallDetectionRuleOptions as o, type StructureIncompleteRuleOptions as p, type StructureOrphanRuleOptions as q, type StructureParallelWidthRuleOptions as r, type StructureRelationshipRuleOptions as s, type ToolFailureRuleOptions as t, type ToolOrderingRuleOptions as u, type ToolUsageRuleOptions as v, type TraceCheckContext as w, type TraceCheckDiagnostic as x, type TraceCheckDiagnosticCode as y, type TraceCheckEvidence as z };
+export { createRequireCompletedRule as $, type TraceCheckEvidence as A, type BaselineRegressionRuleOptions as B, type TraceCheckFacts as C, type DecisionRuleOptions as D, type TraceCheckFinding as E, type TraceCheckFindingStatus as F, type GuardrailRuleOptions as G, type TraceCheckRule as H, type TraceCheckRuleCategory as I, type TraceCheckRuleExecution as J, type TraceCheckRuleExecutionStatus as K, type LogicalTraceEvent as L, type MaxStepDurationRuleOptions as M, type TraceCheckSeverity as N, type ObservedOutcomeRuleOptions as O, type TraceCheckStatus as P, type TraceCheckSummary as Q, type RetrievalRuleOptions as R, type SessionWorkflowMetadata as S, type TraceCheckInput as T, type TraceSignalRuleOptions as U, createBaselineRegressionRule as V, createDecisionRule as W, createGuardrailRule as X, createLlmUsageRule as Y, createMaxStepDurationRule as Z, createObservedOutcomeRule as _, type LogicalProjectionDiagnostic as a, createRetrievalRule as a0, createRunDepthRule as a1, createRunDurationRule as a2, createRunEventCountRule as a3, createRunStatusRule as a4, createSafetyOversizedAttributeRule as a5, createSafetyRawContentRule as a6, createSafetyRedactionRule as a7, createSafetySecretPatternRule as a8, createStallDetectionRule as a9, type SessionConfidence as aA, type SessionEdgeSource as aB, type SessionGroup as aC, type SessionLastError as aD, type SessionWorkflowKey as aE, createStructureCycleRule as aa, createStructureIncompleteRule as ab, createStructureOrphanRule as ac, createStructureParallelWidthRule as ad, createStructureRelationshipRule as ae, createToolFailureRule as af, createToolOrderingRule as ag, createToolUsageRule as ah, projectLogicalEvents as ai, resolveCanonicalToolName as aj, runTraceChecks as ak, type SessionRunRecord as al, type EnrichSessionSummaryOptions as am, type SessionStatus as an, type SessionSummary as ao, type SessionIndex as ap, type BuildActivitySummaryOptions as aq, type ActivitySummary as ar, type SessionWarning as as, type BuildSessionIndexOptions as at, type ActivityEntry as au, type CriticalPathStep as av, type HandoffEdge as aw, type RetryLink as ax, SESSION_WORKFLOW_KEYS as ay, type SessionCheckSummary as az, type TraceCheckDiagnostic as b, type TraceCheckResult as c, type LlmUsageRuleOptions as d, type RunDepthRuleOptions as e, type RunDurationRuleOptions as f, type RunEventCountRuleOptions as g, type RunStatusRuleOptions as h, type RunTraceChecksOptions as i, type SafetyFindingCategory as j, type SafetyFindingConfidence as k, type SafetyOversizedAttributeRuleOptions as l, type SafetyRawContentRuleOptions as m, type SafetyRedactionRuleOptions as n, type SafetySecretPattern as o, type SafetySecretPatternRuleOptions as p, type StallDetectionRuleOptions as q, type StructureIncompleteRuleOptions as r, type StructureOrphanRuleOptions as s, type StructureParallelWidthRuleOptions as t, type StructureRelationshipRuleOptions as u, type ToolFailureRuleOptions as v, type ToolOrderingRuleOptions as w, type ToolUsageRuleOptions as x, type TraceCheckContext as y, type TraceCheckDiagnosticCode as z };

package/packages/core/dist/{index-AMAGuO_i.d.ts → index-D72DPqAF.d.ts}

@@ -77,6 +77,7 @@ declare const openInferenceJsonReader: TraceReader;
 declare const otlpJsonReader: TraceReader;
 declare const agentInspectJsonlReader: TraceReader;
 declare const DEFAULT_TRACE_READERS: readonly TraceReader[];
+
 declare function detectTraceFormat(input: TraceInput, options?: TraceReadOptions): Promise<TraceFormatDetectionResult>;
 declare function readTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
 declare function openTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
@@ -99,4 +100,4 @@ declare function openTraceDirectory(dirPath: string, options?: TraceReadOptions)
  */
 declare function openTraceText(content: string, options?: TraceReadOptions): Promise<TraceReadResult>;
 
-export { DEFAULT_TRACE_READERS as D, type TraceReadWarning as T, type TraceReadResult as a, type TraceFormatCandidate as b, type TraceFormatDetectionResult as c, type TraceFormatDetectionStatus as d, type TraceInput as e, TraceReadError as f, type TraceReadErrorCode as g, type TraceReadOptions as h, type TraceReadWarningSeverity as i, type TraceReader as j, type TraceReaderDetectOptions as k, type TraceReaderReadOptions as l, agentInspectJsonlReader as m, assertTraceInput as n, detectTraceFormat as o, openInferenceJsonReader as p, openTrace as q, openTraceDirectory as r, openTraceFile as s, openTraceText as t, otlpJsonReader as u, readTrace as v };
+export { DEFAULT_TRACE_READERS as D, type TraceFormatCandidate as T, type TraceFormatDetectionResult as a, type TraceFormatDetectionStatus as b, type TraceInput as c, TraceReadError as d, type TraceReadErrorCode as e, type TraceReadOptions as f, type TraceReadResult as g, type TraceReadWarning as h, type TraceReadWarningSeverity as i, type TraceReader as j, type TraceReaderDetectOptions as k, type TraceReaderReadOptions as l, agentInspectJsonlReader as m, assertTraceInput as n, detectTraceFormat as o, openInferenceJsonReader as p, openTrace as q, openTraceDirectory as r, openTraceFile as s, openTraceText as t, otlpJsonReader as u, readTrace as v };

package/packages/core/dist/{index-vqr-g6ev.d.cts → index-DLLz9sce.d.cts}

@@ -77,6 +77,7 @@ declare const openInferenceJsonReader: TraceReader;
 declare const otlpJsonReader: TraceReader;
 declare const agentInspectJsonlReader: TraceReader;
 declare const DEFAULT_TRACE_READERS: readonly TraceReader[];
+
 declare function detectTraceFormat(input: TraceInput, options?: TraceReadOptions): Promise<TraceFormatDetectionResult>;
 declare function readTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
 declare function openTrace(input: TraceInput, options?: TraceReadOptions): Promise<TraceReadResult>;
@@ -99,4 +100,4 @@ declare function openTraceDirectory(dirPath: string, options?: TraceReadOptions)
  */
 declare function openTraceText(content: string, options?: TraceReadOptions): Promise<TraceReadResult>;
 
-export { DEFAULT_TRACE_READERS as D, type TraceReadWarning as T, type TraceReadResult as a, type TraceFormatCandidate as b, type TraceFormatDetectionResult as c, type TraceFormatDetectionStatus as d, type TraceInput as e, TraceReadError as f, type TraceReadErrorCode as g, type TraceReadOptions as h, type TraceReadWarningSeverity as i, type TraceReader as j, type TraceReaderDetectOptions as k, type TraceReaderReadOptions as l, agentInspectJsonlReader as m, assertTraceInput as n, detectTraceFormat as o, openInferenceJsonReader as p, openTrace as q, openTraceDirectory as r, openTraceFile as s, openTraceText as t, otlpJsonReader as u, readTrace as v };
+export { DEFAULT_TRACE_READERS as D, type TraceFormatCandidate as T, type TraceFormatDetectionResult as a, type TraceFormatDetectionStatus as b, type TraceInput as c, TraceReadError as d, type TraceReadErrorCode as e, type TraceReadOptions as f, type TraceReadResult as g, type TraceReadWarning as h, type TraceReadWarningSeverity as i, type TraceReader as j, type TraceReaderDetectOptions as k, type TraceReaderReadOptions as l, agentInspectJsonlReader as m, assertTraceInput as n, detectTraceFormat as o, openInferenceJsonReader as p, openTrace as q, openTraceDirectory as r, openTraceFile as s, openTraceText as t, otlpJsonReader as u, readTrace as v };

package/packages/core/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-UnrNaTo2.cjs';
-export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types-UnrNaTo2.cjs';
-export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-C5ye_xcS.cjs';
+import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-VzKihKQo.cjs';
+export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, g as TokenMetadata, h as TraceCorrelationMetadata } from './types-VzKihKQo.cjs';
+export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-DOOT9GZ-.cjs';
 import { a as ObserveOutcomeOptions } from './types-B562HgN_.cjs';
 import './log-config-CFlIJHTf.cjs';
 import './inspect-event-DRthdZlf.cjs';

package/packages/core/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types--ainI31J.js';
-export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types--ainI31J.js';
-export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-CNsNSgE2.js';
+import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-Bx3mEZ04.js';
+export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, g as TokenMetadata, h as TraceCorrelationMetadata } from './types-Bx3mEZ04.js';
+export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-DOX2-RjH.js';
 import { a as ObserveOutcomeOptions } from './types-B562HgN_.js';
 import './log-config-OZRfpHED.js';
 import './inspect-event-DRthdZlf.js';

package/packages/core/dist/index.mjs

@@ -1,6 +1,6 @@
-import { getCurrentContext, getCurrentDepth, getParentStepId, getTraceSafetyFromContext, runWithStepContext, printStepStart, printStepComplete, printError, printFailedAt, inspectRun } from './chunk-5YFJJFXU.mjs';
-export { createInspector, getCurrentCorrelationMetadata, inspectRun, maybeInspectRun } from './chunk-5YFJJFXU.mjs';
-import { normalizeObserveOutcomeInput, prepareOutcomeEventForDisk } from './chunk-3XS5O4JI.mjs';
+import { getCurrentContext, getCurrentDepth, getParentStepId, getTraceSafetyFromContext, runWithStepContext, printStepStart, printStepComplete, printError, printFailedAt, inspectRun } from './chunk-WGDSM37E.mjs';
+export { createInspector, getCurrentCorrelationMetadata, inspectRun, maybeInspectRun } from './chunk-WGDSM37E.mjs';
+import { normalizeObserveOutcomeInput, prepareOutcomeEventForDisk } from './chunk-R4SSYU6D.mjs';
 import './chunk-BT7CATSD.mjs';
 import { prepareTraceEventForDisk, writeTraceEvent } from './chunk-U25RHRSU.mjs';
 import './chunk-VU6O5QAH.mjs';

package/packages/core/dist/persisted.d.cts

@@ -1,6 +1,6 @@
 import { P as PersistedInspectEvent } from './persisted-inspect-event-CVZWZldL.cjs';
 export { a as PersistedEventSource, b as PersistedEventSourceType, c as PersistedEventStatus, d as PersistedInspectError, e as PersistedInspectEventV02, f as PersistedInspectEventV10, g as PersistedSchemaVersion, h as PersistedTokenUsage, i as PersistedTraceContext, j as isPersistedInspectEvent, k as isPersistedInspectEventV02, l as isPersistedInspectEventV10 } from './persisted-inspect-event-CVZWZldL.cjs';
-import { h as TraceEvent } from './types-UnrNaTo2.cjs';
+import { i as TraceEvent } from './types-VzKihKQo.cjs';
 import { c as InspectEvent, a as InspectRunTree } from './inspect-event-DRthdZlf.cjs';
 import './log-config-CFlIJHTf.cjs';
 

package/packages/core/dist/persisted.d.ts

@@ -1,6 +1,6 @@
 import { P as PersistedInspectEvent } from './persisted-inspect-event-BVucFVrP.js';
 export { a as PersistedEventSource, b as PersistedEventSourceType, c as PersistedEventStatus, d as PersistedInspectError, e as PersistedInspectEventV02, f as PersistedInspectEventV10, g as PersistedSchemaVersion, h as PersistedTokenUsage, i as PersistedTraceContext, j as isPersistedInspectEvent, k as isPersistedInspectEventV02, l as isPersistedInspectEventV10 } from './persisted-inspect-event-BVucFVrP.js';
-import { h as TraceEvent } from './types--ainI31J.js';
+import { i as TraceEvent } from './types-Bx3mEZ04.js';
 import { c as InspectEvent, a as InspectRunTree } from './inspect-event-DRthdZlf.js';
 import './log-config-OZRfpHED.js';
 

package/packages/core/dist/programmatic-gZTWLObB.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Stable programmatic diagnostic codes for readers / TraceFacts / TraceContract.
+ *
+ * Lowercase `TraceReadError.code` values remain the published reader error codes.
+ * These `AI_*` identifiers appear in messages and catalogs for actionable remediation.
+ *
+ * @experimental Additive in 6.15.0; do not replace published lowercase reader codes.
+ */
+type ProgrammaticDiagnosticCode = "AI_TRACE_INPUT_INVALID" | "AI_TRACE_FORMAT_UNSUPPORTED" | "AI_TRACE_FORMAT_AMBIGUOUS" | "AI_TRACE_FACTS_INPUT_NOT_NORMALIZED" | "AI_TRACE_CONTRACT_RUN_SELECTION_REQUIRED" | "AI_TRACE_RELATIONSHIP_SELF_PARENT" | "AI_TRACE_RELATIONSHIP_CYCLE";
+interface ProgrammaticDiagnosticSpec {
+    readonly code: ProgrammaticDiagnosticCode;
+    /** Short problem statement (without the code prefix). */
+    readonly summary: string;
+    /** Actionable remediation hint (always included in formatted messages). */
+    readonly remediation: string;
+    /** Related published / capture codes that must remain valid. */
+    readonly relatedCodes?: readonly string[];
+}
+declare const PROGRAMMATIC_DIAGNOSTIC_SPECS: Readonly<Record<ProgrammaticDiagnosticCode, ProgrammaticDiagnosticSpec>>;
+/**
+ * Format `CODE: summary Remediation: …` for thrown errors and diagnostics.
+ */
+declare function formatProgrammaticDiagnostic(code: ProgrammaticDiagnosticCode, detail?: string): string;
+
+export { PROGRAMMATIC_DIAGNOSTIC_SPECS as P, type ProgrammaticDiagnosticCode as a, type ProgrammaticDiagnosticSpec as b, formatProgrammaticDiagnostic as f };

package/packages/core/dist/programmatic-gZTWLObB.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stable programmatic diagnostic codes for readers / TraceFacts / TraceContract.
+ *
+ * Lowercase `TraceReadError.code` values remain the published reader error codes.
+ * These `AI_*` identifiers appear in messages and catalogs for actionable remediation.
+ *
+ * @experimental Additive in 6.15.0; do not replace published lowercase reader codes.
+ */
+type ProgrammaticDiagnosticCode = "AI_TRACE_INPUT_INVALID" | "AI_TRACE_FORMAT_UNSUPPORTED" | "AI_TRACE_FORMAT_AMBIGUOUS" | "AI_TRACE_FACTS_INPUT_NOT_NORMALIZED" | "AI_TRACE_CONTRACT_RUN_SELECTION_REQUIRED" | "AI_TRACE_RELATIONSHIP_SELF_PARENT" | "AI_TRACE_RELATIONSHIP_CYCLE";
+interface ProgrammaticDiagnosticSpec {
+    readonly code: ProgrammaticDiagnosticCode;
+    /** Short problem statement (without the code prefix). */
+    readonly summary: string;
+    /** Actionable remediation hint (always included in formatted messages). */
+    readonly remediation: string;
+    /** Related published / capture codes that must remain valid. */
+    readonly relatedCodes?: readonly string[];
+}
+declare const PROGRAMMATIC_DIAGNOSTIC_SPECS: Readonly<Record<ProgrammaticDiagnosticCode, ProgrammaticDiagnosticSpec>>;
+/**
+ * Format `CODE: summary Remediation: …` for thrown errors and diagnostics.
+ */
+declare function formatProgrammaticDiagnostic(code: ProgrammaticDiagnosticCode, detail?: string): string;
+
+export { PROGRAMMATIC_DIAGNOSTIC_SPECS as P, type ProgrammaticDiagnosticCode as a, type ProgrammaticDiagnosticSpec as b, formatProgrammaticDiagnostic as f };

package/packages/core/dist/readers.cjs

@@ -1234,6 +1234,107 @@ function formatProgrammaticDiagnostic(code, detail) {
   return `${code}: ${summary} Remediation: ${spec.remediation}`;
 }
 
+// packages/core/src/readers/mapping-ledger.ts
+var OPENINFERENCE_MAPPING_LEDGER = {
+  id: "openinference-to-agent-inspect",
+  sourceFormat: "openinference-json",
+  targetFormat: "agent-inspect-persisted-1.0",
+  convention: {
+    name: "OpenInference",
+    version: "0.2.x",
+    specUrl: "https://github.com/Arize-ai/openinference"
+  },
+  entries: [
+    {
+      source: "span.context.span_id",
+      target: "eventId / trace.spanId",
+      transformation: "hex identity when present",
+      confidence: "explicit",
+      loss: "none"
+    },
+    {
+      source: "span.context.trace_id",
+      target: "trace.traceId",
+      transformation: "hex identity when present",
+      confidence: "explicit",
+      loss: "none"
+    },
+    {
+      source: "span.parent_id",
+      target: "parentId",
+      transformation: "direct when resolvable in batch",
+      confidence: "explicit",
+      loss: "none"
+    },
+    {
+      source: "attributes.openinference.span.kind",
+      target: "kind",
+      transformation: "enumerated kind map with degrade-to-LOGIC",
+      confidence: "correlated",
+      loss: "kind-degraded",
+      privacyDecision: "unknown kinds preserved under bounds as attributes"
+    },
+    {
+      source: "attributes.llm.input_messages / output_messages",
+      target: "inputSummary / outputSummary",
+      transformation: "bounded summaries only",
+      confidence: "heuristic",
+      loss: "privacy-redacted",
+      privacyDecision: "raw message bodies are not required and may be omitted"
+    }
+  ],
+  knownLosses: [
+    "Chain-of-thought / private reasoning fields are never imported as raw content.",
+    "Oversized attributes are bounded or marked unsupported.",
+    "Unknown OpenInference kinds degrade to LOGIC with a warning."
+  ]
+};
+var OTLP_JSON_MAPPING_LEDGER = {
+  id: "otlp-json-to-agent-inspect",
+  sourceFormat: "otlp-json",
+  targetFormat: "agent-inspect-persisted-1.0",
+  convention: {
+    name: "OpenTelemetry GenAI semantic conventions",
+    version: "1.36.0",
+    specUrl: "https://opentelemetry.io/docs/specs/semconv/gen-ai/"
+  },
+  entries: [
+    {
+      source: "resourceSpans[].scopeSpans[].spans[]",
+      target: "PersistedInspectEvent[]",
+      transformation: "one span \u2192 one event when mappable",
+      confidence: "explicit",
+      loss: "none"
+    },
+    {
+      source: "span.attributes[gen_ai.*]",
+      target: "attributes / tokenUsage / kind",
+      transformation: "pinned GenAI attribute family",
+      confidence: "correlated",
+      loss: "bounded"
+    },
+    {
+      source: "span.attributes (unknown keys)",
+      target: "attributes.* / unsupportedFields",
+      transformation: "preserve under bounds or list as unsupported",
+      confidence: "unknown",
+      loss: "unsupported"
+    }
+  ],
+  knownLosses: [
+    "Schema 1.0 is not bound to Development-status OTel GenAI revisions.",
+    "Status rewrite to fit a local narrative is forbidden.",
+    "Payload bodies may be omitted; digests are optional application metadata."
+  ]
+};
+var BUILTIN_MAPPING_LEDGERS = Object.freeze([
+  OPENINFERENCE_MAPPING_LEDGER,
+  OTLP_JSON_MAPPING_LEDGER
+]);
+function getMappingLedger(id) {
+  return BUILTIN_MAPPING_LEDGERS.find((ledger) => ledger.id === id);
+}
+
 // packages/core/src/readers/index.ts
 var DEFAULT_MAX_TRACE_INPUT_BYTES = 10 * 1024 * 1024;
 var MIN_DETECTION_CONFIDENCE = 0.5;
@@ -2854,13 +2955,17 @@ function openTraceText(content, options = {}) {
   return openTrace({ type: "string", content }, options);
 }
 
+exports.BUILTIN_MAPPING_LEDGERS = BUILTIN_MAPPING_LEDGERS;
 exports.DEFAULT_TRACE_READERS = DEFAULT_TRACE_READERS;
+exports.OPENINFERENCE_MAPPING_LEDGER = OPENINFERENCE_MAPPING_LEDGER;
+exports.OTLP_JSON_MAPPING_LEDGER = OTLP_JSON_MAPPING_LEDGER;
 exports.PROGRAMMATIC_DIAGNOSTIC_SPECS = PROGRAMMATIC_DIAGNOSTIC_SPECS;
 exports.TraceReadError = TraceReadError;
 exports.agentInspectJsonlReader = agentInspectJsonlReader;
 exports.assertTraceInput = assertTraceInput;
 exports.detectTraceFormat = detectTraceFormat;
 exports.formatProgrammaticDiagnostic = formatProgrammaticDiagnostic;
+exports.getMappingLedger = getMappingLedger;
 exports.openInferenceJsonReader = openInferenceJsonReader;
 exports.openTrace = openTrace;
 exports.openTraceDirectory = openTraceDirectory;