@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/oracle/run.js

@@ -1,30 +1,30 @@
-import chalk from 'chalk';
-import kleur from 'kleur';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import process from 'node:process';
-import { performance } from 'node:perf_hooks';
-import { DEFAULT_SYSTEM_PROMPT, MODEL_CONFIGS, TOKENIZER_OPTIONS } from './config.js';
-import { readFiles } from './files.js';
-import { buildPrompt, buildRequestBody } from './request.js';
-import { estimateRequestTokens } from './tokenEstimate.js';
-import { formatElapsed } from './format.js';
-import { formatFinishLine } from './finishLine.js';
-import { getFileTokenStats, printFileTokenStats } from './tokenStats.js';
-import { OracleResponseError, OracleTransportError, PromptValidationError, describeTransportError, toTransportError, } from './errors.js';
-import { createDefaultClientFactory, isCustomBaseUrl } from './client.js';
-import { formatBaseUrlForLog, maskApiKey } from './logging.js';
-import { startHeartbeat } from '../heartbeat.js';
-import { startOscProgress } from './oscProgress.js';
-import { createFsAdapter } from './fsAdapter.js';
-import { resolveGeminiModelId } from './gemini.js';
-import { resolveClaudeModelId } from './claude.js';
-import { renderMarkdownAnsi } from '../cli/markdownRenderer.js';
-import { createMarkdownStreamer } from 'markdansi';
-import { executeBackgroundResponse } from './background.js';
-import { formatTokenEstimate, formatTokenValue, resolvePreviewMode } from './runUtils.js';
-import { estimateUsdCost } from 'tokentally';
-import { defaultOpenRouterBaseUrl, isKnownModel, isOpenRouterBaseUrl, isProModel, resolveModelConfig, normalizeOpenRouterBaseUrl, } from './modelResolver.js';
+import chalk from "chalk";
+import kleur from "kleur";
+import fs from "node:fs/promises";
+import path from "node:path";
+import process from "node:process";
+import { performance } from "node:perf_hooks";
+import { DEFAULT_SYSTEM_PROMPT, MODEL_CONFIGS, TOKENIZER_OPTIONS } from "./config.js";
+import { readFiles } from "./files.js";
+import { buildPrompt, buildRequestBody } from "./request.js";
+import { estimateRequestTokens } from "./tokenEstimate.js";
+import { formatElapsed } from "./format.js";
+import { formatFinishLine } from "./finishLine.js";
+import { getFileTokenStats, printFileTokenStats } from "./tokenStats.js";
+import { OracleResponseError, OracleTransportError, PromptValidationError, describeTransportError, toTransportError, } from "./errors.js";
+import { createDefaultClientFactory, isCustomBaseUrl } from "./client.js";
+import { formatBaseUrlForLog, maskApiKey } from "./logging.js";
+import { startHeartbeat } from "../heartbeat.js";
+import { startOscProgress } from "./oscProgress.js";
+import { createFsAdapter } from "./fsAdapter.js";
+import { resolveGeminiModelId } from "./gemini.js";
+import { resolveClaudeModelId } from "./claude.js";
+import { renderMarkdownAnsi } from "../cli/markdownRenderer.js";
+import { createMarkdownStreamer } from "markdansi";
+import { executeBackgroundResponse } from "./background.js";
+import { formatTokenEstimate, formatTokenValue, resolvePreviewMode } from "./runUtils.js";
+import { estimateUsdCost } from "tokentally";
+import { defaultOpenRouterBaseUrl, isKnownModel, isOpenRouterBaseUrl, isProModel, resolveModelConfig, normalizeOpenRouterBaseUrl, } from "./modelResolver.js";
 const isStdoutTty = process.stdout.isTTY && chalk.level > 0;
 const dim = (text) => (isStdoutTty ? kleur.dim(text) : text);
 // Default timeout for non-pro API runs (fast models) — give them up to 120s.
