@tangle-network/traces 0.10.1 → 0.10.3

package/README.md

@@ -376,6 +376,8 @@ See [`examples/external-engines.ts`](./examples/external-engines.ts).
 > The built-in agentic analysts (`--llm`) run on the Tangle router by default: set `TANGLE_API_KEY`.
 > `OPENAI_API_KEY` alone targets OpenAI instead, and `OPENAI_BASE_URL` overrides the endpoint for any other OpenAI-compatible gateway.
 > `--llm` also needs a Python interpreter with `agent-eval-rpc[dspy]` installed, because agent-eval's model-backed analysts run through the DSPy RLM engine out of process; set `TRACES_PYTHON` to choose the interpreter.
+> The bridge protocol is version-locked: install the exact version matching this package's `@tangle-network/agent-eval` dependency (`pip install "agent-eval-rpc[dspy]==$(npm view @tangle-network/traces dependencies.@tangle-network/agent-eval)"`) — a skewed bridge kills every agentic analyst at startup.
+> When `--llm` was requested and every agentic analyst fails, `analyze`/`investigate`/`improve` still write the deterministic report, then exit 1 with each analyst's underlying error.
 > Every deterministic command — `list`, `analyze` without `--llm`, `convert`, `index`, `inspect`, `export`, `evidence`, `stream`, `watch`, `analyze --supervisor-run-dir` — needs neither a key nor Python.
 
 ## Agent skills

package/dist/{chunk-7BQ2CVEA.js → chunk-LC66I5TE.js}

@@ -8973,6 +8973,7 @@ async function analyzeSpans(spans, opts = {}) {
   const detRegistry = opts.registry ?? buildDefaultAnalystRegistry({ registry: { log: opts.log } });
   const result = await detRegistry.run(runId, { traceStore: detStore }, { signal: opts.signal });
   opts.signal?.throwIfAborted();
+  let agenticPerAnalyst;
   if (opts.engine || opts.agenticRegistry) {
     const agStore = new OtlpFileTraceStore({ path: otlpPath, maxFileBytes: GENERATED_TRACE_FILE_CEILING });
     await agStore.ensureIndexed();
@@ -8988,6 +8989,7 @@ async function analyzeSpans(spans, opts = {}) {
       signal: opts.signal,
       ...opts.agenticPriorFindings?.length ? { priorFindings: { "*": opts.agenticPriorFindings } } : {}
     });
+    agenticPerAnalyst = [...agResult.per_analyst];
     result.findings.push(...agResult.findings);
     result.per_analyst.push(...agResult.per_analyst);
     const totalCostUsd = result.total_cost_usd + agResult.total_cost_usd;
@@ -8999,7 +9001,7 @@ async function analyzeSpans(spans, opts = {}) {
     result.total_cost_usd = totalCostUsd;
   }
   opts.signal?.throwIfAborted();
-  return { otlpPath, execution, result };
+  return { otlpPath, execution, result, ...agenticPerAnalyst ? { agenticPerAnalyst } : {} };
 }
 
 // src/reactions.ts
@@ -9125,6 +9127,27 @@ function workflowIssueText(issue) {
 function tableCell(value) {
   return value.replace(/\s+/g, " ").replaceAll("|", "\\|").trim();
 }
+var ANALYST_DETAIL_MAX_CHARS = 240;
+var BRIDGE_FAILURE_MARKER = "DSPY-BRIDGE-FAILURE:";
+function condenseAnalystError(raw, maxChars) {
+  const flat = raw.replace(/\s+/g, " ").trim();
+  const marker = flat.indexOf(BRIDGE_FAILURE_MARKER);
+  let text2 = flat;
+  if (marker >= 0) {
+    const fromMarker = flat.slice(marker);
+    const traceback = fromMarker.indexOf(" Traceback (most recent call last)");
+    text2 = traceback > 0 ? fromMarker.slice(0, traceback) : fromMarker;
+  }
+  const chars = [...text2];
+  if (chars.length <= maxChars) return text2;
+  const headChars = Math.floor(maxChars * 0.4);
+  return `${chars.slice(0, headChars).join("")} \u2026 ${chars.slice(chars.length - (maxChars - headChars)).join("")}`;
+}
+function analystRunDetail(summary) {
+  const raw = summary.status === "failed" && summary.error ? [summary.error.class, summary.error.message].map((part) => part.trim()).filter(Boolean).join(": ") : summary.status === "skipped" && summary.reason ? summary.reason : "";
+  const cell = tableCell(condenseAnalystError(raw, ANALYST_DETAIL_MAX_CHARS));
+  return cell === "" ? "\u2014" : cell;
+}
 function count(value) {
   return Math.round(value).toLocaleString("en-US");
 }
@@ -9333,10 +9356,10 @@ function renderReport(result, meta) {
       }
     }
   }
