@steipete/oracle 0.9.0 → 0.11.0

package/dist/src/browser/sessionRunner.js

@@ -1,9 +1,10 @@
-import chalk from 'chalk';
-import { formatTokenCount } from '../oracle/runUtils.js';
-import { formatFinishLine } from '../oracle/finishLine.js';
-import { runBrowserMode } from '../browserMode.js';
-import { assembleBrowserPrompt } from './prompt.js';
-import { BrowserAutomationError } from '../oracle/errors.js';
+import chalk from "chalk";
+import { formatTokenCount } from "../oracle/runUtils.js";
+import { formatFinishLine } from "../oracle/finishLine.js";
+import { runBrowserMode } from "../browserMode.js";
+import { assembleBrowserPrompt } from "./prompt.js";
+import { BrowserAutomationError } from "../oracle/errors.js";
+import { appendArtifacts, saveBrowserTranscriptArtifact, saveDeepResearchReportArtifact, } from "./artifacts.js";
 export async function runBrowserSessionExecution({ runOptions, browserConfig, cwd, log }, deps = {}) {
     const assemblePrompt = deps.assemblePrompt ?? assembleBrowserPrompt;
     const executeBrowser = deps.executeBrowser ?? runBrowserMode;
@@ -14,14 +15,18 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
         })}`));
         log(chalk.dim(`[verbose] Browser prompt length: ${promptArtifacts.composerText.length} chars`));
         if (promptArtifacts.attachments.length > 0) {
-            const attachmentList = promptArtifacts.attachments.map((attachment) => attachment.displayPath).join(', ');
+            const attachmentList = promptArtifacts.attachments
+                .map((attachment) => attachment.displayPath)
+                .join(", ");
             log(chalk.dim(`[verbose] Browser attachments: ${attachmentList}`));
             if (promptArtifacts.bundled) {
                 log(chalk.yellow(`[browser] Bundled ${promptArtifacts.bundled.originalCount} files into ${promptArtifacts.bundled.bundlePath}.`));
             }
         }
-        else if (runOptions.file && runOptions.file.length > 0 && promptArtifacts.attachmentMode === 'inline') {
-            log(chalk.dim('[verbose] Browser will paste file contents inline (no uploads).'));
+        else if (runOptions.file &&
+            runOptions.file.length > 0 &&
+            promptArtifacts.attachmentMode === "inline") {
+            log(chalk.dim("[verbose] Browser will paste file contents inline (no uploads)."));
         }
     }
     if (promptArtifacts.bundled) {
@@ -29,19 +34,20 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
     }
     const headerLine = `Launching browser mode (${runOptions.model}) with ~${promptArtifacts.estimatedInputTokens.toLocaleString()} tokens.`;
     const automationLogger = ((message) => {
-        if (typeof message !== 'string')
+        if (typeof message !== "string")
             return;
-        const shouldAlwaysPrint = message.startsWith('[browser] ') && /fallback|retry/i.test(message);
+        const shouldAlwaysPrint = message.startsWith("[browser] ") &&
+            /archive|fallback|follow-up|retry|thinking|waiting for chatgpt|browser slot|browser control|browser guidance/i.test(message);
         if (!runOptions.verbose && !shouldAlwaysPrint)
             return;
         log(message);
     });
     automationLogger.verbose = Boolean(runOptions.verbose);
-    automationLogger.sessionLog = runOptions.verbose ? log : (() => { });
+    automationLogger.sessionLog = runOptions.verbose ? log : () => { };
     log(headerLine);
-    log(chalk.dim('This run can take up to an hour (usually ~10 minutes).'));
+    log(chalk.dim("This run can take up to an hour (usually ~10 minutes)."));
     if (runOptions.verbose) {
-        log(chalk.dim('Chrome automation does not stream output; this may take a minute...'));
+        log(chalk.dim("Chrome automation does not stream output; this may take a minute..."));
     }
     const persistRuntimeHint = deps.persistRuntimeHint ?? (() => { });
     let browserResult;
@@ -50,14 +56,24 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
             prompt: promptArtifacts.composerText,
             attachments: promptArtifacts.attachments,
             fallbackSubmission: promptArtifacts.fallback
-                ? { prompt: promptArtifacts.fallback.composerText, attachments: promptArtifacts.fallback.attachments }
+                ? {
+                    prompt: promptArtifacts.fallback.composerText,
+                    attachments: promptArtifacts.fallback.attachments,
+                }
                 : undefined,
             config: browserConfig,
             log: automationLogger,
             heartbeatIntervalMs: runOptions.heartbeatIntervalMs,
             verbose: runOptions.verbose,
+            sessionId: runOptions.sessionId,
+            generateImagePath: runOptions.generateImage,
+            outputPath: runOptions.outputPath,
+            followUpPrompts: runOptions.browserFollowUps,
             runtimeHintCb: async (runtime) => {
-                await persistRuntimeHint({ ...runtime, controllerPid: runtime.controllerPid ?? process.pid });
+                await persistRuntimeHint({
+                    ...runtime,
+                    controllerPid: runtime.controllerPid ?? process.pid,
+                });
             },
         });
     }
@@ -65,15 +81,24 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
         if (error instanceof BrowserAutomationError) {
             throw error;
         }
-        const message = error instanceof Error ? error.message : 'Browser automation failed.';
-        throw new BrowserAutomationError(message, { stage: 'execute-browser' }, error);
+        const message = error instanceof Error ? error.message : "Browser automation failed.";
+        throw new BrowserAutomationError(message, { stage: "execute-browser" }, error);
     }
     if (!runOptions.silent) {
-        log(chalk.bold('Answer:'));
-        log(browserResult.answerMarkdown || browserResult.answerText || chalk.dim('(no text output)'));
-        log('');
+        log(chalk.bold("Answer:"));
+        log(browserResult.answerMarkdown || browserResult.answerText || chalk.dim("(no text output)"));
+        log("");
     }
-    const answerText = browserResult.answerMarkdown || browserResult.answerText || '';
+    const answerText = browserResult.answerMarkdown || browserResult.answerText || "";
+    const savedArtifacts = await ensureSessionArtifacts({
+        sessionId: runOptions.sessionId,
+        prompt: promptArtifacts.composerText,
+        answerMarkdown: answerText,
+        conversationUrl: browserResult.tabUrl,
+        browserConfig,
+        existingArtifacts: browserResult.artifacts,
+        logger: automationLogger,
+    });
     const usage = {
         inputTokens: promptArtifacts.estimatedInputTokens,
         outputTokens: browserResult.answerTokens,
@@ -87,9 +112,9 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
         usage.totalTokens,
     ]
         .map((value) => formatTokenCount(value))
-        .join('/');
+        .join("/");
     const tokensPart = (() => {
-        const parts = tokensDisplay.split('/');
+        const parts = tokensDisplay.split("/");
         if (parts.length !== 4)
             return tokensDisplay;
         return `↑${parts[0]} ↓${parts[1]} ↻${parts[2]} Δ${parts[3]}`;
@@ -98,7 +123,9 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
         elapsedMs: browserResult.tookMs,
         model: `${runOptions.model}[browser]`,
         tokensPart,
-        detailParts: [runOptions.file && runOptions.file.length > 0 ? `files=${runOptions.file.length}` : null],
+        detailParts: [
+            runOptions.file && runOptions.file.length > 0 ? `files=${runOptions.file.length}` : null,
+        ],
     });
     log(chalk.blue(line1));
     if (line2) {
@@ -108,12 +135,49 @@ export async function runBrowserSessionExecution({ runOptions, browserConfig, cw
         usage,
         elapsedMs: browserResult.tookMs,
         runtime: {
+            browserTransport: browserResult.browserTransport,
             chromePid: browserResult.chromePid,
             chromePort: browserResult.chromePort,
             chromeHost: browserResult.chromeHost,
+            chromeBrowserWSEndpoint: browserResult.chromeBrowserWSEndpoint,
+            chromeProfileRoot: browserResult.chromeProfileRoot,
             userDataDir: browserResult.userDataDir,
+            chromeTargetId: browserResult.chromeTargetId,
+            tabUrl: browserResult.tabUrl,
+            conversationId: browserResult.conversationId,
             controllerPid: browserResult.controllerPid ?? process.pid,
         },
+        archive: browserResult.archive,
         answerText,
+        artifacts: savedArtifacts,
     };
 }
+export async function ensureSessionArtifacts(params) {
+    if (!params.sessionId || !params.answerMarkdown.trim()) {
+        return params.existingArtifacts;
+    }
+    let artifacts = params.existingArtifacts;
+    const hasReport = artifacts?.some((artifact) => artifact.kind === "deep-research-report");
+    if (params.browserConfig.researchMode === "deep" && !hasReport) {
+        const report = await saveDeepResearchReportArtifact({
+            sessionId: params.sessionId,
+            reportMarkdown: params.answerMarkdown,
+            conversationUrl: params.conversationUrl,
+            logger: params.logger,
+        }).catch(() => null);
+        artifacts = appendArtifacts(artifacts, [report]);
+    }
+    const hasTranscript = artifacts?.some((artifact) => artifact.kind === "transcript");
+    if (!hasTranscript) {
+        const transcript = await saveBrowserTranscriptArtifact({
+            sessionId: params.sessionId,
+            prompt: params.prompt,
+            answerMarkdown: params.answerMarkdown,
+            conversationUrl: params.conversationUrl,
+            artifacts,
+            logger: params.logger,
+        }).catch(() => null);
+        artifacts = appendArtifacts(artifacts, [transcript]);
+    }
+    return artifacts;
+}

package/dist/src/browser/tabLeaseRegistry.js

@@ -0,0 +1,182 @@
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { isProcessAlive } from "./profileState.js";
+import { delay } from "./utils.js";
+export const DEFAULT_MAX_CONCURRENT_CHATGPT_TABS = 3;
+const REGISTRY_FILENAME = "oracle-tab-leases.json";
+const REGISTRY_LOCK_DIRNAME = "oracle-tab-leases.lock";
+const DEFAULT_POLL_MS = 1000;
+const DEFAULT_STALE_MS = 6 * 60 * 60 * 1000;
+const REGISTRY_LOCK_TIMEOUT_MS = 10_000;
+export function normalizeMaxConcurrentTabs(value) {
+    if (value === undefined || value === null) {
+        return DEFAULT_MAX_CONCURRENT_CHATGPT_TABS;
+    }
+    const numeric = typeof value === "string" ? Number.parseInt(value, 10) : Number(value);
+    if (!Number.isFinite(numeric) || numeric <= 0) {
+        return DEFAULT_MAX_CONCURRENT_CHATGPT_TABS;
+    }
+    return Math.max(1, Math.trunc(numeric));
+}
+export async function acquireBrowserTabLease(profileDir, options, deps = {}) {
+    const maxConcurrentTabs = normalizeMaxConcurrentTabs(options.maxConcurrentTabs);
+    const pollMs = Math.max(50, options.pollMs ?? DEFAULT_POLL_MS);
+    const timeoutMs = Math.max(0, options.timeoutMs ?? 0);
+    const staleMs = Math.max(60_000, options.staleMs ?? DEFAULT_STALE_MS);
+    const now = deps.now ?? Date.now;
+    const pid = deps.pid ?? process.pid;
+    const leaseId = randomUUID();
+    const startedAt = now();
+    let warned = false;
+    let lastHeartbeatAt = 0;
+    for (;;) {
+        const acquired = await withRegistryLock(profileDir, async () => {
+            const registry = await readRegistry(profileDir);
+            const active = pruneStaleLeases(registry.leases, {
+                nowMs: now(),
+                staleMs,
+                isProcessAlive: deps.isProcessAlive ?? isProcessAlive,
+            });
+            if (active.length >= maxConcurrentTabs) {
+                if (active.length !== registry.leases.length) {
+                    await writeRegistry(profileDir, { version: 1, leases: active });
+                }
+                return null;
+            }
+            const timestamp = new Date(now()).toISOString();
+            const lease = {
+                id: leaseId,
+                pid,
+                sessionId: options.sessionId,
+                chromeHost: options.chromeHost,
+                chromePort: options.chromePort,
+                createdAt: timestamp,
+                updatedAt: timestamp,
+            };
+            await writeRegistry(profileDir, { version: 1, leases: [...active, lease] });
+            return lease;
+        });
+        if (acquired) {
+            options.logger?.(`[browser] Acquired ChatGPT browser slot ${leaseId.slice(0, 8)} (${maxConcurrentTabs} max).`);
+            return {
+                id: leaseId,
+                release: async () => releaseBrowserTabLease(profileDir, leaseId, options.logger),
+                update: async (patch) => updateBrowserTabLease(profileDir, leaseId, patch),
+            };
+        }
+        const elapsed = now() - startedAt;
+        if (!warned || now() - lastHeartbeatAt >= 30_000) {
+            options.logger?.(`[browser] Waiting for ChatGPT browser slot (${maxConcurrentTabs} max, ${Math.round(elapsed / 1000)}s elapsed).`);
+            warned = true;
+            lastHeartbeatAt = now();
+        }
+        if (timeoutMs > 0 && elapsed >= timeoutMs) {
+            throw new Error(`Timed out waiting for ChatGPT browser slot after ${Math.round(elapsed / 1000)}s (${maxConcurrentTabs} max).`);
+        }
+        await delay(timeoutMs > 0 ? Math.min(pollMs, timeoutMs - elapsed) : pollMs);
+    }
+}
+export async function updateBrowserTabLease(profileDir, leaseId, patch) {
+    await withRegistryLock(profileDir, async () => {
+        const registry = await readRegistry(profileDir);
+        const leases = registry.leases.map((lease) => lease.id === leaseId
+            ? { ...lease, ...patch, id: lease.id, updatedAt: new Date().toISOString() }
+            : lease);
+        await writeRegistry(profileDir, { version: 1, leases });
+    });
+}
+export async function releaseBrowserTabLease(profileDir, leaseId, logger) {
+    await withRegistryLock(profileDir, async () => {
+        const registry = await readRegistry(profileDir);
+        const leases = registry.leases.filter((lease) => lease.id !== leaseId);
+        await writeRegistry(profileDir, { version: 1, leases });
+    }).catch(() => undefined);
+    logger?.(`[browser] Released ChatGPT browser slot ${leaseId.slice(0, 8)}.`);
+}
+export async function hasOtherActiveBrowserTabLeases(profileDir, leaseId, options = {}) {
+    const now = options.now ?? Date.now;
+    const staleMs = Math.max(60_000, options.staleMs ?? DEFAULT_STALE_MS);
+    return withRegistryLock(profileDir, async () => {
+        const registry = await readRegistry(profileDir);
+        const active = pruneStaleLeases(registry.leases, {
+            nowMs: now(),
+            staleMs,
+            isProcessAlive: options.isProcessAlive ?? isProcessAlive,
+        });
+        if (active.length !== registry.leases.length) {
+            await writeRegistry(profileDir, { version: 1, leases: active });
+        }
+        return active.some((lease) => lease.id !== leaseId);
+    });
+}
+async function withRegistryLock(profileDir, callback) {
+    const lockDir = path.join(profileDir, REGISTRY_LOCK_DIRNAME);
+    const startedAt = Date.now();
+    for (;;) {
+        try {
+            await mkdir(lockDir, { recursive: false });
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST") {
+                throw error;
+            }
+            if (Date.now() - startedAt > REGISTRY_LOCK_TIMEOUT_MS) {
+                await rm(lockDir, { recursive: true, force: true }).catch(() => undefined);
+                continue;
+            }
+            await delay(50);
+        }
+    }
+    try {
+        return await callback();
+    }
+    finally {
+        await rm(lockDir, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+async function readRegistry(profileDir) {
+    try {
+        const raw = await readFile(registryPath(profileDir), "utf8");
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed.leases)) {
+            return { version: 1, leases: [] };
+        }
+        return {
+            version: 1,
+            leases: parsed.leases.filter(isLeaseRecord),
+        };
+    }
+    catch {
+        return { version: 1, leases: [] };
+    }
+}
+async function writeRegistry(profileDir, registry) {
+    await mkdir(profileDir, { recursive: true });
+    await writeFile(registryPath(profileDir), `${JSON.stringify(registry, null, 2)}\n`, "utf8");
+}
+function registryPath(profileDir) {
+    return path.join(profileDir, REGISTRY_FILENAME);
+}
+function pruneStaleLeases(leases, options) {
+    return leases.filter((lease) => {
+        if (!options.isProcessAlive(lease.pid)) {
+            return false;
+        }
+        const updatedAt = Date.parse(lease.updatedAt);
+        if (Number.isFinite(updatedAt) && options.nowMs - updatedAt > options.staleMs) {
+            return false;
+        }
+        return true;
+    });
+}
+function isLeaseRecord(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const record = value;
+    return (typeof record.id === "string" &&
+        typeof record.pid === "number" &&
+        typeof record.createdAt === "string" &&
+        typeof record.updatedAt === "string");
+}

package/dist/src/browser/utils.js

@@ -10,7 +10,7 @@ export function parseDuration(input, fallback) {
     if (/^[0-9]+$/.test(lowercase)) {
         return Number(lowercase);
     }
-    const normalized = lowercase.replace(/\s+/g, '');
+    const normalized = lowercase.replace(/\s+/g, "");
     const singleMatch = /^([0-9]+)(ms|s|m|h)$/i.exec(normalized);
     if (singleMatch && singleMatch[0].length === normalized.length) {
         const value = Number(singleMatch[1]);
@@ -33,13 +33,13 @@ export function parseDuration(input, fallback) {
 function convertUnit(value, unitRaw) {
     const unit = unitRaw?.toLowerCase();
     switch (unit) {
-        case 'ms':
+        case "ms":
             return value;
-        case 's':
+        case "s":
             return value * 1000;
-        case 'm':
+        case "m":
             return value * 60_000;
-        case 'h':
+        case "h":
             return value * 3_600_000;
         default:
             return value;
@@ -72,11 +72,11 @@ export async function withRetries(task, options = {}) {
             await delay(delayMs * attempt);
         }
     }
-    throw new Error('withRetries exhausted without result');
+    throw new Error("withRetries exhausted without result");
 }
 export function formatBytes(size) {
     if (!Number.isFinite(size) || size < 0) {
-        return 'n/a';
+        return "n/a";
     }
     if (size < 1024) {
         return `${size} B`;
@@ -113,8 +113,8 @@ export function normalizeChatgptUrl(raw, fallback) {
 export function isTemporaryChatUrl(url) {
     try {
         const parsed = new URL(url);
-        const value = (parsed.searchParams.get('temporary-chat') ?? '').trim().toLowerCase();
-        return value === 'true' || value === '1' || value === 'yes';
+        const value = (parsed.searchParams.get("temporary-chat") ?? "").trim().toLowerCase();
+        return value === "true" || value === "1" || value === "yes";
     }
     catch {
         return false;

package/dist/src/browserMode.js

@@ -1 +1 @@
-export { runBrowserMode, CHATGPT_URL, DEFAULT_MODEL_STRATEGY, DEFAULT_MODEL_TARGET, parseDuration, normalizeChatgptUrl, isTemporaryChatUrl, } from './browser/index.js';
+export { runBrowserMode, CHATGPT_URL, DEFAULT_MODEL_STRATEGY, DEFAULT_MODEL_TARGET, parseDuration, normalizeChatgptUrl, isTemporaryChatUrl, } from "./browser/index.js";

package/dist/src/cli/bridge/claudeConfig.js

@@ -1,8 +1,8 @@
-import chalk from 'chalk';
-import os from 'node:os';
-import path from 'node:path';
-import { loadUserConfig } from '../../config.js';
-import { resolveRemoteServiceConfig } from '../../remote/remoteServiceConfig.js';
+import chalk from "chalk";
+import os from "node:os";
+import path from "node:path";
+import { loadUserConfig } from "../../config.js";
+import { resolveRemoteServiceConfig } from "../../remote/remoteServiceConfig.js";
 export async function runBridgeClaudeConfig(options) {
     const { config: userConfig } = await loadUserConfig();
     const resolved = resolveRemoteServiceConfig({
@@ -12,40 +12,44 @@ export async function runBridgeClaudeConfig(options) {
         env: process.env,
     });
     const snippet = formatClaudeMcpConfig({
-        oracleHomeDir: process.env.ORACLE_HOME_DIR ?? path.join(os.homedir(), '.oracle-local'),
-        browserProfileDir: process.env.ORACLE_BROWSER_PROFILE_DIR ??
-            path.join(os.homedir(), '.oracle-local', 'browser-profile'),
+        oracleHomeDir: options.oracleHomeDir ??
+            process.env.ORACLE_HOME_DIR ??
+            path.join(os.homedir(), options.localBrowser ? ".oracle" : ".oracle-local"),
+        browserProfileDir: options.browserProfileDir ??
+            process.env.ORACLE_BROWSER_PROFILE_DIR ??
+            path.join(os.homedir(), options.localBrowser ? ".oracle" : ".oracle-local", "browser-profile"),
         remoteHost: resolved.host,
         remoteToken: resolved.token,
         includeToken: Boolean(options.printToken),
+        localBrowser: Boolean(options.localBrowser),
     });
     console.log(snippet);
-    if (!options.printToken) {
-        console.log('');
-        console.log(chalk.dim('Tip: rerun with --print-token to include ORACLE_REMOTE_TOKEN in the snippet.'));
+    if (!options.printToken && !options.localBrowser) {
+        console.error("");
+        console.error(chalk.dim("Tip: rerun with --print-token to include ORACLE_REMOTE_TOKEN in the snippet."));
     }
 }
-export function formatClaudeMcpConfig({ oracleHomeDir, browserProfileDir, remoteHost, remoteToken, includeToken, }) {
+export function formatClaudeMcpConfig({ oracleHomeDir, browserProfileDir, remoteHost, remoteToken, includeToken, localBrowser = false, }) {
     const env = {};
     // biome-ignore lint/complexity/useLiteralKeys: env vars are uppercase and include underscores.
-    env['ORACLE_ENGINE'] = 'browser';
+    env["ORACLE_ENGINE"] = "browser";
     // biome-ignore lint/complexity/useLiteralKeys: env vars are uppercase and include underscores.
-    env['ORACLE_HOME_DIR'] = oracleHomeDir;
+    env["ORACLE_HOME_DIR"] = oracleHomeDir;
     // biome-ignore lint/complexity/useLiteralKeys: env vars are uppercase and include underscores.
-    env['ORACLE_BROWSER_PROFILE_DIR'] = browserProfileDir;
-    if (remoteHost) {
+    env["ORACLE_BROWSER_PROFILE_DIR"] = browserProfileDir;
+    if (remoteHost && !localBrowser) {
         // biome-ignore lint/complexity/useLiteralKeys: env vars are uppercase and include underscores.
-        env['ORACLE_REMOTE_HOST'] = remoteHost;
+        env["ORACLE_REMOTE_HOST"] = remoteHost;
         // biome-ignore lint/complexity/useLiteralKeys: env vars are uppercase and include underscores.
-        env['ORACLE_REMOTE_TOKEN'] = includeToken ? remoteToken ?? '<YOUR_TOKEN>' : '<YOUR_TOKEN>';
+        env["ORACLE_REMOTE_TOKEN"] = includeToken ? (remoteToken ?? "<YOUR_TOKEN>") : "<YOUR_TOKEN>";
     }
     // Claude Code supports project-scoped `.mcp.json` config files:
     // https://docs.anthropic.com/en/docs/claude-code/mcp
     return JSON.stringify({
         mcpServers: {
             oracle: {
-                type: 'stdio',
-                command: 'oracle-mcp',
+                type: "stdio",
+                command: "oracle-mcp",
                 args: [],
                 env,
             },

package/dist/src/cli/bridge/client.js

@@ -1,29 +1,33 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import chalk from 'chalk';
-import { configPath as defaultConfigPath } from '../../config.js';
-import { parseBridgeConnectionString, readBridgeConnectionArtifact, looksLikePath, } from '../../bridge/connection.js';
-import { readUserConfigFile, writeUserConfigFile } from '../../bridge/userConfigFile.js';
-import { checkRemoteHealth } from '../../remote/health.js';
+import fs from "node:fs/promises";
+import path from "node:path";
+import chalk from "chalk";
+import { configPath as defaultConfigPath } from "../../config.js";
+import { parseBridgeConnectionString, readBridgeConnectionArtifact, looksLikePath, } from "../../bridge/connection.js";
+import { readUserConfigFile, writeUserConfigFile } from "../../bridge/userConfigFile.js";
+import { checkRemoteHealth } from "../../remote/health.js";
 export async function runBridgeClient(options) {
     const connectRaw = options.connect?.trim();
     if (!connectRaw) {
-        throw new Error('Missing --connect. Provide a connection string or a bridge-connection.json path.');
+        throw new Error("Missing --connect. Provide a connection string or a bridge-connection.json path.");
     }
     const { remoteHost, remoteToken, tunnel } = await resolveConnection(connectRaw);
     if (options.test !== false) {
-        const health = await checkRemoteHealth({ host: remoteHost, token: remoteToken, timeoutMs: 5000 });
+        const health = await checkRemoteHealth({
+            host: remoteHost,
+            token: remoteToken,
+            timeoutMs: 5000,
+        });
         if (!health.ok) {
-            const suffix = health.statusCode ? ` (HTTP ${health.statusCode})` : '';
-            throw new Error(`Remote service health check failed: ${health.error ?? 'unknown error'}${suffix}`);
+            const suffix = health.statusCode ? ` (HTTP ${health.statusCode})` : "";
+            throw new Error(`Remote service health check failed: ${health.error ?? "unknown error"}${suffix}`);
         }
-        console.log(chalk.green(`Remote service OK (${remoteHost})${health.version ? ` — oracle ${health.version}` : ''}`));
+        console.log(chalk.green(`Remote service OK (${remoteHost})${health.version ? ` — oracle ${health.version}` : ""}`));
     }
     const configFilePath = options.config?.trim() || defaultConfigPath();
     if (options.writeConfig !== false) {
         const { config } = await readUserConfigFile(configFilePath);
-        const next = { ...config, browser: { ...(config.browser ?? {}) } };
-        next.browser = { ...(next.browser ?? {}) };
+        const next = { ...config, browser: { ...config.browser } };
+        next.browser = { ...next.browser };
         next.browser.remoteHost = remoteHost;
         next.browser.remoteToken = remoteToken;
         if (tunnel) {
@@ -38,19 +42,19 @@ export async function runBridgeClient(options) {
         await writeUserConfigFile(configFilePath, next);
         console.log(chalk.green(`Wrote remote config to ${configFilePath}`));
     }
-    console.log('');
-    console.log('Next:');
+    console.log("");
+    console.log("Next:");
     console.log(chalk.dim(`- oracle --engine browser -p "hello" --file README.md`));
     if (options.printEnv) {
-        console.log('');
-        console.log('# Optional env overrides (paste into your shell):');
+        console.log("");
+        console.log("# Optional env overrides (paste into your shell):");
         console.log(`export ORACLE_ENGINE=browser`);
         console.log(`export ORACLE_REMOTE_HOST=${shellQuote(remoteHost)}`);
         console.log(`export ORACLE_REMOTE_TOKEN=${shellQuote(remoteToken)}`);
     }
 }
 async function resolveConnection(input) {
-    if (input.includes('://')) {
+    if (input.includes("://")) {
         return { ...parseBridgeConnectionString(input) };
     }
     const resolvedPath = looksLikePath(input) ? path.resolve(process.cwd(), input) : null;
@@ -58,7 +62,11 @@ async function resolveConnection(input) {
         const stat = await fs.stat(resolvedPath).catch(() => null);
         if (stat?.isFile()) {
             const artifact = await readBridgeConnectionArtifact(resolvedPath);
-            return { remoteHost: artifact.remoteHost, remoteToken: artifact.remoteToken, tunnel: artifact.tunnel };
+            return {
+                remoteHost: artifact.remoteHost,
+                remoteToken: artifact.remoteToken,
+                tunnel: artifact.tunnel,
+            };
         }
         if (stat) {
             throw new Error(`--connect points to ${resolvedPath}, but it is not a file.`);

package/dist/src/cli/bridge/codexConfig.js

@@ -1,6 +1,6 @@
-import chalk from 'chalk';
-import { loadUserConfig } from '../../config.js';
-import { resolveRemoteServiceConfig } from '../../remote/remoteServiceConfig.js';
+import chalk from "chalk";
+import { loadUserConfig } from "../../config.js";
+import { resolveRemoteServiceConfig } from "../../remote/remoteServiceConfig.js";
 export async function runBridgeCodexConfig(options) {
     const { config: userConfig } = await loadUserConfig();
     const resolved = resolveRemoteServiceConfig({
@@ -16,28 +16,28 @@ export async function runBridgeCodexConfig(options) {
     });
     console.log(snippet);
     if (!options.printToken) {
-        console.log('');
-        console.log(chalk.dim('Tip: rerun with --print-token to include ORACLE_REMOTE_TOKEN in the snippet.'));
+        console.error("");
+        console.error(chalk.dim("Tip: rerun with --print-token to include ORACLE_REMOTE_TOKEN in the snippet."));
     }
 }
 export function formatCodexMcpSnippet({ remoteHost, remoteToken, includeToken, }) {
-    const hostValue = remoteHost ?? '127.0.0.1:9473';
-    const tokenValue = includeToken ? remoteToken ?? '<YOUR_TOKEN>' : '<YOUR_TOKEN>';
+    const hostValue = remoteHost ?? "127.0.0.1:9473";
+    const tokenValue = includeToken ? (remoteToken ?? "<YOUR_TOKEN>") : "<YOUR_TOKEN>";
     return [
-        '# ~/.codex/config.toml',
-        '',
-        '[mcp.servers.oracle]',
+        "# ~/.codex/config.toml",
+        "",
+        "[mcp.servers.oracle]",
         'command = "oracle-mcp"',
-        'args = []',
+        "args = []",
         `env = { ORACLE_ENGINE = "browser", ORACLE_REMOTE_HOST = "${escapeTomlString(hostValue)}", ORACLE_REMOTE_TOKEN = "${escapeTomlString(tokenValue)}" }`,
-        '',
-        '# If you prefer npx:',
-        '# [mcp.servers.oracle]',
+        "",
+        "# If you prefer npx:",
+        "# [mcp.servers.oracle]",
         '# command = "npx"',
         '# args = ["-y", "@steipete/oracle", "oracle-mcp"]',
         `# env = { ORACLE_ENGINE = "browser", ORACLE_REMOTE_HOST = "${escapeTomlString(hostValue)}", ORACLE_REMOTE_TOKEN = "${escapeTomlString(tokenValue)}" }`,
-    ].join('\n');
+    ].join("\n");
 }
 function escapeTomlString(value) {
-    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
 }