create-siltrun 0.1.0

package/templates/turn-based-grid/src/view.ts

@@ -0,0 +1,94 @@
+// view.ts — the AGENT's perception parser. Input is the rendered ASCII string (and
+// nothing else); output is structured data a brain can reason over. This is the
+// concrete demonstration that the ASCII projection is a SUFFICIENT sensorium: a brain
+// turns text into a decision here, never touching the server State object.
+
+import type { Dir, Pos } from "./substrate/types.ts";
+
+export type View = {
+  w: number;
+  h: number;
+  grid: string[];           // just the map rows
+  selfGlyph: string | null;
+  self: Pos | null;
+  pellets: Pos[];
+  others: { glyph: string; pos: Pos }[];
+  isWall: (x: number, y: number) => boolean;
+};
+
+/** Parse the perception string produced by renderAscii(state, selfId). */
+export function readView(ascii: string): View {
+  const lines = ascii.split("\n");
+  // the grid is the leading block of equal-width rows made only of map glyphs.
+  const grid: string[] = [];
+  for (const line of lines) {
+    if (/^[#.\*A-Za-z]+$/.test(line) && (grid.length === 0 || line.length === grid[0].length)) {
+      grid.push(line);
+    } else if (grid.length > 0) {
+      break; // grid ended
+    }
+  }
+  const h = grid.length;
+  const w = h ? grid[0].length : 0;
+
+  const selfLine = lines.find((l) => l.startsWith("you are: "));
+  const selfGlyph = selfLine ? (selfLine.match(/you are:\s*([A-Za-z])\b/)?.[1] ?? null) : null;
+
+  const pellets: Pos[] = [];
+  const others: { glyph: string; pos: Pos }[] = [];
+  let self: Pos | null = null;
+  for (let y = 0; y < h; y++) {
+    for (let x = 0; x < w; x++) {
+      const c = grid[y][x];
+      if (c === "*") pellets.push({ x, y });
+      else if (/[A-Za-z]/.test(c)) {
+        if (c === selfGlyph) self = { x, y };
+        else others.push({ glyph: c, pos: { x, y } });
+      }
+    }
+  }
+
+  const isWall = (x: number, y: number) => {
+    if (y < 0 || y >= h || x < 0 || x >= w) return true;
+    return grid[y][x] === "#";
+  };
+
+  return { w, h, grid, selfGlyph, self, pellets, others, isWall };
+}
+
+const DIRS: { dir: Exclude<Dir, "stay">; dx: number; dy: number }[] = [
+  { dir: "up", dx: 0, dy: -1 },
+  { dir: "down", dx: 0, dy: 1 },
+  { dir: "left", dx: -1, dy: 0 },
+  { dir: "right", dx: 1, dy: 0 },
+];
+
+/**
+ * BFS from `self` over floor cells to the nearest pellet; return the first step's
+ * direction. Treats other players' cells as blocked. Null if none reachable. This is
+ * the "greedy pathfinder" a real agent would run over its parsed perception.
+ */
+export function stepTowardNearestPellet(view: View): Dir | null {
+  if (!view.self || view.pellets.length === 0) return null;
+  const pelletSet = new Set(view.pellets.map((p) => `${p.x},${p.y}`));
+  const blocked = new Set(view.others.map((o) => `${o.pos.x},${o.pos.y}`));
+  const start = view.self;
+
+  // BFS, recording the first-step direction taken from start on each shortest path.
+  const seen = new Set<string>([`${start.x},${start.y}`]);
+  type Node = { x: number; y: number; first: Dir | null };
+  const queue: Node[] = [{ x: start.x, y: start.y, first: null }];
+  while (queue.length) {
+    const node = queue.shift()!;
+    if (pelletSet.has(`${node.x},${node.y}`) && node.first) return node.first;
+    for (const { dir, dx, dy } of DIRS) {
+      const nx = node.x + dx;
+      const ny = node.y + dy;
+      const key = `${nx},${ny}`;
+      if (seen.has(key) || view.isWall(nx, ny) || blocked.has(key)) continue;
+      seen.add(key);
+      queue.push({ x: nx, y: ny, first: node.first ?? dir });
+    }
+  }
+  return null;
+}

package/templates/turn-based-grid/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src", "room.ts", "vite.config.ts"]
+}

package/templates/turn-based-grid/vite.config.ts

@@ -0,0 +1,7 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  server: { port: 5173 },
+});