boosterarena-mcp 0.3.2 → 0.3.4

package/LEEME.md

@@ -50,7 +50,9 @@ habla con Booster con **tu** sesión.
 ## Qué puede hacer
 
 **Proyectos** — `listar_proyectos`, `abrir_proyecto`, `crear_proyecto`, `guardar_proyecto`,
-`ver_slide`. Nada se sube hasta que se llama a `guardar_proyecto`: el agente trabaja sobre un
+`ver_slide`, `ir_a_slide` (volver a un slide ya hecho para corregirlo; `abrir_proyecto` también acepta
+`escena` y `slide`) y `tanda` (muchas órdenes en una sola llamada: es la forma barata de armar un
+slide). Nada se sube hasta que se llama a `guardar_proyecto`: el agente trabaja sobre un
 borrador y tú decides cuándo se publica.
 
 **Contenido** — poner texto, imágenes, figuras y dibujos de la biblioteca (más de 3.000

package/dist/nucleo.mjs

@@ -1587,7 +1587,7 @@ function construirCatalogo(opts) {
         segundos: num('Solo con evento "time": a los cu\xE1ntos segundos.'),
         paso: num('Solo con evento "clickStep": en qu\xE9 n\xFAmero de clic (1, 2, 3...).'),
         accion: str(
-          "QU\xC9 pasa. abrirCapa = muestra una capa \xB7 irAEscena = salta a otra escena \xB7 irASlide = salta a un slide \xB7 cerrarCapa = cierra la capa abierta \xB7 leerEnVoz = lo lee el navegador en voz alta \xB7 abrirEnlace = abre una URL \xB7 ocultar = el objeto desaparece con una nube de humo \xB7 moverPorTrayectoria = el objeto RECORRE un camino dibujado \xB7 sonar = suena un audio que ya est\xE1 puesto en el slide o en una capa (para \xABque suene al abrirse la capa\xBB: objetivo = ese audio, evento = layerShown, destino = ese mismo audio; para \xABal tocar X\xBB: objetivo = X, destino = el audio) \xB7 reiniciarSecuencia = devuelve el slide a como empez\xF3 \xB7 quitar = le borra todo lo que tuviera programado.",
+          "QU\xC9 pasa. abrirCapa = muestra una capa \xB7 irAEscena = salta a otra escena \xB7 irASlide = salta a un slide \xB7 cerrarCapa = cierra la capa abierta \xB7 leerEnVoz = lo lee el navegador en voz alta \xB7 abrirEnlace = abre una URL \xB7 ocultar = el objeto desaparece con una nube de humo \xB7 moverPorTrayectoria = el objeto RECORRE un camino dibujado \xB7 sonar = suena un audio que ya est\xE1 puesto en el slide o en una capa (para \xABque suene al abrirse la capa\xBB: objetivo = ese audio, evento = layerShown, destino = ese mismo audio; para \xABal tocar X\xBB: objetivo = X, destino = el audio) \xB7 pausarAudio / detenerAudio = pausa o detiene (vuelve al principio) ese audio; destino = el audio, vac\xEDo = el que est\xE9 sonando \xB7 reiniciarSecuencia = devuelve el slide a como empez\xF3 \xB7 quitar = le borra todo lo que tuviera programado.",
           {
             enum: [
               "abrirCapa",
@@ -1599,6 +1599,8 @@ function construirCatalogo(opts) {
               "ocultar",
               "moverPorTrayectoria",
               "sonar",
+              "pausarAudio",
+              "detenerAudio",
               "reiniciarSecuencia",
               "quitar"
             ]
@@ -1694,7 +1696,10 @@ function construirCatalogo(opts) {
 var PUNTO = obj({ x: num("En % del ancho del slide."), y: num("En % del alto del slide.") }, ["x", "y"]);
 function conLoDelMcp(lista2, fn) {
   const props = (nombre) => (lista2.find((t) => t.function.name === nombre)?.function.parameters).properties;
+  const PEDIDO = str('Solo para `borrar` o accion "quitar": lo que te escribi\xF3 la persona pidi\xE9ndolo, COPIADO TAL CUAL (ej: "quita la programaci\xF3n del caldero 3"). Sin una petici\xF3n suya de borrar o quitar, no se borra nada. Nunca lo inventes ni lo escribas t\xFA.');
+  props("borrar").pedido_del_maestro = PEDIDO;
   const programar = props("programar");
+  programar.pedido_del_maestro = PEDIDO;
   programar.trayectoria = str('Con "moverPorTrayectoria" o el evento "trayectoriaTerminada": el NOMBRE del camino ("Trayectoria 1", "a la boca"). Se busca por nombre EXACTO. Un objeto puede tener varios: dale a cada uno el suyo y as\xED cada `clickStep` o cada `trayectoriaTerminada` apunta al que toca. Si el camino no existe todav\xEDa, hace falta `hasta` o `puntos` para trazarlo.');
   programar.hasta = { ...PUNTO, description: 'Solo con "moverPorTrayectoria": a D\xD3NDE llega el CENTRO del objeto, en % del slide. El camino se traza en recta desde donde est\xE9 el objeto \u2014 o, en un `clickStep` 2, 3\u2026, desde donde lo dej\xF3 el paso anterior. Si ya existe un camino con ese `trayectoria`, se retraza.' };
   programar.puntos = { type: "array", items: PUNTO, description: 'Solo con "moverPorTrayectoria": puntos por los que PASA el centro del objeto, en % del slide, para una curva o un recorrido con escalas. El \xFAltimo es la llegada (o, si mandas tambi\xE9n `hasta`, `hasta` va detr\xE1s).' };
@@ -1703,6 +1708,10 @@ 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 (p.capa === CAPA) p.capa = str("Vac\xEDo = en el slide. Para ponerlo DENTRO de una capa: su `ref`, su id (el que ense\xF1a `ver_slide`) o su nombre exacto. La capa tiene que existir en el slide donde est\xE1s trabajando (cr\xE9ala con `nueva_capa`; para una de otro slide, ve antes con `ir_a_slide`): si no, es error.");
+  }
   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;
@@ -1712,6 +1721,8 @@ function conLoDelMcp(lista2, fn) {
   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`.");
+  props("poner_figura").alto = num("Alto en % del alto del slide, independiente del ancho. Para los paneles de capa: una elipse blanca de w 82 \xD7 alto 77, o un rect de 83 \xD7 71. Sin esto, la figura guarda su proporci\xF3n de siempre.");
+  recolocar.alto = num("Nuevo alto en %: para cajas (Revelador, Ciclo, QR\u2026), zonas calientes y FIGURAS, independiente del ancho.");
   props("cambiar_estilo").gris_al_tocar = bool("true = en el \u25B6 Player, al tocar el objeto se vuelve gris (y otro toque le devuelve el color). Le dice al coach qu\xE9 botones ya us\xF3. false lo quita.");
   const i = lista2.findIndex((t) => t.function.name === "poner_emoji");
   lista2.splice(i + 1, 0, fn(
@@ -2056,6 +2067,78 @@ var ESQUEMAS_BOOSTERS = {
       ]
     }
   },
+  magicshow: {
+    donde: "wcfg.ext",
+    cfgSchema: {
+      campos: {
+        title: texto("T\xEDtulo en el tel\xF3n: \xABWhat is missing?\xBB.", { max: 40 }),
+        items: lista("Las cartas del show. Cada una lleva imagen, palabra o las dos.", objeto("Una carta.", {
+          id: texto("Identificador propio de la carta. Si lo omites, lo pone el editor."),
+          src: imagen("La imagen de la carta."),
+          text: texto("La palabra de la carta.", { max: 30 }),
+          anim: bool2("`src` es una animaci\xF3n Lottie (la carta se mueve sola) y no una imagen.")
+        }), { min: 2, max: 12, obligatorio: true }),
+        icon: objeto("El bot\xF3n m\xE1gico que se toca en clase. Sin \xE9l sale una varita.", {
+          kind: opcion("Figura (imagen) o animaci\xF3n (Lottie).", ["image", "lottie"], { obligatorio: true }),
+          src: texto("URL de la figura o del Lottie.", { obligatorio: true })
+        }),
+        names: bool2("Mostrar la palabra debajo de la imagen."),
+        shuffle: bool2("Barajar las cartas en cada truco."),
+        sound: bool2("Sonido del show.")
+      }
+    },
+    ejemplo: {
+      title: "What is missing?",
+      names: true,
+      shuffle: true,
+      sound: true,
+      items: [{ text: "apple" }, { text: "banana" }, { text: "orange" }, { text: "grapes" }, { text: "pear" }]
+    }
+  },
+  pizarra: {
+    donde: "wcfg.ext",
+    cfgSchema: {
+      campos: {
+        fondo: opcion(
+          "El fondo de la pizarra. \xABvidrio\xBB = cristal esmerilado sobre el slide; \xABtransparente\xBB = se escribe directo sobre el slide; \xABnegro\xBB y \xABverde\xBB = pizarr\xF3n de tiza.",
+          ["blanco", "rayas", "cuadricula", "puntos", "vidrio", "transparente", "negro", "verde"]
+        ),
+        doc: objeto("Lo que la clase ve escrito al llegar. En el \u25B6 Player se escribe ENCIMA de una copia. Coordenadas en unidades de pizarra: 1600 \xD7 900 (la pizarra cubre el slide entero).", {
+          trazos: lista("Trazos a mano.", objeto("Un trazo.", {
+            id: texto("Identificador propio.", { obligatorio: true }),
+            tipo: opcion("Pluma o resaltador (semitransparente).", ["pluma", "marcador"], { obligatorio: true }),
+            color: color("Color de la tinta."),
+            ancho: num2("Grosor en unidades de pizarra.", { min: 1, max: 120, entero: false, obligatorio: true }),
+            p: lista("Los puntos, planos: x0, y0, x1, y1\u2026", num2("Una coordenada.", { entero: false }), { obligatorio: true })
+          })),
+          textos: lista("Textos tecleados.", objeto("Un texto.", {
+            id: texto("Identificador propio.", { obligatorio: true }),
+            x: num2("Borde izquierdo.", { entero: false, obligatorio: true }),
+            y: num2("Borde de arriba.", { entero: false, obligatorio: true }),
+            texto: texto("Lo escrito. Admite saltos de l\xEDnea.", { obligatorio: true }),
+            color: color("Color del texto."),
+            tam: num2("Tama\xF1o de la letra en unidades de pizarra (62 = medio).", { min: 10, max: 320, entero: false, obligatorio: true })
+          })),
+          imagenes: lista("Im\xE1genes pegadas.", objeto("Una imagen.", {
+            id: texto("Identificador propio.", { obligatorio: true }),
+            src: imagen("La imagen.", { obligatorio: true }),
+            x: num2("Borde izquierdo.", { entero: false, obligatorio: true }),
+            y: num2("Borde de arriba.", { entero: false, obligatorio: true }),
+            w: num2("Ancho.", { entero: false, obligatorio: true }),
+            h: num2("Alto.", { entero: false, obligatorio: true })
+          }))
+        })
+      }
+    },
+    ejemplo: {
+      fondo: "rayas",
+      doc: {
+        trazos: [{ id: "s1", tipo: "marcador", color: "#f59e0b", ancho: 38, p: [110, 200, 700, 200] }],
+        textos: [{ id: "t1", x: 110, y: 120, texto: "Today: the past simple", color: "#111827", tam: 62 }],
+        imagenes: []
+      }
+    }
+  },
   fracplot: {
     donde: "wcfg.ext",
     cfgSchema: {
@@ -2888,8 +2971,27 @@ function listaDestino(b, capa) {
 }
 function capaPorNombre(b, ref) {
   const s = slideDe(b);
+  return capaExacta(b, s, ref) ?? (b.estricto ? void 0 : s.layers.find((l) => l.name.toLowerCase().includes(ref.toLowerCase())));
+}
+function capaExacta(b, s, ref) {
+  const q = ref.trim().toLowerCase();
   const id = b.aliasCapa.get(ref);
-  return s.layers.find((l) => l.id === id) ?? s.layers.find((l) => l.name.toLowerCase() === ref.toLowerCase()) ?? s.layers.find((l) => l.name.toLowerCase().includes(ref.toLowerCase()));
+  return s.layers.find((l) => l.id === id) ?? s.layers.find((l) => l.id === ref) ?? s.layers.find((l) => l.name.trim().toLowerCase() === q);
+}
+function capaQueFalta(b, nombre, args) {
+  const ref = txt(args.capa).trim();
+  if (!ref || !nombre.startsWith("poner_") || nombre === "poner_fondo") return null;
+  const s = slideDe(b);
+  if (capaExacta(b, s, ref)) return null;
+  const q = ref.toLowerCase();
+  for (const [i, sc] of b.doc.entries()) for (const [j, sl] of sc.slides.entries()) {
+    if (sl === s) continue;
+    const l = sl.layers.find((x) => x.id === ref || x.name.trim().toLowerCase() === q);
+    if (l) {
+      return `La capa \xAB${l.name}\xBB es del slide ${j + 1} de la escena ${i + 1}, y est\xE1s trabajando en el slide ${b.slide + 1} de la escena ${b.escena + 1}. Ve antes con \`ir_a_slide\` (escena ${i + 1}, slide ${j + 1}). No puse nada.`;
+    }
+  }
+  return `No hay ninguna capa "${ref}" en este slide (escena ${b.escena + 1}, slide ${b.slide + 1}), y no la creo: un nombre mal escrito esconder\xEDa lo que pones en una capa que nadie abre. ${s.layers.length ? `Las que hay: ${s.layers.map((l) => `\xAB${l.name}\xBB [${l.id}]`).join(", ")}.` : "Este slide no tiene capas."} Cr\xE9ala antes con \`nueva_capa\`. No puse nada.`;
 }
 function slideDelEl(b, el) {
   for (const sc of b.doc) for (const sl of sc.slides) {
@@ -3016,10 +3118,9 @@ function armarAccion(b, a, el) {
       const ref = txt(a.capa).trim();
       if (b.estricto) {
         const sl = slideDelEl(b, el) ?? s;
-        const id = b.aliasCapa.get(ref);
-        const capa2 = sl.layers.find((l) => l.id === id) ?? sl.layers.find((l) => l.name.trim().toLowerCase() === ref.toLowerCase());
+        const capa2 = capaExacta(b, sl, ref);
         if (!capa2) {
-          return { accion: null, fallo: `${ref ? `No hay ninguna capa "${ref}"` : "Falta `capa`"} en el slide de ese objeto, y no la creo: un nombre mal escrito dejar\xEDa un bot\xF3n que abre una capa en blanco. ${sl.layers.length ? `Las que hay: ${sl.layers.map((l) => `\xAB${l.name}\xBB`).join(", ")}.` : "Ese slide no tiene capas."} Cr\xE9ala antes con \`nueva_capa\` o poniendo algo dentro con \`capa\`.` };
+          return { accion: null, fallo: `${ref ? `No hay ninguna capa "${ref}"` : "Falta `capa`"} en el slide de ese objeto, y no la creo: un nombre mal escrito dejar\xEDa un bot\xF3n que abre una capa en blanco. ${sl.layers.length ? `Las que hay: ${sl.layers.map((l) => `\xAB${l.name}\xBB`).join(", ")}.` : "Ese slide no tiene capas."} Cr\xE9ala antes con \`nueva_capa\`.` };
         }
         return { accion: { type: "showLayer", layerId: capa2.id } };
       }
@@ -3106,6 +3207,15 @@ function armarAccion(b, a, el) {
       if (audio2.kind !== "audio") return { accion: null, fallo: `"${d}" no es un audio.` };
       return { accion: { type: "playSound", targetId: audio2.id } };
     }
+    case "pausarAudio":
+    case "detenerAudio": {
+      const d = txt(a.destino).trim();
+      const audio2 = d ? buscarEl(b, d) : el.kind === "audio" ? el : null;
+      if (d && !audio2) return { accion: null, fallo: `No encuentro el audio "${d}".` };
+      if (audio2 && audio2.kind !== "audio") return { accion: null, fallo: `"${d}" no es un audio.` };
+      const type = txt(a.accion) === "pausarAudio" ? "pauseSound" : "stopSound";
+      return { accion: { type, targetId: audio2?.id ?? "" } };
+    }
     case "ocultar": {
       const d = txt(a.destino).trim();
       const otro = d ? buscarEl(b, d) : null;
@@ -3118,6 +3228,10 @@ function armarAccion(b, a, el) {
 }
 function ejecutar(b, nombre, args, fab) {
   const antes = b.creados.length;
+  if (b.estricto) {
+    const falta = capaQueFalta(b, nombre, args);
+    if (falta) return no(b, falta);
+  }
   const dijo = ejecutarUna(b, nombre, args, fab);
   return b.estricto && !b.fallo ? dijo + dejarFuera(b, nombre, args, antes) : dijo;
 }
@@ -3354,7 +3468,9 @@ El ref "${refBase}" es el rengl\xF3n grande; cada uno es tambi\xE9n "${refBase}_
         x: pct(args.x, 40),
         y: pct(args.y, 35),
         w,
-        h: def.alto === "cuadrado" ? squareH(w) : squareH(w) * def.alto,
+        // `alto` libre solo desde el MCP: los paneles de capa de los maestros son elipses de 82 × 77
+        // y rectángulos de 83 × 71, estirados a mano en el editor (Planificatron, corpus 2026-09-30).
+        h: b.estricto && num3(args.alto, 0) > 0 ? pct(args.alto, 20) : def.alto === "cuadrado" ? squareH(w) : squareH(w) * def.alto,
         fill: txt(args.color) || def.color,
         strokeW: 0,
         strokeStyle: "solid",
@@ -3655,7 +3771,7 @@ Pide \`describir("${el.widget}")\` para ver la forma exacta y vuelve a intentarl
     case "recolocar": {
       const el = buscarEl(b, txt(args.objetivo));
       if (!el) return no(b, `No encuentro ning\xFAn objeto "${txt(args.objetivo)}".`);
-      const altoLibre = el.kind === "widget" && !esMoneda(el) || !!el.hotspot;
+      const altoLibre = el.kind === "widget" && !esMoneda(el) || !!el.hotspot || !!b.estricto && el.kind === "shape";
       if (num3(args.alto, 0) > 0 && !altoLibre) {
         return no(b, `${describirEl(el)} no acepta \`alto\`: se deformar\xEDa. Solo las cajas (Revelador, Ciclo, Label It, QR\u2026) y las zonas calientes. Cambia su tama\xF1o con \`w\` y el alto le sigue.`);
       }
@@ -3795,7 +3911,7 @@ function describirTrigger(t, b) {
   const cuando = t.event.type === "click" ? "al tocarlo" : t.event.type === "hover" ? "al pasarle por encima" : t.event.type === "slideStart" ? "al entrar al slide" : t.event.type === "layerShown" ? "al abrirse su capa" : t.event.type === "time" ? `a los ${t.event.seconds} s` : t.event.type === "clickStep" ? `en el clic n\xBA ${t.event.step}` : t.event.type === "motionEnd" ? "al terminar su trayectoria" : "al dispararse";
   const a = t.action;
   const nombreCapa = (id) => buscarCapa(b, id)?.name ?? "una capa";
-  const qu\u00E9 = a.type === "showLayer" ? `abre \xAB${nombreCapa(a.layerId)}\xBB` : a.type === "goScene" ? `salta a \xAB${b.doc.find((s) => s.id === a.sceneId)?.name ?? "otra escena"}\xBB` : a.type === "goSlide" ? "salta a otro slide" : a.type === "closeLayer" ? "cierra la capa" : a.type === "speak" ? `lee \xAB${a.text}\xBB en voz alta` : a.type === "openUrl" ? "abre un enlace" : a.type === "hideEl" ? "desaparece con humo" : a.type === "playMotion" ? "recorre su trayectoria" : a.type === "playSound" ? "suena el audio" : a.type === "resetSequence" ? "reinicia el slide" : "hace lo suyo";
+  const qu\u00E9 = a.type === "showLayer" ? `abre \xAB${nombreCapa(a.layerId)}\xBB` : a.type === "goScene" ? `salta a \xAB${b.doc.find((s) => s.id === a.sceneId)?.name ?? "otra escena"}\xBB` : a.type === "goSlide" ? "salta a otro slide" : a.type === "closeLayer" ? "cierra la capa" : a.type === "speak" ? `lee \xAB${a.text}\xBB en voz alta` : a.type === "openUrl" ? "abre un enlace" : a.type === "hideEl" ? "desaparece con humo" : a.type === "playMotion" ? "recorre su trayectoria" : a.type === "playSound" ? "suena el audio" : a.type === "pauseSound" ? "pausa el audio" : a.type === "stopSound" ? "detiene el audio" : a.type === "resetSequence" ? "reinicia el slide" : "hace lo suyo";
   return `${cuando}, ${qu\u00E9}`;
 }
 
@@ -3836,13 +3952,22 @@ var WORDSTORM_SAMPLE = [
 var seq = 0;
 var cycleUid = () => `cs-${Date.now().toString(36)}-${seq++}`;
 
+// ../src/canvas/widgets/MagicShowWidget.datos.ts
+var seq2 = 0;
+var magicShowUid = () => `ms-${Date.now().toString(36)}-${seq2++}`;
+var MAGICSHOW_DEMO = ["apple", "cat", "sun", "book", "star", "fish"];
+
+// ../src/canvas/widgets/PizarraWidget.datos.ts
+var pzVacio = () => ({ trazos: [], textos: [], imagenes: [] });
+var PIZARRA_DEFAULTS = { fondo: "blanco", doc: pzVacio() };
+
 // ../src/canvas/widgets/plot2d.ts
 var CURVE_COLORS = ["#2563eb", "#dc2626", "#16a34a", "#d97706", "#7c3aed", "#db2777", "#0891b2", "#65a30d"];
 
 // ../src/canvas/widgets/EquationPlotterWidget.datos.ts
 var DEFAULT_VIEW = { cx: 0, cy: 0, scale: 46 };
-var seq2 = 0;
-var eid = () => `eq-${Date.now().toString(36)}-${seq2++}`;
+var seq3 = 0;
+var eid = () => `eq-${Date.now().toString(36)}-${seq3++}`;
 function defaultPlotterCfg() {
   return {
     eqs: [{ id: eid(), src: "y = x^2", color: CURVE_COLORS[0], visible: true }],
@@ -4122,17 +4247,17 @@ var WIDGETS = [
   // de la interfaz). El precio del recorte malo es peor que el de la GPU: por eso NO hay carril
   // barato de reserva — ver la cabecera de `quitarFondo.ts`.
   { type: "quitafondo", emoji: "\u{1F98E}", label: "Quita Fondos", blurb: "Arr\xE1stralo sobre una imagen y el camale\xF3n se come el fondo. Recorta con el modelo grande: separa mechones de pelo, hojas y patas.", premium: true, ready: true },
-  { type: "transformar", emoji: "\u{1F500}", label: "Transformador", blurb: "Arr\xE1stralo sobre un objeto y elige en qu\xE9 se convierte. En el \u25B6 Player cada clic lo transforma en la siguiente imagen \u2014de la oruga a la mariposa\u2014 y la \xFAltima lo devuelve a como estaba.", premium: false, ready: true },
-  { type: "magichat", emoji: "\u{1F3A9}", label: "Sombrero M\xE1gico", blurb: "Arr\xE1stralo sobre una imagen (o PNG) para volverla una silueta negra. En el \u25B6 Player, al hacer clic se revela a color con una lluvia de estrellas m\xE1gicas.", premium: false, ready: true },
+  { type: "transformar", emoji: "\u{1F500}", label: "Transformador", blurb: "Arr\xE1stralo sobre un objeto y elige en qu\xE9 se convierte. En el \u25B6 Player cada clic lo transforma en la siguiente imagen \u2014de la oruga a la mariposa\u2014 y la \xFAltima lo devuelve a como estaba.", premium: true, ready: true },
+  { type: "magichat", emoji: "\u{1F3A9}", label: "Sombrero M\xE1gico", blurb: "Arr\xE1stralo sobre una imagen (o PNG) para volverla una silueta negra. En el \u25B6 Player, al hacer clic se revela a color con una lluvia de estrellas m\xE1gicas.", premium: true, ready: true },
   // Tómbola: bombo de bingo que gira y suelta una bola (número/palabra/imagen), sin repetir.
-  { type: "tombola", emoji: "\u{1F3B0}", label: "T\xF3mbola", blurb: "Bombo de bingo: gira y suelta una bola al azar con un n\xFAmero, palabra o imagen. Sortea sin repetir hasta vaciarse. Ideal para rifas y elegir al azar.", premium: false, ready: true },
+  { type: "tombola", emoji: "\u{1F3B0}", label: "T\xF3mbola", blurb: "Bombo de bingo: gira y suelta una bola al azar con un n\xFAmero, palabra o imagen. Sortea sin repetir hasta vaciarse. Ideal para rifas y elegir al azar.", premium: true, ready: true },
   // Semáforo de comportamiento: 3 luces que el maestro toca en el Player para dar feedback a la clase.
   { type: "trafficlight", emoji: "\u{1F6A6}", label: "Sem\xE1foro", blurb: "Sem\xE1foro de comportamiento: en el Player, toca una luz (verde/\xE1mbar/rojo) para dar feedback a la clase. El rojo dispara una alerta sonora y visual.", premium: false, ready: true },
   // Graficador de ecuaciones (app-native, rama de MATEMÁTICA): orbe → estudio 2D/3D.
   // three.js entra por lazy() solo si el maestro pulsa 3D.
   // Label It (app-native, rama de CIENCIAS): la lámina del maestro se vuelve actividad de etiquetar.
   // Sirve a biología (célula, flor, corazón), pero también a geografía, anatomía o vocabulario.
-  { type: "labelit", emoji: "\u{1F3F7}\uFE0F", label: "Label It \u2014 etiquetar", blurb: "Sube cualquier l\xE1mina (c\xE9lula, flor, coraz\xF3n, mapa, una cara\u2026), toca la imagen para clavar los puntos y escribe el nombre de cada parte. En el \u25B6 Player se juega de tres formas: revelar al tocar, arrastrar las palabras a su punto, o escribirlas.", premium: false, ready: true },
+  { type: "labelit", emoji: "\u{1F3F7}\uFE0F", label: "Label It \u2014 etiquetar", blurb: "Sube cualquier l\xE1mina (c\xE9lula, flor, coraz\xF3n, mapa, una cara\u2026), toca la imagen para clavar los puntos y escribe el nombre de cada parte. En el \u25B6 Player se juega de tres formas: revelar al tocar, arrastrar las palabras a su punto, o escribirlas.", premium: true, ready: true },
   // Ciclo (app-native, rama de CIENCIAS): una rueda de etapas reemplaza cinco slides sueltas.
   // La rueda NO gira (gira el FOCO), así las imágenes quedan siempre derechas en la proyección.
   // 🍕 «Fracciones manipulables» (regletas que se cortan) SE RETIRÓ del catálogo el 2026-08-12:
@@ -4140,21 +4265,26 @@ var WIDGETS = [
   // armar sus láminas. El booster NO se borra —solo su tarjeta—: los slides que ya lo tengan
   // puesto tienen que seguir abriendo y funcionando (su render, su editor y su config siguen
   // cableados más abajo). Para devolverlo al catálogo, basta con volver a poner su entrada aquí.
-  { type: "cycle", emoji: "\u{1F504}", label: "Ciclo \u2014 rueda de etapas", blurb: "Rueda con las etapas de un proceso (metamorfosis, mitosis, ciclo del agua, fotos\xEDntesis\u2026), cada una con su imagen y su texto. En el \u25B6 Player, cada clic mueve el foco a la siguiente y el centro cuenta qu\xE9 pasa ah\xED. Puede cerrar en c\xEDrculo o ser una cadena, y los nombres pueden salir ocultos para que la clase adivine.", premium: false, ready: true },
+  { type: "cycle", emoji: "\u{1F504}", label: "Ciclo \u2014 rueda de etapas", blurb: "Rueda con las etapas de un proceso (metamorfosis, mitosis, ciclo del agua, fotos\xEDntesis\u2026), cada una con su imagen y su texto. En el \u25B6 Player, cada clic mueve el foco a la siguiente y el centro cuenta qu\xE9 pasa ah\xED. Puede cerrar en c\xEDrculo o ser una cadena, y los nombres pueden salir ocultos para que la clase adivine.", premium: true, ready: true },
+  // Show de Magia: «¿qué desapareció?» con teatro, sombrero y un botón mágico que elige el maestro.
+  { type: "magicshow", emoji: "\u{1F3A9}", label: "Show de Magia \u2014 \xBFqu\xE9 desapareci\xF3?", blurb: "Carga varias im\xE1genes (con su palabra o sin ella) y ponlas en un escenario de teatro. En el \u25B6 Player, cada clic en el bot\xF3n m\xE1gico mete las cartas al sombrero, las baraja y una desaparece; el siguiente clic la hace reaparecer. Nunca repite hasta que salgan todas. El bot\xF3n puede ser la varita o cualquier figura o animaci\xF3n de la biblioteca.", premium: true, ready: true },
   // Graficador de fracciones (app-native, rama de MATEMÁTICA): HERRAMIENTA de autoría. No es una
   // actividad para la clase: es la moneda con la que el maestro DIBUJA las fracciones de su
   // lámina, una tras otra, sin salir a buscar imágenes fuera.
-  { type: "fracplot", emoji: "\u{1F355}", label: "Graficador de fracciones", blurb: "Escribe una fracci\xF3n en sus dos casillas \u2014abajo en cu\xE1ntos pedazos se corta, arriba cu\xE1ntos se pintan\u2014 y la dibuja al instante. Cada \xABInsertar\xBB la estampa en el slide como una figura que se mueve y se estira como cualquier imagen, y el panel se queda abierto para pedir la siguiente: 3/4, luego 2/3, luego 5/8\u2026 Pizza o barra, con la fracci\xF3n escrita debajo. Una impropia como 4/3 sale como dos pizzas.", premium: false, ready: true },
+  { type: "fracplot", emoji: "\u{1F355}", label: "Graficador de fracciones", blurb: "Escribe una fracci\xF3n en sus dos casillas \u2014abajo en cu\xE1ntos pedazos se corta, arriba cu\xE1ntos se pintan\u2014 y la dibuja al instante. Cada \xABInsertar\xBB la estampa en el slide como una figura que se mueve y se estira como cualquier imagen, y el panel se queda abierto para pedir la siguiente: 3/4, luego 2/3, luego 5/8\u2026 Pizza o barra, con la fracci\xF3n escrita debajo. Una impropia como 4/3 sale como dos pizzas.", premium: true, ready: true },
   // QR: el puente entre el slide proyectado y el celular del alumno. Estático a
   // propósito (el enlace va grabado en el dibujo): cero infraestructura, cero costo
   // mensual y sigue funcionando dentro del .zip exportado a LearnPress.
   { type: "qr", emoji: "\u{1F533}", label: "QR \u2014 el que se come el enlace", blurb: "Pon un enlace y sale un c\xF3digo QR que la clase escanea con el celular: la tarea, el formulario, un video, la sala de Booster Live. Al pulsar \xABGenerar\xBB, el c\xF3digo se COME el enlace: abre la boca y se traga a bocados unos c\xF3digos QR peque\xF1os; al cerrarla, los m\xF3dulos que faltaban caen en su sitio. Color, forma de los puntos y r\xF3tulo a tu gusto.", premium: false, ready: true },
+  // Pizarra (app-native): escribir a mano, teclear y pegar imágenes DENTRO del slide. Para el
+  // pizarrón táctil del aula y para la clase por Zoom. Lo de la clase no toca lo guardado.
+  { type: "pizarra", emoji: "\u{1F58D}\uFE0F", label: "Pizarra blanca", blurb: "Una moneda que en el \u25B6 Player abre una pizarra encima de todo el slide: escribe a mano con el dedo, el l\xE1piz o el rat\xF3n, teclea texto y pega im\xE1genes. Pluma, resaltador, borrador, colores y deshacer; la \u2715 roja la quita. Papel blanco, de rayas, cuadros, puntos, vidrio, transparente o pizarr\xF3n de tiza. Ideal para pizarras t\xE1ctiles y clases por Zoom: lo que se escribe en clase no toca tu planificaci\xF3n.", premium: false, ready: true },
   { type: "plotter", emoji: "\u{1F4C8}", label: "Graficador 2D \xB7 3D", blurb: "Orbe que abre un graficador de ecuaciones. En 2D: funciones, polares, param\xE9tricas, c\xEDrculos y elipses, inecuaciones, y los CORTES entre curvas marcados con sus coordenadas. En 3D: superficies z = f(x,y) que se giran con el dedo. Cada letra suelta (a, b, c) se vuelve un deslizador.", premium: true, ready: true }
 ];
-var APP_NATIVE_BOOSTERS = ["instructions", "magicwand", "magichat", "quitafondo", "transformar", "tombola", "trafficlight", "plotter", "labelit", "cycle", "fractions", "fracplot", "qr"];
+var APP_NATIVE_BOOSTERS = ["instructions", "magicwand", "magichat", "quitafondo", "transformar", "tombola", "trafficlight", "plotter", "labelit", "cycle", "magicshow", "fractions", "fracplot", "qr", "pizarra"];
 var ARENAS_APP = [
   { type: "classification", emoji: "\u{1F6F8}", label: "Clasificaci\xF3n \xB7 Espacio", blurb: "Arrastra cada palabra a su categor\xEDa correcta. Tema espacial con OVNIs y aliens.", premium: false, ready: true },
-  { type: "classification-jungle", emoji: "\u{1F435}", label: "Clasificaci\xF3n \xB7 Selva", blurb: "Arrastra cada monito a su bungal\xF3 correcto. Tema selva con caba\xF1as de bamb\xFA.", premium: false, ready: true },
+  { type: "classification-jungle", emoji: "\u{1F435}", label: "Clasificaci\xF3n \xB7 Selva", blurb: "Arrastra cada monito a su bungal\xF3 correcto. Tema selva con caba\xF1as de bamb\xFA.", premium: true, ready: true },
   { type: "gameshow", emoji: "\u{1F3AD}", label: "Game Show", blurb: "Concurso de 2 estudiantes: tel\xF3n, ruleta, preguntas con tiempo y podio.", premium: true, ready: true },
   { type: "race", emoji: "\u{1F3CE}\uFE0F", label: "Carrera de Karts", blurb: "Carrera estilo F\xF3rmula 1: hasta 4 jugadores eligen corredor, responden preguntas y ganan nitro.", premium: true, ready: true },
   { type: "pirate", emoji: "\u{1F3F4}\u200D\u2620\uFE0F", label: "Batalla Pirata", blurb: "Concurso de preguntas para TODA la clase desde sus celulares: gana oro por contestar r\xE1pido, y el que acierta abre un cofre que puede quitarle oro a un compa\xF1ero.", premium: true, ready: true },
@@ -4163,19 +4293,20 @@ var ARENAS_APP = [
   { type: "memory", emoji: "\u{1F0CF}", label: "Memory Game", blurb: "Encuentra las parejas ocultas. Cada carta acepta imagen, audio y texto: imagen\u2194imagen con audio, imagen\u2194palabra o palabra\u2194definici\xF3n. Individual o por equipos.", premium: false, ready: true },
   // Word Storm nació en we-boosters y se trajo app-native (ver APP_NATIVE_ARENAS): su ficha
   // ya no viene del puente, así que vive aquí como cualquier arena de la app.
-  { type: "booster-escape", emoji: "\u{1F9ED}", label: "Booster Escape", blurb: "Laberinto a contrarreloj con dos modos: Individual (corre por los pasillos, esquiva a los enemigos y llega a la respuesta correcta; 3 vidas) y Versus 1v1. Un toque y el explorador corre solo hasta topar. Edita las preguntas (con imagen/audio).", premium: false, ready: true },
-  { type: "las-vegas", emoji: "\u{1F3B0}", label: "The Fabulous Las Vegas", blurb: "Tragamonedas para construir frases: jala la palanca, los rodillos frenan uno a uno y sale una combinaci\xF3n \u2014SHE \xB7 WRITTEN \xB7 A LETTER\u2014 que la clase dice en voz alta. De 1 a 4 rodillos, y cada casilla puede ser una palabra o un dibujo.", premium: false, ready: true },
+  { type: "booster-escape", emoji: "\u{1F9ED}", label: "Booster Escape", blurb: "Laberinto a contrarreloj con dos modos: Individual (corre por los pasillos, esquiva a los enemigos y llega a la respuesta correcta; 3 vidas) y Versus 1v1. Un toque y el explorador corre solo hasta topar. Edita las preguntas (con imagen/audio).", premium: true, ready: true },
+  { type: "las-vegas", emoji: "\u{1F3B0}", label: "The Fabulous Las Vegas", blurb: "Tragamonedas para construir frases: jala la palanca, los rodillos frenan uno a uno y sale una combinaci\xF3n \u2014SHE \xB7 WRITTEN \xB7 A LETTER\u2014 que la clase dice en voz alta. De 1 a 4 rodillos, y cada casilla puede ser una palabra o un dibujo.", premium: true, ready: true },
   // Sentence Line (app-native): la hermana de Word Factory — mismo motor, pero la pieza es una
   // PALABRA y lo que se arma es una oración.
-  { type: "sentenceline", emoji: "\u{1F309}", label: "Sentence Bridge", blurb: "El puente de tablones: cada palabra es un tabl\xF3n y hay que ponerlas en orden para armar el puente. El explorador salta al tabl\xF3n que acabas de poner, y si la oraci\xF3n no es, los tablones equivocados se caen al r\xEDo. Cuando la frase queda bien, cruza al otro lado. Se parte sola por los espacios, o marcas trozos con barras \u2014\xABThe black cat / is sleeping / on the sofa\xBB\u2014 para ense\xF1ar la estructura.", premium: false, ready: true },
+  { type: "sentenceline", emoji: "\u{1F309}", label: "Sentence Bridge", blurb: "El puente de tablones: cada palabra es un tabl\xF3n y hay que ponerlas en orden para armar el puente. El explorador salta al tabl\xF3n que acabas de poner, y si la oraci\xF3n no es, los tablones equivocados se caen al r\xEDo. Cuando la frase queda bien, cruza al otro lado. Se parte sola por los espacios, o marcas trozos con barras \u2014\xABThe black cat / is sleeping / on the sofa\xBB\u2014 para ense\xF1ar la estructura.", premium: true, ready: true },
   // Word Factory (app-native): deletrear ordenando las letras que llegan por la cinta.
-  { type: "wordfactory", emoji: "\u{1F3ED}", label: "Word Factory", blurb: "Una f\xE1brica de palabras: entra un dibujo y sus letras llegan revueltas por la cinta transportadora. El alumno las mete en la m\xE1quina en el orden correcto y, cuando la palabra sale bien, la m\xE1quina fabrica el objeto y lo sella. Sirve para cualquier vocabulario: sube tu dibujo y escribe su palabra.", premium: false, ready: true },
+  { type: "wordfactory", emoji: "\u{1F3ED}", label: "Word Factory", blurb: "Una f\xE1brica de palabras: entra un dibujo y sus letras llegan revueltas por la cinta transportadora. El alumno las mete en la m\xE1quina en el orden correcto y, cuando la palabra sale bien, la m\xE1quina fabrica el objeto y lo sella. Sirve para cualquier vocabulario: sube tu dibujo y escribe su palabra.", premium: true, ready: true },
   // Mazo de Cartas (app-native): reemplaza la actividad de cartas de Wordwall. El maestro
   // toca el mazo y sale una carta al azar; la descarta o la devuelve al mazo.
   { type: "deck", emoji: "\u{1F3B4}", label: "Mazo de Cartas", blurb: "Un mazo boca abajo: toca y sale una carta al azar, volte\xE1ndose en el aire. Cada carta lleva una palabra, una pregunta o un dibujo. La descartas o la devuelves al mazo, y con un bot\xF3n se mezcla otra vez. Para conversaci\xF3n, vocabulario, verbos o tarjetas de rol.", premium: false, ready: true },
-  { type: "word-storm", emoji: "\u2328\uFE0F", label: "Word Storm", blurb: "Lluvia de palabras: escr\xEDbelas con el teclado para destruirlas antes de que toquen la l\xEDnea de peligro. La dificultad sube solita. Edita la lista de palabras.", premium: false, ready: true }
+  { type: "word-storm", emoji: "\u2328\uFE0F", label: "Word Storm", blurb: "Lluvia de palabras: escr\xEDbelas con el teclado para destruirlas antes de que toquen la l\xEDnea de peligro. La dificultad sube solita. Edita la lista de palabras.", premium: true, ready: true }
 ];
-var soloFicha = (e) => ({ type: e.type, emoji: e.emoji, label: e.label, blurb: e.blurb, premium: e.premium, ready: e.ready });
+var soloFicha = (e) => ({ type: e.type, emoji: e.emoji, label: e.label, blurb: e.blurb, premium: e.premium || PREMIUM_EXTERNAS.has(e.type), ready: e.ready });
+var PREMIUM_EXTERNAS = /* @__PURE__ */ new Set(["jenga", "we-spelling-jenga", "duck-shooting"]);
 var ALL_WIDGETS = [
   ...WIDGETS,
   ...FICHAS_BOOSTERS.filter((e) => !APP_NATIVE_BOOSTERS.includes(e.type)).map(soloFicha)
@@ -4200,8 +4331,13 @@ function construirWidget(type, manos) {
     guess: false,
     sound: true,
     stages: Array.from({ length: 4 }, () => ({ id: cycleUid(), text: "" }))
-  } } : type === "fractions" ? { ext: { mode: "add", title: "", a: "1/2", b: "1/3", denoms: FRAC_DENOMS, labels: true, sound: true } } : type === "qr" ? { ext: { ...QR_DEFAULTS, gen: 0 } } : type === "wheel" ? { names: namesDefault } : type === "timer" ? { seconds: 60 } : type === "score" ? { teams: ["Equipo A", "Equipo B"] } : type === "groups" ? { names: namesDefault, teamCount: 2 } : type === "mystery" ? { items: ["apple", "happy", "run", "book", "blue", "friend", "school", "water"] } : { dice: 1 };
-  const sz = ext ? ext.defaultSize : type === "trafficlight" ? { w: 16, h: 42 } : type === "labelit" ? { w: 52, h: 68 } : type === "cycle" ? { w: 66, h: 64 } : type === "fractions" ? { w: 74, h: 50 } : type === "qr" ? { w: 16, h: 33 } : { w: 7, h: 12.4 };
+  } } : type === "magicshow" ? { ext: {
+    names: true,
+    shuffle: true,
+    sound: true,
+    items: MAGICSHOW_DEMO.map((text) => ({ id: magicShowUid(), text }))
+  } } : type === "fractions" ? { ext: { mode: "add", title: "", a: "1/2", b: "1/3", denoms: FRAC_DENOMS, labels: true, sound: true } } : type === "qr" ? { ext: { ...QR_DEFAULTS, gen: 0 } } : type === "pizarra" ? { ext: { ...PIZARRA_DEFAULTS, doc: pzVacio() } } : type === "wheel" ? { names: namesDefault } : type === "timer" ? { seconds: 60 } : type === "score" ? { teams: ["Equipo A", "Equipo B"] } : type === "groups" ? { names: namesDefault, teamCount: 2 } : type === "mystery" ? { items: ["apple", "happy", "run", "book", "blue", "friend", "school", "water"] } : { dice: 1 };
+  const sz = ext ? ext.defaultSize : type === "trafficlight" ? { w: 16, h: 42 } : type === "labelit" ? { w: 52, h: 68 } : type === "cycle" ? { w: 66, h: 64 } : type === "magicshow" ? { w: 62, h: 62 } : type === "fractions" ? { w: 74, h: 50 } : type === "qr" ? { w: 16, h: 33 } : { w: 7, h: 12.4 };
   const pos = sz.h > 55 ? { x: (100 - sz.w) / 2, y: (100 - sz.h) / 2 } : p;
   return { ok: true, el: { id: manos.uid("wdg"), kind: "widget", widget: type, x: pos.x, y: pos.y, w: sz.w, h: sz.h, wcfg } };
 }

package/package.json

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

package/proyectos.mjs

@@ -154,7 +154,12 @@ export async function resolverDestino(token, { equipo, carpeta }) {
 if (import.meta.url === pathToFileURL(process.argv[1]).href) {
   const YO = `node ${process.argv[1]}`;
   const [, , orden, ...resto] = process.argv;
-  const token = await tokenDeAcceso();
+  const token = await tokenDeAcceso().catch((e) => {
+    console.error(`
+  ✕ ${e.message}
+`);
+    process.exit(1);
+  });
   if (!token) {
     console.error('\n  ✕ No hay sesión. Entra primero con `sesion.mjs entrar`.\n');
     process.exit(1);

package/servidor.mjs

@@ -30,7 +30,7 @@ import { join } from 'node:path';
 import { existsSync } from 'node:fs';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createRequire } from 'node:module';
-import { tokenDeAcceso } from './sesion.mjs';
+import { alRenovar, tokenDeAcceso } from './sesion.mjs';
 import { abrir, carpetas, crear, equipos, guardar, listar, resolverDestino } from './proyectos.mjs';
 import { subirArchivo, subirBytes } from './subidas.mjs';
 import { rematarEncargo } from './encargos.mjs';
@@ -104,6 +104,10 @@ const fabricas = () => ({
   nuevaArena: (t) => nucleo.construirArena(t, manos()),
 });
 
+// Cada refresco de la sesión queda en el registro. Lo normal es ~1 por hora: si salen muchos
+// seguidos, algo vuelve a renovar de más (ver `tokenDeAcceso()`).
+alRenovar(({ refrescos, expira }) => aviso(`sesión renovada (#${refrescos}), vale hasta ${expira}`));
+
 async function token() {
   const t = await tokenDeAcceso();
   if (!t) throw new Error('No hay sesión en este equipo. Corre `node mcp/sesion.mjs entrar` y vuelve a arrancar el agente.');
@@ -146,6 +150,10 @@ function herramientasDelLienzo() {
   }));
 }
 
+const MAX_TANDA = 300;
+// Lo que cambia de proyecto (dejaría el resto de la lista cayendo en otro) y la propia tanda.
+const NO_EN_TANDA = new Set(['tanda', 'abrir_proyecto', 'crear_proyecto']);
+
 const HERRAMIENTAS_PROYECTO = [
   {
     name: 'listar_proyectos',
@@ -156,13 +164,34 @@ const HERRAMIENTAS_PROYECTO = [
   {
     name: 'abrir_proyecto',
     description: 'Abre un proyecto y lo deja LISTO para trabajar. A partir de aquí, todo lo que pongas '
-      + 'cae en él. Hay que llamarlo antes que cualquier herramienta del lienzo.',
+      + 'cae en él. Hay que llamarlo antes que cualquier herramienta del lienzo. Sin `slide`, se trabaja '
+      + 'en el slide 1 de la escena 1; para CORREGIR un slide ya hecho, pásale `escena` y `slide` (o '
+      + 'usa `ir_a_slide` después): entonces devuelve una línea por slide y el detalle SOLO de ese, que '
+      + 'cuesta mucho menos leer que el proyecto entero.',
     inputSchema: {
       type: 'object',
-      properties: { id: { type: 'string', description: 'El id que devolvió `listar_proyectos`.' } },
+      properties: {
+        id: { type: 'string', description: 'El id que devolvió `listar_proyectos`.' },
+        escena: { type: 'string', description: 'En qué escena trabajar: su número empezando en 1, o su nombre. Sin esto, la 1.' },
+        slide: { type: 'string', description: 'En qué slide trabajar: su número empezando en 1, su nombre o su id. Sin esto, el 1.' },
+      },
       required: ['id'],
     },
   },
+  {
+    name: 'ir_a_slide',
+    description: 'Cambia el slide de TRABAJO del proyecto abierto a uno que ya existe, para corregirlo '
+      + 'sin rehacer nada. Todo lo que pongas después (y el `capa` de las herramientas de poner) es de '
+      + 'ese slide. Devuelve lo que tiene, con los ids de sus objetos y capas.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        escena: { type: 'string', description: 'Su número empezando en 1, o su nombre. Sin esto, la escena en la que estás.' },
+        slide: { type: 'string', description: 'Su número empezando en 1 dentro de esa escena, su nombre o su id.' },
+      },
+      required: ['slide'],
+    },
+  },
   {
     name: 'crear_proyecto',
     description: 'Crea una presentación nueva, vacía, y la deja abierta para trabajar. Devuelve su id. '
@@ -285,6 +314,34 @@ const HERRAMIENTAS_PROYECTO = [
       required: [],
     },
   },
+  {
+    name: 'tanda',
+    description: 'Hace VARIAS órdenes en una sola llamada, en orden, sobre el proyecto abierto. Es la forma '
+      + 'BARATA de armar un slide: en vez de 100 llamadas sueltas (y 100 vueltas de pensar), una lista. '
+      + 'Cada orden es { herramienta, args } con los mismos nombres y argumentos que la herramienta suelta; '
+      + 'los `ref` de una orden valen para las siguientes. Se para en la primera que falle (lo de antes ya '
+      + 'queda puesto) y te dice cuál y por qué. No sirve para abrir o crear proyectos. Guarda al final '
+      + 'con `guardar_proyecto` (puede ser la última orden de la lista).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        ordenes: {
+          type: 'array',
+          description: `De 1 a ${MAX_TANDA} órdenes.`,
+          items: {
+            type: 'object',
+            properties: {
+              herramienta: { type: 'string', description: 'Nombre de la herramienta. Ej: "poner_texto".' },
+              args: { type: 'object', description: 'Sus argumentos, como si la llamaras sola.' },
+            },
+            required: ['herramienta'],
+          },
+        },
+        seguir_si_falla: { type: 'boolean', description: 'true = si una falla, sigue con las demás. Sin esto, se para.' },
+      },
+      required: ['ordenes'],
+    },
+  },
 ];
 
 // ── Ejecutar una herramienta ─────────────────────────────────────────────────
@@ -336,6 +393,8 @@ function queHace(t, doc, slide) {
       : a.type === 'goSlide' ? 'va a otro slide'
         : a.type === 'closeLayer' ? 'cierra la capa'
           : a.type === 'playSound' ? `suena ${a.targetId}`
+          : a.type === 'pauseSound' ? `pausa ${a.targetId || 'el audio'}`
+          : a.type === 'stopSound' ? `detiene ${a.targetId || 'el audio'}`
             : a.type === 'speak' ? `lee «${corto(a.text, 24)}»`
               : a.type === 'openUrl' ? `abre ${a.url}`
                 : a.type === 'hideEl' ? `oculta ${a.targetId || 'el objeto'}`
@@ -378,6 +437,78 @@ function resumenDelDoc(doc, { escena, slide } = {}) {
   return filas.join('\n') || 'No hay nada con esos números de escena y slide.';
 }
 
+/**
+ * Varias órdenes en UNA llamada. El gasto de un agente no está en cada orden sino en cada vuelta
+ * de pensar: un slide eran ~150 llamadas y, en cada una, el modelo relee toda la conversación.
+ * Con una lista, el modelo piensa una vez y el servidor ejecuta. La respuesta es una línea por
+ * orden, sin la bitácora, para que tampoco la vuelta engorde.
+ */
+async function tanda(args) {
+  const ordenes = Array.isArray(args.ordenes) ? args.ordenes : [];
+  if (!ordenes.length) throw new Error('Falta `ordenes`: una lista de { herramienta, args }.');
+  if (ordenes.length > MAX_TANDA) throw new Error(`Son ${ordenes.length} órdenes y el máximo son ${MAX_TANDA}. Pártelas en varias tandas.`);
+  const filas = [];
+  let fallos = 0;
+  for (const [i, o] of ordenes.entries()) {
+    const h = String(o?.herramienta ?? '').trim();
+    try {
+      if (!h) throw new Error('falta `herramienta`.');
+      if (NO_EN_TANDA.has(h)) throw new Error(`\`${h}\` no va dentro de una tanda: llámala sola.`);
+      const dijo = await llamar(h, o.args && typeof o.args === 'object' ? o.args : {});
+      filas.push(`${i + 1} ✓ ${h} — ${String(dijo).split('\n(bitácora:')[0].split('\n')[0]}`);
+    } catch (e) {
+      fallos++;
+      filas.push(`${i + 1} ✕ ${h || '?'} — ${e.message}`);
+      if (!args.seguir_si_falla) {
+        if (i + 1 < ordenes.length) filas.push(`(paré aquí: las ${ordenes.length - i - 1} siguientes NO se hicieron)`);
+        break;
+      }
+    }
+  }
+  const texto = filas.join('\n');
+  if (fallos) throw new Error(`${fallos} orden(es) fallaron. Lo que salió bien ya está puesto (sin guardar).\n${texto}`);
+  return `${ordenes.length} orden(es) hechas.\n${texto}`;
+}
+
+/** Una línea por slide: para orientarse sin leer el proyecto entero. */
+function indiceDelDoc(doc) {
+  const filas = [];
+  doc.forEach((esc, i) => {
+    filas.push(`Escena ${i + 1}: «${esc.name ?? 'sin nombre'}»`);
+    esc.slides.forEach((s, j) => {
+      const n = s.base.length + s.layers.reduce((t, l) => t + l.els.length, 0);
+      filas.push(`  slide ${j + 1}${s.name ? ` «${s.name}»` : ''} — ${n} objeto(s), ${s.layers.length} capa(s)`);
+    });
+  });
+  return filas.join('\n');
+}
+
+/**
+ * Mueve el punto de trabajo a un slide que YA existe. Antes `abrir_proyecto` dejaba siempre el
+ * slide 1 y no había forma de ir a otro: corregir un slide hecho obligaba a rehacer el proyecto
+ * (Planificatron, hallazgo 23, 2026-10-12). Números desde 1, como los enseña `resumenDelDoc`.
+ */
+function irASlide(args) {
+  const b = yo.borrador;
+  const busca = (lista, pide, actual, qué) => {
+    if (pide === undefined || pide === null || String(pide).trim() === '') return actual;
+    const q = String(pide).trim();
+    const n = Number(q);
+    if (Number.isInteger(n) && n >= 1 && n <= lista.length) return n - 1;
+    const i = lista.findIndex((x) => x.id === q || String(x.name ?? '').trim().toLowerCase() === q.toLowerCase());
+    if (i < 0) {
+      throw new Error(`No hay ${qué === 'escena' ? 'ninguna escena' : 'ningún slide'} "${q}". `
+        + `${qué === 'escena' ? 'Las' : 'Los'} que hay: ${lista.map((x, k) => `${k + 1} «${x.name ?? ''}»`).join(', ')}.`);
+    }
+    return i;
+  };
+  const e = busca(b.doc, args.escena, Math.min(b.escena, b.doc.length - 1), 'escena');
+  const s = busca(b.doc[e].slides, args.slide, 0, 'slide');
+  b.escena = e;
+  b.slide = s;
+  return { escena: e + 1, slide: s + 1 };
+}
+
 async function llamar(nombre, args = {}) {
   // ── Proyectos ──────────────────────────────────────────────────────────────
   if (nombre === 'listar_proyectos') {
@@ -410,6 +541,8 @@ async function llamar(nombre, args = {}) {
     yo.proyecto = p;
     yo.borrador = nucleo.nuevoBorrador(Array.isArray(p.document) ? p.document : [], 0, 0, '');
     yo.borrador.estricto = true;  // sin nadie delante: lo que el Robot resuelve solo, aquí se niega
+    const aUnSlide = nombre === 'abrir_proyecto' && (args.slide !== undefined || args.escena !== undefined);
+    const dondeTrabajo = aUnSlide ? irASlide({ escena: args.escena, slide: args.slide ?? 1 }) : null;
     yo.borrador.premium = yo.plan === 'pro';
     // `poner_dibujo`, `poner_fondo` y `poner_lottie` buscan en caliente.
     await Promise.all([nucleo.cargarBiblioteca(), nucleo.cargarAnimaciones()]);
@@ -422,7 +555,23 @@ async function llamar(nombre, args = {}) {
       : 'tu espacio Personal';
     return `${nombre === 'crear_proyecto' ? 'Creado' : 'Abierto'} «${p.title}»\nid: ${p.id}\n`
       + `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)}`;
+      + `Plan de la cuenta: ${yo.plan}. ${yo.borrador.doc.length} escena(s).\n`
+      + `Trabajando en: escena ${yo.borrador.escena + 1}, slide ${yo.borrador.slide + 1}.\n\n`
+      // Abierto en un slide: el índice de todo + el detalle SOLO de ese. Un proyecto entero con sus
+      // ids son miles de tokens que, para corregir un slide, no hacen falta.
+      + (dondeTrabajo
+        ? `${indiceDelDoc(yo.borrador.doc)}\n\nEl slide de trabajo:\n${resumenDelDoc(yo.borrador.doc, dondeTrabajo)}`
+        : resumenDelDoc(yo.borrador.doc));
+  }
+  if (nombre === 'tanda') {
+    exigeProyecto();
+    return tanda(args);
+  }
+  if (nombre === 'ir_a_slide') {
+    exigeProyecto();
+    const { escena, slide } = irASlide(args);
+    return `Ahora trabajas en la escena ${escena}, slide ${slide}. Lo que pongas va aquí; guarda al terminar.\n\n`
+      + resumenDelDoc(yo.borrador.doc, { escena, slide });
   }
   // 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.
@@ -522,7 +671,14 @@ ${r.aviso}` : '');
   // ── El lienzo: lo hace el MISMO ejecutor que el Robot del navegador ─────────
   exigeProyecto();
   yo.borrador.fallo = false;
-  const dijo = nucleo.ejecutar(yo.borrador, nombre, args, fabricas());
+  // Lo que pidió la persona vale SOLO para esta orden: si se quedara puesto, un «quita esto» de
+  // hace diez órdenes abriría el cerrojo para cualquier `borrar` posterior.
+  yo.borrador.pedido = String(args.pedido_del_maestro ?? '');
+  let dijo;
+  try { dijo = nucleo.ejecutar(yo.borrador, nombre, args, fabricas()); } finally { yo.borrador.pedido = ''; }
+  if (yo.borrador.fallo && !args.pedido_del_maestro && (nombre === 'borrar' || args.accion === 'quitar')) {
+    throw new Error(`${dijo} Si la persona SÍ te lo pidió, vuelve a llamar pasando su mensaje tal cual en \`pedido_del_maestro\`.`);
+  }
   // ⚠️ UN RECHAZO ES UN ERROR, NO UN ÉXITO CON MALAS NOTICIAS. El ejecutor contesta con una frase
   // también cuando se niega («No existe ninguna arena…»), porque al Robot del navegador le basta
   // leerla. A una fábrica sin nadie delante, no: la contaba como hecha y el slide quedaba vacío

package/sesion.mjs

@@ -73,12 +73,16 @@ function cliente() {
 }
 
 // ── La credencial en disco ───────────────────────────────────────────────────
-// Se guarda el `refresh_token`, no el de acceso: el de acceso caduca en una hora y se renueva
-// solo. Este archivo ES una llave, así que va a 600 (solo su dueño), igual que `~/.claude`.
+// Se guarda el `refresh_token` y, junto a él, el token de acceso con su caducidad. Este archivo
+// ES una llave, así que va a 600 (solo su dueño), igual que `~/.claude`.
+// El de acceso va también al archivo para que dos procesos (el servidor y un `quien` suelto, o
+// dos agentes) se lo PRESTEN en vez de renovar cada uno por su lado.
 function guardar(sesion) {
   if (!existsSync(CARPETA)) mkdirSync(CARPETA, { recursive: true, mode: 0o700 });
   const datos = {
     refresh_token: sesion.refresh_token,
+    access_token: sesion.access_token,
+    expira: sesion.expires_at ?? Math.floor(Date.now() / 1000) + (sesion.expires_in ?? 3600),
     correo: sesion.user?.email ?? null,
     guardado: new Date().toISOString(),
   };
@@ -91,15 +95,91 @@ export function leerCredencial() {
   try { return JSON.parse(readFileSync(CREDENCIAL, 'utf8')); } catch { return null; }
 }
 
-/** Devuelve un token de acceso FRESCO, o null si no hay sesión. Es lo que usará el MCP. */
+// ── El token de acceso: se RENUEVA SOLO CUANDO VA A CADUCAR ───────────────────
+// ⚠️ Antes se llamaba a `refreshSession` en CADA orden. Un slide con capas son ~150 órdenes, y
+// Supabase limita los refrescos por IP: a mitad de tanda contestaba con error, este código se lo
+// tragaba (`return null`) y el agente veía «No hay sesión» / «ya no vale». Minutos después volvía
+// solo. Lo destapó el agente de una coach fabricando boosters (Planificatron, hallazgo 22,
+// 2026-10-12). Ahora:
+//  · el token vive en memoria (y en el archivo) y se reutiliza mientras le queden > 5 minutos;
+//  · UN solo refresco a la vez: las órdenes que llegan mientras tanto esperan al mismo;
+//  · si el refresco falla, se dice el error REAL de Supabase, no «no hay sesión».
+const MARGEN_S = 5 * 60;
+let enMemoria = null;  // { access_token, expira, refresh_token }
+let enCurso = null;    // la promesa del refresco que está en marcha, si hay uno
+let refrescos = 0;
+let alRenovarFn = null;
+
+/** Para que el servidor apunte en su bitácora cada refresco (debería ser ~1 por hora). */
+export function alRenovar(fn) { alRenovarFn = fn; }
+
+const ahoraS = () => Date.now() / 1000;
+const vale = (c) => !!c?.access_token && Number(c.expira) - ahoraS() > MARGEN_S;
+const esperar = (ms) => new Promise((r) => setTimeout(r, ms));
+
+function describir(error) {
+  if (!error) return 'Supabase no devolvió sesión';
+  const partes = [error.message || String(error)];
+  if (error.code) partes.push(`[${error.code}]`);
+  if (error.status) partes.push(`(HTTP ${error.status})`);
+  return partes.join(' ');
+}
+
+async function renovar(cred) {
+  let ultimo = null;
+  let refresh = cred.refresh_token;
+  for (let intento = 0; intento < 3; intento++) {
+    const { data, error } = await cliente().auth.refreshSession({ refresh_token: refresh });
+    if (!error && data?.session) {
+      guardar(data.session); // el refresh token ROTA: si no se reescribe, la próxima vez falla
+      enMemoria = {
+        access_token: data.session.access_token,
+        expira: data.session.expires_at,
+        refresh_token: data.session.refresh_token,
+      };
+      refrescos++;
+      alRenovarFn?.({ refrescos, expira: new Date(enMemoria.expira * 1000).toISOString() });
+      return enMemoria.access_token;
+    }
+    ultimo = error;
+    // ¿Lo renovó otro proceso mientras tanto? Entonces el archivo ya trae uno bueno.
+    const otra = leerCredencial();
+    if (otra?.refresh_token && otra.refresh_token !== refresh) {
+      if (vale(otra)) {
+        enMemoria = { access_token: otra.access_token, expira: otra.expira, refresh_token: otra.refresh_token };
+        return otra.access_token;
+      }
+      refresh = otra.refresh_token;
+      continue;
+    }
+    // Un 4xx que no es límite de peticiones es definitivo (sesión cerrada, token revocado):
+    // reintentar no lo arregla. Red caída, 429 y 5xx sí merecen otra vuelta.
+    const st = error?.status;
+    if (st && st >= 400 && st < 500 && st !== 429) break;
+    await esperar(1000 * 2 ** intento);
+  }
+  // Si el token que ya tenemos aún no ha caducado del todo, mejor usarlo que tumbar la orden.
+  if (cred.access_token && Number(cred.expira) - ahoraS() > 30) return cred.access_token;
+  throw new Error(`La sesión de ${cred.correo ?? 'este equipo'} no se pudo renovar: ${describir(ultimo)}. `
+    + 'Si persiste, vuelve a entrar con `npx boosterarena-mcp entrar`.');
+}
+
+/**
+ * Devuelve un token de acceso válido, o null si en este equipo no hay sesión.
+ * Si hay sesión pero Supabase no la renueva, LANZA con el error real.
+ */
 export async function tokenDeAcceso() {
   const cred = leerCredencial();
-  if (!cred?.refresh_token) return null;
-  const sb = cliente();
-  const { data, error } = await sb.auth.refreshSession({ refresh_token: cred.refresh_token });
-  if (error || !data.session) return null;
-  guardar(data.session); // el refresh token ROTA: si no se reescribe, la próxima vez falla
-  return data.session.access_token;
+  if (!cred?.refresh_token) { enMemoria = null; return null; }
+  // Otra entrada (u otro proceso que renovó) cambió el archivo: lo de memoria ya no es lo vigente.
+  if (enMemoria && enMemoria.refresh_token !== cred.refresh_token) enMemoria = null;
+  if (vale(enMemoria)) return enMemoria.access_token;
+  if (vale(cred)) {
+    enMemoria = { access_token: cred.access_token, expira: Number(cred.expira), refresh_token: cred.refresh_token };
+    return cred.access_token;
+  }
+  enCurso ??= renovar(cred).finally(() => { enCurso = null; });
+  return enCurso;
 }
 
 // ── Abrir el navegador ───────────────────────────────────────────────────────
@@ -246,7 +326,8 @@ function escuchar(puerto, estado) {
 export async function quien() {
   const cred = leerCredencial();
   if (!cred) { console.log(`  No hay sesión en este equipo. Usa: ${YO} entrar`); return; }
-  const token = await tokenDeAcceso();
+  let token;
+  try { token = await tokenDeAcceso(); } catch (e) { console.log(`  ✕ ${e.message}`); return; }
   if (!token) { console.log(`  La sesión de ${cred.correo ?? 'este equipo'} ya no vale. Vuelve a entrar.`); return; }
   const r = await fetch(`${SUPABASE_URL}/auth/v1/user`, {
     headers: { apikey: SUPABASE_KEY, Authorization: `Bearer ${token}` },