callstackincubator/agent-device

callstackincubator/agent-device

от callstackincubator
agent-device — CLI для автоматизации устройств, позволяющий AI-агентам открывать приложения на iOS, Android и десктопе, инспектировать UI, взаимодействовать с элементами и собирать отладочную инфор...
agent-device: mobile app automation and verification for AI coding agents

agent-device

npm version CI License: MIT Glama MCP server

Mobile app automation and verification for AI coding agents. Give coding agents a live app feedback loop through a CLI, built-in MCP server, or typed Node.js API.

Let your coding agent verify its changes in the running app. agent-device lets agents inspect, control, debug, and verify apps on iOS, Android, and HarmonyOS (simulators, emulators, and physical devices), plus tvOS, Android TV, Amazon Vega OS TV (Vega Virtual Device), web, macOS, and Linux. Agents read token-efficient accessibility snapshots instead of reasoning over screenshots alone, act through refs and selectors, and save evidence for review. It also coordinates device access across parallel agent worktrees and connects to remote device clouds.

Works with Claude Code, Codex, Cursor, Windsurf, Cline, Goose, and any agent that can run a CLI or connect over MCP, or as the runtime under agents you build with the AI SDK or Eve. Developers at Expensify, Shopify, and others use it to verify their apps.

agent-device powers mobile automation in e2e and T3 Code.

Часто задаваемые вопросы

Инструменты были проиндексированы:
action-button

Нажмите кнопку Action Button на iPhone или iPad один раз. Нажатие отправляется без активации приложения сеанса, и после этого ничего повторно не отслеживается, поэтому приложение сохраняет состояние, в котором его застало нажатие. Что система делает с нажатием, эта команда не наблюдает: в симуляторах не выполняются ни Shortcuts, ни App Intents, поэтому доставку назначенному Shortcut можно проверить только на физическом iPhone. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

alert

Осматривает, ожидает, принимает или отклоняет системный алерт. Используйте get перед действием, если содержимое алерта важно; accept и dismiss изменяют активное состояние алерта. При каждом выполнении iOS XCTest инструмент активируется один раз, после чего только наблюдает. Осматривайте снова после неподтверждённого действия; никогда не считайте, что таймаут означает, что ничего не произошло. Таймаут наступает через 90 секунд.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger
  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

apps

Перечисляет приложения, установленные на выбранном устройстве. Включает системные приложения или OEM-приложения только тогда, когда они нужны в качестве целей автоматизации. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appsFilterenum

    Ограничьте список пользовательскими приложениями или включите системные и OEM-приложения.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

appstate

Показывает приложение/активность на переднем плане (Android и HarmonyOS; iOS и macOS отвечают в рамках сессии). Завершается по тайм-ауту через 90 с.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

app-switcher

Открывает переключатель приложений устройства, чтобы просматривать или менять приложения на переднем плане. Это изменяет видимый системный интерфейс и может увести фокус от текущего приложения. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

artifacts

Перечисляет артефакты демона или облачного провайдера для активной или завершённой сессии. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • providerstring

    Название облачного провайдера, например browserstack, aws-device-farm или testmu.

  • providerSessionIdstring

    Идентификатор сеанса облачного провайдера или ARN.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

audio

Измеряет аудио симулятора/эмулятора, рендерируемое браузером или хостом, в виде компактных сегментов dBFS. Запустите пробу, прежде чем запрашивать её статус или останавливать её. Таймаут наступает через 90 секунд.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • bucketMsinteger

    Размер сегмента уровня звука в миллисекундах.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • durationMsinteger

    Длительность проверки в миллисекундах.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • probeActionenum
  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

back

Переходит назад в приложении или через системную навигацию. Используйте in-app для стека навигации приложения и system, когда требуется поведение системной кнопки «назад». Таймаут наступает через 90 секунд; бюджет, переданный вызывающей стороной, продлевает его.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • modeenum
  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

batch

Выполняет несколько команд за один запрос к демону. Тайм-аут через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • maxStepsinteger

    Максимальное количество шагов, принимаемое для этого пакета.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • onErrorenum

    Политика обработки сбоев пакета.

  • outstring

    Необязательный путь вывода для артефактов команды.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • stepsobject[]обязательный

    Структурированные пакетные шаги. Каждый шаг использует имя команды и тот же объект ввода, что и инструмент этой команды.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

boot

Загружает или подготавливает выбранное устройство или симулятор, чтобы последующие команды могли обращаться к нему. Устройство выбирается через входные параметры выбора устройства, а не указывается здесь по имени. Тайм-аут наступает через 90 секунд; предоставленный вызывающим бюджет продлевает это время.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • headlessboolean

    Загружается без показа интерфейса симулятора, когда поддерживается.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Бюджет запуска в миллисекундах. Ограничивает ожидание загрузки, чтобы Simulator, который ещё ни разу не загружался, мог завершить миграцию при первой загрузке, а холодный эмулятор - свою загрузку; не указывайте параметр, чтобы использовать поведение запуска по умолчанию.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

capabilities

Перечисляет команды, поддерживаемые выбранным устройством или активной сессией. При проверке поддержки до открытия сессии используйте входные параметры выбора устройства. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

click

Активирует цель в UI по ref из снимка, селектору или координатам. После снимка лучше выбрать ref или селектор; координаты нужны только когда семантическое нацеливание недоступно. Это может изменить состояние приложения. Успех означает, что клик отправлен, а не то, что он попал: для подтверждения результата без повторного снимка подойдут settle или verify, либо можно дождаться ожидаемого экрана. Если предыдущее действие сессии только что анимировало экран, цель по ref или селектору перед отправкой повторно проверяется на движение и отправляется в своём состоянии покоя; цель, которая не остановилась, завершается отказом с target_still_moving, а не действует там, где была. Истекает через 90 с; бюджет, заданный вызывающим, продлевает тайм-аут.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • buttonenum

    Кнопка указателя для платформ, поддерживающих кнопки мыши.

  • countinteger

    Количество повторений нажатия/клика.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • doubleTapboolean

    Запрашивает действие двойного касания.

  • holdMsinteger

    Длительность удержания для каждого действия.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • intervalMsinteger

    Задержка между повторными нажатиями/кликами.

  • jitterPxinteger

    Радиус рандомизации в пикселях.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetobjectобязательный

    UI target. Это отдельно от deviceTarget, который выбирает форм-фактор устройства.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • verifyboolean

    Захватывает дешёвые свидетельства после действия (дайджест AX, количество узлов, changedFromBefore) вместо последующего снимка.

