@rcrsr/rill-ext-claude-code 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andre Bremer
+
+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/dist/factory.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Extension factory for Claude Code integration.
+ * Creates extension instance with config validation and process lifecycle management.
+ */
+import { type ExtensionResult } from '@rcrsr/rill';
+import type { ClaudeCodeConfig } from './types.js';
+/**
+ * Create Claude Code extension instance.
+ * Validates configuration and returns host functions with cleanup.
+ *
+ * @param config - Extension configuration
+ * @returns ExtensionResult with prompt, skill, command functions and dispose
+ * @throws Error for invalid configuration (EC-1, EC-2)
+ *
+ * @example
+ * ```typescript
+ * const ext = createClaudeCodeExtension({
+ *   binaryPath: '/usr/local/bin/claude',
+ *   defaultTimeout: 60000
+ * });
+ * // Use with rill runtime...
+ * await ext.dispose();
+ * ```
+ */
+export declare function createClaudeCodeExtension(config?: ClaudeCodeConfig): ExtensionResult;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAGL,KAAK,eAAe,EAGrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAwGlE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,gBAAqB,GAC5B,eAAe,CAmTjB"}

package/dist/factory.js

@@ -0,0 +1,368 @@
+/**
+ * Extension factory for Claude Code integration.
+ * Creates extension instance with config validation and process lifecycle management.
+ */
+import which from 'which';
+import { RuntimeError, emitExtensionEvent, } from '@rcrsr/rill';
+import { spawnClaudeCli } from './process.js';
+import { createStreamParser } from './stream-parser.js';
+import { extractResult } from './result.js';
+// ============================================================
+// CONSTANTS
+// ============================================================
+const DEFAULT_BINARY_PATH = 'claude';
+const DEFAULT_TIMEOUT = 30000;
+const MAX_TIMEOUT = 300000;
+// ============================================================
+// HELPER FUNCTIONS
+// ============================================================
+/**
+ * Serialize dict args to CLI flags for skill/command.
+ * Boolean true values become flags without value, nested dicts use dot-notation.
+ *
+ * @param args - Dict of arguments to serialize
+ * @returns Array of CLI flag strings
+ */
+function serializeArgsToFlags(args) {
+    const flags = [];
+    for (const [key, value] of Object.entries(args)) {
+        if (value === true) {
+            // Boolean true: flag without value
+            flags.push(`--${key}`);
+        }
+        else if (typeof value === 'object' &&
+            value !== null &&
+            !Array.isArray(value)) {
+            // Nested dict: dot-notation
+            const nested = value;
+            for (const [nestedKey, nestedValue] of Object.entries(nested)) {
+                flags.push(`--${key}.${nestedKey}`, String(nestedValue));
+            }
+        }
+        else {
+            // Other values: key-value pair
+            flags.push(`--${key}`, String(value));
+        }
+    }
+    return flags;
+}
+/**
+ * Truncate text to max length for event logging.
+ *
+ * @param text - Text to truncate
+ * @param maxLength - Maximum length (default: 100)
+ * @returns Truncated text with ellipsis if needed
+ */
+function truncateText(text, maxLength = 100) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.slice(0, maxLength) + '...';
+}
+// ============================================================
+// VALIDATION
+// ============================================================
+/**
+ * Validate timeout is positive integer within bounds.
+ *
+ * @param timeout - Timeout in milliseconds
+ * @throws Error if timeout invalid
+ */
+function validateTimeout(timeout) {
+    if (!Number.isInteger(timeout)) {
+        throw new Error('Invalid timeout: must be positive integer, max 300000');
+    }
+    if (timeout <= 0) {
+        throw new Error('Invalid timeout: must be positive integer, max 300000');
+    }
+    if (timeout > MAX_TIMEOUT) {
+        throw new Error('Invalid timeout: must be positive integer, max 300000');
+    }
+}
+// ============================================================
+// FACTORY
+// ============================================================
+/**
+ * Create Claude Code extension instance.
+ * Validates configuration and returns host functions with cleanup.
+ *
+ * @param config - Extension configuration
+ * @returns ExtensionResult with prompt, skill, command functions and dispose
+ * @throws Error for invalid configuration (EC-1, EC-2)
+ *
+ * @example
+ * ```typescript
+ * const ext = createClaudeCodeExtension({
+ *   binaryPath: '/usr/local/bin/claude',
+ *   defaultTimeout: 60000
+ * });
+ * // Use with rill runtime...
+ * await ext.dispose();
+ * ```
+ */
+export function createClaudeCodeExtension(config = {}) {
+    // Extract config with defaults
+    const binaryPath = config.binaryPath ?? DEFAULT_BINARY_PATH;
+    const defaultTimeout = config.defaultTimeout ?? DEFAULT_TIMEOUT;
+    // Validate timeout immediately
+    validateTimeout(defaultTimeout);
+    // Validate binary path eagerly (sync throw if not in PATH)
+    try {
+        which.sync(binaryPath);
+    }
+    catch {
+        throw new Error(`Binary not found: ${binaryPath}`);
+    }
+    // Track active processes for cleanup
+    const tracker = {
+        disposers: new Set(),
+    };
+    // Dispose function for cleanup
+    const dispose = () => {
+        // EC-16: Cleanup failure logs warning, doesn't throw
+        for (const disposer of tracker.disposers) {
+            try {
+                disposer();
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                console.warn(`Failed to cleanup process: ${message}`);
+            }
+        }
+        tracker.disposers.clear();
+    };
+    // Return extension result with implementations
+    const result = {
+        // IR-2: claude-code::prompt
+        prompt: {
+            params: [
+                { name: 'text', type: 'string' },
+                { name: 'options', type: 'dict', defaultValue: {} },
+            ],
+            fn: async (args, ctx) => {
+                const startTime = Date.now();
+                try {
+                    // Extract arguments
+                    const text = args[0];
+                    const options = (args[1] ?? {});
+                    // EC-3: Validate text is non-empty
+                    if (text.trim().length === 0) {
+                        throw new RuntimeError('RILL-R004', 'prompt text cannot be empty');
+                    }
+                    // Extract timeout option
+                    const timeout = typeof options['timeout'] === 'number'
+                        ? options['timeout']
+                        : defaultTimeout;
+                    // Spawn process and collect messages
+                    const spawn = spawnClaudeCli(text, {
+                        binaryPath,
+                        timeoutMs: timeout,
+                    });
+                    // Register cleanup
+                    tracker.disposers.add(spawn.dispose);
+                    // Parse stream output
+                    const parser = createStreamParser();
+                    const messages = [];
+                    spawn.ptyProcess.onData((chunk) => {
+                        parser.processChunk(chunk, (msg) => messages.push(msg));
+                    });
+                    // Wait for process completion
+                    try {
+                        await spawn.exitCode;
+                        parser.flush((msg) => messages.push(msg));
+                    }
+                    finally {
+                        tracker.disposers.delete(spawn.dispose);
+                        spawn.dispose();
+                    }
+                    // Extract result
+                    const result = extractResult(messages);
+                    // AC-17: Emit claude-code:prompt event
+                    const duration = Date.now() - startTime;
+                    emitExtensionEvent(ctx, {
+                        event: 'claude-code:prompt',
+                        subsystem: 'extension:claude-code',
+                        prompt: truncateText(text),
+                        duration,
+                    });
+                    // Convert to plain object literal for RillValue compatibility
+                    return {
+                        ...result,
+                        tokens: { ...result.tokens },
+                    };
+                }
+                catch (error) {
+                    // AC-20: Emit claude-code:error event
+                    const duration = Date.now() - startTime;
+                    emitExtensionEvent(ctx, {
+                        event: 'claude-code:error',
+                        subsystem: 'extension:claude-code',
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        duration,
+                    });
+                    throw error;
+                }
+            },
+            description: 'Execute Claude Code prompt and return result text and token usage',
+            returnType: 'dict',
+        },
+        // IR-3: claude-code::skill
+        skill: {
+            params: [
+                { name: 'name', type: 'string' },
+                { name: 'args', type: 'dict', defaultValue: {} },
+            ],
+            fn: async (fnArgs, ctx) => {
+                const startTime = Date.now();
+                try {
+                    // Extract arguments
+                    const name = fnArgs[0];
+                    const args = (fnArgs[1] ?? {});
+                    // EC-10: Validate name is non-empty
+                    if (name.trim().length === 0) {
+                        throw new RuntimeError('RILL-R004', 'skill name cannot be empty');
+                    }
+                    // Format input as /{name} {serialized args}
+                    const flags = serializeArgsToFlags(args);
+                    const flagsText = flags.length > 0 ? ' ' + flags.join(' ') : '';
+                    const prompt = `/${name}${flagsText}`;
+                    // Extract timeout option
+                    const timeout = typeof args['timeout'] === 'number'
+                        ? args['timeout']
+                        : defaultTimeout;
+                    // Spawn process
+                    const spawn = spawnClaudeCli(prompt, {
+                        binaryPath,
+                        timeoutMs: timeout,
+                    });
+                    tracker.disposers.add(spawn.dispose);
+                    // Parse stream output
+                    const parser = createStreamParser();
+                    const messages = [];
+                    spawn.ptyProcess.onData((chunk) => {
+                        parser.processChunk(chunk, (msg) => messages.push(msg));
+                    });
+                    // Wait for process completion
+                    try {
+                        await spawn.exitCode;
+                        parser.flush((msg) => messages.push(msg));
+                    }
+                    finally {
+                        tracker.disposers.delete(spawn.dispose);
+                        spawn.dispose();
+                    }
+                    // Extract result
+                    const result = extractResult(messages);
+                    // AC-18: Emit claude-code:skill event
+                    const duration = Date.now() - startTime;
+                    emitExtensionEvent(ctx, {
+                        event: 'claude-code:skill',
+                        subsystem: 'extension:claude-code',
+                        name,
+                        args,
+                        duration,
+                    });
+                    // Convert to plain object literal for RillValue compatibility
+                    return {
+                        ...result,
+                        tokens: { ...result.tokens },
+                    };
+                }
+                catch (error) {
+                    // AC-20: Emit claude-code:error event
+                    const duration = Date.now() - startTime;
+                    emitExtensionEvent(ctx, {
+                        event: 'claude-code:error',
+                        subsystem: 'extension:claude-code',
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        duration,
+                    });
+                    throw error;
+                }
+            },
+            description: 'Execute Claude Code skill with instruction and return structured result',
+            returnType: 'dict',
+        },
+        // IR-4: claude-code::command
+        command: {
+            params: [
+                { name: 'name', type: 'string' },
+                { name: 'args', type: 'dict', defaultValue: {} },
+            ],
+            fn: async (fnArgs, ctx) => {
+                const startTime = Date.now();
+                try {
+                    // Extract arguments
+                    const name = fnArgs[0];
+                    const args = (fnArgs[1] ?? {});
+                    // EC-13: Validate name is non-empty
+                    if (name.trim().length === 0) {
+                        throw new RuntimeError('RILL-R004', 'command name cannot be empty');
+                    }
+                    // Format input similar to skill
+                    const flags = serializeArgsToFlags(args);
+                    const flagsText = flags.length > 0 ? ' ' + flags.join(' ') : '';
+                    const prompt = `/${name}${flagsText}`;
+                    // Extract timeout option
+                    const timeout = typeof args['timeout'] === 'number'
+                        ? args['timeout']
+                        : defaultTimeout;
+                    // Spawn process
+                    const spawn = spawnClaudeCli(prompt, {
+                        binaryPath,
+                        timeoutMs: timeout,
+                    });
+                    tracker.disposers.add(spawn.dispose);
+                    // Parse stream output
+                    const parser = createStreamParser();
+                    const messages = [];
+                    spawn.ptyProcess.onData((chunk) => {
+                        parser.processChunk(chunk, (msg) => messages.push(msg));
+                    });
+                    // Wait for process completion
+                    try {
+                        await spawn.exitCode;
+                        parser.flush((msg) => messages.push(msg));
+                    }
+                    finally {
+                        tracker.disposers.delete(spawn.dispose);
+                        spawn.dispose();
+                    }
+                    // Extract result
+                    const result = extractResult(messages);
+                    // AC-19: Emit claude-code:command event
+                    const duration = Date.now() - startTime;
+                    emitExtensionEvent(ctx, {
+                        event: 'claude-code:command',
+                        subsystem: 'extension:claude-code',
+                        name,
+                        args,
+                        duration,
+                    });
+                    // Convert to plain object literal for RillValue compatibility
+                    return {
+                        ...result,
+                        tokens: { ...result.tokens },
+                    };
+                }
+                catch (error) {
+                    // AC-20: Emit claude-code:error event
+                    const duration = Date.now() - startTime;
+                    emitExtensionEvent(ctx, {
+                        event: 'claude-code:error',
+                        subsystem: 'extension:claude-code',
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                        duration,
+                    });
+                    throw error;
+                }
+            },
+            description: 'Execute Claude Code command with task description and return execution summary',
+            returnType: 'dict',
+        },
+    };
+    // IR-5: Dispose function for process cleanup
+    result.dispose = dispose;
+    return result;
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,kBAAkB,GAInB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAc5C,+DAA+D;AAC/D,YAAY;AACZ,+DAA+D;AAE/D,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AACrC,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,IAA6B;IACzD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,mCAAmC;YACnC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACzB,CAAC;aAAM,IACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACrB,CAAC;YACD,4BAA4B;YAC5B,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,SAAS,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;aAAM,CAAC;YACN,+BAA+B;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,SAAS,GAAG,GAAG;IACjD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;AAC1C,CAAC;AAED,+DAA+D;AAC/D,aAAa;AACb,+DAA+D;AAE/D;;;;;GAKG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,yBAAyB,CACvC,SAA2B,EAAE;IAE7B,+BAA+B;IAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC5D,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,eAAe,CAAC;IAEhE,+BAA+B;IAC/B,eAAe,CAAC,cAAc,CAAC,CAAC;IAEhC,2DAA2D;IAC3D,IAAI,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAmB;QAC9B,SAAS,EAAE,IAAI,GAAG,EAAE;KACrB,CAAC;IAEF,+BAA+B;IAC/B,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,qDAAqD;QACrD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,+CAA+C;IAC/C,MAAM,MAAM,GAAoB;QAC9B,4BAA4B;QAC5B,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;aACpD;YACD,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAsB,EAAE;gBAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE7B,IAAI,CAAC;oBACH,oBAAoB;oBACpB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;oBAC/B,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;oBAE3D,mCAAmC;oBACnC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC7B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;oBACrE,CAAC;oBAED,yBAAyB;oBACzB,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,QAAQ;wBACpC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;wBACpB,CAAC,CAAC,cAAc,CAAC;oBAErB,qCAAqC;oBACrC,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE;wBACjC,UAAU;wBACV,SAAS,EAAE,OAAO;qBACnB,CAAC,CAAC;oBAEH,mBAAmB;oBACnB,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAErC,sBAAsB;oBACtB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;oBACpC,MAAM,QAAQ,GAAoB,EAAE,CAAC;oBAErC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;wBAChC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC1D,CAAC,CAAC,CAAC;oBAEH,8BAA8B;oBAC9B,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,QAAQ,CAAC;wBACrB,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC5C,CAAC;4BAAS,CAAC;wBACT,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACxC,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,CAAC;oBAED,iBAAiB;oBACjB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAEvC,uCAAuC;oBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,kBAAkB,CAAC,GAAqB,EAAE;wBACxC,KAAK,EAAE,oBAAoB;wBAC3B,SAAS,EAAE,uBAAuB;wBAClC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC;wBAC1B,QAAQ;qBACT,CAAC,CAAC;oBAEH,8DAA8D;oBAC9D,OAAO;wBACL,GAAG,MAAM;wBACT,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAkC;qBAChD,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,sCAAsC;oBACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,kBAAkB,CAAC,GAAqB,EAAE;wBACxC,KAAK,EAAE,mBAAmB;wBAC1B,SAAS,EAAE,uBAAuB;wBAClC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;wBAC/D,QAAQ;qBACT,CAAC,CAAC;oBACH,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YACD,WAAW,EACT,mEAAmE;YACrE,UAAU,EAAE,MAAM;SACnB;QAED,2BAA2B;QAC3B,KAAK,EAAE;YACL,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;aACjD;YACD,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAsB,EAAE;gBAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE7B,IAAI,CAAC;oBACH,oBAAoB;oBACpB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;oBACjC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;oBAE1D,oCAAoC;oBACpC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC7B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;oBACpE,CAAC;oBAED,4CAA4C;oBAC5C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChE,MAAM,MAAM,GAAG,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;oBAEtC,yBAAyB;oBACzB,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ;wBACjC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;wBACjB,CAAC,CAAC,cAAc,CAAC;oBAErB,gBAAgB;oBAChB,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE;wBACnC,UAAU;wBACV,SAAS,EAAE,OAAO;qBACnB,CAAC,CAAC;oBAEH,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAErC,sBAAsB;oBACtB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;oBACpC,MAAM,QAAQ,GAAoB,EAAE,CAAC;oBAErC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;wBAChC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC1D,CAAC,CAAC,CAAC;oBAEH,8BAA8B;oBAC9B,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,QAAQ,CAAC;wBACrB,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC5C,CAAC;4BAAS,CAAC;wBACT,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACxC,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,CAAC;oBAED,iBAAiB;oBACjB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAEvC,sCAAsC;oBACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,kBAAkB,CAAC,GAAqB,EAAE;wBACxC,KAAK,EAAE,mBAAmB;wBAC1B,SAAS,EAAE,uBAAuB;wBAClC,IAAI;wBACJ,IAAI;wBACJ,QAAQ;qBACT,CAAC,CAAC;oBAEH,8DAA8D;oBAC9D,OAAO;wBACL,GAAG,MAAM;wBACT,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAkC;qBAChD,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,sCAAsC;oBACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,kBAAkB,CAAC,GAAqB,EAAE;wBACxC,KAAK,EAAE,mBAAmB;wBAC1B,SAAS,EAAE,uBAAuB;wBAClC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;wBAC/D,QAAQ;qBACT,CAAC,CAAC;oBACH,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YACD,WAAW,EACT,yEAAyE;YAC3E,UAAU,EAAE,MAAM;SACnB;QAED,6BAA6B;QAC7B,OAAO,EAAE;YACP,MAAM,EAAE;gBACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;aACjD;YACD,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAsB,EAAE;gBAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE7B,IAAI,CAAC;oBACH,oBAAoB;oBACpB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;oBACjC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;oBAE1D,oCAAoC;oBACpC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC7B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;oBACtE,CAAC;oBAED,gCAAgC;oBAChC,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;oBACzC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChE,MAAM,MAAM,GAAG,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC;oBAEtC,yBAAyB;oBACzB,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ;wBACjC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;wBACjB,CAAC,CAAC,cAAc,CAAC;oBAErB,gBAAgB;oBAChB,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE;wBACnC,UAAU;wBACV,SAAS,EAAE,OAAO;qBACnB,CAAC,CAAC;oBAEH,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBAErC,sBAAsB;oBACtB,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;oBACpC,MAAM,QAAQ,GAAoB,EAAE,CAAC;oBAErC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;wBAChC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC1D,CAAC,CAAC,CAAC;oBAEH,8BAA8B;oBAC9B,IAAI,CAAC;wBACH,MAAM,KAAK,CAAC,QAAQ,CAAC;wBACrB,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC5C,CAAC;4BAAS,CAAC;wBACT,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACxC,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,CAAC;oBAED,iBAAiB;oBACjB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;oBAEvC,wCAAwC;oBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,kBAAkB,CAAC,GAAqB,EAAE;wBACxC,KAAK,EAAE,qBAAqB;wBAC5B,SAAS,EAAE,uBAAuB;wBAClC,IAAI;wBACJ,IAAI;wBACJ,QAAQ;qBACT,CAAC,CAAC;oBAEH,8DAA8D;oBAC9D,OAAO;wBACL,GAAG,MAAM;wBACT,MAAM,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAkC;qBAChD,CAAC;gBACjB,CAAC;gBAAC,OAAO,KAAc,EAAE,CAAC;oBACxB,sCAAsC;oBACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBACxC,kBAAkB,CAAC,GAAqB,EAAE;wBACxC,KAAK,EAAE,mBAAmB;wBAC1B,SAAS,EAAE,uBAAuB;wBAClC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;wBAC/D,QAAQ;qBACT,CAAC,CAAC;oBACH,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YACD,WAAW,EACT,gFAAgF;YAClF,UAAU,EAAE,MAAM;SACnB;KACF,CAAC;IAEF,6CAA6C;IAC7C,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @rcrsr/rill-ext-claude-code
+ *
+ * Extension for executing Claude Code toolkit operations from rill scripts.
+ */
+export declare const VERSION = "0.1.0";
+export type { TokenCounts, TokenUsage, TextBlock, ToolUseBlock, ToolResultBlock, ContentBlock, SystemMessage, AssistantMessage, UserMessage, ResultMessage, ClaudeMessage, ClaudeCodeConfig, PromptOptions, ClaudeCodeResult, } from './types.js';
+export type { StreamParser } from './stream-parser.js';
+export { createStreamParser } from './stream-parser.js';
+export { extractResult } from './result.js';
+export type { SpawnResult, SpawnOptions } from './process.js';
+export { spawnClaudeCli } from './process.js';
+export { createClaudeCodeExtension } from './factory.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":"AAAA;;;;GAIG;AAMH,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B,YAAY,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAMpB,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAM5C,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAM9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @rcrsr/rill-ext-claude-code
+ *
+ * Extension for executing Claude Code toolkit operations from rill scripts.
+ */
+// ============================================================
+// VERSION
+// ============================================================
+export const VERSION = '0.1.0';
+export { createStreamParser } from './stream-parser.js';
+// ============================================================
+// RESULT EXTRACTION
+// ============================================================
+export { extractResult } from './result.js';
+export { spawnClaudeCli } from './process.js';
+// ============================================================
+// EXTENSION FACTORY
+// ============================================================
+export { createClaudeCodeExtension } from './factory.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;;;;GAIG;AAEH,+DAA+D;AAC/D,UAAU;AACV,+DAA+D;AAE/D,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AA4B/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/process.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Process manager for Claude CLI spawning and lifecycle.
+ * Handles PTY spawn, timeout enforcement, and cleanup.
+ */
+import * as pty from 'node-pty';
+/**
+ * Process spawn result.
+ * Includes PTY instance and cleanup function.
+ */
+export interface SpawnResult {
+    /** PTY process instance */
+    readonly ptyProcess: pty.IPty;
+    /** Exit code promise (resolves when process exits) */
+    readonly exitCode: Promise<number>;
+    /** Cleanup function (kills process if running) */
+    readonly dispose: () => void;
+}
+/**
+ * Options for spawning Claude CLI process.
+ */
+export interface SpawnOptions {
+    /** Path to Claude CLI binary (default: 'claude') */
+    readonly binaryPath?: string | undefined;
+    /** Timeout in milliseconds (kills process after duration) */
+    readonly timeoutMs?: number | undefined;
+    /** Working directory for process (default: inherit) */
+    readonly cwd?: string | undefined;
+    /** Environment variables (default: inherit) */
+    readonly env?: Record<string, string | undefined> | undefined;
+}
+/**
+ * Spawn Claude CLI process with timeout enforcement.
+ *
+ * @param prompt - User prompt to send to Claude
+ * @param options - Spawn options
+ * @returns Process handle with exit code and cleanup
+ * @throws RuntimeError RILL-R004 for spawn failures
+ */
+export declare function spawnClaudeCli(prompt: string, options?: SpawnOptions): SpawnResult;
+//# sourceMappingURL=process.d.ts.map

package/dist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAOhC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CAC/D;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GACzB,WAAW,CA8Kb"}

package/dist/process.js

@@ -0,0 +1,130 @@
+/**
+ * Process manager for Claude CLI spawning and lifecycle.
+ * Handles PTY spawn, timeout enforcement, and cleanup.
+ */
+import * as pty from 'node-pty';
+import { RuntimeError } from '@rcrsr/rill';
+// ============================================================
+// SPAWN FUNCTION
+// ============================================================
+/**
+ * Spawn Claude CLI process with timeout enforcement.
+ *
+ * @param prompt - User prompt to send to Claude
+ * @param options - Spawn options
+ * @returns Process handle with exit code and cleanup
+ * @throws RuntimeError RILL-R004 for spawn failures
+ */
+export function spawnClaudeCli(prompt, options = {}) {
+    const { binaryPath = 'claude', timeoutMs, cwd = process.cwd(), env = process.env, } = options;
+    // Track timeout and process state
+    let timeoutId;
+    let disposed = false;
+    // Create promise for exit code
+    let resolveExit;
+    let rejectExit;
+    const exitCode = new Promise((resolve, reject) => {
+        resolveExit = resolve;
+        rejectExit = reject;
+    });
+    // Spawn process
+    let ptyProcess;
+    try {
+        ptyProcess = pty.spawn(binaryPath, [
+            '--output-format',
+            'stream-json',
+            '--dangerously-skip-permissions',
+            '--verbose',
+        ], {
+            name: 'xterm-256color',
+            cols: 80,
+            rows: 30,
+            cwd,
+            env,
+        });
+    }
+    catch (error) {
+        // Handle spawn errors
+        if (error instanceof Error) {
+            const code = error.code;
+            // EC-4: Binary not found
+            if (code === 'ENOENT') {
+                throw new RuntimeError('RILL-R004', 'claude binary not found', undefined, { binaryPath });
+            }
+            // EC-5: Permission denied
+            if (code === 'EACCES') {
+                throw new RuntimeError('RILL-R004', 'Permission denied: claude', undefined, { binaryPath });
+            }
+            // EC-6: Generic spawn failure
+            throw new RuntimeError('RILL-R004', `Failed to spawn claude binary: ${error.message}`, undefined, { binaryPath, originalError: error.message });
+        }
+        // Unknown error type
+        throw new RuntimeError('RILL-R004', `Failed to spawn claude binary: Unknown error`, undefined, { binaryPath });
+    }
+    // Set up timeout enforcement
+    if (timeoutMs !== undefined && timeoutMs > 0) {
+        timeoutId = setTimeout(() => {
+            if (!disposed) {
+                disposed = true;
+                ptyProcess.kill();
+                rejectExit(new RuntimeError('RILL-R004', `Claude CLI timeout after ${timeoutMs}ms`, undefined, { timeoutMs }));
+            }
+        }, timeoutMs);
+    }
+    // Handle process exit
+    ptyProcess.onExit((event) => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        if (!disposed) {
+            disposed = true;
+            const { exitCode: code } = event;
+            // EC-9: Non-zero exit code
+            if (code !== 0) {
+                rejectExit(new RuntimeError('RILL-R004', `Claude CLI exited with code ${code}`, undefined, { exitCode: code }));
+            }
+            else {
+                resolveExit(code);
+            }
+        }
+    });
+    // Write prompt to stdin and close
+    try {
+        ptyProcess.write(prompt);
+        // Signal EOF by not writing more (PTY handles stdin closure differently)
+    }
+    catch (error) {
+        // If write fails, clean up and throw
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        ptyProcess.kill();
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        throw new RuntimeError('RILL-R004', `Failed to write prompt to claude process: ${message}`, undefined, { originalError: message });
+    }
+    // Cleanup function
+    const dispose = () => {
+        if (disposed) {
+            return;
+        }
+        disposed = true;
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        // EC-16: Cleanup failure warning
+        try {
+            ptyProcess.kill();
+        }
+        catch (error) {
+            // Log warning but don't throw
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            console.warn(`Failed to kill claude process during cleanup: ${message}`);
+        }
+    };
+    return {
+        ptyProcess,
+        exitCode,
+        dispose,
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

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

package/dist/result.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Result extraction from Claude Code message streams.
+ * Accumulates tokens, costs, and text from parsed messages.
+ */
+import type { ClaudeMessage, ClaudeCodeResult } from './types.js';
+/**
+ * Extracts complete ClaudeCodeResult from parsed message stream.
+ * Accumulates token counts across assistant messages and extracts cost/duration from final result message.
+ *
+ * @param messages - Parsed stream messages (ClaudeMessage[])
+ * @returns Complete result dict with text, tokens, cost, and exitCode
+ */
+export declare function extractResult(messages: readonly ClaudeMessage[]): ClaudeCodeResult;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAIjB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,aAAa,EAAE,GACjC,gBAAgB,CA8ClB"}

package/dist/result.js

@@ -0,0 +1,93 @@
+/**
+ * Result extraction from Claude Code message streams.
+ * Accumulates tokens, costs, and text from parsed messages.
+ */
+/**
+ * Extracts complete ClaudeCodeResult from parsed message stream.
+ * Accumulates token counts across assistant messages and extracts cost/duration from final result message.
+ *
+ * @param messages - Parsed stream messages (ClaudeMessage[])
+ * @returns Complete result dict with text, tokens, cost, and exitCode
+ */
+export function extractResult(messages) {
+    // Initialize accumulation state
+    const tokens = {
+        prompt: 0,
+        cacheWrite5m: 0,
+        cacheWrite1h: 0,
+        cacheRead: 0,
+        output: 0,
+    };
+    const textParts = [];
+    let cost = 0;
+    let duration = 0;
+    let exitCode = 0;
+    // Iterate messages and accumulate
+    for (const msg of messages) {
+        if (msg.type === 'assistant') {
+            // Accumulate token counts from usage field
+            if (msg.message.usage) {
+                accumulateTokens(tokens, msg.message.usage);
+            }
+            // Extract text content from content blocks
+            for (const block of msg.message.content) {
+                if (block.type === 'text') {
+                    textParts.push(block.text);
+                }
+            }
+        }
+        else if (msg.type === 'result') {
+            // Extract cost and duration from final result message
+            cost = msg.cost_usd;
+            duration = msg.duration_ms;
+            exitCode = msg.is_error ? 1 : 0;
+            // Include final usage from result message
+            accumulateTokens(tokens, msg.usage);
+        }
+    }
+    return {
+        result: textParts.join(''),
+        tokens,
+        cost,
+        exitCode,
+        duration,
+    };
+}
+/**
+ * Accumulates token counts from usage field into TokenCounts structure.
+ * Maps usage fields to TokenCounts fields:
+ * - input_tokens -> prompt
+ * - output_tokens -> output
+ * - cache_creation.ephemeral_5m_input_tokens -> cacheWrite5m
+ * - cache_creation.ephemeral_1h_input_tokens -> cacheWrite1h
+ * - cache_read_input_tokens -> cacheRead
+ *
+ * @param tokens - TokenCounts accumulator (mutated)
+ * @param usage - TokenUsage from assistant message or result message
+ */
+function accumulateTokens(tokens, usage) {
+    // Accumulate input tokens (non-cached prompt)
+    if (usage.input_tokens !== undefined) {
+        tokens.prompt += usage.input_tokens;
+    }
+    // Accumulate output tokens
+    if (usage.output_tokens !== undefined) {
+        tokens.output += usage.output_tokens;
+    }
+    // Accumulate cache write tokens (5-minute)
+    if (usage.cache_creation?.ephemeral_5m_input_tokens !== undefined) {
+        tokens.cacheWrite5m +=
+            usage.cache_creation.ephemeral_5m_input_tokens;
+    }
+    // Accumulate cache write tokens (1-hour)
+    if (usage.cache_creation?.ephemeral_1h_input_tokens !== undefined) {
+        tokens.cacheWrite1h +=
+            usage.cache_creation.ephemeral_1h_input_tokens;
+    }
+    // Accumulate cache read tokens
+    if (usage.cache_read_input_tokens !== undefined) {
+        tokens.cacheRead +=
+            usage.cache_read_input_tokens;
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkC;IAElC,gCAAgC;IAChC,MAAM,MAAM,GAAgB;QAC1B,MAAM,EAAE,CAAC;QACT,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,CAAC;QACf,SAAS,EAAE,CAAC;QACZ,MAAM,EAAE,CAAC;KACV,CAAC;IACF,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,kCAAkC;IAClC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,2CAA2C;YAC3C,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACtB,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC;YAED,2CAA2C;YAC3C,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC1B,SAAS,CAAC,IAAI,CAAE,KAAmB,CAAC,IAAI,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,sDAAsD;YACtD,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC;YACpB,QAAQ,GAAG,GAAG,CAAC,WAAW,CAAC;YAC3B,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAEhC,0CAA0C;YAC1C,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CAAC,MAAmB,EAAE,KAAiB;IAC9D,8CAA8C;IAC9C,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,MAA6B,CAAC,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC;IAC9D,CAAC;IAED,2BAA2B;IAC3B,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrC,MAA6B,CAAC,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC;IAC/D,CAAC;IAED,2CAA2C;IAC3C,IAAI,KAAK,CAAC,cAAc,EAAE,yBAAyB,KAAK,SAAS,EAAE,CAAC;QACjE,MAAmC,CAAC,YAAY;YAC/C,KAAK,CAAC,cAAc,CAAC,yBAAyB,CAAC;IACnD,CAAC;IAED,yCAAyC;IACzC,IAAI,KAAK,CAAC,cAAc,EAAE,yBAAyB,KAAK,SAAS,EAAE,CAAC;QACjE,MAAmC,CAAC,YAAY;YAC/C,KAAK,CAAC,cAAc,CAAC,yBAAyB,CAAC;IACnD,CAAC;IAED,+BAA+B;IAC/B,IAAI,KAAK,CAAC,uBAAuB,KAAK,SAAS,EAAE,CAAC;QAC/C,MAAgC,CAAC,SAAS;YACzC,KAAK,CAAC,uBAAuB,CAAC;IAClC,CAAC;AACH,CAAC"}

package/dist/stream-parser.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Stream parser for line-delimited JSON from Claude CLI.
+ * Handles chunked PTY output with ANSI escape sequences.
+ */
+import type { ClaudeMessage } from './types.js';
+/**
+ * Stream parser for line-delimited JSON.
+ * Buffers incomplete lines across chunks.
+ */
+export interface StreamParser {
+    /**
+     * Process a chunk of raw PTY output.
+     * Emits parsed messages via callback.
+     * Throws RuntimeError RILL-R004 for invalid JSON on complete lines.
+     *
+     * @param chunk - Raw data from PTY (Buffer or string)
+     * @param onMessage - Callback for each parsed message
+     * @throws RuntimeError with code RILL-R004 for invalid JSON
+     */
+    processChunk(chunk: Buffer | string, onMessage: (message: ClaudeMessage) => void): void;
+    /**
+     * Flush remaining buffered data.
+     * Call when stream ends to process incomplete lines.
+     *
+     * @param onMessage - Callback for final parsed messages
+     * @throws RuntimeError with code RILL-R004 for invalid JSON
+     */
+    flush(onMessage: (message: ClaudeMessage) => void): void;
+}
+/**
+ * Create a new stream parser instance.
+ *
+ * @returns Stream parser with buffering state
+ */
+export declare function createStreamParser(): StreamParser;
+//# sourceMappingURL=stream-parser.d.ts.map

package/dist/stream-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-parser.d.ts","sourceRoot":"","sources":["../src/stream-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAC1C,IAAI,CAAC;IAER;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;CAC1D;AAuCD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAyEjD"}

package/dist/stream-parser.js

@@ -0,0 +1,95 @@
+/**
+ * Stream parser for line-delimited JSON from Claude CLI.
+ * Handles chunked PTY output with ANSI escape sequences.
+ */
+import { RuntimeError } from '@rcrsr/rill';
+// ============================================================
+// ANSI ESCAPE SEQUENCE REMOVAL
+// ============================================================
+/**
+ * Regular expression matching ANSI escape sequences.
+ * Matches CSI sequences (ESC[...m) and other control codes.
+ * Uses String.fromCharCode to avoid ESLint no-control-regex errors.
+ */
+const ANSI_ESCAPE_PATTERN = new RegExp([
+    // CSI sequences: ESC [ ... letter
+    `${String.fromCharCode(0x1b)}\\[[0-9;]*[A-Za-z]`,
+    // OSC sequences: ESC ] ... BEL
+    `${String.fromCharCode(0x1b)}\\][^${String.fromCharCode(0x07)}]*${String.fromCharCode(0x07)}`,
+    // ESC = and ESC >
+    `${String.fromCharCode(0x1b)}[=>]`,
+    // Character set selection: ESC ( or ESC ) followed by code
+    `${String.fromCharCode(0x1b)}[()][AB012]`,
+].join('|'), 'g');
+/**
+ * Strip ANSI escape sequences from text.
+ *
+ * @param text - Raw text with potential ANSI codes
+ * @returns Clean text with ANSI sequences removed
+ */
+function stripAnsi(text) {
+    return text.replace(ANSI_ESCAPE_PATTERN, '');
+}
+// ============================================================
+// PARSER FACTORY
+// ============================================================
+/**
+ * Create a new stream parser instance.
+ *
+ * @returns Stream parser with buffering state
+ */
+export function createStreamParser() {
+    let buffer = '';
+    let lineNumber = 0;
+    /**
+     * Process a single complete line.
+     * Emits parsed message or throws RuntimeError on failure.
+     */
+    function processLine(line, onMessage) {
+        lineNumber++;
+        // Skip empty lines
+        if (line.trim().length === 0) {
+            return;
+        }
+        try {
+            const parsed = JSON.parse(line);
+            // Validate parsed object has 'type' discriminant
+            if (typeof parsed !== 'object' ||
+                parsed === null ||
+                !('type' in parsed)) {
+                throw new Error('Missing "type" field in message');
+            }
+            onMessage(parsed);
+        }
+        catch {
+            // EC-7: Complete line with invalid JSON is non-recoverable
+            throw new RuntimeError('RILL-R004', `Invalid stream-json output: line ${lineNumber}: ${line}`);
+        }
+    }
+    return {
+        processChunk(chunk, onMessage) {
+            // Convert Buffer to string if needed
+            const text = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+            // Append to buffer (ANSI codes included for now)
+            buffer += text;
+            // Process complete lines
+            let newlineIndex;
+            while ((newlineIndex = buffer.indexOf('\n')) !== -1) {
+                const rawLine = buffer.slice(0, newlineIndex);
+                buffer = buffer.slice(newlineIndex + 1);
+                // Strip ANSI from complete line before parsing
+                const cleanLine = stripAnsi(rawLine);
+                processLine(cleanLine, onMessage);
+            }
+        },
+        flush(onMessage) {
+            // Process remaining buffer as final line
+            if (buffer.trim().length > 0) {
+                const cleanLine = stripAnsi(buffer);
+                processLine(cleanLine, onMessage);
+                buffer = '';
+            }
+        },
+    };
+}
+//# sourceMappingURL=stream-parser.js.map

package/dist/stream-parser.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Type definitions for Claude Code extension.
+ * Defines message types, token tracking, and result structures.
+ */
+/**
+ * Token count breakdown from Claude Code CLI.
+ * Tracks prompt tokens, cache operations, and output tokens.
+ */
+export interface TokenCounts {
+    /** Non-cached prompt tokens */
+    readonly prompt: number;
+    /** Tokens written to 5-minute cache */
+    readonly cacheWrite5m: number;
+    /** Tokens written to 1-hour cache */
+    readonly cacheWrite1h: number;
+    /** Tokens read from cache */
+    readonly cacheRead: number;
+    /** Output tokens generated */
+    readonly output: number;
+}
+/**
+ * Token usage data from Claude API response.
+ * Maps to TokenCounts fields via extraction logic.
+ */
+export interface TokenUsage {
+    /** Non-cached input tokens */
+    readonly input_tokens?: number | undefined;
+    /** Generated output tokens */
+    readonly output_tokens?: number | undefined;
+    /** Cache read tokens */
+    readonly cache_read_input_tokens?: number | undefined;
+    /** Structured cache creation tracking */
+    readonly cache_creation?: {
+        /** 5-minute cache write tokens */
+        readonly ephemeral_5m_input_tokens?: number | undefined;
+        /** 1-hour cache write tokens */
+        readonly ephemeral_1h_input_tokens?: number | undefined;
+    } | undefined;
+}
+/**
+ * Text content block.
+ */
+export interface TextBlock {
+    readonly type: 'text';
+    readonly text: string;
+}
+/**
+ * Tool use request block.
+ */
+export interface ToolUseBlock {
+    readonly type: 'tool_use';
+    readonly id: string;
+    readonly name: string;
+    readonly input: Record<string, unknown>;
+}
+/**
+ * Tool result response block.
+ */
+export interface ToolResultBlock {
+    readonly type: 'tool_result';
+    readonly tool_use_id: string;
+    readonly content: string | unknown;
+    readonly is_error?: boolean | undefined;
+}
+/**
+ * Content block variants for message content arrays.
+ */
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock;
+/**
+ * System initialization message.
+ * First message in stream, establishes session config.
+ */
+export interface SystemMessage {
+    readonly type: 'system';
+    readonly subtype: 'init';
+    readonly model: string;
+    readonly tools?: readonly unknown[] | undefined;
+    readonly mcp_servers?: readonly unknown[] | undefined;
+}
+/**
+ * Assistant response message.
+ * Contains text and tool use blocks.
+ */
+export interface AssistantMessage {
+    readonly type: 'assistant';
+    readonly message: {
+        readonly content: readonly ContentBlock[];
+        readonly usage?: TokenUsage | undefined;
+    };
+}
+/**
+ * User message with tool results.
+ * Contains tool result blocks.
+ */
+export interface UserMessage {
+    readonly type: 'user';
+    readonly message: {
+        readonly content: readonly ContentBlock[];
+    };
+}
+/**
+ * Result message with cost and duration.
+ * Final message in stream with aggregated metrics.
+ */
+export interface ResultMessage {
+    readonly type: 'result';
+    readonly cost_usd: number;
+    readonly duration_ms: number;
+    readonly is_error: boolean;
+    readonly usage: TokenUsage;
+}
+/**
+ * Discriminated union of all Claude Code message types.
+ * Discriminant field: `type`
+ */
+export type ClaudeMessage = SystemMessage | AssistantMessage | UserMessage | ResultMessage;
+/**
+ * Configuration options for Claude Code integration.
+ */
+export interface ClaudeCodeConfig {
+    /** Path to Claude Code CLI binary (default: 'claude') */
+    readonly binaryPath?: string | undefined;
+    /** Default timeout in milliseconds (default: 120000) */
+    readonly defaultTimeout?: number | undefined;
+}
+/**
+ * Options for prompt execution.
+ */
+export interface PromptOptions {
+    /** Execution timeout in milliseconds (overrides defaultTimeout) */
+    readonly timeout?: number | undefined;
+}
+/**
+ * Complete result from Claude Code prompt execution.
+ * Aggregates all stream messages into single structure.
+ */
+export interface ClaudeCodeResult {
+    /** Combined text result from all assistant messages */
+    readonly result: string;
+    /** Token count breakdown */
+    readonly tokens: TokenCounts;
+    /** Total cost in USD */
+    readonly cost: number;
+    /** Exit code from CLI process (0 = success) */
+    readonly exitCode: number;
+    /** Total execution duration in milliseconds */
+    readonly duration: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Type definitions for Claude Code extension.
+ * Defines message types, token tracking, and result structures.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@rcrsr/rill-ext-claude-code",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "node-pty": "^1.0.0",
+    "@rcrsr/rill": "^0.6.0"
+  },
+  "devDependencies": {
+    "@types/which": "^3.0.4",
+    "@rcrsr/rill": "^0.6.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "which": "^6.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --config ../../../eslint.config.js src/",
+    "check": "pnpm run build && pnpm run test && pnpm run lint"
+  }
+}