agents-reverse-engineer 0.3.6 → 0.4.0

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAkBH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAE9D,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/ai/pricing.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Cost estimation engine with pricing table, prefix matching, and format helpers.
+ *
+ * Provides hardcoded per-model pricing for major AI providers (Claude, GPT, Gemini)
+ * and utility functions for estimating, looking up, and formatting costs.
+ *
+ * @module
+ */
+/** Per-model pricing rates in cost per million tokens. */
+export interface ModelPricing {
+    /** Cost in USD per 1 million input tokens */
+    inputCostPerMTok: number;
+    /** Cost in USD per 1 million output tokens */
+    outputCostPerMTok: number;
+}
+/** Source of a cost estimate. */
+export type CostSource = 'cli-reported' | 'estimated' | 'unavailable';
+/** Result of a cost estimation with provenance tracking. */
+export interface CostEstimate {
+    /** Estimated cost in USD (0 when unavailable) */
+    costUsd: number;
+    /** How the cost was determined */
+    source: CostSource;
+}
+/**
+ * Hardcoded pricing for major AI models.
+ *
+ * Keys are model ID prefixes. Models with date suffixes (e.g.
+ * `claude-opus-4-5-20251101`) are matched via prefix lookup against these keys.
+ *
+ * Prices are in USD per million tokens, verified as of 2026-02-07.
+ */
+export declare const DEFAULT_MODEL_PRICING: Record<string, ModelPricing>;
+/**
+ * Look up pricing for a model ID, with optional config overrides.
+ *
+ * Resolution order:
+ * 1. Exact match in merged table (overrides spread over defaults)
+ * 2. Prefix match with longest-key-first ordering to avoid ambiguity
+ * 3. `undefined` if no match found
+ *
+ * @param model - Model identifier (e.g. `"claude-opus-4-5-20251101"`)
+ * @param overrides - Optional pricing overrides from user config
+ * @returns Pricing rates or `undefined` for unknown models
+ */
+export declare function lookupPricing(model: string, overrides?: Record<string, ModelPricing>): ModelPricing | undefined;
+/**
+ * Estimate the cost of an AI call.
+ *
+ * Resolution order:
+ * 1. CLI-reported cost (when available and > 0)
+ * 2. Pricing table estimate (input + output token costs)
+ * 3. Unavailable (unknown model, no CLI cost)
+ *
+ * All costs are rounded to 4 decimal places.
+ *
+ * @param model - Model identifier
+ * @param inputTokens - Number of input tokens consumed
+ * @param outputTokens - Number of output tokens generated
+ * @param cliReportedCost - Cost reported by the CLI (if available)
+ * @param overrides - Optional pricing overrides from user config
+ * @returns Cost estimate with source provenance
+ */
+export declare function estimateCost(model: string, inputTokens: number, outputTokens: number, cliReportedCost?: number, overrides?: Record<string, ModelPricing>): CostEstimate;
+/**
+ * Format a cost value for display.
+ *
+ * @param costUsd - Cost in USD
+ * @param available - Whether the cost is available (false returns "N/A")
+ * @returns Formatted cost string (e.g. `"$0.1234"` or `"N/A"`)
+ */
+export declare function formatCost(costUsd: number, available: boolean): string;
+/**
+ * Format a token count for display with appropriate suffix.
+ *
+ * - >= 1,000,000: `"1.5M"`
+ * - >= 1,000: `"42K"`
+ * - < 1,000: `"500"`
+ *
+ * @param count - Number of tokens
+ * @returns Formatted token count string
+ */
+export declare function formatTokens(count: number): string;
+//# sourceMappingURL=pricing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/ai/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,aAAa,CAAC;AAEtE,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAC;CACpB;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAqB9D,CAAC;AAMF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,YAAY,GAAG,SAAS,CAoB1B;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,MAAM,EACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GACvC,YAAY,CAoBd;AAMD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAKtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWlD"}

package/dist/ai/pricing.js

