sagadeck 1.5.0 → 1.6.0

package/src/ai/llm.js

@@ -1,20 +1,23 @@
 import { mediaPrompt } from './art-direction.js';
 // sagadeck · Cliente de LLM (qualquer endpoint compatível com OpenAI: /v1/chat/completions)
 //
-// Por padrão fala com o `modelrelay serve` local (http://127.0.0.1:8765/v1), que decide pela
-// configuração dele para onde a chamada vai (OpenRouter, OpenAI, gateway corporativo...).
-// Também funciona apontando direto para um provedor.
+// Fala direto com o provedor configurado nesta máquina (~/.sagadeck/ia.json, tela Configurar IA do Studio:
+// src/ai/ia-config.js). As variáveis abaixo valem por cima da configuração:
 //
-//   SAGADECK_LLM_URL      base da API            (padrão: http://127.0.0.1:8765/v1)
-//   SAGADECK_LLM_KEY      bearer token opcional  (ex.: chave do OpenRouter se apontar direto)
-//   SAGADECK_TEXT_MODEL   modelo de texto        (padrão: "text"  — apelido no [models] do modelrelay)
-//   SAGADECK_IMAGE_MODEL  modelo de imagem       (padrão: "image" — idem)
-//   SAGADECK_VISION_MODEL modelo que vê imagens  (padrão: "vision" — quando o de texto não enxerga, a chamada com
-//                         imagem vai para ele em vez de perder a imagem; quem configura o relay decide qual é)
+//   SAGADECK_LLM_URL      base da API            (ex.: https://openrouter.ai/api/v1)
+//   SAGADECK_LLM_KEY      bearer token           (ex.: a chave do OpenRouter)
+//   SAGADECK_TEXT_MODEL   modelo de texto        (padrão: o "text" da configuração)
+//   SAGADECK_IMAGE_MODEL  modelo de imagem       (padrão: o "image" da configuração)
+//   SAGADECK_VISION_MODEL modelo que vê imagens  (padrão: o "vision" da configuração; quando o de texto não enxerga,
+//                         a chamada com imagem vai para ele em vez de perder a imagem)
+//   SAGADECK_SEARCH_MODEL modelo que busca na web (padrão: o "search" da configuração)
 //   SAGADECK_LLM_TIMEOUT  segundos por chamada; em streaming, segundos sem chegar nada (padrão: 180)
 //   SAGADECK_LLM_FIRST_TIMEOUT  em streaming, segundos até a 1ª palavra (o modelo pensa antes) (padrão: 600)
 
 import { currentUsage, recordUsage } from './usage.js';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { iaFile, loadIA, keyOf, migrateModelrelay } from './ia-config.js';
 import {setTimeout as delay} from 'node:timers/promises';
 
 export class LLMError extends Error {
@@ -28,35 +31,67 @@ export class LLMError extends Error {
   }
 }
 
+// De onde vem a IA: variáveis de ambiente (SAGADECK_LLM_URL…, valem por cima; é como os testes apontam para o LLM
+// falso) ou a configuração desta máquina (~/.sagadeck/ia.json, src/ai/ia-config.js). Os papéis text, vision, image e
+// search viram os modelos configurados; sem configuração nenhuma, a IA fica desligada (o Studio usa as regras locais).
+let migrated = false;
 export function llmConfig(env = process.env) {
+  const fromEnv = !!env.SAGADECK_LLM_URL;
+  if (!fromEnv && !migrated) { migrated = true; try { migrateModelrelay({ env, file: iaFile(env) }); } catch { /* segue sem */ } }
+  const ia = fromEnv ? null : loadIA(iaFile(env));
+  const m = ia?.models || {};
   return {
-    url: (env.SAGADECK_LLM_URL || "http://127.0.0.1:8765/v1").replace(/\/+$/, ""),
-    key: env.SAGADECK_LLM_KEY || "",
-    textModel: env.SAGADECK_TEXT_MODEL || "text",
-    imageModel: env.SAGADECK_IMAGE_MODEL || "image",
-    visionModel: env.SAGADECK_VISION_MODEL || "vision",
+    url: (env.SAGADECK_LLM_URL || ia?.url || "").replace(/\/+$/, ""),
+    key: env.SAGADECK_LLM_KEY || (ia ? keyOf(ia, env) : ""),
+    textModel: env.SAGADECK_TEXT_MODEL || m.text || "text",
+    imageModel: env.SAGADECK_IMAGE_MODEL || m.image || "image",
+    visionModel: env.SAGADECK_VISION_MODEL || m.vision || m.text || "vision",
+    // busca na web pelo modelo (no OpenRouter, um modelo ":online"); sem ele, a pesquisa usa os buscadores diretos
+    searchModel: env.SAGADECK_SEARCH_MODEL || m.search || (fromEnv ? "search" : ""),
+    headers: ia?.headers || {},
+    adaptador: ia?.adaptador || "",
+    source: fromEnv ? "variável" : ia ? "arquivo" : "nenhuma",
     timeoutMs: Number(env.SAGADECK_LLM_TIMEOUT || 180) * 1000,
     firstTimeoutMs: Number(env.SAGADECK_LLM_FIRST_TIMEOUT || 600) * 1000,
-    // o modelrelay escolhe os modelos deste app em [apps.sagadeck.models] (o resto vem de [models])
-    app: env.SAGADECK_APP || "sagadeck",
   };
 }
