@leg3ndy/otto-bridge 0.7.2 → 0.7.3

package/README.md

@@ -33,12 +33,12 @@ Enquanto o pacote nao estiver publicado, voce pode gerar um tarball local:
 
 ```bash
 npm pack
-npm install -g ./leg3ndy-otto-bridge-0.7.2.tgz
+npm install -g ./leg3ndy-otto-bridge-0.7.3.tgz
 ```
 
-No `0.7.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 `0.7.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.
 
-No macOS, o `0.7.2` passa a preferir o provider `macos-helper`, um helper `WKWebView` sem Dock para o WhatsApp Web. O helper agora sobe com user-agent de Chrome moderno para evitar o bloqueio do WhatsApp ao detectar Safari/WebKit. Se voce quiser forcar o runtime antigo com Chromium/Playwright, use `OTTO_BRIDGE_WHATSAPP_RUNTIME_PROVIDER=embedded-playwright`.
+No macOS, o `0.7.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`.
 
 ## Publicacao
 
@@ -108,7 +108,7 @@ otto-bridge run --executor clawd-cursor --clawd-url http://127.0.0.1:3847
 
 ### WhatsApp Web em background
 
-Fluxo recomendado no `0.7.2`:
+Fluxo recomendado no `0.7.3`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -118,17 +118,17 @@ 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 do `0.7.2`:
+Contrato do `0.7.3`:
 
 - `otto-bridge extensions --setup whatsappweb`: autentica a sessao uma vez
 - `otto-bridge run`: mantem o browser persistente do WhatsApp vivo em background enquanto o runtime estiver ativo, sem depender de uma aba aberta no Safari
 - ao parar o `otto-bridge run`: o browser em background e desligado, mas a sessao local fica lembrada para o proximo boot
 
-## Handoff rapido do 0.7.2
+## Handoff rapido do 0.7.3
 
 Ja fechado no codigo:
 
-- provider `macos-helper` dockless no macOS com fallback para `embedded-playwright`
+- provider `macos-helper` dockless no macOS como runtime padrao do WhatsApp
 - user-agent do helper ajustado para evitar bloqueio do WhatsApp por detecao de Safari/WebKit
 - resultado final dos `device_job` agora e persistido como contexto mais forte para o proximo turno do Otto
 - prompt bridge-aware no chat normal para ajudar o Otto a responder com base no que realmente aconteceu no device

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "0.7.2";
+export const BRIDGE_VERSION = "0.7.3";
 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/dist/whatsapp_background.js

@@ -90,12 +90,7 @@ export class WhatsAppBackgroundBrowser {
         const provider = getConfiguredWhatsAppRuntimeProvider();
         if (provider.kind === "macos-helper") {
             const helperAvailability = await checkMacOSWhatsAppHelperAvailability();
-            if (helperAvailability.ok) {
-                return helperAvailability;
-            }
-            if (provider.source === "env") {
-                return helperAvailability;
-            }
+            return helperAvailability;
         }
         try {
             await loadEmbeddedPlaywrightModule();
@@ -113,32 +108,29 @@ export class WhatsAppBackgroundBrowser {
             return;
         }
         const provider = getConfiguredWhatsAppRuntimeProvider();
-        if (provider.kind === "macos-helper" && process.platform === "darwin") {
+        if (provider.kind === "macos-helper") {
+            if (process.platform !== "darwin") {
+                throw new Error("O helper nativo do WhatsApp esta disponivel apenas no macOS.");
+            }
             const helperAvailability = await checkMacOSWhatsAppHelperAvailability();
-            if (helperAvailability.ok) {
-                try {
-                    this.helperRuntime = new MacOSWhatsAppHelperRuntime({ background: this.options.background });
-                    await this.helperRuntime.start();
-                    if (this.options.background) {
-                        await this.helperRuntime.hideBackground();
-                    }
-                    else {
-                        await this.helperRuntime.showSetup();
-                    }
-                    this.activeProviderKind = "macos-helper";
-                    return;
+            if (!helperAvailability.ok) {
+                throw new Error(helperAvailability.reason || "O helper macOS do WhatsApp nao esta disponivel nesta maquina.");
+            }
+            this.helperRuntime = new MacOSWhatsAppHelperRuntime({ background: this.options.background });
+            try {
+                await this.helperRuntime.start();
+                if (this.options.background) {
+                    await this.helperRuntime.hideBackground();
                 }
-                catch (error) {
-                    this.helperRuntime = null;
-                    if (provider.source === "env") {
-                        throw error;
-                    }
-                    const detail = error instanceof Error ? error.message : String(error);
-                    console.warn(`[otto-bridge] whatsapp runtime fallback para embedded-playwright: ${detail}`);
+                else {
+                    await this.helperRuntime.showSetup();
                 }
+                this.activeProviderKind = "macos-helper";
+                return;
             }
-            else if (provider.source === "env") {
-                throw new Error(helperAvailability.reason || "O helper macOS do WhatsApp nao esta disponivel nesta maquina.");
+            catch (error) {
+                this.helperRuntime = null;
+                throw error;
             }
         }
         const playwright = await loadEmbeddedPlaywrightModule();
@@ -283,6 +275,7 @@ export class WhatsAppBackgroundBrowser {
         return candidates[0]?.pid || null;
     }
     async getSessionState() {
+        await this.start();
         if (this.helperRuntime) {
             return await this.helperRuntime.getSessionState();
         }
@@ -330,6 +323,7 @@ export class WhatsAppBackgroundBrowser {
         };
     }
     async ensureReady() {
+        await this.start();
         if (this.helperRuntime) {
             return await this.helperRuntime.ensureReady();
         }
@@ -343,6 +337,7 @@ export class WhatsAppBackgroundBrowser {
         throw new Error("Nao consegui confirmar uma sessao pronta do WhatsApp Web neste browser em background.");
     }
     async waitForLogin(timeoutMs = DEFAULT_SETUP_TIMEOUT_MS) {
+        await this.start();
         if (this.helperRuntime) {
             return await this.helperRuntime.waitForLogin(timeoutMs);
         }
@@ -358,6 +353,7 @@ export class WhatsAppBackgroundBrowser {
         return lastState || await this.getSessionState();
     }
     async waitForStableSessionState(options) {
+        await this.start();
         if (this.helperRuntime) {
             return await this.helperRuntime.waitForStableSessionState(options);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leg3ndy/otto-bridge",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "private": false,
   "type": "module",
   "description": "Local companion for Otto Bridge device pairing and WebSocket runtime.",