@danieltmn/tamnora 0.9.3 → 0.9.5

package/harness/packages/core/test/browser.test.js

@@ -0,0 +1,18 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { fileURLToPath } from 'node:url';
+import { existsSync } from 'node:fs';
+import { findBrowserPath } from '../src/browser/index.js';
+
+test('findBrowserPath respeta TAMNORA_BROWSER cuando el archivo existe', () => {
+  const self = fileURLToPath(import.meta.url);
+  assert.ok(existsSync(self));
+  const previous = process.env.TAMNORA_BROWSER;
+  process.env.TAMNORA_BROWSER = self;
+  try {
+    assert.equal(findBrowserPath(), self);
+  } finally {
+    if (previous === undefined) delete process.env.TAMNORA_BROWSER;
+    else process.env.TAMNORA_BROWSER = previous;
+  }
+});

package/harness/packages/core/test/tools.test.js

@@ -6,7 +6,7 @@ import path from 'node:path';
 import { resolveInRoot, toRel } from '../src/tools/paths.js';
 import { evaluatePermission } from '../src/tools/permissions.js';
 import { createTools, createToolRegistry } from '../src/tools/index.js';
-import { fetchUrlTool } from '../src/tools/executors.js';
+import { fetchUrlTool, previewUrlTool, screenshotTool, consoleTool } from '../src/tools/executors.js';
 
 async function makeWorkspace() {
   const root = await mkdtemp(path.join(tmpdir(), 'tamnora-ws-'));
@@ -169,3 +169,18 @@ test('la tool speak valida el texto y la recorta', async () => {
   const { definitions } = createTools({ root: await makeWorkspace() });
   assert.ok(definitions.some((d) => d.function.name === 'speak'));
 });
+
+test('screenshot, console_errors y preview_url validan la URL sin lanzar el navegador', async () => {
+  assert.match(previewUrlTool(null, { url: 'https://example.com/x' }), /example\.com/);
+  assert.match(previewUrlTool(null, {}), /falta "url"/);
+  assert.match(await screenshotTool(null, { url: 'ftp://x' }), /Solo se admite http/);
+  assert.match(await screenshotTool(null, {}), /falta "url"/);
+  assert.match(await consoleTool(null, { url: 'no-url' }), /URL inválida/);
+  assert.equal(evaluatePermission('screenshot', {}, {}), 'allow');
+  assert.equal(evaluatePermission('console_errors', {}, {}), 'allow');
+  assert.equal(evaluatePermission('preview_url', {}, {}), 'allow');
+  const { definitions } = createTools({ root: await makeWorkspace() });
+  for (const name of ['screenshot', 'console_errors', 'preview_url']) {
+    assert.ok(definitions.some((d) => d.function.name === name), `falta ${name}`);
+  }
+});

package/harness/packages/core/test/version.test.js

@@ -0,0 +1,34 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { compareVersions, fetchLatestVersion } from '../src/index.js';
+
+test('compareVersions ordena semver (incluye prerelease)', () => {
+  assert.equal(compareVersions('1.2.3', '1.2.3'), 0);
+  assert.equal(compareVersions('1.2.4', '1.2.3'), 1);
+  assert.equal(compareVersions('1.3.0', '1.2.9'), 1);
+  assert.equal(compareVersions('2.0.0', '1.9.9'), 1);
+  assert.equal(compareVersions('1.0.0', '1.0.0-beta'), 1);
+  assert.equal(compareVersions('1.0.0-beta', '1.0.0'), -1);
+  assert.equal(compareVersions('v0.9.4', '0.9.4'), 0);
+  // Formato desconocido: no afirmamos que hay algo nuevo.
+  assert.equal(compareVersions('base', '1.0.0'), 0);
+});
+
+test('fetchLatestVersion resuelve el tag desde el registro', async () => {
+  const fetchImpl = async (url) => {
+    assert.match(String(url), /registry\.npmjs\.org\/@danieltmn\/tamnora$/);
+    return { ok: true, json: async () => ({ 'dist-tags': { latest: '9.9.9' } }) };
+  };
+  assert.equal(await fetchLatestVersion({ fetchImpl }), '9.9.9');
+});
+
+test('fetchLatestVersion falla claro con HTTP malo o sin version', async () => {
+  await assert.rejects(
+    fetchLatestVersion({ fetchImpl: async () => ({ ok: false, status: 500 }) }),
+    /HTTP 500/
+  );
+  await assert.rejects(
+    fetchLatestVersion({ fetchImpl: async () => ({ ok: true, json: async () => ({}) }) }),
+    /version/
+  );
+});

package/harness/packages/server/public/app.js

@@ -1,6 +1,6 @@
 // Tamnora console — dependency-free client for the harness server (terminal theme).
 
-import { renderMarkdown } from './markdown.js';
+import { renderMarkdown, speechText } from './markdown.js';
 import { streamSse, followRun } from './runStream.js';
 import { diffState, pollDelayMs, localState, summarizeArgs } from './reconcile.js';
 import { installRelayTransport, showRelayTokenGate } from './relayClient.js';
@@ -217,7 +217,7 @@ function activateTab(name) {
   hideMoreMenu();
   if (name === 'runs') refreshRuns();
   if (name === 'providers') refreshProviders();
-  if (name === 'ajustes') { refreshMcp(); refreshSkills(); refreshChannels(); refreshLimits(); refreshVoz(); refreshTranscribe(); refreshProfile(); }
+  if (name === 'ajustes') { refreshMcp(); refreshSkills(); refreshChannels(); refreshLimits(); refreshVoz(); refreshAsesor(); refreshTranscribe(); refreshProfile(); }
 }
 
 document.querySelectorAll('.tab[data-tab]').forEach((t) =>
@@ -1158,6 +1158,10 @@ function toolSummary(name, args) {
       return shortText(a.url, 90);
     case 'speak':
       return shortText(a.texto, 90);
+    case 'screenshot':
+    case 'console_errors':
+    case 'preview_url':
+      return shortText(a.url, 90);
     case 'git_diff':
       return [a.ref ? `vs ${shortText(a.ref, 30)}` : a.staged ? 'staged' : 'unstaged', a.path ? shortText(a.path, 40) : '']
         .filter(Boolean)
@@ -1189,6 +1193,26 @@ function isFailedToolText(text) {
   return /^Error|^Permiso denegado/i.test(String(text ?? ''));
 }
 
+/** Nombre de archivo de una captura, del meta o del texto del resultado. */
+function screenshotName(data, text) {
+  const fromMeta = data?.meta?.screenshot?.name;
+  if (fromMeta) return String(fromMeta);
+  const match = /capturas\/([a-z0-9][a-z0-9-]*\.png)/i.exec(String(text ?? ''));
+  return match ? match[1] : null;
+}
+
+/** Muestra la captura del tool `screenshot` en su tarjeta (clic para ampliar). */
+function showScreenshot(entry, name) {
+  if (!entry || !name || entry.shot) return;
+  entry.shot = true;
+  const img = el('img', 'tool-shot');
+  img.loading = 'lazy';
+  img.alt = 'captura de pantalla';
+  img.src = `/api/screenshots/${encodeURIComponent(name)}`;
+  img.addEventListener('click', () => window.open(img.src, '_blank'));
+  entry.card.appendChild(img);
+}
+
 /** Cierra la tarjeta de un tool-call (evento tool_result o mensaje persistido). */
 function finishToolCard(entry, data) {
   if (!entry) return;
@@ -1203,6 +1227,7 @@ function finishToolCard(entry, data) {
     entry.truncated = true;
     entry.more.hidden = false;
   }
+  if (!failed) showScreenshot(entry, screenshotName(data, preview));
 }
 
 function previewText(value, maxLines = 24, maxChars = 4000) {
@@ -1439,8 +1464,35 @@ function userImages(content) {
     .filter(Boolean);
 }
 
+function advisorGlyph(kind) {
+  if (kind === 'code') return '⚠';
+  if (kind === 'explain') return 'ℹ';
+  return '✦';
+}
+
+/** Tarjeta del asesor: una capa de comentario, no un mensaje del agente. */
+function addAdvisorCard(container, { text, kind } = {}) {
+  const clean = String(text ?? '').trim();
+  if (!clean || !container) return null;
+  const exists = [...container.querySelectorAll('.advisor-text')].some((node) => node.textContent === clean);
+  if (exists) return null;
+  const card = el('div', `advisor-card${kind ? ` advisor-${kind}` : ''}`);
+  const head = el('div', 'advisor-head');
+  head.append(el('span', 'advisor-glyph', advisorGlyph(kind)), el('span', 'advisor-title', 'asesor'));
+  card.append(head, el('div', 'advisor-text', clean));
+  container.appendChild(card);
+  return card;
+}
+
 function renderStored(message, pane) {
   if (message.agent_id) return;
+  if (message.role === 'assistant' && message.name === 'advisor') {
+    addAdvisorCard(pane, {
+      text: typeof message.content === 'string' ? message.content : '',
+      kind: message.mode,
+    });
+    return;
+  }
   if (message.role === 'user') {
     const bubble = addMessage('user', userText(message.content), pane);
     if (message.id) {
@@ -1981,6 +2033,11 @@ function addContinueButton(turn, data) {
 function handleChatEvent(event, data, turn) {
   if (handleAgentEvent(event, data, turn)) return;
   narrar(event, data, turn);
+  if (event === 'advice') {
+    addAdvisorCard(turn.pane, { text: data?.text, kind: data?.kind });
+    scrollMessages(turn.pane);
+    return;
+  }
   if (event === 'agent_start') {
     turn.agents.set(data.agentId, addAgentCard(turn.assistant(), data));
   } else if (event === 'agent_end') {
@@ -2026,6 +2083,10 @@ function handleChatEvent(event, data, turn) {
       const texto = String(data.args?.texto ?? '').trim();
       if (texto) reproducirVoz(texto, { voice: data.args?.voice, rate: data.args?.rate, label: 'voz' }).catch(() => {});
     }
+    if (turn.live && data.name === 'preview_url' && data.args?.url) {
+      setExplorerMode('preview');
+      loadPreview(data.args.url);
+    }
   } else if (event === 'tool_result') {
     setActivity(turn.assistant(), 'thinking');
     finishToolCard(turn.lastTool, data);
@@ -3593,7 +3654,15 @@ const vozRateEl = $('#voz-rate');
 const vozAnnStartEl = $('#voz-ann-start');
 const vozAnnToolsEl = $('#voz-ann-tools');
 const vozAnnEndEl = $('#voz-ann-end');
+const vozAnnAdviceEl = $('#voz-ann-advice');
+const vozAnnAnswerEl = $('#voz-ann-answer');
 const vozFfmpegEl = $('#voz-ffmpeg');
+const asesorEnabledEl = $('#asesor-enabled');
+const asesorCodeEl = $('#asesor-code');
+const asesorExplainEl = $('#asesor-explain');
+const asesorAdviceEl = $('#asesor-advice');
+const asesorWordsEl = $('#asesor-words');
+const asesorNotesEl = $('#asesor-notes');
 const trProviderEl = $('#tr-provider');
 const trModelEl = $('#tr-model');
 
@@ -3926,7 +3995,7 @@ const voz = {
     enabled: false,
     voice: 'es-AR-ElenaNeural',
     rate: '+0%',
-    announce: { start: true, tools: true, end: true },
+    announce: { start: true, tools: true, end: true, advice: true, answer: false },
   },
 };
 
@@ -4057,10 +4126,10 @@ function reproducirVoz(frase, { voice, rate, label, maxAgeMs } = {}) {
  * Narra una frase del turno. Si el turno tarda y la frase quedó vieja en la
  * cola, se descarta al llegar su turno (`maxAgeMs`): narrar el pasado no informa.
  */
-function hablar(texto) {
+function hablar(texto, { label = 'narrando', maxAgeMs = 45000 } = {}) {
   const frase = String(texto ?? '').trim();
   if (!frase || !voz.settings.enabled) return;
-  reproducirVoz(frase, { label: 'narrando', maxAgeMs: 45000 }).catch(() => {});
+  reproducirVoz(frase, { label, maxAgeMs }).catch(() => {});
 }
 
 /** Habla el progreso de un turno EN VIVO: el replay de una reconexion no habla. */
@@ -4070,7 +4139,15 @@ function narrar(event, data, turn) {
   if (!enabled) return;
   if (event === 'start' && announce.start) hablar(data?.say);
   else if (event === 'tool_call' && announce.tools) hablar(data?.say);
-  else if ((event === 'done' || event === 'aborted' || event === 'error') && announce.end) hablar(data?.say);
+  // El asesor y la respuesta final son el cierre del turno: si quedan en cola
+  // detras de un audio largo, igual hay que leerlos (sin vencimiento).
+  else if (event === 'advice' && announce.advice) hablar(data?.say, { label: 'asesor', maxAgeMs: 0 });
+  else if (event === 'done' && announce.answer) {
+    // Lee la respuesta final limpia; si era solo codigo, cae al cierre.
+    const spoken = speechText(data?.content);
+    if (spoken) hablar(spoken, { label: 'respuesta', maxAgeMs: 0 });
+    else if (announce.end) hablar(data?.say);
+  } else if ((event === 'done' || event === 'aborted' || event === 'error') && announce.end) hablar(data?.say);
 }
 
 async function cargarVoces() {
@@ -4096,6 +4173,8 @@ async function aplicarVoz(data) {
       start: data.announce?.start !== false,
       tools: data.announce?.tools !== false,
       end: data.announce?.end !== false,
+      advice: data.announce?.advice !== false,
+      answer: data.announce?.answer === true,
     },
   };
   if (vozEnabledEl) vozEnabledEl.checked = voz.settings.enabled;
@@ -4113,6 +4192,8 @@ async function aplicarVoz(data) {
   if (vozAnnStartEl) vozAnnStartEl.checked = voz.settings.announce.start;
   if (vozAnnToolsEl) vozAnnToolsEl.checked = voz.settings.announce.tools;
   if (vozAnnEndEl) vozAnnEndEl.checked = voz.settings.announce.end;
+  if (vozAnnAdviceEl) vozAnnAdviceEl.checked = voz.settings.announce.advice;
+  if (vozAnnAnswerEl) vozAnnAnswerEl.checked = voz.settings.announce.answer;
   const estado = $('#voz-status');
   if (estado) {
     estado.className = `summary${voz.settings.enabled ? ' ok' : ''}`;
@@ -4136,6 +4217,8 @@ async function submitVoz() {
       start: vozAnnStartEl?.checked !== false,
       tools: vozAnnToolsEl?.checked !== false,
       end: vozAnnEndEl?.checked !== false,
+      advice: vozAnnAdviceEl?.checked !== false,
+      answer: vozAnnAnswerEl?.checked === true,
     },
   };
   const data = await api('/api/tts/settings', { method: 'PUT', body }).catch((e) => ({ error: e.message }));
@@ -4313,6 +4396,57 @@ async function testVoz() {
   }
 }
 
+/* --- ajustes: asesor ------------------------------------------------------- */
+
+function aplicarAsesor(data) {
+  if (!data) return;
+  if (asesorEnabledEl) asesorEnabledEl.checked = data.enabled === true;
+  if (asesorCodeEl) asesorCodeEl.checked = data.code !== false;
+  if (asesorExplainEl) asesorExplainEl.checked = data.explain !== false;
+  if (asesorAdviceEl) asesorAdviceEl.checked = data.advice !== false;
+  if (asesorWordsEl) asesorWordsEl.value = data.maxWords ?? 40;
+  if (asesorNotesEl) asesorNotesEl.value = data.notes ?? '';
+  const estado = $('#asesor-status');
+  if (estado) {
+    estado.className = `summary${data.enabled ? ' ok' : ''}`;
+    estado.textContent = data.enabled ? 'activo' : 'apagado';
+  }
+}
+
+async function refreshAsesor() {
+  if (!asesorEnabledEl) return;
+  const data = await api('/api/advisor/settings').catch(() => null);
+  if (data) aplicarAsesor(data);
+}
+
+function asesorBody() {
+  return {
+    enabled: asesorEnabledEl?.checked === true,
+    code: asesorCodeEl?.checked !== false,
+    explain: asesorExplainEl?.checked !== false,
+    advice: asesorAdviceEl?.checked !== false,
+    maxWords: Number(asesorWordsEl?.value) || 40,
+    notes: asesorNotesEl?.value ?? '',
+  };
+}
+
+async function submitAsesor() {
+  setStatus('#asesor-msg', 'guardando…');
+  const data = await api('/api/advisor/settings', { method: 'PUT', body: asesorBody() }).catch((e) => ({
+    error: e.message,
+  }));
+  if (data?.error) return setStatus('#asesor-msg', data.error, 'err');
+  aplicarAsesor(data);
+  setStatus('#asesor-msg', 'guardado', 'ok');
+}
+
+async function testAsesor() {
+  setStatus('#asesor-msg', 'consultando…');
+  const data = await api('/api/advisor/test', { method: 'POST' }).catch((e) => ({ error: e.message }));
+  if (data?.error) return setStatus('#asesor-msg', data.error, 'err');
+  setStatus('#asesor-msg', data.speak ? data.text : '(no diría nada en este caso)', 'ok');
+}
+
 /* --- ajustes: perfil del usuario ------------------------------------------ */
 
 const perfil = {
@@ -4445,8 +4579,10 @@ if (mcpListEl) {
   $('#mcp-reload').addEventListener('click', () => refreshMcp({ connect: true }));
   $('#tg-save')?.addEventListener('click', submitChannel);
   $('#tg-test')?.addEventListener('click', testChannel);
-  $('#voz-save')?.addEventListener('click', submitVoz);
-  $('#voz-test')?.addEventListener('click', testVoz);
+$('#voz-save')?.addEventListener('click', submitVoz);
+$('#voz-test')?.addEventListener('click', testVoz);
+$('#asesor-save')?.addEventListener('click', submitAsesor);
+$('#asesor-test')?.addEventListener('click', testAsesor);
   $('#mcp-close').addEventListener('click', closeMcpForm);
   $('#mf-cancel').addEventListener('click', closeMcpForm);
   $('#mf-transport').addEventListener('change', syncMcpFormFields);
@@ -5407,6 +5543,105 @@ function watchLifecycle() {
   window.addEventListener('pageshow', wake);
   window.addEventListener('online', wake);
   window.addEventListener('focus', wake);
+  // La cache del server dura 10 min: revisar al volver a la pestaña es barato.
+  refreshUpdate();
+}
+
+/* --- actualizacion de version --------------------------------------------- */
+
+const UPDATE_DISMISS_KEY = 'tamnora-update-dismissed';
+const updateBanner = $('#update-banner');
+const updateBannerText = $('#update-banner-text');
+let updateInfo = null;
+
+function showUpdateBanner(info, { force = false } = {}) {
+  if (!updateBanner || !info?.updateAvailable) return;
+  if (!force && storage.get(UPDATE_DISMISS_KEY) === String(info.latest)) return;
+  updateInfo = info;
+  updateBannerText.textContent = `Hay una versión nueva (v${info.latest}); tenés la v${info.current}.`;
+  updateBanner.hidden = false;
+  const ver = document.querySelector('.brand .ver');
+  if (ver) {
+    ver.classList.add('has-update');
+    ver.title = `Actualización disponible: v${info.latest}`;
+  }
+}
+
+async function refreshUpdate() {
+  if (!updateBanner) return;
+  const info = await api('/api/update').catch(() => null);
+  if (info?.updateAvailable) showUpdateBanner(info);
+}
+
+function dismissUpdate() {
+  if (updateInfo?.latest) storage.set(UPDATE_DISMISS_KEY, String(updateInfo.latest));
+  if (updateBanner) updateBanner.hidden = true;
+}
+
+/** Chequeo manual (click en la version): fuerza la consulta y avisa el resultado. */
+async function forceUpdateCheck() {
+  const ver = document.querySelector('.brand .ver');
+  const original = ver?.textContent;
+  if (ver) ver.textContent = '…';
+  const info = await api('/api/update?force=1').catch(() => null);
+  if (ver) ver.textContent = info?.current ? `v${info.current}` : original;
+  if (!info) return toast('No pude consultar la versión.');
+  if (info.updateAvailable) {
+    showUpdateBanner(info, { force: true });
+    toast(`Hay una versión nueva: v${info.latest}`);
+  } else if (info.error) {
+    toast(`No pude consultar npm: ${info.error}`);
+  } else {
+    toast(`Estás al día (v${info.current}).`);
+  }
+}
+
+/** Espera a que el server reiniciado vuelva a responder `/api/health`. */
+async function waitServerVersion(tries = 45) {
+  for (let i = 0; i < tries; i++) {
+    await new Promise((r) => setTimeout(r, 2000));
+    const health = await fetch('/api/health', { cache: 'no-store' })
+      .then((r) => (r.ok ? r.json() : null))
+      .catch(() => null);
+    if (health?.version) return health.version;
+  }
+  return '';
+}
+
+async function runUpdate() {
+  if (!updateInfo) return;
+  if (!confirm(`¿Actualizar a la v${updateInfo.latest}? La consola se reinicia sola.`)) return;
+  const runBtn = $('#update-run');
+  const laterBtn = $('#update-later');
+  if (runBtn) runBtn.disabled = true;
+  if (laterBtn) laterBtn.disabled = true;
+  updateBannerText.textContent = `Actualizando a v${updateInfo.latest}…`;
+  const res = await api('/api/update', { method: 'POST' }).catch((error) => ({ error: error.message }));
+  if (res?.error) {
+    updateBannerText.textContent = `No se pudo actualizar: ${res.error}`;
+    if (runBtn) runBtn.disabled = false;
+    if (laterBtn) laterBtn.disabled = false;
+    return;
+  }
+  updateBannerText.textContent = 'Instalando la versión nueva… la consola se va a reconectar.';
+  const version = await waitServerVersion();
+  if (version) {
+    updateBannerText.textContent = `Actualizado a v${version}. Recargando…`;
+    setTimeout(() => location.reload(), 900);
+  } else {
+    updateBannerText.textContent = 'No pude confirmar el reinicio. Recargá la página en unos segundos.';
+    if (runBtn) runBtn.disabled = false;
+    if (laterBtn) laterBtn.disabled = false;
+  }
+}
+
+$('#update-run')?.addEventListener('click', runUpdate);
+$('#update-later')?.addEventListener('click', dismissUpdate);
+const brandVerEl = document.querySelector('.brand .ver');
+if (brandVerEl) {
+  brandVerEl.title = 'buscar actualización';
+  brandVerEl.classList.add('ver-action');
+  brandVerEl.addEventListener('click', forceUpdateCheck);
 }
 
 /* --- boot ---------------------------------------------------------------- */
@@ -5430,6 +5665,7 @@ async function boot() {
     const ver = document.querySelector('.brand .ver');
     if (ver) ver.textContent = `v${health.version}`;
   }
+  refreshUpdate();
   await refreshProviders();
   await loadModes();
   await loadModels();

package/harness/packages/server/public/index.html

@@ -34,7 +34,7 @@
   </head>
   <body>
     <header class="topbar">
-      <div class="brand"><span class="logo"><span class="logo-t">T</span><span class="logo-h">H</span></span> <span class="ver">v0.9.3</span></div>
+      <div class="brand"><span class="logo"><span class="logo-t">T</span><span class="logo-h">H</span></span> <span class="ver">v0.9.5</span></div>
       <nav class="tabs">
         <button class="tab active" data-tab="chat">chat</button>
         <button class="tab" data-tab="providers">proveedores</button>
@@ -88,6 +88,15 @@
       </div>
     </header>
 
+    <div id="update-banner" class="update-banner" hidden>
+      <span class="update-banner-icon" aria-hidden="true">⬆</span>
+      <span id="update-banner-text" class="update-banner-text"></span>
+      <div class="update-banner-actions">
+        <button id="update-run" type="button" class="btn primary">actualizar</button>
+        <button id="update-later" type="button" class="btn">más tarde</button>
+      </div>
+    </div>
+
     <main>
       <section id="view-chat" class="view active">
         <aside id="sidebar" class="sidebar">
@@ -415,8 +424,9 @@
             <button type="button" class="ajustes-tab" data-panel="mcp" role="tab">MCP</button>
             <button type="button" class="ajustes-tab" data-panel="skills" role="tab">Skills</button>
             <button type="button" class="ajustes-tab" data-panel="telegram" role="tab">Telegram</button>
-            <button type="button" class="ajustes-tab" data-panel="voz" role="tab">Voz</button>
-            <button type="button" class="ajustes-tab" data-panel="transcripcion" role="tab">Transcripción</button>
+          <button type="button" class="ajustes-tab" data-panel="voz" role="tab">Voz</button>
+          <button type="button" class="ajustes-tab" data-panel="asesor" role="tab">Asesor</button>
+          <button type="button" class="ajustes-tab" data-panel="transcripcion" role="tab">Transcripción</button>
             <button type="button" class="ajustes-tab" data-panel="limites" role="tab">Límites</button>
           </nav>
 
@@ -626,6 +636,12 @@
             <label class="check" title="avisar al terminar">
               <input id="voz-ann-end" type="checkbox" /> el cierre
             </label>
+            <label class="check" title="leer los consejos del asesor">
+              <input id="voz-ann-advice" type="checkbox" /> los consejos del asesor
+            </label>
+            <label class="check" title="leer la respuesta final del agente, sin bloques de código ni tablas">
+              <input id="voz-ann-answer" type="checkbox" /> la respuesta final (sin código)
+            </label>
           </div>
           <p id="voz-ffmpeg" class="muted" hidden>
             Sin <code>ffmpeg</code> en el PATH, en Telegram llega como audio MP3 en vez de nota
@@ -638,6 +654,44 @@
           </div>
         </div>
 
+        <div class="panel ajustes-panel" data-panel="asesor">
+          <div class="row between">
+            <h2>Asesor</h2>
+            <span id="asesor-status" class="summary">cargando…</span>
+          </div>
+          <p class="muted verify-line">
+            Un asesor que observa lo que el agente hace, lo interpreta y solo habla cuando tiene
+            algo que aportar: te alerta de un problema en el código, te explica un proceso o te da
+            un consejo. No lee la respuesta del agente. Usa el proveedor y modelo activos.
+          </p>
+          <label class="check" title="tener un asesor que interprete y comente el turno">
+            <input id="asesor-enabled" type="checkbox" /> Habilitar el asesor
+          </label>
+          <div class="voz-announce">
+            <span class="muted">qué aporta:</span>
+            <label class="check" title="alertar de problemas reales en el código">
+              <input id="asesor-code" type="checkbox" /> problemas en el código
+            </label>
+            <label class="check" title="explicar procesos o decisiones">
+              <input id="asesor-explain" type="checkbox" /> explicar procesos
+            </label>
+            <label class="check" title="dar consejos concretos">
+              <input id="asesor-advice" type="checkbox" /> consejos
+            </label>
+          </div>
+          <label class="field"><span>largo de cada consejo (palabras)</span>
+            <input id="asesor-words" type="number" min="10" max="120" step="5" value="40" />
+          </label>
+          <label class="field"><span>instrucciones para el asesor (opcional)</span>
+            <textarea id="asesor-notes" rows="3" placeholder="Ej: avisame siempre si toco secretos o config de producción."></textarea>
+          </label>
+          <div class="row">
+            <button id="asesor-save" class="btn primary" type="button">guardar</button>
+            <button id="asesor-test" class="btn" type="button">probar asesor</button>
+            <span id="asesor-msg" class="summary"></span>
+          </div>
+        </div>
+
         <div class="panel ajustes-panel" data-panel="transcripcion">
           <div class="row between">
             <h2>Transcripción</h2>

package/harness/packages/server/public/landing/index.html

@@ -451,7 +451,8 @@
 
           <p class="hero-copy">
             Un harness local para orquestar agentes de IA, ejecutar tools en tu workspace y mantener el
-            control desde tu máquina o el celular (túnel + QR o Telegram).
+            control desde tu máquina o el celular (túnel + QR o Telegram). Renderiza páginas con un
+            navegador headless, narra su progreso y hace trazable cada corrida.
           </p>
 
           <div class="actions">
@@ -472,6 +473,18 @@
               <div class="feature-icon">✓</div>
               <div><b>Control</b><span>Permisos allow/ask/deny y runs trazables.</span></div>
             </div>
+            <div class="feature">
+              <div class="feature-icon">◎</div>
+              <div><b>Navegador</b><span>Screenshot y errores de consola de una página.</span></div>
+            </div>
+            <div class="feature">
+              <div class="feature-icon">♪</div>
+              <div><b>Voz</b><span>Narra el progreso y manda audio bajo pedido.</span></div>
+            </div>
+            <div class="feature">
+              <div class="feature-icon">⌘</div>
+              <div><b>Multi-modelo</b><span>OpenRouter, OpenAI, Claude, Gemini y Ollama.</span></div>
+            </div>
           </div>
         </section>
 

package/harness/packages/server/public/markdown.js

@@ -215,3 +215,57 @@ export function renderMarkdown(text) {
   flush();
   return out.join('\n');
 }
+
+function cleanSpeechLine(line) {
+  return line
+    .replace(/^\s*#{1,6}\s+/, '')
+    .replace(/^\s*>\s?/, '')
+    .replace(/^\s*([-*+]|\d+[.)])\s+/, '')
+    .replace(/!\[([^\]]*)\]\([^)]*\)/g, '$1')
+    .replace(/\[([^\]]+)\]\([^)]*\)/g, '$1')
+    .replace(/`([^`]+)`/g, '$1')
+    .replace(/\*\*([^*]+)\*\*/g, '$1')
+    .replace(/__([^_]+)__/g, '$1')
+    .replace(/(^|[^*\w])\*([^*\n]+)\*/g, '$1$2')
+    .replace(/(^|[^_\w])_([^_\n]+)_/g, '$1$2');
+}
+
+/**
+ * Version hablada de una respuesta: deja el texto corrido y saca lo que no se
+ * lee bien (bloques de codigo, tablas, marcas de markdown). Recorta a `maxChars`
+ * cortando en un limite de oracion, para no mandar una sintesis gigante al TTS.
+ */
+export function speechText(text, { maxChars = 1500 } = {}) {
+  const stripped = String(text ?? '')
+    .replace(/```[\s\S]*?```/g, ' ')
+    .replace(/~~~[\s\S]*?~~~/g, ' ');
+  const lines = stripped.replace(/\r\n?/g, '\n').split('\n');
+  const kept = [];
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+    if (line.includes('|') && i + 1 < lines.length && isDelimiterRow(lines[i + 1])) {
+      i += 2;
+      while (i < lines.length && lines[i].trim() && lines[i].includes('|')) i += 1;
+      continue;
+    }
+    if (/^\s*([-*_])(\s*\1){2,}\s*$/.test(line)) {
+      i += 1;
+      continue;
+    }
+    kept.push(cleanSpeechLine(line));
+    i += 1;
+  }
+  let out = kept.join('\n').replace(/\s+/g, ' ').trim();
+  if (out.length > maxChars) {
+    const slice = out.slice(0, maxChars);
+    const cut = Math.max(
+      slice.lastIndexOf('. '),
+      slice.lastIndexOf('! '),
+      slice.lastIndexOf('? '),
+      slice.lastIndexOf('; ')
+    );
+    out = `${(cut > maxChars * 0.5 ? slice.slice(0, cut + 1) : slice).trim()}…`;
+  }
+  return out;
+}

package/harness/packages/server/public/reconcile.js

@@ -110,7 +110,9 @@ export function summarizeArgs(name, args, max = 240) {
   if ((name === 'write' || name === 'edit' || name === 'read') && a.path) {
     return a.content ? `${a.path} · ${humanSize(a.content)}` : String(a.path);
   }
-  if ((name === 'fetch_url' || name === 'preview_url') && a.url) return cut(a.url);
+  if ((name === 'fetch_url' || name === 'preview_url' || name === 'screenshot' || name === 'console_errors') && a.url) {
+    return cut(a.url);
+  }
   if (name === 'task' && (a.description || a.prompt)) return cut(a.description || a.prompt);
   const keys = Object.keys(a);
   if (keys.length === 1 && typeof a[keys[0]] === 'string') return cut(a[keys[0]]);