appium-ios-remotexpc 0.16.1 → 0.18.0

package/build/src/services/ios/dvt/instruments/device-info.js

@@ -0,0 +1,179 @@
+import { getLogger } from '../../../../lib/logger.js';
+import { parseBinaryPlist } from '../../../../lib/plist/index.js';
+import { MessageAux } from '../dtx-message.js';
+const log = getLogger('DeviceInfo');
+/**
+ * DeviceInfo service provides access to device information, file system,
+ * and process management through the DTX protocol.
+ *
+ * Available methods:
+ * - ls(path): List directory contents
+ * - execnameForPid(pid): Get executable path for a process ID
+ * - proclist(): Get list of running processes
+ * - isRunningPid(pid): Check if a process is running
+ * - hardwareInformation(): Get hardware details
+ * - networkInformation(): Get network configuration
+ * - machTimeInfo(): Get mach time information
+ * - machKernelName(): Get kernel name
+ * - kpepDatabase(): Get kernel performance event database
+ * - traceCodes(): Get trace code mappings
+ * - nameForUid(uid): Get username for UID
+ * - nameForGid(gid): Get group name for GID
+ */
+export class DeviceInfo {
+    dvt;
+    static IDENTIFIER = 'com.apple.instruments.server.services.deviceinfo';
+    channel = null;
+    constructor(dvt) {
+        this.dvt = dvt;
+    }
+    /**
+     * Initialize the device info channel
+     */
+    async initialize() {
+        if (!this.channel) {
+            this.channel = await this.dvt.makeChannel(DeviceInfo.IDENTIFIER);
+        }
+    }
+    /**
+     * List directory contents at the specified path.
+     * @param path - The directory path to list
+     * @returns Array of filenames
+     * @throws {Error} If the directory doesn't exist or cannot be accessed
+     */
+    async ls(path) {
+        const result = await this.requestInformation('directoryListingForPath_', path);
+        if (result === null || result === undefined) {
+            throw new Error(`Failed to list directory: ${path}`);
+        }
+        log.debug(`Listed directory ${path}: ${result.length} entries`);
+        return result;
+    }
+    /**
+     * Get the full executable path for a given process ID.
+     * @param pid - The process identifier
+     * @returns The full path to the executable
+     */
+    async execnameForPid(pid) {
+        return this.requestInformation('execnameForPid_', pid);
+    }
+    /**
+     * Get the list of all running processes on the device.
+     * @returns Array of process information objects
+     */
+    async proclist() {
+        const result = await this.requestInformation('runningProcesses');
+        if (!Array.isArray(result)) {
+            throw new Error(`proclist returned invalid data: expected an array, got ${typeof result} (${JSON.stringify(result)})`);
+        }
+        log.debug(`Retrieved ${result.length} running processes`);
+        return result;
+    }
+    /**
+     * Check if a process with the given PID is currently running.
+     * @param pid - The process identifier to check
+     * @returns true if the process is running, false otherwise
+     */
+    async isRunningPid(pid) {
+        return this.requestInformation('isRunningPid_', pid);
+    }
+    /**
+     * Get hardware information about the device.
+     * @returns Object containing hardware information
+     */
+    async hardwareInformation() {
+        return this.requestInformation('hardwareInformation');
+    }
+    /**
+     * Get network configuration information.
+     * @returns Object containing network information
+     */
+    async networkInformation() {
+        return this.requestInformation('networkInformation');
+    }
+    /**
+     * Get mach kernel time information.
+     * @returns Object containing mach time info
+     */
+    async machTimeInfo() {
+        return this.requestInformation('machTimeInfo');
+    }
+    /**
+     * Get the mach kernel name.
+     * @returns The kernel name string
+     */
+    async machKernelName() {
+        return this.requestInformation('machKernelName');
+    }
+    /**
+     * Get the kernel performance event (kpep) database.
+     * @returns Object containing kpep database or null if not available
+     */
+    async kpepDatabase() {
+        const kpepData = await this.requestInformation('kpepDatabase');
+        if (kpepData === null || kpepData === undefined) {
+            return null;
+        }
+        // The kpepDatabase is returned as binary plist data
+        if (Buffer.isBuffer(kpepData)) {
+            try {
+                return parseBinaryPlist(kpepData);
+            }
+            catch (error) {
+                log.warn('Failed to parse kpep database:', error);
+                return null;
+            }
+        }
+        return kpepData;
+    }
+    /**
+     * Get trace code mappings.
+     * @returns Object mapping trace codes (as hex strings) to descriptions
+     */
+    async traceCodes() {
+        const codesFile = await this.requestInformation('traceCodesFile');
+        if (typeof codesFile !== 'string') {
+            return {};
+        }
+        const codes = {};
+        for (const line of codesFile.split('\n')) {
+            const match = line.trim().match(/^(\S+)\s+(.+)$/);
+            if (match) {
+                const [, hex, description] = match;
+                codes[hex] = description;
+            }
+        }
+        log.debug(`Retrieved ${Object.keys(codes).length} trace codes`);
+        return codes;
+    }
+    /**
+     * Get the username for a given user ID (UID).
+     * @param uid - The user identifier
+     * @returns The username string
+     */
+    async nameForUid(uid) {
+        return this.requestInformation('nameForUID_', uid);
+    }
+    /**
+     * Get the group name for a given group ID (GID).
+     * @param gid - The group identifier
+     * @returns The group name string
+     */
+    async nameForGid(gid) {
+        return this.requestInformation('nameForGID_', gid);
+    }
+    /**
+     * Generic method to request information from the device.
+     * @param selectorName - The selector name to call
+     * @param arg - Optional argument to pass to the selector
+     * @returns The information object or value returned by the selector
+     * @private
+     */
+    async requestInformation(selectorName, arg) {
+        await this.initialize();
+        const call = this.channel.call(selectorName);
+        const args = arg !== undefined ? new MessageAux().appendObj(arg) : undefined;
+        await call(args);
+        return this.channel.receivePlist();
+    }
+}

