@avantf/dsh-mem 0.8.1 → 0.10.0

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAQlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAE5E,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EASL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAcL,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAA;AAgB7B;;;;;;;GAOG;AACH,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,gBAAgB;QACxB,UAAU,EAAE;YAAE,IAAI,EAAE,UAAU,CAAA;SAAE,GAAG,aAAa,CAAA;KACjD;CACF;AAED,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAQnD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAO3B,CAAA;AA+BF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAmBvC;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBACtB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa;IAK3C;;;;;;;;;OASG;YACW,IAAI;IAclB;;;;OAIG;IAEH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IAMlF,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAMjE,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CAKjF;AAmGD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyZvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAQlD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAE5E,OAAO,EAAE,mBAAmB,EAAU,MAAM,kCAAkC,CAAA;AAE9E,OAAO,EAUL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAcL,KAAK,cAAc,EAIpB,MAAM,sBAAsB,CAAA;AAsB7B;;;;;;;GAOG;AACH,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,gBAAgB;QACxB,UAAU,EAAE;YAAE,IAAI,EAAE,UAAU,CAAA;SAAE,GAAG,aAAa,CAAA;KACjD;CACF;AAED,eAAO,MAAM,IAAI,eAAe,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAQnD,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAA;AAEpB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAO3B,CAAA;AA+BF,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAmBvC;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAe;gBACtB,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa;IAK3C;;;;;;;;;OASG;YACW,IAAI;IAclB;;;;OAIG;IAEH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;IAMlF,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC;IAMjE,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CAKjF;AA4ND,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0bvE"}

package/lib/types/remote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/remote.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,oBAAoB,EAGpB,wBAAwB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAGhF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AA8F/D,eAAO,MAAM,WAAW,EAAE,SAAS,oBAAoB,EAwFtD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnE;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBA0C9B,CAAA"}
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../src/remote.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,oBAAoB,EAGpB,wBAAwB,EACzB,MAAM,kCAAkC,CAAA;AACzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAGhF,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AA8F/D,eAAO,MAAM,WAAW,EAAE,SAAS,oBAAoB,EAsFtD,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,EAAE,wBAGhC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnE;AA8BD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBA0C9B,CAAA"}

package/lib/types/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAiB7D,yDAAyD;AACzD,eAAO,MAAM,MAAM;;;;;6BAED,OAAO,SAAS,SAAS,KAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;CAQpE,CAAA"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAwC7D,yDAAyD;AACzD,eAAO,MAAM,MAAM;;;;;6BAED,OAAO,SAAS,SAAS,KAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE;CAUpE,CAAA"}

package/lib/types/runtime_deps_resource.d.ts

@@ -0,0 +1,29 @@
+import { type RuntimeDepsResource } from '../engine/mem-contract/index.js';
+/** The loader's answer: the parsed resource, or why it could not be used. */
+export type RuntimeDepsResourceLoad = {
+    readonly ok: true;
+    readonly path: string;
+    readonly resource: RuntimeDepsResource;
+} | {
+    readonly ok: false;
+    readonly path: string;
+    readonly reason: string;
+};
+/**
+ * `res/runtime-deps.yaml` next to the package that owns this module.
+ *
+ * `import.meta.url` is the anchor (not `process.cwd()`, not a config path): the file ships beside the
+ * code, and an installed plugin must read the copy its own package manager put there.
+ */
+export declare function runtimeDepsResourceUrl(): URL;
+/**
+ * Read and validate the shipped declaration.
+ *
+ * Synchronous on purpose: it is a few kilobytes next to the entry module, read once at mount, and the
+ * caller's plan (the item specs and the audit entries) has to exist before anything is declared.
+ *
+ * `url` is injectable so a test can point at a scratch install directory; production always uses
+ * {@link runtimeDepsResourceUrl}.
+ */
+export declare function loadRuntimeDepsResource(url?: URL): RuntimeDepsResourceLoad;
+//# sourceMappingURL=runtime_deps_resource.d.ts.map

package/lib/types/runtime_deps_resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime_deps_resource.d.ts","sourceRoot":"","sources":["../../src/runtime_deps_resource.ts"],"names":[],"mappings":"AA6BA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAE1F,6EAA6E;AAC7E,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1E;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,GAAG,CAE5C;AAYD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,GAA8B,GAAG,uBAAuB,CAiCpG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avantf/dsh-mem",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "avantf-mem DSH native Cordis plugin: host service + memory tools + RPC + client 记忆 tab",
   "type": "module",
   "main": "lib/index.js",
@@ -34,12 +34,22 @@
     "!lib/client.js.map",
     "!lib/types/**/*.js",
     "!lib/types/**/*.js.map",
