aua_execute_goal
Run bounded Android UI actions to accomplish a supplied goal; returns decision options for host approval and stops on completion, handoff, or unresolved effects.
Instructions
Agent plans, a decision policy selects candidate IDs, Android Use executes. decider=auto uses Jev when enabled (TypeSafe key in screen settings, or ANDROID_USE_JEV_ENABLED=1 / TYPESAFE_API_KEY; sends visible app UI text to TypeSafe), otherwise host: no key, nothing sent externally. Host mode returns status=decision_required with compact state, option IDs and a one-time token; choose with aua_goal_decide. Caller supplies goal, foreground package, exact input texts and optional completion selector. Compact semantic state and parallel operation/target questions share one Jev request per step. Each Jev request also judges goal completion; without a completion selector a confident ACHIEVED stops before another action (stop_reason=model_goal_achieved, unverified: check it). input_macros=true can combine stable-field focus and exact input with native readback; max_steps counts candidate selections, with at most two native writes per input macro. Bounded candidate-only actions; no automatic replay. status=handoff is not success. effect_timeout_seconds bounds observation after acknowledged mutations; unresolved effects hand off without another mutation. Geometry-only changes do not prove an effect. Keep existing tools for planning, unsupported controls and recovery. Password screens hand off.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"goal": "<goal>",
"package": "<package>"
},
"name": "aua_execute_goal"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | ||
| texts | No | ||
| actions | No | ||
| decider | No | auto | |
| observe | No | tree | |
| package | Yes | ||
| max_steps | No | ||
| completion | No | ||
| min_margin | No | ||
| input_macros | No | ||
| max_model_calls | No | ||
| min_probability | No | ||
| timeout_seconds | No | ||
| completion_state | No | visible | |
| effect_timeout_seconds | No |