clipboard

Читает текущий текст буфера обмена устройства или заменяет его содержимое на указанный текст. Android выполняет обе операции через shell-команду сервиса буфера обмена, а сборка, которая не реализует ни одну из них (Android 16 не реализует), возвращает UNSUPPORTED_OPERATION вместо сообщения о пустом буфере обмена. Тайм-аут через 90 секунд.

Параметры
  • actionenumобязательный
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • textstring
  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

close

Закрывает указанное приложение или приложение активного сеанса, если приложение не указано. Использует shutdown только тогда, когда выбранный симулятор или эмулятор также должен остановиться. Через 90 секунд наступает таймаут.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appstring

    Необязательное приложение для закрытия.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • forceboolean

    Перезаписывает существующую цель --save-script вместо отказа (псевдоним: --overwrite).

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • saveScriptboolean | string
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • shutdownboolean

    Завершает сеанс или устройство, если это поддерживается.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

debug

Символизирует артефакты сбоев Apple с совпадающими UUID dSYM. Это отладочное пространство имён намеренно узкое: используйте logs для журналов приложения, network для HTTP-данных, perf для образцов производительности, record/trace для медиа и трассировок, а react-devtools для профилей React Native. Таймаут наступает через 90 секунд.

Параметры
  • actionenumобязательный
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • artifactstringобязательный

    Путь к артефакту краха Apple (.ips, .crash или .log).

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • dsymstring

    Путь к соответствующему бандлу .dSYM.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • outstring

    Путь вывода для символизированного артефакта.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • searchPathstring

    Сканирует каталог на наличие соответствующих .dSYM-пакетов.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

devices

Перечисляет доступные устройства и симуляторы, которые можно выбрать для автоматизации. Используйте параметры platform, device, udid или serial в последующих командах, чтобы выбрать один результат. Прерывается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

diff

Сравнивает снимки доступности или скриншоты, чтобы выявить изменения в интерфейсе. Использует сравнение снимков для определения изменений в семантическом дереве и сравнение скриншотов для выявления пиксельных отличий. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger
  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • interactiveOnlyboolean
  • kindstringобязательный
  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • outstring
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean
  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

doctor

Диагностирует проблемы готовности устройства, приложения, сервера разработки и React Native или Expo. Возвращает компактные данные для локальной инвентаризации, сессий, необязательного обнаружения приложений, тулчейнов и доступности сервера. В iOS-симуляторах также прогревает кэш сборки XCTest runner в фоновом режиме, если он отсутствует, поэтому запускайте его перед первым снимком Apple или взаимодействием в сессии. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • remoteboolean

    Проверьте настройку удалённого подключения вместо локальной инвентаризации устройств.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • targetAppstring

    Пакет/bundle ID установленного приложения или имя приложения для проверки без открытия сеанса.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

events

Читает принадлежащую демону временную шкалу событий сеанса в виде постраничных JSON-совместимых записей. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • cursorstring
  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • limitinteger
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

fill

Заменяет текст в поле ввода UI, выбранном по snapshot ref, селектору или координатам. Передаёт пустой текст, чтобы очистить поле. Изучает неподтверждённые свидетельства и сверяет ожидаемое значение или результирующий экран перед продолжением. Предпочитает refs или селекторы после snapshot; использует recordAs, чтобы чувствительный текст не попал в записанный повтор, но при этом отправлялся в живое приложение. Завершается по тайм-ауту через 90 с; бюджет, заданный вызывающей стороной, продлевает его.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • delayMsinteger

    Задержка между введёнными символами.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • recordAsstring

    Когда запись скрипта активирована, отправляйте текст в живое приложение, но публикуйте его как ${VAR}. Используйте имя переменной воспроизведения в верхнем регистре, например PASSWORD.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetobjectобязательный

    UI target. Это отдельно от deviceTarget, который выбирает форм-фактор устройства.

  • tenantstring

    Идентификатор удаленного тенанта.

  • textstringобязательный

    Текст для ввода в целевой элемент. Передайте "" , чтобы очистить его.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • verifyboolean

    Захватывает дешёвые свидетельства после действия (дайджест AX, количество узлов, changedFromBefore) вместо последующего снимка.

find

Находит по text/label/value/role/id и выполняет действие. Локатор role соответствует словарю типов snapshot (button, text, text-field, switch, ...); написания листовых узлов до reconciliation (statictext, edittext, textview) по-прежнему принимаются на узлах, которые несли их в течение окна устаревания. Завершается по тайм-ауту через 90 с.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger
  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • firstboolean
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • lastboolean
  • leaseIdstring

    Существующий идентификатор аренды.

  • locatorenum
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • querystringобязательный
  • rawboolean
  • recordboolean

    Принудительно записывает это внеполосное наблюдение в восстановление с активированным ремонтом (взаимоисключающее с noRecord). Авторские шаги воспроизведения записываются автоматически и никогда не требуют этого. При поиске действительно только для действия только для чтения.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger
  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • valuestring
focus

Перемещает фокус ввода в явно указанные координаты экрана без ввода текста. Предпочитает семантические взаимодействия, когда доступны snapshot ref или selector; использует type или fill после фокусировки. Завершается по таймауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • xnumberобязательный

    Координата X.

  • ynumberобязательный

    Координата Y.

fold

