@downcity/plugins 1.0.246 → 1.0.252

package/src/web/types/WebPlugin.ts

@@ -1,78 +1,251 @@
 /**
- * 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 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",
 } as const;
 
-/**
- * WebPlugin 安装提示目标。
- */
-export type WebPluginInstallTarget = "web-access" | "agent-browser" | "all";
+/** WebPlugin action 名称联合类型。 */
+export type WebPluginActionName =
+  (typeof WEB_PLUGIN_ACTIONS)[keyof typeof WEB_PLUGIN_ACTIONS];
 
-/**
- * agent-browser CLI 安装作用域。
- */
-export type WebPluginInstallScope = "user" | "project";
+/** 搜索 action 输入。 */
+export interface WebSearchInput {
+  /** 用户要检索的自然语言查询。 */
+  query: string;
+  /** 最多返回的结果数量，provider 可自行设置上限。 */
+  limit?: number;
+  /** 只搜索这些域名；不传时由 provider 决定搜索范围。 */
+  domains?: string[];
+}
 
-/**
- * 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;
+/** 单条搜索结果。 */
+export interface WebSearchItem extends JsonObject {
+  /** 结果页面的规范 URL。 */
+  url: string;
+  /** 页面标题。 */
+  title: string | null;
+  /** 搜索 provider 返回的摘要。 */
+  snippet: string | null;
+  /** provider 给出的相关性分数。 */
+  score: number | null;
 }
 
