dsh-web-search-pro 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-web-search-pro contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LOGIN.md

@@ -0,0 +1,67 @@
+# 中文社区平台登录态（复用你已登录的浏览器）
+
+知乎 / 微博 / 豆瓣 / 贴吧 / 抖音 / 快手 / 小红书的搜索页都有反爬与登录墙，
+免登录的公开接口基本都被风控。所以这些平台走 **Playwright 驱动登录态浏览器** 的路径：
+在你已登录的浏览器里打开搜索页、读渲染结果——不需要逆向任何签名。
+
+## 方式一：登录一次保存登录态（推荐）
+
+运行插件包里的脚本，按提示逐个平台登录一次（扫码/账号密码），
+脚本会把所有 cookies 合并保存成一个 storageState JSON：
+
+```bash
+cd dsh-web-search-pro
+node scripts/save-login.mjs all login-state.json
+# 或只登录一个平台：
+node scripts/save-login.mjs zhihu login-state.json
+```
+
+然后把文件路径填到 `$DSH_HOME/settings.yaml`：
+
+```yaml
+web-search-pro:
+  playwright:
+    storageStatePath: 'login-state.json'   # 绝对路径更稳
+```
+
+> storageState 是 Playwright 的标准登录态文件（cookies + origins），
+> 同一份文件可同时含多个站点的登录态（脚本会依次登录并合并）。
+
+## 方式二：用 Cookie 插件导出
+
+如果你更习惯手动导出：
+
+1. 在浏览器装 Cookie-Editor（或 EditThisCookie）。
+2. 在目标站点导出 cookies（JSON）。
+3. 组装成 storageState 格式：
+
+```json
+{ "cookies": [ ...导出的 cookies... ], "origins": [] }
+```
+
+每个 cookie 至少需要 `name` `value` `domain` `path`（可补 `expires` `httpOnly` `secure`）。
+
+## 结果选择器可配置
+
+站点改版后如果提取不到结果，不用改代码——在 `settings.yaml` 按平台覆盖选择器：
+
+```yaml
+web-search-pro:
+  platformRules:
+    zhihu:
+      item: '.SearchResult-Card'
+      title: '.ContentItem-title'
+      link: '.ContentItem-title a'
+      text: '.Highlight'
+    weibo:
+      item: '.card-wrap'
+      title: '.txt'
+      link: '.from a'
+```
+
+## 安全与合规提醒
+
+- 仅做**单次、低频**的搜索调用，不要批量爬取；遵守目标平台的服务条款与 robots.txt。
+- 登录态文件包含你的登录凭据，请勿提交到公开仓库或分享给他人。
+- 本能力借鉴 MediaCrawler 的思路（登录态浏览器驱动搜索页），
+  但为 MIT 许可的独立实现，未使用其 NON-COMMERCIAL 许可下的签名算法代码。

package/README.md

