@danieltmn/tamnora 0.9.3 → 0.9.5

package/CHANGELOG.md

@@ -5,6 +5,36 @@ Todos los cambios relevantes de este proyecto se documentan en este archivo.
 El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
 y el proyecto usa [Versionado Semantico](https://semver.org/lang/es/).
 
+## [0.9.5] - 2026-10-08
+
+### Agregado
+
+- **Actualizacion desde la consola**: `GET /api/update` consulta el registro npm
+  y un banner ofrece **actualizar con un click**; `POST /api/update` (solo
+  loopback) apaga el server, instala la version nueva con un script detached y lo
+  vuelve a levantar. Un click en la version del topbar fuerza el chequeo.
+  `tamnora update` detiene el server antes de instalar (Windows bloquea los
+  archivos), detecta drift entre instalaciones y lo reinicia; `tamnora doctor`
+  avisa si hay una version nueva.
+- **Asesor**: una capa de comentario sobre el run activo que interpreta lo que
+  hizo el agente y, si aporta algo, alerta un problema real de codigo, explica un
+  proceso o da un consejo. No lee la respuesta del agente. Tarjeta en el chat,
+  evento `advice` y voz opcional. Ajustes en la pestana **Asesor** (`app.json` ->
+  `advisor`).
+- **Voz: leer la respuesta final**: `tts.announce.answer` lee la respuesta del
+  agente limpiando bloques de codigo, tablas y marcas de markdown.
+
+### Corregido
+
+- El asesor y la respuesta final ya no se descartan de la cola de audio cuando
+  quedan detras de una narracion larga (`maxAgeMs: 0`).
+
+## [0.9.4] - 2026-10-07
+
+### Cambios
+
+- feat: navegador headless (screenshot/console_errors) y permisos de Telegram
+
 ## [0.9.3] - 2026-10-07
 
 ### Cambios

package/README.md

@@ -5,8 +5,19 @@ con TUI, consola web, tools locales, MCP y evaluacion de modelos.
 
 - **Sin dependencias**: solo modulos de Node (`node:sqlite`, `node:crypto`, ...).
 - **Local**: corre en tu maquina y guarda el estado en tu casa local.
-- **Multi-proveedor**: OpenRouter, OpenAI, proveedores compatibles (DeepSeek,
-  Groq, Mistral, xAI, Together, Fireworks, Cerebras, Perplexity) y Ollama.
+- **Multi-proveedor**: OpenRouter, OpenAI, Anthropic (Claude), Google Gemini,
+  proveedores compatibles (DeepSeek, Groq, Mistral, xAI, Together, Fireworks,
+  Cerebras, Perplexity) y Ollama.
+- **Navegador headless**: tools `screenshot` y `console_errors` (renderiza JS y
+  saca una captura PNG o lista los errores de consola) y `preview_url`.
+- **Voz**: el agente narra su progreso, puede **leer la respuesta final** (sin
+  bloques de codigo ni tablas) y mandar audio bajo pedido (`speak`,
+  `/audioresumen`).
+- **Asesor**: una capa de comentario sobre el run que interpreta lo que hizo el
+  agente y, si aporta algo, avisa de un problema en el codigo, explica un proceso
+  o da un consejo (con tarjeta en el chat y voz opcional). No lee la respuesta.
+- **Actualizar desde la consola**: la consola avisa cuando hay una version nueva
+  y la instala con un click (el server se reinicia solo).
 
 ## Instalacion
 
@@ -39,7 +50,8 @@ tamnora tui --mode plan   # modo plan: solo lectura, sin escritura ni bash
 Atajos: `enter` enviar · `↑/↓` historial · `←/→` cursor · `home/end` inicio/fin ·
 `pgup/pgdn` scroll · `ctrl+l` limpiar · `ctrl+c` cancelar/salir · `/salir`,
 `/limpiar`. El pegado de bloques multilinea entra como un solo texto y el header
-muestra el contexto usado (`ctx <tokens>`).
+muestra el contexto usado (`ctx <tokens>`). Las tools `write`/`edit` muestran un
+**diff lado a lado** (viejo en rojo, nuevo en verde, con numeros de linea).
 
 ### Server como servicio
 
@@ -50,8 +62,8 @@ tamnora server --reload       # reinicia aplicando config/codigo
 tamnora server --stop
 tamnora server --status
 tamnora server --logs --follow
-tamnora doctor                # verifica Node, casa, puerto y base
-tamnora update                # busca/instala una version nueva
+tamnora doctor                # verifica Node, casa, puerto, base y version nueva
+tamnora update                # busca/instala una version nueva (reinicia el server)
 tamnora autostart install     # arranque automatico del server
 ```
 
@@ -63,10 +75,14 @@ Tamnora (override con `--home` o `TAMNORA_HOME`):
 - macOS: `~/Library/Application Support/tamnora`
 - Linux: `~/.config/tamnora`
 
-> **Actualizar**: en `0.4.1+` alcanza con `tamnora update` (o `--yes`). Si venis de
-> **`0.4.0` o anterior**, `tamnora update` fallaba en Windows, asi que hace una vez
-> `npm i -g @danieltmn/tamnora@latest` (agrega `--prefer-online` si el cache de npm
-> devuelve la version vieja) o corre con `npx @danieltmn/tamnora@latest`.
+> **Actualizar**: en `0.9.5+` la consola avisa cuando hay una version nueva y la
+> instala con un click (el server se reinicia solo); un click en la version del
+> topbar fuerza el chequeo. Por CLI, `tamnora update --yes` ahora **detiene el
+> server antes de instalar** (en Windows libera los archivos) y lo reinicia. Si
+> venis de **`0.8.0` o anterior** y "dice que actualizo pero sigue igual", hace una
+> vez: `tamnora server --stop`, `npm i -g @danieltmn/tamnora@latest` y
+> `tamnora server --start`. Verifica que `where tamnora` coincida con
+> `npm root -g` (si no, hay dos instalaciones y el update toca la otra).
 
 ### Consola web
 
@@ -91,6 +107,16 @@ menu "mas" (los tres puntitos). En el chat:
 - **Runs durables**: cerrar el celular o cortar la red **no cancela** el turno; al
   volver, la consola **reconecta** y reconstruye el progreso. Para cortarlo se usa
   el boton de detener (o `POST /api/sessions/:id/stop`).
+- **Audio**: un unico reproductor encola la narracion, el tool `speak`, la
+  respuesta final y los consejos del asesor, y reproduce de a uno con pausa y
+  detener (Ajustes -> Voz).
+- **Asesor**: en Ajustes -> Asesor se activa una capa que comenta el turno
+  (problemas de codigo / explicaciones / consejos) con proveedor y modelo activos.
+- **Actualizar**: cuando npm tiene una version nueva aparece un banner para
+  actualizar con un click; el server se reinicia solo.
+- **Comandos**: el input muestra un menu al escribir `/` (`/new`, `/init`, `/goal`,
+  `/resumen`, `/audioresumen`, `/compact`, `/clear`, `/cwd`, `/kill`, `/help`).
+- **Capturas**: el tool `screenshot` muestra la imagen inline en su tarjeta.
 
 ### Preview
 
@@ -136,10 +162,15 @@ Con un token de bot (`telegram.token` en `tamnora.json`, `app.json` o
 `TAMNORA_TELEGRAM_TOKEN`) podes manejar el harness desde el chat. Cada chat mapea
 a una sesion y el bot soporta:
 
-- texto, **imagenes** y **notas de voz** (transcripcion con `telegram.transcribeModel`,
-  default `whisper-1`, via `POST {baseUrl}/audio/transcriptions`);
-- aprobaciones `ask` con **botones inline** (permitir/denegar);
-- comandos `/new`, `/status`, `/model`, `/provider`, `/mode`, `/stop`, `/help`;
+- texto, **imagenes** (entrantes y salientes: el tool `screenshot` llega como foto)
+  y **notas de voz** (transcripcion con `telegram.transcribeModel`, default
+  `whisper-1`, via `POST {baseUrl}/audio/transcriptions`);
+- aprobaciones `ask` con **botones inline** y una explicacion de lo que va a hacer
+  el agente (`Permitir` / `Permitir todo` / `Denegar`); "Permitir todo" deja de
+  preguntar por el resto de la sesion;
+- el bot **solo manda audio cuando lo pedis** (tool `speak` o `/audioresumen`);
+- comandos `/new`, `/resumen`, `/audioresumen`, `/status`, `/model`, `/provider`,
+  `/mode`, `/stop`, `/help`;
 - **notificaciones**: si un run de la consola pertenece a una sesion vinculada a un
   chat, el canal avisa el fin, los errores, los subagentes y los permisos.
 
@@ -161,11 +192,15 @@ entorno completo, `"inheritEnv": true`.
 ## Tools
 
 Tools locales confinadas al workspace (`read`, `list`, `glob`, `grep`, `write`,
-`edit`, `bash`, `fetch_url`) y de Git (`git_status`, `git_diff`, `git_log`,
+`edit`, `bash`, `fetch_url`), de navegador (`screenshot`, `console_errors`,
+`preview_url`), de voz (`speak`) y de Git (`git_status`, `git_diff`, `git_log`,
 `git_commit`), con permisos `allow`/`ask`/`deny` por tool o por patron.
+
 `fetch_url` lee URLs (HTML a texto) y avisa cuando un sitio exige JavaScript o
-esta detras de Cloudflare; para esos casos, registra un MCP de navegador (por
-ejemplo Playwright).
+esta detras de Cloudflare; para esos casos las tools `screenshot` / `console_errors`
+usan el **Chrome/Edge/Chromium del sistema** como navegador headless (sin
+dependencias): sacan una captura PNG y recolectan los errores de consola. Para
+automatizacion mas completa, registra un MCP (por ejemplo Playwright).
 
 ## Subagentes
 

package/harness/packages/cli/src/commands/doctor.js

@@ -7,6 +7,9 @@ import {
   databasePath,
   serverLogPath,
   Store,
+  readPackageVersion,
+  compareVersions,
+  fetchLatestVersion,
 } from '../../../core/src/index.js';
 import { parse } from '../lib/util.js';
 import { pidAlive, readRuntime } from '../lib/daemon.js';
@@ -52,6 +55,17 @@ export async function doctorCommand(argv) {
   checks.push(['base de datos', dbOk, dbOk ? '' : 'se creara al primer uso']);
   checks.push(['proveedor activo', Boolean(provider), provider || 'elegi uno en la consola (npm: tamnora serve)']);
 
+  const current = readPackageVersion();
+  let versionHint = '';
+  try {
+    const latest = await fetchLatestVersion();
+    versionHint =
+      compareVersions(latest, current) > 0 ? `hay v${latest}: corre tamnora update --yes` : 'al dia';
+  } catch (error) {
+    versionHint = `no pude verificar (${error?.message ?? error})`;
+  }
+  checks.push([`version (v${current})`, true, versionHint]);
+
   if (serverLive) checks.push([`server (pid ${rt.pid})`, true, rt.url || '']);
   checks.push([`logs`, true, serverLogPath()]);
 

package/harness/packages/cli/src/commands/update.js

@@ -1,16 +1,26 @@
 import { spawnSync } from 'node:child_process';
-import { readPackageVersion } from '../lib/core.js';
+import path from 'node:path';
+import { fetchLatestVersion, compareVersions, packageRoot, readPackageVersion, readApp } from '../lib/core.js';
 import { parse } from '../lib/util.js';
+import { readRuntime, pidAlive, stopRunningServer, spawnDetached, portHint } from '../lib/daemon.js';
 
 const PACKAGE = '@danieltmn/tamnora';
 const IS_WIN = process.platform === 'win32';
 const NPM = IS_WIN ? 'npm.cmd' : 'npm';
-const OPTIONS = { yes: { type: 'boolean', short: 'y' }, check: { type: 'boolean' }, tag: { type: 'string' }, help: { type: 'boolean', short: 'h' } };
+const OPTIONS = {
+  yes: { type: 'boolean', short: 'y' },
+  check: { type: 'boolean' },
+  restart: { type: 'boolean' },
+  'no-restart': { type: 'boolean' },
+  tag: { type: 'string' },
+  help: { type: 'boolean', short: 'h' },
+};
 
 function npm(args) {
-  return spawnSync(NPM, args, { encoding: 'utf8', windowsHide: true, shell: IS_WIN });
+  return spawnSync(NPM, args, { encoding: 'utf8', windowsHide: true, shell: IS_WIN, timeout: 180000 });
 }
 
+/** Version del paquete instalado globalmente (la que resuelve `npm ls -g`). */
 function installedVersion() {
   const out = npm(['ls', '-g', PACKAGE, '--json', '--depth=0']);
   try {
@@ -21,10 +31,49 @@ function installedVersion() {
   }
 }
 
+function globalRoot() {
+  const out = npm(['root', '-g']);
+  return out.status === 0 ? String(out.stdout || '').trim() : '';
+}
+
+const norm = (p) => path.resolve(String(p || '')).toLowerCase();
+
+/**
+ * Detiene el server gestionado (runtime.json) para que Windows libere los
+ * archivos bloqueados; sin esto `npm i -g` falla o queda a medias.
+ */
+async function stopServerIfRunning() {
+  const rt = readRuntime();
+  if (!rt || !pidAlive(rt.pid)) return null;
+  console.log(`Deteniendo el server (pid ${rt.pid}) para poder reemplazar los archivos...`);
+  stopRunningServer();
+  for (let i = 0; i < 25 && pidAlive(rt.pid); i++) await new Promise((r) => setTimeout(r, 200));
+  return rt;
+}
+
+function restartServer(rt) {
+  try {
+    const bin = process.argv[1];
+    const args = [bin, 'server', '--stream', '--no-open'];
+    if (rt?.port) args.push('--port', String(rt.port));
+    if (rt?.host) args.push('--host', rt.host);
+    if (rt?.cwd) args.push('--dir', rt.cwd);
+    const { child } = spawnDetached(args, { envFlag: 'TAMNORA_DETACHED' });
+    console.log(`Server reiniciado en segundo plano (pid ${child.pid}).`);
+  } catch (error) {
+    console.error(`No pude reiniciar el server solo: ${error?.message ?? error}`);
+    console.error('Reinicialo a mano: tamnora server --start');
+  }
+}
+
 export async function updateCommand(argv) {
   const { values } = parse(argv, OPTIONS);
   if (values.help) {
-    console.log('Uso: tamnora update [--check] [--yes]\n\nBusca una version nueva en npm y actualiza la instalacion global.');
+    console.log(
+      'Uso: tamnora update [--check] [--yes] [--no-restart]\n\n' +
+        'Busca una version nueva en npm y actualiza la instalacion global.\n' +
+        'Detiene el server antes de instalar (en Windows libera los archivos) y lo reinicia al terminar.'
+    );
     return 0;
   }
 
@@ -33,24 +82,20 @@ export async function updateCommand(argv) {
   const version = readPackageVersion();
   console.log(`Version actual: ${version}`);
 
-  const view = npm(['view', spec, 'version', '--json']);
   let latest = '';
   try {
-    latest = String(JSON.parse(view.stdout)).trim();
-  } catch {
-    latest = String(view.stdout || '').trim().replace(/"/g, '');
-  }
-  if (view.status !== 0 || !/^\d+\.\d+\.\d+/.test(latest)) {
-    console.error(`No se pudo consultar npm (${tag}): ${(view.stderr || '').trim() || 'revisa tu conexion'}`);
+    latest = await fetchLatestVersion({ pkg: PACKAGE, tag });
+  } catch (error) {
+    console.error(`No se pudo consultar npm (${tag}): ${error?.message ?? error}`);
     return 1;
   }
   console.log(`Disponible (${tag}): ${latest}`);
-  if (latest === version) {
+  if (compareVersions(latest, version) <= 0) {
     console.log('Ya estas en la ultima version.');
     return 0;
   }
   if (values.check) {
-    console.log(`Hay una version nueva. Corre: tamnora update --yes`);
+    console.log('Hay una version nueva. Corre: tamnora update --yes');
     return 0;
   }
   if (!values.yes) {
@@ -60,21 +105,46 @@ export async function updateCommand(argv) {
     return 0;
   }
 
+  const wasRunning = await stopServerIfRunning();
+  if (!wasRunning) {
+    // Un server no gestionado (ej. `pnpm serve` en primer plano) tambien
+    // bloquea los archivos. Avisamos en vez de matar un proceso ajeno.
+    const app = readApp();
+    const hint = app?.port ? portHint(app.port) : '';
+    if (hint) console.warn(`aviso: algo escucha en el puerto ${app.port} (${hint}); cerralo si la instalacion falla.`);
+  }
+
   console.log(`Actualizando a ${spec}...`);
-  const result = spawnSync(NPM, ['i', '-g', spec], {
-    stdio: 'inherit',
-    windowsHide: true,
-    shell: IS_WIN,
-  });
+  const result = spawnSync(NPM, ['i', '-g', spec], { stdio: 'inherit', windowsHide: true, shell: IS_WIN });
   if (result.status !== 0) {
     console.error(`La actualizacion fallo. Proba a mano: npm i -g ${spec}`);
+    if (wasRunning) restartServer(wasRunning);
     return 1;
   }
+
   const installed = installedVersion() || readPackageVersion();
   console.log(`Listo. Instalado: v${installed} (pediste ${latest}).`);
-  if (installed && installed !== latest) {
-    console.log('Ojo: la version instalada no coincide con la publicada. Cerra procesos que usen la carpeta y reintenta.');
+
+  // Drift: npm instala en un prefix distinto al de la copia que esta corriendo.
+  const runningRoot = packageRoot();
+  const expectedRoot = globalRoot();
+  const expectedPkg = expectedRoot ? path.join(expectedRoot, ...PACKAGE.split('/')) : '';
+  if (runningRoot && expectedPkg && norm(runningRoot) !== norm(expectedPkg)) {
+    console.warn('Ojo: la copia global quedo en un lugar distinto al de esta instalacion.');
+    console.warn(`  instalada: ${expectedPkg}`);
+    console.warn(`  en uso:    ${runningRoot}`);
+    console.warn('  puede que el update no afecte la copia que corre; revisa cual resuelve "tamnora".');
+  }
+  if (installed && compareVersions(installed, latest) < 0) {
+    console.warn('Ojo: la version instalada no coincide con la publicada. Cerra procesos que usen la carpeta y reintenta.');
+  }
+
+  if (values['no-restart']) {
+    console.log('Reinicia el server cuando quieras: tamnora server --reload');
+  } else if (wasRunning || values.restart) {
+    restartServer(wasRunning || { port: readApp().port });
+  } else {
+    console.log('Reinicia el server: tamnora server --reload');
   }
-  console.log('Reinicia el server: tamnora server --reload');
   return 0;
 }

package/harness/packages/core/src/agent/modes.js

@@ -13,7 +13,20 @@ export const MODES = {
     id: 'plan',
     label: 'Plan',
     description: 'Solo lectura: investiga y propone un plan, sin modificar nada.',
-    tools: ['read', 'list', 'glob', 'grep', 'fetch_url', 'speak', 'git_status', 'git_diff', 'git_log'],
+    tools: [
+      'read',
+      'list',
+      'glob',
+      'grep',
+      'fetch_url',
+      'speak',
+      'screenshot',
+      'console_errors',
+      'preview_url',
+      'git_status',
+      'git_diff',
+      'git_log',
+    ],
     systemPrompt:
       'Estás en modo PLAN: no modifiques archivos ni ejecutes comandos. Investigá el proyecto con las herramientas de solo lectura y respondé con un plan concreto y accionable.',
   },

package/harness/packages/core/src/agent/runAgent.js

@@ -215,12 +215,19 @@ export async function runAgent({
         }
       }
 
-      onEvent?.({ type: 'tool_result', id: call.id, name, result: output });
+      const normalized = normalizeToolOutput(output);
+      onEvent?.({
+        type: 'tool_result',
+        id: call.id,
+        name,
+        result: normalized.content,
+        meta: normalized.meta,
+      });
       working.push({
         role: 'tool',
         tool_call_id: call.id,
         name,
-        content: typeof output === 'string' ? output : JSON.stringify(output),
+        content: normalized.content,
       });
     }
 
@@ -315,6 +322,20 @@ function createStallGuard(onEvent, stallWarnMs) {
   };
 }
 
+/**
+ * Normaliza el resultado de un tool a `{ content, meta }`. Un executor puede
+ * devolver un string (lo normal) o `{ content, meta }` cuando necesita mandar
+ * metadata al cliente sin ensuciar lo que ve el modelo (p. ej. una captura).
+ */
+export function normalizeToolOutput(output) {
+  if (typeof output === 'string') return { content: output };
+  if (output && typeof output === 'object' && typeof output.content === 'string') {
+    return { content: output.content, meta: output.meta };
+  }
+  if (output == null) return { content: '' };
+  return { content: JSON.stringify(output) };
+}
+
 async function defaultExecute(name) {
   return `Error: la herramienta "${name}" no está disponible todavía (se agrega en la Fase 1).`;
 }