connect_phone
ChatGPTHelp the user connect their own iPhone or Android phone to Lusor, at no cost. Without wait_seconds it returns the download link, the setup guide and the short steps for that platform: show them to the user. Then, while the user follows them, call again with wait_seconds 50 (repeat while it says waiting) to get the phone as soon as it is connected. Changes nothing and buys nothing.
get_phone
ChatGPTDetails of one phone: what list_phones returns, plus its plan, OS and app versions, when it was added and last seen.
get_screen_state
ChatGPTRead the phone's current screen as a list of UI elements. Use it before phone_action to find what to tap, and to read on-screen text. Interactive ones are numbered [N]; tap one with phone_action action=tap index=N. detail=compact (default) lists only interactive elements; detail=full also lists text and layout. Changes nothing on the phone, but uses phone minutes on a Lusor Phone, like any direct action.
get_screenshot
ChatGPTTake a fresh screenshot of the phone and return it as an image, to see what is on screen (layout, images, state). To find something to tap, use get_screen_state instead: it gives numbered elements. Changes nothing on the phone, but uses phone minutes on a Lusor Phone, like any direct action.
get_task
ChatGPTA task's status, result text, error and recording link (if it was recorded). When the status is awaiting_human it includes the agent's question; answer it with reply_to_task.
install_app
ChatGPTInstall apps from the Lusor app catalog on a Lusor Phone (cloud Android), one after another. Name each app by its catalog name (e.g. "Instagram") or package (e.g. com.instagram.android); up to 24. Returns at once; follow progress with list_app_installs. A phone runs one install batch at a time. Uses the phone; does not buy anything.
list_app_installs
ChatGPTThe catalog app installs on a phone, newest first, with each one's status (queued, fetching, staged, installing, installed, failed, uninstalled ...), plus the current install batch when there is one.
list_phones
ChatGPTList the phones in this workspace: id, name, platform, type (cloud = a Lusor Phone, own = the customer's own phone), whether it is online, and whether it is busy with a task or idle. Call this first to get a phone_id for the other tools, and to check a phone is online and idle before run_task.
list_tasks
ChatGPTList recent tasks (agent runs on a phone), newest first: id, phone, status, prompt, times and error.
phone_action
ChatGPTDo one exact action on a phone directly, for a step or two you control yourself (use run_task for a whole job): tap (index from get_screen_state, or x+y), swipe (x, y to end_x, end_y), type (text into the focused field), key (Android key_code, e.g. 66 Enter, 67 Delete), back, home, or launch_app (package, e.g. com.android.settings). Set return_screen to get the screen elements after the action. Actions are never retried: a repeated tap taps twice. On a Lusor Phone this uses phone minutes.
remove_phone
ChatGPTRemove one Lusor Phone from this workspace's plan: the phone is wiped (its data cannot be recovered) and the unused rest of the period is credited to the account. Two calls: without confirm_preview_id it only returns a quote (nothing is removed); show it to the user and, only after they agree, call again with confirm_preview_id. Refused while a task runs on the phone, and for the plan's last phone.
reply_to_task
ChatGPTAnswer the question a task is waiting on (status awaiting_human; get_task shows the question). The task resumes with your answer. Questions asking for a password or code can only be answered in the Lusor app.
run_task
ChatGPTStart an AI agent on a phone with a prompt; it operates the phone to do the task, which suits multi-step jobs that need judgment ("open Settings and turn on dark mode", "find the latest order in the shop app"). For one exact tap or keystroke use phone_action. Write the prompt as a complete instruction: the goal, the app, and what to report back. Returns the task id at once, or with wait_seconds (up to 50) waits for it to finish or ask a question and returns its result. If it is not finished, follow up with get_task; never call run_task again for the same job (that starts a second agent). Uses credits, and phone minutes on a Lusor Phone. The phone must be idle (see list_phones).
stop_task
ChatGPTCancel a running or queued task, for example one that is stuck or no longer wanted, or to free a busy phone. Stopping a task that already ended does nothing.
wipe_phone
ChatGPTWipe a Lusor Phone back to a fresh state: every installed app, account sign-in, file and setting on it is erased for good. The phone stays in the workspace and on the plan. Two calls: without confirm_phone_name it only says what will be erased and the phone's exact name (nothing is wiped); tell the user and ask them to confirm by typing that name. Only then call again with confirm_phone_name set to the name the user typed; it must match the phone's current name exactly. Refused while a task runs on the phone.