claude_stream_viewer 1.0.15 → 1.0.18

package/src/stats/stats_renderer.ts

@@ -0,0 +1,185 @@
+import { colors } from '../libs/colors.js';
+import { TerminalOutput } from '../libs/terminal_output.js';
+import type { StatsFormat, StatsReport } from '../types/stats_report.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: StatsReport, format: StatsFormat): string {
+		if (format === 'json') return JSON.stringify(report, null, 2);
+		if (format === 'markdown') return StatsRenderer.formatMarkdown(report);
+		return StatsRenderer.formatText(report);
+	}
+
+	private static formatText(report: StatsReport): string {
+		const lines: string[] = [];
+		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');
+	}
+
+	private static formatMarkdown(report: StatsReport): string {
+		const lines: string[] = [];
+		const r = report.result;
+		lines.push('## Stream stats');
+		lines.push('');
+		const summary: string[] = [];
+		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();
+	}
+
+	private static formatCount(value: number): string {
+		return value.toLocaleString('en-US');
+	}
+}

package/src/types/claude_event.ts

@@ -0,0 +1,74 @@
+/**
+ * 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>;
+};

package/src/types/stats_report.ts

@@ -0,0 +1,66 @@
+/** 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;
+	};
+};

package/dist/claude-stream-viewer.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=claude-stream-viewer.d.ts.map

package/dist/claude-stream-viewer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claude-stream-viewer.d.ts","sourceRoot":"","sources":["../src/claude-stream-viewer.ts"],"names":[],"mappings":""}

package/dist/claude-stream-viewer.js

@@ -1,100 +0,0 @@
-#!/usr/bin/env node
-// Reads Claude API stream-json events line-by-line from stdin and pretty-prints
-// them with colorized output. Designed to wrap an upstream `claude --stream-json`
-// pipe, e.g. `claude … | claude_stream_viewer`.
-import readline from 'node:readline';
-import chalk from 'chalk';
-const colors = {
-    text: chalk.white,
-    tool: chalk.cyan,
-    system: chalk.gray,
-    error: chalk.red,
-    json: chalk.dim,
-    header: chalk.yellow.bold,
-};
-function printText(text) {
-    process.stdout.write(colors.text(text));
-}
-function printNewline() {
-    process.stdout.write('\n');
-}
-function printHeader(label) {
-    printNewline();
-    console.log(colors.header(`\n=== ${label} ===`));
-}
-function printJSON(obj) {
-    console.log(colors.json(JSON.stringify(obj, null, 2)));
-}
-function handleEvent(data) {
-    try {
-        // Newer SDKs wrap each event in a `stream_event` envelope.
-        if (data.type === 'stream_event' && data.event) {
-            const evt = data.event;
-            if (evt.delta?.type === 'text_delta' && evt.delta.text) {
-                printText(evt.delta.text);
-                return;
-            }
-            if (evt.type === 'tool_use') {
-                printHeader('TOOL USE');
-                printJSON(evt);
-                return;
-            }
-            // `content_block_delta` is the parent envelope of `text_delta` —
-            // already rendered above, so skip it here to avoid duplicating
-            // the text stream as a JSON dump.
-            if (evt.type && evt.type !== 'content_block_delta') {
-                printHeader(`EVENT: ${evt.type}`);
-                printJSON(evt);
-                return;
-            }
-        }
-        // Legacy format: pre-`stream_event` SDKs emit raw `message_delta`
-        // events with the text delta hanging off the root.
-        if (data.type === 'message_delta') {
-            const text = data.delta?.text;
-            if (text) {
-                printText(text);
-                return;
-            }
-        }
-        // Final assistant message bundling all content blocks for the turn.
-        if (data.message?.content) {
-            printHeader('FINAL MESSAGE');
-            for (const block of data.message.content) {
-                if (block.text) {
-                    console.log(colors.text(block.text));
-                }
-            }
-            return;
-        }
-        // Unrecognized shape — dump it raw so the user can extend ClaudeEvent.
-        printHeader('UNKNOWN EVENT');
-        printJSON(data);
-    }
-    catch (err) {
-        // Never let a single malformed event take down the stream — log and move on.
-        console.error(colors.error('Error processing event:'), err);
-        printJSON(data);
-    }
-}
-const rl = readline.createInterface({
-    input: process.stdin,
-    crlfDelay: Infinity,
-});
-rl.on('line', (line) => {
-    // stream-json pipes occasionally pad with blank lines between events.
-    if (line.trim() === '')
-        return;
-    try {
-        const parsed = JSON.parse(line);
-        handleEvent(parsed);
-    }
-    catch (err) {
-        console.error(colors.error('Invalid JSON:'), line);
-    }
-});
-rl.on('close', () => {
-    printNewline();
-    console.log(colors.system('\n[stream ended]'));
-});
-//# sourceMappingURL=claude-stream-viewer.js.map

package/dist/claude-stream-viewer.js.map

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

package/dist/claude_stream_viewer.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=claude_stream_viewer.d.ts.map

package/dist/claude_stream_viewer.d.ts.map

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

package/dist/claude_stream_viewer.js

@@ -1,155 +0,0 @@
-#!/usr/bin/env node
-// Reads Claude API stream-json events line-by-line from stdin and pretty-prints
-// them with colorized output. Designed to wrap an upstream `claude --stream-json`
-// pipe, e.g. `claude … | npx claude_stream_viewer`.
-// Usage:
-//   claude --stream-json | npx claude_stream_viewer
-//
-// claude --output-format stream-json --verbose --include-partial-messages --permission-mode auto -p "explain quantum computing like I'm 5" | npx claude_stream_viewer
-import Readline from 'node:readline';
-import Fs from 'node:fs';
-import * as Commander from 'commander';
-import Chalk from 'chalk';
-import Path from 'node:path';
-const __dirname = new URL('.', import.meta.url).pathname;
-const colors = {
-    text: Chalk.white,
-    tool: Chalk.cyan,
-    system: Chalk.gray,
-    error: Chalk.red,
-    json: Chalk.dim,
-    header: Chalk.yellow.bold,
-};
-///////////////////////////////////////////////////////////////////////////////
-///////////////////////////////////////////////////////////////////////////////
-//	class MainHelper
-///////////////////////////////////////////////////////////////////////////////
-///////////////////////////////////////////////////////////////////////////////
-class MainHelper {
-    static printText(text) {
-        process.stdout.write(colors.text(text));
-    }
-    static printNewline() {
-        process.stdout.write('\n');
-    }
-    static printHeader(label) {
-        MainHelper.printNewline();
-        console.log(colors.header(`\n=== ${label} ===`));
-    }
-    static printJSON(obj) {
-        console.log(colors.json(JSON.stringify(obj, null, 2)));
-    }
-    static handleEvent(data) {
-        try {
-            // Newer SDKs wrap each event in a `stream_event` envelope.
-            if (data.type === 'stream_event' && data.event) {
-                const evt = data.event;
-                if (evt.delta?.type === 'text_delta' && evt.delta.text) {
-                    MainHelper.printText(evt.delta.text);
-                    return;
-                }
-                if (evt.type === 'tool_use') {
-                    MainHelper.printHeader('TOOL USE');
-                    MainHelper.printJSON(evt);
-                    return;
-                }
-                // `content_block_delta` is the parent envelope of `text_delta` —
-                // already rendered above, so skip it here to avoid duplicating
-                // the text stream as a JSON dump.
-                if (evt.type && evt.type !== 'content_block_delta') {
-                    MainHelper.printHeader(`EVENT: ${evt.type}`);
-                    MainHelper.printJSON(evt);
-                    return;
-                }
-            }
-            // Legacy format: pre-`stream_event` SDKs emit raw `message_delta`
-            // events with the text delta hanging off the root.
-            if (data.type === 'message_delta') {
-                const text = data.delta?.text;
-                if (text) {
-                    MainHelper.printText(text);
-                    return;
-                }
-            }
-            // Final assistant message bundling all content blocks for the turn.
-            if (data.message?.content) {
-                MainHelper.printHeader('FINAL MESSAGE');
-                for (const block of data.message.content) {
-                    if (block.text) {
-                        console.log(colors.text(block.text));
-                    }
-                }
-                return;
-            }
-            // Unrecognized shape — dump it raw so the user can extend ClaudeEvent.
-            MainHelper.printHeader('UNKNOWN EVENT');
-            MainHelper.printJSON(data);
-        }
-        catch (err) {
-            // Never let a single malformed event take down the stream — log and move on.
-            console.error(colors.error('Error processing event:'), err);
-            MainHelper.printJSON(data);
-        }
-    }
-}
-///////////////////////////////////////////////////////////////////////////////
-///////////////////////////////////////////////////////////////////////////////
-//	function main
-///////////////////////////////////////////////////////////////////////////////
-///////////////////////////////////////////////////////////////////////////////
-async function main() {
-    const packageJsonPath = Path.join(__dirname, '..', 'package.json');
-    const packageJson = JSON.parse(await Fs.promises.readFile(packageJsonPath, 'utf-8'));
-    const packageVersion = packageJson.version ?? 'unknown';
-    ///////////////////////////////////////////////////////////////////////////////
-    ///////////////////////////////////////////////////////////////////////////////
-    //	
-    ///////////////////////////////////////////////////////////////////////////////
-    ///////////////////////////////////////////////////////////////////////////////
-    const program = new Commander.Command();
-    program
-        .name('claude_stream_viewer')
-        .description('Pretty-prints Claude API stream-json events from stdin with colorized output.')
-        .version(packageVersion)
-        .option('--no-color', 'disable colored output')
-        .parse(process.argv);
-    const options = program.opts();
-    ///////////////////////////////////////////////////////////////////////////////
-    ///////////////////////////////////////////////////////////////////////////////
-    //	
-    ///////////////////////////////////////////////////////////////////////////////
-    ///////////////////////////////////////////////////////////////////////////////
-    if (options.color === false) {
-        Chalk.level = 0;
-    }
-    const readline = Readline.createInterface({
-        input: process.stdin,
-        crlfDelay: Infinity,
-    });
-    readline.on('line', (line) => {
-        // stream-json pipes occasionally pad with blank lines between events.
-        if (line.trim() === '')
-            return;
-        try {
-            const parsed = JSON.parse(line);
-            MainHelper.handleEvent(parsed);
-        }
-        catch (err) {
-            console.error(colors.error('Invalid JSON:'), line);
-        }
-    });
-    await new Promise((resolve) => {
-        readline.on('close', () => {
-            MainHelper.printNewline();
-            console.log(colors.system('\n[stream ended]'));
-            resolve();
-        });
-    });
-}
-///////////////////////////////////////////////////////////////////////////////
-///////////////////////////////////////////////////////////////////////////////
-//	
-///////////////////////////////////////////////////////////////////////////////
-///////////////////////////////////////////////////////////////////////////////
-await main();
-//# sourceMappingURL=claude_stream_viewer.js.map

package/dist/claude_stream_viewer.js.map

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