@anweat/dsh-browser 0.1.4 → 0.1.6

package/README.md

@@ -1,92 +1,229 @@
-# dsh-browser
-
-自包含的浏览器运行时插件 for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）。
-
-把 **Playwright（chromium 内核）** 与 **OpenCLI** 作为插件自身的 npm 依赖打包（优先插件本地，缺省回退全局复用），对外提供一个 `browser` 服务 + 一组交互式浏览器工具。`dsh-web-search-pro` 通过 `inject: ['browser']` 注入该服务，驱动它的 playwright / opencli 后端——**不再依赖全局 CLI**。
-
-## 安装
-
-```bash
-dsh plugin --profile web add @anweat/dsh-browser
-# 或本地目录 / tarball：
-dsh plugin --profile web add ./dsh-browser
-# 重启（web profile 关闭了 HMR）：
-dsh --profile web
-```
-
-> 依赖 `@deepseek-ai/*` 已发布到 npm（`^0.1.0-rc.6`）。
-> 若你的 harness 是本地源码 checkout（如 `0.1.0-rc.5`），版本号可能有出入——用
-> `dsh plugin --profile web add ./<path>` 并在 profile 的 `pnpm-workspace.yaml`
-> 里对齐版本后重装即可。
-
-## 内核与依赖的"打包 vs 复用"
-
-| 层 | 实际是什么 | 打包还是复用 |
-|---|---|---|
-| **chromium 内核** | 共享缓存 `%LOCALAPPDATA%\ms-playwright`（约 400MB） | **永远复用共享缓存**，不塞进插件、不重复下载；缺失时 `browser_install` 一键补 |
-| **playwright 驱动**（JS 包） | `playwright` npm 依赖 | 插件本地 node_modules 优先，缺省回退全局 npm |
-| **opencli**（纯 Node CLI） | `@jackwener/opencli` npm 依赖 | 同上，本地优先 / 全局复用 |
-
-## 服务：`browser`
-
-`dsh-browser` 在 `apply()` 里 `ctx.provide('browser', service)`。任何插件声明
-`inject: ['browser']` 即可消费：
-
-```ts
-export const inject = ['tools', 'browser']
-export function apply(ctx: Context) {
-  const browser = ctx.get('browser') as BrowserService
-  // browser.render / snapshot / searchResults / opencli / open / click / type / scroll / read / screenshot / close
-}
-```
-
-服务接口（结构性，无需共享类型包）见 `src/browser-service.ts`。
-
-## 工具（9 个）
-
-| 工具 | 作用 |
-|---|---|
-| `browser_open` | 打开 URL，返回标题/可读文本/全页截图路径（持久页会话） |
-| `browser_click` | 按 CSS 选择器点击 |
-| `browser_type` | 向 input/textarea 输入 |
-| `browser_scroll` | 纵向滚动（触发懒加载） |
-| `browser_read` | 读当前页 URL/标题/文本（不截图） |
-| `browser_screenshot` | 当前页全页截图 |
-| `browser_close` | 关闭当前页（下次 open 全新） |
-| `browser_status` | 运行时状态（channel/headless/chromium 是否就绪/opencli 是否启用/当前页） |
-| `browser_install` | 安装 playwright chromium（`browser_status` 报缺失时执行一次） |
-
-## 配置（cordis.yml / patch config）
-
-```yaml
-- insert:
-    - id: browser
-      name: '@anweat/dsh-browser'
-      config:
-        channel: chromium        # 'chromium'（打包内核）| 'msedge'（系统 Edge）
-        headless: true
-        opencliEnabled: true
-        storageStatePath: ''     # Playwright 登录态 JSON（复用已登录会话）
-        autoInstall: false       # 缺内核时是否自动 install chromium
-        verbose: false
-```
-
-## 登录态复用
-
-- `channel: chromium` + `storageStatePath` 指向一份 storageState JSON，即可用你已登录的身份抓受限页面。
-- 生成登录态：`npx playwright codegen --save-storage=storageState.json`（或复用 `dsh-web-search-pro` 的 `scripts/save-login.mjs`），把产物路径填进 `storageStatePath`。
-- opencli 的社交平台后端（小红书/推特/Reddit/IG/FB）仍需浏览器扩展 + 登录态在线，即使 opencli 已打包为依赖也绕不开扩展。
-
-## 发布 / 构建
-
-```bash
-pnpm install          # 装依赖（playwright / opencli / @deepseek-ai/*）
-pnpm run build        # tsc → lib/
-node scripts/install-browser.mjs   # 安装 chromium 内核（发布前验证，可选）
-```
-
-## 与 dsh-web-search-pro 的关系
-
-`dsh-web-search-pro` 现在 `inject: ['browser']`，其 `web_snapshot` / `web_fetch_pro`(playwright 后端) /
-`web_platform_search`(中文社区 playwright + 社交平台 opencli) 全部走本插件的 `browser` 服务。
-两者可独立安装，但 web-search-pro 的浏览器类能力依赖 dsh-browser 先行提供 `browser` 服务（Cordis `inject` 自动排序，无需手动控制挂载顺序）。
+# dsh-browser
+
+自包含的浏览器运行时插件 for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）。
+
+把 **Playwright（chromium 内核）** 与 **OpenCLI** 作为插件自身的 npm 依赖打包（优先插件本地，缺省回退全局复用），对外提供一个 `browser` 服务 + 一组交互式浏览器工具。`dsh-web-search-pro` 通过 `inject: ['browser']` 注入该服务，驱动它的 playwright / opencli 后端——**不再依赖全局 CLI**。
+
+## 安装
+
+```bash
+dsh plugin --profile web add @anweat/dsh-browser
+# 或本地目录 / tarball：
+dsh plugin --profile web add ./dsh-browser
+# 重启（web profile 关闭了 HMR）：
+dsh --profile web
+```
+
+> 依赖 `@deepseek-ai/*` 已发布到 npm（`^0.1.0-rc.6`）。
+> 若你的 harness 是本地源码 checkout（如 `0.1.0-rc.5`），版本号可能有出入——用
+> `dsh plugin --profile web add ./<path>` 并在 profile 的 `pnpm-workspace.yaml`
+> 里对齐版本后重装即可。
+
+## 快速使用与适用情形
+
+安装并重启后，可先让模型调用 `browser_status`，再按任务选择工具：
+
+| 情形 | 推荐方式 | 关键边界 |
+|---|---|---|
+| 公开网页读取、截图 | `browser_open` → `browser_read` / `browser_screenshot` | 不需要登录态 |
+| 表单、分页、懒加载 | `browser_click` / `browser_type` / `browser_scroll` | 选择器由调用方明确提供 |
+| 登录后站点 | `authProfile` | 必须配置 `allowedDomains`；默认不回写 Cookie |
+| 固定站点增强 | `rulePack` | 只允许有界步骤；本地 init script 必须 SHA-256 固定且 ≤64KB |
+| 模型生成的多步操作 | `browser_recipe_run` | 声明式步骤；包含页面写操作时触发 DSH 原生一次性审批 |
+| 默认只读脚本 | `browser_script_catalog` → `browser_script_run_builtin` | 内置 article/links/JSON-LD/forms，不执行外来代码 |
+| 外部模型生成 UserScript | `browser_script_validate` → `browser_userscript_run` | 必须 `@match` + `@grant none`；执行前原生审批 |
+| Reddit/小红书等 OpenCLI 平台 | `browser_opencli_status` / `browser_opencli_run` | 通用调用始终审批；Chrome 扩展与目标站点登录态必须在线 |
+
+DSH 会话示例：
+
+```text
+先调用 browser_status；然后用 browser_open 打开目标页。
+若页面需要登录，使用 authProfile=forum；不要把 Cookie 放进工具参数。
+```
+
+## 内核与依赖的"打包 vs 复用"
+
+| 层 | 实际是什么 | 打包还是复用 |
+|---|---|---|
+| **chromium 内核** | 共享缓存 `%LOCALAPPDATA%\ms-playwright`（约 400MB） | **永远复用共享缓存**，不塞进插件、不重复下载；缺失时 `browser_install` 一键补 |
+| **playwright 驱动**（JS 包） | `playwright` npm 依赖 | 插件本地 node_modules 优先，缺省回退全局 npm |
+| **opencli**（纯 Node CLI） | `@jackwener/opencli` npm 依赖 | 同上，本地优先 / 全局复用 |
+
+## 服务：`browser`
+
+`dsh-browser` 在 `apply()` 里 `ctx.provide('browser', service)`。任何插件声明
+`inject: ['browser']` 即可消费：
+
+```ts
+export const inject = ['tools', 'browser']
+export function apply(ctx: Context) {
+  const browser = ctx.get('browser') as BrowserService
+  // browser.render / snapshot / searchResults / opencli / recipe /
+  // runBuiltinScript / runUserscript / open / click / type / scroll / read / screenshot / close
+}
+```
+
+服务接口（结构性，无需共享类型包）见 `src/browser-service.ts`。
+
+## 工具（16 个）
+
+| 工具 | 作用 |
+|---|---|
+| `browser_open` | 打开 URL，返回标题/可读文本/全页截图路径（持久页会话） |
+| `browser_click` | 按 CSS 选择器点击 |
+| `browser_type` | 向 input/textarea 输入 |
+| `browser_scroll` | 纵向滚动（触发懒加载） |
+| `browser_read` | 读当前页 URL/标题/文本（不截图） |
+| `browser_screenshot` | 当前页全页截图 |
+| `browser_close` | 关闭当前页（下次 open 全新） |
+| `browser_status` | 运行时状态（channel/headless/chromium 是否就绪/opencli 是否启用/当前页） |
+| `browser_install` | 安装 playwright chromium（`browser_status` 报缺失时执行一次） |
+| `browser_script_catalog` | 列出内置只读脚本及其 SHA-256 |
+| `browser_script_validate` | 解析外部 UserScript 的元数据、域名、grant、能力与哈希，不执行 |
+| `browser_script_run_builtin` | 在独立 Playwright context 中运行内置只读脚本 |
+| `browser_userscript_run` | 运行外部 UserScript；强制域名匹配和 DSH 原生一次性审批 |
+| `browser_recipe_run` | 最多 25 步 Playwright Recipe；支持等待、定位、表单、键盘、提取、断言和截图 |
+| `browser_opencli_status` | 实际运行 OpenCLI doctor，报告 daemon/extension/profile 连通性 |
+| `browser_opencli_run` | 通用 OpenCLI argv 网关；始终触发 DSH 原生一次性审批 |
+
+## 外部模型脚本：推荐流程
+
+外部模型可以输出 Tampermonkey/UserScript 格式源码，但不要直接执行。让当前 DSH Agent 先调用
+`browser_script_validate`，展示名称、`@match`、SHA-256 和能力，再调用
+`browser_userscript_run`。执行调用会进入 Harness 的 `tools/pre-execute → approval` 原生流程；用户拒绝、
+没有 approval 服务或调用不属于 Agent 时都不会运行。
+
+最小脚本示例：
+
+```js
+// ==UserScript==
+// @name Read Search Cards
+// @match https://example.com/search*
+// @grant none
+// ==/UserScript==
+return [...document.querySelectorAll('.result')].slice(0, 20).map(card => ({
+  title: card.querySelector('h2')?.textContent?.trim() || '',
+  url: card.querySelector('a')?.href || '',
+}))
+```
+
+当前兼容的是 UserScript 元数据和页面脚本执行模型，不模拟完整 Tampermonkey：
+
+- 只支持 `@grant none`；`GM_cookie`、`GM_xmlhttpRequest`、`unsafeWindow` 等不提供。
+- 不支持 `@require`，避免审批过的源码在运行时再拉取未审查代码。
+- 源码 ≤64KB、结果 ≤100,000 字符、单次运行最长 30 秒。
+- 使用显式 URL，新建独立 Playwright context；需要登录态时只能选已限域的 `authProfile`。
+- 审批代表允许该脚本以当前站点登录身份操作页面；静态能力报告只用于解释，不是沙箱。
+
+常见读取任务优先用内置脚本：`article-clean`、`links`、`jsonld`、`forms`。它们不返回表单当前值，
+也不触发点击或网络写操作。
+
+## Playwright Recipe
+
+Recipe 适合让模型生成可审计、可复现的多步操作，不必生成 JavaScript：
+
+```json
+{
+  "url": "https://example.com/search",
+  "steps": [
+    { "type": "wait", "condition": "selector", "value": "#query" },
+    { "type": "fill", "selector": "#query", "value": "DeepSeek Harness" },
+    { "type": "press", "selector": "#query", "key": "Enter" },
+    { "type": "wait", "condition": "load" },
+    { "type": "extract", "selector": "main", "mode": "links", "limit": 30 },
+    { "type": "screenshot" }
+  ]
+}
+```
+
+支持的步骤为：`wait`、`click`、`fill`、`type`、`press`、`select`、`check`、`hover`、
+`scroll`、`extract`、`assert`、`screenshot`。纯读取步骤直接执行；出现点击、输入、键盘、选择、
+勾选、悬停或滚动时，整个 Recipe 只询问一次审批，批准后顺序执行。
+
+## 配置（cordis.yml / patch config）
+
+```yaml
+- insert:
+    - id: browser
+      name: '@anweat/dsh-browser'
+      config:
+        channel: chromium        # 'chromium'（打包内核）| 'msedge'（系统 Edge）
+        headless: true
+        opencliEnabled: true
+        storageStatePath: ''     # Playwright 登录态 JSON（复用已登录会话）
+        authProfiles:
+          forum:
+            storageStatePath: 'D:/secrets/forum.json'
+            allowedDomains: [example.com]
+            persistState: false  # 默认只读；true 才会原子回写刷新后的状态
+        rulePacks:
+          forum-enhanced:
+            matches: [example.com]
+            initScriptPath: 'D:/dsh/rules/forum.js'
+            initScriptSha256: '<64位sha256>'
+            steps:
+              - { type: waitFor, selector: '#results', timeoutMs: 10000 }
+              - { type: scroll, deltaY: 1600, repeat: 2, waitMs: 300 }
+        autoInstall: false       # 缺内核时是否自动 install chromium
+        verbose: false
+```
+
+## 登录态复用
+
+- `channel: chromium` + `storageStatePath` 指向一份 storageState JSON，即可用你已登录的身份抓受限页面。
+- 新配置优先使用 `authProfiles`：按名称复用全局登录态，但必须用 `allowedDomains` 限域；默认只读，避免一次搜索意外改写 Cookie Vault。
+- `browser_open` 和 web-search-pro 的平台搜索可选择 `authProfile` / `rulePack`。`browser_status` 只显示 profile 名称、域名和回写状态，不显示文件路径或 Cookie。
+- RulePack 仍只允许有界动作；init script 必须是本地、SHA-256 固定且不超过 64KB。外部模型 JavaScript 使用独立的 UserScript 工具，并强制一次性审批，不能冒充 RulePack。
+- 生成登录态：`npx playwright codegen --save-storage=storageState.json`（或复用 `dsh-web-search-pro` 的 `scripts/save-login.mjs`），把产物路径填进 `storageStatePath`。
+- opencli 的社交平台后端（小红书/推特/Reddit/IG/FB）仍需浏览器扩展 + 登录态在线，即使 opencli 已打包为依赖也绕不开扩展。
+
+### OpenCLI 连接检查
+
+插件运行时优先使用自己依赖的 OpenCLI。需要在终端排查 Browser Bridge 时，可全局安装同一 CLI 并检查：
+
+```bash
+npm i -g @jackwener/opencli
+opencli daemon status
+opencli doctor
+```
+
+健康状态应同时包含 daemon running、extension connected 和一个 connected Chrome profile。仅安装 npm 包不等于 Browser Bridge 可用；Chrome 扩展断开时，OpenCLI 社区搜索会明确失败，而普通 Playwright 浏览器工具不受影响。
+
+插件内先调用 `browser_opencli_status`，不要只看 `browser_status.opencliEnabled`。后者表示配置开关，
+前者才是真实连接。通用调用以 argv 数组传入，不经过 shell，也不会自行拼接引号：
+
+```json
+{
+  "profile": "chrome",
+  "args": ["reddit", "search", "DeepSeek Harness", "-f", "json"]
+}
+```
+
+优先级建议：已有站点 adapter（`opencli <site> <command>`）→ `opencli web read` / `extract` →
+`browser network` → DOM state/find/action → 最后才是只读 `eval`。`opencli browser` 必须包含显式 session：
+
+```text
+["browser", "research", "open", "https://example.com"]
+["browser", "research", "state"]
+["browser", "research", "network", "--filter", "title,url"]
+["browser", "research", "extract", "--selector", "main"]
+["browser", "research", "close"]
+```
+
+`browser_opencli_run` 是通用高级入口，可能调用发布、删除、发帖等 adapter，因此无论命令看起来是否只读，
+都要求原生一次性审批。常规搜索仍优先走 `dsh-web-search-pro` 的只读工具。
+
+## 发布 / 构建
+
+```bash
+pnpm install          # 装依赖（playwright / opencli / @deepseek-ai/*）
+pnpm test
+pnpm run build        # tsc → lib/
+node scripts/install-browser.mjs   # 安装 chromium 内核（发布前验证，可选）
+```
+
+## 与 dsh-web-search-pro 的关系
+
+`dsh-web-search-pro` 现在 `inject: ['browser']`，其 `web_snapshot` / `web_fetch_pro`(playwright 后端) /
+`web_platform_search`(中文社区 playwright + 社交平台 opencli) 全部走本插件的 `browser` 服务。
+两者可独立安装，但 web-search-pro 的浏览器类能力依赖 dsh-browser 先行提供 `browser` 服务（Cordis `inject` 自动排序，无需手动控制挂载顺序）。

