react-native-mcp-kit 4.0.0 → 4.2.0

package/dist/server/host/coredevice/xpc.js

@@ -0,0 +1,318 @@
+"use strict";
+// Encoder/decoder for Apple's binary XPC object format. RemoteXPC sends
+// these as the payload of an `XpcWrapper` inside HTTP/2 DATA frames.
+//
+// Wire layout reference: PROTOCOL.md. Integers are little-endian and
+// every variable-width field is zero-padded to a 4-byte boundary.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseXpcWrapper = exports.buildXpcWrapper = exports.XpcFlags = void 0;
+const TYPE_NULL = 0x00001000;
+const TYPE_BOOL = 0x00002000;
+const TYPE_INT64 = 0x00003000;
+const TYPE_UINT64 = 0x00004000;
+const TYPE_DOUBLE = 0x00005000;
+const TYPE_DATA = 0x00008000;
+const TYPE_STRING = 0x00009000;
+const TYPE_UUID = 0x0000a000;
+const TYPE_ARRAY = 0x0000e000;
+const TYPE_DICTIONARY = 0x0000f000;
+const XPC_WRAPPER_MAGIC = 0x29b00b92;
+const XPC_PAYLOAD_MAGIC = 0x42133742;
+const XPC_PAYLOAD_VERSION = 5;
+const pad4 = (n) => {
+    return (4 - (n % 4)) % 4;
+};
+class Reader {
+    buf;
+    offset = 0;
+    constructor(buf) {
+        this.buf = buf;
+    }
+    u32() {
+        const value = this.buf.readUInt32LE(this.offset);
+        this.offset += 4;
+        return value;
+    }
+    u64() {
+        const value = this.buf.readBigUInt64LE(this.offset);
+        this.offset += 8;
+        return value;
+    }
+    i64() {
+        const value = this.buf.readBigInt64LE(this.offset);
+        this.offset += 8;
+        return value;
+    }
+    f64() {
+        const value = this.buf.readDoubleLE(this.offset);
+        this.offset += 8;
+        return value;
+    }
+    bytes(n) {
+        const slice = this.buf.subarray(this.offset, this.offset + n);
+        this.offset += n;
+        return slice;
+    }
+    skipPadding(unpaddedSize) {
+        this.offset += pad4(unpaddedSize);
+    }
+    position() {
+        return this.offset;
+    }
+    readCString() {
+        let end = this.offset;
+        while (end < this.buf.length && this.buf[end] !== 0)
+            end++;
+        if (end >= this.buf.length) {
+            throw new Error(`Unterminated CString at offset ${this.offset}`);
+        }
+        const text = this.buf.subarray(this.offset, end).toString('utf8');
+        this.offset = end + 1;
+        return text;
+    }
+}
+class Writer {
+    chunks = [];
+    length = 0;
+    push(buf) {
+        this.chunks.push(buf);
+        this.length += buf.length;
+    }
+    u32(value) {
+        const b = Buffer.alloc(4);
+        b.writeUInt32LE(value, 0);
+        this.push(b);
+    }
+    u64(value) {
+        const b = Buffer.alloc(8);
+        b.writeBigUInt64LE(value, 0);
+        this.push(b);
+    }
+    i64(value) {
+        const b = Buffer.alloc(8);
+        b.writeBigInt64LE(value, 0);
+        this.push(b);
+    }
+    f64(value) {
+        const b = Buffer.alloc(8);
+        b.writeDoubleLE(value, 0);
+        this.push(b);
+    }
+    bytes(buf) {
+        this.push(buf);
+    }
+    pad() {
+        const padding = pad4(this.length);
+        if (padding)
+            this.push(Buffer.alloc(padding));
+    }
+    size() {
+        return this.length;
+    }
+    build() {
+        return Buffer.concat(this.chunks, this.length);
+    }
+}
+const decodeObject = (reader) => {
+    const type = reader.u32();
+    switch (type) {
+        case TYPE_NULL:
+            return null;
+        case TYPE_BOOL:
+            return reader.u32() !== 0;
+        case TYPE_INT64:
+            return reader.i64();
+        case TYPE_UINT64:
+            return reader.u64();
+        case TYPE_DOUBLE:
+            return reader.f64();
+        case TYPE_DATA: {
+            const len = reader.u32();
+            const data = Buffer.from(reader.bytes(len));
+            reader.skipPadding(len);
+            return data;
+        }
+        case TYPE_STRING: {
+            const lenIncludingNul = reader.u32();
+            const raw = reader.bytes(lenIncludingNul);
+            reader.skipPadding(lenIncludingNul);
+            let end = raw.length;
+            while (end > 0 && raw[end - 1] === 0)
+                end--;
+            return raw.subarray(0, end).toString('utf8');
+        }
+        case TYPE_UUID: {
+            const data = reader.bytes(16);
+            const hex = data.toString('hex');
+            return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+        }
+        case TYPE_ARRAY: {
+            reader.u32(); // body length
+            const count = reader.u32();
+            const items = [];
+            for (let i = 0; i < count; i++)
+                items.push(decodeObject(reader));
+            return items;
+        }
+        case TYPE_DICTIONARY: {
+            // Entry keys are AlignedString (NUL-terminated UTF-8 padded to 4),
+            // values are XpcObjects. Don't confuse the key encoding with
+            // XpcString (length-prefixed) — they look similar but are not.
+            reader.u32(); // body length
+            const count = reader.u32();
+            const out = {};
+            for (let i = 0; i < count; i++) {
+                const start = reader.position();
+                const key = reader.readCString();
+                reader.skipPadding(reader.position() - start);
+                out[key] = decodeObject(reader);
+            }
+            return out;
+        }
+        default:
+            throw new Error(`Unknown XPC type tag 0x${type.toString(16)}`);
+    }
+};
+const encodeObject = (writer, value) => {
+    if (value === null) {
+        writer.u32(TYPE_NULL);
+        return;
+    }
+    if (typeof value === 'boolean') {
+        writer.u32(TYPE_BOOL);
+        writer.u32(value ? 1 : 0);
+        return;
+    }
+    if (typeof value === 'bigint') {
+        writer.u32(value < 0n ? TYPE_INT64 : TYPE_UINT64);
+        if (value < 0n)
+            writer.i64(value);
+        else
+            writer.u64(value);
+        return;
+    }
+    if (typeof value === 'number') {
+        writer.u32(TYPE_DOUBLE);
+        writer.f64(value);
+        return;
+    }
+    if (typeof value === 'string') {
+        writer.u32(TYPE_STRING);
+        const utf8 = Buffer.from(value, 'utf8');
+        writer.u32(utf8.length + 1);
+        writer.bytes(utf8);
+        writer.bytes(Buffer.from([0]));
+        writer.pad();
+        return;
+    }
+    if (Buffer.isBuffer(value)) {
+        writer.u32(TYPE_DATA);
+        writer.u32(value.length);
+        writer.bytes(value);
+        writer.pad();
+        return;
+    }
+    if (Array.isArray(value)) {
+        writer.u32(TYPE_ARRAY);
+        const body = new Writer();
+        body.u32(value.length);
+        for (const item of value)
+            encodeObject(body, item);
+        const bodyBuf = body.build();
+        writer.u32(bodyBuf.length);
+        writer.bytes(bodyBuf);
+        return;
+    }
+    if (typeof value === 'object') {
+        writer.u32(TYPE_DICTIONARY);
+        const entries = Object.entries(value);
+        const body = new Writer();
+        body.u32(entries.length);
+        for (const [key, val] of entries) {
+            const keyUtf8 = Buffer.from(key, 'utf8');
+            body.bytes(keyUtf8);
+            body.bytes(Buffer.from([0]));
+            const padding = pad4(keyUtf8.length + 1);
+            if (padding)
+                body.bytes(Buffer.alloc(padding));
+            encodeObject(body, val);
+        }
+        const bodyBuf = body.build();
+        writer.u32(bodyBuf.length);
+        writer.bytes(bodyBuf);
+        return;
+    }
+    throw new Error(`Cannot encode XPC value of type ${typeof value}`);
+};
+const encodeXpcObject = (value) => {
+    const writer = new Writer();
+    encodeObject(writer, value);
+    return writer.build();
+};
+const decodeXpcObject = (buf) => {
+    return decodeObject(new Reader(buf));
+};
+// XpcWrapper frames an XpcObject on the RemoteXPC wire. Layout
+// (little-endian throughout):
+//
+//   uint32 magic      = 0x29B00B92
+//   uint32 flags
+//   uint64 messageLen   on-wire value = inner_size - 8
+//   uint64 messageId
+//   if payload present:
+//     uint32 payloadMagic   = 0x42133742
+//     uint32 protocolVersion = 5
+//     XpcObject
+exports.XpcFlags = {
+    ALWAYS_SET: 0x00000001,
+    DATA_PRESENT: 0x00000100,
+    INIT_HANDSHAKE: 0x00400000,
+    PING: 0x00000002,
+    REPLY: 0x00020000,
+    WANTING_REPLY: 0x00010000,
+};
+const buildXpcWrapper = (flags, messageId, payload) => {
+    const writer = new Writer();
+    writer.u32(XPC_WRAPPER_MAGIC);
+    writer.u32(flags);
+    writer.bytes(Buffer.alloc(8)); // messageLen placeholder, patched below
+    const innerStart = writer.size();
+    writer.u64(messageId);
+    if (payload !== null) {
+        writer.u32(XPC_PAYLOAD_MAGIC);
+        writer.u32(XPC_PAYLOAD_VERSION);
+        writer.bytes(encodeXpcObject(payload));
+    }
+    const built = writer.build();
+    built.writeBigUInt64LE(BigInt(built.length - innerStart - 8), 8);
+    return built;
+};
+exports.buildXpcWrapper = buildXpcWrapper;
+const parseXpcWrapper = (buf, offset = 0) => {
+    const reader = new Reader(buf.subarray(offset));
+    const magic = reader.u32();
+    if (magic !== XPC_WRAPPER_MAGIC) {
+        throw new Error(`Bad XpcWrapper magic 0x${magic.toString(16)} at offset ${offset}`);
+    }
+    const flags = reader.u32();
+    const innerLen = Number(reader.u64()) + 8;
+    const messageId = reader.u64();
+    const remaining = innerLen - 8;
+    let payload = null;
+    if (remaining >= 8) {
+        const payloadMagic = reader.u32();
+        if (payloadMagic !== XPC_PAYLOAD_MAGIC) {
+            throw new Error(`Bad payload magic 0x${payloadMagic.toString(16)}`);
+        }
+        reader.u32(); // protocolVersion
+        if (remaining > 8) {
+            payload = decodeXpcObject(Buffer.from(reader.bytes(remaining - 8)));
+        }
+    }
+    else if (remaining > 0) {
+        reader.bytes(remaining);
+    }
+    return { flags, messageId, payload, totalSize: 16 + innerLen };
+};
+exports.parseXpcWrapper = parseXpcWrapper;
+//# sourceMappingURL=xpc.js.map

