@tangle-network/traces 0.9.2 → 0.9.4

package/README.md

@@ -51,7 +51,7 @@ traces stream --all --mode findings
 
 That's the command in the demo above. The **deterministic pass** checks stuck loops, token growth, output decay, missing self-verification, tool failures, and human corrections. Each supported issue is returned as a finding with evidence, an action, confidence, and a validation plan. It needs no API key and costs nothing.
 
-Add `--llm` for the **agentic analysts** (failure-mode / knowledge-gap / knowledge-poisoning / improvement); they call OpenAI and respect `--budget <usd>`.
+Add `--llm` for the **agentic analysts**. `traces` first uses free local signals to choose the smallest useful set: a failure review always runs, while knowledge and edit reviews run only when failures, repeated calls, or corrective feedback support them. They call OpenAI and respect `--budget <usd>`.
 
 Every run also writes a **canonical OpenInference JSONL artifact**, so you can run external engines like [HALO](https://github.com/context-labs/halo) over it directly with `--analyzer halo`. See [External engines](#external-engines-bring-your-own). Analysis is never locked to one engine.
 
@@ -71,7 +71,7 @@ The deterministic pass (free, no key) surfaces:
 | **No self-verification** | state-mutating actions never followed by an eval/inspect/check |
 | **Tool mix / retry / error rates** | repeated, retried, and failed tool calls |
 
-`--llm` adds agentic analysts that read the conversation and cluster higher-order failure and improvement signals.
+`--llm` adds agentic analysts that read the conversation and cluster higher-order failure and improvement signals. They receive the compact deterministic findings first, then share their earlier findings with later analysts. With `traces improve`, the selected analysts and reasons are saved in `result.json` and the report, so another agent can reuse the packet without rereading the raw trace.
 
 ## Supported harnesses
 
@@ -198,7 +198,7 @@ The directory contains:
 
 | File | Purpose |
 |---|---|
-| `result.json` | findings, actions, checks, execution facts, and adoption data |
+| `result.json` | findings, actions, checks, execution facts, adoption data, and the chosen LLM analysis route |
 | `evidence.jsonl` | one row per evidence ref, suitable for downstream mining |
 | `report.md` | human-readable report rendered from the typed data |
 | `traces.otlp.jsonl` | canonical trace used by the analysts and execution accounting |

package/dist/{chunk-RUG26PIS.js → chunk-BKGWYQR4.js}

@@ -4632,8 +4632,56 @@ async function analyzeAdoption(spans, opts = {}) {
   };
 }
 
+// src/agentic-routing.ts
+import {
+  DEFAULT_TRACE_ANALYST_KINDS
+} from "@tangle-network/agent-eval/analyst";
+function planTraceAgenticRoute(pipelines, reactions) {
+  const reasons = [{
+    code: "requested-baseline",
+    detail: "LLM trace analysis was explicitly requested; start with one bounded failure-mode pass."
+  }];
+  const ids = /* @__PURE__ */ new Set(["failure-mode"]);
+  const hasFailures = pipelines.failureClusters.totalFailures > 0;
+  const hasLoops = pipelines.stuckLoops.findings.length > 0;
+  const corrective = reactions.signals.correction + reactions.signals.frustration + reactions.signals.jargon + reactions.signals.structure;
+  if (hasFailures) {
+    reasons.push({
+      code: "execution-failures",
+      detail: `${pipelines.failureClusters.totalFailures} execution failure(s) require a concrete edit proposal.`
+    });
+  }
+  if (hasLoops) {
+    reasons.push({
+      code: "repeated-tool-loops",
+      detail: `${pipelines.stuckLoops.findings.length} repeated tool-call loop(s) require a concrete edit proposal.`
+    });
+  }
+  if (corrective > 0) {
+    ids.add("knowledge-gap");
+    ids.add("knowledge-poisoning");
+    reasons.push({
+      code: "corrective-human-feedback",
+      detail: `${corrective} corrective human reaction signal(s) warrant gap and contradiction analysis.`
+    });
+  }
+  if (hasFailures || hasLoops || corrective > 0) ids.add("improvement");
+  return {
+    schemaVersion: 1,
+    kind: "traces.agentic_route",
+    analystIds: DEFAULT_TRACE_ANALYST_KINDS.map((spec) => spec.id).filter((id) => ids.has(id)),
+    reasons
+  };
+}
+function traceAgenticKinds(route) {
+  const selected = new Set(route.analystIds);
+  return DEFAULT_TRACE_ANALYST_KINDS.filter((spec) => selected.has(spec.id));
+}
+
 // src/analyze.ts
