claude_stream_viewer 1.0.9

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

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

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

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

package/dist/claude-stream-viewer.js

@@ -0,0 +1,100 @@
+#!/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

@@ -0,0 +1 @@
+{"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

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

package/dist/claude_stream_viewer.d.ts.map

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

package/dist/claude_stream_viewer.js

@@ -0,0 +1,100 @@
+#!/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

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

package/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "claude_stream_viewer",
+    "version": "1.0.9",
+    "description": "Claude Stream Viewer - Pretty-prints Claude API stream-json events from stdin with colorized output.",
+    "main": "dist/claude_stream_viewer.js",
+    "bin": {
+        "claude_stream_viewer": "dist/claude_stream_viewer.js"
+    },
+    "scripts": {
+        "dev": "tsx ./src/claude_stream_viewer.ts",
+        "build": "tsc -p tsconfig.build.json",
+        "postbuild": "chmod +x ./dist/claude_stream_viewer.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",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": [],
+    "author": "",
+    "license": "ISC",
+    "type": "module",
+    "dependencies": {
+        "chalk": "^5.6.2"
+    },
+    "devDependencies": {
+        "@types/node": "^20.0.0",
+        "tsx": "^4.21.0",
+        "typescript": "^5.3.3"
+    }
+}

package/src/claude_stream_viewer.ts

@@ -0,0 +1,137 @@
+#!/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';
+
+// Partial typing on purpose: stream-json's shape varies across SDK versions and
+// event subtypes, and we only consume the few fields we render. Anything we
+// don't recognize falls through to the UNKNOWN EVENT branch so the user can
+// extend this type incrementally as new shapes show up.
+type ClaudeEvent = {
+	type?: string;
+	event?: {
+		type?: string;
+		delta?: {
+			type?: string;
+			text?: string;
+		};
+	};
+	// Legacy `message_delta` format places the text delta one level higher,
+	// directly on the root event rather than inside `event.delta`.
+	delta?: {
+		text?: string;
+	};
+	message?: {
+		content?: Array<{ type?: string; text?: string }>;
+	};
+};
+
+const colors = {
+	text: chalk.white,
+	tool: chalk.cyan,
+	system: chalk.gray,
+	error: chalk.red,
+	json: chalk.dim,
+	header: chalk.yellow.bold,
+};
+
+function printText(text: string) {
+	process.stdout.write(colors.text(text));
+}
+
+function printNewline() {
+	process.stdout.write('\n');
+}
+
+function printHeader(label: string) {
+	printNewline();
+	console.log(colors.header(`\n=== ${label} ===`));
+}
+
+function printJSON(obj: unknown) {
+	console.log(colors.json(JSON.stringify(obj, null, 2)));
+}
+
+function handleEvent(data: ClaudeEvent) {
+	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]'));
+});

package/tsconfig.build.json

@@ -0,0 +1,13 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "rootDir": "src/",
+        "outDir": "dist",
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true
+    },
+    "include": [
+        "src/**/*"
+    ]
+}

package/tsconfig.json

@@ -0,0 +1,28 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "node16",
+        "lib": [
+            "ES2020"
+        ],
+        "moduleResolution": "node16",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "resolveJsonModule": true,
+        "types": [
+            "node"
+        ],
+        "rootDir": ".",
+    },
+    "include": [
+        "src/**/*",
+        "tests/**/*",
+        "examples/**/*",
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}