ralph-cli-sandboxed 0.2.7 → 0.2.8

package/dist/utils/stream-json.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Stream JSON parser interface and provider-specific implementations.
+ *
+ * Each CLI provider has its own stream-json event format. This module provides
+ * a unified interface for parsing stream-json output from different providers.
+ */
+/**
+ * Interface for parsing stream-json lines from CLI providers.
+ */
+export interface StreamJsonParser {
+    /**
+     * Parse a single line of stream-json output and return displayable text.
+     * @param line - A single line of JSON output
+     * @returns Human-readable text to display, or empty string if nothing to show
+     */
+    parseStreamJsonLine(line: string): string;
+}
+/**
+ * Base class for stream-json parsers with common utilities.
+ */
+declare abstract class BaseStreamParser implements StreamJsonParser {
+    protected debug: boolean;
+    constructor(debug?: boolean);
+    abstract parseStreamJsonLine(line: string): string;
+    protected debugLog(message: string): void;
+    protected truncateOutput(output: string | unknown, maxLength?: number): string;
+}
+/**
+ * Parser for Claude Code CLI stream-json events.
+ *
+ * Event types:
+ * - content_block_delta: Incremental text updates (text_delta, input_json_delta)
+ * - content_block_start: Tool use or text block start
+ * - content_block_stop: End of content block
+ * - tool_result: Tool execution results
+ * - assistant: Complete assistant message with content blocks
+ * - message_start/message_delta/message_stop: Message lifecycle
+ * - system/user: System and user messages
+ * - result/error: Final results or errors
+ * - file_edit/file_write/file_read: File operations
+ * - bash/command: Command execution
+ * - bash_output/command_output: Command results
+ */
+export declare class ClaudeStreamParser extends BaseStreamParser {
+    parseStreamJsonLine(line: string): string;
+    private handleFallback;
+}
+/**
+ * Parser for Gemini CLI stream-json events.
+ *
+ * Event types:
+ * - initialization: Model initialization info
+ * - messages: Conversation messages
+ * - tools: Tool calls and results
+ * - turn_complete: End of turn
+ * - response: Final response text
+ */
+export declare class GeminiStreamParser extends BaseStreamParser {
+    parseStreamJsonLine(line: string): string;
+    private handleFallback;
+}
+/**
+ * Parser for OpenCode CLI stream-json events.
+ *
+ * Event types:
+ * - step_start/step_end/step_finish: Step lifecycle
+ * - tool_use: Tool invocation with nested part structure (part.type="tool", part.tool, part.state)
+ * - tool/tool_call: Direct tool invocation (alternate format)
+ * - tool_response: Tool results
+ * - text: Text output with nested part structure (part.text)
+ * - assistant_message/model_response: Model output
+ * - thinking/reasoning: Thinking process
+ * - done/complete: Completion
+ */
+export declare class OpenCodeStreamParser extends BaseStreamParser {
+    parseStreamJsonLine(line: string): string;
+    private handleFallback;
+}
+/**
+ * Parser for Codex CLI stream-json events.
+ *
+ * Event types:
+ * - thread.started: Thread initialization
+ * - turn.started/turn.completed/turn.failed: Turn lifecycle
+ * - item.started/item.completed/item.failed: Action lifecycle
+ *   - command_execution, file_change, file_read, mcp_tool_call, web_search, plan_update
+ */
+export declare class CodexStreamParser extends BaseStreamParser {
+    parseStreamJsonLine(line: string): string;
+    private handleFallback;
+}
+/**
+ * Parser for Goose CLI stream-json events.
+ *
+ * Goose uses a similar event format to Claude Code.
+ * Falls back to Claude parser behavior for common events.
+ */
+export declare class GooseStreamParser extends BaseStreamParser {
+    private claudeParser;
+    constructor(debug?: boolean);
+    parseStreamJsonLine(line: string): string;
+}
+/**
+ * Parser for Aider CLI stream events.
+ *
+ * Aider's --stream flag outputs JSON events for:
+ * - text: Streamed text content
+ * - tool_call: Tool/function calls
+ * - tool_result: Tool execution results
+ * - file_edit: File modifications
+ * - error: Error messages
+ */
+export declare class AiderStreamParser extends BaseStreamParser {
+    parseStreamJsonLine(line: string): string;
+    private handleFallback;
+}
+/**
+ * Universal fallback parser that handles common event patterns.
+ * Used for providers without specific stream-json support or as a fallback.
+ */
+export declare class DefaultStreamParser extends BaseStreamParser {
+    parseStreamJsonLine(line: string): string;
+}
+/**
+ * Get the appropriate stream-json parser for a CLI provider.
+ *
+ * @param provider - The CLI provider name (e.g., "claude", "gemini", "opencode")
+ * @param debug - Enable debug logging
+ * @returns The appropriate StreamJsonParser for the provider
+ */
+export declare function getStreamJsonParser(provider: string | undefined, debug?: boolean): StreamJsonParser;
+export {};