@autenai/sdk 0.3.0 → 0.5.0

package/README.md

@@ -0,0 +1,154 @@
+# auten
+
+Programmatic control of Android phones through the Auten relay.
+
+```bash
+npm install @autenai/sdk
+```
+
+Or install the CLI globally:
+
+```bash
+npm install -g @autenai/sdk
+auten login
+```
+
+## Quickstart
+
+### 1. Get a key
+
+Sign up at https://auten.ai (or contact the operator of your relay) to receive an API key.
+
+### 2. Save it
+
+```bash
+$ auten login
+Relay base URL [https://relay.auten.ai]:
+API key: ********************************
+  ✓ Authenticated as my-team — 1 device(s), 0 task(s).
+  ✓ Saved to ~/.autenrc
+```
+
+The CLI also reads `AUTEN_API_KEY` and `AUTEN_BASE_URL` from the environment, so you don't need `.autenrc` in CI.
+
+### 3. Send a task
+
+```bash
+$ auten devices
+STATUS  SERIAL            MODEL     SCREEN     LASTSEEN
+──────  ────────────────  ────────  ─────────  ───────────────────
+online  a4e0eff201d020fd  SM-A556B  1080x2116  2026-05-04 09:00:00
+
+$ auten task --speed lightning "open the calculator and compute 999÷3"
+auten task
+Phone:  a4e0eff201d020fd
+Speed:  lightning
+Prompt: open the calculator and compute 999÷3
+
+  ✓ Task 0f3789ec-68b1-4322-9fe2-15b33dfd8dc6 dispatched.
+  → Live: https://relay.auten.ai/w/a4e0eff201d020fd?t=...
+  → status: running
+  → status: completed
+
+  ✓ done (10992ms, $0.0308) — Calculator displays 333.
+```
+
+## SDK
+
+```ts
+import { Auten } from "@autenai/sdk";
+
+const auten = new Auten({ apiKey: process.env.AUTEN_API_KEY! });
+
+// Identity & devices
+const me = await auten.me();
+const devices = await auten.devices.list();
+
+// Run a task and wait for the result
+const result = await auten.tasks.run({
+  device: devices[0].serial,
+  prompt: "open instagram, scroll the feed for 30 seconds",
+  speed: "lightning",
+});
+console.log(result.status, result.verified, result.result?.summary);
+
+// Or fire-and-forget + poll later
+const { task_id } = await auten.tasks.create({ device, prompt });
+const final = await auten.tasks.wait(task_id);
+
+// Direct phone control
+const phone = auten.phone(devices[0].serial);
+const screen = await phone.look();      // SoM screenshot + element list
+await phone.tap(500, 800);
+await phone.type("hello", { x: 540, y: 700 });
+await phone.openUrl("https://news.tv3.lt");
+```
+
+## Per-device credentials
+
+Login data is encrypted server-side and only ever decrypted into the agent's
+runtime when it actually needs to fill a form.
+
+```bash
+$ auten creds add --device a4e0eff... --service instagram \
+    --username myaccount --password secret
+$ auten creds ls --device a4e0eff...
+$ auten creds rm --device a4e0eff... instagram
+```
+
+From code:
+
+```ts
+const phone = auten.phone(serial);
+await phone.credentials.save({ service: "instagram", username: "x", password: "y" });
+const list = await phone.credentials.list();
+```
+
+## API keys
+
+```bash
+$ auten keys                               # list yours
+$ auten keys create laptop                 # mint a new key
+  ✓ Key created.
+    sk_live_abcdef0123456789...            # printed once
+    Save this key now — it will never be shown again.
+$ auten keys revoke <id>                   # disable instantly
+```
+
+## Speed presets
+
+`--speed` controls every artificial delay during replay:
+
+| preset      | settle | post-action | look-after-each |
+|-------------|--------|-------------|-----------------|
+| `fast`      | 250ms  | 350ms       | yes (default)   |
+| `instant`   | 50ms   | 100ms       | yes             |
+| `lightning` | 10ms   | 30ms        | no (skipped)    |
+
+`lightning` is the fastest but skips per-action verification — only use it for
+flows that have already been verified once at `fast`.
+
+## Configuration
+
+```
+AUTEN_API_KEY        Your key (can be set in ~/.autenrc instead)
+AUTEN_BASE_URL       Relay URL — default https://relay.auten.ai
+```
+
+## Errors
+
+```ts
+import { AuthError, ApiError, DeviceOfflineError } from "@autenai/sdk";
+
+try {
+  await auten.tasks.create({ device, prompt });
+} catch (err) {
+  if (err instanceof DeviceOfflineError) /* phone disconnected from WS */;
+  if (err instanceof AuthError)          /* bad / revoked key */;
+  if (err instanceof ApiError && err.status >= 500) /* relay error */;
+}
+```
+
+## License
+
+MIT

