boosterarena-mcp 0.2.2 → 0.3.1

package/LEEME.md

@@ -54,7 +54,16 @@ habla con Booster con **tu** sesión.
 borrador y tú decides cuándo se publica.
 
 **Contenido** — poner texto, imágenes, figuras y dibujos de la biblioteca (más de 3.000
-ilustraciones y 280 fondos, que se buscan por nombre en español o inglés).
+ilustraciones y 280 fondos, que se buscan por nombre en español o inglés), y animaciones Lottie
+(`poner_lottie`: de la galería de Booster o por URL). El fondo puede ser una imagen tuya
+(`poner_fondo` con `url`), y cada capa puede llevar el suyo (`capa` en `poner_fondo`, o `fondo`
+en `nueva_capa`).
+
+**Trayectorias** — `programar … moverPorTrayectoria` con `hasta` {x, y} (a dónde llega el centro
+del objeto, en % del slide) traza el camino solo; `puntos` para curvas o escalas y `duracion` en
+ms. Un objeto puede tener varios caminos con nombre: en una secuencia de clics cada uno sale de
+donde lo dejó el anterior, y `trayectoriaTerminada` apunta a cada uno por su nombre exacto.
+`recolocar` acepta `x`/`y` fuera del slide para que un objeto entre en escena.
 
 **Boosters y Boost Arenas** — colocarlos y configurarlos por nombre. `describir` te dice qué
 acepta cada uno antes de intentarlo, así que el agente no tiene que adivinar los campos.

package/dist/nucleo.mjs

@@ -1,5 +1,6 @@
 // ../src/insert/catalogos.ts
 var ILUS_BASE = "https://assets.boosterarena.com/ilustraciones";
+var ANIM_PRO_BASE = "https://assets.boosterarena.com/animados-pro";
 var FONDOS_BASE = "https://assets.boosterarena.com/fondos";
 var FLAG_ICONS = ["us", "gb", "mx", "ca", "es", "fr", "de", "it", "br", "jp", "cn", "kr", "in", "ru", "au", "nl", "pt", "ar", "co", "eg", "za", "sa", "tr", "gr"].map((c) => `circle-flags:${c}`);
 var ILLUS_ICONS = ["idea", "reading", "graduation-cap", "library", "planner", "calendar", "alarm-clock", "globe", "landscape", "gallery", "camera", "film", "music", "like", "rating", "sports-mode", "night-landscape", "panorama", "picture", "news", "document", "about", "conference-call", "voice-presentation"].map((n2) => `flat-color-icons:${n2}`);
@@ -67,6 +68,7 @@ var limpiarVacias = (ws) => {
   const utiles = ws.filter((w) => !VACIAS.has(w));
   return utiles.length ? utiles : ws;
 };
+var palabrasDeBusqueda = (q) => limpiarVacias(q.split(/[\s/,_-]+/).filter(Boolean)).map(raiz);
 var raiz = (w) => {
   if (w.length <= 3) return w;
   let r = w;
@@ -143,7 +145,7 @@ function cargarBiblioteca() {
   });
   return cargando;
 }
-var t\u00E9rminos = (consulta) => limpiarVacias(sinTildes(consulta).split(/\s+/).filter(Boolean)).map(raiz);
+var t\u00E9rminos = (consulta) => palabrasDeBusqueda(sinTildes(consulta));
 function mejorIlustracion(lista2, consulta) {
   if (!lista2.length) return null;
   const palabras = t\u00E9rminos(consulta);
@@ -231,6 +233,37 @@ function buscarFondo(consulta) {
     parecidos: h.parecidos.map((f) => f.nombre.es)
   };
 }
