@downcity/plugins 1.0.248 → 1.0.253

package/bin/web/Plugin.js

@@ -1,129 +1,273 @@
 /**
- * WebPlugin：联网方法论注入插件。
+ * WebPlugin：provider-neutral 的联网与浏览器能力边界。
  *
  * 关键点（中文）
- * - web plugin 不选择 provider，也不持久化 provider 运行态。
- * - install action 只返回联网能力安装提示，不执行命令或修改文件。
- * - 它只通过 `system()` 注入联网研究与浏览器使用方法论。
- * - 具体执行能力由当前 agent 已注册的 tools、skills 或外部 plugin 决定。
+ * - Plugin 只编排已显式注入的 provider，不选择云厂商或模型。
+ * - 搜索、文档读取与浏览器 session 是三个独立能力。
+ * - 浏览器长期资源由 provider 拥有，并在 Plugin lifecycle.stop 时统一释放。
  */
-import { BasePlugin } from "@downcity/agent";
-import { create_action } from "@downcity/agent";
+import { BasePlugin, create_action } from "@downcity/agent";
 import { z } from "zod";
-import { WEB_PLUGIN_PROMPT } from "../web/WebPromptAssets.js";
-import { render_web_install_prompt } from "../web/runtime/Prompt.js";
 import { WEB_PLUGIN_ACTIONS } from "../web/types/WebPlugin.js";
-/**
- * 读取字符串选项。
- */
-function get_string_opt(opts, key) {
-    const value = opts[key];
-    if (typeof value !== "string")
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed || undefined;
-}
-/**
- * 读取安装目标。
- */
-function get_install_target_opt(opts) {
-    const value = get_string_opt(opts, "target");
-    if (value === "web-access" || value === "agent-browser" || value === "all") {
-        return value;
-    }
-    return undefined;
-}
-/**
- * 读取安装作用域。
- */
-function get_install_scope_opt(opts) {
-    const value = get_string_opt(opts, "scope");
-    if (value === "user" || value === "project")
-        return value;
-    return undefined;
+const URL_SCHEMA = z.string().url();
+const SESSION_ID_SCHEMA = z.string().trim().min(1);
+const MAX_CHARS_SCHEMA = z.number().int().min(1).max(100_000).optional();
+const BROWSER_ACTION_SCHEMA = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("goto"), url: URL_SCHEMA }),
+    z.object({ type: z.literal("click"), selector: z.string().trim().min(1) }),
+    z.object({
+        type: z.literal("fill"),
+        selector: z.string().trim().min(1),
+        value: z.string(),
+    }),
+    z.object({
+        type: z.literal("press"),
+        selector: z.string().trim().min(1),
+        key: z.string().trim().min(1),
+    }),
+    z.object({
+        type: z.literal("scroll"),
+        x: z.number().optional(),
+        y: z.number().optional(),
+    }),
+    z.object({
+        type: z.literal("wait"),
+        milliseconds: z.number().int().min(0).max(60_000).optional(),
+    }),
+]);
+/** 把异常转换为 action 的稳定失败结果。 */
+function failure_result(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { success: false, error: message, message };
 }
