viberoom 0.8.0 → 0.9.1

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

@@ -1,9 +1,10 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/assets/icon-256.png" width="128" height="128" alt="viberoom">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/viberoom-dark.png">
+    <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/readme/viberoom.png" width="620" alt="viberoom">
+  </picture>
 </p>
 
-<h1 align="center">viberoom</h1>
-
 <p align="center"><strong>One chat, many coding agents.</strong><br>
 Open a room, summon the agents you already have, give each one a role, and let them work it out with you and with each other.</p>
 
@@ -14,16 +15,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">
+  <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><br>
+  <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.webp" 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.webp" 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.webp" 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.webp" 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.webp" 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.webp" 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 +115,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 +130,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,22 +152,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.
-
-## Let them design the look
-
-A look (how the window is drawn: colours, light, corners, fonts) is data, not code: which of the shipped
-looks it starts from, a few hues, and what it wants otherwise. Ask a vibemate for "a warm paper look for
-long evenings" and it has a built-in skill on what makes a look good and four tools: read every token
-with what it means, check a draft (the hub measures whether the words read on their paper and reports
-the numbers, since a vibemate cannot see colours), save the look among your own (Settings → Appearance,
-after the shipped ones, with your name on it), or propose wearing it as a card you can try on first. Your
-own looks are files under your data folder: export one to share it, import one someone sent you, delete
-one you are done with. A shipped look can only be fine-tuned, never rewritten.
+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>
 
@@ -109,8 +167,8 @@ one you are done with. A shipped look can only be fine-tuned, never rewritten.
 
 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>
 
@@ -122,7 +180,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>
@@ -152,10 +210,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.
@@ -165,11 +224,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>
 
@@ -186,7 +246,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>
 
@@ -195,6 +255,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