package/bin/auten.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/cli/index.js');

package/dist/cli/add-phone.d.ts

@@ -0,0 +1,2 @@
+export declare function addPhoneCommand(): Promise<void>;
+//# sourceMappingURL=add-phone.d.ts.map

package/dist/cli/add-phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-phone.d.ts","sourceRoot":"","sources":["../../cli/add-phone.ts"],"names":[],"mappings":"AA6IA,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAkGrD"}

package/dist/cli/add-phone.js

@@ -0,0 +1,254 @@
+/**
+ * Walk the user through adding a new phone:
+ *   USB plug-in → ADB authorization → APK install → service config → WS verify.
+ *
+ * Uses the SDK to verify the WS connection appears against the relay.
+ */
+import { execFileSync } from "child_process";
+import { existsSync, statSync } from "fs";
+import { resolve } from "path";
+import { homedir } from "os";
+import { Auten } from "../src/index.js";
+import { C, banner, step, ok, warn, info, fail, sleep, loadConfig } from "./util.js";
+const PACKAGE = "com.sce.agent";
+function adb(args, timeoutMs = 10_000) {
+    return execFileSync("adb", args, { encoding: "utf-8", timeout: timeoutMs }).trim();
+}
+function adbDevices() {
+    return adb(["devices"]).split("\n").slice(1)
+        .map(l => l.trim()).filter(Boolean)
+        .map(l => { const [serial, status] = l.split(/\s+/); return { serial, status }; });
+}
+function getDeviceInfo(serial) {
+    const prop = (k) => adb(["-s", serial, "shell", "getprop", k]).trim();
+    const model = prop("ro.product.model");
+    const androidVersion = prop("ro.build.version.release");
+    const sizeOut = adb(["-s", serial, "shell", "wm", "size"]);
+    const m = sizeOut.match(/(\d+)x(\d+)/);
+    const ipOut = adb(["-s", serial, "shell", "ip", "route"]);
+    const ipLine = ipOut.split("\n").find(l => l.includes("wlan0") && l.includes("src")) || "";
+    const tokens = ipLine.split(/\s+/);
+    const srcIdx = tokens.indexOf("src");
+    return {
+        serial,
+        model,
+        androidVersion,
+        screenWidth: m ? parseInt(m[1], 10) : 0,
+        screenHeight: m ? parseInt(m[2], 10) : 0,
+        wifiIp: srcIdx >= 0 && tokens[srcIdx + 1] ? tokens[srcIdx + 1] : "",
+    };
+}
+function findApk() {
+    const candidates = [
+        process.env.APK_PATH,
+        resolve(process.cwd(), "../mobile-agent-apk/app/build/outputs/apk/debug/app-debug.apk"),
+        resolve(process.cwd(), "mobile-agent-apk/app/build/outputs/apk/debug/app-debug.apk"),
+        resolve(homedir(), ".sce-agent/apk/app-debug.apk"),
+    ].filter(Boolean);
+    return candidates.find(p => existsSync(p)) || null;
+}
+function installApk(serial, apkPath) {
+    try {
+        const out = execFileSync("adb", ["-s", serial, "install", "-r", apkPath], { encoding: "utf-8", timeout: 120_000 });
+        if (out.includes("Success"))
+            return { ok: true };
+        return { ok: false, reinstallNeeded: false, error: out };
+    }
+    catch (err) {
+        const e = err;
+        const msg = String(e.stderr || e.stdout || e.message || "");
+        if (msg.includes("INSTALL_FAILED_UPDATE_INCOMPATIBLE") || msg.includes("signatures do not match")) {
+            return { ok: false, reinstallNeeded: true, error: msg };
+        }
+        return { ok: false, reinstallNeeded: false, error: msg };
+    }
+}
+function configureServices(serial) {
+    adb(["-s", serial, "shell", "settings", "put", "secure", "enabled_accessibility_services",
+        `${PACKAGE}/${PACKAGE}.AgentAccessibilityService`]);
+    adb(["-s", serial, "shell", "settings", "put", "secure", "accessibility_enabled", "1"]);
+    adb(["-s", serial, "shell", "ime", "enable", `${PACKAGE}/.AgentIME`]);
+    adb(["-s", serial, "shell", "ime", "set", `${PACKAGE}/.AgentIME`]);
+    // Disable factory keyboards so they can't reclaim the default IME slot —
+    // AgentIME is headless and draws no UI; if any of these were active the
+    // user would still see a real keyboard pop up on EditText focus.
+    for (const kb of ["com.samsung.android.honeyboard", "com.google.android.inputmethod.latin", "com.touchtype.swiftkey"]) {
+        try {
+            adb(["-s", serial, "shell", "ime", "disable", kb]);
+        }
+        catch { }
+    }
+    for (const perm of ["android.permission.WRITE_EXTERNAL_STORAGE", "android.permission.READ_EXTERNAL_STORAGE"]) {
+        try {
+            adb(["-s", serial, "shell", "pm", "grant", PACKAGE, perm]);
+        }
+        catch { }
+    }
+}
+function forceRestartApk(serial) {
+    // Toggle accessibility off then on so Android rebinds the service after force-stop.
+    try {
+        adb(["-s", serial, "shell", "am", "force-stop", PACKAGE]);
+    }
+    catch { }
+    adb(["-s", serial, "shell", "settings", "put", "secure", "accessibility_enabled", "0"]);
+    adb(["-s", serial, "shell", "settings", "put", "secure", "enabled_accessibility_services",
+        `${PACKAGE}/${PACKAGE}.AgentAccessibilityService`]);
+    adb(["-s", serial, "shell", "settings", "put", "secure", "accessibility_enabled", "1"]);
+}
+async function waitForDevice() {
+    let prompted = false;
+    while (true) {
+        const devs = adbDevices();
+        if (devs.length === 0) {
+            if (!prompted) {
+                warn("No phone detected.");
+                info("Plug in the phone via USB.");
+                info("Settings → About phone → tap 'Build number' 7 times to unlock Developer options.");
+                info("Settings → Developer options → enable 'USB debugging'.");
+                info("Waiting...");
+                prompted = true;
+            }
+        }
+        else if (devs.length > 1) {
+            fail(`Multiple phones detected: ${devs.map(d => d.serial).join(", ")}`);
+            fail("Connect only one phone at a time.");
+            process.exit(1);
+        }
+        else {
+            return devs[0];
+        }
+        await sleep(2000);
+    }
+}
+async function waitForAuthorization(serial) {
+    let prompted = false;
+    while (true) {
+        const d = adbDevices().find(x => x.serial === serial);
+        if (!d)
+            throw new Error(`Phone ${serial} disconnected.`);
+        if (d.status === "device")
+            return;
+        if (d.status === "unauthorized" && !prompted) {
+            warn("Authorization required.");
+            info("Unlock the phone, accept the 'Allow USB debugging' dialog, check 'Always allow'.");
+            info("Waiting...");
+            prompted = true;
+        }
+        else if (d.status !== "unauthorized" && d.status !== "device") {
+            fail(`Phone state '${d.status}' — try replugging USB.`);
+            process.exit(1);
+        }
+        await sleep(2000);
+    }
+}
+export async function addPhoneCommand() {
+    const cfg = loadConfig();
+    banner("═════════════════════════════════════");
+    banner("  auten — Add Phone");
+    banner("═════════════════════════════════════");
+    console.log(`${C.dim}Relay: ${cfg.baseUrl}${C.reset}`);
+    try {
+        execFileSync("adb", ["version"], { encoding: "utf-8", timeout: 3000 });
+    }
+    catch {
+        fail("`adb` not found. Install Android platform-tools.");
+        process.exit(1);
+    }
+    const apkPath = findApk();
+    if (!apkPath) {
+        fail("APK not found.");
+        info("Build it first: `auten build-apk`");
+        info("Or set APK_PATH=/path/to/app-debug.apk");
+        process.exit(1);
+    }
+    const apkAge = (Date.now() - statSync(apkPath).mtimeMs) / 1000 / 86400;
+    if (apkAge > 30)
+        warn(`APK is ${apkAge.toFixed(0)} days old — consider rebuilding (auten build-apk).`);
+    step(1, 6, "Detect connected phone");
+    const dev = await waitForDevice();
+    ok(`Phone detected: ${dev.serial}`);
+    step(2, 6, "Authorize USB debugging");
+    if (dev.status === "device")
+        ok("Already authorized.");
+    else {
+        await waitForAuthorization(dev.serial);
+        ok("Authorized.");
+    }
+    step(3, 6, "Read device info");
+    const dInfo = getDeviceInfo(dev.serial);
+    ok(`Model: ${dInfo.model} (Android ${dInfo.androidVersion})`);
+    ok(`Screen: ${dInfo.screenWidth}x${dInfo.screenHeight}`);
+    if (dInfo.wifiIp)
+        ok(`WiFi IP: ${dInfo.wifiIp}`);
+    else
+        warn("No WiFi IP detected — connect the phone to WiFi for the agent to reach the relay.");
+    step(4, 6, "Install APK");
+    let installResult = installApk(dev.serial, apkPath);
+    if (!installResult.ok && installResult.reinstallNeeded) {
+        warn("Existing install was signed with a different key — uninstalling and reinstalling.");
+        warn("Any data inside the SCE Agent app will be wiped.");
+        try {
+            adb(["-s", dev.serial, "uninstall", PACKAGE]);
+        }
+        catch { }
+        installResult = installApk(dev.serial, apkPath);
+    }
+    if (!installResult.ok) {
+        fail(`Install failed: ${installResult.error?.slice(0, 300)}`);
+        process.exit(1);
+    }
+    ok("APK installed.");
+    step(5, 6, "Enable accessibility, IME, permissions");
+    configureServices(dev.serial);
+    forceRestartApk(dev.serial);
+    ok("Services configured. APK restarted.");
+    step(6, 6, "Verify WS connection to relay");
+    info(`Polling ${cfg.baseUrl}/v1/devices for an online device matching '${dInfo.model}'...`);
+    const agent = new Auten(cfg);
+    const deadline = Date.now() + 60_000;
+    let online = null;
+    while (Date.now() < deadline) {
+        try {
+            const list = await agent.devices.list();
+            const candidate = list.find(d => d.online && d.model === dInfo.model);
+            if (candidate) {
+                online = { serial: candidate.serial };
+                break;
+            }
+        }
+        catch (err) {
+            info(`Relay query failed: ${err.message} — retrying...`);
+        }
+        await sleep(2000);
+    }
+    if (!online) {
+        fail("Phone did not appear online via WS within 60s.");
+        info("On phone: Settings → Accessibility → Auten Agent must be enabled.");
+        info("If accessibility is on but no WS: rebuild APK with the current relay URL via `auten build-apk`.");
+        process.exit(1);
+    }
+    ok(`Phone online: ${online.serial}`);
+    info("Round-tripping /look to confirm end-to-end flow...");
+    try {
+        const phone = agent.phone(online.serial);
+        const look = await phone.look();
+        ok(`/look returned ${look.elements.length} elements, ~${Math.round(look.annotated.length * 0.75 / 1024)} KB JPEG. End-to-end working.`);
+    }
+    catch (err) {
+        warn(`/look round-trip failed: ${err.message}`);
+        warn("WS connection is up but the phone could not return a screenshot. Investigate manually.");
+    }
+    console.log("");
+    banner("═════════════════════════════════════");
+    banner("  ✓ Phone ready — disconnect USB now");
+    banner("═════════════════════════════════════");
+    console.log("");
+    console.log(`  Device serial:   ${C.bold}${online.serial}${C.reset}`);
+    console.log(`  Model:           ${dInfo.model}`);
+    console.log(`  Relay:           ${cfg.baseUrl}`);
+    console.log("");
+    console.log(`  ${C.dim}The phone keeps its WS connection over WiFi as long as the SCE Agent app is alive.${C.reset}`);
+    console.log("");
+}
+//# sourceMappingURL=add-phone.js.map

