tracelight 0.1.0

package/dist/pricing.js

@@ -0,0 +1,73 @@
+/**
+ * Hand-maintained cost table for Claude model families.
+ *
+ * IMPORTANT: These prices are hand-maintained and must be verified against
+ * https://www.anthropic.com/pricing before using for billing or reporting.
+ * Last verified: 2026-06-13.
+ */
+/** Date this pricing table was last verified against Anthropic's public list prices. */
+export const PRICING_AS_OF_DATE = "2026-06-13";
+/**
+ * Known model-family prefixes mapped to their public list prices (USD per 1M tokens).
+ *
+ * Real model ids look like "claude-sonnet-4-6-20250930"; we match by prefix so
+ * versioned ids resolve correctly. Add new families here as they are released.
+ */
+export const MODEL_PRICING = {
+    // Opus 4.6 / 4.7 / 4.8 list prices. (Older opus 4.0/4.1 were higher; rare in transcripts.)
+    "claude-opus": {
+        inputPer1M: 5,
+        outputPer1M: 25,
+        cacheWritePer1M: 6.25,
+        cacheReadPer1M: 0.5,
+    },
+    "claude-sonnet": {
+        inputPer1M: 3,
+        outputPer1M: 15,
+        cacheWritePer1M: 3.75,
+        cacheReadPer1M: 0.3,
+    },
+    "claude-haiku": {
+        inputPer1M: 1,
+        outputPer1M: 5,
+        cacheWritePer1M: 1.25,
+        cacheReadPer1M: 0.1,
+    },
+    // Fable 5 (Mythos-tier) sits above Opus on price.
+    "claude-fable": {
+        inputPer1M: 10,
+        outputPer1M: 50,
+        cacheWritePer1M: 12.5,
+        cacheReadPer1M: 1.0,
+    },
+};
+/**
+ * Finds the ModelPricing entry for a given model id by checking which known
+ * prefix the id starts with. Returns undefined for unknown models (e.g. "<synthetic>").
+ */
+function findPricingForModel(modelId) {
+    for (const prefix of Object.keys(MODEL_PRICING)) {
+        if (modelId.startsWith(prefix)) {
+            return MODEL_PRICING[prefix];
+        }
+    }
+    return undefined;
+}
+/**
+ * Estimates the cost in USD for a given model and token usage.
+ *
+ * Returns undefined for model ids that don't match any known prefix (e.g. "<synthetic>"),
+ * so the UI can display "cost unavailable" rather than a misleading zero.
+ */
+export function estimateCostUsd(modelId, usage) {
+    const pricing = findPricingForModel(modelId);
+    if (pricing === undefined) {
+        return undefined;
+    }
+    const tokensPerMillion = 1_000_000;
+    return ((usage.inputTokens * pricing.inputPer1M) / tokensPerMillion +
+        (usage.outputTokens * pricing.outputPer1M) / tokensPerMillion +
+        (usage.cacheCreationInputTokens * pricing.cacheWritePer1M) / tokensPerMillion +
+        (usage.cacheReadInputTokens * pricing.cacheReadPer1M) / tokensPerMillion);
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,wFAAwF;AACxF,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,2FAA2F;IAC3F,aAAa,EAAE;QACb,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,GAAG;KACpB;IACD,eAAe,EAAE;QACf,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,GAAG;KACpB;IACD,cAAc,EAAE;QACd,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,GAAG;KACpB;IACD,kDAAkD;IAClD,cAAc,EAAE;QACd,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,EAAE;QACf,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,GAAG;KACpB;CACF,CAAC;AAEF;;;GAGG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,KAAiB;IAChE,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,gBAAgB,GAAG,SAAS,CAAC;IAEnC,OAAO,CACL,CAAC,KAAK,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,gBAAgB;QAC3D,CAAC,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,gBAAgB;QAC7D,CAAC,KAAK,CAAC,wBAAwB,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,gBAAgB;QAC7E,CAAC,KAAK,CAAC,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,GAAG,gBAAgB,CACzE,CAAC;AACJ,CAAC"}

package/dist/projectLoader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Project loader: discovers Claude Code projects from ~/.claude/projects/ and
+ * parses their .jsonl session files into the internal model.
+ *
+ * This module is the only place that knows about the ~/.claude/projects/
+ * directory layout. The server and UI import only the types from apiTypes.ts
+ * and model.ts — never the raw parser shapes.
+ */
+import type { SessionSummary } from "./model.js";
+import type { ProjectListing, SessionListItem, SessionDetail } from "./apiTypes.js";
+/**
+ * Reads a single .jsonl file and returns its SessionSummary, including populated subagents.
+ * Returns null on any read or parse failure (defensive).
+ */
+export declare function loadSession(filePath: string): SessionSummary | null;
+/**
+ * Converts a SessionSummary to the lightweight SessionListItem shape for the API.
+ */
+export declare function toSessionListItem(sessionSummary: SessionSummary, filePath: string): SessionListItem;
+/**
+ * Converts a SessionSummary to the full SessionDetail shape for the /api/sessions/:id endpoint.
+ * All turns are included in parser order; the UI decides which to render.
+ */
+export declare function toSessionDetail(sessionSummary: SessionSummary, filePath: string): SessionDetail;
+/**
+ * Loads all projects from ~/.claude/projects/, parsing each .jsonl session file.
+ * Returns projects sorted by most-recent session first.
+ * Projects or sessions that fail to load are silently skipped.
+ */
+export declare function loadAllProjects(): ProjectListing[];
+//# sourceMappingURL=projectLoader.d.ts.map

package/dist/projectLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectLoader.d.ts","sourceRoot":"","sources":["../src/projectLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,cAAc,EAA2D,MAAM,YAAY,CAAC;AAE1G,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,aAAa,EAQd,MAAM,eAAe,CAAC;AAIvB;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CASnE;AAkED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM,GACf,eAAe,CAmBjB;AAgHD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,MAAM,GACf,aAAa,CAiBf;AA2CD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,cAAc,EAAE,CA6ElD"}

package/dist/projectLoader.js

@@ -0,0 +1,335 @@
+/**
+ * Project loader: discovers Claude Code projects from ~/.claude/projects/ and
+ * parses their .jsonl session files into the internal model.
+ *
+ * This module is the only place that knows about the ~/.claude/projects/
+ * directory layout. The server and UI import only the types from apiTypes.ts
+ * and model.ts — never the raw parser shapes.
+ */
+import { readdirSync, readFileSync, statSync, existsSync } from "fs";
+import { join, dirname, basename } from "path";
+import { homedir } from "os";
+import { parseSessionJsonl, parseSubagentTurns } from "./parser/index.js";
+import { MODEL_PRICING, PRICING_AS_OF_DATE } from "./pricing.js";
+const CLAUDE_PROJECTS_DIR = join(homedir(), ".claude", "projects");
+/**
+ * Reads a single .jsonl file and returns its SessionSummary, including populated subagents.
+ * Returns null on any read or parse failure (defensive).
+ */
+export function loadSession(filePath) {
+    try {
+        const jsonlText = readFileSync(filePath, "utf-8");
+        const baseSummary = parseSessionJsonl(jsonlText);
+        const subagents = loadSubagentsForSession(filePath);
+        return { ...baseSummary, subagents };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Derives the subagents sidecar directory from the session file path,
+ * then reads each agent-*.jsonl + agent-*.meta.json pair into a SubagentTrace.
+ *
+ * Layout: <dirOfFile>/<basenameWithout.jsonl>/subagents/
+ *
+ * Missing directory, missing/corrupt meta, or unreadable agent file all result
+ * in that subagent being silently skipped — never throws.
+ */
+function loadSubagentsForSession(sessionFilePath) {
+    const sessionFileBasename = basename(sessionFilePath);
+    const sessionId = sessionFileBasename.endsWith(".jsonl")
+        ? sessionFileBasename.slice(0, -".jsonl".length)
+        : sessionFileBasename;
+    const subagentDir = join(dirname(sessionFilePath), sessionId, "subagents");
+    if (!existsSync(subagentDir)) {
+        return [];
+    }
+    let dirEntries;
+    try {
+        dirEntries = readdirSync(subagentDir);
+    }
+    catch {
+        return [];
+    }
+    const agentJsonlFiles = dirEntries.filter((name) => name.startsWith("agent-") && name.endsWith(".jsonl"));
+    const subagentTraces = [];
+    for (const agentJsonlFilename of agentJsonlFiles) {
+        const agentId = agentJsonlFilename
+            .replace(/^agent-/, "")
+            .replace(/\.jsonl$/, "");
+        const agentJsonlPath = join(subagentDir, agentJsonlFilename);
+        const agentMetaPath = join(subagentDir, `agent-${agentId}.meta.json`);
+        try {
+            const agentJsonlText = readFileSync(agentJsonlPath, "utf-8");
+            const agentMetaText = readFileSync(agentMetaPath, "utf-8");
+            const meta = JSON.parse(agentMetaText);
+            const agentType = typeof meta["agentType"] === "string" ? meta["agentType"] : "unknown";
+            const description = typeof meta["description"] === "string" ? meta["description"] : "";
+            const parentToolUseId = typeof meta["toolUseId"] === "string" ? meta["toolUseId"] : "";
+            const turns = parseSubagentTurns(agentJsonlText);
+            subagentTraces.push({ agentId, agentType, description, parentToolUseId, turns });
+        }
+        catch {
+            // Skip this subagent — missing or corrupt file
+            continue;
+        }
+    }
+    return subagentTraces;
+}
+/**
+ * Converts a SessionSummary to the lightweight SessionListItem shape for the API.
+ */
+export function toSessionListItem(sessionSummary, filePath) {
+    const nonMetaTurnCount = sessionSummary.turns.filter((t) => !t.isMeta).length;
+    return {
+        sessionId: sessionSummary.sessionId,
+        filePath,
+        aiTitle: sessionSummary.aiTitle,
+        startedAt: sessionSummary.startedAt,
+        endedAt: sessionSummary.endedAt,
+        durationMs: sessionSummary.durationMs,
+        turnCount: nonMetaTurnCount,
+        totalUsage: {
+            inputTokens: sessionSummary.totalUsage.inputTokens,
+            outputTokens: sessionSummary.totalUsage.outputTokens,
+            cacheCreationInputTokens: sessionSummary.totalUsage.cacheCreationInputTokens,
+            cacheReadInputTokens: sessionSummary.totalUsage.cacheReadInputTokens,
+        },
+        modelsUsed: Array.from(sessionSummary.modelsUsed),
+        unknownEventCount: sessionSummary.unknownEvents.length,
+    };
+}
+/**
+ * Converts a TokenUsage to the over-the-wire TokenUsageSummary shape.
+ */
+function toTokenUsageSummary(usage) {
+    return {
+        inputTokens: usage.inputTokens,
+        outputTokens: usage.outputTokens,
+        cacheCreationInputTokens: usage.cacheCreationInputTokens,
+        cacheReadInputTokens: usage.cacheReadInputTokens,
+    };
+}
+/**
+ * Converts a ContentBlock (model) to a ContentBlockJson (API wire type).
+ * ThinkingBlock's opaque `signature` field is intentionally dropped.
+ */
+function toContentBlockJson(block) {
+    switch (block.type) {
+        case "text":
+            return { type: "text", text: block.text };
+        case "thinking":
+            return { type: "thinking", thinking: block.thinking };
+        case "tool_use":
+            return { type: "tool_use", id: block.id, name: block.name, input: block.input };
+        case "tool_result": {
+            const content = typeof block.content === "string"
+                ? block.content
+                : Array.from(block.content).map((textBlock) => ({ type: "text", text: textBlock.text }));
+            const resultBlock = {
+                type: "tool_result",
+                tool_use_id: block.tool_use_id,
+                content,
+            };
+            if (block.is_error !== undefined) {
+                return { ...resultBlock, is_error: block.is_error };
+            }
+            return resultBlock;
+        }
+    }
+}
+/**
+ * Converts a ToolCall (model) to ToolCallJson (API wire type).
+ */
+function toToolCallJson(toolCall) {
+    return {
+        id: toolCall.id,
+        name: toolCall.name,
+        input: toolCall.input,
+        result: toolCall.result,
+        isError: toolCall.isError,
+        subagentId: toolCall.subagentId,
+    };
+}
+/**
+ * Converts a Turn (model) to TurnJson (API wire type).
+ * The userMessageUuid field is not sent to the UI.
+ */
+function toTurnJson(turn) {
+    return {
+        turnIndex: turn.turnIndex,
+        promptId: turn.promptId,
+        timestamp: turn.timestamp,
+        userText: turn.userText,
+        isMeta: turn.isMeta,
+        assistantBlocks: Array.from(turn.assistantBlocks).map(toContentBlockJson),
+        toolCalls: Array.from(turn.toolCalls).map(toToolCallJson),
+        usage: turn.usage !== undefined ? toTokenUsageSummary(turn.usage) : undefined,
+        model: turn.model,
+        durationMs: turn.durationMs,
+        isSidechain: turn.isSidechain,
+    };
+}
+/**
+ * Converts a SubagentTrace (model) to SubagentTraceJson (API wire type).
+ * Reuses toTurnJson for each subagent turn to keep the mapping consistent.
+ */
+function toSubagentTraceJson(subagent) {
+    return {
+        agentId: subagent.agentId,
+        agentType: subagent.agentType,
+        description: subagent.description,
+        parentToolUseId: subagent.parentToolUseId,
+        turns: Array.from(subagent.turns).map(toTurnJson),
+    };
+}
+/**
+ * Builds the pricing table payload from the hand-maintained MODEL_PRICING table.
+ * MODEL_PRICING values are structurally identical to ModelPricingJson so they
+ * can be spread directly; the readonly modifier on the source fields is erased at runtime.
+ */
+function buildPricingTableJson() {
+    const models = {};
+    for (const [prefix, pricing] of Object.entries(MODEL_PRICING)) {
+        models[prefix] = {
+            inputPer1M: pricing.inputPer1M,
+            outputPer1M: pricing.outputPer1M,
+            cacheWritePer1M: pricing.cacheWritePer1M,
+            cacheReadPer1M: pricing.cacheReadPer1M,
+        };
+    }
+    return { asOfDate: PRICING_AS_OF_DATE, models };
+}
+/**
+ * Converts a SessionSummary to the full SessionDetail shape for the /api/sessions/:id endpoint.
+ * All turns are included in parser order; the UI decides which to render.
+ */
+export function toSessionDetail(sessionSummary, filePath) {
+    const nonMetaTurnCount = sessionSummary.turns.filter((t) => !t.isMeta).length;
+    return {
+        sessionId: sessionSummary.sessionId,
+        filePath,
+        aiTitle: sessionSummary.aiTitle,
+        startedAt: sessionSummary.startedAt,
+        endedAt: sessionSummary.endedAt,
+        durationMs: sessionSummary.durationMs,
+        turnCount: nonMetaTurnCount,
+        totalUsage: toTokenUsageSummary(sessionSummary.totalUsage),
+        modelsUsed: Array.from(sessionSummary.modelsUsed),
+        unknownEventCount: sessionSummary.unknownEvents.length,
+        turns: Array.from(sessionSummary.turns).map(toTurnJson),
+        subagents: Array.from(sessionSummary.subagents).map(toSubagentTraceJson),
+        pricing: buildPricingTableJson(),
+    };
+}
+/**
+ * Derives a human-readable display name from the slug.
+ * The slug is a cwd path with slashes replaced by hyphens, e.g.:
+ *   "-Users-alice-Documents-independent-stuff-leetcode" → "Documents/independent-stuff/leetcode"
+ *   "-home-bob-project" → "project"
+ *   "-Users-alice" → "Users/alice" (no home-dir prefix match, show as-is)
+ *
+ * Strips leading "-Users-<username>-" or "-home-<username>-" (the home-dir prefix),
+ * then shows the last 2 path segments joined by "/" for readability.
+ * If slug doesn't match home patterns or is malformed, falls back to the last segment alone.
+ */
+function slugToDisplayName(slug) {
+    // Normalize: remove leading hyphen
+    const normalized = slug.startsWith("-") ? slug.slice(1) : slug;
+    const parts = normalized.split("-").filter((s) => s.length > 0);
+    if (parts.length === 0) {
+        return slug;
+    }
+    // Try to detect and strip home-dir prefix: "-Users-<username>-" or "-home-<username>-"
+    let remainingParts = parts;
+    if (parts.length >= 2) {
+        const firstPart = parts[0];
+        if (firstPart === "Users" || firstPart === "home") {
+            // Skip the next part (username) and keep the rest
+            remainingParts = parts.slice(2);
+        }
+    }
+    // If we stripped everything, fall back to original last segment
+    if (remainingParts.length === 0) {
+        return parts[parts.length - 1];
+    }
+    // Show the last 2 path segments, joined by "/"
+    const numToShow = Math.min(2, remainingParts.length);
+    const displayParts = remainingParts.slice(-numToShow);
+    return displayParts.join("/");
+}
+/**
+ * Loads all projects from ~/.claude/projects/, parsing each .jsonl session file.
+ * Returns projects sorted by most-recent session first.
+ * Projects or sessions that fail to load are silently skipped.
+ */
+export function loadAllProjects() {
+    let projectDirEntries;
+    try {
+        projectDirEntries = readdirSync(CLAUDE_PROJECTS_DIR);
+    }
+    catch {
+        return [];
+    }
+    const projects = [];
+    for (const entry of projectDirEntries) {
+        const entryPath = join(CLAUDE_PROJECTS_DIR, entry);
+        let entryIsDirectory;
+        try {
+            entryIsDirectory = statSync(entryPath).isDirectory();
+        }
+        catch {
+            continue;
+        }
+        if (!entryIsDirectory)
+            continue;
+        // Each project dir contains .jsonl files (sessions) and possibly subdirectories
+        // (subagent files, memory). We only parse the root-level .jsonl files.
+        let projectEntries;
+        try {
+            projectEntries = readdirSync(entryPath);
+        }
+        catch {
+            continue;
+        }
+        const jsonlFiles = projectEntries.filter((name) => name.endsWith(".jsonl") && !name.includes("/"));
+        if (jsonlFiles.length === 0)
+            continue;
+        const sessions = [];
+        for (const jsonlFile of jsonlFiles) {
+            const filePath = join(entryPath, jsonlFile);
+            const summary = loadSession(filePath);
+            if (summary === null)
+                continue;
+            sessions.push(toSessionListItem(summary, filePath));
+        }
+        if (sessions.length === 0)
+            continue;
+        // Sort sessions by startedAt descending (most recent first)
+        sessions.sort((sessionA, sessionB) => {
+            const timeA = sessionA.startedAt ? new Date(sessionA.startedAt).getTime() : 0;
+            const timeB = sessionB.startedAt ? new Date(sessionB.startedAt).getTime() : 0;
+            return timeB - timeA;
+        });
+        const mostRecentSessionAt = sessions[0].startedAt;
+        projects.push({
+            slug: entry,
+            displayName: slugToDisplayName(entry),
+            sessions,
+            mostRecentSessionAt,
+        });
+    }
+    // Sort projects by most-recent session first
+    projects.sort((projectA, projectB) => {
+        const timeA = projectA.mostRecentSessionAt
+            ? new Date(projectA.mostRecentSessionAt).getTime()
+            : 0;
+        const timeB = projectB.mostRecentSessionAt
+            ? new Date(projectB.mostRecentSessionAt).getTime()
+            : 0;
+        return timeB - timeA;
+    });
+    return projects;
+}
+//# sourceMappingURL=projectLoader.js.map

package/dist/projectLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectLoader.js","sourceRoot":"","sources":["../src/projectLoader.ts"],"names":[],"mappings":"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"}

package/dist/scripts/summarize.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CLI script: print a turn-by-turn text summary of a Claude Code session JSONL file.
+ *
+ * Usage: npm run summarize -- <path-to-jsonl>
+ */
+export {};
+//# sourceMappingURL=summarize.d.ts.map

package/dist/scripts/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../src/scripts/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/scripts/summarize.js

@@ -0,0 +1,153 @@
+/**
+ * CLI script: print a turn-by-turn text summary of a Claude Code session JSONL file.
+ *
+ * Usage: npm run summarize -- <path-to-jsonl>
+ */
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import { parseSessionJsonl } from "../parser/index.js";
+const args = process.argv.slice(2);
+if (args.length === 0) {
+    console.error("Usage: npm run summarize -- <path-to-jsonl>");
+    process.exit(1);
+}
+const filePath = resolve(args[0]);
+let jsonlText;
+try {
+    jsonlText = readFileSync(filePath, "utf-8");
+}
+catch (err) {
+    console.error(`Error reading file: ${filePath}`);
+    console.error(err);
+    process.exit(1);
+}
+const summary = parseSessionJsonl(jsonlText);
+// ---------------------------------------------------------------------------
+// Print header
+// ---------------------------------------------------------------------------
+console.log("=".repeat(72));
+console.log(`SESSION: ${summary.sessionId}`);
+if (summary.aiTitle) {
+    console.log(`TITLE:   ${summary.aiTitle}`);
+}
+if (summary.startedAt) {
+    const startDate = new Date(summary.startedAt).toLocaleString();
+    const durationSec = summary.durationMs
+        ? `  (${(summary.durationMs / 1000).toFixed(0)}s)`
+        : "";
+    console.log(`STARTED: ${startDate}${durationSec}`);
+}
+const { totalUsage } = summary;
+console.log(`TOKENS:  input=${totalUsage.inputTokens} output=${totalUsage.outputTokens} ` +
+    `cache_read=${totalUsage.cacheReadInputTokens} cache_create=${totalUsage.cacheCreationInputTokens}`);
+if (summary.modelsUsed.length > 0) {
+    console.log(`MODELS:  ${summary.modelsUsed.join(", ")}`);
+}
+console.log(`TURNS:   ${summary.turns.length} total`);
+if (summary.unknownEvents.length > 0) {
+    console.log(`UNKNOWN EVENTS: ${summary.unknownEvents.length} (unrecognized line types)`);
+}
+console.log("=".repeat(72));
+console.log();
+// ---------------------------------------------------------------------------
+// Filter to non-meta turns for the summary
+// ---------------------------------------------------------------------------
+const nonMetaTurns = summary.turns.filter((t) => !t.isMeta);
+const metaCount = summary.turns.length - nonMetaTurns.length;
+if (metaCount > 0) {
+    console.log(`(${metaCount} meta/system turns omitted)\n`);
+}
+if (nonMetaTurns.length === 0) {
+    console.log("No conversation turns found.");
+    process.exit(0);
+}
+// ---------------------------------------------------------------------------
+// Print each turn
+// ---------------------------------------------------------------------------
+for (const turn of nonMetaTurns) {
+    const turnLabel = `TURN ${turn.turnIndex + 1}`;
+    const timeLabel = turn.timestamp
+        ? `  [${new Date(turn.timestamp).toLocaleTimeString()}]`
+        : "";
+    const durationLabel = turn.durationMs
+        ? `  (${(turn.durationMs / 1000).toFixed(1)}s)`
+        : "";
+    const sidechainLabel = turn.isSidechain ? "  [SIDECHAIN]" : "";
+    console.log("-".repeat(72));
+    console.log(`${turnLabel}${timeLabel}${durationLabel}${sidechainLabel}  model=${turn.model ?? "?"}`);
+    // User message
+    if (turn.userText) {
+        const truncated = turn.userText.length > 200
+            ? turn.userText.slice(0, 200) + "…"
+            : turn.userText;
+        console.log(`  USER: ${truncated}`);
+    }
+    // Token usage
+    if (turn.usage) {
+        const u = turn.usage;
+        console.log(`  USAGE: in=${u.inputTokens} out=${u.outputTokens} ` +
+            `cache_read=${u.cacheReadInputTokens} cache_create=${u.cacheCreationInputTokens}`);
+    }
+    // Assistant content blocks
+    const thinkingBlocks = turn.assistantBlocks.filter((b) => b.type === "thinking");
+    const textBlocks = turn.assistantBlocks.filter((b) => b.type === "text");
+    const toolUseBlocks = turn.assistantBlocks.filter((b) => b.type === "tool_use");
+    if (thinkingBlocks.length > 0) {
+        console.log(`  THINKING: [${thinkingBlocks.length} block(s) — collapsed]`);
+    }
+    for (const block of textBlocks) {
+        if (block.type !== "text")
+            continue;
+        const truncated = block.text.length > 300 ? block.text.slice(0, 300) + "…" : block.text;
+        console.log(`  ASSISTANT: ${truncated}`);
+    }
+    // Tool calls
+    for (const toolCall of turn.toolCalls) {
+        const inputSummary = formatToolInput(toolCall.input);
+        const resultSummary = toolCall.result
+            ? `→ ${toolCall.result.slice(0, 100).replace(/\n/g, " ")}${toolCall.result.length > 100 ? "…" : ""}`
+            : toolCall.subagentId
+                ? `→ [subagent: ${toolCall.subagentId}]`
+                : "→ [no result]";
+        const errorMark = toolCall.isError ? " [ERROR]" : "";
+        console.log(`  TOOL ${toolCall.name}(${inputSummary})${errorMark}`);
+        console.log(`       ${resultSummary}`);
+    }
+    console.log();
+}
+// ---------------------------------------------------------------------------
+// Unknown events summary
+// ---------------------------------------------------------------------------
+if (summary.unknownEvents.length > 0) {
+    console.log("=".repeat(72));
+    console.log(`UNKNOWN LINE TYPES:`);
+    const typeCounts = new Map();
+    for (const ev of summary.unknownEvents) {
+        typeCounts.set(ev.rawType, (typeCounts.get(ev.rawType) ?? 0) + 1);
+    }
+    for (const [rawType, count] of typeCounts) {
+        console.log(`  ${rawType}: ${count} line(s)`);
+    }
+    console.log();
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatToolInput(input) {
+    const keys = Object.keys(input);
+    if (keys.length === 0)
+        return "";
+    if (keys.length === 1) {
+        const value = String(input[keys[0]] ?? "");
+        const truncated = value.length > 60 ? value.slice(0, 60) + "…" : value;
+        return `${keys[0]}=${JSON.stringify(truncated)}`;
+    }
+    return keys
+        .slice(0, 3)
+        .map((k) => {
+        const value = String(input[k] ?? "");
+        return `${k}=${JSON.stringify(value.length > 30 ? value.slice(0, 30) + "…" : value)}`;
+    })
+        .join(", ");
+}
+//# sourceMappingURL=summarize.js.map

package/dist/scripts/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/scripts/summarize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,IAAI,SAAiB,CAAC;AACtB,IAAI,CAAC;IACH,SAAS,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAE7C,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAC9E,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;AAC7C,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC;AACD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IACtB,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC;IAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU;QACpC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAClD,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,GAAG,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC;AACD,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;AAC/B,OAAO,CAAC,GAAG,CACT,kBAAkB,UAAU,CAAC,WAAW,WAAW,UAAU,CAAC,YAAY,GAAG;IAC3E,cAAc,UAAU,CAAC,oBAAoB,iBAAiB,UAAU,CAAC,wBAAwB,EAAE,CACtG,CAAC;AACF,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3D,CAAC;AACD,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;AACtD,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,mBAAmB,OAAO,CAAC,aAAa,CAAC,MAAM,4BAA4B,CAAC,CAAC;AAC3F,CAAC;AACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,OAAO,CAAC,GAAG,EAAE,CAAC;AAEd,8EAA8E;AAC9E,2CAA2C;AAC3C,8EAA8E;AAC9E,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;AAC7D,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;IAClB,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,+BAA+B,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC9B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAC9E,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS;QAC9B,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,kBAAkB,EAAE,GAAG;QACxD,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU;QACnC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC/C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CACT,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,cAAc,WAAW,IAAI,CAAC,KAAK,IAAI,GAAG,EAAE,CACxF,CAAC;IAEF,eAAe;IACf,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,SAAS,GACb,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG;YACxB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG;YACnC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,cAAc;IACd,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,OAAO,CAAC,GAAG,CACT,eAAe,CAAC,CAAC,WAAW,QAAQ,CAAC,CAAC,YAAY,GAAG;YACnD,cAAc,CAAC,CAAC,oBAAoB,iBAAiB,CAAC,CAAC,wBAAwB,EAAE,CACpF,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAEhF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,gBAAgB,cAAc,CAAC,MAAM,wBAAwB,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACpC,MAAM,SAAS,GACb,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACxE,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,aAAa;IACb,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM;YACnC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACpG,CAAC,CAAC,QAAQ,CAAC,UAAU;gBACnB,CAAC,CAAC,gBAAgB,QAAQ,CAAC,UAAU,GAAG;gBACxC,CAAC,CAAC,eAAe,CAAC;QACtB,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,UAAU,QAAQ,CAAC,IAAI,IAAI,YAAY,IAAI,SAAS,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,GAAG,CAAC,UAAU,aAAa,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAC9E,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACvC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,eAAe,CAAC,KAA8B;IACrD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,SAAS,GACb,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;QACvD,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,IAAI;SACR,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;IACxF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Fastify HTTP server for tracelight.
+ *
+ * Serves:
+ *   - GET /api/projects    — list of all projects with session summaries
+ *   - GET /api/sessions/:id — full session detail by sessionId
+ *   - Static files from the Vite build output (ui/dist/)
+ *
+ * The server imports only from model.ts and apiTypes.ts — never from parser/.
+ */
+export interface ServerOptions {
+    port: number;
+}
+export declare function createServer(options: ServerOptions): Promise<{
+    start: () => Promise<string>;
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=index.d.ts.map