claude_stream_viewer 1.0.15 → 1.0.18

package/dist/stats/stats_collector.js

@@ -0,0 +1,165 @@
+/**
+ * Accumulates per-stream statistics — tool-call counts, tool-result errors, and
+ * peak prompt size — and captures the `result` event, then assembles a
+ * {@link StatsReport}. A fresh instance should be created per stream.
+ */
+export class StatsCollector {
+    constructor() {
+        this.toolUseCounts = new Map();
+        this.toolResultCount = 0;
+        this.toolResultErrorCount = 0;
+        this.peakPromptTokens = 0;
+    }
+    /** Feeds one event into the accumulators; call for every event in the stream. */
+    track(event) {
+        const type = event.type;
+        if (type === 'assistant') {
+            this.trackPromptSize(event);
+            this.trackToolUses(event);
+            return;
+        }
+        if (type === 'user') {
+            this.trackToolResults(event);
+            return;
+        }
+        if (type === 'result') {
+            this.resultEvent = event;
+        }
+    }
+    trackPromptSize(event) {
+        const usage = event.message?.usage;
+        if (usage === undefined)
+            return;
+        const prompt = (usage.input_tokens ?? 0) + (usage.cache_read_input_tokens ?? 0) + (usage.cache_creation_input_tokens ?? 0);
+        if (prompt > this.peakPromptTokens) {
+            this.peakPromptTokens = prompt;
+        }
+    }
+    trackToolUses(event) {
+        const content = event.message?.content;
+        if (content === undefined)
+            return;
+        for (const block of content) {
+            if (block.type !== 'tool_use') {
+                continue;
+            }
+            const name = block.name ?? 'tool';
+            this.toolUseCounts.set(name, (this.toolUseCounts.get(name) ?? 0) + 1);
+        }
+    }
+    trackToolResults(event) {
+        const content = event.message?.content;
+        if (content === undefined)
+            return;
+        for (const block of content) {
+            if (block.type !== 'tool_result') {
+                continue;
+            }
+            this.toolResultCount += 1;
+            if (block.is_error === true) {
+                this.toolResultErrorCount += 1;
+            }
+        }
+    }
+    /**
+     * Builds the final {@link StatsReport} from the captured `result` event and
+     * the tracked accumulators. Call once, after the stream closes.
+     */
+    buildReport() {
+        const event = this.resultEvent;
+        const usage = event?.usage;
+        const result = {
+            terminalReason: event?.terminal_reason,
+            stopReason: event?.stop_reason,
+            isError: event?.is_error === true,
+            numTurns: event?.num_turns,
+            permissionDenials: event?.permission_denials?.length ?? 0,
+            durationMs: event?.duration_ms,
+            totalCostUsd: event?.total_cost_usd,
+        };
+        let latency;
+        if (event?.duration_ms !== undefined) {
+            const wallMs = event.duration_ms;
+            const apiMs = event.duration_api_ms;
+            const localMs = apiMs !== undefined ? Math.max(0, wallMs - apiMs) : undefined;
+            const output = usage?.output_tokens;
+            const throughputTokPerS = (apiMs !== undefined && apiMs > 0 && output !== undefined && output > 0)
+                ? Math.round(output / (apiMs / 1000))
+                : undefined;
+            latency = { wallMs, apiMs, localMs, throughputTokPerS };
+        }
+        let tokens;
+        if (usage !== undefined) {
+            const input = usage.input_tokens ?? 0;
+            const output = usage.output_tokens ?? 0;
+            const cacheRead = usage.cache_read_input_tokens ?? 0;
+            const cacheCreate = usage.cache_creation_input_tokens ?? 0;
+            const total = input + output + cacheRead + cacheCreate;
+            const promptTotal = input + cacheRead + cacheCreate;
+            const cacheHitPct = promptTotal > 0 ? StatsCollector.round1((cacheRead / promptTotal) * 100) : 0;
+            tokens = {
+                input,
+                output,
+                cacheRead,
+                cacheCreate,
+                total,
+                cacheHitPct,
+                byModel: StatsCollector.buildByModel(event?.modelUsage),
+            };
+        }
+        const contextWindow = StatsCollector.maxContextWindow(event?.modelUsage);
+        const context = {
+            peakPromptTokens: this.peakPromptTokens,
+            contextWindow: contextWindow > 0 ? contextWindow : undefined,
+            peakPct: contextWindow > 0 ? StatsCollector.round1((this.peakPromptTokens / contextWindow) * 100) : undefined,
+        };
+        const byTool = [...this.toolUseCounts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .map(([name, count]) => ({ name, count }));
+        const totalCalls = byTool.reduce((sum, entry) => sum + entry.count, 0);
+        const errorPct = this.toolResultCount > 0 ? StatsCollector.round1((this.toolResultErrorCount / this.toolResultCount) * 100) : 0;
+        const tools = {
+            totalCalls,
+            byTool,
+            resultCount: this.toolResultCount,
+            errorCount: this.toolResultErrorCount,
+            errorPct,
+        };
+        return {
+            truncated: this.resultEvent === undefined,
+            result,
+            latency,
+            tokens,
+            context,
+            tools,
+        };
+    }
+    static buildByModel(modelUsage) {
+        if (modelUsage === undefined)
+            return [];
+        return Object.entries(modelUsage).map(([model, usage]) => ({
+            model,
+            input: usage.inputTokens ?? 0,
+            output: usage.outputTokens ?? 0,
+            cacheRead: usage.cacheReadInputTokens ?? 0,
+            cacheCreate: usage.cacheCreationInputTokens ?? 0,
+            costUsd: usage.costUSD,
+        }));
+    }
+    static maxContextWindow(modelUsage) {
+        if (modelUsage === undefined)
+            return 0;
+        let max = 0;
+        for (const usage of Object.values(modelUsage)) {
+            const contextWindow = usage.contextWindow ?? 0;
+            if (contextWindow > max) {
+                max = contextWindow;
+            }
+        }
+        return max;
+    }
+    static round1(value) {
+        return Math.round(value * 10) / 10;
+    }
+}
+//# sourceMappingURL=stats_collector.js.map

package/dist/stats/stats_collector.js.map

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

package/dist/stats/stats_renderer.d.ts

@@ -0,0 +1,13 @@
+import type { StatsFormat, StatsReport } from '../types/stats_report.js';
+/** Renders a {@link StatsReport} as colorized text, JSON, or Markdown. */
+export declare class StatsRenderer {
+    /**
+     * Renders the report in the requested format and returns it as a single
+     * string ready to print. Text output is colorized; JSON and Markdown are not.
+     */
+    static render(report: StatsReport, format: StatsFormat): string;
+    private static formatText;
+    private static formatMarkdown;
+    private static formatCount;
+}
+//# sourceMappingURL=stats_renderer.d.ts.map

package/dist/stats/stats_renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats_renderer.d.ts","sourceRoot":"","sources":["../../src/stats/stats_renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEzE,0EAA0E;AAC1E,qBAAa,aAAa;IACzB;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM;IAM/D,OAAO,CAAC,MAAM,CAAC,UAAU;IAiEzB,OAAO,CAAC,MAAM,CAAC,cAAc;IAoG7B,OAAO,CAAC,MAAM,CAAC,WAAW;CAG1B"}

package/dist/stats/stats_renderer.js

@@ -0,0 +1,193 @@
+import { colors } from '../libs/colors.js';
+import { TerminalOutput } from '../libs/terminal_output.js';
+/** Renders a {@link StatsReport} as colorized text, JSON, or Markdown. */
+export class StatsRenderer {
+    /**
+     * Renders the report in the requested format and returns it as a single
+     * string ready to print. Text output is colorized; JSON and Markdown are not.
+     */
+    static render(report, format) {
+        if (format === 'json')
+            return JSON.stringify(report, null, 2);
+        if (format === 'markdown')
+            return StatsRenderer.formatMarkdown(report);
+        return StatsRenderer.formatText(report);
+    }
+    static formatText(report) {
+        const lines = [];
+        const r = report.result;
+        lines.push(TerminalOutput.header('RESULT'));
+        if (report.truncated === true)
+            lines.push(colors.system('(no result event — stream truncated)'));
+        if (r.terminalReason !== undefined)
+            lines.push(colors.system(`terminal_reason: ${r.terminalReason}`));
+        if (r.stopReason !== undefined)
+            lines.push(colors.system(`stop_reason: ${r.stopReason}`));
+        if (r.isError === true)
+            lines.push(colors.error('is_error: true'));
+        if (r.permissionDenials > 0)
+            lines.push(colors.system(`permission_denials: ${r.permissionDenials}`));
+        if (r.numTurns !== undefined)
+            lines.push(colors.system(`turns: ${r.numTurns}`));
+        if (r.durationMs !== undefined)
+            lines.push(colors.system(`duration: ${(r.durationMs / 1000).toFixed(2)}s`));
+        if (r.totalCostUsd !== undefined)
+            lines.push(colors.system(`cost: $${r.totalCostUsd.toFixed(4)}`));
+        const latency = report.latency;
+        if (latency !== undefined) {
+            lines.push(TerminalOutput.header('LATENCY'));
+            lines.push(colors.system(`wall:  ${(latency.wallMs / 1000).toFixed(2)}s`));
+            if (latency.apiMs !== undefined)
+                lines.push(colors.system(`api:   ${(latency.apiMs / 1000).toFixed(2)}s`));
+            if (latency.localMs !== undefined)
+                lines.push(colors.system(`local: ${(latency.localMs / 1000).toFixed(2)}s (tools + overhead)`));
+            if (latency.throughputTokPerS !== undefined)
+                lines.push(colors.system(`throughput: ${latency.throughputTokPerS} output tok/s (api time)`));
+        }
+        const tokens = report.tokens;
+        if (tokens !== undefined) {
+            lines.push(TerminalOutput.header('TOKENS'));
+            lines.push(colors.system(`input:        ${StatsRenderer.formatCount(tokens.input)}`));
+            lines.push(colors.system(`output:       ${StatsRenderer.formatCount(tokens.output)}`));
+            lines.push(colors.system(`cache read:   ${StatsRenderer.formatCount(tokens.cacheRead)}`));
+            lines.push(colors.system(`cache create: ${StatsRenderer.formatCount(tokens.cacheCreate)}`));
+            lines.push(colors.system(`total:        ${StatsRenderer.formatCount(tokens.total)}`));
+            lines.push(colors.system(`cache hit:    ${tokens.cacheHitPct.toFixed(1)}% of prompt tokens`));
+            if (tokens.byModel.length > 0) {
+                lines.push(colors.system('\nby model:'));
+                for (const model of tokens.byModel) {
+                    const costSuffix = model.costUsd !== undefined ? ` $${model.costUsd.toFixed(4)}` : '';
+                    lines.push(colors.system(`  ${model.model}: in=${StatsRenderer.formatCount(model.input)} out=${StatsRenderer.formatCount(model.output)} cache_read=${StatsRenderer.formatCount(model.cacheRead)} cache_create=${StatsRenderer.formatCount(model.cacheCreate)}${costSuffix}`));
+                }
+            }
+        }
+        const context = report.context;
+        if (context.peakPromptTokens > 0) {
+            lines.push(TerminalOutput.header('CONTEXT'));
+            lines.push(colors.system(`peak prompt: ${StatsRenderer.formatCount(context.peakPromptTokens)} tokens`));
+            if (context.contextWindow !== undefined && context.peakPct !== undefined) {
+                lines.push(colors.system(`window:      ${StatsRenderer.formatCount(context.contextWindow)} (${context.peakPct.toFixed(1)}% used at peak)`));
+            }
+        }
+        const tools = report.tools;
+        if (tools.byTool.length > 0) {
+            lines.push(TerminalOutput.header('TOOLS'));
+            lines.push(colors.system(`calls: ${tools.totalCalls}`));
+            for (const entry of tools.byTool) {
+                lines.push(colors.system(`  ${entry.name}: ${entry.count}`));
+            }
+            if (tools.resultCount > 0) {
+                const line = `errors: ${tools.errorCount}/${tools.resultCount} (${tools.errorPct.toFixed(1)}%)`;
+                lines.push(tools.errorCount > 0 ? colors.error(line) : colors.system(line));
+            }
+        }
+        return lines.join('\n');
+    }
+    static formatMarkdown(report) {
+        const lines = [];
+        const r = report.result;
+        lines.push('## Stream stats');
+        lines.push('');
+        const summary = [];
+        if (r.terminalReason !== undefined)
+            summary.push(r.terminalReason);
+        if (r.stopReason !== undefined)
+            summary.push(r.stopReason);
+        if (r.numTurns !== undefined)
+            summary.push(`${r.numTurns} turns`);
+        if (r.durationMs !== undefined)
+            summary.push(`${(r.durationMs / 1000).toFixed(2)}s`);
+        if (r.totalCostUsd !== undefined)
+            summary.push(`$${r.totalCostUsd.toFixed(4)}`);
+        if (summary.length > 0) {
+            lines.push(`**Result:** ${summary.join(' · ')}`);
+            lines.push('');
+        }
+        if (report.truncated === true) {
+            lines.push('_No result event — stream truncated._');
+            lines.push('');
+        }
+        if (r.isError === true) {
+            lines.push('> ⚠️ **is_error: true**');
+            lines.push('');
+        }
+        if (r.permissionDenials > 0) {
+            lines.push(`> permission denials: ${r.permissionDenials}`);
+            lines.push('');
+        }
+        const latency = report.latency;
+        if (latency !== undefined) {
+            lines.push('### Latency');
+            lines.push('');
+            lines.push('| metric | value |');
+            lines.push('|---|---|');
+            lines.push(`| wall | ${(latency.wallMs / 1000).toFixed(2)}s |`);
+            if (latency.apiMs !== undefined)
+                lines.push(`| api | ${(latency.apiMs / 1000).toFixed(2)}s |`);
+            if (latency.localMs !== undefined)
+                lines.push(`| local (tools + overhead) | ${(latency.localMs / 1000).toFixed(2)}s |`);
+            if (latency.throughputTokPerS !== undefined)
+                lines.push(`| throughput | ${latency.throughputTokPerS} output tok/s |`);
+            lines.push('');
+        }
+        const tokens = report.tokens;
+        if (tokens !== undefined) {
+            lines.push('### Tokens');
+            lines.push('');
+            lines.push('| type | count |');
+            lines.push('|---|--:|');
+            lines.push(`| input | ${StatsRenderer.formatCount(tokens.input)} |`);
+            lines.push(`| output | ${StatsRenderer.formatCount(tokens.output)} |`);
+            lines.push(`| cache read | ${StatsRenderer.formatCount(tokens.cacheRead)} |`);
+            lines.push(`| cache create | ${StatsRenderer.formatCount(tokens.cacheCreate)} |`);
+            lines.push(`| **total** | **${StatsRenderer.formatCount(tokens.total)}** |`);
+            lines.push(`| cache hit | ${tokens.cacheHitPct.toFixed(1)}% |`);
+            lines.push('');
+            if (tokens.byModel.length > 0) {
+                lines.push('**By model:**');
+                lines.push('');
+                lines.push('| model | in | out | cache read | cache create | cost |');
+                lines.push('|---|--:|--:|--:|--:|--:|');
+                for (const model of tokens.byModel) {
+                    const cost = model.costUsd !== undefined ? `$${model.costUsd.toFixed(4)}` : '';
+                    lines.push(`| ${model.model} | ${StatsRenderer.formatCount(model.input)} | ${StatsRenderer.formatCount(model.output)} | ${StatsRenderer.formatCount(model.cacheRead)} | ${StatsRenderer.formatCount(model.cacheCreate)} | ${cost} |`);
+                }
+                lines.push('');
+            }
+        }
+        const context = report.context;
+        if (context.peakPromptTokens > 0) {
+            lines.push('### Context');
+            lines.push('');
+            if (context.contextWindow !== undefined && context.peakPct !== undefined) {
+                lines.push(`Peak prompt **${StatsRenderer.formatCount(context.peakPromptTokens)}** tokens — ${context.peakPct.toFixed(1)}% of ${StatsRenderer.formatCount(context.contextWindow)} window.`);
+            }
+            else {
+                lines.push(`Peak prompt **${StatsRenderer.formatCount(context.peakPromptTokens)}** tokens.`);
+            }
+            lines.push('');
+        }
+        const tools = report.tools;
+        if (tools.byTool.length > 0) {
+            lines.push('### Tools');
+            lines.push('');
+            lines.push(`Total calls: **${tools.totalCalls}**`);
+            lines.push('');
+            lines.push('| tool | calls |');
+            lines.push('|---|--:|');
+            for (const entry of tools.byTool) {
+                lines.push(`| ${entry.name} | ${entry.count} |`);
+            }
+            lines.push('');
+            if (tools.resultCount > 0) {
+                lines.push(`Errors: ${tools.errorCount}/${tools.resultCount} (${tools.errorPct.toFixed(1)}%)`);
+                lines.push('');
+            }
+        }
+        return lines.join('\n').trimEnd();
+    }
+    static formatCount(value) {
+        return value.toLocaleString('en-US');
+    }
+}
+//# sourceMappingURL=stats_renderer.js.map

package/dist/stats/stats_renderer.js.map

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

package/dist/types/claude_event.d.ts

@@ -0,0 +1,75 @@
+/**
+ * A single content block inside an `assistant` or `user` message.
+ *
+ * The same shape covers every block kind (`text`, `thinking`, `tool_use`,
+ * `tool_result`); only the fields relevant to a given `type` are populated.
+ */
+export type ContentBlock = {
+    type?: string;
+    text?: string;
+    thinking?: string;
+    id?: string;
+    name?: string;
+    input?: unknown;
+    tool_use_id?: string;
+    content?: string | Array<{
+        type?: string;
+        text?: string;
+    }>;
+    is_error?: boolean;
+};
+/** Raw, untyped input object of a `tool_use` block, keyed by parameter name. */
+export type ToolInput = Record<string, unknown>;
+/** Per-model usage aggregate, as found in the result event's `modelUsage` map. */
+export type ModelUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    costUSD?: number;
+    contextWindow?: number;
+};
+/**
+ * A consolidated Claude Code stream-json event (`system`, `assistant`, `user`,
+ * `rate_limit_event`, `result`, …).
+ *
+ * Partial typing on purpose: only the fields the viewer reads are listed.
+ * Anything unrecognized falls through to the unknown-event branch.
+ */
+export type ClaudeEvent = {
+    type?: string;
+    subtype?: string;
+    cwd?: string;
+    model?: string;
+    tools?: string[];
+    session_id?: string;
+    claude_code_version?: string;
+    message?: {
+        content?: ContentBlock[];
+        usage?: {
+            input_tokens?: number;
+            cache_read_input_tokens?: number;
+            cache_creation_input_tokens?: number;
+        };
+    };
+    rate_limit_info?: {
+        status?: string;
+    };
+    result?: string;
+    total_cost_usd?: number;
+    duration_ms?: number;
+    duration_api_ms?: number;
+    num_turns?: number;
+    is_error?: boolean;
+    stop_reason?: string;
+    permission_denials?: unknown[];
+    terminal_reason?: string;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        cache_read_input_tokens?: number;
+        cache_creation_input_tokens?: number;
+    };
+    modelUsage?: Record<string, ModelUsage>;
+};
+//# sourceMappingURL=claude_event.d.ts.map

