@steipete/oracle 0.4.4 → 0.5.0

package/dist/src/cli/browserDefaults.js

@@ -0,0 +1,41 @@
+import { normalizeChatgptUrl, CHATGPT_URL } from '../browserMode.js';
+export function applyBrowserDefaultsFromConfig(options, config, getSource) {
+    const browser = config.browser;
+    if (!browser)
+        return;
+    const configuredChatgptUrl = browser.chatgptUrl ?? browser.url;
+    const cliChatgptSet = options.chatgptUrl !== undefined || options.browserUrl !== undefined;
+    if ((getSource('chatgptUrl') === 'default' || getSource('chatgptUrl') === undefined) && !cliChatgptSet && configuredChatgptUrl !== undefined) {
+        options.chatgptUrl = normalizeChatgptUrl(configuredChatgptUrl ?? '', CHATGPT_URL);
+    }
+    if (getSource('browserChromeProfile') === 'default' && browser.chromeProfile !== undefined) {
+        options.browserChromeProfile = browser.chromeProfile ?? undefined;
+    }
+    if (getSource('browserChromePath') === 'default' && browser.chromePath !== undefined) {
+        options.browserChromePath = browser.chromePath ?? undefined;
+    }
+    if (getSource('browserCookiePath') === 'default' && browser.chromeCookiePath !== undefined) {
+        options.browserCookiePath = browser.chromeCookiePath ?? undefined;
+    }
+    if ((getSource('browserUrl') === 'default' || getSource('browserUrl') === undefined) && options.browserUrl === undefined && browser.url !== undefined) {
+        options.browserUrl = browser.url;
+    }
+    if (getSource('browserTimeout') === 'default' && typeof browser.timeoutMs === 'number') {
+        options.browserTimeout = String(browser.timeoutMs);
+    }
+    if (getSource('browserPort') === 'default' && typeof browser.debugPort === 'number') {
+        options.browserPort = browser.debugPort;
+    }
+    if (getSource('browserInputTimeout') === 'default' && typeof browser.inputTimeoutMs === 'number') {
+        options.browserInputTimeout = String(browser.inputTimeoutMs);
+    }
+    if (getSource('browserHeadless') === 'default' && browser.headless !== undefined) {
+        options.browserHeadless = browser.headless;
+    }
+    if (getSource('browserHideWindow') === 'default' && browser.hideWindow !== undefined) {
+        options.browserHideWindow = browser.hideWindow;
+    }
+    if (getSource('browserKeepBrowser') === 'default' && browser.keepBrowser !== undefined) {
+        options.browserKeepBrowser = browser.keepBrowser;
+    }
+}

package/dist/src/cli/detach.js

@@ -1,11 +1,11 @@
-import { PRO_MODELS } from '../oracle.js';
+import { isProModel } from '../oracle/modelResolver.js';
 export function shouldDetachSession({ 
 // Params kept for future policy tweaks; currently only model/disableDetachEnv matter.
 engine, model, waitPreference: _waitPreference, disableDetachEnv, }) {
     if (disableDetachEnv)
         return false;
     // Only Pro-tier API runs should start detached by default; browser runs stay inline so failures surface.
-    if (PRO_MODELS.has(model) && engine === 'api')
+    if (isProModel(model) && engine === 'api')
         return true;
     return false;
 }

package/dist/src/cli/dryRun.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
 import { MODEL_CONFIGS, TOKENIZER_OPTIONS, DEFAULT_SYSTEM_PROMPT, buildPrompt, readFiles, getFileTokenStats, printFileTokenStats, } from '../oracle.js';
+import { isKnownModel } from '../oracle/modelResolver.js';
 import { assembleBrowserPrompt } from '../browser/prompt.js';
 import { buildTokenEstimateSuffix, formatAttachmentLabel } from '../browser/promptSummary.js';
 import { buildCookiePlan } from '../browser/policies.js';