Складывает или раскладывает складной симулятор iPhone (iPhone Duo) или складной эмулятор Android в закрытое, полуоткрытое или открытое положение. iOS отправляет HID-событие шарнира симулятора, затем считывает угол шарнира обратно из CoreDevice для подтверждения и может отслеживать ключевые кадры угла с временными метками; Android задаёт позу через консоль эмулятора, затем подтверждает состояние устройства, которое фиксирует гостевая система, и сообщает угол шарнира, который профиль AVD определяет для этой позы, а также убирает экран блокировки, который может появиться при складывании на внешний дисплей. В iOS смена положения перемещает приложение на другую панель с другим размером в точках; в Android складывание в закрытое положение или из него перемещает приложение между внешним и внутренним дисплеями, а любая смена положения может изменить форму окна приложения, размер которого сообщит следующий снимок. В любом случае все ref и координаты, полученные до этого, устарели: сделайте повторный снимок после этой команды. Нажатия, длительные нажатия и прокрутка нацелены на окно приложения на его текущей панели в закрытом, полуоткрытом и открытом положениях. Только симулятор и эмулятор; iOS требует iOS simulator SDK; Device Hub и разрешение Accessibility на хосте не требуются. Симулятор, привязанный к нестандартному набору симуляторов, отклоняется с UNSUPPORTED_OPERATION и причиной unsupported-device-scope; запускайте fold для симулятора из набора по умолчанию. Завершается по таймауту через 255 с.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • keyframesobject[]

    Кусочно-линейное движение шарнира. Начинается с 0 мс; метки времени строго возрастают, до 60000 мс. Повторяющиеся углы создают удержания. Несовместимо с pose.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • poseenum

    Мгновенный пресет; несовместим с ключевыми кадрами.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

gesture

Выполняет структурированный жест: pan, fling, swipe, pinch, rotate, transform или drag. Выберите вид жеста, затем укажите только те входные данные, которые применимы к этому виду. Таймаут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • degreesnumber

    Поворот в градусах.

  • deltaobject

    Смещение при жестах панорамирования или трансформации.

  • destinationstring

    Перетащите целевой @ref или селектор.

  • destinationHoldMsinteger

    Задержитесь перед отпусканием в пункте назначения.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • directionenum

    Направление смахивания.

  • distanceinteger

    Дальность броска.

  • durationMsinteger

    Продолжительность панорамирования/трансформации.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • kindenumобязательный

    Вариант жеста.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • moveMsinteger

    Длительность движения при перетаскивании.

  • noRecordboolean

    Не записывайте это действие.

  • originobject

    Точка начала жеста.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • pointerCountinteger

    Количество указателей касания для панорамирования (1 или 2).

  • presetenum

    Пресет смахивания.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scalenumber

    Сведение или масштабирование.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • sourcestring

    Перетащите исходный @ref или селектор.

  • sourceHoldMsinteger

    Длительность удержания для активации перетаскивания.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

get

Читает текст или атрибуты доступности из snapshot ref или селектора, не изменяя приложение. Использует формат text для видимого содержимого или attrs для карты атрибутов элемента. Завершается по таймауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • formatenumобязательный
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • recordboolean

    Принудительно записывает это внеполосное наблюдение в восстановление с активированным ремонтом (взаимоисключающее с noRecord). Авторские шаги воспроизведения записываются автоматически и никогда не требуют этого. При поиске действительно только для действия только для чтения.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetobjectобязательный

    Определяет целевой элемент UI по snapshot reference или селекторному выражению.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

help

Руководства по использованию. Без темы: полная карточка workflow. Тема = одно из: commands, manual-qa, maestro, workflow, scripting, gestures, tv, debugging, react-devtools, cdp, react-native, physical-device, ios-system-ui, foldable, remote, macos, web, dogfood, validate для этого руководства, или имя инструмента для его полной справки по флагам. Только для специализированных задач или когда форма команды неочевидна; не для первого шага, не нужно после ошибки с подсказкой.

Параметры
  • topicstring

    Тема руководства или имя инструмента; для карточки опустите.

home

Переводит выбранное устройство на домашний экран. При этом сеанс приложения остаётся открытым, но приложение уходит с переднего плана. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

hover

Наводит указатель на целевой элемент интерфейса по snapshot ref, селектору или координатам без нажатия, чтобы открыть интерфейс, появляющийся при наведении, например панели инструментов строки или меню. Только веб; на сенсорных платформах состояния наведения нет. Используйте settle, чтобы увидеть, что показало наведение, без последующего snapshot. Тайм-аут наступает через 90 секунд; переданный вызывающим кодом бюджет продлевает его.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetobjectобязательный

    UI target. Это отдельно от deviceTarget, который выбирает форм-фактор устройства.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

install

Устанавливает бинарный файл приложения из локального пути. Передаёт идентификатор приложения вместе с путём, когда целевой системе требуется явный выбор приложения; использует reinstall для замены уже установленного приложения. Завершается по таймауту через 180 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appstring

    Необязательная подсказка идентификатора приложения.

  • appPathstringобязательный

    Путь к бинарному файлу приложения.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

install-from-source

Устанавливает сборки приложений из URL-адресов, удалённых спецификаций исходного кода или артефактов CI, разрешаемых удалённым демоном. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • retainPathsboolean
  • retentionMsinteger
  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • sourceobjectобязательный

    Устанавливает исходный объект.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

is

Проверяет, удовлетворяет ли селектор UI-предикату, такому как visible, hidden, exists, absent, editable, selected, focused или text. absent проходит только тогда, когда один читаемый, полный, устоявшийся, неограниченный областью, полной глубины accessibility-снимок имеет ноль совпадений. Использует wait, когда условие может появиться асинхронно. Время ожидания истекает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • predicateenumобязательный
  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • recordboolean

    Принудительно записывает это внеполосное наблюдение в восстановление с активированным ремонтом (взаимоисключающее с noRecord). Авторские шаги воспроизведения записываются автоматически и никогда не требуют этого. При поиске действительно только для действия только для чтения.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • selectorstringобязательный
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • valuestring
keyboard

