paris-immersion 0.1.11 → 0.1.12

package/dist/commands/daemon.d.ts

@@ -4,3 +4,10 @@
  * instalador chama `install`; o `paris logout` chama `uninstall`.
  */
 export declare function daemonCommand(action: string): Promise<void>;
+/**
+ * `paris restart` — religa o agente do terminal embutido. Sempre dá certo:
+ * libera a porta (mata serve preso) e reinstala/reinicia o serviço persistente,
+ * que sobe um serve NOVO com serve-token fresco e reconecta ao relay. É o comando
+ * que a UI do curso oferece quando o terminal não conecta sozinho.
+ */
+export declare function restartCommand(): Promise<void>;

package/dist/commands/daemon.js

@@ -1,4 +1,4 @@
-import { installDaemon, uninstallDaemon, daemonStatus } from '../lib/daemon.js';
+import { installDaemon, uninstallDaemon, daemonStatus, restartDaemon } from '../lib/daemon.js';
 import { c } from '../lib/colors.js';
 /**
  * `paris daemon <install|uninstall|status>` — gerencia o serviço persistente
@@ -33,3 +33,22 @@ export async function daemonCommand(action) {
     console.log(c.yellow("Uso: paris daemon <install|uninstall|status>"));
     process.exitCode = 1;
 }
+/**
+ * `paris restart` — religa o agente do terminal embutido. Sempre dá certo:
+ * libera a porta (mata serve preso) e reinstala/reinicia o serviço persistente,
+ * que sobe um serve NOVO com serve-token fresco e reconecta ao relay. É o comando
+ * que a UI do curso oferece quando o terminal não conecta sozinho.
+ */
+export async function restartCommand() {
+    try {
+        process.stdout.write(c.dim('Religando o agente do terminal embutido…\n'));
+        const { mechanism } = await restartDaemon();
+        console.log(c.green('✓ Agente reiniciado.') + c.dim(` (${mechanism})`));
+        console.log(c.dim('  Volte para a aba do curso — o terminal reconecta sozinho em alguns segundos.'));
+    }
+    catch (err) {
+        console.log(c.yellow(`! Não consegui reiniciar o serviço: ${err instanceof Error ? err.message : String(err)}`));
+        console.log(c.dim('  Tente: paris daemon install'));
+        process.exitCode = 1;
+    }
+}

package/dist/commands/serve.js

@@ -337,6 +337,16 @@ export async function serveCommand(opts) {
     }
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
+        // EADDRINUSE não é erro: o serviço em background (daemon) já tem um `paris
+        // serve` segurando a porta. Não precisa rodar de novo — o terminal embutido
+        // conecta no que já está rodando. Se ele NÃO conectar, é melhor reiniciar
+        // (religa com serve-token fresco) do que falhar com vermelho assustador.
+        if (/EADDRINUSE/i.test(msg)) {
+            console.log(c.green('✓ paris já está rodando') + c.dim(` (porta ${portNum} em uso pelo serviço em background).`));
+            console.log(c.dim('  O terminal do curso conecta no agente que já está ativo.'));
+            console.log(c.dim('  Se o terminal não conectar, rode: ') + c.bold('paris restart'));
+            process.exit(0);
+        }
         console.error(c.red(`Falha ao iniciar paris serve: ${msg}`));
         process.exit(1);
     }

package/dist/index.js

@@ -9,11 +9,11 @@ import { reopenCommand } from './commands/reopen.js';
 import { graduateCommand } from './commands/graduate.js';
 import { logoutCommand } from './commands/logout.js';
 import { serveCommand } from './commands/serve.js';
-import { daemonCommand } from './commands/daemon.js';
+import { daemonCommand, restartCommand } from './commands/daemon.js';
 const program = new Command()
     .name('paris')
     .description('Paris Immersion — CLI do aluno (login, workspace, tarefas)')
-    .version('0.1.11');
+    .version('0.1.12');
 program
     .command('login')
     .description('Autenticar com sua conta Paris (device-code OR --token direto)')
@@ -61,6 +61,10 @@ program
     .command('daemon <action>')
     .description('Serviço persistente do paris serve (install | uninstall | status)')
     .action(daemonCommand);
