agent-device 0.8.6 → 0.10.0

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export { createAgentDeviceClient, type AgentDeviceClient, type AgentDeviceClientConfig, type AgentDeviceDevice, type AgentDeviceIdentifiers, type AgentDeviceSelectionOptions, type AgentDeviceSession, type AgentDeviceSessionDevice, type AppCloseOptions, type AppCloseResult, type AppDeployOptions, type AppDeployResult, type AppInstallFromSourceOptions, type AppInstallFromSourceResult, type AppOpenOptions, type AppOpenResult, type CaptureScreenshotOptions, type CaptureScreenshotResult, type CaptureSnapshotOptions, type CaptureSnapshotResult, type EnsureSimulatorOptions, type EnsureSimulatorResult, type MaterializationReleaseOptions, type MaterializationReleaseResult, type MetroPrepareOptions, type MetroPrepareResult, type RuntimeResult, type RuntimeSetOptions, type RuntimeShowOptions, type SessionCloseResult, type StartupPerfSample, } from './client.ts';
+export { createAgentDeviceClient, type AgentDeviceClient, type AgentDeviceClientConfig, type AgentDeviceDevice, type AgentDeviceIdentifiers, type AgentDeviceSelectionOptions, type AgentDeviceSession, type AgentDeviceSessionDevice, type AppCloseOptions, type AppCloseResult, type AppDeployOptions, type AppDeployResult, type AppInstallFromSourceOptions, type AppInstallFromSourceResult, type AppOpenOptions, type AppOpenResult, type CaptureScreenshotOptions, type CaptureScreenshotResult, type CaptureSnapshotOptions, type CaptureSnapshotResult, type EnsureSimulatorOptions, type EnsureSimulatorResult, type MaterializationReleaseOptions, type MaterializationReleaseResult, type MetroPrepareOptions, type MetroPrepareResult, type SessionCloseResult, type StartupPerfSample, } from './client.ts';
 export { AppError, type NormalizedError } from './utils/errors.ts';
 export type { MetroPrepareKind, MetroRuntimeHints } from './client-metro.ts';
 export type { SessionRuntimeHints } from './daemon/types.ts';

package/dist/src/platforms/android/devices.d.ts

@@ -1,7 +1,11 @@
+import { runCmd } from '../../utils/exec.ts';
 import type { DeviceInfo } from '../../utils/device.ts';
 type AndroidDeviceDiscoveryOptions = {
     serialAllowlist?: ReadonlySet<string>;
 };
+type AndroidAdbRunner = typeof runCmd;
+export declare function parseAndroidEmulatorAvdNameOutput(rawOutput: string): string | undefined;
+export declare function resolveAndroidEmulatorAvdName(serial: string, runAdb?: AndroidAdbRunner): Promise<string | undefined>;
 export declare function parseAndroidTargetFromCharacteristics(rawOutput: string): 'tv' | null;
 export declare function parseAndroidFeatureListForTv(rawOutput: string): boolean;
 export declare function listAndroidDevices(options?: AndroidDeviceDiscoveryOptions): Promise<DeviceInfo[]>;

package/dist/src/platforms/android/sdk.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveAndroidSdkRoots(env?: NodeJS.ProcessEnv): string[];
+export declare function ensureAndroidSdkPathConfigured(env?: NodeJS.ProcessEnv): Promise<void>;

package/dist/src/platforms/ios/app-filter.d.ts

@@ -0,0 +1,2 @@
+import type { IosAppInfo } from './devicectl.ts';
+export declare function filterAppleAppsByBundlePrefix(apps: IosAppInfo[], filter: 'user-installed' | 'all'): IosAppInfo[];

package/dist/src/platforms/ios/devices.d.ts