package/build/src/services/ios/dvt/nskeyedarchiver-decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nskeyedarchiver-decoder.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/dvt/nskeyedarchiver-decoder.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;gBAElB,IAAI,EAAE,GAAG;IAUrB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;IAa3C;;OAEG;IACH,MAAM,IAAI,GAAG;IA8Bb;;OAEG;IACH,OAAO,CAAC,YAAY;IAkFpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkBzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAiBpD"}
+{"version":3,"file":"nskeyedarchiver-decoder.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/dvt/nskeyedarchiver-decoder.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAM;gBAElB,IAAI,EAAE,GAAG;IAUrB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;IAa3C;;OAEG;IACH,MAAM,IAAI,GAAG;IA8Bb;;OAEG;IACH,OAAO,CAAC,YAAY;IAmHpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAuBzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAiBpD"}

package/build/src/services/ios/dvt/nskeyedarchiver-decoder.js

@@ -1,5 +1,6 @@
 import { getLogger } from '../../../lib/logger.js';
 const log = getLogger('NSKeyedArchiverDecoder');
+const MAX_DECODE_DEPTH = 1000;
 /**
  * Decode NSKeyedArchiver formatted data into native JavaScript objects
  *
@@ -66,42 +67,59 @@ export class NSKeyedArchiverDecoder {
     /**
      * Decode an object at a specific index
      */
