ghagga-core 2.5.0 → 2.6.0

package/dist/providers/cli-bridge.d.ts

@@ -0,0 +1,136 @@
+/**
+ * CLI Bridge — calls LLM CLIs directly instead of using API tokens.
+ *
+ * Supported CLIs (in auto-detect priority order):
+ * 1. opencode run --model <provider/model> --format json "<prompt>"
+ * 2. copilot -p "prompt"
+ * 3. gemini -p "prompt" --output-format text
+ *
+ * Legacy alias:
+ * - 'claude' is treated as 'opencode' with default cliModel 'anthropic/claude-sonnet-4-5'
+ *
+ * Authentication:
+ * - OpenCode: provider-specific env var (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.)
+ * - Gemini: GEMINI_API_KEY env var or google account
+ * - Copilot: COPILOT_GITHUB_TOKEN or GH_TOKEN env var
+ */
+/**
+ * Maps OpenCode provider prefixes to the env var they need for authentication.
+ * Used to inject exactly the right credential into the subprocess environment.
+ */
+export declare const OPENCODE_ENV_BY_PREFIX: Record<string, string>;
+/** Valid CLI tool names for explicit selection. */
+export type CLIToolName = 'opencode' | 'gemini' | 'copilot';
+/** Options for generateViaCLI(). */
+export interface CLIBridgeOptions {
+    /**
+     * Preferred CLI tool to use.
+     * Also accepts 'claude' as a legacy alias → mapped to 'opencode' at runtime.
+     */
+    preferredCLI?: CLIToolName | 'claude' | (string & {});
+    /** OpenCode model in `provider/model` format (e.g., 'anthropic/claude-sonnet-4-5'). */
+    cliModel?: string;
+    /** Injected credentials mapped by env var name (e.g., { ANTHROPIC_API_KEY: 'sk-...' }). */
+    credentials?: Record<string, string>;
+}
+interface CLIAdapter {
+    name: string;
+    command: string;
+    available: boolean;
+    generate: (prompt: string, systemPrompt?: string, cliModel?: string, env?: NodeJS.ProcessEnv) => string;
+}
+/**
+ * Error class for configuration failures that should NOT trigger fallback
+ * to other CLIs. These represent misconfiguration, not transient failures.
+ */
+export declare class CLIConfigurationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolve the env var name needed for a given CLI tool and model.
+ *
+ * - opencode: derives from cliModel provider prefix (e.g., 'anthropic' → 'ANTHROPIC_API_KEY')
+ * - gemini: always 'GEMINI_API_KEY'
+ * - copilot: always 'COPILOT_GITHUB_TOKEN'
+ *
+ * Returns undefined if the prefix is unknown or cliModel is not provided for opencode.
+ */
+export declare function resolveCredentialEnvVar(preferredCLI: string | undefined, cliModel?: string): string | undefined;
+/**
+ * Build a subprocess environment using the ALLOWLIST approach:
+ * 1. Start with an empty env
+ * 2. Copy ONLY known-safe vars from process.env
+ * 3. Add the single required credential
+ *
+ * This prevents credential leakage — only explicitly safe vars plus the
+ * required credential are passed to the subprocess. Any env var NOT in
+ * SAFE_ENV_VARS (e.g., AZURE_OPENAI_KEY, REPLICATE_API_TOKEN) is excluded.
+ */
+export declare function buildSubprocessEnv(credentialEnvName?: string, credentialValue?: string): NodeJS.ProcessEnv;
+/**
+ * Parse OpenCode `--format json` output.
+ *
+ * The output is newline-delimited JSON. Each line is an object with a `type` field:
+ * - `text` — contains actual LLM response text in `part.text`
+ * - `step_finish` — contains token usage in `part.tokens` and cost in `part.cost`
+ *
+ * Returns the concatenated text and optional token usage.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function parseOpenCodeOutput(raw: string): {
+    text: string;
+    tokens?: {
+        input?: number;
+        output?: number;
+    };
+};
+/**
+ * Sanitize an error message by redacting known API key patterns.
+ *
+ * This MUST be applied to all error messages before they propagate
+ * (thrown errors, console.error, progress callbacks, etc.).
+ */
+export declare function sanitizeErrorMessage(message: string): string;
+/**
+ * Validate cliModel format and provider prefix for OpenCode.
+ * Throws CLIConfigurationError for malformed or unsupported values.
+ *
+ * Only called when preferredCLI === 'opencode' and cliModel is provided.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function validateCliModel(cliModel: string): void;
+/**
+ * Get list of available CLI providers.
+ * Returns names from the adapter list (opencode, copilot, gemini).
+ */
+export declare function getAvailableCLIs(): string[];
+/**
+ * Generate text using CLI bridge.
+ * Tries each available CLI in priority order: opencode -> copilot -> gemini.
+ *
+ * Legacy alias: 'claude' is mapped to 'opencode' with default model
+ * 'anthropic/claude-sonnet-4-5'.
+ *
+ * Configuration errors (malformed cliModel, unsupported provider prefix,
+ * missing credentials) throw CLIConfigurationError immediately — they do NOT
+ * fall through to retry other CLIs.
+ *
+ * @param prompt - User prompt
+ * @param systemPrompt - Optional system prompt
+ * @param options - Optional CLI bridge options (preferredCLI, cliModel, credentials)
+ * @returns { text, provider, cli }
+ */
+export declare function generateViaCLI(prompt: string, systemPrompt?: string, options?: CLIBridgeOptions): {
+    text: string;
+    provider: string;
+    cli: string;
+};
+/**
+ * Get the raw adapters array (for testing purposes only).
+ * @internal
+ */
+export declare function _getAdapters(): readonly CLIAdapter[];
+export {};
+//# sourceMappingURL=cli-bridge.d.ts.map