+var anims = null;
+async function cargarAnimaciones() {
+  if (anims?.length) return;
+  anims = await fetch(`${ANIM_PRO_BASE}/catalogo.json`, { cache: "no-cache" }).then((r) => r.ok ? r.json() : Promise.reject(new Error(String(r.status)))).then((j) => Array.isArray(j?.elementos) ? j.elementos : []).catch(() => []);
+}
+function buscarAnimacion(consulta) {
+  const lista2 = anims ?? [];
+  if (!lista2.length) return null;
+  const palabras = t\u00E9rminos(consulta);
+  const ordena = (a, b) => b.p - a.p || a.e.nombre.es.localeCompare(b.e.nombre.es);
+  let exacto = true;
+  let orden = lista2.map((e2) => ({ e: e2, p: palabras.length ? puntuar(e2, palabras) : 1 })).filter((x) => x.p > 0);
+  if (!orden.length) {
+    exacto = false;
+    orden = lista2.map((e2) => {
+      const d = puntuarDetalle(e2, palabras);
+      return { e: e2, p: d.encajadas * 1e3 + d.total };
+    }).filter((x) => x.p > 0);
+  }
+  if (!orden.length) return null;
+  orden.sort(ordena);
+  const e = orden[0].e;
+  return {
+    src: `${ANIM_PRO_BASE}/${e.archivo}`,
+    nombre: e.nombre.es,
+    plan: e.plan,
+    caja: { w: e.w, h: e.h, dw: e.dw, dh: e.dh },
+    exacto,
+    parecidos: orden.slice(1, 3).map((x) => x.e.nombre.es)
+  };
+}
 
 // ../src/shared/textEffects.ts
 var COLOR_EFFECTS = [
@@ -1330,7 +1363,7 @@ var efectosMov = MOTION_EFFECTS.map((e) => e.id);
 function construirCatalogo(opts) {
   const fn = (name, description, parameters) => ({ type: "function", function: { name, description, parameters } });
   const monedas = ["quitafondo", "magichat", "transformar"].filter((t) => opts.boosters.includes(t));
-  return [
+  const lista2 = [
     // ── PONER COSAS EN EL SLIDE ───────────────────────────────────────────────
     fn(
       "poner_texto",
@@ -1656,6 +1689,45 @@ function construirCatalogo(opts) {
       obj({ mensaje: str("Lo que le dices al maestro. Una o dos frases, en espa\xF1ol, en su tono.") }, ["mensaje"])
     )
   ];
+  return opts.sinNavegador ? conLoDelMcp(lista2, fn) : lista2;
+}
+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 programar = props("programar");
+  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).' };
+  programar.duracion = num('Solo con "moverPorTrayectoria": cu\xE1nto tarda el recorrido, en milisegundos. Sin esto, 2000.');
+  const fondo = props("poner_fondo");
+  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`.");
+  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(
+    "poner_lottie",
+    "Pone una ANIMACI\xD3N Lottie: de la galer\xEDa de animaciones de Booster (busc\xE1ndola por palabra) o una URL propia de un .json de Lottie. Hace de decoraci\xF3n (las esquinas) o de bot\xF3n: se programa con `programar` como cualquier objeto.",
+    obj({
+      ref: REF,
+      x: X,
+      y: Y,
+      w: W,
+      capa: CAPA,
+      busca: str('Qu\xE9 animaci\xF3n buscar en la galer\xEDa, en espa\xF1ol, ingl\xE9s o portugu\xE9s: "regalo", "trofeo", "estrella", "altavoz".'),
+      url: str("En vez de `busca`: la URL https:// de un Lottie .json (lottie.host, o uno subido).")
+    }, ["ref", "x", "y", "w"])
+  ));
+  return lista2;
 }
 
 // ../src/insert/shapes.ts
@@ -1711,6 +1783,33 @@ var FORMA_DEF = {
   blob: { anch: 26, alto: "cuadrado", color: "#c4b5fd" }
 };
 
+// ../src/canvas/audioVol.ts
+var AUDIO_VOL_INICIAL = 0.7;
+
+// ../src/canvas/bucleCapas.ts
+var alMostrar = (t) => t.event.type === "layerShown" || t.event.type === "slideStart";
+function capasQueAbre(t) {
+  return [t.action, ...(t.luego ?? []).map((p) => p.action)].filter((a) => a.type === "showLayer" && a.layerId).map((a) => a.layerId);
+}
+function abreAlMostrarse(slide, capaId) {
+  const capa = slide.layers.find((l) => l.id === capaId);
+  if (!capa) return [];
+  return capa.els.flatMap((el) => [...el.triggers ?? [], ...el.gtriggers ?? []]).filter(alMostrar).flatMap(capasQueAbre);
+}
+function abreEnBucle(slide, desde, t) {
+  if (!alMostrar(t)) return false;
+  const vistas = /* @__PURE__ */ new Set();
+  const pendientes = [...capasQueAbre(t)];
+  while (pendientes.length) {
+    const id = pendientes.pop();
+    if (id === desde) return true;
+    if (vistas.has(id)) continue;
+    vistas.add(id);
+    pendientes.push(...abreAlMostrarse(slide, id));
+  }
+  return false;
+}
+
 // ../src/shared/fontsAncho.ts
 var ANCHO_LETRA = {
   "Poppins": { 100: [712, 689], 200: [724, 692], 300: [736, 696], 400: [747, 699], 500: [760, 703], 600: [770, 708], 700: [782, 715], 800: [793, 723], 900: [805, 731] },
@@ -1849,11 +1948,28 @@ var ESQUEMAS_BOOSTERS = {
       campos: {
         images: lista("Las im\xE1genes que la varita saca una a una.", objeto("Una imagen.", {
           src: imagen("La imagen.", { obligatorio: true }),
-          label: texto("R\xF3tulo que se planta debajo. Vac\xEDo = sin r\xF3tulo.")
+          label: texto("R\xF3tulo que se planta con ella. Vac\xEDo = sin r\xF3tulo."),
+          dest: objeto("D\xD3NDE cae la imagen al salir de la varita, en % del slide. Sin esto, se reparten solas en filas de 4.", {
+            x: num2("Borde izquierdo, en % del ancho.", { entero: false, obligatorio: true }),
+            y: num2("Borde superior, en % del alto.", { entero: false, obligatorio: true }),
+            w: num2("Ancho, en % del ancho del slide. El alto sale de la imagen.", { entero: false, min: 2, max: 100, obligatorio: true })
+          }),
+          labelDest: objeto("D\xF3nde cae el R\xD3TULO, aparte de la imagen, en % del slide. Sin esto, justo debajo de ella.", {
+            x: num2("Borde izquierdo, en % del ancho.", { entero: false, obligatorio: true }),
+            y: num2("Borde superior, en % del alto.", { entero: false, obligatorio: true }),
+            w: num2("Ancho, en % del ancho del slide.", { entero: false, min: 2, max: 100, obligatorio: true })
+          }),
+          labelColor: color('Color del r\xF3tulo plantado. Sin esto, casi negro: sobre un fondo oscuro pon "#ffffff".')
         }), { max: 30 })
-      }
+      },
+      nota: "Pop-up City: cada lugar sale de la varita y cae en SU sitio de la ciudad con `dest`, y su r\xF3tulo en el suyo con `labelDest`."
     },
-    ejemplo: { images: [{ src: "https://assets.boosterarena.com/u/ej/cat.webp", label: "cat" }] }
+    ejemplo: {
+      images: [
+        { src: "https://assets.boosterarena.com/u/ej/cat.webp", label: "cat" },
+        { src: "https://assets.boosterarena.com/u/ej/bank.webp", label: "bank", dest: { x: 62, y: 40, w: 16 }, labelDest: { x: 62, y: 72, w: 16 }, labelColor: "#ffffff" }
+      ]
+    }
   },
   tombola: {
     donde: "wcfg.ext",
@@ -2759,8 +2875,12 @@ var slideDe = (b) => {
   return sc.slides[Math.min(b.slide, sc.slides.length - 1)];
 };
 function listaDestino(b, capa) {
-  const s = slideDe(b);
   const ref = txt(capa).trim();
+  if (!ref && slideDe(b).base.some((e) => e.kind === "arena")) {
+    nuevoSlide(b, "");
+    b.bitacora.push("\u{1F4C4} Slide nuevo: el de la arena es solo para la arena");
+  }
+  const s = slideDe(b);
   if (!ref) return { els: s.base };
   const capaObj = capaPorNombre(b, ref) ?? crearCapa(b, ref);
   b.capaDeTrabajo = capaObj.id;
@@ -2839,7 +2959,33 @@ function encajar(el) {
   el.y = +Math.max(0, Math.min(100 - el.h, el.y)).toFixed(2);
   return el;
 }
-function armarEvento(a, el) {
+function caminoPorNombre(suyas, nombre, estricto) {
+  const q = nombre.trim().toLowerCase();
+  if (!q) return suyas[0];
+  return suyas.find((m) => m.name.trim().toLowerCase() === q) ?? (estricto ? void 0 : suyas.find((m) => m.name.toLowerCase().includes(q)) ?? suyas[0]);
+}
+function puntosPedidos(a) {
+  const esPt = (p) => !!p && typeof p === "object" && Number.isFinite(p.x) && Number.isFinite(p.y);
+  const pts = Array.isArray(a.puntos) ? a.puntos.filter(esPt) : [];
+  if (esPt(a.hasta)) pts.push(a.hasta);
+  return pts.map((p) => ({ x: Math.max(-40, Math.min(140, p.x)), y: Math.max(-40, Math.min(140, p.y)) }));
+}
+function salidaDelCamino(el, movido, a) {
+  const paso = Math.round(num3(a.paso, 1));
+  if (txt(a.evento) !== "clickStep" || paso < 2) return { x: 0, y: 0 };
+  const previo = (el.triggers ?? []).find((t) => t.event.type === "clickStep" && t.event.step === paso - 1 && t.action.type === "playMotion" && t.action.targetId === movido.id);
+  const idPrevio = previo?.action.type === "playMotion" ? previo.action.motionId : "";
+  const cam = (movido.motions ?? []).find((m) => m.id === idPrevio);
+  return cam?.path.length ? { ...cam.path[cam.path.length - 1] } : { x: 0, y: 0 };
+}
+function trazarCamino(a, destinos) {
+  const r2 = (p) => ({ x: +p.x.toFixed(2), y: +p.y.toFixed(2) });
+  if (destinos.length > 1) return [a, ...destinos].map(r2);
+  const z = destinos[0];
+  const n2 = Math.max(4, Math.min(40, Math.round(Math.hypot(z.x - a.x, z.y - a.y) / 2.5)));
+  return Array.from({ length: n2 + 1 }, (_, i) => r2({ x: a.x + (z.x - a.x) * i / n2, y: a.y + (z.y - a.y) * i / n2 }));
+}
+function armarEvento(a, el, estricto) {
   switch (txt(a.evento)) {
     case "hover":
       return { type: "hover" };
@@ -2852,9 +2998,7 @@ function armarEvento(a, el) {
     case "clickStep":
       return { type: "clickStep", step: Math.max(1, Math.round(num3(a.paso, 1))) };
     case "trayectoriaTerminada": {
-      const nombre = txt(a.trayectoria).trim().toLowerCase();
-      const suyas = el.motions ?? [];
-      const cam = (nombre ? suyas.find((m) => m.name.toLowerCase().includes(nombre)) : void 0) ?? suyas[0];
+      const cam = caminoPorNombre(el.motions ?? [], txt(a.trayectoria), estricto);
       return cam ? { type: "motionEnd", motionId: cam.id } : { type: "click" };
     }
     default:
@@ -2910,10 +3054,32 @@ function armarAccion(b, a, el) {
       if (d && !quien) return { accion: null, fallo: `No encuentro el objeto "${d}" para moverlo.` };
       const movido = quien ?? buscarEl(b, txt(a.objetivo));
       if (!movido) return { accion: null, fallo: "No s\xE9 qu\xE9 objeto tiene que moverse." };
-      const nombre = txt(a.trayectoria).trim().toLowerCase();
+      const nombre = txt(a.trayectoria).trim();
       const suyas = movido.motions ?? [];
-      const cam = (nombre ? suyas.find((m) => m.name.toLowerCase().includes(nombre)) : void 0) ?? suyas[0];
+      const pts = puntosPedidos(a);
+      if (pts.length) {
+        const c = { x: movido.x + movido.w / 2, y: movido.y + movido.h / 2 };
+        const path = trazarCamino(salidaDelCamino(el, movido, a), pts.map((p) => ({ x: p.x - c.x, y: p.y - c.y })));
+        const duration = Math.round(Math.max(200, Math.min(6e4, num3(a.duracion, 2e3))));
+        const igual = nombre ? suyas.find((m) => m.name.trim().toLowerCase() === nombre.toLowerCase()) : void 0;
+        if (igual) {
+          igual.path = path;
+          igual.duration = duration;
+        } else {
+          let n2 = suyas.length + 1;
+          while (suyas.some((m) => m.name === `Trayectoria ${n2}`)) n2 += 1;
+          movido.motions = [...suyas, { id: nid("mo"), name: nombre || `Trayectoria ${n2}`, path, duration }];
+        }
+        const cam2 = igual ?? movido.motions[movido.motions.length - 1];
+        b.tocados.push(movido.id);
+        b.bitacora.push(`\u219D ${describirEl(movido)}: camino \xAB${cam2.name}\xBB${igual ? " retrazado" : ""}`);
+        return { accion: { type: "playMotion", targetId: movido.id, motionId: cam2.id } };
+      }
+      const cam = caminoPorNombre(suyas, nombre, b.estricto);
       if (cam) return { accion: { type: "playMotion", targetId: movido.id, motionId: cam.id } };
+      if (b.estricto) {
+        return { accion: null, fallo: `${nombre && suyas.length ? `${describirEl(movido)} no tiene ning\xFAn camino \xAB${nombre}\xBB (tiene: ${suyas.map((m) => `\xAB${m.name}\xBB`).join(", ")}). ` : ""}Para trazarlo, pasa \`hasta\` {x, y} \u2014a d\xF3nde llega el centro del objeto, en % del slide\u2014 o \`puntos\`.` };
+      }
       const nuevo = { id: nid("mo"), name: txt(a.trayectoria) || "Trayectoria 1", path: [], duration: 2e3 };
       movido.motions = [...suyas, nuevo];
       b.tocados.push(movido.id);