+program
+    .command('restart')
+    .description('Religa o agente do terminal embutido (libera a porta + reinicia o serviço). Use se o terminal não conectar.')
+    .action(restartCommand);
 program.parseAsync().catch((err) => {
     console.error('\n[paris] erro:', err?.message ?? err);
     process.exit(1);

package/dist/lib/daemon.d.ts

@@ -4,3 +4,18 @@ export declare function installDaemon(): Promise<{
 /** Best-effort — nunca lança (usado no logout, não pode travar). */
 export declare function uninstallDaemon(): Promise<void>;
 export declare function daemonStatus(): Promise<boolean>;
+/**
+ * Mata, best-effort, qualquer processo escutando na porta do serve (default
+ * 31000). Cobre o caso de um `paris serve` "preso" (manual ou daemon zumbi)
+ * segurando a porta — origem do `EADDRINUSE` e do terminal que não conecta.
+ */
+export declare function killServePort(port?: number): Promise<void>;
+/**
+ * Reinicia o agente do terminal embutido de forma que SEMPRE dá certo: libera a
+ * porta (mata serve preso) e re-registra o serviço persistente (que sobe um serve
+ * NOVO — com serve-token fresco, reconectando ao relay). É o que o comando
+ * copiável da UI roda quando o terminal não conecta sozinho.
+ */
+export declare function restartDaemon(port?: number): Promise<{
+    mechanism: string;
+}>;

package/dist/lib/daemon.js

@@ -244,3 +244,46 @@ export async function daemonStatus() {
             return false;
     }
 }
+/**
+ * Mata, best-effort, qualquer processo escutando na porta do serve (default
+ * 31000). Cobre o caso de um `paris serve` "preso" (manual ou daemon zumbi)
+ * segurando a porta — origem do `EADDRINUSE` e do terminal que não conecta.
+ */
+export async function killServePort(port = 31000) {
+    try {
+        if (platform() === 'win32') {
+            await execFileAsync('powershell', [
+                '-NoProfile',
+                '-Command',
+                `Get-NetTCPConnection -LocalPort ${port} -State Listen -ErrorAction SilentlyContinue | ` +
+                    `Select-Object -ExpandProperty OwningProcess -Unique | ` +
+                    `ForEach-Object { Stop-Process -Id $_ -Force -ErrorAction SilentlyContinue }`,
+            ]).catch(() => { });
+            return;
+        }
+        // macOS / Linux: lsof → PIDs escutando na porta → kill.
+        const { stdout } = await execFileAsync('lsof', ['-ti', `tcp:${port}`, '-sTCP:LISTEN']).catch(() => ({ stdout: '' }));
+        const pids = stdout
+            .split('\n')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        for (const pid of pids) {
+            await execFileAsync('kill', ['-TERM', pid]).catch(() => { });
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+}
+/**
+ * Reinicia o agente do terminal embutido de forma que SEMPRE dá certo: libera a
+ * porta (mata serve preso) e re-registra o serviço persistente (que sobe um serve
+ * NOVO — com serve-token fresco, reconectando ao relay). É o que o comando
+ * copiável da UI roda quando o terminal não conecta sozinho.
+ */
+export async function restartDaemon(port = 31000) {
+    await killServePort(port);
+    // pequena folga pro SO liberar o socket antes do novo bind
+    await new Promise((r) => setTimeout(r, 600));
+    return installDaemon();
+}

package/dist/lib/relay-agent.js

@@ -45,23 +45,40 @@ export async function startRelayAgent(opts) {
     if (!opts.apiUrl || !opts.loginToken)
         return null;
     const log = opts.log ?? (() => { });
-    let info;
-    try {
-        const res = await fetch(`${opts.apiUrl.replace(/\/$/, '')}/api/onboarding/v2/serve-token`, {
-            headers: { authorization: `Bearer ${opts.loginToken}` },
-            signal: AbortSignal.timeout(8000),
-        });
-        if (!res.ok)
+    const fetchInfo = async () => {
+        try {
+            const res = await fetch(`${opts.apiUrl.replace(/\/$/, '')}/api/onboarding/v2/serve-token`, {
+                headers: { authorization: `Bearer ${opts.loginToken}` },
+                signal: AbortSignal.timeout(8000),
+            });
+            if (!res.ok)
+                return null;
+            return (await res.json());
+        }
+        catch {
             return null;
-        info = (await res.json());
+        }
+    };
+    // Primeira busca decide se o relay está configurado (senão → modo local-only).
+    // Retry só quando a API está inalcançável (fetchInfo → null): cobre o blip de
+    // rede no boot (o daemon sobe antes da rede) sem penalizar o dev local (a API
+    // responde 200 na 1ª tentativa). KeepAlive mantém o serve, mas sem este retry o
+    // agente relay nunca subia se a 1ª busca caísse no boot.
+    const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+    let initial = await fetchInfo();
+    for (let i = 0; i < 6 && !initial; i++) {
+        await sleep(5000);
+        initial = await fetchInfo();
     }
-    catch {
+    if (!initial || !initial.relayUrl || !initial.token || !initial.e2eKeyB64)
         return null;
-    }
-    const { token, relayUrl, e2eKeyB64 } = info;
-    if (!relayUrl || !token || !e2eKeyB64)
-        return null; // relay não configurado → local-only
-    const key = Buffer.from(e2eKeyB64, 'base64');
+    // Mutáveis: o serve-token é de vida curta e é RENOVADO a cada (re)conexão (o
+    // loginToken/JWT do aluno é estável). Sem isso, o daemon que sobe no boot fica
+    // preso com um token expirado, o relay rejeita o agente, e o terminal embutido
+    // fica "Esperando o paris CLI subir" pra sempre mesmo com o serve rodando.
+    let relayUrl = initial.relayUrl;
+    let token = initial.token;
+    let key = Buffer.from(initial.e2eKeyB64, 'base64'); // chave E2E é estável por participante
     if (key.length !== 32)
         return null;
     let ws = null;
@@ -167,7 +184,19 @@ export async function startRelayAgent(opts) {
             }
         }, 80);
     };
-    const connect = () => {
+    const connect = async () => {
+        if (closed)
+            return;
+        // Renova token + relayUrl + chave a cada tentativa (o serve-token expira;
+        // o loginToken é estável). É isto que conserta o "agente preso no boot".
+        const fresh = await fetchInfo();
+        if (fresh?.relayUrl && fresh.token && fresh.e2eKeyB64) {
+            relayUrl = fresh.relayUrl;
+            token = fresh.token;
+            const k = Buffer.from(fresh.e2eKeyB64, 'base64');
+            if (k.length === 32)
+                key = k;
+        }
         if (closed)
             return;
         const url = `${relayUrl.replace(/\/$/, '')}/agent?token=${encodeURIComponent(token)}`;

package/package.json

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