@leg3ndy/otto-bridge 0.6.5 → 0.6.7

package/README.md

@@ -33,10 +33,10 @@ Enquanto o pacote nao estiver publicado, voce pode gerar um tarball local:
 
 ```bash
 npm pack
-npm install -g ./leg3ndy-otto-bridge-0.6.5.tgz
+npm install -g ./leg3ndy-otto-bridge-0.6.7.tgz
 ```
 
-No `0.6.5`, `playwright` deixa de ser opcional 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.6.7`, `playwright` deixa de ser opcional 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.
 
 ## Publicacao
 
@@ -106,7 +106,7 @@ otto-bridge run --executor clawd-cursor --clawd-url http://127.0.0.1:3847
 
 ### WhatsApp Web em background
 
-Fluxo recomendado no `0.6.5`:
+Fluxo recomendado no `0.6.7`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -116,10 +116,10 @@ otto-bridge extensions --status whatsappweb
 
 O setup agora abre o login do WhatsApp Web em um browser persistente 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.6.5`:
+Contrato do `0.6.7`:
 
 - `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
+- `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
 
 ### Ver estado local

package/dist/executors/native_macos.js

@@ -2164,7 +2164,7 @@ end repeat
         if (!availability.ok) {
             return null;
         }
-        const browser = new WhatsAppBackgroundBrowser({ headless: true });
+        const browser = new WhatsAppBackgroundBrowser({ headless: false, background: true });
         await browser.start();
         this.whatsappBackgroundBrowser = browser;
         return browser;

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "0.6.5";
+export const BRIDGE_VERSION = "0.6.7";
 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

@@ -1,3 +1,4 @@
+import { spawn } from "node:child_process";
 import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -99,7 +100,7 @@ export class WhatsAppBackgroundBrowser {
         const playwright = await loadPlaywrightModule();
         await ensureWhatsAppBrowserUserDataDir();
         this.context = await playwright.chromium.launchPersistentContext(getWhatsAppBrowserUserDataDir(), {
-            headless: this.options.headless !== false,
+            headless: this.options.headless === true,
             viewport: { width: 1440, height: 960 },
             locale: "pt-BR",
             timezoneId: "America/Sao_Paulo",
@@ -113,6 +114,10 @@ export class WhatsAppBackgroundBrowser {
         const pages = this.context.pages();
         this.page = pages[0] || await this.context.newPage();
         await this.ensureWhatsAppPage();
+        if (this.options.background) {
+            await this.moveWindowOffscreen();
+            await this.hideAppFromDock();
+        }
     }
     async close() {
         const current = this.context;
@@ -126,6 +131,85 @@ export class WhatsAppBackgroundBrowser {
     async waitForTimeout(timeoutMs) {
         await this.page?.waitForTimeout(Math.max(0, Number(timeoutMs || 0)));
     }
+    async moveWindowOffscreen() {
+        const context = this.context;
+        const page = this.page;
+        if (!context || !page || typeof context.newCDPSession !== "function") {
+            return;
+        }
+        try {
+            const session = await context.newCDPSession(page);
+            const windowInfo = await session.send("Browser.getWindowForTarget");
+            const windowId = Number(windowInfo.windowId || 0);
+            if (Number.isFinite(windowId) && windowId > 0) {
+                await session.send("Browser.setWindowBounds", {
+                    windowId,
+                    bounds: {
+                        windowState: "normal",
+                        left: -2200,
+                        top: 80,
+                        width: 1320,
+                        height: 920,
+                    },
+                });
+            }
+            await session.detach?.().catch(() => undefined);
+        }
+        catch {
+            // If background placement fails, keep the runtime alive anyway.
+        }
+    }
+    async hideAppFromDock() {
+        if (process.platform !== "darwin") {
+            return;
+        }
+        const browserPid = await this.findBrowserProcessId();
+        if (!browserPid) {
+            return;
+        }
+        const script = [
+            'tell application "System Events"',
+            `set visible of (first application process whose unix id is ${browserPid}) to false`,
+            "end tell",
+        ].join("\n");
+        await runCommand("osascript", ["-e", script]).catch(() => undefined);
+    }
+    async findBrowserProcessId() {
+        if (process.platform !== "darwin") {
+            return null;
+        }
+        const userDataDir = getWhatsAppBrowserUserDataDir();
+        const result = await runCommand("pgrep", ["-af", userDataDir]).catch(() => null);
+        if (!result) {
+            return null;
+        }
+        const candidates = result
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => {
+            const match = line.match(/^(\d+)\s+(.*)$/);
+            if (!match) {
+                return null;
+            }
+            const pid = Number(match[1]);
+            const command = match[2] || "";
+            if (!Number.isFinite(pid) || pid <= 0) {
+                return null;
+            }
+            let score = 0;
+            if (!command.includes("--type="))
+                score += 100;
+            if (command.includes("Chromium.app") || command.includes("chrome"))
+                score += 40;
+            if (command.includes(userDataDir))
+                score += 20;
+            return { pid, score };
+        })
+            .filter((item) => item !== null)
+            .sort((left, right) => right.score - left.score || left.pid - right.pid);
+        return candidates[0]?.pid || null;
+    }
     async getSessionState() {
         const state = await this.withPage(async (page) => {
             await this.ensureWhatsAppPage();
@@ -494,6 +578,27 @@ function clipText(text, maxLength) {
     }
     return `${value.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;
 }
+function runCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve(stdout.trim());
+                return;
+            }
+            reject(new Error(stderr.trim() || stdout.trim() || `${command} exited with code ${code}`));
+        });
+    });
+}
 export async function detectWhatsAppBackgroundStatus() {
     const availability = await WhatsAppBackgroundBrowser.checkAvailability();
     if (!availability.ok) {
@@ -502,7 +607,7 @@ export async function detectWhatsAppBackgroundStatus() {
             notes: availability.reason || "Playwright nao esta disponivel para verificar o WhatsApp Web em background.",
         };
     }
-    const browser = new WhatsAppBackgroundBrowser({ headless: true });
+    const browser = new WhatsAppBackgroundBrowser({ headless: false, background: true });
     try {
         const state = await browser.waitForStableSessionState({
             timeoutMs: DEFAULT_EXPECTED_CONNECTED_TIMEOUT_MS,
@@ -522,7 +627,7 @@ export async function detectWhatsAppBackgroundStatus() {
     }
 }
 async function verifyWhatsAppBackgroundSessionPersistence(options) {
-    const browser = new WhatsAppBackgroundBrowser({ headless: true });
+    const browser = new WhatsAppBackgroundBrowser({ headless: false, background: true });
     try {
         options?.log?.("Confirmando se a sessao persistiu no browser em background do bridge...");
         const state = await browser.waitForStableSessionState({

package/package.json

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