@morlay/x-use-bundle 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 morlay
+
+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/README.md

@@ -1,3 +1,34 @@
-# Temporary Holding Version
+# @morlay/x-use-bundle
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![NPM Version](https://img.shields.io/npm/v/%2540morlay%252Fx-use-bundle)](https://www.npmjs.com/package/@morlay/x-use-bundle)
+[![NPM Downloads](https://img.shields.io/npm/dw/%40morlay%2Fx-use-bundle)](https://www.npmjs.com/package/@morlay/x-use-bundle)
+
+通用 MCP 接法的一次装齐：两条 `dsh-mcp-client` 行分别以 stdio 起 `agent-browser mcp` 与
+`agent-desktop mcp`，工具以 `mcp__agent-browser__*` / `mcp__agent-desktop__*` 进入模型目录。
+
+| 装什么                 | 数据从哪来                |
+| ---------------------- | ------------------------- |
+| `mcp-agent-browser` 行 | 本包的 `tsdown.config.ts` |
+| `mcp-agent-desktop` 行 | 本包的 `tsdown.config.ts` |
+
+## 用法
+
+把包名加进 profile 的 `dsh.profile.bundles`，或在插件页启用。前提只有一条：对应的 bin 在宿主的 `PATH` 里
+（`agent-browser` / `agent-desktop`）。**没装就是没有这组工具**：两行都用 MCP 客户端默认的
+`failOnStartupError: false`，命令找不到时该行照常激活、只是不产出工具，宿主其余部分不受影响。
+
+两条都是**宿主级**挂载：一个 server 进程、所有会话共用同一个浏览器 / 桌面会话（page、tab、前台窗口会互相
+看见）。要每会话独立 Chromium 或把已有浏览器独占给一个会话，用 `browser-use` + 提供方那一套。
+
+要在打包形态里补 PATH（例如 mise 的 shim 不在 GUI 启动的环境里），用宿主侧的启动环境处理，而不是在本包钉
+绝对路径。要改 `agent-browser mcp` / `agent-desktop mcp` 的参数（`--tools`、`--session`、`--headed`），在
+profile 的覆盖层里改对应行的 `config.args`；MCP 客户端字段见上游
+[`dsh-mcp-client`](../../../vendor/deepseek-harness/packages/mcp/mcp-client/README.zh.md)。
+
+## 链接
+
+- [MCP 客户端](../../../vendor/deepseek-harness/packages/mcp/mcp-client/README.zh.md)：服务器配置、工具命名与限制。
+- [MCP 资源](../../../vendor/deepseek-harness/packages/mcp/mcp-resources/README.zh.md)：随附 profile 提供的资源发现与读取。
+- [浏览器操作子系统](../../../vendor/deepseek-harness/docs/subsystems/browser-use.zh.md)：需要会话级隔离时的提供方接法。
+
+**插件页不挂长文**：`locale/*.json` 的 `meta.detail` 指向空文件 [`docs/detail.md`](./docs/detail.md)；本 README 仍是包门面。

package/cordis.patch.yml

@@ -0,0 +1,18 @@
+# 本文件由 packages/bundles/x-use-bundle/tsdown.config.ts 生成，请勿手工编辑
+- insert:
+    - id: mcp-agent-browser
+      name: "@deepseek-ai/dsh-mcp-client"
+      config:
+        serverName: agent-browser
+        transport: stdio
+        command: agent-browser
+        args:
+          - mcp
+    - id: mcp-agent-desktop
+      name: "@deepseek-ai/dsh-mcp-client"
+      config:
+        serverName: agent-desktop
+        transport: stdio
+        command: agent-desktop
+        args:
+          - mcp

package/dist/index.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/index.mjs

@@ -0,0 +1 @@
+export {};

package/icon.svg

@@ -0,0 +1,24 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect x="5.6" y="7.4" width="24.8" height="21.2" rx="4.2" stroke="url(#window)" stroke-width="3" />
+  <path d="M5.6 14.4h24.8" stroke="url(#bar)" stroke-width="3" />
+  <path d="M10.2 11.2h.02M13.6 11.2h.02M17 11.2h.02" stroke="url(#dots)" stroke-width="3" stroke-linecap="round" />
+  <path d="m19.4 18.6 8.2 3.6-3.6 1.2-1.2 3.6-3.4-8.4Z" stroke="url(#cursor)" stroke-width="2.4" stroke-linecap="round" stroke-linejoin="round" />
+  <defs>
+    <linearGradient id="window" x1="5.6" y1="7.4" x2="30.4" y2="28.6" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#9FD0FF" />
+      <stop offset="1" stop-color="#2F6FD0" />
+    </linearGradient>
+    <linearGradient id="bar" x1="5.6" y1="14.4" x2="30.4" y2="14.4" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#CFE6FF" />
+      <stop offset="1" stop-color="#5B95E8" />
+    </linearGradient>
+    <linearGradient id="dots" x1="10.2" y1="11.2" x2="17" y2="11.2" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#E4F1FF" />
+      <stop offset="1" stop-color="#7FB0F0" />
+    </linearGradient>
+    <linearGradient id="cursor" x1="19.4" y1="18.6" x2="27.6" y2="27" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#BFE2FF" />
+      <stop offset="1" stop-color="#3B7BDC" />
+    </linearGradient>
+  </defs>
+</svg>

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "Browser & Desktop Use (MCP)",
+    "description": "Two generic dsh-mcp-client rows mounting agent-browser's and agent-desktop's stdio MCP servers; tools arrive as mcp__agent-browser__* and mcp__agent-desktop__*. Commands resolve from the global PATH, so a missing binary simply leaves its tools out.",
+    "detail": "docs/detail.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "浏览器与桌面操作（MCP）",
+    "description": "两行通用 dsh-mcp-client：分别挂 agent-browser 与 agent-desktop 的 stdio MCP server，工具以 mcp__agent-browser__* / mcp__agent-desktop__* 进入模型目录；命令走全局 PATH 里的 bin，没装则对应工具不出现。",
+    "detail": "docs/detail.md"
+  }
+}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@morlay/x-use-bundle",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.2",
+  "description": "通用 MCP 接法的一次装齐：agent-browser 与 agent-desktop 各一行 dsh-mcp-client，工具以 mcp__agent-browser__* / mcp__agent-desktop__* 进入模型目录；命令走全局 PATH 里的 bin，没装则该功能自然不可用。",
+  "keywords": [
+    "agent-browser",
+    "agent-desktop",
+    "bundle-entry",
+    "dsh",
+    "dsh-bundle",
+    "dsh-plugin",
+    "mcp"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/morlay/dsh-plugin.git"
+  },
+  "files": [
+    "locale/*.json",
+    "docs",
+    "dist",
+    "icon.svg",
+    "src",
+    "cordis.patch.yml",
+    "!**/__tests__"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-mcp-client": "^0.2.2-rc.1"
+  },
+  "devDependencies": {
+    "@local/devkit": "0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.1.0"
+  },
+  "icon": "./icon.svg",
+  "engines": {
+    "dsh": ">= 0.2.2-rc.1 < 0.2.3"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "build": "pnpm exec tsdown"
+  }
 }

package/src/index.ts

@@ -0,0 +1 @@
+export {};