@leg3ndy/otto-bridge 1.0.3 → 1.0.4

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_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/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.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).
 
 ## 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.4.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.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.
 
-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.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 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.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.
 
 ## Publicacao
 
@@ -143,11 +143,13 @@ 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.
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.0.3`:
+Fluxo recomendado na linha `1.0.4`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -157,13 +159,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.4`:
 
 - `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.4
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 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";
@@ -119,6 +120,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 +187,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,13 +475,13 @@ 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)));
@@ -474,11 +494,28 @@ function renderPromptFrameLine(width, edgeLeft, edgeRight) {
     return style(`${edgeLeft}${"─".repeat(width)}${edgeRight}`, ANSI.brandBlue, supportsAnsi());
 }
 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()) {
+        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;
 }
 function printAssistantMessage(message) {
@@ -492,9 +529,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,6 +642,7 @@ function printStructuredOutcome(job) {
     if (!rendered) {
         return;
     }
+    console.log("");
     console.log(rendered);
 }
 function buildConversationSummary(summary, job) {
@@ -748,6 +819,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 +844,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 +877,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 +898,6 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             }
         }
     };
-    printConsoleHelp();
     if (options?.initialPrompt) {
         await handlePrompt(options.initialPrompt);
     }
@@ -830,7 +917,24 @@ 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 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: "Dentro do console: /help, /model fast|thinking, /status, /clear, /exit", tone: "muted" },
+    ]));
     await pauseForEnter(rl);
 }
 async function pickHomeChoice(rl, paired) {
@@ -842,15 +946,21 @@ async function pickHomeChoice(rl, paired) {
             `${style("3.", ANSI.brandBlue, supportsAnsi())} Status detalhado`,
             `${style("4.", ANSI.brandBlue, supportsAnsi())} Extensões instaladas`,
             `${style("5.", ANSI.brandBlue, supportsAnsi())} Sair`,
+            `${style("6.", ANSI.brandBlue, supportsAnsi())} Ajuda`,
         ]
         : [
             `${style("1.", ANSI.brandBlue, supportsAnsi())} Pairing setup`,
             `${style("2.", ANSI.brandBlue, supportsAnsi())} Sair`,
+            `${style("3.", ANSI.brandBlue, supportsAnsi())} Ajuda`,
         ];
     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 === "3")
+            return "help";
+        return "exit";
     }
     if (answer === "1")
         return "console";
@@ -860,6 +970,8 @@ async function pickHomeChoice(rl, paired) {
         return "status";
     if (answer === "4")
         return "extensions";
+    if (answer === "6")
+        return "help";
     return "exit";
 }
 export async function launchInteractiveCli(options) {
@@ -874,6 +986,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 +995,29 @@ 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 === "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 +1058,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 +1087,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

@@ -104,28 +104,31 @@ 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 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 extensions --install <name>
   otto-bridge extensions --setup <name>
-  otto-bridge extensions --status <name>
-  otto-bridge extensions --list
-  otto-bridge version
   otto-bridge update --dry-run
   otto-bridge --version`);
 }

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.4";
 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.4",
   "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.3");
+console.log("\n[otto-bridge] Welcome to OTTOAI 1.0.4");
 console.log("[otto-bridge] Vamos iniciar o setup interativo do bridge.\n");
 
 const result = spawnSync(process.execPath, [mainPath, "setup", "--postinstall"], {