@danieltmn/tamnora 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.19.0] - 2026-10-12
+
+### Cambios
+
+- fix(consola): permiso y URL de preview legibles en movil
+- feat(voz): velocidad y tono como rangos numericos
+
 ## [0.18.0] - 2026-10-12
 
 ### Agregado

package/harness/packages/core/src/tools/executors.js

@@ -422,11 +422,11 @@ const MAX_SPEAK_TEXT = 1200;
  * son del cliente (la consola lo reproduce y Telegram lo manda como nota de
  * voz), asi que aca solo se normaliza el pedido y se acota el largo.
  */
-export function speakTool(_root, { texto, voice, rate } = {}) {
+export function speakTool(_root, { texto, voice, rate, pitch } = {}) {
   const value = String(texto ?? '').replace(/\s+/g, ' ').trim();
   if (!value) return 'Error: falta "texto".';
   const recortado = value.length > MAX_SPEAK_TEXT ? `${value.slice(0, MAX_SPEAK_TEXT - 1).trimEnd()}…` : value;
-  const opciones = [voice, rate].filter(Boolean).join(', ');
+  const opciones = [voice, rate, pitch].filter(Boolean).join(', ');
   return `Audio pedido${opciones ? ` (${opciones})` : ''}: "${recortado}". El cliente lo reproduce o lo envía como nota de voz.`;
 }
 

package/harness/packages/core/src/tools/schema.js

@@ -145,6 +145,7 @@ export const TOOL_DEFINITIONS = [
           texto: { type: 'string', description: 'Text to speak (long text is trimmed)' },
           voice: { type: 'string', description: 'Optional voice id, e.g. "es-AR-ElenaNeural"' },
           rate: { type: 'string', description: 'Optional speed, e.g. "+10%"' },
+          pitch: { type: 'string', description: 'Optional tone, e.g. "-10Hz"' },
         },
         required: ['texto'],
       },

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

@@ -1367,7 +1367,7 @@ async function loadFullToolResult(entry, message) {
 function speakControl(args) {
   const texto = String(args?.texto ?? '').trim();
   if (!texto) return null;
-  const btn = button('', () => reproducirVoz(texto, { voice: args?.voice, rate: args?.rate, label: 'voz' }).catch(() => {}), 'tool-audio-btn');
+  const btn = button('', () => reproducirVoz(texto, { voice: args?.voice, rate: args?.rate, pitch: args?.pitch, label: 'voz' }).catch(() => {}), 'tool-audio-btn');
   btn.append(icon('play', 13), el('span', '', 'escuchar'));
   return btn;
 }
@@ -2366,7 +2366,7 @@ function handleChatEvent(event, data, turn) {
     turn.lastTool = addToolCard(target, data.name, data.args, { callId: data.id, summary: data.summary });
     if (turn.live && data.name === 'speak') {
       const texto = String(data.args?.texto ?? '').trim();
-      if (texto) reproducirVoz(texto, { voice: data.args?.voice, rate: data.args?.rate, label: 'voz' }).catch(() => {});
+      if (texto) reproducirVoz(texto, { voice: data.args?.voice, rate: data.args?.rate, pitch: data.args?.pitch, label: 'voz' }).catch(() => {});
     }
     if (turn.live && data.name === 'preview_url' && data.args?.url) {
       setExplorerMode('preview');
@@ -4050,6 +4050,9 @@ const tgStatusEl = $('#tg-status');
 const vozEnabledEl = $('#voz-enabled');
 const vozVoiceEl = $('#voz-voice');
 const vozRateEl = $('#voz-rate');
+const vozRateValEl = $('#voz-rate-val');
+const vozPitchEl = $('#voz-pitch');
+const vozPitchValEl = $('#voz-pitch-val');
 const vozAnnStartEl = $('#voz-ann-start');
 const vozAnnToolsEl = $('#voz-ann-tools');
 const vozAnnEndEl = $('#voz-ann-end');
@@ -4645,6 +4648,7 @@ const voz = {
     enabled: false,
     voice: 'es-AR-ElenaNeural',
     rate: '+0%',
+    pitch: '+0Hz',
     announce: { start: true, tools: true, end: true, advice: true, answer: false, summary: false },
   },
 };
@@ -4689,13 +4693,53 @@ function ensurePlayer() {
   });
 }
 