-/**
- * WebPlugin install action 返回的安装提示数据。
- */
-export interface WebPluginInstallInstructions extends JsonObject {
-  /**
-   * 标识当前结果只包含操作说明。
-   */
-  kind: "instructions";
-  /**
-   * 已归一化的联网能力目标。
-   */
-  target: WebPluginInstallTarget;
-  /**
-   * 已归一化的 agent-browser CLI 安装作用域。
-   */
-  scope: WebPluginInstallScope;
-  /**
-   * 提供给 Agent 执行的完整安装说明。
-   */
-  prompt: string;
+/** 搜索 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;
 }

package/src/web.ts

@@ -1,16 +1,38 @@
 /**
  * `@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";
 export type {
-  WebPluginInstallInstructions,
-  WebPluginInstallPayload,
-  WebPluginInstallScope,
-  WebPluginInstallTarget,
+  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";

package/bin/web/PROMPT.d.ts

@@ -1,7 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-declare const TEXT_MODULE_CONTENT = "# Web Plugin\n\nThis plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.\n\nIf web-related dependencies are needed, use the `web` plugin's `install` action to receive instructions for capabilities such as `web-access` and `agent-browser`. The action never executes commands, accesses the network, installs dependencies, or changes files. Follow the returned prompt with the available plugin and Shell capabilities.\n\nWhen a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.\n\n## General Principles\n\n- Goal-driven: think like a human. Define the success criteria first, then choose the starting point most likely to reach them directly.\n- Evidence at every step: each result is evidence. When a path stops making progress, switch methods instead of repeatedly retrying the wrong approach.\n- Prefer primary sources: search engines are for discovery. Conclusions should usually trace back to official sites, official platforms, original pages, official docs, or source code.\n- Stop when done: once the goal is reached, do not spend extra steps just to look more complete.\n- Capability self-check: do not assume that a web skill or tool exists. Prefer capabilities explicitly available in the current system/tool list or in already looked-up skills.\n\n## Tool Selection\n\n- To discover sources or map keyword context: prefer currently available search tools or web-access-style skills.\n- For a known URL where you need page text or a direct answer: prefer currently available fetch/read tools.\n- For a known URL where you need raw HTML, meta tags, JSON-LD, or similar structured content: prefer currently available HTTP/curl/shell capabilities.\n- For logged-in state, dynamic rendering, site navigation, complex interactions, or anti-bot pages: prefer currently available browser, Chrome, agent-browser, or computer-use capabilities.\n- Jina-style markdown preprocessing may help for article-like pages and save tokens, but do not blindly trust it for dashboards, product pages, or complex layouts.\n\n## Browser Strategy\n\n- Once in the browser layer, understand the page structure before choosing the next action.\n- Programmatic methods are faster but more likely to trigger anti-bot behavior. GUI interaction is slower but more deterministic. If programmatic access is blocked, fall back to GUI.\n- Prefer links generated by the page itself. Do not manually guess or trim internal URL parameters.\n- Operate only tabs you created. Do not disturb the user's existing tabs. Close tabs you created when the task is done.\n- When encountering a login wall, first decide whether it actually blocks the goal. Ask the user to log in only when the target cannot be reached otherwise.\n\n## Parallelism And Verification\n\n- Independent research targets may be split and run in parallel. Targets with dependencies should not be parallelized blindly.\n- Verification tasks should return to primary sources. Do not use multiple secondary reports to circularly confirm each other.\n\n## Relationship To Skills And Tools\n\n- If the current environment has a `web-access` skill, web search, scraping, and verification tasks may prefer its instructions.\n- If the current environment has `agent-browser`, browser, or Chrome capabilities, dynamic pages and logged-in tasks may prefer them.\n- If necessary web capability is missing, state that directly. Do not pretend you have accessed the web.\n\n## Available Action\n\n- `install`: return installation instructions for web-related Skills and CLIs without executing them.\n\nExample:\n\n```ts\nplugin_call({\n  plugin: \"web\",\n  action: \"install\",\n  payload: {\n    target: \"agent-browser\",\n    scope: \"user\",\n  },\n});\n```\n\nAfter calling `install`, follow `data.prompt`. Skill installation is delegated to the `skill.install` instruction action so that the active SkillPlugin scan roots remain the source of truth. After running the instructed Shell commands, verify Skills with `skill.list` and read them with `skill.lookup`.\n";
-export default TEXT_MODULE_CONTENT;
-//# sourceMappingURL=PROMPT.d.ts.map

package/bin/web/PROMPT.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PROMPT.d.ts","sourceRoot":"","sources":["../../src/web/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,QAAA,MAAM,mBAAmB,+mIAA+mI,CAAC;AAEzoI,eAAe,mBAAmB,CAAC"}

package/bin/web/PROMPT.js

@@ -1,8 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-// Source: src/web/PROMPT.ts
-const TEXT_MODULE_CONTENT = "# Web Plugin\n\nThis plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.\n\nIf web-related dependencies are needed, use the `web` plugin's `install` action to receive instructions for capabilities such as `web-access` and `agent-browser`. The action never executes commands, accesses the network, installs dependencies, or changes files. Follow the returned prompt with the available plugin and Shell capabilities.\n\nWhen a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.\n\n## General Principles\n\n- Goal-driven: think like a human. Define the success criteria first, then choose the starting point most likely to reach them directly.\n- Evidence at every step: each result is evidence. When a path stops making progress, switch methods instead of repeatedly retrying the wrong approach.\n- Prefer primary sources: search engines are for discovery. Conclusions should usually trace back to official sites, official platforms, original pages, official docs, or source code.\n- Stop when done: once the goal is reached, do not spend extra steps just to look more complete.\n- Capability self-check: do not assume that a web skill or tool exists. Prefer capabilities explicitly available in the current system/tool list or in already looked-up skills.\n\n## Tool Selection\n\n- To discover sources or map keyword context: prefer currently available search tools or web-access-style skills.\n- For a known URL where you need page text or a direct answer: prefer currently available fetch/read tools.\n- For a known URL where you need raw HTML, meta tags, JSON-LD, or similar structured content: prefer currently available HTTP/curl/shell capabilities.\n- For logged-in state, dynamic rendering, site navigation, complex interactions, or anti-bot pages: prefer currently available browser, Chrome, agent-browser, or computer-use capabilities.\n- Jina-style markdown preprocessing may help for article-like pages and save tokens, but do not blindly trust it for dashboards, product pages, or complex layouts.\n\n## Browser Strategy\n\n- Once in the browser layer, understand the page structure before choosing the next action.\n- Programmatic methods are faster but more likely to trigger anti-bot behavior. GUI interaction is slower but more deterministic. If programmatic access is blocked, fall back to GUI.\n- Prefer links generated by the page itself. Do not manually guess or trim internal URL parameters.\n- Operate only tabs you created. Do not disturb the user's existing tabs. Close tabs you created when the task is done.\n- When encountering a login wall, first decide whether it actually blocks the goal. Ask the user to log in only when the target cannot be reached otherwise.\n\n## Parallelism And Verification\n\n- Independent research targets may be split and run in parallel. Targets with dependencies should not be parallelized blindly.\n- Verification tasks should return to primary sources. Do not use multiple secondary reports to circularly confirm each other.\n\n## Relationship To Skills And Tools\n\n- If the current environment has a `web-access` skill, web search, scraping, and verification tasks may prefer its instructions.\n- If the current environment has `agent-browser`, browser, or Chrome capabilities, dynamic pages and logged-in tasks may prefer them.\n- If necessary web capability is missing, state that directly. Do not pretend you have accessed the web.\n\n## Available Action\n\n- `install`: return installation instructions for web-related Skills and CLIs without executing them.\n\nExample:\n\n```ts\nplugin_call({\n  plugin: \"web\",\n  action: \"install\",\n  payload: {\n    target: \"agent-browser\",\n    scope: \"user\",\n  },\n});\n```\n\nAfter calling `install`, follow `data.prompt`. Skill installation is delegated to the `skill.install` instruction action so that the active SkillPlugin scan roots remain the source of truth. After running the instructed Shell commands, verify Skills with `skill.list` and read them with `skill.lookup`.\n";
-export default TEXT_MODULE_CONTENT;
-//# sourceMappingURL=PROMPT.js.map

package/bin/web/PROMPT.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PROMPT.js","sourceRoot":"","sources":["../../src/web/PROMPT.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4BAA4B;AAC5B,MAAM,mBAAmB,GAAG,4mIAA4mI,CAAC;AAEzoI,eAAe,mBAAmB,CAAC"}

package/bin/web/WebPromptAssets.d.ts

@@ -1,12 +0,0 @@
-/**
- * WebPromptAssets：web plugin 静态提示词资产。
- *
- * 关键点（中文）
- * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
- * - web plugin 只保留通用联网方法论，不再维护 provider 专属提示词。
- */
-/**
- * web plugin 基础 prompt。
- */
-export declare const WEB_PLUGIN_PROMPT: string;
-//# sourceMappingURL=WebPromptAssets.d.ts.map

package/bin/web/WebPromptAssets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebPromptAssets.d.ts","sourceRoot":"","sources":["../../src/web/WebPromptAssets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAA6B,CAAC"}

package/bin/web/WebPromptAssets.js

@@ -1,13 +0,0 @@
-/**
- * WebPromptAssets：web plugin 静态提示词资产。
- *
- * 关键点（中文）
- * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
- * - web plugin 只保留通用联网方法论，不再维护 provider 专属提示词。
- */
-import webPluginPromptText from "../web/PROMPT.js";
-/**
- * web plugin 基础 prompt。
- */
-export const WEB_PLUGIN_PROMPT = webPluginPromptText.trim();
-//# sourceMappingURL=WebPromptAssets.js.map

package/bin/web/WebPromptAssets.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"WebPromptAssets.js","sourceRoot":"","sources":["../../src/web/WebPromptAssets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,mBAAmB,MAAM,iBAAiB,CAAC;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,IAAI,EAAE,CAAC"}

package/bin/web/runtime/Prompt.d.ts

@@ -1,14 +0,0 @@
-/**
- * WebPlugin 安装提示词渲染器。
- *
- * 关键点（中文）
- * - 只生成 Agent 可执行的操作说明，不执行命令、访问网络或修改文件。
- * - Skill 安装委托给 SkillPlugin，避免重复维护扫描根与安装位置规则。
- * - agent-browser CLI 仅根据请求的作用域提供 Shell 命令候选。
- */
-import type { WebPluginInstallInstructions, WebPluginInstallPayload } from "../../web/types/WebPlugin.js";
-/**
- * 生成 web install action 返回的纯提示词。
- */
-export declare function render_web_install_prompt(payload: WebPluginInstallPayload | null | undefined): WebPluginInstallInstructions;
-//# sourceMappingURL=Prompt.d.ts.map

package/bin/web/runtime/Prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Prompt.d.ts","sourceRoot":"","sources":["../../../src/web/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,4BAA4B,EAC5B,uBAAuB,EAGxB,MAAM,0BAA0B,CAAC;AAoDlC;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAClD,4BAA4B,CA2B9B"}

package/bin/web/runtime/Prompt.js

@@ -1,77 +0,0 @@
-/**
- * WebPlugin 安装提示词渲染器。
- *
- * 关键点（中文）
- * - 只生成 Agent 可执行的操作说明，不执行命令、访问网络或修改文件。
- * - Skill 安装委托给 SkillPlugin，避免重复维护扫描根与安装位置规则。
- * - agent-browser CLI 仅根据请求的作用域提供 Shell 命令候选。
- */
-/**
- * 归一化联网能力目标。
- */
-function resolve_install_target(target) {
-    return target === "agent-browser" || target === "all"
-        ? target
-        : "web-access";
-}
-/**
- * 归一化 CLI 安装作用域。
- */
-function resolve_install_scope(scope) {
-    return scope === "project" ? "project" : "user";
-}
-/**
- * 渲染单个 Skill 的安装工作流。
- */
-function render_skill_install_step(skill_name) {
-    return [
-        `- Call \`plugin_call({ plugin: "skill", action: "install", payload: { spec: "${skill_name}" } })\`.`,
-        "  Follow the returned scan-aware Shell instructions. The WebPlugin has not installed this Skill.",
-    ].join("\n");
-}
-/**
- * 渲染 agent-browser CLI 的安装提示。
- */
-function render_agent_browser_cli_step(scope) {
-    if (scope === "project") {
-        return [
-            "- Inspect the project lockfile and use its existing package manager to install `agent-browser` as a devDependency:",
-            "  - pnpm: `pnpm add -D agent-browser`",
-            "  - npm: `npm install -D agent-browser`",
-            "  - yarn: `yarn add -D agent-browser`",
-            "- Verify the project-local CLI with the matching package-manager command, for example `pnpm exec agent-browser --help`.",
-        ].join("\n");
-    }
-    return [
-        "- Install the CLI globally with `npm install -g agent-browser`.",
-        "- Verify it with `agent-browser --help`.",
-    ].join("\n");
-}
-/**
- * 生成 web install action 返回的纯提示词。
- */
-export function render_web_install_prompt(payload) {
-    const target = resolve_install_target(payload?.target);
-    const scope = resolve_install_scope(payload?.scope);
-    const skill_names = target === "all" ? ["web-access", "agent-browser"] : [target];
-    const skill_steps = skill_names.map(render_skill_install_step).join("\n");
-    const cli_steps = target === "agent-browser" || target === "all"
-        ? ["", "## agent-browser CLI", render_agent_browser_cli_step(scope)]
-        : [];
-    const prompt = [
-        "# Install Web Capabilities Instructions",
-        "",
-        "This action only returns instructions. It has not executed commands, accessed the network, installed dependencies, or changed files.",
-        "",
-        "## Skills",
-        skill_steps,
-        ...cli_steps,
-        "",
-        "## Verification",
-        "After completing the Shell steps, call `plugin_call({ plugin: \"skill\", action: \"list\", payload: {} })` and confirm every requested Skill is discoverable.",
-        "Call `skill.lookup` for each installed Skill before using it.",
-        "If the `skill` plugin is unavailable, configure it before installing a Skill; do not guess an unscanned destination.",
-    ].join("\n");
-    return { kind: "instructions", target, scope, prompt };
-}
-//# sourceMappingURL=Prompt.js.map

package/bin/web/runtime/Prompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Prompt.js","sourceRoot":"","sources":["../../../src/web/runtime/Prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;GAEG;AACH,SAAS,sBAAsB,CAC7B,MAAyC;IAEzC,OAAO,MAAM,KAAK,eAAe,IAAI,MAAM,KAAK,KAAK;QACnD,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,YAAY,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,KAAuC;IAEvC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,UAAkB;IACnD,OAAO;QACL,gFAAgF,UAAU,WAAW;QACrG,kGAAkG;KACnG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,6BAA6B,CAAC,KAA4B;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;YACL,oHAAoH;YACpH,uCAAuC;YACvC,yCAAyC;YACzC,uCAAuC;YACvC,yHAAyH;SAC1H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAED,OAAO;QACL,iEAAiE;QACjE,0CAA0C;KAC3C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAmD;IAEnD,MAAM,MAAM,GAAG,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,WAAW,GACf,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,MAAM,SAAS,GACb,MAAM,KAAK,eAAe,IAAI,MAAM,KAAK,KAAK;QAC5C,CAAC,CAAC,CAAC,EAAE,EAAE,sBAAsB,EAAE,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,MAAM,GAAG;QACb,yCAAyC;QACzC,EAAE;QACF,sIAAsI;QACtI,EAAE;QACF,WAAW;QACX,WAAW;QACX,GAAG,SAAS;QACZ,EAAE;QACF,iBAAiB;QACjB,+JAA+J;QAC/J,+DAA+D;QAC/D,sHAAsH;KACvH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC"}

package/src/web/PROMPT.ts

@@ -1,9 +0,0 @@
-/**
- * 自动生成文件，请勿手改。
- * 源文件：由同路径 `*.ts.txt` 生成。
- */
-
-// Source: src/web/PROMPT.ts
-const TEXT_MODULE_CONTENT = "# Web Plugin\n\nThis plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.\n\nIf web-related dependencies are needed, use the `web` plugin's `install` action to receive instructions for capabilities such as `web-access` and `agent-browser`. The action never executes commands, accesses the network, installs dependencies, or changes files. Follow the returned prompt with the available plugin and Shell capabilities.\n\nWhen a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.\n\n## General Principles\n\n- Goal-driven: think like a human. Define the success criteria first, then choose the starting point most likely to reach them directly.\n- Evidence at every step: each result is evidence. When a path stops making progress, switch methods instead of repeatedly retrying the wrong approach.\n- Prefer primary sources: search engines are for discovery. Conclusions should usually trace back to official sites, official platforms, original pages, official docs, or source code.\n- Stop when done: once the goal is reached, do not spend extra steps just to look more complete.\n- Capability self-check: do not assume that a web skill or tool exists. Prefer capabilities explicitly available in the current system/tool list or in already looked-up skills.\n\n## Tool Selection\n\n- To discover sources or map keyword context: prefer currently available search tools or web-access-style skills.\n- For a known URL where you need page text or a direct answer: prefer currently available fetch/read tools.\n- For a known URL where you need raw HTML, meta tags, JSON-LD, or similar structured content: prefer currently available HTTP/curl/shell capabilities.\n- For logged-in state, dynamic rendering, site navigation, complex interactions, or anti-bot pages: prefer currently available browser, Chrome, agent-browser, or computer-use capabilities.\n- Jina-style markdown preprocessing may help for article-like pages and save tokens, but do not blindly trust it for dashboards, product pages, or complex layouts.\n\n## Browser Strategy\n\n- Once in the browser layer, understand the page structure before choosing the next action.\n- Programmatic methods are faster but more likely to trigger anti-bot behavior. GUI interaction is slower but more deterministic. If programmatic access is blocked, fall back to GUI.\n- Prefer links generated by the page itself. Do not manually guess or trim internal URL parameters.\n- Operate only tabs you created. Do not disturb the user's existing tabs. Close tabs you created when the task is done.\n- When encountering a login wall, first decide whether it actually blocks the goal. Ask the user to log in only when the target cannot be reached otherwise.\n\n## Parallelism And Verification\n\n- Independent research targets may be split and run in parallel. Targets with dependencies should not be parallelized blindly.\n- Verification tasks should return to primary sources. Do not use multiple secondary reports to circularly confirm each other.\n\n## Relationship To Skills And Tools\n\n- If the current environment has a `web-access` skill, web search, scraping, and verification tasks may prefer its instructions.\n- If the current environment has `agent-browser`, browser, or Chrome capabilities, dynamic pages and logged-in tasks may prefer them.\n- If necessary web capability is missing, state that directly. Do not pretend you have accessed the web.\n\n## Available Action\n\n- `install`: return installation instructions for web-related Skills and CLIs without executing them.\n\nExample:\n\n```ts\nplugin_call({\n  plugin: \"web\",\n  action: \"install\",\n  payload: {\n    target: \"agent-browser\",\n    scope: \"user\",\n  },\n});\n```\n\nAfter calling `install`, follow `data.prompt`. Skill installation is delegated to the `skill.install` instruction action so that the active SkillPlugin scan roots remain the source of truth. After running the instructed Shell commands, verify Skills with `skill.list` and read them with `skill.lookup`.\n";
-
-export default TEXT_MODULE_CONTENT;

package/src/web/PROMPT.ts.txt

@@ -1,61 +0,0 @@
-# Web Plugin
-
-This plugin injects general web-access methodology. It does not choose a provider and does not guarantee that any specific web tool exists.
-
-If web-related dependencies are needed, use the `web` plugin's `install` action to receive instructions for capabilities such as `web-access` and `agent-browser`. The action never executes commands, accesses the network, installs dependencies, or changes files. Follow the returned prompt with the available plugin and Shell capabilities.
-
-When a task needs internet access, verification, webpage reading, webpage interaction, or browser use, choose the path based on the currently available tools, skills, and user goal.
-
-## General Principles
-
-- Goal-driven: think like a human. Define the success criteria first, then choose the starting point most likely to reach them directly.
-- Evidence at every step: each result is evidence. When a path stops making progress, switch methods instead of repeatedly retrying the wrong approach.
-- Prefer primary sources: search engines are for discovery. Conclusions should usually trace back to official sites, official platforms, original pages, official docs, or source code.
-- Stop when done: once the goal is reached, do not spend extra steps just to look more complete.
-- Capability self-check: do not assume that a web skill or tool exists. Prefer capabilities explicitly available in the current system/tool list or in already looked-up skills.
-
-## Tool Selection
-
-- To discover sources or map keyword context: prefer currently available search tools or web-access-style skills.
-- For a known URL where you need page text or a direct answer: prefer currently available fetch/read tools.
-- For a known URL where you need raw HTML, meta tags, JSON-LD, or similar structured content: prefer currently available HTTP/curl/shell capabilities.
-- For logged-in state, dynamic rendering, site navigation, complex interactions, or anti-bot pages: prefer currently available browser, Chrome, agent-browser, or computer-use capabilities.
-- Jina-style markdown preprocessing may help for article-like pages and save tokens, but do not blindly trust it for dashboards, product pages, or complex layouts.
-
-## Browser Strategy
-
-- Once in the browser layer, understand the page structure before choosing the next action.
-- Programmatic methods are faster but more likely to trigger anti-bot behavior. GUI interaction is slower but more deterministic. If programmatic access is blocked, fall back to GUI.
-- Prefer links generated by the page itself. Do not manually guess or trim internal URL parameters.
-- Operate only tabs you created. Do not disturb the user's existing tabs. Close tabs you created when the task is done.
-- When encountering a login wall, first decide whether it actually blocks the goal. Ask the user to log in only when the target cannot be reached otherwise.
-
-## Parallelism And Verification
-
-- Independent research targets may be split and run in parallel. Targets with dependencies should not be parallelized blindly.
-- Verification tasks should return to primary sources. Do not use multiple secondary reports to circularly confirm each other.
-
-## Relationship To Skills And Tools
-
-- If the current environment has a `web-access` skill, web search, scraping, and verification tasks may prefer its instructions.
-- If the current environment has `agent-browser`, browser, or Chrome capabilities, dynamic pages and logged-in tasks may prefer them.
-- If necessary web capability is missing, state that directly. Do not pretend you have accessed the web.
-
-## Available Action
-
-- `install`: return installation instructions for web-related Skills and CLIs without executing them.
-
-Example:
-
-```ts
-plugin_call({
-  plugin: "web",
-  action: "install",
-  payload: {
-    target: "agent-browser",
-    scope: "user",
-  },
-});
-```
-
-After calling `install`, follow `data.prompt`. Skill installation is delegated to the `skill.install` instruction action so that the active SkillPlugin scan roots remain the source of truth. After running the instructed Shell commands, verify Skills with `skill.list` and read them with `skill.lookup`.

package/src/web/WebPromptAssets.ts

@@ -1,14 +0,0 @@
-/**
- * WebPromptAssets：web plugin 静态提示词资产。
- *
- * 关键点（中文）
- * - prompt 文本真实来源是 `*.ts.txt` 文本文件。
- * - web plugin 只保留通用联网方法论，不再维护 provider 专属提示词。
- */
-
-import webPluginPromptText from "@/web/PROMPT.js";
-
-/**
- * web plugin 基础 prompt。
- */
-export const WEB_PLUGIN_PROMPT = webPluginPromptText.trim();