@loom-framework/core 0.1.0-alpha.5 → 0.1.0-alpha.51

package/dist/backend/ai/button-resolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Button Resolver - Resolve AI button prompts from configuration
+ *
+ * Replaces {{var}} placeholders in prompt with context values.
+ * Context variables not referenced in the template are appended to the prompt.
+ */
+import type { LoomConfig } from '../../index.js';
+/**
+ * Resolve prompt from AI button configuration.
+ * - Replaces {{var}} in prompt with context values
+ * - Appends unreferenced context fields to the end
+ * Returns null if button not found.
+ */
+export declare function resolveButtonPrompt(buttonId: string, context: Record<string, string> | undefined, config: LoomConfig): {
+    prompt: string;
+    error?: string;
+} | null;
+//# sourceMappingURL=button-resolver.d.ts.map

package/dist/backend/ai/button-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/ai/button-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAmBjD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,MAAM,EAAE,UAAU,GACjB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoC3C"}

package/dist/backend/ai/button-resolver.js

@@ -0,0 +1,58 @@
+/**
+ * Button Resolver - Resolve AI button prompts from configuration
+ *
+ * Replaces {{var}} placeholders in prompt with context values.
+ * Context variables not referenced in the template are appended to the prompt.
+ */
+const TEMPLATE_VAR = /\{\{(\w+)\}\}/g;
+/**
+ * Extract variable names from a prompt template string.
+ */
+function extractVarNames(prompt) {
+    const names = [];
+    let match;
+    const re = new RegExp(TEMPLATE_VAR.source, 'g');
+    while ((match = re.exec(prompt)) !== null) {
+        if (!names.includes(match[1])) {
+            names.push(match[1]);
+        }
+    }
+    return names;
+}
+/**
+ * Resolve prompt from AI button configuration.
+ * - Replaces {{var}} in prompt with context values
+ * - Appends unreferenced context fields to the end
+ * Returns null if button not found.
+ */
+export function resolveButtonPrompt(buttonId, context, config) {
+    const button = config.aiButtons?.find((b) => b.id === buttonId);
+    if (!button) {
+        return null;
+    }
+    const varNames = extractVarNames(button.prompt);
+    // Check that all referenced variables have values in context
+    if (varNames.length > 0) {
+        const missing = varNames.filter((v) => !context || context[v] === undefined);
+        if (missing.length > 0) {
+            return {
+                prompt: '',
+                error: `Missing context variables: ${missing.join(', ')}. Required: ${varNames.join(', ')}`,
+            };
+        }
+    }
+    // Replace {{var}} with context values
+    let resolved = button.prompt;
+    if (context) {
+        resolved = resolved.replace(TEMPLATE_VAR, (match, key) => {
+            return context[key] !== undefined ? String(context[key]) : match;
+        });
+        // Append unreferenced context fields
+        const unreferenced = Object.entries(context).filter(([key]) => !varNames.includes(key));
+        if (unreferenced.length > 0) {
+            resolved += '\n\n' + unreferenced.map(([key, value]) => `${key}: ${value}`).join('\n');
+        }
+    }
+    return { prompt: resolved };
+}
+//# sourceMappingURL=button-resolver.js.map

