@youdie006/prodex 0.16.1 → 0.16.3

package/dist/banner.js

@@ -44,4 +44,3 @@ export function shouldColorize(env = process.env, isTty = process.stdout.isTTY)
         return env.FORCE_COLOR !== "0";
     return Boolean(isTty);
 }
-//# sourceMappingURL=banner.js.map

package/dist/bundle.js

@@ -27,4 +27,3 @@ export async function buildDryRunBundle(root, input) {
         created_at: nowIso()
     };
 }
-//# sourceMappingURL=bundle.js.map

package/dist/chatgpt-browser.js

@@ -1873,4 +1873,3 @@ function hasChromeLikeVersion(command) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-//# sourceMappingURL=chatgpt-browser.js.map

package/dist/cli-args.js

@@ -357,4 +357,3 @@ export function printHelpIfRequested(args, command, stdout, printHelp, options =
     printHelp(stdout);
     return true;
 }
-//# sourceMappingURL=cli-args.js.map

package/dist/cli-help.js

@@ -31,12 +31,12 @@ Ask / consult commands:
 
 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 create [--cwd /absolute/path/to/repo] --title "Title" --prompt "Prompt" [--repo-id id] [--file path]
   prodex tasks list [--status new|claimed|done|blocked] [--cwd /absolute/path/to/repo] [--json]
   prodex tasks show <task-id|latest> [--cwd /absolute/path/to/repo]
   prodex tasks claim <task-id> [--cwd /absolute/path/to/repo] [--by codex]
   prodex tasks complete <task-id> [--cwd /absolute/path/to/repo] --summary "Summary" [--command "npm test"] [--artifact .bridge/artifacts/results/name.md=text]
-  prodex tasks block <task-id> [--cwd /absolute/path/to/repo] --summary "Summary" [--code code] [--next-step "Next step"] [--retryable]
+  prodex tasks block <task-id> [--cwd /absolute/path/to/repo] --summary "Summary" [--code code] [--next-step "Next step"] [--retryable] [--command "npm test"]
   prodex results show <task-id|latest> [--cwd /absolute/path/to/repo]
   prodex results artifact <task-id|latest> [artifact-path] [--cwd /absolute/path/to/repo]
   prodex results reseal <task-id|latest> --confirm-current-result [--cwd /absolute/path/to/repo]
@@ -45,6 +45,7 @@ Bridge ledger (durable tasks/results/receipts/sessions under .bridge/):
   prodex receipts rotate-key [--cwd /absolute/path/to/repo]
   prodex sessions list [--status preview|running|done|blocked] [--cwd /absolute/path/to/repo] [--json]
   prodex sessions show <session-id|latest> [--cwd /absolute/path/to/repo]
+  prodex sessions cancel <session-id|latest> [--cwd /absolute/path/to/repo]
 
 Agent / MCP integration:
   prodex mcp [--cwd /absolute/path/to/repo]
@@ -200,12 +201,12 @@ export function printTasksHelp(stdout) {
     stdout(`prodex tasks
 
 Commands:
-  prodex tasks create [--cwd /absolute/path/to/repo] --title "Title" --prompt "Prompt"
+  prodex tasks create [--cwd /absolute/path/to/repo] --title "Title" --prompt "Prompt" [--repo-id id] [--file path]
   prodex tasks list [--status new|claimed|done|blocked] [--cwd /absolute/path/to/repo] [--json]
   prodex tasks show <task-id|latest> [--cwd /absolute/path/to/repo]
   prodex tasks claim <task-id> [--cwd /absolute/path/to/repo] [--by codex]
   prodex tasks complete <task-id> [--cwd /absolute/path/to/repo] --summary "Summary" [--command "npm test"] [--artifact .bridge/artifacts/results/name.md=text]
-  prodex tasks block <task-id> [--cwd /absolute/path/to/repo] --summary "Summary" [--code code] [--next-step "Next step"] [--retryable]`);
+  prodex tasks block <task-id> [--cwd /absolute/path/to/repo] --summary "Summary" [--code code] [--next-step "Next step"] [--retryable] [--command "npm test"]`);
 }
 export function printResultsHelp(stdout) {
     stdout(`prodex results
@@ -275,4 +276,3 @@ Persist defaults with \`${cli} setup${sourceCliOption}\`; per-ask flags override
 Use \`${cli} pro ask\` for dry-run/manual previews.
 \`${cli} pro browser ask${sourceCliOption}\` always attempts an explicit visible-browser send.`);
 }
