feat: add HarmonyOS platform support

.gitignore

@@ -36,3 +36,4 @@ android-snapshot-helper/build/
 android-snapshot-helper/dist/
 android-multitouch-helper/build/
 android-multitouch-helper/dist/
+harmonyos-lab/

src/backend.ts

@@ -9,7 +9,7 @@ import type {
   SnapshotState,
 } from './utils/snapshot.ts';
 
-export type AgentDeviceBackendPlatform = 'ios' | 'android' | 'macos' | 'linux';
+export type AgentDeviceBackendPlatform = 'ios' | 'android' | 'macos' | 'harmonyos' | 'linux';
 
 export const BACKEND_CAPABILITY_NAMES = [
   'android.shell',

src/client-normalizers.ts

@@ -142,7 +142,7 @@ function buildClientDevicePlatformFields(
   platform: AgentDeviceDevice['platform'],
   id: string,
   simulatorSetPath?: string | null,
-): Pick<AgentDeviceSessionDevice, 'ios' | 'android'> {
+): Pick<AgentDeviceSessionDevice, 'ios' | 'android' | 'harmonyos'> {
   return {
     ios:
       platform === 'ios'
@@ -152,6 +152,7 @@ function buildClientDevicePlatformFields(
           }
         : undefined,
     android: platform === 'android' ? { serial: id } : undefined,
+    harmonyos: platform === 'harmonyos' ? { serial: id } : undefined,
   };
 }
 
@@ -181,6 +182,7 @@ export function normalizeOpenDevice(
     (platform !== 'ios' &&
       platform !== 'macos' &&
       platform !== 'android' &&
+      platform !== 'harmonyos' &&
       platform !== 'linux') ||
     !id ||
     !name
@@ -204,6 +206,10 @@ export function normalizeOpenDevice(
         : undefined,
     android:
       platform === 'android' ? { serial: readOptionalString(value, 'serial') ?? id } : undefined,
+    harmonyos:
+      platform === 'harmonyos'
+        ? { serial: readOptionalString(value, 'serial') ?? id }
+        : undefined,
   };
 }
 

src/client-shared.ts

@@ -36,7 +36,11 @@ export function buildDeviceIdentifiers(
   return {
     deviceId: id,
     deviceName: name,
-    ...(platform === 'android' ? { serial: id } : platform === 'ios' ? { udid: id } : {}),
+    ...(platform === 'android' || platform === 'harmonyos'
+      ? { serial: id }
+      : platform === 'ios'
+        ? { udid: id }
+        : {}),
   };
 }
 
@@ -56,9 +60,12 @@ function serializeSessionDevice(
           ios_simulator_device_set: device.ios?.simulatorSetPath ?? null,
         }
       : {}),
-    ...(device.platform === 'android' && includeAndroidSerial
+    ...((device.platform === 'android' || device.platform === 'harmonyos') && includeAndroidSerial
       ? {
-          serial: device.android?.serial ?? device.id,
+          serial:
+            device.platform === 'android'
+              ? device.android?.serial ?? device.id
+              : device.harmonyos?.serial ?? device.id,
         }
       : {}),
   };

src/client-types.ts

@@ -114,6 +114,9 @@ export type AgentDeviceDevice = {
   android?: {
     serial: string;
   };
+  harmonyos?: {
+    serial: string;
+  };
 };
 
 export type AgentDeviceSessionDevice = {
@@ -129,6 +132,9 @@ export type AgentDeviceSessionDevice = {
   android?: {
     serial: string;
   };
+  harmonyos?: {
+    serial: string;
+  };
 };
 
 export type AgentDeviceSession = {

src/commands/client-command-metadata.ts

@@ -149,7 +149,7 @@ export const clientCommandMetadata = [
   }),
   defineClientCommandMetadata('app-switcher', {}),
   defineClientCommandMetadata('keyboard', {
-    action: enumField(['status', 'dismiss']),
+    action: enumField(['status', 'dismiss', 'enter', 'return']),
   }),
   defineClientCommandMetadata('clipboard', {
     action: requiredField(enumField(CLIPBOARD_ACTION_VALUES)),

src/commands/client-output.ts

@@ -249,6 +249,11 @@ function formatAppState(data: AppStateCommandResult): string | null {
     if (data.activity) lines.push(`Activity: ${data.activity}`);
     return lines.join('\n');
   }
+  if (data.platform === 'harmonyos') {
+    const lines = [`Foreground app: ${data.bundleId ?? 'unknown'}`];
+    if (data.activity) lines.push(`Ability: ${data.activity}`);
+    return lines.join('\n');
+  }
   return null;
 }
 

src/commands/command-input.ts

@@ -7,7 +7,7 @@ import type {
 import type { DeviceTarget, PlatformSelector } from '../utils/device.ts';
 import type { JsonSchema } from './command-contract.ts';
 
-const PLATFORM_VALUES = ['ios', 'android', 'macos', 'linux', 'apple'] as const;
+const PLATFORM_VALUES = ['ios', 'android', 'macos', 'harmonyos', 'linux', 'apple'] as const;
 const DEVICE_TARGET_VALUES = ['mobile', 'tv', 'desktop'] as const;
 const INTERACTION_TARGET_KINDS = ['ref', 'selector', 'point'] as const;
 

src/compat/maestro/command-mapper.ts

@@ -154,7 +154,7 @@ function convertOpenLink(
 ): SessionAction {
   const rawLink = readOpenLink(value, name);
   const url = resolveMaestroString(rawLink, context);
-  if ((context.platform === 'ios' || context.platform === 'android') && config.appId) {
+  if ((context.platform === 'ios' || context.platform === 'android' || context.platform === 'harmonyos') && config.appId) {
     return action(
       'open',
       [resolveMaestroString(requireAppId(config, name), context), url],

src/compat/maestro/runtime-targets.ts

@@ -256,7 +256,9 @@ function filterReactNativeOverlayBlockedMatches(
 }
 
 export function readMaestroSelectorPlatform(flags: DaemonRequest['flags']): Platform {
-  return flags?.platform === 'android' ? 'android' : 'ios';
+  if (flags?.platform === 'android') return 'android';
+  if (flags?.platform === 'harmonyos') return 'harmonyos';
+  return 'ios';
 }
 
 export function extractMaestroVisibleTextQuery(selectorExpression: string): string | null {

src/contracts.ts

@@ -57,7 +57,7 @@ export type DaemonRequestMeta = {
   materializedPathRetentionMs?: number;
   materializationId?: string;
   lockPolicy?: DaemonLockPolicy;
-  lockPlatform?: 'ios' | 'macos' | 'android' | 'linux' | 'apple';
+  lockPlatform?: 'ios' | 'macos' | 'android' | 'harmonyos' | 'linux' | 'apple';
   requestProgress?: 'replay-test';
 };
 
@@ -395,7 +395,7 @@ export const daemonCommandRequestSchema = schema<DaemonRequest>((input, path) =>
             lockPlatform: optionalEnum(
               meta,
               'lockPlatform',
-              ['ios', 'macos', 'android', 'linux', 'apple'] as const,
+              ['ios', 'macos', 'android', 'harmonyos', 'linux', 'apple'] as const,
               `${path}.meta`,
             ),
           },