@vibevibes/mcp 0.8.1 → 0.9.1

package/dist/index.d.ts

@@ -1,9 +1,7 @@
 /**
- * vibevibes-mcp — MCP server for agent participation in vibevibes experiences.
+ * vibevibes MCP server — connects Claude to a running vibevibes experience.
  *
- * The `connect` tool is the single entry point: it joins the server, writes
- * the state file (for the stop hook to poll), and returns room info.
- *
- * 4 tools: connect, act, look, disconnect
+ * The dev server (vibevibes-dev from @vibevibes/sdk) must be running first.
+ * 5 tools: connect, act, look, screenshot, disconnect
  */
 export {};

package/dist/index.js

@@ -1,10 +1,8 @@
 /**
- * vibevibes-mcp — MCP server for agent participation in vibevibes experiences.
+ * vibevibes MCP server — connects Claude to a running vibevibes experience.
  *
- * The `connect` tool is the single entry point: it joins the server, writes
- * the state file (for the stop hook to poll), and returns room info.
- *
- * 4 tools: connect, act, look, disconnect
+ * The dev server (vibevibes-dev from @vibevibes/sdk) must be running first.
+ * 5 tools: connect, act, look, screenshot, disconnect
  */
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -12,101 +10,35 @@ import { z } from "zod";
 import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync, readdirSync } from "node:fs";
 import { resolve, dirname } from "node:path";
 import { fileURLToPath } from "node:url";
-import { spawn, spawnSync } from "node:child_process";
+import { spawnSync } from "node:child_process";
 /** Extract error message from unknown catch value. */
 function toErrorMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
-// ── Server auto-start ──────────────────────────────────────
-let serverStarted = false;
+// ── Server check ──────────────────────────────────────
+let serverReachable = false;
 /**
- * Check if the server is reachable. If not, start it in a child process.
- * The server loads the experience from the given project root.
+ * Check if the dev server is reachable.
+ * If not, throw an error telling the agent to run `npm run dev`.
  */
