paris-immersion 0.1.5 → 0.1.7

package/dist/index.js

@@ -12,7 +12,7 @@ import { serveCommand } from './commands/serve.js';
 const program = new Command()
     .name('paris')
     .description('Paris Immersion — CLI do aluno (login, workspace, tarefas)')
-    .version('0.1.5');
+    .version('0.1.7');
 program
     .command('login')
     .description('Autenticar com sua conta Paris (device-code OR --token direto)')

package/dist/lib/relay-agent.js

@@ -12,6 +12,7 @@ import { WebSocket } from 'ws';
 import { spawnCoachPty } from '../commands/serve.js';
 const TYPE_DATA = 0x00;
 const TYPE_RESIZE = 0x01;
+const TYPE_WORKSPACE = 0x02; // agent → viewer: caminho do workspace (pro handoff nativo)
 /** plaintext = type(1) || body → frame = nonce(12) || AES-256-GCM(enc||tag). */
 function seal(key, type, body) {
     const nonce = crypto.randomBytes(12);
@@ -72,12 +73,14 @@ export async function startRelayAgent(opts) {
     // "no-op" (reconexão com mesma dimensão) e forçar o Claude a repintar.
     let ptyCols = 80;
     let ptyRows = 24;
-    // Coalescing da saída do pty: o Claude emite a tela em RAJADAS de muitos
-    // chunks pequenos. Cifrar/enviar cada um (1 AES-GCM + 1 frame WS por chunk)
-    // é caro e deixa a escrita lenta. Junta numa janela curta → 1 frame por
-    // rajada. ~12ms é imperceptível e corta o overhead drasticamente.
-    const COALESCE_MS = 12;
-    const MAX_OUT_BUF = 64 * 1024;
+    // Coalescing da saída do pty: o Claude faz streaming token-a-token (~20-30ms
+    // entre tokens). Com janela curta, cada token vira um frame (1 AES-GCM + 1
+    // frame WS + 1 round-trip + 1 render) → escrita picotada/lenta. Uma janela
+    // maior junta VÁRIOS tokens por frame → escrita lisa, muito menos overhead.
+    // O custo é ~Xms a mais de latência — imperceptível pra leitura do curso.
+    // Ajustável por env (PARIS_RELAY_COALESCE_MS) pra afinar sem republicar.
+    const COALESCE_MS = Math.min(250, Math.max(0, Number(process.env.PARIS_RELAY_COALESCE_MS) || 55));
+    const MAX_OUT_BUF = 256 * 1024;
     let outBuf = '';
     let flushTimer;
     const flushOut = () => {
@@ -181,6 +184,16 @@ export async function startRelayAgent(opts) {
                             killTimer = undefined;
                         }
                         startPty(); // no-op se já tem Claude vivo → reatacha na mesma sessão
+                        // Informa o caminho do workspace pro browser oferecer o handoff nativo
+                        // ("seguir no terminal nativo" → cd <ws> && claude --continue).
+                        if (opts.cwd && ws && ws.readyState === WebSocket.OPEN) {
+                            try {
+                                ws.send(seal(key, TYPE_WORKSPACE, Buffer.from(opts.cwd, 'utf8')), { binary: true });
+                            }
+                            catch {
+                                /* noop */
+                            }
+                        }
                     }
                     else if (m.t === 'viewer-left') {
                         // Não mata na hora — janela de graça pra reconexão reatachar.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paris-immersion",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Paris Immersion CLI — login, install workspace, status, task control. Para alunos das imersões da Paris Group.",
   "homepage": "https://parisgroup.ai",
   "repository": {