package/cordis.patch.yml

@@ -1,15 +1,15 @@
-# dsh-browser bundle patch — installs the browser runtime as one more row over
-# the active profile. Install with:
-#   dsh plugin --profile <name> add @anweat/dsh-browser
-# then boot the profile (the web profile has HMR disabled, so a restart applies it).
-#
-# Login state: set `storageStatePath` to a Playwright storageState JSON (see
-# README) to reuse an already-logged-in browser session.
-- insert:
-    - id: browser
-      name: '@anweat/dsh-browser'
-      config:
-        channel: chromium
-        headless: true
-        opencliEnabled: true
-        verbose: false
+# dsh-browser bundle patch — installs the browser runtime as one more row over
+# the active profile. Install with:
+#   dsh plugin --profile <name> add @anweat/dsh-browser
+# then boot the profile (the web profile has HMR disabled, so a restart applies it).
+#
+# Login state: prefer named `authProfiles` with explicit `allowedDomains` (see
+# README). `storageStatePath` remains as a legacy global fallback.
+- insert:
+    - id: browser
+      name: '@anweat/dsh-browser'
+      config:
+        channel: chromium
+        headless: true
+        opencliEnabled: true
+        verbose: false

package/lib/approval-policy.d.ts

@@ -0,0 +1,11 @@
+/** Approval classification for multi-action and arbitrary-code browser tools. */
+export type BrowserPolicyDecision = {
+    kind: 'allow';
+} | {
+    kind: 'deny';
+    reason: string;
+} | {
+    kind: 'ask';
+    reason: string;
+};
+export declare function browserPolicyDecision(name: string, args: unknown): BrowserPolicyDecision;

