@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/browser/constants.js

@@ -1,15 +1,21 @@
-export const CHATGPT_URL = 'https://chatgpt.com/';
-export const DEFAULT_MODEL_TARGET = 'GPT-5.4 Pro';
-export const DEFAULT_MODEL_STRATEGY = 'select';
-export const COOKIE_URLS = ['https://chatgpt.com', 'https://chat.openai.com', 'https://atlas.openai.com'];
+export const CHATGPT_URL = "https://chatgpt.com/";
+export const DEFAULT_MODEL_TARGET = "GPT-5.5 Pro";
+export const DEFAULT_MODEL_STRATEGY = "select";
+export const COOKIE_URLS = [
+    "https://chatgpt.com",
+    "https://chat.openai.com",
+    "https://atlas.openai.com",
+];
 export const INPUT_SELECTORS = [
     'textarea[data-id="prompt-textarea"]',
     'textarea[placeholder*="Send a message"]',
+    'textarea[aria-label="Chat with ChatGPT"]',
     'textarea[aria-label="Message ChatGPT"]',
-    'textarea:not([disabled])',
+    "textarea:not([disabled])",
     'textarea[name="prompt-textarea"]',
-    '#prompt-textarea',
-    '.ProseMirror',
+    "#prompt-textarea",
+    ".ProseMirror",
+    '[contenteditable="true"][role="textbox"]',
     '[contenteditable="true"][data-virtualkeyboard="true"]',
 ];
 export const ANSWER_SELECTORS = [
@@ -24,12 +30,12 @@ export const ANSWER_SELECTORS = [
     '[data-turn="assistant"]',
 ];
 export const CONVERSATION_TURN_SELECTOR = 'article[data-testid^="conversation-turn"], div[data-testid^="conversation-turn"], section[data-testid^="conversation-turn"], ' +
-    'article[data-message-author-role], div[data-message-author-role], section[data-message-author-role], ' +
-    'article[data-turn], div[data-turn], section[data-turn]';
+    "article[data-message-author-role], div[data-message-author-role], section[data-message-author-role], " +
+    "article[data-turn], div[data-turn], section[data-turn]";
 export const ASSISTANT_ROLE_SELECTOR = '[data-message-author-role="assistant"], [data-turn="assistant"]';
 export const CLOUDFLARE_SCRIPT_SELECTOR = 'script[src*="/challenge-platform/"]';
-export const CLOUDFLARE_TITLE = 'just a moment';
-export const PROMPT_PRIMARY_SELECTOR = '#prompt-textarea';
+export const CLOUDFLARE_TITLE = "just a moment";
+export const PROMPT_PRIMARY_SELECTOR = "#prompt-textarea";
 export const PROMPT_FALLBACK_SELECTOR = 'textarea[name="prompt-textarea"]';
 export const FILE_INPUT_SELECTORS = [
     'form input[type="file"]:not([accept])',
@@ -65,7 +71,14 @@ export const SEND_BUTTON_SELECTORS = [
     'button[aria-label*="Send"]',
 ];
 export const SEND_BUTTON_SELECTOR = SEND_BUTTON_SELECTORS[0];
-export const MODEL_BUTTON_SELECTOR = '[data-testid="model-switcher-dropdown-button"]';
+export const MODEL_BUTTON_SELECTOR = '[data-testid="model-switcher-dropdown-button"], button.__composer-pill[aria-haspopup="menu"]';
+export const COMPOSER_MODEL_SIGNAL_SELECTOR = '[data-testid="composer-footer-actions"]';
 export const COPY_BUTTON_SELECTOR = 'button[data-testid="copy-turn-action-button"]';
 // Action buttons that only appear once a turn has finished rendering.
+export const DEEP_RESEARCH_PLUS_BUTTON = '[data-testid="composer-plus-btn"]';
+export const DEEP_RESEARCH_DROPDOWN_ITEM_TEXT = "Deep research";
+export const DEEP_RESEARCH_PILL_LABEL = "Deep research";
+export const DEEP_RESEARCH_POLL_INTERVAL_MS = 5_000;
+export const DEEP_RESEARCH_AUTO_CONFIRM_WAIT_MS = 70_000;
+export const DEEP_RESEARCH_DEFAULT_TIMEOUT_MS = 2_400_000;
 export const FINISHED_ACTIONS_SELECTOR = 'button[data-testid="copy-turn-action-button"], button[data-testid="good-response-turn-action-button"], button[data-testid="bad-response-turn-action-button"], button[aria-label="Share"]';

package/dist/src/browser/controlPlan.js

@@ -0,0 +1,81 @@
+export function describeBrowserControlPlan(config = {}) {
+    const guidance = [];
+    const tabRef = String(config.browserTabRef ?? "").trim();
+    const reusesExistingTab = tabRef.length > 0;
+    if (config.attachRunning) {
+        guidance.push(reusesExistingTab
+            ? `Oracle reuses the matching ChatGPT tab (${tabRef}) and leaves the existing browser process alone.`
+            : "Oracle opens a dedicated tab and leaves the existing browser process alone.");
+        if (config.keepBrowser) {
+            guidance.push("The browser stays open because Oracle did not launch it.");
+        }
+        return {
+            mode: "attach-running",
+            launchesChrome: false,
+            mayFocusWindow: true,
+            summary: reusesExistingTab
+                ? "attach to an already-running local Chrome tab"
+                : "attach to an already-running local Chrome session",
+            guidance,
+        };
+    }
+    if (config.remoteChrome) {
+        guidance.push(reusesExistingTab
+            ? `Oracle reuses the matching ChatGPT tab (${tabRef}) in the configured remote Chrome session.`
+            : "Oracle opens a dedicated tab in the configured remote Chrome session.");
+        guidance.push("Local Chrome launch, cookie copy, and window hiding flags are skipped.");
+        return {
+            mode: "remote-chrome",
+            launchesChrome: false,
+            mayFocusWindow: false,
+            summary: reusesExistingTab
+                ? "reuse an existing remote Chrome tab"
+                : "reuse an existing remote Chrome session",
+            guidance,
+        };
+    }
+    if (config.headless) {
+        guidance.push("Headless mode avoids visible UI but may be blocked by ChatGPT or Cloudflare.");
+        return {
+            mode: "headless",
+            launchesChrome: true,
+            mayFocusWindow: false,
+            summary: "launch headless Chrome",
+            guidance,
+        };
+    }
+    if (config.hideWindow) {
+        guidance.push("Chrome may briefly focus while launching before Oracle hides it.");
+        guidance.push("For the calmest shared-desktop flow, prefer --browser-attach-running or --remote-chrome.");
+        return {
+            mode: "hidden-window",
+            launchesChrome: true,
+            mayFocusWindow: true,
+            summary: "launch Chrome and hide the window after startup",
+            guidance,
+        };
+    }
+    guidance.push(config.manualLogin
+        ? "Manual-login mode may show the persistent Oracle Chrome profile for sign-in or automation."
+        : "A visible automation Chrome window may take focus while Oracle controls ChatGPT.");
+    guidance.push("Use --browser-hide-window, --browser-attach-running, or --remote-chrome to reduce desktop disruption.");
+    if (config.keepBrowser) {
+        guidance.push("Chrome will remain open after the run because --browser-keep-browser is enabled.");
+    }
+    return {
+        mode: "visible-window",
+        launchesChrome: true,
+        mayFocusWindow: true,
+        summary: "launch visible Chrome",
+        guidance,
+    };
+}
+export function formatBrowserControlPlan(plan, label = "browser") {
+    const risk = plan.mayFocusWindow
+        ? "may focus/control the browser UI"
+        : "does not use a visible local browser window";
+    return [
+        `[${label}] Browser control: ${plan.summary}; ${risk}.`,
+        ...plan.guidance.map((entry) => `[${label}] Browser guidance: ${entry}`),
+    ];
+}

package/dist/src/browser/cookies.js

@@ -1,6 +1,6 @@
-import { COOKIE_URLS } from './constants.js';
-import { delay } from './utils.js';
-import { getCookies } from '@steipete/sweet-cookie';
+import { COOKIE_URLS } from "./constants.js";
+import { delay } from "./utils.js";
+import { getCookies } from "@steipete/sweet-cookie";
 export class ChromeCookieSyncError extends Error {
 }
 export async function syncCookies(Network, url, profile, logger, options = {}) {
@@ -55,7 +55,7 @@ async function readChromeCookiesWithWait(url, profile, filterNames, cookiePath,
         return cookies;
     }
     const waitLabel = waitMs >= 1000 ? `${Math.round(waitMs / 1000)}s` : `${waitMs}ms`;
-    const message = firstError instanceof Error ? firstError.message : String(firstError ?? '');
+    const message = firstError instanceof Error ? firstError.message : String(firstError ?? "");
     if (firstError) {
         logger(`[cookies] Cookie read failed (${message}); waiting ${waitLabel} then retrying once.`);
     }
@@ -68,27 +68,27 @@ async function readChromeCookiesWithWait(url, profile, filterNames, cookiePath,
 async function readChromeCookies(url, profile, filterNames, cookiePath) {
     const origins = Array.from(new Set([stripQuery(url), ...COOKIE_URLS]));
     const chromeProfile = cookiePath ?? profile ?? undefined;
-    const timeoutMs = readDuration('ORACLE_COOKIE_LOAD_TIMEOUT_MS', 5_000);
+    const timeoutMs = readDuration("ORACLE_COOKIE_LOAD_TIMEOUT_MS", 5_000);
     // Learned: read from multiple origins to capture auth cookies that land on chat.openai.com + atlas.
     const { cookies, warnings } = await getCookies({
         url,
         origins,
         names: filterNames?.length ? filterNames : undefined,
-        browsers: ['chrome'],
-        mode: 'merge',
+        browsers: ["chrome"],
+        mode: "merge",
         chromeProfile,
         timeoutMs,
     });
-    if (process.env.ORACLE_DEBUG_COOKIES === '1' && warnings.length) {
+    if (process.env.ORACLE_DEBUG_COOKIES === "1" && warnings.length) {
         // eslint-disable-next-line no-console
-        console.log(`[cookies] sweet-cookie warnings:\n- ${warnings.join('\n- ')}`);
+        console.log(`[cookies] sweet-cookie warnings:\n- ${warnings.join("\n- ")}`);
     }
     const merged = new Map();
     for (const cookie of cookies) {
         const normalized = toCdpCookie(cookie);
         if (!normalized)
             continue;
-        const key = `${normalized.domain ?? ''}:${normalized.name}`;
+        const key = `${normalized.domain ?? ""}:${normalized.name}`;
         if (!merged.has(key))
             merged.set(key, normalized);
     }
@@ -102,10 +102,10 @@ function normalizeInlineCookies(rawCookies, fallbackHost) {
         // Learned: inline cookies may omit url/domain; default to current host with a safe path.
         const normalized = {
             name: cookie.name,
-            value: cookie.value ?? '',
+            value: cookie.value ?? "",
             url: cookie.url,
             domain: cookie.domain ?? fallbackHost,
-            path: cookie.path ?? '/',
+            path: cookie.path ?? "/",
             expires: normalizeExpiration(cookie.expires),
             secure: cookie.secure ?? true,
             httpOnly: cookie.httpOnly ?? false,
@@ -125,13 +125,13 @@ function toCdpCookie(cookie) {
         name: cookie.name,
         value: cookie.value,
         domain: cookie.domain,
-        path: cookie.path ?? '/',
+        path: cookie.path ?? "/",
         secure: cookie.secure ?? true,
         httpOnly: cookie.httpOnly ?? false,
     };
-    if (typeof cookie.expires === 'number')
+    if (typeof cookie.expires === "number")
         out.expires = cookie.expires;
-    if (cookie.sameSite === 'Lax' || cookie.sameSite === 'Strict' || cookie.sameSite === 'None') {
+    if (cookie.sameSite === "Lax" || cookie.sameSite === "Strict" || cookie.sameSite === "None") {
         out.sameSite = cookie.sameSite;
     }
     return out;
@@ -139,10 +139,10 @@ function toCdpCookie(cookie) {
 function attachUrl(cookie, fallbackUrl) {
     const cookieWithUrl = { ...cookie };
     if (!cookieWithUrl.url) {
-        if (!cookieWithUrl.domain || cookieWithUrl.domain === 'localhost') {
+        if (!cookieWithUrl.domain || cookieWithUrl.domain === "localhost") {
             cookieWithUrl.url = fallbackUrl;
         }
-        else if (!cookieWithUrl.domain.startsWith('.')) {
+        else if (!cookieWithUrl.domain.startsWith(".")) {
             cookieWithUrl.url = `https://${cookieWithUrl.domain}`;
         }
     }
@@ -156,8 +156,8 @@ function attachUrl(cookie, fallbackUrl) {
 function stripQuery(url) {
     try {
         const parsed = new URL(url);
-        parsed.hash = '';
-        parsed.search = '';
+        parsed.hash = "";
+        parsed.search = "";
         return parsed.toString();
     }
     catch {

package/dist/src/browser/detect.js

@@ -1,9 +1,9 @@
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-import { Launcher } from 'chrome-launcher';
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { Launcher } from "chrome-launcher";
 export async function detectChromeBinary() {
-    const envPath = (process.env.CHROME_PATH ?? '').trim();
+    const envPath = (process.env.CHROME_PATH ?? "").trim();
     if (envPath) {
         const ok = await isExecutable(envPath);
         if (ok) {
@@ -14,7 +14,7 @@ export async function detectChromeBinary() {
     if (launcherDetected) {
         return { path: launcherDetected };
     }
-    const candidates = platformChromeCandidates();
+    const candidates = platformChromeCandidates(process.platform, os.homedir());
     for (const candidate of candidates.absolutePaths) {
         if (await isExecutable(candidate)) {
             return { path: candidate };
@@ -26,112 +26,234 @@ export async function detectChromeBinary() {
     }
     return { path: null };
 }
-export async function detectChromeCookieDb({ profile }) {
-    const profileName = profile?.trim() ? profile.trim() : 'Default';
-    if (process.platform === 'win32') {
+export async function detectChromeCookieDb({ profile, }) {
+    const profileName = profile?.trim() ? profile.trim() : "Default";
+    if (process.platform === "win32") {
         return null;
     }
-    const roots = platformProfileRoots();
+    const roots = resolveAttachRunningProfileRoots();
     for (const root of roots) {
-        const dir = path.join(root, profileName);
-        const direct = path.join(dir, 'Cookies');
+        const dir = path.join(root.root, profileName);
+        const direct = path.join(dir, "Cookies");
         if (await isFile(direct))
             return direct;
-        const network = path.join(dir, 'Network', 'Cookies');
+        const network = path.join(dir, "Network", "Cookies");
         if (await isFile(network))
             return network;
     }
     return null;
 }
-function platformChromeCandidates() {
-    if (process.platform === 'linux') {
+export function resolveAttachRunningProfileRoots(platform = process.platform, homeDir = os.homedir()) {
+    if (platform === "darwin") {
+        return [
+            {
+                family: "chrome",
+                root: path.join(homeDir, "Library", "Application Support", "Google", "Chrome"),
+            },
+            {
+                family: "chromium",
+                root: path.join(homeDir, "Library", "Application Support", "Chromium"),
+            },
+            {
+                family: "edge",
+                root: path.join(homeDir, "Library", "Application Support", "Microsoft Edge"),
+            },
+            {
+                family: "brave",
+                root: path.join(homeDir, "Library", "Application Support", "BraveSoftware", "Brave-Browser"),
+            },
+        ];
+    }
+    if (platform === "linux") {
+        return [
+            { family: "chrome", root: path.join(homeDir, ".config", "google-chrome") },
+            { family: "chromium", root: path.join(homeDir, ".config", "chromium") },
+            { family: "edge", root: path.join(homeDir, ".config", "microsoft-edge") },
+            {
+                family: "brave",
+                root: path.join(homeDir, ".config", "BraveSoftware", "Brave-Browser"),
+            },
+            { family: "chromium", root: path.join(homeDir, "snap", "chromium", "common", "chromium") },
+            { family: "chromium", root: path.join(homeDir, "snap", "chromium", "current", "chromium") },
+        ];
+    }
+    if (platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA ?? path.join(homeDir, "AppData", "Local");
+        return [
+            {
+                family: "chrome",
+                root: path.join(localAppData, "Google", "Chrome", "User Data"),
+            },
+            {
+                family: "chromium",
+                root: path.join(localAppData, "Chromium", "User Data"),
+            },
+            {
+                family: "edge",
+                root: path.join(localAppData, "Microsoft", "Edge", "User Data"),
+            },
+            {
+                family: "brave",
+                root: path.join(localAppData, "BraveSoftware", "Brave-Browser", "User Data"),
+            },
+        ];
+    }
+    return [];
+}
+export function resolveDevToolsActivePortDiscoveryRoots(platform = process.platform, homeDir = os.homedir()) {
+    if (platform === "darwin") {
+        return [path.join(homeDir, "Library", "Application Support")];
+    }
+    if (platform === "linux") {
+        return [path.join(homeDir, ".config"), path.join(homeDir, "snap")];
+    }
+    if (platform === "win32") {
+        return [process.env.LOCALAPPDATA ?? path.join(homeDir, "AppData", "Local")];
+    }
+    return [];
+}
+export function inferAttachRunningBrowserFamily(chromePath) {
+    const normalized = chromePath?.trim().toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    if (normalized.includes("microsoft edge") || normalized.includes("msedge")) {
+        return "edge";
+    }
+    if (normalized.includes("brave")) {
+        return "brave";
+    }
+    if (normalized.includes("chromium")) {
+        return "chromium";
+    }
+    if (normalized.includes("chrome")) {
+        return "chrome";
+    }
+    return null;
+}
+export function parseDevToolsActivePort(raw, options = {}) {
+    const host = formatWebSocketHost(options.host ?? "127.0.0.1");
+    const [rawPort, rawBrowserPath] = raw.split(/\r?\n/u);
+    const port = Number.parseInt(rawPort?.trim() ?? "", 10);
+    if (!Number.isFinite(port) || port <= 0 || port > 65_535) {
+        throw new Error("DevToolsActivePort did not contain a valid port.");
+    }
+    const browserPath = rawBrowserPath?.trim() || "/devtools/browser";
+    const normalizedPath = browserPath.startsWith("/") ? browserPath : `/${browserPath}`;
+    return {
+        port,
+        browserWSEndpoint: `ws://${host}:${port}${normalizedPath}`,
+    };
+}
+export async function readDevToolsActivePortInfo(profileRoot, options = {}) {
+    const candidates = [
+        path.join(profileRoot, "DevToolsActivePort"),
+        path.join(profileRoot, "Default", "DevToolsActivePort"),
+    ];
+    for (const candidate of candidates) {
+        try {
+            const raw = await fs.readFile(candidate, "utf8");
+            const parsed = parseDevToolsActivePort(raw, options);
+            return { ...parsed, path: candidate };
+        }
+        catch {
+            // ignore missing/unreadable candidates
+        }
+    }
+    return null;
+}
+export async function discoverDevToolsActivePortCandidates(options = {}) {
+    const { host, platform = process.platform, homeDir = os.homedir(), maxDepth = 6 } = options;
+    const roots = resolveDevToolsActivePortDiscoveryRoots(platform, homeDir);
+    const candidates = [];
+    const seenPaths = new Set();
+    for (const root of roots) {
+        await walkForDevToolsActivePort(root, maxDepth, async (candidatePath, stat) => {
+            if (seenPaths.has(candidatePath)) {
+                return;
+            }
+            seenPaths.add(candidatePath);
+            try {
+                const raw = await fs.readFile(candidatePath, "utf8");
+                const parsed = parseDevToolsActivePort(raw, { host });
+                candidates.push({
+                    ...parsed,
+                    path: candidatePath,
+                    profileRoot: deriveDevToolsProfileRoot(candidatePath),
+                    mtimeMs: Number(stat.mtimeMs),
+                });
+            }
+            catch {
+                // ignore unreadable or malformed DevToolsActivePort files
+            }
+        });
+    }
+    return candidates;
+}
+function platformChromeCandidates(platform = process.platform, homeDir = os.homedir()) {
+    if (platform === "linux") {
         return {
             binaryNames: [
-                'google-chrome',
-                'google-chrome-stable',
-                'chromium',
-                'chromium-browser',
-                'brave-browser',
-                'microsoft-edge',
-                'microsoft-edge-stable',
+                "google-chrome",
+                "google-chrome-stable",
+                "chromium",
+                "chromium-browser",
+                "brave-browser",
+                "microsoft-edge",
+                "microsoft-edge-stable",
             ],
             absolutePaths: [
-                '/usr/bin/google-chrome',
-                '/usr/bin/google-chrome-stable',
-                '/usr/bin/google-chrome-beta',
-                '/usr/bin/google-chrome-unstable',
-                '/usr/bin/chromium',
-                '/usr/bin/chromium-browser',
-                '/usr/bin/brave-browser',
-                '/usr/bin/microsoft-edge',
-                '/usr/bin/microsoft-edge-stable',
-                '/snap/bin/chromium',
-                '/snap/bin/brave',
-                '/snap/bin/brave-browser',
-                '/snap/bin/microsoft-edge',
-                '/opt/google/chrome/chrome',
+                "/usr/bin/google-chrome",
+                "/usr/bin/google-chrome-stable",
+                "/usr/bin/google-chrome-beta",
+                "/usr/bin/google-chrome-unstable",
+                "/usr/bin/chromium",
+                "/usr/bin/chromium-browser",
+                "/usr/bin/brave-browser",
+                "/usr/bin/microsoft-edge",
+                "/usr/bin/microsoft-edge-stable",
+                "/snap/bin/chromium",
+                "/snap/bin/brave",
+                "/snap/bin/brave-browser",
+                "/snap/bin/microsoft-edge",
+                "/opt/google/chrome/chrome",
             ],
         };
     }
-    if (process.platform === 'darwin') {
+    if (platform === "darwin") {
         return {
             binaryNames: [],
             absolutePaths: [
-                '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
-                '/Applications/Chromium.app/Contents/MacOS/Chromium',
-                '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
-                '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+                "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+                "/Applications/Chromium.app/Contents/MacOS/Chromium",
+                "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+                "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
             ],
         };
     }
-    if (process.platform === 'win32') {
-        const programFiles = process.env.ProgramFiles ?? 'C:\\Program Files';
-        const programFilesX86 = process.env['ProgramFiles(x86)'] ?? 'C:\\Program Files (x86)';
-        const localAppData = process.env.LOCALAPPDATA ?? path.join(os.homedir(), 'AppData', 'Local');
+    if (platform === "win32") {
+        const programFiles = process.env.ProgramFiles ?? "C:\\Program Files";
+        const programFilesX86 = process.env["ProgramFiles(x86)"] ?? "C:\\Program Files (x86)";
+        const localAppData = process.env.LOCALAPPDATA ?? path.join(homeDir, "AppData", "Local");
         return {
             binaryNames: [],
             absolutePaths: [
-                path.join(programFiles, 'Google', 'Chrome', 'Application', 'chrome.exe'),
-                path.join(programFilesX86, 'Google', 'Chrome', 'Application', 'chrome.exe'),
-                path.join(localAppData, 'Google', 'Chrome', 'Application', 'chrome.exe'),
-                path.join(programFiles, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
-                path.join(programFilesX86, 'Microsoft', 'Edge', 'Application', 'msedge.exe'),
+                path.join(programFiles, "Google", "Chrome", "Application", "chrome.exe"),
+                path.join(programFilesX86, "Google", "Chrome", "Application", "chrome.exe"),
+                path.join(localAppData, "Google", "Chrome", "Application", "chrome.exe"),
+                path.join(programFiles, "Microsoft", "Edge", "Application", "msedge.exe"),
+                path.join(programFilesX86, "Microsoft", "Edge", "Application", "msedge.exe"),
             ],
         };
     }
     return { binaryNames: [], absolutePaths: [] };
 }
-function platformProfileRoots() {
-    const home = os.homedir();
-    if (process.platform === 'darwin') {
-        return [
-            path.join(home, 'Library', 'Application Support', 'Google', 'Chrome'),
-            path.join(home, 'Library', 'Application Support', 'Chromium'),
-            path.join(home, 'Library', 'Application Support', 'Microsoft Edge'),
-            path.join(home, 'Library', 'Application Support', 'BraveSoftware', 'Brave-Browser'),
-        ];
-    }
-    if (process.platform === 'linux') {
-        return [
-            path.join(home, '.config', 'google-chrome'),
-            path.join(home, '.config', 'google-chrome-beta'),
-            path.join(home, '.config', 'google-chrome-unstable'),
-            path.join(home, '.config', 'chromium'),
-            path.join(home, '.config', 'microsoft-edge'),
-            path.join(home, '.config', 'BraveSoftware', 'Brave-Browser'),
-            // Snap Chromium profiles
-            path.join(home, 'snap', 'chromium', 'common', 'chromium'),
-            path.join(home, 'snap', 'chromium', 'current', 'chromium'),
-        ];
-    }
-    return [];
-}
 async function isExecutable(candidate) {
     try {
         const stat = await fs.stat(candidate);
         if (!stat.isFile())
             return false;
-        if (process.platform === 'win32')
+        if (process.platform === "win32")
             return true;
         // eslint-disable-next-line no-bitwise
         return (stat.mode & 0o111) !== 0;
@@ -150,7 +272,7 @@ async function isFile(candidate) {
     }
 }
 async function findOnPath(names) {
-    const rawPath = process.env.PATH ?? '';
+    const rawPath = process.env.PATH ?? "";
     const dirs = rawPath.split(path.delimiter).filter(Boolean);
     for (const name of names) {
         for (const dir of dirs) {
@@ -162,3 +284,54 @@ async function findOnPath(names) {
     }
     return null;
 }
+function deriveDevToolsProfileRoot(activePortPath) {
+    const parentDir = path.dirname(activePortPath);
+    if (path.basename(parentDir).toLowerCase() === "default") {
+        return path.dirname(parentDir);
+    }
+    return parentDir;
+}
+function formatWebSocketHost(host) {
+    if (host.includes(":") && !host.startsWith("[") && !host.endsWith("]")) {
+        return `[${host}]`;
+    }
+    return host;
+}
+async function walkForDevToolsActivePort(root, maxDepth, onFile) {
+    const stack = [{ dir: root, depth: 0 }];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (!current) {
+            continue;
+        }
+        let entries;
+        try {
+            entries = await fs.readdir(current.dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            const candidatePath = path.join(current.dir, entry.name);
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            if (entry.isFile()) {
+                if (entry.name !== "DevToolsActivePort") {
+                    continue;
+                }
+                try {
+                    const stat = await fs.stat(candidatePath);
+                    await onFile(candidatePath, stat);
+                }
+                catch {
+                    // ignore unreadable candidates
+                }
+                continue;
+            }
+            if (entry.isDirectory() && current.depth < maxDepth) {
+                stack.push({ dir: candidatePath, depth: current.depth + 1 });
+            }
+        }
+    }
+}