feat: add startNativeSession tool for native automation sessions (KOB-54362, 1.11.0) - #116
Merged
Conversation
…-54362) Expose a Sessions-domain tool that starts a native automation session (XCUITest on iOS, UIAutomator on Android, or GameDriver) on a Kobiton device. Only userIntent and testFramework are required; device targeting accepts an exact udid or deviceName/platformVersion matching, and the app under test plus test-runner bundle are passed as kobiton-store identifiers from uploadAppToStore. Also documents the previously missing getOrgSettings row in the README tools table and corrects the tool count to 31. Version 1.10.0 (package.json is the source of truth; manifests synced via pnpm run build:version). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: cuongktran <trankiencuong10@gmail.com>
TranKienCuong
force-pushed
the
KOB-54362
branch
from
August 14, 2026 04:54
42a2672 to
78b5c24
Compare
duchnguyen
reviewed
Aug 19, 2026
duchnguyen
reviewed
Aug 19, 2026
duchnguyen
reviewed
Aug 19, 2026
duchnguyen
reviewed
Aug 19, 2026
- deviceGroup enum: CLOUD was never a valid value server-side (the device-pool switch handles KOBITON / ORGANIZATION / ANY and defaults to ANY) — an agent picking CLOUD would get an opaque no-devices failure. Replaced with ANY and documented all three values. - noReset / fullReset: documented as mutually exclusive. - runCommand: documented as ignored for XCUITEST and UIAUTOMATOR. - app / testRunner: documented as required for XCUITEST and UIAUTOMATOR (server-side validation rejects the call when omitted); kept out of the schema-level required list for GameDriver flexibility. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: cuongktran <trankiencuong10@gmail.com>
duchnguyen
approved these changes
Aug 20, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds
startNativeSessionto the Sessions domain — start a native automation session (XCUITest on iOS, UIAutomator on Android, or GameDriver) on a Kobiton device directly from an AI agent, without hand-crafted JSON-RPC.Changes
tools/sessions.yaml: newstartNativeSessiontool definition. OnlyuserIntentandtestFrameworkare required; device targeting accepts an exactudidordeviceName/platformVersionmatching; the app under test and test-runner bundle are passed as store identifiers fromuploadAppToStore. Annotations follow the resource-creating pattern (readOnlyHint/destructiveHint/idempotentHint/openWorldHintall false).README.md: tool count 31; row added to the Sessions table.package.jsonsource of truth; manifests synced viapnpm run build:version; CHANGELOG entry added).Notes
listDevicesfirst.sessionTimeout/testTimeoutare in minutes;deviceWaitTimeoutis in seconds and only honored for queued executions.🤖 Generated with Claude Code