@@ -2951,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": {
@@ -3108,6 +3293,36 @@ El ref "${refBase}" es el rengl\xF3n grande; cada uno es tambi\xE9n "${refBase}_
       b.bitacora.push(`\u{1F5BC}\uFE0F Imagen subida${dentroDe ? ` en la capa \xAB${dentroDe}\xBB` : ""}`);
       return `Puesta la imagen (id ${el.id}).`;
     }
+    // Solo lo ofrece el MCP (`catalogo.ts`, `sinNavegador`): el Robot no pone animaciones.
+    case "poner_lottie": {
+      const url = txt(args.url).trim();
+      const busca = txt(args.busca).trim();
+      if (!url && !busca) return no(b, "Dime qu\xE9 animaci\xF3n buscar (`busca`) o p\xE1same la `url` de un Lottie.");
+      if (url && !/^https?:\/\//i.test(url)) return no(b, "La `url` tiene que ser una direcci\xF3n https:// de un .json de Lottie.");
+      const hallada = url ? null : buscarAnimacion(busca);
+      if (!url && !hallada) {
+        return no(b, `La galer\xEDa de animaciones no tiene nada parecido a "${busca}" (o no contest\xF3). Prueba otra palabra, en singular, o pon un dibujo con \`poner_dibujo\`.`);
+      }
+      if (hallada?.plan === "pro" && !b.premium) {
+        return no(b, `La animaci\xF3n \xAB${hallada.nombre}\xBB es del plan Pro y esta cuenta no lo tiene. Se activa desde boosterarena.com.`);
+      }
+      const w = pct(args.w, 20);
+      const prop = hallada?.caja.w && hallada.caja.h ? hallada.caja.w / hallada.caja.h : 1;
+      const el = encajar({
+        id: nid("lottie"),
+        kind: "lottie",
+        x: pct(args.x, 40),
+        y: pct(args.y, 30),
+        w,
+        h: +(w / prop * (1920 / 1080)).toFixed(1),
+        src: hallada?.src ?? url
+      });
+      const { dentroDe } = plantar(b, el, args.ref, args.capa);
+      b.bitacora.push(`\u2728 Animaci\xF3n ${hallada ? `\xAB${hallada.nombre}\xBB` : "propia"}${dentroDe ? ` en la capa \xAB${dentroDe}\xBB` : ""}`);
+      if (!hallada) return `Animaci\xF3n puesta (id ${el.id}).`;
+      const otros = hallada.parecidos.length ? ` Otras parecidas: ${hallada.parecidos.map((x) => `"${x}"`).join(", ")}.` : "";
+      return hallada.exacto ? `Animaci\xF3n "${hallada.nombre}" puesta (id ${el.id}, exacto: true).${otros}` : `Animaci\xF3n "${hallada.nombre}" puesta (id ${el.id}, exacto: false). \u26A0\uFE0F OJO: no hay ninguna que sea "${busca}"; es la m\xE1s cercana.${otros}`;
+    }
     case "poner_audio": {
       const url = txt(args.url).trim();
       if (!/^https?:\/\//i.test(url)) {
@@ -3121,7 +3336,8 @@ El ref "${refBase}" es el rengl\xF3n grande; cada uno es tambi\xE9n "${refBase}_
         w: 16,
         h: 7,
         src: url,
-        name: txt(args.nombre) || "Audio"
+        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`);
@@ -3206,21 +3422,35 @@ El ref "${refBase}" es el rengl\xF3n grande; cada uno es tambi\xE9n "${refBase}_
     case "poner_fondo": {
       const color2 = txt(args.color).trim();
       const busca = txt(args.busca).trim();
+      const url = txt(args.url).trim();
+      const refCapa = txt(args.capa).trim();
+      const capa = refCapa ? capaPorNombre(b, refCapa) : void 0;
+      if (refCapa && !capa) {
+        return no(b, `No hay ninguna capa "${refCapa}" en este slide. Cr\xE9ala antes con \`nueva_capa\` (que tambi\xE9n acepta \`fondo\`).`);
+      }
+      const destino = capa ?? slideDe(b);
+      const d\u00F3nde = capa ? ` de la capa \xAB${capa.name}\xBB` : "";
+      if (url) {
+        if (!/^https?:\/\//i.test(url)) return no(b, "La `url` tiene que ser una imagen ya SUBIDA (https://). S\xFAbela antes con `subir_imagen`.");
+        destino.background = url;
+        b.bitacora.push(`\u{1F3DE}\uFE0F Fondo propio${d\u00F3nde}`);
+        return `Fondo${d\u00F3nde} puesto con esa imagen.`;
+      }
       if (busca) {
         const f = buscarFondo(busca);
         if (!f) return no(b, `No hay ning\xFAn fondo parecido a "${busca}". Puedes poner un color liso.`);
-        slideDe(b).background = f.src;
-        b.bitacora.push(`\u{1F3DE}\uFE0F Fondo: ${f.nombre}`);
+        destino.background = f.src;
+        b.bitacora.push(`\u{1F3DE}\uFE0F Fondo${d\u00F3nde}: ${f.nombre}`);
         const otros = f.parecidos.length ? ` Otros parecidos: ${f.parecidos.map((x) => `"${x}"`).join(", ")}.` : "";
-        return f.exacto ? `Fondo puesto: "${f.nombre}" (exacto: true).${otros}` : `Fondo puesto: "${f.nombre}" (exacto: false). \u26A0\uFE0F OJO: no hay ning\xFAn fondo que sea "${busca}"; es lo m\xE1s cercano.${otros} Si no sirve, prueba otra palabra o pon un color liso.`;
+        return f.exacto ? `Fondo${d\u00F3nde} puesto: "${f.nombre}" (exacto: true).${otros}` : `Fondo${d\u00F3nde} puesto: "${f.nombre}" (exacto: false). \u26A0\uFE0F OJO: no hay ning\xFAn fondo que sea "${busca}"; es lo m\xE1s cercano.${otros} Si no sirve, prueba otra palabra o pon un color liso.`;
       }
       if (!color2) return no(b, "Dime un color o una escena a buscar.");
       if (!COLOR_DE_FONDO.test(color2)) {
         return no(b, `"${color2}" no es un color que el slide sepa pintar. M\xE1ndalo en hex ("#0f172a"), rgb(), hsl() o como un degradado CSS.`);
       }
-      slideDe(b).background = color2;
-      b.bitacora.push(`\u{1F3A8} Fondo ${color2}`);
-      return "Fondo de color puesto.";
+      destino.background = color2;
+      b.bitacora.push(`\u{1F3A8} Fondo ${color2}${d\u00F3nde}`);
+      return `Fondo de color${d\u00F3nde} puesto.`;
     }
     case "poner_booster": {
       const tipo = txt(args.tipo);
@@ -3348,6 +3578,12 @@ ${fallosEnTexto(r.fallos)}
 
 Pide \`describir("${el.widget}")\` para ver la forma exacta y vuelve a intentarlo.`);
       }
