terminal-smart-cli 0.97.11 → 0.97.13

package/bin/ts.js

@@ -293,6 +293,75 @@ async function imageCmd(args) {
   if (JSON_OUT) console.log(JSON.stringify(output));
   else console.log('\n' + ui.okLine((en ? 'image saved: ' : 'imagem salva: ') + C.cyan(target)) + '\n  ' + C.dim(`${result.model} · ${result.charged} créditos · saldo ${result.remaining}`));
 }
+
+// `ts video` continua analisando URLs. Geração usa um nome separado para não
+// quebrar scripts existentes: `ts gerar-video "descrição"`.
+async function generateVideoCmd(args) {
+  const token = needToken();
+  const en = cfg.lang === 'en';
+  const prompt = args.join(' ').trim() || await readStdin();
+  if (!prompt || prompt.length < 8) throw new ApiError(en ? 'Describe the video.' : 'Descreva o vídeo (mínimo de 8 caracteres).', { code: 'invalid_prompt' });
+  const catalog = await api('/api/ia/video/options', { token });
+  const options = Array.isArray(catalog.options) ? catalog.options : [];
+  let choice = FLAGS.has('--premium') ? 'premium'
+    : (FLAGS.has('--economico') || FLAGS.has('--economy')) ? 'economy'
+      : (FLAGS.has('--sem-video') || FLAGS.has('--none')) ? 'none' : '';
+  if (!choice && (!process.stdin.isTTY || JSON_OUT)) {
+    throw new ApiError(en ? 'Choose --premium, --economy or --none.' : 'Escolha --premium, --economico ou --sem-video. Vídeo pago nunca é aprovado silenciosamente.', { code: 'video_confirmation_required' });
+  }
+  if (!choice) {
+    const byId = id => options.find(option => option.id === id) || {};
+    const economy = byId('economy'), premium = byId('premium');
+    console.log('\n' + ui.box([
+      C.bold(en ? 'Generate video' : 'Gerar vídeo'),
+      C.dim(en ? 'The charge happens only after secure delivery.' : 'A cobrança só acontece depois da entrega segura.'), '',
+      `  ${C.cyan('1')}  ${C.bold(economy.label || 'Econômico · Veo Lite')}  ${C.dim((economy.estimatedCredits || '?') + ' créditos')}${economy.allowed === false ? C.warn(' · requer Pro') : ''}`,
+      `  ${C.cyan('2')}  ${C.bold(premium.label || 'Premium · Sora 2')}  ${C.dim((premium.estimatedCredits || '?') + ' créditos')}${premium.allowed === false ? C.warn(' · requer Pro') : ''}`,
+      `  ${C.cyan('3')}  ${C.bold(en ? 'Do not generate' : 'Não gerar')}  ${C.dim(en ? 'no charge' : 'sem cobrança')}`, '',
+      C.dim((en ? 'Available ' : 'Disponível ') + (catalog.available ?? catalog.remaining ?? 0) + ' créditos'),
+    ], { title: 'ts gerar-video' }));
+    const answer = String(await ui.ask(C.dim(en ? '  Choose 1, 2 or 3 › ' : '  Escolha 1, 2 ou 3 › '))).trim();
+    choice = answer === '1' ? 'economy' : answer === '2' ? 'premium' : 'none';
+  }
+  const selected = options.find(option => option.id === choice);
+  if (!selected || selected.allowed === false) throw new ApiError(en ? 'Video generation requires Pro.' : 'Geração de vídeo requer plano Pro.', { code: 'plan_limit' });
+  if (choice === 'none') { if (JSON_OUT) console.log(JSON.stringify({ ok: true, skipped: true, charged: 0 })); else console.log(ui.infoLine(en ? 'No video generated.' : 'Nenhum vídeo gerado e nenhum crédito cobrado.')); return; }
+  const conversationId = await ensureConv(token);
+  const spinner = JSON_OUT ? { stop() {}, text() {} } : ui.spinner(en ? 'starting video…' : 'iniciando vídeo…').start();
+  let submitted;
+  try {
+    submitted = await api('/api/ia/video', { method: 'POST', token, timeoutMs: 120000, body: { conversationId, prompt, choice, confirmed: true, aspectRatio: '16:9' } });
+    const id = submitted && submitted.job && submitted.job.id;
+    if (!id) throw new Error(en ? 'Video job was not created.' : 'O job de vídeo não foi criado.');
+    let job;
+    for (let attempt = 0; attempt < 180; attempt++) {
+      await new Promise(resolve => setTimeout(resolve, 5000));
+      const state = await api('/api/ia/video/jobs/' + encodeURIComponent(id), { token, timeoutMs: 60000 });
+      job = state.job || {};
+      spinner.text((en ? 'generating video' : 'gerando vídeo') + ` · ${job.progress || 0}%`);
+      if (job.status === 'failed') throw new Error(job.error || (en ? 'Video failed.' : 'Falha ao gerar vídeo.'));
+      if (job.status === 'completed') break;
+    }
+    if (!job || job.status !== 'completed' || !job.contentUrl) throw new Error(en ? 'Video is still processing.' : 'O vídeo continua em processamento no servidor.');
+    const response = await fetch(base() + job.contentUrl, { headers: { 'x-session-token': token }, signal: AbortSignal.timeout(600000) });
+    if (!response.ok) throw new Error('Download HTTP ' + response.status);
+    const fs = require('fs'), os = require('os'), path = require('path');
+    const bytes = Buffer.from(await response.arrayBuffer());
+    if (bytes.length < 1024 || bytes.length > 250 * 1024 * 1024) throw new Error(en ? 'Invalid video payload.' : 'Conteúdo de vídeo inválido.');
+    const target = path.join(os.homedir(), 'Downloads', `terminal-smart-video-${Date.now()}.mp4`);
+    const partial = target + '.partial-' + process.pid;
+    try {
+      fs.writeFileSync(partial, bytes, { flag: 'wx' });
+      fs.renameSync(partial, target);
+    } catch (error) {
+      try { fs.unlinkSync(partial); } catch (_) {}
+      throw error;
+    }
+    const output = { ok: true, path: target, model: job.model, charged: job.charged, choice, seconds: job.seconds };
+    spinner.stop();
+    if (JSON_OUT) console.log(JSON.stringify(output)); else console.log('\n' + ui.okLine((en ? 'video saved: ' : 'vídeo salvo: ') + C.cyan(target)) + '\n  ' + C.dim(`${job.model} · ${job.charged} créditos · ${job.seconds}s`));
+  } finally { spinner.stop(); }
+}
 // Envia uma mensagem na conversa ativa e devolve o texto (recria a conversa 1x se apagada na web).
 async function sendMessage(token, content) {
   const doStream = async (convId) => {
@@ -1734,7 +1803,7 @@ async function metaCmd() {
   // Com --noturno, quando a run PAUSA por falta de crédito, esperamos o intervalo
   // e RE-INVOCAMOS run() — que retoma sozinho do .ts-meta.json — até concluir ou
   // bater um teto (créditos totais / janelas / horas / travamento sem progresso).
-  const RETOMAVEL = new Set(['no_credits', 'budget', 'connection']); // pausas que valem re-tentar
+  const RETOMAVEL = new Set(['no_credits', 'budget', 'connection', 'model_no_action', 'invalid_artifact']); // pausas que valem re-tentar
   const _sleep = (ms) => new Promise(r => setTimeout(r, ms));
   let st = null, janela = 0, prevPend = null, semProgresso = 0;
   const loopStart = Date.now();
@@ -1769,7 +1838,11 @@ async function metaCmd() {
         onRoundDone: ({ checklist, spent }) => {
           sp.stop();
           const d = checklist.filter(i => i.passes).length;
-          console.log('    ' + C.dim(T.meta_progress(d, checklist.length, spent, budget)) + '\n');
+          // On resumed missions `budget` is only the new window size, while
+          // `spent` is cumulative. Display the persisted cumulative ceiling.
+          const live = metaMod.load(dir);
+          const cumulativeBudget = live && Number(live.budget) > 0 ? Number(live.budget) : budget;
+          console.log('    ' + C.dim(T.meta_progress(d, checklist.length, spent, cumulativeBudget)) + '\n');
           sp.text(T.meta_marking).start();
         },
       });
@@ -1835,6 +1908,12 @@ async function metaCmd() {
     console.log('  ' + C.dim('Resolva o bloqueio manualmente e rode "ts meta", ou ajuste o objetivo com --novo.'));
   } else if (st.pause_reason === 'timeout') {
     console.log(ui.infoLine('Tempo limite atingido. Retome com "ts meta".'));
+  } else if (st.pause_reason === 'model_no_action') {
+    console.log(ui.infoLine('O executor respondeu sem criar o artefato. A retomada usará geração direta ou outro modelo; rode "ts meta".'));
+  } else if (st.pause_reason === 'connection') {
+    console.log(ui.infoLine('O provedor interrompeu a geração. O progresso foi salvo; rode "ts meta" para retomar.'));
+  } else if (st.pause_reason === 'invalid_artifact') {
+    console.log(ui.infoLine('O artefato gerado não passou na validação. As partes válidas foram salvas; rode "ts meta".'));
   } else {
     console.log(ui.infoLine(st.pause_reason === 'budget' ? T.meta_paused_budget : T.meta_paused_rounds));
     metaMod.notify(token, T.meta_notify_paused(st.goal, done, st.checklist.length, st.pause_reason));
@@ -2933,11 +3012,18 @@ async function uso() {
 
 async function quem() {
   const token = needToken();
-  let ok = false;
-  try { const chk = await api('/api/auth/check', { token }); ok = !!(chk && (chk.success || chk.authenticated)); } catch (_) {}
+  let ok = false, planoAtual = cfg.plan || '?';
+  try {
+    const [chk, conta] = await Promise.all([
+      api('/api/auth/check', { token }),
+      api('/api/credits', { token }),
+    ]);
+    ok = !!(chk && (chk.success || chk.authenticated));
+    if (conta && conta.plan) planoAtual = conta.plan;
+  } catch (_) {}
   console.log('\n' + ui.box([
     C.dim(T.quem_user + ': ') + C.bold(cfg.username || '?') + (ok ? '  ' + C.ok('•') : '  ' + C.err('• offline')),
-    C.dim(T.quem_plan + ': ') + (cfg.plan || '?'),
+    C.dim(T.quem_plan + ': ') + planoAtual,
     C.dim(T.quem_server + ': ') + base(),
     C.dim(T.quem_conv + ': ') + (cfg.convId ? '#' + cfg.convId : '—'),
   ], { title: T.quem_title }) + '\n');
@@ -2958,13 +3044,22 @@ async function integracoesCmd(args) {
     const [google, microsoft] = await Promise.all([getStatus('google'), getStatus('microsoft')]);
     const data = { google, microsoft };
     if (JSON_OUT) { console.log(JSON.stringify(data)); return; }
-    const line = (label, item) => C.bold(label.padEnd(22)) + (item.connected ? C.ok(en ? 'connected' : 'conectado') + C.dim(item.email ? ` · ${item.email}` : '') : C.dim(en ? 'not connected' : 'não conectado'));
-    console.log('\n' + ui.box([line('Google Workspace', google), line('Microsoft/Outlook', microsoft), '', C.dim(en ? 'Connect: ts integrations connect google|microsoft' : 'Conectar: ts integracoes conectar google|microsoft'), C.dim(en ? 'Manage on web: terminalsmart.com.br/integracoes' : 'Gerenciar na Web: terminalsmart.com.br/integracoes')], { title: en ? 'Integrations' : 'Integrações' }) + '\n');
+    const line = (label, item) => C.bold(label.padEnd(22)) + (item.connected ? C.ok(en ? 'connected' : 'conectado') + C.dim(item.email ? ` · ${item.email}` : '') + C.dim(item.accessLevel ? ` · ${item.accessLevel === 'advanced' ? (en ? 'advanced beta' : 'avançado beta') : (en ? 'essential' : 'essencial')}` : '') : C.dim(en ? 'not connected' : 'não conectado'));
+    console.log('\n' + ui.box([line('Google Workspace', google), line('Microsoft/Outlook', microsoft), '', C.dim(en ? 'Connect: ts integrations connect google [essential|advanced]' : 'Conectar: ts integracoes conectar google [essencial|avancado]'), C.dim(en ? 'Manage on web: terminalsmart.com.br/integracoes' : 'Gerenciar na Web: terminalsmart.com.br/integracoes')], { title: en ? 'Integrations' : 'Integrações' }) + '\n');
+    return;
+  }
+  if (['arquivos', 'files', 'drive'].includes(sub)) {
+    const url = 'https://terminalsmart.com.br/integracoes#google-files';
+    if (JSON_OUT) { console.log(JSON.stringify({ provider: 'google', url })); return; }
+    console.log(ui.infoLine(en ? 'Opening Google Drive file selection…' : 'Abrindo a seleção de arquivos do Google Drive…'));
+    try { require('child_process').exec(process.platform === 'win32' ? `start "" "${url}"` : process.platform === 'darwin' ? `open "${url}"` : `xdg-open "${url}"`); } catch (_) {}
     return;
   }
   if (!provider) { console.error(ui.infoLine(en ? 'Choose google or microsoft.' : 'Escolha google ou microsoft.')); process.exit(2); }
   if (['conectar', 'connect', 'reconectar', 'reconnect'].includes(sub)) {
-    const data = await api(`/api/integrations/${provider}/connect`, { method: 'POST', token, body: { source: 'cli' } });
+    const requestedLevel = String(args[2] || '').toLowerCase();
+    const accessLevel = provider === 'google' && ['avancado', 'advanced'].includes(requestedLevel) ? 'advanced' : 'essential';
+    const data = await api(`/api/integrations/${provider}/connect`, { method: 'POST', token, body: { source: 'cli', ...(provider === 'google' ? { accessLevel } : {}) } });
     if (JSON_OUT) { console.log(JSON.stringify({ provider, authUrl: data.authUrl })); return; }
     console.log('\n' + ui.box([C.bold(en ? `Authorize ${names[provider]}` : `Autorize ${names[provider]}`), '', data.authUrl, '', C.dim(en ? 'After authorization, run: ts integrations' : 'Depois de autorizar, rode: ts integracoes')], { title: 'OAuth' }) + '\n');
     try { require('child_process').exec(process.platform === 'win32' ? `start "" "${data.authUrl}"` : process.platform === 'darwin' ? `open "${data.authUrl}"` : `xdg-open "${data.authUrl}"`); } catch (_) {}
@@ -2977,7 +3072,7 @@ async function integracoesCmd(args) {
     await api(`/api/integrations/${provider}/disconnect`, { method: 'POST', token, body: { confirmed: true } });
     console.log(ui.okLine(`${names[provider]} ${en ? 'disconnected' : 'desconectado'}`)); return;
   }
-  console.log(ui.infoLine(en ? 'Usage: ts integrations [status|connect|disconnect] [google|microsoft]' : 'Uso: ts integracoes [status|conectar|desconectar] [google|microsoft]'));
+  console.log(ui.infoLine(en ? 'Usage: ts integrations [status|connect|disconnect|files] [google|microsoft] [essential|advanced]' : 'Uso: ts integracoes [status|conectar|desconectar|arquivos] [google|microsoft] [essencial|avancado]'));
 }
 
 function idioma(l) {
@@ -3046,6 +3141,7 @@ function recallCmd(args) {
     case 'logout': return logout();
     case 'chat': case 'conversa': return chatRepl();
     case 'imagem': case 'image': case 'img': return imageCmd(POS.slice(1));
+    case 'gerar-video': case 'video-gerar': case 'generate-video': return generateVideoCmd(POS.slice(1));
     case 'quem': case 'whoami': return quem();
     case 'nova': case 'new':    return nova();
     case 'run':    return runCmd(POS.slice(1));
@@ -3102,6 +3198,9 @@ function recallCmd(args) {
         if (/^\s*(?:(?:quero|preciso)\s+(?:que\s+)?(?:voc[eê]\s+)?|(?:por favor[,\s]+)?)?(?:gere|gerar|crie|criar|fa[çc]a|produza|desenhe|ilustre|edite)\s+(?:uma|a|minha)?\s*(?:imagem|foto|ilustra[çc][aã]o|arte|banner|capa|mockup)\b/i.test(text)) {
           return imageCmd([text]);
         }
+        if (/^\s*(?:(?:quero|preciso)\s+(?:que\s+)?(?:voc[eê]\s+)?|(?:por favor[,\s]+)?)?(?:gere|gerar|crie|criar|fa[çc]a|produza)\s+(?:um|o|meu)?\s*(?:vídeo|video|clipe)\b/i.test(text)) {
+          return generateVideoCmd([text]);
+        }
         const r = await router.route(text, cfg.token);
         if (r.dest === 'agente') { console.log('  ' + C.cyan('⚙') + ' ' + C.dim(T.route_agent)); return agentCmd([text]); }
         if (r.dest === 'run') { console.log('  ' + C.indigo('◆') + ' ' + C.dim(T.route_run)); return runCmd([text]); }

package/lib/agent.js

@@ -115,7 +115,7 @@ REGRAS:
 - NÃO DESISTA sem TENTAR: é PROIBIDO responder "não tenho acesso" / "não consigo" / "preciso que você me passe X" enquanto houver uma ferramenta que você ainda não usou pra tentar. Antes de declarar que algo é impossível, AJA: conecte (conectar_vps), procure (buscar_arquivos, ou grep/find via executar_comando/executar_remoto), leia (ler_arquivo). Ex.: pediram pra ler um código-fonte que "você não tem"? Se há uma VPS/pasta onde ele pode estar, CONECTE e procure (grep -rn "<símbolo>" <dir>) ANTES de dizer que não tem. Só afirme que não conseguiu DEPOIS de ter tentado de fato e mostre o erro/saída REAL que te barrou.
 - NUNCA pergunte "onde está o arquivo X?" / "há um diretório com Y?" / "posso gerar Z?" sem ANTES ter PROCURADO de fato: rode find/buscar_arquivos por ele em TODOS os lugares plausíveis — na VPS conectada (find / -name "arquivo" 2>/dev/null, e nas pastas do projeto) E na máquina local do usuário (buscar_arquivos, incluindo o pack/instalação de origem que ele citou). Se um config/arquivo obrigatório faltar mesmo depois de procurar, tente ACHAR um exemplo/modelo (outro .conf parecido, o default no código-fonte) e GERAR a partir dele — só peça ajuda ao usuário como ÚLTIMO recurso, dizendo exatamente onde já procurou e não achou.
 - BINÁRIO NATIVO: ao subir/instalar um executável numa máquina, valide com file (arquitetura: 32 vs 64-bit) E ldd (as bibliotecas resolvem?) ANTES de declarar "pronto/instalado" — "está no lugar" NÃO é "roda". Se ldd mostrar "not found", instale a lib faltante e revalide.
-- WINDOWS / SHELL BASH: o shell aqui é o bash do Git, NÃO o cmd. (a) "node -e"/"python -c" com várias linhas ou com import() FALHA — escreva um arquivo .mjs/.py e rode "node arquivo.mjs"/"python arquivo.py". (b) pra ESPERAR use "sleep N" (NUNCA "timeout /t", que é do cmd e quebra no bash). (c) comandos que só existem no cmd (dir, type, if exist) rode via "cmd /c \"...\"". (d) pra matar um servidor/processo de teste, ache o PID pela PORTA ("netstat -ano | findstr :PORTA" → "taskkill /PID <pid> /F") — NUNCA por imagem ("taskkill /IM node.exe" mata processos não relacionados, inclusive os do usuário).
+- WINDOWS / SHELL CMD: executar_comando usa cmd.exe. (a) use "dir", "mkdir pasta", "type"; NUNCA "mkdir -p", "ls", "rm" ou caminhos "/c/..."; (b) para PowerShell, chame "powershell -NoProfile -Command ..."; (c) "node -e"/"python -c" multilinha falha — escreva .mjs/.py; (d) para esperar use "timeout /t N /nobreak"; (e) mate servidor pelo PID da PORTA (netstat/findstr e taskkill /PID), nunca por imagem.
 - PROVE O CAMINHO REAL antes de declarar "pronto/corrigido": "testes de API passando" NÃO é "o app funciona". Se há UI ou rotas condicionais (por papel/role, por filtro), rode o FLUXO EXATO do usuário afetado — a tela/rota que quebrava — e veja o resultado; numa entrega WEB, verifique com olhos (navegador). Em fix de código com ramos (SQL com subqueries/parâmetros, condicional por role): conte placeholder-a-placeholder e rode de novo o caminho que falhava. Só diga "corrigido" COM a prova verde do caminho real — e NÃO peça pro usuário rodar a prova que você mesmo consegue rodar. Se subir um server de teste, ENCERRE-o (por PID) ao terminar — não deixe processo órfão na porta.
 - DEPLOY EM CONTAINER: edite sempre a FONTE (o diretório do projeto no host, ex /opt/projects/<app>, ou o código local), NUNCA dentro do container (/app/... é efêmero) — o "docker build" monta a imagem a partir da FONTE, então um fix feito dentro do container SOME no rebuild e você fica achando que corrigiu. Do mesmo jeito: NUNCA inclua arquivos de segredo (.env) no pacote/tar de deploy — o .env de exemplo do repo sobrescreve o .env REAL do servidor e a app volta pro modo stub. Ao recriar um container, repasse rede, portas, volumes E o --env-file que ele já tinha.
 - SEU PRÓPRIO TESTE PODE ESTAR ERRADO: antes de confiar num veredito "FALHOU", confira a ASSERÇÃO (HTTP 200/201 é SUCESSO, não falha; 401/403 numa rota protegida sem token é o comportamento CORRETO). E não re-leia/re-escreva o MESMO arquivo várias vezes: se você já leu, use o que leu.
@@ -134,7 +134,7 @@ RULES:
 - Prefer READ commands to diagnose before changing anything.
 - Destructive commands go through user approval; if denied, explain and offer a safe alternative.
 - NEVER expose or ask for secrets (.env, keys, passwords, tokens); never send data off this machine.
-- Windows: multi-line python -c fails silently — write a .py with escrever_arquivo and run "python file.py".
+- Windows: executar_comando runs cmd.exe. Use native commands (dir, mkdir folder, type) or call PowerShell explicitly. NEVER use mkdir -p, ls, rm, or /c/... paths. Put multiline Python in a .py file created with escrever_arquivo.
 - If a dependency is missing, install it (winget/apt/pip/npm) and continue.
 - LINUX/apt: NEVER run a bare "apt-get install" — on a freshly-created machine unattended-upgrades holds the apt lock and the install HANGS silently (no output). ALWAYS install like this: "sudo DEBIAN_FRONTEND=noninteractive apt-get -o DPkg::Lock::Timeout=600 install -y <packages>" (the -o Lock::Timeout WAITS for the lock up to 10min instead of hanging; noninteractive+-y avoids prompts that block without a TTY). Use "add-apt-repository -y" + "apt-get update" for PPAs. A command that doesn't return in ~1min is likely stuck on the lock/prompt — don't wait forever.
 - STARTING A DAEMON/SERVICE in the background on a VPS (via executar_remoto): NEVER run the binary directly or use just "nohup cmd &" — the SSH channel WAITS on the process (a service never exits) and TIMES OUT; then you think it hung and RETRY (loop). ALWAYS use this pattern, which detaches the process from SSH and RETURNS immediately: "setsid nohup ./daemon args >log 2>&1 </dev/null & echo started" (setsid + redirecting ALL fds, INCLUDING stdin with </dev/null, is what frees the channel). Then confirm it's up with pgrep/ss in a SEPARATE call. If the start still times out, the daemon is likely failing at init (run it in the FOREGROUND with a short timeout to see the real error and fix it) — do NOT repeat the same start.
@@ -145,7 +145,7 @@ RULES:
 - DON'T GIVE UP without TRYING: it is FORBIDDEN to answer "I don't have access" / "I can't" / "I need you to give me X" while there's a tool you haven't used yet to try. Before declaring something impossible, ACT: connect (conectar_vps), search (buscar_arquivos, or grep/find via executar_comando/executar_remoto), read (ler_arquivo). E.g. asked to read source code you "don't have"? If there's a VPS/folder where it might live, CONNECT and search (grep -rn "<symbol>" <dir>) BEFORE saying you don't have it. Only claim you couldn't do it AFTER actually trying, and show the REAL error/output that blocked you.
 - NEVER ask "where is file X?" / "is there a folder with Y?" / "may I generate Z?" without having actually SEARCHED first: run find/buscar_arquivos for it in EVERY plausible place — on the connected VPS (find / -name "file" 2>/dev/null, and the project folders) AND on the user's local machine (buscar_arquivos, including the source pack/install they mentioned). If a required config/file is still missing after searching, try to FIND a template/example (a similar .conf, the default in the source) and GENERATE from it — only ask the user as a LAST resort, stating exactly where you already looked and didn't find it.
 - NATIVE BINARY: when uploading/installing an executable on a machine, validate with file (architecture: 32 vs 64-bit) AND ldd (do the libraries resolve?) BEFORE declaring "done/installed" — "it's in place" is NOT "it runs". If ldd shows "not found", install the missing lib and re-validate.
-- WINDOWS / BASH SHELL: the shell here is Git bash, NOT cmd. (a) "node -e"/"python -c" with multiple lines or with import() FAILS — write a .mjs/.py file and run "node file.mjs"/"python file.py". (b) to WAIT use "sleep N" (NEVER "timeout /t", which is cmd and breaks in bash). (c) cmd-only commands (dir, type, if exist) run via "cmd /c \"...\"". (d) to kill a test server/process, find the PID by PORT ("netstat -ano | findstr :PORT" → "taskkill /PID <pid> /F") — NEVER by image ("taskkill /IM node.exe" kills unrelated processes, including the user's).
+- WINDOWS / CMD SHELL: executar_comando runs cmd.exe. (a) use dir, mkdir folder, type; NEVER mkdir -p, ls, rm, or /c/... paths; (b) call PowerShell explicitly when needed; (c) put multiline node/python code in .mjs/.py files; (d) wait with timeout /t N /nobreak; (e) kill a server by its PORT PID, never by image name.
 - PROVE THE REAL PATH before declaring "done/fixed": "API tests passing" is NOT "the app works". If there's UI or conditional routes (by role, by filter), run the EXACT flow of the affected user — the screen/route that was breaking — and see the result; on a WEB deliverable, verify with eyes (browser). In a code fix with branches (SQL with subqueries/params, role conditionals): count placeholder-by-placeholder and re-run the path that was failing. Only say "fixed" WITH green proof of the real path — and do NOT ask the user to run a proof you can run yourself. If you start a test server, SHUT IT DOWN (by PID) when done — don't leave an orphan process on the port.
 - CONTAINER DEPLOY: always edit the SOURCE (the project dir on the host, e.g. /opt/projects/<app>, or the local code), NEVER inside the container (/app/... is ephemeral) — "docker build" builds the image FROM THE SOURCE, so a fix made inside the container VANISHES on rebuild while you think it's fixed. Likewise: NEVER include secret files (.env) in the deploy tar/package — the repo's sample .env overwrites the REAL server .env and the app falls back to stub mode. When recreating a container, re-pass its network, ports, volumes AND the --env-file it had.
 - YOUR OWN TEST MAY BE WRONG: before trusting a "FAILED" verdict, check the ASSERTION (HTTP 200/201 is SUCCESS, not failure; 401/403 on a protected route without a token is the CORRECT behavior). And don't re-read/re-write the SAME file repeatedly: if you already read it, use what you read.
@@ -162,7 +162,7 @@ RULES:
 // fechamento garantido pra o modelo não tentar chamar ferramenta de novo).
 // Ferramentas SÓ-LEITURA: usadas no modo Ask (--ler), no Plan (--plano) e no sub-agente
 // de exploração (nunca escrevem/rodam comando destrutivo → seguras por construção).
-const READONLY = new Set(['ler_arquivo', 'ler_documento', 'ler_apresentacao', 'listar_diretorio', 'buscar_arquivos', 'buscar_codigo', 'mapa_projeto', 'info_sistema', 'buscar_web', 'buscar_skill', 'android_dispositivos', 'android_logs', 'status_microsoft365', 'listar_emails_outlook', 'ler_email_outlook', 'listar_pastas_outlook', 'obter_anexo_outlook', 'status_google_workspace', 'listar_emails_gmail', 'ler_email_gmail', 'listar_pastas_gmail', 'obter_anexo_gmail', 'listar_arquivos_drive', 'ler_google_docs', 'ler_google_sheets']);
+const READONLY = new Set(['ler_arquivo', 'ler_documento', 'ler_apresentacao', 'listar_diretorio', 'buscar_arquivos', 'buscar_codigo', 'mapa_projeto', 'info_sistema', 'buscar_web', 'buscar_skill', 'android_dispositivos', 'android_logs', 'status_microsoft365', 'listar_emails_outlook', 'ler_email_outlook', 'listar_pastas_outlook', 'obter_anexo_outlook', 'status_google_workspace', 'listar_emails_gmail', 'ler_email_gmail', 'listar_pastas_gmail', 'obter_anexo_gmail', 'listar_arquivos_drive', 'selecionar_arquivos_drive', 'ler_google_docs', 'ler_google_sheets']);
 
 function scopeToolDefs(defs, allowedTools) {
   if (!Array.isArray(allowedTools)) return defs;
@@ -170,8 +170,8 @@ function scopeToolDefs(defs, allowedTools) {
   return defs.filter(def => allow.has(def && def.function && def.function.name));
 }
 const DEVICE_MUTATING = new Set(['android_parear', 'android_conectar', 'android_instalar', 'android_iniciar', 'android_capturar_tela']);
-const CLOUD_MUTATING = new Set(['conectar_microsoft365', 'alterar_email_outlook', 'criar_resposta_outlook', 'criar_encaminhamento_outlook', 'criar_rascunho_outlook', 'enviar_rascunho_outlook', 'alterar_email_gmail', 'criar_resposta_gmail', 'criar_encaminhamento_gmail', 'criar_rascunho_gmail', 'enviar_rascunho_gmail', 'editar_google_docs', 'editar_google_sheets']);
-async function llm({ baseUrl, key, messages, model, signalMs = 180000, noTools = false, toolsOverride = null, onRetry = null }) {
+const CLOUD_MUTATING = new Set(['conectar_microsoft365', 'alterar_email_outlook', 'criar_resposta_outlook', 'criar_encaminhamento_outlook', 'criar_rascunho_outlook', 'enviar_rascunho_outlook', 'alterar_email_gmail', 'criar_resposta_gmail', 'criar_encaminhamento_gmail', 'criar_rascunho_gmail', 'enviar_rascunho_gmail', 'criar_google_docs', 'editar_google_docs', 'criar_google_sheets', 'editar_google_sheets']);
+async function llm({ baseUrl, key, messages, model, signalMs = 180000, noTools = false, toolsOverride = null, onRetry = null, creditBudget = null }) {
   // RESILIÊNCIA: o gateway CDC pode reiniciar/oscilar no meio de uma missão longa.
   // withRetry cobre conn/timeout/5xx (backoff+jitter); NUNCA re-tenta no_credits/auth.
   return withRetry(async () => {
@@ -181,7 +181,13 @@ async function llm({ baseUrl, key, messages, model, signalMs = 180000, noTools =
     try {
       res = await fetch(baseUrl.replace(/\/+$/, '') + '/chat/completions', {
         method: 'POST', signal: ctrl.signal,
-        headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + key },
+        headers: {
+          'Content-Type': 'application/json',
+          'Authorization': 'Bearer ' + key,
+          ...(Number.isFinite(Number(creditBudget)) && Number(creditBudget) > 0
+            ? { 'X-TS-Credit-Budget': String(Math.floor(Number(creditBudget))) }
+            : {}),
+        },
         body: JSON.stringify({ model: model || DEFAULT_EXECUTOR, messages, ...(noTools ? {} : { tools: toolsOverride || tools.DEFS, tool_choice: 'auto' }), stream: false }),
       });
     } catch (_) { clearTimeout(timer); throw new ApiError('conn', { code: 'conn' }); }
@@ -192,7 +198,13 @@ async function llm({ baseUrl, key, messages, model, signalMs = 180000, noTools =
       // marca code:'no_credits' pra virar CTA de upgrade limpo, nunca "HTTP 402" cru.
       const _em = (j && (j.error?.message || j.error || j.message)) || ('HTTP ' + res.status);
       const _cap = res.status === 402 || (res.status === 429 && /cost_cap|tenant_cost|teto|insufficient|quota|no_credits/i.test(JSON.stringify((j && j.error) || j || '')));
-      throw new ApiError(_em, { status: res.status, code: (j && j.code) || (_cap ? 'no_credits' : '') });
+      const _providerCode = j && ((j.error && j.error.code) || j.code);
+      const err = new ApiError(_em, { status: res.status, code: _providerCode === 'mission_credit_budget' ? 'mission_budget' : (_providerCode || (_cap ? 'no_credits' : '')) });
+      if (_providerCode === 'mission_credit_budget') {
+        err.creditsRequired = Number(j?.error?.creditsRequired) || 0;
+        err.creditsAvailable = Number(j?.error?.creditsAvailable) || 0;
+      }
+      throw err;
     }
     const ch = (j.choices && j.choices[0]) || {};
     return { msg: ch.message || { content: '' }, usage: j.usage || {}, model: j.model || 'smart', billing: j.ts_billing || null };
@@ -225,7 +237,11 @@ function isCycle(sigs) {
 // Veredito do watchdog (PURO, testável): 'break' | 'warn' | 'ok'.
 //   break = 2º strike (repetiu demais OU já avisado e ainda em ciclo) → encerra o loop.
 //   warn  = 1º strike (bateu o limite de repetição OU 1º ciclo) e ainda não avisou ESTA sig.
-function loopDecision({ nSig, cycling, warnedThis, loopWarned, WARN, BREAK }) {
+function loopDecision({ nSig, cycling, warnedThis, loopWarned, WARN, BREAK, cacheHit = false }) {
+  // Uma leitura idêntica já atendida pelo cache não é ausência de progresso:
+  // ela não consulta a fonte, não cria efeito colateral e deve voltar ao modelo
+  // como referência curta. O watchdog continua valendo para execuções reais.
+  if (cacheHit) return 'cache';
   if (nSig >= BREAK || (cycling && loopWarned)) return 'break';
   if ((nSig >= WARN || cycling) && !warnedThis) return 'warn';
   return 'ok';
@@ -607,7 +623,7 @@ async function run(task, opts = {}) {
         const sys = lang !== 'en'
           ? 'Resuma a conversa de agente abaixo em UM bloco curto e denso (máx ~300 palavras): objetivo, o que já foi feito (arquivos/comandos e resultados), decisões tomadas e o que falta. Preserve caminhos de arquivos e fatos técnicos EXATOS. Sem preâmbulo.'
           : 'Summarize the agent conversation below into ONE short dense block (max ~300 words): goal, what was done (files/commands and results), decisions, and what remains. Preserve EXACT file paths and technical facts. No preamble.';
-        const r = await llm({ baseUrl: k.baseUrl, key: k.key, model: selectedModel, noTools: true, signalMs: 60000, messages: [{ role: 'system', content: sys }, { role: 'user', content: lines }] });
+        const r = await llm({ baseUrl: k.baseUrl, key: k.key, model: selectedModel, noTools: true, signalMs: 60000, creditBudget: Math.max(1, maxCredits - charged - _visionCredits), messages: [{ role: 'system', content: sys }, { role: 'user', content: lines }] });
         const u = r.usage || {};
         acc.inTok += u.prompt_tokens || 0; acc.outTok += u.completion_tokens || 0;
         charged += (r.billing && r.billing.charged) || 0;
@@ -648,14 +664,19 @@ async function run(task, opts = {}) {
     // gateway oscilou → mostra "reconectando" em vez de morrer calado (confiabilidade visível)
     const _onGwRetry = (e) => onStep({ name: 'gateway', detail: (lang !== 'en' ? 'reconectando ' : 'reconnecting ') + e.attempt + '/' + e.tries + ' (' + e.reason + ')', retry: true });
     try {
-      r = await llm({ baseUrl: k.baseUrl, key: k.key, messages, model: selectedModel, toolsOverride: mainTools, onRetry: _onGwRetry });
+      r = await llm({ baseUrl: k.baseUrl, key: k.key, messages, model: selectedModel, toolsOverride: mainTools, onRetry: _onGwRetry, creditBudget: Math.max(1, maxCredits - charged - _visionCredits) });
     } catch (e) {
+      if (e instanceof ApiError && e.code === 'mission_budget') {
+        guardStopped = { kind: 'credits', limit: maxCredits, spent: charged + _visionCredits,
+          required: e.creditsRequired || 0, available: e.creditsAvailable || maxCredits };
+        break;
+      }
       // Estourou a janela mesmo assim (turno gigante)? Compacta FORÇADO e tenta 1x —
       // o erro de contexto nunca chega cru ao usuário se der pra recuperar.
       const ctxErr = e instanceof ApiError && e.status === 400 && /context|length|token|maximum|too (long|large)/i.test(String(e.message || ''));
       if (!ctxErr) throw e;
       await _compactIfNeeded(true);
-      r = await llm({ baseUrl: k.baseUrl, key: k.key, messages, model: selectedModel, toolsOverride: mainTools });
+      r = await llm({ baseUrl: k.baseUrl, key: k.key, messages, model: selectedModel, toolsOverride: mainTools, creditBudget: Math.max(1, maxCredits - charged - _visionCredits) });
     }
     const u = r.usage || {};
     acc.inTok += u.prompt_tokens || 0; acc.outTok += u.completion_tokens || 0;
@@ -695,13 +716,22 @@ async function run(task, opts = {}) {
         result = { erro: 'MISSÃO INTERROMPIDA PELO LIMITE DE CUSTO/TEMPO. Esta ferramenta não foi executada.', guard: guardStopped };
       }
 
-      // ── WATCHDOG anti-loop: mede repetição ANTES de qualquer gate/execução ──
+      // Consulta o cache antes do watchdog, mas só entrega o resultado depois dos gates
+      // de segurança. Assim uma leitura repetida não vira falso loop, sem permitir que
+      // cache contorne escopo estrito, modo somente leitura ou outras políticas.
+      const _cachedRead = READONLY.has(name) ? _missionCache.get(name, input) : null;
+
+      // ── WATCHDOG anti-loop: mede somente chamadas que realmente precisariam executar ──
       const _sig = loopSig(name, input);
-      _recentSigs.push(_sig); if (_recentSigs.length > 8) _recentSigs.shift();
-      const _nSig = (_callCounts.get(_sig) || 0) + 1; _callCounts.set(_sig, _nSig);
-      const _cycling = isCycle(_recentSigs);
+      let _nSig = _callCounts.get(_sig) || 0;
+      let _cycling = false;
+      if (!_cachedRead) {
+        _recentSigs.push(_sig); if (_recentSigs.length > 8) _recentSigs.shift();
+        _nSig++; _callCounts.set(_sig, _nSig);
+        _cycling = isCycle(_recentSigs);
+      }
       const _verdict = loopedOut ? 'ended'
-        : loopDecision({ nSig: _nSig, cycling: _cycling, warnedThis: _warnedSigs.has(_sig), loopWarned: _loopWarned, WARN: LOOP_WARN, BREAK: LOOP_BREAK });
+        : loopDecision({ nSig: _nSig, cycling: _cycling, warnedThis: _warnedSigs.has(_sig), loopWarned: _loopWarned, WARN: LOOP_WARN, BREAK: LOOP_BREAK, cacheHit: !!_cachedRead });
       if (_verdict === 'ended') {
         // um tc anterior deste lote já disparou o corte → os demais fecham sem executar
         result = { erro: lang !== 'en' ? 'LOOP encerrado — não execute mais ferramentas; conclua.' : 'LOOP ended — do not run more tools; conclude.' };
@@ -985,7 +1015,7 @@ async function run(task, opts = {}) {
         steps++; _ran = true;
       }
       if (result === undefined && READONLY.has(name)) {
-        const _cached = _missionCache.get(name, input);
+        const _cached = _cachedRead;
         if (_cached) {
           const _visible = messages.some(m => m && m.role === 'tool' && m.tool_call_id === _cached.toolCallId);
           _cachedContent = cacheReference(_cached, name, _visible);
@@ -1098,7 +1128,7 @@ async function run(task, opts = {}) {
       ? 'PARE de usar ferramentas. Você atingiu o limite de passos (ou não produziu uma resposta em texto). Escreva AGORA, em português, um fechamento CURTO e honesto pro usuário: o que você tentou, o que descobriu e o que ainda falta OU o que você precisa dele pra concluir (ex.: confirmar o caminho completo de um arquivo). Não invente resultado nem chame ferramenta.'
       : 'STOP using tools. You hit the step limit (or produced no text answer). Write NOW a SHORT, honest closing for the user: what you tried, what you found, and what is still missing OR what you need from them to finish (e.g. confirm a file\'s full path). Do not invent results or call tools.';
     try {
-      const r = await llm({ baseUrl: k.baseUrl, key: k.key, messages: [...messages, { role: 'user', content: pedido }], model: selectedModel, noTools: true, signalMs: 60000 });
+      const r = await llm({ baseUrl: k.baseUrl, key: k.key, messages: [...messages, { role: 'user', content: pedido }], model: selectedModel, noTools: true, signalMs: 60000, creditBudget: Math.max(1, maxCredits - charged - _visionCredits) });
       const u = r.usage || {};
       acc.inTok += u.prompt_tokens || 0; acc.outTok += u.completion_tokens || 0;
       charged += (r.billing && r.billing.charged) || 0;

package/lib/api.js

@@ -9,7 +9,10 @@ class ApiError extends Error {
 
 // ── RESILIÊNCIA a queda de gateway (backend + CDC de IA) ─────────────────────
 // Status HTTP transitórios (vale re-tentar). 402/401/4xx-de-lógica NÃO entram.
-function isRetryableStatus(s) { return s === 408 || s === 425 || s === 429 || s === 500 || s === 502 || s === 503 || s === 504; }
+function isRetryableStatus(s) {
+  return s === 408 || s === 425 || s === 429 || s === 500 || s === 502 || s === 503 || s === 504
+    || (s >= 520 && s <= 527); // Cloudflare/origin transitórios, incluindo timeout 524
+}
 // Re-tenta fn com backoff exponencial + jitter. NUNCA re-tenta erros de lógica
 // (sem crédito, auth, contexto, 4xx não-transitório). onRetry avisa a UI.
 async function withRetry(fn, { tries = 3, baseMs = 500, onRetry = null, connOnly = false } = {}) {
@@ -26,7 +29,11 @@ async function withRetry(fn, { tries = 3, baseMs = 500, onRetry = null, connOnly
       const fatal = code === 'no_credits' || code === 'auth' || code === 'context'
         || st === 401 || st === 402 || st === 403 || st === 404 || st === 409 || st === 422
         || (st >= 400 && st < 500 && !isRetryableStatus(st));
-      if (fatal || !retryable || attempt === tries) throw e;
+      // A 524 already consumed the proxy's long origin timeout. One retry is
+      // enough; repeated 524s should return control so the model router can
+      // switch provider instead of freezing a mission for many minutes.
+      const slowGatewayTimeoutExhausted = st === 524 && attempt >= 2;
+      if (fatal || !retryable || attempt === tries || slowGatewayTimeoutExhausted) throw e;
       const wait = Math.round(baseMs * Math.pow(2.5, attempt - 1) * (0.75 + Math.random() * 0.5));
       if (onRetry) { try { onRetry({ attempt, tries, waitMs: wait, reason: code || ('http_' + st) }); } catch (_) {} }
       await new Promise(r => setTimeout(r, wait));

package/lib/intelligence-core.js

@@ -9,7 +9,9 @@
 const crypto = require('crypto');
 
 const INTELLIGENCE_CONTRACT = 1;
-const PRICE_REVISION = '2026-08-06';
+// Keep this machine-readable. Human/provider notes belong in commit history;
+// catalogFreshness appends an ISO time before parsing this value.
+const PRICE_REVISION = '2026-08-11';
 
 const MODEL_CATALOG = Object.freeze({
   smart: {
@@ -28,7 +30,7 @@ const MODEL_CATALOG = Object.freeze({
   },
   'deepseek-v4-pro': {
     upstreamId: 'deepseek/deepseek-v4-pro',
-    provider: 'deepseek', contextWindow: 1048576, price: { input: 0.435, output: 0.87, cachedInput: 0.003625 },
+    provider: 'deepseek', contextWindow: 1048576, price: { input: 0.63168, output: 1.26336, cachedInput: 0.063168 },
     capabilities: ['tools', 'code', 'planning', 'review', 'long-context'], toolReliability: 0.95, quality: 0.93,
   },
   'gemini-2.5-flash-lite': {
@@ -63,7 +65,7 @@ const MODEL_CATALOG = Object.freeze({
   },
   'glm-5.2': {
     upstreamId: 'z-ai/glm-5.2',
-    provider: 'zai', contextWindow: 200000, price: { input: 0.7644, output: 2.4024, cachedInput: 0.15288 },
+    provider: 'zai', contextWindow: 1048576, price: { input: 0.76, output: 2.42, cachedInput: 0.152 },
     capabilities: ['tools', 'planning', 'code', 'long-context'], toolReliability: 0.88, quality: 0.89,
   },
   'mimo-v2.5': {
@@ -83,19 +85,24 @@ const MODEL_CATALOG = Object.freeze({
   },
   'gpt-5.6-terra': {
     upstreamId: 'openai/gpt-5.6-terra',
-    provider: 'openai', contextWindow: 1000000, price: { input: 2.50, output: 15.00, cachedInput: 0.25 },
+    provider: 'openai', contextWindow: 1050000, price: { input: 1.00, output: 6.00, cachedInput: 0.10 },
     capabilities: ['tools', 'code', 'planning', 'review', 'long-context'], toolReliability: 0.96, quality: 0.95,
   },
   'gpt-5.6-luna': {
     upstreamId: 'openai/gpt-5.6-luna',
-    provider: 'openai', contextWindow: 1000000, price: { input: 1.00, output: 6.00, cachedInput: 0.10 },
-    capabilities: ['tools', 'code', 'planning', 'execution', 'summarization', 'review', 'long-context'], toolReliability: 0.93, quality: 0.89,
+    provider: 'openai', contextWindow: 1050000, price: { input: 0.10, output: 0.60, cachedInput: 0.01 },
+    capabilities: ['tools', 'code', 'planning', 'execution', 'summarization', 'review', 'vision', 'long-context'], toolReliability: 0.93, quality: 0.89,
   },
   'claude-sonnet-5': {
     upstreamId: 'anthropic/claude-sonnet-5',
     provider: 'anthropic', contextWindow: 1000000, price: { input: 2.00, output: 10.00, cachedInput: 0.20 },
     capabilities: ['tools', 'code', 'planning', 'review', 'long-context'], toolReliability: 0.97, quality: 0.96,
   },
+  'claude-opus-5': {
+    upstreamId: 'anthropic/claude-opus-5',
+    provider: 'anthropic', contextWindow: 1000000, price: { input: 5.00, output: 25.00, cachedInput: 0.50 },
+    capabilities: ['tools', 'vision', 'code', 'planning', 'review', 'long-context'], toolReliability: 0.98, quality: 0.99,
+  },
   'claude-sonnet-4-6': {
     upstreamId: 'anthropic/claude-sonnet-4.6',
     provider: 'anthropic', contextWindow: 1000000, price: { input: 3.00, output: 15.00, cachedInput: 0.30 },
@@ -126,8 +133,33 @@ const MODEL_CATALOG = Object.freeze({
   },
   'laguna-s-2.1': {
     upstreamId: 'poolside/laguna-s-2.1',
-    provider: 'openrouter', contextWindow: 1048576, price: { input: 0.10, output: 0.20, cachedInput: 0.01 },
-    capabilities: ['code', 'review', 'long-context'], toolReliability: 0.25, quality: 0.75,
+    provider: 'openrouter', contextWindow: 1048576, price: { input: 0.09, output: 0.18, cachedInput: 0.009 },
+    capabilities: ['tools', 'code', 'review', 'long-context'], toolReliability: 0.80, quality: 0.78,
+  },
+  'qwen3.8-max': {
+    upstreamId: 'qwen/qwen3.8-max',
+    provider: 'openrouter', contextWindow: 1000000, price: { input: 2.00, output: 6.00, cachedInput: 0.20 },
+    capabilities: ['tools', 'vision', 'code', 'planning', 'review', 'long-context'], toolReliability: 0.91, quality: 0.93,
+  },
+  'gemini-3.6-flash': {
+    upstreamId: 'google/gemini-3.6-flash',
+    provider: 'openrouter', contextWindow: 1048576, price: { input: 1.50, output: 7.50, cachedInput: 0.15 },
+    capabilities: ['tools', 'vision', 'classification', 'planning', 'review', 'long-context'], toolReliability: 0.92, quality: 0.92,
+  },
+  'muse-spark-1.2': {
+    upstreamId: 'meta/muse-spark-1.2',
+    provider: 'meta', contextWindow: 1048576, price: { input: 1.25, output: 4.25, cachedInput: 0.125 },
+    capabilities: ['tools', 'vision', 'code', 'planning', 'review', 'long-context'], toolReliability: 0.95, quality: 0.95,
+  },
+  'muse-glimmer-30b': {
+    upstreamId: 'meta/muse-glimmer-30b',
+    provider: 'openrouter', contextWindow: 131072, price: { input: 0.35, output: 1.50, cachedInput: 0.035 },
+    capabilities: ['tools', 'vision', 'planning', 'review'], toolReliability: 0.88, quality: 0.86,
+  },
+  'solar-pro4': {
+    upstreamId: 'upstage/solar-pro4',
+    provider: 'openrouter', contextWindow: 524288, price: { input: 0.03, output: 0.12, cachedInput: 0.003 },
+    capabilities: ['tools', 'code', 'review', 'long-context'], toolReliability: 0.82, quality: 0.78,
   },
   'gpt-oss-120b': {
     upstreamId: 'openai/gpt-oss-120b',
@@ -169,7 +201,7 @@ const AGENT_ROLES = Object.freeze({
   }),
   inspector: Object.freeze({
     prompt: 'Inspecione em modo somente leitura e compare evidências com os critérios de aceite. Não altere nada e não elogie por cortesia.',
-    models: Object.freeze({ free: ['gemini-2.5-flash-lite'], basic: ['gemini-2.5-flash', 'gpt-4o-mini'], pro: ['claude-haiku-4-5', 'gemini-2.5-flash', 'gpt-5.6-luna'] }),
+    models: Object.freeze({ free: ['gemini-2.5-flash-lite'], basic: ['gemini-2.5-flash', 'gpt-4o-mini'], pro: ['gpt-5.6-luna', 'claude-haiku-4-5', 'gemini-2.5-flash'] }),
   }),
   corrector: Object.freeze({
     prompt: 'Corrija apenas falhas confirmadas pelo inspetor, preserve o que funciona e repita as provas afetadas. Não amplie o escopo.',
@@ -177,7 +209,7 @@ const AGENT_ROLES = Object.freeze({
   }),
   vision: Object.freeze({
     prompt: 'Extraia fatos observáveis da imagem e separe leitura, inferência e incerteza. Não invente texto ilegível.',
-    models: Object.freeze({ free: ['smart'], basic: ['gemini-2.5-flash'], pro: ['gemini-2.5-flash', 'claude-haiku-4-5'] }),
+    models: Object.freeze({ free: ['smart'], basic: ['gemini-2.5-flash'], pro: ['gpt-5.6-luna', 'gemini-2.5-flash', 'claude-haiku-4-5'] }),
   }),
   document: Object.freeze({
     prompt: 'Produza conteúdo estruturado e use o motor nativo do formato solicitado. Preserve editabilidade e valide o arquivo gerado.',
@@ -205,13 +237,18 @@ function clamp(n, min, max) {
 
 function normalizeModelId(model) {
   const raw = String(model || 'smart').trim();
-  const lower = raw.toLowerCase();
+  // O prefixo e uma instrucao de transporte do CDC, nao parte da identidade/preco.
+  // Sem remove-lo, todo modelo OpenRouter caia no preco `_default`: Luna era
+  // sobrecobrado e Opus subcobrado, com risco direto de margem negativa.
+  const transportFree = raw.replace(/^openrouter:/i, '');
+  const lower = transportFree.toLowerCase();
   if (MODEL_CATALOG[raw]) return raw;
+  if (MODEL_CATALOG[transportFree]) return transportFree;
   if (MODEL_CATALOG[lower]) return lower;
   if (MODEL_ALIASES[lower]) return MODEL_ALIASES[lower];
   const upstream = Object.entries(MODEL_CATALOG)
     .find(([, info]) => String(info.upstreamId || '').toLowerCase() === lower);
-  return upstream ? upstream[0] : raw;
+  return upstream ? upstream[0] : transportFree;
 }
 
 function modelInfo(model, now) {

package/lib/meta.js

@@ -29,6 +29,96 @@ const MAX_VISUAL_FIXES = 5;  // rodadas de polimento VISUAL (o olho crítico)
 const MAX_VISUAL_FIXES_FLUTTER = 3; // Flutter: rebuild é MUITO mais pesado/lento → teto menor de polimento (economia)
 const VISUAL_ESCALATE_AT = 2; // após N reprovações visuais, a MÃO do fix vira o modelo forte (grok) — o deepseek erra layout complexo
 const MAX_BUILD_FIXES = 12; // rodadas extras de correção de build antes de desistir
+const META_PROJECT_TOOLS = Object.freeze([
+  'executar_comando', 'ler_arquivo', 'escrever_arquivo', 'editar_arquivo',
+  'restaurar_arquivo', 'listar_diretorio', 'buscar_arquivos', 'buscar_codigo',
+  'mapa_projeto', 'preciso_de_voce',
+]);
+
+// Most meta rounds work inside one local project. Do not send schemas for
+// Gmail, Outlook, Android, SSH and Drive unless the item needs integrations.
+function toolsForMetaItem(item, goal) {
+  const text = `${item && item.desc || ''}\n${goal || ''}`.toLowerCase();
+  if (/\b(gmail|outlook|e-?mail|google\s+(drive|docs|sheets)|onedrive|microsoft\s*365|ssh|vps|servidor remoto|android|celular|telegram|whatsapp)\b/i.test(text)) return null;
+  return [...META_PROJECT_TOOLS];
+}
+
+// Connect each checklist item to a concrete artifact. Planner criteria have
+// priority; deterministic fallbacks cover later items that exceed the criteria cap.
+function artifactForMetaItem(item, st) {
+  const list = Array.isArray(st && st.checklist) ? st.checklist : [];
+  const index = Math.max(0, list.indexOf(item));
+  const criterion = Array.isArray(st && st.criteria) ? st.criteria[index] : null;
+  if (criterion && criterion.type === 'file_exists' && criterion.path) return String(criterion.path);
+  const d = String(item && item.desc || '').toLowerCase();
+  if (/controller.*8 dire|8 dire.*controller/.test(d)) return 'src/player_controller.gd';
+  if (/combate b[aá]sico|sistema de combate/.test(d)) return 'src/combat_system.gd';
+  if (/interface|\bui\b|\bhud\b/.test(d)) return 'docs/UI_SPEC.md';
+  if (/80-100 monstros|lista.*monstros/.test(d)) return 'data/monsters.json';
+  if (/economia|zeny|vending/.test(d)) return 'docs/ECONOMY.md';
+  if (/prioriza|\bmvp\b.*alpha|roadmap/.test(d)) return 'docs/ROADMAP.md';
+  return `artifacts/${String(item && item.id || 'item').replace(/[^a-z0-9_-]/gi, '_')}.md`;
+}
+
+function normalizeMetaArtifact(relativePath, raw) {
+  let text = String(raw || '').trim().replace(/^```(?:json|gdscript|markdown|md)?\s*/i, '').replace(/\s*```\s*$/i, '').trim();
+  if (/\.json$/i.test(relativePath)) {
+    const a = text.indexOf('['), o = text.indexOf('{');
+    const start = a >= 0 && (o < 0 || a < o) ? a : o;
+    const end = Math.max(text.lastIndexOf(']'), text.lastIndexOf('}'));
+    if (start < 0 || end < start) throw new Error('resposta sem JSON');
+    const parsed = JSON.parse(text.slice(start, end + 1));
+    text = JSON.stringify(parsed, null, 2) + '\n';
+  }
+  if (!text || text.length < 80) throw new Error('artefato vazio ou curto demais');
+  return text;
+}
+
+function persistMetaArtifact(dir, relativePath, raw) {
+  const root = path.resolve(dir);
+  const target = path.resolve(root, relativePath);
+  if (target !== root && !target.startsWith(root + path.sep)) throw new Error('artefato fora da pasta confinada');
+  const content = normalizeMetaArtifact(relativePath, raw);
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.writeFileSync(target, content, 'utf8');
+  return { target, bytes: Buffer.byteLength(content) };
+}
+
+function directArtifactPlan(item) {
+  const d = String(item && item.desc || '').toLowerCase();
+  const groups = (values, size) => { const out = []; for (let i = 0; i < values.length; i += size) out.push(values.slice(i, i + size)); return out; };
+  const uniqueIds = (data, key) => {
+    const rows = data && data[key];
+    if (!Array.isArray(rows) || rows.some(row => !row || row.id === undefined || row.id === null || String(row.id).trim() === '')) return false;
+    const ids = rows.map(row => String(row.id));
+    return new Set(ids).size === ids.length;
+  };
+  if (/classes|novice|[aá]rvores de skills/.test(d)) return {
+    key: 'classes', minimum: 20,
+    parts: groups(['Novice','Swordsman','Mage','Archer','Merchant','Thief','Acolyte','Knight','Crusader','Wizard','Sage','Hunter','Bard','Dancer','Blacksmith','Alchemist','Assassin','Rogue','Priest','Monk'], 4),
+    schema: '{"classes":[{"id":"string","name":"string","tier":0,"base_attributes":{"STR":1,"AGI":1,"VIT":1,"INT":1,"DEX":1,"LUK":1},"skills":[{"id":"string","name":"string","max_level":10,"sp_cost":1,"cooldown_seconds":0,"description":"string"}]}]}',
+    validate: data => uniqueIds(data, 'classes') && data.classes.every(c => Array.isArray(c.skills) && c.skills.length >= 8 && new Set(c.skills.map(s => String(s.id))).size === c.skills.length),
+  };
+  if (/lista completa de mapas|cidades.*masmorras/.test(d)) return {
+    key: 'maps', minimum: 18,
+    parts: groups(['Prontera','Geffen','Payon','Morroc','Alberta','Izlude','Prontera Field North','Prontera Field South','Geffen Field','Payon Forest','Sograt Desert','Prontera Culvert','Byalan Island','Undersea Tunnel','Payon Cave','Geffen Dungeon','Pyramid','Orc Dungeon','Glast Heim'], 4),
+    schema: '{"maps":[{"id":"string","name":"string","type":"city|field|dungeon","level_range":[1,10],"layout":"string","npcs":["string"],"monsters":["string"],"connections":["string"],"safe_areas":["string"],"events":["string"]}]}',
+    validate: data => uniqueIds(data, 'maps'),
+  };
+  if (/50\+ quests|pelo menos 50 quests/.test(d)) return {
+    key: 'quests', minimum: 50,
+    parts: Array.from({ length: 5 }, (_, i) => `quests ${i * 10 + 1} a ${i * 10 + 10}`),
+    schema: '{"quests":[{"id":"string","title":"string","type":"main|side|job|daily|weekly","objectives":["string"],"rewards":{"exp":1,"job_exp":1,"zeny":1,"items":["string"]},"dialogue":"string","prerequisites":["string"]}]}',
+    validate: data => uniqueIds(data, 'quests'),
+  };
+  if (/80-100 monstros|lista detalhada.*monstros/.test(d)) return {
+    key: 'monsters', minimum: 80,
+    parts: Array.from({ length: 10 }, (_, i) => `monstros ${i * 10 + 1} a ${i * 10 + 10}`),
+    schema: '{"monsters":[{"id":"string","name":"string","level":1,"hp":10,"element":"Neutral","size":"Small|Medium|Large","map":"string","drops":[{"item":"string","chance_percent":1}],"is_mvp":false}]}',
+    validate: data => uniqueIds(data, 'monsters') && data.monsters.every(m => Number(m.level) > 0 && Number(m.hp) > 0 && Array.isArray(m.drops)),
+  };
+  return null;
+}
 const WEB_CANVAS_MOVE_MIN = 0.02; // check de MOVIMENTO do canvas web (jogo/cena 3D): diferença MÍNIMA
 // entre 2 quadros pra a cena contar como VIVA. Abaixo disso = parada/congelada (T-pose, mixer parado,
 // loop sem avançar o tempo). SÓ se aplica a canvas de JOGO/3D — dashboard/gráfico pode ficar estático.
@@ -819,7 +909,7 @@ async function _llmJson({ token, system, user, maxTokens = 900 }) {
 }
 
 // Chamada de TEXTO com modelo arbitrário — usada pelo PENSADOR (escalonamento).
-async function _llmText({ token, model, system, user, maxTokens = 1200 }) {
+async function _llmText({ token, model, system, user, maxTokens = 1200, creditBudget = null }) {
   if (!_key) _key = await keyring.resolve(token, { feature: 'cli_agent' });
   const ctrl = new AbortController();
   const timer = setTimeout(() => ctrl.abort(), 120000);
@@ -827,7 +917,8 @@ async function _llmText({ token, model, system, user, maxTokens = 1200 }) {
   try {
     res = await fetch(String(_key.baseUrl).replace(/\/+$/, '') + '/chat/completions', {
       method: 'POST', signal: ctrl.signal,
-      headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + _key.key },
+      headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + _key.key,
+        ...(Number.isFinite(Number(creditBudget)) && Number(creditBudget) > 0 ? { 'X-TS-Credit-Budget': String(Math.floor(Number(creditBudget))) } : {}) },
       body: JSON.stringify({ model: keyring.modeloPara(_key, model), stream: false, max_completion_tokens: maxTokens, messages: [{ role: 'system', content: system }, { role: 'user', content: user }] }),
     });
   } finally { clearTimeout(timer); }
@@ -836,7 +927,16 @@ async function _llmText({ token, model, system, user, maxTokens = 1200 }) {
   const u = j?.usage || {};
   let credits = (j?.ts_billing && j.ts_billing.charged) || 0;
   if (u.prompt_tokens && !_key.billingAuthoritative) { try { const c = await api('/api/credit/charge', { method: 'POST', token, body: { model, inTok: u.prompt_tokens || 0, outTok: u.completion_tokens || 0 } }); credits = (c && c.charged) || 0; } catch (_) {} }
-  return { text: String(j?.choices?.[0]?.message?.content || '').trim(), credits };
+  const text = String(j?.choices?.[0]?.message?.content || '').trim();
+  // Some providers may return HTTP 200 without `choices` during an internal
+  // failure. Empty output is not a valid brief and must never become success.
+  if (!text) {
+    const providerMessage = String(j?.error?.message || j?.message || '').trim();
+    throw new ApiError(`O modelo ${model || 'selecionado'} retornou uma resposta vazia${providerMessage ? ': ' + providerMessage : '.'}`, {
+      status: 502, code: 'empty_model_response',
+    });
+  }
+  return { text, credits };
 }
 
 // ESCALONAMENTO: o executor barato travou no mesmo erro. Chama o modelo CARO
@@ -1057,7 +1157,7 @@ async function run(goal, opts = {}) {
     const feasModel = thinker || 'grok-4.5';
     if (feasMode === true || (feasMode === 'auto' && looksComplex(goal))) {
       onRound({ n: 0, item: (lang === 'en' ? `Checking feasibility with ${feasModel}…` : `Avaliando viabilidade com ${feasModel}…`), attempt: 1 });
-      try { const fe = await feasibilityPhase(goal, feasModel, token); feasBrief = fe.brief; feasCred = fe.credits || 0; try { fs.writeFileSync(path.join(dir, 'VIABILIDADE.md'), feasBrief); } catch (_) {} onAlert({ type: 'design', text: `🔎 ts: viabilidade avaliada (${feasModel}, ${feasCred} créditos) — o que dá e o que não dá está fixado. Salvo em VIABILIDADE.md.` }); } catch (_e) { if (_e && _e.code === 'no_credits') throw _e; }
+      try { const fe = await feasibilityPhase(goal, feasModel, token); feasBrief = fe.brief; feasCred = fe.credits || 0; try { fs.writeFileSync(path.join(dir, 'VIABILIDADE.md'), feasBrief); } catch (_) {} onAlert({ type: 'design', text: `🔎 ts: viabilidade avaliada (${feasModel}, ${feasCred} créditos) — o que dá e o que não dá está fixado. Salvo em VIABILIDADE.md.` }); } catch (_e) { if (_e && _e.code === 'no_credits') throw _e; onAlert({ type: 'phase_error', text: `⚠ ts: viabilidade não concluída: ${String(_e && _e.message || _e).slice(0, 220)}` }); }
     }
     // FASE DE DESIGN (nova missão visual): o designer forte projeta o design system
     // ANTES do checklist e do código, pra o app sair bonito de fábrica.
@@ -1067,7 +1167,7 @@ async function run(goal, opts = {}) {
       onRound({ n: 0, item: (lang === 'en' ? `Designing the visual with ${designer}…` : `Projetando o visual com ${designer}…`), attempt: 1 });
       let mockupB64 = null;
       if (opts.mockup) { try { mockupB64 = fs.readFileSync(opts.mockup).toString('base64'); onAlert({ type: 'design', text: `🖼 ts: mockup de referência carregado (${path.basename(opts.mockup)}) — o designer vai projetar a partir dele e o olho vai cobrar fidelidade.` }); } catch (_) { onAlert({ type: 'design', text: `⚠ ts: não consegui ler o mockup ${opts.mockup} — seguindo sem ele.` }); } }
-      try { const d = await designPhase(goal, designer, token, { dir, mockupB64, kind: _projKind(goal, dir) }); designBrief = d.brief; designCred = d.credits || 0; try { fs.writeFileSync(path.join(dir, 'DESIGN.md'), designBrief); } catch (_) {} onAlert({ type: 'design', text: `🎨 ts: design system criado pelo ${designer} (${designCred} créditos) — o app vai seguir esse visual. Salvo em DESIGN.md.` }); } catch (_e) { if (_e && _e.code === 'no_credits') throw _e; }
+      try { const d = await designPhase(goal, designer, token, { dir, mockupB64, kind: _projKind(goal, dir) }); designBrief = d.brief; designCred = d.credits || 0; try { fs.writeFileSync(path.join(dir, 'DESIGN.md'), designBrief); } catch (_) {} onAlert({ type: 'design', text: `🎨 ts: design system criado pelo ${designer} (${designCred} créditos) — o app vai seguir esse visual. Salvo em DESIGN.md.` }); } catch (_e) { if (_e && _e.code === 'no_credits') throw _e; onAlert({ type: 'phase_error', text: `⚠ ts: design não concluído: ${String(_e && _e.message || _e).slice(0, 220)}` }); }
     }
     // FASE DE ARQUITETURA (3º pilar): app complexo ganha um CONTRATO antes do checklist
     let archBrief = null, archCred = 0;
@@ -1075,7 +1175,7 @@ async function run(goal, opts = {}) {
     const archModel = thinker || 'grok-4.5';
     if (archMode === true || (archMode === 'auto' && looksComplex(goal))) {
       onRound({ n: 0, item: (lang === 'en' ? `Designing the architecture with ${archModel}…` : `Projetando a arquitetura com ${archModel}…`), attempt: 1 });
-      try { const a = await archPhase(goal, archModel, token, { dir }); archBrief = a.brief; archCred = a.credits || 0; try { fs.writeFileSync(path.join(dir, 'ARQUITETURA.md'), archBrief); } catch (_) {} onAlert({ type: 'design', text: `📐 ts: contrato de arquitetura criado pelo ${archModel} (${archCred} créditos) — componentes, arquivos e assinaturas fixados. Salvo em ARQUITETURA.md.` }); } catch (_e) { if (_e && _e.code === 'no_credits') throw _e; }
+      try { const a = await archPhase(goal, archModel, token, { dir }); archBrief = a.brief; archCred = a.credits || 0; try { fs.writeFileSync(path.join(dir, 'ARQUITETURA.md'), archBrief); } catch (_) {} onAlert({ type: 'design', text: `📐 ts: contrato de arquitetura criado pelo ${archModel} (${archCred} créditos) — componentes, arquivos e assinaturas fixados. Salvo em ARQUITETURA.md.` }); } catch (_e) { if (_e && _e.code === 'no_credits') throw _e; onAlert({ type: 'phase_error', text: `⚠ ts: arquitetura não concluída: ${String(_e && _e.message || _e).slice(0, 220)}` }); }
     }
     const mk = await makeChecklist(goal + (designBrief ? '\n\n[Há um DESIGN SYSTEM definido — o checklist deve refletir a aplicação desse visual]' : '') + (archBrief ? '\n\n[Há um CONTRATO DE ARQUITETURA definido — os itens devem seguir os componentes/arquivos dele]' : ''), token);
     // CRITÉRIOS (TaskSpec): usuário (--criterios) manda; senão, com --provar, combina o que o
@@ -1121,6 +1221,16 @@ async function run(goal, opts = {}) {
     // ABRE sem crashar E o "olho" aprova o layout. O portão REENTRA enquanto o visual não passa.
     if (!pend.length) {
       const b = detectBuild(dir);
+      // A documentation/data/code-sample package has no build target by
+      // design. Verify its executable file criteria and finish honestly;
+      // absence of a build system is not a "build-fix ceiling" failure.
+      if (!b) {
+        const criteriaOk = await _checkCriteria(st, dir);
+        st.verification = criteriaOk ? ((st.criteria || []).length ? 'verified' : 'no_gate') : 'unverified';
+        st.status = 'done'; st.finished_at = new Date().toISOString();
+        st.runNote = criteriaOk ? 'pacote sem alvo compilavel; criterios de artefato verificados' : 'criterios de artefato falharam';
+        save(st, dir); onRoundDone({ checklist: st.checklist, spent: st.creditsSpent }); return st;
+      }
       const buildCapLeft  = (st.buildFixes  || 0) < MAX_BUILD_FIXES;
       // teto de polimento visual: menor pra Flutter (rebuild caro/lento) que pra Android
       const visualCap = (b && b.kind === 'flutter') ? MAX_VISUAL_FIXES_FLUTTER : MAX_VISUAL_FIXES;
@@ -1256,9 +1366,119 @@ async function run(goal, opts = {}) {
     }
 
     const item = pend[0];
+    const expectedArtifact = artifactForMetaItem(item, st);
+    // A process can be interrupted after a read-only round but before the
+    // no-artifact branch persists `directArtifact`. Recover that evidence on
+    // resume instead of repeating the same exploratory attempt.
+    const expectedOnDisk = expectedArtifact
+      ? (path.isAbsolute(expectedArtifact) ? expectedArtifact : path.resolve(dir, expectedArtifact))
+      : null;
+    if (!item.directArtifact && (item.attempts || 0) > 0 && expectedOnDisk && !fs.existsSync(expectedOnDisk)) {
+      item.directArtifact = true;
+      item.directModel = item.directModel || 'glm-5.2';
+      item.attempts = Math.max(0, item.attempts - 1);
+    }
     item.attempts = (item.attempts || 0) + 1;
     onRound({ n: st.rounds.length + 1, item: item.desc, attempt: item.attempts });
 
+    // Known large structured deliverables are cheaper and more reliable when
+    // generated in validated batches from the start (classes/maps/quests/monsters).
+    if (!item.directArtifact && directArtifactPlan(item)) {
+      item.directArtifact = true;
+      item.directModel = 'glm-5.2';
+    }
+
+    // Some providers can generate a large document but refuse to place that
+    // content inside tool-call arguments. After a proven zero-tool response,
+    // generate content-only, validate it and let the confined harness persist it.
+    if (item.directArtifact) {
+      const directModel = item.directModel || 'glm-5.2';
+      const plan = directArtifactPlan(item);
+      let totalCredits = 0, finalText = '';
+      if (plan) {
+        const merged = [];
+        item.directParts = item.directParts || {};
+        for (let partIndex = 0; partIndex < plan.parts.length; partIndex++) {
+          if (Array.isArray(item.directParts[partIndex])) {
+            merged.push(...item.directParts[partIndex]);
+            continue;
+          }
+          const part = plan.parts[partIndex];
+          let generated = null, parsedPart = null, lastDirectError = null;
+          for (let directAttempt = 0; directAttempt < 2 && !parsedPart; directAttempt++) {
+            try {
+              const remainingBudget = Math.max(1, Math.floor(st.budget - st.creditsSpent));
+              generated = await _llmText({
+                token, model: directModel, maxTokens: 7500, creditBudget: remainingBudget,
+                system: `Gere SOMENTE JSON estritamente valido no schema pedido. Sem introducao, sem markdown fence, sem comentarios, sem virgula sobrando e com todas as aspas/chaves fechadas. Entregue apenas a parte solicitada. SCHEMA: ${plan.schema}`,
+                user: `OBJETIVO:\n${item.desc}\n\nPARTE ${partIndex + 1}/${plan.parts.length}: ${Array.isArray(part) ? part.join(', ') : part}. Inclua exatamente estas entidades e detalhe cada uma.`,
+              });
+              totalCredits += generated.credits || 0;
+              st.creditsSpent += generated.credits || 0;
+              save(st, dir); // custo existe mesmo se a saida abaixo for invalida
+              const parsed = JSON.parse(normalizeMetaArtifact(expectedArtifact, generated.text));
+              if (!Array.isArray(parsed[plan.key])) throw new Error(`parte ${partIndex + 1} sem array ${plan.key}`);
+              parsedPart = parsed[plan.key];
+            } catch (e) {
+              lastDirectError = e;
+              generated = null;
+              if (directAttempt === 0) await new Promise(r => setTimeout(r, 1500));
+            }
+          }
+          if (!parsedPart) {
+            item.attempts = Math.max(0, (item.attempts || 1) - 1);
+            const transient = /abort|timeout|fetch|network/i.test(String(lastDirectError && lastDirectError.message || lastDirectError)) || Number(lastDirectError && lastDirectError.status) >= 500;
+            st.status = 'paused'; st.pause_reason = transient ? 'connection' : 'invalid_artifact';
+            st.budget = st.creditsSpent;
+            save(st, dir);
+            onAlert({ type: transient ? 'conn' : 'retry', text: `Geracao em lotes pausada na parte ${partIndex + 1}/${plan.parts.length}: ${String(lastDirectError && lastDirectError.message || lastDirectError).slice(0, 180)}. As partes ja validadas e os custos foram preservados.` });
+            return st;
+          }
+          item.directParts[partIndex] = parsedPart;
+          merged.push(...item.directParts[partIndex]);
+          save(st, dir);
+        }
+        const data = { [plan.key]: merged };
+        if (merged.length < plan.minimum) throw new Error(`${plan.key}: esperado minimo ${plan.minimum}, recebido ${merged.length}`);
+        if (plan.validate && !plan.validate(data)) throw new Error(`${plan.key}: validacao semantica falhou`);
+        finalText = JSON.stringify(data, null, 2);
+      } else {
+        let generated = null, lastDirectError = null;
+        for (let directAttempt = 0; directAttempt < 2 && !generated; directAttempt++) {
+          try {
+            const remainingBudget = Math.max(1, Math.floor(st.budget - st.creditsSpent));
+            generated = await _llmText({
+              token, model: directModel, maxTokens: /\.json$/i.test(expectedArtifact) ? 16000 : 14000,
+              creditBudget: remainingBudget,
+              system: 'Gere o CONTEUDO COMPLETO do artefato solicitado. Responda SOMENTE com o conteudo final, sem introducao, sem promessas e sem markdown fence. Se for JSON, devolva JSON estritamente valido. Nao use ferramentas.',
+              user: `OBJETIVO MAIOR:\n${st.goal.slice(0, 1800)}\n\nITEM ATUAL:\n${item.desc}\n\nCAMINHO/FORMATO OBRIGATORIO: ${expectedArtifact}`,
+            });
+          } catch (e) {
+            lastDirectError = e;
+            if (directAttempt === 0) await new Promise(r => setTimeout(r, 1500));
+          }
+        }
+        if (!generated) {
+          item.attempts = Math.max(0, (item.attempts || 1) - 1);
+          const transient = /abort|timeout|fetch|network/i.test(String(lastDirectError && lastDirectError.message || lastDirectError)) || Number(lastDirectError && lastDirectError.status) >= 500;
+          st.status = 'paused'; st.pause_reason = transient ? 'connection' : 'invalid_artifact';
+          st.budget = st.creditsSpent;
+          save(st, dir);
+          onAlert({ type: transient ? 'conn' : 'retry', text: `Geracao direta pausada: ${String(lastDirectError && lastDirectError.message || lastDirectError).slice(0, 180)}. O item continua pendente e sera retomado sem consumir tentativa.` });
+          return st;
+        }
+        totalCredits += generated.credits || 0;
+        finalText = generated.text;
+      }
+      if (!plan) st.creditsSpent += totalCredits;
+      const persisted = persistMetaArtifact(dir, expectedArtifact, finalText);
+      item.passes = true; item.blocked = false; item.directArtifact = false; delete item.directParts;
+      st.rounds.push({ item: item.desc, id: item.id, result: `Artefato validado e persistido pelo harness: ${persisted.target} (${persisted.bytes} bytes)`, credits: totalCredits, steps: plan ? plan.parts.length : 1, at: new Date().toISOString() });
+      save(st, dir);
+      onRoundDone({ marks: [item.id], credits: totalCredits, checklist: st.checklist, spent: st.creditsSpent });
+      continue;
+    }
+
     // Rodada com CONTEXTO ZERADO: o agente recebe só o essencial (objetivo resumido +
     // estado do checklist + resultado da rodada anterior) — nunca o histórico inteiro.
     const last = st.rounds[st.rounds.length - 1];
@@ -1295,7 +1515,10 @@ async function run(goal, opts = {}) {
     const minimalBlock = (lang === 'en'
       ? `\nMINIMAL-CODE RULES (economy — mandatory, think like a pragmatic lazy senior):\n1) Does this really need to exist? If not, don't build it.\n2) Does it already exist in this project? If yes, REUSE it — never rewrite a second version.\n3) Does the language/platform/browser already do it natively? If yes, use the native thing (e.g. <input type="date"> instead of a datepicker lib; fetch instead of axios; CSS instead of a JS animation lib).\n4) Only then write code — the MINIMUM that solves the item. NO extra library without real need, no gratuitous abstractions/wrappers, no speculative "future-proofing".\n`
       : `\nREGRAS DE CÓDIGO MÍNIMO (economia — obrigatórias; pense como um sênior pragmático e "preguiçoso"):\n1) Isso precisa mesmo existir? Se não precisa, NÃO construa.\n2) Já existe neste projeto? Se sim, REUSE — nunca escreva uma segunda versão.\n3) A linguagem/plataforma/navegador já faz isso nativo? Se sim, use o nativo (ex: <input type="date"> em vez de lib de datepicker; fetch em vez de axios; CSS em vez de lib JS de animação).\n4) Só então escreva código — o MÍNIMO que resolve o item. SEM biblioteca extra sem necessidade real, sem abstração/wrapper gratuito, sem "preparar pro futuro" especulativo.\n`);
-    const task = feasBlock + archBlock + designBlock + seedBlock + rulesBlock + minimalBlock + (lang === 'en'
+    const artifactBlock = lang === 'en'
+      ? `\nMANDATORY PROOF ARTIFACT FOR THIS ITEM: ${expectedArtifact}\nYou MUST call escrever_arquivo or editar_arquivo and persist the deliverable at exactly this relative path. A text-only answer does NOT complete the item. Create parent directories through the file tool as needed.\n`
+      : `\nARTEFATO DE PROVA OBRIGATORIO DESTE ITEM: ${expectedArtifact}\nVoce DEVE chamar escrever_arquivo ou editar_arquivo e persistir a entrega exatamente nesse caminho relativo. Resposta apenas em texto NAO conclui o item. Crie os diretorios-pai pela ferramenta de arquivo quando necessario.\n`;
+    const task = feasBlock + archBlock + designBlock + seedBlock + rulesBlock + minimalBlock + artifactBlock + (lang === 'en'
       ? `Bigger goal (context — do NOT do everything now):\n${st.goal.slice(0, 800)}\n\nCHECKLIST (state):\n${fmtChecklist(st.checklist)}\n${mapBlock}`
       : `Objetivo maior (contexto — NÃO faça tudo agora):\n${st.goal.slice(0, 800)}\n\nCHECKLIST (estado):\n${fmtChecklist(st.checklist)}\n${mapBlock}`)
       + (last ? `\n${lang === 'en' ? 'Previous round' : 'Rodada anterior'}: ${String(last.result || '').slice(0, 600)}\n` : '')
@@ -1324,13 +1547,34 @@ async function run(goal, opts = {}) {
     // ser o modelo forte (o pensador/olho, grok-4.5) — que sabe compor layout. Volta ao
     // barato assim que o olho aprovar (visual_fix some do checklist). Só nas rodadas visuais.
     let roundModel = useModel;
+    // If the automatic executor family was just proven unavailable, do not
+    // spend three HTTP retries on it again for every checklist item. Keep the
+    // cooldown mission-local and short so normal routing recovers naturally.
+    if (!model && Number(st.autoExecutorDegradedUntil || 0) > Date.now()) {
+      roundModel = 'glm-5.2';
+    }
+    // A model that answered with promises but executed zero tools is avoided
+    // for this item on the next window. This is a capability failure, not a
+    // reason to burn the item's second implementation attempt.
+    if (!model && Array.isArray(item.avoidModels) && item.avoidModels.length) {
+      const avoid = item.avoidModels.map(v => String(v).toLowerCase());
+      const candidates = ['glm-5.2', 'claude-haiku-4-5', 'deepseek-v4-pro'];
+      roundModel = candidates.find(c => !avoid.some(a => a.includes(c) || c.includes(a))) || roundModel;
+    }
     if (visualLadder && item.id === 'visual_fix' && (st.visualFixes || 0) >= VISUAL_ESCALATE_AT && (useThinker || eye)) {
       roundModel = useThinker || eye;
       onAlert({ type: 'escalate', text: `🎨 ts: o olho reprovou o layout ${st.visualFixes}x — passando a MÃO do fix visual pro ${roundModel} (mais forte em layout) até aprovar.` });
     }
     let out = null, connErr = null;
     for (let att = 0; att < 3 && !out; att++) {
-      try { out = await agent.run(task, { token, lang, yes, autoAll, model: roundModel, confineDir: dir, skipSessionStart: true, onStep: opts.onStep, onStepDone: opts.onStepDone, askApprove: opts.askApprove, onRemote: opts.onRemote, onThinking: opts.onThinking }); }
+      try {
+        // `agent.run` defaults to a defensive 40-credit cap. Complex meta rounds
+        // can have a minimum context larger than that, so use the remaining
+        // window budget while preserving the mission-wide ceiling.
+        const roundCreditBudget = Math.max(1, Math.min(5000, Math.floor(st.budget - st.creditsSpent)));
+        const roundAllowedTools = Array.isArray(opts.allowedTools) ? opts.allowedTools : toolsForMetaItem(item, st.goal);
+        out = await agent.run(task, { token, lang, yes, autoAll, model: roundModel, maxCredits: roundCreditBudget, allowedTools: roundAllowedTools, confineDir: dir, skipSessionStart: true, onStep: opts.onStep, onStepDone: opts.onStepDone, askApprove: opts.askApprove, onRemote: opts.onRemote, onThinking: opts.onThinking });
+      }
       catch (e) {
         connErr = e;
         // teto de IA estourado → PAUSA limpa e resumível com CTA de upgrade (nunca segue em silêncio)
@@ -1339,13 +1583,63 @@ async function run(goal, opts = {}) {
           onAlert({ type: 'no_credits', text: `💳 ts: seu limite de IA acabou — a missão foi PAUSADA e salva. Assine um plano em terminalsmart.com.br/planos e retome com "ts meta".` });
           return st;
         }
-        if (e && (e.code === 'conn' || String(e.message).includes('fetch') || String(e.message).includes('network'))) { onAlert({ type: 'retry', text: `📡 ts: falha de conexão na rodada — tentando de novo (${att + 1}/3)…` }); await new Promise(r => setTimeout(r, 4000 * (att + 1))); }
-        else throw e; // erro não-transitório: sobe
+        const transientStatus = e && Number(e.status);
+        const transientProvider = e && ([408, 425, 429, 500, 502, 503, 504].includes(transientStatus) || (transientStatus >= 520 && transientStatus <= 527) || e.code === 'conn' || /fetch|network|temporariamente indispon[ií]vel/i.test(String(e.message)));
+        if (transientProvider) {
+          // Automatic Pro mode: once the selected executor exhausts its HTTP
+          // retries, switch to another tool-capable model before pausing.
+          // Change provider family first: if Flash is down, Pro from the same
+          // family is likely affected too. GLM is the economical independent fallback.
+          const fallbacks = ['glm-5.2', 'deepseek-v4-pro', 'claude-haiku-4-5'];
+          if (!model && att === 0 && !roundModel) {
+            st.autoExecutorDegradedUntil = Date.now() + (10 * 60 * 1000);
+            save(st, dir);
+          }
+          if (!model && att < fallbacks.length) roundModel = fallbacks[att];
+          onAlert({ type: 'retry', text: `📡 ts: provedor indisponível — tentando de novo (${att + 1}/3)${roundModel ? ` com ${roundModel}` : ''}…` });
+          await new Promise(r => setTimeout(r, 4000 * (att + 1)));
+        } else throw e; // erro não-transitório: sobe
       }
     }
     if (!out) { st.status = 'paused'; st.pause_reason = 'connection'; save(st, dir); onAlert({ type: 'conn', text: `📡 ts: sem conexão com o servidor após 3 tentativas. Missão PAUSADA e salva. Retome com "ts meta" quando a internet voltar.` }); return st; }
     st.creditsSpent += out.credits || 0;
 
+    // A preflight budget stop is financial state, not an implementation
+    // failure. Do not consume an attempt or block a valid checklist item.
+    if (out.guard && out.guard.kind === 'credits' && !(out.steps > 0)) {
+      item.attempts = Math.max(0, (item.attempts || 1) - 1);
+      st.status = 'paused';
+      st.pause_reason = 'budget';
+      // Signals night mode to open a fresh window without inventing spend.
+      st.budget = st.creditsSpent;
+      save(st, dir);
+      const need = out.guard.required ? ` (minimo estimado: ${out.guard.required}; disponivel: ${out.guard.available || 0})` : '';
+      onAlert({ type: 'budget', text: `A rodada precisava de mais contexto que o saldo desta janela${need}. Pausei sem marcar o item como falho; a proxima janela retoma limpo.` });
+      return st;
+    }
+
+    const expectedNow = String(expectedArtifact || '').replace(/\\/g, '/').toLowerCase();
+    const wroteExpectedNow = (out.actions || []).some(a => {
+      if (!['escrever_arquivo', 'editar_arquivo'].includes(a && a.name)) return false;
+      const target = String(a.target || '').replace(/\\/g, '/').toLowerCase();
+      return target === expectedNow || target.endsWith('/' + expectedNow);
+    });
+    // Reading/searching is not implementation progress. A model can consume
+    // several tool steps exploring the project and still fail to create the
+    // promised deliverable; treat that exactly like a zero-tool promise.
+    if (expectedNow && !wroteExpectedNow) {
+      item.attempts = Math.max(0, (item.attempts || 1) - 1);
+      item.avoidModels = [...new Set([...(item.avoidModels || []), String(out.model || roundModel || 'automatico')])];
+      item.directArtifact = true;
+      const failedModel = String(out.model || roundModel || 'glm-5.2');
+      item.directModel = /glm/i.test(failedModel) ? 'glm-5.2' : failedModel;
+      st.status = 'paused'; st.pause_reason = 'model_no_action';
+      st.budget = st.creditsSpent;
+      save(st, dir);
+      onAlert({ type: 'retry', text: `O modelo ${out.model || roundModel || 'automatico'} respondeu, mas executou zero ferramentas. Nao marquei falha do item; a retomada usara outro executor.` });
+      return st;
+    }
+
     // ── BLOQUEIO HUMANO: o agente pediu uma ação externa que só o usuário faz ──
     // A missão PAUSA (gasto zero enquanto espera) e chama o usuário. Retoma com "ts meta".
     if (out.needHuman) {
@@ -1364,7 +1658,7 @@ async function run(goal, opts = {}) {
     let marks = [];
     const written = (out.actions || []).filter(a => a.name === 'escrever_arquivo' || a.name === 'editar_arquivo').map(a => String(a.target || ''));
     const _basename = (p) => String(p).replace(/\\/g, '/').split('/').pop().toLowerCase();
-    const _fileHints = (txt) => (String(txt).match(/[\w.\-]+\.(kt|java|xml|gradle|json|md|txt|kts|properties|pro|png|webp|py|js|ts|html|css|sh)\b/gi) || []).map(s => s.toLowerCase());
+    const _fileHints = (txt) => (String(txt).match(/[\w.\-]+\.(kt|java|xml|gradle|json|md|txt|kts|properties|pro|png|webp|py|gd|js|ts|html|css|sh)\b/gi) || []).map(s => s.toLowerCase());
     const itemFiles = _fileHints(item.desc);
     // Uma escrita/comando genérico não prova um item sem vínculo. Só há marcação automática
     // quando o próprio texto do item identifica o artefato e a rodada gravou esse artefato.
@@ -1372,7 +1666,13 @@ async function run(goal, opts = {}) {
     // para outros itens só porque algum arquivo/comando apareceu na mesma rodada.
     const wroteForItem = itemFiles.length > 0
       && itemFiles.some(f => written.some(w => _basename(w) === f));
-    if (wroteForItem) marks.push(item.id);
+    const _normPath = (p) => String(p || '').replace(/\\/g, '/').replace(/^\.\//, '').toLowerCase();
+    const expectedNorm = _normPath(expectedArtifact);
+    const wroteExpectedArtifact = !!expectedNorm && written.some(w => {
+      const n = _normPath(w);
+      return n === expectedNorm || n.endsWith('/' + expectedNorm);
+    });
+    if (wroteForItem || wroteExpectedArtifact) marks.push(item.id);
 
     // Item de correção de build: NÃO usa marcador — o PORTÃO DE BUILD é a única
     // autoridade (recompila de verdade). Marca provisório pra reabrir o gate; se o
@@ -1394,7 +1694,7 @@ async function run(goal, opts = {}) {
       const mk = await _llmJson({ token, system: MARK_SYS,
         user: `OBJETIVO:\n${st.goal.slice(0, 600)}\n\nCHECKLIST (contexto):\n${fmtChecklist(st.checklist)}\n\nITEM ALVO: (${item.id}) ${item.desc}\n\nRESULTADO DA RODADA:\n${String(out.text || '').slice(0, 2000)}${evid}` });
       st.creditsSpent += mk.credits || 0;
-      if (mk.json && mk.json.passou === true) marks.push(item.id);
+      if (mk.json && mk.json.passou === true && wroteExpectedArtifact) marks.push(item.id);
     } catch (_) {}
     marks = [...new Set(marks)];
     for (const it of st.checklist) if (marks.includes(it.id)) it.passes = true;
@@ -1456,4 +1756,4 @@ function trailSummary(st, lang) {
   };
 }
 
-module.exports = { webRunGate, run, load, notify, stateFile, detectBuild, ensureToolchain, runBuild, escalate, designPhase, archPhase, looksVisual, looksComplex, runApp, visualGate, ensureEmulator, _projKind, _llmVision, verificationLabel, _checkCriteria, trailSummary };
+module.exports = { webRunGate, run, load, notify, stateFile, detectBuild, ensureToolchain, runBuild, escalate, designPhase, archPhase, looksVisual, looksComplex, runApp, visualGate, ensureEmulator, _projKind, _llmVision, toolsForMetaItem, artifactForMetaItem, normalizeMetaArtifact, persistMetaArtifact, directArtifactPlan, verificationLabel, _checkCriteria, trailSummary };

package/lib/tools.js

@@ -190,10 +190,12 @@ const DEFS = [
   { type: 'function', function: { name: 'obter_anexo_outlook', description: 'Obtém o link autenticado para baixar um anexo do Outlook.', parameters: { type: 'object', properties: { id_email: { type: 'string' }, id_anexo: { type: 'string' } }, required: ['id_email','id_anexo'] } } },
   { type: 'function', function: { name: 'criar_rascunho_outlook', description: 'Cria rascunho no Outlook. Exige confirmação e não envia.', parameters: { type: 'object', properties: { para: { type: 'array', items: { type: 'string' } }, cc: { type: 'array', items: { type: 'string' } }, assunto: { type: 'string' }, corpo: { type: 'string' }, formato_html: { type: 'boolean' } }, required: ['para','assunto','corpo'] } } },
   { type: 'function', function: { name: 'enviar_rascunho_outlook', description: 'Envia um rascunho existente do Outlook. Exige confirmação.', parameters: { type: 'object', properties: { rascunho_id: { type: 'string' } }, required: ['rascunho_id'] } } },
-  { type: 'function', function: { name: 'status_google_workspace', description: 'Verifica a conexão com Gmail, Drive, Docs e Sheets.', parameters: { type: 'object', properties: {} } } },
-  { type: 'function', function: { name: 'conectar_google_workspace', description: 'Gera o link oficial para autorizar Gmail, Drive, Docs e Sheets.', parameters: { type: 'object', properties: {} } } },
-  { type: 'function', function: { name: 'listar_emails_gmail', description: 'Lista e prioriza e-mails do Gmail, sem alterar nada.', parameters: { type: 'object', properties: {
-    limite: { type: 'number' }, somente_nao_lidos: { type: 'boolean' }, priorizar: { type: 'boolean' }, consulta: { type: 'string' }, pasta: { type: 'string', enum: ['inbox','sent','drafts','spam','trash','starred','important','all'] }
+  { type: 'function', function: { name: 'status_google_workspace', description: 'Verifica a conexão Google e informa se o acesso é Essencial ou Avançado.', parameters: { type: 'object', properties: {} } } },
+  { type: 'function', function: { name: 'conectar_google_workspace', description: 'Gera o link Google. Essencial acessa arquivos escolhidos/criados pelo app; Avançado beta inclui Gmail completo e pesquisa global do Drive.', parameters: { type: 'object', properties: {
+    nivel: { type: 'string', enum: ['essencial', 'avancado'] }
+  } } } },
+  { type: 'function', function: { name: 'listar_emails_gmail', description: 'Lista e prioriza e-mails do Gmail, sem alterar nada. Use pagina com nextPageToken para continuar em lotes.', parameters: { type: 'object', properties: {
+    limite: { type: 'number' }, somente_nao_lidos: { type: 'boolean' }, priorizar: { type: 'boolean' }, consulta: { type: 'string' }, pasta: { type: 'string', enum: ['inbox','sent','drafts','spam','trash','starred','important','all'] }, pagina: { type: 'string' }
   } } } },
   { type: 'function', function: { name: 'ler_email_gmail', description: 'Lê o corpo completo de um e-mail ou a conversa inteira sem marcar como lido.', parameters: { type: 'object', properties: {
     id_email: { type: 'string' }, conversa_completa: { type: 'boolean' }
@@ -215,9 +217,13 @@ const DEFS = [
     para: { type: 'array', items: { type: 'string' } }, cc: { type: 'array', items: { type: 'string' } }, assunto: { type: 'string' }, corpo: { type: 'string' }, formato_html: { type: 'boolean' }
   }, required: ['para', 'assunto', 'corpo'] } } },
   { type: 'function', function: { name: 'enviar_rascunho_gmail', description: 'Envia rascunho existente do Gmail. Exige confirmação.', parameters: { type: 'object', properties: { rascunho_id: { type: 'string' } }, required: ['rascunho_id'] } } },
-  { type: 'function', function: { name: 'listar_arquivos_drive', description: 'Lista arquivos no Google Drive por nome ou tipo.', parameters: { type: 'object', properties: {
+  { type: 'function', function: { name: 'listar_arquivos_drive', description: 'Lista arquivos acessíveis no Drive; no Essencial limita-se aos escolhidos/criados pelo app e no Avançado pesquisa todo o Drive.', parameters: { type: 'object', properties: {
     busca: { type: 'string' }, tipo_mime: { type: 'string' }, limite: { type: 'number' }
   } } } },
+  { type: 'function', function: { name: 'selecionar_arquivos_drive', description: 'Fornece o link da Central de Integrações para escolher arquivos existentes no Google Drive.', parameters: { type: 'object', properties: {} } } },
+  { type: 'function', function: { name: 'criar_google_docs', description: 'Cria um novo Google Docs. Exige confirmação.', parameters: { type: 'object', properties: {
+    nome: { type: 'string' }, texto_inicial: { type: 'string' }, id_pasta: { type: 'string' }
+  }, required: ['nome'] } } },
   { type: 'function', function: { name: 'ler_google_docs', description: 'Lê texto de Google Docs pelo ID.', parameters: { type: 'object', properties: { id_documento: { type: 'string' } }, required: ['id_documento'] } } },
   { type: 'function', function: { name: 'editar_google_docs', description: 'Edita o Google Docs original por padrão; cria cópia somente se solicitado. Exige confirmação.', parameters: { type: 'object', properties: {
     id_documento: { type: 'string' }, localizar: { type: 'string' }, substituir_por: { type: 'string' }, diferenciar_maiusculas: { type: 'boolean' }, criar_copia: { type: 'boolean' }, nome_copia: { type: 'string' }
@@ -225,6 +231,9 @@ const DEFS = [
   { type: 'function', function: { name: 'ler_google_sheets', description: 'Lê células de Google Sheets pelo ID e intervalo.', parameters: { type: 'object', properties: {
     id_planilha: { type: 'string' }, intervalo: { type: 'string' }
   }, required: ['id_planilha'] } } },
+  { type: 'function', function: { name: 'criar_google_sheets', description: 'Cria uma nova Google Sheets e pode preencher valores iniciais. Exige confirmação.', parameters: { type: 'object', properties: {
+    nome: { type: 'string' }, intervalo: { type: 'string' }, valores: { type: 'array', items: { type: 'array', items: {} } }, id_pasta: { type: 'string' }
+  }, required: ['nome'] } } },
   { type: 'function', function: { name: 'editar_google_sheets', description: 'Edita a Google Sheets original por padrão; cria cópia somente se solicitado. Exige confirmação.', parameters: { type: 'object', properties: {
     id_planilha: { type: 'string' }, intervalo: { type: 'string' }, valores: { type: 'array', items: { type: 'array', items: {} } }, criar_copia: { type: 'boolean' }, nome_copia: { type: 'string' }
   }, required: ['id_planilha', 'intervalo', 'valores'] } } },
@@ -364,9 +373,14 @@ function _shellGotcha(cmd) {
     return 'python -c MULTILINHA falha em silêncio no Windows. Escreva um arquivo .py com escrever_arquivo e rode "python arquivo.py".';
   if (/\bnode\s+-e\b/.test(s) && (multi || /\bimport\s*\(/.test(s) || /\bawait\b/.test(s)))
     return 'node -e MULTILINHA ou com import()/await de topo falha no eval. Escreva um arquivo .mjs com escrever_arquivo e rode "node arquivo.mjs".';
-  // timeout /t é do cmd; sob git-bash pega o timeout do coreutils e dá "invalid time interval"
-  if (/\btimeout\s+\/t\b/i.test(s))
-    return 'Este shell é bash (não cmd): "timeout /t N" falha. Para esperar use "sleep N". Comandos só-do-cmd (dir, type, if exist) rode via: cmd /c "…".';
+  // child_process.exec usa cmd.exe no Windows. Alguns comandos POSIX têm outro
+  // significado: `mkdir -p app` cria por engano uma pasta literal chamada `-p`.
+  if (process.platform === 'win32' && /(^|[&|]\s*|\s)mkdir\s+-p(?:\s|$)/i.test(s))
+    return 'Este shell é cmd.exe: "mkdir -p" criaria uma pasta chamada "-p". Use "mkdir pasta" ou PowerShell New-Item.';
+  if (process.platform === 'win32' && /(^|[&|]\s*|\s)ls(?:\s|$)/i.test(s))
+    return 'Este shell é cmd.exe: use "dir" (ou chame PowerShell explicitamente) em vez de "ls".';
+  if (process.platform === 'win32' && /(?:^|\s)\/[a-zA-Z]\//.test(s))
+    return 'Caminho no formato /c/... não é válido no cmd.exe. Use C:\\... ou um caminho relativo ao diretório de trabalho.';
   // matar processo por IMAGEM mata tudo com esse nome (inclusive a própria missão)
   if (/\btaskkill\b[^\n]*\/im\b/i.test(s))
     return 'taskkill /IM mata TODOS os processos com esse nome (inclusive os do usuário e possivelmente o próprio ts). Mate pelo PID da PORTA: netstat -ano | findstr :PORTA  →  taskkill /PID <pid> /F.';
@@ -889,20 +903,24 @@ async function execute(name, input, opts = {}) {
         return await require('./api').api('/api/integrations/microsoft/mail/forwards', { method: 'POST', token: opts.token, body: { messageId: input.id_email, to: input.para, cc: input.cc || [], body: input.corpo || '', confirmed: true } });
       case 'obter_anexo_outlook':
         return { downloadUrl: '/api/integrations/microsoft/mail/attachments/download?' + new URLSearchParams({ messageId: input.id_email, attachmentId: input.id_anexo }), instrucao: 'Use uma sessão autenticada do Terminal Smart para baixar o anexo.' };
-      case 'criar_rascunho_outlook':
-        return await require('./api').api('/api/integrations/microsoft/mail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+      case 'criar_rascunho_outlook': {
+        const data = await require('./api').api('/api/integrations/microsoft/mail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+        return { ...data, rascunho_id: data.rascunho_id || data.draftId || data.draft?.id || data.id || null };
+      }
       case 'enviar_rascunho_outlook':
         return await require('./api').api('/api/integrations/microsoft/mail/send', { method: 'POST', token: opts.token, body: { draftId: input.rascunho_id, confirmed: true } });
       case 'status_google_workspace':
         return await require('./api').api('/api/integrations/google/status', { token: opts.token });
       case 'conectar_google_workspace': {
-        const data = await require('./api').api('/api/integrations/google/connect', { method: 'POST', body: { source: 'cli' }, token: opts.token });
-        return { ok: true, authUrl: data.authUrl, instrucao: 'Abra o link no navegador, autorize sua conta Google e volte ao Terminal Smart.' };
+        const accessLevel = String(input.nivel || '').toLowerCase() === 'avancado' ? 'advanced' : 'essential';
+        const data = await require('./api').api('/api/integrations/google/connect', { method: 'POST', body: { source: 'cli', accessLevel }, token: opts.token });
+        return { ok: true, accessLevel, authUrl: data.authUrl, instrucao: `Abra o link no navegador, autorize o acesso Google ${accessLevel === 'advanced' ? 'Avançado (beta)' : 'Essencial'} e volte ao Terminal Smart.` };
       }
       case 'listar_emails_gmail': {
         const p = new URLSearchParams({ limit: String(Math.min(30, Math.max(1, parseInt(input.limite) || 15))) });
         if (input.somente_nao_lidos) p.set('unread', '1'); if (input.priorizar) p.set('priority', '1');
         if (input.consulta) p.set('query', input.consulta); if (input.pasta) p.set('folder', input.pasta);
+        if (input.pagina) p.set('page', input.pagina);
         return await require('./api').api('/api/integrations/google/gmail/messages?' + p, { token: opts.token });
       }
       case 'ler_email_gmail': {
@@ -919,15 +937,21 @@ async function execute(name, input, opts = {}) {
         return await require('./api').api('/api/integrations/google/gmail/forwards', { method: 'POST', token: opts.token, body: { messageId: input.id_email, to: input.para, cc: input.cc || [], body: input.corpo || '', confirmed: true } });
       case 'obter_anexo_gmail':
         return { downloadUrl: '/api/integrations/google/gmail/attachments/download?' + new URLSearchParams({ messageId: input.id_email, attachmentId: input.id_anexo }), instrucao: 'Use uma sessão autenticada do Terminal Smart para baixar o anexo.' };
-      case 'criar_rascunho_gmail':
-        return await require('./api').api('/api/integrations/google/gmail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+      case 'criar_rascunho_gmail': {
+        const data = await require('./api').api('/api/integrations/google/gmail/drafts', { method: 'POST', token: opts.token, body: { to: input.para, cc: input.cc || [], subject: input.assunto, body: input.corpo, contentType: input.formato_html ? 'html' : 'text', confirmed: true } });
+        return { ...data, id_rascunho: data.id_rascunho || data.draftId || data.draft?.id || data.id || null };
+      }
       case 'enviar_rascunho_gmail':
-        return await require('./api').api('/api/integrations/google/gmail/send', { method: 'POST', token: opts.token, body: { draftId: input.rascunho_id, confirmed: true } });
+        return await require('./api').api('/api/integrations/google/gmail/send', { method: 'POST', token: opts.token, body: { draftId: input.id_rascunho, confirmed: true } });
       case 'listar_arquivos_drive': {
         const p = new URLSearchParams({ limit: String(Math.min(100, Math.max(1, parseInt(input.limite) || 30))) });
         if (input.busca) p.set('query', input.busca); if (input.tipo_mime) p.set('mimeType', input.tipo_mime);
         return await require('./api').api('/api/integrations/google/drive/files?' + p, { token: opts.token });
       }
+      case 'selecionar_arquivos_drive':
+        return { url: 'https://terminalsmart.com.br/integracoes#google-files', instrucao: 'Abra o link e clique em Escolher arquivos do Drive.' };
+      case 'criar_google_docs':
+        return await require('./api').api('/api/integrations/google/docs/create', { method: 'POST', token: opts.token, body: { name: input.nome, text: input.texto_inicial || '', folderId: input.id_pasta, confirmed: true } });
       case 'ler_google_docs':
         return await require('./api').api('/api/integrations/google/docs/document?id=' + encodeURIComponent(input.id_documento), { token: opts.token });
       case 'editar_google_docs':
@@ -936,6 +960,8 @@ async function execute(name, input, opts = {}) {
         const p = new URLSearchParams({ id: input.id_planilha }); if (input.intervalo) p.set('range', input.intervalo);
         return await require('./api').api('/api/integrations/google/sheets/values?' + p, { token: opts.token });
       }
+      case 'criar_google_sheets':
+        return await require('./api').api('/api/integrations/google/sheets/create', { method: 'POST', token: opts.token, body: { name: input.nome, range: input.intervalo || 'A1', values: input.valores || [], folderId: input.id_pasta, confirmed: true } });
       case 'editar_google_sheets':
         return await require('./api').api('/api/integrations/google/sheets/update', { method: 'POST', token: opts.token, body: { spreadsheetId: input.id_planilha, range: input.intervalo, values: input.valores, createCopy: input.criar_copia === true, copyName: input.nome_copia, confirmed: true } });
       case 'ler_apresentacao': {
@@ -971,4 +997,4 @@ async function execute(name, input, opts = {}) {
   } catch (e) { return { erro: String((e && e.message) || e).slice(0, 400) }; }
 }
 
-module.exports = { DEFS, execute, isDestructive, selfDestructiveReason, buildProjectMap };
+module.exports = { DEFS, execute, isDestructive, selfDestructiveReason, buildProjectMap, _test: { shellGotcha: _shellGotcha } };

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "terminal-smart-cli",
-  "version": "0.97.11",
+  "version": "0.97.13",
   "description": "Terminal Smart no seu terminal — pergunte, analise logs por pipe e orquestre agentes de IA. Comando: ts",
   "bin": {
     "ts": "bin/ts.js"
   },
   "scripts": {
-    "test": "node test/core.test.js && node test/intelligence-core.test.js && node test/cloud-slug.test.js && node test/eval-model.test.js && node test/project-cache.test.js && node test/memory-bus.test.js && node test/capabilities.test.js && node test/mcp-e2e.test.js && node test/erros.test.js && node test/capability-pack.test.js && node test/byok.test.js && node test/conhecimento.test.js && node test/policy.test.js && node test/temas.test.js && node test/skill-index.test.js && node test/doctor.test.js && node test/google-workspace-tools.test.js && node test/office-editors.test.js"
+    "test": "node test/core.test.js && node test/intelligence-core.test.js && node test/cloud-slug.test.js && node test/eval-model.test.js && node test/project-cache.test.js && node test/memory-bus.test.js && node test/capabilities.test.js && node test/mcp-e2e.test.js && node test/erros.test.js && node test/capability-pack.test.js && node test/video-generation.test.js && node test/byok.test.js && node test/conhecimento.test.js && node test/policy.test.js && node test/temas.test.js && node test/skill-index.test.js && node test/doctor.test.js && node test/google-workspace-tools.test.js && node test/office-editors.test.js"
   },
   "files": [
     "bin",
@@ -24,7 +24,7 @@
     "ssh",
     "agente"
   ],
-  "author": "Terminal Smart <contato@terminalsmart.com.br>",
+  "author": "Terminal Smart <contato@g3tecnegocios.com>",
   "homepage": "https://terminalsmart.com.br/cli",
   "bugs": {
     "url": "https://terminalsmart.com.br/cli"