Action payload · devices:advanced
native_tool
Call a tool actually listed in capabilities.nativeTools. name follows the shared ID rules; arguments defaults to {}. This example applies only when get_screen_info is discovered. Follow that tool’s inputSchema and coordinate units; common normalized coordinates do not apply automatically. Native availability depends on the bridge preset, upstream version, device and permissions.
Payload
{
"type": "native_tool",
"name": "get_screen_info",
"arguments": {}
}Payload fields
typestringrequiredDiscriminator that selects the action or content shape.
"native_tool"namestringrequiredName of the resource or operation. For commands with an enum, choose one of the listed values.
"get_screen_info"Validation pattern
^[A-Za-z0-9._:-]+$argumentsobjectoptionalArguments for the discovered native tool, validated against its advertised inputSchema.
{}Unknown fields are rejected.
View JSON Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"native_tool"
],
"description": "Discriminator that selects the action or content shape."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._:-]+$",
"description": "Name of the resource or operation. For commands with an enum, choose one of the listed values."
},
"arguments": {
"type": "object",
"additionalProperties": {},
"default": {},
"description": "Arguments for the discovered native tool, validated against its advertised inputSchema."
}
},
"required": [
"type",
"name"
],
"additionalProperties": false,
"description": "Call a tool actually listed in capabilities.nativeTools. name follows the shared ID rules; arguments defaults to {}. This example applies only when get_screen_info is discovered. Follow that tool’s inputSchema and coordinate units; common normalized coordinates do not apply automatically. Native availability depends on the bridge preset, upstream version, device and permissions.",
"example": {
"type": "native_tool",
"name": "get_screen_info",
"arguments": {}
}
}REST wraps this payload inside {requestId, command}. The matching MCP tool takes sessionId and requestId plus these fields, without the type discriminator.
Contract
Submit this as command to POST /sessions/{sessionId}/actions, pass it as the CLI action JSON, or use the matching MCP convenience tool. Command objects are strict and reject unknown fields.
Execution
Call a tool actually listed in capabilities.nativeTools. name follows the shared ID rules; arguments defaults to {}. This example applies only when get_screen_info is discovered. Follow that tool’s inputSchema and coordinate units; common normalized coordinates do not apply automatically. Native availability depends on the bridge preset, upstream version, device and permissions.
Action status and driver result remain separate. A completed result can still require a fresh screenshot or hierarchy check to prove the intended visible effect.