Проверяет видимость/тип клавиатуры Android или нажимает на клавиатуру устройства либо скрывает её. Чтобы скрыть клавиатуру, используйте keyboard dismiss. Он нажимает клавишу скрытия/сокрытия клавиатуры, когда она отображается, проверяет, что клавиатура закрыта, и сообщает UNSUPPORTED_OPERATION, если клавиши скрытия нет. Фоновые нажатия не выполняются. Таймаут наступает через 90 секунд.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

logs

Информация журнала приложения сеанса, запуск/остановка потоковой передачи, диагностика и маркеры. Тайм-аут через 90 секунд.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • messagestring
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • restartboolean
  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

longpress

Удерживает цель UI по snapshot ref, селектору или координатам, чтобы открыть контекстное меню или выполнить другой жест удержания. Устанавливает durationMs, если длительность удержания по умолчанию не подходит. Тайм-аут наступает через 210 секунд; переданный вызывающим кодом бюджет увеличивает это время.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • durationMsinteger

    Продолжительность долгого нажатия в миллисекундах.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetobjectобязательный

    UI target. Это отдельно от deviceTarget, который выбирает форм-фактор устройства.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

metro

Готовит сервер разработки React Native или запрашивает перезагрузку подключённых приложений, используя сервер разработки, к которому привязана эта сессия. Предоставляет явные входные данные времени выполнения только для переопределения этой привязки на один вызов. Привязка очищается при закрытии сессии, а новое открытие без подсказок времени выполнения также очищает любую оставшуюся привязку от предыдущей одноимённой сессии. Тайм-аут наступает через 90 секунд.

Параметры
  • actionenumобязательный
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • bridgeScopeobject
  • bundleUrlstring
  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • installDependenciesIfNeededboolean
  • kindstring
  • launchUrlstring
  • leaseIdstring

    Существующий идентификатор аренды.

  • listenHoststring
  • logPathstring
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • metroHoststring
  • metroPortinteger
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • portinteger
  • probeTimeoutMsinteger
  • projectRootstring
  • publicBaseUrlstring
  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • reuseExistingboolean
  • runIdstring

    Идентификатор прогона аренды.

  • runtimeFilePathstring
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • startupTimeoutMsinteger
  • statusHoststring
  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger
  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

network

Выгружает недавний HTTP(S)-трафик, разобранный из журнала приложения сеанса. Тайм-аут наступает через 90 секунд.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeenum
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • limitinteger
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

open

Загружает выбранное устройство при необходимости, затем открывает приложение, deep link или URL в сеансе. Использует входные параметры app или URL, чтобы выбрать, что станет целью автоматизации на переднем плане. metroHost, metroPort и bundleUrl выбирают сервер Metro приложения и сохраняют его адрес для последующих перезагрузок. launchUrl выбирает URL запуска приложения и не выбирает сервер перезагрузки. Новое открытие без подсказок Metro очищает старую привязку с тем же именем; закрытие тоже её очищает. Истекает по тайм-ауту через 90 с; бюджет, переданный вызывающим, продлевает его.

Параметры
  • activitystring

    Имя Android activity.

  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appstring

    Название приложения, bundle id, package или URL.

  • bundleUrlstring

    Подсказка URL пакета в рамках сессии, примененная к открытому приложению.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • forceboolean

    Перезаписывает существующую цель --save-script вместо отказа (псевдоним: --overwrite).

  • foregroundboolean

    Включает начальный интерактивный снимок в свежем открытом ответе. Без аргумента приложения находит единственное запущенное приложение на единственной загруженной симуляторе iOS; неоднозначные окружения завершаются с ошибкой.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • launchArgsstring[]

    Аргументы запуска передаются дословно в команду запуска платформы.

  • launchConsolestring

    Запускает консольный режим.

  • launchUrlstring

    Запускает URL для открытого приложения; не выбирает сервер, используемый при перезагрузке metro.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • metroHoststring

    Подсказка хоста отладки Metro с областью действия сеанса применяется к открытому приложению.

  • metroPortinteger

    Сессионный порт Metro/debug, применяемый к открытому приложению. В эмуляторе/симуляторе хост по умолчанию устанавливается на псевдоним loopback (Android 10.0.2.2, iOS 127.0.0.1), если параметр --metro-host опущен; для физических устройств по-прежнему требуется явно указывать --metro-host.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • relaunchboolean

    Принудительно перезапускает.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • saveScriptboolean | string
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • surfaceenum

    Поверхность отображения macOS для открытия: само приложение, приложение на переднем плане, рабочий стол или строка меню.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • testImeboolean

    Активируйте безголовый тестовый IME Android для детерминированного ввода текста Unicode (по умолчанию включен для эмуляторов; на реальных устройствах — по выбору).

  • timeoutMsinteger

    Бюджет запуска в миллисекундах. Ограничивает время ожидания загрузки Simulator, чтобы ни разу не загружавшийся Simulator мог завершить миграцию при первой загрузке; не указывайте параметр для стандартного поведения при запуске.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • urlstring

    Необязательный URL, передаваемый с app shell.

  • waitMsinteger

    Блокирует это открытие на срок до n миллисекунд (100-120000), пока устройство удерживает другая сессия, затем завершается ошибкой DEVICE_IN_USE с указанием этой сессии. Ожидание возникает только при конкуренции сессий: заявка на устройство, удерживаемая другим workspace, отклоняется сразу вместе с командой восстановления. Устройство, которое никогда не освобождается или снова захватывается, пока это открытие ждёт, расходует весь бюджет, что расширяет рамки тайм-аута этой команды, а не съедает их.

orientation

Устанавливает ориентацию устройства на iOS и Android. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • orientationenumобязательный
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

perf

