primocode 7.10.1 → 7.12.0

package/bin/primocode.js

@@ -22,6 +22,7 @@ const cfg = require('../lib/config');
 const { runAct } = require('../lib/act');
 const pasta = require('../lib/pasta');
 const catalogo = require('../lib/catalogo');
+const streaming = require('../lib/streaming');
 
 // A pasta de onde o comando foi dado. Não é mais onde ele trabalha (o padrão é
 // ~/primocode), mas continua servindo de ponto de partida para achar pasta que
@@ -55,6 +56,7 @@ ${c.bold('Comandos')}
   ${c.brand('/read')} <arquivo>       mostra um arquivo
   ${c.brand('/run')} <comando>        executa no shell do projeto
   ${c.brand('/open')} <arquivo|url>   abre no navegador
+  ${c.brand('/streaming')}            painel ao vivo — veja o agente mexendo no computador
   ${c.brand('/status')}               checa o servidor
   ${c.brand('/name')} <nome>          como o Primo te chama
   ${c.brand('/mascot')} <estilo>      mascote: primo|fox|cat
@@ -465,7 +467,7 @@ async function handleSlash(text) {
             for (const g of catalogo.GRUPOS) {
                 console.log('  ' + c.bold(c.white(g.nome)) + ' ' + ui.truncate(c.dim('— ' + g.resumo), cols - 4 - ui.visibleWidth(g.nome)));
                 for (const i of g.itens) {
-                    console.log('    ' + c.brand(ui.padRight(i.tool, 21)) + ui.truncate(c.muted(i.faz), cols - 26));
+                    console.log('    ' + c.brand(ui.padRight(i.tool, 23)) + ui.truncate(c.muted(i.faz), cols - 28));
                 }
                 console.log('');
             }
@@ -503,6 +505,33 @@ async function handleSlash(text) {
             break;
         }
 
+        // Painel ao vivo: um servidorzinho local mostra cada ação do agente na
+        // tela + a foto tirada logo depois dela. Liga/desliga; /streaming on|off
+        // também funciona.
+        case 'streaming': case 'stream': case 'live': {
+            const pedido = rest.toLowerCase();
+            const ligar = pedido === 'on' ? true : pedido === 'off' ? false : !streaming.isOn();
+
+            if (!ligar) {
+                if (streaming.isOn()) { streaming.stop(); console.log(c.ok('Streaming desligado.')); }
+                else console.log(c.muted('O streaming já estava desligado.'));
+                break;
+            }
+            if (streaming.isOn()) {
+                console.log(c.muted(`Já está ligado: ${streaming.url()}`));
+                break;
+            }
+            try {
+                const url = await streaming.start();
+                console.log(c.ok('Streaming ligado: ') + c.white(url));
+                console.log(c.muted('  Dê uma instrução e veja cada passo dele aí, ao vivo. /streaming de novo desliga.'));
+                await tools.openInBrowser(url);
+            } catch (e) {
+                console.log(c.err(`Não consegui ligar o streaming: ${e.message}`));
+            }
+            break;
+        }
+
         case 'name': {
             if (!rest) { console.log(c.muted(`  Nome atual: ${state.config.userName || '(nenhum)'}`)); break; }
             state.config.userName = rest;

package/lib/act.js

@@ -15,6 +15,7 @@ const tools = require('./tools');
 const api = require('./api');
 const cfg = require('./config');
 const catalogo = require('./catalogo');
+const streaming = require('./streaming');
 
 const MAX_ITERATIONS = 15;
 const MAX_PROFUNDIDADE = 2; // principal + 1 nível de subagente
@@ -93,6 +94,27 @@ function logResult(kind, result, profundidade) {
         case 'browser_read':
             console.log(p + c.muted(`${(result.text || '').length} caracteres lidos da página`));
             return;
+        case 'desktop_windows': {
+            console.log(p + c.muted(`${result.total} janela${result.total === 1 ? '' : 's'}`));
+            for (const j of (result.janelas || []).slice(0, 5)) console.log(p + c.dim(`${j.app ? j.app + ' · ' : ''}${j.titulo}`.slice(0, 120)));
+            if ((result.janelas || []).length > 5) console.log(p + c.dim(`… +${result.janelas.length - 5}`));
+            return;
+        }
+        case 'desktop_elements': {
+            console.log(p + c.muted(`${result.total} elemento${result.total === 1 ? '' : 's'} em “${result.janela || 'janela em foco'}”`));
+            for (const e of (result.elementos || []).slice(0, 5)) console.log(p + c.dim(`${e.nome} (${e.x},${e.y})`.slice(0, 120)));
+            if ((result.elementos || []).length > 5) console.log(p + c.dim(`… +${result.elementos.length - 5}`));
+            return;
+        }
+        case 'desktop_click_element':
+            console.log(p + c.ok('ok') + c.muted(` · ${result.duplo ? 'clique duplo' : 'clique'} em “${result.clicado}” (${result.x},${result.y})`));
+            return;
+        case 'desktop_open_app':
+            console.log(p + c.ok('ok') + c.muted(` · ${result.app}`));
+            return;
+        case 'desktop_focus':
+            console.log(p + c.ok('ok') + c.muted(` · ${result.janela || 'em foco'}`));
+            return;
         case 'browser_screenshot':
         case 'desktop_screenshot':
             console.log(p + c.muted(`${result.path} · ${tools.fmtBytes(result.bytes || 0)}`));
@@ -104,6 +126,7 @@ function logResult(kind, result, profundidade) {
         case 'browser_wait':
         case 'browser_eval':
         case 'desktop_click':
+        case 'desktop_double_click':
         case 'desktop_move':
         case 'desktop_drag':
         case 'desktop_type':
@@ -257,6 +280,10 @@ async function runAct(userPrompt, opts) {
             const result = await tools.execute(tc.name, tc.arguments, { projectDir: pastaAtual });
             logResult(tc.name, result, profundidade);
 
+            // Painel ao vivo (/streaming): registra o passo e fotografa a tela.
+            // Nunca pode derrubar o loop — falha de foto é problema do painel.
+            try { streaming.step(tc.name, tc.arguments, result); } catch {}
+
             // Uma escrita bem-sucedida limpa a dívida: o agente se corrigiu.
             if (result && result.ok === false) falhasPendentes.push(`${tc.name}(${tc.arguments?.path || ''}): ${result.error}`);
             else if (['write_file', 'edit_file'].includes(tc.name)) falhasPendentes.length = 0;

package/lib/catalogo.js

@@ -55,16 +55,22 @@ const GRUPOS = [
     },
     {
         nome: 'Computador',
-        resumo: 'mouse, teclado e tela — age em qualquer programa, não só no navegador',
+        resumo: 'janelas, botões, mouse e teclado — age em qualquer programa e na área de trabalho',
         itens: [
-            { tool: 'desktop_screenshot', escreve: true,  faz: 'tira foto da sua tela' },
-            { tool: 'desktop_click',      escreve: false, faz: 'clica na tela' },
-            { tool: 'desktop_move',       escreve: false, faz: 'move o mouse' },
-            { tool: 'desktop_drag',       escreve: false, faz: 'arrasta de um ponto a outro' },
-            { tool: 'desktop_type',       escreve: false, faz: 'digita no programa que está na frente' },
-            { tool: 'desktop_key',        escreve: false, faz: 'aperta tecla ou atalho' },
-            { tool: 'desktop_scroll',     escreve: false, faz: 'rola a tela' },
-            { tool: 'desktop_size',       escreve: false, faz: 'mede a tela, para se orientar antes de clicar' },
+            { tool: 'desktop_open_app',      escreve: false, faz: 'abre um programa pelo nome (Chrome, Bloco de Notas…)' },
+            { tool: 'desktop_windows',       escreve: false, faz: 'lista as janelas abertas, com título' },
+            { tool: 'desktop_focus',         escreve: false, faz: 'traz uma janela para a frente, pelo título' },
+            { tool: 'desktop_elements',      escreve: false, faz: 'lê os botões, campos e ícones da janela, com posição' },
+            { tool: 'desktop_click_element', escreve: false, faz: 'clica num botão ou ícone pelo NOME, sem coordenada' },
+            { tool: 'desktop_click',         escreve: false, faz: 'clica na tela por coordenada' },
+            { tool: 'desktop_double_click',  escreve: false, faz: 'clique duplo — abre ícone da área de trabalho' },
+            { tool: 'desktop_move',          escreve: false, faz: 'move o mouse' },
+            { tool: 'desktop_drag',          escreve: false, faz: 'arrasta de um ponto a outro' },
+            { tool: 'desktop_type',          escreve: false, faz: 'digita no programa que está na frente' },
+            { tool: 'desktop_key',           escreve: false, faz: 'aperta tecla ou atalho (Enter, ctrl+c, alt+tab)' },
+            { tool: 'desktop_scroll',        escreve: false, faz: 'rola a tela' },
+            { tool: 'desktop_size',          escreve: false, faz: 'mede a tela, para se orientar antes de clicar' },
+            { tool: 'desktop_screenshot',    escreve: true,  faz: 'tira foto da sua tela' },
         ],
     },
     {