package/dist/types/claude_event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_event.d.ts","sourceRoot":"","sources":["../../src/types/claude_event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;QACzB,KAAK,CAAC,EAAE;YACP,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;YACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;SACrC,CAAC;KACF,CAAC;IACF,eAAe,CAAC,EAAE;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;KACrC,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACxC,CAAC"}

package/dist/types/claude_event.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude_event.js.map

package/dist/types/claude_event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude_event.js","sourceRoot":"","sources":["../../src/types/claude_event.ts"],"names":[],"mappings":""}

package/dist/types/stats_report.d.ts

@@ -0,0 +1,68 @@
+/** Output format selected on the command line for the stats summary. */
+export type StatsFormat = 'text' | 'json' | 'markdown';
+/** Token counts and cost attributed to a single model within a session. */
+export type ModelTokens = {
+    model: string;
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheCreate: number;
+    costUsd?: number;
+};
+/**
+ * Structured end-of-stream statistics assembled by {@link StatsCollector} from
+ * the `result` event and the accumulators tracked across the stream.
+ *
+ * `latency` and `tokens` are absent when the stream had no `result` event
+ * (see `truncated`); `context` and `tools` are always present because they are
+ * derived from per-event accumulators.
+ */
+export type StatsReport = {
+    /** True when no `result` event was seen (the stream was cut short). */
+    truncated: boolean;
+    result: {
+        terminalReason?: string;
+        stopReason?: string;
+        isError: boolean;
+        numTurns?: number;
+        permissionDenials: number;
+        durationMs?: number;
+        totalCostUsd?: number;
+    };
+    /** Present only when the result event carried timing. */
+    latency?: {
+        wallMs: number;
+        apiMs?: number;
+        /** Wall time minus API time — local tool execution and overhead. */
+        localMs?: number;
+        throughputTokPerS?: number;
+    };
+    /** Present only when the result event carried usage. */
+    tokens?: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheCreate: number;
+        total: number;
+        /** Cache reads as a percentage of all prompt tokens. */
+        cacheHitPct: number;
+        byModel: ModelTokens[];
+    };
+    context: {
+        /** Largest single-message prompt (input + cache) seen in the stream. */
+        peakPromptTokens: number;
+        contextWindow?: number;
+        peakPct?: number;
+    };
+    tools: {
+        totalCalls: number;
+        byTool: Array<{
+            name: string;
+            count: number;
+        }>;
+        resultCount: number;
+        errorCount: number;
+        errorPct: number;
+    };
+};
+//# sourceMappingURL=stats_report.d.ts.map