+    "res",
     "cordis.patch.yml",
     "README.md"
   ],
   "engines": {
     "node": ">=22.15.0 <23 || >=23.11.0"
   },
+  "scripts": {
+    "build": "node ../../../build/scripts/link-base.mjs && node ../../scripts/link-dsh.mjs && node ../../scripts/link-envinit.mjs && tsc -p tsconfig.json && node ../../scripts/copy-envinit-bootstrap.mjs && node ../../scripts/carry-engine-types.mjs && tsdown",
+    "bundle": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "node ../../../build/scripts/link-base.mjs && node ../../scripts/link-dsh.mjs && tsc -p tsconfig.test.json",
+    "test": "node ../../../build/scripts/link-base.mjs && node ../../scripts/link-envinit.mjs && vitest run",
+    "test:dsh": "node ../../../build/scripts/link-base.mjs && vitest run --config vitest.dsh.config.ts",
+    "prepublishOnly": "node ../../../build/scripts/prepublish-assert.mjs --package @avantf/dsh-mem && node ../../../build/scripts/pack-plugin.mjs"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.0",
     "@deepseek-ai/dsh-llm": "^0.1.5-rc.2 || ^0.1.7-rc.2 || ^0.2.0-rc.2",
@@ -71,26 +81,26 @@
   },
   "dependencies": {
     "@avantf/dsh-plugin-base": ">=0.3.0 <1.0.0",
-    "yaml": "^2.5.0"
+    "yaml": "catalog:"
   },
   "optionalDependencies": {
-    "@huggingface/transformers": "^4.2.0",
-    "hnswlib-node": "^2.1.1",
-    "nodejieba": "^2.6.0"
+    "@huggingface/transformers": "catalog:",
+    "hnswlib-node": "catalog:",
+    "nodejieba": "catalog:"
   },
   "devDependencies": {
     "@avantf/dsh-plugin-base": ">=0.3.0 <1.0.0",
-    "@avantf/mem": "0.8.1",
-    "@avantf/mem-contract": "0.8.1",
-    "@avantf/mem-provision": "0.8.1",
-    "@types/node": "^22.0.0",
+    "@avantf/mem": "workspace:*",
+    "@avantf/mem-contract": "workspace:*",
+    "@avantf/mem-provision": "workspace:*",
+    "@types/node": "catalog:",
     "@types/react": "^18.3.0",
-    "lightningcss": "^1.32.0",
-    "react": "18.3.1",
+    "lightningcss": "catalog:",
+    "react": "catalog:",
     "tsdown": "0.22.2",
-    "typescript": "^5.5.0",
-    "vitest": "^2.1.0",
-    "zod": "4.4.3"
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "zod": "catalog:"
   },
   "license": "MIT",
   "publishConfig": {
@@ -102,13 +112,5 @@
     "url": "git@gitee.com:ffeng86/dsh-mem.git",
     "directory": "packages/plugin"
   },
-  "author": "qunqi.ff",
-  "scripts": {
-    "build": "node ../../../build/scripts/link-base.mjs && node ../../scripts/link-dsh.mjs && node ../../scripts/link-envinit.mjs && tsc -p tsconfig.json && node ../../scripts/copy-envinit-bootstrap.mjs && node ../../scripts/carry-engine-types.mjs && tsdown",
-    "bundle": "tsdown",
-    "watch": "tsdown --watch",
-    "typecheck": "node ../../../build/scripts/link-base.mjs && node ../../scripts/link-dsh.mjs && tsc -p tsconfig.test.json",
-    "test": "node ../../../build/scripts/link-base.mjs && node ../../scripts/link-envinit.mjs && vitest run",
-    "test:dsh": "node ../../../build/scripts/link-base.mjs && vitest run --config vitest.dsh.config.ts"
-  }
-}
+  "author": "qunqi.ff"
+}

package/res/runtime-deps.yaml

