@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/cli/browserTabs.js

@@ -0,0 +1,228 @@
+import fs from "node:fs/promises";
+import { createHash } from "node:crypto";
+import chalk from "chalk";
+import { sessionStore } from "../sessionStore.js";
+import { collectChatGptTabs, DEFAULT_REMOTE_CHROME_HOST, DEFAULT_REMOTE_CHROME_PORT, extractConversationIdFromUrl, formatBrowserTabState, harvestChatGptTab, sessionMatchesTab, } from "../browser/liveTabs.js";
+import { resolveOutputPath } from "./writeOutputPath.js";
+const LIVE_POLL_MS = 2000;
+const DEFAULT_STALL_THRESHOLD_MS = 60_000;
+function sessionBrowserEndpoint(meta) {
+    const runtime = meta?.browser?.runtime ?? {};
+    const remote = meta?.browser?.config?.remoteChrome ?? {};
+    const host = runtime.chromeHost ?? remote.host;
+    const port = runtime.chromePort ?? remote.port;
+    if (!host || !port) {
+        return null;
+    }
+    return { host, port };
+}
+function collectUniqueEndpoints(metas) {
+    const entries = new Map();
+    entries.set(`${DEFAULT_REMOTE_CHROME_HOST}:${DEFAULT_REMOTE_CHROME_PORT}`, {
+        host: DEFAULT_REMOTE_CHROME_HOST,
+        port: DEFAULT_REMOTE_CHROME_PORT,
+    });
+    for (const meta of metas) {
+        const endpoint = sessionBrowserEndpoint(meta);
+        if (!endpoint) {
+            continue;
+        }
+        entries.set(`${endpoint.host}:${endpoint.port}`, endpoint);
+    }
+    return Array.from(entries.values());
+}
+function buildSessionIndex(metas) {
+    return metas
+        .filter((meta) => meta?.mode === "browser")
+        .sort((left, right) => String(right.createdAt ?? "").localeCompare(String(left.createdAt ?? "")));
+}
+function resolveLinkedSession(tab, metas) {
+    return buildSessionIndex(metas).find((meta) => sessionMatchesTab(meta, tab)) ?? null;
+}
+function snippet(text, max = 120) {
+    const normalized = String(text ?? "")
+        .replace(/\s+/g, " ")
+        .trim();
+    if (normalized.length <= max) {
+        return normalized;
+    }
+    return `${normalized.slice(0, Math.max(0, max - 1)).trimEnd()}…`;
+}
+function resolveSessionTabRef(meta) {
+    const runtime = meta?.browser?.runtime ?? {};
+    const harvest = meta?.browser?.harvest ?? {};
+    return (harvest.url ??
+        runtime.tabUrl ??
+        harvest.conversationId ??
+        runtime.conversationId ??
+        harvest.targetId ??
+        runtime.chromeTargetId ??
+        "current");
+}
+export function resolveSessionTabRefForTest(meta) {
+    return resolveSessionTabRef(meta);
+}
+async function persistHarvest(sessionId, meta, harvested) {
+    const hash = createHash("sha1")
+        .update(harvested.lastAssistantMarkdown ?? harvested.lastAssistantText ?? "")
+        .digest("hex");
+    const browser = {
+        ...(meta.browser ?? {}),
+        harvest: {
+            targetId: harvested.targetId,
+            url: harvested.url,
+            conversationId: harvested.conversationId ?? extractConversationIdFromUrl(harvested.url),
+            harvestedAt: new Date().toISOString(),
+            assistantHash: hash,
+            state: harvested.state,
+            stopExists: harvested.stopExists,
+            sendExists: harvested.sendExists,
+            assistantCount: harvested.assistantCount,
+            currentModelLabel: harvested.currentModelLabel,
+            lastAssistantSnippet: harvested.lastAssistantSnippet,
+        },
+    };
+    await sessionStore.updateSession(sessionId, { browser });
+}
+function printHarvestSummary(sessionId, harvested) {
+    console.log(chalk.bold(`Session: ${sessionId}`));
+    console.log(`Target: ${harvested.targetId}`);
+    console.log(`State: ${formatBrowserTabState(harvested)}`);
+    console.log(`Model: ${harvested.currentModelLabel || "(unknown)"}`);
+    console.log(`URL: ${harvested.url}`);
+    console.log(`Assistant turns: ${harvested.assistantCount}`);
+    console.log(`Signals: stop=${harvested.stopExists ? "yes" : "no"} send=${harvested.sendExists ? "yes" : "no"}`);
+    if (harvested.lastUserSnippet) {
+        console.log(`Last user: ${harvested.lastUserSnippet}`);
+    }
+    console.log(chalk.dim("---"));
+}
+async function maybeWriteHarvestOutput(pathInput, cwd, content) {
+    const resolved = resolveOutputPath(pathInput, cwd);
+    if (!resolved) {
+        return;
+    }
+    const payload = content ?? "";
+    if (resolved === "-" || resolved === "/dev/stdout") {
+        process.stdout.write(`${payload}${payload.endsWith("\n") ? "" : "\n"}`);
+        return;
+    }
+    await fs.writeFile(resolved, payload, "utf8");
+    console.log(chalk.dim(`Wrote harvested assistant output to ${resolved}`));
+}
+export async function showBrowserTabsStatus() {
+    const metas = await sessionStore.listSessions().catch(() => []);
+    const endpoints = collectUniqueEndpoints(metas);
+    let printedAny = false;
+    for (const endpoint of endpoints) {
+        let tabs;
+        try {
+            tabs = await collectChatGptTabs(endpoint);
+        }
+        catch {
+            continue;
+        }
+        if (tabs.length === 0) {
+            continue;
+        }
+        printedAny = true;
+        console.log(chalk.bold(`Browser Tabs ${endpoint.host}:${endpoint.port}`));
+        for (const tab of tabs) {
+            const linkedSession = resolveLinkedSession({ ...tab, host: endpoint.host, port: endpoint.port }, metas);
+            console.log(`- ${tab.targetId} ${formatBrowserTabState(tab)} model=${tab.currentModelLabel || "(unknown)"} turns=${tab.assistantCount} stop=${tab.stopExists ? "yes" : "no"} send=${tab.sendExists ? "yes" : "no"}`);
+            console.log(`  title=${tab.title || "(untitled)"}`);
+            console.log(`  url=${tab.url}`);
+            if (linkedSession) {
+                console.log(`  session=${linkedSession.id}`);
+            }
+            if (tab.lastAssistantSnippet) {
+                console.log(`  last=${snippet(tab.lastAssistantSnippet)}`);
+            }
+        }
+    }
+    if (!printedAny) {
+        console.log("No live ChatGPT tabs found on known Chrome DevTools endpoints.");
+    }
+}
+export async function harvestSessionBrowserOutput(sessionId, options = {}) {
+    const meta = await sessionStore.readSession(sessionId);
+    if (!meta) {
+        throw new Error(`No session found with ID ${sessionId}.`);
+    }
+    const endpoint = sessionBrowserEndpoint(meta) ?? {
+        host: DEFAULT_REMOTE_CHROME_HOST,
+        port: DEFAULT_REMOTE_CHROME_PORT,
+    };
+    const harvested = await harvestChatGptTab({
+        host: endpoint.host,
+        port: endpoint.port,
+        ref: options.browserTabRef ?? resolveSessionTabRef(meta),
+        stallWindowMs: options.stallWindowMs,
+    });
+    await persistHarvest(sessionId, meta, harvested);
+    printHarvestSummary(sessionId, harvested);
+    const output = harvested.lastAssistantMarkdown ?? harvested.lastAssistantText ?? "";
+    if (options.writeOutputPath) {
+        await maybeWriteHarvestOutput(options.writeOutputPath, meta.cwd ?? process.cwd(), output);
+    }
+    if (!options.quietOutput && output) {
+        process.stdout.write(`${output}${output.endsWith("\n") ? "" : "\n"}`);
+    }
+    return harvested;
+}
+export async function liveTailSessionBrowserOutput(sessionId, options = {}) {
+    const meta = await sessionStore.readSession(sessionId);
+    if (!meta) {
+        throw new Error(`No session found with ID ${sessionId}.`);
+    }
+    const endpoint = sessionBrowserEndpoint(meta) ?? {
+        host: DEFAULT_REMOTE_CHROME_HOST,
+        port: DEFAULT_REMOTE_CHROME_PORT,
+    };
+    const browserTabRef = options.browserTabRef ?? resolveSessionTabRef(meta);
+    const stallThresholdMs = options.stallThresholdMs ?? DEFAULT_STALL_THRESHOLD_MS;
+    let lastHash = null;
+    let unchangedSince = Date.now();
+    while (true) {
+        const harvested = await harvestChatGptTab({
+            host: endpoint.host,
+            port: endpoint.port,
+            ref: browserTabRef,
+        });
+        const fullText = harvested.lastAssistantMarkdown ?? harvested.lastAssistantText ?? "";
+        const hash = createHash("sha1").update(fullText).digest("hex");
+        if (hash !== lastHash) {
+            lastHash = hash;
+            unchangedSince = Date.now();
+            const statusLine = `[${new Date().toISOString()}] state=${harvested.state} stop=${harvested.stopExists ? "yes" : "no"} ` +
+                `send=${harvested.sendExists ? "yes" : "no"} model=${harvested.currentModelLabel || "(unknown)"} ` +
+                `snippet=${snippet(harvested.lastAssistantSnippet || fullText, 160)}`;
+            console.log(statusLine);
+            await persistHarvest(sessionId, meta, harvested);
+        }
+        const derivedState = harvested.stopExists
+            ? Date.now() - unchangedSince >= stallThresholdMs
+                ? "stalled"
+                : "running"
+            : harvested.authenticated
+                ? "completed"
+                : "detached";
+        if (derivedState === "completed" || derivedState === "stalled" || derivedState === "detached") {
+            const finalHarvest = {
+                ...harvested,
+                state: derivedState,
+            };
+            await persistHarvest(sessionId, meta, finalHarvest);
+            printHarvestSummary(sessionId, finalHarvest);
+            const output = finalHarvest.lastAssistantMarkdown ?? finalHarvest.lastAssistantText ?? "";
+            if (options.writeOutputPath) {
+                await maybeWriteHarvestOutput(options.writeOutputPath, meta.cwd ?? process.cwd(), output);
+            }
+            if (output) {
+                process.stdout.write(`${output}${output.endsWith("\n") ? "" : "\n"}`);
+            }
+            return finalHarvest;
+        }
+        await new Promise((resolve) => setTimeout(resolve, LIVE_POLL_MS));
+    }
+}

