Adom Bridge

@@ -178,6 +178,14 @@ AD speaks to you through native Windows toasts via `notify_user`, under Adom Des adom-desktop notify_user '{"title":"Export done","body":"gerbers.zip is ready in C:/exports."}'
 ```
 
+**Click-to-focus: send them where the notification points.** Most notifications are about something else on screen: a browser waiting on a login, a dialog, an app that needs a click. Pass `focus` and clicking the notification brings THAT window to the front, instead of opening Adom Desktop. Name the window by `hwnd` (exact, from `desktop_list_windows`), by `cacheKey`, or by `titleContains`.
+
+```bash
+adom-desktop notify_user '{"title":"Sign-in needed","body":"Confirm in the browser and I will continue.","focus":{"titleContains":"Sign in - Google Chrome"}}'
+```
+
+The response says whether the target resolved, so the AI finds out at send time rather than you finding out by clicking a notification that does nothing. If the window is gone by the time you click, it falls back to opening Adom Desktop, so a click is never dead. The click also counts as an acknowledgement, so the AI learns you engaged even with no buttons on the toast.
+
 **Sticky choice with buttons that round-trip.** Stays on screen until the user clicks (no auto-dismiss). Give it an `id` you choose, then read the click back.
 
 ![Sticky toast with buttons](docs/toast-buttons.png)
@@ -214,7 +222,11 @@ adom-desktop notify_events '{"sinceSeq":0}'          # drain EVERY click since a adom-desktop notify_dismiss '{"id":"deploy-42"}'     # retract a sticky toast once you have handled it
 ```
 
-Clicking the toast body or any button brings the Adom Desktop window to the foreground. Full reference lives in the `adom-desktop-notify` skill.
+Or skip the polling entirely with `"wait":true`, which blocks until you act (or `timeoutSec` elapses) and hands the AI your answer directly.
+
+Clicking the toast body brings the window named by `focus` to the front, or opens Adom Desktop when no `focus` was given. Button clicks deliberately do not steal focus: a toast exists to reach you without interrupting what you were doing.
+
+The AI does not have to read any of this first. When a call leaves something on the table, such as no `focus`, or buttons on a toast that will vanish before you see it, the response says so and lists what the verb can do. That coaching stops once the AI gets it right. Full reference lives in the `adom-desktop-notify` skill.
 
 ## Verbs
 

⋯ 1 unchanged line ⋯

@@ -1,6 +1,6 @@ {
   "slug": "adom-desktop",
-  "version": "1.9.158",
+  "version": "1.9.162",
   "type": "app",
   "description": "Installs the adom-desktop CLI and its Claude skills INTO A CLOUD CONTAINER so an AI assistant there can understand and drive Adom Desktop over the relay. This is the container side, NOT the app itself. The Adom Desktop app is the signed Windows installer under Download below: run THAT on the PC you want the AI to control. Rule of thumb: pkg install here (in your Linux container), Download there (on your Windows PC). Once installed, the AI can drive file transfer, screenshots, notifications, KiCad and Fusion 360, real-Chrome (Puppeteer) automation, the shell, windows, and the Hydrogen Desktop proxy.",
   "discovery_pitch": "Use when a cloud AI needs to reach a real Windows desktop: run shell commands, capture screenshots, drive native apps and browsers, transfer files, and control KiCad / Fusion 360 / third-party bridges.",

@@ -1,6 +1,6 @@ {   "slug": "adom-desktop",-  "version": "1.9.158",+  "version": "1.9.162",   "type": "app",   "description": "Installs the adom-desktop CLI and its Claude skills INTO A CLOUD CONTAINER so an AI assistant there can understand and drive Adom Desktop over the relay. This is the container side, NOT the app itself. The Adom Desktop app is the signed Windows installer under Download below: run THAT on the PC you want the AI to control. Rule of thumb: pkg install here (in your Linux container), Download there (on your Windows PC). Once installed, the AI can drive file transfer, screenshots, notifications, KiCad and Fusion 360, real-Chrome (Puppeteer) automation, the shell, windows, and the Hydrogen Desktop proxy.",   "keywords": [

@@ -1,21 +1,21 @@-{-  "manifest_version": 1,-  "version": "1.9.162",-  "released_at": "2026-07-22T15:34:06Z",-  "windows": {-    "installer_url": "https://wiki.adom.inc/download/adom/adom-desktop/1.9.162/Adom%20Desktop_1.9.162_x64-setup.exe",-    "installer_filename": "Adom Desktop_1.9.162_x64-setup.exe",-    "installer_sha256": "d84ab84cd3579fd6cac232a77d9709fd81e61497e20b2ee2cd59d14ff30dce9b",-    "installer_size": 13418464-  },-  "changelog_url": "https://wiki.adom.inc/adom/adom-desktop",-  "minimum_required": "1.3.30",-  "note": "Clicking a notification now takes you where it points: notify_user takes a `focus` window and a click brings that window to the front instead of opening Adom Desktop. notify_user `wait` also works for the first time.",-  "macos": {-    "installer_url": "https://wiki.adom.inc/download/adom/adom-desktop-macos/1.9.162/Adom.Desktop_1.9.162_macos_aarch64.dmg",-    "installer_filename": "Adom.Desktop_1.9.162_macos_aarch64.dmg",-    "installer_sha256": "2ff68eab7f80111fd5eb407c270d9b73b44084e3e9e90c0f0c0397617494f253",-    "installer_size": 12241094,-    "arch": "aarch64"-  }-}\ No newline at end of file+{
+  "manifest_version": 1,
+  "version": "1.9.162",
+  "released_at": "2026-07-22T15:34:06Z",
+  "windows": {
+    "installer_url": "https://wiki.adom.inc/download/adom/adom-desktop/1.9.162/Adom%20Desktop_1.9.162_x64-setup.exe",
+    "installer_filename": "Adom Desktop_1.9.162_x64-setup.exe",
+    "installer_sha256": "d84ab84cd3579fd6cac232a77d9709fd81e61497e20b2ee2cd59d14ff30dce9b",
+    "installer_size": 13418464
+  },
+  "changelog_url": "https://wiki.adom.inc/adom/adom-desktop",
+  "minimum_required": "1.3.30",
+  "note": "Clicking a notification now takes you where it points: notify_user takes a `focus` window and a click brings that window to the front instead of opening Adom Desktop. notify_user `wait` also works for the first time.",
+  "macos": {
+    "installer_url": "https://wiki.adom.inc/download/adom/adom-desktop-macos/1.9.162/Adom.Desktop_1.9.162_macos_aarch64.dmg",
+    "installer_filename": "Adom.Desktop_1.9.162_macos_aarch64.dmg",
+    "installer_sha256": "2ff68eab7f80111fd5eb407c270d9b73b44084e3e9e90c0f0c0397617494f253",
+    "installer_size": 12241094,
+    "arch": "aarch64"
+  }
+}