@tangle-network/traces 0.22.0 → 0.23.1

package/dist/cli.js

@@ -13,7 +13,6 @@ import {
   assertOutsideSourceBundle,
   assessSpans,
   buildPolicyEvidenceRecord,
-  buildSessionFactsReport,
   buildSessionIndexFromRows,
   buildSkillUsageReport,
   cmdReplayVerify,
@@ -22,6 +21,7 @@ import {
   collectSessionSelection,
   commandAnalyzer,
   commandRedactor,
+  createSessionFactsReportBuilder,
   defaultSkillUsageStorePath,
   diffRuns,
   executeUpload,
@@ -47,6 +47,7 @@ import {
   parseIsoToEpochMs,
   parseSession,
   parseSince,
+  parseTimeBound,
   planUpload,
   primeAnalyzer,
   projectSessionBundle,
@@ -66,6 +67,7 @@ import {
   runTraceInvestigation,
   runTraceQuestions,
   saveReport,
+  scanSessions,
   selectAdapters,
   serializePolicyEvidence,
   serializeSessionIndex,
@@ -90,7 +92,7 @@ import {
   writeSessionIndexFile,
   writeTraceEvidenceExportFile,
   writeTraceQuestionsArtifacts
-} from "./chunk-DON6NQ7H.js";
+} from "./chunk-7DVZCCZI.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";
@@ -489,6 +491,9 @@ function parseArgs(argv) {
       case "--since":
         a.since = next();
         break;
+      case "--until":
+        a.until = next();
+        break;
       case "--out":
         a.out = next();
         break;
@@ -703,6 +708,10 @@ function validateViewSelection(args) {
     `--view is not supported by ${args.command}. A view is a projection of an assembled bundle: run \`traces bundle ... --out <dir>\` first, then \`traces bundle-view <dir> --view evidence-only --out <view-dir>\`.`
   );
 }
+function validateUntilSelection(args) {
+  if (args.until === void 0 || args.command === "facts") return args;
+  throw new Error(`--until is not supported by ${args.command}; it bounds the facts window (traces facts --since <t> --until <t>)`);
+}
 function validateWorkflowSelection(args) {
   if (!args.workflow && !args.latestTurn) return args;
   if (!WORKFLOW_COMMANDS.has(args.command)) {
@@ -736,7 +745,7 @@ function adaptersFor(args) {
   return selectAdapters({ all: args.all, harnesses: [args.harness] });
 }
 async function discover(args) {
-  const sinceMs = args.since ? Date.parse(args.since) : void 0;
+  const sinceMs = args.since ? parseSince(args.since) : void 0;
   const out = [];
   for (const adapter of adaptersFor(args)) {
     let refs = await locateSessions(adapter, { cwd: args.cwd, sinceMs });
@@ -1201,10 +1210,50 @@ async function cmdFacts(args) {
   if (format !== "json" && format !== "text") {
     throw new Error(`unknown facts format "${format}" (expected json or text)`);
   }
-  const collected = await collectSpans(args);
-  if (collected.spans.length === 0) throw new Error("no spans found for the given selection");
-  warnIncompleteWorkflow(collected.workflow);
-  const report = buildSessionFactsReport(collected.spans, { harness: collected.harness, includeContent: !args.noContent });
+  const window = args.since !== void 0 || args.until !== void 0 ? {
+    ...args.since !== void 0 ? { since: new Date(parseSince(args.since)).toISOString() } : {},
+    ...args.until !== void 0 ? { until: new Date(parseTimeBound(args.until, "--until")).toISOString() } : {}
+  } : void 0;
+  const builder = createSessionFactsReportBuilder({ includeContent: !args.noContent, window });
+  let report;
+  const discoversWindow = window !== void 0 && !args.session && !args.otlp && !args.input && !args.sourceBundle && !args.workflow;
+  if (discoversWindow) {
+    const harnesses = /* @__PURE__ */ new Set();
+    for await (const scanned of scanSessions({
+      adapters: adaptersFor(args),
+      cwd: args.cwd,
+      sinceMs: window.since === void 0 ? void 0 : Date.parse(window.since),
+      last: args.last > 0 ? args.last : void 0,
+      taskScope: args.latestTurn ? "latest" : "all",
+      onError: (error, ref) => {
+        if (!ref) throw error;
+        builder.addUnread({
+          sessionId: ref.sessionId,
+          traceId: null,
+          source: ref.path,
+          reason: error instanceof Error ? error.message : String(error)
+        });
+      }
+    })) {
+      harnesses.add(scanned.adapter.harness);
+      builder.add(scanned.spans);
+    }
+    report = { ...builder.build(), harness: [...harnesses].join("+") || args.harness };
+  } else {
+    const collected = await collectSpans(args);
+    if (collected.spans.length === 0) throw new Error("no spans found for the given selection");
+    warnIncompleteWorkflow(collected.workflow);
+    builder.add(collected.spans);
+    report = { ...builder.build(), harness: collected.harness };
+  }
+  const unreadInWindow = report.selection?.unreadSessions ?? [];
+  if (unreadInWindow.length > 0) {
+    const named = unreadInWindow.slice(0, 3).map((entry) => entry.source ?? entry.sessionId ?? entry.traceId);
+    process.stderr.write(
+      `warning: ${unreadInWindow.length} session(s) could not be read; each is named with its reason in selection.unreadSessions (${named.join(", ")}${unreadInWindow.length > named.length ? ", \u2026" : ""})
+`
+    );
+  }
   const unread = report.sessions.filter((facts) => facts.recordSpans === 0);
   if (unread.length > 0) {
     throw new Error(
@@ -2050,10 +2099,15 @@ Commands:
             sessions: tool calls excluding synthesized spans, subagent spawns
             with task names, human turns in order, the final message per task,
             changed paths, first/last record times, the harness token total, and
-            the first failure by agent-eval's fixed precedence (or none).
+            the first failure by agent-eval's fixed precedence (or none), the
+            session's recorded working directory, and for each human turn the
+            agent message it answered.
             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)
+            --since/--until select every session with a record in the window and
+            count only that window's turns; a session that cannot be read is named
+            in selection.unreadSessions. Without a window: exit 1 when a selected
+            session cannot be read. --format json (default) or text
   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
@@ -2129,7 +2183,11 @@ Options:
                    accepted vs rejected. Rolls up when the dir holds many runs.
                    analyze reads Runtime journals and recorded startup failures.
                    watch reads a live Runtime journal and OTLP span files.
-  --since <t>      upload: window, 30m / 2h / 7d or an ISO date (default 24h); analyze: ISO cutoff
+  --since <t>      30m / 2h / 7d (before now) or an ISO date. Selection commands read
+                   sessions modified at or after it; upload: its window (default 24h).
+                   facts: opens a time window and selects EVERY session with a record
+                   in it, not only the newest; its turn facts keep only turns inside it
+  --until <t>      facts: closes the window (exclusive), same forms as --since
   --out <path>     Write report to a file
   --dir <path>     improve/ask: write artifacts to this directory
   --otlp <file|dir>  READ OTLP-JSONL emitted by any system, skipping the adapters.
@@ -2261,7 +2319,7 @@ async function main() {
     return;
   }
   const args = validateOtlpSelection(
-    validateViewSelection(validateWorkflowSelection(applyCurrentSessionSelection(parsedArgs)))
+    validateViewSelection(validateWorkflowSelection(validateUntilSelection(applyCurrentSessionSelection(parsedArgs))))
   );
   switch (args.command) {
     case "help":

package/dist/index.d.ts

@@ -900,6 +900,14 @@ declare const ATTR: {
      *  in-container path even when no such path exists on this host. */
     readonly ENVIRONMENT_CWD: "tangle.environment.cwd";
 };
+/**
+ * The working directory the harness recorded for a session, verbatim, on the
+ * adapter's root `session` span. Unlike `tangle.cwd` it is never repaired,
+ * decoded from a directory name, or inferred from paths the spans mention: an
+ * adapter sets it only from a field the session source itself carries, and
+ * leaves it absent when the source names none.
+ */
+declare const SESSION_CWD_ATTR = "traces.session.cwd";
 /** `tangle.ingest_source` value for CLI-uploaded traces. Wire contract. */
 declare const INGEST_SOURCE_CLI = "cli";
 /**
@@ -957,6 +965,9 @@ declare function parseIsoToEpochMs(ts: string): number;
 /** Parse a `--since` window: `30m` / `2h` / `7d` (relative to now) or an ISO
  *  date, → epoch ms. Throws on a malformed value (fail-loud, not silent). */
 declare function parseSince(value: string): number;
+/** Parse one time bound the way `--since` reads it: `30m` / `2h` / `7d` before
+ *  now, or an ISO date. `flag` names the option in the error. */
+declare function parseTimeBound(value: string, flag: string): number;
 
 type JsonSourceErrorKind = 'read' | 'parse';
 declare class JsonSourceError extends Error {
@@ -3844,10 +3855,28 @@ declare function readPullRequests(spans: readonly OtlpSpan[]): PullRequestReadin
  * deltas, which is a different (and smaller) number.
  */
 /** Cache invalidation key for deterministic measurements and prepared analyst context. */
-declare const SESSION_FACTS_MEASUREMENT_VERSION = "3";
+declare const SESSION_FACTS_MEASUREMENT_VERSION = "4";
+/**
+ * A half-open time window: a time `t` is inside when `since <= t < until`.
+ * Either bound may be absent, which leaves that side open.
+ */
+interface SessionFactsWindow {
+    /** ISO-8601 lower bound, inclusive. */
+    readonly since?: string;
+    /** ISO-8601 upper bound, exclusive. */
+    readonly until?: string;
+}
 interface SessionFactsOptions {
     /** Defaults to true for compatibility. False withholds conversation, commands, paths and assignment text. */
     readonly includeContent?: boolean;
+    /**
+     * Limit the turn facts to a time window. `humanTurns`, `excludedTurns` and
+     * `turnsByActor` keep only `user.prompt` turns that started inside it; every
+     * other fact still covers the whole session. A report built with a window
+     * also leaves out every session with no record inside it, and names them in
+     * {@link SessionFactsReport.selection}.
+     */
+    readonly window?: SessionFactsWindow;
 }
 declare const SESSION_TOKEN_TOTAL_ATTR = "traces.session.total_tokens";
 /**
@@ -3859,6 +3888,8 @@ declare const SESSION_TOKEN_TOTAL_ATTR = "traces.session.total_tokens";
 declare const SPAN_SYNTHESIZED_ATTR = "traces.codex.span_synthesized";
 /** Max characters of message or prompt text kept per fact entry. */
 declare const FACT_TEXT_CAP = 2000;
+/** Max characters of the agent message kept in {@link SessionTurnFact.answered}. */
+declare const ANSWERED_TEXT_CAP = 1500;
 /** Entries kept per list field before the sheet reports the rest as omitted. */
 declare const FACT_LIST_CAP = 200;
 /**
@@ -3904,6 +3935,15 @@ interface SessionTurnFact {
     readonly at: string;
     readonly text: string;
     readonly spanId: string;
+    /**
+     * The text of the last message this session's own agent wrote before the
+     * turn: what the person was answering. Clipped to {@link ANSWERED_TEXT_CAP}
+     * characters with a visible `… [+N chars]` marker. Null when the agent had
+     * written no text before the turn.
+     */
+    readonly answered: string | null;
+    /** The `message.assistant` span `answered` was read from. */
+    readonly answeredSpanId: string | null;
 }
 /** How many `user.prompt` turns each actor produced. */
 interface TurnActorCount {
@@ -3952,6 +3992,13 @@ interface SessionFacts {
     readonly traceId: string;
     readonly sessionId: string | null;
     readonly harness: string | null;
+    /**
+     * The working directory the harness recorded for the session, read from
+     * `traces.session.cwd` on the adapter's root span. Null with the reason when
+     * no span carries it; never decoded from a directory name or inferred from
+     * the paths the session touched.
+     */
+    readonly cwd: SessionFact<string>;
     /** Spans in this trace, including the synthesized ones. */
     readonly spanCount: number;
     /**
@@ -4002,18 +4049,45 @@ interface SessionFacts {
     readonly firstFailure: FirstFailure;
     readonly measurements: SessionMeasurements;
 }
+/** A session the report could not read, so whether it belongs in the window is unknown. */
+interface UnreadSessionFact {
+    readonly sessionId: string | null;
+    readonly traceId: string | null;
+    /** Where the session was read from, when the reader knows. */
+    readonly source: string | null;
+    readonly reason: string;
+}
+/** How a windowed report chose its sessions and turns. Null on a report built without a window. */
+interface SessionFactsSelection {
+    /** The window's inclusive lower bound, or null when open. */
+    readonly since: string | null;
+    /** The window's exclusive upper bound, or null when open. */
+    readonly until: string | null;
+    /** Which sessions the report holds. */
+    readonly sessionRule: string;
+    /** Which turns `humanTurns`, `excludedTurns` and `turnsByActor` hold. */
+    readonly turnRule: string;
+    /** Sessions read in full whose records all fall outside the window, by session id. */
+    readonly outsideWindow: readonly string[];
+    /** Sessions that could not be read; each is named with the reason, never counted as empty. */
+    readonly unreadSessions: readonly UnreadSessionFact[];
+}
 interface SessionFactsReport {
     readonly schemaVersion: 1;
     readonly kind: 'traces.session_facts_report';
     readonly generatedAt: string;
     readonly measurementVersion: typeof SESSION_FACTS_MEASUREMENT_VERSION;
-    /** SHA-256 of the canonical selected spans, including content, attributes, links and timing. */
+    /**
+     * SHA-256 over the selected sessions in trace-id order, each contributing the
+     * SHA-256 of its canonical spans (content, attributes, links and timing).
+     */
     readonly sourceDigest: string;
     /** Latest recorded endpoint, not the last time the filesystem was checked. */
     readonly evidenceThrough: string | null;
     readonly contentIncluded: boolean;
     readonly harness: string | null;
     readonly spanCount: number;
+    readonly selection: SessionFactsSelection | null;
     readonly sessions: readonly SessionFacts[];
 }
 /**
@@ -4022,11 +4096,25 @@ interface SessionFactsReport {
  * model, network call, or budget is involved.
  */
 declare function computeSessionFacts(spans: readonly OtlpSpan[], options?: SessionFactsOptions): SessionFacts[];
-/** The facts sheet for a set of spans, as one report. */
-declare function buildSessionFactsReport(spans: readonly OtlpSpan[], options?: SessionFactsOptions & {
+type SessionFactsReportOptions = SessionFactsOptions & {
     harness?: string | null;
     generatedAt?: string;
-}): SessionFactsReport;
+};
+/** The facts sheet for a set of spans, as one report. */
+declare function buildSessionFactsReport(spans: readonly OtlpSpan[], options?: SessionFactsReportOptions): SessionFactsReport;
+/**
+ * Builds one report from sessions supplied a batch at a time, so a caller
+ * reading many sessions holds one session's spans at once rather than all of
+ * them. `add` the whole spans of one or more sessions per call; a trace split
+ * across two calls is reported as two sessions.
+ */
+interface SessionFactsReportBuilder {
+    add(spans: readonly OtlpSpan[]): void;
+    /** Name a session that could not be read at all. Only a windowed report holds these. */
+    addUnread(session: UnreadSessionFact): void;
+    build(): SessionFactsReport;
+}
+declare function createSessionFactsReportBuilder(options?: SessionFactsReportOptions): SessionFactsReportBuilder;
 /** The short readable form: the same facts, one screen, no span-id lists. */
 declare function renderSessionFacts(report: SessionFactsReport): string;
 /**
@@ -5129,4 +5217,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, 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, 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 };
+export { ACTOR_ATTR, ANSWERED_TEXT_CAP, 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, 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_CWD_ATTR, 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 SessionFactsReportBuilder, type SessionFactsReportOptions, type SessionFactsSelection, type SessionFactsWindow, 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 UnreadSessionFact, 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, createSessionFactsReportBuilder, 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, parseTimeBound, 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 };

package/dist/index.js

@@ -1,5 +1,6 @@
 import {
   ACTOR_ATTR,
+  ANSWERED_TEXT_CAP,
   ATTR,
   AmpAdapter,
   BLOBS_DIR,
@@ -43,6 +44,7 @@ import {
   REACTIONS,
   RESULT_FILE,
   RULE,
+  SESSION_CWD_ATTR,
   SESSION_FACTS_MEASUREMENT_VERSION,
   SESSION_FACTS_VERSION_SUFFIX,
   SESSION_TOKEN_TOTAL_ATTR,
@@ -100,6 +102,7 @@ import {
   countSkillRunsJsonl,
   createBundleSourceReader,
   createFindingRejectionTally,
+  createSessionFactsReportBuilder,
   cwdMatchesSelection,
   cwdMatchesSelectionResolved,
   defaultSkillCatalogRoots,
@@ -167,6 +170,7 @@ import {
   parseJsonAnswer,
   parseSession,
   parseSince,
+  parseTimeBound,
   planTraceAgenticRoute,
   planUpload,
   primeAnalyzer,
@@ -283,7 +287,7 @@ import {
   writeTraceQuestionsArtifacts,
   zaiChatCaller,
   zeroPricedCost
-} from "./chunk-DON6NQ7H.js";
+} from "./chunk-7DVZCCZI.js";
 
 // src/adapters/factory.ts
 import { readdir, stat } from "fs/promises";
@@ -936,6 +940,7 @@ async function parseRetainedSession(input) {
 }
 export {
   ACTOR_ATTR,
+  ANSWERED_TEXT_CAP,
   ATTR,
   AmpAdapter,
   AnalystRegistry,
@@ -983,6 +988,7 @@ export {
   RESULT_FILE,
   RETAINED_SESSION_READER_VERSION,
   RULE,
+  SESSION_CWD_ATTR,
   SESSION_FACTS_MEASUREMENT_VERSION,
   SESSION_FACTS_VERSION_SUFFIX,
   SESSION_TOKEN_TOTAL_ATTR,
@@ -1044,6 +1050,7 @@ export {
   createBundleSourceReader,
   createFindingRejectionTally,
   createHostedClient,
+  createSessionFactsReportBuilder,
   cwdMatchesSelection,
   cwdMatchesSelectionResolved,
   defaultSkillCatalogRoots,
@@ -1112,6 +1119,7 @@ export {
   parseRetainedSession,
   parseSession,
   parseSince,
+  parseTimeBound,
   planTraceAgenticRoute,
   planUpload,
   primeAnalyzer,

package/docs/trace-analysts.md

@@ -198,7 +198,8 @@ The sheet is that extraction, made part of the tool.
 | `subagentToolSpans` | TOOL spans excluded because a subagent, not this agent, made the call |
 | `subagents` | every subagent-spawning call, with the task name the call recorded |
 | `pullRequests` | pull requests the commands created and merged, each named by number or head branch, with the command span and the join evidence |
-| `humanTurns` | `user.prompt` turns a person typed into this session, in order, with timestamps |
+| `cwd` | the working directory the harness recorded for the session, or `null` with the reason |
+| `humanTurns` | `user.prompt` turns a person typed into this session, in order, with timestamps, each with the agent message it `answered` |
 | `excludedTurns` | every `user.prompt` turn `humanTurns` left out, grouped by the reason, with the span ids |
 | `turnsByActor` | every `user.prompt` turn by actor, so the human filter is checkable |
 | `finalMessages` | the last message of the session's own agent, and of each subagent task, separately |
@@ -242,7 +243,7 @@ It reaches the built-in kinds run by `analyze --llm`, `investigate`, and `improv
 
 - The sheet is bounded at `PREPARED_CONTEXT_BYTE_CEILING` (30,000 bytes), a fifth of the `perCallByteCeiling` of 150,000 the trace tools work to, so the rest of the budget stays available for the tool calls the model still makes.
 - When the sheet does not fit, fields are shed from the largest downward and the shed is listed in `omitted_fields`. The tool-call counts are the last facts to go.
-- Receiving the sheet changes an analyst's behavior, so its version carries `+session-facts.2`. `createTraceAnalyst` records `prepare_context` in the exact-run identity, and a changed prepared context must not hide behind an unchanged version.
+- Receiving the sheet changes an analyst's behavior, so its version carries `SESSION_FACTS_VERSION_SUFFIX` (`+session-facts.` and the sheet's `measurementVersion`). `createTraceAnalyst` records `prepare_context` in the exact-run identity, and a changed prepared context must not hide behind an unchanged version.
 - The sheet is not evidence. Citations still resolve against the raw spans, which is why every fact names its span ids rather than asking the model to trust the sheet.
 
 Pass `sessionFactsContext: false` to `analyzeSpans` to run an analyst without it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/traces",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "description": "Point it at your coding-agent session traces (Claude Code, Codex, OpenCode, Gemini, Pi, \u2026) and get failure-mode + efficiency findings. CLI + SDK over the @tangle-network/agent-eval analyst suite \u2014 observe live sessions, run your own analysts, redact, and upload to the Tangle Intelligence Platform.",
   "type": "module",
   "license": "MIT",
@@ -65,7 +65,7 @@
     "@tangle-network/agent-interface": "5.2.0",
     "@tangle-network/agent-runtime": "0.318.0",
     "@tangle-network/agent-trace-contract": "2.0.0",
-    "@tangle-network/harness-sessions": "0.1.0",
+    "@tangle-network/harness-sessions": "0.1.3",
     "@tangle-network/sandbox": "0.60.49"
   },
   "devDependencies": {