nio-cat 0.9.9 → 0.9.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nio-cat",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "description": "nio: fes servir Claude Code, Codex, Grok, Antigravity i Ollama del teu ordinador des del mòbil.",
   "license": "UNLICENSED",
   "author": "f.cat",

package/src/agents/claude.js

@@ -20,6 +20,8 @@ module.exports = {
     // Conversa del terminal: el primer missatge en fa una branca; després ja continua la pròpia.
     if (session.nativeId && session.forkNative) { args.push('--fork-session'); delete session.forkNative; }
     if (session.model) args.push('--model', session.model);
+    // Que l'agent posi un títol que resumeixi la feina (eina MCP de nio; el hub el desa).
+    args.push('--append-system-prompt', 'Treballes dins una sessió de nio. Quan entenguis la tasca, crida l’eina mcp__nio__sessio_titol amb un títol de 3-7 paraules que la resumeixi, en l’idioma de l’usuari; torna-la a cridar només si la feina canvia de tema.');
 
     if (session.mode === 'tot' && process.getuid?.() === 0) {
       ctx.fail('Claude Code no deixa el mode «Via lliure» quan s’executa com a root. Canvia els permisos a «Demana permís» o engega nio amb un usuari normal.');

package/src/agents/ollama.js

@@ -70,11 +70,11 @@ async function pull(name, onProgress, signal) {
 }
 
 // Una resposta d'un sol cop (sense flux), per exemple per a la pissarra.
-async function chat({ model, messages, format, think, maxTokens, signal }) {
+async function chat({ model, messages, format, think, maxTokens, numCtx, signal }) {
   const res = await fetch(`${base()}/api/chat`, {
     method: 'POST',
     headers: { 'content-type': 'application/json' },
-    body: JSON.stringify({ model, messages, stream: false, ...(format ? { format } : {}), ...(think === false ? { think: false } : {}), options: { temperature: 0.2, ...(maxTokens ? { num_predict: maxTokens } : {}) } }),
+    body: JSON.stringify({ model, messages, stream: false, ...(format ? { format } : {}), ...(think === false ? { think: false } : {}), options: { temperature: 0.2, ...(maxTokens ? { num_predict: maxTokens } : {}), ...(numCtx ? { num_ctx: numCtx } : {}) } }),
     ...(signal ? { signal } : {}),
   });
   if (!res.ok) throw new Error(`Ollama ha tornat un error ${res.status}: ${await res.text()}`);

package/src/call.js

@@ -65,7 +65,7 @@ class Call {
     if (!r.ok) {
       const d = j?.detail;
       const msg = (typeof d === 'string' ? d : d?.message || (Array.isArray(d) ? d.map((x) => x.msg).join('; ') : '') || j?.message || t || `Error ${r.status}`);
-      throw Object.assign(httpErr(r.status === 401 ? 400 : 502, `ElevenLabs: ${clip(msg, 220)}`), { upstream: r.status });
+      throw Object.assign(httpErr(r.status === 401 ? 400 : 502, require('./voice').elPermHint(msg) || `ElevenLabs: ${clip(msg, 220)}`), { upstream: r.status });
     }
     return j;
   }

package/src/claude-hook.js

@@ -6,6 +6,7 @@
 const READ_ONLY = new Set([
   'Read', 'Glob', 'Grep', 'LS', 'NotebookRead', 'WebSearch', 'WebFetch',
   'TodoWrite', 'TodoRead', 'Task', 'Agent', 'ToolSearch', 'Skill', 'BashOutput',
+  'mcp__nio__sessio_titol',
 ]);
 
 function reply(decision, reason) {

package/src/hub.js

@@ -5,6 +5,7 @@ const path = require('path');
 const crypto = require('crypto');
 const { EventEmitter } = require('events');
 const { byId, binPath } = require('./agents');
+const TITLE_TOOL = /(^|[._])sessio_titol$/;
 const { HOME, save } = require('./config');
 const push = require('./push');
 const usage = require('./usage');
@@ -206,7 +207,7 @@ class Hub extends EventEmitter {
     const s = this.get(sid);
     if (!s) throw httpErr(404, 'Aquesta sessió no existeix');
     if (patch.mode && ['llegir', 'preguntar', 'tot'].includes(patch.mode)) s.mode = patch.mode;
-    if (typeof patch.title === 'string') s.title = patch.title.slice(0, 120);
+    if (typeof patch.title === 'string') { s.title = patch.title.slice(0, 120); s.titleBy = 'user'; } // un nom posat a mà no el canvia l'agent
     if (typeof patch.model === 'string') s.model = patch.model.slice(0, 80);
     if (typeof patch.cwd === 'string' && path.resolve(patch.cwd) !== s.cwd) {
       const cwd = path.resolve(patch.cwd);
@@ -285,6 +286,12 @@ class Hub extends EventEmitter {
       stream: (t) => this.chunk(s, String(t)),
       tool: ({ id: tid, name, input }) => {
         toolNames.set(tid, name);
+        // L'agent posa títol a la sessió amb l'eina MCP sessio_titol (Claude: mcp__nio__sessio_titol, Codex: nio.sessio_titol).
+        if (TITLE_TOOL.test(name || '') && typeof input === 'string') try { input = JSON.parse(input); } catch { input = {}; }
+        if (TITLE_TOOL.test(name || '') && s.titleBy !== 'user') {
+          const t = String(input?.titol || '').replace(/\s+/g, ' ').trim().replace(/[.。]$/, '').slice(0, 80);
+          if (t && t !== s.title) { s.title = t; s.titleBy = 'agent'; this.touch(s); }
+        }
         const inp = summarizeInput(input);
         this.push(s, 'tool', { id: tid, name, input: inp });
         this.audit.add({ type: 'tool', session: s.id, agent: s.agent, title: s.title, cwd: s.cwd, tool: name, what: describe(name, inp), mode: s.mode });

package/src/mcp.js

@@ -50,6 +50,14 @@ const TOOLS = [
       return `Desat a ${r.path} (${r.size} B).`;
     },
   },
+  {
+    name: 'sessio_titol',
+    description: 'Posa títol a la sessió de nio on treballes: 3-7 paraules que resumeixin la feina (p. ex. «Mode fosc a la botiga»), perquè l’usuari la reconegui a la llista. Crida-la quan entenguis la tasca i torna-la a cridar si la feina canvia de tema. Fora de nio no fa res.',
+    inputSchema: { type: 'object', properties: { titol: { type: 'string', description: 'Títol curt, sense punt final' } }, required: ['titol'], additionalProperties: false },
+    annotations: { readOnlyHint: true },
+    // El títol el posa nio quan veu passar aquesta crida (hub.js); aquí només es confirma.
+    run: ({ titol }) => (String(titol || '').trim() ? `Títol: ${String(titol).trim().slice(0, 80)}` : 'Falta el títol.'),
+  },
 ];
 
 function serve({ input = process.stdin, output = process.stdout } = {}) {
@@ -64,7 +72,7 @@ function serve({ input = process.stdin, output = process.stdout } = {}) {
           protocolVersion: params?.protocolVersion || '2025-06-18',
           capabilities: { tools: {} },
           serverInfo: { name: 'nio', version: require('../package.json').version },
-          instructions: 'Memòria compartida de nio (fitxers markdown en aquest ordinador). Consulta-la a l’inici d’una tasca (memoria_cerca o memoria_llegeix preferencies.md) i desa-hi el que valgui la pena recordar.',
+          instructions: 'Memòria compartida de nio (fitxers markdown en aquest ordinador). Consulta-la a l’inici d’una tasca (memoria_cerca o memoria_llegeix preferencies.md) i desa-hi el que valgui la pena recordar. Si treballes dins una sessió de nio, posa-li un títol curt amb sessio_titol.',
         });
       case 'ping':
         return reply({});

package/src/notes.js

@@ -49,6 +49,16 @@ class Notes {
     try { this.notes = JSON.parse(fs.readFileSync(FILE, 'utf8')); } catch { /* encara no n'hi ha */ }
     const old = Date.now() - TRASH_DAYS * 864e5;
     this.notes = this.notes.filter((n) => !n.trashed || n.trashed > old);
+    this.queues = new Map(); // cues per nota: «t:<id>» transcripció en ordre, «s:<id>» apunts i resum
+    this.parting = new Map();
+    // Si nio es va aturar enmig d'una classe: es reprèn el que quedava a mitges.
+    setImmediate(() => {
+      for (const n of this.notes) {
+        if (!n.live) continue;
+        for (const sg of n.live.segs) if (sg.state === 'transcribing') this.queue(`t:${n.id}`, () => this.liveTranscribe(n, sg));
+        if (n.live.state === 'closing' || n.live.state === 'summarizing') this.liveFinish(n);
+      }
+    });
   }
 
   save() {
@@ -85,6 +95,7 @@ class Notes {
     const n = this.get(id);
     if (!n.trashed && !forever) return this.patch(id, { trashed: true });
     for (const a of n.audio) fs.rm(this.audioFile(n, a), { force: true }, () => {});
+    for (const sg of n.live?.segs || []) fs.rm(this.liveFile(n, sg), { force: true }, () => {});
     this.notes = this.notes.filter((x) => x !== n);
     this.save();
     this.hub.emit('out', { type: 'note-gone', id });
@@ -136,6 +147,164 @@ class Notes {
     if (this.notes.includes(n)) { n.updated = Date.now(); this.save(); this.emit(n); }
   }
 
+  // ---------- Classe o reunió en directe
+  // El mòbil grava trossos de ~20 s i els envia en ordre. Cada tros es transcriu (en ordre, un darrere l'altre);
+  // cada ~4-5 minuts de veu, un model en fa apunts mentre la gravació continua; en acabar, el resum de tot.
+  queue(key, fn) {
+    const p = (this.queues.get(key) || Promise.resolve()).then(fn).catch(() => {});
+    this.queues.set(key, p);
+    return p;
+  }
+  liveFile(n, sg) { return path.join(AUDIO, `${n.id}-live-${sg.seq}.${extOf(sg.mime)}`); }
+
+  liveStart(b = {}) {
+    const kind = LIVE_KINDS[b.kind] ? b.kind : 'classe';
+    const when = new Date().toLocaleString('ca-ES', { day: 'numeric', month: 'short', hour: '2-digit', minute: '2-digit' });
+    const title = `${LIVE_KINDS[kind]} · ${when}`;
+    const n = this.create({ title, labels: [kind === 'classe' ? 'classe' : 'reunió'] });
+    n.live = { kind, engine: str(b.engine, 80), lang: LIVE_LANGS.includes(b.lang) ? b.lang : 'ca', state: 'rec', started: Date.now(), ended: 0, segs: [], parts: [], error: '', autoTitle: title };
+    this.save(); this.emit(n);
+    return n;
+  }
+
+  liveResume(id) {
+    const n = this.get(id), L = n.live;
+    if (!L) throw httpErr(400, 'Aquesta nota no és d’una classe ni d’una reunió');
+    if (L.state === 'closing' || L.state === 'summarizing') throw httpErr(409, 'Ara mateix l’estic resumint. Espera que acabi.');
+    L.state = 'rec'; L.error = ''; n.updated = Date.now();
+    this.save(); this.emit(n);
+    return n;
+  }
+
+  liveSeg(id, buf, mime, q) {
+    const n = this.get(id), L = n.live;
+    if (!L) throw httpErr(400, 'Aquesta nota no és d’una classe ni d’una reunió');
+    const seq = Math.max(0, Math.floor(Number(q.seq) || 0));
+    if (L.segs.some((x) => x.seq === seq)) return { ok: true, seq, dup: true }; // el mòbil l'ha tornat a enviar
+    if (!buf?.length) throw httpErr(400, 'El tros d’àudio és buit');
+    if (L.segs.length >= 2000) throw httpErr(413, 'Aquesta gravació ja és massa llarga');
+    const sg = { seq, at: Math.max(0, Number(q.at) || 0), dur: Math.max(0, Number(q.dur) || 0), mime, state: 'transcribing', text: '', error: '' };
+    fs.mkdirSync(AUDIO, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(this.liveFile(n, sg), buf);
+    L.segs.push(sg); L.segs.sort((a, b) => a.seq - b.seq);
+    n.updated = Date.now(); this.save(); this.emit(n);
+    this.queue(`t:${n.id}`, () => this.liveTranscribe(n, sg));
+    return { ok: true, seq };
+  }
+
+  async liveTranscribe(n, sg) {
+    if (!this.notes.includes(n)) return;
+    try {
+      const { text } = await voice.transcribe(this.cfg, fs.readFileSync(this.liveFile(n, sg)), sg.mime, n.live.lang);
+      const t = String(text || '').replace(/\s+/g, ' ').trim();
+      sg.text = HALLUCINATION.test(t) ? '' : t; sg.state = 'ok'; sg.error = '';
+    } catch (e) {
+      sg.state = 'error'; sg.error = String(e.message || e).slice(0, 300);
+    }
+    if (!this.notes.includes(n)) return;
+    n.updated = Date.now(); this.save(); this.emit(n);
+    this.liveParts(n);
+  }
+
+  // Apunts dels trossos ja transcrits, en ordre. Amb «final», també el tros que queda encara que sigui curt.
+  liveParts(n, final = false) {
+    if (this.parting.has(n.id)) return final ? this.parting.get(n.id).then(() => this.liveParts(n, true)) : this.parting.get(n.id);
+    const run = (async () => {
+      for (;;) {
+        const L = n.live, last = L.parts.length ? L.parts[L.parts.length - 1].to : -1, ready = [];
+        for (const sg of L.segs) { if (sg.seq <= last) continue; if (sg.state === 'transcribing') break; ready.push(sg); }
+        const text = ready.map((x) => x.text).filter(Boolean).join(' ');
+        if (!ready.length || (!final && text.length < PART_CHARS) || (final && ready.some((x) => x.state === 'transcribing'))) return;
+        const pick = await this.pickEngine(L.engine);
+        if (!pick) return; // sense model: al final es deixa la transcripció
+        const part = { from: ready[0].seq, to: ready[ready.length - 1].seq, text: '', error: '' };
+        if (text.trim().length > 40) {
+          try { part.text = (await this.ask(pick, LIVE_TASKS.part[L.kind], text, false)).text.trim(); }
+          catch (e) { part.error = String(e.message || e).slice(0, 200); }
+        }
+        if (!this.notes.includes(n)) return;
+        L.parts.push(part); n.updated = Date.now(); this.save(); this.emit(n);
+      }
+    })().finally(() => this.parting.delete(n.id));
+    this.parting.set(n.id, run);
+    return run;
+  }
+
+  liveStop(id) {
+    const n = this.get(id), L = n.live;
+    if (!L) throw httpErr(400, 'Aquesta nota no és d’una classe ni d’una reunió');
+    if (L.state === 'rec' || L.state === 'error') { L.state = 'closing'; L.ended = Date.now(); n.updated = Date.now(); this.save(); this.emit(n); this.liveFinish(n); }
+    return n;
+  }
+
+  liveSummary(id, b = {}) {
+    const n = this.get(id), L = n.live;
+    if (!L) throw httpErr(400, 'Aquesta nota no és d’una classe ni d’una reunió');
+    if (L.state === 'rec') throw httpErr(409, 'Primer atura la gravació');
+    if (L.state === 'closing' || L.state === 'summarizing') return n;
+    if (b.engine) L.engine = str(b.engine, 80);
+    L.parts = L.parts.filter((p) => !p.error); // els apunts que havien fallat es tornen a fer
+    L.state = 'closing'; this.save(); this.emit(n);
+    this.liveFinish(n);
+    return n;
+  }
+
+  // Espera la transcripció i els apunts pendents i en fa el resum final.
+  liveFinish(n) {
+    return this.queue(`s:${n.id}`, async () => {
+      const L = n.live;
+      await (this.queues.get(`t:${n.id}`) || Promise.resolve());
+      if (!this.notes.includes(n)) return;
+      L.state = 'summarizing'; L.error = ''; this.emit(n);
+      try {
+        await this.liveParts(n, true);
+        const transcript = L.segs.map((x) => x.text).filter(Boolean).join(' ').trim();
+        if (!transcript) throw new Error('No s’ha transcrit res: no hi ha res a resumir.');
+        const pick = await this.pickEngine(L.engine);
+        if (!pick) {
+          if (!n.text.trim()) n.text = transcript;
+          throw new Error('No hi ha cap model per resumir. He deixat la transcripció a la nota. Instal·la Ollama amb un model (ollama pull qwen3:4b) o Claude Code.');
+        }
+        const max = pick.id.startsWith('ollama:') ? 9000 : 60000; // els models locals petits tenen poc context
+        const rangeText = (p) => L.segs.filter((x) => x.seq >= p.from && x.seq <= p.to).map((x) => x.text).filter(Boolean).join(' ');
+        let blocks = transcript.length <= max ? [transcript] : L.parts.map((p) => p.text || rangeText(p)).filter(Boolean);
+        // Massa llarg per a un sol cop: es condensen els apunts per grups fins que hi caben.
+        while (blocks.join('\n\n').length > max && blocks.length > 1) {
+          const groups = [];
+          for (const b of blocks) { const g = groups[groups.length - 1]; if (g && g.join('\n\n').length + b.length < max * 0.8) g.push(b); else groups.push([b]); }
+          if (groups.length === blocks.length) groups.splice(0, groups.length, ...Array.from({ length: Math.ceil(blocks.length / 2) }, (_, i) => blocks.slice(i * 2, i * 2 + 2)));
+          blocks = [];
+          for (const g of groups) blocks.push((await this.ask(pick, LIVE_TASKS.condense, g.join('\n\n'), false)).text.trim());
+        }
+        const r = await this.ask(pick, LIVE_TASKS.final[L.kind], blocks.join('\n\n').slice(0, max), true);
+        const text = str(r.text, 200000).trim();
+        if (!text) throw new Error('El model no ha tornat cap resum. Torna-ho a provar o tria’n un altre.');
+        if (!this.notes.includes(n)) return;
+        const title = str(r.title, 120).trim();
+        if (title && n.title === L.autoTitle) { n.title = `${title}`; L.autoTitle = n.title; }
+        n.text = text; L.state = 'done'; L.summaryEngine = pick.id;
+      } catch (e) {
+        if (!this.notes.includes(n)) return;
+        L.state = 'error'; L.error = String(e.message || e).slice(0, 300);
+      }
+      n.updated = Date.now(); this.save(); this.emit(n);
+    });
+  }
+
+  async pickEngine(engine) {
+    const list = await this.engines();
+    // Per defecte: el model local més petit de 3 mil milions de paràmetres o més; si no, Claude ràpid; si no, el primer.
+    const auto = list.filter((e) => e.local && e.id.startsWith('ollama:') && e.params >= 3)[0] || list.find((e) => e.id === 'claude:haiku') || list[0];
+    return list.find((e) => e.id === engine) || auto || null;
+  }
+
+  async ask(pick, task, body, json) {
+    const local = pick.id.startsWith('ollama:'), wrap = !json && local;
+    const user = `--- TRANSCRIPCIÓ ---\n${body}\n--- FI ---\n\n${task}${wrap ? '\n\nTorna només JSON amb aquest format: {"text":"…"}. El text pot tenir salts de línia.' : ''}`;
+    const raw = await runModel(this.cfg, pick.id, LIVE_SYSTEM, user, json || wrap, { numCtx: local ? 8192 : 0 });
+    return json ? parseJson(raw) : wrap ? { text: String(parseJson(raw).text ?? '') } : { text: raw };
+  }
+
   // ---------- Motors per resumir i organitzar
   async engines() {
     const { binPath } = require('./agents');
@@ -179,6 +348,9 @@ class Notes {
     return [
       R('GET', '/api/notes', () => ({ notes: this.notes })),
       R('POST', '/api/notes', ({ body }) => this.create(body), { limit: 1024 * 1024 }),
+      R('POST', '/api/notes/live', ({ body }) => this.liveStart(body || {})),
+      R('POST', /^\/api\/notes\/([\w-]+)\/live\/seg$/, async ({ req, params, url }) => this.liveSeg(params[0], await readRaw(req), String(req.headers['content-type'] || 'audio/webm').split(';')[0], Object.fromEntries(url.searchParams)), { raw: true }),
+      R('POST', /^\/api\/notes\/([\w-]+)\/live\/(stop|resume|summary)$/, ({ params, body }) => (params[1] === 'stop' ? this.liveStop(params[0]) : params[1] === 'resume' ? this.liveResume(params[0]) : this.liveSummary(params[0], body || {}))),
       R('GET', '/api/notes/engines', () => this.engines().then((engines) => ({ engines }))),
       R('POST', '/api/notes/ai', ({ body }) => this.ai(body || {})),
       R('PATCH', /^\/api\/notes\/([\w-]+)$/, ({ params, body }) => this.patch(params[0], body), { limit: 1024 * 1024 }),
@@ -241,6 +413,25 @@ const ACTIONS = {
   },
 };
 
+// ---------- Classe o reunió
+const LIVE_KINDS = { classe: 'Classe', reunio: 'Reunió' };
+const LIVE_LANGS = ['ca', 'es', 'en'];
+const PART_CHARS = 3500; // ≈ 4-5 minuts de veu per tros d'apunts
+// Whisper s'inventa aquestes frases quan sent silenci o soroll.
+const HALLUCINATION = /^[\s.…]*$|^(gràcies( per (veure|mirar|escoltar)[^.!]*)?|subtítols[^.!]*|amara\.org[^.!]*|gracias( por (ver|mirar)[^.!]*)?|subtítulos[^.!]*|thank you( for watching)?|thanks for watching)[.!…\s]*$/i;
+const LIVE_SYSTEM = 'Ets l’assistent de notes de nio. Treballes amb la transcripció automàtica d’una classe o d’una reunió: pot tenir paraules mal transcrites, que pots corregir quan el context ho deixa clar. No t’inventis res que no s’hi digui. Respon en l’idioma de la transcripció (si dubtes, en català). No facis servir cap eina.';
+const LIVE_TASKS = {
+  part: {
+    classe: 'Escriu els apunts d’aquest tros de classe: de 3 a 8 punts curts amb els conceptes, definicions, exemples, fórmules i dades que s’hi expliquen. Cada punt comença amb «- ». Només els punts, sense introducció.',
+    reunio: 'Escriu les notes d’aquest tros de reunió: de 3 a 8 punts curts amb els temes tractats, les decisions i les tasques (amb qui se’n fa càrrec, si es diu). Cada punt comença amb «- ». Només els punts, sense introducció.',
+  },
+  condense: 'Són apunts seguits d’una mateixa classe o reunió. Fes-ne uns de sols, sense repeticions i amb tot el que és important: com a màxim 12 punts. Cada punt comença amb «- ». Només els punts.',
+  final: {
+    classe: 'Fes el resum de tota la classe. Torna només JSON amb aquest format: {"title":"…","text":"…"}. «title»: el tema de la classe, en menys de 8 paraules. «text»: Markdown amb aquests apartats: «## Resum» (un paràgraf de 4 a 6 frases), «## Conceptes clau» (llista «- **concepte**: explicació curta»), «## Punts importants» (llista), «## Per repassar» (de 3 a 5 preguntes que podrien sortir a l’examen) i, només si se’n parla, «## Deures i dates».',
+    reunio: 'Fes el resum de tota la reunió. Torna només JSON amb aquest format: {"title":"…","text":"…"}. «title»: el tema principal, en menys de 8 paraules. «text»: Markdown amb aquests apartats: «## Resum» (de 3 a 5 frases), «## Decisions» (llista), «## Tasques» (llista «- [ ] qui: què»; si no es diu qui, només què) i «## Temes oberts» (llista). Deixa fora els apartats que quedarien buits.',
+  },
+};
+
 function parseJson(raw) {
   const t = String(raw || '').replace(/^```(?:json)?\s*|\s*```$/g, '').trim();
   try { return JSON.parse(t); } catch { /* potser hi ha text al voltant */ }
@@ -264,14 +455,14 @@ function runCli(bin, args, input, { cwd, timeout = 180000 } = {}) {
   });
 }
 
-async function runModel(cfg, engine, system, user, json) {
+async function runModel(cfg, engine, system, user, json, { numCtx = 0 } = {}) {
   const { binPath } = require('./agents');
   const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'nio-nota-'));
   try {
     if (engine.startsWith('ollama:')) {
       // Qwen3 «pensa» abans de respondre (minuts en un model petit): «/no_think» ho desactiva. Si la resposta porta un bloc <think>, es treu.
       const model = engine.slice(7), soft = /qwen3/i.test(model) ? '\n\n/no_think' : '';
-      const out = await ollama.chat({ model, messages: [{ role: 'system', content: system }, { role: 'user', content: user + soft }], format: json ? 'json' : undefined, think: false, maxTokens: 3000, signal: AbortSignal.timeout(150000) }).catch((e) => { throw e.name === 'TimeoutError' ? httpErr(504, 'El model ha trigat massa. Prova-ho amb un de més petit o ràpid.') : e; });
+      const out = await ollama.chat({ model, messages: [{ role: 'system', content: system }, { role: 'user', content: user + soft }], format: json ? 'json' : undefined, think: false, maxTokens: 3000, numCtx: numCtx || undefined, signal: AbortSignal.timeout(150000) }).catch((e) => { throw e.name === 'TimeoutError' ? httpErr(504, 'El model ha trigat massa. Prova-ho amb un de més petit o ràpid.') : e; });
       return out.replace(/^[\s\S]*?<\/think>\s*/i, '').trim();
     }
     if (engine === 'claude' || engine.startsWith('claude:')) {

package/src/voice.js

@@ -58,11 +58,21 @@ const PROVIDERS = {
 function ext(mime) {
   return /ogg/.test(mime || '') ? 'ogg' : /mp4|m4a|aac/.test(mime || '') ? 'm4a' : /mpeg|mp3/.test(mime || '') ? 'mp3' : /wav/.test(mime || '') ? 'wav' : 'webm';
 }
+// Una clau restringida a la qual falta un permís: es diu quin interruptor cal activar a ElevenLabs.
+const EL_PERMS = { text_to_speech: 'Text to Speech → Access', speech_to_text: 'Speech to Text → Access', convai_write: 'ElevenAgents → Write', convai_read: 'ElevenAgents → Write' };
+function elPermHint(msg) {
+  const m = String(msg || '').match(/missing the permission (\w+)/i);
+  if (!m) return null;
+  const what = EL_PERMS[m[1]] || m[1];
+  return `A la clau d’ElevenLabs li falta el permís «${what}». Edita-la a elevenlabs.io (Developers → API Keys) i activa’l, o crea’n una de nova amb aquest permís.`;
+}
+
 async function errText(r) {
   const t = await r.text().catch(() => '');
   try {
     const j = JSON.parse(t);
-    return (j.detail?.message || j.detail || j.error?.message || j.error || t).toString().slice(0, 200);
+    const msg = (j.detail?.message || j.detail || j.error?.message || j.error || t).toString();
+    return elPermHint(msg) || msg.slice(0, 200);
   } catch {
     return `${r.status} ${t.slice(0, 160)}`;
   }
@@ -93,12 +103,14 @@ function status(cfg) {
   };
 }
 
-async function transcribe(cfg, audio, mime) {
+async function transcribe(cfg, audio, mime, lang) {
   const p = pick(cfg, 'stt');
+  lang = lang || cfgOf(cfg).lang || 'ca';
+  const l = lang === 'auto' ? '' : lang; // «auto»: que el proveïdor ho endevini
   if (!p) throw httpErr(400, 'Aquest ordinador encara no té veu. Activa Whisper (gratis) o posa una clau a Ajustos → Veu.');
   if (!audio?.length) throw httpErr(400, 'No hi ha àudio');
-  if (p === 'whisper') return { text: await whisper.transcribe(cfg, audio, mime, cfgOf(cfg).lang || 'ca'), provider: p };
-  return { text: (await PROVIDERS[p].stt(cfg.voice.keys[p], audio, mime, cfgOf(cfg).lang || 'ca')).trim(), provider: p };
+  if (p === 'whisper') return { text: await whisper.transcribe(cfg, audio, mime, lang), provider: p };
+  return { text: (await PROVIDERS[p].stt(cfg.voice.keys[p], audio, mime, l)).trim(), provider: p };
 }
 
 async function speak(cfg, text) {
@@ -179,4 +191,4 @@ function routes(cfg) {
   ];
 }
 
-module.exports = { routes, transcribe, speak, status, pick, PROVIDERS };
+module.exports = { routes, transcribe, speak, status, pick, PROVIDERS, elPermHint };

package/src/whisper.js

@@ -128,7 +128,7 @@ async function transcribe(cfg, audio, mime, lang = 'ca') {
     const input = path.join(tmp, `audio.${ext(mime)}`);
     fs.writeFileSync(input, audio);
     if (e === 'python') {
-      await run(pyBin(), [input, '--model', 'turbo', '--language', lang, '--output_format', 'txt', '--output_dir', tmp, '--fp16', 'False', '--verbose', 'False']);
+      await run(pyBin(), [input, '--model', 'turbo', ...(lang === 'auto' ? [] : ['--language', lang]), '--output_format', 'txt', '--output_dir', tmp, '--fp16', 'False', '--verbose', 'False']);
       return fs.readFileSync(path.join(tmp, 'audio.txt'), 'utf8').trim();
     }
     if (!fs.existsSync(modelPath(cfg))) {

package/web/app/app.js

@@ -206,21 +206,24 @@ async function api(path, opts = {}) {
   const body = opts.body && typeof opts.body !== 'string' ? opts.body : opts.body ? JSON.parse(opts.body) : undefined;
   let res;
   try { res = await fetch(m.url + path, { ...opts, headers: { Authorization: `Bearer ${m.token}`, 'content-type': 'application/json', ...(opts.headers || {}) }, body: body ? JSON.stringify(body) : undefined }); }
-  catch (e) { if (e.name === 'AbortError') throw e; throw new Error(`No he pogut parlar amb ${m.name || 'l’ordinador'}. Comprova que nio hi estigui engegat i torna-ho a provar.`); }
-  const data = await res.json().catch(() => ({}));
+  catch (e) { if (e.name === 'AbortError') throw e; throw Object.assign(new Error(`No he pogut parlar amb ${m.name || 'l’ordinador'}. Comprova que nio hi estigui engegat i torna-ho a provar.`), { unreachable: true }); }
+  const data = await res.json().catch(() => null);
+  // Un túnel mort respon una pàgina d'error de Cloudflare (502, 530…), no el JSON de nio: és com no arribar-hi.
+  if (!data && res.status >= 500) throw Object.assign(new Error(`No arribo a ${m.name || 'l’ordinador'}`), { unreachable: true });
+  if (!data) { if (!res.ok) throw new Error(`Error ${res.status}`); return {}; }
   if (!res.ok) throw new Error(data.error || `Error ${res.status}`);
   if (Array.isArray(data.agents)) data.agents = data.agents.filter((x) => x.id !== 'demo'); // l'agent de proves del programa no s'ensenya
   return data;
 }
 
-let streamCtrl = null, retry = 0, gotHello = false;
+let streamCtrl = null, retry = 0, gotHello = false, alive = 0; // alive: última vegada que ha arribat alguna cosa de l'ordinador
 async function pollLoop(ctrl) {
   let first = true;
   while (!ctrl.signal.aborted) {
     try {
       const [list, aps] = await Promise.all([api('/api/sessions'), api('/api/approvals')]);
       if (ctrl.signal.aborted) return;
-      state.connected = true; state.lastError = null;
+      state.connected = true; state.lastError = null; alive = Date.now();
       if (first) { first = false; state.synced = true; const r = state.route; state.sessions = new Map(list.map((x) => [x.id, x])); state.approvals = new Map(aps.map((a) => [a.id, a])); if (r.name === 'session') openSession(r.id); else render(); }
       else {
         const r = state.route, seen = new Set();
@@ -297,7 +300,7 @@ async function connect() {
     const res = await fetch(`${m.url}/api/stream?d=${encodeURIComponent(deviceId())}&k=${isPhone() ? 'phone' : 'desktop'}`, { headers: { Authorization: `Bearer ${m.token}` }, signal: ctrl.signal, cache: 'no-store' });
     if (res.status === 401) throw Object.assign(new Error('La clau no és vàlida. Torna a connectar amb el codi QR.'), { fatal: true });
     if (!res.ok || !res.body) throw new Error(`Error ${res.status}`);
-    state.connected = true; state.lastError = null; retry = 0;
+    state.connected = true; state.lastError = null; retry = 0; alive = Date.now();
     rememberIdentity(m.url, state.info.identity);
     renameMachine(state.info.host, state.info.id); syncServiceWorker(); render(); brainsForBoard(); loadVoice().then(() => state.route.name === 'session' && renderComposer?.()); flushQueue();
     const reader = res.body.getReader(), dec = new TextDecoder(); let buf = '';
@@ -306,6 +309,7 @@ async function connect() {
     const hw = setTimeout(() => { if (!gotHello) { poll = true; reader.cancel().catch(() => {}); } }, 5000);
     for (;;) {
       const { value, done } = await reader.read().catch(() => ({ done: true })); if (done) break;
+      alive = Date.now();
       buf += dec.decode(value, { stream: true }); let i;
       while ((i = buf.indexOf('\n\n')) >= 0) {
         const block = buf.slice(0, i); buf = buf.slice(i + 2);
@@ -319,11 +323,13 @@ async function connect() {
   } catch (e) {
     if (ctrl.signal.aborted) return;
     state.connected = false;
-    state.lastError = e.message === 'Failed to fetch' || e.name === 'TypeError' ? (location.protocol === 'https:' && /^http:\/\/(127\.0\.0\.1|localhost)/.test(m.url) ? 'El navegador no deixa que aquesta web parli amb aquest ordinador. Prova Chrome, o engega nio amb --local.' : 'No arribo a l’ordinador') : e.message;
+    const unreachable = e.unreachable || e.message === 'Failed to fetch' || e.name === 'TypeError' || /^Error 5\d\d$/.test(e.message);
+    state.lastError = unreachable ? (location.protocol === 'https:' && /^http:\/\/(127\.0\.0\.1|localhost)/.test(m.url) ? 'El navegador no deixa que aquesta web parli amb aquest ordinador. Prova Chrome, o engega nio amb --local.' : 'No arribo a l’ordinador') : e.message;
     render();
     if (e.fatal) return;
     // Potser el túnel ha canviat d'adreça: la busquem a nio.cat (signada per l'ordinador).
-    if (state.lastError === 'No arribo a l’ordinador' && (await relocate(store.active))) { if (!ctrl.signal.aborted) connect(); return; }
+    // (Passa sobretot quan es torna a executar install.sh: el túnel ràpid de Cloudflare canvia d'adreça.)
+    if (unreachable && (await relocate(store.active))) { if (!ctrl.signal.aborted) connect(); return; }
     if (m.kind === 'vps' && m.via && retry >= 2) autoReconnect(m);
     setTimeout(() => machine() && !ctrl.signal.aborted && connect(), Math.min(15000, 1000 * 2 ** retry++));
   }
@@ -735,7 +741,7 @@ function viewSettings() {
   const avisos = machine() ? `<section class="panel"><header><h2>Avisos al mòbil</h2></header><div class="body stack"><p class="small">Rep un avís quan un agent et demana permís o acaba la feina.</p>${isIOS && !standalone ? '<p class="muted small">A l’iPhone, primer afegeix nio a la pantalla d’inici (Comparteix → Afegeix a la pantalla d’inici) i obre’l des d’allà.</p>' : ''}${pushOn ? '<p class="small"><span class="chip ok">' + svg(ICON.check) + 'Avisos activats en aquest dispositiu</span></p>' : ''}<div class="row">${pushOn ? '<button class="btn ink grow" data-act="push-test" type="button">Envia’n un de prova</button><button class="btn" data-act="push-off" type="button">Desactiva</button>' : '<button class="btn ink grow" data-act="push" type="button">Activa els avisos</button>'}</div></div></section>` : '';
   if (machine() && pushOn === null) refreshPush();
   if (machine() && tgState === undefined) loadTelegram();
-  return `${head}<div class="stack-lg" style="max-width:640px">${avisos}${voicePanel()}<div id="tgPanel">${telegramPanel()}</div></div>`;
+  return `${head}<div class="stack-lg cols">${avisos}${voicePanel()}<div id="tgPanel">${telegramPanel()}</div></div>`;
 }
 // Ajustos sense ordinador: un sol avís a dalt i les seccions de mostra, desactivades.
 function settingsOff() {
@@ -922,7 +928,7 @@ async function pantallaTab() {
   });
 }
 function moreSheet() {
-  const item = (k) => `<a class="more-link" href="${HASH[k]}" ${state.route.name === k ? 'aria-current="page"' : ''}><span>${VIEWS[k].label}</span>${k === 'approvals' && state.approvals.size ? `<span class="badge">${state.approvals.size}</span>` : ''}</a>`;
+  const item = (k) => `<a class="more-link" href="${HASH[k]}" ${state.route.name === k ? 'aria-current="page"' : ''}>${svg(VIEWS[k].icon)}<span>${VIEWS[k].label}</span>${k === 'approvals' && state.approvals.size ? `<span class="badge">${state.approvals.size}</span>` : ''}</a>`;
   const groups = [...new Set(Object.values(VIEWS).map((v) => v.group))].map((group) => [group, Object.keys(VIEWS).filter((k) => VIEWS[k].group === group)]);
   openSheet(`<h2>Més</h2><nav class="more-sections" aria-label="Totes les seccions">${groups.map(([title, keys]) => `<section><h3>${title}</h3><div>${keys.map(item).join('')}</div></section>`).join('')}</nav>`, (sh) => { sh.onclick = (e) => { if (e.target.closest('a, [data-act]')) closeSheet(); }; });
 }
@@ -1310,7 +1316,10 @@ const hhmm = (t) => new Date(t * 1000).toLocaleString('ca', { weekday: t * 1000
 function usageChip(agent) {
   const u = state.usage?.[agent]; if (!u?.windows?.length) return '';
   const tip = u.windows.map((w) => `${w.label}: ${Math.round(w.used * 100)} %${w.resetsAt ? ` · es reinicia ${hhmm(w.resetsAt)}` : ''}`).join('\n');
-  return `<span class="chip mono usage" title="${esc(`Ús de la subscripció\n${tip}`)}">${svg(CHIP_ICON.usage)}${u.windows.map((w) => `<span class="uw" data-hi="${w.used >= 0.8 ? 1 : 0}">${esc(w.label)} ${Math.round(w.used * 100)}%</span>`).join('')}</span>`;
+  // Etiquetes curtes: «5h», «7d». La icona és un anell que s'omple amb la finestra més plena.
+  const short = (l) => (l === 'setmana' ? '7d' : l.replace(/\s+/g, '')), top = Math.max(...u.windows.map((w) => w.used)), pct = Math.round(top * 100);
+  const ring = `<svg class="ico ring" viewBox="0 0 24 24" aria-hidden="true"><circle cx="12" cy="12" r="8.5" class="rt"/><circle cx="12" cy="12" r="8.5" pathLength="100" stroke-dasharray="${Math.max(pct, 2)} 100" transform="rotate(-90 12 12)" class="rv"/></svg>`;
+  return `<span class="chip mono usage" data-hi="${top >= 0.8 ? 1 : 0}" title="${esc(`Ús de la subscripció\n${tip}`)}">${ring}${u.windows.map((w) => `<span class="uw" data-hi="${w.used >= 0.8 ? 1 : 0}">${esc(short(w.label))} (${Math.round(w.used * 100)}%)</span>`).join('')}</span>`;
 }
 function renderSessionHead() {
   renderChrome();
@@ -1423,6 +1432,7 @@ function putEvent(e, scroll = true) {
   const feed = $('#feed'); if (!feed) return;
   if (e.kind === 'text' && scroll && (e.open || typers.has(e.seq))) return streamText(state.route.id, e);
   const stick = nearBottom(feed);
+  if (e.kind === 'tool_result' && TITLE_TOOL.test(e.name || '')) return; // el títol ja es veu a dalt i a la línia «Títol»
   if (e.kind === 'tool_result') {
     const t = toolEls.get(e.id);
     if (t) {
@@ -1448,12 +1458,15 @@ function putEvent(e, scroll = true) {
   if (scroll && e.kind === 'user' && pinNext && !old) { pinNext = false; return pinMessage(feed, node); }
   if (scroll) follow(feed, stick);
 }
+// L'agent posa títol a la sessió amb l'eina sessio_titol de nio (Claude: mcp__nio__sessio_titol, Codex: nio.sessio_titol).
+const TITLE_TOOL = /(^|[._])sessio_titol$/;
 function eventNode(e) {
   const s = state.sessions.get(state.route.id);
   switch (e.kind) {
     case 'user': return el(`<div class="msg-user">${esc(e.text)}</div>`);
     case 'text': return el(`<div class="msg-ai ${e.open && s?.state === 'running' ? 'cursor' : ''}" data-seq="${e.seq}">${md(e.text)}${!e.open && ttsOn() ? `<button class="speak" type="button" data-speak aria-label="Escolta la resposta">${svg(ICON.speaker)}<span>Escolta</span></button>` : ''}</div>`);
-    case 'tool': return el(`<details class="tool"><summary><span class="name">${esc(e.name)}</span><span class="arg">${esc(toolArg(e.input))}</span><span class="st">…</span></summary><pre>${esc(prettyInput(e.input))}</pre></details>`);
+    case 'tool': if (TITLE_TOOL.test(e.name || '')) return el(`<div class="ev-info">Títol: «${esc(e.input?.titol || '')}»</div>`);
+      return el(`<details class="tool"><summary><span class="name">${esc(e.name)}</span><span class="arg">${esc(toolArg(e.input))}</span><span class="st">…</span></summary><pre>${esc(prettyInput(e.input))}</pre></details>`);
     case 'tool_result': return el(`<details class="tool"><summary><span class="name">${esc(e.name || 'Eina')}</span><span class="arg"></span><span class="st ${e.error ? 'err' : 'ok'}">${e.error ? '✕' : '✓'}</span></summary><pre class="out">${esc(e.output)}</pre></details>`);
     case 'approval': { const a = state.approvals.get(e.approval) || {}; return el(approvalCard({ ...a, approval: e.approval, tool: e.tool, input: e.input, state: e.state && e.state !== 'pending' ? e.state : a.state || e.state }, false)); }
     case 'error': return el(`<div class="ev-error" role="alert"><b>Error</b><span>${esc(e.text)}</span></div>`);
@@ -2624,7 +2637,20 @@ function voicePanel() {
   const on = [...(v?.whisper?.ready ? ['Whisper'] : []), ...Object.entries(P).filter(([, p]) => p.key).map(([, p]) => p.name)];
   return `<section class="panel"><header><h2>Veu</h2>${on.length ? `<span class="chip ok"><i class="dot on"></i>${esc(on.join(' · '))}</span>` : ''}</header><div class="body stack"><p class="small">Dicta els missatges amb el micròfon i escolta les respostes. Amb <b>Whisper</b> és gratis i l’àudio no surt de l’ordinador (${esc(machine().name)}). Si hi poses una clau d’ElevenLabs o OpenAI, també es queda a l’ordinador.</p>${v ? '' : '<p class="muted small">Aquest ordinador encara no té la veu (cal nio 0.7 o més nou).</p>'}<div class="row"><button class="btn ink" data-act="voice" type="button" ${v ? '' : 'disabled'}>${on.length ? 'Canvia la configuració' : 'Configura la veu'}</button></div></div></section>`;
 }
-async function voiceSheet() {
+// Pas a pas per fer la clau d'ElevenLabs amb només els permisos que fa servir nio.
+const EL_GUIDE = `<details class="el-guide" id="elGuide"><summary>Com faig la clau? Pas a pas</summary><ol>
+  <li>Obre <a href="https://elevenlabs.io/app/developers/api-keys" target="_blank" rel="noopener">elevenlabs.io → Developers → API Keys</a> i prem <b>Create API Key</b>.</li>
+  <li><b>Name</b>: «nio». <b>Expire After</b>: «Never» (o la data que vulguis).</li>
+  <li>Activa <b>Restrict Key</b> i, a <b>Endpoints</b>, deixa-ho així:<ul>
+    <li><b>Text to Speech</b> → <span class="el-on">Access</span> · per escoltar les respostes</li>
+    <li><b>ElevenAgents</b> → <span class="el-on">Write</span> · per a la Trucada amb en Nio</li>
+    <li><b>Speech to Text</b> → <span class="el-on">Access</span> · només si vols que ElevenLabs transcrigui en lloc de Whisper</li>
+    <li>Tota la resta, també <b>Administration</b> → <span class="el-off">No Access</span></li></ul></li>
+  <li><b>Usage Limits</b> (opcional): posa un màxim de crèdits, perquè no gasti més del que vols.</li>
+  <li>Deixa activat <b>Auto-disable if leaked</b>.</li>
+  <li>Prem <b>Create</b>, copia la clau (<span class="mono">sk_…</span>; només es veu un cop) i enganxa-la aquí sobre. Es desa a l’ordinador i no torna mai al mòbil.</li>
+</ol><p class="muted small">Si falta algun permís, nio et dirà quin has d’activar.</p></details>`;
+async function voiceSheet(opts = {}) {
   await loadVoice();
   if (!nodeVoice) return toast('Aquest ordinador encara no té la veu. Actualitza nio (npx nio-cat@latest).', 5000);
   if (isDemo()) return toast('A la demo no hi ha veu. Amb nio instal·lat, dictes amb Whisper, gratis.', 4500);
@@ -2634,6 +2660,7 @@ async function voiceSheet() {
     <form class="stack" id="voiceForm" style="margin-top:14px">
       <details class="voice-extras"><summary>Extres opcionals · ElevenLabs i OpenAI</summary><div class="stack"><p class="muted small">Afegeix una clau per fer servir aquests serveis. Whisper funciona sense cap clau.</p>
       <label class="f"><span>Clau d’ElevenLabs ${v.providers.elevenlabs.key ? `<span class="muted">(desada: ${esc(v.providers.elevenlabs.key)})</span>` : ''}</span><input type="password" id="vEl" placeholder="${v.providers.elevenlabs.key ? 'Deixa-ho buit per mantenir-la' : 'sk_…'}" value="${!v.providers.elevenlabs.key && old.key ? esc(old.key) : ''}" autocomplete="off" autocapitalize="off" spellcheck="false"></label>
+      ${EL_GUIDE}
       <label class="f"><span>Clau d’OpenAI ${v.providers.openai.key ? `<span class="muted">(desada: ${esc(v.providers.openai.key)})</span>` : ''}</span><input type="password" id="vOa" placeholder="${v.providers.openai.key ? 'Deixa-ho buit per mantenir-la' : 'sk-…'}" autocomplete="off" autocapitalize="off" spellcheck="false"></label>
       <div class="grid-2"><label class="f"><span>Per entendre’t</span><select id="vStt"><option value="">Automàtic</option>${v.whisper ? `<option value="whisper" ${v.stt === 'whisper' ? 'selected' : ''}>Whisper (gratis)</option>` : ''}<option value="elevenlabs" ${v.stt === 'elevenlabs' ? 'selected' : ''}>ElevenLabs Scribe</option><option value="openai" ${v.stt === 'openai' ? 'selected' : ''}>OpenAI</option></select></label>
       <label class="f"><span>Per parlar</span><select id="vTts"><option value="">Automàtic</option><option value="elevenlabs" ${v.tts === 'elevenlabs' ? 'selected' : ''}>ElevenLabs</option><option value="openai" ${v.tts === 'openai' ? 'selected' : ''}>OpenAI</option></select></label></div>
@@ -2642,6 +2669,7 @@ async function voiceSheet() {
       <button class="btn ghost" type="button" id="vOff">Treu les claus</button></div></details>
       <div class="row sheet-foot"><button class="btn ink" type="submit">Desa</button></div>
     </form>`, (sh) => {
+    if (opts.guide) { const g = $('#elGuide', sh); sh.querySelector('.voice-extras').open = true; g.open = true; setTimeout(() => g.scrollIntoView({ block: 'start', behavior: 'smooth' }), 120); }
     const put = async (body, msg) => { try { nodeVoice = await api('/api/voice', { method: 'PUT', body }); try { localStorage.removeItem('nio.voice'); } catch { /* res */ } closeSheet(); toast(msg); if (state.route.name === 'session') renderSession(); else render(); } catch (e) { toast(e.message, 4500); } };
     $('#voiceForm', sh).onsubmit = (e) => { e.preventDefault(); const keys = {}; const el = $('#vEl', sh).value.trim(), oa = $('#vOa', sh).value.trim(); if (el) keys.elevenlabs = el; if (oa) keys.openai = oa; put({ keys, stt: $('#vStt', sh).value || null, tts: $('#vTts', sh).value || null, speak: $('#vSpeak', sh).checked }, 'Veu desada a l’ordinador'); };
     $('#vOff', sh).onclick = () => { if (confirm('Es treuran les claus de veu d’aquest ordinador.')) put({ keys: { elevenlabs: null, openai: null } }, 'Claus eliminades'); };
@@ -3014,7 +3042,19 @@ if ('serviceWorker' in navigator) {
   navigator.serviceWorker.addEventListener('message', (e) => { if (e.data?.type === 'open-session' && e.data.id) go(`#/s/${e.data.id}`); });
 }
 addEventListener('hashchange', route);
-document.addEventListener('visibilitychange', () => { if (!document.hidden && machine() && !state.connected) connect(); });
+// El mòbil congela la pàgina en segon pla i el flux queda mort sense cap error: l'ordinador envia un ping cada 15 s,
+// així que si fa més de 40 s que no arriba res (o en tornar a l'app, més de 20 s), es torna a connectar sol.
+function revive(maxIdle) {
+  if (!machine() || isDemo(machine()) || document.hidden) return;
+  // Desconnectat, el vigilant no talla els reintents en curs; en tornar a l'app sí que es torna a provar de seguida.
+  if (state.connected ? Date.now() - alive < maxIdle : maxIdle >= 40000) return;
+  retry = 0; reconTry.clear(); connect();
+}
+document.addEventListener('visibilitychange', () => revive(20000));
+addEventListener('pageshow', (e) => { if (e.persisted) revive(0); });
+addEventListener('online', () => revive(0));
+addEventListener('focus', () => revive(20000));
+setInterval(() => revive(40000), 10000);
 setInterval(() => { if (!document.hidden && state.route.name === 'sessions') render(); }, 60000);
 const qs = new URLSearchParams(location.search).get('s');
 if (qs) history.replaceState(null, '', location.pathname + `#/s/${qs}`);

package/web/app/call.js

@@ -43,7 +43,7 @@ export function createCall(ctx) {
     if (!m) return head + ctx.noMachine('La trucada parla amb un ordinador. Connecta’n un per trucar.');
     const ready = demo || st?.ready, loading = !demo && !st;
     const why = st?.error ? `<p class="call-why err">${esc(OLD.test(st.error) ? 'Aquest ordinador encara no sap trucar: actualitza nio (cal nio-cat 0.9.9 o més nou).' : st.error)}</p>`
-      : !ready && !loading ? '<p class="call-why">Per trucar cal una clau d’ElevenLabs. Es queda a l’ordinador i el cost va al teu compte d’ElevenLabs.</p>' : '';
+      : !ready && !loading ? '<p class="call-why">Per trucar cal una clau d’ElevenLabs amb el permís «ElevenAgents → Write». Es queda a l’ordinador i el cost va al teu compte d’ElevenLabs. <button class="linkish" type="button" data-call="guide">Com faig la clau?</button></p>' : '';
     return `${head}
       <section class="call-hero">
         <div class="call-face" aria-hidden="true"><span class="call-ring"></span><span class="call-ring r2"></span>${bot('idle', 'call-bot')}</div>
@@ -62,6 +62,7 @@ export function createCall(ctx) {
     const a = b.dataset.call;
     if (a === 'start') start();
     else if (a === 'voice') ctx.voiceSheet();
+    else if (a === 'guide') ctx.voiceSheet({ guide: true });
   });
 
   // ---------------------------------------------------------------- pantalla de la trucada