agent-inspect 6.21.0 → 6.22.0

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

@@ -1,11 +1,11 @@
 import { T as TraceMetadataStatus } from './types-VzKihKQo.cjs';
-import { T as TraceReadWarning, a as TraceReadResult } from './index-vqr-g6ev.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", "correlationId", "requestId", "decisionId"];
+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";
@@ -28,6 +28,11 @@ interface SessionWorkflowMetadata {
     toolCallId?: string;
     mcpToolCallId?: string;
     linkedStepId?: string;
+    operationId?: string;
+    attemptId?: string;
+    attemptNumber?: number;
+    fallbackOf?: string;
+    idempotencyKey?: string;
     correlationId?: string;
     requestId?: string;
     decisionId?: string;

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

@@ -1,11 +1,11 @@
 import { T as TraceMetadataStatus } from './types-Bx3mEZ04.js';
-import { T as TraceReadWarning, a as TraceReadResult } from './index-AMAGuO_i.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", "correlationId", "requestId", "decisionId"];
+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";
@@ -28,6 +28,11 @@ interface SessionWorkflowMetadata {
     toolCallId?: string;
     mcpToolCallId?: string;
     linkedStepId?: string;
+    operationId?: string;
+    attemptId?: string;
+    attemptNumber?: number;
+    fallbackOf?: string;
+    idempotencyKey?: string;
     correlationId?: string;
     requestId?: string;
     decisionId?: string;

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/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;