tauri-agent-tools 0.9.0 → 0.9.2

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/commands/screenshot.js

@@ -1,7 +1,7 @@
 import { writeFile } from 'node:fs/promises';
 import { Command } from 'commander';
 import { ImageFormatSchema } from '../schemas/commands.js';
-import { addBridgeOptions, resolveBridge, parseIntArg } from './shared.js';
+import { addBridgeOptions, resolveBridge, resolveWindowId, parseIntArg } from './shared.js';
 import { computeCropRect, cropImage, resizeImage } from '../util/image.js';
 function autoOutputPath(format) {
     const ts = new Date().toISOString().replace(/[:.]/g, '-');
@@ -11,7 +11,8 @@ export function registerScreenshot(program, getAdapter) {
     const cmd = new Command('screenshot')
         .description('Capture a screenshot of a window or DOM element')
         .option('-s, --selector <css>', 'CSS selector — screenshot just this element (requires bridge)')
-        .option('-t, --title <regex>', 'Window title to match (default: auto-discover from bridge)')
+        .option('-t, --title <regex>', 'Window title to match — regex; quote titles with spaces (default: auto-discover from bridge)')
+        .option('-w, --window-id <id>', 'Platform window id (from list-windows) — overrides --title')
         .option('-o, --output <path>', 'Output file path (default: auto-named)')
         .option('--format <fmt>', 'Output format: png or jpg', 'png')
         .option('--max-width <number>', 'Resize to max width', parseIntArg)
@@ -19,6 +20,7 @@ export function registerScreenshot(program, getAdapter) {
         .addHelpText('after', `
 Examples:
   $ tauri-agent-tools screenshot --title "My App"
+  $ tauri-agent-tools screenshot --window-id 12345 -o win.png   # id from list-windows, no bridge needed
   $ tauri-agent-tools screenshot --selector ".sidebar" --output sidebar.png
   $ tauri-agent-tools screenshot --selector "#login" --format jpg --json`);
     addBridgeOptions(cmd);
@@ -30,6 +32,7 @@ Examples:
         const format = formatResult.data;
         const adapter = await getAdapter();
         let buffer;
+        let windowId;
         if (opts.selector) {
             // DOM-targeted pixel capture — the core feature
             const bridge = await resolveBridge(opts);
@@ -38,18 +41,7 @@ Examples:
                 throw new Error(`Element not found: ${opts.selector}`);
             }
             const viewport = await bridge.getViewportSize();
-            // Find window
-            let windowId;
-            if (opts.title) {
-                windowId = await adapter.findWindow(opts.title);
-            }
-            else {
-                const title = await bridge.getDocumentTitle();
-                if (!title) {
-                    throw new Error('Could not get window title from bridge. Use --title to specify.');
-                }
-                windowId = await adapter.findWindow(title);
-            }
+            windowId = await resolveWindowId(adapter, bridge, opts);
             const windowGeom = await adapter.getWindowGeometry(windowId);
             // Capture full window
             buffer = await adapter.captureWindow(windowId, format);
@@ -62,10 +54,15 @@ Examples:
         }
         else {
             // Full window fallback — no bridge needed
-            if (!opts.title) {
-                throw new Error('Either --selector (with bridge) or --title is required');
+            if (opts.windowId) {
+                windowId = opts.windowId;
+            }
+            else if (opts.title) {
+                windowId = await adapter.findWindow(opts.title);
+            }
+            else {
+                throw new Error('Either --selector (with bridge), --title, or --window-id is required');
             }
-            const windowId = await adapter.findWindow(opts.title);
             buffer = await adapter.captureWindow(windowId, format);
         }
         if (opts.maxWidth) {
@@ -80,6 +77,7 @@ Examples:
                 size: buffer.length,
                 selector: opts.selector ?? null,
                 windowTitle: opts.title ?? null,
+                windowId,
             }, null, 2));
         }
         else {

package/dist/commands/screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/commands/screenshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../src/commands/screenshot.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared.d.ts

@@ -1,6 +1,7 @@
 import type { Command } from 'commander';
 import type { z } from 'zod';
 import type { BridgeConfig } from '../schemas/bridge.js';
+import type { PlatformAdapter } from '../types.js';
 import { BridgeClient } from '../bridge/client.js';
 /**
  * Options parsed from the bridge-related CLI flags.
@@ -17,6 +18,22 @@ export interface BridgeOpts {
      */
     strict?: boolean;
 }
