@leg3ndy/otto-bridge 1.1.1 → 1.1.2

package/README.md

@@ -15,7 +15,7 @@ Para o estado atual da arquitetura, capacidades entregues, limitacoes e roadmap
 
 Para o corte de arquitetura do `0.9.0`, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_0_9_0_RELEASE.md).
 
-Para o patch atual `1.1.1`, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_1_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_1_PATCH.md). Para o corte funcional da linha `1.1.0`, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_0_RELEASE.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_0_RELEASE.md).
+Para o patch atual `1.1.2`, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_2_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_2_PATCH.md). Para o corte funcional da linha `1.1.0`, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_0_RELEASE.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_1_0_RELEASE.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.1.1.tgz
+npm install -g ./leg3ndy-otto-bridge-1.1.2.tgz
 ```
 
-Na linha `1.1.1`, `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.1.2`, `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.1.1` 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.1.2` 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.1.1` adiciona a camada workspace-first com rail de coding, trust/policy por workspace, source control first-class, working set persistido e grounding remoto por repositório.
+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.1.2` mantem a camada workspace-first com rail de coding, trust/policy por workspace, source control first-class, working set persistido e grounding remoto por repositório, enquanto estabiliza o `Otto Console` com header fixo, intro card sem `model:` e redraw limpo no resize.
 
 ## Publicacao
 
@@ -153,7 +153,7 @@ Dentro do console, use:
 - `/workspace use <id|n>` para fixar um workspace anexado na sessão atual
 - `/workspace clear` para limpar o binding atual do chat/sessão
 
-No TTY, o composer agora fica ancorado no rodapé com placeholder `Peça algo ao Otto`, quebra por largura real do terminal e deixa o transcript do Otto sempre visível acima. Logo abaixo do input, o console mostra o modelo ativo, a barra de uso de contexto/tokens e o modo de aprovação atual; `Shift+Tab` alterna esse modo sem sair do console.
+No TTY, o console agora usa buffer alternativo com header fixo no topo: banner, card azul com `cwd`/`bridge` e linha de comandos continuam visíveis enquanto o transcript cresce. O composer fica ancorado no rodapé com placeholder `Peça algo ao Otto`, quebra por largura real do terminal e mantém o transcript do Otto sempre acima sem duplicar a viewport no resize. O intro card não repete `model:`, o footer mostra o modelo ativo em cinza claro, e as mensagens renderizam o usuário com `>` e o assistente com bolinha azul, com espaçamento entre os blocos; `Shift+Tab` alterna o modo de aprovação sem sair do console.
 
 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.
 
