viberoom 0.7.0 → 0.9.0

package/NOTICE

@@ -27,9 +27,11 @@ This product bundles the following third-party material:
   - Cascadia Code: Copyright 2019 Microsoft Corporation.
 
 - Vendor icons (assets/vendors/): the logos of Claude, Codex, Gemini, Cursor,
-  OpenCode and GitHub Copilot, as published in the Agent Client Protocol
-  registry (https://agentclientprotocol.com). Each mark belongs to its owner and
-  is used only to identify the agent it stands for.
+  OpenCode, GitHub Copilot and Grok, as published in the Agent Client Protocol
+  registry (https://agentclientprotocol.com), and the Nous Research mark for
+  Hermes Agent, traced in one colour from the icon published on nousresearch.com.
+  Each mark belongs to its owner and is used only to identify the agent it
+  stands for.
 
 - ACP adapters (vendor/acp/, copied from the npm packages at build time by
   scripts/vendor-acp.mjs, each with its licence file):

package/README.md

@@ -14,16 +14,86 @@ Open a room, summon the agents you already have, give each one a role, and let t
 </p>
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/conversation.png" width="960" alt="A room with two vibemates: one explains a git command from a screenshot, the other adds the part that changes whose problem it is">
+  <a href="https://todor-rusev.github.io/viberoom/demo/vibeclassic.html"><img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/looks.gif" width="960" alt="The recorded session, drawn in each of the six looks in turn; click to open the interactive demo"></a>
 </p>
 
 <p align="center">
-  <b>Claude</b> &nbsp;·&nbsp; <b>Codex</b> &nbsp;·&nbsp; <b>Gemini</b> &nbsp;·&nbsp; <b>Cursor</b> &nbsp;·&nbsp; <b>OpenCode</b> &nbsp;·&nbsp; <b>GitHub Copilot</b><br>
+  <a href="https://todor-rusev.github.io/viberoom/demo/vibeclassic.html"><img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/try-the-demo.png" width="880" alt="Try the interactive demo: a recorded session in the real viberoom window, two rooms, six vibemates, six looks, nothing to install"></a>
+</p>
+
+<p align="center">
+  <b>Claude</b> &nbsp;·&nbsp; <b>Codex</b> &nbsp;·&nbsp; <b>Gemini</b> &nbsp;·&nbsp; <b>Cursor</b> &nbsp;·&nbsp; <b>OpenCode</b> &nbsp;·&nbsp; <b>GitHub Copilot</b> &nbsp;·&nbsp; <b>Grok Build</b> &nbsp;·&nbsp; <b>Hermes Agent</b><br>
   <sub>whichever of them you have installed, with your own logins, in one room</sub>
 </p>
 
 <br>
 
+## See it before you install it
+
+Two rooms, six vibemates, one afternoon: a small CLI fixed and tested by Claude, Codex and OpenCode, and a
+bakery's launch planned by Claude, Codex and Gemini, with the tool calls, the pictures, the file previews and
+the Mermaid diagrams as they happened. The session is recorded as pages that run the real viberoom window
+with no hub behind it. Every card below opens it in that look: walk between the rooms, open the participants,
+change the look under Settings. (The pages live in [`docs/demo/`](docs/demo/) too, for a copy of your own.)
+
+<a href="https://todor-rusev.github.io/viberoom/demo/vibeclassic.html"><img align="right" width="460" src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/card-vibeclassic.jpg" alt="VibeClassic"></a>
+
+**VibeClassic** &mdash; the default: lavender light, soft tiles, room to breathe.<br>
+<a href="https://todor-rusev.github.io/viberoom/demo/vibeclassic.html">Open the demo in VibeClassic &rarr;</a>
+
+<br clear="all">
+
+<a href="https://todor-rusev.github.io/viberoom/demo/vibeclassic-dark.html"><img align="left" width="460" src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/card-vibeclassic-dark.jpg" alt="VibeClassic Dark"></a>
+
+**VibeClassic Dark** &mdash; the same room after dark: navy paper, the same tiles, nothing glares.<br>
+<a href="https://todor-rusev.github.io/viberoom/demo/vibeclassic-dark.html">Open the demo in VibeClassic Dark &rarr;</a>
+
+<br clear="all">
+
+<a href="https://todor-rusev.github.io/viberoom/demo/clay.html"><img align="right" width="460" src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/card-clay.jpg" alt="Clay"></a>
+
+**Clay** &mdash; sand, terracotta and teal on warm paper; matte objects, soft corners.<br>
+<a href="https://todor-rusev.github.io/viberoom/demo/clay.html">Open the demo in Clay &rarr;</a>
+
+<br clear="all">
+
+<a href="https://todor-rusev.github.io/viberoom/demo/eye-comfort.html"><img align="left" width="460" src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/card-eye-comfort.jpg" alt="Eye Comfort"></a>
+
+**Eye Comfort** &mdash; cream instead of white, dark grey instead of black, air between the lines: made for long evenings.<br>
+<a href="https://todor-rusev.github.io/viberoom/demo/eye-comfort.html">Open the demo in Eye Comfort &rarr;</a>
+
+<br clear="all">
+
+<a href="https://todor-rusev.github.io/viberoom/demo/3d-clayful.html"><img align="right" width="460" src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/card-3d-clayful.jpg" alt="3D clayful"></a>
+
+**3D clayful** &mdash; cream, lavender, pink and mint with real volume: light from the top left, a wall under every object.<br>
+<a href="https://todor-rusev.github.io/viberoom/demo/3d-clayful.html">Open the demo in 3D clayful &rarr;</a>
+
+<br clear="all">
+
+<a href="https://todor-rusev.github.io/viberoom/demo/terminal.html"><img align="left" width="460" src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/card-terminal.jpg" alt="Terminal"></a>
+
+**Terminal** &mdash; phosphor green on black, one monospace face, hairlines instead of shadows.<br>
+<a href="https://todor-rusev.github.io/viberoom/demo/terminal.html">Open the demo in Terminal &rarr;</a>
+
+<br clear="all">
+
+
+## Six looks, or your own
+
+A look is how the window is drawn: colours, light, corners, fonts. Pick one under Settings, fine-tune it,
+or ask a vibemate for "a warm paper look for long evenings": it reads every design token with what it
+means, checks its draft (the hub measures whether the words read on their paper and reports the numbers,
+since a vibemate cannot see colours), saves the look among your own with your name on it, and proposes
+wearing it as a card you can try on first. Your looks are files: export one to share it, import one
+someone sent you.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/looks-picker.png" width="820" alt="Settings: the look picker with the six shipped looks">
+</p>
+
+<br>
+
 ## The idea
 
 One agent is a conversation. Three agents in one room are a **team**: one decides what "done" means,
@@ -44,7 +114,7 @@ effort and how much it may do on its own. Three vibemates from the same agent wi
 vibios behave like three different people, which is exactly the point.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/summon.png" width="960" alt="Summon a vibemate: agent, model, effort, mode, name, face and a private brief">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/summon.png" width="960" alt="Summon a vibemate: eight agents to pick from, then a name, a face and a private brief">
 </p>
 
 <br>
@@ -59,8 +129,7 @@ vibemate gets the rules as instructions, so the room runs the way you wrote it d
   <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/rules.png" width="820" alt="Room rules with live @references to the vibemates">
 </p>
 
-Here is what a five-line ruleset buys you: a handoff chain that runs on its own, with the human at
-both ends.
+Five lines of rules buy you a handoff chain that runs on its own, with the human at both ends.
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/art/handoff.svg" width="960" alt="One task, four hands: you to Pip to Nova to Rex, review loop, report back">
@@ -82,11 +151,10 @@ library marks it as theirs until you have read it.
 
 ## Let them design the room
 
-A vibemate can design a room as well as work in it. It has a built-in skill on what makes rules and
-roles good, and four hub tools: read the room's settings and rules, check a design and preview the
-brief the others would receive, save a template for you to pick under New room, or propose a change to
-the room you are in. A proposal is a card in the chat with the diff; nothing changes until you click
-Apply, and the room is told what you decided.
+A vibemate can design a room as well as work in it: read the room's settings and rules, check a design
+and preview the brief the others would receive, save a template for you to pick under New room, or propose
+a change to the room you are in. A proposal is a card in the chat with the diff; nothing changes until you
+click Apply, and the room is told what you decided.
 
 <br>
 
@@ -98,8 +166,8 @@ Apply, and the room is told what you decided.
 
 Write to the room and every vibemate answers, each after a short pause so replies do not trip over
 each other. `@Name` one of them and the rest read along. Vibemates talk to each other the same way:
-a reply wakes the others, `@Name` picks one, and a hop limit keeps an argument from running all night. **Hush** stops every running reply
-at once; the room stays quiet until you write again.
+a reply wakes the others, `@Name` picks one, and a hop limit keeps an argument from running all night.
+**Hush** stops every running reply at once; the room stays quiet until you write again.
 
 <br>
 
@@ -111,7 +179,7 @@ at that line. A diagram block becomes a diagram. Change one of your own messages
 the vibemates are told, or the conversation rewinds to that point.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/home.png" width="960" alt="The home page: welcome back, your rooms, what you can do here">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/conversation.png" width="960" alt="A room with two vibemates: one explains a git command from a screenshot, the other adds the part that changes whose problem it is">
 </p>
 
 <br>
@@ -141,10 +209,11 @@ it in a browser tab. Later, `npm install -g viberoom@latest` and the next start
   sees your keys; every agent keeps its own login.
 - **Edit a message.** Fix what you said; the vibemates get the memo, or the conversation rewinds.
 - **Quote a message.** Select a fragment of a bubble, or copy it with Ctrl+C, and it goes into your next
-  message as a quote — with who said it and when, so the vibemates read it as that person's words, not yours.
+  message as a quote, with who said it and when.
 - **Your messages on a timeline.** A thin strip on the chat's right edge, one mark per message of yours:
   hover for the message with its neighbours, click to jump there.
-- **Pick a folder from a tree.** Browse the machine's folders when a room needs one; make a new one on the spot.
+- **Nothing is cut in silence.** A persona or a rule longer than the room's limit is refused with the
+  numbers, and the window offers to cut it, raise the limit, or go back.
 - **Settings save themselves.** Change a setting and it is saved: on Enter, on leaving the field, on a pick.
 - **Search the room.** Everything anyone said, one search box.
 - **For geeks.** Every panel folds its technical settings behind a toggle. You never have to open it.
@@ -154,11 +223,12 @@ it in a browser tab. Later, `npm install -g viberoom@latest` and the next start
 ## What you need
 
 - Node.js 22 or newer.
-- At least one coding agent installed and logged in: Claude Code, Codex, Gemini CLI, Cursor, OpenCode
-  or GitHub Copilot. viberoom finds the ones you have and offers only those. It installs none of them.
+- At least one coding agent installed and logged in: Claude Code, Codex, Gemini CLI, Cursor, OpenCode,
+  GitHub Copilot, Grok Build or Hermes Agent. viberoom finds the ones you have and offers only those. It
+  installs none of them.
 - A browser. Chrome, Edge or Brave for the app window; anything modern for a tab.
 
-Something does not start? `viberoom doctor` checks these four things and says which one is missing.
+Something does not start? `viberoom doctor` checks these things and says which one is missing.
 
 <br>
 
@@ -175,7 +245,7 @@ viberoom logs       the background hub's log
 
 `Enter` sends, `Shift+Enter` is a new line, `@Name` addresses one vibemate, `/name` invokes a skill.
 Your data lives in `~/.viberoom` (or `$VIBEROOM_DATA_DIR`): settings, rooms with their history,
-skills and the log.
+skills, looks and the log.
 
 <br>
 
@@ -184,6 +254,7 @@ skills and the log.
 - A question ("how do I ...?") goes to [Discussions → Q&A](https://github.com/todor-rusev/viberoom/discussions/categories/q-a).
 - An idea goes to [Discussions → Ideas](https://github.com/todor-rusev/viberoom/discussions/categories/ideas).
 - A bug goes to [Issues](https://github.com/todor-rusev/viberoom/issues/new/choose); the form asks for what a fix needs.
+- A change you would like to make: read [CONTRIBUTING.md](CONTRIBUTING.md) first. Pull requests are credited, not merged as they are.
 
 <br>
 

package/assets/vendors/grok.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 16 16">
+    <path fill="currentColor" d="M0.58392448,14.9254204 L0.8326,14.66295 C2.004465,13.42985 3.1678,12.2082 2.45814,10.48105 C1.50813,8.1701 2.061355,5.4619 3.820575,3.70057 C5.6495,1.8709 8.3431,1.40957 10.59295,2.336505 C11.0907,2.52161 11.5245,2.785025 11.86295,3.02993 L9.98425,3.89849 C8.235,3.163775 6.23115,3.66355 5.0081,4.88809 C3.354105,6.5426 3.019895,9.4117 4.95835,11.2656 L-0.335,15.99995 C-0.066496,15.62975 0.2538896,15.275934 0.58392448,14.9254204 Z M14.0391,2.288155 L16.33165,2.57749377e-12 L16.20795,0.172288 C14.4658,2.574355 13.6153,3.749045 14.29795,6.6879 C14.76445,8.68415 14.261,10.90255 12.63545,12.53005 C10.5861,14.58325 7.3066,15.0403 4.6059,13.19215 L6.48885,12.3193 C8.2125,12.99705 10.0983,12.69945 11.4536,11.34255 C12.80895,9.9856 13.1133,8.00925 12.4321,6.3647 C12.30265,6.05285 11.9144,5.97455 11.64275,6.1753 L6.102,10.27035 L14.0391,2.288155 Z"/>
+</svg>

package/assets/vendors/hermes.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="-1 0 63 63"><path fill="currentColor" d="M25 0h10v1h-10zM28 1h10v1h-10zM19 2h4v1h-4zM30 2h10v1h-10zM16 3h10v1h-10zM32 3h10v1h-10zM14 4h14v1h-14zM33 4h10v1h-10zM12 5h17v1h-17zM34 5h10v1h-10zM11 6h19v1h-19zM35 6h10v1h-10zM9 7h22v1h-22zM35 7h11v1h-11zM8 8h21v1h-21zM30 8h2v1h-2zM36 8h10v1h-10zM7 9h20v1h-20zM31 9h1v1h-1zM37 9h7v1h-7zM6 10h19v1h-19zM26 10h1v1h-1zM30 10h3v1h-3zM37 10h6v1h-6zM47 10h1v1h-1zM5 11h7v1h-7zM13 11h11v1h-11zM30 11h2v1h-2zM38 11h1v1h-1zM41 11h1v1h-1zM47 11h2v1h-2zM8 12h4v1h-4zM13 12h4v1h-4zM21 12h1v1h-1zM27 12h6v1h-6zM38 12h1v1h-1zM41 12h1v1h-1zM43 12h2v1h-2zM46 12h3v1h-3zM9 13h2v1h-2zM27 13h7v1h-7zM38 13h11v1h-11zM12 14h1v1h-1zM15 14h8v1h-8zM27 14h7v1h-7zM39 14h11v1h-11zM3 15h4v1h-4zM9 15h26v1h-26zM39 15h11v1h-11zM3 16h32v1h-32zM36 16h15v1h-15zM3 17h32v1h-32zM36 17h15v1h-15zM2 18h49v1h-49zM2 19h50v1h-50zM2 20h17v1h-17zM20 20h32v1h-32zM2 21h17v1h-17zM20 21h32v1h-32zM2 22h18v1h-18zM21 22h31v1h-31zM2 23h11v1h-11zM14 23h6v1h-6zM21 23h32v1h-32zM2 24h11v1h-11zM17 24h2v1h-2zM29 24h24v1h-24zM3 25h8v1h-8zM19 25h3v1h-3zM30 25h23v1h-23zM3 26h7v1h-7zM18 26h6v1h-6zM30 26h23v1h-23zM4 27h6v1h-6zM11 27h1v1h-1zM20 27h3v1h-3zM24 27h1v1h-1zM30 27h7v1h-7zM41 27h12v1h-12zM5 28h2v1h-2zM8 28h5v1h-5zM20 28h2v1h-2zM24 28h1v1h-1zM30 28h24v1h-24zM9 29h4v1h-4zM21 29h1v1h-1zM30 29h24v1h-24zM9 30h2v1h-2zM12 30h1v1h-1zM30 30h24v1h-24zM9 31h3v1h-3zM30 31h24v1h-24zM9 32h2v1h-2zM30 32h25v1h-25zM9 33h2v1h-2zM30 33h25v1h-25zM9 34h1v1h-1zM29 34h26v1h-26zM8 35h2v1h-2zM29 35h26v1h-26zM8 36h2v1h-2zM29 36h27v1h-27zM8 37h2v1h-2zM29 37h27v1h-27zM8 38h3v1h-3zM12 38h4v1h-4zM29 38h27v1h-27zM8 39h3v1h-3zM13 39h1v1h-1zM16 39h1v1h-1zM29 39h27v1h-27zM8 40h4v1h-4zM28 40h6v1h-6zM35 40h22v1h-22zM8 41h4v1h-4zM28 41h6v1h-6zM35 41h18v1h-18zM54 41h3v1h-3zM8 42h5v1h-5zM28 42h6v1h-6zM35 42h18v1h-18zM54 42h3v1h-3zM7 43h6v1h-6zM28 43h5v1h-5zM35 43h18v1h-18zM55 43h2v1h-2zM0 44h1v1h-1zM7 44h7v1h-7zM28 44h5v1h-5zM34 44h19v1h-19zM55 44h3v1h-3zM0 45h1v1h-1zM7 45h7v1h-7zM28 45h25v1h-25zM55 45h3v1h-3zM0 46h1v1h-1zM7 46h9v1h-9zM19 46h4v1h-4zM28 46h6v1h-6zM36 46h17v1h-17zM55 46h3v1h-3zM0 47h2v1h-2zM6 47h18v1h-18zM28 47h5v1h-5zM36 47h17v1h-17zM55 47h3v1h-3zM60 47h1v1h-1zM0 48h3v1h-3zM6 48h19v1h-19zM28 48h4v1h-4zM36 48h17v1h-17zM54 48h4v1h-4zM60 48h1v1h-1zM0 49h9v1h-9zM10 49h16v1h-16zM28 49h25v1h-25zM54 49h4v1h-4zM60 49h1v1h-1zM1 50h7v1h-7zM9 50h43v1h-43zM53 50h5v1h-5zM60 50h1v1h-1zM0 51h1v1h-1zM2 51h5v1h-5zM9 51h18v1h-18zM29 51h29v1h-29zM59 51h2v1h-2zM0 52h2v1h-2zM8 52h18v1h-18zM30 52h27v1h-27zM59 52h2v1h-2zM1 53h3v1h-3zM6 53h19v1h-19zM27 53h1v1h-1zM31 53h26v1h-26zM59 53h2v1h-2zM2 54h9v1h-9zM12 54h11v1h-11zM27 54h1v1h-1zM32 54h25v1h-25zM58 54h2v1h-2zM4 55h6v1h-6zM12 55h12v1h-12zM25 55h2v1h-2zM28 55h1v1h-1zM33 55h23v1h-23zM57 55h3v1h-3zM6 56h1v1h-1zM11 56h13v1h-13zM26 56h1v1h-1zM28 56h1v1h-1zM32 56h4v1h-4zM38 56h3v1h-3zM46 56h1v1h-1zM49 56h6v1h-6zM56 56h3v1h-3zM6 57h2v1h-2zM9 57h16v1h-16zM27 57h1v1h-1zM30 57h3v1h-3zM36 57h3v1h-3zM47 57h2v1h-2zM50 57h8v1h-8zM7 58h6v1h-6zM14 58h11v1h-11zM28 58h3v1h-3zM35 58h3v1h-3zM49 58h1v1h-1zM51 58h6v1h-6zM8 59h4v1h-4zM14 59h15v1h-15zM34 59h3v1h-3zM50 59h1v1h-1zM52 59h3v1h-3zM13 60h15v1h-15zM34 60h2v1h-2zM50 60h4v1h-4zM12 61h11v1h-11zM24 61h1v1h-1zM33 61h2v1h-2zM51 61h2v1h-2zM12 62h10v1h-10zM23 62h2v1h-2zM30 62h1v1h-1zM33 62h1v1h-1zM52 62h1v1h-1z"/></svg>

package/dist/agent-health.js

@@ -10,7 +10,7 @@ export function loginState(probe, evidence) {
         return "unknown";
     return probe.files.length ? "missing" : "unknown";
 }
-const LOGIN_WORDS = /\b(not logged in|log ?in required|login required|please log ?in|unauthori[sz]ed|authentication (failed|required|error)|invalid api key|api key (is )?(missing|not set|invalid)|no credentials|credentials not found|401|403|oauth|token (expired|invalid))\b/i;
+const LOGIN_WORDS = /\b(not logged in|log ?in required|login required|please log ?in|unauthori[sz]ed|authentication (failed|required|error)|invalid api key|api key (is )?(missing|not set|invalid)|no credentials|credentials not found|no (llm )?provider (configured|available)|401|403|oauth|token (expired|invalid))\b/i;
 const MISSING_WORDS = /\b(enoent|not found|no such file|is not recognized|command not found|spawn\w* (failed|error))\b/i;
 const TIMEOUT_WORDS = /\b(timed out|timeout|took too long|did not answer|no response)\b/i;
 export function classifyStartFailure(input) {

package/dist/hub.js

@@ -11,6 +11,7 @@ import { DEFAULT_ROOM_SETTINGS } from "./persona.js";
 import { Room } from "./room.js";
 import { SkillLibrary } from "./skills.js";
 import { TemplateLibrary, roomSettingsFromTemplate } from "./templates.js";
+import { LookLibrary, checkLookSpec, loadTokens } from "./looks.js";
 export const ADJUSTABLE = {
     canvas: "colour", panel: "colour", bubble: "colour", mine: "colour", ring: "colour", ink: "colour", muted: "colour", accent: "colour",
     face: "colour", logo: "colour", logoInk: "colour", corners: "scale",
@@ -21,11 +22,61 @@ export const DEFAULT_APPEARANCE = { chatFontSize: 14.5, font: "nunito", mono: "j
 export const DIAGRAM_PRESETS = ["pop", "lavender", "mint", "sunset", "slate"];
 const ROOM_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,39}$/;
 const INSTRUCTION_FILES = ["CLAUDE.md", "AGENTS.md", "GEMINI.md", ".cursorrules"];
+export function nextAppearance(current, a) {
+    const chatFontSize = Number(a.chatFontSize ?? current.chatFontSize ?? DEFAULT_APPEARANCE.chatFontSize);
+    if (!Number.isFinite(chatFontSize) || chatFontSize < 12 || chatFontSize > 24)
+        throw new Error("appearance.chatFontSize must be between 12 and 24");
+    const font = String(a.font ?? current.font ?? DEFAULT_APPEARANCE.font);
+    if (!TEXT_FONTS.includes(font))
+        throw new Error(`appearance.font must be one of ${TEXT_FONTS.join(", ")}`);
+    const mono = String(a.mono ?? current.mono ?? DEFAULT_APPEARANCE.mono);
+    if (!MONO_FONTS.includes(mono))
+        throw new Error(`appearance.mono must be one of ${MONO_FONTS.join(", ")}`);
+    const look = String(a.look ?? current.look ?? DEFAULT_APPEARANCE.look);
+    if (!/^[a-z][a-z0-9-]{0,30}$/.test(look))
+        throw new Error("appearance.look must be a short lower-case id");
+    const custom = { ...(current.custom ?? {}) };
+    if (a.custom !== undefined && typeof a.custom === "object" && a.custom) {
+        for (const [lookId, values] of Object.entries(a.custom)) {
+            if (!/^[a-z][a-z0-9-]{0,30}$/.test(lookId))
+                throw new Error("appearance.custom: a look id is a short lower-case id");
+            if (values === null) {
+                delete custom[lookId];
+                continue;
+            }
+            if (typeof values !== "object")
+                throw new Error("appearance.custom: each look takes an object of adjustments");
+            const clean = {};
+            for (const [key, value] of Object.entries(values)) {
+                const kind = ADJUSTABLE[key];
+                if (!kind)
+                    throw new Error(`appearance.custom: "${key}" is not adjustable (${Object.keys(ADJUSTABLE).join(", ")})`);
+                if (kind === "colour") {
+                    if (typeof value !== "string" || !/^#[0-9a-fA-F]{6}$/.test(value))
+                        throw new Error(`appearance.custom.${key} must be a colour like #1a2b3c`);
+                    clean[key] = value.toLowerCase();
+                }
+                else {
+                    const n = typeof value === "string" || typeof value === "number" ? Number(value) : NaN;
+                    if (!Number.isFinite(n) || n < 0 || n > 2)
+                        throw new Error(`appearance.custom.${key} must be a number between 0 and 2`);
+                    clean[key] = String(Math.round(n * 100) / 100);
+                }
+            }
+            if (Object.keys(clean).length)
+                custom[lookId] = clean;
+            else
+                delete custom[lookId];
+        }
+    }
+    return { chatFontSize: Math.round(chatFontSize * 2) / 2, font, mono, look, custom };
+}
 export class Hub extends EventEmitter {
     dataDir;
     rooms = new Map();
     skills;
     templates;
+    looks;
     settings;
     log;
     optionCache = new Map();
@@ -39,6 +90,7 @@ export class Hub extends EventEmitter {
         mkdirSync(join(this.dataDir, "rooms"), { recursive: true });
         this.skills = new SkillLibrary(join(this.dataDir, "skills"), log.child("skills"));
         this.templates = new TemplateLibrary(join(this.dataDir, "templates"), log.child("templates"));
+        this.looks = new LookLibrary(join(this.dataDir, "looks"), log.child("looks"));
         try {
             this.skills.seedBuiltins();
         }
@@ -51,6 +103,30 @@ export class Hub extends EventEmitter {
             hubUrl: () => this.hubUrl,
             templates: this.templates,
             templatesChanged: () => this.emit("event", { type: "templates" }),
+            looks: {
+                list: () => this.looks.list(),
+                describe: () => this.looks.describe(),
+                check: (raw) => checkLookSpec(raw),
+                save: (raw, options) => this.saveLook(raw, options),
+            },
+            appearance: {
+                current: () => ({ ...this.settings.appearance, custom: { ...(this.settings.appearance.custom ?? {}) } }),
+                preview: (patch) => nextAppearance(this.settings.appearance, patch),
+                apply: (patch) => {
+                    this.updateSettings({ appearance: patch });
+                },
+                ownAdjustments: async (lookId) => {
+                    const tokens = await loadTokens();
+                    let look = tokens.looks[lookId];
+                    if (!look) {
+                        const spec = this.looks.get(lookId);
+                        if (!spec)
+                            return null;
+                        look = tokens.make(spec);
+                    }
+                    return { label: look.label, values: Object.fromEntries(tokens.adjustables.map((f) => [f.key, String(f.of(look))])) };
+                },
+            },
             needApproval: () => this.settings.agentSkillsNeedApproval === true,
             save: (draft) => {
                 const { body: _b, ...meta } = this.saveSkillInternal(draft);
@@ -209,54 +285,7 @@ export class Hub extends EventEmitter {
             next.editor = { mode, command };
         }
         if (patch.appearance !== undefined && typeof patch.appearance === "object" && patch.appearance) {
-            const a = patch.appearance;
-            const chatFontSize = Number(a.chatFontSize ?? next.appearance?.chatFontSize ?? DEFAULT_APPEARANCE.chatFontSize);
-            if (!Number.isFinite(chatFontSize) || chatFontSize < 12 || chatFontSize > 24)
-                throw new Error("appearance.chatFontSize must be between 12 and 24");
-            const font = String(a.font ?? next.appearance?.font ?? DEFAULT_APPEARANCE.font);
-            if (!TEXT_FONTS.includes(font))
-                throw new Error(`appearance.font must be one of ${TEXT_FONTS.join(", ")}`);
-            const mono = String(a.mono ?? next.appearance?.mono ?? DEFAULT_APPEARANCE.mono);
-            if (!MONO_FONTS.includes(mono))
-                throw new Error(`appearance.mono must be one of ${MONO_FONTS.join(", ")}`);
-            const look = String(a.look ?? next.appearance?.look ?? DEFAULT_APPEARANCE.look);
-            if (!/^[a-z][a-z0-9-]{0,30}$/.test(look))
-                throw new Error("appearance.look must be a short lower-case id");
-            const custom = { ...(next.appearance?.custom ?? {}) };
-            if (a.custom !== undefined && typeof a.custom === "object" && a.custom) {
-                for (const [lookId, values] of Object.entries(a.custom)) {
-                    if (!/^[a-z][a-z0-9-]{0,30}$/.test(lookId))
-                        throw new Error("appearance.custom: a look id is a short lower-case id");
-                    if (values === null) {
-                        delete custom[lookId];
-                        continue;
-                    }
-                    if (typeof values !== "object")
-                        throw new Error("appearance.custom: each look takes an object of adjustments");
-                    const clean = {};
-                    for (const [key, value] of Object.entries(values)) {
-                        const kind = ADJUSTABLE[key];
-                        if (!kind)
-                            throw new Error(`appearance.custom: "${key}" is not adjustable (${Object.keys(ADJUSTABLE).join(", ")})`);
-                        if (kind === "colour") {
-                            if (typeof value !== "string" || !/^#[0-9a-fA-F]{6}$/.test(value))
-                                throw new Error(`appearance.custom.${key} must be a colour like #1a2b3c`);
-                            clean[key] = value.toLowerCase();
-                        }
-                        else {
-                            const n = typeof value === "string" || typeof value === "number" ? Number(value) : NaN;
-                            if (!Number.isFinite(n) || n < 0 || n > 2)
-                                throw new Error(`appearance.custom.${key} must be a number between 0 and 2`);
-                            clean[key] = String(Math.round(n * 100) / 100);
-                        }
-                    }
-                    if (Object.keys(clean).length)
-                        custom[lookId] = clean;
-                    else
-                        delete custom[lookId];
-                }
-            }
-            next.appearance = { chatFontSize: Math.round(chatFontSize * 2) / 2, font, mono, look, custom };
+            next.appearance = nextAppearance(next.appearance, patch.appearance);
         }
         next.appearance = { ...DEFAULT_APPEARANCE, ...(next.appearance ?? {}) };
         if (!next.editor)
@@ -402,7 +431,7 @@ export class Hub extends EventEmitter {
             });
             if (!choice.agentType) {
                 try {
-                    room.addUnstaffed({ name: choice.name || tv.name, tagline: tv.tagline, role: tv.role, avatar: tv.avatar, skills });
+                    room.addUnstaffed({ name: choice.name || tv.name, tagline: tv.tagline, role: tv.role, avatar: tv.avatar, skills, textCheck: "notice" });
                 }
                 catch (error) {
                     notices.push(`${choice.name || tv.name} could not be added: ${error instanceof Error ? error.message : String(error)}`);
@@ -421,12 +450,15 @@ export class Hub extends EventEmitter {
                     model: choice.model ?? tv.model,
                     effort: choice.effort ?? tv.effort,
                     mode: choice.mode ?? tv.mode,
+                    textCheck: "notice",
                 });
             }
             catch (error) {
                 notices.push(`${choice.name || tv.name} could not be summoned: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
+        if (room.settings.customRules.length > room.settings.briefTextLimit)
+            notices.push(`The room rules from the template are ${room.settings.customRules.length} characters, over this room's limit of ${room.settings.briefTextLimit}; kept as they are, but the next edit has to fit.`);
         this.saveRooms();
         return { room, notices };
     }
@@ -492,12 +524,28 @@ export class Hub extends EventEmitter {
         this.update = update;
         this.emit("event", { type: "update", update });
     }
+    async saveLook(raw, options) {
+        const saved = await this.looks.save(raw, options);
+        this.emit("event", { type: "looks", looks: this.looks.list() });
+        return saved;
+    }
+    removeLook(id) {
+        const removed = this.looks.remove(id);
+        if (!removed)
+            return false;
+        if (this.settings.appearance?.look === id || this.settings.appearance?.custom?.[id]) {
+            this.updateSettings({ appearance: { look: this.settings.appearance.look === id ? DEFAULT_APPEARANCE.look : this.settings.appearance.look, custom: { [id]: null } } });
+        }
+        this.emit("event", { type: "looks", looks: this.looks.list() });
+        return true;
+    }
     snapshot() {
         return {
             settings: this.settings,
             update: this.update,
             recipes: listRecipes().map(({ build: _b, ...r }) => r),
             skills: this.skills.list(),
+            looks: this.looks.list(),
             roomDefaults: { ...DEFAULT_ROOM_SETTINGS, ...this.settings.roomDefaults },
             rooms: [...this.rooms.values()].map((room) => room.snapshot()),
             openRooms: [...this.openRooms],
@@ -518,6 +566,7 @@ export class Hub extends EventEmitter {
         rmSync(join(this.dataDir, "rooms"), { recursive: true, force: true });
         rmSync(this.roomsPath(), { force: true });
         rmSync(this.skills.dir, { recursive: true, force: true });
+        rmSync(this.looks.dir, { recursive: true, force: true });
         mkdirSync(join(this.dataDir, "rooms"), { recursive: true });
         mkdirSync(this.skills.dir, { recursive: true });
         this.skills.list();

package/dist/jsonrpc.js

@@ -11,7 +11,9 @@ export class RemoteError extends Error {
     rpc;
     method;
     constructor(rpc, method) {
-        super(`${method} failed: ${rpc.message} (code ${rpc.code})`);
+        const data = rpc.data;
+        const detail = typeof data === "string" ? data : data && typeof data === "object" && typeof data.details === "string" ? data.details : "";
+        super(`${method} failed: ${rpc.message}${detail ? `: ${detail}` : ""} (code ${rpc.code})`);
         this.rpc = rpc;
         this.method = method;
     }