@expo/build-tools 22.3.0 → 22.5.0

package/dist/ios/xcode.d.ts

@@ -0,0 +1,3 @@
+export declare function getXcodeVersionAsync({ env }: {
+    env: NodeJS.ProcessEnv;
+}): Promise<string>;

package/dist/ios/xcode.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getXcodeVersionAsync = getXcodeVersionAsync;
+const eas_build_job_1 = require("@expo/eas-build-job");
+const turtle_spawn_1 = __importDefault(require("@expo/turtle-spawn"));
+async function getXcodeVersionAsync({ env }) {
+    let stdout;
+    try {
+        ({ stdout } = await (0, turtle_spawn_1.default)('xcodebuild', ['-version'], { stdio: 'pipe', env }));
+    }
+    catch (error) {
+        throw new eas_build_job_1.SystemError('Failed to get Xcode version', { cause: error });
+    }
+    const version = /^Xcode\s+(\d+(?:\.\d+)*)$/m.exec(stdout)?.[1];
+    if (!version) {
+        throw new eas_build_job_1.SystemError(`Failed to determine Xcode version from: ${stdout.trim()}`);
+    }
+    return version;
+}

package/dist/steps/functions/downloadBuild.js

@@ -19,6 +19,8 @@ const node_path_1 = __importDefault(require("node:path"));
 const stream_1 = __importDefault(require("stream"));
 const util_1 = require("util");
 const zod_1 = require("zod");
+const bplist_parser_1 = __importDefault(require("bplist-parser"));
+const plist_1 = __importDefault(require("plist"));
 const artifacts_1 = require("../../utils/artifacts");
 const files_1 = require("../../utils/files");
 const retryOnDNSFailure_1 = require("../../utils/retryOnDNSFailure");
@@ -163,12 +165,34 @@ async function downloadBuildAsync(params) {
         onlyFiles: false,
         onlyDirectories: false,
     });
+    let matchingFilesRoot = extractionDirectory;
+    if (matchingFiles.length === 0 &&
+        extensions.includes('app') &&
+        (await isIosAppBundleAsync(extractionDirectory))) {
+        const appBundlePath = `${extractionDirectory}.app`;
+        await node_fs_1.default.promises.rename(extractionDirectory, appBundlePath);
+        matchingFiles.push(appBundlePath);
+        matchingFilesRoot = node_path_1.default.dirname(appBundlePath);
+    }
     if (matchingFiles.length === 0) {
         throw new eas_build_job_1.UserError('EAS_DOWNLOAD_BUILD_NO_MATCHING_FILES', `No ${extensions.map(ext => `.${ext}`).join(', ')} entries found in the archive.`);
     }
-    logger.info(`Found ${matchingFiles.length} matching ${(0, strings_1.pluralize)(matchingFiles.length, 'entry')}:\n${matchingFiles.map(f => `- ${node_path_1.default.relative(extractionDirectory, f)}`).join('\n')}`);
+    logger.info(`Found ${matchingFiles.length} matching ${(0, strings_1.pluralize)(matchingFiles.length, 'entry')}:\n${matchingFiles.map(f => `- ${node_path_1.default.relative(matchingFilesRoot, f)}`).join('\n')}`);
     return { artifactPath: matchingFiles[0] };
 }
