agent-inspect 1.9.0 → 2.1.0

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

@@ -1,339 +1,10 @@
-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-Ap9uMdx_.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-Ap9uMdx_.js';
-import { a as InspectRunTree } from './inspect-event-CevRYp58.js';
-export { A as AttributionConfidence, E as EventSource, c as InspectEvent, I as InspectKind, b as InspectNode } from './inspect-event-CevRYp58.js';
-import { P as PersistedInspectEvent } from './persisted-inspect-event-Cw7TeYGr.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-Cw7TeYGr.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-BPHS4Sds.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 { 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';
-
-/**
- * Strict MVP validation before writing JSONL. Rejects empty ids, non-finite times, and malformed payloads.
- */
-declare function validateEvent(event: unknown): event is TraceEvent;
-/** Serializes a trace line as compact JSON without a trailing newline. */
-declare function serializeEvent(event: TraceEvent): string;
-/**
- * Creates (or truncates) an empty JSONL file for a run. Uses {@link ensureTraceDir} then {@link getTraceFilePath}.
- * On failure, retries once under {@link FALLBACK_TRACE_DIR}.
- */
-declare function initializeTraceFile(runId: string, traceDir: string): Promise<string | undefined>;
-declare function writeTraceEvent(event: TraceEvent, traceDir: string): Promise<void>;
-/**
- * Reads raw JSONL file contents for a run, or `undefined` if missing or unreadable.
- */
-declare function readTraceFile(runId: string, traceDir: string): Promise<string | undefined>;
-/**
- * Parses JSONL into validated {@link TraceEvent} rows (v0.1 native or v0.2 normalized).
- * Invalid lines are skipped with a warning.
- */
-declare function readTraceEvents(runId: string, traceDir: string): Promise<TraceEvent[]>;
-/**
- * Lists `.jsonl` file names in `traceDir`, newest by mtime first (name sort as tie-breaker).
- */
-declare function listTraceFiles(traceDir: string): Promise<string[]>;
-/** Maps a `.jsonl` file name to its run id (basename only; no traversal). */
-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.
- * Accepts homogenous v0.1 or v0.2 files; mixed files are converted with a warning.
- */
-declare function parseTraceJsonl(raw: string, options?: ParseTraceJsonlOptions): ParseTraceJsonlResult;
-/**
- * Returns a user-facing message when a trace file uses an unsupported schema version.
- */
-declare function unknownTraceFormatMessage(): string;
-
-interface TraceDirectoryOptions {
-    dir?: string;
-}
-declare function resolveTraceDir(options?: TraceDirectoryOptions): string;
-declare class TraceDirectory {
-    #private;
-    constructor(options?: TraceDirectoryOptions);
-    getPath(filename?: string): string;
-    list(): Promise<string[]>;
-    getFileStats(filename: string): Promise<Stats>;
-}
-
-declare function extractMetadata(filePath: string, _quickScan?: boolean): Promise<TraceMetadata>;
-declare function buildRunSummary(events: TraceEvent[]): RunSummary;
-
-interface TraceFilterOptions {
-    status?: TraceMetadataStatus;
-    name?: string;
-    since?: string;
-    limit?: number;
-}
-declare function filterTraces(traces: TraceMetadata[], options: TraceFilterOptions): TraceMetadata[];
-
-type TimelineFocus = "all" | "slow";
-interface TimelineEntry {
-    stepId: string;
-    name: string;
-    type: StepType;
-    status: StepStatus;
-    depth: number;
-    startedAt: number;
-    offsetMs: number;
-    durationMs?: number;
-    isError: boolean;
-    slow?: boolean;
-    streaming?: {
-        chunkCount?: number;
-        streamDurationMs?: number;
-        streamedCharCount?: number;
-    };
-}
-interface RunTimeline {
-    runId: string;
-    name?: string;
-    status: TraceMetadataStatus;
-    startedAt?: number;
-    endedAt?: number;
-    durationMs?: number;
-    correlation?: {
-        correlationId?: string;
-        requestId?: string;
-        decisionId?: string;
-        groupId?: string;
-    };
-    entries: TimelineEntry[];
-}
-interface TimelineOptions {
-    focus?: TimelineFocus;
-    slowTopN?: number;
-}
-declare function buildRunTimeline(events: TraceEvent[], options?: TimelineOptions): RunTimeline;
-interface RenderTimelineOptions {
-    focus?: TimelineFocus;
-}
-declare function renderTimeline(timeline: RunTimeline, options?: RenderTimelineOptions): string;
-
-interface RunWhatSummary {
-    runId: string;
-    name?: string;
-    status: TraceMetadataStatus;
-    durationMs?: number;
-    totalSteps: number;
-    llmSteps: number;
-    toolSteps: number;
-    logicSteps: number;
-    errorSteps: number;
-    maxDepth: number;
-    longestStep?: {
-        name: string;
-        durationMs: number;
-        type: string;
-    };
-    totalTokens?: {
-        input: number;
-        output: number;
-        total?: number;
-        cached?: number;
-    };
-    correlation?: TraceCorrelationMetadata;
-    failedStepNames: string[];
-    runErrorMessage?: string;
-}
-/**
- * Build a concise inspection summary for `what` / report workflows.
- * Read-only over in-memory v0.1 {@link TraceEvent} rows.
- */
-declare function buildRunWhatSummary(events: TraceEvent[]): RunWhatSummary;
-interface RenderWhatOptions {
-    /** Include correlation ids when present (default true). */
-    correlation?: boolean;
-}
-/**
- * Render a human-readable `what` summary (plain text, no ANSI).
- */
-declare function renderRunWhat(summary: RunWhatSummary, options?: RenderWhatOptions): string;
-
-type ReportFormat = "markdown" | "html";
-interface ReportOptions {
-    format: ReportFormat;
-    includeAttributes?: boolean;
-    includeErrors?: boolean;
-    redactionProfile?: RedactionProfile;
-    /** Include correlation ids in the what section (default true). */
-    correlation?: boolean;
-}
-interface ReportResult {
-    format: ReportFormat;
-    content: string;
-    contentType: string;
-    fileExtension: string;
-}
-/**
- * Build a local inspection report (markdown or HTML) from v0.1 trace events.
- * Composes `what`, timeline, and execution-tree sections.
- */
-declare function buildRunReport(events: TraceEvent[], options: ReportOptions): ReportResult;
-
-type ExplainMode = "dry-run" | "local";
-interface ExplainFact {
-    id: string;
-    label: string;
-    value: unknown;
-    source: "trace";
-    confidence: "observed";
-}
-interface ExplainInference {
-    id: string;
-    label: string;
-    text: string;
-    evidence: string[];
-    confidence: "deterministic";
-}
-interface ExplainResult {
-    mode: ExplainMode;
-    runId: string;
-    name?: string;
-    status?: string;
-    redactionProfile: RedactionProfile;
-    facts: ExplainFact[];
-    inferences: ExplainInference[];
-    notes: string[];
-}
-interface ExplainOptions {
-    mode?: ExplainMode;
-    redactionProfile?: RedactionProfile;
-}
-/**
- * Build a local, deterministic explanation payload from a reader-selected run.
- *
- * This helper performs no network I/O and does not call a model provider.
- */
-declare function buildLocalExplanation(run: InspectRunTree, options?: ExplainOptions): ExplainResult;
-
-interface DurationStats {
-    minMs?: number;
-    maxMs?: number;
-    avgMs?: number;
-    p50Ms?: number;
-    p95Ms?: number;
-}
-interface TraceStatsRankedRun {
-    runId: string;
-    name?: string;
-    durationMs?: number;
-    status: string;
-}
-interface TraceStatsRankedStep {
-    runId: string;
-    stepName: string;
-    stepType: string;
-    durationMs: number;
-}
-interface TraceStats {
-    traceDir: string;
-    since?: string;
-    correlationId?: string;
-    groupId?: string;
-    totalRuns: number;
-    successCount: number;
-    errorCount: number;
-    runningCount: number;
-    unknownCount: number;
-    errorRate: number;
-    duration: DurationStats;
-    totalSteps: number;
-    avgStepsPerRun: number;
-    totalLlmSteps: number;
-    totalToolSteps: number;
-    totalErrorSteps: number;
-    slowestRuns: TraceStatsRankedRun[];
-    slowestSteps: TraceStatsRankedStep[];
-}
-interface TraceStatsOptions {
-    traceDir: string;
-    since?: string;
-    correlationId?: string;
-    groupId?: string;
-    slowRunLimit?: number;
-    slowStepLimit?: number;
-}
-declare function buildTraceStats(metas: TraceMetadata[], options: TraceStatsOptions): Promise<TraceStats>;
-declare function renderTraceStats(stats: TraceStats): string;
-
-interface TraceSearchOptions {
-    traceDir: string;
-    since?: string;
-    status?: "success" | "error" | "running" | "unknown";
-    kind?: string;
-    type?: string;
-    name?: string;
-    tool?: string;
-    duration?: string;
-    limit?: number;
-}
-interface TraceSearchResult {
-    runId: string;
-    runName?: string;
-    runStatus: string;
-    stepId?: string;
-    stepName?: string;
-    stepType?: string;
-    timestamp?: number;
-    durationMs?: number;
-    matchReason: string;
-    matchedFields: string[];
-    filePath: string;
-}
-interface ParsedDurationFilter {
-    op: ">" | ">=" | "<" | "<=";
-    ms: number;
-}
-declare function parseDurationFilter(expr: string): ParsedDurationFilter;
-declare function searchTraces(metas: TraceMetadata[], options: TraceSearchOptions): Promise<TraceSearchResult[]>;
-declare function loadTraceMetadataList(_traceDir: string, fileNames: string[], getPath: (fileName: string) => string): Promise<TraceMetadata[]>;
-
-/**
- * Safety check for cleanup workflows: returns true only when the file appears to be an AgentInspect trace.
- * This should be conservative: false positives are more dangerous than false negatives.
- */
-declare function isAgentInspectTrace(filePath: string): Promise<boolean>;
-
-/**
- * v0.2 shared duration utilities.
- *
- * `parseDuration` is used for filters such as "since" / "older-than".
- * `formatDuration` is used for compact display in CLI and summaries.
- */
-declare function parseDuration(duration: string): number;
+import { I as InspectRunOptions, S as StepOptions, O as ObserveOptions } from './types-D-Y1kOU-.js';
+export { E as ErrorInfo, R as RedactionProfile, a as Run, b as RunStatus, c as Step, d as StepMetadata, e as StepStatus, f as StepType, T as TokenMetadata, g as TraceCorrelationMetadata } from './types-D-Y1kOU-.js';
+export { C as CreateInspectorOptions, I as Inspector, a as InspectorCaptureOptions, b as InspectorObserveOptions, c as InspectorRunOptions, d as InspectorStepOptions, e as createInspector, g as getCurrentCorrelationMetadata, m as maybeInspectRun } from './context-yv2VSDQF.js';
+import './log-config-DVimQJho.js';
+import './inspect-event-CevRYp58.js';
+import './persisted-inspect-event-D-WpXeZX.js';
+import './writers.js';
 
 /**
  * Stable v1.0 API for local manual run tracing.
@@ -343,19 +14,6 @@ declare function parseDuration(duration: string): number;
  */
 declare function inspectRun<T>(name: string, fn: () => Promise<T> | T, options?: InspectRunOptions): Promise<T>;
 
