create-miniverse 0.1.0

package/dist/index.js

@@ -0,0 +1,508 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { mkdirSync, writeFileSync, copyFileSync, existsSync, readdirSync, statSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var TEMPLATES = path.resolve(__dirname, "..", "templates");
+var y = pc.yellow;
+var c = pc.cyan;
+var m = pc.magenta;
+var g = pc.green;
+var r = pc.red;
+var b = pc.blue;
+var w = pc.white;
+var d = pc.dim;
+var banner = `
+${r("  \u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557 \u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2557 ")}${b("\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${r("  \u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551 \u2588\u2588\u2551 ")}${b("\u2588\u2588\u2551   \u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557 \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D")}
+${r("  \u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551 \u2588\u2588\u2551 ")}${b("\u255A\u2588\u2588\u2557 \u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557  ")}
+${r("  \u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551 \u2588\u2588\u2551 ")}${b(" \u255A\u2588\u2588\u2588\u2588\u2554\u255D  \u2588\u2588\u2554\u2550\u2550\u255D   \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557 \u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551 \u2588\u2588\u2554\u2550\u2550\u255D  ")}
+${r("  \u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551 \u2588\u2588\u2551 \u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2551 ")}${b("  \u255A\u2588\u2588\u2554\u255D   \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2551  \u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557")}
+${r("  \u255A\u2550\u255D     \u255A\u2550\u255D \u255A\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D \u255A\u2550\u255D ")}${b("   \u255A\u2550\u255D    \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D")}
+${d("  a tiny pixel world for your AI agents")}
+`;
+var WORLDS = [
+  { value: "cozy-startup", label: "Cozy Startup", hint: "warm office with exposed brick" },
+  { value: "posh-highrise", label: "Posh Highrise", hint: "clean modern office with marble floors" },
+  { value: "jungle-treehouse", label: "Jungle Treehouse", hint: "tropical office in the canopy" },
+  { value: "ocean-lab", label: "Ocean Lab", hint: "underwater research station" },
+  { value: "gear-supply", label: "Gear Supply", hint: "industrial tech workspace" }
+];
+var SPRITES = ["morty", "dexter", "nova", "rio"];
+async function main() {
+  console.log(banner);
+  p.intro(pc.bgGreen(pc.black(" create-miniverse ")));
+  const dirArg = process.argv[2];
+  const projectName = dirArg ?? await p.text({
+    message: "Project name",
+    placeholder: "my-miniverse",
+    defaultValue: "my-miniverse",
+    validate: (v) => {
+      if (!v) return "Project name is required";
+      if (existsSync(v)) return `Directory "${v}" already exists`;
+    }
+  });
+  if (p.isCancel(projectName)) {
+    p.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const agentInput = await p.text({
+    message: "What are your agents called? (comma-separated)",
+    placeholder: "Claude, Sage, Nova, Flux",
+    defaultValue: "Claude, Sage, Nova, Flux"
+  });
+  if (p.isCancel(agentInput)) {
+    p.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const agents = agentInput.split(",").map((s2) => s2.trim()).filter(Boolean);
+  const worldId = await p.select({
+    message: "Pick a world",
+    options: WORLDS.map((w2) => ({
+      value: w2.value,
+      label: w2.label,
+      hint: w2.hint
+    }))
+  });
+  if (p.isCancel(worldId)) {
+    p.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const signalMode = await p.select({
+    message: "How will your agents send updates?",
+    options: [
+      { value: "server", label: "Heartbeat server", hint: "POST /api/heartbeat \u2014 best for AI agents (recommended)" },
+      { value: "mock", label: "Mock data", hint: "random state changes \u2014 good for testing" }
+    ]
+  });
+  if (p.isCancel(signalMode)) {
+    p.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const projectDir = path.resolve(process.cwd(), projectName);
+  const s = p.spinner();
+  s.start("Creating project...");
+  mkdirSync(projectDir, { recursive: true });
+  mkdirSync(path.join(projectDir, "src"), { recursive: true });
+  mkdirSync(path.join(projectDir, "public", "sprites"), { recursive: true });
+  mkdirSync(path.join(projectDir, "public", "worlds"), { recursive: true });
+  const monorepoRoot = path.resolve(__dirname, "..", "..", "..");
+  const coreDir = path.join(monorepoRoot, "packages", "core");
+  const serverDir = path.join(monorepoRoot, "packages", "server");
+  const useLocal = existsSync(path.join(coreDir, "package.json"));
+  const coreDep = useLocal ? `file:${coreDir}` : "^0.1.0";
+  const serverDep = useLocal ? `file:${serverDir}` : "^0.1.0";
+  const pkg = {
+    name: projectName,
+    private: true,
+    type: "module",
+    scripts: {
+      dev: "vite",
+      build: "vite build",
+      preview: "vite preview",
+      ...signalMode === "server" ? { server: "miniverse" } : {}
+    },
+    dependencies: {
+      "@miniverse/core": coreDep,
+      ...signalMode === "server" ? { "@miniverse/server": serverDep } : {}
+    },
+    devDependencies: {
+      typescript: "^5.4.0",
+      vite: "^5.4.0"
+    }
+  };
+  writeFileSync(path.join(projectDir, "package.json"), JSON.stringify(pkg, null, 2) + "\n");
+  writeFileSync(path.join(projectDir, "tsconfig.json"), JSON.stringify({
+    compilerOptions: {
+      target: "ES2022",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      strict: true,
+      esModuleInterop: true,
+      skipLibCheck: true,
+      jsx: "preserve"
+    },
+    include: ["src"]
+  }, null, 2) + "\n");
+  writeFileSync(path.join(projectDir, "vite.config.ts"), generateViteConfig(worldId));
+  writeFileSync(path.join(projectDir, "index.html"), generateIndexHtml(projectName, agents));
+  writeFileSync(path.join(projectDir, "src", "main.ts"), generateMainTs(agents, worldId, signalMode));
+  writeFileSync(
+    path.join(projectDir, "public", "worlds", "index.json"),
+    JSON.stringify([WORLDS.find((w2) => w2.value === worldId)].map((w2) => ({ id: w2.value, name: w2.label })), null, 2) + "\n"
+  );
+  s.stop("Project created");
+  s.start(`Downloading ${WORLDS.find((w2) => w2.value === worldId).label} world...`);
+  const demoWorldsDir = path.resolve(__dirname, "..", "..", "..", "demo", "public", "worlds", worldId);
+  const targetWorldDir = path.join(projectDir, "public", "worlds", worldId);
+  if (existsSync(demoWorldsDir)) {
+    copyDirSync(demoWorldsDir, targetWorldDir);
+  } else {
+    const templateWorldDir = path.join(TEMPLATES, "worlds", worldId);
+    if (existsSync(templateWorldDir)) {
+      copyDirSync(templateWorldDir, targetWorldDir);
+    } else {
+      mkdirSync(targetWorldDir, { recursive: true });
+      writeFileSync(path.join(targetWorldDir, "scene.json"), "{}");
+      p.log.warn("World assets not found \u2014 you may need to copy them manually or generate a new world.");
+    }
+  }
+  const demoSpritesDir = path.resolve(__dirname, "..", "..", "..", "demo", "public", "sprites");
+  const targetSpritesDir = path.join(projectDir, "public", "sprites");
+  for (const spriteName of SPRITES) {
+    for (const suffix of ["_walk.png", "_actions.png"]) {
+      const src = path.join(demoSpritesDir, spriteName + suffix);
+      if (existsSync(src)) {
+        copyFileSync(src, path.join(targetSpritesDir, spriteName + suffix));
+      }
+    }
+  }
+  s.stop("Assets copied");
+  const nextSteps = [
+    `cd ${projectName}`,
+    "npm install",
+    "npm run dev",
+    ...signalMode === "server" ? ["npm run server  # in another terminal"] : []
+  ];
+  p.note(nextSteps.join("\n"), "Next steps");
+  p.outro(pc.green("Your miniverse is ready! Press E to open the editor."));
+}
+function generateViteConfig(worldId) {
+  return `import { defineConfig } from 'vite';
+import fs from 'fs';
+import path from 'path';
+
+function sceneSavePlugin() {
+  return {
+    name: 'scene-save',
+    configureServer(server: any) {
+      server.middlewares.use('/api/save-scene', (req: any, res: any) => {
+        if (req.method !== 'POST') {
+          res.statusCode = 405;
+          res.end('Method not allowed');
+          return;
+        }
+        let body = '';
+        req.on('data', (chunk: string) => { body += chunk; });
+        req.on('end', () => {
+          try {
+            const data = JSON.parse(body);
+            const worldId = data.worldId ?? '${worldId}';
+            delete data.worldId;
+
+            const safeId = worldId.replace(/[^a-zA-Z0-9_-]/g, '');
+            const worldDir = path.resolve(__dirname, 'public/worlds', safeId);
+            if (!fs.existsSync(worldDir)) {
+              fs.mkdirSync(worldDir, { recursive: true });
+            }
+
+            const filePath = path.join(worldDir, 'scene.json');
+            let existing: Record<string, unknown> = {};
+            if (fs.existsSync(filePath)) {
+              try { existing = JSON.parse(fs.readFileSync(filePath, 'utf-8')); } catch {}
+            }
+            const merged = { ...existing, ...data };
+
+            fs.writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\\n');
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({ ok: true }));
+            console.log('[scene-save] Written to', filePath);
+          } catch (e: any) {
+            res.statusCode = 400;
+            res.end(JSON.stringify({ error: e.message }));
+          }
+        });
+      });
+    },
+  };
+}
+
+export default defineConfig({
+  plugins: [sceneSavePlugin()],
+});
+`;
+}
+function generateIndexHtml(projectName, agents) {
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>${projectName}</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      background: #1a1a2e;
+      color: #eee;
+      font-family: 'Courier New', monospace;
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      justify-content: center;
+      min-height: 100vh;
+      gap: 16px;
+    }
+    h1 { font-size: 20px; color: #e94560; letter-spacing: 4px; text-transform: uppercase; }
+    .subtitle { font-size: 12px; color: #666; margin-bottom: 8px; }
+    #miniverse-container {
+      border: 2px solid #333;
+      border-radius: 4px;
+      overflow: hidden;
+      background: #0f0f23;
+      display: inline-block;
+      line-height: 0;
+      transition: border-color 0.15s, border-radius 0.15s;
+    }
+    #editor-wrapper #miniverse-container {
+      border-color: #00ff88;
+      border-radius: 4px 0 0 4px;
+    }
+    #tooltip {
+      position: fixed;
+      background: rgba(0,0,0,0.85);
+      border: 1px solid #e94560;
+      padding: 8px 12px;
+      border-radius: 4px;
+      font-size: 11px;
+      pointer-events: none;
+      display: none;
+      z-index: 100;
+      max-width: 200px;
+    }
+    #tooltip .name { color: #e94560; font-weight: bold; }
+    #tooltip .state { color: #aaa; }
+    #tooltip .task { color: #66aaff; }
+    .status-bar {
+      display: flex; gap: 16px; font-size: 11px; color: #555;
+    }
+    .status-bar .agent { display: flex; align-items: center; gap: 4px; }
+    .status-dot { width: 6px; height: 6px; border-radius: 50%; background: #555; }
+    .status-dot.working { background: #4ade80; }
+    .status-dot.idle { background: #fbbf24; }
+    .status-dot.sleeping { background: #818cf8; }
+    .status-dot.thinking { background: #f472b6; }
+    .status-dot.error { background: #ef4444; }
+    .status-dot.speaking { background: #22d3ee; }
+    .hint { font-size: 10px; color: #444; }
+  </style>
+</head>
+<body>
+  <h1>${projectName}</h1>
+  <p class="subtitle">powered by miniverse</p>
+  <div id="miniverse-container"></div>
+  <div class="status-bar" id="status-bar"></div>
+  <p class="hint">Press <b>E</b> to toggle editor</p>
+  <div id="tooltip">
+    <div class="name"></div>
+    <div class="state"></div>
+    <div class="task"></div>
+  </div>
+  <script type="module" src="/src/main.ts"></script>
+</body>
+</html>
+`;
+}
+function generateMainTs(agents, worldId, signalMode) {
+  const agentIds = agents.map((a) => a.toLowerCase().replace(/[^a-z0-9]/g, ""));
+  const spriteAssignments = agentIds.map((id, i) => {
+    const sprite = SPRITES[i % SPRITES.length];
+    return `    '${id}': charSprites('${sprite}'),`;
+  }).join("\n");
+  const residentConfigs = agentIds.map((id, i) => {
+    const name = agents[i];
+    const sprite = SPRITES[i % SPRITES.length];
+    return `      { agentId: '${id}', name: '${name}', sprite: '${id}', position: sceneData?.characters?.${id} ?? 'desk_0_0' },`;
+  }).join("\n");
+  const signalConfig = signalMode === "server" ? `    signal: {
+      type: 'websocket',
+      url: 'ws://localhost:4321/ws',
+    },` : `    signal: {
+      type: 'mock',
+      mockData: () => [${agentIds.map((id, i) => `
+        { id: '${id}', name: '${agents[i]}', state: (['working', 'idle', 'thinking'] as const)[Math.floor(Math.random() * 3)], task: null, energy: Math.random() },`).join("")}
+      ],
+      interval: 3000,
+    },`;
+  return `import { Miniverse, FurnitureSystem, Editor } from '@miniverse/core';
+import type { SceneConfig, SpriteSheetConfig } from '@miniverse/core';
+
+const WORLD_ID = '${worldId}';
+const basePath = \`/worlds/\${WORLD_ID}\`;
+
+function charSprites(name: string): SpriteSheetConfig {
+  return {
+    sheets: {
+      walk: \`/sprites/\${name}_walk.png\`,
+      actions: \`/sprites/\${name}_actions.png\`,
+    },
+    animations: {
+      idle_down: { sheet: 'walk', row: 0, frames: 2, speed: 0.5 },
+      idle_up: { sheet: 'walk', row: 1, frames: 2, speed: 0.5 },
+      walk_down: { sheet: 'walk', row: 0, frames: 4, speed: 0.15 },
+      walk_up: { sheet: 'walk', row: 1, frames: 4, speed: 0.15 },
+      walk_left: { sheet: 'walk', row: 2, frames: 4, speed: 0.15 },
+      walk_right: { sheet: 'walk', row: 3, frames: 4, speed: 0.15 },
+      working: { sheet: 'actions', row: 0, frames: 4, speed: 0.3 },
+      sleeping: { sheet: 'actions', row: 1, frames: 2, speed: 0.8 },
+      talking: { sheet: 'actions', row: 2, frames: 4, speed: 0.15 },
+    },
+    frameWidth: 64,
+    frameHeight: 64,
+  };
+}
+
+function buildSceneConfig(cols = 16, rows = 12, savedFloor?: number[][]): SceneConfig {
+  const floor: number[][] = [];
+  const walkable: boolean[][] = [];
+
+  for (let r = 0; r < rows; r++) {
+    floor[r] = [];
+    walkable[r] = [];
+    for (let c = 0; c < cols; c++) {
+      if (savedFloor && savedFloor[r] && savedFloor[r][c] !== undefined) {
+        floor[r][c] = savedFloor[r][c];
+      } else if (r <= 1) {
+        floor[r][c] = 1;
+      } else {
+        floor[r][c] = 0;
+      }
+      walkable[r][c] = floor[r][c] >= 0 && floor[r][c] !== 1;
+    }
+  }
+
+  return {
+    name: 'main',
+    tileWidth: 32,
+    tileHeight: 32,
+    layers: [floor],
+    walkable,
+    locations: {},
+    tilesets: [{
+      image: \`\${basePath}/tilesets/tileset.png\`,
+      tileWidth: 32,
+      tileHeight: 32,
+      columns: 16,
+    }],
+  };
+}
+
+async function main() {
+  const container = document.getElementById('miniverse-container')!;
+  const tooltip = document.getElementById('tooltip')!;
+  const statusBar = document.getElementById('status-bar')!;
+
+  const sceneData = await fetch(\`\${basePath}/scene.json\`).then(r => r.json()).catch(() => null);
+
+  const gridCols = sceneData?.gridCols ?? 16;
+  const gridRows = sceneData?.gridRows ?? 12;
+  const sceneConfig = buildSceneConfig(gridCols, gridRows, sceneData?.floor);
+  const tileSize = 32;
+
+  const spriteSheets: Record<string, SpriteSheetConfig> = {
+${spriteAssignments}
+  };
+
+  const mv = new Miniverse({
+    container,
+    world: WORLD_ID,
+    scene: 'main',
+${signalConfig}
+    residents: [
+${residentConfigs}
+    ],
+    scale: 2,
+    width: gridCols * tileSize,
+    height: gridRows * tileSize,
+    sceneConfig,
+    spriteSheets,
+    objects: [],
+  });
+
+  // --- Furniture system ---
+  const furniture = new FurnitureSystem(tileSize, 2);
+
+  const rawSpriteMap: Record<string, string> = sceneData?.spriteMap ?? {};
+  await Promise.all(
+    Object.entries(rawSpriteMap).map(([id, src]) => furniture.loadSprite(id, \`\${basePath}\${src}\`)),
+  );
+
+  furniture.setLayout(sceneData?.furniture ?? []);
+  if (sceneData?.wanderPoints) {
+    furniture.setWanderPoints(sceneData.wanderPoints);
+  }
+
+  furniture.setDeadspaceCheck((col, row) => {
+    const floor = mv.getFloorLayer();
+    return floor?.[row]?.[col] < 0;
+  });
+
+  const syncFurniture = () => {
+    mv.setTypedLocations(furniture.getLocations());
+    mv.updateWalkability(furniture.getBlockedTiles());
+  };
+  syncFurniture();
+  furniture.onSave(syncFurniture);
+
+  await mv.start();
+
+  mv.addLayer({ order: 5, render: (ctx) => furniture.renderBelow(ctx) });
+  mv.addLayer({ order: 15, render: (ctx) => furniture.renderAbove(ctx) });
+
+  // --- Editor ---
+  const editor = new Editor({
+    canvas: mv.getCanvas(),
+    furniture,
+    miniverse: mv,
+    worldId: WORLD_ID,
+    onSave: async (scene) => {
+      const res = await fetch('/api/save-scene', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ ...scene, worldId: WORLD_ID }),
+      });
+      if (!res.ok) throw new Error(await res.text());
+    },
+  });
+  if (sceneData?.tileNames) editor.setTileNames(sceneData.tileNames);
+  editor.loadCharacterAssignments(sceneData?.characters);
+  mv.addLayer({ order: 50, render: (ctx) => {
+    editor.renderOverlay(ctx);
+    if (editor.isActive()) syncFurniture();
+  } });
+
+  // --- Tooltip ---
+  mv.on('resident:click', (data: unknown) => {
+    const d = data as { name: string; state: string; task: string | null };
+    tooltip.style.display = 'block';
+    tooltip.querySelector('.name')!.textContent = d.name;
+    tooltip.querySelector('.state')!.textContent = \`State: \${d.state}\`;
+    tooltip.querySelector('.task')!.textContent = d.task ? \`Task: \${d.task}\` : 'No active task';
+    setTimeout(() => { tooltip.style.display = 'none'; }, 3000);
+  });
+
+  container.addEventListener('mousemove', (e) => {
+    tooltip.style.left = e.clientX + 12 + 'px';
+    tooltip.style.top = e.clientY + 12 + 'px';
+  });
+}
+
+main().catch(console.error);
+`;
+}
+function copyDirSync(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    const srcPath = path.join(src, entry);
+    const destPath = path.join(dest, entry);
+    if (statSync(srcPath).isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "create-miniverse",
+  "version": "0.1.0",
+  "description": "Create a new Miniverse project — a tiny pixel world for your AI agents.",
+  "type": "module",
+  "bin": {
+    "create-miniverse": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --outfile=dist/index.js --banner:js='#!/usr/bin/env node' --external:@clack/prompts --external:picocolors",
+    "dev": "npm run build -- --watch"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.8.2",
+    "picocolors": "^1.1.0"
+  },
+  "keywords": [
+    "miniverse",
+    "ai",
+    "agents",
+    "pixel-art",
+    "create",
+    "cli"
+  ],
+  "license": "MIT"
+}