@houwert/conductor 0.3.0 → 0.4.0

package/dist/commands/cheat-sheet.js

@@ -39,6 +39,8 @@ APP CONTROL
     --clear-keychain                        Wipe keychain before launching
     --argument key=value                    Set launch argument (repeatable)
   stop-app [<appId>]                        Stop app (uses session appId if omitted)
+  clear-state [<appId>]                     Clear app data/state (uses session appId if omitted)
+  uninstall-app <appId>                     Uninstall app from device
 
 INTERACTIONS
   tap <element>                             Tap element by text

package/dist/commands/clear-state.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.clearState = clearState;
+exports.HELP = `  clear-state [<appId>]                Clear app data/state`;
+const runner_js_1 = require("../runner.js");
+const session_js_1 = require("../session.js");
+const output_js_1 = require("../output.js");
+async function clearState(appId, opts = {}, sessionName = 'default') {
+    const session = await (0, session_js_1.getSession)(sessionName);
+    const resolvedAppId = appId ?? session.appId;
+    if (!resolvedAppId) {
+        (0, output_js_1.printError)('clear-state: no appId provided and no active session. Run launch-app first.', opts);
+        return 1;
+    }
+    const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        await driver.clearAppState(resolvedAppId);
+    }, sessionName);
+    if (result.success) {
+        (0, output_js_1.printSuccess)(`clear-state "${resolvedAppId}" — done`, opts);
+        return 0;
+    }
+    else {
+        (0, output_js_1.printError)(`clear-state "${resolvedAppId}" — failed\n${result.stderr}`, opts);
+        return 1;
+    }
+}

package/dist/commands/list-apps.js

@@ -21,7 +21,7 @@ async function listApps(opts = {}, sessionName = 'default') {
     }
     const platform = await (0, bootstrap_js_1.detectPlatform)(deviceId);
     let appIds;