@@ -0,0 +1,123 @@
+# dsh-web-search-pro
+
+增强型、可持久化的扩展网页搜索插件 for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）。
+
+一个 DSH **bundle 插件**，把多引擎网页搜索、平台搜索、持久化缓存、脚本猫式按站提取、Playwright 渲染打包成模型可直接调用的 9 个工具。灵感来自 [MediaCrawler](https://github.com/NanmiCoder/MediaCrawler)、[Agent-Reach](https://github.com/Panniantong/Agent-Reach)、脚本猫/油猴 userscript、opencli 与 playwright。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-web-search-pro   # 自动装 dsh-browser（dependency）+ 自动挂载 browser 行（本 patch）
+# 或本地目录 / tarball：
+dsh plugin --profile web add ./dsh-web-search-pro
+# 重启（web profile 关闭了 HMR）：
+dsh --profile web
+```
+
+> dsh-browser 需先发布到 npm（本地测试可用 `dsh plugin --profile web add ../dsh-browser ../dsh-web-search-pro` 一条命令显式列两个）。
+> 依赖 `@deepseek-ai/*` 已发布到 npm（`^0.1.0-rc.6`，与社区 dsh-cc-tui 一致）。
+> 若你的 harness 是本地源码 checkout（如 `0.1.0-rc.5`），版本号可能有出入——用
+> `dsh plugin --profile web add ./<path>` 并在 profile 的 `pnpm-workspace.yaml`
+> 里对齐版本后重装即可。
+
+## 工具（9 个）
+
+| 工具 | 作用 |
+|---|---|
+| `web_search_pro` | 多引擎搜索 + RRF 融合 + 内存/SQLite 双层缓存 + 历史 |
+| `web_fetch_pro` | 可读化抓取（Jina → HTTP+规则抽取 → Playwright 兜底）+ 快照缓存 |
+| `web_platform_search` | 20 平台：GitHub/B站/YouTube/V2EX/小红书/Twitter/Reddit/IG/FB/RSS + 知乎/微博/豆瓣/贴吧/抖音/快手（Playwright 登录态） |
+| `web_snapshot` | Playwright 全页截图 + HTML + 文本落盘 |
+| `web_history` / `web_cache_clear` / `web_search_stats` | 持久历史 / 清缓存 / 存储统计 |
+| `web_rule` | 持久化按站提取规则（脚本猫式，list/upsert/remove） |
+| `web_deps` | 检测/安装外部依赖（gh/bili/yt-dlp/opencli/agent-reach/mcporter/playwright） |
+
+## 配置
+
+三层，越靠前越日常：
+
+1. **`$DSH_HOME/settings.yaml` → `web-search-pro:` 段**（热重载，改完即生效）：
+
+   ```yaml
+   web-search-pro:
+     exaApiKey: 'sk-...'       # 或环境变量 EXA_API_KEY / .credentials.yaml
+     jinaApiKey: 'jina_...'    # 或环境变量 JINA_API_KEY
+     engines: [ddg, bing, exa, seam, jina]
+     parallelEngines: false
+     ttlSeconds: 3600
+     searchMaxResults: 8
+   ```
+
+2. **cordis.yml `config:`**（部署级默认值，见 `cordis.patch.yml`）。
+3. **环境变量 / 凭据**：`$EXA_API_KEY`、`$JINA_API_KEY`（`exaApiKeyEnv`/`jinaApiKeyEnv` 引用）。
+
+## 外部依赖（按需）
+
+多数后端需要系统额外安装的工具；插件提供 `web_deps` 工具检测与安装：
+
+| 依赖 | 用途 | 安装 |
+|---|---|---|
+| gh | GitHub 后端 | `winget install GitHub.cli` / `choco install gh` |
+| bili-cli | B站后端 | `uv tool install bili-cli` / `pipx install bili-cli` |
+| yt-dlp | YouTube 后端 | `uv tool install yt-dlp` / `pip install yt-dlp` |
+| opencli | 小红书/Twitter/Reddit/IG/FB | `npm i -g opencli` |
+| agent-reach | agent-reach 后端 | `uv tool install agent-reach` / `pip install agent-reach` |
+| playwright | 渲染/截图后端 | `npm i -g playwright && playwright install chromium` |
+
+## 平台与引擎
+
+`seam`（ctx.web/DeepSeek 原生）· `exa` · `ddg` · `bing` · `jina` · `github` · `bilibili` · `v2ex` · `youtube`。默认顺序 `ddg, bing, exa, seam, jina`（免费优先），失败自动回退；`multi` 并行融合。
+
+## 开发
+
+```bash
+pnpm install
+pnpm build        # tsc src → lib
+```
+
+源码在 `src/`；`lib/` 为发布产物（已提交）。
+
+## License
+
+MIT
+
+
+## 中文社区平台登录态
+
+zhihu / weibo / douban / tieba / douyin / kuaishou 的免登录公开接口都被风控，
+所以走 **Playwright 驱动登录态浏览器**（借鉴 MediaCrawler 思路、MIT 独立实现，未用其签名算法）：
+
+1. 登录一次保存登录态：`node scripts/save-login.mjs all login-state.json`
+2. 在 `$DSH_HOME/settings.yaml` 里设 `playwright.storageStatePath`
+3. 站点改版时无需改代码，用 `platformRules` 按平台覆盖结果选择器
+
+详见 [LOGIN.md](./LOGIN.md)。
+
+
+## 历史管理
+
+web_history 支持：kind/query/engine/platform 过滤、replay（用 queryId 回放已存结果）、
+export（把过滤后的历史+结果写成 JSON 文件）。
+
+## 自定义平台（解析 cookie 去搜索）
+
+在 settings.yaml 里定义任意站点（URL 模板 + 结果选择器 + 可选 Cookie），
+web_platform_search 就能直接搜它——不需要改代码：
+
+    web-search-pro:
+      customPlatforms:
+        mybili:
+          name: '我的B站'
+          url: 'https://search.bilibili.com/all?keyword={query}'
+          item: '.bili-video-card'
+          title: '.bili-video-card__info--tit'
+          link: 'a'
+        # 需要登录的站点补 cookie（a=b; c=d，自动应用到 url 域名）
+        myforum:
+          name: '某论坛'
+          url: 'https://forum.example.com/search?q={query}'
+          item: '.thread'
+          title: '.thread-title a'
+          link: '.thread-title a'
+          cookie: 'sessionid=abc123; csrftoken=xyz'
+

package/cordis.patch.yml

@@ -0,0 +1,21 @@
+# dsh-web-search-pro bundle patch.
+#
+# Install (self-contained — also pulls in dsh-browser as a dependency):
+#   dsh plugin --profile <name> add dsh-web-search-pro
+#
+# The patch inserts BOTH rows: browser (the dsh-browser runtime this plugin
+# injects) and web-search-pro. dsh-browser is declared as a regular
+# dependency in package.json, so pnpm installs it; because dsh plugin
+# reconcile only auto-mounts DIRECT dependencies' patches, the parent plugin
+# inserts the child's row here so one command activates both.
+- insert:
+    - id: browser
+      name: dsh-browser
+      config:
+        channel: chromium
+        headless: true
+        opencliEnabled: true
+    - id: web-search-pro
+      name: dsh-web-search-pro
+      config:
+        verbose: false

package/lib/browser-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Consumer-side contract for the `browser` service provided by the dsh-browser
+ * plugin. web-search-pro injects it (inject: ['browser']) and calls these
+ * methods instead of its former local PlaywrightManager / global opencli.
+ * @module web-search-pro/browser-service
+ */
+export interface RenderRule {
+    hostname: string;
+    contentSelectors: string[];
+    removeSelectors?: string[];
+}
+export interface BrowserRenderResult {
+    title: string;
+    text: string;
+    html: string;
+    usedRule?: string;
+}
+export interface BrowserSnapshotResult {
+    title: string;
+    text: string;
+    screenshotPath: string;
+    htmlPath: string;
+    usedRule?: string;
+}
+export interface BrowserSearchItem {
+    url: string;
+    title: string;
+    snippet?: string;
+}
+export interface BrowserCliResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+export interface BrowserService {
+    render(url: string, rules: readonly RenderRule[], opts?: {
+        signal?: AbortSignal;
+        maxChars?: number;
+        waitMs?: number;
+    }): Promise<BrowserRenderResult>;
+    snapshot(url: string, rules: readonly RenderRule[], opts: {
+        signal?: AbortSignal;
+        outDir: string;
+        maxChars?: number;
+    }): Promise<BrowserSnapshotResult>;
+    searchResults(url: string, spec: {
+        item: string;
+        title: string;
+        link: string;
+        text?: string;
+    }, opts?: {
+        signal?: AbortSignal;
+        count?: number;
+        waitMs?: number;
+        cookies?: {
+            name: string;
+            value: string;
+            domain: string;
+            path: string;
+        }[];
+    }): Promise<BrowserSearchItem[]>;
+    opencli(args: string[], opts?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<BrowserCliResult>;
+    close(): Promise<void>;
+}

package/lib/browser-service.js

@@ -0,0 +1,8 @@
+/**
+ * Consumer-side contract for the `browser` service provided by the dsh-browser
+ * plugin. web-search-pro injects it (inject: ['browser']) and calls these
+ * methods instead of its former local PlaywrightManager / global opencli.
+ * @module web-search-pro/browser-service
+ */
+export {};
+//# sourceMappingURL=browser-service.js.map

package/lib/browser-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-service.js","sourceRoot":"","sources":["../src/browser-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/config.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Plugin configuration (schemastery) and the resolved runtime shape.
+ * @module web-search-pro/config
+ */
+import z from '@deepseek-ai/schemastery';
+/** A user-defined custom platform: search URL template + result selectors + optional login cookie. */
+export interface CustomPlatformSpec {
+    name: string;
+    /** Search-page URL template; `{query}` is replaced with the URL-encoded query. */
+    url: string;
+    item: string;
+    title: string;
+    link: string;
+    text?: string;
+    /** Optional raw Cookie header (`a=b; c=d`); cookies are applied to the URL's domain. */
+    cookie?: string;
+}
+export interface Config {
+    /** SQLite database path; defaults to $DSH_HOME/data/web-search-pro/store.db */
+    dbPath?: string;
+    /** Cache freshness window in seconds. */
+    ttlSeconds: number;
+    /** In-process LRU entry cap (hot queries resolve without touching SQLite). */
+    memoryCacheEntries: number;
+    /** Reciprocal Rank Fusion constant for multi-engine merging. */
+    rrfConstant: number;
+    /** Max recency bonus added to a source's fusion score (0..1). */
+    freshnessBoost: number;
+    /** Days over which the recency bonus decays to zero. */
+    freshnessDays: number;
+    /** Max authority-domain bonus added to a source's fusion score (0..1). */
+    authorityBoost: number;
+    /** Extra authority domains (beyond the built-in .edu/.gov/.org and the curated list). */
+    authorityDomains: string[];
+    /** Default cap on returned sources per search. */
+    searchMaxResults: number;
+    /** Cooperative per-call timeout budget in ms. */
+    timeoutMs: number;
+    /** Ordered engine list for web_search_pro. */
+    engines: string[];
+    /** Query all requested engines in parallel and merge. */
+    parallelEngines: boolean;
+    /** Exa API key (falls back to $EXA_API_KEY / credentials ref). */
+    exaApiKey?: string;
+    /** Credential/env reference for the Exa key; defaults to EXA_API_KEY. */
+    exaApiKeyEnv?: string;
+    /** Jina AI API key (falls back to $JINA_API_KEY / credentials ref). */
+    jinaApiKey?: string;
+    /** Credential/env reference for the Jina key; defaults to JINA_API_KEY. */
+    jinaApiKeyEnv?: string;
+    /** Allow CLI backends (gh / bili / yt-dlp / opencli / agent-reach). */
+    enableCliBackends: boolean;
+    /** Allow opencli browser-session backends. */
+    opencliEnabled: boolean;
+    /** Allow agent-reach backends. */
+    agentReachEnabled: boolean;
+    /** Provider id registered into ctx.web for the built-in web_search tool. */
+    providerId: string;
+    /** Register the ctx.web provider (set DSH_WEB_SEARCH_PROVIDER to use it). */
+    registerProvider: boolean;
+    /** Per-platform search-page selector overrides (item/title/link/text). Overrides built-in specs. */
+    platformRules?: Record<string, {
+        item: string;
+        title: string;
+        link: string;
+        text?: string;
+    }>;
+    /** User-defined custom platform search: url template + selectors + optional cookie. */
+    customPlatforms?: Record<string, CustomPlatformSpec>;
+    /** Snapshot options. The browser runtime itself (channel/headless/storageStatePath) is provided by the dsh-browser plugin via the `browser` service. */
+    playwright: {
+        /** Gate the playwright fallback backend in web_fetch_pro. */
+        enabled: boolean;
+        /** Directory for web_snapshot artifacts; defaults to <dbDir>/snapshots. */
+        snapshotDir?: string;
+    };
+    verbose: boolean;
+}
+export declare const Config: z<Config>;
+export interface ResolvedConfig extends Config {
+    dbPath: string;
+    exaApiKey?: string;
+    exaApiKeyEnv: string;
+    jinaApiKey?: string;
+    jinaApiKeyEnv: string;
+    playwright: Required<Pick<Config['playwright'], 'enabled' | 'snapshotDir'>>;
+}
+/** Default database path under the harness home. */
+export declare function defaultDbPath(): string;
+/** Resolve a fully-defaulted config from user input. */
+export declare function resolveConfig(config: Config): ResolvedConfig;

package/lib/config.js

@@ -0,0 +1,72 @@
+/**
+ * Plugin configuration (schemastery) and the resolved runtime shape.
+ * @module web-search-pro/config
+ */
+import path from 'node:path';
+import os from 'node:os';
+import z from '@deepseek-ai/schemastery';
+export const Config = z.object({
+    dbPath: z.string(),
+    ttlSeconds: z.number().default(3600),
+    memoryCacheEntries: z.number().default(128),
+    rrfConstant: z.number().default(60),
+    freshnessBoost: z.number().default(0.2),
+    freshnessDays: z.number().default(30),
+    authorityBoost: z.number().default(0.25),
+    authorityDomains: z.array(z.string()).default([]),
+    searchMaxResults: z.number().default(8),
+    timeoutMs: z.number().default(30_000),
+    engines: z.array(z.string()).default(['ddg', 'bing', 'exa', 'seam', 'jina']),
+    parallelEngines: z.boolean().default(false),
+    exaApiKey: z.string().role('secret'),
+    exaApiKeyEnv: z.string().default('EXA_API_KEY'),
+    jinaApiKey: z.string().role('secret'),
+    jinaApiKeyEnv: z.string().default('JINA_API_KEY'),
+    enableCliBackends: z.boolean().default(true),
+    opencliEnabled: z.boolean().default(true),
+    agentReachEnabled: z.boolean().default(true),
+    providerId: z.string().default('web-search-pro'),
+    registerProvider: z.boolean().default(false),
+    platformRules: z.dict(z.object({
+        item: z.string(),
+        title: z.string(),
+        link: z.string(),
+        text: z.string(),
+    })),
+    customPlatforms: z.dict(z.object({
+        name: z.string(),
+        url: z.string(),
+        item: z.string(),
+        title: z.string(),
+        link: z.string(),
+        text: z.string(),
+        cookie: z.string(),
+    })),
+    playwright: z.object({
+        enabled: z.boolean().default(true),
+        snapshotDir: z.string(),
+    }),
+    verbose: z.boolean().default(false),
+});
+/** Default database path under the harness home. */
+export function defaultDbPath() {
+    const home = process.env.DSH_HOME ?? path.join(os.homedir(), '.dsh');
+    return path.join(home, 'data', 'web-search-pro', 'store.db');
+}
+/** Resolve a fully-defaulted config from user input. */
+export function resolveConfig(config) {
+    const dbPath = config.dbPath ?? defaultDbPath();
+    const pw = config.playwright ?? {};
+    const snapshotDir = pw.snapshotDir ?? path.join(path.dirname(dbPath), 'snapshots');
+    return {
+        ...config,
+        dbPath,
+        exaApiKeyEnv: config.exaApiKeyEnv ?? 'EXA_API_KEY',
+        jinaApiKeyEnv: config.jinaApiKeyEnv ?? 'JINA_API_KEY',
+        playwright: {
+            enabled: pw.enabled ?? true,
+            snapshotDir,
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

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

package/lib/deps.d.ts

@@ -0,0 +1,34 @@
+/**
+ * External dependency detection and install for the CLI/platform backends.
+ * Most backends shell out to tools installed outside DSH (gh, bili, yt-dlp,
+ * opencli, agent-reach, playwright, mcporter). This module reports which are
+ * present and how to install them; the web_deps tool exposes it to the model.
+ *
+ * Install is intentionally a MODEL-FACING TOOL, not a browser settings button:
+ * a browser button running winget/pip/npm would be arbitrary command execution
+ * without a permission gate, whereas a tool flows through DSH's existing
+ * tool-permission/approval pipeline. The card points at this tool instead.
+ * @module web-search-pro/deps
+ */
+export interface DepInfo {
+    id: string;
+    label: string;
+    /** Backend that needs it. */
+    usedBy: string;
+    available: boolean;
+    path?: string;
+    installs: {
+        installer: string;
+        command: string;
+    }[];
+}
+/** Detect all backends. */
+export declare function detectDeps(): Promise<DepInfo[]>;
+/** Run the install command for one backend + installer. */
+export declare function installDep(id: string, installer: string): Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}>;
+export declare const DEP_IDS: string[];

package/lib/deps.js

@@ -0,0 +1,90 @@
+/**
+ * External dependency detection and install for the CLI/platform backends.
+ * Most backends shell out to tools installed outside DSH (gh, bili, yt-dlp,
+ * opencli, agent-reach, playwright, mcporter). This module reports which are
+ * present and how to install them; the web_deps tool exposes it to the model.
+ *
+ * Install is intentionally a MODEL-FACING TOOL, not a browser settings button:
+ * a browser button running winget/pip/npm would be arbitrary command execution
+ * without a permission gate, whereas a tool flows through DSH's existing
+ * tool-permission/approval pipeline. The card points at this tool instead.
+ * @module web-search-pro/deps
+ */
+import { runCli } from "./util.js";
+const IS_WIN = process.platform === 'win32';
+/** One external tool the plugin may shell out to. */
+const DEPS = [
+    {
+        id: 'gh', label: 'GitHub CLI', usedBy: 'github 后端',
+        installs: [
+            { installer: 'winget', command: 'winget install GitHub.cli' },
+            { installer: 'choco', command: 'choco install gh' },
+        ],
+    },
+    {
+        id: 'bili', label: 'bili-cli', usedBy: 'bilibili 后端',
+        installs: [
+            { installer: 'uv', command: 'uv tool install bili-cli' },
+            { installer: 'pipx', command: 'pipx install bili-cli' },
+            { installer: 'pip', command: 'pip install bili-cli' },
+        ],
+    },
+    {
+        id: 'yt-dlp', label: 'yt-dlp', usedBy: 'youtube 后端',
+        installs: [
+            { installer: 'uv', command: 'uv tool install yt-dlp' },
+            { installer: 'pip', command: 'pip install yt-dlp' },
+        ],
+    },
+    {
+        id: 'agent-reach', label: 'Agent-Reach', usedBy: 'agent-reach 后端',
+        installs: [
+            { installer: 'uv', command: 'uv tool install agent-reach' },
+            { installer: 'pip', command: 'pip install agent-reach' },
+        ],
+    },
+    {
+        id: 'mcporter', label: 'mcporter', usedBy: '（预留：Exa MCP 后端）',
+        installs: [
+            { installer: 'npm', command: 'npm i -g mcporter' },
+        ],
+    },
+    // opencli and playwright are NOT listed here: they are bundled (plugin-local
+    // node_modules, with global reuse fallback) in the dsh-browser plugin, which
+    // this plugin injects via the `browser` service.
+];
+/** Resolve a command on PATH (win32: where.exe; posix: sh -c command -v). */
+async function resolveCmd(cmd) {
+    const res = await runCli(IS_WIN ? 'where' : 'sh', IS_WIN ? [cmd] : ['-c', 'command -v ' + cmd], { timeoutMs: 8_000, signal: undefined, maxOutput: 64 * 1024 });
+    if (res.code !== 0)
+        return { found: false };
+    const first = res.stdout.split(/\r?\n/).find(line => line.trim().length > 0);
+    return first ? { found: true, path: first.trim() } : { found: false };
+}
+/** Detect all backends. */
+export async function detectDeps() {
+    const out = [];
+    for (const dep of DEPS) {
+        const resolved = await resolveCmd(dep.id);
+        out.push({ ...dep, available: resolved.found, ...resolved.path ? { path: resolved.path } : {} });
+    }
+    return out;
+}
+/** Run the install command for one backend + installer. */
+export async function installDep(id, installer) {
+    const dep = DEPS.find(d => d.id === id);
+    if (!dep)
+        throw new Error('unknown dependency: ' + id);
+    const target = dep.installs.find(i => i.installer === installer);
+    if (!target)
+        throw new Error('unknown installer ' + installer + ' for ' + id + '; try: ' + dep.installs.map(i => i.installer).join(', '));
+    return runCompound(target.command, 180_000);
+}
+async function runCompound(command, timeoutMs) {
+    // Split on spaces is fine for these fixed commands; quotes are not used.
+    const parts = command.split(' ').filter(Boolean);
+    const bin = parts.shift();
+    return runCli(bin, parts, { timeoutMs, signal: undefined, maxOutput: 256 * 1024 });
+}
+export const DEP_IDS = DEPS.map(d => d.id);
+//# sourceMappingURL=deps.js.map

package/lib/deps.js.map

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