@leg3ndy/otto-bridge 1.0.6 → 1.0.8

package/README.md

@@ -15,7 +15,7 @@ Para o estado atual da arquitetura, capacidades entregues, limitacoes e roadmap
 
 Para o corte de arquitetura do `0.9.0`, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_0_9_0_RELEASE.md).
 
-Para a release atual `1.0.6`, com aviso de update no proprio CLI e input-box refinado do console, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_6_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_6_PATCH.md).
+Para a release atual `1.0.8`, com cards visuais para status/extensoes e refresh inteligente ao voltar do Terminal, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_8_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_8_PATCH.md).
 
 ## Distribuicao
 
@@ -38,14 +38,14 @@ Enquanto o pacote nao estiver publicado, voce pode gerar um tarball local:
 
 ```bash
 npm pack
-npm install -g ./leg3ndy-otto-bridge-1.0.6.tgz
+npm install -g ./leg3ndy-otto-bridge-1.0.8.tgz
 ```
 
-Na linha `1.0.6`, `playwright` segue como dependencia obrigatoria no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
+Na linha `1.0.8`, `playwright` segue como dependencia obrigatoria no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
 
-No macOS, a linha `1.0.6` usa o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. O runtime antigo com Chromium/Playwright fica disponivel apenas como override explicito via `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
+No macOS, a linha `1.0.8` usa o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. O runtime antigo com Chromium/Playwright fica disponivel apenas como override explicito via `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
 
-No nivel arquitetural, o `0.9.0` marcou a mudanca de papel do bridge: ele publica tools e resultados estruturados para o Otto, em vez de injetar resposta pronta como caminho principal do chat. O `1.0.0` oficializou isso como runtime agentico; o `1.0.6` adiciona aviso de update no proprio CLI e refina o input-box do console sem voltar a poluir a superficie com aliases legados.
+No nivel arquitetural, o `0.9.0` marcou a mudanca de papel do bridge: ele publica tools e resultados estruturados para o Otto, em vez de injetar resposta pronta como caminho principal do chat. O `1.0.0` oficializou isso como runtime agentico; o `1.0.8` preserva esse fluxo, mantem o input-box TTY estavel e melhora as views de status/extensoes e o refresh ao sair do `Terminal`.
 
 ## Publicacao
 
