openclaw-overlay-plugin 0.7.65 → 0.7.67

package/dist/index.d.ts

@@ -1,2 +1,12 @@
-export declare function activate(api: any): Promise<void>;
-export default function register(api: any): void;
+/**
+ * OpenClaw Overlay Plugin
+ * Decentralized agent marketplace with BSV micropayments.
+ */
+export declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    activate(api: any): Promise<void>;
+    register(api: any): void;
+};
+export default plugin;

package/dist/index.js

@@ -7,9 +7,11 @@ import path from 'node:path';
 import os from 'node:os';
 import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
+import process from 'node:process';
 import { serviceManager } from './src/services/index.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+let isInitialized = false;
 async function ensureCp() {
     if (execFileAsync)
         return;
@@ -57,7 +59,7 @@ function loadDailySpending(walletDir) {
     return { date: today, totalSats: 0, transactions: [] };
 }
 function writeActivityEvent(event) {
-    const alertDir = path.join(process['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay');
+    const alertDir = path.join(process['env'].HOME || '', '.openclaw', 'openclaw-overlay');
     try {
         fs.mkdirSync(alertDir, { recursive: true });
         fs.appendFileSync(path.join(alertDir, 'activity-feed.jsonl'), JSON.stringify({ ...event, ts: Date.now() }) + '\n');
@@ -115,7 +117,7 @@ async function startAutoImport(env, cliPath, logger) {
                             logger?.info?.(`[openclaw-overlay] Auto-imported ${utxo.value} sats from ${utxo.tx_hash}`);
                             // Clear onboarding flag since wallet is now funded
                             try {
-                                const onboardingSentFile = path.join(process['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
+                                const onboardingSentFile = path.join(process['env'].HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
                                 if (fs.existsSync(onboardingSentFile)) {
                                     fs.unlinkSync(onboardingSentFile);
                                 }
@@ -125,7 +127,7 @@ async function startAutoImport(env, cliPath, logger) {
                             wakeAgent(`💰 **Wallet Funded!**\n\nAuto-imported ${utxo.value} sats from transaction ${utxo.tx_hash.slice(0, 16)}...\n\nNotify the user their wallet has been funded.`, logger, { sessionKey: 'hook:openclaw-overlay:import' });
                             // Check if registered, auto-register if not
                             try {
-                                const regPath = path.join(process['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
+                                const regPath = path.join(process['env'].HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
                                 if (!fs.existsSync(regPath)) {
                                     logger?.info?.('[openclaw-overlay] Not yet registered — auto-registering...');
                                     const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
@@ -196,7 +198,7 @@ async function autoAdvertiseServices(env, cliPath, logger) {
 }
 function wakeAgent(text, logger, options = {}) {
     const sessionKey = options.sessionKey || `hook:openclaw-overlay:${Date.now()}`;
-    const gatewayPort = process['en' + 'v'].OPENCLAW_GATEWAY_PORT || '18789';
+    const gatewayPort = process['env'].OPENCLAW_GATEWAY_PORT || '18789';
     const httpToken = getHooksToken();
     if (!httpToken)
         return;
@@ -207,7 +209,7 @@ function wakeAgent(text, logger, options = {}) {
     }).catch(() => { });
 }
 function getHooksToken() {
-    let token = process['en' + 'v'].OPENCLAW_HOOKS_TOKEN || null;
+    let token = process['env'].OPENCLAW_HOOKS_TOKEN || null;
     if (!token) {
         try {
             const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
@@ -262,7 +264,7 @@ function startBackgroundService(env, cliPath, logger) {
                     }
                     const notif = categorizeEvent(event);
                     if (notif) {
-                        const dir = path.join(process['en' + 'v'].HOME || '', '.openclaw', 'openclaw-overlay');
+                        const dir = path.join(process['env'].HOME || '', '.openclaw', 'openclaw-overlay');
                         fs.mkdirSync(dir, { recursive: true });
                         fs.appendFileSync(path.join(dir, 'activity-feed.jsonl'), JSON.stringify(notif) + '\n');
                     }
@@ -291,94 +293,104 @@ function stopBackgroundService() {
     wokenRequests.clear();
     stopAutoImport();
 }
-export async function activate(api) {
-    return register(api);
-}
-let isInitialized = false;
 function getCliPath() {
     const base = __dirname.endsWith('dist') ? __dirname : path.join(__dirname, 'dist');
     return path.join(base, 'src', 'cli.js');
 }
-export default function register(api) {
-    if (isInitialized)
-        return;
-    isInitialized = true;
-    const entries = api.getConfig?.()?.plugins?.entries || {};
-    const entry = entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
-    const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
-    // 1. Tool
-    api.registerTool({
-        name: "overlay",
-        description: "Access the BSV agent marketplace",
-        parameters: {
-            type: "object",
-            properties: {
-                action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister"] },
-                service: { type: "string" },
-                input: { type: "object" },
-                identityKey: { type: "string" },
-                sats: { type: "number" },
-                requestId: { type: "string" },
-                recipientKey: { type: "string" },
-                serviceId: { type: "string" },
-                result: { type: "object" }
+/**
+ * OpenClaw Overlay Plugin
+ * Decentralized agent marketplace with BSV micropayments.
+ */
+export const plugin = {
+    id: "openclaw-overlay-plugin",
+    name: "BSV Overlay Network",
+    description: "OpenClaw Overlay — decentralized agent marketplace with BSV micropayments",
+    async activate(api) {
+        return this.register(api);
+    },
+    register(api) {
+        if (isInitialized)
+            return;
+        isInitialized = true;
+        const entries = api.getConfig?.()?.plugins?.entries || {};
+        const entry = entries['openclaw-overlay-plugin'] || entries['openclaw-overlay'] || {};
+        const pluginConfig = { ...entry, ...(entry.config || {}), ...(api.config || {}) };
+        // 1. Tool
+        api.registerTool({
+            name: "overlay",
+            description: "Access the BSV agent marketplace",
+            parameters: {
+                type: "object",
+                properties: {
+                    action: { type: "string", enum: ["request", "discover", "balance", "status", "pay", "onboard", "pending-requests", "fulfill", "unregister"] },
+                    service: { type: "string" },
+                    input: { type: "object" },
+                    identityKey: { type: "string" },
+                    sats: { type: "number" },
+                    requestId: { type: "string" },
+                    recipientKey: { type: "string" },
+                    serviceId: { type: "string" },
+                    result: { type: "object" }
+                },
+                required: ["action"]
             },
-            required: ["action"]
-        },
-        async execute(_id, params) {
-            try {
-                return await executeOverlayAction(params, pluginConfig, api);
-            }
-            catch (error) {
-                return { content: [{ type: "text", text: `Error: ${error.message}` }] };
-            }
-        }
-    });
-    // 2. Command
-    api.registerCommand({
-        name: "overlay",
-        description: "BSV Overlay Marketplace commands",
-        acceptsArgs: true,
-        handler: async (ctx) => {
-            try {
-                const action = ctx.args?.[0] || 'status';
-                if (action === 'help') {
-                    return { text: `🛰️ **Overlay Help**\n\n**Subcommands**:\n- \`status\`: Show identity and wallet balance\n- \`balance\`: Show current satoshis\n- \`onboard\`: Start discovery setup\n- \`discover <serviceId>\`: Find providers on network\n- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
+            async execute(_id, params) {
+                try {
+                    return await executeOverlayAction(params, pluginConfig, api);
+                }
+                catch (error) {
+                    return { content: [{ type: "text", text: `Error: ${error.message}` }] };
                 }
-                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) {
-                return { text: `❌ Error: ${error.message}` };
+        });
+        // 2. Command
+        api.registerCommand({
+            name: "overlay",
+            description: "BSV Overlay Marketplace commands",
+            acceptsArgs: true,
+            requireAuth: true,
+            handler: async (ctx) => {
+                try {
+                    const action = ctx.args?.[0] || 'status';
+                    if (action === 'help') {
+                        return { text: `🛰️ **Overlay Help**\n\n**Subcommands**:\n- \`status\`: Show identity and wallet balance\n- \`balance\`: Show current satoshis\n- \`onboard\`: Start discovery setup\n- \`discover <serviceId>\`: Find providers on network\n- \`pending-requests\`: See incoming service jobs\n- \`fulfill\`: Complete a request (Agent only)` };
+                    }
+                    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) {
+                    return { text: `❌ Error: ${error.message}` };
+                }
             }
-        }
-    });
-    // 3. Service
-    api.registerService({
-        id: "openclaw-overlay-relay",
-        start: async () => {
-            const env = buildEnvironment(pluginConfig);
-            const cliPath = getCliPath();
-            startBackgroundService(env, cliPath, api.logger);
-            startAutoImport(env, cliPath, api.logger);
-        },
-        stop: () => stopBackgroundService()
-    });
-    // 4. CLI
-    api.registerCli(({ program }) => {
-        const overlay = program.command("overlay").description("BSV Overlay Network management");
-        overlay.command("status").action(async () => {
-            await ensureCp();
-            const result = await handleStatus(buildEnvironment(pluginConfig), getCliPath());
-            console.log(JSON.stringify(result, null, 2));
         });
-        overlay.command("balance").action(async () => {
-            await ensureCp();
-            const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
-            console.log(JSON.stringify(result, null, 2));
+        // 3. Service
+        api.registerService({
+            id: "openclaw-overlay-relay",
+            start: async () => {
+                const env = buildEnvironment(pluginConfig);
+                const cliPath = getCliPath();
+                startBackgroundService(env, cliPath, api.logger);
+                startAutoImport(env, cliPath, api.logger);
+            },
+            stop: () => stopBackgroundService()
         });
-    }, { commands: ["overlay"] });
-}
+        // 4. CLI
+        api.registerCli(({ program }) => {
+            const overlay = program.command("overlay").description("BSV Overlay Network management");
+            overlay.command("status").action(async () => {
+                await ensureCp();
+                const result = await handleStatus(buildEnvironment(pluginConfig), getCliPath());
+                console.log(JSON.stringify(result, null, 2));
+            });
+            overlay.command("balance").action(async () => {
+                await ensureCp();
+                const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
+                console.log(JSON.stringify(result, null, 2));
+            });
+        }, { descriptors: [{ name: "overlay", description: "BSV Overlay Network management" }] });
+    }
+};
+export default plugin;
 async function executeOverlayAction(params, config, api) {
     await ensureCp();
     const { action } = params;
@@ -452,7 +464,7 @@ async function handleFulfill(params, env, cliPath) {
     return parseCliOutput(res.stdout).data;
 }
 function buildEnvironment(config) {
-    const env = { ...process['en' + 'v'] };
+    const env = { ...process['env'] };
     env.BSV_WALLET_DIR = config.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
     env.OVERLAY_URL = config.overlayUrl || 'https://clawoverlay.com';
     env.BSV_NETWORK = env.BSV_NETWORK || 'mainnet';

package/dist/src/compatibility.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Compatibility Test for Node 24 and OpenClaw SDK
+ */
+export {};

package/dist/src/compatibility.test.js

@@ -0,0 +1,52 @@
+/**
+ * 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)
+    let registeredCli = false;
+    let hasDescriptors = false;
+    const mockApi = {
+        logger: { info: () => { }, warn: () => { }, error: () => { } },
+        registerTool: () => { },
+        registerCommand: () => { },
+        registerService: () => { },
+        registerCli: (fn, options) => {
+            registeredCli = true;
+            if (options && options.descriptors && options.descriptors[0].name === 'overlay') {
+                hasDescriptors = true;
+            }
+        },
+        getConfig: () => ({ plugins: { entries: {} } })
+    };
+    try {
+        plugin.register(mockApi);
+        if (registeredCli && hasDescriptors) {
+            console.log('✓ CLI descriptors registered correctly for Phase 1 discovery.');
+        }
+        else {
+            throw new Error(`CLI registration missing or using old 'commands' array format.`);
+        }
+    }
+    catch (err) {
+        console.error('✗ Plugin registration failed:', err.message);
+        process.exit(1);
+    }
+    console.log('--- All Compatibility Tests Passed ---\n');
+}
+testCompatibility().catch(err => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/src/scripts/baemail/commands.d.ts

@@ -1,63 +1,34 @@
-/**
- * Baemail commands - paid message forwarding service.
- */
-export interface BaemailConfig {
-    deliveryChannel: string;
-    tiers: {
-        standard: number;
-        priority: number;
-        urgent: number;
-    };
-    maxMessageLength: number;
-    blocklist: string[];
-    createdAt: string;
-    updatedAt: string;
-}
 export interface BaemailLogEntry {
     requestId: string;
     from: string;
-    senderName: string;
-    tier: string;
+    to?: string;
     paidSats: number;
-    messageLength: number;
-    deliveryChannel: string;
     deliverySuccess: boolean;
-    deliveryError: string | null;
-    paymentTxid: string;
-    refundStatus: string | null;
+    refundStatus?: 'pending' | 'completed';
     refundTxid?: string;
-    refundedAt?: string;
-    timestamp: string;
     _lineIdx?: number;
+    ts?: number;
+    senderName?: string;
+    messageLength?: number;
+    tier?: string;
+    deliveryChannel?: string;
+    deliveryError?: string | null;
+    paymentTxid?: string;
+    timestamp?: string;
 }
 /**
- * Load baemail configuration.
- */
-export declare function loadBaemailConfig(): BaemailConfig | null;
-/**
- * Save baemail configuration.
- */
-export declare function saveBaemailConfig(config: BaemailConfig): void;
-/**
- * Setup baemail service with delivery channel and tier pricing.
+ * Log a baemail delivery event.
  */
-export declare function cmdBaemailSetup(channel: string | undefined, standardStr: string | undefined, priorityStr?: string, urgentStr?: string): Promise<never>;
+export declare function logBaemailDelivery(entry: BaemailLogEntry): void;
+export declare function loadBaemailConfig(): Promise<any>;
 /**
- * View current baemail configuration.
- */
-export declare function cmdBaemailConfig(): Promise<never>;
-/**
- * Block a sender from using baemail.
- */
-export declare function cmdBaemailBlock(identityKey: string | undefined): Promise<never>;
-/**
- * Unblock a sender.
- */
-export declare function cmdBaemailUnblock(identityKey: string | undefined): Promise<never>;
-/**
- * View baemail delivery log.
+ * List recent baemail deliveries.
  */
 export declare function cmdBaemailLog(limitStr?: string): Promise<never>;
+export declare function cmdBaemailSetup(priceSatsStr: string, prioritySats?: string, urgentSats?: string, channel?: string): Promise<never>;
+export declare function cmdBaemailConfig(): Promise<never>;
+export declare function cmdBaemailBlock(pubkey: string): Promise<never>;
+export declare function cmdBaemailUnblock(pubkey: string): Promise<never>;
 /**
  * Refund a failed baemail delivery.
  */