Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions apps/memos-local-plugin/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,12 @@ for the full per-commit history use `git log` or the GitHub releases page.

## Index

- Local DSH compatibility branch: admit exactly `0.2.2-rc.1` after the
published host API matrix compiles, builds, and passes adapter tests.
Use the new host's Cordis peer and matching session codec for `0.2.2-rc.1`.
Earlier compatibility fixtures retain their pinned Cordis version. This
branch has not been published to npm.

- Unreleased — Admit DSH `0.1.7-rc.2`, `0.2.0-rc.2`, and `0.2.1-rc.2/rc.3`
through explicit, bounded optional peer ranges; retain the `2.0.21` V4
producer-owned message sources. Stop importing the moved `JsonValue` type
Expand Down
16 changes: 13 additions & 3 deletions apps/memos-local-plugin/adapters/deepseek-harness/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ modifying the DSH repository.
> DeepSeek Harness is currently a developer preview. The development API stack
> is pinned to `0.2.1-rc.3`. The compatibility matrix compiles, builds, and tests
> this adapter against the published `0.1.0-rc.6`, `0.1.7-rc.2`, `0.2.0-rc.2`,
> `0.2.1-rc.2`, and `0.2.1-rc.3` packages. These are API/contract checks, not a
> `0.2.1-rc.2`, `0.2.1-rc.3`, and `0.2.2-rc.1` packages. These are API/contract checks, not a
> substitute for validating each packaged Desktop/Web/CLI release.

