Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

fix(dsh-memory-plugin): accept every DSH 0.x release and check new hosts daily (#5733)

t0saki0df1630a3edc
diff --git a/.github/host-compat.json b/.github/host-compat.json
new file mode 100644
index 000000000..264d3838b
--- /dev/null
+++ b/.github/host-compat.json
@@ -0,0 +1,52 @@
+{
+ "hosts": [
+ {
+ "id": "dsh",
+ "name": "DeepSeek Harness",
+ "plugin": "examples/dsh-memory-plugin",
+ "probe": "@deepseek-ai/dsh",
+ "tags": [
+ "latest",
+ "next",
+ "alpha"
+ ],
+ "packages": "^@deepseek-ai/dsh(-.+)?$",
+ "includePrerelease": true,
+ "tests": "*.test.mjs",
+ "skipTests": [
+ "bundle.test.mjs"
+ ],
+ "smoke": [
+ {
+ "run": [
+ "npm",
+ "install",
+ "--no-audit",
+ "--no-fund",
+ "@deepseek-ai/dsh@{version}"
+ ]
+ },
+ {
+ "run": [
+ "./node_modules/.bin/dsh",
+ "plugin",
+ "--profile",
+ "web",
+ "add",
+ "{tarball}"
+ ]
+ },
+ {
+ "run": [
+ "./node_modules/.bin/dsh",
+ "--profile",
+ "web",
+ "--dump-config"
+ ],
+ "expect": "^- id: openviking-memory-runtime$"
+ }
+ ],
+ "notes": "DSH checks @deepseek-ai/dsh-* peers at plugin load with prereleases included. bundle.test.mjs asserts the dev pins stay at the tested minimum, which this check replaces on purpose. The smoke steps install that dsh release, add the packed bundle to a profile, and require the composed profile to include the bundle; DSH refuses to add a bundle whose peers reject the release, so the add step fails first."
+ }
+ ]
+}
diff --git a/.github/scripts/host-compat.mjs b/.github/scripts/host-compat.mjs
new file mode 100644
index 000000000..c3d2f6544
--- /dev/null
+++ b/.github/scripts/host-compat.mjs
@@ -0,0 +1,200 @@
+#!/usr/bin/env node
+
+// Plugins declare the host versions they accept as a peer range, and a range
+// open enough to admit host releases nobody has tried yet is only safe if
+// somebody does try them. This runs each plugin's tests against the host
+// releases its npm dist-tags point at today, so a breaking host release shows
+// up here before a user reports it. Hosts are listed in .github/host-compat.json.
+//
+// Usage: node .github/scripts/host-compat.mjs [--host <id>] [--version <v>] [--report-issues]
+//
+// The plugin is copied to a scratch directory, every host package its manifest
+// pins is moved to the release under test, and its tests run there. The tests
+// exercise the plugin's code on the new host packages but never start the host,
+// so a host may also list smoke steps: commands that install the real host
+// release, add the packed plugin to it, and check the host picked it up. Run
+// `node examples/memory-plugin-shared/sync.mjs` first: the copy takes the
+// generated shared/ modules with it.
+
+import { execFileSync, spawnSync } from "node:child_process";
+import { appendFileSync, cpSync, globSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const CONFIG = join(ROOT, ".github", "host-compat.json");
+const LOG_TAIL_LINES = 60;
+const STEP_TIMEOUT_MS = 10 * 60 * 1000;
+
+function parseArgs(argv) {
+ const args = { host: undefined, version: undefined, reportIssues: false };
+ for (let i = 0; i < argv.length; i++) {
+ const arg = argv[i];
+ if (arg === "--host") args.host = argv[++i];
+ else if (arg === "--version") args.version = argv[++i];
+ else if (arg === "--report-issues") args.reportIssues = true;
+ else throw new Error(`unknown argument: ${arg}`);
+ }
+ return args;
+}
+
+function run(command, args, cwd, env = process.env) {
+ const result = spawnSync(command, args, {
+ cwd, env, encoding: "utf8", maxBuffer: 64 * 1024 * 1024, timeout: STEP_TIMEOUT_MS,
+ });
+ const timedOut = result.error?.code === "ETIMEDOUT" ? `\ntimed out after ${STEP_TIMEOUT_MS / 1000}s` : "";
+ return { ok: result.status === 0, output: `${result.stdout ?? ""}${result.stderr ?? ""}${timedOut}` };
+}
+
+function tail(text) {
+ return text.trimEnd().split("\n").slice(-LOG_TAIL_LINES).join("\n");
+}
+
+/** Distinct releases the host's dist-tags point at, each with the tags naming it. */
+function releasesUnderTest(host) {
+ const tags = JSON.parse(execFileSync("npm", ["view", host.probe, "dist-tags", "--json"], { encoding: "utf8" }));
+ const releases = new Map();
+ for (const tag of host.tags) {
+ const version = tags[tag];
+ if (!version) continue;
+ releases.set(version, [...(releases.get(version) ?? []), tag]);
+ }
+ return [...releases].map(([version, names]) => ({ version, tags: names }));
+}
+
+function retarget(manifest, pattern, version) {
+ for (const field of ["devDependencies", "overrides"]) {
+ for (const name of Object.keys(manifest[field] ?? {})) {
+ if (pattern.test(name)) manifest[field][name] = version;
+ }
+ }
+}
+
+/** Host peers whose declared range does not admit the release, judged the way the host judges. */
+function rejectedPeers(manifest, pattern, version, pluginDir, includePrerelease) {
+ const semver = createRequire(join(pluginDir, "package.json"))("semver");
+ return Object.entries(manifest.peerDependencies ?? {})
+ .filter(([name, range]) => pattern.test(name) && !semver.satisfies(version, range, { includePrerelease }))
+ .map(([name, range]) => `${name}@"${range}"`);
+}
+
+function checkRelease(host, release) {
+ const pattern = new RegExp(host.packages);
+ const source = join(ROOT, host.plugin);
+ const work = mkdtempSync(join(tmpdir(), `host-compat-${host.id}-`));
+ try {
+ cpSync(source, work, { recursive: true, filter: (path) => basename(path) !== "node_modules" });
+ const manifestPath = join(work, "package.json");
+ const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+ retarget(manifest, pattern, release.version);
+ writeFileSync(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+ rmSync(join(work, "package-lock.json"), { force: true });
+
+ const install = run("npm", ["install", "--no-audit", "--no-fund", "--ignore-scripts"], work);
+ if (!install.ok) return { stage: "install", log: tail(install.output) };
+
+ const rejected = rejectedPeers(manifest, pattern, release.version, work, host.includePrerelease);
+ if (rejected.length > 0) {
+ return { stage: "peer range", log: `${host.probe}@${release.version} is outside ${rejected.join(", ")}` };
+ }
+
+ const skip = new Set(host.skipTests ?? []);
+ const files = globSync(host.tests, { cwd: work }).filter((file) => !skip.has(file)).sort();
+ const tests = run(process.execPath, ["--test", ...files], work);
+ if (!tests.ok) return { stage: "tests", log: tail(tests.output) };
+ return host.smoke ? smoke(host, release, work) : undefined;
+ } finally {
+ rmSync(work, { recursive: true, force: true });
+ }
+}
+
+/**
+ * Install the real host release in an isolated home and run the host's smoke
+ * steps against the plugin packed the way npm would publish it. Steps substitute
+ * {version} and {tarball}; a step with `expect` must print a line matching it.
+ */
+function smoke(host, release, work) {
+ const dir = mkdtempSync(join(tmpdir(), `host-compat-${host.id}-smoke-`));
+ try {
+ const home = join(dir, "home");
+ const hostDir = join(dir, "host");
+ mkdirSync(home);
+ mkdirSync(hostDir);
+ const pack = run("npm", ["pack", "--ignore-scripts", "--json", "--pack-destination", dir], work);
+ if (!pack.ok) return { stage: "smoke: pack", log: tail(pack.output) };
+ const tarball = join(dir, JSON.parse(pack.output.slice(pack.output.indexOf("[")))[0].filename);
+
+ // The host's own state (profiles, stores, credentials) lands in the scratch home.
+ const env = { ...process.env, HOME: home, USERPROFILE: home, XDG_CONFIG_HOME: join(home, ".config") };
+ const fill = (arg) => arg.replaceAll("{version}", release.version).replaceAll("{tarball}", tarball);
+ for (const step of host.smoke) {
+ const [command, ...args] = step.run.map(fill);
+ const label = `smoke: ${step.run.join(" ")}`;
+ const result = run(command.startsWith(".") ? join(hostDir, command) : command, args, hostDir, env);
+ if (!result.ok) return { stage: label, log: tail(result.output) };
+ if (step.expect && !new RegExp(step.expect, "m").test(result.output)) {
+ return { stage: label, log: `output has no line matching /${step.expect}/\n${tail(result.output)}` };
+ }
+ }
+ return undefined;
+ } finally {
+ rmSync(dir, { recursive: true, force: true });
+ }
+}
+
+/** One issue per failing host release; a release that already has an open issue gets no repeat. */
+function reportIssue(host, release, failure) {
+ const title = `Host compatibility: ${host.plugin} fails on ${host.probe}@${release.version}`;
+ const open = JSON.parse(execFileSync("gh", [
+ "issue", "list", "--state", "open", "--search", `"${title}" in:title`, "--json", "title",
+ ], { encoding: "utf8" }));
+ if (open.some((issue) => issue.title === title)) return;
+ const runUrl = process.env.GITHUB_RUN_ID
+ ? `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}`
+ : "a local run";
+ const body = [
+ `The scheduled host compatibility check failed at the **${failure.stage}** stage for`,
+ `\`${host.plugin}\` on \`${host.probe}@${release.version}\` (dist-tags: ${release.tags.join(", ")}).`,
+ "",
+ `Run: ${runUrl}`,
+ "",
+ "```",
+ failure.log,
+ "```",
+ ].join("\n");
+ execFileSync("gh", ["issue", "create", "--title", title, "--body", body], { stdio: "inherit" });
+}
+
+function main() {
+ const args = parseArgs(process.argv.slice(2));
+ const { hosts } = JSON.parse(readFileSync(CONFIG, "utf8"));
+ const selected = hosts.filter((host) => !args.host || host.id === args.host);
+ if (selected.length === 0) throw new Error(`no host named ${args.host} in ${CONFIG}`);
+
+ const rows = [];
+ for (const host of selected) {
+ const releases = args.version ? [{ version: args.version, tags: ["--version"] }] : releasesUnderTest(host);
+ for (const release of releases) {
+ console.log(`::group::${host.id} ${release.version} (${release.tags.join(", ")})`);
+ const failure = checkRelease(host, release);
+ if (failure) console.log(failure.log);
+ console.log("::endgroup::");
+ rows.push({ host, release, failure });
+ if (failure && args.reportIssues) reportIssue(host, release, failure);
+ }
+ }
+
+ const summary = [
+ "| Host | Release | Tags | Result |",
+ "|---|---|---|---|",
+ ...rows.map(({ host, release, failure }) =>
+ `| ${host.name} | \`${release.version}\` | ${release.tags.join(", ")} | ${failure ? `failed: ${failure.stage}` : "passed"} |`),
+ ].join("\n");
+ console.log(summary);
+ if (process.env.GITHUB_STEP_SUMMARY) appendFileSync(process.env.GITHUB_STEP_SUMMARY, `${summary}\n`);
+ if (rows.some((row) => row.failure)) process.exitCode = 1;
+}
+
+main();
diff --git a/.github/workflows/host-compat.yml b/.github/workflows/host-compat.yml
new file mode 100644
index 000000000..0114cde7f
--- /dev/null
+++ b/.github/workflows/host-compat.yml
@@ -0,0 +1,54 @@
+name: Host Compatibility
+
+# Plugin peer ranges admit host releases published after the plugin, so this
+# tries the plugins against what each host's npm dist-tags point at today. It
+# runs on a schedule rather than on pull requests: a new host release is not a
+# change in this repository and must not turn unrelated pull requests red.
+# A failing release gets one issue; later runs leave it alone while it is open.
+# Hosts and the plugins under test are listed in .github/host-compat.json.
+
+on:
+ schedule:
+ - cron: '0 16 * * *' # Daily at 00:00 SGT (16:00 UTC)
+ workflow_dispatch:
+ inputs:
+ host:
+ description: Host id from .github/host-compat.json (empty for all)
+ required: false
+ version:
+ description: Exact host release to test instead of the dist-tags
+ required: false
+
+permissions:
+ contents: read
+ issues: write
+
+concurrency:
+ group: host-compat
+ cancel-in-progress: false
+
+jobs:
+ check:
+ runs-on: ubuntu-24.04
+ steps:
+ - uses: actions/checkout@v6
+
+ - uses: actions/setup-node@v6
+ with:
+ node-version: '24'
+
+ - name: Generate the shared runtime copies
+ run: node examples/memory-plugin-shared/sync.mjs
+
+ - name: Test plugins against current host releases
+ env:
+ GH_TOKEN: ${{ github.token }}
+ HOST: ${{ inputs.host }}
+ VERSION: ${{ inputs.version }}
+ run: |
+ args=()
+ [ -n "$HOST" ] && args+=(--host "$HOST")
+ [ -n "$VERSION" ] && args+=(--version "$VERSION")
+ # Only the schedule files issues; a manual run reports in its summary.
+ [ "${{ github.event_name }}" = schedule ] && args+=(--report-issues)
+ node .github/scripts/host-compat.mjs "${args[@]}"
diff --git a/docs/en/agent-integrations/17-dsh.md b/docs/en/agent-integrations/17-dsh.md
index e356a38b1..f09a090a8 100644
--- a/docs/en/agent-integrations/17-dsh.md
+++ b/docs/en/agent-integrations/17-dsh.md
@@ -104,7 +104,8 @@ Credentials given in the patch win over the environment. Behavior knobs resolve
|-------|---------------|
| Nothing injected, no OpenViking tools | `dsh --profile web --dump-config` should list `openviking-memory-runtime`; re-run the installer or `dsh plugin --profile web add …` |
| Installed into the wrong profile | The installer defaults to `web`; re-run it with `--dsh-profile <name>` |
-| `ERESOLVE` during install | Use a supported `@deepseek-ai/dsh` version: `0.1.0-rc.6`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.7-rc.2`, or a stable `0.1.x` (peer range `>=0.1.0-rc.6 <0.2.0 \|\| ^0.1.5-rc.1 \|\| ^0.1.7-rc.2`), and keep all `@deepseek-ai/dsh-*` host packages on the same version. |
+| DSH reports the bundle is incompatible with this dsh version | The bundle accepts every `@deepseek-ai/dsh` 0.x release from `0.1.0-rc.6` on (peer range `>=0.1.0-rc.6 <1.0.0-0`), so this means DSH 1.0 or later; update the bundle, or accept the risk with `dsh plugin allow-version`. Keep all `@deepseek-ai/dsh-*` host packages on the same version. |
+| Bundle fails to start on a new DSH release | Releases verified so far: `0.1.0-rc.6`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.7-rc.2`, `0.2.0-rc.2`, `0.2.1-alpha.1`. Newer 0.x releases are admitted without prior verification; pin DSH to a verified release and open an issue. |
| Install says the package is "not in the npm registry" | The profile may have a pnpm minimum release age of 24 hours; check its configuration (`minimumReleaseAge`). Wait it out, or add the exact version to `minimumReleaseAgeExclude` in the profile's `pnpm-workspace.yaml` |
| Recall is empty | `curl "<your OpenViking URL>/health"`; check the endpoint and that the prompt is longer than the minimum query length (3 characters) |
| 401 / 403 from OpenViking | Verify `OPENVIKING_API_KEY`; for trusted-mode deployments also verify `OPENVIKING_ACCOUNT` and `OPENVIKING_USER` |
diff --git a/docs/images/agents/en/deepseek-harness.md b/docs/images/agents/en/deepseek-harness.md
index eba224d0c..8ebf1e673 100644
--- a/docs/images/agents/en/deepseek-harness.md
+++ b/docs/images/agents/en/deepseek-harness.md
@@ -25,7 +25,8 @@ The installer asks for the harness and OpenViking credentials:
|---|---|
| No context injection or OpenViking tools | Run `dsh --profile web --dump-config` and confirm it contains `openviking-memory`; otherwise rerun the installer or run `dsh plugin --profile web add @openviking/dsh-memory-plugin` |
| Installed into the wrong profile | The installer uses `web`; rerun it with `bash -s -- --dsh-profile <name>` in place of `bash` |
-| `ERESOLVE @deepseek-ai/dsh-*` during install | Prerelease tags may be out of sync; install `@deepseek-ai/[email protected]` exactly |
+| DSH reports the plugin is incompatible with this dsh version | The plugin accepts every DSH 0.x release from `0.1.0-rc.6` on; on DSH 1.0 or later, update the plugin or run `dsh plugin allow-version` |
+| Plugin fails to start after a DSH upgrade | Newer 0.x releases are admitted without prior verification; pin DSH to a verified release such as `0.2.0-rc.2` and open an issue |
| Package reported missing from npm | pnpm rejects releases younger than 24 hours by default; wait and retry, or add the exact version to `minimumReleaseAgeExclude` in `pnpm-workspace.yaml` |
| Recall returns no history | Run `curl http://localhost:1933/health` to confirm the server is healthy, then check the endpoint and make sure the prompt is at least 3 characters long |
| OpenViking returns 401 / 403 | Check the API key; trusted-mode deployments must also check `OPENVIKING_ACCOUNT` and `OPENVIKING_USER` |
diff --git a/docs/images/agents/zh/deepseek-harness.md b/docs/images/agents/zh/deepseek-harness.md
index b6a1c9540..f628e3e2e 100644
--- a/docs/images/agents/zh/deepseek-harness.md
+++ b/docs/images/agents/zh/deepseek-harness.md
@@ -25,7 +25,8 @@ curl -fsSL https://openviking.ai/install | bash
|---|---|
| 没有上下文注入,也没有 OpenViking 工具 | 执行 `dsh --profile web --dump-config`,确认输出中包含 `openviking-memory`;若缺失,重新运行安装器或执行 `dsh plugin --profile web add @openviking/dsh-memory-plugin` |
| 插件安装到了错误的 profile | 安装器默认使用 `web`;把命令末尾的 `bash` 换成 `bash -s -- --dsh-profile <name>` 重新运行 |
-| 安装时报 `ERESOLVE @deepseek-ai/dsh-*` | 各包预发布 tag 可能不同步,请精确安装 `@deepseek-ai/[email protected]` |
+| DSH 提示插件与当前 dsh 版本不兼容 | 插件接受 `0.1.0-rc.6` 起的所有 DSH 0.x 版本;DSH 已是 1.0 或更高时,升级插件或运行 `dsh plugin allow-version` |
+| 升级 DSH 后插件启动失败 | 更新的 0.x 版本不经预先验证就会被接受;请把 DSH 固定到已验证的版本(如 `0.2.0-rc.2`),并提 issue |
| 安装时提示包不在 npm registry 中 | pnpm 默认拒绝发布不满 24 小时的版本;可稍后重试,或把精确版本加入 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` |
| 无法召回历史记忆 | 先执行 `curl http://localhost:1933/health` 确认服务端正常;再检查端点配置,并确认 prompt 不少于 3 个字符 |
| OpenViking 返回 401 / 403 | 检查 API Key;可信模式部署还需检查 `OPENVIKING_ACCOUNT` 与 `OPENVIKING_USER` |
diff --git a/docs/zh/agent-integrations/17-dsh.md b/docs/zh/agent-integrations/17-dsh.md
index 735829563..b9f104866 100644
--- a/docs/zh/agent-integrations/17-dsh.md
+++ b/docs/zh/agent-integrations/17-dsh.md
@@ -104,7 +104,8 @@ patch 中写的凭证优先于环境变量。行为配置按优先级从高到
|------|----------|
| 没有注入,也没有 OpenViking 工具 | `dsh --profile web --dump-config` 里应能看到 `openviking-memory-runtime`;重新运行安装器或 `dsh plugin --profile web add …` |
| 装到了错误的 profile | 安装器默认 `web`;用 `--dsh-profile <name>` 重新运行 |
-| 安装时报 `ERESOLVE` | 使用受支持的 `@deepseek-ai/dsh` 版本:`0.1.0-rc.6`、`0.1.5-rc.1`、`0.1.5-rc.2`、`0.1.7-rc.2` 或稳定版 `0.1.x`(peer 范围 `>=0.1.0-rc.6 <0.2.0 \|\| ^0.1.5-rc.1 \|\| ^0.1.7-rc.2`),并让所有 `@deepseek-ai/dsh-*` 宿主包保持同一版本。 |
+| DSH 提示插件与当前 dsh 版本不兼容 | 插件接受 `0.1.0-rc.6` 起的所有 `@deepseek-ai/dsh` 0.x 版本(peer 范围 `>=0.1.0-rc.6 <1.0.0-0`),出现这个提示说明 DSH 已是 1.0 或更高;升级插件,或者确认风险后用 `dsh plugin allow-version` 放行。所有 `@deepseek-ai/dsh-*` 宿主包要保持同一版本。 |
+| 升级 DSH 后插件启动失败 | 已验证的版本:`0.1.0-rc.6`、`0.1.5-rc.1`、`0.1.5-rc.2`、`0.1.7-rc.2`、`0.2.0-rc.2`、`0.2.1-alpha.1`。更新的 0.x 版本不经预先验证就会被接受;请把 DSH 固定到已验证的版本,并提 issue。 |
| 安装时报包「不在 npm registry 中」 | 检查该 profile 的 pnpm 是否设置了 24 小时的最小发布年龄(`minimumReleaseAge`)。等一等,或把该精确版本加进 profile 的 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` |
| 召不回任何内容 | `curl "<OpenViking 服务地址>/health"`;检查端点配置,以及 prompt 是否长于最小查询长度(3 个字符) |
| OpenViking 返回 401 / 403 | 检查 `OPENVIKING_API_KEY`;可信模式部署还要检查 `OPENVIKING_ACCOUNT` 与 `OPENVIKING_USER` |
diff --git a/examples/dsh-memory-plugin/README.md b/examples/dsh-memory-plugin/README.md
index 3478aab77..6f052979c 100644
--- a/examples/dsh-memory-plugin/README.md
+++ b/examples/dsh-memory-plugin/README.md
@@ -35,7 +35,7 @@ It also needs `node examples/memory-plugin-shared/sync.mjs` run first: the
## Requirements
-- `@deepseek-ai/dsh` `0.1.0-rc.6`, `0.1.5-rc.1`, `0.1.5-rc.2`, or `0.1.7-rc.2`; stable `0.1.x` releases are also admitted by the peer range
+- `@deepseek-ai/dsh` `0.1.0-rc.6` or later, below `1.0.0` (see [DSH version compatibility](#dsh-version-compatibility))
- Node.js `^22.19.0` or `>=24`
- A reachable OpenViking server
@@ -49,18 +49,34 @@ individual DSH core packages to the profile. DSH initializes profiles with
available through its module fallback at boot. A missing-peer warning during
`dsh plugin add` alone does not prove startup is broken.
-The peer range is `>=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2`. Each
-pre-release clause admits one series explicitly: semver does not include a
-release candidate in the first clause merely because it compares above
-`0.1.0-rc.6`, so every verified pre-release series is listed on its own. Other
-pre-release series need separate verification. Local devDependencies and
-`overrides` stay pinned to rc.6 to exercise the minimum supported contract.
-
Everything under `shared/` and `skills/` is generated by
`node examples/memory-plugin-shared/sync.mjs` — edit
`examples/memory-plugin-shared/lib/` and `examples/skills/`, never the vendored
copies.
+### DSH version compatibility
+
+The peer range is `>=0.1.0-rc.6 <1.0.0-0`. DSH checks each `@deepseek-ai/dsh-*`
+peer when it loads a plugin, with pre-releases included in the range, so this
+admits every 0.x release and pre-release from `0.1.0-rc.6` on, including ones
+published after this bundle. The bundle touches a small DSH surface —
+`createUserMessage` and `boundContextSummary` from `@deepseek-ai/dsh-llm` and
+the plugin entry points of `@deepseek-ai/dsh-mcp-client` and
+`@deepseek-ai/dsh-skill-filesystem` — so the range is not narrowed to the
+releases tested so far.
+
+Verified releases: `0.1.0-rc.6`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.7-rc.2`,
+`0.2.0-rc.2`, and `0.2.1-alpha.1`. A daily job
+(`.github/workflows/host-compat.yml`) runs the bundle's tests against the
+releases DSH's `latest`, `next`, and `alpha` dist-tags point at, installs each
+of those releases, adds the packed bundle to a profile and checks
+`--dump-config` lists it, and opens an issue when any of that fails, so a breaking release is usually caught before users
+reach it; if the bundle still fails to start on a new release, pin DSH to a
+verified one and open an issue. DSH 1.0 and later, pre-releases included, fall outside the
+range and DSH refuses to load the bundle; `dsh plugin allow-version` grants an exact-version
+exemption if you accept the risk. Local devDependencies and `overrides` stay
+pinned to rc.6 to exercise the minimum supported contract.
+
## Troubleshooting startup
If startup reports that `@deepseek-ai/dsh-llm` does not export `assertNever`,
diff --git a/examples/dsh-memory-plugin/bundle.test.mjs b/examples/dsh-memory-plugin/bundle.test.mjs
index 8e97f9406..7b536013f 100644
--- a/examples/dsh-memory-plugin/bundle.test.mjs
+++ b/examples/dsh-memory-plugin/bundle.test.mjs
@@ -19,12 +19,17 @@ test("bundle uses neutral DSH naming and bounded peers", async () => {
assert.equal(manifest.name, "@openviking/dsh-memory-plugin");
assert.equal(manifest.dependencies, undefined);
+ // DSH checks dsh peers at load time with prereleases included in ranges.
+ const dshRange = { includePrerelease: true };
for (const [name, range] of Object.entries(manifest.peerDependencies)) {
- for (const version of ["0.1.0-rc.6", "0.1.5-rc.1", "0.1.5-rc.2", "0.1.5"]) {
- assert.ok(semver.satisfies(version, range), `${name} must accept ${version}`);
+ for (const version of [
+ "0.1.0-rc.6", "0.1.5-rc.1", "0.1.5-rc.2", "0.1.5", "0.1.7-rc.2",
+ "0.2.0-rc.2", "0.2.1-alpha.1", "0.3.0",
+ ]) {
+ assert.ok(semver.satisfies(version, range, dshRange), `${name} must accept ${version}`);
}
- for (const version of ["0.0.1-rc.3", "0.1.0-rc.5", "0.1.5-alpha.2", "0.2.0-rc.1", "0.2.0"]) {
- assert.ok(!semver.satisfies(version, range), `${name} must reject ${version}`);
+ for (const version of ["0.0.1-rc.3", "0.1.0-rc.5", "1.0.0-rc.1", "1.0.0"]) {
+ assert.ok(!semver.satisfies(version, range, dshRange), `${name} must reject ${version}`);
}
assert.equal(manifest.devDependencies[name], "0.1.0-rc.6", `${name} must test the minimum`);
}
@@ -53,6 +58,7 @@ test("the runtime and package lock report the published package version", async
assert.equal(PLUGIN_VERSION, manifest.version);
assert.equal(lock.version, manifest.version);
assert.equal(lock.packages[""].version, manifest.version);
+ assert.deepEqual(lock.packages[""].peerDependencies, manifest.peerDependencies);
});
test("plugin source tree contains no product-specific identifier", async () => {
diff --git a/examples/dsh-memory-plugin/config.mjs b/examples/dsh-memory-plugin/config.mjs
index 0eaec0a9a..c0925a538 100644
--- a/examples/dsh-memory-plugin/config.mjs
+++ b/examples/dsh-memory-plugin/config.mjs
@@ -1,7 +1,7 @@
import { buildPluginConfig } from "./shared/plugin-config.mjs";
import { loadCredentialFiles } from "./shared/credentials.mjs";
-export const PLUGIN_VERSION = "0.5.16";
+export const PLUGIN_VERSION = "0.5.17";
/**
* Namespace for the bridged OpenViking MCP tools. DSH publishes every MCP tool
diff --git a/examples/dsh-memory-plugin/package-lock.json b/examples/dsh-memory-plugin/package-lock.json
index 50438fbad..10d891dc2 100644
--- a/examples/dsh-memory-plugin/package-lock.json
+++ b/examples/dsh-memory-plugin/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "@openviking/dsh-memory-plugin",
- "version": "0.5.16",
+ "version": "0.5.17",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "@openviking/dsh-memory-plugin",
- "version": "0.5.16",
+ "version": "0.5.17",
"license": "Apache-2.0",
"devDependencies": {
"@deepseek-ai/dsh-llm": "0.1.0-rc.6",
@@ -19,9 +19,9 @@
"node": "^22.19.0 || >=24"
},
"peerDependencies": {
- "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2",
- "@deepseek-ai/dsh-mcp-client": ">=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2",
- "@deepseek-ai/dsh-skill-filesystem": ">=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2"
+ "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <1.0.0-0",
+ "@deepseek-ai/dsh-mcp-client": ">=0.1.0-rc.6 <1.0.0-0",
+ "@deepseek-ai/dsh-skill-filesystem": ">=0.1.0-rc.6 <1.0.0-0"
}
},
"node_modules/@deepseek-ai/cordis": {
diff --git a/examples/dsh-memory-plugin/package.json b/examples/dsh-memory-plugin/package.json
index 97ed27331..ac2a89656 100644
--- a/examples/dsh-memory-plugin/package.json
+++ b/examples/dsh-memory-plugin/package.json
@@ -1,6 +1,6 @@
{
"name": "@openviking/dsh-memory-plugin",
- "version": "0.5.16",
+ "version": "0.5.17",
"description": "OpenViking memory and context bundle for DeepSeek Harness",
"icon": "./icon.svg",
"type": "module",
@@ -43,9 +43,9 @@
"prepublishOnly": "npm run prepack && npm run check && npm test"
},
"peerDependencies": {
- "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2",
- "@deepseek-ai/dsh-mcp-client": ">=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2",
- "@deepseek-ai/dsh-skill-filesystem": ">=0.1.0-rc.6 <0.2.0 || ^0.1.5-rc.1 || ^0.1.7-rc.2"
+ "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <1.0.0-0",
+ "@deepseek-ai/dsh-mcp-client": ">=0.1.0-rc.6 <1.0.0-0",
+ "@deepseek-ai/dsh-skill-filesystem": ">=0.1.0-rc.6 <1.0.0-0"
},
"devDependencies": {
"@deepseek-ai/dsh-llm": "0.1.0-rc.6",