privateboard 0.1.37 → 0.1.38

package/dist/cli.js

@@ -888,6 +888,30 @@ var init_room_name_auto = __esm({
   }
 });
 
+// src/storage/migrations/053_room_threads.sql
+var room_threads_default;
+var init_room_threads = __esm({
+  "src/storage/migrations/053_room_threads.sql"() {
+    room_threads_default = "-- 053_room_threads.sql \xB7 Private 1:1 threads with a single director.\n--\n-- A \"thread\" is a lightweight room spawned from a live room (the\n-- parent) for the user to pull one director aside without exposing\n-- the conversation to the other directors. The thread reuses the\n-- regular `rooms` / `messages` / `room_members` plumbing \u2014 only two\n-- discriminators tell it apart:\n--\n--   room_kind            \xB7 'main' (default \xB7 all existing rows) or 'thread'\n--   thread_director_id   \xB7 the single director the thread is with;\n--                          NULL on main rooms\n--\n-- parent_room_id (added in 020) is reused to point at the parent\n-- main room. The follow-up-room feature also uses parent_room_id,\n-- so callers must disambiguate via room_kind (follow-up = 'main'\n-- with parent_room_id set; thread = 'thread' with both set).\n--\n-- No FK constraints \u2014 main room deletion handled at storage layer\n-- so a future hard-delete path can cascade thread rooms explicitly.\n\nALTER TABLE rooms ADD COLUMN room_kind          TEXT NOT NULL DEFAULT 'main';\nALTER TABLE rooms ADD COLUMN thread_director_id TEXT NULL;\n\n-- Index the parent \u2192 child relationship for the common dock-bar /\n-- \"list threads in this room\" query. Filter to threads only so the\n-- much larger main-room population doesn't dominate the index.\nCREATE INDEX IF NOT EXISTS idx_rooms_parent_thread\n  ON rooms (parent_room_id, room_kind)\n  WHERE room_kind = 'thread';\n";
+  }
+});
+
+// src/storage/migrations/054_voice_clone_jobs.sql
+var voice_clone_jobs_default;
+var init_voice_clone_jobs = __esm({
+  "src/storage/migrations/054_voice_clone_jobs.sql"() {
+    voice_clone_jobs_default = "-- 054_voice_clone_jobs.sql \xB7 Persist voice-clone jobs across a process restart.\n--\n-- A clone job spans 5-60 s (YouTube fetch \u2192 upload \u2192 clone) and the\n-- user can minimize the modal into a bottom-right pill. If the\n-- process is killed mid-job (Ctrl+C, hard restart) the row would\n-- otherwise be left in `running` forever; boot-time recovery (see\n-- src/boot.ts) flips stale `running` rows to `failed` so the UI can\n-- surface \"last clone was interrupted\" instead of silently losing it.\n--\n-- Fields:\n--   id            uuid \xB7 primary key, also exposed to client as jobId\n--   agent_id      director receiving the cloned voice\n--   provider      'minimax' | 'elevenlabs' \xB7 resolved from active credential at start\n--   source_kind   'file' | 'youtube'\n--   source_ref    absolute filesystem path (file) or YouTube URL (youtube)\n--   label         user-supplied display label for the new voice; nullable\n--   status        'queued' | 'running' | 'done' | 'failed' | 'cancelled'\n--   current_stage 'fetch' | 'upload' | 'clone' \xB7 which 3rd of the pipeline\n--   pct           0-100 overall progress (each stage covers ~33 pp)\n--   voice_id      provider-issued voice id when status='done'; NULL otherwise\n--   error_code    short token like 'yt_age_gated' / 'provider_quota'\n--   error_message human-readable detail for the modal\n--   created_at    epoch millis\n--   updated_at    epoch millis \xB7 refreshed on every progress write\n\nCREATE TABLE IF NOT EXISTS clone_jobs (\n  id            TEXT PRIMARY KEY,\n  agent_id      TEXT NOT NULL,\n  provider      TEXT NOT NULL,\n  source_kind   TEXT NOT NULL,\n  source_ref    TEXT NOT NULL,\n  label         TEXT,\n  status        TEXT NOT NULL DEFAULT 'queued',\n  current_stage TEXT NOT NULL DEFAULT 'fetch',\n  pct           INTEGER NOT NULL DEFAULT 0,\n  voice_id      TEXT,\n  error_code    TEXT,\n  error_message TEXT,\n  created_at    INTEGER NOT NULL,\n  updated_at    INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_clone_jobs_status_updated\n  ON clone_jobs (status, updated_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_clone_jobs_agent_running\n  ON clone_jobs (agent_id, status)\n  WHERE status IN ('queued', 'running');\n";
+  }
+});
+
+// src/storage/migrations/055_voice_labels.sql
+var voice_labels_default;
+var init_voice_labels = __esm({
+  "src/storage/migrations/055_voice_labels.sql"() {
+    voice_labels_default = "-- 055_voice_labels.sql \xB7 Persist user-supplied friendly names for\n-- provider voice_ids that don't have a name field of their own.\n--\n-- MiniMax's `voice_clone` API has no `name` parameter \u2014 the voice_id\n-- IS the dashboard label \u2014 so when the user typed \"Chloe\" in the\n-- clone modal, that string never reaches MiniMax. Previously we\n-- mirrored the label to localStorage, which dies the moment the\n-- user clears site data or moves to another machine. This table is\n-- the durable record. `listVoicesPage` merges it into the catalogue\n-- response so the picker / trigger / message-author labels stay\n-- friendly across reloads, devices, and DB exports.\n--\n-- Fields:\n--   voice_id    TEXT PRIMARY KEY \xB7 provider-issued voice id\n--   provider    TEXT NOT NULL    \xB7 'minimax' | 'elevenlabs'\n--   label       TEXT NOT NULL    \xB7 user-typed name from the clone modal\n--   created_at  INTEGER NOT NULL \xB7 epoch ms\n--   updated_at  INTEGER NOT NULL \xB7 epoch ms \xB7 refreshed on rename\n\nCREATE TABLE IF NOT EXISTS voice_labels (\n  voice_id   TEXT PRIMARY KEY,\n  provider   TEXT NOT NULL,\n  label      TEXT NOT NULL,\n  created_at INTEGER NOT NULL,\n  updated_at INTEGER NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS voice_labels_provider_idx\n  ON voice_labels(provider);\n";
+  }
+});
+
 // src/storage/db.ts
 var db_exports = {};
 __export(db_exports, {
@@ -1014,6 +1038,9 @@ var init_db = __esm({
     init_agent_provider_buckets();
     init_search_credentials();
     init_room_name_auto();
+    init_room_threads();
+    init_voice_clone_jobs();
+    init_voice_labels();
     MIGRATIONS = [
       { name: "001_init.sql", sql: init_default },
       { name: "002_default_opus.sql", sql: default_opus_default },
@@ -1066,7 +1093,10 @@ var init_db = __esm({
       { name: "049_voice_credentials.sql", sql: voice_credentials_default },
       { name: "050_agent_provider_buckets.sql", sql: agent_provider_buckets_default },
       { name: "051_search_credentials.sql", sql: search_credentials_default },
-      { name: "052_room_name_auto.sql", sql: room_name_auto_default }
+      { name: "052_room_name_auto.sql", sql: room_name_auto_default },
+      { name: "053_room_threads.sql", sql: room_threads_default },
+      { name: "054_voice_clone_jobs.sql", sql: voice_clone_jobs_default },
+      { name: "055_voice_labels.sql", sql: voice_labels_default }
     ];
     _db = null;
   }
@@ -2609,8 +2639,8 @@ function runSeed() {
 // src/server.ts
 import { serve } from "@hono/node-server";
 import { serveStatic } from "@hono/node-server/serve-static";
-import { Hono as Hono15 } from "hono";
-import { existsSync as existsSync2 } from "fs";
+import { Hono as Hono17 } from "hono";
+import { existsSync as existsSync3 } from "fs";
 
 // src/routes/agents.ts
 import { Hono } from "hono";
@@ -14216,7 +14246,7 @@ function cleanupOrphanedStreams(opts = {}) {
 
 // src/storage/rooms.ts
 init_db();
-var ROOM_COLS = "id, number, name, subject, mode, intensity, delivery_mode, vote_trigger, status, brief_style, awaiting_continue, awaiting_clarify, created_at, paused_at, adjourned_at, incognito, parent_room_id, parent_brief_id, name_auto";
+var ROOM_COLS = "id, number, name, subject, mode, intensity, delivery_mode, vote_trigger, status, brief_style, awaiting_continue, awaiting_clarify, created_at, paused_at, adjourned_at, incognito, parent_room_id, parent_brief_id, name_auto, room_kind, thread_director_id";
 function mapRow8(row) {
   return {
     id: row.id,
@@ -14237,7 +14267,9 @@ function mapRow8(row) {
     incognito: row.incognito === 1,
     parentRoomId: row.parent_room_id,
     parentBriefId: row.parent_brief_id,
-    nameAuto: row.name_auto === 1
+    nameAuto: row.name_auto === 1,
+    kind: row.room_kind === "thread" ? "thread" : "main",
+    threadDirectorId: row.thread_director_id
   };
 }
 function mapMember(row) {
@@ -14249,7 +14281,9 @@ function mapMember(row) {
   };
 }
 function listRooms() {
-  const rows = getDb().prepare(`SELECT ${ROOM_COLS} FROM rooms ORDER BY created_at DESC`).all();
+  const rows = getDb().prepare(
+    `SELECT ${ROOM_COLS} FROM rooms WHERE room_kind = 'main' ORDER BY created_at DESC`
+  ).all();
   return rows.map(mapRow8);
 }
 function getRoom(id) {
@@ -14269,11 +14303,65 @@ function listAllRoomMembers(roomId) {
   return rows.map(mapMember);
 }
 function listFollowUpRooms(parentRoomId) {
-  const rows = getDb().prepare(`SELECT ${ROOM_COLS} FROM rooms WHERE parent_room_id = ? ORDER BY created_at DESC`).all(parentRoomId);
+  const rows = getDb().prepare(
+    `SELECT ${ROOM_COLS} FROM rooms WHERE parent_room_id = ? AND room_kind = 'main' ORDER BY created_at DESC`
+  ).all(parentRoomId);
+  return rows.map(mapRow8);
+}
+function listThreadsForRoom(parentRoomId, opts = {}) {
+  const params = [parentRoomId];
+  let sql = `SELECT ${ROOM_COLS} FROM rooms WHERE parent_room_id = ? AND room_kind = 'thread'`;
+  if (opts.directorId) {
+    sql += ` AND thread_director_id = ?`;
+    params.push(opts.directorId);
+  }
+  sql += ` ORDER BY created_at DESC`;
+  const rows = getDb().prepare(sql).all(...params);
   return rows.map(mapRow8);
 }
+function createThread(parentRoomId, directorId) {
+  const parent = getRoom(parentRoomId);
+  if (!parent) throw new Error(`createThread \xB7 parent room ${parentRoomId} not found`);
+  if (parent.kind !== "main") {
+    throw new Error(`createThread \xB7 parent room ${parentRoomId} is a ${parent.kind}; threads can only spawn from main rooms`);
+  }
+  const parentMembers = listRoomMembers(parentRoomId);
+  const isMember = parentMembers.some((m) => m.agentId === directorId);
+  if (!isMember) {
+    throw new Error(`createThread \xB7 director ${directorId} is not a member of parent room ${parentRoomId}`);
+  }
+  const db = getDb();
+  const id = newId();
+  const number = nextRoomNumber();
+  const now = Date.now();
+  const subject = parent.subject;
+  const name = subject.slice(0, 60);
+  const mode = parent.mode;
+  const intensity = parent.intensity;
+  const deliveryMode = "text";
+  const voteTrigger = "manual";
+  const insertRoom = db.prepare(
+    `INSERT INTO rooms (
+       id, number, name, subject, mode, intensity, delivery_mode, vote_trigger,
+       brief_style, status, created_at,
+       parent_room_id, parent_brief_id, name_auto, room_kind, thread_director_id
+     ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL, 'live', ?, ?, NULL, 1, 'thread', ?)`
+  );
+  const insertMember = db.prepare(
+    "INSERT INTO room_members (room_id, agent_id, position, joined_at) VALUES (?, ?, ?, ?)"
+  );
+  const tx = db.transaction(() => {
+    insertRoom.run(id, number, name, subject, mode, intensity, deliveryMode, voteTrigger, now, parentRoomId, directorId);
+    insertMember.run(id, directorId, 0, now);
+  });
+  tx();
+  return {
+    room: getRoom(id),
+    members: listRoomMembers(id)
+  };
+}
 function recentDirectorAppearances(windowSize) {
-  const rooms = getDb().prepare("SELECT id FROM rooms ORDER BY created_at DESC LIMIT ?").all(Math.max(1, Math.floor(windowSize)));
+  const rooms = getDb().prepare("SELECT id FROM rooms WHERE room_kind = 'main' ORDER BY created_at DESC LIMIT ?").all(Math.max(1, Math.floor(windowSize)));
   const counts = /* @__PURE__ */ new Map();
   if (rooms.length === 0) return counts;
   const placeholders = rooms.map(() => "?").join(",");
@@ -14344,6 +14432,18 @@ function setRoomNameFromAuto(roomId, name) {
   const r = getDb().prepare("UPDATE rooms SET name = ? WHERE id = ? AND name_auto = 1").run(trimmed, roomId);
   return r.changes > 0;
 }
+function forceRoomAutoName(roomId, name) {
+  const trimmed = name.trim();
+  if (!trimmed) return false;
+  const r = getDb().prepare("UPDATE rooms SET name = ?, name_auto = 1 WHERE id = ?").run(trimmed, roomId);
+  return r.changes > 0;
+}
+function setRoomSubject(roomId, next) {
+  const trimmed = next.trim();
+  if (!trimmed) return false;
+  const r = getDb().prepare("UPDATE rooms SET subject = ? WHERE id = ?").run(trimmed, roomId);
+  return r.changes > 0;
+}
 function addRoomMember(roomId, agentId) {
   const db = getDb();
   const existing = db.prepare("SELECT agent_id, position, joined_at, removed_at FROM room_members WHERE room_id = ? AND agent_id = ?").get(roomId, agentId);
@@ -14960,6 +15060,52 @@ function getActiveVoiceKeyPlaintext() {
   return getVoiceCredentialKey(active.id);
 }
 
+// src/storage/voice-labels.ts
+init_db();
+function rowToLabel(r) {
+  return {
+    voiceId: r.voice_id,
+    provider: r.provider,
+    label: r.label,
+    createdAt: r.created_at,
+    updatedAt: r.updated_at
+  };
+}
+function setVoiceLabel(input) {
+  const now = Date.now();
+  const id = (input.voiceId || "").trim();
+  const label = (input.label || "").trim();
+  if (!id || !label) return;
+  getDb().prepare(
+    `INSERT INTO voice_labels (voice_id, provider, label, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?)
+       ON CONFLICT(voice_id) DO UPDATE SET
+         provider = excluded.provider,
+         label = excluded.label,
+         updated_at = excluded.updated_at`
+  ).run(id, input.provider, label, now, now);
+}
+function getVoiceLabelMap(voiceIds) {
+  const out = /* @__PURE__ */ new Map();
+  if (voiceIds.length === 0) return out;
+  const CHUNK = 500;
+  for (let i = 0; i < voiceIds.length; i += CHUNK) {
+    const slice = voiceIds.slice(i, i + CHUNK);
+    const placeholders = slice.map(() => "?").join(",");
+    const rows = getDb().prepare(`SELECT voice_id, label FROM voice_labels WHERE voice_id IN (${placeholders})`).all(...slice);
+    for (const r of rows) out.set(r.voice_id, r.label);
+  }
+  return out;
+}
+function listVoiceLabels() {
+  const rows = getDb().prepare(`SELECT * FROM voice_labels ORDER BY updated_at DESC`).all();
+  return rows.map(rowToLabel);
+}
+function deleteVoiceLabel(voiceId) {
+  const r = getDb().prepare(`DELETE FROM voice_labels WHERE voice_id = ?`).run(voiceId);
+  return r.changes > 0;
+}
+
 // src/voice/registry.ts
 function minimaxBaseUrl() {
   const region = getPrefs().minimaxRegion;
@@ -15095,6 +15241,7 @@ async function fetchAllElevenLabsV2Voices(apiKey) {
       }
       const json = await res.json();
       const rows = elevenLabsV2VoiceRows(json.voices);
+      rows.sort((a, b) => elevenLabsCategoryRank(a.category) - elevenLabsCategoryRank(b.category));
       for (const r of rows) {
         out.push({
           provider: "elevenlabs",
@@ -15129,6 +15276,11 @@ async function fetchAllElevenLabsV2Voices(apiKey) {
   );
   return { voices: out, error: lastError };
 }
+function elevenLabsCategoryRank(category) {
+  if (category === "cloned" || category === "professional") return 0;
+  if (category === "generated") return 2;
+  return 1;
+}
 function elevenLabsV2VoiceRows(raw) {
   if (!Array.isArray(raw)) return [];
   const out = [];
@@ -15184,8 +15336,8 @@ async function fetchAllMiniMaxVoices(apiKey) {
     }
     const json = await res.json();
     const rows = [
-      ...voiceRows(json.system_voice, "system"),
       ...voiceRows(json.voice_cloning, "clone"),
+      ...voiceRows(json.system_voice, "system"),
       ...voiceRows(json.voice_generation, "generated")
     ];
     if (rows.length === 0) {
@@ -15249,7 +15401,7 @@ async function listVoicesPage(cursorStr, pageSize) {
   if (activeProvider === "elevenlabs") {
     const { voices: all, error } = await getElevenLabsVoicesCached(activeKey);
     const offset = cursor && cursor.src === "el" ? cursor.offset ?? 0 : 0;
-    const slice = all.slice(offset, offset + size);
+    const slice = mergeCustomLabels(all.slice(offset, offset + size));
     const next = offset + slice.length;
     const hasMore = next < all.length;
     const nextCursor = hasMore ? encodeCursor({ src: "el", offset: next }) : null;
@@ -15270,7 +15422,7 @@ async function listVoicesPage(cursorStr, pageSize) {
   if (activeProvider === "minimax") {
     const all = await getMiniMaxVoicesCached(activeKey);
     const offset = cursor && cursor.src === "mm" ? cursor.offset ?? 0 : 0;
-    const slice = all.slice(offset, offset + size);
+    const slice = mergeCustomLabels(all.slice(offset, offset + size));
     const next = offset + slice.length;
     const hasMore = next < all.length;
     const nextCursor = hasMore ? encodeCursor({ src: "mm", offset: next }) : null;
@@ -15286,6 +15438,22 @@ async function listVoicesPage(cursorStr, pageSize) {
     configured: true
   };
 }
+function mergeCustomLabels(voices) {
+  const ids = voices.map((v) => v.voiceId).filter((id) => !!id);
+  if (ids.length === 0) return voices;
+  const labelMap = getVoiceLabelMap(ids);
+  if (labelMap.size === 0) return voices;
+  return voices.map((v) => {
+    const custom = v.voiceId ? labelMap.get(v.voiceId) : void 0;
+    if (!custom) return v;
+    if (v.label && v.label !== v.voiceId) return v;
+    return { ...v, label: custom };
+  });
+}
+function invalidateVoicesCache() {
+  miniMaxCache.clear();
+  elevenLabsCache.clear();
+}
 async function listAvailableVoices() {
   const voices = [];
   let cursor = null;
@@ -19047,7 +19215,9 @@ var TONE_GUIDANCE = {
     "1\u20132 \u53E5\u3002\u7ED9\u8FD9\u4E2A idea \u4E00\u4E2A**\u66F4\u6709\u4F20\u64AD\u529B\u7684\u8BF4\u6CD5**\u2014\u2014\u4E00\u53E5 slogan\u3001\u4E00\u4E2A\u65B0\u540D\u5B57\u3001\u4E00\u4E2A\u5BF9\u5916\u8BB2\u5F97\u6E05\u695A\u7684\u5B9A\u4F4D\u3001\u4E00\u4E2A\u8BA9\u4EBA\u8BB0\u4F4F\u7684\u6BD4\u55BB\u3002",
     "",
     "\u3010\u4E00\u4E2A\u5177\u4F53\u505A\u6CD5\u3011",
-    "1\u20133 \u53E5\u3002\u7ED9\u4E00\u4E2A**\u6700\u5C0F\u53EF\u6267\u884C**\u7684\u5177\u4F53\u52A8\u4F5C / \u5B9E\u9A8C / \u7B2C\u4E00\u6B65\u5F62\u6001\u3002**\u4E0B\u5468\u5C31\u80FD\u505A\u7684\u4E8B**\uFF0C\u4E0D\u662F\u5B8F\u5927\u84DD\u56FE\u3002",
+    "1\u20133 \u53E5\u3002\u7ED9\u4E00\u4E2A**\u6700\u5C0F\u53EF\u6267\u884C**\u7684\u5177\u4F53\u52A8\u4F5C / \u5B9E\u9A8C / \u7B2C\u4E00\u6B65\u5F62\u6001\u2014\u2014\u53EF\u4EE5\u662F\u4E00\u4E2A\u539F\u578B\u3001\u4E00\u901A\u7535\u8BDD\u3001\u4E00\u6B21\u5C0F\u6D4B\u3001\u4E00\u4EFD\u8349\u6848\u3001\u4E00\u4E2A\u80FD\u8DD1\u901A\u7684\u6700\u5C0F\u95ED\u73AF\u3002\u91CD\u70B9\u662F\u300C\u80FD\u7ACB\u523B\u52A8\u624B\u3001\u89C4\u6A21\u53EF\u63A7\u300D\uFF0C\u4E0D\u662F\u5B8F\u5927\u84DD\u56FE\u3002",
+    "  \xB7 **\u4E0D\u8981\u7528\u6A21\u677F\u8154**\u5199\u300C\u4E0B\u5468\u5C31\u80FD\u505A\u7684\u4E8B\u300D\u300C\u8FD9\u5468\u5C31\u80FD\u52A8\u624B\u300D\u300C\u660E\u5929\u5C31\u80FD\u5F00\u59CB\u300D\u8FD9\u4E00\u7C7B**\u6B7B\u677F\u65F6\u95F4\u8868\u8FBE**\u2014\u2014\u4EFB\u4F55 director \u4E00\u65E6\u673A\u68B0\u590D\u8BFB\u300C\u4E0B\u5468\u5C31\u80FD\u505A\u300D\u300C\u4E0B\u5468\u53EF\u4EE5\u2026\u300D/\u300Cnext week we can\u2026\u300D/\u300Cby next week\u2026\u300D\uFF0C\u6574\u6BB5\u90FD\u4F1A\u88AB\u89C6\u4E3A\u6A21\u677F\u586B\u5145\u800C\u975E\u771F\u6B63\u8D21\u732E\u3002\u8FD9\u79CD phrasing **\u6574\u8F6E\u91CC\u6700\u591A\u51FA\u73B0\u4E00\u6B21**\uFF0C\u4E0D\u8981\u6BCF\u4E2A director \u90FD\u91CD\u590D\u3002",
+    "  \xB7 \u8868\u8FBE\u300C\u6700\u5C0F\u53EF\u6267\u884C\u300D\u7528\u5404\u81EA\u7684\u8BDD\uFF1A\u4F8B\u5982\u300C\u4E00\u4E2A\u4E0B\u5348\u5C31\u80FD\u62FC\u51FA\u539F\u578B\u300D\u300C\u5148\u627E 3 \u4E2A\u76EE\u6807\u7528\u6237\u804A\u4E00\u804A\u300D\u300C\u62FF\u73B0\u6210\u6570\u636E\u5148\u8DD1\u4E00\u7248\u300D\u300C\u5199\u4E00\u9875 brief \u53D1\u7ED9 X\u300D\u300C\u5728 X \u5E73\u53F0\u4E0A\u6302\u4E2A\u843D\u5730\u9875\u6D4B\u70B9\u51FB\u300D\u300C\u5148\u505A\u5185\u6D4B\u7248\u7ED9\u5C0F\u8303\u56F4\u7528\u6237\u300D\u2014\u2014\u4F60\u7684\u89D2\u8272\u80CC\u666F\u51B3\u5B9A\u4F60\u600E\u4E48\u63CF\u8FF0\u8FD9\u4E2A\u6700\u5C0F\u52A8\u4F5C\uFF0C\u800C\u4E0D\u662F\u5957\u65F6\u95F4\u8BCD\u3002",
     "",
     "\u3010\u6211\u8865\u5145\u7684\u65B0\u65B9\u5411\u3011",
     "1\u20133 \u53E5\u3002\u4ECE\u4F60\u72EC\u7279\u7684\u89D2\u8272\u89C6\u89D2\uFF0C\u5F00\u4E00\u4E2A**\u623F\u95F4\u91CC\u8FD8\u6CA1\u4EBA\u8BB2\u8FC7\u7684\u65B9\u5411**\u3002\u53EF\u4EE5\u662F\u90BB\u8FD1\u9886\u57DF\u7684\u7C7B\u6BD4\u3001\u672A\u88AB\u6CE8\u610F\u7684\u7528\u6237\u573A\u666F\u3001\u8DE8\u5B66\u79D1\u7684\u8FDE\u63A5\u3001\u534A\u6210\u54C1\u5F0F\u7684\u300C\u5982\u679C\u2026\u4F1A\u600E\u6837\u300D\u3002\u8FD9\u91CC\u662F\u4F60 contrarian DNA \u7684\u552F\u4E00\u51FA\u53E3\u2014\u2014\u628A\u5B83\u7528\u5728\u300C\u5F00\u522B\u4EBA\u6CA1\u5F00\u8FC7\u7684\u65B9\u5411\u300D\u4E0A\uFF0C\u4E0D\u662F\u300C\u6307\u51FA\u522B\u4EBA\u7684\u76F2\u70B9\u300D\u3002",
@@ -19349,6 +19519,15 @@ Name: ${prefs.name}
       interestLines.push(``);
     }
   }
+  const threadModeBlock = room.kind === "thread" ? [
+    ``,
+    `\u2500\u2500\u2500 PRIVATE ASIDE \xB7 1:1 WITH THE USER \u2500\u2500\u2500`,
+    `This is a private thread the user pulled you into from the main boardroom (room "${room.subject}"). The transcript below shows BOTH (a) the main room conversation up to the moment the user opened this thread, AND (b) this thread's own messages \u2014 chronologically merged so you have full context.`,
+    `Crucially: the other directors are NOT here. They cannot see this conversation. Anything you say below is between you and the user. The chair is not moderating; there is no round-robin; there will be no brief.`,
+    `Your posture \xB7 drop the "speak into the room" framing. You're having a candid 1:1 \u2014 be more personal, more specific, willing to commit to a view, willing to say what you wouldn't put on the record. Stay yourself (your lens, your discipline) but you don't have to "represent your seat" \u2014 just talk with this person.`,
+    `Do not address other directors by name as if they're listening (they aren't). You CAN reference what they said in the main room (it's part of your context) \u2014 "Socrates earlier framed it as X, but between you and me, I think the sharper question is \u2026".`,
+    `No \`@handle\` tokens in prose \u2014 the same handle-vs-name rule applies (use NAME if you reference someone, never the raw handle).`
+  ].join("\n") : "";
   const system = {
     role: "system",
     content: [
@@ -19359,6 +19538,7 @@ Name: ${prefs.name}
       `Other directors at the table:`,
       `  \xB7 ${others_summary}`,
       youSection,
+      ...threadModeBlock ? [threadModeBlock] : [],
       ...memoryBlock ? [memoryBlock] : [],
       ...interestLines,
       ...priorContext && priorContext.trim() ? [priorContext] : [],
@@ -19381,8 +19561,14 @@ Name: ${prefs.name}
       `\u2500\u2500\u2500 INTENSITY \xB7 ${intensity.toUpperCase()} \u2500\u2500\u2500`,
       intensityLine,
       ``,
-      `\u2500\u2500\u2500 ROUND MODE \xB7 ${opening ? "OPENING (PARALLEL)" : "REACTIVE"} \u2500\u2500\u2500`,
-      opening ? OPENING_BLOCK : REACTIVE_BLOCK,
+      // Round-mode block is only meaningful in main rooms (opening
+      // parallel sweep vs reactive build-on). Threads are a continuous
+      // 1:1 with no rounds, no peers — skip this block entirely so the
+      // model isn't told to "engage other directors" who aren't here.
+      ...room.kind === "thread" ? [] : [
+        `\u2500\u2500\u2500 ROUND MODE \xB7 ${opening ? "OPENING (PARALLEL)" : "REACTIVE"} \u2500\u2500\u2500`,
+        opening ? OPENING_BLOCK : REACTIVE_BLOCK
+      ],
       ...chairBriefBlock ? [chairBriefBlock] : [],
       ...activeSkillsBlock ? ["", activeSkillsBlock] : [],
       ...sharedMaterials && sharedMaterials.trim() ? ["", sharedMaterials] : [],
@@ -20265,6 +20451,15 @@ function extractProviderHint(message) {
 // src/orchestrator/context.ts
 function buildDirectorContext(roomId) {
   const room = getRoom(roomId);
+  if (room && room.kind === "thread" && room.parentRoomId) {
+    const threadOwn = listMessages(roomId);
+    const parentSnapshot = listMessages(room.parentRoomId).filter((m) => m.createdAt < room.createdAt);
+    const merged = [...parentSnapshot, ...threadOwn].sort(
+      (a, b) => a.createdAt - b.createdAt
+    );
+    const currentRound2 = merged.length > 0 ? Math.max(...merged.map((m) => m.roundNum ?? 0), 0) : 0;
+    return { historyMessages: merged, summaryPreamble: "", currentRound: currentRound2 };
+  }
   const allMessages = listMessages(roomId);
   if (allMessages.length === 0) {
     return { historyMessages: [], summaryPreamble: "", currentRound: 0 };
@@ -21137,7 +21332,7 @@ function tickRoom(roomId, opts) {
   state.maxSpeakersThisTurn = plan.length;
   emitQueueUpdate(roomId, state);
   const tickKind = opts.kind ?? "user";
-  if (!opts.forceSpeakerId && tickKind !== "force") {
+  if (!opts.forceSpeakerId && tickKind !== "force" && room.kind !== "thread") {
     announceRoundOpen(roomId, opts.roundNum, tickKind === "user");
   }
   rlog(roomId, "tick", {
@@ -21669,6 +21864,9 @@ async function pumpQueue(roomId) {
     });
     if (reachedCap) {
       const room = getRoom(roomId);
+      if (room && room.kind === "thread") {
+        return;
+      }
       if (room && room.status === "live" && !room.awaitingContinue && !room.awaitingClarify && room.voteTrigger === "manual") {
         const nextRound = nextUserRoundNum(roomId);
         rlog(roomId, "manual-auto-continue", {
@@ -23968,17 +24166,44 @@ var REJECT_PHRASES = /* @__PURE__ */ new Set([
 ]);
 async function generateRoomTitle(roomId) {
   const room = getRoom(roomId);
-  if (!room) return { kind: "skipped", reason: "no-room" };
-  if (!room.nameAuto) return { kind: "skipped", reason: "user-named" };
+  if (!room) {
+    process.stderr.write(`[room-title] room=${roomId} skip=no-room
+`);
+    return { kind: "skipped", reason: "no-room" };
+  }
+  if (!room.nameAuto) {
+    process.stderr.write(`[room-title] room=${roomId} kind=${room.kind} skip=user-named
+`);
+    return { kind: "skipped", reason: "user-named" };
+  }
   const subject = room.subject.trim();
-  if (!subject) return { kind: "skipped", reason: "no-subject" };
+  if (!subject) {
+    process.stderr.write(`[room-title] room=${roomId} kind=${room.kind} skip=no-subject
+`);
+    return { kind: "skipped", reason: "no-subject" };
+  }
   const fallbackName = room.subject.slice(0, 60);
   if (room.name !== fallbackName) {
+    process.stderr.write(
+      `[room-title] room=${roomId} kind=${room.kind} skip=already-renamed name="${room.name.slice(0, 30)}" fallback="${fallbackName.slice(0, 30)}"
+`
+    );
     return { kind: "skipped", reason: "already-renamed", detail: room.name.slice(0, 60) };
   }
-  const modelV = utilityModelFor();
-  if (!modelV) return { kind: "skipped", reason: "no-model" };
-  const prompt = `You are titling a conversation for a sidebar entry, the way ChatGPT does it. Read the user's opening question and write the title that another reader would expect to see for THIS conversation \u2014 specific enough to distinguish it from any neighbouring entry in the same domain.
+  const r = await distillTitle(subject, `room=${roomId} kind=${room.kind}`);
+  if (!r.ok) return { kind: "skipped", reason: r.reason, detail: r.detail };
+  const updated = setRoomNameFromAuto(roomId, r.phrase);
+  if (!updated) return { kind: "skipped", reason: "race-after-rename" };
+  roomBus.emit(roomId, {
+    type: "config-event",
+    kind: "settings-changed",
+    payload: { changes: { name: { from: room.name, to: r.phrase } } },
+    createdAt: Date.now()
+  });
+  return { kind: "ok", before: room.name, after: r.phrase };
+}
+function buildTitlePrompt(text) {
+  return `You are titling a conversation for a sidebar entry, the way ChatGPT does it. Read the user's opening question and write the title that another reader would expect to see for THIS conversation \u2014 specific enough to distinguish it from any neighbouring entry in the same domain.
 
 How to write a representative title:
 1. Identify the CORE SUBJECT or TASK (the noun, the deliverable, the decision being made).
@@ -24013,47 +24238,95 @@ Input: I want to redesign our onboarding email sequence \u2014 currently 5 email
 Output: Onboarding email redesign
 
 --- User's opening question ---
-${subject}
+${text}
 
 --- Title ---
 `;
+}
+async function distillTitle(text, ctx) {
+  const modelV = utilityModelFor();
+  if (!modelV) {
+    process.stderr.write(`[room-title] ${ctx} skip=no-model
+`);
+    return { ok: false, reason: "no-model" };
+  }
+  process.stderr.write(`[room-title] ${ctx} model=${modelV} input="${text.slice(0, 40)}\u2026" \xB7 calling LLM
+`);
   let raw = "";
   try {
     raw = await callLLM({
       modelV,
       carrier: null,
-      messages: [{ role: "user", content: prompt }],
-      // Low but not zero · 0.2 was deterministic-ish but kept locking
-      // onto a generic first-noun pick. 0.4 lets the model trade off
-      // alternatives without wandering into creative territory.
+      messages: [{ role: "user", content: buildTitlePrompt(text) }],
+      // Low but not zero · 0.2 kept locking onto a generic first-noun
+      // pick; 0.4 lets the model trade off alternatives without
+      // wandering into creative territory.
       temperature: 0.4,
-      // 40 was tight enough that a model thinking briefly before
-      // answering would get cut off mid-title; 80 fits the title plus
-      // a small margin without inviting paragraphs.
+      // 40 truncated mid-title for models that think briefly first;
+      // 80 fits the title plus margin without inviting paragraphs.
       maxTokens: 80
     });
   } catch (e) {
     const detail = e instanceof Error ? e.message : String(e);
-    process.stderr.write(`[room-title] LLM call failed for ${roomId}: ${detail}
+    process.stderr.write(`[room-title] ${ctx} LLM call failed: ${detail}
 `);
-    return { kind: "skipped", reason: "llm-error", detail };
+    return { ok: false, reason: "llm-error", detail };
   }
   if (!raw.trim()) {
-    return { kind: "skipped", reason: "empty-output", detail: `model=${modelV}` };
+    process.stderr.write(`[room-title] ${ctx} skip=empty-output model=${modelV}
+`);
+    return { ok: false, reason: "empty-output", detail: `model=${modelV}` };
   }
   const phrase = sanitiseTitle(raw);
   if (!phrase) {
-    return { kind: "skipped", reason: "rejected-generic", detail: raw.trim().slice(0, 80) };
+    process.stderr.write(`[room-title] ${ctx} skip=rejected-generic raw="${raw.trim().slice(0, 80)}"
+`);
+    return { ok: false, reason: "rejected-generic", detail: raw.trim().slice(0, 80) };
+  }
+  process.stderr.write(`[room-title] ${ctx} llm_raw="${raw.trim().slice(0, 60)}" phrase="${phrase}"
+`);
+  return { ok: true, phrase };
+}
+function threadSeedText(body) {
+  return body.replace(/^\s*[—–-]\s*@.*$/gm, "").replace(/^\s*>\s?/gm, "").replace(/\n{2,}/g, "\n").trim();
+}
+async function generateThreadTitle(threadId) {
+  const room = getRoom(threadId);
+  if (!room) {
+    process.stderr.write(`[thread-title] thread=${threadId} skip=no-room
+`);
+    return { kind: "skipped", reason: "no-room" };
+  }
+  if (room.kind !== "thread") {
+    return { kind: "skipped", reason: "not-thread" };
+  }
+  const firstUser = listMessages(threadId).find((m) => m.authorKind === "user");
+  if (!firstUser || !firstUser.body.trim()) {
+    return { kind: "skipped", reason: "no-message" };
+  }
+  const seed = threadSeedText(firstUser.body);
+  if (!seed) {
+    return { kind: "skipped", reason: "no-subject" };
+  }
+  const name = (room.name || "").trim();
+  const isPlaceholder = /^thread:/.test(name);
+  const isRawTruncation = name === room.subject.slice(0, 60) || name === firstUser.body.slice(0, 60);
+  if (!isPlaceholder && !isRawTruncation) {
+    return { kind: "skipped", reason: "already-renamed", detail: name.slice(0, 60) };
   }
-  const updated = setRoomNameFromAuto(roomId, phrase);
+  const r = await distillTitle(seed, `thread=${threadId}`);
+  if (!r.ok) return { kind: "skipped", reason: r.reason, detail: r.detail };
+  const updated = forceRoomAutoName(threadId, r.phrase);
   if (!updated) return { kind: "skipped", reason: "race-after-rename" };
-  roomBus.emit(roomId, {
+  roomBus.emit(threadId, {
     type: "config-event",
     kind: "settings-changed",
-    payload: { changes: { name: { from: room.name, to: phrase } } },
+    payload: { changes: { name: { from: name, to: r.phrase } } },
     createdAt: Date.now()
   });
-  return { kind: "ok", before: room.name, after: phrase };
+  process.stderr.write(`[thread-title] OK thread=${threadId} "${name.slice(0, 30)}" \u2192 "${r.phrase}"
+`);
+  return { kind: "ok", before: name, after: r.phrase };
 }
 function sanitiseTitle(raw) {
   let s = raw.trim();
@@ -24448,6 +24721,16 @@ function roomsRouter() {
       return c.json({ deferred: true });
     }
     const roundNum = nextUserRoundNum(id);
+    let triggerThreadTitle = false;
+    if (room.kind === "thread") {
+      const priorMsgs = listMessages(id);
+      const priorUser = priorMsgs.some((m) => m.authorKind === "user");
+      if (!priorUser) {
+        setRoomSubject(id, text);
+        setRoomNameFromAuto(id, text.slice(0, 60));
+        triggerThreadTitle = true;
+      }
+    }
     const msg = insertMessage({
       roomId: id,
       authorKind: "user",
@@ -24456,6 +24739,32 @@ function roomsRouter() {
       meta: mentions.length ? { mentions } : {},
       roundNum
     });
+    if (triggerThreadTitle) {
+      const before = getRoom(id);
+      process.stderr.write(
+        `[thread-title] firing for thread=${id} subject="${(before?.subject ?? "").slice(0, 40)}" name="${before?.name ?? ""}" nameAuto=${before?.nameAuto}
+`
+      );
+      generateThreadTitle(id).then((result) => {
+        if (result.kind === "ok") {
+          process.stderr.write(
+            `[thread-title] OK thread=${id} "${result.before.slice(0, 40)}" \u2192 "${result.after}"
+`
+          );
+        } else {
+          const tail = result.detail ? ` detail="${result.detail.slice(0, 100)}"` : "";
+          process.stderr.write(
+            `[thread-title] SKIP thread=${id} reason=${result.reason}${tail}
+`
+          );
+        }
+      }).catch((e) => {
+        process.stderr.write(
+          `[thread-title] THROW thread=${id} ${e instanceof Error ? e.message : String(e)}
+`
+        );
+      });
+    }
     roomBus.emit(id, {
       type: "message-appended",
       messageId: msg.id,
@@ -24493,7 +24802,7 @@ function roomsRouter() {
       return c.json(msg);
     }
     const chair = getChairAgent();
-    const chairMentioned = !!chair && (mentions.includes(chair.id) || /(?:^|\s)@chair\b/i.test(text));
+    const chairMentioned = !!chair && room.kind !== "thread" && (mentions.includes(chair.id) || /(?:^|\s)@chair\b/i.test(text));
     if (chairMentioned) {
       void chairInterrupt(id).catch((e) => {
         process.stderr.write(
@@ -24512,6 +24821,62 @@ function roomsRouter() {
     abortRoom(id);
     return c.json({ ok: true });
   });
+  r.post("/:id/threads", async (c) => {
+    const parentId = c.req.param("id");
+    const parent = getRoom(parentId);
+    if (!parent) return c.json({ error: "parent room not found" }, 404);
+    if (parent.kind !== "main") {
+      return c.json({ error: "threads can only spawn from main rooms" }, 400);
+    }
+    let body;
+    try {
+      body = await c.req.json();
+    } catch {
+      return c.json({ error: "invalid JSON body" }, 400);
+    }
+    const b = body ?? {};
+    const directorId = typeof b.directorId === "string" ? b.directorId.trim() : "";
+    if (!directorId) return c.json({ error: "directorId is required" }, 400);
+    const agent = getAgent(directorId);
+    if (!agent) return c.json({ error: "director not found" }, 404);
+    if (agent.roleKind === "moderator") {
+      return c.json({ error: "cannot open a thread with the chair" }, 400);
+    }
+    try {
+      const existing = listThreadsForRoom(parentId, { directorId });
+      if (existing.length > 0) {
+        const newest = existing[0];
+        const members = listRoomMembers(newest.id);
+        return c.json({ room: newest, members });
+      }
+      const result = createThread(parentId, directorId);
+      return c.json(result);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      return c.json({ error: msg }, 400);
+    }
+  });
+  r.get("/:id/threads", (c) => {
+    const parentId = c.req.param("id");
+    if (!getRoom(parentId)) return c.json({ error: "not found" }, 404);
+    const directorId = c.req.query("directorId");
+    const threads = listThreadsForRoom(
+      parentId,
+      directorId ? { directorId } : {}
+    );
+    const enriched = threads.map((t) => {
+      const msgs = listMessages(t.id);
+      const messageCount = msgs.filter(
+        (m) => !(m.meta?.streaming === true)
+      ).length;
+      return { ...t, messageCount };
+    });
+    for (const t of enriched) {
+      if (t.messageCount > 0) void generateThreadTitle(t.id).catch(() => {
+      });
+    }
+    return c.json({ threads: enriched });
+  });
   r.post("/:id/messages/:messageId/voice-done", (c) => {
     const id = c.req.param("id");
     const messageId = c.req.param("messageId");
@@ -25319,8 +25684,650 @@ function usageRouter() {
   return r;
 }
 
-// src/routes/voice-credentials.ts
+// src/routes/voice-clone.ts
 import { Hono as Hono13 } from "hono";
+import { streamSSE as streamSSE3 } from "hono/streaming";
+import { randomBytes as randomBytes9 } from "crypto";
+import { mkdirSync as mkdirSync2, writeFileSync, statSync as statSync2, rmSync, existsSync as existsSync2 } from "fs";
+import { tmpdir } from "os";
+import { join as join4 } from "path";
+
+// src/storage/clone-jobs.ts
+init_db();
+import { randomBytes as randomBytes7 } from "crypto";
+function rowToJob(r) {
+  return {
+    id: r.id,
+    agentId: r.agent_id,
+    provider: r.provider,
+    sourceKind: r.source_kind,
+    sourceRef: r.source_ref,
+    label: r.label,
+    status: r.status,
+    currentStage: r.current_stage,
+    pct: r.pct,
+    voiceId: r.voice_id,
+    errorCode: r.error_code,
+    errorMessage: r.error_message,
+    createdAt: r.created_at,
+    updatedAt: r.updated_at
+  };
+}
+function createCloneJob(input) {
+  const id = randomBytes7(8).toString("hex");
+  const now = Date.now();
+  getDb().prepare(
+    `INSERT INTO clone_jobs (id, agent_id, provider, source_kind, source_ref, label,
+                               status, current_stage, pct, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, 'queued', 'fetch', 0, ?, ?)`
+  ).run(id, input.agentId, input.provider, input.sourceKind, input.sourceRef, input.label ?? null, now, now);
+  const row = getDb().prepare(`SELECT * FROM clone_jobs WHERE id = ?`).get(id);
+  return rowToJob(row);
+}
+function getCloneJob(id) {
+  const row = getDb().prepare(`SELECT * FROM clone_jobs WHERE id = ?`).get(id);
+  return row ? rowToJob(row) : null;
+}
+function findActiveJobForAgent(agentId) {
+  const row = getDb().prepare(`SELECT * FROM clone_jobs WHERE agent_id = ? AND status IN ('queued', 'running') ORDER BY created_at DESC LIMIT 1`).get(agentId);
+  return row ? rowToJob(row) : null;
+}
+function findAnyActiveJob() {
+  const row = getDb().prepare(`SELECT * FROM clone_jobs WHERE status IN ('queued', 'running') ORDER BY created_at DESC LIMIT 1`).get();
+  return row ? rowToJob(row) : null;
+}
+function updateCloneJobProgress(id, patch) {
+  const cur = getCloneJob(id);
+  if (!cur) return null;
+  const next = {
+    status: patch.status ?? cur.status,
+    currentStage: patch.currentStage ?? cur.currentStage,
+    pct: patch.pct ?? cur.pct,
+    voiceId: patch.voiceId !== void 0 ? patch.voiceId : cur.voiceId,
+    errorCode: patch.errorCode !== void 0 ? patch.errorCode : cur.errorCode,
+    errorMessage: patch.errorMessage !== void 0 ? patch.errorMessage : cur.errorMessage
+  };
+  getDb().prepare(
+    `UPDATE clone_jobs SET status=?, current_stage=?, pct=?, voice_id=?, error_code=?, error_message=?, updated_at=?
+       WHERE id=?`
+  ).run(
+    next.status,
+    next.currentStage,
+    next.pct,
+    next.voiceId,
+    next.errorCode,
+    next.errorMessage,
+    Date.now(),
+    id
+  );
+  return getCloneJob(id);
+}
+function recoverStuckCloneJobs() {
+  const r = getDb().prepare(
+    `UPDATE clone_jobs
+       SET status = 'failed',
+           error_code = COALESCE(error_code, 'interrupted'),
+           error_message = COALESCE(error_message, 'Process restarted while clone was in progress.'),
+           updated_at = ?
+       WHERE status IN ('queued', 'running')`
+  ).run(Date.now());
+  return r.changes;
+}
+
+// src/voice/clone.ts
+import { readFileSync, statSync } from "fs";
+import { basename } from "path";
+import { randomBytes as randomBytes8 } from "crypto";
+var CloneError = class extends Error {
+  code;
+  detail;
+  constructor(code, message, detail = "") {
+    super(message);
+    this.name = "CloneError";
+    this.code = code;
+    this.detail = detail;
+  }
+};
+var MAX_AUDIO_BYTES = 20 * 1024 * 1024;
+var MIN_AUDIO_BYTES = 32 * 1024;
+function extractMiniMaxGroupId(jwt) {
+  const parts = jwt.split(".");
+  if (parts.length !== 3) return null;
+  try {
+    const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf8"));
+    const candidates = ["GroupID", "group_id", "groupId", "g"];
+    for (const k of candidates) {
+      const v = payload[k];
+      if (typeof v === "string" && v.trim()) return v.trim();
+    }
+  } catch {
+  }
+  return null;
+}
+async function cloneFromAudio(input) {
+  validateAudioFile(input.audioPath);
+  if (input.provider === "minimax") return cloneMiniMax(input);
+  if (input.provider === "elevenlabs") return cloneElevenLabs(input);
+  throw new CloneError("provider_unknown", `Unsupported provider ${String(input.provider)}`);
+}
+function validateAudioFile(path) {
+  let size;
+  try {
+    size = statSync(path).size;
+  } catch (e) {
+    throw new CloneError("audio_unreadable", "Could not read audio file", String(e));
+  }
+  if (size < MIN_AUDIO_BYTES) throw new CloneError("audio_too_short", "Audio file is too small to clone from");
+  if (size > MAX_AUDIO_BYTES) throw new CloneError("audio_too_large", "Audio file exceeds 20MB");
+}
+async function cloneMiniMax(input) {
+  const groupId = input.miniMaxGroupId && input.miniMaxGroupId.trim() || extractMiniMaxGroupId(input.apiKey);
+  if (!groupId) {
+    throw new CloneError(
+      "missing_group_id",
+      'MiniMax needs a Group ID for voice cloning. Paste it into the "MiniMax Group ID" field on the clone dialog, or re-paste a JWT-format key that already carries the ID.'
+    );
+  }
+  const baseUrl = input.miniMaxBaseUrl || "https://api.minimaxi.com";
+  input.onProgress?.(0, "upload");
+  const fileBuf = readFileSync(input.audioPath);
+  const fileName = basename(input.audioPath);
+  const upRes = await streamMultipartUpload({
+    url: `${baseUrl}/v1/files/upload?GroupId=${encodeURIComponent(groupId)}`,
+    headers: { "authorization": `Bearer ${input.apiKey}` },
+    fields: { purpose: "voice_clone" },
+    files: [{ fieldName: "file", bytes: fileBuf, mime: mimeForName(fileName), fileName }],
+    onProgress: (pct) => input.onProgress?.(pct, "upload"),
+    signal: input.signal
+  });
+  if (!upRes.ok) throw await translateMinimaxError(upRes, "upload");
+  const upJson = await upRes.json();
+  const fileId = upJson.file?.file_id;
+  if (!fileId) {
+    const msg = upJson.base_resp?.status_msg || "unknown error";
+    throw new CloneError("provider_unknown", `MiniMax upload returned no file_id: ${msg}`);
+  }
+  input.onProgress?.(100, "upload");
+  input.onProgress?.(0, "clone");
+  const voiceId = buildMiniMaxVoiceId(input.agentId, input.label || null);
+  const cloneRes = await fetch(`${baseUrl}/v1/voice_clone?GroupId=${encodeURIComponent(groupId)}`, {
+    method: "POST",
+    headers: {
+      "authorization": `Bearer ${input.apiKey}`,
+      "content-type": "application/json"
+    },
+    body: JSON.stringify({
+      file_id: fileId,
+      voice_id: voiceId,
+      need_noise_reduction: true,
+      need_volume_normalization: true
+    }),
+    signal: input.signal
+  });
+  if (!cloneRes.ok) throw await translateMinimaxError(cloneRes, "clone");
+  const cloneJson = await cloneRes.json();
+  const status = cloneJson.base_resp?.status_code ?? 0;
+  if (status !== 0) {
+    const msg = cloneJson.base_resp?.status_msg || "unknown error";
+    if (status === 1008 || /insufficient/i.test(msg)) {
+      throw new CloneError("provider_quota", "MiniMax balance is insufficient for voice cloning.", msg);
+    }
+    if (/voice[_ ]id/i.test(msg)) {
+      throw new CloneError("provider_invalid_voice_id", `MiniMax rejected the voice_id: ${msg}`);
+    }
+    throw new CloneError("provider_unknown", `MiniMax voice_clone failed (${status}): ${msg}`);
+  }
+  input.onProgress?.(100, "clone");
+  return { voiceId, label: input.label?.trim() || `Cloned \xB7 ${voiceId}` };
+}
+async function translateMinimaxError(res, where) {
+  const text = await res.text().catch(() => "");
+  if (res.status === 401 || res.status === 403) {
+    return new CloneError("provider_auth", "MiniMax rejected the API key. Re-check it in voice settings.", text);
+  }
+  if (res.status === 402 || /insufficient/i.test(text)) {
+    return new CloneError("provider_quota", "MiniMax balance is insufficient for voice cloning.", text);
+  }
+  return new CloneError("provider_unknown", `MiniMax ${where} returned HTTP ${res.status}`, text);
+}
+function buildMiniMaxVoiceId(agentId, label) {
+  const ts = Date.now().toString(36);
+  const sanitizedLabel = (label || "").replace(/[^A-Za-z0-9_-]/g, "").slice(0, 16);
+  if (sanitizedLabel && sanitizedLabel.length >= 2) {
+    return `${sanitizedLabel}_${ts}`;
+  }
+  const safeAgent = agentId.replace(/[^A-Za-z0-9]/g, "").slice(0, 8) || "director";
+  return `pb_${safeAgent}_${ts}`;
+}
+async function cloneElevenLabs(input) {
+  input.onProgress?.(0, "upload");
+  const fileBuf = readFileSync(input.audioPath);
+  const fileName = basename(input.audioPath);
+  const label = input.label?.trim() || `Cloned \xB7 ${input.agentId.slice(0, 8)}`;
+  const res = await streamMultipartUpload({
+    url: `https://api.elevenlabs.io/v1/voices/add`,
+    headers: { "xi-api-key": input.apiKey },
+    fields: { name: label },
+    files: [{ fieldName: "files", bytes: fileBuf, mime: mimeForName(fileName), fileName }],
+    onProgress: (pct) => input.onProgress?.(pct, "upload"),
+    signal: input.signal
+  });
+  input.onProgress?.(100, "upload");
+  input.onProgress?.(0, "clone");
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    if (res.status === 401) throw new CloneError("provider_auth", "ElevenLabs rejected the API key.", text);
+    if (res.status === 402 || /paid_plan_required|quota_exceeded|insufficient/i.test(text)) {
+      throw new CloneError("provider_quota", "ElevenLabs subscription doesn't allow voice cloning, or you're out of credits.", text);
+    }
+    throw new CloneError("provider_unknown", `ElevenLabs voices/add returned HTTP ${res.status}`, text);
+  }
+  const json = await res.json();
+  const voiceId = json.voice_id;
+  if (!voiceId) throw new CloneError("provider_unknown", "ElevenLabs returned no voice_id");
+  input.onProgress?.(100, "clone");
+  return { voiceId, label };
+}
+async function streamMultipartUpload(opts) {
+  const boundary = `----pb-vc-${randomBytes8(8).toString("hex")}`;
+  const CRLF = "\r\n";
+  const enc = (s) => Buffer.from(s, "utf8");
+  const partsBeforeFiles = [];
+  for (const [k, v] of Object.entries(opts.fields)) {
+    partsBeforeFiles.push(enc(`--${boundary}${CRLF}`));
+    partsBeforeFiles.push(enc(`Content-Disposition: form-data; name="${k}"${CRLF}${CRLF}`));
+    partsBeforeFiles.push(enc(`${v}${CRLF}`));
+  }
+  const filePreludes = opts.files.map((f) => enc(
+    `--${boundary}${CRLF}Content-Disposition: form-data; name="${f.fieldName}"; filename="${f.fileName}"${CRLF}Content-Type: ${f.mime}${CRLF}${CRLF}`
+  ));
+  const fileEndings = opts.files.map(() => enc(CRLF));
+  const closing = enc(`--${boundary}--${CRLF}`);
+  let total = 0;
+  for (const b of partsBeforeFiles) total += b.length;
+  for (let i = 0; i < opts.files.length; i++) {
+    total += filePreludes[i].length + opts.files[i].bytes.length + fileEndings[i].length;
+  }
+  total += closing.length;
+  const CHUNK_SIZE = 64 * 1024;
+  let step = { kind: "fixed", idx: 0, list: partsBeforeFiles };
+  let sent = 0;
+  const stream = new ReadableStream({
+    pull(controller) {
+      for (; ; ) {
+        if (step.kind === "done") {
+          controller.close();
+          return;
+        }
+        if (step.kind === "fixed") {
+          if (step.idx >= step.list.length) {
+            if (opts.files.length === 0) step = { kind: "closing" };
+            else {
+              controller.enqueue(filePreludes[0]);
+              sent += filePreludes[0].length;
+              opts.onProgress?.(Math.min(99, sent / total * 100));
+              step = { kind: "fileBody", fileIdx: 0, off: 0 };
+              return;
+            }
+            continue;
+          }
+          const chunk = step.list[step.idx++];
+          controller.enqueue(chunk);
+          sent += chunk.length;
+          opts.onProgress?.(Math.min(99, sent / total * 100));
+          return;
+        }
+        if (step.kind === "fileBody") {
+          const file = opts.files[step.fileIdx];
+          if (step.off >= file.bytes.length) {
+            const ending = fileEndings[step.fileIdx];
+            controller.enqueue(ending);
+            sent += ending.length;
+            opts.onProgress?.(Math.min(99, sent / total * 100));
+            const nextIdx = step.fileIdx + 1;
+            if (nextIdx >= opts.files.length) {
+              step = { kind: "closing" };
+            } else {
+              controller.enqueue(filePreludes[nextIdx]);
+              sent += filePreludes[nextIdx].length;
+              opts.onProgress?.(Math.min(99, sent / total * 100));
+              step = { kind: "fileBody", fileIdx: nextIdx, off: 0 };
+            }
+            return;
+          }
+          const slice = file.bytes.subarray(step.off, step.off + CHUNK_SIZE);
+          controller.enqueue(slice);
+          step.off += slice.length;
+          sent += slice.length;
+          opts.onProgress?.(Math.min(99, sent / total * 100));
+          return;
+        }
+        if (step.kind === "closing") {
+          controller.enqueue(closing);
+          sent += closing.length;
+          opts.onProgress?.(100);
+          step = { kind: "done" };
+          return;
+        }
+      }
+    },
+    cancel() {
+      step = { kind: "done" };
+    }
+  });
+  const fetchInit = {
+    method: "POST",
+    headers: {
+      ...opts.headers,
+      "content-type": `multipart/form-data; boundary=${boundary}`,
+      "content-length": String(total)
+    },
+    body: stream,
+    duplex: "half",
+    signal: opts.signal
+  };
+  return await fetch(opts.url, fetchInit);
+}
+function mimeForName(name) {
+  const lower = name.toLowerCase();
+  if (lower.endsWith(".mp3")) return "audio/mpeg";
+  if (lower.endsWith(".m4a")) return "audio/mp4";
+  if (lower.endsWith(".wav")) return "audio/wav";
+  if (lower.endsWith(".webm")) return "audio/webm";
+  if (lower.endsWith(".ogg")) return "audio/ogg";
+  return "application/octet-stream";
+}
+
+// src/routes/voice-clone.ts
+var listeners = /* @__PURE__ */ new Map();
+function emit(ev) {
+  const set = listeners.get(ev.jobId);
+  if (!set) return;
+  for (const fn of set) {
+    try {
+      fn(ev);
+    } catch {
+    }
+  }
+}
+function subscribe(jobId, fn) {
+  let set = listeners.get(jobId);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(jobId, set);
+  }
+  set.add(fn);
+  return () => {
+    set?.delete(fn);
+    if (set?.size === 0) listeners.delete(jobId);
+  };
+}
+var aborters = /* @__PURE__ */ new Map();
+var workerExtras = /* @__PURE__ */ new Map();
+function overallPct(stage, innerPct) {
+  const stageIdx = stage === "fetch" ? 0 : stage === "upload" ? 1 : 2;
+  return Math.round(stageIdx * (100 / 3) + innerPct / 3);
+}
+function pushProgress(jobId, stage, innerPct, message) {
+  const pct = overallPct(stage, innerPct);
+  updateCloneJobProgress(jobId, { status: "running", currentStage: stage, pct });
+  emit({ jobId, stage, pct, status: "running", message, ts: Date.now() });
+}
+async function runWorker(job) {
+  const aborter = new AbortController();
+  aborters.set(job.id, aborter);
+  try {
+    const apiKey = getActiveVoiceKeyPlaintext();
+    if (!apiKey) {
+      throw new CloneError("provider_auth", "No active voice credential. Configure one in voice settings first.");
+    }
+    const audioPath = job.sourceRef;
+    pushProgress(job.id, "fetch", 100, "Using uploaded audio");
+    const extras = workerExtras.get(job.id) || {};
+    const { voiceId, label } = await cloneFromAudio({
+      provider: job.provider,
+      apiKey,
+      audioPath,
+      agentId: job.agentId,
+      label: job.label,
+      miniMaxBaseUrl: job.provider === "minimax" ? minimaxBaseUrlFromPref() : void 0,
+      miniMaxGroupId: job.provider === "minimax" && typeof extras.miniMaxGroupId === "string" ? extras.miniMaxGroupId : null,
+      signal: aborter.signal,
+      onProgress: (pct, stage) => {
+        if (aborter.signal.aborted) return;
+        pushProgress(job.id, stage, pct);
+      }
+    });
+    const agent = getAgent(job.agentId);
+    const existing = agent?.voice;
+    const cloneModel = job.provider === "minimax" ? "speech-2.8-hd" : "eleven_multilingual_v2";
+    const updated = updateAgent(job.agentId, {
+      voice: {
+        provider: job.provider,
+        model: cloneModel,
+        voiceId,
+        ...existing?.speed != null ? { speed: existing.speed } : {},
+        ...existing?.pitch != null ? { pitch: existing.pitch } : {},
+        ...existing?.volume != null ? { volume: existing.volume } : {},
+        ...existing?.emotion ? { emotion: existing.emotion } : {}
+      }
+    });
+    if (updated?.voice) writeVoiceBucketEntry(job.agentId, job.provider, updated.voice);
+    if (job.label) setVoiceLabel({ voiceId, provider: job.provider, label: job.label });
+    invalidateVoicesCache();
+    updateCloneJobProgress(job.id, {
+      status: "done",
+      currentStage: "clone",
+      pct: 100,
+      voiceId,
+      errorCode: null,
+      errorMessage: null
+    });
+    emit({
+      jobId: job.id,
+      stage: "clone",
+      pct: 100,
+      status: "done",
+      voiceId,
+      message: label,
+      provider: job.provider,
+      ts: Date.now()
+    });
+  } catch (e) {
+    const { code, message } = normaliseError(e);
+    updateCloneJobProgress(job.id, {
+      status: aborters.has(job.id) ? "failed" : "cancelled",
+      errorCode: code,
+      errorMessage: message
+    });
+    emit({
+      jobId: job.id,
+      stage: getCloneJob(job.id)?.currentStage || "fetch",
+      pct: getCloneJob(job.id)?.pct ?? 0,
+      status: aborters.has(job.id) ? "failed" : "cancelled",
+      errorCode: code,
+      errorMessage: message,
+      ts: Date.now()
+    });
+  } finally {
+    aborters.delete(job.id);
+    workerExtras.delete(job.id);
+  }
+}
+function normaliseError(e) {
+  if (e instanceof CloneError) {
+    const detail = e.detail ? `
+${e.detail.slice(-360)}` : "";
+    return { code: e.code, message: `${e.message}${detail}` };
+  }
+  if (e instanceof Error && e.name === "AbortError") return { code: "cancelled", message: "Clone was cancelled." };
+  return { code: "unknown", message: e instanceof Error ? e.message : String(e) };
+}
+function minimaxBaseUrlFromPref() {
+  try {
+    const region = getPrefs().minimaxRegion;
+    return region === "intl" ? "https://api.minimax.io" : "https://api.minimaxi.com";
+  } catch {
+    return "https://api.minimaxi.com";
+  }
+}
+function voiceCloneRouter() {
+  const r = new Hono13();
+  r.post("/upload", async (c) => {
+    const ct = c.req.header("content-type") || "";
+    if (!ct.toLowerCase().startsWith("multipart/form-data")) {
+      return c.json({ error: "expected multipart/form-data" }, 400);
+    }
+    const form = await c.req.formData();
+    const file = form.get("file");
+    if (!(file instanceof File)) {
+      return c.json({ error: "missing file field" }, 400);
+    }
+    const safeName = String(file.name || "source").replace(/[^A-Za-z0-9_.\- ]/g, "_") || "source";
+    const dir = join4(tmpdir(), `pb-voice-clone-${randomBytes9(6).toString("hex")}`);
+    mkdirSync2(dir, { recursive: true });
+    const path = join4(dir, safeName);
+    const buf = Buffer.from(await file.arrayBuffer());
+    writeFileSync(path, buf);
+    return c.json({ filePath: path, size: buf.length, name: safeName });
+  });
+  r.post("/start", async (c) => {
+    const body = await c.req.json();
+    const agentId = body.agentId?.trim();
+    const source = body.source || {};
+    if (!agentId) return c.json({ error: "missing agentId" }, 400);
+    if (!getAgent(agentId)) return c.json({ error: "unknown agent" }, 404);
+    if (findAnyActiveJob()) {
+      return c.json({ error: "another clone job is in progress" }, 409);
+    }
+    if (findActiveJobForAgent(agentId)) {
+      return c.json({ error: "this director already has a clone in progress" }, 409);
+    }
+    if (source.kind !== "file" || !source.filePath) {
+      return c.json({ error: "source must be { kind: 'file', filePath }" }, 400);
+    }
+    if (!existsSync2(source.filePath) || !statSync2(source.filePath).isFile()) {
+      return c.json({ error: "uploaded file is missing" }, 400);
+    }
+    const kind = "file";
+    const ref = source.filePath;
+    const provider = getActiveVoiceProvider();
+    if (provider !== "minimax" && provider !== "elevenlabs") {
+      return c.json({ error: "active voice credential must be minimax or elevenlabs" }, 400);
+    }
+    const label = (body.label || "").trim();
+    if (!label) {
+      return c.json({ error: "label is required" }, 400);
+    }
+    const job = createCloneJob({
+      agentId,
+      provider,
+      sourceKind: kind,
+      sourceRef: ref,
+      label
+    });
+    const extras = {};
+    if (body.miniMaxGroupId) extras.miniMaxGroupId = body.miniMaxGroupId.trim();
+    workerExtras.set(job.id, extras);
+    void runWorker(job);
+    return c.json({ jobId: job.id, status: job.status });
+  });
+  r.get("/active", (c) => {
+    const j = findAnyActiveJob();
+    return c.json({ job: j ?? null });
+  });
+  r.get("/:id", (c) => {
+    const j = getCloneJob(c.req.param("id"));
+    if (!j) return c.json({ error: "not found" }, 404);
+    return c.json({ job: j });
+  });
+  r.get("/:id/stream", async (c) => {
+    const id = c.req.param("id");
+    const initial = getCloneJob(id);
+    if (!initial) return c.json({ error: "not found" }, 404);
+    return streamSSE3(c, async (s) => {
+      await s.writeSSE({
+        event: "snapshot",
+        data: JSON.stringify({
+          jobId: initial.id,
+          stage: initial.currentStage,
+          pct: initial.pct,
+          status: initial.status,
+          voiceId: initial.voiceId,
+          errorCode: initial.errorCode,
+          errorMessage: initial.errorMessage,
+          ts: Date.now()
+        })
+      });
+      if (initial.status === "done" || initial.status === "failed" || initial.status === "cancelled") {
+        await s.writeSSE({ event: "end", data: JSON.stringify({ jobId: id, status: initial.status }) });
+        return;
+      }
+      const queue = [];
+      let wake = null;
+      let closed = false;
+      const off = subscribe(id, (ev) => {
+        queue.push(ev);
+        if (wake) {
+          wake();
+          wake = null;
+        }
+      });
+      s.onAbort(() => {
+        closed = true;
+        off();
+        if (wake) {
+          wake();
+          wake = null;
+        }
+      });
+      while (!closed) {
+        if (queue.length === 0) {
+          await new Promise((res) => {
+            wake = res;
+          });
+          if (closed) break;
+        }
+        const ev = queue.shift();
+        await s.writeSSE({ event: "progress", data: JSON.stringify(ev) });
+        if (ev.status === "done" || ev.status === "failed" || ev.status === "cancelled") {
+          await s.writeSSE({ event: "end", data: JSON.stringify({ jobId: id, status: ev.status }) });
+          break;
+        }
+      }
+      off();
+    });
+  });
+  r.delete("/:id", (c) => {
+    const id = c.req.param("id");
+    const job = getCloneJob(id);
+    if (!job) return c.json({ error: "not found" }, 404);
+    const aborter = aborters.get(id);
+    if (aborter) {
+      aborter.abort();
+      aborters.delete(id);
+    }
+    updateCloneJobProgress(id, {
+      status: "cancelled",
+      errorCode: "cancelled",
+      errorMessage: "Cancelled by user."
+    });
+    emit({
+      jobId: id,
+      stage: job.currentStage,
+      pct: job.pct,
+      status: "cancelled",
+      errorCode: "cancelled",
+      errorMessage: "Cancelled by user.",
+      ts: Date.now()
+    });
+    return c.json({ ok: true });
+  });
+  return r;
+}
+
+// src/routes/voice-credentials.ts
+import { Hono as Hono14 } from "hono";
 
 // src/storage/reconcile-voices.ts
 var MINIMAX_SEED_VOICES = [
@@ -25487,7 +26494,7 @@ function pickNextActiveVoiceId(removedProvider) {
   return sorted[0]?.id ?? null;
 }
 function voiceCredentialsRouter() {
-  const r = new Hono13();
+  const r = new Hono14();
   r.get("/", (c) => {
     const activeId = getPrefs().activeVoiceCredentialId;
     const items = listVoiceCredentials().map((m) => payloadFor3(m, activeId));
@@ -25555,8 +26562,9 @@ function voiceCredentialsRouter() {
     const label = typeof labelRaw === "string" ? labelRaw : null;
     const meta = createVoiceCredential(provider, label, key);
     if (!meta) return c.json({ error: "failed to create credential" }, 500);
-    const hadActive = !!getPrefs().activeVoiceCredentialId;
-    if (!hadActive) {
+    const priorActiveId = getPrefs().activeVoiceCredentialId;
+    const priorActive = priorActiveId ? getVoiceCredentialMeta(priorActiveId) : null;
+    if (!priorActive) {
       updatePrefs({ activeVoiceCredentialId: meta.id });
       try {
         reconcileAgentVoices({ reason: "first-key", priorProvider: null });
@@ -25566,6 +26574,8 @@ function voiceCredentialsRouter() {
 `
         );
       }
+    } else if (priorActive.provider === provider) {
+      updatePrefs({ activeVoiceCredentialId: meta.id });
     }
     const activeId = getPrefs().activeVoiceCredentialId;
     return c.json(payloadFor3(meta, activeId), 201);
@@ -25604,8 +26614,37 @@ function voiceCredentialsRouter() {
   return r;
 }
 
+// src/routes/voice-labels.ts
+import { Hono as Hono15 } from "hono";
+function voiceLabelsRouter() {
+  const r = new Hono15();
+  r.get("/", (c) => {
+    return c.json({ labels: listVoiceLabels() });
+  });
+  r.put("/:voiceId", async (c) => {
+    const voiceId = c.req.param("voiceId");
+    if (!voiceId) return c.json({ error: "missing voiceId" }, 400);
+    const body = await c.req.json();
+    const provider = body.provider === "minimax" || body.provider === "elevenlabs" ? body.provider : null;
+    if (!provider) return c.json({ error: "provider must be minimax or elevenlabs" }, 400);
+    const label = (body.label || "").trim();
+    if (!label) return c.json({ error: "label is required" }, 400);
+    setVoiceLabel({ voiceId, provider, label });
+    invalidateVoicesCache();
+    return c.json({ ok: true, voiceId, provider, label });
+  });
+  r.delete("/:voiceId", (c) => {
+    const voiceId = c.req.param("voiceId");
+    if (!voiceId) return c.json({ error: "missing voiceId" }, 400);
+    const removed = deleteVoiceLabel(voiceId);
+    if (removed) invalidateVoicesCache();
+    return c.json({ ok: true, removed });
+  });
+  return r;
+}
+
 // src/routes/voices.ts
-import { Hono as Hono14 } from "hono";
+import { Hono as Hono16 } from "hono";
 function ttsErrorMessage(e, providerLabel) {
   if (!(e instanceof Error)) return String(e);
   const cause = e.cause;
@@ -25650,7 +26689,7 @@ function ttsCacheSet(key, val) {
   }
 }
 function voicesRouter() {
-  const r = new Hono14();
+  const r = new Hono16();
   r.get("/", async (c) => {
     const url = new URL(c.req.url);
     const cursor = url.searchParams.get("cursor");
@@ -25817,7 +26856,7 @@ function voicesRouter() {
 init_paths();
 
 // src/version.ts
-var VERSION = "0.1.37";
+var VERSION = "0.1.38";
 
 // src/utils/render-picker-catalog.ts
 function renderPickerCatalog() {
@@ -25829,9 +26868,9 @@ function renderPickerCatalog() {
 
 // src/server.ts
 function createApp() {
-  const app = new Hono15();
+  const app = new Hono17();
   const dir = publicDir();
-  if (!existsSync2(dir)) {
+  if (!existsSync3(dir)) {
     throw new Error(
       `public/ directory not found at: ${dir}
 Build the package or check that public/ is bundled alongside dist/.`
@@ -25878,6 +26917,8 @@ Build the package or check that public/ is bundled alongside dist/.`
   app.route("/api/usage", usageRouter());
   app.route("/api/voices", voicesRouter());
   app.route("/api/voice-credentials", voiceCredentialsRouter());
+  app.route("/api/voice-clone", voiceCloneRouter());
+  app.route("/api/voice-labels", voiceLabelsRouter());
   app.route("/api/search", searchRouter());
   app.route("/api/search-credentials", searchCredentialsRouter());
   app.use(
@@ -25974,6 +27015,16 @@ async function bootApp(opts = {}) {
     }
   } catch (e) {
     process.stderr.write(`[boot] persona-job recovery failed: ${errMsg(e)}
+`);
+  }
+  try {
+    const failed = recoverStuckCloneJobs();
+    if (failed > 0) {
+      process.stderr.write(`[boot] marked ${failed} voice-clone job(s) failed (server restarted mid-clone)
+`);
+    }
+  } catch (e) {
+    process.stderr.write(`[boot] voice-clone recovery failed: ${errMsg(e)}
 `);
   }
   void (async () => {