chromeflow 0.1.25 → 0.1.26

package/CLAUDE.md

@@ -63,7 +63,8 @@ Do NOT ask "should I open the browser?" — just do it. The user expects seamles
         [if fails] get_elements()           — get EXACT DOM coords, use these in highlight_region
         highlight_region(x,y,w,h,msg)       — use exact coords from get_elements, not estimates
         [after wait_for_click] get_page_text() — confirm result, NOT take_screenshot
-        [last resort only] take_screenshot() — only if you need to see the visual layout
+        [last resort only] take_screenshot() — returns image to Claude only (no file, no clipboard)
+        take_and_copy_screenshot()          — same as above BUT also saves PNG + copies to clipboard
    d. Pause for the user when needed:
         find_and_highlight(text, msg)        — show the user what to do
         wait_for_click()                    — wait for user interaction

package/dist/tools/browser.js

@@ -50,7 +50,7 @@ ${lines.join("\n")}` }]
   );
   server.tool(
     "take_screenshot",
-    "Capture a screenshot ONLY when click_element or fill_input has failed and you need pixel coordinates to call highlight_region. DO NOT use this to check page state, confirm actions, or see what loaded \u2014 use get_page_text for all of that.",
+    "Capture a screenshot and return it to Claude only \u2014 no file is saved, nothing goes to the clipboard. Use ONLY when you need to visually inspect the page layout or get pixel coordinates for highlight_region. DO NOT use to check page state or confirm actions \u2014 use get_page_text for that. To also save or copy the image, use take_and_copy_screenshot instead.",
     {},
     async () => {
       const response = await bridge.request({ type: "screenshot" });
@@ -74,10 +74,10 @@ ${lines.join("\n")}` }]
   );
   server.tool(
     "take_and_copy_screenshot",
-    `Take a screenshot, copy it to the system clipboard, and save it as a PNG file.
-Use this when you need to share, upload, or keep a screenshot outside of Claude.
-The image is always copied to the clipboard so you can immediately paste it anywhere.
-save_to controls where the file is saved: "downloads" (default) saves to ~/Downloads, "cwd" saves to Claude's current working directory.`,
+    `Take a screenshot, return it to Claude, copy it to the system clipboard, and save it as a PNG file.
+Use this instead of take_screenshot when you need the image outside of Claude \u2014 to paste into a chat, upload to a form, or keep as a file.
+Unlike take_screenshot (Claude-only), this also puts the image on the clipboard and saves it to disk.
+save_to controls where the PNG is saved: "downloads" (default) saves to ~/Downloads, "cwd" saves to Claude's current working directory.`,
     {
       save_to: z.enum(["downloads", "cwd"]).optional().describe(`Where to save the PNG file: "downloads" (~/Downloads, default) or "cwd" (Claude's current working directory)`)
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromeflow",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "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": {