@runalabs/rill-cli 0.1.6 → 0.1.7

package/README.md

@@ -6,6 +6,23 @@ Rill starts a local Chromium recorder. Your browser tool drives the returned CDP
 
 [Getting started](https://userill.dev/docs) · [Website CLI reference](https://userill.dev/docs/cli) · [Agent instructions](https://userill.dev/docs/cli#agents)
 
+## Cloud agent runs
+
+Invited workspaces can supply a URL and prompt. Cloud runs need Node.js 22+ and a Rill login; Chrome and ffmpeg run on Rill's server.
+
+```sh
+rill record https://example.com -p "Open pricing and describe the plans."
+rill record https://example.com/dashboard -p "Describe the dashboard." --account staging
+rill run status <run-id>
+rill run cancel <run-id>
+```
+
+The first run opens Rill authorization if needed. Save optional website test accounts in Rill Settings using an account name, exact HTTPS origin, username, password, and optional login URL. Login appears in the private video, with masked password inputs; login diagnostics are omitted. MFA, CAPTCHA, external SSO, and unsupported login forms return a blocker.
+
+Cloud recordings are private by default. Closing the terminal disconnects without cancelling. Use `--no-wait` to return after submission, and `--id <same-run-id>` with identical arguments to retry an uncertain submission. Cloud runs use run credits: Free includes 3 per calendar month and Pro includes 20. Buy additional credits from Billing.
+
+The following local-recording instructions remain available through `record start` and `record stop`.
+
 ## Install and verify
 
 Browser recording runs on macOS and Linux. Install Node.js 22+, Google Chrome or Chromium, and ffmpeg on `PATH`.

package/dist/cli.js

@@ -6,6 +6,7 @@ var __export = (target, all) => {
 };
 
 // src/cli.ts
+import { spawn as spawn6 } from "child_process";
 import { Command } from "commander";
 import { hostname as hostname3 } from "os";
 import { basename, dirname as dirname2 } from "path";
@@ -14631,6 +14632,11 @@ var recordingSchema = external_exports.object({
     truncated: external_exports.boolean()
   })
 });
