dsh-llm-workbuddy 0.1.15 → 0.1.16

package/CHANGELOG.md

@@ -4,6 +4,26 @@
 每次发版请同步 `package.json` 的 `version` 并打一个 `git tag`（如 `v0.1.13`），
 在 GitHub 创建 Release 时本文件即为更新说明来源。
 
+## [0.1.16] - 2026-09-10
+
+### Fixed
+- **适配 DeepSeek Harness `0.1.5-rc.1`（此前 0.1.15 在该版本上完全无法加载）**。
+  0.1.5-rc.1 移动了两个导出符号，而具名导入一个已不存在的符号会触发 ESM
+  **加载期 `SyntaxError`**，整个插件在 `import` 阶段即崩溃（provider、状态胶囊、
+  用量面板全部消失），不是运行期告警。现改为经命名空间对象取值并带兜底：
+  - `@deepseek-ai/dsh-llm`：`CallId` 在 0.1.5-rc.1 改名为 `ToolCallId`。
+  - `@deepseek-ai/dsh-settings`：`settingsNamespace` 已移除（改由注册内部
+    `parseSettingsNamespace` 校验，规则同为 `/^[a-z][a-z0-9-]*$/`），
+    `installSettingsSection` 改为 settings 服务的 `installSection` 方法。
+  - `settings` 分区改走 `ctx.inject(["settings"], (c) => c.settings.installSection(...))`，
+    与官方 `dsh-llm-deepseek` / `dsh-llm-pi-ai` 在 0.1.5-rc.1 上的写法一致。
+
+### Changed
+- `peerDependencies` 放宽为 `^0.1.1-rc.2 || ^0.1.5-rc.1`（`dsh-llm` /
+  `dsh-settings` / `dsh-timeout`），`@deepseek-ai/cordis` 放宽为 `^4.0.1 || ^4.0.2`，
+  以显式声明对 0.1.5-rc.1 的支持。修复为运行时取值，**同一个包在
+  0.1.1-rc.2 与 0.1.5-rc.1 上均可加载**。
+
 ## [0.1.15] - 2026-09-10
 
 ### Fixed
@@ -79,6 +99,7 @@
 ---
 
 <!-- 历史版本锚点（便于生成 Release 时对比区间） -->
+[0.1.16]: https://github.com/zdk119746/dsh-llm-workbuddy/compare/v0.1.15...v0.1.16
 [0.1.15]: https://github.com/zdk119746/dsh-llm-workbuddy/compare/v0.1.14...v0.1.15
 [0.1.14]: https://github.com/zdk119746/dsh-llm-workbuddy/compare/v0.1.13...v0.1.14
 [0.1.13]: https://github.com/zdk119746/dsh-llm-workbuddy/compare/v0.1.12...v0.1.13

package/lib/index.js

@@ -23,7 +23,6 @@ import { fileURLToPath } from "node:url";
 import z from "@deepseek-ai/schemastery";
 import {
   CONTEXT_WINDOW_EXCEEDED_CODE,
-  CallId,
   EMPTY_RESPONSE_CODE,
   LlmAdapter,
   LlmError,
@@ -33,9 +32,50 @@ import {
   isContextWindowExceededError,
   isQuotaExceededError,
 } from "@deepseek-ai/dsh-llm";
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+// Namespace imports for symbols that moved between harness releases. A named
+// import of a symbol that no longer exists is an ESM load-time SyntaxError that
+// takes the whole plugin down, so these resolve through the namespace object
+// with a fallback instead.
+import * as dshLlm from "@deepseek-ai/dsh-llm";
+import * as dshSettings from "@deepseek-ai/dsh-settings";
 import { MAX_TIMER_DELAY_MS, idleWatchdog, timeoutOf } from "@deepseek-ai/dsh-timeout";
 
+/**
+ * Brand a tool-call id. Harness 0.1.1-rc.2 exports `CallId`; 0.1.5-rc.1 renamed
+ * it to `ToolCallId`. Both brands are string-preserving, so the first one the
+ * loaded harness provides is correct on either release.
+ */
+const CallId = dshLlm.CallId ?? dshLlm.ToolCallId;
+
+/**
+ * Validate a settings namespace. Harness 0.1.5-rc.1 stopped exporting
+ * `settingsNamespace` and validates inside registration instead; this mirrors
+ * the same lowercase-hyphenated grammar so a bad namespace still fails loudly.
+ */
+const settingsNamespace = dshSettings.settingsNamespace ?? ((value) => {
+  if (typeof value !== "string" || !/^[a-z][a-z0-9-]*$/.test(value)) {
+    throw new TypeError(`settings namespace "${value}" must match /^[a-z][a-z0-9-]*$/`);
+  }
+  return value;
+});
+
+/**
+ * Wire this plugin's settings section to the optional settings service.
+ * Harness 0.1.1-rc.2 exports the free function `installSettingsSection`;
+ * 0.1.5-rc.1 replaced it with the `installSection` method on the settings
+ * service, reached through `ctx.inject(["settings"], …)`. Both register the
+ * plugin's composition config as the namespace base and fall back to it when
+ * the service is absent, so behaviour is identical either way.
+ */
+function installSettingsSection(ctx, ns, schema, entry, hooks) {
+  if (typeof dshSettings.installSettingsSection === "function") {
+    return dshSettings.installSettingsSection(ctx, ns, schema, entry, hooks);
+  }
+  ctx.inject(["settings"], (settingsCtx) => {
+    settingsCtx.settings.installSection(ctx, ns, schema, entry, hooks);
+  });
+}
+
 /** Plugin identity (Cordis convention). */
 export const name = "llm-workbuddy";
 // `llm` is a hard requirement (the adapter must always register). `webServer`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-llm-workbuddy",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "WorkBuddy (via the local workbuddy2api proxy) LLM provider adapter for DeepSeek Harness, with a Web login-status widget",
   "type": "module",
   "main": "lib/index.js",
@@ -48,10 +48,10 @@
     "CHANGELOG.md"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-timeout": "^0.1.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1 || ^4.0.2",
+    "@deepseek-ai/dsh-llm": "^0.1.1-rc.2 || ^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2 || ^0.1.5-rc.1",
+    "@deepseek-ai/dsh-timeout": "^0.1.1-rc.2 || ^0.1.5-rc.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   }
 }