-  lines.push("| Analyst | Status | Findings | Latency |");
-  lines.push("|---|---|---|---|");
+  lines.push("| Analyst | Status | Findings | Latency | Detail |");
+  lines.push("|---|---|---|---|---|");
   for (const s of result.per_analyst) {
-    lines.push(`| \`${s.analyst_id}\` | ${s.status} | ${s.findings_count} | ${s.latency_ms}ms |`);
+    lines.push(`| \`${s.analyst_id}\` | ${s.status} | ${s.findings_count} | ${s.latency_ms}ms | ${analystRunDetail(s)} |`);
   }
   lines.push("");
   if (findings.length === 0 && deterministic.totalSignals === 0) {
@@ -10015,11 +10038,32 @@ async function runTraceInvestigation(opts) {
     reactions,
     adoption,
     ...agenticRoute ? { agenticRoute } : {},
+    ...analysis.agenticPerAnalyst ? { agenticPerAnalyst: analysis.agenticPerAnalyst } : {},
     external
   };
   const result = { ...partial, report: "" };
   return { ...result, report: renderInvestigationReport(result, analysis.result) };
 }
+var AGENTIC_FAILURE_REASON_MAX_CHARS = 400;
+var BRIDGE_MISMATCH_PATTERN = /must contain exactly|No module named ['"]?agent_eval_rpc|could not start/;
+function condensedReason(summary) {
+  const raw = summary.status === "skipped" ? `skipped \u2014 ${summary.reason ?? "no reason recorded"}` : summary.error ? `${summary.error.class}: ${summary.error.message}` : "failed without an error message";
+  return condenseAnalystError(raw, AGENTIC_FAILURE_REASON_MAX_CHARS);
+}
+function totalAgenticFailureMessage(agenticPerAnalyst, opts = {}) {
+  if (!agenticPerAnalyst || agenticPerAnalyst.length === 0) return void 0;
+  if (agenticPerAnalyst.some((summary) => summary.status === "ok")) return void 0;
+  const lines = [
+    `LLM analysis produced nothing: none of the ${agenticPerAnalyst.length} agentic analyst(s) succeeded. The reported findings are from the deterministic pass only.`,
+    ...agenticPerAnalyst.map((summary) => `  ${summary.analyst_id}: ${condensedReason(summary)}`)
+  ];
+  if (opts.requiredBridgeVersion && agenticPerAnalyst.some((summary) => BRIDGE_MISMATCH_PATTERN.test(summary.error?.message ?? ""))) {
+    lines.push(
+      `hint: the DSPy bridge protocol is version-locked \u2014 the TRACES_PYTHON interpreter needs agent-eval-rpc[dspy]==${opts.requiredBridgeVersion} (matching this package's @tangle-network/agent-eval).`
+    );
+  }
+  return lines.join("\n");
+}
 async function runTraceStoreInvestigation(opts) {
   opts.signal?.throwIfAborted();
   const generatedAt = opts.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString();
@@ -11527,6 +11571,7 @@ export {
   loadTracesConfig,
   mergeTracesConfig,
   runTraceInvestigation,
+  totalAgenticFailureMessage,
   runTraceStoreInvestigation,
   writeTraceImprovementArtifacts,
   runTraceImprovement,

package/dist/cli.js

@@ -37,6 +37,7 @@ import {
   serializeTraceStreamEvent,
   sessionIdFromAttributes,
   streamSessions,
+  totalAgenticFailureMessage,
   traceStreamEventsFromSpans,
   watchSessions,
   writeInspectionReportFile,
@@ -44,7 +45,7 @@ import {
   writePolicyEvidenceFile,
   writeSessionIndexFile,
   writeTraceEvidenceExportFile
-} from "./chunk-7BQ2CVEA.js";
+} from "./chunk-LC66I5TE.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";
@@ -347,7 +348,7 @@ async function resolveSelectedSession(args) {
     `session ID "${args.session}" is ambiguous across ${matches.length} files; select one harness or pass its explicit session path`
   );
 }
-function buildAnalysisEngine(model) {
+function buildAnalysisEngine(model, budgetUsd) {
   const tangleKey = process.env.TANGLE_API_KEY;
   const openAiKey = process.env.OPENAI_API_KEY;
   const apiKey = tangleKey || openAiKey;
@@ -362,9 +363,37 @@ function buildAnalysisEngine(model) {
     apiKey,
     baseUrl,
     model,
+    // agent-eval 0.139.3's engine defaults are tuned below what real runs
+    // need. maxOutputTokens 4096 is under what current coding models emit for
+    // one findings array: glm-5.2 counts reasoning tokens in
+    // completion_tokens, the first oversized completion breaches its cost
+    // reservation, and the fail-closed ledger then refuses every later call
+    // in the run.
+    maxOutputTokens: 16384,
+    // maxCostUsd defaults to $1 per analyst — a proxy-side ceiling separate
+    // from --budget. With the larger token cap the per-call reservation grows
+    // ~4x, so that default binds before the registry's --budget allocation
+    // and kills analysts mid-run. --budget is the operator's spend authority
+    // and the registry still splits it across analysts, so forwarding it here
+    // only stops the engine's own default from cutting runs short.
+    ...budgetUsd !== void 0 && Number.isFinite(budgetUsd) && budgetUsd > 0 ? { maxCostUsd: budgetUsd } : {},
     ...python ? { runner: { command: python } } : {}
   });
 }
+function requiredBridgeVersion() {
+  const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+  const version = pkg.dependencies?.["@tangle-network/agent-eval"];
+  if (typeof version !== "string" || !version) {
+    throw new Error("package.json is missing the @tangle-network/agent-eval dependency");
+  }
+  return version;
+}
+function assertAgenticAnalystsRan(args, agenticPerAnalyst) {
+  if (!args.llm) return;
+  if (!totalAgenticFailureMessage(agenticPerAnalyst)) return;
+  const message = totalAgenticFailureMessage(agenticPerAnalyst, { requiredBridgeVersion: requiredBridgeVersion() });
+  throw new Error(message);
+}
 async function cmdList(args) {
   const groups = await discover({ ...args, last: args.last || 20 });
   for (const { adapter, refs } of groups) {
@@ -636,6 +665,7 @@ async function cmdAnalyze(args) {
   } else {
     console.log(result.report);
   }
+  assertAgenticAnalystsRan(args, result.agenticPerAnalyst);
 }
 async function cmdAnalyzeSupervisorRun(runDir, args) {
   const nested = await findSupervisorRunDirs(runDir);
@@ -692,6 +722,13 @@ async function collectImportedSpans(args) {
     }, spans, sessionId))
   };
 }
