@homie-rocks/studio 0.40.0 → 0.43.0

package/lib/studio.mjs

@@ -108,7 +108,7 @@ function listKind(root, kind) {
 /**
  * RULES ON THE SERVER (NETPLAY.md section 29). A game written as rules plus view says so in game.json with a `"room"`
  * object (where its rules run, its tick rate…; rules/rules.ts `roomSettings` checks them at build) and has a
- * src/rules.ts. Any other game is hosted by a player's browser, as before. The file alone decides nothing: games made
+ * src/rules.ts. Other games need the browser-hosted netplay contract checked by the build. The file alone decides nothing: games made
  * before this had their own src/rules.ts, with whatever they liked in it, and they build exactly as they did.
  */
 export const isRulesGame = (g) => g?.room != null && typeof g.room === 'object' && existsSync(join(g.dir, 'src', 'rules.ts'));
@@ -129,7 +129,7 @@ export function starters() {
   const dir = join(PACKAGE_ROOT, 'starters');
   return readdirSync(dir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => {
     const meta = JSON.parse(readFileSync(join(dir, d.name, 'game.json'), 'utf8'));
-    // `example`: a starter that shows how something is written (coin-dash: rules on the server) and is not yet offered as the start of a new game.
+    // `example`: marks the smallest reference (coin-dash); all starters use server rules and can start a new game.
     return { id: d.name, name: meta.name, blurb: meta.blurb, players: meta.players, roundSeconds: meta.roundSeconds, ...(meta.example === true ? { example: true } : {}) };
   });
 }
@@ -309,7 +309,7 @@ export async function newApp(root, id, { name } = {}) {
   const meta = JSON.parse(readFileSync(file, 'utf8'));
   meta.id = id; meta.name = String(name ?? 'Welcome together').slice(0, 60);
   writeFileSync(file, `${JSON.stringify(meta, null, 2)}\n`);
-  const main = join(dest, 'src/main.ts');
+  const main = join(dest, meta.entry ?? 'src/main.ts');
   writeFileSync(main, readFileSync(main, 'utf8').replaceAll("game: 'welcome'", `game: '${id}'`));
   return { ok: true, command: 'app new', id, dir: dest, files: readdirSync(dest, { recursive: true }).map(String), ...addNeeds(root, meta.needs) };
 }

package/lib/template-history.json

@@ -2199,6 +2199,68 @@
    }
   },
   "0.40.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": [
+     "34444a6ca4b14437",
+     "fc90f3609cad18ba"
+    ]
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": [
+      "c18362ed28975d81",
+      "f3a280b8c96cd068"
+     ],
+     "## Apps: one screen, roles and parts": [
+      "4db0abe4cdfac09f",
+      "be6f8fa45f93211a"
+     ],
+     "## Commands (all through the pinned CLI in node_modules)": [
+      "a7f290579585368c",
+      "c920ac84d44c872a"
+     ],
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": [
+      "2da7fa74c8884834",
+      "9e44559de535d842"
+     ],
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": [
+      "98d08705087a33ec",
+      "d0028361fe567add"
+     ],
+     "## Selling things (the shop)": "9e020d69dd6a954e",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "2e6b29afb85dcf7e",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": [
+        "7cad8fd10f62fef1",
+        "cae1df6235f51d17"
+       ]
+      }
+     }
+    }
+   }
+  },
+  "0.41.0": {
    "files": {
     "CLAUDE.md": "ddf2b2a0376202f6",
     "README.md": "684b3cca8001673c",
@@ -2213,8 +2275,52 @@
    "sections": {
     "AGENTS.md": {
      "(intro)": "214aa46eb3a895d5",
-     "## Layout": "c18362ed28975d81",
+     "## Layout": "f3a280b8c96cd068",
      "## Apps: one screen, roles and parts": "be6f8fa45f93211a",
+     "## Commands (all through the pinned CLI in node_modules)": "159151b8861fc051",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "9e44559de535d842",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "d0028361fe567add",
+     "## Selling things (the shop)": "9e020d69dd6a954e",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "2e6b29afb85dcf7e",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "2cdd530e48170bfd"
+      }
+     }
+    }
+   }
+  },
+  "0.42.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": "34444a6ca4b14437"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "c18362ed28975d81",
+     "## Apps: one screen, roles and parts": [
+      "8596f2b25edda3e2",
+      "be6f8fa45f93211a"
+     ],
      "## Commands (all through the pinned CLI in node_modules)": "a7f290579585368c",
      "## The site": "0cb8dd9a6f8a0096",
      "## Making games": "2da7fa74c8884834",
