@elizaos/plugin-localdb 2.0.0-beta.1 → 2.0.3-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shaw Walters and elizaOS Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @elizaos/plugin-localdb
+
+Persistent local database adapter for elizaOS. Stores agent state to a JSON file on Node.js or to `localStorage` in the browser. No external database required.
+
+## What it does
+
+elizaOS agents need a `DatabaseAdapter` to store memories, entities, rooms, relationships, tasks, and other runtime state. This plugin provides that adapter with local persistence:
+
+- **Node.js:** all collections are written to a single `localdb.json` file. Data survives process restarts.
+- **Browser:** all collections are written to `localStorage` under the key `elizaos:localdb:<agentId>`.
+
+Vector search uses an in-memory HNSW index (cosine similarity). The index is rebuilt from embeddings written during the current session; it does not persist across restarts.
+
+## Capabilities added to an Eliza agent
+
+- Full `IDatabaseAdapter` implementation: entities, memories (with vector search), rooms, worlds, components, relationships, participants, tasks, logs, cache, pairing requests.
+- JSON-patch operations on component data (`set`, `remove`, `push`, `increment`).
+- Levenshtein-based embedding cache lookup for deduplication.
+
+## Installation
+
+```bash
+npm install @elizaos/plugin-localdb
+```
+
+Add the plugin to your agent character:
+
+```ts
+import localdbPlugin from "@elizaos/plugin-localdb";
+
+const character = {
+  plugins: [localdbPlugin],
+  // ...
+};
+```
+
+The plugin registers itself only if no other database adapter has already been loaded. Load order matters — place it after any preferred adapter so it acts as a fallback, or first if it is the intended adapter.
+
+## Configuration
+
+| Environment variable | Default | Description |
+|----------------------|---------|-------------|
+| `LOCALDB_DATA_DIR` | `.eliza-localdb/` (process cwd) | Directory where `localdb.json` is written. Also readable as an agent setting under the same key. |
+
+The browser entry ignores all env vars and uses `localStorage` automatically.
+
+## Limitations
+
+- **Not for high write throughput.** The file backend flushes the entire JSON document after every write.
+- **Vector index is not persisted.** Semantic memory search is unavailable for data written in previous sessions until new embeddings are stored.
+- **No transaction atomicity.** Concurrent writes in a single process are not isolated.
+- **Designed for development and lightweight deployments.** For production agents with large memory stores, prefer a SQL-backed adapter.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-localdb",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.3-beta.3",
   "type": "module",
   "description": "File-backed (Node) and localStorage (browser) persistence via plugin-inmemorydb; ships compiled ESM in dist/.",
   "main": "./dist/index.js",
@@ -23,33 +23,41 @@
       },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
   "sideEffects": false,
   "files": [
+    "registry-entry.json",
     "dist"
   ],
   "scripts": {
     "build": "tsup --config tsup.config.ts",
     "dev": "tsup --config tsup.config.ts --watch",
     "clean": "rm -rf dist .turbo",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "lint": "echo \"Lint skipped\"",
-    "lint:check": "bun run lint",
-    "test": "echo \"No tests\""
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
+    "lint": "bunx @biomejs/biome check --write --unsafe .",
+    "lint:check": "bunx @biomejs/biome check .",
+    "test": "vitest run"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
-    "@elizaos/plugin-inmemorydb": "2.0.0-beta.1"
+    "@elizaos/core": "2.0.3-beta.3",
+    "@elizaos/plugin-inmemorydb": "2.0.3-beta.3"
   },
   "devDependencies": {
     "@types/node": "25.6.2",
     "tsup": "8.5.1",
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
-    "@elizaos/core": "2.0.0-beta.1",
-    "@elizaos/plugin-inmemorydb": "2.0.0-beta.1"
+    "@elizaos/core": "2.0.3-beta.3",
+    "@elizaos/plugin-inmemorydb": "2.0.3-beta.3"
   },
   "publishConfig": {
     "access": "public"
@@ -58,5 +66,6 @@
     "type": "git",
     "url": "git+https://github.com/elizaos/eliza.git",
     "directory": "plugins/plugin-localdb"
-  }
+  },
+  "gitHead": "f54b0f4eaed317d59fa7dbcdce20f4cdb0734420"
 }

