preflite 1.0.1

package/dist/domain/task/TaskRecord.js

@@ -0,0 +1,14 @@
+export class TaskRecord {
+    id;
+    spec;
+    status;
+    sessionId;
+    message;
+    constructor(id, spec, status, sessionId, message) {
+        this.id = id;
+        this.spec = spec;
+        this.status = status;
+        this.sessionId = sessionId;
+        this.message = message;
+    }
+}

package/dist/domain/task/TaskSpec.js

@@ -0,0 +1,12 @@
+export class TaskSpec {
+    requiredPlatform;
+    script;
+    scriptKind;
+    airtest;
+    constructor(requiredPlatform, script, scriptKind = "midscene", airtest) {
+        this.requiredPlatform = requiredPlatform;
+        this.script = script;
+        this.scriptKind = scriptKind;
+        this.airtest = airtest;
+    }
+}

package/dist/infrastructure/adapters/AdapterRegistry.js

@@ -0,0 +1,10 @@
+export class AdapterRegistry {
+    resourceAdapters;
+    commandExecutor;
+    snapshotProvider;
+    constructor(resourceAdapters, commandExecutor, snapshotProvider) {
+        this.resourceAdapters = resourceAdapters;
+        this.commandExecutor = commandExecutor;
+        this.snapshotProvider = snapshotProvider;
+    }
+}

package/dist/infrastructure/adapters/BridgeAdapters.js

@@ -0,0 +1,6 @@
+export class BridgeAdapters {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+}

package/dist/infrastructure/adapters/android/AndroidResourceAdapter.js

@@ -0,0 +1,51 @@
+import { DeviceResource } from "../../../domain/resource/DeviceResource.js";
+import { PlatformType, ResourceStatus } from "../../../shared-kernel/enums/index.js";
+import { asResourceId } from "../../../shared-kernel/ids/index.js";
+import { probeAndroidDeviceDetails } from "../deviceDetailsProbe.js";
+export function parseAndroidDevices(stdout) {
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.startsWith("List of devices attached"))
+        .map((line) => {
+        const [serial, state] = line.split(/\s+/);
+        return { serial: serial ?? "", state: state ?? "" };
+    })
+        .filter((row) => row.serial.length > 0);
+}
+function toAndroidResourceId(serial) {
+    return `android:${serial}`;
+}
+export class AndroidResourceAdapter {
+    commandRunner;
+    discoveryCommand;
+    adbServerHost;
+    adbServerPort;
+    constructor(commandRunner, discoveryCommand, adbServerHost, adbServerPort) {
+        this.commandRunner = commandRunner;
+        this.discoveryCommand = discoveryCommand;
+        this.adbServerHost = adbServerHost;
+        this.adbServerPort = adbServerPort;
+    }
+    adapterName() {
+        return "AndroidResourceAdapter";
+    }
+    async discover() {
+        const result = await this.commandRunner.run(this.discoveryCommand, 15_000);
+        if (!result.ok)
+            return [];
+        const targets = parseAndroidDevices(result.stdout).filter((item) => item.state === "device");
+        const rows = await Promise.all(targets.map(async (target) => {
+            const deviceDetails = await probeAndroidDeviceDetails(this.commandRunner, target.serial, 12_000, {
+                host: this.adbServerHost,
+                port: this.adbServerPort,
+            });
+            return new DeviceResource(asResourceId(toAndroidResourceId(target.serial)), PlatformType.ANDROID, ResourceStatus.ONLINE, {
+                platform: PlatformType.ANDROID,
+                supportsDebug: true,
+                labels: ["real", "android", target.serial],
+            }, deviceDetails);
+        }));
+        return rows;
+    }
+}

package/dist/infrastructure/adapters/deviceDetailsProbe.js

