paris-immersion 0.1.4 → 0.1.6

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.4');
+    .version('0.1.6');
 program
     .command('login')
     .description('Autenticar com sua conta Paris (device-code OR --token direto)')

package/dist/lib/relay-agent.js

@@ -72,12 +72,42 @@ 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 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 = () => {
+        flushTimer = undefined;
+        if (!outBuf)
+            return;
+        const data = outBuf;
+        outBuf = '';
+        if (ws && ws.readyState === WebSocket.OPEN) {
+            try {
+                ws.send(seal(key, TYPE_DATA, Buffer.from(data, 'utf8')), { binary: true });
+            }
+            catch {
+                /* ws caiu no meio */
+            }
+        }
+    };
     // Mantém o Claude vivo por uma janela após o viewer sair, pra que uma
     // reconexão (ex.: Safari derruba o ws periodicamente) REATACHE na MESMA sessão
     // em vez de reiniciar o curso. O resize que o viewer manda ao reconectar faz a
     // TUI do Claude repintar a tela atual.
     const PTY_GRACE_MS = 600_000; // 10min — aluno que sai no meio e volta reatacha na MESMA sessão
     const killPty = () => {
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+            flushTimer = undefined;
+        }
+        outBuf = '';
         if (pty) {
             try {
                 pty.kill();
@@ -99,13 +129,17 @@ export async function startRelayAgent(opts) {
             return;
         }
         pty.onData((d) => {
-            if (ws && ws.readyState === WebSocket.OPEN) {
-                try {
-                    ws.send(seal(key, TYPE_DATA, Buffer.from(d, 'utf8')), { binary: true });
-                }
-                catch {
-                    /* ws caiu no meio */
+            outBuf += d;
+            // Flush imediato se acumulou muito (evita um frame gigante); senão coalesce.
+            if (outBuf.length >= MAX_OUT_BUF) {
+                if (flushTimer) {
+                    clearTimeout(flushTimer);
+                    flushTimer = undefined;
                 }
+                flushOut();
+            }
+            else if (!flushTimer) {
+                flushTimer = setTimeout(flushOut, COALESCE_MS);
             }
         });
         pty.onExit?.(() => killPty());

package/package.json

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