-async function ensureServerRunning(projectRoot) {
-    if (serverStarted)
+async function ensureServerRunning() {
+    if (serverReachable)
         return;
-    // Check if server is already running
     try {
         const controller = new AbortController();
         const timer = setTimeout(() => controller.abort(), 2000);
         const res = await fetch(`${SERVER_URL}/state`, { signal: controller.signal });
         clearTimeout(timer);
         if (res.ok) {
-            serverStarted = true;
+            serverReachable = true;
             return;
         }
     }
     catch {
-        // Server not running — start it
-    }
-    // Find the server entry point (in mcp/dist/ or mcp/src/)
-    const serverScript = resolve(MCP_ROOT, "dist/server.js");
-    const serverTs = resolve(MCP_ROOT, "src/server.ts");
-    // Start server as a child process using a small bootstrap script
-    const bootstrapCode = `
-    import("${serverScript.replace(/\\/g, "/")}").then(m => {
-      m.startServer({ projectRoot: "${projectRoot.replace(/\\/g, "/")}" });
-    }).catch(e => {
-      // Fallback: try tsx for .ts source
-      import("${serverTs.replace(/\\/g, "/")}").then(m => {
-        m.startServer({ projectRoot: "${projectRoot.replace(/\\/g, "/")}" });
-      }).catch(e2 => {
-        console.error("Failed to start server:", e2.message);
-        process.exit(1);
-      });
-    });
-  `;
-    const child = spawn(process.execPath, ["--input-type=module", "-e", bootstrapCode], {
-        stdio: ["pipe", "pipe", "pipe"],
-        detached: true,
-        env: { ...process.env, PORT: new URL(SERVER_URL).port || "4321" },
-    });
-    child.unref();
-    // Store child for cleanup
-    serverChild = child;
-    child.stderr?.on("data", (chunk) => {
-        const msg = chunk.toString().trim();
-        if (msg)
-            console.error(`[server] ${msg}`);
-    });
-    // Wait for server to become available (up to 15 seconds)
-    const deadline = Date.now() + 15000;
-    while (Date.now() < deadline) {
-        await new Promise((r) => setTimeout(r, 500));
-        try {
-            const controller = new AbortController();
-            const timer = setTimeout(() => controller.abort(), 1500);
-            const res = await fetch(`${SERVER_URL}/state`, { signal: controller.signal });
-            clearTimeout(timer);
-            if (res.ok) {
-                serverStarted = true;
-                return;
-            }
-        }
-        catch {
-            // Keep waiting
-        }
+        // Not reachable
     }
-    throw new Error(`Server failed to start within 15 seconds at ${SERVER_URL}`);
+    throw new Error(`Dev server not running at ${SERVER_URL}. Run \`npm run dev\` first (in a background shell), then try again.`);
 }
-let serverChild = null;
-// Cleanup server on exit
-process.on("exit", () => { if (serverChild)
-    try {
-        serverChild.kill();
-    }
-    catch { } });
-process.on("SIGINT", () => { if (serverChild)
-    try {
-        serverChild.kill();
-    }
-    catch { } process.exit(0); });
-process.on("SIGTERM", () => { if (serverChild)
-    try {
-        serverChild.kill();
-    }
-    catch { } process.exit(0); });
 // Resolve server URL: CLI arg > env var > localhost default
 const RAW_SERVER_URL = process.argv[2] ||
     process.env.VIBEVIBES_SERVER_URL ||
@@ -323,8 +255,8 @@ Call this first, then use act to interact. The stop hook keeps you present.`, {
         if (url) {
             SERVER_URL = url.replace(/\/$/, "");
         }
-        // Auto-start server if not running
-        await ensureServerRunning(PROJECT_ROOT);
+        // Check dev server is running
+        await ensureServerRunning();
         // Check if already connected (same process re-calling connect)
         let identity = null;
         if (currentOwner && existsSync(AGENTS_DIR)) {

package/hooks/logic.js

@@ -136,9 +136,14 @@ export function makeDecision(ctx, iteration) {
     // Experience signaled completion — allow exit (agent file already deleted by stop-hook)
     if (ctx.observation?.done)
         return null;
-    // Nothing to react to — allow exit silently (zero wasted tokens)
-    if (!hasEvents && !hasError && !hasBrowserErrors && !hasObserveError)
-        return null;
+    // Always block exit while connected — the agent should stay alive.
+    // If there are events/errors, include them. Otherwise, minimal keepalive.
+    if (!hasEvents && !hasError && !hasBrowserErrors && !hasObserveError) {
+        return {
+            decision: "block",
+            reason: "Still connected. Waiting for activity.",
+        };
+    }
     const reason = formatPrompt(ctx);
     return {
         decision: "block",

package/package.json

@@ -1,33 +1,25 @@
 {
   "name": "@vibevibes/mcp",
-  "version": "0.8.1",
-  "description": "MCP server + runtime engine for vibevibes experiences",
+  "version": "0.9.1",
+  "description": "MCP server — connects Claude to vibevibes experiences",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "vibevibes": "./bin/cli.js",
-    "vibevibes-serve": "./bin/serve.js"
+    "vibevibes": "./bin/cli.js"
   },
   "scripts": {
-    "build": "tsc && tsc -p tsconfig.hooks.json && node -e \"const{cpSync}=require('fs');cpSync('src/viewer','dist/viewer',{recursive:true})\"",
+    "build": "tsc && tsc -p tsconfig.hooks.json",
     "postinstall": "node ./bin/postinstall.js",
     "prepublishOnly": "npm run build",
     "dev": "tsx src/index.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.9.0",
-    "@vibevibes/sdk": "^0.3.0",
-    "esbuild": "^0.27.2",
-    "express": "^4.18.2",
-    "ws": "^8.19.0",
-    "zod": "^3.22.4",
-    "zod-to-json-schema": "^3.22.4"
+    "zod": "^3.22.4"
   },
   "devDependencies": {
-    "@types/express": "^4.17.21",
     "@types/node": "^20.11.5",
-    "@types/ws": "^8.18.1",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3"
   },
@@ -50,10 +42,6 @@
     "vibevibes",
     "mcp",
     "model-context-protocol",
-    "multiplayer",
-    "ai-native",
-    "shared-experience",
-    "real-time",
-    "websocket"
+    "ai-native"
   ]
 }

package/bin/serve.js

@@ -1,41 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Start the vibevibes server for an experience.
- *
- * Usage:
- *   npx vibevibes-serve              # serves from current directory
- *   npx vibevibes-serve ./my-exp     # serves from a specific path
- */
-
-import { resolve } from "node:path";
-import { writeFileSync, existsSync } from "node:fs";
-import { execSync } from "node:child_process";
-import { startServer } from "../dist/server.js";
-
-const projectRoot = resolve(process.argv[2] || ".");
-const port = parseInt(process.env.PORT || "4321", 10);
-
-// Find git root (where Claude Code reads .mcp.json from)
-let mcpJsonDir = projectRoot;
-try {
-  mcpJsonDir = execSync("git rev-parse --show-toplevel", { cwd: projectRoot, encoding: "utf-8" }).trim();
-} catch {}
-
-// Auto-generate .mcp.json so Claude Code can connect via /mcp
-const mcpJsonPath = resolve(mcpJsonDir, ".mcp.json");
-if (!existsSync(mcpJsonPath)) {
-  const config = {
-    mcpServers: {
-      vibevibes: {
-        command: "npx",
-        args: ["vibevibes-mcp"],
-        env: { VIBEVIBES_SERVER_URL: `http://localhost:${port}` },
-      },
-    },
-  };
-  writeFileSync(mcpJsonPath, JSON.stringify(config, null, 2) + "\n");
-  console.log(`  .mcp.json: wrote ${mcpJsonPath}`);
-}
-
-startServer({ projectRoot, port });