+var agentOutcomeSchema = external_exports.object({
+  outcome: external_exports.enum(["walkthrough", "passed", "failed", "inconclusive"]),
+  summary: external_exports.string().min(1).max(1e3),
+  evidence: external_exports.string().max(1e3)
+}).strict();
 
 // ../recorder/src/cursor-overlay.ts
 function installCursorOverlay(options) {
@@ -14917,6 +14923,12 @@ var RecordingSession = class _RecordingSession {
   stopPromise;
   maxTimer;
   removeCursorOverlay;
+  diagnosticsPaused = false;
+  secretValues = [];
+  setDiagnosticPrivacy(paused, secrets) {
+    this.diagnosticsPaused = paused;
+    if (secrets) this.secretValues = secrets.filter(Boolean);
+  }
   bodyBytes = 0;
   truncated = false;
   constructor(options, runtime) {
@@ -14934,7 +14946,7 @@ var RecordingSession = class _RecordingSession {
     const width = options.width ?? 1280;
     const height = options.height ?? 720;
     await mkdir2(options.outputDirectory, { recursive: true, mode: 448 });
-    const runtime = options.cdpUrl ? await connectAttached(options.cdpUrl, options.outputDirectory) : await launchManaged({ headed: options.headed ?? false, width, height, outputDirectory: options.outputDirectory });
+    const runtime = options.cdpUrl ? await connectAttached(options.cdpUrl, options.outputDirectory) : await launchManaged({ headed: options.headed ?? false, width, height, outputDirectory: options.outputDirectory, proxyServer: options.proxyServer });
     const cdpSession = await runtime.context.newCDPSession(runtime.page);
     const screencast = new ScreencastRecorder(cdpSession, join3(options.outputDirectory, "frames"), width, height);
     const session = new _RecordingSession(options, { ...runtime, screencast });
@@ -14952,6 +14964,11 @@ var RecordingSession = class _RecordingSession {
     }, (options.maxDurationSeconds ?? 600) * 1e3);
     return session;
   }
+  // In-process agents share this connection so exposed diagnostic bindings are
+  // not dispatched through a second Playwright client.
+  get recordedPage() {
+    return this.page;
+  }
   status() {
     return { recordingId: this.recordingId, cdpUrl: this.cdpUrl, startedAt: this.startedAt.toISOString(), status: this.stopPromise ? "finalizing" : "recording" };
   }
@@ -14979,13 +14996,14 @@ var RecordingSession = class _RecordingSession {
       timeline: this.timelineEvents.toSorted((left, right) => left.offsetMs - right.offsetMs)
     };
     try {
-      await writeBundle(bundle, diagnosticsPath);
+      const safeBundle = JSON.parse(this.secretValues.reduce((text, secret) => text.split(JSON.stringify(secret).slice(1, -1)).join("[redacted]"), JSON.stringify(bundle)));
+      await writeBundle(safeBundle, diagnosticsPath);
       await this.screencast.stop(videoPath, durationSeconds);
     } finally {
       await this.removeCursorOverlay?.();
       if (this.browserProcess) {
         await this.browser.close().catch(() => void 0);
-        this.browserProcess.kill("SIGTERM");
+        await terminateBrowser(this.browserProcess);
         if (this.profileDirectory) await rm(this.profileDirectory, { recursive: true, force: true }).catch(() => void 0);
       }
     }
@@ -15000,6 +15018,7 @@ var RecordingSession = class _RecordingSession {
     this.captureNetworkBodies = captureNetworkBodies;
     const offset = () => Date.now() - this.startedAt.getTime();
     const pushTimeline = (event) => {
+      if (this.diagnosticsPaused) return;
       if (this.timelineEvents.length >= 1e4) {
         this.truncated = true;
         return;
@@ -15018,6 +15037,7 @@ var RecordingSession = class _RecordingSession {
       if (frame === this.page.mainFrame()) pushTimeline({ offsetMs: offset(), type: "navigation", label: sanitizeUrl(frame.url()) });
     });
     this.page.on("console", async (message) => {
+      if (this.diagnosticsPaused) return;
       if (this.consoleEvents.length >= 1e4) {
         this.truncated = true;
         return;
@@ -15036,11 +15056,13 @@ var RecordingSession = class _RecordingSession {
       if (severity === "error" || severity === "warning") pushTimeline({ offsetMs: event.offsetMs, type: "console", label: event.text.slice(0, 160), severity });
     });
     this.page.on("pageerror", (error51) => {
+      if (this.diagnosticsPaused) return;
       const event = { id: `con_${this.consoleEvents.length + 1}`, offsetMs: offset(), severity: "error", text: redactText(error51.message), stack: redactText(error51.stack ?? "").split("\n").slice(0, 20) };
       this.consoleEvents.push(event);
       pushTimeline({ offsetMs: event.offsetMs, type: "exception", label: event.text.slice(0, 160), severity: "error" });
     });
     this.page.on("request", (request2) => {
+      if (this.diagnosticsPaused) return;
       if (this.networkEvents.length >= 5e3) {
         this.truncated = true;
         return;
@@ -15112,17 +15134,25 @@ async function launchManaged(options) {
     "--disable-component-update",
     "--disable-sync",
     "--metrics-recording-only",
+    ...options.proxyServer ? [`--proxy-server=${options.proxyServer}`, "--proxy-bypass-list=<-loopback>", "--disable-quic", "--force-webrtc-ip-handling-policy=disable_non_proxied_udp"] : [],
     ...options.headed ? [] : ["--headless=new", "--hide-scrollbars"],
     "about:blank"
   ];
-  const browserProcess = spawn3(executable, args, { stdio: ["ignore", "ignore", "pipe"], detached: false });
+  const env = options.proxyServer ? Object.fromEntries(Object.entries(process.env).filter(([key]) => ["PATH", "HOME", "TMPDIR", "DISPLAY", "LANG", "LD_LIBRARY_PATH", "XDG_RUNTIME_DIR"].includes(key))) : process.env;
+  const browserProcess = spawn3(executable, args, { stdio: ["ignore", "ignore", "pipe"], detached: false, env });
   const cdpUrl = `http://127.0.0.1:${port}`;
-  await waitForCdp(cdpUrl, browserProcess);
-  const browser = await chromium.connectOverCDP(cdpUrl, { artifactsDir: options.outputDirectory, isLocal: true });
-  const context = browser.contexts()[0];
-  const page = context.pages()[0] ?? await context.newPage();
-  await page.setViewportSize({ width: options.width, height: options.height });
-  return { cdpUrl, browser, context, page, browserProcess, profileDirectory };
+  try {
+    await waitForCdp(cdpUrl, browserProcess);
+    const browser = await chromium.connectOverCDP(cdpUrl, { artifactsDir: options.outputDirectory, isLocal: true });
+    const context = browser.contexts()[0];
+    const page = context.pages()[0] ?? await context.newPage();
+    await page.setViewportSize({ width: options.width, height: options.height });
+    return { cdpUrl, browser, context, page, browserProcess, profileDirectory };
+  } catch (error51) {
+    await terminateBrowser(browserProcess);
+    await rm(profileDirectory, { recursive: true, force: true }).catch(() => void 0);
+    throw error51;
+  }
 }
 async function connectAttached(cdpUrl, outputDirectory) {
   const browser = await chromium.connectOverCDP(cdpUrl, { artifactsDir: outputDirectory, isLocal: true, noDefaults: true });
@@ -15140,6 +15170,17 @@ async function getAvailablePort() {
   await new Promise((resolve) => server.close(() => resolve()));
   return port;
 }
+async function terminateBrowser(child) {
+  if (child.exitCode !== null || child.signalCode !== null) return;
+  await new Promise((resolve) => {
+    const timeout = setTimeout(() => child.kill("SIGKILL"), 3e3);
+    child.once("exit", () => {
+      clearTimeout(timeout);
+      resolve();
+    });
+    child.kill("SIGTERM");
+  });
+}
 async function waitForCdp(cdpUrl, browserProcess) {
   const deadline = Date.now() + 15e3;
   while (Date.now() < deadline) {
@@ -15281,6 +15322,15 @@ var ControlPlaneClient = class {
     this.apiUrl = apiUrl;
     this.token = token;
   }
+  createCloudRun(input) {
+    return this.request("/api/cloud/runs", { method: "POST", body: JSON.stringify(input) });
+  }
+  cloudRun(id) {
+    return this.request(`/api/cloud/runs/${encodeURIComponent(id)}`);
+  }
+  cancelCloudRun(id) {
+    return this.request(`/api/cloud/runs/${encodeURIComponent(id)}/cancel`, { method: "POST" });
+  }
   health() {
     return this.request("/api/health", {}, false);
   }
@@ -15698,12 +15748,16 @@ program.command("doctor").description("Validate Rill prerequisites before record
   emit(result, options.pretty);
   if (result.status === "error") process.exitCode = 1;
 });
-program.command("login").description("Authorize this agent using a human-approved device code.").action(async () => {
+async function authorize() {
   const options = program.opts();
   const client = new ControlPlaneClient(options.apiUrl, null);
   const authorization = await client.createDeviceAuthorization({ deviceName: `${hostname3()} \xB7 ${process.platform}` });
   process.stderr.write(`Open ${authorization.verificationUri} and enter ${authorization.userCode}
 `);
+  const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer.exe" : "xdg-open";
+  const child = spawn6(opener, [authorization.verificationUri], { stdio: "ignore", detached: true });
+  child.on("error", () => void 0);
+  child.unref();
   const deadline = Date.now() + authorization.expiresIn * 1e3;
   while (Date.now() < deadline) {
     await new Promise((resolve) => setTimeout(resolve, authorization.interval * 1e3));
@@ -15712,11 +15766,41 @@ program.command("login").description("Authorize this agent using a human-approve
     if (result.status !== "approved" || !result.token) throw new Error(`Device authorization ${result.status}.`);
     await saveCredential(options.apiUrl, result.token);
     emit({ schemaVersion: 1, status: "authenticated", expiresAt: result.expiresAt, apiUrl: options.apiUrl }, options.pretty);
-    return;
+    return result.token;
   }
   throw new Error("Device authorization expired.");
+}
+program.command("login").description("Authorize Rill once.").action(async () => {
+  await authorize();
+});
+var record2 = program.command("record").description("Run a cloud browser from a URL and prompt, or manage a local recording.").argument("[url]").option("-p, --prompt <prompt>").option("--expectation <text>").option("--account <name>", "Saved website test account").option("--id <uuid>", "Retry a submission with the same run ID").option("--no-wait").action(async (url2, commandOptions) => {
+  if (!url2 || !commandOptions.prompt) throw new Error("Use rill record <url> -p <prompt>.");
+  const options = program.opts();
+  const token = await loadCredential(options.apiUrl) ?? await authorize();
+  const client = new ControlPlaneClient(options.apiUrl, token);
+  const id = commandOptions.id ?? crypto.randomUUID();
+  process.stderr.write(`Run ID: ${id}
+`);
+  let run2 = await client.createCloudRun({ id, url: url2, prompt: commandOptions.prompt, expectation: commandOptions.expectation, account: commandOptions.account });
+  let last = "";
+  while (commandOptions.wait !== false && !["completed", "failed", "cancelled"].includes(run2.status)) {
+    if (last !== run2.status) {
+      last = run2.status;
+      process.stderr.write(`${last}
+`);
+    }
+    await new Promise((resolve) => setTimeout(resolve, 2e3));
+    run2 = await client.cloudRun(id);
+  }
+  emit(run2, options.pretty);
+  if (run2.status === "failed") process.exitCode = 1;
+});
+var cloudRun = program.command("run").description("Retrieve or cancel a cloud run.");
+for (const action of ["status", "cancel"]) cloudRun.command(action).argument("<run-id>").action(async (id) => {
+  const options = program.opts();
+  const client = new ControlPlaneClient(options.apiUrl, await loadCredential(options.apiUrl));
+  emit(await (action === "status" ? client.cloudRun(id) : client.cancelCloudRun(id)), options.pretty);
 });
-var record2 = program.command("record").description("Manage a browser recording session.");
 record2.command("start").option("--url <url>").option("--title <title>").option("--description <description>", "").option("--headed").option("--cdp-url <url>").option("--width <pixels>", "", "1280").option("--height <pixels>", "", "720").option("--max-duration <seconds>", "", "600").action(async (commandOptions) => {
   const options = program.opts();
   const token = await loadCredential(options.apiUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runalabs/rill-cli",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Record, inspect, and share agent-controlled browser runs with Rill.",
   "license": "Apache-2.0",
   "repository": {