@vibevibes/mcp 0.7.0 → 0.8.0

package/dist/index.js

@@ -640,6 +640,35 @@ Use this to orient yourself before deciding whether to act.`, {
         return { content: [{ type: "text", text: `Look failed: ${toErrorMessage(err)}` }] };
     }
 });
+// ── Tool: screenshot ───────────────────────────────────────
+server.tool("screenshot", `Capture a screenshot of the experience as seen in the browser.
+
+Returns the current visual state as a PNG image. Use this to:
+- See what the UI looks like
+- Debug visual/layout issues
+- Verify your changes rendered correctly
+
+Requires at least one browser viewer to be connected.`, {}, async () => {
+    try {
+        const res = await fetchJSON("/screenshot", { timeoutMs: 15000 });
+        if (res.error) {
+            return { content: [{ type: "text", text: `Screenshot failed: ${res.error}` }] };
+        }
+        if (!res.dataUrl) {
+            return { content: [{ type: "text", text: "Screenshot returned empty" }] };
+        }
+        // dataUrl is "data:image/png;base64,..."
+        const base64 = res.dataUrl.replace(/^data:image\/\w+;base64,/, "");
+        return {
+            content: [
+                { type: "image", data: base64, mimeType: "image/png" },
+            ],
+        };
+    }
+    catch (err) {
+        return { content: [{ type: "text", text: `Screenshot failed: ${toErrorMessage(err)}` }] };
+    }
+});
 // ── Tool: disconnect ────────────────────────────────────────
 server.tool("disconnect", `Disconnect from the current experience.
 

package/dist/server.js

@@ -903,6 +903,64 @@ app.post("/browser-error", (req, res) => {
     }
     res.json({ ok: true });
 });
+// ── Screenshot ─────────────────────────────────────────────
+const screenshotCallbacks = new Map();
+app.get("/screenshot", async (_req, res) => {
+    // Find a browser WebSocket connection to request a screenshot from
+    let browserWs = null;
+    for (const [ws, actorId] of room.wsConnections.entries()) {
+        if (ws.readyState === WebSocket.OPEN && actorId.startsWith("viewer-")) {
+            browserWs = ws;
+            break;
+        }
+    }
+    // Fallback: any open connection
+    if (!browserWs) {
+        for (const [ws] of room.wsConnections.entries()) {
+            if (ws.readyState === WebSocket.OPEN) {
+                browserWs = ws;
+                break;
+            }
+        }
+    }
+    if (!browserWs) {
+        return res.status(503).json({ error: "No browser connected to capture screenshot" });
+    }
+    const id = `ss-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    try {
+        const dataUrl = await new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                screenshotCallbacks.delete(id);
+                reject(new Error("Screenshot timeout"));
+            }, 10000);
+            screenshotCallbacks.set(id, {
+                resolve: (url) => { clearTimeout(timer); resolve(url); },
+                reject: (err) => { clearTimeout(timer); reject(err); },
+            });
+            browserWs.send(JSON.stringify({ type: "screenshot_request", id }));
+        });
+        res.json({ dataUrl });
+    }
+    catch (err) {
+        res.status(500).json({ error: toErrorMessage(err) });
+    }
+});
+// Called by WebSocket handler when browser sends screenshot_response
+function handleScreenshotResponse(msg) {
+    const cb = screenshotCallbacks.get(msg.id);
+    if (!cb)
+        return;
+    screenshotCallbacks.delete(msg.id);
+    if (msg.error) {
+        cb.reject(new Error(msg.error));
+    }
+    else if (msg.dataUrl) {
+        cb.resolve(msg.dataUrl);
+    }
+    else {
+        cb.reject(new Error("Empty screenshot response"));
+    }
+}
 // ── Agent context ──────────────────────────────────────────
 app.get("/agent-context", (req, res) => {
     const rawSince = queryInt(req.query.since);
@@ -1219,6 +1277,9 @@ export async function startServer(config) {
                         }
                     }
                 }
+                if (msg.type === "screenshot_response") {
+                    handleScreenshotResponse(msg);
+                }
             }
             catch (err) {
                 if (!(err instanceof SyntaxError)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibevibes/mcp",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "MCP server + runtime engine for vibevibes experiences",
   "type": "module",
   "main": "dist/index.js",