primocode 7.10.1 → 7.12.0

package/lib/modo.js

@@ -30,12 +30,16 @@ const VERBOS = [
     'implement[ae]r?', 'l[eê]i?a?r?', 'procur[ae]r?', 'busc[ae]r?', 'encontr[ae]r?',
     'renome[ai]r?', 'copi[ae]r?', 'commit[ae]r?', 'deploy',
     'sobe', 'suba', 'subir', 'empurr[ae]r?', 'mergea?r?',
+    // Interação com o computador: "clica no botão", "digita a senha",
+    // "pesquisa no google", "aperta enter", "arrasta o arquivo".
+    'clic[ao]r?', 'clique', 'digit[ae]r?', 'pesquis[ae]r?', 'apert[ae]r?',
+    'arrast[ae]r?', 'rol[ae]r?', 'minimiz[ae]r?', 'maximiz[ae]r?', 'fech[ae]r?',
 ];
 const RE_VERBO = new RegExp(`(^|\\s)(${VERBOS.join('|')})\\b`, 'i');
 
 // Coisas que só existem quando há trabalho de arquivo/máquina envolvido.
 const RE_ARTEFATO = /\.(js|ts|tsx|jsx|html|css|json|md|py|sh|yml|yaml|txt|csv|env)\b|[\w-]+\/[\w-]/i;
-const RE_FERRAMENTA = /\b(navegador|browser|desktop|terminal|shell|git|npm|node|deploy|servidor|localhost|porta \d+|screenshot|print da tela)\b/i;
+const RE_FERRAMENTA = /\b(navegador|browser|desktop|terminal|shell|git|npm|node|deploy|servidor|localhost|porta \d+|screenshot|print da tela|mouse|teclado|janela|[áa]rea de trabalho|aplicativo|[íi]cone)\b/i;
 const RE_PASTA = /\b(pasta|diret[óo]rio|arquivo|arquivos|reposit[óo]rio|repo|projeto)\b/i;
 
 // Conversa: cumprimento, agradecimento, pergunta conceitual.

package/lib/streaming.js

