@xdarkicex/openclaw-memory-libravdb 1.4.21 → 1.4.22
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +6 -6
- package/dist/sidecar.js +3 -0
- package/dist/types.d.ts +3 -0
- package/docs/embedding-profiles.md +2 -0
- package/openclaw.plugin.json +48 -1
- package/package.json +1 -1
package/dist/index.js
CHANGED
|
@@ -12,16 +12,16 @@ import { createPluginRuntime } from "./plugin-runtime.js";
|
|
|
12
12
|
export const MEMORY_ID = "libravdb-memory";
|
|
13
13
|
const LIGHTWEIGHT_MODES = new Set(["cli-metadata", "setup-only"]);
|
|
14
14
|
export function register(api) {
|
|
15
|
-
const
|
|
15
|
+
const registrationMode = api.registrationMode;
|
|
16
16
|
const logger = api.logger ?? console;
|
|
17
|
-
if (
|
|
17
|
+
if (registrationMode === "cli-metadata") {
|
|
18
18
|
registerMemoryCliMetadata(api);
|
|
19
19
|
return;
|
|
20
20
|
}
|
|
21
21
|
const cfg = api.pluginConfig;
|
|
22
|
-
const isLightweight = LIGHTWEIGHT_MODES.has(
|
|
23
|
-
const isDiscovery =
|
|
24
|
-
logger.info?.(`LibraVDB registering mode=${
|
|
22
|
+
const isLightweight = LIGHTWEIGHT_MODES.has(registrationMode);
|
|
23
|
+
const isDiscovery = registrationMode === "discovery";
|
|
24
|
+
logger.info?.(`LibraVDB registering mode=${registrationMode} lightweight=${isLightweight} ` +
|
|
25
25
|
`discovery=${isDiscovery} userId=${cfg.userId ?? "(auto)"} ` +
|
|
26
26
|
`crossSessionRecall=${cfg.crossSessionRecall !== false}`);
|
|
27
27
|
// Runtime creation:
|
|
@@ -41,7 +41,7 @@ export function register(api) {
|
|
|
41
41
|
logger.info?.(`LibraVDB: discovery mode — CLI registered, context engine deferred.`);
|
|
42
42
|
}
|
|
43
43
|
else {
|
|
44
|
-
logger.warn?.(`LibraVDB: registration mode is "${
|
|
44
|
+
logger.warn?.(`LibraVDB: registration mode is "${registrationMode}". ` +
|
|
45
45
|
`Context engine hooks (bootstrap, ingest, afterTurn) are NOT registered. ` +
|
|
46
46
|
`Memory will not be written automatically — only CLI commands are available.`);
|
|
47
47
|
}
|
package/dist/sidecar.js
CHANGED
|
@@ -373,6 +373,9 @@ export function buildSidecarEnv(cfg) {
|
|
|
373
373
|
if (cfg.embeddingRuntimePath) {
|
|
374
374
|
env.LIBRAVDB_ONNX_RUNTIME = cfg.embeddingRuntimePath;
|
|
375
375
|
}
|
|
376
|
+
if (cfg.onnxDevice) {
|
|
377
|
+
env.LIBRAVDB_ONNX_DEVICE = cfg.onnxDevice;
|
|
378
|
+
}
|
|
376
379
|
if (cfg.embeddingBackend) {
|
|
377
380
|
env.LIBRAVDB_EMBEDDING_BACKEND = cfg.embeddingBackend;
|
|
378
381
|
}
|
package/dist/types.d.ts
CHANGED
|
@@ -15,6 +15,9 @@ export interface PluginConfig {
|
|
|
15
15
|
useSessionRecallProjection?: boolean;
|
|
16
16
|
useSessionSummarySearchExperiment?: boolean;
|
|
17
17
|
embeddingRuntimePath?: string;
|
|
18
|
+
/** Optional ONNX execution provider override passed through to libravdbd.
|
|
19
|
+
* Use "cpu" to bypass CoreML/MPS on Intel Macs or fragile GPU/NPU providers. */
|
|
20
|
+
onnxDevice?: "auto" | "cpu" | "cuda" | "coreml" | "directml" | "openvino";
|
|
18
21
|
embeddingBackend?: "bundled" | "onnx-local" | "custom-local";
|
|
19
22
|
embeddingProfile?: string;
|
|
20
23
|
fallbackProfile?: string;
|
|
@@ -12,6 +12,7 @@ Why:
|
|
|
12
12
|
- MiniLM keeps the local LongMemEval retrieval slice inside the target memory envelope on macOS.
|
|
13
13
|
- Nomic remains available as an explicit opt-in profile for long-context experiments.
|
|
14
14
|
- Nomic ONNX on macOS is fragile with CoreML execution and can trigger multi-GB RSS, so it is no longer the safe bundled default.
|
|
15
|
+
- Intel Macs without reliable Metal/MPS support should set `onnxDevice: "cpu"` to force CPU ONNX execution and bypass CoreML.
|
|
15
16
|
|
|
16
17
|
Current shipped profile names:
|
|
17
18
|
|
|
@@ -33,6 +34,7 @@ How it works:
|
|
|
33
34
|
- `onnx-local` still requires local model assets through `embeddingModelPath`, typically a directory containing `embedding.json`.
|
|
34
35
|
- The manifest may override or refine the profile, but explicit dimension mismatches fail closed.
|
|
35
36
|
- The sidecar store persists an embedding fingerprint, so reopening an existing store with a different effective model profile will fail instead of silently mixing vector spaces.
|
|
37
|
+
- `onnxDevice` is passed through as `LIBRAVDB_ONNX_DEVICE` for daemon versions that support execution-provider selection (`auto`, `cpu`, `cuda`, `coreml`, `directml`, `openvino`).
|
|
36
38
|
|
|
37
39
|
Recommended usage:
|
|
38
40
|
|
package/openclaw.plugin.json
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"id": "libravdb-memory",
|
|
3
3
|
"name": "LibraVDB Memory",
|
|
4
4
|
"description": "Persistent vector memory with three-tier hybrid scoring",
|
|
5
|
-
"version": "1.4.
|
|
5
|
+
"version": "1.4.22",
|
|
6
6
|
"kind": [
|
|
7
7
|
"memory",
|
|
8
8
|
"context-engine"
|
|
@@ -22,12 +22,59 @@
|
|
|
22
22
|
"sidecarPath": {
|
|
23
23
|
"type": "string"
|
|
24
24
|
},
|
|
25
|
+
"userId": {
|
|
26
|
+
"type": "string",
|
|
27
|
+
"description": "Stable identity for cross-session durable memory. When set, sessions share memories under user:{userId}."
|
|
28
|
+
},
|
|
29
|
+
"identityPath": {
|
|
30
|
+
"type": "string",
|
|
31
|
+
"description": "Custom path for the auto-derived identity JSON file."
|
|
32
|
+
},
|
|
33
|
+
"crossSessionRecall": {
|
|
34
|
+
"type": "boolean",
|
|
35
|
+
"default": true,
|
|
36
|
+
"description": "When false, only session-scoped memories are retrieved; durable user recall is skipped."
|
|
37
|
+
},
|
|
38
|
+
"useSessionRecallProjection": {
|
|
39
|
+
"type": "boolean"
|
|
40
|
+
},
|
|
41
|
+
"grpcEndpoint": {
|
|
42
|
+
"type": "string",
|
|
43
|
+
"description": "Optional gRPC kernel endpoint for hosts using the daemon kernel transport."
|
|
44
|
+
},
|
|
45
|
+
"authoredHardBudgetFraction": {
|
|
46
|
+
"type": "number",
|
|
47
|
+
"minimum": 0,
|
|
48
|
+
"maximum": 1
|
|
49
|
+
},
|
|
50
|
+
"authoredSoftBudgetFraction": {
|
|
51
|
+
"type": "number",
|
|
52
|
+
"minimum": 0,
|
|
53
|
+
"maximum": 1
|
|
54
|
+
},
|
|
55
|
+
"elevatedGuidanceBudgetFraction": {
|
|
56
|
+
"type": "number",
|
|
57
|
+
"minimum": 0,
|
|
58
|
+
"maximum": 1
|
|
59
|
+
},
|
|
25
60
|
"useSessionSummarySearchExperiment": {
|
|
26
61
|
"type": "boolean"
|
|
27
62
|
},
|
|
28
63
|
"embeddingRuntimePath": {
|
|
29
64
|
"type": "string"
|
|
30
65
|
},
|
|
66
|
+
"onnxDevice": {
|
|
67
|
+
"type": "string",
|
|
68
|
+
"enum": [
|
|
69
|
+
"auto",
|
|
70
|
+
"cpu",
|
|
71
|
+
"cuda",
|
|
72
|
+
"coreml",
|
|
73
|
+
"directml",
|
|
74
|
+
"openvino"
|
|
75
|
+
],
|
|
76
|
+
"description": "Optional ONNX execution provider override passed to libravdbd. Use cpu to bypass CoreML/MPS on Intel Macs."
|
|
77
|
+
},
|
|
31
78
|
"embeddingBackend": {
|
|
32
79
|
"type": "string",
|
|
33
80
|
"enum": [
|