@youdie006/prodex 0.37.0 → 0.38.0

package/README.md

@@ -424,6 +424,47 @@ During local development, you can run the TypeScript source directly:
 npm run dev -- tasks list
 ```
 
+## When a send breaks
+
+prodex drives a web UI that changes underneath it, so the interesting question is what you have when that happens.
+
+**Report it from the receipt, not from memory.** A blocked consult already records the blocker, the version and the platform, so `prodex pro report-issue` builds the report out of that:
+
+```bash
+prodex pro report-issue              # prints it, files nothing
+prodex pro report-issue --confirm    # opens it as a GitHub issue, through `gh`
+```
+
+The prompt, the answer and the summary never travel - a public issue is not where a private consult should leak - and filing is deduplicated by blocker code, so something that stays broken adds to one issue instead of opening a new one every time.
+
+**Capture what the page looked like.** With diagnostics on, a failing send leaves a screenshot and a snapshot of the picker and composer next to each other:
+
+```bash
+PRODEX_BROWSER_DIAGNOSTICS=1 prodex ask "..."
+# .bridge/diagnostics/<when>/{screen.png,page-shape.json}
+```
+
+The snapshot carries roles, testids, rects, `aria-value*` and `pointer-events`. Those last two are what identified a model row that no coordinate could click and a slider step prodex could not read. Captures stay on your machine and are never attached to a report; a screenshot of ChatGPT shows the conversation.
+
+**Notice before a person does.** `scripts/ui-watchdog.mjs` sends a token and checks the reply - a real round trip rather than a guess from the page's shape - and can file what it finds:
+
+```bash
+node scripts/ui-watchdog.mjs                 # says ok or broken
+node scripts/ui-watchdog.mjs --file-issue    # and reports it
+```
+
+It needs the logged-in browser, so it belongs on a machine that has one rather than in CI. A daily cron entry is enough.
+
+## Sending without leaving a trace
+
+`--temporary` sends into a ChatGPT Temporary Chat, which leaves your chat list untouched:
+
+```bash
+prodex ask --new-chat --temporary "..."
+```
+
+It costs something, and prodex says so on every such send: an unsaved chat is not in the transcript API, so the answer is read off the page, where tables and citation links can be lost - and neither `pro browser recover` nor `--target-url` can reach it afterwards. It requires `--new-chat`, because a throwaway chat cannot be continued.
+
 ## FAQ
 
 **A send failed with `send_ui_changed` / "the ChatGPT web UI may have changed".** prodex drives the visible ChatGPT web UI, so an OpenAI redesign of the composer or send control can break sends. When a send times out without the prompt ever posting (the composer still holds the text, or no send button was found), prodex reports this as a likely UI change instead of a misleading "slow model" timeout. Fix: update prodex (`npm i -g @youdie006/prodex@latest`); if it persists, open an issue at https://github.com/youdie006/prodex/issues, and paste the prompt manually in the visible browser in the meantime.

package/dist/chatgpt-browser.js

@@ -15,7 +15,12 @@ export class ChatGptBrowserBlockerError extends Error {
         this.blocker = blocker;
     }
 }
-const REASONING_EFFORTS = ["즉시", "중간", "높음", "매우 높음"];
+// Five steps, not four. Measured at both ends of the live slider: position 0 of
+// 4 reads "Instant, 1 of 5" and position 4 reads "Pro, 5 of 5", so Pro is a step
+// of this control rather than a model. Leaving it out meant --effort could not
+// reach the top of the slider at all, and the only route there - --model Pro -
+// answered with advice to "say --effort Pro", which then failed.
+const REASONING_EFFORTS = ["즉시", "중간", "높음", "매우 높음", "Pro"];
 const PRO_MODES = ["기본", "확장"];
 // Aliases map friendly CLI input onto the exact Korean menu labels the picker
 // clicks by text. Keys are lowercased and space-stripped before lookup.
@@ -25,7 +30,9 @@ const REASONING_EFFORT_ALIASES = {
     medium: "중간",
     high: "높음",
     max: "매우 높음",
-    extrahigh: "매우 높음"
+    extrahigh: "매우 높음",
+    pro: "Pro",
+    "프로": "Pro"
 };
 // Menu labels per canonical value, verified live in both the Korean and the
 // English (US) ChatGPT UI. Matching tries every candidate so either UI works.
@@ -33,7 +40,8 @@ const EFFORT_MENU_LABELS = {
     "즉시": ["즉시", "Instant"],
     "중간": ["중간", "Medium"],
     "높음": ["높음", "High"],
-    "매우 높음": ["매우 높음", "Extra High"]
+    "매우 높음": ["매우 높음", "Extra High"],
+    Pro: ["Pro", "프로"]
 };
 const PRO_MODE_SUBMENU_LABELS = {
     "기본": ["Pro 기본", "Pro Standard", "Standard", "기본"],
@@ -1637,7 +1645,21 @@ export function pinnedSelectionWarning(pinned, offered) {
     if (offered.length === 0)
         return undefined;
     const has = (wanted) => offered.some((label) => label.trim().toLowerCase() === wanted.trim().toLowerCase());
-    const missing = [pinned.model, pinned.effort].find((wanted) => wanted !== undefined && !has(wanted));
+    // A value prodex already knows to be a slider step needs no listing to
+    // vouch for it: the slider shows one step at a time, so a listing that
+    // happens to read "Extra High" says nothing about Pro. Warning there was a
+    // false alarm about a setting the very next send used successfully, and an
+    // alarm that cries about known-good settings is one people learn to skip.
+    const knownStep = (wanted) => {
+        try {
+            parseReasoningEffort(wanted);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const missing = [pinned.model, pinned.effort].find((wanted) => wanted !== undefined && !has(wanted) && !knownStep(wanted));
     if (missing === undefined)
         return undefined;
     // Say only what was seen. The picker lists its models, but the effort slider
@@ -1714,6 +1736,31 @@ async function dispatchArrowKey(cdp, key) {
     await cdp.send("Input.dispatchKeyEvent", { type: "rawKeyDown", key, code, windowsVirtualKeyCode: virtualKey });
     await cdp.send("Input.dispatchKeyEvent", { type: "keyUp", key, code, windowsVirtualKeyCode: virtualKey });
 }
+/**
+ * How to read every step of the slider and leave it as it was.
+ *
+ * The control shows one step at a time, and that single visible label was all
+ * `pro browser models` ever reported - which is how a machine on this same
+ * account concluded "Pro does not exist here" from five listings that each read
+ * Instant / GPT-5.6 Sol / GPT-5.5, with the slider parked on Instant every
+ * time. Seeing the rest means walking it, and walking someone's setting is only
+ * acceptable if it is put back, so the plan always ends where it started.
+ *
+ * Refuses bounds that do not look like this control, so a misread never becomes
+ * thousands of keystrokes in someone's browser.
+ */
+export function sliderWalkPlan(state) {
+    const { position, min, max } = state;
+    if (!Number.isInteger(position) || !Number.isInteger(min) || !Number.isInteger(max))
+        return undefined;
+    const steps = max - min;
+    if (steps < 1 || steps > 12)
+        return undefined;
+    if (position < min || position > max)
+        return undefined;
+    const offset = position - min;
+    return { toBottom: offset, climb: steps, back: offset };
+}
 async function selectModelReasoning(cdp, options, selectionWarnings = []) {
     if (!options.model && !options.proMode && !options.effort)
         return;
@@ -3206,6 +3253,52 @@ export async function listChatGptSidebarProjects(input = {}) {
     }
     return { url: status.url, projects };
 }
+/**
+ * Every step of the effort slider, read by walking it and putting it back.
+ *
+ * Best effort: a slider that cannot be focused, read or walked leaves the
+ * listing exactly as it was rather than failing a read-only command.
+ */
+async function readEffortSteps(cdp) {
+    try {
+        const focused = await cdp.evaluate(focusPowerSliderExpression());
+        if (!focused?.ok)
+            return undefined;
+        const start = await cdp.evaluate(powerSliderStateExpression());
+        if (!start?.ok)
+            return undefined;
+        const plan = sliderWalkPlan({ position: start.position, min: start.min, max: start.max });
+        if (!plan)
+            return undefined;
+        const current = start.effort ?? null;
+        for (let i = 0; i < plan.toBottom; i += 1) {
+            await dispatchArrowKey(cdp, "ArrowLeft");
+            await sleep(120);
+        }
+        const labels = [];
+        const record = async () => {
+            const state = await cdp.evaluate(powerSliderStateExpression());
+            const label = state?.effort?.trim();
+            if (label && !labels.includes(label))
+                labels.push(label);
+        };
+        await record();
+        for (let i = 0; i < plan.climb; i += 1) {
+            await dispatchArrowKey(cdp, "ArrowRight");
+            await sleep(120);
+            await record();
+        }
+        // Put it back. Reading someone's setting must not change it.
+        for (let i = 0; i < plan.climb - plan.back; i += 1) {
+            await dispatchArrowKey(cdp, "ArrowLeft");
+            await sleep(120);
+        }
+        return labels.length > 0 ? { labels, current } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 export async function listChatGptModelOptions(input = {}) {
     const port = resolveCdpPort(input.port);
     const timeoutMs = input.timeoutMs ?? 15_000;
@@ -3239,7 +3332,8 @@ export async function listChatGptModelOptions(input = {}) {
             if (!opened)
                 throw new Error("ChatGPT model menu did not open after clicking the selector");
             const options = await cdp.evaluate(modelMenuOptionsExpression());
-            return { url: status.url, options };
+            const effortSteps = await readEffortSteps(cdp);
+            return { url: status.url, options, ...(effortSteps ? { effortSteps } : {}) };
         }
         finally {
             try {

package/dist/cli-help.js

@@ -26,10 +26,11 @@ 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 300000] [--busy-wait-ms 600000] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--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] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Pro] [--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] [--json]
   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] [--json]
+  prodex pro report-issue [--cwd /absolute/path/to/repo] [--task <task-id>] [--repo owner/name] [--confirm]  # bug report from a failed consult's receipt; previews unless --confirm, never carries the prompt or the answer
 
 Bridge ledger (durable tasks/results/receipts/sessions under .bridge/):
   prodex init [--cwd /absolute/path/to/repo]
@@ -51,7 +52,7 @@ Bridge ledger (durable tasks/results/receipts/sessions under .bridge/):
 
 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 setup [--cwd /absolute/path/to/repo] [--host 127.0.0.1] [--port 8787] [--token-ttl-hours <hours>] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Pro] [--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]
@@ -79,7 +80,7 @@ export function printSetupHelp(stdout) {
     stdout(`prodex setup
 
 Commands:
