tools.adb_tools module

Android Debug Bridge (ADB) tools — USB and TCP/wireless.

Pairing (wireless debugging), connect/disconnect, device listing, shell, install/uninstall, pull/push, logcat (bounded), port forwarding, reboot, tcpip/usb mode, bugreport, screencap, plus adb_invoke for whitelisted top-level adb subcommands.

Requires adb (Android SDK platform-tools) on PATH.

Security: UNSANDBOXED_EXEC (same privilege model as Docker/SSH).

Per-user isolation: Each ToolContext.user_id gets a dedicated ANDROID_ADB_SERVER_PORT (deterministic hash of user id) and a separate HOME under STARGAZER_ADB_HOME_ROOT (default: tempfile prefix stargazer_adb_homes) so ~/.android keys/state do not collide with other bot users on the same host.

Interactive RSA prompts are not supported — authorize on the device first.