@steipete/oracle 0.8.6 → 0.10.0

package/dist/src/oracle/errors.js

@@ -1,12 +1,12 @@
-import { APIConnectionError, APIConnectionTimeoutError, APIUserAbortError } from 'openai';
-import { APIError } from 'openai/error';
-import { formatElapsed } from './format.js';
+import { APIConnectionError, APIConnectionTimeoutError, APIUserAbortError } from "openai";
+import { APIError } from "openai/error";
+import { formatElapsed } from "./format.js";
 export class OracleUserError extends Error {
     category;
     details;
     constructor(category, message, details, cause) {
         super(message);
-        this.name = 'OracleUserError';
+        this.name = "OracleUserError";
         this.category = category;
         this.details = details;
         if (cause) {
@@ -16,20 +16,20 @@ export class OracleUserError extends Error {
 }
 export class FileValidationError extends OracleUserError {
     constructor(message, details, cause) {
-        super('file-validation', message, details, cause);
-        this.name = 'FileValidationError';
+        super("file-validation", message, details, cause);
+        this.name = "FileValidationError";
     }
 }
 export class BrowserAutomationError extends OracleUserError {
     constructor(message, details, cause) {
-        super('browser-automation', message, details, cause);
-        this.name = 'BrowserAutomationError';
+        super("browser-automation", message, details, cause);
+        this.name = "BrowserAutomationError";
     }
 }
 export class PromptValidationError extends OracleUserError {
     constructor(message, details, cause) {
-        super('prompt-validation', message, details, cause);
-        this.name = 'PromptValidationError';
+        super("prompt-validation", message, details, cause);
+        this.name = "PromptValidationError";
     }
 }
 export function asOracleUserError(error) {
@@ -42,7 +42,7 @@ export class OracleTransportError extends Error {
     reason;
     constructor(reason, message, cause) {
         super(message);
-        this.name = 'OracleTransportError';
+        this.name = "OracleTransportError";
         this.reason = reason;
         if (cause) {
             this.cause = cause;
@@ -54,7 +54,7 @@ export class OracleResponseError extends Error {
     response;
     constructor(message, response) {
         super(message);
-        this.name = 'OracleResponseError';
+        this.name = "OracleResponseError";
         this.response = response;
         this.metadata = extractResponseMetadata(response);
     }
@@ -79,54 +79,54 @@ export function toTransportError(error, model) {
         return error;
     }
     if (error instanceof APIConnectionTimeoutError) {
-        return new OracleTransportError('client-timeout', 'OpenAI request timed out before completion.', error);
+        return new OracleTransportError("client-timeout", "OpenAI request timed out before completion.", error);
     }
     if (error instanceof APIUserAbortError) {
-        return new OracleTransportError('client-abort', 'The request was aborted before OpenAI finished responding.', error);
+        return new OracleTransportError("client-abort", "The request was aborted before OpenAI finished responding.", error);
     }
     if (error instanceof APIConnectionError) {
-        return new OracleTransportError('connection-lost', 'Connection to OpenAI dropped before the response completed.', error);
+        return new OracleTransportError("connection-lost", "Connection to OpenAI dropped before the response completed.", error);
     }
-    const isApiError = error instanceof APIError || error?.name === 'APIError';
+    const isApiError = error instanceof APIError || error?.name === "APIError";
     if (isApiError) {
         const apiError = error;
         const code = apiError.code ?? apiError.error?.code;
-        const messageText = apiError.message?.toLowerCase?.() ?? '';
+        const messageText = apiError.message?.toLowerCase?.() ?? "";
         const apiMessage = apiError.error?.message ||
             apiError.message ||
-            (apiError.status ? `${apiError.status} OpenAI API error` : 'OpenAI API error');
+            (apiError.status ? `${apiError.status} OpenAI API error` : "OpenAI API error");
         // Friendly guidance when a pro-tier model isn't available on this base URL / API key.
-        if (model === 'gpt-5.2-pro' &&
-            (code === 'model_not_found' ||
-                messageText.includes('does not exist') ||
-                messageText.includes('unknown model') ||
-                messageText.includes('model_not_found'))) {
-            return new OracleTransportError('model-unavailable', 'gpt-5.2-pro is not available on this API base/key. Try gpt-5-pro or gpt-5.2, or switch to the browser engine.', apiError);
+        if ((model === "gpt-5.5-pro" || model === "gpt-5.4-pro") &&
+            (code === "model_not_found" ||
+                messageText.includes("does not exist") ||
+                messageText.includes("unknown model") ||
+                messageText.includes("model_not_found"))) {
+            return new OracleTransportError("model-unavailable", `${model} is not available on this API base/key. Try gpt-5.5, gpt-5-pro, or switch to the browser engine.`, apiError);
         }
         if (apiError.status === 404 || apiError.status === 405) {
-            return new OracleTransportError('unsupported-endpoint', 'HTTP 404/405 from the Responses API; this base URL or gateway likely does not expose /v1/responses. Set OPENAI_BASE_URL to api.openai.com/v1, update your Azure API version/deployment, or use the browser engine.', apiError);
+            return new OracleTransportError("unsupported-endpoint", "HTTP 404/405 from the Responses API; this base URL or gateway likely does not expose /v1/responses. Set OPENAI_BASE_URL to api.openai.com/v1, update your Azure API version/deployment, or use the browser engine.", apiError);
         }
-        return new OracleTransportError('api-error', apiMessage, apiError);
+        return new OracleTransportError("api-error", apiMessage, apiError);
     }
-    return new OracleTransportError('unknown', error instanceof Error ? error.message : 'Unknown transport failure.', error);
+    return new OracleTransportError("unknown", error instanceof Error ? error.message : "Unknown transport failure.", error);
 }
 export function describeTransportError(error, deadlineMs) {
     switch (error.reason) {
-        case 'client-timeout':
+        case "client-timeout":
             return deadlineMs
                 ? `Client-side timeout: OpenAI streaming call exceeded the ${formatElapsed(deadlineMs)} deadline.`
-                : 'Client-side timeout: OpenAI streaming call exceeded the configured deadline.';
-        case 'connection-lost':
-            return 'Connection to OpenAI ended unexpectedly before the response completed.';
-        case 'client-abort':
-            return 'Request was aborted before OpenAI completed the response.';
-        case 'api-error':
+                : "Client-side timeout: OpenAI streaming call exceeded the configured deadline.";
+        case "connection-lost":
+            return "Connection to OpenAI ended unexpectedly before the response completed.";
+        case "client-abort":
+            return "Request was aborted before OpenAI completed the response.";
+        case "api-error":
             return error.message;
-        case 'model-unavailable':
+        case "model-unavailable":
             return error.message;
-        case 'unsupported-endpoint':
-            return 'The Responses API returned 404/405 — your base URL/gateway probably lacks /v1/responses (check OPENAI_BASE_URL or switch to api.openai.com / browser engine).';
+        case "unsupported-endpoint":
+            return "The Responses API returned 404/405 — your base URL/gateway probably lacks /v1/responses (check OPENAI_BASE_URL or switch to api.openai.com / browser engine).";
         default:
-            return 'OpenAI streaming call ended with an unknown transport error.';
+            return "OpenAI streaming call ended with an unknown transport error.";
     }
 }

package/dist/src/oracle/files.js

@@ -1,11 +1,20 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import fg from 'fast-glob';
-import { FileValidationError } from './errors.js';
-const MAX_FILE_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
+import fs from "node:fs/promises";
+import path from "node:path";
+import fg from "fast-glob";
+import { FileValidationError } from "./errors.js";
+export const DEFAULT_MAX_FILE_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
 const DEFAULT_FS = fs;
-const DEFAULT_IGNORED_DIRS = ['node_modules', 'dist', 'coverage', '.git', '.turbo', '.next', 'build', 'tmp'];
-export async function readFiles(filePaths, { cwd = process.cwd(), fsModule = DEFAULT_FS, maxFileSizeBytes = MAX_FILE_SIZE_BYTES, readContents = true, } = {}) {
+const DEFAULT_IGNORED_DIRS = new Set([
+    "node_modules",
+    "dist",
+    "coverage",
+    ".git",
+    ".turbo",
+    ".next",
+    "build",
+    "tmp",
+]);
+export async function readFiles(filePaths, { cwd = process.cwd(), fsModule = DEFAULT_FS, maxFileSizeBytes = DEFAULT_MAX_FILE_SIZE_BYTES, readContents = true, } = {}) {
     if (!filePaths || filePaths.length === 0) {
         return [];
     }
@@ -24,13 +33,13 @@ export async function readFiles(filePaths, { cwd = process.cwd(), fsModule = DEF
     }
     else {
         if (partitioned.globPatterns.length > 0 || partitioned.excludePatterns.length > 0) {
-            throw new Error('Glob patterns and exclusions are only supported for on-disk files.');
+            throw new Error("Glob patterns and exclusions are only supported for on-disk files.");
         }
         candidatePaths = await expandWithCustomFs(partitioned, fsModule);
     }
     const allowedLiteralDirs = partitioned.literalDirectories
         .map((dir) => path.resolve(dir))
-        .filter((dir) => DEFAULT_IGNORED_DIRS.includes(path.basename(dir)));
+        .filter((dir) => DEFAULT_IGNORED_DIRS.has(path.basename(dir)));
     const allowedLiteralFiles = partitioned.literalFiles.map((file) => path.resolve(file));
     const resolvedLiteralDirs = new Set(allowedLiteralDirs);
     const allowedPaths = new Set([...allowedLiteralDirs, ...allowedLiteralFiles]);
@@ -50,7 +59,7 @@ export async function readFiles(filePaths, { cwd = process.cwd(), fsModule = DEF
         return false;
     });
     if (filteredCandidates.length === 0) {
-        throw new FileValidationError('No files matched the provided --file patterns.', {
+        throw new FileValidationError("No files matched the provided --file patterns.", {
             patterns: partitioned.globPatterns,
             excludes: partitioned.excludePatterns,
         });
@@ -68,7 +77,7 @@ export async function readFiles(filePaths, { cwd = process.cwd(), fsModule = DEF
         if (!stats.isFile()) {
             continue;
         }
-        if (maxFileSizeBytes && typeof stats.size === 'number' && stats.size > maxFileSizeBytes) {
+        if (maxFileSizeBytes && typeof stats.size === "number" && stats.size > maxFileSizeBytes) {
             const relative = path.relative(cwd, filePath) || filePath;
             oversized.push(`${relative} (${formatBytes(stats.size)})`);
             continue;
@@ -76,14 +85,14 @@ export async function readFiles(filePaths, { cwd = process.cwd(), fsModule = DEF
         accepted.push(filePath);
     }
     if (oversized.length > 0) {
-        throw new FileValidationError(`The following files exceed the 1 MB limit:\n- ${oversized.join('\n- ')}`, {
+        throw new FileValidationError(`The following files exceed the ${formatBytes(maxFileSizeBytes)} limit:\n- ${oversized.join("\n- ")}`, {
             files: oversized,
             limitBytes: maxFileSizeBytes,
         });
     }
     const files = [];
     for (const filePath of accepted) {
-        const content = readContents ? await fsModule.readFile(filePath, 'utf8') : '';
+        const content = readContents ? await fsModule.readFile(filePath, "utf8") : "";
         files.push({ path: filePath, content });
     }
     return files;
@@ -100,7 +109,7 @@ async function partitionFileInputs(rawPaths, cwd, fsModule) {
         if (!raw) {
             continue;
         }
-        if (raw.startsWith('!')) {
+        if (raw.startsWith("!")) {
             const normalized = normalizeGlob(raw.slice(1), cwd);
             if (normalized) {
                 result.excludePatterns.push(normalized);
@@ -153,11 +162,13 @@ async function expandWithNativeGlob(partitioned, cwd) {
     }));
     const resolved = matches.map((match) => path.resolve(cwd, match));
     const filtered = resolved.filter((filePath) => !isGitignored(filePath, gitignoreSets));
-    const finalFiles = dotfileOptIn ? filtered : filtered.filter((filePath) => !path.basename(filePath).startsWith('.'));
+    const finalFiles = dotfileOptIn
+        ? filtered
+        : filtered.filter((filePath) => !path.basename(filePath).startsWith("."));
     return Array.from(new Set(finalFiles));
 }
 async function loadGitignoreSets(cwd) {
-    const gitignorePaths = await fg('**/.gitignore', {
+    const gitignorePaths = await fg("**/.gitignore", {
         cwd,
         dot: true,
         absolute: true,
@@ -168,11 +179,11 @@ async function loadGitignoreSets(cwd) {
     const sets = [];
     for (const filePath of gitignorePaths) {
         try {
-            const raw = await fs.readFile(filePath, 'utf8');
+            const raw = await fs.readFile(filePath, "utf8");
             const patterns = raw
-                .split('\n')
+                .split("\n")
                 .map((line) => line.trim())
-                .filter((line) => line.length > 0 && !line.startsWith('#'));
+                .filter((line) => line.length > 0 && !line.startsWith("#"));
             if (patterns.length > 0) {
                 sets.push({ dir: path.dirname(filePath), patterns });
             }
@@ -204,7 +215,7 @@ async function buildIgnoredWhitelist(filePaths, cwd, fsModule) {
         const parts = rel.split(path.sep).filter(Boolean);
         for (let i = 0; i < parts.length - 1; i += 1) {
             const part = parts[i];
-            if (!DEFAULT_IGNORED_DIRS.includes(part)) {
+            if (!DEFAULT_IGNORED_DIRS.has(part)) {
                 continue;
             }
             const dirPath = path.resolve(cwd, ...parts.slice(0, i + 1));
@@ -212,7 +223,7 @@ async function buildIgnoredWhitelist(filePaths, cwd, fsModule) {
                 continue;
             }
             try {
-                const stats = await fsModule.stat(path.join(dirPath, '.gitignore'));
+                const stats = await fsModule.stat(path.join(dirPath, ".gitignore"));
                 if (stats.isFile()) {
                     whitelist.add(dirPath);
                 }
@@ -233,7 +244,7 @@ function findIgnoredAncestor(filePath, cwd, _literalDirs, allowedPaths, ignoredW
     const parts = rel.split(path.sep);
     for (let idx = 0; idx < parts.length; idx += 1) {
         const part = parts[idx];
-        if (!DEFAULT_IGNORED_DIRS.includes(part)) {
+        if (!DEFAULT_IGNORED_DIRS.has(part)) {
             continue;
         }
         const ignoredDir = path.resolve(cwd, parts.slice(0, idx + 1).join(path.sep));
@@ -251,9 +262,9 @@ function matchesPattern(relativePath, pattern) {
     if (!pattern) {
         return false;
     }
-    const normalized = pattern.replace(/\\+/g, '/');
+    const normalized = pattern.replace(/\\+/g, "/");
     // Directory rule
-    if (normalized.endsWith('/')) {
+    if (normalized.endsWith("/")) {
         const dir = normalized.slice(0, -1);
         return relativePath === dir || relativePath.startsWith(`${dir}/`);
     }
@@ -262,16 +273,14 @@ function matchesPattern(relativePath, pattern) {
     return regex.test(relativePath);
 }
 function globToRegex(pattern) {
-    const withMarkers = pattern.replace(/\*\*/g, '§§DOUBLESTAR§§').replace(/\*/g, '§§SINGLESTAR§§');
-    const escaped = withMarkers.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
-    const restored = escaped
-        .replace(/§§DOUBLESTAR§§/g, '.*')
-        .replace(/§§SINGLESTAR§§/g, '[^/]*');
+    const withMarkers = pattern.replace(/\*\*/g, "§§DOUBLESTAR§§").replace(/\*/g, "§§SINGLESTAR§§");
+    const escaped = withMarkers.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    const restored = escaped.replace(/§§DOUBLESTAR§§/g, ".*").replace(/§§SINGLESTAR§§/g, "[^/]*");
     return new RegExp(`^${restored}$`);
 }
 function includesDotfileSegment(pattern) {
-    const segments = pattern.split('/');
-    return segments.some((segment) => segment.startsWith('.') && segment.length > 1);
+    const segments = pattern.split("/");
+    return segments.some((segment) => segment.startsWith(".") && segment.length > 1);
 }
 async function expandWithCustomFs(partitioned, fsModule) {
     const paths = new Set();
@@ -302,38 +311,38 @@ async function expandDirectoryRecursive(directory, fsModule) {
     return results;
 }
 function makeDirectoryPattern(relative) {
-    if (relative === '.' || relative === '') {
-        return '**/*';
+    if (relative === "." || relative === "") {
+        return "**/*";
     }
     return `${stripTrailingSlashes(relative)}/**/*`;
 }
 function isNativeFsModule(fsModule) {
-    return ((fsModule.__nativeFs === true ||
+    return (fsModule.__nativeFs === true ||
         (fsModule.readFile === DEFAULT_FS.readFile &&
             fsModule.stat === DEFAULT_FS.stat &&
-            fsModule.readdir === DEFAULT_FS.readdir)));
+            fsModule.readdir === DEFAULT_FS.readdir));
 }
 function normalizeGlob(pattern, cwd) {
     if (!pattern) {
-        return '';
+        return "";
     }
     let normalized = pattern;
     if (path.isAbsolute(normalized)) {
         normalized = path.relative(cwd, normalized);
     }
     normalized = toPosix(normalized);
-    if (normalized.startsWith('./')) {
+    if (normalized.startsWith("./")) {
         normalized = normalized.slice(2);
     }
     return normalized;
 }
 function toPosix(value) {
-    return value.replace(/\\/g, '/');
+    return value.replace(/\\/g, "/");
 }
 function toPosixRelative(absPath, cwd) {
     const relative = path.relative(cwd, absPath);
     if (!relative) {
-        return '.';
+        return ".";
     }
     return toPosix(relative);
 }
@@ -343,17 +352,32 @@ function toPosixRelativeOrBasename(absPath, cwd) {
 }
 function stripTrailingSlashes(value) {
     const normalized = toPosix(value);
-    return normalized.replace(/\/+$/g, '');
+    return normalized.replace(/\/+$/g, "");
 }
 function formatBytes(size) {
     if (size >= 1024 * 1024) {
-        return `${(size / (1024 * 1024)).toFixed(1)} MB`;
+        return `${formatScaled(size / (1024 * 1024))} MB`;
     }
     if (size >= 1024) {
-        return `${(size / 1024).toFixed(1)} KB`;
+        return `${formatScaled(size / 1024)} KB`;
     }
     return `${size} B`;
 }
+function formatScaled(value) {
+    return value.toFixed(1).replace(/\.0$/, "");
+}
+export function normalizeMaxFileSizeBytes(value, source = "max file size") {
+    if (value == null || value === "") {
+        return undefined;
+    }
+    const parsed = typeof value === "number"
+        ? value
+        : Number.parseInt(typeof value === "string" ? value.trim() : String(value), 10);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+        throw new Error(`${source} must be a positive integer number of bytes.`);
+    }
+    return parsed;
+}
 function relativePath(targetPath, cwd) {
     const relative = path.relative(cwd, targetPath);
     return relative || targetPath;
@@ -363,10 +387,10 @@ export function createFileSections(files, cwd = process.cwd()) {
         const relative = toPosix(path.relative(cwd, file.path) || file.path);
         const sectionText = [
             `### File ${index + 1}: ${relative}`,
-            '```',
+            "```",
             file.content.trimEnd(),
-            '```',
-        ].join('\n');
+            "```",
+        ].join("\n");
         return {
             index: index + 1,
             absolutePath: file.path,

package/dist/src/oracle/finishLine.js

@@ -1,7 +1,7 @@
-import { formatUSD } from './format.js';
+import { formatUSD } from "./format.js";
 export function formatElapsedCompact(ms) {
     if (!Number.isFinite(ms) || ms < 0) {
-        return 'unknown';
+        return "unknown";
     }
     if (ms < 60_000) {
         return `${(ms / 1000).toFixed(1)}s`;
@@ -9,24 +9,26 @@ export function formatElapsedCompact(ms) {
     if (ms < 60 * 60_000) {
         const minutes = Math.floor(ms / 60_000);
         const seconds = Math.floor((ms % 60_000) / 1000);
-        return `${minutes}m${seconds.toString().padStart(2, '0')}s`;
+        return `${minutes}m${seconds.toString().padStart(2, "0")}s`;
     }
     const hours = Math.floor(ms / (60 * 60_000));
     const minutes = Math.floor((ms % (60 * 60_000)) / 60_000);
-    return `${hours}h${minutes.toString().padStart(2, '0')}m`;
+    return `${hours}h${minutes.toString().padStart(2, "0")}m`;
 }
 export function formatFinishLine({ elapsedMs, model, costUsd, tokensPart, summaryExtraParts, detailParts, }) {
     const line1Parts = [
         formatElapsedCompact(elapsedMs),
-        typeof costUsd === 'number' ? formatUSD(costUsd) : null,
+        typeof costUsd === "number" ? formatUSD(costUsd) : null,
         model,
         tokensPart,
         ...(summaryExtraParts ?? []),
     ];
-    const line1 = line1Parts.filter((part) => typeof part === 'string' && part.length > 0).join(' · ');
-    const line2Parts = (detailParts ?? []).filter((part) => typeof part === 'string' && part.length > 0);
+    const line1 = line1Parts
+        .filter((part) => typeof part === "string" && part.length > 0)
+        .join(" · ");
+    const line2Parts = (detailParts ?? []).filter((part) => typeof part === "string" && part.length > 0);
     if (line2Parts.length === 0) {
         return { line1 };
     }
-    return { line1, line2: line2Parts.join(' | ') };
+    return { line1, line2: line2Parts.join(" | ") };
 }

package/dist/src/oracle/format.js

@@ -1,15 +1,15 @@
 export function formatUSD(value) {
     if (!Number.isFinite(value)) {
-        return 'n/a';
+        return "n/a";
     }
     // Display with 4 decimal places, rounding to $0.0001 minimum granularity.
     return `$${value.toFixed(4)}`;
 }
 export function formatNumber(value, { estimated = false } = {}) {
     if (value == null) {
-        return 'n/a';
+        return "n/a";
     }
-    const suffix = estimated ? ' (est.)' : '';
+    const suffix = estimated ? " (est.)" : "";
     return `${value.toLocaleString()}${suffix}`;
 }
 export function formatElapsed(ms) {

package/dist/src/oracle/gemini.js

@@ -1,30 +1,35 @@
-import { GoogleGenAI, HarmCategory, HarmBlockThreshold } from '@google/genai';
+import { GoogleGenAI, HarmCategory, HarmBlockThreshold, } from "@google/genai";
 const MODEL_ID_MAP = {
-    'gemini-3-pro': 'gemini-3-pro-preview',
-    'gpt-5.1-pro': 'gpt-5.1-pro',
-    'gpt-5-pro': 'gpt-5-pro',
-    'gpt-5.1': 'gpt-5.1',
-    'gpt-5.1-codex': 'gpt-5.1-codex',
-    'gpt-5.2': 'gpt-5.2',
-    'gpt-5.2-instant': 'gpt-5.2-instant',
-    'gpt-5.2-pro': 'gpt-5.2-pro',
-    'claude-4.5-sonnet': 'claude-4.5-sonnet',
-    'claude-4.1-opus': 'claude-4.1-opus',
-    'grok-4.1': 'grok-4.1',
+    "gemini-3.1-pro": "gemini-3.1-pro-preview",
+    "gemini-3-pro": "gemini-3-pro-preview",
+    "gpt-5.5": "gpt-5.5",
+    "gpt-5.5-pro": "gpt-5.5-pro",
+    "gpt-5.4": "gpt-5.4",
+    "gpt-5.4-pro": "gpt-5.4-pro",
+    "gpt-5.1-pro": "gpt-5.1-pro",
+    "gpt-5-pro": "gpt-5-pro",
+    "gpt-5.1": "gpt-5.1",
+    "gpt-5.1-codex": "gpt-5.1-codex",
+    "gpt-5.2": "gpt-5.2",
+    "gpt-5.2-instant": "gpt-5.2-instant",
+    "gpt-5.2-pro": "gpt-5.2-pro",
+    "claude-4.6-sonnet": "claude-4.6-sonnet",
+    "claude-4.1-opus": "claude-4.1-opus",
+    "grok-4.1": "grok-4.1",
 };
 export function resolveGeminiModelId(modelName) {
     // Map our logical Gemini names to the exact model ids expected by the SDK.
     return MODEL_ID_MAP[modelName] ?? modelName;
 }
-export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedModelId) {
+export function createGeminiClient(apiKey, modelName = "gemini-3-pro", resolvedModelId) {
     const modelId = resolvedModelId ?? resolveGeminiModelId(modelName);
     const genAI = new GoogleGenAI({ apiKey });
     const adaptBodyToGemini = (body) => {
         const contents = body.input.map((inputItem) => ({
-            role: inputItem.role === 'user' ? 'user' : 'model',
+            role: inputItem.role === "user" ? "user" : "model",
             parts: inputItem.content
                 .map((contentPart) => {
-                if (contentPart.type === 'input_text') {
+                if (contentPart.type === "input_text") {
                     return { text: contentPart.text };
                 }
                 return null;
@@ -33,7 +38,7 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
         }));
         const tools = body.tools
             ?.map((tool) => {
-            if (tool.type === 'web_search_preview') {
+            if (tool.type === "web_search_preview") {
                 return {
                     googleSearch: {},
                 };
@@ -60,7 +65,7 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
             },
         ];
         const systemInstruction = body.instructions
-            ? { role: 'system', parts: [{ text: body.instructions }] }
+            ? { role: "system", parts: [{ text: body.instructions }] }
             : undefined;
         return {
             model: modelId,
@@ -80,18 +85,19 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
             candidate.content?.parts?.forEach((part) => {
                 if (part.text) {
                     outputText.push(part.text);
-                    output.push({ type: 'text', text: part.text });
+                    output.push({ type: "text", text: part.text });
                 }
             });
         });
         const usage = {
             input_tokens: geminiResponse.usageMetadata?.promptTokenCount || 0,
             output_tokens: geminiResponse.usageMetadata?.candidatesTokenCount || 0,
-            total_tokens: (geminiResponse.usageMetadata?.promptTokenCount || 0) + (geminiResponse.usageMetadata?.candidatesTokenCount || 0),
+            total_tokens: (geminiResponse.usageMetadata?.promptTokenCount || 0) +
+                (geminiResponse.usageMetadata?.candidatesTokenCount || 0),
         };
         return {
             id: geminiResponse.responseId ?? `gemini-${Date.now()}`,
-            status: 'completed',
+            status: "completed",
             output_text: outputText,
             output,
             usage,
@@ -105,15 +111,15 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
         };
         return {
             id: responseId ?? `gemini-${Date.now()}`,
-            status: 'completed',
+            status: "completed",
             output_text: [text],
-            output: [{ type: 'text', text }],
+            output: [{ type: "text", text }],
             usage,
         };
     };
     const enrichGeminiError = (error) => {
         const message = error instanceof Error ? error.message : String(error);
-        if (message.includes('404')) {
+        if (message.includes("404")) {
             return new Error(`Gemini model not available to this API key/region. Confirm preview access and model ID (${modelId}). Original: ${message}`);
         }
         return error instanceof Error ? error : new Error(message);
@@ -123,7 +129,7 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
             stream: (body) => {
                 const geminiBody = adaptBodyToGemini(body);
                 let finalResponsePromise = null;
-                let aggregatedText = '';
+                let aggregatedText = "";
                 let lastUsage;
                 let responseId;
                 async function* iterator() {
@@ -138,7 +144,7 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
                         const text = chunk.text;
                         if (text) {
                             aggregatedText += text;
-                            yield { type: 'chunk', delta: text };
+                            yield { type: "chunk", delta: text };
                         }
                         if (chunk.usageMetadata) {
                             lastUsage = chunk.usageMetadata;
@@ -157,13 +163,14 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
                         if (!finalResponsePromise) {
                             // In case the user calls finalResponse before iterating, we need to consume the stream
                             // This is a bit edge-casey but safe.
-                            for await (const _ of generator) { }
+                            for await (const _ of generator) {
+                            }
                         }
                         if (!finalResponsePromise) {
-                            throw new Error('Response promise not initialized');
+                            throw new Error("Response promise not initialized");
                         }
                         return finalResponsePromise;
-                    }
+                    },
                 };
             },
             create: async (body) => {
@@ -180,8 +187,8 @@ export function createGeminiClient(apiKey, modelName = 'gemini-3-pro', resolvedM
             retrieve: async (id) => {
                 return {
                     id,
-                    status: 'error',
-                    error: { message: 'Retrieve by ID not supported for Gemini API yet.' },
+                    status: "error",
+                    error: { message: "Retrieve by ID not supported for Gemini API yet." },
                 };
             },
         },