@botiverse/testbed-cli 0.1.0 → 0.2.0

package/lib/main.mjs

@@ -6,7 +6,7 @@ import { resolveAuth } from "./auth.mjs";
 import { makeClient, ApiError } from "./client.mjs";
 import { runAgentLogin } from "./agent-login.mjs";
 
-export const USAGE = `testbed — cloud phones + the acceptance stamp in the Raft release loop
+export const USAGE = `testbed — cloud phones + the acceptance testbed in the Raft release loop
 
   testbed login                          agent: PKCE login via raft (no browser); human: how to set TESTBED_TOKEN
   testbed logout                         agent: forget the stored session
@@ -21,6 +21,15 @@ export const USAGE = `testbed — cloud phones + the acceptance stamp in the Raf
   testbed repair-adb <lease-id>
   testbed diagnose-adb <lease-id> [--pubkey-sha256 HEX]
 
+  testbed verify start [--ttl MIN] [--instance ID] [--request-id ID] [--app-ref LABEL] [--apk-key fast/<id> --apk-sha256 HEX]
+                                         open a human verification session (takes one pool device)
+  testbed verify show <session-id>
+  testbed verify renew <session-id> [--minutes MIN]
+  testbed verify end <session-id>
+  testbed verify accounts <session-id>   QA accounts the verifier may log in with
+  testbed verify login <session-id> --account <account-id>
+  testbed verify reinstall <session-id> --apk-key fast/<id> --apk-sha256 HEX
+
   testbed cases                          acceptance case library
   testbed run <case-id...> [--app --ref --apk --apk-run --release --by]
   testbed runs
@@ -84,7 +93,7 @@ export async function main(argv, opts) {
       case "login": {
         if (auth.mode !== "agent") {
           out("Not a managed Raft agent. Humans and CI use TESTBED_TOKEN:");
-          out(`  browser: ${auth.apiBase}/login  (then reuse the stamp_session cookie value as TESTBED_TOKEN)`);
+          out(`  browser: ${auth.apiBase}/login  (then reuse the testbed_session cookie value as TESTBED_TOKEN)`);
           out("  CI:      a deploy token issued by the testbed owner");
           return exit(0);
         }
@@ -174,6 +183,77 @@ export async function main(argv, opts) {
         emit(d, () => out(JSON.stringify(d, null, 2)));
         return exit(0);
       }
+      case "verify": {
+        const sub = args.shift();
+        const vs = (id) => `/verify-sessions/${encodeURIComponent(id)}`;
+        const fmt = (t) => (t ? new Date(t).toISOString().slice(0, 16) : "-");
+        const describe = (sess) => {
+          out(`session ${sess.id} — ${sess.state}${sess.instance_id ? ` on ${sess.instance_id}` : ""}, expires ${fmt(sess.expires_at)}`);
+          out(`${auth.apiBase.replace(/\/api$/, "")}/verify/${sess.id}`);
+          if (sess.app_ref) out(`app: ${sess.app_ref}`);
+          if (sess.qa_account_label) out(`qa account: ${sess.qa_account_label}`);
+        };
+        switch (sub) {
+          case "start": {
+            const ttl = takeFlag(args, "ttl"); const instance = takeFlag(args, "instance"); const requestId = takeFlag(args, "request-id");
+            const appRef = takeFlag(args, "app-ref"); const apkKey = takeFlag(args, "apk-key"); const apkSha = takeFlag(args, "apk-sha256");
+            if ((apkKey === undefined) !== (apkSha === undefined)) throw new Error("usage: --apk-key and --apk-sha256 go together");
+            const d = await api("POST", "/verify-sessions", {
+              ttl_minutes: ttl !== undefined ? Number(ttl) : undefined, instance_id: instance, request_id: requestId,
+              app_ref: appRef, app_oss_key: apkKey, app_sha256: apkSha,
+            });
+            emit(d, () => describe(d.session));
+            return exit(0);
+          }
+          case "show": {
+            const id = args[0]; if (!id) throw new Error("usage: testbed verify show <session-id>");
+            const d = await api("GET", vs(id));
+            emit(d, () => describe(d.session));
+            return exit(0);
+          }
+          case "renew": {
+            const id = args[0]; if (!id) throw new Error("usage: testbed verify renew <session-id> [--minutes MIN]");
+            const minutes = takeFlag(args, "minutes");
+            const d = await api("POST", `${vs(id)}/renew`, minutes !== undefined ? { minutes: Number(minutes) } : {});
+            emit(d, () => out(`session ${id} now until ${new Date(d.expires_at).toISOString()} (lease until ${new Date(d.lease_expires_at).toISOString()})`));
+            return exit(0);
+          }
+          case "end": {
+            const id = args[0]; if (!id) throw new Error("usage: testbed verify end <session-id>");
+            const d = await api("POST", `${vs(id)}/end`, {});
+            emit(d, () => out(d.already_terminal ? `session ${id} was already over` : `ended session ${id}; device reclaim continues asynchronously`));
+            return exit(0);
+          }
+          case "accounts": {
+            const id = args[0]; if (!id) throw new Error("usage: testbed verify accounts <session-id>");
+            const d = await api("GET", `${vs(id)}/qa-accounts`);
+            emit(d, () => {
+              table(d.accounts.map((a) => ({
+                account: a.id, label: a.label, email: a.login_email ?? "-", env: a.environment ?? "-",
+                state: a.in_use ? "in use" : a.cooldown_until && a.cooldown_until > Date.now() ? "cooldown" : "free",
+              })), ["account", "label", "email", "env", "state"], out);
+              if (d.current) out(`\ncurrently logged in: ${d.current.account_label ?? d.current.account_id}`);
+            });
+            return exit(0);
+          }
+          case "login": {
+            const id = args[0]; const account = takeFlag(args, "account");
+            if (!id || !account) throw new Error("usage: testbed verify login <session-id> --account <account-id>");
+            const d = await api("POST", `${vs(id)}/login-qa`, { account_id: account });
+            emit(d, () => out(`logged ${d.account_label ?? account} into session ${id}`));
+            return exit(0);
+          }
+          case "reinstall": {
+            const id = args[0]; const apkKey = takeFlag(args, "apk-key"); const apkSha = takeFlag(args, "apk-sha256");
+            if (!id || !apkKey || !apkSha) throw new Error("usage: testbed verify reinstall <session-id> --apk-key fast/<id> --apk-sha256 HEX");
+            const d = await api("POST", `${vs(id)}/reinstall`, { app_oss_key: apkKey, app_sha256: apkSha });
+            emit(d, () => out(`reinstalled on session ${id}: ${d.status ?? "ok"}`));
+            return exit(0);
+          }
+          default:
+            throw new Error("usage: testbed verify <start|show|renew|end|accounts|login|reinstall> …");
+        }
+      }
       case "cases": {
         const d = await api("GET", "/cases");
         emit(d, () => table(d.cases.map((c) => ({ id: c.id, tier: c.tier, rev: c.revision, title: c.title })), ["id", "tier", "rev", "title"], out));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@botiverse/testbed-cli",
-  "version": "0.1.0",
-  "description": "CLI for testbed \u2014 cloud phones and the acceptance stamp in the Raft release loop",
+  "version": "0.2.0",
+  "description": "CLI for testbed \u2014 cloud phones and the acceptance testbed in the Raft release loop",
   "license": "MIT",
   "type": "module",
   "bin": {