+function analystLog(msg, fields) {
+  const error = typeof fields?.error === "string" && fields.error ? fields.error : void 0;
+  const errorClass = typeof fields?.error_class === "string" && fields.error_class ? `${fields.error_class}: ` : "";
+  process.stderr.write(error ? `${msg} \u2014 ${errorClass}${error}
+` : `${msg}
+`);
+}
 function externalAnalyzersFromArgs(args) {
   return args.analyzers.map(
     (spec) => spec === "halo" ? haloAnalyzer({ defaultPrompt: args.analyzerPrompt, model: args.model }) : spec === "hodoscope" ? hodoscopeAnalyzer({ summarizeModel: args.model }) : commandAnalyzer({ name: spec, command: spec, args: (p, prompt) => prompt ? [p, prompt] : [p] })
@@ -705,13 +742,14 @@ async function cmdInvestigate(args) {
   } else {
     console.log(result.report);
   }
+  assertAgenticAnalystsRan(args, result.agenticPerAnalyst);
 }
 async function investigate(args, options = {}) {
   const { spans, harness, cwds, sources, workflow } = await collectSpans(args);
   if (spans.length === 0) throw new Error("no spans found for the given selection");
   const config = args.config !== void 0 || options.loadDefaultConfig !== false ? await loadTracesConfig(args.config) : void 0;
   const analystModel = args.model ?? process.env.TRACES_ANALYST_MODEL ?? DEFAULT_ANALYST_MODEL;
-  const engine = args.llm ? buildAnalysisEngine(analystModel) : void 0;
+  const engine = args.llm ? buildAnalysisEngine(analystModel, args.budget) : void 0;
   return runTraceInvestigation(mergeTracesConfig({
     spans,
     harness,
@@ -725,8 +763,7 @@ async function investigate(args, options = {}) {
     otlpOutPath: args.otlp,
     externalAnalyzers: externalAnalyzersFromArgs(args),
     analyzerPrompt: args.analyzerPrompt,
-    log: (msg) => process.stderr.write(`${msg}
-`)
+    log: analystLog
   }, config));
 }
 async function cmdImprove(args) {
@@ -734,7 +771,7 @@ async function cmdImprove(args) {
   if (spans.length === 0) throw new Error("no spans found for the given selection");
   const config = await loadTracesConfig(args.config);
   const analystModel = args.model ?? process.env.TRACES_ANALYST_MODEL ?? DEFAULT_ANALYST_MODEL;
-  const engine = args.llm ? buildAnalysisEngine(analystModel) : void 0;
+  const engine = args.llm ? buildAnalysisEngine(analystModel, args.budget) : void 0;
   const result = await runTraceImprovement({
     ...mergeTracesConfig({
       spans,
@@ -749,8 +786,7 @@ async function cmdImprove(args) {
       otlpOutPath: args.otlp,
       externalAnalyzers: externalAnalyzersFromArgs(args),
       analyzerPrompt: args.analyzerPrompt,
-      log: (msg) => process.stderr.write(`${msg}
-`)
+      log: analystLog
     }, config),
     outDir: args.dir ?? args.out
   });
@@ -759,6 +795,7 @@ async function cmdImprove(args) {
   console.log(
     `improvement artifacts \u2192 ${dir}  (${result.findings.length} findings with actions and checks, OTLP: ${result.otlpPath})`
   );
+  assertAgenticAnalystsRan(args, result.agenticPerAnalyst);
 }
 function summarizeFindingEvidence(finding) {
   const first = finding.evidence[0];
@@ -1051,7 +1088,9 @@ Options:
   --llm            Enable agentic RLM analysts. Runs on the Tangle router by
                    default (TANGLE_API_KEY); OPENAI_API_KEY alone targets OpenAI,
                    OPENAI_BASE_URL overrides the endpoint. Needs Python with
-                   agent-eval-rpc[dspy] (TRACES_PYTHON selects the interpreter).
+                   agent-eval-rpc[dspy] (TRACES_PYTHON selects the interpreter),
+                   version-matched to this package's @tangle-network/agent-eval.
+                   Exits 1 when every agentic analyst fails, with each reason.
   --model <id>     Model for --llm, HALO, and Hodoscope (default for --llm: ${DEFAULT_ANALYST_MODEL})
   --config <path>  investigate/improve/stream: JS config with analysts, liveAnalysts, or external analyzers
   --budget <usd>   USD cap for agentic analysts

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ToolUseMetrics, InMemoryTraceStore } from '@tangle-network/agent-eval';
 import { StuckLoopReport, FailureClusterReport } from '@tangle-network/agent-eval/pipelines';
-import { TraceAnalystDefinition, TraceAnalysisEngine, AnalystRegistry, AnalystFinding, buildDefaultAnalystRegistry, AnalystRunResult, Analyst } from '@tangle-network/agent-eval/analyst';
+import { TraceAnalystDefinition, TraceAnalysisEngine, AnalystRegistry, AnalystFinding, buildDefaultAnalystRegistry, AnalystRunSummary, AnalystRunResult, Analyst } from '@tangle-network/agent-eval/analyst';
 export { Analyst, AnalystContext, AnalystFinding, AnalystRegistry, buildDefaultAnalystRegistry, makeFinding } from '@tangle-network/agent-eval/analyst';
 import { ExecutionReport } from '@tangle-network/agent-eval/contract';
 import { TraceAnalysisStore, RedactionRule, RedactionReport } from '@tangle-network/agent-eval/traces';
@@ -1223,6 +1223,13 @@ interface AnalyzeResult {
     otlpPath: string;
     execution: ExecutionReport;
     result: Awaited<ReturnType<ReturnType<typeof buildDefaultAnalystRegistry>['run']>>;
+    /**
+     * Per-analyst summaries from the agentic pass alone (also merged into
+     * `result.per_analyst`). Present only when an agentic pass ran; callers use
+     * it to tell "the engine produced nothing" apart from "deterministic-only
+     * run", which the merged list cannot express.
+     */
+    agenticPerAnalyst?: readonly AnalystRunSummary[];
 }
 declare function analyzeSpans(spans: readonly OtlpSpan[], opts?: AnalyzeOptions): Promise<AnalyzeResult>;
 
@@ -1880,6 +1887,13 @@ interface TraceInvestigationResult {
     readonly adoption: AdoptionReport;
     /** Deterministic routing record for the agentic trace-analysis pass. */
     readonly agenticRoute?: TraceAgenticRoute;
+    /**
+     * Per-analyst summaries from the agentic pass alone. Present only when an
+     * agentic pass ran; failed entries carry the engine's error (bridge stderr
+     * included), so callers can fail loud instead of reporting the deterministic
+     * findings as if the requested LLM analysis had happened.
+     */
+    readonly agenticPerAnalyst?: readonly AnalystRunSummary[];
     readonly external: readonly ExternalAnalysisResult[];
     readonly report: string;
 }
@@ -1923,6 +1937,16 @@ declare function buildTraceFindingPacket(opts: BuildTraceFindingPacketOptions):
 declare function loadTracesConfig(path?: string): Promise<TracesConfig | undefined>;
 declare function mergeTracesConfig(opts: TraceInvestigationOptions, config?: TracesConfig): TraceInvestigationOptions;
 declare function runTraceInvestigation(opts: TraceInvestigationOptions): Promise<TraceInvestigationResult>;
+/**
+ * Operator-facing message for a fully dead agentic pass: non-empty exactly
+ * when an agentic pass ran and NO analyst in it succeeded — failed and
+ * skipped both count as "produced nothing", so one skip cannot silence the
+ * alarm. Partial success returns undefined: some agentic findings were
+ * produced, and the per-analyst report table carries the individual reasons.
+ */
+declare function totalAgenticFailureMessage(agenticPerAnalyst: readonly AnalystRunSummary[] | undefined, opts?: {
+    requiredBridgeVersion?: string;
+}): string | undefined;
 declare function runTraceStoreInvestigation(opts: TraceStoreInvestigationOptions): Promise<TraceStoreInvestigationResult>;
 declare function writeTraceImprovementArtifacts(result: Omit<TraceImprovementResult, 'artifacts'>, outDir?: string): Promise<TraceImprovementArtifacts>;
 declare function runTraceImprovement(opts: TraceImprovementOptions): Promise<TraceImprovementResult>;
@@ -2188,4 +2212,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, 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, CopilotAdapter, type CorruptionMode, DEFAULT_HARNESS, EmptySessionError, type ExecuteOptions, type ExternalAnalysisKind, type ExternalAnalysisPayload, type ExternalAnalysisResult, type ExternalAnalyzer, type ExternalAnalyzerOptions, type ExternalDiscoveryCandidate, FactoryAdapter, ForgeAdapter, GeminiAdapter, type HaloAnalyzerOptions, type HaloReasoningEffort, type HarnessTraceAdapter, type HodoscopeAnalyzerOptions, type HodoscopeInput, type HodoscopeMessage, type HodoscopeSourceMapEntry, type HodoscopeTrajectory, 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 ParentTaskResolution, 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 SessionRelationship, type SessionRole, type SessionSeedGroup, type SessionSelection, type SessionSelectionRow, type SessionSourceFile, type SessionWorkflow, SessionWorkflowError, type SessionWorkflowErrorCode, type SessionWorkflowIssue, type SessionWorkflowSession, type SessionWorkflowSummary, 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, chatTrajectoryToSpans, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessionSelection, collectSessionWorkflow, collectSessions, commandAnalyzer, commandRedactor, countSkillRunsJsonl, cwdMatchesSelection, defaultTraceLiveAnalysts, describeSessionRelationship, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, haloAnalyzer, hodoscopeAnalyzer, importCodeTraceBench, indexSessionIdsByTrace, inspectSessionIndex, isChatTrajectory, isChatTrajectoryMessage, 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, validateOtlpSpans, watchSessions, writeHodoscopeInput, 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, 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, CopilotAdapter, type CorruptionMode, DEFAULT_HARNESS, EmptySessionError, type ExecuteOptions, type ExternalAnalysisKind, type ExternalAnalysisPayload, type ExternalAnalysisResult, type ExternalAnalyzer, type ExternalAnalyzerOptions, type ExternalDiscoveryCandidate, FactoryAdapter, ForgeAdapter, GeminiAdapter, type HaloAnalyzerOptions, type HaloReasoningEffort, type HarnessTraceAdapter, type HodoscopeAnalyzerOptions, type HodoscopeInput, type HodoscopeMessage, type HodoscopeSourceMapEntry, type HodoscopeTrajectory, 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 ParentTaskResolution, 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 SessionRelationship, type SessionRole, type SessionSeedGroup, type SessionSelection, type SessionSelectionRow, type SessionSourceFile, type SessionWorkflow, SessionWorkflowError, type SessionWorkflowErrorCode, type SessionWorkflowIssue, type SessionWorkflowSession, type SessionWorkflowSummary, 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, chatTrajectoryToSpans, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessionSelection, collectSessionWorkflow, collectSessions, commandAnalyzer, commandRedactor, countSkillRunsJsonl, cwdMatchesSelection, defaultTraceLiveAnalysts, describeSessionRelationship, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, haloAnalyzer, hodoscopeAnalyzer, importCodeTraceBench, indexSessionIdsByTrace, inspectSessionIndex, isChatTrajectory, isChatTrajectoryMessage, 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, totalAgenticFailureMessage, traceAgenticKinds, traceStreamEventsFromSpans, uploadKey, userPromptSpan, validateOtlpSpans, watchSessions, writeHodoscopeInput, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts };

package/dist/index.js

@@ -118,6 +118,7 @@ import {
   toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
+  totalAgenticFailureMessage,
   traceAgenticKinds,
   traceStreamEventsFromSpans,
   uploadKey,
@@ -131,7 +132,7 @@ import {
   writeSessionIndexFile,
   writeTraceEvidenceExportFile,
   writeTraceImprovementArtifacts
-} from "./chunk-7BQ2CVEA.js";
+} from "./chunk-LC66I5TE.js";
 
 // src/collect.ts
 async function collectSessions(opts = {}) {
@@ -284,6 +285,7 @@ export {
   toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
+  totalAgenticFailureMessage,
   traceAgenticKinds,
   traceStreamEventsFromSpans,
   uploadKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/traces",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "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",
@@ -47,7 +47,7 @@
     "node": ">=22"
   },
   "dependencies": {
-    "@tangle-network/agent-eval": "0.139.3"
+    "@tangle-network/agent-eval": "0.140.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",