@youdie006/prodex 0.16.32 → 0.16.33

package/dist/browser-send-lock.js

@@ -115,7 +115,7 @@ export async function withBrowserSendLock(waitMs, onWait, fn) {
             continue;
         }
         if (Date.now() >= deadline) {
-            throw new Error(`Another prodex browser send is in progress (pid ${holder.pid}). Wait for it to finish, or pass --busy-wait-ms to queue behind it.`);
+            throw new Error(`Another prodex browser send is in progress (pid ${holder.pid}) and did not finish within the wait budget. Retry once it finishes, or raise --timeout-ms (which is also the queue budget).`);
         }
         if (!waited) {
             waited = true;

package/dist/chatgpt-browser.js

@@ -1308,7 +1308,7 @@ export async function recoverChatGptAnswerFromThread(options) {
             code: "browser_unreachable",
             message: `No Chrome DevTools endpoint is reachable on 127.0.0.1:${port}.`,
             retryable: true,
-            next_step: "Run `prodex pro browser login`, log in, then retry."
+            next_step: "Run `prodex pro browser login` to reopen the dedicated window - it reuses the saved session (no manual login unless it expired) and returns immediately when run non-interactively - then retry."
         });
     }
     const cdp = await connectCdp(page.page.webSocketDebuggerUrl);
@@ -1790,7 +1790,7 @@ async function findChatGptPage(port, timeoutMs, targetUrl) {
                 code: "browser_unreachable",
                 message: `No Chrome DevTools endpoint is reachable on 127.0.0.1:${port}.`,
                 retryable: true,
-                next_step: "Run `prodex pro browser login`, log in, then retry.",
+                next_step: "Run `prodex pro browser login` to reopen the dedicated window - it reuses the saved session (no manual login unless it expired) and returns immediately when run non-interactively - then retry.",
                 ...(error instanceof Error ? { detail: error.message } : {})
             }
         };

package/dist/cli-help.js

@@ -26,7 +26,7 @@ Ask / consult commands:
   prodex pro browser models [--source-cli /absolute/path/to/dist/cli.js] [--port 9333] [--timeout-ms 15000]  # read-only list of model menu options
   prodex pro browser projects [--source-cli /absolute/path/to/dist/cli.js] [--port 9333] [--timeout-ms 15000]  # read-only list of sidebar project names (for --project)
   prodex pro browser recover [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] --target-url <thread-url> [--timeout-ms 60000]  # recover a finished answer from a thread whose send timed out