package/dist/src/cli/bundleWarnings.js

@@ -1,4 +1,4 @@
-import chalk from 'chalk';
+import chalk from "chalk";
 export function warnIfOversizeBundle(estimatedTokens, threshold = 196_000, log = console.log) {
     if (Number.isNaN(estimatedTokens) || estimatedTokens <= threshold) {
         return false;

package/dist/src/cli/clipboard.js

@@ -1,8 +1,17 @@
-import clipboard from 'clipboardy';
+async function loadClipboard() {
+    if (process.platform === "darwin" && process.arch === "x64") {
+        const paths = (process.env.PATH ?? "").split(":").filter(Boolean);
+        if (!paths.includes("/usr/sbin")) {
+            process.env.PATH = ["/usr/sbin", ...paths].join(":");
+        }
+    }
+    return (await import("clipboardy")).default;
+}
 export async function copyToClipboard(text) {
     try {
+        const clipboard = await loadClipboard();
         await clipboard.write(text);
-        return { success: true, command: 'clipboardy' };
+        return { success: true, command: "clipboardy" };
     }
     catch (error) {
         return { success: false, error };

package/dist/src/cli/detach.js

@@ -1,4 +1,4 @@
-import { isProModel } from '../oracle/modelResolver.js';
+import { isProModel } from "../oracle/modelResolver.js";
 export function shouldDetachSession({ 
 // Params kept for policy tweaks.
 engine, model, waitPreference, disableDetachEnv, }) {
@@ -8,7 +8,7 @@ engine, model, waitPreference, disableDetachEnv, }) {
     if (waitPreference)
         return false;
     // Only Pro-tier API runs should start detached by default; browser runs stay inline so failures surface.
-    if (isProModel(model) && engine === 'api')
+    if (isProModel(model) && engine === "api")
         return true;
     return false;
 }

package/dist/src/cli/dryRun.js

@@ -1,11 +1,12 @@
-import chalk from 'chalk';
-import { MODEL_CONFIGS, TOKENIZER_OPTIONS, DEFAULT_SYSTEM_PROMPT, buildPrompt, readFiles, getFileTokenStats, printFileTokenStats, } from '../oracle.js';
-import { isKnownModel } from '../oracle/modelResolver.js';
-import { assembleBrowserPrompt } from '../browser/prompt.js';
-import { buildTokenEstimateSuffix, formatAttachmentLabel } from '../browser/promptSummary.js';
-import { buildCookiePlan } from '../browser/policies.js';
+import chalk from "chalk";
+import { MODEL_CONFIGS, TOKENIZER_OPTIONS, DEFAULT_SYSTEM_PROMPT, buildPrompt, readFiles, getFileTokenStats, printFileTokenStats, } from "../oracle.js";
+import { isKnownModel } from "../oracle/modelResolver.js";
+import { assembleBrowserPrompt } from "../browser/prompt.js";
+import { buildTokenEstimateSuffix, formatAttachmentLabel } from "../browser/promptSummary.js";
+import { buildCookiePlan } from "../browser/policies.js";
+import { describeBrowserControlPlan, formatBrowserControlPlan } from "../browser/controlPlan.js";
 export async function runDryRunSummary({ engine, runOptions, cwd, version, log, browserConfig, }, deps = {}) {
-    if (engine === 'browser') {
+    if (engine === "browser") {
         await runBrowserDryRun({ runOptions, cwd, version, log, browserConfig }, deps);
         return;
     }
@@ -15,17 +16,19 @@ async function runApiDryRun({ runOptions, cwd, version, log, }, deps) {
     const readFilesImpl = deps.readFilesImpl ?? readFiles;
     const files = await readFilesImpl(runOptions.file ?? [], { cwd });
     const systemPrompt = runOptions.system?.trim() || DEFAULT_SYSTEM_PROMPT;
-    const combinedPrompt = buildPrompt(runOptions.prompt ?? '', files, cwd);
-    const modelConfig = isKnownModel(runOptions.model) ? MODEL_CONFIGS[runOptions.model] : MODEL_CONFIGS['gpt-5.1'];
+    const combinedPrompt = buildPrompt(runOptions.prompt ?? "", files, cwd);
+    const modelConfig = isKnownModel(runOptions.model)
+        ? MODEL_CONFIGS[runOptions.model]
+        : MODEL_CONFIGS["gpt-5.1"];
     const tokenizer = modelConfig.tokenizer;
     const estimatedInputTokens = tokenizer([
-        { role: 'system', content: systemPrompt },
-        { role: 'user', content: combinedPrompt },
+        { role: "system", content: systemPrompt },
+        { role: "user", content: combinedPrompt },
     ], TOKENIZER_OPTIONS);
     const headerLine = `[dry-run] Oracle (${version}) would call ${runOptions.model} with ~${estimatedInputTokens.toLocaleString()} tokens and ${files.length} files.`;
     log(chalk.cyan(headerLine));
     if (files.length === 0) {
-        log(chalk.dim('[dry-run] No files matched the provided --file patterns.'));
+        log(chalk.dim("[dry-run] No files matched the provided --file patterns."));
         return;
     }
     const inputBudget = runOptions.maxInput ?? modelConfig.inputLimit;
@@ -38,13 +41,23 @@ async function runApiDryRun({ runOptions, cwd, version, log, }, deps) {
     printFileTokenStats(stats, { inputTokenBudget: inputBudget, log });
 }
 async function runBrowserDryRun({ runOptions, cwd, version, log, browserConfig, }, deps) {
+    validateBrowserFollowUps(runOptions, browserConfig);
     const assemblePromptImpl = deps.assembleBrowserPromptImpl ?? assembleBrowserPrompt;
     const artifacts = await assemblePromptImpl(runOptions, { cwd });
     const suffix = buildTokenEstimateSuffix(artifacts);
     const headerLine = `[dry-run] Oracle (${version}) would launch browser mode (${runOptions.model}) with ~${artifacts.estimatedInputTokens.toLocaleString()} tokens${suffix}.`;
     log(chalk.cyan(headerLine));
-    logBrowserCookieStrategy(browserConfig, log, 'dry-run');
-    logBrowserFileSummary(artifacts, log, 'dry-run');
+    logBrowserControlPlan(browserConfig, log, "dry-run");
+    logBrowserFollowUpSummary(runOptions.browserFollowUps, log, "dry-run");
+    logBrowserCookieStrategy(browserConfig, log, "dry-run");
+    logBrowserArchivePolicy(browserConfig, log, "dry-run");
+    logBrowserFileSummary(artifacts, log, "dry-run");
+}
+function logBrowserControlPlan(browserConfig, log, label) {
+    const plan = describeBrowserControlPlan(browserConfig);
+    for (const line of formatBrowserControlPlan(plan, label)) {
+        log(chalk.dim(line));
+    }
 }
 function logBrowserCookieStrategy(browserConfig, log, label) {
     if (!browserConfig)
@@ -52,9 +65,15 @@ function logBrowserCookieStrategy(browserConfig, log, label) {
     const plan = buildCookiePlan(browserConfig);
     log(chalk.bold(`[${label}] ${plan.description}`));
 }
+function logBrowserArchivePolicy(browserConfig, log, label) {
+    const mode = browserConfig?.archiveConversations ?? "auto";
+    log(chalk.dim(`[${label}] ChatGPT archive policy: ${mode}.`));
+}
 function logBrowserFileSummary(artifacts, log, label) {
     if (artifacts.attachments.length > 0) {
-        const prefix = artifacts.bundled ? `[${label}] Bundled upload:` : `[${label}] Attachments to upload:`;
+        const prefix = artifacts.bundled
+            ? `[${label}] Bundled upload:`
+            : `[${label}] Attachments to upload:`;
         log(chalk.bold(prefix));
         artifacts.attachments.forEach((attachment) => {
             log(`  • ${formatAttachmentLabel(attachment)}`);
@@ -66,19 +85,22 @@ function logBrowserFileSummary(artifacts, log, label) {
     }
     if (artifacts.inlineFileCount > 0) {
         log(chalk.bold(`[${label}] Inline file content:`));
-        log(`  • ${artifacts.inlineFileCount} file${artifacts.inlineFileCount === 1 ? '' : 's'} pasted directly into the composer.`);
+        log(`  • ${artifacts.inlineFileCount} file${artifacts.inlineFileCount === 1 ? "" : "s"} pasted directly into the composer.`);
         return;
     }
     log(chalk.dim(`[${label}] No files attached.`));
 }
-export async function runBrowserPreview({ runOptions, cwd, version, previewMode, log, }, deps = {}) {
+export async function runBrowserPreview({ runOptions, cwd, version, previewMode, log, browserConfig, }, deps = {}) {
+    validateBrowserFollowUps(runOptions, browserConfig);
     const assemblePromptImpl = deps.assembleBrowserPromptImpl ?? assembleBrowserPrompt;
     const artifacts = await assemblePromptImpl(runOptions, { cwd });
     const suffix = buildTokenEstimateSuffix(artifacts);
     const headerLine = `[preview] Oracle (${version}) browser mode (${runOptions.model}) with ~${artifacts.estimatedInputTokens.toLocaleString()} tokens${suffix}.`;
     log(chalk.cyan(headerLine));
-    logBrowserFileSummary(artifacts, log, 'preview');
-    if (previewMode === 'json' || previewMode === 'full') {
+    logBrowserControlPlan(browserConfig, log, "preview");
+    logBrowserFollowUpSummary(runOptions.browserFollowUps, log, "preview");
+    logBrowserFileSummary(artifacts, log, "preview");
+    if (previewMode === "json" || previewMode === "full") {
         const attachmentSummary = artifacts.attachments.map((attachment) => ({
             path: attachment.path,
             displayPath: attachment.displayPath,
@@ -86,20 +108,34 @@ export async function runBrowserPreview({ runOptions, cwd, version, previewMode,
         }));
         const previewPayload = {
             model: runOptions.model,
-            engine: 'browser',
+            engine: "browser",
             composerText: artifacts.composerText,
             attachments: attachmentSummary,
             inlineFileCount: artifacts.inlineFileCount,
             bundled: artifacts.bundled,
             tokenEstimate: artifacts.estimatedInputTokens,
+            browserFollowUps: runOptions.browserFollowUps ?? [],
         };
-        log('');
-        log(chalk.bold('Preview JSON'));
+        log("");
+        log(chalk.bold("Preview JSON"));
         log(JSON.stringify(previewPayload, null, 2));
     }
-    if (previewMode === 'full') {
-        log('');
-        log(chalk.bold('Composer Text'));
-        log(artifacts.composerText || chalk.dim('(empty prompt)'));
+    if (previewMode === "full") {
+        log("");
+        log(chalk.bold("Composer Text"));
+        log(artifacts.composerText || chalk.dim("(empty prompt)"));
+    }
+}
+function logBrowserFollowUpSummary(followUps, log, label) {
+    const count = followUps?.filter((entry) => entry.trim().length > 0).length ?? 0;
+    if (count > 0) {
+        log(chalk.bold(`[${label}] Browser follow-ups: ${count} additional prompt(s).`));
+        log(chalk.dim(`[${label}] Multi-turn is explicit only: Oracle will send these prompts in order, but it never invents follow-ups automatically.`));
+    }
+}
+function validateBrowserFollowUps(runOptions, browserConfig) {
+    const followUpCount = runOptions.browserFollowUps?.filter((entry) => entry.trim().length > 0).length ?? 0;
+    if (followUpCount > 0 && browserConfig?.researchMode === "deep") {
+        throw new Error("Browser follow-ups are not supported with Deep Research mode. Put the full research plan into the initial prompt or run a normal browser consult for multi-turn review.");
     }
 }

package/dist/src/cli/duplicatePromptGuard.js

@@ -1,12 +1,20 @@
-import chalk from 'chalk';
-export async function shouldBlockDuplicatePrompt({ prompt, force, sessionStore, log = console.log, }) {
+import chalk from "chalk";
+function normalizeRunSignature(prompt, browserFollowUps) {
+    const followUps = (browserFollowUps ?? [])
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .join("\n\n--- browser follow-up ---\n\n");
+    return [prompt.trim(), followUps].filter(Boolean).join("\n\n--- browser follow-ups ---\n\n");
+}
+export async function shouldBlockDuplicatePrompt({ prompt, browserFollowUps, force, sessionStore, log = console.log, }) {
     if (force)
         return false;
     const normalized = prompt?.trim();
     if (!normalized)
         return false;
-    const running = (await sessionStore.listSessions()).filter((entry) => entry.status === 'running');
-    const duplicate = running.find((entry) => (entry.options?.prompt?.trim?.() ?? '') === normalized);
+    const signature = normalizeRunSignature(normalized, browserFollowUps);
+    const running = (await sessionStore.listSessions()).filter((entry) => entry.status === "running");
+    const duplicate = running.find((entry) => normalizeRunSignature(entry.options?.prompt?.trim?.() ?? "", entry.options?.browserFollowUps) === signature);
     if (!duplicate)
         return false;
     log(chalk.yellow(`A session with the same prompt is already running (${duplicate.id}). Reattach with "oracle session ${duplicate.id}" or rerun with --force to start another run.`));

package/dist/src/cli/engine.js

@@ -1,7 +1,7 @@
-import { isProModel } from '../oracle/modelResolver.js';
+import { isProModel } from "../oracle/modelResolver.js";
 export function defaultWaitPreference(model, engine) {
     // Pro-class API runs can take a long time; prefer non-blocking unless explicitly overridden.
-    if (engine === 'api' && isProModel(model)) {
+    if (engine === "api" && isProModel(model)) {
         return false;
     }
     return true; // browser or non-pro models are fast enough to block by default
@@ -17,7 +17,7 @@ export function defaultWaitPreference(model, engine) {
  */
 export function resolveEngine({ engine, browserFlag, env, }) {
     if (browserFlag) {
-        return 'browser';
+        return "browser";
     }
     if (engine) {
         return engine;
@@ -26,16 +26,16 @@ export function resolveEngine({ engine, browserFlag, env, }) {
     if (envEngine) {
         return envEngine;
     }
-    return env.OPENAI_API_KEY ? 'api' : 'browser';
+    return env.OPENAI_API_KEY ? "api" : "browser";
 }
 function normalizeEngineMode(raw) {
-    if (typeof raw !== 'string') {
+    if (typeof raw !== "string") {
         return null;
     }
     const normalized = raw.trim().toLowerCase();
-    if (normalized === 'api')
-        return 'api';
-    if (normalized === 'browser')
-        return 'browser';
+    if (normalized === "api")
+        return "api";
+    if (normalized === "browser")
+        return "browser";
     return null;
 }

package/dist/src/cli/errorUtils.js

@@ -1,4 +1,4 @@
-const LOGGED_SYMBOL = Symbol('oracle.alreadyLogged');
+const LOGGED_SYMBOL = Symbol("oracle.alreadyLogged");
 export function markErrorLogged(error) {
     if (error instanceof Error) {
         error[LOGGED_SYMBOL] = true;

package/dist/src/cli/fileSize.js

@@ -1,11 +1,11 @@
-import { normalizeMaxFileSizeBytes } from '../oracle/files.js';
+import { normalizeMaxFileSizeBytes } from "../oracle/files.js";
 export function resolveConfiguredMaxFileSizeBytes(userConfig, env = process.env) {
     const envValue = env.ORACLE_MAX_FILE_SIZE_BYTES?.trim();
     if (envValue) {
-        return normalizeMaxFileSizeBytes(envValue, 'ORACLE_MAX_FILE_SIZE_BYTES');
+        return normalizeMaxFileSizeBytes(envValue, "ORACLE_MAX_FILE_SIZE_BYTES");
     }
     if (userConfig?.maxFileSizeBytes !== undefined) {
-        return normalizeMaxFileSizeBytes(userConfig.maxFileSizeBytes, 'config.maxFileSizeBytes');
+        return normalizeMaxFileSizeBytes(userConfig.maxFileSizeBytes, "config.maxFileSizeBytes");
     }
     return undefined;
 }

package/dist/src/cli/format.js

@@ -1,8 +1,8 @@
 export function formatCompactNumber(value) {
     if (Number.isNaN(value) || !Number.isFinite(value))
-        return '0';
+        return "0";
     const abs = Math.abs(value);
-    const stripTrailingZero = (text) => text.replace(/\.0$/, '');
+    const stripTrailingZero = (text) => text.replace(/\.0$/, "");
     if (abs >= 1_000_000) {
         return `${stripTrailingZero((value / 1_000_000).toFixed(1))}m`;
     }

package/dist/src/cli/help.js

@@ -1,4 +1,4 @@
-import kleur from 'kleur';
+import kleur from "kleur";
 const createColorWrapper = (isTty) => (styler) => (text) => isTty ? styler(text) : text;
 export function applyHelpStyling(program, version, isTty) {
     const wrap = createColorWrapper(isTty);
@@ -34,44 +34,44 @@ export function applyHelpStyling(program, version, isTty) {
             return colors.argument(text);
         },
     });
-    program.addHelpText('beforeAll', () => renderHelpBanner(version, colors));
-    program.addHelpText('after', () => renderHelpFooter(program, colors));
+    program.addHelpText("beforeAll", () => renderHelpBanner(version, colors));
+    program.addHelpText("after", () => renderHelpFooter(program, colors));
 }
 function renderHelpBanner(version, colors) {
-    const subtitle = 'Prompt + files required — GPT-5.4 Pro/GPT-5.4 for tough questions with code/file context.';
+    const subtitle = "Prompt + files required — GPT-5.5 Pro/GPT-5.5 for tough questions with code/file context.";
     return `${colors.banner(`Oracle CLI v${version}`)} ${colors.subtitle(`— ${subtitle}`)}\n`;
 }
 function renderHelpFooter(program, colors) {
     const tips = [
-        `${colors.bullet('•')} Required: always pass a prompt AND ${colors.accent('--file …')} (directories/globs are fine); Oracle cannot see your project otherwise.`,
-        `${colors.bullet('•')} Attach lots of source (whole directories beat single files) and keep total input under ~196k tokens.`,
-        `${colors.bullet('•')} Oracle starts empty—open with a short project briefing (stack, services, build steps), spell out the question and prior attempts, and why it matters; the more explanation and context you provide, the better the response will be.`,
-        `${colors.bullet('•')} Spell out the project + platform + version requirements (repo name, target OS/toolchain versions, API dependencies) so Oracle doesn’t guess defaults.`,
-        `${colors.bullet('•')} When comparing multiple repos/files, spell out each repo + path + role (e.g., “Project A SettingsView → apps/project-a/Sources/SettingsView.swift; Project B SettingsView → ../project-b/mac/...”) so the model knows exactly which file is which.`,
-        `${colors.bullet('•')} Best results: 6–30 sentences plus key source files; very short prompts often yield generic answers.`,
-        `${colors.bullet('•')} Oracle is one-shot by default. For OpenAI/Azure API runs, you can chain follow-ups by passing ${colors.accent('--followup <sessionId|responseId>')} (continues via Responses API previous_response_id).`,
-        `${colors.bullet('•')} Run ${colors.accent('--files-report')} to inspect token spend before hitting the API.`,
-        `${colors.bullet('•')} Non-preview runs spawn detached sessions (especially gpt-5.4-pro API). If the CLI times out, do not re-run — reattach with ${colors.accent('oracle session <slug>')} to resume/inspect the existing run.`,
-        `${colors.bullet('•')} Set a memorable 3–5 word slug via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
-        `${colors.bullet('•')} Finished sessions auto-hide preamble logs when reattached; raw timestamps remain in the saved log file.`,
-        `${colors.bullet('•')} Need hidden flags? Run ${colors.accent(`${program.name()} --help --verbose`)} to list search/token/browser overrides.`,
-        `${colors.bullet('•')} If any Oracle session is already running, do not start new API runs. Attach to the existing browser session instead; only trigger API calls when you explicitly mean to.`,
-        `${colors.bullet('•')} Duplicate prompt guard: if the same prompt is already running, new runs are blocked unless you pass ${colors.accent('--force')}—prefer reattaching instead of spawning duplicates.`,
-    ].join('\n');
+        `${colors.bullet("•")} Required: always pass a prompt AND ${colors.accent("--file …")} (directories/globs are fine); Oracle cannot see your project otherwise.`,
+        `${colors.bullet("•")} Attach lots of source (whole directories beat single files) and keep total input under ~196k tokens.`,
+        `${colors.bullet("•")} Oracle starts empty—open with a short project briefing (stack, services, build steps), spell out the question and prior attempts, and why it matters; the more explanation and context you provide, the better the response will be.`,
+        `${colors.bullet("•")} Spell out the project + platform + version requirements (repo name, target OS/toolchain versions, API dependencies) so Oracle doesn’t guess defaults.`,
+        `${colors.bullet("•")} When comparing multiple repos/files, spell out each repo + path + role (e.g., “Project A SettingsView → apps/project-a/Sources/SettingsView.swift; Project B SettingsView → ../project-b/mac/...”) so the model knows exactly which file is which.`,
+        `${colors.bullet("•")} Best results: 6–30 sentences plus key source files; very short prompts often yield generic answers.`,
+        `${colors.bullet("•")} Oracle is one-shot by default. API runs can continue with ${colors.accent("--followup <sessionId|responseId>")}; browser runs can ask sequential ChatGPT turns with repeated ${colors.accent("--browser-follow-up")}.`,
+        `${colors.bullet("•")} Run ${colors.accent("--files-report")} to inspect token spend before hitting the API.`,
+        `${colors.bullet("•")} Non-preview runs spawn detached sessions (especially gpt-5.5-pro API). If the CLI times out, do not re-run — reattach with ${colors.accent("oracle session <slug>")} to resume/inspect the existing run.`,
+        `${colors.bullet("•")} Set a memorable 3–5 word slug via ${colors.accent('--slug "<words>"')} to keep session IDs tidy.`,
+        `${colors.bullet("•")} Finished sessions auto-hide preamble logs when reattached; raw timestamps remain in the saved log file.`,
+        `${colors.bullet("•")} Need hidden flags? Run ${colors.accent(`${program.name()} --help --verbose`)} to list search/token/browser overrides.`,
+        `${colors.bullet("•")} If any Oracle session is already running, do not start new API runs. Attach to the existing browser session instead; only trigger API calls when you explicitly mean to.`,
+        `${colors.bullet("•")} Duplicate prompt guard: if the same prompt is already running, new runs are blocked unless you pass ${colors.accent("--force")}—prefer reattaching instead of spawning duplicates.`,
+    ].join("\n");
     const formatExample = (command, description) => `${colors.command(`  ${command}`)}\n${colors.muted(`    ${description}`)}`;
     const examples = [
-        formatExample(`${program.name()} --render --copy --prompt "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"`, 'Build the bundle, print it, and copy it for manual paste into ChatGPT.'),
-        formatExample(`${program.name()} --prompt "Cross-check the data layer assumptions" --models gpt-5.2-pro,gemini-3-pro --file "src/**/*.ts"`, 'Run multiple API models in one go and aggregate cost/usage.'),
-        formatExample(`${program.name()} status --hours 72 --limit 50`, 'Show sessions from the last 72h (capped at 50 entries).'),
-        formatExample(`${program.name()} session <sessionId>`, 'Attach to a running/completed session and stream the saved transcript.'),
-        formatExample(`${program.name()} --prompt "Ship review" --slug "release-readiness-audit"`, 'Encourage the model to hand you a 3–5 word slug and pass it along with --slug.'),
-        formatExample(`${program.name()} --prompt "Tabs frozen: compare Project A SettingsView (apps/project-a/Sources/SettingsView.swift) vs Project B SettingsView (../project-b/mac/App/Presentation/Views/SettingsView.swift)" --file apps/project-a/Sources/SettingsView.swift --file ../project-b/mac/App/Presentation/Views/SettingsView.swift`, 'Spell out what each attached file is (repo + path + role) before asking for comparisons so the model knows exactly what it is reading.'),
-    ].join('\n\n');
+        formatExample(`${program.name()} --render --copy --prompt "Review the TS data layer for schema drift" --file "src/**/*.ts,*/*.test.ts"`, "Build the bundle, print it, and copy it for manual paste into ChatGPT."),
+        formatExample(`${program.name()} --prompt "Cross-check the data layer assumptions" --models gpt-5.2-pro,gemini-3-pro --file "src/**/*.ts"`, "Run multiple API models in one go and aggregate cost/usage."),
+        formatExample(`${program.name()} status --hours 72 --limit 50`, "Show sessions from the last 72h (capped at 50 entries)."),
+        formatExample(`${program.name()} session <sessionId>`, "Attach to a running/completed session and stream the saved transcript."),
+        formatExample(`${program.name()} --prompt "Ship review" --slug "release-readiness-audit"`, "Encourage the model to hand you a 3–5 word slug and pass it along with --slug."),
+        formatExample(`${program.name()} --prompt "Tabs frozen: compare Project A SettingsView (apps/project-a/Sources/SettingsView.swift) vs Project B SettingsView (../project-b/mac/App/Presentation/Views/SettingsView.swift)" --file apps/project-a/Sources/SettingsView.swift --file ../project-b/mac/App/Presentation/Views/SettingsView.swift`, "Spell out what each attached file is (repo + path + role) before asking for comparisons so the model knows exactly what it is reading."),
+    ].join("\n\n");
     return `
-${colors.section('Tips')}
+${colors.section("Tips")}
 ${tips}
 
-${colors.section('Examples')}
+${colors.section("Examples")}
 ${examples}
 `;
 }

package/dist/src/cli/hiddenAliases.js

@@ -9,14 +9,14 @@ export function applyHiddenAliases(options, setOptionValue) {
     if (options.include && options.include.length > 0) {
         const mergedFiles = [...(options.file ?? []), ...options.include];
         options.file = mergedFiles;
-        setOptionValue?.('file', mergedFiles);
+        setOptionValue?.("file", mergedFiles);
     }
     if (!options.prompt && options.message) {
         options.prompt = options.message;
-        setOptionValue?.('prompt', options.message);
+        setOptionValue?.("prompt", options.message);
     }
     if (!options.engine && options.mode) {
         options.engine = options.mode;
-        setOptionValue?.('engine', options.mode);
+        setOptionValue?.("engine", options.mode);
     }
 }