-import { buildDefaultAnalystRegistry } from "@tangle-network/agent-eval/analyst";
+import {
+  buildDefaultAnalystRegistry
+} from "@tangle-network/agent-eval/analyst";
 import { OtlpFileTraceStore } from "@tangle-network/agent-eval/traces";
 var GENERATED_TRACE_FILE_CEILING = 512 * 1024 * 1024;
 async function analyzeSpans(spans, opts = {}) {
@@ -4651,17 +4699,20 @@ async function analyzeSpans(spans, opts = {}) {
   await detStore.ensureIndexed();
   const detRegistry = opts.registry ?? buildDefaultAnalystRegistry({ registry: { log: opts.log } });
   const result = await detRegistry.run(runId, { traceStore: detStore });
-  if (opts.ai) {
+  if (opts.ai || opts.agenticRegistry) {
     const agStore = new OtlpFileTraceStore({ path: otlpPath, maxFileBytes: GENERATED_TRACE_FILE_CEILING });
     await agStore.ensureIndexed();
-    const agRegistry = buildDefaultAnalystRegistry({
+    const agRegistry = opts.agenticRegistry ?? buildDefaultAnalystRegistry({
       ai: opts.ai,
       model: opts.model,
+      kinds: opts.agenticKinds,
       includeBehavioral: false,
       registry: { log: opts.log }
     });
     const agResult = await agRegistry.run(runId, { traceStore: agStore }, {
-      budget: opts.budgetUsd != null ? { totalUsd: opts.budgetUsd } : void 0
+      budget: opts.budgetUsd != null ? { totalUsd: opts.budgetUsd } : void 0,
+      chainFindings: true,
+      ...opts.agenticPriorFindings?.length ? { priorFindings: { "*": opts.agenticPriorFindings } } : {}
     });
     result.findings.push(...agResult.findings);
     result.per_analyst.push(...agResult.per_analyst);
@@ -5500,6 +5551,14 @@ function renderExternal(results) {
   }
   return lines.join("\n");
 }
+function renderAgenticRoute(route) {
+  if (!route) return "";
+  const lines = ["## LLM trace analysis", ""];
+  lines.push(`- **Selected analysts:** ${route.analystIds.map((id) => `\`${id}\``).join(", ")}`);
+  for (const reason of route.reasons) lines.push(`- **${reason.code}:** ${reason.detail}`);
+  lines.push("");
+  return lines.join("\n");
+}
 function renderInvestigationReport(result, analystResult) {
   const base = `${renderReport({ ...analystResult, findings: [...result.findings] }, {
     harness: result.harness,
@@ -5511,7 +5570,7 @@ function renderInvestigationReport(result, analystResult) {
     deterministic: summarizeDeterministicSignals(result.pipelines, result.reactions),
     sources: result.sources
   })}
-${renderPipelines(result.pipelines)}
+${renderAgenticRoute(result.agenticRoute)}${renderPipelines(result.pipelines)}
 ${renderReactions(result.reactions)}
 ${renderAdoption(result.adoption)}`;
   const external = renderExternal(result.external);
@@ -5567,24 +5626,29 @@ function mergeTracesConfig(opts, config) {
 async function runTraceInvestigation(opts) {
   if (opts.spans.length === 0) throw new Error("runTraceInvestigation: no spans to analyze");
   const generatedAt = opts.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString();
-  const [analysis, pipelines, reactions, adoption] = await Promise.all([
-    analyzeSpans(opts.spans, {
-      ai: opts.ai,
-      model: opts.model,
-      budgetUsd: opts.budgetUsd,
-      registry: opts.registry,
-      otlpOutPath: opts.otlpOutPath,
-      runId: `traces-investigation-${Date.parse(generatedAt) || Date.now()}`,
-      log: opts.log
-    }),
+  const [pipelines, reactions, adoption] = await Promise.all([
     runPipelines(opts.spans, { minLoopOccurrences: opts.minLoopOccurrences }),
     Promise.resolve(analyzeReactions(opts.spans)),
     analyzeAdoption(opts.spans, { cwds: opts.cwds })
   ]);
+  const deterministic = deterministicFindings(pipelines, reactions, adoption);
+  const agenticRoute = opts.ai && !opts.agenticRegistry ? planTraceAgenticRoute(pipelines, reactions) : void 0;
+  const analysis = await analyzeSpans(opts.spans, {
+    ai: opts.ai,
+    model: opts.model,
+    budgetUsd: opts.budgetUsd,
+    registry: opts.registry,
+    agenticRegistry: opts.agenticRegistry,
+    agenticKinds: agenticRoute ? traceAgenticKinds(agenticRoute) : void 0,
+    agenticPriorFindings: deterministic,
+    otlpOutPath: opts.otlpOutPath,
+    runId: `traces-investigation-${Date.parse(generatedAt) || Date.now()}`,
+    log: opts.log
+  });
   const external = opts.externalAnalyzers?.length ? await runExternalAnalyzers(analysis.otlpPath, opts.externalAnalyzers, { prompt: opts.analyzerPrompt }) : [];
   const findings = [
     ...analysis.result.findings,
-    ...deterministicFindings(pipelines, reactions, adoption),
+    ...deterministic,
     ...normalizeExternalFindings(external)
   ];
   const partial = {
@@ -5602,6 +5666,7 @@ async function runTraceInvestigation(opts) {
     pipelines,
     reactions,
     adoption,
+    ...agenticRoute ? { agenticRoute } : {},
     external
   };
   const result = { ...partial, report: "" };
@@ -5616,7 +5681,8 @@ async function runTraceStoreInvestigation(opts) {
   });
   const runId = opts.runId ?? `traces-store-investigation-${Date.parse(generatedAt) || Date.now()}`;
   const analystResult = await registry.run(runId, { traceStore: opts.traceStore }, {
-    budget: opts.budgetUsd != null ? { totalUsd: opts.budgetUsd } : void 0
+    budget: opts.budgetUsd != null ? { totalUsd: opts.budgetUsd } : void 0,
+    chainFindings: true
   });
   const packet = buildTraceFindingPacket({
     findings: analystResult.findings,
@@ -6678,6 +6744,8 @@ export {
   writeInspectionReportFile,
   countSkillRunsJsonl,
   analyzeAdoption,
+  planTraceAgenticRoute,
+  traceAgenticKinds,
   analyzeSpans,
   REACTIONS,
   analyzeReactions,

package/dist/cli.js

@@ -40,12 +40,20 @@ import {
   writePolicyEvidenceFile,
   writeSessionIndexFile,
   writeTraceEvidenceExportFile
-} from "./chunk-RUG26PIS.js";
+} from "./chunk-BKGWYQR4.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";
 import { readFile, stat } from "fs/promises";
 import { basename, resolve } from "path";
+import {
+  analyzeSupervisorRun,
+  findSupervisorRunDirs,
+  isUnavailable,
+  renderSupervisorRollupMarkdown,
+  renderSupervisorRunMarkdown,
+  rollupSupervisorRuns
+} from "@tangle-network/agent-eval/supervisor-run";
 function packageVersion() {
   const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
   if (typeof pkg.version !== "string" || !pkg.version) throw new Error("package.json is missing version");
@@ -92,6 +100,9 @@ function parseArgs(argv) {
       case "--cwd":
         a.cwd = next();
         break;
+      case "--supervisor-run-dir":
+        a.supervisorRunDir = next();
+        break;
       case "--since":
         a.since = next();
         break;
@@ -453,6 +464,7 @@ async function loadExportAttributes(args) {
   return attributes;
 }
 async function cmdAnalyze(args) {
+  if (args.supervisorRunDir) return cmdAnalyzeSupervisorRun(args.supervisorRunDir, args);
   const result = await investigate(args, { loadDefaultConfig: false });
   if (args.out) {
     await saveReport(args.out, result.report);
@@ -463,6 +475,32 @@ async function cmdAnalyze(args) {
     console.log(result.report);
   }
 }
+async function cmdAnalyzeSupervisorRun(runDir, args) {
+  const nested = await findSupervisorRunDirs(runDir);
+  let markdown;
+  if (nested.length > 0) {
+    markdown = renderSupervisorRollupMarkdown(
+      rollupSupervisorRuns(await Promise.all(nested.map((dir) => analyzeSupervisorRun(dir)))),
+      `Supervisor rollup \u2014 ${runDir}`
+    );
+  } else {
+    const report = await analyzeSupervisorRun(runDir);
+    if (isUnavailable(report.orchestration.workersSpawned)) {
+      throw new Error(
+        `no supervisor run found at ${runDir} \u2014 expected <runDir>/ws/.loops/supervisor/<id>, or a parent directory containing such runs`
+      );
+    }
+    markdown = renderSupervisorRunMarkdown(report);
+  }
+  if (args.out) {
+    await saveReport(args.out, markdown);
+    console.log(
+      `supervisor report \u2192 ${args.out}  (${nested.length > 0 ? `${nested.length} runs` : "1 run"})`
+    );
+  } else {
+    console.log(markdown);
+  }
+}
 async function collectImportedSpans(args) {
   if (!args.input) throw new Error("input file missing");
   const attributes = await loadExportAttributes(args);
@@ -787,6 +825,7 @@ function usage() {
 Commands:
   list      List discovered sessions
   analyze   Run analyst suite + loop/waste pipelines over sessions or an input file
+            (--supervisor-run-dir <dir> reports a supervision tree instead)
   investigate Run typed investigation flow, including BYO config + evidence-backed actions
   improve   Write findings, evidence, report, and canonical trace artifacts
   convert   Emit OTLP-JSONL only (HALO: use analyze --analyzer halo)
@@ -804,6 +843,10 @@ Options:
   --last <n>       Most-recent N sessions
   --session <id|path> Analyze one listed session ID or one explicit harness session file
   --cwd <dir>      Filter sessions by working directory
+  --supervisor-run-dir <dir>
+                   analyze: report a SUPERVISION TREE instead of harness sessions \u2014
+                   steers, spawn waves, concurrency, idle wall, cost by role,
+                   accepted vs rejected. Rolls up when the dir holds many runs.
   --since <t>      upload: window, 30m / 2h / 7d or an ISO date (default 24h); analyze: ISO cutoff
   --out <path>     Write report to a file
   --dir <path>     improve: write artifacts to this directory

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import { ToolUseMetrics, InMemoryTraceStore } from '@tangle-network/agent-eval';
 import { StuckLoopReport, FailureClusterReport } from '@tangle-network/agent-eval/pipelines';
+import { TraceAnalystKindSpec, AnalystRegistry, AnalystFinding, buildDefaultAnalystRegistry, AnalystRunResult, Analyst } from '@tangle-network/agent-eval/analyst';
+export { Analyst, AnalystContext, AnalystFinding, AnalystRegistry, buildDefaultAnalystRegistry, makeFinding } from '@tangle-network/agent-eval/analyst';
 import { AxAIService } from '@ax-llm/ax';
 import { ExecutionReport } from '@tangle-network/agent-eval/contract';
-import { AnalystRegistry, buildDefaultAnalystRegistry, AnalystFinding, AnalystRunResult, Analyst } from '@tangle-network/agent-eval/analyst';
-export { Analyst, AnalystContext, AnalystFinding, AnalystRegistry, buildDefaultAnalystRegistry, makeFinding } from '@tangle-network/agent-eval/analyst';
 import { TraceAnalysisStore, RedactionRule, RedactionReport } from '@tangle-network/agent-eval/traces';
 export { DEFAULT_REDACTION_RULES, RedactionReport, RedactionRule, redactString, redactValue } from '@tangle-network/agent-eval/traces';
 import { TraceSpanEvent } from '@tangle-network/agent-eval/hosted';
@@ -874,6 +874,31 @@ interface AdoptionOptions {
 }
 declare function analyzeAdoption(spans: readonly OtlpSpan[], opts?: AdoptionOptions): Promise<AdoptionReport>;
 
+type TraceAgenticRouteReasonCode = 'requested-baseline' | 'execution-failures' | 'repeated-tool-loops' | 'corrective-human-feedback';
+interface TraceAgenticRouteReason {
+    readonly code: TraceAgenticRouteReasonCode;
+    readonly detail: string;
+}
+/** A deterministic selection record for the agent-eval trace analysts. */
+interface TraceAgenticRoute {
+    readonly schemaVersion: 1;
+    readonly kind: 'traces.agentic_route';
+    /** Agent ids in execution order. Later agents receive earlier findings. */
+    readonly analystIds: readonly string[];
+    /** Why each extra analyst earned model spend. */
+    readonly reasons: readonly TraceAgenticRouteReason[];
+}
+/**
+ * Select the smallest useful agent-eval trace-analysis suite.
+ *
+ * A caller explicitly requesting LLM analysis always gets one failure-mode
+ * pass. The remaining lenses require a local signal first, and the edit
+ * designer runs only when there is something concrete to improve.
+ */
+declare function planTraceAgenticRoute(pipelines: PipelineReport, reactions: ReactionReport): TraceAgenticRoute;
+/** Resolve a route into the maintained agent-eval kind specifications. */
+declare function traceAgenticKinds(route: TraceAgenticRoute): readonly TraceAnalystKindSpec[];
+
 /**
  * Project normalized `OtlpSpan[]` onto agent-eval's runtime trace store.
  *
@@ -920,6 +945,13 @@ interface AnalyzeOptions {
      * `@tangle-network/agent-eval`'s `AnalystRegistry`.
      */
     registry?: AnalystRegistry;
+    /** Agentic registry override. Unlike `registry`, this runs after the local
+     * deterministic pass and receives its compact findings as prior context. */
+    agenticRegistry?: AnalystRegistry;
+    /** Select a subset of agent-eval's maintained trace analyst kinds. */
+    agenticKinds?: readonly TraceAnalystKindSpec[];
+    /** Compact deterministic findings that agents receive before reading spans. */
+    agenticPriorFindings?: readonly AnalystFinding[];
     /** Where to write the OTLP-JSONL artifact. Defaults to a temp file. */
     otlpOutPath?: string;
     runId?: string;
@@ -1453,6 +1485,8 @@ interface TraceInvestigationOptions {
     readonly model?: string;
     readonly budgetUsd?: number;
     readonly registry?: AnalystRegistry;
+    /** Agentic registry override for custom trace-analysis agents. */
+    readonly agenticRegistry?: AnalystRegistry;
     readonly externalAnalyzers?: readonly ExternalAnalyzer[];
     readonly analyzerPrompt?: string;
     readonly otlpOutPath?: string;
@@ -1492,6 +1526,8 @@ interface TraceInvestigationResult {
     readonly pipelines: PipelineReport;
     readonly reactions: ReactionReport;
     readonly adoption: AdoptionReport;
+    /** Deterministic routing record for the agentic trace-analysis pass. */
+    readonly agenticRoute?: TraceAgenticRoute;
     readonly external: readonly ExternalAnalysisResult[];
     readonly report: string;
 }
@@ -1744,4 +1780,4 @@ interface ExecuteOptions {
 /** Send the final, new outbound items (or write their dry-run OTLP). */
 declare function executeUpload(plan: UploadPlan, opts?: ExecuteOptions): Promise<UploadResult>;
 
-export { ACTOR_ATTR, ATTR, type Actor, type AdoptionOptions, type AdoptionReport, AmpAdapter, type AnalyzeOptions, type AnalyzeResult, type BuildPolicyEvidenceOptions, type BuildSessionIndexOptions, type BuildTraceFindingPacketOptions, CODING_REDACTION_RULES, CONTENT_CAP, CORRECTIVE_REACTIONS, ClaudeAdapter, CodexAdapter, type CollectOptions, type CollectPolicyEvidenceOptions, type CollectSessionIndexOptions, CopilotAdapter, type CorruptionMode, DEFAULT_HARNESS, EmptySessionError, type ExecuteOptions, type ExternalAnalysisResult, type ExternalAnalyzer, FactoryAdapter, ForgeAdapter, GeminiAdapter, type HarnessTraceAdapter, INGEST_SOURCE_CLI, type InspectSessionIndexOptions, JsonSourceError, type JsonlCorruptionReceipt, JsonlParseError, type JsonlReadOptions, type LiveBatchOptions, type LocateOptions, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpSpan, type OtlpSpanKind, type OtlpStatusCode, type ParseOptions, PartialUploadError, PiAdapter, type PipelineOptions, type PipelineReport, type PlanOptions, type PolicyEvidenceLoopSummary, type PolicyEvidenceRecord, type PolicyEvidenceToolSummary, QwenAdapter, REACTIONS, type Reaction, type ReactionReport, type ReactionSessionReport, type Redactor, type RepoAttrs, type RepoResolution, type RepoResolutionSource, type RunResult, type RuntimeTrace, type ScanOptions, type ScannedSession, type SessionBatch, type SessionCorruptionReceipt, type SessionIdentityConflict, type SessionIdentityIndex, type SessionIntegrity, type SessionRef, type SpanInput, type SpanRedaction, TRACES_REDACTION_RULES, 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 TraceSessionIndex, type TraceSessionIndexRow, type TraceStoreInvestigationOptions, type TraceStoreInvestigationResult, type TraceStreamEvent, type TraceStreamOptions, type TraceStreamReplayOptions, type TraceStreamSession, type TracesConfig, type TriggerPair, type UploadBackend, type UploadIdentity, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, type UserPromptInput, alreadyUploaded, analyzeAdoption, analyzeLiveBatch, analyzeReactions, analyzeSpans, applyRedactor, buildPolicyEvidenceRecord, buildSessionIndex, buildSessionIndexFromRows, buildTraceFindingPacket, capText, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessions, commandAnalyzer, commandRedactor, countSkillRunsJsonl, cwdMatchesSelection, defaultTraceLiveAnalysts, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, haloAnalyzer, indexSessionIdsByTrace, inspectSessionIndex, knownHarnesses, listAdapters, loadState, loadTracesConfig, locateSessions, looksLikeAgentPrompt, mergeTracesConfig, normalizeRemote, outboundHash, parseIsoToEpochMs, parseSession, parseSince, planUpload, readJsonFile, readJsonl, readSessionIndexFile, recordSessionCorruption, redactSpans, renderInspectionReport, resolveAdapter, resolveRepoAttrs, resolveSessionRepoAttrs, runCommand, runExternalAnalyzers, runPipelines, runTraceImprovement, runTraceInvestigation, runTraceStoreInvestigation, saveReport, saveState, scanSessions, selectAdapters, serializeInspectionReport, serializePolicyEvidence, serializeSessionIndex, serializeSpans, serializeTraceStreamEvent, sessionHash, sessionIdFromAttributes, sessionIntegrityAttributes, span, stampRepoAttrs, stampSessionIdentity, stampSessionIntegrity, stampSpanWorkdirRepoAttrs, streamSessions, summarizeOtlpExecution, summarizeSpanExecution, takeJsonl, textIsSynthetic, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, traceStreamEventsFromSpans, uploadKey, userPromptSpan, watchSessions, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts };
+export { ACTOR_ATTR, ATTR, type Actor, type AdoptionOptions, type AdoptionReport, AmpAdapter, type AnalyzeOptions, type AnalyzeResult, type BuildPolicyEvidenceOptions, type BuildSessionIndexOptions, type BuildTraceFindingPacketOptions, CODING_REDACTION_RULES, CONTENT_CAP, CORRECTIVE_REACTIONS, ClaudeAdapter, CodexAdapter, type CollectOptions, type CollectPolicyEvidenceOptions, type CollectSessionIndexOptions, CopilotAdapter, type CorruptionMode, DEFAULT_HARNESS, EmptySessionError, type ExecuteOptions, type ExternalAnalysisResult, type ExternalAnalyzer, FactoryAdapter, ForgeAdapter, GeminiAdapter, type HarnessTraceAdapter, INGEST_SOURCE_CLI, type InspectSessionIndexOptions, JsonSourceError, type JsonlCorruptionReceipt, JsonlParseError, type JsonlReadOptions, type LiveBatchOptions, type LocateOptions, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpSpan, type OtlpSpanKind, type OtlpStatusCode, type ParseOptions, PartialUploadError, PiAdapter, type PipelineOptions, type PipelineReport, type PlanOptions, type PolicyEvidenceLoopSummary, type PolicyEvidenceRecord, type PolicyEvidenceToolSummary, QwenAdapter, REACTIONS, type Reaction, type ReactionReport, type ReactionSessionReport, type Redactor, type RepoAttrs, type RepoResolution, type RepoResolutionSource, type RunResult, type RuntimeTrace, type ScanOptions, type ScannedSession, type SessionBatch, type SessionCorruptionReceipt, type SessionIdentityConflict, type SessionIdentityIndex, type SessionIntegrity, type SessionRef, type SpanInput, type SpanRedaction, TRACES_REDACTION_RULES, 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 TraceSessionIndex, type TraceSessionIndexRow, type TraceStoreInvestigationOptions, type TraceStoreInvestigationResult, type TraceStreamEvent, type TraceStreamOptions, type TraceStreamReplayOptions, type TraceStreamSession, type TracesConfig, type TriggerPair, type UploadBackend, type UploadIdentity, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, type UserPromptInput, alreadyUploaded, analyzeAdoption, analyzeLiveBatch, analyzeReactions, analyzeSpans, applyRedactor, buildPolicyEvidenceRecord, buildSessionIndex, buildSessionIndexFromRows, buildTraceFindingPacket, capText, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessions, commandAnalyzer, commandRedactor, countSkillRunsJsonl, cwdMatchesSelection, defaultTraceLiveAnalysts, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, haloAnalyzer, indexSessionIdsByTrace, inspectSessionIndex, knownHarnesses, listAdapters, loadState, loadTracesConfig, locateSessions, looksLikeAgentPrompt, mergeTracesConfig, normalizeRemote, outboundHash, parseIsoToEpochMs, parseSession, parseSince, planTraceAgenticRoute, planUpload, readJsonFile, readJsonl, readSessionIndexFile, recordSessionCorruption, redactSpans, renderInspectionReport, resolveAdapter, resolveRepoAttrs, resolveSessionRepoAttrs, runCommand, runExternalAnalyzers, runPipelines, runTraceImprovement, runTraceInvestigation, runTraceStoreInvestigation, saveReport, saveState, scanSessions, selectAdapters, serializeInspectionReport, serializePolicyEvidence, serializeSessionIndex, serializeSpans, serializeTraceStreamEvent, sessionHash, sessionIdFromAttributes, sessionIntegrityAttributes, span, stampRepoAttrs, stampSessionIdentity, stampSessionIntegrity, stampSpanWorkdirRepoAttrs, streamSessions, summarizeOtlpExecution, summarizeSpanExecution, takeJsonl, textIsSynthetic, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, traceAgenticKinds, traceStreamEventsFromSpans, uploadKey, userPromptSpan, watchSessions, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts };

package/dist/index.js

@@ -64,6 +64,7 @@ import {
   parseIsoToEpochMs,
   parseSession,
   parseSince,
+  planTraceAgenticRoute,
   planUpload,
   readJsonFile,
   readJsonl,
@@ -105,6 +106,7 @@ import {
   toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
+  traceAgenticKinds,
   traceStreamEventsFromSpans,
   uploadKey,
   userPromptSpan,
@@ -115,7 +117,7 @@ import {
   writeSessionIndexFile,
   writeTraceEvidenceExportFile,
   writeTraceImprovementArtifacts
-} from "./chunk-RUG26PIS.js";
+} from "./chunk-BKGWYQR4.js";
 
 // src/collect.ts
 async function collectSessions(opts = {}) {
@@ -212,6 +214,7 @@ export {
   parseIsoToEpochMs,
   parseSession,
   parseSince,
+  planTraceAgenticRoute,
   planUpload,
   readJsonFile,
   readJsonl,
@@ -255,6 +258,7 @@ export {
   toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
+  traceAgenticKinds,
   traceStreamEventsFromSpans,
   uploadKey,
   userPromptSpan,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/traces",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "description": "Point it at your coding-agent session traces (Claude Code, Codex, OpenCode, Gemini, Pi, …) and get failure-mode + efficiency findings. CLI + SDK over the @tangle-network/agent-eval analyst suite — observe live sessions, run your own analysts, redact, and upload to the Tangle Intelligence Platform.",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@ax-llm/ax": "^23.0.1",
-    "@tangle-network/agent-eval": "^0.122.8"
+    "@tangle-network/agent-eval": "^0.124.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",