@homie-rocks/studio 0.27.0 → 0.29.0

package/mcp/ui/feedback.js

@@ -0,0 +1,112 @@
+/* The Tell Homie card: a note to the people who make Homie, exactly as it would go, with Send, Edit and Don't send.
+ * Nothing leaves this computer until the person presses Send here (or says yes in the chat). Edit drafts the note
+ * again from the person's own words, through the same redaction, so what the card shows is always what would go.
+ * The model is told what the person chose, once. Every text is set as text, never as HTML. */
+(function () {
+  var C = Card;
+  var KINDS = [['stuck', 'Stuck'], ['confusing', 'Confusing'], ['idea', 'Idea'], ['praise', 'Praise'], ['bug', 'Bug']];
+  var LABEL = { stuck: 'Stuck', confusing: 'Confusing', idea: 'Idea', praise: 'Praise', bug: 'Bug' };
+  var ui = { editing: false, busy: false, why: null, kind: null, text: null, email: null };
+
+  function fieldsOf(sc) {
+    var n = sc.note || {};
+    return { kind: n.kind, text: n.text, step: n.step || undefined, email: n.email || undefined, offered: n.offered === true,
+      studioVersion: n.studioVersion || undefined, pluginVersion: n.pluginVersion || undefined, app: n.app || undefined,
+      // The studio the draft was made for (its pinned version is in the note): a send is checked against the same one.
+      studio: sc.studio || undefined };
+  }
+
+  function act(sc, args, after) {
+    if (ui.busy) return;
+    ui.busy = true; ui.why = null; C.render();
+    C.call('homie_feedback', args).then(function (res) {
+      ui.busy = false;
+      // Refused (not sent, a reworded note that cannot go, the app said no): the note stays on screen with why.
+      var d = res && res.structuredContent;
+      if (!d || d.kind !== 'feedback' || res.isError) { ui.why = C.textOf(res) || 'That did not work. Nothing was sent.'; C.render(); return; }
+      if (after) after(res);
+      C.take(res);
+    }).catch(function () { ui.busy = false; ui.why = 'The app did not answer. Nothing was sent.'; C.render(); });
+  }
+
+  function quote(text) {
+    var q = C.el('blockquote', 'quote');
+    String(text || '').split('\n').forEach(function (line, i) { if (i) q.appendChild(C.el('br')); q.appendChild(document.createTextNode(line)); });
+    return q;
+  }
+
+  function editor(card, sc) {
+    var n = sc.note || {};
+    if (ui.kind === null) { ui.kind = n.kind || 'idea'; ui.text = n.text || ''; ui.email = n.email || ''; }
+    var kinds = C.el('div', 'kinds'); kinds.setAttribute('role', 'radiogroup'); kinds.setAttribute('aria-label', 'What kind of note');
+    KINDS.forEach(function (k) {
+      var b = C.btn(k[1], 'small ' + (ui.kind === k[0] ? '' : 'ghost'), function () { ui.kind = k[0]; C.render(); });
+      b.setAttribute('role', 'radio'); b.setAttribute('aria-checked', ui.kind === k[0] ? 'true' : 'false');
+      kinds.appendChild(b);
+    });
+    card.appendChild(kinds);
+    var area = C.el('textarea'); area.value = ui.text; area.rows = 5; area.maxLength = 1500; area.setAttribute('aria-label', 'Your note, in your words');
+    area.oninput = function () { ui.text = area.value; };
+    card.appendChild(area);
+    var mail = C.el('input'); mail.type = 'email'; mail.placeholder = 'Your email, if you want a reply (optional)'; mail.value = ui.email; mail.setAttribute('aria-label', 'Reply address (optional)');
+    mail.oninput = function () { ui.email = mail.value; };
+    card.appendChild(mail);
+    var acts = C.el('div', 'actions');
+    acts.appendChild(C.btn(ui.busy ? 'Saving…' : 'Use this', '', function () {
+      var f = fieldsOf(sc);
+      act(sc, { action: 'draft', kind: ui.kind, text: ui.text, step: f.step, email: (ui.email || '').trim() || undefined, offered: f.offered, studioVersion: f.studioVersion, pluginVersion: f.pluginVersion, app: f.app, studio: f.studio, by: 'card' }, function (res) {
+        ui.editing = false; ui.kind = null;
+        var d = res && res.structuredContent;
+        if (d && d.state === 'draft') C.tell('edit:' + d.draft, 'The person reworded the note on the Tell Homie card. Nothing is sent yet; the card shows the new text (draft ' + d.draft + ') with Send. Do not send it yourself unless they say yes.');
+      });
+    }));
+    acts.appendChild(C.btn('Cancel', 'ghost', function () { ui.editing = false; ui.kind = null; C.render(); }));
+    card.appendChild(acts);
+  }
+
+  function render(sc) {
+    var card = C.el('main', 'card');
+    var state = sc.state;
+    var head = state === 'sent' ? C.pill('Sent', 'ok') : state === 'declined' ? C.pill('Not sent', '') : state === 'draft' ? C.pill('Not sent yet', 'warn') : C.pill('Not sent', 'bad');
+    C.add(card, C.top('Note', head));
+    card.appendChild(C.el('h1', '', state === 'sent' ? 'Sent to Homie. Thank you.' : state === 'declined' ? 'Not sent' : 'A note to the people who make Homie'));
+    var n = sc.note;
+    if (state === 'draft' && ui.editing) { editor(card, sc); }
+    else if (n) {
+      card.appendChild(C.el('p', 'sub', state === 'sent' ? 'This is what they got:' : state === 'declined' ? 'Nothing left this computer. This was the note:' : 'This is exactly what would go:'));
+      card.appendChild(C.add(C.el('div', 'chips'), C.pill(LABEL[n.kind] || n.kind, 'live')));
+      card.appendChild(quote(n.text));
+      if (sc.with) card.appendChild(C.el('p', 'fine', 'With it: ' + sc.with));
+      if (sc.taken && sc.taken.length) card.appendChild(C.el('p', 'fine', 'Homie took out ' + sc.taken.join(', ') + ' before showing it here.'));
+    }
+    if (ui.why) card.appendChild(C.el('p', 'note bad', ui.why));
+    if (state === 'draft' && !ui.editing) {
+      var acts = C.el('div', 'actions send');
+      var send = C.btn(ui.busy ? 'Sending…' : 'Send', '', function () {
+        act(sc, Object.assign({ action: 'send', draft: sc.draft, by: 'card' }, fieldsOf(sc)), function (res) {
+          var d = res && res.structuredContent;
+          if (d && d.state === 'sent') C.tell('sent:' + sc.draft, 'The person pressed Send on the Tell Homie card: the note went to Homie (reference ' + String(d.reference || '').slice(0, 8) + '). Thank them in one line, and do not offer another note in this session.');
+        });
+      });
+      send.disabled = ui.busy;
+      acts.appendChild(send);
+      var edit = C.btn('Edit', 'ghost', function () { ui.editing = true; ui.kind = null; C.render(); }); edit.disabled = ui.busy;
+      acts.appendChild(edit);
+      var no = C.btn('Don’t send', 'ghost', function () {
+        act(sc, { action: 'decline', draft: sc.draft, by: 'card' }, function () {
+          C.tell('declined:' + sc.draft, 'The person pressed Don’t send on the Tell Homie card. Nothing was sent. Do not offer to send a note again in this session.');
+        });
+      });
+      no.disabled = ui.busy;
+      acts.appendChild(no);
+      card.appendChild(acts);
+    }
+    if (state === 'sent' && sc.reference) card.appendChild(C.el('p', 'fine', 'Reference ' + String(sc.reference).slice(0, 8) + '. Notes are private: only the people who make Homie read them.'));
+    var foot = C.el('div', 'foot');
+    foot.appendChild(C.el('span', 'when', state === 'sent' ? 'Sent to ' + (sc.to || 'homie.rocks') : state === 'declined' ? 'Nothing was sent.' : 'Nothing is sent until you press Send. Goes to ' + (sc.to || 'homie.rocks') + ', privately.'));
+    card.appendChild(foot);
+    return card;
+  }
+
+  C.start({ kind: 'feedback', label: 'Note', render: render, poll: null });
+})();