@@ -0,0 +1,229 @@
+import { compactDeviceDetails } from "../../domain/resource/DeviceDetails.js";
+export function shSingleQuote(value) {
+    return `'${value.replace(/'/g, `'\"'\"'`)}'`;
+}
+/** 供 hdc 探测子命令与会话参数一致（可执行路径含空格时加引号） */
+export function buildHarmonyHdcShellPrefix(hdcPath, hdcHost, hdcPort) {
+    const trimmedPath = hdcPath?.trim();
+    const rawExe = trimmedPath || "hdc";
+    const exe = /[^\w@%+=:,./-]/.test(rawExe) || rawExe.includes(" ")
+        ? `"${rawExe.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`
+        : rawExe;
+    const host = hdcHost?.trim();
+    if (host && hdcPort != null && Number.isFinite(hdcPort) && hdcPort > 0) {
+        return `${exe} -s ${host}:${Math.floor(hdcPort)}`;
+    }
+    return exe;
+}
+/**
+ * 解析 `adb shell` 多行 getprop 输出。
+ * - 7 行：manufacturer, brand, model, device, release, sdk, fingerprint（与 ANDROID_PROP_SHELL 一致）
+ * - 4 行：兼容旧版 manufacturer, model, release, sdk
+ */
+export function parseAndroidGetpropBlock(stdout) {
+    const lines = stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    let manufacturer;
+    let brand;
+    let model;
+    let deviceCodename;
+    let release;
+    let sdk;
+    let fingerprint;
+    if (lines.length >= 7) {
+        manufacturer = lines[0];
+        brand = lines[1];
+        model = lines[2];
+        deviceCodename = lines[3];
+        release = lines[4];
+        sdk = lines[5];
+        fingerprint = lines[6];
+    }
+    else if (lines.length >= 4) {
+        manufacturer = lines[0];
+        model = lines[1];
+        release = lines[2];
+        sdk = lines[3];
+    }
+    else {
+        return {};
+    }
+    const parts = [];
+    if (release)
+        parts.push(release);
+    if (sdk && /^\d+$/.test(sdk))
+        parts.push(`API ${sdk}`);
+    const osVersion = parts.length ? parts.join(" · ") : undefined;
+    return {
+        manufacturer: manufacturer || undefined,
+        brand: brand || undefined,
+        model: model || undefined,
+        deviceCodename: deviceCodename || undefined,
+        osVersion,
+        buildFingerprint: fingerprint || undefined,
+    };
+}
+/** 与 MIDSCENE_ANDROID_ADB_HOST / MIDSCENE_ANDROID_ADB_PORT 对齐；非本机默认 daemon 时加 `-H` `-P`。 */
+export function buildAndroidAdbCliPrefix(adbHost, adbPort) {
+    const host = (adbHost ?? "").trim() || "127.0.0.1";
+    const p = adbPort != null && Number.isFinite(adbPort) && adbPort > 0 ? Math.floor(adbPort) : 5037;
+    if ((host === "127.0.0.1" || host === "localhost") && p === 5037) {
+        return "adb";
+    }
+    const safeHost = /[\s'"\\]/.test(host) ? shSingleQuote(host) : host;
+    return `adb -H ${safeHost} -P ${p}`;
+}
+export function parseBatteryLevelFromDumpsys(stdout) {
+    const m = stdout.match(/^\s*level:\s*(\d+)\s*$/im);
+    if (m?.[1]) {
+        const n = Number(m[1]);
+        if (Number.isFinite(n) && n >= 0 && n <= 100)
+            return n;
+    }
+    return null;
+}
+export function parseHarmonyBatteryCapacity(stdout) {
+    const m = stdout.match(/^\s*capacity:\s*(\d+)\s*$/im);
+    if (!m?.[1])
+        return null;
+    const n = Number(m[1]);
+    if (Number.isFinite(n) && n >= 0 && n <= 100)
+        return n;
+    return null;
+}
+const ANDROID_PROP_SHELL = "getprop ro.product.manufacturer; getprop ro.product.brand; getprop ro.product.model; getprop ro.product.device; getprop ro.build.version.release; getprop ro.build.version.sdk; getprop ro.build.fingerprint";
+/** Android / Harmony：系统设置中的本机名称（优先 global device_name，否则 secure bluetooth_name）。 */
+const SHELL_USER_DEVICE_NAME = 'n=$(settings get global device_name); case "$n" in ""|null|NULL) settings get secure bluetooth_name;; *) printf %s "$n";; esac';
+const HARMONY_PARAM_SHELL = "param get const.product.manufacturer; param get const.product.brand; param get const.product.name; param get const.product.model; param get const.build.product; param get const.product.os.dist.name; param get const.product.os.dist.version; param get const.product.os.dist.apiversion; param get const.product.software.version";
+/** 解析 `settings get` 类单行输出，忽略 null/空。 */
+export function normalizeShellSettingsDeviceName(stdout) {
+    const line = stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .find((l) => l.length > 0);
+    if (!line || /^null$/i.test(line) || line === "N/A")
+        return undefined;
+    return line;
+}
+export function parseHarmonyParamBlock(stdout) {
+    const lines = stdout.split("\n").map((l) => l.trim().replace(/^"(.*)"$/, "$1"));
+    const [manufacturer, brand, productName, model, deviceCodename, osName, osDistVersion, osDistApiVersion, softwareVersion] = lines;
+    const osParts = [];
+    if (osDistVersion)
+        osParts.push(osDistVersion);
+    if (osDistApiVersion && /^\d+$/.test(osDistApiVersion))
+        osParts.push(`API ${osDistApiVersion}`);
+    return {
+        manufacturer: manufacturer || undefined,
+        brand: brand || undefined,
+        deviceName: productName || undefined,
+        model: model || undefined,
+        deviceCodename: deviceCodename || undefined,
+        osName: osName || undefined,
+        osVersion: osParts.length ? osParts.join(" · ") : undefined,
+        buildFingerprint: softwareVersion || undefined,
+    };
+}
+export async function probeAndroidDeviceDetails(runner, serial, timeoutMs = 12_000, adbServer) {
+    const adbCli = buildAndroidAdbCliPrefix(adbServer?.host, adbServer?.port);
+    const sq = shSingleQuote(serial);
+    const propsCmd = `${adbCli} -s ${sq} shell ${JSON.stringify(ANDROID_PROP_SHELL)}`;
+    const batCmd = `${adbCli} -s ${sq} shell dumpsys battery 2>/dev/null | head -n 40`;
+    const nameCmd = `${adbCli} -s ${sq} shell ${JSON.stringify(SHELL_USER_DEVICE_NAME)}`;
+    const [propsRes, batRes, nameRes] = await Promise.all([
+        runner.run(propsCmd, timeoutMs),
+        runner.run(batCmd, timeoutMs),
+        runner.run(nameCmd, timeoutMs),
+    ]);
+    if (!propsRes.ok && !batRes.ok)
+        return undefined;
+    const base = { osName: "Android" };
+    if (propsRes.ok)
+        Object.assign(base, parseAndroidGetpropBlock(propsRes.stdout));
+    if (batRes.ok) {
+        const level = parseBatteryLevelFromDumpsys(batRes.stdout);
+        if (level != null)
+            base.batteryPercent = level;
+    }
+    if (nameRes.ok) {
+        const deviceName = normalizeShellSettingsDeviceName(nameRes.stdout);
+        if (deviceName)
+            base.deviceName = deviceName;
+    }
+    return compactDeviceDetails(base);
+}
+const IOS_VERSION_IN_NAME = /\((\d{1,2}\.\d+(?:\.\d+)?)\)\s*$/;
+/**
+ * 仅从 xctrace 展示名解析 iOS 版本（型号须用 ideviceinfo -k ProductType，勿把用户设备名当型号）。
+ */
+export function buildIosDeviceDetailsFromDisplayName(displayName) {
+    const name = displayName.trim();
+    const m = IOS_VERSION_IN_NAME.exec(name);
+    const osVersion = m?.[1];
+    return compactDeviceDetails({
+        manufacturer: "Apple",
+        osName: "iOS",
+        osVersion: osVersion || undefined,
+    }) ?? { manufacturer: "Apple", osName: "iOS" };
+}
+/** 硬件型号标识，如 iPhone15,2 */
+export async function probeIosProductType(runner, udid, timeoutMs = 8_000) {
+    const sq = shSingleQuote(udid);
+    const cmd = `ideviceinfo -u ${sq} -k ProductType 2>/dev/null`;
+    const res = await runner.run(cmd, timeoutMs);
+    if (!res.ok)
+        return undefined;
+    const line = (res.stdout.trim().split(/\s+/)[0] ?? "").trim();
+    if (!line || line === "N/A")
+        return undefined;
+    return line;
+}
+export async function probeIosBatteryPercent(runner, udid, timeoutMs = 8_000) {
+    const sq = shSingleQuote(udid);
+    const cmd = `ideviceinfo -u ${sq} -q com.apple.mobile.battery -k BatteryCurrentCapacity 2>/dev/null`;
+    const res = await runner.run(cmd, timeoutMs);
+    if (!res.ok)
+        return null;
+    const raw = res.stdout.trim();
+    if (!raw)
+        return null;
+    const token = raw.split(/\s+/)[0] ?? "";
+    const n = Number(token);
+    if (!Number.isFinite(n))
+        return null;
+    return Math.max(0, Math.min(100, Math.round(n)));
+}
+/** iOS 设置中的设备名称（与 xctrace 列表展示名不同）。 */
+export async function probeIosDeviceName(runner, udid, timeoutMs = 8_000) {
+    const sq = shSingleQuote(udid);
+    const cmd = `ideviceinfo -u ${sq} -k DeviceName 2>/dev/null`;
+    const res = await runner.run(cmd, timeoutMs);
+    if (!res.ok)
+        return undefined;
+    const line = (res.stdout.trim().split(/\n/)[0] ?? "").trim();
+    if (!line || line === "N/A")
+        return undefined;
+    return line;
+}
+export async function probeHarmonyDeviceDetails(runner, hdcShellPrefix, target, timeoutMs = 12_000) {
+    const prefix = hdcShellPrefix.trim() || "hdc";
+    const tq = shSingleQuote(target);
+    const propsCmd = `${prefix} -t ${tq} shell ${JSON.stringify(HARMONY_PARAM_SHELL)}`;
+    const batCmd = `${prefix} -t ${tq} shell hidumper -s BatteryService -a -i`;
+    const [propsRes, batRes] = await Promise.all([
+        runner.run(propsCmd, timeoutMs),
+        runner.run(batCmd, timeoutMs),
+    ]);
+    if (!propsRes.ok)
+        return undefined;
+    const base = { osName: "HarmonyOS" };
+    Object.assign(base, parseHarmonyParamBlock(propsRes.stdout));
+    if (batRes.ok) {
+        const level = parseHarmonyBatteryCapacity(batRes.stdout);
+        if (level != null)
+            base.batteryPercent = level;
+    }
+    return compactDeviceDetails(base);
+}

package/dist/infrastructure/adapters/harmony/HarmonyResourceAdapter.js

@@ -0,0 +1,40 @@
+import { DeviceResource } from "../../../domain/resource/DeviceResource.js";
+import { PlatformType, ResourceStatus } from "../../../shared-kernel/enums/index.js";
+import { asResourceId } from "../../../shared-kernel/ids/index.js";
+import { probeHarmonyDeviceDetails } from "../deviceDetailsProbe.js";
+export function parseHarmonyTargets(stdout) {
+    return stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && !line.includes("[Empty]"));
+}
+function toHarmonyResourceId(target) {
+    return `harmony:${target}`;
+}
+export class HarmonyResourceAdapter {
+    commandRunner;
+    discoveryCommand;
+    hdcShellPrefix;
+    constructor(commandRunner, discoveryCommand, hdcShellPrefix = "hdc") {
+        this.commandRunner = commandRunner;
+        this.discoveryCommand = discoveryCommand;
+        this.hdcShellPrefix = hdcShellPrefix;
+    }
+    adapterName() {
+        return "HarmonyResourceAdapter";
+    }
+    async discover() {
+        const result = await this.commandRunner.run(this.discoveryCommand, 15_000);
+        if (!result.ok)
+            return [];
+        const targets = parseHarmonyTargets(result.stdout);
+        return Promise.all(targets.map(async (target) => {
+            const deviceDetails = await probeHarmonyDeviceDetails(this.commandRunner, this.hdcShellPrefix, target);
+            return new DeviceResource(asResourceId(toHarmonyResourceId(target)), PlatformType.HARMONY, ResourceStatus.ONLINE, {
+                platform: PlatformType.HARMONY,
+                supportsDebug: true,
+                labels: ["real", "harmony", target],
+            }, deviceDetails);
+        }));
+    }
+}