package/registry-entry.json

@@ -0,0 +1,25 @@
+{
+  "id": "localdb",
+  "name": "Localdb",
+  "description": "Simple JSON-based local database storage for elizaOS - no SQL, no migrations",
+  "npmName": "@elizaos/plugin-localdb",
+  "version": "2.0.0-beta.0",
+  "source": "bundled",
+  "tags": ["database", "storage", "localdb"],
+  "config": {},
+  "render": {
+    "visible": false,
+    "pinTo": [],
+    "style": "card",
+    "group": "feature-other",
+    "groupOrder": 12,
+    "actions": ["enable", "configure"]
+  },
+  "resources": {
+    "homepage": "https://github.com/elizaos-plugins/plugin-localdb#readme",
+    "repository": "https://github.com/elizaos-plugins/plugin-localdb"
+  },
+  "dependsOn": [],
+  "kind": "plugin",
+  "subtype": "database"
+}

package/dist/index.browser.d.ts

@@ -1,7 +0,0 @@
-import { UUID, Plugin } from '@elizaos/core';
-import { InMemoryDatabaseAdapter } from '@elizaos/plugin-inmemorydb';
-
-declare function createDatabaseAdapter(agentId: UUID): InMemoryDatabaseAdapter;
-declare const plugin: Plugin;
-
-export { createDatabaseAdapter, plugin as default, plugin };

package/dist/index.browser.js

