agent-inspect 4.1.0 → 4.3.0

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

@@ -462,6 +462,47 @@ interface CriticalPathStep {
     source: SessionEdgeSource;
     confidence: SessionConfidence;
 }
+/** Session lifecycle status (v4.2 RFC). */
+type SessionStatus = "running" | "waiting_input" | "idle" | "completed" | "error" | "stale" | "unknown";
+interface SessionLastError {
+    runId: string;
+    message: string;
+    code?: string;
+}
+interface SessionCheckSummary {
+    pass: number;
+    fail: number;
+    warn: number;
+}
+interface EnrichSessionSummaryOptions {
+    /** Reference clock for staleness (default Date.now()). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (default 24h). */
+    staleThresholdMs?: number;
+}
+interface ActivityEntry {
+    sessionId: string;
+    status: SessionStatus;
+    summary: string;
+    lastActivity: string;
+    runCount: number;
+}
+interface ActivitySummary {
+    since: string;
+    sessions: number;
+    failed: number;
+    stale: number;
+    guardrailWarnings: number;
+    entries: ActivityEntry[];
+}
+interface BuildActivitySummaryOptions {
+    /** Duration window (e.g. 7d, 24h). Default 7d. */
+    since?: string;
+    /** Reference clock (default Date.now()). */
+    nowMs?: number;
+    /** Max entries returned (default 20). */
+    limit?: number;
+}
 interface SessionSummary {
     sessionId: string;
     runIds: string[];
@@ -469,6 +510,23 @@ interface SessionSummary {
     handoffs: HandoffEdge[];
     retries: RetryLink[];
     criticalPath: CriticalPathStep[];
+    /** Derived session status (v4.2+). */
+    status: SessionStatus;
+    /** Earliest run start time in the session. */
+    startedAt?: number;
+    /** Latest run end time when all runs have ended. */
+    endedAt?: number;
+    /** endedAt - startedAt when both are present. */
+    durationMs?: number;
+    correlationId?: string;
+    jobId?: string;
+    workflowId?: string;
+    lastError?: SessionLastError;
+    /** ISO-8601 timestamp of the most recent run activity. */
+    lastActivity: string;
+    retryCount: number;
+    observationSummary?: string;
+    checkSummary?: SessionCheckSummary;
 }
 interface SessionIndex {
     runs: SessionRunRecord[];
@@ -479,6 +537,10 @@ interface SessionIndex {
 interface BuildSessionIndexOptions {
     /** When true, group runs that share only `groupId` under a synthetic session key. */
     correlateByGroupId?: boolean;
+    /** Reference clock for session staleness (v4.2+). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (v4.2+, default 24h). */
+    staleThresholdMs?: number;
 }
 
 /** Extracts session/workflow metadata from a run metadata or attributes bag. */
@@ -487,6 +549,22 @@ declare function sessionKeyForRun(meta: SessionWorkflowMetadata | undefined, opt
     correlateByGroupId?: boolean;
 }): string | undefined;
 
+/** Derives session status from run records per the v4.2 RFC (no timestamp-only causality). */
+declare function deriveSessionStatus(runs: readonly SessionRunRecord[], options?: EnrichSessionSummaryOptions): SessionStatus;
+/**
+ * Enriches a session summary with v4.2 derived fields (status, timing, errors).
+ * Pure function; does not read trace files.
+ */
+declare function enrichSessionSummary(summary: Omit<SessionSummary, "status" | "lastActivity" | "retryCount" | "startedAt" | "endedAt" | "durationMs" | "correlationId" | "jobId" | "workflowId" | "lastError" | "observationSummary" | "checkSummary">, runs: readonly SessionRunRecord[], options?: EnrichSessionSummaryOptions): SessionSummary;
+
+/**
+ * Builds a deterministic activity summary from a session index (v4.2).
+ * Read-only; does not mutate traces or invent relationships.
+ */
+declare function buildActivitySummary(index: SessionIndex, options?: BuildActivitySummaryOptions): ActivitySummary;
+/** Renders a human activity summary for terminal output. */
+declare function renderActivitySummaryHuman(summary: ActivitySummary): string;
+
 /** Enriches trace metadata with run_started metadata for session indexing. */
 declare function enrichSessionRunRecord(meta: TraceMetadata): Promise<SessionRunRecord>;
 /** Builds session run records from extracted trace metadata rows. */
@@ -565,4 +643,96 @@ declare function isAgentInspectTrace(filePath: string): Promise<boolean>;
  */
 declare function parseDuration(duration: string): number;
 
-export { type BuildSessionIndexOptions, type CriticalPathStep, DEFAULT_TRACE_DIR_NAME, type DurationStats, ErrorInfo, type ExplainFact, type ExplainInference, type ExplainMode, type ExplainOptions, type ExplainResult, FALLBACK_TRACE_DIR, type GroupSessionCohortsOptions, type HandoffEdge, InspectRunTree, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, type ParseTraceJsonlOptions, type ParseTraceJsonlResult, type ParsedDurationFilter, RUNS_DIR_NAME, RedactionProfile, type RenderTimelineOptions, type RenderWhatOptions, type ResolvedRedactionProfile, type RetryLink, RunStatus, RunSummary, type RunTimeline, type RunWhatSummary, SESSION_WORKFLOW_KEYS, type SessionCohort, type SessionCohortKind, type SessionConfidence, type SessionEdgeSource, type SessionGroup, type SessionIndex, type SessionRunRecord, type SessionScopeOptions, type SessionScopeResult, type SessionSummary, type SessionWarning, type SessionWorkflowKey, type SessionWorkflowMetadata, StepStatus, StepType, TERMINAL_INDENT, type TimelineEntry, type TimelineFocus, type TimelineOptions, TraceCorrelationMetadata, TraceDirectory, type TraceDirectoryOptions, TraceEvent, type TraceFilterOptions, type TraceJsonlFormat, TraceMetadata, TraceMetadataStatus, type TraceSearchOptions, type TraceSearchResult, type TraceSessionCheckResult, type TraceStats, type TraceStatsOptions, type TraceStatsRankedRun, type TraceStatsRankedStep, aggregateSessionCheckResults, buildLocalExplanation, buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildSessionIndex, buildTraceStats, createRunId, createStepId, enrichSessionRunRecord, ensureTraceDir, extractMetadata, extractSessionWorkflowMetadata, filterMetasBySessionScope, filterTraces, formatDuration, formatError, formatTerminalName, formatTimestamp, getDefaultTraceDir, getIndent, getRunIdFromTraceFileName, getTraceFilePath, groupSessionCohorts, initializeTraceFile, isAgentInspectTrace, listTraceFiles, loadSessionRunRecords, loadTraceMetadataList, parseDuration, parseDurationFilter, parseTraceJsonl, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, readTraceEvents, readTraceFile, renderErrorLine, renderRunSummary, renderRunWhat, renderStepLine, renderTimeline, renderTraceStats, resolveRedactionProfile, resolveTraceDir, searchTraces, serializeEvent, sessionKeyForRun, traceMetasToSessionRunRecords, truncateName, unknownTraceFormatMessage, validateEvent, warn, writeTraceEvent };
+/** Aggregate verify-safe status for a bundle. */
+type BundleSafeStatus = "SAFE" | "SAFE WITH WARNINGS" | "UNSAFE" | "UNKNOWN";
+/** Metadata-safe status (underscore form). */
+type BundleSafeStatusMetadata = "SAFE" | "SAFE_WITH_WARNINGS" | "UNSAFE" | "UNKNOWN";
+type BundleRedactionProfile = "local" | "share" | "strict";
+interface BundleMetadata {
+    createdAt: string;
+    agentInspectVersion: string;
+    redactionProfile: BundleRedactionProfile;
+    sourceTraceCount: number;
+    runIds: string[];
+    safeStatus: BundleSafeStatusMetadata;
+    files: string[];
+    note: string;
+    sessionId?: string;
+    since?: string;
+}
+interface BundleRedactionReportRun {
+    runId: string;
+    findings: number;
+    detectors: string[];
+}
+interface BundleRedactionReport {
+    profile: BundleRedactionProfile;
+    totalFindings: number;
+    runs: BundleRedactionReportRun[];
+}
+interface BundleCheckRunResult {
+    runId: string;
+    status: BundleSafeStatus;
+    errors: number;
+    warnings: number;
+    findings: number;
+}
+interface BundleCheckResults {
+    aggregateStatus: BundleSafeStatus;
+    runs: BundleCheckRunResult[];
+}
+interface BundleResolveOptions {
+    runId?: string;
+    sessionId?: string;
+    since?: string;
+}
+interface BundleResolveResult {
+    runIds: string[];
+    sessionId?: string;
+    since?: string;
+}
+interface BundlePlaceholderArtifact {
+    status: "not_requested";
+    note: string;
+}
+
+/**
+ * Resolves which run ids belong in a bundle.
+ *
+ * @throws when target mode is missing, ambiguous, or yields zero runs.
+ */
+declare function resolveBundleRunIds(index: SessionIndex, runs: readonly SessionRunRecord[], options: BundleResolveOptions): BundleResolveResult;
+
+declare function buildBundleMetadata(parts: {
+    agentInspectVersion: string;
+    profile: BundleRedactionProfile;
+    resolve: BundleResolveResult;
+    checks: BundleCheckResults;
+    files: string[];
+    createdAt?: string;
+}): BundleMetadata;
+declare function buildPlaceholderArtifact(): BundlePlaceholderArtifact;
+
+/**
+ * Builds a human-readable bundle summary for `summary.md`.
+ */
+declare function buildBundleSummaryMarkdown(parts: {
+    metadata: BundleMetadata;
+    checks: BundleCheckResults;
+    redaction: BundleRedactionReport;
+}): string;
+
+declare function aggregateBundleSafeStatus(statuses: readonly BundleSafeStatus[]): BundleSafeStatus;
+declare function toMetadataSafeStatus(status: BundleSafeStatus): BundleSafeStatusMetadata;
+declare function bundleFailsOnSafety(status: BundleSafeStatus, allowUnsafe: boolean): boolean;
+
+/**
+ * Normalizes bundle output path. Strips a `.zip` suffix (folder-first MVP).
+ */
+declare function normalizeBundleOutputPath(out: string): string;
+/**
+ * Default bundle directory when --out is omitted.
+ */
+declare function defaultBundleOutputPath(runIds: readonly string[]): string;
+
+export { type ActivityEntry, type ActivitySummary, type BuildActivitySummaryOptions, type BuildSessionIndexOptions, type BundleCheckResults, type BundleCheckRunResult, type BundleMetadata, type BundlePlaceholderArtifact, type BundleRedactionProfile, type BundleRedactionReport, type BundleRedactionReportRun, type BundleResolveOptions, type BundleResolveResult, type BundleSafeStatus, type BundleSafeStatusMetadata, type CriticalPathStep, DEFAULT_TRACE_DIR_NAME, type DurationStats, type EnrichSessionSummaryOptions, ErrorInfo, type ExplainFact, type ExplainInference, type ExplainMode, type ExplainOptions, type ExplainResult, FALLBACK_TRACE_DIR, type GroupSessionCohortsOptions, type HandoffEdge, InspectRunTree, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, type ParseTraceJsonlOptions, type ParseTraceJsonlResult, type ParsedDurationFilter, RUNS_DIR_NAME, RedactionProfile, type RenderTimelineOptions, type RenderWhatOptions, type ResolvedRedactionProfile, type RetryLink, RunStatus, RunSummary, type RunTimeline, type RunWhatSummary, SESSION_WORKFLOW_KEYS, type SessionCheckSummary, type SessionCohort, type SessionCohortKind, type SessionConfidence, type SessionEdgeSource, type SessionGroup, type SessionIndex, type SessionLastError, type SessionRunRecord, type SessionScopeOptions, type SessionScopeResult, type SessionStatus, type SessionSummary, type SessionWarning, type SessionWorkflowKey, type SessionWorkflowMetadata, StepStatus, StepType, TERMINAL_INDENT, type TimelineEntry, type TimelineFocus, type TimelineOptions, TraceCorrelationMetadata, TraceDirectory, type TraceDirectoryOptions, TraceEvent, type TraceFilterOptions, type TraceJsonlFormat, TraceMetadata, TraceMetadataStatus, type TraceSearchOptions, type TraceSearchResult, type TraceSessionCheckResult, type TraceStats, type TraceStatsOptions, type TraceStatsRankedRun, type TraceStatsRankedStep, aggregateBundleSafeStatus, aggregateSessionCheckResults, buildActivitySummary, buildBundleMetadata, buildBundleSummaryMarkdown, buildLocalExplanation, buildPlaceholderArtifact, buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildSessionIndex, buildTraceStats, bundleFailsOnSafety, createRunId, createStepId, defaultBundleOutputPath, deriveSessionStatus, enrichSessionRunRecord, enrichSessionSummary, ensureTraceDir, extractMetadata, extractSessionWorkflowMetadata, filterMetasBySessionScope, filterTraces, formatDuration, formatError, formatTerminalName, formatTimestamp, getDefaultTraceDir, getIndent, getRunIdFromTraceFileName, getTraceFilePath, groupSessionCohorts, initializeTraceFile, isAgentInspectTrace, listTraceFiles, loadSessionRunRecords, loadTraceMetadataList, normalizeBundleOutputPath, parseDuration, parseDurationFilter, parseTraceJsonl, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, readTraceEvents, readTraceFile, renderActivitySummaryHuman, renderErrorLine, renderRunSummary, renderRunWhat, renderStepLine, renderTimeline, renderTraceStats, resolveBundleRunIds, resolveRedactionProfile, resolveTraceDir, searchTraces, serializeEvent, sessionKeyForRun, toMetadataSafeStatus, traceMetasToSessionRunRecords, truncateName, unknownTraceFormatMessage, validateEvent, warn, writeTraceEvent };

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

@@ -462,6 +462,47 @@ interface CriticalPathStep {
     source: SessionEdgeSource;
     confidence: SessionConfidence;
 }
+/** Session lifecycle status (v4.2 RFC). */
+type SessionStatus = "running" | "waiting_input" | "idle" | "completed" | "error" | "stale" | "unknown";
+interface SessionLastError {
+    runId: string;
+    message: string;
+    code?: string;
+}
+interface SessionCheckSummary {
+    pass: number;
+    fail: number;
+    warn: number;
+}
+interface EnrichSessionSummaryOptions {
+    /** Reference clock for staleness (default Date.now()). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (default 24h). */
+    staleThresholdMs?: number;
+}
+interface ActivityEntry {
+    sessionId: string;
+    status: SessionStatus;
+    summary: string;
+    lastActivity: string;
+    runCount: number;
+}
+interface ActivitySummary {
+    since: string;
+    sessions: number;
+    failed: number;
+    stale: number;
+    guardrailWarnings: number;
+    entries: ActivityEntry[];
+}
+interface BuildActivitySummaryOptions {
+    /** Duration window (e.g. 7d, 24h). Default 7d. */
+    since?: string;
+    /** Reference clock (default Date.now()). */
+    nowMs?: number;
+    /** Max entries returned (default 20). */
+    limit?: number;
+}
 interface SessionSummary {
     sessionId: string;
     runIds: string[];
@@ -469,6 +510,23 @@ interface SessionSummary {
     handoffs: HandoffEdge[];
     retries: RetryLink[];
     criticalPath: CriticalPathStep[];
+    /** Derived session status (v4.2+). */
+    status: SessionStatus;
+    /** Earliest run start time in the session. */
+    startedAt?: number;
+    /** Latest run end time when all runs have ended. */
+    endedAt?: number;
+    /** endedAt - startedAt when both are present. */
+    durationMs?: number;
+    correlationId?: string;
+    jobId?: string;
+    workflowId?: string;
+    lastError?: SessionLastError;
+    /** ISO-8601 timestamp of the most recent run activity. */
+    lastActivity: string;
+    retryCount: number;
+    observationSummary?: string;
+    checkSummary?: SessionCheckSummary;
 }
 interface SessionIndex {
     runs: SessionRunRecord[];
@@ -479,6 +537,10 @@ interface SessionIndex {
 interface BuildSessionIndexOptions {
     /** When true, group runs that share only `groupId` under a synthetic session key. */
     correlateByGroupId?: boolean;
+    /** Reference clock for session staleness (v4.2+). */
+    nowMs?: number;
+    /** Inactivity threshold before marking a session stale (v4.2+, default 24h). */
+    staleThresholdMs?: number;
 }
 
 /** Extracts session/workflow metadata from a run metadata or attributes bag. */
@@ -487,6 +549,22 @@ declare function sessionKeyForRun(meta: SessionWorkflowMetadata | undefined, opt
     correlateByGroupId?: boolean;
 }): string | undefined;
 
+/** Derives session status from run records per the v4.2 RFC (no timestamp-only causality). */
+declare function deriveSessionStatus(runs: readonly SessionRunRecord[], options?: EnrichSessionSummaryOptions): SessionStatus;
+/**
+ * Enriches a session summary with v4.2 derived fields (status, timing, errors).
+ * Pure function; does not read trace files.
+ */
+declare function enrichSessionSummary(summary: Omit<SessionSummary, "status" | "lastActivity" | "retryCount" | "startedAt" | "endedAt" | "durationMs" | "correlationId" | "jobId" | "workflowId" | "lastError" | "observationSummary" | "checkSummary">, runs: readonly SessionRunRecord[], options?: EnrichSessionSummaryOptions): SessionSummary;
+
+/**
+ * Builds a deterministic activity summary from a session index (v4.2).
+ * Read-only; does not mutate traces or invent relationships.
+ */
+declare function buildActivitySummary(index: SessionIndex, options?: BuildActivitySummaryOptions): ActivitySummary;
+/** Renders a human activity summary for terminal output. */
+declare function renderActivitySummaryHuman(summary: ActivitySummary): string;
+
 /** Enriches trace metadata with run_started metadata for session indexing. */
 declare function enrichSessionRunRecord(meta: TraceMetadata): Promise<SessionRunRecord>;
 /** Builds session run records from extracted trace metadata rows. */
@@ -565,4 +643,96 @@ declare function isAgentInspectTrace(filePath: string): Promise<boolean>;
  */
 declare function parseDuration(duration: string): number;
 
-export { type BuildSessionIndexOptions, type CriticalPathStep, DEFAULT_TRACE_DIR_NAME, type DurationStats, ErrorInfo, type ExplainFact, type ExplainInference, type ExplainMode, type ExplainOptions, type ExplainResult, FALLBACK_TRACE_DIR, type GroupSessionCohortsOptions, type HandoffEdge, InspectRunTree, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, type ParseTraceJsonlOptions, type ParseTraceJsonlResult, type ParsedDurationFilter, RUNS_DIR_NAME, RedactionProfile, type RenderTimelineOptions, type RenderWhatOptions, type ResolvedRedactionProfile, type RetryLink, RunStatus, RunSummary, type RunTimeline, type RunWhatSummary, SESSION_WORKFLOW_KEYS, type SessionCohort, type SessionCohortKind, type SessionConfidence, type SessionEdgeSource, type SessionGroup, type SessionIndex, type SessionRunRecord, type SessionScopeOptions, type SessionScopeResult, type SessionSummary, type SessionWarning, type SessionWorkflowKey, type SessionWorkflowMetadata, StepStatus, StepType, TERMINAL_INDENT, type TimelineEntry, type TimelineFocus, type TimelineOptions, TraceCorrelationMetadata, TraceDirectory, type TraceDirectoryOptions, TraceEvent, type TraceFilterOptions, type TraceJsonlFormat, TraceMetadata, TraceMetadataStatus, type TraceSearchOptions, type TraceSearchResult, type TraceSessionCheckResult, type TraceStats, type TraceStatsOptions, type TraceStatsRankedRun, type TraceStatsRankedStep, aggregateSessionCheckResults, buildLocalExplanation, buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildSessionIndex, buildTraceStats, createRunId, createStepId, enrichSessionRunRecord, ensureTraceDir, extractMetadata, extractSessionWorkflowMetadata, filterMetasBySessionScope, filterTraces, formatDuration, formatError, formatTerminalName, formatTimestamp, getDefaultTraceDir, getIndent, getRunIdFromTraceFileName, getTraceFilePath, groupSessionCohorts, initializeTraceFile, isAgentInspectTrace, listTraceFiles, loadSessionRunRecords, loadTraceMetadataList, parseDuration, parseDurationFilter, parseTraceJsonl, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, readTraceEvents, readTraceFile, renderErrorLine, renderRunSummary, renderRunWhat, renderStepLine, renderTimeline, renderTraceStats, resolveRedactionProfile, resolveTraceDir, searchTraces, serializeEvent, sessionKeyForRun, traceMetasToSessionRunRecords, truncateName, unknownTraceFormatMessage, validateEvent, warn, writeTraceEvent };
+/** Aggregate verify-safe status for a bundle. */
+type BundleSafeStatus = "SAFE" | "SAFE WITH WARNINGS" | "UNSAFE" | "UNKNOWN";
+/** Metadata-safe status (underscore form). */
+type BundleSafeStatusMetadata = "SAFE" | "SAFE_WITH_WARNINGS" | "UNSAFE" | "UNKNOWN";
+type BundleRedactionProfile = "local" | "share" | "strict";
+interface BundleMetadata {
+    createdAt: string;
+    agentInspectVersion: string;
+    redactionProfile: BundleRedactionProfile;
+    sourceTraceCount: number;
+    runIds: string[];
+    safeStatus: BundleSafeStatusMetadata;
+    files: string[];
+    note: string;
+    sessionId?: string;
+    since?: string;
+}
+interface BundleRedactionReportRun {
+    runId: string;
+    findings: number;
+    detectors: string[];
+}
+interface BundleRedactionReport {
+    profile: BundleRedactionProfile;
+    totalFindings: number;
+    runs: BundleRedactionReportRun[];
+}
+interface BundleCheckRunResult {
+    runId: string;
+    status: BundleSafeStatus;
+    errors: number;
+    warnings: number;
+    findings: number;
+}
+interface BundleCheckResults {
+    aggregateStatus: BundleSafeStatus;
+    runs: BundleCheckRunResult[];
+}
+interface BundleResolveOptions {
+    runId?: string;
+    sessionId?: string;
+    since?: string;
+}
+interface BundleResolveResult {
+    runIds: string[];
+    sessionId?: string;
+    since?: string;
+}
+interface BundlePlaceholderArtifact {
+    status: "not_requested";
+    note: string;
+}
+
+/**
+ * Resolves which run ids belong in a bundle.
+ *
+ * @throws when target mode is missing, ambiguous, or yields zero runs.
+ */
+declare function resolveBundleRunIds(index: SessionIndex, runs: readonly SessionRunRecord[], options: BundleResolveOptions): BundleResolveResult;
+
+declare function buildBundleMetadata(parts: {
+    agentInspectVersion: string;
+    profile: BundleRedactionProfile;
+    resolve: BundleResolveResult;
+    checks: BundleCheckResults;
+    files: string[];
+    createdAt?: string;
+}): BundleMetadata;
+declare function buildPlaceholderArtifact(): BundlePlaceholderArtifact;
+
+/**
+ * Builds a human-readable bundle summary for `summary.md`.
+ */
+declare function buildBundleSummaryMarkdown(parts: {
+    metadata: BundleMetadata;
+    checks: BundleCheckResults;
+    redaction: BundleRedactionReport;
+}): string;
+
+declare function aggregateBundleSafeStatus(statuses: readonly BundleSafeStatus[]): BundleSafeStatus;
+declare function toMetadataSafeStatus(status: BundleSafeStatus): BundleSafeStatusMetadata;
+declare function bundleFailsOnSafety(status: BundleSafeStatus, allowUnsafe: boolean): boolean;
+
+/**
+ * Normalizes bundle output path. Strips a `.zip` suffix (folder-first MVP).
+ */
+declare function normalizeBundleOutputPath(out: string): string;
+/**
+ * Default bundle directory when --out is omitted.
+ */
+declare function defaultBundleOutputPath(runIds: readonly string[]): string;
+
+export { type ActivityEntry, type ActivitySummary, type BuildActivitySummaryOptions, type BuildSessionIndexOptions, type BundleCheckResults, type BundleCheckRunResult, type BundleMetadata, type BundlePlaceholderArtifact, type BundleRedactionProfile, type BundleRedactionReport, type BundleRedactionReportRun, type BundleResolveOptions, type BundleResolveResult, type BundleSafeStatus, type BundleSafeStatusMetadata, type CriticalPathStep, DEFAULT_TRACE_DIR_NAME, type DurationStats, type EnrichSessionSummaryOptions, ErrorInfo, type ExplainFact, type ExplainInference, type ExplainMode, type ExplainOptions, type ExplainResult, FALLBACK_TRACE_DIR, type GroupSessionCohortsOptions, type HandoffEdge, InspectRunTree, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, type ParseTraceJsonlOptions, type ParseTraceJsonlResult, type ParsedDurationFilter, RUNS_DIR_NAME, RedactionProfile, type RenderTimelineOptions, type RenderWhatOptions, type ResolvedRedactionProfile, type RetryLink, RunStatus, RunSummary, type RunTimeline, type RunWhatSummary, SESSION_WORKFLOW_KEYS, type SessionCheckSummary, type SessionCohort, type SessionCohortKind, type SessionConfidence, type SessionEdgeSource, type SessionGroup, type SessionIndex, type SessionLastError, type SessionRunRecord, type SessionScopeOptions, type SessionScopeResult, type SessionStatus, type SessionSummary, type SessionWarning, type SessionWorkflowKey, type SessionWorkflowMetadata, StepStatus, StepType, TERMINAL_INDENT, type TimelineEntry, type TimelineFocus, type TimelineOptions, TraceCorrelationMetadata, TraceDirectory, type TraceDirectoryOptions, TraceEvent, type TraceFilterOptions, type TraceJsonlFormat, TraceMetadata, TraceMetadataStatus, type TraceSearchOptions, type TraceSearchResult, type TraceSessionCheckResult, type TraceStats, type TraceStatsOptions, type TraceStatsRankedRun, type TraceStatsRankedStep, aggregateBundleSafeStatus, aggregateSessionCheckResults, buildActivitySummary, buildBundleMetadata, buildBundleSummaryMarkdown, buildLocalExplanation, buildPlaceholderArtifact, buildRunSummary, buildRunTimeline, buildRunWhatSummary, buildSessionIndex, buildTraceStats, bundleFailsOnSafety, createRunId, createStepId, defaultBundleOutputPath, deriveSessionStatus, enrichSessionRunRecord, enrichSessionSummary, ensureTraceDir, extractMetadata, extractSessionWorkflowMetadata, filterMetasBySessionScope, filterTraces, formatDuration, formatError, formatTerminalName, formatTimestamp, getDefaultTraceDir, getIndent, getRunIdFromTraceFileName, getTraceFilePath, groupSessionCohorts, initializeTraceFile, isAgentInspectTrace, listTraceFiles, loadSessionRunRecords, loadTraceMetadataList, normalizeBundleOutputPath, parseDuration, parseDurationFilter, parseTraceJsonl, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, readTraceEvents, readTraceFile, renderActivitySummaryHuman, renderErrorLine, renderRunSummary, renderRunWhat, renderStepLine, renderTimeline, renderTraceStats, resolveBundleRunIds, resolveRedactionProfile, resolveTraceDir, searchTraces, serializeEvent, sessionKeyForRun, toMetadataSafeStatus, traceMetasToSessionRunRecords, truncateName, unknownTraceFormatMessage, validateEvent, warn, writeTraceEvent };