@youdie006/prodex 0.25.1 → 0.26.1

package/dist/chatgpt-browser.js

@@ -363,6 +363,48 @@ export async function ensureVirtualDisplay(options = {}) {
     }
     throw new Error(`No free X display between :${first} and :${first + 9}. Set PRODEX_VIRTUAL_DISPLAY_NUM to a free number.`);
 }
+/**
+ * How should the dedicated browser be opened?
+ *
+ * An explicit flag or environment variable wins; otherwise reopen it the way it
+ * was last opened. Without the saved fallback, `pro browser login` - the exact
+ * command every `browser_unreachable` blocker tells people to run - put a
+ * VISIBLE window back on the desktop of someone who had set up a virtual
+ * display, which is the surprise window they went to that trouble to avoid.
+ *
+ * Choosing a mode explicitly replaces the saved one wholesale rather than
+ * merging with it: asking for headless must not also rejoin an old virtual
+ * display.
+ */
+export function resolveBrowserWindowMode(args) {
+    const env = args.env ?? process.env;
+    const flags = args.flags ?? {};
+    const fromEnv = (name) => {
+        const raw = (env[name] ?? "").trim().toLowerCase();
+        if (raw === "")
+            return undefined;
+        return raw === "1" || raw === "true" || raw === "yes";
+    };
+    const explicit = {
+        headless: flags.headless ?? fromEnv("PRODEX_HEADLESS"),
+        virtualDisplay: flags.virtualDisplay ?? fromEnv("PRODEX_VIRTUAL_DISPLAY"),
+        minimized: flags.minimized ?? fromEnv("PRODEX_MINIMIZE_WINDOW")
+    };
+    const chosen = Object.values(explicit).some((value) => value === true);
+    if (chosen) {
+        return {
+            headless: explicit.headless === true,
+            virtualDisplay: explicit.virtualDisplay === true,
+            minimized: explicit.minimized === true
+        };
+    }
+    const saved = args.lastLogin;
+    return {
+        headless: saved?.headless === true,
+        virtualDisplay: saved?.virtual_display !== undefined,
+        minimized: saved?.minimized === true
+    };
+}
 export function resolveHeadlessPreference(explicit, env = process.env) {
     if (typeof explicit === "boolean")
         return explicit;
@@ -416,6 +458,11 @@ export function isUsableChatGptAnswer(answer) {
         if (toolPanelOnly)
             return false;
     }
+    // ChatGPT's own interruption notice, which is what a thread shows after the
+    // browser dies mid-stream. Measured: recover saved "Pro thinking / Connection
+    // interrupted. Waiting for the complete answer" as a recovered answer.
+    if (/connection interrupted|연결이\s*중단/i.test(normalized) && normalized.length < 200)
+        return false;
     return true;
 }
 /**
@@ -943,6 +990,31 @@ export function openChatGptBrowser(options = {}) {
         }
     };
 }
+/**
+ * Open a ChatGPT tab in the already-running dedicated Chrome.
+ *
+ * Reported from a live machine: Chrome was up but had no chatgpt.com tab, so
+ * login reused it ("no new window opened"), told the user to finish logging in
+ * "in the opened window", and then blocked forever on a tab that nobody was
+ * going to create. Opening it is the whole fix.
+ */
+export async function openChatGptTab(port = DEFAULT_CDP_PORT, url = "https://chatgpt.com/") {
+    const endpoint = `http://127.0.0.1:${port}/json/new?${encodeURIComponent(url)}`;
+    // Chrome moved /json/new from GET to PUT; try the current verb first and fall
+    // back so this keeps working on either.
+    for (const method of ["PUT", "GET"]) {
+        try {
+            const response = await fetch(endpoint, { method, signal: AbortSignal.timeout(5_000) });
+            if (response.ok)
+                return true;
+        }
+        catch {
+            // Try the next verb, then give up quietly: the caller keeps polling and
+            // the user can still open the tab by hand.
+        }
+    }
+    return false;
+}
 export async function getChatGptBrowserStatus(options = {}) {
     const port = resolveCdpPort(options.port);
     const page = await findChatGptPage(port, options.timeoutMs ?? 1500);
@@ -1745,6 +1817,26 @@ export async function recoverChatGptAnswerFromThread(options) {
                         warnings: []
                     };
                 }