package/lib/approval-policy.js

@@ -0,0 +1,33 @@
+/** Approval classification for multi-action and arbitrary-code browser tools. */
+import { recipeNeedsApproval } from "./automation.js";
+import { validateUserscript } from "./scripts.js";
+export function browserPolicyDecision(name, args) {
+    if (name === 'browser_userscript_run') {
+        const input = args;
+        if (typeof input.source !== 'string' || typeof input.url !== 'string')
+            return { kind: 'deny', reason: 'external userscript requires source and URL' };
+        const validation = validateUserscript(input.source, input.url);
+        if (!validation.valid)
+            return { kind: 'deny', reason: 'invalid external userscript: ' + validation.errors.join('; ') };
+        const host = new URL(input.url).hostname;
+        return {
+            kind: 'ask',
+            reason: `Run external userscript "${validation.metadata.name}" (${validation.sha256.slice(0, 12)}) on ${host}; capabilities: ${validation.capabilities.join(', ')}`,
+        };
+    }
+    if (name === 'browser_opencli_run') {
+        const input = args;
+        const argv = Array.isArray(input.args) ? input.args.filter(value => typeof value === 'string') : [];
+        return { kind: 'ask', reason: 'Run a general OpenCLI command with the logged-in Chrome profile: ' + (argv.slice(0, 3).join(' ') || '(empty)') };
+    }
+    if (name === 'browser_recipe_run') {
+        const input = args;
+        const steps = Array.isArray(input.steps) ? input.steps : [];
+        if (recipeNeedsApproval(steps)) {
+            const actions = [...new Set(steps.map(step => step.type).filter(type => !['wait', 'extract', 'assert', 'screenshot'].includes(type)))];
+            return { kind: 'ask', reason: 'Run a multi-step Playwright recipe with page mutations: ' + actions.join(', ') };
+        }
+    }
+    return { kind: 'allow' };
+}
+//# sourceMappingURL=approval-policy.js.map

