dsh-trivium 0.4.20 → 0.4.21

package/README.md

@@ -245,6 +245,8 @@ Off by default. After you turn **Chips (memory whitelist)** on in Settings, the
 
 ## Changelog
 
+**0.4.21** — Host adaptation for `@deepseek-ai/dsh@0.2.x`. Session format v4 replaced the shared `kind: "plugin"` message source with producer-owned kinds: a third-party producer must write `kind: "plugin:dsh-trivium"` and drop the `plugin` field, or the whole turn fails with "format v4 message requires a producer-owned source kind". The plugin now picks the shape from the installed `dsh-llm` version, so 0.1.x keeps working. `agent/created` (0.1.6+) is handled next to `agent/session-start`, with a one-shot guard in case a host emits both. Peer range widened to `<0.3.0`. New `smoke-p14` pins both source shapes and the version switch. Four tools / short map / find paths unchanged.
+
 **0.4.20** — Storage bump to `triviumdb@0.8.9`. The napi surface is unchanged (`triviumdb.d.ts` and `index.js` hash identically to 0.8.8), so this is a kernel-only update: SM-L2 is now the default QuIVer query path, FIND planning no longer materializes discarded candidates, and the server edition ships an attributed Web Console. All 14 offline smoke scripts pass unchanged. Four tools / short map / find paths unchanged.
 
 **0.4.19** — Fixed the plugin's own UI rendering Simplified Chinese on an English host ([issue #2](https://github.com/QWQcool/dsh-trivium/issues/2)). The `locale` service is now reached through `ctx.inject(["locale"], …)`, so **follow host** no longer depends on composition order, and the plugin fallback is `en` — the host's own `FALLBACK_LOCALE`, and the bucket every other resolved host language lands in. The Settings card and the Chips tab only ever choose between zh and en, so a browser naming no registered language no longer gets a Chinese card. Four tools / short map / find paths unchanged.
@@ -310,7 +312,7 @@ Local source checkout: `npm install`, then `node scripts/link-dsh.mjs`, then res
 ## Release info
 
 - GitHub: https://github.com/QWQcool/dsh-trivium