+/** Convierte la velocidad guardada ("+20%") al valor del slider (20). */
+function rateToSlider(rate) {
+  const m = /^([+-]?)(\d+)%$/.exec(String(rate ?? '').trim());
+  return m ? (m[1] === '-' ? -1 : 1) * Number(m[2]) : 0;
+}
+
+/** Convierte el valor del slider (-20) a la velocidad guardada. */
+function sliderToRate(n) {
+  const v = Math.max(-100, Math.min(100, Math.round(Number(n) || 0)));
+  return v === 0 ? '+0%' : `${v > 0 ? '+' : '-'}${Math.abs(v)}%`;
+}
+
+/** Convierte el tono guardado ("-10Hz") al valor del slider (-10). */
+function pitchToSlider(pitch) {
+  const m = /^([+-]?)(\d+)Hz$/.exec(String(pitch ?? '').trim());
+  return m ? (m[1] === '-' ? -1 : 1) * Number(m[2]) : 0;
+}
+
+/** Convierte el valor del slider (-10) al tono guardado. */
+function sliderToPitch(n) {
+  const v = Math.max(-50, Math.min(50, Math.round(Number(n) || 0)));
+  return v === 0 ? '+0Hz' : `${v > 0 ? '+' : '-'}${Math.abs(v)}Hz`;
+}
+
+function etiquetaRate(n) {
+  const v = Math.round(Number(n) || 0);
+  return v === 0 ? 'normal' : `${v > 0 ? '+' : '−'}${Math.abs(v)}%`;
+}
+
+function etiquetaPitch(n) {
+  const v = Math.round(Number(n) || 0);
+  return v === 0 ? 'normal' : `${v > 0 ? '+' : '−'}${Math.abs(v)} Hz`;
+}
+
+/** Refresca la etiqueta numérica de los sliders de voz. */
+function renderVozSliders() {
+  if (vozRateValEl && vozRateEl) vozRateValEl.textContent = etiquetaRate(vozRateEl.value);
+  if (vozPitchValEl && vozPitchEl) vozPitchValEl.textContent = etiquetaPitch(vozPitchEl.value);
+}
+
 /** Encola un audio. La promesa se resuelve al terminar (o al detenerlo). */
