@steipete/oracle 0.21.0 → 0.21.2

package/dist/bin/oracle-cli.js

@@ -368,6 +368,12 @@ program
     .addOption(new Option("--wait").default(undefined))
     .addOption(new Option("--no-wait").default(undefined).hideHelp())
     .showHelpAfterError("(use --help for usage)");
+program.on("afterHelp", ({ error }) => {
+    if (!error && program.opts().verbose) {
+        console.log("");
+        printDebugHelp(program.name());
+    }
+});
 program.addHelpText("after", `
 Examples:
   # Quick API run with two files
@@ -651,7 +657,7 @@ program
     .option("--remote-host <host:port>", "Delegate browser runs to a remote `oracle serve` instance.")
     .option("--remote-token <token>", "Access token for the remote `oracle serve` instance.")
     .action(async (sessionId, _options, cmd) => {
-    const restartOptions = cmd.opts();
+    const restartOptions = cmd.optsWithGlobals();
     await restartSession(sessionId, restartOptions);
 });
 function buildRunOptions(options, overrides = {}) {
@@ -986,7 +992,6 @@ async function runRootCommand(options) {
         return;
     }
     const userConfig = (await loadUserConfig()).config;
-    const helpRequested = rawCliArgs.some((arg) => arg === "--help" || arg === "-h");
     const multiModelProvided = Array.isArray(options.models) && options.models.length > 0;
     const optionUsesDefault = (name) => {
         // Commander reports undefined for untouched options, so treat undefined/default the same
@@ -996,15 +1001,6 @@ async function runRootCommand(options) {
     if (multiModelProvided && !optionUsesDefault("model") && normalizeModelOption(options.model)) {
         throw new Error("--models cannot be combined with --model.");
     }
-    if (helpRequested) {
-        if (options.verbose) {
-            console.log("");
-            printDebugHelp(program.name());
-            console.log("");
-        }
-        program.help({ error: false });
-        return;
-    }
     const previewMode = resolvePreviewMode(options.dryRun || options.preview);
     const mergedFileInputs = mergePathLikeOptions(options.file, options.include, options.files, options.path, options.paths);
     if (mergedFileInputs.length > 0) {
@@ -1462,9 +1458,9 @@ async function runRootCommand(options) {
     });
     let browserDeps;
     if (browserConfig && remoteHost) {
-        const { createRemoteBrowserExecutor } = await import("../src/remote/client.js");
+        const { resolveBrowserExecutor } = await import("../src/browser/executor.js");
         browserDeps = {
-            executeBrowser: createRemoteBrowserExecutor({ host: remoteHost, token: remoteToken }),
+            executeBrowser: await resolveBrowserExecutor({ ...resolvedOptions, model: activeModel }, { host: remoteHost, token: remoteToken }),
         };
         console.log(chalk.dim(`Routing browser automation to remote host ${remoteHost}`));
     }
@@ -1776,9 +1772,12 @@ async function restartSession(sessionId, options) {
     }
     let browserDeps;
     if (browserConfig && remoteHost) {
-        const { createRemoteBrowserExecutor } = await import("../src/remote/client.js");
+        const { resolveBrowserExecutor } = await import("../src/browser/executor.js");
         browserDeps = {
-            executeBrowser: createRemoteBrowserExecutor({ host: remoteHost, token: remoteToken }),
+            executeBrowser: await resolveBrowserExecutor(runOptions, {
+                host: remoteHost,
+                token: remoteToken,
+            }),
         };
         console.log(chalk.dim(`Routing browser automation to remote host ${remoteHost}`));
     }

package/dist/src/browser/executor.js

@@ -1,6 +1,13 @@
 import { resolveBrowserProvider } from "./provider.js";
-export async function resolveLocalBrowserExecutor(options) {
+export async function resolveBrowserExecutor(options, remote) {
     const provider = resolveBrowserProvider(options.model);
+    if (!provider) {
+        throw new Error(`Unsupported browser model: ${options.model}. Use a GPT or Gemini model.`);
+    }
+    if (remote) {
+        const { createRemoteBrowserExecutor } = await import("../remote/client.js");
+        return createRemoteBrowserExecutor({ ...remote, runOptions: options });
+    }
     if (provider === "gemini") {
         const { createGeminiWebExecutor } = await import("../gemini-web/index.js");
         return createGeminiWebExecutor({
@@ -13,7 +20,5 @@ export async function resolveLocalBrowserExecutor(options) {
             allowModelFallback: options.geminiAllowModelFallback,
         });
     }
-    if (provider === "chatgpt")
-        return (await import("../browserMode.js")).runBrowserMode;
-    throw new Error(`Unsupported browser model: ${options.model}. Use a GPT or Gemini model.`);
+    return (await import("../browserMode.js")).runBrowserMode;
 }

package/dist/src/browser/profileState.js

@@ -248,6 +248,8 @@ async function queryProcessStartTimeMs(pid) {
             maxBuffer: 1024 * 1024,
             windowsHide: true,
             timeout: 5000,
+            // Keep ps timestamps parseable regardless of the user's locale.
+            env: { ...process.env, LC_ALL: "C" },
         });
         const startedAt = Date.parse(String(stdout ?? "").trim());
         return Number.isFinite(startedAt) ? startedAt : null;

package/dist/src/browser/provider.js

@@ -8,4 +8,18 @@ export function resolveBrowserProvider(model) {
         return "chatgpt";
     return undefined;
 }
-export const REMOTE_GEMINI_UNSUPPORTED_MESSAGE = "Gemini browser runs are supported locally; remote browser services support ChatGPT only.";
+export function resolveRemoteBrowserModel(model, desiredModel) {
+    if (model !== undefined) {
+        if (typeof model === "string" && resolveBrowserProvider(model))
+            return model;
+        throw new Error(`Unsupported browser model: ${String(model)}. Use a GPT or Gemini model.`);
+    }
+    if (typeof desiredModel === "string" && resolveBrowserProvider(desiredModel))
+        return desiredModel;
+    // Older ChatGPT clients send only a picker label, or omit the selection entirely.
+    if (desiredModel == null ||
+        (typeof desiredModel === "string" &&
+            /^(?:|latest|auto|pro|thinking|instant)(?:\s.*)?$/i.test(desiredModel.trim())))
+        return undefined;
+    throw new Error(`Unsupported browser model: ${String(desiredModel)}. Use a GPT or Gemini model.`);
+}

package/dist/src/browser/sessionRunner.js

@@ -1,7 +1,7 @@
 import chalk from "chalk";
 import { formatTokenCount } from "../oracle/runUtils.js";
 import { formatFinishLine } from "../oracle/finishLine.js";
-import { resolveLocalBrowserExecutor } from "./executor.js";
+import { resolveBrowserExecutor } from "./executor.js";
 import { DEFAULT_BROWSER_CONFIG } from "./config.js";
 import { redactBrowserConfigForDebugLog } from "./configLogging.js";
 import { assembleBrowserPrompt, cleanupGeneratedBrowserBundles, materializeBrowserFallback, } from "./prompt.js";
@@ -67,7 +67,7 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
     if (signal?.aborted) {
         throw new BrowserRunCancelledError();
     }
-    const executeBrowser = deps.executeBrowser ?? (await resolveLocalBrowserExecutor(runOptions));
+    const executeBrowser = deps.executeBrowser ?? (await resolveBrowserExecutor(runOptions));
     try {
         promptArtifacts = await Promise.race([
             assemblePrompt(runOptions, { cwd }).then(async (artifacts) => {

package/dist/src/gemini-web/browserSessionManager.js

@@ -1,7 +1,8 @@
 import path from "node:path";
 import os from "node:os";
 import { mkdir } from "node:fs/promises";
-import { launchChrome, connectWithNewTab, closeTab } from "../browser/chromeLifecycle.js";
+import { launchChrome, connectWithNewTab, connectToRemoteChrome, closeTab, } from "../browser/chromeLifecycle.js";
+import { resolveAttachRunningConnection } from "../browser/attachRunning.js";
 import { resolveBrowserConfig } from "../browser/config.js";
 import { readDevToolsPort, writeDevToolsActivePort, writeChromePid, cleanupStaleProfileState, verifyDevToolsReachable, } from "../browser/profileState.js";
 export async function openGeminiBrowserSession(input) {
@@ -12,8 +13,20 @@ export async function openGeminiBrowserSession(input) {
         keepBrowser: browserConfig?.keepBrowser ?? keepBrowserDefault,
     });
     const profileDir = resolvedConfig.manualLoginProfileDir ?? path.join(os.homedir(), ".oracle", "browser-profile");
-    await mkdir(profileDir, { recursive: true });
     const keepBrowser = Boolean(resolvedConfig.keepBrowser);
+    if (resolvedConfig.attachRunning || resolvedConfig.remoteChrome) {
+        const logger = log ?? (() => { });
+        const endpoint = await resolveAttachRunningConnection(resolvedConfig, logger);
+        const connection = await connectToRemoteChrome(endpoint.host, endpoint.port, logger, "about:blank", endpoint.browserWSEndpoint, { approvalWaitMs: resolvedConfig.approvalWaitMs, fallbackToDefault: false });
+        return {
+            profileDir: endpoint.profileRoot ?? profileDir,
+            port: endpoint.port,
+            client: connection.client,
+            targetId: connection.targetId,
+            close: () => connection.close({ preserveTarget: keepBrowser }),
+        };
+    }
+    await mkdir(profileDir, { recursive: true });
     let port = await readDevToolsPort(profileDir);
     let launchedChrome = null;
     let chromeWasLaunched = false;

package/dist/src/gemini-web/executor.js

@@ -228,7 +228,7 @@ async function loadGeminiCookies(browserConfig, log, options) {
     if (hasInlineRequired) {
         return inlineResult;
     }
-    const manualNoKeychain = Boolean(browserConfig?.manualLogin) || Boolean(options?.preferManualNoKeychain);
+    const manualNoKeychain = Boolean(browserConfig?.manualLogin || browserConfig?.attachRunning || browserConfig?.remoteChrome) || Boolean(options?.preferManualNoKeychain);
     if (manualNoKeychain) {
         log?.("[gemini-web] Using manual-login cookie extraction path (no keychain cookie read).");
         const cdpResult = await loadGeminiCookiesFromCDP(browserConfig, log);

package/dist/src/gemini-web/http.js

@@ -1,6 +1,15 @@
+import { EnvHttpProxyAgent } from "undici";
+// Gemini's /app policy/reporting headers exceed Node's default 16 KiB limit.
+const GEMINI_MAX_HEADER_SIZE = 64 * 1024;
+let geminiDispatcher;
+export function createGeminiWebDispatcher(options = {}) {
+    return new EnvHttpProxyAgent({ ...options, maxHeaderSize: GEMINI_MAX_HEADER_SIZE });
+}
 export async function fetchGeminiWebResource(url, init = {}) {
     try {
-        return await fetch(url, init);
+        const dispatcher = init.dispatcher ?? (geminiDispatcher ??= createGeminiWebDispatcher());
+        const options = { ...init, dispatcher };
+        return await fetch(url, options);
     }
     catch (error) {
         const cause = error instanceof Error ? error.cause : undefined;
@@ -8,7 +17,7 @@ export async function fetchGeminiWebResource(url, init = {}) {
             typeof cause === "object" &&
             "code" in cause &&
             cause.code === "UND_ERR_HEADERS_OVERFLOW") {
-            throw new Error("Gemini response headers exceed Node's configured limit. Start Oracle with NODE_OPTIONS=--max-http-header-size=65536 (preserving any existing Node options) and retry.", { cause: error });
+            throw new Error("Gemini response headers exceed the HTTP transport's configured limit (Oracle's default is 64 KiB).", { cause: error });
         }
         throw error;
     }

package/dist/src/remote/client.js

@@ -11,16 +11,18 @@ import { checkRemoteHealth } from "./health.js";
 import { parseHostPort } from "../bridge/connection.js";
 import { BrowserRunCancelledError } from "../oracle/errors.js";
 import { resolveSiblingImagePath } from "../browser/chatgptImages.js";
-import { resolveBrowserProvider, REMOTE_GEMINI_UNSUPPORTED_MESSAGE } from "../browser/provider.js";
-export function createRemoteBrowserExecutor({ host, token }) {
+import { resolveBrowserProvider, resolveRemoteBrowserModel } from "../browser/provider.js";
+export function createRemoteBrowserExecutor({ host, token, runOptions }) {
     // Return a drop-in replacement for runBrowserMode so the browser session runner can stay unchanged.
     return async function remoteBrowserExecutor(options) {
-        if (options.model !== undefined && !resolveBrowserProvider(options.model)) {
-            throw new Error(`Unsupported browser model: ${options.model}. Remote services support ChatGPT only.`);
-        }
-        if (resolveBrowserProvider(options.model) === "gemini" ||
-            resolveBrowserProvider(options.config?.desiredModel) === "gemini") {
-            throw new Error(REMOTE_GEMINI_UNSUPPORTED_MESSAGE);
+        const model = resolveRemoteBrowserModel(options.model ?? runOptions?.model, options.config?.desiredModel);
+        const gemini = resolveBrowserProvider(model) === "gemini";
+        if (gemini &&
+            (runOptions?.editImage ||
+                runOptions?.generateImage ||
+                options.generateImagePath ||
+                options.outputPath)) {
+            throw new Error("Remote Gemini image generation and editing are not supported; run these requests locally.");
         }
         if (options.config?.researchMode === "search") {
             throw new Error("Web Search is a local browser pilot; --remote-host does not negotiate this capability yet. Use local Chrome or --browser-attach-running.");
@@ -46,8 +48,22 @@ export function createRemoteBrowserExecutor({ host, token }) {
             prompt: options.prompt,
             attachments: await serializeAttachments(options.attachments ?? []),
             fallbackSubmission: await serializeFallback(options.fallbackSubmission, { host, token }),
-            browserConfig: options.config ?? {},
+            browserConfig: {
+                ...options.config,
+                // Keep old hosts fail-closed for Gemini even when the picker label is unrelated.
+                ...(gemini ? { desiredModel: model } : {}),
+                inlineCookies: null,
+                inlineCookiesSource: null,
+            },
             options: {
+                model,
+                ...(gemini
+                    ? {
+                        youtube: runOptions?.youtube,
+                        geminiShowThoughts: runOptions?.geminiShowThoughts,
+                        geminiAllowModelFallback: runOptions?.geminiAllowModelFallback,
+                    }
+                    : {}),
                 heartbeatIntervalMs: options.heartbeatIntervalMs,
                 verbose: options.verbose,
                 sessionId: options.sessionId,

package/dist/src/remote/server.js

@@ -9,7 +9,7 @@ import { spawn, spawnSync } from "node:child_process";
 import { mkdtemp, rm, mkdir, writeFile, stat, realpath } from "node:fs/promises";
 import chalk from "chalk";
 import { materializeStagedFallbackBundle } from "../browser/prompt.js";
-import { runBrowserMode } from "../browserMode.js";
+import { resolveBrowserExecutor } from "../browser/executor.js";
 import { resolveBrowserConfig } from "../browser/config.js";
 import { RunSlots } from "./runSlots.js";
 export { RunSlots } from "./runSlots.js";
@@ -19,7 +19,7 @@ import { getCookies } from "@steipete/sweet-cookie";
 import { CHATGPT_URL } from "../browser/constants.js";
 import { getCliVersion } from "../version.js";
 import { getOracleHomeDir } from "../oracleHome.js";
-import { resolveBrowserProvider, REMOTE_GEMINI_UNSUPPORTED_MESSAGE } from "../browser/provider.js";
+import { resolveBrowserProvider, resolveRemoteBrowserModel } from "../browser/provider.js";
 import { cleanupStaleProfileState, readDevToolsPort, verifyDevToolsReachable, writeChromePid, writeDevToolsActivePort, } from "../browser/profileState.js";
 import { normalizeChatgptUrl } from "../browser/utils.js";
 import { computeFileSha256, resolveSessionArtifactsDir, sanitizeArtifactFilename, sanitizeArtifactMimeType, validateArtifactFile, } from "../browser/artifacts.js";
@@ -60,7 +60,6 @@ function validateAdmissionOptions(options) {
         throw new Error("--max-queued-runs must be a nonnegative integer.");
 }
 export async function createRemoteServer(options = {}, deps = {}) {
-    const runBrowser = deps.runBrowser ?? runBrowserMode;
     const attachedBrowser = usesHostBrowserAttachment(options.browserConfig);
     const manualLoginDefault = !attachedBrowser && options.manualLoginDefault;
     const hostBrowserConfig = options.browserConfig
@@ -231,13 +230,20 @@ export async function createRemoteServer(options = {}, deps = {}) {
             await abandon();
             return;
         }
-        if (resolveBrowserProvider(payload.browserConfig?.desiredModel) === "gemini") {
+        let model;
+        try {
+            model = resolveRemoteBrowserModel(payload.options.model, payload.browserConfig?.desiredModel);
+            if (resolveBrowserProvider(model) === "gemini" && payload.options.imageOutputRequested) {
+                throw new Error("Remote Gemini image generation and editing are not supported; run these requests locally.");
+            }
+        }
+        catch (error) {
             await abandon();
             if (!res.destroyed) {
                 res.writeHead(400, { "Content-Type": "application/json" });
                 res.end(JSON.stringify({
                     error: "unsupported_browser_provider",
-                    message: REMOTE_GEMINI_UNSUPPORTED_MESSAGE,
+                    message: error instanceof Error ? error.message : String(error),
                 }));
             }
             return;
@@ -362,8 +368,16 @@ export async function createRemoteServer(options = {}, deps = {}) {
                     logger(`[serve] Enforcing manual-login profile at ${options.manualLoginProfileDir ?? "default"} for remote run ${runId}`);
                 }
             }
+            const runBrowser = deps.runBrowser ??
+                (await resolveBrowserExecutor({
+                    model: model ?? "gpt-5.5",
+                    youtube: typeof payload.options.youtube === "string" ? payload.options.youtube : undefined,
+                    geminiShowThoughts: payload.options.geminiShowThoughts === true,
+                    geminiAllowModelFallback: payload.options.geminiAllowModelFallback !== false,
+                }));
             const result = await runBrowser({
                 prompt: payload.prompt,
+                model,
                 attachments,
                 fallbackSubmission,
                 config: payload.browserConfig,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.21.0",
+  "version": "0.21.2",
   "description": "CLI wrapper around OpenAI Responses API with GPT-5.6 Sol, GPT-5.6, GPT-5.5 Pro, GPT-5.5, GPT-5.4, GPT-5.2, GPT-5.1, and GPT-5.1 Codex high reasoning modes.",
   "keywords": [],
   "homepage": "https://askoracle.sh",
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@anthropic-ai/tokenizer": "^0.0.4",
-    "@google/genai": "^2.22.0",
+    "@google/genai": "^2.23.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "@steipete/sweet-cookie": "^0.4.3",
     "chalk": "^6.0.0",
@@ -72,30 +72,31 @@
     "inquirer": "14.2.2",
     "json5": "^2.2.3",
     "kleur": "^4.1.5",
-    "markdansi": "0.3.3",
-    "openai": "^7.15.0",
+    "markdansi": "0.3.4",
+    "openai": "^7.20.0",
     "osc-progress": "^0.3.3",
     "qs": "^6.16.0",
     "shiki": "^4.4.3",
     "toasted-notifier": "^10.1.0",
     "tokentally": "^0.1.6",
+    "undici": "^7.29.1",
     "zod": "^4.6.2"
   },
   "devDependencies": {
     "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@types/chrome-remote-interface": "^0.34.0",
-    "@types/node": "^26.5.1",
-    "@vitest/coverage-v8": "5.0.0",
-    "devtools-protocol": "0.0.1695952",
+    "@types/node": "^26.6.2",
+    "@vitest/coverage-v8": "5.0.1",
+    "devtools-protocol": "0.0.1701330",
     "es-toolkit": "^1.52.0",
     "esbuild": "^0.28.2",
-    "oxfmt": "0.67.0",
+    "oxfmt": "0.68.0",
     "oxlint": "^1.82.0",
     "puppeteer-core": "^25.10.0",
     "tsx": "^4.23.13",
     "typescript": "^7.0.2",
-    "vitest": "5.0.0"
+    "vitest": "5.0.1"
   },
   "devEngines": {
     "runtime": [
@@ -108,5 +109,5 @@
   "engines": {
     "node": ">=24"
   },
-  "packageManager": "pnpm@11.26.0"
+  "packageManager": "pnpm@11.27.0"
 }

package/dist/docs-site/CNAME

@@ -1 +0,0 @@
-askoracle.sh