@@ -36,14 +36,14 @@ const defaultWait = (ms) => new Promise((resolve) => {
 export async function runOracle(options, deps = {}) {
     const { apiKey: optionsApiKey = options.apiKey, cwd = process.cwd(), fs: fsModule = createFsAdapter(fs), log = console.log, write: sinkWrite = (_text) => true, allowStdout = true, stdoutWrite: stdoutWriteDep, now = () => performance.now(), clientFactory = createDefaultClientFactory(), client, wait = defaultWait, } = deps;
     const stdoutWrite = allowStdout
-        ? stdoutWriteDep ?? process.stdout.write.bind(process.stdout)
+        ? (stdoutWriteDep ?? process.stdout.write.bind(process.stdout))
         : () => true;
     const isTty = allowStdout && isStdoutTty;
-    const resolvedXaiBaseUrl = process.env.XAI_BASE_URL?.trim() || 'https://api.x.ai/v1';
+    const resolvedXaiBaseUrl = process.env.XAI_BASE_URL?.trim() || "https://api.x.ai/v1";
     const openRouterApiKey = process.env.OPENROUTER_API_KEY?.trim();
     const defaultOpenRouterBase = defaultOpenRouterBaseUrl();
     const knownModelConfig = isKnownModel(options.model) ? MODEL_CONFIGS[options.model] : undefined;
-    const provider = knownModelConfig?.provider ?? 'other';
+    const provider = knownModelConfig?.provider ?? "other";
     const hasOpenAIKey = Boolean(optionsApiKey) ||
         Boolean(process.env.OPENAI_API_KEY) ||
         Boolean(process.env.AZURE_OPENAI_API_KEY && options.azure?.endpoint);
@@ -52,21 +52,21 @@ export async function runOracle(options, deps = {}) {
     const hasXaiKey = Boolean(optionsApiKey) || Boolean(process.env.XAI_API_KEY);
     let baseUrl = options.baseUrl?.trim();
     if (!baseUrl) {
-        if (options.model.startsWith('grok')) {
+        if (options.model.startsWith("grok")) {
             baseUrl = resolvedXaiBaseUrl;
         }
-        else if (provider === 'anthropic') {
+        else if (provider === "anthropic") {
             baseUrl = process.env.ANTHROPIC_BASE_URL?.trim();
         }
         else {
             baseUrl = process.env.OPENAI_BASE_URL?.trim();
         }
     }
-    const providerKeyMissing = (provider === 'openai' && !hasOpenAIKey) ||
-        (provider === 'anthropic' && !hasAnthropicKey) ||
-        (provider === 'google' && !hasGeminiKey) ||
-        (provider === 'xai' && !hasXaiKey) ||
-        provider === 'other';
+    const providerKeyMissing = (provider === "openai" && !hasOpenAIKey) ||
+        (provider === "anthropic" && !hasAnthropicKey) ||
+        (provider === "google" && !hasGeminiKey) ||
+        (provider === "xai" && !hasXaiKey) ||
+        provider === "other";
     const openRouterFallback = providerKeyMissing && Boolean(openRouterApiKey);
     if (!baseUrl || openRouterFallback) {
         if (openRouterFallback) {
@@ -86,66 +86,76 @@ export async function runOracle(options, deps = {}) {
     const isAzureOpenAI = Boolean(options.azure?.endpoint);
     const getApiKeyForModel = (model) => {
         if (isOpenRouterBaseUrl(baseUrl) || openRouterFallback) {
-            return { key: optionsApiKey ?? openRouterApiKey, source: 'OPENROUTER_API_KEY' };
+            return { key: optionsApiKey ?? openRouterApiKey, source: "OPENROUTER_API_KEY" };
         }
-        if (typeof model === 'string' && model.startsWith('gpt')) {
+        if (typeof model === "string" && model.startsWith("gpt")) {
             if (optionsApiKey)
-                return { key: optionsApiKey, source: 'apiKey option' };
+                return { key: optionsApiKey, source: "apiKey option" };
             if (isAzureOpenAI) {
                 const key = process.env.AZURE_OPENAI_API_KEY ?? process.env.OPENAI_API_KEY;
-                return { key, source: 'AZURE_OPENAI_API_KEY|OPENAI_API_KEY' };
+                return { key, source: "AZURE_OPENAI_API_KEY|OPENAI_API_KEY" };
             }
-            return { key: process.env.OPENAI_API_KEY, source: 'OPENAI_API_KEY' };
+            return { key: process.env.OPENAI_API_KEY, source: "OPENAI_API_KEY" };
         }
-        if (typeof model === 'string' && model.startsWith('gemini')) {
-            return { key: optionsApiKey ?? process.env.GEMINI_API_KEY, source: 'GEMINI_API_KEY' };
+        if (typeof model === "string" && model.startsWith("gemini")) {
+            return { key: optionsApiKey ?? process.env.GEMINI_API_KEY, source: "GEMINI_API_KEY" };
         }
-        if (typeof model === 'string' && model.startsWith('claude')) {
-            return { key: optionsApiKey ?? process.env.ANTHROPIC_API_KEY, source: 'ANTHROPIC_API_KEY' };
+        if (typeof model === "string" && model.startsWith("claude")) {
+            return { key: optionsApiKey ?? process.env.ANTHROPIC_API_KEY, source: "ANTHROPIC_API_KEY" };
         }
-        if (typeof model === 'string' && model.startsWith('grok')) {
-            return { key: optionsApiKey ?? process.env.XAI_API_KEY, source: 'XAI_API_KEY' };
+        if (typeof model === "string" && model.startsWith("grok")) {
+            return { key: optionsApiKey ?? process.env.XAI_API_KEY, source: "XAI_API_KEY" };
         }
-        return { key: optionsApiKey ?? openRouterApiKey, source: optionsApiKey ? 'apiKey option' : 'OPENROUTER_API_KEY' };
+        return {
+            key: optionsApiKey ?? openRouterApiKey,
+            source: optionsApiKey ? "apiKey option" : "OPENROUTER_API_KEY",
+        };
     };
     const apiKeyResult = getApiKeyForModel(options.model);
     const apiKey = apiKeyResult.key;
     if (!apiKey) {
         const envVar = isOpenRouterBaseUrl(baseUrl) || openRouterFallback
-            ? 'OPENROUTER_API_KEY'
-            : options.model.startsWith('gpt')
+            ? "OPENROUTER_API_KEY"
+            : options.model.startsWith("gpt")
                 ? isAzureOpenAI
-                    ? 'AZURE_OPENAI_API_KEY (or OPENAI_API_KEY)'
-                    : 'OPENAI_API_KEY'
-                : options.model.startsWith('gemini')
-                    ? 'GEMINI_API_KEY'
-                    : options.model.startsWith('claude')
-                        ? 'ANTHROPIC_API_KEY'
-                        : options.model.startsWith('grok')
-                            ? 'XAI_API_KEY'
-                            : 'OPENROUTER_API_KEY';
-        throw new PromptValidationError(`Missing ${envVar}. Set it via the environment or a .env file.`, {
+                    ? "AZURE_OPENAI_API_KEY (or OPENAI_API_KEY)"
+                    : "OPENAI_API_KEY"
+                : options.model.startsWith("gemini")
+                    ? "GEMINI_API_KEY"
+                    : options.model.startsWith("claude")
+                        ? "ANTHROPIC_API_KEY"
+                        : options.model.startsWith("grok")
+                            ? "XAI_API_KEY"
+                            : "OPENROUTER_API_KEY";
+        const browserModeHint = options.model.startsWith("gpt")
+            ? ' If you have a ChatGPT Pro subscription, retry with --engine browser (or MCP engine:"browser" / preset:"chatgpt-pro-heavy"); browser mode uses your signed-in ChatGPT session instead of an API key.'
+            : "";
+        throw new PromptValidationError(`Missing ${envVar}. Set it via the environment or a .env file.${browserModeHint}`, {
             env: envVar,
         });
     }
     const envVar = apiKeyResult.source;
-    const minPromptLength = Number.parseInt(process.env.ORACLE_MIN_PROMPT_CHARS ?? '10', 10);
+    const minPromptLength = Number.parseInt(process.env.ORACLE_MIN_PROMPT_CHARS ?? "10", 10);
     const promptLength = options.prompt?.trim().length ?? 0;
     // Enforce the short-prompt guardrail on pro-tier models because they're costly; cheaper models can run short prompts without blocking.
     const isProTierModel = isProModel(options.model);
     if (isProTierModel && !Number.isNaN(minPromptLength) && promptLength < minPromptLength) {
         throw new PromptValidationError(`Prompt is too short (<${minPromptLength} chars). This was likely accidental; please provide more detail.`, { minPromptLength, promptLength });
     }
-    const resolverOpenRouterApiKey = openRouterFallback || isOpenRouterBaseUrl(baseUrl) ? openRouterApiKey ?? apiKey : undefined;
+    const resolverOpenRouterApiKey = openRouterFallback || isOpenRouterBaseUrl(baseUrl) ? (openRouterApiKey ?? apiKey) : undefined;
     const modelConfig = await resolveModelConfig(options.model, {
         baseUrl,
         openRouterApiKey: resolverOpenRouterApiKey,
     });
     const isLongRunningModel = isProTierModel;
     const supportsBackground = modelConfig.supportsBackground !== false;
-    const useBackground = supportsBackground ? options.background ?? isLongRunningModel : false;
+    const useBackground = supportsBackground ? (options.background ?? isLongRunningModel) : false;
     const inputTokenBudget = options.maxInput ?? modelConfig.inputLimit;
-    const files = await readFiles(options.file ?? [], { cwd, fsModule, maxFileSizeBytes: options.maxFileSizeBytes });
+    const files = await readFiles(options.file ?? [], {
+        cwd,
+        fsModule,
+        maxFileSizeBytes: options.maxFileSizeBytes,
+    });
     const searchEnabled = options.search !== false;
     logVerbose(`cwd: ${cwd}`);
     let pendingNoFilesTip = null;
@@ -154,21 +164,21 @@ export async function runOracle(options, deps = {}) {
         const displayPaths = files
             .map((file) => path.relative(cwd, file.path) || file.path)
             .slice(0, 10)
-            .join(', ');
-        const extra = files.length > 10 ? ` (+${files.length - 10} more)` : '';
+            .join(", ");
+        const extra = files.length > 10 ? ` (+${files.length - 10} more)` : "";
         logVerbose(`Attached files (${files.length}): ${displayPaths}${extra}`);
     }
     else {
-        logVerbose('No files attached.');
+        logVerbose("No files attached.");
         if (!isPreview) {
             pendingNoFilesTip =
-                'Tip: no files attached — Oracle works best with project context. Add files via --file path/to/code or docs.';
+                "Tip: no files attached — Oracle works best with project context. Add files via --file path/to/code or docs.";
         }
     }
     const shortPrompt = (options.prompt?.trim().length ?? 0) < 80;
     if (!isPreview && shortPrompt) {
         pendingShortPromptTip =
-            'Tip: brief prompts often yield generic answers — aim for 6–30 sentences and attach key files.';
+            "Tip: brief prompts often yield generic answers — aim for 6–30 sentences and attach key files.";
     }
     const fileTokenInfo = getFileTokenStats(files, {
         cwd,
@@ -183,7 +193,7 @@ export async function runOracle(options, deps = {}) {
     const fileCount = files.length;
     const richTty = allowStdout && process.stdout.isTTY && chalk.level > 0;
     const renderPlain = Boolean(options.renderPlain);
-    const timeoutSeconds = options.timeoutSeconds === undefined || options.timeoutSeconds === 'auto'
+    const timeoutSeconds = options.timeoutSeconds === undefined || options.timeoutSeconds === "auto"
         ? isLongRunningModel
             ? DEFAULT_TIMEOUT_PRO_MS / 1000
             : DEFAULT_TIMEOUT_NON_PRO_MS / 1000
@@ -194,7 +204,7 @@ export async function runOracle(options, deps = {}) {
     const effectiveModelId = options.effectiveModelId ??
         (azureDeploymentName
             ? azureDeploymentName
-            : options.model.startsWith('gemini')
+            : options.model.startsWith("gemini")
                 ? resolveGeminiModelId(options.model)
                 : (modelConfig.apiModel ?? modelConfig.model));
     if (!isPreview && options.previousResponseId) {
@@ -213,30 +223,31 @@ export async function runOracle(options, deps = {}) {
     });
     requestBody.model = effectiveModelId;
     const estimatedInputTokens = estimateRequestTokens(requestBody, modelConfig);
-    const tokenLabel = formatTokenEstimate(estimatedInputTokens, (text) => (richTty ? chalk.green(text) : text));
+    const tokenLabel = formatTokenEstimate(estimatedInputTokens, (text) => richTty ? chalk.green(text) : text);
     const fileLabel = richTty ? chalk.magenta(fileCount.toString()) : fileCount.toString();
-    const filesPhrase = fileCount === 0 ? 'no files' : `${fileLabel} files`;
+    const filesPhrase = fileCount === 0 ? "no files" : `${fileLabel} files`;
     const headerModelLabelBase = richTty ? chalk.cyan(modelConfig.model) : modelConfig.model;
     const headerModelSuffix = effectiveModelId !== modelConfig.model
         ? richTty
             ? chalk.gray(` (API: ${effectiveModelId})`)
             : ` (API: ${effectiveModelId})`
-        : '';
+        : "";
     const headerLine = `Calling ${headerModelLabelBase}${headerModelSuffix} — ${tokenLabel} tokens, ${filesPhrase}.`;
-    const shouldReportFiles = (options.filesReport || fileTokenInfo.totalTokens > inputTokenBudget) && fileTokenInfo.stats.length > 0;
+    const shouldReportFiles = (options.filesReport || fileTokenInfo.totalTokens > inputTokenBudget) &&
+        fileTokenInfo.stats.length > 0;
     if (!isPreview) {
         if (!options.suppressHeader) {
             log(headerLine);
         }
         const maskedKey = maskApiKey(apiKey);
         if (maskedKey && options.verbose) {
-            const resolvedSuffix = effectiveModelId !== modelConfig.model ? ` (API: ${effectiveModelId})` : '';
+            const resolvedSuffix = effectiveModelId !== modelConfig.model ? ` (API: ${effectiveModelId})` : "";
             log(dim(`Using ${envVar}=${maskedKey} for model ${modelConfig.model}${resolvedSuffix}`));
         }
         if (!options.suppressHeader &&
-            (modelConfig.model === 'gpt-5.1-pro' || modelConfig.model === 'gpt-5.2-pro') &&
-            effectiveModelId === 'gpt-5.4-pro') {
-            log(dim(`Note: \`${modelConfig.model}\` is a stable CLI alias; OpenAI API uses \`gpt-5.4-pro\`.`));
+            (modelConfig.model === "gpt-5.1-pro" || modelConfig.model === "gpt-5.2-pro") &&
+            effectiveModelId === "gpt-5.5-pro") {
+            log(dim(`Note: \`${modelConfig.model}\` is a stable CLI alias; OpenAI API uses \`gpt-5.5-pro\`.`));
         }
         if (baseUrl) {
             log(dim(`Base URL: ${formatBaseUrlForLog(baseUrl)}`));
@@ -245,7 +256,7 @@ export async function runOracle(options, deps = {}) {
             log(dim(`Resolved model: ${modelConfig.model} → ${effectiveModelId}`));
         }
         if (options.background && !supportsBackground) {
-            log(dim('Background runs are not supported for this model; streaming in foreground instead.'));
+            log(dim("Background runs are not supported for this model; streaming in foreground instead."));
         }
         if (!options.suppressTips) {
             if (pendingNoFilesTip) {
@@ -256,10 +267,10 @@ export async function runOracle(options, deps = {}) {
             }
         }
         if (isLongRunningModel) {
-            log(dim('This model can take up to 60 minutes (usually replies much faster).'));
+            log(dim("This model can take up to 60 minutes (usually replies much faster)."));
         }
         if (options.verbose || isLongRunningModel) {
-            log(dim('Press Ctrl+C to cancel.'));
+            log(dim("Press Ctrl+C to cancel."));
         }
     }
     if (shouldReportFiles) {
@@ -270,19 +281,19 @@ export async function runOracle(options, deps = {}) {
     }
     logVerbose(`Estimated tokens (request body): ${estimatedInputTokens.toLocaleString()}`);
     if (isPreview && previewMode) {
-        if (previewMode === 'json' || previewMode === 'full') {
-            log('Request JSON');
+        if (previewMode === "json" || previewMode === "full") {
+            log("Request JSON");
             log(JSON.stringify(requestBody, null, 2));
-            log('');
+            log("");
         }
-        if (previewMode === 'full') {
-            log('Assembled Prompt');
+        if (previewMode === "full") {
+            log("Assembled Prompt");
             log(promptWithFiles);
-            log('');
+            log("");
         }
         log(`Estimated input tokens: ${estimatedInputTokens.toLocaleString()} / ${inputTokenBudget.toLocaleString()} (model: ${modelConfig.model})`);
         return {
-            mode: 'preview',
+            mode: "preview",
             previewMode,
             requestBody,
             estimatedInputTokens,
@@ -290,31 +301,31 @@ export async function runOracle(options, deps = {}) {
         };
     }
     const proxyCompatibleBaseUrl = baseUrl && (isOpenRouterBaseUrl(baseUrl) || isCustomBaseUrl(baseUrl)) ? baseUrl : undefined;
-    const apiEndpoint = modelConfig.model.startsWith('gemini')
+    const apiEndpoint = modelConfig.model.startsWith("gemini")
         ? proxyCompatibleBaseUrl
         : proxyCompatibleBaseUrl
             ? proxyCompatibleBaseUrl
-            : modelConfig.model.startsWith('claude')
-                ? process.env.ANTHROPIC_BASE_URL ?? baseUrl
+            : modelConfig.model.startsWith("claude")
+                ? (process.env.ANTHROPIC_BASE_URL ?? baseUrl)
                 : baseUrl;
     const clientInstance = client ??
         clientFactory(apiKey, {
             baseUrl: apiEndpoint,
             azure: options.azure,
             model: options.model,
-            resolvedModelId: modelConfig.model.startsWith('claude')
+            resolvedModelId: modelConfig.model.startsWith("claude")
                 ? resolveClaudeModelId(effectiveModelId)
-                : modelConfig.model.startsWith('gemini')
+                : modelConfig.model.startsWith("gemini")
                     ? resolveGeminiModelId(effectiveModelId)
                     : effectiveModelId,
             httpTimeoutMs: options.httpTimeoutMs,
         });
-    logVerbose('Dispatching request to API...');
+    logVerbose("Dispatching request to API...");
     if (options.verbose) {
-        log(''); // ensure verbose section is separated from Answer stream
+        log(""); // ensure verbose section is separated from Answer stream
     }
     const stopOscProgress = startOscProgress({
-        label: useBackground ? 'Waiting for API (background)' : 'Waiting for API',
+        label: useBackground ? "Waiting for API (background)" : "Waiting for API",
         targetMs: useBackground ? timeoutMs : Math.min(timeoutMs, 10 * 60_000),
         indeterminate: true,
         write: sinkWrite,
@@ -328,16 +339,16 @@ export async function runOracle(options, deps = {}) {
     const timeoutExceeded = () => now() - runStart >= timeoutMs;
     const throwIfTimedOut = () => {
         if (timeoutExceeded()) {
-            throw new OracleTransportError('client-timeout', `Timed out waiting for API response after ${formatElapsed(timeoutMs)}.`);
+            throw new OracleTransportError("client-timeout", `Timed out waiting for API response after ${formatElapsed(timeoutMs)}.`);
         }
     };
     const ensureAnswerHeader = () => {
         if (options.silent || answerHeaderPrinted)
             return;
         // Always add a separating newline for readability; optionally include the label depending on caller needs.
-        log('');
+        log("");
         if (allowAnswerHeader) {
-            log(chalk.bold('Answer:'));
+            log(chalk.bold("Answer:"));
         }
         answerHeaderPrinted = true;
     };
@@ -405,20 +416,20 @@ export async function runOracle(options, deps = {}) {
                     isTty && !renderPlain
                         ? createMarkdownStreamer({
                             render: renderMarkdownAnsi,
-                            spacing: 'single',
-                            mode: 'hybrid',
+                            spacing: "single",
+                            mode: "hybrid",
                         })
                         : null;
                 for await (const event of stream) {
                     throwIfTimedOut();
-                    const isTextDelta = event.type === 'chunk' || event.type === 'response.output_text.delta';
+                    const isTextDelta = event.type === "chunk" || event.type === "response.output_text.delta";
                     if (!isTextDelta)
                         continue;
                     stopOscProgress();
                     stopHeartbeatNow();
                     sawTextDelta = true;
                     ensureAnswerHeader();
-                    if (options.silent || typeof event.delta !== 'string')
+                    if (options.silent || typeof event.delta !== "string")
                         continue;
                     // Always keep the log/bookkeeping sink up to date.
                     sinkWrite(event.delta);
@@ -458,41 +469,41 @@ export async function runOracle(options, deps = {}) {
         stopOscProgress();
     }
     if (!response) {
-        throw new Error('API did not return a response.');
+        throw new Error("API did not return a response.");
     }
     // We only add spacing when streamed text was printed.
     if (sawTextDelta && !options.silent) {
         if (renderPlain) {
             // Plain streaming already wrote chunks; ensure clean separation.
-            stdoutWrite('\n');
+            stdoutWrite("\n");
         }
         else {
             // Separate streamed output from logs.
-            log('');
+            log("");
         }
     }
-    logVerbose(`Response status: ${response.status ?? 'completed'}`);
-    if (response.status && response.status !== 'completed') {
+    logVerbose(`Response status: ${response.status ?? "completed"}`);
+    if (response.status && response.status !== "completed") {
         // API can reply `in_progress` even after the stream closes; give it a brief grace poll.
-        if (response.id && response.status === 'in_progress') {
+        if (response.id && response.status === "in_progress") {
             const polishingStart = now();
             const pollIntervalMs = 2_000;
             const maxWaitMs = 180_000;
-            log(chalk.dim('Response still in_progress; polling until completion...'));
+            log(chalk.dim("Response still in_progress; polling until completion..."));
             // Short polling loop — we don't want to hang forever, just catch late finalization.
             while (now() - polishingStart < maxWaitMs) {
                 throwIfTimedOut();
                 await wait(pollIntervalMs);
                 const refreshed = await clientInstance.responses.retrieve(response.id);
-                if (refreshed.status === 'completed') {
+                if (refreshed.status === "completed") {
                     response = refreshed;
                     break;
                 }
             }
         }
-        if (response.status !== 'completed') {
+        if (response.status !== "completed") {
             const detail = response.error?.message || response.incomplete_details?.reason || response.status;
-            log(chalk.yellow(`API ended the run early (status=${response.status}${response.incomplete_details?.reason ? `, reason=${response.incomplete_details.reason}` : ''}).`));
+            log(chalk.yellow(`API ended the run early (status=${response.status}${response.incomplete_details?.reason ? `, reason=${response.incomplete_details.reason}` : ""}).`));
             throw new OracleResponseError(`Response did not complete: ${detail}`, response);
         }
     }
@@ -509,16 +520,16 @@ export async function runOracle(options, deps = {}) {
                 ? renderPlain || !richTty
                     ? answerText
                     : renderMarkdownAnsi(answerText)
-                : chalk.dim('(no text output)');
+                : chalk.dim("(no text output)");
             sinkWrite(printable);
-            if (!printable.endsWith('\n')) {
-                sinkWrite('\n');
+            if (!printable.endsWith("\n")) {
+                sinkWrite("\n");
             }
             stdoutWrite(printable);
-            if (!printable.endsWith('\n')) {
-                stdoutWrite('\n');
+            if (!printable.endsWith("\n")) {
+                stdoutWrite("\n");
             }
-            log('');
+            log("");
         }
     }
     const usage = response.usage ?? {};
@@ -530,17 +541,21 @@ export async function runOracle(options, deps = {}) {
     const cost = pricing
         ? estimateUsdCost({
             usage: { inputTokens, outputTokens, reasoningTokens, totalTokens },
-            pricing: { inputUsdPerToken: pricing.inputPerToken, outputUsdPerToken: pricing.outputPerToken },
+            pricing: {
+                inputUsdPerToken: pricing.inputPerToken,
+                outputUsdPerToken: pricing.outputPerToken,
+            },
         })?.totalUsd
         : undefined;
     const effortLabel = modelConfig.reasoning?.effort;
     const modelLabel = effortLabel ? `${modelConfig.model}[${effortLabel}]` : modelConfig.model;
-    const sessionIdContainsModel = typeof options.sessionId === 'string' && options.sessionId.toLowerCase().includes(modelConfig.model.toLowerCase());
+    const sessionIdContainsModel = typeof options.sessionId === "string" &&
+        options.sessionId.toLowerCase().includes(modelConfig.model.toLowerCase());
     const tokensDisplay = [inputTokens, outputTokens, reasoningTokens, totalTokens]
         .map((value, index) => formatTokenValue(value, usage, index))
-        .join('/');
+        .join("/");
     const tokensPart = (() => {
-        const parts = tokensDisplay.split('/');
+        const parts = tokensDisplay.split("/");
         if (parts.length !== 4)
             return tokensDisplay;
         return `↑${parts[0]} ↓${parts[1]} ↻${parts[2]} Δ${parts[3]}`;
@@ -553,7 +568,11 @@ export async function runOracle(options, deps = {}) {
         if (actualInput === undefined)
             return null;
         const delta = actualInput - estimatedInputTokens;
-        const deltaText = delta === 0 ? '' : delta > 0 ? ` (+${delta.toLocaleString()})` : ` (${delta.toLocaleString()})`;
+        const deltaText = delta === 0
+            ? ""
+            : delta > 0
+                ? ` (+${delta.toLocaleString()})`
+                : ` (${delta.toLocaleString()})`;
         return `est→actual=${estimatedInputTokens.toLocaleString()}→${actualInput.toLocaleString()}${deltaText}`;
     })();
     const { line1, line2 } = formatFinishLine({
@@ -564,43 +583,49 @@ export async function runOracle(options, deps = {}) {
         summaryExtraParts: options.sessionId ? [`sid=${options.sessionId}`] : null,
         detailParts: [
             estActualPart,
-            !searchEnabled ? 'search=off' : null,
+            !searchEnabled ? "search=off" : null,
             files.length > 0 ? `files=${files.length}` : null,
         ],
     });
     if (!options.silent) {
-        log('');
+        log("");
     }
     log(chalk.blue(line1));
     if (line2) {
         log(dim(line2));
     }
     return {
-        mode: 'live',
+        mode: "live",
         response,
-        usage: { inputTokens, outputTokens, reasoningTokens, totalTokens, ...(cost != null ? { cost } : {}) },
+        usage: {
+            inputTokens,
+            outputTokens,
+            reasoningTokens,
+            totalTokens,
+            ...(cost != null ? { cost } : {}),
+        },
         elapsedMs,
     };
 }
 export function extractTextOutput(response) {
     if (Array.isArray(response.output_text) && response.output_text.length > 0) {
-        return response.output_text.join('\n');
+        return response.output_text.join("\n");
     }
     if (Array.isArray(response.output)) {
         const segments = [];
         for (const item of response.output) {
             if (Array.isArray(item.content)) {
                 for (const chunk of item.content) {
-                    if (chunk && (chunk.type === 'output_text' || chunk.type === 'text') && chunk.text) {
+                    if (chunk && (chunk.type === "output_text" || chunk.type === "text") && chunk.text) {
                         segments.push(chunk.text);
                     }
                 }
             }
-            else if (typeof item.text === 'string') {
+            else if (typeof item.text === "string") {
                 segments.push(item.text);
             }
         }
-        return segments.join('\n');
+        return segments.join("\n");
     }
-    return '';
+    return "";
 }

package/dist/src/oracle/runUtils.js

@@ -1,10 +1,10 @@
 export function resolvePreviewMode(value) {
-    const allowed = new Set(['summary', 'json', 'full']);
-    if (typeof value === 'string' && value.length > 0) {
-        return allowed.has(value) ? value : 'summary';
+    const allowed = new Set(["summary", "json", "full"]);
+    if (typeof value === "string" && value.length > 0) {
+        return allowed.has(value) ? value : "summary";
     }
     if (value) {
-        return 'summary';
+        return "summary";
     }
     return undefined;
 }
@@ -13,7 +13,10 @@ export function resolvePreviewMode(value) {
  */
 export function formatTokenCount(value) {
     if (Math.abs(value) >= 1000) {
-        const abbreviated = (value / 1000).toFixed(2).replace(/\.0+$/, '').replace(/\.([1-9]*)0$/, '.$1');
+        const abbreviated = (value / 1000)
+            .toFixed(2)
+            .replace(/\.0+$/, "")
+            .replace(/\.([1-9]*)0$/, ".$1");
         return `${abbreviated}k`;
     }
     return value.toLocaleString();