Собирает показатели здоровья кадров, диагностику памяти и артефакты профилирования платформы с компактными сводками, понятными агенту. Для CPU-профилей start и stop записывают исходный артефакт, а report записывает компактную сводку; запросите отчёт, когда задаче нужны читаемые нативные данные CPU. Результат профилирования - только доказательство: компактное состояние, путь к артефакту и размер. Таймаут - 90 секунд.

Параметры
  • actionenum
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • areaenumобязательный
  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • kindenum
  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • outstring

    Здесь нет артефакта, путь которого можно вывести. В этом диалоге я только переводил текст — никаких файлов или артефактов не создавалось. Если вы имели в виду что-то другое, уточните, пожалуйста.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • subjectenum
  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • templatestring

    Название шаблона xctrace, например Time Profiler.

  • tenantstring

    Идентификатор удаленного тенанта.

  • tracePathstring

    Существующий путь к файлу .trace для отчёта, по умолчанию используется последний след сессии.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

press

Коротко нажимает на цель UI по snapshot ref, селектору или координатам. Вместо этого нужен longpress, когда цели требуется контекстное меню или жест удержания. Успех означает, что нажатие отправлено, а не что оно сработало: чтобы подтвердить результат, есть settle или verify, либо можно дождаться нужного экрана. Цель, заданная ref или селектором, перед отправкой повторно проверяется на движение, если предыдущее действие сессии только что анимировало экран, и нажатие отправляется в её позиции покоя; если цель не остановилась, она отказывает с target_still_moving, а не действует там, где была. Завершается по тайм-ауту через 90 с; бюджет, заданный вызывающей стороной, продлевает его.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • countinteger

    Количество повторений нажатия/клика.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger

    Глубина обхода снимка.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • doubleTapboolean

    Запрашивает действие двойного касания.

  • holdMsinteger

    Длительность удержания для каждого действия.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • intervalMsinteger

    Задержка между повторными нажатиями/кликами.

  • jitterPxinteger

    Радиус рандомизации в пикселях.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean

    Использует сырые данные снимка при разрешении селектора.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring

    Snapshot scope selector используется перед разрешением.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetobjectобязательный

    UI target. Это отдельно от deviceTarget, который выбирает форм-фактор устройства.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • verifyboolean

    Захватывает дешёвые свидетельства после действия (дайджест AX, количество узлов, changedFromBefore) вместо последующего снимка.

push

Доставляет полезную нагрузку push-уведомлений в установленное приложение. Таймаут: 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appstringобязательный
  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • payloadstring | objectобязательный
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

react-native

Запускает поддерживаемые хелперы автоматизации React Native. Использует dismiss-overlay, чтобы закрыть видимый оверлей ошибки разработки, прежде чем продолжить обычную автоматизацию UI. Тайм-аут наступает через 90 секунд.

Параметры
  • actionenumобязательный
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

record

Запускает или останавливает запись экрана для активного сеанса приложения или, если поддерживается, для выбранного устройства, либо создаёт контактный лист PNG из уже экспортированной записи. Длинные записи Android могут возвращать несколько видеофрагментов; HarmonyOS поддерживает запись всего экрана на физических устройствах. Тайм-аут наступает через 90 секунд.

Параметры
  • actionenumобязательный
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • fpsinteger
  • hideTouchesboolean
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • pathstring
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • qualityenum
  • recordingScopeenum
  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

reinstall

Заменяет установленное приложение на бинарный файл из локального пути. Используйте его, когда нужно сохранить ту же идентичность приложения при установке новой сборки на выбранное устройство. Завершается по тайм-ауту через 180 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appstringобязательный
  • appPathstringобязательный

    Путь к бинарному файлу приложения.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

replay

Запускает записанный сценарий автоматизации, включая совместимые сценарии Maestro YAML. Сценарий без закрытия терминала оставляет свою сессию активной для последующей автоматизации. Тайм-аут наступает через 90 секунд; переданный вызывающей стороной бюджет продлевает его.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • backendstring
  • bundleUrlstring

    Подсказка с URL пакета наследуется сеансами, открытыми повторным воспроизведением.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • envstring[]
  • forceboolean
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • keepSessionboolean

    Оставляет сеанс активным, подавляя ровно одно прописанное закрытие терминала в нативном .ad.

  • leaseIdstring

    Существующий идентификатор аренды.

  • maestroboolean
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • metroHoststring

    Подсказка хоста Metro/debug наследуется сессиями, открытыми через replay.

  • metroPortinteger

    Сеансы, открытые через replay, наследуют подсказку порта Metro/debug.

  • pathstringобязательный
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • resumeFrominteger
  • resumePlanDigeststring
  • runIdstring

    Идентификатор прогона аренды.

  • saveScriptboolean | string
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • testImeboolean

    Активирует headless Android test IME для сессий, которые открывает этот replay (по умолчанию включено для эмуляторов; на реальных устройствах включается вручную).

  • timeoutMsinteger

    Максимальное фактическое время выполнения повторного запроса.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • updateboolean
screenshot

Захватывает снимок экрана активного приложения или веб-сессии. Выбирайте область захвата, плотность, размер или аннотации через соответствующие поля ввода при необходимости. Завершается по тайм-ауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • cropOnstring

    Выражение селектора; захват обрезается до кадра, в который разрешается селектор на том же экране.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • fullscreenboolean
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • normalizeStatusBarboolean
  • overlayRefsboolean
  • pathstring

    Путь вывода.

  • pixelDensityinteger

    Выводит плотность пикселей скриншота в пикселях на логическую точку.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scalenumber

    Коэффициент масштабирования снимка экрана.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • stabilizeboolean
  • surfaceenum
  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

scroll

