@swmansion/argent 0.32.1-next.0 → 0.32.1-next.10

package/dist/tool-args.generated.d.ts

@@ -10,11 +10,11 @@ export interface ArgentToolArgs {
         minStableMs?: number;
     };
     "await-ui-element": {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, HarmonyOS id, or Chromium id). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** What to wait for. `exists`: selector is anywhere in the tree. `visible`: selector is present with a non-zero on-screen frame. `hidden`: selector is absent or zero-area. `text`: the first visible match in reading order (topmost), falling back to the first match overall if none is visible, contains (or, with textMatch `equals`, exactly matches) expectedText. If a loose selector hits several elements, only that one is checked, so narrow it to target the intended element. */
+        /** What to wait for. `exists`: the selector matches an element anywhere in the tree. `visible`: it matches one with a non-zero on-screen frame. `hidden`: it matches nothing, or only a zero-area element (e.g. a spinner that went away). `text`: the first visible match in reading order (topmost, then leftmost; the first match overall if none is visible) contains expectedText, or equals it with textMatch `equals`. Only that match is checked, so if a loose selector hits several elements, narrow it to the one holding the text. */
         condition: "exists" | "visible" | "hidden" | "text";
-        /** Element to match (text / identifier / role). */
+        /** Element to match. Give at least one field; every given field must match. */
         selector: {
             /** Case-insensitive substring of the element's visible label or value. */
             text?: string;
@@ -23,11 +23,11 @@ export interface ArgentToolArgs {
             /** Case-insensitive substring of the element's role (e.g. AXButton, button, TextView). */
             role?: string;
         };
-        /** For condition `text`: the string the first visible matched element (topmost in reading order; the first match overall if none is visible) must contain (default) or equal (see `textMatch`). Case-insensitive. */
+        /** Required for condition `text`: the string the checked match must contain or equal (see `textMatch`). */
         expectedText?: string;
         /** For condition `text`: how expectedText is compared. `contains` (default) is a case-insensitive substring; `equals` is a case-insensitive full-string match. */
         textMatch?: "contains" | "equals";
-        /** Optional iOS app bundle id, passed to the describe fallback (see `describe`). Ignored on every other platform, including physical iOS. */
+        /** iOS app bundle id, passed to the describe fallback (see `describe`). Ignored on every other platform, including physical iOS. */
         bundleId?: string;
         /** Max time to wait for the condition before giving up (default 5000). */
         timeoutMs?: number;
@@ -39,25 +39,25 @@ export interface ArgentToolArgs {
         timeoutSeconds?: number;
     };
     "boot-device": {
-        /** iOS: simulator UDID to boot (from `list-devices`). Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */
+        /** iOS: simulator UDID to boot (from `list-devices`). */
         udid?: string;
-        /** Android: AVD name to launch a new emulator from (from `list-devices` → `avds[].name`). Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */
+        /** Android: AVD name to launch a new emulator from (from `list-devices` → `avds[].name`). */
         avdName?: string;
-        /** Vega (Fire TV): VVD image to boot: the `vvdImage` of a Vega device from `list-devices` (e.g. `tv`). Starts the single SDK-managed Vega Virtual Device. Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */
+        /** Vega (Fire TV): VVD image to boot: the `vvdImage` of a Vega device from `list-devices` (e.g. `tv`). */
         vvdImage?: string;
-        /** HarmonyOS: emulator instance to start: the `name` of a `kind: "emulator"` device from `list-devices` (e.g. `Phone_1`); the `harmony-emulator-<name>` id that entry reports as its `udid` is accepted too. Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */
+        /** HarmonyOS: emulator instance to start: the `name` of a `kind: "emulator"` device from `list-devices` (e.g. `Phone_1`); the `harmony-emulator-<name>` id that entry reports as its `udid` is accepted too. */
         harmonyInstance?: string;
-        /** Android/Vega/HarmonyOS: overall budget for the boot sequence. Default 480000 (8 min) on Android, 120000 (2 min) on Vega, 180000 (3 min) on HarmonyOS, where with `force` it spans the shutdown as well as the boot. Clamped to [30s, 15min]. Ignored on iOS. */
+        /** Android/Vega/HarmonyOS: overall budget for the boot sequence. Default 480000 (8 min) on Android, 120000 (2 min) on Vega, 180000 (3 min) on HarmonyOS, where with `force` it spans the shutdown as well as the boot. */
         bootTimeoutMs?: number;
-        /** Shut down and re-boot the device even if already running. On HarmonyOS it is also what ties an already-running instance to the `hdc` connect key it registered under, since the emulator manager never reports one: without it the instance is left alone and the payload names the instance rather than a key (`list-devices` lists the keys, but not which instance each belongs to). Ignored for Electron, which always spawns a fresh process. */
+        /** Shut down and re-boot the device even if already running. On HarmonyOS it is also what ties an already-running instance to its `hdc` connect key: without it the instance is left alone and its key stays unresolved (`list-devices` lists the keys, but not which instance each belongs to). Ignored for Electron, which always spawns a fresh process. */
         force?: boolean;
-        /** Android only: boot the emulator with audio output enabled. Defaults to false: argent boots emulators MUTED so several agent-driven devices don't all play sound on the host machine; pass `true` when the task involves playing, hearing, or testing audio. Takes effect at boot: if the emulator is already running muted, add `force: true` to reboot it with sound. A boot snapshot saved in the other audio mode can't be reused, so the first boot after toggling is a slower cold boot. The `boot-sound` argent flag flips this default to true. Ignored on iOS/Vega/HarmonyOS/Electron, which argent never mutes. */
+        /** Android only (argent never mutes other platforms): boot the emulator with audio output enabled. Defaults to false, so several agent-driven emulators don't all play sound on the host; pass `true` when the task involves playing, hearing, or testing audio. Takes effect at boot: if the emulator is already running muted, add `force: true`. The first boot after toggling is a slower cold boot (the snapshot was saved in the other audio mode). The `boot-sound` argent flag flips this default to true. */
         sound?: boolean;
         /** Android on a macOS host only: boot the emulator with guest Vulkan. Defaults to false: guest Vulkan crashes Chrome's GPU process, which breaks Chrome and Custom Tab sign-in flows. Without it apps find no Vulkan device, although the guest still lists the Vulkan features, so a Vulkan-only renderer such as WebGPU (react-native-wgpu) draws nothing; pass `true` to test one. Takes effect at boot: an emulator already running in the other mode is reused with a `note`, and `force: true` reboots it. A boot snapshot saved in the other mode can't be reused, so the first boot after toggling is a slower cold boot. The `ARGENT_EMULATOR_GUEST_VULKAN` env var flips this default to true. Ignored on other hosts and platforms. */
         guestVulkan?: boolean;
-        /** iOS only: boot the simulator core WITHOUT opening its GUI window (Simulator.app, or Device Hub on Xcode 27+). The device still streams via simulator-server; used by Argent Lens. Set the `ARGENT_SIMULATOR_NO_WINDOW` env var (1/true/yes) to force this host-wide without passing the flag per call (the iOS analog of `ARGENT_EMULATOR_NO_WINDOW`). Ignored on Android/Vega/HarmonyOS/Electron, which have no equivalent GUI step. */
+        /** iOS only: boot the simulator core WITHOUT opening its GUI window (Simulator.app, or Device Hub on Xcode 27+). The device still streams via simulator-server. The `ARGENT_SIMULATOR_NO_WINDOW` env var (1/true/yes) forces this host-wide. */
         headless?: boolean;
-        /** Electron: path to the Electron app to launch. Either a packaged .app bundle / executable, or a project directory whose package.json points the Electron binary at the entry script. Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */
+        /** Electron: path to the Electron app to launch. Either a packaged .app bundle / executable, or a project directory whose package.json points the Electron binary at the entry script. */
         electronAppPath?: string;
         /** Electron-only: CDP remote-debugging port to expose. Defaults to a free port; the resulting device id is `chromium-cdp-<port>`. */
         electronPort?: number;
@@ -73,15 +73,15 @@ export interface ArgentToolArgs {
     "chromium-cookies": {
         /** Chromium device id from `list-devices` (e.g. `chromium-cdp-9222`). */
         udid: string;
-        /** get: read cookies. set: create/update a cookie. delete: remove a named cookie. clear: remove all browser cookies. */
+        /** get: read cookies. set: create/update a cookie. delete: remove matching cookies. clear: remove ALL browser cookies. */
         action: "get" | "set" | "delete" | "clear";
-        /** set/delete: cookie name. */
+        /** Cookie name. */
         name?: string;
-        /** set: cookie value. */
+        /** Cookie value. */
         value?: string;
-        /** get: restrict to these URLs (defaults to the active page). set/delete: scope the cookie by URL. */
+        /** get: restrict to this URL (defaults to the active page). set/delete: scope the cookie by URL. */
         url?: string;
-        /** set/delete: scope the cookie by domain (alt to url). */
+        /** set/delete: scope the cookie by domain. */
         domain?: string;
         /** set/delete: cookie path (default /). */
         path?: string;
@@ -97,21 +97,21 @@ export interface ArgentToolArgs {
     "chromium-storage": {
         /** Chromium device id from `list-devices` (e.g. `chromium-cdp-9222`). */
         udid: string;
-        /** Which Web Storage area: `local` (localStorage) or `session` (sessionStorage). */
+        /** `local`: localStorage. `session`: sessionStorage. */
         store: "local" | "session";
         /** get: read one key (with `key`) or all entries. set: write `key`=`value`. remove: delete `key`. clear: empty the store. */
         action: "get" | "set" | "remove" | "clear";
-        /** get (optional) / set / remove: the storage key. */
+        /** The storage key. */
         key?: string;
-        /** set: the value to store. */
+        /** The value to store. */
         value?: string;
     };
     "chromium-tabs": {
         /** Chromium device id from `list-devices` (e.g. `chromium-cdp-9222`). */
         udid: string;
-        /** list: enumerate tabs/windows. select: make a tab active (every other tool then acts on it). new: open a tab. close: close a tab. */
+        /** list: enumerate tabs/windows. select: make a tab active. new: open a tab and activate it. close: close a tab; if it was active, another live tab becomes active. */
         action: "list" | "select" | "new" | "close";
-        /** Target tab for `select` / `close`: a tabId like `t2` or a label. `close` defaults to the active tab. */
+        /** Target tab for `select` (required) / `close`: a tabId like `t2` or a label. `close` defaults to the active tab. */
         tab?: string;
         /** `new` only: URL to open (defaults to about:blank). */
         url?: string;
@@ -119,27 +119,27 @@ export interface ArgentToolArgs {
         label?: string;
     };
     "debugger-component-tree": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial). */
         device_id: string;
         /** iOS simulator UDID from list-devices. Pass it when device_id is a logicalDeviceId (two or more devices share one Metro), so that the tap coordinates of a landscape UI are on the screen's axes. Give the UDID of the simulator that shows the app. */
         udid?: string;
-        /** When true (default), only components visible on screen are returned. Set to false to include all mounted components including those scrolled off-screen. Useful when you need to understand the full page structure. */
+        /** When true, only components visible on screen are returned. Set to false to include all mounted components, including those scrolled off-screen, e.g. to understand the full page structure. */
         onScreenOnly?: boolean;
         /** Maximum total nodes to include. When exceeded, intermediate single-child wrapper chains are collapsed to preserve both root structure and leaf elements. Default: no limit. */
         maxNodes?: number;
-        /** When true, appends a summary of all filtered components: total fiber count, JS-side skip counts by name, and TS-side filter pass removals. Useful for understanding what was pruned from the tree. */
+        /** When true, appends a summary of all filtered components: total fiber count and skip counts by component name and by filter. */
         includeSkipped?: boolean;
     };
     "debugger-connect": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: iOS simulator UDID, Android serial, Vega serial (amazon-...), or Chromium device id (chromium-cdp-<port>). Pass this SAME id as device_id to every subsequent debugger-* call to pin them to this device. The returned logicalDeviceId is informational (Metro's own per-connection handle, absent on Vega); you do not switch to it. Forwarding it still resolves here, but the list-devices id is the stable one. */
         device_id: string;
     };
     "debugger-evaluate": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID, Android serial, Vega serial, or Chromium device id). The logicalDeviceId debugger-connect returns also resolves here, but prefer the stable list-devices id. */
         device_id: string;
@@ -147,37 +147,37 @@ export interface ArgentToolArgs {
         expression: string;
     };
     "debugger-inspect-element": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial). */
         device_id: string;
-        /** Logical X coordinate on device screen */
+        /** X coordinate on device screen, in logical pixels (not normalized 0–1) */
         x: number;
-        /** Logical Y coordinate on device screen */
+        /** Y coordinate on device screen, in logical pixels (not normalized 0–1) */
         y: number;
         /** Lines of source context to include around the component definition */
         contextLines?: number;
-        /** When true, resolves bundled frame locations to original source files via Metro symbolication and includes a code fragment. When false, returns the raw bundled frame info (file, line, column) without symbolication or source reading. */
+        /** When true, resolves bundled frame locations to original source files via Metro symbolication and includes a code fragment. When false, returns the raw bundled frame info (file, line, column) without a code fragment. */
         resolveSourceMaps?: boolean;
-        /** Maximum number of hierarchy items to return, counted from the bottom (most specific component first). The hierarchy walks from the tapped element up to the root, so the first items are the most relevant for editing. Increase to 70+ if you need to understand the broader navigation/screen structure. */
+        /** Maximum number of hierarchy items to return, most specific first. The default covers all app-specific code; increase to 70+ to also see the navigation/screen structure. */
         maxItems?: number;
-        /** When true, items that would normally be filtered are kept in the response with skipped=true and a skipReason. Useful for understanding what was pruned. */
+        /** When true, items that would normally be filtered are kept in the response with skipped=true and a skipReason. */
         includeSkipped?: boolean;
     };
     "debugger-log-registry": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID, Android serial, Vega serial, or Chromium device id). The logicalDeviceId debugger-connect returns also resolves here, but prefer the stable list-devices id. */
         device_id: string;
     };
     "debugger-reload-metro": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial). */
         device_id: string;
     };
     "debugger-status": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID, Android serial, Vega serial, or Chromium device id). The logicalDeviceId debugger-connect returns also resolves here, but prefer the stable list-devices id. */
         device_id: string;
