clementine-agent 1.6.0 → 1.6.2

package/dist/cli/browser.d.ts

@@ -20,5 +20,17 @@
 export declare function cmdBrowserStatus(): Promise<void>;
 export declare function cmdBrowserInstall(): Promise<void>;
 export declare function cmdBrowserEnable(): Promise<void>;
+/**
+ * Auto-prompt during `clementine update`. Stays silent unless there's
+ * something actionable — mirrors the keychain wizard's behavior.
+ *
+ * Skips prompting when:
+ *   - Not in an interactive TTY
+ *   - The MCP wrapper isn't shipped with this version
+ *   - Browser harness is already installed AND enabled
+ *   - User previously dismissed the prompt
+ */
+export declare function maybePromptBrowserHarness(): Promise<void>;
 export declare function cmdBrowserDisable(): Promise<void>;
+export declare function cmdBrowserConnect(): Promise<void>;
 //# sourceMappingURL=browser.d.ts.map

package/dist/cli/browser.js

@@ -19,9 +19,11 @@
  */
 import { execSync, spawnSync } from 'node:child_process';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import http from 'node:http';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { confirm } from '@inquirer/prompts';
 const BOLD = '\x1b[1m';
 const DIM = '\x1b[0;90m';
 const GREEN = '\x1b[0;32m';
@@ -40,10 +42,36 @@ const VENV_PYTHON = path.join(VENV_DIR, 'bin', 'python3');
 const MCP_SERVERS_FILE = path.join(BASE_DIR, 'mcp-servers.json');
 const HARNESS_REPO = 'https://github.com/browser-use/browser-harness.git';
 const SERVER_NAME = 'browser-harness';
+const DISMISSED_MARKER = path.join(BASE_DIR, '.browser-harness-dismissed');
 function commandExists(cmd) {
     const result = spawnSync('which', [cmd], { stdio: 'pipe' });
     return result.status === 0;
 }
