viberoom 0.5.2 → 0.5.4

package/NOTICE

@@ -3,8 +3,14 @@ Copyright (c) 2026 Todor Rusev
 
 This product bundles the following third-party material:
 
-- Nunito (ui/fonts/): Copyright 2014 The Nunito Project Authors,
-  licensed under the SIL Open Font License, Version 1.1 (ui/fonts/OFL.txt).
+- Fonts (ui/fonts/), each licensed under the SIL Open Font License, Version 1.1
+  (ui/fonts/OFL.txt), fetched from Google Fonts by scripts/fetch-fonts.mjs:
+  - Nunito: Copyright 2014 The Nunito Project Authors.
+  - Inter: Copyright 2016 The Inter Project Authors.
+  - Noto Sans: Copyright 2022 The Noto Project Authors.
+  - JetBrains Mono: Copyright 2020 The JetBrains Mono Project Authors.
+  - Fira Code: Copyright 2014-2020 The Fira Code Project Authors.
+  - Source Code Pro: Copyright 2010-2019 Adobe (http://www.adobe.com/).
 
 - Vendor icons (assets/vendors/): the logos of Claude, Codex, Gemini, Cursor,
   OpenCode and GitHub Copilot, as published in the Agent Client Protocol

package/README.md

@@ -14,7 +14,7 @@ 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 Forge & Lumen room: Forge explains a git command from a screenshot, Lumen adds the part that changes whose problem it is">
+  <img src="https://raw.githubusercontent.com/todor-rusev/viberoom/main/docs/screenshots/conversation.png" width="960" alt="A Wren & Quinn room: Wren explains a git command from a screenshot, Quinn adds the part that changes whose problem it is">
 </p>
 
 <p align="center">

package/dist/hub.js

@@ -11,6 +11,9 @@ import { DEFAULT_ROOM_SETTINGS } from "./persona.js";
 import { Room } from "./room.js";
 import { SkillLibrary } from "./skills.js";
 import { TemplateLibrary } from "./templates.js";
+export const TEXT_FONTS = ["nunito", "inter", "noto-sans", "arial", "system"];
+export const MONO_FONTS = ["jetbrains-mono", "fira-code", "source-code-pro", "system"];
+export const DEFAULT_APPEARANCE = { chatFontSize: 14.5, font: "nunito", mono: "jetbrains-mono" };
 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"];
@@ -109,6 +112,8 @@ export class Hub extends EventEmitter {
             agentSkillsNeedApproval: false,
             diagrams: { preset: "pop", primary: null },
             editor: { ...DEFAULT_EDITOR_SETTINGS },
+            appearance: { ...DEFAULT_APPEARANCE },
+            checkForUpdates: true,
             roomDefaults: {},
             vendorPresets: {},
         };
@@ -161,6 +166,8 @@ export class Hub extends EventEmitter {
             next.profileCompleted = patch.profileCompleted === true || patch.profileCompleted === "true";
         if (patch.agentSkillsNeedApproval !== undefined)
             next.agentSkillsNeedApproval = patch.agentSkillsNeedApproval === true || patch.agentSkillsNeedApproval === "true";
+        if (patch.checkForUpdates !== undefined)
+            next.checkForUpdates = patch.checkForUpdates === true || patch.checkForUpdates === "true";
         if (patch.diagrams !== undefined && typeof patch.diagrams === "object" && patch.diagrams) {
             const d = patch.diagrams;
             const preset = String(d.preset ?? next.diagrams?.preset ?? "pop");
@@ -186,6 +193,20 @@ export class Hub extends EventEmitter {
                 throw new Error("editor.command must mention {file} (and usually {line})");
             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(", ")}`);
+            next.appearance = { chatFontSize: Math.round(chatFontSize * 2) / 2, font, mono };
+        }
+        next.appearance = { ...DEFAULT_APPEARANCE, ...(next.appearance ?? {}) };
         if (!next.editor)
             next.editor = { ...DEFAULT_EDITOR_SETTINGS };
         if (patch.roomDefaults !== undefined && typeof patch.roomDefaults === "object" && patch.roomDefaults) {
@@ -311,9 +332,16 @@ export class Hub extends EventEmitter {
         const template = this.templates.get(input.templateId);
         if (!template)
             throw new Error(`no such template: ${input.templateId}`);
-        const { room, notices } = this.createRoom({ name: input.name, dir: input.dir, settings: template.settings });
+        const { room, notices } = this.createRoom({ name: input.name, dir: input.dir || template.dir || null, settings: template.settings });
+        const installed = new Set(listRecipes().filter((r) => !r.unavailableReason).map((r) => r.id));
         for (const [i, tv] of template.vibemates.entries()) {
-            const choice = input.vibemates[i] ?? { name: tv.name, agentType: "" };
+            const choice = { ...(input.vibemates[i] ?? { name: tv.name, agentType: "" }) };
+            if (!choice.agentType && tv.agentType) {
+                if (installed.has(tv.agentType))
+                    choice.agentType = tv.agentType;
+                else
+                    notices.push(`${choice.name || tv.name}: the template runs it on ${tv.agentType}, which is not installed here; pick another agent in the roster.`);
+            }
             const skills = (tv.skills ?? []).filter((name) => {
                 const ok = !!this.skills.get(name);
                 if (!ok)
@@ -337,6 +365,7 @@ export class Hub extends EventEmitter {
                     role: tv.role,
                     avatar: tv.avatar,
                     skills,
+                    replyDelay: tv.replyDelay,
                     model: choice.model ?? tv.model,
                     effort: choice.effort ?? tv.effort,
                     mode: choice.mode ?? tv.mode,
@@ -349,6 +378,24 @@ export class Hub extends EventEmitter {
         this.saveRooms();
         return { room, notices };
     }
+    saveRoomAsTemplate(roomId, input) {
+        const name = input.name.trim();
+        if (!name)
+            throw new Error("the template needs a name");
+        const room = this.getRoom(roomId);
+        const base = room.templateOf();
+        const edited = input.template ?? {};
+        const saved = this.templates.save({
+            name,
+            description: input.description.trim(),
+            emoji: (input.emoji ?? room.settings.emoji) || undefined,
+            dir: edited.dir?.trim() || base.dir,
+            settings: { ...base.settings, ...(edited.settings ?? {}) },
+            vibemates: edited.vibemates ?? base.vibemates,
+        });
+        this.emit("event", { type: "templates" });
+        return saved;
+    }
     getRoom(id) {
         const room = this.rooms.get(id);
         if (!room)
@@ -388,9 +435,15 @@ export class Hub extends EventEmitter {
         else
             this.log.info(`removed room ${id}`);
     }
+    update = null;
+    setUpdate(update) {
+        this.update = update;
+        this.emit("event", { type: "update", update });
+    }
     snapshot() {
         return {
             settings: this.settings,
+            update: this.update,
             recipes: listRecipes().map(({ build: _b, ...r }) => r),
             skills: this.skills.list(),
             roomDefaults: { ...DEFAULT_ROOM_SETTINGS, ...this.settings.roomDefaults },

package/dist/main.js

@@ -86,6 +86,7 @@ Options
   --browser    open the default browser instead of a Chromium app window
 `);
 }
+import { checkForUpdate } from "./update.js";
 function buildInfo() {
     const pkg = JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
     const built = statSync(fileURLToPath(import.meta.url)).mtime;
@@ -251,6 +252,15 @@ async function runHub(options, log, info) {
         }
     }
     hub.setHubUrl(server.url);
+    if (hub.settings.checkForUpdates) {
+        void checkForUpdate(hub.dataDir, info.version).then((update) => {
+            hub.setUpdate(update);
+            if (update.available)
+                log.info(`viberoom ${update.latest} is available (this is ${update.current})`);
+            else if (update.error)
+                log.warn(`update check failed: ${update.error}`);
+        });
+    }
     if (background)
         writePidFile(options.dataDir, { pid: process.pid, port: options.port, build: info.build, startedAt: Date.now() });
     log.info(`viberoom ${info.version} (build ${info.build}) is open at ${server.url} (data: ${hub.dataDir}; rooms: ${[...hub.rooms.values()].map((r) => r.name).join(", ")})`);

package/dist/room.js

@@ -133,6 +133,40 @@ export class Room extends EventEmitter {
             this.colorIndex++;
         }
     }
