@steipete/oracle 0.20.3 → 0.21.1

package/dist/src/browser/config.js

@@ -58,6 +58,7 @@ export const DEFAULT_BROWSER_CONFIG = {
     researchMode: "off",
     archiveConversations: "auto",
     resumeConversationUrl: null,
+    captureProviderNative: false,
 };
 export function resolveBrowserConfig(config) {
     const debugPortEnv = parseDebugPort(process.env.ORACLE_BROWSER_PORT ?? process.env.ORACLE_BROWSER_DEBUG_PORT);
@@ -117,6 +118,7 @@ export function resolveBrowserConfig(config) {
         researchMode,
         archiveConversations,
         resumeConversationUrl: config?.resumeConversationUrl ?? DEFAULT_BROWSER_CONFIG.resumeConversationUrl,
+        captureProviderNative: config?.captureProviderNative ?? DEFAULT_BROWSER_CONFIG.captureProviderNative,
         manualLogin,
         manualLoginProfileDir: manualLogin ? resolvedProfileDir : null,
         manualLoginCookieSync: config?.manualLoginCookieSync ?? DEFAULT_BROWSER_CONFIG.manualLoginCookieSync,

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/index.js

@@ -16,6 +16,7 @@ import { INPUT_SELECTORS } from "./constants.js";
 import { uploadAttachmentViaDataTransfer } from "./actions/remoteFileTransfer.js";
 import { ensureThinkingTime } from "./actions/thinkingTime.js";
 import { throwIfAssistantUiError } from "./actions/assistantResponse.js";
+import { finalizeProviderNativeCapture, } from "./chatgptConversation.js";
 import { startThinkingStatusMonitor } from "./actions/thinkingStatus.js";
 import { classifyChatGptUiWarningText, collectChatGptUiWarnings, createAssistantTimeoutError, throwChatGptUiWarningIfPresent, } from "./uiWarnings.js";
 import { activateDeepResearch, captureDeepResearchTargetKeys, waitForDeepResearchCompletion, waitForResearchPlanAutoConfirm, } from "./actions/deepResearch.js";
@@ -443,6 +444,31 @@ function formatBrowserLeaseDiagnostics(options) {
         `launch=${options.launchDisposition ?? "unknown"}`,
     ].join("; ");
 }
+/**
+ * Provider-native capture, gated on explicit opt-in.
+ *
+ * Off by default because it costs two extra authenticated requests per run and
+ * only matters when a caller intends to treat the transcript as evidence rather
+ * than as an answer. When it is on and it fails, the run is unaffected: the
+ * summary records why, and nothing throws.
+ */
+async function runProviderNativeCapture(params) {
+    if (!params.config.captureProviderNative) {
+        return { artifacts: [] };
+    }
+    const conversationId = params.conversationUrl
+        ? extractConversationIdFromUrl(params.conversationUrl)
+        : undefined;
+    return finalizeProviderNativeCapture({
+        Runtime: params.Runtime,
+        conversationId,
+        conversationUrl: params.conversationUrl,
+        sessionId: params.sessionId,
+        answerMarkdown: params.answerMarkdown,
+        answerMessageId: params.answerMessageId,
+        logger: params.logger,
+    });
+}
 function buildSkippedModelSelectionEvidence(desiredModel, strategy) {
     return {
         requestedModel: desiredModel ?? null,
@@ -682,6 +708,7 @@ async function runBrowserModeInternal(options, cancellation) {
     const startedAt = Date.now();
     let answerText = "";
     let answerMarkdown = "";
+    let answerMessageId;
     let answerHtml = "";
     let runStatus = "attempted";
     let connectionClosedUnexpectedly = false;
@@ -1227,15 +1254,23 @@ async function runBrowserModeInternal(options, cancellation) {
                 conversationUrl: lastUrl,
                 logger,
             }), logger);
+            const providerCapture = await runProviderNativeCapture({
+                Runtime,
+                config,
+                conversationUrl: lastUrl,
+                sessionId: options.sessionId,
+                answerMarkdown: researchResult.text,
+                logger,
+            });
             const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
                 sessionId: options.sessionId,
                 prompt: promptText,
                 answerMarkdown: researchResult.text,
                 conversationUrl: lastUrl,
-                artifacts: appendArtifacts(undefined, [reportArtifact]),
+                artifacts: appendArtifacts(appendArtifacts(undefined, [reportArtifact]), providerCapture.artifacts),
                 logger,
             }), logger);