-    decodeObject(index) {
+    decodeObject(index, visited = new Set(), depth = 0) {
+        // Prevent stack overflow with depth limit
+        if (depth > MAX_DECODE_DEPTH) {
+            log.warn(`Maximum decode depth exceeded at index ${index}`);
+            return null;
+        }
         if (index < 0 || index >= this.objects.length) {
             return null;
         }
+        // Prevent infinite recursion
+        if (visited.has(index)) {
+            return null; // Return null for circular references
+        }
         // Check cache
         if (this.decoded.has(index)) {
             return this.decoded.get(index);
         }
+        visited.add(index);
         const obj = this.objects[index];
         // Handle null marker
         if (obj === '$null' || obj === null) {
+            visited.delete(index);
             return null;
         }
         // Handle primitive types
         if (typeof obj !== 'object') {
+            visited.delete(index);
             return obj;
         }
         // Handle Buffer/binary data (eg. screenshots)
         if (Buffer.isBuffer(obj)) {
             this.decoded.set(index, obj);
+            visited.delete(index);
             return obj;
         }
         // Handle UID references
         if ('CF$UID' in obj) {
-            return this.decodeObject(obj.CF$UID);
+            const result = this.decodeObject(obj.CF$UID, visited, depth + 1);
+            visited.delete(index);
+            return result;
         }
         // Handle NSDictionary (NS.keys + NS.objects) - check this FIRST before NSArray
         if ('NS.keys' in obj && 'NS.objects' in obj) {
-            const result = this.decodeDictionary(obj['NS.keys'], obj['NS.objects']);
+            const result = this.decodeDictionary(obj['NS.keys'], obj['NS.objects'], visited, depth);
             this.decoded.set(index, result);
+            visited.delete(index);
             return result;
         }
         // Handle NSArray (NS.objects only, without NS.keys)
         if ('NS.objects' in obj) {
-            const result = this.decodeArray(obj['NS.objects']);
+            const result = this.decodeArray(obj['NS.objects'], visited, depth);
             this.decoded.set(index, result);
+            visited.delete(index);
             return result;
         }
         // Handle regular objects - just return as-is but resolve references
@@ -112,11 +130,17 @@ export class NSKeyedArchiverDecoder {
             }
             if (typeof value === 'number') {
                 // Could be a reference or primitive
-                const referenced = this.objects[value];
-                if (referenced &&
-                    typeof referenced === 'object' &&
-                    referenced !== '$null') {
-                    result[key] = this.decodeObject(value);
+                if (value < this.objects.length && value >= 0) {
+                    const referenced = this.objects[value];
+                    if (referenced &&
+                        typeof referenced === 'object' &&
+                        referenced !== '$null' &&
+                        !visited.has(value)) {
+                        result[key] = this.decodeObject(value, visited, depth + 1);
+                    }
+                    else {
+                        result[key] = value;
+                    }
                 }
                 else {
                     result[key] = value;
@@ -124,8 +148,8 @@ export class NSKeyedArchiverDecoder {
             }
             else if (typeof value === 'object' && value && 'CF$UID' in value) {
                 const uid = value.CF$UID;
-                if (typeof uid === 'number') {
-                    result[key] = this.decodeObject(uid);
+                if (typeof uid === 'number' && !visited.has(uid)) {
+                    result[key] = this.decodeObject(uid, visited, depth + 1);
                 }
                 else {
                     result[key] = value;
@@ -136,21 +160,22 @@ export class NSKeyedArchiverDecoder {
             }
         }
         this.decoded.set(index, result);
+        visited.delete(index);
         return result;
     }
     /**
      * Decode an NSArray
      */
-    decodeArray(refs) {
+    decodeArray(refs, visited = new Set(), depth = 0) {
         if (!Array.isArray(refs)) {
             return [];
         }
         return refs.map((ref) => {
             if (typeof ref === 'number') {
-                return this.decodeObject(ref);
+                return this.decodeObject(ref, visited, depth + 1);
             }
             else if (typeof ref === 'object' && ref && 'CF$UID' in ref) {
-                return this.decodeObject(ref.CF$UID);
+                return this.decodeObject(ref.CF$UID, visited, depth + 1);
             }
             return ref;
         });
@@ -158,14 +183,14 @@ export class NSKeyedArchiverDecoder {
     /**
      * Decode an NSDictionary
      */
-    decodeDictionary(keyRefs, valueRefs) {
+    decodeDictionary(keyRefs, valueRefs, visited = new Set(), depth = 0) {
         if (!Array.isArray(keyRefs) || !Array.isArray(valueRefs)) {
             return {};
         }
         const result = {};
         for (let i = 0; i < keyRefs.length && i < valueRefs.length; i++) {
-            const key = this.decodeObject(keyRefs[i]);
-            const value = this.decodeObject(valueRefs[i]);
+            const key = this.decodeObject(keyRefs[i], visited, depth + 1);
+            const value = this.decodeObject(valueRefs[i], visited, depth + 1);
             if (typeof key === 'string') {
                 result[key] = value;
             }

package/build/src/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/services.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,gCAAgC,EAChC,aAAa,IAAI,iBAAiB,EAClC,iCAAiC,EAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAmBrD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sCAAsC,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uCAAuC,CAAC,CAYlD;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,6BAA6B,CAAC,CAYxC;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mCAAmC,CAAC,CAY9C;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/services.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGhF,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAChC,6BAA6B,EAC7B,iCAAiC,EACjC,uCAAuC,EACvC,sCAAsC,EACtC,mCAAmC,EACnC,gCAAgC,EAChC,aAAa,IAAI,iBAAiB,EAClC,iCAAiC,EAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAqBrD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sCAAsC,CAAC,CAYjD;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,uCAAuC,CAAC,CAYlD;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gCAAgC,CAAC,CAY3C;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,6BAA6B,CAAC,CAYxC;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mCAAmC,CAAC,CAY9C;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAG5B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iCAAiC,CAAC,CAY5C;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,CAAC,CAiCnC;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM;;;;;;;;GAO3D"}

package/build/src/services.js

@@ -5,7 +5,9 @@ import { TunnelApiClient } from './lib/tunnel/tunnel-api-client.js';
 import AfcService from './services/ios/afc/index.js';
 import DiagnosticsService from './services/ios/diagnostic-service/index.js';
 import { DVTSecureSocketProxyService } from './services/ios/dvt/index.js';
+import { ApplicationListing } from './services/ios/dvt/instruments/application-listing.js';
 import { ConditionInducer } from './services/ios/dvt/instruments/condition-inducer.js';
+import { DeviceInfo } from './services/ios/dvt/instruments/device-info.js';
 import { Graphics } from './services/ios/dvt/instruments/graphics.js';
 import { LocationSimulation } from './services/ios/dvt/instruments/location-simulation.js';
 import { Screenshot } from './services/ios/dvt/instruments/screenshot.js';
@@ -137,14 +139,18 @@ export async function startDVTService(udid) {
     const locationSimulation = new LocationSimulation(dvtService);
     const conditionInducer = new ConditionInducer(dvtService);
     const screenshot = new Screenshot(dvtService);
+    const appListing = new ApplicationListing(dvtService);
     const graphics = new Graphics(dvtService);
+    const deviceInfo = new DeviceInfo(dvtService);
     return {
         remoteXPC: remoteXPC,
         dvtService,
         locationSimulation,
         conditionInducer,
         screenshot,
+        appListing,
         graphics,
+        deviceInfo,
     };
 }
 export async function createRemoteXPCConnection(udid) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-ios-remotexpc",
-  "version": "0.16.1",
+  "version": "0.18.0",
   "main": "build/src/index.js",
   "types": "build/src/index.d.ts",
   "type": "module",
@@ -44,6 +44,8 @@
     "test:dvt:location-simulation": "mocha test/integration/dvt_instruments/location-simulation-test.ts --exit --timeout 1m",
     "test:dvt:condition-inducer": "mocha test/integration/dvt_instruments/condition-inducer-test.ts --exit --timeout 1m",
     "test:dvt:screenshot": "mocha test/integration/dvt_instruments/screenshot-test.ts --exit --timeout 1m",
+    "test:dvt:device-info": "mocha test/integration/dvt_instruments/device-info-test.ts --exit --timeout 1m",
+    "test:dvt:applist": "mocha test/integration/dvt_instruments/app-listing-test.ts --exit --timeout 1m",
     "test:tunnel-creation": "sudo tsx scripts/test-tunnel-creation.ts",
     "test:tunnel-creation:lsof": "sudo tsx scripts/test-tunnel-creation.ts --keep-open"
   },

package/src/index.ts

@@ -29,6 +29,8 @@ export type {
   ConditionInducerService,
   ScreenshotService,
   GraphicsService,
+  DeviceInfoService,
+  ProcessInfo,
   ConditionProfile,
   ConditionGroup,
   SocketInfo,

package/src/lib/types.ts

@@ -6,6 +6,7 @@ import { EventEmitter } from 'events';
 
 import type { ServiceConnection } from '../service-connection.js';
 import type { BaseService, Service } from '../services/ios/base-service.js';
+import type { iOSApplication } from '../services/ios/dvt/instruments/application-listing.js';
 import type { LocationCoordinates } from '../services/ios/dvt/instruments/location-simulation.js';
 import { ProvisioningProfile } from '../services/ios/misagent/provisioning-profile.js';
 import type { PowerAssertionOptions } from '../services/ios/power-assertion/index.js';
@@ -521,6 +522,32 @@ export interface ScreenshotService {
   getScreenshot(): Promise<Buffer>;
 }
 
+/**
+ * Application listing service interface
+ */
+export interface AppListService {
+  /**
+   * Get the list of iOS applications on the device
+   * @returns {Promise<iOSApplication>}
+   * e.g.
+   * [
+   *  {
+   *    ExtensionDictionary: { NSExtensionPointIdentifier: 'com.apple.mlhost.worker', ... },
+   *    Version: '1.0',
+   *    DisplayName: 'ModelMonitoringLighthousePlugin',
+   *    CFBundleIdentifier: 'com.apple.aeroml.ModelMonitoringLighthouse.ModelMonitoringLighthousePlugin',
+   *    BundlePath: '/System/Library/ExtensionKit/Extensions/ModelMonitoringLighthousePlugin.appex',
+   *    ExecutableName: 'ModelMonitoringLighthousePlugin',
+   *    Restricted: 1,
+   *    Type: 'PluginKit',
+   *    PluginIdentifier: 'com.apple.aeroml.ModelMonitoringLighthouse.ModelMonitoringLighthousePlugin',
+   *    PluginUUID: 'AF17A1FE-E454-57C8-B963-0832FD71AB08'
+   *   },
+   *   ...
+   * ]
+   */
+  list(): Promise<iOSApplication[]>;
+}
 /**
  * Graphics service interface for OpenGL/graphics monitoring
  */
@@ -547,6 +574,228 @@ export interface GraphicsService {
   messages(): AsyncGenerator<unknown, void, unknown>;
 }
 
+/**
+ * Process information
+ */
+export interface ProcessInfo {
+  /** Process identifier (may be negative for system services) */
+  pid: number;
+
+  /** Process name */
+  name?: string;
+
+  /** Indicates whether the process is an application */
+  isApplication: boolean;
+
+  /** Bundle identifier for application processes */
+  bundleIdentifier?: string;
+
+  /** Full path to the executable */
+  realAppName?: string;
+
+  /** Raw device start timestamp */
+  startDate?: {
+    /** Mach-based timestamp value */
+    'NS.time': number;
+  };
+
+  /** Whether crash analysis should include corpse sampling */
+  shouldAnalyzeWithCorpse?: boolean;
+}
+
+/**
+ * DeviceInfo service interface for accessing device information,
+ * file system, and process management
+ */
+export interface DeviceInfoService {
+  /**
+   * List directory contents
+   * @param path The directory path to list
+   * @returns Array of filenames
+   */
+  ls(path: string): Promise<string[]>;
+
+  /**
+   * Get executable path for a process
+   * @param pid The process identifier
+   * @returns The full path to the executable
+   */
+  execnameForPid(pid: number): Promise<string>;
+
+  /**
+   * Get list of running processes
+   * @returns Array of process information
+   * @example
+   * ```typescript
+   * const processes = await deviceInfo.proclist();
+   * // Example response:
+   * // [
+   * //   {
+   * //     name: 'audioaccessoryd',
+   * //     startDate: { 'NS.time': 786563887.8186979 },
+   * //     isApplication: false,
+   * //     pid: 77,
+   * //     realAppName: '/usr/libexec/audioaccessoryd'
+   * //   },
+   * //   {
+   * //     name: 'dmd',
+   * //     startDate: { 'NS.time': 786563890.2724509 },
+   * //     isApplication: false,
+   * //     pid: -102,
+   * //     realAppName: '/usr/libexec/dmd'
+   * //   },
+   * //   ...
+   * // ]
+   * ```
+   */
+  proclist(): Promise<ProcessInfo[]>;
+
+  /**
+   * Check if a process is running
+   * @param pid The process identifier
+   * @returns true if running, false otherwise
+   */
+  isRunningPid(pid: number): Promise<boolean>;
+
+  /**
+   * Get hardware information
+   * @returns Hardware information object
+   * @example
+   * ```typescript
+   * const hwInfo = await deviceInfo.hardwareInformation();
+   * // Example response:
+   * // {
+   * //   numberOfPhysicalCpus: 6,
+   * //   hwCPUsubtype: 2,
+   * //   numberOfCpus: 6,
+   * //   hwCPUtype: 16777228,
+   * //   hwCPU64BitCapable: 1,
+   * //   ProcessorTraceState: {
+   * //     HWTraceVersion: '{\n  "lib_ver": "libhwtrace @ tag libhwtrace-118.1",\n  "api_ver": 21,\n  ...\n}',
+   * //     Streaming: false,
+   * //     ProdTraceSupported: false,
+   * //     AllocatedBufferSize: 0,
+   * //     HWSupported: false,
+   * //     HWConfigured: false,
+   * //     RequestedBufferSize: 0,
+   * //     DevTraceSupported: false
+   * //   }
+   * // }
+   * ```
+   */
+  hardwareInformation(): Promise<any>;
+
+  /**
+   * Get network information
+   * @returns Network information object
+   * @example
+   * ```typescript
+   * const networkInfo = await deviceInfo.networkInformation();
+   * // Example response:
+   * // {
+   * //   en2: 'Ethernet Adapter (en2)',
+   * //   en0: 'Wi-Fi',
+   * //   en1: 'Ethernet Adapter (en1)',
+   * //   lo0: 'Loopback'
+   * // }
+   * ```
+   */
+  networkInformation(): Promise<any>;
+
+  /**
+   * Get mach time information
+   * @returns Mach time info array containing [machAbsoluteTime, numer, denom, machContinuousTime, systemTime, timezone]
+   * @example
+   * ```typescript
+   * const machTime = await deviceInfo.machTimeInfo();
+   * // Example response:
+   * // [
+   * //   1536005260807,      // machAbsoluteTime
+   * //   125,                // numer
+   * //   3,                  // denom
+   * //   1713684132688,      // machContinuousTime
+   * //   1764942215.065243,  // systemTime
+   * //   'Asia/Kolkata'      // timezone
+   * // ]
+   * ```
+   */
+  machTimeInfo(): Promise<any>;
+
+  /**
+   * Get mach kernel name
+   * @returns Kernel name string
+   * @example
+   * ```typescript
+   * const kernelName = await deviceInfo.machKernelName();
+   * // Example response:
+   * // '/mach.release.t8030'
+   * ```
+   */
+  machKernelName(): Promise<string>;
+
+  /**
+   * Get kernel performance event database
+   * @returns KPEP database object or null
+   * @example
+   * ```typescript
+   * const kpep = await deviceInfo.kpepDatabase();
+   * // Example response:
+   * // {
+   * //   system: {
+   * //     cpu: {
+   * //       config_counters: 1020,
+   * //       marketing_name: 'Apple A13',
+   * //       fixed_counters: 3,
+   * //       aliases: { ... },
+   * //       events: { ... },
+   * //       architecture: 'arm64',
+   * //       power_counters: -32
+   * //     }
+   * //   },
+   * //   internal: false,
+   * //   id: 'cpu_100000c_2_462504d2',
+   * //   name: 'a13',
+   * //   version: [1, 0]
+   * // }
+   * ```
+   */
+  kpepDatabase(): Promise<any | null>;
+
+  /**
+   * Get trace code mappings
+   * @returns Object mapping trace codes (as hex strings) to descriptions
+   * @example
+   * ```typescript
+   * const codes = await deviceInfo.traceCodes();
+   * // Example response:
+   * // {
+   * //   '0x1020000': 'KTrap_DivideError',
+   * //   '0x1020004': 'KTrap_Debug',
+   * //   '0x1020008': 'KTrap_NMI',
+   * //   '0x102000c': 'KTrap_Int3',
+   * //   '0x1020010': 'KTrap_Overflow',
+   * //   '0x1020014': 'KTrap_BoundRange',
+   * //   ...
+   * // }
+   * ```
+   */
+  traceCodes(): Promise<Record<string, string>>;
+
+  /**
+   * Get username for UID
+   * @param uid The user identifier
+   * @returns Username string
+   */
+  nameForUid(uid: number): Promise<string>;
+
+  /**
+   * Get group name for GID
+   * @param gid The group identifier
+   * @returns Group name string
+   */
+  nameForGid(gid: number): Promise<string>;
+}
+
 /**
  * DVT service with connection
  * This allows callers to properly manage the connection lifecycle
@@ -560,8 +809,12 @@ export interface DVTServiceWithConnection {
   conditionInducer: ConditionInducerService;
   /** The Screenshot service instance */
   screenshot: ScreenshotService;
+  /** The Application Listing service instance */
+  appListing: AppListService;
   /** The Graphics service instance */
   graphics: GraphicsService;
+  /** The DeviceInfo service instance */
+  deviceInfo: DeviceInfoService;
   /** The RemoteXPC connection that can be used to close the connection */
   remoteXPC: RemoteXpcConnection;
 }