chromeflow 0.1.55 → 0.1.57

package/CLAUDE.md

@@ -34,10 +34,8 @@ Do NOT ask "should I open the browser?" — just do it. The user expects seamles
 ## Guided flow pattern
 
 ```
-1. show_guide_panel(title, steps[])          — show the full plan upfront
-2. open_page(url)                            — navigate to the right page (add new_tab=true to keep current tab open)
-   mark_step_done(0)                         — ALWAYS mark step 0 done right after open_page succeeds
-3. For each step:
+1. open_page(url)                            — navigate to the right page (add new_tab=true to keep current tab open)
+2. For each step:
    a. Claude acts directly:
         click_element("Save")               — press buttons/links Claude can press
         get_page_text() or wait_for_selector(".success") — ALWAYS confirm after click; click_element returns after 600ms regardless of outcome
@@ -62,8 +60,7 @@ Do NOT ask "should I open the browser?" — just do it. The user expects seamles
         find_and_highlight(text, msg)        — show the user what to do
         wait_for_click()                    — wait for user interaction
         [after fill_input] clear_overlays() — always clear after filling
-   e. mark_step_done(i)                      — check off the step after it is complete
-4. clear_overlays()                          — clean up when done
+3. clear_overlays()                          — clean up when done
 ```
 
 **Default to automation.** Only pause for human input when the step genuinely requires
@@ -238,4 +235,30 @@ document.body.style.zoom = '1';
 1. Retry the exact same `execute_script` call
 2. If still failing, use `find_and_highlight` to show the user a download button to click manually
 
+**Shadow DOM `[role=radio]` / custom radios silently no-op**: On sites like Outlier,
+`element.click()` on a shadow-DOM radio often doesn't flip `aria-checked`. Two things
+must be true: (a) the element must be scrolled into view FIRST (`scrollIntoView({block:'center'})`),
+and (b) the full pointer-event chain must fire — not just `click()`:
+```js
+['pointerdown','mousedown','pointerup','mouseup','click'].forEach(t =>
+  el.dispatchEvent(new MouseEvent(t, {bubbles: true, cancelable: true}))
+);
+```
+After scroll, re-query the radio list — its length may change as more content becomes
+visible. Then verify `aria-checked === "true"` before moving on.
+
+**Visibility-detection overlays** (e.g. Multimango's "Content Hidden" black overlay):
+Some sites render a full-screen overlay when the tab loses focus, triggered by
+`document.visibilityState` / `document.hidden`. Chromeflow tab-switching triggers it.
+Workaround — remove the overlay and patch the APIs:
+```js
+document.querySelectorAll('[style*="z-index: 99999"]').forEach(el => el.remove());
+Object.defineProperty(document, 'hidden', { get: () => false, configurable: true });
+Object.defineProperty(document, 'visibilityState', { get: () => 'visible', configurable: true });
+['visibilitychange','blur'].forEach(t =>
+  document.addEventListener(t, e => e.stopImmediatePropagation(), true)
+);
+```
+Re-apply after every navigation.
+
 **Never use Bash to work around a stuck browser interaction.**

package/README.md

@@ -17,7 +17,7 @@ Chromeflow works in **your actual Chrome browser**, where you're already logged
 | **Browser** | Your real Chrome (sessions intact) | Fresh instance, logged out of everything |
 | **Auth / 2FA** | Already handled — pauses when needed | Can't handle — blocks completely |
 | **Page understanding** | DOM queries (fast, cheap, reliable) | Screenshots + vision model (slow, expensive) |
-| **Human-in-the-loop** | Built-in guide panel, highlights, pauses | Fully autonomous, no interaction |
+| **Human-in-the-loop** | Highlights, pauses on sensitive input | Fully autonomous, no interaction |
 | **Integration** | MCP server for Claude Code | Standalone, not Claude Code aware |
 | **Credential capture** | Reads API keys → writes to `.env` | Not designed for this |
 
@@ -90,7 +90,6 @@ Claude will navigate, highlight steps, click what it can, pause for anything sen
 | Screenshot + save + copy to clipboard | `take_and_copy_screenshot` |
 | Screenshot the terminal window | `capture_terminal` |
 | Save/restore form state across tabs | `save_page_state`, `restore_page_state` |
-| Show a step-by-step guide panel | `show_guide_panel`, `mark_step_done` |
 
 ### File uploads
 

package/dist/setup.js

@@ -53,9 +53,8 @@ Do NOT ask "should I open the browser?" \u2014 just do it. The user expects seam
 ## Guided flow pattern
 
 \`\`\`
-1. show_guide_panel(title, steps[])          \u2014 show the full plan upfront
-2. open_page(url)                            \u2014 navigate to the right page
-3. For each step:
+1. open_page(url)                            \u2014 navigate to the right page
+2. For each step:
    a. [if needed] take_screenshot()          \u2014 only when you need to locate something
    b. Claude acts directly:
         click_element("Save")               \u2014 press buttons/links Claude can press
@@ -64,8 +63,7 @@ Do NOT ask "should I open the browser?" \u2014 just do it. The user expects seam
       Or pause for the user:
         find_and_highlight(text, msg)        \u2014 show the user what to do
         wait_for_click()                    \u2014 wait for user interaction
-   c. mark_step_done(i)                      \u2014 check off the step
-4. clear_overlays()                          \u2014 clean up when done
+3. clear_overlays()                          \u2014 clean up when done
 \`\`\`
 
 **Default to automation.** Only pause for human input when the step genuinely requires
@@ -153,10 +151,8 @@ const CHROMEFLOW_TOOLS = [
   "click_element",
   "wait_for_click",
   "wait_for_selector",
-  "mark_step_done",
   "find_and_highlight",
   "highlight_region",
-  "show_guide_panel",
   // v0.1.23+
   "switch_to_tab",
   "list_tabs",
@@ -177,7 +173,9 @@ const CHROMEFLOW_TOOLS = [
   // v0.1.42+
   "set_dialog_response",
   // v0.1.46+
-  "type_text"
+  "type_text",
+  // v0.1.57+
+  "inspect_request_headers"
 ].map((t) => `mcp__chromeflow__${t}`);
 function patchSettingsLocalJson(cwd) {
   const claudeDir = join(cwd, ".claude");

package/dist/tools/browser.js

@@ -190,7 +190,7 @@ For prompt: the value string is returned to the page. For confirm: true/false is
   );
   server.tool(
     "clear_overlays",
-    "Remove all highlights and callout annotations from the current page. Does NOT remove the guide panel \u2014 the guide panel persists until the next flow starts.",
+    "Remove all highlights and callout annotations from the current page.",
     {},
     async () => {
       await bridge.request({ type: "clear" });
@@ -321,6 +321,23 @@ PAGE ALERT: "${alert}" \u2014 the page showed a dialog with this message. Read i
       };
     }
   );
+  server.tool(
+    "inspect_request_headers",
+    `Navigate to a URL and capture the exact HTTP request headers Chrome sends for the main document request.
+Use this to diagnose server-side bot detection \u2014 e.g. when a site returns a "mobile" or "switch devices" page despite the client reporting desktop.
+Returns the request method, URL, and all headers including Sec-CH-UA-* client hints.
+This tool DOES navigate the active tab to the URL.`,
+    {
+      url: z.string().url().describe("URL to navigate to and capture headers for")
+    },
+    async ({ url }) => {
+      const response = await bridge.request({ type: "inspect_request_headers", url }, 2e4);
+      const r = response;
+      return {
+        content: [{ type: "text", text: r.message ?? "(no headers captured)" }]
+      };
+    }
+  );
 }
 export {
   registerBrowserTools

package/dist/tools/flow.js

@@ -138,19 +138,6 @@ ${lines.join("\n")}`
       };
     }
   );
