qraftai-runner 0.1.0 → 0.3.0

package/dist/index.js

@@ -7,6 +7,8 @@ import { createRequire } from "node:module";
 import { writeFileSync, existsSync, statSync, mkdirSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
+import { execFile as execFile2 } from "node:child_process";
+import { promisify as promisify2 } from "node:util";
 
 // ../server/mobile/appiumManager.js
 import { spawn } from "node:child_process";
@@ -66,6 +68,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 var pexec = promisify(execFile);
 var DEFAULT_NEW_COMMAND_TIMEOUT = parseInt(process.env.APPIUM_CMD_TIMEOUT || "120");
+var STUDIO_CMD_TIMEOUT = parseInt(process.env.STUDIO_APPIUM_CMD_TIMEOUT || "3600");
 var MJPEG_PORT = parseInt(process.env.MOBILE_MJPEG_PORT || "9100");
 async function listIosSimulators() {
   try {
@@ -1070,6 +1073,7 @@ var AppiumDriver = class extends AutomationDriver {
 };
 
 // index.js
+var pexec2 = promisify2(execFile2);
 var VERSION = (() => {
   const req = createRequire(import.meta.url);
   for (const p of ["./package.json", "../package.json"]) {
@@ -1087,10 +1091,49 @@ function parseArgs(argv) {
     if (a === "--server" || a === "-s") out.server = argv[++i];
     else if (a === "--token" || a === "-t") out.token = argv[++i];
     else if (a === "--name" || a === "-n") out.name = argv[++i];
+    else if (a === "--check" || a === "--doctor") out.check = true;
+    else if (a === "--skip-check") out.skipCheck = true;
     else if (a === "--help" || a === "-h") out.help = true;
   }
   return out;
 }
+async function have(cmd, cmdArgs, re) {
+  try {
+    const { stdout, stderr } = await pexec2(cmd, cmdArgs, { timeout: 8e3 });
+    return re ? re.test(`${stdout || ""}${stderr || ""}`) : true;
+  } catch {
+    return false;
+  }
+}
+async function preflight() {
+  const java = await have("java", ["-version"]);
+  const adb = await have("adb", ["version"]);
+  const appium = await have("appium", ["--version"]);
+  const uia = appium ? await have("appium", ["driver", "list", "--installed"], /uiautomator2/i) : false;
+  let device = false;
+  try {
+    device = (await listAdbDevices()).length > 0 || (await listAvds()).length > 0;
+  } catch {
+  }
+  return [
+    { label: "Java (JDK 17+)", ok: java, critical: false, hint: "install a JDK 17+ (e.g. brew install openjdk)" },
+    { label: "adb (Android SDK platform-tools)", ok: adb, critical: true, hint: "install Android SDK; add platform-tools to PATH + set ANDROID_HOME" },
+    { label: "Appium 2", ok: appium, critical: true, hint: "npm i -g appium" },
+    { label: "uiautomator2 driver", ok: uia, critical: true, hint: "appium driver install uiautomator2" },
+    { label: "A device (booted emulator / USB phone)", ok: device, critical: false, hint: "boot an emulator or plug in a phone with USB debugging" }
+  ];
+}
+function reportPreflight(checks) {
+  console.log("\nPrerequisite check:");
+  let criticalMissing = false, deviceMissing = false;
+  for (const c of checks) {
+    console.log(`  ${c.ok ? "\u2713" : "\u2717"} ${c.label}${c.ok ? "" : `  \u2192 ${c.hint}`}`);
+    if (!c.ok && c.critical) criticalMissing = true;
+    if (!c.ok && !c.critical && /device/i.test(c.label)) deviceMissing = true;
+  }
+  if (!criticalMissing && deviceMissing) console.log("  (no device yet \u2014 connect one and it'll appear on \u21BB Recheck in the app)");
+  return { criticalMissing };
+}
 var args = parseArgs(process.argv.slice(2));
 if (args.help) {
   console.log(`QraftAI Runner v${VERSION}
@@ -1103,11 +1146,18 @@ Options:
   -s, --server   wss://<your-qraftai-host>/runner-stream   (or QRAFTAI_SERVER)
   -t, --token    org-scoped runner token from the Mobile tab (or QRAFTAI_TOKEN)
   -n, --name     a label shown in the app for this machine   (or QRAFTAI_RUNNER_NAME)
+      --check    check prerequisites and exit (no connection; also --doctor)
+      --skip-check  connect without the startup prerequisite check
 
 Prerequisites (on this machine): JDK 17+, Android SDK (adb + emulator),
 Appium 2 + uiautomator2, and a device (AVD or USB phone with USB debugging).`);
   process.exit(0);
 }
+if (args.check) {
+  const { criticalMissing } = reportPreflight(await preflight());
+  console.log(criticalMissing ? "\n\u2716  Missing required tools above.\n" : "\n\u2713  Ready to run the runner.\n");
+  process.exit(criticalMissing ? 1 : 0);
+}
 var SERVER = args.server || process.env.QRAFTAI_SERVER;
 var TOKEN = args.token || process.env.QRAFTAI_TOKEN;
 var NAME = args.name || process.env.QRAFTAI_RUNNER_NAME || "";
@@ -1130,11 +1180,12 @@ function sendMsg(type, payload = {}, reqId) {
 var ok = (reqId, result) => sendMsg("RESULT", { result }, reqId);
 var err = (reqId, message) => sendMsg("ERROR", { message }, reqId);
 var HANDLERS = {
-  async OPEN_SESSION({ sessionId, device, kind = "avd", platform = "android", app }) {
+  async OPEN_SESSION({ sessionId, device, kind = "avd", platform = "android", app, studio = false }) {
     if (sessions.has(sessionId)) return { platform: sessions.get(sessionId).platform };
     const resolvedApp = await resolveApp(app);
     const { host, port } = await ensureAppium();
-    const capabilities = buildCapabilities(device, resolvedApp, kind, {}, platform);
+    const overrides = studio ? { "appium:newCommandTimeout": STUDIO_CMD_TIMEOUT } : {};
+    const capabilities = buildCapabilities(device, resolvedApp, kind, overrides, platform);
     const driver = new AppiumDriver({
       capabilities,
       connection: { protocol: "http", hostname: host, port, path: "/" }
@@ -1296,4 +1347,12 @@ async function shutdown() {
 }
 process.on("SIGINT", shutdown);
 process.on("SIGTERM", shutdown);
+if (!args.skipCheck) {
+  const { criticalMissing } = reportPreflight(await preflight());
+  if (criticalMissing) {
+    console.error("\n\u2716  Fix the required tools above, then re-run. (bypass with --skip-check)\n");
+    process.exit(1);
+  }
+  console.log("");
+}
 connect();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qraftai-runner",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "QraftAI local device runner — bridge your own Android emulator/phone to a QraftAI workspace.",
   "type": "module",
   "bin": {