chromeflow 0.1.46 → 0.1.48

package/CLAUDE.md

@@ -43,6 +43,7 @@ Do NOT ask "should I open the browser?" — just do it. The user expects seamles
         get_page_text() or wait_for_selector(".success") — ALWAYS confirm after click; click_element returns after 600ms regardless of outcome
         fill_form([{label, value}, ...])    — fill multiple fields in one call; prefer over repeated fill_input
         fill_input("Product name", "Pro")   — fill a single field (works on React, CodeMirror, and contenteditable)
+        type_text("hello world")            — type via trusted keyboard events (use when fill_input fails isTrusted checks)
         set_file_input("Upload", "/abs/path/to/file.zip") — upload a file to a file input (even hidden inputs)
         clear_overlays()                    — call this immediately after fill_input/fill_form succeeds
         scroll_to_element("label text")     — jump directly to a known field; prefer this over scroll_page when the target is known
@@ -155,13 +156,17 @@ screenshot to check what happened.
 **Multiple elements with the same label** (e.g. many "Remove" buttons):
 `click_element("Remove", nth=3)` — use `nth` (1-based) to target the specific one by order top-to-bottom. Check `get_form_fields` or `get_page_text` first to determine which index corresponds to the right section.
 
-**`fill_input` not found:**
+**`fill_input` not found or rejected by the page:**
 1. `click_element(hint)` to focus the field, then retry `fill_input`
-2. `find_and_highlight(hint, "Click here — I'll fill it in")` (no `valueToType`) then
+2. If the site rejects programmatic input (isTrusted check, shadow DOM, custom editors):
+   - `click_element(hint)` to focus the field
+   - `execute_script("document.execCommand('selectAll')")` to clear existing content
+   - `type_text("new value")` — uses CDP trusted keyboard events that pass isTrusted checks
+3. `find_and_highlight(hint, "Click here — I'll fill it in")` (no `valueToType`) then
    `wait_for_click()` — the user's click focuses the field and `fill_input`'s active-element
    fallback fills it automatically
-3. Call `clear_overlays()` after `fill_input` succeeds
-4. Only use `valueToType` when the user must personally type the value (password, personal data)
+4. Call `clear_overlays()` after `fill_input` succeeds
+5. Only use `valueToType` when the user must personally type the value (password, personal data)
 
 **Waiting for async results** (build, save, deploy): `wait_for_selector(selector, timeout)` — never poll with screenshots.
 

package/dist/setup.js

@@ -175,7 +175,9 @@ const CHROMEFLOW_TOOLS = [
   // v0.1.40+
   "capture_terminal",
   // v0.1.42+
-  "set_dialog_response"
+  "set_dialog_response",
+  // v0.1.46+
+  "type_text"
 ].map((t) => `mcp__chromeflow__${t}`);
 function patchSettingsLocalJson(cwd) {
   const claudeDir = join(cwd, ".claude");

package/dist/tools/browser.js

@@ -252,6 +252,27 @@ ${lines.join("\n")}${r.warning ?? ""}` }]
       };
     }
   );
+  server.tool(
+    "type_text",
+    `Type text into the currently focused element using trusted keyboard events via Chrome DevTools Protocol.
+Unlike fill_input (which sets .value programmatically), this produces real keystrokes that pass isTrusted checks. Use this when:
+- fill_input fails because the site validates event.isTrusted (e.g. Outlier, DataAnnotation code editors)
+- The target is a shadow DOM input, custom web component, or heavily guarded editor
+- You need to type into a CodeMirror/Monaco/Ace editor that rejects programmatic value changes
+
+Usage: first click_element or execute_script to focus the target field, then call type_text with the content.
+To clear existing content before typing, use execute_script("document.execCommand('selectAll')") first.`,
+    {
+      text: z.string().describe("The text to type into the focused element")
+    },
+    async ({ text }) => {
+      const response = await bridge.request({ type: "type_text", text });
+      const r = response;
+      return {
+        content: [{ type: "text", text: r.message ?? (r.success ? "Text typed successfully" : "Failed to type text") }]
+      };
+    }
+  );
   server.tool(
     "set_file_input",
     `Upload a file to a file input field. Works even when the input is visually hidden behind a custom drag-and-drop zone.

package/package.json

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