swipium 1.0.0

package/dist/lib/android.js

@@ -0,0 +1,278 @@
+// Thin adb/emulator helpers used by qa_doctor and DirectDriver.
+import { spawn } from 'node:child_process';
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { run } from './spawn.js';
+const MIN_APK_BYTES = 1024 * 1024;
+export function androidHome() {
+    return process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT || join(homedir(), 'Library/Android/sdk');
+}
+export function findAapt2() {
+    const bt = join(androidHome(), 'build-tools');
+    if (!existsSync(bt))
+        return null;
+    for (const v of readdirSync(bt).sort().reverse()) {
+        const p = join(bt, v, 'aapt2');
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/** Extract the applicationId from an APK via aapt2 badging. */
+export async function apkPackageId(apk) {
+    const aapt2 = findAapt2();
+    if (!aapt2)
+        return null;
+    try {
+        const r = await run(aapt2, ['dump', 'badging', apk], { timeoutMs: 30000 });
+        return r.stdout.match(/package: name='([^']+)'/)?.[1] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Explicit path, else newest usable (>1MB) .apk under projectRoot or projectRoot/apps/android. */
+export function resolveApk(projectRoot, explicit) {
+    if (explicit && explicit.trim()) {
+        const p = explicit.trim();
+        if (!existsSync(p))
+            return { error: `APK not found: ${p}` };
+        if (statSync(p).size < MIN_APK_BYTES)
+            return { error: `APK looks like an LFS pointer (<1MB): ${p}` };
+        return { apk: p };
+    }
+    let best;
+    for (const dir of [projectRoot, join(projectRoot, 'apps', 'android')]) {
+        if (!existsSync(dir))
+            continue;
+        for (const f of readdirSync(dir)) {
+            if (!f.toLowerCase().endsWith('.apk'))
+                continue;
+            const p = join(dir, f);
+            const s = statSync(p);
+            if (s.size >= MIN_APK_BYTES && (!best || s.mtimeMs > best.m))
+                best = { p, m: s.mtimeMs };
+        }
+    }
+    return best ? { apk: best.p } : { error: `No usable APK (>1MB) under ${projectRoot} or apps/android. Pass apk explicitly.` };
+}
+/**
+ * Boot an AVD headless. Returns the ChildProcess so the caller can `kill()` it on cancel.
+ * We `unref()` it so a running emulator does NOT keep the MCP process alive after the
+ * client disconnects (unref does not prevent kill — the caller still holds the handle).
+ * `detached:true` + `stdio:'ignore'` so it survives an intentional server exit as an
+ * orphan rather than being torn down mid-run. NOTE: deliberate session/shutdown teardown
+ * (track + kill booted emulators on session-close) is a follow-up lifecycle pass.
+ */
+export function bootEmulator(avd, headless = true) {
+    const args = ['-avd', avd, '-no-audio', '-no-snapshot', '-no-boot-anim', '-gpu', 'swiftshader_indirect'];
+    if (headless)
+        args.push('-no-window'); // omit for a visible window (local supervised QA)
+    const child = spawn('emulator', args, { detached: true, stdio: 'ignore' });
+    child.unref();
+    return child;
+}
+/** Free bytes on the device /data partition (parsed from `df`), or null. */
+export async function deviceFreeDataBytes(serial) {
+    try {
+        const r = await run('adb', ['-s', serial, 'shell', 'df', '/data'], { timeoutMs: 8000 });
+        const lines = r.stdout.trim().split('\n').filter(Boolean);
+        const data = lines[lines.length - 1]; // the mount row
+        const cols = data.trim().split(/\s+/);
+        // Filesystem  1K-blocks  Used  Available  Use%  Mounted  → Available is index 3
+        const availKb = Number(cols[3]);
+        return Number.isFinite(availKb) ? availKb * 1024 : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Device supported ABIs (ro.product.cpu.abilist). */
+export async function deviceAbis(serial) {
+    try {
+        const r = await run('adb', ['-s', serial, 'shell', 'getprop', 'ro.product.cpu.abilist'], { timeoutMs: 5000 });
+        return r.stdout.trim().split(',').map((s) => s.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** PURE: parse `aapt2 dump badging` stdout into structured metadata (testable without aapt2). */
+export function parseAaptBadging(stdout) {
+    const pkg = stdout.match(/package: name='([^']+)'/);
+    const vCode = stdout.match(/versionCode='(\d+)'/);
+    const vName = stdout.match(/versionName='([^']*)'/);
+    const minSdk = stdout.match(/sdkVersion:'(\d+)'/);
+    const nativeLine = stdout.match(/native-code:\s*(.*)/);
+    const abis = nativeLine ? [...nativeLine[1].matchAll(/'([^']+)'/g)].map((x) => x[1]) : [];
+    return {
+        packageId: pkg?.[1] ?? null,
+        versionName: vName?.[1] ?? null,
+        versionCode: vCode ? Number(vCode[1]) : null,
+        minSdk: minSdk ? Number(minSdk[1]) : null,
+        abis,
+    };
+}
+/** Full APK metadata in a SINGLE aapt2 call (packageId + versionName/Code + minSdk + ABIs). */
+export async function apkBadging(apk) {
+    const aapt2 = findAapt2();
+    if (!aapt2)
+        return null;
+    try {
+        const r = await run(aapt2, ['dump', 'badging', apk], { timeoutMs: 30000 });
+        return parseAaptBadging(r.stdout);
+    }
+    catch {
+        return null;
+    }
+}
+/** APK minSdkVersion via aapt2 badging (null when aapt2/the field is unavailable). */
+export async function apkMinSdk(apk) {
+    const aapt2 = findAapt2();
+    if (!aapt2)
+        return null;
+    try {
+        const r = await run(aapt2, ['dump', 'badging', apk], { timeoutMs: 30000 });
+        const m = r.stdout.match(/sdkVersion:'(\d+)'/);
+        return m ? Number(m[1]) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Device API level (ro.build.version.sdk), or null. */
+export async function deviceSdk(serial) {
+    try {
+        const r = await run('adb', ['-s', serial, 'shell', 'getprop', 'ro.build.version.sdk'], { timeoutMs: 5000 });
+        const n = Number(r.stdout.trim());
+        return Number.isFinite(n) && n > 0 ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** PURE: is an APK's minSdk satisfied by a device API level? Unknown values → compatible (don't block on missing info). */
+export function minSdkCompatible(apkMinSdk, deviceApiLevel) {
+    if (apkMinSdk == null || deviceApiLevel == null)
+        return true;
+    return deviceApiLevel >= apkMinSdk;
+}
+/**
+ * PURE: classify a failed `adb install` into a typed blocker. adb reports a `Failure [REASON]`
+ * token (or a human message) on the stderr that `run()` folds into the thrown Error message.
+ * Mapping these lets prepareAndroid say WHO must fix it instead of a generic launch failure.
+ */
+export function classifyAndroidInstallError(message) {
+    const m = message;
+    if (/INSTALL_FAILED_UPDATE_INCOMPATIBLE|INCONSISTENT_CERTIFICATES|signatures do not match|INSTALL_FAILED_SHARED_USER_INCOMPATIBLE|DUPLICATE_PACKAGE/i.test(m))
+        return 'ANDROID_SIGNATURE_CONFLICT';
+    if (/INSTALL_FAILED_VERSION_DOWNGRADE|INSTALL_FAILED_OLDER_SDK|INSTALL_FAILED_DEPRECATED_SDK_VERSION|requires (?:a )?newer (?:sdk|version)|requires .*API level/i.test(m))
+        return 'ANDROID_MIN_SDK_INCOMPATIBLE';
+    if (/INSTALL_FAILED_NO_MATCHING_ABIS|no matching abis|INSTALL_FAILED_CPU_ABI_INCOMPATIBLE/i.test(m))
+        return 'APK_ARCH_INCOMPATIBLE';
+    if (/INSTALL_FAILED_INSUFFICIENT_STORAGE|not enough space|no space left/i.test(m))
+        return 'INSTALL_FAILED';
+    return 'INSTALL_FAILED';
+}
+/** Native ABIs an APK ships (empty = pure/no native code → installs on any ABI). */
+export async function apkNativeAbis(apk) {
+    const aapt2 = findAapt2();
+    if (!aapt2)
+        return [];
+    try {
+        const r = await run(aapt2, ['dump', 'badging', apk], { timeoutMs: 30000 });
+        const m = r.stdout.match(/native-code:\s*(.*)/);
+        if (!m)
+            return [];
+        return [...m[1].matchAll(/'([^']+)'/g)].map((x) => x[1]);
+    }
+    catch {
+        return [];
+    }
+}
+export function fmtBytes(n) {
+    if (n == null)
+        return 'unknown';
+    const u = ['B', 'KB', 'MB', 'GB'];
+    let i = 0;
+    let v = n;
+    while (v >= 1024 && i < u.length - 1) {
+        v /= 1024;
+        i++;
+    }
+    return `${v.toFixed(1)} ${u[i]}`;
+}
+/** Wait until sys.boot_completed === 1 (or timeout). */
+export async function waitForBoot(serial, timeoutMs = 180000) {
+    const deadline = Date.now() + timeoutMs;
+    try {
+        await run('adb', ['-s', serial, 'wait-for-device'], { timeoutMs });
+    }
+    catch {
+        /* keep polling below */
+    }
+    while (Date.now() < deadline) {
+        try {
+            const r = await run('adb', ['-s', serial, 'shell', 'getprop', 'sys.boot_completed'], { timeoutMs: 5000 });
+            if (r.stdout.trim() === '1')
+                return true;
+        }
+        catch {
+            /* not up yet */
+        }
+        await new Promise((res) => setTimeout(res, 2000));
+    }
+    return false;
+}
+export async function which(bin) {
+    const finder = process.platform === 'win32' ? 'where' : 'which';
+    try {
+        const r = await run(finder, [bin], { timeoutMs: 5000 });
+        return r.code === 0 && r.stdout.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export async function firstLine(bin, args) {
+    try {
+        const r = await run(bin, args, { timeoutMs: 8000 });
+        if (r.code !== 0)
+            return null;
+        return (r.stdout || r.stderr).split('\n')[0]?.trim() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Online device/emulator serials (state === "device"). */
+export async function adbDevices() {
+    try {
+        const r = await run('adb', ['devices'], { timeoutMs: 10000 });
+        return r.stdout
+            .split('\n')
+            .slice(1)
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && l.endsWith('device'))
+            .map((l) => l.split(/\s+/)[0]);
+    }
+    catch {
+        return [];
+    }
+}
+export async function listAvds() {
+    try {
+        const r = await run('emulator', ['-list-avds'], { timeoutMs: 10000 });
+        if (r.code !== 0)
+            return [];
+        return r.stdout
+            .split('\n')
+            .map((s) => s.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=android.js.map

package/dist/lib/android.js.map

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

package/dist/lib/commandTemplate.js

@@ -0,0 +1,55 @@
+export function displayArgv(argv) {
+    return argv.map((arg) => (/^[A-Za-z0-9_/:=.,@%+-]+$/.test(arg) ? arg : JSON.stringify(arg))).join(' ');
+}
+export function shellSplit(input) {
+    const out = [];
+    let cur = '';
+    let quote = null;
+    let escape = false;
+    for (const ch of input) {
+        if (escape) {
+            cur += ch;
+            escape = false;
+            continue;
+        }
+        if (ch === '\\' && quote !== "'") {
+            escape = true;
+            continue;
+        }
+        if (quote) {
+            if (ch === quote)
+                quote = null;
+            else
+                cur += ch;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            quote = ch;
+            continue;
+        }
+        if (/\s/.test(ch)) {
+            if (cur) {
+                out.push(cur);
+                cur = '';
+            }
+            continue;
+        }
+        cur += ch;
+    }
+    if (escape)
+        cur += '\\';
+    if (quote)
+        throw new Error(`Unclosed ${quote} quote in command template`);
+    if (cur)
+        out.push(cur);
+    return out;
+}
+export function resolveCommandTemplate(template, vars) {
+    const parts = Array.isArray(template) ? template : shellSplit(template);
+    if (!parts.length || !parts[0])
+        throw new Error('Command template is empty');
+    const replace = (value) => value.replace(/\{([a-zA-Z0-9_]+)\}/g, (m, key) => vars[key] ?? m);
+    const argv = parts.map(replace);
+    return { command: argv[0], args: argv.slice(1), argv, deprecatedString: !Array.isArray(template) };
+}
+//# sourceMappingURL=commandTemplate.js.map

package/dist/lib/commandTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandTemplate.js","sourceRoot":"","sources":["../../src/lib/commandTemplate.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzG,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAqB,IAAI,CAAC;IACnC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,IAAI,EAAE,CAAC;YACV,MAAM,GAAG,KAAK,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;YACjC,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACX,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,EAAE,KAAK,KAAK;gBAAE,KAAK,GAAG,IAAI,CAAC;;gBAC1B,GAAG,IAAI,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,KAAK,GAAG,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACd,GAAG,GAAG,EAAE,CAAC;YACX,CAAC;YACD,SAAS;QACX,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,MAAM;QAAE,GAAG,IAAI,IAAI,CAAC;IACxB,IAAI,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,KAAK,4BAA4B,CAAC,CAAC;IAC1E,IAAI,GAAG;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAyB,EAAE,IAA4B;IAC5F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7G,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;AACrG,CAAC"}

package/dist/lib/coordSpace.js

@@ -0,0 +1,23 @@
+// Coordinate-convention audit (PHASE3-PLAN §8.1). The vision-MCP audit found that visual tools
+// returning coordinates WITHOUT declaring their space cause wrong taps. So every visual result
+// self-describes: screenshot vs device pixels, the scale between them, density, orientation, and
+// origin. An agent (or our own tools) can then convert a screenshot-space hit into a device-space
+// tap correctly instead of guessing.
+import { pngSize } from './png.js';
+import { getOrientation } from './device.js';
+/** Assemble the coordinate space for a screenshot buffer using the driver's device metrics. */
+export async function captureCoordinateSpace(driver, screenshotBuf) {
+    const shot = pngSize(screenshotBuf);
+    const [device, density] = await Promise.all([driver.screenSize().catch(() => null), driver.screenDensity().catch(() => null)]);
+    const serial = driver.currentDevice();
+    const o = serial ? await getOrientation(serial).catch(() => null) : null;
+    const orientation = o ? (o.rotation === 1 || o.rotation === 3 ? 'landscape' : 'portrait') : 'unknown';
+    const scale = shot && device && device.width ? Math.round((shot.width / device.width) * 1000) / 1000 : null;
+    return { origin: 'top-left', screenshot: shot, device, density, scale, orientation };
+}
+/** Convert a screenshot-space point to device (tap) pixels using the scale. */
+export function toDevicePoint(cs, x, y) {
+    const s = cs.scale && cs.scale !== 0 ? cs.scale : 1;
+    return { x: Math.round(x / s), y: Math.round(y / s) };
+}
+//# sourceMappingURL=coordSpace.js.map

package/dist/lib/coordSpace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordSpace.js","sourceRoot":"","sources":["../../src/lib/coordSpace.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,+FAA+F;AAC/F,iGAAiG;AACjG,kGAAkG;AAClG,qCAAqC;AAErC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAY7C,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAc,EAAE,aAAqB;IAChF,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/H,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;IACtC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,MAAM,WAAW,GAAmC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtI,MAAM,KAAK,GAAG,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5G,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACvF,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,EAAmB,EAAE,CAAS,EAAE,CAAS;IACrE,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AACxD,CAAC"}

package/dist/lib/device.js

@@ -0,0 +1,87 @@
+// Device-parity adb helpers (PHASE3-PLAN §4.2 / roadmap §5). Serial-based (Android/adb-specific)
+// rather than on the Driver interface, so the iOS/native-backend swap seam stays lean — when iOS
+// lands it provides its own device-parity implementations. All spawns use arg arrays (injection-safe).
+import { run } from './spawn.js';
+/** One `getprop` dump, parsed into the props we surface. */
+export async function getDeviceProps(serial) {
+    const get = (out, key) => out.match(new RegExp(`\\[${key.replace(/\./g, '\\.')}\\]:\\s*\\[([^\\]]*)\\]`))?.[1] ?? null;
+    try {
+        const r = await run('adb', ['-s', serial, 'shell', 'getprop'], { timeoutMs: 8000 });
+        const o = r.stdout;
+        return {
+            model: get(o, 'ro.product.model'),
+            manufacturer: get(o, 'ro.product.manufacturer'),
+            sdk: get(o, 'ro.build.version.sdk'),
+            release: get(o, 'ro.build.version.release'),
+            abis: (get(o, 'ro.product.cpu.abilist') ?? '').split(',').map((s) => s.trim()).filter(Boolean),
+            locale: get(o, 'persist.sys.locale') ?? get(o, 'ro.product.locale'),
+            timezone: get(o, 'persist.sys.timezone'),
+        };
+    }
+    catch {
+        return { model: null, manufacturer: null, sdk: null, release: null, abis: [], locale: null, timezone: null };
+    }
+}
+/** Current rotation 0..3 (0/2 portrait, 1/3 landscape) and whether auto-rotate is on. */
+export async function getOrientation(serial) {
+    try {
+        const rot = await run('adb', ['-s', serial, 'shell', 'settings', 'get', 'system', 'user_rotation'], { timeoutMs: 5000 });
+        const acc = await run('adb', ['-s', serial, 'shell', 'settings', 'get', 'system', 'accelerometer_rotation'], { timeoutMs: 5000 });
+        const rotation = Number(rot.stdout.trim());
+        return { rotation: Number.isFinite(rotation) ? rotation : 0, auto: acc.stdout.trim() === '1' };
+    }
+    catch {
+        return null;
+    }
+}
+export async function setOrientation(serial, o) {
+    if (o === 'auto') {
+        await run('adb', ['-s', serial, 'shell', 'settings', 'put', 'system', 'accelerometer_rotation', '1'], { timeoutMs: 5000, rejectOnNonZero: true });
+        return;
+    }
+    // fixed orientation: disable auto-rotate, then pin user_rotation (0=portrait, 1=landscape).
+    await run('adb', ['-s', serial, 'shell', 'settings', 'put', 'system', 'accelerometer_rotation', '0'], { timeoutMs: 5000, rejectOnNonZero: true });
+    await run('adb', ['-s', serial, 'shell', 'settings', 'put', 'system', 'user_rotation', o === 'landscape' ? '1' : '0'], { timeoutMs: 5000, rejectOnNonZero: true });
+}
+/** Installed packages (optionally third-party only / name-filtered). */
+export async function listPackages(serial, opts = {}) {
+    const args = ['-s', serial, 'shell', 'pm', 'list', 'packages'];
+    if (opts.thirdPartyOnly)
+        args.push('-3');
+    if (opts.filter)
+        args.push(opts.filter);
+    try {
+        const r = await run('adb', args, { timeoutMs: 8000 });
+        return r.stdout.split('\n').map((l) => l.trim().replace(/^package:/, '')).filter(Boolean).sort();
+    }
+    catch {
+        return [];
+    }
+}
+/** Best-effort runtime-permission state for a package (parsed from dumpsys). */
+export async function listRuntimePermissions(serial, pkg) {
+    const granted = [];
+    const denied = [];
+    try {
+        const r = await run('adb', ['-s', serial, 'shell', 'dumpsys', 'package', pkg], { timeoutMs: 8000 });
+        for (const m of r.stdout.matchAll(/(android\.permission\.[A-Z_]+):\s*granted=(true|false)/g)) {
+            (m[2] === 'true' ? granted : denied).push(m[1]);
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+    return { granted, denied };
+}
+export async function grantPermission(serial, pkg, perm) {
+    await run('adb', ['-s', serial, 'shell', 'pm', 'grant', pkg, perm], { timeoutMs: 6000, rejectOnNonZero: true });
+}
+/** Spoof the device location via the emulator console (`emu geo fix <lon> <lat>`). Emulator-only. */
+export async function setGeo(serial, lat, lng) {
+    // arg order is longitude, then latitude.
+    await run('adb', ['-s', serial, 'emu', 'geo', 'fix', String(lng), String(lat)], { timeoutMs: 8000, rejectOnNonZero: true });
+}
+export async function revokePermission(serial, pkg, perm) {
+    await run('adb', ['-s', serial, 'shell', 'pm', 'revoke', pkg, perm], { timeoutMs: 6000, rejectOnNonZero: true });
+}
+//# sourceMappingURL=device.js.map

package/dist/lib/device.js.map

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

package/dist/lib/gitignore.js

@@ -0,0 +1,22 @@
+// Keep Swipium's generated artifacts out of the user's VCS. Both `swipium scan` and every
+// session (which writes .swipium/<id>/…) call this, so merely using Swipium never dirties a
+// developer's git tree. Idempotent; only touches a real git repo's .gitignore.
+import { existsSync, readFileSync, appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function ensureGitignored(root) {
+    try {
+        if (!existsSync(join(root, '.git')))
+            return 'not-a-repo';
+        const gi = join(root, '.gitignore');
+        const cur = existsSync(gi) ? readFileSync(gi, 'utf8') : '';
+        if (/^\s*\.swipium\/?\s*$/m.test(cur))
+            return 'present';
+        const prefix = cur.length && !cur.endsWith('\n') ? '\n' : '';
+        appendFileSync(gi, `${prefix}\n# Swipium QA artifacts (generated)\n.swipium/\n`);
+        return 'added';
+    }
+    catch {
+        return 'not-a-repo'; // best-effort; never block a scan/session on a gitignore write
+    }
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/lib/gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.js","sourceRoot":"","sources":["../../src/lib/gitignore.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,4FAA4F;AAC5F,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,YAAY,CAAC;QACzD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,cAAc,CAAC,EAAE,EAAE,GAAG,MAAM,mDAAmD,CAAC,CAAC;QACjF,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,YAAY,CAAC,CAAC,+DAA+D;IACtF,CAAC;AACH,CAAC"}

package/dist/lib/image.js

@@ -0,0 +1,97 @@
+// Local, deterministic visual ops (PHASE3-PLAN §8.2) — baseline diff + template matching on
+// decoded pixels. No AI, no network, no third-party code: just arithmetic over PNG bytes.
+import { decodePng, toGray } from './png.js';
+/** Per-pixel diff of two same-size screenshots. A pixel "changed" if any channel differs by > tol. */
+export function imageDiff(aBuf, bBuf, tol = 32) {
+    const a = decodePng(aBuf);
+    const b = decodePng(bBuf);
+    if (a.width !== b.width || a.height !== b.height) {
+        return { comparable: false, reason: `size mismatch ${a.width}x${a.height} vs ${b.width}x${b.height}`, ratio: 1, changedPixels: 0, total: 0, box: null };
+    }
+    const { width, height } = a;
+    const ca = a.channels;
+    const cb = b.channels;
+    let changed = 0;
+    let minX = width;
+    let minY = height;
+    let maxX = -1;
+    let maxY = -1;
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const pa = (y * width + x) * ca;
+            const pb = (y * width + x) * cb;
+            if (Math.abs(a.data[pa] - b.data[pb]) > tol || Math.abs(a.data[pa + 1] - b.data[pb + 1]) > tol || Math.abs(a.data[pa + 2] - b.data[pb + 2]) > tol) {
+                changed++;
+                if (x < minX)
+                    minX = x;
+                if (y < minY)
+                    minY = y;
+                if (x > maxX)
+                    maxX = x;
+                if (y > maxY)
+                    maxY = y;
+            }
+        }
+    }
+    const total = width * height;
+    return {
+        comparable: true,
+        ratio: changed / total,
+        changedPixels: changed,
+        total,
+        box: maxX >= 0 ? { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 } : null,
+    };
+}
+function downscaleGray(g, w, h, factor) {
+    const nw = Math.max(1, Math.floor(w / factor));
+    const nh = Math.max(1, Math.floor(h / factor));
+    const out = new Uint8Array(nw * nh);
+    for (let y = 0; y < nh; y++) {
+        for (let x = 0; x < nw; x++)
+            out[y * nw + x] = g[Math.min(h - 1, y * factor) * w + Math.min(w - 1, x * factor)];
+    }
+    return { g: out, w: nw, h: nh };
+}
+/**
+ * Locate `templateBuf` within `screenBuf` by sum-of-absolute-differences on downscaled
+ * grayscale (best-effort; returns a confidence score the caller can threshold). Returns the
+ * match CENTER in screenshot pixels. Bounded so it stays fast on phone-sized screenshots.
+ */
+export function findTemplate(screenBuf, templateBuf, minScore = 0.85) {
+    const s = decodePng(screenBuf);
+    const t = decodePng(templateBuf);
+    // Downscale the screen to ~200px wide for speed; scale the template by the same factor.
+    const factor = Math.max(1, Math.ceil(s.width / 200));
+    const sg = downscaleGray(toGray(s), s.width, s.height, factor);
+    const tg = downscaleGray(toGray(t), t.width, t.height, factor);
+    if (tg.w < 1 || tg.h < 1 || tg.w > sg.w || tg.h > sg.h) {
+        return { found: false, score: 0, x: -1, y: -1 };
+    }
+    const stride = tg.w * tg.h > 400 ? 2 : 1; // coarse search for larger templates
+    let best = Infinity;
+    let bx = 0;
+    let by = 0;
+    const maxSad = tg.w * tg.h * 255;
+    for (let y = 0; y + tg.h <= sg.h; y += stride) {
+        for (let x = 0; x + tg.w <= sg.w; x += stride) {
+            let sad = 0;
+            for (let ty = 0; ty < tg.h && sad < best; ty++) {
+                const srow = (y + ty) * sg.w + x;
+                const trow = ty * tg.w;
+                for (let tx = 0; tx < tg.w; tx++)
+                    sad += Math.abs(sg.g[srow + tx] - tg.g[trow + tx]);
+            }
+            if (sad < best) {
+                best = sad;
+                bx = x;
+                by = y;
+            }
+        }
+    }
+    const score = 1 - best / maxSad;
+    // center back in full-resolution screenshot pixels
+    const cx = Math.round((bx + tg.w / 2) * factor);
+    const cy = Math.round((by + tg.h / 2) * factor);
+    return { found: score >= minScore, score: Math.round(score * 1000) / 1000, x: cx, y: cy };
+}
+//# sourceMappingURL=image.js.map

package/dist/lib/image.js.map

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

package/dist/lib/logger.js

@@ -0,0 +1,8 @@
+// Structured logging to STDERR only.
+// CRITICAL: on the stdio transport, stdout must carry pure JSON-RPC. Anything
+// written to stdout corrupts the MCP stream. All diagnostics go to stderr.
+export function log(level, msg, meta) {
+    const line = JSON.stringify({ ts: new Date().toISOString(), level, msg, ...(meta ?? {}) });
+    process.stderr.write(line + '\n');
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,8EAA8E;AAC9E,2EAA2E;AAI3E,MAAM,UAAU,GAAG,CAAC,KAAY,EAAE,GAAW,EAAE,IAA8B;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3F,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC"}