sudocode 1.0.0 → 1.1.1

package/node_modules/@sudocode-ai/local-server/dist/execution/output/claude-code-output-processor.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Claude Code Output Processor
+ *
+ * Implements the IOutputProcessor interface specifically for parsing
+ * Claude Code's stream-json output format in real-time.
+ *
+ * This processor is tailored to Claude Code's CLI output and handles its
+ * specific message structure, tool calling patterns, and metadata format.
+ *
+ * @module execution/output/claude-code-output-processor
+ */
+import type { IOutputProcessor, ProcessingMetrics, ToolCall, FileChange, ToolCallHandler, FileChangeHandler, ProgressHandler, ErrorHandler } from "./types.js";
+/**
+ * ClaudeCodeOutputProcessor - Parses Claude Code's stream-json output
+ *
+ * This processor is specifically designed for Claude Code's output format.
+ * It handles line-by-line parsing of Claude's stream-json messages,
+ * extracting tool calls, file changes, and usage metrics in real-time.
+ *
+ * **Claude Code Specific Features:**
+ * - Parses Claude's message.content array structure
+ * - Handles tool_use and tool_result content types
+ * - Extracts usage metrics from result messages
+ * - Processes Claude-specific error formats
+ *
+ * @example
+ * ```typescript
+ * const processor = new ClaudeCodeOutputProcessor();
+ *
+ * processor.onToolCall((toolCall) => {
+ *   console.log(`Claude called tool: ${toolCall.name}`, toolCall.input);
+ * });
+ *
+ * // Process Claude Code's stream-json output
+ * await processor.processLine('{"type":"assistant","message":{"content":[...]}}');
+ * const metrics = processor.getMetrics();
+ * ```
+ */
+export declare class ClaudeCodeOutputProcessor implements IOutputProcessor {
+    private _metrics;
+    private _toolCalls;
+    private _fileChanges;
+    private _toolCallHandlers;
+    private _fileChangeHandlers;
+    private _progressHandlers;
+    private _errorHandlers;
+    private _messageHandlers;
+    private _usageHandlers;
+    private _lineNumber;
+    constructor();
+    /**
+     * Process a single line of Claude Code's stream-json output
+     *
+     * Parses the JSON line and routes to appropriate handler based on message type.
+     * Handles malformed JSON gracefully and skips empty lines.
+     *
+     * @param line - Raw JSON line from Claude Code CLI output
+     */
+    processLine(line: string): Promise<void>;
+    /**
+     * Get current processing metrics
+     *
+     * @returns Current aggregate metrics
+     */
+    getMetrics(): ProcessingMetrics;
+    /**
+     * Get all tool calls recorded during processing
+     *
+     * @returns Array of all tool calls
+     */
+    getToolCalls(): ToolCall[];
+    /**
+     * Get all file changes detected during processing
+     *
+     * @returns Array of all file changes
+     */
+    getFileChanges(): FileChange[];
+    /**
+     * Register a callback for tool call events
+     *
+     * @param handler - Function to call when a tool is invoked
+     */
+    onToolCall(handler: ToolCallHandler): void;
+    /**
+     * Register a callback for file change events
+     *
+     * @param handler - Function to call when a file is modified
+     */
+    onFileChange(handler: FileChangeHandler): void;
+    /**
+     * Register a callback for progress update events
+     *
+     * @param handler - Function to call when metrics are updated
+     */
+    onProgress(handler: ProgressHandler): void;
+    /**
+     * Register a callback for error events
+     *
+     * @param handler - Function to call when an error occurs
+     */
+    onError(handler: ErrorHandler): void;
+    /**
+     * Register a callback for message events
+     *
+     * @param handler - Function to call when a text message is received
+     */
+    onMessage(handler: import("./types.js").MessageHandler): void;
+    /**
+     * Register a callback for usage metric updates
+     *
+     * @param handler - Function to call when usage metrics are updated
+     */
+    onUsage(handler: import("./types.js").UsageHandler): void;
+    /**
+     * Get tool calls filtered by tool name
+     *
+     * @param toolName - Name of the tool to filter by (e.g., 'Bash', 'Read', 'Write')
+     * @returns Array of tool calls matching the tool name
+     *
+     * @example
+     * ```typescript
+     * const bashCalls = processor.getToolCallsByName('Bash');
+     * console.log(`Executed ${bashCalls.length} bash commands`);
+     * ```
+     */
+    getToolCallsByName(toolName: string): ToolCall[];
+    /**
+     * Get file changes filtered by file path
+     *
+     * @param path - File path to filter by (exact match)
+     * @returns Array of file changes to the specified path
+     *
+     * @example
+     * ```typescript
+     * const changes = processor.getFileChangesByPath('src/index.ts');
+     * console.log(`File modified ${changes.length} times`);
+     * ```
+     */
+    getFileChangesByPath(path: string): FileChange[];
+    /**
+     * Get file changes filtered by operation type
+     *
+     * @param operation - Operation type to filter by ('read', 'write', 'edit')
+     * @returns Array of file changes with the specified operation
+     *
+     * @example
+     * ```typescript
+     * const writes = processor.getFileChangesByOperation('write');
+     * console.log(`Wrote to ${writes.length} files`);
+     * ```
+     */
+    getFileChangesByOperation(operation: "read" | "write" | "edit"): FileChange[];
+    /**
+     * Get only failed tool calls
+     *
+     * @returns Array of tool calls with status='error'
+     *
+     * @example
+     * ```typescript
+     * const failures = processor.getFailedToolCalls();
+     * failures.forEach(call => {
+     *   console.error(`${call.name} failed:`, call.error);
+     * });
+     * ```
+     */
+    getFailedToolCalls(): ToolCall[];
+    /**
+     * Get only successful tool calls
+     *
+     * @returns Array of tool calls with status='success'
+     *
+     * @example
+     * ```typescript
+     * const successes = processor.getSuccessfulToolCalls();
+     * console.log(`${successes.length} tool calls succeeded`);
+     * ```
+     */
+    getSuccessfulToolCalls(): ToolCall[];
+    /**
+     * Get total cost of execution in USD
+     *
+     * @returns Total cost based on token usage
+     *
+     * @example
+     * ```typescript
+     * const cost = processor.getTotalCost();
+     * console.log(`Execution cost: $${cost.toFixed(2)}`);
+     * ```
+     */
+    getTotalCost(): number;
+    /**
+     * Get execution summary with aggregate statistics
+     *
+     * Provides a high-level overview of the execution including:
+     * - Tool call counts by type
+     * - File operation counts by type
+     * - Success rates
+     * - Token usage and costs
+     * - Duration
+     *
+     * @returns Complete execution summary
+     *
+     * @example
+     * ```typescript
+     * const summary = processor.getExecutionSummary();
+     * console.log('Execution Summary:', {
+     *   duration: `${summary.duration}ms`,
+     *   cost: `$${summary.totalCost.toFixed(2)}`,
+     *   successRate: `${summary.successRate.toFixed(1)}%`,
+     *   toolCalls: summary.toolCallsByType,
+     * });
+     * ```
+     */
+    getExecutionSummary(): import("./types.js").ExecutionSummary;
+    /**
+     * Handle tool_use message from Claude Code
+     *
+     * Creates a new ToolCall entry with pending status and emits onToolCall event.
+     * Also detects potential file operations based on tool name.
+     *
+     * @param message - Parsed tool_use message
+     */
+    private _handleToolUse;
+    /**
+     * Handle tool_result message from Claude Code
+     *
+     * Updates the corresponding ToolCall with result/error status.
+     * Detects file changes from Read/Write/Edit tools and emits onFileChange event.
+     *
+     * @param message - Parsed tool_result message
+     */
+    private _handleToolResult;
+    /**
+     * Handle text message from Claude Code
+     *
+     * Emits message events to registered handlers.
+     *
+     * @param message - Parsed text message
+     */
+    private _handleText;
+    /**
+     * Handle usage message from Claude Code
+     *
+     * Updates usage metrics with token counts and calculates cost.
+     * Emits usage events to registered handlers.
+     *
+     * @param message - Parsed usage message
+     */
+    private _handleUsage;
+    /**
+     * Handle error message from Claude Code
+     *
+     * Tracks error in metrics and emits onError event.
+     *
+     * @param message - Parsed error message
+     */
+    private _handleError;
+    /**
+     * Detect file change from a tool call
+     *
+     * Analyzes tool calls to file operation tools (Read/Write/Edit) and
+     * extracts file change information.
+     *
+     * @param toolCall - The completed tool call
+     * @param message - The tool result message
+     * @returns FileChange object if file operation detected, null otherwise
+     */
+    private _detectFileChange;
+    /**
+     * Detect the type of message from parsed Claude Code JSON data
+     *
+     * Claude Code uses a specific structure with type and message.content fields.
+     * This method understands Claude's output format.
+     *
+     * @param data - Parsed JSON object from Claude Code
+     * @returns Message type
+     */
+    private _detectMessageType;
+    /**
+     * Parse raw Claude Code JSON data into an OutputMessage
+     *
+     * @param data - Parsed JSON object from Claude Code
+     * @param type - Detected message type
+     * @returns Structured OutputMessage
+     */
+    private _parseMessage;
+    /**
+     * Extract text content from Claude Code message data
+     *
+     * Claude can return content as a string or an array of content blocks.
+     * This method handles both formats.
+     */
+    private _extractTextContent;
+    /**
+     * Extract tool use information from Claude Code message data
+     *
+     * Claude includes tool_use blocks in the message.content array.
+     */
+    private _extractToolUse;
+    /**
+     * Extract tool result information from Claude Code message data
+     *
+     * Claude includes tool_result blocks with execution results.
+     */
+    private _extractToolResult;
+    /**
+     * Extract usage information from Claude Code result message
+     *
+     * Claude provides token usage in result messages with detailed breakdowns.
+     */
+    private _extractUsage;
+    /**
+     * Emit progress event to all registered handlers
+     */
+    private _emitProgress;
+    /**
+     * Emit error event to all registered handlers
+     */
+    private _emitError;
+}
+//# sourceMappingURL=claude-code-output-processor.d.ts.map