@@ -0,0 +1,99 @@
+# Dependency declaration shipped WITH @avantf/dsh-mem.
+#
+# This file is DATA, not policy: it names the optional modules this build looks for, where an install
+# may come from, and what a session is told when one of them cannot be loaded. It travels inside the
+# published tarball (`files: ["res"]` in package.json) and is read from the INSTALL directory at
+# mount — never from a user's `configs/common.yaml`, so a profile cannot drift from the code that
+# depends on it. The only per-deployment knobs left in the user config are the two `enabled` switches
+# (`semantic.self_heal.enabled`, `semantic.native_self_heal.enabled`); everything below is the
+# plugin's own declaration.
+#
+# Shape: `RuntimeDepsResourceSchema` in @avantf/mem-contract. A malformed file is a packaging bug: the
+# plugin logs it and degrades (no self-heal item, no dependency audit) instead of refusing the mount.
+#
+# `sources[].cache: ''` on a source with NO registry means the family root's npm cache
+# (`<home>/cache/npm`); a source WITH a registry is a registry source.
+version: 1
+
+# `@huggingface/transformers` — the local ONNX embedding backend's optional module (plus its
+# transitive onnxruntime-node). Mirrors the providers this project has always used: the domestic
+# mirror first, then npmjs, each also once with ONNXRUNTIME_NODE_INSTALL=skip (onnxruntime-node's
+# postinstall download returns 302 on some mirrors and the WASM/CPU fallback is enough), then a
+# cache-only (offline) attempt.
+semantic:
+  packages:
+    "@huggingface/transformers": "^4.2.0"
+  sources:
+    - { id: npmmirror, registry: "https://registry.npmmirror.com", cache: "" }
+    - { id: npmjs, registry: "https://registry.npmjs.org", cache: "" }
+    - { id: local-store, registry: "", cache: "" }
+  attempts:
+    - { source: npmmirror, env: {}, allowScripts: true }
+    - { source: npmmirror, env: { ONNXRUNTIME_NODE_INSTALL: skip }, allowScripts: true }
+    - { source: npmjs, env: {}, allowScripts: true }
+    - { source: npmjs, env: { ONNXRUNTIME_NODE_INSTALL: skip }, allowScripts: true }
+    - { source: local-store, env: {}, allowScripts: true }
+  verify: ["@huggingface/transformers"]
+
+# The native optional dependencies. Both are node-gyp builds, so `allowScripts: true` is REQUIRED:
+# the install script is what produces the binding, and an --ignore-scripts install would resolve and
+# then fail on first use. They go into their own content-addressed root (a different package set is a
+# different key), never the transformers one.
+native:
+  packages:
+    nodejieba: "^2.6.0"
+    "hnswlib-node": "^2.1.1"
+  sources:
+    - { id: npmmirror, registry: "https://registry.npmmirror.com", cache: "" }
+    - { id: npmjs, registry: "https://registry.npmjs.org", cache: "" }
+    - { id: local-store, registry: "", cache: "" }
+  attempts:
+    - { source: npmmirror, env: {}, allowScripts: true }
+    - { source: npmjs, env: {}, allowScripts: true }
+    - { source: local-store, env: {}, allowScripts: true }
+  verify: ["nodejieba", "hnswlib-node"]
+
+# The startup dependency audit + the session notices it drives. `kind: module` LOADS the specifier
+# (a real require/import, so a native addon's binding is loaded rather than merely found) from a ready
+# self-heal root first and from this tree otherwise; `kind: runtime-deps` observes that item's state.
+# Delivery: `when` against the observed state (`failed` / `missing` / `degraded`; `pending` and
+# `unknown` match nothing), and `min_vectors` (optional) holds a line back until the corpus is big
+# enough for the missing piece to matter. These sentences are what a session is told — they belong to
+# this deployment's vocabulary (Chinese, per DESIGN §12), not to base or engine code.
+audit:
+  - id: mem:nodejieba
+    kind: module
+    specifier: nodejieba
+    severity: warning
+    when: missing
+    body: |
+      [avantf-mem] 分词依赖 nodejieba 不可用：实体/关系抽取已退化为正则，实体腿与 Jaccard 腿会变弱。
+  - id: mem:hnswlib
+    kind: module
+    specifier: hnswlib-node
+    severity: info
+    when: missing
+    min_vectors: 2000
+    body: |
+      [avantf-mem] 向量索引依赖 hnswlib-node 不可用：语义检索仍然可用，但语料达到阈值后改走暴力检索（更慢）。
+  - id: mem:transformers
+    kind: module
+    specifier: "@huggingface/transformers"
+    severity: degraded
+    when: missing
+    body: |
+      [avantf-mem] 语义检索依赖 @huggingface/transformers 不可用：检索仅剩 FTS+实体（语义腿关闭）。
+  - id: mem:semantic-deps
+    kind: runtime-deps
+    item: mem:semantic-deps
+    severity: degraded
+    when: failed
+    body: |
+      [avantf-mem] 语义依赖自愈未完成：检索已降级到 FTS+实体，修复后新会话不再出现本提示。
+  - id: mem:native-deps
+    kind: runtime-deps
+    item: mem:native-deps
+    severity: warning
+    when: failed
+    body: |
+      [avantf-mem] 原生依赖自愈未完成：分词与向量索引按各自的回退继续工作，修复后新会话不再出现本提示。