+    templateOf() {
+        const { name: _n, humanName: _h, ...rest } = this.settings;
+        const settings = { ...rest, customRules: this.renderRuleReferences(this.settings.customRules) };
+        const vibemates = [];
+        for (const p of this.participants.values()) {
+            if (p.kind !== "agent" || p.status === "left")
+                continue;
+            const v = { name: p.name };
+            if (p.tagline)
+                v.tagline = p.tagline;
+            if (p.role)
+                v.role = p.role;
+            if (p.avatar)
+                v.avatar = p.avatar;
+            if (p.skills?.length)
+                v.skills = [...p.skills];
+            if (p.replyDelay !== undefined)
+                v.replyDelay = p.replyDelay;
+            if (p.agentType) {
+                v.agentType = p.agentType;
+                const model = p.launch?.model ?? p.model;
+                const effort = p.launch?.effort ?? p.effort;
+                const mode = p.launch?.mode ?? p.mode;
+                if (model)
+                    v.model = model;
+                if (effort)
+                    v.effort = effort;
+                if (mode)
+                    v.mode = mode;
+            }
+            vibemates.push(v);
+        }
+        return { dir: this.dir, settings, vibemates };
+    }
     toStored() {
         const { name: _n, humanName: _h, ...settings } = this.settings;
         return {
@@ -931,6 +965,7 @@ export class Room extends EventEmitter {
                 turnActive: false,
                 pendingTurn: false,
                 turn: null,
+                strayMessageId: null,
                 turnsSinceBrief: 0,
                 usedAtBrief: 0,
                 briefSentThisTurn: false,
@@ -1886,11 +1921,16 @@ export class Room extends EventEmitter {
         const turn = runtime.turn;
         switch (update.sessionUpdate) {
             case "agent_message_chunk": {
-                if (!turn)
-                    return;
                 const u = update;
-                let text = contentText(u.content);
                 const messageId = u.messageId ?? null;
+                if (!turn) {
+                    if (messageId)
+                        runtime.strayMessageId = messageId;
+                    return;
+                }
+                if (messageId && messageId === runtime.strayMessageId)
+                    return;
+                let text = contentText(u.content);
                 if (messageId && !turn.sawMessageId && turn.message.text) {
                     const notices = (turn.message.notices ??= []);
                     notices.push(turn.message.text.trim());

package/dist/server.js

@@ -40,6 +40,7 @@ const STATIC_FILES = {
     "/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" },
 };
+import { checkForUpdate, installUpdate, restartWithNewBuild, runsFromSourceCheckout } from "./update.js";
 export function startServer(hub, port, log, info, onShutdownRequest) {
     const uiDir = fileURLToPath(new URL("../ui/", import.meta.url));
     const assetsDir = fileURLToPath(new URL("../assets/", import.meta.url));
@@ -178,6 +179,28 @@ export function startServer(hub, port, log, info, onShutdownRequest) {
             sendJson(res, 200, snapshot());
             return;
         }
+        if (req.method === "GET" && path === "/api/update") {
+            if (url.searchParams.get("check") === "1")
+                hub.setUpdate(await checkForUpdate(hub.dataDir, info.version, { force: true }));
+            sendJson(res, 200, hub.update ?? { current: info.version, latest: null, available: false, checkedAt: null, error: null });
+            return;
+        }
+        if (req.method === "POST" && path === "/api/update/install") {
+            const mainUrl = new URL("./main.js", import.meta.url).href;
+            if (runsFromSourceCheckout(mainUrl))
+                throw new Error("this viberoom runs from a source checkout; update it with git pull and npm run update");
+            const latest = hub.update?.available ? hub.update.latest : null;
+            if (!latest)
+                throw new Error("no newer version is known; check for updates first");
+            log.info(`installing viberoom ${latest} (npm install -g)`);
+            const result = await installUpdate(latest);
+            if (!result.ok)
+                throw new Error(`npm install failed: ${result.output.slice(-600) || "no output"}`);
+            log.info(`viberoom ${latest} installed; starting the new build, which replaces this hub`);
+            sendJson(res, 200, { ok: true, version: latest });
+            setTimeout(() => restartWithNewBuild(mainUrl, port, hub.dataDir), 300);
+            return;
+        }
         if (req.method === "GET" && path === "/api/version") {
             sendJson(res, 200, info);
             return;
@@ -369,7 +392,7 @@ export function startServer(hub, port, log, info, onShutdownRequest) {
             sendJson(res, 200, { ok: true, room: room.snapshot(), notices });
             return;
         }
-        const roomAction = path.match(/^\/api\/rooms\/([^/]+)\/(send|typing|invite|settings|focus|rename|dir|delete|open)$/);
+        const roomAction = path.match(/^\/api\/rooms\/([^/]+)\/(send|typing|invite|settings|focus|rename|dir|delete|open|template-preview|save-template)$/);
         if (roomAction) {
             const room = hub.getRoom(decodeURIComponent(roomAction[1]));
             const action = roomAction[2];
@@ -392,6 +415,23 @@ export function startServer(hub, port, log, info, onShutdownRequest) {
                 const message = room.postHumanMessage(text, imageList(body.images));
                 sendJson(res, 200, { ok: true, id: message.id });
             }
+            else if (action === "template-preview") {
+                sendJson(res, 200, { template: { name: room.name, emoji: room.settings.emoji || "", ...room.templateOf() } });
+            }
+            else if (action === "save-template") {
+                const edited = body.template && typeof body.template === "object" ? body.template : undefined;
+                const template = hub.saveRoomAsTemplate(room.id, {
+                    name: String(body.name ?? ""),
+                    description: String(body.description ?? ""),
+                    emoji: body.emoji === undefined ? undefined : String(body.emoji),
+                    template: edited && {
+                        dir: optionalString(edited.dir) ?? undefined,
+                        settings: edited.settings && typeof edited.settings === "object" ? edited.settings : undefined,
+                        vibemates: Array.isArray(edited.vibemates) ? edited.vibemates : undefined,
+                    },
+                });
+                sendJson(res, 200, { ok: true, template });
+            }
             else if (action === "typing") {
                 room.humanTyping();
                 sendJson(res, 200, { ok: true });

package/dist/templates.js

@@ -1,6 +1,7 @@
 // viberoom - Copyright (c) 2026 Todor Rusev - AGPL-3.0-or-later; see LICENSE
-import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
+import { writeFileAtomic } from "./atomic.js";
 import { fileURLToPath } from "node:url";
 const ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,39}$/;
 export const SHIPPED_TEMPLATES_DIR = fileURLToPath(new URL("../templates/", import.meta.url));
@@ -22,6 +23,8 @@ export function cleanTemplate(raw, id) {
         }
         if (Array.isArray(o.skills))
             out.skills = o.skills.map((s) => String(s).trim()).filter(Boolean);
+        if (typeof o.replyDelay === "number" && Number.isFinite(o.replyDelay))
+            out.replyDelay = o.replyDelay;
         return out;
     });
     const settings = (t.settings && typeof t.settings === "object" ? t.settings : {});
@@ -32,8 +35,16 @@ export function cleanTemplate(raw, id) {
         out.emoji = t.emoji.trim().slice(0, 8);
     if (t.recommended === true)
         out.recommended = true;
+    if (typeof t.dir === "string" && t.dir.trim())
+        out.dir = t.dir.trim();
+    if (typeof t.created === "string" && t.created.trim())
+        out.created = t.created.trim();
     return out;
 }
+export function templateId(name) {
+    const id = name.toLowerCase().normalize("NFKD").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
+    return ID_PATTERN.test(id) ? id : "template";
+}
 function readTemplates(dir, log, builtin) {
     const out = [];
     if (!existsSync(dir))
@@ -54,7 +65,7 @@ function readTemplates(dir, log, builtin) {
             log.warn(`template ${entry.name} in ${dir} skipped: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
-    return out.sort((a, b) => (a.order ?? 100) - (b.order ?? 100) || a.name.localeCompare(b.name));
+    return out.sort((a, b) => (a.order ?? 100) - (b.order ?? 100) || (b.created ?? "").localeCompare(a.created ?? "") || a.name.localeCompare(b.name));
 }
 export class TemplateLibrary {
     dir;
@@ -68,9 +79,22 @@ export class TemplateLibrary {
     list() {
         const own = readTemplates(this.dir, this.log, false);
         const taken = new Set(own.map((t) => t.id));
-        return [...readTemplates(this.shippedDir, this.log, true).filter((t) => !taken.has(t.id)), ...own];
+        return [...own, ...readTemplates(this.shippedDir, this.log, true).filter((t) => !taken.has(t.id))];
     }
     get(id) {
         return this.list().find((t) => t.id === id);
     }
+    save(template) {
+        const taken = new Set(this.list().map((t) => t.id));
+        const base = templateId(template.name);
+        let id = base;
+        for (let n = 2; taken.has(id); n++)
+            id = `${base.slice(0, 40 - String(n).length - 1)}-${n}`;
+        const clean = cleanTemplate({ ...template, created: new Date().toISOString() }, id);
+        const folder = join(this.dir, id);
+        mkdirSync(folder, { recursive: true });
+        writeFileAtomic(join(folder, "template.json"), JSON.stringify(clean, null, 2) + "\n");
+        this.log.info(`saved template "${clean.name}" (${id})`);
+        return clean;
+    }
 }

package/dist/update.js

@@ -0,0 +1,95 @@
+// viberoom - Copyright (c) 2026 Todor Rusev - AGPL-3.0-or-later; see LICENSE
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+export const REGISTRY_URL = "https://registry.npmjs.org/viberoom/latest";
+export const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+const CHECK_FILE = "update-check.json";
+export function parseVersion(v) {
+    const m = /^v?(\d+)\.(\d+)\.(\d+)(-[0-9A-Za-z.-]+)?$/.exec(v.trim());
+    if (!m)
+        return null;
+    return { parts: [Number(m[1]), Number(m[2]), Number(m[3])], prerelease: !!m[4] };
+}
+export function compareVersions(a, b) {
+    const pa = parseVersion(a);
+    const pb = parseVersion(b);
+    if (!pa || !pb)
+        return 0;
+    for (let i = 0; i < 3; i++)
+        if (pa.parts[i] !== pb.parts[i])
+            return pa.parts[i] - pb.parts[i];
+    if (pa.prerelease !== pb.prerelease)
+        return pa.prerelease ? -1 : 1;
+    return 0;
+}
+export function readCheckRecord(dataDir) {
+    const file = join(dataDir, CHECK_FILE);
+    if (!existsSync(file))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(file, "utf8"));
+        if (typeof raw.checkedAt !== "string")
+            return null;
+        return { checkedAt: raw.checkedAt, latest: typeof raw.latest === "string" ? raw.latest : null, error: typeof raw.error === "string" ? raw.error : null };
+    }
+    catch {
+        return null;
+    }
+}
+export function toInfo(current, record) {
+    const latest = record?.latest ?? null;
+    return { current, latest, available: latest !== null && compareVersions(latest, current) > 0, checkedAt: record?.checkedAt ?? null, error: record?.error ?? null };
+}
+export async function checkForUpdate(dataDir, current, options = {}) {
+    const now = options.now ?? Date.now;
+    const previous = readCheckRecord(dataDir);
+    if (!options.force && previous && now() - Date.parse(previous.checkedAt) < CHECK_INTERVAL_MS)
+        return toInfo(current, previous);
+    const doFetch = options.fetchImpl ?? fetch;
+    let record;
+    try {
+        const res = await doFetch(REGISTRY_URL, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(options.timeoutMs ?? 6000) });
+        if (!res.ok)
+            throw new Error(`registry answered ${res.status}`);
+        const body = (await res.json());
+        if (typeof body.version !== "string" || !parseVersion(body.version))
+            throw new Error("registry answer had no version");
+        record = { checkedAt: new Date(now()).toISOString(), latest: body.version, error: null };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        record = { checkedAt: new Date(now()).toISOString(), latest: previous?.latest ?? null, error: message.replace(/\s+/g, " ").slice(0, 200) };
+    }
+    writeFileSync(join(dataDir, CHECK_FILE), JSON.stringify(record, null, 2));
+    return toInfo(current, record);
+}
+export function runsFromSourceCheckout(mainModuleUrl) {
+    const path = decodeURIComponent(new URL(mainModuleUrl).pathname);
+    return !/\/node_modules\/viberoom\//.test(path);
+}
+export function installCommandLine(version) {
+    if (!parseVersion(version))
+        throw new Error(`not a version: ${version}`);
+    return `npm install -g viberoom@${version} --no-audit --no-fund`;
+}
+export function installUpdate(version) {
+    const line = installCommandLine(version);
+    return new Promise((resolve) => {
+        const child = process.platform === "win32" ? spawn(line, { shell: true, windowsHide: true }) : spawn("npm", line.split(" ").slice(1));
+        let output = "";
+        const collect = (chunk) => {
+            output = (output + chunk.toString()).slice(-4000);
+        };
+        child.stdout?.on("data", collect);
+        child.stderr?.on("data", collect);
+        child.on("error", (error) => resolve({ ok: false, output: `${output}\n${error.message}`.trim() }));
+        child.on("close", (code) => resolve({ ok: code === 0, output: output.trim() }));
+    });
+}
+export function restartWithNewBuild(mainModuleUrl, port, dataDir) {
+    const main = fileURLToPath(mainModuleUrl);
+    const child = spawn(process.execPath, [main, "start", "--port", String(port), "--data-dir", dataDir, "--no-open"], { detached: true, stdio: "ignore", windowsHide: true });
+    child.unref();
+}

package/package.json

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

package/templates/wren-and-quinn/template.json

@@ -0,0 +1,28 @@
+{
+  "name": "Wren & Quinn",
+  "order": 1,
+  "emoji": "⚒️",
+  "recommended": true,
+  "description": "Two equals around one codebase. Wren builds by default, Quinn explains by default; either does either when asked, and either reviews the other's work when you ask for it. The way viberoom itself was built.",
+  "settings": {
+    "language": {
+      "mode": "follow-human"
+    },
+    "turnTaking": "parallel",
+    "agentsWakeEachOther": true,
+    "hopLimit": 24,
+    "customRules": "Both build, both explain, both review; @ decides who does what. Without @, a task goes to the one who has worked on that part the most, or most recently; if neither has touched it, to Wren. A question without @ goes to Quinn.\nThe human decides when work is reviewed: ask the other one to review it. Unasked, the other answers questions and otherwise stays silent; it does not review, comment on or extend work it was not asked about. When asked to review, first say in one line what you will check, then check it by that criterion: a number, a live check, the risky case. The builder reports to the human, never to the other vibemate. A build is reported as: what changed (the files, and the commit if the project uses version control), how to verify it (a command, a script, a screenshot), what was not verified, what is left.\nMeasure before diagnosing; say no with a reason and a cheaper alternative; keep replies short.\nWork only on your own task, never on the other's; do not touch what the other is working on.\nReply only when addressed. On a message to everyone, only the one it concerns answers; the other stays silent. Never add to, correct or comment on the other's reply unless the human asks.\nFollow the conventions of the project you work in (its instructions, notes, tests). Where it keeps decision notes, write the decision there before reporting it here.\nRead every proposal and analyse it; agree or reject only with a real argument. Never concede to be agreeable, never object to seem rigorous.\nReply in the human's language. Code identifiers, commands, file paths, protocol and tool names stay exactly as in the code; established technical terms (kernel, thread, commit, pull request, layout) stay in English."
+  },
+  "vibemates": [
+    {
+      "name": "Wren",
+      "tagline": "builds by default; explains and reviews when asked",
+      "role": "You are Wren, one of two equal vibemates, Wren and Quinn. You lean to building: a task without an address is yours when it touches what you have built, or when neither of you has; before you change anything, read what is already there, the notes, the docs and the code, and keep each change small. Everything else is in the room rules."
+    },
+    {
+      "name": "Quinn",
+      "tagline": "explains by default; builds and reviews when asked",
+      "role": "You are Quinn, one of two equal vibemates, Wren and Quinn. You lean to explaining: a question without an address is yours; when you review, it is by a criterion, not an impression. Everything else is in the room rules."
+    }
+  ]
+}