@rayadesu/dsh-billing 0.2.1 → 0.2.2

package/AGENTS.md

@@ -11,6 +11,7 @@ deepseek-harness 官方仓库（[deepseek-ai/deepseek-harness](https://github.co
 ```
 packages/llm-billing/    宿主插件 @rayadesu/dsh-llm-billing（/user/balance 传输、峰谷计价、billing Remote）
 packages/ui-billing/     浏览器插件 @rayadesu/dsh-client-ui-billing（会话头部徽标与详情面板）
+packages/typert-protocol/ 内嵌 Typert 协议声明（@deepseek-ai/dsh-typert-protocol@0.1.1-rc.2 的 lib/types），构建期供 typert 生成器识别装饰器；刻意不在 pnpm workspace 内，让 @deepseek-ai/dsh-typert-protocol 从 npm 解析（内嵌副本只有声明，无运行时实现）
 cordis.patch.yml         DSH profile bundle 补丁层：挂载 llm-billing + ui-billing 两个插件行
 ```
 
@@ -31,23 +32,31 @@ cordis.patch.yml         DSH profile bundle 补丁层：挂载 llm-billing + ui-
 ## 约定
 
 - **源文件以本仓库为准**：`packages/*/src` 与 `tests/` 没有上游 fork，改动直接在本仓库进行。
-- **不在本仓库构建**：tsconfig 依赖 deepseek-harness monorepo 布局
-  （`tsconfig.base*.json`、vendor/ 引用），构建需在任意 deepseek-harness checkout 环境中
-  进行（把两个包放入 `packages/llm/llm-billing` 与 `packages/client/ui-billing` 位置后
-  构建），再把生成的 `lib/` 同步回本仓库对应包目录；`lib/` 已 gitignore，不进仓库。
-- **依赖以发布形态声明**：`@deepseek-ai/dsh-*` 依赖写 `^0.1.0-rc.8`（npm `next` tag 上的
-  发布形态，对应官方 monorepo 里的 `workspace:^`）；本插件的三个包发布到 npm 的
+- **本仓库独立构建**：本仓库是独立 pnpm workspace，tsconfig 只依赖仓库根的
+  `tsconfig.base*.json`，`@deepseek-ai/*` peer 包从 npm 解析。`pnpm run build`
+  依次跑 host/client 两个编译面：`tsc -b` 产出 `lib/types`，tsdown 产出
+  `lib/index.js`/`lib/invariant.js`，typert 生成器按 package.json 的 name 重新生成
+  `lib/typert.host.js` 与 `lib/typert.remote-client.*`，client 面重建 `lib/client.js`。
+  `lib/` 仍是 gitignore 的构建产物，不进仓库。
+- **发布前校验**：`pnpm run verify`（每个包 `prepublishOnly` 自动运行）检查
+  `lib/typert.host.js` 的 `TYPERT.package` 必须等于导出它的包名，且 lib 中不得残留
+  其他包名的清单；失败即禁止发布。
+- **依赖以发布形态声明**：`@deepseek-ai/dsh-*` 依赖写 `^0.1.1-rc.2`（对应官方 monorepo 当前发布基线，monorepo 内为 
+  `workspace:^`）；本插件的三个包发布到 npm 的
   `@rayadesu` scope，直接 `dsh plugin add @rayadesu/...` 安装。
 - **密钥不进仓库**：`DEEPSEEK_API_KEY` 等一律由用户环境或凭据 seam 提供，仓库不含真实值。
 - **README 双语**：每个 README 遵循 DSH 结构 `README.md`(EN) + `README.zh.md`(ZH) +
   `README.i18n.yaml`（记录两文件 git blob hash，改动后需更新）。
-- **版本对齐**：根 bundle 与两个包统一版本号（当前 0.2.1），`pnpm-lock.yaml` 随依赖变更更新。
+- **版本对齐**：根 bundle 与两个包统一版本号（当前 0.2.2），`pnpm-lock.yaml` 随依赖变更更新。
 - **文本规范**：LF 换行、文件末尾一个换行（`.editorconfig`/`.gitattributes` 已声明）。
 
 ## 常用命令
 
 ```sh
 pnpm install   # 安装本仓库依赖（dsh-* 从 registry 解析）
+pnpm run build # host + client 两个编译面（tsc + tsdown + typert 产物）
+pnpm run test  # vitest
+pnpm run verify # 发布前校验
 dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @rayadesu/dsh-client-ui-billing  # 安装进 DSH
 ```
 

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority; after
 # editing either side, bring the other along and re-record both hashes with:
 #   git hash-object README.md README.zh.md
-README.md: 6ba8f7b92f1815c54688bc77b63dbf8408565eae
-README.zh.md: 6efa6759a56cdaeeffa48319fff42e95d246029f
+README.md: f3072dc71e845a685a5ffbc7148d7fa35c9d7ead
+README.zh.md: 99be34e3d1a1b328956b37d43aff472f9f62470b

package/README.md

@@ -68,7 +68,7 @@ Manual rows (only when you do not want the bundle):
 
 The two plugin packages declare the DeepSeek Harness packages they build on
 (`@deepseek-ai/cordis`, `@deepseek-ai/dsh-credentials`, `@deepseek-ai/dsh-session`,
-and the client runtime packages) as `peerDependencies` at `^0.1.0-rc.8`. A dsh
+and the client runtime packages) as `peerDependencies` at `^0.1.1-rc.2`. A dsh
 profile does not auto-install peers, so these are provided by the dsh
 installation itself through the `profiles/node_modules` fallback rather than
 fetched from the registry — no extra packages to install, and no registry token