Прокручивает в заданном направлении или к верхнему/нижнему краю прокручиваемого содержимого. Устанавливает until в селектор, чтобы достичь целевого элемента за пределами экрана одной командой, а не циклом «прокрути и проверь». Необязательный параметр amount задаёт долю пути пальца по оси области просмотра, которая учитывается до 0,8 от неё; направленные прокрутки снижают инерцию после отпускания, а физика прокрутки приложения определяет итоговое смещение контента. Видимая клавиатура сокращает зону свайпа вместо того, чтобы скрываться; когда остаётся слишком мало места, команда отказывается с ошибкой scroll_keyboard_occludes_surface. Направленная прокрутка также сообщает замеченное движение в параметре movement: moved, at-edge, unchanged или unobserved, когда два чтения не могут подтвердить ни одно из утверждений в ту или иную сторону; неизменённая поверхность внутри контейнера, который всё ещё скрывает содержимое в этом направлении, отказывается с ошибкой scroll_no_progress, а не повторяет запрошенное расстояние. Поле movement отсутствует там, где уровень проверяет за проход (top/bottom, until), где среда выполнения не может прочитать экран или где наблюдение за устаканиванием или повторное воспроизведение уже владеет этим наблюдением. Завершается по тайм-ауту через 90 с; бюджет, переданный вызывающей стороной, продлевает его.

Параметры
  • amountnumber

    Величина прокрутки платформы.

  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • directionenumобязательный
  • durationMsinteger

    Длительность прокрутки в миллисекундах, если бэкенд поддерживает регулировку темпа.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • pixelsinteger

    Величина прокрутки в пикселях.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settleboolean

    После выполнения действия ожидает завершения обновления UI и возвращает окончательную разницу между состоянием после действия и исходным деревом в том же ответе. По возможности; действие никогда не завершается сбоем.

  • settleQuietMsinteger

    Settle: окно тишины в миллисекундах (по умолчанию 500; 300, когда дерево в стабильном состоянии приходит из моста снимков симулятора iOS). В iOS масштабная замена экрана, например закрытие модального окна, подтверждается не менее 1500 мс, какое бы окно ни запрашивалось, в пределах дедлайна Settle, заданного timeoutMs.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Settle: время ожидания в миллисекундах (по умолчанию 10000).

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • untilstring

    Повторяет проходы прокрутки, пока этот селектор не станет видимым на экране, затем останавливается. Не действует для направлений «верхний/нижний край», у которых есть собственное условие остановки.

session

Перечисляет активные сессии, выводит действующий каталог состояния демона или публикует подготовленный сценарий open-to-destination, не закрывая его сессию. Тайм-аут через 90 секунд.

Параметры
  • actionenum

    list показывает активные сессии; state-dir выводит каталог состояния демона; save-script публикует вооружённую запись без разбора.

  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • forceboolean

    Атомарно заменяет существующую цель save-script.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • pathstring

    Необязательный путь вывода .ad для save-script.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

settings

Считывает или изменяет поддерживаемые настройки операционной системы, масштабы анимации, внешний вид или разрешения приложений на выбранной цели. Поддержка платформ различается в зависимости от настройки и действия. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • appstring

    App - цель изменения, задаётся по bundle id, имени пакета или имени приложения: приложение, состояние которого очищает clear-app-state, или приложение, на которое попадает изменение permission (либо изменение приватности location on|off в симуляторе iOS). Имя разрешается в установленное приложение так же, как это делает open (симулятор iOS сопоставляет отображаемые имена и принимает только bundle id установленного приложения, Android принимает только установленный пакет и сопоставляет остальные имена с именами установленных пакетов, а сессия Limrun iOS разрешает только псевдоним settings); приложение, которое ни во что не разрешается, отклоняется с app_not_installed до того, как что-либо изменится. Приложению, указанному здесь, не нужна сессия, и оно не обязано быть запущенным (Android deny|reset удерживаемого разрешения всё же убивает запущенное приложение); без него эти изменения используют приложение сессии, а изменение, действующее на всё устройство, отклоняет такое приложение с setting_app_not_consumed (location set на любой цели, переключатель Android location on|off, разрешения macOS). CLI учитывает его только тогда, когда его передаёт текущий вызов: ни AGENT_DEVICE_TARGET_APP, ни targetApp из конфига никогда не перенацеливают изменение настроек.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • latitudenumber
  • leaseIdstring

    Существующий идентификатор аренды.

  • longitudenumber
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • modeenum
  • noRecordboolean

    Не записывайте это действие.

  • permissionstring
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • settingstringобязательный
  • statestring
  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

shutdown

Выключает выбранный симулятор или эмулятор. Таймаут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

snapshot