@@ -0,0 +1,410 @@
+/**
+ * streaming.js — o painel "ao vivo": ver o agente mexendo no computador.
+ *
+ * O agente age no desktop do usuário (clica, digita, abre janela), mas rápido
+ * demais para acompanhar a olho nu — e às vezes numa janela que não está na
+ * frente. O /streaming liga um servidorzinho HTTP local que abre um site com
+ * a cara do PrimoCode: mascote + nome no cabeçalho e, abaixo, uma "janela"
+ * com ABAS — "Ao vivo" mostra a tela agora, e cada app/janela em que o agente
+ * mexeu vira uma aba própria, com os passos e as fotos daquele app. Dá para
+ * voltar e rever o que ele já fez, passo a passo.
+ *
+ * Zero dependências: http nativo, uma página HTML embutida que consulta
+ * /state a cada 700ms. Só escuta em 127.0.0.1 — nada disso sai da máquina.
+ */
+
+'use strict';
+
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const desktop = require('./desktop');
+
+const DIR = path.join(os.homedir(), '.primocode', 'streaming');
+const MAX_LOG = 300;
+// Fotos guardadas em disco para o "voltar no tempo" das abas. Além disso a
+// pasta viraria um álbum infinito — as mais velhas saem.
+const MAX_FRAMES = 80;
+const MAX_ABAS = 12;
+// Uma foto por ação no máximo a cada 600ms: digitar letra por letra não pode
+// virar uma rajada de screenshots.
+const INTERVALO_FOTO_MS = 600;
+
+const state = {
+    on: false,
+    server: null,
+    url: '',
+    frames: [],        // [{ id, hora, acao, aba }] — id é o nome do arquivo
+    proximoFrame: 1,
+    abas: [],          // [{ id, nome, passos: 0 }] — "Ao vivo" é virtual, não entra aqui
+    abaAtual: null,
+    log: [],
+    erroFoto: null,
+    ultimaFoto: 0,
+    passo: 0,
+};
+
+// Ações cujo efeito aparece NA TELA — são as que merecem uma foto nova.
+const ACOES_NA_TELA = new Set([
+    'desktop_click', 'desktop_double_click', 'desktop_click_element',
+    'desktop_move', 'desktop_drag', 'desktop_type', 'desktop_key',
+    'desktop_scroll', 'desktop_open_app', 'desktop_focus', 'desktop_screenshot',
+    'browser_open', 'browser_click', 'browser_type', 'browser_key',
+    'browser_scroll',
+]);
+
+function isOn() { return state.on; }
+function url() { return state.url; }
+
+const corta = (s, n) => { const t = String(s ?? ''); return t.length > n ? t.slice(0, n - 1) + '…' : t; };
+
+// A frase humana de cada ação — é o que aparece na linha do tempo.
+function descrever(name, args = {}) {
+    switch (name) {
+        case 'desktop_click': return `clique em (${args.x}, ${args.y})`;
+        case 'desktop_double_click': return `clique duplo em (${args.x}, ${args.y})`;
+        case 'desktop_click_element': return `clique em “${corta(args.name, 40)}”${args.double ? ' (duplo)' : ''}`;
+        case 'desktop_move': return `mouse para (${args.x}, ${args.y})`;
+        case 'desktop_drag': return `arrastou (${args.from_x}, ${args.from_y}) → (${args.to_x}, ${args.to_y})`;
+        case 'desktop_type': return `digitou “${corta(args.text, 40)}”`;
+        case 'desktop_key': return `tecla ${args.key}`;
+        case 'desktop_scroll': return `rolou a tela (${args.dy ?? 300})`;
+        case 'desktop_open_app': return `abriu ${corta(args.app || args.name, 40)}`;
+        case 'desktop_focus': return `focou a janela “${corta(args.window || args.title, 40)}”`;
+        case 'desktop_windows': return 'listou as janelas abertas';
+        case 'desktop_elements': return `leu os elementos${args.window ? ` de “${corta(args.window, 30)}”` : ' da janela em foco'}`;
+        case 'desktop_screenshot': return 'tirou um print da tela';
+        case 'desktop_size': return 'mediu a tela';
+        case 'browser_open': return `abriu ${corta(args.url, 60)} no navegador`;
+        case 'browser_click': return `clicou em “${corta(args.text || args.selector || `${args.x},${args.y}`, 40)}” na página`;
+        case 'browser_type': return `digitou “${corta(args.text, 40)}” na página`;
+        case 'browser_key': return `tecla ${args.key} na página`;
+        case 'browser_scroll': return 'rolou a página';
+        case 'browser_read': return 'leu a página';
+        case 'browser_screenshot': return 'print da página';
+        case 'browser_wait': return `esperou ${corta(args.selector, 40)}`;
+        case 'browser_eval': return 'rodou JavaScript na página';
+        case 'write_file': return `criou/reescreveu ${corta(args.path, 50)}`;
+        case 'edit_file': return `editou ${corta(args.path, 50)}`;
+        case 'multi_edit': return `editou ${corta(args.path, 50)} (várias trocas)`;
+        case 'read_file': return `leu ${corta(args.path, 50)}`;
+        case 'run_shell': return `rodou: ${corta(args.command, 60)}`;
+        case 'run_in_new_terminal': return `terminal novo: ${corta(args.command, 50)}`;
+        case 'write_todos': return 'atualizou o plano';
+        default: return name.replace(/_/g, ' ');
+    }
+}
+
+// ── Abas: uma por app/janela em que o agente mexeu ────────────────────────
+// Abrir um app, focar uma janela ou abrir um site começa (ou reencontra) a
+// aba daquele contexto. As ações seguintes caem nela — é o que deixa o
+// "o que a IA já fez" navegável depois, em vez de um rolo único.
+
+function nomeDeAba(name, args = {}) {
+    if (name === 'desktop_open_app') return String(args.app || args.name || '').trim();
+    if (name === 'desktop_focus') return String(args.window || args.title || '').trim();
+    if (name === 'browser_open') {
+        try { return new URL(String(args.url)).hostname || 'navegador'; } catch { return 'navegador'; }
+    }
+    if (args && args.window) return String(args.window).trim();
+    return '';
+}
+
+function entrarNaAba(nome) {
+    const alvo = corta(nome, 24);
+    if (!alvo) return;
+    let aba = state.abas.find((a) => a.nome.toLowerCase() === alvo.toLowerCase());
+    if (!aba) {
+        aba = { id: state.abas.length + 1, nome: alvo, passos: 0 };
+        state.abas.push(aba);
+        if (state.abas.length > MAX_ABAS) state.abas.shift();
+    }
+    state.abaAtual = aba;
+}
+
+/**
+ * Chamada pelo loop do agente depois de CADA tool. Quando o streaming está
+ * desligado é um no-op — o caminho normal não paga nada por isto.
+ */
+function step(name, args, result) {
+    if (!state.on) return;
+
+    const troca = nomeDeAba(name, args || {});
+    if (troca) entrarNaAba(troca);
+    if (!state.abaAtual && ACOES_NA_TELA.has(name)) entrarNaAba('Tela');
+
+    state.passo++;
+    if (state.abaAtual) state.abaAtual.passos++;
+
+    const entrada = {
+        n: state.passo,
+        hora: new Date().toTimeString().slice(0, 8),
+        acao: descrever(name, args || {}),
+        ok: !(result && result.ok === false),
+        erro: result && result.ok === false ? corta(result.error, 120) : undefined,
+        aba: state.abaAtual ? state.abaAtual.id : null,
+    };
+
+    if (ACOES_NA_TELA.has(name)) {
+        const frame = capturar(entrada);
+        if (frame) entrada.frame = frame;
+    }
+
+    state.log.push(entrada);
+    if (state.log.length > MAX_LOG) state.log.splice(0, state.log.length - MAX_LOG);
+}
+
+function capturar(entrada) {
+    const agora = Date.now();
+    if (agora - state.ultimaFoto < INTERVALO_FOTO_MS) return null;
+    state.ultimaFoto = agora;
+
+    const id = state.proximoFrame;
+    const arquivo = path.join(DIR, `frame-${id}.png`);
+    const r = desktop.screenshot(arquivo);
+    if (!r.ok) { if (!state.erroFoto) state.erroFoto = r.error; return null; }
+
+    state.erroFoto = null;
+    state.proximoFrame++;
+    state.frames.push({ id, hora: entrada.hora, acao: entrada.acao, aba: entrada.aba });
+    while (state.frames.length > MAX_FRAMES) {
+        const velho = state.frames.shift();
+        try { fs.unlinkSync(path.join(DIR, `frame-${velho.id}.png`)); } catch {}
+    }
+    return id;
+}
+
+// ── Página ────────────────────────────────────────────────────────────────
+// O desenho combinado: mascote + PrimoCode no cabeçalho; abaixo, uma "janela"
+// de borda branca com as três bolinhas e as ABAS; dentro, a tela que a IA
+// está usando (ou usou, nas abas antigas), com os passos daquela aba embaixo.
+
+// O mascote do CLI (▐▛███▜▌ …) redesenhado em SVG, célula a célula, na mesma
+// paleta: bloco cheio na cor viva, contorno na apagada.
+const MASCOTE_SVG = `<svg viewBox="0 0 9 3.6" aria-hidden="true">
+<g fill="#0891b2"><rect x="1" y="0" width="1" height="1"/><rect x="7" y="0" width="1" height="1"/><rect x="0" y="1" width="1" height="1" opacity=".7"/><rect x="8" y="1" width="1" height="1" opacity=".7"/><rect x="1" y="1" width="1" height="1"/><rect x="7" y="1" width="1" height="1"/></g>
+<g fill="#22d3ee"><rect x="2" y="0" width="5" height="1" rx=".12"/><rect x="2" y="1" width="5" height="1"/><rect x="1.9" y="2.2" width=".9" height=".5" rx=".1"/><rect x="3.4" y="2.2" width=".9" height=".5" rx=".1"/><rect x="4.9" y="2.2" width=".9" height=".5" rx=".1"/><rect x="6.4" y="2.2" width=".9" height=".5" rx=".1"/></g>
+<g fill="#0b1220"><rect x="3" y=".35" width=".8" height=".5" rx=".1"/><rect x="5.2" y=".35" width=".8" height=".5" rx=".1"/><rect x="3.9" y="1.25" width="1.2" height=".28" rx=".14"/></g>
+</svg>`;
+
+const PAGINA = `<!doctype html>
+<html lang="pt-BR"><head><meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>PrimoCode · Ao vivo</title>
+<style>
+  * { box-sizing: border-box; margin: 0; }
+  body { background: #17181a; color: #e2e8f0; font: 14px/1.5 ui-monospace, 'Cascadia Code', Consolas, monospace; min-height: 100vh; display: flex; flex-direction: column; align-items: center; padding: 18px 14px 26px; }
+
+  /* Cabeçalho: mascote + nome */
+  header { display: flex; align-items: center; gap: 16px; padding: 6px 0 18px; }
+  header .mascote { width: 72px; height: 30px; transform: rotate(-8deg); }
+  header .mascote svg { width: 100%; height: 100%; display: block; }
+  header h1 { font-size: 34px; font-weight: 700; letter-spacing: .5px; }
+  header h1 b { color: #22d3ee; font-weight: 700; }
+  header .vivo { margin-left: 14px; display: inline-flex; align-items: center; gap: 7px; color: #64748b; font-size: 12px; }
+  .dot { width: 9px; height: 9px; border-radius: 50%; background: #22d3ee; animation: pulsa 1.4s infinite; }
+  @keyframes pulsa { 50% { opacity: .25 } }
+
+  /* A "janela" */
+  #janela { width: min(1060px, 100%); background: #000; border: 4px solid #f4f4f4; border-radius: 26px; overflow: hidden; display: flex; flex-direction: column; box-shadow: 0 18px 60px rgba(0,0,0,.55); }
+  #barra { display: flex; align-items: center; gap: 8px; background: #232323; padding: 10px 16px; border-bottom: 1px solid #101010; }
+  #barra .b { width: 13px; height: 13px; border-radius: 50%; flex: none; }
+  #barra .b.r { background: #e5484d; } #barra .b.y { background: #f5d90a; } #barra .b.g { background: #46d160; }
+
+  #abas { display: flex; gap: 4px; margin-left: 14px; overflow-x: auto; scrollbar-width: none; }
+  #abas::-webkit-scrollbar { display: none; }
+  .aba { border: 0; cursor: pointer; white-space: nowrap; font: inherit; font-size: 13px; padding: 5px 14px; border-radius: 9px 9px 0 0; background: transparent; color: #94a3b8; }
+  .aba:hover { color: #e2e8f0; }
+  .aba.ativa { background: #000; color: #22d3ee; }
+  .aba .qtd { color: #475569; font-size: 11px; margin-left: 6px; }
+
+  #tela { position: relative; min-height: 380px; display: flex; align-items: center; justify-content: center; background: #000; }
+  #tela img { width: 100%; max-height: 62vh; object-fit: contain; display: none; }
+  #aviso { color: #94a3b8; text-align: center; max-width: 52ch; padding: 70px 20px; font-size: 15px; }
+  #carimbo { position: absolute; left: 12px; bottom: 10px; background: rgba(11,18,32,.82); border: 1px solid #1e293b; color: #94a3b8; font-size: 12px; padding: 3px 10px; border-radius: 7px; display: none; max-width: 85%; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+  /* Filmstrip + passos da aba */
+  #rodape { background: #0b0c0e; border-top: 1px solid #1c1d20; }
+  #filme { display: flex; gap: 6px; padding: 8px 12px 2px; overflow-x: auto; }
+  .foto { flex: none; border: 1px solid #26272b; border-radius: 6px; background: #000; cursor: pointer; padding: 0; width: 84px; height: 50px; overflow: hidden; opacity: .75; }
+  .foto img { width: 100%; height: 100%; object-fit: cover; display: block; }
+  .foto.ativa { border-color: #22d3ee; opacity: 1; }
+  #passos { max-height: 150px; overflow-y: auto; padding: 6px 4px 10px; }
+  .item { padding: 3px 14px; display: flex; gap: 8px; font-size: 13px; }
+  .item .n { color: #475569; min-width: 3ch; text-align: right; }
+  .item .ok { color: #22d3ee; } .item .falha { color: #fb7185; }
+  .item .txt { flex: 1; word-break: break-word; color: #cbd5e1; }
+  .item .txt .erro { color: #fb7185; font-size: 12px; display: block; }
+  .item .hora { color: #475569; font-size: 11px; }
+  .item.temfoto { cursor: pointer; } .item.temfoto:hover .txt { color: #22d3ee; }
+
+  footer { color: #475569; font-size: 12px; padding-top: 14px; }
+</style></head>
+<body>
+<header>
+  <div class="mascote">${MASCOTE_SVG}</div>
+  <h1><b>Primo</b>Code</h1>
+  <span class="vivo"><span class="dot"></span><span id="st">conectando…</span></span>
+</header>
+
+<div id="janela">
+  <div id="barra">
+    <span class="b r"></span><span class="b y"></span><span class="b g"></span>
+    <nav id="abas"></nav>
+  </div>
+  <section id="tela">
+    <img id="frame" alt="tela que a IA está usando">
+    <div id="aviso">Tela que a IA está usando aparece aqui, em tempo real.<br><br>Dê uma instrução no terminal do PrimoCode — cada app em que ela mexer vira uma aba, e você pode voltar para ver o que ela já fez.</div>
+    <div id="carimbo"></div>
+  </section>
+  <div id="rodape">
+    <div id="filme"></div>
+    <div id="passos"></div>
+  </div>
+</div>
+<footer>só nesta máquina (127.0.0.1) · /streaming desliga</footer>
+
+<script>
+const VIVO = 0;                 // id da aba "Ao vivo"
+let dados = { abas: [], frames: [], log: [] };
+let abaSel = VIVO;              // aba escolhida pelo usuário
+let fotoSel = null;             // frame fixado no filmstrip (null = mais recente)
+let ultimoEstado = '';
+
+function esc(s) { return String(s ?? '').replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c])); }
+
+function framesDaAba(id) {
+  return id === VIVO ? dados.frames : dados.frames.filter((f) => f.aba === id);
+}
+function logDaAba(id) {
+  return id === VIVO ? dados.log : dados.log.filter((e) => e.aba === id);
+}
+
+function render() {
+  // Abas: "Ao vivo" + uma por app/janela
+  const nav = document.getElementById('abas');
+  const abas = [{ id: VIVO, nome: 'Ao vivo' }, ...dados.abas];
+  nav.innerHTML = abas.map((a) =>
+    '<button class="aba' + (a.id === abaSel ? ' ativa' : '') + '" data-id="' + a.id + '">'
+    + (a.id === VIVO ? '● ' : '') + esc(a.nome)
+    + (a.passos ? '<span class="qtd">' + a.passos + '</span>' : '')
+    + '</button>').join('');
+  nav.querySelectorAll('.aba').forEach((b) => b.onclick = () => { abaSel = Number(b.dataset.id); fotoSel = null; render(); });
+
+  // Imagem: a fixada no filmstrip, senão a mais nova da aba
+  const fs = framesDaAba(abaSel);
+  const atual = fotoSel != null ? fs.find((f) => f.id === fotoSel) : fs[fs.length - 1];
+  const img = document.getElementById('frame');
+  const aviso = document.getElementById('aviso');
+  const carimbo = document.getElementById('carimbo');
+  if (atual) {
+    const src = '/frame?n=' + atual.id;
+    if (img.dataset.n !== String(atual.id)) { img.src = src; img.dataset.n = String(atual.id); }
+    img.style.display = 'block'; aviso.style.display = 'none';
+    carimbo.style.display = 'block';
+    carimbo.textContent = '#' + atual.id + ' · ' + atual.hora + ' · ' + atual.acao + (fotoSel != null ? '  (clique na miniatura de novo para voltar ao mais recente)' : '');
+  } else {
+    img.style.display = 'none'; aviso.style.display = 'block'; carimbo.style.display = 'none';
+    if (dados.erroFoto) aviso.innerHTML = 'Sem foto da tela: ' + esc(dados.erroFoto);
+  }
+
+  // Filmstrip da aba (as últimas 14)
+  const filme = document.getElementById('filme');
+  const tira = fs.slice(-14);
+  filme.innerHTML = tira.map((f) =>
+    '<button class="foto' + ((atual && f.id === atual.id) ? ' ativa' : '') + '" data-id="' + f.id + '" title="' + esc(f.acao) + '"><img loading="lazy" src="/frame?n=' + f.id + '"></button>').join('');
+  filme.querySelectorAll('.foto').forEach((b) => b.onclick = () => {
+    const id = Number(b.dataset.id);
+    fotoSel = (fotoSel === id) ? null : id;   // clicar de novo volta ao "mais recente"
+    render();
+  });
+  if (fotoSel == null) filme.scrollLeft = filme.scrollWidth;
+
+  // Passos da aba (mais novos primeiro)
+  const passos = logDaAba(abaSel).slice(-40).reverse();
+  document.getElementById('passos').innerHTML = passos.map((e) =>
+    '<div class="item' + (e.frame ? ' temfoto" data-frame="' + e.frame : '') + '">'
+    + '<span class="n">' + e.n + '</span>'
+    + '<span class="' + (e.ok ? 'ok' : 'falha') + '">' + (e.ok ? '✔' : '✗') + '</span>'
+    + '<span class="txt">' + esc(e.acao) + (e.erro ? '<span class="erro">' + esc(e.erro) + '</span>' : '') + '</span>'
+    + '<span class="hora">' + e.hora + '</span></div>').join('');
+  document.querySelectorAll('.item.temfoto').forEach((el) => el.onclick = () => { fotoSel = Number(el.dataset.frame); render(); });
+}
+
+async function tick() {
+  try {
+    const s = await (await fetch('/state')).json();
+    dados = s;
+    document.getElementById('st').textContent = 'ao vivo · porta ' + location.port;
+    const assinatura = JSON.stringify([s.frames.length, s.log.length, s.abas.length, s.erroFoto]);
+    if (assinatura !== ultimoEstado) { ultimoEstado = assinatura; render(); }
+  } catch (e) {
+    document.getElementById('st').textContent = 'reconectando…';
+  }
+  setTimeout(tick, 700);
+}
+tick();
+</script>
+</body></html>`;
+
+function start() {
+    if (state.on) return Promise.resolve(state.url);
+    try { fs.mkdirSync(DIR, { recursive: true }); } catch {}
+    // Fotos de sessões passadas não pertencem a esta linha do tempo.
+    try { for (const f of fs.readdirSync(DIR)) if (/^frame-\d+\.png$/.test(f)) fs.unlinkSync(path.join(DIR, f)); } catch {}
+
+    return new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            const u = new URL(req.url || '/', 'http://x');
+            if (u.pathname === '/state') {
+                res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8', 'Cache-Control': 'no-store' });
+                res.end(JSON.stringify({
+                    erroFoto: state.erroFoto,
+                    abas: state.abas,
+                    frames: state.frames,
+                    log: state.log.slice(-120),
+                }));
+                return;
+            }
+            if (u.pathname === '/frame') {
+                // O id vem de fora: só serve o arquivo se for número — nada de
+                // path traversal por aqui.
+                const id = Math.round(Number(u.searchParams.get('n')));
+                const conhecido = Number.isFinite(id) && state.frames.some((f) => f.id === id);
+                if (!conhecido) { res.writeHead(404); res.end(); return; }
+                fs.readFile(path.join(DIR, `frame-${id}.png`), (err, buf) => {
+                    if (err) { res.writeHead(404); res.end(); return; }
+                    // Cada frame é imutável: o navegador pode guardar à vontade.
+                    res.writeHead(200, { 'Content-Type': 'image/png', 'Cache-Control': 'max-age=3600' });
+                    res.end(buf);
+                });
+                return;
+            }
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(PAGINA);
+        });
+
+        server.on('error', reject);
+        // unref: o painel não pode segurar o processo vivo — /exit tem de sair
+        // mesmo com o streaming ligado.
+        server.on('connection', (s) => s.unref());
+        // Só na própria máquina: isto é a tela do usuário, não um serviço.
+        server.listen(0, '127.0.0.1', () => {
+            server.unref();
+            state.server = server;
+            state.on = true;
+            state.url = `http://127.0.0.1:${server.address().port}`;
+            resolve(state.url);
+        });
+    });
+}
+
+function stop() {
+    if (state.server) { try { state.server.close(); } catch {} }
+    state.server = null;
+    state.on = false;
+    state.url = '';
+}
+
+module.exports = { start, stop, step, isOn, url, descrever };