-    if (platform === 'ios') {
+    if (platform === 'ios' || platform === 'tvos') {
         const result = await (0, runner_js_1.spawnCommand)('bash', [
             '-c',
             `xcrun simctl listapps ${deviceId} | plutil -convert json - -o -`,

package/dist/commands/uninstall-app.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.uninstallApp = uninstallApp;
+exports.HELP = `  uninstall-app <appId>                Uninstall app from device`;
+const runner_js_1 = require("../runner.js");
+const output_js_1 = require("../output.js");
+const ios_js_1 = require("../drivers/ios.js");
+const android_js_1 = require("../drivers/android.js");
+async function uninstallApp(appId, opts = {}, sessionName = 'default') {
+    if (!appId) {
+        (0, output_js_1.printError)('uninstall-app requires <appId>', opts);
+        return 1;
+    }
+    const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        if (driver instanceof ios_js_1.IOSDriver) {
+            await driver.uninstallApp(appId);
+        }
+        else if (driver instanceof android_js_1.AndroidDriver) {
+            await driver.uninstallApp(appId);
+        }
+    }, sessionName);
+    if (result.success) {
+        (0, output_js_1.printSuccess)(`uninstall-app "${appId}" — done`, opts);
+        return 0;
+    }
+    else {
+        (0, output_js_1.printError)(`uninstall-app "${appId}" — failed\n${result.stderr}`, opts);
+        return 1;
+    }
+}

package/dist/drivers/android.js

@@ -208,6 +208,10 @@ class AndroidDriver {
     async clearAppState(packageName) {
         await this.adb(['shell', 'pm', 'clear', packageName]);
     }
+    async uninstallApp(packageName) {
+        await this.adb(['shell', 'am', 'force-stop', packageName]).catch(() => { });
+        await this.adb(['uninstall', packageName]);
+    }
     async clearKeychain() {
         // No-op on Android — keychain is an iOS concept
     }

package/dist/drivers/flow-runner.js

@@ -987,6 +987,21 @@ async function executeCommandBody(key, val, driver, opts) {
             await driver.clearKeychain();
             break;
         }
+        case 'uninstallApp': {
+            const appId = val == null || val === ''
+                ? (opts.appId ??
+                    (() => {
+                        throw new Error('uninstallApp: no appId in command or flow header');
+                    })())
+                : resolveAppId(val, 'uninstallApp');
+            if (driver instanceof ios_js_1.IOSDriver) {
+                await driver.uninstallApp(appId);
+            }
+            else {
+                await driver.uninstallApp(appId);
+            }
+            break;
+        }
         // ── Keys ───────────────────────────────────────────────────────────────
         case 'pressKey': {
             const keyName = val.toUpperCase();

package/dist/drivers/ios.js

@@ -168,6 +168,11 @@ class IOSDriver {
             await promises_1.default.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
         }
     }
+    async uninstallApp(bundleId) {
+        const deviceId = this.requireDeviceId();
+        await this.simctl(['terminate', deviceId, bundleId]).catch(() => { });
+        await this.simctl(['uninstall', deviceId, bundleId]);
+    }
     async clearKeychain() {
         const deviceId = this.requireDeviceId();
         await this.simctl(['keychain', deviceId, 'reset']);

package/dist/index.js

@@ -9,6 +9,8 @@ const verbose_js_1 = require("./verbose.js");
 const list_devices_js_1 = require("./commands/list-devices.js");
 const launch_app_js_1 = require("./commands/launch-app.js");
 const stop_app_js_1 = require("./commands/stop-app.js");
+const clear_state_js_1 = require("./commands/clear-state.js");
+const uninstall_app_js_1 = require("./commands/uninstall-app.js");
 const tap_js_1 = require("./commands/tap.js");
 const type_js_1 = require("./commands/type.js");
 const back_js_1 = require("./commands/back.js");
@@ -48,6 +50,8 @@ const COMMAND_HELP = {
     'copy-app': copy_app_js_1.HELP,
     'launch-app': launch_app_js_1.HELP,
     'stop-app': stop_app_js_1.HELP,
+    'clear-state': clear_state_js_1.HELP,
+    'uninstall-app': uninstall_app_js_1.HELP,
     tap: tap_js_1.HELP,
     type: type_js_1.HELP,
     'erase-text': erase_text_js_1.HELP,
@@ -240,6 +244,16 @@ async function main() {
             exitCode = await (0, stop_app_js_1.stopApp)(appId, opts, sessionName);
             break;
         }
+        case 'clear-state': {
+            const appId = rest[0];
+            exitCode = await (0, clear_state_js_1.clearState)(appId, opts, sessionName);
+            break;
+        }
+        case 'uninstall-app': {
+            const appId = rest[0] ?? '';
+            exitCode = await (0, uninstall_app_js_1.uninstallApp)(appId, opts, sessionName);
+            break;
+        }
         case 'tap': {
             const element = rest.join(' ');
             exitCode = await (0, tap_js_1.tap)(element, opts, sessionName, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houwert/conductor",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "CLI tool for mobile app interactions — optimized for AI agents",
   "license": "MIT",
   "repository": {

package/skills/conductor/SKILL.md

@@ -124,6 +124,28 @@ conductor stop-app com.example.myapp
 
 ---
 
+### `clear-state [<appId>]`
+
+Clear app data/state without relaunching. Uses the session `appId` if not specified. On iOS this terminates the app, preserves the .app bundle, uninstalls, and reinstalls (clearing all user data). On Android this runs `pm clear`.
+
+```bash
+conductor clear-state
+conductor clear-state com.example.myapp
+```
+
+---
+
+### `uninstall-app <appId>`
+
+Uninstall an app from the device. The app ID is required.
+
+```bash
+conductor uninstall-app com.example.myapp
+conductor uninstall-app com.example.myapp --device emulator-5554
+```
+
+---
+
 ### `tap <element>`
 
 Tap a UI element by its text label or accessibility ID. **Try the most obvious text label or ID first** — e.g. `"Sign In"`, `"Submit"`, `"btn_login"`. Only run `inspect` to look up the exact identifier if your first attempt fails. **For icon-only buttons (no visible text label), always run `inspect` first** to find the accessibility ID before tapping.

package/skills/conductor/references/flow-syntax.md

@@ -26,6 +26,8 @@ appId: com.example.myapp
     appId: com.other.app
 - clearState               # clear app data
 - clearKeychain            # clear keychain (iOS: full keychain; Android: account credentials)
+- uninstallApp             # uninstall app from device
+- uninstallApp: com.other.app  # uninstall a specific app
 ```
 
 ### Tapping