claude-code-parser 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# claude-code-parser
+
+[![npm version](https://img.shields.io/npm/v/claude-code-parser)](https://www.npmjs.com/package/claude-code-parser)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/claude-code-parser)](https://bundlephobia.com/package/claude-code-parser)
+
+Parse Claude Code's `--output-format stream-json` NDJSON output into fully typed TypeScript events. Zero dependencies. 9 kB.
+
+**[Documentation](https://udhaykumarbala.github.io/claude-code-parser/)** | **[Protocol Reference](https://udhaykumarbala.github.io/claude-code-parser/protocol/overview)**
+
+> Includes the first standalone documentation of Claude Code's undocumented `stream-json` protocol.
+
+## Install
+
+```bash
+npm install claude-code-parser
+```
+
+## Quick Start
+
+```typescript
+import { spawn } from 'child_process'
+import { createInterface } from 'readline'
+import { parseLine, Translator, createMessage } from 'claude-code-parser'
+
+const claude = spawn('claude', [
+  '-p', '--input-format', 'stream-json',
+  '--output-format', 'stream-json', '--verbose',
+], { stdio: ['pipe', 'pipe', 'inherit'] })
+
+const translator = new Translator()
+
+const rl = createInterface({ input: claude.stdout! })
+rl.on('line', (line) => {
+  const event = parseLine(line)
+  if (!event) return
+
+  for (const relay of translator.translate(event)) {
+    switch (relay.type) {
+      case 'text_delta':    process.stdout.write(relay.content); break
+      case 'tool_use':      console.log(`\n[tool] ${relay.toolName}`); break
+      case 'turn_complete': console.log(`\n[done] $${relay.costUsd?.toFixed(4)}`); break
+    }
+  }
+})
+
+claude.stdin!.write(createMessage.user('What is 2 + 2?'))
+```
+
+## API
+
+| Export | Description |
+|---|---|
+| `parseLine(line)` | NDJSON line → `ClaudeEvent \| null` |
+| `Translator` | Stateful dedup translator → `RelayEvent[]` |
+| `createMessage.user(text)` | Construct stdin user message |
+| `createMessage.approve(id)` | Approve pending tool execution |
+| `createMessage.deny(id)` | Deny pending tool execution |
+| `createMessage.toolResult(id, content)` | Send tool result |
+| `extractContent(raw)` | Normalize polymorphic tool_result content |
+
+### RelayEvent Types
+
+`text_delta` | `thinking_delta` | `tool_use` | `tool_result` | `session_meta` | `turn_complete` | `error`
+
+[Full API docs](https://udhaykumarbala.github.io/claude-code-parser/guide/api)
+
+## Why This Exists
+
+The official SDK (`@anthropic-ai/claude-code`) couples parsing with subprocess management. This library **only parses** — for developers building custom relays, dashboards, CI tools, or browser viewers who need raw event access.
+
+Key problems it solves:
+- **`--verbose` deduplication** — cumulative snapshots require stateful content tracking
+- **Multi-agent interleaving** — sub-agents produce interleaved events on the same stdout
+- **Polymorphic content** — `tool_result.content` can be string, array, or null
+- **Double-encoded results** — the `result` field is JSON inside JSON
+
+## Documentation
+
+- [Getting Started](https://udhaykumarbala.github.io/claude-code-parser/guide/getting-started)
+- [API Reference](https://udhaykumarbala.github.io/claude-code-parser/guide/api)
+- [Examples](https://udhaykumarbala.github.io/claude-code-parser/guide/examples) — WS relay, log viewer, CI tracker, tool approval
+- [Protocol Overview](https://udhaykumarbala.github.io/claude-code-parser/protocol/overview)
+- [Output Events](https://udhaykumarbala.github.io/claude-code-parser/protocol/output-events) — Full event catalog
+- [Input Messages](https://udhaykumarbala.github.io/claude-code-parser/protocol/input-messages) — Undocumented stdin protocol
+- [Deduplication](https://udhaykumarbala.github.io/claude-code-parser/protocol/deduplication)
+- [Multi-Agent](https://udhaykumarbala.github.io/claude-code-parser/protocol/multi-agent)
+- [Gotchas](https://udhaykumarbala.github.io/claude-code-parser/protocol/gotchas) — Double encoding, polymorphic content, thinking field names
+
+## License
+
+MIT
+
+> This is an unofficial community package. Not affiliated with or endorsed by Anthropic.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { parseLine } from './parser.js';
+export { Translator, extractContent } from './translator.js';
+export { createMessage } from './writer.js';
+export type { ClaudeEvent, ClaudeMessage, ClaudeContent, ModelUsageEntry, } from './types/protocol.js';
+export type { RelayEvent, TextDeltaEvent, ThinkingDeltaEvent, ToolUseEvent, ToolResultEvent, SessionMetaEvent, TurnCompleteEvent, ErrorEvent, } from './types/events.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAG5B,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACX,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Core parser
+export { parseLine } from './parser.js';
+// Stateful translator with dedup
+export { Translator, extractContent } from './translator.js';
+// Stdin message constructors
+export { createMessage } from './writer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE5D,6BAA6B;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/parser.d.ts

@@ -0,0 +1,12 @@
+import type { ClaudeEvent } from './types/protocol.js';
+/**
+ * Parse a single NDJSON line from Claude Code's stdout into a typed event.
+ *
+ * Returns `null` for empty lines or unparseable JSON (matching the Go
+ * reference which logs and skips bad lines).
+ *
+ * @param line - One line of NDJSON from Claude Code's stdout
+ * @returns Typed ClaudeEvent, or null if the line is empty/invalid
+ */
+export declare function parseLine(line: string): ClaudeEvent | null;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAS1D"}

package/dist/parser.js

@@ -0,0 +1,21 @@
+/**
+ * Parse a single NDJSON line from Claude Code's stdout into a typed event.
+ *
+ * Returns `null` for empty lines or unparseable JSON (matching the Go
+ * reference which logs and skips bad lines).
+ *
+ * @param line - One line of NDJSON from Claude Code's stdout
+ * @returns Typed ClaudeEvent, or null if the line is empty/invalid
+ */
+export function parseLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return null;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAErC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAA;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/translator.d.ts

@@ -0,0 +1,40 @@
+import type { ClaudeEvent } from './types/protocol.js';
+import type { RelayEvent } from './types/events.js';
+/**
+ * Translates raw ClaudeEvents into deduplicated RelayEvents.
+ *
+ * Tracks content block index to avoid re-emitting blocks that were
+ * already sent in previous `assistant` events (the `--verbose` mode
+ * cumulative snapshot problem).
+ *
+ * Port of the Go Translator in mobile-code/translator.go.
+ */
+export declare class Translator {
+    private lastContentIndex;
+    private lastFirstBlockKey;
+    private _sessionId;
+    private _model;
+    /** The session ID captured from the most recent `system/init` event. */
+    get sessionId(): string | undefined;
+    /** The model name captured from the most recent `system/init` event. */
+    get model(): string | undefined;
+    /** Reset content index tracking. Call on new turn/session. */
+    reset(): void;
+    /** Convert a raw ClaudeEvent into zero or more RelayEvents. */
+    translate(raw: ClaudeEvent): RelayEvent[];
+    private translateSystem;
+    private translateResult;
+    private translateAssistant;
+    private translateUser;
+    private translateContentBlock;
+}
+/**
+ * Handle the polymorphic `content` field in tool_result blocks.
+ *
+ * Three possible shapes:
+ * 1. `string` — plain text
+ * 2. `Array<{ type: string; text: string }>` — structured text blocks, joined with newline
+ * 3. `null` / `undefined` — empty string
+ */
+export declare function extractContent(raw: unknown): string;
+//# sourceMappingURL=translator.d.ts.map

package/dist/translator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../src/translator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgC,MAAM,qBAAqB,CAAA;AACpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEnD;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,MAAM,CAAoB;IAElC,wEAAwE;IACxE,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAElC;IAED,wEAAwE;IACxE,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,8DAA8D;IAC9D,KAAK,IAAI,IAAI;IAKb,+DAA+D;IAC/D,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,EAAE;IAgBzC,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,qBAAqB;CAsC9B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAiBnD"}

package/dist/translator.js

@@ -0,0 +1,247 @@
+/**
+ * Translates raw ClaudeEvents into deduplicated RelayEvents.
+ *
+ * Tracks content block index to avoid re-emitting blocks that were
+ * already sent in previous `assistant` events (the `--verbose` mode
+ * cumulative snapshot problem).
+ *
+ * Port of the Go Translator in mobile-code/translator.go.
+ */
+export class Translator {
+    lastContentIndex = 0;
+    lastFirstBlockKey;
+    _sessionId;
+    _model;
+    /** The session ID captured from the most recent `system/init` event. */
+    get sessionId() {
+        return this._sessionId;
+    }
+    /** The model name captured from the most recent `system/init` event. */
+    get model() {
+        return this._model;
+    }
+    /** Reset content index tracking. Call on new turn/session. */
+    reset() {
+        this.lastContentIndex = 0;
+        this.lastFirstBlockKey = undefined;
+    }
+    /** Convert a raw ClaudeEvent into zero or more RelayEvents. */
+    translate(raw) {
+        switch (raw.type) {
+            case 'system':
+                return this.translateSystem(raw);
+            case 'result':
+                return this.translateResult(raw);
+            case 'assistant':
+                return this.translateAssistant(raw);
+            case 'user':
+                return this.translateUser(raw);
+            default:
+                // progress, rate_limit_event, and unknown types are ignored
+                return [];
+        }
+    }
+    translateSystem(raw) {
+        switch (raw.subtype) {
+            case 'init':
+                if (raw.session_id)
+                    this._sessionId = raw.session_id;
+                if (raw.model)
+                    this._model = raw.model;
+                return [{
+                        type: 'session_meta',
+                        model: raw.model ?? 'unknown',
+                    }];
+            case 'result': {
+                const resultText = parseDoubleEncodedResult(raw.result);
+                if (raw.is_error) {
+                    this.reset();
+                    return [{
+                            type: 'error',
+                            message: resultText,
+                            sessionId: raw.session_id,
+                        }];
+                }
+                this.reset();
+                return [{
+                        type: 'turn_complete',
+                        sessionId: raw.session_id,
+                    }];
+            }
+            default:
+                return [];
+        }
+    }
+    translateResult(raw) {
+        const resultText = parseDoubleEncodedResult(raw.result);
+        if (raw.subtype === 'error' || raw.is_error) {
+            this.reset();
+            return [{
+                    type: 'error',
+                    message: resultText,
+                    sessionId: raw.session_id,
+                }];
+        }
+        const ev = {
+            type: 'turn_complete',
+            sessionId: raw.session_id,
+            costUsd: raw.total_cost_usd,
+        };
+        // Extract usage from modelUsage (take first model entry)
+        if (raw.modelUsage) {
+            for (const usage of Object.values(raw.modelUsage)) {
+                ev.inputTokens =
+                    usage.inputTokens + usage.cacheReadInputTokens + usage.cacheCreationInputTokens;
+                ev.outputTokens = usage.outputTokens;
+                ev.contextWindow = usage.contextWindow;
+                break; // Take the first (usually only) model
+            }
+        }
+        this.reset();
+        return [ev];
+    }
+    translateAssistant(raw) {
+        const msg = raw.message;
+        if (!msg?.content || msg.content.length === 0)
+            return [];
+        // Detect context switches (new turn, different sub-agent, etc.)
+        // by fingerprinting the first content block. If it doesn't match
+        // what we were tracking, this is a different message stream → reset.
+        const firstKey = blockFingerprint(msg.content[0]);
+        if (firstKey !== this.lastFirstBlockKey) {
+            this.lastContentIndex = 0;
+            this.lastFirstBlockKey = firstKey;
+        }
+        // Safety: if content shrank below our index for any other reason, reset.
+        if (msg.content.length < this.lastContentIndex) {
+            this.lastContentIndex = 0;
+        }
+        const events = [];
+        // Only process content blocks we haven't sent yet (dedup)
+        for (let i = this.lastContentIndex; i < msg.content.length; i++) {
+            const block = msg.content[i];
+            const ev = this.translateContentBlock(block);
+            if (ev)
+                events.push(ev);
+        }
+        this.lastContentIndex = msg.content.length;
+        return events;
+    }
+    translateUser(raw) {
+        const msg = raw.message;
+        if (!msg?.content)
+            return [];
+        const events = [];
+        for (const block of msg.content) {
+            if (block.type === 'tool_result') {
+                events.push({
+                    type: 'tool_result',
+                    toolUseId: block.tool_use_id ?? '',
+                    output: extractContent(block.content),
+                    isError: block.is_error ?? false,
+                });
+            }
+        }
+        return events;
+    }
+    translateContentBlock(block) {
+        switch (block.type) {
+            case 'text':
+                return {
+                    type: 'text_delta',
+                    content: block.text ?? '',
+                };
+            case 'thinking': {
+                const text = block.thinking ?? block.text ?? '';
+                if (!text)
+                    return null;
+                return {
+                    type: 'thinking_delta',
+                    content: text,
+                };
+            }
+            case 'tool_use':
+                return {
+                    type: 'tool_use',
+                    toolUseId: block.id ?? '',
+                    toolName: block.name ?? '',
+                    input: block.input != null ? JSON.stringify(block.input) : '',
+                };
+            case 'tool_result':
+                return {
+                    type: 'tool_result',
+                    toolUseId: block.tool_use_id ?? '',
+                    output: extractContent(block.content),
+                    isError: block.is_error ?? false,
+                };
+            default:
+                // Unknown block types are silently skipped
+                return null;
+        }
+    }
+}
+/**
+ * Handle the polymorphic `content` field in tool_result blocks.
+ *
+ * Three possible shapes:
+ * 1. `string` — plain text
+ * 2. `Array<{ type: string; text: string }>` — structured text blocks, joined with newline
+ * 3. `null` / `undefined` — empty string
+ */
+export function extractContent(raw) {
+    if (raw == null)
+        return '';
+    if (typeof raw === 'string')
+        return raw;
+    if (Array.isArray(raw)) {
+        const parts = [];
+        for (const block of raw) {
+            if (block && typeof block === 'object' && 'text' in block && typeof block.text === 'string') {
+                if (block.text)
+                    parts.push(block.text);
+            }
+        }
+        return parts.join('\n');
+    }
+    // Fallback: stringify whatever we got
+    return String(raw);
+}
+/**
+ * Create a fingerprint for a content block to detect context switches.
+ *
+ * Uses the block's stable identity: tool_use blocks have unique IDs,
+ * text/thinking blocks use a prefix of their content. This lets the
+ * translator detect when interleaved sub-agent events switch context.
+ */
+function blockFingerprint(block) {
+    // tool_use blocks have unique IDs — best signal
+    if (block.id)
+        return `${block.type}:${block.id}`;
+    // thinking/text blocks — use first 64 chars as fingerprint
+    const text = block.thinking ?? block.text ?? '';
+    if (text)
+        return `${block.type}:${text.slice(0, 64)}`;
+    // Fallback for exotic blocks
+    return `${block.type}:${block.tool_use_id ?? 'unknown'}`;
+}
+/**
+ * Parse the double-encoded `result` field.
+ * Claude Code's result field is a JSON-encoded string (e.g., `"\"actual text\""`).
+ */
+function parseDoubleEncodedResult(result) {
+    if (result == null)
+        return '';
+    if (typeof result === 'string') {
+        try {
+            const parsed = JSON.parse(result);
+            if (typeof parsed === 'string')
+                return parsed;
+        }
+        catch {
+            // Not double-encoded, use as-is
+        }
+        return result;
+    }
+    return String(result);
+}
+//# sourceMappingURL=translator.js.map

package/dist/translator.js.map

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

package/dist/types/events.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Translated relay events — the normalized output of the Translator.
+ *
+ * This is a discriminated union on the `type` field. Consumers can
+ * switch on `event.type` to get full type narrowing.
+ */
+export type RelayEvent = TextDeltaEvent | ThinkingDeltaEvent | ToolUseEvent | ToolResultEvent | SessionMetaEvent | TurnCompleteEvent | ErrorEvent;
+export interface TextDeltaEvent {
+    type: 'text_delta';
+    content: string;
+}
+export interface ThinkingDeltaEvent {
+    type: 'thinking_delta';
+    content: string;
+}
+export interface ToolUseEvent {
+    type: 'tool_use';
+    toolUseId: string;
+    toolName: string;
+    /** Tool input as a JSON string. */
+    input: string;
+}
+export interface ToolResultEvent {
+    type: 'tool_result';
+    toolUseId: string;
+    output: string;
+    isError: boolean;
+}
+export interface SessionMetaEvent {
+    type: 'session_meta';
+    model: string;
+}
+export interface TurnCompleteEvent {
+    type: 'turn_complete';
+    sessionId?: string;
+    costUsd?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    contextWindow?: number;
+}
+export interface ErrorEvent {
+    type: 'error';
+    message: string;
+    sessionId?: string;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,kBAAkB,GAClB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,UAAU,CAAA;AAEd,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/types/events.js

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

package/dist/types/events.js.map

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

package/dist/types/protocol.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Raw NDJSON types from Claude Code's `--output-format stream-json`.
+ *
+ * These mirror the wire format exactly. Fields use snake_case to match
+ * the JSON keys Claude Code emits. Types are intentionally loose —
+ * the protocol is undocumented and can add fields/types without notice.
+ */
+/** Per-model token usage breakdown, keyed by model ID in ClaudeEvent.modelUsage. */
+export interface ModelUsageEntry {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    contextWindow: number;
+}
+/** Raw NDJSON envelope from Claude Code's stdout. */
+export interface ClaudeEvent {
+    type: string;
+    subtype?: string;
+    message?: ClaudeMessage;
+    /** Double-encoded JSON string — must be JSON.parse()'d to get actual text. */
+    result?: unknown;
+    session_id?: string;
+    model?: string;
+    tools?: string[];
+    duration_ms?: number;
+    duration_api_ms?: number;
+    cost_usd?: number;
+    total_cost_usd?: number;
+    is_error?: boolean;
+    num_turns?: number;
+    modelUsage?: Record<string, ModelUsageEntry>;
+    usage?: unknown;
+}
+/** Message payload within a ClaudeEvent. */
+export interface ClaudeMessage {
+    content: ClaudeContent[];
+    role?: string;
+    stop_reason?: string;
+}
+/**
+ * Polymorphic content block.
+ *
+ * `type` is deliberately `string` (not a union) because Claude Code
+ * can add new block types in any release. The translator handles
+ * known types and silently skips unknown ones.
+ */
+export interface ClaudeContent {
+    type: string;
+    /** Text content (for `text` blocks, also fallback for `thinking` blocks in some formats). */
+    text?: string;
+    /** Thinking content (primary field for `thinking` blocks). */
+    thinking?: string;
+    /** Tool use ID (for `tool_use` blocks). */
+    id?: string;
+    /** Tool name (for `tool_use` blocks). */
+    name?: string;
+    /** Tool input — kept as unknown since shapes vary by tool. */
+    input?: unknown;
+    /**
+     * Tool result content — polymorphic:
+     * - `string` — plain text
+     * - `Array<{ type: string; text: string }>` — structured text blocks
+     * - `null` — no content
+     */
+    content?: unknown;
+    /** Back-reference to the tool_use block (for `tool_result` blocks). */
+    tool_use_id?: string;
+    /** Whether the tool result is an error (for `tool_result` blocks). */
+    is_error?: boolean;
+}
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,wBAAwB,EAAE,MAAM,CAAA;IAChC,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB"}

package/dist/types/protocol.js

@@ -0,0 +1,9 @@
+/**
+ * Raw NDJSON types from Claude Code's `--output-format stream-json`.
+ *
+ * These mirror the wire format exactly. Fields use snake_case to match
+ * the JSON keys Claude Code emits. Types are intentionally loose —
+ * the protocol is undocumented and can add fields/types without notice.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/types/protocol.js.map

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

package/dist/writer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Construct NDJSON messages for Claude Code's `--input-format stream-json` stdin.
+ *
+ * Each function returns a single NDJSON line (JSON + newline) ready to be
+ * written to the Claude Code process's stdin.
+ *
+ * Port of Go WriteToStdin, WriteToolResult, WriteToolResultWithContent
+ * from mobile-code/session.go.
+ */
+export declare const createMessage: {
+    /**
+     * Construct a user chat message.
+     *
+     * @param content - The message text to send to Claude
+     * @returns NDJSON line to write to stdin
+     */
+    readonly user: (content: string) => string;
+    /**
+     * Approve a pending tool execution.
+     *
+     * @param toolUseId - The tool_use block ID to approve
+     * @returns NDJSON line to write to stdin
+     */
+    readonly approve: (toolUseId: string) => string;
+    /**
+     * Deny a pending tool execution.
+     *
+     * @param toolUseId - The tool_use block ID to deny
+     * @returns NDJSON line to write to stdin
+     */
+    readonly deny: (toolUseId: string) => string;
+    /**
+     * Send a tool result with custom content (for interactive tools like AskUserQuestion).
+     *
+     * @param toolUseId - The tool_use block ID this result is for
+     * @param content - The result content to send
+     * @returns NDJSON line to write to stdin
+     */
+    readonly toolResult: (toolUseId: string, content: string) => string;
+};
+//# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa;IACxB;;;;;OAKG;6BACW,MAAM,KAAG,MAAM;IAO7B;;;;;OAKG;kCACgB,MAAM,KAAG,MAAM;IAOlC;;;;;OAKG;+BACa,MAAM,KAAG,MAAM;IAO/B;;;;;;OAMG;qCACmB,MAAM,WAAW,MAAM,KAAG,MAAM;CAO9C,CAAA"}

package/dist/writer.js

@@ -0,0 +1,62 @@
+/**
+ * Construct NDJSON messages for Claude Code's `--input-format stream-json` stdin.
+ *
+ * Each function returns a single NDJSON line (JSON + newline) ready to be
+ * written to the Claude Code process's stdin.
+ *
+ * Port of Go WriteToStdin, WriteToolResult, WriteToolResultWithContent
+ * from mobile-code/session.go.
+ */
+export const createMessage = {
+    /**
+     * Construct a user chat message.
+     *
+     * @param content - The message text to send to Claude
+     * @returns NDJSON line to write to stdin
+     */
+    user(content) {
+        return JSON.stringify({
+            type: 'user',
+            message: { role: 'user', content },
+        }) + '\n';
+    },
+    /**
+     * Approve a pending tool execution.
+     *
+     * @param toolUseId - The tool_use block ID to approve
+     * @returns NDJSON line to write to stdin
+     */
+    approve(toolUseId) {
+        return JSON.stringify({
+            type: 'approve',
+            tool_use_id: toolUseId,
+        }) + '\n';
+    },
+    /**
+     * Deny a pending tool execution.
+     *
+     * @param toolUseId - The tool_use block ID to deny
+     * @returns NDJSON line to write to stdin
+     */
+    deny(toolUseId) {
+        return JSON.stringify({
+            type: 'deny',
+            tool_use_id: toolUseId,
+        }) + '\n';
+    },
+    /**
+     * Send a tool result with custom content (for interactive tools like AskUserQuestion).
+     *
+     * @param toolUseId - The tool_use block ID this result is for
+     * @param content - The result content to send
+     * @returns NDJSON line to write to stdin
+     */
+    toolResult(toolUseId, content) {
+        return JSON.stringify({
+            type: 'tool_result',
+            tool_use_id: toolUseId,
+            content,
+        }) + '\n';
+    },
+};
+//# sourceMappingURL=writer.js.map

package/dist/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../src/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;SACnC,CAAC,GAAG,IAAI,CAAA;IACX,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,SAAiB;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,SAAS;SACvB,CAAC,GAAG,IAAI,CAAA;IACX,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,SAAiB;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,SAAS;SACvB,CAAC,GAAG,IAAI,CAAA;IACX,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,SAAiB,EAAE,OAAe;QAC3C,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,SAAS;YACtB,OAAO;SACR,CAAC,GAAG,IAAI,CAAA;IACX,CAAC;CACO,CAAA"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "claude-code-parser",
+  "version": "0.1.0",
+  "description": "Parse Claude Code's --output-format stream-json into fully typed TypeScript events",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "stream-json",
+    "ndjson",
+    "parser",
+    "cli",
+    "streaming",
+    "typescript"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
+    "vitest": "^4.1.0"
+  }
+}