Adom Desktop - RustDesk Bridge

@@ -1,27 +1,39 @@ --- name: adom-desktop-rustdesk-bridge-description: Drive RustDesk remote-desktop sessions via Adom Desktop. Use when the user wants to remote into / control / screen-share / view a host that RDP can't reach (Windows Home, no RDP server), or says rustdesk, connect via rustdesk, remote desktop, remote into my machine, screen share my other pc, rdp alternative, vnc alternative, watch the install on my test laptop.+description: Drive RustDesk remote-desktop sessions via Adom Desktop — connect out to / control / view / screen-share a remote host that RDP can't reach (Windows Home, no RDP server). Trigger words: rustdesk, connect via rustdesk, remote desktop, remote into my machine, control a remote host, screen share my other pc, view my other pc, connect to my office computer, remote into my work pc, rdp alternative, vnc alternative, take over a remote pc, watch the install on my test laptop, rustdesk_connect, rustdesk_readiness. ---  # Adom Desktop - RustDesk Bridge -Use this when the user wants to **control or view a remote machine's screen** and RDP isn't an option (Windows **Home** can't host RDP; or the host has no RDP server). It's the client side — it drives the controlling machine out to a host.+Use this when the user wants to **control or view a remote machine's screen** and RDP isn't an option (Windows **Home** can't host RDP; or the host has no RDP server). Client side — it drives the controlling machine out to a host. -## Activate (first use, idempotent)+## FIRST-TIME / COLD-START — read before you panic -1. `adom-desktop bridge_install '{"manifestUrl":"https://wiki.adom.inc/api/v1/pages/adom-desktop-rustdesk-bridge/files/rustdesk-bridge-manifest.json"}'`-2. `adom-desktop rustdesk_ensure_client`  — downloads the portable RustDesk client if missing-3. then call the verbs below+A fresh machine may not have the RustDesk client yet. **`not present` / `installing` is EXPECTED, not failure** — prewarm and poll, don't declare defeat. -## Verbs+| You see (field / errorCode) | Meaning | What you do |+|---|---|---|+| `rustdesk_connect` → `error: rustdesk client not found` | client not downloaded yet | call `rustdesk_prewarm` (non-blocking), poll `rustdesk_readiness` until `ready:true`, retry connect |+| `rustdesk_readiness` → `installing:true` | client downloading in background | re-poll `rustdesk_readiness`; **never block, never re-trigger** |+| `rustdesk_readiness` → `ready:true` | client present | `rustdesk_connect {to,password}` |+| `rustdesk_readiness` → `lastError` set | download failed | relay the `_hint`; retry `rustdesk_prewarm` | -- `rustdesk_connect {to, password?}` — `to` is a RustDesk ID or IP. Pass `password` to auto-authenticate (no typing).-- `rustdesk_client_status` — installed path + active sessions.-- `rustdesk_disconnect {to?}` — close one session (or all).-- `rustdesk_ensure_client` — ensure/download the client.+For **"what tools do I have / is it ready"**, call the AD-level **`bridge_readiness`** — NOT `rustdesk_client_status` (status may spawn the bridge; `bridge_readiness` never does). -## Notes+## Core verbs (80% path) -- Multi-machine: address with `adom-desktop --target <name> rustdesk_connect ...`.-- RustDesk portable uses a rotating one-time password; a permanent password needs the installed service (host-side, Phase 2).-- On the same LAN/VPN, RustDesk upgrades to a direct P2P connection automatically.+| Command | Description | Key args |+|---|---|---|+| `rustdesk_connect` | open a session to a host | `{to: <id-or-ip>, password?}` |+| `rustdesk_client_status` | installed path + active sessions | — |+| `rustdesk_disconnect` | close one session (or all) | `{to?}` |+| `rustdesk_readiness` | READ-ONLY cold-start probe (never downloads) | — |+| `rustdesk_prewarm` | start the client download in background | `{wait?}` |++Full machine-readable catalog: `rustdesk_describe '{}'`.++## Conventions+- **Surface `_hint` verbatim.** Every verb returns an actionable `_hint`; relay it unchanged; branch on the stable field/`errorCode`, not the prose.+- **`ok:true` is not enough** — `rustdesk_connect` returns on session-START. Verify with `rustdesk_client_status` (session shows as `<id> - Remote Desktop - RustDesk`).+- **Pass the password** to auto-authenticate; without it the session waits at a prompt on the controlling machine.+- Multi-machine: `adom-desktop --target <name> rustdesk_connect ...`. On the same LAN/VPN RustDesk auto-upgrades to a direct P2P link.

@@ -2,7 +2,7 @@   "slug": "adom-desktop-rustdesk-bridge",   "title": "Adom Desktop - RustDesk Bridge",   "type": "app",-  "version": "0.2.0",+  "version": "0.3.0",   "description": "Drive RustDesk remote-desktop sessions from cloud Claude via Adom Desktop \u2014 connect out to any host by ID or IP (with a password), and list/close sessions. Works where RDP can't (Windows Home).",   "tags": [     "bridge",

@@ -2,7 +2,7 @@   "slug": "adom-desktop-rustdesk-bridge",   "title": "Adom Desktop - RustDesk Bridge",   "type": "app",-  "version": "0.2.0",+  "version": "0.3.0",   "description": "Drive RustDesk remote-desktop sessions from cloud Claude via Adom Desktop — connect out to any host by ID or IP (with a password), and list/close sessions. Works where RDP can't (Windows Home).",   "tags": [     "bridge",

@@ -1,8 +1,8 @@ {   "manifest_version": 1,-  "version": "0.2.0",-  "url": "https://wiki.adom.inc/download/adom/adom-desktop-rustdesk-bridge/0.2.0/rustdesk-bridge-v0.2.0.zip",-  "sha256": "f8067a895f57995852d8b139f023799607ebf80ddd35fca5ea3b5791d369cd4a",-  "size": 5005,+  "version": "0.3.0",+  "url": "https://wiki.adom.inc/download/adom/adom-desktop-rustdesk-bridge/0.3.0/rustdesk-bridge-v0.3.0.zip",+  "sha256": "9f8b6500516357124d36b06c6f05aef4e70b21f94a5d0786368d3ddfbe8d805d",+  "size": 5941,   "released_at": "2026-06-30T02:22:26Z" }\ No newline at end of file