agent-mobile 0.1.0

package/dist/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { openCommand } from './commands/open.js';
+import { snapshotCommand } from './commands/snapshot.js';
+import { tapCommand } from './commands/tap.js';
+import { fillCommand } from './commands/fill.js';
+import { swipeCommand } from './commands/swipe.js';
+import { screenshotCommand } from './commands/screenshot.js';
+import { closeCommand } from './commands/close.js';
+import { doctorCommand } from './commands/doctor.js';
+// Read version from package.json dynamically
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('agent-mobile')
+    .description('Mobile automation CLI for AI agents - control iOS simulators\n\nCommands:\n  open        Launch an iOS app by bundle ID\n  snapshot    Get UI elements with refs (@e1, @e2, ...)\n  tap         Tap element by ref or coordinates\n  fill        Fill text into input by ref\n  swipe       Swipe in a direction\n  screenshot  Take a screenshot\n  close       Close the current session\n  doctor      Check system requirements\n\nWorkflow:\n  1. agent-mobile open com.apple.Preferences\n  2. agent-mobile snapshot\n  3. agent-mobile tap @e1')
+    .version(packageJson.version);
+program.addCommand(openCommand);
+program.addCommand(snapshotCommand);
+program.addCommand(tapCommand);
+program.addCommand(fillCommand);
+program.addCommand(swipeCommand);
+program.addCommand(screenshotCommand);
+program.addCommand(closeCommand);
+program.addCommand(doctorCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,6CAA6C;AAC7C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7F,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,cAAc,CAAC;KACpB,WAAW,CAAC,uhBAAuhB,CAAC;KACpiB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAEhC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/appium.d.ts

@@ -0,0 +1,10 @@
+import { type Browser } from 'webdriverio';
+export interface OpenOptions {
+    bundleId: string;
+    deviceName?: string;
+}
+export declare function createSession(options: OpenOptions): Promise<Browser>;
+export declare function getDriver(): Promise<Browser>;
+export declare function closeSession(): Promise<void>;
+export declare function validateSession(): Promise<boolean>;
+//# sourceMappingURL=appium.d.ts.map

package/dist/lib/appium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appium.d.ts","sourceRoot":"","sources":["../../src/lib/appium.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAuBnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CA2C1E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAgDlD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAQxD"}

package/dist/lib/appium.js

@@ -0,0 +1,127 @@
+import { remote } from 'webdriverio';
+import { execSync } from 'child_process';
+import { readSession, writeSession, deleteSession } from './session.js';
+import { ensureAppiumReady } from './server.js';
+let driver = null;
+function getAppiumUrl() {
+    const host = process.env.APPIUM_HOST || 'localhost';
+    const port = process.env.APPIUM_PORT || '4723';
+    return `http://${host}:${port}`;
+}
+function getBootedSimulatorUdid() {
+    try {
+        const output = execSync('xcrun simctl list devices booted', { encoding: 'utf-8' });
+        const match = output.match(/\(([A-F0-9-]{36})\) \(Booted\)/);
+        return match ? match[1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function createSession(options) {
+    // Auto-setup: ensure Appium is running and driver is installed
+    await ensureAppiumReady();
+    const appiumUrl = getAppiumUrl();
+    const udid = process.env.SIMULATOR_UDID || getBootedSimulatorUdid();
+    if (!udid) {
+        throw new Error('No booted iOS simulator found. Boot one with: xcrun simctl boot "iPhone 16 Pro"');
+    }
+    try {
+        driver = await remote({
+            hostname: process.env.APPIUM_HOST || 'localhost',
+            port: parseInt(process.env.APPIUM_PORT || '4723'),
+            capabilities: {
+                platformName: 'iOS',
+                'appium:automationName': 'XCUITest',
+                'appium:deviceName': options.deviceName || 'iPhone Simulator',
+                'appium:udid': udid,
+                'appium:bundleId': options.bundleId,
+                'appium:noReset': true,
+            },
+            logLevel: 'silent',
+        });
+        const session = {
+            sessionId: driver.sessionId,
+            appiumUrl,
+            deviceName: options.deviceName || 'iPhone Simulator',
+            bundleId: options.bundleId,
+            refs: {},
+        };
+        writeSession(session);
+        return driver;
+    }
+    catch (error) {
+        const err = error;
+        if (err.message.includes('ECONNREFUSED')) {
+            throw new Error(`Cannot connect to Appium at ${appiumUrl}. Run: agent-mobile doctor`);
+        }
+        throw error;
+    }
+}
+export async function getDriver() {
+    if (driver) {
+        return driver;
+    }
+    const session = readSession();
+    if (!session) {
+        throw new Error('No active session. Run: agent-mobile open <bundle-id>');
+    }
+    // Auto-setup: ensure Appium is running
+    await ensureAppiumReady();
+    const appiumUrl = getAppiumUrl();
+    const udid = process.env.SIMULATOR_UDID || getBootedSimulatorUdid() || undefined;
+    try {
+        // Try to reconnect to existing session
+        driver = await remote({
+            hostname: process.env.APPIUM_HOST || 'localhost',
+            port: parseInt(process.env.APPIUM_PORT || '4723'),
+            capabilities: {
+                platformName: 'iOS',
+                'appium:automationName': 'XCUITest',
+                'appium:deviceName': session.deviceName,
+                'appium:udid': udid,
+                'appium:bundleId': session.bundleId,
+                'appium:noReset': true,
+            },
+            logLevel: 'silent',
+        });
+        // Update session with new session ID
+        session.sessionId = driver.sessionId;
+        writeSession(session);
+        return driver;
+    }
+    catch (error) {
+        const err = error;
+        if (err.message.includes('ECONNREFUSED')) {
+            throw new Error(`Cannot connect to Appium at ${appiumUrl}. Run: agent-mobile doctor`);
+        }
+        if (err.message.includes('invalid session id') || err.message.includes('session not created')) {
+            deleteSession();
+            throw new Error('Session expired. Run: agent-mobile open <bundle-id>');
+        }
+        throw error;
+    }
+}
+export async function closeSession() {
+    if (driver) {
+        try {
+            await driver.deleteSession();
+        }
+        catch {
+            // Ignore errors during cleanup
+        }
+        driver = null;
+    }
+    deleteSession();
+}
+export async function validateSession() {
+    try {
+        const d = await getDriver();
+        await d.getPageSource();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=appium.js.map

package/dist/lib/appium.js.map

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

package/dist/lib/server.d.ts

@@ -0,0 +1,26 @@
+export declare function isAppiumRunning(): Promise<boolean>;
+export declare function isXCUITestDriverInstalled(): boolean;
+export declare function installXCUITestDriver(): Promise<void>;
+export declare function startAppiumServer(): Promise<void>;
+export declare function stopAppiumServer(): Promise<void>;
+export declare function ensureAppiumReady(): Promise<void>;
+export interface DoctorResult {
+    xcode: {
+        ok: boolean;
+        message: string;
+    };
+    simulator: {
+        ok: boolean;
+        message: string;
+    };
+    appium: {
+        ok: boolean;
+        message: string;
+    };
+    xcuitest: {
+        ok: boolean;
+        message: string;
+    };
+}
+export declare function runDoctor(): Promise<DoctorResult>;
+//# sourceMappingURL=server.d.ts.map

package/dist/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/lib/server.ts"],"names":[],"mappings":"AAkBA,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAUxD;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAYnD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY3D;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqCvD;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAqBtD;AAED,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUvD;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,SAAS,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,QAAQ,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,CA+CvD"}

package/dist/lib/server.js

@@ -0,0 +1,165 @@
+import { spawn, execSync } from 'child_process';
+import { existsSync, writeFileSync, readFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+const PID_FILE = join(tmpdir(), 'agent-mobile-appium.pid');
+const LOG_FILE = join(tmpdir(), 'agent-mobile-appium.log');
+let appiumProcess = null;
+function getAppiumPort() {
+    return parseInt(process.env.APPIUM_PORT || '4723');
+}
+function getAppiumHost() {
+    return process.env.APPIUM_HOST || '127.0.0.1';
+}
+export async function isAppiumRunning() {
+    const port = getAppiumPort();
+    const host = getAppiumHost();
+    try {
+        const response = await fetch(`http://${host}:${port}/status`);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export function isXCUITestDriverInstalled() {
+    try {
+        const output = execSync('npx appium driver list --installed --json 2>/dev/null', {
+            encoding: 'utf-8',
+            timeout: 30000,
+        });
+        const drivers = JSON.parse(output);
+        return 'xcuitest' in drivers;
+    }
+    catch {
+        // If we can't check, try anyway
+        return true;
+    }
+}
+export async function installXCUITestDriver() {
+    console.log('Installing XCUITest driver (first-time setup)...');
+    try {
+        execSync('npx appium driver install xcuitest', {
+            encoding: 'utf-8',
+            stdio: 'inherit',
+            timeout: 300000, // 5 minutes
+        });
+        console.log('XCUITest driver installed successfully');
+    }
+    catch (error) {
+        throw new Error('Failed to install XCUITest driver. Run manually: npx appium driver install xcuitest');
+    }
+}
+export async function startAppiumServer() {
+    const port = getAppiumPort();
+    const host = getAppiumHost();
+    // Check if already running
+    if (await isAppiumRunning()) {
+        return;
+    }
+    console.log('Starting Appium server...');
+    // Use npx to run the bundled appium
+    appiumProcess = spawn('npx', ['appium', '--address', host, '--port', String(port), '--relaxed-security'], {
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: { ...process.env },
+    });
+    // Save PID for later cleanup
+    if (appiumProcess.pid) {
+        writeFileSync(PID_FILE, String(appiumProcess.pid));
+    }
+    // Don't let the parent wait for this process
+    appiumProcess.unref();
+    // Wait for server to be ready
+    const maxAttempts = 30;
+    for (let i = 0; i < maxAttempts; i++) {
+        await new Promise(resolve => setTimeout(resolve, 1000));
+        if (await isAppiumRunning()) {
+            console.log('Appium server ready');
+            return;
+        }
+    }
+    throw new Error('Appium server failed to start. Run manually: npx appium');
+}
+export async function stopAppiumServer() {
+    // Try to stop the process we started
+    if (appiumProcess && !appiumProcess.killed) {
+        appiumProcess.kill();
+        appiumProcess = null;
+    }
+    // Try to stop via PID file
+    if (existsSync(PID_FILE)) {
+        try {
+            const pid = parseInt(readFileSync(PID_FILE, 'utf-8'));
+            process.kill(pid, 'SIGTERM');
+        }
+        catch {
+            // Process may already be dead
+        }
+        try {
+            unlinkSync(PID_FILE);
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+export async function ensureAppiumReady() {
+    // Check and install XCUITest driver if needed
+    if (!isXCUITestDriverInstalled()) {
+        await installXCUITestDriver();
+    }
+    // Start Appium if not running
+    if (!(await isAppiumRunning())) {
+        await startAppiumServer();
+    }
+}
+export async function runDoctor() {
+    const result = {
+        xcode: { ok: false, message: '' },
+        simulator: { ok: false, message: '' },
+        appium: { ok: false, message: '' },
+        xcuitest: { ok: false, message: '' },
+    };
+    // Check Xcode
+    try {
+        const xcodeVersion = execSync('xcodebuild -version 2>/dev/null | head -1', { encoding: 'utf-8' }).trim();
+        result.xcode = { ok: true, message: xcodeVersion };
+    }
+    catch {
+        result.xcode = { ok: false, message: 'Xcode not found. Install from App Store.' };
+    }
+    // Check Simulator
+    try {
+        const output = execSync('xcrun simctl list devices booted 2>/dev/null', { encoding: 'utf-8' });
+        const bootedMatch = output.match(/\(([A-F0-9-]{36})\) \(Booted\)/);
+        if (bootedMatch) {
+            // Get device name
+            const nameMatch = output.match(/^\s+(.+) \([A-F0-9-]{36}\) \(Booted\)/m);
+            const deviceName = nameMatch ? nameMatch[1] : 'Unknown';
+            result.simulator = { ok: true, message: `${deviceName} (booted)` };
+        }
+        else {
+            result.simulator = { ok: false, message: 'No simulator booted. Run: xcrun simctl boot "iPhone 16 Pro"' };
+        }
+    }
+    catch {
+        result.simulator = { ok: false, message: 'Cannot check simulators. Is Xcode installed?' };
+    }
+    // Check Appium
+    if (await isAppiumRunning()) {
+        result.appium = { ok: true, message: 'Running on port ' + getAppiumPort() };
+    }
+    else {
+        result.appium = { ok: true, message: 'Not running (will auto-start)' };
+    }
+    // Check XCUITest driver
+    if (isXCUITestDriverInstalled()) {
+        result.xcuitest = { ok: true, message: 'Installed' };
+    }
+    else {
+        result.xcuitest = { ok: true, message: 'Not installed (will auto-install)' };
+    }
+    return result;
+}
+//# sourceMappingURL=server.js.map

package/dist/lib/server.js.map

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

package/dist/lib/session.d.ts

@@ -0,0 +1,19 @@
+export interface ElementRef {
+    xpath: string;
+    type: string;
+    label?: string;
+    value?: string;
+}
+export interface SessionData {
+    sessionId: string;
+    appiumUrl: string;
+    deviceName: string;
+    bundleId: string;
+    refs: Record<string, ElementRef>;
+}
+export declare function readSession(): SessionData | null;
+export declare function writeSession(session: SessionData): void;
+export declare function updateRefs(refs: Record<string, ElementRef>): void;
+export declare function deleteSession(): void;
+export declare function getRef(ref: string): ElementRef | undefined;
+//# sourceMappingURL=session.d.ts.map

package/dist/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAClC;AAED,wBAAgB,WAAW,IAAI,WAAW,GAAG,IAAI,CAUhD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAEvD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI,CAMjE;AAED,wBAAgB,aAAa,IAAI,IAAI,CAQpC;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAG1D"}

package/dist/lib/session.js

@@ -0,0 +1,39 @@
+import * as fs from 'fs';
+const SESSION_FILE = '/tmp/agent-mobile-session.json';
+export function readSession() {
+    try {
+        if (!fs.existsSync(SESSION_FILE)) {
+            return null;
+        }
+        const data = fs.readFileSync(SESSION_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+export function writeSession(session) {
+    fs.writeFileSync(SESSION_FILE, JSON.stringify(session, null, 2));
+}
+export function updateRefs(refs) {
+    const session = readSession();
+    if (session) {
+        session.refs = refs;
+        writeSession(session);
+    }
+}
+export function deleteSession() {
+    try {
+        if (fs.existsSync(SESSION_FILE)) {
+            fs.unlinkSync(SESSION_FILE);
+        }
+    }
+    catch {
+        // Ignore errors during cleanup
+    }
+}
+export function getRef(ref) {
+    const session = readSession();
+    return session?.refs[ref];
+}
+//# sourceMappingURL=session.js.map

package/dist/lib/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAiBtD,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAgC;IACzD,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW;IAChC,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,OAAO,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/lib/snapshot.d.ts

@@ -0,0 +1,11 @@
+import type { Browser } from 'webdriverio';
+export interface SnapshotOptions {
+    interactive?: boolean;
+    all?: boolean;
+}
+export interface SnapshotResult {
+    text: string;
+    count: number;
+}
+export declare function takeSnapshot(driver: Browser, options?: SnapshotOptions): Promise<SnapshotResult>;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/lib/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AA6H3C,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA2CzB"}

package/dist/lib/snapshot.js

@@ -0,0 +1,136 @@
+import { updateRefs } from './session.js';
+// Map iOS element types to short names
+const TYPE_MAP = {
+    XCUIElementTypeButton: 'button',
+    XCUIElementTypeStaticText: 'staticText',
+    XCUIElementTypeTextField: 'textField',
+    XCUIElementTypeSecureTextField: 'secureTextField',
+    XCUIElementTypeTextView: 'textView',
+    XCUIElementTypeSwitch: 'switch',
+    XCUIElementTypeSlider: 'slider',
+    XCUIElementTypeCell: 'cell',
+    XCUIElementTypeImage: 'image',
+    XCUIElementTypeLink: 'link',
+    XCUIElementTypeSearchField: 'searchField',
+    XCUIElementTypeNavigationBar: 'navBar',
+    XCUIElementTypeTabBar: 'tabBar',
+    XCUIElementTypeTable: 'table',
+    XCUIElementTypeCollectionView: 'collectionView',
+    XCUIElementTypeScrollView: 'scrollView',
+    XCUIElementTypeOther: 'other',
+    XCUIElementTypeApplication: 'application',
+    XCUIElementTypeWindow: 'window',
+};
+function mapType(iosType) {
+    return TYPE_MAP[iosType] || iosType.replace('XCUIElementType', '').toLowerCase();
+}
+function escapeXPathString(str) {
+    if (!str.includes("'")) {
+        return `'${str}'`;
+    }
+    if (!str.includes('"')) {
+        return `"${str}"`;
+    }
+    // Use concat for strings with both quotes
+    const parts = str.split("'");
+    return `concat('${parts.join("', \"'\", '")}')`;
+}
+function parseAccessibilityTree(xml) {
+    const elements = [];
+    // Match iOS element tags with attributes
+    const elementRegex = /<(XCUIElementType\w+)\s+([^>]*)(?:\/>|>)/g;
+    let match;
+    const xpathCounts = {};
+    while ((match = elementRegex.exec(xml)) !== null) {
+        const [, tagName, attrs] = match;
+        // Parse attributes
+        const getAttr = (name) => {
+            const attrMatch = attrs.match(new RegExp(`${name}="([^"]*)"`));
+            return attrMatch ? attrMatch[1] : undefined;
+        };
+        const enabled = getAttr('enabled') !== 'false';
+        const visible = getAttr('visible') !== 'false';
+        const accessible = getAttr('accessible') === 'true';
+        const name = getAttr('name');
+        const label = getAttr('label') || name;
+        const value = getAttr('value');
+        // Build XPath - prefer @name attribute for stability, fall back to position
+        let xpath;
+        if (name) {
+            xpath = `//${tagName}[@name=${escapeXPathString(name)}]`;
+        }
+        else {
+            xpathCounts[tagName] = (xpathCounts[tagName] || 0) + 1;
+            xpath = `//${tagName}[${xpathCounts[tagName]}]`;
+        }
+        elements.push({
+            type: mapType(tagName),
+            name: name || undefined,
+            label: label || undefined,
+            value: value || undefined,
+            enabled,
+            visible,
+            accessible,
+            xpath,
+        });
+    }
+    return elements;
+}
+function isInteractive(el) {
+    if (!el.enabled || !el.visible)
+        return false;
+    // Interactive types
+    const interactiveTypes = [
+        'button',
+        'textField',
+        'secureTextField',
+        'textView',
+        'switch',
+        'slider',
+        'cell',
+        'link',
+        'searchField',
+    ];
+    if (interactiveTypes.includes(el.type))
+        return true;
+    // Elements with labels that are accessible
+    if (el.accessible && el.label)
+        return true;
+    return false;
+}
+export async function takeSnapshot(driver, options = {}) {
+    const showAll = options.all === true;
+    const interactiveOnly = options.interactive !== false && !showAll;
+    const pageSource = await driver.getPageSource();
+    const elements = parseAccessibilityTree(pageSource);
+    // Filter elements
+    const filtered = interactiveOnly ? elements.filter(isInteractive) : elements;
+    // Assign refs and build output
+    const refs = {};
+    const lines = [];
+    filtered.forEach((el, index) => {
+        const ref = `@e${index + 1}`;
+        refs[ref] = {
+            xpath: el.xpath,
+            type: el.type,
+            label: el.label,
+            value: el.value,
+        };
+        // Build compact output line
+        let line = `${ref} ${el.type}`;
+        if (el.label) {
+            line += ` "${el.label}"`;
+        }
+        if (el.value) {
+            line += ` [${el.value}]`;
+        }
+        lines.push(line);
+    });
+    // Persist refs to session
+    updateRefs(refs);
+    return {
+        text: lines.join('\n'),
+        count: lines.length,
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/lib/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/lib/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAmB,MAAM,cAAc,CAAC;AAE3D,uCAAuC;AACvC,MAAM,QAAQ,GAA2B;IACvC,qBAAqB,EAAE,QAAQ;IAC/B,yBAAyB,EAAE,YAAY;IACvC,wBAAwB,EAAE,WAAW;IACrC,8BAA8B,EAAE,iBAAiB;IACjD,uBAAuB,EAAE,UAAU;IACnC,qBAAqB,EAAE,QAAQ;IAC/B,qBAAqB,EAAE,QAAQ;IAC/B,mBAAmB,EAAE,MAAM;IAC3B,oBAAoB,EAAE,OAAO;IAC7B,mBAAmB,EAAE,MAAM;IAC3B,0BAA0B,EAAE,aAAa;IACzC,4BAA4B,EAAE,QAAQ;IACtC,qBAAqB,EAAE,QAAQ;IAC/B,oBAAoB,EAAE,OAAO;IAC7B,6BAA6B,EAAE,gBAAgB;IAC/C,yBAAyB,EAAE,YAAY;IACvC,oBAAoB,EAAE,OAAO;IAC7B,0BAA0B,EAAE,aAAa;IACzC,qBAAqB,EAAE,QAAQ;CAChC,CAAC;AAEF,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnF,CAAC;AAaD,SAAS,iBAAiB,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,0CAA0C;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,WAAW,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,yCAAyC;IACzC,MAAM,YAAY,GAAG,2CAA2C,CAAC;IACjE,IAAI,KAAK,CAAC;IACV,MAAM,WAAW,GAA2B,EAAE,CAAC;IAE/C,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;QAEjC,mBAAmB;QACnB,MAAM,OAAO,GAAG,CAAC,IAAY,EAAsB,EAAE;YACnD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC;YAC/D,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C,CAAC,CAAC;QAEF,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC;QAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM,CAAC;QACpD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/B,4EAA4E;QAC5E,IAAI,KAAa,CAAC;QAClB,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,GAAG,KAAK,OAAO,UAAU,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACvD,KAAK,GAAG,KAAK,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;QAClD,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC;YACtB,IAAI,EAAE,IAAI,IAAI,SAAS;YACvB,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,OAAO;YACP,OAAO;YACP,UAAU;YACV,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,EAAiB;IACtC,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE7C,oBAAoB;IACpB,MAAM,gBAAgB,GAAG;QACvB,QAAQ;QACR,WAAW;QACX,iBAAiB;QACjB,UAAU;QACV,QAAQ;QACR,QAAQ;QACR,MAAM;QACN,MAAM;QACN,aAAa;KACd,CAAC;IAEF,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpD,2CAA2C;IAC3C,IAAI,EAAE,CAAC,UAAU,IAAI,EAAE,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAE3C,OAAO,KAAK,CAAC;AACf,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAe,EACf,UAA2B,EAAE;IAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC;IACrC,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC;IAElE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;IAChD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAEpD,kBAAkB;IAClB,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE7E,+BAA+B;IAC/B,MAAM,IAAI,GAA+B,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;QAE7B,IAAI,CAAC,GAAG,CAAC,GAAG;YACV,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,KAAK,EAAE,EAAE,CAAC,KAAK;YACf,KAAK,EAAE,EAAE,CAAC,KAAK;SAChB,CAAC;QAEF,4BAA4B;QAC5B,IAAI,IAAI,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC;QAC3B,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,KAAK,EAAE,CAAC,KAAK,GAAG,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACtB,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}