runcloud 0.2.191 → 0.2.193

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`)
@@ -1448,8 +1521,38 @@ function registerSimulatorCommands(program, platform) {
                 writeSimulatorLogEntry(entry, opts.json === true);
         }
     }, opts));
+    if (platform === 'ios') {
+        simulator
+            .command('crashes')
+            .description('Show native crash reports from an active iOS session, symbolicated from Xcode build dSYMs')
+            .argument('<id>')
+            .option('--json', 'output JSON', false)
+            .action((id, opts) => action(async () => {
+            const result = await client().get(`/run-cloud/ios/${encodeURIComponent(id)}/crashes`);
+            if (opts.json) {
+                print(result, opts);
+                return;
+            }
+            const crashes = Array.isArray(result.crashes) ? result.crashes : [];
+            if (crashes.length === 0)
+                console.error('No crash reports captured for this lease.');
+            for (const crash of crashes)
+                console.log(formatSimulatorCrash(crash));
+        }, opts));
+    }
     return simulator;
 }
+export function formatSimulatorCrash(crash) {
+    const exception = [crash.exception?.type, crash.exception?.signal].filter(Boolean).join(' / ');
+    const lines = [`${crash.capturedAt} ${crash.process ?? 'unknown process'}${exception ? ` — ${exception}` : ''} (${crash.symbolication ?? 'unknown'})`];
+    const thread = crash.threads?.find((candidate) => candidate.crashed) ?? crash.threads?.[0];
+    for (const frame of thread?.frames.slice(0, 32) ?? []) {
+        const location = frame.file ? ` (${frame.file}${frame.line ? `:${frame.line}` : ''})` : '';
+        const name = frame.symbol ?? `${frame.address}${frame.marker ? ` [${frame.marker}]` : ''}`;
+        lines.push(`  ${String(frame.index).padStart(2)} ${(frame.image ?? '???').padEnd(24)} ${name}${location}`);
+    }
+    return lines.join('\n');
+}
 function jsonErrorEnvelope(error) {
     if (error instanceof ApiError) {
         return {

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.2.191';
+export const CLI_VERSION = '0.2.193';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcloud",
-  "version": "0.2.191",
+  "version": "0.2.193",
   "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.