@runalabs/rill-cli 0.1.7-beta.0 → 0.1.8

package/README.md

@@ -6,7 +6,7 @@ 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 beta
+## 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.
 
@@ -19,7 +19,7 @@ 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. Current beta admission is three accepted runs per workspace per UTC day; monthly run credits are not implemented yet.
+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`.
 
@@ -262,3 +262,10 @@ secret-tool clear service rill api-url https://userill.dev
 ```
 
 Substitute your API URL if you configured another environment. These commands clear the local credential; server-side revocation is managed in Settings.
+
+### Cloud run output
+
+`rill record <url> -p "<prompt>"` prints the outcome, summary, and recording URL.
+Use `--json` for a machine-readable result (`--pretty` also enables JSON formatting).
+Provider token usage is retained internally and omitted from customer output.
+`rill run status <run-id>` and `rill run cancel <run-id>` support the same output options.

package/dist/cli.js

@@ -15702,6 +15702,25 @@ function errorMessage(error51) {
   return error51 instanceof Error ? error51.message : String(error51);
 }
 
+// src/cloud-output.ts
+function customerRun(run2) {
+  if (!run2.result) return run2;
+  const { usage: _usage, ...result } = run2.result;
+  return { ...run2, result };
+}
+function formatCloudRun(run2) {
+  const result = run2.result;
+  const outcome = typeof result?.outcome === "string" ? result.outcome : void 0;
+  const summary = typeof result?.summary === "string" ? result.summary : void 0;
+  const publication = result?.publication;
+  const lines = [`Run ${run2.status}${outcome ? ` \xB7 ${outcome}` : ""}`, `Run ID: ${run2.id}`];
+  if (summary) lines.push("", summary);
+  if (publication?.playbackUrl) lines.push("", `Recording: ${publication.playbackUrl}`);
+  if (run2.status === "failed" && !summary) lines.push("", "The run could not finish.");
+  if (!["completed", "failed", "cancelled"].includes(run2.status)) lines.push("", `Check progress: rill run status ${run2.id}`);
+  return lines.join("\n") + "\n";
+}
+
 // src/recording-lifecycle.ts
 async function startRecordingWithCompensation(remote, dependencies) {
   try {
@@ -15739,7 +15758,7 @@ function controlPlaneUrl(environmentUrl) {
 
 // src/cli.ts
 var program = new Command();
-program.name("rill").description("Record, inspect, and share agent browser runs.").version(CLI_VERSION).option("--api-url <url>", "Rill control plane", controlPlaneUrl(process.env.RILL_API_URL)).option("--pretty", "Pretty-print JSON output", false);
+program.name("rill").description("Record, inspect, and share agent browser runs.").version(CLI_VERSION).option("--api-url <url>", "Rill control plane", controlPlaneUrl(process.env.RILL_API_URL)).option("--pretty", "Pretty-print JSON output", false).option("--json", "Output cloud run results as JSON", false);
 var activeTelemetry = null;
 program.command("daemon", { hidden: true }).action(() => runDaemon());
 program.command("doctor").description("Validate Rill prerequisites before recording.").action(async () => {
@@ -15748,7 +15767,7 @@ program.command("doctor").description("Validate Rill prerequisites before record
   emit(result, options.pretty);
   if (result.status === "error") process.exitCode = 1;
 });
-async function authorize() {
+async function authorize(quiet = false) {
   const options = program.opts();
   const client = new ControlPlaneClient(options.apiUrl, null);
   const authorization = await client.createDeviceAuthorization({ deviceName: `${hostname3()} \xB7 ${process.platform}` });
@@ -15765,7 +15784,7 @@ async function authorize() {
     if (result.status === "pending") continue;
     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);
+    if (!quiet) emit({ schemaVersion: 1, status: "authenticated", expiresAt: result.expiresAt, apiUrl: options.apiUrl }, options.pretty);
     return result.token;
   }
   throw new Error("Device authorization expired.");
@@ -15776,7 +15795,7 @@ program.command("login").description("Authorize Rill once.").action(async () =>
 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 token = await loadCredential(options.apiUrl) ?? await authorize(true);
   const client = new ControlPlaneClient(options.apiUrl, token);
   const id = commandOptions.id ?? crypto.randomUUID();
   process.stderr.write(`Run ID: ${id}
@@ -15792,14 +15811,17 @@ var record2 = program.command("record").description("Run a cloud browser from a
     await new Promise((resolve) => setTimeout(resolve, 2e3));
     run2 = await client.cloudRun(id);
   }
-  emit(run2, options.pretty);
+  if (options.json || options.pretty) emit(customerRun(run2), options.pretty);
+  else process.stdout.write(formatCloudRun(run2));
   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);
+  const run2 = await (action === "status" ? client.cloudRun(id) : client.cancelCloudRun(id));
+  if (options.json || options.pretty) emit(customerRun(run2), options.pretty);
+  else process.stdout.write(formatCloudRun(run2));
 });
 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();

package/package.json

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