@steipete/oracle 0.8.6 → 0.10.0

package/dist/src/cli/tui/index.js

@@ -1,19 +1,20 @@
-import chalk from 'chalk';
-import inquirer from 'inquirer';
-import kleur from 'kleur';
-import path from 'node:path';
-import os from 'node:os';
-import fs from 'node:fs/promises';
-import { DEFAULT_MODEL, MODEL_CONFIGS } from '../../oracle.js';
-import { renderMarkdownAnsi } from '../markdownRenderer.js';
-import { sessionStore, pruneOldSessions } from '../../sessionStore.js';
-import { performSessionRun } from '../sessionRunner.js';
-import { MAX_RENDER_BYTES, trimBeforeFirstAnswer } from '../sessionDisplay.js';
-import { formatSessionTableHeader, formatSessionTableRow } from '../sessionTable.js';
-import { buildBrowserConfig, resolveBrowserModelLabel } from '../browserConfig.js';
-import { resolveNotificationSettings } from '../notifier.js';
-import { loadUserConfig } from '../../config.js';
-import { formatTokenCount } from '../../oracle/runUtils.js';
+import chalk from "chalk";
+import inquirer from "inquirer";
+import kleur from "kleur";
+import path from "node:path";
+import os from "node:os";
+import fs from "node:fs/promises";
+import { DEFAULT_MODEL, MODEL_CONFIGS, } from "../../oracle.js";
+import { renderMarkdownAnsi } from "../markdownRenderer.js";
+import { sessionStore, pruneOldSessions } from "../../sessionStore.js";
+import { performSessionRun } from "../sessionRunner.js";
+import { MAX_RENDER_BYTES, trimBeforeFirstAnswer } from "../sessionDisplay.js";
+import { formatSessionTableHeader, formatSessionTableRow } from "../sessionTable.js";
+import { buildBrowserConfig, resolveBrowserModelLabel } from "../browserConfig.js";
+import { resolveNotificationSettings } from "../notifier.js";
+import { loadUserConfig } from "../../config.js";
+import { resolveConfiguredMaxFileSizeBytes } from "../fileSize.js";
+import { formatTokenCount } from "../../oracle/runUtils.js";
 const isTty = () => Boolean(process.stdout.isTTY && chalk.level > 0);
 const dim = (text) => (isTty() ? kleur.dim(text) : text);
 const RECENT_WINDOW_HOURS = 24;
