runcloud 0.2.199 → 0.2.200

package/README.md

@@ -64,6 +64,8 @@ runcloud ios create --model iphone --install ./MyApp.app   # boot a simulator an
 runcloud ios list                                          # list active sessions
 runcloud ios get <id>                                      # inspect a session (viewer URL, status)
 runcloud ios open-url myapp://path --id <id>               # open a URL or deep link
+runcloud ios settings <id> --json                          # read device settings (on-screen keyboard mode)
+runcloud ios settings <id> --soft-keyboard hidden          # auto, hidden, or shown
 runcloud ios tap <id> 0.5 0.75                             # normalized top-left display coordinates
 runcloud ios type-text <id> "Hello from iOS!"              # printable US ASCII, tab, and line feed
 runcloud ios accessibility-tree <id> --json                # read the current typed accessibility hierarchy
@@ -84,6 +86,7 @@ runcloud ios delete <id>                                   # release the session
 runcloud android create --model pixel
 runcloud android swipe <id> 0.5 0.8 0.5 0.2 --duration 250
 runcloud android press-key <id> enter
+runcloud android settings <id> --soft-keyboard auto --json
 runcloud android accessibility-tree <id> --json
 runcloud android camera inject <id> ./quadrants.mp4 --bundle-id com.example.Camera
 runcloud android mic inject <id> ./tone.wav --bundle-id com.example.Recorder

package/dist/commands/run-cloud.js

@@ -1053,6 +1053,54 @@ async function setSimulatorSessionLocation(platform, sessionId, point) {
         throw error;
     }
 }
+const SOFT_KEYBOARD_MODES = ['auto', 'hidden', 'shown'];
+function parseSoftKeyboardMode(value) {
+    if (SOFT_KEYBOARD_MODES.includes(value))
+        return value;
+    throw new InvalidArgumentError(`must be one of ${SOFT_KEYBOARD_MODES.join(', ')}`);
+}
+async function simulatorSessionSettings(platform, sessionId, softKeyboard) {
+    const path = `/run-cloud/${platform}/${encodeURIComponent(sessionId)}/settings`;
+    try {
+        const response = (softKeyboard ? await client().patch(path, { softKeyboard }) : await client().get(path));
+        const result = typeof response === 'object' && response !== null && !Array.isArray(response)
+            ? response
+            : {};
+        if (result.ok !== true
+            || result.platform !== platform
+            || result.sessionId !== sessionId
+            || !SOFT_KEYBOARD_MODES.includes(result.softKeyboard)
+            || (softKeyboard !== undefined && result.softKeyboard !== softKeyboard)) {
+            throw new ApiError(0, 'Simulator settings returned an invalid acknowledgement', path, {
+                code: 'keyboard_setting_invalid_response',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'settings',
+            });
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ApiTransportError) {
+            throw new ApiError(0, 'Simulator settings could not reach the run.cloud API', path, {
+                code: 'keyboard_setting_transport_error',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'settings',
+            });
+        }
+        if (error instanceof ApiError) {
+            Object.assign(error, {
+                sessionId: error.sessionId ?? sessionId,
+                platform: error.platform ?? platform,
+                action: error.action ?? 'settings',
+            });
+        }
+        throw error;
+    }
+}
 function registerSimulatorCommands(program, platform) {
     const label = platform === 'android' ? 'Android emulator' : 'iOS simulator';
     const article = platform === 'android' ? 'an' : 'an';
@@ -1180,6 +1228,15 @@ function registerSimulatorCommands(program, platform) {
         .action((id, opts) => action(async () => {
         print(await setSimulatorSessionLocation(platform, id, null), opts);
     }, opts));
+    simulator
+        .command('settings')
+        .description(`Show or change the device settings of ${article} ${label} session`)
+        .argument('<id>', 'session id')
+        .option('--soft-keyboard <mode>', 'on-screen keyboard: auto (hide while a hardware keyboard types), hidden, or shown', parseSoftKeyboardMode)
+        .option('--json', 'output JSON', false)
+        .action((id, opts) => action(async () => {
+        print(await simulatorSessionSettings(platform, id, opts.softKeyboard), opts);
+    }, opts));
     addInteractionOptions(simulator
         .command('tap')
         .description(`Tap normalized display coordinates in ${article} ${label} session`)

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.2.199';
+export const CLI_VERSION = '0.2.200';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcloud",
-  "version": "0.2.199",
+  "version": "0.2.200",
   "description": "Create and control run.cloud remote mobile simulators and cloud sandboxes",
   "license": "Apache-2.0",
   "keywords": [

package/skills/run-cloud-ios-simulator/SKILL.md

@@ -40,7 +40,7 @@ runcloud ios get "$SESSION_ID" --json
 ```
 
 Replace `ios` with `android` for an Android artifact. The shared lifecycle is
-`create`, `list`, `get`, `open-url`, `location set|clear`, `logs`, and `delete`. Use `--json` whenever
+`create`, `list`, `get`, `open-url`, `location set|clear`, `settings`, `logs`, and `delete`. Use `--json` whenever
 another program consumes output, and inspect `runcloud ios|android --help` for
 create and log options.