@expo/build-tools 22.4.0 → 22.6.0

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export { uploadWithSignedUrl } from './storage/uploadWithSignedUrl';
 export type { SignedUrl, UploadWithSignedUrlParams } from './storage/uploadWithSignedUrl';
 export { ArtifactToUpload, Artifacts, BuildContext, BuildContextOptions, CacheManager, LogBuffer, SkipNativeBuildError, } from './context';
 export { PackageManager } from './utils/packageManager';
+export * as TurtleSshSession from './utils/turtleSshSession';
+export { formatSecondsForLog } from './utils/formatDuration';
 export { findAndUploadXcodeBuildLogsAsync } from './ios/xcodeBuildLogs';
 export { Hook, runHookIfPresent } from './utils/hooks';
 export { parseGradleProfile, formatGradleProfileReport } from './android/gradleProfile';

package/dist/index.js

@@ -39,7 +39,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sentry = exports.Datadog = exports.formatGradleProfileReport = exports.parseGradleProfile = exports.runHookIfPresent = exports.Hook = exports.findAndUploadXcodeBuildLogsAsync = exports.PackageManager = exports.SkipNativeBuildError = exports.BuildContext = exports.uploadWithSignedUrl = exports.RemoteLoggerStream = exports.HttpLogStream = exports.Builders = void 0;
+exports.Sentry = exports.Datadog = exports.formatGradleProfileReport = exports.parseGradleProfile = exports.runHookIfPresent = exports.Hook = exports.findAndUploadXcodeBuildLogsAsync = exports.formatSecondsForLog = exports.TurtleSshSession = exports.PackageManager = exports.SkipNativeBuildError = exports.BuildContext = exports.uploadWithSignedUrl = exports.RemoteLoggerStream = exports.HttpLogStream = exports.Builders = void 0;
 const Builders = __importStar(require("./builders"));
 exports.Builders = Builders;
 const HttpLogStream_1 = __importDefault(require("./logging/HttpLogStream"));