@@ -35,5 +35,6 @@ type FindBootableSimulatorOptions = IosDeviceDiscoveryOptions & {
  * Returns `null` when no suitable simulator can be found.
  */
 export declare function findBootableIosSimulator(options?: FindBootableSimulatorOptions): Promise<DeviceInfo | null>;
-export declare function listIosDevices(options?: IosDeviceDiscoveryOptions): Promise<DeviceInfo[]>;
+export declare function listAppleDevices(options?: IosDeviceDiscoveryOptions): Promise<DeviceInfo[]>;
+export declare const listIosDevices: typeof listAppleDevices;
 export {};

package/dist/src/platforms/ios/macos-apps.d.ts

@@ -0,0 +1,12 @@
+import type { DeviceInfo } from '../../utils/device.ts';
+import type { IosAppInfo } from './devicectl.ts';
+export declare function resolveMacOsApp(app: string): Promise<string>;
+export declare function openMacOsApp(_device: DeviceInfo, app: string, options?: {
+    appBundleId?: string;
+    url?: string;
+}): Promise<void>;
+export declare function closeMacOsApp(_device: DeviceInfo, app: string): Promise<void>;
+export declare function readMacOsClipboardText(): Promise<string>;
+export declare function writeMacOsClipboardText(text: string): Promise<void>;
+export declare function setMacOsAppearance(state: string): Promise<void>;
+export declare function listMacApps(filter?: 'user-installed' | 'all'): Promise<IosAppInfo[]>;

package/dist/src/platforms/ios/runner-client.d.ts

@@ -1,11 +1,13 @@
 import type { DeviceInfo } from '../../utils/device.ts';
+import type { ClickButton } from '../../core/click-button.ts';
 export type RunnerCommand = {
-    command: 'tap' | 'tapSeries' | 'longPress' | 'drag' | 'dragSeries' | 'type' | 'swipe' | 'findText' | 'snapshot' | 'screenshot' | 'back' | 'home' | 'appSwitcher' | 'alert' | 'pinch' | 'recordStart' | 'recordStop' | 'shutdown';
+    command: 'tap' | 'mouseClick' | 'tapSeries' | 'longPress' | 'drag' | 'dragSeries' | 'type' | 'swipe' | 'findText' | 'snapshot' | 'screenshot' | 'back' | 'home' | 'appSwitcher' | 'alert' | 'pinch' | 'recordStart' | 'recordStop' | 'shutdown';
     appBundleId?: string;
     text?: string;
     action?: 'get' | 'accept' | 'dismiss';
     x?: number;
     y?: number;
+    button?: ClickButton;
     count?: number;
     intervalMs?: number;
     doubleTap?: boolean;

package/dist/src/platforms/ios/runner-macos-products.d.ts

@@ -0,0 +1,3 @@
+import type { DeviceInfo } from '../../utils/device.ts';
+export declare function repairMacOsRunnerProductsIfNeeded(device: DeviceInfo, productPaths: string[], xctestrunPath: string): Promise<void>;
+export declare function isExpectedRunnerRepairFailure(error: unknown): boolean;

package/dist/src/platforms/ios/runner-xctestrun-products.d.ts

@@ -0,0 +1,2 @@
+export declare function xctestrunReferencesExistingProducts(xctestrunPath: string): boolean;
+export declare function resolveExistingXctestrunProductPaths(xctestrunPath: string): string[] | null;

package/dist/src/platforms/ios/runner-xctestrun.d.ts

@@ -1,11 +1,28 @@
 import { type DeviceInfo } from '../../utils/device.ts';
+export { xctestrunReferencesExistingProducts } from './runner-xctestrun-products.ts';
 export declare const runnerPrepProcesses: Set<import("child_process").ChildProcess>;
 export declare const IOS_RUNNER_CONTAINER_BUNDLE_IDS: string[];
+type EnsureXctestrunDeps = {
+    findProjectRoot: () => string;
+    findXctestrun: (root: string) => string | null;
+    xctestrunReferencesProjectRoot: (xctestrunPath: string, projectRoot: string) => boolean;
+    resolveExistingXctestrunProductPaths: (xctestrunPath: string) => string[] | null;
+    repairRunnerProductsIfNeeded: (device: DeviceInfo, productPaths: string[], xctestrunPath: string) => Promise<void>;
+    assertSafeDerivedCleanup: (derivedPath: string) => void;
+    cleanRunnerDerivedArtifacts: (derivedPath: string) => void;
+    buildRunnerXctestrun: (device: DeviceInfo, projectPath: string, derived: string, options: {
+        verbose?: boolean;
+        logPath?: string;
+        traceLogPath?: string;
+    }) => Promise<void>;
+};
 export declare function ensureXctestrun(device: DeviceInfo, options: {
     verbose?: boolean;
     logPath?: string;
     traceLogPath?: string;
-}): Promise<string>;
+}, deps?: EnsureXctestrunDeps): Promise<string>;
+export declare function shouldDeleteRunnerDerivedRootEntry(entryName: string): boolean;
+export declare function xctestrunReferencesProjectRoot(xctestrunPath: string, projectRoot: string): boolean;
 export declare function prepareXctestrunWithEnv(xctestrunPath: string, envVars: Record<string, string>, suffix: string): Promise<{
     xctestrunPath: string;
     jsonPath: string;
@@ -13,6 +30,7 @@ export declare function prepareXctestrunWithEnv(xctestrunPath: string, envVars:
 export declare function resolveRunnerDestination(device: DeviceInfo): string;
 export declare function resolveRunnerBuildDestination(device: DeviceInfo): string;
 export declare function resolveRunnerMaxConcurrentDestinationsFlag(device: DeviceInfo): string;
-export declare function resolveRunnerSigningBuildSettings(env?: NodeJS.ProcessEnv, forDevice?: boolean): string[];
+export declare function resolveRunnerSigningBuildSettings(env?: NodeJS.ProcessEnv, forDevice?: boolean, platform?: DeviceInfo['platform']): string[];
 export declare function resolveRunnerBundleBuildSettings(env?: NodeJS.ProcessEnv): string[];
+export declare function resolveRunnerPerformanceBuildSettings(): string[];
 export declare function assertSafeDerivedCleanup(derivedPath: string, env?: NodeJS.ProcessEnv): void;

package/dist/src/utils/args.d.ts

@@ -21,7 +21,7 @@ type FinalizeArgsOptions = ParseArgsOptions & {
 export declare function parseArgs(argv: string[], options?: FinalizeArgsOptions): ParsedArgs;
 export declare function parseRawArgs(argv: string[]): RawParsedArgs;
 export declare function finalizeParsedArgs(parsed: RawParsedArgs, options?: FinalizeArgsOptions): ParsedArgs;
-export declare function toDaemonFlags(flags: CliFlags): Omit<CliFlags, 'json' | 'config' | 'help' | 'version'>;
+export declare function toDaemonFlags(flags: CliFlags): Omit<CliFlags, 'json' | 'config' | 'remoteConfig' | 'help' | 'version'>;
 export declare function usage(): string;
 export declare function usageForCommand(command: string): string | null;
 export {};

package/dist/src/utils/cli-config.d.ts

@@ -1,4 +1,4 @@
-import { type CliFlags } from './command-schema.ts';
+import { type CliFlags, type FlagKey } from './command-schema.ts';
 type EnvMap = Record<string, string | undefined>;
 export declare function resolveConfigBackedFlagDefaults(options: {
     command: string | null;
@@ -6,4 +6,5 @@ export declare function resolveConfigBackedFlagDefaults(options: {
     cliFlags: CliFlags;
     env?: EnvMap;
 }): Partial<CliFlags>;
+export declare function readEnvFlagDefaultsForKeys(env: EnvMap, keys: readonly FlagKey[]): Partial<CliFlags>;
 export {};

package/dist/src/utils/command-schema.d.ts

@@ -1,6 +1,7 @@
 export type CliFlags = {
     json: boolean;
     config?: string;
+    remoteConfig?: string;
     stateDir?: string;
     daemonBaseUrl?: string;
     daemonAuthToken?: string;
@@ -13,8 +14,8 @@ export type CliFlags = {
     sessionLock?: 'reject' | 'strip';
     sessionLocked?: boolean;
     sessionLockConflicts?: 'reject' | 'strip';
-    platform?: 'ios' | 'android' | 'apple';
-    target?: 'mobile' | 'tv';
+    platform?: 'ios' | 'macos' | 'android' | 'apple';
+    target?: 'mobile' | 'tv' | 'desktop';
     device?: string;
     udid?: string;
     serial?: string;
@@ -57,6 +58,7 @@ export type CliFlags = {
     holdMs?: number;
     jitterPx?: number;
     doubleTap?: boolean;
+    clickButton?: 'primary' | 'secondary' | 'middle';
     pauseMs?: number;
     pattern?: 'one-way' | 'ping-pong';
     activity?: string;
@@ -97,13 +99,15 @@ export type FlagDefinition = {
     usageDescription?: string;
 };
 type CommandSchema = {
-    description: string;
+    helpDescription: string;
+    summary?: string;
     positionalArgs: readonly string[];
     allowsExtraPositionals?: boolean;
     allowedFlags: readonly FlagKey[];
     defaults?: Partial<CliFlags>;
     skipCapabilityCheck?: boolean;
     usageOverride?: string;
+    listUsageOverride?: string;
 };
 export declare const GLOBAL_FLAG_KEYS: Set<keyof CliFlags>;
 export declare function getFlagDefinition(token: string): FlagDefinition | undefined;

package/dist/src/utils/device.d.ts

@@ -1,7 +1,8 @@
-export type Platform = 'ios' | 'android';
+export type ApplePlatform = 'ios' | 'macos';
+export type Platform = ApplePlatform | 'android';
 export type PlatformSelector = Platform | 'apple';
 export type DeviceKind = 'simulator' | 'emulator' | 'device';
-export type DeviceTarget = 'mobile' | 'tv';
+export type DeviceTarget = 'mobile' | 'tv' | 'desktop';
 export type DeviceInfo = {
     platform: Platform;
     id: string;
@@ -12,7 +13,7 @@ export type DeviceInfo = {
     simulatorSetPath?: string;
 };
 type DeviceSelector = {
-    platform?: Platform;
+    platform?: PlatformSelector;
     target?: DeviceTarget;
     deviceName?: string;
     udid?: string;
@@ -21,7 +22,14 @@ type DeviceSelector = {
 type DeviceSelectionContext = {
     simulatorSetPath?: string;
 };
-export declare function normalizePlatformSelector(platform: PlatformSelector | undefined): Platform | undefined;
-export declare function resolveApplePlatformName(target: DeviceTarget | undefined): 'iOS' | 'tvOS';
+export declare function normalizePlatformSelector(platform: PlatformSelector | undefined): PlatformSelector | undefined;
+export declare function isApplePlatform(platform: Platform | PlatformSelector | undefined): platform is ApplePlatform | 'apple';
+export declare function matchesPlatformSelector(platform: Platform, selector: PlatformSelector | undefined): boolean;
+export declare function resolveApplePlatformName(platformOrTarget: ApplePlatform | DeviceTarget | undefined): 'iOS' | 'tvOS' | 'macOS';
+export declare function resolveAppleSimulatorSetPathForSelector(params: {
+    simulatorSetPath?: string;
+    platform?: PlatformSelector;
+    target?: DeviceTarget;
+}): string | undefined;
 export declare function resolveDevice(devices: DeviceInfo[], selector: DeviceSelector, context?: DeviceSelectionContext): Promise<DeviceInfo>;
 export {};

package/dist/src/utils/remote-config.d.ts

@@ -0,0 +1,15 @@
+import type { CliFlags } from './command-schema.ts';
+type EnvMap = Record<string, string | undefined>;
+export declare const REMOTE_OPEN_FLAG_KEYS: readonly ["remoteConfig", "session", "platform", "daemonBaseUrl", "daemonAuthToken", "daemonTransport", "metroProjectRoot", "metroKind", "metroPublicBaseUrl", "metroProxyBaseUrl", "metroBearerToken", "metroPreparePort", "metroListenHost", "metroStatusHost", "metroStartupTimeoutMs", "metroProbeTimeoutMs", "metroRuntimeFile", "metroNoReuseExisting", "metroNoInstallDeps"];
+export declare function loadRemoteConfigFile(options: {
+    configPath: string;
+    cwd: string;
+    env?: EnvMap;
+}): Partial<CliFlags>;
+export declare function resolveRemoteConfigDefaults(options: {
+    cliFlags: CliFlags;
+    cwd: string;
+    env: EnvMap;
+}): Partial<CliFlags>;
+export declare function pickRemoteOpenDefaults(defaultFlags: Partial<CliFlags>): Partial<CliFlags>;
+export {};

package/dist/src/utils/remote-open.d.ts

@@ -0,0 +1,9 @@
+import type { AgentDeviceClient } from '../client.ts';
+import type { CliFlags } from './command-schema.ts';
+export declare function resolveRemoteOpenRuntime(flags: CliFlags, client: AgentDeviceClient): Promise<{
+    platform?: 'ios' | 'android';
+    metroHost?: string;
+    metroPort?: number;
+    bundleUrl?: string;
+    launchUrl?: string;
+} | undefined>;

package/ios-runner/AgentDeviceRunner/AgentDeviceRunner.xcodeproj/project.pbxproj

@@ -253,11 +253,12 @@
 				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
 				GCC_WARN_UNDECLARED_SELECTOR = YES;
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
-				GCC_WARN_UNUSED_FUNCTION = YES;
-				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
-				LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
-				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
+					GCC_WARN_UNUSED_FUNCTION = YES;
+					GCC_WARN_UNUSED_VARIABLE = YES;
+					IPHONEOS_DEPLOYMENT_TARGET = 15.6;
+					LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
+					MACOSX_DEPLOYMENT_TARGET = 13.0;
+					MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
 				MTL_FAST_MATH = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = auto;
@@ -313,11 +314,12 @@
 				GCC_WARN_ABOUT_RETURN_TYPE = YES_ERROR;
 				GCC_WARN_UNDECLARED_SELECTOR = YES;
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
-				GCC_WARN_UNUSED_FUNCTION = YES;
-				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
-				LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
-				MTL_ENABLE_DEBUG_INFO = NO;
+					GCC_WARN_UNUSED_FUNCTION = YES;
+					GCC_WARN_UNUSED_VARIABLE = YES;
+					IPHONEOS_DEPLOYMENT_TARGET = 15.6;
+					LOCALIZATION_PREFERS_STRING_CATALOGS = YES;
+					MACOSX_DEPLOYMENT_TARGET = 13.0;
+					MTL_ENABLE_DEBUG_INFO = NO;
 				MTL_FAST_MATH = YES;
 				SDKROOT = auto;
 				SWIFT_COMPILATION_MODE = wholemodule;
@@ -338,14 +340,15 @@
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;
-				INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
-				INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
-				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
-				LD_RUNPATH_SEARCH_PATHS = (
-					"$(inherited)",
-					"@executable_path/Frameworks",
-				);
-				MARKETING_VERSION = 1.0;
+					INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
+					INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
+					IPHONEOS_DEPLOYMENT_TARGET = 15.6;
+					LD_RUNPATH_SEARCH_PATHS = (
+						"$(inherited)",
+						"@executable_path/Frameworks",
+					);
+					MACOSX_DEPLOYMENT_TARGET = 13.0;
+					MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = "$(AGENT_DEVICE_IOS_RUNNER_APP_BUNDLE_ID)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				STRING_CATALOG_GENERATE_SYMBOLS = YES;
@@ -354,9 +357,9 @@
 				SWIFT_EMIT_LOC_STRINGS = YES;
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator appletvos appletvsimulator";
-				TARGETED_DEVICE_FAMILY = "1,2,3";
-				TVOS_DEPLOYMENT_TARGET = 15.6;
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3";
+					TVOS_DEPLOYMENT_TARGET = 15.6;
 			};
 			name = Debug;
 		};
@@ -373,14 +376,15 @@
 				INFOPLIST_KEY_UIApplicationSceneManifest_Generation = YES;
 				INFOPLIST_KEY_UIApplicationSupportsIndirectInputEvents = YES;
 				INFOPLIST_KEY_UILaunchScreen_Generation = YES;
-				INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
-				INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
-				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
-				LD_RUNPATH_SEARCH_PATHS = (
-					"$(inherited)",
-					"@executable_path/Frameworks",
-				);
-				MARKETING_VERSION = 1.0;
+					INFOPLIST_KEY_UISupportedInterfaceOrientations_iPad = "UIInterfaceOrientationPortrait UIInterfaceOrientationPortraitUpsideDown UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
+					INFOPLIST_KEY_UISupportedInterfaceOrientations_iPhone = "UIInterfaceOrientationPortrait UIInterfaceOrientationLandscapeLeft UIInterfaceOrientationLandscapeRight";
+					IPHONEOS_DEPLOYMENT_TARGET = 15.6;
+					LD_RUNPATH_SEARCH_PATHS = (
+						"$(inherited)",
+						"@executable_path/Frameworks",
+					);
+					MACOSX_DEPLOYMENT_TARGET = 13.0;
+					MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = "$(AGENT_DEVICE_IOS_RUNNER_APP_BUNDLE_ID)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				STRING_CATALOG_GENERATE_SYMBOLS = YES;
@@ -389,21 +393,23 @@
 				SWIFT_EMIT_LOC_STRINGS = YES;
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator appletvos appletvsimulator";
-				TARGETED_DEVICE_FAMILY = "1,2,3";
-				TVOS_DEPLOYMENT_TARGET = 15.6;
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3";
+					TVOS_DEPLOYMENT_TARGET = 15.6;
 			};
 			name = Release;
 		};
 		20EA2EEE2F2CFC7C001CF0EF /* Debug */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 1;
-				DEVELOPMENT_TEAM = 2S799L9W4M;
-				GENERATE_INFOPLIST_FILE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
-				MARKETING_VERSION = 1.0;
+					"CODE_SIGN_ENTITLEMENTS[sdk=macosx*]" = AgentDeviceRunnerUITests/AgentDeviceRunnerUITests.entitlements;
+					CODE_SIGN_STYLE = Automatic;
+					CURRENT_PROJECT_VERSION = 1;
+					DEVELOPMENT_TEAM = 2S799L9W4M;
+					GENERATE_INFOPLIST_FILE = YES;
+					IPHONEOS_DEPLOYMENT_TARGET = 15.6;
+					MACOSX_DEPLOYMENT_TARGET = 13.0;
+					MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = "$(AGENT_DEVICE_IOS_RUNNER_TEST_BUNDLE_ID)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				STRING_CATALOG_GENERATE_SYMBOLS = NO;
@@ -412,9 +418,9 @@
 				SWIFT_OBJC_BRIDGING_HEADER = "AgentDeviceRunnerUITests/AgentDeviceRunnerUITests-Bridging-Header.h";
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator appletvos appletvsimulator";
-				TARGETED_DEVICE_FAMILY = "1,2,3";
-				TVOS_DEPLOYMENT_TARGET = 15.6;
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3";
+					TVOS_DEPLOYMENT_TARGET = 15.6;
 				TEST_TARGET_NAME = AgentDeviceRunner;
 			};
 			name = Debug;
@@ -422,12 +428,14 @@
 		20EA2EEF2F2CFC7C001CF0EF /* Release */ = {
 			isa = XCBuildConfiguration;
 			buildSettings = {
-				CODE_SIGN_STYLE = Automatic;
-				CURRENT_PROJECT_VERSION = 1;
-				DEVELOPMENT_TEAM = 2S799L9W4M;
-				GENERATE_INFOPLIST_FILE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 15.6;
-				MARKETING_VERSION = 1.0;
+					"CODE_SIGN_ENTITLEMENTS[sdk=macosx*]" = AgentDeviceRunnerUITests/AgentDeviceRunnerUITests.entitlements;
+					CODE_SIGN_STYLE = Automatic;
+					CURRENT_PROJECT_VERSION = 1;
+					DEVELOPMENT_TEAM = 2S799L9W4M;
+					GENERATE_INFOPLIST_FILE = YES;
+					IPHONEOS_DEPLOYMENT_TARGET = 15.6;
+					MACOSX_DEPLOYMENT_TARGET = 13.0;
+					MARKETING_VERSION = 1.0;
 				PRODUCT_BUNDLE_IDENTIFIER = "$(AGENT_DEVICE_IOS_RUNNER_TEST_BUNDLE_ID)";
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				STRING_CATALOG_GENERATE_SYMBOLS = NO;
@@ -436,9 +444,9 @@
 				SWIFT_OBJC_BRIDGING_HEADER = "AgentDeviceRunnerUITests/AgentDeviceRunnerUITests-Bridging-Header.h";
 				SWIFT_UPCOMING_FEATURE_MEMBER_IMPORT_VISIBILITY = YES;
 				SWIFT_VERSION = 5.0;
-				SUPPORTED_PLATFORMS = "iphoneos iphonesimulator appletvos appletvsimulator";
-				TARGETED_DEVICE_FAMILY = "1,2,3";
-				TVOS_DEPLOYMENT_TARGET = 15.6;
+					SUPPORTED_PLATFORMS = "macosx iphoneos iphonesimulator appletvos appletvsimulator";
+					TARGETED_DEVICE_FAMILY = "1,2,3";
+					TVOS_DEPLOYMENT_TARGET = 15.6;
 				TEST_TARGET_NAME = AgentDeviceRunner;
 			};
 			name = Release;

package/ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/AgentDeviceRunnerUITests.entitlements

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "https://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.network.client</key>
+  <true/>
+  <key>com.apple.security.network.server</key>
+  <true/>
+</dict>
+</plist>

package/ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift

@@ -217,6 +217,16 @@ extension RunnerTests {
         return Response(ok: true, data: DataPayload(message: "tapped"))
       }
       return Response(ok: false, error: ErrorPayload(message: "tap requires text or x/y"))
+    case .mouseClick:
+      guard let x = command.x, let y = command.y else {
+        return Response(ok: false, error: ErrorPayload(message: "mouseClick requires x and y"))
+      }
+      do {
+        try mouseClickAt(app: activeApp, x: x, y: y, button: command.button ?? "primary")
+        return Response(ok: true, data: DataPayload(message: "clicked"))
+      } catch {
+        return Response(ok: false, error: ErrorPayload(message: error.localizedDescription))
+      }
     case .tapSeries:
       guard let x = command.x, let y = command.y else {
         return Response(ok: false, error: ErrorPayload(message: "tapSeries requires x and y"))
@@ -328,7 +338,7 @@ extension RunnerTests {
         Thread.sleep(forTimeInterval: 0.5)
       }
       let screenshot = XCUIScreen.main.screenshot()
-      guard let pngData = screenshot.image.pngData() else {
+      guard let pngData = runnerPngData(for: screenshot.image) else {
         return Response(ok: false, error: ErrorPayload(message: "Failed to encode screenshot as PNG"))
       }
       let fileName = "screenshot-\(Int(Date().timeIntervalSince1970 * 1000)).png"
@@ -338,21 +348,40 @@ extension RunnerTests {
       } catch {
         return Response(ok: false, error: ErrorPayload(message: "Failed to write screenshot: \(error.localizedDescription)"))
       }
+#if os(macOS)
+      return Response(ok: true, data: DataPayload(message: filePath))
+#else
       // Return path relative to app container root (tmp/ maps to NSTemporaryDirectory)
       return Response(ok: true, data: DataPayload(message: "tmp/\(fileName)"))
+#endif
     case .back:
       if tapNavigationBack(app: activeApp) {
         return Response(ok: true, data: DataPayload(message: "back"))
       }
+#if os(macOS)
+      return Response(ok: false, error: ErrorPayload(message: "back button is not available on macOS"))
+#else
       performBackGesture(app: activeApp)
       return Response(ok: true, data: DataPayload(message: "back"))
+#endif
     case .home:
+#if os(macOS)
+      return Response(ok: false, error: ErrorPayload(message: "home is not supported on macOS"))
+#else
       pressHomeButton()
       return Response(ok: true, data: DataPayload(message: "home"))
+#endif
     case .appSwitcher:
+#if os(macOS)
+      return Response(ok: false, error: ErrorPayload(message: "appSwitcher is not supported on macOS"))
+#else
       performAppSwitcherGesture(app: activeApp)
       return Response(ok: true, data: DataPayload(message: "appSwitcher"))
+#endif
     case .alert:
+#if os(macOS)
+      return Response(ok: false, error: ErrorPayload(message: "alert is not supported on macOS"))
+#else
       let action = (command.action ?? "get").lowercased()
       let alert = activeApp.alerts.firstMatch
       if !alert.exists {
@@ -370,12 +399,17 @@ extension RunnerTests {
       }
       let buttonLabels = alert.buttons.allElementsBoundByIndex.map { $0.label }
       return Response(ok: true, data: DataPayload(message: alert.label, items: buttonLabels))
+#endif
     case .pinch:
+#if os(macOS)
+      return Response(ok: false, error: ErrorPayload(message: "pinch is not supported on macOS"))
+#else
       guard let scale = command.scale, scale > 0 else {
         return Response(ok: false, error: ErrorPayload(message: "pinch requires scale > 0"))
       }
       pinch(app: activeApp, scale: scale, x: command.x, y: command.y)
       return Response(ok: true, data: DataPayload(message: "pinched"))
+#endif
     }
   }
 }