@leg3ndy/otto-bridge 1.0.4 → 1.0.6

package/README.md

@@ -11,11 +11,11 @@ Companion local do Otto para:
 
 Para um passo a passo de instalacao, pareamento, uso, desconexao e desinstalacao, veja [USER_GUIDE.md](https://github.com/LGCYYL/ottoai/blob/main/otto-bridge/USER_GUIDE.md).
 
-Para o estado atual da arquitetura, capacidades entregues, limitacoes e roadmap do Otto Bridge, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_ARCHITECTURE.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_ARCHITECTURE.md).
+Para o estado atual da arquitetura, capacidades entregues, limitacoes e roadmap do Otto Bridge, veja [`leg3ndy-ai-backend/docs/otto-bridge/OTTO_BRIDGE_ARCHITECTURE.md`](../leg3ndy-ai-backend/docs/otto-bridge/OTTO_BRIDGE_ARCHITECTURE.md).
 
-Para o corte de arquitetura do `0.9.0`, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md).
+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.4`, com estabilizacao do TTY, pensamento visivel no modo `Thinking` e replay web mais compacto, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_4_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_4_PATCH.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).
 
 ## 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.4.tgz
+npm install -g ./leg3ndy-otto-bridge-1.0.6.tgz
 ```
 
-Na linha `1.0.4`, `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.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.
 
-No macOS, a linha `1.0.4` 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.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 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.4` consolida o hub terminal como fluxo principal, estabiliza o TTY do console, deixa o modo `Thinking` visualmente claro e reduz o ruido do replay no modal web.
+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.
 
 ## Publicacao
 
@@ -147,9 +147,17 @@ No modo `OttoAI Thinking`, o terminal agora marca explicitamente o trecho de rac
 
 Quando o handoff local devolver resultado estruturado, o CLI agora mostra inline a listagem de arquivos e o conteúdo de `read_file`, em vez de só resumir que executou a tarefa.
 