@@ -2238,6 +2344,47 @@
      }
     }
    }
+  },
+  "0.43.0": {
+   "files": {
+    "CLAUDE.md": "ddf2b2a0376202f6",
+    "README.md": "684b3cca8001673c",
+    "HANDOFF.md": "29337e2ace95b2e7",
+    "games/README.md": "5ad32fe80c61f117",
+    "music/README.md": "a3dc042dadd39df8",
+    "videos/README.md": "16babc3437d5545b",
+    "posts/README.md": "37841aae476bd540",
+    "site/README.md": "732894273a32dc3f",
+    "site/src/worker.mjs": "34444a6ca4b14437"
+   },
+   "sections": {
+    "AGENTS.md": {
+     "(intro)": "214aa46eb3a895d5",
+     "## Layout": "f3a280b8c96cd068",
+     "## Apps: one screen, roles and parts": "8596f2b25edda3e2",
+     "## Commands (all through the pinned CLI in node_modules)": "159151b8861fc051",
+     "## The site": "0cb8dd9a6f8a0096",
+     "## Making games": "9e44559de535d842",
+     "## The Game Codex and progress": "0738ef719cef3a4c",
+     "## Art direction and models": "a48fff7bf0a5f2fc",
+     "## Running live games (the back office)": "51ebf2ab756f6e4d",
+     "## Servers and AI seats": "d0028361fe567add",
+     "## Selling things (the shop)": "9e020d69dd6a954e",
+     "## Continuing a build from the Claude app": "0d68081e924ca419",
+     "## Rules": "2e6b29afb85dcf7e",
+     "## Telling Homie": "80b46fdd9e578db8",
+     "## Beta": "9d02638207a26e73"
+    }
+   },
+   "named": {
+    "Homie Arcade": {
+     "sections": {
+      "AGENTS.md": {
+       "## Commands (all through the pinned CLI in node_modules)": "2cdd530e48170bfd"
+      }
+     }
+    }
+   }
   }
  }
 }

package/lib/tools-build.mjs

