@leg3ndy/otto-bridge 1.0.7 → 1.0.9

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 a release atual `1.0.7`, com hotfix do input-box TTY do console, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_7_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_7_PATCH.md).
+Para a release atual `1.0.9`, com composer multiline no console TTY e quebra de linha dentro da moldura, veja [`leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_9_PATCH.md`](../leg3ndy-ai-backend/docs/otto-bridge/releases/OTTO_BRIDGE_1_0_9_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.7.tgz
+npm install -g ./leg3ndy-otto-bridge-1.0.9.tgz
 ```
 
-Na linha `1.0.7`, `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.9`, `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.7` 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.9` 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.7` preserva esse fluxo e corrige o freeze do input-box TTY introduzido no refinamento visual do console.
+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.9` preserva esse fluxo, mantem o input-box TTY estavel, adiciona composer multiline e melhora as views de status/extensoes e o refresh ao sair do `Terminal`.
 
 ## Publicacao
 
@@ -157,7 +157,7 @@ Esse comando abre um shell local interativo para instalar extensoes, rodar coman
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.0.7`:
+Fluxo recomendado na linha `1.0.9`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -167,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.7`:
+Contrato da linha `1.0.9`:
 
 - `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.7
+## Handoff rapido da linha 1.0.9
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -1,9 +1,10 @@
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
 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 { defaultDeviceName, getBridgeConfigPath, loadBridgeConfig, normalizeInstalledExtensions, resolveApiBaseUrl, resolveExecutorConfig, } from "./config.js";
 import { streamDeviceCliChat, } from "./chat_cli_client.js";
 import { formatManagedBridgeExtensionStatus, isManagedBridgeExtensionSlug, loadManagedBridgeExtensionState, } from "./extensions.js";
 import { pairDevice } from "./pairing.js";
@@ -308,6 +309,47 @@ export function resolveCliModelMode(value) {
 function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+async function resolveInstalledBridgeVersion() {
+    try {
+        const raw = await readFile(new URL("../package.json", import.meta.url), "utf8");
+        const parsed = JSON.parse(raw);
+        return normalizeText(parsed.version) || BRIDGE_VERSION;
+    }
+    catch {
+        return BRIDGE_VERSION;
+    }
+}
+async function captureBridgeRuntimeSnapshot(config) {
+    const managedExtensionState = await Promise.all(normalizeInstalledExtensions(config?.installedExtensions || [])
+        .filter(isManagedBridgeExtensionSlug)
+        .sort((left, right) => left.localeCompare(right))
+        .map(async (slug) => {
+        const state = await loadManagedBridgeExtensionState(slug);
+        return {
+            slug,
+            status: normalizeText(state?.status),
+            lastSetupAt: normalizeText(state?.lastSetupAt),
+            notes: normalizeText(state?.notes),
+        };
+    }));
+    return {
+        bridgeVersion: await resolveInstalledBridgeVersion(),
+        configFingerprint: JSON.stringify(config || null),
+        extensionStateFingerprint: JSON.stringify(managedExtensionState),
+    };
+}
+export function diffBridgeRuntimeSnapshots(before, after) {
+    const versionChanged = before.bridgeVersion !== after.bridgeVersion;
+    const configChanged = before.configFingerprint !== after.configFingerprint;
+    const extensionStateChanged = before.extensionStateFingerprint !== after.extensionStateFingerprint;
+    return {
+        versionChanged,
+        configChanged,
+        extensionStateChanged,
+        requiresCliRestart: versionChanged,
+        requiresRuntimeRefresh: configChanged || extensionStateChanged,
+    };
+}
 async function createPromptInterface() {
     const rl = createInterface({
         input,
@@ -539,6 +581,72 @@ function buildBridgeReleaseCard(notice) {
         { text: `Rode: ${notice.updateCommand || "otto-bridge update"}`, tone: "primary" },
     ];
 }
+function buildStatusCard(config, runtimeSession) {
+    const releaseNotice = runtimeSession.getReleaseNotice();
+    return [
+        { text: "Bridge Status", tone: "title" },
+        { text: "", tone: "muted" },
+        { text: `device: ${config.deviceName}`, tone: "primary" },
+        { text: `device id: ${config.deviceId}`, tone: "primary" },
+        { text: `api: ${config.apiBaseUrl}`, tone: "primary" },
+        { text: `executor: ${config.executor.type}`, tone: "primary" },
+        { text: `approval: ${config.approvalMode}`, tone: "primary" },
+        { text: `runtime: ${runtimeSession.getStatusLabel()}`, tone: "primary" },
+        ...(runtimeSession.getStatusDetail()
+            ? [{ text: `runtime note: ${runtimeSession.getStatusDetail()}`, tone: "muted" }]
+            : []),
+        ...(releaseNotice
+            ? [
+                { text: "", tone: "muted" },
+                {
+                    text: `bridge update: ${releaseNotice.kind === "required" ? "required" : "available"}`,
+                    tone: releaseNotice.kind === "required" ? "warning" : "primary",
+                },
+                ...(releaseNotice.currentVersion
+                    ? [{ text: `current version: ${releaseNotice.currentVersion}`, tone: "primary" }]
+                    : []),
+                ...(releaseNotice.latestVersion
+                    ? [{ text: `latest version: ${releaseNotice.latestVersion}`, tone: "primary" }]
+                    : []),
+                ...(releaseNotice.minSupportedVersion
+                    ? [{ text: `min supported: ${releaseNotice.minSupportedVersion}`, tone: "primary" }]
+                    : []),
+                { text: `update command: ${releaseNotice.updateCommand || "otto-bridge update"}`, tone: "muted" },
+            ]
+            : []),
+        { text: "", tone: "muted" },
+        { text: `config: ${getBridgeConfigPath()}`, tone: "muted" },
+    ];
+}
+async function buildExtensionsCard(config) {
+    const lines = [
+        { text: "Extensões", tone: "title" },
+        { text: "", tone: "muted" },
+    ];
+    if (!config.installedExtensions.length) {
+        lines.push({ text: "Nenhuma extensão instalada neste bridge.", tone: "muted" });
+        return lines;
+    }
+    for (const extension of config.installedExtensions) {
+        if (!isManagedBridgeExtensionSlug(extension)) {
+            lines.push({ text: `• ${extension}`, tone: "primary" });
+            lines.push({ text: "Extensão local sem status gerenciado.", tone: "muted" });
+            lines.push({ text: "", tone: "muted" });
+            continue;
+        }
+        const state = await loadManagedBridgeExtensionState(extension);
+        const status = state ? formatManagedBridgeExtensionStatus(state.status) : "sem estado salvo";
+        lines.push({ text: `• ${extension}: ${status}`, tone: "primary" });
+        if (state?.notes) {
+            lines.push({ text: truncate(state.notes, 160), tone: "muted" });
+        }
+        lines.push({ text: "", tone: "muted" });
+    }
+    while (lines.length > 2 && !normalizeText(lines[lines.length - 1]?.text)) {
+        lines.pop();
+    }
+    return lines;
+}
 function printHubScreen(runtimeSession, modelMode) {
     clearScreen();
     console.log(renderBanner());
@@ -561,6 +669,8 @@ function printConsoleScreen(runtimeSession, modelMode) {
         console.log(renderInfoCard(buildBridgeReleaseCard(releaseNotice)));
     }
     console.log("");
+    printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
+    console.log("");
 }
 function renderPromptFrameLine(width, edgeLeft, edgeRight) {
     return style(`${edgeLeft}${"─".repeat(width)}${edgeRight}`, ANSI.brandBlue, supportsAnsi());
@@ -578,10 +688,130 @@ function renderConsolePromptContentLine(text, width, tone) {
         : style(clipped, ANSI.slateItalic, enabled);
     return `${border} ${body} ${border}`;
 }
+function sliceByWidth(text, width) {
+    if (width <= 0) {
+        return [""];
+    }
+    if (!text.length) {
+        return [""];
+    }
+    const parts = [];
+    let offset = 0;
+    while (offset < text.length) {
+        parts.push(text.slice(offset, offset + width));
+        offset += width;
+    }
+    return parts.length ? parts : [""];
+}
+export function buildConsoleComposerLayout(value, innerWidth) {
+    const promptWidth = 2;
+    const lineContentWidth = Math.max(1, innerWidth - promptWidth);
+    if (!value) {
+        return {
+            lines: [CONSOLE_PLACEHOLDER],
+            cursorLineIndex: 0,
+            cursorColumn: 0,
+        };
+    }
+    const logicalLines = value.split("\n");
+    const lastLogicalLine = logicalLines[logicalLines.length - 1] ?? "";
+    const lines = [];
+    for (const logicalLine of logicalLines) {
+        const wrapped = sliceByWidth(logicalLine, lineContentWidth);
+        lines.push(...wrapped);
+    }
+    const trailingNewline = value.endsWith("\n");
+    const needsSoftWrapCursorRow = !trailingNewline
+        && lastLogicalLine.length > 0
+        && lastLogicalLine.length % lineContentWidth === 0;
+    if (trailingNewline || needsSoftWrapCursorRow) {
+        lines.push("");
+    }
+    const cursorLineIndex = trailingNewline
+        ? lines.length - 1
+        : needsSoftWrapCursorRow
+            ? lines.length - 1
+            : Math.max(0, lines.length - 1);
+    const cursorColumn = trailingNewline
+        ? 0
+        : needsSoftWrapCursorRow
+            ? 0
+            : lastLogicalLine.length % lineContentWidth;
+    return {
+        lines,
+        cursorLineIndex,
+        cursorColumn,
+    };
+}
+function renderConsoleComposerLines(value, innerWidth, enabled) {
+    const layout = buildConsoleComposerLayout(value, innerWidth);
+    const lineContentWidth = Math.max(1, innerWidth - 2);
+    const promptStyled = style(">", `${ANSI.bold}${ANSI.white}`, enabled);
+    if (!value) {
+        const placeholder = truncate(CONSOLE_PLACEHOLDER, lineContentWidth);
+        return {
+            renderedLines: [
+                `${promptStyled} ${style(placeholder, ANSI.slate, enabled)}${" ".repeat(Math.max(0, lineContentWidth - placeholder.length))}`,
+            ],
+            cursorLineIndex: 0,
+            cursorColumn: 0,
+        };
+    }
+    return {
+        renderedLines: layout.lines.map((line, index) => {
+            const prefix = index === 0 ? `${promptStyled} ` : "  ";
+            return `${prefix}${line}${" ".repeat(Math.max(0, lineContentWidth - line.length))}`;
+        }),
+        cursorLineIndex: layout.cursorLineIndex,
+        cursorColumn: layout.cursorColumn,
+    };
+}
+function tryConsumeControlSequence(buffer) {
+    const knownNewlineSequences = [
+        "\u001b[13;2u",
+        "\u001b[27;2;13~",
+        "\u001b[1;2M",
+        "\u001b\r",
+        "\u001b\n",
+    ];
+    for (const sequence of knownNewlineSequences) {
+        if (buffer.startsWith(sequence)) {
+            return {
+                consumed: sequence.length,
+                action: "newline",
+            };
+        }
+    }
+    if (buffer === "\u001b" || /^\u001b\[[0-9;?]*$/.test(buffer)) {
+        return {
+            consumed: 0,
+            action: "incomplete",
+        };
+    }
+    const csiMatch = buffer.match(/^\u001b\[[0-9;?]*[ -/]*[@-~]/);
+    if (csiMatch) {
+        return {
+            consumed: csiMatch[0].length,
+            action: "ignore",
+        };
+    }
+    const ss3Match = buffer.match(/^\u001bO./);
+    if (ss3Match) {
+        return {
+            consumed: ss3Match[0].length,
+            action: "ignore",
+        };
+    }
+    if (buffer.startsWith("\u001b")) {
+        return {
+            consumed: 1,
+            action: "ignore",
+        };
+    }
+    return null;
+}
 async function askConsoleInput(rl) {
     if (!supportsAnsi() || typeof input.setRawMode !== "function" || !input.isTTY) {
-        printSoft(`Comandos: ${CONSOLE_COMMAND_HINT}`);
-        console.log("");
         return normalizeText(await question(rl, "> "));
     }
     rl.pause();
@@ -591,71 +821,90 @@ async function askConsoleInput(rl) {
         const enabled = supportsAnsi();
         const availableWidth = Number(output.columns || 96);
         const innerWidth = Math.max(42, Math.min(availableWidth - 8, 116));
-        const sectionTopOffsetFromInputLine = 3;
         let renderedOnce = false;
         let value = "";
+        let pendingControlBuffer = "";
+        let previousCursorRowsFromTop = 0;
         const cleanup = () => {
             input.removeListener("data", onData);
             input.setRawMode(false);
             input.pause();
             rl.resume();
         };
-        const renderInputContent = () => {
-            const promptPlain = "> ";
-            const promptStyled = style(">", `${ANSI.bold}${ANSI.white}`, enabled);
-            const maxValueLength = Math.max(0, innerWidth - promptPlain.length);
-            if (!value) {
-                const placeholder = truncate(CONSOLE_PLACEHOLDER, maxValueLength);
-                const padded = `${style(placeholder, ANSI.slate, enabled)}${" ".repeat(Math.max(0, maxValueLength - placeholder.length))}`;
-                return `${promptStyled} ${padded}`;
-            }
-            const visibleValue = value.length > maxValueLength
-                ? value.slice(value.length - maxValueLength)
-                : value;
-            return `${promptStyled} ${visibleValue}${" ".repeat(Math.max(0, maxValueLength - visibleValue.length))}`;
-        };
         const render = () => {
+            const composer = renderConsoleComposerLines(value, innerWidth, enabled);
             if (renderedOnce) {
                 cursorTo(output, 0);
-                moveCursor(output, 0, -sectionTopOffsetFromInputLine);
+                moveCursor(output, 0, -previousCursorRowsFromTop);
             }
             else {
                 renderedOnce = true;
             }
-            const commands = style(`Comandos: ${CONSOLE_COMMAND_HINT}`, ANSI.slateItalic, enabled);
             const top = renderPromptFrameLine(innerWidth + 2, "┌", "┐");
             const border = style("│", ANSI.brandBlue, enabled);
-            const middle = `${border} ${renderInputContent()} ${border}`;
             const bottom = renderPromptFrameLine(innerWidth + 2, "└", "┘");
+            const content = composer.renderedLines.map((line) => `${border} ${line} ${border}`).join("\n");
             output.write("\u001b[J");
-            output.write(`${commands}\n\n${top}\n${middle}\n${bottom}\n`);
+            output.write(`${top}\n${content}\n${bottom}\n`);
             cursorTo(output, 0);
-            moveCursor(output, 0, -2);
-            const visibleValueLength = Math.min(value.length, Math.max(0, innerWidth - 2));
-            cursorTo(output, 4 + visibleValueLength);
+            previousCursorRowsFromTop = 1 + composer.cursorLineIndex;
+            moveCursor(output, 0, -previousCursorRowsFromTop);
+            cursorTo(output, 4 + composer.cursorColumn);
+        };
+        const insertNewline = () => {
+            value = `${value}\n`;
+            render();
+        };
+        const submitPrompt = () => {
+            cleanup();
+            output.write("\n");
+            resolve(normalizeText(value));
         };
         const onData = (chunk) => {
-            const text = Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
-            for (const char of Array.from(text)) {
-                if (char === "\u0003") {
+            pendingControlBuffer += Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
+            while (pendingControlBuffer.length > 0) {
+                if (pendingControlBuffer.startsWith("\u0003")) {
                     cleanup();
                     reject(createCliExitError());
                     return;
                 }
-                if (char === "\r" || char === "\n") {
-                    cleanup();
-                    output.write("\n");
-                    resolve(normalizeText(value));
+                if (pendingControlBuffer.startsWith("\r")) {
+                    if (pendingControlBuffer.startsWith("\r\n")) {
+                        pendingControlBuffer = pendingControlBuffer.slice(2);
+                    }
+                    else {
+                        pendingControlBuffer = pendingControlBuffer.slice(1);
+                    }
+                    submitPrompt();
                     return;
                 }
-                if (char === "\u007f" || char === "\b") {
+                if (pendingControlBuffer.startsWith("\n")) {
+                    pendingControlBuffer = pendingControlBuffer.slice(1);
+                    insertNewline();
+                    continue;
+                }
+                if (pendingControlBuffer.startsWith("\u007f") || pendingControlBuffer.startsWith("\b")) {
+                    pendingControlBuffer = pendingControlBuffer.slice(1);
                     value = value.slice(0, -1);
                     render();
                     continue;
                 }
-                if (char === "\u001b") {
+                const controlSequence = tryConsumeControlSequence(pendingControlBuffer);
+                if (controlSequence) {
+                    if (controlSequence.action === "incomplete") {
+                        return;
+                    }
+                    pendingControlBuffer = pendingControlBuffer.slice(controlSequence.consumed);
+                    if (controlSequence.action === "newline") {
+                        insertNewline();
+                    }
                     continue;
                 }
+                const [char] = Array.from(pendingControlBuffer);
+                if (!char) {
+                    return;
+                }
+                pendingControlBuffer = pendingControlBuffer.slice(char.length);
                 value += char;
                 render();
             }
@@ -838,6 +1087,30 @@ export async function runTerminalShell(options) {
         });
     });
 }
+async function showRuntimeRefreshProgress(options) {
+    clearScreen();
+    console.log(renderBanner());
+    console.log("");
+    console.log(renderInfoCard([
+        { text: options.title, tone: "title" },
+        { text: "", tone: "muted" },
+        { text: options.detail, tone: "muted" },
+    ]));
+    console.log("");
+    const enabled = supportsAnsi();
+    const width = 28;
+    const steps = Math.max(8, options.steps || width);
+    const delayMs = Math.max(20, options.delayMs || 45);
+    for (let step = 0; step <= steps; step += 1) {
+        const filled = Math.round((step / steps) * width);
+        const empty = Math.max(0, width - filled);
+        const bar = `${"█".repeat(filled)}${"░".repeat(empty)}`;
+        const line = `[${bar}] ${Math.round((step / steps) * 100)}%`;
+        output.write(`\r${style(line, ANSI.brandBlue, enabled)}`);
+        await delay(delayMs);
+    }
+    output.write("\n\n");
+}
 function buildConversationSummary(summary, job) {
     const rendered = renderStructuredOutcome(job, { compact: true });
     if (!rendered) {
@@ -849,23 +1122,8 @@ function buildConversationSummary(summary, job) {
     return `${summary}\n${rendered}`.slice(0, 4_000).trim();
 }
 async function printExtensionsOverview(config) {
-    printSection("Extensions");
-    if (!config.installedExtensions.length) {
-        printMuted("Nenhuma extensão instalada neste bridge.");
-        return;
-    }
-    for (const extension of config.installedExtensions) {
-        if (!isManagedBridgeExtensionSlug(extension)) {
-            console.log(`- ${extension}`);
-            continue;
-        }
-        const state = await loadManagedBridgeExtensionState(extension);
-        const status = state ? formatManagedBridgeExtensionStatus(state.status) : "sem estado salvo";
-        console.log(`- ${extension}: ${status}`);
-        if (state?.notes) {
-            printMuted(`  ${truncate(state.notes, 140)}`);
-        }
-    }
+    printSection("Extensões");
+    console.log(renderInfoCard(await buildExtensionsCard(config)));
 }
 async function runSetupWizard(rl, options) {
     printSection(options?.postinstall ? "Setup Inicial" : "Pairing Setup");
@@ -960,6 +1218,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
         printSection("Console");
         printSoft("Comandos: /help, /model [fast|thinking], /status, /clear, /exit");
         printSoft("Bridge: otto-bridge terminal, otto-bridge extensions --install <name>, otto-bridge update");
+        printSoft("Composer: Enter envia; Shift+Enter quebra linha quando suportado; Ctrl+J tambem insere newline.");
     };
     const handlePrompt = async (promptText) => {
         const normalizedPrompt = normalizeText(promptText);
@@ -1111,7 +1370,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
 }
 async function printStatusView(rl, config, runtimeSession) {
     printSection("Bridge Status");
-    renderStatusOverview(config, runtimeSession).forEach((line) => console.log(line));
+    console.log(renderInfoCard(buildStatusCard(config, runtimeSession)));
     await pauseForEnter(rl);
 }
 async function printHelpView(rl) {
@@ -1152,7 +1411,7 @@ async function pickHomeChoice(rl, paired) {
             `${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("5.", ANSI.brandBlue, supportsAnsi())} Extensões`,
             `${style("6.", ANSI.brandBlue, supportsAnsi())} Ajuda`,
             `${style("7.", ANSI.brandBlue, supportsAnsi())} Sair`,
         ]
@@ -1190,6 +1449,7 @@ async function pickHomeChoice(rl, paired) {
 export async function launchInteractiveCli(options) {
     let rl = await createPromptInterface();
     let runtimeSession = null;
+    let restartRequested = false;
     try {
         let config = await loadBridgeConfig();
         if (!config) {
@@ -1203,7 +1463,7 @@ export async function launchInteractiveCli(options) {
                 await runOttoConsole(rl, config, runtimeSession);
             }
             if (!config) {
-                return;
+                return { restartRequested: false };
             }
         }
         runtimeSession = runtimeSession || new CliRuntimeSession(config);
@@ -1220,18 +1480,34 @@ export async function launchInteractiveCli(options) {
                 continue;
             }
             if (choice === "terminal") {
+                const snapshotBefore = await captureBridgeRuntimeSnapshot(config);
                 rl.close();
                 await runTerminalShell({ fromHub: true });
-                rl = await createPromptInterface();
                 const refreshedConfig = await loadBridgeConfig();
+                const snapshotAfter = await captureBridgeRuntimeSnapshot(refreshedConfig);
+                const runtimeDiff = diffBridgeRuntimeSnapshots(snapshotBefore, snapshotAfter);
+                rl = await createPromptInterface();
                 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)) {
+                if (runtimeDiff.requiresCliRestart) {
+                    config = refreshedConfig;
+                    restartRequested = true;
+                    await showRuntimeRefreshProgress({
+                        title: "Reiniciando Otto Bridge",
+                        detail: "Aguarde um minuto, o Otto Bridge está reiniciando para aplicar mudanças.",
+                    });
+                    break;
+                }
+                if (runtimeDiff.requiresRuntimeRefresh) {
                     config = refreshedConfig;
+                    await showRuntimeRefreshProgress({
+                        title: "Aplicando mudanças do runtime",
+                        detail: "Aguarde um instante, o Otto Bridge está atualizando o runtime local para aplicar mudanças.",
+                    });
                     if (runtimeSession) {
                         await runtimeSession.replaceConfig(refreshedConfig);
                         await runtimeSession.waitForReady();
@@ -1286,6 +1562,7 @@ export async function launchInteractiveCli(options) {
         await runtimeSession?.stop().catch(() => undefined);
         rl.close();
     }
+    return { restartRequested };
 }
 export async function runSetupCommand(options) {
     const rl = await createPromptInterface();

package/dist/main.js

@@ -140,6 +140,32 @@ Examples:
 function printVersion() {
     console.log(`${BRIDGE_PACKAGE_NAME} ${BRIDGE_VERSION}`);
 }
+async function restartCurrentCliProcess() {
+    const command = process.platform === "win32" ? "otto-bridge.cmd" : "otto-bridge";
+    const fallbackEntrypoint = process.argv[1];
+    const spawnRestart = (binary, args) => new Promise((resolve, reject) => {
+        const child = spawn(binary, args, {
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.once("spawn", () => {
+            resolve();
+        });
+        child.once("error", (error) => {
+            reject(error);
+        });
+    });
+    try {
+        await spawnRestart(command, []);
+        return;
+    }
+    catch {
+        if (!fallbackEntrypoint) {
+            throw new Error("Nao foi possivel relancar o Otto Bridge apos atualizar.");
+        }
+    }
+    await spawnRestart(process.execPath, [fallbackEntrypoint]);
+}
 function runChildCommand(command, args) {
     return new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -555,7 +581,9 @@ async function main() {
     const args = parseArgs(process.argv.slice(2));
     switch (args.command) {
         case "home":
-            await launchInteractiveCli();
+            if ((await launchInteractiveCli()).restartRequested) {
+                await restartCurrentCliProcess();
+            }
             return;
         case "setup":
             await runSetupCommand({
@@ -572,7 +600,9 @@ async function main() {
             await runPairCommand(args);
             return;
         case "run":
-            await launchInteractiveCli();
+            if ((await launchInteractiveCli()).restartRequested) {
+                await restartCurrentCliProcess();
+            }
             return;
         case "status":
             await runStatusCommand();

package/dist/types.js

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