package/mcp/ui/setup.js

@@ -60,6 +60,8 @@
     acts.appendChild(C.btn('Check again', 'ghost small', function () {
       C.call('setup_status', { fresh: true }).then(function (r) { C.take(r); }).catch(function () {});
     }));
+    // Homie's own updates by email: the person signs up on homie.rocks (double opt-in); the card asks for nothing.
+    if (sc.updates) acts.appendChild(C.btn('Get Homie updates', 'ghost small', function () { C.open(sc.updates); }));
     foot.appendChild(acts);
     card.appendChild(foot);
     if (install && install.state === 'done') C.tell('install-' + install.job, (cur ? cur.name : 'The studio') + '\'s toolkit finished installing; the studio is ready to build.');

package/netplay/NETPLAY.md

@@ -1230,6 +1230,7 @@ every watching shell. homie.rocks runs nothing: its room page opens the room's o
 | `swears` | `block`, `allow` (`block`) | Slurs, sexual words, threats and contact details are held whatever this says. |
 | `ai` | `true`, `false` (`true`) | The studio's review of typed text. |
 | `bubbles`, `watchers`, `hub` | `true` | A line may show over its sender's character; watchers may send (not only read); homie.rocks's page for the room may show it. |
+| `history` | 0–90 days (0) | 0.29.0: keep what is said (never a reaction) in the studio's D1 for that many days, and give it back as the window when a page opens; 0 keeps nothing past the window. A kids server, a capped room or chat `off` keeps 0. |
 | `emoji` | the five, then up to 3 of the game's own | `{ k, e }`: a kind and its glyph. |
 | `lines` | 8 default lines, or up to 12 of the game's own | `{ id, text }`: the game's words; each passes the floor at build. |
 | `capped` | `kids`, `server-lines`, `server-off` | Why the mode is lower than the game asks. |