+export const llmConfigured = (cfg = llmConfig()) => !!(cfg.url || cfg.adaptador);
+
+// o papel (text, vision, image, search) vira o modelo configurado; outro nome passa como veio
+export function resolveModel(cfg, name) {
+  const roles = { text: cfg.textModel, vision: cfg.visionModel, image: cfg.imageModel, search: cfg.searchModel };
+  return roles[name] || name;
+}
 
 function headers(cfg) {
-  const h = { "Content-Type": "application/json", "X-Modelrelay-App": cfg.app || "sagadeck" };
+  const h = { "Content-Type": "application/json", ...(cfg.headers || {}) };
   if (cfg.key) h.Authorization = `Bearer ${cfg.key}`;
   return h;
 }
 
+// Adaptador (opcional, da pessoa): um .mjs cujo default é (url, init) => Response. Serve para o que não é compatível
+// com a API da OpenAI (outro jeito de autenticar, outro endereço) sem mexer no sagadeck. Sem ele, o fetch normal.
+const adapters = new Map();
+async function send(cfg, url, init) {
+  if (!cfg.adaptador) return fetch(url, init);
+  if (!adapters.has(cfg.adaptador)) adapters.set(cfg.adaptador, import(pathToFileURL(path.resolve(cfg.adaptador)).href).then((mod) => mod.default));
+  const fn = await adapters.get(cfg.adaptador);
+  if (typeof fn !== "function") throw new LLMError(`O adaptador ${cfg.adaptador} não exporta uma função padrão (url, init) => Response.`);
+  return fn(url, init);
+}
+const notConfigured = () => new LLMError("A IA não está configurada: no Studio, abra Configurar IA (ou crie ~/.sagadeck/ia.json).", { code: "AI_NOT_CONFIGURED" });
+const howToFix = "Confira o provedor e a chave em Configurar IA, no Studio.";
+
 // Disponibilidade com cache curto, para o Studio decidir entre LLM e as regras determinísticas.
 let availability = { at: 0, ok: false, url: "" };
 
 export async function llmAvailable({ force = false } = {}) {
   const cfg = llmConfig();
+  if (!llmConfigured(cfg)) return false;
   if (!force && availability.url === cfg.url && Date.now() - availability.at < 30_000) return availability.ok;
   let ok = false;
   try {
-    const res = await fetch(`${cfg.url}/models`, { headers: headers(cfg), signal: AbortSignal.timeout(2500) });
+    const res = await send(cfg, `${cfg.url}/models`, { headers: headers(cfg), signal: AbortSignal.timeout(2500) });
     ok = res.ok;
   } catch {
     ok = false;
@@ -106,13 +141,13 @@ export async function chat(messages, opts = {}) {
 
 async function chatUnmetered(messages, opts = {}) {
   const cfg = opts.cfg || llmConfig();
-  const key = `${cfg.url}|${cfg.app}|${opts.model || cfg.textModel}`;
+  const key = `${cfg.url}|${opts.model || cfg.textModel}`;
   // o modelo de texto não enxerga: a chamada com imagem vai para o modelo de visão (se o relay tiver um)
   const viaVision = async () => {
     const vision = cfg.visionModel;
-    if (!vision || vision === (opts.model || cfg.textModel) || noVision.has(`${cfg.url}|${cfg.app}|${vision}`)) return null;
+    if (!vision || vision === (opts.model || cfg.textModel) || noVision.has(`${cfg.url}|${vision}`)) return null;
     try { return { ...(await chatOnce(messages, { ...opts, model: vision, cfg })), visionRouted: vision }; }
-    catch (e) { if (refusesImages(e) || e.status === 400 || e.status === 404) { noVision.add(`${cfg.url}|${cfg.app}|${vision}`); return null; } throw e; }
+    catch (e) { if (refusesImages(e) || e.status === 400 || e.status === 404) { noVision.add(`${cfg.url}|${vision}`); return null; } throw e; }
   };
   if (hasImageParts(messages) && noVision.has(key)) {
     return (await viaVision()) || { ...(await chatOnce(withoutImages(messages), { ...opts, cfg })), imagesDropped: true };
@@ -147,7 +182,8 @@ async function chatOnce(messages, opts = {}) {
 }
 
 async function chatOnceRaw(messages, { model, temperature, maxTokens, onDelta, signal, reasoningOff, cfg = llmConfig() } = {}) {
-  const body = { model: model || cfg.textModel, messages };
+  if (!llmConfigured(cfg)) throw notConfigured();
+  const body = { model: resolveModel(cfg, model || cfg.textModel), messages };
   if (reasoningOff) body.reasoning = { enabled: false };
   if (temperature !== undefined) body.temperature = temperature;
   if (maxTokens) body.max_tokens = maxTokens;
@@ -155,7 +191,7 @@ async function chatOnceRaw(messages, { model, temperature, maxTokens, onDelta, s
 
   let res;
   try {
-    res = await fetch(`${cfg.url}/chat/completions`, {
+    res = await send(cfg, `${cfg.url}/chat/completions`, {
       method: "POST",
       headers: headers(cfg),
       body: JSON.stringify(body),
@@ -168,7 +204,7 @@ async function chatOnceRaw(messages, { model, temperature, maxTokens, onDelta, s
     if (e.cause?.code === "UND_ERR_HEADERS_TIMEOUT") return chatStream(body, () => {}, cfg, signal);
     const why = e.name === "TimeoutError" ? `sem resposta em ${cfg.timeoutMs / 1000}s` : e.message;
     throw new LLMError(`Não consegui falar com o LLM em ${cfg.url} (${why}). ` +
-      "Rode `modelrelay serve` ou ajuste SAGADECK_LLM_URL.", { cause: e });
+      howToFix, { cause: e });
   }
 
   const raw = await res.text();
@@ -213,7 +249,7 @@ async function chatStream(body, onDelta, cfg, signal) {
 async function readStream(body, onDelta, cfg, signal, sig, alive, wrote = () => {}, noTextFor = () => 0) {
   let res;
   try {
-    res = await fetch(`${cfg.url}/chat/completions`, {
+    res = await send(cfg, `${cfg.url}/chat/completions`, {
       method: "POST",
       headers: headers(cfg),
       body: JSON.stringify({ ...body, stream: true, stream_options: { include_usage: true } }),
@@ -223,7 +259,7 @@ async function readStream(body, onDelta, cfg, signal, sig, alive, wrote = () =>
     if (signal?.aborted) throw new LLMError("Parado a pedido.", { cause: e, aborted: true });
     const why = e.name === "TimeoutError" ? `não começou a responder em ${(cfg.firstTimeoutMs ?? cfg.timeoutMs) / 1000} s` : e.message;
     throw new LLMError(`Não consegui falar com o LLM em ${cfg.url} (${why}). ` +
-      "Rode `modelrelay serve` ou ajuste SAGADECK_LLM_URL.", { cause: e });
+      howToFix, { cause: e });
   }
   alive(); // começou: daqui em diante, o limite é ficar sem chegar nada
   if (!res.ok) {

package/src/library.js

@@ -22,8 +22,9 @@ import YAML from "yaml";
 import * as MASTER from "./master.js";
 import { unpackDeck } from "./package.js";
 import { writeDeckFile } from "./deck-file.js";
+import { loadPreferences } from "./preferences.js";
 
-export const TRASH_DAYS = 1;
+export const TRASH_DAYS = 30; // padrão; cada máquina escolhe em Preferências › Biblioteca (lixeiraDias)
 const TRASH = ".lixeira";
 const TOPIC_META = ".topico.json";
 const COLORS = ["#d33a2c", "#0f6cbd", "#e5a50a", "#8b5cf6", "#0e9f6e", "#e8590c", "#d6336c", "#495057"];
@@ -128,7 +129,9 @@ function uniquePath(dir, name, ext = "") {
   return p;
 }
 
-export function openLibrary(root) {
+// trashDays: quantos dias a lixeira guarda (padrão: o das Preferências desta máquina, lido a cada limpeza)
+export function openLibrary(root, { trashDays } = {}) {
+  const keepDays = () => trashDays ?? loadPreferences().biblioteca?.lixeiraDias ?? TRASH_DAYS;
   root = path.resolve(root);
   fs.mkdirSync(root, { recursive: true });
 
@@ -191,7 +194,7 @@ export function openLibrary(root) {
       topics.push({ id: e.name, name: e.name, color: meta.color || COLORS[topics.length % COLORS.length], count: mine.length, created: meta.created || 0 });
     }
     topics.sort((a, b) => a.name.localeCompare(b.name, "pt-BR"));
-    return { root, topics, decks, trash: listTrash() };
+    return { root, topics, decks, trash: listTrash(), trashDays: keepDays() };
   }
 
   // ---- tópicos ----
@@ -414,7 +417,8 @@ export function openLibrary(root) {
     return all.length;
   }
   function purgeOld(now = Date.now()) {
-    for (const t of listTrash()) if (now - t.deleted > TRASH_DAYS * 864e5) purgeDeck(t.id);
+    const days = keepDays();
+    for (const t of listTrash()) if (now - t.deleted > days * 864e5) purgeDeck(t.id);
   }
 
   // ---- importar .sagadeck / .zip ----

package/src/motion.js

@@ -22,11 +22,11 @@ function drawTrace(ctx,o,t,w,h){
  ctx.restore();
 }
 function scene(o){
- let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;let reduced=!!o.still||matchMedia('(prefers-reduced-motion:reduce)').matches;const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
+ let active=o.type!=='chat',started=false,epoch=performance.now(),serial=0,phase='idle',elapsed=0,previous=0;const reduceQuery=matchMedia('(prefers-reduced-motion:reduce)');let still=false,reduced=!!o.still||reduceQuery.matches;const recompute=()=>{reduced=!!o.still||still||reduceQuery.matches;};reduceQuery.addEventListener?.('change',recompute);const main=document.querySelector('main'),canvas=document.querySelector('canvas'),ctx=canvas.getContext('2d');
  const message=(kind)=>parent.postMessage({sagaMotion:kind},'*');
  const chat=document.querySelector('.chat'),input=document.querySelector('.input'),thread=document.querySelector('.thread'),status=document.querySelector('.status');
  function reset(){started=false;phase='idle';elapsed=0;chat.hidden=true;input.textContent='';thread.replaceChildren();status.textContent='';}
- message('ready');window.addEventListener('message',e=>{if(e.source!==parent)return;if(e.data?.sagaMotion==='poster'){reduced=true;if(o.type==='terminal')document.querySelector('.feed').textContent=o.lines.join('\n');}if(e.data?.sagaMotion==='active')active=!!e.data.active;if(e.data?.sagaMotion==='reset')reset();if(e.data?.sagaMotion==='start'){reset();started=true;active=true;phase='recognize';chat.hidden=false;}});
+ window.__sagaMotion=()=>({active,reduced,started,serial,phase});message('ready');window.addEventListener('message',e=>{if(e.source!==parent)return;if(e.data?.sagaMotion==='poster'){still=e.data.active!==false;recompute();if(reduced&&o.type==='terminal')document.querySelector('.feed').textContent=o.lines.join('\n');}if(e.data?.sagaMotion==='active')active=!!e.data.active;if(e.data?.sagaMotion==='reset')reset();if(e.data?.sagaMotion==='start'){reset();started=true;active=true;phase='recognize';chat.hidden=false;}});
  if(o.type==='chat'&&o.manual){const request=e=>{if(!active)return;if(e.type==='keydown'&&![' ','Enter','ArrowRight','PageDown'].includes(e.key))return;e.preventDefault();message('start-request');};document.addEventListener('click',request);document.addEventListener('keydown',request);}
  if(o.type==='chat'&&!o.manual){started=true;phase='recognize';chat.hidden=false;}
  function bubble(text,kind){const el=document.createElement('div');el.className='bubble '+kind;el.textContent=text;thread.append(el);return el;}

package/src/preferences.js

@@ -22,6 +22,9 @@ export const PREF_SCHEMA = {
   exportacao: {
     pdfClaro: { def: false },   // PDF e impressão na versão clara do tema (quando o tema tem par claro/escuro)
   },
+  biblioteca: {
+    lixeiraDias: { def: 30, min: 1, max: 365 }, // excluída fica restaurável por tantos dias, depois é apagada de vez
+  },
 };
 
 export function preferencesFile(env = process.env, home = os.homedir()) {

package/src/research/research.js

@@ -11,7 +11,7 @@
 // (fontes.json, notas.md e o texto de cada fonte). Sem internet (a rede do banco): avisa e segue sem inventar.
 import fs from "node:fs";
 import path from "node:path";
-import { chat } from "../ai/llm.js";
+import { chat, llmConfig } from "../ai/llm.js";
 import { fetchUrlDoc } from "../ai/context.js";
 import { searchDuckDuckGo } from "./duckduckgo.js";
 import { searchWikipedia } from "./wikipedia.js";
@@ -66,11 +66,12 @@ export async function arxivSearch(q, { limit = 5 } = {}) {
     return { title: tag("title"), url: abs, pdf: abs.replace("/abs/", "/pdf/"), snippet: clip(tag("summary"), 300), date: tag("published").slice(0, 10), arxiv: true };
   });
 }
-// Busca pelo modelo "search" do modelrelay (no OpenRouter, um modelo com ":online": a busca na web dele, por API
-// oficial). O DuckDuckGo direto passou a responder com desafio anti-robô; ele fica como segunda tentativa. Sem o
-// apelido "search" no modelrelay (a rede do banco), não há buscador: a pesquisa avisa e segue sem inventar.
+// Busca pelo modelo de busca configurado (Configurar IA › busca; no OpenRouter, um modelo com ":online": a busca na
+// web dele, por API oficial). O DuckDuckGo direto passou a responder com desafio anti-robô; ele fica como segunda
+// tentativa. Sem modelo de busca (a rede do banco), não há buscador: a pesquisa avisa e segue sem inventar.
 export async function llmSearch(q, { limit = 8 } = {}) {
-  const model = process.env.SAGADECK_SEARCH_MODEL || "search";
+  const model = llmConfig().searchModel;
+  if (!model) throw new Error("sem modelo de busca configurado");
   const r = await chat([{ role: "user", content: `Hoje é ${today()}. Pesquise na web e liste as ${limit} melhores fontes para: ${q}\nPrefira fontes primárias (site oficial, documentação, artigo, imprensa séria); para humor, memes e opiniões sobre cultura, blogs e fóruns também podem ser pertinentes. Para cada uma, o título, a URL completa e exata (a página, não o site), uma frase do que ela traz e a data, se houver.\nResponda só JSON: [{"title": "…", "url": "https://…", "snippet": "…", "date": "…"}]` }], { model, maxTokens: 3000, temperature: 0, reasoningOff: true });
   const t = r.text || "", m = t.match(/```(?:json)?\s*([\s\S]*?)```/), raw = m ? m[1] : t.slice(t.indexOf("["), t.lastIndexOf("]") + 1);
   return (JSON.parse(raw) || []).filter((x) => /^https?:\/\//.test(x?.url || "")).slice(0, limit).map((x) => ({ title: String(x.title || x.url), url: String(x.url), snippet: String(x.snippet || ""), date: String(x.date || "") }));

package/src/runtime/motion.js

@@ -10,6 +10,10 @@ for(const frame of document.querySelectorAll('iframe[data-motion]')){
   document.addEventListener('keydown',begin,true);slide.addEventListener('click',begin,true);
  }
  window.addEventListener('message',e=>{if(e.source!==frame.contentWindow)return;if(e.data?.sagaMotion==='done')finish();if(e.data?.sagaMotion==='ready')activate();if(e.data?.sagaMotion==='start-request'&&slide?.classList.contains('current')&&!done){if(started)finish();else{started=true;send('start');}}});
- const activate=()=>{const active=slide?.classList.contains('current');send('active',active);if(document.documentElement.classList.contains('export')||document.documentElement.dataset.motion==='none'||matchMedia('(prefers-reduced-motion: reduce)').matches)send('poster');if(!active){started=false;done=false;frame.style.visibility='';send('reset');}};
+ const activate=()=>{const active=slide?.classList.contains('current');send('active',active);send('poster',document.documentElement.classList.contains('export')||document.documentElement.dataset.motion==='none'||matchMedia('(prefers-reduced-motion: reduce)').matches);if(!active){started=false;done=false;frame.style.visibility='';send('reset');}};
  frame.addEventListener('load',activate);if(slide)new MutationObserver(activate).observe(slide,{attributes:true,attributeFilter:['class']});
+ // a cena pode ter carregado e dito 'ready' antes deste script escutar: fala com ela já (senão ela não sabe do slide
+ // atual nem do movimento reduzido e anima sem parar)
+ activate();
+ matchMedia('(prefers-reduced-motion: reduce)').addEventListener?.('change',activate);
 }

package/src/studio/ai-chat-route.js

@@ -119,7 +119,7 @@ _${c.naoConfirmados.length} observação(ões) descartada(s): o trecho citado n
         // Sem modelo, ninguém decide nada: nem "o que é X?" nem "resuma" viram edição por palavra-chave
         // (as regras antigas trocavam o layout e enfiavam texto genérico no slide). O deck fica como está.
         return {
-          reply: `A IA está desligada (nenhum LLM respondendo em ${llmConfig().url}), então não mexi em nada. Rode "modelrelay serve" ou defina SAGADECK_LLM_URL e mande de novo.`,
+          reply: `A IA está desligada (${llmConfig().url ? `nenhum LLM respondendo em ${llmConfig().url}` : "não configurada"}), então não mexi em nada. Configure em Configurar IA (provedor e chave) e mande de novo.`,
           spec, actions: [], targetSlide: body.targetSlide, talk: true, mode: "off",
         };
       }

package/src/studio/banner.js

@@ -0,0 +1,18 @@
+// O que o `sagadeck studio` escreve ao subir. A primeira linha é o endereço do Studio, a página que a pessoa abre: antes
+// vinha primeiro o endereço de um serviço de IA à parte, e um agente pedido para "deixar pronto para usar" abria a
+// página dele ou, sem achar o Studio, saía criando uma interface do zero. A IA se configura dentro do Studio.
+import { PROVIDERS } from "../ai/ia-config.js";
+
+const providerName = (ai) => Object.values(PROVIDERS).find((p) => p.url === ai.url)?.label || ai.url;
+
+export function studioBanner({ version, url, library, ai = null, multiuser = false, usersDir = "", pid = process.pid, isLibrary = true }) {
+  const iaLine = !ai || !(ai.url || ai.adaptador)
+    ? "  IA: não configurada. No Studio, clique em IA desligada (ou Configurar IA na biblioteca) e informe provedor e chave."
+    : `  IA: ${providerName(ai)} · texto ${ai.textModel}${ai.source === "variável" ? " (pelas variáveis SAGADECK_LLM_*)" : ""}`;
+  return [
+    `✓ SagaDeck Studio ${version} pronto. Abra no navegador: ${url}${isLibrary ? "  (biblioteca)" : ""}`,
+    multiuser ? `  multiusuário: bibliotecas em ${usersDir}` : `  biblioteca: ${library}`,
+    iaLine,
+    `  processo ${pid}`,
+  ];
+}

package/src/studio/ia-routes.js

@@ -0,0 +1,53 @@
+// Tela "Configurar IA" do Studio: ler (a chave nunca sai inteira), salvar e testar a configuração da IA desta máquina
+// (src/ai/ia-config.js). No multiusuário quem configura é quem administra o servidor (arquivo ou variáveis), não a tela.
+import { PROVIDERS, ROLES, iaFile, loadIA, saveIA, maskedIA, keyOf } from "../ai/ia-config.js";
+import { chat, llmConfig, llmAvailable } from "../ai/llm.js";
+
+const json = (res, status, data) => { res.writeHead(status, { "Content-Type": "application/json", "Cache-Control": "no-store" }); res.end(JSON.stringify(data)); };
+
+// o que veio da tela; a chave em branco mantém a que já está gravada
+function draft(body, current) {
+  const provider = String(body.provider || "");
+  const preset = PROVIDERS[provider];
+  return {
+    provider: preset ? provider : "outro",
+    url: String(body.url || preset?.url || "").trim(),
+    key: String(body.key || "").trim() || current?.key || "",
+    keyEnv: body.key ? "" : String(body.keyEnv ?? current?.keyEnv ?? preset?.keyEnv ?? ""),
+    models: Object.fromEntries(ROLES.map((r) => [r, String(body.models?.[r] || "").trim()])),
+    ...(current?.headers ? { headers: current.headers } : {}),
+    ...(current?.adaptador ? { adaptador: current.adaptador } : {}),
+  };
+}
+
+export async function iaRoutes({ req, res, pathname, opts, readJSON }) {
+  if (pathname === "/api/ia" && req.method === "GET") {
+    const cfg = llmConfig();
+    json(res, 200, { config: maskedIA(loadIA()), file: iaFile(), source: cfg.source, providers: PROVIDERS, roles: ROLES, editable: !opts.multiuser });
+    return true;
+  }
+  if ((pathname === "/api/ia" || pathname === "/api/ia/test") && req.method === "POST") {
+    if (opts.multiuser) { json(res, 403, { error: "No servidor multiusuário, a IA é configurada por quem administra." }); return true; }
+    const body = await readJSON(req);
+    const next = draft(body, loadIA());
+    if (!next.url) { json(res, 400, { error: "Falta o endereço do provedor." }); return true; }
+    if (!next.models.text) { json(res, 400, { error: "Falta o modelo de texto." }); return true; }
+    if (pathname === "/api/ia") {
+      try { const saved = saveIA(next); await llmAvailable({ force: true }); json(res, 200, { ok: true, config: maskedIA(saved) }); }
+      catch (e) { json(res, 400, { error: e.message }); }
+      return true;
+    }
+    // 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 || "",
+      timeoutMs: 60_000, firstTimeoutMs: 60_000 };
+    const t0 = Date.now();
+    try {
+      const r = await chat([{ role: "user", content: "Responda só com a palavra: ok" }], { cfg, maxTokens: 200, think: false, allowTruncated: true, retries: 0 });
+      json(res, 200, { ok: true, text: String(r.text || "").trim().slice(0, 80), model: r.model || cfg.textModel, ms: Date.now() - t0 });
+    } catch (e) { json(res, 200, { ok: false, error: e.message, ms: Date.now() - t0 }); }
+    return true;
+  }
+  return false;
+}

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

@@ -0,0 +1,76 @@
+// Tela "Configurar IA" (editor e biblioteca): provedor, chave e modelos desta máquina, com Testar antes de salvar.
+// A chave fica só nesta máquina (~/.sagadeck/ia.json) e nunca volta inteira para a página.
+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 .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 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" };
+  const HINT = { text: "obrigatório", vision: "opcional; vazio = o de texto", image: "opcional; para gerar ilustrações", search: "opcional; no OpenRouter, um modelo :online" };
+  const esc = (s) => String(s ?? "").replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+  let dialog, info, onSaved = () => {};
+
+  function build() {
+    if (!document.getElementById("ai-cfg-style")) { const st = document.createElement("style"); st.id = "ai-cfg-style"; st.textContent = css; document.head.append(st); }
+    dialog = document.createElement("dialog");
+    dialog.className = "ai-cfg";
+    dialog.id = "ai-settings-dialog";
+    document.body.append(dialog);
+  }
+
+  function form() {
+    const c = info.config || {}, providers = info.providers || {};
+    const provider = c.provider && (providers[c.provider] || c.provider === "outro") ? c.provider : (c.url ? "outro" : "openrouter");
+    dialog.innerHTML = `<h2>Configurar IA</h2>
+      <p>O sagadeck fala direto com o provedor que você escolher. A chave fica só nesta máquina, em <code>${esc(info.file)}</code>.</p>
+      ${info.source === "variável" ? '<p class="warn">As variáveis SAGADECK_LLM_URL / SAGADECK_LLM_KEY estão definidas e valem por cima desta tela.</p>' : ""}
+      ${info.editable ? "" : '<p class="warn">Neste servidor, quem configura a IA é quem administra.</p>'}
+      <label for="ai-cfg-provider">Provedor</label>
+      <select id="ai-cfg-provider" data-f="provider">${Object.entries(providers).map(([k, p]) => `<option value="${k}">${esc(p.label)}</option>`).join("")}<option value="outro">Outro compatível com a API da OpenAI</option></select>
+      <label for="ai-cfg-url">Endereço da API</label>
+      <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])}" spellcheck="false"><small>${HINT[r] || ""}</small></div>`).join("")}</div>
+      <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>`;
+    const sel = dialog.querySelector('[data-f="provider"]'), url = dialog.querySelector('[data-f="url"]');
+    sel.value = provider;
+    url.value = c.url || providers[provider]?.url || "";
+    const sync = () => { const p = providers[sel.value]; if (p) url.value = p.url; url.readOnly = !!p; };
+    sync();
+    sel.onchange = sync;
+    if (!info.editable) dialog.querySelectorAll("input,select,[data-save],[data-test]").forEach((el) => (el.disabled = true));
+    dialog.querySelector("[data-close]").onclick = () => dialog.close();
+    dialog.querySelector("[data-test]").onclick = () => submit("api/ia/test");
+    dialog.querySelector("[data-save]").onclick = () => submit("api/ia");
+  }
+
+  async function submit(endpoint) {
+    const status = dialog.querySelector("[data-status]");
+    const body = { provider: dialog.querySelector('[data-f="provider"]').value, url: dialog.querySelector('[data-f="url"]').value, key: dialog.querySelector('[data-f="key"]').value,
+      models: Object.fromEntries([...dialog.querySelectorAll("[data-model]")].map((el) => [el.dataset.model, el.value])) };
+    status.className = ""; status.textContent = endpoint.endsWith("test") ? "Testando…" : "Salvando…";
+    try {
+      const r = await fetch(endpoint, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) });
+      const j = await r.json();
+      if (!r.ok || j.ok === false) throw new Error(j.error || `HTTP ${r.status}`);
+      if (endpoint.endsWith("test")) { status.className = "ok"; status.textContent = `Funcionou: o modelo ${j.model} respondeu "${j.text}" em ${(j.ms / 1000).toFixed(1)} s.`; return; }
+      info.config = j.config;
+      status.className = "ok"; status.textContent = "Salvo.";
+      onSaved(j.config);
+    } catch (e) { status.className = "err"; status.textContent = (endpoint.endsWith("test") ? "Não funcionou: " : "Não salvou: ") + e.message; }
+  }
+
+  return {
+    async open(saved) {
+      onSaved = typeof saved === "function" ? saved : () => {};
+      if (!dialog) build();
+      info = await (await fetch("api/ia")).json();
+      form();
+      if (!dialog.open) dialog.showModal();
+    },
+  };
+})();

package/src/studio/public/app.js

@@ -3032,27 +3032,8 @@
   // ==========================================================================
   // LLM: STATUS E GERAÇÃO DE DECK
   // ==========================================================================
-  async function openAISettings() {
-    // O console protege-se com frame-ancestors self: abrir numa aba, nunca dentro de iframe.
-    const setupWindow = window.open("about:blank", "sagadeck-ai-setup");
-    let dialog = document.getElementById("ai-settings-dialog");
-    if (!dialog) {
-      dialog = document.createElement("dialog"); dialog.id = "ai-settings-dialog"; dialog.className = "ai-settings-dialog";
-      dialog.innerHTML = '<div class="ai-settings-head"><h2>Configurar IA</h2><button type="button" data-close>Fechar</button></div><p data-ai-info>Verificando a conexão...</p><a data-ai-link target="_blank" rel="noopener" hidden>Abrir configuração do modelrelay</a><button type="button" data-ai-refresh>Verificar conexão</button>';
-      document.body.append(dialog);dialog.querySelector('[data-close]').onclick=()=>dialog.close();
-      dialog.addEventListener('close',()=>refreshAIStatus(true));
-      dialog.querySelector('[data-ai-refresh]').onclick=()=>openAISettings();
-    }
-    if (!dialog.open) dialog.showModal();
-    await refreshAIStatus(true);
-    const info=dialog.querySelector('[data-ai-info]'), link=dialog.querySelector('[data-ai-link]');
-    try {
-      const setup=await (await fetch('api/ai/setup')).json();
-      info.textContent=state.ai.available ? `Conectada · modelo de texto: ${state.ai.textModel}. A configuração abre em uma aba própria.` : 'O serviço de IA não está respondendo. Inicie modelrelay serve neste computador e clique em Verificar conexão.';
-      if(setup.url){link.href=setup.url;link.hidden=false;if(setupWindow){setupWindow.opener=null;setupWindow.location.href=setup.url;dialog.close();}}
-      else {setupWindow?.close();link.hidden=true;}
-    } catch { setupWindow?.close();info.textContent='Não foi possível consultar a configuração. Verifique a conexão e tente novamente.'; }
-  }
+  // Configurar IA: provedor, chave e modelos desta máquina (ai-settings.js)
+  function openAISettings() { window.SagaAISettings.open(() => refreshAIStatus(true)); }
 
   async function refreshAIStatus(force = false) {
     try {
@@ -3065,7 +3046,7 @@
     dom.aiStatus.textContent = on ? "IA ligada" : "IA desligada";
     dom.aiStatus.title = on
       ? `LLM em ${state.ai.url} · texto: ${state.ai.textModel} · imagem: ${state.ai.imageModel}`
-      : `Nenhum LLM em ${state.ai.url || "?"}. Rode "modelrelay serve" ou defina SAGADECK_LLM_URL. Clique para configurar a IA.`;
+      : state.ai.configured ? `Nenhum LLM respondendo em ${state.ai.url}. Clique para conferir o provedor e a chave.` : "A IA não está configurada. Clique para informar provedor e chave.";
     dom.aiStatus.classList.toggle("on", on);
     dom.aiStatus.classList.toggle("off", !on);
   }
@@ -3073,7 +3054,7 @@
   function openAiDeckModal() {
     dom.aiDeckTheme.innerHTML = '<option value="">A IA escolhe</option>' +
       (state.themes || []).map((t) => `<option value="${t}">${t}</option>`).join("");
-    dom.aiDeckStatus.textContent = state.ai.available ? "" : 'Nenhum LLM disponível — rode "modelrelay serve" antes de gerar.';
+    dom.aiDeckStatus.textContent = state.ai.available ? "" : "IA desligada: clique em IA desligada, no alto, para configurar antes de gerar.";
     // cada abertura recomeça do sensato: 15 min viram 10 slides
     dom.aiDeckMinutes.value = "15";
     dom.aiDeckSlides.value = "10";

package/src/studio/public/index.html

@@ -842,6 +842,7 @@
   <script src="fit.js"></script>
   <script src="ui-icons.js"></script>
   <script src="update-notice.js"></script>
+  <script src="ai-settings.js"></script>
   <script src="calc-fields.js"></script>
   <script src="art-preview.js"></script>
   <script src="api-collections.js"></script>

package/src/studio/public/library.html

@@ -31,7 +31,7 @@
   <div class="lib-body">
     <aside class="lib-side">
       <nav id="side" aria-label="Biblioteca"></nav>
-      <a class="lib-btn ghost ai-settings" id="btn-ai" hidden target="_blank" rel="noopener" title="Provedores, chaves e modelos de IA"><i class="ic" data-ic="sliders-horizontal"></i><span class="lbl">modelrelay</span></a>
+      <button type="button" class="lib-btn ghost ai-settings" id="btn-ai" hidden title="Provedores, chaves e modelos de IA"><i class="ic" data-ic="sliders-horizontal"></i><span class="lbl">Configurar IA</span></button>
     </aside>
     <main class="lib-main" id="main" tabindex="-1" aria-live="polite"><div class="initial-loading"><span class="loading-orbit"></span>Preparando seu estúdio…</div></main>
   </div>
@@ -51,6 +51,7 @@
   <div class="ltoast" id="toast" role="status"></div>
   <script src="ui-icons.js"></script>
   <script src="update-notice.js"></script>
+  <script src="ai-settings.js"></script>
   <script src="library.js"></script>
 </body>
 </html>

package/src/studio/public/library.js

@@ -58,8 +58,9 @@
     if (view !== "recentes" && view !== "todas" && view !== "lixeira" && !topicOf(view)) view = "recentes";
     render();
   }
-  // botão IA: a tela de configuração do modelrelay local, quando existe
-  api("api/ai/setup").then(({ url }) => { if (url) { $("#btn-ai").href = url; $("#btn-ai").hidden = false; } }).catch(() => {});
+  // botão IA: provedor, chave e modelos desta máquina (ai-settings.js); no multiusuário quem configura é quem administra
+  api("api/ia").then(({ editable }) => { $("#btn-ai").hidden = !editable; }).catch(() => {});
+  $("#btn-ai").onclick = () => window.SagaAISettings.open();
   const openEditor = (id, present) => { location.href = `editor?deck=${encodeURIComponent(id)}${present ? "&present=1" : ""}`; };
 
   // ---------------------------------------------------------------- barra lateral
@@ -111,7 +112,7 @@
     const match = (d) => !q || d.title.toLowerCase().includes(q);
     const main = $("#main");
     if (view === "lixeira") {
-      main.innerHTML = `<div class="head"><div><h1>Lixeira</h1><div class="sub">Fica aqui por um dia; depois é apagado de vez.</div></div>${data.trash.length ? `<button class="lib-btn ghost danger" data-empty-trash>${ic("trash-2")}Esvaziar lixeira</button>` : ""}</div>` +
+      main.innerHTML = `<div class="head"><div><h1>Lixeira</h1><div class="sub">Fica aqui por ${data.trashDays === 1 ? "um dia" : `${data.trashDays || 30} dias`}; depois é apagado de vez (o prazo se muda em Preferências).</div></div>${data.trash.length ? `<button class="lib-btn ghost danger" data-empty-trash>${ic("trash-2")}Esvaziar lixeira</button>` : ""}</div>` +
         (data.trash.length ? data.trash.map((t) => `<div class="trash-row"><div class="t"><b>${esc(t.title)}</b><div class="sub">Era de ${esc(t.topic || NO_TOPIC.name)} · ${t.slides || 0} slides · excluída ${ago(t.deleted)}</div></div>
           <button class="lib-btn ghost" data-restore="${esc(t.id)}">${ic("rotate-ccw")}Restaurar</button><button class="lib-btn ghost danger" data-purge="${esc(t.id)}">Excluir de vez</button></div>`).join("")
           : `<div class="empty"><div class="big">${ic("trash-2")}</div><h2>Lixeira vazia</h2></div>`);
@@ -211,7 +212,7 @@
       if (a === "open" || a === "present") return openEditor(id, a === "present");
       if (a === "rename") return nameDialog("Renomear apresentação", d.title, (title) => act(() => api("api/library/decks/rename", { id, title }), "Renomeada"));
       if (a === "dup") return act(() => api("api/library/decks/duplicate", { id }), "Cópia criada");
-      if (a === "trash") return act(() => api("api/library/decks/trash", { id }), "Na lixeira — dá para restaurar por um dia");
+      if (a === "trash") return act(() => api("api/library/decks/trash", { id }), `Na lixeira — dá para restaurar por ${data.trashDays === 1 ? "um dia" : `${data.trashDays || 30} dias`}`);
     });
     m.querySelectorAll("[data-move]").forEach((b) => b.onclick = () => { closeMenus(); act(() => api("api/library/decks/move", { id, topic: b.dataset.move }), `Movida para ${topicOf(b.dataset.move).name}`); });
     m.querySelectorAll("[data-dl]").forEach((b) => b.onclick = () => {

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

@@ -15,6 +15,9 @@ window.SagaPrefs = function ({ dom, store, escHtml, escAttr, fold, setAppTheme,
       { k: "ia.autor", type: "text", label: "Seu nome", hint: "Vai na capa e no rodapé das apresentações novas (no lugar de \"Seu Nome\")." },
       { k: "ia.idioma", type: "select", options: [["auto", "O do pedido"], ["português do Brasil", "Português (Brasil)"], ["inglês", "Inglês"], ["espanhol", "Espanhol"]], label: "Idioma do conteúdo gerado" },
     ] },
+    { id: "biblioteca", title: "Biblioteca", items: [
+      { k: "biblioteca.lixeiraDias", type: "select", options: [["1", "1 dia"], ["7", "7 dias"], ["30", "30 dias"], ["90", "90 dias"]], label: "Quanto tempo a lixeira guarda", hint: "Apresentação excluída fica restaurável por esse tempo; depois é apagada de vez." },
+    ] },
     { id: "exportacao", title: "Exportação", items: [
       { k: "exportacao.pdfClaro", type: "bool", label: "PDF na versão clara do tema", hint: "Tema escuro com par claro (ex.: Manual noite) sai claro no PDF, melhor para imprimir." },
     ] },