@swmansion/argent 0.32.1-next.13 → 0.32.1-next.15

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

@@ -1,6 +1,6 @@
 export interface ArgentToolArgs {
     "await-screen-idle": {
-        /** 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, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
         /** Max time to wait for the screen to settle before giving up (default 3000). */
         timeoutMs?: number;
@@ -10,9 +10,9 @@ export interface ArgentToolArgs {
         minStableMs?: number;
     };
     "await-ui-element": {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
-        /** 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. */
+        /** 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. On a Mac app, a match in an open menu comes first, then one in an alert, sheet or popover, then one in the window. */
         condition: "exists" | "visible" | "hidden" | "text";
         /** Element to match. Give at least one field; every given field must match. */
         selector: {
@@ -39,7 +39,7 @@ export interface ArgentToolArgs {
         timeoutSeconds?: number;
     };
     "boot-device": {
-        /** iOS: simulator UDID to boot (from `list-devices`). */
+        /** iOS: simulator UDID to boot (from `list-devices`). A Mac app id (`macos-app-<bundle id>`) starts that app again from its last path. */
         udid?: string;
         /** Android: AVD name to launch a new emulator from (from `list-devices` → `avds[].name`). */
         avdName?: string;
@@ -49,7 +49,7 @@ export interface ArgentToolArgs {
         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. */
         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 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. */
+        /** 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). On a Mac app it quits and restarts the app, also a copy of the same build running without the argent library: that copy loses its unsaved changes. When the app argent runs answers the quit with a save prompt, the call fails and the app keeps running. Force never quits a copy of another build (another .app path). Ignored for Electron, which always spawns a fresh process. */
         force?: boolean;
         /** 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;
@@ -63,6 +63,10 @@ export interface ArgentToolArgs {
         electronPort?: number;
         /** Electron-only: extra CLI arguments forwarded to the Electron binary after the app path. */
         electronArgs?: Array<string>;
+        /** Mac app: path to the .app bundle to start with the argent library; its device id is `macos-app-<bundle id>`. A Release build with the hardened runtime cannot be driven; a hardened Debug build needs the step the error names. */
+        macosAppPath?: string;
+        /** Mac app only: arguments for the app executable. Omitted, the app starts with none, also when an earlier start had some. */
+        macosAppArgs?: Array<string>;
     };
     button: {
         /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
@@ -183,7 +187,7 @@ export interface ArgentToolArgs {
         device_id: string;
     };
     describe: {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
         /** 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;
@@ -231,10 +235,10 @@ export interface ArgentToolArgs {
         e2e_test_file?: string;
         /** 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` 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 id to run against (iOS UDID, Android/Vega serial, Chromium id, Mac app 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; `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";
+        /** 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> }`. `macos` with no `device` runs a standalone e2e test on the Mac app its `launch` names, which need not be running (a single-key `launch: { macos: … }` map does this on its own). Auto-detection never picks a Mac app otherwise. */
+        platform?: "ios" | "android" | "chromium" | "vega" | "macos" | "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. 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 when a fragment defines an executionPrerequisite. */
@@ -273,10 +277,28 @@ export interface ArgentToolArgs {
         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">;
+            platform?: "ios" | "android" | "chromium" | "vega" | "macos" | Array<"ios" | "android" | "chromium" | "vega" | "macos">;
             runtimeKind?: "mobile" | "tv";
         };
     };
+    "file-panel": {
+        /** Mac app id from `list-devices` (macos-app-<bundle id>). */
+        udid: string;
+        /** list: the open file panels. choose: answer a panel with path or paths. cancel: cancel a panel. discard: answer a panel with its Delete or Don't Save button. stub: arm an answer or a cancel for the next panel the app presents (stubMode). */
+        action: "list" | "choose" | "cancel" | "discard" | "stub";
+        /** For choose and stub: the absolute path to answer with (a leading ~/ is your home folder). An open panel takes an existing file or folder; a save panel takes the file to write, in an existing folder. A save panel answer replaces an existing file at that path without the replace prompt a user gets: check the path first. */
+        path?: string;
+        /** For choose and stub: several absolute paths, for an open panel that allows a multiple selection. Instead of path. */
+        paths?: Array<string>;
+        /** For choose, cancel and discard: the panel's number from list. Needed only when more than one panel is open. */
+        panel?: number;
+        /** For stub: answer the next panel with path or paths (default), cancel it, or off to disarm a stub that is still armed. */
+        stubMode?: "answer" | "cancel" | "off";
+        /** For stub with stubMode answer: the kind of panel the answer is for, which also decides the path checks. Default: open when every path exists, save when the one path does not exist yet. */
+        panelKind?: "open" | "save";
+        /** For choose, cancel and discard: how long to wait for a panel to appear after the click that opens it (default 5000). */
+        timeoutMs?: number;
+    };
     fill: {
         /** Target device id from `list-devices`. */
         udid: string;
@@ -321,7 +343,7 @@ export interface ArgentToolArgs {
         interpolate?: number;
     };
     "gesture-drag": {
-        /** Target Chromium device id from `list-devices` (chromium-cdp-<port>). */
+        /** Target Chromium device id from `list-devices` (chromium-cdp-<port>), or a Mac app id. */
         udid: string;
         /** Press x. */
         fromX: number;
@@ -331,7 +353,7 @@ export interface ArgentToolArgs {
         toX: number;
         /** Release y. */
         toY: number;
-        /** Total drag duration in milliseconds (default 300); the button stays down this long. */
+        /** Total drag duration in milliseconds (default 300, 800 for a long press on a Mac app); the button stays down this long. */
         durationMs?: number;
         /** 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;
@@ -377,7 +399,7 @@ export interface ArgentToolArgs {
         durationMs?: number;
     };
     "gesture-scroll": {
-        /** Target Chromium device id from `list-devices` (chromium-cdp-<port>). */
+        /** Target Chromium device id from `list-devices` (chromium-cdp-<port>), or a Mac app id. */
         udid: string;
         /** Anchor x. The wheel events land here; put it over the element you want to scroll. */
         x: number;
@@ -387,7 +409,7 @@ export interface ArgentToolArgs {
         deltaX?: number;
         /** 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. */
+        /** Spread the scroll over this many milliseconds in wheel-event steps (default 300) so scroll handlers fire progressively. Ignored on a Mac app. */
         durationMs?: number;
     };
     "gesture-swipe": {
@@ -407,7 +429,7 @@ export interface ArgentToolArgs {
         momentum?: boolean;
     };
     "gesture-tap": {
-        /** 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, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
         /** Horizontal position: 0 = left edge, 1 = right edge. */
         x: number;
@@ -415,32 +437,44 @@ export interface ArgentToolArgs {
         y: number;
         /** 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;
+        /** Mouse button, Mac app only: "right" is a right-click, for example to open a context menu; any other device refuses it. Default "left". */
+        button?: "left" | "right";
     };
     keyboard: {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
         /** 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`; 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. */
+        /** 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. Mac app: also delete (forward delete), home, end, page-up, page-down, and shortcuts with modifiers joined by + (command, shift, option, control), e.g. command+a. */
         key?: string;
         /** 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). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
-        /** 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. */
+        /** 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. Mac app: the bundle id in the device id. */
         bundleId: string;
         /** 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. 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. */
+        /** Apple simulators, Mac apps 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, except a Mac app: use restart-app for that. Omitted on a Mac app, a stopped app gets the arguments of its last start. 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>;
+    "menu-bar": {
+        /** Mac app id from `list-devices` (macos-app-<bundle id>). */
+        udid: string;
+        /** list: the app's menu bar, one line per item. choose: run one menu item, by path or identifier. */
+        action: "list" | "choose";
+        /** For choose: the titles from the menu bar down to the item, as list shows them, e.g. ["File", "Export..."]. Case and "..." versus "…" do not matter. */
+        path?: Array<string>;
+        /** For choose: the item's id="..." from list, instead of path. */
+        identifier?: string;
+    };
     "native-describe-screen": {
-        /** Simulator UDID */
+        /** Simulator UDID, or a Mac app id (macos-app-<bundle id>) */
         udid: string;
-        /** Bundle ID of the app */
+        /** Bundle ID of the app (on a Mac app, the bundle id in the device id) */
         bundleId: string;
         /** Exact UIView class names whose entire subtree should be pruned (e.g. ["UIImageView"] to drop image-heavy branches) */
         skipClasses?: Array<string>;
@@ -454,9 +488,9 @@ export interface ArgentToolArgs {
         bundleId: string;
     };
     "native-find-views": {
-        /** Simulator UDID */
+        /** Simulator UDID, or a Mac app id (macos-app-<bundle id>) */
         udid: string;
-        /** Bundle ID of the app */
+        /** Bundle ID of the app (on a Mac app, the bundle id in the device id) */
         bundleId: string;
         /** UIView class name to match (exact, e.g. UIButton) */
         className?: string;
@@ -476,9 +510,9 @@ export interface ArgentToolArgs {
         fields?: Array<string>;
     };
     "native-full-hierarchy": {
-        /** Simulator UDID */
+        /** Simulator UDID, or a Mac app id (macos-app-<bundle id>) */
         udid: string;
-        /** Bundle ID of the app */
+        /** Bundle ID of the app (on a Mac app, the bundle id in the device id) */
         bundleId: string;
         /** View fields to include. Use EXACT names: className, frame, hidden, alpha, identifier, label, nativeID, userInteractionEnabled, depth, pointer, tag, windowFrame, screenFrame, bounds, center, opaque, clipsToBounds, transform, contentMode, backgroundColor, tintColor, layerName. Defaults to all of the first group when omitted. */
         fields?: Array<string>;
@@ -490,9 +524,9 @@ export interface ArgentToolArgs {
         maxDepth?: number;
     };
     "native-network-logs": {
-        /** Device ID from list-devices: an iOS simulator UDID or Android serial */
+        /** Device ID from list-devices: an iOS simulator UDID or Android serial, or a Mac app id (macos-app-<bundle id>) */
         udid: string;
-        /** App bundle ID on iOS or package name on Android */
+        /** App bundle ID on iOS or package name on Android (on a Mac app, the bundle id in the device id) */
         bundleId: string;
         /** Android only: the app's Metro port, whose requests are left out of the listing. Omit it to use this device's port, 8081 by default. */
         port?: number;
@@ -522,11 +556,11 @@ export interface ArgentToolArgs {
         device_id: string;
     };
     "native-user-interactable-view-at-point": {
-        /** Simulator UDID */
+        /** Simulator UDID, or a Mac app id (macos-app-<bundle id>) */
         udid: string;
-        /** Bundle ID of the app */
+        /** Bundle ID of the app (on a Mac app, the bundle id in the device id) */
         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. */
+        /** Raw X coordinate in points, on the portrait axes of the screen (the axes of native-describe-screen frames); on a Mac app, points from the top-left of the area describe reports. NOT normalized [0,1] tap space. */
         x: number;
         /** Raw Y coordinate in points, on the same axes as x. NOT normalized [0,1] tap space. */
         y: number;
@@ -544,11 +578,11 @@ export interface ArgentToolArgs {
         maxDepth?: number;
     };
     "native-view-at-point": {
-        /** Simulator UDID */
+        /** Simulator UDID, or a Mac app id (macos-app-<bundle id>) */
         udid: string;
-        /** Bundle ID of the app */
+        /** Bundle ID of the app (on a Mac app, the bundle id in the device id) */
         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. */
+        /** Raw X coordinate in points, on the portrait axes of the screen (the axes of native-describe-screen frames); on a Mac app, points from the top-left of the area describe reports. NOT normalized [0,1] tap space. */
         x: number;
         /** Raw Y coordinate in points, on the same axes as x. NOT normalized [0,1] tap space. */
         y: number;
@@ -574,7 +608,7 @@ export interface ArgentToolArgs {
         bundleId?: string;
     };
     paste: {
-        /** Target device id from `list-devices` (iOS simulator UDID or Android emulator serial). */
+        /** Target device id from `list-devices` (iOS simulator UDID or Android emulator serial, or Mac app id). */
         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`), 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;
@@ -774,13 +808,13 @@ export interface ArgentToolArgs {
         appPath: string;
     };
     "restart-app": {
-        /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial). */
+        /** Target device id from `list-devices` (iOS UDID, Mac app id, HarmonyOS id, or Android serial). */
         udid: string;
-        /** App identifier. iOS: bundle id. Android: package name. Vega: interactive component app id. HarmonyOS: bundle name. */
+        /** App identifier. iOS: bundle id. Android: package name. Vega: interactive component app id. HarmonyOS: bundle name. Mac app: the bundle id in the device id. */
         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. */
         activity?: string;
-        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. */
+        /** Apple simulators, Mac apps and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. Omitted on a Mac app, the app gets the arguments of its last start. */
         launchArgs?: Array<string>;
     };
     rotate: {
@@ -790,7 +824,7 @@ export interface ArgentToolArgs {
         orientation: "Portrait" | "LandscapeLeft" | "LandscapeRight" | "PortraitUpsideDown";
     };
     "run-sequence": {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id), shared across all steps. */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, Mac app id, or Chromium id), shared across all steps. */
         udid: string;
         /** Ordered list of interaction steps to execute sequentially */
         steps: Array<{
@@ -819,11 +853,11 @@ export interface ArgentToolArgs {
         udid: string;
     };
     screenshot: {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, Apple TV UDID, Vega serial, HarmonyOS id, or Chromium id). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Apple TV UDID, Vega serial, HarmonyOS id, Mac app id, or Chromium id). */
         udid: string;
         /** 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. 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 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. On a Mac app the default is one pixel per window point, downscaled to a 768 px long side for a larger window. */
         scale?: number;
         /** 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;
@@ -835,7 +869,7 @@ export interface ArgentToolArgs {
         baselinePath?: string;
         /** 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). */
+        /** Target device id from `list-devices` (iOS UDID, HarmonyOS id, or Android serial, or a Mac app id). */
         udid: string;
         /** Capture the baseline screenshot live from the device, at full resolution, before diffing. Cannot be combined with captureCurrent. */
         captureBaseline?: boolean;