@@ -1261,6 +1262,12 @@ stays in the room; clients get the rest in `welcome.policy.chat` and every `poli
 | `lines` | down, a watching shell as it opens | `lines` | The window: the last 50 lines of the last 15 minutes. Never to a page the room holds out. |
 | `unline` | down, everyone | `ids` | The owner took them down: hide them, and their bubbles. |
 | `held` / `slow` | down, the sender | `why`, `message`, `n?`, `until?` | Not sent. `why`: `off`, `emoji`, `lines`, `sign-in`, `sign-in-react`, `members`, `members-react`, `watchers`, `hub`, `muted`, `slow`, `repeat`, `words`, `harm`, `contact`, `link`, `swears`, `ai`, `busy`, `unknown`, `empty`, `ai_seat`. |
+| `unsay` | up, a watching shell | `id` | 0.29.0: take my own line down (a line of this browser, or of this signed-in account). Everyone gets `unline`. |
+
+0.29.0 adds to `line`: `card` (`{ url, title, studio, pitch, image }`, a "show what you made" card the Worker read
+from a Homie studio's manifest; `text` stays a plain fallback such as "Made: <title> by <studio>"), `mod` (a moderator
+the owner named), `kept` (it came from the room's history) and, on a page's own copy of the window only, `mine` (this
+browser's or account's own line). A page that knows none of these shows the line's `text`.
 
 A line's sender is the socket's own client, or for a watch socket the client of the same browser
 (its room key) or account in the room: its seat, name and colour. A page with no client in the
@@ -1361,7 +1368,10 @@ ticker.
 
 **Privacy.** Nothing a person says is stored: the room keeps the last 50 lines of the last 15
 minutes in its memory (never in Durable Object storage), and an empty room forgets them with
-everything else a minute after its last person leaves. The counts (lines, reactions, held by why,
+everything else a minute after its last person leaves. Only where the owner turns `history` on (0.29.0; off by
+default for every game and the Lounge, never on a kids server) does the Table keep what was said in D1
+(`chat_history`: the words, the name shown, when, a signed-in sender's account id; never a reaction, an address or a
+browser key) for that many days; what is taken down there is deleted there, and a deleted account takes its lines. The counts (lines, reactions, held by why,
 reviews and neurons) are daily numbers in the studio's own D1, never a message or a sender. A
 report keeps one message for 30 days. The review sends the message's words (and nothing about who
 said it) to the studio's own Workers AI; Cloudflare says it does not keep or train on them.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homie-rocks/studio",
-  "version": "0.27.0",
+  "version": "0.29.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",

package/site/SITE.md

@@ -13,6 +13,7 @@ and every game gets a landing page. Anything the studio puts in `site/` wins.
 | `/music/`, `/videos/` | Songs and videos (`media/MEDIA.md`) | the studio has one published |
 | `/rooms/` | Every public room playing now across the studio's games, each with Join (`/api/rooms` is the same as JSON, cacheable for 15 s) | the studio has a game |
 | `/posts/` | The studio's posts, newest first, with `/posts/feed.xml` (Atom) and `/posts/feed.json` (JSON Feed) | the studio has a post |
+| `/lounge/` | The Lounge (0.29.0): the studio's community room, with play nights, live rooms and "show what you made" (`chat/LOUNGE.md`) | studio.json has `"lounge"` |
 
 A section with nothing in it has no tab, and its address answers 404. Every page ends with a
 "Made with Homie" link to https://homie.rocks/studio/. studio.json may add `"tagline"` (one line, on Home and in
@@ -35,6 +36,18 @@ the hub offers Watch beside Join. From 0.23.0 a room whose chat is on and whose
 socket from the visitor's browser and shows its lines and reactions live (NETPLAY.md section 19). A visitor there
 sends what a watcher may send (reactions and quick lines when the room's `react` is `anyone`), never types.
 
+## The Lounge: `/lounge/` (0.29.0)
+
+With studio.json `"lounge": true` (or `{ "name", "tab", "blurb", "featured", "kids", "chat" }`), `/lounge/` is the
+studio's community room (worker/lounge.mjs, lounge-page.mjs; chat/LOUNGE.md): room chat in a room of its own, in the
+studio's look, one column on a phone ("Chat" and "What's on") and the talk beside a sidebar on a computer. Its script
+is `/_homie/lounge.js`; its socket is `/lounge/__watch` (a page of this site carries its signed-in account; a page of
+another site is a watcher that reacts, never types). `/lounge/api/now` is its public facts as JSON (rules, play
+nights, live rooms; CORS open, cacheable for 30 s), and the manifest names it (`lounge: { name, page, now }`).
+`/lounge/api/history`, `show`, `report`, `delete` and `mod` are this site's pages' only. The owner's tools are
+`/_studio/api/lounge` and `/_studio/api/lounge/rules`, `night`, `mod`, `remove` and `hold`. A game called `lounge`
+keeps its page, and the build says the Lounge is off.
+
 ## Room chat on the play, watch and TV pages
 
 Every play page, big screen and watch page carries room chat (worker/chat-page.mjs; chat/CHAT.md): the Chat pill

package/worker/chat-store.mjs

@@ -1,7 +1,8 @@
 /**
  * ROOM CHAT IN THE STUDIO'S OWN D1 (@homie-rocks/studio 0.23.0, NETPLAY.md section 19): the owner's chat rules per game
  * and per server, and the reports players make. Never the chat itself: what people say lives a few minutes in the
- * room's memory and nowhere else (worker/room.mjs). A report keeps the one message it is about, for 30 days.
+ * room's memory and nowhere else (worker/room.mjs), unless an owner turns a room's `history` on (0.29.0: then
+ * worker/lounge-store.mjs keeps it for that many days). A report keeps the one message it is about, for 30 days.
  *
  *   chat_rules    (game, server, rules JSON, updated_at): server '' is the whole game; a server's row wins over it
  *   chat_reports  one reported message: its words, its sender's room name and (when signed in) account id, the room,

package/worker/chat.mjs

@@ -20,6 +20,9 @@
  *
  * 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.
+ * A room keeps its words longer only when its owner turns `history` on (a number of days, 0.29.0; off for every game
+ * by default, never on a kids server): then the Table writes what was said, never a reaction, to the studio's own D1
+ * (worker/lounge-store.mjs) and forgets it after that many days.
  */
 import { WORDS_B64 } from './chat-words.mjs';
 import { clefRun, localAiOf } from './brain.mjs';
@@ -55,6 +58,8 @@ export const CHAT_LIMITS = Object.freeze({
   /** A typed message: `max` is the room's, at most this (homie.rocks's LINE_MAX). */
   text: 280, minText: 20, name: 24,
   lineText: 60, lines: 12, extraEmoji: 3, words: 64, word: 32, slowMax: 120,
+  /** `history`: the most days a room may keep what was said (0, the default, keeps nothing past the window). */
+  historyMax: 90,
   /** The room's window: the last `keep` messages from the last `keepMs` (memory only), for a page that just opened. */
   keep: 50, keepMs: 15 * 60_000,
   /** The same words from the same person within this long are not sent again. */
@@ -77,9 +82,12 @@ export const CHAT_RATES = Object.freeze({
 /** A game with no "chat" in its game.json: emoji and quick lines for everyone, typing for signed-in players (reviewed). */
 export const CHAT_DEFAULTS = Object.freeze({
   mode: 'text', who: 'signed-in', react: 'anyone', slow: 2, max: 140, links: 'block', swears: 'block', ai: true,
-  bubbles: true, watchers: true, hub: true,
+  bubbles: true, watchers: true, hub: true, history: 0,
 });
 
+/** How long a room with these rules keeps what was said: its `history` days, else the window's few minutes. */
+export const windowMsOf = (rules) => (rules?.history > 0 ? rules.history * 86_400_000 : CHAT_LIMITS.keepMs);
+
 const ID = /^[a-z][a-z0-9_]{0,15}$/;
 const PICTO = /\p{Extended_Pictographic}/u;
 const oneLine = (v, max) => [...String(v ?? '').normalize('NFKC').replace(/[\p{Cc}\p{Cf}\p{Co}\p{Cs}\u2028\u2029]+/gu, ' ').replace(/\s+/g, ' ').trim()].slice(0, max).join('').trim();
@@ -151,6 +159,8 @@ export function normalizeChat(raw, { kids = false, speech = 'game' } = {}) {
     links: r.links === 'allow' ? 'allow' : 'block',
     swears: r.swears === 'allow' ? 'allow' : 'block',
     ai: bool('ai'), bubbles: bool('bubbles'), watchers: bool('watchers'), hub: bool('hub'),
+    // Kept words (0.29.0): only when the owner asks, never on a kids server or a capped one, never with chat off.
+    history: kids || capped || mode === 'off' ? 0 : int(r.history, 0, CHAT_LIMITS.historyMax, CHAT_DEFAULTS.history),
     emoji: [...REACTIONS.map((x) => ({ ...x })), ...extraEmoji(r.emoji)],
     lines: quickLines(r.lines),
     block: wordList(r.block), allow: wordList(r.allow),
@@ -191,6 +201,7 @@ export function checkChatRules(body) {
   for (const k of ['who', 'react']) if (b[k] !== undefined) { if (!CHAT_WHO.includes(b[k])) return bad(`${k} is anyone, signed-in or members`); f[k] = b[k]; }
   if (b.slow !== undefined) { const n = Math.floor(Number(b.slow)); if (!Number.isFinite(n) || n < 0 || n > CHAT_LIMITS.slowMax) return bad(`slow is 0 to ${CHAT_LIMITS.slowMax} seconds`); f.slow = n; }
   if (b.max !== undefined) { const n = Math.floor(Number(b.max)); if (!Number.isFinite(n) || n < CHAT_LIMITS.minText || n > CHAT_LIMITS.text) return bad(`max is ${CHAT_LIMITS.minText} to ${CHAT_LIMITS.text} characters`); f.max = n; }
+  if (b.history !== undefined) { const n = Math.floor(Number(b.history)); if (!Number.isFinite(n) || n < 0 || n > CHAT_LIMITS.historyMax) return bad(`history is 0 (keep nothing) to ${CHAT_LIMITS.historyMax} days`); f.history = n; }
   if (b.links !== undefined) { if (!['block', 'allow'].includes(b.links)) return bad('links is block or allow'); f.links = b.links; }
   if (b.swears !== undefined) { if (!['block', 'allow'].includes(b.swears)) return bad('swears is block or allow'); f.swears = b.swears; }
   for (const k of ['ai', 'bubbles', 'watchers', 'hub']) if (b[k] !== undefined) f[k] = b[k] === true || b[k] === 'on' || b[k] === 'true';
@@ -208,6 +219,7 @@ export function chatProblems(raw) {
   if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return ['"chat" is an object (or false for no chat)'];
   const out = [];
   if (raw.mode !== undefined && !CHAT_MODES.includes(raw.mode)) out.push('chat.mode is off, emoji, lines or text');
+  if (raw.history !== undefined && !(Number.isInteger(raw.history) && raw.history >= 0 && raw.history <= CHAT_LIMITS.historyMax)) out.push(`chat.history is a number of days, 0 to ${CHAT_LIMITS.historyMax} (0 keeps nothing past the room's few minutes)`);
   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`);
   // 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": … } }`);