package/lib/approval-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-policy.js","sourceRoot":"","sources":["../src/approval-policy.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,EAAE,mBAAmB,EAA0B,MAAM,iBAAiB,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAOjD,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,IAAa;IAC/D,IAAI,IAAI,KAAK,wBAAwB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAA2C,CAAA;QACzD,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,6CAA6C,EAAE,CAAA;QACrJ,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9D,IAAI,CAAC,UAAU,CAAC,KAAK;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,+BAA+B,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;QACtH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;QACxC,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,4BAA4B,UAAU,CAAC,QAAQ,CAAC,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,IAAI,mBAAmB,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACpK,CAAA;IACH,CAAC;IACD,IAAI,IAAI,KAAK,qBAAqB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAA0B,CAAA;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAa,CAAC,CAAC,CAAC,EAAE,CAAA;QAC/G,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,mEAAmE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,EAAE,CAAA;IACjJ,CAAC;IACD,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAA2B,CAAA;QACzC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAA4B,CAAC,CAAC,CAAC,EAAE,CAAA;QAClF,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;YACtI,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,0DAA0D,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;QACjH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;AAC1B,CAAC"}

package/lib/auth-profiles.d.ts

@@ -0,0 +1,20 @@
+export interface AuthProfileConfig {
+    storageStatePath: string;
+    allowedDomains: string[];
+    /** Persist cookies/localStorage back after a transient context closes. Defaults to false. */
+    persistState?: boolean;
+}
+export interface ResolvedAuthProfile extends AuthProfileConfig {
+    id: string;
+    persistState: boolean;
+}
+export declare class AuthProfileStore {
+    private readonly profiles;
+    constructor(profiles?: Record<string, AuthProfileConfig>);
+    resolve(id: string, targetUrl: string): ResolvedAuthProfile;
+    list(): {
+        id: string;
+        allowedDomains: string[];
+        persistState: boolean;
+    }[];
+}