-  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 setup [--cwd /absolute/path/to/repo] [--host 127.0.0.1] [--port 8787] [--token-ttl-hours <hours>] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Pro] [--project "name"] [--clear-model|--clear-pro-mode|--clear-effort|--clear-project] [--interactive]
 
 Save a loopback-only HTTP MCP profile in .bridge/config.local.json. Use --token-ttl-hours before tunnels or ChatGPT Project use.
 
@@ -167,10 +168,11 @@ Commands:
   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]
-  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"] [--project "name" | --project-new "name"] "prompt"
+  prodex pro browser ask [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--target-url url --confirm-target] [--new-chat] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] [--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Pro] [--project "name" | --project-new "name"] "prompt"
   prodex pro latest [--source-cli /absolute/path/to/dist/cli.js] [--cwd /absolute/path/to/repo] [--json]
   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] [--json]
+  prodex pro report-issue [--cwd /absolute/path/to/repo] [--task <task-id>] [--repo owner/name] [--confirm]  # bug report from a failed consult's receipt; previews unless --confirm, never carries the prompt or the answer
 
 Use \`prodex pro ask\` for dry-run/manual previews.
 Use \`prodex pro browser ask\` only when you want an explicit visible-browser send.
@@ -251,7 +253,7 @@ export function printProBrowserHelp(stdout, sourceCli) {
     const smokeUsage = sourceCli
         ? `${cli} pro browser smoke${sourceCliOption} [--cwd /absolute/path/to/repo] [--port 9333] [--timeout-ms 90000]`
         : "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 selectionUsage = '[--model Pro] [--pro-mode 기본|확장] [--effort 즉시|중간|높음|"매우 높음"|Pro] [--project "name" | --project-new "name"]';
     const askUsage = sourceCli
         ? `${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] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] ${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] [--temporary] [--stdin] [--json] [--auto-login|--no-auto-login] [--file path] [--attach path] [--tool deep-research|web-search|create-image] ${selectionUsage} "prompt"`;

package/dist/cli-pro.js

@@ -447,7 +447,17 @@ export async function runProCommand(rest, io, runCliFn) {
             for (const option of listed.options) {
                 io.stdout(formatModelMenuOption(option));
             }
-            io.stdout("An arrow shows what that row is set to now; --model / --effort reach into those submenus (e.g. --model Pro).");
+            if (listed.effortSteps) {
+                io.stdout("");
+                io.stdout("Effort steps on this account (the slider was walked and put back):");
+                for (const label of listed.effortSteps.labels) {
+                    io.stdout(`${label === listed.effortSteps.current ? "*" : " "} ${label}`);
+                }
+                io.stdout("Pass any of these to --effort. The list is complete: the slider shows one step at a time, so reading it any other way sees only the current one.");
+            }
+            else {
+                io.stdout("An arrow shows what that row is set to now; --model / --effort reach into those submenus (e.g. --model Pro).");
+            }
             return 0;
         }
         if (browserSubcommand === "projects") {

package/dist/cli.js

@@ -436,7 +436,9 @@ repo: ${cwd}
 
 Safety notes:
 - This command only prints commands; it does not start servers, open browsers, or write files.
-- Visible-browser sends require a manual, visible browser session and stop on login, captcha, Cloudflare, permission, rate-limit, or usage-limit blockers, plus response_choice_pending when ChatGPT is waiting for you to pick which of two answers you prefer.`;
+- Visible-browser sends require a manual, visible browser session and stop on login, captcha, Cloudflare, permission, rate-limit, or usage-limit blockers, plus response_choice_pending when ChatGPT is waiting for you to pick which of two answers you prefer.
+- When a send is blocked, \`prodex pro report-issue\` turns that receipt into a bug report (prints it; --confirm files it). It carries the blocker, version and platform, never the prompt or the answer.
+- PRODEX_BROWSER_DIAGNOSTICS=1 makes a failing send leave a screenshot and a page snapshot under .bridge/diagnostics for whoever debugs it. They stay local.`;
 }
 async function hasOnboardingReadme(cwd) {
     try {

package/dist/config.js

@@ -10,7 +10,8 @@ const BRIDGE_DIRECTORY_MODE = 0o700;
 const BrowserDefaultsSchema = z.object({
     model: z.string().min(1).optional(),
     pro_mode: z.enum(["기본", "확장"]).optional(),
-    effort: z.enum(["즉시", "중간", "높음", "매우 높음"]).optional(),
+    // Pro is the slider's fifth step, so a saved default may name it.
+    effort: z.enum(["즉시", "중간", "높음", "매우 높음", "Pro"]).optional(),
     project: z.string().min(1).optional()
 });
 const LocalConfigSchema = z.object({

package/package.json

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