@@ -17,9 +17,10 @@ import type {
 export type AndroidExecPortReverseOptions = Readonly<{
   /**
    * Refuses to replace any existing device mapping, including one this provider created
-   * (`adb reverse --no-rebind`), for a device that other adb clients also drive. A refusal the
-   * device listing confirms throws `COMMAND_FAILED` with
-   * `details.reason: 'android_port_reverse_rebind_refused'`.
+   * (`adb reverse --no-rebind`), for a device that other adb clients also drive. When
+   * `adb reverse --list` shows the endpoint after a refusal, the provider throws `COMMAND_FAILED`
+   * with `details.reason: 'android_port_reverse_rebind_refused'`; otherwise it throws the adb
+   * failure.
    */
   noRebind?: boolean;
 }>;
 
@@ -41,7 +41,7 @@ agent-device disconnect
 
 `connect` checks the instance credentials. agent-device never creates or deletes that instance: `disconnect` leaves it running, and its owner deletes it. When the variables for a platform are set, they take precedence over `LIMRUN_API_KEY` for that platform.
 
-On Android, agent-device does not replace an existing port reverse mapping. If the owner already maps a device port, such as `tcp:8081` for their Metro server, a reverse to that port fails and the owner's mapping stays in place. The error has `details.reason: 'android_port_reverse_rebind_refused'` when `adb reverse --list` shows the mapping. Otherwise it is a plain ADB failure.
+On an attached Android instance, agent-device does not replace an existing port reverse mapping. If the owner already maps a device port, such as `tcp:8081` for their Metro server, a reverse to that port fails and the owner's mapping stays in place. The error has `details.reason: 'android_port_reverse_rebind_refused'` when `adb reverse --list` shows the mapping. Otherwise it is a plain ADB failure.
 
 `install`, and `apps` before the first `open`, still need `LIMRUN_API_KEY`, because they use Limrun asset storage. After `open`, `apps` lists the apps installed on the instance without the key. Install the app before you hand over the instance. From the Node.js runtime, `getDeviceSession(device).installRemoteApp(url)` installs from a signed asset URL without the API key.