@downcity/plugins 1.0.246 → 1.0.252

package/bin/web/types/WebPlugin.d.ts

@@ -1,73 +1,223 @@
 /**
- * WebPlugin 协议类型。
+ * WebPlugin 的公开协议类型。
  *
  * 关键点（中文）
- * - web plugin 只注入联网方法论，不维护 provider 运行态。
- * - install action 只返回安装提示，不执行命令或修改文件。
- * - target 表示需要安装说明的联网能力，不表示 agent 运行时默认选择。
+ * - WebPlugin 只定义联网能力的稳定边界，不绑定搜索服务、浏览器云厂商或模型。
+ * - 浏览器 provider 负责 session 的创建、观察、动作执行和关闭。
+ * - 所有 action 返回值都保持 JSON 可序列化，避免把 Playwright 对象泄漏到 Agent 内核。
  */
 import type { JsonObject } from "@downcity/agent";
-/**
- * WebPlugin action 名称常量。
- */
+/** WebPlugin 对外 action 名称。 */
 export declare const WEB_PLUGIN_ACTIONS: {
-    /**
-     * 返回联网能力的安装操作提示。
-     */
-    readonly install: "install";
+    /** 搜索公开网页或索引。 */
+    readonly search: "search";
+    /** 打开已知 URL 并读取文档。 */
+    readonly open: "open";
+    /** 创建浏览器 session。 */
+    readonly browser_create_session: "browser_create_session";
+    /** 读取浏览器当前状态。 */
+    readonly browser_observe: "browser_observe";
+    /** 执行一个确定性的浏览器动作。 */
+    readonly browser_act: "browser_act";
+    /** 执行一个由语义 provider 解释的自然语言动作。 */
+    readonly browser_semantic_act: "browser_semantic_act";
+    /** 从当前浏览器页面抽取文本。 */
+    readonly browser_extract: "browser_extract";
+    /** 使用语义 provider 抽取页面内容。 */
+    readonly browser_semantic_extract: "browser_semantic_extract";
+    /** 关闭浏览器 session。 */
+    readonly browser_close_session: "browser_close_session";
 };
