agent-inspect 6.20.0 → 6.22.0

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

@@ -1,29 +1,54 @@
-export { D as DEFAULT_TRACE_READERS, b as TraceFormatCandidate, c as TraceFormatDetectionResult, d as TraceFormatDetectionStatus, e as TraceInput, f as TraceReadError, g as TraceReadErrorCode, h as TraceReadOptions, a as TraceReadResult, T as TraceReadWarning, i as TraceReadWarningSeverity, j as TraceReader, k as TraceReaderDetectOptions, l as TraceReaderReadOptions, m as agentInspectJsonlReader, n as assertTraceInput, o as detectTraceFormat, p as openInferenceJsonReader, q as openTrace, r as openTraceDirectory, s as openTraceFile, t as openTraceText, u as otlpJsonReader, v as readTrace } from './index-vqr-g6ev.cjs';
+export { D as DEFAULT_TRACE_READERS, T as TraceFormatCandidate, a as TraceFormatDetectionResult, b as TraceFormatDetectionStatus, c as TraceInput, d as TraceReadError, e as TraceReadErrorCode, f as TraceReadOptions, g as TraceReadResult, h as TraceReadWarning, i as TraceReadWarningSeverity, j as TraceReader, k as TraceReaderDetectOptions, l as TraceReaderReadOptions, m as agentInspectJsonlReader, n as assertTraceInput, o as detectTraceFormat, p as openInferenceJsonReader, q as openTrace, r as openTraceDirectory, s as openTraceFile, t as openTraceText, u as otlpJsonReader, v as readTrace } from './index-DLLz9sce.cjs';
+export { P as PROGRAMMATIC_DIAGNOSTIC_SPECS, a as ProgrammaticDiagnosticCode, b as ProgrammaticDiagnosticSpec, f as formatProgrammaticDiagnostic } from './programmatic-gZTWLObB.cjs';
 import './inspect-event-DRthdZlf.cjs';
 import './persisted-inspect-event-CVZWZldL.cjs';
 
 /**
- * Stable programmatic diagnostic codes for readers / TraceFacts / TraceContract.
+ * Version-pinned reader/exporter mapping ledger (6.22).
  *
- * Lowercase `TraceReadError.code` values remain the published reader error codes.
- * These `AI_*` identifiers appear in messages and catalogs for actionable remediation.
+ * Records which external convention version was used and what was lost.
+ * Does not bind persisted schema 1.0 to an unstable external convention.
  *
- * @experimental Additive in 6.15.0; do not replace published lowercase reader codes.
+ * @experimental Available through `agent-inspect/readers`.
  */
-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[];
+type MappingConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
+type MappingLossKind = "none" | "dropped" | "bounded" | "privacy-redacted" | "kind-degraded" | "unsupported";
+/**
+ * One source→target mapping row.
+ *
+ * @experimental
+ */
+interface MappingLedgerEntry {
+    source: string;
+    target: string;
+    transformation: string;
+    confidence: MappingConfidence;
+    loss: MappingLossKind;
+    privacyDecision?: string;
 }
-declare const PROGRAMMATIC_DIAGNOSTIC_SPECS: Readonly<Record<ProgrammaticDiagnosticCode, ProgrammaticDiagnosticSpec>>;
 /**
- * Format `CODE: summary Remediation: …` for thrown errors and diagnostics.
+ * Ledger published by a reader or exporter mapping.
+ *
+ * @experimental
  */
-declare function formatProgrammaticDiagnostic(code: ProgrammaticDiagnosticCode, detail?: string): string;
+interface MappingLedger {
+    id: string;
+    sourceFormat: string;
+    targetFormat: string;
+    /** External convention pin (e.g. OTel GenAI / OpenInference version). */
+    convention?: {
+        name: string;
+        version: string;
+        specUrl?: string;
+    };
+    entries: readonly MappingLedgerEntry[];
+    knownLosses: readonly string[];
+}
+/** OpenInference → AgentInspect mapping ledger pin. */
+declare const OPENINFERENCE_MAPPING_LEDGER: MappingLedger;
+/** OTLP JSON → AgentInspect mapping ledger pin. */
+declare const OTLP_JSON_MAPPING_LEDGER: MappingLedger;
+declare const BUILTIN_MAPPING_LEDGERS: readonly MappingLedger[];
+declare function getMappingLedger(id: string): MappingLedger | undefined;
 
-export { PROGRAMMATIC_DIAGNOSTIC_SPECS, type ProgrammaticDiagnosticCode, type ProgrammaticDiagnosticSpec, formatProgrammaticDiagnostic };
+export { BUILTIN_MAPPING_LEDGERS, type MappingConfidence, type MappingLedger, type MappingLedgerEntry, type MappingLossKind, OPENINFERENCE_MAPPING_LEDGER, OTLP_JSON_MAPPING_LEDGER, getMappingLedger };

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

