@leg3ndy/otto-bridge 1.0.1 → 1.0.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_0_9_0_RELEASE.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_0_9_0_RELEASE.md).
 
-Para a release atual `1.0.1`, com runtime agentico formal, hub terminal e console alinhado ao Otto da web, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_1_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_1_PATCH.md).
+Para a release atual `1.0.2`, com runtime agentico formal, hub terminal refinado e console alinhado ao Otto da web, veja [`leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_2_PATCH.md`](../leg3ndy-ai-backend/docs/OTTO_BRIDGE_1_0_2_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.1.tgz
+npm install -g ./leg3ndy-otto-bridge-1.0.2.tgz
 ```
 
-Na linha `1.0.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.0.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.0.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.0.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.0.1` consolida o hub terminal como fluxo principal e alinha o console ao comportamento normal do Otto antes de fazer handoff local.
+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.2` consolida o hub terminal como fluxo principal, esconde aliases legados da superfície pública e alinha o console ao comportamento normal do Otto antes de fazer handoff local.
 
 ## Publicacao
 
@@ -80,7 +80,6 @@ otto-bridge --help
 
 ```bash
 otto-bridge
-otto-bridge home
 ```
 
 Em TTY, o comando sem argumentos agora abre o hub interativo com banner, setup, status, extensoes e o `Otto Console`. Se ja existir pairing salvo, o próprio `otto-bridge` sobe o runtime local automaticamente e mostra o estado da conexão no hub.
@@ -116,7 +115,7 @@ No macOS, o caminho recomendado agora e o executor nativo do Otto Bridge. Se nen
 otto-bridge
 ```
 
-Esse agora e o fluxo principal do produto: o hub abre, conecta o runtime local e deixa o Otto pronto para handoff e approvals sem depender de um `run` separado.
+Esse agora e o fluxo principal do produto: o hub abre, conecta o runtime local e deixa o Otto pronto para handoff e approvals sem depender de nenhum comando separado de runtime.
 
 Se precisar do executor nativo no macOS sem reparar, atualize o pairing/config e reabra o hub:
 
@@ -124,8 +123,6 @@ Se precisar do executor nativo no macOS sem reparar, atualize o pairing/config e
 otto-bridge setup
 ```
 
-`otto-bridge run` continua existindo apenas como alias legado/headless para compatibilidade operacional.
-
 O adapter `clawd-cursor` continua disponivel como override opcional no pairing legado:
 
 ```bash
@@ -142,7 +139,7 @@ O console usa a mesma sessão local já ligada pelo `otto-bridge`, envia prompts
 
 ### WhatsApp Web em background
 
-Fluxo recomendado na linha `1.0.1`:
+Fluxo recomendado na linha `1.0.2`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -152,13 +149,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.1`:
+Contrato da linha `1.0.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.0.1
+## Handoff rapido da linha 1.0.2
 
 Ja fechado no codigo:
 

package/dist/cli_terminal.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { createInterface } from "node:readline/promises";
-import { stdin as input, stdout as output } from "node:process";
+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";
 import { formatManagedBridgeExtensionStatus, isManagedBridgeExtensionSlug, loadManagedBridgeExtensionState, } from "./extensions.js";
@@ -28,6 +28,7 @@ const OTTOAI_BANNER = [
     "╚██████╔╝   ██║      ██║   ╚██████╔╝    ██║  ██║██║",
     " ╚═════╝    ╚═╝      ╚═╝    ╚═════╝     ╚═╝  ╚═╝╚═╝",
 ];
+const CLI_EXIT_SENTINEL = "__OTTO_BRIDGE_CLI_EXIT__";
 class CliRuntimeSession {
     config;
     runtime = null;
@@ -158,7 +159,7 @@ function renderBanner() {
     const enabled = supportsAnsi();
     const lines = OTTOAI_BANNER.map((line) => style(line, ANSI.coral, enabled));
     const title = `${BRIDGE_PACKAGE_NAME} v${BRIDGE_VERSION}`;
-    const subtitle = "Terminal bridge, pairing wizard and local Otto console";
+    const subtitle = "Paired local runtime and terminal console";
     return [
         lines.join("\n"),
         "",
@@ -166,6 +167,19 @@ function renderBanner() {
         `${style(subtitle, ANSI.dim, enabled)}`,
     ].join("\n");
 }
+function createCliExitError() {
+    return new Error(CLI_EXIT_SENTINEL);
+}
+function isCliExitError(error) {
+    return error instanceof Error && error.message === CLI_EXIT_SENTINEL;
+}
+function isReadlineClosedError(error) {
+    const detail = error instanceof Error ? error.message : String(error || "");
+    const normalized = detail.toLowerCase();
+    return normalized.includes("readline was closed")
+        || normalized.includes("canceled")
+        || normalized.includes("aborted");
+}
 function printSection(title) {
     const enabled = supportsAnsi();
     console.log(`\n${style(title, ANSI.blue, enabled)}`);
@@ -196,16 +210,31 @@ function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 async function createPromptInterface() {
-    return createInterface({
+    const rl = createInterface({
         input,
         output,
         terminal: true,
     });
+    rl.on("SIGINT", () => {
+        rl.close();
+    });
+    return rl;
+}
+async function question(rl, prompt) {
+    try {
+        return await rl.question(prompt);
+    }
+    catch (error) {
+        if (isReadlineClosedError(error)) {
+            throw createCliExitError();
+        }
+        throw error;
+    }
 }
 async function ask(rl, label, options) {
     const defaultValue = normalizeText(options?.defaultValue);
     const suffix = defaultValue ? ` ${style(`[${defaultValue}]`, ANSI.dim, supportsAnsi())}` : "";
-    const answer = normalizeText(await rl.question(`${style("›", ANSI.coral, supportsAnsi())} ${label}${suffix}: `));
+    const answer = normalizeText(await question(rl, `${style("›", ANSI.coral, supportsAnsi())} ${label}${suffix}: `));
     if (answer) {
         return answer;
     }
@@ -217,15 +246,15 @@ async function ask(rl, label, options) {
     }
     return await ask(rl, label, options);
 }
-async function askYesNo(rl, question, defaultValue = true) {
-    const answer = normalizeText(await rl.question(`${style("?", ANSI.blue, supportsAnsi())} ${question} ${style(defaultValue ? "[Y/n]" : "[y/N]", ANSI.dim, supportsAnsi())}: `)).toLowerCase();
+async function askYesNo(rl, promptText, defaultValue = true) {
+    const answer = normalizeText(await question(rl, `${style("?", ANSI.blue, supportsAnsi())} ${promptText} ${style(defaultValue ? "[Y/n]" : "[y/N]", ANSI.dim, supportsAnsi())}: `)).toLowerCase();
     if (!answer) {
         return defaultValue;
     }
     return ["y", "yes", "s", "sim"].includes(answer);
 }
 async function pauseForEnter(rl, message = "Pressione Enter para continuar") {
-    await rl.question(`${style("↵", ANSI.dim, supportsAnsi())} ${message}`);
+    await question(rl, `${style("↵", ANSI.dim, supportsAnsi())} ${message}`);
 }
 async function chooseExecutor(rl, current) {
     const defaultType = current?.type || resolveExecutorConfig().type;
@@ -305,6 +334,72 @@ function renderStatusOverview(config, runtimeSession) {
         `${style("Config", ANSI.blue, supportsAnsi())}: ${getBridgeConfigPath()}`,
     ];
 }
+function renderRuntimeHeadline(runtimeSession) {
+    if (!runtimeSession) {
+        return "bridge: aguardando pairing inicial";
+    }
+    const status = runtimeSession.getStatusLabel();
+    if (status === "online") {
+        return "bridge: pareado e pronto para uso local";
+    }
+    if (status === "starting") {
+        return "bridge: conectando o runtime local";
+    }
+    if (status === "reconnecting") {
+        return "bridge: reconectando com o backend";
+    }
+    if (status === "error") {
+        return "bridge: com problema de conexao, veja /status";
+    }
+    return "bridge: offline";
+}
+function padRight(text, width) {
+    return text.length >= width ? text : `${text}${" ".repeat(width - text.length)}`;
+}
+function renderInfoCard(lines) {
+    const normalized = lines.map((line) => truncate(line, 78));
+    const width = Math.max(38, ...normalized.map((line) => line.length));
+    return [
+        `+${"-".repeat(width + 2)}+`,
+        ...normalized.map((line) => `| ${padRight(line, width)} |`),
+        `+${"-".repeat(width + 2)}+`,
+    ].join("\n");
+}
+function printHubScreen(runtimeSession) {
+    console.clear();
+    console.log(renderBanner());
+    console.log("");
+    console.log(renderInfoCard([
+        "Welcome to OttoAI",
+        "/status for bridge details, /help inside the console",
+        "model: OttoAI local console",
+        `cwd: ${process.cwd()}`,
+        renderRuntimeHeadline(runtimeSession),
+    ]));
+}
+function printConsoleScreen(runtimeSession) {
+    console.clear();
+    console.log(renderBanner());
+    console.log("");
+    console.log(renderInfoCard([
+        "Welcome to OttoAI",
+        "/help for commands, /status for bridge details",
+        "model: OttoAI local console",
+        `cwd: ${process.cwd()}`,
+        renderRuntimeHeadline(runtimeSession),
+    ]));
+    console.log("");
+}
+async function askConsoleInput(rl) {
+    return normalizeText(await question(rl, `${style(">", ANSI.white, supportsAnsi())} `));
+}
+function printAssistantMessage(message) {
+    const text = normalizeText(message);
+    if (!text) {
+        return;
+    }
+    console.log(`${style("•", ANSI.coral, supportsAnsi())} ${text}`);
+}
 async function printExtensionsOverview(config) {
     printSection("Extensions");
     if (!config.installedExtensions.length) {
@@ -371,7 +466,7 @@ async function followConsoleJob(rl, config, jobId) {
         const stepId = extractJobStepId(job);
         if (status !== lastStatus || stepId !== lastStepId) {
             const statusLabel = `${status}${stepId ? ` · ${stepId}` : ""}`;
-            console.log(`${style("runtime", ANSI.teal, supportsAnsi())} ${statusLabel}`);
+            printMuted(`local: ${statusLabel}`);
             lastStatus = status;
             lastStepId = stepId;
         }
@@ -401,16 +496,15 @@ async function followConsoleJob(rl, config, jobId) {
                     : status === "failed"
                         ? "Execução local falhou."
                         : "Execução local cancelada.");
-            console.log(`${style("otto", ANSI.coral, supportsAnsi())} ${summary}`);
+            printAssistantMessage(summary);
             return summary;
         }
         await delay(1400);
     }
 }
 async function runOttoConsole(rl, config, runtimeSession, options) {
-    printSection("Otto Console");
-    printMuted("Este console usa o mesmo runtime local já ligado pelo `otto-bridge`.");
-    printMuted(`Runtime: ${runtimeSession.getStatusLabel()} · ${runtimeSession.getStatusDetail()}`);
+    printConsoleScreen(runtimeSession);
+    printMuted("Digite sua mensagem normalmente. O handoff local só acontece quando fizer sentido.");
     const sessionId = randomUUID();
     const conversation = [];
     const printConsoleHelp = () => {
@@ -427,6 +521,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
         }
         if (normalizedPrompt === "/clear") {
             conversation.splice(0, conversation.length);
+            printConsoleScreen(runtimeSession);
             printMuted("Contexto local do console limpo.");
             return;
         }
@@ -439,13 +534,12 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             return;
         }
         if (normalizedPrompt === "/exit") {
-            throw new Error("__OTTO_CONSOLE_EXIT__");
+            throw createCliExitError();
         }
         conversation.push({ role: "user", content: normalizedPrompt });
         while (conversation.length > 18) {
             conversation.shift();
         }
-        console.log(`${style("você", ANSI.white, supportsAnsi())} ${normalizedPrompt}`);
         let streamedAssistant = "";
         let assistantPrefixPrinted = false;
         let handoffPayload = null;
@@ -475,7 +569,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
                 return;
             }
             if (!assistantPrefixPrinted) {
-                output.write(`${style("otto", ANSI.coral, supportsAnsi())} `);
+                output.write(`${style("•", ANSI.coral, supportsAnsi())} `);
                 assistantPrefixPrinted = true;
             }
             output.write(contentChunk);
@@ -489,7 +583,7 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
             const handoffData = handoffPayload;
             const bridgeSummary = extractBridgeHandoffSummary(handoffData);
             if (bridgeSummary) {
-                console.log(`${style("otto", ANSI.coral, supportsAnsi())} ${bridgeSummary}`);
+                printAssistantMessage(bridgeSummary);
             }
             const job = handoffData.job && typeof handoffData.job === "object"
                 ? handoffData.job
@@ -514,12 +608,12 @@ async function runOttoConsole(rl, config, runtimeSession, options) {
         await handlePrompt(options.initialPrompt);
     }
     for (;;) {
-        const promptText = await ask(rl, "OTTO", { allowEmpty: true });
+        const promptText = await askConsoleInput(rl);
         try {
             await handlePrompt(promptText);
         }
         catch (error) {
-            if (error instanceof Error && error.message === "__OTTO_CONSOLE_EXIT__") {
+            if (isCliExitError(error)) {
                 break;
             }
             throw error;
@@ -537,8 +631,8 @@ async function pickHomeChoice(rl, paired) {
     const options = paired
         ? [
             `${style("1.", ANSI.coral, supportsAnsi())} Otto Console`,
-            `${style("2.", ANSI.coral, supportsAnsi())} Re-pair / setup`,
-            `${style("3.", ANSI.coral, supportsAnsi())} Status do bridge`,
+            `${style("2.", ANSI.coral, supportsAnsi())} Setup / parear novamente`,
+            `${style("3.", ANSI.coral, supportsAnsi())} Status detalhado`,
             `${style("4.", ANSI.coral, supportsAnsi())} Extensões instaladas`,
             `${style("5.", ANSI.coral, supportsAnsi())} Sair`,
         ]
@@ -565,10 +659,9 @@ export async function launchInteractiveCli(options) {
     const rl = await createPromptInterface();
     let runtimeSession = null;
     try {
-        console.clear();
-        console.log(renderBanner());
         let config = await loadBridgeConfig();
         if (!config) {
+            printHubScreen(null);
             const setup = await runSetupWizard(rl, options);
             config = setup.config;
             if (config && setup.openConsole) {
@@ -583,8 +676,7 @@ export async function launchInteractiveCli(options) {
         runtimeSession = runtimeSession || new CliRuntimeSession(config);
         await runtimeSession.ensureStarted();
         for (;;) {
-            console.log("");
-            renderStatusOverview(config, runtimeSession).forEach((line) => console.log(line));
+            printHubScreen(runtimeSession);
             const choice = await pickHomeChoice(rl, true);
             if (choice === "exit") {
                 break;
@@ -620,6 +712,11 @@ export async function launchInteractiveCli(options) {
             }
         }
     }
+    catch (error) {
+        if (!isCliExitError(error)) {
+            throw error;
+        }
+    }
     finally {
         await runtimeSession?.stop().catch(() => undefined);
         rl.close();
@@ -629,8 +726,7 @@ export async function runSetupCommand(options) {
     const rl = await createPromptInterface();
     let runtimeSession = null;
     try {
-        console.clear();
-        console.log(renderBanner());
+        printHubScreen(null);
         const setup = await runSetupWizard(rl, options);
         if (setup.config && setup.openConsole) {
             runtimeSession = new CliRuntimeSession(setup.config);
@@ -638,6 +734,11 @@ export async function runSetupCommand(options) {
             await runOttoConsole(rl, setup.config, runtimeSession);
         }
     }
+    catch (error) {
+        if (!isCliExitError(error)) {
+            throw error;
+        }
+    }
     finally {
         await runtimeSession?.stop().catch(() => undefined);
         rl.close();
@@ -647,8 +748,7 @@ export async function runConsoleCommand(initialPrompt) {
     const rl = await createPromptInterface();
     let runtimeSession = null;
     try {
-        console.clear();
-        console.log(renderBanner());
+        printHubScreen(null);
         let config = await loadBridgeConfig();
         if (!config) {
             const setup = await runSetupWizard(rl);
@@ -661,6 +761,11 @@ export async function runConsoleCommand(initialPrompt) {
         await runtimeSession.ensureStarted();
         await runOttoConsole(rl, config, runtimeSession, { initialPrompt });
     }
+    catch (error) {
+        if (!isCliExitError(error)) {
+            throw error;
+        }
+    }
     finally {
         await runtimeSession?.stop().catch(() => undefined);
         rl.close();

package/dist/executors/native_macos.js

@@ -4563,7 +4563,7 @@ return {
                 qrStabilityWindowMs: WHATSAPP_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS,
             });
             if (state.connected) {
-                await this.syncWhatsAppExtensionState("connected", "Sessao local do WhatsApp Web mantida em background enquanto `otto-bridge run` estiver ativo.", { runtimeAttached: true });
+                await this.syncWhatsAppExtensionState("connected", "Sessao local do WhatsApp Web mantida em background enquanto `otto-bridge` estiver ativo.", { runtimeAttached: true });
                 return;
             }
             await this.syncWhatsAppExtensionState("session_expired", state.qrVisible

package/dist/main.js

@@ -4,7 +4,6 @@ import process from "node:process";
 import { clearBridgeConfig, getBridgeConfigPath, loadBridgeConfig, normalizeInstalledExtensions, resolveApiBaseUrl, resolveExecutorConfig, saveBridgeConfig, } from "./config.js";
 import { buildInstalledManagedExtensionState, formatManagedBridgeExtensionStatus, getManagedBridgeExtensionDefinition, isManagedBridgeExtensionSlug, loadManagedBridgeExtensionState, removeManagedBridgeExtensionState, saveManagedBridgeExtensionState, } from "./extensions.js";
 import { pairDevice } from "./pairing.js";
-import { BridgeRuntime } from "./runtime.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";
@@ -13,8 +12,8 @@ const UPDATE_RETRY_DELAYS_MS = [0, 8_000, 20_000];
 function parseArgs(argv) {
     const [maybeCommand, ...rest] = argv;
     if (!maybeCommand) {
-        const interactiveDefault = process.stdout.isTTY && process.stdin.isTTY && process.env.OTTO_BRIDGE_LEGACY_DEFAULT_RUN !== "1";
-        return { command: interactiveDefault ? "home" : "run", options: new Map() };
+        const interactiveDefault = process.stdout.isTTY && process.stdin.isTTY;
+        return { command: interactiveDefault ? "home" : "help", options: new Map() };
     }
     if (maybeCommand === "--help" || maybeCommand === "-h") {
         return { command: "help", options: new Map() };
@@ -106,16 +105,14 @@ function resolveExecutorOverrides(args, current) {
 function printUsage() {
     console.log(`Usage:
   otto-bridge
-  otto-bridge home
   otto-bridge setup
   otto-bridge console
-  otto-bridge pair --api http://localhost:8000 --code ABC123 [--name "Meu PC"] [--executor native-macos|mock|clawd-cursor]
   otto-bridge status
   otto-bridge extensions --list
-  otto-bridge extensions --install github
-  otto-bridge extensions --setup whatsappweb
-  otto-bridge extensions --status whatsappweb
-  otto-bridge extensions --uninstall github
+  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
@@ -124,13 +121,11 @@ Examples:
   otto-bridge
   otto-bridge setup
   otto-bridge console
-  otto-bridge pair --api https://api.leg3ndy.com.br --code ABC123
-  otto-bridge extensions --install whatsappweb
-  otto-bridge extensions --setup whatsappweb
-  otto-bridge extensions --status whatsappweb
+  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 --version`);
 }
@@ -249,7 +244,7 @@ async function detectManagedExtensionStatus(slug, currentState) {
         if (hasFreshRuntimeAttachment(currentState)) {
             return {
                 status: "connected",
-                notes: currentState?.notes || "Sessao local do WhatsApp Web mantida em background enquanto `otto-bridge run` estiver ativo.",
+                notes: currentState?.notes || "Sessao local do WhatsApp Web mantida em background enquanto `otto-bridge` estiver ativo.",
             };
         }
         const detected = await detectManagedWhatsAppWebStatus();
@@ -290,44 +285,10 @@ async function runPairCommand(args) {
 async function loadRequiredBridgeConfig() {
     const config = await loadBridgeConfig();
     if (!config) {
-        throw new Error("No local pairing found. Run `otto-bridge pair --code <CODE>` first.");
+        throw new Error("Nenhum pairing local encontrado. Rode `otto-bridge` ou `otto-bridge setup` primeiro.");
     }
     return config;
 }
-async function runRuntimeCommand(args) {
-    console.log("[otto-bridge] `run` agora é um alias legado. Prefira `otto-bridge`.");
-    const config = await loadRequiredBridgeConfig();
-    const runtimeConfig = {
-        ...config,
-        executor: resolveExecutorOverrides(args, config.executor),
-    };
-    const runtime = new BridgeRuntime(runtimeConfig);
-    let stopping = false;
-    const shutdown = async (signal) => {
-        if (stopping) {
-            return;
-        }
-        stopping = true;
-        console.log(`[otto-bridge] shutting down runtime after ${signal}`);
-        await runtime.stop().catch(() => undefined);
-    };
-    const handleSigint = () => {
-        void shutdown("SIGINT");
-    };
-    const handleSigterm = () => {
-        void shutdown("SIGTERM");
-    };
-    process.once("SIGINT", handleSigint);
-    process.once("SIGTERM", handleSigterm);
-    try {
-        await runtime.start();
-    }
-    finally {
-        process.off("SIGINT", handleSigint);
-        process.off("SIGTERM", handleSigterm);
-        await runtime.stop().catch(() => undefined);
-    }
-}
 async function runStatusCommand() {
     const config = await loadBridgeConfig();
     if (!config) {
@@ -395,7 +356,7 @@ async function runExtensionsCommand(args) {
             }
             console.log(`[otto-bridge] proximo passo para ${extension}: otto-bridge extensions --setup ${extension}`);
         }
-        console.log("[otto-bridge] rode `otto-bridge run` novamente se quiser sincronizar agora com a web");
+        console.log("[otto-bridge] reabra `otto-bridge` se quiser sincronizar agora com a web");
         return;
     }
     if (setupValue) {
@@ -488,7 +449,7 @@ async function runExtensionsCommand(args) {
             }
         }
         console.log(`[otto-bridge] extensoes removidas: ${removed.join(", ")}`);
-        console.log("[otto-bridge] rode `otto-bridge run` novamente se quiser sincronizar agora com a web");
+        console.log("[otto-bridge] reabra `otto-bridge` se quiser sincronizar agora com a web");
         return;
     }
     if (!config.installedExtensions.length) {
@@ -600,7 +561,7 @@ async function main() {
             await runPairCommand(args);
             return;
         case "run":
-            await runRuntimeCommand(args);
+            await launchInteractiveCli();
             return;
         case "status":
             await runStatusCommand();

package/dist/runtime.js

@@ -84,6 +84,8 @@ export class BridgeRuntime {
     localAutomationRuntime;
     lastBridgeReleaseNoticeKey = null;
     activeSocket = null;
+    reconnectTimer = null;
+    reconnectWaitResolver = null;
     stopped = false;
     started = false;
     pendingConfirmations = new Map();
@@ -206,12 +208,21 @@ export class BridgeRuntime {
             }
             this.logInfo(`[otto-bridge] reconnecting in ${this.reconnectDelayMs}ms`);
             this.emit({ type: "reconnecting", delayMs: this.reconnectDelayMs });
-            await delay(this.reconnectDelayMs);
+            await this.waitForReconnect(this.reconnectDelayMs);
             this.reconnectDelayMs = Math.min(this.reconnectDelayMs * 2, DEFAULT_RECONNECT_MAX_DELAY_MS);
         }
     }
     async stop() {
         this.stopped = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.reconnectWaitResolver) {
+            const resolve = this.reconnectWaitResolver;
+            this.reconnectWaitResolver = null;
+            resolve();
+        }
         for (const [jobId, cancel] of this.activeCancels.entries()) {
             try {
                 await cancel();
@@ -237,6 +248,27 @@ export class BridgeRuntime {
             await this.executor.close();
         }
     }
+    async waitForReconnect(ms) {
+        if (ms <= 0 || this.stopped) {
+            return;
+        }
+        await new Promise((resolve) => {
+            this.reconnectWaitResolver = () => {
+                if (this.reconnectTimer) {
+                    clearTimeout(this.reconnectTimer);
+                    this.reconnectTimer = null;
+                }
+                this.reconnectWaitResolver = null;
+                resolve();
+            };
+            this.reconnectTimer = setTimeout(() => {
+                const finish = this.reconnectWaitResolver;
+                this.reconnectTimer = null;
+                this.reconnectWaitResolver = null;
+                finish?.();
+            }, ms);
+        });
+    }
     async connectOnce() {
         const socket = new WebSocket(this.config.wsUrl, ["device", this.config.deviceToken]);
         this.activeSocket = socket;

package/dist/types.js

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