package/dist/bundler.d.ts

@@ -1,36 +0,0 @@
-/**
- * Experience bundler — produces server and client bundles from src/index.tsx.
- *
- * Server bundle: CJS, eval'd via new Function() to extract tools + manifest.
- * Client bundle: ESM, loaded in browser via blob URL + dynamic import().
- *
- * Extracted from create-experience/runtime/bundler.ts into @vibevibes/runtime.
- */
-/**
- * Bundle for server-side tool execution (Node.js eval).
- * Returns the raw ExperienceModule extracted via new Function().
- */
-export declare function bundleForServer(entryPath: string): Promise<string>;
-/**
- * Evaluate a server bundle and extract the ExperienceModule.
- */
-export declare function evalServerBundle(serverCode: string): Promise<unknown>;
-/**
- * Bundle for client-side Canvas rendering (browser).
- * Returns pure ESM. External imports (react, zod, etc.) are left as-is —
- * the viewer's import map resolves them in the browser.
- */
-export declare function bundleForClient(entryPath: string): Promise<string>;
-/**
- * Build both bundles from an entry file.
- */
-export declare function buildExperience(entryPath: string): Promise<{
-    serverCode: string;
-    clientCode: string;
-}>;
-/**
- * Validate a client bundle for common issues.
- * Lightweight — esbuild already validates syntax. This just checks the output exists.
- * Returns null if OK, or an error message string.
- */
-export declare function validateClientBundle(code: string): string | null;

package/dist/bundler.js