@@ -88,6 +88,41 @@ export DEEPSEEK_API_KEY=sk-...
 dsh web
 ```
 
+## Development
+
+This repository is a standalone pnpm workspace: the plugin packages resolve the
+`@deepseek-ai/*` peer packages from npm, so building does not need a full
+DeepSeek Harness checkout.
+
+Requirements: Node `^22.19 || >=24` and pnpm.
+
+```sh
+pnpm install                 # installs workspace and npm dev dependencies
+pnpm run build               # host face (tsc + tsdown + typert artifacts), then client face
+pnpm run typecheck           # both compile faces
+pnpm run test                # vitest unit/browser tests
+pnpm run verify              # pre-publish gate (also runs via prepublishOnly)
+```
+
+The host pass regenerates `lib/typert.host.js` and `lib/typert.remote-client.*`
+from the package source, keyed by each package.json name; the client pass
+rebuilds `lib/client.js`. `lib/` is git-ignored build output — do not hand-edit
+it. If a typert manifest ever names a package other than its own
+(`TYPERT.package` !== package.json name), the `verify` gate fails before publish.
+
+The typert generator recognizes `Remote`/`TypertRemoteService` only from a
+workspace-registered protocol package, so `packages/typert-protocol` vendors
+the published `@deepseek-ai/dsh-typert-protocol@0.1.1-rc.2` declarations; when
+the dsh dependency line moves, refresh it from the installed package.
+
+Publishing (the bundle and both plugins share one version):
+
+```sh
+pnpm --filter @rayadesu/dsh-llm-billing publish --access public
+pnpm --filter @rayadesu/dsh-client-ui-billing publish --access public
+pnpm publish --access public   # @rayadesu/dsh-billing bundle
+```
+
 ## Configuration
 
 Both packages ship sane defaults; everything below is optional.

package/README.zh.md

@@ -65,7 +65,7 @@ dsh plugin --profile web add @rayadesu/dsh-billing @rayadesu/dsh-llm-billing @ra
 
 两个插件包把它们依赖的 DeepSeek Harness 包（`@deepseek-ai/cordis`、
 `@deepseek-ai/dsh-credentials`、`@deepseek-ai/dsh-session` 以及客户端运行时包）
-声明为 `peerDependencies`（`^0.1.0-rc.8`）。dsh profile 默认不自动安装 peer，所以
+声明为 `peerDependencies`（`^0.1.1-rc.2`）。dsh profile 默认不自动安装 peer，所以
 这些由 dsh 安装本身通过 `profiles/node_modules` 回退提供，而不是从 registry 拉取——
 无需额外安装，安装机也不需要 registry token。
 
@@ -83,6 +83,38 @@ export DEEPSEEK_API_KEY=sk-...
 dsh web
 ```
 
+## 开发
+
+本仓库是独立的 pnpm workspace：两个插件包从 npm 解析 `@deepseek-ai/*` peer 包，
+构建不需要完整的 DeepSeek Harness checkout。
+
+环境要求：Node `^22.19 || >=24` 与 pnpm。
+
+```sh
+pnpm install                 # 安装 workspace 与 npm 开发依赖
+pnpm run build               # host 面（tsc + tsdown + typert 产物），再 client 面
+pnpm run typecheck           # 两个编译面
+pnpm run test                # vitest 单元/浏览器测试
+pnpm run verify              # 发布前校验（prepublishOnly 也会自动运行）
+```
+
+host 面会从源码重新生成 `lib/typert.host.js` 与 `lib/typert.remote-client.*`，
+包名取自各 package.json；client 面重建 `lib/client.js`。`lib/` 是 git-ignored
+的构建产物，不要手工修改。一旦 typert 清单里的 `TYPERT.package` 与 package.json
+的 name 不一致，`verify` 会在发布前直接失败。
+
+typert 生成器只认工作区内已注册协议包里的 `Remote`/`TypertRemoteService` 声明，所以
+`packages/typert-protocol` 内嵌了 npm 上 `@deepseek-ai/dsh-typert-protocol@0.1.1-rc.2` 的
+声明文件；dsh 依赖线升级时，从安装包重新刷新它。
+
+发布（bundle 与两个插件包统一版本号）：
+
+```sh
+pnpm --filter @rayadesu/dsh-llm-billing publish --access public
+pnpm --filter @rayadesu/dsh-client-ui-billing publish --access public
+pnpm publish --access public   # @rayadesu/dsh-billing bundle
+```
+
 ## 配置
 
 两个包都有合理默认值，下面都是可选的。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rayadesu/dsh-billing",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "DeepSeek Harness billing plugin: account balance and this session's billed spend with a session-header badge.",
   "license": "MIT",
   "packageManager": "pnpm@11.7.0",
@@ -13,7 +13,12 @@
     }
   },
   "scripts": {
-    "build": "pnpm -r build"
+    "build": "pnpm run build:host && pnpm run build:client",
+    "build:host": "tsc -b tsconfig.host.json && tsdown --env.DSH_BUILD_FACE host",
+    "build:client": "tsc -b tsconfig.client.json && tsdown --env.DSH_BUILD_FACE client",
+    "typecheck": "tsc -b tsconfig.host.json && tsc -b tsconfig.client.json",
+    "test": "vitest run",
+    "verify": "node scripts/verify-packages.mjs"
   },
   "files": [
     "cordis.patch.yml",
@@ -26,7 +31,18 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@rayadesu/dsh-llm-billing": "^0.2.1",
-    "@rayadesu/dsh-client-ui-billing": "^0.2.1"
+    "@rayadesu/dsh-llm-billing": "^0.2.2",
+    "@rayadesu/dsh-client-ui-billing": "^0.2.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
+    "@deepseek-ai/dsh-typert-generator": "^0.1.1-rc.2",
+    "@types/node": "^22.20.0",
+    "jsdom": "29.1.1",
+    "lightningcss": "^1.32.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
   }
 }