tauri-agent-tools 0.9.1 → 0.9.2

package/.agents/skills/tauri-agent-tools/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: tauri-agent-tools
 description: CLI for inspecting and interacting with Tauri desktop apps — DOM queries, screenshots, interaction (click/type/scroll), IPC monitoring, store inspection, structured assertions, plus bridge-free diagnostics (unified cross-layer logs, deep OS process trees, OS logs, app paths, sidecar NDJSON tap/replay, forensic bundles) and the `diagnose`/`bundle` super-commands for one-shot triage. Works against older/vendored bridges by degrading gracefully.
-version: 0.9.1
+version: 0.9.2
 tags: [tauri, desktop, debugging, screenshot, dom, inspection, diff, mutations, snapshot, interaction, click, type, scroll, invoke, probe, capture, check, store-inspect, logs, bundle, process-tree, forensics, os-logs, app-paths, sidecar, config-inspect, diagnose]
 ---
 
@@ -269,6 +269,9 @@ tauri-agent-tools type "#search" "hello world" --json
 # Clear and retype
 tauri-agent-tools type "#email" "new@email.com" --clear --json
 
+# App applies the value on a transition/async render: wait longer for it to stick
+tauri-agent-tools type "#q" "term" --verify-timeout 2000 --json
+
 # Scroll to bottom
 tauri-agent-tools scroll --to-bottom --json
 
@@ -292,6 +295,8 @@ tauri-agent-tools invoke get_release_context --json
 tauri-agent-tools invoke save_item '{"id": 42}' --json
 ```
 
+`type` and `select <value>` write through the element's native `value` setter (so React/Vue/Svelte controlled inputs see the change); `select --toggle` performs a native `click()`. Both then re-read the element. `verification: "reverted"` in the failure JSON (exit 1, with a `hint`; `type` prints it with `--json`, `select` always) means the app rolled the write back — a controlled input that rejected it — and is the app's answer, not a tooling error. `verification: "transformed"` means the app reformatted the value and counts as success (`verified: false`).
+
 ### Probe, capture, and check (workflow commands)
 
 ```bash
@@ -347,11 +352,11 @@ tauri-agent-tools eval "document.title" --window-label overlay --json
 | `mutations` | `<selector>`, `--attributes`, `--duration <ms>`, `--json` | yes | Watch DOM mutations |
 | `snapshot` | `-o <prefix>`, `-s <css>`, `--window-id <id>`, `--dom-depth <n>`, `--eval <js>`, `--json` | yes | Screenshot + DOM + page state + storage |
 | `click` | `<selector>`, `--double`, `--right`, `--wait <ms>`, `--json` | yes | Click a DOM element |
-| `type` | `<selector> <text>`, `--clear`, `--json` | yes | Type text into an input |
+| `type` | `<selector> <text>`, `--clear`, `--verify-timeout <ms>`, `--json` | yes | Type text into an input (native setter, verified write) |
 | `scroll` | `--selector <css>`, `--by <px>`, `--to-top`, `--to-bottom`, `--into-view`, `--json` | yes | Scroll window or element |
 | `focus` | `<selector>`, `--json` | yes | Focus a DOM element |
 | `navigate` | `<target>`, `--json` | yes | Navigate within the app |
-| `select` | `<selector> [value]`, `--toggle`, `--json` | yes | Select dropdown or toggle checkbox |
+| `select` | `<selector> [value]`, `--toggle`, `--verify-timeout <ms>`, `--json` | yes | Select dropdown or toggle checkbox (native setter; `--toggle` via native `click()`; verified write) |
 | `invoke` | `<command> [args-json]`, `--json` | yes | Invoke a Tauri IPC command |
 | `probe` | `--pid <n>`, `--json` | optional | Discover targets and bridge health |
 | `capture` | `-o <dir>`, `-s <css>`, `--window-id <id>`, `--logs-duration <ms>`, `--json` | yes | Full debug evidence bundle |

package/.agents/skills/tauri-bridge-setup/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: tauri-bridge-setup
 description: How to add the tauri-agent-tools Rust dev bridge to a Tauri application
-version: 0.9.1
+version: 0.9.2
 tags: [tauri, rust, bridge, setup, integration, multi-window, process-tree, capabilities, devtools, health]
 ---
 

package/.agents/skills/tauri-debug-quickstart/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: tauri-debug-quickstart
 description: First-30-seconds triage for a broken Tauri desktop app. Pick the right command for the symptom you're seeing, with one-line escalations to deeper skills.
-version: 0.9.1
+version: 0.9.2
 tags: [tauri, debugging, triage, quickstart, decision-tree, logs, process-tree, bundle, forensics, diagnose]
 ---
 

package/README.md

