@ttfw/envoi 1.0.0

package/dist/lib/claude.js

@@ -0,0 +1,291 @@
+/**
+ * Claude Code CLI wrapper for invoking Claude with proper flags.
+ *
+ * Provides functions to build CLI arguments, spawn processes, and parse responses.
+ */
+import { spawn } from 'node:child_process';
+import { ClaudeError, InterruptedError } from '../types/claude.js';
+function isDebugEnabled() {
+    return process.env.ENVOI_DEBUG === '1';
+}
+/**
+ * Builds CLI arguments array from config and invocation parameters.
+ *
+ * @param config - Claude Code CLI configuration
+ * @param invocation - Invocation parameters
+ * @returns Array of CLI arguments
+ */
+export function buildClaudeArgs(config, invocation) {
+    const args = [
+        '--print', // non-interactive output
+        '--output-format',
+        config.output_format,
+        '--max-turns',
+        invocation.maxTurns.toString(),
+        '--no-session-persistence', // always
+        '--permission-mode',
+        invocation.permissionMode,
+        '--model',
+        invocation.model,
+    ];
+    // Add optional allowedTools flag
+    if (invocation.allowedTools) {
+        args.push('--allowedTools', invocation.allowedTools);
+    }
+    // Add optional system-prompt flag
+    if (invocation.systemPrompt) {
+        args.push('--system-prompt', invocation.systemPrompt);
+    }
+    // Add the prompt as the last argument
+    args.push(invocation.prompt);
+    return args;
+}
+/**
+ * Parses the JSON response from Claude Code CLI and extracts the result.
+ *
+ * The CLI returns a JSON wrapper with format: { result: 'model output', ... }
+ * This function extracts the .result field as the actual model text.
+ *
+ * When the CLI returns an error response (e.g., error_max_turns), the result
+ * field may be missing. In such cases, this function returns an empty result
+ * so callers can handle the situation gracefully.
+ *
+ * @param stdout - Standard output from CLI process
+ * @returns Parsed result object with result field and optional subtype for errors
+ * @throws {Error} If JSON parsing fails
+ */
+function toNumberOrNull(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : null;
+}
+function parseUsageShape(candidate) {
+    if (typeof candidate !== 'object' || candidate === null)
+        return null;
+    const usage = candidate;
+    const input = toNumberOrNull(usage.input_tokens) ??
+        toNumberOrNull(usage.prompt_tokens) ??
+        toNumberOrNull(usage.inputTokens);
+    const output = toNumberOrNull(usage.output_tokens) ??
+        toNumberOrNull(usage.completion_tokens) ??
+        toNumberOrNull(usage.outputTokens);
+    const total = toNumberOrNull(usage.total_tokens) ?? toNumberOrNull(usage.totalTokens);
+    const cacheCreation = toNumberOrNull(usage.cache_creation_input_tokens);
+    const cacheRead = toNumberOrNull(usage.cache_read_input_tokens);
+    const computedTotal = total ??
+        (input !== null && output !== null ? input + output : null);
+    const hasAnyValue = input !== null ||
+        output !== null ||
+        computedTotal !== null ||
+        cacheCreation !== null ||
+        cacheRead !== null;
+    if (!hasAnyValue)
+        return null;
+    return {
+        input_tokens: input,
+        output_tokens: output,
+        total_tokens: computedTotal,
+        cache_creation_input_tokens: cacheCreation,
+        cache_read_input_tokens: cacheRead,
+    };
+}
+function extractTokenUsage(raw) {
+    const candidates = [
+        raw.usage,
+        raw.token_usage,
+        raw.metrics,
+        raw.metrics?.usage,
+        raw.message?.usage,
+    ];
+    for (const candidate of candidates) {
+        const usage = parseUsageShape(candidate);
+        if (usage)
+            return usage;
+    }
+    return null;
+}
+export function parseClaudeResponse(stdout) {
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch (error) {
+        throw new Error(`Failed to parse JSON response: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new Error('Parsed response is not an object');
+    }
+    const obj = parsed;
+    // Handle CLI error responses (e.g., error_max_turns) that lack a result field
+    // Return empty result so callers can handle based on subtype
+    if (typeof obj.result !== 'string') {
+        const subtype = typeof obj.subtype === 'string' ? obj.subtype : undefined;
+        const tokenUsage = extractTokenUsage(obj);
+        if (isDebugEnabled()) {
+            console.log(`[CLAUDE_DEBUG] No result field in response, subtype=${subtype}`);
+        }
+        return {
+            result: '',
+            raw: parsed,
+            subtype,
+            tokenUsage,
+        };
+    }
+    const tokenUsage = extractTokenUsage(obj);
+    return {
+        result: obj.result,
+        raw: parsed,
+        subtype: typeof obj.subtype === 'string' ? obj.subtype : undefined,
+        tokenUsage,
+    };
+}
+/**
+ * Invokes Claude Code CLI with the given configuration and invocation parameters.
+ *
+ * @param config - Claude Code CLI configuration
+ * @param invocation - Invocation parameters including prompt, model, etc.
+ * @returns Promise resolving to ClaudeResponse with parsed output
+ * @throws {ClaudeError} If invocation fails or times out
+ *
+ * @example
+ * ```typescript
+ * const response = await invokeClaudeCode(config, {
+ *   prompt: 'Hello, Claude!',
+ *   maxTurns: 1,
+ *   permissionMode: 'plan',
+ *   model: 'claude-3-5-sonnet-20241022',
+ *   timeout: 60000
+ * });
+ * ```
+ */
+export async function invokeClaudeCode(config, invocation) {
+    // Short-circuit if already aborted
+    if (invocation.signal?.aborted) {
+        throw new InterruptedError('Claude Code invocation aborted by signal');
+    }
+    const startTime = Date.now();
+    const args = buildClaudeArgs(config, invocation);
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        let timeoutId = null;
+        let aborted = false;
+        let abortHandler = null;
+        let exited = false;
+        let killTimerId = null;
+        // Spawn the process
+        const child = spawn(config.command, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (isDebugEnabled()) {
+            console.log(`[CLAUDE_DEBUG] Spawned PID: ${child.pid}`);
+        }
+        // Close stdin: we always pass prompt via argv; prevents cli waiting on stdin
+        child.stdin?.end();
+        // Cleanup function to remove all listeners and timers
+        const cleanup = () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            if (killTimerId) {
+                clearTimeout(killTimerId);
+                killTimerId = null;
+            }
+            if (abortHandler && invocation.signal) {
+                invocation.signal.removeEventListener('abort', abortHandler);
+                abortHandler = null;
+            }
+        };
+        // Track if child has exited
+        child.on('exit', (code, signal) => {
+            if (isDebugEnabled()) {
+                console.log(`[CLAUDE_DEBUG] Exit: code=${code}, signal=${signal}`);
+            }
+            exited = true;
+            // Clear the SIGKILL escalation timer if child exited
+            if (killTimerId) {
+                clearTimeout(killTimerId);
+                killTimerId = null;
+            }
+        });
+        // Handle abort signal
+        if (invocation.signal) {
+            abortHandler = () => {
+                if (aborted)
+                    return;
+                aborted = true;
+                cleanup();
+                child.kill('SIGTERM');
+                // Force kill after 1 second if still alive
+                killTimerId = setTimeout(() => {
+                    if (!exited)
+                        child.kill('SIGKILL');
+                }, 1000);
+                reject(new InterruptedError('Claude Code invocation aborted by signal'));
+            };
+            invocation.signal.addEventListener('abort', abortHandler, { once: true });
+        }
+        // Set up timeout
+        if (invocation.timeout > 0) {
+            timeoutId = setTimeout(() => {
+                cleanup();
+                child.kill('SIGTERM');
+                reject(new ClaudeError(`Claude Code CLI invocation timed out after ${invocation.timeout}ms`, 124, // Standard timeout exit code
+                stderr));
+            }, invocation.timeout);
+        }
+        // Capture stdout
+        child.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        // Capture stderr
+        child.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        // Handle process completion
+        child.on('close', (code) => {
+            // If we were aborted, error was already handled
+            if (aborted) {
+                return;
+            }
+            cleanup();
+            const durationMs = Date.now() - startTime;
+            const exitCode = code ?? 0;
+            // If process was killed by timeout, error was already handled
+            if (code === null && !aborted) {
+                return;
+            }
+            try {
+                // Parse the JSON response
+                const parsed = parseClaudeResponse(stdout);
+                // If result is empty and we have an error subtype, treat as failure
+                // Common subtypes: error_max_turns, error_during_execution
+                const isErrorSubtype = parsed.subtype?.startsWith('error_') ?? false;
+                const effectiveSuccess = exitCode === 0 && !isErrorSubtype;
+                resolve({
+                    success: effectiveSuccess,
+                    result: effectiveSuccess ? parsed.result : (parsed.result || null),
+                    raw: parsed.raw,
+                    exitCode,
+                    durationMs,
+                    stderr,
+                    tokenUsage: parsed.tokenUsage,
+                });
+            }
+            catch (error) {
+                if (isDebugEnabled()) {
+                    console.log(`[CLAUDE_DEBUG] Parse failed. stdout (first 2000 chars):\n${stdout.slice(0, 2000)}`);
+                }
+                reject(new ClaudeError(`Failed to parse Claude response: ${error instanceof Error ? error.message : String(error)}`, exitCode, stderr, error instanceof Error ? error : undefined));
+            }
+        });
+        // Handle process errors
+        child.on('error', (error) => {
+            if (aborted) {
+                return;
+            }
+            cleanup();
+            reject(new ClaudeError(`Failed to spawn Claude Code CLI process: ${error.message}`, 1, stderr, error));
+        });
+    });
+}
+//# sourceMappingURL=claude.js.map

package/dist/lib/claude.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Configuration loading and validation utilities.
+ *
+ * Provides functions to load, find, and validate Envoi config files.
+ */
+import type { EnvoiConfig } from '../types/config.js';
+/** Default configuration file name */
+export declare const CONFIG_FILE_NAME = "envoi.config.json";
+export declare const LEGACY_CONFIG_NAME = "relais.config.json";
+/**
+ * Error thrown when configuration loading or validation fails.
+ */
+export declare class ConfigError extends Error {
+    readonly configPath?: string | undefined;
+    readonly cause?: Error | undefined;
+    constructor(message: string, configPath?: string | undefined, cause?: Error | undefined);
+}
+/**
+ * Searches for a configuration file by walking upward from the current directory.
+ * Stops at the filesystem root if not found.
+ *
+ * @returns Path to the config file if found, null otherwise
+ */
+export declare function findConfigFile(): Promise<string | null>;
+/**
+ * Gets the repository root directory (where the config file is located).
+ * If configPath is provided, returns its directory. Otherwise, searches upward
+ * from the current directory.
+ *
+ * @param configPath - Optional path to the config file. If provided, returns its directory.
+ * @returns Path to the repository root directory, or null if config not found
+ */
+export declare function getRepoRoot(configPath?: string): Promise<string | null>;
+/**
+ * Changes the current working directory to the repository root.
+ * This ensures that relative paths in config (workspace_dir, lockfile, etc.)
+ * resolve correctly regardless of where the command was invoked from.
+ *
+ * @param configPath - Optional path to the config file. If not provided, searches upward.
+ * @throws {ConfigError} If the config file cannot be found
+ */
+export declare function chdirToRepoRoot(configPath?: string): Promise<void>;
+/**
+ * Validates that an object conforms to the EnvoiConfig interface.
+ *
+ * This performs structural validation to ensure all required fields are present
+ * and have the expected types.
+ *
+ * @param config - The object to validate
+ * @returns True if the object is a valid EnvoiConfig
+ */
+export declare function validateConfig(config: unknown): config is EnvoiConfig;
+/**
+ * Loads and validates an Envoi configuration file.
+ *
+ * @param configPath - Optional path to the config file. If not provided,
+ *                     searches upward for a known config file name.
+ * @returns The validated configuration object
+ * @throws {ConfigError} If the config file cannot be found, read, or is invalid
+ *
+ * @example
+ * ```typescript
+ * // Load from default location
+ * const config = await loadConfig();
+ *
+ * // Load from specific path
+ * const config = await loadConfig('/path/to/envoi.config.json');
+ * ```
+ */
+export declare function loadConfig(configPath?: string): Promise<EnvoiConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,sBAA2B,CAAC;AACzD,eAAO,MAAM,kBAAkB,uBAA0B,CAAC;AAE1D;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,UAAU,CAAC,EAAE,MAAM;aACnB,KAAK,CAAC,EAAE,KAAK;gBAF7B,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuB7D;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW7E;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,WAAW,CA4NrE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAuC1E"}