@elizaos/app-core 2.0.0-beta.2 → 2.0.11-beta.5

package/scripts/aosp/capture-screens.mjs

@@ -1,325 +0,0 @@
-#!/usr/bin/env node
-// Capture a sequenced set of PNG screenshots from a connected device or
-// Cuttlefish instance. Drives `adb shell screencap -p` and pulls each PNG
-// to a numbered file under <out-dir>/.
-//
-// Usage:
-//   node eliza/packages/app-core/scripts/aosp/capture-screens.mjs --out reports/aosp-boot
-//   node eliza/packages/app-core/scripts/aosp/capture-screens.mjs --out reports/avd \
-//        --steps home,dialer,assist,sms
-//
-// Flags:
-//   --out <dir>          Output directory (created if missing).
-//   --serial <serial>    adb device serial (defaults to ANDROID_SERIAL).
-//   --adb <path>         Explicit adb binary (defaults to PATH / SDK lookup).
-//   --steps <csv>        Comma-separated steps from the predefined map.
-//                        Default: home,dialer,sms,assist,recents,launcher.
-//   --label <text>       Free-form label appended to filenames.
-//   --no-launch          Capture only the current screen, skip step driving.
-//   --app-config <PATH>  Override the host app.config.ts path (used to
-//                        resolve `aosp.packageName` for the launcher step).
-//
-// Each step launches the named variant surface via the role intent and
-// waits briefly for the WebView to settle before grabbing the
-// framebuffer.
-
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import process from "node:process";
-import { fileURLToPath } from "node:url";
-import { resolveRepoRootFromImportMeta } from "../lib/repo-root.mjs";
-import {
-  loadAospVariantConfig,
-  resolveAppConfigPath,
-} from "./lib/load-variant-config.mjs";
-
-const repoRoot = resolveRepoRootFromImportMeta(import.meta.url);
-
-/**
- * Build the per-variant step map. The launcher step is the only one
- * that needs the variant package name; the rest fire pure-AOSP
- * intents the system resolves on its own.
- */
-export function buildStepMap(packageName) {
-  return {
-    home: {
-      label: "home",
-      drive: (adb, serial) => shell(adb, serial, "input keyevent KEYCODE_HOME"),
-      settleMs: 1500,
-    },
-    dialer: {
-      label: "dialer",
-      drive: (adb, serial) =>
-        shell(adb, serial, "am start -a android.intent.action.DIAL"),
-      settleMs: 2500,
-    },
-    sms: {
-      label: "sms",
-      drive: (adb, serial) =>
-        shell(
-          adb,
-          serial,
-          'am start -a android.intent.action.SENDTO -d "smsto:5551234567"',
-        ),
-      settleMs: 2500,
-    },
-    assist: {
-      label: "assist",
-      drive: (adb, serial) =>
-        shell(adb, serial, "am start -a android.intent.action.ASSIST"),
-      settleMs: 2500,
-    },
-    recents: {
-      label: "recents",
-      drive: (adb, serial) =>
-        shell(adb, serial, "input keyevent KEYCODE_APP_SWITCH"),
-      settleMs: 1500,
-    },
-    launcher: {
-      label: "launcher",
-      drive: (adb, serial) =>
-        shell(
-          adb,
-          serial,
-          `monkey -p ${packageName} -c android.intent.category.LAUNCHER 1`,
-        ),
-      settleMs: 2500,
-    },
-  };
-}
-
-// All step names supported by `buildStepMap()`. Used for argument
-// validation independent of the variant package name (the only
-// variant-bound step is `launcher`, which still has the same name).
-const STEP_NAMES = ["home", "dialer", "sms", "assist", "recents", "launcher"];
-
-function parseArgs(argv) {
-  const args = {
-    outDir: null,
-    serial: process.env.ANDROID_SERIAL || null,
-    adb: process.env.ADB || null,
-    steps: STEP_NAMES.slice(),
-    label: null,
-    noLaunch: false,
-    appConfigPath: null,
-  };
-
-  const readFlagValue = (flag, index) => {
-    const value = argv[index + 1];
-    if (!value || value.startsWith("--")) {
-      throw new Error(`${flag} requires a value`);
-    }
-    return value;
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--out") {
-      args.outDir = path.resolve(readFlagValue(arg, i));
-      i += 1;
-    } else if (arg === "--serial" || arg === "-s") {
-      args.serial = readFlagValue(arg, i);
-      i += 1;
-    } else if (arg === "--adb") {
-      args.adb = path.resolve(readFlagValue(arg, i));
-      i += 1;
-    } else if (arg === "--steps") {
-      args.steps = readFlagValue(arg, i)
-        .split(",")
-        .map((step) => step.trim())
-        .filter(Boolean);
-      i += 1;
-    } else if (arg === "--label") {
-      args.label = readFlagValue(arg, i);
-      i += 1;
-    } else if (arg === "--no-launch") {
-      args.noLaunch = true;
-    } else if (arg === "--app-config") {
-      args.appConfigPath = path.resolve(readFlagValue(arg, i));
-      i += 1;
-    } else if (arg === "-h" || arg === "--help") {
-      console.log(
-        "Usage: node eliza/packages/app-core/scripts/aosp/capture-screens.mjs --out <DIR> [--serial S] [--adb PATH] [--steps a,b,c] [--label TEXT] [--no-launch] [--app-config PATH]",
-      );
-      console.log("Steps:", STEP_NAMES.join(", "));
-      process.exit(0);
-    } else {
-      throw new Error(`Unknown argument: ${arg}`);
-    }
-  }
-
-  if (!args.outDir) throw new Error("--out is required");
-  for (const step of args.steps) {
-    if (!STEP_NAMES.includes(step)) {
-      throw new Error(
-        `Unknown step "${step}". Known: ${STEP_NAMES.join(", ")}`,
-      );
-    }
-  }
-  return args;
-}
-
-function resolveAdb(explicit) {
-  if (explicit) {
-    if (!fs.existsSync(explicit)) {
-      throw new Error(`adb not found: ${explicit}`);
-    }
-    return explicit;
-  }
-  const sdkRoots = [
-    process.env.ANDROID_HOME,
-    process.env.ANDROID_SDK_ROOT,
-    path.join(os.homedir(), "Library", "Android", "sdk"),
-    path.join(os.homedir(), "Android", "Sdk"),
-  ].filter(Boolean);
-  for (const sdkRoot of sdkRoots) {
-    const candidate = path.join(sdkRoot, "platform-tools", "adb");
-    if (fs.existsSync(candidate)) return candidate;
-  }
-  const result = spawnSync("adb", ["version"], { stdio: "ignore" });
-  if (!result.error) return "adb";
-  throw new Error(
-    "Could not find adb. Set --adb, ADB, ANDROID_HOME, or ANDROID_SDK_ROOT.",
-  );
-}
-
-function adbArgs(serial, args) {
-  return serial ? ["-s", serial, ...args] : args;
-}
-
-function run(command, args) {
-  const result = spawnSync(command, args, {
-    encoding: "utf8",
-    maxBuffer: 64 * 1024 * 1024,
-  });
-  if (result.error) {
-    throw new Error(`${command} failed: ${result.error.message}`);
-  }
-  if (result.status !== 0) {
-    throw new Error(
-      `${command} ${args.join(" ")} failed:\n${result.stderr || result.stdout}`,
-    );
-  }
-  return result.stdout;
-}
-
-function shell(adb, serial, command) {
-  return run(adb, adbArgs(serial, ["shell", command]));
-}
-
-function captureFramebuffer(adb, serial, targetPath) {
-  // adb exec-out streams the PNG bytes back without an intermediate file
-  // on the device. Falls back to push/pull if exec-out fails.
-  const result = spawnSync(
-    adb,
-    adbArgs(serial, ["exec-out", "screencap", "-p"]),
-    { maxBuffer: 64 * 1024 * 1024 },
-  );
-  if (result.error || result.status !== 0) {
-    const tmpDevicePath = `/sdcard/screencap-${Date.now()}.png`;
-    shell(adb, serial, `screencap -p ${tmpDevicePath}`);
-    run(adb, adbArgs(serial, ["pull", tmpDevicePath, targetPath]));
-    shell(adb, serial, `rm -f ${tmpDevicePath}`);
-    return;
-  }
-  fs.writeFileSync(targetPath, result.stdout);
-}
-
-async function sleep(ms) {
-  await new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-function timestampSlug() {
-  const d = new Date();
-  return [
-    d.getFullYear(),
-    String(d.getMonth() + 1).padStart(2, "0"),
-    String(d.getDate()).padStart(2, "0"),
-    "-",
-    String(d.getHours()).padStart(2, "0"),
-    String(d.getMinutes()).padStart(2, "0"),
-    String(d.getSeconds()).padStart(2, "0"),
-  ].join("");
-}
-
-export async function captureScreens({
-  outDir,
-  serial,
-  adb,
-  steps,
-  label,
-  noLaunch,
-  packageName,
-  appConfigPath,
-}) {
-  fs.mkdirSync(outDir, { recursive: true });
-  const slug = timestampSlug();
-
-  if (noLaunch) {
-    const target = path.join(
-      outDir,
-      `${slug}__current${label ? `__${label}` : ""}.png`,
-    );
-    captureFramebuffer(adb, serial, target);
-    console.log(`[capture] ${target}`);
-    return [target];
-  }
-
-  // The launcher step needs the variant package name. Callers can
-  // pass it directly, otherwise we read from the host's app.config.ts.
-  let resolvedPackage = packageName;
-  if (!resolvedPackage) {
-    const cfgPath = resolveAppConfigPath({
-      repoRoot,
-      flagValue: appConfigPath,
-    });
-    if (fs.existsSync(cfgPath)) {
-      const variant = loadAospVariantConfig({ appConfigPath: cfgPath });
-      if (variant?.packageName) resolvedPackage = variant.packageName;
-    }
-  }
-  if (!resolvedPackage && steps.includes("launcher")) {
-    throw new Error(
-      "[capture] No package name resolved. Pass `packageName` programmatically " +
-        "or `--app-config <PATH>` so the launcher step can target the variant APK.",
-    );
-  }
-  const stepMap = buildStepMap(resolvedPackage ?? "");
-  const captured = [];
-  for (let i = 0; i < steps.length; i += 1) {
-    const step = stepMap[steps[i]];
-    try {
-      step.drive(adb, serial);
-    } catch (error) {
-      console.warn(
-        `[capture] step ${step.label} drive failed (continuing): ${error.message}`,
-      );
-    }
-    await sleep(step.settleMs);
-    const target = path.join(
-      outDir,
-      `${slug}__${String(i).padStart(2, "0")}_${step.label}${label ? `__${label}` : ""}.png`,
-    );
-    captureFramebuffer(adb, serial, target);
-    console.log(`[capture] ${target}`);
-    captured.push(target);
-  }
-  return captured;
-}
-
-async function main(argv = process.argv.slice(2)) {
-  const args = parseArgs(argv);
-  const adb = resolveAdb(args.adb);
-  await captureScreens({ ...args, adb });
-}
-
-const isMain =
-  process.argv[1] &&
-  path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
-if (isMain) {
-  await main();
-}
-
-export { parseArgs, resolveAdb, STEP_NAMES };

package/scripts/aosp/e2e-validate.mjs

@@ -1,225 +0,0 @@
-#!/usr/bin/env node
-// End-to-end validation against a running AOSP system-app device or
-// AVD. Wraps boot-validate (role/permission/appop assertions) and
-// capture-screens (visual proof of HOME / Dialer / SMS / Assistant
-// ownership) into a single command that emits a JSON report + a PNG
-// gallery.
-//
-// Usage:
-//   node eliza/packages/app-core/scripts/aosp/e2e-validate.mjs --out reports/e2e-cuttlefish
-//   node eliza/packages/app-core/scripts/aosp/e2e-validate.mjs --out reports/e2e-avd \
-//        --skip-boot-validate            # skip system-image checks
-//
-// Flags:
-//   --out <dir>             Output directory for screenshots + report.json.
-//   --serial <serial>       adb device serial.
-//   --adb <path>            Explicit adb binary.
-//   --timeout-ms <ms>       Boot wait timeout (default 180000).
-//   --skip-boot-validate    Skip role/permission/appop assertions.
-//                           Use for AVD app-only runs where the device
-//                           was never imaged with the variant vendor.
-//   --steps <csv>           Override the default screenshot step list.
-//   --label <text>          Free-form label appended to PNG names.
-//   --app-config <PATH>     Override the host app.config.ts path.
-//   --smoke-cuttlefish-only Run only the cuttlefish-style health + chat
-//                           smoke (smoke-cuttlefish.mjs). Skips boot
-//                           validation and screenshot capture. Useful
-//                           in CI where the only ABI to exercise is
-//                           x86_64 against a running cvd.
-
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-import { fileURLToPath } from "node:url";
-import { resolveRepoRootFromImportMeta } from "../lib/repo-root.mjs";
-import { validateBootedDevice } from "./boot-validate.mjs";
-import { captureScreens, resolveAdb } from "./capture-screens.mjs";
-import {
-  loadAospVariantConfig,
-  resolveAppConfigPath,
-} from "./lib/load-variant-config.mjs";
-
-const repoRoot = resolveRepoRootFromImportMeta(import.meta.url);
-
-function parseArgs(argv) {
-  const args = {
-    outDir: null,
-    serial: process.env.ANDROID_SERIAL || null,
-    adb: process.env.ADB || null,
-    timeoutMs: 180_000,
-    skipBootValidate: false,
-    steps: ["home", "dialer", "sms", "assist", "recents", "launcher"],
-    label: null,
-    appConfigPath: null,
-    smokeCuttlefishOnly: false,
-  };
-  const readFlagValue = (flag, index) => {
-    const value = argv[index + 1];
-    if (!value || value.startsWith("--")) {
-      throw new Error(`${flag} requires a value`);
-    }
-    return value;
-  };
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    if (arg === "--out") {
-      args.outDir = path.resolve(readFlagValue(arg, i));
-      i += 1;
-    } else if (arg === "--serial" || arg === "-s") {
-      args.serial = readFlagValue(arg, i);
-      i += 1;
-    } else if (arg === "--adb") {
-      args.adb = path.resolve(readFlagValue(arg, i));
-      i += 1;
-    } else if (arg === "--timeout-ms") {
-      args.timeoutMs = Number.parseInt(readFlagValue(arg, i), 10);
-      i += 1;
-    } else if (arg === "--skip-boot-validate") {
-      args.skipBootValidate = true;
-    } else if (arg === "--steps") {
-      args.steps = readFlagValue(arg, i)
-        .split(",")
-        .map((step) => step.trim())
-        .filter(Boolean);
-      i += 1;
-    } else if (arg === "--label") {
-      args.label = readFlagValue(arg, i);
-      i += 1;
-    } else if (arg === "--app-config") {
-      args.appConfigPath = path.resolve(readFlagValue(arg, i));
-      i += 1;
-    } else if (arg === "--smoke-cuttlefish-only") {
-      args.smokeCuttlefishOnly = true;
-    } else if (arg === "-h" || arg === "--help") {
-      console.log(
-        "Usage: node eliza/packages/app-core/scripts/aosp/e2e-validate.mjs --out <DIR> [--serial S] [--adb P] [--timeout-ms N] [--skip-boot-validate] [--steps a,b,c] [--label TEXT] [--app-config PATH] [--smoke-cuttlefish-only]",
-      );
-      process.exit(0);
-    } else {
-      throw new Error(`Unknown argument: ${arg}`);
-    }
-  }
-  if (!args.outDir) throw new Error("--out is required");
-  if (!Number.isFinite(args.timeoutMs) || args.timeoutMs <= 0) {
-    throw new Error("--timeout-ms must be a positive integer");
-  }
-  return args;
-}
-
-async function main(argv = process.argv.slice(2)) {
-  const args = parseArgs(argv);
-  const adb = resolveAdb(args.adb);
-  fs.mkdirSync(args.outDir, { recursive: true });
-
-  // Resolve variant once and reuse for both boot-validate and the
-  // launcher screenshot step. AVD-only runs (where vendor/<dir> isn't
-  // imaged) still need the variant for the launcher package name.
-  const cfgPath = resolveAppConfigPath({
-    repoRoot,
-    flagValue: args.appConfigPath,
-  });
-  const variant = fs.existsSync(cfgPath)
-    ? loadAospVariantConfig({ appConfigPath: cfgPath })
-    : null;
-
-  // CI-only fast path: run the cuttlefish health + chat smoke and bail.
-  // Useful when the only goal is to confirm /api/health + a chat
-  // round-trip on x86_64 cvd; the boot-validate / screenshot path
-  // requires a built AOSP variant image which CI typically doesn't have.
-  if (args.smokeCuttlefishOnly) {
-    if (!variant) {
-      throw new Error(
-        "[e2e] --smoke-cuttlefish-only requires app.config.ts > aosp.packageName to resolve the package id.",
-      );
-    }
-    const { runSmoke, formatResult, summarize } = await import(
-      "./smoke-cuttlefish.mjs"
-    );
-    const results = await runSmoke({
-      packageName: variant.packageName,
-      appName: variant.appName,
-    });
-    const smokeReport = {
-      startedAt: new Date().toISOString(),
-      mode: "smoke-cuttlefish-only",
-      packageName: variant.packageName,
-      results,
-    };
-    fs.writeFileSync(
-      path.join(args.outDir, "report.json"),
-      JSON.stringify(smokeReport, null, 2),
-    );
-    for (const r of results) {
-      console.log(formatResult(r.step, r.label, r.ok, r.detail));
-    }
-    const { line, allPassed } = summarize(results);
-    console.log(line);
-    process.exit(allPassed ? 0 : 1);
-  }
-
-  const report = {
-    startedAt: new Date().toISOString(),
-    skipBootValidate: args.skipBootValidate,
-    serial: args.serial,
-    adb,
-    bootValidate: null,
-    screenshots: [],
-    errors: [],
-  };
-
-  if (!args.skipBootValidate) {
-    try {
-      report.bootValidate = await validateBootedDevice({
-        adb,
-        serial: args.serial,
-        timeoutMs: args.timeoutMs,
-        skipLogcat: false,
-        variant,
-        appConfigPath: args.appConfigPath,
-      });
-      console.log(
-        "[e2e] Boot validation passed (HOME/Dialer/SMS/Assistant roles + perms).",
-      );
-    } catch (error) {
-      report.errors.push({ phase: "boot-validate", message: error.message });
-      console.error(`[e2e] Boot validation FAILED: ${error.message}`);
-    }
-  } else {
-    console.log("[e2e] Skipping boot validation (--skip-boot-validate).");
-  }
-
-  try {
-    report.screenshots = await captureScreens({
-      outDir: args.outDir,
-      serial: args.serial,
-      adb,
-      steps: args.steps,
-      label: args.label,
-      noLaunch: false,
-      packageName: variant?.packageName,
-      appConfigPath: args.appConfigPath,
-    });
-  } catch (error) {
-    report.errors.push({ phase: "capture-screens", message: error.message });
-    console.error(`[e2e] Screenshot capture FAILED: ${error.message}`);
-  }
-
-  report.finishedAt = new Date().toISOString();
-  const reportPath = path.join(args.outDir, "report.json");
-  fs.writeFileSync(reportPath, JSON.stringify(report, null, 2));
-  console.log(`[e2e] Report: ${reportPath}`);
-
-  if (report.errors.length > 0) {
-    console.error(`[e2e] ${report.errors.length} error(s); see report.json`);
-    process.exit(1);
-  }
-}
-
-const isMain =
-  process.argv[1] &&
-  path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
-if (isMain) {
-  await main();
-}
-
-export { parseArgs };