-/**
- * WebPlugin：为 agent 注入联网任务的方法论。
- */
+/** WebPlugin：组合显式注入的 Web provider。 */
 export class WebPlugin extends BasePlugin {
-    /**
-     * 当前 plugin 稳定名称。
-     */
+    /** 当前 plugin 稳定名称。 */
     name = "web";
-    /**
-     * 插件标题。
-     */
-    title = "Web Methodology";
-    /**
-     * 插件说明。
-     */
-    description = "Injects web research and browser-use methodology for agents.";
-    /**
-     * WebPlugin 对外 action。
-     */
+    /** 插件标题。 */
+    title = "Web";
+    /** 插件说明。 */
+    description = "Provides structured web search, document reading, and browser sessions through configured providers.";
+    /** 搜索 provider。 */
+    search_provider;
+    /** 文档读取 provider。 */
+    open_provider;
+    /** 浏览器 provider。 */
+    browser_provider;
+    constructor(options) {
+        super();
+        if (!options.search && !options.open && !options.browser) {
+            throw new TypeError("WebPlugin requires at least one provider");
+        }
+        this.search_provider = options.search;
+        this.open_provider = options.open;
+        this.browser_provider = options.browser;
+    }
+    /** Agent 释放或卸载 plugin 时关闭全部浏览器资源。 */
+    lifecycle = {
+        stop: async () => {
+            await this.browser_provider?.dispose();
+        },
+    };
+    /** 给模型注入最小且与实际 actions 一致的使用说明。 */
+    system() {
+        return [
+            "# Web Plugin",
+            "",
+            "Use direct search or document reading before starting a browser session.",
+            "Use browser actions only for dynamic pages, navigation, or interaction.",
+            "Browser actions are deterministic CSS-selector operations; inspect the page before acting.",
+            "Do not perform consequential actions such as submitting, sending, purchasing, uploading, or deleting without host approval.",
+            "Close every browser session created for the task when it is no longer needed.",
+        ].join("\n");
+    }
+    /** WebPlugin 结构化 actions。 */
     actions = {
-        [WEB_PLUGIN_ACTIONS.install]: create_action({
-            description: "Return instructions for installing web-related Skills and CLIs. This action does not install anything.",
-            input_schema: {
-                zod: z.object({
-                    target: z.enum(["web-access", "agent-browser", "all"]).optional(),
-                    scope: z.enum(["user", "project"]).optional(),
-                }),
-                json_schema: {
-                    type: "object",
-                    properties: {
-                        target: {
-                            type: "string",
-                            enum: ["web-access", "agent-browser", "all"],
-                            description: "Web capability to receive installation instructions for.",
-                        },
-                        scope: {
-                            type: "string",
-                            enum: ["user", "project"],
-                            description: "Installation scope for the agent-browser CLI.",
-                        },
+        [WEB_PLUGIN_ACTIONS.search]: create_action({
+            description: "Search the web with the configured search provider.",
+            input_schema: z.object({
+                query: z.string().trim().min(1),
+                limit: z.number().int().min(1).max(100).optional(),
+                domains: z.array(z.string().trim().min(1)).max(50).optional(),
+            }),
+            examples: [{ title: "Search official sources", payload: { query: "Playwright CDP documentation", limit: 5 } }],
+            execute: async ({ input }) => {
+                if (!this.search_provider) {
+                    return failure_result("WebPlugin search provider is not configured");
+                }
+                try {
+                    const result = await this.search_provider(input);
+                    return { success: true, data: result, message: "web search completed" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.open]: create_action({
+            description: "Read a known URL with the configured document provider.",
+            input_schema: z.object({ url: URL_SCHEMA, max_chars: MAX_CHARS_SCHEMA }),
+            examples: [{ title: "Read official documentation", payload: { url: "https://playwright.dev/docs/api/class-playwright" } }],
+            execute: async ({ input }) => {
+                if (!this.open_provider) {
+                    return failure_result("WebPlugin document provider is not configured");
+                }
+                try {
+                    const result = await this.open_provider(input);
+                    return { success: true, data: result, message: "web document opened" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_create_session]: create_action({
+            description: "Create a browser session with an optional initial URL.",
+            input_schema: z.object({
+                url: URL_SCHEMA.optional(),
+                include_screenshot: z.boolean().optional(),
+            }),
+            examples: [{ title: "Open a page", payload: { url: "https://example.com" } }],
+            execute: async ({ input }) => {
+                if (!this.browser_provider) {
+                    return failure_result("WebPlugin browser provider is not configured");
+                }
+                try {
+                    const result = await this.browser_provider.create_session(input);
+                    return { success: true, data: result, message: "browser session created" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_observe]: create_action({
+            description: "Observe the current browser page as text and an optional screenshot.",
+            input_schema: z.object({
+                session_id: SESSION_ID_SCHEMA,
+                include_screenshot: z.boolean().optional(),
+            }),
+            execute: async ({ input }) => {
+                if (!this.browser_provider) {
+                    return failure_result("WebPlugin browser provider is not configured");
+                }
+                try {
+                    const result = await this.browser_provider.observe(input);
+                    return { success: true, data: result, message: "browser observed" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_act]: create_action({
+            description: "Execute one deterministic browser action and return the resulting observation.",
+            input_schema: z.object({
+                session_id: SESSION_ID_SCHEMA,
+                action: BROWSER_ACTION_SCHEMA,
+                include_screenshot: z.boolean().optional(),
+            }),
+            examples: [{ title: "Click a link", payload: { session_id: "session-id", action: { type: "click", selector: "a" } } }],
+            execute: async ({ input }) => {
+                if (!this.browser_provider) {
+                    return failure_result("WebPlugin browser provider is not configured");
+                }
+                try {
+                    const result = await this.browser_provider.act(input);
+                    return { success: true, data: result, message: "browser action completed" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_semantic_act]: create_action({
+            description: "Execute one natural-language browser action through a semantic provider.",
+            input_schema: z.object({
+                session_id: SESSION_ID_SCHEMA,
+                instruction: z.string().trim().min(1),
+                include_screenshot: z.boolean().optional(),
+            }),
+            examples: [{
+                    title: "Use a semantic browser action",
+                    payload: {
+                        session_id: "session-id",
+                        instruction: "Click the sign in button",
                     },
-                },
+                }],
+            execute: async ({ input }) => {
+                if (!this.browser_provider?.semantic_act) {
+                    return failure_result("WebPlugin semantic browser action provider is not configured");
+                }
+                try {
+                    const result = await this.browser_provider.semantic_act(input);
+                    return { success: true, data: result, message: "semantic browser action completed" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
             },
-            examples: [
-                {
-                    title: "Get user-level installation instructions for all web capabilities",
-                    payload: { target: "all", scope: "user" },
-                },
-            ],
-            command: {
-                description: "Return web capability installation instructions without executing them.",
-                configure(command) {
-                    command
-                        .option("--target <target>", "web-access、agent-browser 或 all")
-                        .option("--scope <scope>", "agent-browser CLI 安装位置：user 或 project");
-                },
-                map_input({ opts }) {
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_extract]: create_action({
+            description: "Extract text from the page body or a CSS selector.",
+            input_schema: z.object({
+                session_id: SESSION_ID_SCHEMA,
+                selector: z.string().trim().min(1).optional(),
+                max_chars: MAX_CHARS_SCHEMA,
+            }),
+            execute: async ({ input }) => {
+                if (!this.browser_provider) {
+                    return failure_result("WebPlugin browser provider is not configured");
+                }
+                try {
+                    const result = await this.browser_provider.extract(input);
+                    return { success: true, data: result, message: "browser content extracted" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_semantic_extract]: create_action({
+            description: "Extract page content through a semantic provider.",
+            input_schema: z.object({
+                session_id: SESSION_ID_SCHEMA,
+                instruction: z.string().trim().min(1),
+                max_chars: MAX_CHARS_SCHEMA,
+            }),
+            execute: async ({ input }) => {
+                if (!this.browser_provider?.semantic_extract) {
+                    return failure_result("WebPlugin semantic browser extract provider is not configured");
+                }
+                try {
+                    const result = await this.browser_provider.semantic_extract(input);
+                    return { success: true, data: result, message: "semantic browser content extracted" };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
+            },
+        }),
+        [WEB_PLUGIN_ACTIONS.browser_close_session]: create_action({
+            description: "Close a browser session and release its page resources.",
+            input_schema: z.object({ session_id: SESSION_ID_SCHEMA }),
+            execute: async ({ input }) => {
+                if (!this.browser_provider) {
+                    return failure_result("WebPlugin browser provider is not configured");
+                }
+                try {
+                    await this.browser_provider.close_session(input);
                     return {
-                        ...(get_install_target_opt(opts)
-                            ? { target: get_install_target_opt(opts) }
-                            : {}),
-                        ...(get_install_scope_opt(opts)
-                            ? { scope: get_install_scope_opt(opts) }
-                            : {}),
+                        success: true,
+                        data: { session_id: input.session_id, closed: true },
+                        message: "browser session closed",
                     };
-                },
-            },
-            execute({ input }) {
-                const result = render_web_install_prompt(input);
-                return {
-                    success: true,
-                    data: result,
-                    message: "Web capability installation instructions ready; no commands were executed and no files were changed.",
-                };
+                }
+                catch (error) {
+                    return failure_result(error);
+                }
             },
         }),
     };
-    /**
-     * 注入联网方法论提示词。
-     */
-    system(_context) {
-        return WEB_PLUGIN_PROMPT;
-    }
 }
 //# sourceMappingURL=Plugin.js.map

package/bin/web/Plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/web/Plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/web/Plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC;AACpC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnD,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEzE,MAAM,qBAAqB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACzD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;IACtD,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;KAClB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC9B,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACzB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACxB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACzB,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;KAC7D,CAAC;CACH,CAAC,CAAC;AAEH,6BAA6B;AAC7B,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrD,CAAC;AAED,sCAAsC;AACtC,MAAM,OAAO,SAAU,SAAQ,UAAU;IACvC,sBAAsB;IACb,IAAI,GAAG,KAAK,CAAC;IAEtB,YAAY;IACH,KAAK,GAAG,KAAK,CAAC;IAEvB,YAAY;IACH,WAAW,GAClB,sGAAsG,CAAC;IAEzG,mBAAmB;IACF,eAAe,CAA8B;IAE9D,qBAAqB;IACJ,aAAa,CAA4B;IAE1D,oBAAoB;IACH,gBAAgB,CAA+B;IAEhE,YAAY,OAAyB;QACnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACzD,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAC1C,CAAC;IAED,qCAAqC;IAC5B,SAAS,GAAG;QACnB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,IAAI,CAAC,gBAAgB,EAAE,OAAO,EAAE,CAAC;QACzC,CAAC;KACF,CAAC;IAEF,mCAAmC;IACnC,MAAM;QACJ,OAAO;YACL,cAAc;YACd,EAAE;YACF,0EAA0E;YAC1E,yEAAyE;YACzE,4FAA4F;YAC5F,6HAA6H;YAC7H,+EAA+E;SAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,6BAA6B;IACpB,OAAO,GAAG;QACjB,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;YACzC,WAAW,EAAE,qDAAqD;YAClE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;gBAClD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;aAC9D,CAAC;YACF,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,8BAA8B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9G,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;oBAC1B,OAAO,cAAc,CAAC,6CAA6C,CAAC,CAAC;gBACvE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAuB,CAAC,CAAC;oBACnE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;gBAC1E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;YACvC,WAAW,EAAE,yDAAyD;YACtE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;YACxE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,kDAAkD,EAAE,EAAE,CAAC;YAC1H,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;oBACxB,OAAO,cAAc,CAAC,+CAA+C,CAAC,CAAC;gBACzE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAqB,CAAC,CAAC;oBAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;gBACzE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,sBAAsB,CAAC,EAAE,aAAa,CAAC;YACzD,WAAW,EAAE,wDAAwD;YACrE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE;gBAC1B,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;aAC3C,CAAC;YACF,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,qBAAqB,EAAE,EAAE,CAAC;YAC7E,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC3B,OAAO,cAAc,CAAC,8CAA8C,CAAC,CAAC;gBACxE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CACvD,KAAkC,CACnC,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;gBAC7E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;YAClD,WAAW,EAAE,sEAAsE;YACnF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,UAAU,EAAE,iBAAiB;gBAC7B,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;aAC3C,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC3B,OAAO,cAAc,CAAC,8CAA8C,CAAC,CAAC;gBACxE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAChD,KAA4B,CAC7B,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;gBACtE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;YAC9C,WAAW,EAAE,gFAAgF;YAC7F,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,UAAU,EAAE,iBAAiB;gBAC7B,MAAM,EAAE,qBAAqB;gBAC7B,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;aAC3C,CAAC;YACF,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;YACtH,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC3B,OAAO,cAAc,CAAC,8CAA8C,CAAC,CAAC;gBACxE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAwB,CAAC,CAAC;oBACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC;gBAC9E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,aAAa,CAAC;YACvD,WAAW,EAAE,0EAA0E;YACvF,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,UAAU,EAAE,iBAAiB;gBAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;aAC3C,CAAC;YACF,QAAQ,EAAE,CAAC;oBACT,KAAK,EAAE,+BAA+B;oBACtC,OAAO,EAAE;wBACP,UAAU,EAAE,YAAY;wBACxB,WAAW,EAAE,0BAA0B;qBACxC;iBACF,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,EAAE,CAAC;oBACzC,OAAO,cAAc,CACnB,8DAA8D,CAC/D,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CACrD,KAAgC,CACjC,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC;gBACvF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,aAAa,CAAC;YAClD,WAAW,EAAE,oDAAoD;YACjE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,UAAU,EAAE,iBAAiB;gBAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;gBAC7C,SAAS,EAAE,gBAAgB;aAC5B,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC3B,OAAO,cAAc,CAAC,8CAA8C,CAAC,CAAC;gBACxE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAChD,KAA4B,CAC7B,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;gBAC/E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,EAAE,aAAa,CAAC;YAC3D,WAAW,EAAE,mDAAmD;YAChE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;gBACrB,UAAU,EAAE,iBAAiB;gBAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;gBACrC,SAAS,EAAE,gBAAgB;aAC5B,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;oBAC7C,OAAO,cAAc,CACnB,+DAA+D,CAChE,CAAC;gBACJ,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CACzD,KAAoC,CACrC,CAAC;oBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;gBACxF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;QAEF,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,EAAE,aAAa,CAAC;YACxD,WAAW,EAAE,yDAAyD;YACtE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;YACzD,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC3B,OAAO,cAAc,CAAC,8CAA8C,CAAC,CAAC;gBACxE,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CACvC,KAAiC,CAClC,CAAC;oBACF,OAAO;wBACL,OAAO,EAAE,IAAI;wBACb,IAAI,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE;wBACpD,OAAO,EAAE,wBAAwB;qBAClC,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;SACF,CAAC;KACiC,CAAC;CACvC"}

package/bin/web/providers/ComputerUseBrowserProviderAdapter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Provider-neutral Computer Use 浏览器 adapter。
+ *
+ * 关键点（中文）
+ * - adapter 不依赖 OpenAI、Anthropic 或 Google SDK。
+ * - 每次语义动作先获取带截图的当前状态，再交给宿主模型循环。
+ * - 模型回调不能直接接触 Playwright 对象，只能返回 JSON observation。
+ */
+import type { BrowserActInput, BrowserCloseSessionInput, BrowserCreateSessionInput, BrowserExtractInput, BrowserExtractResult, BrowserObservation, BrowserObserveInput, BrowserSemanticActInput } from "../../web/types/WebPlugin.js";
+import type { ComputerUseBrowserProviderAdapterOptions, ComputerUseBrowserProviderMethods } from "../../web/types/ComputerUseBrowserProviderAdapter.js";
+/** 为基础浏览器组合 Computer Use 视觉回退。 */
+export declare class ComputerUseBrowserProviderAdapter implements ComputerUseBrowserProviderMethods {
+    /** adapter 稳定名称。 */
+    readonly name: string;
+    /** 拥有 session 的基础浏览器 provider。 */
+    private readonly browser;
+    /** Computer Use 模型回调。 */
+    private readonly run_callback;
+    constructor(options: ComputerUseBrowserProviderAdapterOptions);
+    /** 委托创建浏览器 session。 */
+    create_session(input: BrowserCreateSessionInput): Promise<BrowserObservation>;
+    /** 委托观察页面。 */
+    observe(input: BrowserObserveInput): Promise<BrowserObservation>;
+    /** 委托确定性动作。 */
+    act(input: BrowserActInput): Promise<BrowserObservation>;
+    /** 获取截图并运行一次 Computer Use 模型循环。 */
+    semantic_act(input: BrowserSemanticActInput): Promise<BrowserObservation>;
+    /** 委托页面文本抽取。 */
+    extract(input: BrowserExtractInput): Promise<BrowserExtractResult>;
+    /** Computer Use adapter 不提供结构化语义抽取。 */
+    close_session(input: BrowserCloseSessionInput): Promise<void>;
+    /** 释放基础浏览器资源。 */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=ComputerUseBrowserProviderAdapter.d.ts.map

package/bin/web/providers/ComputerUseBrowserProviderAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputerUseBrowserProviderAdapter.d.ts","sourceRoot":"","sources":["../../../src/web/providers/ComputerUseBrowserProviderAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EAEnB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,wCAAwC,EACxC,iCAAiC,EAClC,MAAM,kDAAkD,CAAC;AAE1D,kCAAkC;AAClC,qBAAa,iCACX,YAAW,iCAAiC;IAE5C,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAE1C,yBAAyB;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkD;gBAEnE,OAAO,EAAE,wCAAwC;IAQ7D,uBAAuB;IACjB,cAAc,CAClB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAI9B,cAAc;IACR,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAItE,eAAe;IACT,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI9D,mCAAmC;IAC7B,YAAY,CAChB,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAY9B,gBAAgB;IACV,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIxE,uCAAuC;IACjC,aAAa,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,iBAAiB;IACX,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/bin/web/providers/ComputerUseBrowserProviderAdapter.js

@@ -0,0 +1,62 @@
+/**
+ * Provider-neutral Computer Use 浏览器 adapter。
+ *
+ * 关键点（中文）
+ * - adapter 不依赖 OpenAI、Anthropic 或 Google SDK。
+ * - 每次语义动作先获取带截图的当前状态，再交给宿主模型循环。
+ * - 模型回调不能直接接触 Playwright 对象，只能返回 JSON observation。
+ */
+/** 为基础浏览器组合 Computer Use 视觉回退。 */
+export class ComputerUseBrowserProviderAdapter {
+    /** adapter 稳定名称。 */
+    name;
+    /** 拥有 session 的基础浏览器 provider。 */
+    browser;
+    /** Computer Use 模型回调。 */
+    run_callback;
+    constructor(options) {
+        const name = String(options.name || "").trim();
+        if (!name)
+            throw new TypeError("ComputerUseBrowserProviderAdapter requires name");
+        this.name = name;
+        this.browser = options.browser;
+        this.run_callback = options.run;
+    }
+    /** 委托创建浏览器 session。 */
+    async create_session(input) {
+        return await this.browser.create_session(input);
+    }
+    /** 委托观察页面。 */
+    async observe(input) {
+        return await this.browser.observe(input);
+    }
+    /** 委托确定性动作。 */
+    async act(input) {
+        return await this.browser.act(input);
+    }
+    /** 获取截图并运行一次 Computer Use 模型循环。 */
+    async semantic_act(input) {
+        const observation = await this.browser.observe({
+            session_id: input.session_id,
+            include_screenshot: true,
+        });
+        return await this.run_callback({
+            instruction: input.instruction,
+            session_id: input.session_id,
+            observation,
+        });
+    }
+    /** 委托页面文本抽取。 */
+    async extract(input) {
+        return await this.browser.extract(input);
+    }
+    /** Computer Use adapter 不提供结构化语义抽取。 */
+    async close_session(input) {
+        await this.browser.close_session(input);
+    }
+    /** 释放基础浏览器资源。 */
+    async dispose() {
+        await this.browser.dispose();
+    }
+}
+//# sourceMappingURL=ComputerUseBrowserProviderAdapter.js.map

package/bin/web/providers/ComputerUseBrowserProviderAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputerUseBrowserProviderAdapter.js","sourceRoot":"","sources":["../../../src/web/providers/ComputerUseBrowserProviderAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkBH,kCAAkC;AAClC,MAAM,OAAO,iCAAiC;IAG5C,oBAAoB;IACX,IAAI,CAAS;IAEtB,kCAAkC;IACjB,OAAO,CAAkB;IAE1C,yBAAyB;IACR,YAAY,CAAkD;IAE/E,YAAY,OAAiD;QAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAClC,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,cAAc,CAClB,KAAgC;QAEhC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,cAAc;IACd,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,eAAe;IACf,KAAK,CAAC,GAAG,CAAC,KAAsB;QAC9B,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,YAAY,CAChB,KAA8B;QAE9B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YAC7C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,kBAAkB,EAAE,IAAI;SACzB,CAAC,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC;YAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,WAAW;SACZ,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,aAAa,CAAC,KAA+B;QACjD,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,iBAAiB;IACjB,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/bin/web/providers/PlaywrightBrowserProvider.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 基于 Playwright/CDP 的浏览器 provider。
+ *
+ * 关键点（中文）
+ * - provider 只连接外部已启动的 CDP 浏览器，不负责安装或启动 Chrome。
+ * - 每个 session 拥有独立 Page；连接与 session 生命周期统一由 provider 回收。
+ * - action 只暴露确定性 DOM 操作，AI 语义动作由后续 Stagehand adapter 承担。
+ */
+import type { BrowserActInput, BrowserCloseSessionInput, BrowserCreateSessionInput, BrowserExtractInput, BrowserExtractResult, BrowserObservation, BrowserObserveInput, BrowserProvider } from "../../web/types/WebPlugin.js";
+import type { PlaywrightBrowserProviderOptions } from "../../web/types/PlaywrightBrowserProvider.js";
+/** 基于 Playwright/CDP 的浏览器 provider。 */
+export declare class PlaywrightBrowserProvider implements BrowserProvider {
+    /** provider 稳定名称。 */
+    readonly name = "playwright-cdp";
+    /** 构造参数。 */
+    private readonly options;
+    /** 当前 CDP 浏览器连接。 */
+    private browser;
+    /** 当前 provider 拥有的 session。 */
+    private readonly sessions;
+    /** provider 是否已释放。 */
+    private disposed;
+    constructor(options: PlaywrightBrowserProviderOptions);
+    /** 创建一个新的页面 session。 */
+    create_session(input: BrowserCreateSessionInput): Promise<BrowserObservation>;
+    /** 读取当前页面状态。 */
+    observe(input: BrowserObserveInput): Promise<BrowserObservation>;
+    /** 执行确定性浏览器动作。 */
+    act(input: BrowserActInput): Promise<BrowserObservation>;
+    /** 从当前页面抽取文本。 */
+    extract(input: BrowserExtractInput): Promise<BrowserExtractResult>;
+    /** 关闭指定 session 拥有的页面。 */
+    close_session(input: BrowserCloseSessionInput): Promise<void>;
+    /** 关闭所有页面和 CDP 连接。 */
+    dispose(): Promise<void>;
+    /** 懒连接 CDP 浏览器。 */
+    private get_browser;
+    /** 读取 session，不存在时抛出稳定错误。 */
+    private require_session;
+    /** 生成当前页面的模型友好观察结果。 */
+    private read_observation;
+}
+//# sourceMappingURL=PlaywrightBrowserProvider.d.ts.map

package/bin/web/providers/PlaywrightBrowserProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowserProvider.d.ts","sourceRoot":"","sources":["../../../src/web/providers/PlaywrightBrowserProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0CAA0C,CAAC;AAkCjG,uCAAuC;AACvC,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,qBAAqB;IACrB,QAAQ,CAAC,IAAI,oBAAoB;IAEjC,YAAY;IACZ,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE,oBAAoB;IACpB,OAAO,CAAC,OAAO,CAAwB;IAEvC,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IAExE,sBAAsB;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,gCAAgC;IAgBrD,wBAAwB;IAClB,cAAc,CAClB,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,kBAAkB,CAAC;IAsB9B,gBAAgB;IACV,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOtE,kBAAkB;IACZ,GAAG,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6B9D,iBAAiB;IACX,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAkBxE,0BAA0B;IACpB,aAAa,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,sBAAsB;IAChB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,mBAAmB;YACL,WAAW;IAezB,6BAA6B;IAC7B,OAAO,CAAC,eAAe;IAQvB,uBAAuB;YACT,gBAAgB;CAkB/B"}