package/dist/types/stats_report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats_report.d.ts","sourceRoot":"","sources":["../../src/types/stats_report.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAEvD,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,yDAAyD;IACzD,OAAO,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,oEAAoE;QACpE,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,wDAAwD;IACxD,MAAM,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;QACd,wDAAwD;QACxD,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,WAAW,EAAE,CAAC;KACvB,CAAC;IACF,OAAO,EAAE;QACR,wEAAwE;QACxE,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,KAAK,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KACjB,CAAC;CACF,CAAC"}

package/dist/types/stats_report.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stats_report.js.map

package/dist/types/stats_report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats_report.js","sourceRoot":"","sources":["../../src/types/stats_report.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,18 +1,23 @@
 {
     "name": "claude_stream_viewer",
-    "version": "1.0.15",
+    "version": "1.0.18",
     "description": "Claude Stream Viewer - Pretty-prints Claude API stream-json events from stdin with colorized output.",
-    "main": "dist/claude_stream_viewer.js",
+    "main": "dist/cli.js",
     "bin": {
-        "claude_stream_viewer": "dist/claude_stream_viewer.js"
+        "claude_stream_viewer": "dist/cli.js"
     },
     "scripts": {
-        "dev": "tsx ./src/claude_stream_viewer.ts",
+        "dev": "tsx ./src/cli.ts",
+        "sample:basic": "cat ./data/claude_events/basic.claude_events.jsonl | npm run dev",
+        "sample:video_generation": "cat ./data/claude_events/video_generation.claude_events.jsonl | npm run dev",
+        "sample:video_build_in_public": "cat ./data/claude_events/video_build_in_public.claude_events.jsonl | npm run dev",
         "build": "tsc -p tsconfig.build.json",
-        "postbuild": "chmod +x ./dist/claude_stream_viewer.js",
+        "postbuild": "chmod +x ./dist/cli.js",
         "version:bump": "npm version patch --no-git-tag-version && git commit -a -m \"feat: bump version in claude_stream_viewer package.json\"",
         "publish:all": "npm run version:bump && npm run build && npm publish --access public",
         "typecheck": "tsc --noEmit",
+        "demo_vhs:gif": "cd demo_vhs && vhs demo.tape",
+        "demo_vhs:gif:compress": "cd demo_vhs && gifsicle --lossy=80 --colors 64  -O3 claude_stream_viewer.gif -o claude_stream_viewer.compressed.gif",
         "test": "echo \"Error: no test specified\" && exit 1"
     },
     "keywords": [
@@ -30,12 +35,11 @@
     "type": "module",
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/jeromeetienne/skillmd_collection.git",
-        "directory": "packages/claude_stream_viewer"
+        "url": "git+https://github.com/jeromeetienne/claude_stream_viewer.git"
     },
-    "homepage": "https://github.com/jeromeetienne/skillmd_collection/tree/main/packages/claude_stream_viewer#readme",
+    "homepage": "https://github.com/jeromeetienne/claude_stream_viewer#readme",
     "bugs": {
-        "url": "https://github.com/jeromeetienne/skillmd_collection/issues"
+        "url": "https://github.com/jeromeetienne/claude_stream_viewer/issues"
     },
     "dependencies": {
         "chalk": "^5.6.2",