@runalabs/rill-cli 0.1.0 → 0.1.1

package/README.md

@@ -5,7 +5,7 @@ Record, inspect, and share agent-controlled browser runs with Rill.
 ## Install
 
 ```sh
-npm install --global @runalabs/rill-cli@0.1.0
+npm install --global @runalabs/rill-cli@0.1.1
 rill doctor
 ```
 
@@ -23,5 +23,10 @@ rill record start --url https://staging.example.com --title "Agent reproduction"
 rill record stop <recording-id>
 ```
 
+If the local recorder is unavailable, `rill record status <recording-id>` falls
+back to the control plane. Use `rill record cancel <recording-id>` to abandon an
+active recording and release its quota reservation. A failed local startup
+automatically cancels the reservation it just created.
+
 Commands emit one schema-versioned JSON object to stdout. Human-readable
 progress is written to stderr.

package/dist/cli.js

@@ -583,6 +583,15 @@ function json(response, status, value) {
 import { createReadStream } from "fs";
 import { readFile as readFile2, stat } from "fs/promises";
 import { Upload } from "tus-js-client";
+var ControlPlaneError = class extends Error {
+  constructor(code, message, recovery, details) {
+    super(`${code}: ${message}${recovery ? `: ${recovery}` : ""}`);
+    this.code = code;
+    this.recovery = recovery;
+    this.details = details;
+    this.name = "ControlPlaneError";
+  }
+};
 var ControlPlaneClient = class {
   constructor(apiUrl, token) {
     this.apiUrl = apiUrl;
@@ -603,6 +612,12 @@ var ControlPlaneClient = class {
   recordingStatus(recordingId) {
     return this.request(`/api/recordings/${recordingId}`);
   }
+  cancelRecording(recordingId, reason = "cancelled_by_agent") {
+    return this.request(`/api/recordings/${recordingId}/cancel`, {
+      method: "POST",
+      body: JSON.stringify({ reason })
+    });
+  }
   async waitUntilPlayable(recordingId, timeoutMs = 10 * 6e4) {
     const deadline = Date.now() + timeoutMs;
     let intervalMs = 1e3;
@@ -667,7 +682,10 @@ var ControlPlaneClient = class {
     }
     const response = await fetch(`${this.apiUrl}${path}`, { ...init, headers });
     const value = await response.json().catch(() => null);
-    if (!response.ok) throw new Error([value?.error?.code, value?.error?.message, value?.error?.recovery].filter(Boolean).join(": ") || `Request failed (${response.status}).`);
+    if (!response.ok && value?.error?.code && value.error.message) {
+      throw new ControlPlaneError(value.error.code, value.error.message, value.error.recovery, value.error.details);
+    }
+    if (!response.ok) throw new Error(`Request failed (${response.status}).`);
     return value;
   }
 };
@@ -715,11 +733,16 @@ function emit(value, pretty = false) {
   process.stdout.write(`${JSON.stringify(value, null, pretty ? 2 : void 0)}
 `);
 }
-function fail(error) {
+function failureValue(error) {
   const message = error instanceof Error ? error.message : String(error);
   const [candidate] = message.split(":", 1);
   const knownCodes = /* @__PURE__ */ new Set(["authentication_required", "scope_denied", "quota_exceeded", "browser_unavailable", "recording_not_found", "upload_interrupted", "processing_failed", "share_revoked", "validation_failed"]);
-  emit({ error: { code: knownCodes.has(candidate) ? candidate : "internal_error", message } });
+  const structured = error && typeof error === "object" ? error : {};
+  const code = structured.code && knownCodes.has(structured.code) ? structured.code : knownCodes.has(candidate) ? candidate : "internal_error";
+  return { error: { code, message, ...structured.recovery ? { recovery: structured.recovery } : {}, ...structured.details ? { details: structured.details } : {} } };
+}
+function fail(error) {
+  emit(failureValue(error));
   process.exitCode = 1;
 }
 
@@ -837,6 +860,35 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : String(error);
 }
 
+// src/recording-lifecycle.ts
+async function startRecordingWithCompensation(remote, dependencies) {
+  try {
+    return await dependencies.startLocal();
+  } catch (startupError) {
+    try {
+      await dependencies.cancelRemote(remote.recordingId, "local_start_failed");
+    } catch (cleanupError) {
+      throw new AggregateError(
+        [startupError, cleanupError],
+        "Local recording startup failed and the remote reservation could not be cancelled. Run `rill record cancel <recording-id>`."
+      );
+    }
+    throw startupError;
+  }
+}
+async function remoteAwareRecordingStatus(recordingId, dependencies) {
+  try {
+    return { ...await dependencies.localStatus(recordingId), source: "local" };
+  } catch {
+    const remote = await dependencies.remoteStatus(recordingId);
+    return {
+      ...remote,
+      recordingId: typeof remote.recordingId === "string" ? remote.recordingId : remote.id ?? recordingId,
+      source: "remote"
+    };
+  }
+}
+
 // 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", process.env.RILL_API_URL ?? "https://rill-staging.tight-shadow-8e12.workers.dev").option("--pretty", "Pretty-print JSON output", false);
@@ -873,8 +925,13 @@ record.command("start").option("--url <url>").option("--title <title>").option("
   const width = Number(commandOptions.width);
   const height = Number(commandOptions.height);
   const remote = await client.createRecording({ title: commandOptions.title ?? `Browser recording \xB7 ${(/* @__PURE__ */ new Date()).toISOString()}`, description: commandOptions.description, sourceUrl: commandOptions.url ?? null, width, height });
-  await ensureDaemon(process.argv[1]);
-  const local = await startRecording({ recordingId: remote.recordingId, url: commandOptions.url, cdpUrl: commandOptions.cdpUrl, headed: Boolean(commandOptions.headed), width, height, maxDurationSeconds: Number(commandOptions.maxDuration), captureNetworkBodies: remote.bodyCaptureEnabled });
+  const local = await startRecordingWithCompensation(remote, {
+    startLocal: async () => {
+      await ensureDaemon(process.argv[1]);
+      return startRecording({ recordingId: remote.recordingId, url: commandOptions.url, cdpUrl: commandOptions.cdpUrl, headed: Boolean(commandOptions.headed), width, height, maxDurationSeconds: Number(commandOptions.maxDuration), captureNetworkBodies: remote.bodyCaptureEnabled });
+    },
+    cancelRemote: (recordingId, reason) => client.cancelRecording(recordingId, reason)
+  });
   emit({ schemaVersion: 1, recordingId: remote.recordingId, status: local.status, cdpUrl: local.cdpUrl, bodyCaptureEnabled: remote.bodyCaptureEnabled, maxDurationSeconds: Number(commandOptions.maxDuration) }, options.pretty);
 });
 record.command("stop").argument("<recording-id>").option("--no-wait").action(async (recordingId, commandOptions) => {
@@ -895,8 +952,22 @@ record.command("stop").argument("<recording-id>").option("--no-wait").action(asy
 });
 record.command("status").argument("<recording-id>").action(async (recordingId) => {
   const options = program.opts();
-  await ensureDaemon(process.argv[1]);
-  emit({ schemaVersion: 1, ...await recordingStatus(recordingId) }, options.pretty);
+  const token = await loadCredential(options.apiUrl);
+  const client = new ControlPlaneClient(options.apiUrl, token);
+  const status = await remoteAwareRecordingStatus(recordingId, {
+    localStatus: async (id) => {
+      await ensureDaemon(process.argv[1]);
+      return recordingStatus(id);
+    },
+    remoteStatus: (id) => client.recordingStatus(id)
+  });
+  emit({ schemaVersion: 1, ...status }, options.pretty);
+});
+record.command("cancel").argument("<recording-id>").description("Cancel an active recording and release its remote quota slot.").action(async (recordingId) => {
+  const options = program.opts();
+  const token = await loadCredential(options.apiUrl);
+  const client = new ControlPlaneClient(options.apiUrl, token);
+  emit(await client.cancelRecording(recordingId), options.pretty);
 });
 program.command("upload").argument("<video-file>").option("--title <title>").option("--no-wait").action(async (videoFile, commandOptions) => {
   const options = program.opts();

package/package.json

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