dsh-interconnect 0.11.22 → 0.11.24

package/README.md

@@ -3,6 +3,8 @@
 跨实例消息互通与事件通知插件，用于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH)。
 让一个 DSH 实例能向同一个实例、另一台机器、或另一台机器上的别的 DSH 实例发送消息、探测活性，并在实例之间双向推送事件。
 
+> **项目状态（2026-09-16）**：本仓库是该插件的**树外（out-of-tree）主源**。并入 DSH monorepo 的计划（PR #3243）已按「保持树外」的评审意见关闭；插件继续经 npm 分发（`dsh-interconnect`），并由团队内部的插件集合仓以 git submodule 引用本仓库。
+
 ## 包含三个插件
 
 **`interconnect`** —— host 服务（`ctx.interconnect`）：
@@ -237,9 +239,27 @@ dsh plugin --profile <name> add file:/path/to/dsh-interconnect
 
 registry 上的 tarball 自带 `lib/*.js` 与 `lib/types/**/*.d.ts`，安装时不跑构建。
 
-`dsh plugin add` 会把仓库识别为 bundle 并追加进 profile 的 `dsh.profile.bundles`。重启
-web 服务使 host 侧生效。两端实例的 `.credentials.yaml`（或等价凭据源）设置相同的
-`DSH_INTERCONNECT_TOKEN` 作为共享密钥。
+`dsh plugin add` 会把仓库识别为 bundle 并追加进 profile 的 `dsh.profile.bundles`。这次改动
+落在**组合层**：`@deepseek-ai/dsh-base` 插入的 `hmr` 行监听 profile 的 `package.json`，
+manifest 一变就重读 `dsh.profile.bundles` 并重算 patch 层，所以新增的行会在几秒内插进
+运行中的树并激活，**不需要重启**。已实测：安装前 `GET /interconnect/link` 返回 404，安装后
+6 秒内同一请求返回 403（插件 fail-closed 的应答）。
+
+插件**代码**的更新属于另一层，必须重启该实例：hmr 的模块监听根在 base 里是空的
+（`root: []`）且跳过 `node_modules`，已经导入的模块不会重载。升级已装插件、或在 `file:`
+安装下重建 `lib/`，都落在这一类。没有 `profileContext` 的启动方式（`hmr` 行被禁用）也只能靠
+重启。
+
+两端实例用相同的 `DSH_INTERCONNECT_TOKEN` 作为共享密钥，任选一种来源：继承的进程环境变量、
+`$DSH_HOME/.env`、或 `$DSH_HOME/.credentials.yaml` 的 `refs` 段（该 provider 由
+`@deepseek-ai/dsh-base` 挂载；优先级为 继承的环境 > credentials 文档 > 调用目录的 `.env` >
+`$DSH_HOME/.env`）：
+
+```yaml
+version: 1
+refs:
+  DSH_INTERCONNECT_TOKEN: <两端相同的共享密钥>
+```
 
 ## 开发
 

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-interconnect",
   "description": "Cross-instance message/event handoff for DeepSeek Harness (DSH): WebSocket link, model-facing tools, and companion skill.",
-  "version": "0.11.22",
+  "version": "0.11.24",
   "entry": {
     "name": "dsh-interconnect/interconnect",
     "inject": ["agents", "credentials"]

package/lib/index.js

@@ -831,7 +831,6 @@ function assertNever(value) {
   throw new Error(`interconnect: unhandled variant ${JSON.stringify(value)}`);
 }
 var INTERCONNECT_TOKEN_REF = "DSH_INTERCONNECT_TOKEN";
-var PLUGIN_SOURCE = "dsh-interconnect";
 var MAX_LINK_FRAME_BYTES = 1024 * 1024;
 var DEFAULT_INSTANCE_ID = "dsh";
 var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
@@ -1440,8 +1439,7 @@ var InterconnectService = class extends Service {
     })();
     const message = createUserMessage({
       source: {
-        kind: "plugin",
-        plugin: PLUGIN_SOURCE,
+        kind: "plugin:dsh-interconnect",
         form: "notice",
         summary: boundContextSummary(
           sender === void 0 ? `interconnect handoff delivered on instance ${this.instanceId}` : `interconnect handoff from ${sender.instanceId} (session ${sender.sessionId}) delivered on instance ${this.instanceId}`
@@ -1735,7 +1733,7 @@ function timingSafeEqual(a, b) {
   return constantTimeEqual(createHash("sha256").update(a, "utf8").digest(), createHash("sha256").update(b, "utf8").digest());
 }
 function linkUrl(origin) {
-  const url = new URL("/interconnect/link", origin);
+  const url = new URL(LINK_CHANNEL, origin);
   if (url.protocol === "http:") url.protocol = "ws:";
   else if (url.protocol === "https:") url.protocol = "wss:";
   if (url.protocol !== "ws:" && url.protocol !== "wss:") {

package/lib/interconnect/index.js

@@ -831,7 +831,6 @@ function assertNever(value) {
   throw new Error(`interconnect: unhandled variant ${JSON.stringify(value)}`);
 }
 var INTERCONNECT_TOKEN_REF = "DSH_INTERCONNECT_TOKEN";
-var PLUGIN_SOURCE = "dsh-interconnect";
 var MAX_LINK_FRAME_BYTES = 1024 * 1024;
 var DEFAULT_INSTANCE_ID = "dsh";
 var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
@@ -1440,8 +1439,7 @@ var InterconnectService = class extends Service {
     })();
     const message = createUserMessage({
       source: {
-        kind: "plugin",
-        plugin: PLUGIN_SOURCE,
+        kind: "plugin:dsh-interconnect",
         form: "notice",
         summary: boundContextSummary(
           sender === void 0 ? `interconnect handoff delivered on instance ${this.instanceId}` : `interconnect handoff from ${sender.instanceId} (session ${sender.sessionId}) delivered on instance ${this.instanceId}`
@@ -1735,7 +1733,7 @@ function timingSafeEqual(a, b) {
   return constantTimeEqual(createHash("sha256").update(a, "utf8").digest(), createHash("sha256").update(b, "utf8").digest());
 }
 function linkUrl(origin) {
-  const url = new URL("/interconnect/link", origin);
+  const url = new URL(LINK_CHANNEL, origin);
   if (url.protocol === "http:") url.protocol = "ws:";
   else if (url.protocol === "https:") url.protocol = "wss:";
   if (url.protocol !== "ws:" && url.protocol !== "wss:") {