Захватывает дерево доступности или сравнивает его с базовым состоянием предыдущей сессии. Использует возвращённые refs для последующих семантических взаимодействий и опцию diff для проверки изменений в интерфейсе. Таймаут истекает через 90 секунд; переданный вызывающей стороной бюджет продлевает его.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • customActionsboolean

    Называет аффордансы элемента, объединённого в один (iOS UIAccessibilityCustomAction, React Native accessibilityActions) — карточка, чьи элементы ответа/управления не являются отдельными элементами, всё равно перечисляет их здесь. Имена предназначены для ПЛАНИРОВАНИЯ, а не для вызова: нет API для их запуска, поэтому достигайте аффорданса через экран деталей элемента, через тот же элемент управления, представленный как помеченный элемент в другом месте, или по координатам из его прямоугольника. Только iOS-симулятор; стоит один цикл обращения к специальным возможностям на каждый объединённый элемент.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger
  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • forceFullboolean
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • interactiveOnlyboolean
  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • observeOnlyboolean

    Только для iOS. Отказывается вместо активации или восстановления session app. Сообщает состояние XCUIApplication, которое не доказывает владение экраном (#2696).

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • rawboolean
  • recordboolean

    Принудительно записывает это внеполосное наблюдение в восстановительно-вооружённое исцеление (взаимоисключающе с noRecord). Авторские шаги воспроизведения записываются автоматически и никогда не требуют этого.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • timeoutMsinteger

    Максимальное реальное время для команды создания снимка.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

swipe

Быстро смахивает по координатам с необязательным шаблоном повтора. Завершается по таймауту через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • countinteger

    Количество повторений смахивания.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • fromobjectобязательный

    Начальная точка свайпа.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • patternenum
  • pauseMsinteger

    Сделайте паузу между повторными свайпами.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • toobjectобязательный

    Конечная точка свайпа.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

test

Запускает один или несколько replay-скриптов как последовательный набор тестов. Передаёт прогресс в потоковом режиме; без фиксированного тайм-аута клиента.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • artifactsDirstring
  • backendstring
  • bundleUrlstring

    Подсказка Bundle URL наследуется каждой тестовой сессией.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • envstring[]
  • failFastboolean
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • maestroboolean
  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • metroHoststring

    Каждая тестовая сессия наследует подсказку хоста Metro/debug.

  • metroPortinteger

    Подсказка о порте Metro/debug, наследуемая каждой тестовой сессией.

  • pathsstring[]обязательный
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • recordVideoboolean
  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • retriesinteger
  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • shardAllinteger
  • shardSplitinteger
  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • testImeboolean

    Активирует headless Android test IME для сессий, которые открывает каждая попытка запуска suite (на эмуляторах включено по умолчанию; на реальных устройствах включается вручную).

  • timeoutMsinteger
  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • updateboolean
trace

Запускает или останавливает захват trace-лога и возвращает получившийся артефакт, когда захват завершается. Без пути start записывает trace-лог с меткой времени, названный по имени сессии, в каталог sessions состояния демона; путь при stop перемещает завершённый trace туда. Тайм-аут наступает через 90 с.

Параметры
  • actionenumобязательный
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • pathstring
  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

trigger-app-event

Запрашивает у приложения обработку события автоматизации или тестирования, определяемого приложением, с необязательной структурированной полезной нагрузкой. Вызывайте этот инструмент только для тех имён событий и форм полезной нагрузки, которые приложение документирует. Время ожидания истекает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • eventstringобязательный

    Название события автоматизации или тестирования, определяемого приложением, которое документирует приложение.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • payloadobject

    Структурированный payload передаётся событию в том виде, который приложение документирует для него.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

tv-remote

Нажимает или удерживает кнопку ТВ-пульта или D-pad на Android TV, tvOS или Vega OS. Выбирает кнопку и необязательную длительность удержания через поля ввода. Псевдонимы ok, center и enter соответствуют select. Тайм-аут: 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • buttonenumобязательный
  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • durationMsinteger

    Длительность нажатия в миллисекундах. tvOS и Vega OS используют точную длительность удержания; Android TV преобразует любое положительное значение в ADB longpress (longpress).

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

type

Добавляет текст в поле ввода, находящееся в фокусе в данный момент. Используйте fill, когда нужно заменить текущее значение поля, и сначала установите фокус на поле, если ни одно поле ввода не активно. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • delayMsinteger

    Задержка между введёнными символами.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • textstringобязательный

    Текст для ввода.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

viewport

Изменяет размер активного веб-вьюпорта перед созданием снимков или скриншотов. Полезно для приложений с фиксированной компоновкой или с высотой 100vh, где изменение вьюпорта открывает другое содержимое. Тайм-аут наступает через 90 секунд.

Параметры
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • heightintegerобязательный

    Высота вьюпорта в CSS-пикселях.

  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

  • widthintegerобязательный

    Ширина вьюпорта в CSS-пикселях.

wait

Ожидает заданную длительность, текст, ссылку на снимок, появление селектора, строгое отсутствие селектора или стабильный интерфейс. Использует целевой критерий строгого отсутствия, когда требуется ноль совпадений селектора; стабильный режим ожидает, пока интерфейс остаётся спокойным в течение запрошенного окна. Тайм-аут наступает через 90 секунд; бюджет, переданный вызывающим кодом, продлевает его.

Параметры
  • absentstring
  • androidDeviceAllowliststring

    Список разрешённых серийных номеров Android, используемый для определения устройства.

  • debugboolean

    Включает отладочную диагностику.

  • depthinteger
  • devicestring

    Селектор имени устройства (UDID указывается в поле udid, серийный номер - в поле serial).

  • deviceTargetenum

    Форма целевого устройства. Соответствует флагу --target в CLI.

  • durationMsinteger
  • includeCostboolean

    Включает per-command agent-cost (cost.wallClockMs, …) в structuredContent. По умолчанию отключено; форма ответа по умолчанию не меняется.

  • kindenum
  • leaseIdstring

    Существующий идентификатор аренды.

  • mcpOutputFormatenum

    Формат текстового содержимого MCP. По умолчанию использует оптимизированный для агентов текст; для JSON-текста используйте json. Структурированное содержимое всегда возвращается отдельно.

  • noRecordboolean

    Не записывайте это действие.

  • platformenum

    Определяет устройство с помощью селектора платформы.

  • quietMsinteger
  • rawboolean
  • refstring
  • responseLevelenum

    Степень подробности ответа: token-cheap digest / default (today) / full. По умолчанию используется default; форма ответа по умолчанию не изменяется.

  • runIdstring

    Идентификатор прогона аренды.

  • scopestring
  • selectorstring
  • serialstring

    Селектор последовательных портов для Android, HarmonyOS или Vega VVD.

  • sessionstring

    Имя сессии агент-устройство.

  • stableboolean
  • targetenum

    Псевдоним для deviceTarget в командах без поля UI target. Интерактивные команды резервируют target для элемента UI.

  • tenantstring

    Идентификатор удаленного тенанта.

  • textstring
  • timeoutMsinteger
  • udidstring

    UDID устройства Apple или симулятора; селектор, который закрепляет одно устройство, когда несколько имеют одинаковое имя.

0.21.28основная
0.21.29-nightly.20261020.76
0.21.29-nightly.20261019.75
0.21.29-nightly.20261018.74
0.21.29-nightly.20261017.73
0.21.29-nightly.20261016.72
0.21.28-nightly.20261015.70
0.21.28-nightly.20261014.57
0.21.28-nightly.20261013.49
0.21.27
0.21.26
0.21.26-nightly.20261012.41
0.21.26-nightly.20261011.35
0.21.25
0.21.24
0.21.23
0.21.22
0.21.21
0.21.20
0.21.19
0.21.18
0.21.17
0.21.16
0.21.15
0.21.14
0.21.13
0.21.12
0.21.11
0.21.10
0.21.9
0.21.8
0.21.7
0.21.6
0.21.5
0.21.4
0.21.3
0.21.2
0.21.1
0.21.0
0.20.10
0.20.9
0.20.8
0.20.7
0.20.6
0.20.5
0.20.4
0.20.3
0.20.2
0.20.1
0.20.0
0.19.3
0.19.2
0.19.1
0.19.0
0.18.3
0.18.2
0.18.1
0.18.0
0.17.10
0.17.9
0.17.8
0.17.7
0.17.6
0.17.5
0.17.4
0.17.3
0.17.2
0.17.1
0.17.0
0.16.14
0.16.13
0.16.12
0.16.11
0.16.10
0.16.9
0.16.8
0.16.7
0.16.6
0.16.5
0.16.4
0.16.2
0.16.1
0.16.0
0.15.2
0.15.1
0.15.0
0.14.9
0.14.8
0.14.7
0.14.6
0.14.5
0.14.4
0.14.3
0.14.2
0.14.1
0.14.0
0.13.3
0.13.2
0.13.1
0.13.0
0.12.9
0.12.8
0.12.7
0.12.6
0.12.5
0.12.4
0.12.3
0.12.2
0.12.1
0.12.0
0.11.16
0.11.15
0.11.14
0.11.13
0.11.12
0.11.11
0.11.10
0.11.9
0.11.8
0.11.7
0.11.6
0.11.5
0.11.4
0.11.3
0.11.2
0.11.1
0.11.0
0.10.3
0.10.2
0.10.1
0.10.0
0.9.0
0.8.6
0.8.5
0.8.4
0.8.3
0.8.2
0.8.1
0.8.0
0.7.22
0.7.21
0.7.20
0.7.19
0.7.18
0.7.17
0.7.16
0.7.15
0.7.14
0.7.13
0.7.12
0.7.11
0.7.10
0.7.9
0.7.6
0.7.5
0.7.4
0.7.3
0.7.2
0.7.1
0.7.0
0.6.3
0.6.2
0.6.1
0.6.0
0.5.5
0.5.4
0.5.3
0.5.2
0.5.1
0.5.0
0.4.2
0.4.1
0.4.0
0.3.5
0.3.4
0.3.3
0.3.2
0.3.1
0.3.0
0.2.6
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.2.0
0.1.9
0.1.8
0.1.7
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить callstackincubator/agent-device:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"callstackincubator-agent-device-sv22o95ofw\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"agent-device@latest\",\"mcp\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add callstackincubator-agent-device-sv22o95ofw -- npx agent-device@latest mcp

Либо через JSON-конфиг:

claude mcp add-json callstackincubator-agent-device-sv22o95ofw "{\"command\":\"npx\",\"args\":[\"agent-device@latest\",\"mcp\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add callstackincubator-agent-device-sv22o95ofw -- npx agent-device@latest mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.callstackincubator-agent-device-sv22o95ofw]
command = "npx"
args = ["agent-device@latest", "mcp"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите callstackincubator/agent-device, а в поле команды запуска — строку ниже:
npx agent-device@latest mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например callstackincubator-agent-device-sv22o95ofw.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: callstackincubator-agent-device-sv22o95ofw
    command: npx
    args:
      - "agent-device@latest"
      - "mcp"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "callstackincubator-agent-device-sv22o95ofw": {
      "command": "npx",
      "args": [
        "agent-device@latest",
        "mcp"
      ]
    }
  }
}