package/lib/tools.js

@@ -436,6 +436,22 @@ async function despachar(name, args, ctx) {
                 return desktop.scroll(args.dy != null ? args.dy : 300);
             case 'desktop_size':
                 return desktop.getScreenSize();
+            case 'desktop_double_click':
+                return desktop.doubleClick(args.x, args.y);
+            case 'desktop_open_app':
+                return desktop.openApp(args.app || args.name || '');
+            case 'desktop_windows':
+                return desktop.listWindows();
+            case 'desktop_focus':
+                return desktop.focusWindow(args.window || args.title || '');
+            case 'desktop_elements':
+                return desktop.uiElements(args.window);
+            case 'desktop_click_element':
+                return desktop.clickElement(args.name || args.text || '', {
+                    window: args.window,
+                    double: !!args.double,
+                    button: args.button,
+                });
 
             default:
                 return { ok: false, error: `Tool não implementada: ${name}` };

package/lib/ui.js

@@ -161,9 +161,9 @@ const TIPS = [
 ];
 
 const NEWS = [
+    'Agora ele INTERAGE com o computador: janelas, botões e ícones pelo nome',
+    '/streaming abre um painel ao vivo — veja cada passo dele na tela',
     'Dois provedores em corrente: acabou a cota de um, o outro atende',
-    'Ele trabalha em ~/primocode. Fale o nome de uma pasta e ele muda sozinho',
-    'Falha de navegador agora diz quais seletores EXISTEM na página',
 ];
 
 // ── Cabeçalho ────────────────────────────────────────────────────────────
@@ -309,9 +309,12 @@ function actionHeader(name, args) {
         desktop_screenshot:'Desktop·shot', desktop_click:'Desktop·click', desktop_move:'Desktop·move',
         desktop_drag:'Desktop·drag', desktop_type:'Desktop·type', desktop_key:'Desktop·key',
         desktop_scroll:'Desktop·scroll', desktop_size:'Desktop·size',
+        desktop_double_click:'Desktop·2click', desktop_open_app:'Desktop·app',
+        desktop_windows:'Desktop·janelas', desktop_focus:'Desktop·foco',
+        desktop_elements:'Desktop·elementos', desktop_click_element:'Desktop·click',
     };
     const label = nice[name] || name;
-    const argStr = args ? (args.path || args.pattern || args.command || args.target || args.url || args.selector || args.text || args.description || (args.todos ? `${args.todos.length} tarefas` : '') || (args.x != null ? `${args.x},${args.y}` : '') || args.key || JSON.stringify(args).slice(0,60)) : '';
+    const argStr = args ? (args.path || args.pattern || args.command || args.target || args.url || args.selector || args.text || args.app || args.window || args.name || args.description || (args.todos ? `${args.todos.length} tarefas` : '') || (args.x != null ? `${args.x},${args.y}` : '') || args.key || JSON.stringify(args).slice(0,60)) : '';
     return `  ${c.dim('⎿')} ${c.brand(label)}${argStr ? ' '+c.muted(argStr) : ''}`;
 }
 

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "primocode",
-  "version": "7.10.1",
-  "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Modelos grátis. Cria arquivos, roda comandos, controla navegador e desktop.",
+  "version": "7.12.0",
+  "description": "PrimoCode — agente de engenharia com IA e cursor próprio. Modelos grátis. Cria arquivos, roda comandos, controla navegador e desktop: abre apps, clica em botões e ícones pelo nome, digita e usa atalhos.",
   "main": "bin/primocode.js",
   "bin": {
     "primocode": "bin/primocode.js"
   },
   "scripts": {
     "start": "node bin/primocode.js",
-    "test": "node test/tools.test.js && node test/ui.test.js && node test/modo.test.js && node test/pasta.test.js && node test/catalogo.test.js"
+    "test": "node test/tools.test.js && node test/ui.test.js && node test/modo.test.js && node test/pasta.test.js && node test/catalogo.test.js && node test/desktop.test.js"
   },
   "engines": {
     "node": ">=18.17.0"