boosterarena-mcp 0.3.0 → 0.3.2

package/LEEME.md

@@ -77,6 +77,10 @@ ninguna de las dos cosas, pero se las traga sin distinguirlas de las que subiste
 > devuelve la misma URL y ocupa una sola vez. Para quien repite la misma ilustración en cientos
 > de clases, eso no es un detalle.
 
+**Voz de Booster** — `generar_voz` crea el audio de un texto con una de las 10 voces de Booster
+(las mismas del editor, iguales en cualquier máquina) y lo pone en el slide o en una capa, listo
+para `sonar`. Es del plan Pro y gasta letras de la cuota mensual de la cuenta.
+
 **Encargos** — quitar el fondo de una imagen, el Sombrero Mágico y el Transformador se resuelven
 sin abrir el navegador.
 

package/dist/nucleo.mjs

@@ -1703,6 +1703,12 @@ function conLoDelMcp(lista2, fn) {
   fondo.url = str("Una imagen ya SUBIDA (con `subir_imagen`), https://. Usa esto, `busca` o `color`: uno solo.");
   fondo.capa = str("El `ref` o el nombre de una CAPA para ponerle el fondo a ella en vez de al slide. Cada capa puede llevar el suyo.");
   props("nueva_capa").fondo = str("Fondo propio de la capa: la URL https:// de una imagen ya subida o un color en hex. Sin esto, la capa deja ver el slide de debajo.");
+  for (const t of lista2) {
+    const p = t.function.parameters.properties;
+    if (!t.function.name.startsWith("poner_") || !p.x || t.function.name === "poner_texto_plantilla") continue;
+    p.x = num("Borde IZQUIERDO, en % del ancho del slide. Puede ser NEGATIVO o pasar de 100 para que nazca FUERA del slide y entre con una trayectoria.");
+    p.y = num("Borde SUPERIOR, en % del alto del slide. Tambi\xE9n puede quedar fuera, como `x`.");
+  }
   const recolocar = props("recolocar");
   recolocar.x = num("Nuevo borde izquierdo en %. Puede ser NEGATIVO o pasar de 100 para dejar el objeto FUERA del slide y que entre con una trayectoria (el monstruo que entra solo: x = -50).");
   recolocar.y = num("Nuevo borde superior en %. Tambi\xE9n puede quedar fuera del slide, como `x`.");
@@ -3111,6 +3117,25 @@ function armarAccion(b, a, el) {
   }
 }
 function ejecutar(b, nombre, args, fab) {
+  const antes = b.creados.length;
+  const dijo = ejecutarUna(b, nombre, args, fab);
+  return b.estricto && !b.fallo ? dijo + dejarFuera(b, nombre, args, antes) : dijo;
+}
+var enElAreaDeTrabajo = (v, lado) => Math.max(-lado - 30, Math.min(130, v));
+function dejarFuera(b, nombre, args, antes) {
+  if (!nombre.startsWith("poner_") || ["poner_fondo", "poner_arena", "poner_audio", "poner_texto_plantilla"].includes(nombre)) return "";
+  if (b.creados.length !== antes + 1) return "";
+  const el = buscarEl(b, b.creados[antes]);
+  if (!el) return "";
+  const x = typeof args.x === "number" && Number.isFinite(args.x) ? args.x : null;
+  const y = typeof args.y === "number" && Number.isFinite(args.y) ? args.y : null;
+  const sale = (v, lado) => v !== null && (v < 0 || v + lado > 100);
+  if (!sale(x, el.w) && !sale(y, el.h)) return "";
+  if (sale(x, el.w)) el.x = +enElAreaDeTrabajo(x, el.w).toFixed(2);
+  if (sale(y, el.h)) el.y = +enElAreaDeTrabajo(y, el.h).toFixed(2);
+  return " Qued\xF3 FUERA del slide (o asomando): no se ve entero hasta que una trayectoria lo meta.";
+}
+function ejecutarUna(b, nombre, args, fab) {
   switch (nombre) {
     // ── Poner cosas ──────────────────────────────────────────────────────────
     case "poner_texto": {
@@ -3314,8 +3339,8 @@ El ref "${refBase}" es el rengl\xF3n grande; cada uno es tambi\xE9n "${refBase}_
         name: txt(args.nombre) || "Audio",
         vol: AUDIO_VOL_INICIAL
       };
-      plantar(b, el, args.ref, void 0);
-      b.bitacora.push(`\u{1F50A} Audio \xAB${el.name}\xBB`);
+      const { dentroDe } = plantar(b, el, args.ref, args.capa);
+      b.bitacora.push(`\u{1F50A} Audio \xAB${el.name}\xBB${dentroDe ? ` en la capa \xAB${dentroDe}\xBB` : ""}`);
       return `Puesto el audio "${el.name}" (id ${el.id}). Est\xE1 FUERA del slide, como un mando: para que suene, progr\xE1malo con \`programar\` (al hacer clic \u2192 reproducir audio) o ponlo al iniciar el slide.`;
     }
     case "poner_figura": {
@@ -3640,9 +3665,8 @@ Pide \`describir("${el.widget}")\` para ver la forma exacta y vuelve a intentarl
         el.w = w;
       }
       if (num3(args.alto, 0) > 0) el.h = pct(args.alto, el.h);
-      const fuera = (v, lado) => Math.max(-lado - 30, Math.min(130, v));
-      if (typeof args.x === "number") el.x = b.estricto ? +fuera(args.x, el.w).toFixed(2) : pct(args.x, el.x);
-      if (typeof args.y === "number") el.y = b.estricto ? +fuera(args.y, el.h).toFixed(2) : pct(args.y, el.y);
+      if (typeof args.x === "number") el.x = b.estricto ? +enElAreaDeTrabajo(args.x, el.w).toFixed(2) : pct(args.x, el.x);
+      if (typeof args.y === "number") el.y = b.estricto ? +enElAreaDeTrabajo(args.y, el.h).toFixed(2) : pct(args.y, el.y);
       const afuera = b.estricto && (el.x < 0 || el.y < 0 || el.x + el.w > 100 || el.y + el.h > 100);
       if (!afuera) encajar(el);
       b.tocados.push(el.id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boosterarena-mcp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "El MCP de Booster: tu agente crea y edita presentaciones dentro de boosterarena.com",
   "keywords": [
     "mcp",

package/servidor.mjs

@@ -32,7 +32,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createRequire } from 'node:module';
 import { tokenDeAcceso } from './sesion.mjs';
 import { abrir, carpetas, crear, equipos, guardar, listar, resolverDestino } from './proyectos.mjs';
-import { subirArchivo } from './subidas.mjs';
+import { subirArchivo, subirBytes } from './subidas.mjs';
 import { rematarEncargo } from './encargos.mjs';
 
 // La versión se lee del package.json: escrita a mano se queda vieja en silencio, y es lo que
@@ -228,6 +228,31 @@ const HERRAMIENTAS_PROYECTO = [
       required: ['ruta'],
     },
   },
+  {
+    name: 'generar_voz',
+    description: 'Genera un audio con la VOZ DE BOOSTER (siempre la misma en cualquier máquina, no la del '
+      + 'navegador) y lo PONE en el slide o en una capa, listo para sonar. Es lo que hace el editor con '
+      + '«Leer en voz alta 🔊». Después prográmalo con `programar` y accion `sonar` (destino = su ref): al '
+      + 'tocar algo, en un clickStep, o con evento layerShown para que suene al abrirse la capa. Prefiérelo '
+      + 'a `leerEnVoz`, que depende de las voces del equipo donde se proyecte. ⚠️ Es del plan Pro y gasta '
+      + 'letras de la cuota mensual de la cuenta (2.000 por audio, 50.000 al mes).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        texto: { type: 'string', description: 'Lo que dice. En inglés. Hasta 2.000 letras.' },
+        voz: {
+          type: 'string',
+          description: 'La voz. EE. UU.: af_heart (mujer, la mejor), af_bella, af_nicole, am_michael (hombre), '
+            + 'am_fenrir, am_puck. Reino Unido: bf_emma (mujer), bf_isabella, bm_george (hombre), bm_lewis. '
+            + 'Sin esto, af_heart.',
+        },
+        ref: { type: 'string', description: 'Etiqueta corta para programarlo después en esta tanda. Ej: "voz_cat".' },
+        nombre: { type: 'string', description: 'Cómo se llama el chip del audio en el editor. Sin esto, el principio del texto.' },
+        capa: { type: 'string', description: 'El `ref` o el nombre de una capa para ponerlo DENTRO de ella. Vacío = en el slide.' },
+      },
+      required: ['texto'],
+    },
+  },
   {
     name: 'transformar_en',
     description: 'Hace que un objeto se CONVIERTA en otras imágenes al hacerle clic en el ▶ Player '
@@ -399,6 +424,36 @@ async function llamar(nombre, args = {}) {
       + `Dónde: ${nombre === 'crear_proyecto' ? donde : (p.team_id ? `equipo ${p.team_id}` : 'tu espacio Personal')} — se abre desde la galería de https://boosterarena.com\n`
       + `Plan de la cuenta: ${yo.plan}. ${yo.borrador.doc.length} escena(s).\n\n${resumenDelDoc(yo.borrador.doc)}`;
   }
+  // La voz de Booster: la MISMA función que usa el editor (`/api/voz`, que pone el candado Pro y
+  // descuenta las letras en el servidor), luego se sube el MP3 y se planta como un audio normal.
+  if (nombre === 'generar_voz') {
+    exigeProyecto();
+    const texto = String(args.texto ?? '').trim();
+    if (!texto) throw new Error('Falta el `texto`.');
+    if (texto.length > 2000) throw new Error(`El texto tiene ${texto.length} letras y el máximo son 2.000. Pártelo en dos audios.`);
+    const t = await token();
+    const r = await fetch('https://boosterarena.com/api/voz', {
+      method: 'POST',
+      headers: { Authorization: `Bearer ${t}`, 'Content-Type': 'application/json' },
+      body: JSON.stringify({ texto, voz: String(args.voz ?? '').trim() || 'af_heart' }),
+    });
+    if (!r.ok) {
+      const info = await r.json().catch(() => ({}));
+      const m = info.error;
+      throw new Error(m === 'PRO_REQUIRED' ? 'La voz de Booster es del plan Pro y esta cuenta no lo tiene. Díselo a tu usuario: se activa desde boosterarena.com. Mientras tanto, `subir_audio` con un audio propio.'
+        : m === 'MONTHLY_LIMIT' ? 'Se acabaron las letras de voz de este mes en esta cuenta. Mientras tanto, `subir_audio` con un audio propio.'
+          : m === 'VOZ_DESCONOCIDA' ? `No existe la voz "${info.voz}". Usa una de la lista de \`voz\`.`
+            : m === 'NO_AUTH' ? 'La sesión ya no vale. Corre `node mcp/sesion.mjs entrar`.'
+              : `El servidor de voz contestó ${r.status}: ${info.detail ?? m ?? 'sin detalle'}.`);
+    }
+    const restantes = Number(r.headers.get('X-Voz-Restantes') ?? -1);
+    const url = await subirBytes(t, Buffer.from(await r.arrayBuffer()), 'mp3');
+    yo.borrador.fallo = false;
+    const nombreChip = String(args.nombre ?? '').trim() || texto.slice(0, 28).trim();
+    const dijo = nucleo.ejecutar(yo.borrador, 'poner_audio', { url, ref: args.ref, nombre: nombreChip, capa: args.capa }, fabricas());
+    if (yo.borrador.fallo) throw new Error(dijo);
+    return `Voz generada y puesta. ${dijo}\nURL: ${url}${restantes >= 0 ? `\nLetras de voz que le quedan este mes a la cuenta: ${restantes}.` : ''}`;
+  }
   if (nombre === 'subir_imagen' || nombre === 'subir_audio') {
     const t = await token();
     const r = await subirArchivo(t, args.ruta, nombre === 'subir_imagen' ? 'imagen' : 'audio');

package/subidas.mjs

@@ -3,8 +3,8 @@
 //
 //  Es la pieza que le faltaba a la fábrica de Planificatron. Ellos generan FUERA de Booster
 //  —las imágenes con Flux en su propia gráfica, la voz con edge-tts— y el resultado entra por
-//  aquí. Booster no genera ninguna de las dos cosas (se retiró por costo, y el audio nunca se
-//  generó) y esto no lo cambia: la fábrica no le añade capacidades a Booster, le añade un
+//  aquí. Booster no genera imágenes (se retiró por costo); la voz sí, desde el 2026-09-21, con
+//  `generar_voz`, que también sube por aquí (`subirBytes`). La fábrica no le añade capacidades a Booster, le añade un
 //  PROVEEDOR DE ARCHIVOS. Un MP3 de un TTS y un MP3 que subió un maestro son el mismo elemento
 //  con una URL de R2, y el documento no puede notar la diferencia.
 //
@@ -56,18 +56,7 @@ export async function subirArchivo(token, ruta, familia) {
   }
 
   const cuerpo = await readFile(ruta);
-  const r = await fetch(SUBIDA, {
-    method: 'POST',
-    headers: { Authorization: `Bearer ${token}`, 'Content-Type': tipo, 'X-Ext': ext },
-    body: cuerpo,
-  });
-  if (!r.ok) {
-    let detalle = String(r.status);
-    try { detalle = (await r.json())?.detail || detalle; } catch { /* respuesta no-JSON */ }
-    if (r.status === 401) throw new Error('La sesión ya no vale. Corre `node mcp/sesion.mjs entrar`.');
-    throw new Error(`No se pudo subir: ${detalle}`);
-  }
-  const { url } = await r.json();
+  const url = await subirBytes(token, cuerpo, ext);
 
   const kb = Math.round(info.size / 1024);
   const pesado = familia === 'imagen' && ['png', 'jpg', 'jpeg'].includes(ext) && info.size > AVISO_PESO;
@@ -82,3 +71,20 @@ export async function subirArchivo(token, ruta, familia) {
       : '',
   };
 }
+
+/** Sube unos bytes ya en memoria (la voz recién generada) y devuelve su URL. Mismo camino que
+ *  `subirArchivo`: `functions/api/upload.ts`, con el token del maestro. */
+export async function subirBytes(token, cuerpo, ext) {
+  const r = await fetch(SUBIDA, {
+    method: 'POST',
+    headers: { Authorization: `Bearer ${token}`, 'Content-Type': TIPOS[ext] ?? 'application/octet-stream', 'X-Ext': ext },
+    body: cuerpo,
+  });
+  if (!r.ok) {
+    let detalle = String(r.status);
+    try { detalle = (await r.json())?.detail || detalle; } catch { /* respuesta no-JSON */ }
+    if (r.status === 401) throw new Error('La sesión ya no vale. Corre `node mcp/sesion.mjs entrar`.');
+    throw new Error(`No se pudo subir: ${detalle}`);
+  }
+  return (await r.json()).url;
+}