@steipete/oracle 0.11.1 → 0.12.1

package/dist/src/browser/index.js

@@ -26,6 +26,7 @@ import { resolveAttachRunningConnection } from "./attachRunning.js";
 import { connectToExistingChatGptTab } from "./liveTabs.js";
 import { captureBrowserDiagnostics } from "./domDebug.js";
 import { archiveChatGptConversation, resolveBrowserArchiveDecision, } from "./actions/archiveConversation.js";
+import { assertManualLoginProfileReadyForRun, defaultManualLoginProfileDir, formatManualLoginSetupCommand, isManualLoginProfileInitialized, resolveManualLoginWaitMs, } from "./manualLoginProfile.js";
 import { describeBrowserControlPlan, formatBrowserControlPlan } from "./controlPlan.js";
 export { CHATGPT_URL, DEFAULT_MODEL_STRATEGY, DEFAULT_MODEL_TARGET } from "./constants.js";
 export { parseDuration, delay, normalizeChatgptUrl, isTemporaryChatUrl } from "./utils.js";
@@ -290,6 +291,17 @@ async function closeRemoteConnectionAfterRun(options) {
 function shouldCloseOwnedRunTargetAfterRun(options) {
     return options.runStatus === "complete" && options.ownsTarget && !options.keepBrowser;
 }
+function buildSkippedModelSelectionEvidence(desiredModel, strategy) {
+    return {
+        requestedModel: desiredModel ?? null,
+        resolvedLabel: null,
+        strategy,
+        status: "skipped",
+        verified: false,
+        source: "config",
+        capturedAt: new Date().toISOString(),
+    };
+}
 export async function runBrowserMode(options) {
     const promptText = options.prompt?.trim();
     if (!promptText) {
@@ -315,6 +327,7 @@ export async function runBrowserMode(options) {
     const runtimeHintCb = options.runtimeHintCb;
     let lastTargetId;
     let lastUrl;
+    let promptSubmitted = false;
     let tabLease = null;
     const emitRuntimeHint = async () => {
         if (!chrome?.port) {
@@ -328,6 +341,7 @@ export async function runBrowserMode(options) {
             chromeTargetId: lastTargetId,
             tabUrl: lastUrl,
             conversationId,
+            promptSubmitted,
             userDataDir,
             controllerPid: process.pid,
         };
@@ -345,6 +359,13 @@ export async function runBrowserMode(options) {
             logger(`Failed to persist runtime hint: ${message}`);
         }
     };
+    const markPromptSubmitted = async () => {
+        if (promptSubmitted) {
+            return;
+        }
+        promptSubmitted = true;
+        await emitRuntimeHint();
+    };
     if (config.debug || process.env.CHATGPT_DEVTOOLS_TRACE === "1") {
         logger(`[browser-mode] config: ${JSON.stringify({
             ...redactBrowserConfigForDebugLog(config),
@@ -383,14 +404,19 @@ export async function runBrowserMode(options) {
     const manualLogin = Boolean(config.manualLogin);
     const manualProfileDir = config.manualLoginProfileDir
         ? path.resolve(config.manualLoginProfileDir)
-        : path.join(os.homedir(), ".oracle", "browser-profile");
+        : defaultManualLoginProfileDir();
     const userDataDir = manualLogin
         ? manualProfileDir
         : await mkdtemp(path.join(await resolveUserDataBaseDir(), "oracle-browser-"));
+    const effectiveKeepBrowser = Boolean(config.keepBrowser);
     if (manualLogin) {
         // Learned: manual login reuses a persistent profile so cookies/SSO survive.
         await mkdir(userDataDir, { recursive: true });
         logger(`Manual login mode enabled; reusing persistent profile at ${userDataDir}`);
+        await assertManualLoginProfileReadyForRun({
+            userDataDir,
+            keepBrowser: effectiveKeepBrowser,
+        });
     }
     else {
         logger(`Created temporary Chrome profile at ${userDataDir}`);
@@ -403,7 +429,6 @@ export async function runBrowserMode(options) {
             sessionId: options.sessionId,
         });
     }
-    const effectiveKeepBrowser = Boolean(config.keepBrowser);
     let acquiredChrome;
     try {
         acquiredChrome = manualLogin
@@ -451,6 +476,7 @@ export async function runBrowserMode(options) {
     let answerMarkdown = "";
     let answerHtml = "";
     let runStatus = "attempted";
+    let modelSelectionEvidence;
     let connectionClosedUnexpectedly = false;
     let stopThinkingMonitor = null;
     let removeDialogHandler = null;
@@ -587,6 +613,8 @@ export async function runBrowserMode(options) {
                 appliedCookies,
                 manualLogin,
                 timeoutMs: config.timeoutMs,
+                profileDir: userDataDir,
+                keepBrowser: effectiveKeepBrowser,
             }));
             if (config.url !== baseUrl) {
                 await raceWithDisconnect(navigateToPromptReadyWithFallback(Page, Runtime, {
@@ -680,7 +708,7 @@ export async function runBrowserMode(options) {
         await captureRuntimeSnapshot();
         const modelStrategy = config.modelStrategy ?? DEFAULT_MODEL_STRATEGY;
         if (config.desiredModel && modelStrategy !== "ignore") {
-            await raceWithDisconnect(withRetries(() => ensureModelSelection(Runtime, config.desiredModel, logger, modelStrategy), {
+            modelSelectionEvidence = await raceWithDisconnect(withRetries(() => ensureModelSelection(Runtime, config.desiredModel, logger, modelStrategy), {
                 retries: 2,
                 delayMs: 300,
                 onRetry: (attempt, error) => {
@@ -699,13 +727,15 @@ export async function runBrowserMode(options) {
             logger(`Prompt textarea ready (after model switch, ${promptText.length.toLocaleString()} chars queued)`);
         }
         else if (modelStrategy === "ignore") {
+            modelSelectionEvidence = buildSkippedModelSelectionEvidence(config.desiredModel, modelStrategy);
             logger("Model picker: skipped (strategy=ignore)");
         }
         const deepResearch = config.researchMode === "deep";
         // Handle thinking time selection if specified. Deep Research owns its own effort flow.
         const thinkingTime = config.thinkingTime;
         if (thinkingTime && !deepResearch) {
-            await raceWithDisconnect(withRetries(() => ensureThinkingTime(Runtime, thinkingTime, logger), {
+            const thinkingTargetModel = modelStrategy === "select" ? config.desiredModel : null;
+            await raceWithDisconnect(withRetries(() => ensureThinkingTime(Runtime, thinkingTime, logger, thinkingTargetModel), {
                 retries: 2,
                 delayMs: 300,
                 onRetry: (attempt, error) => {
@@ -783,6 +813,7 @@ export async function runBrowserMode(options) {
                 inputTimeoutMs: config.inputTimeoutMs ?? undefined,
                 baselineTurns: baselineTurns ?? undefined,
                 attachmentNames,
+                onPromptSubmitted: markPromptSubmitted,
             };
             await runProviderSubmissionFlow(chatgptDomProvider, {
                 prompt,
@@ -791,6 +822,7 @@ export async function runBrowserMode(options) {
                 log: logger,
                 state: providerState,
             });
+            await markPromptSubmitted();
             const providerBaselineTurns = providerState.baselineTurns;
             if (typeof providerBaselineTurns === "number" && Number.isFinite(providerBaselineTurns)) {
                 baselineTurns = providerBaselineTurns;
@@ -881,6 +913,7 @@ export async function runBrowserMode(options) {
                 answerHtml: researchResult.html,
                 artifacts: savedArtifacts,
                 archive,
+                modelSelection: modelSelectionEvidence,
                 tookMs: durationMs,
                 answerTokens: tokens,
                 answerChars: researchResult.text.length,
@@ -891,6 +924,7 @@ export async function runBrowserMode(options) {
                 chromeTargetId: lastTargetId,
                 tabUrl: lastUrl,
                 conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                promptSubmitted,
                 controllerPid: process.pid,
             };
         }
@@ -975,6 +1009,7 @@ export async function runBrowserMode(options) {
                         chromeTargetId: lastTargetId,
                         tabUrl: lastUrl,
                         conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                        promptSubmitted,
                         controllerPid: process.pid,
                     },
                 });
@@ -1030,6 +1065,7 @@ export async function runBrowserMode(options) {
                             chromeTargetId: lastTargetId,
                             tabUrl: lastUrl,
                             conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                            promptSubmitted,
                             controllerPid: process.pid,
                         };
                         throw new BrowserAutomationError("Assistant response timed out before completion; reattach later to capture the answer.", { stage: "assistant-timeout", runtime, diagnostics }, error);
@@ -1266,6 +1302,7 @@ export async function runBrowserMode(options) {
             generatedImages: imageArtifacts.generatedImages,
             savedImages: imageArtifacts.savedImages,
             archive,
+            modelSelection: modelSelectionEvidence,
             tookMs: durationMs,
             answerTokens,
             answerChars,
@@ -1276,6 +1313,7 @@ export async function runBrowserMode(options) {
             chromeTargetId: lastTargetId,
             tabUrl: lastUrl,
             conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+            promptSubmitted,
             controllerPid: process.pid,
         };
     }
@@ -1293,6 +1331,7 @@ export async function runBrowserMode(options) {
                 userDataDir,
                 chromeTargetId: lastTargetId,
                 tabUrl: lastUrl,
+                promptSubmitted,
                 controllerPid: process.pid,
             };
             const reuseProfileHint = `oracle --engine browser --browser-manual-login ` +
@@ -1333,6 +1372,7 @@ export async function runBrowserMode(options) {
                 userDataDir,
                 chromeTargetId: lastTargetId,
                 tabUrl: lastUrl,
+                promptSubmitted,
                 controllerPid: process.pid,
             },
         }, normalizedError);
@@ -1491,12 +1531,13 @@ async function findEphemeralPort() {
         });
     });
 }
-async function waitForLogin({ runtime, logger, appliedCookies, manualLogin, timeoutMs, }) {
+async function waitForLogin({ runtime, logger, appliedCookies, manualLogin, timeoutMs, profileDir, keepBrowser, }) {
     if (!manualLogin) {
         await ensureLoggedIn(runtime, logger, { appliedCookies });
         return;
     }
-    const deadline = Date.now() + Math.min(timeoutMs ?? 1_200_000, 20 * 60_000);
+    const waitMs = resolveManualLoginWaitMs(timeoutMs, Boolean(keepBrowser));
+    const deadline = Date.now() + waitMs;
     let lastNotice = 0;
     while (Date.now() < deadline) {
         try {
@@ -1518,7 +1559,10 @@ async function waitForLogin({ runtime, logger, appliedCookies, manualLogin, time
             await delay(1000);
         }
     }
-    throw new Error("Manual login mode timed out waiting for ChatGPT session; please sign in and retry.");
+    const setupCommand = formatManualLoginSetupCommand(profileDir ?? defaultManualLoginProfileDir());
+    throw new Error("Manual login mode timed out waiting for ChatGPT session. " +
+        `Browser mode is using Oracle's private Chrome profile at ${profileDir ?? "(default profile)"}, not your normal Chrome profile. ` +
+        `Run first-time setup, sign in there, then retry: ${setupCommand}`);
 }
 async function maybeRecoverLongAssistantResponse({ runtime, baselineTurns, answerText, answerMarkdown, logger, allowMarkdownUpdate, }) {
     // Learned: long streaming responses can still be rendering after initial capture.
@@ -1677,6 +1721,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
     let remoteTargetId = null;
     let tabLease = null;
     let lastUrl;
+    let promptSubmitted = false;
     let attachedExistingTab = false;
     let ownsTarget = true;
     const runtimeHintCb = options.runtimeHintCb;
@@ -1692,6 +1737,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 chromeTargetId: remoteTargetId ?? undefined,
                 tabUrl: lastUrl,
                 conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                promptSubmitted,
                 controllerPid: process.pid,
             });
             await tabLease?.update({
@@ -1706,12 +1752,20 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
             logger(`Failed to persist runtime hint: ${message}`);
         }
     };
+    const markPromptSubmitted = async () => {
+        if (promptSubmitted) {
+            return;
+        }
+        promptSubmitted = true;
+        await emitRuntimeHint();
+    };
     const startedAt = Date.now();
     let answerText = "";
     let answerMarkdown = "";
     let answerHtml = "";
     let connectionClosedUnexpectedly = false;
     let runStatus = "attempted";
+    let modelSelectionEvidence;
     let stopThinkingMonitor = null;
     let removeDialogHandler = null;
     let connection = null;
@@ -1801,7 +1855,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
         }
         const modelStrategy = config.modelStrategy ?? DEFAULT_MODEL_STRATEGY;
         if (config.desiredModel && modelStrategy !== "ignore") {
-            await withRetries(() => ensureModelSelection(Runtime, config.desiredModel, logger, modelStrategy), {
+            modelSelectionEvidence = await withRetries(() => ensureModelSelection(Runtime, config.desiredModel, logger, modelStrategy), {
                 retries: 2,
                 delayMs: 300,
                 onRetry: (attempt, error) => {
@@ -1814,13 +1868,15 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
             logger(`Prompt textarea ready (after model switch, ${promptText.length.toLocaleString()} chars queued)`);
         }
         else if (modelStrategy === "ignore") {
+            modelSelectionEvidence = buildSkippedModelSelectionEvidence(config.desiredModel, modelStrategy);
             logger("Model picker: skipped (strategy=ignore)");
         }
         const deepResearch = config.researchMode === "deep";
         // Handle thinking time selection if specified. Deep Research owns its own effort flow.
         const thinkingTime = config.thinkingTime;
         if (thinkingTime && !deepResearch) {
-            await withRetries(() => ensureThinkingTime(Runtime, thinkingTime, logger), {
+            const thinkingTargetModel = modelStrategy === "select" ? config.desiredModel : null;
+            await withRetries(() => ensureThinkingTime(Runtime, thinkingTime, logger, thinkingTargetModel), {
                 retries: 2,
                 delayMs: 300,
                 onRetry: (attempt, error) => {
@@ -1876,6 +1932,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 inputTimeoutMs: config.inputTimeoutMs ?? undefined,
                 baselineTurns: baselineTurns ?? undefined,
                 attachmentNames,
+                onPromptSubmitted: markPromptSubmitted,
             };
             await runProviderSubmissionFlow(chatgptDomProvider, {
                 prompt,
@@ -1884,6 +1941,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 log: logger,
                 state: providerState,
             });
+            await markPromptSubmitted();
             const providerBaselineTurns = providerState.baselineTurns;
             if (typeof providerBaselineTurns === "number" && Number.isFinite(providerBaselineTurns)) {
                 baselineTurns = providerBaselineTurns;
@@ -1948,6 +2006,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 answerHtml: researchResult.html,
                 artifacts: savedArtifacts,
                 archive,
+                modelSelection: modelSelectionEvidence,
                 tookMs: durationMs,
                 answerTokens: tokens,
                 answerChars: researchResult.text.length,
@@ -1956,6 +2015,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 chromeTargetId: remoteTargetId ?? undefined,
                 tabUrl: lastUrl,
                 conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                promptSubmitted,
                 controllerPid: process.pid,
             };
         }
@@ -2039,6 +2099,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                         chromeTargetId: remoteTargetId ?? undefined,
                         tabUrl: lastUrl,
                         conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                        promptSubmitted,
                         controllerPid: process.pid,
                     },
                 });
@@ -2107,6 +2168,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                             chromeTargetId: remoteTargetId ?? undefined,
                             tabUrl: lastUrl,
                             conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+                            promptSubmitted,
                             controllerPid: process.pid,
                         };
                         throw new BrowserAutomationError("Assistant response timed out before completion; reattach later to capture the answer.", { stage: "assistant-timeout", runtime, diagnostics }, error);
@@ -2309,8 +2371,10 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
             chromeTargetId: remoteTargetId ?? undefined,
             tabUrl: lastUrl,
             conversationId: lastUrl ? extractConversationIdFromUrl(lastUrl) : undefined,
+            promptSubmitted,
             artifacts: savedArtifacts,
             archive,
+            modelSelection: modelSelectionEvidence,
             controllerPid: process.pid,
         };
     }
@@ -2334,6 +2398,7 @@ async function runRemoteBrowserMode(promptText, attachments, config, logger, opt
                 chromeProfileRoot,
                 chromeTargetId: remoteTargetId ?? undefined,
                 tabUrl: lastUrl,
+                promptSubmitted,
                 controllerPid: process.pid,
             },
         });
@@ -2372,10 +2437,14 @@ export { estimateTokenCount } from "./utils.js";
 export { resolveBrowserConfig, DEFAULT_BROWSER_CONFIG } from "./config.js";
 // biome-ignore lint/style/useNamingConvention: test-only export used in vitest suite
 export const __test__ = {
+    assertManualLoginProfileReadyForRun,
     closeRemoteConnectionAfterRun,
     detachKeptChromeProcess,
+    formatManualLoginSetupCommand,
+    isManualLoginProfileInitialized,
     isImageOnlyUiChromeText,
     listIgnoredRemoteChromeFlags,
+    resolveManualLoginWaitMs,
     shouldCloseOwnedRunTargetAfterRun,
 };
 export { syncCookies } from "./cookies.js";

package/dist/src/browser/manualLoginProfile.js

@@ -0,0 +1,54 @@
+import { readdir } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { BrowserAutomationError } from "../oracle/errors.js";
+export function resolveManualLoginWaitMs(timeoutMs, keepBrowser) {
+    const configured = Math.min(timeoutMs ?? 1_200_000, 20 * 60_000);
+    if (keepBrowser) {
+        return configured;
+    }
+    return Math.min(configured, 30_000);
+}
+export async function assertManualLoginProfileReadyForRun({ userDataDir, keepBrowser, }) {
+    if (keepBrowser) {
+        return;
+    }
+    if (await isManualLoginProfileInitialized(userDataDir)) {
+        return;
+    }
+    const setupCommand = formatManualLoginSetupCommand(userDataDir);
+    throw new BrowserAutomationError("ChatGPT browser manual-login profile is not initialized. " +
+        `Browser mode is using Oracle's private Chrome profile at ${userDataDir}, separate from your normal Chrome profile. ` +
+        `Run first-time setup, sign in there, then retry: ${setupCommand}. ` +
+        "If you want to reuse an already signed-in Chrome instead, use --browser-attach-running.", {
+        stage: "browser-login-setup",
+        details: {
+            profileDir: userDataDir,
+            setupCommand,
+            sessionStatus: "needs_login",
+        },
+        reuseProfileHint: setupCommand,
+    });
+}
+export async function isManualLoginProfileInitialized(profileDir) {
+    const entries = await readdir(profileDir, { withFileTypes: true }).catch(() => []);
+    return entries.some((entry) => {
+        if (!entry.name)
+            return false;
+        if (entry.name === "Default" || entry.name === "Local State")
+            return true;
+        if (entry.name.startsWith("Profile "))
+            return true;
+        return false;
+    });
+}
+export function formatManualLoginSetupCommand(profileDir) {
+    return [
+        "oracle --engine browser --browser-manual-login --browser-keep-browser",
+        `--browser-manual-login-profile-dir ${JSON.stringify(profileDir)}`,
+        '-p "HI"',
+    ].join(" ");
+}
+export function defaultManualLoginProfileDir() {
+    return path.join(os.homedir(), ".oracle", "browser-profile");
+}

package/dist/src/browser/projectSourcesRunner.js

@@ -9,6 +9,7 @@ import { acquireBrowserTabLease, hasOtherActiveBrowserTabLeases, } from "./tabLe
 import { acquireProfileRunLock, cleanupStaleProfileState, findRunningChromeDebugTargetForProfile, readChromePid, readDevToolsPort, shouldCleanupManualLoginProfileState, verifyDevToolsReachable, writeChromePid, writeDevToolsActivePort, } from "./profileState.js";
 import { CHATGPT_URL } from "./constants.js";
 import { delay } from "./utils.js";
+import { assertManualLoginProfileReadyForRun, defaultManualLoginProfileDir, formatManualLoginSetupCommand, resolveManualLoginWaitMs, } from "./manualLoginProfile.js";
 import { openProjectSourcesTab, uploadProjectSources, waitForProjectSourcesReady, waitForProjectSourcesListSettled, } from "./actions/projectSources.js";
 import { normalizeProjectSourcesUrl } from "../projectSources/url.js";
 import { buildProjectSourcesUploadPlan, diffAddedProjectSources } from "../projectSources/plan.js";
@@ -45,13 +46,18 @@ export async function runBrowserProjectSources(request) {
     const manualLogin = Boolean(config.manualLogin);
     const manualProfileDir = config.manualLoginProfileDir
         ? path.resolve(config.manualLoginProfileDir)
-        : path.join(os.homedir(), ".oracle", "browser-profile");
+        : defaultManualLoginProfileDir();
     const userDataDir = manualLogin
         ? manualProfileDir
         : await mkdtemp(path.join(os.tmpdir(), "oracle-project-sources-"));
+    const effectiveKeepBrowser = Boolean(config.keepBrowser);
     if (manualLogin) {
         await mkdir(userDataDir, { recursive: true });
         logger(`Manual login mode enabled; reusing persistent profile at ${userDataDir}`);
+        await assertManualLoginProfileReadyForRun({
+            userDataDir,
+            keepBrowser: effectiveKeepBrowser,
+        });
     }
     else {
         logger(`Created temporary Chrome profile at ${userDataDir}`);
@@ -73,7 +79,6 @@ export async function runBrowserProjectSources(request) {
     let removeDialogHandler = null;
     let connectionClosedUnexpectedly = false;
     let completed = false;
-    const effectiveKeepBrowser = Boolean(config.keepBrowser);
     try {
         const acquired = manualLogin
             ? await acquireManualLoginChromeForProjectSources(userDataDir, config, logger)
@@ -140,6 +145,8 @@ export async function runBrowserProjectSources(request) {
             appliedCookies,
             manualLogin,
             timeoutMs: config.timeoutMs,
+            profileDir: userDataDir,
+            keepBrowser: effectiveKeepBrowser,
         }));
         await raceWithDisconnect(navigateToChatGPT(Page, Runtime, projectUrl, logger));
         await raceWithDisconnect(openProjectSourcesTab(Runtime, Input, config.inputTimeoutMs, logger));
@@ -261,12 +268,13 @@ async function applyProjectSourcesCookies({ config, network, manualLogin, logger
         : "No Chrome cookies found; continuing without session reuse");
     return cookieCount;
 }
-async function waitForProjectSourcesLogin({ runtime, logger, appliedCookies, manualLogin, timeoutMs, }) {
+async function waitForProjectSourcesLogin({ runtime, logger, appliedCookies, manualLogin, timeoutMs, profileDir, keepBrowser, }) {
     if (!manualLogin) {
         await ensureLoggedIn(runtime, logger, { appliedCookies });
         return;
     }
-    const deadline = Date.now() + Math.min(timeoutMs ?? 1_200_000, 20 * 60_000);
+    const waitMs = resolveManualLoginWaitMs(timeoutMs, Boolean(keepBrowser));
+    const deadline = Date.now() + waitMs;
     let lastNotice = 0;
     while (Date.now() < deadline) {
         try {
@@ -288,7 +296,10 @@ async function waitForProjectSourcesLogin({ runtime, logger, appliedCookies, man
             await delay(1000);
         }
     }
-    throw new Error("Manual login mode timed out waiting for ChatGPT session; please sign in and retry.");
+    const setupCommand = formatManualLoginSetupCommand(profileDir ?? defaultManualLoginProfileDir());
+    throw new Error("Manual login mode timed out waiting for ChatGPT session. " +
+        `Browser mode is using Oracle's private Chrome profile at ${profileDir ?? "(default profile)"}, not your normal Chrome profile. ` +
+        `Run first-time setup, sign in there, then retry: ${setupCommand}`);
 }
 async function acquireManualLoginChromeForProjectSources(userDataDir, config, logger) {
     const lockTimeoutMs = Math.max(0, config.profileLockTimeoutMs ?? 0);

package/dist/src/browser/prompt.js

@@ -5,6 +5,7 @@ import { readFiles, createFileSections, MODEL_CONFIGS, TOKENIZER_OPTIONS, format
 import { isKnownModel } from "../oracle/modelResolver.js";
 import { buildPromptMarkdown } from "../oracle/promptAssembly.js";
 import { buildAttachmentPlan } from "./policies.js";
+import { createStoredZip } from "./zipBundle.js";
 const DEFAULT_BROWSER_INLINE_CHAR_BUDGET = 60_000;
 const MEDIA_EXTENSIONS = new Set([
     ".mp4",
@@ -34,6 +35,49 @@ export function isMediaFile(filePath) {
     const ext = path.extname(filePath).toLowerCase();
     return MEDIA_EXTENSIONS.has(ext);
 }
+function formatSectionsForBundle(sections) {
+    const bundleLines = [];
+    sections.forEach((section) => {
+        bundleLines.push(formatFileSection(section.displayPath, section.content).trimEnd());
+        bundleLines.push("");
+    });
+    return `${bundleLines
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trimEnd()}\n`;
+}
+async function writeBrowserBundle(sections, format) {
+    const bundleDir = await fs.mkdtemp(path.join(os.tmpdir(), "oracle-browser-bundle-"));
+    const tokenEstimateText = formatSectionsForBundle(sections);
+    if (format === "zip") {
+        const bundlePath = path.join(bundleDir, "attachments-bundle.zip");
+        const buffer = createStoredZip(sections.map((section) => ({
+            path: section.displayPath,
+            content: section.content,
+        })));
+        await fs.writeFile(bundlePath, buffer);
+        return {
+            attachment: {
+                path: bundlePath,
+                displayPath: bundlePath,
+                sizeBytes: buffer.length,
+            },
+            metadata: { originalCount: sections.length, bundlePath, format },
+            tokenEstimateText,
+        };
+    }
+    const bundlePath = path.join(bundleDir, "attachments-bundle.txt");
+    await fs.writeFile(bundlePath, tokenEstimateText, "utf8");
+    return {
+        attachment: {
+            path: bundlePath,
+            displayPath: bundlePath,
+            sizeBytes: Buffer.byteLength(tokenEstimateText, "utf8"),
+        },
+        metadata: { originalCount: sections.length, bundlePath, format },
+        tokenEstimateText,
+    };
+}
 export async function assembleBrowserPrompt(runOptions, deps = {}) {
     const cwd = deps.cwd ?? process.cwd();
     const readFilesFn = deps.readFilesImpl ?? readFiles;
@@ -49,7 +93,10 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
             sizeBytes: stats.size,
         };
     }));
-    const files = await readFilesFn(textFilePaths, { cwd });
+    const files = await readFilesFn(textFilePaths, {
+        cwd,
+        maxFileSizeBytes: runOptions.maxFileSizeBytes,
+    });
     const basePrompt = (runOptions.prompt ?? "").trim();
     const userPrompt = basePrompt;
     const systemPrompt = runOptions.system?.trim() || "";
@@ -59,6 +106,7 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
         ? "never"
         : (runOptions.browserAttachments ?? "auto");
     const bundleRequested = Boolean(runOptions.browserBundleFiles);
+    const bundleFormat = runOptions.browserBundleFormat ?? "text";
     const inlinePlan = buildAttachmentPlan(sections, { inlineFiles: true, bundleRequested });
     const uploadPlan = buildAttachmentPlan(sections, { inlineFiles: false, bundleRequested });
     const baseComposerSections = [];
@@ -88,26 +136,12 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
     let bundleText = null;
     let bundled = null;
     if (shouldBundle) {
-        const bundleDir = await fs.mkdtemp(path.join(os.tmpdir(), "oracle-browser-bundle-"));
-        const bundlePath = path.join(bundleDir, "attachments-bundle.txt");
-        const bundleLines = [];
-        sections.forEach((section) => {
-            bundleLines.push(formatFileSection(section.displayPath, section.content).trimEnd());
-            bundleLines.push("");
-        });
-        bundleText = `${bundleLines
-            .join("\n")
-            .replace(/\n{3,}/g, "\n\n")
-            .trimEnd()}\n`;
-        await fs.writeFile(bundlePath, bundleText, "utf8");
+        const writtenBundle = await writeBrowserBundle(sections, bundleFormat);
+        bundleText = writtenBundle.tokenEstimateText;
         attachments.length = 0;
-        attachments.push({
-            path: bundlePath,
-            displayPath: bundlePath,
-            sizeBytes: Buffer.byteLength(bundleText, "utf8"),
-        });
+        attachments.push(writtenBundle.attachment);
         attachments.push(...mediaAttachments);
-        bundled = { originalCount: sections.length, bundlePath };
+        bundled = writtenBundle.metadata;
     }
     const inlineFileCount = selectedPlan.inlineFileCount;
     const modelConfig = isKnownModel(runOptions.model)
@@ -140,26 +174,11 @@ export async function assembleBrowserPrompt(runOptions, deps = {}) {
         const fallbackAttachments = [...uploadPlan.attachments, ...mediaAttachments];
         let fallbackBundled = null;
         if (uploadPlan.shouldBundle) {
-            const bundleDir = await fs.mkdtemp(path.join(os.tmpdir(), "oracle-browser-bundle-"));
-            const bundlePath = path.join(bundleDir, "attachments-bundle.txt");
-            const bundleLines = [];
-            sections.forEach((section) => {
-                bundleLines.push(formatFileSection(section.displayPath, section.content).trimEnd());
-                bundleLines.push("");
-            });
-            const fallbackBundleText = `${bundleLines
-                .join("\n")
-                .replace(/\n{3,}/g, "\n\n")
-                .trimEnd()}\n`;
-            await fs.writeFile(bundlePath, fallbackBundleText, "utf8");
+            const writtenBundle = await writeBrowserBundle(sections, bundleFormat);
             fallbackAttachments.length = 0;
-            fallbackAttachments.push({
-                path: bundlePath,
-                displayPath: bundlePath,
-                sizeBytes: Buffer.byteLength(fallbackBundleText, "utf8"),
-            });
+            fallbackAttachments.push(writtenBundle.attachment);
             fallbackAttachments.push(...mediaAttachments);
-            fallbackBundled = { originalCount: sections.length, bundlePath };
+            fallbackBundled = writtenBundle.metadata;
         }
         fallback = {
             composerText: fallbackComposerText,

package/dist/src/browser/providers/chatgptDomProvider.js

@@ -23,6 +23,7 @@ async function submitPromptViaAdapter(ctx) {
         attachmentNames: state.attachmentNames ?? [],
         baselineTurns: state.baselineTurns ?? undefined,
         inputTimeoutMs: state.inputTimeoutMs ?? undefined,
+        onPromptSubmitted: state.onPromptSubmitted,
     }, ctx.prompt, state.logger);
     state.committedTurns =
         typeof committedTurns === "number" && Number.isFinite(committedTurns) ? committedTurns : null;

package/dist/src/browser/reattachability.js

@@ -0,0 +1,22 @@
+export function hasRecoverableChatGptConversation(runtime) {
+    if (!runtime) {
+        return false;
+    }
+    if (runtime.conversationId?.trim()) {
+        return true;
+    }
+    const tabUrl = runtime.tabUrl?.trim();
+    if (!tabUrl) {
+        return false;
+    }
+    try {
+        const url = new URL(tabUrl);
+        if (url.hostname !== "chatgpt.com" && url.hostname !== "chat.openai.com") {
+            return false;
+        }
+        return /(?:^|\/)c\/[^/]+/.test(url.pathname);
+    }
+    catch {
+        return false;
+    }
+}