@@ -157,7 +157,7 @@ Esse comando abre um shell local interativo para instalar extensoes, rodar coman
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.0.6`:
+Fluxo recomendado na linha `1.0.8`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -167,13 +167,13 @@ otto-bridge extensions --status whatsappweb
 
 O setup agora abre o login do WhatsApp Web no helper/background browser do proprio bridge. Depois do QR code, o Otto usa a sessao local em background, sem depender de aba visivel no Safari.
 
-Contrato da linha `1.0.6`:
+Contrato da linha `1.0.8`:
 
 - `otto-bridge extensions --setup whatsappweb`: autentica a sessao uma vez
 - `otto-bridge`: mantem o browser persistente do WhatsApp vivo em background enquanto o runtime do hub estiver ativo, sem depender de uma aba aberta no Safari
 - ao fechar o `otto-bridge`: o browser em background e desligado, mas a sessao local fica lembrada para o proximo boot
 
-## Handoff rapido da linha 1.0.6
+## Handoff rapido da linha 1.0.8
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -1,9 +1,10 @@
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
 import { createInterface } from "node:readline/promises";
 import { cursorTo, moveCursor, } from "node:readline";
 import process, { stdin as input, stdout as output } from "node:process";
-import { defaultDeviceName, getBridgeConfigPath, loadBridgeConfig, resolveApiBaseUrl, resolveExecutorConfig, } from "./config.js";
+import { defaultDeviceName, getBridgeConfigPath, loadBridgeConfig, normalizeInstalledExtensions, resolveApiBaseUrl, resolveExecutorConfig, } from "./config.js";
 import { streamDeviceCliChat, } from "./chat_cli_client.js";
 import { formatManagedBridgeExtensionStatus, isManagedBridgeExtensionSlug, loadManagedBridgeExtensionState, } from "./extensions.js";
 import { pairDevice } from "./pairing.js";
@@ -308,6 +309,47 @@ export function resolveCliModelMode(value) {
 function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+async function resolveInstalledBridgeVersion() {
+    try {
+        const raw = await readFile(new URL("../package.json", import.meta.url), "utf8");
+        const parsed = JSON.parse(raw);
+        return normalizeText(parsed.version) || BRIDGE_VERSION;
+    }
+    catch {
+        return BRIDGE_VERSION;
+    }
+}
+async function captureBridgeRuntimeSnapshot(config) {
+    const managedExtensionState = await Promise.all(normalizeInstalledExtensions(config?.installedExtensions || [])
+        .filter(isManagedBridgeExtensionSlug)
+        .sort((left, right) => left.localeCompare(right))
+        .map(async (slug) => {
+        const state = await loadManagedBridgeExtensionState(slug);
+        return {
+            slug,
+            status: normalizeText(state?.status),
+            lastSetupAt: normalizeText(state?.lastSetupAt),
+            notes: normalizeText(state?.notes),
+        };
+    }));
+    return {
+        bridgeVersion: await resolveInstalledBridgeVersion(),
+        configFingerprint: JSON.stringify(config || null),
+        extensionStateFingerprint: JSON.stringify(managedExtensionState),
+    };
+}
+export function diffBridgeRuntimeSnapshots(before, after) {
+    const versionChanged = before.bridgeVersion !== after.bridgeVersion;
+    const configChanged = before.configFingerprint !== after.configFingerprint;
+    const extensionStateChanged = before.extensionStateFingerprint !== after.extensionStateFingerprint;
+    return {
+        versionChanged,
+        configChanged,
+        extensionStateChanged,
+        requiresCliRestart: versionChanged,
+        requiresRuntimeRefresh: configChanged || extensionStateChanged,
+    };
+}
 async function createPromptInterface() {
     const rl = createInterface({
         input,
@@ -539,6 +581,72 @@ function buildBridgeReleaseCard(notice) {
         { text: `Rode: ${notice.updateCommand || "otto-bridge update"}`, tone: "primary" },
     ];
 }
+function buildStatusCard(config, runtimeSession) {
+    const releaseNotice = runtimeSession.getReleaseNotice();
+    return [
+        { text: "Bridge Status", tone: "title" },
+        { text: "", tone: "muted" },
+        { text: `device: ${config.deviceName}`, tone: "primary" },
+        { text: `device id: ${config.deviceId}`, tone: "primary" },
+        { text: `api: ${config.apiBaseUrl}`, tone: "primary" },
+        { text: `executor: ${config.executor.type}`, tone: "primary" },
+        { text: `approval: ${config.approvalMode}`, tone: "primary" },
+        { text: `runtime: ${runtimeSession.getStatusLabel()}`, tone: "primary" },
+        ...(runtimeSession.getStatusDetail()
+            ? [{ text: `runtime note: ${runtimeSession.getStatusDetail()}`, tone: "muted" }]
+            : []),
+        ...(releaseNotice
+            ? [
+                { text: "", tone: "muted" },
+                {
+                    text: `bridge update: ${releaseNotice.kind === "required" ? "required" : "available"}`,
+                    tone: releaseNotice.kind === "required" ? "warning" : "primary",
+                },
+                ...(releaseNotice.currentVersion
+                    ? [{ text: `current version: ${releaseNotice.currentVersion}`, tone: "primary" }]
+                    : []),
+                ...(releaseNotice.latestVersion
+                    ? [{ text: `latest version: ${releaseNotice.latestVersion}`, tone: "primary" }]
+                    : []),
+                ...(releaseNotice.minSupportedVersion
+                    ? [{ text: `min supported: ${releaseNotice.minSupportedVersion}`, tone: "primary" }]
+                    : []),
+                { text: `update command: ${releaseNotice.updateCommand || "otto-bridge update"}`, tone: "muted" },
+            ]
+            : []),
+        { text: "", tone: "muted" },
+        { text: `config: ${getBridgeConfigPath()}`, tone: "muted" },
+    ];
+}
+async function buildExtensionsCard(config) {
+    const lines = [
+        { text: "Extensões", tone: "title" },
+        { text: "", tone: "muted" },
+    ];
+    if (!config.installedExtensions.length) {
+        lines.push({ text: "Nenhuma extensão instalada neste bridge.", tone: "muted" });
+        return lines;
+    }
+    for (const extension of config.installedExtensions) {
+        if (!isManagedBridgeExtensionSlug(extension)) {
+            lines.push({ text: `• ${extension}`, tone: "primary" });
+            lines.push({ text: "Extensão local sem status gerenciado.", tone: "muted" });
+            lines.push({ text: "", tone: "muted" });
+            continue;
+        }
+        const state = await loadManagedBridgeExtensionState(extension);
+        const status = state ? formatManagedBridgeExtensionStatus(state.status) : "sem estado salvo";
+        lines.push({ text: `• ${extension}: ${status}`, tone: "primary" });
+        if (state?.notes) {
+            lines.push({ text: truncate(state.notes, 160), tone: "muted" });
+        }
+        lines.push({ text: "", tone: "muted" });
+    }
+    while (lines.length > 2 && !normalizeText(lines[lines.length - 1]?.text)) {
+        lines.pop();
+    }
+    return lines;
+}
 function printHubScreen(runtimeSession, modelMode) {
     clearScreen();
     console.log(renderBanner());
@@ -561,6 +669,8 @@ function printConsoleScreen(runtimeSession, modelMode) {
         console.log(renderInfoCard(buildBridgeReleaseCard(releaseNotice)));
     }
     console.log("");
+    printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
+    console.log("");
 }
 function renderPromptFrameLine(width, edgeLeft, edgeRight) {
     return style(`${edgeLeft}${"─".repeat(width)}${edgeRight}`, ANSI.brandBlue, supportsAnsi());
@@ -580,22 +690,22 @@ function renderConsolePromptContentLine(text, width, tone) {
 }
 async function askConsoleInput(rl) {
     if (!supportsAnsi() || typeof input.setRawMode !== "function" || !input.isTTY) {
-        printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
-        console.log("");
         return normalizeText(await question(rl, "> "));
     }
     rl.pause();
     input.setRawMode(true);
+    input.resume();
     return await new Promise((resolve, reject) => {
         const enabled = supportsAnsi();
         const availableWidth = Number(output.columns || 96);
         const innerWidth = Math.max(42, Math.min(availableWidth - 8, 116));
-        const sectionTopOffsetFromInputLine = 3;
+        const sectionTopOffsetFromInputLine = 1;
         let renderedOnce = false;
         let value = "";
         const cleanup = () => {
             input.removeListener("data", onData);
             input.setRawMode(false);
+            input.pause();
             rl.resume();
         };
         const renderInputContent = () => {
@@ -620,13 +730,12 @@ async function askConsoleInput(rl) {
             else {
                 renderedOnce = true;
             }
-            const commands = style(`Comandos: ${CONSOLE_COMMAND_HINT}`, ANSI.slateItalic, enabled);
             const top = renderPromptFrameLine(innerWidth + 2, "┌", "┐");
             const border = style("│", ANSI.brandBlue, enabled);
             const middle = `${border} ${renderInputContent()} ${border}`;
             const bottom = renderPromptFrameLine(innerWidth + 2, "└", "┘");
             output.write("\u001b[J");
-            output.write(`${commands}\n\n${top}\n${middle}\n${bottom}\n`);
+            output.write(`${top}\n${middle}\n${bottom}\n`);
             cursorTo(output, 0);
             moveCursor(output, 0, -2);
             const visibleValueLength = Math.min(value.length, Math.max(0, innerWidth - 2));
@@ -836,6 +945,30 @@ export async function runTerminalShell(options) {
         });
     });
 }
+async function showRuntimeRefreshProgress(options) {
+    clearScreen();
+    console.log(renderBanner());
+    console.log("");
+    console.log(renderInfoCard([
+        { text: options.title, tone: "title" },
+        { text: "", tone: "muted" },
+        { text: options.detail, tone: "muted" },
+    ]));
+    console.log("");
+    const enabled = supportsAnsi();
+    const width = 28;
+    const steps = Math.max(8, options.steps || width);
+    const delayMs = Math.max(20, options.delayMs || 45);
+    for (let step = 0; step <= steps; step += 1) {
+        const filled = Math.round((step / steps) * width);
+        const empty = Math.max(0, width - filled);
+        const bar = `${"█".repeat(filled)}${"░".repeat(empty)}`;
+        const line = `[${bar}] ${Math.round((step / steps) * 100)}%`;
+        output.write(`\r${style(line, ANSI.brandBlue, enabled)}`);
+        await delay(delayMs);
+    }
+    output.write("\n\n");
+}
 function buildConversationSummary(summary, job) {
     const rendered = renderStructuredOutcome(job, { compact: true });
     if (!rendered) {
@@ -847,23 +980,8 @@ function buildConversationSummary(summary, job) {
     return `${summary}\n${rendered}`.slice(0, 4_000).trim();
 }
 async function printExtensionsOverview(config) {
-    printSection("Extensions");
-    if (!config.installedExtensions.length) {
-        printMuted("Nenhuma extensão instalada neste bridge.");
-        return;
-    }
-    for (const extension of config.installedExtensions) {
-        if (!isManagedBridgeExtensionSlug(extension)) {
-            console.log(`- ${extension}`);
-            continue;
-        }
-        const state = await loadManagedBridgeExtensionState(extension);
-        const status = state ? formatManagedBridgeExtensionStatus(state.status) : "sem estado salvo";
-        console.log(`- ${extension}: ${status}`);
-        if (state?.notes) {
-            printMuted(`  ${truncate(state.notes, 140)}`);
-        }
-    }
+    printSection("Extensões");
+    console.log(renderInfoCard(await buildExtensionsCard(config)));
 }
 async function runSetupWizard(rl, options) {
     printSection(options?.postinstall ? "Setup Inicial" : "Pairing Setup");
@@ -1109,7 +1227,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
 }
 async function printStatusView(rl, config, runtimeSession) {
     printSection("Bridge Status");
-    renderStatusOverview(config, runtimeSession).forEach((line) => console.log(line));
+    console.log(renderInfoCard(buildStatusCard(config, runtimeSession)));
     await pauseForEnter(rl);
 }
 async function printHelpView(rl) {
@@ -1150,7 +1268,7 @@ async function pickHomeChoice(rl, paired) {
             `${style("2.", ANSI.brandBlue, supportsAnsi())} Terminal`,
             `${style("3.", ANSI.brandBlue, supportsAnsi())} Setup / parear novamente`,
             `${style("4.", ANSI.brandBlue, supportsAnsi())} Status detalhado`,
-            `${style("5.", ANSI.brandBlue, supportsAnsi())} Extensões instaladas`,
+            `${style("5.", ANSI.brandBlue, supportsAnsi())} Extensões`,
             `${style("6.", ANSI.brandBlue, supportsAnsi())} Ajuda`,
             `${style("7.", ANSI.brandBlue, supportsAnsi())} Sair`,
         ]
@@ -1188,6 +1306,7 @@ async function pickHomeChoice(rl, paired) {
 export async function launchInteractiveCli(options) {
     let rl = await createPromptInterface();
     let runtimeSession = null;
+    let restartRequested = false;
     try {
         let config = await loadBridgeConfig();
         if (!config) {
@@ -1201,7 +1320,7 @@ export async function launchInteractiveCli(options) {
                 await runOttoConsole(rl, config, runtimeSession);
             }
             if (!config) {
-                return;
+                return { restartRequested: false };
             }
         }
         runtimeSession = runtimeSession || new CliRuntimeSession(config);
@@ -1218,18 +1337,34 @@ export async function launchInteractiveCli(options) {
                 continue;
             }
             if (choice === "terminal") {
+                const snapshotBefore = await captureBridgeRuntimeSnapshot(config);
                 rl.close();
                 await runTerminalShell({ fromHub: true });
-                rl = await createPromptInterface();
                 const refreshedConfig = await loadBridgeConfig();
+                const snapshotAfter = await captureBridgeRuntimeSnapshot(refreshedConfig);
+                const runtimeDiff = diffBridgeRuntimeSnapshots(snapshotBefore, snapshotAfter);
+                rl = await createPromptInterface();
                 if (!refreshedConfig) {
                     await runtimeSession?.stop().catch(() => undefined);
                     runtimeSession = null;
                     printWarning("Pairing local removido no terminal. Encerrando o hub.");
                     break;
                 }
-                if (JSON.stringify(refreshedConfig) !== JSON.stringify(config)) {
+                if (runtimeDiff.requiresCliRestart) {
+                    config = refreshedConfig;
+                    restartRequested = true;
+                    await showRuntimeRefreshProgress({
+                        title: "Reiniciando Otto Bridge",
+                        detail: "Aguarde um minuto, o Otto Bridge está reiniciando para aplicar mudanças.",
+                    });
+                    break;
+                }
+                if (runtimeDiff.requiresRuntimeRefresh) {
                     config = refreshedConfig;
+                    await showRuntimeRefreshProgress({
+                        title: "Aplicando mudanças do runtime",
+                        detail: "Aguarde um instante, o Otto Bridge está atualizando o runtime local para aplicar mudanças.",
+                    });
                     if (runtimeSession) {
                         await runtimeSession.replaceConfig(refreshedConfig);
                         await runtimeSession.waitForReady();
@@ -1284,6 +1419,7 @@ export async function launchInteractiveCli(options) {
         await runtimeSession?.stop().catch(() => undefined);
         rl.close();
     }
+    return { restartRequested };
 }
 export async function runSetupCommand(options) {
     const rl = await createPromptInterface();

package/dist/main.js

@@ -140,6 +140,32 @@ Examples:
 function printVersion() {
     console.log(`${BRIDGE_PACKAGE_NAME} ${BRIDGE_VERSION}`);
 }
+async function restartCurrentCliProcess() {
+    const command = process.platform === "win32" ? "otto-bridge.cmd" : "otto-bridge";
+    const fallbackEntrypoint = process.argv[1];
+    const spawnRestart = (binary, args) => new Promise((resolve, reject) => {
+        const child = spawn(binary, args, {
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.once("spawn", () => {
+            resolve();
+        });
+        child.once("error", (error) => {
+            reject(error);
+        });
+    });
+    try {
+        await spawnRestart(command, []);
+        return;
+    }
+    catch {
+        if (!fallbackEntrypoint) {
+            throw new Error("Nao foi possivel relancar o Otto Bridge apos atualizar.");
+        }
+    }
+    await spawnRestart(process.execPath, [fallbackEntrypoint]);
+}
 function runChildCommand(command, args) {
     return new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -555,7 +581,9 @@ async function main() {
     const args = parseArgs(process.argv.slice(2));
     switch (args.command) {
         case "home":
-            await launchInteractiveCli();
+            if ((await launchInteractiveCli()).restartRequested) {
+                await restartCurrentCliProcess();
+            }
             return;
         case "setup":
             await runSetupCommand({
@@ -572,7 +600,9 @@ async function main() {
             await runPairCommand(args);
             return;
         case "run":
-            await launchInteractiveCli();
+            if ((await launchInteractiveCli()).restartRequested) {
+                await restartCurrentCliProcess();
+            }
             return;
         case "status":
             await runStatusCommand();

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "1.0.6";
+export const BRIDGE_VERSION = "1.0.8";
 export const BRIDGE_PACKAGE_NAME = "@leg3ndy/otto-bridge";
 export const DEFAULT_API_BASE_URL = "http://localhost:8000";
 export const DEFAULT_POLL_INTERVAL_MS = 3000;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leg3ndy/otto-bridge",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "private": false,
   "type": "module",
   "description": "Local companion for Otto Bridge device pairing and WebSocket runtime.",

package/scripts/postinstall.mjs

@@ -24,7 +24,7 @@ if (!existsSync(mainPath)) {
   process.exit(0);
 }
 
-console.log("\n[otto-bridge] Welcome to OTTOAI 1.0.6");
+console.log("\n[otto-bridge] Welcome to OTTOAI 1.0.8");
 console.log("[otto-bridge] Vamos iniciar o setup interativo do bridge.\n");
 
 const result = spawnSync(process.execPath, [mainPath, "setup", "--postinstall"], {