mooncat-browser 0.1.0

package/dist/cli.js

@@ -0,0 +1,278 @@
+// -*- coding: utf-8 -*-
+// cli.ts — mooncat-browser 命令行入口。
+//
+// 命令：
+//   mooncat-browser start [--port 17322] [--profile D:\p] [--chrome path] [--health-port 17440]
+//   mooncat-browser health [--port 17322]
+//   mooncat-browser stop [--port 17322]
+//   mooncat-browser open --url <url> [--port 17322]
+//   mooncat-browser install-extension
+//   mooncat-browser skills [--skill <name>] [--target <dir>] [--list]
+//
+// --port 语义 = browserd RPC 端口（client 连这里，默认 17322）。
+// start 还会顺带起一个 wrapper health 端口（--health-port，默认 17440），供 stop/监控用。
+import { Command } from "commander";
+import { createRequire } from "node:module";
+import { resolveConfig } from "./config.js";
+import { BrowserClient } from "./client.js";
+import { startService, readServiceState, serviceStatePath, browserdScriptPath } from "./server.js";
+import { fileURLToPath } from "node:url";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+const require = createRequire(import.meta.url);
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+/** webplater 扩展已构建产物目录（install-extension 指向这里）。 */
+function extensionDistDir() {
+    return process.env.MOONCAT_BROWSER_EXTENSION || join(__dirname, "..", "browser-op", "webplater", "dist", "chrome-mv3");
+}
+function printHeader(title) {
+    console.log(`\n[mooncat-browser] ${title}`);
+}
+/** 构造 client（按 --port / env / default）。 */
+function makeClient(port) {
+    return new BrowserClient({ port });
+}
+/** 轮询 rpcPort，直到连不上（browserd 已退）或超时。返回 true 表示已退出。 */
+async function waitForExit(rpcPort, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        try {
+            await fetch(`http://127.0.0.1:${rpcPort}/health`, {
+                signal: AbortSignal.timeout(1000),
+            });
+            // 还活着，继续等
+        }
+        catch {
+            return true; // 连不上 = 已退
+        }
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    return false;
+}
+async function run() {
+    const program = new Command();
+    program
+        .name("mooncat-browser")
+        .description("浏览器自动化工具包：可独立启动的本地服务 + JS/TS client")
+        .version(getVersion());
+    // ─── start ──────────────────────────────────────────────────────────────
+    program
+        .command("start")
+        .description("启动 browser 服务（wrapper + browserd 常驻）")
+        .option("-p, --port <port>", "browserd RPC 端口（client 连这里，默认 17322）", (v) => Number(v))
+        .option("--rpc-port <port>", "同 --port", (v) => Number(v))
+        .option("--health-port <port>", "wrapper health 端口（默认 17440）", (v) => Number(v))
+        .option("--profile <path>", "Chrome user-data-dir（默认 %LOCALAPPDATA%\\mooncat-browser\\profile）")
+        .option("--chrome <path>", "Chrome 可执行文件路径（不传则自动探测）")
+        .action(async (opts) => {
+        const cfg = resolveConfig({
+            port: opts.port ?? opts.rpcPort,
+            healthPort: opts.healthPort,
+            profile: opts.profile,
+            chromePath: opts.chrome,
+        });
+        printHeader(`starting service`);
+        console.log(`  rpc port    : ${cfg.rpcPort}  (clients connect here)`);
+        console.log(`  health port : ${cfg.healthPort}`);
+        console.log(`  profile     : ${cfg.profile}`);
+        console.log(`  chrome      : ${cfg.chromePath || "(auto-detect)"}`);
+        console.log(`  logs        : ${cfg.logsDir}`);
+        console.log(`  browserd    : ${browserdScriptPath()}`);
+        try {
+            await startService(cfg);
+            console.log(`\n  service running. Ctrl+C to stop, or: mooncat-browser stop --port ${cfg.rpcPort}`);
+        }
+        catch (e) {
+            console.error(`\n  [ERROR] failed to start: ${e.message}`);
+            process.exit(1);
+        }
+    });
+    // ─── health ─────────────────────────────────────────────────────────────
+    program
+        .command("health")
+        .description("探测 browserd 是否就绪 + 是否已 open")
+        .option("-p, --port <port>", "browserd RPC 端口（默认 17322）", (v) => Number(v))
+        .action(async (opts) => {
+        const client = makeClient(opts.port);
+        const h = await client.health();
+        if (!h) {
+            console.error(`\n[mooncat-browser] browserd not reachable at ${client.baseUrl}`);
+            console.error(`  hint: run \`mooncat-browser start\` first`);
+            process.exit(1);
+        }
+        printHeader(`health @ ${client.baseUrl}`);
+        console.log(JSON.stringify(h, null, 2));
+    });
+    // ─── stop ───────────────────────────────────────────────────────────────
+    program
+        .command("stop")
+        .description("graceful 停止服务（关闭 Chrome + 退出 wrapper，不重启）")
+        .option("-p, --port <port>", "browserd RPC 端口（默认 17322）", (v) => Number(v))
+        .action(async (opts) => {
+        const cfg = resolveConfig({ port: opts.port });
+        const state = readServiceState(cfg.rpcPort);
+        const healthPort = state?.healthPort ?? cfg.healthPort;
+        printHeader(`stopping service (rpc :${cfg.rpcPort})`);
+        // 1) 优先走 wrapper /shutdown（wrapper 协调 graceful 关闭 + 不重启）
+        //    healthPort 从 start 时持久化的状态文件读，避免 CLI 覆盖不一致。
+        let viaWrapper = false;
+        try {
+            const resp = await fetch(`http://127.0.0.1:${healthPort}/shutdown`, { method: "POST" });
+            if (resp.ok) {
+                viaWrapper = true;
+                console.log(`  shutdown sent to wrapper (pid=${state?.pid ?? "?"}, health :${healthPort})`);
+            }
+        }
+        catch {
+            /* wrapper 不在，回落到直接关 browserd */
+        }
+        // 2) wrapper 不在 → 直接发 close 给 browserd
+        if (!viaWrapper) {
+            try {
+                const client = new BrowserClient({ port: cfg.rpcPort });
+                await client.close();
+                console.log(`  close sent directly to browserd (wrapper not running)`);
+            }
+            catch (e) {
+                console.error(`  [WARN] direct close failed: ${e.message}`);
+            }
+        }
+        // 3) 等 browserd 退出（最多 ~12s）
+        const gone = await waitForExit(cfg.rpcPort, 12000);
+        console.log(`  browserd ${gone ? "stopped" : "still alive (may be restarting or stuck)"}`);
+        // 4) 清理可能残留的状态文件
+        try {
+            if (existsSync(serviceStatePath(cfg.rpcPort))) {
+                const { unlinkSync } = await import("node:fs");
+                unlinkSync(serviceStatePath(cfg.rpcPort));
+                console.log(`  removed stale state file`);
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        console.log(`  done. (Chrome closed gracefully, login state preserved)`);
+    });
+    // ─── open ───────────────────────────────────────────────────────────────
+    program
+        .command("open")
+        .description("连接已运行的服务，打开/复用浏览器并导航到 URL")
+        .requiredOption("-u, --url <url>", "要打开的 URL")
+        .option("-p, --port <port>", "browserd RPC 端口（默认 17322）", (v) => Number(v))
+        .option("--headless", "无头模式（仅 CDP 路生效）")
+        .action(async (opts) => {
+        const client = makeClient(opts.port);
+        const h = await client.health();
+        if (!h) {
+            console.error(`\n[mooncat-browser] browserd not reachable at ${client.baseUrl}`);
+            console.error(`  hint: run \`mooncat-browser start\` first`);
+            process.exit(1);
+        }
+        if (!h.open && !h.browserOpen) {
+            await client.open({ headless: !!opts.headless });
+            console.log(`  browser opened`);
+        }
+        const tab = await client.newTab({ url: opts.url });
+        printHeader(`opened`);
+        console.log(`  url         : ${opts.url}`);
+        console.log(`  pageHandle  : ${JSON.stringify(tab.pageHandle)}`);
+        console.log(`  reused      : ${tab.reused ?? false}`);
+    });
+    // ─── install-extension ──────────────────────────────────────────────────
+    program
+        .command("install-extension")
+        .description("打印 WebPlater 扩展路径 + Load unpacked 指引")
+        .action(() => {
+        const dir = extensionDistDir();
+        printHeader(`install WebPlater extension`);
+        if (!existsSync(dir)) {
+            console.error(`  extension not built at: ${dir}`);
+            console.error(`  rebuild with: \`npm run build:extension\` (requires pnpm + network)`);
+            process.exit(1);
+        }
+        console.log(`  extension dir : ${dir}`);
+        console.log(`\n  Chrome -> chrome://extensions`);
+        console.log(`  1. enable "Developer mode" (top right)`);
+        console.log(`  2. click "Load unpacked"`);
+        console.log(`  3. select the directory above`);
+        console.log(`\n  装扩展后，重启浏览器（close + open）才会切到 extension 路由。`);
+    });
+    // ─── skills ─────────────────────────────────────────────────────────────
+    program
+        .command("skills")
+        .description("安装/更新内置 skills 到 ~/.agents/skills（覆盖同名，幂等可重复执行）")
+        .option("-s, --skill <name>", "只安装指定 skill（默认全部）")
+        .option("-t, --target <dir>", "自定义目标目录（默认 ~/.agents/skills）")
+        .option("--list", "只列出包内的 skills，不拷贝")
+        .action((opts) => {
+        const srcRoot = skillsSourceDir();
+        if (!existsSync(srcRoot)) {
+            console.error(`\n[mooncat-browser] skills 源不存在: ${srcRoot}`);
+            console.error(`  hint: 包发布时可能漏了 skills/ 目录`);
+            process.exit(1);
+        }
+        // 列出源里的 skill 子目录（每个含 SKILL.md）
+        const names = readdirSync(srcRoot, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .filter((d) => existsSync(join(srcRoot, d.name, "SKILL.md")))
+            .map((d) => d.name);
+        if (opts.list) {
+            printHeader(`available skills (${srcRoot})`);
+            for (const n of names)
+                console.log(`  ${n}`);
+            return;
+        }
+        const requested = opts.skill ? [opts.skill] : names;
+        const missing = requested.filter((n) => !names.includes(n));
+        if (missing.length) {
+            console.error(`\n[mooncat-browser] skill 不存在: ${missing.join(", ")}`);
+            console.error(`  可用: ${names.join(", ") || "(无)"}`);
+            process.exit(1);
+        }
+        const destRoot = opts.target || defaultSkillsTarget();
+        mkdirSync(destRoot, { recursive: true });
+        printHeader(`install skills -> ${destRoot}`);
+        for (const n of requested) {
+            const src = join(srcRoot, n);
+            const dest = join(destRoot, n);
+            // 先清空目标 skill 目录再拷贝，保证与源完全一致（删除源里已移除的旧文件，如重命名后的残留）
+            rmSync(dest, { recursive: true, force: true });
+            cpSync(src, dest, { recursive: true, force: true });
+            console.log(`  [ok] ${n} -> ${dest}`);
+        }
+        console.log(`\n  ${requested.length} skill(s) installed. 重启 agent 后生效。`);
+    });
+    await program.parseAsync(process.argv);
+}
+/** 包内 skills 源目录：dist/cli.js -> ../skills；源码运行 -> ../../skills。 */
+function skillsSourceDir() {
+    return process.env.MOONCAT_BROWSER_SKILLS_SRC || join(__dirname, "..", "skills");
+}
+/** skills 安装默认目标：~/.agents/skills（跨平台 homedir()）。 */
+function defaultSkillsTarget() {
+    return join(homedir(), ".agents", "skills");
+}
+function getVersion() {
+    // 编译后 dist/cli.js 读 ../package.json；源码运行时读 ../../package.json
+    // 统一用相对包根查找（容忍 dist/ 与 src/ 两种位置）
+    const candidates = [
+        join(__dirname, "..", "package.json"),
+        join(__dirname, "..", "..", "package.json"),
+    ];
+    for (const p of candidates) {
+        try {
+            if (existsSync(p))
+                return require(p).version || "0.0.0";
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    return "0.0.0";
+}
+run().catch((e) => {
+    console.error(`[mooncat-browser] fatal: ${e.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,94 @@
+import type { BrowserHandle, BrowserNewTabOptions, BrowserOpenOptions, BrowserOperateParams, CookieFilter, CookieSet, DownloadSummary, ReuseTabOptions, TabInfo, WaitForDownloadOptions, WaitForOptions, WaitForResult } from "./protocol.js";
+/** BrowserClient 构造选项。 */
+export interface BrowserClientOptions {
+    /**
+     * browserd 的 baseUrl，如 "http://127.0.0.1:17322"。
+     * 与 port 二选一；baseUrl 优先。
+     */
+    baseUrl?: string;
+    /** browserd RPC 端口（仅 host=127.0.0.1）。与 baseUrl 二选一。 */
+    port?: number;
+    /** 自定义 host（默认 127.0.0.1）。一般不改。 */
+    host?: string;
+    /** 默认 RPC 超时（毫秒）。默认 60000。单个方法可覆盖。 */
+    timeoutMs?: number;
+}
+/**
+ * 浏览器自动化 client。
+ *
+ * 通过 HTTP JSON-RPC 连接 browserd，控制宿主 Chrome。
+ * 不依赖 workspace / mooncat 发行体 / PM2 —— 只是一个 HTTP client。
+ */
+export declare class BrowserClient {
+    private readonly host;
+    private readonly port;
+    private readonly defaultTimeoutMs;
+    private reqId;
+    constructor(opts?: BrowserClientOptions);
+    /** 当前连接的 baseUrl（用于日志/诊断）。 */
+    get baseUrl(): string;
+    /** 连接探测：browserd 是否活着 + 是否已 open。返回 /health 响应，或 null。 */
+    health(timeoutMs?: number): Promise<Record<string, unknown> | null>;
+    /** 发一个 JSON-RPC 请求，返回 result 或 throw。 */
+    private rpc;
+    /** 打开浏览器（宿主 Chrome，双路由自动选择 extension/cdp）。 */
+    open(options?: BrowserOpenOptions): Promise<BrowserHandle>;
+    /** 新建标签页。默认同 host 复用已有 tab（导航+激活），force:true 强制开新 tab。 */
+    newTab(options?: BrowserNewTabOptions): Promise<TabInfo>;
+    /** 列出所有标签页（每项 pageHandle 必有 pageId）。 */
+    listTabs(): Promise<TabInfo[]>;
+    /** 在页面上执行动作（click/fill/goto/snapshot/evaluate/...，40+ 个 action）。 */
+    operate(params: BrowserOperateParams): Promise<unknown>;
+    /** 获取 cookies。 */
+    getCookies(filter?: CookieFilter): Promise<{
+        cookies: CookieSet[];
+    }>;
+    /** 设置 cookies。 */
+    setCookies(cookies: CookieSet[]): Promise<{
+        ok: boolean;
+        count: number;
+    }>;
+    /** 清除 cookies。 */
+    clearCookies(filter?: CookieFilter): Promise<unknown>;
+    /** 关闭浏览器（graceful，保留登录态）。 */
+    close(): Promise<{
+        ok: boolean;
+        closed: boolean;
+    }>;
+    /**
+     * 复用 tab：按 urlMatch 找已开的 tab，有则切过去复用，无则 newTab(url)。
+     * 高危平台频繁重开页面触发风控，已开的 tab 应复用。
+     */
+    reuseTab(options: ReuseTabOptions): Promise<TabInfo & {
+        reused: boolean;
+    }>;
+    /** 列出最近下载（chrome.downloads.search 实时查，默认最近 20 条；仅 extension 模式）。 */
+    listDownloads(limit?: number): Promise<{
+        downloads: DownloadSummary[];
+    }>;
+    /** 查单个下载状态（by id；仅 extension 模式）。 */
+    getDownload(id: number): Promise<{
+        download: DownloadSummary | null;
+    }>;
+    /**
+     * 轮询等下载完成（基于 chrome.downloads 原生状态，不轮询目录）。
+     * 点了下载按钮后调用，按 filenameRegex + sinceMs 匹配，等 state=complete。
+     * 返回 { download, reason }：reason=complete 成功，timeout 超时。
+     */
+    waitForDownload(options: WaitForDownloadOptions): Promise<{
+        download: DownloadSummary | null;
+        reason: string;
+    }>;
+    /**
+     * 通用等待：DOM 节点（selector）或文本（text）出现。
+     * 延迟重试（轮询）+ 刷新重试（检测不到刷新页面重来）+ 连续 maxRefresh 次仍未出现则返回 ok:false。
+     * 适用于 SPA 异步加载的元素，比 sleep 固定等待更稳。frameId 指定时在对应 iframe 内检测/刷新。
+     */
+    waitFor(options: WaitForOptions): Promise<WaitForResult>;
+}
+/**
+ * 默认导出的便捷工厂：等价于 `new BrowserClient(opts)`。
+ * 便于 `import { browser } from "@mooncat/browser"` 后直接用。
+ */
+export declare function createBrowser(opts?: BrowserClientOptions): BrowserClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,eAAe,EAEf,OAAO,EACP,sBAAsB,EACtB,cAAc,EACd,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,0BAA0B;AAC1B,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,KAAK,CAAK;gBAEN,IAAI,GAAE,oBAAyB;IAY3C,8BAA8B;IAC9B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,0DAA0D;IAC1D,MAAM,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IA6BjE,yCAAyC;IACzC,OAAO,CAAC,GAAG;IA6CX,8CAA8C;IACxC,IAAI,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpE,0DAA0D;IACpD,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlE,wCAAwC;IAClC,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAmBpC,oEAAoE;IAC9D,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7D,kBAAkB;IACZ,UAAU,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAI9E,kBAAkB;IACZ,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/E,kBAAkB;IACZ,YAAY,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/D,6BAA6B;IACvB,KAAK,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAIxD;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;IAOhF,oEAAoE;IAC9D,aAAa,CAAC,KAAK,SAAK,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAI1E,qCAAqC;IAC/B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAAC;IAI5E;;;;OAIG;IACG,eAAe,CACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;QAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQhE;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAsF/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,aAAa,CAExE"}