+### Abrir um shell local pelo hub
+
+```bash
+otto-bridge terminal
+```
+
+Esse comando abre um shell local interativo para instalar extensoes, rodar comandos externos e fazer operacao manual sem encerrar o bridge. No hub principal, a opcao `Terminal` faz a mesma coisa e volta ao menu quando voce sair com `exit`.
+
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.0.4`:
+Fluxo recomendado na linha `1.0.6`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -159,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.4`:
+Contrato da linha `1.0.6`:
 
 - `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.4
+## Handoff rapido da linha 1.0.6
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
 import { createInterface } from "node:readline/promises";
 import { cursorTo, moveCursor, } from "node:readline";
 import process, { stdin as input, stdout as output } from "node:process";
@@ -49,6 +50,8 @@ const MAX_RENDERED_LIST_ENTRIES = 28;
 const MAX_RENDERED_LIST_ENTRIES_COMPACT = 10;
 const MAX_RENDERED_FILE_CHARS = 6_000;
 const MAX_RENDERED_FILE_CHARS_COMPACT = 1_400;
+const CONSOLE_PLACEHOLDER = "Peça algo ao Otto";
+const CONSOLE_COMMAND_HINT = "/help, /model [fast|thinking], /status, /clear, /exit";
 class CliRuntimeSession {
     config;
     runtime = null;
@@ -56,6 +59,7 @@ class CliRuntimeSession {
     status = "offline";
     detail = "Aguardando pairing.";
     lastError = null;
+    releaseNotice = null;
     constructor(config) {
         this.config = config;
     }
@@ -89,8 +93,24 @@ class CliRuntimeSession {
                 }
                 return;
             case "update_required":
+                this.releaseNotice = {
+                    kind: "required",
+                    message: event.message,
+                    currentVersion: normalizeText(event.currentVersion),
+                    latestVersion: normalizeText(event.latestVersion),
+                    minSupportedVersion: normalizeText(event.minSupportedVersion),
+                    updateCommand: normalizeText(event.updateCommand) || "otto-bridge update",
+                };
+                return;
             case "update_available":
-                this.detail = truncate(event.message || this.detail, 160);
+                this.releaseNotice = {
+                    kind: "available",
+                    message: event.message,
+                    currentVersion: normalizeText(event.currentVersion),
+                    latestVersion: normalizeText(event.latestVersion),
+                    minSupportedVersion: normalizeText(event.minSupportedVersion),
+                    updateCommand: normalizeText(event.updateCommand) || "otto-bridge update",
+                };
                 return;
             default:
                 return;
@@ -177,6 +197,9 @@ class CliRuntimeSession {
     getLastError() {
         return this.lastError;
     }
+    getReleaseNotice() {
+        return this.releaseNotice;
+    }
 }
 function style(text, color, enabled = true) {
     if (!enabled) {
@@ -397,6 +420,7 @@ function extractConfirmationPrompt(job) {
         || payload.confirmation_message) || "O Otto está aguardando sua confirmação para continuar.";
 }
 function renderStatusOverview(config, runtimeSession) {
+    const releaseNotice = runtimeSession?.getReleaseNotice();
     return [
         `${style("Device", ANSI.brandBlue, supportsAnsi())}: ${config.deviceName}`,
         `${style("Device ID", ANSI.brandBlue, supportsAnsi())}: ${config.deviceId}`,
@@ -407,6 +431,21 @@ function renderStatusOverview(config, runtimeSession) {
         ...(runtimeSession?.getStatusDetail()
             ? [`${style("Runtime note", ANSI.brandBlue, supportsAnsi())}: ${runtimeSession.getStatusDetail()}`]
             : []),
+        ...(releaseNotice
+            ? [
+                `${style("Bridge update", ANSI.brandBlue, supportsAnsi())}: ${releaseNotice.kind === "required" ? "required" : "available"}`,
+                ...(releaseNotice.currentVersion
+                    ? [`${style("Current version", ANSI.brandBlue, supportsAnsi())}: ${releaseNotice.currentVersion}`]
+                    : []),
+                ...(releaseNotice.latestVersion
+                    ? [`${style("Latest version", ANSI.brandBlue, supportsAnsi())}: ${releaseNotice.latestVersion}`]
+                    : []),
+                ...(releaseNotice.minSupportedVersion
+                    ? [`${style("Min supported", ANSI.brandBlue, supportsAnsi())}: ${releaseNotice.minSupportedVersion}`]
+                    : []),
+                `${style("Update command", ANSI.brandBlue, supportsAnsi())}: ${releaseNotice.updateCommand || "otto-bridge update"}`,
+            ]
+            : []),
         `${style("Config", ANSI.brandBlue, supportsAnsi())}: ${getBridgeConfigPath()}`,
     ];
 }
@@ -439,6 +478,9 @@ function styleCardLine(line, tone, enabled) {
     if (tone === "title") {
         return `${ANSI.bold}${ANSI.brandBlue}${line}${ANSI.reset}`;
     }
+    if (tone === "warning") {
+        return `${ANSI.bold}${ANSI.amber}${line}${ANSI.reset}`;
+    }
     if (tone === "muted") {
         return `${ANSI.slateItalic}${line}${ANSI.reset}`;
     }
@@ -474,49 +516,151 @@ function buildWelcomeCard(runtimeSession, modelMode) {
         { text: renderRuntimeHeadline(runtimeSession), tone: "muted" },
     ];
 }
+function buildBridgeReleaseCard(notice) {
+    const isRequired = notice.kind === "required";
+    return [
+        {
+            text: isRequired ? "Atualização obrigatória do bridge" : "Atualização disponível do bridge",
+            tone: "warning",
+        },
+        { text: "", tone: "muted" },
+        {
+            text: isRequired
+                ? `Atual: ${notice.currentVersion || "desconhecida"}  |  mínima: ${notice.minSupportedVersion || "desconhecida"}`
+                : `Atual: ${notice.currentVersion || "desconhecida"}  |  nova: ${notice.latestVersion || "desconhecida"}`,
+            tone: "muted",
+        },
+        {
+            text: isRequired
+                ? "Este bridge precisa ser atualizado para continuar suportado."
+                : "Há uma nova versão do Otto Bridge pronta para instalar.",
+            tone: "muted",
+        },
+        { text: `Rode: ${notice.updateCommand || "otto-bridge update"}`, tone: "primary" },
+    ];
+}
 function printHubScreen(runtimeSession, modelMode) {
     clearScreen();
     console.log(renderBanner());
     console.log("");
     console.log(renderInfoCard(buildWelcomeCard(runtimeSession, modelMode)));
+    const releaseNotice = runtimeSession?.getReleaseNotice();
+    if (releaseNotice) {
+        console.log("");
+        console.log(renderInfoCard(buildBridgeReleaseCard(releaseNotice)));
+    }
 }
 function printConsoleScreen(runtimeSession, modelMode) {
     clearScreen();
     console.log(renderBanner());
     console.log("");
     console.log(renderInfoCard(buildWelcomeCard(runtimeSession, modelMode)));
-    console.log("");
-    console.log(style("Peça algo ao Otto", `${ANSI.bold}${ANSI.white}`, supportsAnsi()));
-    printSoft("Comandos: /help, /model [fast|thinking], /status, /clear, /exit");
+    const releaseNotice = runtimeSession.getReleaseNotice();
+    if (releaseNotice) {
+        console.log("");
+        console.log(renderInfoCard(buildBridgeReleaseCard(releaseNotice)));
+    }
     console.log("");
 }
 function renderPromptFrameLine(width, edgeLeft, edgeRight) {
     return style(`${edgeLeft}${"─".repeat(width)}${edgeRight}`, ANSI.brandBlue, supportsAnsi());
 }
+function renderConsolePromptContentLine(text, width, tone) {
+    const enabled = supportsAnsi();
+    const border = style("│", ANSI.brandBlue, enabled);
+    if (tone === "input") {
+        const prompt = `${style(">", `${ANSI.bold}${ANSI.white}`, enabled)} ${" ".repeat(Math.max(0, width - 2))}`;
+        return `${border} ${prompt} ${border}`;
+    }
+    const clipped = padRight(truncate(text, width), width);
+    const body = tone === "placeholder"
+        ? style(clipped, `${ANSI.bold}${ANSI.white}`, enabled)
+        : style(clipped, ANSI.slateItalic, enabled);
+    return `${border} ${body} ${border}`;
+}
 async function askConsoleInput(rl) {
-    if (!supportsAnsi()) {
+    if (!supportsAnsi() || typeof input.setRawMode !== "function" || !input.isTTY) {
+        printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
+        console.log("");
         return normalizeText(await question(rl, "> "));
     }
-    const availableWidth = Number(output.columns || 96);
-    const inputWidth = Math.max(28, Math.min(availableWidth - 12, 92));
-    const top = renderPromptFrameLine(inputWidth + 4, "┌", "┐");
-    const bottom = renderPromptFrameLine(inputWidth + 4, "└", "┘");
-    const middle = [
-        style("│", ANSI.brandBlue, true),
-        " ",
-        style(">", `${ANSI.bold}${ANSI.white}`, true),
-        " ",
-        " ".repeat(inputWidth),
-        " ",
-        style("│", ANSI.brandBlue, true),
-    ].join("");
-    output.write(`${top}\n${middle}\n${bottom}`);
-    cursorTo(output, 0);
-    moveCursor(output, 0, -1);
-    cursorTo(output, 4);
-    const answer = normalizeText(await question(rl, ""));
-    output.write("\n");
-    return answer;
+    rl.pause();
+    input.setRawMode(true);
+    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;
+        let renderedOnce = false;
+        let value = "";
+        const cleanup = () => {
+            input.removeListener("data", onData);
+            input.setRawMode(false);
+            rl.resume();
+        };
+        const renderInputContent = () => {
+            const promptPlain = "> ";
+            const promptStyled = style(">", `${ANSI.bold}${ANSI.white}`, enabled);
+            const maxValueLength = Math.max(0, innerWidth - promptPlain.length);
+            if (!value) {
+                const placeholder = truncate(CONSOLE_PLACEHOLDER, maxValueLength);
+                const padded = `${style(placeholder, ANSI.slate, enabled)}${" ".repeat(Math.max(0, maxValueLength - placeholder.length))}`;
+                return `${promptStyled} ${padded}`;
+            }
+            const visibleValue = value.length > maxValueLength
+                ? value.slice(value.length - maxValueLength)
+                : value;
+            return `${promptStyled} ${visibleValue}${" ".repeat(Math.max(0, maxValueLength - visibleValue.length))}`;
+        };
+        const render = () => {
+            if (renderedOnce) {
+                cursorTo(output, 0);
+                moveCursor(output, 0, -sectionTopOffsetFromInputLine);
+            }
+            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`);
+            cursorTo(output, 0);
+            moveCursor(output, 0, -2);
+            const visibleValueLength = Math.min(value.length, Math.max(0, innerWidth - 2));
+            cursorTo(output, 4 + visibleValueLength);
+        };
+        const onData = (chunk) => {
+            const text = Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+            for (const char of Array.from(text)) {
+                if (char === "\u0003") {
+                    cleanup();
+                    reject(createCliExitError());
+                    return;
+                }
+                if (char === "\r" || char === "\n") {
+                    cleanup();
+                    output.write("\n");
+                    resolve(normalizeText(value));
+                    return;
+                }
+                if (char === "\u007f" || char === "\b") {
+                    value = value.slice(0, -1);
+                    render();
+                    continue;
+                }
+                if (char === "\u001b") {
+                    continue;
+                }
+                value += char;
+                render();
+            }
+        };
+        render();
+        input.on("data", onData);
+    });
 }
 function printAssistantMessage(message) {
     const text = normalizeText(message);
@@ -637,6 +781,16 @@ export function renderStructuredOutcome(job, options) {
     }
     return lines.join("\n").trim();
 }