-function enqueueSpeech({ texto, voice, rate, label = 'audio', maxAgeMs = 0 } = {}) {
+function enqueueSpeech({ texto, voice, rate, pitch, label = 'audio', maxAgeMs = 0 } = {}) {
   const frase = String(texto ?? '').trim();
   if (!frase) return Promise.resolve();
   ensurePlayer();
   return new Promise((resolve, reject) => {
-    ap.queue.push({ texto: frase, voice, rate, label, createdAt: Date.now(), maxAgeMs, resolve, reject });
+    ap.queue.push({ texto: frase, voice, rate, pitch, label, createdAt: Date.now(), maxAgeMs, resolve, reject });
     if (ap.current) renderAudio();
     else playNextAudio();
   });
@@ -4717,6 +4761,7 @@ function playNextAudio() {
     texto: item.texto,
     voice: item.voice ?? voz.settings.voice,
     rate: item.rate ?? voz.settings.rate,
+    pitch: item.pitch ?? voz.settings.pitch,
   });
   ap.audio.src = `/api/tts?${params}`;
   ap.audio.play().catch(() => {
@@ -4768,8 +4813,8 @@ function renderAudio() {
 }
 
 /** Reproduce una frase contra el endpoint de sintesis del server. */
-function reproducirVoz(frase, { voice, rate, label, maxAgeMs } = {}) {
-  return enqueueSpeech({ texto: frase, voice, rate, label, maxAgeMs });
+function reproducirVoz(frase, { voice, rate, pitch, label, maxAgeMs } = {}) {
+  return enqueueSpeech({ texto: frase, voice, rate, pitch, label, maxAgeMs });
 }
 
 /**
@@ -4824,6 +4869,7 @@ async function aplicarVoz(data) {
     enabled: data.enabled === true,
     voice: data.voice || 'es-AR-ElenaNeural',
     rate: data.rate || '+0%',
+    pitch: data.pitch || '+0Hz',
     announce: {
       start: data.announce?.start !== false,
       tools: data.announce?.tools !== false,
@@ -4844,7 +4890,9 @@ async function aplicarVoz(data) {
     }
     vozVoiceEl.value = voz.settings.voice;
   }
-  if (vozRateEl) vozRateEl.value = voz.settings.rate;
+  if (vozRateEl) vozRateEl.value = rateToSlider(voz.settings.rate);
+  if (vozPitchEl) vozPitchEl.value = pitchToSlider(voz.settings.pitch);
+  renderVozSliders();
   if (vozAnnStartEl) vozAnnStartEl.checked = voz.settings.announce.start;
   if (vozAnnToolsEl) vozAnnToolsEl.checked = voz.settings.announce.tools;
   if (vozAnnEndEl) vozAnnEndEl.checked = voz.settings.announce.end;
@@ -4869,7 +4917,8 @@ async function submitVoz() {
   const body = {
     enabled: vozEnabledEl?.checked === true,
     voice: vozVoiceEl?.value,
-    rate: vozRateEl?.value,
+    rate: sliderToRate(vozRateEl?.value),
+    pitch: sliderToPitch(vozPitchEl?.value),
     announce: {
       start: vozAnnStartEl?.checked !== false,
       tools: vozAnnToolsEl?.checked !== false,
@@ -5043,10 +5092,15 @@ trTestBtn?.addEventListener('click', toggleTrTest);
 
 async function testVoz() {
   setStatus('#voz-msg', 'sintetizando…');
+  const trato = ($('#perfil-address')?.value || '').trim();
+  const frase = trato
+    ? `${trato}, esta sería la voz predeterminada para mí`
+    : 'Esta sería la voz predeterminada para mí';
   try {
-    await reproducirVoz('Hola!, soy tu agente de IA,  y así es la voz con la que cuento lo que estoy haciendo. ¿Qué te parece?', {
+    await reproducirVoz(frase, {
       voice: vozVoiceEl?.value,
-      rate: vozRateEl?.value,
+      rate: sliderToRate(vozRateEl?.value),
+      pitch: sliderToPitch(vozPitchEl?.value),
     });
     setStatus('#voz-msg', 'sonó', 'ok');
   } catch (error) {
@@ -5416,6 +5470,8 @@ if (mcpListEl) {
   $('#tg-test')?.addEventListener('click', testChannel);
 $('#voz-save')?.addEventListener('click', submitVoz);
 $('#voz-test')?.addEventListener('click', testVoz);
+vozRateEl?.addEventListener('input', renderVozSliders);
+vozPitchEl?.addEventListener('input', renderVozSliders);
 $('#asesor-save')?.addEventListener('click', submitAsesor);
 $('#asesor-test')?.addEventListener('click', testAsesor);
   $('#mcp-close').addEventListener('click', closeMcpForm);

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

@@ -37,7 +37,7 @@
   </head>
   <body>
     <header class="topbar">
-      <div class="brand"><span class="logo"><img src="/icons/logo.png" alt="Tamnora" /></span> <span id="topbar-section" class="topbar-section">chat</span> <span class="ver">v0.18.0</span></div>
+      <div class="brand"><span class="logo"><img src="/icons/logo.png" alt="Tamnora" /></span> <span id="topbar-section" class="topbar-section">chat</span> <span class="ver">v0.19.0</span></div>
       <nav class="tabs">
         <button class="tab active" data-tab="chat">chat</button>
         <button class="tab" data-tab="providers">proveedores</button>
@@ -736,11 +736,16 @@
             <select id="voz-voice" title="voz del catálogo de Edge"></select>
           </label>
           <label class="field"><span>velocidad</span>
-            <select id="voz-rate" title="velocidad del habla">
-              <option value="-20%">más lenta</option>
-              <option value="+0%">normal</option>
-              <option value="+20%">más rápida</option>
-            </select>
+            <div class="voz-range">
+              <input id="voz-rate" type="range" min="-100" max="100" step="5" value="0" title="velocidad del habla (%)" />
+              <output id="voz-rate-val" for="voz-rate">normal</output>
+            </div>
+          </label>
+          <label class="field"><span>tono</span>
+            <div class="voz-range">
+              <input id="voz-pitch" type="range" min="-50" max="50" step="5" value="0" title="tono de la voz (Hz)" />
+              <output id="voz-pitch-val" for="voz-pitch">normal</output>
+            </div>
           </label>
           <div class="voz-announce">
             <span class="muted">qué cuenta:</span>

package/harness/packages/server/public/styles.css

@@ -822,7 +822,7 @@ body.resizing * { cursor: col-resize !important; }
 }
 .perm-card .perm-head { display: flex; gap: 7px; align-items: center; color: var(--warn); font-weight: 700; }
 .perm-card .perm-args { color: var(--muted); margin: 5px 0 9px; white-space: pre-wrap; word-break: break-word; max-height: 7.5em; overflow: auto; }
-.perm-card .perm-actions { display: flex; align-items: center; gap: 8px; }
+.perm-card .perm-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
 .perm-card .spacer { flex: 1; }
 .perm-card.approved { border-color: var(--ok); background: rgba(63, 185, 80, 0.06); }
 .perm-card.approved .perm-head { color: var(--ok); }
@@ -1320,6 +1320,9 @@ pre.code code { background: none; border: 0; padding: 0; font-size: 0.92em; }
 
 /* ajustes: voz (TTS) -------------------------------------------------------- */
 .voz-announce { display: flex; align-items: center; gap: 14px; flex-wrap: wrap; border-top: 1px solid var(--border); border-bottom: 1px solid var(--border); padding: 8px 0; }
+.voz-range { display: flex; align-items: center; gap: 12px; }
+.voz-range input[type="range"] { flex: 1; max-width: 360px; accent-color: var(--accent); cursor: pointer; }
+.voz-range output { min-width: 62px; text-align: right; font: 600 12px var(--serif); color: var(--fg); }
 
 /* ajustes: pestañas internas ---------------------------------------------- */
 #view-ajustes.active { display: block; overflow-y: auto; }
@@ -1888,6 +1891,27 @@ dialog.file-modal.preview-maximized {
   .session-tab {
     max-width: 160px;
   }
+  /* Permiso: en un movil la fila de acciones aplastaba "requiere aprobación"
+     a una letra por linea y los botones se salian. El veredicto pasa a su
+     propia linea y los botones se reparten el ancho. */
+  .perm-card .perm-head {
+    flex-wrap: wrap;
+  }
+  .perm-card .perm-actions .muted {
+    flex: 1 0 100%;
+  }
+  .perm-card .perm-actions .spacer {
+    display: none;
+  }
+  .perm-card .perm-actions .btn {
+    flex: 1 1 auto;
+    min-height: 40px;
+  }
+  /* Preview: el input de la URL se aplastaba contra los botones y no se leia.
+     Le damos la fila entera y los controles caen abajo. */
+  .xp-bar #preview-url {
+    flex: 1 1 100%;
+  }
 }
 
 @media (max-width: 480px) {

package/harness/packages/server/src/lib/channels/telegram.js

@@ -252,12 +252,16 @@ export function startTelegramChannel(
    * (`sendVoice`, aparece como nota de voz); sin ffmpeg cae a audio MP3.
    * Un fallo del TTS no debe romper el run: se loguea y sigue.
    */
-  async function enviarNotaDeVoz(chatId, texto, { voice, rate } = {}) {
+  async function enviarNotaDeVoz(chatId, texto, { voice, rate, pitch } = {}) {
     const tts = resolveTts(ctx.app);
     const frase = String(texto ?? '').trim().slice(0, MAX_TEXTO);
     if (!frase) return;
     try {
-      const mp3 = await sintetizar(frase, { voice: voice || tts.voice, rate: rate || tts.rate });
+      const mp3 = await sintetizar(frase, {
+        voice: voice || tts.voice,
+        rate: rate || tts.rate,
+        pitch: pitch || tts.pitch,
+      });
       const ogg = await mp3AOgg(mp3);
       const form = new FormData();
       form.append('chat_id', chatId);
@@ -527,7 +531,7 @@ export function startTelegramChannel(
           } else if (event.type === 'tool_call') {
             activity = `${event.name} ${toolCallPayload(event).summary}`.trim();
             if (event.name === 'speak') {
-              enviarNotaDeVoz(chatId, event.args?.texto, { voice: event.args?.voice, rate: event.args?.rate });
+              enviarNotaDeVoz(chatId, event.args?.texto, { voice: event.args?.voice, rate: event.args?.rate, pitch: event.args?.pitch });
             }
           } else if (event.type === 'tool_result') {
             activity = `${event.name} ✓`;
@@ -888,6 +892,7 @@ export function startTelegramChannel(
           enviarNotaDeVoz(linked, event.data?.args?.texto, {
             voice: event.data?.args?.voice,
             rate: event.data?.args?.rate,
+            pitch: event.data?.args?.pitch,
           });
         }
         return;

package/harness/packages/server/src/lib/ttsSettings.js

@@ -8,6 +8,7 @@ export const DEFAULT_TTS = {
   enabled: false,
   voice: VOZ_POR_DEFECTO,
   rate: '+0%',
+  pitch: '+0Hz',
   announce: { start: true, tools: true, end: true, advice: true, answer: false, summary: false },
 };
 
@@ -23,6 +24,7 @@ export function resolveTts(app) {
     enabled: saved.enabled === true,
     voice: typeof saved.voice === 'string' && saved.voice ? saved.voice : DEFAULT_TTS.voice,
     rate: typeof saved.rate === 'string' && saved.rate ? saved.rate : DEFAULT_TTS.rate,
+    pitch: typeof saved.pitch === 'string' && saved.pitch ? saved.pitch : DEFAULT_TTS.pitch,
   };
 }
 
@@ -40,3 +42,12 @@ export function sanearRate(value, fallback = '+0%') {
   if (numero === 0) return '+0%';
   return `${match[1] === '-' ? '-' : '+'}${numero}%`;
 }
+
+/** Sanitiza un tono: "+10Hz", "-20Hz", "30Hz" -> "+30Hz". */
+export function sanearPitch(value, fallback = '+0Hz') {
+  const match = /^([+-]?)(\d+)Hz$/.exec(String(value ?? '').trim());
+  if (!match) return fallback;
+  const numero = Math.min(50, Number(match[2]));
+  if (numero === 0) return '+0Hz';
+  return `${match[1] === '-' ? '-' : '+'}${numero}Hz`;
+}

package/harness/packages/server/src/routes/tts.js

@@ -5,7 +5,7 @@
 import { sintetizar, listarVoces, MAX_TEXTO } from '../lib/core.js';
 import { readApp, writeApp } from '../lib/core.js';
 import { ffmpegDisponible } from '../lib/ffmpeg.js';
-import { resolveTts, sanearVoz, sanearRate } from '../lib/ttsSettings.js';
+import { resolveTts, sanearVoz, sanearRate, sanearPitch } from '../lib/ttsSettings.js';
 import { sendJson, sendError, readJson } from '../lib/http.js';
 
 const cacheVoces = { at: 0, data: null, filtro: 'es-' };
@@ -37,6 +37,7 @@ export function registerTts(route, ctx) {
     if ('enabled' in body) next.enabled = body.enabled === true;
     if ('voice' in body) next.voice = sanearVoz(body.voice, actual.voice);
     if ('rate' in body) next.rate = sanearRate(body.rate, actual.rate);
+    if ('pitch' in body) next.pitch = sanearPitch(body.pitch, actual.pitch);
     if (body.announce && typeof body.announce === 'object') {
       const announce = { ...actual.announce };
       for (const key of ['start', 'tools', 'end', 'advice', 'answer', 'summary']) {
@@ -68,8 +69,9 @@ export function registerTts(route, ctx) {
     if (!texto) return sendError(res, 400, 'Falta "texto".');
     const voz = sanearVoz(query.get('voice'), config.voice);
     const rate = sanearRate(query.get('rate'), config.rate);
+    const pitch = sanearPitch(query.get('pitch'), config.pitch);
     try {
-      const mp3 = await sintetizar(texto, { voice: voz, rate });
+      const mp3 = await sintetizar(texto, { voice: voz, rate, pitch });
       res.writeHead(200, {
         'Content-Type': 'audio/mpeg',
         'Content-Length': mp3.length,

package/harness/packages/server/test/tts.test.js

@@ -75,6 +75,8 @@ test('los ajustes de voz exponen defaults y sanitizan lo guardado', async () =>
     const initial = await (await fetch(`${base}/api/tts/settings`)).json();
     assert.equal(initial.enabled, false);
     assert.equal(initial.voice, 'es-AR-ElenaNeural');
+    assert.equal(initial.rate, '+0%');
+    assert.equal(initial.pitch, '+0Hz');
     assert.equal(initial.announce.start, true);
     assert.equal(initial.announce.tools, true);
     assert.equal(initial.announce.end, true);
@@ -83,17 +85,19 @@ test('los ajustes de voz exponen defaults y sanitizan lo guardado', async () =>
     const put = await fetch(`${base}/api/tts/settings`, {
       method: 'PUT',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({ enabled: true, voice: '<script>', rate: '150%', announce: { summary: true } }),
+      body: JSON.stringify({ enabled: true, voice: '<script>', rate: '150%', pitch: '999Hz', announce: { summary: true } }),
     });
     const saved = await put.json();
     assert.equal(saved.enabled, true);
     assert.equal(saved.voice, 'es-AR-ElenaNeural');
     assert.equal(saved.rate, '+100%');
+    assert.equal(saved.pitch, '+50Hz');
     assert.equal(saved.announce.summary, true);
 
     const reread = await (await fetch(`${base}/api/tts/settings`)).json();
     assert.equal(reread.enabled, true);
     assert.equal(reread.rate, '+100%');
+    assert.equal(reread.pitch, '+50Hz');
     assert.equal(reread.announce.summary, true);
   } finally {
     global.WebSocket = original;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danieltmn/tamnora",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Harness local para IAs: agente CLI-first con TUI, consola web y evaluacion. Node puro, sin dependencias.",
   "type": "module",
   "packageManager": "pnpm@11.25.0",