@@ -53,6 +53,9 @@ Object.defineProperty(exports, "BuildContext", { enumerable: true, get: function
 Object.defineProperty(exports, "SkipNativeBuildError", { enumerable: true, get: function () { return context_1.SkipNativeBuildError; } });
 var packageManager_1 = require("./utils/packageManager");
 Object.defineProperty(exports, "PackageManager", { enumerable: true, get: function () { return packageManager_1.PackageManager; } });
+exports.TurtleSshSession = __importStar(require("./utils/turtleSshSession"));
+var formatDuration_1 = require("./utils/formatDuration");
+Object.defineProperty(exports, "formatSecondsForLog", { enumerable: true, get: function () { return formatDuration_1.formatSecondsForLog; } });
 var xcodeBuildLogs_1 = require("./ios/xcodeBuildLogs");
 Object.defineProperty(exports, "findAndUploadXcodeBuildLogsAsync", { enumerable: true, get: function () { return xcodeBuildLogs_1.findAndUploadXcodeBuildLogsAsync; } });
 var hooks_1 = require("./utils/hooks");

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',
@@ -63,6 +65,7 @@ async function launchApplicationAsync({ applicationIdentifier, activityName, lau
             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 });
         }
@@ -93,6 +96,28 @@ async function launchApplicationAsync({ applicationIdentifier, activityName, lau
         ], { 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}.`);

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/remoteDeviceRunSession.js

@@ -73,7 +73,7 @@ const SERVE_SIM_PACKAGE_NAME = '@expo/serve-sim';
 const SERVE_SIM_HOST = '127.0.0.1';
 const SERVE_SIM_MAX_DIMENSION = '1280';
 const SERVE_SIM_MJPEG_QUALITY = '0.55';
-const SERVE_SIM_VIDEO_BITRATE = '3000000';
+const SERVE_SIM_VIDEO_BITRATE = '6000000';
 const SERVE_SIM_VIDEO_FPS = '60';
 const START_DEVICE_RUN_SESSION_MUTATION = (0, gql_tada_1.graphql)(`
   mutation StartDeviceRunSession($deviceRunSessionId: ID!, $remoteConfig: JSONObject!) {

package/dist/utils/formatDuration.d.ts

@@ -0,0 +1 @@
+export declare function formatSecondsForLog(totalSeconds: number): string;

package/dist/utils/formatDuration.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSecondsForLog = formatSecondsForLog;
+function formatSecondsForLog(totalSeconds) {
+    const hours = Math.floor(totalSeconds / 3600);
+    const minutes = Math.floor((totalSeconds % 3600) / 60);
+    const seconds = totalSeconds % 60;
+    const parts = [];
+    if (hours > 0) {
+        parts.push(hours === 1 ? '1 hour' : `${hours} hours`);
+    }
+    if (minutes > 0) {
+        parts.push(minutes === 1 ? '1 minute' : `${minutes} minutes`);
+    }
+    if (seconds > 0 || parts.length === 0) {
+        parts.push(seconds === 1 ? '1 second' : `${seconds} seconds`);
+    }
+    return parts.join(' ');
+}

package/dist/utils/processes.d.ts

@@ -1,2 +1,9 @@
+import { ChildProcess } from 'node:child_process';
+export declare function isChildProcessAlive(child: ChildProcess): boolean;
+/**
+ * Kill a detached spawn's process group. Negated pid targets the group so bash/sleep
+ * children cannot survive after the parent is gone (e.g. across upterm redial).
+ */
+export declare function killProcessGroup(child: ChildProcess): void;
 export declare function getParentAndDescendantProcessPidsAsync(ppid: number): Promise<number[]>;
 export declare function isProcessDescendantOfAsync(pid: number, ancestorPid: number): Promise<boolean>;

package/dist/utils/processes.js

@@ -3,9 +3,29 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isChildProcessAlive = isChildProcessAlive;
+exports.killProcessGroup = killProcessGroup;
 exports.getParentAndDescendantProcessPidsAsync = getParentAndDescendantProcessPidsAsync;
 exports.isProcessDescendantOfAsync = isProcessDescendantOfAsync;
 const turtle_spawn_1 = __importDefault(require("@expo/turtle-spawn"));
+function isChildProcessAlive(child) {
+    return child.exitCode === null && child.signalCode === null && !child.killed;
+}
+/**
+ * Kill a detached spawn's process group. Negated pid targets the group so bash/sleep
+ * children cannot survive after the parent is gone (e.g. across upterm redial).
+ */
+function killProcessGroup(child) {
+    if (child.pid == null) {
+        return;
+    }
+    try {
+        process.kill(-child.pid, 'SIGTERM');
+    }
+    catch {
+        child.kill();
+    }
+}
 async function getChildrenPidsAsync(parentPids) {
     try {
         const result = await (0, turtle_spawn_1.default)('pgrep', ['-P', parentPids.join(',')], {

package/dist/utils/turtleSshSession.d.ts

@@ -0,0 +1,28 @@
+import { Job, SshSettings } from '@expo/eas-build-job';
+import { bunyan } from '@expo/logger';
+import { BuildContext } from '../context';
+export type TurtleSshTarget = {
+    type: 'BUILD' | 'JOB_RUN';
+    id: string;
+};
+export declare function isSshEnabled(job: Pick<Job, 'ssh'>): boolean;
+export declare function getSshIdleTimeoutSeconds(job: Pick<Job, 'ssh'>): number;
+export declare function getSshRelayServerUrl(job: Pick<Job, 'ssh'>): string;
+export type SshSessionHandle = {
+    getConnectedClientCountAsync: () => Promise<number>;
+    ensureConnectedAsync: () => Promise<void>;
+    stopAsync: () => Promise<void>;
+};
+export type StartedSshSession = {
+    handle: SshSessionHandle;
+    idleTimeoutSeconds: number;
+};
+export declare function startSshSessionAsync(ctx: BuildContext, { target, relayServerUrl, idleTimeoutSeconds: requestedIdleTimeoutSeconds, }: {
+    target: TurtleSshTarget;
+} & SshSettings): Promise<StartedSshSession>;
+export declare function superviseSshSessionAsync({ handle, idleTimeoutSeconds, hasJobFinished, logger, }: {
+    handle: SshSessionHandle;
+    idleTimeoutSeconds: number;
+    hasJobFinished: () => boolean;
+    logger: bunyan;
+}): Promise<void>;

package/dist/utils/turtleSshSession.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSshEnabled = isSshEnabled;
+exports.getSshIdleTimeoutSeconds = getSshIdleTimeoutSeconds;
+exports.getSshRelayServerUrl = getSshRelayServerUrl;
+exports.startSshSessionAsync = startSshSessionAsync;
+exports.superviseSshSessionAsync = superviseSshSessionAsync;
+const eas_build_job_1 = require("@expo/eas-build-job");
+const gql_tada_1 = require("gql.tada");
+const formatDuration_1 = require("./formatDuration");
+const retry_1 = require("./retry");
+const upterm_1 = require("./upterm");
+const sentry_1 = require("../sentry");
+const MAX_SSH_REDIALS = 10;
+const REDIAL_BACKOFF_MS = 6_000;
+const CLIENT_COUNT_POLL_INTERVAL_MS = 5_000;
+const MAX_SSH_IDLE_TIMEOUT_SECONDS = 3600;
+const DEFAULT_SSH_IDLE_TIMEOUT_SECONDS = 0;
+const CREATE_OR_UPDATE_TURTLE_SSH_SESSION_MUTATION = (0, gql_tada_1.graphql)(`
+  mutation CreateOrUpdateTurtleSshSession(
+    $target: TurtleSshTargetInput!
+    $connectionConfig: TurtleSshConnectionConfigInput!
+    $sessionSettings: TurtleSshSessionSettingsInput!
+  ) {
+    turtleSshSession {
+      createOrUpdateTurtleSshSession(
+        target: $target
+        connectionConfig: $connectionConfig
+        sessionSettings: $sessionSettings
+      ) {
+        id
+        sessionSettings {
+          idleTimeoutSeconds
+        }
+      }
+    }
+  }
+`);
+function isSshEnabled(job) {
+    return job.ssh != null;
+}
+function getSshIdleTimeoutSeconds(job) {
+    const idleTimeoutSeconds = job.ssh?.idleTimeoutSeconds ?? DEFAULT_SSH_IDLE_TIMEOUT_SECONDS;
+    if (!Number.isInteger(idleTimeoutSeconds) ||
+        idleTimeoutSeconds < 0 ||
+        idleTimeoutSeconds > MAX_SSH_IDLE_TIMEOUT_SECONDS) {
+        throw new eas_build_job_1.SystemError(`SSH idle timeout must be an integer between 0 and ${MAX_SSH_IDLE_TIMEOUT_SECONDS} seconds, got ${idleTimeoutSeconds}.`, { trackingCode: 'SSH_IDLE_TIMEOUT_INVALID' });
+    }
+    return idleTimeoutSeconds;
+}
+function getSshRelayServerUrl(job) {
+    const relayServerUrl = job.ssh?.relayServerUrl;
+    if (!relayServerUrl) {
+        throw new eas_build_job_1.SystemError('SSH is enabled but no relay server URL was configured on the job.', {
+            trackingCode: 'SSH_RELAY_SERVER_URL_MISSING',
+        });
+    }
+    return relayServerUrl;
+}
+async function createOrUpdateSessionAsync(ctx, { target, connectionConfig, idleTimeoutSeconds, }) {
+    const result = await ctx.graphqlClient
+        .mutation(CREATE_OR_UPDATE_TURTLE_SSH_SESSION_MUTATION, {
+        target,
+        connectionConfig: {
+            ...connectionConfig,
+            type: 'UPTERM_V1',
+        },
+        sessionSettings: { idleTimeoutSeconds },
+    })
+        .toPromise();
+    if (result.error || !result.data) {
+        throw new eas_build_job_1.SystemError(`Failed to create or update the SSH session: ${result.error?.message ?? 'no data returned'}`, { cause: result.error });
+    }
+    const session = result.data.turtleSshSession.createOrUpdateTurtleSshSession;
+    return { idleTimeoutSeconds: session.sessionSettings.idleTimeoutSeconds };
+}
+async function startSshSessionAsync(ctx, { target, relayServerUrl, idleTimeoutSeconds: requestedIdleTimeoutSeconds, }) {
+    const logger = ctx.logger;
+    const host = await (0, upterm_1.startUptermHostAsync)(ctx, { relayServerUrl });
+    let idleTimeoutSeconds;
+    try {
+        ({ idleTimeoutSeconds } = await createOrUpdateSessionAsync(ctx, {
+            target,
+            connectionConfig: { ...host.connectionConfig, reconnecting: false },
+            idleTimeoutSeconds: requestedIdleTimeoutSeconds,
+        }));
+    }
+    catch (err) {
+        await host.stopAsync().catch(() => { });
+        throw err;
+    }
+    const ensureConnectedAsync = async () => {
+        if (host.isAlive()) {
+            return;
+        }
+        for (let attempt = 1; attempt <= MAX_SSH_REDIALS; attempt++) {
+            try {
+                if (!host.isAlive()) {
+                    logger.warn('The SSH relay connection dropped. Reconnecting...');
+                    await createOrUpdateSessionAsync(ctx, {
+                        target,
+                        connectionConfig: { ...host.connectionConfig, reconnecting: true },
+                        idleTimeoutSeconds: requestedIdleTimeoutSeconds,
+                    }).catch(() => { });
+                    await host.redialAsync();
+                }
+                await createOrUpdateSessionAsync(ctx, {
+                    target,
+                    connectionConfig: { ...host.connectionConfig, reconnecting: false },
+                    idleTimeoutSeconds: requestedIdleTimeoutSeconds,
+                });
+                logger.info('The SSH relay connection was restored.');
+                return;
+            }
+            catch (err) {
+                logger.warn({ err }, `SSH reconnect attempt ${attempt} of ${MAX_SSH_REDIALS} failed.`);
+                if (attempt < MAX_SSH_REDIALS) {
+                    await (0, retry_1.sleepAsync)(REDIAL_BACKOFF_MS);
+                }
+            }
+        }
+        throw new eas_build_job_1.SystemError(`The SSH relay connection dropped and could not be restored after ${MAX_SSH_REDIALS} attempts.`);
+    };
+    return {
+        handle: {
+            getConnectedClientCountAsync: () => host.getConnectedClientCountAsync(),
+            ensureConnectedAsync,
+            stopAsync: () => host.stopAsync(),
+        },
+        idleTimeoutSeconds,
+    };
+}
+async function superviseSshSessionAsync({ handle, idleTimeoutSeconds, hasJobFinished, logger, }) {
+    const idleTimeoutMs = idleTimeoutSeconds * 1_000;
+    let idleSince = null;
+    let previousClientCount = 0;
+    for (;;) {
+        try {
+            await handle.ensureConnectedAsync();
+        }
+        catch (err) {
+            logger.warn({ err }, 'Could not restore the SSH relay connection. Closing the session.');
+            sentry_1.Sentry.capture('Could not restore the SSH relay connection', err instanceof Error ? err : undefined, {
+                tags: { trackingCode: 'SSH_RELAY_RECONNECT_FAILED' },
+            });
+            return;
+        }
+        let connectedClientCount;
+        try {
+            connectedClientCount = await handle.getConnectedClientCountAsync();
+        }
+        catch (err) {
+            logger.warn({ err }, 'Could not read the SSH client count. Closing the session.');
+            sentry_1.Sentry.capture('Could not read the SSH client count', err instanceof Error ? err : undefined, {
+                tags: { trackingCode: 'SSH_CLIENT_COUNT_UNREADABLE' },
+            });
+            return;
+        }
+        if (connectedClientCount !== previousClientCount) {
+            logger.info(`SSH clients connected: ${connectedClientCount}`);
+            previousClientCount = connectedClientCount;
+        }
+        const jobHasFinished = hasJobFinished();
+        if (connectedClientCount > 0 || !jobHasFinished) {
+            idleSince = null;
+        }
+        else if (idleSince === null) {
+            idleSince = Date.now();
+        }
+        if (jobHasFinished && connectedClientCount === 0) {
+            if (idleTimeoutSeconds === 0) {
+                logger.info('The job finished and no SSH client is connected. Closing the session.');
+                return;
+            }
+            if (idleSince !== null && Date.now() - idleSince >= idleTimeoutMs) {
+                logger.info(`No SSH client connected for ${(0, formatDuration_1.formatSecondsForLog)(idleTimeoutSeconds)} after the job finished. Closing the session.`);
+                return;
+            }
+        }
+        await (0, retry_1.sleepAsync)(CLIENT_COUNT_POLL_INTERVAL_MS);
+    }
+}

package/dist/utils/upterm.d.ts

@@ -0,0 +1,38 @@
+import { Env } from '@expo/eas-build-job';
+import { z } from 'zod';
+import { BuildContext } from '../context';
+export declare function resolveUptermGcsObjectName(platform?: NodeJS.Platform, arch?: string): string;
+export type SshConnectionConfig = {
+    type: 'upterm-v1';
+    host: string;
+    secret: string;
+};
+export type UptermHost = {
+    connectionConfig: SshConnectionConfig;
+    getConnectedClientCountAsync: () => Promise<number>;
+    isAlive: () => boolean;
+    redialAsync: () => Promise<SshConnectionConfig>;
+    stopAsync: () => Promise<void>;
+};
+declare const UptermSessionJsonZ: z.ZodObject<{
+    sessionId: z.ZodString;
+    host: z.ZodString;
+    clientCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type UptermSessionJson = z.infer<typeof UptermSessionJsonZ>;
+export declare function connectionConfigFromUptermSession(parsed: Pick<UptermSessionJson, 'sessionId' | 'host'>): SshConnectionConfig | null;
+/**
+ * Strip upterm session secrets out of text before it reaches a log or an error message. upterm
+ * prints the session id as the userinfo of the connect line it advertises
+ * (`upterm proxy ws(s)://<sessionId>@host`) and repeats it bare as the ssh destination on the
+ * same line. Control characters are dropped first so they cannot split a token mid-match. The
+ * loop lifts the id out of the proxy URL and removes every occurrence of it; the final replace
+ * blanks userinfo in any other URL as a catch-all.
+ */
+export declare function redactConnectionSecrets(text: string): string;
+export declare function redactSpawnErrorForLog(err: unknown): unknown;
+export declare function resolveUptermPathAsync(env: Env): Promise<string>;
+export declare function startUptermHostAsync(ctx: BuildContext, { relayServerUrl }: {
+    relayServerUrl: string;
+}): Promise<UptermHost>;
+export {};

package/dist/utils/upterm.js

@@ -0,0 +1,257 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveUptermGcsObjectName = resolveUptermGcsObjectName;
+exports.connectionConfigFromUptermSession = connectionConfigFromUptermSession;
+exports.redactConnectionSecrets = redactConnectionSecrets;
+exports.redactSpawnErrorForLog = redactSpawnErrorForLog;
+exports.resolveUptermPathAsync = resolveUptermPathAsync;
+exports.startUptermHostAsync = startUptermHostAsync;
+const eas_build_job_1 = require("@expo/eas-build-job");
+const downloader_1 = __importDefault(require("@expo/downloader"));
+const turtle_spawn_1 = __importDefault(require("@expo/turtle-spawn"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const zod_1 = require("zod");
+const processes_1 = require("./processes");
+const retry_1 = require("./retry");
+const CONTROL_CHARACTERS = /[\u0000-\u0008\u000B-\u001F\u007F-\u009F]/g;
+function resolveUptermGcsObjectName(platform = process.platform, arch = process.arch) {
+    if (platform === 'darwin' && arch === 'arm64') {
+        return 'upterm-darwin-arm64';
+    }
+    if (platform === 'linux' && arch === 'x64') {
+        return 'upterm-linux-amd64';
+    }
+    throw new eas_build_job_1.SystemError(`SSH upterm is only available on darwin/arm64 and linux/x64 (got ${platform}/${arch}).`);
+}
+const UPTERM_GCS_BASE_URL = 'https://storage.googleapis.com/turtle-v2/upterm';
+const UPTERM_DOWNLOAD_TIMEOUT_MS = 60_000;
+const UPTERM_KEEPALIVE_SLEEP_SECONDS = 6 * 60 * 60;
+const CONNECTION_POLL_INTERVAL_MS = 500;
+const CONNECTION_STARTUP_TIMEOUT_MS = 60_000;
+const PROCESS_EXIT_TIMEOUT_MS = 5_000;
+const CLIENT_COUNT_READ_ATTEMPTS = 4;
+const CLIENT_COUNT_READ_RETRY_MS = 500;
+const DEFAULT_SSH_PORT = '22';
+const UptermSessionJsonZ = zod_1.z.object({
+    sessionId: zod_1.z.string().min(1),
+    host: zod_1.z.string().min(1),
+    clientCount: zod_1.z.number().optional(),
+});
+function connectionConfigFromUptermSession(parsed) {
+    let host = parsed.host;
+    if (host.includes('://')) {
+        let url;
+        try {
+            url = new URL(host);
+        }
+        catch {
+            return null;
+        }
+        host = url.port && url.port !== DEFAULT_SSH_PORT ? `${url.hostname}:${url.port}` : url.hostname;
+    }
+    if (!host) {
+        return null;
+    }
+    return { type: 'upterm-v1', host, secret: parsed.sessionId };
+}
+/**
+ * Strip upterm session secrets out of text before it reaches a log or an error message. upterm
+ * prints the session id as the userinfo of the connect line it advertises
+ * (`upterm proxy ws(s)://<sessionId>@host`) and repeats it bare as the ssh destination on the
+ * same line. Control characters are dropped first so they cannot split a token mid-match. The
+ * loop lifts the id out of the proxy URL and removes every occurrence of it; the final replace
+ * blanks userinfo in any other URL as a catch-all.
+ */
+function redactConnectionSecrets(text) {
+    let redacted = text.replace(CONTROL_CHARACTERS, '');
+    for (const [, token] of redacted.matchAll(/upterm proxy wss?:\/\/([^@\s]+)@/g)) {
+        redacted = redacted.split(token).join('<redacted>');
+    }
+    return redacted.replace(/([a-z][a-z0-9+.-]*:\/\/)[^@\s/]+@/gi, '$1<redacted>@');
+}
+function redactSpawnErrorForLog(err) {
+    if (!err || typeof err !== 'object') {
+        return err;
+    }
+    const spawnErr = err;
+    return {
+        ...spawnErr,
+        ...(typeof spawnErr.message === 'string'
+            ? { message: redactConnectionSecrets(spawnErr.message) }
+            : {}),
+        ...(typeof spawnErr.stdout === 'string'
+            ? { stdout: redactConnectionSecrets(spawnErr.stdout) }
+            : {}),
+        ...(typeof spawnErr.stderr === 'string'
+            ? { stderr: redactConnectionSecrets(spawnErr.stderr) }
+            : {}),
+    };
+}
+async function resolveUptermPathAsync(env) {
+    try {
+        await (0, turtle_spawn_1.default)('upterm', ['version'], { stdio: 'pipe', env });
+        return 'upterm';
+    }
+    catch { }
+    const objectName = resolveUptermGcsObjectName();
+    const downloadDir = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'eas-upterm-'));
+    const uptermPath = node_path_1.default.join(downloadDir, objectName);
+    const url = `${UPTERM_GCS_BASE_URL}/${objectName}`;
+    try {
+        await (0, downloader_1.default)(url, uptermPath, { retry: 3, timeout: UPTERM_DOWNLOAD_TIMEOUT_MS });
+        await promises_1.default.chmod(uptermPath, 0o755);
+    }
+    catch (err) {
+        await promises_1.default.rm(downloadDir, { recursive: true, force: true }).catch(() => { });
+        throw new eas_build_job_1.SystemError(`The upterm SSH client was not on PATH and could not be downloaded from ${url}. ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return uptermPath;
+}
+async function findAdminSocketPathAsync(uptermSocketDir) {
+    // Use this dial's own admin socket, not upterm's default, which can still point at a previous
+    // dial's session after a redial and break client-count reads.
+    const entries = await promises_1.default.readdir(uptermSocketDir).catch(() => []);
+    const socketName = entries.find(entry => entry.endsWith('.sock'));
+    return socketName ? node_path_1.default.join(uptermSocketDir, socketName) : null;
+}
+async function readCurrentSessionJsonAsync(uptermPath, adminSocketPath) {
+    try {
+        const result = await (0, turtle_spawn_1.default)(uptermPath, ['session', 'current', '--admin-socket', adminSocketPath, '--output', 'json'], { stdio: 'pipe' });
+        const parsed = UptermSessionJsonZ.safeParse(JSON.parse(result.stdout));
+        return parsed.success ? parsed.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function waitForConnectionConfigAsync(uptermPath, uptermSocketDir, getHostOutput) {
+    const deadline = Date.now() + CONNECTION_STARTUP_TIMEOUT_MS;
+    for (;;) {
+        const adminSocketPath = await findAdminSocketPathAsync(uptermSocketDir);
+        if (adminSocketPath) {
+            const session = await readCurrentSessionJsonAsync(uptermPath, adminSocketPath);
+            if (session) {
+                const connectionConfig = connectionConfigFromUptermSession(session);
+                if (connectionConfig) {
+                    return connectionConfig;
+                }
+            }
+        }
+        if (Date.now() >= deadline) {
+            throw new eas_build_job_1.SystemError(`The upterm client did not register with the relay within ${CONNECTION_STARTUP_TIMEOUT_MS / 1_000}s. Output:\n${redactConnectionSecrets(getHostOutput())}`);
+        }
+        await (0, retry_1.sleepAsync)(CONNECTION_POLL_INTERVAL_MS);
+    }
+}
+async function startUptermHostAsync(ctx, { relayServerUrl }) {
+    const uptermPath = await resolveUptermPathAsync(ctx.env);
+    const stateDir = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), 'eas-ssh-'));
+    const hostKeyPath = node_path_1.default.join(stateDir, 'id_host');
+    const forceCommandPath = node_path_1.default.join(stateDir, 'join.sh');
+    const uptermSocketDir = node_path_1.default.join(stateDir, 'upterm');
+    await (0, turtle_spawn_1.default)('ssh-keygen', ['-t', 'ed25519', '-N', '', '-f', hostKeyPath, '-q'], {
+        logger: ctx.logger,
+    });
+    await promises_1.default.writeFile(forceCommandPath, '#!/usr/bin/env bash\nexec bash -l\n', { mode: 0o755 });
+    let currentProcess = null;
+    const stopCurrentProcessAsync = async () => {
+        const previousProcess = currentProcess;
+        currentProcess = null;
+        if (!previousProcess) {
+            return;
+        }
+        (0, processes_1.killProcessGroup)(previousProcess.child);
+        await Promise.race([
+            previousProcess.catch(() => { }),
+            (0, retry_1.sleepAsync)(PROCESS_EXIT_TIMEOUT_MS).then(() => {
+                ctx.logger.debug('The previous upterm host process did not exit in time.');
+            }),
+        ]);
+    };
+    const getConnectedClientCountAsync = async () => {
+        for (let attempt = 1; attempt <= CLIENT_COUNT_READ_ATTEMPTS; attempt++) {
+            const adminSocketPath = await findAdminSocketPathAsync(uptermSocketDir);
+            const session = adminSocketPath
+                ? await readCurrentSessionJsonAsync(uptermPath, adminSocketPath)
+                : null;
+            if (session && typeof session.clientCount === 'number') {
+                return session.clientCount;
+            }
+            if (attempt < CLIENT_COUNT_READ_ATTEMPTS) {
+                await (0, retry_1.sleepAsync)(CLIENT_COUNT_READ_RETRY_MS);
+            }
+        }
+        throw new eas_build_job_1.SystemError('Could not read the SSH client count from the upterm admin socket.', {
+            trackingCode: 'SSH_CLIENT_COUNT_UNREADABLE',
+        });
+    };
+    const dialAsync = async () => {
+        await stopCurrentProcessAsync();
+        await promises_1.default.rm(uptermSocketDir, { recursive: true, force: true }).catch(err => {
+            ctx.logger.debug({ err }, 'Failed to clear the previous SSH socket directory.');
+        });
+        ctx.logger.debug('Connecting to the SSH relay.');
+        // --force-command is what each connecting SSH client runs (a login shell). The `sleep` after
+        // `--` is the host-side process that keeps `upterm host` up while nobody is connected.
+        const uptermProcess = (0, turtle_spawn_1.default)(uptermPath, [
+            'host',
+            '--server',
+            relayServerUrl,
+            '--accept',
+            '--skip-host-key-check',
+            '-i',
+            hostKeyPath,
+            '--force-command',
+            forceCommandPath,
+            '--',
+            'bash',
+            '-lc',
+            `sleep ${UPTERM_KEEPALIVE_SLEEP_SECONDS}`,
+        ], {
+            // upterm puts its admin socket under XDG_RUNTIME_DIR; point it at our state dir so we can
+            // find it for `session current` and clean it up on stop/redial.
+            env: { ...ctx.env, XDG_RUNTIME_DIR: stateDir },
+            stdio: ['ignore', 'pipe', 'pipe'],
+            detached: true,
+        });
+        uptermProcess.catch(err => ctx.logger.debug({ err: redactSpawnErrorForLog(err) }, 'The upterm host process exited.'));
+        uptermProcess.child.unref();
+        currentProcess = uptermProcess;
+        let output = '';
+        const appendChunk = (chunk) => {
+            output += chunk.toString();
+        };
+        uptermProcess.child.stdout?.on('data', appendChunk);
+        uptermProcess.child.stderr?.on('data', appendChunk);
+        return await waitForConnectionConfigAsync(uptermPath, uptermSocketDir, () => output);
+    };
+    const stopAsync = async () => {
+        await stopCurrentProcessAsync();
+        await promises_1.default.rm(stateDir, { recursive: true, force: true });
+    };
+    let connectionConfig;
+    try {
+        connectionConfig = await dialAsync();
+    }
+    catch (err) {
+        await stopAsync();
+        throw err;
+    }
+    return {
+        get connectionConfig() {
+            return connectionConfig;
+        },
+        getConnectedClientCountAsync,
+        isAlive: () => currentProcess != null && (0, processes_1.isChildProcessAlive)(currentProcess.child),
+        redialAsync: async () => {
+            connectionConfig = await dialAsync();
+            return connectionConfig;
+        },
+        stopAsync,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo/build-tools",
-  "version": "22.4.0",
+  "version": "22.6.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",
@@ -102,5 +103,5 @@
     "typescript": "^5.5.4",
     "uuid": "^9.0.1"
   },
-  "gitHead": "39c39ad4bfdd1e7e74417bb6f7178b011ce61bbe"
+  "gitHead": "89fe2cb3e1bba6e153752f1acf26b7817974b4a4"
 }