openclaw-overlay-plugin 0.8.9 → 0.8.11

package/dist/index.js

@@ -12,6 +12,8 @@ import { cmdServiceQueue } from './src/scripts/services/queue.js';
 import { cmdRespondService } from './src/scripts/services/respond.js';
 import { cmdConnect } from './src/scripts/messaging/connect.js';
 import { setNoExit } from './src/scripts/output.js';
+import debug from 'debug';
+const log = debug('openclaw:plugin:overlay');
 // Track background service state
 let serviceRunning = false;
 let abortController = null;
@@ -251,7 +253,9 @@ export function register(api) {
         acceptsArgs: true,
         handler: async (ctx) => {
             try {
-                const action = ctx.args?.[0] || 'status';
+                api.logger?.info?.(`[openclaw-overlay] Command received with args: ${JSON.stringify(ctx.args)} (type: ${typeof ctx.args})`);
+                const args = Array.isArray(ctx.args) ? ctx.args : (typeof ctx.args === 'string' ? ctx.args.split(' ').filter(Boolean) : []);
+                const action = args[0] || 'status';
                 const result = await executeOverlayAction({ action }, pluginConfig, api);
                 return { text: `**Overlay ${action.toUpperCase()}**\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}` };
             }
@@ -300,6 +304,7 @@ export function register(api) {
 }
 async function executeOverlayAction(params, config, api) {
     const { action } = params;
+    log('Executing action: %s with params: %O', action, params);
     applyConfigToEnv(config);
     switch (action) {
         case "request": {

package/dist/src/compatibility.test.js

@@ -1,21 +1,10 @@
 /**
  * Compatibility Test for Node 24 and OpenClaw SDK
  */
-import sqlite3 from 'sqlite3';
 import { plugin } from '../index.js';
 async function testCompatibility() {
     console.log('--- Overlay Compatibility Test ---');
-    // 1. Verify SQLite3 Native Bindings
-    try {
-        const db = new sqlite3.Database(':memory:');
-        console.log('✓ SQLite3 native bindings loaded successfully.');
-        db.close();
-    }
-    catch (err) {
-        console.error('✗ SQLite3 failed to load bindings:', err.message);
-        process.exit(1);
-    }
-    // 2. Verify Plugin Registration (SDK Descriptors)
+    // 1. Verify Plugin Registration (SDK Descriptors)
     let registeredCli = false;
     let hasDescriptors = false;
     const mockApi = {

package/dist/src/core/wallet.js

@@ -10,6 +10,8 @@ import { Wallet, WalletStorageManager, Services, Monitor, StorageKnex, randomByt
 import knexLib from 'knex';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
+import debug from 'debug';
+const log = debug('openclaw:plugin:overlay:wallet');
 import { toChain, DEFAULT_TAAL_API_KEYS, DEFAULT_DB_NAME } from './config.js';
 import { buildPayment } from './payment.js';
 import { verifyPayment, acceptPayment } from './verify.js';
@@ -50,6 +52,7 @@ export class BSVAgentWallet {
      * The SQLite database and identity file are written to `config.storageDir`.
      */
     static async create(config) {
+        log('Creating new wallet in: %s', config.storageDir);
         // Generate a new root key (or use one provided in config)
         const rootKeyHex = config.rootKeyHex ?? PrivateKey.fromRandom().toHex();
         const rootKey = PrivateKey.fromHex(rootKeyHex);
@@ -73,9 +76,11 @@ export class BSVAgentWallet {
      * Reads the persisted identity file and re-initializes the wallet.
      */
     static async load(config) {
+        log('Loading wallet from: %s', config.storageDir);
         const identityPath = path.join(config.storageDir, IDENTITY_FILE);
         if (!fs.existsSync(identityPath)) {
             if (config.createIfMissing === false) {
+                log('Wallet not found and createIfMissing is false');
                 throw new Error(`No wallet found in ${config.storageDir}`);
             }
             return this.create(config);
@@ -182,6 +187,7 @@ export class BSVAgentWallet {
      */
     static async buildSetup(config, rootKeyHex) {
         const chain = toChain(config.network);
+        log('Building setup for chain: %s (network: %s)', chain, config.network);
         const taalApiKey = config.taalApiKey ?? DEFAULT_TAAL_API_KEYS[chain];
         const rootKey = PrivateKey.fromHex(rootKeyHex);
         const identityKey = rootKey.toPublicKey().toString();
@@ -217,7 +223,7 @@ export class BSVAgentWallet {
         // 6. SQLite storage via knex
         const filePath = path.join(config.storageDir, `${DEFAULT_DB_NAME}.sqlite`);
         const knex = knexLib({
-            client: 'better-sqlite3',
+            client: 'sqlite3',
             connection: { filename: filePath },
             useNullAsDefault: true,
         });

package/dist/src/scripts/messaging/connect.js

@@ -7,6 +7,8 @@ import { fail } from '../output.js';
 import { loadIdentity } from '../wallet/identity.js';
 import { processMessage } from './handlers.js';
 import { ensureStateDir } from '../utils/storage.js';
+import debug from 'debug';
+const log = debug('openclaw:plugin:overlay:connect');
 /**
  * Connect command: establish WebSocket connection for real-time messaging.
  * Supports being used as a library with onMessage callback and AbortSignal.
@@ -22,6 +24,7 @@ export async function cmdConnect(onMessage, signal) {
     }
     const { identityKey, privKey } = await loadIdentity();
     const wsUrl = OVERLAY_URL.replace(/^http/, 'ws') + '/relay/subscribe?identity=' + identityKey;
+    log('Connecting to WebSocket relay: %s', wsUrl);
     let reconnectDelay = 1000;
     let shouldReconnect = true;
     let currentWs = null;
@@ -59,18 +62,22 @@ export async function cmdConnect(onMessage, signal) {
         const ws = new WebSocketClient(wsUrl);
         currentWs = ws;
         ws.on('open', () => {
+            log('WebSocket connection established!');
             reconnectDelay = 1000; // reset on successful connect
-            const log = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
+            const logMsg = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
             if (onMessage)
-                onMessage(log);
+                onMessage(logMsg);
             else
-                console.error(JSON.stringify(log));
+                console.error(JSON.stringify(logMsg));
         });
         ws.on('message', async (data) => {
+            log('Incoming WebSocket message received');
             try {
                 const envelope = JSON.parse(data.toString());
+                log('Message type: %s', envelope.type);
                 if (envelope.type === 'message') {
                     const result = await processMessage(envelope.message, identityKey, privKey);
+                    log('Processed message: %s', result.id);
                     if (onMessage)
                         onMessage(result);
                     else

package/index.ts

@@ -13,6 +13,9 @@ import { cmdServiceQueue } from './src/scripts/services/queue.js';
 import { cmdRespondService } from './src/scripts/services/respond.js';
 import { cmdConnect } from './src/scripts/messaging/connect.js';
 import { setNoExit } from './src/scripts/output.js';
+import debug from 'debug';
+
+const log = debug('openclaw:plugin:overlay');
 
 // Track background service state
 let serviceRunning = false;
@@ -260,7 +263,9 @@ export function register(api: any) {
     acceptsArgs: true,
     handler: async (ctx: any) => {
       try {
-        const action = ctx.args?.[0] || 'status';
+        api.logger?.info?.(`[openclaw-overlay] Command received with args: ${JSON.stringify(ctx.args)} (type: ${typeof ctx.args})`);
+        const args = Array.isArray(ctx.args) ? ctx.args : (typeof ctx.args === 'string' ? ctx.args.split(' ').filter(Boolean) : []);
+        const action = args[0] || 'status';
         const result = await executeOverlayAction({ action }, pluginConfig, api);
         return { text: `**Overlay ${action.toUpperCase()}**\n\n${typeof result === 'string' ? result : JSON.stringify(result, null, 2)}` };
       } catch (error: any) {
@@ -306,6 +311,7 @@ export function register(api: any) {
 
 async function executeOverlayAction(params: any, config: any, api: any) {
   const { action } = params;
+  log('Executing action: %s with params: %O', action, params);
   applyConfigToEnv(config);
 
   switch (action) {

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-overlay-plugin",
   "name": "BSV Overlay Network",
   "description": "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
-  "version": "0.8.9",
+  "version": "0.8.11",
   "skills": [
     "./SKILL.md"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-overlay-plugin",
-  "version": "0.8.9",
+  "version": "0.8.11",
   "description": "Openclaw BSV Overlay — agent discovery, service marketplace, and micropayments on the BSV blockchain",
   "publishConfig": {
     "access": "public"
@@ -25,16 +25,18 @@
     "test": "npx tsx src/test/cli.test.ts && npx tsx src/test/taskflow.test.ts && npx tsx src/test/key-derivation.test.ts",
     "postversion": "node ../sync_versions.js",
     "lint": "eslint src/**/*.ts",
-    "postinstall": "node -e \"try{require('better-sqlite3')}catch{console.log('Note: better-sqlite3 requires build tools. If install failed, ensure python3 and a C++ compiler are available.')}\""
+    "postinstall": "node -e \"try{require('sqlite3')}catch{console.log('Note: sqlite3 requires build tools. If install failed, ensure python3 and a C++ compiler are available.')}\""
   },
   "dependencies": {
     "@bsv/sdk": "^2.0.13",
     "@bsv/wallet-toolbox": "^2.1.18",
-    "better-sqlite3": "^11.0.0",
+    "debug": "^4.4.0",
     "dotenv": "^17.3.1",
-    "knex": "^3.1.0"
+    "knex": "^3.1.0",
+    "sqlite3": "^5.1.7"
   },
   "devDependencies": {
+    "@types/debug": "^4.1.12",
     "@types/node": "^22.10.0",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.58.0",

package/src/ambient.d.ts

@@ -0,0 +1 @@
+declare module "debug";

package/src/compatibility.test.ts

@@ -2,23 +2,12 @@
  * Compatibility Test for Node 24 and OpenClaw SDK
  */
 
-import sqlite3 from 'sqlite3';
 import { plugin } from '../index.js';
 
 async function testCompatibility() {
   console.log('--- Overlay Compatibility Test ---');
   
-  // 1. Verify SQLite3 Native Bindings
-  try {
-    const db = new sqlite3.Database(':memory:');
-    console.log('✓ SQLite3 native bindings loaded successfully.');
-    db.close();
-  } catch (err: any) {
-    console.error('✗ SQLite3 failed to load bindings:', err.message);
-    process.exit(1);
-  }
-
-  // 2. Verify Plugin Registration (SDK Descriptors)
+  // 1. Verify Plugin Registration (SDK Descriptors)
   let registeredCli = false;
   let hasDescriptors = false;
   

package/src/core/wallet.ts

@@ -20,6 +20,9 @@ import type { SetupWallet } from '@bsv/wallet-toolbox';
 import knexLib from 'knex';
 import * as path from 'node:path';
 import * as fs from 'node:fs';
+import debug from 'debug';
+
+const log = debug('openclaw:plugin:overlay:wallet');
 
 import type {
   WalletConfig,
@@ -76,6 +79,7 @@ export class BSVAgentWallet {
    * The SQLite database and identity file are written to `config.storageDir`.
    */
   private static async create(config: WalletConfig): Promise<BSVAgentWallet> {
+    log('Creating new wallet in: %s', config.storageDir);
     // Generate a new root key (or use one provided in config)
     const rootKeyHex = config.rootKeyHex ?? PrivateKey.fromRandom().toHex();
     const rootKey = PrivateKey.fromHex(rootKeyHex);
@@ -104,9 +108,11 @@ export class BSVAgentWallet {
    * Reads the persisted identity file and re-initializes the wallet.
    */
   static async load(config: WalletConfig & { createIfMissing?: boolean }): Promise<BSVAgentWallet> {
+    log('Loading wallet from: %s', config.storageDir);
     const identityPath = path.join(config.storageDir, IDENTITY_FILE);
     if (!fs.existsSync(identityPath)) {
       if (config.createIfMissing === false) {
+        log('Wallet not found and createIfMissing is false');
         throw new Error(`No wallet found in ${config.storageDir}`);
       }
       return this.create(config);
@@ -235,6 +241,7 @@ export class BSVAgentWallet {
     rootKeyHex: string,
   ): Promise<SetupWallet> {
     const chain = toChain(config.network);
+    log('Building setup for chain: %s (network: %s)', chain, config.network);
     const taalApiKey = config.taalApiKey ?? DEFAULT_TAAL_API_KEYS[chain];
 
     const rootKey = PrivateKey.fromHex(rootKeyHex);
@@ -279,7 +286,7 @@ export class BSVAgentWallet {
     // 6. SQLite storage via knex
     const filePath = path.join(config.storageDir, `${DEFAULT_DB_NAME}.sqlite`);
     const knex = knexLib({
-      client: 'better-sqlite3',
+      client: 'sqlite3',
       connection: { filename: filePath },
       useNullAsDefault: true,
     });

package/src/scripts/messaging/connect.ts

@@ -8,6 +8,9 @@ import { fail } from '../output.js';
 import { loadIdentity } from '../wallet/identity.js';
 import { processMessage } from './handlers.js';
 import { ensureStateDir } from '../utils/storage.js';
+import debug from 'debug';
+
+const log = debug('openclaw:plugin:overlay:connect');
 
 /**
  * Connect command: establish WebSocket connection for real-time messaging.
@@ -24,6 +27,7 @@ export async function cmdConnect(onMessage?: (data: any) => void, signal?: Abort
 
   const { identityKey, privKey } = await loadIdentity();
   const wsUrl = OVERLAY_URL.replace(/^http/, 'ws') + '/relay/subscribe?identity=' + identityKey;
+  log('Connecting to WebSocket relay: %s', wsUrl);
 
   let reconnectDelay = 1000;
   let shouldReconnect = true;
@@ -60,17 +64,21 @@ export async function cmdConnect(onMessage?: (data: any) => void, signal?: Abort
     currentWs = ws;
 
     ws.on('open', () => {
+      log('WebSocket connection established!');
       reconnectDelay = 1000; // reset on successful connect
-      const log = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
-      if (onMessage) onMessage(log);
-      else console.error(JSON.stringify(log));
+      const logMsg = { event: 'connected', identity: identityKey, overlay: OVERLAY_URL };
+      if (onMessage) onMessage(logMsg);
+      else console.error(JSON.stringify(logMsg));
     });
 
     ws.on('message', async (data: any) => {
+      log('Incoming WebSocket message received');
       try {
         const envelope = JSON.parse(data.toString());
+        log('Message type: %s', envelope.type);
         if (envelope.type === 'message') {
           const result = await processMessage(envelope.message, identityKey, privKey);
+          log('Processed message: %s', result.id);
           
           if (onMessage) onMessage(result);
           else console.log(JSON.stringify(result));