android-device

name	android-device
description	Operate Android device capabilities with device_status and device tools, including permissions, location, URL open, share, and settings recovery. Use for phone status, location, permissions, links, and Android system handoff tasks.

Android Device

Use device_status for state and permission checks. Use device for system actions.

Tool Map

• device_status with action=info|permissions|location
• device with action=open_url|share|open_app_settings

Default Automation Policy

• Set request_if_missing=true when permissions may be missing.
• Set open_settings_if_failed=true for automatic recovery.
• Set wait_user_confirmation=true only when the app cannot complete the system step itself.
• Avoid pre-confirmation for normal operations.

Location Playbook

1. Call device_status(action="location", provider="auto", prefer_fine=true).
2. If no fix, retry with provider="network".
3. If location service is disabled, allow settings handoff and continue.
4. If still unavailable, return recoverable error with next step.

Common Calls

• device_status(action="permissions", permissions=[...], request_if_missing=true, open_settings_if_failed=true, wait_user_confirmation=true)
• device_status(action="location", provider="auto", prefer_fine=true, open_settings_if_failed=true, wait_user_confirmation=true)
• device(action="open_url", url="https://...")
• device(action="share", text="...", subject="...")

Failure Recovery

• permissions_missing or permissions_denied: grant permissions and retry.
• location_disabled: enable location service in settings, then continue.
• ui_unavailable: foreground app and retry same call.