@@ -1,113 +0,0 @@
-// index.browser.ts
-import {
-  InMemoryDatabaseAdapter
-} from "@elizaos/plugin-inmemorydb";
-var BrowserLocalStorage = class {
-  constructor(key) {
-    this.key = key;
-  }
-  key;
-  collections = /* @__PURE__ */ new Map();
-  ready = false;
-  async init() {
-    const raw = globalThis.localStorage?.getItem(this.key);
-    if (raw) {
-      const parsed = JSON.parse(raw);
-      for (const [collection, entries] of Object.entries(parsed)) {
-        this.collections.set(collection, new Map(Object.entries(entries)));
-      }
-    }
-    this.ready = true;
-  }
-  async close() {
-    await this.flush();
-    this.ready = false;
-  }
-  async isReady() {
-    return this.ready;
-  }
-  getCollection(collection) {
-    let current = this.collections.get(collection);
-    if (!current) {
-      current = /* @__PURE__ */ new Map();
-      this.collections.set(collection, current);
-    }
-    return current;
-  }
-  async flush() {
-    const out = {};
-    for (const [collection, entries] of this.collections) {
-      out[collection] = Object.fromEntries(entries);
-    }
-    globalThis.localStorage?.setItem(this.key, JSON.stringify(out));
-  }
-  async get(collection, id) {
-    const item = this.getCollection(collection).get(id);
-    return item === void 0 ? null : item;
-  }
-  async getAll(collection) {
-    return Array.from(this.getCollection(collection).values());
-  }
-  async getWhere(collection, predicate) {
-    return (await this.getAll(collection)).filter(predicate);
-  }
-  async set(collection, id, data) {
-    this.getCollection(collection).set(id, data);
-    await this.flush();
-  }
-  async delete(collection, id) {
-    const deleted = this.getCollection(collection).delete(id);
-    if (deleted) await this.flush();
-    return deleted;
-  }
-  async deleteMany(collection, ids) {
-    const current = this.getCollection(collection);
-    for (const id of ids) current.delete(id);
-    await this.flush();
-  }
-  async deleteWhere(collection, predicate) {
-    const current = this.getCollection(collection);
-    for (const [id, item] of current) {
-      if (predicate(item)) current.delete(id);
-    }
-    await this.flush();
-  }
-  async count(collection, predicate) {
-    const current = this.getCollection(collection);
-    if (!predicate) return current.size;
-    let total = 0;
-    for (const item of current.values()) {
-      if (predicate(item)) total++;
-    }
-    return total;
-  }
-  async clear() {
-    this.collections.clear();
-    await this.flush();
-  }
-};
-function createDatabaseAdapter(agentId) {
-  return new InMemoryDatabaseAdapter(
-    new BrowserLocalStorage(`elizaos:localdb:${agentId}`),
-    agentId
-  );
-}
-var plugin = {
-  name: "@elizaos/plugin-localdb",
-  description: "Browser localStorage database storage for elizaOS examples.",
-  async init(_config, runtime) {
-    const r = runtime;
-    const hasAdapter = r.adapter !== void 0 || r.databaseAdapter !== void 0 || (r.hasDatabaseAdapter?.() ?? false);
-    if (hasAdapter) return;
-    const adapter = createDatabaseAdapter(runtime.agentId);
-    await adapter.initialize();
-    r.registerDatabaseAdapter?.(adapter);
-  }
-};
-var index_browser_default = plugin;
-export {
-  createDatabaseAdapter,
-  index_browser_default as default,
-  plugin
-};
-//# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../index.browser.ts"],"sourcesContent":["import type {\n  IAgentRuntime,\n  IDatabaseAdapter,\n  Plugin,\n  UUID,\n} from \"@elizaos/core\";\nimport {\n  InMemoryDatabaseAdapter,\n  type IStorage,\n} from \"@elizaos/plugin-inmemorydb\";\n\ntype RuntimeWithDatabase = IAgentRuntime & {\n  registerDatabaseAdapter?: (adapter: IDatabaseAdapter) => void;\n  adapter?: IDatabaseAdapter;\n  databaseAdapter?: IDatabaseAdapter;\n  hasDatabaseAdapter?: () => boolean;\n};\n\nclass BrowserLocalStorage implements IStorage {\n  private collections = new Map<string, Map<string, unknown>>();\n  private ready = false;\n\n  constructor(private readonly key: string) {}\n\n  async init(): Promise<void> {\n    const raw = globalThis.localStorage?.getItem(this.key);\n    if (raw) {\n      const parsed = JSON.parse(raw) as Record<string, Record<string, unknown>>;\n      for (const [collection, entries] of Object.entries(parsed)) {\n        this.collections.set(collection, new Map(Object.entries(entries)));\n      }\n    }\n    this.ready = true;\n  }\n\n  async close(): Promise<void> {\n    await this.flush();\n    this.ready = false;\n  }\n\n  async isReady(): Promise<boolean> {\n    return this.ready;\n  }\n\n  private getCollection(collection: string): Map<string, unknown> {\n    let current = this.collections.get(collection);\n    if (!current) {\n      current = new Map();\n      this.collections.set(collection, current);\n    }\n    return current;\n  }\n\n  private async flush(): Promise<void> {\n    const out: Record<string, Record<string, unknown>> = {};\n    for (const [collection, entries] of this.collections) {\n      out[collection] = Object.fromEntries(entries);\n    }\n    globalThis.localStorage?.setItem(this.key, JSON.stringify(out));\n  }\n\n  async get<T>(collection: string, id: string): Promise<T | null> {\n    const item = this.getCollection(collection).get(id);\n    return item === undefined ? null : (item as T);\n  }\n\n  async getAll<T>(collection: string): Promise<T[]> {\n    return Array.from(this.getCollection(collection).values()) as T[];\n  }\n\n  async getWhere<T>(\n    collection: string,\n    predicate: (item: T) => boolean,\n  ): Promise<T[]> {\n    return (await this.getAll<T>(collection)).filter(predicate);\n  }\n\n  async set<T>(collection: string, id: string, data: T): Promise<void> {\n    this.getCollection(collection).set(id, data);\n    await this.flush();\n  }\n\n  async delete(collection: string, id: string): Promise<boolean> {\n    const deleted = this.getCollection(collection).delete(id);\n    if (deleted) await this.flush();\n    return deleted;\n  }\n\n  async deleteMany(collection: string, ids: string[]): Promise<void> {\n    const current = this.getCollection(collection);\n    for (const id of ids) current.delete(id);\n    await this.flush();\n  }\n\n  async deleteWhere<T = Record<string, unknown>>(\n    collection: string,\n    predicate: (item: T) => boolean,\n  ): Promise<void> {\n    const current = this.getCollection(collection);\n    for (const [id, item] of current) {\n      if (predicate(item as T)) current.delete(id);\n    }\n    await this.flush();\n  }\n\n  async count<T = Record<string, unknown>>(\n    collection: string,\n    predicate?: (item: T) => boolean,\n  ): Promise<number> {\n    const current = this.getCollection(collection);\n    if (!predicate) return current.size;\n    let total = 0;\n    for (const item of current.values()) {\n      if (predicate(item as T)) total++;\n    }\n    return total;\n  }\n\n  async clear(): Promise<void> {\n    this.collections.clear();\n    await this.flush();\n  }\n}\n\nexport function createDatabaseAdapter(agentId: UUID): InMemoryDatabaseAdapter {\n  return new InMemoryDatabaseAdapter(\n    new BrowserLocalStorage(`elizaos:localdb:${agentId}`),\n    agentId,\n  );\n}\n\nexport const plugin: Plugin = {\n  name: \"@elizaos/plugin-localdb\",\n  description: \"Browser localStorage database storage for elizaOS examples.\",\n\n  async init(\n    _config: Record<string, string>,\n    runtime: IAgentRuntime,\n  ): Promise<void> {\n    const r = runtime as RuntimeWithDatabase;\n    const hasAdapter =\n      r.adapter !== undefined ||\n      r.databaseAdapter !== undefined ||\n      (r.hasDatabaseAdapter?.() ?? false);\n\n    if (hasAdapter) return;\n\n    const adapter = createDatabaseAdapter(runtime.agentId);\n    await adapter.initialize();\n    r.registerDatabaseAdapter?.(adapter);\n  },\n};\n\nexport default plugin;\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,7 +0,0 @@
-import { UUID, Plugin } from '@elizaos/core';
-import { InMemoryDatabaseAdapter } from '@elizaos/plugin-inmemorydb';
-
-declare function createDatabaseAdapter(agentId: UUID, dataDir: string): InMemoryDatabaseAdapter;
-declare const plugin: Plugin;
-
-export { createDatabaseAdapter, plugin as default, plugin };