package/dist/providers/cli-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-bridge.d.ts","sourceRoot":"","sources":["../../src/providers/cli-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoBH;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQzD,CAAC;AAyCF,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5D,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACtD,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,CACR,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,KACpB,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAepB;AAID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,iBAAiB,CAAC,EAAE,MAAM,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAAC,UAAU,CAgBnB;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C,CAyBA;AAiCD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAcvD;AAkID;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAuEjD;AAID;;;GAGG;AACH,wBAAgB,YAAY,IAAI,SAAS,UAAU,EAAE,CAEpD"}

package/dist/providers/cli-bridge.js

@@ -0,0 +1,457 @@
+/**
+ * CLI Bridge — calls LLM CLIs directly instead of using API tokens.
+ *
+ * Supported CLIs (in auto-detect priority order):
+ * 1. opencode run --model <provider/model> --format json "<prompt>"
+ * 2. copilot -p "prompt"
+ * 3. gemini -p "prompt" --output-format text
+ *
+ * Legacy alias:
+ * - 'claude' is treated as 'opencode' with default cliModel 'anthropic/claude-sonnet-4-5'
+ *
+ * Authentication:
+ * - OpenCode: provider-specific env var (ANTHROPIC_API_KEY, OPENAI_API_KEY, etc.)
+ * - Gemini: GEMINI_API_KEY env var or google account
+ * - Copilot: COPILOT_GITHUB_TOKEN or GH_TOKEN env var
+ */
+import { execSync } from 'node:child_process';
+import { unlinkSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+// ─── Constants ──────────────────────────────────────────────────
+/** Default model used when 'claude' legacy alias is resolved to 'opencode'. */
+const CLAUDE_LEGACY_DEFAULT_MODEL = 'anthropic/claude-sonnet-4-5';
+/** Prompt size threshold (in chars) above which stdin is used instead of inline arg. */
+const STDIN_THRESHOLD = 10_000;
+/** Regex for validating OpenCode cliModel format: `provider/model`. */
+const CLI_MODEL_REGEX = /^[^/]+\/.+$/;
+// ─── Env-Var Mapping ────────────────────────────────────────────
+/**
+ * Maps OpenCode provider prefixes to the env var they need for authentication.
+ * Used to inject exactly the right credential into the subprocess environment.
+ */
+export const OPENCODE_ENV_BY_PREFIX = {
+    opencode: '', // Free models — no API key needed
+    anthropic: 'ANTHROPIC_API_KEY',
+    openai: 'OPENAI_API_KEY',
+    google: 'GEMINI_API_KEY',
+    'github-copilot': 'GITHUB_TOKEN',
+    groq: 'GROQ_API_KEY',
+    openrouter: 'OPENROUTER_API_KEY',
+};
+/**
+ * Known-safe env vars that the subprocess needs to function.
+ * Only these (plus the single required credential) are copied into the subprocess env.
+ *
+ * This ALLOWLIST approach prevents credential leakage — any env var NOT listed here
+ * (e.g., AZURE_OPENAI_KEY, REPLICATE_API_TOKEN) is automatically excluded.
+ */
+const SAFE_ENV_VARS = [
+    'PATH',
+    'HOME',
+    'USER',
+    'SHELL',
+    'LANG',
+    'LC_ALL',
+    'LC_CTYPE',
+    'TERM',
+    'TMPDIR',
+    'TMP',
+    'TEMP',
+    'NODE_ENV',
+    'NODE_PATH',
+    'NODE_EXTRA_CA_CERTS',
+    'HTTP_PROXY',
+    'HTTPS_PROXY',
+    'NO_PROXY',
+    'http_proxy',
+    'https_proxy',
+    'no_proxy',
+    'SSL_CERT_FILE',
+    'SSL_CERT_DIR',
+    'NODE_TLS_REJECT_UNAUTHORIZED',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'XDG_CACHE_HOME',
+    'XDG_RUNTIME_DIR',
+];
+/**
+ * Error class for configuration failures that should NOT trigger fallback
+ * to other CLIs. These represent misconfiguration, not transient failures.
+ */
+export class CLIConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CLIConfigurationError';
+    }
+}
+// ─── CLI Detection ──────────────────────────────────────────────
+/**
+ * Detect whether a CLI command is installed on the system.
+ * Uses `which` to check PATH availability.
+ */
+function detectCLI(command) {
+    try {
+        execSync(`which ${command}`, { timeout: 3000, stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── CLI Exec Options ───────────────────────────────────────────
+const CLI_EXEC_OPTIONS = {
+    timeout: 180_000,
+    maxBuffer: 10 * 1024 * 1024,
+    encoding: 'utf8',
+    stdio: ['pipe', 'pipe', 'pipe'],
+};
+// ─── Credential Resolution ──────────────────────────────────────
+/**
+ * Resolve the env var name needed for a given CLI tool and model.
+ *
+ * - opencode: derives from cliModel provider prefix (e.g., 'anthropic' → 'ANTHROPIC_API_KEY')
+ * - gemini: always 'GEMINI_API_KEY'
+ * - copilot: always 'COPILOT_GITHUB_TOKEN'
+ *
+ * Returns undefined if the prefix is unknown or cliModel is not provided for opencode.
+ */
+export function resolveCredentialEnvVar(preferredCLI, cliModel) {
+    switch (preferredCLI) {
+        case 'opencode': {
+            if (!cliModel)
+                return undefined;
+            const prefix = cliModel.split('/')[0];
+            if (!prefix)
+                return undefined;
+            return OPENCODE_ENV_BY_PREFIX[prefix];
+        }
+        case 'gemini':
+            return 'GEMINI_API_KEY';
+        case 'copilot':
+            return 'COPILOT_GITHUB_TOKEN';
+        default:
+            return undefined;
+    }
+}
+// ─── Subprocess Environment ─────────────────────────────────────
+/**
+ * Build a subprocess environment using the ALLOWLIST approach:
+ * 1. Start with an empty env
+ * 2. Copy ONLY known-safe vars from process.env
+ * 3. Add the single required credential
+ *
+ * This prevents credential leakage — only explicitly safe vars plus the
+ * required credential are passed to the subprocess. Any env var NOT in
+ * SAFE_ENV_VARS (e.g., AZURE_OPENAI_KEY, REPLICATE_API_TOKEN) is excluded.
+ */
+export function buildSubprocessEnv(credentialEnvName, credentialValue) {
+    const env = {};
+    // Copy only known-safe vars from process.env
+    for (const key of SAFE_ENV_VARS) {
+        if (process.env[key] !== undefined) {
+            env[key] = process.env[key];
+        }
+    }
+    // Add the single required credential
+    if (credentialEnvName && credentialValue) {
+        env[credentialEnvName] = credentialValue;
+    }
+    return env;
+}
+/**
+ * Parse OpenCode `--format json` output.
+ *
+ * The output is newline-delimited JSON. Each line is an object with a `type` field:
+ * - `text` — contains actual LLM response text in `part.text`
+ * - `step_finish` — contains token usage in `part.tokens` and cost in `part.cost`
+ *
+ * Returns the concatenated text and optional token usage.
+ *
+ * @internal Exported for testing only.
+ */
+export function parseOpenCodeOutput(raw) {
+    const lines = raw.split('\n').filter((line) => line.trim().length > 0);
+    const textParts = [];
+    let tokens;
+    for (const line of lines) {
+        try {
+            const event = JSON.parse(line);
+            if (event.type === 'text') {
+                const textEvent = event;
+                if (textEvent.part?.text) {
+                    textParts.push(textEvent.part.text);
+                }
+            }
+            else if (event.type === 'step_finish') {
+                const finishEvent = event;
+                if (finishEvent.part?.tokens) {
+                    tokens = finishEvent.part.tokens;
+                }
+            }
+        }
+        catch {
+            // Skip malformed JSON lines (e.g., partial output on error)
+        }
+    }
+    return { text: textParts.join(''), tokens };
+}
+// ─── Error Sanitization ─────────────────────────────────────────
+/**
+ * Known API key patterns that must be redacted from error messages.
+ * Each regex captures a token prefix and enough context to identify the key type,
+ * then matches the rest of the key value.
+ *
+ * Constructed at runtime (split+join) to avoid triggering GitHub push protection
+ * on pattern literals.
+ */
+const API_KEY_PATTERNS = [
+    // Anthropic: sk-ant-*
+    /sk-ant-[a-zA-Z0-9_-]{10,}/g,
+    // OpenAI: sk-proj*, sk-<20+ alphanum>
+    /sk-[a-zA-Z0-9]{20,}/g,
+    // Google: AIza*
+    /AIza[a-zA-Z0-9_-]{30,}/g,
+    // GitHub PAT (classic): ghp_*
+    /ghp_[a-zA-Z0-9]{30,}/g,
+    // GitHub PAT (fine-grained): github_pat_*
+    /github_pat_[a-zA-Z0-9_]{30,}/g,
+    // Groq: gsk_*
+    /gsk_[a-zA-Z0-9]{20,}/g,
+    // OpenRouter: sk-or-*
+    /\bsk-or-[a-zA-Z0-9_-]{20,}\b/g,
+    // GitHub OAuth/App tokens: gho_*, ghs_*
+    /gh[os]_[a-zA-Z0-9]{30,}/g,
+    // Copilot/GitHub general token (catch-all for longer tokens)
+    /ghp_[a-zA-Z0-9]{20,}/g,
+];
+/**
+ * Sanitize an error message by redacting known API key patterns.
+ *
+ * This MUST be applied to all error messages before they propagate
+ * (thrown errors, console.error, progress callbacks, etc.).
+ */
+export function sanitizeErrorMessage(message) {
+    let sanitized = message;
+    for (const pattern of API_KEY_PATTERNS) {
+        // Reset lastIndex for global regexes
+        pattern.lastIndex = 0;
+        sanitized = sanitized.replace(pattern, '[REDACTED_KEY]');
+    }
+    return sanitized;
+}
+// ─── Validation Helpers ─────────────────────────────────────────
+/**
+ * Validate cliModel format and provider prefix for OpenCode.
+ * Throws CLIConfigurationError for malformed or unsupported values.
+ *
+ * Only called when preferredCLI === 'opencode' and cliModel is provided.
+ *
+ * @internal Exported for testing only.
+ */
+export function validateCliModel(cliModel) {
+    if (!CLI_MODEL_REGEX.test(cliModel)) {
+        throw new CLIConfigurationError(`Invalid cliModel format: '${cliModel}'. Expected 'provider/model' (e.g., 'anthropic/claude-sonnet-4-5').`);
+    }
+    const prefix = cliModel.split('/')[0];
+    if (!(prefix in OPENCODE_ENV_BY_PREFIX)) {
+        const supported = Object.keys(OPENCODE_ENV_BY_PREFIX).join(', ');
+        throw new CLIConfigurationError(`Unsupported OpenCode provider prefix: '${prefix}'. Supported prefixes: ${supported}.`);
+    }
+}
+/**
+ * Validate that credentials are available for the selected tool.
+ * Throws CLIConfigurationError if the required credential is missing
+ * from both the injected credentials and the server environment.
+ */
+function validateCredentials(credentialEnvName, credentials) {
+    if (!credentialEnvName)
+        return; // No credential needed (free models or auto mode)
+    // Check injected credentials first
+    if (credentials) {
+        const value = credentials[credentialEnvName];
+        if (value && value.length > 0)
+            return; // Has injected credential
+    }
+    // Check server environment as fallback
+    const serverValue = process.env[credentialEnvName];
+    if (serverValue && serverValue.length > 0)
+        return; // Has server env credential
+    throw new CLIConfigurationError(`Missing credential for CLI tool. Expected env var '${credentialEnvName}' to be set, ` +
+        `or provide it via installation credentials.`);
+}
+// ─── Adapters ───────────────────────────────────────────────────
+const adapters = [
+    {
+        name: 'opencode',
+        command: 'opencode',
+        available: detectCLI('opencode'),
+        generate(prompt, systemPrompt, cliModel, env) {
+            const fullPrompt = systemPrompt ? `${systemPrompt}\n\n${prompt}` : prompt;
+            // Build args: opencode run --model <model> --format json [inline-prompt]
+            const args = ['run'];
+            if (cliModel) {
+                args.push('--model', cliModel);
+            }
+            args.push('--format', 'json');
+            const cmdArgs = args.map((a) => JSON.stringify(a)).join(' ');
+            const execOptions = {
+                ...CLI_EXEC_OPTIONS,
+                ...(env ? { env } : {}),
+            };
+            let raw;
+            const cmd = fullPrompt.length > STDIN_THRESHOLD
+                ? `opencode ${cmdArgs}`
+                : `opencode ${cmdArgs} ${JSON.stringify(fullPrompt)}`;
+            try {
+                raw = execSync(cmd, {
+                    ...execOptions,
+                    ...(fullPrompt.length > STDIN_THRESHOLD ? { input: fullPrompt } : {}),
+                });
+            }
+            catch (execError) {
+                // execSync throws on non-zero exit — capture stderr for diagnostics
+                const err = execError;
+                const stderr = err.stderr ? String(err.stderr).slice(0, 500) : 'no stderr';
+                const stdout = err.stdout ? String(err.stdout).slice(0, 200) : 'no stdout';
+                throw new Error(`OpenCode exited with status ${err.status ?? 'unknown'}. stderr: ${sanitizeErrorMessage(stderr)}. stdout: ${sanitizeErrorMessage(stdout)}`);
+            }
+            const parsed = parseOpenCodeOutput(raw);
+            if (!parsed.text) {
+                // Log raw output for debugging empty responses
+                const preview = raw.slice(0, 500) || '(empty)';
+                throw new Error(`OpenCode returned no text content in JSON output. Raw preview: ${preview}`);
+            }
+            return parsed.text.trim();
+        },
+    },
+    {
+        name: 'copilot',
+        command: 'copilot',
+        available: detectCLI('copilot'),
+        generate(prompt, _systemPrompt, _cliModel, env) {
+            // copilot -p takes prompt as argument — too large for ARG_MAX with big diffs.
+            // Write to temp file and tell copilot to read it.
+            const tmpFile = join(tmpdir(), `ghagga-prompt-${process.pid}-${Date.now()}.txt`);
+            try {
+                writeFileSync(tmpFile, prompt, 'utf8');
+                return execSync(`copilot -p "Read and analyze the file at ${tmpFile} and provide a code review"`, { ...CLI_EXEC_OPTIONS, ...(env ? { env } : {}) }).trim();
+            }
+            finally {
+                try {
+                    unlinkSync(tmpFile);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        },
+    },
+    {
+        name: 'gemini',
+        command: 'gemini',
+        available: detectCLI('gemini'),
+        generate(prompt, systemPrompt, _cliModel, env) {
+            // Gemini auto-detects non-TTY stdin and reads from it
+            const fullPrompt = systemPrompt ? `${systemPrompt}\n\n${prompt}` : prompt;
+            return execSync('gemini -p - --output-format text', {
+                ...CLI_EXEC_OPTIONS,
+                ...(env ? { env } : {}),
+                input: fullPrompt,
+            }).trim();
+        },
+    },
+];
+// ─── Public API ─────────────────────────────────────────────────
+/**
+ * Get list of available CLI providers.
+ * Returns names from the adapter list (opencode, copilot, gemini).
+ */
+export function getAvailableCLIs() {
+    return adapters.filter((a) => a.available).map((a) => a.name);
+}
+/**
+ * Generate text using CLI bridge.
+ * Tries each available CLI in priority order: opencode -> copilot -> gemini.
+ *
+ * Legacy alias: 'claude' is mapped to 'opencode' with default model
+ * 'anthropic/claude-sonnet-4-5'.
+ *
+ * Configuration errors (malformed cliModel, unsupported provider prefix,
+ * missing credentials) throw CLIConfigurationError immediately — they do NOT
+ * fall through to retry other CLIs.
+ *
+ * @param prompt - User prompt
+ * @param systemPrompt - Optional system prompt
+ * @param options - Optional CLI bridge options (preferredCLI, cliModel, credentials)
+ * @returns { text, provider, cli }
+ */
+export function generateViaCLI(prompt, systemPrompt, options) {
+    const { preferredCLI: rawPreferredCLI, cliModel: rawCliModel, credentials } = options ?? {};
+    // ── Legacy alias: 'claude' → 'opencode' with default model ──
+    let resolvedCLI = rawPreferredCLI;
+    let cliModel = rawCliModel;
+    if (rawPreferredCLI === 'claude') {
+        resolvedCLI = 'opencode';
+        if (!cliModel) {
+            cliModel = CLAUDE_LEGACY_DEFAULT_MODEL;
+        }
+    }
+    // ── Validate cliModel (configuration error = hard fail) ──
+    if (resolvedCLI === 'opencode' && cliModel) {
+        validateCliModel(cliModel);
+    }
+    // ── Resolve credential env var ──
+    const credentialEnvName = resolveCredentialEnvVar(resolvedCLI, cliModel);
+    // ── Validate credentials (configuration error = hard fail) ──
+    if (resolvedCLI && credentialEnvName) {
+        validateCredentials(credentialEnvName, credentials);
+    }
+    // ── Build subprocess environment ──
+    let subprocessEnv;
+    if (credentials && credentialEnvName) {
+        const credentialValue = credentials[credentialEnvName];
+        subprocessEnv = buildSubprocessEnv(credentialEnvName, credentialValue);
+    }
+    const available = adapters.filter((a) => a.available);
+    if (available.length === 0) {
+        throw new Error('No CLI providers available. Install one of: opencode, copilot, gemini');
+    }
+    // Reorder: preferred first, then rest
+    const ordered = resolvedCLI
+        ? [
+            ...available.filter((a) => a.name === resolvedCLI),
+            ...available.filter((a) => a.name !== resolvedCLI),
+        ]
+        : available;
+    for (const adapter of ordered) {
+        try {
+            // Pass cliModel only to the opencode adapter (others ignore it)
+            const modelArg = adapter.name === 'opencode' ? cliModel : undefined;
+            const text = adapter.generate(prompt, systemPrompt, modelArg, subprocessEnv);
+            return { text, provider: 'cli-bridge', cli: adapter.name };
+        }
+        catch (error) {
+            // CLIConfigurationError should NOT be caught — re-throw immediately
+            if (error instanceof CLIConfigurationError) {
+                throw error;
+            }
+            // Truncate error message — stderr from CLI failures can contain the entire prompt
+            // (including huge diffs like package-lock.json), making logs unreadable.
+            // Sanitize to redact any leaked credentials in error output.
+            const fullMessage = error.message ?? String(error);
+            const truncated = fullMessage.length > 500 ? `${fullMessage.slice(0, 500)}... [truncated]` : fullMessage;
+            console.error(`[cli-bridge] ${adapter.name} failed: ${sanitizeErrorMessage(truncated)}`);
+        }
+    }
+    throw new Error(`All CLI providers failed: ${available.map((a) => a.name).join(', ')}`);
+}
+// ─── Test Helpers ───────────────────────────────────────────────
+/**
+ * Get the raw adapters array (for testing purposes only).
+ * @internal
+ */
+export function _getAdapters() {
+    return adapters;
+}
+//# sourceMappingURL=cli-bridge.js.map

package/dist/providers/cli-bridge.js.map

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

package/dist/providers/fallback.d.ts

@@ -31,6 +31,14 @@ export interface FallbackResult {
     /** Approximate tokens used (prompt + completion) */
     tokensUsed: number;
 }
+/**
+ * Check if an error is retryable (should try the next provider in the chain).
+ *
+ * Retryable: 5xx, timeouts, rate limits (429), and payload-too-large (413).
+ * The 413 case is important for free-tier providers with low TPM limits —
+ * the next provider in the chain may have a higher limit.
+ */
+export declare function isRetryableError(error: unknown): boolean;
 /**
  * Generate text with automatic provider fallback.
  *

package/dist/providers/fallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/providers/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAE9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IAEf,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,QAAQ,EAAE,WAAW,CAAC;IAEtB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAsCD;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgD5F"}
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/providers/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAE9B,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IAEf,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,8BAA8B;IAC9B,QAAQ,EAAE,WAAW,CAAC;IAEtB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmCxD;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA0D5F"}