agent-inspect 1.5.0 → 1.6.0

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

@@ -1,11 +1,15 @@
-import { T as TraceEvent, R as RunSummary, a as TraceMetadata, b as TraceMetadataStatus, S as StepType, c as StepStatus, d as TraceCorrelationMetadata, e as RedactionProfile, I as InspectRunOptions, f as StepOptions, O as ObserveOptions } from './types-CNbheSdk.cjs';
-export { A as ActiveStepContext, E as ErrorInfo, g as ExecutionContext, h as Run, i as RunCompletedEvent, j as RunStartedEvent, k as RunStatus, l as Step, m as StepCompletedEvent, n as StepMetadata, o as StepStartedEvent, p as TokenMetadata, q as TraceEventBase, r as TraceSchemaVersion, s as isStepStatus, t as isStepType, u as isTraceEvent } from './types-CNbheSdk.cjs';
-export { A as AttributionConfidence, E as EventSource, I as InspectEvent, a as InspectKind, b as InspectNode, c as InspectRunTree, L as LogEventMapping, d as LogIngestConfig, R as RedactionRule, e as RedactionStrategy } from './log-config-BzGmDYum.cjs';
-import { PersistedInspectEvent } from './persisted.cjs';
-export { InspectEventToPersistedOptions, PersistedEventSource, PersistedEventSourceType, PersistedEventStatus, PersistedInspectError, PersistedSchemaVersion, PersistedToInspectEventOptions, PersistedToTraceEventOptions, PersistedTokenUsage, PersistedTraceContext, PersistedTreeBridgeOptions, TraceEventToPersistedOptions, inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents, isPersistedInspectEvent, persistedInspectEventToInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, persistedInspectEventsToTraceEvents, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './persisted.cjs';
+import { T as TraceEvent, R as RunSummary, a as TraceMetadata, b as TraceMetadataStatus, S as StepType, c as StepStatus, d as TraceCorrelationMetadata, e as RedactionProfile, I as InspectRunOptions, f as StepOptions, O as ObserveOptions } from './types-DB8jB6Jg.cjs';
+export { A as ActiveStepContext, E as ErrorInfo, g as ExecutionContext, h as Run, i as RunCompletedEvent, j as RunStartedEvent, k as RunStatus, l as Step, m as StepCompletedEvent, n as StepMetadata, o as StepStartedEvent, p as TokenMetadata, q as TraceEventBase, r as TraceSchemaVersion, s as isStepStatus, t as isStepType, u as isTraceEvent } from './types-DB8jB6Jg.cjs';
+export { A as AttributionConfidence, E as EventSource, a as InspectEvent, I as InspectKind, b as InspectNode, c as InspectRunTree } from './inspect-event-Des4JDHo.cjs';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-0kaRADsp.cjs';
+export { a as PersistedEventSource, b as PersistedEventSourceType, c as PersistedEventStatus, d as PersistedInspectError, e as PersistedSchemaVersion, f as PersistedTokenUsage, g as PersistedTraceContext, i as isPersistedInspectEvent } from './persisted-inspect-event-0kaRADsp.cjs';
+export { InspectEventToPersistedOptions, PersistedToInspectEventOptions, PersistedToTraceEventOptions, PersistedTreeBridgeOptions, TraceEventToPersistedOptions, inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents, persistedInspectEventToInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, persistedInspectEventsToTraceEvents, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './persisted.cjs';
+export { L as LogEventMapping, a as LogIngestConfig, R as RedactionRule, b as RedactionStrategy } from './log-config-BnH8Ykcb.cjs';
 export { DEFAULT_LOG_INGEST_CONFIG, DEFAULT_REDACT_KEYS, EventNormalizer, JsonLogParser, LiveLogAccumulator, LiveLogAccumulatorOptions, LiveLogUpdate, Log4jsParser, LogSourceFormat, LogToTreeResult, NormalizeOptions, ParseLogLineOptions, ParseLogsOptions, ParseResult, ParserWarning, ParserWarningCode, RawLogRecord, Redactor, RedactorOptions, RenderTreeOptions, TreeBuilder, TreeBuilderOptions, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './logs.cjs';
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, ResolvedRedactionProfile, TERMINAL_INDENT, TraceSafetyOptions, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn } from './advanced.cjs';
+export { CreateInspectorOptions, DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, Inspector, InspectorCaptureOptions, InspectorObserveOptions, InspectorRunOptions, InspectorRuntime, InspectorRuntimeContext, InspectorRuntimeDiagnostics, InspectorRuntimeOptions, InspectorStepOptions, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, ResolvedRedactionProfile, TERMINAL_INDENT, TraceSafetyOptions, createInspector, createInspectorRuntime, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn } from './advanced.cjs';
 import { Stats } from 'node:fs';
+export { BufferedFileWriterOptions, BufferedFileWriterOverflowMode, CompositeTraceWriterOptions, FileTraceWriterOptions, MemoryTraceWriter, TraceWriter, TraceWriterStats, bufferedFileWriter, compositeWriter, fileWriter, memoryWriter, nullWriter } from './writers.cjs';
+export { DEFAULT_TRACE_READERS, TraceFormatCandidate, TraceFormatDetectionResult, TraceFormatDetectionStatus, TraceInput, TraceReadError, TraceReadErrorCode, TraceReadOptions, TraceReadResult, TraceReadWarning, TraceReadWarningSeverity, TraceReader, TraceReaderDetectOptions, TraceReaderReadOptions, agentInspectJsonlReader, detectTraceFormat, openTrace, readTrace } from './readers.cjs';
 export { DiffKind, DiffOptions, DiffPath, DiffPathSegment, DiffSeverity, RenderDiffOptions, RunComparable, RunDiffItem, RunDiffResult, RunDiffSummary, StepComparable, diffRuns, diffTraceEvents, manualTraceEventsToComparableRun, renderRunDiff } from './diff.cjs';
 export { EXPORT_PAYLOAD_VERSION, ExportFormat, ExportOptions, ExportResult, ExportValidationResult, OpenInferenceExport, OpenInferenceSpan, TraceExporter, compactAttributes, escapeHtml, escapeMarkdown, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, flattenTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, safeString, stableJson, summarizeTree, validateExport, validateExportContent } from './exporters.cjs';
 
@@ -38,13 +42,28 @@ declare function listTraceFiles(traceDir: string): Promise<string[]>;
 declare function getRunIdFromTraceFileName(fileName: string): string | undefined;
 
 type TraceJsonlFormat = "0.1" | "0.2" | "mixed" | "empty";
+type ParsedTraceJsonlRow = {
+    format: "0.1";
+    event: TraceEvent;
+    sourceLine: number;
+} | {
+    format: "0.2";
+    event: PersistedInspectEvent;
+    sourceLine: number;
+};
 interface ParseTraceJsonlResult {
     format: TraceJsonlFormat;
+    /** Count of valid source JSONL rows before any one-to-many normalization. */
+    sourceEventCount: number;
     events: TraceEvent[];
     persisted: PersistedInspectEvent[];
+    /** Valid source rows in JSONL order, before cross-version normalization. */
+    rows: ParsedTraceJsonlRow[];
 }
 interface ParseTraceJsonlOptions {
     validate?: (value: unknown) => value is TraceEvent;
+    /** Emit parse warnings through the standard AgentInspect warning channel (default true). */
+    warnings?: boolean;
 }
 /**
  * Parses JSONL content into normalized v0.1 {@link TraceEvent} rows.
@@ -141,6 +160,8 @@ interface RunWhatSummary {
     totalTokens?: {
         input: number;
         output: number;
+        total?: number;
+        cached?: number;
     };
     correlation?: TraceCorrelationMetadata;
     failedStepNames: string[];

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

@@ -1,11 +1,15 @@
-import { T as TraceEvent, R as RunSummary, a as TraceMetadata, b as TraceMetadataStatus, S as StepType, c as StepStatus, d as TraceCorrelationMetadata, e as RedactionProfile, I as InspectRunOptions, f as StepOptions, O as ObserveOptions } from './types-Bkt7LS01.js';
-export { A as ActiveStepContext, E as ErrorInfo, g as ExecutionContext, h as Run, i as RunCompletedEvent, j as RunStartedEvent, k as RunStatus, l as Step, m as StepCompletedEvent, n as StepMetadata, o as StepStartedEvent, p as TokenMetadata, q as TraceEventBase, r as TraceSchemaVersion, s as isStepStatus, t as isStepType, u as isTraceEvent } from './types-Bkt7LS01.js';
-export { A as AttributionConfidence, E as EventSource, I as InspectEvent, a as InspectKind, b as InspectNode, c as InspectRunTree, L as LogEventMapping, d as LogIngestConfig, R as RedactionRule, e as RedactionStrategy } from './log-config-BzGmDYum.js';
-import { PersistedInspectEvent } from './persisted.js';
-export { InspectEventToPersistedOptions, PersistedEventSource, PersistedEventSourceType, PersistedEventStatus, PersistedInspectError, PersistedSchemaVersion, PersistedToInspectEventOptions, PersistedToTraceEventOptions, PersistedTokenUsage, PersistedTraceContext, PersistedTreeBridgeOptions, TraceEventToPersistedOptions, inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents, isPersistedInspectEvent, persistedInspectEventToInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, persistedInspectEventsToTraceEvents, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './persisted.js';
+import { T as TraceEvent, R as RunSummary, a as TraceMetadata, b as TraceMetadataStatus, S as StepType, c as StepStatus, d as TraceCorrelationMetadata, e as RedactionProfile, I as InspectRunOptions, f as StepOptions, O as ObserveOptions } from './types-tSix7tfv.js';
+export { A as ActiveStepContext, E as ErrorInfo, g as ExecutionContext, h as Run, i as RunCompletedEvent, j as RunStartedEvent, k as RunStatus, l as Step, m as StepCompletedEvent, n as StepMetadata, o as StepStartedEvent, p as TokenMetadata, q as TraceEventBase, r as TraceSchemaVersion, s as isStepStatus, t as isStepType, u as isTraceEvent } from './types-tSix7tfv.js';
+export { A as AttributionConfidence, E as EventSource, a as InspectEvent, I as InspectKind, b as InspectNode, c as InspectRunTree } from './inspect-event-Des4JDHo.js';
+import { P as PersistedInspectEvent } from './persisted-inspect-event-DiFto0K2.js';
+export { a as PersistedEventSource, b as PersistedEventSourceType, c as PersistedEventStatus, d as PersistedInspectError, e as PersistedSchemaVersion, f as PersistedTokenUsage, g as PersistedTraceContext, i as isPersistedInspectEvent } from './persisted-inspect-event-DiFto0K2.js';
+export { InspectEventToPersistedOptions, PersistedToInspectEventOptions, PersistedToTraceEventOptions, PersistedTreeBridgeOptions, TraceEventToPersistedOptions, inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents, persistedInspectEventToInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, persistedInspectEventsToTraceEvents, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './persisted.js';
+export { L as LogEventMapping, a as LogIngestConfig, R as RedactionRule, b as RedactionStrategy } from './log-config-C1GcJPIM.js';
 export { DEFAULT_LOG_INGEST_CONFIG, DEFAULT_REDACT_KEYS, EventNormalizer, JsonLogParser, LiveLogAccumulator, LiveLogAccumulatorOptions, LiveLogUpdate, Log4jsParser, LogSourceFormat, LogToTreeResult, NormalizeOptions, ParseLogLineOptions, ParseLogsOptions, ParseResult, ParserWarning, ParserWarningCode, RawLogRecord, Redactor, RedactorOptions, RenderTreeOptions, TreeBuilder, TreeBuilderOptions, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './logs.js';
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, ResolvedRedactionProfile, TERMINAL_INDENT, TraceSafetyOptions, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn } from './advanced.js';
+export { CreateInspectorOptions, DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, Inspector, InspectorCaptureOptions, InspectorObserveOptions, InspectorRunOptions, InspectorRuntime, InspectorRuntimeContext, InspectorRuntimeDiagnostics, InspectorRuntimeOptions, InspectorStepOptions, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, ResolvedRedactionProfile, TERMINAL_INDENT, TraceSafetyOptions, createInspector, createInspectorRuntime, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, isSilentContext, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, resolveRedactionProfile, resolveTraceSafetyOptions, runWithContext, runWithStepContext, truncateName, warn } from './advanced.js';
 import { Stats } from 'node:fs';
+export { BufferedFileWriterOptions, BufferedFileWriterOverflowMode, CompositeTraceWriterOptions, FileTraceWriterOptions, MemoryTraceWriter, TraceWriter, TraceWriterStats, bufferedFileWriter, compositeWriter, fileWriter, memoryWriter, nullWriter } from './writers.js';
+export { DEFAULT_TRACE_READERS, TraceFormatCandidate, TraceFormatDetectionResult, TraceFormatDetectionStatus, TraceInput, TraceReadError, TraceReadErrorCode, TraceReadOptions, TraceReadResult, TraceReadWarning, TraceReadWarningSeverity, TraceReader, TraceReaderDetectOptions, TraceReaderReadOptions, agentInspectJsonlReader, detectTraceFormat, openTrace, readTrace } from './readers.js';
 export { DiffKind, DiffOptions, DiffPath, DiffPathSegment, DiffSeverity, RenderDiffOptions, RunComparable, RunDiffItem, RunDiffResult, RunDiffSummary, StepComparable, diffRuns, diffTraceEvents, manualTraceEventsToComparableRun, renderRunDiff } from './diff.js';
 export { EXPORT_PAYLOAD_VERSION, ExportFormat, ExportOptions, ExportResult, ExportValidationResult, OpenInferenceExport, OpenInferenceSpan, TraceExporter, compactAttributes, escapeHtml, escapeMarkdown, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, flattenTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, safeString, stableJson, summarizeTree, validateExport, validateExportContent } from './exporters.js';
 
@@ -38,13 +42,28 @@ declare function listTraceFiles(traceDir: string): Promise<string[]>;
 declare function getRunIdFromTraceFileName(fileName: string): string | undefined;
 
 type TraceJsonlFormat = "0.1" | "0.2" | "mixed" | "empty";
+type ParsedTraceJsonlRow = {
+    format: "0.1";
+    event: TraceEvent;
+    sourceLine: number;
+} | {
+    format: "0.2";
+    event: PersistedInspectEvent;
+    sourceLine: number;
+};
 interface ParseTraceJsonlResult {
     format: TraceJsonlFormat;
+    /** Count of valid source JSONL rows before any one-to-many normalization. */
+    sourceEventCount: number;
     events: TraceEvent[];
     persisted: PersistedInspectEvent[];
+    /** Valid source rows in JSONL order, before cross-version normalization. */
+    rows: ParsedTraceJsonlRow[];
 }
 interface ParseTraceJsonlOptions {
     validate?: (value: unknown) => value is TraceEvent;
+    /** Emit parse warnings through the standard AgentInspect warning channel (default true). */
+    warnings?: boolean;
 }
 /**
  * Parses JSONL content into normalized v0.1 {@link TraceEvent} rows.
@@ -141,6 +160,8 @@ interface RunWhatSummary {
     totalTokens?: {
         input: number;
         output: number;
+        total?: number;
+        cached?: number;
     };
     correlation?: TraceCorrelationMetadata;
     failedStepNames: string[];

package/packages/core/dist/index.mjs

@@ -1,19 +1,26 @@
-import { getCurrentContext, warn, createStepId, getCurrentDepth, getParentStepId, getTraceSafetyFromContext, runWithStepContext, formatError, truncateName, getDefaultTraceDir, isTraceEvent, parseDuration, formatTimestamp, formatDuration, readTraceEvents, createRunId, resolveTraceSafetyOptions, runWithContext, getTraceFilePath, prepareTraceEventForDisk, writeTraceEvent, printStepStart, printStepComplete, printError, printFailedAt, initializeTraceFile, printRunStart, printRunComplete } from './chunk-XDBND27A.mjs';
-export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, RUNS_DIR_NAME, TERMINAL_INDENT, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getRunIdFromTraceFileName, getTraceDirFromContext, getTraceFilePath, getTraceSafetyFromContext, hasActiveContext, initializeTraceFile, isSilentContext, isStepStatus, isStepType, isTraceEvent, listTraceFiles, parseDuration, parseTraceJsonl, prepareMetadataForDisk, prepareTraceEventForDisk, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, readTraceEvents, readTraceFile, renderErrorLine, renderRunSummary, renderStepLine, resolveTraceSafetyOptions, runWithContext, runWithStepContext, serializeEvent, truncateName, unknownTraceFormatMessage, validateEvent, warn, writeTraceEvent } from './chunk-XDBND27A.mjs';
-export { inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents, persistedInspectEventToInspectEvent, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './chunk-Q6EPNB3V.mjs';
-import { buildRunStartedMetadata } from './chunk-QX3ZMPUF.mjs';
-export { isPersistedInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToTraceEvents } from './chunk-QX3ZMPUF.mjs';
-export { DEFAULT_LOG_INGEST_CONFIG, EventNormalizer, JsonLogParser, LiveLogAccumulator, Log4jsParser, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './chunk-QPAU2TPA.mjs';
-import './chunk-7TGZLWEE.mjs';
-export { TreeBuilder } from './chunk-E5F2LQCX.mjs';
-import { exportMarkdown, exportHtml, manualTraceEventsToRunTree, redactRunTreeForExport } from './chunk-5EMIZZXD.mjs';
-export { EXPORT_PAYLOAD_VERSION, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, validateExport, validateExportContent } from './chunk-5EMIZZXD.mjs';
-export { resolveRedactionProfile } from './chunk-EDTQHZPM.mjs';
-export { DEFAULT_REDACT_KEYS, Redactor } from './chunk-VU6O5QAH.mjs';
+import { getCurrentContext, getCurrentDepth, getParentStepId, getTraceSafetyFromContext, runWithStepContext, runWithContext, printStepStart, printStepComplete, printError, printFailedAt, printRunStart, printRunComplete } from './chunk-6QSLZCBJ.mjs';
+export { MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, TERMINAL_INDENT, createInspector, createInspectorRuntime, formatTerminalName, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getIndent, getParentStepId, getTraceDirFromContext, getTraceSafetyFromContext, hasActiveContext, isSilentContext, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, runWithContext, runWithStepContext } from './chunk-6QSLZCBJ.mjs';
+export { inspectEventToPersistedInspectEvent, inspectEventsToPersistedInspectEvents } from './chunk-U2BGPESY.mjs';
+export { DEFAULT_LOG_INGEST_CONFIG, EventNormalizer, JsonLogParser, LiveLogAccumulator, Log4jsParser, loadLogIngestConfig, matchMapping, mergeLogIngestConfig, parseLogLine, parseLogsToTrees, renderRunTree, renderRunTrees, wildcardMatch } from './chunk-HR7G62IE.mjs';
+import { redactTraceEventsForReport, exportMarkdown, exportHtml, manualTraceEventsToRunTree, redactRunTreeForExport } from './chunk-Y56BPA3B.mjs';
+export { EXPORT_PAYLOAD_VERSION, exportHtml, exportMarkdown, exportOpenInference, exportOtlpJson, exportRunTree, manualTraceEventsToRunTree, mergeExportDefaults, redactRunTreeForExport, validateExport, validateExportContent } from './chunk-Y56BPA3B.mjs';
 export { diffRuns, diffTraceEvents, manualTraceEventsToComparableRun, renderRunDiff } from './chunk-YWAOOXLR.mjs';
 import './chunk-BT7CATSD.mjs';
 import { escapeMarkdown, escapeHtml } from './chunk-HY7H3CQM.mjs';
 export { compactAttributes, escapeHtml, escapeMarkdown, flattenTree, safeString, stableJson, summarizeTree } from './chunk-HY7H3CQM.mjs';
+export { bufferedFileWriter, compositeWriter, fileWriter, memoryWriter, nullWriter } from './chunk-6SZPTECC.mjs';
+import { readTraceEventsFromFile, resolveTraceSafetyOptions, prepareTraceEventForDisk, writeTraceEvent, initializeTraceFile } from './chunk-57S5D6HR.mjs';
+export { DEFAULT_MAX_EVENT_BYTES, DEFAULT_MAX_METADATA_VALUE_LENGTH, DEFAULT_MAX_PREVIEW_LENGTH, getRunIdFromTraceFileName, initializeTraceFile, listTraceFiles, prepareMetadataForDisk, prepareTraceEventForDisk, readTraceEvents, readTraceFile, resolveTraceSafetyOptions, serializeEvent, validateEvent, writeTraceEvent } from './chunk-57S5D6HR.mjs';
+export { resolveRedactionProfile } from './chunk-EDTQHZPM.mjs';
+export { DEFAULT_REDACT_KEYS, Redactor } from './chunk-VU6O5QAH.mjs';
+export { DEFAULT_TRACE_READERS, TraceReadError, agentInspectJsonlReader, detectTraceFormat, openTrace, readTrace } from './chunk-TFLPUZ56.mjs';
+export { persistedInspectEventToInspectEvent, persistedInspectEventsToInspectEvents, persistedInspectEventsToRunTrees, traceEventToPersistedInspectEvent, traceEventsToPersistedInspectEvents, traceEventsToPersistedRunTrees } from './chunk-TZISEVLQ.mjs';
+import { buildRunStartedMetadata } from './chunk-S4YWKV4G.mjs';
+export { TreeBuilder } from './chunk-E5F2LQCX.mjs';
+import { warn, createStepId, formatError, truncateName, getDefaultTraceDir, parseTraceJsonl, parseDuration, formatTimestamp, formatDuration, isTraceEvent, createRunId, getTraceFilePath } from './chunk-VTIB5MDK.mjs';
+export { DEFAULT_TRACE_DIR_NAME, FALLBACK_TRACE_DIR, MAX_NAME_LENGTH, RUNS_DIR_NAME, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTimestamp, getDefaultTraceDir, getTraceFilePath, isStepStatus, isStepType, isTraceEvent, parseDuration, parseTraceJsonl, truncateName, unknownTraceFormatMessage, warn } from './chunk-VTIB5MDK.mjs';
+export { isPersistedInspectEvent, persistedInspectEventToTraceEvents, persistedInspectEventsToTraceEvents } from './chunk-74XZ6N7Q.mjs';
+import './chunk-7TGZLWEE.mjs';
 import { readdir, stat, readFile } from 'fs/promises';
 import path from 'path';
 import { createReadStream } from 'fs';
@@ -55,12 +62,10 @@ var TraceDirectory = class {
 function isFiniteNumber(v) {
   return typeof v === "number" && Number.isFinite(v);
 }
-function safeParseJson(line) {
-  try {
-    return JSON.parse(line);
-  } catch {
-    return void 0;
-  }
+function parseIsoToMs(value) {
+  if (value === void 0) return void 0;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : void 0;
 }
 async function extractMetadata(filePath, _quickScan) {
   const stats = await stat(filePath);
@@ -69,8 +74,7 @@ async function extractMetadata(filePath, _quickScan) {
     runIdFromFile = runIdFromFile.slice(0, -".jsonl".length);
   }
   const raw = await readFile(filePath, "utf-8");
-  const lines = raw.split(/\r?\n/);
-  let eventCount = 0;
+  const parsedTrace = parseTraceJsonl(raw, { warnings: false });
   let runId;
   let name;
   let startedAt;
@@ -80,16 +84,32 @@ async function extractMetadata(filePath, _quickScan) {
   let hasRunCompleted = false;
   let runCompletedStatus;
   let anyStepError = false;
-  let anyKnownEvent = false;
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (trimmed === "") continue;
-    const parsed = safeParseJson(trimmed);
-    if (!parsed) continue;
-    if (!isTraceEvent(parsed)) continue;
-    const e = parsed;
-    anyKnownEvent = true;
-    eventCount += 1;
+  const anyKnownEvent = parsedTrace.sourceEventCount > 0;
+  let persistedStatus;
+  const persistedRun = parsedTrace.persisted.find(
+    (event) => event.kind === "RUN"
+  );
+  if (persistedRun) {
+    runId = persistedRun.runId;
+    if (persistedRun.name.trim() !== "") {
+      name = persistedRun.name;
+    }
+    startedAt = parseIsoToMs(persistedRun.startedAt) ?? parseIsoToMs(persistedRun.timestamp);
+    endedAt = parseIsoToMs(persistedRun.endedAt);
+    if (isFiniteNumber(persistedRun.durationMs)) {
+      explicitDurationMs = persistedRun.durationMs;
+      if (endedAt === void 0 && startedAt !== void 0) {
+        endedAt = startedAt + persistedRun.durationMs;
+      }
+    }
+    if (persistedRun.status === "ok") persistedStatus = "success";
+    else if (persistedRun.status === "error") persistedStatus = "error";
+    else if (persistedRun.status === "running") persistedStatus = "running";
+    else if (persistedRun.status === "unknown") persistedStatus = "unknown";
+  } else {
+    runId = parsedTrace.persisted[0]?.runId;
+  }
+  for (const e of parsedTrace.events) {
     if (runId === void 0 && typeof e.runId === "string") {
       runId = e.runId;
     }
@@ -126,6 +146,8 @@ async function extractMetadata(filePath, _quickScan) {
     status = runCompletedStatus;
   } else if (anyStepError) {
     status = "error";
+  } else if (persistedStatus !== void 0) {
+    status = persistedStatus;
   } else if (hasRunStarted && !hasRunCompleted) {
     status = "running";
   } else if (anyKnownEvent) {
@@ -141,12 +163,15 @@ async function extractMetadata(filePath, _quickScan) {
     startedAt,
     endedAt,
     durationMs,
-    eventCount,
+    eventCount: parsedTrace.sourceEventCount,
     filePath,
     fileSize: stats.size,
     createdAt: stats.birthtime
   };
 }
+function isNonNegativeFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
 function buildRunSummary(events) {
   const started = events.find(
     (e) => e.event === "run_started"
@@ -169,8 +194,10 @@ function buildRunSummary(events) {
         name: s.name,
         status: "running",
         parentId: s.parentId,
-        tokensInput: typeof s.metadata?.tokens?.input === "number" ? s.metadata.tokens.input : void 0,
-        tokensOutput: typeof s.metadata?.tokens?.output === "number" ? s.metadata.tokens.output : void 0
+        tokensInput: isNonNegativeFiniteNumber(s.metadata?.tokens?.input) ? s.metadata.tokens.input : void 0,
+        tokensOutput: isNonNegativeFiniteNumber(s.metadata?.tokens?.output) ? s.metadata.tokens.output : void 0,
+        tokensTotal: isNonNegativeFiniteNumber(s.metadata?.tokens?.total) ? s.metadata.tokens.total : void 0,
+        tokensCached: isNonNegativeFiniteNumber(s.metadata?.tokens?.cached) ? s.metadata.tokens.cached : void 0
       });
     }
   }
@@ -192,7 +219,11 @@ function buildRunSummary(events) {
   let longestStep;
   let totalTokensInput = 0;
   let totalTokensOutput = 0;
-  let hasAnyTokens = false;
+  let totalTokensTotal = 0;
+  let totalTokensCached = 0;
+  let tokenBearingSteps = 0;
+  let stepsWithKnownTotal = 0;
+  let hasCachedTokens = false;
   const depthCache = /* @__PURE__ */ new Map();
   const computeDepth = (stepId) => {
     const cached = depthCache.get(stepId);
@@ -221,10 +252,21 @@ function buildRunSummary(events) {
         longestStep = { name: s.name, durationMs: s.durationMs, type: s.type };
       }
     }
-    if (typeof s.tokensInput === "number" || typeof s.tokensOutput === "number") {
-      hasAnyTokens = true;
-      if (typeof s.tokensInput === "number") totalTokensInput += s.tokensInput;
-      if (typeof s.tokensOutput === "number") totalTokensOutput += s.tokensOutput;
+    if (s.tokensInput !== void 0 || s.tokensOutput !== void 0 || s.tokensTotal !== void 0 || s.tokensCached !== void 0) {
+      tokenBearingSteps += 1;
+      if (s.tokensInput !== void 0) totalTokensInput += s.tokensInput;
+      if (s.tokensOutput !== void 0) totalTokensOutput += s.tokensOutput;
+      if (s.tokensTotal !== void 0) {
+        totalTokensTotal += s.tokensTotal;
+        stepsWithKnownTotal += 1;
+      } else if (s.tokensInput !== void 0 && s.tokensOutput !== void 0) {
+        totalTokensTotal += s.tokensInput + s.tokensOutput;
+        stepsWithKnownTotal += 1;
+      }
+      if (s.tokensCached !== void 0) {
+        totalTokensCached += s.tokensCached;
+        hasCachedTokens = true;
+      }
     }
   }
   const summary = {
@@ -239,7 +281,14 @@ function buildRunSummary(events) {
     errorSteps,
     maxDepth,
     ...longestStep ? { longestStep } : {},
-    ...hasAnyTokens ? { totalTokens: { input: totalTokensInput, output: totalTokensOutput } } : {}
+    ...tokenBearingSteps > 0 ? {
+      totalTokens: {
+        input: totalTokensInput,
+        output: totalTokensOutput,
+        ...stepsWithKnownTotal === tokenBearingSteps ? { total: totalTokensTotal } : {},
+        ...hasCachedTokens ? { cached: totalTokensCached } : {}
+      }
+    } : {}
   };
   return summary;
 }
@@ -544,9 +593,17 @@ function renderRunWhat(summary, options = {}) {
     `Status: ${summary.status} \xB7 Duration: ${duration} \xB7 Steps: ${summary.totalSteps} (${stepMixLine(summary)})`
   );
   if (summary.totalTokens) {
-    lines.push(
-      `Tokens: ${summary.totalTokens.input} in / ${summary.totalTokens.output} out`
-    );
+    const tokenParts = [
+      `${summary.totalTokens.input} in`,
+      `${summary.totalTokens.output} out`
+    ];
+    if (summary.totalTokens.total !== void 0) {
+      tokenParts.push(`${summary.totalTokens.total} total`);
+    }
+    if (summary.totalTokens.cached !== void 0) {
+      tokenParts.push(`${summary.totalTokens.cached} cached`);
+    }
+    lines.push(`Tokens: ${tokenParts.join(" / ")}`);
   }
   if (showCorrelation && summary.correlation) {
     const parts = [];
@@ -609,12 +666,15 @@ footer{margin-top:2rem;font-size:0.85rem;color:#555}
 `.trim();
 function buildRunReport(events, options) {
   const profile = options.redactionProfile ?? "local";
-  const whatSummary = buildRunWhatSummary(events);
+  const safeEvents = redactTraceEventsForReport(events, {
+    redactionProfile: profile
+  });
+  const whatSummary = buildRunWhatSummary(safeEvents);
   const whatText = renderRunWhat(whatSummary, {
     correlation: options.correlation !== false
   });
-  const timelineText = renderTimeline(buildRunTimeline(events));
-  const tree = resolveTree(events, profile);
+  const timelineText = renderTimeline(buildRunTimeline(safeEvents));
+  const tree = resolveTree(safeEvents, profile);
   const exportOpts = {
     includeMetadata: false,
     includeAttributes: options.includeAttributes === true,
@@ -696,6 +756,8 @@ ${attrsSection}
     fileExtension: ".html"
   };
 }
+
+// packages/core/src/stats.ts
 function percentile(sorted, p) {
   if (sorted.length === 0) return void 0;
   const idx = Math.min(
@@ -706,19 +768,10 @@ function percentile(sorted, p) {
 }
 async function readRunStartedMetadata(filePath) {
   try {
-    const raw = await readFile(filePath, "utf-8");
-    for (const line of raw.split(/\r?\n/)) {
-      const trimmed = line.trim();
-      if (trimmed === "") continue;
-      let parsed;
-      try {
-        parsed = JSON.parse(trimmed);
-      } catch {
-        continue;
-      }
-      if (!isTraceEvent(parsed)) continue;
-      if (parsed.event !== "run_started") continue;
-      const rs = parsed;
+    const events = await readTraceEventsFromFile(filePath);
+    for (const event of events) {
+      if (event.event !== "run_started") continue;
+      const rs = event;
       if (rs.metadata && typeof rs.metadata === "object") {
         return rs.metadata;
       }
@@ -777,7 +830,7 @@ async function buildTraceStats(metas, options) {
       });
     }
     try {
-      const events = await readTraceEvents(m.runId, options.traceDir);
+      const events = await readTraceEventsFromFile(m.filePath);
       if (events.length === 0) continue;
       const summary = buildRunSummary(events);
       totalSteps += summary.totalSteps;
@@ -965,7 +1018,7 @@ async function searchTraces(metas, options) {
     if (options.status && m.status !== options.status) continue;
     let events = [];
     try {
-      events = await readTraceEvents(m.runId, options.traceDir);
+      events = await readTraceEventsFromFile(m.filePath);
     } catch {
       continue;
     }