@@ -25,20 +26,20 @@ export async function launchTui({ version, printIntro = true }) {
     let exitMessageShown = false;
     if (printIntro) {
         if (rich) {
-            console.log(chalk.bold('🧿 oracle'), `${version}`, dim('— Whispering your tokens to the silicon sage'));
+            console.log(chalk.bold("🧿 oracle"), `${version}`, dim("— Whispering your tokens to the silicon sage"));
         }
         else {
             console.log(`🧿 oracle ${version} — Whispering your tokens to the silicon sage`);
         }
     }
-    console.log('');
+    console.log("");
     let showingOlder = false;
     for (;;) {
         const { recent, older, olderTotal } = await fetchSessionBuckets();
         const choices = [];
         const headerLabel = formatSessionTableHeader(isTty());
         // Start with a selectable row so focus never lands on a separator
-        choices.push({ name: chalk.bold.green('ask oracle'), value: '__ask__' });
+        choices.push({ name: chalk.bold.green("ask oracle"), value: "__ask__" });
         if (!showingOlder) {
             if (recent.length > 0) {
                 choices.push(new inquirer.Separator(headerLabel));
@@ -54,22 +55,22 @@ export async function launchTui({ version, printIntro = true }) {
             choices.push(new inquirer.Separator(headerLabel));
             choices.push(...older.map(toSessionChoice));
         }
-        choices.push(new inquirer.Separator(' '));
-        choices.push(new inquirer.Separator('Actions'));
-        choices.push({ name: chalk.bold.green('ask oracle'), value: '__ask__' });
+        choices.push(new inquirer.Separator(" "));
+        choices.push(new inquirer.Separator("Actions"));
+        choices.push({ name: chalk.bold.green("ask oracle"), value: "__ask__" });
         if (!showingOlder && olderTotal > 0) {
-            choices.push({ name: 'Older page', value: '__older__' });
+            choices.push({ name: "Older page", value: "__older__" });
         }
         else {
-            choices.push({ name: 'Newer (recent)', value: '__reset__' });
+            choices.push({ name: "Newer (recent)", value: "__reset__" });
         }
-        choices.push({ name: 'Exit', value: '__exit__' });
+        choices.push({ name: "Exit", value: "__exit__" });
         const selection = await new Promise((resolve) => {
             const prompt = inquirer.prompt([
                 {
-                    name: 'selection',
-                    type: 'select',
-                    message: 'Select a session or action',
+                    name: "selection",
+                    type: "select",
+                    message: "Select a session or action",
                     choices,
                     pageSize: 16,
                     loop: false,
@@ -80,40 +81,40 @@ export async function launchTui({ version, printIntro = true }) {
                 .catch((error) => {
                 pagingFailures += 1;
                 const message = error instanceof Error ? error.message : String(error);
-                if (message.includes('SIGINT') || message.includes('force closed the prompt')) {
-                    console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+                if (message.includes("SIGINT") || message.includes("force closed the prompt")) {
+                    console.log(chalk.green("🧿 Closing the book. See you next prompt."));
                     exitMessageShown = true;
-                    resolve('__exit__');
+                    resolve("__exit__");
                     return;
                 }
-                console.error(chalk.red('Paging failed; returning to recent list.'), message);
-                if (message.includes('setRawMode') || message.includes('EIO') || pagingFailures >= 3) {
-                    console.error(chalk.red('Terminal input unavailable; exiting TUI.'), dim('Try `stty sane` then rerun oracle, or use `oracle recent`.'));
-                    resolve('__exit__');
+                console.error(chalk.red("Paging failed; returning to recent list."), message);
+                if (message.includes("setRawMode") || message.includes("EIO") || pagingFailures >= 3) {
+                    console.error(chalk.red("Terminal input unavailable; exiting TUI."), dim("Try `stty sane` then rerun oracle, or use `oracle recent`."));
+                    resolve("__exit__");
                     return;
                 }
-                resolve('__reset__');
+                resolve("__reset__");
             });
         });
-        if (process.env.ORACLE_DEBUG_TUI === '1') {
+        if (process.env.ORACLE_DEBUG_TUI === "1") {
             console.error(`[tui] selection=${JSON.stringify(selection)}`);
         }
         pagingFailures = 0;
-        if (selection === '__exit__') {
+        if (selection === "__exit__") {
             if (!exitMessageShown) {
-                console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+                console.log(chalk.green("🧿 Closing the book. See you next prompt."));
             }
             return;
         }
-        if (selection === '__ask__') {
+        if (selection === "__ask__") {
             await askOracleFlow(version, userConfig);
             continue;
         }
-        if (selection === '__older__') {
+        if (selection === "__older__") {
             showingOlder = true;
             continue;
         }
-        if (selection === '__reset__') {
+        if (selection === "__reset__") {
             showingOlder = false;
             continue;
         }
@@ -123,13 +124,20 @@ export async function launchTui({ version, printIntro = true }) {
 async function fetchSessionBuckets() {
     const all = await sessionStore.listSessions();
     const cutoff = Date.now() - RECENT_WINDOW_HOURS * 60 * 60 * 1000;
-    const recent = all.filter((meta) => new Date(meta.createdAt).getTime() >= cutoff).slice(0, PAGE_SIZE);
+    const recent = all
+        .filter((meta) => new Date(meta.createdAt).getTime() >= cutoff)
+        .slice(0, PAGE_SIZE);
     const olderAll = all.filter((meta) => new Date(meta.createdAt).getTime() < cutoff);
     const older = olderAll.slice(0, PAGE_SIZE);
     const hasMoreOlder = olderAll.length > PAGE_SIZE;
     if (recent.length === 0 && older.length === 0 && olderAll.length > 0) {
         // No recent entries; fall back to top 10 overall.
-        return { recent: olderAll.slice(0, PAGE_SIZE), older: [], hasMoreOlder: olderAll.length > PAGE_SIZE, olderTotal: olderAll.length };
+        return {
+            recent: olderAll.slice(0, PAGE_SIZE),
+            older: [],
+            hasMoreOlder: olderAll.length > PAGE_SIZE,
+            olderTotal: olderAll.length,
+        };
     }
     return { recent, older, hasMoreOlder, olderTotal: olderAll.length };
 }
@@ -153,78 +161,80 @@ async function showSessionDetail(sessionId) {
         }
         const prompt = await readStoredPrompt(sessionId);
         if (prompt) {
-            console.log(chalk.bold('Prompt:'));
+            console.log(chalk.bold("Prompt:"));
             console.log(renderMarkdownAnsi(prompt));
-            console.log(dim('---'));
+            console.log(dim("---"));
         }
         const logPath = await getSessionLogPath(sessionId);
         if (logPath) {
             console.log(dim(`Log file: ${logPath}`));
         }
-        console.log('');
+        console.log("");
         await renderSessionLog(sessionId);
-        const isRunning = meta.status === 'running';
+        const isRunning = meta.status === "running";
         const modelActions = meta.models?.map((run) => ({
             name: `View ${run.model} log (${run.status})`,
             value: `log:${run.model}`,
         })) ?? [];
         const actions = [
-            { name: 'View combined log', value: 'log:__all__' },
+            { name: "View combined log", value: "log:__all__" },
             ...modelActions,
-            ...(isRunning ? [{ name: 'Refresh', value: 'refresh' }] : []),
-            { name: 'Back', value: 'back' },
+            ...(isRunning ? [{ name: "Refresh", value: "refresh" }] : []),
+            { name: "Back", value: "back" },
         ];
         let next;
         try {
             ({ next } = await inquirer.prompt([
                 {
-                    name: 'next',
-                    type: 'select',
-                    message: 'Actions',
+                    name: "next",
+                    type: "select",
+                    message: "Actions",
                     choices: actions,
                 },
             ]));
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
-            if (message.includes('SIGINT') || message.includes('force closed the prompt')) {
-                console.log(chalk.green('🧿 Closing the book. See you next prompt.'));
+            if (message.includes("SIGINT") || message.includes("force closed the prompt")) {
+                console.log(chalk.green("🧿 Closing the book. See you next prompt."));
                 return;
             }
-            console.error(chalk.red('Paging failed; returning to session list.'), message);
+            console.error(chalk.red("Paging failed; returning to session list."), message);
             return;
         }
-        if (next === 'back') {
+        if (next === "back") {
             return;
         }
-        if (next === 'refresh') {
+        if (next === "refresh") {
             continue;
         }
-        if (next.startsWith('log:')) {
-            const [, target] = next.split(':');
-            await renderSessionLog(sessionId, target === '__all__' ? undefined : target);
+        if (next.startsWith("log:")) {
+            const [, target] = next.split(":");
+            await renderSessionLog(sessionId, target === "__all__" ? undefined : target);
         }
     }
 }
 async function renderSessionLog(sessionId, model) {
-    const raw = model ? await sessionStore.readModelLog(sessionId, model) : await sessionStore.readLog(sessionId);
-    const headerLabel = model ? `Log (${model})` : 'Log';
+    const raw = model
+        ? await sessionStore.readModelLog(sessionId, model)
+        : await sessionStore.readLog(sessionId);
+    const headerLabel = model ? `Log (${model})` : "Log";
     console.log(chalk.bold(headerLabel));
     const text = trimBeforeFirstAnswer(raw);
-    const size = Buffer.byteLength(text, 'utf8');
+    const size = Buffer.byteLength(text, "utf8");
     if (size > MAX_RENDER_BYTES) {
         console.log(chalk.yellow(`Log is large (${size.toLocaleString()} bytes). Rendering raw text; open the log file for full context.`));
         process.stdout.write(text);
-        console.log('');
+        console.log("");
         return;
     }
     if (!text.trim()) {
-        console.log(dim('(log is empty)'));
-        console.log('');
+        console.log(dim("(log is empty)"));
+        console.log("");
         return;
     }
     process.stdout.write(renderMarkdownAnsi(text));
-    console.log('');
+    console.log("");
 }
 async function getSessionLogPath(sessionId) {
     try {
@@ -237,14 +247,14 @@ async function getSessionLogPath(sessionId) {
 }
 function printSessionHeader(meta) {
     console.log(chalk.bold(`Session ${chalk.cyan(meta.id)}`));
-    console.log(`${chalk.white('Status:')} ${meta.status}`);
-    console.log(`${chalk.white('Created:')} ${meta.createdAt}`);
+    console.log(`${chalk.white("Status:")} ${meta.status}`);
+    console.log(`${chalk.white("Created:")} ${meta.createdAt}`);
     if (meta.model) {
-        console.log(`${chalk.white('Model:')} ${meta.model}`);
+        console.log(`${chalk.white("Model:")} ${meta.model}`);
     }
     const mode = meta.mode ?? meta.options?.mode;
     if (mode) {
-        console.log(`${chalk.white('Mode:')} ${mode}`);
+        console.log(`${chalk.white("Mode:")} ${mode}`);
     }
     if (meta.errorMessage) {
         console.log(chalk.red(`Error: ${meta.errorMessage}`));
@@ -254,66 +264,66 @@ function printModelSummaries(models) {
     if (models.length === 0) {
         return;
     }
-    console.log(chalk.bold('Models:'));
+    console.log(chalk.bold("Models:"));
     for (const run of models) {
         const usage = run.usage
             ? ` tok=${formatTokenCount(run.usage.outputTokens ?? 0)}/${formatTokenCount(run.usage.totalTokens ?? 0)}`
-            : '';
+            : "";
         console.log(` - ${chalk.cyan(run.model)} — ${run.status}${usage}`);
     }
-    console.log('');
+    console.log("");
 }
 async function askOracleFlow(version, userConfig) {
     const modelChoices = Object.keys(MODEL_CONFIGS);
     const hasApiKey = Boolean(process.env.OPENAI_API_KEY);
-    const initialMode = hasApiKey ? 'api' : 'browser';
+    const initialMode = hasApiKey ? "api" : "browser";
     const preferredMode = userConfig.engine ?? initialMode;
     const wizardQuestions = [
         {
-            name: 'promptInput',
-            type: 'input',
-            message: 'Paste your prompt text or a path to a file (leave blank to cancel):',
+            name: "promptInput",
+            type: "input",
+            message: "Paste your prompt text or a path to a file (leave blank to cancel):",
         },
         ...(hasApiKey
             ? [
                 {
-                    name: 'mode',
-                    type: 'select',
-                    message: 'Engine',
+                    name: "mode",
+                    type: "select",
+                    message: "Engine",
                     default: preferredMode,
                     choices: [
-                        { name: 'API', value: 'api' },
-                        { name: 'Browser', value: 'browser' },
+                        { name: "API", value: "api" },
+                        { name: "Browser", value: "browser" },
                     ],
                 },
             ]
             : [
                 {
-                    name: 'mode',
-                    type: 'select',
-                    message: 'Engine',
+                    name: "mode",
+                    type: "select",
+                    message: "Engine",
                     default: preferredMode,
-                    choices: [{ name: 'Browser', value: 'browser' }],
+                    choices: [{ name: "Browser", value: "browser" }],
                 },
             ]),
         {
-            name: 'slug',
-            type: 'input',
-            message: 'Optional slug (3–5 words, leave blank for auto):',
+            name: "slug",
+            type: "input",
+            message: "Optional slug (3–5 words, leave blank for auto):",
         },
         {
-            name: 'model',
-            type: 'select',
-            message: 'Model',
+            name: "model",
+            type: "select",
+            message: "Model",
             default: DEFAULT_MODEL,
             choices: modelChoices,
         },
         {
-            name: 'models',
-            type: 'checkbox',
-            message: 'Additional API models to fan out to (optional)',
+            name: "models",
+            type: "checkbox",
+            message: "Additional API models to fan out to (optional)",
             choices: modelChoices,
-            when: (ans) => ans.mode === 'api',
+            when: (ans) => ans.mode === "api",
             filter: (values) => Array.isArray(values)
                 ? values
                     .map((entry) => entry.trim())
@@ -321,50 +331,52 @@ async function askOracleFlow(version, userConfig) {
                 : [],
         },
         {
-            name: 'files',
-            type: 'input',
-            message: 'Files or globs to attach (comma-separated, optional):',
+            name: "files",
+            type: "input",
+            message: "Files or globs to attach (comma-separated, optional):",
             filter: (value) => value
-                .split(',')
+                .split(",")
                 .map((entry) => entry.trim())
                 .filter(Boolean),
         },
         {
-            name: 'chromeProfile',
-            type: 'input',
-            message: 'Chrome profile to reuse cookies from:',
-            default: 'Default',
-            when: (ans) => ans.mode === 'browser',
+            name: "chromeProfile",
+            type: "input",
+            message: "Chrome profile to reuse cookies from:",
+            default: "Default",
+            when: (ans) => ans.mode === "browser",
         },
         {
-            name: 'chromeCookiePath',
-            type: 'input',
-            message: 'Cookie DB path (Chromium/Edge, optional):',
-            when: (ans) => ans.mode === 'browser',
+            name: "chromeCookiePath",
+            type: "input",
+            message: "Cookie DB path (Chromium/Edge, optional):",
+            when: (ans) => ans.mode === "browser",
         },
         {
-            name: 'hideWindow',
-            type: 'confirm',
-            message: 'Hide Chrome window (macOS headful only)?',
+            name: "hideWindow",
+            type: "confirm",
+            message: "Hide Chrome window (macOS headful only)?",
             default: false,
-            when: (ans) => ans.mode === 'browser',
+            when: (ans) => ans.mode === "browser",
         },
         {
-            name: 'keepBrowser',
-            type: 'confirm',
-            message: 'Keep browser open after completion?',
+            name: "keepBrowser",
+            type: "confirm",
+            message: "Keep browser open after completion?",
             default: false,
-            when: (ans) => ans.mode === 'browser',
+            when: (ans) => ans.mode === "browser",
         },
     ];
     const answers = await inquirer.prompt(wizardQuestions);
     const mode = (answers.mode ?? initialMode);
     const prompt = await resolvePromptInput(answers.promptInput);
     if (!prompt.trim()) {
-        console.log(chalk.yellow('Cancelled.'));
+        console.log(chalk.yellow("Cancelled."));
         return;
     }
-    const promptWithSuffix = userConfig.promptSuffix ? `${prompt.trim()}\n${userConfig.promptSuffix}` : prompt;
+    const promptWithSuffix = userConfig.promptSuffix
+        ? `${prompt.trim()}\n${userConfig.promptSuffix}`
+        : prompt;
     await sessionStore.ensureStorage();
     await pruneOldSessions(userConfig.sessionRetentionHours, (message) => console.log(chalk.dim(message)));
     const normalizedMultiModels = Array.isArray(answers.models) && answers.models.length > 0
@@ -374,6 +386,7 @@ async function askOracleFlow(version, userConfig) {
         prompt: promptWithSuffix,
         model: answers.model,
         file: answers.files,
+        maxFileSizeBytes: resolveConfiguredMaxFileSizeBytes(userConfig, process.env),
         models: normalizedMultiModels.length > 1 ? normalizedMultiModels : undefined,
         slug: answers.slug,
         filesReport: false,
@@ -388,12 +401,12 @@ async function askOracleFlow(version, userConfig) {
         sessionId: undefined,
         verbose: false,
         heartbeatIntervalMs: undefined,
-        browserAttachments: 'auto',
+        browserAttachments: "auto",
         browserInlineFiles: false,
         browserBundleFiles: false,
         background: undefined,
     };
-    const browserConfig = mode === 'browser'
+    const browserConfig = mode === "browser"
         ? await buildBrowserConfig({
             browserChromeProfile: answers.chromeProfile,
             browserCookiePath: answers.chromeCookiePath,
@@ -428,7 +441,7 @@ async function askOracleFlow(version, userConfig) {
         return true;
     };
     console.log(chalk.bold(`Session ${sessionMeta.id} starting...`));
-    console.log(dim(`Log path: ${path.join(os.homedir(), '.oracle', 'sessions', sessionMeta.id, 'output.log')}`));
+    console.log(dim(`Log path: ${path.join(os.homedir(), ".oracle", "sessions", sessionMeta.id, "output.log")}`));
     try {
         await performSessionRun({
             sessionMeta,
@@ -461,7 +474,7 @@ async function resolvePromptInput(rawInput) {
     try {
         const stats = await fs.stat(asPath);
         if (stats.isFile()) {
-            const contents = await fs.readFile(asPath, 'utf8');
+            const contents = await fs.readFile(asPath, "utf8");
             return contents;
         }
     }
@@ -483,4 +496,4 @@ async function readStoredPrompt(sessionId) {
 }
 // Exported for testing
 export { askOracleFlow, showSessionDetail };
-export { resolveSessionCost as resolveCost } from '../sessionTable.js';
+export { resolveSessionCost as resolveCost } from "../sessionTable.js";

package/dist/src/cli/writeOutputPath.js

@@ -1,12 +1,12 @@
-import os from 'node:os';
-import path from 'node:path';
-import { sessionStore } from '../sessionStore.js';
+import os from "node:os";
+import path from "node:path";
+import { sessionStore } from "../sessionStore.js";
 export function resolveOutputPath(input, cwd) {
     if (!input || input.trim().length === 0) {
         return undefined;
     }
-    const expanded = input.startsWith('~/') ? path.join(os.homedir(), input.slice(2)) : input;
-    if (expanded === '-' || expanded === '/dev/stdout') {
+    const expanded = input.startsWith("~/") ? path.join(os.homedir(), input.slice(2)) : input;
+    if (expanded === "-" || expanded === "/dev/stdout") {
         return expanded;
     }
     const absolute = path.isAbsolute(expanded) ? expanded : path.resolve(cwd, expanded);

package/dist/src/config.js

@@ -1,20 +1,20 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import JSON5 from 'json5';
-import { getOracleHomeDir } from './oracleHome.js';
+import fs from "node:fs/promises";
+import path from "node:path";
+import JSON5 from "json5";
+import { getOracleHomeDir } from "./oracleHome.js";
 function resolveConfigPath() {
-    return path.join(getOracleHomeDir(), 'config.json');
+    return path.join(getOracleHomeDir(), "config.json");
 }
 export async function loadUserConfig() {
     const CONFIG_PATH = resolveConfigPath();
     try {
-        const raw = await fs.readFile(CONFIG_PATH, 'utf8');
+        const raw = await fs.readFile(CONFIG_PATH, "utf8");
         const parsed = JSON5.parse(raw);
         return { config: parsed ?? {}, path: CONFIG_PATH, loaded: true };
     }
     catch (error) {
         const code = error.code;
-        if (code === 'ENOENT') {
+        if (code === "ENOENT") {
             return { config: {}, path: CONFIG_PATH, loaded: false };
         }
         console.warn(`Failed to read ${CONFIG_PATH}: ${error instanceof Error ? error.message : String(error)}`);

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

@@ -0,0 +1,80 @@
+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 { resolveBrowserConfig } from "../browser/config.js";
+import { readDevToolsPort, writeDevToolsActivePort, writeChromePid, cleanupStaleProfileState, verifyDevToolsReachable, } from "../browser/profileState.js";
+export async function openGeminiBrowserSession(input) {
+    const { browserConfig, keepBrowserDefault, purpose, log } = input;
+    const resolvedConfig = resolveBrowserConfig({
+        ...browserConfig,
+        manualLogin: true,
+        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);
+    let port = await readDevToolsPort(profileDir);
+    let launchedChrome = null;
+    let chromeWasLaunched = false;
+    if (port) {
+        const probe = await verifyDevToolsReachable({ port });
+        if (!probe.ok) {
+            log?.(`[gemini-web] Stale DevTools port ${port}; launching fresh Chrome for ${purpose}.`);
+            await cleanupStaleProfileState(profileDir, log, { lockRemovalMode: "if_oracle_pid_dead" });
+            port = null;
+        }
+    }
+    if (!port) {
+        log?.(`[gemini-web] Launching Chrome for ${purpose}.`);
+        launchedChrome = await launchChrome(resolvedConfig, profileDir, log ?? (() => { }));
+        port = launchedChrome.port;
+        chromeWasLaunched = true;
+        await writeDevToolsActivePort(profileDir, port);
+        if (launchedChrome.pid) {
+            await writeChromePid(profileDir, launchedChrome.pid);
+        }
+    }
+    else {
+        log?.(`[gemini-web] Reusing Chrome on port ${port} for ${purpose}.`);
+    }
+    const connection = await connectWithNewTab(port, log ?? (() => { }), undefined);
+    const client = connection.client;
+    const targetId = connection.targetId;
+    const close = async () => {
+        if (keepBrowser) {
+            try {
+                await client.close();
+            }
+            catch {
+                /* ignore */
+            }
+            return;
+        }
+        if (targetId && port) {
+            await closeTab(port, targetId, log ?? (() => { })).catch(() => undefined);
+        }
+        try {
+            await client.close();
+        }
+        catch {
+            /* ignore */
+        }
+        if (chromeWasLaunched && launchedChrome) {
+            try {
+                launchedChrome.kill();
+            }
+            catch {
+                /* ignore */
+            }
+            await cleanupStaleProfileState(profileDir, log, { lockRemovalMode: "never" }).catch(() => undefined);
+        }
+    };
+    return {
+        profileDir,
+        port,
+        client,
+        targetId: targetId ?? undefined,
+        close,
+    };
+}