@leg3ndy/otto-bridge 1.0.3 → 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.3`, com console terminal azul da marca, seletor `Fast/Thinking` e rendering estruturado de resultados locais, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_3_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_3_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.3.tgz
+npm install -g ./leg3ndy-otto-bridge-1.0.5.tgz
 ```
 
-Na linha `1.0.3`, `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.3` 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.3` consolida o hub terminal como fluxo principal, esconde aliases legados da superfície pública, alinha o console ao comportamento normal do Otto antes de fazer handoff local e melhora a leitura visual/estruturada do resultado no proprio terminal.
+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
 
@@ -143,11 +143,21 @@ Dentro do console, use:
 - `/model thinking` para `OttoAI Thinking`
 - `/status` para ver detalhes técnicos do bridge e do runtime
 
+No modo `OttoAI Thinking`, o terminal agora marca explicitamente o trecho de raciocínio com `Pensando (OttoAI Thinking)` e separa esse bloco da resposta final do Otto.
+
 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.3`:
+Fluxo recomendado na linha `1.0.5`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -157,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.3`:
+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.3
+## Handoff rapido da linha 1.0.5
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -1,5 +1,7 @@
 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";
 import { defaultDeviceName, getBridgeConfigPath, loadBridgeConfig, resolveApiBaseUrl, resolveExecutorConfig, } from "./config.js";
 import { streamDeviceCliChat, } from "./chat_cli_client.js";
@@ -48,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;
@@ -119,6 +123,18 @@ class CliRuntimeSession {
         });
         await delay(350);
     }
+    async waitForReady(timeoutMs = 4500) {
+        const startedAt = Date.now();
+        for (;;) {
+            if (this.status !== "starting") {
+                return;
+            }
+            if (Date.now() - startedAt >= timeoutMs) {
+                return;
+            }
+            await delay(120);
+        }
+    }
     async replaceConfig(nextConfig) {
         await this.stop();
         this.config = nextConfig;
@@ -174,6 +190,13 @@ function style(text, color, enabled = true) {
 function supportsAnsi() {
     return Boolean(output.isTTY);
 }
+function clearScreen() {
+    if (supportsAnsi()) {
+        output.write("\u001b[2J\u001b[3J\u001b[H");
+        return;
+    }
+    console.clear();
+}
 function renderBanner() {
     const enabled = supportsAnsi();
     const lines = OTTOAI_BANNER.map((line) => style(line, ANSI.brandBlue, enabled));
@@ -455,30 +478,54 @@ function buildWelcomeCard(runtimeSession, modelMode) {
     ];
 }
 function printHubScreen(runtimeSession, modelMode) {
-    console.clear();
+    clearScreen();
     console.log(renderBanner());
     console.log("");
     console.log(renderInfoCard(buildWelcomeCard(runtimeSession, modelMode)));
 }
 function printConsoleScreen(runtimeSession, modelMode) {
-    console.clear();
+    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");
-    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) {
-    const availableWidth = Number(output.columns || 90);
-    const frameWidth = Math.max(36, Math.min(availableWidth - 2, 88));
-    console.log(renderPromptFrameLine(frameWidth, "┌", "┐"));
-    const answer = normalizeText(await question(rl, `${style("│", ANSI.brandBlue, supportsAnsi())} ${style(">", `${ANSI.bold}${ANSI.white}`, supportsAnsi())} `));
-    console.log(renderPromptFrameLine(frameWidth, "└", "┘"));
+    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(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, -2);
+    cursorTo(output, 4);
+    const answer = normalizeText(await question(rl, ""));
+    cursorTo(output, 0);
+    moveCursor(output, 0, 1);
     return answer;
 }
 function printAssistantMessage(message) {
@@ -492,9 +539,42 @@ function extractJobOutcome(job) {
     const result = job.result && typeof job.result === "object"
         ? job.result
         : {};
-    return result.outcome && typeof result.outcome === "object"
+    const outcome = result.outcome && typeof result.outcome === "object"
         ? result.outcome
         : {};
+    if (Object.keys(outcome).length > 0) {
+        return outcome;
+    }
+    const payload = job.payload && typeof job.payload === "object"
+        ? job.payload
+        : {};
+    const actions = Array.isArray(payload.actions) ? payload.actions : [];
+    const firstAction = actions.find((item) => item && typeof item === "object");
+    const actionType = normalizeText(firstAction?.type).toLowerCase();
+    if (actionType === "list_files" && result.file_listing && typeof result.file_listing === "object") {
+        const listing = result.file_listing;
+        return {
+            action_type: "list_files",
+            path: normalizeText(firstAction?.path),
+            resolved_path: normalizeText(listing.resolved_path),
+            listed_item_count: listing.item_count,
+            total_item_count: listing.total_item_count,
+            limit_applied: listing.limit_applied,
+            entries: Array.isArray(listing.entries) ? listing.entries : [],
+        };
+    }
+    if (actionType === "read_file" && result.read_file && typeof result.read_file === "object") {
+        const readFile = result.read_file;
+        return {
+            action_type: "read_file",
+            path: normalizeText(firstAction?.path),
+            resolved_path: normalizeText(readFile.resolved_path),
+            content: typeof readFile.content === "string" ? readFile.content : undefined,
+            content_chunks: Array.isArray(readFile.chunks) ? readFile.chunks : [],
+            binary_notice: normalizeText(readFile.binary_notice),
+        };
+    }
+    return {};
 }
 function outcomePathLabel(outcome) {
     return normalizeText(outcome.resolved_path || outcome.path);
@@ -572,8 +652,46 @@ function printStructuredOutcome(job) {
     if (!rendered) {
         return;
     }
+    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) {
@@ -693,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);
@@ -748,6 +868,8 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
         }
         let streamedAssistant = "";
         let assistantPrefixPrinted = false;
+        let reasoningPrefixPrinted = false;
+        let contentSeparatedFromReasoning = false;
         let handoffPayload = null;
         await streamDeviceCliChat(config, {
             messages: conversation,
@@ -771,10 +893,25 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             if (errorMessage) {
                 throw new Error(errorMessage);
             }
+            const reasoningChunk = typeof event.content === "string" && eventType === "reasoning"
+                ? event.content
+                : "";
+            if (reasoningChunk) {
+                if (!reasoningPrefixPrinted) {
+                    output.write(`${style("Pensando (OttoAI Thinking)\n", ANSI.brandBlue, supportsAnsi())}`);
+                    reasoningPrefixPrinted = true;
+                }
+                output.write(style(reasoningChunk, ANSI.slateItalic, supportsAnsi()));
+                return;
+            }
             const contentChunk = typeof event.content === "string" ? event.content : "";
             if (!contentChunk) {
                 return;
             }
+            if (reasoningPrefixPrinted && !contentSeparatedFromReasoning) {
+                output.write("\n\n");
+                contentSeparatedFromReasoning = true;
+            }
             if (!assistantPrefixPrinted) {
                 output.write(`${style("•", ANSI.brandBlue, supportsAnsi())} `);
                 assistantPrefixPrinted = true;
@@ -789,13 +926,13 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
         if (handoffPayload) {
             const handoffData = handoffPayload;
             const bridgeSummary = extractBridgeHandoffSummary(handoffData);
-            if (bridgeSummary) {
-                printAssistantMessage(bridgeSummary);
-            }
             const job = handoffData.job && typeof handoffData.job === "object"
                 ? handoffData.job
                 : null;
             const jobId = normalizeText(job?.id);
+            if (bridgeSummary && !jobId) {
+                printAssistantMessage(bridgeSummary);
+            }
             if (jobId) {
                 finalAssistantSummary = await followConsoleJob(rl, config, jobId);
             }
@@ -810,7 +947,6 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             }
         }
     };
-    printConsoleHelp();
     if (options?.initialPrompt) {
         await handlePrompt(options.initialPrompt);
     }
@@ -830,7 +966,36 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
 async function printStatusView(rl, config, runtimeSession) {
     printSection("Bridge Status");
     renderStatusOverview(config, runtimeSession).forEach((line) => console.log(line));
-    await printExtensionsOverview(config);
+    await pauseForEnter(rl);
+}
+async function printHelpView(rl) {
+    printSection("Ajuda");
+    console.log(renderInfoCard([
+        { text: "Otto Bridge CLI", tone: "title" },
+        { text: "", tone: "muted" },
+        { 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);
 }
 async function pickHomeChoice(rl, paired) {
@@ -838,32 +1003,46 @@ 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) {
-        return answer === "1" ? "setup" : "exit";
+        if (answer === "1")
+            return "setup";
+        if (answer === "2")
+            return "terminal";
+        if (answer === "3")
+            return "help";
+        return "exit";
     }
     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();
@@ -874,6 +1053,7 @@ export async function launchInteractiveCli(options) {
             if (config && setup.openConsole) {
                 runtimeSession = new CliRuntimeSession(config);
                 await runtimeSession.ensureStarted();
+                await runtimeSession.waitForReady();
                 await runOttoConsole(rl, config, runtimeSession);
             }
             if (!config) {
@@ -882,22 +1062,54 @@ export async function launchInteractiveCli(options) {
         }
         runtimeSession = runtimeSession || new CliRuntimeSession(config);
         await runtimeSession.ensureStarted();
+        await runtimeSession.waitForReady();
         for (;;) {
             printHubScreen(runtimeSession, "fast");
             const choice = await pickHomeChoice(rl, true);
             if (choice === "exit") {
                 break;
             }
+            if (choice === "help") {
+                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) {
                     config = setup.config;
                     if (runtimeSession) {
                         await runtimeSession.replaceConfig(setup.config);
+                        await runtimeSession.waitForReady();
                     }
                     else {
                         runtimeSession = new CliRuntimeSession(setup.config);
                         await runtimeSession.ensureStarted();
+                        await runtimeSession.waitForReady();
                     }
                 }
                 if (setup.config && setup.openConsole && runtimeSession) {
@@ -938,6 +1150,7 @@ export async function runSetupCommand(options) {
         if (setup.config && setup.openConsole) {
             runtimeSession = new CliRuntimeSession(setup.config);
             await runtimeSession.ensureStarted();
+            await runtimeSession.waitForReady();
             await runOttoConsole(rl, setup.config, runtimeSession);
         }
     }
@@ -966,6 +1179,7 @@ export async function runConsoleCommand(initialPrompt) {
         }
         runtimeSession = new CliRuntimeSession(config);
         await runtimeSession.ensureStarted();
+        await runtimeSession.waitForReady();
         await runOttoConsole(rl, config, runtimeSession, { initialPrompt });
     }
     catch (error) {

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) {
@@ -104,29 +104,37 @@ function resolveExecutorOverrides(args, current) {
 }
 function printUsage() {
     console.log(`Usage:
-  otto-bridge
-  otto-bridge setup
-  otto-bridge console
-  otto-bridge status
+  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>
   otto-bridge extensions --setup <name>
   otto-bridge extensions --status <name>
   otto-bridge extensions --uninstall <name>
-  otto-bridge version
   otto-bridge update [--tag latest|next] [--dry-run]
   otto-bridge unpair
+  otto-bridge version
+
+Console:
+  /help
+  /model fast
+  /model thinking
+  /status
+  /clear
+  /exit
 
 Examples:
   otto-bridge
-  otto-bridge setup
-  otto-bridge console
+  otto-bridge terminal
+  otto-bridge status
   otto-bridge extensions --install <name>
   otto-bridge extensions --setup <name>
-  otto-bridge extensions --status <name>
-  otto-bridge extensions --list
-  otto-bridge version
+  otto-bridge update
   otto-bridge update --dry-run
+  otto-bridge unpair
   otto-bridge --version`);
 }
 function printVersion() {
@@ -557,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.3";
+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.3",
+  "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.3");
+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"], {