agent-inspect 6.21.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';