package/node_modules/@sudocode-ai/local-server/dist/execution/output/claude-code-output-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-output-processor.d.ts","sourceRoot":"","sources":["../../../src/execution/output/claude-code-output-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,QAAQ,EACR,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,YAAY,EAIb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,yBAA0B,YAAW,gBAAgB;IAEhE,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,YAAY,CAAe;IAGnC,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,mBAAmB,CAA2B;IACtD,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,cAAc,CAAsB;IAG5C,OAAO,CAAC,WAAW,CAAK;;IA0BxB;;;;;;;OAOG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkE9C;;;;OAIG;IACH,UAAU,IAAI,iBAAiB;IAU/B;;;;OAIG;IACH,YAAY,IAAI,QAAQ,EAAE;IAI1B;;;;OAIG;IACH,cAAc,IAAI,UAAU,EAAE;IAI9B;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI9C;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1C;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,YAAY,EAAE,cAAc,GAAG,IAAI;IAI7D;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,OAAO,YAAY,EAAE,YAAY,GAAG,IAAI;IAQzD;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIhD;;;;;;;;;;;OAWG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IAIhD;;;;;;;;;;;OAWG;IACH,yBAAyB,CACvB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GACnC,UAAU,EAAE;IAMf;;;;;;;;;;;;OAYG;IACH,kBAAkB,IAAI,QAAQ,EAAE;IAIhC;;;;;;;;;;OAUG;IACH,sBAAsB,IAAI,QAAQ,EAAE;IAIpC;;;;;;;;;;OAUG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,mBAAmB,IAAI,OAAO,YAAY,EAAE,gBAAgB;IAsD5D;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IAoCzB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAanB;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IA2BpB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAmBpB;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAoC1B;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAsErB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAgBvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,UAAU;CAcnB"}