mooncat-browser 0.1.0

package/dist/protocol.d.ts

@@ -0,0 +1,195 @@
+/** 浏览器连接模式。 */
+export type BrowserMode = "extension" | "cdp";
+/** 路由模式：自动检测 / 强制扩展 / 强制 CDP。 */
+export type RouteMode = "auto" | "extension" | "cdp";
+/**
+ * 浏览器句柄。由 open() 返回。
+ * 标识一个已打开的浏览器实例（extension 模式或 CDP 直连）。
+ * 不可变，没有“切当前 tab”的操作。
+ */
+export interface BrowserHandle {
+    /** 连接模式：extension（浏览器扩展）或 cdp（Playwright CDP）。 */
+    mode: BrowserMode;
+    /** 启动通知信息，如 profile 路径、建议等。 */
+    notice?: {
+        level?: "info" | "warn" | "error";
+        message: string;
+    } | string | null;
+    /** 所有者标识。 */
+    ownerId: string;
+    /** CDP 模式的 WebSocket 端点。 */
+    wsEndpoint?: string;
+}
+/**
+ * 标签页句柄。由 newTab()/listTabs() 返回，在 operate() 中作为 pageHandle 传入。
+ * pageId 是 browserd 维护的 page registry key（如 "p1"、"p2"），是 operate 的必备字段。
+ */
+export interface PageHandle {
+    /** 连接模式。 */
+    mode: BrowserMode;
+    /** 内部 pageId，browserd 维护的 page registry key。格式如 "p1"、"p2"。 */
+    pageId: string;
+    /** 标签页 URL。 */
+    url?: string;
+    /** 浏览器 tabId（仅 extension 模式）。 */
+    tabId?: string;
+    /** 所有者标识。 */
+    ownerId?: string;
+}
+/** browser.open() 选项。 */
+export interface BrowserOpenOptions {
+    /** 是否无头启动（仅 CDP 模式生效，扩展模式忽略）。默认 false。 */
+    headless?: boolean;
+    /** 路由模式：auto（自动）/ extension / cdp。默认 auto。 */
+    routeMode?: RouteMode;
+    /** Chrome 可执行文件路径。不传则自动查找。 */
+    executablePath?: string;
+}
+/** 标签页信息（newTab/listTabs/reuseTab 统一返回）。包含 pageHandle（operate 传它）+ 元信息。 */
+export interface TabInfo {
+    /** 标签页句柄（必有 pageId，operate 传它）。 */
+    pageHandle: PageHandle;
+    /** 标签页 URL。 */
+    url?: string;
+    /** 标签页标题。 */
+    title?: string;
+    /** 是否活动标签。 */
+    active?: boolean;
+    /** reuseTab 返回：是否复用了已有 tab。 */
+    reused?: boolean;
+}
+/** browser.newTab() 选项。 */
+export interface BrowserNewTabOptions {
+    /** 新标签页打开的 URL。 */
+    url?: string;
+    /** 强制开新 tab（默认同 host 复用已有 tab）。 */
+    force?: boolean;
+}
+/**
+ * operate 动作参数。
+ * 不同 action 接受的 params 字段不同；常见动作见 browserd 的 rpcOperate（40+ 个动作）。
+ */
+export interface BrowserOperateParams {
+    /** 标签页句柄（由 newTab()/listTabs() 获取，传 tab.pageHandle）。 */
+    pageHandle: PageHandle;
+    /** 动作名。常见：click / fill / type / press / hover / goto / screenshot / snapshot / evaluate 等。 */
+    action: string;
+    /** 动作参数。具体字段因 action 而异。 */
+    params?: Record<string, unknown>;
+}
+/** Cookie 筛选条件。透传到 browserd。 */
+export interface CookieFilter {
+    /** Cookie name 筛选。 */
+    name?: string;
+    /** Cookie domain 筛选。 */
+    domain?: string;
+    /** Cookie path 筛选。 */
+    path?: string;
+    /** 其他筛选条件透传到 browserd。 */
+    [key: string]: unknown;
+}
+/** reuseTab() 选项。 */
+export interface ReuseTabOptions {
+    /** URL 匹配正则。找到第一个 url 匹配的 tab 复用（切过去）；找不到则 newTab。 */
+    urlMatch: RegExp;
+    /** 未匹配时 newTab 打开的 URL。 */
+    url?: string;
+}
+/** waitForDownload() 选项。基于 chrome.downloads API 原生监听。 */
+export interface WaitForDownloadOptions {
+    /** 文件名匹配正则源串（如 "每日数据_.*\\.xlsx$"）。 */
+    filenameRegex?: string;
+    /** 只看 startTime > sinceMs 的下载（下载前时间戳，防止命中旧下载）。 */
+    sinceMs?: number;
+    /** 轮询超时（毫秒）。默认 60000。 */
+    timeoutMs?: number;
+    /** 轮询间隔（毫秒）。默认 2000。 */
+    intervalMs?: number;
+}
+/** 单个下载状态摘要。 */
+export interface DownloadSummary {
+    /** 下载 id（chrome.downloads 分配）。 */
+    id: number;
+    /** 本地文件名（绝对路径）。 */
+    filename: string;
+    /** 下载源 URL。 */
+    url: string;
+    /** 下载状态：进行中/中断/完成。 */
+    state: "in_progress" | "interrupted" | "complete";
+    /** 已接收字节。 */
+    bytesReceived: number;
+    /** 总字节（-1 = 未知）。 */
+    totalBytes: number;
+    /** 文件是否仍存在于磁盘。 */
+    exists: boolean;
+}
+/** waitFor() 选项。通用等待：DOM 节点/文本出现，带刷新重试。 */
+export interface WaitForOptions {
+    /** 标签页句柄。 */
+    tab: PageHandle;
+    /** 目标所在的 frameId（跨域 iframe 内的元素必须传，顶层元素不传）。 */
+    frameId?: number;
+    /** CSS selector 等待出现（与 text 二选一或都传，任一满足即返回）。 */
+    selector?: string;
+    /** 等待页面出现的文本（innerText 含此子串即满足）。 */
+    text?: string;
+    /** 单次轮询总超时（毫秒），到了若未满足触发一次刷新。默认 10000。 */
+    pollTimeoutMs?: number;
+    /** 轮询间隔（毫秒）。默认 1000。 */
+    intervalMs?: number;
+    /** 连续检测不到时，刷新页面重新检测的最大次数。默认 2。 */
+    maxRefresh?: number;
+    /** 刷新后等待页面就绪的时间（毫秒）。默认 5000。 */
+    refreshSettleMs?: number;
+}
+/** waitFor() 结果。 */
+export interface WaitForResult {
+    /** 是否等到（selector 或 text 出现）。 */
+    ok: boolean;
+    /** 实际满足的条件：selector / text。 */
+    matched: "selector" | "text" | null;
+    /** 刷新了几次才等到（0 = 未刷新直接等到）。 */
+    refreshCount: number;
+    /** 总耗时（毫秒）。 */
+    elapsedMs: number;
+}
+/** 待设置的 Cookie。字段对齐 CDP Cookie 协议。 */
+export interface CookieSet {
+    /** Cookie 名称。 */
+    name: string;
+    /** Cookie 值。 */
+    value: string;
+    /** Cookie 作用 URL（CDP 路由需要 url 或 domain）。 */
+    url?: string;
+    /** Cookie 作用 domain。 */
+    domain?: string;
+    /** Cookie 作用 path。默认 "/"。 */
+    path?: string;
+    /** 是否仅 HTTPS。 */
+    secure?: boolean;
+    /** 是否仅 HTTP（不可被 JS 读取）。 */
+    httpOnly?: boolean;
+}
+/** browserd RPC 方法名（与 browserd.cjs 的 switch 一一对应）。 */
+export type RpcMethod = "open" | "newTab" | "listTabs" | "operate" | "getCookies" | "setCookies" | "clearCookies" | "close" | "reuseTab" | "listDownloads" | "getDownload" | "waitForDownload";
+/** RPC 请求信封。 */
+export interface RpcRequest {
+    id: number;
+    method: RpcMethod;
+    params?: Record<string, unknown>;
+}
+/** RPC 成功响应。 */
+export interface RpcOkResponse {
+    id: number;
+    ok: true;
+    result: unknown;
+}
+/** RPC 失败响应。 */
+export interface RpcErrorResponse {
+    id?: number;
+    ok: false;
+    error: string;
+}
+/** RPC 响应（成功或失败）。 */
+export type RpcResponse = RpcOkResponse | RpcErrorResponse;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAUA,eAAe;AACf,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,KAAK,CAAC;AAE9C,iCAAiC;AACjC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,IAAI,EAAE,WAAW,CAAC;IAClB,+BAA+B;IAC/B,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,IAAI,CAAC;IAChF,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yBAAyB;AACzB,MAAM,WAAW,kBAAkB;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,oBAAoB;IACnC,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,UAAU,EAAE,UAAU,CAAC;IACvB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;IAClD,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,oBAAoB;AACpB,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,+BAA+B;IAC/B,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,sDAAsD;AACtD,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,SAAS,GACT,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,OAAO,GACP,UAAU,GACV,eAAe,GACf,aAAa,GACb,iBAAiB,CAAC;AAEtB,gBAAgB;AAChB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,gBAAgB;AAChB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,gBAAgB;AAChB,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAqB;AACrB,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAC"}

