@double_geste/agent-standup 1.25.2 → 1.25.3

package/examples/cats/README.txt

@@ -0,0 +1,7 @@
+Cat pack for Agent Standup (public domain / CC0, like the starter pack).
+Copy the PNG files into your characters folder, then press Reload:
+- lead.png = Boss, a grumpy cream cat (the lead)
+- you.png = Kibbles, a bag of cat food (you)
+- salem, smokey, mochi, patches, miso, biscuit, cinnamon, earl-grey, oreo = the sub-agents
+- name-talk.png = open-mouth frame for each of them
+64x64 px, transparent background. Drawn procedurally in Python with the help of an AI assistant.

package/examples/characters/README.txt

@@ -0,0 +1,5 @@
+Example pixel characters (public domain, made for Agent Standup).
+Copy them into your characters folder to try the feature, then draw your own:
+- 32x32 or 64x64 px PNG with a transparent background, facing front, feet at the bottom
+- lead.png = the lead (Claude), you.png = you, any other name = a sub-agent
+- name-talk.png = optional open-mouth frame

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@double_geste/agent-standup",
-  "version": "1.25.2",
+  "version": "1.25.3",
   "description": "Your Claude Code agents as a live video call, from the terminal: a local page in your browser, plus one-line status for status bars. Free, open source, zero token cost.",
   "bin": {
     "agent-standup": "bin/agent-standup.js"
@@ -13,6 +13,7 @@
     "kokoro-worker.js",
     "demo.js",
     "public",
+    "examples",
     "media",
     "LICENSE",
     "README.md"

package/public/index.html

@@ -279,6 +279,7 @@
     <select id="liveProj" style="display:none;margin-top:6px" title="Project to follow"></select>
     <select id="sessions" style="display:none"></select></div>
   <h4 data-fr="Personnages" data-en="Characters">Personnages</h4>
+  <div class="box"><select id="charPack" aria-label="Characters"><option value="none" data-fr="Personnages dessinés" data-en="Drawn characters">Personnages dessinés</option><option value="folder" data-fr="Mon dossier" data-en="My folder">Mon dossier</option><option value="starter" data-fr="Pack de départ" data-en="Starter pack">Pack de départ</option><option value="cats" data-fr="Pack de chats" data-en="Cat pack">Pack de chats</option></select></div>
   <div class="box"><div id="charInfo" class="dim" style="font-size:11.5px;line-height:1.5"></div><div style="display:flex;gap:6px;margin-top:6px"><button class="btn" id="charReload" data-fr="Recharger" data-en="Reload">Recharger</button><button class="btn" id="charOpen" style="display:none" data-fr="Ouvrir le dossier" data-en="Open folder">Ouvrir le dossier</button></div></div>
   <button class="mi" data-t="customLaptop"><span data-fr="Ordinateur devant vos personnages" data-en="Laptop in front of your own characters">Ordinateur devant vos personnages</span><i class="sw"></i></button>
   <h4 data-fr="Outils" data-en="Tools">Outils</h4>
@@ -342,6 +343,11 @@ const savePrefs = () => { prefs._t = Date.now(); try { localStorage.setItem('cc.
 const LANGS = [['en', 'English', 'en'], ['fr', 'Français', 'fr'], ['zh-TW', '繁體中文', 'zh-Hant-TW'], ['zh-CN', '简体中文', 'zh-Hans-CN'], ['es', 'Español', 'es'], ['de', 'Deutsch', 'de'], ['da', 'Dansk', 'da'], ['pt-BR', 'Português (Brasil)', 'pt-BR'], ['ja', '日本語', 'ja']];
 let LOC = {};
 const FR = () => prefs.lang === 'fr';
+const FR_W = /\b(le|la|les|des|une|un|et|est|pour|dans|que|qui|pas|sur|avec|je|tu|nous|vous|ce|cette|ça|du|au|aux|mais|sont|été|fait|plus|ne|ont|il|elle|ils|elles|très|aussi|donc|bien|tout|voici|voilà|merci|oui|non|comme|où|déjà|encore)\b/gi, EN_W = /\b(the|and|is|are|to|of|in|that|with|for|this|it|on|you|we|not|have|has|was|be|will|can|from|your|at|as|but|all|now|also|done|here|there|which|what|then|just|so)\b/gi;
+const langOf = (t) => {   // 'fr' or 'en' when a line clearly reads as one of them, else null: the voice then follows the interface language
+  t = String(t || ''); const fr = (t.match(FR_W) || []).length + (t.match(/[éèêàçùâîôûœ]/g) || []).length, en = (t.match(EN_W) || []).length;
+  return fr >= 2 && fr > en * 1.5 ? 'fr' : en >= 2 && en > fr * 1.5 ? 'en' : null;
+};
 const tr = (en) => (prefs.lang === 'en' || prefs.lang === 'fr' ? en : LOC[en] || en);
 const L = (fr, en) => (FR() ? fr : tr(en));
 async function loadLocale(code) { LOC = {}; if (code === 'en' || code === 'fr') return; try { const r = await fetch('/locales/' + encodeURIComponent(code) + '.json'); if (r.ok) LOC = await r.json(); } catch {} }
@@ -367,10 +373,14 @@ const mix = (a, b, t) => { const A = hexRGB(a), B = hexRGB(b); return '#' + A.ma
 let CHARS = { lead: null, you: null, pool: [], dir: '', n: 0 };
 const toData = (url) => fetch(url).then((r) => r.blob()).then((b) => new Promise((res) => { const f = new FileReader(); f.onload = () => res(f.result); f.readAsDataURL(b); }));
 async function loadChars() {
-  const next = { lead: null, you: null, pool: [], dir: '', n: 0 };
+  if (!['none', 'folder', 'starter', 'cats'].includes(prefs.charPack)) {   // drawn characters by default; someone who already had images in their folder keeps them
+    let n = 0; try { n = ((await (await fetch('/api/characters')).json()).chars || []).length; } catch {} prefs.charPack = n ? 'folder' : 'none'; savePrefs(); const sel = $('#charPack'); if (sel) sel.value = prefs.charPack;
+  }
+  const pack = prefs.charPack, next = { lead: null, you: null, pool: [], dir: '', n: 0, pack };
+  if (pack === 'none') { try { next.dir = (await (await fetch('/api/characters')).json()).dir || ''; } catch {} CHARS = next; return; }   // the drawn characters, whatever is in the folder
   try {
-    const d = await (await fetch('/api/characters')).json(); next.dir = d.dir || '';
-    for (const c of d.chars || []) { try { const e = { name: c.stem, idle: await toData('/characters/' + encodeURIComponent(c.file)), talk: c.talk ? await toData('/characters/' + encodeURIComponent(c.talk)) : null };
+    const base = pack === 'folder' ? '/characters/' : '/packs/' + pack + '/', d = await (await fetch('/api/characters?pack=' + (pack === 'folder' ? '' : pack))).json(); next.dir = d.dir || '';
+    for (const c of d.chars || []) { try { const e = { name: c.stem, idle: await toData(base + encodeURIComponent(c.file)), talk: c.talk ? await toData(base + encodeURIComponent(c.talk)) : null };
       if (c.role === 'lead') next.lead = e; else if (c.role === 'you') next.you = e; else next.pool.push(e); next.n++; } catch {} }
   } catch {}
   CHARS = next;
@@ -383,7 +393,7 @@ const customFor = (id) => {   // sub-agents: the best-hashed image no other agen
 };
 function renderCharInfo() {
   const el = $('#charInfo'); if (!el) return;
-  el.innerHTML = CHARS.n ? `✓ ${CHARS.n} ${esc(L('personnage(s) personnalisé(s) chargé(s)', 'custom character(s) loaded'))}` : `${esc(L('Déposez vos images (PNG) dans ce dossier pour remplacer les personnages :', 'Drop your pixel art (PNG) in this folder to replace the characters:'))}<br><code style="word-break:break-all">${esc(CHARS.dir)}</code><br>${esc(L('lead.png = le chef · you.png = vous · les autres = les sous-agents · nom-talk.png = bouche ouverte', 'lead.png = the lead · you.png = you · others = the sub-agents · name-talk.png = open mouth'))}`;
+  el.innerHTML = CHARS.pack === 'none' ? esc(L('Les personnages dessinés par l’application. Choisissez « Mon dossier » pour vos propres images, ou un pack.', 'The characters drawn by the app. Pick “My folder” for your own images, or a pack.')) : CHARS.pack !== 'folder' ? `✓ ${CHARS.n} ${esc(L('personnages du pack', 'characters from the pack'))} · ${esc(L('Pour les modifier, copiez-les dans votre dossier et choisissez « Mon dossier ».', 'To tweak them, copy them into your folder and pick “My folder”.'))}` : CHARS.n ? `✓ ${CHARS.n} ${esc(L('personnage(s) personnalisé(s) chargé(s)', 'custom character(s) loaded'))}` : `${esc(L('Déposez vos images (PNG) dans ce dossier pour remplacer les personnages :', 'Drop your pixel art (PNG) in this folder to replace the characters:'))}<br><code style="word-break:break-all">${esc(CHARS.dir)}</code><br>${esc(L('lead.png = le chef · you.png = vous · les autres = les sous-agents · nom-talk.png = bouche ouverte', 'lead.png = the lead · you.png = you · others = the sub-agents · name-talk.png = open mouth'))}`;
   $('#charOpen').style.display = EMBED ? '' : 'none';
 }
 function persona(a) { const p = persona0(a); p.custom = customFor(a.id); return p; }
@@ -527,7 +537,7 @@ const speakable = (t) => t.replace(/(?:[\w.-]+\/)+([\w.-]+)/g, (m, f) => f.repla
 const trMem = new Map(), trPending = new Map();
 const baseText = (ev, max) => short(ev.text, max || (S.live ? (ev.kind === 'order' ? 220 : 180) : (ev.kind === 'order' ? 200 : 230)));
 function ensureTr(texts) {
-  texts = [...new Set(texts)].filter((t) => t && !trMem.has(t));
+  texts = [...new Set(texts)].filter((t) => t && !trMem.has(t)).filter((t) => langOf(t) !== 'fr');   // already French: nothing to translate
   const waits = texts.filter((t) => trPending.has(t)).map((t) => trPending.get(t)), fresh = texts.filter((t) => !trPending.has(t));
   if (fresh.length) {
     const pr = fetch('/api/translate', { method: 'POST', body: JSON.stringify({ texts: fresh }) }).then((r) => r.json()).then((d) => {
@@ -728,7 +738,7 @@ function warmTTS(i) {   // synthesize the next few lines ahead of time
   if (!TTS.server || !AUD.ctx || !prefs.voice || prefs.vstyle === 'animal' || prefs.vstyle === 'sims') return;
   let n = 0; for (let k = i; k < S.events.length && n < 4; k++) {
     const e = S.events[k]; if (quiet(e)) continue; n++;
-    const p = S.agents[e.agent], v = p && TTS.voiceFor(p, FR() && trMem.has(baseText(e))); if (v) TTS.buf(speakable(spoken(e)), v, TTS.rate()).catch(() => {});
+    const p = S.agents[e.agent], txt = speakable(spoken(e)), v = p && TTS.voiceFor(p, frVoice(txt)); if (v) TTS.buf(txt, v, TTS.rate()).catch(() => {});
   }
 }
 
@@ -849,7 +859,8 @@ function captionRun(id, text, totalMs) {
   for (let i = 1; i < ps.length; i++) { const x = ps[i], when = at; timers.push(setTimeout(() => setCaption(id, x), when)); at += totalMs * x.length / n; }
   capTimers.set(id, timers);
 }
-async function speakLine(text, p, primary, token, fr = FR()) {
+const frVoice = (t) => (langOf(t) ?? (FR() ? 'fr' : 'en')) === 'fr';   // a French line gets a French voice whatever the interface language, and the other way round
+async function speakLine(text, p, primary, token, fr = frVoice(text)) {
   captionRun(p.id, text, estMs(text));
   if (AUD.off() || !prefs.voice) { if (!AUD.off() && prefs.office) AUD.murmur(0.5 + (p.vi % 5) / 10, estMs(text) / 1000); return sleep(estMs(text)); }
   if (S.hurry) return sleep(estMs(text));
@@ -1641,7 +1652,7 @@ async function run(i) {
       if (g.kind === 'order') { S.status[g.to] = 'working'; AUD.join(); setTimeout(() => { paintStatus(); fly(g.agent, g.to, '📨'); popTile(g.to); }, 30); }
       if (g.kind === 'report') { AUD.ding(); setTimeout(() => { fly(g.agent, g.to, '✅'); popTile(g.agent); }, 30); }
       const said = clipSpeech(line, S.pace); if (g.agent === 'main' && g.kind === 'say') { const full = plain(g.text), key = said.replace(/…$/, '').trim().slice(-30), pos = key ? full.indexOf(key) : -1, n = pos >= 0 ? pos + key.length : said.length; S.mainSaid = { ev: g, said: n, full: n >= full.length - 5 }; }
-      return speakLine(said, S.agents[g.agent], true, token, FR() && trMem.has(baseText(g))).then(() => stopTalk(g.agent));
+      return speakLine(said, S.agents[g.agent], true, token, frVoice(said)).then(() => stopTalk(g.agent));
     };
     let plays;
     if (ev.kind === 'order' && group.length > 1) {   // the first order in full, then "Also Remy on X, Iris on Y"
@@ -1930,6 +1941,7 @@ function setView(v) { prefs.view = v; savePrefs(); document.body.classList.toggl
 
 $('#viewSeg').onclick = (e) => { const b = e.target.closest('button'); if (b) setView(b.dataset.v); };
 $('#langSel').onchange = () => setLang($('#langSel').value, true);
+$('#charPack').value = ['none', 'folder', 'starter', 'cats'].includes(prefs.charPack) ? prefs.charPack : 'none'; $('#charPack').onchange = () => { prefs.charPack = $('#charPack').value; savePrefs(); $('#charReload').onclick(); };
 $('#charReload').onclick = async () => { await loadChars(); for (const k in imgCache) delete imgCache[k]; for (const id in S.agents) S.agents[id].custom = null; for (const id in S.agents) S.agents[id].custom = customFor(id); buildStage(); paintStatus(); renderCharInfo(); };
 $('#charOpen').onclick = () => window.parent.postMessage({ agentStandup: 'openCharacters' }, '*');
 $('#modeSeg').onclick = (e) => { const b = e.target.closest('button'); if (b) setMode(b.dataset.m); };

package/public/locales/da.json

@@ -209,5 +209,12 @@
  "Laptop in front of your own characters": "Bærbar foran dine egne figurer",
  "Also ": "Også ",
  " on ": " på ",
- "To sum up: ": "Kort sagt: "
+ "To sum up: ": "Kort sagt: ",
+ "Cat pack": "Kattepakke",
+ "characters from the pack": "figurer fra pakken",
+ "Drawn characters": "Tegnede figurer",
+ "Starter pack": "Startpakke",
+ "To tweak them, copy them into your folder and pick “My folder”.": "For at tilpasse dem: kopiér dem til din mappe og vælg “Min mappe”.",
+ "My folder": "Min mappe",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "Figurerne tegnet af appen. Vælg “Min mappe” for dine egne billeder, eller en pakke."
 }

package/public/locales/de.json

@@ -210,5 +210,12 @@
  "Laptop in front of your own characters": "Laptop vor deinen eigenen Figuren",
  "Also ": "Außerdem ",
  " on ": " an ",
- "To sum up: ": "Zusammengefasst: "
+ "To sum up: ": "Zusammengefasst: ",
+ "Cat pack": "Katzen-Pack",
+ "characters from the pack": "Figuren aus dem Pack",
+ "Drawn characters": "Gezeichnete Figuren",
+ "Starter pack": "Starter-Pack",
+ "To tweak them, copy them into your folder and pick “My folder”.": "Zum Anpassen in deinen Ordner kopieren und „Mein Ordner“ wählen.",
+ "My folder": "Mein Ordner",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "Die von der App gezeichneten Figuren. Wähle „Mein Ordner“ für eigene Bilder oder ein Pack."
 }

package/public/locales/en.json

@@ -27,7 +27,9 @@
  "cache write": "cache write",
  "Call": "Call",
  "Cartoon voices (real voice)": "Cartoon voices (real voice)",
+ "Cat pack": "Cat pack",
  "Characters": "Characters",
+ "characters from the pack": "characters from the pack",
  "Chatter between agents": "Chatter between agents",
  "Claude Code is not logged in: run “claude” once in a terminal to sign in.": "Claude Code is not logged in: run “claude” once in a terminal to sign in.",
  "Claude Code not found: install it (npm i -g @anthropic-ai/claude-code) or set its path in the “agentStandup.claudePath” setting.": "Claude Code not found: install it (npm i -g @anthropic-ai/claude-code) or set its path in the “agentStandup.claudePath” setting.",
@@ -48,6 +50,7 @@
  "Done": "Done",
  "Done. ": "Done. ",
  "Downloading, you can carry on: system voices are used meanwhile.": "Downloading, you can carry on: system voices are used meanwhile.",
+ "Drawn characters": "Drawn characters",
  "Drop your pixel art (PNG) in this folder to replace the characters:": "Drop your pixel art (PNG) in this folder to replace the characters:",
  "duration": "duration",
  "Editing ": "Editing ",
@@ -93,6 +96,7 @@
  "may be waiting for your approval": "may be waiting for your approval",
  "Music volume": "Music volume",
  "Mute / unmute": "Mute / unmute",
+ "My folder": "My folder",
  "Natural voices": "Natural voices",
  "need you": "need you",
  "needs you?": "needs you?",
@@ -163,9 +167,11 @@
  "stalled: a sub-agent has been silent for a long time": "stalled: a sub-agent has been silent for a long time",
  "standing by": "standing by",
  "Start Claude Code in this folder — the call will start by itself.": "Start Claude Code in this folder — the call will start by itself.",
+ "Starter pack": "Starter pack",
  "sub-agents active": "sub-agents active",
  "task": "task",
  "Tasks": "Tasks",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "The characters drawn by the app. Pick “My folder” for your own images, or a pack.",
  "THE END": "THE END",
  "The engine stopped: system voices are used instead.": "The engine stopped: system voices are used instead.",
  "This dev was replaced by his own agents. Spare a coffee for his career change? ☕": "This dev was replaced by his own agents. Spare a coffee for his career change? ☕",
@@ -173,6 +179,7 @@
  "Time": "Time",
  "to": "to",
  "To sum up: ": "To sum up: ",
+ "To tweak them, copy them into your folder and pick “My folder”.": "To tweak them, copy them into your folder and pick “My folder”.",
  "tokens": "tokens",
  "Tokens": "Tokens",
  "Tokens recorded by Claude Code (counted once per message, not a bill)": "Tokens recorded by Claude Code (counted once per message, not a bill)",

package/public/locales/es.json

@@ -210,5 +210,12 @@
  "Laptop in front of your own characters": "Portátil delante de tus propios personajes",
  "Also ": "También ",
  " on ": " en ",
- "To sum up: ": "En resumen: "
+ "To sum up: ": "En resumen: ",
+ "Cat pack": "Pack de gatos",
+ "characters from the pack": "personajes del pack",
+ "Drawn characters": "Personajes dibujados",
+ "Starter pack": "Pack inicial",
+ "To tweak them, copy them into your folder and pick “My folder”.": "Para retocarlos, cópialos en tu carpeta y elige «Mi carpeta».",
+ "My folder": "Mi carpeta",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "Los personajes dibujados por la aplicación. Elige «Mi carpeta» para tus propias imágenes, o un pack."
 }

package/public/locales/ja.json

@@ -210,5 +210,12 @@
  "Laptop in front of your own characters": "自作キャラクターの前にノートパソコン",
  "Also ": "それから ",
  " on ": " は ",
- "To sum up: ": "まとめると： "
+ "To sum up: ": "まとめると： ",
+ "Cat pack": "ネコパック",
+ "characters from the pack": "パックのキャラクター",
+ "Drawn characters": "描画キャラクター",
+ "Starter pack": "スターターパック",
+ "To tweak them, copy them into your folder and pick “My folder”.": "調整するには、自分のフォルダーにコピーして「自分のフォルダー」を選んでください。",
+ "My folder": "自分のフォルダー",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "アプリが描画するキャラクターです。自分の画像を使うには「自分のフォルダー」、またはパックを選んでください。"
 }

package/public/locales/pt-BR.json

@@ -210,5 +210,12 @@
  "Laptop in front of your own characters": "Notebook na frente dos seus personagens",
  "Also ": "Também ",
  " on ": " em ",
- "To sum up: ": "Resumindo: "
+ "To sum up: ": "Resumindo: ",
+ "Cat pack": "Pacote de gatos",
+ "characters from the pack": "personagens do pacote",
+ "Drawn characters": "Personagens desenhados",
+ "Starter pack": "Pacote inicial",
+ "To tweak them, copy them into your folder and pick “My folder”.": "Para ajustá-los, copie-os para sua pasta e escolha “Minha pasta”.",
+ "My folder": "Minha pasta",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "Os personagens desenhados pelo aplicativo. Escolha “Minha pasta” para suas próprias imagens, ou um pacote."
 }

package/public/locales/zh-CN.json

@@ -210,5 +210,12 @@
  "Laptop in front of your own characters": "在自定义角色前显示笔记本电脑",
  "Also ": "另外 ",
  " on ": " 负责 ",
- "To sum up: ": "总结一下： "
+ "To sum up: ": "总结一下： ",
+ "Cat pack": "猫咪包",
+ "characters from the pack": "来自角色包的角色",
+ "Drawn characters": "绘制的角色",
+ "Starter pack": "入门包",
+ "To tweak them, copy them into your folder and pick “My folder”.": "若要修改，请将它们复制到你的文件夹并选择“我的文件夹”。",
+ "My folder": "我的文件夹",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "由应用绘制的角色。选择“我的文件夹”使用你自己的图片，或选择一个角色包。"
 }

package/public/locales/zh-TW.json

@@ -210,5 +210,12 @@
  "Laptop in front of your own characters": "在自訂角色前顯示筆記型電腦",
  "Also ": "另外 ",
  " on ": " 負責 ",
- "To sum up: ": "總結一下： "
+ "To sum up: ": "總結一下： ",
+ "Cat pack": "貓咪包",
+ "characters from the pack": "來自角色包的角色",
+ "Drawn characters": "繪製的角色",
+ "Starter pack": "入門包",
+ "To tweak them, copy them into your folder and pick “My folder”.": "若要修改，請將它們複製到你的資料夾並選擇「我的資料夾」。",
+ "My folder": "我的資料夾",
+ "The characters drawn by the app. Pick “My folder” for your own images, or a pack.": "由應用程式繪製的角色。選擇「我的資料夾」使用你自己的圖片，或選擇一個角色包。"
 }

package/server.js

@@ -503,8 +503,10 @@ const MIME = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css
 const CHAR_NAME = /^[\w][\w .()\-]{0,78}\.(png|gif|webp|jpe?g)$/i, CHAR_MAX = 300 * 1024, CHAR_TYPES = { png: 'image/png', gif: 'image/gif', webp: 'image/webp', jpg: 'image/jpeg', jpeg: 'image/jpeg' };
 const charactersDir = () => process.env.AGENT_STANDUP_CHARACTERS || path.join(os.homedir(), '.agent-standup', 'characters');
 // lstat, not stat: a symlink is not a regular file, so it is skipped and never served
-function listCharacters() {
-  const dir = charactersDir(); let names = []; try { names = fs.readdirSync(dir); } catch {}
+// Built-in character packs, shipped with the app (examples/<folder>): picked in ⚙ → Characters, or copied into the person's own folder as a start
+const PACKS = { starter: 'characters', cats: 'cats' }, packDir = (name) => (PACKS[name] ? path.join(__dirname, 'examples', PACKS[name]) : null);
+function listCharacters(pack) {
+  const dir = pack ? packDir(pack) : charactersDir(); let names = []; if (!dir) return { dir: '', max: CHAR_MAX, chars: [] }; try { names = fs.readdirSync(dir); } catch {}
   const ok = names.filter((f) => CHAR_NAME.test(f)).filter((f) => { try { const st = fs.lstatSync(path.join(dir, f)); return st.isFile() && st.size <= CHAR_MAX; } catch { return false; } }).slice(0, 80);
   const stem = (f) => f.replace(/\.[^.]+$/, ''), by = new Map(ok.map((f) => [stem(f).toLowerCase(), f]));
   const chars = ok.filter((f) => !/-talk$/i.test(stem(f))).map((f) => { const st = stem(f), l = st.toLowerCase();
@@ -563,7 +565,8 @@ function start(port = PORT) {
     if (url.pathname === '/api/prefs') return json(readPrefs() || {});
     if (url.pathname === '/api/current') return json(currentSession(url.searchParams.get('proj') || '', url.searchParams.get('id') || '', { proj: url.searchParams.get('sproj') || '', id: url.searchParams.get('sid') || '' }));
     if (url.pathname === '/api/board') return json(boardRows());
-    if (url.pathname === '/api/characters') return json(listCharacters());
+    if (url.pathname === '/api/characters') return json(listCharacters(url.searchParams.get('pack') || ''));
+    if (url.pathname === '/api/packs') return json(Object.keys(PACKS).map((name) => ({ name, n: listCharacters(name).chars.length })));
     if (url.pathname === '/api/media') {
       const q = (k) => url.searchParams.get(k) || '', SAFE = /^[\w.\-]+$/, n = +q('n') || 0, bad = [q('proj'), q('id'), q('agent'), q('tool')].some((v) => !SAFE.test(v) || v === '..' || v.length > 200);
       const file = bad || !Number.isInteger(n) || n < 0 || n > 9 ? null : mediaFile(q('proj'), q('id'), q('agent')), im = file && toolImage(file, q('tool'), n);
@@ -585,9 +588,10 @@ function start(port = PORT) {
       }
       return json({ id: tl.id, agents: tl.agents, total: tl.events.length, events: tl.events.slice(+after) });
     }
-    if (url.pathname.startsWith('/characters/')) {   // only plain image files of the characters folder, by exact name
-      let f = ''; try { f = decodeURIComponent(url.pathname.slice('/characters/'.length)); } catch {}
-      const dir = charactersDir(), fp = path.join(dir, f);
+    const pk = url.pathname.match(/^\/packs\/([a-z]+)\/(.*)$/);
+    if (url.pathname.startsWith('/characters/') || (pk && packDir(pk[1]))) {   // only plain image files of the characters folder (or of a built-in pack), by exact name
+      let f = ''; try { f = decodeURIComponent(pk ? pk[2] : url.pathname.slice('/characters/'.length)); } catch {}
+      const dir = pk ? packDir(pk[1]) : charactersDir(), fp = path.join(dir, f);
       try { const ls = fs.lstatSync(fp); if (!CHAR_NAME.test(f) || !fp.startsWith(dir + path.sep) || !ls.isFile() || ls.size > CHAR_MAX) throw 0; } catch { res.writeHead(404); return res.end('not found'); }
       res.writeHead(200, { 'content-type': CHAR_TYPES[f.split('.').pop().toLowerCase()] || 'application/octet-stream', 'cache-control': 'no-cache' }); return fs.createReadStream(fp).pipe(res);
     }