replicas-cli 0.2.200 → 0.2.202

package/dist/index.mjs

@@ -8131,18 +8131,18 @@ function extractPrNumber(url) {
 
 // ../shared/src/default-skills/replicas-agent/abilities/computer.ts
 var SECTION = `### Computer use (Linux desktop control)
-Drive the workspace's Linux desktop - open a browser, click, type, scroll, screenshot, record - and surface a live noVNC viewer to the user via the \`replicas computer\` CLI. Every Replicas workspace boots with Xvfb / openbox / x11vnc / noVNC pre-installed.
+Drive the workspace's Linux desktop - open a browser, click, type, scroll, screenshot, record - via the \`replicas computer\` CLI. Every Replicas workspace boots with Xvfb / openbox / x11vnc / noVNC pre-installed and the live noVNC viewer is automatically published as an authenticated preview, so a \`Desktop\` tab is always available in the dashboard. Use \`replicas computer info\` to get the viewer URL when you want to share it (e.g. point a user on Slack at the live stream).
 
 **Reference:** \`references/COMPUTER-USE.md\`
 
 Use this when:
 - A task requires interacting with a website, web app, or desktop application that has no usable API
-- You want the user to watch the agent work - \`replicas computer start\` exposes a \`Desktop\` tab in the dashboard
+- You want the user to watch the agent work - they can open the \`Desktop\` tab, or you can share the URL from \`replicas computer info\`
 - You're testing UI changes in a browser before reporting them as done
 - You want to record a screen capture of a task as proof to share back`;
 var REFERENCE = `# Computer use (Linux desktop control)
 
-Every Replicas workspace boots with a full Linux desktop stack - Xvfb (1920\xD71080), openbox, tint2, x11vnc, noVNC, ffmpeg, and Google Chrome. You drive it through the \`replicas computer\` CLI.
+Every Replicas workspace boots with a full Linux desktop stack - Xvfb (1920\xD71080), openbox, tint2, x11vnc, noVNC, ffmpeg, and Google Chrome. The engine also auto-registers the noVNC viewer (port 6080) as an authenticated preview at startup, so the dashboard \`Desktop\` tab is live the moment the workspace is up. You drive the desktop through the \`replicas computer\` CLI.
 
 Use this for anything the user can't reasonably do via an API - clicking around web apps, filling forms, testing UI changes, dragging files between desktop apps, recording a walkthrough.
 
@@ -8150,7 +8150,7 @@ Use this for anything the user can't reasonably do via an API - clicking around
 
 - **Prefer real APIs first.** If a task has a CLI or HTTP API (GitHub, Linear, Slack, Replicas itself), use that. Driving a UI is slower, flakier, and less auditable.
 - **Use it when there's no API**: testing a frontend you just changed, navigating a vendor portal, demonstrating a flow on video.
-- **Use it when the user wants to watch.** \`replicas computer start\` exposes a live \`Desktop\` tab in the dashboard - they can watch you work in real time.
+- **Use it when the user wants to watch.** The dashboard already shows a \`Desktop\` tab. If you're talking to the user somewhere else (e.g. Slack), call \`replicas computer info\` to get the viewer URL and paste it in.
 
 ## Never use raw \`xdotool\` / \`scrot\` / \`ffmpeg\` directly
 
@@ -8169,10 +8169,10 @@ scrot /tmp/state.png
 ## Quickstart
 
 \`\`\`bash
-# 1) Make the desktop visible to the user (creates an authenticated noVNC
-#    preview on port 6080, prints the viewer URL, adds a "Desktop" tab to the
-#    dashboard).
-replicas computer start
+# 1) (Optional) Get the live viewer URL so you can share it with the user.
+#    The desktop is already running and the preview is already registered -
+#    this just looks up the URL.
+replicas computer info
 
 # 2) Launch a browser on the workspace display.
 replicas computer launch chrome
@@ -8193,20 +8193,14 @@ replicas computer record start /tmp/demo.mp4 --fps 60
 # ... do stuff ...
 replicas computer record stop
 replicas media upload /tmp/demo.mp4
-
-# 6) Tear down the live preview when done (services keep running for next time).
-replicas computer stop
 \`\`\`
 
 ## Command reference
 
-### \`replicas computer start [--port N] [--display :N] [--size WxH]\`
-Ensures all desktop services are running and creates an authenticated noVNC preview. Prints the viewer URL (\`https://<port>-<hash>.tryreplicas.com/\`). The Replicas dashboard automatically shows a \`Desktop\` tab while this preview is live - point the user at it instead of pasting the URL.
-
-Idempotent - safe to call repeatedly. Use it as the first computer-use command in any session.
+### \`replicas computer info\`
+Prints the live noVNC viewer URL (\`https://6080-<hash>.tryreplicas.com/\`) for the workspace desktop. The engine auto-registers this authenticated preview on startup; \`info\` just looks it up. Use it when you want to share the live stream URL with the user out-of-band (e.g. in a Slack reply) - the dashboard \`Desktop\` tab already points at the same URL automatically.
 
-### \`replicas computer stop [--port N]\`
-Tears down the noVNC preview (the \`Desktop\` tab disappears). The underlying Xvfb / openbox / x11vnc / browser keep running so the next \`start\` is instant.
+If invoked very early in the workspace lifecycle, \`info\` will poll briefly while the engine finishes registering the preview, then error if it's still not available.
 
 ### \`replicas computer status\`
 Prints which desktop services are running and the active preview URL (if any). Useful for debugging when a tool call seems to be doing nothing.
@@ -8279,12 +8273,11 @@ replicas computer screenshot /tmp/loaded.png
 The display is 1920\xD71080. Screenshot pixels map 1:1 to click coordinates - if your Read tool shows a button at pixel (520, 700), click \`replicas computer click 520 700\`. **No translation needed.** Modern image-reading models often imagine the screenshot is at a different resolution; trust the \`xdpyinfo\` value (\`replicas computer status\` shows the real size).
 
 ### Letting the user watch
-Always start the desktop session with \`replicas computer start\` *before* doing anything visual, even if you don't need the URL yourself. The Desktop tab appears in their dashboard. They get to watch and intervene if needed.
+The Desktop tab is already live in the dashboard - the user can open it any time. If you're communicating with the user somewhere else (Slack, PR comment, etc.), grab the URL with \`replicas computer info\` and share it inline so they can watch you work.
 
 ### Recording a deliverable
 For tasks the user wants proof of:
 \`\`\`bash
-replicas computer start                                 # makes it visible live too
 replicas computer record start /tmp/walkthrough.mp4
 # ... your work ...
 replicas computer record stop
@@ -8292,15 +8285,13 @@ replicas media upload /tmp/walkthrough.mp4
 \`\`\`
 Then embed the printed \`![\u2026](\u2026)\` line in your chat reply. See \`MEDIA.md\`.
 
-### Cleaning up
-Call \`replicas computer stop\` when you're done with the visual demo so the live preview URL goes away. The services keep running so the next \`start\` is instant.
-
 ## Failure modes
 
 - **"Desktop services script missing"**: workspace image is older than this skill. Tell the user - nothing you can do from the CLI side.
 - **\`xdotool ... failed: Can't open display\`**: Xvfb didn't come up. \`replicas computer status\` will show which service is dead. Re-running any CLI command auto-attempts to start it.
 - **Browser doesn't appear after \`launch chrome\`**: give it 1-2s, then screenshot. Chrome cold-start on the virtual display takes ~500ms but bigger pages take longer.
 - **Live preview shows static / black screen**: the browser may have crashed. \`replicas computer status\` should show no Chrome process - re-launch.
+- **\`replicas computer info\` errors with "not registered"**: engine couldn't register the preview at startup (transient monolith error, or warming mode). Re-running the engine usually fixes it. Until it's registered, the Desktop tab will show a placeholder.
 
 ## What gets baked in vs. lazy
 
@@ -8308,10 +8299,10 @@ Call \`replicas computer stop\` when you're done with the visual demo so the liv
 |---|---|
 | \`xvfb\`, \`openbox\`, \`tint2\`, \`x11vnc\`, \`websockify\`, \`xdotool\`, \`scrot\`, \`ffmpeg\`, \`google-chrome\` | Baked into the workspace image |
 | Xvfb / openbox / tint2 / x11vnc / websockify processes | Started at workspace boot (\`replicas-start-desktop-services\`) |
-| noVNC preview URL (port 6080) | **Lazy** - created by \`replicas computer start\` |
-| Dashboard \`Desktop\` tab | Appears when the preview URL is live, disappears on \`stop\` |
+| noVNC preview URL (port 6080) | Registered by the engine on startup (authenticated) |
+| Dashboard \`Desktop\` tab | Always available once the engine has registered the preview |
 
-You can call any of the input tools (\`click\`, \`type\`, \`screenshot\`, etc.) without first calling \`start\` - they'll work since the daemons are running. \`start\` is only needed when you want the user to see the live stream.
+You can call any of the input tools (\`click\`, \`type\`, \`screenshot\`, etc.) immediately - the daemons are already running.
 `;
 var COMPUTER_ABILITY = {
   label: "Computer use",
@@ -12835,6 +12826,8 @@ var STATE_DIR = process.env.REPLICAS_DESKTOP_STATE_DIR || "/tmp/replicas-compute
 var DEFAULT_DISPLAY = process.env.REPLICAS_DESKTOP_DISPLAY || ":99";
 var NOVNC_PORT = process.env.REPLICAS_DESKTOP_NOVNC_PORT ? parseInt(process.env.REPLICAS_DESKTOP_NOVNC_PORT, 10) : DESKTOP_NOVNC_PORT;
 var SERVICES_SCRIPT = "/usr/local/bin/replicas-start-desktop-services";
+var INFO_WAIT_TIMEOUT_MS = 1e4;
+var INFO_WAIT_INTERVAL_MS = 500;
 function fail(msg) {
   throw new Error(msg);
 }
@@ -12868,43 +12861,33 @@ function parseCoord(value, label) {
 function resolvePath(p) {
   return isAbsolute(p) ? p : resolve(process.cwd(), p);
 }
-async function computerStartCommand(options) {
-  if (options.display) process.env.REPLICAS_DESKTOP_DISPLAY = options.display;
-  if (options.size) {
-    const m = /^(\d+)x(\d+)$/.exec(options.size);
-    if (!m) fail(`--size must be WIDTHxHEIGHT (got "${options.size}")`);
-    process.env.REPLICAS_DESKTOP_WIDTH = m[1];
-    process.env.REPLICAS_DESKTOP_HEIGHT = m[2];
-  }
-  ensureServicesRunning();
-  const port = options.port ? parsePreviewPort(options.port) : NOVNC_PORT;
-  let publicUrl;
+async function lookupDesktopViewerUrl() {
   try {
-    const result = await createAgentPreview(port, true);
-    publicUrl = result.preview.publicUrl;
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    if (!/409/.test(msg)) throw err;
     const list = await listAgentPreviews();
-    const existing = list.previews.find((p) => p.port === port);
-    if (!existing) throw err;
-    publicUrl = existing.publicUrl;
+    const preview2 = list.previews.find((p) => p.port === NOVNC_PORT);
+    return preview2 ? getDesktopViewerUrl(preview2.publicUrl) : null;
+  } catch {
+    return null;
   }
-  const viewerUrl = getDesktopViewerUrl(publicUrl);
-  mkdirSync(STATE_DIR, { recursive: true });
-  writeFileSync(
-    `${STATE_DIR}/preview.json`,
-    JSON.stringify({ port, publicUrl, viewerUrl }, null, 2)
-  );
-  console.log(viewerUrl);
-  console.error(chalk19.dim(`Desktop preview ready (port ${port}, authenticated).`));
-  console.error(chalk19.dim(`The Replicas dashboard will show a "Desktop" tab while this preview is live.`));
 }
-async function computerStopCommand(options) {
-  const port = options.port ? parsePreviewPort(options.port) : NOVNC_PORT;
-  await deleteAgentPreview(port);
-  rmSync(`${STATE_DIR}/preview.json`, { force: true });
-  console.log(`Desktop preview stopped on port ${port}`);
+async function waitForDesktopViewerUrl(timeoutMs) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const url = await lookupDesktopViewerUrl();
+    if (url) return url;
+    await new Promise((resolve2) => setTimeout(resolve2, INFO_WAIT_INTERVAL_MS));
+  }
+  return await lookupDesktopViewerUrl();
+}
+async function computerInfoCommand() {
+  const viewerUrl = await waitForDesktopViewerUrl(INFO_WAIT_TIMEOUT_MS);
+  if (!viewerUrl) {
+    fail(
+      `Desktop preview for port ${NOVNC_PORT} is not registered. The engine registers it at startup \u2014 check /tmp/replicas-desktop-stack.log and engine logs for errors.`
+    );
+  }
+  console.log(viewerUrl);
+  console.error(chalk19.dim(`Share this URL with the user to let them watch the desktop live.`));
 }
 async function computerStatusCommand() {
   const procs = ["Xvfb", "openbox", "tint2", "x11vnc", "websockify"];
@@ -12913,15 +12896,11 @@ async function computerStatusCommand() {
     const running = r.status === 0 && !!r.stdout?.toString().trim();
     console.log(`  ${running ? chalk19.green("\u25CF") : chalk19.red("\u25CB")} ${p}`);
   }
-  const previewFile = `${STATE_DIR}/preview.json`;
-  if (existsSync(previewFile)) {
-    try {
-      const meta = JSON.parse(readFileSync(previewFile, "utf8"));
-      console.log(`  ${chalk19.cyan("preview")}: ${meta.viewerUrl}`);
-    } catch {
-    }
+  const viewerUrl = await lookupDesktopViewerUrl();
+  if (viewerUrl) {
+    console.log(`  ${chalk19.cyan("preview")}: ${viewerUrl}`);
   } else {
-    console.log(`  ${chalk19.dim("preview: not started (run `replicas computer start`)")}`);
+    console.log(`  ${chalk19.dim("preview: not yet registered (engine registers it at startup)")}`);
   }
 }
 async function computerScreenshotCommand(path6) {
@@ -16602,7 +16581,7 @@ Deleted file ${pathOrId}.
 }
 
 // src/index.ts
-var CLI_VERSION = "0.2.200";
+var CLI_VERSION = "0.2.202";
 function parseBooleanOption(value) {
   if (value === "true") return true;
   if (value === "false") return false;
@@ -17227,8 +17206,7 @@ if (isAgentMode()) {
       process.exit(1);
     }
   };
-  computer.command("start").description("Ensure the desktop stack is running and create an authenticated noVNC preview URL. Prints the viewer URL.").option("--port <port>", "noVNC port to expose (default: 6080)").option("--display <id>", "X display to use (default: :99)").option("--size <WxH>", "Display size, e.g. 1920x1080 (default: 1920x1080)").action(wrap((options) => computerStartCommand(options)));
-  computer.command("stop").description("Tear down the noVNC preview. Desktop services stay running for the next start.").option("--port <port>", "noVNC port to unregister (default: 6080)").action(wrap((options) => computerStopCommand(options)));
+  computer.command("info").description("Print the live noVNC viewer URL for the workspace desktop. The preview is registered automatically at engine startup, so this just looks it up \u2014 share the URL with the user to let them watch the desktop.").action(wrap(() => computerInfoCommand()));
   computer.command("status").description("Show which desktop services are running and the active preview URL").action(wrap(() => computerStatusCommand()));
   computer.command("screenshot <path>").description("Capture the current desktop to a PNG file. Use the path with `replicas media upload` to share it.").action(wrap((path6) => computerScreenshotCommand(path6)));
   computer.command("click <x> <y>").description("Move to (x, y) and click. Coordinates are in pixels on the workspace display.").option("-b, --button <n>", "Mouse button (1=left, 2=middle, 3=right). Default 1.").option("--double", "Double-click instead of single-click").option("--modifiers <mods>", "Hold modifier keys during the click, e.g. ctrl or ctrl+shift").action(wrap((x, y, options) => computerClickCommand(x, y, options)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-cli",
-  "version": "0.2.200",
+  "version": "0.2.202",
   "description": "CLI for managing Replicas workspaces - SSH into cloud dev environments with automatic port forwarding",
   "main": "dist/index.mjs",
   "bin": {