-  server.tool(
-    "mark_step_done",
-    "Mark a step in the guide panel as completed (shows a green check). Call this after any step finishes \u2014 whether Claude acted autonomously or the user completed a highlighted step via wait_for_click.",
-    {
-      stepIndex: z.number().int().describe("0-based index of the step to mark done")
-    },
-    async ({ stepIndex }) => {
-      await bridge.request({ type: "mark_step_done", stepIndex });
-      return {
-        content: [{ type: "text", text: `Step ${stepIndex + 1} marked as done.` }]
-      };
-    }
-  );
 }
 export {
   registerFlowTools

package/dist/tools/highlight.js

@@ -64,30 +64,6 @@ Only pass x/y/width/height when you have no selector and already have fresh coor
       };
     }
   );
-  server.tool(
-    "show_guide_panel",
-    "Show a floating step-by-step guide panel on the page to help the user understand what they need to do",
-    {
-      title: z.string().describe("Title of the guide (e.g. 'Set up Stripe API keys')"),
-      steps: z.array(
-        z.object({
-          text: z.string().describe("Step instruction text"),
-          done: z.boolean().optional().describe("Whether this step is already completed")
-        })
-      ).describe("Ordered list of steps")
-    },
-    async ({ title, steps }) => {
-      await bridge.request({ type: "show_panel", title, steps });
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Guide panel shown: "${title}" with ${steps.length} steps.`
-          }
-        ]
-      };
-    }
-  );
 }
 export {
   registerHighlightTools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromeflow",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "Browser guidance MCP server for Claude Code — highlights, clicks, fills, and captures from the web so you don't have to.",
   "type": "module",
   "bin": {