package/lib/auth-profiles.js

@@ -0,0 +1,28 @@
+function hostAllowed(hostname, domains) {
+    const host = hostname.toLowerCase().replace(/\.$/, '');
+    return domains.some(value => {
+        const domain = value.toLowerCase().trim().replace(/^\*\./, '').replace(/\.$/, '');
+        return domain.length > 0 && (host === domain || host.endsWith('.' + domain));
+    });
+}
+export class AuthProfileStore {
+    profiles;
+    constructor(profiles = {}) {
+        this.profiles = profiles;
+    }
+    resolve(id, targetUrl) {
+        const profile = this.profiles[id];
+        if (!profile)
+            throw new Error('unknown auth profile: ' + id);
+        const url = new URL(targetUrl);
+        if (!hostAllowed(url.hostname, profile.allowedDomains ?? []))
+            throw new Error('auth profile ' + id + ' is not allowed for ' + url.hostname);
+        if (!profile.storageStatePath?.trim())
+            throw new Error('auth profile ' + id + ' has no storageStatePath');
+        return { id, ...profile, persistState: profile.persistState ?? false };
+    }
+    list() {
+        return Object.entries(this.profiles).sort(([a], [b]) => a.localeCompare(b)).map(([id, profile]) => ({ id, allowedDomains: [...(profile.allowedDomains ?? [])], persistState: profile.persistState ?? false }));
+    }
+}
+//# sourceMappingURL=auth-profiles.js.map