package/dist/index.js

@@ -1,128 +0,0 @@
-// index.ts
-import { mkdir, readFile, writeFile } from "fs/promises";
-import { dirname, join } from "path";
-import { logger } from "@elizaos/core";
-import {
-  InMemoryDatabaseAdapter
-} from "@elizaos/plugin-inmemorydb";
-var FileStorage = class {
-  collections = /* @__PURE__ */ new Map();
-  ready = false;
-  filePath;
-  constructor(dataDir) {
-    this.filePath = join(dataDir, "localdb.json");
-  }
-  async init() {
-    await mkdir(dirname(this.filePath), { recursive: true });
-    try {
-      const raw = await readFile(this.filePath, "utf8");
-      const parsed = JSON.parse(raw);
-      for (const [collection, entries] of Object.entries(parsed)) {
-        this.collections.set(collection, new Map(Object.entries(entries)));
-      }
-    } catch (error) {
-      if (error.code !== "ENOENT") throw error;
-    }
-    this.ready = true;
-  }
-  async close() {
-    await this.flush();
-    this.ready = false;
-  }
-  async isReady() {
-    return this.ready;
-  }
-  getCollection(collection) {
-    let current = this.collections.get(collection);
-    if (!current) {
-      current = /* @__PURE__ */ new Map();
-      this.collections.set(collection, current);
-    }
-    return current;
-  }
-  async flush() {
-    const out = {};
-    for (const [collection, entries] of this.collections) {
-      out[collection] = Object.fromEntries(entries);
-    }
-    await writeFile(this.filePath, JSON.stringify(out, null, 2), "utf8");
-  }
-  async get(collection, id) {
-    const item = this.getCollection(collection).get(id);
-    return item === void 0 ? null : item;
-  }
-  async getAll(collection) {
-    return Array.from(this.getCollection(collection).values());
-  }
-  async getWhere(collection, predicate) {
-    return (await this.getAll(collection)).filter(predicate);
-  }
-  async set(collection, id, data) {
-    this.getCollection(collection).set(id, data);
-    await this.flush();
-  }
-  async delete(collection, id) {
-    const deleted = this.getCollection(collection).delete(id);
-    if (deleted) await this.flush();
-    return deleted;
-  }
-  async deleteMany(collection, ids) {
-    const current = this.getCollection(collection);
-    for (const id of ids) current.delete(id);
-    await this.flush();
-  }
-  async deleteWhere(collection, predicate) {
-    const current = this.getCollection(collection);
-    for (const [id, item] of current) {
-      if (predicate(item)) current.delete(id);
-    }
-    await this.flush();
-  }
-  async count(collection, predicate) {
-    const current = this.getCollection(collection);
-    if (!predicate) return current.size;
-    let total = 0;
-    for (const item of current.values()) {
-      if (predicate(item)) total++;
-    }
-    return total;
-  }
-  async clear() {
-    this.collections.clear();
-    await this.flush();
-  }
-};
-function getDataDir(runtime) {
-  const configured = runtime.getSetting?.("LOCALDB_DATA_DIR");
-  if (typeof configured === "string" && configured.length > 0) {
-    return configured;
-  }
-  const envDir = process.env.LOCALDB_DATA_DIR;
-  if (typeof envDir === "string" && envDir.length > 0) {
-    return envDir;
-  }
-  return join(process.cwd(), ".eliza-localdb");
-}
-function createDatabaseAdapter(agentId, dataDir) {
-  return new InMemoryDatabaseAdapter(new FileStorage(dataDir), agentId);
-}
-var plugin = {
-  name: "@elizaos/plugin-localdb",
-  description: "Local JSON-file database storage for elizaOS examples.",
-  async init(_config, runtime) {
-    const r = runtime;
-    const hasAdapter = r.adapter !== void 0 || r.databaseAdapter !== void 0 || (r.hasDatabaseAdapter?.() ?? false);
-    if (hasAdapter) return;
-    const adapter = createDatabaseAdapter(runtime.agentId, getDataDir(r));
-    await adapter.initialize();
-    r.registerDatabaseAdapter?.(adapter);
-    logger.info({ src: "plugin:localdb" }, "Local database adapter registered");
-  }
-};
-var index_default = plugin;
-export {
-  createDatabaseAdapter,
-  index_default as default,
-  plugin
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join } from \"node:path\";\nimport type {\n  IAgentRuntime,\n  IDatabaseAdapter,\n  Plugin,\n  UUID,\n} from \"@elizaos/core\";\nimport { logger } from \"@elizaos/core\";\nimport {\n  InMemoryDatabaseAdapter,\n  type IStorage,\n} from \"@elizaos/plugin-inmemorydb\";\n\ntype RuntimeWithDatabase = IAgentRuntime & {\n  registerDatabaseAdapter?: (adapter: IDatabaseAdapter) => void;\n  adapter?: IDatabaseAdapter;\n  databaseAdapter?: IDatabaseAdapter;\n  hasDatabaseAdapter?: () => boolean;\n  getSetting?: (key: string) => string | undefined;\n};\n\nclass FileStorage implements IStorage {\n  private collections = new Map<string, Map<string, unknown>>();\n  private ready = false;\n  private readonly filePath: string;\n\n  constructor(dataDir: string) {\n    this.filePath = join(dataDir, \"localdb.json\");\n  }\n\n  async init(): Promise<void> {\n    await mkdir(dirname(this.filePath), { recursive: true });\n    try {\n      const raw = await readFile(this.filePath, \"utf8\");\n      const parsed = JSON.parse(raw) as Record<string, Record<string, unknown>>;\n      for (const [collection, entries] of Object.entries(parsed)) {\n        this.collections.set(collection, new Map(Object.entries(entries)));\n      }\n    } catch (error) {\n      if ((error as { code?: string }).code !== \"ENOENT\") throw error;\n    }\n    this.ready = true;\n  }\n\n  async close(): Promise<void> {\n    await this.flush();\n    this.ready = false;\n  }\n\n  async isReady(): Promise<boolean> {\n    return this.ready;\n  }\n\n  private getCollection(collection: string): Map<string, unknown> {\n    let current = this.collections.get(collection);\n    if (!current) {\n      current = new Map();\n      this.collections.set(collection, current);\n    }\n    return current;\n  }\n\n  private async flush(): Promise<void> {\n    const out: Record<string, Record<string, unknown>> = {};\n    for (const [collection, entries] of this.collections) {\n      out[collection] = Object.fromEntries(entries);\n    }\n    await writeFile(this.filePath, JSON.stringify(out, null, 2), \"utf8\");\n  }\n\n  async get<T>(collection: string, id: string): Promise<T | null> {\n    const item = this.getCollection(collection).get(id);\n    return item === undefined ? null : (item as T);\n  }\n\n  async getAll<T>(collection: string): Promise<T[]> {\n    return Array.from(this.getCollection(collection).values()) as T[];\n  }\n\n  async getWhere<T>(\n    collection: string,\n    predicate: (item: T) => boolean,\n  ): Promise<T[]> {\n    return (await this.getAll<T>(collection)).filter(predicate);\n  }\n\n  async set<T>(collection: string, id: string, data: T): Promise<void> {\n    this.getCollection(collection).set(id, data);\n    await this.flush();\n  }\n\n  async delete(collection: string, id: string): Promise<boolean> {\n    const deleted = this.getCollection(collection).delete(id);\n    if (deleted) await this.flush();\n    return deleted;\n  }\n\n  async deleteMany(collection: string, ids: string[]): Promise<void> {\n    const current = this.getCollection(collection);\n    for (const id of ids) current.delete(id);\n    await this.flush();\n  }\n\n  async deleteWhere<T = Record<string, unknown>>(\n    collection: string,\n    predicate: (item: T) => boolean,\n  ): Promise<void> {\n    const current = this.getCollection(collection);\n    for (const [id, item] of current) {\n      if (predicate(item as T)) current.delete(id);\n    }\n    await this.flush();\n  }\n\n  async count<T = Record<string, unknown>>(\n    collection: string,\n    predicate?: (item: T) => boolean,\n  ): Promise<number> {\n    const current = this.getCollection(collection);\n    if (!predicate) return current.size;\n    let total = 0;\n    for (const item of current.values()) {\n      if (predicate(item as T)) total++;\n    }\n    return total;\n  }\n\n  async clear(): Promise<void> {\n    this.collections.clear();\n    await this.flush();\n  }\n}\n\nfunction getDataDir(runtime: RuntimeWithDatabase): string {\n  const configured = runtime.getSetting?.(\"LOCALDB_DATA_DIR\");\n  if (typeof configured === \"string\" && configured.length > 0) {\n    return configured;\n  }\n\n  const envDir = process.env.LOCALDB_DATA_DIR;\n  if (typeof envDir === \"string\" && envDir.length > 0) {\n    return envDir;\n  }\n\n  return join(process.cwd(), \".eliza-localdb\");\n}\n\nexport function createDatabaseAdapter(\n  agentId: UUID,\n  dataDir: string,\n): InMemoryDatabaseAdapter {\n  return new InMemoryDatabaseAdapter(new FileStorage(dataDir), agentId);\n}\n\nexport const plugin: Plugin = {\n  name: \"@elizaos/plugin-localdb\",\n  description: \"Local JSON-file database storage for elizaOS examples.\",\n\n  async init(\n    _config: Record<string, string>,\n    runtime: IAgentRuntime,\n  ): Promise<void> {\n    const r = runtime as RuntimeWithDatabase;\n    const hasAdapter =\n      r.adapter !== undefined ||\n      r.databaseAdapter !== undefined ||\n      (r.hasDatabaseAdapter?.() ?? false);\n\n    if (hasAdapter) return;\n\n    const adapter = createDatabaseAdapter(runtime.agentId, getDataDir(r));\n    await adapter.initialize();\n    r.registerDatabaseAdapter?.(adapter);\n    logger.info({ src: \"plugin:localdb\" }, \"Local database adapter registered\");\n  },\n};\n\nexport default plugin;\n"],"mappings":"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","names":[]}