@homie-rocks/studio 0.24.3 → 0.24.5

package/worker/chat-page.mjs

@@ -3,10 +3,11 @@
  * screen (the TV view) and the watch page. It speaks on the page's own watch socket, so every game has it, old builds
  * too, with no game code:
  *
- *   play      a Chat pill beside the room button (the corner game.json screen.share keeps clear of the game's HUD),
- *             its sheet (the room's last minutes, the room's emoji, its quick lines, typing where the rules allow,
- *             Report on a line, and for the studio's owner Remove, Mute and Kick), a short ticker of new lines where the
- *             status chip sits, and reactions floating up the screen
+ *   play      a Chat pill beside the room button (the corner game.json screen.share keeps clear of the game's HUD; the
+ *             round icon on a phone, as the room button is), its sheet (the room's last minutes, the room's emoji, its
+ *             quick lines, typing where the rules allow, Report on a line, and for the studio's owner Remove, Mute and
+ *             Kick), a short strip of new lines where the status chip sits or where game.json screen.chat puts it
+ *             (chatPlaces; "sheet-only" keeps them in the sheet), and reactions floating up the screen
  *   tv        the room's lines in a corner (no typing: a television is read across a room) and the float
  *   watch     a Chat button in the watch page's band, its panel over the stage, and the float
  *
@@ -22,17 +23,86 @@ import { REACTIONS } from './chat.mjs';
 import { REPORT_REASONS, REPORT_WORDS } from './chat-store.mjs';
 import { NET_PALETTE } from './room.mjs';
 
+/** Where room chat's strip of new lines may sit: a corner, or the middle of the top or bottom edge. */
+export const CHAT_PLACES = ['top-left', 'top-center', 'top-right', 'bottom-left', 'bottom-center', 'bottom-right'];
+const CHAT_CORNERS = ['top-left', 'top-right', 'bottom-left', 'bottom-right'];
+const CHAT_DEVICES = ['desk', 'phone', 'sideways', 'tv'];
+const CHAT_FIELDS = ['at', 'x', 'y', 'lines'];
+
+/** One entry of game.json `screen.chat` as written (a place, false, or an object), keeping only the fields that are right. */
+function chatEntry(v) {
+  if (v === false) return { lines: 'sheet-only' };
+  if (typeof v === 'string') return CHAT_PLACES.includes(v) ? { at: v } : {};
+  if (!v || typeof v !== 'object' || Array.isArray(v)) return {};
+  const o = {};
+  if (CHAT_PLACES.includes(v.at)) o.at = v.at;
+  for (const k of ['x', 'y']) if (v[k] !== undefined && v[k] !== null && v[k] !== '' && Number.isFinite(Number(v[k]))) o[k] = Math.round(Number(v[k]));
+  if (v.lines === 'strip' || v.lines === 'sheet-only') o.lines = v.lines;
+  return o;
+}
+
+/**
+ * Where room chat sits on each screen, from game.json `screen.chat` (0.24.5), so a game with a busy HUD keeps its chat
+ * off its clock, its title and its controls. The Chat pill itself sits in the room button's band (`screen.share`
+ * places both); this places the strip of new lines that shows for a moment, and the big screen's corner of lines:
+ *
+ *   "chat": "bottom-right"                                   every device's strip there (and the big screen's corner)
+ *   "chat": false                                            no strip: new lines wait in the sheet, the pill counts them
+ *   "chat": { "at": "top-left", "y": 120 }                   moved 120 px in from its edge (x: from its side)
+ *   "chat": { "lines": "strip", "phone": { "lines": "sheet-only" }, "tv": { "at": "top-right" } }
+ *
+ * `at` is a place from CHAT_PLACES (default: the bottom left, or the bottom right when the room button is there); `x`
+ * and `y` move it in, 0 to 600 px (in the middle of an edge, `x` moves it either way); `lines` is "strip" (the default)
+ * or "sheet-only". `desk`, `phone` (held upright), `sideways` (else as `phone`) and `tv` (the big screen) each change
+ * only what they name. The big screen has no sheet: it takes a corner only, its place follows the top level's when that
+ * is a corner, and its lines stay unless its own entry says "sheet-only" (then it shows only the float).
+ */
+export function chatPlaces(value) {
+  const top = chatEntry(value);
+  const per = value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+  const done = (o) => {
+    const at = o.at ?? null;
+    const clamp = (n, lo) => Math.max(lo, Math.min(600, n ?? 0));
+    return { at, x: clamp(o.x, at && at.endsWith('center') ? -600 : 0), y: clamp(o.y, 0), lines: o.lines ?? 'strip' };
+  };
+  const phone = { ...top, ...chatEntry(per.phone) };
+  const { lines: _l, ...where } = top;
+  const own = chatEntry(per.tv);
+  if (own.at && !CHAT_CORNERS.includes(own.at)) delete own.at;
+  const tv = { ...(CHAT_CORNERS.includes(where.at) ? where : {}), ...own };
+  return { desk: done({ ...top, ...chatEntry(per.desk) }), phone: done(phone), sideways: done({ ...phone, ...chatEntry(per.sideways) }), tv: done(tv) };
+}
+
+/** game.json `screen.chat` as the build reads it: the problems in words (the page uses the default for anything wrong). */
+export function screenChatProblems(value) {
+  if (value === undefined || value === null || value === false) return [];
+  const out = [];
+  const one = (v, name, top) => {
+    if (v === false) return;
+    if (typeof v === 'string') { if (!CHAT_PLACES.includes(v)) out.push(`${name} "${v}" is not a place (${CHAT_PLACES.join(', ')})`); return; }
+    if (!v || typeof v !== 'object' || Array.isArray(v)) { out.push(`${name} is a place, false, or { "at", "x", "y", "lines" }`); return; }
+    for (const k of Object.keys(v)) {
+      if (top && CHAT_DEVICES.includes(k)) continue;
+      if (!CHAT_FIELDS.includes(k)) out.push(`${name}.${k} is not a field (${k === 'corner' || k === 'place' ? 'the place is "at"' : `${CHAT_FIELDS.join(', ')}${top ? `, or ${CHAT_DEVICES.join(', ')}` : ''}`})`);
+    }
+    if (v.at !== undefined && !CHAT_PLACES.includes(v.at)) out.push(`${name}.at "${v.at}" is not a place (${CHAT_PLACES.join(', ')})`);
+    if (name.endsWith('.tv') && v.at !== undefined && !CHAT_CORNERS.includes(v.at)) out.push(`${name}.at: the big screen takes a corner`);
+    for (const k of ['x', 'y']) if (v[k] !== undefined && !Number.isFinite(Number(v[k]))) out.push(`${name}.${k} is a number of pixels`);
+    if (v.lines !== undefined && v.lines !== 'strip' && v.lines !== 'sheet-only') out.push(`${name}.lines is "strip" or "sheet-only"`);
+  };
+  one(value, 'screen.chat', true);
+  if (value && typeof value === 'object' && !Array.isArray(value)) for (const d of CHAT_DEVICES) if (value[d] !== undefined) one(value[d], `screen.chat.${d}`, false);
+  return out.slice(0, 8);
+}
+
 /** What a page's chat starts from (`window.__HOMIE_CHAT`): its surface, the game, and who this browser is to the studio. */
-export function chatBoot(g, { surface = 'play', owner = false, acct = false, member = false, room = null, place = null } = {}) {
-  const screen = g?.screen?.chat;
-  const ticker = screen === false ? false : typeof screen === 'string' ? screen : screen && typeof screen === 'object' && typeof screen.at === 'string' ? screen.at : null;
+export function chatBoot(g, { surface = 'play', owner = false, acct = false, member = false, room = null } = {}) {
   return {
     surface, game: g.id, name: g.name, owner: Boolean(owner), acct: Boolean(acct), member: Boolean(member), palette: NET_PALETTE,
     reactions: REACTIONS, reasons: REPORT_REASONS.map((k) => ({ k, text: REPORT_WORDS[k] })),
     ...(room ? { room } : {}),
-    // game.json "screen": { "chat": "bottom-right" | false }: where new lines show for a moment (false: only the pill's count).
-    ...(ticker !== null ? { ticker } : {}),
-    ...(place ? { place } : {}),
+    // game.json "screen": { "chat": … }: where the strip of new lines sits on each device, or "sheet-only" (chatPlaces).
+    places: chatPlaces(g?.screen?.chat),
     account: '/account/',
   };
 }
@@ -42,7 +112,11 @@ export const CHAT_CSS = `
 .cpill .cico { width: 15px; height: 15px; flex: none; }
 .cpill .cbadge { min-width: 16px; height: 16px; padding: 0 4px; box-sizing: border-box; border-radius: 8px; background: var(--hot); color: #0b0b10; font: 800 10px/16px ui-sans-serif, system-ui, sans-serif; text-align: center; }
 .cpill.dim .cbadge { display: inline-block; }
+/* The pill as the room button's round icon (on a phone, beside a room button kept an icon, or where its word would reach
+   the game's clock or title): its word goes, and the count rides its corner. */
+.cpill.icon-only, .cpill.icon-only:hover, .cpill.icon-only:focus-visible, .cpill.icon-only[aria-expanded="true"] { position: relative; width: 34px; padding: 0; justify-content: center; }
 .cpill.icon-only span.cword { display: none; }
+.cpill.icon-only .cbadge { position: absolute; top: -5px; right: -5px; min-width: 16px; box-shadow: 0 0 0 2px rgba(6,9,16,.85); }
 .csheet { display: flex; flex-direction: column; gap: 8px; width: min(340px, calc(100vw - 16px)); }
 .chead { display: flex; align-items: center; gap: 8px; margin: 0 2px; }
 .chead b { font: 800 15px/1.2 ui-sans-serif, system-ui, sans-serif; letter-spacing: -.01em; }
@@ -88,24 +162,25 @@ export const CHAT_CSS = `
 .creport { display: grid; grid-template-columns: 1fr 1fr; gap: 6px; margin: 6px 0 2px; }
 .creport p { grid-column: 1 / -1; margin: 0; color: #c3cad9; font: 600 12.5px/1.35 ui-sans-serif, system-ui, sans-serif; }
 .creport button { min-height: 32px; padding: 0 8px; border-radius: 9px; border: 1px solid rgba(255,255,255,.16); background: transparent; color: inherit; font: 700 12px/1.2 ui-sans-serif, system-ui, sans-serif; cursor: pointer; text-align: left; }
-.ctick { position: fixed; z-index: 5; display: flex; flex-direction: column; gap: 4px; max-width: min(320px, calc(100vw - 24px)); pointer-events: none; }
-.ctick.at-bottom-left { left: max(10px, env(safe-area-inset-left)); bottom: calc(max(10px, env(safe-area-inset-bottom)) + 36px); align-items: flex-start; }
-.ctick.at-bottom-right { right: max(10px, env(safe-area-inset-right)); bottom: calc(max(10px, env(safe-area-inset-bottom)) + 36px); align-items: flex-end; }
-.ctick.at-bottom-center { left: 50%; transform: translateX(-50%); bottom: calc(max(10px, env(safe-area-inset-bottom)) + 36px); align-items: center; }
-.ctick.at-top-left { left: max(10px, env(safe-area-inset-left)); top: calc(max(10px, env(safe-area-inset-top)) + 48px); align-items: flex-start; flex-direction: column-reverse; }
-.ctick.at-top-right { right: max(10px, env(safe-area-inset-right)); top: calc(max(10px, env(safe-area-inset-top)) + 48px); align-items: flex-end; flex-direction: column-reverse; }
-.ctick.at-top-center { left: 50%; transform: translateX(-50%); top: calc(max(10px, env(safe-area-inset-top)) + 48px); align-items: center; flex-direction: column-reverse; }
+/* The strip of new lines (game.json screen.chat: its place, moved in by --chat-x / --chat-y). */
+.ctick { --chat-x: 0px; --chat-y: 0px; position: fixed; z-index: 5; display: flex; flex-direction: column; gap: 4px; max-width: min(320px, calc(100vw - 24px)); pointer-events: none; }
+.ctick.at-bottom-left { left: calc(max(10px, env(safe-area-inset-left)) + var(--chat-x)); bottom: calc(max(10px, env(safe-area-inset-bottom)) + 36px + var(--chat-y)); align-items: flex-start; }
+.ctick.at-bottom-right { right: calc(max(10px, env(safe-area-inset-right)) + var(--chat-x)); bottom: calc(max(10px, env(safe-area-inset-bottom)) + 36px + var(--chat-y)); align-items: flex-end; }
+.ctick.at-bottom-center { left: calc(50% + var(--chat-x)); transform: translateX(-50%); bottom: calc(max(10px, env(safe-area-inset-bottom)) + 36px + var(--chat-y)); align-items: center; }
+.ctick.at-top-left { left: calc(max(10px, env(safe-area-inset-left)) + var(--chat-x)); top: calc(max(10px, env(safe-area-inset-top)) + 48px + var(--chat-y)); align-items: flex-start; flex-direction: column-reverse; }
+.ctick.at-top-right { right: calc(max(10px, env(safe-area-inset-right)) + var(--chat-x)); top: calc(max(10px, env(safe-area-inset-top)) + 48px + var(--chat-y)); align-items: flex-end; flex-direction: column-reverse; }
+.ctick.at-top-center { left: calc(50% + var(--chat-x)); transform: translateX(-50%); top: calc(max(10px, env(safe-area-inset-top)) + 48px + var(--chat-y)); align-items: center; flex-direction: column-reverse; }
 .ctick div { padding: 5px 10px; border-radius: 12px; background: rgba(6,9,16,.66); color: #eef1f8; font: 600 13px/1.3 ui-sans-serif, system-ui, -apple-system, sans-serif; overflow-wrap: anywhere; backdrop-filter: blur(6px); -webkit-backdrop-filter: blur(6px); animation: ctin .2s ease-out; transition: opacity .5s; }
 .ctick div b { font-weight: 800; margin-right: 6px; }
 .ctick div.cout { opacity: 0; }
 @keyframes ctin { from { opacity: 0; transform: translateY(6px); } }
 .cfloat { position: fixed; left: 0; top: 0; width: 100%; height: 100%; pointer-events: none; z-index: 4; }
-.ctv { position: fixed; z-index: 6; box-sizing: border-box; width: min(26rem, 30vw); max-height: 42vh; display: flex; flex-direction: column; justify-content: flex-end; gap: .3em; padding: .55em .8em; border-radius: 16px; background: rgba(8,12,22,.7); border: 1px solid rgba(255,255,255,.12); color: #eef1f8; font: 600 clamp(14px, 1.6vmin, 24px)/1.35 ui-sans-serif, system-ui, -apple-system, sans-serif; pointer-events: none; overflow: hidden; }
+.ctv { --chat-x: 0px; --chat-y: 0px; position: fixed; z-index: 6; box-sizing: border-box; width: min(26rem, 30vw); max-height: 42vh; display: flex; flex-direction: column; justify-content: flex-end; gap: .3em; padding: .55em .8em; border-radius: 16px; background: rgba(8,12,22,.7); border: 1px solid rgba(255,255,255,.12); color: #eef1f8; font: 600 clamp(14px, 1.6vmin, 24px)/1.35 ui-sans-serif, system-ui, -apple-system, sans-serif; pointer-events: none; overflow: hidden; }
 .ctv:empty { display: none; }
-.ctv.at-bottom-left { left: max(16px, env(safe-area-inset-left)); bottom: max(16px, env(safe-area-inset-bottom)); }
-.ctv.at-bottom-right { right: max(16px, env(safe-area-inset-right)); bottom: max(16px, env(safe-area-inset-bottom)); }
-.ctv.at-top-left { left: max(16px, env(safe-area-inset-left)); top: max(16px, env(safe-area-inset-top)); justify-content: flex-start; }
-.ctv.at-top-right { right: max(16px, env(safe-area-inset-right)); top: max(16px, env(safe-area-inset-top)); justify-content: flex-start; }
+.ctv.at-bottom-left { left: calc(max(16px, env(safe-area-inset-left)) + var(--chat-x)); bottom: calc(max(16px, env(safe-area-inset-bottom)) + var(--chat-y)); }
+.ctv.at-bottom-right { right: calc(max(16px, env(safe-area-inset-right)) + var(--chat-x)); bottom: calc(max(16px, env(safe-area-inset-bottom)) + var(--chat-y)); }
+.ctv.at-top-left { left: calc(max(16px, env(safe-area-inset-left)) + var(--chat-x)); top: calc(max(16px, env(safe-area-inset-top)) + var(--chat-y)); justify-content: flex-start; }
+.ctv.at-top-right { right: calc(max(16px, env(safe-area-inset-right)) + var(--chat-x)); top: calc(max(16px, env(safe-area-inset-top)) + var(--chat-y)); justify-content: flex-start; }
 .ctv div { overflow-wrap: anywhere; transition: opacity 1s; }
 .ctv div.cout { opacity: 0; }
 .ctv b { font-weight: 800; margin-right: .4em; }
@@ -221,21 +296,41 @@ export const CHAT_JS = String.raw`(function () {
     if (parts.length) raf = requestAnimationFrame(paint);
   }
 
-  /* ------------------------------------------------------------ the ticker: new lines, for a moment, where the chip sits */
+  /* ------------------------------------------------------------ where chat sits on this screen (game.json screen.chat) */
+  // This screen as the room button knows it (desk, phone held upright, phone turned sideways), else by its size.
+  function device() {
+    if (surface === 'tv') return 'tv';
+    var s = window.__shell && window.__shell.share;
+    if (s && s.device) return s.device;
+    var w = window.innerWidth || 0; var h = window.innerHeight || 0;
+    return w && h && Math.min(w, h) <= 540 ? (w > h ? 'sideways' : 'phone') : 'desk';
+  }
+  function placeHere() { var p = cfg.places || {}; return p[device()] || p.desk || { at: null, x: 0, y: 0, lines: 'strip' }; }
+
+  /* ------------------------------------------------------------ the strip: new lines, for a moment, where the chip sits */
   var tickEl = null;
   function tickPlace() {
-    if (cfg.ticker) return cfg.ticker;
+    var p = placeHere();
+    if (p.at) return p.at;
     var s = window.__shell && window.__shell.share;
     return s && s.at === 'bottom-left' ? 'bottom-right' : 'bottom-left';
   }
   function tick(m) {
-    if (surface === 'tv' || cfg.ticker === false || !st.show || st.open) return;
+    if (surface === 'tv' || !st.show || st.open) return;
+    // "sheet-only": a busy HUD keeps new lines in the sheet; the pill's count says they are there.
+    var p = placeHere();
+    if (p.lines === 'sheet-only') return;
     if (!tickEl) {
       var host = (surface === 'watch' ? document.querySelector('.stage') : null) || document.body;
       if (!host) return;
       tickEl = el('div', 'ctick'); tickEl.setAttribute('aria-hidden', 'true'); host.appendChild(tickEl); if (surface === 'watch') tickEl.style.position = 'absolute';
     }
-    tickEl.className = 'ctick at-' + tickPlace();
+    var at = tickPlace();
+    tickEl.className = 'ctick at-' + at;
+    // Moved in by the game's x / y, and past the room button when the strip shares its place.
+    var s = window.__shell && window.__shell.share; var same = surface === 'play' && s && s.at === at;
+    tickEl.style.setProperty('--chat-x', ((p.x || 0) + (same ? s.x || 0 : 0)) + 'px');
+    tickEl.style.setProperty('--chat-y', ((p.y || 0) + (same ? s.y || 0 : 0)) + 'px');
     var row = el('div');
     if (m.name) { var b = el('b', '', m.name); b.style.color = colourOf(m); row.appendChild(b); }
     row.appendChild(document.createTextNode(m.glyph && m.react ? m.glyph : (m.text || '')));
@@ -247,13 +342,16 @@ export const CHAT_JS = String.raw`(function () {
   /* ------------------------------------------------------------ the TV's corner */
   var tvEl = null;
   function tvLine(m) {
-    if (!st.show) return;
+    var p = placeHere();
+    if (!st.show || p.lines === 'sheet-only') return;
     if (!tvEl) {
       if (!document.body) return;
       tvEl = el('div', 'ctv');
       var join = document.querySelector('[data-join]');
       var at = join && /join-bottom-left/.test(join.className) ? 'bottom-right' : join && /join-top-left|join-top-right/.test(join.className) ? 'bottom-left' : 'bottom-left';
-      tvEl.className = 'ctv at-' + (cfg.ticker && cfg.ticker !== 'bottom-center' && cfg.ticker !== 'top-center' ? cfg.ticker : at);
+      tvEl.className = 'ctv at-' + (p.at || at);
+      tvEl.style.setProperty('--chat-x', (p.x || 0) + 'px');
+      tvEl.style.setProperty('--chat-y', (p.y || 0) + 'px');
       document.body.appendChild(tvEl);
     }
     var row = el('div', m.t === 'react' ? 'creact' : '');
@@ -277,6 +375,7 @@ export const CHAT_JS = String.raw`(function () {
       pill = el('button', 'pill cpill'); pill.type = 'button'; pill.setAttribute('data-chat-toggle', ''); pill.setAttribute('aria-expanded', 'false'); pill.setAttribute('aria-controls', 'chat-sheet'); pill.setAttribute('aria-label', 'Room chat');
       pill.innerHTML = ICON; pill.appendChild(el('span', 'cword', 'Chat')); badge = el('b', 'cbadge'); badge.hidden = true; pill.appendChild(badge);
       band.appendChild(pill);
+      watchBand(band);
       sheet = el('div', 'sheet csheet'); sheet.id = 'chat-sheet'; sheet.setAttribute('role', 'dialog'); sheet.setAttribute('aria-label', 'Room chat'); sheet.hidden = true;
       ui.appendChild(sheet);
       // One sheet at a time: the room's and the server's close this one, and this one closes theirs.
@@ -318,6 +417,52 @@ export const CHAT_JS = String.raw`(function () {
     renderFeed();
     paintRules();
   }
+  /*
+   * The pill's word, as the room button's: on a phone (either way up), or beside a room button that game.json keeps an
+   * icon ("label": false), the pill is the round icon from the start. Elsewhere its word shows unless, with it, the band
+   * would leave the screen or reach from its corner into the middle third of the screen's width (where games keep a
+   * clock or a title); once it has, it stays the icon until the screen changes size, so it never flickers as the room
+   * button's own label comes and goes.
+   */
+  var narrow = false;
+  function shareHere() { var s = window.__shell && window.__shell.share; return s || {}; }
+  function wordCollides() {
+    var band = pill && pill.parentNode;
+    var w = window.innerWidth || 0;
+    if (!band || !band.getBoundingClientRect || !w) return false;
+    var had = pill.classList.contains('icon-only');
+    if (had) pill.classList.remove('icon-only');
+    var r = band.getBoundingClientRect();
+    if (had) pill.classList.add('icon-only');
+    if (!r.width) return false;
+    if (r.left < 4 || r.right > w - 4) return true;
+    var at = shareHere().at || 'top-right';
+    if (/center/.test(at)) return false;
+    return /right/.test(at) ? r.left < w * 2 / 3 : r.right > w / 3;
+  }
+  function fitPill() {
+    if (!pill || surface !== 'play') return;
+    var s = shareHere();
+    if (!narrow && s.device !== 'phone' && s.device !== 'sideways' && s.label !== false) narrow = wordCollides();
+    var icon = s.device === 'phone' || s.device === 'sideways' || s.label === false || narrow;
+    if (icon) { pill.classList.add('icon-only'); pill.title = 'Room chat'; } else { pill.classList.remove('icon-only'); pill.title = ''; }
+    st.compact = icon;
+  }
+  var fitQueued = false;
+  function fitSoon() {
+    if (fitQueued) return;
+    fitQueued = true;
+    var go = function () { fitQueued = false; fitPill(); };
+    if (window.requestAnimationFrame) window.requestAnimationFrame(go); else setTimeout(go, 16);
+  }
+  function watchBand(band) {
+    fitPill();
+    // The band changes as the room code arrives, the server's pill shows and the labels fade to dots: look again.
+    try { if (window.ResizeObserver) new ResizeObserver(fitSoon).observe(band); } catch (e) {}
+    // A new size (a turned phone, a resized window): the room button moves first, then the word is measured afresh.
+    window.addEventListener('resize', function () { setTimeout(function () { narrow = false; fitPill(); }, 60); });
+  }
+  st.fit = fitPill;
   function openChat(on, quiet) {
     if (!sheet) return;
     st.open = Boolean(on);

package/worker/chat.mjs

@@ -14,12 +14,15 @@
  *               links, swears, and the studio's own words. It always runs, and it needs nothing.
  *   review      typed text the floor let through, on the studio's own Workers AI: Cloudflare's Clef decision model
  *               (`@cf/cloudflare/clef-flash`, launched 2026-10-01: a probability for each answer, about 40 ms), within a
- *               day's budget of neurons. No binding, no budget left or an error: the floor alone decides.
+ *               day's budget of neurons. Under `homie-studio dev` with no binding, the same questions go to the person's
+ *               own Ollama (clef-flash) when dev found it there: free. No model, no budget left or an error: the floor
+ *               alone decides.
  *
  * Emoji and quick lines are the studio's own words: they never need a review, so they reach every screen at once.
  * NOTHING is stored here: the relay keeps a short window in memory (section 19), and a report keeps only the message.
  */
 import { WORDS_B64 } from './chat-words.mjs';
+import { clefRun, localAiOf } from './brain.mjs';
 
 export const CHAT_MODES = Object.freeze(['off', 'emoji', 'lines', 'text']);
 export const CHAT_WHO = Object.freeze(['anyone', 'signed-in', 'members']);
@@ -206,7 +209,10 @@ export function chatProblems(raw) {
   const out = [];
   if (raw.mode !== undefined && !CHAT_MODES.includes(raw.mode)) out.push('chat.mode is off, emoji, lines or text');
   for (const k of ['who', 'react']) if (raw[k] !== undefined && !CHAT_WHO.includes(raw[k])) out.push(`chat.${k} is anyone, signed-in or members`);
-  if (raw.lines !== undefined && raw.lines !== null) {
+  // Where chat sits on the screen is the page's (game.json "screen": { "chat" }), never the room's rules.
+  for (const k of ['corner', 'place', 'at']) if (raw[k] !== undefined && (k !== 'at' || typeof raw.at === 'string')) out.push(`chat.${k}: where chat sits on the screen goes in "screen": { "chat": { "at": … } }`);
+  if (raw.lines === 'strip' || raw.lines === 'sheet-only') out.push(`chat.lines is the quick lines ({ "id": "text" }); "${raw.lines}" goes in "screen": { "chat": { "lines": "${raw.lines}" } }`);
+  else if (raw.lines !== undefined && raw.lines !== null) {
     const pairs = Array.isArray(raw.lines) ? raw.lines.map((x) => [x?.id, x?.text]) : typeof raw.lines === 'object' ? Object.entries(raw.lines) : null;
     if (!pairs) out.push('chat.lines is { "id": "text" }');
     else {
@@ -387,9 +393,11 @@ const timeout = (p, ms) => Promise.race([p, new Promise((_, no) => setTimeout(()
  * (`why` is the most likely other answer). Throws when there is no binding, the model fails or it takes too long:
  * the caller lets the floor decide.
  */
-export async function reviewChat(env, text, { model = env?.HOMIE_CHAT_MODEL || CHAT_MODEL, ms = CHAT_LIMITS.reviewMs, threshold = REVIEW_THRESHOLD, links = 'block', now = () => Date.now() } = {}) {
-  if (!env?.AI || typeof env.AI.run !== 'function') throw new Error('this Worker has no Workers AI binding (AI)');
-  const spec = CHAT_MODELS[model] ?? CHAT_MODELS[CHAT_MODEL];
+export async function reviewChat(env, text, { model = env?.HOMIE_CHAT_MODEL || CHAT_MODEL, ms = CHAT_LIMITS.reviewMs, threshold = REVIEW_THRESHOLD, links = 'block', now = () => Date.now(), fetch: fetchImpl = null } = {}) {
+  // No binding: the person's own Ollama (`homie-studio dev` found clef-flash there), with the same question. Free.
+  const local = env?.AI && typeof env.AI.run === 'function' ? null : localAiOf(env);
+  if (!local && (!env?.AI || typeof env.AI.run !== 'function')) throw new Error('this Worker has no Workers AI binding (AI)');
+  const spec = local ? { kind: 'clef', name: local.model, input: 0, output: 0 } : CHAT_MODELS[model] ?? CHAT_MODELS[CHAT_MODEL];
   const at = now();
   if (spec.kind === 'guard') {
     const r = await timeout(env.AI.run(model, { messages: [{ role: 'user', content: text }], temperature: 0, max_tokens: 16, response_format: { type: 'json_object' } }), ms);
@@ -402,7 +410,9 @@ export async function reviewChat(env, text, { model = env?.HOMIE_CHAT_MODEL || C
   }
   // A room that allows links says so, so a plain link is not read as spam.
   const verdict = links === 'allow' ? { ...VERDICT, criteria: { ...VERDICT.criteria, spam: 'Ads, scams or spam (a plain link is fine here)' } } : VERDICT;
-  const r = await timeout(env.AI.run(model, { model: spec.name, state: text, questions: { verdict } }), ms);
+  const r = local
+    ? await clefRun(env, { state: text, questions: { verdict }, ms: Math.max(ms, 4000), local, fetch: fetchImpl })
+    : await timeout(env.AI.run(model, { model: spec.name, state: text, questions: { verdict } }), ms);
   const a = r?.answers?.verdict;
   if (!a || typeof a !== 'object') throw new Error('the review answered nothing it could use');
   const probs = a.probabilities && typeof a.probabilities === 'object' ? a.probabilities : null;
@@ -415,5 +425,5 @@ export async function reviewChat(env, text, { model = env?.HOMIE_CHAT_MODEL || C
     why = why ?? 'held';
   }
   const input = Number(r?.usage?.input_tokens ?? r?.usage?.prompt_tokens) || Math.ceil((text.length + VERDICT_CHARS) / 4);
-  return { ok: pOk >= threshold, why, p: Math.round(pOk * 1000) / 1000, neurons: (input * spec.input) / 1e6, ms: now() - at, model };
+  return { ok: pOk >= threshold, why, p: Math.round(pOk * 1000) / 1000, neurons: (input * spec.input) / 1e6, ms: now() - at, model: local ? local.model : model, ...(local ? { local: true } : {}) };
 }

package/worker/index.mjs

@@ -86,7 +86,7 @@ import {
   setMembership,
 } from './servers.mjs';
 import { BRAIN_BUDGET, HouseAgents, agentFacts, aiName, decodeFacts, encodeFacts, passById, passRefusal, sitRoute } from './agents.mjs';
-import { talks } from './brain.mjs';
+import { CLEF, DECIDE, clefRun, costOf, localAiOf, picksOf, talks } from './brain.mjs';
 import { REACTIONS, reviewChat } from './chat.mjs';
 import { REPORT_REASONS, chatDay, chatOf, chatRowsOf, fileReport } from './chat-store.mjs';
 import { doorPage, serverPage, serversPage } from './site.mjs';
@@ -1163,16 +1163,71 @@ export class Table {
     this.vocabRead = this.readVocab(game).catch(() => false);
     // Room chat (section 19): typed text the floor let through waits for the studio's own Workers AI.
     this.room.review = (text, opts) => this.reviewChat(text, opts);
+    // A game's own decisions (section 20): the host's typed questions, for a game whose game.json opts in.
+    this.room.decider = (state, questions, opts) => this.decide(state, questions, opts);
     return this.room;
   }
 
+  /** Whether this game asked for decisions (game.json "decide": true, in the built catalogue), read once a minute. */
+  async decideOn() {
+    if (this.decideRead && Date.now() - this.decideRead.at < 60_000) return this.decideRead.on;
+    let on = false;
+    try {
+      const res = this.env.ASSETS ? await this.env.ASSETS.fetch(new Request('https://assets.local/games.json')) : null;
+      const cat = res?.ok ? await res.json() : null;
+      const g = (cat?.games ?? []).find((x) => x.id === this.game);
+      on = Boolean(g && (g.decide === true || (g.decide && typeof g.decide === 'object' && g.decide.on !== false)));
+    } catch { on = false; }
+    this.decideRead = { at: Date.now(), on };
+    return on;
+  }
+
+  /**
+   * One of a game's own decisions (worker/brain.mjs checkDecide, picksOf): Clef on the studio's Workers AI (model
+   * HOMIE_DECIDE_MODEL, else clef-flash), or the person's own Ollama under `homie-studio dev`, within the AI brains' day
+   * (the same budget the guides spend: decisions and guides are one day of neurons). Not opted in, no AI, over budget, too
+   * slow or failed: `{ ok: false, why }`, and the host's floor answers.
+   */
+  async decide(state, questions) {
+    if (!(await this.decideOn())) return { ok: false, why: 'off' };
+    const local = this.env.AI ? null : localAiOf(this.env);
+    if (!this.env.AI && !local) return { ok: false, why: 'no-ai' };
+    if (this.env.AI) {
+      if (!this.brainDay || Date.now() - this.brainReadAt > 60_000) await this.readBrainDay().catch(() => {});
+      if (this.brainCap.neurons - this.brainUsed.neurons <= 0) return { ok: false, why: 'budget' };
+    }
+    const model = CLEF.models[this.env.HOMIE_DECIDE_MODEL] ? this.env.HOMIE_DECIDE_MODEL : '@cf/cloudflare/clef-flash';
+    const t0 = Date.now();
+    try {
+      const r = await clefRun(this.env, { state, questions, model, ms: DECIDE.ms, local });
+      const ms = Date.now() - t0;
+      const usage = r.usage ?? { input_tokens: Math.ceil(JSON.stringify({ state, questions }).length / 4) + 400, output_tokens: 0 };
+      const cost = costOf({ provider: r.engine === 'local' ? 'local' : 'workers-ai', model: r.model, usage });
+      this.brainSpend({ neurons: cost.neurons, micros: 0, provider: r.engine === 'local' ? 'decide-local' : 'decide' });
+      this.flushSoon();
+      const { picks, p } = picksOf(r.answers, questions);
+      return { ok: true, by: r.engine === 'local' ? 'local' : 'ai', picks, p, ms, neurons: cost.neurons };
+    } catch (error) {
+      return { ok: false, why: /took over/.test(String(error?.message ?? error)) ? 'slow' : 'error' };
+    }
+  }
+
+  /** The day's counters go to D1 on an alarm: set one a minute out when none is set (a house guide's alarm also flushes). */
+  flushSoon() {
+    this.ctx.waitUntil((async () => { if ((await this.ctx.storage.getAlarm()) === null) await this.ctx.storage.setAlarm(Date.now() + 60_000); })().catch(() => {}));
+  }
+
   /**
    * One typed chat message, reviewed by the studio's decision model (worker/chat.mjs reviewChat) within the day's
    * budget for the whole studio. No binding (`homie-studio dev` without --remote-ai), no budget left, or an error: the
    * floor alone has decided (`by` says which), and the message goes out.
    */
   async reviewChat(text, { links = 'block' } = {}) {
-    if (!this.env.AI) return { ok: true, by: 'none' };
+    // Under `homie-studio dev` with no binding, the person's own Ollama reviews (free, so no budget).
+    if (!this.env.AI) {
+      if (!localAiOf(this.env)) return { ok: true, by: 'none' };
+      try { const v = await reviewChat(this.env, text, { links }); return { ok: v.ok, by: 'local', why: v.why, ms: v.ms, p: v.p }; } catch { return { ok: true, by: 'error' }; }
+    }
     if (this.chatCap === null || Date.now() - this.chatReadAt > 60_000) await this.readChatDay().catch(() => {});
     if (this.chatUsed >= (this.chatCap ?? 0)) return { ok: true, by: 'budget' };
     try {

package/worker/office.mjs

@@ -56,9 +56,9 @@
  */
 import { SEAT_MAX, seatsOf } from './seats.mjs';
 import { PUBLIC_SERVER, SERVER_LIMITS, checkServer, levelName, narrows, policyOf, roomServer, rowFor, serverView, serversOf, serverPassCookie, writeServer } from './servers.mjs';
-import { BRAIN_BUDGET, aiName, fillSpot, passById, passCreate, passList, passRevoke } from './agents.mjs';
-import { DEFAULT_MODEL, OWNER_MODEL } from './brain.mjs';
-import { OWNER_COOKIE, cookieValues, ownerAllowed, ownerSession, today } from './stats.mjs';
+import { BRAIN_BUDGET, aiName, brainFor, fillSpot, passById, passCreate, passList, passRevoke, think } from './agents.mjs';
+import { DEFAULT_MODEL, NEURONS_PER_M, OWNER_MODEL, vocabularyOf } from './brain.mjs';
+import { OWNER_COOKIE, cookieValues, counter, ownerAllowed, ownerSession, today } from './stats.mjs';
 import { esc, layout, notFoundPage } from './site.mjs';
 import { confirmPage, lockedPage, officePage } from './office-page.mjs';
 import { licenseOf } from './license.mjs';
@@ -473,6 +473,8 @@ async function roomRow(env, meta, room, max) {
     clients, bans: office.bans ?? [], mutes: office.mutes ?? [],
     // Room chat (0.23.0): the room's last minutes, with who sent each line (a client id and account; never an address).
     chat: office.chat ? { mode: office.chat.rules?.mode ?? null, pending: office.chat.pending ?? 0, lines: (office.chat.lines ?? []).slice(-50).map((l) => ({ id: l.id, at: l.at, t: l.t, kind: l.kind, name: oneLine(l.name, 40), seat: l.seat ?? null, by: l.by, text: l.text ?? null, glyph: l.glyph ?? null, react: l.react ?? null, say: l.say ?? null, acct: Boolean(l.acct), owner: Boolean(l.owner), client: l.client ?? null, player: l.player ?? null, browser: l.browser ?? null, ...(l.review ? { review: l.review } : {}) })) } : null,
+    // A game's own decisions (0.24.4, net.decide): how many, who answered, the model's median time, the neurons.
+    ...(office.decides && typeof office.decides === 'object' ? { decides: { n: Number(office.decides.n) || 0, by: office.decides.by ?? {}, msP50: office.decides.msP50 ?? null, neurons: Number(office.decides.neurons) || 0 } } : {}),
     // The house guides' brains (0.17.0): which brain, why not when it is not, and the last decisions (seats and ids).
     ...(f.brains && typeof f.brains === 'object' ? { brains: {
       brain: String(f.brains.brain ?? ''), why: f.brains.why ? oneLine(f.brains.why, 120) : null, calls: Number(f.brains.calls) || 0,
@@ -482,6 +484,62 @@ async function roomRow(env, meta, room, max) {
   };
 }
 
+/**
+ * `agents try` (0.24.4): a guide's brain on one moment the owner gives, with no seat taken and nobody in a room: the
+ * game's own vocabulary, the view, the asks and the party's lines in; the decision out, with the brain's own pick
+ * before the fixed rules, Clef's probabilities, the model's time and the neurons. It runs exactly what a house guide
+ * runs (agents.mjs think) and spends from the same day's budget, so a creator can test an agents.json, and compare a
+ * model (`model`: one of the models this toolkit prices) before setting it.
+ */
+export async function agentsTry(env, cat, body) {
+  const bad = (message) => ({ ok: false, error: 'bad-request', message });
+  const meta = (cat.games ?? []).find((g) => g.id === body.game);
+  if (!meta) return bad('game is one of this studio\'s game ids');
+  const mode = body.mode ?? 'workers-ai';
+  if (!['workers-ai', 'owner-key', 'script'].includes(mode)) return bad('mode is workers-ai, owner-key or script');
+  if (body.model !== undefined && !(typeof body.model === 'string' && NEURONS_PER_M[body.model])) return bad(`model is one of ${Object.keys(NEURONS_PER_M).join(', ')}`);
+  const view = body.view && typeof body.view === 'object' && !Array.isArray(body.view) ? body.view : null;
+  if (!view || JSON.stringify(view).length > 2048) return bad('view is the game state a guide sees (an object, under 2 KB)');
+  const int = (v) => Number.isInteger(v) && v >= 0 && v < 64;
+  const asks = (Array.isArray(body.asks) ? body.asks : []).slice(0, 3).filter((a) => a && typeof a.k === 'string' && int(a.from)).map((a, i) => ({ k: a.k, args: a.args && typeof a.args === 'object' ? a.args : {}, from: a.from, at: Date.now() - i }));
+  const party = (Array.isArray(body.party) ? body.party : []).slice(-3).filter((p) => p && int(p.seat) && typeof p.line === 'string').map((p) => ({ seat: p.seat, line: p.line, args: p.args ?? {} }));
+  const seats = (list) => (Array.isArray(list) ? list.filter(int).slice(0, 32) : []);
+  let vocab = null;
+  try {
+    const res = env.ASSETS ? await env.ASSETS.fetch(new Request(`https://assets.local/games/${meta.id}/agents.json`)) : null;
+    if (res?.ok) vocab = vocabularyOf(await res.json()).vocab;
+  } catch { vocab = null; }
+  if (!vocab) return { ok: false, error: 'no-vocabulary', message: `${meta.name} has no agents.json in this build: its guides have nothing to choose from.` };
+  const day = await brainDay(env);
+  const budget = { left: (k) => (k === 'neurons' ? day.budget.neurons - day.used.neurons : day.budget.usd * 1e6 - day.used.usd * 1e6) };
+  const e = body.model ? { ...env, HOMIE_BRAIN_MODEL: body.model } : env;
+  const brain = brainFor(mode, e, { budget });
+  const ctx = {
+    view, me: { seat: int(body.seat) ? body.seat : 7 }, goal: view.goal ?? null, asks, party, speech: ['game', 'lines', 'off'].includes(body.speech) ? body.speech : 'lines',
+    kids: body.kids === true, quiet: body.quiet === true, players: seats(body.players ?? (Array.isArray(view.party) ? view.party.map((p) => p?.seat) : [])), avoid: seats(body.avoid),
+    // What a house guide remembers: who is new to it, and its own last lines (ids, arguments, how long ago).
+    newHere: seats(body.newHere),
+    said: (Array.isArray(body.said) ? body.said : []).slice(-4).filter((x) => x && typeof x.line === 'string' && vocab.lines[x.line]).map((x) => ({ line: x.line, args: x.args && typeof x.args === 'object' ? x.args : {}, ago: Math.max(0, Number(x.agoMs) || 0) })),
+  };
+  const t = await think(vocab, { mode, brain, ctx });
+  if (t.engine && env.DB) {
+    const rows = [counter(env, { metric: 'brain-calls', subject: meta.id, source: 'try' })];
+    const n = Math.round(t.cost.neurons);
+    if (n > 0) rows.push(counter(env, { metric: 'brain-neurons', subject: meta.id, n }));
+    if (t.cost.micros >= 1) rows.push(counter(env, { metric: 'brain-microdollars', subject: meta.id, n: Math.round(t.cost.micros) }));
+    await env.DB.batch(rows.filter(Boolean)).catch(() => {});
+  }
+  return {
+    ok: true, game: meta.id, mode, model: t.model ?? (mode === 'workers-ai' ? e.HOMIE_BRAIN_MODEL || DEFAULT_MODEL : null), engine: t.engine, provider: t.provider,
+    decision: t.decision, own: t.own, overruled: /\+floor$/.test(t.provider), why: t.why, p: t.p, ms: t.ms,
+    // A decision model's whole answer: every option's probability, per question (ids and numbers only).
+    ...(t.answers ? { answers: Object.fromEntries(Object.entries(t.answers).map(([k, a]) => [k, a?.probabilities ? Object.fromEntries(Object.entries(a.probabilities).map(([o, v]) => [o, Math.round(Number(v) * 100) / 100])) : a?.noul ?? a?.score ?? null])) } : {}),
+    ...(t.usage ? { tokens: { input: Number(t.usage.input_tokens ?? t.usage.prompt_tokens) || null, output: Number(t.usage.output_tokens ?? t.usage.completion_tokens) || 0 } } : {}),
+    neurons: Math.round(t.cost.neurons * 1000) / 1000, micros: Math.round(t.cost.micros),
+    budget: { neurons: day.budget.neurons, usedBefore: Math.round(day.used.neurons) },
+  };
+}
+
 /** The AI brains' day for the whole studio: the budget (meta brain_budget) and what today used (stats_daily). */
 export async function brainDay(env) {
   const budget = { neurons: BRAIN_BUDGET.neurons, usd: BRAIN_BUDGET.usd };
@@ -1163,6 +1221,8 @@ async function api(request, env, url, cat) {
       return json({ ok: true, game, server, members });
     } catch (error) { return json({ ok: false, error: 'not-migrated', message: `Servers need migration 0006_studio_servers.sql (npm run deploy). (${String(error?.message ?? error).slice(0, 120)})` }, 503); }
   }
+  // A guide's brain on a moment the owner gives (0.24.4): what it would decide, why, how sure, how long and what it cost.
+  if (path === '/_studio/api/agents/try' && request.method === 'POST') return json(await agentsTry(env, cat, body));
   // Room chat (0.23.0): every game's rules, every live room's last minutes, the reports, the review's day.
   if (path === '/_studio/api/chat' && request.method === 'GET') {
     const metas = (cat.games ?? []).filter((g) => !url.searchParams.get('game') || g.id === url.searchParams.get('game'));