@youdie006/prodex 0.8.3 → 0.9.0

package/dist/cli-help.js

@@ -6,22 +6,18 @@ export const CLI_VERSION = packageJson.version ?? "0.0.0";
 export function printHelp(stdout) {
     stdout(`prodex v${CLI_VERSION}
 
-Commands:
-  prodex --version
-  prodex init [--cwd /absolute/path/to/repo]
-  prodex doctor [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
-  prodex setup [--cwd /absolute/path/to/repo] [--host 127.0.0.1] [--port 8787] [--token-ttl-hours <hours>] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"] [--project "name"] [--clear-model|--clear-pro-mode|--clear-effort|--clear-project] [--interactive]
-  prodex start [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
-  prodex status [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js] [--show-token] [--url-only] [--unsafe-show-non-expiring-token]
-  prodex tunnel url [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js] --public-url https://... [--show-token] [--url-only]
-  prodex release status [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
-  prodex release pack [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js] --pack-destination /absolute/path [--keep-workdir]
-  prodex onboard [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
-  prodex project prompt [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
-  prodex claude prompt [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
-  prodex claude config [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+Ask ChatGPT from the terminal (visible logged-in browser):
+  prodex ask "Explain this stack trace"          # shortcut for: prodex pro browser ask
+  prodex ask --file src/auth.ts "Review this for security holes"
+
+First-time setup:
+  prodex pro browser login    # dedicated Chrome; interactive runs wait until your login is READY
+  prodex doctor               # bridge + MCP + browser health
+
+Ask / consult commands:
+  prodex ask [same flags as pro browser ask] "prompt"  # top-level shortcut for pro browser ask
   prodex pro ask [--dry-run] [--cwd /absolute/path/to/repo] [--file path] "prompt"  # dry-run preview
-  prodex pro browser login [--cwd /absolute/path/to/repo] [--dry-run] [--source-cli /absolute/path/to/dist/cli.js] [--profile-dir path] [--port 9333] [--url https://chatgpt.com/...] [--launch-timeout-ms 5000]  # preview/open visible browser login
+  prodex pro browser login [--cwd /absolute/path/to/repo] [--dry-run] [--source-cli /absolute/path/to/dist/cli.js] [--profile-dir path] [--port 9333] [--url https://chatgpt.com/...] [--launch-timeout-ms 5000] [--wait|--no-wait] [--wait-timeout-ms 300000]  # preview/open visible browser login
   prodex pro browser help [--source-cli /absolute/path/to/dist/cli.js]
   prodex pro browser check [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 1500]
   prodex pro browser smoke [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000]
@@ -30,6 +26,9 @@ Commands:
   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]
   prodex pro show <task-id|latest> [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
+
+Bridge ledger (durable tasks/results/receipts/sessions under .bridge/):
+  prodex init [--cwd /absolute/path/to/repo]
   prodex tasks create [--cwd /absolute/path/to/repo] --title "Title" --prompt "Prompt"
   prodex tasks list [--status new|claimed|done|blocked] [--cwd /absolute/path/to/repo]
   prodex tasks show <task-id|latest> [--cwd /absolute/path/to/repo]
@@ -44,7 +43,23 @@ Commands:
   prodex receipts rotate-key [--cwd /absolute/path/to/repo]
   prodex sessions list [--status preview|running|done|blocked] [--cwd /absolute/path/to/repo]
   prodex sessions show <session-id|latest> [--cwd /absolute/path/to/repo]
-  prodex mcp [--cwd /absolute/path/to/repo]`);
+
+Agent / MCP integration:
+  prodex mcp [--cwd /absolute/path/to/repo]
+  prodex setup [--cwd /absolute/path/to/repo] [--host 127.0.0.1] [--port 8787] [--token-ttl-hours <hours>] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"] [--project "name"] [--clear-model|--clear-pro-mode|--clear-effort|--clear-project] [--interactive]
+  prodex start [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+  prodex status [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js] [--show-token] [--url-only] [--unsafe-show-non-expiring-token]
+  prodex tunnel url [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js] --public-url https://... [--show-token] [--url-only]
+  prodex claude prompt [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+  prodex claude config [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+  prodex project prompt [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+  prodex onboard [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+
+Maintenance:
+  prodex --version
+  prodex doctor [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+  prodex release status [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js]
+  prodex release pack [--cwd /absolute/path/to/repo] [--source-cli /absolute/path/to/dist/cli.js] --pack-destination /absolute/path [--keep-workdir]`);
 }
 export function printInitHelp(stdout) {
     stdout(`prodex init
@@ -141,7 +156,7 @@ export function printProHelp(stdout) {
 Commands:
   prodex pro ask [--dry-run] [--cwd /absolute/path/to/repo] [--file path] "prompt"
   prodex pro browser help [--source-cli /absolute/path/to/dist/cli.js]
-  prodex pro browser login [--cwd /absolute/path/to/repo] [--dry-run] [--source-cli /absolute/path/to/dist/cli.js] [--launch-timeout-ms 5000]
+  prodex pro browser login [--cwd /absolute/path/to/repo] [--dry-run] [--source-cli /absolute/path/to/dist/cli.js] [--launch-timeout-ms 5000] [--wait|--no-wait] [--wait-timeout-ms 300000]
   prodex pro browser check [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
   prodex pro browser smoke [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo]
   prodex pro browser models [--source-cli /absolute/path/to/dist/cli.js]
@@ -220,8 +235,8 @@ export function printProBrowserHelp(stdout, sourceCli) {
     const cli = formatCliCommand(sourceCli);
     const sourceCliOption = formatSourceCliOption(sourceCli);
     const loginUsage = sourceCli
-        ? `${cli} pro browser login${sourceCliOption} [--cwd /absolute/path/to/repo] [--dry-run] [--profile-dir path] [--port 9333] [--url https://chatgpt.com/...] [--launch-timeout-ms 5000]`
-        : "prodex pro browser login [--cwd /absolute/path/to/repo] [--dry-run] [--source-cli /absolute/path/to/dist/cli.js] [--profile-dir path] [--port 9333] [--url https://chatgpt.com/...] [--launch-timeout-ms 5000]";
+        ? `${cli} pro browser login${sourceCliOption} [--cwd /absolute/path/to/repo] [--dry-run] [--profile-dir path] [--port 9333] [--url https://chatgpt.com/...] [--launch-timeout-ms 5000] [--wait|--no-wait] [--wait-timeout-ms 300000]`
+        : "prodex pro browser login [--cwd /absolute/path/to/repo] [--dry-run] [--source-cli /absolute/path/to/dist/cli.js] [--profile-dir path] [--port 9333] [--url https://chatgpt.com/...] [--launch-timeout-ms 5000] [--wait|--no-wait] [--wait-timeout-ms 300000]";
     const checkUsage = sourceCli
         ? `${cli} pro browser check${sourceCliOption} [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 1500]`
         : "prodex pro browser check [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 1500]";

package/dist/cli-help.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1D,MAAM,WAAW,GAAG,kBAAkB,CAAC,iBAAiB,CAAyB,CAAC;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;AAE1D,MAAM,UAAU,SAAS,CAAC,MAA8B;IACtD,MAAM,CAAC,WAAW,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4CAwCa,CAAC,CAAC;AAC9C,CAAC;AACD,MAAM,UAAU,aAAa,CAAC,MAA8B;IAC1D,MAAM,CAAC;;;;;2EAKkE,CAAC,CAAC;AAC7E,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,MAA8B;IAC3D,MAAM,CAAC;;;;;;;;;;;;;qHAa4G,CAAC,CAAC;AACvH,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,MAA8B;IAC3D,MAAM,CAAC;;;;;uEAK8D,CAAC,CAAC;AACzE,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,CAAC;;;;;8DAKqD,CAAC,CAAC;AAChE,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,CAAC;;;;;oGAK2F,CAAC,CAAC;AACtG,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,MAA8B;IAC/D,MAAM,CAAC;;;;;sHAK6G,CAAC,CAAC;AACxH,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,CAAC;;;;;6FAKoF,CAAC,CAAC;AAC/F,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC7D,MAAM,CAAC;;;;;uGAK8F,CAAC,CAAC;AACzG,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,MAAM,CAAC;;;;;qGAK4F,CAAC,CAAC;AACvG,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC7D,MAAM,CAAC;;;;;;gGAMuF,CAAC,CAAC;AAClG,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,MAA8B;IACzD,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;mGAuB0F,CAAC,CAAC;AACrG,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC7D,MAAM,CAAC;;;;;0GAKiG,CAAC,CAAC;AAC5G,CAAC;AACD,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,MAAM,CAAC;;;;;;wGAM+F,CAAC,CAAC;AAC1G,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,MAA8B;IAC3D,MAAM,CAAC;;;;;;;;wIAQ+H,CAAC,CAAC;AAC1I,CAAC;AACD,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC7D,MAAM,CAAC;;;;;iGAKwF,CAAC,CAAC;AACnG,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC9D,MAAM,CAAC;;;;;;;;;uBASc,CAAC,CAAC;AACzB,CAAC;AACD,MAAM,UAAU,iBAAiB,CAAC,MAA8B;IAC9D,MAAM,CAAC;;;;0EAIiE,CAAC,CAAC;AAC5E,CAAC;AACD,MAAM,UAAU,mBAAmB,CAAC,MAA8B,EAAE,SAAkB;IACpF,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,GAAG,GAAG,qBAAqB,eAAe,2IAA2I;QACvL,CAAC,CAAC,gNAAgN,CAAC;IACrN,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,GAAG,GAAG,qBAAqB,eAAe,mEAAmE;QAC/G,CAAC,CAAC,wIAAwI,CAAC;IAC7I,MAAM,UAAU,GAAG,SAAS;QAC1B,CAAC,CAAC,GAAG,GAAG,qBAAqB,eAAe,oEAAoE;QAChH,CAAC,CAAC,yIAAyI,CAAC;IAC9I,MAAM,cAAc,GAAG,wGAAwG,CAAC;IAChI,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,GAAG,GAAG,mBAAmB,eAAe,wHAAwH,cAAc,WAAW;QAC3L,CAAC,CAAC,2LAA2L,cAAc,WAAW,CAAC;IACzN,MAAM,WAAW,GAAG,SAAS;QAC3B,CAAC,CAAC,GAAG,GAAG,sBAAsB,eAAe,qCAAqC;QAClF,CAAC,CAAC,2GAA2G,CAAC;IAChH,MAAM,CAAC,GAAG,GAAG;;;IAGX,UAAU;IACV,UAAU;IACV,UAAU;IACV,WAAW;IACX,QAAQ;;;;;;;;;QASJ,GAAG,sBAAsB,eAAe;0BACtB,GAAG,SAAS,eAAe;QAC7C,GAAG;IACP,GAAG,mBAAmB,eAAe,sDAAsD,CAAC,CAAC;AACjG,CAAC"}
+{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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"}

package/dist/cli-pro.d.ts

@@ -1,4 +1,4 @@
-import { type ChatGptBrowserLaunch, sendChatGptPrompt } from "./chatgpt-browser.js";
+import { type ChatGptBrowserLaunch, type SendChatGptProgressEvent, getChatGptBrowserStatus, sendChatGptPrompt } from "./chatgpt-browser.js";
 import { type HelpRequestOptions } from "./cli-args.js";
 import { type BrowserCommandOptions } from "./cli-shared.js";
 import { BridgeStore } from "./store.js";
@@ -7,8 +7,53 @@ export type RunCliFn = (args: string[], io: CliIO) => Promise<number>;
 export declare function runChatgptCommand(rest: string[], io: CliIO): Promise<number>;
 export declare function runProCommand(rest: string[], io: CliIO, runCliFn: RunCliFn): Promise<number>;
 export declare function runConsultsCommand(rest: string[], io: CliIO): Promise<number>;
+/**
+ * Turns send progress events into stderr lines so multi-minute Pro consults do
+ * not look frozen. Phase transitions print immediately; the per-poll waiting
+ * heartbeat is throttled to one line per heartbeatMs.
+ */
+export declare function createBrowserSendProgressPrinter(write: (line: string) => void, heartbeatMs?: number): (event: SendChatGptProgressEvent) => void;
 export declare function runAskProCommand(rest: string[], io: CliIO): Promise<number>;
 export declare const PRO_BROWSER_SMOKE_TOKEN = "PRODEX_PRO_SMOKE_OK";
+export interface BrowserConsultInput {
+    prompt: string;
+    model?: string;
+    pro_mode?: string;
+    effort?: string;
+    project?: string;
+    timeout_ms?: number;
+    files?: string[];
+}
+export interface BrowserConsultOutcome {
+    task_id: string;
+    status: string;
+    thread: string;
+    answer: string;
+    notes: string[];
+}
+/**
+ * MCP-facing wrapper around the visible-browser ask flow. Reuses the full CLI
+ * path (send pacing, task/session/receipt persistence, artifact save) by
+ * invoking runAskProCommand with captured io, then returns structured fields
+ * instead of printed lines. Registered only on the local stdio MCP server -
+ * never on the HTTP MCP surface, which is exposed to ChatGPT itself.
+ */
+export declare function performBrowserConsultForMcp(cwd: string, input: BrowserConsultInput): Promise<BrowserConsultOutcome>;
+export interface LoginWaitDeps {
+    statusFn?: typeof getChatGptBrowserStatus;
+    sleepFn?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+/**
+ * Guided login: poll the visible browser until a logged-in ChatGPT tab with a
+ * usable composer appears, narrating each state change so the user knows what
+ * manual step (login, challenge, opening a chat) is still missing.
+ */
+export declare function waitForChatGptLoginReady(stderr: (line: string) => void, options: {
+    port: number;
+    timeoutMs?: number;
+    pollMs?: number;
+}, deps?: LoginWaitDeps): Promise<boolean>;
 export declare function assertBrowserLaunchStayedAlive(opened: ChatGptBrowserLaunch, timeoutMs?: number): Promise<void>;
 export declare function browserSendBlockerFromError(error: unknown): {
     code: string;

package/dist/cli-pro.js

@@ -1,12 +1,12 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { buildDryRunBundle } from "./bundle.js";
-import { chatGptVisibilityBlocker, defaultChatGptProfileDir, getChatGptBrowserStatus, listChatGptModelOptions, normalizeChatGptTargetUrl, openChatGptBrowser, parseProMode, parseReasoningEffort, sendChatGptPrompt } from "./chatgpt-browser.js";
+import { DEFAULT_CDP_PORT, resolveCdpPort, chatGptVisibilityBlocker, defaultChatGptProfileDir, getChatGptBrowserStatus, listChatGptModelOptions, normalizeChatGptTargetUrl, openChatGptBrowser, parseProMode, parseReasoningEffort, sendChatGptPrompt } from "./chatgpt-browser.js";
 import { ASK_PRO_BOOLEAN_FLAGS, ASK_PRO_PREVIEW_VALUE_FLAGS, ASK_PRO_VALUE_FLAGS, assertHelpRequestArgs, assertNoExtraArgs, assertOnlyOptions, findHelpFlagIndexBeforePromptDelimiter, hasAskProDryRunMode, hasAskProMode, hasAskProSendMode, isHelpSubcommand, parseAskProArgs, printHelpIfRequested, readFlag, readPortFlag, readPositionalsWithOptions, readPositiveNumberFlag, readRepeatedFlag, resolveCwdFlag, resolveOptionalFileFlag, unknownSubcommandError } from "./cli-args.js";
 import { printProBrowserHelp, printProHelp } from "./cli-help.js";
 import { listRawResultsForInspection, listTasksForInspection } from "./cli-ledger.js";
 import { redactServerUrl } from "./cli-server.js";
-import { errorMessage, firstLine, formatBlockedConsultRecordedMessage, formatBrowserCheckCommand, formatBrowserLoginCommand, formatBrowserSmokeCommand, formatBrowserTargetAskCommand, formatInitCommand, formatSetupCommand, isMissingFileError, computeSendPacingWaitMs, isUntrustedResultError, resolveMinSendIntervalMs, sourceAwareBrowserBlocker, sourceAwareBrowserNextStep, sourceAwareResultError, sourceAwareResultMessage, sourceAwareSetupMessage } from "./cli-shared.js";
+import { errorMessage, firstLine, formatBlockedConsultRecordedMessage, formatProLatestCommand, formatBrowserCheckCommand, formatBrowserLoginCommand, formatBrowserSmokeCommand, formatBrowserTargetAskCommand, formatInitCommand, formatSetupCommand, isMissingFileError, computeSendPacingWaitMs, isUntrustedResultError, resolveMinSendIntervalMs, sourceAwareBrowserBlocker, sourceAwareBrowserNextStep, sourceAwareResultError, sourceAwareResultMessage, sourceAwareSetupMessage } from "./cli-shared.js";
 import { getTokenExpiryStatus, loadBrowserDefaults, loadLocalConfig } from "./config.js";
 import { BridgeStore, MAX_FETCHABLE_RESULT_ARTIFACT_BYTES } from "./store.js";
 export async function runChatgptCommand(rest, io) {
@@ -17,7 +17,7 @@ export async function runChatgptCommand(rest, io) {
     if (subcommand === "open") {
         assertOnlyOptions(chatgptArgs, "chatgpt open", ["--port", "--profile-dir", "--url"]);
         const opened = openChatGptBrowser({
-            port: readPortFlag(chatgptArgs, "--port") ?? 9333,
+            port: resolveCdpPort(readPortFlag(chatgptArgs, "--port")),
             profileDir: readFlag(chatgptArgs, "--profile-dir"),
             url: readChatGptBrowserUrlFlag(chatgptArgs)
         });
@@ -29,7 +29,7 @@ export async function runChatgptCommand(rest, io) {
     }
     if (subcommand === "status") {
         assertOnlyOptions(chatgptArgs, "chatgpt status", ["--port"]);
-        const status = await getChatGptBrowserStatus({ port: readPortFlag(chatgptArgs, "--port") ?? 9333 });
+        const status = await getChatGptBrowserStatus({ port: resolveCdpPort(readPortFlag(chatgptArgs, "--port")) });
         io.stdout(JSON.stringify(status, null, 2));
         return 0;
     }
@@ -38,7 +38,7 @@ export async function runChatgptCommand(rest, io) {
         const targetCwd = resolveCwdFlag(io.cwd, chatgptArgs);
         const targetStore = new BridgeStore(targetCwd);
         const sourceCli = resolveOptionalFileFlag(io.cwd, chatgptArgs, "--source-cli");
-        const port = readPortFlag(chatgptArgs, "--port") ?? 9333;
+        const port = resolveCdpPort(readPortFlag(chatgptArgs, "--port"));
         const timeoutMs = readPositiveNumberFlag(chatgptArgs, "--timeout-ms") ?? 90000;
         const commandOptions = {
             ...(readFlag(chatgptArgs, "--cwd") ? { cwd: targetCwd } : {}),
@@ -83,7 +83,8 @@ export async function runChatgptCommand(rest, io) {
             result = await sendChatGptPrompt({
                 port,
                 prompt: smokePrompt,
-                timeoutMs
+                timeoutMs,
+                onProgress: createBrowserSendProgressPrinter(io.stderr)
             });
         }
         catch (error) {
@@ -151,22 +152,25 @@ export async function runProCommand(rest, io, runCliFn) {
         }
         if (browserSubcommand === "login") {
             if (printProBrowserHelpIfRequested(browserArgs, "pro browser login", io, {
-                valueFlags: ["--cwd", "--profile-dir", "--port", "--url", "--source-cli", "--launch-timeout-ms"],
-                booleanFlags: ["--dry-run"]
+                valueFlags: ["--cwd", "--profile-dir", "--port", "--url", "--source-cli", "--launch-timeout-ms", "--wait-timeout-ms"],
+                booleanFlags: ["--dry-run", "--wait", "--no-wait"]
             })) {
                 return 0;
             }
-            assertOnlyOptions(browserArgs, "pro browser login", ["--cwd", "--profile-dir", "--port", "--url", "--source-cli", "--launch-timeout-ms"], ["--dry-run"]);
+            assertOnlyOptions(browserArgs, "pro browser login", ["--cwd", "--profile-dir", "--port", "--url", "--source-cli", "--launch-timeout-ms", "--wait-timeout-ms"], ["--dry-run", "--wait", "--no-wait"]);
+            if (browserArgs.includes("--wait") && browserArgs.includes("--no-wait")) {
+                throw new Error("pro browser login cannot combine --wait and --no-wait");
+            }
             const loginUrl = readChatGptBrowserUrlFlag(browserArgs);
             const sourceCli = resolveOptionalFileFlag(io.cwd, browserArgs, "--source-cli");
             const targetCwd = readFlag(browserArgs, "--cwd") ? resolveCwdFlag(io.cwd, browserArgs) : undefined;
             const profileDir = readFlag(browserArgs, "--profile-dir");
-            const port = readPortFlag(browserArgs, "--port") ?? 9333;
+            const port = resolveCdpPort(readPortFlag(browserArgs, "--port"));
             const launchTimeoutMs = readPositiveNumberFlag(browserArgs, "--launch-timeout-ms");
             const commandOptions = {
                 ...(targetCwd ? { cwd: targetCwd } : {}),
                 ...(profileDir ? { profileDir } : {}),
-                ...(port !== 9333 ? { port } : {}),
+                ...(port !== DEFAULT_CDP_PORT ? { port } : {}),
                 ...(readFlag(browserArgs, "--url") ? { url: loginUrl } : {}),
                 ...(launchTimeoutMs !== undefined ? { launchTimeoutMs } : {})
             };
@@ -195,7 +199,16 @@ export async function runProCommand(rest, io, runCliFn) {
                 sourceCli,
                 commandOptions
             });
-            return 0;
+            // Guided wait: interactive terminals walk the user to a verified READY
+            // state instead of returning while login is still unfinished. Scripts
+            // and agents (non-TTY) keep the immediate return unless --wait is
+            // passed; --no-wait always skips.
+            const shouldWaitForReady = !browserArgs.includes("--no-wait") && (browserArgs.includes("--wait") || process.stdout.isTTY === true);
+            if (!shouldWaitForReady)
+                return 0;
+            const waitTimeoutMs = readPositiveNumberFlag(browserArgs, "--wait-timeout-ms") ?? 300_000;
+            const ready = await waitForChatGptLoginReady(io.stderr, { port: opened.port, timeoutMs: waitTimeoutMs });
+            return ready ? 0 : 1;
         }
         if (browserSubcommand === "ask") {
             if (printProBrowserHelpIfRequested(browserArgs, "pro browser ask", io, {
@@ -348,6 +361,34 @@ async function enforceVisibleBrowserSendPacing(cwd, stderr) {
         // best effort: pacing must never block a legitimate send on a write failure
     }
 }
+const PROGRESS_PHASE_LABELS = {
+    connecting: "connecting to browser",
+    tab_ready: "chatgpt tab ready",
+    selecting: "applying selection",
+    sent: "prompt sent, waiting for answer"
+};
+/**
+ * Turns send progress events into stderr lines so multi-minute Pro consults do
+ * not look frozen. Phase transitions print immediately; the per-poll waiting
+ * heartbeat is throttled to one line per heartbeatMs.
+ */
+export function createBrowserSendProgressPrinter(write, heartbeatMs = 10_000) {
+    let lastWaitingElapsedMs;
+    return (event) => {
+        if (event.phase === "waiting") {
+            if (lastWaitingElapsedMs !== undefined && event.elapsedMs - lastWaitingElapsedMs < heartbeatMs)
+                return;
+            lastWaitingElapsedMs = event.elapsedMs;
+            write(`progress: waiting ${Math.round(event.elapsedMs / 1000)}s${event.detail ? ` (${event.detail})` : ""}`);
+            return;
+        }
+        if (event.phase === "answered") {
+            write(`progress: answer received after ${Math.round(event.elapsedMs / 1000)}s${event.detail ? ` (${event.detail})` : ""}`);
+            return;
+        }
+        write(`progress: ${PROGRESS_PHASE_LABELS[event.phase]}${event.detail ? ` (${event.detail})` : ""}`);
+    };
+}
 export async function runAskProCommand(rest, io) {
     const parsedAskPro = parseAskProArgs(rest);
     const hasDryRunMode = parsedAskPro.optionArgs.includes("--dry-run");
@@ -409,7 +450,7 @@ export async function runAskProCommand(rest, io) {
         ...(selectionProMode ? { pro_mode: selectionProMode } : {}),
         ...(selectionEffort ? { effort: selectionEffort } : {})
     };
-    const browserPort = hasSendMode ? (readPortFlag(parsedAskPro.optionArgs, "--port") ?? 9333) : undefined;
+    const browserPort = hasSendMode ? resolveCdpPort(readPortFlag(parsedAskPro.optionArgs, "--port")) : undefined;
     // Pro extended can legitimately think for minutes, so its default timeout is
     // higher; an explicit --timeout-ms always wins.
     const defaultBrowserTimeoutMs = selectionProMode === "확장" ? 300_000 : 90_000;
@@ -480,7 +521,8 @@ export async function runAskProCommand(rest, io) {
                 projectNew: selectionProjectNew,
                 model: selectionModel,
                 proMode: selectionProMode,
-                effort: selectionEffort
+                effort: selectionEffort,
+                onProgress: createBrowserSendProgressPrinter(io.stderr)
             });
         }
         catch (error) {
@@ -579,6 +621,10 @@ export async function runAskProCommand(rest, io) {
         io.stdout(`${result.task_id}\t${result.status}\t${consult.url}`);
         io.stdout("");
         io.stdout(result.summary);
+        // Discoverability footer on stderr: the answer above is also persisted,
+        // and `pro latest` re-prints it without a new browser send.
+        const cwdForHints = readFlag(parsedAskPro.optionArgs, "--cwd") ? targetCwd : undefined;
+        io.stderr(`${answerArtifactPath ? `saved: ${answerArtifactPath}` : "saved: task result (answer too large for a fetchable artifact)"} | re-print: ${formatProLatestCommand(sourceCli, { cwd: cwdForHints })}`);
     }
     else {
         await writeSessionBestEffort(targetStore, {
@@ -599,6 +645,84 @@ export async function runAskProCommand(rest, io) {
     return 0;
 }
 export const PRO_BROWSER_SMOKE_TOKEN = "PRODEX_PRO_SMOKE_OK";
+/**
+ * MCP-facing wrapper around the visible-browser ask flow. Reuses the full CLI
+ * path (send pacing, task/session/receipt persistence, artifact save) by
+ * invoking runAskProCommand with captured io, then returns structured fields
+ * instead of printed lines. Registered only on the local stdio MCP server -
+ * never on the HTTP MCP surface, which is exposed to ChatGPT itself.
+ */
+export async function performBrowserConsultForMcp(cwd, input) {
+    const stdoutLines = [];
+    const stderrLines = [];
+    const argv = [
+        "--send",
+        ...(input.model !== undefined ? ["--model", input.model] : []),
+        ...(input.pro_mode !== undefined ? ["--pro-mode", input.pro_mode] : []),
+        ...(input.effort !== undefined ? ["--effort", input.effort] : []),
+        ...(input.project !== undefined ? ["--project", input.project] : []),
+        ...(input.timeout_ms !== undefined ? ["--timeout-ms", String(input.timeout_ms)] : []),
+        ...(input.files ?? []).flatMap((file) => ["--file", file]),
+        "--",
+        input.prompt
+    ];
+    await runAskProCommand(argv, {
+        cwd,
+        stdout: (line) => stdoutLines.push(line),
+        stderr: (line) => stderrLines.push(line),
+        allowAskProBrowserSend: true
+    });
+    const header = stdoutLines[0] ?? "";
+    const [taskId = "", status = "", thread = ""] = header.split("\t");
+    return {
+        task_id: taskId,
+        status,
+        thread,
+        answer: stdoutLines.slice(2).join("\n"),
+        notes: stderrLines.filter((line) => !line.startsWith("progress:"))
+    };
+}
+/**
+ * Guided login: poll the visible browser until a logged-in ChatGPT tab with a
+ * usable composer appears, narrating each state change so the user knows what
+ * manual step (login, challenge, opening a chat) is still missing.
+ */
+export async function waitForChatGptLoginReady(stderr, options, deps = {}) {
+    const statusFn = deps.statusFn ?? getChatGptBrowserStatus;
+    const sleepFn = deps.sleepFn ?? sleep;
+    const now = deps.now ?? Date.now;
+    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)...");
+    let lastState = "";
+    while (now() - startedAt < timeoutMs) {
+        const status = await statusFn({ port: options.port, timeoutMs: 1_500 });
+        const state = !status.reachable
+            ? "login: browser starting..."
+            : status.blocker
+                ? `login: blocked - ${status.blocker.message}`
+                : !status.loggedInLikely
+                    ? "login: waiting for ChatGPT login in the opened window..."
+                    : !status.hasComposer
+                        ? "login: logged in; open a chat so the prompt composer is visible..."
+                        : "";
+        if (state === "") {
+            stderr(`login: READY - logged-in ChatGPT tab with composer detected (${Math.round((now() - startedAt) / 1000)}s).`);
+            return true;
+        }
+        if (state !== lastState) {
+            lastState = state;
+            stderr(state);
+        }
+        const remainingMs = timeoutMs - (now() - startedAt);
+        if (remainingMs <= 0)
+            break;
+        await sleepFn(Math.min(pollMs, Math.max(1, remainingMs)));
+    }
+    stderr(`login: not ready after ${Math.round(timeoutMs / 1000)}s. Finish login in the browser, then verify with \`prodex pro browser check\`.`);
+    return false;
+}
 export async function assertBrowserLaunchStayedAlive(opened, timeoutMs) {
     const outcome = await waitForBrowserLaunchReady(opened, timeoutMs);
     if (outcome.reachable)
@@ -635,12 +759,17 @@ export function browserSendBlockerFromError(error) {
             next_step: "Update prodex (npm i -g @youdie006/prodex@latest); if it persists, report it at https://github.com/youdie006/prodex/issues or paste the prompt manually in the visible browser."
         };
     }
-    if (/^Timed out after \d+ms/.test(message)) {
+    const timedOut = message.match(/^Timed out after (\d+)ms/);
+    if (timedOut) {
+        // Suggest a concrete doubled budget so the user can paste a rerun command
+        // instead of guessing what "raise --timeout-ms" means in milliseconds.
+        const usedMs = Number(timedOut[1]);
+        const suggestedMs = Number.isFinite(usedMs) && usedMs > 0 ? usedMs * 2 : 600_000;
         return {
             code: "send_timeout",
             message,
             retryable: true,
-            next_step: "Raise --timeout-ms (Pro extended already uses a higher default) and rerun the consult."
+            next_step: `Rerun with a bigger budget: \`prodex pro browser ask --timeout-ms ${suggestedMs} "<same prompt>"\`.`
         };
     }
     return {
@@ -847,7 +976,7 @@ export async function printProductCheck(store, io, args, configCwd = io.cwd) {
         }
     }
     const browserStatus = await getChatGptBrowserStatus({
-        port: readPortFlag(args, "--port") ?? 9333,
+        port: resolveCdpPort(readPortFlag(args, "--port")),
         timeoutMs: readPositiveNumberFlag(args, "--timeout-ms") ?? 1500
     });
     const browserCommandOptions = {