+export function renderBridgeReleaseNoticeCard(notice) {
+    return renderInfoCard(buildBridgeReleaseCard({
+        kind: notice.kind,
+        message: normalizeText(notice.message),
+        currentVersion: normalizeText(notice.currentVersion),
+        latestVersion: normalizeText(notice.latestVersion),
+        minSupportedVersion: normalizeText(notice.minSupportedVersion),
+        updateCommand: normalizeText(notice.updateCommand) || "otto-bridge update",
+    }));
+}
 function printStructuredOutcome(job) {
     const rendered = renderStructuredOutcome(job);
     if (!rendered) {
@@ -645,6 +799,43 @@ function printStructuredOutcome(job) {
     console.log("");
     console.log(rendered);
 }
+function resolveTerminalShellCommand() {
+    if (process.platform === "win32") {
+        return {
+            command: process.env.COMSPEC || "cmd.exe",
+            args: [],
+        };
+    }
+    return {
+        command: process.env.SHELL || "/bin/zsh",
+        args: ["-l"],
+    };
+}
+export async function runTerminalShell(options) {
+    clearScreen();
+    console.log(renderBanner());
+    console.log("");
+    printSection("Terminal");
+    printMuted(options?.fromHub
+        ? "Saindo temporariamente para o shell local. Digite `exit` para voltar ao Otto Bridge."
+        : "Abrindo o shell local. Digite `exit` para encerrar e voltar ao terminal anterior.");
+    console.log("");
+    const shell = resolveTerminalShellCommand();
+    await new Promise((resolve, reject) => {
+        const child = spawn(shell.command, shell.args, {
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.on("error", reject);
+        child.on("exit", (code, signal) => {
+            if (signal || code === 0 || code === 130) {
+                resolve();
+                return;
+            }
+            reject(new Error(`Terminal local encerrou com code ${code ?? "unknown"}.`));
+        });
+    });
+}
 function buildConversationSummary(summary, job) {
     const rendered = renderStructuredOutcome(job, { compact: true });
     if (!rendered) {
@@ -764,7 +955,9 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
     const sessionId = randomUUID();
     const conversation = [];
     const printConsoleHelp = () => {
+        printSection("Console");
         printSoft("Comandos: /help, /model [fast|thinking], /status, /clear, /exit");
+        printSoft("Bridge: otto-bridge terminal, otto-bridge extensions --install <name>, otto-bridge update");
     };
     const handlePrompt = async (promptText) => {
         const normalizedPrompt = normalizeText(promptText);
@@ -927,12 +1120,24 @@ async function printHelpView(rl) {
         { text: "otto-bridge", tone: "primary" },
         { text: "Abre o hub principal e sobe o runtime local automaticamente.", tone: "muted" },
         { text: "", tone: "muted" },
+        { text: "otto-bridge terminal", tone: "primary" },
+        { text: "Abre um shell local interativo sem desligar o bridge.", tone: "muted" },
+        { text: "", tone: "muted" },
         { text: "otto-bridge setup", tone: "primary" },
         { text: "Repareia o dispositivo e atualiza config/executor.", tone: "muted" },
         { text: "", tone: "muted" },
         { text: "otto-bridge console", tone: "primary" },
         { text: "Abre direto o console do Otto no terminal.", tone: "muted" },
         { text: "", tone: "muted" },
+        { text: "otto-bridge extensions --install <name>", tone: "primary" },
+        { text: "Instala uma extensao local do bridge.", tone: "muted" },
+        { text: "", tone: "muted" },
+        { text: "otto-bridge update --dry-run | otto-bridge update", tone: "primary" },
+        { text: "Mostra ou aplica a atualizacao global do pacote.", tone: "muted" },
+        { text: "", tone: "muted" },
+        { text: "otto-bridge version | otto-bridge unpair", tone: "primary" },
+        { text: "Mostra a versao instalada ou remove o pairing local.", tone: "muted" },
+        { text: "", tone: "muted" },
         { text: "Dentro do console: /help, /model fast|thinking, /status, /clear, /exit", tone: "muted" },
     ]));
     await pauseForEnter(rl);
@@ -942,22 +1147,26 @@ async function pickHomeChoice(rl, paired) {
     const options = paired
         ? [
             `${style("1.", ANSI.brandBlue, supportsAnsi())} Otto Console`,
-            `${style("2.", ANSI.brandBlue, supportsAnsi())} Setup / parear novamente`,
-            `${style("3.", ANSI.brandBlue, supportsAnsi())} Status detalhado`,
-            `${style("4.", ANSI.brandBlue, supportsAnsi())} Extensões instaladas`,
-            `${style("5.", ANSI.brandBlue, supportsAnsi())} Sair`,
+            `${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("6.", ANSI.brandBlue, supportsAnsi())} Ajuda`,
+            `${style("7.", ANSI.brandBlue, supportsAnsi())} Sair`,
         ]
         : [
             `${style("1.", ANSI.brandBlue, supportsAnsi())} Pairing setup`,
-            `${style("2.", ANSI.brandBlue, supportsAnsi())} Sair`,
+            `${style("2.", ANSI.brandBlue, supportsAnsi())} Terminal`,
             `${style("3.", ANSI.brandBlue, supportsAnsi())} Ajuda`,
+            `${style("4.", ANSI.brandBlue, supportsAnsi())} Sair`,
         ];
     console.log(options.join("\n"));
     const answer = await ask(rl, "Escolha");
     if (!paired) {
         if (answer === "1")
             return "setup";
+        if (answer === "2")
+            return "terminal";
         if (answer === "3")
             return "help";
         return "exit";
@@ -965,17 +1174,19 @@ async function pickHomeChoice(rl, paired) {
     if (answer === "1")
         return "console";
     if (answer === "2")
-        return "setup";
+        return "terminal";
     if (answer === "3")
-        return "status";
+        return "setup";
     if (answer === "4")
+        return "status";
+    if (answer === "5")
         return "extensions";
     if (answer === "6")
         return "help";
     return "exit";
 }
 export async function launchInteractiveCli(options) {
-    const rl = await createPromptInterface();
+    let rl = await createPromptInterface();
     let runtimeSession = null;
     try {
         let config = await loadBridgeConfig();
@@ -1006,6 +1217,31 @@ export async function launchInteractiveCli(options) {
                 await printHelpView(rl);
                 continue;
             }
+            if (choice === "terminal") {
+                rl.close();
+                await runTerminalShell({ fromHub: true });
+                rl = await createPromptInterface();
+                const refreshedConfig = await loadBridgeConfig();
+                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)) {
+                    config = refreshedConfig;
+                    if (runtimeSession) {
+                        await runtimeSession.replaceConfig(refreshedConfig);
+                        await runtimeSession.waitForReady();
+                    }
+                    else {
+                        runtimeSession = new CliRuntimeSession(refreshedConfig);
+                        await runtimeSession.ensureStarted();
+                        await runtimeSession.waitForReady();
+                    }
+                }
+                continue;
+            }
             if (choice === "setup") {
                 const setup = await runSetupWizard(rl);
                 if (setup.config) {

package/dist/main.js

@@ -6,7 +6,7 @@ import { buildInstalledManagedExtensionState, formatManagedBridgeExtensionStatus
 import { pairDevice } from "./pairing.js";
 import { detectWhatsAppBackgroundStatus, runWhatsAppBackgroundSetup, } from "./whatsapp_background.js";
 import { BRIDGE_PACKAGE_NAME, BRIDGE_VERSION, DEFAULT_PAIR_TIMEOUT_SECONDS, DEFAULT_POLL_INTERVAL_MS, } from "./types.js";
-import { launchInteractiveCli, runConsoleCommand, runSetupCommand, } from "./cli_terminal.js";
+import { launchInteractiveCli, runConsoleCommand, runSetupCommand, runTerminalShell, } from "./cli_terminal.js";
 const RUNTIME_STATUS_FRESHNESS_MS = 90_000;
 const UPDATE_RETRY_DELAYS_MS = [0, 8_000, 20_000];
 function parseArgs(argv) {
@@ -107,6 +107,7 @@ function printUsage() {
   otto-bridge                             abre o hub principal e sobe o runtime local
   otto-bridge setup                       refaz o pairing no terminal
   otto-bridge console                     abre direto o console do Otto
+  otto-bridge terminal                    abre um shell local e volta ao hub ao sair
   otto-bridge status                      mostra o pairing atual em JSON
   otto-bridge extensions --list
   otto-bridge extensions --install <name>
@@ -127,9 +128,13 @@ Console:
 
 Examples:
   otto-bridge
+  otto-bridge terminal
+  otto-bridge status
   otto-bridge extensions --install <name>
   otto-bridge extensions --setup <name>
+  otto-bridge update
   otto-bridge update --dry-run
+  otto-bridge unpair
   otto-bridge --version`);
 }
 function printVersion() {
@@ -560,6 +565,9 @@ async function main() {
         case "console":
             await runConsoleCommand(option(args, "prompt"));
             return;
+        case "terminal":
+            await runTerminalShell();
+            return;
         case "pair":
             await runPairCommand(args);
             return;

package/dist/runtime.js

@@ -389,13 +389,27 @@ export class BridgeRuntime {
         if (updateRequired) {
             const message = `[otto-bridge] update required current=${this.config.bridgeVersion} min_supported=${minSupportedVersion || "unknown"} latest=${latestVersion || "unknown"} command="${updateCommand}"`;
             this.logWarn(message);
-            this.emit({ type: "update_required", message });
+            this.emit({
+                type: "update_required",
+                message,
+                currentVersion: this.config.bridgeVersion,
+                latestVersion,
+                minSupportedVersion,
+                updateCommand,
+            });
             return;
         }
         if (updateAvailable) {
             const message = `[otto-bridge] update available current=${this.config.bridgeVersion} latest=${latestVersion || "unknown"} command="${updateCommand}"`;
             this.logInfo(message);
-            this.emit({ type: "update_available", message });
+            this.emit({
+                type: "update_available",
+                message,
+                currentVersion: this.config.bridgeVersion,
+                latestVersion,
+                minSupportedVersion,
+                updateCommand,
+            });
         }
     }
     clearPendingConfirmations(jobId) {

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "1.0.4";
+export const BRIDGE_VERSION = "1.0.6";
 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.4",
+  "version": "1.0.6",
   "private": false,
   "type": "module",
   "description": "Local companion for Otto Bridge device pairing and WebSocket runtime.",
@@ -40,6 +40,7 @@
     "pair": "node dist/main.js pair",
     "setup": "node dist/main.js setup",
     "console": "node dist/main.js console",
+    "terminal": "node dist/main.js terminal",
     "run": "node dist/main.js run",
     "status": "node dist/main.js status",
     "version:cli": "node dist/main.js version",

package/scripts/postinstall.mjs

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