@homie-rocks/studio 0.16.1 → 0.17.0

package/worker/office.mjs

@@ -45,8 +45,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 { aiName, fillSpot, passById, passCreate, passList, passRevoke } from './agents.mjs';
-import { OWNER_COOKIE, cookieValues, ownerAllowed, ownerSession } from './stats.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 { esc, layout, notFoundPage } from './site.mjs';
 import { confirmPage, lockedPage, officePage } from './office-page.mjs';
 import { licenseOf } from './license.mjs';
@@ -455,9 +456,35 @@ async function roomRow(env, meta, room, max) {
     host: f.host ?? null, announce: f.announce ?? null,
     slots: slots.slice(0, 64).map((s) => ({ slot: s.slot, seat: s.seat ?? null, name: oneLine(s.name, 40), bot: Boolean(s.bot), ...(s.agent ? { agent: { role: s.agent.role ?? 'party', seat: s.agent.seat ?? null } } : {}) })),
     clients, bans: office.bans ?? [], mutes: office.mutes ?? [],
+    // 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,
+      guides: (Array.isArray(f.brains.guides) ? f.brains.guides : []).slice(0, 8).map((g) => ({ name: oneLine(g.name, 40), seat: g.seat ?? null, provider: g.provider ?? null })),
+      decisions: (Array.isArray(f.brains.decisions) ? f.brains.decisions : []).slice(-50),
+    } } : {}),
   };
 }
 