+/**
+ * Options parsed from the window-targeting CLI flags.
+ */
+export interface WindowTargetOpts {
+    windowId?: string;
+    title?: string;
+}
+/**
+ * Resolve the platform window id for a window-consuming command.
+ * Precedence: --window-id (used verbatim) > --title regex > bridge document.title.
+ *
+ * The id is not validated here: its format is adapter-specific (X11/macOS/Sway
+ * numeric, Hyprland hex 0x…), and the adapters that interpolate ids into shell
+ * commands already guard with validateWindowId().
+ */
+export declare function resolveWindowId(adapter: PlatformAdapter, bridge: BridgeClient, opts: WindowTargetOpts): Promise<string>;
 /**
  * Parse a value with a Zod enum schema, throwing a human-readable error on failure.
  * Replaces raw `.parse()` calls that would surface cryptic ZodError messages.

package/dist/commands/shared.js

@@ -1,5 +1,24 @@
 import { BridgeClient } from '../bridge/client.js';
 import { discoverBridge, discoverBridgesByPid } from '../bridge/tokenDiscovery.js';
+/**
+ * Resolve the platform window id for a window-consuming command.
+ * Precedence: --window-id (used verbatim) > --title regex > bridge document.title.
+ *
+ * The id is not validated here: its format is adapter-specific (X11/macOS/Sway
+ * numeric, Hyprland hex 0x…), and the adapters that interpolate ids into shell
+ * commands already guard with validateWindowId().
+ */
+export async function resolveWindowId(adapter, bridge, opts) {
+    if (opts.windowId)
+        return opts.windowId;
+    if (opts.title)
+        return adapter.findWindow(opts.title);
+    const docTitle = await bridge.getDocumentTitle();
+    if (!docTitle) {
+        throw new Error('Could not get window title from bridge. Use --title or --window-id.');
+    }
+    return adapter.findWindow(docTitle);
+}
 /**
  * Parse a value with a Zod enum schema, throwing a human-readable error on failure.
  * Replaces raw `.parse()` calls that would surface cryptic ZodError messages.

package/dist/commands/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/commands/shared.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AA0BnF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAwB,EACxB,MAAoB,EACpB,IAAsB;IAEtB,IAAI,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACxC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;IACjD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CACvB,MAAoB,EACpB,KAAa,EACb,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,KAAK,qBAAqB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,GAAG;SACP,MAAM,CAAC,iBAAiB,EAAE,wCAAwC,EAAE,WAAW,CAAC;SAChF,MAAM,CAAC,kBAAkB,EAAE,yCAAyC,CAAC;SACrE,MAAM,CAAC,gBAAgB,EAAE,2CAA2C,EAAE,WAAW,CAAC;SAClF,MAAM,CAAC,wBAAwB,EAAE,qCAAqC,CAAC;SACvE,MAAM,CACL,UAAU,EACV,6EAA6E,CAC9E,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,IAAY,EACZ,IAA0B;IAE1B,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,OAAuB;IAC3E,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,8BAA8B,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,OAAO,CACL,GAAG,IAAI,0CAA0C,CAAC,IAAI;QACtD,6EAA6E;QAC7E,gDAAgD,CACjD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAgB;IAC3D,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3E,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7E,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;IACvF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAgB;IAClD,IAAI,MAAoB,CAAC;IAEzB,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5B,iDAAiD;QACjD,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAClD,CAAC;SAAM,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAClC,yBAAyB;QACzB,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjC,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,GAAG,CAAC;gBACb,CAAC,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBACjE,CAAC,CAAC,2BAA2B,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,GAAG,MAAM,OAAO,EAAE,CACnD,CAAC;QACJ,CAAC;QACD,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;SACjC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,wBAAwB;QACxB,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,4BAA4B;gBAC1B,mDAAmD;gBACnD,0CAA0C,CAC7C,CAAC;QACJ,CAAC;QACD,MAAM,GAAG;YACP,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI;YAClC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;AACpD,CAAC"}

package/dist/commands/snapshot.js

@@ -1,6 +1,6 @@
 import { writeFile } from 'node:fs/promises';
 import { Command } from 'commander';
-import { addBridgeOptions, resolveBridge, parseIntArg } from './shared.js';
+import { addBridgeOptions, resolveBridge, resolveWindowId, parseIntArg } from './shared.js';
 import { buildSerializerScript } from './dom.js';
 import { computeCropRect, cropImage } from '../util/image.js';
 import { DomNodeSchema } from '../schemas/dom.js';
@@ -20,20 +20,13 @@ const STORAGE_SCRIPT = `(() => {
   var session = Object.keys(sessionStorage).map(function(k) { return { key: k, value: sessionStorage.getItem(k) }; });
   return JSON.stringify({ localStorage: local, sessionStorage: session });
 })()`;
-async function resolveWindowId(adapter, bridge, title) {
-    if (title)
-        return adapter.findWindow(title);
-    const docTitle = await bridge.getDocumentTitle();
-    if (!docTitle)
-        throw new Error('Could not get window title. Use --title.');
-    return adapter.findWindow(docTitle);
-}
 export function registerSnapshot(program, getAdapter) {
     const cmd = new Command('snapshot')
         .description('Capture screenshot + DOM + page state + storage in one shot')
         .requiredOption('-o, --output <prefix>', 'Output path prefix (e.g. /tmp/debug)')
         .option('-s, --selector <css>', 'CSS selector to screenshot (full window if omitted)')
-        .option('-t, --title <regex>', 'Window title to match (default: auto-discover)')
+        .option('-t, --title <regex>', 'Window title to match — regex; quote titles with spaces (default: auto-discover)')
+        .option('-w, --window-id <id>', 'Platform window id (from list-windows) — overrides --title')
         .option('--dom-depth <number>', 'DOM tree depth', parseIntArg, 3)
         .option('--eval <js>', 'Additional JS to eval and save')
         .option('--json', 'Output structured manifest');
@@ -46,7 +39,7 @@ export function registerSnapshot(program, getAdapter) {
         const files = {};
         // 1. Screenshot
         try {
-            const windowId = await resolveWindowId(adapter, bridge, opts.title);
+            const windowId = await resolveWindowId(adapter, bridge, opts);
             let buffer;
             if (opts.selector) {
                 const elementRect = await bridge.getElementRect(opts.selector);