agents-reverse-engineer 0.3.6 → 0.4.0

package/dist/ai/backends/claude.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Claude CLI backend adapter.
+ *
+ * Full implementation of the {@link AIBackend} interface for the Claude Code
+ * CLI (`claude`). Builds CLI arguments, parses structured JSON responses
+ * with Zod validation, detects CLI availability on PATH, and provides
+ * install instructions.
+ *
+ * The prompt is NOT included in the args array -- it goes to stdin via
+ * the subprocess wrapper ({@link runSubprocess}).
+ *
+ * @module
+ */
+import type { AIBackend, AICallOptions, AIResponse } from '../types.js';
+/**
+ * Check whether a command is available on the system PATH.
+ *
+ * Splits `process.env.PATH` by the platform delimiter and checks each
+ * directory for a file matching the command name. On Windows, also checks
+ * each extension from `process.env.PATHEXT` (e.g., `.exe`, `.cmd`, `.bat`).
+ *
+ * Uses `fs.stat` (not `fs.access` with execute bit) for cross-platform
+ * compatibility -- Windows does not have Unix execute permissions.
+ *
+ * @param command - The bare command name to look for (e.g., "claude")
+ * @returns `true` if the command exists as a file in any PATH directory
+ *
+ * @example
+ * ```typescript
+ * if (await isCommandOnPath('claude')) {
+ *   console.log('Claude CLI is available');
+ * }
+ * ```
+ */
+export declare function isCommandOnPath(command: string): Promise<boolean>;
+/**
+ * Claude Code CLI backend adapter.
+ *
+ * Implements the {@link AIBackend} interface for the `claude` CLI.
+ * This is the primary (and currently only fully implemented) backend.
+ *
+ * @example
+ * ```typescript
+ * const backend = new ClaudeBackend();
+ * if (await backend.isAvailable()) {
+ *   const args = backend.buildArgs({ prompt: 'Summarize this file' });
+ *   const result = await runSubprocess('claude', args, {
+ *     timeoutMs: 120_000,
+ *     input: 'Summarize this file',
+ *   });
+ *   const response = backend.parseResponse(result.stdout, result.durationMs, result.exitCode);
+ * }
+ * ```
+ */
+export declare class ClaudeBackend implements AIBackend {
+    readonly name = "claude";
+    readonly cliCommand = "claude";
+    /**
+     * Check if the `claude` CLI is available on PATH.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build CLI arguments for a Claude invocation.
+     *
+     * Returns the argument array for `claude -p --output-format json`. The
+     * prompt itself is NOT included -- it goes to stdin via the subprocess
+     * wrapper.
+     *
+     * @param options - Call options (model, systemPrompt, maxTurns)
+     * @returns Argument array suitable for {@link runSubprocess}
+     */
+    buildArgs(options: AICallOptions): string[];
+    /**
+     * Parse Claude CLI JSON output into a normalized {@link AIResponse}.
+     *
+     * Handles non-JSON prefix text by finding the first `{` character
+     * (defensive parsing per RESEARCH.md Pitfall 4). Validates the response
+     * against the Zod schema and extracts the model name from `modelUsage`.
+     *
+     * @param stdout - Raw stdout from the Claude CLI process
+     * @param durationMs - Wall-clock duration of the subprocess
+     * @param exitCode - Process exit code
+     * @returns Normalized AI response
+     * @throws {AIServiceError} With code `PARSE_ERROR` if JSON is missing or schema validation fails
+     */
+    parseResponse(stdout: string, durationMs: number, exitCode: number): AIResponse;
+    /**
+     * Get user-facing install instructions for the Claude CLI.
+     */
+    getInstallInstructions(): string;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/ai/backends/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/ai/backends/claude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA2CxE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA2BvE;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,YAAY;IAE/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE;IAuB3C;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU;IAsC/E;;OAEG;IACH,sBAAsB,IAAI,MAAM;CAOjC"}

package/dist/ai/backends/claude.js

@@ -0,0 +1,213 @@
+/**
+ * Claude CLI backend adapter.
+ *
+ * Full implementation of the {@link AIBackend} interface for the Claude Code
+ * CLI (`claude`). Builds CLI arguments, parses structured JSON responses
+ * with Zod validation, detects CLI availability on PATH, and provides
+ * install instructions.
+ *
+ * The prompt is NOT included in the args array -- it goes to stdin via
+ * the subprocess wrapper ({@link runSubprocess}).
+ *
+ * @module
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { AIServiceError } from '../types.js';
+// ---------------------------------------------------------------------------
+// Zod schema for Claude CLI JSON output
+// ---------------------------------------------------------------------------
+/**
+ * Schema validated against Claude CLI v2.1.31 JSON output.
+ *
+ * When invoked with `claude -p --output-format json`, the CLI produces a
+ * single JSON object on stdout matching this shape. See RESEARCH.md for
+ * the live verification details.
+ */
+const ClaudeResponseSchema = z.object({
+    type: z.literal('result'),
+    subtype: z.enum(['success', 'error']),
+    is_error: z.boolean(),
+    duration_ms: z.number(),
+    duration_api_ms: z.number(),
+    num_turns: z.number(),
+    result: z.string(),
+    session_id: z.string(),
+    total_cost_usd: z.number(),
+    usage: z.object({
+        input_tokens: z.number(),
+        cache_creation_input_tokens: z.number(),
+        cache_read_input_tokens: z.number(),
+        output_tokens: z.number(),
+    }),
+    modelUsage: z.record(z.object({
+        inputTokens: z.number(),
+        outputTokens: z.number(),
+        cacheReadInputTokens: z.number(),
+        cacheCreationInputTokens: z.number(),
+        costUSD: z.number(),
+    })),
+});
+// ---------------------------------------------------------------------------
+// PATH detection utility
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a command is available on the system PATH.
+ *
+ * Splits `process.env.PATH` by the platform delimiter and checks each
+ * directory for a file matching the command name. On Windows, also checks
+ * each extension from `process.env.PATHEXT` (e.g., `.exe`, `.cmd`, `.bat`).
+ *
+ * Uses `fs.stat` (not `fs.access` with execute bit) for cross-platform
+ * compatibility -- Windows does not have Unix execute permissions.
+ *
+ * @param command - The bare command name to look for (e.g., "claude")
+ * @returns `true` if the command exists as a file in any PATH directory
+ *
+ * @example
+ * ```typescript
+ * if (await isCommandOnPath('claude')) {
+ *   console.log('Claude CLI is available');
+ * }
+ * ```
+ */
+export async function isCommandOnPath(command) {
+    const envPath = process.env.PATH ?? '';
+    const pathDirs = envPath
+        .replace(/["]+/g, '')
+        .split(path.delimiter)
+        .filter(Boolean);
+    // On Windows, PATHEXT lists executable extensions (e.g., ".EXE;.CMD;.BAT").
+    // On other platforms, PATHEXT is unset; check the bare command name only.
+    const envExt = process.env.PATHEXT ?? '';
+    const extensions = envExt ? envExt.split(';') : [''];
+    for (const dir of pathDirs) {
+        for (const ext of extensions) {
+            try {
+                const candidate = path.join(dir, command + ext);
+                const stat = await fs.stat(candidate);
+                if (stat.isFile()) {
+                    return true;
+                }
+            }
+            catch {
+                // Not found in this dir/ext combination, continue
+            }
+        }
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// Claude backend
+// ---------------------------------------------------------------------------
+/**
+ * Claude Code CLI backend adapter.
+ *
+ * Implements the {@link AIBackend} interface for the `claude` CLI.
+ * This is the primary (and currently only fully implemented) backend.
+ *
+ * @example
+ * ```typescript
+ * const backend = new ClaudeBackend();
+ * if (await backend.isAvailable()) {
+ *   const args = backend.buildArgs({ prompt: 'Summarize this file' });
+ *   const result = await runSubprocess('claude', args, {
+ *     timeoutMs: 120_000,
+ *     input: 'Summarize this file',
+ *   });
+ *   const response = backend.parseResponse(result.stdout, result.durationMs, result.exitCode);
+ * }
+ * ```
+ */
+export class ClaudeBackend {
+    name = 'claude';
+    cliCommand = 'claude';
+    /**
+     * Check if the `claude` CLI is available on PATH.
+     */
+    async isAvailable() {
+        return isCommandOnPath(this.cliCommand);
+    }
+    /**
+     * Build CLI arguments for a Claude invocation.
+     *
+     * Returns the argument array for `claude -p --output-format json`. The
+     * prompt itself is NOT included -- it goes to stdin via the subprocess
+     * wrapper.
+     *
+     * @param options - Call options (model, systemPrompt, maxTurns)
+     * @returns Argument array suitable for {@link runSubprocess}
+     */
+    buildArgs(options) {
+        const args = [
+            '-p', // Non-interactive print mode
+            '--output-format', 'json', // Structured JSON output
+            '--no-session-persistence', // Don't save session to disk
+            '--permission-mode', 'bypassPermissions', // Non-interactive: skip permission prompts (PITFALLS.md §8)
+        ];
+        if (options.model) {
+            args.push('--model', options.model);
+        }
+        if (options.systemPrompt) {
+            args.push('--system-prompt', options.systemPrompt);
+        }
+        if (options.maxTurns !== undefined) {
+            args.push('--max-turns', String(options.maxTurns));
+        }
+        return args;
+    }
+    /**
+     * Parse Claude CLI JSON output into a normalized {@link AIResponse}.
+     *
+     * Handles non-JSON prefix text by finding the first `{` character
+     * (defensive parsing per RESEARCH.md Pitfall 4). Validates the response
+     * against the Zod schema and extracts the model name from `modelUsage`.
+     *
+     * @param stdout - Raw stdout from the Claude CLI process
+     * @param durationMs - Wall-clock duration of the subprocess
+     * @param exitCode - Process exit code
+     * @returns Normalized AI response
+     * @throws {AIServiceError} With code `PARSE_ERROR` if JSON is missing or schema validation fails
+     */
+    parseResponse(stdout, durationMs, exitCode) {
+        // Find JSON object in stdout (handle any prefix text like upgrade notices)
+        const jsonStart = stdout.indexOf('{');
+        if (jsonStart === -1) {
+            throw new AIServiceError('PARSE_ERROR', `No JSON object found in Claude CLI output. Raw output (first 200 chars): ${stdout.slice(0, 200)}`);
+        }
+        let parsed;
+        try {
+            parsed = ClaudeResponseSchema.parse(JSON.parse(stdout.slice(jsonStart)));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new AIServiceError('PARSE_ERROR', `Failed to parse Claude CLI JSON response: ${message}`);
+        }
+        // Extract model name from modelUsage keys (first key is the model used)
+        const modelName = Object.keys(parsed.modelUsage)[0] ?? 'unknown';
+        return {
+            text: parsed.result,
+            model: modelName,
+            inputTokens: parsed.usage.input_tokens,
+            outputTokens: parsed.usage.output_tokens,
+            cacheReadTokens: parsed.usage.cache_read_input_tokens,
+            cacheCreationTokens: parsed.usage.cache_creation_input_tokens,
+            costUsd: parsed.total_cost_usd,
+            durationMs,
+            exitCode,
+            raw: parsed,
+        };
+    }
+    /**
+     * Get user-facing install instructions for the Claude CLI.
+     */
+    getInstallInstructions() {
+        return [
+            'Claude Code (recommended):',
+            '  npm install -g @anthropic-ai/claude-code',
+            '  https://code.claude.com',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/ai/backends/claude.js.map

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

package/dist/ai/backends/gemini.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Gemini CLI backend stub.
+ *
+ * Implements the {@link AIBackend} interface for the Gemini CLI (`gemini`).
+ * This is a stub that demonstrates the extension pattern -- `parseResponse`
+ * throws "not implemented". Full implementation deferred to a future phase
+ * once the Gemini CLI JSON output is stable (see RESEARCH.md Open Question 2).
+ *
+ * @module
+ */
+import type { AIBackend, AICallOptions, AIResponse } from '../types.js';
+/**
+ * Gemini CLI backend stub.
+ *
+ * Detects CLI availability and builds argument arrays, but throws when
+ * `parseResponse` is called since the Gemini adapter is not yet implemented.
+ *
+ * @example
+ * ```typescript
+ * const backend = new GeminiBackend();
+ * console.log(await backend.isAvailable()); // true if `gemini` is on PATH
+ * backend.parseResponse('{}', 0, 0);        // throws AIServiceError
+ * ```
+ */
+export declare class GeminiBackend implements AIBackend {
+    readonly name = "gemini";
+    readonly cliCommand = "gemini";
+    /**
+     * Check if the `gemini` CLI is available on PATH.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build CLI arguments for a Gemini invocation.
+     *
+     * Based on documented Gemini CLI flags from RESEARCH.md.
+     * The prompt goes to stdin via the subprocess wrapper.
+     *
+     * @param _options - Call options (unused in stub)
+     * @returns Argument array for the Gemini CLI
+     */
+    buildArgs(_options: AICallOptions): string[];
+    /**
+     * Parse Gemini CLI output into a normalized {@link AIResponse}.
+     *
+     * @throws {AIServiceError} Always -- Gemini backend is not yet implemented
+     */
+    parseResponse(_stdout: string, _durationMs: number, _exitCode: number): AIResponse;
+    /**
+     * Get user-facing install instructions for the Gemini CLI.
+     */
+    getInstallInstructions(): string;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/ai/backends/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../src/ai/backends/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIxE;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,YAAY;IAE/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE;IAI5C;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;IAOlF;;OAEG;IACH,sBAAsB,IAAI,MAAM;CAOjC"}

package/dist/ai/backends/gemini.js

@@ -0,0 +1,66 @@
+/**
+ * Gemini CLI backend stub.
+ *
+ * Implements the {@link AIBackend} interface for the Gemini CLI (`gemini`).
+ * This is a stub that demonstrates the extension pattern -- `parseResponse`
+ * throws "not implemented". Full implementation deferred to a future phase
+ * once the Gemini CLI JSON output is stable (see RESEARCH.md Open Question 2).
+ *
+ * @module
+ */
+import { AIServiceError } from '../types.js';
+import { isCommandOnPath } from './claude.js';
+/**
+ * Gemini CLI backend stub.
+ *
+ * Detects CLI availability and builds argument arrays, but throws when
+ * `parseResponse` is called since the Gemini adapter is not yet implemented.
+ *
+ * @example
+ * ```typescript
+ * const backend = new GeminiBackend();
+ * console.log(await backend.isAvailable()); // true if `gemini` is on PATH
+ * backend.parseResponse('{}', 0, 0);        // throws AIServiceError
+ * ```
+ */
+export class GeminiBackend {
+    name = 'gemini';
+    cliCommand = 'gemini';
+    /**
+     * Check if the `gemini` CLI is available on PATH.
+     */
+    async isAvailable() {
+        return isCommandOnPath(this.cliCommand);
+    }
+    /**
+     * Build CLI arguments for a Gemini invocation.
+     *
+     * Based on documented Gemini CLI flags from RESEARCH.md.
+     * The prompt goes to stdin via the subprocess wrapper.
+     *
+     * @param _options - Call options (unused in stub)
+     * @returns Argument array for the Gemini CLI
+     */
+    buildArgs(_options) {
+        return ['-p', '--output-format', 'json'];
+    }
+    /**
+     * Parse Gemini CLI output into a normalized {@link AIResponse}.
+     *
+     * @throws {AIServiceError} Always -- Gemini backend is not yet implemented
+     */
+    parseResponse(_stdout, _durationMs, _exitCode) {
+        throw new AIServiceError('SUBPROCESS_ERROR', 'Gemini backend is not yet implemented. Use Claude backend.');
+    }
+    /**
+     * Get user-facing install instructions for the Gemini CLI.
+     */
+    getInstallInstructions() {
+        return [
+            'Gemini CLI (experimental):',
+            '  npm install -g @anthropic-ai/gemini-cli',
+            '  https://github.com/google-gemini/gemini-cli',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/ai/backends/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../../src/ai/backends/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,QAAQ,CAAC;IAChB,UAAU,GAAG,QAAQ,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAuB;QAC/B,OAAO,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,OAAe,EAAE,WAAmB,EAAE,SAAiB;QACnE,MAAM,IAAI,cAAc,CACtB,kBAAkB,EAClB,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,OAAO;YACL,4BAA4B;YAC5B,2CAA2C;YAC3C,+CAA+C;SAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/ai/backends/opencode.d.ts

@@ -0,0 +1,53 @@
+/**
+ * OpenCode CLI backend stub.
+ *
+ * Implements the {@link AIBackend} interface for the OpenCode CLI (`opencode`).
+ * This is a stub that demonstrates the extension pattern -- `parseResponse`
+ * throws "not implemented". Full implementation deferred to a future phase
+ * once the OpenCode JSONL output parsing is built (see RESEARCH.md Open Question 3).
+ *
+ * @module
+ */
+import type { AIBackend, AICallOptions, AIResponse } from '../types.js';
+/**
+ * OpenCode CLI backend stub.
+ *
+ * Detects CLI availability and builds argument arrays, but throws when
+ * `parseResponse` is called since the OpenCode adapter is not yet implemented.
+ *
+ * @example
+ * ```typescript
+ * const backend = new OpenCodeBackend();
+ * console.log(await backend.isAvailable()); // true if `opencode` is on PATH
+ * backend.parseResponse('{}', 0, 0);        // throws AIServiceError
+ * ```
+ */
+export declare class OpenCodeBackend implements AIBackend {
+    readonly name = "opencode";
+    readonly cliCommand = "opencode";
+    /**
+     * Check if the `opencode` CLI is available on PATH.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Build CLI arguments for an OpenCode invocation.
+     *
+     * Based on documented OpenCode CLI flags from RESEARCH.md.
+     * The prompt goes to stdin via the subprocess wrapper.
+     *
+     * @param _options - Call options (unused in stub)
+     * @returns Argument array for the OpenCode CLI
+     */
+    buildArgs(_options: AICallOptions): string[];
+    /**
+     * Parse OpenCode CLI output into a normalized {@link AIResponse}.
+     *
+     * @throws {AIServiceError} Always -- OpenCode backend is not yet implemented
+     */
+    parseResponse(_stdout: string, _durationMs: number, _exitCode: number): AIResponse;
+    /**
+     * Get user-facing install instructions for the OpenCode CLI.
+     */
+    getInstallInstructions(): string;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/ai/backends/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/ai/backends/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIxE;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,UAAU,cAAc;IAEjC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE;IAI5C;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU;IAOlF;;OAEG;IACH,sBAAsB,IAAI,MAAM;CAOjC"}

package/dist/ai/backends/opencode.js

@@ -0,0 +1,66 @@
+/**
+ * OpenCode CLI backend stub.
+ *
+ * Implements the {@link AIBackend} interface for the OpenCode CLI (`opencode`).
+ * This is a stub that demonstrates the extension pattern -- `parseResponse`
+ * throws "not implemented". Full implementation deferred to a future phase
+ * once the OpenCode JSONL output parsing is built (see RESEARCH.md Open Question 3).
+ *
+ * @module
+ */
+import { AIServiceError } from '../types.js';
+import { isCommandOnPath } from './claude.js';
+/**
+ * OpenCode CLI backend stub.
+ *
+ * Detects CLI availability and builds argument arrays, but throws when
+ * `parseResponse` is called since the OpenCode adapter is not yet implemented.
+ *
+ * @example
+ * ```typescript
+ * const backend = new OpenCodeBackend();
+ * console.log(await backend.isAvailable()); // true if `opencode` is on PATH
+ * backend.parseResponse('{}', 0, 0);        // throws AIServiceError
+ * ```
+ */
+export class OpenCodeBackend {
+    name = 'opencode';
+    cliCommand = 'opencode';
+    /**
+     * Check if the `opencode` CLI is available on PATH.
+     */
+    async isAvailable() {
+        return isCommandOnPath(this.cliCommand);
+    }
+    /**
+     * Build CLI arguments for an OpenCode invocation.
+     *
+     * Based on documented OpenCode CLI flags from RESEARCH.md.
+     * The prompt goes to stdin via the subprocess wrapper.
+     *
+     * @param _options - Call options (unused in stub)
+     * @returns Argument array for the OpenCode CLI
+     */
+    buildArgs(_options) {
+        return ['run', '--format', 'json'];
+    }
+    /**
+     * Parse OpenCode CLI output into a normalized {@link AIResponse}.
+     *
+     * @throws {AIServiceError} Always -- OpenCode backend is not yet implemented
+     */
+    parseResponse(_stdout, _durationMs, _exitCode) {
+        throw new AIServiceError('SUBPROCESS_ERROR', 'OpenCode backend is not yet implemented. Use Claude backend.');
+    }
+    /**
+     * Get user-facing install instructions for the OpenCode CLI.
+     */
+    getInstallInstructions() {
+        return [
+            'OpenCode (experimental):',
+            '  curl -fsSL https://opencode.ai/install | bash',
+            '  https://opencode.ai',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/ai/backends/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/ai/backends/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,UAAU,CAAC;IAClB,UAAU,GAAG,UAAU,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAuB;QAC/B,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,OAAe,EAAE,WAAmB,EAAE,SAAiB;QACnE,MAAM,IAAI,cAAc,CACtB,kBAAkB,EAClB,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,OAAO;YACL,0BAA0B;YAC1B,iDAAiD;YACjD,uBAAuB;SACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/ai/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Public API for the AI service layer.
+ *
+ * This barrel export is the ONLY import point for the AI service layer.
+ * No other module should reach into `src/ai/backends/` or `src/ai/telemetry/`
+ * directly.
+ *
+ * @module
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   AIService,
+ *   createBackendRegistry,
+ *   resolveBackend,
+ * } from './ai/index.js';
+ *
+ * const registry = createBackendRegistry();
+ * const backend = await resolveBackend(registry, 'auto');
+ * const service = new AIService(backend, {
+ *   timeoutMs: 120_000,
+ *   maxRetries: 3,
+ *   telemetry: { keepRuns: 10 },
+ * });
+ *
+ * const response = await service.call({ prompt: 'Hello' });
+ * ```
+ */
+export type { AIBackend, AIResponse, AICallOptions, SubprocessResult, RetryOptions, TelemetryEntry, RunLog, FileRead, CostSource, } from './types.js';
+export { AIServiceError } from './types.js';
+export { AIService } from './service.js';
+export type { AIServiceOptions } from './service.js';
+export { BackendRegistry, createBackendRegistry, resolveBackend, detectBackend, getInstallInstructions, } from './registry.js';
+export { withRetry, DEFAULT_RETRY_OPTIONS } from './retry.js';
+export { runSubprocess } from './subprocess.js';
+export { isCommandOnPath } from './backends/claude.js';
+export { DEFAULT_MODEL_PRICING, estimateCost, lookupPricing, formatCost, formatTokens } from './pricing.js';
+export type { ModelPricing, CostEstimate } from './pricing.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH,YAAY,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,MAAM,EACN,QAAQ,EACR,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAM5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMrD,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAM9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5G,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,54 @@
+/**
+ * Public API for the AI service layer.
+ *
+ * This barrel export is the ONLY import point for the AI service layer.
+ * No other module should reach into `src/ai/backends/` or `src/ai/telemetry/`
+ * directly.
+ *
+ * @module
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   AIService,
+ *   createBackendRegistry,
+ *   resolveBackend,
+ * } from './ai/index.js';
+ *
+ * const registry = createBackendRegistry();
+ * const backend = await resolveBackend(registry, 'auto');
+ * const service = new AIService(backend, {
+ *   timeoutMs: 120_000,
+ *   maxRetries: 3,
+ *   telemetry: { keepRuns: 10 },
+ * });
+ *
+ * const response = await service.call({ prompt: 'Hello' });
+ * ```
+ */
+export { AIServiceError } from './types.js';
+// ---------------------------------------------------------------------------
+// Service orchestrator
+// ---------------------------------------------------------------------------
+export { AIService } from './service.js';
+// ---------------------------------------------------------------------------
+// Backend registry
+// ---------------------------------------------------------------------------
+export { BackendRegistry, createBackendRegistry, resolveBackend, detectBackend, getInstallInstructions, } from './registry.js';
+// ---------------------------------------------------------------------------
+// Retry utility
+// ---------------------------------------------------------------------------
+export { withRetry, DEFAULT_RETRY_OPTIONS } from './retry.js';
+// ---------------------------------------------------------------------------
+// Subprocess wrapper
+// ---------------------------------------------------------------------------
+export { runSubprocess } from './subprocess.js';
+// ---------------------------------------------------------------------------
+// Backend utilities
+// ---------------------------------------------------------------------------
+export { isCommandOnPath } from './backends/claude.js';
+// ---------------------------------------------------------------------------
+// Pricing
+// ---------------------------------------------------------------------------
+export { DEFAULT_MODEL_PRICING, estimateCost, lookupPricing, formatCost, formatTokens } from './pricing.js';
+//# sourceMappingURL=index.js.map