+/** 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 };
+  const used = { neurons: 0, usd: 0, calls: 0 };
+  try {
+    const b = JSON.parse((await env.DB.prepare("SELECT value FROM meta WHERE key = 'brain_budget'").first())?.value ?? 'null');
+    if (b && Number.isFinite(Number(b.neurons))) budget.neurons = Number(b.neurons);
+    if (b && Number.isFinite(Number(b.usd))) budget.usd = Number(b.usd);
+  } catch { /* the defaults */ }
+  try {
+    const { results } = await env.DB.prepare("SELECT metric, SUM(n) AS n FROM stats_daily WHERE day = ?1 AND metric IN ('brain-calls', 'brain-neurons', 'brain-microdollars') GROUP BY metric").bind(today()).all();
+    for (const r of results ?? []) {
+      if (r.metric === 'brain-calls') used.calls = Number(r.n) || 0;
+      if (r.metric === 'brain-neurons') used.neurons = Number(r.n) || 0;
+      if (r.metric === 'brain-microdollars') used.usd = Math.round(Number(r.n) || 0) / 1e6;
+    }
+  } catch { /* nothing counted yet */ }
+  return { budget, used, ai: Boolean(env.AI), key: Boolean(env.HOMIE_BRAIN_KEY), model: env.HOMIE_BRAIN_MODEL || DEFAULT_MODEL, ownerModel: OWNER_MODEL };
+}
+
 async function invitesOf(env, game, origin) {
   try {
     const { results } = await env.DB.prepare('SELECT id, code, label, uses, max_uses, expires_at, revoked, created_at, server FROM office_invites WHERE game = ?1 ORDER BY created_at DESC LIMIT 100').bind(game).all();
@@ -500,7 +527,9 @@ export async function officeView(env, cat, origin) {
       id: g.id, name: g.name, launch, launchFrom: row?.launch ? 'office' : g.launch ? 'game.json' : 'default',
       // Servers (0.16.0): each with its policy and what is on it now; its build reads the dial only from netplay rev 6.
       servers: servers.map((sv) => ({ ...serverView(sv, { origin, game: g.id }), live: byServer[sv.id] ?? { rooms: 0, players: 0, ai: 0 }, members: members[sv.id] ?? 0 })),
-      build: { netplayRev: Number.isInteger(g.netplayRev) ? g.netplayRev : null, predates: !(Number(g.netplayRev) >= 6), caps: g.caps ?? null },
+      build: { netplayRev: Number.isInteger(g.netplayRev) ? g.netplayRev : null, predates: !(Number(g.netplayRev) >= 6), caps: g.caps ?? null, guides: Number(g.netplayRev) >= 7 },
+      // 0.17.0: the game's AI guides have words of their own (agents.json): without it they play but never talk.
+      vocab: g.vocab === true,
       passes: (await passList(env, { game: g.id })).filter((x) => x.live || Date.now() - x.createdAt < 7 * 86_400_000),
       remix: remixOf(g, settings), remixBuilt: g.landing?.source !== false, license: licenseOf(g.license).kind,
       seats: seatsOf(g), maxPlayers: max, maxSet: Number(row?.max_players) >= 1 ? Number(row.max_players) : null,
@@ -515,6 +544,7 @@ export async function officeView(env, cat, origin) {
     // The fill-a-spot service (an AI seated in an empty spot for a price) is a money decision: not offered yet.
     fillSpot: { available: Boolean(fillSpot()), note: 'Let a fill-a-spot service seat AI (coming later)' },
     agentsTalk: await talkConsented(env),
+    brain: await brainDay(env),
   };
 }
 async function memberCountsOf(env, game) {
@@ -624,7 +654,10 @@ function checkAction(cat, op, body) {
       if (!meta) return bad('game is one of this studio\'s game ids');
       if (typeof body.server !== 'string' || !(body.server === 'public' || /^[a-z0-9][a-z0-9-]{1,19}$/.test(body.server))) return bad('server is the server\'s id');
       if (!['off', 'script', 'workers-ai', 'owner-key'].includes(body.mode)) return bad('mode is off, script, workers-ai or owner-key');
-      return { ok: true, action: { op, game: meta.id, server: body.server, mode: body.mode } };
+      // The day's budget for the studio's brains: Workers AI neurons (workers-ai) or dollars of the owner's key (owner-key).
+      const budget = body.budget === undefined || body.budget === null ? undefined : Number(body.budget);
+      if (budget !== undefined && (!['workers-ai', 'owner-key'].includes(body.mode) || !(budget >= 0) || budget > (body.mode === 'owner-key' ? 100 : 1e7))) return bad('budget goes with workers-ai (neurons a day; the free allocation is 10,000 an account) or owner-key (dollars a day, at most 100)');
+      return { ok: true, action: { op, game: meta.id, server: body.server, mode: body.mode, ...(budget !== undefined ? { budget } : {}) } };
     }
     default:
       return bad('unknown control');
@@ -670,7 +703,7 @@ export function describe(cat, a) {
     case 'pass': return a.action === 'revoke' ? `Revoke the agent pass ${a.id}: that AI leaves every room and cannot sit again.` : `Issue an agent pass for an AI called "${a.label} · AI".`;
     case 'room-level': return `Set the AI in ${where} to ${levelName(a.level)} (level ${a.level}).`;
     case 'agents-brain': return ['workers-ai', 'owner-key'].includes(a.mode)
-      ? `Let the AI guides on ${gname}'s server ${a.server} talk: they speak only the lines the game's own agents.json gives them (never free text), at most one line every 8 seconds, never about a person, and a player can quiet them. Their brain runs on ${a.mode === 'workers-ai' ? 'this studio\'s own Workers AI (free allowance)' : 'your own AI provider key (your money, capped daily)'}.`
+      ? `Let the AI guides on ${gname}'s server ${a.server} talk: they speak only the lines the game's own agents.json gives them (never free text), at most one line every 8 seconds, never about a person, and a player can quiet them. Their brain runs on ${a.mode === 'workers-ai' ? `this studio's own Workers AI (free allowance${a.budget !== undefined ? `; at most ${Math.round(a.budget).toLocaleString('en-US')} neurons a day` : ''})` : `your own AI provider key (claude-haiku-4-5, your money${a.budget !== undefined ? `, at most $${Number(a.budget).toFixed(2)} a day` : ', capped daily'})`}.`
       : `Set the AI guides' brain on ${gname}'s server ${a.server} to ${a.mode}.`;
     default: return 'A control.';
   }
@@ -686,7 +719,12 @@ export async function needsAsk(env, cat, a) {
     const before = meta ? (await serversOf(env, meta, { fresh: true })).find((x) => x.id === a.server) : null;
     return narrows(before, a.fields);
   }
-  if (a.op === 'agents-brain') return ['workers-ai', 'owner-key'].includes(a.mode) && !(await talkConsented(env));
+  if (a.op === 'agents-brain') {
+    if (['workers-ai', 'owner-key'].includes(a.mode) && !(await talkConsented(env))) return true;
+    // Raising the cap on the owner's own money is the owner's to confirm; Workers AI's free allocation is not money.
+    if (a.mode === 'owner-key' && a.budget !== undefined) return a.budget > (await brainDay(env)).budget.usd;
+    return false;
+  }
   return false;
 }
 
@@ -765,7 +803,7 @@ export async function perform(env, cat, a) {
       try { await writeServer(env, meta.id, sv); } catch (error) { return { ok: false, error: 'not-migrated', message: `Servers need migration 0006_studio_servers.sql (npm run deploy). (${String(error?.message ?? error).slice(0, 120)})` }; }
       const view = serverView(sv, { origin: a.origin ?? '', game: meta.id });
       const notes = [];
-      if (sv.policy === 'beginner' && sv.guides) notes.push(`${sv.guides} AI guide seat${sv.guides === 1 ? '' : 's'} in every room, marked AI: the game's own bots play them now; guides talk once AI talk arrives (a later version, and only with the owner's yes).`);
+      if (sv.policy === 'beginner' && sv.guides) notes.push(`${sv.guides} AI guide seat${sv.guides === 1 ? '' : 's'} in every room, marked AI: they play from the game's script, silent. To let them talk (only the game's own agents.json lines), turn on a brain: agents brain ${meta.id} ${sv.id} workers-ai (the first time asks the owner).${meta.vocab ? '' : ` ${meta.name} has no agents.json yet: write one first.`}`);
       if (sv.policy === 'hybrid') notes.push(`${sv.aiSeats} seat${sv.aiSeats === 1 ? '' : 's'} in every room are AI companions, marked AI; the party votes their level.`);
       if (sv.policy === 'humans-only') notes.push('No AI can join; the game\'s practice bots are off unless the owner turns them on (bots: fill).');
       if (!(Number(meta.netplayRev) >= 6)) notes.push(`${meta.name}'s build predates servers (netplay revision ${meta.netplayRev ?? '5 or older'}): reserved AI seats stay empty and its bots do not read the dial until it is rebuilt with @homie-rocks/studio 0.16.`);
@@ -839,8 +877,24 @@ export async function perform(env, cat, a) {
         await writeServer(env, meta.id, sv);
         if (['workers-ai', 'owner-key'].includes(a.mode)) await env.DB.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES ('agents_talk_ok', ?1)").bind(String(Date.now())).run();
       } catch (error) { return { ok: false, error: 'not-migrated', message: `Servers need migration 0006_studio_servers.sql (npm run deploy). (${String(error?.message ?? error).slice(0, 120)})` }; }
+      if (a.budget !== undefined) {
+        const day = await brainDay(env);
+        const next = { neurons: day.budget.neurons, usd: day.budget.usd, ...(a.mode === 'workers-ai' ? { neurons: Math.round(a.budget) } : { usd: Math.round(a.budget * 100) / 100 }) };
+        await env.DB.prepare("INSERT OR REPLACE INTO meta (key, value) VALUES ('brain_budget', ?1)").bind(JSON.stringify(next)).run().catch(() => {});
+      }
       await pushPolicy(env, meta, settings, sv);
-      return { ok: true, op: a.op, game: meta.id, server: sv.id, brain: sv.brain, note: ['workers-ai', 'owner-key'].includes(a.mode) ? 'Saved. AI guides\' talk arrives with @homie-rocks/studio 0.17; until then they play as the game\'s bots, silent.' : 'Saved.' };
+      const day = await brainDay(env);
+      const notes = [];
+      if (!meta.vocab && ['workers-ai', 'owner-key'].includes(a.mode)) notes.push(`${meta.name} has no agents.json yet: its guides play but have no words. Write one (the game skill's "Write the guide vocabulary"), build and deploy.`);
+      if (a.mode === 'workers-ai') notes.push(!env.AI ? 'This Worker has no Workers AI binding yet: run `npm run deploy` once more (it binds Workers AI when a server uses it). Until then the guides answer from the game\'s script.'
+        : !(day.budget.neurons > 0) ? 'The day\'s Workers AI budget is 0: the guides answer from the game\'s script (set --budget to let them think).'
+          : `The guides think with Workers AI (${day.model}) from their next decision: at most ${day.budget.neurons.toLocaleString('en-US')} neurons a day for the whole studio (${Math.round(day.used.neurons).toLocaleString('en-US')} used today), then the game's script until 00:00 UTC.`);
+      if (a.mode === 'owner-key') notes.push(!env.HOMIE_BRAIN_KEY ? 'Set your key on your own computer: `npx --no-install homie-studio agents brain key` opens a page there (the key goes straight to the Worker, never through a chat). Until then the guides answer from the game\'s script.'
+        : !(day.budget.usd > 0) ? 'The day\'s dollar cap is 0: the guides answer from the game\'s script.'
+          : `The guides think with your key (claude-haiku-4-5) from their next decision, at most $${day.budget.usd.toFixed(2)} a day ($${day.used.usd.toFixed(2)} used today), then the game's script until 00:00 UTC.`);
+      if (a.mode === 'script') notes.push('The guides play from the game\'s script, silent.');
+      if (a.mode === 'off') notes.push('The guides are the game\'s plain bots.');
+      return { ok: true, op: a.op, game: meta.id, server: sv.id, brain: sv.brain, budget: day.budget, note: `Saved. ${notes.join(' ')}`.trim() };
     }
     default: return { ok: false, error: 'op' };
   }

package/worker/room.mjs

@@ -28,13 +28,20 @@
  * reserves for AI, names every agent "<label> · AI", rewrites the host's roster
  * and results so they cannot hide an AI, filters speech, runs the party's vote on
  * the skill dial, and closes agents that are left alone with no person seated.
+ *
+ * AGENT HANDS AND BRAINS (revision 7, NETPLAY.md section 18): an AI with no game client of its own (hands `host`)
+ * sees the game through `agent:view` (the host's, to its seat, at most one every 2 s, under 2 KB) and moves through
+ * `agent:do` (a goal of the game's agents.json, at most one every 3 s). It says only `say:<lineId>` lines of that
+ * vocabulary, with arguments that fit, and only on a server whose AI may talk: the relay drops everything else an AI
+ * says (`stats.agentDrops`). The Table's own house agents (worker/agents.mjs) are peers like any other, on a loopback.
  * =============================================================================
  */
 import { aiName, skillPreset, stripAi } from './agents.mjs';
+import { checkArgs, talks, vocabularyOf } from './brain.mjs';
 
 export const NET_VERSION = 1;
 /** The contract revision this relay speaks (NETPLAY.md): optional fields, frames and refusals; the wire stays `v: 1`. */
-export const NET_REVISION = 6;
+export const NET_REVISION = 7;
 const POLICY_KINDS = ['open', 'humans-only', 'hybrid', 'beginner'];
 /**
  * A room's policy before the Worker says anything (and the public server's with nothing set): today's behaviour.
@@ -48,6 +55,11 @@ export const VOTE = Object.freeze({ ms: 15_000, cooldownMs: 120_000, autoMs: 30
 /** Agents left with no person seated for this long are closed (`agents-alone`): an AI never keeps a room alive. */
 export const AGENTS_ALONE_MS = 60_000;
 const CAPS = ['skill', 'agents'];
+/** Revision 7: what a game's host shows an AI (`agent:view`) and how often an AI may act (`agent:do`). */
+export const AGENT_FRAMES = Object.freeze({ viewMs: 2000, viewBytes: 2048, doMs: 3000 });
+const SAY = /^say:([a-z][a-z0-9_]{0,31})$/;
+const d0 = (m) => (m.d && typeof m.d === 'object' && !Array.isArray(m.d) ? m.d : {});
+const ASK = /^ask:([a-z][a-z0-9_]{0,31})$/;
 
 /** A policy as the relay keeps it: every field checked (the Worker composed it, but a bad one must not break a room). */
 export function normalizePolicy(p) {
@@ -209,6 +221,8 @@ export class NetRoom {
     this.lastHumanAt = 0;
     /** A policy that no longer lets AI in, waiting for the round to finish: when the agents leave. */
     this.agentsOut = null;
+    /** Revision 7: the game's agents.json (the Table reads it once), the only words an AI here may say. */
+    this.vocab = null;
     this.code = code;
     this.seatCap = maxPlayers;
     this.maxPlayers = maxPlayers;
@@ -277,6 +291,8 @@ export class NetRoom {
       watch: conn.watch === true, policy: WATCH_POLICIES.includes(conn.watchPolicy) ? conn.watchPolicy : 'follow', follow: null, followWhy: null,
       // An agent (section 17): only the Worker's word, from a verified pass, makes one; its hello cannot.
       agentWord: conn.agent && typeof conn.agent === 'object' ? conn.agent : null, agent: null, caps: new Set(), speechAt: [],
+      // Revision 7: the latest view the host showed this AI (what its arguments are checked against), and its pace.
+      lastView: null, viewAt: 0, doAt: 0,
     };
     this.clients.set(c.id, c);
     return {
@@ -432,22 +448,35 @@ export class NetRoom {
         // The server's speech (section 17): `lines` drops every free-text chat (quick lines and emotes pass), `off`
         // drops all speech, whoever sends it (a host relaying a player's chat too).
         if (SPEECH.test(kind) && (this.policy.speech === 'off' || (this.policy.speech === 'lines' && /^chat/i.test(kind)))) { this.stats.speechDrops += 1; return; }
+        // What an AI may send (section 18): its own goals and its game's lines, checked here whatever its host says.
+        if (c.agent && !this.agentEvOk(c, kind, m, text.length, now)) { this.stats.agentDrops += 1; return; }
         // An agent says at most one line every 4 s and 8 a minute.
         if (c.agent && SPEECH.test(kind)) {
           while (c.speechAt.length && c.speechAt[0] <= now - 60_000) c.speechAt.shift();
           if (c.speechAt.length >= AGENT_SPEECH.perMinute || (c.speechAt.length && now - c.speechAt[c.speechAt.length - 1] < AGENT_SPEECH.gapMs)) { this.stats.agentDrops += 1; return; }
           c.speechAt.push(now);
         }
+        // A line the host relays for an AI (`d.ai`): still only a line of the vocabulary, with fitting arguments.
+        if (isHost && d0(m).ai === true && !this.aiLineOk(kind, d0(m))) { this.stats.agentDrops += 1; return; }
+        // The host shows one AI the game (`agent:view`): to that AI's seat only, small, at most one every 2 s.
+        if (kind === 'agent:view') {
+          const o = isHost && Number.isInteger(m.to) ? this.live().find((x) => x.seat === m.to && x.agent) : null;
+          if (!o || text.length > AGENT_FRAMES.viewBytes || now - o.viewAt < AGENT_FRAMES.viewMs - 250) { this.stats.agentDrops += 1; return; }
+          o.viewAt = now;
+          o.lastView = m.d && typeof m.d === 'object' && !Array.isArray(m.d) ? m.d : null;
+        }
         this.stats.evs += 1;
         const out = { t: 'ev', from: c.seat, k: kind, d: m.d ?? null };
         if (isHost) {
           if (typeof m.to === 'string') { const o = this.clients.get(m.to); if (o && o.helloed && o !== c) this.send(o, out); }
           else if (Number.isInteger(m.to)) { for (const o of this.others(c)) if (o.seat === m.to) this.send(o, out); }
-          // An agent with no game client hears only what is addressed to its seat (the lite feed).
-          else for (const o of this.others(c)) { if (!this.lite(o)) this.send(o, out); }
+          // An agent with no game client hears only what is addressed to its seat (the lite feed), and the party's lines.
+          else for (const o of this.others(c)) { if (!this.lite(o) || this.liteHears(kind)) this.send(o, out); }
         } else {
           const h = this.host();
           if (h) this.send(h, { ...out, id: c.id });
+          // The lite feed (section 18): an AI with no game client hears the party's lines, and an ask made of it.
+          if (!c.agent) this.copyToLite(c, kind, out);
         }
         return;
       }
@@ -607,8 +636,18 @@ export class NetRoom {
     this.reapSeats(now);
     let full = false;
     if (c.want === 'play' && !this.seatClient(c, typeof m.token === 'string' ? m.token : '')) {
-      if (c.agent) return refuse('agents-off', 'no AI seat is free in this room');
-      full = true; c.waiting = true;
+      // The studio's own house guide (a loopback) makes way for an AI with a pass (the owner's Claude, say).
+      const house = c.agent && !c.conn.loopback ? this.live().find((o) => o.agent && o.conn.loopback && o.seat !== null) : null;
+      if (house) {
+        const seat = house.seat;
+        this.error(house, 'agent-yield', 'an AI with a pass took this seat');
+        this.kick(house, 'agent-yield', 4002);
+        if (this.seats.get(seat)?.token === house.token) { this.seats.delete(seat); this.seatsDirty = true; }
+      }
+      if (!house || !this.seatClient(c, '')) {
+        if (c.agent) return refuse('agents-off', 'no AI seat is free in this room');
+        full = true; c.waiting = true;
+      }
     }
     if (c.seat === null) c.name = c.typed || (c.want === 'screen' && !c.watch ? 'Screen' : 'Watcher');
     if (c.seat !== null && !c.agent) this.lastHumanAt = now;
@@ -760,6 +799,73 @@ export class NetRoom {
     }
   }
 
+  /* ------------------------------------------------------------ agent hands and brains (section 18) */
+
+  /** The game's agents.json (the Table reads it once from the build): the only goals and lines an AI here has. */
+  setVocabulary(raw) {
+    this.vocab = raw ? vocabularyOf(raw).vocab : null;
+    return Boolean(this.vocab);
+  }
+
+  /** The seats people hold now (a "player" argument names one of them). */
+  peopleSeats() { return this.seatedHumans().map((c) => c.seat); }
+
+  /**
+   * Whether this AI may send this event: `agent:do` (a goal of the vocabulary, arguments that fit the view the host
+   * last showed it, at most one every 3 s), `say:<lineId>` (a line of the vocabulary, on a server whose AI may talk),
+   * never `agent:view`, `chat:` or `emote:` (an AI never types), and nothing else from an AI with no game client.
+   */
+  agentEvOk(c, kind, m, bytes, now) {
+    if (kind === 'agent:view') return false;
+    const ctx = { view: c.lastView, players: this.peopleSeats() };
+    const d = m.d && typeof m.d === 'object' && !Array.isArray(m.d) ? m.d : {};
+    if (kind === 'agent:do') {
+      if (c.id === this.hostId || !this.vocab || bytes > 1024 || now - c.doAt < AGENT_FRAMES.doMs) return false;
+      const goal = this.vocab.goals[d.goal];
+      if (typeof d.goal !== 'string' || !goal || checkArgs(goal.args, d.args, ctx)) return false;
+      c.doAt = now;
+      return true;
+    }
+    if (SPEECH.test(kind)) {
+      const id = SAY.exec(kind)?.[1];
+      const line = id && this.vocab ? this.vocab.lines[id] : null;
+      return Boolean(line && talks(this.policy) && bytes <= 1024 && !checkArgs(line.args, d.args, ctx));
+    }
+    return !this.lite(c);
+  }
+
+  /**
+   * A line a host relays for an AI (`say:<lineId>`, `d.ai`): a line of the vocabulary on a server whose AI may talk,
+   * arguments that fit (a view argument: the speaking AI's latest view, or for a guide no AI holds, an id at most).
+   * A host cannot put words of its own in an AI's mouth on other screens.
+   */
+  aiLineOk(kind, d) {
+    const id = SAY.exec(kind)?.[1];
+    const line = id && this.vocab ? this.vocab.lines[id] : null;
+    if (!line || !talks(this.policy)) return false;
+    const speaker = Number.isInteger(d.seat) ? this.live().find((o) => o.seat === d.seat && o.agent) : null;
+    if (Number.isInteger(d.seat) && !speaker) return false;
+    const args = d.args && typeof d.args === 'object' ? d.args : {};
+    const view = speaker ? speaker.lastView : Object.fromEntries(Object.entries(line.args).filter(([, sp]) => sp.kind === 'view').map(([k, sp]) => [sp.key, /^[a-z0-9][a-z0-9_-]{0,39}$/.test(String(args[k] ?? '')) ? [args[k]] : []]));
+    return !checkArgs(line.args, args, { view, players: this.peopleSeats() });
+  }
+
+  /** What an AI with no game client hears of a host's broadcast: the party's lines (free chat only on a "game" server). */
+  liteHears(kind) { return /^(?:say|emote):/i.test(kind) || (/^chat/i.test(kind) && this.policy.speech === 'game'); }
+
+  /** A person's line, copied to every AI with no game client; a person's ask (`ask:<id>`, d.seat), to that AI alone. */
+  copyToLite(c, kind, out) {
+    const ask = ASK.exec(kind)?.[1];
+    if (ask) {
+      const seat = out.d && Number.isInteger(out.d.seat) ? out.d.seat : null;
+      if (seat === null || (this.vocab && !this.vocab.asks[ask])) return;
+      for (const o of this.live()) if (o !== c && this.lite(o) && o.seat === seat) this.send(o, out);
+      return;
+    }
+    if (!SPEECH.test(kind) || !this.liteHears(kind)) return;
+    for (const o of this.live()) if (o !== c && this.lite(o) && o.id !== this.hostId) this.send(o, out);
+  }
+
   /* ------------------------------------------------------------ watchers (section 16) */
 
   /**
@@ -871,7 +977,8 @@ export class NetRoom {
     // becomes a bot instead of a frozen body.
     for (const c of [...this.clients.values()]) {
       if (!c.helloed) { if (now - c.joinedAt > 5000) { this.clients.delete(c.id); try { c.conn.close(4000, 'no-hello'); } catch { /* gone */ } } continue; }
-      if (now - c.lastSeen > this.idleMs) this.kick(c, 'silent', 4000);
+      // A loopback (the Table's own house agent) cannot be half-open: it is never closed for silence.
+      if (now - c.lastSeen > this.idleMs && !c.conn.loopback) this.kick(c, 'silent', 4000);
     }
     // A host that stopped sending snapshots while others are present.
     const h = this.host();
@@ -1473,6 +1580,8 @@ export class NetRoom {
       policy: this.policyOut(),
       ...(this.vote ? { vote: this.voteView() } : {}),
       caps: [...this.caps],
+      // Revision 7: whether this room's game has a vocabulary its AI may speak (agents.json).
+      vocab: Boolean(this.vocab),
       memory: {
         snapBytes: this.lastSnapText ? this.lastSnapText.length : 0,
         ckptBytes: this.lastCkpt ? JSON.stringify(this.lastCkpt).length : 0,

package/worker/stats.mjs

@@ -16,7 +16,9 @@
  *   peak    the most people playing one game at once that day (all its rooms), and peak-room in one room
  *   song    a song's player started; video: a video's player started
  *   agent-minutes   minutes an AI sat in a seat (an agent pass, NETPLAY.md section 17; 0.16.0), counted as it leaves
- *   brain-calls, brain-neurons   reserved for AI guides' brains (a later version): calls made and Workers AI used
+ *   brain-calls     AI guides' brain calls (0.17.0), by provider (workers-ai, owner-key): the house guides' alarms
+ *   brain-neurons, brain-microdollars   what those calls used: Workers AI neurons, and the owner's own key in
+ *                   millionths of a dollar. The day's budget (meta `brain_budget`) is read against these, every game.
  * A round's rows count agents as AI, never as people: `humans` is people only.
  * Each visit, play and screen row carries WHERE FROM: '' (typed, bookmarked, or this site's own link), the
  * referring site's host (homie.rocks, another studio, anywhere on the web), or `via:<tag>` from a ?via= link.
@@ -57,7 +59,7 @@ CREATE TABLE IF NOT EXISTS stats_keys (
 ) WITHOUT ROWID;
 `;
 
-export const METRICS = Object.freeze(['visit', 'play', 'screen', 'watch', 'room', 'round', 'humans', 'peak', 'peak-room', 'song', 'video', 'agent-minutes', 'brain-calls', 'brain-neurons']);
+export const METRICS = Object.freeze(['visit', 'play', 'screen', 'watch', 'room', 'round', 'humans', 'peak', 'peak-room', 'song', 'video', 'agent-minutes', 'brain-calls', 'brain-neurons', 'brain-microdollars']);
 const MAX_METRICS = new Set(['peak', 'peak-room']);
 const SLUG = /^[a-z0-9][a-z0-9-]{0,39}$/;
 const DAY = /^\d{4}-\d{2}-\d{2}$/;

package/worker/version.mjs

@@ -1,2 +1,2 @@
 /** The @homie-rocks/studio version this Worker code is (package.json's; a test keeps them equal). Cache-busts /_homie/site.js. */
-export const STUDIO_VERSION_TAG = '0.16.1';
+export const STUDIO_VERSION_TAG = '0.17.0';