+async function isIosAppBundleAsync(directory) {
+    try {
+        const infoPlist = await node_fs_1.default.promises.readFile(node_path_1.default.join(directory, 'Info.plist'));
+        const isBinaryPlist = infoPlist.subarray(0, 8).toString('ascii') === 'bplist00';
+        const parsedInfoPlist = (isBinaryPlist
+            ? bplist_parser_1.default.parseBuffer(infoPlist)[0]
+            : plist_1.default.parse(infoPlist.toString('utf8')));
+        return parsedInfoPlist?.CFBundlePackageType === 'APPL';
+    }
+    catch {
+        return false;
+    }
+}
 function parseHttpApplicationArchiveUrl(value) {
     try {
         const applicationArchiveUrl = zod_1.z.string().parse(value);

package/dist/steps/functions/installMaestro.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createInstallMaestroBuildFunction = createInstallMaestroBuildFunction;
 exports.installIdbFromBrew = installIdbFromBrew;
+const downloader_1 = __importDefault(require("@expo/downloader"));
 const eas_build_job_1 = require("@expo/eas-build-job");
 const results_1 = require("@expo/results");
 const steps_1 = require("@expo/steps");
@@ -16,6 +17,10 @@ const path_1 = __importDefault(require("path"));
 const semver_1 = __importDefault(require("semver"));
 const maestroBackend_1 = require("./maestroBackend");
 const datadog_1 = require("../../datadog");
+const xcode_1 = require("../../ios/xcode");
+const IosSimulatorUtils_1 = require("../../utils/IosSimulatorUtils");
+const download_1 = require("../../utils/download");
+const MAESTRO_RUNNER_WDA_CACHE_DOWNLOAD_TIMEOUT_MS = 20_000;
 function createInstallMaestroBuildFunction() {
     return new steps_1.BuildFunction({
         namespace: 'eas',
@@ -118,10 +123,12 @@ function createInstallMaestroBuildFunction() {
                             requestedVersion === 'latest' ||
                             (requestedVersion === undefined &&
                                 (!currentMaestroRunnerVersion || semver_1.default.gt(currentMaestroRunnerVersion, '1.1.15'))))) {
-                        const xcodeVersion = await getXcodeVersion({ env });
+                        // `getXcodeVersionAsync` returns the raw version (e.g. "16.4"), which
+                        // `semver.coerce` normalizes (e.g. "16.4.0") for comparison and display.
+                        const xcodeVersion = semver_1.default.coerce(await (0, xcode_1.getXcodeVersionAsync)({ env }));
                         // maestro-runner 1.1.16 added `arch` to its xcodebuild destination. Xcode versions
                         // below 26 reject that option, so use the last compatible maestro-runner version.
-                        if (semver_1.default.lt(xcodeVersion, '26.0.0')) {
+                        if (xcodeVersion && semver_1.default.lt(xcodeVersion, '26.0.0')) {
                             if (requestedMaestroRunnerVersion) {
                                 throw new eas_build_job_1.UserError('ERR_MAESTRO_INVALID_INPUT', `maestro-runner ${requestedVersion} is not compatible with Xcode ${xcodeVersion}. Use maestro-runner 1.1.15 or an Xcode 26+ image.`);
                             }
@@ -147,6 +154,12 @@ function createInstallMaestroBuildFunction() {
                 logger.error(maestroVersionResult.reason, 'Failed to get Maestro version.');
                 throw new Error(`Failed to ensure ${backend} is installed.`);
             }
+            if (backend === 'maestro-runner' && global.runtimePlatform === steps_1.BuildRuntimePlatform.DARWIN) {
+                await installMaestroRunnerWdaCache({
+                    logger,
+                    env,
+                });
+            }
             logger.info(`${backend} ${maestroVersionResult.value} is ready.`);
             outputs.maestro_version.set(maestroVersionResult.value);
             datadog_1.Datadog.distribution('eas.maestro.install', 1, {
@@ -156,19 +169,87 @@ function createInstallMaestroBuildFunction() {
         },
     });
 }
-async function getXcodeVersion({ env }) {
-    let stdout;
+async function installMaestroRunnerWdaCache({ logger, env, }) {
+    if (!env.HOME) {
+        logger.warn('Skipping the prebuilt WebDriverAgent cache because the $HOME environment variable is empty.');
+        return;
+    }
+    const maestroRunnerHome = path_1.default.join(env.HOME, '.maestro-runner');
     try {
-        ({ stdout } = await (0, turtle_spawn_1.default)('xcodebuild', ['-version'], { stdio: 'pipe', env }));
+        const wdaVersion = await getMaestroRunnerWdaVersion({ maestroRunnerHome });
+        if (!wdaVersion) {
+            logger.info('Skipping the prebuilt WebDriverAgent cache because the installed WDA version is unknown.');
+            return;
+        }
+        const xcodeVersion = await (0, xcode_1.getXcodeVersionAsync)({ env });
+        const iosRuntimes = await IosSimulatorUtils_1.IosSimulatorUtils.getAvailableRuntimesAsync({ env });
+        const iosRuntimeIdentifierPrefix = 'com.apple.CoreSimulator.SimRuntime.iOS-';
+        // maestro-runner derives its WDA cache key from the runtime identifier, not from the runtime
+        // version. These values can differ for patched runtimes, for example the iOS-26-3 identifier
+        // can report version 26.3.1.
+        const iosRuntimeVersions = [
+            ...new Set(iosRuntimes.map(runtime => runtime.identifier.slice(iosRuntimeIdentifierPrefix.length).replaceAll('-', '.'))),
+        ];
+        if (iosRuntimeVersions.length === 0) {
+            logger.info('Skipping the prebuilt WebDriverAgent cache because no iOS runtime is available.');
+            return;
+        }
+        const tempDirectory = await fs_1.default.promises.mkdtemp(path_1.default.join(os_1.default.tmpdir(), 'install_maestro_runner_wda_cache'));
+        try {
+            const archivePath = path_1.default.join(tempDirectory, 'wda-cache.tar.gz');
+            const directArchiveUrl = `https://storage.googleapis.com/turtle-v2/maestro-runner-wda-cache/` +
+                `xcode-${encodeURIComponent(xcodeVersion)}-wda-${encodeURIComponent(wdaVersion)}.tar.gz`;
+            const proxiedArchiveUrl = (0, download_1.getProxiedDownloadUrl)({
+                directUrl: directArchiveUrl,
+                proxyBaseUrl: env.EAS_BUILD_COCOAPODS_CACHE_URL,
+            });
+            logger.info(`Downloading the prebuilt WebDriverAgent cache for Xcode ${xcodeVersion}`);
+            if (proxiedArchiveUrl) {
+                try {
+                    await (0, downloader_1.default)(proxiedArchiveUrl, archivePath, {
+                        retry: 3,
+                        timeout: MAESTRO_RUNNER_WDA_CACHE_DOWNLOAD_TIMEOUT_MS,
+                    });
+                }
+                catch (err) {
+                    logger.debug({ err }, 'Failed to download the prebuilt WebDriverAgent cache via the proxy; falling back to the direct URL.');
+                    await (0, downloader_1.default)(directArchiveUrl, archivePath, {
+                        retry: 3,
+                        timeout: MAESTRO_RUNNER_WDA_CACHE_DOWNLOAD_TIMEOUT_MS,
+                    });
+                }
+            }
+            else {
+                await (0, downloader_1.default)(directArchiveUrl, archivePath, {
+                    retry: 3,
+                    timeout: MAESTRO_RUNNER_WDA_CACHE_DOWNLOAD_TIMEOUT_MS,
+                });
+            }
+            await fs_1.default.promises.mkdir(maestroRunnerHome, { recursive: true });
+            await (0, turtle_spawn_1.default)('tar', ['-xzf', archivePath, '-C', maestroRunnerHome], { logger, env });
+            const genericProductsDirectory = path_1.default.join(maestroRunnerHome, 'cache', 'wda-builds', 'generic', 'DerivedData', 'Build', 'Products');
+            for (const runtimeVersion of iosRuntimeVersions) {
+                const productsDirectory = path_1.default.join(maestroRunnerHome, 'cache', 'wda-builds', `sim-ios${runtimeVersion}-iphone`, 'DerivedData', 'Build', 'Products');
+                await fs_1.default.promises.cp(genericProductsDirectory, productsDirectory, { recursive: true });
+            }
+            logger.info(`Installed the prebuilt WebDriverAgent cache for iOS ${iosRuntimeVersions.join(', ')}.`);
+        }
+        finally {
+            await fs_1.default.promises.rm(tempDirectory, { force: true, recursive: true });
+        }
     }
-    catch (error) {
-        throw new eas_build_job_1.SystemError('Failed to get Xcode version', { cause: error });
+    catch (err) {
+        logger.warn({ err }, 'Failed to install the prebuilt WebDriverAgent cache. maestro-runner will build WebDriverAgent when it is needed.');
     }
-    const xcodeVersion = semver_1.default.coerce(/^Xcode\s+(\S+)/m.exec(stdout)?.[1])?.version;
-    if (!xcodeVersion) {
-        throw new eas_build_job_1.SystemError(`Failed to parse Xcode version from xcodebuild output: ${stdout.trim()}`);
+}
+async function getMaestroRunnerWdaVersion({ maestroRunnerHome, }) {
+    try {
+        const packageJson = JSON.parse(await fs_1.default.promises.readFile(path_1.default.join(maestroRunnerHome, 'drivers', 'ios', 'WebDriverAgent', 'package.json'), 'utf8'));
+        return typeof packageJson.version === 'string' ? packageJson.version : null;
+    }
+    catch {
+        return null;
     }
-    return xcodeVersion;
 }
 async function getMaestroVersion({ env, backend, }) {
     switch (backend) {

package/dist/steps/functions/launchApplication.d.ts

@@ -1,9 +1,11 @@
 import { bunyan } from '@expo/logger';
 import { BuildFunction, BuildRuntimePlatform, BuildStepEnv } from '@expo/steps';
 export declare function createLaunchApplicationFunction(): BuildFunction;
-export declare function launchApplicationAsync({ applicationIdentifier, activityName, runtimePlatform, env, logger, }: {
+export declare function launchApplicationAsync({ applicationIdentifier, activityName, launchArgs, openUrl, runtimePlatform, env, logger, }: {
     applicationIdentifier: string;
     activityName?: string;
+    launchArgs?: string[];
+    openUrl?: string;
     runtimePlatform: BuildRuntimePlatform;
     env: BuildStepEnv;
     logger: bunyan;

package/dist/steps/functions/launchApplication.js

@@ -8,6 +8,8 @@ exports.launchApplicationAsync = launchApplicationAsync;
 const eas_build_job_1 = require("@expo/eas-build-job");
 const steps_1 = require("@expo/steps");
 const turtle_spawn_1 = __importDefault(require("@expo/turtle-spawn"));
+const IOS_URL_SCHEME_APPROVAL_DOMAIN = 'com.apple.launchservices.schemeapproval';
+const IOS_URL_SCHEME_APPROVAL_KEY_PREFIX = 'com.apple.CoreSimulator.CoreSimulatorBridge-->';
 function createLaunchApplicationFunction() {
     return new steps_1.BuildFunction({
         namespace: 'eas',
@@ -25,15 +27,29 @@ function createLaunchApplicationFunction() {
                 required: false,
                 allowedValueTypeName: steps_1.BuildStepInputValueTypeName.STRING,
             }),
+            steps_1.BuildStepInput.createProvider({
+                id: 'launch_args',
+                required: false,
+                allowedValueTypeName: steps_1.BuildStepInputValueTypeName.JSON,
+            }),
+            steps_1.BuildStepInput.createProvider({
+                id: 'open_url',
+                required: false,
+                allowedValueTypeName: steps_1.BuildStepInputValueTypeName.STRING,
+            }),
         ],
         fn: async ({ global, logger }, { inputs, env }) => {
             const applicationIdentifier = parseNonEmptyStringInput(inputs.application_identifier.value, 'application_identifier');
             const activityName = inputs.activity_name.value === undefined
                 ? undefined
                 : parseNonEmptyStringInput(inputs.activity_name.value, 'activity_name');
+            const launchArgs = parseLaunchArgsInput(inputs.launch_args.value);
+            const openUrl = inputs.open_url.value === undefined ? undefined : parseOpenUrlInput(inputs.open_url.value);
             await launchApplicationAsync({
                 applicationIdentifier,
                 activityName,
+                launchArgs,
+                openUrl,
                 runtimePlatform: global.runtimePlatform,
                 env,
                 logger,
@@ -41,23 +57,70 @@ function createLaunchApplicationFunction() {
         },
     });
 }
-async function launchApplicationAsync({ applicationIdentifier, activityName, runtimePlatform, env, logger, }) {
+async function launchApplicationAsync({ applicationIdentifier, activityName, launchArgs = [], openUrl, runtimePlatform, env, logger, }) {
     if (runtimePlatform === steps_1.BuildRuntimePlatform.DARWIN) {
-        logger.info(`Launching ${applicationIdentifier}.`);
-        await (0, turtle_spawn_1.default)('xcrun', ['simctl', 'launch', 'booted', applicationIdentifier], {
+        logApplicationLaunch(logger, applicationIdentifier, launchArgs);
+        await (0, turtle_spawn_1.default)('xcrun', ['simctl', 'launch', 'booted', applicationIdentifier, ...launchArgs], {
             env,
             logger,
         });
+        if (openUrl) {
+            await preapproveIosUrlSchemeAsync({ applicationIdentifier, openUrl, env, logger });
+            logger.info(`Opening ${openUrl} in ${applicationIdentifier}.`);
+            await (0, turtle_spawn_1.default)('xcrun', ['simctl', 'openurl', 'booted', openUrl], { env, logger });
+        }
         return;
     }
     if (!activityName) {
         throw new eas_build_job_1.UserError('EAS_LAUNCH_APPLICATION_MISSING_ACTIVITY', 'Launching an Android application requires activity_name.');
     }
-    logger.info(`Launching ${applicationIdentifier}.`);
-    await (0, turtle_spawn_1.default)('adb', ['shell', 'am', 'start', '-n', `${applicationIdentifier}/${activityName}`], {
+    logApplicationLaunch(logger, applicationIdentifier, launchArgs);
+    // Android does not support process arguments like iOS. Pass raw `am start` Intent
+    // arguments instead, such as `--es key value` or `--ez key true`.
+    await (0, turtle_spawn_1.default)('adb', ['shell', 'am', 'start', ...launchArgs, '-n', `${applicationIdentifier}/${activityName}`], {
         env,
         logger,
     });
+    if (openUrl) {
+        logger.info(`Opening ${openUrl} in ${applicationIdentifier}.`);
+        await (0, turtle_spawn_1.default)('adb', [
+            'shell',
+            'am',
+            'start',
+            '-a',
+            'android.intent.action.VIEW',
+            '-d',
+            openUrl,
+            '-n',
+            `${applicationIdentifier}/${activityName}`,
+        ], { env, logger });
+    }
+}
+async function preapproveIosUrlSchemeAsync({ applicationIdentifier, openUrl, env, logger, }) {
+    const urlScheme = new URL(openUrl).protocol.slice(0, -1);
+    if (urlScheme === 'http' || urlScheme === 'https') {
+        return;
+    }
+    try {
+        await (0, turtle_spawn_1.default)('xcrun', [
+            'simctl',
+            'spawn',
+            'booted',
+            'defaults',
+            'write',
+            IOS_URL_SCHEME_APPROVAL_DOMAIN,
+            `${IOS_URL_SCHEME_APPROVAL_KEY_PREFIX}${urlScheme}`,
+            '-string',
+            applicationIdentifier,
+        ], { env, logger });
+    }
+    catch (error) {
+        logger.warn({ err: error }, `Could not preapprove the ${urlScheme} URL scheme for ${applicationIdentifier}. Opening the URL anyway; the Simulator might require manual confirmation.`);
+    }
+}
+function logApplicationLaunch(logger, applicationIdentifier, launchArgs) {
+    const argumentsDescription = launchArgs.length > 0 ? ` with arguments ${JSON.stringify(launchArgs)}` : '';
+    logger.info(`Launching ${applicationIdentifier}${argumentsDescription}.`);
 }
 function parseNonEmptyStringInput(value, inputName) {
     if (typeof value !== 'string' || value.length === 0) {
@@ -65,3 +128,19 @@ function parseNonEmptyStringInput(value, inputName) {
     }
     return value;
 }
+function parseLaunchArgsInput(value) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value) || !value.every(argument => typeof argument === 'string')) {
+        throw new eas_build_job_1.UserError('EAS_LAUNCH_APPLICATION_INVALID_INPUT', 'Input "launch_args" must be an array of strings.');
+    }
+    return value;
+}
+function parseOpenUrlInput(value) {
+    const openUrl = parseNonEmptyStringInput(value, 'open_url');
+    if (!URL.canParse(openUrl)) {
+        throw new eas_build_job_1.UserError('EAS_LAUNCH_APPLICATION_INVALID_INPUT', 'Input "open_url" must be a valid URL.');
+    }
+    return openUrl;
+}

package/dist/steps/utils/appiumCommandSummary.d.ts

@@ -0,0 +1,9 @@
+import { type AppiumCommand } from './appiumCommands.generated';
+export declare const APPIUM_COMMAND_SUMMARIES: Record<AppiumCommand, string>;
+/**
+ * Translate a raw Appium command name into a short, human-readable summary.
+ *
+ * If a command has no curated summary, the raw command name is returned
+ * unchanged — we intentionally do not guess a phrasing.
+ */
+export declare function humanizeAppiumCommand(command: string): string;

package/dist/steps/utils/appiumCommandSummary.js

@@ -0,0 +1,397 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APPIUM_COMMAND_SUMMARIES = void 0;
+exports.humanizeAppiumCommand = humanizeAppiumCommand;
+exports.APPIUM_COMMAND_SUMMARIES = {
+    // Session lifecycle
+    createSession: 'Started the session',
+    deleteSession: 'Ended the session',
+    getSession: 'Read the session details',
+    getStatus: 'Checked the server status',
+    getAppiumSessions: 'Listed Appium sessions',
+    getAppiumSessionCapabilities: 'Read the session capabilities',
+    getTimeouts: 'Read timeouts',
+    timeouts: 'Set timeouts',
+    getSettings: 'Read Appium settings',
+    updateSettings: 'Updated Appium settings',
+    listCommands: 'Listed available commands',
+    listExtensions: 'Listed available extensions',
+    receiveAsyncResponse: 'Received an async response',
+    // Screen and media
+    getScreenshot: 'Took a screenshot',
+    getElementScreenshot: 'Took a screenshot of an element',
+    getPageSource: 'Read the screen contents',
+    printPage: 'Printed the page',
+    // Window and orientation
+    getWindowRect: 'Read the screen size',
+    setWindowRect: 'Resized the window',
+    maximizeWindow: 'Maximized the window',
+    minimizeWindow: 'Minimized the window',
+    fullScreenWindow: 'Made the window full screen',
+    getWindowHandle: 'Read the current window',
+    getWindowHandles: 'Listed open windows',
+    setWindow: 'Switched window',
+    closeWindow: 'Closed the window',
+    createNewWindow: 'Opened a new window',
+    setFrame: 'Switched to a frame',
+    switchToParentFrame: 'Switched to the parent frame',
+    getOrientation: 'Read the screen orientation',
+    setOrientation: 'Changed the screen orientation',
+    getRotation: 'Read the device rotation',
+    setRotation: 'Rotated the device',
+    // Device
+    getDeviceTime: 'Read the device time',
+    getGeoLocation: 'Read the device location',
+    setGeoLocation: 'Set the device location',
+    getNetworkConnection: 'Read the network connection',
+    setNetworkConnection: 'Changed the network connection',
+    setDevicePosture: 'Set the device posture',
+    clearDevicePosture: 'Cleared the device posture',
+    setPermissions: 'Set app permissions',
+    // Element discovery
+    findElement: 'Found an element',
+    findElements: 'Found elements',
+    findElementFromElement: 'Found a nested element',
+    findElementsFromElement: 'Found nested elements',
+    findElementFromShadowRoot: 'Found an element in a shadow root',
+    findElementsFromShadowRoot: 'Found elements in a shadow root',
+    elementShadowRoot: 'Read an element shadow root',
+    active: 'Read the focused element',
+    // Element interaction
+    click: 'Tapped an element',
+    clear: 'Cleared an element',
+    setValue: 'Typed into an element',
+    getText: 'Read element text',
+    getName: 'Read an element tag',
+    getAttribute: 'Read an element attribute',
+    getProperty: 'Read an element property',
+    getCssProperty: 'Read an element style',
+    getComputedLabel: 'Read an element label',
+    getComputedRole: 'Read an element role',
+    getElementRect: 'Read an element position and size',
+    elementDisplayed: 'Checked if an element was visible',
+    elementEnabled: 'Checked if an element was enabled',
+    elementSelected: 'Checked if an element was selected',
+    // Gestures
+    performActions: 'Performed a gesture',
+    releaseActions: 'Finished a gesture',
+    // App management
+    installApp: 'Installed an app',
+    removeApp: 'Removed an app',
+    isAppInstalled: 'Checked if an app was installed',
+    activateApp: 'Activated an app',
+    terminateApp: 'Terminated an app',
+    queryAppState: 'Read the app state',
+    background: 'Sent the app to the background',
+    // Contexts
+    getContexts: 'Listed available contexts',
+    getCurrentContext: 'Read the current context',
+    setContext: 'Switched context',
+    // Web navigation
+    setUrl: 'Opened a URL',
+    getUrl: 'Read the current URL',
+    back: 'Navigated back',
+    forward: 'Navigated forward',
+    refresh: 'Refreshed the page',
+    title: 'Read the page title',
+    // Cookies
+    getCookie: 'Read a cookie',
+    getCookies: 'Read all cookies',
+    setCookie: 'Set a cookie',
+    deleteCookie: 'Deleted a cookie',
+    deleteCookies: 'Deleted all cookies',
+    // Alerts
+    getAlertText: 'Read an alert',
+    setAlertText: 'Typed into an alert',
+    postAcceptAlert: 'Accepted an alert',
+    postDismissAlert: 'Dismissed an alert',
+    // Keyboard and input methods
+    hideKeyboard: 'Hid the keyboard',
+    isKeyboardShown: 'Checked if the keyboard was shown',
+    activateIMEEngine: 'Activated an input method',
+    deactivateIMEEngine: 'Deactivated the input method',
+    getActiveIMEEngine: 'Read the active input method',
+    availableIMEEngines: 'Listed input methods',
+    isIMEActivated: 'Checked if an input method was active',
+    // Clipboard (driver-level, not declared by base-driver)
+    getClipboard: 'Read the clipboard',
+    setClipboard: 'Wrote to the clipboard',
+    // Files
+    pushFile: 'Pushed a file to the device',
+    pullFile: 'Pulled a file from the device',
+    pullFolder: 'Pulled a folder from the device',
+    // Logs
+    getLog: 'Read device logs',
+    getLogTypes: 'Listed log types',
+    getLogEvents: 'Read logged events',
+    logCustomEvent: 'Logged a custom event',
+    generateTestReport: 'Generated a test report',
+    // Scripts
+    execute: 'Ran a script command',
+    executeAsync: 'Ran an async script command',
+    executeCdp: 'Ran a Chrome DevTools command',
+    // Web authentication (virtual authenticators)
+    addVirtualAuthenticator: 'Added a virtual authenticator',
+    removeVirtualAuthenticator: 'Removed a virtual authenticator',
+    addAuthCredential: 'Added an auth credential',
+    getAuthCredential: 'Read auth credentials',
+    removeAuthCredential: 'Removed an auth credential',
+    removeAllAuthCredentials: 'Removed all auth credentials',
+    setUserAuthVerified: 'Set the user verification state',
+    // Federated sign-in (FedCM)
+    fedCMGetAccounts: 'Listed federated sign-in accounts',
+    fedCMSelectAccount: 'Selected a federated sign-in account',
+    fedCMGetDialogType: 'Read the federated sign-in dialog type',
+    fedCMGetTitle: 'Read the federated sign-in dialog title',
+    fedCMClickDialogButton: 'Clicked a federated sign-in dialog button',
+    fedCMCancelDialog: 'Canceled the federated sign-in dialog',
+    fedCMResetCooldown: 'Reset the federated sign-in cooldown',
+    fedCMSetDelayEnabled: 'Toggled the federated sign-in delay',
+    // Virtual sensors and pressure sources
+    createVirtualSensor: 'Created a virtual sensor',
+    updateVirtualSensorReading: 'Updated a virtual sensor reading',
+    getVirtualSensorInfo: 'Read virtual sensor info',
+    deleteVirtualSensor: 'Removed a virtual sensor',
+    createVirtualPressureSource: 'Created a virtual pressure source',
+    updateVirtualPressureSource: 'Updated a virtual pressure source',
+    deleteVirtualPressureSource: 'Removed a virtual pressure source',
+    // Privacy / experimental web platform
+    getGlobalPrivacyControl: 'Read the Global Privacy Control setting',
+    setGlobalPrivacyControl: 'Set the Global Privacy Control setting',
+    setStorageAccess: 'Set storage access',
+    setRPHRegistrationMode: 'Set the protocol handler registration mode',
+    setSPCTransactionMode: 'Set the payment transaction mode',
+    // Driver routes and compatibility commands
+    asyncScriptTimeout: 'Set the async script timeout',
+    closeApp: 'Closed the app',
+    disableConditionInducer: 'Disabled the condition inducer',
+    enableConditionInducer: 'Enabled the condition inducer',
+    fingerprint: 'Simulated a fingerprint',
+    getCurrentActivity: 'Read the current activity',
+    getCurrentPackage: 'Read the current package',
+    getDisplayDensity: 'Read the display density',
+    getLocation: 'Read an element location',
+    getLocationInView: 'Read an element location in view',
+    getPerformanceData: 'Read performance data',
+    getPerformanceDataTypes: 'Listed performance data types',
+    getScreenInfo: 'Read screen information',
+    getSize: 'Read an element size',
+    getStrings: 'Read app strings',
+    getSystemBars: 'Read system bar information',
+    getViewportRect: 'Read the viewport size',
+    getViewportScreenshot: 'Took a viewport screenshot',
+    getWindowSize: 'Read the window size',
+    gsmCall: 'Simulated a phone call',
+    gsmSignal: 'Changed the cellular signal',
+    gsmVoice: 'Changed the cellular voice state',
+    implicitWait: 'Set the element lookup timeout',
+    isLocationServicesEnabled: 'Checked if location services were enabled',
+    isLocked: 'Checked if the device was locked',
+    keyevent: 'Sent a key event',
+    keys: 'Sent keyboard input',
+    launchApp: 'Launched the app',
+    listConditionInducers: 'Listed condition inducers',
+    lock: 'Locked the device',
+    longPressKeyCode: 'Long-pressed a key',
+    networkSpeed: 'Changed the network speed',
+    openNotifications: 'Opened notifications',
+    powerAC: 'Changed the charging state',
+    powerCapacity: 'Changed the battery level',
+    pressKeyCode: 'Pressed a key',
+    replaceValue: 'Replaced an element value',
+    reset: 'Reset the app',
+    sendSMS: 'Simulated a text message',
+    sensorSet: 'Changed a sensor value',
+    setStylusHandwriting: 'Changed stylus handwriting mode',
+    setValueImmediate: 'Typed into an element immediately',
+    startActivity: 'Started an activity',
+    startAudioRecording: 'Started audio recording',
+    startRecordingScreen: 'Started screen recording',
+    stopAudioRecording: 'Stopped audio recording',
+    stopRecordingScreen: 'Stopped screen recording',
+    submit: 'Submitted an element',
+    toggleData: 'Toggled mobile data',
+    toggleEnrollTouchId: 'Changed Touch ID enrollment',
+    toggleFlightMode: 'Toggled airplane mode',
+    toggleLocationServices: 'Toggled location services',
+    toggleWiFi: 'Toggled Wi-Fi',
+    touchId: 'Simulated Touch ID',
+    unlock: 'Unlocked the device',
+    // Driver mobile commands
+    mobileAcceptAlert: 'Accepted an alert',
+    mobileActivateApp: 'Activated an app',
+    mobileBackgroundApp: 'Sent the app to the background',
+    mobileBluetooth: 'Changed Bluetooth state',
+    mobileBroadcast: 'Sent an Android broadcast',
+    mobileCalibrateWebToRealCoordinatesTranslation: 'Calibrated web coordinates',
+    mobileChangePermissions: 'Changed app permissions',
+    mobileClearApp: 'Cleared app data',
+    mobileClearKeychains: 'Cleared keychains',
+    mobileClickGesture: 'Performed a click gesture',
+    mobileConfigureLocalization: 'Changed device localization',
+    mobileDeepLink: 'Opened a deep link',
+    mobileDeleteFile: 'Deleted a device file',
+    mobileDeleteFolder: 'Deleted a device folder',
+    mobileDeviceidle: 'Changed device idle state',
+    mobileDisableVoiceOver: 'Disabled VoiceOver',
+    mobileDismissAlert: 'Dismissed an alert',
+    mobileDoubleClickGesture: 'Performed a double-click gesture',
+    mobileDoubleTap: 'Double-tapped the screen',
+    mobileDragFromToForDuration: 'Dragged between screen points',
+    mobileDragFromToWithVelocity: 'Dragged with a set velocity',
+    mobileDragGesture: 'Performed a drag gesture',
+    mobileEnableVoiceOver: 'Enabled VoiceOver',
+    mobileEnrollBiometric: 'Changed biometric enrollment',
+    mobileExecEmuConsoleCommand: 'Ran an emulator console command',
+    mobileExpectNotification: 'Waited for a notification',
+    mobileFingerprint: 'Simulated a fingerprint',
+    mobileFlingGesture: 'Performed a fling gesture',
+    mobileForcePress: 'Force-pressed the screen',
+    mobileGetActionHistory: 'Read scheduled action history',
+    mobileGetActiveAppInfo: 'Read active app information',
+    mobileGetAppearance: 'Read the device appearance',
+    mobileGetBatteryInfo: 'Read battery information',
+    mobileGetChromeCapabilities: 'Read Chrome capabilities',
+    mobileGetConnectivity: 'Read device connectivity',
+    mobileGetContentSize: 'Read scrollable content size',
+    mobileGetContexts: 'Listed available contexts',
+    mobileGetDeviceInfo: 'Read device information',
+    mobileGetDeviceTime: 'Read the device time',
+    mobileGetDeclaredOrientation: 'Read the declared device orientation',
+    mobileGetGeolocation: 'Read the device location',
+    mobileGetIncreaseContrast: 'Read the Increase Contrast setting',
+    mobileGetNotifications: 'Read notifications',
+    mobileGetPasteboard: 'Read the pasteboard',
+    mobileGetPerformanceData: 'Read app performance data',
+    mobileGetPermission: 'Read an app permission',
+    mobileGetPermissions: 'Read app permissions',
+    mobileGetSimulatedLocation: 'Read the simulated location',
+    mobileGetSource: 'Read the screen contents',
+    mobileGetUiMode: 'Read the Android UI mode',
+    mobileGetXctestScreenRecordingInfo: 'Read XCTest screen recording information',
+    mobileGsmCall: 'Simulated a phone call',
+    mobileGsmSignal: 'Changed the cellular signal',
+    mobileGsmVoice: 'Changed the cellular voice state',
+    mobileHandleAlert: 'Handled an alert',
+    mobileHideKeyboard: 'Hid the keyboard',
+    mobileInjectEmulatorCameraImage: 'Injected an emulator camera image',
+    mobileInstallApp: 'Installed an app',
+    mobileInstallCertificate: 'Installed a certificate',
+    mobileInstallMultipleApks: 'Installed multiple APKs',
+    mobileInstallXCTestBundle: 'Installed an XCTest bundle',
+    mobileIsAppInstalled: 'Checked if an app was installed',
+    mobileIsBiometricEnrolled: 'Checked biometric enrollment',
+    mobileIsMediaProjectionRecordingRunning: 'Checked media projection recording',
+    mobileIsVoiceOverEnabled: 'Checked if VoiceOver was enabled',
+    mobileKeys: 'Sent keyboard input',
+    mobileKillApp: 'Stopped an app',
+    mobileLaunchApp: 'Launched an app',
+    mobileListApps: 'Listed installed apps',
+    mobileListCertificates: 'Listed certificates',
+    mobileListDisplays: 'Listed displays',
+    mobileListSms: 'Listed text messages',
+    mobileListWindows: 'Listed app windows',
+    mobileListXCTestBundles: 'Listed XCTest bundles',
+    mobileLongClickGesture: 'Performed a long-click gesture',
+    mobileNetworkSpeed: 'Changed the network speed',
+    mobileNfc: 'Changed NFC state',
+    mobilePerformAccessibilityAudit: 'Ran an accessibility audit',
+    mobilePerformEditorAction: 'Performed a keyboard editor action',
+    mobilePerformHandGesture: 'Performed a hand gesture',
+    mobilePerformIndigoHidEvent: 'Performed an Indigo HID event',
+    mobilePerformIoHidEvent: 'Performed an IOHID event',
+    mobilePerformStatusBarCommand: 'Performed a status bar command',
+    mobilePinch: 'Pinched the screen',
+    mobilePinchCloseGesture: 'Performed a pinch-close gesture',
+    mobilePinchOpenGesture: 'Performed a pinch-open gesture',
+    mobilePowerAc: 'Changed the charging state',
+    mobilePowerCapacity: 'Changed the battery level',
+    mobilePressButton: 'Pressed a device button',
+    mobilePressKey: 'Pressed a key',
+    mobilePullFile: 'Pulled a file from the device',
+    mobilePullFolder: 'Pulled a folder from the device',
+    mobilePushFile: 'Pushed a file to the device',
+    mobilePushNotification: 'Sent a push notification',
+    mobileQueryAppState: 'Read the app state',
+    mobileRefreshGpsCache: 'Refreshed the GPS cache',
+    mobileRemoveApp: 'Removed an app',
+    mobileRemoveCertificate: 'Removed a certificate',
+    mobileReplaceElementValue: 'Replaced an element value',
+    mobileResetAccessibilityCache: 'Reset the accessibility cache',
+    mobileResetGeolocation: 'Reset the device location',
+    mobileResetLocationService: 'Reset location services',
+    mobileResetPermission: 'Reset an app permission',
+    mobileResetSimulatedLocation: 'Reset the simulated location',
+    mobileRotateDigitalCrown: 'Rotated the Digital Crown',
+    mobileRotateElement: 'Rotated an element',
+    mobileRunXCTest: 'Ran an XCTest bundle',
+    mobileScheduleAction: 'Scheduled a device action',
+    mobileScreenshots: 'Took display screenshots',
+    mobileScroll: 'Scrolled the screen',
+    mobileScrollBackTo: 'Scrolled back to an element',
+    mobileScrollGesture: 'Performed a scroll gesture',
+    mobileScrollToElement: 'Scrolled to an element',
+    mobileSelectPickerWheelValue: 'Changed a picker wheel value',
+    mobileSendBiometricMatch: 'Simulated biometric authentication',
+    mobileSendMemoryWarning: 'Sent a memory warning',
+    mobileSendSms: 'Simulated a text message',
+    mobileSendTrimMemory: 'Sent an Android memory trim event',
+    mobileSetAppearance: 'Changed the device appearance',
+    mobileSetConnectivity: 'Changed device connectivity',
+    mobileSetContentSize: 'Changed the content size',
+    mobileSetGeolocation: 'Set the device location',
+    mobileSetIncreaseContrast: 'Changed the Increase Contrast setting',
+    mobileSetPasteboard: 'Wrote to the pasteboard',
+    mobileSetPermissions: 'Set app permissions',
+    mobileSetSimulatedLocation: 'Set a simulated location',
+    mobileSetUiMode: 'Changed the Android UI mode',
+    mobileShake: 'Shook the device',
+    mobileShell: 'Ran an Android shell command',
+    mobileSimctl: 'Ran a simctl command',
+    mobileSiriCommand: 'Sent a Siri command',
+    mobileStartActivity: 'Started an activity',
+    mobileStartLogsBroadcast: 'Started log streaming',
+    mobileStartMediaProjectionRecording: 'Started media projection recording',
+    mobileStartNetworkMonitor: 'Started network monitoring',
+    mobileStartPerfRecord: 'Started performance recording',
+    mobileStartScreenRecording: 'Started screen recording',
+    mobileStartScreenStreaming: 'Started screen streaming',
+    mobileStartService: 'Started a service',
+    mobileStartSystemMonitor: 'Started system monitoring',
+    mobileStartXctestScreenRecording: 'Started XCTest screen recording',
+    mobileStopLogsBroadcast: 'Stopped log streaming',
+    mobileStopMediaProjectionRecording: 'Stopped media projection recording',
+    mobileStopNetworkMonitor: 'Stopped network monitoring',
+    mobileStopPerfRecord: 'Stopped performance recording',
+    mobileStopScreenRecording: 'Stopped screen recording',
+    mobileStopScreenStreaming: 'Stopped screen streaming',
+    mobileStopService: 'Stopped a service',
+    mobileStopSystemMonitor: 'Stopped system monitoring',
+    mobileStopXctestScreenRecording: 'Stopped XCTest screen recording',
+    mobileSwipe: 'Swiped the screen',
+    mobileSwipeGesture: 'Performed a swipe gesture',
+    mobileTap: 'Tapped the screen',
+    mobileTapWithNumberOfTaps: 'Tapped the screen multiple times',
+    mobileTerminateApp: 'Terminated an app',
+    mobileTouchAndHold: 'Touched and held the screen',
+    mobileTwoFingerTap: 'Tapped with two fingers',
+    mobileType: 'Typed text',
+    mobileUnlock: 'Unlocked the device',
+    mobileUnscheduleAction: 'Canceled a scheduled action',
+    mobileUpdateSafariPreferences: 'Updated Safari preferences',
+    mobileViewPortRect: 'Read the viewport size',
+    mobileViewportScreenshot: 'Took a viewport screenshot',
+    mobileVoiceOverCurrentSpeech: 'Read current VoiceOver speech',
+    mobileVoiceOverMove: 'Moved the VoiceOver cursor',
+};
+/**
+ * Translate a raw Appium command name into a short, human-readable summary.
+ *
+ * If a command has no curated summary, the raw command name is returned
+ * unchanged — we intentionally do not guess a phrasing.
+ */
+function humanizeAppiumCommand(command) {
+    return Object.hasOwn(exports.APPIUM_COMMAND_SUMMARIES, command)
+        ? exports.APPIUM_COMMAND_SUMMARIES[command]
+        : command;
+}

package/dist/steps/utils/appiumCommands.generated.d.ts

@@ -0,0 +1,4 @@
+export type BaseDriverAppiumCommand = 'activateApp' | 'activateIMEEngine' | 'active' | 'addAuthCredential' | 'addVirtualAuthenticator' | 'availableIMEEngines' | 'back' | 'clear' | 'clearDevicePosture' | 'click' | 'closeWindow' | 'createNewWindow' | 'createSession' | 'createVirtualPressureSource' | 'createVirtualSensor' | 'deactivateIMEEngine' | 'deleteCookie' | 'deleteCookies' | 'deleteSession' | 'deleteVirtualPressureSource' | 'deleteVirtualSensor' | 'elementDisplayed' | 'elementEnabled' | 'elementSelected' | 'elementShadowRoot' | 'execute' | 'executeAsync' | 'executeCdp' | 'fedCMCancelDialog' | 'fedCMClickDialogButton' | 'fedCMGetAccounts' | 'fedCMGetDialogType' | 'fedCMGetTitle' | 'fedCMResetCooldown' | 'fedCMSelectAccount' | 'fedCMSetDelayEnabled' | 'findElement' | 'findElementFromElement' | 'findElementFromShadowRoot' | 'findElements' | 'findElementsFromElement' | 'findElementsFromShadowRoot' | 'forward' | 'fullScreenWindow' | 'generateTestReport' | 'getActiveIMEEngine' | 'getAlertText' | 'getAppiumSessionCapabilities' | 'getAppiumSessions' | 'getAttribute' | 'getAuthCredential' | 'getComputedLabel' | 'getComputedRole' | 'getContexts' | 'getCookie' | 'getCookies' | 'getCssProperty' | 'getCurrentContext' | 'getDeviceTime' | 'getElementRect' | 'getElementScreenshot' | 'getGeoLocation' | 'getGlobalPrivacyControl' | 'getLog' | 'getLogEvents' | 'getLogTypes' | 'getName' | 'getNetworkConnection' | 'getOrientation' | 'getPageSource' | 'getProperty' | 'getRotation' | 'getScreenshot' | 'getSession' | 'getSettings' | 'getStatus' | 'getText' | 'getTimeouts' | 'getUrl' | 'getVirtualSensorInfo' | 'getWindowHandle' | 'getWindowHandles' | 'getWindowRect' | 'hideKeyboard' | 'installApp' | 'isAppInstalled' | 'isIMEActivated' | 'isKeyboardShown' | 'listCommands' | 'listExtensions' | 'logCustomEvent' | 'maximizeWindow' | 'minimizeWindow' | 'performActions' | 'postAcceptAlert' | 'postDismissAlert' | 'printPage' | 'pullFile' | 'pullFolder' | 'pushFile' | 'queryAppState' | 'receiveAsyncResponse' | 'refresh' | 'releaseActions' | 'removeAllAuthCredentials' | 'removeApp' | 'removeAuthCredential' | 'removeVirtualAuthenticator' | 'setAlertText' | 'setContext' | 'setCookie' | 'setDevicePosture' | 'setFrame' | 'setGeoLocation' | 'setGlobalPrivacyControl' | 'setNetworkConnection' | 'setOrientation' | 'setPermissions' | 'setRPHRegistrationMode' | 'setRotation' | 'setSPCTransactionMode' | 'setStorageAccess' | 'setUrl' | 'setUserAuthVerified' | 'setValue' | 'setWindow' | 'setWindowRect' | 'switchToParentFrame' | 'terminateApp' | 'timeouts' | 'title' | 'updateSettings' | 'updateVirtualPressureSource' | 'updateVirtualSensorReading';
+export type XCUITestAppiumCommand = 'asyncScriptTimeout' | 'background' | 'closeApp' | 'disableConditionInducer' | 'enableConditionInducer' | 'getClipboard' | 'getLocation' | 'getLocationInView' | 'getScreenInfo' | 'getSize' | 'getStrings' | 'getViewportRect' | 'getViewportScreenshot' | 'getWindowSize' | 'implicitWait' | 'isLocked' | 'keys' | 'launchApp' | 'listConditionInducers' | 'lock' | 'mobileActivateApp' | 'mobileCalibrateWebToRealCoordinatesTranslation' | 'mobileClearApp' | 'mobileClearKeychains' | 'mobileConfigureLocalization' | 'mobileDeepLink' | 'mobileDeleteFile' | 'mobileDeleteFolder' | 'mobileDisableVoiceOver' | 'mobileDoubleTap' | 'mobileDragFromToForDuration' | 'mobileDragFromToWithVelocity' | 'mobileEnableVoiceOver' | 'mobileEnrollBiometric' | 'mobileExpectNotification' | 'mobileForcePress' | 'mobileGetActiveAppInfo' | 'mobileGetAppearance' | 'mobileGetBatteryInfo' | 'mobileGetContentSize' | 'mobileGetContexts' | 'mobileGetDeviceInfo' | 'mobileGetDeviceTime' | 'mobileGetIncreaseContrast' | 'mobileGetPasteboard' | 'mobileGetPermission' | 'mobileGetSimulatedLocation' | 'mobileGetSource' | 'mobileGetXctestScreenRecordingInfo' | 'mobileHandleAlert' | 'mobileHideKeyboard' | 'mobileInstallApp' | 'mobileInstallCertificate' | 'mobileInstallXCTestBundle' | 'mobileIsAppInstalled' | 'mobileIsBiometricEnrolled' | 'mobileIsVoiceOverEnabled' | 'mobileKeys' | 'mobileKillApp' | 'mobileLaunchApp' | 'mobileListApps' | 'mobileListCertificates' | 'mobileListXCTestBundles' | 'mobilePerformAccessibilityAudit' | 'mobilePerformHandGesture' | 'mobilePerformIndigoHidEvent' | 'mobilePerformIoHidEvent' | 'mobilePinch' | 'mobilePressButton' | 'mobilePullFile' | 'mobilePullFolder' | 'mobilePushFile' | 'mobilePushNotification' | 'mobileQueryAppState' | 'mobileRemoveApp' | 'mobileRemoveCertificate' | 'mobileResetLocationService' | 'mobileResetPermission' | 'mobileResetSimulatedLocation' | 'mobileRotateDigitalCrown' | 'mobileRotateElement' | 'mobileRunXCTest' | 'mobileScroll' | 'mobileScrollToElement' | 'mobileSelectPickerWheelValue' | 'mobileSendBiometricMatch' | 'mobileSendMemoryWarning' | 'mobileSetAppearance' | 'mobileSetContentSize' | 'mobileSetIncreaseContrast' | 'mobileSetPasteboard' | 'mobileSetPermissions' | 'mobileSetSimulatedLocation' | 'mobileShake' | 'mobileSimctl' | 'mobileSiriCommand' | 'mobileStartLogsBroadcast' | 'mobileStartNetworkMonitor' | 'mobileStartPerfRecord' | 'mobileStartScreenRecording' | 'mobileStartSystemMonitor' | 'mobileStartXctestScreenRecording' | 'mobileStopLogsBroadcast' | 'mobileStopNetworkMonitor' | 'mobileStopPerfRecord' | 'mobileStopScreenRecording' | 'mobileStopSystemMonitor' | 'mobileStopXctestScreenRecording' | 'mobileSwipe' | 'mobileTap' | 'mobileTapWithNumberOfTaps' | 'mobileTerminateApp' | 'mobileTouchAndHold' | 'mobileTwoFingerTap' | 'mobileUpdateSafariPreferences' | 'mobileVoiceOverCurrentSpeech' | 'mobileVoiceOverMove' | 'reset' | 'setClipboard' | 'setValueImmediate' | 'startAudioRecording' | 'startRecordingScreen' | 'stopAudioRecording' | 'stopRecordingScreen' | 'submit' | 'toggleEnrollTouchId' | 'touchId' | 'unlock';
+export type UiAutomator2AppiumCommand = 'background' | 'fingerprint' | 'getClipboard' | 'getCurrentActivity' | 'getCurrentPackage' | 'getDisplayDensity' | 'getLocation' | 'getLocationInView' | 'getPerformanceData' | 'getPerformanceDataTypes' | 'getSize' | 'getStrings' | 'getSystemBars' | 'getWindowSize' | 'gsmCall' | 'gsmSignal' | 'gsmVoice' | 'implicitWait' | 'isLocationServicesEnabled' | 'isLocked' | 'keyevent' | 'keys' | 'lock' | 'longPressKeyCode' | 'mobileAcceptAlert' | 'mobileBackgroundApp' | 'mobileBluetooth' | 'mobileBroadcast' | 'mobileChangePermissions' | 'mobileClearApp' | 'mobileClickGesture' | 'mobileDeepLink' | 'mobileDeleteFile' | 'mobileDeviceidle' | 'mobileDismissAlert' | 'mobileDoubleClickGesture' | 'mobileDragGesture' | 'mobileExecEmuConsoleCommand' | 'mobileFingerprint' | 'mobileFlingGesture' | 'mobileGetActionHistory' | 'mobileGetBatteryInfo' | 'mobileGetChromeCapabilities' | 'mobileGetConnectivity' | 'mobileGetContexts' | 'mobileGetDeclaredOrientation' | 'mobileGetDeviceInfo' | 'mobileGetDeviceTime' | 'mobileGetGeolocation' | 'mobileGetNotifications' | 'mobileGetPerformanceData' | 'mobileGetPermissions' | 'mobileGetUiMode' | 'mobileGsmCall' | 'mobileGsmSignal' | 'mobileGsmVoice' | 'mobileInjectEmulatorCameraImage' | 'mobileInstallApp' | 'mobileInstallMultipleApks' | 'mobileIsAppInstalled' | 'mobileIsMediaProjectionRecordingRunning' | 'mobileListApps' | 'mobileListDisplays' | 'mobileListSms' | 'mobileListWindows' | 'mobileLongClickGesture' | 'mobileNetworkSpeed' | 'mobileNfc' | 'mobilePerformEditorAction' | 'mobilePerformStatusBarCommand' | 'mobilePinchCloseGesture' | 'mobilePinchOpenGesture' | 'mobilePowerAc' | 'mobilePowerCapacity' | 'mobilePressKey' | 'mobileRefreshGpsCache' | 'mobileRemoveApp' | 'mobileReplaceElementValue' | 'mobileResetAccessibilityCache' | 'mobileResetGeolocation' | 'mobileScheduleAction' | 'mobileScreenshots' | 'mobileScroll' | 'mobileScrollBackTo' | 'mobileScrollGesture' | 'mobileSendSms' | 'mobileSendTrimMemory' | 'mobileSetConnectivity' | 'mobileSetGeolocation' | 'mobileSetUiMode' | 'mobileShell' | 'mobileStartActivity' | 'mobileStartLogsBroadcast' | 'mobileStartMediaProjectionRecording' | 'mobileStartScreenStreaming' | 'mobileStartService' | 'mobileStopLogsBroadcast' | 'mobileStopMediaProjectionRecording' | 'mobileStopScreenStreaming' | 'mobileStopService' | 'mobileSwipeGesture' | 'mobileTerminateApp' | 'mobileType' | 'mobileUnlock' | 'mobileUnscheduleAction' | 'mobileViewPortRect' | 'mobileViewportScreenshot' | 'networkSpeed' | 'openNotifications' | 'powerAC' | 'powerCapacity' | 'pressKeyCode' | 'replaceValue' | 'sendSMS' | 'sensorSet' | 'setClipboard' | 'setStylusHandwriting' | 'setValueImmediate' | 'startActivity' | 'startRecordingScreen' | 'stopRecordingScreen' | 'toggleData' | 'toggleFlightMode' | 'toggleLocationServices' | 'toggleWiFi' | 'unlock';
+export type AppiumCommand = BaseDriverAppiumCommand | XCUITestAppiumCommand | UiAutomator2AppiumCommand;

package/dist/steps/utils/appiumCommands.generated.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/steps/utils/appiumEvents.js

@@ -10,6 +10,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const promises_1 = require("node:timers/promises");
 const zod_1 = require("zod");
 const turtleFetch_1 = require("../../utils/turtleFetch");
+const appiumCommandSummary_1 = require("./appiumCommandSummary");
 const deviceRunSessionEvents_1 = require("./deviceRunSessionEvents");
 const APPIUM_REQUEST_TIMEOUT_MS = 10_000;
 const POLL_INTERVAL_MS = 1_000;
@@ -127,7 +128,7 @@ function createAppiumEventSource(eventFile) {
                     type: 'operation.completed',
                     operationId,
                     durationMs: Math.max(0, command.endTime - command.startTime),
-                    summary: command.cmd,
+                    summary: (0, appiumCommandSummary_1.humanizeAppiumCommand)(command.cmd),
                     data: {
                         command: command.cmd,
                         appiumSessionId: command.appiumSessionId,

package/dist/steps/utils/argentArtifacts.d.ts

@@ -3,6 +3,7 @@ import { z } from 'zod';
 import { CustomBuildContext } from '../../customBuildContext';
 declare const ArgentArtifactSchema: z.ZodObject<{
     id: z.ZodString;
+    kind: z.ZodOptional<z.ZodString>;
     filename: z.ZodString;
     mimeType: z.ZodString;
     isDirectory: z.ZodOptional<z.ZodBoolean>;

package/dist/steps/utils/argentArtifacts.js

@@ -21,11 +21,11 @@ const deviceRunSessionArtifacts_1 = require("./deviceRunSessionArtifacts");
 const ARGENT_ARTIFACT_UPLOAD_POLL_INTERVAL_MS = 5_000;
 const ARGENT_ARTIFACT_UPLOAD_CLEANUP_TIMEOUT_MS = 30_000;
 const ARGENT_ARTIFACT_FETCH_TIMEOUT_MS = 10_000;
-// Kinds the EAS dashboard groups device run session artifacts by. Only media types the dashboard
-// renders specially are mapped; anything else stays unclassified and lands in its "Other" group.
-// Note that these kinds only affect grouping and labelling. The dashboard gates its inline video
-// player on the `__eas_screen_recording` metadata flag, which Argent artifacts deliberately do not
-// set, so a `screen-recording` kind here does not add a player to the session page.
+// Fallback kinds for Argent versions that do not include a semantic artifact kind. Only media types
+// the EAS dashboard renders specially can be inferred safely. Note that these kinds only affect
+// grouping and labelling. The dashboard gates its inline video player on the
+// `__eas_screen_recording` metadata flag, which Argent artifacts deliberately do not set, so a
+// `screen-recording` kind here does not add a player to the session page.
 const ARGENT_ARTIFACT_KIND_BY_MIME_TYPE = new Map([
     ['image/png', 'screenshot'],
     ['image/jpeg', 'screenshot'],
@@ -34,6 +34,9 @@ const ARGENT_ARTIFACT_KIND_BY_MIME_TYPE = new Map([
 ]);
 const ArgentArtifactSchema = zod_1.z.object({
     id: zod_1.z.string(),
+    // Optional for compatibility with older Argent tool servers. Keep this open to new kinds so a
+    // newer Argent version can add a category without requiring an EAS worker release first.
+    kind: zod_1.z.string().optional(),
     filename: zod_1.z.string(),
     mimeType: zod_1.z.string(),
     isDirectory: zod_1.z.boolean().optional(),
@@ -42,8 +45,12 @@ const ArgentArtifactsListResponseSchema = zod_1.z.object({
     artifacts: zod_1.z.array(ArgentArtifactSchema),
 });
 function getArgentArtifactKind(artifact) {
+    if (artifact.kind) {
+        return artifact.kind;
+    }
     // Directories are repackaged as a tarball before upload, so the reported media type describes the
-    // contents rather than the file we actually store.
+    // contents rather than the file we actually store. A semantic kind above remains valid because it
+    // describes what the artifact represents, not its transport format.
     if (artifact.isDirectory) {
         return undefined;
     }

package/dist/steps/utils/ios/xcactivitylog.js

@@ -16,6 +16,7 @@ const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const zod_1 = require("zod");
 const sentry_1 = require("../../../sentry");
+const download_1 = require("../../../utils/download");
 const DEFAULT_XCLOGPARSER_VERSION = 'v0.2.47';
 const XCLOGPARSER_DOWNLOAD_URL = 'https://storage.googleapis.com/turtle-v2/xclogparser';
 const XCLOGPARSER_DOWNLOAD_TIMEOUT_MS = 20_000;
@@ -123,7 +124,7 @@ async function downloadXclogparser({ tempDir, version, logger, proxyBaseUrl, env
     const zipName = getXclogparserZipName(version);
     const zipPath = path_1.default.join(tempDir, zipName);
     const directUrl = `${XCLOGPARSER_DOWNLOAD_URL}/${zipName}`;
-    const proxiedUrl = getProxiedDownloadUrl({ directUrl, proxyBaseUrl });
+    const proxiedUrl = (0, download_1.getProxiedDownloadUrl)({ directUrl, proxyBaseUrl });
     if (proxiedUrl) {
         const proxiedDownloadResult = await (0, results_1.asyncResult)(downloadAndUnpackXclogparser({ tempDir, zipPath, sourceUrl: proxiedUrl, env }));
         if (!proxiedDownloadResult.ok) {
@@ -188,13 +189,6 @@ const COMPILE_SIGNATURE_PREFIXES = ['SwiftCompile ', 'SwiftGeneratePch '];
 function getXclogparserZipName(version) {
     return `XCLogParser-macOS-x86-64-arm64-${version}.zip`;
 }
-function getProxiedDownloadUrl({ directUrl, proxyBaseUrl, }) {
-    if (!proxyBaseUrl) {
-        return null;
-    }
-    const parsedUrl = new URL(directUrl);
-    return directUrl.replace(`${parsedUrl.protocol}//${parsedUrl.host}`, `${proxyBaseUrl}/${parsedUrl.host}`);
-}
 function isCompileStep(step) {
     const detailStepType = step.detailStepType ?? '';
     const signature = step.signature ?? '';

package/dist/utils/IosSimulatorUtils.d.ts

@@ -27,6 +27,14 @@ export declare namespace IosSimulatorUtils {
         runtimeDisplayName: string;
         displayName: string;
     };
+    export type IosSimulatorRuntime = {
+        identifier: string;
+        isAvailable?: boolean;
+        version?: string;
+    };
+    export function getAvailableRuntimesAsync({ env, }: {
+        env: NodeJS.ProcessEnv;
+    }): Promise<IosSimulatorRuntime[]>;
     export function getAvailableDevicesAsync({ env, filter, }: {
         env: NodeJS.ProcessEnv;
         filter: 'available' | 'booted';

package/dist/utils/IosSimulatorUtils.js

@@ -13,6 +13,15 @@ const promises_1 = require("node:timers/promises");
 const retry_1 = require("./retry");
 var IosSimulatorUtils;
 (function (IosSimulatorUtils) {
+    async function getAvailableRuntimesAsync({ env, }) {
+        const { stdout } = await (0, turtle_spawn_1.default)('xcrun', ['simctl', 'list', 'runtimes', '--json'], { env });
+        const { runtimes } = JSON.parse(stdout);
+        return runtimes.flatMap(runtime => runtime.isAvailable !== false &&
+            runtime.identifier?.startsWith('com.apple.CoreSimulator.SimRuntime.iOS-')
+            ? [{ ...runtime, identifier: runtime.identifier }]
+            : []);
+    }
+    IosSimulatorUtils.getAvailableRuntimesAsync = getAvailableRuntimesAsync;
     async function getAvailableDevicesAsync({ env, filter, }) {
         const result = await (0, turtle_spawn_1.default)('xcrun', ['simctl', 'list', 'devices', '--json', '--no-escape-slashes', filter], { env });
         const xcrunData = JSON.parse(result.stdout);

package/dist/utils/download.d.ts

@@ -0,0 +1,4 @@
+export declare function getProxiedDownloadUrl({ directUrl, proxyBaseUrl, }: {
+    directUrl: string;
+    proxyBaseUrl?: string;
+}): string | null;

package/dist/utils/download.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProxiedDownloadUrl = getProxiedDownloadUrl;
+function getProxiedDownloadUrl({ directUrl, proxyBaseUrl, }) {
+    if (!proxyBaseUrl) {
+        return null;
+    }
+    const parsedUrl = new URL(directUrl);
+    return directUrl.replace(`${parsedUrl.protocol}//${parsedUrl.host}`, `${proxyBaseUrl.replace(/\/$/, '')}/${parsedUrl.host}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/build-tools",
-  "version": "22.3.0",
+  "version": "22.5.0",
   "bugs": "https://github.com/expo/eas-cli/issues",
   "license": "BUSL-1.1",
   "author": "Expo <support@expo.io>",
@@ -25,6 +25,7 @@
     "build": "tsc",
     "build:record-sim": "mkdir -p bin && record_sim_bin_path=$(swift build -c release --package-path resources/record-sim --build-path resources/record-sim/.build --show-bin-path) && swift build -c release --package-path resources/record-sim --build-path resources/record-sim/.build && cp \"$record_sim_bin_path/record-sim\" bin/record-sim && chmod +x bin/record-sim",
     "typecheck": "tsc",
+    "generate-appium-commands": "mise exec node@22.22.0 -- node scripts/generate-appium-commands.js",
     "prepack": "rimraf dist \"*.tsbuildinfo\" && yarn gql && tsc -p tsconfig.build.json",
     "jest-unit": "jest --config jest/unit-config.ts",
     "jest-integration": "jest --config jest/integration-config.ts",
@@ -46,7 +47,7 @@
     "@expo/plist": "^0.3.5",
     "@expo/results": "^1.0.0",
     "@expo/spawn-async": "1.7.2",
-    "@expo/steps": "22.1.0",
+    "@expo/steps": "22.4.0",
     "@expo/template-file": "22.0.0",
     "@expo/turtle-spawn": "22.0.0",
     "@expo/xcpretty": "^4.3.1",
@@ -102,5 +103,5 @@
     "typescript": "^5.5.4",
     "uuid": "^9.0.1"
   },
-  "gitHead": "70066fc8beedabdd31081f18c18928461d400806"
+  "gitHead": "3f74ea369d329a363fe16c9f90c8be74cb598777"
 }