@@ -38,6 +38,7 @@ export async function buildTools(root,esbuild) {
     if(!['owner','signed-in','public'].includes(t.audience)&&!(t.audience&&typeof t.audience.app==='string'&&typeof t.audience.role==='string'))throw new Error(`tool ${t.name} needs an audience`);
     if(t.inputSchema?.type!=='object')throw new Error(`tool ${t.name} input schema must be an object`);
     validator.getValidator(t.inputSchema);
+    if(t.price && (t.kind==='prompt'||!Number.isSafeInteger(t.price.amount)||t.price.amount<=0||! /^[a-z]{3}$/.test(t.price.currency)))throw new Error(`tool ${t.name}: price needs a positive minor-unit amount and currency`);
     if(t.kind!==undefined&&!['tool','prompt'].includes(t.kind))throw new Error(`tool ${t.name}: invalid kind`);
     if(t.webhook&&(!/^[A-Z][A-Z0-9_]{0,63}$/.test(t.webhook.secret)||typeof t.webhook.person!=='string'||!t.webhook.person))throw new Error(`tool ${t.name}: webhook needs a named secret and account`);
     for(const [name,event] of Object.entries(t.events??{})){
@@ -51,5 +52,6 @@ export async function buildTools(root,esbuild) {
     let text=readFileSync(worker,'utf8');
     if(!text.includes('useTools(')){text += "\nimport { useTools } from '@homie-rocks/studio/worker';\nuseTools(async () => (await import('./tools/index.mjs')).default);\n";writeFileSync(worker,text);}
   }
+  writeFileSync(join(dir,'declarations.json'),JSON.stringify({paid:defs.some(t=>t.price)})+'\n');
   return defs.map(t=>t.name);
 }

package/lib/trailer.mjs

@@ -1,8 +1,8 @@
 /**
  * `homie-studio trailer <id>`: a trailer of a game, in one command.
  *
- * The work is not here. It is the Homie plugin's video skill (`video.mjs trailer`): the game rendered frame by frame
- * on a virtual clock, its sound rebuilt from its own files, the highlights picked from what it played, an end card,
+ * The work is not here. It is the Homie plugin's video skill (`video.mjs trailer`): live footage for server rules,
+ * or a virtual clock and rebuilt sound for older browser games, selected highlights, an end card,
  * and 16:9, 1:1 and 9:16 deliveries. This finds that script and hands the command over, so a person at a terminal
  * and an agent with the plugin run the same thing. The video goes to videos/<id>-trailer/ (or --slug <slug>).
  *
@@ -36,10 +36,14 @@ export function trailerCommand(root, id, rest, { skills = null, slug = null } =
 }
 
 export function trailerLines(r) {
+  const live = r.capture?.mode === 'live';
+  const audio = r.capture?.audio;
+  const sound = audio?.rebuilt ? `${audio.placed} sounds rebuilt from the game's own files`
+    : audio ? 'game audio captured live' : live ? 'no audio captured' : 'the game logged no sound';
   return [
     ...(r.problems ?? []).map((x) => `PROBLEM: ${x}`),
     `${r.seconds} s trailer of ${r.game}: ${Object.values(r.outputs ?? {}).map((o) => o.file).join(', ')}`,
-    `  filmed ${r.capture?.seconds} s frame by frame (${r.capture?.frames} frames, ${r.capture?.heldFrames} held); ${r.capture?.audio ? `${r.capture.audio.placed} sounds rebuilt from the game's own files` : 'the game logged no sound'}`,
+    `  filmed ${r.capture?.seconds} s ${live ? 'live' : 'frame by frame'} (${r.capture?.frames} frames, ${r.capture?.heldFrames} held); ${sound}`,
     `  ${r.edit?.shots} shots of ${r.edit?.shotSeconds} s, picked ${r.edit?.picked}`,
     ...(r.warnings ?? []).map((w) => `  warning: ${w}`),
     ...(r.next ? [`  next (the video skill's script): ${r.next}`] : []),

package/lib/typecheck.mjs

@@ -93,12 +93,12 @@ export function typecheck(root, games, { log = () => {} } = {}) {
       }
       // An error with no file is the project itself (a tsconfig.json that does not read): the game's to fix.
       const bare = /^error (TS\d+): (.*)$/.exec(line);
-      if (bare) mine.push(`games/${g.id}${own ? '/tsconfig.json' : ''} ${bare[1]} ${bare[2]}`);
+      if (bare) mine.push(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}${own ? '/tsconfig.json' : ''} ${bare[1]} ${bare[2]}`);
     }
     rows.push({ id: g.id, checked: true, with: own ? 'its tsconfig.json' : 'the build\'s own settings', errors: mine.length, elsewhere });
-    if (elsewhere) log(`types: games/${g.id}: ${elsewhere} ${elsewhere === 1 ? 'error' : 'errors'} outside the game's own files (a package it imports as source); not the game's, so not counted`);
+    if (elsewhere) log(`types: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: ${elsewhere} ${elsewhere === 1 ? 'error' : 'errors'} outside the game's own files (a package it imports as source); not the game's, so not counted`);
     if (mine.length) found.push(...mine);
-    else log(`types: games/${g.id} has no type errors (TypeScript ${ts.version ?? '?'}, ${own ? 'its tsconfig.json' : 'the build\'s own settings'})`);
+    else log(`types: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id} has no type errors (TypeScript ${ts.version ?? '?'}, ${own ? 'its tsconfig.json' : 'the build\'s own settings'})`);
   }
   if (found.length) {
     const shown = found.slice(0, 20);
@@ -125,7 +125,7 @@ export async function typecheckRules(root, g, checked, tune, { log = () => {} }
     '@homie-rocks/studio/*': [join(PACKAGE_ROOT, '*')],
   } }, files: [join(g.dir, 'src/rules.ts'), join(g.dir, g.entry ?? 'src/view.ts'), join(dir, 'files.d.ts')] }, null, 2)}\n`);
   const res = await runRulesCompiler(compiler, ['-p', project, '--pretty', 'false']);
-  if (res.error) throw new Error(`games/${g.id}: the rules type check could not finish: ${res.error.message}`);
+  if (res.error) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: the rules type check could not finish: ${res.error.message}`);
   const messages = [];
   for (const line of `${res.stdout ?? ''}\n${res.stderr ?? ''}`.split(/\r?\n/)) {
     const at = /^(.+?)\((\d+),(\d+)\): error (TS\d+): (.*)$/.exec(line);
@@ -134,7 +134,9 @@ export async function typecheckRules(root, g, checked, tune, { log = () => {} }
       // Imported game helpers count too. Only the toolkit's own implementation is outside the author's remit.
       if (!file.startsWith(`${PACKAGE_ROOT}${sep}`) && !file.includes(`${sep}node_modules${sep}`) || file.startsWith(`${g.dir}${sep}`)) {
         const sourceLine = readFileSync(file,'utf8').split(/\r?\n/)[Number(at[2])-1] ?? '';
-        const advice = /Property 'ask'.*type 'never'/.test(at[5]) ? 'This handler scope never calls world.ask, so no answer can arrive here. Handle the answer in the scope that asks.'
+        const advice = /Property 'bot'.*RosterRow/.test(at[5]) ? "Rules roster rows use driver === 'bot' or 'ai' (not row.bot); preserve the visible AI label."
+          : /'[^']*\.at' is possibly 'undefined'/.test(at[5]) ? 'Effects carry either at (position) or id (entity). Check e.at before reading coordinates, or resolve e.id with room.get.'
+          : /Property 'ask'.*type 'never'/.test(at[5]) ? 'This handler scope never calls world.ask, so no answer can arrive here. Handle the answer in the scope that asks.'
           : /world\.round\.end/.test(sourceLine) && at[4] === 'TS2339' ? 'Only room handlers end a round. Send a declared event to a room handler that calls world.round.end().'
           : /'check'.*does not exist/.test(at[5]) ? 'Remove the obsolete check key. Generated observations require no exemption.'
           : /=> (?:GameDecision|GuideDecision)'/.test(at[5]) ? 'A floor returns goal and say names from agents.json with exactly the args and sayArgs each declares, or {} to decline. Forward a request as { goal: ask.k, args: ask.args }.'
@@ -150,7 +152,7 @@ export async function typecheckRules(root, g, checked, tune, { log = () => {} }
     } else if (/^error TS/.test(line)) messages.push(line);
     else if (/^\s+\S/.test(line) && messages.length) messages[messages.length - 1] += `\n${line.length > 360 ? line.slice(0, 220) + ' … ' + line.slice(-100) : line}`;
   }
-  if (messages.length) throw new Error(`games/${g.id}: its rules have type errors:\n${messages.slice(0, 30).map((m) => `  ${m}`).join('\n')}`);
-  if (res.status !== 0 && !res.stdout) throw new Error(`games/${g.id}: TypeScript stopped without diagnostics (${res.signal ?? res.status})`);
-  log(`types: games/${g.id}: rules, move and view checked with the toolkit's strict compiler`);
+  if (messages.length) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: its rules have type errors:\n${messages.slice(0, 30).map((m) => `  ${m}`).join('\n')}`);
+  if (res.status !== 0 && !res.stdout) throw new Error(`${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: TypeScript stopped without diagnostics (${res.signal ?? res.status})`);
+  log(`types: ${g.kind === 'app' ? 'apps' : 'games'}/${g.id}: rules, move and view checked with the toolkit's strict compiler`);
 }

package/lib/upgrade.mjs

@@ -1,3 +1,4 @@
+import {refreshWorkerConfig} from './worker-config.mjs';
 /**
  * `homie-studio upgrade [--apply] [--diff]` — an existing studio takes what this version's template adds, and
  * nothing it made its own is ever overwritten.
@@ -346,6 +347,7 @@ export function upgradeApply(root, plan) {
     }
     if (text !== null && (!existsSync(path) || readFileSync(path, 'utf8') !== text)) writeAtomic(path, text);
   }
+  refreshWorkerConfig(root);
   const pinned = done.some((c) => c.kind === 'pin');
   return {
     ...plan, applied: true, done, skipped,

package/lib/worker-build.mjs

@@ -1,34 +1,22 @@
-import {existsSync,mkdirSync,readFileSync,writeFileSync,rmSync} from 'node:fs';
-import {join,relative,dirname} from 'node:path';
+import {refreshWorkerConfig} from './worker-config.mjs';
+import {pathToFileURL} from 'node:url';
+import {existsSync,mkdirSync,writeFileSync,rmSync} from 'node:fs';
+import {join,relative} from 'node:path';
 import {readConfig} from './routes.mjs';
 import {paidReleases} from './parts-upload.mjs';
-import {configPath} from './studio.mjs';
 /** Preserve dynamic imports as real Worker modules: page startup never evaluates MCP libraries. */
 export async function buildWorker(root,esbuild) {
   const source=join(root,'site/src/worker.mjs');if(!existsSync(source))return;
   const out=join(root,'site/src/runtime');
+  refreshWorkerConfig(root);
   const alias={...(readConfig(root)?.alias??{})};
-  if(paidReleases(root).length)alias['@homie-rocks/studio/worker']='@homie-rocks/studio/worker/selling';
+  const toolModule=join(root,'site/src/tools/index.mjs');
+  const pricedTools=existsSync(toolModule) && (await import(pathToFileURL(toolModule).href+'?worker='+Date.now())).default.some(tool=>tool.price);
+  if(paidReleases(root).length || existsSync(join(root,'shop.json')) || pricedTools)alias['@homie-rocks/studio/worker']='@homie-rocks/studio/worker/selling';
   const result=await esbuild.build({entryPoints:[source],absWorkingDir:root,alias,outdir:out,bundle:true,splitting:true,format:'esm',platform:'browser',mainFields:['module','main'],conditions:['workerd','worker','browser'],external:['node:*','cloudflare:*'],target:'es2022',write:false,minify:true,metafile:true,logLevel:'silent'});
   rmSync(out,{recursive:true,force:true});
   mkdirSync(out,{recursive:true});
   for(const file of result.outputFiles)writeFileSync(file.path,file.contents);
-  const config=configPath(root);
-  if(existsSync(config)){
-    const original=readFileSync(config,'utf8');
-    const json=JSON.parse(original.replace(/^\s*\/\/.*$/gm,''));
-    const before=JSON.stringify(json);
-    json.main=relative(dirname(config),join(out,'worker.js')).split('\\').join('/');
-    json.no_bundle=true;json.find_additional_modules=true;
-    json.rules=[...(json.rules??[]).filter(r=>!r.homieMcp),{type:'ESModule',globs:['**/*.js'],fallthrough:true}];
-    // No duplicate rule on rebuild.
-    json.rules=json.rules.filter((r,i,all)=>all.findIndex(x=>JSON.stringify(x)===JSON.stringify(r))===i);
-    json.compatibility_flags=[...new Set([...(json.compatibility_flags??[]),'nodejs_compat'])];
-    if(JSON.stringify(json)!==before) {
-      const comments=original.match(/^(?:\s*\/\/[^\n]*\n)*/)?.[0]??'';
-      writeFileSync(config,comments+JSON.stringify(json,null,2)+'\n');
-    }
-  }
   const sizes=Object.entries(result.metafile.outputs).map(([path,value])=>({path:relative(root,path),bytes:value.bytes,imports:value.imports}));
   writeFileSync(join(out,'modules.json'),JSON.stringify(sizes,null,2)+'\n');
   return sizes;

package/lib/worker-config.mjs

@@ -0,0 +1,28 @@
+import {readFileSync,writeFileSync,existsSync} from 'node:fs';
+import {join} from 'node:path';
+import {configPath,readStudio,layoutOf,listExperiences} from './studio.mjs';
+import {wranglerConfig} from './scaffold.mjs';
+import {paidReleases} from './parts-upload.mjs';
+const parse=t=>JSON.parse(t.replace(/^\s*\/\/.*$/gm,''));
+const read=file=>existsSync(file)?parse(readFileSync(file,'utf8')):{};
+function merge(base,custom) {
+  if(Array.isArray(custom))return custom;
+  if(custom && typeof custom==='object')return Object.fromEntries([...new Set([...Object.keys(base??{}),...Object.keys(custom)])].sort().map(k=>[k,k in custom?merge(base?.[k],custom[k]):base[k]]));
+  return custom;
+}
+/** Generated output is never an input. Studio additions belong in wrangler.custom.json. */
+export function updateWorkerConfig(root,generated) {
+  const file=configPath(root),next=merge(parse(generated),read(join(root,'wrangler.custom.json')));
+  const text='// Generated by homie-studio. Edit studio.json or wrangler.custom.json, then build.\n'+JSON.stringify(next,null,2)+'\n';
+  if(!existsSync(file)||readFileSync(file,'utf8')!==text)writeFileSync(file,text);
+}
+export function refreshWorkerConfig(root,overrides={}) {
+  const studio=readStudio(root),cf=studio.cloudflare;
+  if(!cf?.worker)return;
+  const metadata=read(join(root,'site/src/functions/declarations.json'));
+  const functions=Array.isArray(metadata)?metadata:[];
+  const tools=read(join(root,'site/src/tools/declarations.json'));
+  const ai=cf.ai??listExperiences(root).some(g=>g.decide===true || g.chat!==false && (g.chat?.mode??'text')==='text' && g.chat?.ai!==false);
+  const paid=paidReleases(root).length>0||existsSync(join(root,'shop.json'))||tools.paid===true;
+  updateWorkerConfig(root,wranglerConfig({worker:cf.worker,name:studio.name,d1:cf.d1,d1Id:cf.d1Id,r2:cf.r2,layout:layoutOf(root),ai,paidParts:paid,partsRateLimit:cf.purchaseRateLimit??null,routes:cf.routes??null,triggers:functions.length?{crons:[...new Set(['* * * * *',...functions.map(f=>f.schedule).filter(Boolean)])].sort()}:null,...overrides}));
+}

package/netplay/NETPLAY.md

@@ -1,5 +1,13 @@
 # Homie netplay contract, v1 (revision 11)
 
+**Authoring now:** New games use rules plus view and the server as host. Read the
+Homie game skill's RULES.md and section 29 below. Sections 1–28 preserve the
+browser-hosted helper contract for existing games and describe shared shell
+features; their createNetplay/host-loop examples are not a recipe for new games.
+Use the skill's REWRITE.md for an owner-requested rewrite. All five starters use
+server rules. Room seats are capped at 32; larger rooms are future work.
+
+
 Status: **v1, revision 11** (2026-10-08, `@homie-rocks/studio` 0.33.1). The wire
 version is `v: 1`. Everything revisions 2 to 11 added is either an optional field, a new message type,
 a new refusal, or a change of pace inside the old caps, and both sides ignore types they do

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.40.0",
+  "version": "0.43.0",
   "description": "A studio for games, music and video on its own Cloudflare: scaffold, multiplayer starters on the netplay contract, a port toolkit that makes existing single-player web games multiplayer, the site Worker with public rooms (Table/Lobby Durable Objects and D1, all on the free Workers plan, no payment method), a site with the hub's sections (Home, Games, Music, Videos, Rooms, Posts with feeds) in the studio's own look, an epic landing page for every game, big songs and videos in the studio's own R2 once it has storage (uploaded, checked by SHA-256, served at the same addresses), deploy, and the homie.rocks directory.",
   "type": "module",
   "license": "Apache-2.0",
@@ -88,6 +88,10 @@
     "./tools": {
       "types": "./tools/tools.ts",
       "default": "./tools/tools.ts"
+    },
+    "./functions": {
+      "types": "./functions/functions.ts",
+      "default": "./functions/functions.ts"
     }
   },
   "files": [
@@ -116,7 +120,8 @@
     "links/",
     "apps/",
     "app-starters/",
-    "tools/"
+    "tools/",
+    "functions/"
   ],
   "engines": {
     "node": ">=22"

package/rules/host.ts

@@ -2,8 +2,8 @@
  * host.ts — the host runtime: a rules module playing the host's part on the wire.
  * =============================================================================
  *
- * Today one player's browser is a room's host: it runs the rules and the clock and sends everybody the state. The host
- * runtime is that host with no browser in it. It takes a compiled rules module (rules.ts) and three things from its
+ * The server normally hosts the room: rules, clock and state. Browser hosting uses the same runtime
+ * for offline play, local development or private friends games. It takes a compiled rules module (rules.ts) and three things from its
  * caller: a way to send a frame, a clock and a store. It has no transport in it and no Cloudflare in it, in the style of
  * worker/room.mjs. Inside the `Table` (worker/index.mjs) the relay hands it parsed frames and fans out what it sends;
  * in Node the tests and the build check drive it with a clock of their own.

package/rules/view.ts

@@ -672,6 +672,7 @@ export function openRoom<R = unknown>(opts: OpenRoomOptions = {}): Room<R> {
   net.expose({
     self: () => { const m = meNow(); return m ? { x: m.pos.x, y: m.pos.y, z: m.pos.z } : null; },
     peer: (seat: number) => { if (!latest) return null; for (const u of latest.ents.values()) if (u.seat === seat) return { x: u.pos.x, y: u.pos.y, z: u.pos.z }; return null; },
+    movement: () => { const kinds = schema.kinds.filter(k => k.player); return kinds.length && kinds.every(k => k.maxSpeed === 0) ? 'stationary' : 'spatial'; },
     prediction: () => ({ ...correction, observedLeadAt, lastSendAt, now: clock(), serverTick: latest?.k, tick: stepped, catchTick, lead: targetLead(), medianLead: medianLead(), rate: speed, rtt: authorityRtt(), hostAge: quantile(hostAges, 0.5), pending: pending.length }),
     scores: () => roster().map((r) => ({ seat: r.seat, score: r.score })),
     score: myScore, tick: () => latest?.k ?? 0, epoch: () => epoch, hosted: () => net.rulesHosting ? 'browser' : schema.settings.host, status: () => solo ? 'offline' : status,

package/shop/SHOP.md

@@ -39,9 +39,10 @@ A kind is a label, not a recurring-billing, wallet, random-reward or fulfillment
   omitted limits do not apply. `referralNewPlayersOnly: true` limits attribution to new players.
 - `catalog`: modes (`test`, `live`) populated by `homie-studio shop catalog` for named Stripe Products.
   Prices always come from your file, even when a Stripe Product exists.
-- Flood protection: `purchaseAttemptsPerMinute` (6 per buyer),
-  `purchaseAttemptsPerAddressPerMinute` (600), `guestBuyersPerAddressPerHour` (600).
-  These are configurable positive integers, per Worker instance. `PLAYER_LIMIT_DAILY` also applies.
+- Optional flood protection: `purchaseAttemptsPerMinute`,
+  `purchaseAttemptsPerAddressPerMinute`, `guestBuyersPerAddressPerHour`.
+  Omitted or null means no limit. Explicit positive integers apply per Worker instance.
+  An explicitly set `PLAYER_LIMIT_DAILY` also applies to new shop buyers.
   Referral delivery uses `REFERRAL_STATEMENTS_PER_MINUTE`, `REFERRAL_STATEMENTS_GLOBAL_PER_MINUTE`
   (both 30), and `REFERRAL_STATEMENT_BYTES` (65536). `requestBytes` overrides the catalog-sized shop request
   allowance; `SHOP_WEBHOOK_BYTES` (524288) controls the webhook byte allowance.

package/starters/coin-dash/src/move.ts

@@ -1,3 +1,5 @@
+// This same guarded step runs on the server and immediately for the local player.
+// Only pose/motion, input, ctx map/public tune/math/clocks: no scores, queries or random.
 /*
  * COIN DASH — how a runner moves. Its own file, because two places run it: the server, for every body it moves, and
  * each player's browser, for that player's own body. So it reads only what both have: the body's own position,

package/starters/coin-dash/src/rules.ts

@@ -1,3 +1,5 @@
+// Game truth lives here: declared fields, legal inputs, next-tick events and the server clock.
+// Read the game skill RULES.md before changing the mechanic; keep presentation in view.ts.
 /*
  * COIN DASH — the rules: the example of a game whose rules run on the server.
  *

package/starters/coin-dash/src/view.ts

@@ -1,3 +1,5 @@
+// Presentation only: openRoom gives predicted own movement and interpolated other bodies.
+// Send intent; rules decide outcomes. Keep rendered obstacles aligned with room.map.
 /*
  * COIN DASH — the view: what a player sees, and what they press.
  *

package/starters/ember-vale/src/move.ts

@@ -1,3 +1,5 @@
+// This same guarded step runs on the server and immediately for the local player.
+// Only pose/motion, input, ctx map/public tune/math/clocks: no scores, queries or random.
 import { defineMove } from '@homie-rocks/studio/rules';
 
 export const move = defineMove({

package/starters/ember-vale/src/rules.ts

@@ -1,3 +1,5 @@
+// Game truth lives here: declared fields, legal inputs, next-tick events and the server clock.
+// Read the game skill RULES.md before changing the mechanic; keep presentation in view.ts.
 import { defineRules, f, type GameWorld, type GameSelf } from '@homie-rocks/studio/rules';
 import { move } from './move';
 

package/starters/ember-vale/src/view.ts

@@ -1,3 +1,5 @@
+// Presentation only: openRoom gives predicted own movement and interpolated other bodies.
+// Send intent; rules decide outcomes. Keep rendered obstacles aligned with room.map.
 /** Ember Vale: server-run hunts, with the hero save and memorials owned by its player. */
 import { AI_MARK, BUBBLE_FONT, createBubbles, createControls, createLabels, paintBubbles, type BubbleIn, type BubbleOut, createSaves, easeView, exposePort, fitView, stripAi, type BodyBase, type Fit, type LabelIn, type LabelOut, type NetEvent } from '@homie-rocks/studio/port';
 // The Game Lab: tunables, phases, tracks and overlays (no-ops outside the lab).

package/starters/gem-rush/src/move.ts

@@ -1,3 +1,5 @@
+// This same guarded step runs on the server and immediately for the local player.
+// Only pose/motion, input, ctx map/public tune/math/clocks: no scores, queries or random.
 import { defineMove } from '@homie-rocks/studio/rules';
 
 export const move = defineMove({

package/starters/gem-rush/src/rules.ts

@@ -1,3 +1,5 @@
+// Game truth lives here: declared fields, legal inputs, next-tick events and the server clock.
+// Read the game skill RULES.md before changing the mechanic; keep presentation in view.ts.
 import { defineRules, f } from '@homie-rocks/studio/rules';
 import { move } from './move';
 

package/starters/gem-rush/src/view.ts

@@ -1,3 +1,5 @@
+// Presentation only: openRoom gives predicted own movement and interpolated other bodies.
+// Send intent; rules decide outcomes. Keep rendered obstacles aligned with room.map.
 /** Gem Rush: the canvas draws the room; rules.ts decides the game. Coordinates here are pixels (50 per metre). */
 import { openRoom, type Entity } from '@homie-rocks/studio/rules/view';
 import type rules from './rules';

package/starters/gem-rush-3d/src/move.ts

@@ -1,3 +1,5 @@
+// This same guarded step runs on the server and immediately for the local player.
+// Only pose/motion, input, ctx map/public tune/math/clocks: no scores, queries or random.
 import { defineMove, type Vec3 } from '@homie-rocks/studio/rules';
 
 import type { MoveBody, MoveContext } from '@homie-rocks/studio/rules/types';

package/starters/gem-rush-3d/src/rules.ts

@@ -1,3 +1,5 @@
+// Game truth lives here: declared fields, legal inputs, next-tick events and the server clock.
+// Read the game skill RULES.md before changing the mechanic; keep presentation in view.ts.
 import { defineRules, f, type GameWorld } from '@homie-rocks/studio/rules';
 import { move } from './move';
 

package/starters/gem-rush-3d/src/view.ts

@@ -1,3 +1,5 @@
+// Presentation only: openRoom gives predicted own movement and interpolated other bodies.
+// Send intent; rules decide outcomes. Keep rendered obstacles aligned with room.map.
 /** Gem Rush 3D: the room runs the rules; this view draws the meadow and its animals. */
 import {
   AmbientLight, AnimationClip, AnimationMixer, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CircleGeometry, Color, ConeGeometry, CylinderGeometry,

package/starters/hero-rush-3d/src/move.ts

@@ -1,3 +1,5 @@
+// This same guarded step runs on the server and immediately for the local player.
+// Only pose/motion, input, ctx map/public tune/math/clocks: no scores, queries or random.
 import { defineMove, type Vec3 } from '@homie-rocks/studio/rules';
 
 import type { MoveBody, MoveContext } from '@homie-rocks/studio/rules/types';

package/starters/hero-rush-3d/src/rules.ts

@@ -1,3 +1,5 @@
+// Game truth lives here: declared fields, legal inputs, next-tick events and the server clock.
+// Read the game skill RULES.md before changing the mechanic; keep presentation in view.ts.
 import { defineRules, f, type GameWorld } from '@homie-rocks/studio/rules';
 import { move } from './move';
 

package/starters/hero-rush-3d/src/view.ts

@@ -1,3 +1,5 @@
+// Presentation only: openRoom gives predicted own movement and interpolated other bodies.
+// Send intent; rules decide outcomes. Keep rendered obstacles aligned with room.map.
 /** Hero Rush 3D: server rules, predicted jumps, and the original meadow and heroes. */
 import {
   AmbientLight, Box3, BoxGeometry, BufferAttribute, BufferGeometry, CanvasTexture, CircleGeometry, Color, ConeGeometry, CylinderGeometry,