package/worker/discover.mjs

@@ -67,6 +67,8 @@ export function robotsTxt(cat, origin, { preview = false } = {}) {
     'Disallow: /shop/thanks',
     'Disallow: /shop/parent/',
     'Disallow: /__homie',
+    // The Lounge's socket and APIs (0.29.0); its page may be crawled.
+    ...(cat.studio?.lounge ? ['Disallow: /lounge/api/', 'Disallow: /lounge/__'] : []),
     ...games.flatMap((id) => [`Disallow: /${id}/play`, `Disallow: /${id}/tv`, `Disallow: /${id}/watch`, `Disallow: /${id}/live`, `Disallow: /${id}/invite`, `Disallow: /${id}/api/`, `Disallow: /${id}/__`, `Disallow: /${id}/s/*/play`, `Disallow: /${id}/s/*/tv`, `Disallow: /${id}/s/*/home`]),
     '',
     `Sitemap: ${origin}/sitemap.xml`,
@@ -96,6 +98,8 @@ export function sitemapEntries(cat, { all = null } = {}) {
   if (songs.length) { add('/music/', newest(songs.map(mediaDate))); for (const e of songs) add(`/music/${e.slug}/`, mediaDate(e)); }
   if (videos.length) { add('/videos/', newest(videos.map(mediaDate))); for (const e of videos) add(`/videos/${e.slug}/`, mediaDate(e)); }
   if (posts.length) { add('/posts/', newest(posts.map(postDate))); for (const p of posts) add(`/posts/${p.slug}/`, postDate(p)); }
+  // The Lounge (0.29.0), when studio.json turns it on: its page (what is said there is not in the page).
+  if (cat.studio?.lounge) add('/lounge/');
   for (const p of ownPages(cat, all)) add(p);
   return out;
 }
@@ -210,6 +214,7 @@ export function llmsTxt(cat, origin, { remixable = () => false, directory = 'htt
   }
   out.push('', '## Optional', '');
   if (games.length) out.push(`- [Rooms](${origin}/rooms/): every public room playing now (${origin}/api/rooms is the same as JSON)`);
+  if (cat.studio?.lounge) out.push(`- [${label(cat.studio.lounge.name ?? 'The Lounge')}](${origin}/lounge/): the studio's community room: play nights, live rooms and chat (${origin}/lounge/api/now is its play nights and rules as JSON; what people say there is not published)`);
   out.push(`- [Studio manifest](${origin}/.well-known/homie-studio.json): the games, songs, videos and posts as JSON`);
   out.push(`- [Sitemap](${origin}/sitemap.xml): every public page`);
   if (!full) out.push(`- [Everything, in full](${origin}/llms-full.txt): each game's whole description, how to play and credits, and every post's text`);

package/worker/index.mjs

@@ -92,6 +92,8 @@ import { BRAIN_BUDGET, HouseAgents, agentFacts, aiName, decodeFacts, encodeFacts
 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 { forgetLines, historyOf, keepLines, keptLine } from './lounge-store.mjs';
+import { isLoungePath, loungeRoutes } from './lounge.mjs';
 import { doorPage, serverPage, serversPage } from './site.mjs';
 import { isLocalOrigin, qrSvg } from './qr.mjs';
 import { SEAT_MAX, perAddress, seatsOf } from './seats.mjs';
@@ -601,6 +603,11 @@ async function route(request, env, ctx) {
     if (shopped) return shopped;
   }
   if (path.startsWith('/api/player/') || path === '/account' || path === '/account/' || path === '/_homie/account.js') return playerRoutes(request, env, ctx, url, { catalogueOf: getCat });
+  // The Lounge (0.29.0, chat/LOUNGE.md): the studio's own community room, when studio.json turns it on.
+  if (isLoungePath(path)) {
+    const lounged = await loungeRoutes(request, env, ctx, url, { catalogueOf: getCat, roomsOf });
+    if (lounged) return lounged;
+  }
   if (path === '/_homie/site.js') return new Response(SITE_JS, { headers: { 'content-type': 'text/javascript; charset=utf-8', 'cache-control': url.searchParams.get('v') === STUDIO_VERSION_TAG ? 'public, max-age=31536000, immutable' : 'public, max-age=300', 'x-content-type-options': 'nosniff' } });
   if (path === '/api/stats/beat' && request.method === 'POST') return mediaBeat(request, env, ctx, url);
   if (path === '/api/stats') {
@@ -658,6 +665,8 @@ async function route(request, env, ctx) {
       // The studio's posts, for the hub (the full text is in /posts/feed.json).
       posts: (cat.posts ?? []).slice(0, 20).map((p) => ({ slug: p.slug, title: p.title, date: p.date, summary: p.summary, page: `${url.origin}/posts/${p.slug}/`, image: p.image ? (p.image.startsWith('/') ? `${url.origin}${p.image}` : p.image) : null, links: p.links ?? {} })),
       ...(shareRooms ? { rooms: `${url.origin}/api/rooms` } : {}),
+      // The studio's Lounge (0.29.0), for a directory that shows lounges: its page and its public facts.
+      ...(cat.studio?.lounge ? { lounge: { name: cat.studio.lounge.name, page: `${url.origin}/lounge/`, now: `${url.origin}/lounge/api/now` } } : {}),
       // Shared only when studio.json says `stats.share`: two numbers for the whole studio, for the hub.
       ...(played ? { played } : {}),
       // The shop (0.24.0): whether it sells and its till, never a key or a sale; and referrals: this studio takes
@@ -1200,11 +1209,30 @@ 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);
+    // Kept chat (0.29.0): a room whose rules keep `history` writes what was said to D1 and deletes what is taken down,
+    // one after another (a line removed the moment it went out is never written after its delete).
+    this.room.onPublished = (rec) => this.keptQueue(() => keepLines(this.env, this.game, this.code, [rec]));
+    this.room.onUnsaid = (ids) => this.keptQueue(() => forgetLines(this.env, this.game, this.code, ids));
     // 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;
   }
 
+  /** Kept chat's writes, in order, each finished before the next (D1 calls from one room never pass each other). */
+  keptQueue(fn) {
+    if (!this.env.DB) return;
+    this.kept = (this.kept ?? Promise.resolve()).then(fn).catch((error) => { try { console.log(JSON.stringify({ ev: 'chat-history-failed', room: this.code, error: String(error?.message ?? error).slice(0, 200) })); } catch { /* no console */ } });
+    this.ctx.waitUntil(this.kept);
+  }
+
+  /** A room that keeps history puts what it kept back in its window before its first page opens (once per opening). */
+  async hydrateHistory(room) {
+    const days = room.chatRules().history;
+    if (!(days > 0) || room.hydrated || !this.env.DB) return;
+    room.hydrated = true;
+    try { await this.kept; room.hydrate(await historyOf(this.env, this.game, this.code, { days })); } catch { /* the window alone (before migration 0009) */ }
+  }
+
   /** 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;
@@ -1411,14 +1439,16 @@ export class Table {
     // A chat line as the room keeps it (section 19), for a report: the Worker files the room's own copy, never a reporter's.
     if (url.pathname === '/__chat') {
       const id = url.searchParams.get('id');
-      const r = room.chatLog.find((x) => x.id === id);
-      return json({ ok: Boolean(r), line: r ? { id: r.id, kind: r.kind, text: r.text ?? null, glyph: r.glyph ?? null, name: r.name, seat: r.seat, at: r.at, by: r.by, player: r.from?.player ?? null } : null });
+      // A line older than the window is in the room's kept history, when it keeps one (0.29.0).
+      const r = room.chatLog.find((x) => x.id === id) ?? (room.chatRules().history > 0 ? await keptLine(this.env, this.game, this.code, id) : null);
+      return json({ ok: Boolean(r), line: r ? { id: r.id, kind: r.kind, text: r.text ?? null, glyph: r.glyph ?? null, name: r.name, seat: r.seat, at: r.at, by: r.by, player: r.from?.player ?? null, owner: Boolean(r.owner), mod: Boolean(r.mod) } : null });
     }
     if (url.pathname === '/__office') {
       const ctl = await request.json().catch(() => null);
       const why = await verifyControl(this.env, ctl, { game: this.game, room: this.code }, this.seen);
       if (why) return json({ ok: false, error: 'refused', why }, 403);
-      const res = room.control(ctl.op, ctl.args && typeof ctl.args === 'object' ? ctl.args : {});
+      // A Lounge card waits for the studio's review (0.29.0); every other control answers at once.
+      const res = await room.control(ctl.op, ctl.args && typeof ctl.args === 'object' ? ctl.args : {});
       // AI talk turned off (a policy) or a guide kicked: the house guides follow at once.
       if (this.house) this.house.sync();
       await this.ctx.storage.put('office', room.officeSaved()).catch(() => {});
@@ -1436,6 +1466,8 @@ export class Table {
     if (pol) room.setPolicy(pol);
     if (this.house) this.house.sync();
     const agent = decodeFacts(url.searchParams.get('ag'));
+    // Kept chat (0.29.0): the room's history is back in its window before this page hears it.
+    await this.hydrateHistory(room);
     const [client, server] = Object.values(new WebSocketPair());
     server.accept();
     const via = url.searchParams.get('via');
@@ -1459,6 +1491,9 @@ export class Table {
       acct: url.searchParams.get('acct') === '1',
       member: url.searchParams.get('mem') === '1',
       hub: url.pathname === '/__watch' && url.searchParams.get('hub') === '1',
+      // The Lounge (0.29.0): the signed-in account's name and a moderator's mark, the Worker's word on a watch socket.
+      ...(url.pathname === '/__watch' && url.searchParams.get('nm') ? { name: String(url.searchParams.get('nm')).slice(0, 40) } : {}),
+      ...(url.pathname === '/__watch' && url.searchParams.get('mod') === '1' ? { mod: true } : {}),
       send: (text) => { try { server.send(text); } catch { /* closed */ } },
       close: (c, r) => { try { server.close(c, r); } catch { /* closed */ } },
       buffered: () => 0,