+                // Not a research thread: read the ordinary answer from the transcript
+                // too. Recover used to be page-only, so it inherited everything the
+                // page loses - flattened markdown, dropped citation urls - and it once
+                // saved ChatGPT's "Connection interrupted" notice as the answer.
+                const transcript = await evaluateOnPage(page.page, transcriptAnswerExpression(conversationId), {
+                    timeoutMs: 60_000
+                });
+                if (transcript.ok && transcript.text.trim().length > 0) {
+                    const recovered = resolveTranscriptCitations(transcript.text, transcript.references).trim();
+                    if (recovered.length > 0) {
+                        return {
+                            url,
+                            title: "",
+                            answer: recovered,
+                            modelHints: [],
+                            ...(transcript.modelSlug ? { modelSlug: transcript.modelSlug } : {}),
+                            warnings: []
+                        };
+                    }
+                }
             }
             catch {
                 // Not a research thread, or the transcript API is unavailable: fall
@@ -2128,12 +2220,21 @@ export async function sendChatGptPrompt(options) {
         if (!conversationId)
             throw new ChatGptBrowserBlockerError(deepResearchUnreadableBlocker(pinnedThreadUrl ?? "https://chatgpt.com/"));
         let lastState;
+        let consecutiveResearchReadFailures = 0;
         while (Date.now() - started < timeoutMs) {
             try {
                 lastState = await evaluateOnPage(page, deepResearchReportExpression(conversationId), { timeoutMs: 60_000 });
+                consecutiveResearchReadFailures = 0;
             }
             catch {
-                // Transient CDP/network failure: keep polling until the budget runs out.
+                // A few failures in a row mean the browser is gone, not busy. Waiting
+                // out a 30-minute budget on a dead browser helps nobody: the research
+                // finishes on ChatGPT's side anyway, so hand back the thread and let
+                // recover collect the report.
+                consecutiveResearchReadFailures += 1;
+                if (consecutiveResearchReadFailures >= CONSECUTIVE_READ_FAILURES_BEFORE_GIVING_UP) {
+                    throw new ChatGptBrowserBlockerError(browserLostMidWaitBlocker(pinnedThreadUrl));
+                }
                 await sleep(5_000);
                 continue;
             }
@@ -2164,11 +2265,13 @@ export async function sendChatGptPrompt(options) {
     }
     let recoveredNavigations = 0;
     let lastTranscriptClassification;
+    let consecutiveReadFailures = 0;
     const answerIsStable = createChatGptAnswerStabilityTracker();
     while (Date.now() - started < timeoutMs) {
         await sleep(1000);
         try {
             finalState = await evaluateOnPage(page, answerExpression());
+            consecutiveReadFailures = 0;
             // First conversation id wins. Re-deriving it every poll would let a tab
             // that wandered to another thread redirect the read to a stranger's
             // conversation - and the prompt check below is the second line of defence,
@@ -2206,7 +2309,13 @@ export async function sendChatGptPrompt(options) {
                 throw error;
             // Transient CDP failure while the answer is streaming: retry. A throw here
             // would discard an already-streamed partial answer and skip the salvage
-            // path below, so keep the last good state and poll again until timeout.
+            // path below, so keep the last good state and poll again. But a run of
+            // failures is a browser that went away rather than a busy one, and
+            // sitting out the whole budget on it only delays the recovery.
+            consecutiveReadFailures += 1;
+            if (consecutiveReadFailures >= CONSECUTIVE_READ_FAILURES_BEFORE_GIVING_UP) {
+                throw new ChatGptBrowserBlockerError(browserLostMidWaitBlocker(finalState?.url ?? pinnedThreadUrl));
+            }
             continue;
         }
         const runtimeBlocker = chatGptBlockerFromAnswerState(finalState);
@@ -3073,6 +3182,32 @@ export function chunkComposerText(text, size = COMPOSER_INSERT_CHUNK_CHARS) {
  * so hand the run back rather than waiting on a page that never renders it -
  * deep research draws into a widget iframe, leaving the thread DOM empty.
  */
+/**
+ * The dedicated browser died while a send was waiting for its answer.
+ *
+ * Observed live: Chrome went away mid deep-research run, every poll threw, the
+ * loop swallowed each failure, and the send sat silent for the rest of a
+ * 30-minute budget - while the research finished on ChatGPT's side. Nothing is
+ * lost except the ability to read it, so fail fast and hand back the thread.
+ */
+// Reading the page can fail for a moment (a navigation, a busy renderer). Five
+// failures in a row is not a moment - it is a browser that went away.
+const CONSECUTIVE_READ_FAILURES_BEFORE_GIVING_UP = 5;
+export function browserLostMidWaitBlocker(threadUrl) {
+    // Killing the browser aborts a streaming answer too, so promise nothing
+    // about the answer itself - only say where to look. Deep research is the one
+    // case that genuinely keeps going without us.
+    const where = threadUrl ? ` The consult landed in ${threadUrl}` : "";
+    return {
+        code: "browser_unreachable",
+        message: `The dedicated ChatGPT browser stopped responding while this consult was waiting for its answer.${where}`,
+        retryable: true,
+        next_step: threadUrl
+            ? `Run \`prodex pro browser login\` to reopen the browser, then collect the answer with \`prodex pro browser recover --target-url ${threadUrl}\` (MCP: pro_recover with thread ${threadUrl}).`
+            : "Run `prodex pro browser login` to reopen the browser, then retry.",
+        ...(threadUrl ? { thread: threadUrl } : {})
+    };
+}
 export function deepResearchUnreadableBlocker(threadUrl) {
     return {
         code: "deep_research_not_readable",

package/dist/cli-pro.js

@@ -2,7 +2,7 @@ import { existsSync, statSync } from "node:fs";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { buildDryRunBundle } from "./bundle.js";
-import { DEFAULT_CDP_PORT, resolveCdpPort, chatGptVisibilityBlocker, defaultChatGptProfileDir, formatDurationMs, getChatGptBrowserStatus, listChatGptModelOptions, listChatGptSidebarProjects, normalizeChatGptTargetUrl, openChatGptBrowser, parseProMode, parseReasoningEffort, defaultTimeoutForTools, ensureVirtualDisplay, minimizeChatGptWindow, readLastBrowserLoginLaunch, resolveVirtualDisplayPreference, resolveHeadlessPreference, recordBrowserLoginLaunch, recoverChatGptAnswerFromThread, sendChatGptPrompt } from "./chatgpt-browser.js";
+import { DEFAULT_CDP_PORT, resolveCdpPort, chatGptVisibilityBlocker, defaultChatGptProfileDir, formatDurationMs, getChatGptBrowserStatus, listChatGptModelOptions, listChatGptSidebarProjects, normalizeChatGptTargetUrl, openChatGptBrowser, openChatGptTab, parseProMode, parseReasoningEffort, defaultTimeoutForTools, ensureVirtualDisplay, minimizeChatGptWindow, readLastBrowserLoginLaunch, resolveVirtualDisplayPreference, resolveBrowserWindowMode, resolveHeadlessPreference, recordBrowserLoginLaunch, recoverChatGptAnswerFromThread, sendChatGptPrompt } from "./chatgpt-browser.js";
 import { ASK_PRO_BOOLEAN_FLAGS, ASK_PRO_PREVIEW_VALUE_FLAGS, ASK_PRO_VALUE_FLAGS, assertHelpRequestArgs, assertNoExtraArgs, assertOnlyOptions, findHelpFlagIndexBeforePromptDelimiter, formatCliCommand, hasAskProDryRunMode, hasAskProMode, hasAskProSendMode, isHelpSubcommand, parseAskProArgs, printHelpIfRequested, readFlag, readPortFlag, readPositionalsWithOptions, readNonNegativeIntegerFlag, readPositiveIntegerFlag, readRepeatedFlag, resolveCwdFlag, resolveOptionalFileFlag, unknownSubcommandError } from "./cli-args.js";
 import { printProBrowserHelp, printProHelp } from "./cli-help.js";
 import { listRawResultsForInspection, listTasksForInspection } from "./cli-ledger.js";
@@ -222,14 +222,30 @@ export async function runProCommand(rest, io, runCliFn) {
             // again: Chrome's singleton would just open ANOTHER window (the recurring
             // "extra windows" problem, which then blocks sends as
             // ambiguous_chatgpt_tabs). Reuse the running instance instead.
-            const headless = resolveHeadlessPreference(browserArgs.includes("--headless") ? true : undefined);
-            // A real browser on a virtual X display: no window anywhere, and
-            // Cloudflare sees an ordinary headed Chrome (headless it rejects).
-            const wantsVirtualDisplay = resolveVirtualDisplayPreference(browserArgs.includes("--virtual-display") ? true : undefined);
-            if (wantsVirtualDisplay && headless) {
+            if (browserArgs.includes("--virtual-display") && browserArgs.includes("--headless")) {
                 throw new Error("pro browser login cannot combine --headless and --virtual-display (a virtual display already hides the window).");
             }
-            const virtualDisplay = wantsVirtualDisplay ? await ensureVirtualDisplay() : undefined;
+            // Reopen the browser the way it was last opened unless a flag or the
+            // environment says otherwise. A virtual-display user who follows the
+            // `browser_unreachable` advice used to get a visible window back.
+            const savedLaunch = await readLastBrowserLoginLaunch();
+            const windowMode = resolveBrowserWindowMode({
+                flags: {
+                    ...(browserArgs.includes("--headless") ? { headless: true } : {}),
+                    ...(browserArgs.includes("--virtual-display") ? { virtualDisplay: true } : {}),
+                    ...(browserArgs.includes("--minimized") ? { minimized: true } : {})
+                },
+                ...(savedLaunch ? { lastLogin: savedLaunch } : {})
+            });
+            const headless = windowMode.headless;
+            // A real browser on a virtual X display: no window anywhere, and
+            // Cloudflare sees an ordinary headed Chrome (headless it rejects).
+            const wantsVirtualDisplay = windowMode.virtualDisplay;
+            const virtualDisplay = wantsVirtualDisplay
+                ? await ensureVirtualDisplay(savedLaunch?.virtual_display !== undefined && !browserArgs.includes("--virtual-display")
+                    ? { displayNumber: savedLaunch.virtual_display }
+                    : {})
+                : undefined;
             const alreadyRunning = (await getChatGptBrowserStatus({ port })).reachable;
             if (alreadyRunning) {
                 // One Chrome profile cannot serve a headed and a headless instance at
@@ -1286,13 +1302,24 @@ export async function waitForChatGptLoginReady(stderr, options, deps = {}) {
     const statusFn = deps.statusFn ?? getChatGptBrowserStatus;
     const sleepFn = deps.sleepFn ?? sleep;
     const now = deps.now ?? Date.now;
+    const openTabFn = deps.openTabFn ?? openChatGptTab;
     const timeoutMs = options.timeoutMs ?? 300_000;
     const pollMs = options.pollMs ?? 2_000;
     const startedAt = now();
-    stderr("login: waiting for a logged-in ChatGPT tab (finish login in the opened window; Ctrl+C stops waiting)...");
+    stderr("login: waiting for a logged-in ChatGPT tab (finish login in the dedicated Chrome window; Ctrl+C stops waiting)...");
     let lastState = "";
+    let openedMissingTab = false;
     while (now() - startedAt < timeoutMs) {
         const status = await statusFn({ port: options.port, timeoutMs: 1_500 });
+        // A running Chrome with no chatgpt.com tab leaves the user nothing to log
+        // into. Open the tab once rather than waiting for one to appear.
+        if (status.reachable && status.blocker?.code === "chatgpt_page_missing" && !openedMissingTab) {
+            openedMissingTab = true;
+            stderr("login: the running Chrome had no ChatGPT tab - opening a ChatGPT tab in it...");
+            await openTabFn(options.port);
+            await sleepFn(pollMs);
+            continue;
+        }
         const state = !status.reachable
             ? "login: browser starting..."
             : status.blocker

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@youdie006/prodex",
-  "version": "0.25.1",
+  "version": "0.26.1",
   "description": "Local receipt bus for coordinating Codex execution with ChatGPT Pro/Projects consultation.",
   "author": "youdie006",
   "license": "MIT",