package/dist/protocol.js

@@ -0,0 +1,11 @@
+// -*- coding: utf-8 -*-
+// protocol.ts — @mooncat/browser 公共类型契约。
+//
+// 这些类型构成 @mooncat/browser 的公开 contract：
+//   - client / server / cli 共用
+//   - 用户 import { PageHandle, TabInfo, ... } 用于类型标注
+//
+// 设计原则：handle 是纯数据，绝不带方法/路由判断（见 browser co-work 模型）。
+// 路由（extension/CDP）是 browserd 内部的事，handle 只携带 mode/pageId/tabId 等标识。
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,yCAAyC;AACzC,EAAE;AACF,wCAAwC;AACxC,+BAA+B;AAC/B,oDAAoD;AACpD,EAAE;AACF,qDAAqD;AACrD,qEAAqE"}

package/dist/server.d.ts

@@ -0,0 +1,66 @@
+import { type ResolvedConfig } from "./config.js";
+/** browserd.cjs 路径：dist/ 在包根下，browser-op 在包根下。允许用环境变量覆盖（开发态）。 */
+export declare function browserdScriptPath(): string;
+/** wrapper 进程状态文件路径（按 rpcPort 分隔，支持多实例）。 */
+export declare function serviceStatePath(rpcPort: number): string;
+/** wrapper 进程状态（stop 命令据此定位 healthPort）。 */
+export interface ServiceState {
+    pid: number;
+    rpcPort: number;
+    healthPort: number;
+    profile: string;
+    startedAt: string;
+}
+/** 服务运行状态（/health 返回的一部分）。 */
+export interface ServiceStatus {
+    ok: boolean;
+    status: "ok" | "degraded" | "down" | "stopping";
+    rpcPort: number;
+    healthPort: number;
+    browserd: boolean;
+    browserdPid: number | null;
+    lastExit: {
+        code: number | string | null;
+        at: string;
+    } | null;
+    profile: string;
+}
+/**
+ * browserd 服务包装器。
+ *
+ * 用 startService(cfg) 启动；返回的对象含 stop() 用于 graceful 关闭。
+ * 进程信号（SIGINT/SIGTERM）会触发 graceful 关闭。
+ */
+export declare class BrowserService {
+    private readonly cfg;
+    private readonly logStream;
+    private browserd;
+    private lastExit;
+    private stopping;
+    private restartTimer;
+    private healthServer;
+    private shuttingDown;
+    constructor(cfg: ResolvedConfig);
+    private log;
+    /** 启动 wrapper：spawn browserd + 起 health server + 写 pidfile + 注册信号。 */
+    start(): Promise<void>;
+    /** spawn browserd 子进程（崩溃自动重启，除非 stopping）。 */
+    private startBrowserd;
+    /** 查询当前状态（代理 browserd /health + wrapper 状态）。 */
+    status(): Promise<ServiceStatus>;
+    /**
+     * Graceful 关闭：
+     *   1. 标记 stopping（阻止重启）
+     *   2. 发 close 给 browserd（browserd graceful 关 Chrome，保留登录态）
+     *   3. 等 browserd 退出（最多 10s），仍未退则 kill
+     *   4. 关 health server + 删 pidfile + exit
+     */
+    stop(): Promise<void>;
+    /** 等 browserd 子进程退出，最多 timeoutMs；超时则 SIGKILL。 */
+    private waitForBrowserdExit;
+}
+/** 便捷入口：解析配置并启动 wrapper（CLI start 命令调用）。 */
+export declare function startService(cfg: ResolvedConfig): Promise<BrowserService>;
+/** 读取已运行 wrapper 的状态（用于 stop 命令定位 healthPort）。 */
+export declare function readServiceState(rpcPort: number): ServiceState | null;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAuBA,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAI3E,iEAAiE;AACjE,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAED,4CAA4C;AAC5C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,8BAA8B;AAC9B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAA6D;IAC7E,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,YAAY,CAAS;gBAEjB,GAAG,EAAE,cAAc;IAM/B,OAAO,CAAC,GAAG;IAUX,sEAAsE;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C5B,8CAA8C;IAC9C,OAAO,CAAC,aAAa;IA0BrB,gDAAgD;IAC1C,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC;IA8BtC;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C3B,iDAAiD;IACjD,OAAO,CAAC,mBAAmB;CAsB5B;AAED,4CAA4C;AAC5C,wBAAsB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAI/E;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CASrE"}

