@steipete/oracle 0.14.0 → 0.15.0

package/dist/src/browser/prompt.js

@@ -1,12 +1,14 @@
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-import { readFiles, createFileSections, MODEL_CONFIGS, TOKENIZER_OPTIONS, formatFileSections, } from "../oracle.js";
+import { readFiles, createFileSections, FileValidationError, MODEL_CONFIGS, TOKENIZER_OPTIONS, formatFileSections, } from "../oracle.js";
 import { isKnownModel } from "../oracle/modelResolver.js";
 import { buildPromptMarkdown } from "../oracle/promptAssembly.js";
 import { buildAttachmentPlan } from "./policies.js";
 import { createStoredZip } from "./zipBundle.js";
 const DEFAULT_BROWSER_INLINE_CHAR_BUDGET = 60_000;
+const MAX_BROWSER_ATTACHMENTS = 10;
+const MAX_BROWSER_ZIP_BUNDLE_BYTES = 128 * 1024 * 1024;
 const MEDIA_EXTENSIONS = new Set([
     ".mp4",
     ".mov",
@@ -31,27 +33,95 @@ const MEDIA_EXTENSIONS = new Set([
     ".heif",
     ".pdf",
 ]);
+const ARCHIVE_EXTENSIONS = new Set([
+    ".7z",
+    ".aab",
+    ".apk",
+    ".br",
+    ".bz2",
+    ".cab",
+    ".crx",
+    ".deb",
+    ".dmg",
+    ".doc",
+    ".docx",
+    ".ear",
+    ".epub",
+    ".gz",
+    ".ipa",
+    ".iso",
+    ".jar",
+    ".lz",
+    ".lz4",
+    ".msi",
+    ".odp",
+    ".ods",
+    ".odt",
+    ".pkg",
+    ".ppt",
+    ".pptx",
+    ".rar",
+    ".rpm",
+    ".tar",
+    ".tgz",
+    ".war",
+    ".whl",
+    ".xls",
+    ".xlsx",
+    ".xz",
+    ".xpi",
+    ".zip",
+    ".zipx",
+    ".zst",
+]);
 export function isMediaFile(filePath) {
     const ext = path.extname(filePath).toLowerCase();
     return MEDIA_EXTENSIONS.has(ext);
 }
+export function isRawUploadFile(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    return MEDIA_EXTENSIONS.has(ext) || ARCHIVE_EXTENSIONS.has(ext);
+}
 function formatSectionsForBundle(sections, options = {}) {
     return formatFileSections(sections, {
         lineNumbers: options.lineNumbers ?? true,
         trailingNewline: true,
     });
 }
-async function writeBrowserBundle(sections, format) {
+function resolveBrowserBundleFormat(format, sources) {
+    if (format !== "auto") {
+        return format;
+    }
+    return sources.hasRawUploadFiles ? "zip" : "text";
+}
+function shouldWriteBrowserBundle(format, { attachmentCount, bundleRequested, textSourceCount, textPlanShouldBundle, }) {
+    if (format === "zip") {
+        return (textPlanShouldBundle ||
+            (bundleRequested && attachmentCount > 0) ||
+            attachmentCount > MAX_BROWSER_ATTACHMENTS);
+    }
+    return textSourceCount > 0 && (textPlanShouldBundle || attachmentCount > MAX_BROWSER_ATTACHMENTS);
+}
+function assertAttachmentCount(attachments, format) {
+    if (attachments.length <= MAX_BROWSER_ATTACHMENTS)
+        return;
+    throw new Error(`Browser upload has ${attachments.length} attachments after applying bundle format "${format}". Use --browser-bundle-format auto or zip to stay within the ${MAX_BROWSER_ATTACHMENTS}-attachment limit.`);
+}
+async function writeBrowserBundle(sections, sources, format) {
     const bundleDir = await fs.mkdtemp(path.join(os.tmpdir(), "oracle-browser-bundle-"));
     const tokenEstimateText = formatSectionsForBundle(sections, {
         lineNumbers: format === "text",
     });
     if (format === "zip") {
+        const totalSourceBytes = sources.reduce((total, source) => total + source.sizeBytes, 0);
+        if (totalSourceBytes > MAX_BROWSER_ZIP_BUNDLE_BYTES) {
+            throw new Error(`Browser ZIP bundle inputs exceed the ${MAX_BROWSER_ZIP_BUNDLE_BYTES}-byte in-memory limit.`);
+        }
         const bundlePath = path.join(bundleDir, "attachments-bundle.zip");
-        const buffer = createStoredZip(sections.map((section) => ({
-            path: section.displayPath,
-            content: section.content,
-        })));
+        const buffer = createStoredZip(await Promise.all(sources.map(async (source) => ({
+            path: source.displayPath,
+            content: await fs.readFile(source.absolutePath),
+        }))));
         await fs.writeFile(bundlePath, buffer);
         return {
             attachment: {
@@ -60,7 +130,7 @@ async function writeBrowserBundle(sections, format) {
                 sizeBytes: buffer.length,
                 generatedBundle: true,
             },
-            metadata: { originalCount: sections.length, bundlePath, format },
+            metadata: { originalCount: sources.length, bundlePath, format },
             tokenEstimateText,
         };
     }
@@ -81,11 +151,27 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
     const cwd = deps.cwd ?? process.cwd();
     const readFilesFn = deps.readFilesImpl ?? readFiles;
     const allFilePaths = runOptions.file ?? [];
-    const textFilePaths = allFilePaths.filter((f) => !isMediaFile(f));
-    const mediaFilePaths = allFilePaths.filter((f) => isMediaFile(f));
-    const mediaAttachments = await Promise.all(mediaFilePaths.map(async (filePath) => {
+    const discoveredFiles = allFilePaths.length > 0
+        ? await readFilesFn(allFilePaths, {
+            cwd,
+            maxFileSizeBytes: 0,
+            readContents: false,
+        })
+        : [];
+    const textFilePaths = discoveredFiles
+        .filter((file) => !isRawUploadFile(file.path))
+        .map((file) => file.path);
+    const rawUploadFiles = discoveredFiles.filter((file) => isRawUploadFile(file.path));
+    const maxFileSizeBytes = runOptions.maxFileSizeBytes;
+    const rawUploadAttachments = await Promise.all(rawUploadFiles.map(async ({ path: filePath }) => {
         const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
         const stats = await fs.stat(resolvedPath);
+        if (maxFileSizeBytes && stats.size > maxFileSizeBytes) {
+            throw new FileValidationError(`The following file exceeds the ${maxFileSizeBytes}-byte limit:\n- ${path.relative(cwd, resolvedPath) || resolvedPath} (${stats.size} bytes)`, {
+                files: [resolvedPath],
+                limitBytes: maxFileSizeBytes,
+            });
+        }
         return {
             path: resolvedPath,
             displayPath: path.relative(cwd, resolvedPath) || path.basename(resolvedPath),
@@ -105,7 +191,10 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
         ? "never"
         : (runOptions.browserAttachments ?? "auto");
     const bundleRequested = Boolean(runOptions.browserBundleFiles);
-    const bundleFormat = runOptions.browserBundleFormat ?? "text";
+    const bundleFormat = runOptions.browserBundleFormat ?? "auto";
+    if (attachmentsPolicy === "never" && rawUploadAttachments.length > 0) {
+        throw new FileValidationError("Raw or binary files cannot be pasted inline when browser attachments are disabled. Use --browser-attachments auto or always.", { files: rawUploadAttachments.map((attachment) => attachment.displayPath) });
+    }
     const inlinePlan = buildAttachmentPlan(sections, { inlineFiles: true, bundleRequested });
     const uploadPlan = buildAttachmentPlan(sections, { inlineFiles: false, bundleRequested });
     const baseComposerSections = [];
@@ -124,25 +213,47 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
             : inlineComposerText.length <= DEFAULT_BROWSER_INLINE_CHAR_BUDGET || sections.length === 0
                 ? inlinePlan
                 : uploadPlan;
-    const composerText = (selectedPlan.inlineBlock
+    const textBundleSources = sections.map((section) => ({
+        absolutePath: section.absolutePath,
+        displayPath: section.displayPath,
+        sizeBytes: Buffer.byteLength(section.content, "utf8"),
+    }));
+    const rawUploadBundleSources = rawUploadAttachments.map((attachment) => ({
+        absolutePath: attachment.path,
+        displayPath: attachment.displayPath,
+        sizeBytes: attachment.sizeBytes ?? 0,
+    }));
+    const allBundleSources = [...textBundleSources, ...rawUploadBundleSources];
+    const attachments = [...selectedPlan.attachments, ...rawUploadAttachments];
+    const resolvedBundleFormat = resolveBrowserBundleFormat(bundleFormat, {
+        hasRawUploadFiles: rawUploadAttachments.length > 0,
+    });
+    const shouldBundle = shouldWriteBrowserBundle(resolvedBundleFormat, {
+        attachmentCount: attachments.length,
+        bundleRequested,
+        textSourceCount: textBundleSources.length,
+        textPlanShouldBundle: selectedPlan.shouldBundle,
+    });
+    const composerText = (!shouldBundle && selectedPlan.inlineBlock
         ? [...baseComposerSections, selectedPlan.inlineBlock]
         : baseComposerSections)
         .filter(Boolean)
         .join("\n\n")
         .trim();
-    const attachments = [...selectedPlan.attachments, ...mediaAttachments];
-    const shouldBundle = selectedPlan.shouldBundle;
     let bundleText = null;
     let bundled = null;
     if (shouldBundle) {
-        const writtenBundle = await writeBrowserBundle(sections, bundleFormat);
+        const writtenBundle = await writeBrowserBundle(sections, resolvedBundleFormat === "zip" ? allBundleSources : textBundleSources, resolvedBundleFormat);
         bundleText = writtenBundle.tokenEstimateText;
         attachments.length = 0;
         attachments.push(writtenBundle.attachment);
-        attachments.push(...mediaAttachments);
+        if (resolvedBundleFormat === "text") {
+            attachments.push(...rawUploadAttachments);
+        }
         bundled = writtenBundle.metadata;
     }
-    const inlineFileCount = selectedPlan.inlineFileCount;
+    assertAttachmentCount(attachments, resolvedBundleFormat);
+    const inlineFileCount = shouldBundle ? 0 : selectedPlan.inlineFileCount;
     const modelConfig = isKnownModel(runOptions.model)
         ? MODEL_CONFIGS[runOptions.model]
         : MODEL_CONFIGS["gpt-5.1"];
@@ -167,15 +278,27 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
     let fallback = null;
     if (attachmentsPolicy === "auto" && selectedPlan.mode === "inline" && sections.length > 0) {
         const fallbackComposerText = baseComposerSections.join("\n\n").trim();
-        const fallbackAttachments = [...uploadPlan.attachments, ...mediaAttachments];
+        const fallbackAttachments = [...uploadPlan.attachments, ...rawUploadAttachments];
         let fallbackBundled = null;
-        if (uploadPlan.shouldBundle) {
-            const writtenBundle = await writeBrowserBundle(sections, bundleFormat);
+        const fallbackBundleFormat = resolveBrowserBundleFormat(bundleFormat, {
+            hasRawUploadFiles: rawUploadAttachments.length > 0,
+        });
+        const fallbackShouldBundle = shouldWriteBrowserBundle(fallbackBundleFormat, {
+            attachmentCount: fallbackAttachments.length,
+            bundleRequested,
+            textSourceCount: textBundleSources.length,
+            textPlanShouldBundle: uploadPlan.shouldBundle,
+        });
+        if (fallbackShouldBundle) {
+            const writtenBundle = await writeBrowserBundle(sections, fallbackBundleFormat === "zip" ? allBundleSources : textBundleSources, fallbackBundleFormat);
             fallbackAttachments.length = 0;
             fallbackAttachments.push(writtenBundle.attachment);
-            fallbackAttachments.push(...mediaAttachments);
+            if (fallbackBundleFormat === "text") {
+                fallbackAttachments.push(...rawUploadAttachments);
+            }
             fallbackBundled = writtenBundle.metadata;
         }
+        assertAttachmentCount(fallbackAttachments, fallbackBundleFormat);
         fallback = {
             composerText: fallbackComposerText,
             attachments: fallbackAttachments,
@@ -190,7 +313,13 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
         inlineFileCount,
         tokenEstimateIncludesInlineFiles,
         attachmentsPolicy,
-        attachmentMode: selectedPlan.mode,
+        attachmentMode: shouldBundle
+            ? "bundle"
+            : attachments.length > 0
+                ? "upload"
+                : selectedPlan.mode === "bundle"
+                    ? "inline"
+                    : selectedPlan.mode,
         fallback,
         bundled,
     };

package/dist/src/cli/browserConfig.js

@@ -1,5 +1,6 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+import { normalizeThinkingTimeLevel } from "../oracle/thinkingTime.js";
 import { CHATGPT_URL, DEFAULT_MODEL_STRATEGY, DEFAULT_MODEL_TARGET } from "../browser/constants.js";
 import { normalizeChatgptUrl } from "../browser/utils.js";
 import { parseDuration } from "../duration.js";
@@ -63,6 +64,18 @@ export function normalizeChatGptModelForBrowser(model) {
     return model;
 }
 export async function buildBrowserConfig(options) {
+    if (options.copyProfile && options.browserKeepBrowser) {
+        throw new Error("--copy-profile cannot be combined with --browser-keep-browser: the copied profile is a throwaway that is deleted after the run, so it must not be retained.");
+    }
+    if (options.copyProfile && options.browserManualLogin) {
+        throw new Error("--copy-profile cannot be combined with --browser-manual-login: choose either a throwaway copied profile or the persistent manual-login profile.");
+    }
+    if (options.copyProfile && options.remoteChrome) {
+        throw new Error("--copy-profile cannot be combined with --remote-chrome: copied profiles require a locally launched Chrome instance.");
+    }
+    if (options.copyProfile && options.remoteHost) {
+        throw new Error("--copy-profile cannot be combined with --remote-host: the local profile source is not available to the remote browser service.");
+    }
     const desiredModelOverride = options.browserModelLabel?.trim();
     const normalizedOverride = desiredModelOverride?.toLowerCase() ?? "";
     const baseModel = options.model.toLowerCase();
@@ -97,7 +110,9 @@ export async function buildBrowserConfig(options) {
             ? desiredModelOverride
             : mapModelToBrowserLabel(options.model);
     return {
-        chromeProfile: options.browserChromeProfile ?? DEFAULT_CHROME_PROFILE,
+        chromeProfile: options.copyProfile
+            ? (options.browserChromeProfile ?? null)
+            : (options.browserChromeProfile ?? DEFAULT_CHROME_PROFILE),
         chromePath: options.browserChromePath ?? null,
         chromeCookiePath: options.browserCookiePath ?? null,
         attachRunning,
@@ -145,6 +160,7 @@ export async function buildBrowserConfig(options) {
         keepBrowser: options.browserKeepBrowser ? true : undefined,
         manualLogin: options.browserManualLogin === undefined ? undefined : options.browserManualLogin,
         manualLoginProfileDir: options.browserManualLoginProfileDir ?? undefined,
+        copyProfileSource: options.copyProfile ?? undefined,
         hideWindow: options.browserHideWindow ? true : undefined,
         desiredModel,
         modelStrategy,
@@ -153,7 +169,7 @@ export async function buildBrowserConfig(options) {
         allowCookieErrors: options.browserAllowCookieErrors ?? true,
         remoteChrome,
         browserTabRef: options.browserTab ?? undefined,
-        thinkingTime: options.browserThinkingTime,
+        thinkingTime: normalizeThinkingTimeLevel(options.browserThinkingTime) ?? undefined,
         researchMode: options.browserResearch === "deep" ? "deep" : "off",
         archiveConversations: options.browserArchive,
     };
@@ -170,6 +186,7 @@ function validateAttachRunningOptions(options, { attachRunning, hasInlineCookies
         options.browserKeepBrowser ? "--browser-keep-browser" : null,
         options.browserManualLogin ? "--browser-manual-login" : null,
         options.browserManualLoginProfileDir ? "--browser-manual-login-profile-dir" : null,
+        options.copyProfile ? "--copy-profile" : null,
         hasInlineCookies ? "--browser-inline-cookies/--browser-inline-cookies-file" : null,
         options.browserPort != null || options.browserDebugPort != null
             ? "--browser-port/--browser-debug-port"

package/dist/src/cli/browserDefaults.js

@@ -1,5 +1,6 @@
 import { CHATGPT_URL } from "../browser/constants.js";
 import { normalizeChatgptUrl } from "../browser/utils.js";
+import { normalizeThinkingTimeLevel } from "../oracle/thinkingTime.js";
 export function applyBrowserDefaultsFromConfig(options, config, getSource) {
     const browser = config.browser;
     if (!browser)
@@ -89,7 +90,7 @@ export function applyBrowserDefaultsFromConfig(options, config, getSource) {
         options.browserModelStrategy = browser.modelStrategy;
     }
     if (isUnset("browserThinkingTime") && browser.thinkingTime !== undefined) {
-        options.browserThinkingTime = browser.thinkingTime;
+        options.browserThinkingTime = normalizeThinkingTimeLevel(browser.thinkingTime) ?? undefined;
     }
     if (isUnset("browserResearch") && browser.researchMode !== undefined) {
         options.browserResearch = browser.researchMode;

package/dist/src/cli/options.js

@@ -3,6 +3,7 @@ import { parseDuration } from "../duration.js";
 import path from "node:path";
 import fg from "fast-glob";
 import { DEFAULT_MODEL, MODEL_CONFIGS } from "../oracle/config.js";
+import { normalizeThinkingTimeLevel } from "../oracle/thinkingTime.js";
 export function collectPaths(value, previous = []) {
     if (!value) {
         return previous;
@@ -127,6 +128,13 @@ export function parseSearchOption(value) {
     }
     throw new InvalidArgumentError('Search mode must be "on" or "off".');
 }
+export function parseThinkingTimeOption(value) {
+    const normalized = normalizeThinkingTimeLevel(value);
+    if (normalized) {
+        return normalized;
+    }
+    throw new InvalidArgumentError('Thinking time must be one of "light", "standard", "extended", "heavy", or a ChatGPT UI alias like "instant", "medium", "high", or "extra-high".');
+}
 export function normalizeModelOption(value) {
     return (value ?? "").trim();
 }

package/dist/src/cli/sessionRunner.js

@@ -389,6 +389,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             userError.details?.stage === "assistant-timeout";
         const cloudflareChallenge = userError?.category === "browser-automation" &&
             userError.details?.stage === "cloudflare-challenge";
+        const browserCanReattach = !browserConfig?.copyProfileSource;
         let reattachGuidanceLogged = false;
         const logBrowserReattachGuidance = (runtime) => {
             if (reattachGuidanceLogged || mode !== "browser")
@@ -399,7 +400,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             reattachGuidanceLogged = true;
             log(formatBrowserReattachGuidance(sessionMeta.id));
         };
-        if (connectionLost && mode === "browser") {
+        if (connectionLost && mode === "browser" && browserCanReattach) {
             const runtime = userError.details
                 ?.runtime;
             const recoverableRuntime = runtime ?? sessionMeta.browser?.runtime;
@@ -456,7 +457,7 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
             logBrowserReattachGuidance(recoverableRuntime);
             return;
         }
-        if (assistantTimeout && mode === "browser") {
+        if (assistantTimeout && mode === "browser" && browserCanReattach) {
             const runtime = userError.details
                 ?.runtime;
             log(dim("Assistant response timed out; marking capture incomplete for reattach."));
@@ -509,9 +510,14 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         }
         if (cloudflareChallenge && mode === "browser") {
             const details = userError.details;
-            log(dim("Cloudflare challenge detected; browser left running so you can complete the check."));
-            if (details?.reuseProfileHint) {
-                log(dim(`Reuse this browser profile with: ${details.reuseProfileHint}`));
+            if (browserCanReattach) {
+                log(dim("Cloudflare challenge detected; browser left running so you can complete the check."));
+                if (details?.reuseProfileHint) {
+                    log(dim(`Reuse this browser profile with: ${details.reuseProfileHint}`));
+                }
+            }
+            else {
+                log(dim("Cloudflare challenge detected; copied profile closed and removed."));
             }
         }
         if (userError) {
@@ -527,10 +533,10 @@ export async function performSessionRun({ sessionMeta, runOptions, mode, browser
         if (transportLine) {
             log(dim(`Transport: ${transportLine}`));
         }
-        const browserRuntime = mode === "browser"
+        const browserRuntime = mode === "browser" && browserCanReattach
             ? userError?.details?.runtime
             : undefined;
-        if (!cloudflareChallenge) {
+        if (!cloudflareChallenge && browserCanReattach) {
             logBrowserReattachGuidance(browserRuntime ?? sessionMeta.browser?.runtime);
         }
         await sessionStore.updateSession(sessionMeta.id, {

package/dist/src/mcp/tools/chatgptImage.js

@@ -2,6 +2,7 @@ import path from "node:path";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";
 import { getOracleHomeDir } from "../../oracleHome.js";
+import { browserThinkingTimeInputSchema, browserThinkingTimeRawSchema, } from "../types.js";
 import { consultOutputShape, runConsultTool } from "./consult.js";
 const chatGptImageInputShape = {
     prompt: z.string().min(1, "Prompt is required.").describe("Image generation prompt."),
@@ -29,8 +30,7 @@ const chatGptImageInputShape = {
         .enum(["auto", "never", "always"])
         .optional()
         .describe('How to deliver files. Defaults to "always" when files are present so reference images are uploaded.'),
-    browserThinkingTime: z
-        .enum(["light", "standard", "extended", "heavy"])
+    browserThinkingTime: browserThinkingTimeRawSchema
         .optional()
         .describe("Set ChatGPT thinking time when supported by the chosen model."),
     browserModelStrategy: z
@@ -58,7 +58,12 @@ const chatGptImageOutputShape = {
     ...consultOutputShape,
     requestedOutputPath: z.string(),
 };
-const chatGptImageInputSchema = z.object(chatGptImageInputShape).strict();
+const chatGptImageInputSchema = z
+    .object({
+    ...chatGptImageInputShape,
+    browserThinkingTime: browserThinkingTimeInputSchema.optional(),
+})
+    .strict();
 function resolveDefaultImageOutputPath() {
     // Include a random token so concurrent agent calls in the same millisecond do
     // not resolve to the same default path and overwrite each other.

package/dist/src/mcp/tools/consult.js

@@ -20,11 +20,12 @@ async function readSessionLogTail(sessionId, maxBytes) {
 import { performSessionRun } from "../../cli/sessionRunner.js";
 import { runDryRunSummary } from "../../cli/dryRun.js";
 import { CHATGPT_URL } from "../../browser/constants.js";
-import { CONSULT_PRESETS, consultInputSchema } from "../types.js";
+import { CONSULT_PRESETS, browserThinkingTimeRawSchema, consultInputSchema } from "../types.js";
 import { applyConsultPreset } from "../consultPresets.js";
 import { loadUserConfig } from "../../config.js";
 import { resolveNotificationSettings } from "../../cli/notifier.js";
 import { mapModelToBrowserLabel, resolveBrowserModelLabel } from "../../cli/browserConfig.js";
+import { normalizeThinkingTimeLevel } from "../../oracle/thinkingTime.js";
 // Use raw shapes so the MCP SDK (with its bundled Zod) wraps them and emits valid JSON Schema.
 const consultInputShape = {
     preset: z
@@ -61,11 +62,10 @@ const consultInputShape = {
         .optional()
         .describe("Browser-only: bundle many files into a single upload (helps with upload limits)."),
     browserBundleFormat: z
-        .enum(["text", "zip"])
+        .enum(["auto", "text", "zip"])
         .optional()
-        .describe('Browser-only: bundle upload format when browserBundleFiles is true or auto-bundling is needed. Defaults to "text"; "zip" preserves individual file names in one uploaded archive.'),
-    browserThinkingTime: z
-        .enum(["light", "standard", "extended", "heavy"])
+        .describe('Browser-only: bundle upload format when browserBundleFiles is true or auto-bundling is needed. Defaults to "auto"; "auto" uses ZIP when bundled inputs include raw/binary files.'),
+    browserThinkingTime: browserThinkingTimeRawSchema
         .optional()
         .describe("Browser-only: set ChatGPT thinking time when supported by the chosen model."),
     browserModelStrategy: z
@@ -166,7 +166,7 @@ const consultDryRunResolvedShape = z.object({
         researchMode: z.string().nullable().optional(),
         attachments: z.string().optional(),
         bundleFiles: z.boolean().optional(),
-        bundleFormat: z.enum(["text", "zip"]).optional(),
+        bundleFormat: z.enum(["auto", "text", "zip"]).optional(),
         keepBrowser: z.boolean().optional(),
         manualLogin: z.boolean().optional(),
         profileDir: z.string().nullable().optional(),
@@ -266,6 +266,7 @@ export function buildConsultBrowserConfig({ userConfig, env, runModel, inputMode
     const manualLogin = hasProfileDir
         ? true
         : (configuredBrowser.manualLogin ?? process.platform === "win32");
+    const configuredThinkingTime = normalizeThinkingTimeLevel(configuredBrowser.thinkingTime);
     return {
         ...configuredBrowser,
         url: configuredUrl,
@@ -278,7 +279,7 @@ export function buildConsultBrowserConfig({ userConfig, env, runModel, inputMode
         manualLoginProfileDir: manualLogin
             ? ((envProfileDir || configuredBrowser.manualLoginProfileDir) ?? null)
             : null,
-        thinkingTime: browserThinkingTime ?? configuredBrowser.thinkingTime,
+        thinkingTime: browserThinkingTime ?? configuredThinkingTime ?? undefined,
         modelStrategy: browserModelStrategy ?? configuredBrowser.modelStrategy,
         researchMode: browserResearchMode ?? configuredBrowser.researchMode,
         archiveConversations: browserArchive ?? configuredBrowser.archiveConversations,
@@ -358,7 +359,7 @@ export function formatConsultDryRunResolved(details) {
         lines.push(`  browser research mode: ${details.browser.researchMode ?? "off"}`);
         lines.push(`  browser attachments: ${details.browser.attachments ?? "auto"}`);
         lines.push(`  browser bundle files: ${details.browser.bundleFiles ? "yes" : "no"}`);
-        lines.push(`  browser bundle format: ${details.browser.bundleFormat ?? "text"}`);
+        lines.push(`  browser bundle format: ${details.browser.bundleFormat ?? "auto"}`);
         lines.push(`  browser keep browser: ${details.browser.keepBrowser ? "yes" : "no"}`);
         lines.push(`  browser manual login: ${details.browser.manualLogin ? "yes" : "no"}`);
         if (details.browser.profileDir) {

package/dist/src/mcp/types.js

@@ -1,5 +1,14 @@
 import { z } from "zod";
+import { THINKING_TIME_INPUT_VALUES, normalizeThinkingTimeLevel } from "../oracle/thinkingTime.js";
 export const CONSULT_PRESETS = ["chatgpt-pro-heavy"];
+export const browserThinkingTimeRawSchema = z.enum(THINKING_TIME_INPUT_VALUES);
+export const browserThinkingTimeInputSchema = browserThinkingTimeRawSchema.transform((value) => {
+    const normalized = normalizeThinkingTimeLevel(value);
+    if (!normalized) {
+        throw new Error(`Unknown browserThinkingTime value: ${value}`);
+    }
+    return normalized;
+});
 export const consultInputSchema = z
     .object({
     preset: z.enum(CONSULT_PRESETS).optional(),
@@ -11,8 +20,8 @@ export const consultInputSchema = z
     browserModelLabel: z.string().optional(),
     browserAttachments: z.enum(["auto", "never", "always"]).optional(),
     browserBundleFiles: z.boolean().optional(),
-    browserBundleFormat: z.enum(["text", "zip"]).optional(),
-    browserThinkingTime: z.enum(["light", "standard", "extended", "heavy"]).optional(),
+    browserBundleFormat: z.enum(["auto", "text", "zip"]).optional(),
+    browserThinkingTime: browserThinkingTimeInputSchema.optional(),
     browserModelStrategy: z.enum(["select", "current", "ignore"]).optional(),
     browserResearchMode: z.enum(["deep"]).optional(),
     browserArchive: z.enum(["auto", "always", "never"]).optional(),

package/dist/src/oracle/thinkingTime.js

@@ -0,0 +1,40 @@
+export const THINKING_TIME_LEVELS = ["light", "standard", "extended", "heavy"];
+export const THINKING_TIME_ALIASES = [
+    "instant",
+    "low",
+    "medium",
+    "high",
+    "extra-high",
+    "extra high",
+    "extrahigh",
+    "xhigh",
+];
+export const THINKING_TIME_INPUT_VALUES = [
+    ...THINKING_TIME_LEVELS,
+    ...THINKING_TIME_ALIASES,
+];
+export function normalizeThinkingTimeLevel(value) {
+    const normalized = (value ?? "")
+        .trim()
+        .toLowerCase()
+        .replace(/[_\s]+/g, "-");
+    switch (normalized) {
+        case "light":
+        case "instant":
+        case "low":
+            return "light";
+        case "standard":
+        case "medium":
+            return "standard";
+        case "extended":
+        case "high":
+            return "extended";
+        case "heavy":
+        case "extra-high":
+        case "extrahigh":
+        case "xhigh":
+            return "heavy";
+        default:
+            return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/oracle",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "CLI wrapper around OpenAI Responses API with 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",
@@ -61,7 +61,7 @@
     "@google/genai": "^2.8.0",
     "@google/generative-ai": "^0.24.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@steipete/sweet-cookie": "^0.3.0",
+    "@steipete/sweet-cookie": "^0.4.0",
     "chalk": "^5.6.2",
     "chrome-launcher": "^1.2.1",
     "chrome-remote-interface": "^0.34.0",
@@ -73,7 +73,7 @@
     "inquirer": "14.0.2",
     "json5": "^2.2.3",
     "kleur": "^4.1.5",
-    "markdansi": "0.2.1",
+    "markdansi": "0.3.1",
     "openai": "^6.42.0",
     "osc-progress": "^0.3.0",
     "qs": "^6.15.2",
@@ -87,8 +87,8 @@
     "@types/chrome-remote-interface": "^0.34.0",
     "@types/inquirer": "^9.0.9",
     "@types/node": "^25.9.2",
-    "@typescript/native-preview": "7.0.0-dev.20260609.1",
-    "@vitest/coverage-v8": "4.1.8",
+    "@typescript/native-preview": "7.0.0-dev.20260612.1",
+    "@vitest/coverage-v8": "4.1.9",
     "devtools-protocol": "0.0.1643702",
     "es-toolkit": "^1.47.0",
     "esbuild": "^0.28.0",
@@ -97,7 +97,7 @@
     "puppeteer-core": "^25.1.0",
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "vitest": "^4.1.9"
   },
   "devEngines": {
     "runtime": [