@zenalexa/unicli 0.216.3 → 0.217.3

package/dist/transport/types.d.ts

@@ -16,6 +16,8 @@
  *    matching transport/step to fix.
  */
 import type { Envelope } from "../core/envelope.js";
+import type { RefStore } from "./refs.js";
+import type { SnapshotEncoding } from "./snapshot-encoder.js";
 /**
  * The seven transports that together cover the full "operate anything"
  * surface. A transport is a physical execution channel; a strategy
@@ -31,6 +33,7 @@ export type SnapshotFormat = "dom-ax" | "os-ax" | "screenshot" | "text" | "json"
 /** Uniform snapshot shape returned by {@link TransportAdapter.snapshot}. */
 export interface Snapshot {
     format: SnapshotFormat;
+    encoding?: SnapshotEncoding;
     data: string | Buffer;
     width?: number;
     height?: number;
@@ -92,6 +95,7 @@ export interface TransportEvent {
  * to `cua` on non-trivial perception tasks).
  */
 export interface TransportBus {
+    refs: RefStore;
     register(adapter: TransportAdapter): void;
     get(kind: TransportKind): TransportAdapter;
     /**
@@ -119,6 +123,7 @@ export interface TransportContext {
     vars: Record<string, unknown>;
     signal?: AbortSignal;
     bus: TransportBus;
+    refs?: RefStore;
 }
 /**
  * The core interface every transport implements.
@@ -136,7 +141,7 @@ export interface TransportAdapter {
     readonly capability: Capability;
     open(ctx: TransportContext): Promise<void>;
     snapshot(opts?: {
-        format?: SnapshotFormat;
+        format?: SnapshotFormat | SnapshotEncoding;
         fresh?: boolean;
     }): Promise<Snapshot>;
     action<T = unknown>(req: ActionRequest): Promise<ActionResult<T>>;

package/dist/transport/types.d.ts.map

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

package/dist/types.d.ts

@@ -22,6 +22,7 @@ export declare enum Strategy {
     INTERCEPT = "intercept",
     UI = "ui"
 }
+export type TargetSurface = "web" | "desktop" | "system" | "mobile";
 export interface AdapterArg {
     name: string;
     type?: "str" | "int" | "float" | "bool";
@@ -70,6 +71,13 @@ export interface PipelineStep {
 export interface AdapterCommand {
     name: string;
     description?: string;
+    /** Source adapter file used in repair and evidence-bearing error envelopes. */
+    adapter_path?: string;
+    /**
+     * Runtime target surface. TS helper commands can operate on desktop apps
+     * even when their registration helper keeps the site in a web-api manifest.
+     */
+    target_surface?: TargetSurface;
     /**
      * When true, the adapter is quarantined: skipped by `unicli test` and the
      * CI conformance suite, and shown with a `[quarantined]` tag in `unicli list`.
@@ -97,6 +105,8 @@ export interface AdapterCommand {
     adapterArgs?: AdapterArg[];
     strategy?: Strategy;
     browser?: boolean;
+    domain?: string;
+    base?: string;
     func?: (page: IPage, kwargs: Record<string, unknown>) => Promise<unknown>;
     method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
     path?: string;
@@ -229,7 +239,7 @@ export interface PipelineErrorDetail {
     step: number;
     action: string;
     config: unknown;
-    errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "timeout" | "expression_error" | "assertion_failed" | "stale_ref" | "ambiguous" | "ref_not_found";
+    errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "stale_ref" | "ambiguous" | "ref_not_found";
     url?: string;
     statusCode?: number;
     responsePreview?: string;

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,qBAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AA4RD,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;AACrB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,6BAAiB,CAAA;IACjB,mCAAuB,CAAA;IACvB,qBAAS,CAAA;AACX,CAAC,EANW,QAAQ,KAAR,QAAQ,QAMnB;AAwSD,sCAAsC;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;IACvB,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,YAAY,EAAE,EAAE;CACR,CAAC"}

package/docs/mcp/clients/claude-code.md

@@ -0,0 +1,29 @@
+# Claude Code Computer Use
+
+Register Uni-CLI as the `computer-use` MCP server for Claude Code:
+
+```bash
+claude mcp add computer-use \
+  -- npx -y @zenalexa/unicli mcp serve --profile computer-use
+```
+
+The profile exposes only the 15 local computer-control tools:
+`computer-use.apps`, `computer-use.windows`, `computer-use.snapshot`,
+`computer-use.find`, `computer-use.click`, `computer-use.type`,
+`computer-use.press`, `computer-use.scroll`, `computer-use.launch`,
+`computer-use.screenshot`, `computer-use.attach`, `computer-use.evaluate`,
+`computer-use.wait`, `computer-use.observe`, and `computer-use.assert`.
+
+## Permissions
+
+On macOS, grant Accessibility to the terminal or app that launches Claude Code.
+Grant Screen Recording if you want screenshot fallback. Windows and Linux use
+the UIA and AT-SPI sidecars respectively.
+
+## Verify
+
+```bash
+npx -y @zenalexa/unicli mcp serve --profile computer-use
+```
+
+The server banner should report `15 tools registered, mode=computer-use`.

package/docs/mcp/clients/claude-desktop.md

@@ -0,0 +1,47 @@
+# Claude Desktop Computer Use
+
+Use the `computer-use` MCP profile when Claude Desktop should control local
+apps through Uni-CLI's compute layer.
+
+```jsonc
+// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
+// Windows: %APPDATA%\Claude\claude_desktop_config.json
+{
+  "mcpServers": {
+    "computer-use": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@zenalexa/unicli",
+        "mcp",
+        "serve",
+        "--profile",
+        "computer-use",
+        "--transport",
+        "stdio",
+      ],
+    },
+  },
+}
+```
+
+Restart Claude Desktop after editing the config.
+
+## Permissions
+
+macOS requires Accessibility for structured app control. Screenshot fallback
+also requires Screen Recording. Grant both to Claude Desktop, Terminal, or the
+launcher that starts the MCP server.
+
+Windows uses UI Automation through the Uni-CLI sidecar. Linux uses AT-SPI and
+requires the desktop accessibility bus to be available.
+
+## Verify
+
+Run this outside Claude first:
+
+```bash
+npx -y @zenalexa/unicli mcp serve --profile computer-use
+```
+
+The server banner should report `15 tools registered, mode=computer-use`.

package/docs/mcp/clients/codex.md

@@ -0,0 +1,29 @@
+# Codex Computer Use
+
+Codex desktop can already have its own `computer-use` plugin. To swap the MCP
+server name to Uni-CLI while keeping compatible tool names, configure:
+
+```toml
+# ~/.codex/mcp.toml
+[mcp.servers.computer-use]
+command = "npx"
+args = ["-y", "@zenalexa/unicli", "mcp", "serve", "--profile", "computer-use"]
+```
+
+Existing prompts that call `computer-use.*` tools can keep the same prefix.
+Uni-CLI routes the calls through the cross-platform compute cascade: macOS AX,
+Windows UIA, Linux AT-SPI, CDP for Electron targets, then configured fallbacks.
+
+## Permissions
+
+On macOS, grant Accessibility to Codex or to the terminal process that launches
+the MCP server. Grant Screen Recording for screenshot fallback. Windows and
+Linux require the platform accessibility services used by UIA and AT-SPI.
+
+## Verify
+
+```bash
+npx -y @zenalexa/unicli mcp serve --profile computer-use
+```
+
+The server banner should report `15 tools registered, mode=computer-use`.

package/docs/mcp/clients/cursor.md

@@ -0,0 +1,38 @@
+# Cursor Computer Use
+
+Use a project-level `.cursor/mcp.json` or global `~/.cursor/mcp.json` entry:
+
+```jsonc
+{
+  "mcpServers": {
+    "computer-use": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@zenalexa/unicli",
+        "mcp",
+        "serve",
+        "--profile",
+        "computer-use",
+      ],
+    },
+  },
+}
+```
+
+Restart Cursor or reload MCP servers after changing the file.
+
+## Permissions
+
+macOS requires Accessibility for AX control and Screen Recording for screenshot
+fallback. Grant permissions to Cursor if it launches the server directly, or to
+the terminal/shell process that starts the MCP server. Windows and Linux use the
+UIA and AT-SPI sidecars.
+
+## Verify
+
+```bash
+npx -y @zenalexa/unicli mcp serve --profile computer-use
+```
+
+The server banner should report `15 tools registered, mode=computer-use`.

package/docs/mcp/clients/gemini-cli.md

@@ -0,0 +1,38 @@
+# Gemini CLI Computer Use
+
+Add Uni-CLI's `computer-use` MCP profile to Gemini CLI settings:
+
+```jsonc
+// ~/.gemini/settings.json
+{
+  "mcpServers": {
+    "computer-use": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@zenalexa/unicli",
+        "mcp",
+        "serve",
+        "--profile",
+        "computer-use",
+      ],
+    },
+  },
+}
+```
+
+Restart Gemini CLI after editing settings.
+
+## Permissions
+
+On macOS, grant Accessibility to the terminal that launches Gemini CLI. Grant
+Screen Recording if screenshot fallback is needed. Windows and Linux use the
+UIA and AT-SPI sidecars respectively.
+
+## Verify
+
+```bash
+npx -y @zenalexa/unicli mcp serve --profile computer-use
+```
+
+The server banner should report `15 tools registered, mode=computer-use`.

package/docs/operate/compute.md

@@ -0,0 +1,172 @@
+# Compute
+
+`unicli compute` is the local computer-control surface. It routes each request
+through the fastest available structured transport first, then falls back to
+broader transports when needed.
+
+Transport order is selected per verb and host platform:
+
+- macOS: Accessibility first for app control, CDP for browser/Electron renderers,
+  CUA as the visual fallback.
+- Windows: UIA first once the sidecar is present, CDP next where available, CUA
+  as fallback.
+- Linux: AT-SPI first once the sidecar is present, CDP next where available,
+  CUA as fallback.
+
+## Snapshot, Find, Click
+
+```bash
+unicli compute snapshot --app Calculator --format compact
+unicli compute find --role button --name 5
+unicli compute find --role input --text 8 --first
+unicli compute click @e7
+```
+
+Snapshots return compact element refs such as `@e7`. The latest ref bucket is
+kept by the transport bus so follow-up actions can dereference aliases without
+coordinates. When a structured transport reports bounds, the refs preserve
+screen-relative coordinates and `screenIndex` so follow-up actions can target
+the same monitor in multi-display setups.
+When a snapshot node includes a visible/current value, compact output and stored
+refs preserve it, and `compute find --text <text>` can match that value. This is
+useful for calculator displays, address fields, editors, and status labels
+whose value is not part of the accessible name.
+
+## Commands
+
+| Command                                           | Purpose                                            |
+| ------------------------------------------------- | -------------------------------------------------- |
+| `compute apps`                                    | List running apps                                  |
+| `compute windows --app <name>`                    | List windows                                       |
+| `compute snapshot --app <name> --format compact`  | Capture a compact/tree/json accessibility snapshot |
+| `compute find --role <role> --name/--text <text>` | Find matching refs by label or value               |
+| `compute click <ref>`                             | Click a ref                                        |
+| `compute type <ref> <text>`                       | Set or type text                                   |
+| `compute press <combo>`                           | Send a key combo                                   |
+| `compute scroll <ref>`                            | Scroll a ref                                       |
+| `compute launch <app>`                            | Launch an app                                      |
+| `compute screenshot [path]`                       | Capture a screenshot                               |
+| `compute attach --app <name>`                     | Attach CDP to a renderer                           |
+| `compute attach --app <name> --confirm-relaunch`  | Allow risky app relaunch for CDP attach            |
+| `compute eval <js>`                               | Evaluate JS in an attached renderer                |
+| `compute wait --ref <ref>`                        | Wait for an element/text/state                     |
+| `compute observe <goal>`                          | Rank refs for a natural-language goal              |
+| `compute assert --text <text>`                    | Assert visible state                               |
+
+## Output
+
+All commands use the normal Uni-CLI v2 envelope. Success writes to stdout; a
+failed cascade writes a structured error to stderr with the failing transport
+details and exits with the transport error code.
+
+`compute launch <app>` is routed through the subprocess transport first. It uses
+the host launcher command for the current OS: `open -a` on macOS,
+`Start-Process` through PowerShell on Windows, and `gtk-launch` on Linux.
+When `--debug-port <port>` is supplied, Uni-CLI passes
+`--remote-debugging-port=<port>` to the launched app for Electron CDP attach
+workflows. The native desktop fallbacks honor the same debug-port argument when
+the subprocess route is not available.
+The direct low-level UIA and AT-SPI sidecar `launch_app` actions are also
+implemented for sidecar callers: UIA uses PowerShell `Start-Process`, and
+AT-SPI uses `gtk-launch`. Cross-OS live launch smoke evidence is still pending.
+
+```bash
+unicli compute snapshot --app TextEdit -f json
+```
+
+Failures include a `minimum_capability` key and may include a structured
+`remedy` with a command or deeplink. See
+[Compute Troubleshooting](troubleshooting.md) for the remedy catalog.
+
+## Live Smoke
+
+Maintainers can generate the cross-OS smoke plan without touching the host:
+
+```bash
+npm run compute:smoke -- --json --platform linux
+```
+
+To execute it on a real target machine, run:
+
+```bash
+npm run compute:smoke -- --run --include-mutating --output smoke-report.json
+```
+
+The smoke harness uses a temporary ref store, checks `doctor compute`, lists
+apps, launches the platform calculator app, captures a compact snapshot, finds a
+button ref, waits for it, asserts it is enabled, clicks it with `--background`,
+exercises type/scroll routing, and captures a screenshot. Omit
+`--include-mutating` to skip launch/click/type/scroll steps while still
+collecting read-only evidence. For richer text-field or scroll-container
+coverage, override the app and target label with `--app` and `--button`.
+When `--run` is used, the harness records every step's `ok`, `exit_code`,
+duration, stdout, and stderr instead of aborting at the first failed command, so
+cross-OS smoke artifacts keep enough evidence for repair. `--output` writes the
+same schema-versioned report to disk for CI artifacts or manual release
+evidence.
+
+## Focus Stealing
+
+Actuating commands prefer background mode: `compute click`, `compute type`,
+`compute press`, and `compute scroll` pass `focus: false` to structured
+transports unless `--focus` is set. CUA remains the visual last-resort fallback;
+when the cascade reaches CUA, Uni-CLI treats the action as focus-taking because
+the backend may move the cursor or active surface.
+
+See [Compute Focus Behavior](focus-behavior.md) for the transport matrix and
+source links.
+
+Windows UIA uses native top-level inventory and live descendant traversal where
+available. Refs emitted from Windows snapshot/find can target `compute type`,
+`compute scroll`, `compute screenshot`, `compute wait`, and `compute assert`.
+Wait/assert use role/name/title/app/pid filters and descendant text/value/state
+checks when the UIA tree exposes them. `compute observe` ranks top-level and
+descendant refs by goal/title/name token overlap and marks scrollable
+descendants with `action: "scroll"` and slider/spinner/range descendants with
+`action: "set_value"`. Descendant invoke, value, focus, and scroll actions
+prefer native UIA patterns before bounded fallback paths; invoke also tries
+toggle and selection item patterns for controls such as checkboxes, radio
+buttons, and selectable list rows, while numeric set-value inputs can use
+RangeValuePattern for sliders and spinners.
+The UIA sidecar also supports direct app launch through PowerShell
+`Start-Process`; the public compute launch cascade still tries subprocess first.
+
+Linux AT-SPI uses `wmctrl -lG -p` where available and falls back to AT-SPI-only
+top-level registry roots when `wmctrl` is missing or empty. Refs emitted from
+Linux snapshot/find can target `compute click`, `compute type`, `compute
+scroll`, `compute screenshot`, `compute wait`, `compute observe`, and
+`compute assert`. Descendant click/type/focus prefer native AT-SPI
+Action/Value/EditableText/Component proxies before bounded display-server
+helpers; descendant scroll prefers native `Component.scroll_to(...)` before
+helper fallback. `compute observe` marks scrollable descendants with
+`action: "scroll"` and slider/spin-button/range descendants with
+`action: "set_value"`. Descendant screenshots capture the element rectangle
+when bounds are known. Top-level X11 screenshots use `import -window <id>` when
+a real window id exists, and Wayland/top-level bounds use `grim -g` when bounds
+are known.
+The AT-SPI sidecar also supports direct app launch through `gtk-launch`; the
+public compute launch cascade still tries subprocess first.
+
+## CDP Attach
+
+`compute attach --app <name>` resolves known Electron apps from the built-in
+registry and uses the app's assigned debug port. If the endpoint is not already
+listening, Uni-CLI launches the app with `--remote-debugging-port=<port>`,
+reprobes CDP, and then reuses that renderer for `compute eval`, snapshot, click,
+type, press, and scroll actions. App-based attach also persists the last CDP
+session under the Uni-CLI compute state directory so a later `compute eval` from
+a separate process can reconnect to the same renderer.
+
+Some apps are marked as unsafe to relaunch automatically because restarting them
+can interrupt signed-in workspace state. For those apps, attach refuses before
+launching and returns a structured error; rerun with `--confirm-relaunch` only
+when relaunching the app is acceptable.
+
+See [Electron App Control](electron.md) for app caveats and registry guidance.
+
+## Fallback Semantics
+
+The cascade stops on the first successful transport result. Failed transports
+are accumulated into one error envelope only when every candidate fails. This
+keeps normal operation low-latency while preserving enough evidence for
+`unicli doctor compute` and repair workflows.

package/docs/operate/electron.md

@@ -0,0 +1,87 @@
+# Electron App Control
+
+`unicli compute attach` makes Electron renderers scriptable through Chrome
+DevTools Protocol (CDP). Use it when accessibility snapshots miss web content
+inside apps such as VS Code, Slack, Discord, Notion, Figma, GitHub Desktop, or
+NeteaseMusic.
+
+## Attach
+
+```bash
+unicli compute attach --app vscode
+unicli compute eval "document.title"
+```
+
+Attach resolves the app in Uni-CLI's Electron registry, probes the assigned CDP
+port, launches the app with `--remote-debugging-port=<port>` when the endpoint
+is absent, then stores the active target under the compute state directory. A
+later `compute eval`, snapshot, click, type, press, scroll, or wait command can
+reuse that saved target from a separate process.
+
+Use an explicit port when the app is already running with a custom CDP port:
+
+```bash
+unicli compute attach --port 9333
+```
+
+## Relaunch Safety
+
+Apps marked with `relaunchLosesSession: true` require explicit confirmation:
+
+```bash
+unicli compute attach --app notion --confirm-relaunch
+```
+
+Use confirmation only when restarting that app is acceptable. Meeting apps,
+workspace apps, and document apps can interrupt active calls, reconnect
+workspaces, or refresh unsaved UI state during relaunch.
+
+## App Caveats
+
+| App             | Notes                                                                                      |
+| --------------- | ------------------------------------------------------------------------------------------ |
+| VS Code         | Renderer CDP uses `--remote-debugging-port=<port>`. Extension-host inspection is separate. |
+| Notion          | Requires `--confirm-relaunch` because workspace state can refresh.                         |
+| Teams / Zoom    | Avoid relaunch during calls. Attach to an already-debug-enabled instance when possible.    |
+| NeteaseMusic    | CDP-first inspection is preferred because the AX tree can be sparse.                       |
+| Slack / Discord | CDP exposes channel and message content that desktop accessibility can miss.               |
+
+## Manual Launch
+
+The registry handles launch for known apps. For manual debugging or a custom
+app, launch with a CDP port and then attach by port:
+
+```bash
+unicli compute launch Slack --debug-port 9241
+unicli compute attach --port 9241
+```
+
+The equivalent host command on macOS is:
+
+```bash
+open -a "Slack" --args --remote-debugging-port=9241
+unicli compute attach --port 9241
+```
+
+On Linux or Windows, start the app executable with the same
+`--remote-debugging-port=<port>` argument, then run `compute attach --port`.
+
+## Adding an App
+
+Add a profile in `src/electron-apps.ts` with:
+
+- unique `port`
+- `processName`
+- `bundleId` or `executableNames`
+- `displayName`
+- useful `aliases`
+- `contentHints`
+- `relaunchLosesSession: true` when relaunch can interrupt active user state
+
+Verify the change with:
+
+```bash
+npx vitest run --project unit tests/unit/electron-apps-table.test.ts
+unicli compute attach --app <id>
+unicli compute eval "document.title"
+```

package/docs/operate/focus-behavior.md

@@ -0,0 +1,40 @@
+# Compute Focus Behavior
+
+`unicli compute` defaults structured transports to `focus: false` for actuating
+verbs. Use `--focus` or `focus: true` only when the target app must be brought
+forward before the action can succeed. CUA is the visual fallback and is treated
+as focus-taking when the cascade reaches it.
+
+## Defaults
+
+| Verb                 | desktop-ax (macOS)                                                                                                                                                                 | desktop-uia (Windows)                                                                                                                                                                                                               | desktop-atspi (Linux)                                                                                                                                                                                                                                                             | cdp-browser                                                                                                                                     | cua                                                                                                                                         |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `compute click`      | Uses `AXUIElementPerformAction(..., AXPress)` without app activation. Proof: [desktop-ax-swift.ts](../../src/transport/adapters/desktop-ax-swift.ts).                              | Descendant refs prefer native UIA `InvokePattern.Invoke`, `TogglePattern.Toggle`, or `SelectionItemPattern.Select`, then fall back to bounded HWND `PostMessageW` click. Proof: [invoke.rs](../../crates/unicli-uia/src/invoke.rs). | Descendant refs prefer native AT-SPI `ActionProxy.do_action(0)`, then fall back to bounded X11/Wayland click helpers. Top-level X11 refs use `wmctrl`; AT-SPI-only synthetic refs use `ComponentProxy.grab_focus()`. Proof: [invoke.rs](../../crates/unicli-atspi/src/invoke.rs). | Uses the attached renderer page and does not activate the browser window. Proof: [cdp-browser.ts](../../src/transport/adapters/cdp-browser.ts). | Cascade passes `focus: true`; visual backend may move cursor or focus. Proof: [cua.ts](../../src/transport/adapters/cua.ts).                |
+| `compute type`       | Uses `AXUIElementSetAttributeValue` when possible, without activation. Proof: [desktop-ax-swift.ts](../../src/transport/adapters/desktop-ax-swift.ts).                             | Descendant refs prefer native UIA `ValuePattern.SetValue`; numeric values can fall through to `RangeValuePattern.SetValue` before bounded click plus `SendInput`. Proof: [invoke.rs](../../crates/unicli-uia/src/invoke.rs).        | Descendant refs prefer native AT-SPI `ValueProxy.set_current_value(...)` or `EditableTextProxy.set_text_contents(...)`, then fall back to display-server text helpers. Proof: [invoke.rs](../../crates/unicli-atspi/src/invoke.rs).                                               | Types through the attached renderer page. Proof: [cdp-browser.ts](../../src/transport/adapters/cdp-browser.ts).                                 | Cascade passes `focus: true`; visual typing may move cursor or focus. Proof: [cua.ts](../../src/transport/adapters/cua.ts).                 |
+| `compute press`      | Uses AX action dispatch when a ref/app scope is available; global key combos may require foreground app focus. Proof: [desktop-ax.ts](../../src/transport/adapters/desktop-ax.ts). | Planned per-window key dispatch keeps foreground changes behind `focus: true`. Proof: [unicli-uia main.rs](../../crates/unicli-uia/src/main.rs).                                                                                    | Uses display-server helpers for fallback key dispatch: `xdotool` on X11, `wtype` for printable Wayland keys, and `ydotool` for supported Wayland modifier combos. Proof: [input.rs](../../crates/unicli-atspi/src/input.rs).                                                      | Sends key events to the attached renderer page. Proof: [cdp-browser.ts](../../src/transport/adapters/cdp-browser.ts).                           | Cascade passes `focus: true`; visual key events may focus the active surface. Proof: [cua.ts](../../src/transport/adapters/cua.ts).         |
+| `compute scroll`     | Uses `AXScrollToVisible` through the AX element action path without activation. Proof: [desktop-ax-swift.ts](../../src/transport/adapters/desktop-ax-swift.ts).                    | Descendant refs prefer native UIA `ScrollPattern.Scroll(...)`, then fall back to `SendInput` wheel dispatch. Top-level window refs are foregrounded before `SendInput`. Proof: [input.rs](../../crates/unicli-uia/src/input.rs).    | Descendant refs prefer native AT-SPI `Component.scroll_to(...)`, then fall back to display-server wheel helpers. Top-level refs are activated before helper wheel dispatch. Proof: [input.rs](../../crates/unicli-atspi/src/input.rs).                                            | Sends wheel events to the attached renderer page. Proof: [cdp-browser.ts](../../src/transport/adapters/cdp-browser.ts).                         | Cascade passes `focus: true`; visual scrolling may move the cursor or active surface. Proof: [cua.ts](../../src/transport/adapters/cua.ts). |
+| `compute screenshot` | Reads window/screen state without activation; may require Screen Recording permission. Proof: [desktop-ax.ts](../../src/transport/adapters/desktop-ax.ts).                         | Descendant refs crop the owning HWND/GDI bitmap when bounds are known; top-level refs capture the window bitmap. Proof: [screenshot.rs](../../crates/unicli-uia/src/screenshot.rs).                                                 | Top-level X11 window refs capture with `import -window <id>`; Wayland refs with known bounds capture with `grim -g`. Other helper paths activate the target before screenshot. Proof: [screenshot.rs](../../crates/unicli-atspi/src/screenshot.rs).                               | Captures the attached renderer page. Proof: [cdp-browser.ts](../../src/transport/adapters/cdp-browser.ts).                                      | Backend-specific screenshot behavior. Proof: [cua.ts](../../src/transport/adapters/cua.ts).                                                 |
+
+## Operational Notes
+
+- `compute click`, `compute type`, `compute press`, and `compute scroll` pass
+  `focus: false` to AX, UIA, AT-SPI, and CDP unless the caller sets `--focus`
+  or `focus: true`.
+- Linux AT-SPI refs from `compute snapshot` / `compute find --first` can target
+  `compute click`, `compute type`, `compute scroll`, `compute screenshot`,
+  `compute wait`, `compute observe`, and `compute assert`. Descendant click,
+  type, focus, scroll, and screenshot prefer native AT-SPI or bounded region
+  operations before display-server helpers. Top-level X11 refs use `wmctrl`
+  where a real window id exists; AT-SPI-only synthetic refs use the
+  accessibility tree and native `ComponentProxy.grab_focus()`.
+- Windows UIA refs from `compute snapshot` / `compute find --first` can target
+  descendant click, type, focus, scroll, screenshot, wait, observe, and assert
+  when the OS exposes the UIA tree. Invoke, toggle, selection, value, focus,
+  and scroll prefer native UIA patterns before bounded fallback paths.
+- Linux AT-SPI `compute press` remains a global display-server helper path, so
+  it targets the active desktop surface.
+- CUA is a fallback for cases where structured transports cannot see or act on
+  the target. Because it is visual-provider based, the cascade dispatches CUA
+  actions with `focus: true`.
+- If a target is minimized, hidden, disabled, or off screen, prefer a fresh
+  `compute snapshot` and a structured retry before enabling `--focus`.