Unified application task
app_taskUse this when the user needs to execute one typed intent inside a curated app via trusted local API, scoped Accessibility or CDP without screenshots. New local- IDs support inspect/find-visible-controls and explicitly scoped non-destructive focus_control, after unique PID/window and semantic ID/name/role checks. Unknown apps cannot launch, click, invoke or submit; a single native text value can change only after explicit commit and exact old-value check (raw expected_text or an expiring blind token from inspect/find). Telegram edits require authenticated owner, original text and verified read-back.
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": {
"app": "<app>",
"intent": "<intent>",
"device": "<device>"
},
"name": "app_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | Registered app id or local-<hash> inventory id for read-only inspect/find of visible controls; unknown apps support inspect, visible lookup, verified focus or explicit one-field text replacement with old-value check; no launch, click or submission. | |
| pid | No | Existing positive native process id to disambiguate the window. | |
| query | No | With registered-app find: text entered into a verified search field. With detected local- app find: read-only search of already visible accessibility names, no typing. With find_post: read-only Telegram query through an authorized local API; never selects or edits a result automatically. | |
| commit | No | With edit_post or set_control_text: explicit authorization to change exactly the verified post or native text value; requires expected_text and replacement_text. | |
| device | Yes | ReMCP device id returned by list_devices. Required for every device operation. | |
| intent | Yes | High-level user intent, no untrusted selectors, code or shortcuts. | |
| verify | No | For native app launch only, inspect a real app window after dispatch; may take longer. | |
| channel | No | With find_post only: optional exact public Telegram channel username, e.g. @mychannel. Never a substring or guessed channel. | |
| dry_run | No | Return semantic route/transaction plan without opening apps, typing or editing; redact user-provided text. | |
| post_url | No | With edit_post: exact https://t.me/channel/messageId permalink; never a guessed post. | |
| target_id | No | Existing exact Chromium tab id; useful when multiple authorized tabs match. | |
| window_id | No | Existing exact native window id to disambiguate the window. | |
| control_id | No | For focus_control/set_control_text: exact accessibility element ID from the verified native inspect/find result. | |
| expected_name | No | For focus_control/set_control_text: exact previously observed accessible name. | |
| expected_role | No | For focus_control/set_control_text: exact previously observed accessible role. No invoke/submit. | |
| expected_text | No | For edit_post: exact previously read post text. For set_control_text: exact old native field text, or supply expected_value_token instead. | |
| replacement_text | No | With edit_post: bounded post replacement, max 4096. With set_control_text: 1–256 single-line non-secret characters; never presses Enter. | |
| expected_value_token | No | For set_control_text: blinded 90-second field-version token from a verified app_task inspect/find response; alternative to revealing expected_text. Bound to app/PID/window/control. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | Array/scalar payload wrapper used when the natural result is not an object. | |
| text | Yes | Concise human-readable result of the tool call. |