-/**
- * WebPlugin 安装提示目标。
- */
-export type WebPluginInstallTarget = "web-access" | "agent-browser" | "all";
-/**
- * agent-browser CLI 安装作用域。
- */
-export type WebPluginInstallScope = "user" | "project";
-/**
- * WebPlugin install 提示 action 输入。
- */
-export interface WebPluginInstallPayload {
-    /**
-     * 需要获取安装说明的联网能力。
-     *
-     * 说明（中文）
-     * - `web-access`：返回 web-access Skill 的安装工作流。
-     * - `agent-browser`：返回 agent-browser Skill 与 CLI 的安装工作流。
-     * - `all`：返回以上全部能力的安装工作流。
-     * - 默认值为 `web-access`。
-     */
-    target?: WebPluginInstallTarget;
-    /**
-     * agent-browser CLI 的安装作用域。
-     *
-     * 说明（中文）
-     * - `user`：提示 Agent 将 CLI 安装到 npm 全局环境。
-     * - `project`：提示 Agent 使用项目已有的包管理器安装 devDependency。
-     * - Skill 安装位置由 SkillPlugin 的扫描配置决定，不受此字段控制。
-     * - 默认值为 `user`。
-     */
-    scope?: WebPluginInstallScope;
+/** WebPlugin action 名称联合类型。 */
+export type WebPluginActionName = (typeof WEB_PLUGIN_ACTIONS)[keyof typeof WEB_PLUGIN_ACTIONS];
+/** 搜索 action 输入。 */
+export interface WebSearchInput {
+    /** 用户要检索的自然语言查询。 */
+    query: string;
+    /** 最多返回的结果数量，provider 可自行设置上限。 */
+    limit?: number;
+    /** 只搜索这些域名；不传时由 provider 决定搜索范围。 */
+    domains?: string[];
 }
-/**
- * WebPlugin install action 返回的安装提示数据。
- */
-export interface WebPluginInstallInstructions extends JsonObject {
-    /**
-     * 标识当前结果只包含操作说明。
-     */
-    kind: "instructions";
-    /**
-     * 已归一化的联网能力目标。
-     */
-    target: WebPluginInstallTarget;
-    /**
-     * 已归一化的 agent-browser CLI 安装作用域。
-     */
-    scope: WebPluginInstallScope;
-    /**
-     * 提供给 Agent 执行的完整安装说明。
-     */
-    prompt: string;
+/** 单条搜索结果。 */
+export interface WebSearchItem extends JsonObject {
+    /** 结果页面的规范 URL。 */
+    url: string;
+    /** 页面标题。 */
+    title: string | null;
+    /** 搜索 provider 返回的摘要。 */
+    snippet: string | null;
+    /** provider 给出的相关性分数。 */
+    score: number | null;
+}
+/** 搜索 action 返回值。 */
+export interface WebSearchResult extends JsonObject {
+    /** 实际使用的 provider 名称。 */
+    provider: string;
+    /** 搜索结果列表。 */
+    items: WebSearchItem[];
+}
+/** 已知 URL 打开输入。 */
+export interface WebOpenInput {
+    /** 要读取的 HTTP(S) URL。 */
+    url: string;
+    /** 返回正文的最大字符数。 */
+    max_chars?: number;
+}
+/** 已知 URL 打开返回值。 */
+export interface WebOpenResult extends JsonObject {
+    /** 实际使用的 provider 名称。 */
+    provider: string;
+    /** 最终读取到的 URL。 */
+    url: string;
+    /** 页面标题。 */
+    title: string | null;
+    /** 页面正文或 provider 生成的 Markdown。 */
+    content: string;
+}
+/** 浏览器 session 创建输入。 */
+export interface BrowserCreateSessionInput {
+    /** 创建后立即打开的 URL。 */
+    url?: string;
+    /** 是否在首次观察时返回 PNG data URL。 */
+    include_screenshot?: boolean;
+}
+/** 浏览器页面的可序列化观察结果。 */
+export interface BrowserObservation extends JsonObject {
+    /** 实际使用的 provider 名称。 */
+    provider: string;
+    /** 浏览器 session 标识。 */
+    session_id: string;
+    /** 当前页面 URL。 */
+    url: string;
+    /** 当前页面标题。 */
+    title: string;
+    /** 当前页面的可见文本快照。 */
+    text: string;
+    /** 可选的 PNG data URL，供视觉模型使用。 */
+    screenshot_data_url: string | null;
+}
+/** 浏览器动作输入。 */
+export type BrowserAction = {
+    type: "goto"; /** 目标 URL。 */
+    url: string;
+} | {
+    type: "click"; /** CSS selector。 */
+    selector: string;
+} | {
+    /** 填充表单元素。 */
+    type: "fill";
+    /** CSS selector。 */
+    selector: string;
+    /** 要填充的文本。 */
+    value: string;
+} | {
+    /** 在元素上按键。 */
+    type: "press";
+    /** CSS selector。 */
+    selector: string;
+    /** Playwright 支持的键名。 */
+    key: string;
+} | {
+    /** 滚动页面。 */
+    type: "scroll";
+    /** 垂直滚动像素，正数向下。 */
+    y?: number;
+    /** 水平滚动像素，正数向右。 */
+    x?: number;
+} | {
+    /** 等待页面稳定。 */
+    type: "wait";
+    /** 等待毫秒数，provider 可限制最大值。 */
+    milliseconds?: number;
+};
+/** 浏览器动作输入 payload。 */
+export interface BrowserActInput {
+    /** 目标浏览器 session 标识。 */
+    session_id: string;
+    /** 要执行的确定性动作。 */
+    action: BrowserAction;
+    /** 动作完成后是否附带截图。 */
+    include_screenshot?: boolean;
+}
+/** 语义浏览器动作输入。 */
+export interface BrowserSemanticActInput {
+    /** 目标浏览器 session 标识。 */
+    session_id: string;
+    /** 给语义 provider 的自然语言动作，例如“点击登录按钮”。 */
+    instruction: string;
+    /** 动作完成后是否附带截图。 */
+    include_screenshot?: boolean;
+}
+/** 浏览器观察输入 payload。 */
+export interface BrowserObserveInput {
+    /** 目标浏览器 session 标识。 */
+    session_id: string;
+    /** 是否返回 PNG data URL。 */
+    include_screenshot?: boolean;
+}
+/** 浏览器抽取输入 payload。 */
+export interface BrowserExtractInput {
+    /** 目标浏览器 session 标识。 */
+    session_id: string;
+    /** 可选 CSS selector；不传时读取 body 文本。 */
+    selector?: string;
+    /** 返回的最大字符数。 */
+    max_chars?: number;
+}
+/** 语义浏览器抽取输入。 */
+export interface BrowserSemanticExtractInput {
+    /** 目标浏览器 session 标识。 */
+    session_id: string;
+    /** 给语义 provider 的抽取要求。 */
+    instruction: string;
+    /** 返回内容的最大字符数。 */
+    max_chars?: number;
+}
+/** 浏览器抽取返回值。 */
+export interface BrowserExtractResult extends JsonObject {
+    /** 实际使用的 provider 名称。 */
+    provider: string;
+    /** 浏览器 session 标识。 */
+    session_id: string;
+    /** 当前页面 URL。 */
+    url: string;
+    /** 抽取到的文本。 */
+    content: string;
+}
+/** 浏览器 session 关闭输入。 */
+export interface BrowserCloseSessionInput {
+    /** 要关闭的浏览器 session 标识。 */
+    session_id: string;
+}
+/** 浏览器 provider 的能力协议。 */
+export interface BrowserProvider {
+    /** provider 稳定名称，用于结果和诊断。 */
+    readonly name: string;
+    /** 创建浏览器 session 并返回初始观察结果。 */
+    create_session(input: BrowserCreateSessionInput): Promise<BrowserObservation>;
+    /** 读取指定 session 当前状态。 */
+    observe(input: BrowserObserveInput): Promise<BrowserObservation>;
+    /** 执行确定性动作并返回动作后的状态。 */
+    act(input: BrowserActInput): Promise<BrowserObservation>;
+    /** 可选的自然语言动作能力，由 Stagehand 或 Computer Use adapter 实现。 */
+    semantic_act?(input: BrowserSemanticActInput): Promise<BrowserObservation>;
+    /** 从指定 session 抽取文本。 */
+    extract(input: BrowserExtractInput): Promise<BrowserExtractResult>;
+    /** 可选的自然语言结构化抽取能力。 */
+    semantic_extract?(input: BrowserSemanticExtractInput): Promise<BrowserExtractResult>;
+    /** 关闭指定 session。 */
+    close_session(input: BrowserCloseSessionInput): Promise<void>;
+    /** 释放 provider 持有的浏览器连接和剩余 session。 */
+    dispose(): Promise<void>;
+}
+/** WebPlugin 构造参数。 */
+export interface WebPluginOptions {
+    /** 搜索 provider；未配置时 search action 返回能力不可用。 */
+    search?: (input: WebSearchInput) => Promise<WebSearchResult> | WebSearchResult;
+    /** 已知 URL 文档 provider；未配置时 open action 返回能力不可用。 */
+    open?: (input: WebOpenInput) => Promise<WebOpenResult> | WebOpenResult;
+    /** 浏览器 provider；未配置时 browser actions 返回能力不可用。 */
+    browser?: BrowserProvider;
 }
 //# sourceMappingURL=WebPlugin.d.ts.map

package/bin/web/types/WebPlugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,GAAG,eAAe,GAAG,KAAK,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA6B,SAAQ,UAAU;IAC9D;;OAEG;IACH,IAAI,EAAE,cAAc,CAAC;IACrB;;OAEG;IACH,MAAM,EAAE,sBAAsB,CAAC;IAC/B;;OAEG;IACH,KAAK,EAAE,qBAAqB,CAAC;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"WebPlugin.d.ts","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB;IAC7B,iBAAiB;;IAEjB,sBAAsB;;IAEtB,qBAAqB;;IAErB,iBAAiB;;IAEjB,qBAAqB;;IAErB,kCAAkC;;IAElC,oBAAoB;;IAEpB,4BAA4B;;IAE5B,qBAAqB;;CAEb,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,mBAAmB,GAC7B,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE/D,oBAAoB;AACpB,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,cAAc;AACd,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yBAAyB;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,yBAAyB;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,qBAAqB;AACrB,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,mBAAmB;AACnB,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oBAAoB;AACpB,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAwB;AACxB,MAAM,WAAW,yBAAyB;IACxC,oBAAoB;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,sBAAsB;AACtB,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,eAAe;AACf,MAAM,MAAM,aAAa,GACrB;IAAkB,IAAI,EAAE,MAAM,CAAC,CAAC,cAAc;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAe,IAAI,EAAE,OAAO,CAAC,CAAC,oBAAoB;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrE;IACE,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GACD;IACE,cAAc;IACd,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IACE,YAAY;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,mBAAmB;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,GACD;IACE,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,uBAAuB;AACvB,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,mBAAmB;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,iBAAiB;AACjB,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,uBAAuB;AACvB,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,uBAAuB;AACvB,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iBAAiB;AACjB,MAAM,WAAW,2BAA2B;IAC1C,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACtD,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAwB;AACxB,MAAM,WAAW,wBAAwB;IACvC,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0BAA0B;AAC1B,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,cAAc,CACZ,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,yBAAyB;IACzB,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjE,wBAAwB;IACxB,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzD,yDAAyD;IACzD,YAAY,CAAC,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC3E,wBAAwB;IACxB,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnE,sBAAsB;IACtB,gBAAgB,CAAC,CACf,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,oBAAoB;IACpB,aAAa,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,uCAAuC;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,CACP,KAAK,EAAE,cAAc,KAClB,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IAChD,mDAAmD;IACnD,IAAI,CAAC,EAAE,CACL,KAAK,EAAE,YAAY,KAChB,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;IAC5C,iDAAiD;IACjD,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B"}

package/bin/web/types/WebPlugin.js

@@ -1,18 +1,30 @@
 /**
- * WebPlugin 协议类型。
+ * WebPlugin 的公开协议类型。
  *
  * 关键点（中文）
- * - web plugin 只注入联网方法论，不维护 provider 运行态。
- * - install action 只返回安装提示，不执行命令或修改文件。
- * - target 表示需要安装说明的联网能力，不表示 agent 运行时默认选择。
- */
-/**
- * WebPlugin action 名称常量。
+ * - WebPlugin 只定义联网能力的稳定边界，不绑定搜索服务、浏览器云厂商或模型。
+ * - 浏览器 provider 负责 session 的创建、观察、动作执行和关闭。
+ * - 所有 action 返回值都保持 JSON 可序列化，避免把 Playwright 对象泄漏到 Agent 内核。
  */
+/** WebPlugin 对外 action 名称。 */
 export const WEB_PLUGIN_ACTIONS = {
-    /**
-     * 返回联网能力的安装操作提示。
-     */
-    install: "install",
+    /** 搜索公开网页或索引。 */
+    search: "search",
+    /** 打开已知 URL 并读取文档。 */
+    open: "open",
+    /** 创建浏览器 session。 */
+    browser_create_session: "browser_create_session",
+    /** 读取浏览器当前状态。 */
+    browser_observe: "browser_observe",
+    /** 执行一个确定性的浏览器动作。 */
+    browser_act: "browser_act",
+    /** 执行一个由语义 provider 解释的自然语言动作。 */
+    browser_semantic_act: "browser_semantic_act",
+    /** 从当前浏览器页面抽取文本。 */
+    browser_extract: "browser_extract",
+    /** 使用语义 provider 抽取页面内容。 */
+    browser_semantic_extract: "browser_semantic_extract",
+    /** 关闭浏览器 session。 */
+    browser_close_session: "browser_close_session",
 };
 //# sourceMappingURL=WebPlugin.js.map

package/bin/web/types/WebPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebPlugin.js","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC;;OAEG;IACH,OAAO,EAAE,SAAS;CACV,CAAC"}
+{"version":3,"file":"WebPlugin.js","sourceRoot":"","sources":["../../../src/web/types/WebPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,iBAAiB;IACjB,MAAM,EAAE,QAAQ;IAChB,sBAAsB;IACtB,IAAI,EAAE,MAAM;IACZ,qBAAqB;IACrB,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB;IACjB,eAAe,EAAE,iBAAiB;IAClC,qBAAqB;IACrB,WAAW,EAAE,aAAa;IAC1B,kCAAkC;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB;IACpB,eAAe,EAAE,iBAAiB;IAClC,4BAA4B;IAC5B,wBAAwB,EAAE,0BAA0B;IACpD,qBAAqB;IACrB,qBAAqB,EAAE,uBAAuB;CACtC,CAAC"}

package/bin/web.d.ts

@@ -1,9 +1,15 @@
 /**
  * `@downcity/plugins/web` 独立公开入口。
  *
- * 关键点（中文）：只汇总 WebPlugin 及其安装指引 action 协议。
+ * 关键点（中文）：汇总 provider-neutral WebPlugin 与 Playwright/CDP provider。
  */
 export { WebPlugin } from "./web/Plugin.js";
-export { WEB_PLUGIN_ACTIONS, } from "./web/types/WebPlugin.js";
-export type { WebPluginInstallInstructions, WebPluginInstallPayload, WebPluginInstallScope, WebPluginInstallTarget, } from "./web/types/WebPlugin.js";
+export { PlaywrightBrowserProvider } from "./web/providers/PlaywrightBrowserProvider.js";
+export { SemanticBrowserProviderAdapter } from "./web/providers/SemanticBrowserProviderAdapter.js";
+export { ComputerUseBrowserProviderAdapter } from "./web/providers/ComputerUseBrowserProviderAdapter.js";
+export { WEB_PLUGIN_ACTIONS } from "./web/types/WebPlugin.js";
+export type { BrowserActInput, BrowserAction, BrowserCloseSessionInput, BrowserCreateSessionInput, BrowserExtractInput, BrowserExtractResult, BrowserObservation, BrowserObserveInput, BrowserProvider, BrowserSemanticActInput, BrowserSemanticExtractInput, WebOpenInput, WebOpenResult, WebPluginActionName, WebPluginOptions, WebSearchInput, WebSearchItem, WebSearchResult, } from "./web/types/WebPlugin.js";
+export type { PlaywrightBrowserProviderOptions } from "./web/types/PlaywrightBrowserProvider.js";
+export type { SemanticBrowserProviderAdapterOptions } from "./web/types/SemanticBrowserProviderAdapter.js";
+export type { ComputerUseBrowserProviderAdapterOptions, ComputerUseBrowserProviderMethods, ComputerUseBrowserRunInput, } from "./web/types/ComputerUseBrowserProviderAdapter.js";
 //# sourceMappingURL=web.d.ts.map

package/bin/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,YAAY,EACV,eAAe,EACf,aAAa,EACb,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,uBAAuB,EACvB,2BAA2B,EAC3B,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AACjG,YAAY,EAAE,qCAAqC,EAAE,MAAM,+CAA+C,CAAC;AAC3G,YAAY,EACV,wCAAwC,EACxC,iCAAiC,EACjC,0BAA0B,GAC3B,MAAM,kDAAkD,CAAC"}

package/bin/web.js

@@ -1,8 +1,11 @@
 /**
  * `@downcity/plugins/web` 独立公开入口。
  *
- * 关键点（中文）：只汇总 WebPlugin 及其安装指引 action 协议。
+ * 关键点（中文）：汇总 provider-neutral WebPlugin 与 Playwright/CDP provider。
  */
 export { WebPlugin } from "./web/Plugin.js";
-export { WEB_PLUGIN_ACTIONS, } from "./web/types/WebPlugin.js";
+export { PlaywrightBrowserProvider } from "./web/providers/PlaywrightBrowserProvider.js";
+export { SemanticBrowserProviderAdapter } from "./web/providers/SemanticBrowserProviderAdapter.js";
+export { ComputerUseBrowserProviderAdapter } from "./web/providers/ComputerUseBrowserProviderAdapter.js";
+export { WEB_PLUGIN_ACTIONS } from "./web/types/WebPlugin.js";
 //# sourceMappingURL=web.js.map

package/bin/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,kBAAkB,GACnB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAC;AACnG,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/plugins",
-  "version": "1.0.246",
+  "version": "1.0.252",
   "type": "module",
   "description": "Downcity 内建 plugin 集合包",
   "main": "./bin/index.js",
@@ -48,8 +48,8 @@
     }
   },
   "dependencies": {
-    "@downcity/agent": "^1.1.330",
-    "@downcity/shell": "^0.1.168",
+    "@downcity/agent": "^1.1.335",
+    "@downcity/shell": "^0.1.170",
     "ai": "^6.0.193",
     "better-sqlite3": "^12.10.0",
     "commander": "^15.0.0",
@@ -57,6 +57,7 @@
     "fs-extra": "^11.3.5",
     "js-yaml": "^4.1.1",
     "node-cron": "^4.2.1",
+    "playwright-core": "^1.62.1",
     "ws": "^8.21.0",
     "zod": "^4.4.3"
   },