@@ -431,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)}`);
@@ -450,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 };
     }

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;
     }

package/dist/main.js

@@ -19,6 +19,7 @@ function parseArgs(argv) {
         port: 4810,
         portGiven: false,
         dataDir: process.env.VIBEROOM_DATA_DIR ? resolve(process.env.VIBEROOM_DATA_DIR) : resolve(homedir(), ".viberoom"),
+        dataDirGiven: !!process.env.VIBEROOM_DATA_DIR,
         name: undefined,
         open: true,
         browser: false,
@@ -43,6 +44,7 @@ function parseArgs(argv) {
                 break;
             case "--data-dir":
                 options.dataDir = resolve(next());
+                options.dataDirGiven = true;
                 break;
             case "--open":
                 options.open = true;
@@ -271,7 +273,8 @@ async function runHub(options, log, info) {
             }
         }
     }
-    migrateLegacyData(options.dataDir, log);
+    if (!options.dataDirGiven)
+        migrateLegacyData(options.dataDir, log);
     const hub = new Hub(options.dataDir, log, options.name);
     if (options.name && hub.settings.humanName !== options.name)
         hub.updateSettings({ humanName: options.name });

package/dist/persona.js

@@ -29,7 +29,8 @@ export const ROOM_SETTINGS_SPEC = {
     replayAfterRestart: { kind: "integer", min: 0, max: 200, default: 10, brief: false, agent: true, doc: "Messages replayed to a vibemate whose session restarts." },
     backlogCap: { kind: "integer", min: 1, max: 1000, default: 50, brief: false, agent: true, doc: "Most missed messages a vibemate reads on its next turn; older ones are dropped with a note." },
     showVendorInRoster: { kind: "boolean", default: false, brief: true, agent: true, doc: "The roster in the brief names each vibemate's vendor (Claude, Codex, ...)." },
-    customRules: { kind: "text", max: 4000, default: "", brief: true, agent: true, doc: "The room rules, one per line; every vibemate gets them under 'Room rules (set by the human)'. @Name inside a rule is a live reference." },
+    briefTextLimit: { kind: "integer", min: 500, max: 32_000, default: 8000, brief: false, agent: true, doc: "Most characters a vibio (a vibemate's role) or the room rules may have; both go into every brief. Text over it is refused with the numbers, never cut." },
+    customRules: { kind: "text", max: 32_000, default: "", brief: true, agent: true, doc: "The room rules, one per line, at most briefTextLimit characters; every vibemate gets them under 'Room rules (set by the human)'. @Name inside a rule is a live reference." },
     refereeAction: { kind: "enum", values: ["next-header", "retry-hidden"], default: "next-header", brief: false, agent: true, doc: "On a mechanical violation (wrong language, too long): remind in the next header, or hold the reply and ask for a corrected one in a hidden turn." },
     turnTaking: { kind: "enum", values: ["parallel", "one-at-a-time"], default: "parallel", brief: false, agent: true, doc: "parallel: every addressed vibemate answers at once; one-at-a-time: one speaks, the others queue and see the earlier replies first." },
     waitWhileHumanTypes: { kind: "boolean", default: true, brief: false, agent: true, doc: "A vibemate about to start a turn waits while the human is typing." },
@@ -77,8 +78,12 @@ export function coerceSetting(key, raw) {
                 throw new Error(`${key} must be ${spec.values.join(" or ")}`);
             return value;
         }
-        case "text":
-            return String(raw).slice(0, spec.max);
+        case "text": {
+            const value = String(raw);
+            if (value.length > spec.max)
+                throw new Error(`${key} is ${value.length} characters; at most ${spec.max}`);
+            return value;
+        }
         case "language": {
             if (raw && typeof raw === "object") {
                 const o = raw;

package/dist/recipes.js

@@ -1,12 +1,21 @@
 // viberoom - Copyright (c) 2026 Todor Rusev - AGPL-3.0-or-later; see LICENSE
 import { execSync } from "node:child_process";
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, realpathSync } from "node:fs";
 import { homedir } from "node:os";
 import { createRequire } from "node:module";
-import { dirname, join } from "node:path";
+import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { loginState } from "./agent-health.js";
 const isWindows = process.platform === "win32";
+const ICON_VERSION = (() => {
+    try {
+        return String(createRequire(import.meta.url)("../package.json").version ?? "0");
+    }
+    catch {
+        return "0";
+    }
+})();
+const iconUrl = (id) => `/vendor-icons/${id}.svg?v=${ICON_VERSION}`;
 function resolvePackageEntry(packageName, relativeEntry) {
     try {
         const require = createRequire(import.meta.url);
@@ -141,6 +150,46 @@ function resolveClaudeCode() {
 function resolveCodex() {
     return resolveGlobalNpmBin("codex") ?? resolveOnPath(["codex"]);
 }
+function realHome() {
+    try {
+        return realpathSync(homedir());
+    }
+    catch {
+        return null;
+    }
+}
+function resolveGrok() {
+    const exe = isWindows ? "grok.exe" : "grok";
+    const home = realHome();
+    const dirs = [process.env.GROK_BIN_DIR, process.env.GROK_HOME && join(process.env.GROK_HOME, "bin"), join(homedir(), ".grok", "bin"), home && join(home, ".grok", "bin")];
+    for (const dir of dirs)
+        if (dir && existsSync(join(dir, exe)))
+            return join(dir, exe);
+    const onPath = resolveOnPath(["grok"]);
+    return onPath && !/\.(cmd|bat|ps1)$/i.test(onPath) ? onPath : null;
+}
+function resolveHermes() {
+    const hermesHome = process.env.HERMES_HOME || (isWindows ? process.env.LOCALAPPDATA && join(process.env.LOCALAPPDATA, "hermes") : join(homedir(), ".hermes"));
+    const scripts = isWindows ? "Scripts" : "bin";
+    const exe = (name) => (isWindows ? `${name}.exe` : name);
+    const candidates = [];
+    if (hermesHome) {
+        const venv = join(hermesHome, "hermes-agent", "venv");
+        candidates.push({ command: join(venv, scripts, exe("hermes-acp")), args: [] }, { command: join(venv, scripts, exe("hermes")), args: ["acp"] });
+        if (isWindows)
+            candidates.push({ command: join(hermesHome, "bin", "hermes-acp.exe"), args: [] }, { command: join(hermesHome, "bin", "hermes.exe"), args: ["acp"] });
+    }
+    if (!isWindows) {
+        candidates.push({ command: join(homedir(), ".local", "bin", "hermes"), args: ["acp"] }, { command: "/usr/local/lib/hermes-agent/venv/bin/hermes-acp", args: [] }, { command: "/usr/local/bin/hermes", args: ["acp"] });
+    }
+    for (const candidate of candidates)
+        if (existsSync(candidate.command))
+            return candidate;
+    const onPath = resolveOnPath(["hermes-acp", "hermes"]);
+    if (onPath && !/\.(cmd|bat|ps1)$/i.test(onPath))
+        return { command: onPath, args: /^hermes-acp/i.test(basename(onPath)) ? [] : ["acp"] };
+    return null;
+}
 const vendorDir = join(dirname(fileURLToPath(import.meta.url)), "..", "vendor", "acp");
 const claudeAdapter = join(vendorDir, "claude-agent-acp", "dist", "index.js");
 const codexAdapter = join(vendorDir, "codex-acp", "dist", "index.js");
@@ -151,12 +200,14 @@ const geminiEntry = resolvePackageEntry("@google/gemini-cli", join("bundle", "ge
 const cursorAgent = resolveCursorAgent();
 const openCodeExe = resolveOpenCode();
 const copilotExe = resolveCopilot();
+const grokExe = resolveGrok();
+const hermesLaunch = resolveHermes();
 const recipes = [
     {
         id: "claude",
         label: "Claude (claude-agent-acp)",
         vendor: "Claude",
-        icon: "/vendor-icons/claude.svg",
+        icon: iconUrl("claude"),
         tested: true,
         note: "Adapter around the Claude Agent SDK, driving the Claude Code installed on this machine with its login and settings.",
         modelPresets: ["haiku", "sonnet", "opus", "default"],
@@ -182,7 +233,7 @@ const recipes = [
         id: "codex",
         label: "Codex (codex-acp)",
         vendor: "Codex",
-        icon: "/vendor-icons/codex.svg",
+        icon: iconUrl("codex"),
         tested: true,
         note: "Adapter around the Codex App Server of the Codex CLI installed on this machine; uses its login (~/.codex) or CODEX_API_KEY. Mode 'agent' edits the working directory without asking; 'read-only' for a chat-only participant.",
         modelPresets: ["gpt-5.4-mini", "gpt-5.5", "gpt-5.6-sol", "gpt-5.6-terra", "gpt-5.6-luna"],
@@ -208,7 +259,7 @@ const recipes = [
         id: "gemini",
         label: "Gemini CLI (gemini --acp)",
         vendor: "Gemini",
-        icon: "/vendor-icons/gemini.svg",
+        icon: iconUrl("gemini"),
         tested: true,
         note: "Native ACP mode of the globally installed Gemini CLI; uses the machine's Gemini login / API key. Exposes no config options over ACP: the model is fixed at launch (--model).",
         modelPresets: ["gemini-3.8-flash", "gemini-3.7-flash"],
@@ -235,7 +286,7 @@ const recipes = [
         id: "cursor",
         label: "Cursor (cursor-agent acp)",
         vendor: "Cursor",
-        icon: "/vendor-icons/cursor.svg",
+        icon: iconUrl("cursor"),
         tested: true,
         note: "Cursor's CLI agent in native ACP mode; uses the machine's Cursor login (agent login) or CURSOR_API_KEY. Mode 'agent' edits without asking; 'ask' is read-only Q&A. Models: see the session settings after joining.",
         modelPresets: [],
@@ -261,7 +312,7 @@ const recipes = [
         id: "opencode",
         label: "OpenCode (opencode acp)",
         vendor: "OpenCode",
-        icon: "/vendor-icons/opencode.svg",
+        icon: iconUrl("opencode"),
         tested: false,
         note: "The open-source coding agent in native ACP mode; the model list comes from the providers configured in OpenCode (opencode providers). Mode 'plan' is read-only; 'build' edits the working directory (OpenCode's own permission config decides what still asks; the questions arrive here).",
         modelPresets: [],
@@ -286,7 +337,7 @@ const recipes = [
         id: "copilot",
         label: "GitHub Copilot (copilot --acp)",
         vendor: "Copilot",
-        icon: "/vendor-icons/copilot.svg",
+        icon: iconUrl("copilot"),
         tested: false,
         note: "GitHub Copilot CLI in native ACP mode; uses the machine's Copilot login (copilot login). Session modes agent / plan / autopilot; the 'allow_all' option decides whether tool calls ask for permission. Exposes no model option over ACP: the model is fixed at launch (--model, e.g. auto).",
         modelPresets: ["auto"],
@@ -312,6 +363,57 @@ const recipes = [
             args: ["--acp", ...(model ? ["--model", model] : [])],
         }),
     },
+    {
+        id: "grok",
+        label: "Grok Build (grok agent stdio)",
+        vendor: "Grok",
+        icon: iconUrl("grok"),
+        tested: true,
+        note: "xAI's coding agent in its native ACP mode; uses this machine's Grok login (grok login) or XAI_API_KEY. It reports no session modes over ACP, so the mode is a launch flag: 'ask-first' asks before every tool call, 'always-approve' never does; a change restarts the session with its notes kept. Model and reasoning effort are session options (the model also goes on the launch command).",
+        modelPresets: ["grok-4.6", "grok-4.5"],
+        defaultModel: null,
+        effortPresets: ["xhigh", "high", "medium", "low"],
+        defaultEffort: null,
+        modePresets: ["ask-first", "always-approve"],
+        defaultMode: "ask-first",
+        bypassMode: "always-approve",
+        unavailableReason: grokExe ? null : "Grok Build not found",
+        installedAt: grokExe,
+        installHint: "curl -fsSL https://x.ai/cli/install.sh | bash (Windows: irm https://x.ai/cli/install.ps1 | iex), or npm install -g @xai-official/grok; then grok login",
+        loginCommand: "grok login",
+        login: { env: ["XAI_API_KEY", "GROK_DEPLOYMENT_KEY"], files: [".grok/auth.json"], command: "grok login" },
+        loginState: "unknown",
+        modeAtLaunch: true,
+        build: ({ model, mode }) => ({
+            command: grokExe ?? "",
+            args: ["agent", ...(model ? ["-m", model] : []), ...(mode === "always-approve" ? ["--always-approve"] : []), "stdio"],
+        }),
+    },
+    {
+        id: "hermes",
+        label: "Hermes Agent (hermes acp)",
+        vendor: "Hermes",
+        icon: iconUrl("hermes"),
+        tested: true,
+        note: "Nous Research's open-source agent in its native ACP mode; the provider and model are the ones configured in Hermes (hermes model). Mode 'default' asks before edits, 'accept_edits' auto-allows workspace and /tmp edits, 'dont_ask' auto-allows file edits except sensitive paths; a tool call that still needs permission arrives here with Hermes' own choices: once, this session, or always.",
+        modelPresets: [],
+        defaultModel: null,
+        effortPresets: [],
+        defaultEffort: null,
+        modePresets: ["default", "accept_edits", "dont_ask"],
+        defaultMode: "default",
+        bypassMode: "dont_ask",
+        unavailableReason: hermesLaunch ? null : "Hermes Agent not found",
+        installedAt: hermesLaunch?.command ?? null,
+        installHint: "curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash (Windows: iex (irm https://hermes-agent.nousresearch.com/install.ps1)), then hermes model",
+        loginCommand: "hermes model",
+        login: { env: [], files: [], command: "hermes model" },
+        loginState: "unknown",
+        build: () => ({
+            command: hermesLaunch?.command ?? "",
+            args: hermesLaunch?.args ?? [],
+        }),
+    },
 ];
 const fakeAgent = process.env.VIBEROOM_FAKE_AGENT;
 if (fakeAgent) {

package/dist/room-design.js

@@ -1,11 +1,11 @@
 // viberoom - Copyright (c) 2026 Todor Rusev - AGPL-3.0-or-later; see LICENSE
 import { AGENT_SETTINGS, DEFAULT_ROOM_SETTINGS, NAME_PATTERN, ROOM_SETTINGS_SPEC, SILENT_MARKER, REQUEST_BRIEF_MARKER, buildBrief, coerceSetting } from "./persona.js";
 export const TAGLINE_MAX = 80;
-export const ROLE_MAX = 4000;
+export const ROLE_MAX = 8000;
 export const AVATAR_MAX = 8;
 export const RULES_SOFT_MAX = 12;
 export const ROLE_SOFT_MAX = 1200;
-export const RULES_NEAR_LIMIT = 3000;
+export const RULES_NEAR_LIMIT = 0.75;
 export function ruleLines(customRules) {
     return customRules
         .split(/\r?\n/)
@@ -57,6 +57,7 @@ export function lintRoomDesign(design, context) {
         if (!vibemates.length)
             error("template-no-vibemates", "a template needs at least one vibemate");
     }
+    const roleMax = raw.briefTextLimit !== undefined ? settings.briefTextLimit : context.briefTextLimit ?? settings.briefTextLimit ?? ROLE_MAX;
     const seen = new Map();
     const touched = context.changedVibemates ? new Set(context.changedVibemates.map((n) => n.trim().toLowerCase())) : null;
     for (const [i, v] of vibemates.entries()) {
@@ -79,8 +80,8 @@ export function lintRoomDesign(design, context) {
             error("tagline-too-long", `${who}: the tagline is at most ${TAGLINE_MAX} characters (it is the one line the others see)`);
         else if (soft && !(v?.tagline ?? "").trim())
             warn("vibemate-no-tagline", `${who} has no tagline: the others read it in the roster to know what this one leans to`);
-        if ((v?.role ?? "").length > ROLE_MAX)
-            error("role-too-long", `${who}: the role is at most ${ROLE_MAX} characters`);
+        if ((v?.role ?? "").length > roleMax)
+            error("role-too-long", `${who}: the role is ${v.role.length} characters; the limit is ${roleMax} (the briefTextLimit setting)`);
         else if (soft && !(v?.role ?? "").trim())
             warn("vibemate-no-role", `${who} has no role: without one it is the agent's default self, not a character`);
         else if (soft && (v.role ?? "").length > ROLE_SOFT_MAX)