+/** Probe the CDP socket — returns true if Chrome is listening on :9222. */
+function probeCdp() {
+    return new Promise(resolve => {
+        const req = http.get('http://localhost:9222/json/version', { timeout: 1500 }, res => {
+            resolve(res.statusCode === 200);
+            res.resume();
+        });
+        req.on('error', () => resolve(false));
+        req.on('timeout', () => { req.destroy(); resolve(false); });
+    });
+}
+/** True if a Google Chrome process is currently running. */
+function isChromeRunning() {
+    if (process.platform === 'darwin') {
+        const r = spawnSync('pgrep', ['-x', 'Google Chrome'], { stdio: 'pipe' });
+        return r.status === 0;
+    }
+    // Linux: chrome / chromium / google-chrome
+    for (const name of ['google-chrome', 'chromium', 'chrome']) {
+        const r = spawnSync('pgrep', ['-x', name], { stdio: 'pipe' });
+        if (r.status === 0)
+            return true;
+    }
+    return false;
+}
 function pythonVersion() {
     try {
         const out = execSync('python3 --version', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
@@ -75,6 +103,7 @@ export async function cmdBrowserStatus() {
     const harnessOk = existsSync(path.join(HARNESS_HOME, 'src'));
     const servers = loadMcpServers();
     const enabled = Object.prototype.hasOwnProperty.call(servers, SERVER_NAME);
+    const cdpOk = await probeCdp();
     console.log();
     console.log(`  ${BOLD}Browser Harness${RESET} ${DIM}(beta)${RESET}`);
     console.log();
@@ -83,6 +112,7 @@ export async function cmdBrowserStatus() {
     console.log(`  ${venvOk ? GREEN + '✓' : YELLOW + '○'}${RESET} venv installed    ${DIM}${VENV_DIR}${RESET}`);
     console.log(`  ${harnessOk ? GREEN + '✓' : YELLOW + '○'}${RESET} harness cloned    ${DIM}${HARNESS_HOME}${RESET}`);
     console.log(`  ${enabled ? GREEN + '✓' : DIM + '○'}${RESET} MCP entry         ${DIM}${enabled ? 'enabled' : 'disabled'} in mcp-servers.json${RESET}`);
+    console.log(`  ${cdpOk ? GREEN + '✓' : YELLOW + '○'}${RESET} Chrome CDP        ${DIM}${cdpOk ? 'connected on :9222' : 'not connected — run: clementine browser connect'}${RESET}`);
     console.log();
     if (!py) {
         console.log(`  ${YELLOW}Install Python 3.10+ first:${RESET}`);
@@ -97,12 +127,20 @@ export async function cmdBrowserStatus() {
         console.log(`  Next: ${BOLD}clementine browser enable${RESET}`);
         console.log();
     }
+    else if (!cdpOk) {
+        console.log(`  Next: ${BOLD}clementine browser connect${RESET}`);
+        console.log();
+    }
     else {
-        console.log(`  ${GREEN}Ready.${RESET} ${DIM}Restart the daemon to pick up changes: clementine restart${RESET}`);
+        console.log(`  ${GREEN}Ready.${RESET} ${DIM}Browser harness is fully connected.${RESET}`);
         console.log();
     }
 }
-export async function cmdBrowserInstall() {
+/**
+ * Core install logic. Returns true on success, false on any failure.
+ * Prints progress + errors to stdout/stderr but never calls process.exit.
+ */
+async function runInstall() {
     console.log();
     console.log(`  ${BOLD}Installing browser-harness${RESET} ${DIM}(beta)${RESET}`);
     console.log();
@@ -110,13 +148,13 @@ export async function cmdBrowserInstall() {
         console.error(`  ${RED}python3 not found.${RESET} Install Python 3.10+ first:`);
         console.error(`    ${CYAN}brew install python@3.12${RESET}`);
         console.error();
-        process.exit(1);
+        return false;
     }
     if (!existsSync(MCP_SCRIPT)) {
         console.error(`  ${RED}MCP wrapper not found at:${RESET} ${MCP_SCRIPT}`);
         console.error(`  ${DIM}This means the package was installed without vendor/ files. Reinstall:${RESET}`);
         console.error(`    ${CYAN}npm install -g clementine-agent@latest${RESET}`);
-        process.exit(1);
+        return false;
     }
     if (!existsSync(BASE_DIR))
         mkdirSync(BASE_DIR, { recursive: true });
@@ -124,7 +162,7 @@ export async function cmdBrowserInstall() {
     if (!existsSync(HARNESS_HOME)) {
         if (!commandExists('git')) {
             console.error(`  ${RED}git not found.${RESET} Install git, then re-run.`);
-            process.exit(1);
+            return false;
         }
         console.log(`  ${DIM}→ cloning ${HARNESS_REPO}${RESET}`);
         try {
@@ -132,7 +170,7 @@ export async function cmdBrowserInstall() {
         }
         catch {
             console.error(`  ${RED}Clone failed.${RESET} Check network / git access and try again.`);
-            process.exit(1);
+            return false;
         }
     }
     else {
@@ -146,7 +184,7 @@ export async function cmdBrowserInstall() {
         }
         catch {
             console.error(`  ${RED}venv creation failed.${RESET}`);
-            process.exit(1);
+            return false;
         }
     }
     else {
@@ -165,25 +203,21 @@ export async function cmdBrowserInstall() {
     }
     catch {
         console.error(`  ${RED}pip install failed.${RESET} Inspect output above and re-run when fixed.`);
-        process.exit(1);
+        return false;
     }
     console.log();
     console.log(`  ${GREEN}✓${RESET} Install complete.`);
-    console.log();
-    console.log(`  ${BOLD}Next steps:${RESET}`);
-    console.log(`  1. Enable Chrome remote debugging — open Chrome with:`);
-    console.log(`       ${CYAN}/Applications/Google\\ Chrome.app/Contents/MacOS/Google\\ Chrome \\${RESET}`);
-    console.log(`         ${CYAN}--remote-debugging-port=9222${RESET}`);
-    console.log(`  2. Enable the MCP server:  ${BOLD}clementine browser enable${RESET}`);
-    console.log(`  3. Restart the daemon:     ${BOLD}clementine restart${RESET}`);
-    console.log();
+    return true;
 }
-export async function cmdBrowserEnable() {
+/**
+ * Core enable logic. Returns true on success, false on any failure.
+ */
+function runEnable() {
     if (!existsSync(VENV_PYTHON) || !existsSync(MCP_SCRIPT)) {
         console.error();
         console.error(`  ${RED}Not installed yet.${RESET} Run ${BOLD}clementine browser install${RESET} first.`);
         console.error();
-        process.exit(1);
+        return false;
     }
     const servers = loadMcpServers();
     servers[SERVER_NAME] = {
@@ -201,9 +235,107 @@ export async function cmdBrowserEnable() {
     saveMcpServers(servers);
     console.log();
     console.log(`  ${GREEN}✓${RESET} Registered ${BOLD}${SERVER_NAME}${RESET} in mcp-servers.json`);
+    return true;
+}
+export async function cmdBrowserInstall() {
+    const ok = await runInstall();
+    if (!ok)
+        process.exit(1);
+    console.log();
+    console.log(`  ${BOLD}Next:${RESET} ${BOLD}clementine browser enable${RESET} — register the MCP server`);
+    console.log(`  ${DIM}Then connect Chrome with: clementine browser connect${RESET}`);
+    console.log();
+}
+export async function cmdBrowserEnable() {
+    const ok = runEnable();
+    if (!ok)
+        process.exit(1);
     console.log(`  ${DIM}Restart the daemon to pick up the change: clementine restart${RESET}`);
     console.log();
 }
+/**
+ * Auto-prompt during `clementine update`. Stays silent unless there's
+ * something actionable — mirrors the keychain wizard's behavior.
+ *
+ * Skips prompting when:
+ *   - Not in an interactive TTY
+ *   - The MCP wrapper isn't shipped with this version
+ *   - Browser harness is already installed AND enabled
+ *   - User previously dismissed the prompt
+ */
+export async function maybePromptBrowserHarness() {
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return;
+    if (!existsSync(MCP_SCRIPT))
+        return;
+    const servers = loadMcpServers();
+    const enabled = Object.prototype.hasOwnProperty.call(servers, SERVER_NAME);
+    const installed = existsSync(VENV_PYTHON);
+    if (enabled && installed)
+        return;
+    if (existsSync(DISMISSED_MARKER))
+        return;
+    console.log();
+    console.log(`  ${BOLD}Browser Harness available${RESET} ${DIM}(beta, opt-in)${RESET}`);
+    console.log(`  ${DIM}Lets Clementine drive your real Chrome — fill forms, post on LinkedIn,${RESET}`);
+    console.log(`  ${DIM}book appointments — using your live browser session.${RESET}`);
+    console.log();
+    let answer;
+    try {
+        answer = await confirm({
+            message: 'Install Browser Harness now?',
+            default: false,
+        });
+    }
+    catch {
+        // User Ctrl+C'd or terminal closed — treat as decline, don't dismiss permanently
+        return;
+    }
+    if (!answer) {
+        try {
+            writeFileSync(DISMISSED_MARKER, new Date().toISOString() + '\n');
+        }
+        catch { /* non-fatal */ }
+        console.log(`  ${DIM}Skipped. To install later: clementine browser install${RESET}`);
+        console.log();
+        return;
+    }
+    // User said yes — run install + enable inline
+    const installOk = await runInstall();
+    if (!installOk) {
+        console.error(`  ${YELLOW}Install failed.${RESET} ${DIM}You can retry with: clementine browser install${RESET}`);
+        console.log();
+        return;
+    }
+    const enableOk = runEnable();
+    if (!enableOk) {
+        console.error(`  ${YELLOW}Enable failed.${RESET} ${DIM}Retry with: clementine browser enable${RESET}`);
+        console.log();
+        return;
+    }
+    console.log();
+    console.log(`  ${GREEN}✓${RESET} Browser Harness installed and enabled.`);
+    console.log();
+    // Offer to connect Chrome right now
+    let connectNow = false;
+    try {
+        connectNow = await confirm({
+            message: 'Connect Chrome now? (relaunches Chrome with debugging — will close current windows)',
+            default: false,
+        });
+    }
+    catch {
+        // Ctrl+C — bail without dismissing
+        return;
+    }
+    if (connectNow) {
+        await runConnect({ confirmQuit: false });
+    }
+    else {
+        console.log(`  ${DIM}Connect later with: ${BOLD}clementine browser connect${RESET}`);
+        console.log();
+    }
+}
 export async function cmdBrowserDisable() {
     const servers = loadMcpServers();
     if (!Object.prototype.hasOwnProperty.call(servers, SERVER_NAME)) {
@@ -221,4 +353,121 @@ export async function cmdBrowserDisable() {
     console.log(`  ${DIM}Restart the daemon: clementine restart${RESET}`);
     console.log();
 }
+/**
+ * Core connect logic — quits any running Chrome and relaunches with
+ * --remote-debugging-port=9222 so browser-harness can connect.
+ *
+ * Returns true when CDP is reachable on :9222 at the end, false otherwise.
+ * Never calls process.exit so it's safe to call from the auto-prompt flow.
+ */
+async function runConnect(opts = {}) {
+    // 1. Already connected? Done.
+    if (await probeCdp()) {
+        console.log();
+        console.log(`  ${GREEN}✓${RESET} Already connected — Chrome is running with remote debugging on :9222`);
+        console.log();
+        return true;
+    }
+    // 2. Platform check — auto-launch is currently macOS only
+    if (process.platform !== 'darwin' && process.platform !== 'linux') {
+        console.error();
+        console.error(`  ${YELLOW}Auto-connect is only supported on macOS and Linux.${RESET}`);
+        console.error(`  Launch Chrome manually with the flag: ${BOLD}--remote-debugging-port=9222${RESET}`);
+        console.error();
+        return false;
+    }
+    // 3. Chrome already running without the flag? Need to quit first.
+    if (isChromeRunning()) {
+        console.log();
+        console.log(`  ${YELLOW}Chrome is running, but without remote debugging.${RESET}`);
+        console.log(`  ${DIM}To connect, Chrome needs to be quit and relaunched with the flag.${RESET}`);
+        console.log(`  ${DIM}This will close your current Chrome windows.${RESET}`);
+        console.log();
+        let confirmed = !opts.confirmQuit; // skip prompt when caller already confirmed
+        if (opts.confirmQuit) {
+            try {
+                confirmed = await confirm({
+                    message: 'Quit Chrome and relaunch with debugging?',
+                    default: false,
+                });
+            }
+            catch {
+                return false;
+            }
+        }
+        if (!confirmed) {
+            console.log(`  ${DIM}Skipped. To do it yourself: quit Chrome (Cmd+Q), then run:${RESET}`);
+            console.log(`    ${BOLD}clementine browser connect${RESET}`);
+            console.log();
+            return false;
+        }
+        console.log(`  ${DIM}→ quitting Chrome...${RESET}`);
+        try {
+            if (process.platform === 'darwin') {
+                execSync('osascript -e \'tell application "Google Chrome" to quit\'', { stdio: 'pipe' });
+            }
+            else {
+                // Linux: graceful TERM, then KILL if needed
+                try {
+                    execSync('pkill -TERM -x "google-chrome|chromium|chrome"', { stdio: 'pipe' });
+                }
+                catch { /* ok */ }
+            }
+            // Wait briefly for Chrome to actually exit
+            for (let i = 0; i < 15; i++) {
+                if (!isChromeRunning())
+                    break;
+                await new Promise(r => setTimeout(r, 300));
+            }
+        }
+        catch {
+            console.error(`  ${RED}Failed to quit Chrome.${RESET} Please quit it manually and re-run.`);
+            return false;
+        }
+    }
+    // 4. Launch Chrome with the debugging flag
+    console.log(`  ${DIM}→ launching Chrome with --remote-debugging-port=9222${RESET}`);
+    try {
+        if (process.platform === 'darwin') {
+            execSync('open -na "Google Chrome" --args --remote-debugging-port=9222', { stdio: 'pipe' });
+        }
+        else {
+            // Linux — find a chrome binary in PATH
+            const candidates = ['google-chrome', 'chromium', 'chrome'];
+            const bin = candidates.find(commandExists);
+            if (!bin) {
+                console.error(`  ${RED}No Chrome / Chromium binary found in PATH.${RESET}`);
+                return false;
+            }
+            // Launch detached so this command returns immediately
+            execSync(`nohup ${bin} --remote-debugging-port=9222 >/dev/null 2>&1 &`, { stdio: 'pipe' });
+        }
+    }
+    catch (e) {
+        console.error(`  ${RED}Failed to launch Chrome:${RESET} ${String(e).slice(0, 200)}`);
+        return false;
+    }
+    // 5. Poll for CDP availability (up to ~6s)
+    for (let i = 0; i < 24; i++) {
+        await new Promise(r => setTimeout(r, 250));
+        if (await probeCdp()) {
+            console.log();
+            console.log(`  ${GREEN}✓${RESET} Connected — Chrome is running with remote debugging on :9222`);
+            console.log(`  ${DIM}Browser harness can now control your live session.${RESET}`);
+            console.log();
+            return true;
+        }
+    }
+    console.error();
+    console.error(`  ${YELLOW}Chrome launched, but CDP socket isn't responding yet.${RESET}`);
+    console.error(`  ${DIM}Check that Chrome started, then verify with:${RESET}`);
+    console.error(`    ${CYAN}curl http://localhost:9222/json/version${RESET}`);
+    console.error();
+    return false;
+}
+export async function cmdBrowserConnect() {
+    const ok = await runConnect({ confirmQuit: true });
+    if (!ok)
+        process.exit(1);
+}
 //# sourceMappingURL=browser.js.map

package/dist/cli/index.js

@@ -24,7 +24,7 @@ import { cmdCronList, cmdCronRun, cmdCronRunDue, cmdCronRuns, cmdCronAdd, cmdCro
 import { cmdDashboard } from './dashboard.js';
 import { cmdChat } from './chat.js';
 import { cmdIngestSeed, cmdIngestRun, cmdIngestList, cmdIngestStatus } from './ingest.js';
-import { cmdBrowserStatus, cmdBrowserInstall, cmdBrowserEnable, cmdBrowserDisable } from './browser.js';
+import { cmdBrowserStatus, cmdBrowserInstall, cmdBrowserEnable, cmdBrowserDisable, cmdBrowserConnect, maybePromptBrowserHarness } from './browser.js';
 import { isSensitiveEnvKey } from '../secrets/sensitivity.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -3171,6 +3171,8 @@ async function cmdUpdate(options) {
             console.log(`  ${DIM}Restart your daemon to pick up the new code:${RESET}`);
             console.log(`    clementine restart`);
         }
+        // Surface new opt-in integrations (silent unless action needed)
+        await maybePromptBrowserHarness();
         return;
     }
     let step = 0;
@@ -3830,6 +3832,8 @@ async function cmdUpdate(options) {
     }
     console.log(`  ${DIM}Config backup: ${backupDir}${RESET}`);
     console.log();
+    // Surface new opt-in integrations (silent unless action needed)
+    await maybePromptBrowserHarness();
 }
 // ── Cron commands ───────────────────────────────────────────────────
 const cronCmd = program
@@ -4566,6 +4570,10 @@ browserCmd
     .command('enable')
     .description('Register the browser harness MCP server in mcp-servers.json')
     .action(cmdBrowserEnable);
+browserCmd
+    .command('connect')
+    .description('Quit Chrome and relaunch it with --remote-debugging-port=9222 (one-shot)')
+    .action(cmdBrowserConnect);
 browserCmd
     .command('disable')
     .description('Remove the browser harness MCP entry (keeps installed files)')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clementine-agent",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Clementine — Personal AI Assistant (TypeScript)",
   "type": "module",
   "main": "dist/index.js",