privateboard 0.1.16 → 0.1.18

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -60,7 +60,7 @@ var init_paths = __esm({
 var init_default;
 var init_init = __esm({
   "src/storage/migrations/001_init.sql"() {
-    init_default = "-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- Boardroom \xB7 initial schema\n-- All tables for the v1 MVP. memory_* and knowledge_* are deferred\n-- (post-MVP) and will land in a later migration.\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n-- User preferences \xB7 single-row table.\nCREATE TABLE prefs (\n  id          INTEGER PRIMARY KEY CHECK (id = 1),\n  name        TEXT    NOT NULL DEFAULT 'You',\n  intro       TEXT    NOT NULL DEFAULT '',\n  avatar_seed TEXT,\n  theme       TEXT    NOT NULL DEFAULT 'regent',\n  created_at  INTEGER NOT NULL,\n  updated_at  INTEGER NOT NULL\n);\n\nINSERT INTO prefs (id, name, intro, theme, created_at, updated_at)\nVALUES (1, 'You', '', 'regent',\n        CAST(strftime('%s','now') AS INTEGER) * 1000,\n        CAST(strftime('%s','now') AS INTEGER) * 1000);\n\n-- LLM provider API keys \xB7 stored AES-GCM encrypted.\nCREATE TABLE provider_keys (\n  provider   TEXT PRIMARY KEY,\n  key_blob   BLOB NOT NULL,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\n-- Directors / Agents.\nCREATE TABLE agents (\n  id          TEXT    PRIMARY KEY,\n  name        TEXT    NOT NULL,\n  handle      TEXT    UNIQUE NOT NULL,\n  role_tag    TEXT    NOT NULL DEFAULT '',     -- e.g. 'skeptic', 'physicist'\n  bio         TEXT    NOT NULL DEFAULT '',\n  cover_quote TEXT,\n  instruction TEXT    NOT NULL,\n  model_v     TEXT    NOT NULL,                 -- 'sonnet-4-6' | 'gpt-5' | ...\n  avatar_path TEXT    NOT NULL,\n  is_pinned   INTEGER NOT NULL DEFAULT 0,\n  is_seed     INTEGER NOT NULL DEFAULT 0,\n  created_at  INTEGER NOT NULL,\n  updated_at  INTEGER NOT NULL\n);\n\n-- Rooms (boardroom sessions).\nCREATE TABLE rooms (\n  id           TEXT    PRIMARY KEY,\n  number       INTEGER NOT NULL UNIQUE,\n  name         TEXT    NOT NULL,\n  subject      TEXT    NOT NULL,\n  mode         TEXT    NOT NULL DEFAULT 'discovery',  -- discovery|constructive|adversarial\n  status       TEXT    NOT NULL DEFAULT 'live',       -- live|adjourned\n  brief_style  TEXT,\n  created_at   INTEGER NOT NULL,\n  adjourned_at INTEGER\n);\n\n-- Room \u2194 Agent membership (M:N).\nCREATE TABLE room_members (\n  room_id   TEXT    NOT NULL,\n  agent_id  TEXT    NOT NULL,\n  position  INTEGER NOT NULL,                     -- speaking order in round-robin\n  joined_at INTEGER NOT NULL,\n  PRIMARY KEY (room_id, agent_id),\n  FOREIGN KEY (room_id)  REFERENCES rooms(id)  ON DELETE CASCADE,\n  FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE\n);\n\nCREATE INDEX idx_room_members_room ON room_members(room_id, position);\n\n-- Messages (user, agents, system).\nCREATE TABLE messages (\n  id           TEXT    PRIMARY KEY,\n  room_id      TEXT    NOT NULL,\n  author_kind  TEXT    NOT NULL,                  -- 'agent' | 'user' | 'system'\n  author_id    TEXT,                              -- agent.id or NULL\n  reply_to_id  TEXT,\n  body         TEXT    NOT NULL,\n  meta_json    TEXT,                              -- JSON: mentions[], speakerStatus, ...\n  round_num    INTEGER NOT NULL DEFAULT 1,\n  created_at   INTEGER NOT NULL,\n  FOREIGN KEY (room_id)     REFERENCES rooms(id)     ON DELETE CASCADE,\n  FOREIGN KEY (reply_to_id) REFERENCES messages(id)  ON DELETE SET NULL\n);\n\nCREATE INDEX idx_messages_room ON messages(room_id, created_at);\n\n-- Configuration / lifecycle events (room-opened, room-adjourned, member-add, ...).\nCREATE TABLE config_events (\n  id          TEXT    PRIMARY KEY,\n  room_id     TEXT    NOT NULL,\n  kind        TEXT    NOT NULL,\n  payload     TEXT,                                -- JSON\n  actor_kind  TEXT    NOT NULL,                    -- 'user' | 'system'\n  created_at  INTEGER NOT NULL,\n  FOREIGN KEY (room_id) REFERENCES rooms(id) ON DELETE CASCADE\n);\n\n-- Briefs \xB7 adjourn product.\nCREATE TABLE briefs (\n  id          TEXT    PRIMARY KEY,\n  room_id     TEXT    NOT NULL UNIQUE,\n  style       TEXT    NOT NULL,\n  title       TEXT    NOT NULL,\n  body_md     TEXT    NOT NULL,\n  body_json   TEXT,\n  created_at  INTEGER NOT NULL,\n  FOREIGN KEY (room_id) REFERENCES rooms(id) ON DELETE CASCADE\n);\n";
+    init_default = "-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n-- Boardroom \xB7 initial schema\n-- All tables for the v1 MVP. memory_* and knowledge_* are deferred\n-- (post-MVP) and will land in a later migration.\n-- \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\n\n-- User preferences \xB7 single-row table.\n-- Note: the `theme` column is historical \xB7 appearance moved to\n-- localStorage. The column stays defined here so existing rows\n-- keep validating (NOT NULL DEFAULT), but the server code no\n-- longer reads or writes it. Will be retired in a future cleanup\n-- migration bundled with other DB-shape changes.\nCREATE TABLE prefs (\n  id          INTEGER PRIMARY KEY CHECK (id = 1),\n  name        TEXT    NOT NULL DEFAULT 'You',\n  intro       TEXT    NOT NULL DEFAULT '',\n  avatar_seed TEXT,\n  theme       TEXT    NOT NULL DEFAULT 'regent',\n  created_at  INTEGER NOT NULL,\n  updated_at  INTEGER NOT NULL\n);\n\nINSERT INTO prefs (id, name, intro, theme, created_at, updated_at)\nVALUES (1, 'You', '', 'regent',\n        CAST(strftime('%s','now') AS INTEGER) * 1000,\n        CAST(strftime('%s','now') AS INTEGER) * 1000);\n\n-- LLM provider API keys \xB7 stored AES-GCM encrypted.\nCREATE TABLE provider_keys (\n  provider   TEXT PRIMARY KEY,\n  key_blob   BLOB NOT NULL,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\n-- Directors / Agents.\nCREATE TABLE agents (\n  id          TEXT    PRIMARY KEY,\n  name        TEXT    NOT NULL,\n  handle      TEXT    UNIQUE NOT NULL,\n  role_tag    TEXT    NOT NULL DEFAULT '',     -- e.g. 'skeptic', 'physicist'\n  bio         TEXT    NOT NULL DEFAULT '',\n  cover_quote TEXT,\n  instruction TEXT    NOT NULL,\n  model_v     TEXT    NOT NULL,                 -- 'sonnet-4-6' | 'gpt-5' | ...\n  avatar_path TEXT    NOT NULL,\n  is_pinned   INTEGER NOT NULL DEFAULT 0,\n  is_seed     INTEGER NOT NULL DEFAULT 0,\n  created_at  INTEGER NOT NULL,\n  updated_at  INTEGER NOT NULL\n);\n\n-- Rooms (boardroom sessions).\nCREATE TABLE rooms (\n  id           TEXT    PRIMARY KEY,\n  number       INTEGER NOT NULL UNIQUE,\n  name         TEXT    NOT NULL,\n  subject      TEXT    NOT NULL,\n  mode         TEXT    NOT NULL DEFAULT 'discovery',  -- discovery|constructive|adversarial\n  status       TEXT    NOT NULL DEFAULT 'live',       -- live|adjourned\n  brief_style  TEXT,\n  created_at   INTEGER NOT NULL,\n  adjourned_at INTEGER\n);\n\n-- Room \u2194 Agent membership (M:N).\nCREATE TABLE room_members (\n  room_id   TEXT    NOT NULL,\n  agent_id  TEXT    NOT NULL,\n  position  INTEGER NOT NULL,                     -- speaking order in round-robin\n  joined_at INTEGER NOT NULL,\n  PRIMARY KEY (room_id, agent_id),\n  FOREIGN KEY (room_id)  REFERENCES rooms(id)  ON DELETE CASCADE,\n  FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE\n);\n\nCREATE INDEX idx_room_members_room ON room_members(room_id, position);\n\n-- Messages (user, agents, system).\nCREATE TABLE messages (\n  id           TEXT    PRIMARY KEY,\n  room_id      TEXT    NOT NULL,\n  author_kind  TEXT    NOT NULL,                  -- 'agent' | 'user' | 'system'\n  author_id    TEXT,                              -- agent.id or NULL\n  reply_to_id  TEXT,\n  body         TEXT    NOT NULL,\n  meta_json    TEXT,                              -- JSON: mentions[], speakerStatus, ...\n  round_num    INTEGER NOT NULL DEFAULT 1,\n  created_at   INTEGER NOT NULL,\n  FOREIGN KEY (room_id)     REFERENCES rooms(id)     ON DELETE CASCADE,\n  FOREIGN KEY (reply_to_id) REFERENCES messages(id)  ON DELETE SET NULL\n);\n\nCREATE INDEX idx_messages_room ON messages(room_id, created_at);\n\n-- Configuration / lifecycle events (room-opened, room-adjourned, member-add, ...).\nCREATE TABLE config_events (\n  id          TEXT    PRIMARY KEY,\n  room_id     TEXT    NOT NULL,\n  kind        TEXT    NOT NULL,\n  payload     TEXT,                                -- JSON\n  actor_kind  TEXT    NOT NULL,                    -- 'user' | 'system'\n  created_at  INTEGER NOT NULL,\n  FOREIGN KEY (room_id) REFERENCES rooms(id) ON DELETE CASCADE\n);\n\n-- Briefs \xB7 adjourn product.\nCREATE TABLE briefs (\n  id          TEXT    PRIMARY KEY,\n  room_id     TEXT    NOT NULL UNIQUE,\n  style       TEXT    NOT NULL,\n  title       TEXT    NOT NULL,\n  body_md     TEXT    NOT NULL,\n  body_json   TEXT,\n  created_at  INTEGER NOT NULL,\n  FOREIGN KEY (room_id) REFERENCES rooms(id) ON DELETE CASCADE\n);\n";
   }
 });
 
@@ -998,6 +998,18 @@ function parseVoice(raw) {
     if (typeof obj.speed === "number" && Number.isFinite(obj.speed)) out.speed = obj.speed;
     if (typeof obj.pitch === "number" && Number.isFinite(obj.pitch)) out.pitch = obj.pitch;
     if (typeof obj.volume === "number" && Number.isFinite(obj.volume)) out.volume = obj.volume;
+    if (typeof obj.emotion === "string" && obj.emotion.trim()) {
+      out.emotion = obj.emotion.trim();
+    }
+    if (typeof obj.modifyPitch === "number" && Number.isFinite(obj.modifyPitch)) {
+      out.modifyPitch = obj.modifyPitch;
+    }
+    if (typeof obj.modifyIntensity === "number" && Number.isFinite(obj.modifyIntensity)) {
+      out.modifyIntensity = obj.modifyIntensity;
+    }
+    if (typeof obj.modifyTimbre === "number" && Number.isFinite(obj.modifyTimbre)) {
+      out.modifyTimbre = obj.modifyTimbre;
+    }
     if (typeof obj.instructions === "string" && obj.instructions.trim()) {
       out.instructions = obj.instructions.trim().slice(0, 500);
     }
@@ -1182,6 +1194,13 @@ function serializeVoice(v) {
     ...typeof v.speed === "number" && Number.isFinite(v.speed) ? { speed: Math.max(0.5, Math.min(2, v.speed)) } : {},
     ...typeof v.pitch === "number" && Number.isFinite(v.pitch) ? { pitch: Math.max(-12, Math.min(12, v.pitch)) } : {},
     ...typeof v.volume === "number" && Number.isFinite(v.volume) ? { volume: Math.max(0, Math.min(2, v.volume)) } : {},
+    // Emotion + voice_modify fine-tuning fields. Without these the
+    // route layer accepts the patch but the storage layer silently
+    // drops them, so settings disappear on the next page load.
+    ...typeof v.emotion === "string" && v.emotion.trim() ? { emotion: v.emotion.trim() } : {},
+    ...typeof v.modifyPitch === "number" && Number.isFinite(v.modifyPitch) ? { modifyPitch: Math.max(-100, Math.min(100, v.modifyPitch)) } : {},
+    ...typeof v.modifyIntensity === "number" && Number.isFinite(v.modifyIntensity) ? { modifyIntensity: Math.max(-100, Math.min(100, v.modifyIntensity)) } : {},
+    ...typeof v.modifyTimbre === "number" && Number.isFinite(v.modifyTimbre) ? { modifyTimbre: Math.max(-100, Math.min(100, v.modifyTimbre)) } : {},
     ...v.instructions && v.instructions.trim() ? { instructions: v.instructions.trim().slice(0, 500) } : {}
   });
 }
@@ -3290,7 +3309,6 @@ function mapRow3(row) {
     name: row.name,
     intro: row.intro,
     avatarSeed: row.avatar_seed,
-    theme: row.theme,
     defaultModelV: row.default_model_v,
     webSearchProvider: normalizeWebSearchProviderPref(row.web_search_provider),
     minimaxRegion: normalizeMinimaxRegion(row.minimax_region),
@@ -3300,7 +3318,7 @@ function mapRow3(row) {
 }
 function getPrefs() {
   const row = getDb().prepare(
-    `SELECT name, intro, avatar_seed, theme, default_model_v,
+    `SELECT name, intro, avatar_seed, default_model_v,
               COALESCE(web_search_provider, 'brave') AS web_search_provider,
               COALESCE(minimax_region, 'cn') AS minimax_region,
               created_at, updated_at FROM prefs WHERE id = 1`
@@ -3325,10 +3343,6 @@ function updatePrefs(patch) {
     fields.push("avatar_seed = ?");
     values.push(patch.avatarSeed);
   }
-  if (patch.theme !== void 0) {
-    fields.push("theme = ?");
-    values.push(patch.theme);
-  }
   if (patch.defaultModelV !== void 0) {
     fields.push("default_model_v = ?");
     values.push(patch.defaultModelV);
@@ -7261,7 +7275,7 @@ function agentsRouter() {
     }
     const b = body ?? {};
     const description = typeof b.description === "string" ? b.description.trim() : "";
-    if (description.length < 4) {
+    if (description.length < 2) {
       return c.json({ error: "describe the director in at least a few words" }, 400);
     }
     if (description.length > 1200) {
@@ -7353,7 +7367,7 @@ function agentsRouter() {
     }
     const b = body ?? {};
     const description = typeof b.description === "string" ? b.description.trim() : "";
-    if (description.length < 4) {
+    if (description.length < 2) {
       return c.json({ error: "describe the director in at least a few words" }, 400);
     }
     if (description.length > 1200) {
@@ -7653,6 +7667,15 @@ function agentsRouter() {
           ...typeof v.speed === "number" ? { speed: v.speed } : {},
           ...typeof v.pitch === "number" ? { pitch: v.pitch } : {},
           ...typeof v.volume === "number" ? { volume: v.volume } : {},
+          // Emotion + voice_modify fine-tuning fields. Previously these
+          // were dropped at the route layer, so the agent-profile UI
+          // could call PATCH /api/agents/:id with `voice.emotion` set
+          // and the server would persist the voice WITHOUT the emotion,
+          // making it look like the setting failed to save.
+          ...typeof v.emotion === "string" ? { emotion: v.emotion } : {},
+          ...typeof v.modifyPitch === "number" ? { modifyPitch: v.modifyPitch } : {},
+          ...typeof v.modifyIntensity === "number" ? { modifyIntensity: v.modifyIntensity } : {},
+          ...typeof v.modifyTimbre === "number" ? { modifyTimbre: v.modifyTimbre } : {},
           ...typeof v.instructions === "string" ? { instructions: v.instructions } : {}
         };
       }
@@ -15037,33 +15060,112 @@ async function listAvailableVoices() {
   }
   const elKey = getKey("elevenlabs");
   if (elKey) {
-    try {
-      const res = await fetch("https://api.elevenlabs.io/v1/voices", {
-        headers: { "xi-api-key": elKey }
-      });
-      if (res.ok) {
-        const json = await res.json();
-        const rows = elevenLabsVoiceRows(json.voices);
-        if (rows.length > 0) {
-          const nonEl = voices.filter((v) => v.provider !== "elevenlabs");
-          voices = [
-            ...nonEl,
-            ...rows.map((r) => ({
-              provider: "elevenlabs",
-              model: "eleven_multilingual_v2",
-              voiceId: r.voiceId,
-              label: r.label,
-              language: r.category,
-              configured: true
-            }))
-          ];
+    const personal = [];
+    const shared = [];
+    await Promise.all([
+      (async () => {
+        try {
+          const res = await fetch(
+            "https://api.elevenlabs.io/v1/voices?show_legacy=true&include_total_count=true",
+            { headers: { "xi-api-key": elKey } }
+          );
+          if (!res.ok) {
+            const errText = await res.text();
+            process.stderr.write(
+              `[voice-registry] elevenlabs /v1/voices HTTP ${res.status}: ${errText.slice(0, 300)}
+`
+            );
+            return;
+          }
+          const json = await res.json();
+          const rows = elevenLabsVoiceRows(json.voices);
+          process.stderr.write(`[voice-registry] elevenlabs /v1/voices \xB7 ${rows.length} voices in personal library
+`);
+          personal.push(...rows);
+        } catch (e) {
+          const cause = e instanceof Error ? e.cause : null;
+          const detail = cause?.message ? `: ${cause.message}` : "";
+          process.stderr.write(
+            `[voice-registry] elevenlabs /v1/voices fetch failed${detail} \xB7 ${e instanceof Error ? e.message : String(e)}
+`
+          );
         }
-      }
-    } catch {
+      })(),
+      (async () => {
+        try {
+          const res = await fetch(
+            "https://api.elevenlabs.io/v1/shared-voices?page_size=100",
+            { headers: { "xi-api-key": elKey } }
+          );
+          if (!res.ok) {
+            const errText = await res.text();
+            process.stderr.write(
+              `[voice-registry] elevenlabs /v1/shared-voices HTTP ${res.status}: ${errText.slice(0, 300)}
+`
+            );
+            return;
+          }
+          const json = await res.json();
+          const rows = elevenLabsSharedVoiceRows(json.voices);
+          process.stderr.write(`[voice-registry] elevenlabs /v1/shared-voices \xB7 ${rows.length} voices from public library
+`);
+          shared.push(...rows);
+        } catch (e) {
+          const cause = e instanceof Error ? e.cause : null;
+          const detail = cause?.message ? `: ${cause.message}` : "";
+          process.stderr.write(
+            `[voice-registry] elevenlabs /v1/shared-voices fetch failed${detail} \xB7 ${e instanceof Error ? e.message : String(e)}
+`
+          );
+        }
+      })()
+    ]);
+    if (personal.length > 0 || shared.length > 0) {
+      const nonEl = voices.filter((v) => v.provider !== "elevenlabs");
+      const personalIds = new Set(personal.map((r) => r.voiceId));
+      const sharedDeduped = shared.filter((r) => !personalIds.has(r.voiceId));
+      const personalMapped = personal.map((r) => ({
+        provider: "elevenlabs",
+        model: "eleven_multilingual_v2",
+        voiceId: r.voiceId,
+        label: r.label,
+        // Personal-library rows keep their actual category
+        // ("premade", "cloned", "professional", "generated").
+        language: r.category,
+        configured: true
+      }));
+      const sharedMapped = sharedDeduped.map((r) => ({
+        provider: "elevenlabs",
+        model: "eleven_multilingual_v2",
+        voiceId: r.voiceId,
+        // Prefix shared-library voices so users can tell at a glance
+        // which set they're picking from. The dropdown's group header
+        // already says "elevenlabs", so the per-row prefix is the
+        // tightest signal we have for personal-vs-shared.
+        label: `${r.label} \xB7 shared`,
+        language: r.language || r.category,
+        configured: true
+      }));
+      voices = [...nonEl, ...personalMapped, ...sharedMapped];
     }
   }
   return voices;
 }
+function elevenLabsSharedVoiceRows(raw) {
+  if (!Array.isArray(raw)) return [];
+  const out = [];
+  for (const item of raw) {
+    if (!item || typeof item !== "object") continue;
+    const obj = item;
+    const voiceId = typeof obj.voice_id === "string" ? obj.voice_id : "";
+    if (!voiceId) continue;
+    const label = typeof obj.name === "string" && obj.name.trim() ? obj.name.trim() : voiceId;
+    const category = typeof obj.category === "string" && obj.category.trim() ? obj.category.trim() : "shared";
+    const language = typeof obj.language === "string" && obj.language.trim() ? obj.language.trim() : void 0;
+    out.push({ voiceId, label, category, language });
+  }
+  return out;
+}
 function elevenLabsVoiceRows(raw) {
   if (!Array.isArray(raw)) return [];
   const out = [];
@@ -16220,7 +16322,6 @@ function prefsRouter() {
     const b = body;
     if (typeof b.name === "string") patch.name = b.name.trim().slice(0, 64);
     if (typeof b.intro === "string") patch.intro = b.intro.slice(0, 320);
-    if (typeof b.theme === "string") patch.theme = b.theme.trim().slice(0, 32);
     if (b.avatarSeed === null || typeof b.avatarSeed === "string") {
       patch.avatarSeed = b.avatarSeed;
     }
@@ -18861,6 +18962,7 @@ function minimaxBaseUrl2() {
   return region === "intl" ? "https://api.minimax.io" : "https://api.minimaxi.com";
 }
 var ELEVENLABS_API = "https://api.elevenlabs.io/v1";
+var OPENAI_API = "https://api.openai.com/v1";
 function cleanForSpeech(md) {
   if (!md) return "";
   let out = md;
@@ -18902,6 +19004,7 @@ function voiceProfileForAgent(agent) {
 async function synthesizeSpeech(text, profile, signal) {
   if (profile.provider === "minimax") return synthesizeMiniMax(text, profile, signal);
   if (profile.provider === "elevenlabs") return synthesizeElevenLabs(text, profile, signal);
+  if (profile.provider === "openai") return synthesizeOpenAI(text, profile, signal);
   return {
     provider: profile.provider,
     model: profile.model,
@@ -19067,10 +19170,38 @@ async function synthesizeMiniMax(text, profile, signal) {
       }
     })
   });
-  if (!res.ok) throw new Error(`MiniMax TTS HTTP ${res.status}: ${await res.text()}`);
+  if (!res.ok) {
+    const errText = await res.text();
+    if (res.status === 402 || /insufficient[ _-]?(?:balance|quota|credit|fund)|余额不足|余额[^a-zA-Z]?(?:不足|不够)/i.test(errText)) {
+      const err2 = new Error(
+        "Your MiniMax account balance is insufficient for TTS. Top up your account in the MiniMax console and try again."
+      );
+      err2.code = "paid-plan-required";
+      err2.provider = "minimax";
+      err2.upgradeUrl = getPrefs().minimaxRegion === "intl" ? "https://platform.minimax.io/user-center/billing/overview" : "https://platform.minimaxi.com/user-center/payment";
+      throw err2;
+    }
+    throw new Error(`MiniMax TTS HTTP ${res.status}: ${errText}`);
+  }
   const json = await res.json();
+  const status = json.base_resp?.status_code ?? 0;
+  const statusMsg = json.base_resp?.status_msg || "";
+  if (status !== 0 && (status === 1008 || /insufficient[ _-]?(?:balance|quota|credit|fund)|余额不足|余额[^a-zA-Z]?(?:不足|不够)/i.test(statusMsg))) {
+    const err2 = new Error(
+      "Your MiniMax account balance is insufficient for TTS. Top up your account in the MiniMax console and try again."
+    );
+    err2.code = "paid-plan-required";
+    err2.provider = "minimax";
+    err2.upgradeUrl = getPrefs().minimaxRegion === "intl" ? "https://platform.minimax.io/user-center/billing/overview" : "https://platform.minimaxi.com/user-center/payment";
+    throw err2;
+  }
   const hex = json.data?.audio ?? json.audio ?? "";
-  if (!hex) throw new Error("MiniMax TTS returned no audio");
+  if (!hex) {
+    if (status !== 0 && statusMsg) {
+      throw new Error(`MiniMax TTS failed (${status}): ${statusMsg}`);
+    }
+    throw new Error("MiniMax TTS returned no audio");
+  }
   return {
     provider: "minimax",
     model,
@@ -19080,6 +19211,47 @@ async function synthesizeMiniMax(text, profile, signal) {
     audioBase64: Buffer.from(hex, "hex").toString("base64")
   };
 }
+async function synthesizeOpenAI(text, profile, signal) {
+  const key = getKey("openai");
+  if (!key) {
+    return { provider: "browser", model: "speechSynthesis", voiceId: "system-default", text };
+  }
+  const model = profile.model?.trim() || "gpt-4o-mini-tts";
+  const voice = profile.voiceId?.trim() || "marin";
+  const speed = Math.min(4, Math.max(0.25, profile.speed ?? 1));
+  const res = await fetch(`${OPENAI_API}/audio/speech`, {
+    method: "POST",
+    signal,
+    headers: {
+      "authorization": `Bearer ${key}`,
+      "content-type": "application/json",
+      "accept": "audio/mpeg"
+    },
+    body: JSON.stringify({
+      model,
+      input: text,
+      voice,
+      response_format: "mp3",
+      speed
+    })
+  });
+  if (!res.ok) {
+    const errText = await res.text();
+    throw new Error(`OpenAI TTS HTTP ${res.status}: ${errText.slice(0, 400)}`);
+  }
+  const buf = Buffer.from(await res.arrayBuffer());
+  if (buf.length === 0) {
+    throw new Error("OpenAI TTS returned empty body");
+  }
+  return {
+    provider: "openai",
+    model,
+    voiceId: voice,
+    text,
+    mimeType: "audio/mpeg",
+    audioBase64: buf.toString("base64")
+  };
+}
 async function synthesizeElevenLabs(text, profile, signal) {
   const key = getKey("elevenlabs");
   if (!key) {
@@ -19103,6 +19275,15 @@ async function synthesizeElevenLabs(text, profile, signal) {
   });
   if (!res.ok) {
     const errText = await res.text();
+    if (res.status === 402 && /paid_plan_required|library voices/i.test(errText)) {
+      const err2 = new Error(
+        "ElevenLabs library voices (Rachel, George, etc.) require a paid plan to use via the API. Either upgrade your ElevenLabs subscription, or clone your own voice in the ElevenLabs dashboard and pick it here."
+      );
+      err2.code = "paid-plan-required";
+      err2.provider = "elevenlabs";
+      err2.upgradeUrl = "https://elevenlabs.io/pricing";
+      throw err2;
+    }
     throw new Error(`ElevenLabs TTS HTTP ${res.status}: ${errText.slice(0, 400)}`);
   }
   const buf = Buffer.from(await res.arrayBuffer());
@@ -19139,6 +19320,15 @@ async function* synthesizeElevenLabsStream(text, profile, signal) {
   });
   if (!res.ok) {
     const errText = await res.text();
+    if (res.status === 402 && /paid_plan_required|library voices/i.test(errText)) {
+      const err2 = new Error(
+        "ElevenLabs library voices (Rachel, George, etc.) require a paid plan to use via the API. Either upgrade your ElevenLabs subscription, or clone your own voice in the ElevenLabs dashboard and pick it here."
+      );
+      err2.code = "paid-plan-required";
+      err2.provider = "elevenlabs";
+      err2.upgradeUrl = "https://elevenlabs.io/pricing";
+      throw err2;
+    }
     throw new Error(`ElevenLabs TTS stream HTTP ${res.status}: ${errText.slice(0, 400)}`);
   }
   const body = res.body;
@@ -23008,6 +23198,21 @@ function usageRouter() {
 
 // src/routes/voices.ts
 import { Hono as Hono12 } from "hono";
+function ttsErrorMessage(e, providerLabel) {
+  if (!(e instanceof Error)) return String(e);
+  const cause = e.cause;
+  if (cause && cause instanceof Error) {
+    const code = cause.code;
+    const tail = code ? ` (${String(code)})` : "";
+    const full = `${e.message}: ${cause.message}${tail}`;
+    process.stderr.write(`[tts-preview] ${providerLabel} fetch error \xB7 ${full}
+`);
+    return full;
+  }
+  process.stderr.write(`[tts-preview] ${providerLabel} error \xB7 ${e.message}
+`);
+  return e.message;
+}
 var TTS_CACHE_MAX = 50;
 var ttsCache = /* @__PURE__ */ new Map();
 function ttsCacheKey(messageId, profile) {
@@ -23067,7 +23272,12 @@ function voicesRouter() {
       }
       return c.json({ audioBase64: chunk.audioBase64, mimeType: chunk.mimeType });
     } catch (e) {
-      return c.json({ error: e instanceof Error ? e.message : String(e) }, 502);
+      const tagged = e ?? {};
+      const payload = { error: ttsErrorMessage(e, profile.provider) };
+      if (typeof tagged.code === "string") payload.code = tagged.code;
+      if (typeof tagged.provider === "string") payload.provider = tagged.provider;
+      if (typeof tagged.upgradeUrl === "string") payload.upgradeUrl = tagged.upgradeUrl;
+      return c.json(payload, 502);
     }
   });
   r.post("/by-message/:id", async (c) => {
@@ -23117,7 +23327,7 @@ function voicesRouter() {
       ttsCacheSet(key, out);
       return c.json(out);
     } catch (e) {
-      const msg = e instanceof Error ? e.message : String(e);
+      const msg = ttsErrorMessage(e, profile.provider);
       const isNoKey = /401|403|api[\s-]?key|unauthor/i.test(msg);
       return c.json({
         error: msg,
@@ -23133,7 +23343,7 @@ function voicesRouter() {
 init_paths();
 
 // src/version.ts
-var VERSION = "0.1.16";
+var VERSION = "0.1.18";
 
 // src/server.ts
 function createApp() {
@@ -23209,7 +23419,7 @@ async function startServer(opts) {
   };
 }
 
-// src/cli.ts
+// src/boot.ts
 init_db();
 init_persona_jobs();
 init_paths();
@@ -23231,11 +23441,8 @@ function isPortFree(port) {
   });
 }
 
-// src/cli.ts
-async function main() {
-  const program = new Command().name("privateboard").description("PrivateBoard \xB7 your private board meeting, on call. Local-first, multi-agent thinking.").version(VERSION).option("-p, --port <n>", "port to listen on (default: auto-detect from 3030)").option("--host <h>", "host to bind", "127.0.0.1").option("--no-open", "don't open the browser automatically");
-  program.parse();
-  const opts = program.opts();
+// src/boot.ts
+async function bootApp(opts = {}) {
   const dirs2 = ensureBoardroomDir();
   const { applied } = runMigrations();
   const seed = runSeed();
@@ -23244,7 +23451,7 @@ async function main() {
     const r = reconcileAgentModels();
     reconcile = { switched: r.switched.length, cleared: r.cleared.length };
   } catch (e) {
-    process.stderr.write(`[boot] reconcile failed: ${e instanceof Error ? e.message : String(e)}
+    process.stderr.write(`[boot] reconcile failed: ${errMsg(e)}
 `);
   }
   try {
@@ -23256,7 +23463,7 @@ async function main() {
       );
     }
   } catch (e) {
-    process.stderr.write(`[boot] orphan cleanup failed: ${e instanceof Error ? e.message : String(e)}
+    process.stderr.write(`[boot] orphan cleanup failed: ${errMsg(e)}
 `);
   }
   try {
@@ -23266,7 +23473,7 @@ async function main() {
 `);
     }
   } catch (e) {
-    process.stderr.write(`[boot] clarify recovery failed: ${e instanceof Error ? e.message : String(e)}
+    process.stderr.write(`[boot] clarify recovery failed: ${errMsg(e)}
 `);
   }
   try {
@@ -23276,7 +23483,7 @@ async function main() {
 `);
     }
   } catch (e) {
-    process.stderr.write(`[boot] persona-job recovery failed: ${e instanceof Error ? e.message : String(e)}
+    process.stderr.write(`[boot] persona-job recovery failed: ${errMsg(e)}
 `);
   }
   try {
@@ -23286,7 +23493,7 @@ async function main() {
 `);
     }
   } catch (e) {
-    process.stderr.write(`[boot] topic-rec recovery failed: ${e instanceof Error ? e.message : String(e)}
+    process.stderr.write(`[boot] topic-rec recovery failed: ${errMsg(e)}
 `);
   }
   void (async () => {
@@ -23304,18 +23511,49 @@ async function main() {
 `);
       }
     } catch (e) {
-      process.stderr.write(`[boot] dream sweep failed: ${e instanceof Error ? e.message : String(e)}
+      process.stderr.write(`[boot] dream sweep failed: ${errMsg(e)}
 `);
     }
   })();
+  const port = opts.port ?? await findFreePort(3030);
+  const host = opts.host ?? "127.0.0.1";
+  const server = await startServer({ port, host });
+  return { server, dirs: dirs2, port, host, applied, seed, reconcile };
+}
+var shuttingDown = false;
+async function shutdownApp(server) {
+  if (shuttingDown) return;
+  shuttingDown = true;
+  try {
+    await server?.close();
+  } catch (e) {
+    console.error("  ! error closing server", e);
+  }
+  try {
+    closeDb();
+  } catch (e) {
+    console.error("  ! error closing db", e);
+  }
+}
+function errMsg(e) {
+  return e instanceof Error ? e.message : String(e);
+}
+
+// src/cli.ts
+init_db();
+async function main() {
+  const program = new Command().name("privateboard").description("PrivateBoard \xB7 your private board meeting, on call. Local-first, multi-agent thinking.").version(VERSION).option("-p, --port <n>", "port to listen on (default: auto-detect from 3030)").option("--host <h>", "host to bind", "127.0.0.1").option("--no-open", "don't open the browser automatically");
+  program.parse();
+  const opts = program.opts();
   const portArg = opts.port ? Number.parseInt(opts.port, 10) : void 0;
   if (portArg !== void 0 && (Number.isNaN(portArg) || portArg < 1 || portArg > 65535)) {
     console.error(`Invalid --port: ${opts.port}`);
     process.exit(1);
   }
-  const port = portArg ?? await findFreePort(3030);
-  const host = opts.host ?? "127.0.0.1";
-  const server = await startServer({ port, host });
+  const { server, dirs: dirs2, applied, seed, reconcile } = await bootApp({
+    port: portArg,
+    host: opts.host
+  });
   const bannerLines = [
     "",
     "  \u25B8 privateboard v" + VERSION,
@@ -23340,28 +23578,15 @@ async function main() {
     open(server.url).catch(() => {
     });
   }
-  let shuttingDown = false;
-  const shutdown = async (signal) => {
-    if (shuttingDown) return;
-    shuttingDown = true;
+  const onSignal = (signal) => {
     process.stdout.write(`
   \u25B8 ${signal} received \xB7 shutting down
 `);
-    try {
-      await server.close();
-    } catch (e) {
-      console.error("  ! error closing server", e);
-    }
-    try {
-      closeDb();
-    } catch (e) {
-      console.error("  ! error closing db", e);
-    }
-    process.exit(0);
+    void shutdownApp(server).finally(() => process.exit(0));
   };
-  process.on("SIGINT", () => shutdown("SIGINT"));
-  process.on("SIGTERM", () => shutdown("SIGTERM"));
-  process.on("SIGHUP", () => shutdown("SIGHUP"));
+  process.on("SIGINT", () => onSignal("SIGINT"));
+  process.on("SIGTERM", () => onSignal("SIGTERM"));
+  process.on("SIGHUP", () => onSignal("SIGHUP"));
   process.on("exit", () => {
     try {
       closeDb();