## How it works
Expand Down Expand Up @@ -622,6 +622,7 @@ For the compatibility matrix, run:
npm run test:dsh-compat
# Or select a specific published API stack:
npm run test:dsh-compat -- 0.2.1-rc.3
npm run test:dsh-compat -- 0.2.2-rc.1
```

The script needs npm registry access. It installs each real host peer graph in
Expand All @@ -638,12 +639,15 @@ The six optional DSH service peers intentionally declare separate prerelease
lines:

```text
>=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2
>=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1
```

npm semver only admits a prerelease when a comparator explicitly names its
`major.minor.patch` tuple. Simply changing `<0.2.0` to `<0.3.0` would still
exclude `0.2.1-rc.3`. Unvalidated `0.2.2` and `0.3.x` remain excluded.
exclude `0.2.1-rc.3`. The tested `0.2.2-rc.1` is admitted exactly;
unvalidated `0.2.2` releases and `0.3.x` remain excluded. Its compatibility
fixture uses Cordis `~4.1.0` and the matching V3-to-V4 codec; earlier fixtures
retain their original host dependencies.
The former `0.1.0-rc.5` API baseline is no longer advertised: its core packages
are unavailable from npm, so it cannot be revalidated by this matrix.

Expand All @@ -663,6 +667,12 @@ can overwrite those patches. A successful `allow-version` exemption alone
does not verify runtime compatibility. Until this change is released,
installing npm `2.0.21` still leaves the startup version restriction in place.

When the host reaches Hugging Face through `HTTPS_PROXY`, launch Node with
`NODE_USE_ENV_PROXY=1` so its `fetch` uses that proxy. On a slow first model
download, set `embedding.local.loadTimeoutMs` in the MemOS `config.yaml` to a
larger value; this setting affects model loading, not the bounded foreground
recall timeout.

## Known limitations

1. **Developer-preview compatibility.** The supported prerelease lines and
Expand Down
12 changes: 6 additions & 6 deletions apps/memos-local-plugin/package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

12 changes: 6 additions & 6 deletions apps/memos-local-plugin/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -108,12 +108,12 @@
},
"peerDependencies": {
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-agent": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2",
"@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2",
"@deepseek-ai/dsh-session": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2",
"@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2",
"@deepseek-ai/dsh-timeout": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2",
"@deepseek-ai/dsh-tools": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2",
"@deepseek-ai/dsh-agent": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1",
"@deepseek-ai/dsh-llm": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1",
"@deepseek-ai/dsh-session": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1",
"@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1",
"@deepseek-ai/dsh-timeout": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1",
"@deepseek-ai/dsh-tools": ">=0.1.0-rc.6 <0.2.0 || >=0.1.7-rc.2 <0.1.8 || >=0.2.0-rc.2 <0.2.1 || >=0.2.1-rc.2 <0.2.2 || 0.2.2-rc.1",
"@deepseek-ai/schemastery": "^3.18.1"
},
"peerDependenciesMeta": {
Expand Down
8 changes: 6 additions & 2 deletions apps/memos-local-plugin/scripts/check-dsh-compatibility.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ const manifest = JSON.parse(await readFile(join(root, "package.json"), "utf8"));
const versions = process.argv.slice(2);
if (!versions.length) versions.push(
"0.1.0-rc.6", "0.1.7-rc.2",
"0.2.0-rc.2", "0.2.1-rc.2", "0.2.1-rc.3",
"0.2.0-rc.2", "0.2.1-rc.2", "0.2.1-rc.3", "0.2.2-rc.1",
);
if (versions.some((version) => !/^\d+\.\d+\.\d+(?:-rc\.\d+)?$/.test(version))) {
throw new Error("Expected explicit DSH versions, e.g. 0.2.1-rc.3");
Expand All @@ -32,7 +32,8 @@ for (const version of versions) {
Object.entries(manifest.devDependencies)
.filter(([name]) => name.startsWith("@deepseek-ai/"))
.map(([name, value]) => [name,
name.startsWith("@deepseek-ai/dsh-") && name !== "@deepseek-ai/dsh-session-format-v3-to-v4"
name.startsWith("@deepseek-ai/dsh-") &&
(name !== "@deepseek-ai/dsh-session-format-v3-to-v4" || version === "0.2.2-rc.1")
? version : value]),
);
// Early DSH previews used caret peers. Letting npm choose their latest
Expand All @@ -49,6 +50,9 @@ for (const version of versions) {
}));
const next = new Set();
for (const pkg of metadata) {
if (pkg.name === "@deepseek-ai/dsh-agent" && version === "0.2.2-rc.1") {
devDependencies["@deepseek-ai/cordis"] = pkg.peerDependencies["@deepseek-ai/cordis"];
}
for (const name of Object.keys({ ...pkg.dependencies, ...pkg.peerDependencies })) {
if (!name.startsWith("@deepseek-ai/dsh-") || name === "@deepseek-ai/dsh-session-format-v3-to-v4") continue;
devDependencies[name] = version;
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ const { satisfies } = createRequire(import.meta.url)("semver") as {
const hostServices = ["agent", "llm", "session", "system-prompt", "timeout", "tools"];

describe("DeepSeek Harness bundle package", () => {
it.each(["0.1.0-rc.6", "0.1.7-rc.2", "0.2.0-rc.2", "0.2.1-rc.2", "0.2.1-rc.3"])(
it.each(["0.1.0-rc.6", "0.1.7-rc.2", "0.2.0-rc.2", "0.2.1-rc.2", "0.2.1-rc.3", "0.2.2-rc.1"])(
"admits the supported host %s without a version exemption",
async (version) => {
const pkg = JSON.parse(await readFile(resolve(root, "package.json"), "utf8"));
Expand All @@ -24,7 +24,7 @@ describe("DeepSeek Harness bundle package", () => {
},
);

it.each(["0.1.0-rc.5", "0.2.2-rc.1", "0.2.2", "0.3.0-rc.1", "0.3.0"])(
it.each(["0.1.0-rc.5", "0.2.2", "0.3.0-rc.1", "0.3.0"])(
"does not admit the unvalidated host %s",
async (version) => {
const pkg = JSON.parse(await readFile(resolve(root, "package.json"), "utf8"));
Expand Down
Loading