@leg3ndy/otto-bridge 1.0.4 → 1.0.5

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.5`, com novo modo `Terminal`, input-box mais proximo do estilo Claude e ajuda expandida, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_5_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_5_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.5.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.5`, `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.5` 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.5` adiciona o modo `Terminal`, reorganiza o input-box do console para um fluxo mais proximo do Claude e amplia a ajuda publica 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.5`:
 
 ```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.5`:
 
 - `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.5
 
 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;
@@ -486,36 +489,43 @@ function printConsoleScreen(runtimeSession, modelMode) {
     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");
-    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()) {
+        printMuted(CONSOLE_PLACEHOLDER);
+        printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
         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}`);
+    const inputWidth = Math.max(42, Math.min(availableWidth - 8, 116));
+    const top = renderPromptFrameLine(inputWidth + 2, "┌", "┐");
+    const placeholderLine = renderConsolePromptContentLine(CONSOLE_PLACEHOLDER, inputWidth, "placeholder");
+    const commandsLine = renderConsolePromptContentLine(`Comandos: ${CONSOLE_COMMAND_HINT}`, inputWidth, "commands");
+    const inputLine = renderConsolePromptContentLine("", inputWidth, "input");
+    const bottom = renderPromptFrameLine(inputWidth + 2, "└", "┘");
+    output.write(`${top}\n${placeholderLine}\n${commandsLine}\n${inputLine}\n${bottom}\n`);
     cursorTo(output, 0);
-    moveCursor(output, 0, -1);
+    moveCursor(output, 0, -2);
     cursorTo(output, 4);
     const answer = normalizeText(await question(rl, ""));
-    output.write("\n");
+    cursorTo(output, 0);
+    moveCursor(output, 0, 1);
     return answer;
 }
 function printAssistantMessage(message) {
@@ -645,6 +655,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 +811,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 +976,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 +1003,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 +1030,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 +1073,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/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.5";
 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.5",
   "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.5");
 console.log("[otto-bridge] Vamos iniciar o setup interativo do bridge.\n");
 
 const result = spawnSync(process.execPath, [mainPath, "setup", "--postinstall"], {