+      if (el.widget === "magicwand") {
+        const imgs = cfg.valor.images ?? [];
+        imgs.forEach((im) => {
+          if (!im.id) im.id = nid("wand");
+        });
+      }
       el.wcfg = ficha.donde === "wcfg.ext" ? { ...el.wcfg, ext: cfg.valor } : { ...el.wcfg?.ext ? { ext: el.wcfg.ext } : {}, ...cfg.valor };
       b.tocados.push(el.id);
       b.bitacora.push(`\u270E Booster ${el.widget} configurado`);
@@ -3361,9 +3597,14 @@ Pide \`describir("${el.widget}")\` para ver la forma exacta y vuelve a intentarl
     }
     case "nueva_capa": {
       const r = txt(args.ref).trim();
+      const fondo = txt(args.fondo).trim();
+      if (fondo && !/^https?:\/\//i.test(fondo) && !COLOR_DE_FONDO.test(fondo)) {
+        return no(b, `"${fondo}" no sirve de fondo: tiene que ser la URL https:// de una imagen ya subida o un color en hex.`);
+      }
       const capa = crearCapa(b, txt(args.nombre) || r);
       if (r) b.aliasCapa.set(r, capa.id);
-      return `Capa "${capa.name}" creada. Para poner cosas dentro, p\xE1sale capa="${r || capa.name}".`;
+      if (fondo) capa.background = fondo;
+      return `Capa "${capa.name}" creada${fondo ? " con su fondo" : ""}. Para poner cosas dentro, p\xE1sale capa="${r || capa.name}".`;
     }
     case "nueva_escena": {
       const nombre2 = txt(args.nombre) || `Escena ${b.doc.length + 1}`;
@@ -3389,9 +3630,22 @@ Pide \`describir("${el.widget}")\` para ver la forma exacta y vuelve a intentarl
         b.bitacora.push(`\u{1F9F9} Sin programaci\xF3n: ${describirEl(el)}`);
         return `Le quit\xE9 ${n0} disparador(es).`;
       }
+      if (el.kind === "widget" || el.kind === "arena") {
+        return no(b, `${describirEl(el)} es un booster o una arena: no lleva disparadores, ya trae su propio funcionamiento. Programa otro objeto del slide (un texto, una imagen, un bot\xF3n).`);
+      }
       const { accion, fallo } = armarAccion(b, args, el);
       if (!accion) return no(b, fallo ?? "No entend\xED qu\xE9 acci\xF3n quer\xEDas.");
-      const trig = { id: nid("trig"), event: armarEvento(args, el), action: accion };
+      if (b.estricto && txt(args.evento) === "trayectoriaTerminada" && !caminoPorNombre(el.motions ?? [], txt(args.trayectoria), true)) {
+        return no(b, `${describirEl(el)} no tiene ${txt(args.trayectoria) ? `ning\xFAn camino \xAB${txt(args.trayectoria)}\xBB` : "ning\xFAn camino"}, as\xED que \xABal terminar su trayectoria\xBB no tendr\xEDa cu\xE1ndo dispararse. Progr\xE1male antes \`moverPorTrayectoria\` con \`hasta\`.`);
+      }
+      const trig = { id: nid("trig"), event: armarEvento(args, el, b.estricto), action: accion };
+      if (trig.event.type === "motionEnd" && accion.type === "playMotion" && trig.event.motionId === accion.motionId) {
+        return no(b, "Eso har\xEDa un BUCLE: al terminar el camino volver\xEDa a empezar el mismo camino, sin fin. Si quieres que d\xE9 vueltas, usa otro evento; si quieres encadenar, dale otro nombre al segundo camino.");
+      }
+      const capaDelEl = slideDe(b).layers.find((l) => l.els.some((e) => e.id === el.id));
+      if (capaDelEl && abreEnBucle(slideDe(b), capaDelEl.id, trig)) {
+        return no(b, `Eso har\xEDa un BUCLE: al mostrarse la capa \xAB${capaDelEl.name}\xBB se volver\xEDa a abrir a s\xED misma sin parar y la clase se congelar\xEDa. Usa otra capa, \`cerrarCapa\` o el evento de clic.`);
+      }
       el.triggers = args.primero === true ? [trig, ...el.triggers ?? []] : [...el.triggers ?? [], trig];
       b.tocados.push(el.id);
       b.bitacora.push(`\u26A1 ${describirEl(el)}: ${describirTrigger(trig, b)}`);
