@alfe.ai/openclaw-database 0.0.2 → 0.0.4

package/dist/plugin.d.ts

@@ -2,6 +2,7 @@
 interface PluginApi {
   logger: {
     info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;
     debug: (...args: unknown[]) => void;
   };
@@ -11,7 +12,7 @@ declare const plugin: {
   id: string;
   name: string;
   version: string;
-  activate(api: PluginApi): Promise<void>;
+  activate(api: PluginApi): void;
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion

package/dist/plugin2.js

@@ -14,11 +14,17 @@ function optStr() {
 		default: ""
 	};
 }
-function registerTools(api, client, databases, audit) {
-	function db(name) {
+function registerTools(api, _client, _databases, audit, lazyInit) {
+	async function db(name) {
+		const { mongoClient, databases } = lazyInit ? await lazyInit() : {
+			mongoClient: _client ?? (() => {
+				throw new Error("MongoDB client not initialized");
+			})(),
+			databases: _databases
+		};
 		const dbName = name ?? DEFAULT_DB;
 		if (!databases.includes(dbName)) throw new Error(`Access denied: database "${dbName}" is not in the allowed list`);
-		return client.db(dbName);
+		return mongoClient.db(dbName);
 	}
 	api.registerTool({
 		name: "db_find",
@@ -53,7 +59,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			const docs = await db(p.database).collection(p.collection).find(p.filter).sort(p.sort).project(p.projection).skip(p.skip || 0).limit(p.limit || 20).toArray();
+			const docs = await (await db(p.database)).collection(p.collection).find(p.filter).sort(p.sort).project(p.projection).skip(p.skip || 0).limit(p.limit || 20).toArray();
 			return {
 				documents: docs,
 				count: docs.length
@@ -81,7 +87,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			return await db(p.database).collection(p.collection).findOne(p.filter, { projection: p.projection }) ?? { _not_found: true };
+			return await (await db(p.database)).collection(p.collection).findOne(p.filter, { projection: p.projection }) ?? { _not_found: true };
 		}
 	});
 	api.registerTool({
@@ -102,7 +108,7 @@ function registerTools(api, client, databases, audit) {
 		},
 		execute: async (_id, p) => {
 			const docs = p.documents;
-			const result = await db(p.database).collection(p.collection).insertMany(docs);
+			const result = await (await db(p.database)).collection(p.collection).insertMany(docs);
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -138,7 +144,7 @@ function registerTools(api, client, databases, audit) {
 			]
 		},
 		execute: async (_id, p) => {
-			const result = await db(p.database).collection(p.collection).updateMany(p.filter, p.update, { upsert: p.upsert || false });
+			const result = await (await db(p.database)).collection(p.collection).updateMany(p.filter, p.update, { upsert: p.upsert || false });
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -166,7 +172,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection", "filter"]
 		},
 		execute: async (_id, p) => {
-			const result = await db(p.database).collection(p.collection).deleteMany(p.filter);
+			const result = await (await db(p.database)).collection(p.collection).deleteMany(p.filter);
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -193,7 +199,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			return { count: await db(p.database).collection(p.collection).countDocuments(p.filter) };
+			return { count: await (await db(p.database)).collection(p.collection).countDocuments(p.filter) };
 		}
 	});
 	api.registerTool({
@@ -213,7 +219,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection", "pipeline"]
 		},
 		execute: async (_id, p) => {
-			const results = await db(p.database).collection(p.collection).aggregate(p.pipeline).toArray();
+			const results = await (await db(p.database)).collection(p.collection).aggregate(p.pipeline).toArray();
 			return {
 				results,
 				count: results.length
@@ -228,7 +234,10 @@ function registerTools(api, client, databases, audit) {
 			type: "object",
 			properties: {}
 		},
-		execute: () => Promise.resolve({ databases })
+		execute: async () => {
+			const { databases } = lazyInit ? await lazyInit() : { databases: _databases };
+			return { databases };
+		}
 	});
 	api.registerTool({
 		name: "db_list_collections",
@@ -239,7 +248,7 @@ function registerTools(api, client, databases, audit) {
 			properties: { database: optStr() }
 		},
 		execute: async (_id, p) => {
-			return { collections: (await db(p.database).listCollections().toArray()).map((c) => ({
+			return { collections: (await (await db(p.database)).listCollections().toArray()).map((c) => ({
 				name: c.name,
 				type: c.type
 			})) };
@@ -258,7 +267,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			await db(p.database).createCollection(p.collection);
+			await (await db(p.database)).createCollection(p.collection);
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -280,7 +289,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			await db(p.database).dropCollection(p.collection);
+			await (await db(p.database)).dropCollection(p.collection);
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -302,7 +311,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			const sample = await db(p.database).collection(p.collection).find().limit(100).toArray();
+			const sample = await (await db(p.database)).collection(p.collection).find().limit(100).toArray();
 			const fieldTypes = /* @__PURE__ */ new Map();
 			for (const doc of sample) for (const [key, value] of Object.entries(doc)) {
 				const types = fieldTypes.get(key) ?? /* @__PURE__ */ new Set();
@@ -331,7 +340,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			const coll = db(p.database).collection(p.collection);
+			const coll = (await db(p.database)).collection(p.collection);
 			const count = await coll.countDocuments();
 			const indexes = await coll.indexes();
 			return {
@@ -362,7 +371,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection", "keys"]
 		},
 		execute: async (_id, p) => {
-			const indexName = await db(p.database).collection(p.collection).createIndex(p.keys, p.options);
+			const indexName = await (await db(p.database)).collection(p.collection).createIndex(p.keys, p.options);
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -385,7 +394,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection"]
 		},
 		execute: async (_id, p) => {
-			return { indexes: (await db(p.database).collection(p.collection).indexes()).map((i) => ({
+			return { indexes: (await (await db(p.database)).collection(p.collection).indexes()).map((i) => ({
 				name: i.name,
 				key: i.key,
 				unique: i.unique
@@ -406,7 +415,7 @@ function registerTools(api, client, databases, audit) {
 			required: ["collection", "indexName"]
 		},
 		execute: async (_id, p) => {
-			await db(p.database).collection(p.collection).dropIndex(p.indexName);
+			await (await db(p.database)).collection(p.collection).dropIndex(p.indexName);
 			audit({
 				database: p.database || DEFAULT_DB,
 				collection: p.collection,
@@ -420,6 +429,7 @@ function registerTools(api, client, databases, audit) {
 //#endregion
 //#region src/plugin.ts
 let mongoClient = null;
+let initPromise = null;
 async function fetchCredentials(apiUrl, apiKey) {
 	const res = await fetch(`${apiUrl}/agents/database/register`, {
 		method: "POST",
@@ -431,6 +441,37 @@ async function fetchCredentials(apiUrl, apiKey) {
 	if (!res.ok) throw new Error(`Failed to register database credentials: ${String(res.status)} ${res.statusText}`);
 	return (await res.json()).data;
 }
+/**
+* Lazy initializer — fetches credentials and connects to MongoDB on first use.
+* Returns a shared promise so concurrent calls don't duplicate work.
+*/
+function ensureInitialized(apiUrl, apiKey) {
+	if (initPromise) return initPromise;
+	initPromise = (async () => {
+		const credentials = await fetchCredentials(apiUrl, apiKey);
+		if (!credentials.connectionString) throw new Error("No connection string returned — cluster may still be provisioning");
+		const url = new URL(credentials.connectionString);
+		url.username = credentials.username;
+		url.password = credentials.password;
+		const client = new MongoClient(url.toString(), {
+			maxPoolSize: 3,
+			minPoolSize: 1,
+			serverSelectionTimeoutMS: 5e3
+		});
+		await client.connect();
+		mongoClient = client;
+		return {
+			mongoClient: client,
+			databases: credentials.databases,
+			apiUrl,
+			apiKey
+		};
+	})();
+	initPromise.catch(() => {
+		initPromise = null;
+	});
+	return initPromise;
+}
 function reportAudit(apiUrl, apiKey, entry) {
 	fetch(`${apiUrl}/agents/database/audit`, {
 		method: "POST",
@@ -445,37 +486,27 @@ const plugin = {
 	id: "@alfe.ai/openclaw-database",
 	name: "Database",
 	version: "0.0.1",
-	async activate(api) {
+	activate(api) {
 		const log = api.logger;
 		log.info("Database plugin activating...");
 		let apiUrl;
 		let apiKey;
 		try {
-			const config = await resolveConfig();
+			const config = resolveConfig();
 			apiUrl = config.apiUrl;
 			apiKey = config.apiKey;
 		} catch (err) {
 			log.error(`Database plugin: failed to resolve config — ${err instanceof Error ? err.message : String(err)}`);
 			return;
 		}
-		const credentials = await fetchCredentials(apiUrl, apiKey);
-		if (!credentials.connectionString) {
-			log.error("Database plugin: no connection string returned — cluster may still be provisioning");
-			return;
-		}
-		const url = new URL(credentials.connectionString);
-		url.username = credentials.username;
-		url.password = credentials.password;
-		mongoClient = new MongoClient(url.toString(), {
-			maxPoolSize: 3,
-			minPoolSize: 1,
-			serverSelectionTimeoutMS: 5e3
+		ensureInitialized(apiUrl, apiKey).then(({ databases }) => {
+			log.info(`Database plugin connected — ${String(databases.length)} databases available`);
+		}).catch((err) => {
+			log.warn(`Database plugin: background init failed (will retry on first tool use) — ${err instanceof Error ? err.message : String(err)}`);
 		});
-		await mongoClient.connect();
-		log.info(`Database plugin connected — ${String(credentials.databases.length)} databases available`);
-		registerTools(api, mongoClient, credentials.databases, (entry) => {
+		registerTools(api, null, [], (entry) => {
 			reportAudit(apiUrl, apiKey, entry);
-		});
+		}, () => ensureInitialized(apiUrl, apiKey));
 	},
 	async deactivate(api) {
 		api.logger.info("Database plugin deactivating...");

package/openclaw.plugin.json

@@ -3,5 +3,10 @@
   "name": "Database",
   "version": "0.0.1",
   "description": "MongoDB database access for agents — query, insert, update, delete, and manage collections",
-  "entry": "./dist/plugin.js"
+  "entry": "./dist/plugin.js",
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-database",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "OpenClaw database plugin — MongoDB access for agents via MCP tools",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -26,7 +26,7 @@
   ],
   "dependencies": {
     "mongodb": "^6.12.0",
-    "@alfe.ai/config": "0.0.5"
+    "@alfe.ai/config": "0.0.6"
   },
   "license": "UNLICENSED",
   "scripts": {