openbuilder 0.1.0 → 0.1.1

package/README.md

@@ -293,6 +293,36 @@ To set up OpenBuilder as an automated meeting bot (e.g. for OpenClaw agents):
 - Caption mode (`--captions`) is the most reliable on headless servers
 - Audio mode (`--audio`) requires PulseAudio + ffmpeg + OpenAI key + Xvfb (experimental on servers)
 
+## Running on Your Own Hardware
+
+OpenBuilder works on any machine running OpenClaw — Mac Mini, laptop, Raspberry Pi, VPS, etc.
+
+### macOS (Mac Mini, MacBook)
+- `npx openbuilder` installs Chromium automatically
+- Audio capture mode is not available (no PulseAudio) — captions mode works great
+- Auth: `npx openbuilder auth` opens a browser window — sign in and press Enter
+- For headless operation: use `--auto` auth with `.env` credentials
+
+### Linux (Ubuntu, Debian, etc.)
+- May need system deps: `npx playwright-core install-deps chromium`
+- For headless servers: ensure Xvfb is running (`Xvfb :99 -screen 0 1280x720x24 &`)
+- Audio mode available if PulseAudio + ffmpeg are installed
+
+### What you need
+1. **Node.js 18+**
+2. **OpenClaw** running on the machine
+3. **A Google account** for the bot (or join as guest)
+4. **An AI API key** (Claude or OpenAI) for meeting reports
+
+### Quick setup (any platform)
+```bash
+npx openbuilder                           # Install + Chromium
+npx openbuilder auth                      # Sign into Google (one-time)
+npx openbuilder config set anthropicApiKey sk-ant-...  # For AI reports
+```
+
+Then tell your OpenClaw agent: "Join this meeting: \<url\>"
+
 ## OpenClaw Integration
 
 OpenBuilder ships as an OpenClaw skill. After running `npx openbuilder`, it's available to your OpenClaw agent. The agent can:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbuilder",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Open-source AI meeting assistant — join Google Meet, capture transcripts, generate AI-powered meeting reports with summaries, action items, and speaker analytics",
   "type": "module",
   "bin": {

package/scripts/builder-auth.ts

@@ -9,7 +9,9 @@
  * Saves session to ~/.openbuilder/auth.json via Playwright's storageState.
  */
 
+import { execSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { createInterface } from "node:readline";
 import { config as dotenvConfig } from "dotenv";
 import { join, dirname } from "node:path";
@@ -163,15 +165,22 @@ async function main() {
     "--window-size=1280,720",
   ];
 
-  // Find full Chrome for headed mode
+  // Find full Chrome for headed mode (cross-platform)
   let executablePath: string | undefined;
-  const fullChromePath = join(
-    process.env.HOME || "~",
-    ".cache/ms-playwright/chromium-1208/chrome-linux64/chrome"
-  );
-  if (existsSync(fullChromePath)) {
-    executablePath = fullChromePath;
-  }
+  try {
+    const playwrightCache = join(homedir(), ".cache", "ms-playwright");
+    if (existsSync(playwrightCache)) {
+      const result = execSync(
+        process.platform === "darwin"
+          ? `find "${playwrightCache}" -path "*/Chromium.app/Contents/MacOS/Chromium" -type f 2>/dev/null | head -1`
+          : `find "${playwrightCache}" -path "*/chrome-linux*/chrome" -type f 2>/dev/null | head -1`,
+        { encoding: "utf-8" },
+      ).trim();
+      if (result && existsSync(result)) {
+        executablePath = result;
+      }
+    }
+  } catch { /* fallback to default */ }
 
   const browser = await pw.chromium.launch({
     headless,

package/scripts/builder-join.ts

@@ -529,6 +529,32 @@ async function waitForMeetingEnd(
       return "Navigated away from meeting";
     }
 
+    // Detect if redirected to Meet homepage (meeting ended and Google kicked us out)
+    const currentUrl = page.url();
+    if (
+      currentUrl === "https://meet.google.com/" ||
+      currentUrl === "https://meet.google.com" ||
+      currentUrl.match(/^https:\/\/meet\.google\.com\/?\?/) ||
+      currentUrl === "https://meet.google.com/landing"
+    ) {
+      return "Meeting ended (redirected to homepage)";
+    }
+
+    // Check if the Leave call button is gone (meeting UI disappeared)
+    try {
+      const leaveBtn = page.locator('[aria-label*="Leave call" i]').first();
+      const hasMeetingUI = await leaveBtn.isVisible({ timeout: 500 });
+      if (!hasMeetingUI) {
+        // Double-check: no meeting controls means we're not in a meeting
+        const hasAnyControls = await page.locator('[aria-label*="microphone" i], [aria-label*="camera" i]').first().isVisible({ timeout: 500 }).catch(() => false);
+        if (!hasAnyControls) {
+          return "Meeting ended (meeting UI gone)";
+        }
+      }
+    } catch {
+      // Couldn't check — continue
+    }
+
     // Check if all other participants have left
     const participantCount = await getParticipantCount(page);
 
@@ -1333,11 +1359,16 @@ export async function joinMeeting(opts: {
     let fullChromePath: string | undefined;
     if (useFullChrome) {
       try {
-        const result = execSync(
-          'find ~/.cache/ms-playwright/chromium-*/chrome-linux64 -name "chrome" -type f | head -1',
-          { encoding: "utf-8" },
-        ).trim();
-        fullChromePath = result || undefined;
+        const playwrightCache = join(homedir(), ".cache", "ms-playwright");
+        if (existsSync(playwrightCache)) {
+          const result = execSync(
+            process.platform === "darwin"
+              ? `find "${playwrightCache}" -path "*/Chromium.app/Contents/MacOS/Chromium" -type f 2>/dev/null | head -1`
+              : `find "${playwrightCache}" -path "*/chrome-linux*/chrome" -type f 2>/dev/null | head -1`,
+            { encoding: "utf-8" },
+          ).trim();
+          fullChromePath = result || undefined;
+        }
       } catch { /* fallback to default */ }
     }
     if (useFullChrome && fullChromePath) {
@@ -1368,8 +1399,12 @@ export async function joinMeeting(opts: {
     const fullChromePath = useFullChrome
       ? (() => {
           try {
+            const playwrightCache = join(homedir(), ".cache", "ms-playwright");
+            if (!existsSync(playwrightCache)) return undefined;
             const result = execSync(
-              'find ~/.cache/ms-playwright/chromium-*/chrome-linux64 -name "chrome" -type f | head -1',
+              process.platform === "darwin"
+                ? `find "${playwrightCache}" -path "*/Chromium.app/Contents/MacOS/Chromium" -type f 2>/dev/null | head -1`
+                : `find "${playwrightCache}" -path "*/chrome-linux*/chrome" -type f 2>/dev/null | head -1`,
               { encoding: "utf-8" },
             ).trim();
             return result || undefined;