package/dist/infrastructure/adapters/ios/IOSResourceAdapter.js

@@ -0,0 +1,182 @@
+import { compactDeviceDetails } from "../../../domain/resource/DeviceDetails.js";
+import { DeviceResource } from "../../../domain/resource/DeviceResource.js";
+import { PlatformType, ResourceStatus } from "../../../shared-kernel/enums/index.js";
+import { asResourceId } from "../../../shared-kernel/ids/index.js";
+import { buildIosDeviceDetailsFromDisplayName, probeIosBatteryPercent, probeIosDeviceName, probeIosProductType, } from "../deviceDetailsProbe.js";
+const DEVICE_LINE_PATTERN = /(.*)\(([-A-Za-z0-9]+)\)\s*$/;
+const IOS_DEVICE_NAME_HINTS = ["iphone", "ipad", "ipod"];
+const NON_IOS_HOST_HINTS = [
+    "macbook",
+    "mac mini",
+    "imac",
+    "mac studio",
+    "mac pro",
+    "my mac",
+];
+/** xctrace 真机常见展示：`别名 (16.7.8) (udid)`，与主机 `名称 (UUID)` 区分 */
+const XCTRACE_IOS_VERSION_IN_DISPLAY_NAME = /\(\d{1,2}\.\d+(?:\.\d+)?\)/;
+/** 匹配 simctl 设备行：`    iPhone 15 Pro (UUID) (Booted)` */
+const SIMCTL_DEVICE_LINE = /^\s+(.+?)\s+\(([0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12})\)\s+\((\w+)\)\s*$/;
+/** 匹配 simctl Section Header：`-- iOS 17.4 --` 或 `-- iOS 17.4 (21F90) --` */
+const SIMCTL_SECTION_HEADER = /^--\s+(.+?)\s+--$/;
+function isLegacy40CharHexUdid(udid) {
+    return /^[0-9a-f]{40}$/i.test(udid.trim());
+}
+/** 如 `00008110-001C11111111111E`（8-4-12），与标准五段主机 UUID 区分 */
+function isAppleMobileUdidThreeSegment(udid) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(udid.trim());
+}
+/** Instruments 列表里本机常为 RFC4122 五段式 */
+function isStandardFivePartUuid(udid) {
+    return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(udid.trim());
+}
+/**
+ * 判断 `xcrun xctrace list devices` 的「== Devices ==」行是否为已连接的真机。
+ * 不能仅靠名称里的 iphone/ipad：用户自定义设备名时仍会带系统版本号括号或 40 位 hex UDID。
+ */
+function isLikelyPhysicalIosDevice(name, udid) {
+    const normalized = name.trim().toLowerCase();
+    const id = udid.trim();
+    if (!normalized || !id)
+        return false;
+    if (normalized.includes("simulator"))
+        return false;
+    if (NON_IOS_HOST_HINTS.some((hint) => normalized.includes(hint)))
+        return false;
+    if (IOS_DEVICE_NAME_HINTS.some((hint) => normalized.includes(hint)))
+        return true;
+    if (isLegacy40CharHexUdid(id))
+        return true;
+    if (isAppleMobileUdidThreeSegment(id))
+        return true;
+    if (XCTRACE_IOS_VERSION_IN_DISPLAY_NAME.test(name))
+        return true;
+    if (isStandardFivePartUuid(id))
+        return false;
+    return false;
+}
+function extractOnlineDeviceLines(stdout) {
+    const lines = stdout.split("\n").map((line) => line.trim());
+    const headingIndexes = lines
+        .map((line, index) => ({ line, index }))
+        .filter((item) => item.line.startsWith("== ") && item.line.endsWith(" =="));
+    const devicesHeading = headingIndexes.find((item) => item.line === "== Devices ==");
+    // Fallback: unknown format, keep previous permissive behavior.
+    if (!devicesHeading) {
+        return lines.filter((line) => line.length > 0);
+    }
+    const nextHeading = headingIndexes.find((item) => item.index > devicesHeading.index);
+    const end = nextHeading ? nextHeading.index : lines.length;
+    return lines.slice(devicesHeading.index + 1, end).filter((line) => line.length > 0);
+}
+export function parseIOSDevices(stdout) {
+    return extractOnlineDeviceLines(stdout)
+        .map((line) => {
+        const match = DEVICE_LINE_PATTERN.exec(line);
+        if (!match)
+            return null;
+        const name = match[1]?.trim() ?? "";
+        const udid = match[2]?.trim() ?? "";
+        if (!isLikelyPhysicalIosDevice(name, udid))
+            return null;
+        return { name, udid };
+    })
+        .filter((item) => item !== null && item.udid.length > 0);
+}
+function toIOSResourceId(udid) {
+    return `ios:${udid}`;
+}
+export function parseBootedSimulators(stdout) {
+    const lines = stdout.split("\n");
+    const result = [];
+    let currentRuntime = null;
+    for (const line of lines) {
+        const headerMatch = line.match(SIMCTL_SECTION_HEADER);
+        if (headerMatch) {
+            currentRuntime = headerMatch[1].trim();
+            continue;
+        }
+        const deviceMatch = line.match(SIMCTL_DEVICE_LINE);
+        if (deviceMatch && currentRuntime && deviceMatch[3] === "Booted") {
+            result.push({
+                name: deviceMatch[1].trim(),
+                udid: deviceMatch[2],
+                runtime: currentRuntime,
+            });
+        }
+    }
+    return result;
+}
+function osNameFromRuntime(runtime) {
+    const lower = runtime.toLowerCase();
+    if (lower.startsWith("tvos"))
+        return "tvOS";
+    if (lower.startsWith("watchos"))
+        return "watchOS";
+    if (lower.startsWith("visionos"))
+        return "visionOS";
+    return "iOS";
+}
+function osVersionFromRuntime(runtime) {
+    const m = runtime.match(/(\d[\d.]*)/);
+    return m ? m[1] : undefined;
+}
+export class IOSResourceAdapter {
+    commandRunner;
+    discoveryCommand;
+    constructor(commandRunner, discoveryCommand) {
+        this.commandRunner = commandRunner;
+        this.discoveryCommand = discoveryCommand;
+    }
+    adapterName() {
+        return "IOSResourceAdapter";
+    }
+    async discover() {
+        const [xctraceResult, simctlResult] = await Promise.all([
+            this.commandRunner.run(this.discoveryCommand, 15_000),
+            this.commandRunner.run("xcrun simctl list devices booted", 10_000),
+        ]);
+        const resources = [];
+        // 1) Real iOS devices via xctrace
+        if (xctraceResult.ok) {
+            const targets = parseIOSDevices(xctraceResult.stdout);
+            const realDevices = await Promise.all(targets.map(async (target) => {
+                const base = buildIosDeviceDetailsFromDisplayName(target.name);
+                const [productType, batteryPercent, deviceName] = await Promise.all([
+                    probeIosProductType(this.commandRunner, target.udid),
+                    probeIosBatteryPercent(this.commandRunner, target.udid),
+                    probeIosDeviceName(this.commandRunner, target.udid),
+                ]);
+                const merged = compactDeviceDetails({
+                    ...base,
+                    ...(productType ? { model: productType } : {}),
+                    ...(batteryPercent != null ? { batteryPercent } : {}),
+                    ...(deviceName ? { deviceName } : {}),
+                });
+                return new DeviceResource(asResourceId(toIOSResourceId(target.udid)), PlatformType.IOS, ResourceStatus.ONLINE, {
+                    platform: PlatformType.IOS,
+                    supportsDebug: true,
+                    labels: ["real", "ios", target.name],
+                }, merged);
+            }));
+            resources.push(...realDevices);
+        }
+        // 2) Booted simulators via simctl
+        if (simctlResult.ok) {
+            const simTargets = parseBootedSimulators(simctlResult.stdout);
+            for (const target of simTargets) {
+                resources.push(new DeviceResource(asResourceId(toIOSResourceId(target.udid)), PlatformType.IOS, ResourceStatus.ONLINE, {
+                    platform: PlatformType.IOS,
+                    supportsDebug: true,
+                    labels: ["simulator", "ios", target.name],
+                }, compactDeviceDetails({
+                    manufacturer: "Apple",
+                    osName: osNameFromRuntime(target.runtime),
+                    osVersion: osVersionFromRuntime(target.runtime),
+                    model: target.name,
+                })));
+            }
+        }
+        return resources;
+    }
+}

