replicas-engine 0.1.232 → 0.1.233

package/dist/src/index.js

@@ -357,18 +357,18 @@ var GIT_PARTIAL_CLONE_FILTER = "blob:none";
 
 // ../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.
 
@@ -376,7 +376,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
 
@@ -395,10 +395,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
@@ -419,20 +419,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.
@@ -505,12 +499,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
@@ -518,15 +511,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
 
@@ -534,10 +525,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",
@@ -1792,7 +1783,8 @@ function isClaudeAuthErrorText(text) {
 }
 
 // ../shared/src/engine/environment.ts
-var DAYTONA_SNAPSHOT_ID = "29-05-2026-royal-york-v3";
+var DAYTONA_SNAPSHOT_ID = "29-05-2026-royal-york-v4";
+var DESKTOP_NOVNC_PORT = 6080;
 
 // ../shared/src/engine/types.ts
 var DEFAULT_CHAT_TITLES = {
@@ -2154,21 +2146,48 @@ var BaseRefreshManager = class {
   }
 };
 
+// src/services/monolith-service.ts
+async function monolithRequest(path4, init = {}) {
+  if (!ENGINE_ENV.WORKSPACE_ID) {
+    throw new Error("WORKSPACE_ID is not set; cannot call monolith");
+  }
+  return fetch(`${ENGINE_ENV.MONOLITH_URL}${path4}`, {
+    method: init.method ?? "POST",
+    headers: {
+      Authorization: `Bearer ${ENGINE_ENV.REPLICAS_ENGINE_SECRET}`,
+      "X-Workspace-Id": ENGINE_ENV.WORKSPACE_ID,
+      "Content-Type": "application/json"
+    },
+    body: init.body === void 0 ? void 0 : JSON.stringify(init.body),
+    signal: init.signal
+  });
+}
+var MonolithService = class {
+  async sendEvent(event) {
+    if (!ENGINE_ENV.WORKSPACE_ID) {
+      return;
+    }
+    try {
+      const response = await monolithRequest("/v1/engine/webhook", { body: event });
+      if (!response.ok) {
+        const errorText = await response.text();
+        console.error(`[MonolithService] Failed to send event: ${response.status} ${errorText}`);
+      }
+    } catch (error) {
+      console.error("[MonolithService] Failed to send event:", error);
+    }
+  }
+};
+var monolithService = new MonolithService();
+
 // src/managers/github-token-manager.ts
 var GitHubTokenManager = class extends BaseRefreshManager {
   constructor() {
     super("GitHubTokenManager");
   }
-  async doRefresh(config) {
+  async doRefresh(_config) {
     console.log("[GitHubTokenManager] Refreshing GitHub token...");
-    const response = await fetch(`${config.monolithUrl}/v1/engine/github/refresh-token`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${config.engineSecret}`,
-        "X-Workspace-Id": config.workspaceId,
-        "Content-Type": "application/json"
-      }
-    });
+    const response = await monolithRequest("/v1/engine/github/refresh-token");
     if (!response.ok) {
       const errorText = await response.text();
       throw new Error(`Token refresh failed: ${response.status} ${errorText}`);
@@ -2233,19 +2252,13 @@ var ClaudeTokenManager = class extends BaseRefreshManager {
     }
     return null;
   }
-  async doRefresh(config) {
-    await this.refreshWithRequest(config);
+  async doRefresh(_config) {
+    await this.refreshWithRequest();
   }
-  async refreshWithRequest(config, request) {
+  async refreshWithRequest(request) {
     console.log("[ClaudeTokenManager] Refreshing Claude credentials...");
-    const response = await fetch(`${config.monolithUrl}/v1/engine/claude/refresh-credentials`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${config.engineSecret}`,
-        "X-Workspace-Id": config.workspaceId,
-        "Content-Type": "application/json"
-      },
-      ...request ? { body: JSON.stringify(request) } : {}
+    const response = await monolithRequest("/v1/engine/claude/refresh-credentials", {
+      body: request
     });
     if (!response.ok) {
       const errorText = await response.text();
@@ -2261,7 +2274,7 @@ var ClaudeTokenManager = class extends BaseRefreshManager {
     try {
       console.log("[ClaudeTokenManager] Fetching fresh credentials from monolith after auth failure...");
       const failedMethod = ENGINE_ENV.REPLICAS_CLAUDE_AUTH_METHOD;
-      await this.refreshWithRequest(config, failedMethod && failedMethod !== "none" ? {
+      await this.refreshWithRequest(failedMethod && failedMethod !== "none" ? {
         failedMethod,
         failureReason
       } : void 0);
@@ -2345,19 +2358,13 @@ var CodexTokenManager = class extends BaseRefreshManager {
     }
     return null;
   }
-  async doRefresh(config) {
-    await this.refreshWithRequest(config);
+  async doRefresh(_config) {
+    await this.refreshWithRequest();
   }
-  async refreshWithRequest(config, request) {
+  async refreshWithRequest(request) {
     console.log("[CodexTokenManager] Refreshing Codex credentials...");
-    const response = await fetch(`${config.monolithUrl}/v1/engine/codex/refresh-credentials`, {
-      method: "POST",
-      headers: {
-        Authorization: `Bearer ${config.engineSecret}`,
-        "X-Workspace-Id": config.workspaceId,
-        "Content-Type": "application/json"
-      },
-      ...request ? { body: JSON.stringify(request) } : {}
+    const response = await monolithRequest("/v1/engine/codex/refresh-credentials", {
+      body: request
     });
     if (!response.ok) {
       const errorText = await response.text();
@@ -2373,7 +2380,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
     try {
       console.log("[CodexTokenManager] Fetching fresh credentials from monolith after auth failure...");
       const failedMethod = ENGINE_ENV.REPLICAS_CODEX_AUTH_METHOD;
-      await this.refreshWithRequest(config, failedMethod === "oauth" || failedMethod === "api_key" ? {
+      await this.refreshWithRequest(failedMethod === "oauth" || failedMethod === "api_key" ? {
         failedMethod,
         failureReason
       } : void 0);
@@ -3838,6 +3845,49 @@ var PreviewService = class {
 };
 var previewService = new PreviewService();
 
+// src/services/desktop-preview-service.ts
+var REGISTRATION_TIMEOUT_MS = 3e4;
+var RETRY_DELAY_MS = 2e3;
+var ATTEMPT_TIMEOUT_MS = 8e3;
+async function attemptRegistration() {
+  try {
+    const response = await monolithRequest("/v1/previews", {
+      body: { port: DESKTOP_NOVNC_PORT, authenticated: true },
+      signal: AbortSignal.timeout(ATTEMPT_TIMEOUT_MS)
+    });
+    if (response.ok || response.status === 409) {
+      console.log(
+        `[DesktopPreview] Registered port ${DESKTOP_NOVNC_PORT} (status ${response.status}).`
+      );
+      return true;
+    }
+    const errorText = await response.text().catch(() => "");
+    console.error(
+      `[DesktopPreview] Registration failed: ${response.status} ${errorText}`
+    );
+    return false;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[DesktopPreview] Registration error: ${message}`);
+    return false;
+  }
+}
+async function registerDesktopPreview() {
+  if (IS_WARMING_MODE || !ENGINE_ENV.WORKSPACE_ID) {
+    return;
+  }
+  const deadline = Date.now() + REGISTRATION_TIMEOUT_MS;
+  while (Date.now() < deadline) {
+    if (await attemptRegistration()) {
+      return;
+    }
+    await new Promise((resolve3) => setTimeout(resolve3, RETRY_DELAY_MS));
+  }
+  console.error(
+    `[DesktopPreview] Gave up registering port ${DESKTOP_NOVNC_PORT} after ${REGISTRATION_TIMEOUT_MS}ms`
+  );
+}
+
 // src/services/chat/chat-service.ts
 import { existsSync as existsSync7 } from "fs";
 import { appendFile as appendFile5, copyFile, mkdir as mkdir11, readFile as readFile8, rename as rename2, rm } from "fs/promises";
@@ -4631,33 +4681,6 @@ var MessageQueueService = class {
   }
 };
 
-// src/services/monolith-service.ts
-var MonolithService = class {
-  async sendEvent(event) {
-    if (!ENGINE_ENV.WORKSPACE_ID) {
-      return;
-    }
-    try {
-      const response = await fetch(`${ENGINE_ENV.MONOLITH_URL}/v1/engine/webhook`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${ENGINE_ENV.REPLICAS_ENGINE_SECRET}`,
-          "X-Workspace-Id": ENGINE_ENV.WORKSPACE_ID,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(event)
-      });
-      if (!response.ok) {
-        const errorText = await response.text();
-        console.error(`[MonolithService] Failed to send event: ${response.status} ${errorText}`);
-      }
-    } catch (error) {
-      console.error("[MonolithService] Failed to send event:", error);
-    }
-  }
-};
-var monolithService = new MonolithService();
-
 // src/managers/coding-agent-manager.ts
 var MAX_INTERRUPT_QUEUE_ITEMS = 1e3;
 var MAX_INTERRUPT_QUEUE_CHARS = 2e5;
@@ -8177,15 +8200,7 @@ var KeepAliveService = class _KeepAliveService {
       return;
     }
     try {
-      const response = await fetch(`${ENGINE_ENV.MONOLITH_URL}/v1/engine/keep-alive`, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${ENGINE_ENV.REPLICAS_ENGINE_SECRET}`,
-          "X-Workspace-Id": ENGINE_ENV.WORKSPACE_ID,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({})
-      });
+      const response = await monolithRequest("/v1/engine/keep-alive", { body: {} });
       if (!response.ok) {
         console.warn(`[KeepAlive] Ping returned ${response.status}`);
       }
@@ -10510,6 +10525,7 @@ serve(
     await chatService.initialize();
     await previewService.initialize();
     engineReady = true;
+    void registerDesktopPreview();
     if (!IS_WARMING_MODE) {
       await githubTokenManager.start();
       await claudeTokenManager.start();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.232",
+  "version": "0.1.233",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",