-            const savedArtifacts = appendArtifacts(undefined, [reportArtifact, transcriptArtifact]);
+            const savedArtifacts = appendArtifacts(appendArtifacts(undefined, [reportArtifact, transcriptArtifact]), providerCapture.artifacts);
             const archive = await maybeArchiveCompletedConversation({
                 Runtime,
                 logger,
@@ -1249,6 +1284,7 @@ async function runBrowserModeInternal(options, cancellation) {
                 answerMarkdown: researchResult.text,
                 answerHtml: researchResult.html,
                 artifacts: savedArtifacts,
+                providerNativeCapture: providerCapture.summary,
                 archive,
                 modelSelection: modelSelectionEvidence,
                 thinkingSelection: thinkingSelectionEvidence,
@@ -1561,6 +1597,7 @@ async function runBrowserModeInternal(options, cancellation) {
                     turnAnswerMarkdown = bestText;
                 }
             }
+            answerMessageId = turnAnswer.meta.messageId ?? undefined;
             return {
                 label,
                 answerText: turnAnswerText,
@@ -1664,15 +1701,25 @@ async function runBrowserModeInternal(options, cancellation) {
         });
         const savedImageArtifacts = appendArtifacts(undefined, imageArtifacts.savedImages);
         const savedBrowserArtifacts = appendArtifacts(savedImageArtifacts, fileArtifacts.savedFiles);
+        const providerCapture = await runProviderNativeCapture({
+            Runtime,
+            config,
+            conversationUrl: lastUrl,
+            sessionId: options.sessionId,
+            answerMarkdown,
+            answerMessageId,
+            logger,
+        });
+        const browserArtifactsWithCapture = appendArtifacts(savedBrowserArtifacts, providerCapture.artifacts);
         const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
             sessionId: options.sessionId,
             prompt: promptText,
             answerMarkdown,
             conversationUrl: lastUrl,
-            artifacts: savedBrowserArtifacts,
+            artifacts: browserArtifactsWithCapture,
             logger,
         }), logger);
-        const savedArtifacts = appendArtifacts(savedBrowserArtifacts, [transcriptArtifact]);
+        const savedArtifacts = appendArtifacts(browserArtifactsWithCapture, [transcriptArtifact]);
         const archive = await maybeArchiveCompletedConversation({
             Runtime,
             logger,
@@ -1692,6 +1739,7 @@ async function runBrowserModeInternal(options, cancellation) {
             answerMarkdown,
             answerHtml: answerHtml.length > 0 ? answerHtml : undefined,
             artifacts: savedArtifacts,
+            providerNativeCapture: providerCapture.summary,
             generatedImages: imageArtifacts.generatedImages,
             savedImages: imageArtifacts.savedImages,
             downloadableFiles: fileArtifacts.files,
@@ -2233,6 +2281,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
     const startedAt = Date.now();
     let answerText = "";
     let answerMarkdown = "";
+    let answerMessageId;
     let answerHtml = "";
     let connectionClosedUnexpectedly = false;
     let runStatus = "attempted";
@@ -2552,15 +2601,23 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 conversationUrl: lastUrl,
                 logger,
             }), logger);
+            const providerCapture = await runProviderNativeCapture({
+                Runtime,
+                config,
+                conversationUrl: lastUrl,
+                sessionId: options.sessionId,
+                answerMarkdown: researchResult.text,
+                logger,
+            });
             const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
                 sessionId: options.sessionId,
                 prompt: promptText,
                 answerMarkdown: researchResult.text,
                 conversationUrl: lastUrl,
-                artifacts: appendArtifacts(undefined, [reportArtifact]),
+                artifacts: appendArtifacts(appendArtifacts(undefined, [reportArtifact]), providerCapture.artifacts),
                 logger,
             }), logger);
-            const savedArtifacts = appendArtifacts(undefined, [reportArtifact, transcriptArtifact]);
+            const savedArtifacts = appendArtifacts(appendArtifacts(undefined, [reportArtifact, transcriptArtifact]), providerCapture.artifacts);
             const archive = await maybeArchiveCompletedConversation({
                 Runtime,
                 logger,
@@ -2575,6 +2632,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 answerMarkdown: researchResult.text,
                 answerHtml: researchResult.html,
                 artifacts: savedArtifacts,
+                providerNativeCapture: providerCapture.summary,
                 archive,
                 modelSelection: modelSelectionEvidence,
                 thinkingSelection: thinkingSelectionEvidence,
@@ -2852,6 +2910,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                     turnAnswerMarkdown = bestText;
                 }
             }