-//# sourceMappingURL=cli-help.js.map

package/dist/cli-ledger.js

@@ -378,4 +378,3 @@ export async function listResultsForInspection(store) {
 export async function listRawResultsForInspection(store) {
     return store.listResultsReadOnly();
 }
-//# sourceMappingURL=cli-ledger.js.map

package/dist/cli-pro.js

@@ -215,16 +215,22 @@ export async function runProCommand(rest, io, runCliFn) {
                 });
                 return 0;
             }
-            const opened = openChatGptBrowser({
-                port,
-                profileDir,
-                url: loginUrl
-            });
-            await assertBrowserLaunchStayedAlive(opened, launchTimeoutMs);
+            // If the dedicated Chrome is already reachable on this port, do NOT spawn
+            // 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 alreadyRunning = (await getChatGptBrowserStatus({ port })).reachable;
+            const opened = alreadyRunning
+                ? { profileDir: profileDir ?? defaultChatGptProfileDir(), port }
+                : openChatGptBrowser({ port, profileDir, url: loginUrl });
+            if (!alreadyRunning) {
+                await assertBrowserLaunchStayedAlive(opened, launchTimeoutMs);
+            }
             // Remember this launch so ask auto-recovery reuses the same profile.
             await recordBrowserLoginLaunch({ profile_dir: opened.profileDir, port: opened.port });
             printBrowserLoginGuide(io.stdout, {
-                opened: true,
+                opened: !alreadyRunning,
+                reused: alreadyRunning,
                 loginUrl,
                 profileDir: opened.profileDir,
                 port: opened.port,
@@ -481,8 +487,9 @@ export async function runAskProCommand(rest, io) {
         throw new Error("--json applies to the visible-browser send output; the dry-run preview does not support it.");
     }
     const prompt = parsedAskPro.promptParts.join(" ").trim();
-    if (!prompt)
-        throw new Error("ask-pro requires a prompt");
+    if (!prompt) {
+        throw new Error('ask-pro requires a prompt. Example: prodex ask "Explain this stack trace" (or pipe input: git diff | prodex ask --stdin "review this diff").');
+    }
     let promptText = prompt;
     if (parsedAskPro.optionArgs.includes("--stdin")) {
         // Unix ergonomics: `git diff | prodex ask --stdin "review this"`.
@@ -1090,6 +1097,7 @@ export async function listConsultListEntries(store, options = { readOnly: true }
     return entries;
 }
 export function printBrowserLoginGuide(stdout, input) {
+    const windowAvailable = input.opened || input.reused === true;
     const loginCommand = formatBrowserLoginCommand(input.sourceCli, input.commandOptions);
     const runtimeCommandOptions = {
         ...(input.commandOptions?.cwd ? { cwd: input.commandOptions.cwd } : {}),
@@ -1098,10 +1106,14 @@ export function printBrowserLoginGuide(stdout, input) {
     const checkCommand = formatBrowserCheckCommand(input.sourceCli, runtimeCommandOptions);
     const smokeCommand = formatBrowserSmokeCommand(input.sourceCli, runtimeCommandOptions);
     stdout("ChatGPT Pro browser login");
-    stdout(input.opened ? "Opened the dedicated Chrome window for ChatGPT." : "Dry run: no browser was opened.");
+    stdout(input.reused
+        ? "Chrome is already running for ChatGPT - reusing it (no new window opened)."
+        : input.opened
+            ? "Opened the dedicated Chrome window for ChatGPT."
+            : "Dry run: no browser was opened.");
     stdout("");
     stdout("Steps:");
-    if (input.opened) {
+    if (windowAvailable) {
         stdout(`1. Log in manually at ${input.loginUrl} in the dedicated Chrome window.`);
         stdout("2. If ChatGPT asks for captcha, Cloudflare/human verification, permission, or account verification, complete it in the browser.");
         stdout("3. For usage limit, message limit, model limit, or rate limit, wait for the reset or choose an available model in the browser.");
@@ -1123,7 +1135,7 @@ export function printBrowserLoginGuide(stdout, input) {
     stdout("");
     stdout(`Profile: ${input.profileDir}`);
     stdout(`Debug: http://127.0.0.1:${input.port}`);
-    if (input.opened) {
+    if (windowAvailable) {
         stdout("You can close this Chrome window after check/smoke or when you are done. The dedicated profile is reused next time.");
     }
     else {
@@ -1390,4 +1402,3 @@ export function orphanConsultResultError(taskId) {
 export function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-//# sourceMappingURL=cli-pro.js.map

package/dist/cli-server.js

@@ -396,4 +396,3 @@ export async function assertGitignoreTargetSafe(filePath) {
         throw error;
     }
 }
-//# sourceMappingURL=cli-server.js.map

package/dist/cli-shared.js

@@ -204,4 +204,3 @@ export function computeSendPacingWaitMs(lastSendAtMs, nowMs, intervalMs) {
         return 0; // clock skew / bad marker: do not wait
     return elapsed >= intervalMs ? 0 : intervalMs - elapsed;
 }
-//# sourceMappingURL=cli-shared.js.map

package/dist/cli.js

@@ -1341,4 +1341,3 @@ if (isDirectCliInvocation()) {
         process.exitCode = 1;
     });
 }
-//# sourceMappingURL=cli.js.map

package/dist/config.js

@@ -316,4 +316,3 @@ async function assertDirectoryHandle(handle, label) {
         throw new Error(`${label} must be a real directory`);
     }
 }
-//# sourceMappingURL=config.js.map

package/dist/http-mcp.js

@@ -23,7 +23,12 @@ export async function startHttpMcpServer(options) {
                 return;
             }
             if (!isAuthorized(req, requestUrl, token, options.tokenExpiresAt)) {
-                writeJson(res, 401, { error: "unauthorized" });
+                // Same 401 for missing/wrong/expired (no oracle), but tell the caller
+                // HOW to authorize without leaking anything token-specific.
+                writeJson(res, 401, {
+                    error: "unauthorized",
+                    hint: "Provide a valid token via `?prodex_token=<token>` or `Authorization: Bearer <token>`. If your token expired, regenerate the profile with `prodex setup` and re-read the URL from `prodex status`."
+                });
                 return;
             }
             if (req.method === "POST") {
@@ -233,4 +238,3 @@ function writeJson(res, status, value) {
     res.writeHead(status, { "content-type": "application/json" });
     res.end(`${JSON.stringify(value)}\n`);
 }
-//# sourceMappingURL=http-mcp.js.map

package/dist/index.js

@@ -6,4 +6,3 @@ export * from "./chatgpt-browser.js";
 export * from "./config.js";
 export * from "./http-mcp.js";
 export * from "./mcp-tools.js";
-//# sourceMappingURL=index.js.map

package/dist/mcp-tools.js

@@ -199,4 +199,3 @@ function assertMcpFiles(files) {
         assertMcpTextField(file.path, `files[${index}].path`, MAX_MCP_SHORT_TEXT_BYTES);
     }
 }
-//# sourceMappingURL=mcp-tools.js.map

package/dist/mcp.js

@@ -279,9 +279,22 @@ export class LimitedStdioServerTransport {
             }
             const line = this.buffer.toString("utf8", 0, newlineIndex).replace(/\r$/, "");
             this.buffer = this.buffer.subarray(newlineIndex + 1);
-            const message = JSONRPCMessageSchema.parse(JSON.parse(line));
+            if (line.trim().length === 0)
+                continue;
+            let message;
+            try {
+                message = JSONRPCMessageSchema.parse(JSON.parse(line));
+            }
+            catch (error) {
+                // A single malformed frame is recoverable: report it and keep
+                // processing the rest of the buffer instead of tearing down the whole
+                // session (which would also drop any valid pipelined messages after
+                // it). This matches the SDK's StdioServerTransport. Only the oversize
+                // guards above stay fatal.
+                this.onerror?.(error instanceof Error ? error : new Error(String(error)));
+                continue;
+            }
             this.onmessage?.(message);
         }
     }
 }
-//# sourceMappingURL=mcp.js.map

package/dist/registry.js

@@ -102,4 +102,3 @@ async function registerBridgeRootInner(root) {
         // Advisory registry - never let it fail a bridge operation.
     }
 }
-//# sourceMappingURL=registry.js.map

package/dist/repo-write.js

@@ -424,4 +424,3 @@ function buildSimpleDiff(repoPath, before, after) {
         ...after.replace(/\r\n/g, "\n").split("\n").map((line) => `+${line}`)
     ].join("\n");
 }
-//# sourceMappingURL=repo-write.js.map

package/dist/repo.js

@@ -484,4 +484,3 @@ export async function assertResolvedRepoPathAllowed(root, resolved, repoPath) {
 function isErrorCode(error, code) {
     return typeof error === "object" && error !== null && "code" in error && error.code === code;
 }
-//# sourceMappingURL=repo.js.map

package/dist/safe-file.js

@@ -292,4 +292,3 @@ function procFdPath(fd) {
 function isMissingFileError(error) {
     return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
 }
-//# sourceMappingURL=safe-file.js.map

package/dist/schema.js

@@ -106,4 +106,3 @@ export function makeBridgeId(prefix, title, date = new Date()) {
     const stamp = date.toISOString().replace(/[-:]/g, "").replace(/\..+$/, "").replace("T", "_");
     return `${prefix}_${stamp}_${slugify(title)}`;
 }
-//# sourceMappingURL=schema.js.map

package/dist/store.js

@@ -273,8 +273,26 @@ export class BridgeStore {
     }
     async listFinalizedResultsReadOnly() {
         const results = await this.listResultsReadOnly();
+        if (results.length === 0)
+            return results;
+        if (!(await this.hasReadyStorageDirReadOnly("receipts"))) {
+            throw untrustedResultError(this.root, results[0].task_id, "has no trusted task_completed receipt");
+        }
+        // Read receipts ONCE and index them by task_id instead of re-reading and
+        // re-parsing the whole receipts directory for every result, which was
+        // O(results x receipts) on the completion/list hot path.
+        const completionReceiptsByTask = new Map();
+        for (const receipt of await this.readAll("receipts", parseReceiptRecord, { cleanupTempHardLinks: false })) {
+            if (receipt.kind !== "task_completed" || !receipt.task_id)
+                continue;
+            const existing = completionReceiptsByTask.get(receipt.task_id);
+            if (existing)
+                existing.push(receipt);
+            else
+                completionReceiptsByTask.set(receipt.task_id, [receipt]);
+        }
         for (const result of results) {
-            await this.assertTrustedTaskCompletionReceiptReadOnly(result.task_id, result);
+            await this.assertReceiptsTrustCompletion(result.task_id, result, completionReceiptsByTask.get(result.task_id) ?? []);
         }
         return results;
     }
@@ -505,6 +523,11 @@ export class BridgeStore {
             throw untrustedResultError(this.root, taskId, "has no trusted task_completed receipt");
         }
         const receipts = (await this.readAll("receipts", parseReceiptRecord, { cleanupTempHardLinks: false })).filter((receipt) => receipt.kind === "task_completed" && receipt.task_id === taskId);
+        await this.assertReceiptsTrustCompletion(taskId, result, receipts);
+    }
+    // Given the already-loaded task_completed receipts for one task, accept if any
+    // one is locally trusted and its result digest matches; otherwise throw.
+    async assertReceiptsTrustCompletion(taskId, result, receipts) {
         if (receipts.length === 0) {
             throw untrustedResultError(this.root, taskId, "has no trusted task_completed receipt");
         }
@@ -1542,4 +1565,3 @@ function redactReceiptForDisplay(receipt, integrityStatus) {
     }
     return ReceiptSchema.parse({ ...receipt, metadata });
 }
-//# sourceMappingURL=store.js.map

package/package.json

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

package/dist/banner.d.ts

@@ -1,5 +0,0 @@
-export interface BannerOptions {
-    color?: boolean;
-}
-export declare function renderBanner(options?: BannerOptions): string;
-export declare function shouldColorize(env?: NodeJS.ProcessEnv, isTty?: boolean): boolean;

package/dist/banner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAKA,kFAAkF;AAClF,8EAA8E;AAC9E,oCAAoC;AACpC,MAAM,QAAQ,GAAG;IACf,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;IAC3B,2BAA2B;CAC5B,CAAC;AAEF,MAAM,QAAQ,GAAG;IACf,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,2BAA2B;CAC5B,CAAC;AAEF,MAAM,GAAG,GAAG,GAAG,CAAC;AAChB,MAAM,GAAG,GAAG,GAAG,GAAG,kBAAkB,CAAC,CAAC,gBAAgB;AACtD,MAAM,GAAG,GAAG,GAAG,GAAG,oBAAoB,CAAC,CAAC,mDAAmD;AAC3F,MAAM,GAAG,GAAG,GAAG,GAAG,oBAAoB,CAAC,CAAC,UAAU;AAClD,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;AAE1B,MAAM,OAAO,GAAG,gEAAgE,CAAC;AAEjF,MAAM,UAAU,YAAY,CAAC,UAAyB,EAAE;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACpC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK;IAC/F,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACpE,uHAAuH;IACvH,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC,WAAW,KAAK,GAAG,CAAC;IAC5F,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC"}

package/dist/bundle.d.ts

@@ -1,15 +0,0 @@
-import { type BridgeFile } from "./schema.js";
-export interface DryRunBundleInput {
-    prompt: string;
-    files: string[];
-}
-export interface DryRunBundle {
-    schema_version: 1;
-    id: string;
-    mode: "manual_copy";
-    prompt: string;
-    files: BridgeFile[];
-    text: string;
-    created_at: string;
-}
-export declare function buildDryRunBundle(root: string, input: DryRunBundleInput): Promise<DryRunBundle>;

package/dist/bundle.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAiBzC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAwB;IAC5E,MAAM,QAAQ,GAAa;QACzB,0BAA0B;QAC1B,EAAE;QACF,qCAAqC;QACrC,EAAE;QACF,WAAW;QACX,EAAE;QACF,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;KACpB,CAAC;IACF,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/F,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO;QACL,cAAc,EAAE,cAAc;QAC9B,EAAE,EAAE,YAAY,CAAC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACvE,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,UAAU,EAAE,MAAM,EAAE;KACrB,CAAC;AACJ,CAAC"}

package/dist/chatgpt-browser.d.ts

@@ -1,252 +0,0 @@
-export interface ChatGptBrowserOptions {
-    port?: number;
-    profileDir?: string;
-    url?: string;
-}
-export interface ChatGptBrowserLaunch {
-    command: string;
-    args: string[];
-    profileDir: string;
-    port: number;
-    waitForEarlyExit: (timeoutMs?: number) => Promise<ChatGptBrowserEarlyExit | undefined>;
-}
-export interface ChatGptBrowserEarlyExit {
-    code?: number | null;
-    signal?: NodeJS.Signals | null;
-    error?: string;
-}
-export interface ChatGptBrowserStatus {
-    reachable: boolean;
-    loggedInLikely: boolean;
-    hasComposer: boolean;
-    visibilityState?: string;
-    url?: string;
-    title?: string;
-    modelHints: string[];
-    blocker?: {
-        code: string;
-        message: string;
-        retryable: boolean;
-        next_step?: string;
-    };
-}
-export declare class ChatGptBrowserBlockerError extends Error {
-    readonly blocker: NonNullable<ChatGptBrowserStatus["blocker"]>;
-    constructor(blocker: NonNullable<ChatGptBrowserStatus["blocker"]>);
-}
-export type ChatGptReasoningEffort = "즉시" | "중간" | "높음" | "매우 높음";
-export type ChatGptProMode = "기본" | "확장";
-/** Normalize a CLI reasoning-effort value onto the exact ChatGPT menu label. */
-export declare function parseReasoningEffort(raw: string): ChatGptReasoningEffort;
-/** Normalize a CLI Pro sub-mode value onto the exact ChatGPT menu label. */
-export declare function parseProMode(raw: string): ChatGptProMode;
-export declare const DEFAULT_CDP_PORT = 9333;
-/**
- * Stability policy for the answer poll loop. Returns true once the observed
- * (answer, generating) stream should be accepted as final:
- * - normal answers: two consecutive identical, non-generating polls;
- * - answers whose tail looks like the streaming caret: six additional
- *   confirmations (~6s at the 1s poll cadence), so a lingering caret gets
- *   dropped by ChatGPT's finalization re-render first, while an answer that
- *   genuinely ends with an underscore is still accepted after the extra wait.
- */
-export declare function createChatGptAnswerStabilityTracker(): (answer: string, generating: boolean) => boolean;
-/**
- * Resolve the Chrome DevTools port: explicit flag > PRODEX_CDP_PORT env >
- * default 9333. The env var exists so a non-default port picked at login does
- * not have to be repeated as --port on every later command.
- */
-export declare function resolveCdpPort(explicit?: number): number;
-export type SendChatGptProgressPhase = "connecting" | "tab_ready" | "selecting" | "sent" | "waiting" | "answered";
-export interface SendChatGptProgressEvent {
-    phase: SendChatGptProgressPhase;
-    elapsedMs: number;
-    detail?: string;
-}
-export interface SendChatGptPromptOptions {
-    port?: number;
-    prompt: string;
-    targetUrl?: string;
-    timeoutMs?: number;
-    /** Switch into this sidebar project (by visible name) before sending. */
-    project?: string;
-    /** Create a new project with this name before sending. */
-    projectNew?: string;
-    /** Model to select in the composer picker, e.g. "Pro" or "GPT-5.5". */
-    model?: string;
-    /** Pro sub-mode, used when model is Pro. */
-    proMode?: ChatGptProMode;
-    /** Reasoning effort, used for non-Pro models. */
-    effort?: ChatGptReasoningEffort;
-    /**
-     * Navigate the tab to a fresh chat (chatgpt.com root) before sending. Long
-     * accumulated threads eventually break prompt-acceptance detection
-     * (measured live), so agent loops and debates should send each consult
-     * into a fresh chat. Incompatible with targetUrl.
-     */
-    newChat?: boolean;
-    /** Progress callback so long sends can report phase + elapsed instead of staying silent. */
-    onProgress?: (event: SendChatGptProgressEvent) => void;
-}
-export interface SendChatGptPromptResult {
-    url: string;
-    title: string;
-    answer: string;
-    modelHints: string[];
-    warnings: string[];
-}
-interface ChatGptAnswerState {
-    title: string;
-    url: string;
-    answer: string;
-    modelHints: string[];
-    generating: boolean;
-    assistantMessageCount: number;
-    userMessageCount: number;
-    textSample: string;
-    blockerTextSample: string;
-    blockerScanTextSample?: string;
-    visibleButtonLabels: string[];
-}
-export interface ChatGptPageTextState {
-    textSample: string;
-    blockerTextSample?: string;
-    blockerScanTextSample?: string;
-    visibleButtonLabels: string[];
-}
-export declare const CHATGPT_RUNTIME_BLOCKER_TEXT_EXCLUDED_ANCESTORS = "[data-message-author-role],script,style,noscript,[aria-hidden=\"true\"],div[role=\"textbox\"],textarea,[contenteditable=\"true\"]";
-export declare const CHATGPT_BLOCKER_SCAN_EXCLUDED_ANCESTORS = "[data-message-author-role],script,style,noscript,[aria-hidden=\"true\"],div[role=\"textbox\"],textarea,[contenteditable=\"true\"],nav,aside,[role=\"navigation\"]";
-export declare const CHATGPT_COMPOSER_CANDIDATE_EXCLUDED_ANCESTORS = "[data-message-author-role],script,style,noscript,[aria-hidden=\"true\"]";
-export declare const PRODEX_ACTIVE_COMPOSER_ATTRIBUTE = "data-prodex-active-composer";
-export interface DevtoolsPage {
-    id?: string;
-    type: string;
-    url: string;
-    title: string;
-    webSocketDebuggerUrl: string;
-}
-export declare const CHATGPT_STREAMING_SELECTOR = "[data-testid=\"stop-button\"],[data-message-author-role=\"assistant\"][aria-busy=\"true\"],[data-message-author-role=\"assistant\"] [aria-busy=\"true\"]";
-export declare function defaultChatGptProfileDir(): string;
-export interface BrowserLoginLaunchRecord {
-    profile_dir: string;
-    port: number;
-}
-/**
- * Remember how the last login launched the browser (profile dir + port) so
- * auto-recovery relaunches the SAME profile instead of the default one - a
- * custom-profile user must never be silently sent to a different account.
- * Best-effort: failures never break the login.
- */
-export declare function recordBrowserLoginLaunch(record: BrowserLoginLaunchRecord): Promise<void>;
-export declare function readLastBrowserLoginLaunch(): Promise<Partial<BrowserLoginLaunchRecord> | undefined>;
-export declare function buildChromeLaunchArgs(options: Required<ChatGptBrowserOptions>): string[];
-export declare function inferLoggedInLikely(text: string, visibleButtonLabels?: string[]): boolean;
-export declare function isUsableChatGptAnswer(answer: string): boolean;
-export declare function hasFreshChatGptAnswer(previousAssistantMessageCount: number, state: Pick<ChatGptAnswerState, "answer" | "assistantMessageCount" | "generating">): boolean;
-export interface AcceptanceTimeoutContext {
-    timeoutMs: number;
-    composerStillHasText: boolean;
-    submitButtonFound: boolean;
-}
-export declare function acceptanceTimeoutError(ctx: AcceptanceTimeoutContext): Error;
-export declare function hasPartialChatGptAnswer(previousAssistantMessageCount: number, state: Pick<ChatGptAnswerState, "answer" | "assistantMessageCount">): boolean;
-/**
- * True when the tab is on a fresh, empty ChatGPT chat: the root URL (not a
- * /c/<id> conversation) with zero messages. Used after a --new-chat navigation
- * to confirm the page actually reached the fresh chat before the answer-count
- * baseline is captured - a lingering old thread (slow navigation) has a /c/ URL
- * or non-zero counts and would poison the baseline.
- */
-export declare function isFreshChatGptPage(state: {
-    url: string;
-    assistantMessageCount: number;
-    userMessageCount: number;
-}): boolean;
-export declare function hasChatGptPromptAcceptance(previous: Pick<ChatGptAnswerState, "assistantMessageCount" | "userMessageCount">, state: Pick<ChatGptAnswerState, "assistantMessageCount" | "generating" | "userMessageCount">): boolean;
-export declare function chatGptBusyBlocker(generating: boolean): ChatGptBrowserStatus["blocker"] | undefined;
-export declare function isLikelyChatGptSubmitButton(label: string, dataTestId: string | null): boolean;
-export declare function isLikelyChatGptGeneratingControl(label: string): boolean;
-export declare function detectChatGptBlocker(text: string, visibleButtonLabels?: string[]): ChatGptBrowserStatus["blocker"] | undefined;
-export declare function detectChatGptPageBlocker(state: ChatGptPageTextState): ChatGptBrowserStatus["blocker"] | undefined;
-export declare function inferChatGptPageLoggedInLikely(state: ChatGptPageTextState): boolean;
-export declare function chatGptBlockerErrorFromAnswerState(state: {
-    textSample: string;
-    blockerTextSample?: string;
-    blockerScanTextSample?: string;
-    visibleButtonLabels: string[];
-}): string | undefined;
-export declare function chatGptBlockerFromAnswerState(state: {
-    textSample: string;
-    blockerTextSample?: string;
-    blockerScanTextSample?: string;
-    visibleButtonLabels: string[];
-}): ChatGptBrowserStatus["blocker"] | undefined;
-export declare function computePromptAcceptanceDeadline(timeoutMs: number, startedAt: number): number;
-export declare function computePageDiscoveryTimeout(timeoutMs: number): number;
-export declare function normalizeChatGptTargetUrl(value: string): string;
-export declare function chatGptUrlsReferToSameTarget(currentUrl: string, expectedUrl: string): boolean;
-export declare function selectChatGptPage(pages: DevtoolsPage[], targetUrl?: string, visibilityByPage?: Map<string, string>): DevtoolsPage | undefined;
-export declare function chatGptPageSelectionBlocker(pages: DevtoolsPage[], targetUrl?: string, visibilityByPage?: Map<string, string>): ChatGptBrowserStatus["blocker"] | undefined;
-export declare function assertVisibleChatGptTab(visibilityState: string | undefined, url: string, targetUrl?: string): void;
-export declare function isTabActivationEnabled(env?: NodeJS.ProcessEnv): boolean;
-export declare function assertChatGptTargetUrlMatches(currentUrl: string, targetUrl: string): void;
-export declare function assertChatGptTargetTabAvailable(targetUrl: string): void;
-export declare function assertChatGptPageAvailable(): never;
-export declare function assertChatGptReadyForPrompt(loggedInLikely: boolean, hasComposer: boolean): void;
-export declare function chatGptVisibilityBlocker(visibilityState: string | undefined, url: string | undefined): ChatGptBrowserStatus["blocker"] | undefined;
-/**
- * Environment for the browser spawn. On Linux shells without DISPLAY or
- * WAYLAND_DISPLAY (common in WSL where a non-login shell does not export
- * them), a present WSLg X socket means a desktop is actually available -
- * inject DISPLAY=:0 so Chrome does not exit immediately with code 1.
- */
-export declare function browserLaunchEnv(platform?: NodeJS.Platform, env?: Record<string, string | undefined>, hasX0Socket?: () => boolean): Record<string, string | undefined>;
-export declare function openChatGptBrowser(options?: ChatGptBrowserOptions): ChatGptBrowserLaunch;
-export declare function getChatGptBrowserStatus(options?: {
-    port?: number;
-    timeoutMs?: number;
-}): Promise<ChatGptBrowserStatus>;
-export declare function menuOpenExpression(): string;
-export declare function menuClosedExpression(): string;
-export declare function menuItemLabelMatches(text: string, candidates: readonly string[]): boolean;
-export declare function menuItemPresentExpression(label: string | readonly string[]): string;
-export declare function modelButtonRectExpression(): string;
-export declare function menuItemRectExpression(label: string | readonly string[]): string;
-export declare function submenuItemRectExpression(label: string | readonly string[]): string;
-export declare function proRadioRectExpression(): string;
-export declare function proSubmenuExpanderRectExpression(): string;
-export declare function projectItemRectExpression(name: string): string;
-export declare function newProjectButtonRectExpression(): string;
-export declare function newProjectNameInputRectExpression(): string;
-export declare function newProjectNameInputVisibleExpression(): string;
-export declare function sendChatGptPrompt(options: SendChatGptPromptOptions): Promise<SendChatGptPromptResult>;
-export interface ChatGptModelOption {
-    label: string;
-    kind: "radio" | "submenu";
-    checked: boolean;
-}
-export interface ListChatGptModelOptionsResult {
-    url: string;
-    options: ChatGptModelOption[];
-}
-export declare function modelMenuOptionsExpression(): string;
-export declare function listChatGptModelOptions(input?: {
-    port?: number;
-    timeoutMs?: number;
-}): Promise<ListChatGptModelOptionsResult>;
-export declare function resolveCdpTimeoutMs(explicit?: number): number;
-export declare const CHATGPT_THINKING_PLACEHOLDER_JS = "ansLines.length <= 1 && (/^(\uC0DD\uAC01\\s*\uC911|thinking)$/i.test(ansStripped) || /^thought (for|about)\\b.*$/i.test(ansStripped) || /\\d+\\s*s\\s*\uB3D9\uC548\\s*\uC0DD\uAC01\uD568$/.test(ansStripped) || /(^|\\s)(\uC0DD\uAC01\\s*\uC911|thinking)$/i.test(ansStripped))";
-export declare function statusExpression(): string;
-export declare function prepareComposerExpression(): string;
-export declare function composerTextStateExpression(expectedText?: string): string;
-export declare function submitExpression(): string;
-/**
- * Ordered browser candidates for the current platform: PATH binary names
- * first, then well-known absolute install locations (macOS app bundles,
- * Windows Program Files/LOCALAPPDATA, and Windows-host browsers under WSL).
- * WSL detection cannot rely on WSL_DISTRO_NAME alone: non-login shells
- * (measured live) may not carry it, so WSL_INTEROP and the kernel string are
- * probed too.
- */
-export declare function chromeCommandCandidates(platform?: NodeJS.Platform, env?: Record<string, string | undefined>, isWsl?: () => boolean): string[];
-export {};