package/dist/backend/ai/button-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-resolver.js","sourceRoot":"","sources":["../../../src/backend/ai/button-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAEtC;;GAEG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,KAA6B,CAAC;IAClC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,OAA2C,EAC3C,MAAkB;IAElB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEhD,6DAA6D;IAC7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAC7E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,8BAA8B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC5F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;YAC/D,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CACjD,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CACnC,CAAC;QACF,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,IAAI,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/backend/ai/engine.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AI Engine - Core abstraction for AI communication
+ *
+ * ClaudeCodeEngine: spawns `claude -p --output-format json` processes
+ * with support for --resume, --model, and MCP config.
+ */
+import type { AIEngine, AICallOptions, AIChunk, ClaudeCodeConfig } from '../../index.js';
+/** Log levels for engine diagnostics */
+export type EngineLogLevel = 'COMMAND' | 'PROMPT' | 'STDOUT_CHUNK' | 'RESPONSE_PARSED' | 'STDERR' | 'PROCESS_EXIT';
+export interface EngineLogEntry {
+    level: EngineLogLevel;
+    sessionId: string;
+    timestamp: string;
+    message: string;
+    data?: unknown;
+}
+export type EngineLogger = (entry: EngineLogEntry) => void;
+export interface ClaudeCodeEngineOptions {
+    config: ClaudeCodeConfig;
+    projectRoot: string;
+    /** Optional diagnostic logger for engine operations */
+    logger?: EngineLogger;
+}
+/**
+ * ClaudeCodeEngine - Spawns Claude Code in headless mode
+ *
+ * Uses `claude -p --output-format json --mcp-config .loom/mcp.json`
+ * to invoke AI capabilities. Supports session resume and model selection.
+ */
+export declare class ClaudeCodeEngine implements AIEngine {
+    readonly name = "claude-code";
+    private config;
+    private projectRoot;
+    private activeProcesses;
+    private logger?;
+    constructor(options: ClaudeCodeEngineOptions);
+    private log;
+    /**
+     * Call Claude Code with a prompt and stream back AIChunk objects
+     */
+    call(prompt: string, options: AICallOptions): AsyncGenerator<AIChunk>;
+    /**
+     * Kill an active process by session ID
+     */
+    killSession(sessionId: string): boolean;
+    /**
+     * Kill all active processes (for graceful shutdown)
+     */
+    killAll(): void;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/backend/ai/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/backend/ai/engine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMzF,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,GAAG,iBAAiB,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEnH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,gBAAgB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,MAAM,CAAC,CAAe;gBAElB,OAAO,EAAE,uBAAuB;IAM5C,OAAO,CAAC,GAAG;IAUX;;OAEG;IACI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC;IAkI5E;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAUvC;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/dist/backend/ai/engine.js

@@ -0,0 +1,188 @@
+/**
+ * AI Engine - Core abstraction for AI communication
+ *
+ * ClaudeCodeEngine: spawns `claude -p --output-format json` processes
+ * with support for --resume, --model, and MCP config.
+ */
+import { spawn } from 'child_process';
+import path from 'path';
+import { parseClaudeOutput } from './output-parser.js';
+/** Default timeout for Claude Code processes (2 minutes) */
+const DEFAULT_PROCESS_TIMEOUT_MS = 120_000;
+/**
+ * ClaudeCodeEngine - Spawns Claude Code in headless mode
+ *
+ * Uses `claude -p --output-format json --mcp-config .loom/mcp.json`
+ * to invoke AI capabilities. Supports session resume and model selection.
+ */
+export class ClaudeCodeEngine {
+    name = 'claude-code';
+    config;
+    projectRoot;
+    activeProcesses = new Map();
+    logger;
+    constructor(options) {
+        this.config = options.config;
+        this.projectRoot = options.projectRoot;
+        this.logger = options.logger;
+    }
+    log(level, sessionId, message, data) {
+        this.logger?.({
+            level,
+            sessionId,
+            timestamp: new Date().toISOString(),
+            message,
+            data,
+        });
+    }
+    /**
+     * Call Claude Code with a prompt and stream back AIChunk objects
+     */
+    async *call(prompt, options) {
+        const claudePath = this.config.path || process.env.CLAUDE_CODE_PATH || 'claude';
+        const timeout = options.timeout ?? this.config.timeout ?? DEFAULT_PROCESS_TIMEOUT_MS;
+        const pluginRoot = this.config.pluginRoot || path.join(this.projectRoot, '.claude');
+        const mcpConfigPath = path.join(this.projectRoot, '.loom', 'mcp.json');
+        // Build prompt with file references if provided
+        const fullPrompt = buildPromptWithFiles(prompt, options.files);
+        const args = [
+            '-p',
+            '--output-format', 'stream-json',
+            '--verbose',
+            '--include-partial-messages',
+            '--mcp-config', mcpConfigPath,
+            '--strict-mcp-config',
+        ];
+        if (this.config.skipPermissions !== false) {
+            args.push('--dangerously-skip-permissions');
+        }
+        if (options.model || this.config.defaultModel) {
+            args.push('--model', options.model || this.config.defaultModel);
+        }
+        if (options.resumeSessionId) {
+            args.push('--resume', options.resumeSessionId);
+        }
+        // Read prompt from stdin to avoid ARG_MAX
+        args.push('-');
+        this.log('COMMAND', options.sessionId, `Spawning claude process`, { claudePath, args });
+        this.log('PROMPT', options.sessionId, `Prompt length: ${fullPrompt.length}`, {
+            promptPreview: fullPrompt.slice(0, 200),
+            filesCount: options.files?.length ?? 0,
+        });
+        const childProcess = spawn(claudePath, args, {
+            cwd: this.projectRoot,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                CLAUDE_PLUGIN_ROOT: pluginRoot,
+            },
+        });
+        // Track active process for cleanup
+        this.activeProcesses.set(options.sessionId, childProcess);
+        // Capture stderr for error reporting
+        let stderrOutput = '';
+        childProcess.stderr.on('data', (data) => {
+            const text = data.toString();
+            stderrOutput += text;
+            this.log('STDERR', options.sessionId, text.trim());
+        });
+        // Wait for process completion with timeout
+        let timeoutHandle;
+        const completionPromise = new Promise((resolve, reject) => {
+            timeoutHandle = setTimeout(() => {
+                childProcess.kill('SIGTERM');
+                setTimeout(() => childProcess.kill('SIGKILL'), 5_000);
+                reject(new Error(`Claude Code process timed out after ${timeout}ms`));
+            }, timeout);
+            childProcess.on('close', (code) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                this.activeProcesses.delete(options.sessionId);
+                if (code !== null && code !== 0) {
+                    this.log('PROCESS_EXIT', options.sessionId, `Process exited with code ${code}`, { exitCode: code, stderr: stderrOutput });
+                }
+                resolve();
+            });
+            childProcess.on('error', (err) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                this.activeProcesses.delete(options.sessionId);
+                reject(err);
+            });
+        });
+        // Send prompt via stdin then close
+        childProcess.stdin.write(fullPrompt);
+        childProcess.stdin.end();
+        // Parse output stream
+        try {
+            const parserLogger = this.logger
+                ? (entry) => {
+                    this.log('STDOUT_CHUNK', options.sessionId, entry.message, entry.data);
+                }
+                : undefined;
+            for await (const chunk of parseClaudeOutput(childProcess.stdout, parserLogger)) {
+                this.log('RESPONSE_PARSED', options.sessionId, `Chunk type: ${chunk.type}`, { chunkType: chunk.type });
+                // For result-type content chunks that carry sessionId, split into two chunks
+                if (chunk.type === 'content' && chunk.sessionId) {
+                    const { sessionId, usage, ...contentChunk } = chunk;
+                    yield contentChunk;
+                    if (sessionId) {
+                        yield {
+                            type: 'session_info',
+                            sessionId,
+                            usage,
+                        };
+                    }
+                }
+                else {
+                    yield chunk;
+                }
+            }
+        }
+        catch (error) {
+            yield {
+                type: 'error',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+        // Wait for process completion with timeout
+        await completionPromise;
+        yield { type: 'done' };
+    }
+    /**
+     * Kill an active process by session ID
+     */
+    killSession(sessionId) {
+        const proc = this.activeProcesses.get(sessionId);
+        if (proc && !proc.killed) {
+            proc.kill('SIGTERM');
+            this.activeProcesses.delete(sessionId);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Kill all active processes (for graceful shutdown)
+     */
+    killAll() {
+        for (const [sessionId, proc] of this.activeProcesses) {
+            if (!proc.killed) {
+                proc.kill('SIGTERM');
+            }
+            this.activeProcesses.delete(sessionId);
+        }
+    }
+}
+/**
+ * Build prompt with file references injected for Claude Code.
+ * Formats file paths as inline references so Claude Code can access them.
+ */
+function buildPromptWithFiles(prompt, files) {
+    if (!files || files.length === 0)
+        return prompt;
+    const fileList = files
+        .map((f) => `  - ${f.name}: ${f.path}`)
+        .join('\n');
+    return `${prompt}\n\nAttached files:\n${fileList}`;
+}
+//# sourceMappingURL=engine.js.map

package/dist/backend/ai/engine.js.map

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

package/dist/backend/ai/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * AI Module - Barrel Export
+ */
+export { ClaudeCodeEngine } from './engine.js';
+export type { ClaudeCodeEngineOptions, EngineLogger, EngineLogLevel, EngineLogEntry } from './engine.js';
+export { SessionManager } from './session-manager.js';
+export type { SessionRecord, SessionMessage, SessionFileRef } from './session-manager.js';
+export { parseClaudeOutput } from './output-parser.js';
+export type { ParserLogger, ParserLogEntry } from './output-parser.js';
+export { resolveButtonPrompt } from './button-resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/ai/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/backend/ai/index.js

@@ -0,0 +1,8 @@
+/**
+ * AI Module - Barrel Export
+ */
+export { ClaudeCodeEngine } from './engine.js';
+export { SessionManager } from './session-manager.js';
+export { parseClaudeOutput } from './output-parser.js';
+export { resolveButtonPrompt } from './button-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/ai/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/backend/ai/output-parser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Claude Code Output Parser
+ *
+ * Parses `claude -p --output-format stream-json --verbose --include-partial-messages` output stream.
+ * Supports real-time streaming with thinking, tool calls, and text deltas.
+ *
+ * Key insight: Tool input comes via input_json_delta events, need to accumulate them.
+ */
+import type { AIChunk } from '../../index.js';
+/** Parser log entry for diagnostics */
+export interface ParserLogEntry {
+    type: 'CHUNK_RECEIVED' | 'LINE_PARSED' | 'PARSE_ERROR';
+    timestamp: string;
+    message: string;
+    data?: unknown;
+}
+export type ParserLogger = (entry: ParserLogEntry) => void;
+/**
+ * Parse Claude Code stdout stream into typed AIChunk objects
+ *
+ * Strategy:
+ * 1. Process lines as they arrive (true streaming)
+ * 2. Strip ANSI escape codes
+ * 3. Parse each line as JSON
+ * 4. Map to appropriate AIChunk types
+ * 5. Accumulate tool input from input_json_delta events
+ */
+export declare function parseClaudeOutput(stdout: NodeJS.ReadableStream, logger?: ParserLogger): AsyncGenerator<AIChunk>;
+//# sourceMappingURL=output-parser.d.ts.map

package/dist/backend/ai/output-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-parser.d.ts","sourceRoot":"","sources":["../../../src/backend/ai/output-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAW,MAAM,gBAAgB,CAAC;AAEvD,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,gBAAgB,GAAG,aAAa,GAAG,aAAa,CAAC;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;AAkG3D;;;;;;;;;GASG;AACH,wBAAuB,iBAAiB,CACtC,MAAM,EAAE,MAAM,CAAC,cAAc,EAC7B,MAAM,CAAC,EAAE,YAAY,GACpB,cAAc,CAAC,OAAO,CAAC,CAiCzB"}

package/dist/backend/ai/output-parser.js

@@ -0,0 +1,247 @@
+/**
+ * Claude Code Output Parser
+ *
+ * Parses `claude -p --output-format stream-json --verbose --include-partial-messages` output stream.
+ * Supports real-time streaming with thinking, tool calls, and text deltas.
+ *
+ * Key insight: Tool input comes via input_json_delta events, need to accumulate them.
+ */
+/** ANSI escape code pattern */
+const ANSI_ESCAPE = /\x1b\[[0-9;]*m/g;
+/** Check if a parsed toolInput is empty (no meaningful content) */
+function isEmptyToolInput(input) {
+    if (input === undefined || input === null)
+        return true;
+    if (typeof input === 'object' && Object.keys(input).length === 0)
+        return true;
+    return false;
+}
+/**
+ * Parse Claude Code stdout stream into typed AIChunk objects
+ *
+ * Strategy:
+ * 1. Process lines as they arrive (true streaming)
+ * 2. Strip ANSI escape codes
+ * 3. Parse each line as JSON
+ * 4. Map to appropriate AIChunk types
+ * 5. Accumulate tool input from input_json_delta events
+ */
+export async function* parseClaudeOutput(stdout, logger) {
+    let buffer = '';
+    const state = {
+        toolInputBuffers: new Map(),
+        activeToolId: null,
+        activeToolName: null,
+        emittedToolIds: new Set(),
+    };
+    for await (const chunk of stdout) {
+        buffer += chunk.toString();
+        // Process complete lines
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const chunks = parseLine(trimmed, logger, state);
+            for (const c of chunks) {
+                yield c;
+            }
+        }
+    }
+    // Process any remaining buffer
+    if (buffer.trim()) {
+        const cleanOutput = buffer.replace(ANSI_ESCAPE, '').trim();
+        const chunks = parseLine(cleanOutput, logger, state);
+        for (const c of chunks)
+            yield c;
+    }
+}
+function parseLine(line, logger, state) {
+    try {
+        const data = JSON.parse(line);
+        logger?.({ type: 'LINE_PARSED', timestamp: new Date().toISOString(), message: `Parsed ${data.type}` });
+        return mapToChunks(data, state);
+    }
+    catch {
+        logger?.({ type: 'PARSE_ERROR', timestamp: new Date().toISOString(), message: 'Failed to parse line', data: line.slice(0, 200) });
+        return [];
+    }
+}
+function mapToChunks(data, state) {
+    switch (data.type) {
+        case 'system':
+            if (data.subtype === 'init' && data.session_id) {
+                return [{ type: 'session_info', sessionId: data.session_id }];
+            }
+            return [];
+        case 'stream_event':
+            return handleStreamEvent(data, state);
+        case 'assistant':
+            // Process assistant message - it contains complete tool_use with full input
+            return handleAssistantMessage(data, state);
+        case 'user':
+            return handleUserMessage(data);
+        case 'result':
+            return handleResult(data);
+        default:
+            return [];
+    }
+}
+function handleStreamEvent(wrapper, state) {
+    const { event } = wrapper;
+    switch (event.type) {
+        case 'content_block_delta':
+            // Handle thinking and text deltas
+            if (event.delta?.type === 'thinking_delta' && event.delta.thinking) {
+                return [{ type: 'thinking', content: event.delta.thinking }];
+            }
+            if (event.delta?.type === 'text_delta' && event.delta.text) {
+                return [{ type: 'content', content: event.delta.text }];
+            }
+            // Handle tool input JSON delta - accumulate it
+            if (event.delta?.type === 'input_json_delta' && event.delta.partial_json) {
+                if (state.activeToolId) {
+                    const current = state.toolInputBuffers.get(state.activeToolId) || '';
+                    state.toolInputBuffers.set(state.activeToolId, current + event.delta.partial_json);
+                }
+                return []; // Don't emit until tool call is complete
+            }
+            return [];
+        case 'content_block_start':
+            if (event.content_block?.type === 'tool_use') {
+                const toolUseId = event.content_block.id || '';
+                const toolName = event.content_block.name || 'unknown';
+                // Set active tool for accumulation
+                state.activeToolId = toolUseId;
+                state.activeToolName = toolName;
+                // Initialize buffer if there's already input
+                if (event.content_block.input !== undefined) {
+                    state.toolInputBuffers.set(toolUseId, JSON.stringify(event.content_block.input));
+                }
+                else {
+                    state.toolInputBuffers.set(toolUseId, '');
+                }
+                // Don't emit tool_call yet - wait for content_block_stop with complete input
+                return [];
+            }
+            return [];
+        case 'content_block_stop':
+            // When content block stops, emit the complete tool input if we have one
+            if (state.activeToolId && event.index !== undefined) {
+                const accumulatedInput = state.toolInputBuffers.get(state.activeToolId);
+                if (accumulatedInput && state.activeToolName) {
+                    try {
+                        const parsedInput = JSON.parse(accumulatedInput);
+                        // Skip empty tool inputs (abandoned tool calls from Claude)
+                        if (isEmptyToolInput(parsedInput)) {
+                            state.activeToolId = null;
+                            state.activeToolName = null;
+                            return [];
+                        }
+                        const chunks = [{
+                                type: 'tool_call',
+                                toolUseId: state.activeToolId,
+                                toolName: state.activeToolName,
+                                toolInput: parsedInput,
+                            }];
+                        state.emittedToolIds.add(state.activeToolId);
+                        state.activeToolId = null;
+                        state.activeToolName = null;
+                        return chunks;
+                    }
+                    catch {
+                        // JSON not complete yet, keep state
+                    }
+                }
+                state.activeToolId = null;
+                state.activeToolName = null;
+            }
+            return [];
+        default:
+            return [];
+    }
+}
+function handleAssistantMessage(data, state) {
+    const chunks = [];
+    for (const block of data.message.content || []) {
+        if (block.type === 'thinking' && block.thinking) {
+            // Skip - already sent via thinking_delta
+        }
+        if (block.type === 'text' && block.text) {
+            // Skip - already sent via text_delta
+        }
+        if (block.type === 'tool_use') {
+            // Skip already-emitted tool calls (from content_block_stop)
+            const toolUseId = block.id || '';
+            if (state.emittedToolIds.has(toolUseId))
+                continue;
+            // Use the accumulated input if we have it, otherwise use the block's input
+            const accumulatedInput = state.toolInputBuffers.get(toolUseId);
+            let toolInput;
+            if (accumulatedInput) {
+                try {
+                    toolInput = JSON.parse(accumulatedInput);
+                }
+                catch {
+                    toolInput = block.input;
+                }
+            }
+            else {
+                toolInput = block.input;
+            }
+            // Skip empty tool inputs (abandoned tool calls from Claude)
+            if (isEmptyToolInput(toolInput))
+                continue;
+            chunks.push({
+                type: 'tool_call',
+                toolUseId,
+                toolName: block.name || 'unknown',
+                toolInput,
+            });
+        }
+    }
+    return chunks;
+}
+function handleUserMessage(data) {
+    const chunks = [];
+    for (const block of data.message.content) {
+        if (block.type === 'tool_result') {
+            chunks.push({
+                type: 'tool_result',
+                toolUseId: block.tool_use_id,
+                toolResult: block.content,
+            });
+        }
+    }
+    return chunks;
+}
+function handleResult(data) {
+    const chunks = [];
+    if (data.session_id) {
+        chunks.push({
+            type: 'session_info',
+            sessionId: data.session_id,
+            usage: extractStreamUsage(data.usage),
+        });
+    }
+    if (data.is_error) {
+        chunks.push({ type: 'error', error: data.result || 'Unknown error' });
+    }
+    chunks.push({ type: 'done' });
+    return chunks;
+}
+function extractStreamUsage(usage) {
+    if (!usage)
+        return undefined;
+    const firstKey = Object.keys(usage)[0];
+    const modelUsage = firstKey ? usage[firstKey] : undefined;
+    if (!modelUsage)
+        return undefined;
+    return {
+        inputTokens: modelUsage.inputTokens,
+        outputTokens: modelUsage.outputTokens,
+        contextWindow: 0,
+    };
+}
+//# sourceMappingURL=output-parser.js.map