package/dist/server/host/coredevice/xpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpc.js","sourceRoot":"","sources":["../../../../src/server/host/coredevice/xpc.ts"],"names":[],"mappings":"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"}

package/dist/server/host/deviceResolver.d.ts

@@ -6,12 +6,19 @@ export interface IosSimulator {
     state: string;
     udid: string;
 }
+export interface IosRealDevice {
+    coreDeviceIdentifier: string;
+    name: string;
+    pairingState: string;
+}
 export interface AndroidDevice {
     serial: string;
     state: string;
 }
+export type DeviceKind = 'real-device' | 'simulator';
 export interface ResolvedDevice {
     displayName: string;
+    kind: DeviceKind;
     nativeId: string;
     platform: 'android' | 'ios';
     bundleId?: string;
@@ -46,6 +53,7 @@ interface ResolveOptions {
 }
 export declare const clearDeviceCache: () => void;
 export declare const listIosSimulators: (runner: ProcessRunner) => Promise<IosSimulator[]>;
+export declare const listIosRealDevices: (runner: ProcessRunner) => Promise<IosRealDevice[]>;
 export declare const listAndroidDevices: (runner: ProcessRunner) => Promise<AndroidDevice[]>;
 export declare const resolveDevice: (ctx: HostContext, options: ResolveOptions, runner: ProcessRunner) => Promise<DeviceResolution>;
 export declare const enrichDevicesWithClientStatus: (bridge: Bridge, runner: ProcessRunner) => Promise<EnrichedDeviceList>;

package/dist/server/host/deviceResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deviceResolver.d.ts","sourceRoot":"","sources":["../../../src/server/host/deviceResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,qBAAqB,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,GAAG,EAAE,cAAc,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAOnG,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,eAAO,MAAM,gBAAgB,QAAO,IAGnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAkB,aAAa,KAAG,OAAO,CAAC,YAAY,EAAE,CAyBrF,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAkB,aAAa,KAAG,OAAO,CAAC,aAAa,EAAE,CAwBvF,CAAC;AA8VF,eAAO,MAAM,aAAa,QACnB,WAAW,WACP,cAAc,UACf,aAAa,KACpB,OAAO,CAAC,gBAAgB,CAuD1B,CAAC;AAEF,eAAO,MAAM,6BAA6B,WAChC,MAAM,UACN,aAAa,KACpB,OAAO,CAAC,kBAAkB,CAuH5B,CAAC"}
+{"version":3,"file":"deviceResolver.d.ts","sourceRoot":"","sources":["../../../src/server/host/deviceResolver.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,MAAM,EAAoB,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAK3C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,WAAW,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,qBAAqB,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,GAAG,EAAE,cAAc,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAOnG,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,gBAAgB,QAAO,IAInC,CAAC;AAiBF,eAAO,MAAM,iBAAiB,WAAkB,aAAa,KAAG,OAAO,CAAC,YAAY,EAAE,CAyBrF,CAAC;AAKF,eAAO,MAAM,kBAAkB,WAAkB,aAAa,KAAG,OAAO,CAAC,aAAa,EAAE,CA2CvF,CAAC;AAEF,eAAO,MAAM,kBAAkB,WAAkB,aAAa,KAAG,OAAO,CAAC,aAAa,EAAE,CAwBvF,CAAC;AA4WF,eAAO,MAAM,aAAa,QACnB,WAAW,WACP,cAAc,UACf,aAAa,KACpB,OAAO,CAAC,gBAAgB,CAuD1B,CAAC;AAEF,eAAO,MAAM,6BAA6B,WAChC,MAAM,UACN,aAAa,KACpB,OAAO,CAAC,kBAAkB,CAuH5B,CAAC"}

package/dist/server/host/deviceResolver.js

@@ -1,16 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enrichDevicesWithClientStatus = exports.resolveDevice = exports.listAndroidDevices = exports.listIosSimulators = exports.clearDeviceCache = void 0;
+exports.enrichDevicesWithClientStatus = exports.resolveDevice = exports.listAndroidDevices = exports.listIosRealDevices = exports.listIosSimulators = exports.clearDeviceCache = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
 const processRunner_1 = require("./processRunner");
 const CACHE_TTL_MS = 5_000;
 const LIST_TIMEOUT_MS = 5_000;
 let iosCache = null;
+let iosRealCache = null;
 let androidCache = null;
 const clearDeviceCache = () => {
     iosCache = null;
+    iosRealCache = null;
     androidCache = null;
 };
 exports.clearDeviceCache = clearDeviceCache;
+const XCRUN_MISSING_ERROR = 'xcrun not found. iOS host tools require Xcode command line tools (macOS only).';
+const ADB_MISSING_ERROR = 'adb not found. Android host tools require Android platform-tools on PATH.';
+// Map a thrown error to a user-facing DeviceResolution error. Handles the
+// common ProcessNotFoundError → "install the toolchain" message; everything
+// else gets wrapped as a context-prefixed message.
+const toDeviceError = (err, context, toolMissing) => {
+    if (err instanceof processRunner_1.ProcessNotFoundError) {
+        return { error: toolMissing, ok: false };
+    }
+    return { error: `${context}: ${err.message}`, ok: false };
+};
 const listIosSimulators = async (runner) => {
     if (iosCache && Date.now() - iosCache.timestamp < CACHE_TTL_MS) {
         return iosCache.result;
@@ -34,6 +52,45 @@ const listIosSimulators = async (runner) => {
     return out;
 };
 exports.listIosSimulators = listIosSimulators;
+// Paired physical iOS devices come from `xcrun devicectl` — simctl knows
+// nothing about them. The JSON output of `list devices` is the only stable
+// integration surface (its stdout has a human-readable header first).
+const listIosRealDevices = async (runner) => {
+    if (iosRealCache && Date.now() - iosRealCache.timestamp < CACHE_TTL_MS) {
+        return iosRealCache.result;
+    }
+    const tmpPath = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `rnmcp-devicectl-${(0, node_crypto_1.randomUUID)()}.json`);
+    try {
+        const proc = await runner('xcrun', ['devicectl', 'list', 'devices', '--json-output', tmpPath], {
+            timeoutMs: LIST_TIMEOUT_MS,
+        });
+        if (proc.exitCode !== 0) {
+            throw new Error(`xcrun devicectl list failed (exit ${proc.exitCode}): ${proc.stderr.toString('utf8').trim().slice(0, 500)}`);
+        }
+        const raw = (0, node_fs_1.readFileSync)(tmpPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        const devices = parsed.result?.devices ?? [];
+        const out = [];
+        for (const d of devices) {
+            if (d.hardwareProperties?.platform !== 'iOS')
+                continue;
+            const id = d.identifier;
+            const name = d.deviceProperties?.name;
+            const pairingState = d.connectionProperties?.pairingState;
+            if (typeof id === 'string' && typeof name === 'string' && typeof pairingState === 'string') {
+                out.push({ coreDeviceIdentifier: id, name, pairingState });
+            }
+        }
+        iosRealCache = { result: out, timestamp: Date.now() };
+        return out;
+    }
+    finally {
+        (0, promises_1.rm)(tmpPath, { force: true }).catch(() => {
+            // best-effort
+        });
+    }
+};
+exports.listIosRealDevices = listIosRealDevices;
 const listAndroidDevices = async (runner) => {
     if (androidCache && Date.now() - androidCache.timestamp < CACHE_TTL_MS) {
         return androidCache.result;
@@ -92,7 +149,60 @@ const matchAndroidDeviceByClient = (devices) => {
     });
     return online.length === 1 ? online[0] : null;
 };
+const matchIosRealDeviceByClient = (devices, client) => {
+    const paired = devices.filter((d) => {
+        return d.pairingState === 'paired';
+    });
+    if (paired.length === 0)
+        return null;
+    if (!client.label) {
+        return paired.length === 1 ? paired[0] : null;
+    }
+    const label = client.label;
+    const substring = paired.filter((d) => {
+        return d.name.includes(label) || label.includes(d.name);
+    });
+    if (substring.length === 1)
+        return substring[0];
+    return paired.length === 1 ? paired[0] : null;
+};
+const resolveIosRealClient = async (client, runner) => {
+    try {
+        const devices = await (0, exports.listIosRealDevices)(runner);
+        const matched = matchIosRealDeviceByClient(devices, client);
+        if (matched) {
+            return {
+                device: {
+                    bundleId: client.bundleId,
+                    displayName: matched.name,
+                    kind: 'real-device',
+                    nativeId: matched.coreDeviceIdentifier,
+                    platform: 'ios',
+                },
+                ok: true,
+            };
+        }
+        const pairedList = devices
+            .filter((d) => {
+            return d.pairingState === 'paired';
+        })
+            .map((d) => {
+            return `${d.name} (${d.coreDeviceIdentifier})`;
+        })
+            .join(', ');
+        return {
+            error: `Cannot resolve iOS client '${client.id}' to a paired real device. Label hint: "${client.label ?? '(none)'}". Paired devices: ${pairedList || '(none)'}.`,
+            ok: false,
+        };
+    }
+    catch (err) {
+        return toDeviceError(err, 'Failed to list iOS real devices', XCRUN_MISSING_ERROR);
+    }
+};
 const resolveIosClient = async (client, runner) => {
+    if (client.isSimulator === false) {
+        return resolveIosRealClient(client, runner);
+    }
     try {
         const sims = await (0, exports.listIosSimulators)(runner);
         const matched = matchIosSimByClient(sims, client);
@@ -101,6 +211,7 @@ const resolveIosClient = async (client, runner) => {
                 device: {
                     bundleId: client.bundleId,
                     displayName: matched.name,
+                    kind: 'simulator',
                     nativeId: matched.udid,
                     platform: 'ios',
                 },
@@ -121,16 +232,7 @@ const resolveIosClient = async (client, runner) => {
         };
     }
     catch (err) {
-        if (err instanceof processRunner_1.ProcessNotFoundError) {
-            return {
-                error: 'xcrun not found. iOS host tools require Xcode command line tools (macOS only).',
-                ok: false,
-            };
-        }
-        return {
-            error: `Failed to list iOS simulators: ${err.message}`,
-            ok: false,
-        };
+        return toDeviceError(err, 'Failed to list iOS simulators', XCRUN_MISSING_ERROR);
     }
 };
 const resolveAndroidClient = async (client, runner) => {
@@ -142,6 +244,7 @@ const resolveAndroidClient = async (client, runner) => {
                 device: {
                     bundleId: client.bundleId,
                     displayName: matched.serial,
+                    kind: 'real-device',
                     nativeId: matched.serial,
                     platform: 'android',
                 },
@@ -162,16 +265,7 @@ const resolveAndroidClient = async (client, runner) => {
         };
     }
     catch (err) {
-        if (err instanceof processRunner_1.ProcessNotFoundError) {
-            return {
-                error: 'adb not found. Android host tools require Android platform-tools on PATH.',
-                ok: false,
-            };
-        }
-        return {
-            error: `Failed to list Android devices: ${err.message}`,
-            ok: false,
-        };
+        return toDeviceError(err, 'Failed to list Android devices', ADB_MISSING_ERROR);
     }
 };
 const resolveClientToDevice = async (client, runner) => {
@@ -201,7 +295,12 @@ const scanIosDevices = async (runner) => {
         if (booted.length === 1) {
             const only = booted[0];
             return {
-                device: { displayName: only.name, nativeId: only.udid, platform: 'ios' },
+                device: {
+                    displayName: only.name,
+                    kind: 'simulator',
+                    nativeId: only.udid,
+                    platform: 'ios',
+                },
                 ok: true,
             };
         }
@@ -216,16 +315,7 @@ const scanIosDevices = async (runner) => {
         };
     }
     catch (err) {
-        if (err instanceof processRunner_1.ProcessNotFoundError) {
-            return {
-                error: 'xcrun not found. iOS host tools require Xcode command line tools (macOS only).',
-                ok: false,
-            };
-        }
-        return {
-            error: `Failed to list iOS simulators: ${err.message}`,
-            ok: false,
-        };
+        return toDeviceError(err, 'Failed to list iOS simulators', XCRUN_MISSING_ERROR);
     }
 };
 const scanAndroidDevices = async (runner) => {
@@ -245,6 +335,7 @@ const scanAndroidDevices = async (runner) => {
             return {
                 device: {
                     displayName: only.serial,
+                    kind: 'real-device',
                     nativeId: only.serial,
                     platform: 'android',
                 },
@@ -262,16 +353,7 @@ const scanAndroidDevices = async (runner) => {
         };
     }
     catch (err) {
-        if (err instanceof processRunner_1.ProcessNotFoundError) {
-            return {
-                error: 'adb not found. Android host tools require Android platform-tools on PATH.',
-                ok: false,
-            };
-        }
-        return {
-            error: `Failed to list Android devices: ${err.message}`,
-            ok: false,
-        };
+        return toDeviceError(err, 'Failed to list Android devices', ADB_MISSING_ERROR);
     }
 };
 const resolveIosByUdid = async (udid, runner) => {
@@ -300,6 +382,7 @@ const resolveIosByUdid = async (udid, runner) => {
         return {
             device: {
                 displayName: match.name,
+                kind: 'simulator',
                 nativeId: match.udid,
                 platform: 'ios',
             },
@@ -307,16 +390,7 @@ const resolveIosByUdid = async (udid, runner) => {
         };
     }
     catch (err) {
-        if (err instanceof processRunner_1.ProcessNotFoundError) {
-            return {
-                error: 'xcrun not found. iOS host tools require Xcode command line tools (macOS only).',
-                ok: false,
-            };
-        }
-        return {
-            error: `Failed to list iOS simulators: ${err.message}`,
-            ok: false,
-        };
+        return toDeviceError(err, 'Failed to list iOS simulators', XCRUN_MISSING_ERROR);
     }
 };
 const resolveAndroidBySerial = async (serial, runner) => {
@@ -345,6 +419,7 @@ const resolveAndroidBySerial = async (serial, runner) => {
         return {
             device: {
                 displayName: match.serial,
+                kind: 'real-device',
                 nativeId: match.serial,
                 platform: 'android',
             },
@@ -352,16 +427,7 @@ const resolveAndroidBySerial = async (serial, runner) => {
         };
     }
     catch (err) {
-        if (err instanceof processRunner_1.ProcessNotFoundError) {
-            return {
-                error: 'adb not found. Android host tools require Android platform-tools on PATH.',
-                ok: false,
-            };
-        }
-        return {
-            error: `Failed to list Android devices: ${err.message}`,
-            ok: false,
-        };
+        return toDeviceError(err, 'Failed to list Android devices', ADB_MISSING_ERROR);
     }
 };
 const scanForDevice = async (platform, runner) => {