sagadeck 1.9.0 → 1.11.0

package/src/studio/generation-request.js

@@ -0,0 +1,80 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { llmConfig } from '../ai/llm.js';
+import { loadPreferences } from '../preferences.js';
+import { renameRetry } from '../fs-retry.js';
+
+// O pedido que originou a apresentação (.sagadeck/geracao.json), para dar para auditar depois: foi um prompt ou um
+// material? o que a pessoa pediu? Grava o briefing exatamente como foi para a IA (e se era o texto padrão da tela),
+// a resposta à pergunta da IA, duração, estilo, os anexos (nome, tipo, tamanho, onde ficaram em contexto/), as
+// Preferências que mudam a geração e os modelos. Nada de chave: do provedor, só o endereço sem usuário e senha.
+// Recriar pelo chat grava por cima; o pedido anterior vai para `anteriores` (os 10 últimos).
+export const REQUEST_FILE = path.join('.sagadeck', 'geracao.json');
+
+const text = (v, max = 20000) => (v == null || v === '' ? undefined : String(v).slice(0, max));
+const num = (v) => (Number(v) > 0 ? Number(v) : undefined);
+const clean = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
+
+// onde o anexo ficou guardado (mesma pasta de prepareDocumentMaterials: contexto/documentos/<sha256 12>/<nome>)
+function storedPath(dir, name, bytes) {
+  if (!bytes) return undefined;
+  const hash = crypto.createHash('sha256').update(bytes).digest('hex').slice(0, 12);
+  const rel = ['contexto', 'documentos', hash, path.basename(name)].join('/');
+  return fs.existsSync(path.join(dir, ...rel.split('/'))) ? rel : undefined;
+}
+
+function material(dir, m) {
+  const name = String(m.name || '');
+  const ext = path.extname(name).slice(1).toLowerCase();
+  return clean({
+    nome: name,
+    tipo: /^https?:/i.test(name) ? 'link' : ext || 'texto',
+    detalhe: text(m.detail, 200),
+    tamanho: m.bytes ? m.bytes.length : undefined, // bytes do arquivo anexado
+    caracteres: String(m.text || '').length || undefined, // texto que a IA leu
+    caminho: storedPath(dir, name, m.bytes),
+  });
+}
+
+// o endereço do provedor, sem usuário, senha nem parâmetros (onde às vezes vai uma chave)
+function provider(cfg) {
+  if (cfg.adaptador) return 'adaptador';
+  try { const u = new URL(cfg.url); return `${u.protocol}//${u.host}${u.pathname.replace(/\/+$/, '')}`; } catch { return undefined; }
+}
+
+// origem: "biblioteca" | "editor" | "chat"; pedido: o corpo do pedido (briefing, answer, duration, style…);
+// materials: os anexos como vieram (com bytes); spec: a apresentação gerada (tema e título finais)
+export function saveGenerationRequest(dir, { origem, pedido = {}, materials = [], spec = null, research = null, prefs = loadPreferences().ia, cfg = llmConfig() } = {}) {
+  if (!dir) return null;
+  const guide = pedido.guide && typeof pedido.guide === 'object' ? pedido.guide : {};
+  const entry = clean({
+    data: new Date().toISOString(),
+    origem,
+    briefing: String(pedido.briefing || ''),
+    briefingPadrao: !!guide.padrao,
+    guia: clean({ intencao: text(guide.intent, 40), publico: text(guide.audience, 500), objetivo: text(guide.goal, 500), roteiro: text(guide.route, 40) }),
+    resposta: text(pedido.answer, 500),
+    duracao: num(pedido.duration),
+    slides: num(pedido.slides),
+    tema: text(pedido.theme, 80),
+    estilo: text(pedido.style, 80),
+    direcao: text(pedido.direction && typeof pedido.direction === 'object' ? JSON.stringify(pedido.direction) : pedido.direction, 4000),
+    materiais: materials.map((m) => material(dir, m)),
+    preferencias: clean({ idioma: prefs?.idioma || 'auto', imagens: prefs?.imagens !== false, pesquisa: prefs?.pesquisa !== false, perguntar: prefs?.perguntar !== false, autor: text(prefs?.autor, 120) }),
+    pesquisa: research?.fontes?.length ? research.fontes.map((f) => clean({ site: text(f.site, 200), url: text(f.url, 500) })) : undefined,
+    modelos: clean({ texto: cfg.textModel, visao: cfg.visionModel, imagem: cfg.imageModel, busca: cfg.searchModel || undefined }),
+    provedor: provider(cfg),
+    resultado: spec ? clean({ titulo: text(spec.title, 200), tema: text(spec.theme, 80), slides: Array.isArray(spec.slides) ? spec.slides.length : undefined }) : undefined,
+  });
+  if (!Object.keys(entry.guia).length) delete entry.guia;
+  const file = path.join(dir, REQUEST_FILE);
+  let anteriores = [];
+  try { const old = JSON.parse(fs.readFileSync(file, 'utf8')); anteriores = [{ ...old, anteriores: undefined }, ...(old.anteriores || [])].slice(0, 10); } catch { /* primeiro pedido */ }
+  fs.mkdirSync(path.dirname(file), { recursive: true });
+  const out = { ...entry, ...(anteriores.length ? { anteriores: JSON.parse(JSON.stringify(anteriores)) } : {}) };
+  const tmp = `${file}.tmp-${process.pid}`;
+  fs.writeFileSync(tmp, JSON.stringify(out, null, 2), 'utf8');
+  renameRetry(tmp, file);
+  return out;
+}

package/src/studio/ia-routes.js