@@ -3411,12 +3665,13 @@ 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);
-      if (typeof args.x === "number") el.x = pct(args.x, el.x);
-      if (typeof args.y === "number") el.y = pct(args.y, el.y);
-      encajar(el);
+      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);
       b.bitacora.push(`\u2194\uFE0F Recolocado: ${describirEl(el)}`);
-      return "Movido.";
+      return afuera ? "Movido. Qued\xF3 FUERA del slide: no se ve hasta que una trayectoria lo meta." : "Movido.";
     }
     case "cambiar_estilo": {
       const el = buscarEl(b, txt(args.objetivo));
@@ -3438,6 +3693,7 @@ Pide \`describir("${el.widget}")\` para ver la forma exacta y vuelve a intentarl
       if (txt(args.align)) el.align = txt(args.align);
       if (typeof args.opacidad === "number") el.opacity = Math.max(0, Math.min(1, args.opacidad));
       if (typeof args.giro === "number") el.rot = args.giro || void 0;
+      if (typeof args.gris_al_tocar === "boolean") el.grayClick = args.gris_al_tocar || void 0;
       b.tocados.push(el.id);
       b.bitacora.push(`\u{1F3A8} Retocado: ${describirEl(el)}`);
       return "Estilo cambiado.";
@@ -4026,6 +4282,7 @@ export {
   FORMA_DEF,
   buscarDibujo,
   buscarFondo,
+  cargarAnimaciones,
   cargarBiblioteca,
   construirArena,
   construirCatalogo,

package/package.json

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

package/proyectos.mjs

@@ -50,7 +50,8 @@ async function pedir(token, ruta, opciones = {}) {
 
 /** Los proyectos del maestro, del más reciente al más viejo. Sin el documento. */
 export async function listar(token, { tipo, limite = 50 } = {}) {
-  const q = new URLSearchParams({ select: COLUMNAS_LISTA, order: 'updated_at.desc', limit: String(limite) });
+  // `deleted_at=is.null`: lo que el maestro mandó a la Papelera no se lista.
+  const q = new URLSearchParams({ select: COLUMNAS_LISTA, order: 'updated_at.desc', limit: String(limite), deleted_at: 'is.null' });
   if (tipo) q.set('type', `eq.${tipo}`);
   return pedir(token, `projects?${q}`);
 }

package/servidor.mjs

@@ -138,6 +138,7 @@ function herramientasDelLienzo() {
     boosters: nucleo.ALL_WIDGETS.filter((w) => w.ready).map((w) => w.type),
     arenas: nucleo.ARENAS.filter((a) => a.ready).map((a) => a.type),
     formas: Object.keys(nucleo.FORMA_DEF),
+    sinNavegador: true,  // trazar trayectorias, lotties, fondos por URL y en capas, gris al tocar
   }).map((t) => ({
     name: t.function.name,
     description: t.function.description,
@@ -281,6 +282,7 @@ function queEs(e) {
   if (e.kind === 'arena') return `ARENA ${e.arena}`;
   if (e.kind === 'widget') return `booster ${e.widget}${e.widget === 'instructions' ? ` «${corto(e.wcfg?.ext?.title, 24)}»` : ''}`;
   if (e.kind === 'image') return 'imagen';
+  if (e.kind === 'lottie') return 'animación';
   if (e.kind === 'audio') return `audio «${corto(e.name, 24)}»`;
   if (e.kind === 'shape' && e.shape === 'button') return `botón «${corto(e.text, 24)}»`;
   if (e.kind === 'shape' && e.hotspot) return 'zona caliente';
@@ -294,6 +296,14 @@ function queHace(t, doc, slide) {
   const cuando = { click: 'al tocarlo', hover: 'al pasar encima', slideStart: 'al entrar al slide',
     layerShown: 'al abrirse su capa', time: `a los ${ev.seconds} s`, clickStep: `en el clic ${ev.step}`,
     motionEnd: 'al terminar su trayectoria' }[ev.type] ?? ev.type;
+  // El nombre del camino, que es por lo que se le apunta: «al terminar "Trayectoria 2"».
+  const camino = (id) => {
+    for (const x of [...slide.base, ...slide.layers.flatMap((l) => l.els)]) {
+      const m = (x.motions ?? []).find((mm) => mm.id === id);
+      if (m) return `«${m.name}»`;
+    }
+    return 'su trayectoria';
+  };
   const a = t.action ?? {};
   const capa = (id) => slide.layers.find((l) => l.id === id)?.name ?? id;
   const qué = a.type === 'showLayer' ? `abre la capa «${capa(a.layerId)}»`
@@ -304,17 +314,22 @@ function queHace(t, doc, slide) {
             : a.type === 'speak' ? `lee «${corto(a.text, 24)}»`
               : a.type === 'openUrl' ? `abre ${a.url}`
                 : a.type === 'hideEl' ? `oculta ${a.targetId || 'el objeto'}`
-                  : a.type === 'playMotion' ? 'recorre su trayectoria'
+                  : a.type === 'playMotion' ? `recorre ${camino(a.motionId)}${a.targetId !== t.ownerId ? ` (${a.targetId})` : ''}`
                     : a.type;
   const luego = (t.luego ?? []).length ? ` (+${t.luego.length} en cadena)` : '';
-  return `${cuando} → ${qué}${luego}`;
+  return `${ev.type === 'motionEnd' ? `al terminar ${camino(ev.motionId)}` : cuando} → ${qué}${luego}`;
 }
 
 function listarEls(els, doc, slide, sangria) {
   const filas = [];
   for (const e of els) {
-    filas.push(`${sangria}· ${queEs(e)}  [${e.id}]`);
-    for (const t of e.triggers ?? []) filas.push(`${sangria}    ⚡ ${queHace(t, doc, slide)}`);
+    const donde = `@${Math.round(e.x)},${Math.round(e.y)} ${Math.round(e.w)}×${Math.round(e.h)}`;
+    filas.push(`${sangria}· ${queEs(e)}  ${donde}${e.grayClick ? '  · gris al tocar' : ''}  [${e.id}]`);
+    for (const m of e.motions ?? []) {
+      const fin = m.path[m.path.length - 1];
+      filas.push(`${sangria}    ↝ «${m.name}» ${m.duration} ms${fin ? `, termina desplazado (${Math.round(fin.x)}, ${Math.round(fin.y)})` : ' — ⚠️ SIN CAMINO: no se mueve'}`);
+    }
+    for (const t of e.triggers ?? []) filas.push(`${sangria}    ⚡ ${queHace({ ...t, ownerId: e.id }, doc, slide)}`);
   }
   return filas;
 }
@@ -330,7 +345,7 @@ function resumenDelDoc(doc, { escena, slide } = {}) {
       filas.push(`  slide ${j + 1}${s.name ? ` «${s.name}»` : ''}${fondo}${s.base.length || s.layers.length ? '' : ' (vacío)'}`);
       filas.push(...listarEls(s.base, doc, s, '    '));
       for (const l of s.layers) {
-        filas.push(`    ▣ capa «${l.name}» [${l.id}] — ${l.els.length} objeto(s)${l.background ? ` · fondo ${l.background}` : ''}`);
+        filas.push(`    ▣ capa «${l.name}» [${l.id}] — ${l.els.length} objeto(s)${l.background ? ` · fondo ${/^https?:/.test(l.background) ? 'imagen' : l.background}` : ''}`);
         filas.push(...listarEls(l.els, doc, s, '        '));
       }
     });
@@ -370,7 +385,9 @@ 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
-    await nucleo.cargarBiblioteca();  // `poner_dibujo` busca en caliente
+    yo.borrador.premium = yo.plan === 'pro';
+    // `poner_dibujo`, `poner_fondo` y `poner_lottie` buscan en caliente.
+    await Promise.all([nucleo.cargarBiblioteca(), nucleo.cargarAnimaciones()]);
     // El id va en la PRIMERA línea y con su nombre: antes no venía y había que llamar a
     // `listar_proyectos` y buscar por título, que con ocho pilotos de nombre parecido es jugársela.
     // No hay URL propia de un proyecto: el editor no abre proyectos por dirección, se entra desde la