-/**
- * Returns true when `value` is one of the recognized AGENT_INSPECT enable tokens
- * (`1`, `true`, `yes`, `on`, `enabled`, case-insensitive). Undefined or any other value is false.
- */
-declare function isAgentInspectEnabled(value?: string): boolean;
-/**
- * Runs `fn` with tracing when enabled; otherwise passthrough (no trace file, no context).
- *
- * Enablement order: explicit `options.enabled` wins; when omitted, reads `process.env.AGENT_INSPECT`.
- * Unset or unrecognized env values disable tracing.
- */
-declare function maybeInspectRun<T>(name: string, fn: () => Promise<T> | T, options?: InspectRunOptions): Promise<T>;
-
 /**
  * Stable v1.0 API for instrumenting a named step inside an AgentInspect run.
  *
@@ -384,4 +42,4 @@ declare const step: StepFunction;
  */
 declare function observe<T>(agent: T, options?: ObserveOptions): T;
 
-export { type DurationStats, type ExplainFact, type ExplainInference, type ExplainMode, type ExplainOptions, type ExplainResult, InspectRunOptions, InspectRunTree, ObserveOptions, type ParseTraceJsonlOptions, type ParseTraceJsonlResult, type ParsedDurationFilter, PersistedInspectEvent, RedactionProfile, type RenderTimelineOptions, type RenderWhatOptions, type ReportFormat, type ReportOptions, type ReportResult, RunSummary, type RunTimeline, type RunWhatSummary, StepOptions, StepStatus, StepType, type TimelineEntry, type TimelineFocus, type TimelineOptions, TraceCorrelationMetadata, TraceDirectory, type TraceDirectoryOptions, TraceEvent, type TraceFilterOptions, type TraceJsonlFormat, TraceMetadata, TraceMetadataStatus, type TraceSearchOptions, type TraceSearchResult, type TraceStats, type TraceStatsOptions, type TraceStatsRankedRun, type TraceStatsRankedStep, buildLocalExplanation, buildRunReport, buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildTraceStats, extractMetadata, filterTraces, getRunIdFromTraceFileName, initializeTraceFile, inspectRun, isAgentInspectEnabled, isAgentInspectTrace, listTraceFiles, loadTraceMetadataList, maybeInspectRun, observe, parseDuration, parseDurationFilter, parseTraceJsonl, readTraceEvents, readTraceFile, renderRunWhat, renderTimeline, renderTraceStats, resolveTraceDir, searchTraces, serializeEvent, step, unknownTraceFormatMessage, validateEvent, writeTraceEvent };
+export { InspectRunOptions, ObserveOptions, StepOptions, inspectRun, observe, step };