@@ -185,7 +185,7 @@ export interface ArgentToolArgs {
     describe: {
         /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** Optional app bundle ID. Used as a target hint on iOS when the AX-service returns no elements and the describe tool falls back to native-devtools inspection. If omitted, the fallback auto-detects the frontmost connected app. Ignored on every other platform, including a physical iOS device. */
+        /** App bundle ID, used as a target hint on iOS when the AX-service returns no elements and describe falls back to native-devtools inspection. If omitted, the fallback auto-detects the frontmost connected app. Ignored on every other platform, including a physical iOS device. */
         bundleId?: string;
     };
     "dismiss-update": {
@@ -195,9 +195,9 @@ export interface ArgentToolArgs {
     "e2e-add-echo": {
         /** Name of the e2e test being recorded: the one passed to e2e-start-recording. */
         name: string;
-        /** Absolute path to the project root of the e2e test being recorded: the same value passed to e2e-start-recording. Together with `name` it identifies which recording this echo belongs to. */
+        /** Absolute path to the project root of the e2e test being recorded: the same value passed to e2e-start-recording. */
         project_root: string;
-        /** Message to echo when the e2e test is replayed */
+        /** Text the echo step prints */
         message: string;
     };
     "e2e-add-script": {
@@ -207,13 +207,13 @@ export interface ArgentToolArgs {
         project_root: string;
         /** Path to the .mjs file, relative to the e2e test YAML. For example: "../../scripts/seed-order.mjs". */
         path: string;
-        /** Optional time limit in milliseconds. The default is 30000 and the minimum is 100. */
+        /** Time limit in milliseconds. The default is 30000 and the minimum is 100. */
         timeout?: number;
     };
     "e2e-add-step": {
         /** Name of the e2e test being recorded: the one passed to e2e-start-recording. */
         name: string;
-        /** Absolute path to the project root of the e2e test being recorded: the same value passed to e2e-start-recording. Together with `name` it identifies which recording this step belongs to. */
+        /** Absolute path to the project root of the e2e test being recorded: the same value passed to e2e-start-recording. */
         project_root: string;
         /** MCP tool to execute and record, for example "gesture-tap". Do not pass an e2e test directive or a recording tool. Call e2e-add-script directly for a requested script step. */
         command: string;
@@ -223,21 +223,21 @@ export interface ArgentToolArgs {
         delayMs?: number;
     };
     "e2e-execute": {
-        /** Name of a saved e2e test to run from `.argent/e2e`, or `.argent/flows` when it is not there (e.g. "settings-explore"). Omit when e2e_test_path is set. */
+        /** Name of a saved e2e test to run from `<project_root>/.argent/e2e`, or `.argent/flows` when it is not there (e.g. "settings-explore"). */
         name?: string;
-        /** Absolute path to the calling agent's project root: the cwd it is working in. With name, the saved e2e test is read from `.argent/e2e/<name>.yaml`, else `.argent/flows/<name>.yaml`, under this root; with e2e_test_path, the e2e test, its run: siblings, its script: paths and baselines all resolve beside the YAML instead, so pass the agent's cwd. A script still RUNS in this root whichever source was used. */
+        /** Absolute path to the calling agent's project root: the cwd it is working in, also with e2e_test_path, where the e2e test, its run: siblings, its script: paths and baselines resolve beside the YAML instead. A script still RUNS in this root. */
         project_root: string;
         /** Path to the e2e test .yaml as readable by the tool-server. Internal: the argent client derives it from project_root and name automatically; leave unset. */
         e2e_test_file?: string;
-        /** Omit when name is set. Absolute path to an e2e test .yaml on the client. Over a link (argent link or ARGENT_TOOLS_URL), the argent client uploads the file, its run: fragments and the snapshot baselines of each run, and the tool-server runs those copies. Keep run: fragments under project_root or beside the e2e test file. With updateBaselines, the client writes the new baselines when the run ends. The client also uploads each absolute .png or .yaml path that a tool: step takes as a file argument, when the file is under project_root or beside the e2e test file. A tool: e2e-execute step that names an e2e test with name and an absolute project_root without a .. segment runs: the client also uploads that e2e test and its own files. Over a link, the uploaded e2e tests must not have: script: steps; tool: steps that run an e2e test another way or record an e2e test; tool: steps that take a directory, an app or an output directory; tool: steps whose tool builds a file path from several arguments; tool: steps that name a relative path or a file other than .png or .yaml. Without a link, the tool-server reads the files in place and all step kinds run. */
+        /** Absolute path to an e2e test .yaml on the client. */
         e2e_test_path?: string;
-        /** Device id to run against (iOS UDID, Android/Vega serial, Chromium id), as list-devices reports it. Auto-detected when omitted, but only when exactly one booted device matches (optionally narrowed by `platform`); with several booted the run fails and lists them, so pass this explicitly whenever more than one device is up. */
+        /** Device id to run against (iOS UDID, Android/Vega serial, Chromium id), as list-devices reports it. Auto-detected when omitted, but only when exactly one booted device matches (optionally narrowed by `platform` and the e2e test's `requires:` block); with several booted the run fails and lists them, so pass this explicitly whenever more than one device is up. */
         device?: string;
-        /** Restrict auto-detection to this platform when several devices are booted. `ios` selects local simulators only; pass `ios-remote` to select a remote one. `chromium` does more than filter: with no `device` it SELECTS the self-boot branch for a standalone e2e test - the runner boots an Electron instance from the `launch` step's chromium value and tears it down after the run (a single-key `launch: { chromium: … }` map selects it on its own, without this parameter). When it selects that branch it never falls back to device auto-detection (a fragment, or a standalone e2e test's launch map with no `chromium` key, still does), and the launch value must be a real Electron app path on the tool-server host: a bare-string `launch:` - what the recorder writes - holds an installed-app bundle id, so passing `chromium` for one fails the whole run with `Electron boot: path does not exist`. Edit the launch to `{ chromium: <app path> }` first. */
+        /** Restrict auto-detection to this platform when several devices are booted. `ios` selects local simulators only; `ios-remote` selects a remote one. `chromium` with no `device` also makes the runner boot an Electron instance for a standalone e2e test from its `launch` step's chromium value and tear it down after the run, with no fallback to auto-detection (a single-key `launch: { chromium: … }` map, or a `requires:` block that allows only chromium, does this on its own; a fragment, or a launch map without a `chromium` key, is still auto-detected). That value must be an Electron app path on the tool-server host: the bare-string `launch:` the recorder writes holds a bundle id, which fails the run with `Electron boot: path does not exist`, so first edit it to `{ chromium: <app path> }`. */
         platform?: "ios" | "android" | "chromium" | "vega" | "ios-remote";
-        /** Write/refresh screenshot baselines for `snapshot` steps instead of diffing against them, also in the e2e tests that tool: e2e-execute steps run, unless such a step sets updateBaselines itself. */
+        /** Write/refresh screenshot baselines for `snapshot` steps instead of diffing against them, also in the e2e tests that tool: e2e-execute steps run, unless such a step sets updateBaselines itself. Over a link, the client writes the new baselines when the run ends. */
         updateBaselines?: boolean;
-        /** Set to true to confirm the execution prerequisite has been met. Required (LLM path) when a fragment defines an executionPrerequisite. */
+        /** Set to true to confirm the execution prerequisite has been met. Required when a fragment defines an executionPrerequisite. */
         prerequisiteAcknowledged?: boolean;
         /** @deprecated Renamed to `e2e_test_path`. */
         flow_path?: string;
@@ -247,17 +247,17 @@ export interface ArgentToolArgs {
     "e2e-finish-recording": {
         /** Name of the e2e test being recorded: the one passed to e2e-start-recording. */
         name: string;
-        /** Absolute path to the project root of the e2e test being recorded: the same value passed to e2e-start-recording. Together with `name` it identifies which recording to finish. */
+        /** Absolute path to the project root of the e2e test being recorded: the same value passed to e2e-start-recording. */
         project_root: string;
     };
     "e2e-read-prerequisite": {
-        /** Name of a saved e2e test to inspect from `.argent/e2e`, or `.argent/flows` when it is not there (e.g. "settings-explore"). Omit when e2e_test_path is set. */
+        /** Name of a saved e2e test to inspect from `<project_root>/.argent/e2e`, or `.argent/flows` when it is not there (e.g. "settings-explore"). */
         name?: string;
-        /** Absolute path to the calling agent's project root: the cwd it is working in. With name, the saved e2e test is read from `.argent/e2e/<name>.yaml`, else `.argent/flows/<name>.yaml`, under this root; with e2e_test_path, the prerequisite is read from that YAML instead, so pass the agent's cwd. */
+        /** Absolute path to the calling agent's project root: the cwd it is working in. */
         project_root: string;
         /** Path to the e2e test .yaml as readable by the tool-server. Internal: the argent client derives it from project_root and name automatically; leave unset. */
         e2e_test_file?: string;
-        /** Omit when name is set. Absolute path to an e2e test .yaml on the client. Over a link (argent link or ARGENT_TOOLS_URL), the argent client uploads the file and the tool-server reads the uploaded copy; without a link, the tool-server reads the file in place. Pass the path through the argent client; a raw path that the file-input boundary did not verify is rejected. Pass the same e2e test source here as to e2e-execute, so the prerequisite you read belongs to the e2e test that will run. */
+        /** Absolute path to an e2e test .yaml on the client. */
         e2e_test_path?: string;
         /** @deprecated Renamed to `e2e_test_path`. */
         flow_path?: string;
@@ -267,10 +267,15 @@ export interface ArgentToolArgs {
     "e2e-start-recording": {
         /** Name for this e2e test (e.g. "settings-explore"): letters, digits, underscore and hyphen only. */
         name: string;
-        /** Absolute path to the project root directory (the directory that contains or should contain `.argent/e2e/`). The e2e test file is created at `<project_root>/.argent/e2e/<name>.yaml`. */
+        /** Absolute path to the project root directory (the directory that contains or should contain `.argent/e2e/`). */
         project_root: string;
-        /** Fragments only: the app/device state assumed on entry (e.g. "Settings app open on General page"). For a standalone e2e test, omit this and record a `restart-app` as the first step instead; it is captured as the e2e test's `launch` step. restart-app has no chromium support, so a chromium e2e test records as a fragment; add the `launch: { chromium: <app path> }` line to the YAML afterward, deleting the executionPrerequisite line if you passed one, since an e2e test that starts with a launch must not declare it. */
+        /** Fragments only: the app/device state assumed on entry (e.g. "Settings app open on General page"). Omit it for a standalone e2e test. restart-app has no chromium support, so a chromium e2e test records as a fragment; add the `launch: { chromium: <app path> }` line to the YAML afterward, deleting the executionPrerequisite line if you passed one, since an e2e test that starts with a launch must not declare it. */
         executionPrerequisite?: string;
+        /** The e2e test's `requires:` block: the targets it supports, ANDed. `platform` is one platform or a list (`ios` also covers a remote simulator); `runtimeKind` is `tv` or `mobile`. Omit it for a test that runs on any target. */
+        requires?: {
+            platform?: "ios" | "android" | "chromium" | "vega" | Array<"ios" | "android" | "chromium" | "vega">;
+            runtimeKind?: "mobile" | "tv";
+        };
     };
     fill: {
         /** Target device id from `list-devices`. */
@@ -281,9 +286,9 @@ export interface ArgentToolArgs {
     fold: {
         /** Target device id from `list-devices` (a foldable iOS simulator UDID or Android emulator serial). */
         udid: string;
-        /** Where to move the hinge: `closed` (the cover panel), `half-open` or `open` (the inner panel). Exactly one of `posture` and `angle`. */
+        /** Where to move the hinge: `closed` shows the cover panel, `half-open` and `open` show the inner panel. */
         posture?: "closed" | "half-open" | "open";
-        /** The hinge angle in degrees, 0 (closed) to 180 (open). Exactly one of `posture` and `angle`. */
+        /** The hinge angle in degrees: 0 = closed, 180 = open. */
         angle?: number;
     };
     "foreground-app": {
@@ -297,56 +302,56 @@ export interface ArgentToolArgs {
     "gesture-custom": {
         /** Target device id from `list-devices` (iOS UDID or Android serial). */
         udid: string;
-        /** Sequence of touch events; x/y (and optional second touch) are normalized 0.0–1.0, not pixels */
+        /** Touch events, dispatched in order. */
         events: Array<{
             /** Touch event type */
             type: "Down" | "Move" | "Up";
-            /** Normalized x 0.0–1.0 (not pixels; same as tap/swipe) */
+            /** Touch x. */
             x: number;
-            /** Normalized y 0.0–1.0 (not pixels; same as tap/swipe) */
+            /** Touch y. */
             y: number;
-            /** Second touch x for two-finger gestures: normalized 0.0–1.0 (not pixels) */
+            /** Second finger x, for two-finger gestures. */
             x2?: number;
-            /** Second touch y for two-finger gestures: normalized 0.0–1.0 (not pixels) */
+            /** Second finger y, for two-finger gestures. */
             y2?: number;
             /** Delay before this event in milliseconds (default 16ms ≈ 60fps) */
             delayMs?: number;
         }>;
-        /** Number of intermediate Move events to auto-insert between each pair of consecutive events. Smooths out gestures by linearly interpolating both primary (x,y) and secondary (x2,y2) coordinates. The delay is split evenly across interpolated frames. Default: no interpolation. */
+        /** Number of Move events to insert between each pair of consecutive events, linearly interpolating both x,y and x2,y2 and splitting the delay evenly, for a smooth gesture. Default: no interpolation. */
         interpolate?: number;
     };
     "gesture-drag": {
         /** Target Chromium device id from `list-devices` (chromium-cdp-<port>). */
         udid: string;
-        /** Press x: normalized 0.0–1.0 (fraction of window width, not pixels). */
+        /** Press x. */
         fromX: number;
-        /** Press y: normalized 0.0–1.0 (fraction of window height, not pixels). */
+        /** Press y. */
         fromY: number;
-        /** Release x: normalized 0.0–1.0 (not pixels; same space as tap). */
+        /** Release x. */
         toX: number;
-        /** Release y: normalized 0.0–1.0 (not pixels; same space as tap). */
+        /** Release y. */
         toY: number;
-        /** Total drag duration in milliseconds (default 300, at most 10000 - the button stays down for exactly this long), interpolated at ~60fps. */
+        /** Total drag duration in milliseconds (default 300); the button stays down this long. */
         durationMs?: number;
-        /** Whether the drag releases with momentum; default true (a constant-speed drag). Pass false to decelerate into the release point (ease-out) so an app deriving fling from pointer release velocity (carousels, drag libraries) reads ~0 and applies little to no momentum. Use it when the drag must stop where it was aimed rather than fling past. Deceleration needs wall clock: under ~100ms the whole drag fits inside the velocity window a page averages over (tens of ms), so some fling survives, and under ~70ms its extra frames cannot dispatch fast enough to fit durationMs. Keep durationMs at its default when the fling must be fully suppressed. */
+        /** Whether the drag releases with momentum; default true (a constant-speed drag). false decelerates into the release point, so an app that derives a fling from the release velocity (carousels, drag libraries) applies little to no momentum: use it when the drag must stop where it was aimed. Under ~100ms durationMs some fling survives; keep the default 300 when the fling must be fully suppressed. */
         momentum?: boolean;
     };
     "gesture-pinch": {
         /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
         udid: string;
-        /** Center of pinch, horizontal: normalized 0.0–1.0 (fraction of screen width, not pixels) */
+        /** Center of the pinch, horizontal. */
         centerX: number;
-        /** Center of pinch, vertical: normalized 0.0–1.0 (fraction of screen height, not pixels) */
+        /** Center of the pinch, vertical. */
         centerY: number;
-        /** Initial distance between the two fingers: normalized 0.0–1.0 (fraction of screen, not pixels). E.g. 0.2 = fingers 20% of screen apart. Use a larger startDistance than endDistance to pinch in (zoom out). */
+        /** Initial distance between the two fingers. */
         startDistance: number;
-        /** Final distance between the two fingers: normalized 0.0–1.0 (fraction of screen, not pixels). E.g. 0.6 = fingers 60% of screen apart. Use a larger endDistance than startDistance to pinch out (zoom in). */
+        /** Final distance between the two fingers. */
         endDistance: number;
-        /** Final horizontal center of the pinch: normalized 0.0–1.0. When set, the centroid drifts linearly from centerX to endCenterX over the gesture (e.g. to keep expanding fingers on-screen near an edge). Omit for a fixed center. */
+        /** Final horizontal center of the pinch. When set, the centroid drifts linearly from centerX to endCenterX over the gesture (e.g. to keep expanding fingers on-screen near an edge). Omit for a fixed center. */
         endCenterX?: number;
-        /** Final vertical center of the pinch: normalized 0.0–1.0. When set, the centroid drifts linearly from centerY to endCenterY over the gesture. Omit for a fixed center. */
+        /** Final vertical center of the pinch; drifts from centerY like endCenterX. Omit for a fixed center. */
         endCenterY?: number;
-        /** Axis angle in degrees along which the fingers are placed (default 0 = horizontal). */
+        /** Angle in degrees of the axis the fingers lie on: 0 = horizontal (default), 90 = vertical. */
         angle?: number;
         /** Total gesture duration in milliseconds (default 300). On HarmonyOS the device runs the whole move itself and takes this as wall-clock time, clamped to the 1–15000ms range `uinput` accepts. */
         durationMs?: number;
@@ -354,19 +359,19 @@ export interface ArgentToolArgs {
     "gesture-rotate": {
         /** Target device id from `list-devices` (iOS UDID or Android serial). */
         udid: string;
-        /** Center of rotation, horizontal: normalized 0.0–1.0 (fraction of screen width, not pixels) */
+        /** Center of rotation, horizontal. */
         centerX: number;
-        /** Center of rotation, vertical: normalized 0.0–1.0 (fraction of screen height, not pixels) */
+        /** Center of rotation, vertical. */
         centerY: number;
-        /** Distance from center to each finger: normalized 0.0–1.0 (fraction of screen, not pixels). E.g. 0.15 = fingers placed 15% of screen away from center. One value for both axes, so on a non-square screen the orbit is a physical ellipse; pass radiusX+radiusY instead for a true circle. Required unless radiusX and radiusY are given. */
+        /** Distance from the center to each finger. */
         radius?: number;
-        /** Per-axis finger distance, horizontal: normalized 0.0–1.0 fraction of screen WIDTH. Give both radiusX and radiusY (they override radius) with radiusX·screenWidth = radiusY·screenHeight for a physically circular orbit: constant finger separation, no pinch coupled into the turn. */
+        /** Finger distance along the horizontal axis, as a fraction of screen WIDTH. */
         radiusX?: number;
-        /** Per-axis finger distance, vertical: normalized 0.0–1.0 fraction of screen HEIGHT. Always paired with radiusX; see radiusX. */
+        /** Finger distance along the vertical axis, as a fraction of screen HEIGHT. */
         radiusY?: number;
         /** Starting angle in degrees (0 = right, 90 = down) */
         startAngle: number;
-        /** Ending angle in degrees. endAngle > startAngle = clockwise. */
+        /** Ending angle in degrees. */
         endAngle: number;
         /** Total gesture duration in milliseconds (default 300) */
         durationMs?: number;
@@ -374,13 +379,13 @@ export interface ArgentToolArgs {
     "gesture-scroll": {
         /** Target Chromium device id from `list-devices` (chromium-cdp-<port>). */
         udid: string;
-        /** Anchor x: normalized 0.0–1.0 (fraction of window width, not pixels). The wheel events land here; put it over the element you want to scroll. */
+        /** Anchor x. The wheel events land here; put it over the element you want to scroll. */
         x: number;
-        /** Anchor y: normalized 0.0–1.0 (fraction of window height, not pixels). */
+        /** Anchor y. */
         y: number;
-        /** Horizontal scroll distance as a fraction of the window width (e.g. 0.5 = half a window). Positive scrolls content right (reveals content to the right). */
+        /** Horizontal scroll distance as a fraction of the window width. Positive reveals content to the right; negative scrolls back left. */
         deltaX?: number;
-        /** Vertical scroll distance as a fraction of the window height (e.g. 0.5 = half a window). Positive scrolls content down (reveals content below), like rolling a mouse wheel toward you. */
+        /** Vertical scroll distance as a fraction of the window height (0.5 = half a window). Positive scrolls down (reveals content below), like rolling a mouse wheel toward you; negative scrolls back up. */
         deltaY?: number;
         /** Spread the scroll over this many milliseconds in wheel-event steps (default 300) so scroll handlers fire progressively. */
         durationMs?: number;
@@ -388,47 +393,47 @@ export interface ArgentToolArgs {
     "gesture-swipe": {
         /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
         udid: string;
-        /** Start x: normalized 0.0–1.0 (not pixels; same as tap) */
+        /** Start x. */
         fromX: number;
-        /** Start y: normalized 0.0–1.0 (not pixels; same as tap) */
+        /** Start y. */
         fromY: number;
-        /** End x: normalized 0.0–1.0 (not pixels; same as tap) */
+        /** End x. */
         toX: number;
-        /** End y: normalized 0.0–1.0 (not pixels; same as tap) */
+        /** End y. */
         toY: number;
-        /** Total gesture duration in milliseconds (default 300, at most 10000 - the gesture holds a finger down for exactly this long) */
+        /** Total gesture duration in milliseconds (default 300); the finger stays down this long. Below ~32ms the whole travel lands in one or two frames, which the OS flings as hard as any flick. */
         durationMs?: number;
-        /** Whether the swipe releases with momentum; default true (a natural flinging swipe). Pass false for a momentum-free swipe at the default durationMs: the finger decelerates into the end point (ease-out) so the OS reads ~0 release velocity and applies little to no fling. Use false for scroll-to-element loops. momentum: false needs durationMs >= 150 and is rejected below it: a shorter ease-out gives the OS velocity fit too little wall clock to read the deceleration as a stop, and it flings harder than a plain swipe instead (on Android, backwards). At 150 itself the swipe lands short of where the finger stopped, and 2 of 47 runs still flung backwards. */
+        /** Whether the swipe releases with momentum; default true (a natural flinging swipe). false eases the finger into the end point so the OS applies little to no fling and the content stops where the finger lifts: use it when you need a deterministic scroll distance, e.g. in scroll-to-element loops. false needs durationMs >= 150 and is rejected below that; near 150 it can still land short or fling, so keep the default 300. */
         momentum?: boolean;
     };
     "gesture-tap": {
         /** Target device id from `list-devices` (iOS UDID, Android serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** Normalized horizontal position 0.0–1.0 (left=0, right=1), not pixels */
+        /** Horizontal position: 0 = left edge, 1 = right edge. */
         x: number;
-        /** Normalized vertical position 0.0–1.0 (top=0, bottom=1), not pixels */
+        /** Vertical position: 0 = top edge, 1 = bottom edge. */
         y: number;
-        /** Number of taps/clicks dispatched as ONE multi-tap gesture (2 = double-tap / double-click). The taps land inside the OS double-tap window; on Chromium each click carries an escalating CDP clickCount so dblclick actually fires; on physical iOS 2 is the native double-tap and higher counts loop single taps, which a double-tap recognizer may pair. On HarmonyOS only 2 is one gesture; 3 or more are separate injections a device round trip apart, which the OS reads as single taps. Default 1. */
+        /** Number of taps/clicks dispatched as ONE gesture inside the OS double-tap window (2 = double-tap / double-click), which two separate tap calls cannot guarantee. On physical iOS, higher counts loop single taps, which a double-tap recognizer may pair. On HarmonyOS they land as separate taps. Default 1. */
         clickCount?: number;
     };
     keyboard: {
         /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** Text to type character by character. Cannot be combined with `key` in one call (one call per action); to type and then press a key, put two `keyboard` steps in one `run-sequence`. Handles uppercase and common punctuation. To type a credential without its plaintext ever entering your context, use a secret placeholder: `{{secret:<NAME>}}`, e.g. text: "{{secret:APP_PASSWORD}}". The value is resolved on the machine running the tool-server, from the first source that defines the name: the `ARGENT_SECRET_<NAME>` environment variable, `.argent/secrets.env` in the project, the project's `.env.local` / `.env` (only their `ARGENT_SECRET_`-prefixed keys), then `~/.argent/secrets.env`. Nothing else on the host is reachable. Over a link with the `forward-secrets` flag on, the client's own sources are checked first. Placeholders can be embedded in longer text and are never echoed back resolved. If the secret you need is not set, the failure lists the available names and every source it looked in; ask the user to add it to one of them (a secrets file applies immediately; an env var needs a restart), NEVER ask the user to paste the secret value into the conversation. */
+        /** Text to type character by character; handles uppercase, digits and common punctuation. Cannot be combined with `key`: to type and then press a key, send two `keyboard` steps in one `run-sequence` ({ text: "hello" } then { key: "enter" }). To type a credential without its plaintext ever entering your context, use a secret placeholder `{{secret:<NAME>}}`, e.g. "{{secret:APP_PASSWORD}}", alone or inside longer text. It is resolved on the machine running the tool-server, from the first source that defines the name: the `ARGENT_SECRET_<NAME>` environment variable, `.argent/secrets.env` in the project, the project's `.env.local` / `.env` (only their `ARGENT_SECRET_`-prefixed keys), then `~/.argent/secrets.env`. Nothing else on the host is reachable. Over a link with the `forward-secrets` flag on, the client's own sources are checked first. The result echoes the placeholder, never the value, and the auto-screenshot after typing is skipped. To submit after a secret, put both steps in ONE `run-sequence`: that keeps the skip covering the Enter, which a second bare `keyboard` call would not. If the secret is not set, the failure lists the available names and the sources it checked; ask the user to add it to one of them (a secrets file applies immediately, an env var needs a restart). NEVER ask the user to paste the secret value into the conversation. */
         text?: string;
-        /** Named key to press: enter, escape, backspace, tab, space, arrow-up, arrow-down, arrow-left, arrow-right, f1-f12. Cannot be combined with `text` in one call: one call per action; to type and then press a key, put two `keyboard` steps in one `run-sequence`. Not supported on TV targets; move focus with `tv-remote` (up/down/left/right) instead. Physical iOS: only `enter` and `backspace`. HarmonyOS: only enter (return), backspace (delete), space, arrow-left and arrow-right; any other key fails with 400 KEYBOARD_KEY_UNSUPPORTED. */
+        /** Named key to press: enter, escape, backspace, tab, space, arrow-up, arrow-down, arrow-left, arrow-right, f1-f12. Cannot be combined with `text`; to do both, send two `keyboard` steps in one `run-sequence`. Not supported on Apple TV / Android TV; move focus with `tv-remote` (up/down/left/right) instead. Physical iOS: only `enter` and `backspace`. HarmonyOS: only enter (return), backspace (delete), space, arrow-left and arrow-right; any other key fails with 400 KEYBOARD_KEY_UNSUPPORTED. */
         key?: string;
-        /** Delay in ms between key presses (default 50). Ignored on Android phones/tablets (typed via `adb input text`, which has no per-key cadence), on HarmonyOS (`uitest uiInput text` types the whole string in one shot), on Vega (text/keys injected in a single shot), on TV targets (Apple TV / Android TV type the whole string at the daemon's own cadence), and on physical iOS. */
+        /** Delay in ms between key presses (default 50). Ignored on Android phones/tablets, HarmonyOS, Vega, Apple TV / Android TV and physical iOS, which type the whole string in one shot or at their own cadence. */
         delayMs?: number;
     };
     "launch-app": {
         /** Target device id from `list-devices` (iOS UDID, Android serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** App identifier. iOS: bundle id (e.g. com.apple.MobileSMS). Android: package name from build.gradle `applicationId` (e.g. com.android.settings). HarmonyOS: bundle name as listed by `bm dump -a` (e.g. com.huawei.hmos.calculator). Chromium: any tag matching the same alphabet (letters, digits, '.', '_' and '-'); the call is a no-op since the renderer is already running. */
+        /** App identifier. iOS: bundle id. Android: package name from build.gradle `applicationId`. Vega (Fire TV): the interactive component app id from manifest.toml (e.g. com.example.app.main). HarmonyOS: bundle name as listed by `bm dump -a` (e.g. com.huawei.hmos.calculator). Chromium: any tag matching the pattern. */
         bundleId: string;
-        /** Android-only: fully-qualified Activity name (e.g. `.MainActivity` or `com.example/com.example.MainActivity`). If omitted on Android, the app's default launcher activity is used. Ignored on iOS / Chromium / HarmonyOS (a HarmonyOS ability is resolved from the bundle's own `abilityInfos`). */
+        /** Android-only: fully-qualified Activity name (e.g. `.MainActivity` or `com.example/com.example.MainActivity`). If omitted, the app's default launcher activity is used. */
         activity?: string;
-        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. A running app is relaunched to apply them. Ignored on other targets. */
+        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. A running app is relaunched to apply them. The call fails, launching nothing, if terminating it does not finish within 15s on a local iOS simulator, or fails for a reason other than the app not running on a remote one. */
         launchArgs?: Array<string>;
     };
     "list-devices": Record<string, never>;
@@ -481,7 +486,7 @@ export interface ArgentToolArgs {
         skipClasses?: Array<string>;
         /** Class name prefixes to prune entire subtrees. For SwiftUI apps use ["_TtGC7SwiftUI"] to drop mangled SwiftUI generic type subtrees while keeping _UIHostingView and UIKit bridges. Avoid broad prefixes like "_UI": they prune useful system views. */
         skipClassPrefixes?: Array<string>;
-        /** Maximum recursion depth (default 8). Increase for deeper inspection, decrease to reduce output size. */
+        /** Maximum recursion depth (default 8). Raise it to reach deeper views. */
         maxDepth?: number;
     };
     "native-network-logs": {
@@ -505,11 +510,11 @@ export interface ArgentToolArgs {
     "native-profiler-start": {
         /** Target device id from `list-devices` (iOS UDID or Android serial). */
         device_id: string;
-        /** iOS: the CFBundleExecutable or display name of the app to profile. Android: the app's package name. If omitted, auto-detects the currently running foreground app. Only provide this if auto-detection picks the wrong app. */
+        /** iOS: the CFBundleExecutable or display name of the app to profile. Android: the app's package name. If omitted, auto-detects the foreground app; set it only if auto-detection picks the wrong app. */
         app_process?: string;
-        /** iOS-only: path to an Instruments .tracetemplate file (defaults to bundled Argent template). Ignored on Android. */
+        /** iOS only. Path to an Instruments .tracetemplate file (defaults to the bundled Argent template). */
         template_path?: string;
-        /** iOS-only. When true, cold-launches the app under the profiler with Malloc Stack Logging enabled so memory leaks carry an allocation backtrace (responsible frame + library). Without it, leaks are still detected but unattributable: Instruments reports '<Call stack limit reached>'. Trade-offs: this RESTARTS the app (current state is lost), adds memory/CPU overhead, and makes the app noticeably slow to launch (every startup allocation records a backtrace), so leave it off for pure CPU/hang profiling. Requires a non-degraded Xcode: on Xcode 26.4 and later the cold-launch path is broken, so the call is rejected up front (re-run without the flag, or set ARGENT_IOS_CAPTURE=device to override if the device path works on your host). ARGENT_IOS_CAPTURE=all-processes (e.g. exported globally for the normal capture path) also rejects this flag up front, since that fallback cannot cold-launch; unset it (or set it to device) first. Ignored on Android. */
+        /** iOS only. When true, cold-launches the app under the profiler with Malloc Stack Logging enabled so memory leaks carry an allocation backtrace (responsible frame + library). Without it, leaks carry no backtrace (Instruments reports '<Call stack limit reached>'). Trade-offs: this RESTARTS the app (current state is lost), adds memory/CPU overhead, and makes the app noticeably slow to launch, so leave it off for pure CPU/hang profiling. Rejected up front under the all-processes capture (used where Xcode's `--device` recording is broken, or forced with ARGENT_IOS_CAPTURE=all-processes), which cannot cold-launch and records no leaks. */
         malloc_stack_logging?: boolean;
     };
     "native-profiler-stop": {
@@ -523,7 +528,7 @@ export interface ArgentToolArgs {
         bundleId: string;
         /** Raw X coordinate in points, on the portrait axes of the screen (the axes of native-describe-screen frames). NOT normalized [0,1] tap space. */
         x: number;
-        /** Raw Y coordinate in points, on the portrait axes of the screen (the axes of native-describe-screen frames). NOT normalized [0,1] tap space. */
+        /** Raw Y coordinate in points, on the same axes as x. NOT normalized [0,1] tap space. */
         y: number;
         /** Include ancestor chain for the matched view (default true) */
         includeAncestors?: boolean;
@@ -545,7 +550,7 @@ export interface ArgentToolArgs {
         bundleId: string;
         /** Raw X coordinate in points, on the portrait axes of the screen (the axes of native-describe-screen frames). NOT normalized [0,1] tap space. */
         x: number;
-        /** Raw Y coordinate in points, on the portrait axes of the screen (the axes of native-describe-screen frames). NOT normalized [0,1] tap space. */
+        /** Raw Y coordinate in points, on the same axes as x. NOT normalized [0,1] tap space. */
         y: number;
         /** Include ancestor chain for the matched view (default true) */
         includeAncestors?: boolean;
@@ -563,93 +568,93 @@ export interface ArgentToolArgs {
     "open-url": {
         /** Target device id from `list-devices` (iOS UDID, Android serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** URL or scheme to open (e.g. https://example.com, messages://, tel:555, geo:37.0,-122.0). For Chromium this navigates the renderer. */
+        /** URL or scheme to open (e.g. https://example.com, messages://, tel:555, geo:37.0,-122.0). */
         url: string;
-        /** Physical iOS only: the app that receives the URL. Defaults to Safari for http(s); required for any other scheme. Ignored elsewhere. */
+        /** Physical iOS only: the app that receives the URL. Defaults to Safari for http(s); required for any other scheme. */
         bundleId?: string;
     };
     paste: {
         /** Target device id from `list-devices` (iOS simulator UDID or Android emulator serial). */
         udid: string;
-        /** Text to put on the device clipboard and paste into the focused field. Supports `{{secret:<NAME>}}` placeholders, resolved on the tool-server from the `ARGENT_SECRET_<NAME>` environment variable or an argent secrets file (the same sources as `keyboard`, the client's first over a link with the `forward-secrets` flag on), so a credential never enters your context. If the secret is not set, the failure lists the available names and every source it looked in; ask the user to add it there, NEVER ask for the value in the conversation. */
+        /** Text to put on the device clipboard and paste into the focused field. Supports `{{secret:<NAME>}}` placeholders, resolved on the tool-server from the `ARGENT_SECRET_<NAME>` environment variable or an argent secrets file (the same sources as `keyboard`), so a credential never enters your context and is never echoed back. If the secret is not set, the failure lists the available names and every source it looked in; ask the user to add it there, NEVER ask for the value in the conversation. */
         text: string;
     };
     "profiler-combined-report": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** iOS Simulator/device UDID or Android serial */
         device_id: string;
     };
     "profiler-commit-query": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
-        /** Query mode: by_component (commits for a component), by_time_range (commits in a window), by_index (full detail for one commit), cascade_tree (parent-child cascade for a commit) */
+        /** Query mode; see Modes in the tool description. */
         mode: "by_component" | "by_time_range" | "by_index" | "cascade_tree";
-        /** Component name for by_component mode */
+        /** Component name */
         component_name?: string;
-        /** Time range filter for by_time_range mode */
+        /** Time range in ms since profiling started, the clock this tool prints */
         time_range_ms?: {
-            /** Start of range in ms since profiling started, the same clock profiler-commit-query prints */
+            /** Start of range in ms */
             start: number;
-            /** End of range in ms since profiling started, the same clock profiler-commit-query prints */
+            /** End of range in ms */
             end: number;
         };
-        /** Commit index for by_index and cascade_tree modes */
+        /** Commit index */
         commit_index?: number;
-        /** Max results to return. Defaults to 20 for by_component / by_time_range, which count commits. by_index counts individual fibers and returns all of them unless this is set, because one commit's fibers collapse to far fewer distinct components, and a small cap there can show less than the analyze report it is meant to expand on. */
+        /** Max results to return. Defaults to 20 for by_component / by_time_range, which count commits. by_index counts individual fibers and returns all of them unless this is set; a small cap there can show less than the analyze report it is meant to expand on. */
         top_n?: number;
     };
     "profiler-cpu-query": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
-        /** Query mode: top_functions (global hotspots), time_window (CPU in a time range), call_tree (callers/callees of a function), component_cpu (CPU during a component's commits) */
+        /** Query mode; see Modes in the tool description. */
         mode: "top_functions" | "time_window" | "call_tree" | "component_cpu";
-        /** Time window filter for time_window mode (ms since profiling started, the same clock profiler-commit-query prints) */
+        /** Time window in ms since profiling started, the same clock profiler-commit-query prints */
         time_window_ms?: {
-            /** Start of window in ms since profiling started, the same clock profiler-commit-query prints */
+            /** Start of window in ms */
             start: number;
-            /** End of window in ms since profiling started, the same clock profiler-commit-query prints */
+            /** End of window in ms */
             end: number;
         };
-        /** Component name for component_cpu mode */
+        /** Component name */
         component_name?: string;
-        /** Function name for call_tree mode */
+        /** Function name */
         function_name?: string;
-        /** Number of results to return (default 15) */
+        /** Number of results to return */
         top_n?: number;
-        /** For call_tree mode: also show callers of the function */
+        /** Also show callers of the function */
         include_callers?: boolean;
     };
     "profiler-load": {
-        /** list: show available sessions on disk. load_react: load a React profiler session into memory for query tools. load_native: re-parse native profiler XML files (xctrace on iOS) into memory for query tools. */
+        /** What to do; see Modes in the tool description. */
         mode: "list" | "load_react" | "load_native";
-        /** Timestamp-based session identifier (e.g. '20250313-143022') from the list output. Required for load_react and load_native modes. */
+        /** Timestamp-based session identifier (e.g. '20250313-143022') from the list output. */
         session_id?: string;
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Target device id from `list-devices`. Used to cache the loaded React session under the correct port+device key, and required to resolve the native profiler session for load_native. */
         device_id: string;
-        /** Android package name to use when restoring older load_native .pftrace sessions that do not have a metadata sidecar. */
+        /** Android package name to pass when restoring an older load_native .pftrace session that has no metadata sidecar. */
         app_process?: string;
     };
     "profiler-stack-query": {
         /** iOS Simulator UDID or Android serial. */
         device_id: string;
-        /** Query mode: hang_stacks (full CPU context during a hang), function_callers (who calls a native function), thread_breakdown (CPU split by thread), leak_stacks (leak details by object type) */
+        /** Query mode; see Modes in the tool description. */
         mode: "hang_stacks" | "function_callers" | "thread_breakdown" | "leak_stacks";
-        /** 0-based index into the hang list for hang_stacks mode */
+        /** 0-based index into the hang list */
         hang_index?: number;
-        /** Function name for function_callers mode */
+        /** Native function name */
         function_name?: string;
         /** Thread filter. thread_breakdown: case-insensitive substring match. function_callers: exact raw thread name (e.g. ".blueskyweb.app"), or "main" for the UI thread; omit to search ALL threads (each result is tagged with its thread). Run thread_breakdown first to see the exact raw names. */
         thread?: string;
-        /** Object type filter for leak_stacks mode */
+        /** Object type filter */
         object_type?: string;
-        /** Max results to return (default 15) */
+        /** Max results to return */
         top_n?: number;
     };
     propose_variant: {
@@ -686,7 +691,7 @@ export interface ArgentToolArgs {
         };
     };
     "react-profiler-analyze": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
@@ -696,9 +701,9 @@ export interface ArgentToolArgs {
         platform?: "ios" | "android";
         /** React Native version (e.g. "0.73.4") */
         rn_version?: string;
-        /** Optional list of user actions with their time offset from profiling start. Compute offsetMs = tapTimestampMs - startedAtEpochMs, where tapTimestampMs comes from the tap/swipe tool return value and startedAtEpochMs comes from react-profiler-start return value. */
+        /** User actions to annotate the report's commits with: each commit shows the action that preceded it. */
         annotations?: Array<{
-            /** Milliseconds since profiling started. Compute as: tapTimestampMs - startedAtEpochMs, using the timestampMs returned by tap/swipe and the startedAtEpochMs returned by react-profiler-start. */
+            /** Milliseconds since profiling started: tapTimestampMs - startedAtEpochMs, where tapTimestampMs is the timestampMs a tap/swipe tool returned and startedAtEpochMs is the value react-profiler-start returned. */
             offsetMs: number;
             /** Description of the action performed */
             label: string;
@@ -711,51 +716,51 @@ export interface ArgentToolArgs {
         project_root: string;
     };
     "react-profiler-cpu-summary": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
-        /** Number of top hotspot functions to return (default 20) */
+        /** Number of top hotspot functions to return */
         top_n?: number;
         /** If true, only show React component functions (PascalCase names) */
         react_only?: boolean;
     };
     "react-profiler-fiber-tree": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
-        /** Maximum tree depth to traverse (default 10) */
+        /** Maximum tree depth to traverse */
         max_depth?: number;
         /** Regex string to filter component names */
         filter?: string;
     };
     "react-profiler-renders": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
-        /** Number of top re-rendering components to return (default 20) */
+        /** Number of components to return */
         top_n?: number;
     };
     "react-profiler-start": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial). */
         device_id: string;
-        /** CPU sampling interval in microseconds (default 100) */
+        /** CPU sampling interval in microseconds */
         sample_interval_us?: number;
         /** Take over an active profiling session even when it is owned by another tool-server and still fresh. Set to true only when you know the prior owner is gone. */
         force?: boolean;
     };
     "react-profiler-status": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId). */
         device_id: string;
     };
     "react-profiler-stop": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices: the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial). */
         device_id: string;
@@ -763,7 +768,7 @@ export interface ArgentToolArgs {
     "reinstall-app": {
         /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
         udid: string;
-        /** App identifier that matches the bundle at `appPath`. iOS: bundle id (used to uninstall first). Android: package name (used to uninstall first; the install itself identifies the app from the APK). Vega: interactive component app id (e.g. com.example.app.main), used to uninstall first. HarmonyOS: bundle name, which must match `app.bundleName` in the `.hap`. */
+        /** App identifier, used to uninstall the previous installation. iOS: bundle id. Android: package name. Vega: interactive component app id (e.g. com.example.app.main). HarmonyOS: bundle name (`app.bundleName` in the `.hap`). */
         bundleId: string;
         /** Path to the app bundle. iOS: `.app` directory (e.g. ./build/.../MyApp.app). Android: `.apk` file (e.g. android/app/build/outputs/apk/debug/app-debug.apk). Vega: `.vpkg` file. HarmonyOS: `.hap` file. Relative paths are resolved from the current working directory. */
         appPath: string;
@@ -771,11 +776,11 @@ export interface ArgentToolArgs {
     "restart-app": {
         /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
         udid: string;
-        /** App identifier. iOS: bundle id. Android: package name. HarmonyOS: bundle name. */
+        /** App identifier. iOS: bundle id. Android: package name. Vega: interactive component app id. HarmonyOS: bundle name. */
         bundleId: string;
-        /** Android-only: relaunch a non-launcher Activity (e.g. `.SettingsActivity` or `com.example/com.example.SettingsActivity`). If omitted, the app's default launcher activity is used. Ignored on iOS / HarmonyOS. */
+        /** Android-only: relaunch a non-launcher Activity (e.g. `.SettingsActivity` or `com.example/com.example.SettingsActivity`). If omitted, the app's default launcher activity is used. */
         activity?: string;
-        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. Ignored on other targets. */
+        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. */
         launchArgs?: Array<string>;
     };
     rotate: {
@@ -789,7 +794,7 @@ export interface ArgentToolArgs {
         udid: string;
         /** Ordered list of interaction steps to execute sequentially */
         steps: Array<{
-            /** Tool name, one of: gesture-tap, gesture-swipe, gesture-scroll, gesture-drag, gesture-custom, gesture-pinch, gesture-rotate, button, keyboard, paste, rotate, shake, fold, tv-remote, await-ui-element. On a TV target (Apple TV / Android TV / Vega) use tv-remote (remote presses) and keyboard (text). */
+            /** Tool name: one of the allowed tools listed in the description. */
             tool: string;
             /** Tool arguments (excluding udid, which is injected automatically) */
             args: {
@@ -802,11 +807,11 @@ export interface ArgentToolArgs {
     "screen-recording-start": {
         /** Target device id from `list-devices` (iOS Simulator UDID or Android serial). */
         udid: string;
-        /** Auto-stop cap in seconds (default 180, max 600). Set it to slightly more than the interaction you plan to capture. */
+        /** Auto-stop cap in seconds (default 180). Set it to slightly more than the interaction you plan to capture. */
         timeLimitSeconds?: number;
-        /** Default true. Collapse stretches where the screen does not change: the first second of each still stretch is kept, then unchanged frames are dropped until something moves again, so a long recording with brief activity comes back short instead of full of dead air (on a remote simulator the still stretches are removed whole). The returned durationMs is the trimmed length; wallClockMs/trimmedMs report what was removed. Set false to keep a faithful real-time recording. */
+        /** Default true. Collapse stretches where the screen does not change: the first second of each still stretch is kept, then unchanged frames are dropped until something moves again, so a long recording with brief activity comes back short instead of full of dead air. Set false to keep a faithful real-time recording. */
         trimStatic?: boolean;
-        /** Default true. Draw simulator-server's touch visualizer into the recording: a pulse marks each tap, a comet trail follows swipes and drags, and paired markers show two-finger pinch/rotate, so the video makes clear where every interaction landed. On remote (`remote:`) simulators the overlay is drawn on the runner and is also visible in the live stream until the recording stops. Set false to record the raw screen with no overlay. */
+        /** Default true. Draw an on-screen marker for every tap, swipe, drag, pinch and rotate into the video, so it shows where each interaction landed. Set false to record the raw screen with no overlay. */
         showTouches?: boolean;
     };
     "screen-recording-stop": {
@@ -816,29 +821,29 @@ export interface ArgentToolArgs {
     screenshot: {
         /** Target device id from `list-devices` (iOS UDID, Android serial, Apple TV UDID, Vega serial, HarmonyOS id, or Chromium id). */
         udid: string;
-        /** Orientation override for the screenshot (rotates the captured image after Page.captureScreenshot on Chromium). On Android the capture already follows the device's rotation. Rejected on HarmonyOS, which captures the display in its current orientation and has no override. Ignored on physical iPhones. */
+        /** Orientation override for the screenshot (on Chromium it rotates the captured image). On Android the capture already follows the device's rotation. Rejected on HarmonyOS, which captures the display in its current orientation and has no override. Ignored on physical iPhones. */
         rotation?: "Portrait" | "LandscapeLeft" | "LandscapeRight" | "PortraitUpsideDown";
-        /** Scale factor (0.01-1.0). Defaults to ARGENT_SCREENSHOT_SCALE env var, or 0.25 if unset for iOS/Android/HarmonyOS. On a local Apple TV simulator, an Android TV or Vega, with neither set, the capture is downscaled to a 576 px long side (0.15 of a 4K capture); an Android TV whose form factor or display size cannot be read in time keeps 0.25. On Chromium the default is 1.0 (no downscale); pass <1 to opt in. Downscaling on Chromium requires the optional `sharp` dependency. */
+        /** Scale factor. Defaults to ARGENT_SCREENSHOT_SCALE env var, or 0.25 if unset for iOS/Android/HarmonyOS. On a local Apple TV simulator, an Android TV or Vega, with neither set, the capture is downscaled to a 576 px long side (0.15 of a 4K capture). On Chromium the default is 1.0 (no downscale); pass <1 to opt in. Downscaling on Chromium requires the optional `sharp` dependency. */
         scale?: number;
-        /** Default true. Set false only when capturing a full-resolution PNG (scale: 1.0) to save as a baseline/current for screenshot-diff. The file is still written, but the image bytes are not attached to the agent context. */
+        /** Set false only when capturing a full-resolution PNG (scale: 1.0) to save as a baseline/current for screenshot-diff. The file is still written, but the image bytes are not attached to the agent context. */
         includeImageInContext?: boolean;
-        /** Downscaling algorithm when scale<1 on Chromium. Defaults to lanczos3 (highest quality). Mirrors sim-server's wire enum. Ignored on physical iPhones. */
+        /** Downscaling algorithm when scale<1 on Chromium. Defaults to lanczos3 (highest quality). Ignored on every other platform. */
         downscaler?: "lanczos3" | "box" | "bilinear" | "nearest";
     };
     "screenshot-diff": {
-        /** Path to the baseline PNG file. Required unless captureBaseline is true. */
+        /** Path to the saved baseline PNG file. Required unless captureBaseline is true; do not pass both. */
         baselinePath?: string;
-        /** Path to the current PNG file. Required unless captureCurrent is true. */
+        /** Path to the saved current PNG file. Required unless captureCurrent is true; do not pass both. */
         currentPath?: string;
         /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
         udid: string;
-        /** Capture the baseline screenshot live at full resolution before diffing. Cannot be combined with captureCurrent. */
+        /** Capture the baseline screenshot live from the device, at full resolution, before diffing. Cannot be combined with captureCurrent. */
         captureBaseline?: boolean;
-        /** Capture the current screenshot live at full resolution before diffing. Cannot be combined with captureBaseline. */
+        /** Capture the current screenshot live from the device, at full resolution, before diffing. Cannot be combined with captureBaseline. */
         captureCurrent?: boolean;
         /** Orientation override for live baseline/current captures. Rejected on HarmonyOS, which captures the display in its current orientation and has no override. Ignored on physical iPhones. */
         rotation?: "Portrait" | "LandscapeLeft" | "LandscapeRight" | "PortraitUpsideDown";
-        /** Directory where diff artifacts should be written. Optional: defaults to a temp directory; the diff images are returned in the result either way. */
+        /** Directory where diff artifacts should be written (default: a temp directory). The diff images are returned in the result either way. */
         outputDir?: string;
     };
     "settings-permissions": {
@@ -846,23 +851,23 @@ export interface ArgentToolArgs {
         udid: string;
         /** `grant` pre-authorizes the permission, `deny` refuses it, `reset` returns it to the not-yet-asked state so the app prompts on next use. */
         action: "grant" | "deny" | "reset";
-        /** The permission to change. `notifications` is Android-only (iOS has no simctl service for it); `reminders` is iOS-only; `camera` works on Android and on iOS only when the target simulator's runtime models the service (varies by simruntime, not by the installed Xcode). */
+        /** The permission to change. `notifications` is Android-only; `reminders` is iOS-only; `camera` works on Android, and on iOS only when the simulator's runtime models the service. */
         permission: "camera" | "microphone" | "photos" | "contacts" | "notifications" | "calendar" | "location" | "location-always" | "media-library" | "motion" | "reminders";
-        /** App to change the permission for, required for every action. iOS: bundle id (e.g. com.example.app). Android: package name. `reset` is per-app too: simctl's device-wide reset (no bundleId) silently leaves existing per-app grants untouched on recent iOS, so the permission is always reset for this one app. */
+        /** App to change the permission for; every action, `reset` included, applies to this app only. iOS: bundle id (e.g. com.example.app). Android: package name. */
         bundleId: string;
     };
     shake: {
         /** Target device id from `list-devices` (iOS simulator UDID or Android emulator serial). */
         udid: string;
-        /** How many shake gestures to deliver back-to-back (default 1, max 10). Raise it for apps whose shake detector needs sustained motion before it fires. */
+        /** How many shake gestures to deliver back-to-back (default 1). Raise it for apps whose shake detector needs sustained motion before it fires. */
         count?: number;
     };
     "stop-all-simulator-servers": {
-        /** Device ids (iOS UDID / Android serial / Chromium id) to scope the teardown to. Pass the devices THIS session actually used. Omit only for a deliberate machine-wide cleanup: one tool-server serves every agent using this argent install, so an unscoped stop also kills devices another agent is mid-session on. */
+        /** Ids of the devices THIS session used (iOS UDID / Android serial / Chromium id), to scope the teardown to. */
         devices?: Array<string>;
     };
     "stop-metro": {
-        /** TCP port Metro is listening on (default 8081) */
+        /** TCP port Metro is listening on */
         port?: number;
     };
     "stop-simulator-server": {
@@ -878,7 +883,7 @@ export interface ArgentToolArgs {
     "tv-remote": {
         /** Target TV device id from `list-devices` (Apple TV, Android TV, or Vega). */
         udid: string;
-        /** A single TV-remote button, or a path of them run in one call. Buttons: up/down/left/right (D-pad), select (OK), back, home, menu, playPause, rewind, fastForward, next, previous, volumeUp, volumeDown, mute. The media-transport and volume keys work on Android TV and Vega; on the Apple TV simulator they are rejected (its HID stack ignores them). The D-pad/select/back/menu/home/playPause core works on all three. For multi-step navigation pass an array, e.g. ["up","right","right","select"]; strongly prefer this over multiple `tv-remote` calls: the whole path runs in a single call. */
+        /** A single TV-remote button, or a path of them run in one call. Move focus with up/down/left/right, confirm with select, go back with back/menu, exit with home; the media and volume buttons press the matching remote keys. For multi-step navigation pass an array, e.g. ["up","right","right","select"]; strongly prefer this over multiple `tv-remote` calls: the whole path runs in a single call. */
         button: "up" | "down" | "left" | "right" | "select" | "back" | "home" | "menu" | "playPause" | "rewind" | "fastForward" | "next" | "previous" | "volumeUp" | "volumeDown" | "mute" | Array<"up" | "down" | "left" | "right" | "select" | "back" | "home" | "menu" | "playPause" | "rewind" | "fastForward" | "next" | "previous" | "volumeUp" | "volumeDown" | "mute">;
         /** Repeat the whole `button` value this many times (default 1). Compact for long same-button runs, e.g. { button: "down", repeat: 12 }. */
         repeat?: number;
@@ -892,7 +897,7 @@ export interface ArgentToolArgs {
         target?: "auto" | "global" | "local" | "both";
     };
     "view-network-logs": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices (iOS simulator UDID or Android serial), the same id used with debugger-connect. */
         device_id: string;
@@ -900,13 +905,13 @@ export interface ArgentToolArgs {
         pageIndex?: number | "latest";
     };
     "view-network-request-details": {
-        /** Metro server port. Optional: omit it to use this device's port, 8081 by default. Ignored for Chromium, whose CDP port is encoded in device_id. */
+        /** Metro port. Omit it to use this device's port (8081 by default). Ignored for Chromium, whose CDP port is in device_id. */
         port?: number;
         /** Device id from list-devices (iOS simulator UDID or Android serial), the same id used with debugger-connect. An android- ID needs no debugger connection. */
         device_id: string;
-        /** The requestId from view-network-logs, or an android- ID from native-network-logs */
+        /** The requestId from view-network-logs, or an android- ID from native-network-logs. */
         requestId: string;
-        /** Whether to include the response body (if captured). Defaults to true. */
+        /** Whether to include the response body (if captured). */
         includeBody?: boolean;
     };
     /** @deprecated Renamed to `e2e-add-echo`. */