memory-lancedb-pro 1.0.1 → 1.0.4

package/.github/workflows/ci.yml

@@ -0,0 +1,24 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  cli-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install
+        run: npm ci
+
+      - name: Test
+        run: npm test

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## 1.0.4
+
+- Fix: `embedding.dimensions` is now parsed robustly (number / numeric string / env-var string), so it properly overrides hardcoded model dims (fixes Ollama `nomic-embed-text` dimension mismatch).
+
+## 1.0.3
+
+- Fix: `memory-pro reembed` no longer crashes (missing `clampInt` helper).
+
+## 1.0.2
+
+- Fix: pass through `embedding.dimensions` to the OpenAI-compatible `/embeddings` request payload when explicitly configured.
+- Chore: unify plugin version fields (`openclaw.plugin.json` now matches `package.json`).
+
+## 1.0.1
+
+- Fix: CLI command namespace updated to `memory-pro`.
+
+## 1.0.0
+
+- Initial npm release.

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# 🧠 memory-lancedb-pro
+# 🧠 memory-lancedb-pro · OpenClaw Plugin
 
 **Enhanced Long-Term Memory Plugin for [OpenClaw](https://github.com/openclaw/openclaw)**
 
@@ -326,7 +326,7 @@ This plugin works with **any OpenAI-compatible embedding API**:
 | **Jina** (recommended) | `jina-embeddings-v5-text-small` | `https://api.jina.ai/v1` | 1024 |
 | **OpenAI** | `text-embedding-3-small` | `https://api.openai.com/v1` | 1536 |
 | **Google Gemini** | `gemini-embedding-001` | `https://generativelanguage.googleapis.com/v1beta/openai/` | 3072 |
-| **Ollama** (local) | `nomic-embed-text` | `http://localhost:11434/v1` | 768 |
+| **Ollama** (local) | `nomic-embed-text` | `http://localhost:11434/v1` | _provider-specific_ (set `embedding.dimensions` to match your Ollama model output) |
 
 ### Rerank Providers
 

package/README_CN.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-# 🧠 memory-lancedb-pro
+# 🧠 memory-lancedb-pro · OpenClaw Plugin
 
 **[OpenClaw](https://github.com/openclaw/openclaw) 增强型 LanceDB 长期记忆插件**
 

package/cli.ts

@@ -3,6 +3,7 @@
  */
 
 import type { Command } from "commander";
+import { readFileSync } from "node:fs";
 import { loadLanceDB, type MemoryEntry, type MemoryStore } from "./src/store.js";
 import type { MemoryRetriever } from "./src/retriever.js";
 import type { MemoryScopeManager } from "./src/scopes.js";
@@ -24,6 +25,21 @@ interface CLIContext {
 // Utility Functions
 // ============================================================================
 
+function getPluginVersion(): string {
+  try {
+    const pkgUrl = new URL("./package.json", import.meta.url);
+    const pkg = JSON.parse(readFileSync(pkgUrl, "utf8")) as { version?: string };
+    return pkg.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+function clampInt(value: number, min: number, max: number): number {
+  const n = Number.isFinite(value) ? value : min;
+  return Math.max(min, Math.min(max, Math.trunc(n)));
+}
+
 function formatMemory(memory: any, index?: number): string {
   const prefix = index !== undefined ? `${index + 1}. ` : "";
   const date = new Date(memory.timestamp || memory.createdAt || Date.now()).toISOString().split('T')[0];
@@ -42,7 +58,15 @@ function formatJson(obj: any): string {
 export function registerMemoryCLI(program: Command, context: CLIContext): void {
   const memory = program
     .command("memory-pro")
-    .description("Enhanced memory management commands");
+    .description("Enhanced memory management commands (LanceDB Pro)");
+
+  // Version
+  memory
+    .command("version")
+    .description("Print plugin version")
+    .action(() => {
+      console.log(getPluginVersion());
+    });
 
   // List memories
   memory

package/index.ts

@@ -7,6 +7,7 @@ import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { homedir } from "node:os";
 import { join, dirname, basename } from "node:path";
 import { readFile, readdir, writeFile, mkdir } from "node:fs/promises";
+import { readFileSync } from "node:fs";
 
 // Import core components
 import { MemoryStore } from "./src/store.js";
@@ -83,6 +84,20 @@ function resolveEnvVars(value: string): string {
   });
 }
 
+function parsePositiveInt(value: unknown): number | undefined {
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return Math.floor(value);
+  }
+  if (typeof value === "string") {
+    const s = value.trim();
+    if (!s) return undefined;
+    const resolved = resolveEnvVars(s);
+    const n = Number(resolved);
+    if (Number.isFinite(n) && n > 0) return Math.floor(n);
+  }
+  return undefined;
+}
+
 // ============================================================================
 // Capture & Category Detection (from old plugin)
 // ============================================================================
@@ -252,6 +267,20 @@ async function findPreviousSessionFile(sessionsDir: string, currentSessionFile?:
   } catch {}
 }
 
+// ============================================================================
+// Version
+// ============================================================================
+
+function getPluginVersion(): string {
+  try {
+    const pkgUrl = new URL("./package.json", import.meta.url);
+    const pkg = JSON.parse(readFileSync(pkgUrl, "utf8")) as { version?: string };
+    return pkg.version || "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
 // ============================================================================
 // Plugin Definition
 // ============================================================================
@@ -291,8 +320,10 @@ const memoryLanceDBProPlugin = {
     const scopeManager = createScopeManager(config.scopes);
     const migrator = createMigrator(store);
 
+    const pluginVersion = getPluginVersion();
+
     api.logger.info(
-      `memory-lancedb-pro: plugin registered (db: ${resolvedDbPath}, model: ${config.embedding.model || "text-embedding-3-small"})`
+      `memory-lancedb-pro@${pluginVersion}: plugin registered (db: ${resolvedDbPath}, model: ${config.embedding.model || "text-embedding-3-small"})`
     );
 
     // ========================================================================
@@ -672,7 +703,9 @@ function parsePluginConfig(value: unknown): PluginConfig {
         apiKey,
         model: typeof embedding.model === "string" ? embedding.model : "text-embedding-3-small",
         baseURL: typeof embedding.baseURL === "string" ? resolveEnvVars(embedding.baseURL) : undefined,
-        dimensions: typeof embedding.dimensions === "number" ? embedding.dimensions : undefined,
+        // Accept number, numeric string, or env-var string (e.g. "${EMBED_DIM}").
+        // Also accept legacy top-level `dimensions` for convenience.
+        dimensions: parsePositiveInt(embedding.dimensions ?? cfg.dimensions),
         taskQuery: typeof embedding.taskQuery === "string" ? embedding.taskQuery : undefined,
         taskPassage: typeof embedding.taskPassage === "string" ? embedding.taskPassage : undefined,
         normalized: typeof embedding.normalized === "boolean" ? embedding.normalized : undefined,

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "memory-lancedb-pro",
   "name": "Memory (LanceDB Pro)",
   "description": "Enhanced LanceDB-backed long-term memory with hybrid retrieval, multi-scope isolation, and management CLI",
-  "version": "2026.2.16",
+  "version": "1.0.4",
   "kind": "memory",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-lancedb-pro",
-  "version": "1.0.1",
+  "version": "1.0.4",
   "description": "OpenClaw enhanced LanceDB memory plugin with hybrid retrieval (Vector + BM25), cross-encoder rerank, multi-scope isolation, and management CLI",
   "type": "module",
   "main": "index.ts",
@@ -32,7 +32,12 @@
       "./index.ts"
     ]
   },
+  "scripts": {
+    "test": "node test/cli-smoke.mjs"
+  },
   "devDependencies": {
+    "commander": "^14.0.0",
+    "jiti": "^2.6.0",
     "typescript": "^5.9.3"
   }
 }

package/scripts/smoke-openclaw.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Non-destructive smoke test for a real OpenClaw environment where the plugin is installed.
+# Intended for release preflight and on-host validation.
+
+openclaw memory-pro version
+openclaw memory-pro stats
+openclaw memory-pro list --limit 3
+openclaw memory-pro search "plugin" --limit 3
+
+# export/import (dry-run)
+TMP_JSON="/tmp/memory-pro-export.json"
+openclaw memory-pro export --scope global --category decision --output "$TMP_JSON"
+openclaw memory-pro import --dry-run "$TMP_JSON"
+
+# delete commands (dry-run/help only)
+openclaw memory-pro delete --help >/dev/null
+openclaw memory-pro delete-bulk --scope global --before 1900-01-01 --dry-run
+
+# migrate (read-only)
+openclaw memory-pro migrate check
+
+# reembed (dry-run). Adjust source-db path if needed.
+if [[ -d "$HOME/.openclaw/memory/lancedb-pro" ]]; then
+  openclaw memory-pro reembed --source-db "$HOME/.openclaw/memory/lancedb-pro" --limit 1 --dry-run
+else
+  echo "NOTE: $HOME/.openclaw/memory/lancedb-pro not found; skipping reembed smoke."
+fi
+
+echo "OK: openclaw smoke suite passed"

package/src/embedder.ts

@@ -156,6 +156,9 @@ export class Embedder {
   private readonly _taskPassage?: string;
   private readonly _normalized?: boolean;
 
+  /** Optional requested dimensions to pass through to the embedding provider (OpenAI-compatible). */
+  private readonly _requestDimensions?: number;
+
   constructor(config: EmbeddingConfig) {
     // Resolve environment variables in API key
     const resolvedApiKey = resolveEnvVars(config.apiKey);
@@ -164,6 +167,7 @@ export class Embedder {
     this._taskQuery = config.taskQuery;
     this._taskPassage = config.taskPassage;
     this._normalized = config.normalized;
+    this._requestDimensions = config.dimensions;
 
     this.client = new OpenAI({
       apiKey: resolvedApiKey,
@@ -237,6 +241,13 @@ export class Embedder {
     if (task) payload.task = task;
     if (this._normalized !== undefined) payload.normalized = this._normalized;
 
+    // Some OpenAI-compatible providers support requesting a specific vector size.
+    // We only pass it through when explicitly configured to avoid breaking providers
+    // that reject unknown fields.
+    if (this._requestDimensions && this._requestDimensions > 0) {
+      payload.dimensions = this._requestDimensions;
+    }
+
     return payload;
   }
 

package/test/cli-smoke.mjs

@@ -0,0 +1,92 @@
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+
+import { Command } from "commander";
+import jitiFactory from "jiti";
+
+const jiti = jitiFactory(import.meta.url, { interopDefault: true });
+
+async function createSourceDb(sourceDbPath) {
+  // Create a minimal LanceDB database with a `memories` table and 1 row.
+  const { loadLanceDB } = jiti("../src/store.ts");
+  const lancedb = await loadLanceDB();
+  const db = await lancedb.connect(sourceDbPath);
+
+  // Create table if missing.
+  // LanceDB JS API supports createTable(name, data).
+  const row = {
+    id: "test_smoke_1",
+    text: "hello from smoke test",
+    category: "other",
+    scope: "global",
+    importance: 0.7,
+    timestamp: Date.now(),
+    metadata: "{}",
+    vector: [0, 0, 0, 0],
+  };
+
+  try {
+    await db.createTable("memories", [row]);
+  } catch {
+    // If already exists, ignore.
+    const table = await db.openTable("memories");
+    await table.add([row]);
+  }
+}
+
+async function runCliSmoke() {
+  const workDir = mkdtempSync(path.join(tmpdir(), "memory-lancedb-pro-smoke-"));
+  const sourceDbPath = path.join(workDir, "source-db");
+
+  await createSourceDb(sourceDbPath);
+
+  const { createMemoryCLI } = jiti("../cli.ts");
+
+  const program = new Command();
+  program.exitOverride();
+
+  const context = {
+    // Minimal store interface for reembed dry-run.
+    store: { dbPath: path.join(workDir, "target-db") },
+    retriever: {},
+    scopeManager: {},
+    migrator: {},
+    // Presence required, but dry-run exits before embeddings.
+    embedder: {},
+  };
+
+  // Register commands under `memory-pro`
+  createMemoryCLI(context)({ program });
+
+  // 1) version command should not throw
+  await program.parseAsync(["node", "openclaw", "memory-pro", "version"]);
+
+  // 2) reembed dry-run should not crash (regression test for clampInt)
+  await program.parseAsync([
+    "node",
+    "openclaw",
+    "memory-pro",
+    "reembed",
+    "--source-db",
+    sourceDbPath,
+    "--limit",
+    "1",
+    "--batch-size",
+    "999",
+    "--dry-run",
+  ]);
+
+  rmSync(workDir, { recursive: true, force: true });
+}
+
+runCliSmoke()
+  .then(() => {
+    console.log("OK: CLI smoke test passed");
+  })
+  .catch((err) => {
+    console.error("FAIL: CLI smoke test failed");
+    console.error(err);
+    process.exit(1);
+  });