@@ -258,14 +258,16 @@ Monitor Rust backend logs and sidecar output in real-time. Unlike `console-monit
 
 Interaction commands dispatch DOM events inside the webview. They require the dev bridge (debug builds only).
 
+`type` and `select` write through the element's native prototype `value` setter — React's per-instance value tracker turns a plain `el.value = …` into a no-op — and dispatch bubbling `input`/`change` events, so React, Vue, and Svelte controlled inputs update their state; `select --toggle` performs a native `click()`. Both then re-read the element: a value the app rolled back fails with `Value reverted` (`Checked state reverted` for `--toggle`; exit 1 with the reason and a `hint` on stderr, and the failure object with `verification: "reverted"` on stdout — with `--json` for `type`, always for `select`) — treat that as the app's answer, not a tooling error — while a value the app reformatted is a success reported with `verification: "transformed"`. `--verify-timeout <ms>` (default 500) tunes the re-read deadline for apps that apply values asynchronously.
+
 | Command | Description |
 |---------|-------------|
 | `click <selector>` | Click a DOM element (`--double`, `--right`, `--wait <ms>`) |
-| `type <selector> <text>` | Type text into an input (`--clear` to empty first) |
+| `type <selector> <text>` | Type text into an input via the native value setter, then verify the write (`--clear` to empty first, `--verify-timeout <ms>`) |
 | `scroll` | Scroll window or element (`--by <px>`, `--to-top`, `--to-bottom`, `--into-view`) |
 | `focus <selector>` | Focus a DOM element |
 | `navigate <target>` | Navigate within the app (route path or URL) |
-| `select <selector> [value]` | Select dropdown value or toggle checkbox (`--toggle`) |
+| `select <selector> [value]` | Select a dropdown value or toggle a checkbox via native `click()`, then verify the write (`--toggle`, `--verify-timeout <ms>`) |
 | `invoke <command> [args-json]` | Invoke a Tauri IPC command |
 
 ### Workflow Commands

package/dist/commands/interact/select.d.ts

@@ -1,3 +1,8 @@
 import { Command } from 'commander';
-export declare function buildSelectScript(selector: string, value?: string, toggle?: boolean): string;
+import type { VerifyOptions } from './shared.js';
+/**
+ * Value mode writes through the native prototype value setter and verifies the
+ * write (see buildSetValueScript); toggle mode performs a native click().
+ */
+export declare function buildSelectScript(selector: string, value?: string, toggle?: boolean, options?: VerifyOptions): string;
 export declare function registerSelect(program: Command): void;

package/dist/commands/interact/select.js

@@ -1,37 +1,83 @@
 import { Command } from 'commander';
 import { resolveBridge } from '../shared.js';
-import { addInteractOptions, escapeSelector } from './shared.js';
+import { addInteractOptions, addVerifyOptions, buildSetValueScript, escapeSelector, parseInteractResult, resolveVerifyTimeout, VERIFY_INTERVAL_MS, VERIFY_POLL_SNIPPET, } from './shared.js';
 import { SelectResultSchema } from '../../schemas/interact.js';
-export function buildSelectScript(selector, value, toggle = false) {
+/**
+ * --toggle: a native click(). The browser flips checkedness internally (not
+ * through the JS `checked` setter React wraps), fires input + change, honours
+ * preventDefault(), and is the only event React's ChangeEventPlugin observes
+ * for checkbox/radio. click() is a no-op on disabled controls (including
+ * descendants of <fieldset disabled>) and cannot uncheck a radio, so those
+ * are refused up front instead of reporting a state that did not change.
+ */
+function buildToggleScript(selector, verifyTimeoutMs) {
     const escaped = escapeSelector(selector);
-    if (toggle) {
-        return `(function() {
-  try {
-    var el = document.querySelector('${escaped}');
-    if (!el) return JSON.stringify({ success: false, error: 'Element not found: ${escaped}' });
-    el.checked = !el.checked;
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-    el.dispatchEvent(new Event('input', { bubbles: true }));
-    return JSON.stringify({ success: true, selector: '${escaped}', tagName: el.tagName.toLowerCase(), checked: el.checked });
-  } catch (e) {
-    return JSON.stringify({ success: false, error: String(e) });
+    return `(() => {${VERIFY_POLL_SNIPPET}
+  var selector = '${escaped}';
+  var fail = function (extra) { return JSON.stringify(Object.assign({ success: false, selector: selector }, extra)); };
+  function isDisabled(node) {
+    try { if (node.matches(':disabled')) return true; } catch (e) { /* selector unsupported */ }
+    if (node.disabled) return true;
+    return !!(typeof node.closest === 'function' && node.closest('fieldset[disabled]'));
   }
-})()`;
-    }
-    const escapedValue = value !== undefined ? escapeSelector(value) : '';
-    return `(function() {
   try {
-    var el = document.querySelector('${escaped}');
-    if (!el) return JSON.stringify({ success: false, error: 'Element not found: ${escaped}' });
-    el.value = '${escapedValue}';
-    el.dispatchEvent(new Event('change', { bubbles: true }));
-    el.dispatchEvent(new Event('input', { bubbles: true }));
-    return JSON.stringify({ success: true, selector: '${escaped}', tagName: el.tagName.toLowerCase(), value: el.value });
+    var el = document.querySelector(selector);
+    if (!el) return fail({ error: 'Element not found: ' + selector });
+    var tagName = el.tagName.toLowerCase();
+    var inputType = tagName === 'input' ? String(el.type || 'text').toLowerCase() : '';
+    if (inputType !== 'checkbox' && inputType !== 'radio') {
+      return fail({ tagName: tagName, error: 'Element <' + tagName + (inputType ? ' type=' + inputType : '') + '> is not a checkbox or radio', hint: '--toggle supports <input type=checkbox|radio>; use \`select <selector> <value>\` for other elements.' });
+    }
+    var before = !!el.checked;
+    if (isDisabled(el)) {
+      return fail({ tagName: tagName, checked: before, error: 'Element is disabled (or inside a disabled <fieldset>); click() has no effect' });
+    }
+    if (inputType === 'radio' && before) {
+      return fail({ tagName: tagName, checked: true, error: 'Radio input is already checked; a radio cannot be unchecked by clicking it', hint: 'Toggle the sibling radio you want selected instead.' });
+    }
+    var expected = !before;
+    el.click();
+    return __verify(function () {
+      var cur = document.querySelector(selector) || (el.isConnected ? el : null);
+      return cur ? !!cur.checked : null;
+    }, expected, ${verifyTimeoutMs}, ${VERIFY_INTERVAL_MS}).then(function (v) {
+      if (v.ok) {
+        return JSON.stringify({ success: true, selector: selector, tagName: tagName, checked: v.observed, previousChecked: before, verified: true, verification: 'matched' });
+      }
+      if (v.observed === null) {
+        return fail({
+          tagName: tagName, previousChecked: before, verified: false,
+          error: 'Element left the document after click(); the checked state could not be verified',
+          hint: 'The app removed or re-rendered the element without a matching selector after the click (navigation, a remount, or the click consumed the item). Re-query the DOM to confirm the app state.'
+        });
+      }
+      return fail({
+        tagName: tagName, checked: !!v.observed, previousChecked: before, verified: false, verification: 'reverted',
+        error: 'Checked state reverted: click() set checked=' + expected + ' but the element reads ' + String(!!v.observed) + ' after ${verifyTimeoutMs}ms',
+        hint: 'A controlled checkbox whose change handler did not accept the change, or a click listener that called preventDefault().'
+      });
+    });
   } catch (e) {
-    return JSON.stringify({ success: false, error: String(e) });
+    return fail({ error: 'Script error: ' + (e && e.message ? e.message : String(e)) });
   }
 })()`;
 }
+/**
+ * Value mode writes through the native prototype value setter and verifies the
+ * write (see buildSetValueScript); toggle mode performs a native click().
+ */
+export function buildSelectScript(selector, value, toggle = false, options) {
+    const verifyTimeoutMs = resolveVerifyTimeout(options);
+    if (toggle)
+        return buildToggleScript(selector, verifyTimeoutMs);
+    return buildSetValueScript(selector, value ?? '', {
+        focus: false,
+        clear: false,
+        lowerCaseTagName: true,
+        notFoundErrorExpr: `'Element not found: ' + selector`,
+        verifyTimeoutMs,
+    });
+}
 export function registerSelect(program) {
     const cmd = new Command('select')
         .description('Set the value of a form element or toggle a checkbox')
@@ -42,17 +88,29 @@ export function registerSelect(program) {
 Examples:
   $ tauri-agent-tools select "select#country" "US"
   $ tauri-agent-tools select "input[name='agree']" --toggle
-  $ tauri-agent-tools select "input#search" "hello world"`);
+  $ tauri-agent-tools select "input#search" "hello world"
+
+Values are written through the native prototype setter and followed by bubbling
+input + change events; <select> values must match an <option> value attribute.
+--toggle performs a native click() so React and other frameworks that listen to
+click for checkboxes update their state. The element is re-read afterwards and
+the command fails when the app reverted the change.`);
     addInteractOptions(cmd);
+    addVerifyOptions(cmd);
     cmd.action(async (selector, value, opts) => {
+        // Build first: an invalid --verify-timeout fails before any bridge call.
+        const script = buildSelectScript(selector, value, opts.toggle ?? false, { verifyTimeoutMs: opts.verifyTimeout });
         const bridge = await resolveBridge(opts);
-        const script = buildSelectScript(selector, value, opts.toggle ?? false);
         const raw = await bridge.eval(script);
-        const result = SelectResultSchema.parse(JSON.parse(String(raw)));
+        const result = parseInteractResult(raw, SelectResultSchema, 'Select');
+        // select always prints its JSON result; on failure the object (verification,
+        // hint, options, …) still goes to stdout, and the thrown error reaches
+        // stderr and sets exit code 1.
+        console.log(JSON.stringify(result, null, 2));
         if (!result.success) {
-            throw new Error(result.error ?? 'Select failed');
+            const hint = result.hint ? `\n  hint: ${result.hint}` : '';
+            throw new Error(`${result.error ?? 'Select failed'}${hint}`);
         }
-        console.log(JSON.stringify(result, null, 2));
     });
     program.addCommand(cmd);
 }

package/dist/commands/interact/select.js.map

@@ -1 +1 @@
-{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/commands/interact/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAAc,EAAE,SAAkB,KAAK;IACzF,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;;uCAE4B,OAAO;kFACoC,OAAO;;;;wDAIjC,OAAO;;;;KAI1D,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO;;uCAE8B,OAAO;kFACoC,OAAO;kBACvE,YAAY;;;wDAG0B,OAAO;;;;KAI1D,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;SAC9B,WAAW,CAAC,sDAAsD,CAAC;SACnE,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;SACrD,QAAQ,CAAC,SAAS,EAAE,oCAAoC,CAAC;SACzD,MAAM,CAAC,UAAU,EAAE,iDAAiD,CAAC;SACrE,WAAW,CAAC,OAAO,EAAE;;;;0DAIgC,CAAC,CAAC;IAE1D,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,KAAyB,EAAE,IAAuC,EAAE,EAAE;QACxG,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;QACxE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/commands/interact/select.ts"],"names":[],"mappings":"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"}

package/dist/commands/interact/shared.d.ts

@@ -1,4 +1,5 @@
 import type { Command } from 'commander';
+import type { z } from 'zod';
 /**
  * Escapes backslashes and single quotes in CSS selectors for safe
  * embedding inside JS string literals wrapped in single quotes.
@@ -21,3 +22,98 @@ export declare function buildWaitAndFindScript(selector: string, waitMs: number)
  * plus --json for machine-readable output. Returns the command for chaining.
  */
 export declare function addInteractOptions(cmd: Command): Command;
+/**
+ * Default deadline for the post-write re-read. An accepted write resolves on
+ * the first (synchronous) check, so it costs nothing; only a rejected write
+ * waits out the whole deadline.
+ */
+export declare const DEFAULT_VERIFY_TIMEOUT_MS = 500;
+/**
+ * dev_bridge.rs answers 504 after 5 s and BridgeClient.eval aborts at 5 s;
+ * keep at least 1 s of slack for dispatch + IPC + HTTP.
+ */
+export declare const MAX_VERIFY_TIMEOUT_MS = 4000;
+/**
+ * Poll cadence after the synchronous first check. React commits
+ * transition-lane updates on a Scheduler macrotask, so a microtask/rAF
+ * re-read would be too early.
+ */
+export declare const VERIFY_INTERVAL_MS = 50;
+export interface VerifyOptions {
+    /** 0..MAX_VERIFY_TIMEOUT_MS; 0 = single synchronous check. Default DEFAULT_VERIFY_TIMEOUT_MS. */
+    verifyTimeoutMs?: number;
+}
+export declare function resolveVerifyTimeout(opts?: VerifyOptions): number;
+/** Adds --verify-timeout to a value-writing interaction command. */
+export declare function addVerifyOptions(cmd: Command): Command;
+/**
+ * JS snippet defining `__resolveValueWriter(node)`.
+ *
+ * React (react-dom's inputValueTracking) redefines `value` as an own accessor
+ * on every mounted <input>/<textarea> instance to remember what it wrote;
+ * assigning through that accessor makes the following input/change event a
+ * no-op for React (#10). Built-in form elements are therefore written through
+ * the prototype setter React itself captured. Custom elements are searched up
+ * their prototype chain (Lit/Stencil define accessors on the class prototype)
+ * and fall back to plain assignment for instance-defined or class-field
+ * `value`s. Anything else has no value setter and is refused instead of being
+ * silently given an expando property.
+ *
+ * The parameter is deliberately named `node` so generated scripts never
+ * contain the text `el.value =`.
+ */
+export declare const NATIVE_VALUE_WRITER_SNIPPET = "\n  function __resolveValueWriter(node) {\n    var tag = node.tagName;\n    var proto = tag === 'INPUT' ? HTMLInputElement.prototype\n      : tag === 'TEXTAREA' ? HTMLTextAreaElement.prototype\n      : tag === 'SELECT' ? HTMLSelectElement.prototype\n      : null;\n    if (proto) {\n      var d = Object.getOwnPropertyDescriptor(proto, 'value');\n      if (d && typeof d.set === 'function') return { kind: 'native', set: function (v) { d.set.call(node, v); } };\n      return { kind: 'assign', set: function (v) { node.value = v; } };\n    }\n    if (String(node.localName || '').indexOf('-') !== -1) {\n      var p = Object.getPrototypeOf(node);\n      while (p && p !== Object.prototype) {\n        var cd = Object.getOwnPropertyDescriptor(p, 'value');\n        if (cd && typeof cd.set === 'function') return { kind: 'custom', set: function (v) { cd.set.call(node, v); } };\n        p = Object.getPrototypeOf(p);\n      }\n      if ('value' in node) return { kind: 'assign', set: function (v) { node.value = v; } };\n    }\n    return null;\n  }";
+/**
+ * JS snippet defining `__verify(read, expected, timeoutMs, intervalMs)`.
+ *
+ * The first read is synchronous: React restores a rejected controlled value
+ * inside dispatchEvent, so it is already visible. Later reads catch
+ * transition-lane commits and frameworks that apply values asynchronously.
+ * Resolves `{ ok, observed }` and never rejects. `read` is re-invoked on every
+ * tick so a re-mounted node is read instead of a stale reference.
+ */
+export declare const VERIFY_POLL_SNIPPET = "\n  function __verify(read, expected, timeoutMs, intervalMs) {\n    return new Promise(function (resolve) {\n      var deadline = Date.now() + timeoutMs;\n      function check() {\n        var observed;\n        try { observed = read(); } catch (e) { observed = undefined; }\n        if (observed === expected) { resolve({ ok: true, observed: observed }); return; }\n        if (Date.now() >= deadline) { resolve({ ok: false, observed: observed }); return; }\n        setTimeout(check, intervalMs);\n      }\n      check();\n    });\n  }";
+/**
+ * JS snippet defining `__settle()` — resolves after two macrotasks. Used after
+ * focus()/--clear so that state the app changed in response (React flushes an
+ * onFocus setState on a microtask, an accepted clear commits synchronously, and
+ * a commit scheduled from the app's own zero-delay timer lands on a Scheduler
+ * task after the first macrotask) is visible before the pre-write baseline is
+ * read and the target node is re-resolved.
+ */
+export declare const SETTLE_SNIPPET = "\n  function __settle() {\n    return new Promise(function (resolve) {\n      setTimeout(function () { setTimeout(resolve, 0); }, 0);\n    });\n  }";
+/** JS snippet defining `__selectOptionValues(node)` — option values of a <select>, [] otherwise. */
+export declare const SELECT_OPTIONS_SNIPPET = "\n  function __selectOptionValues(node) {\n    if (!node.options || typeof node.options.length !== 'number') return [];\n    return Array.prototype.map.call(node.options, function (o) { return String(o.value); });\n  }";
+export interface SetValueScriptOptions {
+    /** `type` focuses the element first; `select` does not. */
+    focus: boolean;
+    /** `type --clear`: select() + write '' + input event before the real write. */
+    clear: boolean;
+    /** Existing contracts differ: `type` reports el.tagName as-is, `select` lower-cases it. */
+    lowerCaseTagName: boolean;
+    /** JS expression for the not-found error; `selector` is in scope. */
+    notFoundErrorExpr: string;
+    verifyTimeoutMs: number;
+}
+/**
+ * Shared script body for `type` and `select` value mode. Returns an arrow IIFE
+ * that resolves (via a Promise — the bridge awaits it) to a JSON string and
+ * never throws into the bridge.
+ *
+ * Sequence: snapshot `previousValue` → [focus] → [clear + input] → settle →
+ * re-resolve the target (the app may have re-mounted it) → snapshot `baseline`
+ * → native write → `applied` → refuse values the browser discarded or clamped
+ * back → input, change → verify. `reverted` means the re-read equals
+ * `baseline` or `previousValue`; comparing only against the pre-command value
+ * would let an app that accepted the clear (or changed the value on focus) but
+ * rejected the real write pass as `transformed`. A field the app empties after
+ * a non-empty write is a failure too ("cleared"): the intended value did not
+ * land whether the app rejected or consumed it.
+ */
+export declare function buildSetValueScript(selector: string, value: string, o: SetValueScriptOptions): string;
+/**
+ * Parses an interaction result from the bridge. dev_bridge.rs turns a thrown
+ * script into the string "ERROR: <message>", which JSON.parse would reject
+ * with an opaque SyntaxError — surface it as an actionable error instead.
+ */
+export declare function parseInteractResult<S extends z.ZodTypeAny>(raw: unknown, schema: S, command: string): z.infer<S>;

package/dist/commands/interact/shared.js

@@ -1,4 +1,4 @@
-import { addBridgeOptions } from '../shared.js';
+import { addBridgeOptions, parseIntArg } from '../shared.js';
 /**
  * Escapes backslashes and single quotes in CSS selectors for safe
  * embedding inside JS string literals wrapped in single quotes.
@@ -59,4 +59,269 @@ export function buildWaitAndFindScript(selector, waitMs) {
 export function addInteractOptions(cmd) {
     return addBridgeOptions(cmd).option('--json', 'Output result as JSON');
 }
+// === Value writing + verification (type, select) ===
+/**
+ * Default deadline for the post-write re-read. An accepted write resolves on
+ * the first (synchronous) check, so it costs nothing; only a rejected write
+ * waits out the whole deadline.
+ */
+export const DEFAULT_VERIFY_TIMEOUT_MS = 500;
+/**
+ * dev_bridge.rs answers 504 after 5 s and BridgeClient.eval aborts at 5 s;
+ * keep at least 1 s of slack for dispatch + IPC + HTTP.
+ */
+export const MAX_VERIFY_TIMEOUT_MS = 4000;
+/**
+ * Poll cadence after the synchronous first check. React commits
+ * transition-lane updates on a Scheduler macrotask, so a microtask/rAF
+ * re-read would be too early.
+ */
+export const VERIFY_INTERVAL_MS = 50;
+export function resolveVerifyTimeout(opts) {
+    const ms = opts?.verifyTimeoutMs ?? DEFAULT_VERIFY_TIMEOUT_MS;
+    if (!Number.isInteger(ms) || ms < 0 || ms > MAX_VERIFY_TIMEOUT_MS) {
+        throw new Error(`--verify-timeout must be an integer between 0 and ${MAX_VERIFY_TIMEOUT_MS} ms (the bridge aborts evals after 5000 ms)`);
+    }
+    return ms;
+}
+/** Adds --verify-timeout to a value-writing interaction command. */
+export function addVerifyOptions(cmd) {
+    return cmd.option('--verify-timeout <ms>', `Max time to wait for the written value to stick before reporting it reverted (max ${MAX_VERIFY_TIMEOUT_MS}, 0 = single check)`, parseIntArg, DEFAULT_VERIFY_TIMEOUT_MS);
+}
+/**
+ * JS snippet defining `__resolveValueWriter(node)`.
+ *
+ * React (react-dom's inputValueTracking) redefines `value` as an own accessor
+ * on every mounted <input>/<textarea> instance to remember what it wrote;
+ * assigning through that accessor makes the following input/change event a
+ * no-op for React (#10). Built-in form elements are therefore written through
+ * the prototype setter React itself captured. Custom elements are searched up
+ * their prototype chain (Lit/Stencil define accessors on the class prototype)
+ * and fall back to plain assignment for instance-defined or class-field
+ * `value`s. Anything else has no value setter and is refused instead of being
+ * silently given an expando property.
+ *
+ * The parameter is deliberately named `node` so generated scripts never
+ * contain the text `el.value =`.
+ */
+export const NATIVE_VALUE_WRITER_SNIPPET = `
+  function __resolveValueWriter(node) {
+    var tag = node.tagName;
+    var proto = tag === 'INPUT' ? HTMLInputElement.prototype
+      : tag === 'TEXTAREA' ? HTMLTextAreaElement.prototype
+      : tag === 'SELECT' ? HTMLSelectElement.prototype
+      : null;
+    if (proto) {
+      var d = Object.getOwnPropertyDescriptor(proto, 'value');
+      if (d && typeof d.set === 'function') return { kind: 'native', set: function (v) { d.set.call(node, v); } };
+      return { kind: 'assign', set: function (v) { node.value = v; } };
+    }
+    if (String(node.localName || '').indexOf('-') !== -1) {
+      var p = Object.getPrototypeOf(node);
+      while (p && p !== Object.prototype) {
+        var cd = Object.getOwnPropertyDescriptor(p, 'value');
+        if (cd && typeof cd.set === 'function') return { kind: 'custom', set: function (v) { cd.set.call(node, v); } };
+        p = Object.getPrototypeOf(p);
+      }
+      if ('value' in node) return { kind: 'assign', set: function (v) { node.value = v; } };
+    }
+    return null;
+  }`;
+/**
+ * JS snippet defining `__verify(read, expected, timeoutMs, intervalMs)`.
+ *
+ * The first read is synchronous: React restores a rejected controlled value
+ * inside dispatchEvent, so it is already visible. Later reads catch
+ * transition-lane commits and frameworks that apply values asynchronously.
+ * Resolves `{ ok, observed }` and never rejects. `read` is re-invoked on every
+ * tick so a re-mounted node is read instead of a stale reference.
+ */
+export const VERIFY_POLL_SNIPPET = `
+  function __verify(read, expected, timeoutMs, intervalMs) {
+    return new Promise(function (resolve) {
+      var deadline = Date.now() + timeoutMs;
+      function check() {
+        var observed;
+        try { observed = read(); } catch (e) { observed = undefined; }
+        if (observed === expected) { resolve({ ok: true, observed: observed }); return; }
+        if (Date.now() >= deadline) { resolve({ ok: false, observed: observed }); return; }
+        setTimeout(check, intervalMs);
+      }
+      check();
+    });
+  }`;
+/**
+ * JS snippet defining `__settle()` — resolves after two macrotasks. Used after
+ * focus()/--clear so that state the app changed in response (React flushes an
+ * onFocus setState on a microtask, an accepted clear commits synchronously, and
+ * a commit scheduled from the app's own zero-delay timer lands on a Scheduler
+ * task after the first macrotask) is visible before the pre-write baseline is
+ * read and the target node is re-resolved.
+ */
+export const SETTLE_SNIPPET = `
+  function __settle() {
+    return new Promise(function (resolve) {
+      setTimeout(function () { setTimeout(resolve, 0); }, 0);
+    });
+  }`;
+/** JS snippet defining `__selectOptionValues(node)` — option values of a <select>, [] otherwise. */
+export const SELECT_OPTIONS_SNIPPET = `
+  function __selectOptionValues(node) {
+    if (!node.options || typeof node.options.length !== 'number') return [];
+    return Array.prototype.map.call(node.options, function (o) { return String(o.value); });
+  }`;
+/**
+ * Shared script body for `type` and `select` value mode. Returns an arrow IIFE
+ * that resolves (via a Promise — the bridge awaits it) to a JSON string and
+ * never throws into the bridge.
+ *
+ * Sequence: snapshot `previousValue` → [focus] → [clear + input] → settle →
+ * re-resolve the target (the app may have re-mounted it) → snapshot `baseline`
+ * → native write → `applied` → refuse values the browser discarded or clamped
+ * back → input, change → verify. `reverted` means the re-read equals
+ * `baseline` or `previousValue`; comparing only against the pre-command value
+ * would let an app that accepted the clear (or changed the value on focus) but
+ * rejected the real write pass as `transformed`. A field the app empties after
+ * a non-empty write is a failure too ("cleared"): the intended value did not
+ * land whether the app rejected or consumed it.
+ */
+export function buildSetValueScript(selector, value, o) {
+    const escapedSelector = escapeSelector(selector);
+    const safeValue = JSON.stringify(value);
+    const tagExpr = o.lowerCaseTagName ? 'el.tagName.toLowerCase()' : 'el.tagName';
+    const focusBlock = o.focus
+        ? `
+    if (typeof el.focus === 'function') el.focus();`
+        : '';
+    const clearBlock = o.clear
+        ? `
+    if (typeof el.select === 'function') el.select();
+    writer.set('');
+    el.dispatchEvent(new Event('input', { bubbles: true }));`
+        : '';
+    return `(() => {${NATIVE_VALUE_WRITER_SNIPPET}${VERIFY_POLL_SNIPPET}${SETTLE_SNIPPET}${SELECT_OPTIONS_SNIPPET}
+  var selector = '${escapedSelector}';
+  var requested = ${safeValue};
+  var clearRan = ${o.clear ? 'true' : 'false'};
+  var fail = function (extra) { return JSON.stringify(Object.assign({ success: false, selector: selector }, extra)); };
+  function describe(node) {
+    var t = node.tagName.toLowerCase();
+    var it = t === 'input' ? String(node.type || 'text').toLowerCase() : '';
+    return '<' + t + (it ? ' type=' + it : '') + '>';
+  }
+  function unsupported(node) {
+    return { error: 'Unsupported element ' + describe(node) + ': no value setter', hint: 'Supported: <input>, <textarea>, <select>, and custom elements that expose a value property. For contenteditable regions use \`eval\`.' };
+  }
+  try {
+    var el = document.querySelector(selector);
+    if (!el) return fail({ error: ${o.notFoundErrorExpr} });
+    var tagName = ${tagExpr};
+    var inputType = el.tagName === 'INPUT' ? String(el.type || 'text').toLowerCase() : '';
+    if (inputType === 'checkbox' || inputType === 'radio') {
+      return fail({ tagName: tagName, error: 'Cannot set a text value on <input type=' + inputType + '>', hint: 'Use \`select <selector> --toggle\` to change its checked state.' });
+    }
+    if (inputType === 'file') {
+      return fail({ tagName: tagName, error: 'Cannot set the value of <input type=file>: browsers reject scripted file values' });
+    }
+    var writer = __resolveValueWriter(el);
+    if (!writer) return fail(Object.assign({ tagName: tagName }, unsupported(el)));
+    if (el.tagName === 'SELECT') {
+      var options = __selectOptionValues(el);
+      if (options.indexOf(requested) === -1) {
+        return fail({ tagName: tagName, requestedValue: requested, options: options.slice(0, 50), error: 'No <option> with value ' + JSON.stringify(requested), hint: 'Pass the option value attribute, not its label. Available values: ' + options.slice(0, 20).join(', ') });
+      }
+    }
+    var previousValue = String(el.value);${focusBlock}${clearBlock}
+    var base = { selector: selector, tagName: tagName, requestedValue: requested, previousValue: previousValue };
+    return __settle().then(function () {
+      var live = document.querySelector(selector);
+      if (!live) {
+        return fail(Object.assign({ error: 'Element left the document after focus/clear (removed or re-rendered without a matching selector); nothing was written', hint: 'The app re-rendered in response to focus or the clear. Re-query the DOM and retry, or target a stable selector.' }, base));
+      }
+      if (live !== el) {
+        el = live;
+        writer = __resolveValueWriter(el);
+        if (!writer) return fail(Object.assign({}, base, unsupported(el)));
+      }
+      var baseline = String(el.value);
+      writer.set(requested);
+      var applied = String(el.value);
+      if (writer.kind === 'native' && requested !== '' && applied === '') {
+        // Undo our own writes only: after --clear that is the pre-clear value;
+        // otherwise the value the field held right before the write (which an
+        // app may have changed on focus).
+        var restored = clearRan ? previousValue : baseline;
+        writer.set(restored);
+        if (clearRan) el.dispatchEvent(new Event('input', { bubbles: true }));
+        return fail(Object.assign({
+          value: restored,
+          error: 'Browser discarded the value: ' + describe(el) + ' sanitized ' + JSON.stringify(requested) + ' to ""',
+          hint: 'Use a value the control accepts (e.g. digits for type=number, YYYY-MM-DD for type=date). The previous value was restored' + (clearRan ? ' (the field had already been cleared, so an input event was dispatched for the restore).' : ' and no events were dispatched.')
+        }, base));
+      }
+      if (writer.kind === 'native' && requested !== baseline && applied === baseline) {
+        return fail(Object.assign({
+          value: baseline,
+          error: 'Browser did not take the value: ' + describe(el) + ' still reads ' + JSON.stringify(baseline) + ' after writing ' + JSON.stringify(requested),
+          hint: 'The control clamped or sanitized the value back onto its current value (e.g. min/max on type=range, the format of type=color). No events were dispatched.'
+        }, base));
+      }
+      // Built-in controls may legitimately normalize the value (newlines stripped, numbers canonicalized): verify against what the setter kept. Custom elements may reflect asynchronously: verify against the request.
+      var expected = writer.kind === 'native' ? applied : requested;
+      el.dispatchEvent(new Event('input', { bubbles: true }));
+      (document.querySelector(selector) || el).dispatchEvent(new Event('change', { bubbles: true }));
+      return __verify(function () {
+        var cur = document.querySelector(selector) || (el.isConnected ? el : null);
+        return cur ? String(cur.value) : null;
+      }, expected, ${o.verifyTimeoutMs}, ${VERIFY_INTERVAL_MS}).then(function (v) {
+        if (v.ok) {
+          return JSON.stringify(Object.assign({ success: true, value: v.observed, verified: true, verification: 'matched' }, base));
+        }
+        if (v.observed === null) {
+          return fail(Object.assign({ value: applied, verified: false, error: 'Element left the document after the write; the value could not be verified', hint: 'The app removed or re-rendered the element without a matching selector after the input/change events (navigation, a remount). Re-query the DOM to confirm the app state.' }, base));
+        }
+        var observed = v.observed === undefined ? '' : v.observed;
+        if (observed === baseline || observed === previousValue) {
+          return fail(Object.assign({
+            value: observed, verified: false, verification: 'reverted',
+            error: 'Value reverted: wrote ' + JSON.stringify(applied) + ' but the element reads ' + JSON.stringify(observed) + ' again after ${o.verifyTimeoutMs}ms',
+            hint: 'The app restored the previous value: a controlled input whose change handler did not accept the write (app-side validation), or one that normalized it to the value already present. Check the app state binding; if the app applies values asynchronously, raise --verify-timeout.'
+          }, base));
+        }
+        if (requested !== '' && observed === '') {
+          return fail(Object.assign({
+            value: observed, verified: false, verification: 'reverted',
+            error: 'Value cleared: wrote ' + JSON.stringify(applied) + ' but the element is empty after ${o.verifyTimeoutMs}ms',
+            hint: 'The app emptied the field after the write: it rejected the value (validation reset) or consumed it (e.g. a tag/chip input). Check the app state to tell which.'
+          }, base));
+        }
+        return JSON.stringify(Object.assign({ success: true, value: observed, verified: false, verification: 'transformed' }, base));
+      });
+    }).catch(function (e) {
+      return fail({ error: 'Script error: ' + (e && e.message ? e.message : String(e)) });
+    });
+  } catch (e) {
+    return fail({ error: 'Script error: ' + (e && e.message ? e.message : String(e)) });
+  }
+})()`;
+}
+/**
+ * Parses an interaction result from the bridge. dev_bridge.rs turns a thrown
+ * script into the string "ERROR: <message>", which JSON.parse would reject
+ * with an opaque SyntaxError — surface it as an actionable error instead.
+ */
+export function parseInteractResult(raw, schema, command) {
+    const text = String(raw ?? '');
+    if (text.startsWith('ERROR: ')) {
+        throw new Error(`${command} failed: the bridge script threw: ${text.slice('ERROR: '.length)}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`${command} failed: bridge returned a non-JSON result: ${text.slice(0, 200)}`);
+    }
+    return schema.parse(parsed);
+}
 //# sourceMappingURL=shared.js.map

package/dist/commands/interact/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/interact/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO;QACL,UAAU;QACV,wCAAwC,OAAO,KAAK;QACpD,qDAAqD;QACrD,6DAA6D;QAC7D,+HAA+H;QAC/H,MAAM;KACP,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,MAAc;IACrE,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO;QACL,4BAA4B;QAC5B,mCAAmC,MAAM,GAAG;QAC5C,qBAAqB;QACrB,0CAA0C,OAAO,KAAK;QACtD,eAAe;QACf,iEAAiE;QACjE,qIAAqI;QACrI,eAAe;QACf,OAAO;QACP,mCAAmC;QACnC,kDAAkD;QAClD,eAAe;QACf,OAAO;QACP,4BAA4B;QAC5B,KAAK;QACL,WAAW;QACX,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;AACzE,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/interact/shared.ts"],"names":[],"mappings":"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"}

package/dist/commands/interact/type.d.ts

@@ -1,6 +1,14 @@
 import { Command } from 'commander';
+import type { VerifyOptions } from './shared.js';
 /**
- * Build a JS IIFE script that types text into the element matched by selector.
+ * Build a JS IIFE that types text into the element matched by selector.
+ *
+ * Both the --clear write and the final write go through the element's native
+ * prototype value setter (see NATIVE_VALUE_WRITER_SNIPPET) so React-style
+ * instance trackers see the following input/change events as real changes
+ * (#10). The script then re-reads the value (synchronously, then polled up to
+ * verifyTimeoutMs) and reports `reverted` when the app restored the previous
+ * value. Returns a Promise-resolving IIFE; the bridge awaits it.
  */
-export declare function buildTypeScript(selector: string, text: string, clear: boolean): string;
+export declare function buildTypeScript(selector: string, text: string, clear: boolean, options?: VerifyOptions): string;
 export declare function registerType(program: Command): void;

package/dist/commands/interact/type.js

@@ -1,31 +1,25 @@
 import { Command } from 'commander';
 import { resolveBridge } from '../shared.js';
-import { addInteractOptions, escapeSelector } from './shared.js';
+import { addInteractOptions, addVerifyOptions, buildSetValueScript, parseInteractResult, resolveVerifyTimeout, } from './shared.js';
 import { TypeResultSchema } from '../../schemas/interact.js';
 /**
- * Build a JS IIFE script that types text into the element matched by selector.
+ * Build a JS IIFE that types text into the element matched by selector.
+ *
+ * Both the --clear write and the final write go through the element's native
+ * prototype value setter (see NATIVE_VALUE_WRITER_SNIPPET) so React-style
+ * instance trackers see the following input/change events as real changes
+ * (#10). The script then re-reads the value (synchronously, then polled up to
+ * verifyTimeoutMs) and reports `reverted` when the app restored the previous
+ * value. Returns a Promise-resolving IIFE; the bridge awaits it.
  */
-export function buildTypeScript(selector, text, clear) {
-    const escapedSelector = escapeSelector(selector);
-    const safeText = JSON.stringify(text);
-    const clearBlock = clear
-        ? `
-    el.focus();
-    el.select();
-    el.value = '';
-    el.dispatchEvent(new Event('input', { bubbles: true }));`
-        : '';
-    return `(() => {
-  var el = document.querySelector('${escapedSelector}');
-  if (!el) {
-    return JSON.stringify({ success: false, selector: '${escapedSelector}', error: 'Element not found' });
-  }
-  el.focus();${clearBlock}
-  el.value = ${safeText};
-  el.dispatchEvent(new Event('input', { bubbles: true }));
-  el.dispatchEvent(new Event('change', { bubbles: true }));
-  return JSON.stringify({ success: true, selector: '${escapedSelector}', tagName: el.tagName, value: el.value });
-})()`;
+export function buildTypeScript(selector, text, clear, options) {
+    return buildSetValueScript(selector, text, {
+        focus: true,
+        clear,
+        lowerCaseTagName: false,
+        notFoundErrorExpr: `'Element not found'`,
+        verifyTimeoutMs: resolveVerifyTimeout(options),
+    });
 }
 export function registerType(program) {
     const cmd = new Command('type')
@@ -37,22 +31,43 @@ export function registerType(program) {
 Examples:
   $ tauri-agent-tools type "#username" "admin"
   $ tauri-agent-tools type "input[name=email]" "user@example.com" --clear
-  $ tauri-agent-tools type ".search-input" "hello world" --json`);
+  $ tauri-agent-tools type ".search-input" "hello world" --json
+  $ tauri-agent-tools type "#q" "term" --verify-timeout 2000    # app applies the value asynchronously
+
+The value is written through the element's native prototype setter followed by
+bubbling input + change events, so React/Vue/Svelte controlled inputs see it.
+The element is then re-read; the command fails with "Value reverted" when the
+app restored the previous value (a controlled input that rejected the write).`);
     addInteractOptions(cmd);
+    addVerifyOptions(cmd);
     cmd.action(async (selector, text, opts) => {
+        // Build first: an invalid --verify-timeout fails before any bridge call.
+        const script = buildTypeScript(selector, text, !!opts.clear, { verifyTimeoutMs: opts.verifyTimeout });
         const bridge = await resolveBridge(opts);
-        const script = buildTypeScript(selector, text, !!opts.clear);
         const raw = await bridge.eval(script);
-        const result = TypeResultSchema.parse(JSON.parse(String(raw)));
+        const result = parseInteractResult(raw, TypeResultSchema, 'Type');
         if (!result.success) {
-            throw new Error(`Type failed: ${result.error} (selector: ${result.selector})`);
+            // With --json the failure object (verification, hint, options, …) goes to
+            // stdout so scripts can branch on it; the thrown error still reaches
+            // stderr and sets exit code 1.
+            if (opts.json)
+                console.log(JSON.stringify(result, null, 2));
+            const hint = result.hint ? `\n  hint: ${result.hint}` : '';
+            throw new Error(`Type failed: ${result.error} (selector: ${result.selector})${hint}`);
         }
         if (opts.json) {
             console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const tag = (result.tagName ?? 'element').toLowerCase();
+        let note = '';
+        if (result.verification === 'transformed') {
+            note = ` (app transformed the requested value ${JSON.stringify(result.requestedValue)})`;
         }
-        else {
-            console.log(`Typed into ${(result.tagName ?? 'element').toLowerCase()}: "${result.value}"`);
+        else if (result.requestedValue !== undefined && result.value !== result.requestedValue) {
+            note = ` (browser normalized the requested value ${JSON.stringify(result.requestedValue)})`;
         }
+        console.log(`Typed into ${tag}: "${result.value}"${note}`);
     });
     program.addCommand(cmd);
 }

package/dist/commands/interact/type.js.map

@@ -1 +1 @@
-{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/commands/interact/type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY,EAAE,KAAc;IAC5E,MAAM,eAAe,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,KAAK;QACtB,CAAC,CAAC;;;;6DAIuD;QACzD,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;qCAC4B,eAAe;;yDAEK,eAAe;;eAEzD,UAAU;eACV,QAAQ;;;sDAG+B,eAAe;KAChE,CAAC;AACN,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SAC5B,WAAW,CAAC,kDAAkD,CAAC;SAC/D,QAAQ,CAAC,YAAY,EAAE,oCAAoC,CAAC;SAC5D,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACnD,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;SAClD,WAAW,CAAC,OAAO,EAAE;;;;gEAIsC,CAAC,CAAC;IAEhE,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,IAAY,EAAE,IAAsD,EAAE,EAAE;QAC1G,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAE/D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gBAAgB,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../src/commands/interact/type.ts"],"names":[],"mappings":"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"}

package/dist/schemas/interact.d.ts

@@ -37,25 +37,56 @@ export declare const ClickResultSchema: z.ZodObject<{
     tagName?: string | undefined;
 }>;
 export type ClickResult = z.infer<typeof ClickResultSchema>;
+/**
+ * Outcome of the post-write re-read performed by `type` and `select`:
+ * - `matched`: the element still reports the value the setter applied.
+ * - `transformed`: the app replaced it with a different value (mask, formatter) — a soft success.
+ * - `reverted`: the element reads its pre-write value again — the app rejected the write (failure).
+ */
+export declare const WriteVerificationSchema: z.ZodEnum<["matched", "transformed", "reverted"]>;
+export type WriteVerification = z.infer<typeof WriteVerificationSchema>;
 export declare const TypeResultSchema: z.ZodObject<{
     success: z.ZodBoolean;
     selector: z.ZodOptional<z.ZodString>;
     tagName: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
 } & {
+    /** The value as requested on the command line. */
+    requestedValue: z.ZodOptional<z.ZodString>;
+    /** `el.value` before the write. */
+    previousValue: z.ZodOptional<z.ZodString>;
+    /** True when the re-read equals the value the setter applied. */
+    verified: z.ZodOptional<z.ZodBoolean>;
+    verification: z.ZodOptional<z.ZodEnum<["matched", "transformed", "reverted"]>>;
+    /** Available `<option>` values when a `<select>` had no match. */
+    options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Actionable guidance accompanying a failure. */
+    hint: z.ZodOptional<z.ZodString>;
     value: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     success: boolean;
     value?: string | undefined;
+    options?: string[] | undefined;
     error?: string | undefined;
     selector?: string | undefined;
+    hint?: string | undefined;
     tagName?: string | undefined;
+    requestedValue?: string | undefined;
+    previousValue?: string | undefined;
+    verified?: boolean | undefined;
+    verification?: "matched" | "transformed" | "reverted" | undefined;
 }, {
     success: boolean;
     value?: string | undefined;
+    options?: string[] | undefined;
     error?: string | undefined;
     selector?: string | undefined;
+    hint?: string | undefined;
     tagName?: string | undefined;
+    requestedValue?: string | undefined;
+    previousValue?: string | undefined;
+    verified?: boolean | undefined;
+    verification?: "matched" | "transformed" | "reverted" | undefined;
 }>;
 export type TypeResult = z.infer<typeof TypeResultSchema>;
 export declare const ScrollResultSchema: z.ZodObject<{
@@ -81,22 +112,49 @@ export declare const SelectResultSchema: z.ZodObject<{
     tagName: z.ZodOptional<z.ZodString>;
     error: z.ZodOptional<z.ZodString>;
 } & {
+    /** The value as requested on the command line. */
+    requestedValue: z.ZodOptional<z.ZodString>;
+    /** `el.value` before the write. */
+    previousValue: z.ZodOptional<z.ZodString>;
+    /** True when the re-read equals the value the setter applied. */
+    verified: z.ZodOptional<z.ZodBoolean>;
+    verification: z.ZodOptional<z.ZodEnum<["matched", "transformed", "reverted"]>>;
+    /** Available `<option>` values when a `<select>` had no match. */
+    options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Actionable guidance accompanying a failure. */
+    hint: z.ZodOptional<z.ZodString>;
     value: z.ZodOptional<z.ZodString>;
     checked: z.ZodOptional<z.ZodBoolean>;
+    /** `checked` before a `--toggle`. */
+    previousChecked: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     success: boolean;
     value?: string | undefined;
+    options?: string[] | undefined;
     error?: string | undefined;
     selector?: string | undefined;
+    hint?: string | undefined;
     tagName?: string | undefined;
+    requestedValue?: string | undefined;
+    previousValue?: string | undefined;
+    verified?: boolean | undefined;
+    verification?: "matched" | "transformed" | "reverted" | undefined;
     checked?: boolean | undefined;
+    previousChecked?: boolean | undefined;
 }, {
     success: boolean;
     value?: string | undefined;
+    options?: string[] | undefined;
     error?: string | undefined;
     selector?: string | undefined;
+    hint?: string | undefined;
     tagName?: string | undefined;
+    requestedValue?: string | undefined;
+    previousValue?: string | undefined;
+    verified?: boolean | undefined;
+    verification?: "matched" | "transformed" | "reverted" | undefined;
     checked?: boolean | undefined;
+    previousChecked?: boolean | undefined;
 }>;
 export type SelectResult = z.infer<typeof SelectResultSchema>;
 export declare const InvokeResultSchema: z.ZodObject<{

package/dist/schemas/interact.js

@@ -9,8 +9,30 @@ export const InteractionResultSchema = z.object({
 export const ClickResultSchema = InteractionResultSchema.extend({
     text: z.string().optional(),
 });
+/**
+ * Outcome of the post-write re-read performed by `type` and `select`:
+ * - `matched`: the element still reports the value the setter applied.
+ * - `transformed`: the app replaced it with a different value (mask, formatter) — a soft success.
+ * - `reverted`: the element reads its pre-write value again — the app rejected the write (failure).
+ */
+export const WriteVerificationSchema = z.enum(['matched', 'transformed', 'reverted']);
+/** Optional-only fields shared by the value-writing commands. */
+const WriteResultFields = {
+    /** The value as requested on the command line. */
+    requestedValue: z.string().optional(),
+    /** `el.value` before the write. */
+    previousValue: z.string().optional(),
+    /** True when the re-read equals the value the setter applied. */
+    verified: z.boolean().optional(),
+    verification: WriteVerificationSchema.optional(),
+    /** Available `<option>` values when a `<select>` had no match. */
+    options: z.array(z.string()).optional(),
+    /** Actionable guidance accompanying a failure. */
+    hint: z.string().optional(),
+};
 export const TypeResultSchema = InteractionResultSchema.extend({
     value: z.string().optional(),
+    ...WriteResultFields,
 });
 export const ScrollResultSchema = z.object({
     success: z.boolean(),
@@ -21,6 +43,9 @@ export const ScrollResultSchema = z.object({
 export const SelectResultSchema = InteractionResultSchema.extend({
     value: z.string().optional(),
     checked: z.boolean().optional(),
+    /** `checked` before a `--toggle`. */
+    previousChecked: z.boolean().optional(),
+    ...WriteResultFields,
 });
 export const InvokeResultSchema = z.object({
     success: z.boolean(),

package/dist/schemas/interact.js.map

@@ -1 +1 @@
-{"version":3,"file":"interact.js","sourceRoot":"","sources":["../../src/schemas/interact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8BAA8B;AAE9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}
+{"version":3,"file":"interact.js","sourceRoot":"","sources":["../../src/schemas/interact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8BAA8B;AAE9B,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAGH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;AAGtF,iEAAiE;AACjE,MAAM,iBAAiB,GAAG;IACxB,kDAAkD;IAClD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,mCAAmC;IACnC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,iEAAiE;IACjE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IAChD,kEAAkE;IAClE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,kDAAkD;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC7D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,GAAG,iBAAiB;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC/D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,qCAAqC;IACrC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,GAAG,iBAAiB;CACrB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-agent-tools",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Agent-driven inspection toolkit for Tauri desktop apps",
   "type": "module",
   "bin": {
@@ -55,6 +55,9 @@
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^3.2.4",
     "eslint": "^9.0.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
     "typescript": "^5.8.0",
     "typescript-eslint": "^8.0.0",
     "vitest": "^3.1.0"