package/dist/infrastructure/adapters/real/ShellCommandAndSnapshot.js

@@ -0,0 +1,41 @@
+function renderTemplate(template, resourceId, command) {
+    return template
+        .replaceAll("{resourceId}", resourceId)
+        .replaceAll("{command}", command ?? "");
+}
+export class ShellCommandExecutor {
+    commandRunner;
+    commandTemplate;
+    constructor(commandRunner, commandTemplate) {
+        this.commandRunner = commandRunner;
+        this.commandTemplate = commandTemplate;
+    }
+    async execute(resourceId, command) {
+        const shellCommand = renderTemplate(this.commandTemplate, resourceId, command);
+        const result = await this.commandRunner.run(shellCommand, 30_000);
+        if (!result.ok) {
+            throw new Error(`debug command failed: ${result.stderr || result.stdout}`);
+        }
+        return { output: result.stdout.trim() || "ok" };
+    }
+}
+export class ShellSnapshotProvider {
+    commandRunner;
+    snapshotTemplate;
+    constructor(commandRunner, snapshotTemplate) {
+        this.commandRunner = commandRunner;
+        this.snapshotTemplate = snapshotTemplate;
+    }
+    async snapshot(resourceId) {
+        const shellCommand = renderTemplate(this.snapshotTemplate, resourceId);
+        const result = await this.commandRunner.run(shellCommand, 30_000);
+        if (!result.ok) {
+            throw new Error(`snapshot failed: ${result.stderr || result.stdout}`);
+        }
+        const uri = result.stdout.trim();
+        if (!uri) {
+            throw new Error("snapshot command returned empty uri");
+        }
+        return { uri };
+    }
+}