@@ -15,7 +16,8 @@ async function runApiDryRun({ runOptions, cwd, version, log, }, deps) {
     const files = await readFilesImpl(runOptions.file ?? [], { cwd });
     const systemPrompt = runOptions.system?.trim() || DEFAULT_SYSTEM_PROMPT;
     const combinedPrompt = buildPrompt(runOptions.prompt ?? '', files, cwd);
-    const tokenizer = MODEL_CONFIGS[runOptions.model].tokenizer;
+    const modelConfig = isKnownModel(runOptions.model) ? MODEL_CONFIGS[runOptions.model] : MODEL_CONFIGS['gpt-5.1'];
+    const tokenizer = modelConfig.tokenizer;
     const estimatedInputTokens = tokenizer([
         { role: 'system', content: systemPrompt },
         { role: 'user', content: combinedPrompt },
@@ -26,7 +28,7 @@ async function runApiDryRun({ runOptions, cwd, version, log, }, deps) {
         log(chalk.dim('[dry-run] No files matched the provided --file patterns.'));
         return;
     }
-    const inputBudget = runOptions.maxInput ?? MODEL_CONFIGS[runOptions.model].inputLimit;
+    const inputBudget = runOptions.maxInput ?? modelConfig.inputLimit;
     const stats = getFileTokenStats(files, {
         cwd,
         tokenizer,

package/dist/src/cli/engine.js

@@ -1,7 +1,7 @@
-import { PRO_MODELS } from '../oracle.js';
+import { isProModel } from '../oracle/modelResolver.js';
 export function defaultWaitPreference(model, engine) {
     // Pro-class API runs can take a long time; prefer non-blocking unless explicitly overridden.
-    if (engine === 'api' && PRO_MODELS.has(model)) {
+    if (engine === 'api' && isProModel(model)) {
         return false;
     }
     return true; // browser or non-pro models are fast enough to block by default

package/dist/src/cli/help.js

@@ -38,12 +38,12 @@ export function applyHelpStyling(program, version, isTty) {
     program.addHelpText('after', () => renderHelpFooter(program, colors));
 }
 function renderHelpBanner(version, colors) {
-    const subtitle = 'GPT-5.1 Pro/GPT-5.1 for tough questions with code/file context.';
+    const subtitle = 'Prompt + files required — GPT-5.1 Pro/GPT-5.1 for tough questions with code/file context.';
     return `${colors.banner(`Oracle CLI v${version}`)} ${colors.subtitle(`— ${subtitle}`)}\n`;
 }
 function renderHelpFooter(program, colors) {
     const tips = [
-        `${colors.bullet('•')} Oracle cannot see your project unless you pass ${colors.accent('--file …')} — attach the files/dirs you want it to read.`,
+        `${colors.bullet('•')} Required: always pass a prompt AND ${colors.accent('--file …')} (directories/globs are fine); Oracle cannot see your project otherwise.`,
         `${colors.bullet('•')} Attach lots of source (whole directories beat single files) and keep total input under ~196k tokens.`,
         `${colors.bullet('•')} Oracle starts empty—open with a short project briefing (stack, services, build steps), spell out the question and prior attempts, and why it matters; the more explanation and context you provide, the better the response will be.`,
         `${colors.bullet('•')} Spell out the project + platform + version requirements (repo name, target OS/toolchain versions, API dependencies) so Oracle doesn’t guess defaults.`,

package/dist/src/cli/options.js

@@ -149,7 +149,8 @@ export function resolveApiModel(modelValue) {
     if (normalized.includes('gemini')) {
         return 'gemini-3-pro';
     }
-    throw new InvalidArgumentError(`Unsupported model "${modelValue}". Choose one of: ${Object.keys(MODEL_CONFIGS).join(', ')}`);
+    // Passthrough for custom/OpenRouter model IDs.
+    return normalized;
 }
 export function inferModelFromLabel(modelValue) {
     const normalized = normalizeModelOption(modelValue).toLowerCase();

package/dist/src/cli/runOptions.js

@@ -64,7 +64,7 @@ function resolveEngineWithConfig({ engine, configEngine, env, }) {
     return resolveEngine({ engine: undefined, env });
 }
 function resolveEffectiveModelId(model) {
-    if (model.startsWith('gemini')) {
+    if (typeof model === 'string' && model.startsWith('gemini')) {
         return resolveGeminiModelId(model);
     }
     const config = MODEL_CONFIGS[model];

package/dist/src/cli/sessionDisplay.js

@@ -4,10 +4,24 @@ import { renderMarkdownAnsi } from './markdownRenderer.js';
 import { formatElapsed, formatUSD } from '../oracle/format.js';
 import { MODEL_CONFIGS } from '../oracle.js';
 import { sessionStore, wait } from '../sessionStore.js';
+import { formatTokenCount, formatTokenValue } from '../oracle/runUtils.js';
+import { resumeBrowserSession } from '../browser/reattach.js';
+import { estimateTokenCount } from '../browser/utils.js';
 const isTty = () => Boolean(process.stdout.isTTY);
 const dim = (text) => (isTty() ? kleur.dim(text) : text);
 export const MAX_RENDER_BYTES = 200_000;
 const MODEL_COLUMN_WIDTH = 18;
+function isProcessAlive(pid) {
+    if (!pid)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return !(error instanceof Error && error.code === 'ESRCH');
+    }
+}
 const CLEANUP_TIP = 'Tip: Run "oracle session --clear --hours 24" to prune cached runs (add --all to wipe everything).';
 export async function showStatus({ hours, includeAll, limit, showExamples = false, modelFilter, }) {
     const metas = await sessionStore.listSessions();
@@ -55,7 +69,7 @@ function colorStatus(status, padded) {
     }
 }
 export async function attachSession(sessionId, options) {
-    const metadata = await sessionStore.readSession(sessionId);
+    let metadata = await sessionStore.readSession(sessionId);
     if (!metadata) {
         console.error(chalk.red(`No session found with ID ${sessionId}`));
         process.exitCode = 1;
@@ -74,6 +88,65 @@ export async function attachSession(sessionId, options) {
     const initialStatus = metadata.status;
     const wantsRender = Boolean(options?.renderMarkdown);
     const isVerbose = Boolean(process.env.ORACLE_VERBOSE_RENDER);
+    const runtime = metadata.browser?.runtime;
+    const controllerAlive = isProcessAlive(runtime?.controllerPid);
+    const canReattach = metadata.status === 'running' &&
+        metadata.mode === 'browser' &&
+        runtime?.chromePort &&
+        (metadata.response?.incompleteReason === 'chrome-disconnected' || (runtime.controllerPid && !controllerAlive));
+    if (canReattach) {
+        const portInfo = runtime?.chromePort ? `port ${runtime.chromePort}` : 'unknown port';
+        const urlInfo = runtime?.tabUrl ? `url=${runtime.tabUrl}` : 'url=unknown';
+        console.log(chalk.yellow(`Attempting to reattach to the existing Chrome session (${portInfo}, ${urlInfo})...`));
+        try {
+            const result = await resumeBrowserSession(runtime, metadata.browser?.config, Object.assign(((message) => {
+                if (message) {
+                    console.log(dim(message));
+                }
+            }), { verbose: true }));
+            const outputTokens = estimateTokenCount(result.answerMarkdown);
+            const logWriter = sessionStore.createLogWriter(sessionId);
+            logWriter.logLine('[reattach] captured assistant response from existing Chrome tab');
+            logWriter.logLine('Answer:');
+            logWriter.logLine(result.answerMarkdown || result.answerText);
+            logWriter.stream.end();
+            if (metadata.model) {
+                await sessionStore.updateModelRun(metadata.id, metadata.model, {
+                    status: 'completed',
+                    usage: {
+                        inputTokens: 0,
+                        outputTokens,
+                        reasoningTokens: 0,
+                        totalTokens: outputTokens,
+                    },
+                    completedAt: new Date().toISOString(),
+                });
+            }
+            await sessionStore.updateSession(sessionId, {
+                status: 'completed',
+                completedAt: new Date().toISOString(),
+                usage: {
+                    inputTokens: 0,
+                    outputTokens,
+                    reasoningTokens: 0,
+                    totalTokens: outputTokens,
+                },
+                browser: {
+                    config: metadata.browser?.config,
+                    runtime,
+                },
+                response: { status: 'completed' },
+                error: undefined,
+                transport: undefined,
+            });
+            console.log(chalk.green('Reattach succeeded; session marked completed.'));
+            metadata = (await sessionStore.readSession(sessionId)) ?? metadata;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.log(chalk.red(`Reattach failed: ${message}`));
+        }
+    }
     if (!options?.suppressMetadata) {
         const reattachLine = buildReattachLine(metadata);
         if (reattachLine) {
@@ -85,7 +158,7 @@ export async function attachSession(sessionId, options) {
             console.log('Models:');
             for (const run of metadata.models) {
                 const usage = run.usage
-                    ? ` tok=${run.usage.outputTokens?.toLocaleString() ?? 0}/${run.usage.totalTokens?.toLocaleString() ?? 0}`
+                    ? ` tok=${formatTokenCount(run.usage.outputTokens ?? 0)}/${formatTokenCount(run.usage.totalTokens ?? 0)}`
                     : '';
                 console.log(`- ${chalk.cyan(run.model)} — ${run.status}${usage}`);
             }
@@ -424,17 +497,25 @@ async function buildSessionLogForDisplay(sessionId, fallbackMeta, modelFilter) {
         }
         return await sessionStore.readLog(sessionId);
     }
-    const candidates = normalizedFilter != null
+    const candidates = normalizedFilter
         ? models.filter((model) => model.model.toLowerCase() === normalizedFilter)
         : models;
     if (candidates.length === 0) {
         return '';
     }
     const sections = [];
+    let hasContent = false;
     for (const model of candidates) {
-        const body = await sessionStore.readModelLog(sessionId, model.model);
+        const body = (await sessionStore.readModelLog(sessionId, model.model)) ?? '';
+        if (body.trim().length > 0) {
+            hasContent = true;
+        }
         sections.push(`=== ${model.model} ===\n${body}`.trimEnd());
     }
+    if (!hasContent) {
+        // Fallback for runs that recorded output only in the session log (e.g., browser runs without per-model logs).
+        return await sessionStore.readLog(sessionId);
+    }
     return sections.join('\n\n');
 }
 function extractRenderableChunks(text, state) {
@@ -499,7 +580,19 @@ export function formatCompletionSummary(metadata, options = {}) {
     const usage = metadata.usage;
     const cost = metadata.mode === 'browser' ? null : resolveCost(metadata);
     const costPart = cost != null ? ` | ${formatUSD(cost)}` : '';
-    const tokensDisplay = `${usage.inputTokens}/${usage.outputTokens}/${usage.reasoningTokens}/${usage.totalTokens}`;
+    const tokensDisplay = [
+        usage.inputTokens ?? 0,
+        usage.outputTokens ?? 0,
+        usage.reasoningTokens ?? 0,
+        usage.totalTokens ?? 0,
+    ]
+        .map((value, index) => formatTokenValue(value, {
+        input_tokens: usage.inputTokens,
+        output_tokens: usage.outputTokens,
+        reasoning_tokens: usage.reasoningTokens,
+        total_tokens: usage.totalTokens,
+    }, index))
+        .join('/');
     const filesCount = metadata.options?.file?.length ?? 0;
     const filesPart = filesCount > 0 ? ` | files=${filesCount}` : '';
     const slugPart = options.includeSlug ? ` | slug=${metadata.id}` : '';

package/dist/src/cli/sessionRunner.js

@@ -10,6 +10,8 @@ import { sendSessionNotification, deriveNotificationSettingsFromMetadata, } from
 import { sessionStore } from '../sessionStore.js';
 import { runMultiModelApiSession } from '../oracle/multiModelRunner.js';
 import { MODEL_CONFIGS, DEFAULT_SYSTEM_PROMPT } from '../oracle/config.js';
+import { isKnownModel } from '../oracle/modelResolver.js';
+import { resolveModelConfig } from '../oracle/modelResolver.js';
 import { buildPrompt, buildRequestBody } from '../oracle/request.js';
 import { estimateRequestTokens } from '../oracle/tokenEstimate.js';
 import { formatTokenEstimate, formatTokenValue } from '../oracle/runUtils.js';
@@ -49,7 +51,16 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                     startedAt: new Date().toISOString(),
                 });
             }
-            const result = await runBrowserSessionExecution({ runOptions, browserConfig, cwd, log }, browserDeps);
+            const runnerDeps = {
+                ...browserDeps,
+                persistRuntimeHint: async (runtime) => {
+                    await sessionStore.updateSession(sessionMeta.id, {
+                        status: 'running',
+                        browser: { config: browserConfig, runtime },
+                    });
+                },
+            };
+            const result = await runBrowserSessionExecution({ runOptions, browserConfig, cwd, log }, runnerDeps);
             if (modelForStatus) {
                 await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
                     status: 'completed',
@@ -87,10 +98,10 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             if (!primaryModel) {
                 throw new Error('Missing model name for multi-model run.');
             }
-            const modelConfig = MODEL_CONFIGS[primaryModel];
-            if (!modelConfig) {
-                throw new Error(`Unsupported model "${primaryModel}".`);
-            }
+            const modelConfig = await resolveModelConfig(primaryModel, {
+                baseUrl: runOptions.baseUrl,
+                openRouterApiKey: process.env.OPENROUTER_API_KEY,
+            });
             const files = await readFiles(runOptions.file ?? [], { cwd });
             const promptWithFiles = buildPrompt(runOptions.prompt, files, cwd);
             const requestBody = buildRequestBody({
@@ -119,7 +130,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                 log(dim(tip));
             }
             // Surface long-running model expectations up front so users know why a response might lag.
-            const longRunningModels = multiModels.filter((model) => MODEL_CONFIGS[model]?.reasoning?.effort === 'high');
+            const longRunningModels = multiModels.filter((model) => isKnownModel(model) && MODEL_CONFIGS[model]?.reasoning?.effort === 'high');
             if (longRunningModels.length > 0) {
                 for (const model of longRunningModels) {
                     log('');
@@ -299,6 +310,28 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         log(`ERROR: ${message}`);
         markErrorLogged(error);
         const userError = asOracleUserError(error);
+        const connectionLost = userError?.category === 'browser-automation' && userError.details?.stage === 'connection-lost';
+        if (connectionLost && mode === 'browser') {
+            const runtime = userError.details?.runtime;
+            log(dim('Chrome disconnected before completion; keeping session running for reattach.'));
+            if (modelForStatus) {
+                await sessionStore.updateModelRun(sessionMeta.id, modelForStatus, {
+                    status: 'running',
+                    completedAt: undefined,
+                });
+            }
+            await sessionStore.updateSession(sessionMeta.id, {
+                status: 'running',
+                errorMessage: message,
+                mode,
+                browser: {
+                    config: browserConfig,
+                    runtime: runtime ?? sessionMeta.browser?.runtime,
+                },
+                response: { status: 'running', incompleteReason: 'chrome-disconnected' },
+            });
+            return;
+        }
         if (userError) {
             log(dim(`User error (${userError.category}): ${userError.message}`));
         }

package/dist/src/cli/tui/index.js

@@ -12,13 +12,9 @@ import { MAX_RENDER_BYTES, trimBeforeFirstAnswer } from '../sessionDisplay.js';
 import { buildBrowserConfig, resolveBrowserModelLabel } from '../browserConfig.js';
 import { resolveNotificationSettings } from '../notifier.js';
 import { loadUserConfig } from '../../config.js';
+import { formatTokenCount } from '../../oracle/runUtils.js';
 const isTty = () => Boolean(process.stdout.isTTY && chalk.level > 0);
 const dim = (text) => (isTty() ? kleur.dim(text) : text);
-const disabledChoice = (label) => ({
-    name: label,
-    value: '__disabled__',
-    disabled: true,
-});
 const RECENT_WINDOW_HOURS = 24;
 const PAGE_SIZE = 10;
 const STATUS_PAD = 9;
@@ -27,14 +23,16 @@ const MODE_PAD = 7;
 const TIMESTAMP_PAD = 19;
 const CHARS_PAD = 5;
 const COST_PAD = 7;
-export async function launchTui({ version }) {
+export async function launchTui({ version, printIntro = true }) {
     const userConfig = (await loadUserConfig()).config;
     const rich = isTty();
-    if (rich) {
-        console.log(chalk.bold('🧿 oracle'), `${version}`, dim('— Whispering your tokens to the silicon sage'));
-    }
-    else {
-        console.log(`🧿 oracle ${version} — Whispering your tokens to the silicon sage`);
+    if (printIntro) {
+        if (rich) {
+            console.log(chalk.bold('🧿 oracle'), `${version}`, dim('— Whispering your tokens to the silicon sage'));
+        }
+        else {
+            console.log(`🧿 oracle ${version} — Whispering your tokens to the silicon sage`);
+        }
     }
     console.log('');
     let showingOlder = false;
@@ -44,24 +42,23 @@ export async function launchTui({ version }) {
         const headerLabel = dim(`${'Status'.padEnd(STATUS_PAD)} ${'Model'.padEnd(MODEL_PAD)} ${'Mode'.padEnd(MODE_PAD)} ${'Timestamp'.padEnd(TIMESTAMP_PAD)} ${'Chars'.padStart(CHARS_PAD)} ${'Cost'.padStart(COST_PAD)}  Slug`);
         // Start with a selectable row so focus never lands on a separator
         choices.push({ name: chalk.bold.green('ask oracle'), value: '__ask__' });
-        choices.push(disabledChoice(''));
         if (!showingOlder) {
             if (recent.length > 0) {
-                choices.push(disabledChoice(headerLabel));
+                choices.push(new inquirer.Separator(headerLabel));
                 choices.push(...recent.map(toSessionChoice));
             }
             else if (older.length > 0) {
                 // No recent entries; show first page of older.
-                choices.push(disabledChoice(headerLabel));
+                choices.push(new inquirer.Separator(headerLabel));
                 choices.push(...older.slice(0, PAGE_SIZE).map(toSessionChoice));
             }
         }
         else if (older.length > 0) {
-            choices.push(disabledChoice(headerLabel));
+            choices.push(new inquirer.Separator(headerLabel));
             choices.push(...older.map(toSessionChoice));
         }
-        choices.push(disabledChoice(''));
-        choices.push(disabledChoice('Actions'));
+        choices.push(new inquirer.Separator(' '));
+        choices.push(new inquirer.Separator('Actions'));
         choices.push({ name: chalk.bold.green('ask oracle'), value: '__ask__' });
         if (!showingOlder && olderTotal > 0) {
             choices.push({ name: 'Older page', value: '__older__' });
@@ -294,7 +291,7 @@ function printModelSummaries(models) {
     console.log(chalk.bold('Models:'));
     for (const run of models) {
         const usage = run.usage
-            ? ` tok=${run.usage.outputTokens?.toLocaleString() ?? 0}/${run.usage.totalTokens?.toLocaleString() ?? 0}`
+            ? ` tok=${formatTokenCount(run.usage.outputTokens ?? 0)}/${formatTokenCount(run.usage.totalTokens ?? 0)}`
             : '';
         console.log(` - ${chalk.cyan(run.model)} — ${run.status}${usage}`);
     }

package/dist/src/heartbeat.js

@@ -7,7 +7,7 @@ export function startHeartbeat(config) {
     let pending = false;
     const start = Date.now();
     const timer = setInterval(async () => {
-        // biome-ignore lint/nursery/noUnnecessaryConditions: stop flag flips asynchronously
+        // stop flag flips asynchronously
         if (stopped || pending) {
             return;
         }
@@ -32,7 +32,7 @@ export function startHeartbeat(config) {
     }, intervalMs);
     timer.unref?.();
     const stop = () => {
-        // biome-ignore lint/nursery/noUnnecessaryConditions: multiple callers may race to stop
+        // multiple callers may race to stop
         if (stopped) {
             return;
         }

package/dist/src/oracle/background.js

@@ -9,7 +9,15 @@ const BACKGROUND_RETRY_BASE_MS = 3000;
 const BACKGROUND_RETRY_MAX_MS = 15000;
 export async function executeBackgroundResponse(params) {
     const { client, requestBody, log, wait, heartbeatIntervalMs, now, maxWaitMs } = params;
-    const initialResponse = await client.responses.create(requestBody);
+    let initialResponse;
+    try {
+        initialResponse = await client.responses.create(requestBody);
+    }
+    catch (error) {
+        const transportError = toTransportError(error, requestBody.model);
+        log(chalk.yellow(describeTransportError(transportError, maxWaitMs)));
+        throw transportError;
+    }
     if (!initialResponse || !initialResponse.id) {
         throw new OracleResponseError('API did not return a response ID for the background run.', initialResponse);
     }
@@ -60,7 +68,7 @@ async function pollBackgroundResponse(params) {
     // biome-ignore lint/nursery/noUnnecessaryConditions: intentional polling loop.
     while (true) {
         const status = response.status ?? 'completed';
-        // biome-ignore lint/nursery/noUnnecessaryConditions: firstCycle toggles immediately; keep for clarity in logs.
+        // firstCycle toggles immediately; keep for clarity in logs.
         if (firstCycle) {
             firstCycle = false;
             log(chalk.dim(`API background response status=${status}. We'll keep retrying automatically.`));

package/dist/src/oracle/client.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import { createRequire } from 'node:module';
 import { createGeminiClient } from './gemini.js';
 import { createClaudeClient } from './claude.js';
+import { isOpenRouterBaseUrl } from './modelResolver.js';
 export function createDefaultClientFactory() {
     const customFactory = loadCustomClientFactory();
     if (customFactory)
@@ -16,6 +17,9 @@ export function createDefaultClientFactory() {
             return createClaudeClient(key, options.model, options.resolvedModelId, options.baseUrl);
         }
         let instance;
+        const defaultHeaders = isOpenRouterBaseUrl(options?.baseUrl)
+            ? buildOpenRouterHeaders()
+            : undefined;
         if (options?.azure?.endpoint) {
             instance = new AzureOpenAI({
                 apiKey: key,
@@ -30,6 +34,7 @@ export function createDefaultClientFactory() {
                 apiKey: key,
                 timeout: 20 * 60 * 1000,
                 baseURL: options?.baseUrl,
+                defaultHeaders,
             });
         }
         return {
@@ -41,6 +46,18 @@ export function createDefaultClientFactory() {
         };
     };
 }
+function buildOpenRouterHeaders() {
+    const headers = {};
+    const referer = process.env.OPENROUTER_REFERER ?? process.env.OPENROUTER_HTTP_REFERER ?? 'https://github.com/steipete/oracle';
+    const title = process.env.OPENROUTER_TITLE ?? 'Oracle CLI';
+    if (referer) {
+        headers['HTTP-Referer'] = referer;
+    }
+    if (title) {
+        headers['X-Title'] = title;
+    }
+    return headers;
+}
 function loadCustomClientFactory() {
     const override = process.env.ORACLE_CLIENT_FACTORY;
     if (!override) {

package/dist/src/oracle/config.js

@@ -3,11 +3,12 @@ import { countTokens as countTokensGpt5Pro } from 'gpt-tokenizer/model/gpt-5-pro
 import { countTokens as countTokensAnthropicRaw } from '@anthropic-ai/tokenizer';
 import { stringifyTokenizerInput } from './tokenStringifier.js';
 export const DEFAULT_MODEL = 'gpt-5.1-pro';
-export const PRO_MODELS = new Set(['gpt-5.1-pro', 'gpt-5-pro', 'claude-4.1-opus']);
+export const PRO_MODELS = new Set(['gpt-5.1-pro', 'gpt-5-pro', 'claude-4.5-sonnet', 'claude-4.1-opus']);
 const countTokensAnthropic = (input) => countTokensAnthropicRaw(stringifyTokenizerInput(input));
 export const MODEL_CONFIGS = {
     'gpt-5.1-pro': {
         model: 'gpt-5.1-pro',
+        provider: 'openai',
         tokenizer: countTokensGpt5Pro,
         inputLimit: 196000,
         pricing: {
@@ -18,6 +19,7 @@ export const MODEL_CONFIGS = {
     },
     'gpt-5-pro': {
         model: 'gpt-5-pro',
+        provider: 'openai',
         tokenizer: countTokensGpt5Pro,
         inputLimit: 196000,
         pricing: {
@@ -28,6 +30,7 @@ export const MODEL_CONFIGS = {
     },
     'gpt-5.1': {
         model: 'gpt-5.1',
+        provider: 'openai',
         tokenizer: countTokensGpt5,
         inputLimit: 196000,
         pricing: {
@@ -38,6 +41,7 @@ export const MODEL_CONFIGS = {
     },
     'gpt-5.1-codex': {
         model: 'gpt-5.1-codex',
+        provider: 'openai',
         tokenizer: countTokensGpt5,
         inputLimit: 196000,
         pricing: {
@@ -48,6 +52,7 @@ export const MODEL_CONFIGS = {
     },
     'gemini-3-pro': {
         model: 'gemini-3-pro',
+        provider: 'google',
         tokenizer: countTokensGpt5Pro,
         inputLimit: 200000,
         pricing: {
@@ -61,6 +66,7 @@ export const MODEL_CONFIGS = {
     'claude-4.5-sonnet': {
         model: 'claude-4.5-sonnet',
         apiModel: 'claude-sonnet-4-5',
+        provider: 'anthropic',
         tokenizer: countTokensAnthropic,
         inputLimit: 200000,
         pricing: {
@@ -74,6 +80,7 @@ export const MODEL_CONFIGS = {
     'claude-4.1-opus': {
         model: 'claude-4.1-opus',
         apiModel: 'claude-opus-4-1',
+        provider: 'anthropic',
         tokenizer: countTokensAnthropic,
         inputLimit: 200000,
         pricing: {
@@ -87,6 +94,7 @@ export const MODEL_CONFIGS = {
     'grok-4.1': {
         model: 'grok-4.1',
         apiModel: 'grok-4-1-fast-reasoning',
+        provider: 'xai',
         tokenizer: countTokensGpt5Pro,
         inputLimit: 2_000_000,
         pricing: {
@@ -101,6 +109,6 @@ export const MODEL_CONFIGS = {
 };
 export const DEFAULT_SYSTEM_PROMPT = [
     'You are Oracle, a focused one-shot problem solver.',
-    'Emphasize direct answers, cite any files referenced, and clearly note when the search tool was used.',
+    'Emphasize direct answers and cite any files referenced.',
 ].join(' ');
 export const TOKENIZER_OPTIONS = { allowedSpecial: 'all' };