runcloud 0.2.190 → 0.2.192

package/dist/commands/run-cloud-fleet-release-control.js

@@ -0,0 +1,24 @@
+import { readFileSync, statSync } from 'node:fs';
+const path = '/run-cloud/admin/fleet-release-control';
+export function releaseControlRequest(file) {
+    const stat = statSync(file);
+    if (!stat.isFile() || stat.size > 512 * 1024)
+        throw new Error('Use a JSON request file smaller than 512 KiB');
+    const value = JSON.parse(readFileSync(file, 'utf8'));
+    if (!value || typeof value !== 'object' || Array.isArray(value) || typeof value.reason !== 'string' || !value.reason.trim()
+        || !Number.isSafeInteger(value.expectedRevision) || Number(value.expectedRevision) < 0
+        || !['bootstrap', 'enroll', 'announce', 'override', 'pause', 'resume', 'rollback', 'defer'].includes(String(value.action))) {
+        throw new Error('Request needs action, reason and expectedRevision from the current release-control status');
+    }
+    return value;
+}
+export function registerFleetReleaseControlCommands(fleet, client, action) {
+    const release = fleet.command('release-control').description('Audited fleet targets and coordinated health-gated serve-sim rollouts');
+    release.command('status').description('Read targets, rollout stages, gate values and audit history').action(() => action(async () => {
+        console.log(JSON.stringify(await client().get(path, { signal: AbortSignal.timeout(30000) }), null, 2));
+    }));
+    release.command('apply <request.json>').description('Apply an audited target or rollout request; pause stops new grants while existing holders finish safely')
+        .action((file) => action(async () => {
+        console.log(JSON.stringify(await client().post(path, releaseControlRequest(file), { signal: AbortSignal.timeout(30000) }), null, 2));
+    }));
+}

package/dist/commands/run-cloud-fleet.js

@@ -5,6 +5,7 @@ import { ApiClient, ApiError } from '../api.js';
 import { requireCredentials } from '../config.js';
 import { surveyFleet, surveyText } from './run-cloud-fleet-survey.js';
 import { listReleaseChannels, promoteReleaseChannel, releaseText } from './run-cloud-fleet-releases.js';
+import { registerFleetReleaseControlCommands } from './run-cloud-fleet-release-control.js';
 const ROOT = '/run-cloud/admin/simulators';
 const RANGES = ['1h', '6h', '24h', '7d', '30d', '90d', '1y', '2y'];
 export const ACCESSIBILITY_CODES = ['accessibility_device_unavailable', 'accessibility_capture_failed'];
@@ -303,6 +304,7 @@ function printReport(report, json) {
 }
 export function registerRunCloudFleet(program) {
     const fleet = program.command('fleet').description('Admin fleet telemetry, diagnosis, events, failure evidence and serve-sim release channels');
+    registerFleetReleaseControlCommands(fleet, credentialsClient, action);
     fleet.command('survey [hostId]').description('Survey all fleet signals in seconds; authenticated admin reads, no local services')
         .option('--json', 'Structured metrics, diagnosis, observations and coverage')
         .option('--range <range>', 'Alert/input-lag window: 1h, 6h, 24h, 7d', '24h')

package/dist/commands/run-cloud.js

@@ -1033,6 +1033,52 @@ async function openSimulatorSessionUrl(platform, sessionId, url) {
         throw error;
     }
 }
+function parseCoordinate(value, name) {
+    const limit = name === 'latitude' ? 90 : 180;
+    const parsed = Number(value);
+    if (value.trim() === '' || !Number.isFinite(parsed) || Math.abs(parsed) > limit) {
+        throw new Error(`--${name} must be a number between -${limit} and ${limit}`);
+    }
+    return parsed;
+}
+async function setSimulatorSessionLocation(platform, sessionId, point) {
+    const path = `/run-cloud/${platform}/${encodeURIComponent(sessionId)}/location`;
+    try {
+        const response = (point ? await client().post(path, point) : await client().delete(path));
+        const result = typeof response === 'object' && response !== null && !Array.isArray(response)
+            ? response
+            : {};
+        if (result.ok !== true || result.platform !== platform || result.sessionId !== sessionId || result.cleared !== (point === null)) {
+            throw new ApiError(0, 'Simulator location returned an invalid acknowledgement', path, {
+                code: 'location_invalid_response',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'location',
+            });
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ApiTransportError) {
+            throw new ApiError(0, 'Simulator location could not reach the run.cloud API', path, {
+                code: 'location_transport_error',
+                retryable: true,
+                sessionId,
+                platform,
+                action: 'location',
+            });
+        }
+        if (error instanceof ApiError) {
+            Object.assign(error, {
+                sessionId: error.sessionId ?? sessionId,
+                platform: error.platform ?? platform,
+                action: error.action ?? 'location',
+            });
+        }
+        throw error;
+    }
+}
 function registerSimulatorCommands(program, platform) {
     const label = platform === 'android' ? 'Android emulator' : 'iOS simulator';
     const article = platform === 'android' ? 'an' : 'an';
@@ -1133,6 +1179,33 @@ function registerSimulatorCommands(program, platform) {
         .action((url, opts) => action(async () => {
         print(await openSimulatorSessionUrl(platform, opts.id, url), opts);
     }, opts));
+    const location = simulator
+        .command('location')
+        .description(`Set or clear the simulated GPS location of ${article} ${label} session`);
+    location
+        .command('set')
+        .description('Set the simulated location (WGS84 degrees)')
+        .argument('<id>', 'session id')
+        .requiredOption('--latitude <degrees>', 'latitude from -90 to 90')
+        .requiredOption('--longitude <degrees>', 'longitude from -180 to 180')
+        .option('--json', 'output JSON', false)
+        .action((id, opts) => action(async () => {
+        const point = {
+            latitude: parseCoordinate(opts.latitude, 'latitude'),
+            longitude: parseCoordinate(opts.longitude, 'longitude'),
+        };
+        print(await setSimulatorSessionLocation(platform, id, point), opts);
+    }, opts));
+    location
+        .command('clear')
+        .description(platform === 'android'
+        ? 'Return to the emulator default location'
+        : 'Remove the simulated location')
+        .argument('<id>', 'session id')
+        .option('--json', 'output JSON', false)
+        .action((id, opts) => action(async () => {
+        print(await setSimulatorSessionLocation(platform, id, null), 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.190';
+export const CLI_VERSION = '0.2.192';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcloud",
-  "version": "0.2.190",
+  "version": "0.2.192",
   "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`, `logs`, and `delete`. Use `--json` whenever
+`create`, `list`, `get`, `open-url`, `location set|clear`, `logs`, and `delete`. Use `--json` whenever
 another program consumes output, and inspect `runcloud ios|android --help` for
 create and log options.