+            answerMessageId = turnAnswer.meta.messageId ?? undefined;
             return {
                 label,
                 answerText: turnAnswerText,
@@ -2947,15 +3006,25 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
         });
         const savedImageArtifacts = appendArtifacts(undefined, imageArtifacts.savedImages);
         const savedBrowserArtifacts = appendArtifacts(savedImageArtifacts, fileArtifacts.savedFiles);
+        const providerCapture = await runProviderNativeCapture({
+            Runtime,
+            config,
+            conversationUrl: lastUrl,
+            sessionId: options.sessionId,
+            answerMarkdown,
+            answerMessageId,
+            logger,
+        });
+        const browserArtifactsWithCapture = appendArtifacts(savedBrowserArtifacts, providerCapture.artifacts);
         const transcriptArtifact = await saveOptionalArtifact(() => saveBrowserTranscriptArtifact({
             sessionId: options.sessionId,
             prompt: promptText,
             answerMarkdown,
             conversationUrl: lastUrl,
-            artifacts: savedBrowserArtifacts,
+            artifacts: browserArtifactsWithCapture,
             logger,
         }), logger);
-        const savedArtifacts = appendArtifacts(savedBrowserArtifacts, [transcriptArtifact]);
+        const savedArtifacts = appendArtifacts(browserArtifactsWithCapture, [transcriptArtifact]);
         const archive = await maybeArchiveCompletedConversation({
             Runtime,
             logger,
@@ -2991,6 +3060,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
             submittedPromptHash,
             ownedRecoveryTarget,
             artifacts: savedArtifacts,
+            providerNativeCapture: providerCapture.summary,
             generatedImages: imageArtifacts.generatedImages,
             savedImages: imageArtifacts.savedImages,
             downloadableFiles: fileArtifacts.files,

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) => {
@@ -313,6 +313,7 @@ async function executeAssembledBrowserSession({ runOptions, browserConfig, log,
         archive: browserResult.archive,
         modelSelection,
         thinkingSelection,
+        providerNativeCapture: browserResult.providerNativeCapture,
         warnings,
         answerText,
         artifacts: savedArtifacts,

package/dist/src/cli/browserConfig.js

@@ -238,6 +238,7 @@ export async function buildBrowserConfig(options) {
             ? options.browserResearch
             : "off",
         archiveConversations: options.browserArchive,
+        captureProviderNative: options.browserCaptureProviderNative,
     };
 }
 function assertBrowserModelAvailable(model, modelStrategy) {

package/dist/src/cli/browserDefaults.js

@@ -111,6 +111,10 @@ export function applyBrowserDefaultsFromConfig(options, config, getSource) {
         browser.thinkingTime !== undefined) {
         options.browserThinkingTime = normalizeThinkingTimeLevel(browser.thinkingTime) ?? undefined;
     }
+    if (isUnset("browserCaptureProviderNative") &&
+        typeof browser.captureProviderNative === "boolean") {
+        options.browserCaptureProviderNative = browser.captureProviderNative;
+    }
     if (isUnset("browserResearch") && browser.researchMode !== undefined) {
         options.browserResearch = browser.researchMode;
     }

package/dist/src/cli/sessionRunner.js

@@ -161,6 +161,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
                     archive: result.archive,
                     modelSelection: result.modelSelection,
                     thinkingSelection: result.thinkingSelection,
+                    providerNativeCapture: result.providerNativeCapture,
                     warnings: browserWarnings.length > 0 ? browserWarnings : undefined,
                 },
                 artifacts: mergeArtifacts(sessionMeta.artifacts, mergeArtifacts(result.artifacts, outputArtifacts.artifacts)),

package/dist/src/config.js

@@ -131,6 +131,7 @@ function sanitizeProjectConfig(config) {
     if (config.browser) {
         sanitized.browser = {};
         const browser = config.browser;
+        // Full-conversation retention is user-owned; never allow captureProviderNative here.
         const allowedBrowserKeys = [
             "attachRunning",
             "timeoutMs",

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,
@@ -867,6 +881,7 @@ function sanitizeResult(result, warnings = []) {
         answerChars: result.answerChars,
         modelSelection: result.modelSelection,
         thinkingSelection: result.thinkingSelection,
+        providerNativeCapture: result.providerNativeCapture,
         researchPlan: result.researchPlan,
         archive: result.archive,
         tabUrl: result.tabUrl,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.20.3",
+  "version": "0.21.1",
   "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",
@@ -79,6 +79,7 @@
     "shiki": "^4.4.3",
     "toasted-notifier": "^10.1.0",
     "tokentally": "^0.1.6",
+    "undici": "^7.29.1",
     "zod": "^4.6.2"
   },
   "devDependencies": {