memory-lancedb-pro 1.0.0 → 1.0.3

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,18 @@
+# Changelog
+
+## 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)**
 
@@ -378,31 +378,31 @@ Cross-encoder reranking supports multiple providers via `rerankProvider`:
 
 ```bash
 # List memories
-openclaw memory list [--scope global] [--category fact] [--limit 20] [--json]
+openclaw memory-pro list [--scope global] [--category fact] [--limit 20] [--json]
 
 # Search memories
-openclaw memory search "query" [--scope global] [--limit 10] [--json]
+openclaw memory-pro search "query" [--scope global] [--limit 10] [--json]
 
 # View statistics
-openclaw memory stats [--scope global] [--json]
+openclaw memory-pro stats [--scope global] [--json]
 
 # Delete a memory by ID (supports 8+ char prefix)
-openclaw memory delete <id>
+openclaw memory-pro delete <id>
 
 # Bulk delete with filters
-openclaw memory delete-bulk --scope global [--before 2025-01-01] [--dry-run]
+openclaw memory-pro delete-bulk --scope global [--before 2025-01-01] [--dry-run]
 
 # Export / Import
-openclaw memory export [--scope global] [--output memories.json]
-openclaw memory import memories.json [--scope global] [--dry-run]
+openclaw memory-pro export [--scope global] [--output memories.json]
+openclaw memory-pro import memories.json [--scope global] [--dry-run]
 
 # Re-embed all entries with a new model
-openclaw memory reembed --source-db /path/to/old-db [--batch-size 32] [--skip-existing]
+openclaw memory-pro reembed --source-db /path/to/old-db [--batch-size 32] [--skip-existing]
 
 # Migrate from built-in memory-lancedb
-openclaw memory migrate check [--source /path]
-openclaw memory migrate run [--source /path] [--dry-run] [--skip-existing]
-openclaw memory migrate verify [--source /path]
+openclaw memory-pro migrate check [--source /path]
+openclaw memory-pro migrate run [--source /path] [--dry-run] [--skip-existing]
+openclaw memory-pro migrate verify [--source /path]
 ```
 
 ---

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 长期记忆插件**
 
@@ -333,31 +333,31 @@ openclaw config get plugins.slots.memory
 
 ```bash
 # 列出记忆
-openclaw memory list [--scope global] [--category fact] [--limit 20] [--json]
+openclaw memory-pro list [--scope global] [--category fact] [--limit 20] [--json]
 
 # 搜索记忆
-openclaw memory search "query" [--scope global] [--limit 10] [--json]
+openclaw memory-pro search "query" [--scope global] [--limit 10] [--json]
 
 # 查看统计
-openclaw memory stats [--scope global] [--json]
+openclaw memory-pro stats [--scope global] [--json]
 
 # 按 ID 删除记忆（支持 8+ 字符前缀）
-openclaw memory delete <id>
+openclaw memory-pro delete <id>
 
 # 批量删除
-openclaw memory delete-bulk --scope global [--before 2025-01-01] [--dry-run]
+openclaw memory-pro delete-bulk --scope global [--before 2025-01-01] [--dry-run]
 
 # 导出 / 导入
-openclaw memory export [--scope global] [--output memories.json]
-openclaw memory import memories.json [--scope global] [--dry-run]
+openclaw memory-pro export [--scope global] [--output memories.json]
+openclaw memory-pro import memories.json [--scope global] [--dry-run]
 
 # 使用新模型重新生成 Embedding
-openclaw memory reembed --source-db /path/to/old-db [--batch-size 32] [--skip-existing]
+openclaw memory-pro reembed --source-db /path/to/old-db [--batch-size 32] [--skip-existing]
 
 # 从内置 memory-lancedb 迁移
-openclaw memory migrate check [--source /path]
-openclaw memory migrate run [--source /path] [--dry-run] [--skip-existing]
-openclaw memory migrate verify [--source /path]
+openclaw memory-pro migrate check [--source /path]
+openclaw memory-pro migrate run [--source /path] [--dry-run] [--skip-existing]
+openclaw memory-pro migrate verify [--source /path]
 ```
 
 ---

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];
@@ -41,8 +57,16 @@ function formatJson(obj: any): string {
 
 export function registerMemoryCLI(program: Command, context: CLIContext): void {
   const memory = program
-    .command("memory")
-    .description("Enhanced memory management commands");
+    .command("memory-pro")
+    .description("Enhanced memory management commands (LanceDB Pro)");
+
+  // Version
+  memory
+    .command("version")
+    .description("Print plugin version")
+    .action(() => {
+      console.log(getPluginVersion());
+    });
 
   // List memories
   memory
@@ -607,5 +631,5 @@ export function registerMemoryCLI(program: Command, context: CLIContext): void {
 // ============================================================================
 
 export function createMemoryCLI(context: CLIContext) {
-  return (program: Command) => registerMemoryCLI(program, context);
+  return ({ program }: { program: Command }) => registerMemoryCLI(program, context);
 }

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";
@@ -252,6 +253,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 +306,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"})`
     );
 
     // ========================================================================
@@ -325,7 +342,7 @@ const memoryLanceDBProPlugin = {
         migrator,
         embedder,
       }),
-      { commands: ["memory"] }
+      { commands: ["memory-pro"] }
     );
 
     // ========================================================================

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.3",
   "kind": "memory",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memory-lancedb-pro",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "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);
+  });