agent-inspect 6.14.2 → 6.16.0

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

@@ -1,80 +1,29 @@
-import { a as InspectRunTree } from './inspect-event-DRthdZlf.cjs';
-import { P as PersistedInspectEvent } from './persisted-inspect-event-CVZWZldL.cjs';
+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, T as TraceReadResult, a 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-B259NKkH.cjs';
+import './inspect-event-DRthdZlf.cjs';
+import './persisted-inspect-event-CVZWZldL.cjs';
 
-type TraceInput = {
-    type: "file";
-    path: string;
-} | {
-    type: "directory";
-    path: string;
-} | {
-    type: "string";
-    content: string;
-} | {
-    type: "buffer";
-    content: Buffer;
-} | {
-    type: "stdin";
-};
-type TraceReadWarningSeverity = "info" | "warning" | "error";
-interface TraceReadWarning {
-    code: string;
-    message: string;
-    severity?: TraceReadWarningSeverity;
-    sourceFile?: string;
-    line?: number;
-    field?: string;
-}
-interface TraceReadResult {
-    format: string;
-    events: PersistedInspectEvent[];
-    runs: InspectRunTree[];
-    warnings: TraceReadWarning[];
-    unsupportedFields: string[];
-    sourceFiles: string[];
-}
-interface TraceFormatCandidate {
-    format: string;
-    confidence: number;
-    readerName?: string;
-    description?: string;
-    warnings?: TraceReadWarning[];
-}
-type TraceFormatDetectionStatus = "detected" | "ambiguous" | "unsupported";
-interface TraceFormatDetectionResult {
-    status: TraceFormatDetectionStatus;
-    format?: string;
-    candidates: TraceFormatCandidate[];
-    warnings: TraceReadWarning[];
-}
-interface TraceReaderDetectOptions {
-    format?: string;
-}
-interface TraceReaderReadOptions {
-    format?: string;
-}
-interface TraceReader {
-    readonly format: string;
-    readonly name?: string;
-    detect(input: TraceInput, options?: TraceReaderDetectOptions): TraceFormatCandidate | undefined | Promise<TraceFormatCandidate | undefined>;
-    read(input: TraceInput, options?: TraceReaderReadOptions): TraceReadResult | Promise<TraceReadResult>;
-}
-interface TraceReadOptions {
-    format?: string;
-    readers?: readonly TraceReader[];
-}
-type TraceReadErrorCode = "unsupported_format" | "ambiguous_format" | "reader_failed";
-declare class TraceReadError extends Error {
-    readonly code: TraceReadErrorCode;
-    readonly warnings: TraceReadWarning[];
-    constructor(code: TraceReadErrorCode, message: string, warnings?: TraceReadWarning[]);
-}
-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>;
+/**
+ * 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 { DEFAULT_TRACE_READERS, type TraceFormatCandidate, type TraceFormatDetectionResult, type TraceFormatDetectionStatus, type TraceInput, TraceReadError, type TraceReadErrorCode, type TraceReadOptions, type TraceReadResult, type TraceReadWarning, type TraceReadWarningSeverity, type TraceReader, type TraceReaderDetectOptions, type TraceReaderReadOptions, agentInspectJsonlReader, detectTraceFormat, openInferenceJsonReader, openTrace, otlpJsonReader, readTrace };
+export { PROGRAMMATIC_DIAGNOSTIC_SPECS, type ProgrammaticDiagnosticCode, type ProgrammaticDiagnosticSpec, formatProgrammaticDiagnostic };

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

@@ -1,80 +1,29 @@
-import { a as InspectRunTree } from './inspect-event-DRthdZlf.js';
-import { P as PersistedInspectEvent } from './persisted-inspect-event-BVucFVrP.js';
+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, T as TraceReadResult, a 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-B9ZGvUVL.js';
+import './inspect-event-DRthdZlf.js';
+import './persisted-inspect-event-BVucFVrP.js';
 
-type TraceInput = {
-    type: "file";
-    path: string;
-} | {
-    type: "directory";
-    path: string;
-} | {
-    type: "string";
-    content: string;
-} | {
-    type: "buffer";
-    content: Buffer;
-} | {
-    type: "stdin";
-};
-type TraceReadWarningSeverity = "info" | "warning" | "error";
-interface TraceReadWarning {
-    code: string;
-    message: string;
-    severity?: TraceReadWarningSeverity;
-    sourceFile?: string;
-    line?: number;
-    field?: string;
-}
-interface TraceReadResult {
-    format: string;
-    events: PersistedInspectEvent[];
-    runs: InspectRunTree[];
-    warnings: TraceReadWarning[];
-    unsupportedFields: string[];
-    sourceFiles: string[];
-}
-interface TraceFormatCandidate {
-    format: string;
-    confidence: number;
-    readerName?: string;
-    description?: string;
-    warnings?: TraceReadWarning[];
-}
-type TraceFormatDetectionStatus = "detected" | "ambiguous" | "unsupported";
-interface TraceFormatDetectionResult {
-    status: TraceFormatDetectionStatus;
-    format?: string;
-    candidates: TraceFormatCandidate[];
-    warnings: TraceReadWarning[];
-}
-interface TraceReaderDetectOptions {
-    format?: string;
-}
-interface TraceReaderReadOptions {
-    format?: string;
-}
-interface TraceReader {
-    readonly format: string;
-    readonly name?: string;
-    detect(input: TraceInput, options?: TraceReaderDetectOptions): TraceFormatCandidate | undefined | Promise<TraceFormatCandidate | undefined>;
-    read(input: TraceInput, options?: TraceReaderReadOptions): TraceReadResult | Promise<TraceReadResult>;
-}
-interface TraceReadOptions {
-    format?: string;
-    readers?: readonly TraceReader[];
-}
-type TraceReadErrorCode = "unsupported_format" | "ambiguous_format" | "reader_failed";
-declare class TraceReadError extends Error {
-    readonly code: TraceReadErrorCode;
-    readonly warnings: TraceReadWarning[];
-    constructor(code: TraceReadErrorCode, message: string, warnings?: TraceReadWarning[]);
-}
-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>;
+/**
+ * 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 { DEFAULT_TRACE_READERS, type TraceFormatCandidate, type TraceFormatDetectionResult, type TraceFormatDetectionStatus, type TraceInput, TraceReadError, type TraceReadErrorCode, type TraceReadOptions, type TraceReadResult, type TraceReadWarning, type TraceReadWarningSeverity, type TraceReader, type TraceReaderDetectOptions, type TraceReaderReadOptions, agentInspectJsonlReader, detectTraceFormat, openInferenceJsonReader, openTrace, otlpJsonReader, readTrace };
+export { PROGRAMMATIC_DIAGNOSTIC_SPECS, type ProgrammaticDiagnosticCode, type ProgrammaticDiagnosticSpec, formatProgrammaticDiagnostic };

package/packages/core/dist/readers.mjs

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