@@ -0,0 +1,149 @@
+/**
+ * Cost estimation engine with pricing table, prefix matching, and format helpers.
+ *
+ * Provides hardcoded per-model pricing for major AI providers (Claude, GPT, Gemini)
+ * and utility functions for estimating, looking up, and formatting costs.
+ *
+ * @module
+ */
+// ---------------------------------------------------------------------------
+// Default pricing table
+// ---------------------------------------------------------------------------
+/**
+ * Hardcoded pricing for major AI models.
+ *
+ * Keys are model ID prefixes. Models with date suffixes (e.g.
+ * `claude-opus-4-5-20251101`) are matched via prefix lookup against these keys.
+ *
+ * Prices are in USD per million tokens, verified as of 2026-02-07.
+ */
+export const DEFAULT_MODEL_PRICING = {
+    // Claude (Anthropic) - verified 2026-02-07
+    'claude-opus-4-6': { inputCostPerMTok: 5, outputCostPerMTok: 25 },
+    'claude-opus-4-5': { inputCostPerMTok: 5, outputCostPerMTok: 25 },
+    'claude-opus-4-1': { inputCostPerMTok: 15, outputCostPerMTok: 75 },
+    'claude-opus-4': { inputCostPerMTok: 15, outputCostPerMTok: 75 },
+    'claude-sonnet-4-5': { inputCostPerMTok: 3, outputCostPerMTok: 15 },
+    'claude-sonnet-4': { inputCostPerMTok: 3, outputCostPerMTok: 15 },
+    'claude-haiku-4-5': { inputCostPerMTok: 1, outputCostPerMTok: 5 },
+    'claude-haiku-3-5': { inputCostPerMTok: 0.80, outputCostPerMTok: 4 },
+    'claude-haiku-3': { inputCostPerMTok: 0.25, outputCostPerMTok: 1.25 },
+    // OpenAI GPT - from web search 2026-02-07
+    'gpt-4o': { inputCostPerMTok: 2.50, outputCostPerMTok: 10 },
+    'gpt-4o-mini': { inputCostPerMTok: 0.15, outputCostPerMTok: 0.60 },
+    'gpt-4': { inputCostPerMTok: 30, outputCostPerMTok: 60 },
+    // Google Gemini - from web search 2026-02-07
+    'gemini-2.5-flash': { inputCostPerMTok: 0.15, outputCostPerMTok: 0.60 },
+    'gemini-2.5-pro': { inputCostPerMTok: 1.25, outputCostPerMTok: 10 },
+    'gemini-3-flash': { inputCostPerMTok: 0.50, outputCostPerMTok: 3 },
+};
+// ---------------------------------------------------------------------------
+// Lookup
+// ---------------------------------------------------------------------------
+/**
+ * Look up pricing for a model ID, with optional config overrides.
+ *
+ * Resolution order:
+ * 1. Exact match in merged table (overrides spread over defaults)
+ * 2. Prefix match with longest-key-first ordering to avoid ambiguity
+ * 3. `undefined` if no match found
+ *
+ * @param model - Model identifier (e.g. `"claude-opus-4-5-20251101"`)
+ * @param overrides - Optional pricing overrides from user config
+ * @returns Pricing rates or `undefined` for unknown models
+ */
+export function lookupPricing(model, overrides) {
+    const table = {
+        ...DEFAULT_MODEL_PRICING,
+        ...overrides,
+    };
+    // Exact match
+    if (table[model] !== undefined) {
+        return table[model];
+    }
+    // Prefix match: sort keys longest-first so longer prefixes win
+    const keys = Object.keys(table).sort((a, b) => b.length - a.length);
+    for (const key of keys) {
+        if (model.startsWith(key)) {
+            return table[key];
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Cost estimation
+// ---------------------------------------------------------------------------
+/**
+ * Estimate the cost of an AI call.
+ *
+ * Resolution order:
+ * 1. CLI-reported cost (when available and > 0)
+ * 2. Pricing table estimate (input + output token costs)
+ * 3. Unavailable (unknown model, no CLI cost)
+ *
+ * All costs are rounded to 4 decimal places.
+ *
+ * @param model - Model identifier
+ * @param inputTokens - Number of input tokens consumed
+ * @param outputTokens - Number of output tokens generated
+ * @param cliReportedCost - Cost reported by the CLI (if available)
+ * @param overrides - Optional pricing overrides from user config
+ * @returns Cost estimate with source provenance
+ */
+export function estimateCost(model, inputTokens, outputTokens, cliReportedCost, overrides) {
+    // CLI-reported cost takes precedence when available and non-zero
+    if (cliReportedCost !== undefined && cliReportedCost > 0) {
+        return {
+            costUsd: Number(cliReportedCost.toFixed(4)),
+            source: 'cli-reported',
+        };
+    }
+    // Fall back to pricing table
+    const pricing = lookupPricing(model, overrides);
+    if (pricing === undefined) {
+        return { costUsd: 0, source: 'unavailable' };
+    }
+    const inputCost = (pricing.inputCostPerMTok * inputTokens) / 1_000_000;
+    const outputCost = (pricing.outputCostPerMTok * outputTokens) / 1_000_000;
+    const totalCost = Number((inputCost + outputCost).toFixed(4));
+    return { costUsd: totalCost, source: 'estimated' };
+}
+// ---------------------------------------------------------------------------
+// Formatting helpers
+// ---------------------------------------------------------------------------
+/**
+ * Format a cost value for display.
+ *
+ * @param costUsd - Cost in USD
+ * @param available - Whether the cost is available (false returns "N/A")
+ * @returns Formatted cost string (e.g. `"$0.1234"` or `"N/A"`)
+ */
+export function formatCost(costUsd, available) {
+    if (!available) {
+        return 'N/A';
+    }
+    return `$${costUsd.toFixed(4)}`;
+}
+/**
+ * Format a token count for display with appropriate suffix.
+ *
+ * - >= 1,000,000: `"1.5M"`
+ * - >= 1,000: `"42K"`
+ * - < 1,000: `"500"`
+ *
+ * @param count - Number of tokens
+ * @returns Formatted token count string
+ */
+export function formatTokens(count) {
+    if (count >= 1_000_000) {
+        const millions = count / 1_000_000;
+        // Remove trailing zeros: 1.0 -> 1, 1.5 -> 1.5
+        return `${parseFloat(millions.toFixed(1))}M`;
+    }
+    if (count >= 1_000) {
+        const thousands = count / 1_000;
+        return `${parseFloat(thousands.toFixed(1))}K`;
+    }
+    return `${count}`;
+}
+//# sourceMappingURL=pricing.js.map

package/dist/ai/pricing.js.map

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

package/dist/ai/pricing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pricing.test.d.ts.map

package/dist/ai/pricing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.test.d.ts","sourceRoot":"","sources":["../../src/ai/pricing.test.ts"],"names":[],"mappings":""}

package/dist/ai/pricing.test.js

@@ -0,0 +1,164 @@
+import { describe, it, expect } from 'vitest';
+import { DEFAULT_MODEL_PRICING, lookupPricing, estimateCost, formatCost, formatTokens, } from './pricing.js';
+// ---------------------------------------------------------------------------
+// DEFAULT_MODEL_PRICING
+// ---------------------------------------------------------------------------
+describe('DEFAULT_MODEL_PRICING', () => {
+    it('contains 15 models across Claude, GPT, and Gemini families', () => {
+        const keys = Object.keys(DEFAULT_MODEL_PRICING);
+        expect(keys).toHaveLength(15);
+        const claudeKeys = keys.filter((k) => k.startsWith('claude-'));
+        const gptKeys = keys.filter((k) => k.startsWith('gpt-'));
+        const geminiKeys = keys.filter((k) => k.startsWith('gemini-'));
+        expect(claudeKeys.length).toBe(9);
+        expect(gptKeys.length).toBe(3);
+        expect(geminiKeys.length).toBe(3);
+    });
+    it('has correct pricing for claude-sonnet-4', () => {
+        const pricing = DEFAULT_MODEL_PRICING['claude-sonnet-4'];
+        expect(pricing).toBeDefined();
+        expect(pricing.inputCostPerMTok).toBe(3);
+        expect(pricing.outputCostPerMTok).toBe(15);
+    });
+    it('has correct pricing for gpt-4o', () => {
+        const pricing = DEFAULT_MODEL_PRICING['gpt-4o'];
+        expect(pricing).toBeDefined();
+        expect(pricing.inputCostPerMTok).toBe(2.5);
+        expect(pricing.outputCostPerMTok).toBe(10);
+    });
+    it('has correct pricing for gemini-2.5-pro', () => {
+        const pricing = DEFAULT_MODEL_PRICING['gemini-2.5-pro'];
+        expect(pricing).toBeDefined();
+        expect(pricing.inputCostPerMTok).toBe(1.25);
+        expect(pricing.outputCostPerMTok).toBe(10);
+    });
+});
+// ---------------------------------------------------------------------------
+// lookupPricing
+// ---------------------------------------------------------------------------
+describe('lookupPricing', () => {
+    it('returns exact match for known model', () => {
+        const result = lookupPricing('claude-opus-4-5');
+        expect(result).toBeDefined();
+        expect(result.inputCostPerMTok).toBe(5);
+        expect(result.outputCostPerMTok).toBe(25);
+    });
+    it('returns prefix match for model with date suffix', () => {
+        const result = lookupPricing('claude-opus-4-5-20251101');
+        expect(result).toBeDefined();
+        expect(result.inputCostPerMTok).toBe(5);
+        expect(result.outputCostPerMTok).toBe(25);
+    });
+    it('prefers longer prefix key over shorter one', () => {
+        // 'claude-opus-4-5' should match before 'claude-opus-4'
+        const result = lookupPricing('claude-opus-4-5-20251101');
+        expect(result).toBeDefined();
+        // claude-opus-4-5 has input=5, claude-opus-4 has input=15
+        expect(result.inputCostPerMTok).toBe(5);
+    });
+    it('returns undefined for unknown model', () => {
+        const result = lookupPricing('custom-model');
+        expect(result).toBeUndefined();
+    });
+    it('uses config overrides over defaults', () => {
+        const overrides = {
+            'my-model': { inputCostPerMTok: 1, outputCostPerMTok: 5 },
+        };
+        const result = lookupPricing('my-model', overrides);
+        expect(result).toBeDefined();
+        expect(result.inputCostPerMTok).toBe(1);
+        expect(result.outputCostPerMTok).toBe(5);
+    });
+    it('config overrides take precedence over hardcoded defaults', () => {
+        const overrides = {
+            'claude-sonnet-4': { inputCostPerMTok: 99, outputCostPerMTok: 99 },
+        };
+        const result = lookupPricing('claude-sonnet-4', overrides);
+        expect(result).toBeDefined();
+        expect(result.inputCostPerMTok).toBe(99);
+        expect(result.outputCostPerMTok).toBe(99);
+    });
+});
+// ---------------------------------------------------------------------------
+// estimateCost
+// ---------------------------------------------------------------------------
+describe('estimateCost', () => {
+    it('returns CLI-reported cost when available and non-zero', () => {
+        const result = estimateCost('claude-sonnet-4', 1000, 100, 0.018);
+        expect(result.costUsd).toBe(0.018);
+        expect(result.source).toBe('cli-reported');
+    });
+    it('falls back to pricing table when CLI cost is zero', () => {
+        // claude-sonnet-4: input=3, output=15
+        // cost = (3 * 1_000_000 / 1_000_000) + (15 * 100_000 / 1_000_000) = 3 + 1.5 = 4.5
+        const result = estimateCost('claude-sonnet-4', 1_000_000, 100_000, 0);
+        expect(result.costUsd).toBe(4.5);
+        expect(result.source).toBe('estimated');
+    });
+    it('falls back to pricing table when CLI cost is undefined', () => {
+        const result = estimateCost('claude-sonnet-4', 1_000_000, 100_000);
+        expect(result.costUsd).toBe(4.5);
+        expect(result.source).toBe('estimated');
+    });
+    it('returns unavailable source when model is not in pricing table', () => {
+        const result = estimateCost('unknown-model', 1000, 100);
+        expect(result.costUsd).toBe(0);
+        expect(result.source).toBe('unavailable');
+    });
+    it('uses 4-decimal precision for estimated costs', () => {
+        // claude-haiku-3-5: input=0.80, output=4
+        // cost = (0.80 * 1234 / 1_000_000) + (4 * 567 / 1_000_000)
+        //      = 0.0009872 + 0.002268 = 0.0032552
+        // rounded to 4 decimals = 0.0033
+        const result = estimateCost('claude-haiku-3-5', 1234, 567);
+        expect(result.costUsd).toBe(0.0033);
+        expect(result.source).toBe('estimated');
+    });
+    it('passes overrides to lookupPricing', () => {
+        const overrides = {
+            'my-custom': { inputCostPerMTok: 10, outputCostPerMTok: 20 },
+        };
+        // cost = (10 * 1_000_000 / 1_000_000) + (20 * 500_000 / 1_000_000) = 10 + 10 = 20
+        const result = estimateCost('my-custom', 1_000_000, 500_000, undefined, overrides);
+        expect(result.costUsd).toBe(20);
+        expect(result.source).toBe('estimated');
+    });
+});
+// ---------------------------------------------------------------------------
+// formatCost
+// ---------------------------------------------------------------------------
+describe('formatCost', () => {
+    it('returns $X.XXXX with 4-decimal precision for available costs', () => {
+        expect(formatCost(0.1234, true)).toBe('$0.1234');
+    });
+    it('returns N/A when cost is unavailable', () => {
+        expect(formatCost(0, false)).toBe('N/A');
+    });
+    it('pads to 4 decimal places', () => {
+        expect(formatCost(1.5, true)).toBe('$1.5000');
+    });
+    it('rounds to 4 decimal places', () => {
+        expect(formatCost(0.123456, true)).toBe('$0.1235');
+    });
+});
+// ---------------------------------------------------------------------------
+// formatTokens
+// ---------------------------------------------------------------------------
+describe('formatTokens', () => {
+    it('formats millions with M suffix', () => {
+        expect(formatTokens(1_500_000)).toBe('1.5M');
+    });
+    it('formats thousands with K suffix', () => {
+        expect(formatTokens(42_000)).toBe('42K');
+    });
+    it('formats small numbers without suffix', () => {
+        expect(formatTokens(500)).toBe('500');
+    });
+    it('formats exact million', () => {
+        expect(formatTokens(1_000_000)).toBe('1M');
+    });
+    it('formats exact thousand', () => {
+        expect(formatTokens(1_000)).toBe('1K');
+    });
+});
+//# sourceMappingURL=pricing.test.js.map

package/dist/ai/pricing.test.js.map

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

package/dist/ai/registry.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Backend registry, factory, and auto-detection.
+ *
+ * Manages the set of registered AI CLI backends, selects the appropriate
+ * backend at runtime via auto-detection or explicit request, and provides
+ * actionable error messages when no CLI is found.
+ *
+ * @module
+ */
+import type { AIBackend } from './types.js';
+/**
+ * Registry of available AI CLI backends.
+ *
+ * Stores backends in insertion order, which determines the priority for
+ * auto-detection. Use {@link createBackendRegistry} to get a pre-populated
+ * registry with all supported backends.
+ *
+ * @example
+ * ```typescript
+ * const registry = createBackendRegistry();
+ * const claude = registry.get('claude');
+ * const all = registry.getAll(); // [ClaudeBackend, GeminiBackend, OpenCodeBackend]
+ * ```
+ */
+export declare class BackendRegistry {
+    private readonly backends;
+    /**
+     * Register a backend adapter.
+     *
+     * @param backend - The backend to register (keyed by its `name` property)
+     */
+    register(backend: AIBackend): void;
+    /**
+     * Get a specific backend by name.
+     *
+     * @param name - The backend name (e.g., "claude", "gemini", "opencode")
+     * @returns The backend, or `undefined` if not registered
+     */
+    get(name: string): AIBackend | undefined;
+    /**
+     * Get all registered backends in priority order.
+     *
+     * @returns Array of all registered backends
+     */
+    getAll(): AIBackend[];
+}
+/**
+ * Create a new backend registry pre-populated with all supported backends.
+ *
+ * Registration order determines auto-detection priority:
+ * 1. Claude (recommended, fully implemented)
+ * 2. Gemini (experimental, stub)
+ * 3. OpenCode (experimental, stub)
+ *
+ * @returns A populated {@link BackendRegistry}
+ *
+ * @example
+ * ```typescript
+ * const registry = createBackendRegistry();
+ * const backend = await detectBackend(registry);
+ * ```
+ */
+export declare function createBackendRegistry(): BackendRegistry;
+/**
+ * Detect the first available backend on PATH in priority order.
+ *
+ * Iterates all registered backends and calls `isAvailable()` on each.
+ * Returns the first backend whose CLI is found, or `null` if none are
+ * available.
+ *
+ * Priority order is determined by registration order in
+ * {@link createBackendRegistry}: Claude > Gemini > OpenCode.
+ *
+ * @param registry - The backend registry to search
+ * @returns The first available backend, or `null` if none found
+ *
+ * @example
+ * ```typescript
+ * const registry = createBackendRegistry();
+ * const backend = await detectBackend(registry);
+ * if (backend) {
+ *   console.log(`Using ${backend.name} backend`);
+ * }
+ * ```
+ */
+export declare function detectBackend(registry: BackendRegistry): Promise<AIBackend | null>;
+/**
+ * Get formatted install instructions for all registered backends.
+ *
+ * Returns a multi-line string suitable for error messages when no CLI
+ * is found. Matches the error message template from RESEARCH.md.
+ *
+ * @param registry - The backend registry
+ * @returns Formatted install instructions string
+ *
+ * @example
+ * ```typescript
+ * const instructions = getInstallInstructions(registry);
+ * console.error(`No AI CLI found.\n\nInstall one of the following:\n\n${instructions}`);
+ * ```
+ */
+export declare function getInstallInstructions(registry: BackendRegistry): string;
+/**
+ * Resolve a backend by name or auto-detect the best available one.
+ *
+ * - If `requested` is `'auto'`: runs {@link detectBackend} and throws with
+ *   install instructions if nothing is found.
+ * - If `requested` is a specific name: looks it up in the registry, checks
+ *   availability, and throws if not found or not available.
+ *
+ * @param registry - The backend registry
+ * @param requested - Backend name or `'auto'` for auto-detection
+ * @returns The resolved backend adapter
+ * @throws {AIServiceError} With code `CLI_NOT_FOUND` if no backend is available
+ *
+ * @example
+ * ```typescript
+ * const registry = createBackendRegistry();
+ *
+ * // Auto-detect
+ * const backend = await resolveBackend(registry, 'auto');
+ *
+ * // Explicit selection
+ * const claude = await resolveBackend(registry, 'claude');
+ * ```
+ */
+export declare function resolveBackend(registry: BackendRegistry, requested: string | 'auto'): Promise<AIBackend>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/ai/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;IAIlC;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC;;;;OAIG;IACH,MAAM,IAAI,SAAS,EAAE;CAGtB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAMvD;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAOxF;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAKxE;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAAC,SAAS,CAAC,CAmCpB"}