replicas-computer 0.3.19 → 0.3.20

package/README.md

@@ -37,7 +37,7 @@ The viewer exposes `?view=fit|native|pixel` (letterboxed, one source pixel per C
 
 WebRTC receiver timings use one-second counter differences: `decodeMs` is decode time per decoded frame; `receiverProcessingMs` runs from the first received packet to the decoded frame and already includes buffering and decoding. Neither measures physical display latency. Unsupported counters, counter resets and windows without decoded frames leave these fields absent. The timings appear in diagnostics, `__replicasDesktop` and per-viewer telemetry. See the [WebRTC stats definitions](https://www.w3.org/TR/webrtc-stats/#dom-rtcinboundrtpstreamstats-totalprocessingdelay).
 
-The server records every decision that changes the picture (viewer connects and transport fallbacks with their reason, WebRTC state changes, quality rung moves with the signals that voted for them, encoder swaps, preset changes and keyframe requests) and writes each to the stream log (`/tmp/replicas-computer/stream.log`). `GET /telemetry` returns the `/health` snapshot plus the last 200 events and five minutes of one-second samples (encoder rung, CRF, cap, keyframe interval, preset, fps and kbps; CPU; per-viewer transport, ICE path, pacer counters, socket backlog and the viewer's own reported stats). Fetch it inside the sandbox with `curl -s localhost:6080/telemetry` or through the authenticated preview URL; the dashboard's stream settings menu has **Open stream telemetry**. `REPLICAS_DESKTOP_STREAM_TELEMETRY=1` also writes every sample to the stream log for sessions longer than the in-memory history.
+The server records every decision that changes the picture (viewer connects and transport fallbacks with their reason, WebRTC state changes, quality rung moves with the signals that voted for them, encoder swaps, preset changes and keyframe requests) and writes each to the stream log (`/tmp/replicas-computer/stream.log`). `GET /telemetry` returns the `/health` snapshot plus the last 200 events and five minutes of one-second samples (encoder rung, CRF, cap, keyframe interval, preset, fps and kbps; CPU; per-viewer transport, ICE path, pacer counters, socket backlog and the viewer's own reported stats). Fetch it inside the sandbox with `curl -s localhost:6080/telemetry` or through the authenticated preview URL; the dashboard's stream settings menu has **Open stream telemetry**. `GET /snapshot` returns one 768px JPEG of the current screen; the chat's computer-use tile loads it as a preview of the desktop. `REPLICAS_DESKTOP_STREAM_TELEMETRY=1` also writes every sample to the stream log for sessions longer than the in-memory history.
 
 | Variable | Default | Meaning |
 |---|---|---|

package/dist/index.js

@@ -2932,7 +2932,7 @@ async function computerStatusCommand() {
 }
 
 // src/version.ts
-var COMPUTER_USE_VERSION = "0.3.19";
+var COMPUTER_USE_VERSION = "0.3.20";
 var COMPUTER_USE_PROTOCOL_VERSION = 1;
 
 // src/program.ts
@@ -5412,6 +5412,44 @@ async function runMediaServer() {
       }));
       return;
     }
+    if (url.pathname === "/snapshot") {
+      const capture = spawn5("ffmpeg", [
+        "-hide_banner",
+        "-loglevel",
+        "error",
+        "-f",
+        "x11grab",
+        "-draw_mouse",
+        "0",
+        "-video_size",
+        `${width}x${height}`,
+        "-i",
+        `${display}.0`,
+        "-frames:v",
+        "1",
+        "-vf",
+        "scale=768:-2",
+        "-q:v",
+        "4",
+        "-f",
+        "mjpeg",
+        "pipe:1"
+      ], { env: { ...process.env, DISPLAY: display }, stdio: ["ignore", "pipe", "ignore"] });
+      const chunks = [];
+      capture.stdout.on("data", (chunk) => chunks.push(chunk));
+      capture.on("error", () => void 0);
+      capture.on("close", (code) => {
+        response.setHeader("cache-control", "no-store");
+        if (code !== 0 || chunks.length === 0) {
+          response.statusCode = 503;
+          response.end("Snapshot unavailable");
+          return;
+        }
+        response.setHeader("content-type", "image/jpeg");
+        response.end(Buffer.concat(chunks));
+      });
+      return;
+    }
     const requested = url.pathname === "/" ? "stream-index.html" : url.pathname.slice(1);
     const path = resolve3(webroot, requested);
     if (!path.startsWith(resolve3(webroot) + "/") || !existsSync7(path) || !statSync2(path).isFile()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-computer",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "description": "Replicas workspace computer-use runtime",
   "type": "module",
   "main": "dist/index.js",