@@ -52,7 +52,7 @@ export async function iaRoutes({ req, res, pathname, opts, readJSON }) {
     // testar: uma pergunta curta com o que está na tela (antes de salvar)
     const base = llmConfig();
     const cfg = { ...base, url: next.url.replace(/\/+$/, ""), key: keyOf(next), headers: next.headers || {}, adaptador: next.adaptador || "",
-      textModel: next.models.text, visionModel: next.models.vision || next.models.text, imageModel: next.models.image || "image", searchModel: next.models.search || "",
+      textModel: next.models.text, visionModel: next.models.vision || next.models.text, imageModel: next.models.image || "image", searchModel: next.models.search || "", checkModel: next.models.check || next.models.text,
       timeoutMs: 60_000, firstTimeoutMs: 60_000 };
     const t0 = Date.now();
     try {

package/src/studio/layout-samples.js

@@ -143,7 +143,7 @@ export const LAYOUT_SAMPLES = {
   decisionlab: {layout:"decisionlab", title:"A revisão melhora o resultado?", lab:{volume:10000,errorRate:2,reviewRate:100,catchRate:60,introducedRate:0.2,seconds:30}},
   infographic: { layout: "infographic", shape: "arco", title: "Os ==desafios== da viagem", center: { title: "Desafios" }, items: [{ title: "Roteiro", text: "Três cidades em dez dias" }, { title: "Orçamento", text: "Hospedagem pesa mais" }, { title: "Documentos", text: "Passaporte e visto" }, { title: "Clima", text: "Chuva na segunda semana" }] },
   diagram: { layout: "diagram", kicker: "Processo", title: "Da ideia à ==produção==", mermaid: "flowchart LR\n  A([:lightbulb: Ideia]):::hi --> B{Vale testar?}\n  B -->|sim| C[:flask-conical: Protótipo]\n  B -.->|não| X[Arquivar]:::vazado\n  C ==> D[:rocket: Produção]:::em" },
-  solution: {layout:"solution", title:"Exercício: quanto rende em 3 anos?", problem:"R$ 1.000 aplicados a 1% ao mês, com juros compostos. Quanto há depois de 36 meses?", givens:[{symbol:"C", value:"1000", unit:"R\\$", label:"capital"}, {symbol:"i", value:"0,01", label:"taxa ao mês"}, {symbol:"n", value:"36", label:"meses"}], find:"M", steps:[{text:"Juros compostos", latex:"M = C\\,(1 + i)^n"}, {text:"Substitui os dados", latex:"M = 1000 \\cdot 1{,}01^{36}"}, {text:"Calcula a potência", latex:"1{,}01^{36} \\approx 1{,}4308"}], answer:{latex:"M \\approx R\\$\\,1.430{,}77", text:"Rende cerca de 43% em 3 anos."}},
+  solution: {layout:"solution", title:"Exercício: quanto rende em 3 anos?", problem:"R$ 1.000 aplicados a 1% ao mês, com juros compostos. Quanto há depois de 36 meses?", givens:[{symbol:"C", value:"1000", unit:"R\\$", label:"capital"}, {symbol:"i", value:"0,01", label:"taxa ao mês"}, {symbol:"n", value:"36", label:"meses"}], find:"M", steps:[{text:"Juros compostos", latex:"M = C\\,(1 + i)^n"}, {text:"Calcula o fator", latex:"(1 + i)^n = (1 + {{i}})^{ {{n}} }", fn:"(1+i)^n", name:"fator", decimals:4}, {text:"Multiplica pelo capital", latex:"M = {{C}} \\cdot {{fator}}", fn:"C*fator", name:"M", decimals:2}], answer:{latex:"M \\approx R\\$\\,{{M}}", text:"Rende cerca de {{(M/C - 1)*100:0}}% em {{n}} meses."}, interactive:true},
   calc: {layout:"calc", title:"Qual é o regime do escoamento?", inputs:{V:{label:"Velocidade", latex:"V", value:1.5, min:0.01, max:4, step:0.01, unit:"m/s"}, D:{label:"Diâmetro", latex:"D", value:0.05, min:0.005, max:0.3, step:0.005, unit:"m"}, nu:{label:"Viscosidade (água, 20 °C)", latex:"\\nu = 1{,}0\\times10^{-6}\\ \\mathrm{m^2/s}", value:0.000001, fixed:true}}, outputs:[{name:"Re", label:"Número de Reynolds", latex:"Re = \\frac{VD}{\\nu}", fn:"V*D/nu", decimals:0}, {name:"regime", label:"Regime", of:"Re", cases:[{below:2300, text:"Laminar", color:"s3"}, {below:4000, text:"Transição", color:"em"}, {text:"Turbulento", color:"hi"}], scale:{min:100, max:1000000, log:true}}]},
   algo: {layout:"algo", title:"Bubble sort passo a passo", algorithm:"bubble", array:[5, 1, 4, 2, 8, 3]},
   carousel: {layout:"carousel", title:"Cinco lugares, cinco lições", style:"arc", items:[{title:"Montanha", text:"Subir devagar é o jeito mais rápido de chegar.", label:"Capítulo 1"}, {title:"Mar", text:"Tudo o que é fundo começa raso."}, {title:"Cidade", text:"Muita gente, muita luz, pouco silêncio."}, {title:"Deserto", text:"Onde o pouco vira muito."}, {title:"Floresta", text:"Cada árvore conta uma história."}]},

package/src/studio/library-routes.js

@@ -9,6 +9,7 @@ import { writeDeckFile } from "../deck-file.js";
 import { createExperienceDeck } from "../experiences.js";
 import { demoDeck } from "./demo-decks.js";
 import { DEMO_FILES } from "../api-demo.js";
+import { developerStarter } from "./developer-starters.js";
 
 export async function libraryRoutes({ req, res, pathname, url, W, opts, readJSON, readBody, slideSnapshots, sendExport, galleryKey, galleryEntry, materializePreview, copyModelAssets, generateIntoLibrary, llmAvailable, llmConfig, respond, templateFile, TEMPLATE_DIRS }) {
   const L = W.library;
@@ -74,6 +75,12 @@ export async function libraryRoutes({ req, res, pathname, url, W, opts, readJSON
       case "/api/library/topics/update": return ok({ id: L.updateTopic(b.id, b) });
       case "/api/library/topics/delete": L.deleteTopic(b.id); return ok();
       case "/api/library/decks": {
+        if (b.starter) {
+          const spec = developerStarter(b.starter, { title: b.title });
+          if (b.theme) spec.theme = b.theme;
+          buildHTML(spec);
+          return ok({ id: L.createDeck(b.topic || "", spec) });
+        }
         // nova: em branco (uma capa) — "com IA" usa /api/library/decks/ai
         const title = String(b.title || "Nova apresentação").trim();
         const id = L.createDeck(b.topic || "", { title, theme: b.theme || "bauhaus", duration: 10,

package/src/studio/public/about.js

@@ -0,0 +1,68 @@
+// "Sobre o SagaDeck" (Ajuda › Sobre, no editor; botão Sobre, na biblioteca): a versão que está rodando e o essencial
+// para dar suporte (commit, Node, desde quando, a biblioteca, se a IA está configurada), com Copiar informações.
+window.SagaAbout = (() => {
+  // as cores vêm das variáveis que o editor e a biblioteca definem nos dois temas (claro e escuro); fundo e texto
+  // sempre do mesmo par, senão o tema escuro dá texto claro sobre fundo branco
+  const css = `.about-dlg{margin:auto;max-width:min(520px,calc(100vw - 32px));width:100%;border:1px solid var(--ui-line,#c9ced6);border-radius:12px;padding:20px 22px;background:var(--chrome,#fff);color:var(--text,#1d2433);font:14px/1.45 system-ui,sans-serif;box-shadow:0 20px 60px #0004}
+.about-dlg::backdrop{background:rgba(0,0,0,.45)}.about-dlg h2{margin:0;font-size:20px;color:var(--text,#1d2433)}.about-dlg .ver{margin:2px 0 14px;font-size:15px;color:var(--text-2,#555)}
+.about-dlg .ver b{color:var(--text,#1d2433);font-size:22px}.about-dlg dl{display:grid;grid-template-columns:auto 1fr;gap:6px 14px;margin:0 0 14px}
+.about-dlg dt{color:var(--text-2,#555)}.about-dlg dd{margin:0;overflow-wrap:anywhere;color:var(--text,#1d2433)}.about-dlg code{font:12px ui-monospace,Consolas,monospace;color:inherit}
+.about-dlg .links{display:flex;gap:14px;flex-wrap:wrap;margin:0 0 6px}.about-dlg .links a{color:var(--brand,#5b4bdb)}
+.about-dlg .row{display:flex;gap:8px;justify-content:flex-end;margin-top:14px}.about-dlg button{padding:7px 14px;border-radius:8px;border:1px solid var(--ui-line,#c9ced6);background:transparent;color:var(--text,#1d2433);cursor:pointer;font:inherit}
+.about-dlg button.primary{background:var(--brand-fill,#5b4bdb);border-color:var(--brand-fill,#5b4bdb);color:#fff}.about-dlg [data-copied]{color:var(--text-2,#555);align-self:center;margin-right:auto}`;
+  const REPO = "https://github.com/naruminho/sagadeck";
+  const esc = (s) => String(s ?? "").replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+  let dialog;
+
+  function build() {
+    if (!document.getElementById("about-style")) { const st = document.createElement("style"); st.id = "about-style"; st.textContent = css; document.head.append(st); }
+    dialog = document.createElement("dialog");
+    dialog.className = "about-dlg";
+    dialog.id = "about-dialog";
+    dialog.setAttribute("aria-labelledby", "about-title");
+    document.body.append(dialog);
+  }
+
+  // o que o servidor diz de si (versão, commit, Node, desde quando) e se a IA está configurada
+  async function facts() {
+    const get = async (u) => { try { const r = await fetch(u, { cache: "no-store" }); return r.ok ? r.json() : {}; } catch { return {}; } };
+    const [inst, ia] = await Promise.all([get("api/instance"), get("api/ia")]);
+    return { ...inst, ia: ia.configured == null ? null : !!ia.configured };
+  }
+  const text = (f) => [`SagaDeck ${f.version || "?"} (commit ${f.commit || "?"})`, `Node ${f.node || "?"} · ${f.platform || "?"}`,
+    f.started ? `No ar desde ${new Date(f.started).toLocaleString("pt-BR")} (processo ${f.pid || "?"})` : "",
+    f.multiuser ? "Servidor multiusuário" : f.library ? `Biblioteca: ${f.library}` : "",
+    f.ia == null ? "" : `IA: ${f.ia ? "configurada" : "não configurada"}`].filter(Boolean).join("\n");
+
+  async function open() {
+    if (!dialog) build();
+    dialog.innerHTML = `<h2 id="about-title">Sobre o SagaDeck</h2><p class="ver">Carregando…</p><div class="row"><button type="button" data-close>Fechar</button></div>`;
+    dialog.querySelector("[data-close]").onclick = () => dialog.close();
+    if (!dialog.open) dialog.showModal();
+    const f = await facts();
+    const row = (k, v) => (v ? `<dt>${k}</dt><dd>${v}</dd>` : "");
+    dialog.innerHTML = `<h2 id="about-title">Sobre o SagaDeck</h2>
+      <p class="ver">Versão <b data-version>${esc(f.version || "?")}</b></p>
+      <dl>
+        ${row("Commit", f.commit ? `<code>${esc(f.commit)}</code>` : "")}
+        ${row("Node", f.node ? `${esc(f.node)} · ${esc(f.platform || "")}` : "")}
+        ${row("No ar desde", f.started ? esc(new Date(f.started).toLocaleString("pt-BR")) : "")}
+        ${row("Biblioteca", !f.multiuser && f.library ? `<code>${esc(f.library)}</code>` : f.multiuser ? "neste servidor (multiusuário)" : "")}
+        ${row("IA", f.ia == null ? "" : f.ia ? "configurada (para testar cada recurso: <code>sagadeck ia-check</code>)" : "não configurada")}
+      </dl>
+      <div class="links">
+        <a href="${REPO}/blob/main/CHANGELOG.md" target="_blank" rel="noopener">O que mudou em cada versão</a>
+        <a href="${REPO}" target="_blank" rel="noopener">Código e problemas</a>
+        <a href="https://www.npmjs.com/package/sagadeck" target="_blank" rel="noopener">Pacote no npm</a>
+      </div>
+      <div class="row"><span data-copied hidden>Copiado.</span><button type="button" data-copy>Copiar informações</button><button type="button" class="primary" data-close>Fechar</button></div>`;
+    dialog.querySelector("[data-close]").onclick = () => dialog.close();
+    dialog.querySelector("[data-copy]").onclick = async () => {
+      try { await navigator.clipboard.writeText(text(f)); dialog.querySelector("[data-copied]").hidden = false; }
+      catch { dialog.querySelector("[data-copied]").textContent = "Não deu para copiar."; dialog.querySelector("[data-copied]").hidden = false; }
+    };
+  }
+  // qualquer botão ou link com data-about abre (Ajuda › Sobre no editor, o botão da biblioteca)
+  document.addEventListener("click", (e) => { const b = e.target.closest?.("[data-about]"); if (b) { e.preventDefault(); open(); } });
+  return { open };
+})();

package/src/studio/public/ai-settings.js

@@ -4,12 +4,12 @@ window.SagaAISettings = (() => {
   const css = `.ai-cfg{max-width:min(560px,calc(100vw - 32px));width:100%;border:1px solid var(--border,#c9ced6);border-radius:12px;padding:18px 20px;background:var(--panel,var(--bg,#fff));color:var(--text,#1d2433);font:14px/1.45 system-ui,sans-serif}
 .ai-cfg::backdrop{background:rgba(0,0,0,.35)}.ai-cfg h2{margin:0 0 6px;font-size:18px}.ai-cfg p{margin:4px 0 10px;color:var(--text-2,#555)}
 .ai-cfg label{display:block;margin:10px 0 3px;font-weight:600;font-size:12px}.ai-cfg input,.ai-cfg select{width:100%;box-sizing:border-box;padding:7px 9px;border:1px solid var(--border,#c9ced6);border-radius:8px;background:var(--bg,#fff);color:inherit;font:inherit}
-.ai-cfg .grid{display:grid;grid-template-columns:1fr 1fr;gap:0 12px}.ai-cfg small{color:var(--text-3,#777);font-size:12px}.ai-cfg .warn{background:#fef3c7;color:#78350f;border-radius:8px;padding:8px 10px}
+.ai-cfg .grid{display:grid;grid-template-columns:1fr 1fr;gap:0 12px}.ai-cfg .grid .wide{grid-column:1/-1}.ai-cfg small{color:var(--text-3,#777);font-size:12px}.ai-cfg .warn{background:#fef3c7;color:#78350f;border-radius:8px;padding:8px 10px}
 .ai-cfg .row{display:flex;gap:8px;justify-content:flex-end;margin-top:16px;flex-wrap:wrap}.ai-cfg button{padding:7px 14px;border-radius:8px;border:1px solid var(--border,#c9ced6);background:transparent;color:inherit;cursor:pointer;font:inherit}
 .ai-cfg .rec{background:var(--selected,#eef);border-radius:8px;padding:8px 10px;margin:6px 0 4px}.ai-cfg .rec button{margin-top:6px;display:block}
 .ai-cfg button.primary{background:var(--brand,#5b4bdb);border-color:var(--brand,#5b4bdb);color:#fff}.ai-cfg [data-status]{margin-top:10px;min-height:1.4em}.ai-cfg [data-status].ok{color:#15803d}.ai-cfg [data-status].err{color:#b91c1c}`;
-  const LABEL = { text: "Modelo de texto", vision: "Modelo que vê imagens", image: "Modelo de imagem", search: "Modelo de busca na web", video: "Modelo de vídeo" };
-  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online", video: "opcional; para gerar clipes (cobrado por segundo)" };
+  const LABEL = { text: "Modelo de texto", vision: "Modelo que vê imagens", image: "Modelo de imagem", search: "Modelo de busca na web", video: "Modelo de vídeo", check: "Modelo para conferir" };
+  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online", video: "opcional; para gerar clipes (cobrado por segundo)", check: "opcional; vazio = o de texto. Um modelo de raciocínio mais forte só onde a conta precisa estar certa (contas, leitura crítica, revisão)" };
   const esc = (s) => String(s ?? "").replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
   let dialog, info, onSaved = () => {};
 
@@ -47,7 +47,7 @@ window.SagaAISettings = (() => {
       <input id="ai-cfg-url" data-f="url" placeholder="https://…/v1" spellcheck="false">
       <label for="ai-cfg-key">Chave</label>
       <input id="ai-cfg-key" data-f="key" type="password" autocomplete="off" spellcheck="false" placeholder="${c.keySet ? `configurada (${esc(c.keyHint)}${c.keyFrom === "variável" ? `, da variável ${esc(c.keyEnv)}` : ""}); em branco mantém` : "cole a chave do provedor"}">
-      <div class="grid">${(info.roles || []).map((r) => `<div><label for="ai-cfg-${r}">${LABEL[r] || r}</label><input id="ai-cfg-${r}" data-model="${r}" value="${esc(c.models?.[r])}" placeholder="${info.recommended?.models?.[r] ? `ex.: ${esc(info.recommended.models[r])}` : ""}" spellcheck="false"><small>${HINT[r] || ""}</small></div>`).join("")}</div>
+      <div class="grid">${(info.roles || []).map((r) => `<div${r === "check" ? ' class="wide"' : ""}><label for="ai-cfg-${r}">${LABEL[r] || r}</label><input id="ai-cfg-${r}" data-model="${r}" value="${esc(c.models?.[r])}" placeholder="${info.recommended?.models?.[r] ? `ex.: ${esc(info.recommended.models[r])}` : ""}" spellcheck="false"><small>${HINT[r] || ""}</small></div>`).join("")}</div>
       <p><small>Texto e visão funcionam em qualquer provedor compatível com a API da OpenAI. Gerar imagem e buscar na web dependem do provedor: funcionam no OpenRouter com modelos de imagem e modelos <code>:online</code>; em outros, a pesquisa usa buscadores diretos e a imagem pode não sair.</small></p>
       <div data-status role="status"></div>
       <div class="row"><button type="button" data-close>Fechar</button><button type="button" data-test>Testar</button><button type="button" class="primary" data-save>Salvar</button></div>`;

package/src/studio/public/app.js

@@ -378,6 +378,7 @@
       renderThumbnails();
       selectSlide(0);
       loadChatHistory();
+      conference.refresh(); // o selo da Conferência: uma consulta ao abrir; depois, a cada salvamento
     } catch (err) {
       showToast("Erro ao carregar apresentação: " + err.message);
     }
@@ -431,6 +432,7 @@
       window.SagaMap?.mount(dom.renderedSlideContainer); // só aqui (prévia grande); miniaturas e galeria ficam na prévia em SVG
       window.SagaMapData?.attach(dom.renderedSlideContainer, slide, () => { syncDeckToServer(); renderCurrentSlide(); }, { toast: showToast, hydrate: hydrateIcons, materialized: previewMaterialized });
       window.SagaCalc?.mount(dom.renderedSlideContainer); // calculadora ao vivo: os controles funcionam no editor também
+      window.SagaSolution?.mount(dom.renderedSlideContainer); // exercício interativo: idem
       window.SagaDiagrams?.mount(dom.renderedSlideContainer).then(() => reportDiagram(dom.renderedSlideContainer));
       window.SagaDecisionLab?.mount(dom.renderedSlideContainer);
       applyEditorStep(idx);
@@ -2156,6 +2158,7 @@
     showToast("Screenshot pronto. Use Apresentar para percorrer os destaques.");
   }
   function setupCreativeTools() {
+    window.SagaDeveloperAuthoring.bind({ state, syncDeckToServer, renderThumbnails, renderCurrentSlide, openPane, showToast });
     const shotButton = document.createElement("button");
     shotButton.id = "btn-screenshot";
     shotButton.className = "rbtn rbtn-lg";
@@ -2806,6 +2809,13 @@
     state, showToast: (...a) => showToast(...a), renderThumbnails: () => renderThumbnails(), renderCurrentSlide: () => renderCurrentSlide(),
     trackDeck: (l) => trackDeck(l), hydrateIcons: (el) => hydrateIcons(el), plainTitle: (sl, i) => plainTitle(sl, i),
   });
+  // Revisar › Conferência (conference-ui.js): o que as checagens acharam, com Corrigir com IA (pedido pontual ao chat)
+  const conference = window.SagaConference.create({
+    state, showToast: (...a) => showToast(...a), renderThumbnails: () => renderThumbnails(), renderCurrentSlide: () => renderCurrentSlide(),
+    hydrateIcons: (el) => hydrateIcons(el), plainTitle: (sl, i) => plainTitle(sl, i),
+    chatBusy: () => !!chatApi.getChatJob(),
+    askChat: (text, extra) => { openPane("chat"); dom.chatInput.value = text; chatApi.handleChatSubmit(null, extra); },
+  });
   // Desfazer / refazer único (history.js): todo caminho que muda o deck passa por trackDeck, com o rótulo da origem
   const deckHistory = window.SagaHistory.createHistory();
   function trackDeck(label = "Edição") {
@@ -2865,7 +2875,8 @@
       });
       if (adopted && !state.applyingHistory) deckHistory.rebase(state.deck);
       updateSaveStatus(res.ok ? "saved" : "error");
-      if (res.ok) window.SagaProject?.deckChanged();
+      // o selo da Conferência acompanha o que mudou no deck (navegar entre slides não muda nada: não consulta)
+      if (res.ok) { window.SagaProject?.deckChanged(); conference.refreshSoon(); }
       else if (throwOnError) throw new Error(data.error || 'Não foi possível salvar as mudanças antes de exportar.');
     } catch (err) {
       console.warn("Erro ao sincronizar com servidor:", err);
@@ -3706,7 +3717,7 @@ ${ta.value}`;
 
   // Chat lateral com IA (chat.js): mesma API, agora em módulo próprio.
   const chatApi = window.SagaChat({ state, dom, escHtml, hydrateIcons, showToast, openPane, currentPane,
-    streamAI, syncDeckToServer, renderThumbnails, renderCurrentSlide, trackDeck, fitRendered, refreshAIStatus });
+    streamAI, syncDeckToServer, renderThumbnails, renderCurrentSlide, trackDeck, fitRendered, refreshAIStatus, previewMaterialized });
   const { handleChatSubmit, loadChatHistory, appendChatMessage, createProgressBubble, autoGrowChat, applyBrainstorm, addChatFile } = chatApi;
 
   function setNotesVisible(on) {
@@ -3909,6 +3920,7 @@ ${ta.value}`;
     document.getElementById("btn-header-footer").addEventListener("click", openHeaderFooter);
     document.getElementById("btn-styles")?.addEventListener("click", openStyles);
     document.getElementById("btn-review-changes")?.addEventListener("click", openReviewList);
+    document.getElementById("btn-conference")?.addEventListener("click", () => conference.open());
     document.getElementById("btn-close-hf").addEventListener("click", closeHeaderFooter);
     document.getElementById("btn-hf-cancel").addEventListener("click", closeHeaderFooter);
     document.getElementById("btn-hf-apply").addEventListener("click", applyHeaderFooter);

package/src/studio/public/chat.js

@@ -2,7 +2,7 @@
 // Saiu do app.js pela trava de tamanho dos monolitos; o comportamento é o mesmo.
 // Fábrica no molde de slide-select.js: recebe o estado e os ajudantes, devolve a API.
 window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, openPane, currentPane,
-  streamAI, syncDeckToServer, renderThumbnails, renderCurrentSlide, trackDeck, fitRendered, refreshAIStatus }) {
+  streamAI, syncDeckToServer, renderThumbnails, renderCurrentSlide, trackDeck, fitRendered, refreshAIStatus, previewMaterialized }) {
   let chatJob = null;
   const getChatJob = () => chatJob;
   // ==========================================================================
@@ -96,7 +96,8 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
     box.scrollIntoView({ block: "nearest" });
   }
 
-  async function handleChatSubmit(e) {
+  // extra: o que o Studio manda junto do pedido (contas: [n] do painel Conferência, conferidas depois da resposta)
+  async function handleChatSubmit(e, extra = {}) {
     if (e) e.preventDefault();
     if (chatJob) { if(e?.type === "submit") chatJob.stop(); return; }
     const message = dom.chatInput.value.trim();
@@ -156,9 +157,14 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
         renderNotes: state.renderNotes || [],
         autoRun: !!state.autoRunCommands, // a pessoa liberou os comandos desta conversa (só enquanto a página está aberta)
         expectFile: state.file,
+        ...(Array.isArray(extra?.contas) ? { contas: extra.contas } : {}),
       }, (ev) => { if (!commandEvent(ev)) work.update(ev); }, job.controller.signal);
       if (state.file !== job.file) { work.done(); showToast("O pedido terminou na apresentação em que começou; a apresentação atual foi preservada.", 6000); return; }
       if (!data.spec) throw new Error(data.error || "resposta sem deck");
+      if (data.materialized) {
+        state.file = data.materialized.file;
+        previewMaterialized(data.materialized);
+      }
       // conversa salva antes de dispensar o indicador: quem espera o fim da resposta já encontra o arquivo gravado
       const finishWork = async () => { await saveChatHistory(); work.done(); };
       if (data.variants) {
@@ -241,6 +247,7 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
       dom.chatInput.disabled = false;
       dom.chatInput.focus();
       await saveChatHistory();
+      window.dispatchEvent(new Event("sagadeck:chat-done")); // o painel Conferência confere o selo de novo
     }
   }
 
@@ -317,7 +324,8 @@ window.SagaChat = function ({ state, dom, escHtml, hydrateIcons, showToast, open
   async function loadChatHistory() {
     state.autoRunCommands = false; // outra apresentação: nada fica liberado
     try {
-      const { history } = await (await fetch("api/chat/history")).json();
+      const { history, notice } = await (await fetch("api/chat/history")).json();
+      if (notice) showToast("A criação com IA deixou avisos sem resolver: veja no chat da IA.", 8000);
       state.chatHistory = Array.isArray(history) ? history : [];
       state.loadingHistory = true; // conversa guardada não é resposta nova (o atalho do chat não acende)
       setTimeout(() => { state.loadingHistory = false; });

package/src/studio/public/conference-ui.js

@@ -0,0 +1,91 @@
+// Painel Revisar › Conferência: tudo o que as checagens automáticas acharam no deck aberto (contas, números sem base
+// no material, avisos da revisão visual, figuras do material sem slide, slides que a IA calculou ou incluiu), por
+// slide, com Ir ao slide, Corrigir com IA (um pedido pontual ao chat) e Ignorar (gravado no relatório). A lista vem
+// do servidor (src/studio/conference.js); o app passa o que o painel usa (create(ctx)).
+(function () {
+  const KIND_ICON = { conta: "calculator", material: "file-text", numero: "hash", visual: "scan-eye", figura: "image-off", derivado: "calculator", proprio: "sparkles" };
+  function create(ctx) {
+    const { state, showToast, renderThumbnails, renderCurrentSlide, hydrateIcons, plainTitle, askChat, chatBusy } = ctx;
+    let items = [], salvo = false, conferidoEm = null, timer = null, checking = false;
+    const json = async (r) => { const j = await r.json().catch(() => ({})); if (!r.ok || j.error) throw new Error(j.error || `HTTP ${r.status}`); return j; };
+    function take(j) {
+      items = j.items || []; salvo = !!j.salvo; conferidoEm = j.conferidoEm || null;
+      const b = document.getElementById("conference-badge");
+      if (b) { b.textContent = items.length; b.classList.toggle("clean", !items.length); }
+      document.getElementById("conference-dialog")?.dispatchEvent(new Event("refresh"));
+    }
+    async function refresh() {
+      try { take(await json(await fetch("api/conferencia"))); } catch { /* sem servidor: o selo fica como estava */ }
+    }
+    // o deck muda o tempo todo (formulário, IA): o selo acompanha sem uma consulta por tecla
+    const refreshSoon = () => { clearTimeout(timer); timer = setTimeout(refresh, 700); };
+    function goTo(n) {
+      if (!(n >= 1 && n <= (state.deck?.slides?.length || 0))) return;
+      state.currentSlideIndex = n - 1;
+      renderThumbnails(); renderCurrentSlide();
+    }
+    async function decide(id, status) {
+      try { take(await json(await fetch("api/conferencia/item", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ id, status }) }))); }
+      catch (e) { showToast(e.message); }
+    }
+    async function recheck(btn) {
+      if (checking) return;
+      checking = true; btn.disabled = true;
+      btn.innerHTML = '<i class="ic" data-ic="loader-circle"></i> Conferindo…'; hydrateIcons(btn);
+      try {
+        const j = await json(await fetch("api/conferencia/conferir", { method: "POST", headers: { "Content-Type": "application/json" }, body: "{}" }));
+        take(j);
+        showToast(`Conferido: ${items.length ? `${items.length} pendência(s)` : "nada pendente"}.${j.notes?.length ? ` ${j.notes.join(" ")}` : ""}`, 6000);
+      } catch (e) { showToast(`A conferência não saiu: ${e.message}`); }
+      finally { checking = false; document.getElementById("conference-dialog")?.dispatchEvent(new Event("refresh")); }
+    }
+    function fix(it, dlg) {
+      if (chatBusy()) { showToast("Espere a IA terminar o pedido atual.", 3000); return; }
+      if (it.slide) goTo(it.slide);
+      dlg.close();
+      // conta que não bate: o Studio confere de novo depois da resposta (contas: [n]) e o resultado decide se ela
+      // sai do painel; o resto (sem como conferir sozinho) sai ao ir para o chat
+      if (it.kind !== "conta" && it.kind !== "material") decide(it.id, "enviado");
+      askChat(it.fix, it.contas ? { contas: it.contas } : {});
+    }
+    function open() {
+      let dlg = document.getElementById("conference-dialog");
+      const fill = () => {
+        const groups = new Map();
+        for (const it of items) { const k = it.slide || 0; if (!groups.has(k)) groups.set(k, []); groups.get(k).push(it); }
+        const order = [...groups.keys()].sort((a, b) => (a || 1e9) - (b || 1e9));
+        dlg.innerHTML = `<header><i class="ic" data-ic="list-checks"></i><b>Conferência</b><span class="rv-count">${items.length}</span><span class="grow"></span>${salvo ? `<button type="button" class="btn btn-sm" data-recheck title="Refaz no deck atual a conferência das contas, a checagem dos números e das figuras do material"><i class="ic" data-ic="${checking ? "loader-circle" : "refresh-cw"}"></i> ${checking ? "Conferindo…" : "Conferir de novo"}</button>` : ""}<button type="button" class="btn btn-sm" data-close title="Fechar"><i class="ic" data-ic="x"></i></button></header>
+          <div class="rv-list conf-list">${items.length ? order.map((k) => `<section class="conf-group" data-slide="${k}"><div class="conf-group-head">${k ? `<b class="rv-num">${k}</b><span class="conf-slide-title"></span><button type="button" class="btn btn-sm" data-go="${k}">Ir ao slide</button>` : "<b>Deck todo</b>"}</div>${groups.get(k).map((it) => `<div class="conf-item conf-${it.kind}" data-id="${it.id}"><span class="conf-kind"><i class="ic" data-ic="${KIND_ICON[it.kind] || "circle-alert"}"></i><span></span></span><span class="conf-text"></span><span class="conf-actions"><button type="button" class="btn btn-primary btn-sm" data-fix><i class="ic" data-ic="wand-sparkles"></i> Corrigir com IA</button><button type="button" class="btn btn-sm" data-ignore title="Está certo assim: sai do painel e dos próximos pedidos à IA"><i class="ic" data-ic="eye-off"></i> Ignorar</button></span></div>`).join("")}</section>`).join("")
+            : `<div class="rv-empty">${salvo ? "Nada pendente: as checagens automáticas não deixaram avisos neste deck." : "A conferência vale para apresentações salvas na biblioteca."}</div>`}</div>
+          ${conferidoEm ? `<div class="conf-foot">Conferido em ${new Date(conferidoEm).toLocaleString("pt-BR")}</div>` : ""}`;
+        dlg.querySelectorAll(".conf-group").forEach((g) => {
+          const n = +g.dataset.slide;
+          if (n && state.deck?.slides?.[n - 1]) g.querySelector(".conf-slide-title").textContent = plainTitle(state.deck.slides[n - 1], n - 1);
+          g.querySelector("[data-go]")?.addEventListener("click", () => { goTo(n); dlg.close(); });
+        });
+        dlg.querySelectorAll(".conf-item").forEach((row) => {
+          const it = items.find((x) => x.id === row.dataset.id);
+          row.querySelector(".conf-kind span").textContent = it.label;
+          row.querySelector(".conf-text").textContent = it.text;
+          row.querySelector("[data-fix]").onclick = () => fix(it, dlg);
+          row.querySelector("[data-ignore]").onclick = () => decide(it.id, "ignorado");
+        });
+        dlg.querySelector("[data-recheck]")?.addEventListener("click", (e) => recheck(e.currentTarget));
+        dlg.querySelector("[data-close]").onclick = () => dlg.close();
+        hydrateIcons(dlg);
+      };
+      if (!dlg) {
+        dlg = document.createElement("dialog");
+        dlg.id = "conference-dialog"; dlg.className = "review-dialog conference-dialog";
+        document.body.append(dlg);
+        dlg.addEventListener("refresh", () => { if (dlg.open) fill(); });
+      }
+      fill();
+      if (!dlg.open) dlg.showModal();
+      refresh();
+    }
+    window.addEventListener("sagadeck:chat-done", refreshSoon);
+    return { open, refresh, refreshSoon };
+  }
+  window.SagaConference = { create };
+})();

package/src/studio/public/developer-authoring.css

@@ -0,0 +1,12 @@
+/* Conteúdo técnico em um só lugar: fonte à esquerda, resultado à direita. */
+.dev-author-dialog{margin:auto;width:min(1110px,96vw);max-width:96vw;height:min(810px,94dvh);max-height:94dvh;padding:0;border:1px solid var(--ui-line);border-radius:18px;background:var(--chrome);color:var(--text);box-shadow:0 24px 90px #0005;font:13px var(--font-sans)}
+.dev-author-dialog[open]{display:flex;flex-direction:column}.dev-author-dialog::backdrop{background:#101521aa;backdrop-filter:blur(4px)}
+.dev-author-dialog header{display:flex;justify-content:space-between;align-items:center;padding:20px 25px;border-bottom:1px solid var(--ui-line)}.dev-author-dialog header small{color:var(--brand);font-size:10px;font-weight:700;letter-spacing:.13em}.dev-author-dialog h2{margin:5px 0;font-size:25px;letter-spacing:-.035em}.dev-author-dialog header p{margin:5px 0 0;color:var(--text-2)}
+.dev-author-dialog button{padding:9px 12px;border:1px solid var(--ui-line-strong);border-radius:8px;background:var(--chrome);color:var(--text);font:inherit;cursor:pointer}.dev-author-dialog button:hover{background:var(--hover)}.dev-author-dialog button:disabled{opacity:.45;cursor:default}.dev-author-dialog button:focus-visible,.dev-author-dialog input:focus-visible,.dev-author-dialog select:focus-visible,.dev-author-dialog textarea:focus-visible{outline:2px solid var(--brand);outline-offset:2px}
+.dev-author-work{display:grid;grid-template-columns:minmax(0,1fr) 340px;min-height:0;flex:1}.dev-author-source{display:flex;flex-direction:column;min-height:0;padding:22px 24px;gap:10px}.dev-author-dialog label{display:block;color:var(--text-2);font-size:12px}.dev-author-dialog input:not([type=radio]),.dev-author-dialog textarea,.dev-author-dialog select{display:block;width:100%;margin-top:6px;padding:9px 10px;border:1px solid var(--ui-line-strong);border-radius:7px;background:var(--chrome);color:var(--text);font:13px var(--font-sans)}
+.dev-author-dialog #dev-source{flex:1;min-height:150px;margin-top:0;resize:none;white-space:pre;tab-size:2;font:13px/1.65 var(--font-mono,monospace);background:var(--canvas-bg)}.dev-author-meta{display:grid;grid-template-columns:1fr 1fr;gap:10px}.dev-author-meta>label:first-child{grid-column:1/-1}.dev-author-dialog small{font-size:10px}.dev-author-dialog aside{padding:22px;overflow-y:auto;border-left:1px solid var(--ui-line)}.dev-author-dialog fieldset{border:0;padding:0;margin:0 0 22px}.dev-author-dialog legend{font-size:12px;font-weight:700;color:var(--text);margin-bottom:12px}
+.dev-author-modes label{display:flex;align-items:flex-start;gap:9px;padding:12px;margin-bottom:8px;border:1px solid var(--ui-line);border-radius:9px;cursor:pointer}.dev-author-modes label:has(input:checked){background:var(--selected);border-color:var(--brand)}.dev-author-modes input{margin-top:3px;accent-color:var(--brand)}.dev-author-modes b{display:block;color:var(--text);font-size:13px}.dev-author-modes small{display:block;line-height:1.5;margin-top:4px;color:var(--text-2)}
+.dev-author-dialog h3{font-size:13px;margin-bottom:9px}.dev-author-dialog .dev-author-tip{font-size:11px;line-height:1.5;color:var(--text-2);margin:0 0 10px}.dev-author-range{display:grid;grid-template-columns:1fr 1fr;gap:10px}.dev-author-dialog [data-guide]>label{margin:10px 0}.dev-author-dialog [data-step-text]{resize:vertical;max-height:150px}.dev-author-dialog [data-add-step]{width:100%;margin:4px 0 12px}.dev-author-steps{display:grid;gap:6px}.dev-author-step{display:flex;gap:4px}.dev-author-step button:first-child{flex:1;min-width:0;text-align:left;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:11px}.dev-author-step button.active{border-color:var(--brand);color:var(--brand)}.dev-author-step button:last-child{font-size:10px;padding:7px}
+.dev-author-dialog [data-request]{max-height:210px;overflow:auto;border:1px solid var(--ui-line);padding:12px;border-radius:8px;background:var(--canvas-bg);font:11px/1.6 var(--font-mono,monospace);white-space:pre-wrap;overflow-wrap:anywhere;margin-bottom:12px}.dev-author-secrets{padding:12px;border:1px solid var(--brand);border-radius:8px;color:var(--text);background:var(--selected);line-height:1.6;font-size:11px;overflow-wrap:anywhere}.dev-author-dialog [hidden]{display:none!important}
+.dev-author-dialog footer{display:flex;align-items:center;justify-content:flex-end;gap:9px;padding:14px 24px;border-top:1px solid var(--ui-line)}.dev-author-dialog [data-status]{flex:1;font-size:11px;line-height:1.5;color:var(--text-2)}.dev-author-dialog .dev-author-primary{background:var(--brand);color:#fff;border-color:var(--brand)}.dev-author-dialog .dev-author-primary:hover{filter:brightness(1.08)}
+@media(max-width:760px){.dev-author-dialog{height:94dvh}.dev-author-work{display:flex;flex-direction:column;overflow-y:auto}.dev-author-source{min-height:390px;flex-shrink:0;padding:16px}.dev-author-dialog aside{border-left:0;border-top:1px solid var(--ui-line);overflow:visible;padding:16px}.dev-author-dialog header{padding:15px 16px}.dev-author-dialog h2{font-size:21px}.dev-author-dialog footer{padding:12px 16px;flex-wrap:wrap}.dev-author-dialog [data-status]{flex-basis:100%}}