@@ -1,29 +1,54 @@
-export { D as DEFAULT_TRACE_READERS, b as TraceFormatCandidate, c as TraceFormatDetectionResult, d as TraceFormatDetectionStatus, e as TraceInput, f as TraceReadError, g as TraceReadErrorCode, h as TraceReadOptions, a as TraceReadResult, T as TraceReadWarning, i as TraceReadWarningSeverity, j as TraceReader, k as TraceReaderDetectOptions, l as TraceReaderReadOptions, m as agentInspectJsonlReader, n as assertTraceInput, o as detectTraceFormat, p as openInferenceJsonReader, q as openTrace, r as openTraceDirectory, s as openTraceFile, t as openTraceText, u as otlpJsonReader, v as readTrace } from './index-AMAGuO_i.js';
+export { D as DEFAULT_TRACE_READERS, T as TraceFormatCandidate, a as TraceFormatDetectionResult, b as TraceFormatDetectionStatus, c as TraceInput, d as TraceReadError, e as TraceReadErrorCode, f as TraceReadOptions, g as TraceReadResult, h as TraceReadWarning, i as TraceReadWarningSeverity, j as TraceReader, k as TraceReaderDetectOptions, l as TraceReaderReadOptions, m as agentInspectJsonlReader, n as assertTraceInput, o as detectTraceFormat, p as openInferenceJsonReader, q as openTrace, r as openTraceDirectory, s as openTraceFile, t as openTraceText, u as otlpJsonReader, v as readTrace } from './index-D72DPqAF.js';
+export { P as PROGRAMMATIC_DIAGNOSTIC_SPECS, a as ProgrammaticDiagnosticCode, b as ProgrammaticDiagnosticSpec, f as formatProgrammaticDiagnostic } from './programmatic-gZTWLObB.js';
 import './inspect-event-DRthdZlf.js';
 import './persisted-inspect-event-BVucFVrP.js';
 
 /**
- * Stable programmatic diagnostic codes for readers / TraceFacts / TraceContract.
+ * Version-pinned reader/exporter mapping ledger (6.22).
  *
- * Lowercase `TraceReadError.code` values remain the published reader error codes.
- * These `AI_*` identifiers appear in messages and catalogs for actionable remediation.
+ * Records which external convention version was used and what was lost.
+ * Does not bind persisted schema 1.0 to an unstable external convention.
  *
- * @experimental Additive in 6.15.0; do not replace published lowercase reader codes.
+ * @experimental Available through `agent-inspect/readers`.
  */
-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[];
+type MappingConfidence = "explicit" | "correlated" | "heuristic" | "unknown";
+type MappingLossKind = "none" | "dropped" | "bounded" | "privacy-redacted" | "kind-degraded" | "unsupported";
+/**
+ * One source→target mapping row.
+ *
+ * @experimental
+ */
+interface MappingLedgerEntry {
+    source: string;
+    target: string;
+    transformation: string;
+    confidence: MappingConfidence;
+    loss: MappingLossKind;
+    privacyDecision?: string;
 }
-declare const PROGRAMMATIC_DIAGNOSTIC_SPECS: Readonly<Record<ProgrammaticDiagnosticCode, ProgrammaticDiagnosticSpec>>;
 /**
- * Format `CODE: summary Remediation: …` for thrown errors and diagnostics.
+ * Ledger published by a reader or exporter mapping.
+ *
+ * @experimental
  */
-declare function formatProgrammaticDiagnostic(code: ProgrammaticDiagnosticCode, detail?: string): string;
+interface MappingLedger {
+    id: string;
+    sourceFormat: string;
+    targetFormat: string;
+    /** External convention pin (e.g. OTel GenAI / OpenInference version). */
+    convention?: {
+        name: string;
+        version: string;
+        specUrl?: string;
+    };
+    entries: readonly MappingLedgerEntry[];
+    knownLosses: readonly string[];
+}
+/** OpenInference → AgentInspect mapping ledger pin. */
+declare const OPENINFERENCE_MAPPING_LEDGER: MappingLedger;
+/** OTLP JSON → AgentInspect mapping ledger pin. */
+declare const OTLP_JSON_MAPPING_LEDGER: MappingLedger;
+declare const BUILTIN_MAPPING_LEDGERS: readonly MappingLedger[];
+declare function getMappingLedger(id: string): MappingLedger | undefined;
 
-export { PROGRAMMATIC_DIAGNOSTIC_SPECS, type ProgrammaticDiagnosticCode, type ProgrammaticDiagnosticSpec, formatProgrammaticDiagnostic };
+export { BUILTIN_MAPPING_LEDGERS, type MappingConfidence, type MappingLedger, type MappingLedgerEntry, type MappingLossKind, OPENINFERENCE_MAPPING_LEDGER, OTLP_JSON_MAPPING_LEDGER, getMappingLedger };

