@uvl000/claude-trace 3.0.13-workflowexp.1

package/dist/report/index-generator.js

@@ -0,0 +1,319 @@
+"use strict";
+/**
+ * @file Conversation index generator for trace log directories.
+ *
+ * Scans JSONL session logs, optionally regenerates per-log HTML reports and
+ * AI-generated conversation summaries via the Claude CLI, then writes a
+ * browsable `index.html` listing all sessions and their summaries.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IndexGenerator = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const html_generator_1 = require("./html-generator");
+const shared_conversation_processor_1 = require("./shared-conversation-processor");
+/**
+ * Builds and maintains `index.html` plus per-log `summary-*.json` sidecars.
+ *
+ * Summaries are regenerated when missing or older than the source JSONL file.
+ */
+class IndexGenerator {
+    /**
+     * @param traceDir - Trace output directory (e.g. `.claude-trace`).
+     */
+    constructor(traceDir = ".claude-trace") {
+        this.traceDir = traceDir;
+        this.htmlGenerator = new html_generator_1.HTMLGenerator();
+        this.conversationProcessor = new shared_conversation_processor_1.SharedConversationProcessor();
+    }
+    /**
+     * Main entry point: process all logs in `traceDir` and write `index.html`.
+     * Exits the process with code 1 when the directory or logs are missing.
+     */
+    async generateIndex() {
+        console.log("Generating conversation index...");
+        console.log(`Looking in: ${this.traceDir}/`);
+        if (!fs_1.default.existsSync(this.traceDir)) {
+            console.log(`Directory ${this.traceDir} not found`);
+            process.exit(1);
+        }
+        // Find all log files
+        const logFiles = this.findLogFiles();
+        console.log(`Found ${logFiles.length} log files`);
+        if (logFiles.length === 0) {
+            console.log("No log files found");
+            process.exit(1);
+        }
+        // Process each log file
+        const allSummaries = [];
+        for (const logFile of logFiles) {
+            console.log(`\nProcessing ${logFile}...`);
+            const summary = await this.processLogFile(logFile);
+            if (summary) {
+                allSummaries.push(summary);
+            }
+        }
+        // Generate index.html
+        await this.generateIndexHTML(allSummaries);
+        console.log(`\nIndex generated: ${this.traceDir}/index.html`);
+    }
+    /**
+     * Lists session JSONL files matching `log-YYYY-MM-DD-HH-MM-SS.jsonl`,
+     * newest first.
+     *
+     * @returns Filenames only (not full paths), sorted descending by timestamp.
+     */
+    findLogFiles() {
+        const files = fs_1.default.readdirSync(this.traceDir);
+        return files
+            .filter((file) => file.match(/^log-\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}\.jsonl$/))
+            .sort((a, b) => b.localeCompare(a)); // newest first
+    }
+    /**
+     * Ensures a summary sidecar exists for one log, regenerating when stale.
+     * Also generates the per-log HTML report if missing.
+     */
+    async processLogFile(logFile) {
+        const logPath = path_1.default.join(this.traceDir, logFile);
+        const timestamp = logFile.match(/log-(\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2})\.jsonl$/)?.[1];
+        if (!timestamp)
+            return null;
+        const summaryFile = `summary-${timestamp}.json`;
+        const summaryPath = path_1.default.join(this.traceDir, summaryFile);
+        const htmlFile = `log-${timestamp}.html`;
+        const htmlPath = path_1.default.join(this.traceDir, htmlFile);
+        // Check if summary needs regeneration
+        const logStat = fs_1.default.statSync(logPath);
+        let needsRegeneration = !fs_1.default.existsSync(summaryPath);
+        if (!needsRegeneration) {
+            const summaryStat = fs_1.default.statSync(summaryPath);
+            needsRegeneration = summaryStat.mtime < logStat.mtime;
+        }
+        if (needsRegeneration) {
+            console.log(`  Generating summary (${needsRegeneration ? "missing or outdated" : "up to date"})...`);
+            // Ensure HTML file exists
+            if (!fs_1.default.existsSync(htmlPath)) {
+                console.log(`  Generating HTML file...`);
+                await this.htmlGenerator.generateHTMLFromJSONL(logPath, htmlPath);
+            }
+            // Process conversations
+            const conversations = await this.extractConversations(logPath);
+            const summaries = [];
+            // Summarize non-compacted conversations with more than 2 messages
+            const nonCompactedConversations = conversations.filter((conv) => !conv.compacted && conv.messages.length > 2);
+            console.log(`  Found ${nonCompactedConversations.length} non-compacted conversations (>2 messages)`);
+            for (const conversation of nonCompactedConversations) {
+                console.log(`    Summarizing conversation ${conversation.id}...`);
+                const summary = await this.summarizeConversation(conversation);
+                if (summary) {
+                    summaries.push(summary);
+                }
+            }
+            // Save summary file
+            const logSummary = {
+                logFile,
+                htmlFile,
+                generated: new Date().toISOString(),
+                conversations: summaries,
+            };
+            fs_1.default.writeFileSync(summaryPath, JSON.stringify(logSummary, null, 2));
+            console.log(`  Summary saved: ${summaryFile}`);
+            return logSummary;
+        }
+        else {
+            console.log(`  Using existing summary`);
+            return JSON.parse(fs_1.default.readFileSync(summaryPath, "utf-8"));
+        }
+    }
+    /** Parses a JSONL log into merged {@link SimpleConversation} objects. */
+    async extractConversations(logPath) {
+        // Read and parse JSONL file
+        const content = fs_1.default.readFileSync(logPath, "utf-8");
+        const lines = content
+            .trim()
+            .split("\n")
+            .filter((line) => line.trim());
+        const rawPairs = lines.map((line) => JSON.parse(line));
+        // Process pairs using shared implementation
+        const processedPairs = this.conversationProcessor.processRawPairs(rawPairs);
+        // Extract conversations
+        return this.conversationProcessor.mergeConversations(processedPairs);
+    }
+    /**
+     * Calls the Claude CLI to produce a title and summary for one conversation.
+     * Returns null when parsing fails or the CLI is unavailable.
+     */
+    async summarizeConversation(conversation) {
+        try {
+            // Convert conversation to text for summarization
+            const conversationText = this.conversationToText(conversation);
+            // Prepare prompt for Claude
+            const prompt = `Please analyze this conversation and provide:
+1. A concise title (max 10 words)
+2. A summary in 1-3 paragraphs describing what was accomplished
+
+Conversation:
+${conversationText}
+
+Format your response as:
+TITLE: [title]
+SUMMARY: [summary]`;
+            // Call Claude CLI
+            const claudeResponse = await this.callClaude(prompt);
+            // Parse response
+            const titleMatch = claudeResponse.match(/TITLE:\s*(.+)/);
+            const summaryMatch = claudeResponse.match(/SUMMARY:\s*([\s\S]+)/);
+            if (!titleMatch || !summaryMatch) {
+                console.log(`    Failed to parse Claude response for conversation ${conversation.id}`);
+                return null;
+            }
+            return {
+                id: conversation.id,
+                title: titleMatch[1].trim(),
+                summary: summaryMatch[1].trim(),
+                startTime: conversation.metadata.startTime,
+                messageCount: conversation.messages.length,
+                models: Array.from(conversation.models),
+            };
+        }
+        catch (error) {
+            console.log(`    Failed to summarize conversation ${conversation.id}: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Flattens a conversation to plain text for the summarization prompt.
+     * Truncates long blocks to keep token usage reasonable.
+     */
+    conversationToText(conversation) {
+        let text = "";
+        // Add system prompt (stripped)
+        if (conversation.system) {
+            const systemText = typeof conversation.system === "string"
+                ? conversation.system
+                : conversation.system.map((block) => (block.type === "text" ? block.text : "[non-text]")).join(" ");
+            text += `SYSTEM: ${systemText.substring(0, 500)}...\n\n`;
+        }
+        // Add messages (without tool results for brevity)
+        for (const message of conversation.messages) {
+            if (message.hide)
+                continue;
+            text += `${message.role.toUpperCase()}: `;
+            if (typeof message.content === "string") {
+                text += message.content.substring(0, 1000);
+            }
+            else if (Array.isArray(message.content)) {
+                const textBlocks = message.content
+                    .filter((block) => block.type === "text")
+                    .map((block) => block.text)
+                    .join(" ");
+                text += textBlocks.substring(0, 1000);
+            }
+            text += "\n\n";
+        }
+        return text;
+    }
+    /**
+     * Spawns `claude -p <prompt>` and returns stdout.
+     * @throws When the CLI exits non-zero or cannot be spawned.
+     */
+    async callClaude(prompt) {
+        return new Promise((resolve, reject) => {
+            console.log("    Calling Claude CLI for summarization...");
+            console.log("    This will incur additional token usage");
+            const child = (0, child_process_1.spawn)("claude", ["-p", prompt], {
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            let stdout = "";
+            let stderr = "";
+            child.stdout.on("data", (data) => {
+                stdout += data.toString();
+            });
+            child.stderr.on("data", (data) => {
+                stderr += data.toString();
+            });
+            child.on("close", (code) => {
+                if (code === 0) {
+                    resolve(stdout.trim());
+                }
+                else {
+                    reject(new Error(`Claude CLI exited with code ${code}: ${stderr}`));
+                }
+            });
+            child.on("error", (error) => {
+                reject(new Error(`Failed to spawn claude CLI: ${error.message}`));
+            });
+        });
+    }
+    /**
+     * Writes a static HTML index page linking to per-log reports and summaries.
+     *
+     * Uses inline CSS only — no frontend bundle — so the index opens instantly
+     * without rebuilding the Lit viewer.
+     */
+    async generateIndexHTML(summaries) {
+        // Static template; a future version may reuse the lazy-loading frontend bundle
+        const indexPath = path_1.default.join(this.traceDir, "index.html");
+        let html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Claude Trace - Conversation Index</title>
+    <style>
+        body { font-family: system-ui, sans-serif; max-width: 1200px; margin: 0 auto; padding: 20px; }
+        .header { border-bottom: 1px solid #ddd; padding-bottom: 20px; margin-bottom: 30px; }
+        .log-section { margin-bottom: 40px; }
+        .log-header { background: #f5f5f5; padding: 15px; border-radius: 8px; margin-bottom: 20px; }
+        .conversation { border: 1px solid #e0e0e0; border-radius: 8px; padding: 20px; margin-bottom: 15px; }
+        .conversation h3 { margin-top: 0; color: #2563eb; }
+        .conversation-meta { color: #666; font-size: 14px; margin-bottom: 10px; }
+        .models { display: flex; gap: 8px; margin-top: 10px; }
+        .model-tag { background: #e5f3ff; color: #0066cc; padding: 2px 8px; border-radius: 4px; font-size: 12px; }
+        a { color: #2563eb; text-decoration: none; }
+        a:hover { text-decoration: underline; }
+    </style>
+</head>
+<body>
+    <div class="header">
+        <h1>Claude Trace - Conversation Index</h1>
+        <p>Generated: ${new Date().toISOString().replace("T", " ").slice(0, -5)}</p>
+        <p>Total logs: ${summaries.length}</p>
+    </div>
+`;
+        for (const summary of summaries) {
+            html += `
+    <div class="log-section">
+        <div class="log-header">
+            <h2><a href="${summary.htmlFile}">${summary.logFile}</a></h2>
+            <p>Generated: ${summary.generated.replace("T", " ").slice(0, -5)} | Conversations: ${summary.conversations.length}</p>
+        </div>
+`;
+            for (const conv of summary.conversations) {
+                html += `
+        <div class="conversation">
+            <h3>${conv.title}</h3>
+            <div class="conversation-meta">
+                ${conv.startTime.replace("T", " ").slice(0, -5)} | ${conv.messageCount} messages
+            </div>
+            <p>${conv.summary}</p>
+            <div class="models">
+                ${conv.models.map((model) => `<span class="model-tag">${model}</span>`).join("")}
+            </div>
+        </div>
+`;
+            }
+            html += `    </div>`;
+        }
+        html += `
+</body>
+</html>`;
+        fs_1.default.writeFileSync(indexPath, html);
+    }
+}
+exports.IndexGenerator = IndexGenerator;
+//# sourceMappingURL=index-generator.js.map

package/dist/report/index-generator.js.map

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

package/dist/report/shared-conversation-processor.d.ts

@@ -0,0 +1,200 @@
+/**
+ * @file Shared conversation parsing for frontend and backend.
+ *
+ * Converts raw JSONL request/response pairs into normalized Anthropic-shaped
+ * messages, groups them into conversation threads, pairs tool_use with
+ * tool_result blocks, and detects compacted (summarized) conversations.
+ *
+ * Used by both the Lit HTML viewer and the CLI index generator so parsing
+ * behavior stays identical across surfaces.
+ */
+import type { Message, MessageCreateParams, MessageParam, TextBlockParam, ToolResultBlockParam } from "@anthropic-ai/sdk/resources/messages";
+import type { ApiFormat } from "../tools/types";
+import type { RawPair } from "../types";
+/** A single logged API round-trip normalized for display and grouping. */
+export interface ProcessedPair {
+    id: string;
+    timestamp: string;
+    request: MessageCreateParams;
+    response: Message;
+    model: string;
+    isStreaming: boolean;
+    /** Raw SSE or Bedrock event-stream body preserved for debug views. */
+    rawStreamData?: string;
+    /** Whether streaming data used Anthropic SSE or AWS Bedrock binary format. */
+    streamFormat?: "standard" | "bedrock" | null;
+    /** Detected upstream API format when known at log or parse time. */
+    apiFormat?: ApiFormat;
+}
+/** Message with paired tool results attached and optional UI hide flag. */
+export interface EnhancedMessageParam extends MessageParam {
+    /** Tool results keyed by `tool_use_id`, hoisted onto the assistant turn. */
+    toolResults?: Record<string, ToolResultBlockParam>;
+    /** When true, the message is tool-result-only and hidden in the UI. */
+    hide?: boolean;
+}
+/** Token usage fields aggregated from API pairs in a conversation thread. */
+export interface ConversationUsageMetadata {
+    /** Last request context size; alias of {@link lastTurnInputTokens}. */
+    inputTokens: number;
+    /** Sum of output tokens across all pairs; alias of {@link sessionOutputTokens}. */
+    outputTokens: number;
+    /** Alias of {@link sessionOutputTokens} (not input + output). */
+    totalTokens: number;
+    /** Context token count from the chronologically last API response. */
+    lastTurnInputTokens: number;
+    /** Output token count from the chronologically last API response. */
+    lastTurnOutputTokens: number;
+    /** Sum of `output_tokens` across every pair in the thread. */
+    sessionOutputTokens: number;
+    /** Prompt cache hits on the last turn, when reported by the API. */
+    cacheReadTokens?: number | null;
+    /** Prompt cache writes on the last turn, when reported by the API. */
+    cacheCreationTokens?: number | null;
+}
+/** One logical conversation thread merged from multiple API pairs. */
+export interface SimpleConversation {
+    id: string;
+    models: Set<string>;
+    system?: string | TextBlockParam[];
+    messages: EnhancedMessageParam[];
+    response: Message;
+    /** All API pairs that belong to this thread, sorted by time. */
+    allPairs: ProcessedPair[];
+    /** The pair with the longest message list — treated as the thread snapshot. */
+    finalPair: ProcessedPair;
+    /** True when this thread was detected as a post-compaction summary. */
+    compacted?: boolean;
+    /** Human-readable API format label, e.g. "OpenAI Chat". */
+    apiFormatDisplay?: string;
+    metadata: {
+        startTime: string;
+        endTime: string;
+        totalPairs: number;
+    } & ConversationUsageMetadata;
+}
+/**
+ * Aggregates token usage from chronologically ordered API pairs.
+ *
+ * Input tokens reflect the last turn's context snapshot (not summed across turns).
+ * Output tokens are summed across all pairs as the session generation cost.
+ *
+ * @param pairs - Processed pairs belonging to one conversation thread.
+ */
+export declare function aggregateUsageFromPairs(pairs: ProcessedPair[]): ConversationUsageMetadata;
+/**
+ * Parses raw trace pairs and merges them into viewer-ready conversations.
+ * Used by both the Lit frontend and the CLI index generator.
+ */
+export declare class SharedConversationProcessor {
+    /**
+     * Converts each {@link RawPair} into a {@link ProcessedPair}.
+     *
+     * Handles Anthropic JSON, Anthropic/Bedrock SSE, and OpenAI Chat/Responses
+     * formats. Pairs missing request/response or failing parse are skipped with
+     * a console warning.
+     *
+     * @param rawPairs - Lines parsed from a session JSONL log.
+     * @returns Normalized pairs ready for merging or JSON debug display.
+     */
+    processRawPairs(rawPairs: RawPair[]): ProcessedPair[];
+    /**
+     * Detects AWS Bedrock binary event-stream responses by their leading NUL bytes.
+     *
+     * @param bodyRaw - Raw response body string from the proxy log.
+     */
+    private isBedrockResponse;
+    /**
+     * Parses Bedrock binary event stream into a synthetic Anthropic {@link Message}.
+     *
+     * Extracts base64-wrapped JSON events from `event{"bytes":...}` frames and
+     * merges Bedrock invocation metrics into usage when present.
+     */
+    private parseBedrockStreamingResponse;
+    /**
+     * Decodes base64 to UTF-8 in both browser (atob) and Node.js (Buffer).
+     *
+     * @throws When neither API is available (unlikely in this project's targets).
+     */
+    private decodeBase64ToUtf8;
+    /**
+     * Scans raw Bedrock event-stream text for `event{"bytes":{...}}` JSON wrappers.
+     *
+     * Uses brace counting rather than regex to handle nested JSON objects safely.
+     */
+    private extractJsonChunksFromEventStream;
+    /**
+     * Best-effort extraction of Bedrock token metrics embedded in the raw stream.
+     */
+    private extractBedrockMetrics;
+    /**
+     * Dispatches streaming body parsing to Bedrock or standard Anthropic SSE.
+     *
+     * @param bodyRaw - Raw `body_raw` field from a logged response.
+     * @returns Reconstructed assistant {@link Message}.
+     */
+    parseStreamingResponse(bodyRaw: string): Message;
+    /**
+     * Parses Anthropic-style `data: {...}` SSE lines into a {@link Message}.
+     */
+    private parseStandardStreamingResponse;
+    /**
+     * Replays streaming events into a complete {@link Message}, accumulating
+     * text, thinking, and tool_use deltas and parsing tool JSON at block stop.
+     *
+     * @param events - Ordered stream events from SSE or Bedrock decode.
+     * @param bedrockMetrics - Optional Bedrock token counts overriding usage.
+     */
+    private buildMessageFromEvents;
+    /**
+     * Resolves a display model id from Bedrock URL, request body, or response body.
+     */
+    private extractModel;
+    /**
+     * Strips Bedrock inference-profile prefixes for shorter display names.
+     */
+    private normalizeModelName;
+    /**
+     * Groups {@link ProcessedPair} rows into {@link SimpleConversation} threads.
+     *
+     * Threading heuristic: same system prompt + model, then bucket by normalized
+     * first user message. Within each bucket the pair with the most messages
+     * becomes the thread snapshot. Compacted conversations are merged when detected.
+     *
+     * @param pairs - Normalized pairs from {@link processRawPairs}.
+     * @param options.includeShortConversations - Include threads with ≤2 messages.
+     * @returns Conversations sorted by start time.
+     */
+    mergeConversations(pairs: ProcessedPair[], options?: {
+        includeShortConversations?: boolean;
+    }): SimpleConversation[];
+    /**
+     * Attaches tool_result blocks to their tool_use messages and hides
+     * user turns that contain only orphaned tool results.
+     */
+    private processToolResults;
+    /**
+     * Detects Claude Code compaction: a single-pair conversation whose message
+     * list is two longer than an earlier thread with matching tail messages.
+     */
+    private detectAndMergeCompactConversations;
+    /**
+     * Combines pre- and post-compaction threads, restoring the original first
+     * user message while keeping the compacted response and pair list.
+     */
+    private mergeCompactConversation;
+    /**
+     * Loose equality check for compaction pairing — compares role and content shape only.
+     */
+    private messagesRoughlyEqual;
+    /**
+     * Strips volatile substrings from the first message so threading keys stay
+     * stable across retries (timestamps, IDE open events, system reminders).
+     */
+    private normalizeMessageForGrouping;
+    /**
+     * Simple string hash for conversation grouping keys (not cryptographic).
+     */
+    private hashString;
+}
+//# sourceMappingURL=shared-conversation-processor.d.ts.map

package/dist/report/shared-conversation-processor.d.ts.map

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