@gakr-gakr/memory-lancedb 0.1.0

package/lancedb-runtime.ts

@@ -0,0 +1,77 @@
+type LanceDbModule = typeof import("@lancedb/lancedb");
+
+export type LanceDbRuntimeLogger = {
+  info?: (message: string) => void;
+  warn?: (message: string) => void;
+};
+
+type LanceDbRuntimeLoaderDeps = {
+  platform: NodeJS.Platform;
+  arch: NodeJS.Architecture;
+  importBundled: () => Promise<LanceDbModule>;
+};
+
+function buildLoadFailureMessage(error: unknown): string {
+  return [
+    "memory-lancedb: bundled @lancedb/lancedb dependency is unavailable.",
+    "Install or repair the memory-lancedb plugin package dependencies, then restart AutoBot.",
+    String(error),
+  ].join(" ");
+}
+
+function isUnsupportedNativePlatform(params: {
+  platform: NodeJS.Platform;
+  arch: NodeJS.Architecture;
+}): boolean {
+  return params.platform === "darwin" && params.arch === "x64";
+}
+
+function buildUnsupportedNativePlatformMessage(params: {
+  platform: NodeJS.Platform;
+  arch: NodeJS.Architecture;
+}): string {
+  return [
+    `memory-lancedb: LanceDB runtime is unavailable on ${params.platform}-${params.arch}.`,
+    "The bundled @lancedb/lancedb dependency does not publish a native package for this platform.",
+    "Disable memory-lancedb or switch to a supported memory backend/platform.",
+  ].join(" ");
+}
+
+export function createLanceDbRuntimeLoader(overrides: Partial<LanceDbRuntimeLoaderDeps> = {}): {
+  load: (loggerInstance?: LanceDbRuntimeLogger) => Promise<LanceDbModule>;
+} {
+  const deps: LanceDbRuntimeLoaderDeps = {
+    platform: overrides.platform ?? process.platform,
+    arch: overrides.arch ?? process.arch,
+    importBundled: overrides.importBundled ?? (() => import("@lancedb/lancedb")),
+  };
+
+  let loadPromise: Promise<LanceDbModule> | null = null;
+
+  return {
+    async load(_logger?: LanceDbRuntimeLogger): Promise<LanceDbModule> {
+      if (!loadPromise) {
+        loadPromise = deps.importBundled().catch((error) => {
+          loadPromise = null;
+          if (isUnsupportedNativePlatform({ platform: deps.platform, arch: deps.arch })) {
+            throw new Error(
+              buildUnsupportedNativePlatformMessage({
+                platform: deps.platform,
+                arch: deps.arch,
+              }),
+              { cause: error },
+            );
+          }
+          throw new Error(buildLoadFailureMessage(error), { cause: error });
+        });
+      }
+      return await loadPromise;
+    },
+  };
+}
+
+const defaultLoader = createLanceDbRuntimeLoader();
+
+export async function loadLanceDbModule(logger?: LanceDbRuntimeLogger): Promise<LanceDbModule> {
+  return await defaultLoader.load(logger);
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@gakr-gakr/memory-lancedb",
+  "version": "0.1.0",
+  "description": "AutoBot LanceDB-backed long-term memory plugin with auto-recall/capture",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/autobot/autobot"
+  },
+  "type": "module",
+  "dependencies": {
+    "@lancedb/lancedb": "0.27.2",
+    "apache-arrow": "18.1.0",
+    "openai": "6.37.0",
+    "typebox": "1.1.38"
+  },
+  "devDependencies": {
+    "@gakr-gakr/plugin-sdk": "workspace:*"
+  },
+  "autobot": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "npmSpec": "@gakr-gakr/memory-lancedb",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.4.10"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.19"
+    },
+    "build": {
+      "autobotVersion": "2026.5.19"
+    },
+    "release": {
+      "publishToClawHub": true,
+      "publishToNpm": true
+    }
+  }
+}

package/test-helpers.ts

@@ -0,0 +1,25 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { resolvePreferredAutoBotTmpDir } from "autobot/plugin-sdk/temp-path";
+import { afterEach, beforeEach } from "vitest";
+
+export function installTmpDirHarness(params: { prefix: string }) {
+  let tmpDir = "";
+  let dbPath = "";
+
+  beforeEach(async () => {
+    tmpDir = await fs.mkdtemp(path.join(resolvePreferredAutoBotTmpDir(), params.prefix));
+    dbPath = path.join(tmpDir, "lancedb");
+  });
+
+  afterEach(async () => {
+    if (tmpDir) {
+      await fs.rm(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  return {
+    getTmpDir: () => tmpDir,
+    getDbPath: () => dbPath,
+  };
+}

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../tsconfig.package-boundary.base.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["./*.ts", "./src/**/*.ts"],
+  "exclude": [
+    "./**/*.test.ts",
+    "./dist/**",
+    "./node_modules/**",
+    "./src/test-support/**",
+    "./src/**/*test-helpers.ts",
+    "./src/**/*test-harness.ts",
+    "./src/**/*test-support.ts"
+  ]
+}