Похожие MCP-сервера

hyperb1iss/droidmind

hyperb1iss/droidmind

от hyperb1iss

DroidMind связывает AI-ассистентов с Android-устройствами через MCP. Управляйте приложениями, анализируйте логи, автоматизируйте UI и выполняйте shell-команды на естественном языке. Полезен разрабо...

Python⭐ 440
martingeidobler/android-mcp-server

martingeidobler/android-mcp-server

от martingeidobler

MCP сервер для управления Android через ADB: AI ассистент видит экран, тапает элементы, читает логи и устанавливает приложения. Включает 25 инструментов для отладки и тестирования без модификации кода. Полезен Android-разработчикам и тестировщикам.

TypeScript⭐ 68
mobile-next/mobile-mcp

mobile-next/mobile-mcp

от mobile-next

Mobile Next управляет iOS и Android: запускает приложения, кликает по экрану и выгружает данные с него на эмуляторах, симуляторах и реальных устройствах.

TypeScript⭐ 9785
Neverlow512/agent-droid-bridge

Neverlow512/agent-droid-bridge

от neverlow512

MCP-сервер для подключения AI-агентов к Android-устройствам через ADB. Используется в мобильной автоматизации, тестировании и реверс-инжиниринге: скриншоты, касания, ввод текста, управление приложе...

Python⭐ 22
ambar/simctl-mcp

ambar/simctl-mcp

от ambar

MCP сервер для iOS Simulator автоматизирует: управление устройствами и приложениями, отправку push-уведомлений, работу с буфером обмена. Полезен iOS-разработчикам и QA-инженерам для тестирования.

TypeScript⭐ 20
joshuarileydev/simulator-mcp-server

joshuarileydev/simulator-mcp-server

от joshuarileydev

MCP-сервер для управления iOS симуляторами: запуск, остановка, установка .app и запуск приложений по bundle ID. Полезен iOS-разработчикам для автоматизации тестирования и CI/CD.

JavaScript⭐ 53
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин