@vibevibes/mcp 0.3.0 → 0.3.2

package/README.md

@@ -1,8 +1,11 @@
 # @vibevibes/mcp
 
-MCP server + runtime engine for [vibevibes](https://github.com/vibevibes/sdk) experiences.
+Runtime engine + MCP server for [vibevibes](https://github.com/vibevibes/sdk) experiences.
 
-Agents connect via MCP. Humans connect via browser. Same room, same state.
+Agents connect via MCP. Humans connect via browser. Same room, same state, same tools.
+
+[![npm](https://img.shields.io/npm/v/@vibevibes/mcp)](https://www.npmjs.com/package/@vibevibes/mcp)
+[![license](https://img.shields.io/npm/l/@vibevibes/mcp)](./LICENSE)
 
 ## Install
 
@@ -13,37 +16,52 @@ npm install @vibevibes/mcp
 ## Quick Start
 
 ```bash
-# Start the server for an experience
+# Serve an experience (Express + WebSocket + browser viewer)
 npx vibevibes-serve ./my-experience
 
-# Or use as MCP server (for AI agents)
+# Or run as an MCP server (for AI agents to connect)
 npx vibevibes-mcp
 ```
 
+Open http://localhost:4321 in the browser. Connect an agent via MCP. Both are in the same room.
+
 ## How It Works
 
-1. Define an experience using [@vibevibes/sdk](https://github.com/vibevibes/sdk)
+1. You define an experience with [@vibevibes/sdk](https://github.com/vibevibes/sdk) (tools + canvas)
 2. This server loads and runs it
 3. Agents connect via MCP tools (`connect`, `act`, `look`)
-4. Humans open the browser to see the canvas
+4. Humans open the browser viewer to see the canvas
 5. Everyone shares the same state — tools are the only mutation path
 
+```
+Browser (Canvas)  <--WebSocket-->  vibevibes-serve  <--MCP-->  AI Agent
+```
+
 ## MCP Tools
 
 | Tool | Purpose |
 |------|---------|
-| `connect` | Join the server, get room info |
-| `act` | Execute a tool in the experience |
-| `look` | Observe current state |
-| `disconnect` | Leave room |
+| `connect` | Join the room. Returns available tools, current state, browser URL |
+| `act` | Execute a tool — same tools the human uses via the canvas |
+| `look` | Observe current state and recent events |
+| `disconnect` | Leave the room |
+
+## Features
+
+- **Hot reload** — edit `src/index.tsx`, save, see changes instantly
+- **TypeScript bundling** — esbuild compiles experiences on the fly
+- **Tick engine** — optional fixed-rate game loop (`netcode: "tick"`)
+- **Protocol mode** — load experiences from `manifest.json` + subprocess
+- **Ephemeral state** — per-actor transient data (cursors, typing indicators)
+- **Agent memory** — persistent per-session key-value store
 
 ## Ecosystem
 
 | Package | Description |
 |---------|-------------|
 | [@vibevibes/sdk](https://github.com/vibevibes/sdk) | Define experiences — tools, canvas, state |
-| **@vibevibes/mcp** (this) | Runtime server — MCP + WebSocket + browser viewer |
-| [create-vibevibes](https://github.com/vibevibes/create) | `npx create-vibevibes my-exp` — scaffold in seconds |
+| **@vibevibes/mcp** | Runtime engine — MCP server + WebSocket + viewer |
+| [@vibevibes/create](https://github.com/vibevibes/create) | `npx @vibevibes/create` — scaffold in seconds |
 | [experiences](https://github.com/vibevibes/experiences) | Example experiences — fork and remix |
 
 ## License

package/hooks/logic.js

@@ -37,13 +37,7 @@ function smartTruncate(input, maxLen = 150) {
  * Format an agent context into a readable prompt string.
  * This is what Claude sees as the "reason" when the Stop hook blocks exit.
  *
- * Layout priority (most actionable first):
- *   1. Errors (browser, tool, observe)
- *   2. Observation (curated state — the "what matters")
- *   3. Chat messages (human communication)
- *   4. Other events (raw details)
- *   5. Room/tick/participant context
- *   6. Instructions
+ * Layout: errors > observation > events > participants
  */
 export function formatPrompt(ctx) {
     const parts = [];
@@ -102,60 +96,12 @@ export function formatPrompt(ctx) {
         const visibleEvents = ctx.events.filter((e) => !(e.tool || "").startsWith("_behavior.") &&
             e.actorId !== "_tick-engine" &&
             e.owner !== "_system");
-        // Separate chat messages from other events for prominent display
-        const chatEvents = visibleEvents.filter((e) => e.tool === "_chat.send");
-        const otherEvents = visibleEvents.filter((e) => e.tool !== "_chat.send" && e.tool !== "_chat.team");
-        if (chatEvents.length > 0) {
-            parts.push(`CHAT MESSAGE${chatEvents.length > 1 ? "S" : ""}:`);
-            for (const e of chatEvents) {
-                const actor = e.role || e.owner || (e.actorId ? e.actorId.split("-")[0] : "unknown");
-                const roomTag = e.roomId ? `[${e.roomId}] ` : "";
-                const time = fmtTime(e.ts);
-                const input = e.input;
-                // Sanitize chat messages to prevent prompt injection via newlines, ANSI escapes, control chars
-                const safeMsg = (input?.message || "").replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 500);
-                parts.push(`  ${time} ${roomTag}${actor}: "${safeMsg}"`);
-            }
-            parts.push("");
-        }
-        // Team chat messages (from _chat.team tool calls)
-        const teamChatEvents = visibleEvents.filter((e) => e.tool === "_chat.team");
-        if (teamChatEvents.length > 0) {
-            // Group by team
-            const byTeam = new Map();
-            for (const e of teamChatEvents) {
-                const input = e.input;
-                const team = (input?.team || "unknown").replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 50);
-                if (!byTeam.has(team))
-                    byTeam.set(team, []);
-                byTeam.get(team).push(e);
-            }
-            for (const [team, events] of byTeam) {
-                parts.push(`TEAM CHAT (${team}):`);
-                for (const e of events) {
-                    const actor = e.role || e.owner || (e.actorId ? e.actorId.split("-")[0] : "unknown");
-                    const time = fmtTime(e.ts);
-                    const input = e.input;
-                    const safeMsg = (input?.message || "").replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 500);
-                    parts.push(`  ${time} ${actor}: "${safeMsg}"`);
-                }
-                parts.push("");
-            }
-        }
-        if (otherEvents.length > 0) {
-            // Detect multi-room activity
-            const roomIds = new Set(otherEvents.map((e) => e.roomId).filter(Boolean));
-            const multiRoom = roomIds.size > 1;
-            const header = multiRoom
-                ? `${otherEvents.length} event(s) across ${roomIds.size} rooms:`
-                : `${otherEvents.length} event(s) since your last action:`;
-            parts.push(header);
-            for (const e of otherEvents) {
-                const actor = e.role || e.owner || (e.actorId ? e.actorId.split("-")[0] : "unknown");
+        if (visibleEvents.length > 0) {
+            for (const e of visibleEvents) {
+                const actor = e.role || e.owner || (e.actorId ? e.actorId.split("-")[0] : "?");
                 const inputStr = smartTruncate(e.input);
-                const roomTag = e.roomId ? `[${e.roomId}] ` : "";
                 const time = fmtTime(e.ts);
-                parts.push(`  ${time} ${roomTag}[${actor}] ${e.tool}(${inputStr})`);
+                parts.push(`${time} [${actor}] ${e.tool}(${inputStr})`);
             }
         }
     }
@@ -185,25 +131,6 @@ export function formatPrompt(ctx) {
         parts.push("");
         parts.push(`Participants: ${unique.join(", ")}`);
     }
-    // ── 5. Critical event detection ───────────────────────
-    if (ctx.events && ctx.events.length > 0) {
-        const criticalPatterns = /kill|destroy|tower|ace|gold|death|victory|defeat|eliminated|reset/i;
-        const criticalEvents = ctx.events.filter((e) => {
-            const toolStr = e.tool || "";
-            const outputStr = typeof e.output === "string" ? e.output : "";
-            return criticalPatterns.test(toolStr) || criticalPatterns.test(outputStr);
-        });
-        if (criticalEvents.length > 0) {
-            parts.push("");
-            const eventTypes = [...new Set(criticalEvents.map(e => e.tool || "event"))].slice(0, 5).join(", ");
-            parts.push(`CRITICAL EVENT DETECTED: ${eventTypes}. Consider adjusting your behavior preset via _behavior.activate to adapt to the new situation.`);
-        }
-    }
-    // ── 6. Instructions ───────────────────────────────────
-    parts.push("");
-    parts.push("New activity in the experience. Use the act MCP tool with roomId to respond in the right room. If nothing requires a response, you may observe without acting.");
-    parts.push("COMMUNICATE: Use _chat.send to share strategy with all players. Use _chat.team for team-only coordination. Good agents communicate intentions before acting.");
-    parts.push("IMPORTANT: You are a game participant. ONLY use MCP tools (act, look, stream, memory). NEVER use Bash, rm, or any terminal/file commands.");
     return parts.join("\n");
 }
 /**
@@ -234,25 +161,8 @@ export function makeDecision(ctx, iteration, agentState) {
     if (!hasEvents && !hasError && !hasBrowserErrors && !hasObserveError)
         return null;
     const reason = formatPrompt(ctx);
-    const iter = iteration || 0;
-    // Build richer systemMessage with experience + role context
-    const mode = agentState?.agentMode || "hybrid";
-    const parts = [`vibevibes iteration ${iter}`];
-    if (agentState?.roomId)
-        parts.push(`Room: ${agentState.roomId}`);
-    if (agentState?.role)
-        parts.push(`Role: ${agentState.role}`);
-    parts.push(`Mode: ${mode}`);
-    if (mode === "manual") {
-        parts.push(`You are a manual agent. Use act() for all decisions. No behaviors. Communicate strategy via chat.`);
-    }
-    else {
-        parts.push(`You are a live participant. Fast brain: _behavior.set for reactive per-tick actions. Slow brain: act() for strategic decisions. Communicate strategy via chat. Adapt behaviors on critical events.`);
-    }
-    parts.push(`ONLY use MCP tools. NEVER use Bash, rm, or any terminal/file commands.`);
     return {
         decision: "block",
         reason,
-        systemMessage: parts.join(" | "),
     };
 }

package/package.json

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