-  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"] [--project "name" | --project-new "name"] "prompt"  # explicit visible-browser send
+  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"] [--project "name" | --project-new "name"] "prompt"  # explicit visible-browser send
   prodex pro latest [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
   prodex pro list [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
   prodex pro show <task-id|latest> [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
@@ -252,8 +252,8 @@ export function printProBrowserHelp(stdout, sourceCli) {
         : "prodex pro browser smoke [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000]";
     const selectionUsage = '[--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"] [--project "name" | --project-new "name"]';
     const askUsage = sourceCli
-        ? `${cli} pro browser ask${sourceCliOption} [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] ${selectionUsage} "prompt"`
-        : `prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] ${selectionUsage} "prompt"`;
+        ? `${cli} pro browser ask${sourceCliOption} [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] ${selectionUsage} "prompt"`
+        : `prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] ${selectionUsage} "prompt"`;
     const modelsUsage = sourceCli
         ? `${cli} pro browser models${sourceCliOption} [--port 9333] [--timeout-ms 15000]`
         : "prodex pro browser models [--source-cli /absolute/path/to/dist/cli.js] [--port 9333] [--timeout-ms 15000]";

package/dist/cli-pro.js

@@ -277,8 +277,7 @@ export async function runProCommand(rest, io, runCliFn) {
             }
         }
         if (browserSubcommand === "open" || browserSubcommand === "status" || browserSubcommand === "doctor") {
-            const replacement = browserSubcommand === "open" ? "login" : "check";
-            throw new Error(`Use \`prodex pro browser ${replacement}\` for explicit browser automation.`);
+            throw new Error(`Use \`prodex pro browser ${legacyBrowserSubcommandReplacement(browserSubcommand)}\` for explicit browser automation.`);
         }
         if (browserSubcommand === "smoke") {
             if (printProBrowserHelpIfRequested(browserArgs, "pro browser smoke", io, { valueFlags: ["--cwd", "--port", "--timeout-ms", "--source-cli"] }))
@@ -426,7 +425,10 @@ export async function runProCommand(rest, io, runCliFn) {
         throw unknownSubcommandError("pro browser", browserSubcommand, ["login", "ask", "smoke", "check", "models", "projects", "recover"]);
     }
     if (subcommand === "open" || subcommand === "status" || subcommand === "smoke" || subcommand === "check" || subcommand === "doctor") {
-        throw new Error(`Use \`prodex pro browser ${subcommand === "doctor" ? "check" : subcommand}\` for explicit browser automation.`);
+        // Point at a subcommand that EXISTS: `pro status` used to say "use `pro
+        // browser status`", which itself errors with "use `pro browser check`" -
+        // a two-hop dead end that made an agent abandon the diagnosis.
+        throw new Error(`Use \`prodex pro browser ${legacyBrowserSubcommandReplacement(subcommand)}\` for explicit browser automation.`);
     }
     if (subcommand === "list") {
         if (printHelpIfRequested(proArgs, "pro list", io.stdout, printProHelp, { valueFlags: ["--cwd", "--source-cli"] }))
@@ -531,6 +533,16 @@ export async function runProCommand(rest, io, runCliFn) {
 export async function runConsultsCommand(rest, io) {
     throw new Error("The legacy `consults` alias is retired. Use `prodex pro list`, `prodex pro latest`, or `prodex pro show <task-id|latest>`.");
 }
+// Retired browser subcommands map to the one that replaced them. Every value
+// here must be a subcommand that actually exists, so the error is a single hop
+// to a runnable command.
+function legacyBrowserSubcommandReplacement(subcommand) {
+    if (subcommand === "open")
+        return "login";
+    if (subcommand === "smoke")
+        return "smoke";
+    return "check";
+}
 // File marker + human-pacing gate for visible-browser sends. Reads the previous
 // send's start time from .bridge/last-browser-send, waits out any remaining
 // minimum interval (auto-throttle, not an error), then stamps the new send.
@@ -702,7 +714,11 @@ export async function runAskProCommand(rest, io) {
     const effectiveProSelection = selectionProMode !== undefined || (selectionModel !== undefined && /pro/i.test(selectionModel));
     // Pro reasoning routinely runs 6-20 minutes; 15 min was still cutting long
     // answers off (field report), so a Pro selection defaults to 20 minutes.
-    const defaultBrowserTimeoutMs = effectiveProSelection ? 1_200_000 : 90_000;
+    // With NO model selection at all (no flag, no saved default) the UI's
+    // current model is unknown and may be Pro, so the floor is 5 minutes: the
+    // old 90s guess made repos without saved defaults time out on ordinary
+    // consults (observed in several field sessions).
+    const defaultBrowserTimeoutMs = effectiveProSelection ? 1_200_000 : 300_000;
     const browserTimeoutMs = hasSendMode
         ? (readPositiveIntegerFlag(parsedAskPro.optionArgs, "--timeout-ms") ?? defaultBrowserTimeoutMs)
         : undefined;
@@ -759,7 +775,12 @@ export async function runAskProCommand(rest, io) {
             }
             throw new Error(formatBlockedConsultRecordedMessage(blocker.message, task.id, sourceCli, { cwd: targetCwd }));
         }
-        const sendOnce = () => withBrowserSendLock(busyWaitMs ?? 0, (detail) => io.stderr(`progress: ${detail}`), () => sendChatGptPrompt({
+        // Queue behind another prodex send by default (same budget as the send
+        // itself). MCP consults cannot pass --busy-wait-ms at all, so the old
+        // fail-fast default made pro_consult die instantly with advice the
+        // caller had no way to follow; --busy-wait-ms 0 opts back into failing
+        // fast. A dead holder is still reaped immediately.
+        const sendOnce = () => withBrowserSendLock(busyWaitMs ?? browserTimeoutMs ?? 0, (detail) => io.stderr(`progress: ${detail}`), () => sendChatGptPrompt({
             port: browserPort,
             prompt: bundle.text,
             targetUrl: normalizedTargetUrl,
@@ -1366,7 +1387,10 @@ export async function printProductCheck(store, io, args, configCwd = io.cwd) {
     }
     catch (error) {
         if (isMissingFileError(error)) {
-            io.stdout(`config: missing - run \`${formatSetupCommand(sourceCli, { cwd: setupHintCwd })}\``);
+            // Name it optional: browser consults need no config at all, but agents
+            // reading "config: missing" in an otherwise healthy check concluded
+            // prodex was unconfigured and went chasing `setup` (field sessions).
+            io.stdout(`config: missing - run \`${formatSetupCommand(sourceCli, { cwd: setupHintCwd })}\` (optional - only the HTTP MCP surface needs it; browser consults work without it)`);
         }
         else {
             io.stdout(`config: failed ${sourceAwareSetupMessage(errorMessage(error), sourceCli, { cwd: setupHintCwd })}`);
@@ -1412,6 +1436,15 @@ export async function printProductCheck(store, io, args, configCwd = io.cwd) {
             if (nextStep)
                 io.stdout(`next: ${nextStep}`);
         }
+        else if (browserStatus.blocker?.code === "response_in_progress") {
+            // Busy is not broken: the session is healthy and answering, and sends
+            // queue behind it automatically. Reporting it as "blocked" made agents
+            // conclude the browser was down and start relaunching/logging in (field
+            // failure, observed across several repos).
+            io.stdout(`chatgpt: busy ${browserStatus.blocker.code} - ${browserStatus.blocker.message}`);
+            io.stdout("next: No action needed - a send queues behind it automatically (--busy-wait-ms 0 fails fast instead).");
+            chatgptReady = true;
+        }
         else if (browserStatus.blocker) {
             const visibilityText = browserStatus.blocker.code === "tab_not_visible" ? ` visibility=${browserStatus.visibilityState ?? "unknown"}` : "";
             io.stdout(`chatgpt: blocked ${browserStatus.blocker.code}${visibilityText} - ${browserStatus.blocker.message}`);

package/dist/cli.js

@@ -929,7 +929,10 @@ async function runDoctor(store, io, sourceCli, setupHintCwd) {
     }
     catch (error) {
         if (isMissingFileError(error)) {
-            io.stdout(`config: missing - run \`${formatSetupCommand(sourceCli, { cwd: setupHintCwd })}\``);
+            // Name it optional: browser consults need no config at all, but agents
+            // reading "config: missing" in an otherwise healthy check concluded
+            // prodex was unconfigured and went chasing `setup` (field sessions).
+            io.stdout(`config: missing - run \`${formatSetupCommand(sourceCli, { cwd: setupHintCwd })}\` (optional - only the HTTP MCP surface needs it; browser consults work without it)`);
         }
         else {
             ok = false;

package/dist/mcp.js

@@ -142,7 +142,10 @@ export function createServer(cwd = process.cwd(), options = {}) {
             inputSchema: {
                 prompt: McpBridgeTextSchema.min(1),
                 model: McpShortTextSchema.optional(),
-                pro_mode: McpShortTextSchema.optional(),
+                // pro_mode is deliberately NOT advertised: ChatGPT's 2026-07 update
+                // removed Pro sub-modes, and agents that saw the field passed
+                // nonsense ("true") and got a hard validation error instead of an
+                // answer. Unknown keys are stripped, so a stale caller still works.
                 effort: McpShortTextSchema.optional(),
                 project: McpShortTextSchema.optional(),
                 timeout_ms: z.number().int().positive().max(3_600_000).optional(),

package/package.json

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