FleetDeckDocs

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

json
{
  "type": "native_tool",
  "name": "get_screen_info",
  "arguments": {}
}

Payload fields

typestringrequired

Discriminator that selects the action or content shape.

Allowed:"native_tool"
namestringrequired

Name of the resource or operation. For commands with an enum, choose one of the listed values.

min 1 charactersmax 128 characters
Example: "get_screen_info"
Validation pattern^[A-Za-z0-9._:-]+$
argumentsobjectoptional

Arguments for the discovered native tool, validated against its advertised inputSchema.

default {}

Unknown fields are rejected.

View JSON Schema
json
{
  "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.