@@ -169,7 +169,7 @@ Esse comando abre um shell local interativo para instalar extensoes, rodar coman
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.1.1`:
+Fluxo recomendado na linha `1.1.2`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -179,13 +179,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.1.1`:
+Contrato da linha `1.1.2`:
 
 - `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.1.1
+## Handoff rapido da linha 1.1.2
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -238,6 +238,9 @@ function renderBanner() {
         `${style(subtitle, ANSI.slate, enabled)}`,
     ].join("\n");
 }
+function getCardMaxContentWidth() {
+    return Math.max(24, Number(output.columns || 96) - 4);
+}
 function createCliExitError() {
     return new Error(CLI_EXIT_SENTINEL);
 }
@@ -425,16 +428,30 @@ function buildConsoleFooterStatusLine(width, modelMode, usageTokens, enabled) {
     const usageRatio = contextLimit > 0 ? usageTokens / contextLimit : 0;
     const percent = Math.round(Math.max(0, Math.min(usageRatio, 1)) * 100);
     const barWidth = Math.max(12, Math.min(28, Math.floor(width * 0.18)));
-    return `${getCliModelLabel(modelMode)} | ${buildConsoleUsageBar(barWidth, usageRatio, enabled)} ${percent}% | ${formatCompactTokenCount(usageTokens)} tokens`;
+    const modelLabel = style(getCliModelLabel(modelMode), ANSI.slate, enabled);
+    return `${modelLabel} | ${buildConsoleUsageBar(barWidth, usageRatio, enabled)} ${percent}% | ${formatCompactTokenCount(usageTokens)} tokens`;
 }
 function buildConsoleFooterApprovalLine(mode, enabled, statusSuffix) {
     const state = getConsoleApprovalFooterState(mode);
     const hint = statusSuffix || "Shift+Tab para alternar";
     return style(`${state.label} (${hint})`, state.tone === "warning" ? ANSI.red : state.tone === "primary" ? ANSI.amber : ANSI.slate, enabled);
 }
+function styleTranscriptPrefix(text, tone, enabled) {
+    if (!enabled || !text) {
+        return text;
+    }
+    if (tone === "assistant") {
+        return `${ANSI.bold}${ANSI.brandBlue}${text}${ANSI.reset}`;
+    }
+    if (tone === "user") {
+        return `${ANSI.bold}${ANSI.white}${text}${ANSI.reset}`;
+    }
+    return text;
+}
 class ConsoleScreenRenderer {
     modelMode;
     approvalMode;
+    headerFactory;
     transcript = [];
     onResize = () => {
         this.render();
@@ -444,15 +461,19 @@ class ConsoleScreenRenderer {
     draftValue = "";
     conversationMessages = [];
     approvalStatusSuffix = null;
-    constructor(modelMode, approvalMode) {
+    usingAlternateBuffer = false;
+    constructor(modelMode, approvalMode, headerFactory = () => []) {
         this.modelMode = modelMode;
         this.approvalMode = approvalMode;
+        this.headerFactory = headerFactory;
     }
     activate() {
         if (this.active || !supportsAnsi() || !input.isTTY || !output.isTTY) {
             return;
         }
         this.active = true;
+        output.write("\u001b[?1049h");
+        this.usingAlternateBuffer = true;
         output.on("resize", this.onResize);
         this.render();
     }
@@ -463,6 +484,10 @@ class ConsoleScreenRenderer {
         output.off("resize", this.onResize);
         this.active = false;
         output.write("\u001b[?25h");
+        if (this.usingAlternateBuffer) {
+            output.write("\u001b[?1049l");
+            this.usingAlternateBuffer = false;
+        }
     }
     isActive() {
         return this.active;
@@ -523,7 +548,8 @@ class ConsoleScreenRenderer {
             const wrapped = sliceByWidth(logicalLine, Math.max(1, width - currentPrefix.length));
             wrapped.forEach((segment, index) => {
                 const linePrefix = isFirstVisualLine && index === 0 ? prefix : continuationPrefix;
-                rendered.push(styleTranscriptLine(`${linePrefix}${segment}`, entry.tone, supportsAnsi()));
+                const prefixTone = isFirstVisualLine && index === 0 ? entry.prefixTone : undefined;
+                rendered.push(`${styleTranscriptPrefix(linePrefix, prefixTone, supportsAnsi())}${styleTranscriptLine(segment, entry.tone, supportsAnsi())}`);
             });
             if (logicalLine.length === 0 && wrapped.length === 0) {
                 rendered.push("");
@@ -539,6 +565,7 @@ class ConsoleScreenRenderer {
         const enabled = supportsAnsi();
         const width = Math.max(48, Number(output.columns || 96));
         const height = Math.max(12, Number(output.rows || 24));
+        const headerLines = this.headerFactory();
         const separator = style("─".repeat(width), ANSI.brandBlue, enabled);
         const composer = renderConsoleComposerLines(this.draftValue, width, enabled);
         const usageTokens = Math.min(estimateConsoleContextTokens(this.conversationMessages, this.draftValue), getCliModelContextWindowTokens(this.modelMode));
@@ -549,7 +576,8 @@ class ConsoleScreenRenderer {
             buildConsoleFooterStatusLine(width, this.modelMode, usageTokens, enabled),
             buildConsoleFooterApprovalLine(this.approvalMode, enabled, this.approvalStatusSuffix),
         ];
-        const transcriptHeight = Math.max(0, height - footerLines.length);
+        const visibleHeader = headerLines.slice(0, Math.max(0, height - footerLines.length));
+        const transcriptHeight = Math.max(0, height - visibleHeader.length - footerLines.length);
         const transcriptLines = this.transcript.flatMap((entry) => this.buildEntryLines(entry, width));
         const visibleTranscript = transcriptLines.slice(-transcriptHeight);
         const paddedTranscript = [
@@ -558,8 +586,8 @@ class ConsoleScreenRenderer {
         ];
         output.write("\u001b[?25l");
         output.write("\u001b[H\u001b[2J");
-        output.write([...paddedTranscript, ...footerLines].join("\n"));
-        cursorTo(output, Math.min(width - 1, CONSOLE_COMPOSER_CURSOR_COLUMN + composer.cursorColumn), transcriptHeight + 1 + composer.cursorLineIndex);
+        output.write([...visibleHeader, ...paddedTranscript, ...footerLines].join("\n"));
+        cursorTo(output, Math.min(width - 1, CONSOLE_COMPOSER_CURSOR_COLUMN + composer.cursorColumn), visibleHeader.length + transcriptHeight + 1 + composer.cursorLineIndex);
         output.write("\u001b[?25h");
     }
 }
@@ -797,13 +825,14 @@ function styleCardLine(line, tone, enabled) {
     }
     return `${ANSI.white}${line}${ANSI.reset}`;
 }
-function renderInfoCard(lines) {
+export function renderInfoCard(lines, maxContentWidth = 82) {
     const enabled = supportsAnsi();
+    const safeMaxContentWidth = Math.max(20, maxContentWidth);
     const normalized = lines.map((line) => ({
-        text: truncate(line.text, 82),
+        text: truncate(line.text, safeMaxContentWidth),
         tone: line.tone,
     }));
-    const width = Math.max(44, ...normalized.map((line) => line.text.length));
+    const width = Math.max(Math.min(44, safeMaxContentWidth), ...normalized.map((line) => line.text.length));
     const top = style(`┌${"─".repeat(width + 2)}┐`, ANSI.brandBlue, enabled);
     const bottom = style(`└${"─".repeat(width + 2)}┘`, ANSI.brandBlue, enabled);
     return [
@@ -816,17 +845,31 @@ function renderInfoCard(lines) {
         bottom,
     ].join("\n");
 }
-function buildWelcomeCard(runtimeSession, modelMode) {
+export function buildWelcomeCard(runtimeSession) {
     return [
         { text: "Welcome to OttoAI", tone: "title" },
         { text: "", tone: "muted" },
         { text: "/help inside the console, /status for bridge details", tone: "muted" },
         { text: "", tone: "muted" },
-        { text: `model: ${getCliModelLabel(modelMode)}`, tone: "muted" },
         { text: `cwd: ${process.cwd()}`, tone: "muted" },
         { text: renderRuntimeHeadline(runtimeSession), tone: "muted" },
     ];
 }
+function buildConsoleHeaderLines(runtimeSession) {
+    const lines = [
+        ...renderBanner().split("\n"),
+        "",
+        ...renderInfoCard(buildWelcomeCard(runtimeSession), getCardMaxContentWidth()).split("\n"),
+    ];
+    const releaseNotice = runtimeSession.getReleaseNotice();
+    if (releaseNotice) {
+        lines.push("");
+        lines.push(...renderInfoCard(buildBridgeReleaseCard(releaseNotice), getCardMaxContentWidth()).split("\n"));
+    }
+    lines.push("");
+    lines.push(style(`Comandos: ${CONSOLE_COMMAND_HINT}`, ANSI.slateItalic, supportsAnsi()));
+    return lines;
+}
 function buildBridgeReleaseCard(notice) {
     const isRequired = notice.kind === "required";
     return [
@@ -916,29 +959,20 @@ async function buildExtensionsCard(config) {
     }
     return lines;
 }
-function printHubScreen(runtimeSession, modelMode) {
+function printHubScreen(runtimeSession) {
     clearScreen();
     console.log(renderBanner());
     console.log("");
-    console.log(renderInfoCard(buildWelcomeCard(runtimeSession, modelMode)));
+    console.log(renderInfoCard(buildWelcomeCard(runtimeSession), getCardMaxContentWidth()));
     const releaseNotice = runtimeSession?.getReleaseNotice();
     if (releaseNotice) {
         console.log("");
-        console.log(renderInfoCard(buildBridgeReleaseCard(releaseNotice)));
+        console.log(renderInfoCard(buildBridgeReleaseCard(releaseNotice), getCardMaxContentWidth()));
     }
 }
-function printConsoleScreen(runtimeSession, modelMode) {
+function printConsoleScreen(runtimeSession) {
     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)));
-    }
-    console.log("");
-    printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
+    console.log(buildConsoleHeaderLines(runtimeSession).join("\n"));
     console.log("");
 }
 function formatConsoleWorkspaceLine(workspace, options) {
@@ -1652,11 +1686,11 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
     const sessionId = randomUUID();
     const conversation = [];
     const ui = supportsAnsi() && typeof input.setRawMode === "function" && input.isTTY && output.isTTY
-        ? new ConsoleScreenRenderer(activeModel, config.approvalMode)
+        ? new ConsoleScreenRenderer(activeModel, config.approvalMode, () => buildConsoleHeaderLines(runtimeSession))
         : null;
     ui?.activate();
     if (!ui) {
-        printConsoleScreen(runtimeSession, activeModel);
+        printConsoleScreen(runtimeSession);
     }
     const renderConversationState = () => {
         ui?.setConversationMessages(conversation);
@@ -1669,12 +1703,13 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
                 text,
                 tone,
                 prefix: options?.prefix,
+                prefixTone: options?.prefixTone,
                 continuationPrefix: options?.continuationPrefix,
             });
             return;
         }
         if (options?.prefix) {
-            console.log(`${options.prefix}${text}`);
+            console.log(`${styleTranscriptPrefix(options.prefix, options.prefixTone, supportsAnsi())}${styleTranscriptLine(text, tone, supportsAnsi())}`);
             return;
         }
         if (tone === "warning") {
@@ -1698,6 +1733,14 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
     const emitUserPrompt = (text) => {
         emitConsoleEntry(text, "user", {
             prefix: "> ",
+            prefixTone: "user",
+            continuationPrefix: "  ",
+        });
+    };
+    const emitAssistantPrompt = (text) => {
+        emitConsoleEntry(text, "assistant", {
+            prefix: "• ",
+            prefixTone: "assistant",
             continuationPrefix: "  ",
         });
     };
@@ -1886,7 +1929,12 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
                         : status === "failed"
                             ? "Execução local falhou."
                             : "Execução local cancelada.");
-                emitConsoleEntry(summary, status === "failed" ? "error" : status === "cancelled" ? "warning" : "assistant");
+                if (status === "completed") {
+                    emitAssistantPrompt(summary);
+                }
+                else {
+                    emitConsoleEntry(summary, status === "failed" ? "error" : "warning");
+                }
                 const rendered = renderStructuredOutcome(job);
                 if (rendered) {
                     emitConsoleEntry(rendered, "muted");
@@ -1910,7 +1958,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             ui?.clearTranscript();
             renderConversationState();
             if (!ui) {
-                printConsoleScreen(runtimeSession, activeModel);
+                printConsoleScreen(runtimeSession);
             }
             emitConsoleEntry("Contexto local do console limpo.", "muted");
             return;
@@ -1978,6 +2026,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             throw createCliExitError();
         }
         emitUserPrompt(normalizedPrompt);
+        emitConsoleEntry("", "muted");
         conversation.push({ role: "user", content: normalizedPrompt });
         while (conversation.length > 18) {
             conversation.shift();
@@ -2041,8 +2090,17 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             }
             if (!assistantPrefixPrinted) {
                 assistantEntryId = ui
-                    ? ui.pushEntry({ text: "", tone: "assistant" })
+                    ? ui.pushEntry({
+                        text: "",
+                        tone: "assistant",
+                        prefix: "• ",
+                        prefixTone: "assistant",
+                        continuationPrefix: "  ",
+                    })
                     : null;
+                if (!ui) {
+                    output.write(styleTranscriptPrefix("• ", "assistant", supportsAnsi()));
+                }
                 assistantPrefixPrinted = true;
             }
             if (ui && assistantEntryId) {
@@ -2065,7 +2123,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
                 : null;
             const jobId = normalizeText(job?.id);
             if (bridgeSummary && !jobId) {
-                emitConsoleEntry(bridgeSummary, "assistant");
+                emitAssistantPrompt(bridgeSummary);
             }
             if (jobId) {
                 finalAssistantSummary = await followConsoleJobUi(jobId);
@@ -2188,7 +2246,7 @@ export async function launchInteractiveCli(options) {
     try {
         let config = await loadBridgeConfig();
         if (!config) {
-            printHubScreen(null, "fast");
+            printHubScreen(null);
             const setup = await runSetupWizard(rl, options);
             config = setup.config;
             if (config && setup.openConsole) {
@@ -2205,7 +2263,7 @@ export async function launchInteractiveCli(options) {
         await runtimeSession.ensureStarted();
         await runtimeSession.waitForReady();
         for (;;) {
-            printHubScreen(runtimeSession, "fast");
+            printHubScreen(runtimeSession);
             const choice = await pickHomeChoice(rl, true);
             if (choice === "exit") {
                 break;
@@ -2303,7 +2361,7 @@ export async function runSetupCommand(options) {
     const rl = await createPromptInterface();
     let runtimeSession = null;
     try {
-        printHubScreen(null, "fast");
+        printHubScreen(null);
         const setup = await runSetupWizard(rl, options);
         if (setup.config && setup.openConsole) {
             runtimeSession = new CliRuntimeSession(setup.config);
@@ -2326,7 +2384,7 @@ export async function runConsoleCommand(initialPrompt) {
     const rl = await createPromptInterface();
     let runtimeSession = null;
     try {
-        printHubScreen(null, "fast");
+        printHubScreen(null);
         let config = await loadBridgeConfig();
         if (!config) {
             const setup = await runSetupWizard(rl);

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "1.1.1";
+export const BRIDGE_VERSION = "1.1.2";
 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.1.1",
+  "version": "1.1.2",
   "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.1.1");
+console.log("\n[otto-bridge] Welcome to OTTOAI 1.1.2");
 console.log("[otto-bridge] Vamos iniciar o setup interativo do bridge.\n");
 
 const result = spawnSync(process.execPath, [mainPath, "setup", "--postinstall"], {