package/packages/core/dist/readers.mjs

@@ -1,4 +1,4 @@
-export { DEFAULT_TRACE_READERS, TraceReadError, agentInspectJsonlReader, assertTraceInput, detectTraceFormat, openInferenceJsonReader, openTrace, openTraceDirectory, openTraceFile, openTraceText, otlpJsonReader, readTrace } from './chunk-HT54OLPE.mjs';
+export { BUILTIN_MAPPING_LEDGERS, DEFAULT_TRACE_READERS, OPENINFERENCE_MAPPING_LEDGER, OTLP_JSON_MAPPING_LEDGER, TraceReadError, agentInspectJsonlReader, assertTraceInput, detectTraceFormat, getMappingLedger, openInferenceJsonReader, openTrace, openTraceDirectory, openTraceFile, openTraceText, otlpJsonReader, readTrace } from './chunk-NDRMIL7Z.mjs';
 export { PROGRAMMATIC_DIAGNOSTIC_SPECS, formatProgrammaticDiagnostic } from './chunk-FWK3Q3OJ.mjs';
 import './chunk-NXQF73EC.mjs';
 import './chunk-S4YWKV4G.mjs';

package/packages/core/dist/{types--ainI31J.d.ts → types-Bx3mEZ04.d.ts}

@@ -243,4 +243,4 @@ declare function isStepStatus(value: unknown): value is StepStatus;
  */
 declare function isTraceEvent(value: unknown): value is TraceEvent;
 
-export { type ActiveStepContext as A, type ErrorInfo as E, type InspectRunOptions as I, type ObserveOptions as O, type RedactionProfile as R, type StepOptions as S, type TokenMetadata as T, type Run as a, type RunStatus as b, type Step as c, type StepMetadata as d, type StepStatus as e, type StepType as f, type TraceCorrelationMetadata as g, type TraceEvent as h, type ExecutionContext as i, type RunSummary as j, type TraceMetadata as k, type TraceMetadataStatus as l, type RunCompletedEvent as m, type RunStartedEvent as n, type StepCompletedEvent as o, type StepStartedEvent as p, type TraceEventBase as q, type TraceSchemaVersion as r, isStepStatus as s, isStepType as t, isTraceEvent as u };
+export { type ActiveStepContext as A, type ErrorInfo as E, type InspectRunOptions as I, type ObserveOptions as O, type RedactionProfile as R, type StepOptions as S, type TraceMetadataStatus as T, type Run as a, type RunStatus as b, type Step as c, type StepMetadata as d, type StepStatus as e, type StepType as f, type TokenMetadata as g, type TraceCorrelationMetadata as h, type TraceEvent as i, type ExecutionContext as j, type RunSummary as k, type TraceMetadata as l, type RunCompletedEvent as m, type RunStartedEvent as n, type StepCompletedEvent as o, type StepStartedEvent as p, type TraceEventBase as q, type TraceSchemaVersion as r, isStepStatus as s, isStepType as t, isTraceEvent as u };

package/packages/core/dist/{types-UnrNaTo2.d.cts → types-VzKihKQo.d.cts}

@@ -243,4 +243,4 @@ declare function isStepStatus(value: unknown): value is StepStatus;
  */
 declare function isTraceEvent(value: unknown): value is TraceEvent;
 
-export { type ActiveStepContext as A, type ErrorInfo as E, type InspectRunOptions as I, type ObserveOptions as O, type RedactionProfile as R, type StepOptions as S, type TokenMetadata as T, type Run as a, type RunStatus as b, type Step as c, type StepMetadata as d, type StepStatus as e, type StepType as f, type TraceCorrelationMetadata as g, type TraceEvent as h, type ExecutionContext as i, type RunSummary as j, type TraceMetadata as k, type TraceMetadataStatus as l, type RunCompletedEvent as m, type RunStartedEvent as n, type StepCompletedEvent as o, type StepStartedEvent as p, type TraceEventBase as q, type TraceSchemaVersion as r, isStepStatus as s, isStepType as t, isTraceEvent as u };
+export { type ActiveStepContext as A, type ErrorInfo as E, type InspectRunOptions as I, type ObserveOptions as O, type RedactionProfile as R, type StepOptions as S, type TraceMetadataStatus as T, type Run as a, type RunStatus as b, type Step as c, type StepMetadata as d, type StepStatus as e, type StepType as f, type TokenMetadata as g, type TraceCorrelationMetadata as h, type TraceEvent as i, type ExecutionContext as j, type RunSummary as k, type TraceMetadata as l, type RunCompletedEvent as m, type RunStartedEvent as n, type StepCompletedEvent as o, type StepStartedEvent as p, type TraceEventBase as q, type TraceSchemaVersion as r, isStepStatus as s, isStepType as t, isTraceEvent as u };