@telora/daemon-core 0.2.5

package/dist/stream-json.d.ts

@@ -0,0 +1,885 @@
+/**
+ * Stream-JSON protocol module -- shared core for Claude Code interactive sessions.
+ *
+ * This is the canonical implementation used by both the Telora daemon and factory
+ * engines. It handles parsing NDJSON output from `--output-format stream-json`
+ * and writing messages for `--input-format stream-json`.
+ *
+ * Wire format: newline-delimited JSON (one JSON object per line).
+ *
+ * All inbound events are validated against Zod schemas before routing.
+ * Malformed events are logged, counted, and skipped -- never crash the parser.
+ */
+import { EventEmitter } from 'node:events';
+import type { Readable, Writable } from 'node:stream';
+import { z } from 'zod';
+declare const OutputEventSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"system">;
+    subtype: z.ZodLiteral<"init">;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+    cwd: z.ZodString;
+    model: z.ZodString;
+    tools: z.ZodArray<z.ZodString, "many">;
+    mcp_servers: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        status: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        name: string;
+    }, {
+        status: string;
+        name: string;
+    }>, "many">;
+    permissionMode: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "system";
+    subtype: "init";
+    uuid: string;
+    session_id: string;
+    cwd: string;
+    model: string;
+    tools: string[];
+    mcp_servers: {
+        status: string;
+        name: string;
+    }[];
+    permissionMode: string;
+}, {
+    type: "system";
+    subtype: "init";
+    uuid: string;
+    session_id: string;
+    cwd: string;
+    model: string;
+    tools: string[];
+    mcp_servers: {
+        status: string;
+        name: string;
+    }[];
+    permissionMode: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"system">;
+    subtype: z.ZodEnum<["teammate_spawned", "teammate_idle", "teammate_completed"]>;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+    agent_id: z.ZodString;
+    agent_name: z.ZodString;
+    team_id: z.ZodString;
+    agent_type: z.ZodOptional<z.ZodString>;
+    result: z.ZodOptional<z.ZodString>;
+    is_error: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    type: "system";
+    subtype: "teammate_spawned" | "teammate_idle" | "teammate_completed";
+    uuid: string;
+    session_id: string;
+    agent_id: string;
+    agent_name: string;
+    team_id: string;
+    agent_type?: string | undefined;
+    result?: string | undefined;
+    is_error?: boolean | undefined;
+}, {
+    type: "system";
+    subtype: "teammate_spawned" | "teammate_idle" | "teammate_completed";
+    uuid: string;
+    session_id: string;
+    agent_id: string;
+    agent_name: string;
+    team_id: string;
+    agent_type?: string | undefined;
+    result?: string | undefined;
+    is_error?: boolean | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"system">;
+    subtype: z.ZodString;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodLiteral<"system">;
+    subtype: z.ZodString;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodLiteral<"system">;
+    subtype: z.ZodString;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+    type: z.ZodLiteral<"stream_event">;
+    event: z.ZodObject<{
+        type: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    parent_tool_use_id: z.ZodNullable<z.ZodString>;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "stream_event";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id: string | null;
+    event: {
+        type: string;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    type: "stream_event";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id: string | null;
+    event: {
+        type: string;
+    } & {
+        [k: string]: unknown;
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant">;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+    message: z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"message">;
+        role: z.ZodLiteral<"assistant">;
+        content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+        }, {
+            type: "text";
+            text: string;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"tool_use">;
+            id: z.ZodString;
+            name: z.ZodString;
+            input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        }, {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"thinking">;
+            thinking: z.ZodString;
+            signature: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "thinking";
+            thinking: string;
+            signature: string;
+        }, {
+            type: "thinking";
+            thinking: string;
+            signature: string;
+        }>]>, "many">;
+        model: z.ZodString;
+        stop_reason: z.ZodNullable<z.ZodString>;
+        usage: z.ZodObject<{
+            input_tokens: z.ZodNumber;
+            output_tokens: z.ZodNumber;
+            cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+            cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        }, {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        type: "message";
+        id: string;
+        model: string;
+        role: "assistant";
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "thinking";
+            thinking: string;
+            signature: string;
+        })[];
+        stop_reason: string | null;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        };
+    }, {
+        type: "message";
+        id: string;
+        model: string;
+        role: "assistant";
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "thinking";
+            thinking: string;
+            signature: string;
+        })[];
+        stop_reason: string | null;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        };
+    }>;
+    parent_tool_use_id: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        type: "message";
+        id: string;
+        model: string;
+        role: "assistant";
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "thinking";
+            thinking: string;
+            signature: string;
+        })[];
+        stop_reason: string | null;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        };
+    };
+    type: "assistant";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id: string | null;
+}, {
+    message: {
+        type: "message";
+        id: string;
+        model: string;
+        role: "assistant";
+        content: ({
+            type: "text";
+            text: string;
+        } | {
+            type: "tool_use";
+            id: string;
+            name: string;
+            input: Record<string, unknown>;
+        } | {
+            type: "thinking";
+            thinking: string;
+            signature: string;
+        })[];
+        stop_reason: string | null;
+        usage: {
+            input_tokens: number;
+            output_tokens: number;
+            cache_creation_input_tokens?: number | undefined;
+            cache_read_input_tokens?: number | undefined;
+        };
+    };
+    type: "assistant";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id: string | null;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"user">;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+    message: z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        content: z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"tool_result">;
+            tool_use_id: z.ZodString;
+            content: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">]>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_result";
+            content: string | Record<string, unknown>[];
+            tool_use_id: string;
+        }, {
+            type: "tool_result";
+            content: string | Record<string, unknown>[];
+            tool_use_id: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        role: "user";
+        content: {
+            type: "tool_result";
+            content: string | Record<string, unknown>[];
+            tool_use_id: string;
+        }[];
+    }, {
+        role: "user";
+        content: {
+            type: "tool_result";
+            content: string | Record<string, unknown>[];
+            tool_use_id: string;
+        }[];
+    }>;
+    parent_tool_use_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        role: "user";
+        content: {
+            type: "tool_result";
+            content: string | Record<string, unknown>[];
+            tool_use_id: string;
+        }[];
+    };
+    type: "user";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id?: string | null | undefined;
+}, {
+    message: {
+        role: "user";
+        content: {
+            type: "tool_result";
+            content: string | Record<string, unknown>[];
+            tool_use_id: string;
+        }[];
+    };
+    type: "user";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id?: string | null | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"user">;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+    message: z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        content: z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: "text";
+            text: string;
+        }, {
+            type: "text";
+            text: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        role: "user";
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }, {
+        role: "user";
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    parent_tool_use_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    message: {
+        role: "user";
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
+    type: "user";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id?: string | null | undefined;
+}, {
+    message: {
+        role: "user";
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    };
+    type: "user";
+    uuid: string;
+    session_id: string;
+    parent_tool_use_id?: string | null | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    is_error: z.ZodBoolean;
+    duration_ms: z.ZodNumber;
+    duration_api_ms: z.ZodNumber;
+    num_turns: z.ZodNumber;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }>>;
+    result: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    is_error: z.ZodBoolean;
+    duration_ms: z.ZodNumber;
+    duration_api_ms: z.ZodNumber;
+    num_turns: z.ZodNumber;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }>>;
+    result: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    is_error: z.ZodBoolean;
+    duration_ms: z.ZodNumber;
+    duration_api_ms: z.ZodNumber;
+    num_turns: z.ZodNumber;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }>>;
+    result: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    is_error: z.ZodBoolean;
+    duration_ms: z.ZodNumber;
+    duration_api_ms: z.ZodNumber;
+    num_turns: z.ZodNumber;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }>>;
+    result: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    is_error: z.ZodBoolean;
+    duration_ms: z.ZodNumber;
+    duration_api_ms: z.ZodNumber;
+    num_turns: z.ZodNumber;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }>>;
+    result: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodLiteral<"result">;
+    subtype: z.ZodString;
+    is_error: z.ZodBoolean;
+    duration_ms: z.ZodNumber;
+    duration_api_ms: z.ZodNumber;
+    num_turns: z.ZodNumber;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    usage: z.ZodOptional<z.ZodObject<{
+        input_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        cache_creation_input_tokens: z.ZodOptional<z.ZodNumber>;
+        cache_read_input_tokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }, {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number | undefined;
+        cache_read_input_tokens?: number | undefined;
+    }>>;
+    result: z.ZodOptional<z.ZodString>;
+    errors: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>, z.ZodObject<{
+    type: z.ZodLiteral<"rate_limit_event">;
+    rate_limit_info: z.ZodObject<{
+        status: z.ZodString;
+        resetsAt: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        rateLimitType: z.ZodOptional<z.ZodString>;
+        overageStatus: z.ZodOptional<z.ZodString>;
+        overageDisabledReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        isUsingOverage: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        status: z.ZodString;
+        resetsAt: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        rateLimitType: z.ZodOptional<z.ZodString>;
+        overageStatus: z.ZodOptional<z.ZodString>;
+        overageDisabledReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        isUsingOverage: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        status: z.ZodString;
+        resetsAt: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+        rateLimitType: z.ZodOptional<z.ZodString>;
+        overageStatus: z.ZodOptional<z.ZodString>;
+        overageDisabledReason: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        isUsingOverage: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>;
+    uuid: z.ZodString;
+    session_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "rate_limit_event";
+    uuid: string;
+    session_id: string;
+    rate_limit_info: {
+        status: string;
+        resetsAt?: string | number | undefined;
+        rateLimitType?: string | undefined;
+        overageStatus?: string | undefined;
+        overageDisabledReason?: string | null | undefined;
+        isUsingOverage?: boolean | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    type: "rate_limit_event";
+    uuid: string;
+    session_id: string;
+    rate_limit_info: {
+        status: string;
+        resetsAt?: string | number | undefined;
+        rateLimitType?: string | undefined;
+        overageStatus?: string | undefined;
+        overageDisabledReason?: string | null | undefined;
+        isUsingOverage?: boolean | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}>]>;
+export { OutputEventSchema };
+/** System init event emitted at session start. */
+export interface SystemInitEvent {
+    type: 'system';
+    subtype: 'init';
+    uuid: string;
+    session_id: string;
+    cwd: string;
+    model: string;
+    tools: string[];
+    mcp_servers: Array<{
+        name: string;
+        status: string;
+    }>;
+    permissionMode: string;
+}
+/** System event for teammate lifecycle (Agent Teams). */
+export interface TeammateEvent {
+    type: 'system';
+    subtype: 'teammate_spawned' | 'teammate_idle' | 'teammate_completed';
+    uuid: string;
+    session_id: string;
+    agent_id: string;
+    agent_name: string;
+    team_id: string;
+    agent_type?: string;
+    result?: string;
+    is_error?: boolean;
+}
+/** Generic system event for subtypes beyond init and teammate lifecycle. */
+export interface GenericSystemEvent {
+    type: 'system';
+    subtype: string;
+    uuid: string;
+    session_id: string;
+    [key: string]: unknown;
+}
+/** User text message -- emitted during compaction and other system-generated user messages. */
+export interface UserTextMessageEvent {
+    type: 'user';
+    uuid: string;
+    session_id: string;
+    message: {
+        role: 'user';
+        content: Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    parent_tool_use_id?: string | null;
+}
+/** Raw streaming event wrapper -- contains Claude API streaming events. */
+export interface StreamEvent {
+    type: 'stream_event';
+    event: RawStreamEvent;
+    parent_tool_use_id: string | null;
+    uuid: string;
+    session_id: string;
+}
+/** Raw Claude API stream event types. */
+export type RawStreamEvent = {
+    type: 'message_start';
+    message: {
+        id: string;
+        role: string;
+        model: string;
+        usage: TokenUsage;
+    };
+} | {
+    type: 'content_block_start';
+    index: number;
+    content_block: TextBlock | ToolUseBlock | ThinkingBlock;
+} | {
+    type: 'content_block_delta';
+    index: number;
+    delta: TextDelta | InputJsonDelta;
+} | {
+    type: 'content_block_stop';
+    index: number;
+} | {
+    type: 'message_delta';
+    delta: {
+        stop_reason: string | null;
+        stop_sequence: string | null;
+    };
+    usage: {
+        output_tokens: number;
+    };
+} | {
+    type: 'message_stop';
+} | {
+    type: 'ping';
+};
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ThinkingBlock {
+    type: 'thinking';
+    thinking: string;
+    signature: string;
+}
+export interface TextDelta {
+    type: 'text_delta';
+    text: string;
+}
+export interface InputJsonDelta {
+    type: 'input_json_delta';
+    partial_json: string;
+}
+export interface TokenUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+/** Complete assistant message (emitted after all stream events for a turn). */
+export interface AssistantMessage {
+    type: 'assistant';
+    uuid: string;
+    session_id: string;
+    message: {
+        id: string;
+        type: 'message';
+        role: 'assistant';
+        content: Array<TextBlock | ToolUseBlock | ThinkingBlock>;
+        model: string;
+        stop_reason: string | null;
+        usage: TokenUsage;
+    };
+    parent_tool_use_id: string | null;
+}
+/** Successful result -- signals turn completion. */
+export interface ResultSuccess {
+    type: 'result';
+    subtype: string;
+    is_error: false;
+    duration_ms: number;
+    duration_api_ms: number;
+    num_turns: number;
+    result?: string;
+    total_cost_usd?: number;
+    usage?: TokenUsage;
+    [key: string]: unknown;
+}
+/** Error result -- signals turn completion with error. */
+export interface ResultError {
+    type: 'result';
+    subtype: string;
+    is_error: true;
+    duration_ms: number;
+    duration_api_ms: number;
+    num_turns: number;
+    total_cost_usd?: number;
+    usage?: TokenUsage;
+    errors?: string[];
+    result?: string;
+    [key: string]: unknown;
+}
+/** User tool_result message -- emitted when Claude Code sends tool results back. */
+export interface UserToolResultEvent {
+    type: 'user';
+    uuid: string;
+    session_id: string;
+    message: {
+        role: 'user';
+        content: Array<{
+            type: 'tool_result';
+            tool_use_id: string;
+            content: string | Array<Record<string, unknown>>;
+        }>;
+    };
+    parent_tool_use_id?: string | null;
+}
+/** Rate limit event -- emitted when Claude Code encounters API rate limits. */
+export interface RateLimitEvent {
+    type: 'rate_limit_event';
+    rate_limit_info: {
+        status: string;
+        resetsAt?: string | number;
+        rateLimitType?: string;
+        overageStatus?: string;
+        overageDisabledReason?: string | null;
+        isUsingOverage?: boolean;
+        [key: string]: unknown;
+    };
+    uuid: string;
+    session_id: string;
+}
+/** Union of all possible output events. */
+export type OutputEvent = SystemInitEvent | TeammateEvent | GenericSystemEvent | StreamEvent | AssistantMessage | UserToolResultEvent | UserTextMessageEvent | ResultSuccess | ResultError | RateLimitEvent;
+/** User message sent to Claude Code via stdin. */
+export interface UserMessage {
+    type: 'user';
+    message: {
+        role: 'user';
+        content: string;
+    };
+}
+export interface StreamJsonParserEvents {
+    event: (event: OutputEvent) => void;
+    result: (result: ResultSuccess | ResultError) => void;
+    init: (event: SystemInitEvent) => void;
+    teammate: (event: TeammateEvent) => void;
+    assistant: (message: AssistantMessage) => void;
+    error: (err: Error, line: string) => void;
+}
+/**
+ * Line-buffered NDJSON parser for Claude Code stream-json output.
+ *
+ * Reads from a Readable stream, validates each line against Zod schemas,
+ * and emits typed events. Malformed events are logged, counted, and skipped.
+ */
+export declare class StreamJsonParser extends EventEmitter {
+    private buffer;
+    private _sessionId;
+    private _lastEventTime;
+    private _unparsedEventCount;
+    get sessionId(): string | null;
+    get lastEventTime(): Date;
+    /** Number of events that failed Zod validation and were skipped. */
+    get unparsedEventCount(): number;
+    /**
+     * Attach the parser to a readable stream (typically process.stdout).
+     */
+    attach(stream: Readable): void;
+    private processBuffer;
+    private routeEvent;
+}
+/**
+ * Send a user message to Claude Code via stdin (stream-json format).
+ *
+ * Each message is serialized as a single JSON line followed by a newline.
+ */
+export declare function sendMessage(stdin: Writable, content: string): boolean;
+//# sourceMappingURL=stream-json.d.ts.map