@tangle-network/traces 0.19.1 → 0.21.0

package/dist/cli.js

@@ -2,8 +2,11 @@
 import {
   DEFAULT_ANALYST_MODEL,
   DEFAULT_QUESTION_MAX_COST_USD,
+  DEFAULT_QUESTION_TIMEOUT_MS,
   DEFAULT_SANDBOX_BASE_URL,
+  DEFAULT_SWEEP_THRESHOLD,
   MAX_TRACE_QUESTION_CHARS,
+  SkillUsageStore,
   analysisEngineFromEnv,
   appendAll,
   assembleSessionBundle,
@@ -12,12 +15,14 @@ import {
   buildPolicyEvidenceRecord,
   buildSessionFactsReport,
   buildSessionIndexFromRows,
+  buildSkillUsageReport,
   cmdReplayVerify,
   cmdReplayVerifyBatch,
   cmdVerifyFindings,
   collectSessionSelection,
   commandAnalyzer,
   commandRedactor,
+  defaultSkillUsageStorePath,
   diffRuns,
   executeUpload,
   exportTraceEvidenceFile,
@@ -45,6 +50,7 @@ import {
   planUpload,
   primeAnalyzer,
   projectSessionBundle,
+  readInstalledSkills,
   readJsonl,
   readOtlpInput,
   readSessionIndexFile,
@@ -52,6 +58,7 @@ import {
   renderInspectionReport,
   renderRunDiff,
   renderSessionFacts,
+  renderSkillUsage,
   renderValidation,
   resolveAdapter,
   resolveRunWatchTarget,
@@ -83,7 +90,7 @@ import {
   writeSessionIndexFile,
   writeTraceEvidenceExportFile,
   writeTraceQuestionsArtifacts
-} from "./chunk-YVCHWHCA.js";
+} from "./chunk-KEB25UHZ.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";
@@ -584,6 +591,9 @@ function parseArgs(argv) {
       case "--question-budget":
         a.questionBudget = Number(next());
         break;
+      case "--question-timeout":
+        a.questionTimeout = Number(next());
+        break;
       case "--redactor":
         a.redactorCmd = next();
         break;
@@ -1517,9 +1527,14 @@ async function cmdAsk(args) {
   if (args.budget !== void 0 && (!Number.isFinite(args.budget) || args.budget <= 0)) {
     throw new Error("--budget must be a positive number of USD");
   }
+  const questionTimeoutMs = args.questionTimeout === void 0 ? void 0 : Math.round(args.questionTimeout * 1e3);
+  if (questionTimeoutMs !== void 0 && (!Number.isSafeInteger(questionTimeoutMs) || questionTimeoutMs < 1e3)) {
+    throw new Error("--question-timeout must be a number of seconds, at least 1");
+  }
   const engine = analysisEngineFromEnv({
     model: analystModelFor(args),
     maxCostUsd: args.questionBudget ?? Math.min(args.budget ?? Infinity, DEFAULT_QUESTION_MAX_COST_USD),
+    ...questionTimeoutMs !== void 0 ? { timeoutMs: questionTimeoutMs } : {},
     log: analystLog
   });
   const collected = await collectSpans(args);
@@ -1840,6 +1855,65 @@ async function cmdVerifySafe(argv) {
 `);
   process.exitCode = verdictExitCode(result);
 }
+async function cmdSkills(argv) {
+  let since;
+  let format = "text";
+  let unusedOnly = false;
+  let refresh = true;
+  let storePath = defaultSkillUsageStorePath();
+  let sweepThreshold = DEFAULT_SWEEP_THRESHOLD;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--since") since = parseSince(argv[++i] ?? "");
+    else if (arg === "--format") format = argv[++i] ?? "";
+    else if (arg === "--unused") unusedOnly = true;
+    else if (arg === "--no-refresh") refresh = false;
+    else if (arg === "--store") storePath = argv[++i] ?? "";
+    else if (arg === "--sweep") sweepThreshold = Number(argv[++i]);
+    else if (arg === "--help" || arg === "-h") {
+      usageSkills();
+      return;
+    } else throw new Error(`skills: unknown argument ${arg}`);
+  }
+  if (format !== "json" && format !== "text") throw new Error(`skills: --format must be json or text, got "${format}"`);
+  if (!storePath) throw new Error("skills: --store needs a path");
+  if (!Number.isInteger(sweepThreshold) || sweepThreshold < 1) throw new Error("skills: --sweep must be a positive integer");
+  const store = await SkillUsageStore.load(storePath);
+  const refreshed = refresh ? await store.refresh() : null;
+  if (refreshed) await store.save();
+  const report = buildSkillUsageReport(store.list(), await readInstalledSkills(), storePath, { since, sweepThreshold, refresh: refreshed });
+  if (unusedOnly) {
+    if (format === "json") process.stdout.write(`${JSON.stringify(report.unused, null, 2)}
+`);
+    else for (const skill of report.unused) process.stdout.write(`${skill.skill}	${skill.installedIn.join(",")}
+`);
+    return;
+  }
+  process.stdout.write(format === "json" ? `${JSON.stringify(report, null, 2)}
+` : `${renderSkillUsage(report)}
+`);
+}
+function usageSkills() {
+  console.log(`traces skills [--since 30d|ISO] [--format text|json] [--unused] [--no-refresh] [--store PATH] [--sweep N]
+
+Count skill use across Claude Code, Codex, and Kimi Code sessions on this machine, with no
+model call. Each run reads only transcript bytes appended since the previous run and
+keeps the events in a store (default ${defaultSkillUsageStorePath()}), so counts
+survive a harness deleting old transcripts.
+
+  model   Claude Code Skill tool calls that loaded a skill
+  slash   Claude Code /name commands that expanded to a skill or prompt
+  read    Codex or Kimi commands that successfully read <skill>/SKILL.md
+
+--since       count events at or after 30m / 2h / 7d or an ISO date (default: all stored)
+--unused      print only installed skills with no use in the window
+--no-refresh  answer from the store without reading transcripts
+--store       store path
+--sweep       one Codex or Kimi command reading N or more skills is a catalog sweep, not use;
+              its reads are excluded and counted separately (default ${DEFAULT_SWEEP_THRESHOLD})
+
+OpenCode, Pi, Gemini and other harnesses are not indexed.`);
+}
 function usageVerifySafe() {
   console.log(`traces verify-safe <file|dir> [--profile default|share|strict] [--known-secret-env NAME]... [--format text|json]
 
@@ -1980,6 +2054,10 @@ Commands:
             No model call, no budget, $0. Every fact names the span ids it came
             from; a fact the spans cannot support is null with its reason.
             --format json (default) or text (exit 1 when a session cannot be read)
+  skills    Count skill use across Claude Code, Codex, and Kimi Code sessions on this
+            machine, and list installed skills with no use in the window.
+            Incremental: a run reads only transcript bytes appended since the
+            last run. No model call. traces skills --help
   convert   Emit OTLP-JSONL only, to --otlp-out (HALO: use analyze --analyzer halo)
   index     Emit a reusable session index JSON for later investigation
   bundle    Assemble one session's durable evidence directory: transcript +
@@ -2092,6 +2170,9 @@ Options:
   --question-budget <usd>
                    ask: provider ceiling for one question (default: the smaller
                    of --budget and $${DEFAULT_QUESTION_MAX_COST_USD})
+  --question-timeout <seconds>
+                   ask: wall-clock deadline for one question's investigation
+                   (default: ${DEFAULT_QUESTION_TIMEOUT_MS / 1e3})
   --concurrency <n> ask: questions running at once (default 4);
                    import-codetracebench: trajectories imported at once
   --analyzer <id>  analyze: also run halo, hodoscope, prime, or an installed command (repeatable);
@@ -2167,6 +2248,10 @@ async function main() {
     await cmdVerifySafe(rawArgs.slice(1));
     return;
   }
+  if (rawArgs[0] === "skills") {
+    await cmdSkills(rawArgs.slice(1));
+    return;
+  }
   const parsedArgs = parseArgs(rawArgs);
   if (parsedArgs.help) {
     if (parsedArgs.command === "import-codetracebench" || parsedArgs.command === "help" && parsedArgs.input === "import-codetracebench") usageImportCodeTraceBench();

package/dist/index.d.ts

@@ -1313,6 +1313,17 @@ declare class CodexAdapter implements HarnessTraceAdapter {
  * user prompt. Callers select it explicitly with `--session`; event order is
  * preserved with `step`, and missing timestamps use the source file mtime
  * without inventing durations.
+ *
+ * The same events also arrive wrapped in a Tangle Sandbox live stream
+ * (`retained-execution-*.jsonl`): `{ id, type: 'raw', data: { backend:
+ * 'codex', event }, at }` beside the sandbox's own status, heartbeat, and
+ * message events. The adapter reads `data.event` from Codex raw envelopes,
+ * ignores every other envelope, and uses `at` (the sandbox's receipt time)
+ * when the Codex event has no timestamp of its own.
+ *
+ * A stream that is still being written ends inside a turn. That turn, and any
+ * item it started without completing, are emitted with status UNSET and an
+ * `in_progress` marker, so a live session can be analyzed before it settles.
  */
 
 declare class CodexExecStreamError extends Error {
@@ -1451,6 +1462,26 @@ declare class PiAdapter implements HarnessTraceAdapter {
     parse(ref: SessionRef, options?: ParseOptions): Promise<OtlpSpan[]>;
 }
 
+type SupportedHarness = 'claude-code' | 'codex' | 'opencode' | 'pi' | 'kimi-code' | 'factory-droids';
+/** The compatibility boundary between traces' session selection and the shared native reader. */
+declare class HarnessSessionsAdapter implements HarnessTraceAdapter {
+    readonly nativeHarness: SupportedHarness;
+    readonly harness: string;
+    readonly aliases: readonly string[];
+    private readonly reader;
+    private readonly refs;
+    private readonly legacyOpencode;
+    private readonly scopedAdapter;
+    constructor(nativeHarness: SupportedHarness, displayHarness?: string, aliases?: readonly string[]);
+    locate(opts?: LocateOptions): Promise<SessionRef[]>;
+    locateBySessionId(sessionId: string, opts?: LocateOptions): Promise<SessionRef[]>;
+    sourcePaths(ref: SessionRef): Promise<readonly string[]>;
+    private resolveNativeRef;
+    parse(ref: SessionRef, options?: ParseOptions): Promise<OtlpSpan[]>;
+    resolveParentTask(ref: SessionRef, childSessionId: string, options?: Pick<ParseOptions, 'corruptionMode' | 'signal'>): Promise<ParentTaskResolution>;
+    locateSpawnedChildren(parentSessionId: string, agentPaths: readonly string[], options?: LocateOptions & Pick<ParseOptions, 'corruptionMode' | 'signal'>): Promise<readonly SpawnedChildResolution[]>;
+}
+
 /**
  * Sourcegraph Amp adapter — `${XDG_DATA_HOME:-~/.local/share}/amp/threads/T-*.json`.
  *
@@ -1884,6 +1915,142 @@ declare function computeAdoption(spans: readonly OtlpSpan[]): AdoptionReport;
 /** Add only explicitly requested repository history to the same span measurements. */
 declare function analyzeAdoption(spans: readonly OtlpSpan[], opts?: AdoptionOptions): Promise<AdoptionReport>;
 
+/**
+ * Skill usage across coding-agent session stores: deterministic, incremental, no model call.
+ *
+ * `analyze` parses whole sessions into spans. That costs seconds per few dozen
+ * sessions and stops on one malformed transcript, while skill usage is a
+ * question over every session on the machine (tens of gigabytes). This module
+ * reads raw session bytes, parses only the lines that carry a skill record, and
+ * keeps a byte cursor per file. A refresh reads only bytes appended since the
+ * previous refresh; a query reads the stored events, never the transcripts.
+ *
+ * What counts:
+ * - Claude Code `model`: a Skill tool result that loaded a skill. A main session records
+ *   `toolUseResult.commandName`; subagent and workflow transcripts carry only the result
+ *   text (`Launching skill: <name>`, or `Skill "<name>" launched (forked execution…`).
+ * - Claude Code `slash`: a user `/name` command whose next record is its expanded
+ *   prompt (`isMeta`). Built-in commands such as /clear expand to nothing and are skipped.
+ * - Codex `read`: a completed shell command that reads `<skill>/SKILL.md`. Codex has
+ *   no dedicated skill event, so reading the document is the closest observable act;
+ *   a read is not evidence that the skill shaped the outcome. One command that reads
+ *   several skills at once is a catalog sweep (an audit or a survey), counted apart.
+ * - Kimi Code `read`: a successful ReadFile call or shell command that reads a skill
+ *   document. Kimi streams tool arguments, so a call is counted after its result.
+ *
+ * Each event is keyed by its record ID, so a resumed session that copies earlier
+ * records, or a file reread after truncation, never counts an event twice. The
+ * store keeps events after a harness deletes old transcripts.
+ */
+type SkillUsageHarness = 'claude-code' | 'codex' | 'kimi-code';
+type SkillUsageKind = 'model' | 'slash' | 'read';
+interface SkillUsageEvent {
+    harness: SkillUsageHarness;
+    kind: SkillUsageKind;
+    skill: string;
+    /** Directory holding the skill folder, when the record names it. */
+    root: string | null;
+    /** Record timestamp; null when the record carries none. */
+    ts: string | null;
+    session: string;
+    /** Record identity that keeps each event counted once. */
+    id: string;
+}
+interface SkillUsageSources {
+    /** Claude Code projects directory (`~/.claude/projects`). */
+    claudeProjects: string;
+    /** Codex session directories (`~/.codex/sessions`, `~/.codex/archived_sessions`). */
+    codexSessions: readonly string[];
+    /** Kimi session directory (`~/.kimi/sessions`); only wire.jsonl is scanned. */
+    kimiSessions?: string;
+}
+interface SkillUsageRefresh {
+    harness: SkillUsageHarness;
+    files: number;
+    filesRead: number;
+    bytesRead: number;
+    eventsAdded: number;
+}
+declare function defaultSkillUsageSources(): SkillUsageSources;
+declare function defaultSkillUsageStorePath(): string;
+/** The stored events and per-file cursors. Load, refresh, then query. */
+declare class SkillUsageStore {
+    readonly path: string;
+    private readonly events;
+    private files;
+    private constructor();
+    static load(path: string): Promise<SkillUsageStore>;
+    get size(): number;
+    list(): SkillUsageEvent[];
+    private add;
+    private setRoot;
+    save(): Promise<void>;
+    /** Read bytes appended since the previous refresh. Cost is proportional to new bytes. */
+    refresh(sources?: SkillUsageSources): Promise<SkillUsageRefresh[]>;
+    private refreshHarness;
+    private refreshFile;
+    private scanClaude;
+    /** Confirm a slash command by its expansion: the first later record whose parent it is. */
+    private resolveSlash;
+    private scanCodex;
+    private scanKimi;
+}
+interface InstalledSkill {
+    name: string;
+    harness: SkillUsageHarness;
+    /** Folder holding SKILL.md, as installed (links not resolved). */
+    path: string;
+}
+interface SkillCatalogRoots {
+    /** Claude Code home (`~/.claude`): `skills/` plus enabled plugins' skills. */
+    claudeHome: string;
+    /** Folders Codex lists skills from (`~/.codex/skills`, its `.system`, `~/.agents/skills`). */
+    codexSkillDirs: readonly string[];
+}
+declare function defaultSkillCatalogRoots(): SkillCatalogRoots;
+/** Skills each harness would list now. Claude plugin skills are named `<plugin>:<skill>`. */
+declare function readInstalledSkills(roots?: SkillCatalogRoots): Promise<InstalledSkill[]>;
+interface SkillUsageRow {
+    skill: string;
+    model: number;
+    slash: number;
+    read: number;
+    sessions: number;
+    firstUsed: string | null;
+    lastUsed: string | null;
+    /** Harnesses whose catalog lists this skill now; empty for built-in or removed skills. */
+    installedIn: SkillUsageHarness[];
+}
+interface SkillUsageReport {
+    since: string | null;
+    storePath: string;
+    refresh: SkillUsageRefresh[] | null;
+    storedEvents: number;
+    firstEvent: string | null;
+    lastEvent: string | null;
+    rows: SkillUsageRow[];
+    /** Installed skills with no counted event in the window, by name. */
+    unused: Array<{
+        skill: string;
+        installedIn: SkillUsageHarness[];
+    }>;
+    /** One Codex or Kimi command reading at least `sweepThreshold` skills is a catalog sweep, not use. */
+    sweepThreshold: number;
+    sweepCommands: number;
+    sweepReadsExcluded: number;
+    /** Harnesses whose skill records this command does not read. */
+    notIndexed: string[];
+}
+interface SkillUsageReportOptions {
+    /** Epoch ms; events before it are excluded. Events without a timestamp are excluded from a window. */
+    since?: number;
+    sweepThreshold?: number;
+    refresh?: SkillUsageRefresh[] | null;
+}
+declare const DEFAULT_SWEEP_THRESHOLD = 3;
+declare function buildSkillUsageReport(events: readonly SkillUsageEvent[], installed: readonly InstalledSkill[], storePath: string, options?: SkillUsageReportOptions): SkillUsageReport;
+declare function renderSkillUsage(report: SkillUsageReport): string;
+
 type TraceAgenticRouteReasonCode = 'requested-baseline' | 'execution-failures' | 'repeated-tool-loops' | 'corrective-human-feedback';
 interface TraceAgenticRouteReason {
     readonly code: TraceAgenticRouteReasonCode;
@@ -3426,6 +3593,8 @@ interface TraceQuestionsResult {
     readonly budgetUsd: number | null;
     /** The engine's own ceiling for one question, when it declares one. */
     readonly questionBudgetUsd: number | null;
+    /** The engine's wall-clock deadline for one question, when it declares one. */
+    readonly questionTimeoutMs: number | null;
     readonly spanCount: number;
     readonly otlpPath: string;
     readonly traces: readonly TraceQuestionTrace[];
@@ -3987,6 +4156,8 @@ interface AnalysisEngineFromEnvOptions {
      * cap here and the total to the ledger.
      */
     maxCostUsd?: number;
+    /** Wall-clock deadline for ONE investigation. Default: {@link DEFAULT_QUESTION_TIMEOUT_MS}. */
+    timeoutMs?: number;
     /** Receives one line per model call, in the CLI's analyst log format. */
     log?: (msg: string, fields?: Record<string, unknown>) => void;
     /** Environment to read credentials and the Python interpreter from. Default: process.env. */
@@ -4222,6 +4393,8 @@ interface RunContextJournal {
     /** Node ids that appear as some spawn's `parent` — the exact supervisor set. */
     readonly supervisorIds: ReadonlySet<string>;
     readonly invalidRows: number;
+    /** Readable `waiting`/`woken` rows from a Runtime that still had wait-state nodes. */
+    readonly retiredWaitRows: number;
     readonly partialTail: boolean;
     readonly present: boolean;
 }
@@ -4359,6 +4532,8 @@ interface RunContextSnapshot {
     readonly terminal: boolean;
     /** Rows that were present and unreadable, per artifact. */
     readonly invalidJournalRows: number;
+    /** Wait-state rows from a pre-0.305 Runtime, left out of the tree. */
+    readonly retiredWaitRows: number;
     readonly invalidCoordinationRows: number;
     /** True when an artifact's last line was still being written. */
     readonly partialTail: boolean;
@@ -4973,4 +5148,4 @@ declare function parseRetainedSession(input: {
     readonly signal?: AbortSignal;
 }): Promise<RetainedSessionSelection>;
 
-export { ACTOR_ATTR, ATTR, type Actor, type AdoptionOptions, type AdoptionReport, AmpAdapter, type AnalysisEngineFromEnvOptions, type AnalyzeOptions, type AnalyzeResult, type AnswerSchema, type AssembleSessionBundleOptions, BLOBS_DIR, type BuildPolicyEvidenceOptions, type BuildSessionIndexOptions, type BuildTraceFindingPacketOptions, CHANGED_FILE_LIST_CAP, CITATION_NORMALIZATION_VERSION, CONTENT_CAP, COORDINATION_LOG_FILE, CORRECTIVE_REACTIONS, type ChangedFileFact, type ChatTrajectory, type ChatTrajectoryMessage, type ChatTrajectoryOptions, ClaudeAdapter, type CodeTraceBenchFileRef, type CodeTraceBenchImportOptions, type CodeTraceBenchImportReceipt, type CodeTraceBenchImportResult, type CodeTraceBenchImportedTrace, type CodeTraceBenchStep, CodexAdapter, CodexExecAdapter, CodexExecStreamError, CodexTaskScopeError, type CollectOptions, type CollectPolicyEvidenceOptions, type CollectSessionIndexOptions, type CollectSessionSelectionOptions, type CollectSessionWorkflowOptions, type CompactionMeasurement, type ConformanceRenderOptions, type ContentFootprint, type CoordinationLog, type CoordinationQuestion, type CoordinationSteer, CopilotAdapter, type CorruptionMode, type CoveredMeasurement, DEFAULT_ANALYST_MODEL, DEFAULT_ASK_CONCURRENCY, DEFAULT_HARNESS, DEFAULT_SANDBOX_BASE_URL, EMPTY_SPAN_RUN_SNAPSHOT, EXPORT_RULE, EmptySessionError, type EvidenceOnlyVerdict, type ExcludedTurnFact, type ExecuteOptions, type ExportRule, type ExternalAnalysisKind, type ExternalAnalysisPayload, type ExternalAnalysisResult, type ExternalAnalyzer, type ExternalAnalyzerOptions, type ExternalDiscoveryCandidate, FACT_LIST_CAP, FACT_TEXT_CAP, FactoryAdapter, type FailureFollowUp, type FailureFollowUpReport, type FileRunContextReaderOptions, type FinalMessageFact, type FindSessionTextLeaksOptions, type FindingRejectionCounts, type FindingRejectionReasons, type FindingRejectionTally, type FindingsFileOutcome, type FollowUpKind, ForgeAdapter, GeminiAdapter, type HaloAnalyzerOptions, type HaloReasoningEffort, type HarnessTraceAdapter, type HodoscopeAnalyzerOptions, type HodoscopeInput, type HodoscopeMessage, type HodoscopeSourceMapEntry, type HodoscopeTrajectory, INGEST_SOURCE_CLI, INHERITED_SOURCE_ATTR, INHERITED_SPANS_OMITTED_ATTR, INHERITED_SPAN_ATTR, INHERITED_SPAN_COUNT_ATTR, type InheritedSpanSource, type InspectSessionIndexOptions, JsonSourceError, type JsonlCorruptionReceipt, JsonlParseError, type JsonlReadOptions, type LiveBatchOptions, type LocateOptions, type LoopConvergence, type LoopConvergenceReport, type LoopIteration, type LoopTrend, type LoopTrendBasis, MAX_SHELL_DEPTH, MAX_TRACE_QUESTION_CHARS, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpIngestIssue, type OtlpIngestIssueKind, type OtlpInput, type OtlpInputFile, type OtlpRowConversion, type OtlpSpan, type OtlpSpanKind, type OtlpSpanLink, type OtlpStatusCode, POLICY_EVIDENCE_NOTE, PREPARED_CONTEXT_BYTE_CEILING, type ParentTaskResolution, type ParseOptions, PartialUploadError, PiAdapter, type PiAdapterOptions, type PipelineOptions, type PipelineReport, type PlanOptions, type PolicyEvidenceLoopSummary, type PolicyEvidenceRecord, type PolicyEvidenceToolSummary, type PrimeAnalyzerOptions, type PrimeTransport, type PrimeTransportRequest, type PrimeTransportResponse, type ProjectSessionBundleOptions, type ProjectSessionBundleResult, type PullRequestFact, type PullRequestFacts, type PullRequestReading, QwenAdapter, REACTIONS, RESULT_FILE, RETAINED_SESSION_READER_VERSION, RULE, type Reaction, type ReactionReport, type ReactionSessionReport, type RedactSpansOptions, type Redactor, type RefusedSession, type RepoAttrs, type RepoResolution, type RepoResolutionSource, type ResolvedOtlpInput, type RetainedSessionFile, type RetainedSessionSelection, type RunContextJournal, type RunContextNode, type RunContextResult, type RunContextSnapshot, type RunDiffOptions, type RunDiffReport, type RunDiffSide, type RunResult, type RunWatchSnapshot, type RunWatchTarget, type RuntimeTrace, SESSION_FACTS_MEASUREMENT_VERSION, SESSION_FACTS_VERSION_SUFFIX, SESSION_TOKEN_TOTAL_ATTR, SOURCE_ATTRIBUTE_PREFIX, SPAN_SYNTHESIZED_ATTR, SPAWN_JOURNAL_FILE, STATUS_MARK, SYNTHESIZED_SOURCE_ATTR, SYNTHESIZED_SPAN_ATTR, type SandboxReplayBackendOptions, type ScanOptions, type ScannedSession, type SessionBatch, type SessionBundleAbsence, type SessionBundleCarriedSignatures, type SessionBundleExclusion, type SessionBundleExclusionRule, type SessionBundleFile, type SessionBundleIssue, type SessionBundleIssueKind, type SessionBundleLeakCheck, type SessionBundleLedgerSlice, type SessionBundleManifest, type SessionBundleProjection, type SessionBundleResult, type SessionBundleSliceRule, type SessionBundleVerification, type SessionBundleView, type SessionCorruptionReceipt, type SessionEnvironment, type SessionFact, type SessionFacts, type SessionFactsOptions, type SessionFactsReport, type SessionIdentityConflict, type SessionIdentityIndex, type SessionIntegrity, type SessionMeasurements, type SessionRef, type SessionRelationship, type SessionRole, type SessionSeedGroup, type SessionSelection, type SessionSelectionRow, type SessionSourceFile, type SessionTextLeak, type SessionTextLeakReport, type SessionTurnFact, type SessionWorkflow, SessionWorkflowError, type SessionWorkflowErrorCode, type SessionWorkflowIssue, type SessionWorkflowSession, type SessionWorkflowSummary, type SkippedAnalysis, type SkippedInputFile, type SourceRecordReference, type SpanInput, type SpanNodeStatus, type SpanRedaction, type SpanRunNode, type SpanRunSnapshot, type SpanStructure, type SpawnedChildResolution, type SpendRoll, type SteeringChainReport, type SteeringEdge, type SubagentSpawnFact, TRACE_QUESTION_PREVIEW_HEAD_CHARS, type ToolMeasurement, type TraceAgenticRoute, type TraceAgenticRouteReason, type TraceAgenticRouteReasonCode, type TraceContextIndex, type TraceContextRoot, type TraceEvidenceExportOptions, type TraceEvidenceExportResult, type TraceEvidenceFormatOption, type TraceEvidenceInputFormat, type TraceEvidenceRow, type TraceExecutionOptions, type TraceFindingPacket, type TraceImprovementArtifacts, type TraceImprovementOptions, type TraceImprovementResult, type TraceIndexedFile, type TraceInspectionArea, type TraceInspectionFinding, type TraceInspectionReport, type TraceInspectionSeverity, type TraceInvestigationOptions, type TraceInvestigationResult, type TraceLiveAction, type TraceLiveActionKind, type TraceLiveAnalysisContext, type TraceLiveAnalyst, type TraceLiveBatch, type TraceLiveEvidence, type TraceLiveFinding, type TraceLiveLoop, type TraceLiveSeverity, type TraceQuestion, type TraceQuestionAnswer, type TraceQuestionCitation, type TraceQuestionFailureKind, type TraceQuestionTrace, type TraceQuestionsArtifacts, type TraceQuestionsOptions, type TraceQuestionsResult, type TraceQuestionsTotals, type TraceSessionIndex, type TraceSessionIndexRow, type TraceStoreInvestigationOptions, type TraceStoreInvestigationResult, type TraceStreamEvent, type TraceStreamOptions, type TraceStreamReplayOptions, type TraceStreamSession, type TracesConfig, type TriggerPair, type TurnActorCount, type UnavailableCapabilities, type UploadBackend, type UploadIdentity, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, type UserPromptInput, type VerifySafeOptions, type VerifySafeResult, type WatchRunTargetOptions, ZERO_ROLL, type ZaiChatCallerOptions, addSpend, alreadyUploaded, analysisEngineFromEnv, analyzeAdoption, analyzeLiveBatch, analyzeLoopConvergence, analyzeReactions, analyzeSpans, analyzeSteeringChain, answerSchemaErrors, applyRedactor, assembleSessionBundle, assertAnswerSchema, assertSandboxReachable, assessSpans, buildPolicyEvidenceRecord, buildSessionFactsReport, buildSessionIndex, buildSessionIndexFromRows, buildSpanRunTree, buildTraceFindingPacket, capText, chatTrajectoryToSpans, classifyEvidenceOnlyPath, classifyFailureFollowUps, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessionSelection, collectSessionWorkflow, collectSessions, commandAnalyzer, commandRedactor, commandTextFromInput, computeAdoption, computeSessionFacts, conformanceOfSpans, connectors, countSkillRunsJsonl, createBundleSourceReader, createFindingRejectionTally, cwdMatchesSelection, cwdMatchesSelectionResolved, defaultTraceLiveAnalysts, describeSessionRelationship, diffRuns, engineCallReservationFloorUsd, environmentAttributes, environmentFromSpanAttributes, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, externalFailureMessage, fileRunContextSupervisorRunReader, fileSha256, findContextRoot, findSessionTextLeaks, findSpanSourceFiles, findingRejection, findingRejectionDetail, forEachTreeNode, formatFindingRejections, formatVerdict, haloAnalyzer, hashSessionBundleFiles, hodoscopeAnalyzer, httpJsonTransport, importCodeTraceBench, incompleteInputsNote, indexSessionIdsByTrace, inferRole, inferSpanKind, inspectSessionIndex, int, isBridgeMismatchError, isChatTrajectory, isChatTrajectoryMessage, isFileRunContextDir, isInheritedSpan, isSynthesizedSpan, iterSerializedSpans, knownHarnesses, listAdapters, listSessionBundleFiles, loadState, loadTraceQuestionsFile, loadTracesConfig, locateSessions, looksLikeAgentPrompt, mergeRolls, mergeTracesConfig, ms, normalizeAnalystCitations, normalizeRemote, normalizeTraceQuestions, otlpRowToSpan, outboundHash, parseIsoToEpochMs, parseJsonAnswer, parseRetainedSession, parseSession, parseSince, planTraceAgenticRoute, planUpload, primeAnalyzer, projectSessionBundle, readCoordinationLog, readFileRunContext, readJsonFile, readJsonl, readOtlpInput, readPullRequests, readRunContextJournal, readRunContextSnapshot, readRunSide, readRunWatchSnapshot, readSessionBundleManifest, readSessionIndexFile, readSpanRunSnapshot, recordSessionCorruption, redactSpans, renderConformance, renderInspectionReport, renderRunContextSnapshot, renderRunDiff, renderRunWatchSnapshot, renderSessionFacts, renderSessionFactsContext, renderSpanRunSnapshot, renderTraceQuestionInstructions, renderTraceQuestionPrompt, renderTraceQuestionsReport, renderValidation, resolveAdapter, resolveOtlpInputFiles, resolveRepoAttrs, resolveRunContextDir, resolveRunWatchTarget, resolveSessionRepoAttrs, runCommand, runExternalAnalyzers, runPipelines, runTotals, runTraceImprovement, runTraceInvestigation, runTraceQuestions, runTraceStoreInvestigation, sandboxReplayBackend, saveReport, saveState, scanSessions, selectAdapters, serializeInspectionReport, serializePolicyEvidence, serializeSessionIndex, serializeSpans, serializeTraceStreamEvent, sessionFactsContext, sessionHash, sessionIdFromAttributes, sessionIntegrityAttributes, sessionTextSignatures, shellCommands, skippedAnalyses, span, spanRunTotals, stampEnvironmentAttrs, stampRepoAttrs, stampSessionIdentity, stampSessionIntegrity, stampSpanWorkdirRepoAttrs, streamSessions, summarizeOtlpExecution, summarizeSpanExecution, summarizeSpanStructure, takeJsonl, textIsSynthetic, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, tokens, totalAgenticFailureMessage, totalFindingRejections, traceAgenticKinds, traceCitationsInText, traceStreamEventsFromSpans, unavailableCapabilities, uploadKey, usd, userPromptSpan, validateOtlpSpans, validationExitCode, verdictExitCode, verifyFindingsInSandbox, verifySafe, verifySessionBundle, watchRunTarget, watchSessions, withSessionFactsContext, wrap, writeHodoscopeInput, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionBundleManifest, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts, writeTraceQuestionsArtifacts, zaiChatCaller, zeroPricedCost };
+export { ACTOR_ATTR, ATTR, type Actor, type AdoptionOptions, type AdoptionReport, AmpAdapter, type AnalysisEngineFromEnvOptions, type AnalyzeOptions, type AnalyzeResult, type AnswerSchema, type AssembleSessionBundleOptions, BLOBS_DIR, type BuildPolicyEvidenceOptions, type BuildSessionIndexOptions, type BuildTraceFindingPacketOptions, CHANGED_FILE_LIST_CAP, CITATION_NORMALIZATION_VERSION, CONTENT_CAP, COORDINATION_LOG_FILE, CORRECTIVE_REACTIONS, type ChangedFileFact, type ChatTrajectory, type ChatTrajectoryMessage, type ChatTrajectoryOptions, ClaudeAdapter, type CodeTraceBenchFileRef, type CodeTraceBenchImportOptions, type CodeTraceBenchImportReceipt, type CodeTraceBenchImportResult, type CodeTraceBenchImportedTrace, type CodeTraceBenchStep, CodexAdapter, CodexExecAdapter, CodexExecStreamError, CodexTaskScopeError, type CollectOptions, type CollectPolicyEvidenceOptions, type CollectSessionIndexOptions, type CollectSessionSelectionOptions, type CollectSessionWorkflowOptions, type CompactionMeasurement, type ConformanceRenderOptions, type ContentFootprint, type CoordinationLog, type CoordinationQuestion, type CoordinationSteer, CopilotAdapter, type CorruptionMode, type CoveredMeasurement, DEFAULT_ANALYST_MODEL, DEFAULT_ASK_CONCURRENCY, DEFAULT_HARNESS, DEFAULT_SANDBOX_BASE_URL, DEFAULT_SWEEP_THRESHOLD, EMPTY_SPAN_RUN_SNAPSHOT, EXPORT_RULE, EmptySessionError, type EvidenceOnlyVerdict, type ExcludedTurnFact, type ExecuteOptions, type ExportRule, type ExternalAnalysisKind, type ExternalAnalysisPayload, type ExternalAnalysisResult, type ExternalAnalyzer, type ExternalAnalyzerOptions, type ExternalDiscoveryCandidate, FACT_LIST_CAP, FACT_TEXT_CAP, FactoryAdapter, type FailureFollowUp, type FailureFollowUpReport, type FileRunContextReaderOptions, type FinalMessageFact, type FindSessionTextLeaksOptions, type FindingRejectionCounts, type FindingRejectionReasons, type FindingRejectionTally, type FindingsFileOutcome, type FollowUpKind, ForgeAdapter, GeminiAdapter, type HaloAnalyzerOptions, type HaloReasoningEffort, HarnessSessionsAdapter, type HarnessTraceAdapter, type HodoscopeAnalyzerOptions, type HodoscopeInput, type HodoscopeMessage, type HodoscopeSourceMapEntry, type HodoscopeTrajectory, INGEST_SOURCE_CLI, INHERITED_SOURCE_ATTR, INHERITED_SPANS_OMITTED_ATTR, INHERITED_SPAN_ATTR, INHERITED_SPAN_COUNT_ATTR, type InheritedSpanSource, type InspectSessionIndexOptions, type InstalledSkill, JsonSourceError, type JsonlCorruptionReceipt, JsonlParseError, type JsonlReadOptions, type LiveBatchOptions, type LocateOptions, type LoopConvergence, type LoopConvergenceReport, type LoopIteration, type LoopTrend, type LoopTrendBasis, MAX_SHELL_DEPTH, MAX_TRACE_QUESTION_CHARS, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpIngestIssue, type OtlpIngestIssueKind, type OtlpInput, type OtlpInputFile, type OtlpRowConversion, type OtlpSpan, type OtlpSpanKind, type OtlpSpanLink, type OtlpStatusCode, POLICY_EVIDENCE_NOTE, PREPARED_CONTEXT_BYTE_CEILING, type ParentTaskResolution, type ParseOptions, PartialUploadError, PiAdapter, type PiAdapterOptions, type PipelineOptions, type PipelineReport, type PlanOptions, type PolicyEvidenceLoopSummary, type PolicyEvidenceRecord, type PolicyEvidenceToolSummary, type PrimeAnalyzerOptions, type PrimeTransport, type PrimeTransportRequest, type PrimeTransportResponse, type ProjectSessionBundleOptions, type ProjectSessionBundleResult, type PullRequestFact, type PullRequestFacts, type PullRequestReading, QwenAdapter, REACTIONS, RESULT_FILE, RETAINED_SESSION_READER_VERSION, RULE, type Reaction, type ReactionReport, type ReactionSessionReport, type RedactSpansOptions, type Redactor, type RefusedSession, type RepoAttrs, type RepoResolution, type RepoResolutionSource, type ResolvedOtlpInput, type RetainedSessionFile, type RetainedSessionSelection, type RunContextJournal, type RunContextNode, type RunContextResult, type RunContextSnapshot, type RunDiffOptions, type RunDiffReport, type RunDiffSide, type RunResult, type RunWatchSnapshot, type RunWatchTarget, type RuntimeTrace, SESSION_FACTS_MEASUREMENT_VERSION, SESSION_FACTS_VERSION_SUFFIX, SESSION_TOKEN_TOTAL_ATTR, SOURCE_ATTRIBUTE_PREFIX, SPAN_SYNTHESIZED_ATTR, SPAWN_JOURNAL_FILE, STATUS_MARK, SYNTHESIZED_SOURCE_ATTR, SYNTHESIZED_SPAN_ATTR, type SandboxReplayBackendOptions, type ScanOptions, type ScannedSession, type SessionBatch, type SessionBundleAbsence, type SessionBundleCarriedSignatures, type SessionBundleExclusion, type SessionBundleExclusionRule, type SessionBundleFile, type SessionBundleIssue, type SessionBundleIssueKind, type SessionBundleLeakCheck, type SessionBundleLedgerSlice, type SessionBundleManifest, type SessionBundleProjection, type SessionBundleResult, type SessionBundleSliceRule, type SessionBundleVerification, type SessionBundleView, type SessionCorruptionReceipt, type SessionEnvironment, type SessionFact, type SessionFacts, type SessionFactsOptions, type SessionFactsReport, type SessionIdentityConflict, type SessionIdentityIndex, type SessionIntegrity, type SessionMeasurements, type SessionRef, type SessionRelationship, type SessionRole, type SessionSeedGroup, type SessionSelection, type SessionSelectionRow, type SessionSourceFile, type SessionTextLeak, type SessionTextLeakReport, type SessionTurnFact, type SessionWorkflow, SessionWorkflowError, type SessionWorkflowErrorCode, type SessionWorkflowIssue, type SessionWorkflowSession, type SessionWorkflowSummary, type SkillCatalogRoots, type SkillUsageEvent, type SkillUsageHarness, type SkillUsageKind, type SkillUsageRefresh, type SkillUsageReport, type SkillUsageReportOptions, type SkillUsageRow, type SkillUsageSources, SkillUsageStore, type SkippedAnalysis, type SkippedInputFile, type SourceRecordReference, type SpanInput, type SpanNodeStatus, type SpanRedaction, type SpanRunNode, type SpanRunSnapshot, type SpanStructure, type SpawnedChildResolution, type SpendRoll, type SteeringChainReport, type SteeringEdge, type SubagentSpawnFact, TRACE_QUESTION_PREVIEW_HEAD_CHARS, type ToolMeasurement, type TraceAgenticRoute, type TraceAgenticRouteReason, type TraceAgenticRouteReasonCode, type TraceContextIndex, type TraceContextRoot, type TraceEvidenceExportOptions, type TraceEvidenceExportResult, type TraceEvidenceFormatOption, type TraceEvidenceInputFormat, type TraceEvidenceRow, type TraceExecutionOptions, type TraceFindingPacket, type TraceImprovementArtifacts, type TraceImprovementOptions, type TraceImprovementResult, type TraceIndexedFile, type TraceInspectionArea, type TraceInspectionFinding, type TraceInspectionReport, type TraceInspectionSeverity, type TraceInvestigationOptions, type TraceInvestigationResult, type TraceLiveAction, type TraceLiveActionKind, type TraceLiveAnalysisContext, type TraceLiveAnalyst, type TraceLiveBatch, type TraceLiveEvidence, type TraceLiveFinding, type TraceLiveLoop, type TraceLiveSeverity, type TraceQuestion, type TraceQuestionAnswer, type TraceQuestionCitation, type TraceQuestionFailureKind, type TraceQuestionTrace, type TraceQuestionsArtifacts, type TraceQuestionsOptions, type TraceQuestionsResult, type TraceQuestionsTotals, type TraceSessionIndex, type TraceSessionIndexRow, type TraceStoreInvestigationOptions, type TraceStoreInvestigationResult, type TraceStreamEvent, type TraceStreamOptions, type TraceStreamReplayOptions, type TraceStreamSession, type TracesConfig, type TriggerPair, type TurnActorCount, type UnavailableCapabilities, type UploadBackend, type UploadIdentity, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, type UserPromptInput, type VerifySafeOptions, type VerifySafeResult, type WatchRunTargetOptions, ZERO_ROLL, type ZaiChatCallerOptions, addSpend, alreadyUploaded, analysisEngineFromEnv, analyzeAdoption, analyzeLiveBatch, analyzeLoopConvergence, analyzeReactions, analyzeSpans, analyzeSteeringChain, answerSchemaErrors, applyRedactor, assembleSessionBundle, assertAnswerSchema, assertSandboxReachable, assessSpans, buildPolicyEvidenceRecord, buildSessionFactsReport, buildSessionIndex, buildSessionIndexFromRows, buildSkillUsageReport, buildSpanRunTree, buildTraceFindingPacket, capText, chatTrajectoryToSpans, classifyEvidenceOnlyPath, classifyFailureFollowUps, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessionSelection, collectSessionWorkflow, collectSessions, commandAnalyzer, commandRedactor, commandTextFromInput, computeAdoption, computeSessionFacts, conformanceOfSpans, connectors, countSkillRunsJsonl, createBundleSourceReader, createFindingRejectionTally, cwdMatchesSelection, cwdMatchesSelectionResolved, defaultSkillCatalogRoots, defaultSkillUsageSources, defaultSkillUsageStorePath, defaultTraceLiveAnalysts, describeSessionRelationship, diffRuns, engineCallReservationFloorUsd, environmentAttributes, environmentFromSpanAttributes, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, externalFailureMessage, fileRunContextSupervisorRunReader, fileSha256, findContextRoot, findSessionTextLeaks, findSpanSourceFiles, findingRejection, findingRejectionDetail, forEachTreeNode, formatFindingRejections, formatVerdict, haloAnalyzer, hashSessionBundleFiles, hodoscopeAnalyzer, httpJsonTransport, importCodeTraceBench, incompleteInputsNote, indexSessionIdsByTrace, inferRole, inferSpanKind, inspectSessionIndex, int, isBridgeMismatchError, isChatTrajectory, isChatTrajectoryMessage, isFileRunContextDir, isInheritedSpan, isSynthesizedSpan, iterSerializedSpans, knownHarnesses, listAdapters, listSessionBundleFiles, loadState, loadTraceQuestionsFile, loadTracesConfig, locateSessions, looksLikeAgentPrompt, mergeRolls, mergeTracesConfig, ms, normalizeAnalystCitations, normalizeRemote, normalizeTraceQuestions, otlpRowToSpan, outboundHash, parseIsoToEpochMs, parseJsonAnswer, parseRetainedSession, parseSession, parseSince, planTraceAgenticRoute, planUpload, primeAnalyzer, projectSessionBundle, readCoordinationLog, readFileRunContext, readInstalledSkills, readJsonFile, readJsonl, readOtlpInput, readPullRequests, readRunContextJournal, readRunContextSnapshot, readRunSide, readRunWatchSnapshot, readSessionBundleManifest, readSessionIndexFile, readSpanRunSnapshot, recordSessionCorruption, redactSpans, renderConformance, renderInspectionReport, renderRunContextSnapshot, renderRunDiff, renderRunWatchSnapshot, renderSessionFacts, renderSessionFactsContext, renderSkillUsage, renderSpanRunSnapshot, renderTraceQuestionInstructions, renderTraceQuestionPrompt, renderTraceQuestionsReport, renderValidation, resolveAdapter, resolveOtlpInputFiles, resolveRepoAttrs, resolveRunContextDir, resolveRunWatchTarget, resolveSessionRepoAttrs, runCommand, runExternalAnalyzers, runPipelines, runTotals, runTraceImprovement, runTraceInvestigation, runTraceQuestions, runTraceStoreInvestigation, sandboxReplayBackend, saveReport, saveState, scanSessions, selectAdapters, serializeInspectionReport, serializePolicyEvidence, serializeSessionIndex, serializeSpans, serializeTraceStreamEvent, sessionFactsContext, sessionHash, sessionIdFromAttributes, sessionIntegrityAttributes, sessionTextSignatures, shellCommands, skippedAnalyses, span, spanRunTotals, stampEnvironmentAttrs, stampRepoAttrs, stampSessionIdentity, stampSessionIntegrity, stampSpanWorkdirRepoAttrs, streamSessions, summarizeOtlpExecution, summarizeSpanExecution, summarizeSpanStructure, takeJsonl, textIsSynthetic, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, tokens, totalAgenticFailureMessage, totalFindingRejections, traceAgenticKinds, traceCitationsInText, traceStreamEventsFromSpans, unavailableCapabilities, uploadKey, usd, userPromptSpan, validateOtlpSpans, validationExitCode, verdictExitCode, verifyFindingsInSandbox, verifySafe, verifySessionBundle, watchRunTarget, watchSessions, withSessionFactsContext, wrap, writeHodoscopeInput, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionBundleManifest, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts, writeTraceQuestionsArtifacts, zaiChatCaller, zeroPricedCost };