package/dist/cli/add-phone.js.map

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

package/dist/cli/autocomplete.d.ts

@@ -0,0 +1,31 @@
+export interface Suggestion {
+    name: string;
+    desc: string;
+}
+interface ReadOptions {
+    prompt: string;
+    /**
+     * Computes the suggestions to show beneath the prompt for the current input.
+     * Returning [] means no dropdown is visible.
+     */
+    suggest: (line: string) => Suggestion[];
+    /** Older-first list of past entries. Up/Down recall them when no dropdown is visible. */
+    history?: string[];
+    maxVisible?: number;
+}
+export declare function readLineWithSuggestions(opts: ReadOptions): Promise<string | null>;
+/**
+ * Render a list and let the user navigate it with arrow keys; Enter returns
+ * the selected index, ESC/Ctrl+C returns null. The list stays on screen after
+ * selection so the user can see what they picked.
+ */
+export interface ListPickerOpts<T> {
+    items: T[];
+    render: (item: T, isSelected: boolean) => string;
+    header?: string;
+    footer?: string;
+    initialIndex?: number;
+}
+export declare function selectFromList<T>(opts: ListPickerOpts<T>): Promise<number | null>;
+export {};
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/cli/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../cli/autocomplete.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;IACxC,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiQvF;AAkED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,OAAO,KAAK,MAAM,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoEvF"}