fixo-cli 1.0.0

package/dist/agent/providers-manager.js

@@ -0,0 +1,464 @@
+/**
+ * FixO CLI Provider Connector Manager.
+ * Manages user-supplied API keys for direct provider access,
+ * stored securely at ~/.fixocli/providers.json (mode 0600).
+ *
+ * When a direct key exists for a provider, FixO bypasses the
+ * FreeLLMAPI SaaS proxy and calls the provider's API natively.
+ *
+ * Pillar 4: the legacy `getDirectConfig(name)` method is now
+ * a thin wrapper around the {@link ProviderKeyVault} singleton.
+ * New code should use `withDirectCredential(name, fn)` instead,
+ * which exposes the credential exclusively inside a scoped
+ * callback so the raw key never escapes into a wider stack
+ * frame, an error message, or a log line.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { getProviderKeyVault, resetProviderKeyVault, } from '../runtime/credential-vault.js';
+export const PROVIDER_REGISTRY = [
+    {
+        name: 'openai',
+        displayName: 'OpenAI',
+        baseUrl: 'https://api.openai.com/v1',
+        openAICompat: true,
+        models: ['gpt-4o', 'gpt-4o-mini', 'o3', 'o4-mini', 'gpt-4.1'],
+        requiresKey: true,
+        docsUrl: 'https://platform.openai.com/api-keys',
+    },
+    {
+        name: 'anthropic',
+        displayName: 'Anthropic (Claude)',
+        baseUrl: 'https://api.anthropic.com/v1',
+        openAICompat: false,
+        models: ['claude-opus-4-5', 'claude-sonnet-4-5', 'claude-haiku-3-5'],
+        requiresKey: true,
+        docsUrl: 'https://console.anthropic.com/settings/keys',
+    },
+    {
+        name: 'google',
+        displayName: 'Google (Gemini)',
+        baseUrl: 'https://generativelanguage.googleapis.com/v1beta/openai',
+        openAICompat: true,
+        models: ['gemini-2.5-pro', 'gemini-2.5-flash', 'gemini-2.0-flash'],
+        requiresKey: true,
+        docsUrl: 'https://aistudio.google.com/app/apikey',
+    },
+    {
+        name: 'groq',
+        displayName: 'Groq',
+        baseUrl: 'https://api.groq.com/openai/v1',
+        openAICompat: true,
+        models: ['llama-3.3-70b-versatile', 'llama-3.1-8b-instant', 'mixtral-8x7b-32768', 'gemma2-9b-it'],
+        requiresKey: true,
+        docsUrl: 'https://console.groq.com/keys',
+    },
+    {
+        name: 'mistral',
+        displayName: 'Mistral AI',
+        baseUrl: 'https://api.mistral.ai/v1',
+        openAICompat: true,
+        models: ['mistral-large-latest', 'mistral-small-latest', 'codestral-latest'],
+        requiresKey: true,
+        docsUrl: 'https://console.mistral.ai/api-keys/',
+    },
+    {
+        name: 'cohere',
+        displayName: 'Cohere',
+        baseUrl: 'https://api.cohere.ai/compatibility/v1',
+        openAICompat: true,
+        models: ['command-r-plus', 'command-r', 'command-a-03-2025'],
+        requiresKey: true,
+        docsUrl: 'https://dashboard.cohere.com/api-keys',
+    },
+    {
+        name: 'openrouter',
+        displayName: 'OpenRouter',
+        baseUrl: 'https://openrouter.ai/api/v1',
+        openAICompat: true,
+        models: ['anthropic/claude-opus-4-5', 'openai/gpt-4o', 'google/gemini-2.5-pro', 'meta-llama/llama-4-maverick'],
+        requiresKey: true,
+        docsUrl: 'https://openrouter.ai/keys',
+    },
+    {
+        name: 'nvidia',
+        displayName: 'NVIDIA NIM',
+        baseUrl: 'https://integrate.api.nvidia.com/v1',
+        openAICompat: true,
+        models: ['nvidia/llama-3.1-nemotron-ultra-253b-v1', 'meta/llama-3.1-405b-instruct'],
+        requiresKey: true,
+        docsUrl: 'https://build.nvidia.com/explore/discover',
+    },
+    {
+        name: 'cerebras',
+        displayName: 'Cerebras',
+        baseUrl: 'https://api.cerebras.ai/v1',
+        openAICompat: true,
+        models: ['llama3.3-70b', 'llama-4-scout-17b-16e-instruct', 'qwen-3-32b'],
+        requiresKey: true,
+        docsUrl: 'https://cloud.cerebras.ai/',
+    },
+    {
+        name: 'sambanova',
+        displayName: 'SambaNova',
+        baseUrl: 'https://api.sambanova.ai/v1',
+        openAICompat: true,
+        models: ['Meta-Llama-3.3-70B-Instruct', 'DeepSeek-R1-671B', 'Llama-4-Maverick-17B-128E-Instruct'],
+        requiresKey: true,
+        docsUrl: 'https://cloud.sambanova.ai/',
+    },
+    {
+        name: 'github',
+        displayName: 'GitHub Models',
+        baseUrl: 'https://models.github.ai/inference',
+        openAICompat: true,
+        models: ['openai/gpt-4o', 'microsoft/phi-4', 'meta/llama-3.3-70b-instruct'],
+        requiresKey: true,
+        docsUrl: 'https://github.com/settings/tokens',
+    },
+    {
+        name: 'xai',
+        displayName: 'xAI (Grok)',
+        baseUrl: 'https://api.x.ai/v1',
+        openAICompat: true,
+        models: ['grok-3', 'grok-3-mini', 'grok-2-1212'],
+        requiresKey: true,
+        docsUrl: 'https://console.x.ai/',
+    },
+    {
+        name: 'zen',
+        displayName: 'Zen (OpenCode)',
+        baseUrl: 'https://opencode.ai/zen/v1',
+        openAICompat: true,
+        models: [
+            'kimi-k2.6',
+            'mimo-v2.5-free',
+            'minimax-m2.7',
+            'minimax-m3-free',
+            'nemotron-3-super-free',
+            'qwen3.5-plus',
+            'qwen3.6-plus',
+            'stepfun/step-3.5-flash-free',
+            'z-ai/glm-4.7-flash-free',
+            'deepseek/deepseek-chat',
+        ],
+        requiresKey: true,
+        docsUrl: 'https://opencode.ai/zen',
+    },
+];
+/* ──────────────────────── ProvidersManager ──────────────────────── */
+function getProvidersFilePath() {
+    return path.join(os.homedir(), '.fixocli', 'providers.json');
+}
+function loadStore() {
+    const filePath = getProvidersFilePath();
+    try {
+        if (!fs.existsSync(filePath))
+            return {};
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+function saveStore(store) {
+    const dir = path.join(os.homedir(), '.fixocli');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    const filePath = getProvidersFilePath();
+    fs.writeFileSync(filePath, JSON.stringify(store, null, 2) + '\n', {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+    try {
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch { /* ignore */ }
+}
+function maskKey(key) {
+    if (key.length <= 8)
+        return '••••••••';
+    return key.slice(0, 6) + '••••••' + key.slice(-4);
+}
+const MODELS_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+function getModelsCachePath() {
+    return path.join(os.homedir(), '.fixocli', 'models-cache.json');
+}
+function loadModelsCache() {
+    const filePath = getModelsCachePath();
+    try {
+        if (!fs.existsSync(filePath))
+            return {};
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function saveModelsCache(store) {
+    const dir = path.join(os.homedir(), '.fixocli');
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+    const filePath = getModelsCachePath();
+    fs.writeFileSync(filePath, JSON.stringify(store, null, 2) + '\n', {
+        encoding: 'utf-8',
+        mode: 0o600,
+    });
+    try {
+        fs.chmodSync(filePath, 0o600);
+    }
+    catch { /* ignore */ }
+}
+/**
+ * Build the same provider-specific headers that the existing
+ * `/providers test` flow uses. Kept here so the live-fetch path
+ * and the legacy test path can share one source of truth.
+ */
+function buildModelsRequestHeaders(name, apiKey) {
+    const headers = {
+        'Authorization': `Bearer ${apiKey}`,
+    };
+    if (name === 'zen' || name === 'openrouter') {
+        headers['HTTP-Referer'] = 'https://opencode.ai/';
+        headers['X-Title'] = 'opencode';
+    }
+    else if (name === 'nvidia') {
+        headers['HTTP-Referer'] = 'https://opencode.ai/';
+        headers['X-Title'] = 'opencode';
+        headers['X-BILLING-INVOKE-ORIGIN'] = 'OpenCode';
+    }
+    else if (name === 'cerebras') {
+        headers['X-Cerebras-3rd-Party-Integration'] = 'opencode';
+    }
+    return headers;
+}
+function parseModelsResponse(payload) {
+    if (!payload || typeof payload !== 'object')
+        return null;
+    const data = payload.data;
+    if (!Array.isArray(data))
+        return null;
+    const ids = data
+        .map(m => (m && typeof m === 'object' && typeof m.id === 'string') ? m.id : null)
+        .filter((s) => typeof s === 'string' && s.length > 0);
+    return ids.length > 0 ? ids : null;
+}
+export const ProvidersManager = {
+    /** List all connected providers with masked keys. */
+    list() {
+        const store = loadStore();
+        return Object.entries(store).map(([name, entry]) => {
+            const def = PROVIDER_REGISTRY.find(p => p.name === name);
+            return {
+                name,
+                displayName: def?.displayName ?? name,
+                maskedKey: maskKey(entry.apiKey),
+                addedAt: entry.addedAt,
+            };
+        });
+    },
+    /** Add or update a provider API key. */
+    add(name, apiKey, note) {
+        const store = loadStore();
+        store[name] = {
+            apiKey: apiKey.trim(),
+            addedAt: new Date().toISOString(),
+            ...(note ? { note } : {}),
+        };
+        saveStore(store);
+        // Keep the vault in sync so callers using withDirectCredential
+        // see the new key without having to wait for the next
+        // hydration.
+        const def = PROVIDER_REGISTRY.find((p) => p.name === name);
+        if (def) {
+            getProviderKeyVault().ingest(name, apiKey.trim(), def.baseUrl, def.displayName);
+        }
+    },
+    /** Remove a provider key. Returns true if removed, false if not found. */
+    remove(name) {
+        const store = loadStore();
+        if (!store[name])
+            return false;
+        delete store[name];
+        saveStore(store);
+        getProviderKeyVault().evict(name);
+        return true;
+    },
+    /** Get the raw API key for a provider, or null if not configured. */
+    getKey(name) {
+        const store = loadStore();
+        return store[name]?.apiKey ?? null;
+    },
+    /** Get the base URL and key for a provider — for direct bypass. */
+    getDirectConfig(name) {
+        // Lazily hydrate the vault on first access.
+        this.hydrateVault();
+        const store = loadStore();
+        const entry = store[name];
+        if (!entry)
+            return null;
+        const def = PROVIDER_REGISTRY.find(p => p.name === name);
+        if (!def)
+            return null;
+        // Re-ingest in case the on-disk key was added since the last
+        // hydration. Idempotent: ingest() overwrites by name.
+        getProviderKeyVault().ingest(name, entry.apiKey, def.baseUrl, def.displayName);
+        return {
+            apiKey: entry.apiKey,
+            baseUrl: def.baseUrl,
+            displayName: def.displayName,
+        };
+    },
+    /**
+     * Run `fn` with a direct provider's full credential
+     * ({@link ProviderCredential}) handed in via a scoped
+     * callback. The credential is sourced from the in-memory
+     * {@link ProviderKeyVault} and is only reachable inside `fn`.
+     *
+     * Use this in preference to `getDirectConfig(name)` whenever
+     * possible — it keeps the raw API key out of return values,
+     * error stacks, and exception payloads.
+     */
+    async withDirectCredential(name, fn) {
+        if (!this.has(name))
+            return null;
+        // Make sure the vault is hydrated.
+        this.hydrateVault();
+        const def = this.getDefinition(name);
+        const vault = getProviderKeyVault();
+        return await vault.withCredential(name, (cred) => fn({ ...cred, openAICompat: def ? def.openAICompat : true }));
+    },
+    /**
+     * Populate the {@link ProviderKeyVault} from the on-disk
+     * providers store. Idempotent: re-running it is safe and
+     * only refreshes entries for providers that have keys on
+     * disk. Called automatically on first direct-config access.
+     */
+    hydrateVault() {
+        const store = loadStore();
+        const vault = getProviderKeyVault();
+        for (const [name, entry] of Object.entries(store)) {
+            const def = PROVIDER_REGISTRY.find((p) => p.name === name);
+            vault.ingest(name, entry.apiKey, def ? def.baseUrl : '', def ? def.displayName : name);
+        }
+    },
+    /**
+     * Drop the cached vault singleton. Used by the
+     * `/fixo providers:reset` slash command and by tests.
+     */
+    resetVault() {
+        resetProviderKeyVault();
+    },
+    /** Check if a provider key is configured. */
+    has(name) {
+        const store = loadStore();
+        return !!store[name];
+    },
+    /** Get provider definition by name. */
+    getDefinition(name) {
+        return PROVIDER_REGISTRY.find(p => p.name === name);
+    },
+    /** Get all registered provider definitions. */
+    getAllDefinitions() {
+        return PROVIDER_REGISTRY;
+    },
+    /**
+     * Read the cached model list for `name`. Returns `null` when no
+     * entry exists or when the entry is stale (older than
+     * {@link MODELS_CACHE_TTL_MS}). Synchronous + read-only so the
+     * `/model` picker can call it inline without awaiting.
+     */
+    getCachedModels(name) {
+        const store = loadModelsCache();
+        const entry = store[name];
+        if (!entry)
+            return null;
+        const fetchedAtMs = Date.parse(entry.fetchedAt);
+        if (!Number.isFinite(fetchedAtMs))
+            return null;
+        if (Date.now() - fetchedAtMs > MODELS_CACHE_TTL_MS)
+            return null;
+        return entry;
+    },
+    /**
+     * Fetch the live model list from the provider's `/models`
+     * endpoint and persist it to the on-disk cache. Routes through
+     * the credential vault so the raw API key never escapes into a
+     * wider stack frame.
+     *
+     * Resolution order:
+     *   1. live fetch (success → cache + return `source: 'live'`).
+     *   2. fresh cache hit (within TTL) → `source: 'cache'`.
+     *   3. registry `models[]` fallback → `source: 'registry-fallback'`.
+     *
+     * Never throws — failure modes degrade through the layers above.
+     */
+    async fetchRemoteModels(name) {
+        const def = this.getDefinition(name);
+        if (!def) {
+            const fallback = this.getCachedModels(name);
+            if (fallback) {
+                return { models: fallback.models, source: 'cache', fetchedAt: fallback.fetchedAt };
+            }
+            return { models: [], source: 'registry-fallback', fetchedAt: new Date().toISOString() };
+        }
+        const registryFallback = () => {
+            const now = new Date().toISOString();
+            // Persist a synthetic entry tagged registry-fallback so the
+            // /model picker can render the `[unverified]` hint without
+            // having to know whether a live fetch was ever attempted.
+            const store = loadModelsCache();
+            store[name] = { models: def.models.slice(), fetchedAt: now, source: 'registry-fallback' };
+            try {
+                saveModelsCache(store);
+            }
+            catch { /* ignore */ }
+            return { models: def.models.slice(), source: 'registry-fallback', fetchedAt: now };
+        };
+        // No key on disk → cannot live-fetch; fall through to cache → registry.
+        if (!this.has(name)) {
+            const cached = this.getCachedModels(name);
+            if (cached) {
+                return { models: cached.models, source: 'cache', fetchedAt: cached.fetchedAt };
+            }
+            return registryFallback();
+        }
+        const liveResult = await this.withDirectCredential(name, async (cred) => {
+            try {
+                const headers = buildModelsRequestHeaders(name, cred.apiKey);
+                const resp = await fetch(`${cred.baseUrl}/models`, {
+                    headers,
+                    signal: AbortSignal.timeout(8000),
+                });
+                if (!resp.ok)
+                    return null;
+                const payload = await resp.json().catch(() => null);
+                const ids = parseModelsResponse(payload);
+                if (!ids)
+                    return null;
+                const now = new Date().toISOString();
+                const store = loadModelsCache();
+                store[name] = { models: ids, fetchedAt: now, source: 'live' };
+                saveModelsCache(store);
+                return { models: ids, source: 'live', fetchedAt: now };
+            }
+            catch {
+                return null;
+            }
+        });
+        if (liveResult)
+            return liveResult;
+        const cached = this.getCachedModels(name);
+        if (cached) {
+            return { models: cached.models, source: 'cache', fetchedAt: cached.fetchedAt };
+        }
+        return registryFallback();
+    },
+};
+//# sourceMappingURL=providers-manager.js.map

package/dist/agent/providers-manager.js.map

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

package/dist/agent/repo-map.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build a compact repo map string suitable for LLM context injection.
+ * Returns ~200-500 tokens of structured information about the workspace.
+ */
+export declare function buildRepoMap(cwd: string, additionalExcludes?: string[]): string;
+//# sourceMappingURL=repo-map.d.ts.map

package/dist/agent/repo-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-map.d.ts","sourceRoot":"","sources":["../../src/agent/repo-map.ts"],"names":[],"mappings":"AA2CA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAqB/E"}