package/lib/auth-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-profiles.js","sourceRoot":"","sources":["../src/auth-profiles.ts"],"names":[],"mappings":"AAYA,SAAS,WAAW,CAAC,QAAgB,EAAE,OAA0B;IAC/D,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACtD,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;QACjF,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,WAA8C,EAAE;QAAhD,aAAQ,GAAR,QAAQ,CAAwC;IAAG,CAAC;IAEjF,OAAO,CAAC,EAAU,EAAE,SAAiB;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QACjC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAA;QAC5D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAA;QAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,EAAE,GAAG,sBAAsB,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC3I,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,EAAE,GAAG,0BAA0B,CAAC,CAAA;QACzG,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK,EAAE,CAAA;IACxE,CAAC;IAED,IAAI;QACF,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK,EAAE,CAAC,CAAC,CAAA;IAChN,CAAC;CACF"}

package/lib/automation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Bounded, auditable Playwright recipes for model-generated browser flows.
+ * Recipes deliberately expose named operations instead of arbitrary JavaScript.
+ * @module dsh-browser/automation
+ */
+export type BrowserRecipeStep = {
+    type: 'wait';
+    condition: 'selector' | 'text' | 'load' | 'time';
+    value?: string;
+    waitMs?: number;
+    timeoutMs?: number;
+} | {
+    type: 'click';
+    selector: string;
+    timeoutMs?: number;
+} | {
+    type: 'fill';
+    selector: string;
+    value: string;
+    timeoutMs?: number;
+} | {
+    type: 'type';
+    selector: string;
+    value: string;
+    timeoutMs?: number;
+} | {
+    type: 'press';
+    key: string;
+    selector?: string;
+} | {
+    type: 'select';
+    selector: string;
+    value: string;
+} | {
+    type: 'check';
+    selector: string;
+    checked?: boolean;
+} | {
+    type: 'hover';
+    selector: string;
+} | {
+    type: 'scroll';
+    deltaY?: number;
+    waitMs?: number;
+} | {
+    type: 'extract';
+    selector?: string;
+    mode?: 'text' | 'html' | 'links' | 'attribute';
+    attribute?: string;
+    limit?: number;
+} | {
+    type: 'assert';
+    selector?: string;
+    text?: string;
+    timeoutMs?: number;
+} | {
+    type: 'screenshot';
+};
+export interface RecipeStepResult {
+    step: number;
+    action: BrowserRecipeStep['type'];
+    ok: boolean;
+    value?: string;
+}
+export declare function validateRecipe(steps: readonly BrowserRecipeStep[]): void;
+export declare function recipeNeedsApproval(steps: readonly BrowserRecipeStep[]): boolean;
+export declare function runRecipe(page: any, steps: readonly BrowserRecipeStep[], captureScreenshot: () => Promise<string>, signal?: AbortSignal): Promise<RecipeStepResult[]>;