@@ -1,254 +0,0 @@
-/**
- * Experience bundler — produces server and client bundles from src/index.tsx.
- *
- * Server bundle: CJS, eval'd via new Function() to extract tools + manifest.
- * Client bundle: ESM, loaded in browser via blob URL + dynamic import().
- *
- * Extracted from create-experience/runtime/bundler.ts into @vibevibes/runtime.
- */
-import * as esbuild from "esbuild";
-const EXTERNALS = ["react", "react/jsx-runtime", "react-dom", "react-dom/client", "yjs", "zod", "@vibevibes/sdk", "@vibevibes/runtime"];
-// Additional externals for server-only bundles — heavy rendering libraries that
-// aren't needed for tool/test execution. Canvas components are never called server-side.
-const SERVER_ONLY_EXTERNALS = [
-    ...EXTERNALS,
-    "three", "three/*",
-    "@react-three/fiber", "@react-three/fiber/*",
-    "@react-three/drei", "@react-three/drei/*",
-];
-/**
- * Strip esbuild's CJS annotation: `0 && (module.exports = {...})`.
- * Uses brace-depth counting to handle nested objects/functions in the annotation,
- * unlike a simple `[^}]*` regex which breaks on nested braces.
- */
-function stripCjsAnnotation(code) {
-    const marker = /0\s*&&\s*\(module\.exports\s*=\s*\{/g;
-    let match;
-    let result = code;
-    while ((match = marker.exec(code)) !== null) {
-        const start = match.index;
-        let depth = 1; // we matched the opening `{`
-        let i = match.index + match[0].length;
-        while (i < code.length && depth > 0) {
-            if (code[i] === "{")
-                depth++;
-            else if (code[i] === "}")
-                depth--;
-            i++;
-        }
-        // Skip the closing `)` and optional `;`
-        if (i < code.length && code[i] === ")")
-            i++;
-        if (i < code.length && code[i] === ";")
-            i++;
-        result = result.slice(0, start) + "/* [vibevibes] stripped CJS annotation */" + result.slice(i);
-        break; // Only one annotation per bundle
-    }
-    return result;
-}
-/**
- * Strip import/export statements for external packages.
- * The runtime provides these via globalThis (browser) or function args (server).
- */
-/**
- * Strip external imports from a CJS server bundle so it can be eval'd with new Function().
- * Only used for server bundles — client bundles keep imports (resolved by browser import map).
- */
-function stripExternalImports(code, externals = EXTERNALS) {
-    let result = code;
-    for (const ext of externals) {
-        let escaped;
-        if (ext.endsWith("/*")) {
-            const base = ext.slice(0, -2).replace(/[.*+?^${}()|[\]\\\/]/g, "\\$&");
-            escaped = `${base}\\/[^"']+`;
-        }
-        else {
-            escaped = ext.replace(/[.*+?^${}()|[\]\\\/]/g, "\\$&");
-        }
-        // CJS: var import_X = __toESM(require("pkg"), N); or var import_X = require("pkg");
-        result = result.replace(new RegExp(`var\\s+\\w+\\s*=\\s*(?:__toESM\\()?require\\(["']${escaped}["']\\)[^;]{0,500};`, "g"), "");
-    }
-    return result;
-}
-/**
- * CJS shim definitions for server-side eval (new Function()).
- * Maps esbuild-generated variable names to runtime-provided globals.
- */
-const SDK_CORE_SHIM = "{ defineExperience: defineExperience, defineTool: defineTool, defineTest: defineTest, defineStream: defineStream, default: { defineExperience: defineExperience, defineTool: defineTool, defineTest: defineTest, defineStream: defineStream } }";
-const CJS_BASE_SHIMS = {
-    import_react: "{ default: React, __esModule: true, createElement: React.createElement, Fragment: React.Fragment, useState: React.useState, useEffect: React.useEffect, useCallback: React.useCallback, useMemo: React.useMemo, useRef: React.useRef, useContext: React.useContext, useReducer: React.useReducer, createContext: React.createContext, forwardRef: React.forwardRef, memo: React.memo }",
-    import_zod: "{ z: z, default: z }",
-    import_yjs: "{ default: Y }",
-    import_sdk: SDK_CORE_SHIM,
-    import_vibevibes_sdk: SDK_CORE_SHIM,
-    import_runtime: SDK_CORE_SHIM,
-    import_vibevibes_runtime: SDK_CORE_SHIM,
-    import_react_dom: "{ default: {}, __esModule: true }",
-    import_client: "{ default: {}, __esModule: true }",
-    // Proxy stubs for rendering libraries (server-side only — Canvas is never called)
-    import_three: "(new Proxy({}, { get: (_, p) => typeof p === 'string' ? function(){} : undefined }))",
-    import_fiber: "(new Proxy({}, { get: (_, p) => typeof p === 'string' ? function(){} : undefined }))",
-    import_drei: "(new Proxy({}, { get: (_, p) => typeof p === 'string' ? function(){} : undefined }))",
-};
-/**
- * Inject CJS shim variables for server-side eval.
- */
-function injectCjsShims(code) {
-    const lines = [];
-    // Emit base shims
-    for (const [name, value] of Object.entries(CJS_BASE_SHIMS)) {
-        lines.push(`var ${name} = ${value};`);
-    }
-    // Scan for numbered variants (e.g. import_react2, import_zod3) and alias them
-    for (const baseName of Object.keys(CJS_BASE_SHIMS)) {
-        const pattern = new RegExp(`\\b(${baseName}(\\d+))\\b`, "g");
-        const seen = new Set();
-        let match;
-        while ((match = pattern.exec(code)) !== null) {
-            const numberedName = match[1];
-            if (!seen.has(numberedName)) {
-                seen.add(numberedName);
-                lines.push(`var ${numberedName} = ${baseName};`);
-            }
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * Format esbuild errors into actionable messages with file:line and suggestions.
- */
-function formatEsbuildError(err, target) {
-    const buildErr = err;
-    if (buildErr.errors && Array.isArray(buildErr.errors)) {
-        const formatted = buildErr.errors.map((e) => {
-            const loc = e.location
-                ? `${e.location.file}:${e.location.line}:${e.location.column}`
-                : "unknown location";
-            return `  ${loc}: ${e.text}`;
-        }).join("\n");
-        return new Error(`Build failed (${target} bundle):\n${formatted}\n\n` +
-            `Common fixes:\n` +
-            `- Check for syntax errors at the indicated location\n` +
-            `- Ensure all imports resolve to existing files in src/\n` +
-            `- Verify @vibevibes/sdk imports match the available exports`);
-    }
-    return err instanceof Error ? err : new Error(String(err));
-}
-/**
- * Bundle for server-side tool execution (Node.js eval).
- * Returns the raw ExperienceModule extracted via new Function().
- */
-export async function bundleForServer(entryPath) {
-    let result;
-    try {
-        result = await esbuild.build({
-            entryPoints: [entryPath],
-            bundle: true,
-            format: "cjs",
-            platform: "node",
-            target: "es2022",
-            write: false,
-            external: SERVER_ONLY_EXTERNALS,
-            jsx: "transform",
-            jsxFactory: "React.createElement",
-            jsxFragment: "React.Fragment",
-            logLevel: "silent",
-        });
-    }
-    catch (err) {
-        throw formatEsbuildError(err, "server");
-    }
-    const outputFile = result.outputFiles?.[0];
-    if (!outputFile)
-        throw new Error("esbuild produced no output files for server bundle");
-    let code = outputFile.text;
-    code = stripExternalImports(code, SERVER_ONLY_EXTERNALS);
-    // Strip user-code React hook destructuring (already provided by CJS shims)
-    code = code.replace(/(?:const|let|var)\s+\{[^}]*?\b(?:useState|useEffect|useCallback|useMemo|useRef|useContext|useReducer)\b[^}]*?\}\s*=\s*(?:React|import_react\w*)\s*;/g, "/* [vibevibes] stripped duplicate React destructuring */");
-    // Inject CJS shims for esbuild-generated variable references
-    // Pass code so we can detect numbered variants (import_react2, etc.)
-    code = injectCjsShims(code) + "\n" + code;
-    // Strip esbuild's CJS annotation `0 && (module.exports = {...})` — dead code that
-    // causes syntax errors when module.exports is replaced with var assignment.
-    // Uses brace-depth counting to handle nested objects/functions in the annotation.
-    code = stripCjsAnnotation(code);
-    // Replace module.exports/export default with variable assignment
-    code = code.replace(/module\.exports\s*=\s*/g, "var __experience_export__ = ");
-    code = code.replace(/exports\.default(?!\w)\s*=\s*/g, "var __experience_export__ = ");
-    return code;
-}
-/**
- * Evaluate a server bundle and extract the ExperienceModule.
- */
-export async function evalServerBundle(serverCode) {
-    const sdk = await import("@vibevibes/sdk");
-    const { defineExperience, defineTool, defineTest, defineStream } = sdk;
-    const noop = () => null;
-    const stubReact = {
-        createElement: noop, Fragment: "Fragment",
-        useState: (init) => [typeof init === "function" ? init() : init, noop],
-        useEffect: noop, useCallback: (fn) => fn,
-        useMemo: (fn) => fn(), useRef: (init) => ({ current: init ?? null }),
-        useContext: noop, useReducer: noop,
-        createContext: noop, forwardRef: noop, memo: (x) => x,
-    };
-    const zodModule = await import("zod");
-    const z = zodModule.z ?? zodModule.default ?? zodModule;
-    const fn = new Function("globalThis", "process", "global", "React", "Y", "z", "defineExperience", "defineTool", "defineTest", "defineStream", "require", "exports", "module", "console", `"use strict";\n${serverCode}\nreturn typeof __experience_export__ !== 'undefined' ? __experience_export__ : (typeof module !== 'undefined' ? module.exports : undefined);`);
-    const fakeModule = { exports: {} };
-    const sandboxGlobal = Object.create(null);
-    const sandboxProcess = { env: { NODE_ENV: "production" } };
-    const result = fn(sandboxGlobal, sandboxProcess, sandboxGlobal, stubReact, {}, z, defineExperience, defineTool, defineTest, defineStream, (id) => { throw new Error(`require('${id}') is not supported in the vibevibes server sandbox. Add '${id}' to EXTERNALS in bundler.ts.`); }, fakeModule.exports, fakeModule, console);
-    const exports = fakeModule.exports;
-    return result?.default ?? result ?? exports?.default ?? exports;
-}
-/**
- * Bundle for client-side Canvas rendering (browser).
- * Returns pure ESM. External imports (react, zod, etc.) are left as-is —
- * the viewer's import map resolves them in the browser.
- */
-export async function bundleForClient(entryPath) {
-    let result;
-    try {
-        result = await esbuild.build({
-            entryPoints: [entryPath],
-            bundle: true,
-            format: "esm",
-            platform: "browser",
-            target: "es2020",
-            write: false,
-            external: EXTERNALS,
-            jsx: "transform",
-            jsxFactory: "React.createElement",
-            jsxFragment: "React.Fragment",
-            logLevel: "silent",
-        });
-    }
-    catch (err) {
-        throw formatEsbuildError(err, "client");
-    }
-    const clientOutputFile = result.outputFiles?.[0];
-    if (!clientOutputFile)
-        throw new Error("esbuild produced no output files for client bundle");
-    return clientOutputFile.text;
-}
-/**
- * Build both bundles from an entry file.
- */
-export async function buildExperience(entryPath) {
-    const [serverCode, clientCode] = await Promise.all([
-        bundleForServer(entryPath),
-        bundleForClient(entryPath),
-    ]);
-    return { serverCode, clientCode };
-}
-/**
- * Validate a client bundle for common issues.
- * Lightweight — esbuild already validates syntax. This just checks the output exists.
- * Returns null if OK, or an error message string.
- */
-export function validateClientBundle(code) {
-    if (!code || !code.trim())
-        return "Client bundle is empty";
-    return null;
-}

package/dist/server.d.ts

@@ -1,17 +0,0 @@
-/**
- * @vibevibes/runtime — the server engine for vibevibes experiences.
- *
- * Single-room, single-experience architecture.
- * AI agents join via MCP or HTTP. Humans join via browser.
- * Tools are the only mutation path. State is server-authoritative.
- */
-export interface ServerConfig {
-    /** Absolute path to the experience project root (where manifest.json or src/index.tsx lives). */
-    projectRoot: string;
-    /** Port to listen on. Defaults to 4321 or PORT env var. */
-    port?: number;
-}
-export declare function setPublicUrl(url: string): void;
-export declare function getBaseUrl(): string;
-export declare function startServer(config?: ServerConfig): Promise<import("http").Server>;
-export declare function setProjectRoot(root: string): void;