-- npm: [`dsh-trivium@0.4.20`](https://www.npmjs.com/package/dsh-trivium)
+- npm: [`dsh-trivium@0.4.21`](https://www.npmjs.com/package/dsh-trivium)
 - Tested host: `@deepseek-ai/dsh@0.1.5-rc.1` (also `0.1.1-rc.2` / `0.1.0-rc.8`)
 - License: MIT (depends on [TriviumDB](https://github.com/YoKONCy/TriviumDB), Apache-2.0)
 

package/README.zh-CN.md

@@ -241,6 +241,8 @@ Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按**节点
 
 ## 更新说明
 
+**0.4.21** — 适配 `@deepseek-ai/dsh@0.2.x`。会话格式 v4 把共享的 `kind: "plugin"` 消息来源改成生产者自有的 kind：第三方生产者必须写 `kind: "plugin:dsh-trivium"` 且去掉 `plugin` 字段，否则整轮会以 "format v4 message requires a producer-owned source kind" 失败。插件按已安装的 `dsh-llm` 版本自动选择形状，0.1.x 仍走旧格式。新增对 `agent/created`（0.1.6+）的监听，与 `agent/session-start` 并存并做一次性去重。peer 范围放宽到 `<0.3.0`。新增 `smoke-p14` 钉住两种 source 形状与版本判定。四工具 / 短地图 / find 路径不变。
+
 **0.4.20** — 存储升到 `triviumdb@0.8.9`。napi 接口零变更（`triviumdb.d.ts` 与 `index.js` 与 0.8.8 哈希完全一致），属纯内核升级：QuIVer 默认走 SM-L2 查询路径，FIND 规划不再物化被丢弃的候选，服务端版本带上带署名的 Web Console。14 个离线冒烟脚本原样通过。四工具 / 短地图 / find 路径不变。
 
 **0.4.19** — 修复插件自身界面在英文宿主上渲染成简体中文（[issue #2](https://github.com/QWQcool/dsh-trivium/issues/2)）。`locale` 服务改经 `ctx.inject(["locale"], …)` 获取，「跟随宿主」不再依赖插件组合顺序；兜底语言改为 `en`——与宿主自己的 `FALLBACK_LOCALE` 一致，也是其它已解析宿主语言的归宿。设置卡与芯片标签只在 zh / en 之间选择，浏览器未命名任何注册语言时不再给出中文卡。四工具 / 短地图 / find 路径不变。
@@ -306,7 +308,7 @@ Trivium 是记忆内核，不是日记、日历或聊天伴侣。它按**节点
 ## 发布信息
 
 - GitHub: https://github.com/QWQcool/dsh-trivium
-- npm: [`dsh-trivium@0.4.20`](https://www.npmjs.com/package/dsh-trivium)
+- npm: [`dsh-trivium@0.4.21`](https://www.npmjs.com/package/dsh-trivium)
 - 测试宿主：`@deepseek-ai/dsh@0.1.5-rc.1`（兼 `0.1.1-rc.2` / `0.1.0-rc.8`）
 - License: MIT（依赖 [TriviumDB](https://github.com/YoKONCy/TriviumDB) 为 Apache-2.0）
 

package/lib/host-format.js

@@ -0,0 +1,35 @@
+/**
+ * Host wire-format helpers, kept free of `@deepseek-ai/*` imports so the offline
+ * smoke suite can exercise them without a DSH install.
+ *
+ * Session format v4 (DSH 0.2.0+) replaced the shared `kind: "plugin"` message
+ * source with producer-owned kinds: a third-party producer is `plugin:<name>`
+ * and the `plugin` field is dropped. Writing the old shape into a v4 log fails
+ * the whole turn with "format v4 message requires a producer-owned source kind".
+ * 0.1.x only knows the old shape, so lib/index.js picks by host version.
+ */
+
+/**
+ * Decide whether the host writes session format v4.
+ * @param version - `@deepseek-ai/dsh-llm` version, e.g. "0.1.5-rc.1" / "0.2.1-rc.2".
+ * @returns true for >= 0.2.0, and for an unreadable version (assume the current
+ *   format rather than silently writing a shape the host rejects).
+ */
+export function detectHostFormatV4(version) {
+  const v = String(version || "").trim();
+  if (!v) return true;
+  const [major, minor] = v.split(".").map((n) => parseInt(n, 10) || 0);
+  return major > 0 || minor >= 2;
+}
+
+/**
+ * Build the `source` for one plugin-authored message.
+ * @param hostFormatV4 - result of {@link detectHostFormatV4}.
+ * @param extra - additional source fields (form, sections, ...).
+ * @returns the source object the installed host accepts.
+ */
+export function producerSourceFor(hostFormatV4, extra) {
+  return hostFormatV4
+    ? { kind: "plugin:dsh-trivium", ...extra }
+    : { kind: "plugin", plugin: "dsh-trivium", ...extra };
+}

package/lib/index.js

@@ -1,4 +1,6 @@
+import { createRequire } from "node:module";
 import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
+import { detectHostFormatV4, producerSourceFor } from "./host-format.js";
 import { cwdOf, registerTools } from "./tools.js";
 import {
   buildShortMapReport,
@@ -29,6 +31,27 @@ import { syncSidecarOnOpen } from "./sidecar.js";
 export const name = "dsh-trivium";
 export const inject = ["tools"];
 
+/*
+ * Session format v4 (DSH 0.2.0+) replaced the shared `kind: "plugin"` source
+ * with producer-owned kinds: a third-party producer is `plugin:<name>` and the
+ * `plugin` field is dropped. Writing the old shape into a v4 log fails the
+ * whole turn with "format v4 message requires a producer-owned source kind".
+ * 0.1.x only knows the old shape, so pick by host version.
+ */
+function readHostLlmVersion() {
+  try {
+    return String(createRequire(import.meta.url)("@deepseek-ai/dsh-llm/package.json").version || "");
+  } catch {
+    return "";
+  }
+}
+
+export const HOST_FORMAT_V4 = detectHostFormatV4(readHostLlmVersion());
+
+export function producerSource(extra) {
+  return producerSourceFor(HOST_FORMAT_V4, extra);
+}
+
 const DEFAULTS = {
   autoRecall: false,
   anchorRecall: false,
@@ -127,7 +150,7 @@ function makeLlmCall(ctx, session, agent) {
       messages: [
         createUserMessage({
           content: [{ type: "text", text: prompt }],
-          source: { kind: "plugin", plugin: "dsh-trivium" },
+          source: producerSource(),
         }),
       ],
     };
@@ -253,12 +276,10 @@ function injectShortMap(agent, db, budget) {
   agent.inject(
     createUserMessage({
       content: [{ type: "text", text: map.text }],
-      source: {
-        kind: "plugin",
-        plugin: "dsh-trivium",
+      source: producerSource({
         form: "snapshot",
         sections: [{ name: "dsh-trivium", text: map.text }],
-      },
+      }),
     }),
   );
   return map;
@@ -294,7 +315,19 @@ export function apply(ctx, config = {}) {
 
   registerTools(ctx, optionsOf);
 
-  ctx.on("agent/session-start", async ({ agent }) => {
+  /*
+   * DSH 0.1.6 replaced the serial `agent/session-start` event with
+   * `agent/created` (payload `{ agent, source, signal? }`). 0.1.5 and older
+   * only emit session-start, and a host never emits both, but the started set
+   * keeps the four one-shot steps below from running twice if that changes.
+   */
+  const started = new Set();
+  const onAgentStart = async ({ agent }) => {
+    const startId = sessionKey(agent?.session);
+    if (startId) {
+      if (started.has(startId)) return;
+      started.add(startId);
+    }
     try {
       const ready = await ensureShortMap(agent, optionsOf());
       const cwd = ready?.cwd || cwdOf(agent);
@@ -340,7 +373,10 @@ export function apply(ctx, config = {}) {
     } catch (err) {
       log.warn?.(`[dsh-trivium] session-start skipped: ${err.message}`);
     }
-  });
+  };
+
+  ctx.on("agent/created", onAgentStart);
+  ctx.on("agent/session-start", onAgentStart);
 
   ctx.on("session/event", (session, event) => {
     try {
@@ -457,10 +493,7 @@ export function apply(ctx, config = {}) {
                 // No `form`: "pins" was never in DSH's ContextForm union, so the
                 // client already rendered it as undeclared (opaque) context.
                 // Omitting the field is the documented default for that.
-                source: {
-                  kind: "plugin",
-                  plugin: "dsh-trivium",
-                },
+                source: producerSource(),
               }),
             );
           }
@@ -498,11 +531,7 @@ export function apply(ctx, config = {}) {
             extra.push(
               createUserMessage({
                 content: [{ type: "text", text }],
-                source: {
-                  kind: "plugin",
-                  plugin: "dsh-trivium",
-                  form: "recall",
-                },
+                source: producerSource({ form: "recall" }),
               }),
             );
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-trivium",
-  "version": "0.4.20",
+  "version": "0.4.21",
   "description": "In-process graph memory for DeepSeek Harness, backed by TriviumDB.",
   "license": "MIT",
   "type": "module",
@@ -47,6 +47,7 @@
     "smoke-p11": "node scripts/smoke-p11.mjs",
     "smoke-p12": "node scripts/smoke-p12.mjs",
     "smoke-p13": "node scripts/smoke-p13.mjs",
+    "smoke-p14": "node scripts/smoke-p14.mjs",
     "preuninstall": "node ./lib/purge.js",
     "verify-live-p2": "node scripts/verify-live-p2.mjs"
   },
@@ -54,8 +55,8 @@
     "node": "^22.19.0 || >=24"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.8 <0.1.1 || >=0.1.1-rc.2 <0.2.0",
-    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.1.1 || >=0.1.1-rc.2 <0.2.0"
+    "@deepseek-ai/dsh-llm": ">=0.1.0-rc.8 <0.1.1 || >=0.1.1-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.1.1 || >=0.1.1-rc.2 <0.3.0"
   },
   "dependencies": {
     "triviumdb": "^0.8.9"