package/dist/server.js

@@ -0,0 +1,259 @@
+// -*- coding: utf-8 -*-
+// server.ts — @mooncat/browser 服务包装层。
+//
+// 形态（与原 mooncat services/browser/main.cjs 一致，迁移风险最低）：
+//
+//   mooncat-browser start
+//     -> 启动本 wrapper（health server on healthPort）
+//     -> wrapper spawn browserd.cjs（RPC on rpcPort）
+//     -> GET  /health   代理 browserd /health + wrapper 状态
+//     -> POST /shutdown graceful：发 close 给 browserd（graceful 关 Chrome），
+//                                  等其退出，wrapper 退出（不重启）
+//
+// browserd 崩溃（非 shutdown）时 wrapper 自动 3s 后重启。
+//
+// 注意：browserd.cjs 是原 mooncat libs/browser 的核心，原样复制，不改其内部逻辑。
+// wrapper 通过环境变量（BROWSERD_PORT / BROWSER_OP_USERDATA / BROWSER_OP_CHROME_PATH）
+// 把本包的配置语义桥接给 browserd。
+import http from "node:http";
+import { spawn } from "node:child_process";
+import { createWriteStream, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { appDataDir, browserdEnv } from "./config.js";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+/** browserd.cjs 路径：dist/ 在包根下，browser-op 在包根下。允许用环境变量覆盖（开发态）。 */
+export function browserdScriptPath() {
+    return (process.env.MOONCAT_BROWSERD_BIN ||
+        join(__dirname, "..", "browser-op", "backend", "browserd.cjs"));
+}
+/** wrapper 进程状态文件路径（按 rpcPort 分隔，支持多实例）。 */
+export function serviceStatePath(rpcPort) {
+    return join(appDataDir(), `service-${rpcPort}.json`);
+}
+/**
+ * browserd 服务包装器。
+ *
+ * 用 startService(cfg) 启动；返回的对象含 stop() 用于 graceful 关闭。
+ * 进程信号（SIGINT/SIGTERM）会触发 graceful 关闭。
+ */
+export class BrowserService {
+    cfg;
+    logStream;
+    browserd = null;
+    lastExit = null;
+    stopping = false;
+    restartTimer = null;
+    healthServer = null;
+    shuttingDown = false;
+    constructor(cfg) {
+        this.cfg = cfg;
+        mkdirSync(this.cfg.logsDir, { recursive: true });
+        this.logStream = createWriteStream(join(this.cfg.logsDir, "service.log"), { flags: "a" });
+    }
+    log(msg) {
+        const line = `[${new Date().toISOString()}] ${msg}`;
+        console.error(line);
+        try {
+            this.logStream.write(line + "\n");
+        }
+        catch {
+            /* 日志写入失败不阻塞主流程 */
+        }
+    }
+    /** 启动 wrapper：spawn browserd + 起 health server + 写 pidfile + 注册信号。 */
+    async start() {
+        const state = {
+            pid: process.pid,
+            rpcPort: this.cfg.rpcPort,
+            healthPort: this.cfg.healthPort,
+            profile: this.cfg.profile,
+            startedAt: new Date().toISOString(),
+        };
+        writeFileSync(serviceStatePath(this.cfg.rpcPort), JSON.stringify(state, null, 2), "utf8");
+        this.log(`service wrapper started pid=${process.pid} (rpc :${this.cfg.rpcPort}, health :${this.cfg.healthPort})`);
+        this.startBrowserd();
+        this.healthServer = http.createServer(async (req, res) => {
+            res.setHeader("Content-Type", "application/json");
+            if (req.method === "GET" && req.url === "/health") {
+                res.end(JSON.stringify(await this.status()));
+                return;
+            }
+            if (req.method === "POST" && req.url === "/shutdown") {
+                res.end(JSON.stringify({ ok: true, message: "shutting down" }));
+                this.stop().catch((e) => this.log(`stop error: ${e.message}`));
+                return;
+            }
+            res.statusCode = 404;
+            res.end(JSON.stringify({ ok: false, error: "not found" }));
+        });
+        await new Promise((resolve, reject) => {
+            this.healthServer.listen(this.cfg.healthPort, "127.0.0.1", resolve);
+            this.healthServer.on("error", (e) => reject(e));
+        });
+        this.log(`health listening on http://127.0.0.1:${this.cfg.healthPort}/health`);
+        // 信号 → graceful 关闭
+        const shutdownSignal = (sig) => () => {
+            this.log(`received ${sig}`);
+            this.stop().catch((e) => this.log(`stop error: ${e.message}`));
+        };
+        process.on("SIGINT", shutdownSignal("SIGINT"));
+        process.on("SIGTERM", shutdownSignal("SIGTERM"));
+    }
+    /** spawn browserd 子进程（崩溃自动重启，除非 stopping）。 */
+    startBrowserd() {
+        const env = { ...process.env, ...browserdEnv(this.cfg) };
+        this.browserd = spawn(process.execPath, [browserdScriptPath()], {
+            cwd: process.cwd(),
+            env,
+            stdio: "inherit",
+        });
+        this.log(`browserd started pid=${this.browserd.pid} (rpc :${this.cfg.rpcPort})`);
+        this.browserd.on("exit", (code, signal) => {
+            this.lastExit = { code: code != null ? code : signal, at: new Date().toISOString() };
+            this.log(`browserd exited code=${code} signal=${signal}`);
+            this.browserd = null;
+            if (this.stopping) {
+                // 主动关闭触发的退出，不重启；由 stop() 继续收尾
+                return;
+            }
+            // 非主动退出 → 3s 后重启
+            this.restartTimer = setTimeout(() => {
+                if (this.stopping)
+                    return;
+                this.log(`browserd restarting (auto)`);
+                this.startBrowserd();
+            }, 3000);
+        });
+    }
+    /** 查询当前状态（代理 browserd /health + wrapper 状态）。 */
+    async status() {
+        let browserdUp = false;
+        try {
+            const resp = await fetch(`http://127.0.0.1:${this.cfg.rpcPort}/health`);
+            if (resp.ok) {
+                await resp.text();
+                browserdUp = true;
+            }
+        }
+        catch {
+            browserdUp = false;
+        }
+        const status = this.stopping
+            ? "stopping"
+            : browserdUp
+                ? "ok"
+                : this.lastExit
+                    ? "degraded"
+                    : "down";
+        return {
+            ok: status === "ok",
+            status,
+            rpcPort: this.cfg.rpcPort,
+            healthPort: this.cfg.healthPort,
+            browserd: browserdUp,
+            browserdPid: this.browserd?.pid ?? null,
+            lastExit: this.lastExit,
+            profile: this.cfg.profile,
+        };
+    }
+    /**
+     * Graceful 关闭：
+     *   1. 标记 stopping（阻止重启）
+     *   2. 发 close 给 browserd（browserd graceful 关 Chrome，保留登录态）
+     *   3. 等 browserd 退出（最多 10s），仍未退则 kill
+     *   4. 关 health server + 删 pidfile + exit
+     */
+    async stop() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        this.stopping = true;
+        if (this.restartTimer) {
+            clearTimeout(this.restartTimer);
+            this.restartTimer = null;
+        }
+        this.log(`graceful shutdown begin`);
+        // 1) 发 close 给 browserd（graceful 关 Chrome）
+        try {
+            const body = JSON.stringify({ id: 1, method: "close", params: {} });
+            await fetch(`http://127.0.0.1:${this.cfg.rpcPort}/rpc`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", "Content-Length": String(Buffer.byteLength(body)) },
+                body,
+            });
+        }
+        catch (e) {
+            this.log(`close rpc failed (browserd may already be down): ${e.message}`);
+        }
+        // 2) 等 browserd 退出
+        await this.waitForBrowserdExit(10000);
+        // 3) 关 health server
+        await new Promise((resolve) => {
+            if (!this.healthServer)
+                return resolve();
+            this.healthServer.close(() => resolve());
+            setTimeout(resolve, 1000);
+        });
+        // 4) 删 pidfile + exit
+        try {
+            unlinkSync(serviceStatePath(this.cfg.rpcPort));
+        }
+        catch {
+            /* ignore */
+        }
+        this.log(`graceful shutdown complete`);
+        try {
+            this.logStream.end();
+        }
+        catch {
+            /* ignore */
+        }
+        process.exit(0);
+    }
+    /** 等 browserd 子进程退出，最多 timeoutMs；超时则 SIGKILL。 */
+    waitForBrowserdExit(timeoutMs) {
+        return new Promise((resolve) => {
+            if (!this.browserd)
+                return resolve();
+            const done = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            this.browserd.once("exit", done);
+            const timer = setTimeout(() => {
+                if (this.browserd) {
+                    this.log(`browserd did not exit in ${timeoutMs}ms, killing`);
+                    try {
+                        this.browserd.kill("SIGKILL");
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+                // 给 kill 一点时间
+                setTimeout(done, 500);
+            }, timeoutMs);
+        });
+    }
+}
+/** 便捷入口：解析配置并启动 wrapper（CLI start 命令调用）。 */
+export async function startService(cfg) {
+    const svc = new BrowserService(cfg);
+    await svc.start();
+    return svc;
+}
+/** 读取已运行 wrapper 的状态（用于 stop 命令定位 healthPort）。 */
+export function readServiceState(rpcPort) {
+    const f = serviceStatePath(rpcPort);
+    if (!existsSync(f))
+        return null;
+    try {
+        const obj = JSON.parse(readFileSync(f, "utf8"));
+        return obj && typeof obj === "object" && obj.pid ? obj : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "mooncat-browser",
+  "version": "0.1.0",
+  "description": "浏览器自动化工具包：可独立启动的本地服务（browserd）+ JS/TS client。双路由（WebPlater 扩展 / CDP），不依赖 mooncat 总发行体。",
+  "type": "module",
+  "main": "./dist/client.js",
+  "module": "./dist/client.js",
+  "types": "./dist/client.d.ts",
+  "bin": {
+    "mooncat-browser": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./schemas/*": "./schemas/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "browser-op",
+    "schemas",
+    "skills",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "npm run build:ts && npm run build:docs && npm run build:extension",
+    "build:ts": "tsc",
+    "build:docs": "node scripts/generate-actions.mjs",
+    "build:extension": "cd browser-op/webplater && pnpm install --frozen-lockfile && pnpm run build",
+    "clean": "node scripts/clean.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build:ts"
+  },
+  "dependencies": {
+    "cheerio": "^1.2.0",
+    "commander": "^12.1.0",
+    "playwright-core": "^1.61.0",
+    "turndown": "^7.2.0",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "browser",
+    "automation",
+    "playwright",
+    "chrome",
+    "cdp",
+    "web-automation",
+    "mooncat"
+  ],
+  "license": "MIT"
+}

package/schemas/browser.clearCookies.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mooncat/sdk/browser.clearCookies.schema.json",
+  "title": "browser.clearCookies",
+  "description": "browser.clearCookies input",
+  "type": "object",
+  "properties": {
+    "filter": {
+      "type": null
+    }
+  },
+  "required": []
+}

package/schemas/browser.close.schema.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://mooncat/sdk/browser.close.schema.json",
+  "title": "browser.close",
+  "description": "关闭浏览器",
+  "type": "object",
+  "properties": {},
+  "required": []
+}