@@ -109,8 +110,10 @@ export function lintRoomDesign(design, context) {
     const rules = ruleLines(settings.customRules);
     if (rules.length > RULES_SOFT_MAX)
         warn("too-many-rules", `${rules.length} rules: every vibemate carries them on every turn; ${RULES_SOFT_MAX} is a full protocol, longer belongs in a skill`);
-    if (settings.customRules.length > RULES_NEAR_LIMIT)
-        warn("rules-near-limit", `the rules are ${settings.customRules.length} characters; the hub stores at most 4000`);
+    if (settings.customRules.length > roleMax)
+        error("rules-too-long", `the rules are ${settings.customRules.length} characters; the limit is ${roleMax} (the briefTextLimit setting)`);
+    else if (settings.customRules.length > roleMax * RULES_NEAR_LIMIT)
+        warn("rules-near-limit", `the rules are ${settings.customRules.length} characters; the limit is ${roleMax}`);
     for (const rule of rules) {
         for (const m of BRIEF_MECHANICS)
             if (m.pattern.test(rule))

package/dist/room.js

@@ -21,6 +21,7 @@ import { applyVibemateChanges, diffSettings, lintRoomDesign, ruleLines } from ".
 import { BRIEF_AFFECTING_SETTINGS, AGENT_SETTINGS, coerceSetting, describeSettings, DEFAULT_ROOM_SETTINGS, ROOM_SETTINGS_SPEC, REQUEST_BRIEF_MARKER, NAME_PATTERN, SILENT_MARKER, buildBrief, buildHeader, composeCorrectionPrompt, composePrompt, countSentences, ensureDir, } from "./persona.js";
 import { Transcript } from "./log.js";
 const SKILL_TOOL_READY_MS = 5000;
+const AUTH_WAIT_MS = 8000;
 const COLORS = ["#6d5dfc", "#16a34a", "#d97706", "#dc2626", "#0891b2", "#be185d", "#4d7c0f", "#7c3aed"];
 const MENTION_PATTERN = /@([\p{L}\p{N}][\p{L}\p{N}_-]*)/gu;
 const RULE_REF_TOKEN = /@\{p:([^}]+)\}/g;
@@ -113,7 +114,7 @@ export class Room extends EventEmitter {
     restore(stored) {
         for (const s of stored) {
             if (!s.agentType) {
-                this.addUnstaffed({ name: s.name, tagline: s.tagline, role: s.role, avatar: s.avatar, skills: s.skills, color: s.color, id: s.id });
+                this.addUnstaffed({ name: s.name, tagline: s.tagline, role: s.role, avatar: s.avatar, skills: s.skills, color: s.color, id: s.id, textCheck: "keep" });
                 continue;
             }
             const recipe = getRecipe(s.agentType);
@@ -505,14 +506,8 @@ export class Room extends EventEmitter {
         participant.sessionId = undefined;
         this.restoredSeen.set(id, this.seq);
         this.push({ type: "participant", participant });
-        if (!online) {
-            participant.statusDetail = withNotes ? `${why}; a reconnect starts it with its notes` : `${why}; a reconnect starts it with an empty head`;
-            const comesBack = withNotes ? "it comes back with its notes" : "it comes back knowing nothing from before";
-            this.postSystem(options.reason ? `${participant.name} was respawned while offline (${why}): ${comesBack}.` : `${participant.name} was respawned while offline: ${comesBack}.`);
-            this.push({ type: "participant", participant });
-            this.log.info(`respawn of ${participant.name} (offline): stored session dropped`);
-            return participant;
-        }
+        if (!online)
+            this.log.info(`respawn of ${participant.name} (offline): stored session dropped, starting it now`);
         await this.reconnect(id, memory
             ? { mode: "replay", replay, memory: withNotes, reason: `${why}; it comes back with ${withNotes ? "its notes and " : ""}the last ${replay} messages` }
             : { mode: "replay", replay: 0, reason: `${why}, it remembers nothing from before` });
@@ -676,7 +671,7 @@ export class Room extends EventEmitter {
                 continue;
             let value = coerceSetting(key, patch[key]);
             if (key === "customRules") {
-                const resolved = this.resolveRuleReferences(value);
+                const resolved = this.resolveRuleReferences(this.guardBriefText("The room rules text", value, "refuse", next.briefTextLimit));
                 unknownRefs = resolved.unknown;
                 value = resolved.stored;
             }
@@ -699,6 +694,14 @@ export class Room extends EventEmitter {
         }
         return this.settings;
     }
+    guardBriefText(what, text, check = "refuse", limit = this.settings.briefTextLimit) {
+        if (check === "keep" || text.length <= limit)
+            return text;
+        if (check === "refuse")
+            throw new Error(`${what} is ${text.length} characters; this room's limit is ${limit} (the briefTextLimit setting). Shorten it, move the instructions into a skill, or raise the limit.`);
+        this.postSystem(`${what} is ${text.length} characters, over this room's limit of ${limit}; kept as it is, but the next edit has to fit (shorten it or raise briefTextLimit).`, "human", false, { tone: "attention" });
+        return text;
+    }
     updatePersona(id, patch) {
         const participant = this.participants.get(id);
         const runtime = this.runtimes.get(id);
@@ -727,7 +730,7 @@ export class Room extends EventEmitter {
             changed.push("tagline");
         }
         if (patch.role !== undefined && patch.role.trim() !== (participant.role ?? "")) {
-            participant.role = patch.role.trim().slice(0, 4000);
+            participant.role = this.guardBriefText(`${participant.name}'s vibio`, patch.role.trim());
             changed.push("role");
         }
         if (patch.avatar !== undefined) {
@@ -786,7 +789,7 @@ export class Room extends EventEmitter {
             return cached;
         const cwd = ensureDir(join(this.dataDir, ".probe"));
         const log = this.log.child(`probe:${recipeId}`);
-        const launch = recipe.build({ model: null });
+        const launch = recipe.build({ model: null, mode: null });
         const agent = new AcpAgent({ ...launch, cwd }, {
             onSessionUpdate: () => undefined,
             onPermissionRequest: async () => ({ outcome: { outcome: "cancelled" } }),
@@ -798,7 +801,7 @@ export class Room extends EventEmitter {
             const info = await Promise.race([
                 (async () => {
                     const init = await agent.initialize({ name: "viberoom", version: "0.2.0" });
-                    const session = await this.openSession(agent, cwd, log);
+                    const session = await this.openSession(agent, cwd, log, [], recipe);
                     const result = {
                         recipeId,
                         agentInfo: { name: init.agentInfo?.name ?? null, version: init.agentInfo?.version ?? null },
@@ -806,6 +809,7 @@ export class Room extends EventEmitter {
                         modes: session.modes ?? null,
                         configOptions: session.configOptions ?? [],
                         modelAtLaunch: !!recipe.modelAtLaunch,
+                        modeAtLaunch: !!recipe.modeAtLaunch,
                         discoveredAt: Date.now(),
                         durationMs: 0,
                     };
@@ -858,7 +862,7 @@ export class Room extends EventEmitter {
             turns: 0,
             color: options.color ?? COLORS[this.colorIndex++ % COLORS.length],
             tagline: (options.tagline ?? "").trim().slice(0, 80),
-            role: (options.role ?? "").trim().slice(0, 4000),
+            role: this.guardBriefText(`${name}'s vibio`, (options.role ?? "").trim(), options.textCheck),
             avatar: (options.avatar ?? "").trim().slice(0, 8) || undefined,
             replyDelay: options.replyDelay === undefined || options.replyDelay === null ? undefined : Math.max(0, Math.min(120, Number(options.replyDelay) || 0)),
             skills: normalizeSkillList(options.skills ?? undefined),
@@ -888,7 +892,7 @@ export class Room extends EventEmitter {
             turns: 0,
             color: input.color ?? COLORS[this.colorIndex++ % COLORS.length],
             tagline: (input.tagline ?? "").trim().slice(0, 80),
-            role: (input.role ?? "").trim().slice(0, 4000),
+            role: this.guardBriefText(`${name}'s vibio`, (input.role ?? "").trim(), input.textCheck),
             avatar: (input.avatar ?? "").trim().slice(0, 8) || undefined,
             skills: normalizeSkillList(input.skills),
             violations: 0,
@@ -938,7 +942,7 @@ export class Room extends EventEmitter {
         const name = participant.name;
         const log = this.log.child(name);
         const cwd = ensureDir(this.dir);
-        const spec = recipe.build({ model: launch.model });
+        const spec = recipe.build({ model: launch.model, mode: launch.mode });
         const transcript = new Transcript(join(this.dataDir, "transcripts"), name);
         log.info(`spawning ${spec.command} ${spec.args.join(" ")} (cwd ${cwd}); transcript ${transcript.path}`);
         const stderrTail = [];
@@ -990,7 +994,7 @@ export class Room extends EventEmitter {
                 }
             }
             if (!session)
-                session = await this.openSession(agent, cwd, log, mcpServers);
+                session = await this.openSession(agent, cwd, log, mcpServers, recipe);
             participant.sessionId = session.sessionId;
             participant.sessionOrigin = origin;
             const storedSeen = this.restoredSeen.get(id);
@@ -1044,10 +1048,15 @@ export class Room extends EventEmitter {
             const warnings = await this.applyConfig(runtime, participant, {
                 model: recipe.modelAtLaunch ? null : launch.model,
                 effort: launch.effort,
-                mode: launch.mode,
+                mode: recipe.modeAtLaunch ? null : launch.mode,
             });
             if (recipe.modelAtLaunch && launch.model)
                 participant.model = launch.model;
+            if (recipe.modeAtLaunch) {
+                if (!participant.modes?.length)
+                    participant.modes = recipe.modePresets.map((id) => ({ id, name: id }));
+                participant.mode = launch.mode ?? recipe.defaultMode ?? participant.mode;
+            }
             for (const w of warnings)
                 this.notice(`${name}: ${w}`, "warn");
             participant.status = "idle";
@@ -1148,6 +1157,16 @@ export class Room extends EventEmitter {
         const participant = this.participants.get(id);
         if (!runtime || !participant)
             throw new Error("no such agent (offline?)");
+        const recipe = getRecipe(participant.agentType ?? "");
+        if (recipe?.modeAtLaunch && configId === "mode") {
+            if (!recipe.modePresets.includes(String(value)))
+                throw new Error(`${participant.name}: no mode "${value}" (${recipe.modePresets.join(", ")})`);
+            participant.launch = { model: participant.launch?.model ?? null, effort: participant.launch?.effort ?? null, mode: String(value) };
+            participant.mode = String(value);
+            this.push({ type: "participant", participant });
+            await this.respawnAgent(id, { memory: true, reason: "its mode changed" });
+            return;
+        }
         const hasOption = participant.configOptions?.some((o) => o.id === configId);
         if (!hasOption && configId === "mode" && participant.modes?.some((m) => m.id === value)) {
             await runtime.agent.setMode(runtime.sessionId, String(value));
@@ -1349,6 +1368,7 @@ export class Room extends EventEmitter {
             humanName: this.settings.humanName,
             roomName: this.settings.name,
             base: kind === "room" ? { ...this.settings, customRules: this.renderRuleReferences(this.settings.customRules) } : undefined,
+            briefTextLimit: this.settings.briefTextLimit,
             knownSkills: this.skills ? this.skills.library.list().map((s) => s.name) : undefined,
         };
     }
@@ -2577,7 +2597,7 @@ export class Room extends EventEmitter {
             this.notice(`${participant.name}: agent process exited.`, "error");
         }
     }
-    async openSession(agent, cwd, log, mcpServers = []) {
+    async openSession(agent, cwd, log, mcpServers = [], recipe) {
         try {
             return await agent.newSession(cwd, mcpServers);
         }
@@ -2585,12 +2605,22 @@ export class Room extends EventEmitter {
             if (!isAuthRequired(error) || !agent.authMethods.length)
                 throw error;
             log.info(`session/new needs authentication: ${describeError(error)}`);
+            if (recipe?.loginState === "missing")
+                throw new Error(`authentication required; log in with the agent's own CLI first${recipe.loginCommand ? ` (${recipe.loginCommand})` : ""}`);
         }
         const failures = [];
         for (const method of agent.authMethods) {
+            if (method.type === "terminal") {
+                failures.push(`${method.id}: needs a terminal`);
+                continue;
+            }
             log.info(`authenticate with "${method.id}"${method.name ? ` (${method.name})` : ""}`);
             try {
-                await agent.authenticate(method.id);
+                const done = await Promise.race([agent.authenticate(method.id).then(() => true), delay(AUTH_WAIT_MS).then(() => false)]);
+                if (!done) {
+                    failures.push(`${method.id}: no answer in ${AUTH_WAIT_MS / 1000} s (a sign-in that needs you)`);
+                    continue;
+                }
                 return await agent.newSession(cwd, mcpServers);
             }
             catch (error) {
@@ -2667,7 +2697,7 @@ export class Room extends EventEmitter {
         participant.mode = pick("mode") ?? participant.mode;
     }
     failStart(participant, error, fresh, stderr = []) {
-        participant.statusDetail = error instanceof Error ? error.message : String(error);
+        participant.statusDetail = describeError(error);
         const recipe = getRecipe(participant.agentType ?? "");
         participant.trouble = classifyStartFailure({
             error: participant.statusDetail,
@@ -2826,7 +2856,11 @@ function isAuthRequired(error) {
     return error instanceof Error && /auth/i.test(error.message);
 }
 function describeError(error) {
-    return error instanceof Error ? error.message : String(error);
+    if (!(error instanceof Error))
+        return String(error);
+    const data = error.rpc?.data ?? error.data;
+    const detail = typeof data === "string" ? data : data && typeof data === "object" && typeof data.details === "string" ? data.details : "";
+    return detail && !error.message.includes(detail) ? `${error.message}: ${detail}` : error.message;
 }
 function looksSilent(text) {
     const t = text.trim().toLowerCase();

package/dist/server.js

@@ -34,6 +34,8 @@ const STATIC_FILES = {
     "/vendor-icons/cursor.svg": { file: "vendors/cursor.svg", type: "image/svg+xml", dir: "assets" },
     "/vendor-icons/opencode.svg": { file: "vendors/opencode.svg", type: "image/svg+xml", dir: "assets" },
     "/vendor-icons/copilot.svg": { file: "vendors/copilot.svg", type: "image/svg+xml", dir: "assets" },
+    "/vendor-icons/grok.svg": { file: "vendors/grok.svg", type: "image/svg+xml", dir: "assets" },
+    "/vendor-icons/hermes.svg": { file: "vendors/hermes.svg", type: "image/svg+xml", dir: "assets" },
     "/vendor/mermaid.min.js": { file: "mermaid/dist/mermaid.min.js", type: "text/javascript; charset=utf-8", dir: "node_modules" },
     "/vendor/marked.umd.js": { file: "marked/lib/marked.umd.js", type: "text/javascript; charset=utf-8", dir: "node_modules" },
     "/vendor/prism.js": { file: "prismjs/prism.js", type: "text/javascript; charset=utf-8", dir: "node_modules" },
@@ -146,7 +148,7 @@ export function startServer(hub, port, log, info, onShutdownRequest, onRestartRe
         if (req.method === "GET" && STATIC_FILES[path]) {
             const entry = STATIC_FILES[path];
             const body = await readFile(staticPath(entry));
-            res.writeHead(200, { "Content-Type": entry.type, "Cache-Control": entry.dir === "ui" || !entry.dir ? "no-cache" : "public, max-age=3600" });
+            res.writeHead(200, { "Content-Type": entry.type, "Cache-Control": entry.dir === "node_modules" ? "public, max-age=3600" : "no-cache" });
             res.end(body);
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viberoom",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "viberoom: group chat rooms for a human and several coding agents over the Agent Client Protocol",
   "type": "module",
   "engines": {

package/ui/app.css

@@ -712,6 +712,9 @@ table.csv tbody tr:nth-child(even) td { background: var(--table-stripe); }
 .section textarea { resize: vertical; min-height: 76px; height: auto; padding: 10px 14px; line-height: 1.5; }
 .section input::placeholder, .section textarea::placeholder { color: var(--placeholder); font-weight: 600; }
 .section .hint { margin: -4px 0 10px; }
+.field .count { font-variant-numeric: tabular-nums; color: var(--muted); }
+.field .count::before { content: " · "; }
+.field .count.over { color: var(--danger); font-weight: 800; }
 .three-inline { display: grid; grid-template-columns: 1fr 1fr 1fr; gap: 6px; }
 .three-inline label { margin-bottom: 4px; }
 .rc-num { width: 76px; display: inline-flex; }

package/ui/app.js

@@ -685,28 +685,34 @@
     }
     if (!found.size) return;
     const paths = await Promise.all([...found.keys()].map((token) => resolveInRoom(room.id, token)));
-    let linked = false;
+    const resolved = new Map();
     [...found.keys()].forEach((token, i) => {
       const full = paths[i] && paths[i].path;
-      if (!full) return;
-      const byNode = new Map();
-      for (const hit of found.get(token)) byNode.set(hit.node, [...(byNode.get(hit.node) || []), hit]);
-      for (const [node, hits] of byNode) {
-        if (!node.isConnected) continue;
-        for (const hit of hits.sort((a, b) => b.index - a.index)) {
-          const after = node.splitText(hit.index);
-          after.nodeValue = after.nodeValue.slice(hit.length);
-          const link = document.createElement("a");
-          link.className = "open-link";
-          link.href = "#";
-          link.dataset.open = `${full}${hit.line}`;
-          link.title = `${full} (relative to the room's folder)`;
-          link.textContent = `${token}${hit.line}`;
-          node.parentNode.insertBefore(link, after);
-          linked = true;
-        }
-      }
+      if (full) resolved.set(token, full);
     });
+    if (!resolved.size) return;
+    const byNode = new Map();
+    for (const [token, hits] of found) {
+      if (!resolved.has(token)) continue;
+      for (const hit of hits) byNode.set(hit.node, [...(byNode.get(hit.node) || []), { ...hit, token }]);
+    }
+    let linked = false;
+    for (const [node, hits] of byNode) {
+      if (!node.isConnected) continue;
+      for (const hit of hits.sort((a, b) => b.index - a.index)) {
+        const full = resolved.get(hit.token);
+        const after = node.splitText(hit.index);
+        after.nodeValue = after.nodeValue.slice(hit.length);
+        const link = document.createElement("a");
+        link.className = "open-link";
+        link.href = "#";
+        link.dataset.open = `${full}${hit.line}`;
+        link.title = `${full} (relative to the room's folder)`;
+        link.textContent = `${hit.token}${hit.line}`;
+        node.parentNode.insertBefore(link, after);
+        linked = true;
+      }
+    }
     if (linked) renderPreviews(textEl, m);
   }
   function csvTable(rows) {
@@ -1106,8 +1112,8 @@
       const field = lastField;
       lastField = null;
       try {
-        await onSave();
-        if (field) {
+        const outcome = await onSave();
+        if (field && outcome !== false) {
           recentlySaved.set(field, Date.now());
           markSaved(field);
         }
@@ -1309,24 +1315,60 @@
     }, 190);
   }
   function confirmDialog(text, opts) {
+    return choiceDialog(text, opts).then((choice) => choice === "ok");
+  }
+  function choiceDialog(text, opts) {
     const o = opts || {};
     const dialog = $("#confirm-dialog");
     $("#cf-title").textContent = o.title || "Are you sure?";
     $("#cf-text").textContent = text;
-    const ok = $("#cf-ok");
-    ok.textContent = o.okLabel || "OK";
-    ok.className = `btn ${o.danger ? "danger solid" : "primary"}`;
+    const buttons = { ok: $("#cf-ok"), alt: $("#cf-alt"), cancel: $("#cf-cancel") };
+    buttons.ok.textContent = o.okLabel || "OK";
+    buttons.cancel.textContent = o.cancelLabel || "Cancel";
+    buttons.alt.textContent = o.altLabel || "";
+    buttons.alt.hidden = !o.altLabel;
+    dialog.classList.toggle("three-way", !!o.altLabel);
+    const primary = o.primary || "ok";
+    for (const [name, button] of Object.entries(buttons)) button.dataset.kind = name === primary ? (o.danger ? "danger" : "primary") : "ghost";
     return new Promise((resolve) => {
       const done = () => {
         dialog.removeEventListener("close", done);
-        resolve(dialog.returnValue === "ok");
+        resolve(dialog.returnValue === "ok" ? "ok" : dialog.returnValue === "alt" ? "alt" : "cancel");
       };
       dialog.addEventListener("close", done);
       dialog.returnValue = "";
       openDialog(dialog);
-      ok.focus();
+      buttons[primary].focus();
     });
   }
+
+  const BRIEF_TEXT_MAX = 32000;
+  function briefTextLimit(room) {
+    const r = room || currentRoom();
+    return (r && r.settings && Number(r.settings.briefTextLimit)) || 8000;
+  }
+  function bindCount(el, countEl, limitOf) {
+    if (!el || !countEl) return;
+    const tick = () => {
+      const n = (el.isContentEditable ? rulesText(el) : el.value).length;
+      const limit = limitOf();
+      countEl.textContent = `${n} / ${limit}`;
+      countEl.classList.toggle("over", n > limit);
+    };
+    el.addEventListener("input", tick);
+    tick();
+  }
+  async function fitBriefText(text, what, limit, limitInput) {
+    if (text.length <= limit) return text;
+    const needed = Math.min(BRIEF_TEXT_MAX, Math.ceil(text.length / 500) * 500);
+    const canRaise = text.length <= BRIEF_TEXT_MAX;
+    const choice = await choiceDialog(`${what} is ${text.length} characters; this room's limit is ${limit}. Cut it at the limit, or raise the limit for this room?${canRaise ? "" : ` ${BRIEF_TEXT_MAX} is the most a room can allow.`}`, { title: "Over the room's limit", okLabel: `Cut at ${limit}`, altLabel: canRaise ? `Raise the limit to ${needed}` : "", cancelLabel: "Go back", primary: "cancel" });
+    if (choice === "ok") return text.slice(0, limit);
+    if (choice !== "alt") return null;
+    if (limitInput) limitInput.value = String(needed);
+    else await post(roomApi("/settings"), { briefTextLimit: needed });
+    return text;
+  }
   function remember(key, value) {
     try {
       localStorage.setItem(`viberoom.${key}`, String(value));
@@ -2733,7 +2775,7 @@
         ${field("Vibename", `<input type="text" id="pp-name" maxlength="24" value="${esc(p.name)}">`)}
         ${field("Vibersona", `<input type="text" id="pp-tagline" maxlength="80" value="${esc(p.tagline || "")}" placeholder="a few words under the vibename">`, "Shown under the vibename.", "Everyone in the room sees it: you, and the other vibemates in their roster.")}
         ${field("Vibeface", `<div id="pp-avatar-picker"></div><input type="text" id="pp-avatar" maxlength="8" value="${esc(p.avatar || "")}" placeholder="custom emoji (optional)">`)}
-        ${field("Vibio", `<textarea id="pp-role" rows="5" maxlength="4000" placeholder="who it is, how it speaks, what it cares about">${esc(p.role || "")}</textarea>`, "Only this vibemate reads it.", "Reaches the vibemate as refreshed instructions in its brief on its next turn; its memory is kept. The other participants never see it.")}
+        ${field("Vibio", `<textarea id="pp-role" rows="5" placeholder="who it is, how it speaks, what it cares about">${esc(p.role || "")}</textarea>`, `Only this vibemate reads it.<span class="count" id="pp-role-count"></span>`, "Reaches the vibemate as refreshed instructions in its brief on its next turn; its memory is kept. The other participants never see it. A vibio and the room rules go into every brief, so the room has a limit for them (the room's settings, for geeks); text over it is never cut in silence.")}
       </div>
       ${p.trouble ? `<div class="trouble"><b>${esc(p.trouble.what)}</b><span>${esc(p.trouble.advice)}</span></div>` : ""}
       ${p.statusDetail && (p.status === "offline" || p.status === "error" || p.failedTurns) ? `<p class="hint" style="color:var(--danger);margin:0 4px 10px">${esc(p.statusDetail)}</p>` : ""}
@@ -2806,7 +2848,13 @@
     renderSkillChecks($("#pp-skills"), p.skills || []);
     bindSave($("#pp-skills-section"), () => post(roomApi(`/participants/${encodeURIComponent(p.id)}/persona`), { skills: checkedSkills($("#pp-skills")) }));
     bindSave($("#pp-timing"), () => post(roomApi(`/participants/${encodeURIComponent(p.id)}/persona`), { replyDelay: $("#pp-delay").value === "" ? null : Number($("#pp-delay").value) }));
-    bindSave($("#pp-persona"), () => post(roomApi(`/participants/${encodeURIComponent(p.id)}/persona`), { name: $("#pp-name").value, tagline: $("#pp-tagline").value, role: $("#pp-role").value, avatar: $("#pp-avatar").value }));
+    bindCount($("#pp-role"), $("#pp-role-count"), () => briefTextLimit(currentRoom()));
+    bindSave($("#pp-persona"), async () => {
+      const role = await fitBriefText($("#pp-role").value, `${p.name}'s vibio`, briefTextLimit(currentRoom()));
+      if (role === null) return false;
+      await post(roomApi(`/participants/${encodeURIComponent(p.id)}/persona`), { name: $("#pp-name").value, tagline: $("#pp-tagline").value, role, avatar: $("#pp-avatar").value });
+      return true;
+    });
     renderConfig($("#pp-config"), p, offline);
   }
 
@@ -2907,7 +2955,7 @@
         ${field("Emoji", `<div id="rp-emoji-picker"></div><input type="text" id="rp-emoji" maxlength="8" value="${esc(rs.emoji || "")}" placeholder="custom emoji (optional)">`, "A face for the room, next to its name.")}
         ${field("Topic", `<input type="text" id="rp-topic" maxlength="2000" value="${esc(rs.topic || "")}" placeholder="what this room is about (optional)">`)}
         ${field("Folder", `<span class="dir-row"><input type="text" id="rp-dir" maxlength="1000" value="${esc(room.dir)}" spellcheck="false">${UI.html("button", { label: "Browse", icon: "folder", kind: "ghost", id: "rp-dir-browse", title: "Choose a folder", hook: "browse-btn" })}</span>`, "Where the vibemates read and write. Changing it restarts them in the new folder; they replay the last messages.")}
-        <div class="field mention-host"><span class="label">Room rules${geekTip("References follow renames and note when a participant has left. Rules go into every vibemate's brief as instructions, not as routing.")}</span><div id="rp-rules" class="rules-editor" contenteditable="true" spellcheck="true" data-placeholder="e.g. Everyone listens to @Pesho, he is the manager. Keep answers under 3 sentences."></div><span class="hint">One rule per line; type @ to reference a participant.</span><div class="mention-menu inline" id="rp-rules-menu" hidden></div></div>
+        <div class="field mention-host"><span class="label">Room rules${geekTip("References follow renames and note when a participant has left. Rules go into every vibemate's brief as instructions, not as routing.")}</span><div id="rp-rules" class="rules-editor" contenteditable="true" spellcheck="true" data-placeholder="e.g. Everyone listens to @Pesho, he is the manager. Keep answers under 3 sentences."></div><span class="hint">One rule per line; type @ to reference a participant.<span class="count" id="rp-rules-count"></span></span><div class="mention-menu inline" id="rp-rules-menu" hidden></div></div>
         ${field("Language", `<input type="text" id="rp-lang" value="${esc(lang)}" placeholder="follow the human (default), or e.g. English">`)}
       </div>
       <div class="section">
@@ -2950,6 +2998,7 @@
         <label class="switch"><span class="label">Show vendor and model to other vibemates</span><input type="checkbox" id="rp-vendor" ${rs.showVendorInRoster ? "checked" : ""}></label>
         ${field("Replay last N chat messages after a reconnect", `${UI.html("number-field", { id: "rp-replay", value: String(rs.replayAfterRestart), min: 0, max: 200 })}`)}
         ${field("Missed messages a vibemate reads at most on its next turn", `${UI.html("number-field", { id: "rp-backlog", value: String(rs.backlogCap), min: 1, max: 1000 })}`, "Everything posted since its last turn counts, including while it was muted; older messages are dropped with a note in its prompt.")}
+        ${field("Most characters in a vibio or in the room rules", `${UI.html("number-field", { id: "rp-text-limit", value: String(rs.briefTextLimit ?? 8000), min: 500, max: 32000, step: 500 })}`, "Both go into every brief. Text over the limit is refused with the numbers, never cut.")}
       </div>`,
         "tools, hops, referee, briefs",
       )}
@@ -2963,6 +3012,8 @@
     wireDetailsClose();
     rulesToNodes($("#rp-rules"), room.customRulesText != null ? room.customRulesText : rs.customRules || "", room);
     attachRichMentions($("#rp-rules"), $("#rp-rules-menu"));
+    bindCount($("#rp-rules"), $("#rp-rules-count"), () => Number($("#rp-text-limit").value) || briefTextLimit(room));
+    $("#rp-text-limit").addEventListener("input", () => $("#rp-rules").dispatchEvent(new Event("input")));
     $("#rp-emoji-picker").appendChild(
       emojiGrid(ROOM_EMOJI, rs.emoji || "", (emoji) => {
         $("#rp-emoji").value = emoji;
@@ -2979,10 +3030,13 @@
         if (name.trim() !== room.name) await post(roomApi("/rename"), { name });
         const dir = $("#rp-dir").value.trim();
         if (dir && dir !== room.dir) await post(roomApi("/dir"), { dir });
+        const rules = await fitBriefText(rulesText($("#rp-rules")), "The room rules text", Number($("#rp-text-limit").value) || briefTextLimit(room), $("#rp-text-limit"));
+        if (rules === null) return false;
         await post(roomApi("/settings"), {
           emoji: $("#rp-emoji").value,
           topic: $("#rp-topic").value,
-          customRules: rulesText($("#rp-rules")).slice(0, 4000),
+          customRules: rules,
+          briefTextLimit: Number($("#rp-text-limit").value),
           language: $("#rp-lang").value.trim() || "follow-human",
           tools: $("#rp-tools").value,
           maxSentences: $("#rp-maxlen").value === "" ? null : Number($("#rp-maxlen").value),
@@ -3131,6 +3185,7 @@
             ${field("Hop limit", `${UI.html("number-field", { id: "sp-hops", value: String(d.hopLimit), min: 0, max: 10000 })}`, "How many vibemate-to-vibemate replies may follow one message of yours before the room waits for you again.")}
             ${field("Full brief every N turns", `${UI.html("number-field", { id: "sp-brief-turns", value: String(d.fullBriefEveryTurns), min: 1, max: 10000 })}`, "How often a vibemate gets the whole room brief again instead of the short header.")}
             ${field("Full brief every N tokens", `${UI.html("number-field", { id: "sp-brief-tokens", value: String(d.fullBriefEveryTokens), min: 1000, max: 10000000, step: 1000 })}`, "…or after this much new context since its last full brief, whichever comes first.")}
+            ${field("Most characters in a vibio or in the room rules", `${UI.html("number-field", { id: "sp-text-limit", value: String(d.briefTextLimit ?? 8000), min: 500, max: 32000, step: 500 })}`, "Both go into every brief. Over the limit, the text is refused with the numbers, never cut; each room can raise or lower its own.")}
             <label class="switch"><span class="label">Repeat core rules in every header<span class="hint">The short header before each turn repeats the room's core rules (who is here, how to address, how long to write).</span></span><input type="checkbox" id="sp-header-rules" ${d.headerRules ? "checked" : ""}></label>
             ${field("Tools", `<select id="sp-tools"><option value="on-request"${d.tools === "on-request" ? " selected" : ""}>Only when asked</option><option value="never"${d.tools === "never" ? " selected" : ""}>Never</option></select>`, "Whether vibemates may use their own tools (files, shell, web) without being asked to.")}
           </div>
@@ -3386,6 +3441,7 @@
             hopLimit: Number($("#sp-hops").value),
             fullBriefEveryTurns: Number($("#sp-brief-turns").value),
             fullBriefEveryTokens: Number($("#sp-brief-tokens").value),
+            briefTextLimit: Number($("#sp-text-limit").value),
             headerRules: $("#sp-header-rules").checked,
             tools: $("#sp-tools").value,
           },
@@ -3722,7 +3778,7 @@
       }
       els.invModelCustom.hidden = !info.modelAtLaunch;
       const who = info.agentInfo && info.agentInfo.name ? `${info.agentInfo.name} ${info.agentInfo.version || ""}`.trim() : recipe.vendor;
-      els.invStatus.textContent = parts.length ? `Options from ${who} (${parts.join(", ")}; ${(info.durationMs / 1000).toFixed(1)} s)` : `${who} exposes no config options over ACP${info.modelAtLaunch ? "; the model is a launch flag (built-in list, or type one)" : ""}.`;
+      els.invStatus.textContent = parts.length ? `Options from ${who} (${parts.join(", ")}; ${(info.durationMs / 1000).toFixed(1)} s)` : `${who} exposes no config options over ACP${info.modelAtLaunch ? "; the model is a launch flag (built-in list, or type one)" : ""}${info.modeAtLaunch ? "; the mode is a launch flag (a change restarts the session)" : ""}.`;
     } catch (error) {
       if (requestId !== optionsRequest) return;
       els.invStatus.textContent = `Could not read the vibemate's options (${error.message}); showing the built-in list.`;
@@ -4093,6 +4149,7 @@
       ${stpField("…or every N tokens", `${UI.html("number-field", { id: "stp-brief-tokens", value: String(st.fullBriefEveryTokens ?? 20000), min: 1000, max: 10000000, step: 1000 })}`)}
       ${stpField("Replay after a reconnect", `${UI.html("number-field", { id: "stp-replay", value: String(st.replayAfterRestart ?? 10), min: 0, max: 200 })}`)}
       ${stpField("Missed messages read at most", `${UI.html("number-field", { id: "stp-backlog", value: String(st.backlogCap ?? 50), min: 1, max: 1000 })}`)}
+      ${stpField("Most characters in a vibio or the rules", `${UI.html("number-field", { id: "stp-text-limit", value: String(st.briefTextLimit ?? 8000), min: 500, max: 32000, step: 500 })}`)}
       ${stpSwitch("Core rules in every header", "stp-header-rules", st.headerRules !== false)}
       ${stpSwitch("Show vendor and model to other vibemates", "stp-vendor", !!st.showVendorInRoster)}
     </div>`;
@@ -4114,7 +4171,7 @@
       </div></div>`).join("");
     return `
       <div class="stp-section"><h5>Room</h5>${room}</div>
-      <div class="stp-section"><h5>Room rules</h5><textarea id="stp-rules" rows="5" maxlength="4000" placeholder="one rule per line">${esc(st.customRules || "")}</textarea></div>
+      <div class="stp-section"><h5>Room rules</h5><textarea id="stp-rules" rows="5" placeholder="one rule per line">${esc(st.customRules || "")}</textarea></div>
       <div class="stp-section"><h5>Folder</h5><span class="dir-row"><input type="text" id="stp-dir" maxlength="1000" value="${esc(t.dir || "")}" spellcheck="false">${UI.html("button", { label: "Browse", icon: "folder", kind: "ghost", hook: "browse-btn", data: { stpBrowse: true } })}</span></div>
       <div class="stp-section"><h5>Vibemates · <span id="stp-vm-count">${(t.vibemates || []).length}</span></h5>${vms || '<span class="hint">none</span>'}</div>`;
   }
@@ -4139,7 +4196,8 @@
       backlogCap: num("#stp-backlog"),
       headerRules: $("#stp-header-rules").checked,
       showVendorInRoster: $("#stp-vendor").checked,
-      customRules: $("#stp-rules").value.slice(0, 4000),
+      customRules: $("#stp-rules").value,
+      briefTextLimit: num("#stp-text-limit"),
     };
     const vibemates = [...stpEls.preview.querySelectorAll(".stp-vm")].map((row) => {
       const v = {};

package/ui/index.html

@@ -147,7 +147,7 @@
     <form method="dialog">
       <h3 id="cf-title">Are you sure?</h3>
       <p class="lead" id="cf-text"></p>
-      <div class="actions"><button data-ui="button" data-kind="ghost" value="cancel" type="submit">Cancel</button><button data-ui="button" data-kind="primary" id="cf-ok" value="ok" type="submit">OK</button></div>
+      <div class="actions"><button data-ui="button" data-kind="ghost" id="cf-cancel" value="cancel" type="submit">Cancel</button><button data-ui="button" data-kind="ghost" id="cf-alt" value="alt" type="submit" hidden>Alt</button><button data-ui="button" data-kind="primary" id="cf-ok" value="ok" type="submit">OK</button></div>
     </form>
   </dialog>
   <dialog id="room-dialog" class="dialog">
@@ -200,7 +200,7 @@
         <div class="choice-row"><span class="label">Mode</span><div class="chips" data-for="inv-mode"></div><select id="inv-mode" hidden></select></div>
       </div>
       <div class="two-col">
-        <label>Vibename <span class="hint">(required)</span><input id="inv-name" type="text" maxlength="24" required autocomplete="off" placeholder="letters, digits, _ or -"></label>
+        <label>Vibename <span class="hint req">(required)</span><input id="inv-name" type="text" maxlength="24" required autocomplete="off" placeholder="letters, digits, _ or -"></label>
         <label>Vibersona <span class="hint">(optional; a few words under the vibename)</span><input id="inv-tagline" type="text" maxlength="80" placeholder="e.g. curious analyst"></label>
       </div>
       <label>Vibeface <span class="hint">(pick one, or type any emoji)</span>

package/ui/theme.css

@@ -615,6 +615,7 @@ pre { background: var(--code-bg); color: var(--code-ink); padding: 10px 12px; bo
 .hint { color: var(--faint); font-size: var(--fs-xs); font-weight: 600; line-height: 1.45; }
 .hint.accent { color: var(--primary); }
 .hint.warn { color: var(--warm-ink); }
+.hint.req { color: var(--rose-ink); font-weight: 700; }
 .hint.error, .error { color: var(--rose-ink); font-size: var(--fs-sm); font-weight: 700; }
 .eyebrow { font-size: calc(11px * var(--fs-scale)); text-transform: uppercase; letter-spacing: 0.1em; color: var(--faint); font-weight: 800; }
 .muted { color: var(--muted); }
@@ -820,6 +821,9 @@ code .open-link { color: inherit; }
 .dialog .actions .spacer { flex: 1; }
 .dialog.wide { width: 720px; }
 .dialog.narrow { width: 440px; }
+.dialog.narrow.three-way { width: 580px; }
+.dialog.narrow.three-way .actions { flex-wrap: nowrap; }
+.dialog.narrow.three-way .actions [data-ui="button"] { white-space: nowrap; }
 .toasts { position: fixed; right: 18px; bottom: 20px; display: flex; flex-direction: column; gap: 8px; max-width: 400px; z-index: 50; pointer-events: none; }
 .toast { pointer-events: auto; background: var(--toast-bg); color: var(--toast-ink); padding: 10px 14px; border-radius: calc(12px * var(--r-scale)); font-size: var(--fs-sm); font-weight: 700; box-shadow: var(--shadow-pop); cursor: pointer; animation: slide-in-right var(--t-slow) var(--ease-pop); line-height: 1.4; display: flex; gap: 8px; align-items: flex-start; }
 .toast .i { width: 15px; height: 15px; margin-top: 1px; opacity: 0.85; }