@tangle-network/traces 0.19.1 → 0.21.0

package/dist/index.js

@@ -18,14 +18,15 @@ import {
   DEFAULT_ASK_CONCURRENCY,
   DEFAULT_HARNESS,
   DEFAULT_SANDBOX_BASE_URL,
+  DEFAULT_SWEEP_THRESHOLD,
   EMPTY_SPAN_RUN_SNAPSHOT,
   EXPORT_RULE,
   EmptySessionError,
   FACT_LIST_CAP,
   FACT_TEXT_CAP,
-  FactoryAdapter,
   ForgeAdapter,
   GeminiAdapter,
+  HarnessSessionsAdapter,
   INGEST_SOURCE_CLI,
   INHERITED_SOURCE_ATTR,
   INHERITED_SPANS_OMITTED_ATTR,
@@ -39,7 +40,6 @@ import {
   POLICY_EVIDENCE_NOTE,
   PREPARED_CONTEXT_BYTE_CEILING,
   PartialUploadError,
-  PiAdapter,
   QwenAdapter,
   REACTIONS,
   RESULT_FILE,
@@ -54,6 +54,7 @@ import {
   SYNTHESIZED_SOURCE_ATTR,
   SYNTHESIZED_SPAN_ATTR,
   SessionWorkflowError,
+  SkillUsageStore,
   TRACE_QUESTION_PREVIEW_HEAD_CHARS,
   ZERO_ROLL,
   addSpend,
@@ -75,6 +76,7 @@ import {
   buildSessionFactsReport,
   buildSessionIndex,
   buildSessionIndexFromRows,
+  buildSkillUsageReport,
   buildSpanRunTree,
   buildTraceFindingPacket,
   capText,
@@ -101,6 +103,9 @@ import {
   createFindingRejectionTally,
   cwdMatchesSelection,
   cwdMatchesSelectionResolved,
+  defaultSkillCatalogRoots,
+  defaultSkillUsageSources,
+  defaultSkillUsageStorePath,
   defaultTraceLiveAnalysts,
   describeSessionRelationship,
   diffRuns,
@@ -139,6 +144,8 @@ import {
   isChatTrajectoryMessage,
   isFileRunContextDir,
   isInheritedSpan,
+  isMissingJsonSource,
+  isMissingPathError,
   isSynthesizedSpan,
   iterSerializedSpans,
   knownHarnesses,
@@ -167,6 +174,7 @@ import {
   projectSessionBundle,
   readCoordinationLog,
   readFileRunContext,
+  readInstalledSkills,
   readJsonFile,
   readJsonl,
   readOtlpInput,
@@ -179,6 +187,7 @@ import {
   readSessionIndexFile,
   readSpanRunSnapshot,
   recordSessionCorruption,
+  recordToolOutput,
   redactSpans,
   renderConformance,
   renderInspectionReport,
@@ -187,6 +196,7 @@ import {
   renderRunWatchSnapshot,
   renderSessionFacts,
   renderSessionFactsContext,
+  renderSkillUsage,
   renderSpanRunSnapshot,
   renderTraceQuestionInstructions,
   renderTraceQuestionPrompt,
@@ -220,9 +230,11 @@ import {
   sessionHash,
   sessionIdFromAttributes,
   sessionIntegrityAttributes,
+  sessionJsonlOptions,
   sessionTextSignatures,
   shellCommands,
   skippedAnalyses,
+  sourceOf,
   span,
   spanRunTotals,
   stampEnvironmentAttrs,
@@ -236,10 +248,12 @@ import {
   summarizeSpanStructure,
   takeJsonl,
   textIsSynthetic,
+  textSources,
   toOpenInferenceSpan,
   toRuntimeStore,
   toTraceSpanEvents,
   tokens,
+  toolIoAttributes,
   totalAgenticFailureMessage,
   totalFindingRejections,
   traceAgenticKinds,
@@ -270,7 +284,517 @@ import {
   writeTraceQuestionsArtifacts,
   zaiChatCaller,
   zeroPricedCost
-} from "./chunk-YVCHWHCA.js";
+} from "./chunk-KEB25UHZ.js";
+
+// src/adapters/factory.ts
+import { readdir, stat } from "fs/promises";
+import { homedir } from "os";
+import { basename, join } from "path";
+var SERVICE = "factory";
+function textOf(content) {
+  return capText(
+    (content ?? []).filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("")
+  );
+}
+var FactoryAdapter = class {
+  harness = "factory";
+  aliases = ["factory-droids", "droid"];
+  root() {
+    return join(homedir(), ".factory", "sessions");
+  }
+  async locate(opts = {}) {
+    const root = this.root();
+    let dirs;
+    try {
+      dirs = await readdir(root);
+    } catch (error) {
+      if (isMissingPathError(error)) return [];
+      throw error;
+    }
+    const refs = [];
+    for (const dir of dirs) {
+      const dp = join(root, dir);
+      let files;
+      try {
+        files = await readdir(dp);
+      } catch (error) {
+        if (isMissingPathError(error)) continue;
+        throw error;
+      }
+      const cwd = dir.replace(/-/g, "/");
+      if (opts.cwd && !cwd.startsWith(opts.cwd)) continue;
+      for (const f of files) {
+        if (!f.endsWith(".jsonl")) continue;
+        const path = join(dp, f);
+        let st;
+        try {
+          st = await stat(path);
+        } catch (error) {
+          if (isMissingPathError(error)) continue;
+          throw error;
+        }
+        if (opts.sinceMs && st.mtimeMs < opts.sinceMs) continue;
+        refs.push({ harness: this.harness, sessionId: basename(f, ".jsonl"), path, cwd, mtimeMs: st.mtimeMs });
+      }
+    }
+    return refs.sort((a, b) => b.mtimeMs - a.mtimeMs);
+  }
+  async sourcePaths(ref) {
+    const sidecar = ref.path.replace(/\.jsonl$/, ".settings.json");
+    try {
+      await stat(sidecar);
+      return [ref.path, sidecar];
+    } catch (error) {
+      if (isMissingPathError(error)) return [ref.path];
+      throw error;
+    }
+  }
+  async parse(ref, options = {}) {
+    let settings = {};
+    try {
+      settings = await readJsonFile(ref.path.replace(/\.jsonl$/, ".settings.json"));
+    } catch (error) {
+      if (!isMissingJsonSource(error)) throw error;
+    }
+    const sourceTraceId = ref.sessionId;
+    const sourceRootId = `root:${sourceTraceId}`;
+    const spans = [];
+    const toolByUseId = /* @__PURE__ */ new Map();
+    let firstTimestamp;
+    let lastTimestamp;
+    let sessionLine;
+    let sawLine = false;
+    let step = 0;
+    let lastLlm = sourceRootId;
+    for await (const l of readJsonl(ref.path, sessionJsonlOptions(ref, options))) {
+      if (!sawLine) {
+        firstTimestamp = l.timestamp;
+        sawLine = true;
+      }
+      lastTimestamp = l.timestamp;
+      if (!sessionLine && l.type === "session_start") {
+        sessionLine = { id: l.id, timestamp: l.timestamp };
+      }
+      if (l.type !== "message" || !l.message) continue;
+      const ts = l.timestamp ?? (/* @__PURE__ */ new Date(0)).toISOString();
+      const role = l.message.role;
+      const text = textOf(l.message.content);
+      if (role === "user") {
+        if (text) {
+          spans.push(
+            userPromptSpan({
+              traceId: sourceTraceId,
+              spanId: `user:${l.id ?? step}`,
+              parentSpanId: sourceRootId,
+              startTime: ts,
+              content: text,
+              contentSource: textSources(l.message, "content"),
+              service: SERVICE,
+              agent: SERVICE,
+              step
+            })
+          );
+          step += 1;
+        }
+      } else {
+        const llmId = `llm:${l.id ?? step}`;
+        spans.push(
+          span({
+            traceId: sourceTraceId,
+            spanId: llmId,
+            parentSpanId: sourceRootId,
+            name: `message.${role ?? "unknown"}`,
+            kind: "LLM",
+            startTime: ts,
+            service: SERVICE,
+            agent: SERVICE,
+            model: settings.model ?? null,
+            step,
+            content: text || null,
+            contentSource: textSources(l.message, "content")
+          })
+        );
+        lastLlm = llmId;
+        step += 1;
+      }
+      for (const b of l.message.content ?? []) {
+        if (b.type === "tool_use" && b.name) {
+          const t = span({
+            traceId: sourceTraceId,
+            spanId: `tool:${b.id ?? `${l.id}:${step}`}`,
+            parentSpanId: lastLlm,
+            name: `tool.${b.name}`,
+            kind: "TOOL",
+            startTime: ts,
+            service: SERVICE,
+            agent: SERVICE,
+            tool: b.name,
+            step,
+            extra: toolIoAttributes({ input: b.input, inputSource: sourceOf(b, "input") })
+          });
+          spans.push(t);
+          if (b.id) toolByUseId.set(b.id, t);
+          step += 1;
+        } else if (b.type === "tool_result" && b.tool_use_id) {
+          const t = toolByUseId.get(b.tool_use_id);
+          if (t) {
+            t.status = b.is_error === true ? { code: "ERROR", message: "tool reported error" } : { code: "OK" };
+            recordToolOutput(t, b.content, sourceOf(b, "content"));
+          }
+        }
+      }
+    }
+    const traceId = sessionLine?.id ?? sourceTraceId;
+    const rootId = `root:${traceId}`;
+    for (const item of spans) {
+      item.trace_id = traceId;
+      if (item.parent_span_id === sourceRootId) item.parent_span_id = rootId;
+    }
+    const root = span({
+      traceId,
+      spanId: rootId,
+      parentSpanId: null,
+      name: "session",
+      kind: "AGENT",
+      startTime: sessionLine?.timestamp ?? firstTimestamp ?? (/* @__PURE__ */ new Date(0)).toISOString(),
+      endTime: lastTimestamp,
+      service: SERVICE,
+      agent: SERVICE,
+      model: settings.model ?? null,
+      extra: settings.tokenUsage ? {
+        "session.input_tokens": settings.tokenUsage.inputTokens ?? 0,
+        "session.output_tokens": settings.tokenUsage.outputTokens ?? 0
+      } : void 0
+    });
+    if (sessionLine?.id) root.attributes["tangle.sessionId"] = sessionLine.id;
+    return [root, ...spans];
+  }
+};
+
+// src/adapters/pi.ts
+import { readdir as readdir2, stat as stat2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import { basename as basename2, join as join2, resolve } from "path";
+var SERVICE2 = "pi";
+function terminalStatus(message) {
+  const stopReason = message?.stopReason ?? "missing";
+  if (message?.role === "assistant" && stopReason === "stop") {
+    return { status: "OK", stopReason };
+  }
+  if (message?.role === "assistant" && (stopReason === "error" || message.errorMessage)) {
+    return {
+      status: "ERROR",
+      statusMessage: message.errorMessage?.slice(0, 500) ?? "Pi assistant stopped with an error",
+      stopReason
+    };
+  }
+  return {
+    status: "UNSET",
+    statusMessage: message === void 0 ? "Pi session contained no messages" : `Pi session ended after ${message.role} with stopReason "${stopReason}"`,
+    stopReason
+  };
+}
+function isToolBlock(b) {
+  return typeof b.type === "string" && /tool[_-]?call|tool[_-]?use|^tool$/i.test(b.type);
+}
+function isToolResultBlock(b) {
+  return typeof b.type === "string" && /tool[_-]?result|tool[_-]?output/i.test(b.type);
+}
+function textOf2(content) {
+  if (!content) return "";
+  return capText(
+    content.filter((b) => b.type === "text" && typeof b.text === "string").map((b) => b.text).join("")
+  );
+}
+function toolResultOutput(content) {
+  if (content?.length === 1 && content[0]?.type === "text" && typeof content[0].text === "string") {
+    return content[0].text;
+  }
+  return content;
+}
+function completeToolSpan(toolSpan, result) {
+  toolSpan.end_time = result.timestamp;
+  toolSpan.status = result.isError ? { code: "ERROR", message: result.errorMessage } : { code: "OK" };
+  recordToolOutput(toolSpan, result.output, result.source);
+}
+var PiAdapter = class {
+  harness = "pi";
+  sessionsRoot;
+  constructor(options = {}) {
+    this.sessionsRoot = resolve(options.sessionsRoot ?? join2(homedir2(), ".pi", "agent", "sessions"));
+  }
+  root() {
+    return this.sessionsRoot;
+  }
+  async locate(opts = {}) {
+    const root = this.root();
+    let entries;
+    try {
+      entries = await readdir2(root, { withFileTypes: true });
+    } catch (error) {
+      if (isMissingPathError(error)) return [];
+      throw error;
+    }
+    const paths = [];
+    for (const entry of entries) {
+      if (entry.isFile() && entry.name.endsWith(".jsonl")) {
+        paths.push(join2(root, entry.name));
+        continue;
+      }
+      if (!entry.isDirectory()) continue;
+      const dir = join2(root, entry.name);
+      let files;
+      try {
+        files = await readdir2(dir);
+      } catch (error) {
+        if (isMissingPathError(error)) continue;
+        throw error;
+      }
+      for (const file of files) {
+        if (file.endsWith(".jsonl")) paths.push(join2(dir, file));
+      }
+    }
+    const refs = [];
+    for (const path of paths) {
+      const f = basename2(path);
+      let st;
+      try {
+        st = await stat2(path);
+      } catch (error) {
+        if (isMissingPathError(error)) continue;
+        throw error;
+      }
+      if (opts.sinceMs && st.mtimeMs < opts.sinceMs) continue;
+      let id = basename2(f, ".jsonl").replace(/^[\dTZ.-]+_/, "");
+      let cwd = null;
+      const ref = {
+        harness: this.harness,
+        sessionId: id,
+        path,
+        cwd,
+        mtimeMs: st.mtimeMs
+      };
+      const [session] = await takeJsonl(path, 1, sessionJsonlOptions(ref));
+      if (session?.type === "session") {
+        if (session.id) id = session.id;
+        if (session.cwd) cwd = session.cwd;
+      }
+      ref.sessionId = id;
+      ref.cwd = cwd;
+      if (ref.integrity) {
+        ref.integrity.corruptions = ref.integrity.corruptions.map((receipt) => ({
+          ...receipt,
+          sessionId: id
+        }));
+      }
+      if (opts.cwd && (!cwd || !cwd.startsWith(opts.cwd))) continue;
+      refs.push(ref);
+    }
+    return refs.sort((a, b) => b.mtimeMs - a.mtimeMs);
+  }
+  async parse(ref, options = {}) {
+    const sourceTraceId = ref.sessionId;
+    const sourceRootId = `root:${sourceTraceId}`;
+    const spans = [];
+    const toolByCallId = /* @__PURE__ */ new Map();
+    const pendingResults = /* @__PURE__ */ new Map();
+    let firstTimestamp;
+    let lastTimestamp;
+    let sessionLine;
+    let terminalMessage;
+    let sawLine = false;
+    let step = 0;
+    for await (const l of readJsonl(ref.path, sessionJsonlOptions(ref, options))) {
+      if (!sawLine) {
+        firstTimestamp = l.timestamp;
+        sawLine = true;
+      }
+      lastTimestamp = l.timestamp;
+      if (!sessionLine && l.type === "session") {
+        sessionLine = { id: l.id, timestamp: l.timestamp };
+      }
+      if (l.type === "compaction") {
+        spans.push(span({
+          traceId: sourceTraceId,
+          spanId: "compacted:" + (l.id ?? step),
+          parentSpanId: sourceRootId,
+          name: "session.compacted",
+          kind: "CHAIN",
+          service: SERVICE2,
+          agent: SERVICE2,
+          startTime: l.timestamp ?? "",
+          step: step++,
+          content: typeof l.summary === "string" ? capText(l.summary) : void 0,
+          contentSource: sourceOf(l, "summary"),
+          extra: {
+            ...typeof l.tokensBefore === "number" && Number.isFinite(l.tokensBefore) && l.tokensBefore >= 0 ? { "traces.compaction.tokens_before": l.tokensBefore } : {},
+            ...typeof l.firstKeptEntryId === "string" ? { "traces.pi.first_kept_entry_id": l.firstKeptEntryId } : {},
+            ...l.systemMessage !== void 0 ? { "gen_ai.system_instructions": JSON.stringify(l.systemMessage) } : {}
+          }
+        }));
+        continue;
+      }
+      if (l.type !== "message" || !l.message) continue;
+      const ts = l.timestamp ?? (/* @__PURE__ */ new Date(0)).toISOString();
+      const mid = l.id ?? `m${step}`;
+      const msg = l.message;
+      terminalMessage = {
+        role: msg.role ?? "unknown",
+        stopReason: msg.stopReason,
+        errorMessage: msg.errorMessage
+      };
+      const llmId = `llm:${mid}`;
+      if (msg.role === "toolResult") {
+        const callId = msg.toolCallId ?? `${mid}:result`;
+        const errorMessage = textOf2(msg.content).slice(0, 500) || "tool result reported error";
+        const result = {
+          callId,
+          toolName: msg.toolName ?? "tool",
+          timestamp: ts,
+          isError: msg.isError === true,
+          output: toolResultOutput(msg.content),
+          source: msg.content?.length === 1 && msg.content[0]?.type === "text" && typeof msg.content[0].text === "string" ? sourceOf(msg.content[0], "text") : sourceOf(msg, "content"),
+          errorMessage,
+          step
+        };
+        const toolSpan = toolByCallId.get(callId);
+        if (toolSpan) completeToolSpan(toolSpan, result);
+        else {
+          pendingResults.set(callId, result);
+          step += 1;
+        }
+        continue;
+      } else if (msg.role === "user") {
+        const prompt = textOf2(msg.content);
+        if (prompt) {
+          spans.push(
+            userPromptSpan({
+              traceId: sourceTraceId,
+              spanId: `${mid}:user`,
+              parentSpanId: sourceRootId,
+              startTime: ts,
+              service: SERVICE2,
+              agent: SERVICE2,
+              step,
+              content: prompt,
+              contentSource: textSources(msg, "content")
+            })
+          );
+          step += 1;
+        }
+      } else {
+        const errored = !!msg.errorMessage;
+        spans.push(
+          span({
+            traceId: sourceTraceId,
+            spanId: llmId,
+            parentSpanId: sourceRootId,
+            name: `message.${msg.role ?? "unknown"}`,
+            kind: "LLM",
+            startTime: ts,
+            status: errored ? "ERROR" : "OK",
+            statusMessage: errored ? msg.errorMessage.slice(0, 500) : void 0,
+            service: SERVICE2,
+            agent: SERVICE2,
+            model: msg.model ?? null,
+            inputTokens: msg.usage?.input ?? null,
+            outputTokens: msg.usage?.output ?? null,
+            reasoningTokens: msg.usage?.reasoning ?? null,
+            cachedInputTokens: msg.usage?.cacheRead ?? null,
+            cacheWriteInputTokens: msg.usage?.cacheWrite ?? null,
+            step,
+            content: textOf2(msg.content) || null,
+            contentSource: textSources(msg, "content")
+          })
+        );
+        step += 1;
+      }
+      for (const b of msg.content ?? []) {
+        if (isToolBlock(b)) {
+          const name = b.toolName ?? b.name ?? "tool";
+          const callId = b.id ?? b.callId ?? b.toolCallId ?? `${mid}:${step}`;
+          const toolSpan = span({
+            traceId: sourceTraceId,
+            spanId: `tool:${callId}`,
+            parentSpanId: llmId,
+            name: `tool.${name}`,
+            kind: "TOOL",
+            startTime: ts,
+            service: SERVICE2,
+            agent: SERVICE2,
+            tool: name,
+            status: "UNSET",
+            step,
+            extra: toolIoAttributes({ input: b.input ?? b.args ?? b.arguments, inputSource: sourceOf(b, b.input != null ? "input" : b.args != null ? "args" : "arguments") })
+          });
+          spans.push(toolSpan);
+          toolByCallId.set(callId, toolSpan);
+          const pending = pendingResults.get(callId);
+          if (pending) {
+            completeToolSpan(toolSpan, pending);
+            pendingResults.delete(callId);
+          }
+          step += 1;
+        } else if (isToolResultBlock(b)) {
+          const callId = b.toolCallId ?? b.callId ?? b.id ?? "";
+          const t = toolByCallId.get(callId);
+          if (t) {
+            const err = b.isError === true || b.is_error === true;
+            t.end_time = ts;
+            t.status = err ? { code: "ERROR", message: "tool result reported error" } : { code: "OK" };
+            recordToolOutput(t, b.output ?? b.result ?? b.content ?? b.text, sourceOf(b, b.output != null ? "output" : b.result != null ? "result" : b.content != null ? "content" : "text"));
+          }
+        }
+      }
+    }
+    for (const result of pendingResults.values()) {
+      spans.push(
+        span({
+          traceId: sourceTraceId,
+          spanId: `tool:${result.callId}`,
+          parentSpanId: sourceRootId,
+          name: `tool.${result.toolName}`,
+          kind: "TOOL",
+          startTime: result.timestamp,
+          endTime: result.timestamp,
+          status: result.isError ? "ERROR" : "OK",
+          statusMessage: result.isError ? result.errorMessage : void 0,
+          service: SERVICE2,
+          agent: SERVICE2,
+          tool: result.toolName,
+          step: result.step,
+          extra: {
+            ...toolIoAttributes({ output: result.output, outputSource: result.source }),
+            "traces.pi.tool_result_without_call": true
+          }
+        })
+      );
+    }
+    const traceId = sessionLine?.id ?? sourceTraceId;
+    const rootId = `root:${traceId}`;
+    const terminal = terminalStatus(terminalMessage);
+    for (const item of spans) {
+      item.trace_id = traceId;
+      if (item.parent_span_id === sourceRootId) item.parent_span_id = rootId;
+    }
+    const root = span({
+      traceId,
+      spanId: rootId,
+      parentSpanId: null,
+      name: "session",
+      kind: "AGENT",
+      startTime: sessionLine?.timestamp ?? firstTimestamp ?? (/* @__PURE__ */ new Date(0)).toISOString(),
+      endTime: lastTimestamp,
+      status: terminal.status,
+      statusMessage: terminal.statusMessage,
+      service: SERVICE2,
+      agent: SERVICE2,
+      extra: { "traces.pi.stop_reason": terminal.stopReason }
+    });
+    if (sessionLine?.id) root.attributes["tangle.sessionId"] = sessionLine.id;
+    return [root, ...spans];
+  }
+};
 
 // src/collect.ts
 async function collectSessions(opts = {}) {
@@ -306,7 +830,7 @@ import {
 import { createHash } from "crypto";
 import { mkdir, mkdtemp, rm, writeFile } from "fs/promises";
 import { tmpdir } from "os";
-import { dirname, isAbsolute, join, relative, resolve } from "path";
+import { dirname, isAbsolute, join as join3, relative, resolve as resolve2 } from "path";
 var RETAINED_SESSION_READER_VERSION = "2";
 async function parseRetainedSession(input) {
   input.signal?.throwIfAborted();
@@ -332,12 +856,12 @@ async function parseRetainedSession(input) {
       return unavailable("Retained capture exceeds the 16 MiB per-file or 64 MiB total text limit.");
     }
   }
-  const root = await mkdtemp(join(tmpdir(), "traces-retained-"));
+  const root = await mkdtemp(join3(tmpdir(), "traces-retained-"));
   try {
     const files = /* @__PURE__ */ new Map();
     for (const file of input.files) {
       input.signal?.throwIfAborted();
-      const path = resolve(root, file.path);
+      const path = resolve2(root, file.path);
       const rel = relative(root, path);
       if (!file.path || isAbsolute(file.path) || file.path.includes("\\") || file.path.includes("\0") || rel === "" || rel === ".." || rel.startsWith("../") || files.has(path)) {
         throw new Error("Retained source paths must be unique relative files inside the capture.");
@@ -355,7 +879,7 @@ async function parseRetainedSession(input) {
       const ref = { harness: adapter.harness, sessionId: fallback, path, cwd: null, mtimeMs: 0 };
       try {
         const sources = adapter.sourcePaths ? await adapter.sourcePaths(ref, { signal: input.signal }) : [path];
-        if (sources.some((source) => !files.has(resolve(source)))) {
+        if (sources.some((source) => !files.has(resolve2(source)))) {
           throw new Error("Parser requires files outside the supplied retained capture.");
         }
         const spans = validateOtlpSpans(await adapter.parse(ref, {
@@ -400,7 +924,7 @@ async function parseRetainedSession(input) {
       reason: null,
       sessionId: input.nativeSessionId,
       sourceFiles: chosen.paths.map((path) => {
-        const file = files.get(resolve(path));
+        const file = files.get(resolve2(path));
         return { path: file.path, sha256: `sha256:${createHash("sha256").update(file.content).digest("hex")}` };
       }).sort((a, b) => a.path.localeCompare(b.path)),
       duplicateFiles: selected.slice(1).map((candidate) => candidate.file.path),
@@ -432,6 +956,7 @@ export {
   DEFAULT_ASK_CONCURRENCY,
   DEFAULT_HARNESS,
   DEFAULT_SANDBOX_BASE_URL,
+  DEFAULT_SWEEP_THRESHOLD,
   EMPTY_SPAN_RUN_SNAPSHOT,
   EXPORT_RULE,
   EmptySessionError,
@@ -440,6 +965,7 @@ export {
   FactoryAdapter,
   ForgeAdapter,
   GeminiAdapter,
+  HarnessSessionsAdapter,
   INGEST_SOURCE_CLI,
   INHERITED_SOURCE_ATTR,
   INHERITED_SPANS_OMITTED_ATTR,
@@ -469,6 +995,7 @@ export {
   SYNTHESIZED_SOURCE_ATTR,
   SYNTHESIZED_SPAN_ATTR,
   SessionWorkflowError,
+  SkillUsageStore,
   TRACE_QUESTION_PREVIEW_HEAD_CHARS,
   ZERO_ROLL,
   addSpend,
@@ -492,6 +1019,7 @@ export {
   buildSessionFactsReport,
   buildSessionIndex,
   buildSessionIndexFromRows,
+  buildSkillUsageReport,
   buildSpanRunTree,
   buildTraceFindingPacket,
   capText,
@@ -520,6 +1048,9 @@ export {
   createHostedClient,
   cwdMatchesSelection,
   cwdMatchesSelectionResolved,
+  defaultSkillCatalogRoots,
+  defaultSkillUsageSources,
+  defaultSkillUsageStorePath,
   defaultTraceLiveAnalysts,
   describeSessionRelationship,
   diffRuns,
@@ -589,6 +1120,7 @@ export {
   projectSessionBundle,
   readCoordinationLog,
   readFileRunContext,
+  readInstalledSkills,
   readJsonFile,
   readJsonl,
   readOtlpInput,
@@ -612,6 +1144,7 @@ export {
   renderRunWatchSnapshot,
   renderSessionFacts,
   renderSessionFactsContext,
+  renderSkillUsage,
   renderSpanRunSnapshot,
   renderTraceQuestionInstructions,
   renderTraceQuestionPrompt,