@vibevibes/runtime 0.2.0

package/dist/protocol.js

@@ -0,0 +1,241 @@
+/**
+ * Protocol experience support.
+ *
+ * Loads experiences defined as manifest.json + subprocess tool handler.
+ * The subprocess communicates via newline-delimited JSON over stdin/stdout.
+ */
+import { spawn } from "child_process";
+import * as path from "path";
+import * as fs from "fs";
+// ── Subprocess executor ─────────────────────────────────────────────────
+export class SubprocessExecutor {
+    proc = null;
+    pending = new Map();
+    buffer = "";
+    seq = 0;
+    command;
+    args;
+    cwd;
+    restarting = false;
+    constructor(command, args, cwd) {
+        this.command = command;
+        this.args = args;
+        this.cwd = cwd;
+    }
+    start() {
+        if (this.proc)
+            return;
+        this.proc = spawn(this.command, this.args, {
+            cwd: this.cwd,
+            stdio: ["pipe", "pipe", "pipe"],
+            env: { ...process.env },
+        });
+        this.proc.stdout.on("data", (chunk) => {
+            this.buffer += chunk.toString();
+            this.processBuffer();
+        });
+        this.proc.stderr.on("data", (chunk) => {
+            const msg = chunk.toString().trim();
+            if (msg)
+                console.error(`[protocol:${this.command}] ${msg}`);
+        });
+        this.proc.on("exit", (code) => {
+            console.warn(`[protocol] Tool process exited with code ${code}`);
+            this.proc = null;
+            // Reject all pending requests
+            for (const [id, p] of this.pending) {
+                p.reject(new Error(`Tool process exited (code ${code})`));
+                clearTimeout(p.timer);
+            }
+            this.pending.clear();
+            this.buffer = "";
+            // Auto-restart after a short delay
+            if (!this.restarting) {
+                this.restarting = true;
+                setTimeout(() => {
+                    this.restarting = false;
+                    try {
+                        this.start();
+                    }
+                    catch { }
+                }, 1000);
+            }
+        });
+        this.proc.on("error", (err) => {
+            console.error(`[protocol] Failed to spawn tool process: ${err.message}`);
+        });
+    }
+    stop() {
+        this.restarting = true; // Prevent auto-restart
+        if (this.proc) {
+            this.proc.kill();
+            this.proc = null;
+        }
+        for (const [, p] of this.pending) {
+            p.reject(new Error("Executor stopped"));
+            clearTimeout(p.timer);
+        }
+        this.pending.clear();
+    }
+    processBuffer() {
+        const lines = this.buffer.split("\n");
+        this.buffer = lines.pop() || "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const response = JSON.parse(trimmed);
+                const pending = this.pending.get(response.id);
+                if (pending) {
+                    clearTimeout(pending.timer);
+                    this.pending.delete(response.id);
+                    pending.resolve(response);
+                }
+            }
+            catch {
+                console.warn(`[protocol] Invalid JSON from tool process: ${trimmed.slice(0, 200)}`);
+            }
+        }
+    }
+    async send(method, params, timeoutMs = 10000) {
+        if (!this.proc?.stdin?.writable) {
+            throw new Error("Tool process not running");
+        }
+        const id = `req-${++this.seq}`;
+        const request = { id, method, params };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`Tool process timeout after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                this.proc.stdin.write(JSON.stringify(request) + "\n");
+            }
+            catch (err) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    get running() {
+        return this.proc !== null && !this.proc.killed;
+    }
+}
+// ── Load a protocol experience ──────────────────────────────────────────
+export function isProtocolExperience(entryPath) {
+    return entryPath.endsWith("manifest.json");
+}
+export function loadProtocolManifest(manifestPath) {
+    const raw = fs.readFileSync(manifestPath, "utf-8");
+    const manifest = JSON.parse(raw);
+    if (!manifest.id)
+        throw new Error("manifest.json: id is required");
+    if (!manifest.version)
+        throw new Error("manifest.json: version is required");
+    if (!manifest.title)
+        throw new Error("manifest.json: title is required");
+    if (!manifest.toolProcess)
+        throw new Error("manifest.json: toolProcess is required");
+    if (!Array.isArray(manifest.tools))
+        throw new Error("manifest.json: tools must be an array");
+    return manifest;
+}
+/**
+ * Create a synthetic ExperienceModule from a protocol manifest.
+ * Tool handlers proxy calls to the subprocess executor.
+ */
+export function createProtocolModule(manifest, executor, manifestDir) {
+    // Create tool defs with handlers that proxy to the subprocess
+    const tools = manifest.tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        // Use a plain object as input_schema with a parse method for compatibility
+        input_schema: createJsonSchemaValidator(t.input_schema),
+        risk: (t.risk || "low"),
+        capabilities_required: ["state.write"],
+        handler: async (ctx, input) => {
+            const response = await executor.send("tool", {
+                tool: t.name,
+                input,
+                state: ctx.state,
+                actorId: ctx.actorId,
+                roomId: ctx.roomId,
+                timestamp: ctx.timestamp,
+            });
+            if (response.error) {
+                throw new Error(response.error.message);
+            }
+            if (response.result?.state) {
+                ctx.setState(response.result.state);
+            }
+            return response.result?.output ?? {};
+        },
+    }));
+    // Build observe function if manifest specifies observation config
+    let observe;
+    if (manifest.observe) {
+        const { exclude, include } = manifest.observe;
+        observe = (state, _event, _actorId) => {
+            if (include) {
+                const filtered = {};
+                for (const key of include) {
+                    if (key in state)
+                        filtered[key] = state[key];
+                }
+                return filtered;
+            }
+            if (exclude) {
+                const filtered = { ...state };
+                for (const key of exclude) {
+                    delete filtered[key];
+                }
+                return filtered;
+            }
+            return state;
+        };
+    }
+    // Resolve canvas path
+    const canvasFile = manifest.canvas || "index.html";
+    const canvasPath = path.resolve(manifestDir, canvasFile);
+    const hasCanvas = fs.existsSync(canvasPath);
+    return {
+        manifest: {
+            id: manifest.id,
+            version: manifest.version,
+            title: manifest.title,
+            description: manifest.description || "",
+            requested_capabilities: ["state.write"],
+            agentSlots: manifest.agents,
+            participantSlots: manifest.agents?.map((a) => ({ ...a, type: "ai" })),
+            netcode: manifest.netcode,
+            tickRateMs: manifest.tickRateMs,
+        },
+        Canvas: (() => null), // Protocol experiences use HTML canvas, not React
+        tools,
+        observe,
+        initialState: manifest.initialState ?? {},
+        _executor: executor,
+        _canvasPath: hasCanvas ? canvasPath : undefined,
+    };
+}
+/**
+ * Create a minimal Zod-compatible validator from a JSON Schema.
+ * Only needs .parse() for the server's input validation.
+ */
+function createJsonSchemaValidator(schema) {
+    return {
+        parse: (input) => {
+            // Basic type validation for protocol experiences
+            if (schema.type === "object" && typeof input !== "object") {
+                throw new Error("Expected object input");
+            }
+            return input;
+        },
+        // Expose the raw JSON Schema for tool listing
+        _jsonSchema: schema,
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @vibevibes/runtime — the server engine for vibevibes experiences.
+ *
+ * Single-experience architecture with tool gate, WebSocket broadcasts, and room spawning.
+ *
+ * The server loads one experience from the project root (manifest.json for protocol
+ * experiences, or src/index.tsx for TypeScript experiences). Multiple rooms can be
+ * spawned, all running the same experience.
+ *
+ * AI agents join rooms via MCP or HTTP.
+ */
+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;
+}
+/** Set the public tunnel URL (called from dev.ts when --share is active). */
+export declare function setPublicUrl(url: string): void;
+/** Get the base URL clients should use (tunnel URL if sharing, localhost otherwise). */
+export declare function getBaseUrl(): string;
+export declare function startServer(config?: ServerConfig): Promise<import("http").Server>;
+export declare function setProjectRoot(root: string): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH,MAAM,WAAW,YAAY;IAC3B,iGAAiG;IACjG,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmgBD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wFAAwF;AACxF,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AA+gFD,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,MAAM,EAAE,MAAM,CAAC,CAwlBvF;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD"}