One current frame from the phone camera (JPEG). Falls back to a local test image (if configured) when the phone is unreachable.

The phone's current sensor values (battery level/charging, illuminance lux, acceleration x/y/z) as JSON.

JSON list of the device's recent photos (id, name, date_added, w, h). Get the image via get_photo(id).

If the user designated content in the phone app (LIVE / Capture / File / Phone clipboard), prefer get_reference — it returns exactly what they picked; this gallery list may not include it.

Fetch the photo for the id returned by recent_photos (downscaled to max_width).

Download whatever the phone currently designates as the 'share target' to the PC, save it, and return the path and metadata (JSON).

Depends on the phone app's reference mode: LIVE = real-time camera frame, Capture = a fixed captured image, File = an arbitrary file the user chose. Non-image files (PDF, video, documents, etc.) are fetched as-is too. (If you only need an image preview, get_live_frame is simpler.) Returns: {"path", "mime", "bytes", "name"} — path is the PC-local save path (the user's Downloads folder, so it's easy to find and use later — not a temp folder). Always call this to fetch the phone's CURRENT designation — never reuse files already sitting in the save folder (they are stale copies from earlier fetches, not what the user has designated now).

Query the phone's current camera FPS setting (15=high performance, 2=balanced, 0=on-demand).

Change the phone's camera FPS setting.

fps: 15 (high performance), 2 (balanced, recommended), 0 (power-saving/on-demand)