browse-agent-cli 0.0.5 → 0.0.7

package/dist/clear.js

@@ -1,4 +1,4 @@
-import { t as BASE_DIR, u as loadSession } from "./config.js";
+import { d as loadSession, t as BASE_DIR } from "./config.js";
 import { existsSync, rmSync } from "node:fs";
 //#region src/scripts/clear.ts
 async function clear() {

package/dist/cli.js

@@ -1,68 +1,83 @@
 #!/usr/bin/env node
-import { l as loadServiceSession, n as DEFAULT_SERVICE_PORT, t as BASE_DIR } from "./config.js";
+import { f as resolveOptions, n as DEFAULT_PROFILE_PATHS, r as DEFAULT_SERVICE_PORT, s as findBrowser, u as loadServiceSession } from "./config.js";
 import { t as clear } from "./clear.js";
-import { execSync, spawn } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, statSync, unlinkSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 //#region src/scripts/setup.ts
+const BROWSE_AGENT_WEBSTORE_URL = "https://chromewebstore.google.com/detail/browse-agent/amfbnjpgfgappenkkklkogngmoeofeae?authuser=0&hl=zh-CN";
+const BROWSE_AGENT_EXTENSION_ID = "amfbnjpgfgappenkkklkogngmoeofeae";
+const INSTALL_WAIT_TIMEOUT_MS = 300 * 1e3;
+const INSTALL_POLL_INTERVAL_MS = 1500;
+function openUrlInSelectedBrowser(url) {
+	const opts = resolveOptions();
+	const proc = spawn(findBrowser(opts.browser), ["--new-window", url], {
+		stdio: "ignore",
+		detached: true
+	});
+	proc.on("error", (err) => {
+		throw new Error(`${opts.browser} launch failed: ${err.message}`);
+	});
+	proc.unref();
+}
+function listProfileDirs(userDataDir) {
+	const candidates = ["Default"];
+	try {
+		for (const name of readdirSync(userDataDir)) if (name.startsWith("Profile ")) candidates.push(name);
+	} catch {}
+	return [...new Set(candidates)].map((name) => join(userDataDir, name));
+}
+function isExtensionInstalledInBrowser(browser) {
+	const userDataDir = DEFAULT_PROFILE_PATHS[browser]?.[process.platform];
+	if (!userDataDir || !existsSync(userDataDir)) return false;
+	for (const profileDir of listProfileDirs(userDataDir)) {
+		const extDir = join(profileDir, "Extensions", BROWSE_AGENT_EXTENSION_ID);
+		if (!existsSync(extDir)) continue;
+		try {
+			if (readdirSync(extDir).length > 0) return true;
+		} catch {}
+	}
+	return false;
+}
+function sleep$1(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function waitForExtensionInstall(browser, timeoutMs) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		if (isExtensionInstalledInBrowser(browser)) return true;
+		await sleep$1(INSTALL_POLL_INTERVAL_MS);
+	}
+	return false;
+}
 async function setup() {
-	const baseDir = BASE_DIR;
-	const extensionDir = join(baseDir, "extension");
-	const zipPath = join(baseDir, "extension.zip");
-	const extensionInstalled = existsSync(join(extensionDir, "manifest.json"));
-	if (extensionInstalled) {
-		console.log("browse-agent is already set up.");
-		console.log(`  Extension path: ${extensionDir}`);
-		console.log("  Extension: installed\n");
+	const browser = resolveOptions().browser;
+	if (isExtensionInstalledInBrowser(browser)) {
+		console.log(`Browse Agent extension is already installed in ${browser}.`);
 		return;
 	}
-	console.log("Setting up browse-agent...\n");
-	mkdirSync(baseDir, { recursive: true });
-	if (extensionInstalled) {
-		console.log("\n[1/2] Downloading Chrome extension from latest release...");
-		console.log("  Skipped: extension is already installed.");
-		console.log("\n[2/2] Extracting extension...");
-		console.log("  Skipped: extension is already installed.");
-	} else {
-		console.log("\n[1/2] Downloading Chrome extension from latest release...");
-		const releaseJson = execSync(`curl -s "https://api.github.com/repos/imlinhanchao/browse-agent/releases/latest"`).toString();
-		const asset = JSON.parse(releaseJson).assets?.find((item) => item.name.endsWith(".zip"));
-		if (!asset) {
-			console.error("Error: No extension zip found in latest release.");
-			console.error("Visit https://github.com/imlinhanchao/browse-agent/releases to check.");
-			process.exit(1);
-		}
-		console.log(`  Downloading ${asset.name} (${(asset.size / 1024).toFixed(1)} KB)...`);
-		execSync(`curl -sL -o "${zipPath}" "${asset.browser_download_url}"`);
-		console.log("\n[2/2] Extracting extension...");
-		if (existsSync(extensionDir)) execSync(`rm -rf "${extensionDir}"`);
-		mkdirSync(extensionDir, { recursive: true });
-		execSync(`unzip -o "${zipPath}" -d "${extensionDir}"`, { stdio: "pipe" });
-		unlinkSync(zipPath);
-		const files = readdirSync(extensionDir);
-		if (!files.includes("manifest.json")) {
-			const subdirs = files.filter((file) => {
-				try {
-					return readdirSync(join(extensionDir, file)).includes("manifest.json");
-				} catch {
-					return false;
-				}
-			});
-			if (subdirs.length > 0) {
-				const subdir = join(extensionDir, subdirs[0]);
-				execSync(`mv "${subdir}"/* "${extensionDir}"/`);
-				execSync(`rmdir "${subdir}"`);
-			} else {
-				console.error("Error: Extension extraction failed - manifest.json not found.");
-				process.exit(1);
-			}
+	console.log(`Opening Chrome Web Store install page in ${browser}...`);
+	try {
+		openUrlInSelectedBrowser(BROWSE_AGENT_WEBSTORE_URL);
+		console.log("Please click \"Add to Chrome\" to install Browse Agent.");
+		console.log("Browser extensions cannot be silently installed from CLI without enterprise policy.");
+		console.log(`If it did not open automatically, visit:\n${BROWSE_AGENT_WEBSTORE_URL}\n`);
+		console.log("Waiting for extension installation...");
+		if (await waitForExtensionInstall(browser, INSTALL_WAIT_TIMEOUT_MS)) {
+			console.log(`Browse Agent extension installation detected in ${browser}.`);
+			return;
 		}
+		console.error(`Timed out after ${Math.round(INSTALL_WAIT_TIMEOUT_MS / 1e3)}s waiting for extension install in ${browser}.`);
+		console.error("Please finish installation in browser, then run \"browse-agent setup\" again.");
+		process.exit(1);
+	} catch (err) {
+		const msg = err instanceof Error ? err.message : String(err);
+		console.error(`Failed to open browser automatically: ${msg}`);
+		console.error(`Please open manually:\n${BROWSE_AGENT_WEBSTORE_URL}\n`);
+		process.exit(1);
 	}
-	console.log("\nSetup complete!");
-	console.log(`  Extension path: ${extensionDir}`);
-	console.log("  Extension: installed\n");
 }
 //#endregion
 //#region src/cli.ts
@@ -160,7 +175,7 @@ Examples:
 `.trim());
 }
 function resolveSkillSourceDir() {
-	return join(dirname(fileURLToPath(import.meta.url)), "..", "skill");
+	return join(dirname(fileURLToPath(import.meta.url)), "..", "skills");
 }
 function isNonEmptyDirectory(path) {
 	if (!existsSync(path)) return false;
@@ -316,7 +331,7 @@ try {
 			}
 			if (!service.newlyStarted) {
 				const status = await requestService(servicePort, "/status", "GET");
-				if (status.running === true) {
+				if (status.running === true && status.connected === true) {
 					console.log(JSON.stringify({
 						servicePort,
 						skipped: "service-and-browser-already-running",

package/dist/config.js

@@ -1,10 +1,14 @@
 import { execSync } from "node:child_process";
-import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 //#region src/scripts/config.ts
 const CLI_RUNTIME_DIR = dirname(fileURLToPath(import.meta.url));
 const HOME = process.env.HOME || process.env.USERPROFILE || "";
+const DEFAULT_BASE_DIR = HOME ? join(HOME, ".browse-agent") : join(process.cwd(), ".browse-agent");
+function unique(paths) {
+	return [...new Set(paths.filter(Boolean))];
+}
 const BROWSER_PATHS = {
 	chrome: {
 		darwin: ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"],
@@ -63,8 +67,13 @@ const BROWSER_PATHS = {
 		netbsd: []
 	}
 };
-const BASE_DIR = join(CLI_RUNTIME_DIR, ".browse-agent");
+const BASE_DIR = process.env.BROWSE_AGENT_HOME || DEFAULT_BASE_DIR;
 const DEFAULT_SERVICE_PORT = Number(process.env.BROWSE_AGENT_SERVICE_PORT || 9316);
+unique([
+	join(CLI_RUNTIME_DIR, ".browse-agent"),
+	join(dirname(CLI_RUNTIME_DIR), ".browse-agent"),
+	join(process.cwd(), ".browse-agent")
+]).filter((dir) => dir !== BASE_DIR);
 async function importSdk() {
 	try {
 		return await import("browse-agent-sdk");
@@ -187,17 +196,6 @@ function getProfileDir(browser, useUserProfile) {
 	mkdirSync(dir, { recursive: true });
 	return dir;
 }
-function patchExtension(port, secret) {
-	const extensionSrc = join(BASE_DIR, "extension");
-	const extensionWork = join(BASE_DIR, "_ext_work");
-	if (!existsSync(join(extensionSrc, "manifest.json"))) throw new Error(`Extension is not installed at ${extensionSrc}. Run "browse-agent setup" first.`);
-	if (existsSync(extensionWork)) rmSync(extensionWork, { recursive: true });
-	cpSync(extensionSrc, extensionWork, { recursive: true });
-	const swPath = join(extensionWork, "service-worker.js");
-	const originalSW = readFileSync(swPath, "utf8");
-	writeFileSync(swPath, [`chrome.storage.local.set({ wsUrl: 'ws://127.0.0.1:${port}', secret: '${secret}' });`, originalSW].join("\n"));
-	return extensionWork;
-}
 function cleanExtensionWork() {
 	const extensionWork = join(BASE_DIR, "_ext_work");
 	if (existsSync(extensionWork)) rmSync(extensionWork, { recursive: true });
@@ -206,13 +204,13 @@ function resolveOptions(options = {}) {
 	return {
 		browser: options.browser ?? process.env.BROWSER ?? "chrome",
 		headless: options.headless ?? process.env.HEADLESS === "true",
-		useUserProfile: options.useUserProfile ?? process.env.USE_USER_PROFILE === "true",
+		useUserProfile: options.useUserProfile ?? process.env.USE_USER_PROFILE !== "false",
 		port: options.port ?? Number(process.env.BROWSE_AGENT_PORT || 9315),
 		timeout: options.timeout ?? Number(process.env.CONNECTION_TIMEOUT || 3e4),
 		secret: options.secret ?? process.env.SHARED_SECRET ?? ""
 	};
 }
 //#endregion
-export { clearSession as a, importSdk as c, patchExtension as d, resolveOptions as f, clearServiceSession as i, loadServiceSession as l, saveSession as m, DEFAULT_SERVICE_PORT as n, findBrowser as o, saveServiceSession as p, cleanExtensionWork as r, getProfileDir as s, BASE_DIR as t, loadSession as u };
+export { clearServiceSession as a, getProfileDir as c, loadSession as d, resolveOptions as f, cleanExtensionWork as i, importSdk as l, saveSession as m, DEFAULT_PROFILE_PATHS as n, clearSession as o, saveServiceSession as p, DEFAULT_SERVICE_PORT as r, findBrowser as s, BASE_DIR as t, loadServiceSession as u };
 
 //# sourceMappingURL=config.js.map

package/dist/script.js

@@ -1,4 +1,4 @@
-import { c as importSdk, f as resolveOptions, r as cleanExtensionWork, u as loadSession } from "./config.js";
+import { d as loadSession, f as resolveOptions, i as cleanExtensionWork, l as importSdk } from "./config.js";
 import { t as clear } from "./clear.js";
 import { a as injectCSS, c as getDOM, d as closeBrowser, f as launchBrowser, i as screenshot, l as getContent, n as closeTab, o as injectScript, r as listTabs, s as evaluate, t as activateTab, u as navigate } from "./tabs.js";
 //#region src/scripts/connect.ts

package/dist/service.js

@@ -1,4 +1,4 @@
-import { f as resolveOptions, i as clearServiceSession, n as DEFAULT_SERVICE_PORT, p as saveServiceSession } from "./config.js";
+import { a as clearServiceSession, f as resolveOptions, p as saveServiceSession, r as DEFAULT_SERVICE_PORT } from "./config.js";
 import { a as injectCSS, c as getDOM, d as closeBrowser, f as launchBrowser, i as screenshot, l as getContent, n as closeTab, o as injectScript, r as listTabs, s as evaluate, t as activateTab, u as navigate } from "./tabs.js";
 import { createServer } from "node:http";
 //#region src/service.ts
@@ -13,6 +13,15 @@ function toCommandRequest(value) {
 }
 let currentSession = null;
 let currentAgent = null;
+function isProcessAlive(pid) {
+	if (!pid) return false;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
 function getServicePort() {
 	const index = process.argv.findIndex((arg) => arg === "--service-port");
 	if (index !== -1 && process.argv[index + 1]) {
@@ -39,11 +48,17 @@ function sessionInfo(session) {
 	const { _agent, _proc, ...info } = session;
 	return {
 		running: true,
+		connected: Boolean(_agent?.isConnected),
 		...info
 	};
 }
 async function handleLaunch(body) {
-	if (currentSession && currentAgent) return sessionInfo(currentSession);
+	if (currentSession && currentAgent) {
+		const connected = Boolean(currentAgent?.isConnected);
+		const browserAlive = isProcessAlive(currentSession.pid);
+		if (connected && browserAlive) return sessionInfo(currentSession);
+		await stopBrowserSession();
+	}
 	const options = {
 		browser: body.browser,
 		headless: body.headless,

package/dist/tabs.js

@@ -1,11 +1,27 @@
-import { a as clearSession, c as importSdk, d as patchExtension, f as resolveOptions, m as saveSession, o as findBrowser, r as cleanExtensionWork, s as getProfileDir, u as loadSession } from "./config.js";
-import { spawn } from "node:child_process";
+import { c as getProfileDir, d as loadSession, f as resolveOptions, i as cleanExtensionWork, l as importSdk, m as saveSession, o as clearSession, s as findBrowser } from "./config.js";
+import { execSync, spawn } from "node:child_process";
 //#region src/scripts/launch-browser.ts
+const BROWSE_AGENT_WEBSTORE_URL = "https://chromewebstore.google.com/detail/browse-agent/amfbnjpgfgappenkkklkogngmoeofeae?authuser=0&hl=zh-CN";
 async function launchBrowser(options = {}) {
 	const { BrowserAgent } = await importSdk();
 	const opts = resolveOptions(options);
-	const extensionWork = patchExtension(opts.port, opts.secret);
 	const profileDir = getProfileDir(opts.browser, opts.useUserProfile ?? true);
+	try {
+		if (process.platform === "win32") execSync("taskkill /F /IM chrome.exe /IM msedge.exe /IM brave.exe 2>nul", { stdio: "ignore" });
+		else if (opts.useUserProfile) for (const processName of {
+			chrome: ["Google Chrome"],
+			chromium: ["Chromium"],
+			edge: ["Microsoft Edge"],
+			brave: ["Brave Browser"]
+		}[opts.browser] || []) execSync(`pkill -x "${processName}" 2>/dev/null || true`, {
+			stdio: "pipe",
+			shell: "/bin/sh"
+		});
+		else execSync(`pkill -f "user-data-dir=${profileDir}" 2>/dev/null || true`, {
+			stdio: "pipe",
+			shell: "/bin/sh"
+		});
+	} catch {}
 	const agent = new BrowserAgent({
 		secret: opts.secret,
 		port: opts.port
@@ -13,9 +29,11 @@ async function launchBrowser(options = {}) {
 	await agent.start();
 	console.error(`[browse-agent] Server started on port ${opts.port}`);
 	const launchArgs = [
-		`--load-extension=${extensionWork}`,
+		`--user-data-dir=${profileDir}`,
 		"--no-first-run",
-		"--no-default-browser-check"
+		"--no-default-browser-check",
+		"--new-window",
+		BROWSE_AGENT_WEBSTORE_URL
 	];
 	if (opts.headless) launchArgs.push("--headless=new");
 	const proc = spawn(findBrowser(opts.browser), launchArgs, {
@@ -33,13 +51,14 @@ async function launchBrowser(options = {}) {
 		secret: opts.secret,
 		browser: opts.browser,
 		profileDir,
-		extensionWork,
+		extensionWork: "chrome-webstore:amfbnjpgfgappenkkklkogngmoeofeae",
 		startedAt: (/* @__PURE__ */ new Date()).toISOString(),
 		_agent: agent,
 		_proc: proc
 	};
 	saveSession(session);
 	console.error(`[browse-agent] Browser launched (PID: ${proc.pid})`);
+	console.error("[browse-agent] Opened Chrome Web Store page. Please click \"Add to Chrome\" if not installed.");
 	return session;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browse-agent-cli",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "description": "TypeScript CLI for browse-agent",
   "main": "./dist/cli.js",

package/skills/SKILL.md

@@ -19,7 +19,13 @@ Control a real Chrome browser to visit web pages, extract content, take screensh
 browse-agent setup
 ```
 
-Auto-detects local vs global mode. The setup checks existing state — if already installed, it exits immediately.
+`setup` now opens the Chrome Web Store page in the selected browser and waits for installation detection.
+
+Important for AI agents:
+- Always remind the user to run `browse-agent setup` before first use.
+- Explicitly remind the user to click **Add to Chrome** on the Web Store page (installation cannot be silent in normal user environments).
+- `setup` exits immediately if it detects the extension is already installed.
+- Do NOT use `--headless` unless the user explicitly asks for headless/silent/background mode. Default launch should always open a visible browser window.
 
 ## Usage Procedure — Step-by-Step (Recommended)
 
@@ -79,8 +85,7 @@ Each step is independent. If the page content isn't what you expected, you can n
 
 | Option | Applies to | Description |
 |---|---|---|
-| `--global` | setup, clear | Use global installation (`~/.browse-agent/`) |
-| `--browser <name>` | launch | `chrome` \| `chromium` \| `edge` \| `brave` (default: chrome) |
+| `--browser <name>` | setup, launch | `chrome` \| `chromium` \| `edge` \| `brave` (default: chrome) |
 | `--headless` | launch | Run without visible window |
 | `--port <number>` | launch, connect, feature cmds | WebSocket port (default: 9315) |
 | `--tabId <id>` | all feature cmds | Target a specific tab (ID from `navigate` or `tabs list`) |
@@ -115,8 +120,7 @@ For full API and script examples, see [API Reference](./references/api.md) and [
 ## Cleanup
 
 ```bash
-browse-agent clear           # remove local installation
-browse-agent clear --global   # remove global installation
+browse-agent clear           # remove local runtime data
 ```
 
 ## References

package/skills/references/cli.md

@@ -11,11 +11,11 @@ browse-agent <command> [options]
 ```bash
 # Setup (install SDK + extension)
 browse-agent setup
-browse-agent setup --global
 
 # Launch browser
 browse-agent launch
 browse-agent launch --browser edge --headless
+browse-agent launch --server-only
 
 # Check connection
 browse-agent connect
@@ -25,7 +25,6 @@ browse-agent close
 
 # Remove installation
 browse-agent clear
-browse-agent clear --global
 ```
 
 ## Feature Commands
@@ -64,9 +63,9 @@ browse-agent tabs close 123
 
 | Option | Applies to | Description |
 |---|---|---|
-| `--global` | setup, clear | Use global installation (`~/.browse-agent/`) |
-| `--browser <name>` | launch | Browser: `chrome` \| `chromium` \| `edge` \| `brave` |
+| `--browser <name>` | launch, setup | Browser: `chrome` \| `chromium` \| `edge` \| `brave` |
 | `--headless` | launch | Run in headless mode |
+| `--server-only` | launch | Start service only, skip browser launch |
 | `--port <number>` | launch, connect, feature cmds | WebSocket port (default: 9315) |
 | `--tabId <id>` | all feature cmds | Target a specific tab (ID from `navigate` or `tabs list`) |
 | `--format <type>` | get-content, screenshot | Content format (`text`/`html`) or screenshot format (`png`/`jpeg`) |