openclaw-overlay-plugin 0.8.4 → 0.8.6

package/dist/index.d.ts

@@ -1,4 +1,3 @@
-export declare function activate(api: any): Promise<void>;
 export declare function register(api: any): void;
 export declare const plugin: {
     id: string;

package/dist/index.js

@@ -1,37 +1,19 @@
-import { promisify } from 'node:util';
 import path from 'node:path';
 import os from 'node:os';
-import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
 import { initializeServiceSystem, serviceManager } from './src/services/index.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const cp_name = 'node:child' + '_' + 'process';
-let execFile_orig;
-let spawn_orig;
-let execFileAsync;
-async function ensureCp() {
-    if (execFileAsync)
-        return;
-    // @ts-ignore
-    if (typeof require !== 'undefined') {
-        // @ts-ignore
-        const cp = require(cp_name);
-        execFile_orig = cp.execFile;
-        spawn_orig = cp.spawn;
-    }
-    else {
-        const cp = await import(cp_name);
-        execFile_orig = cp.execFile;
-        spawn_orig = cp.spawn;
-    }
-    execFileAsync = promisify(execFile_orig);
-}
+// Direct imports of command logic
+import { cmdStatus, cmdSetup, cmdAddress, cmdIdentity } from './src/scripts/wallet/setup.js';
+import { cmdBalance, cmdImport } from './src/scripts/wallet/balance.js';
+import { cmdRegister, cmdUnregister } from './src/scripts/overlay/registration.js';
+import { cmdDiscover } from './src/scripts/overlay/discover.js';
+import { cmdRequestService } from './src/scripts/services/request.js';
+import { cmdServiceQueue } from './src/scripts/services/queue.js';
+import { cmdRespondService } from './src/scripts/services/respond.js';
+import { setNoExit } from './src/scripts/output.js';
 // Track background process for proper lifecycle management
 let backgroundProcess = null;
 let serviceRunning = false;
-// Confirmation tokens for destructive actions — maps token → { action, details, expiresAt }
-const pendingConfirmations = new Map();
 // Auto-import tracking
 let autoImportInterval = null;
 let knownTxids = new Set();
@@ -52,18 +34,10 @@ function loadDailySpending(walletDir) {
             return data;
     }
     catch {
-        // Ignore parse errors - return fresh daily spending for corrupted/missing file
+        // Ignore parse errors
     }
     return { date: today, totalSats: 0, transactions: [] };
 }
-function writeActivityEvent(event) {
-    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');
-    }
-    catch { }
-}
 function recordSpend(walletDir, sats, service, provider) {
     const spending = loadDailySpending(walletDir);
     spending.totalSats += sats;
@@ -79,11 +53,18 @@ function checkBudget(walletDir, requestedSats, dailyLimit) {
         spent: spending.totalSats
     };
 }
-async function startAutoImport(env, cliPath, api) {
-    // Get our address
+function applyConfigToEnv(config) {
+    process['env'].BSV_WALLET_DIR = config.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
+    process['env'].OVERLAY_URL = config.overlayUrl || 'https://clawoverlay.com';
+    process['env'].BSV_NETWORK = config.network || process['env'].BSV_NETWORK || 'mainnet';
+    process['env'].BSV_ARC_URL = config.arcUrl || (process['env'].BSV_NETWORK === 'testnet' ? 'https://testnet.arc.gorillapool.io' : 'https://arc.gorillapool.io');
+    process['env'].AGENT_NAME = config.agentName || 'openclaw-agent';
+    setNoExit(true);
+}
+async function startAutoImport(config, api) {
     try {
-        const addrResult = await execFileAsync('node', [cliPath, 'address'], { env });
-        const addrOutput = parseCliOutput(addrResult.stdout);
+        applyConfigToEnv(config);
+        const addrOutput = await cmdAddress();
         if (!addrOutput.success)
             return;
         const address = addrOutput.data?.address;
@@ -91,7 +72,7 @@ async function startAutoImport(env, cliPath, api) {
             return;
         autoImportInterval = setInterval(async () => {
             try {
-                const network = env.BSV_NETWORK === 'testnet' ? 'test' : 'main';
+                const network = process['env'].BSV_NETWORK === 'testnet' ? 'test' : 'main';
                 const controller = new AbortController();
                 const timeout = setTimeout(() => controller.abort(), 15000);
                 const resp = await fetch(`https://api.whatsonchain.com/v1/bsv/${network}/address/${address}/unspent/all`, { signal: controller.signal });
@@ -105,34 +86,26 @@ async function startAutoImport(env, cliPath, api) {
                     if (knownTxids.has(key))
                         continue;
                     if (utxo.value < 200)
-                        continue; // skip dust
+                        continue;
                     api.logger?.info?.(`[openclaw-overlay] Auto-importing UTXO: ${utxo.tx_hash}:${utxo.tx_pos} (${utxo.value} sats)`);
                     try {
-                        const importResult = await execFileAsync('node', [cliPath, 'import', utxo.tx_hash, String(utxo.tx_pos)], { env });
-                        const importOutput = parseCliOutput(importResult.stdout);
+                        applyConfigToEnv(config);
+                        const importOutput = await cmdImport(utxo.tx_hash, String(utxo.tx_pos));
                         if (importOutput.success) {
                             knownTxids.add(key);
                             api.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['env'].HOME || '', '.openclaw', 'openclaw-overlay', 'onboarding-sent.flag');
-                                if (fs.existsSync(onboardingSentFile)) {
-                                    fs.unlinkSync(onboardingSentFile);
-                                }
-                            }
-                            catch { }
                             // Notify agent of successful import
                             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.`, api.logger, { sessionKey: 'hook:openclaw-overlay:import' });
                             // Check if registered, auto-register if not
                             try {
-                                const regPath = path.join(process['env'].HOME || '', '.openclaw', 'openclaw-overlay', 'registration.json');
+                                const regPath = path.join(os.homedir(), '.openclaw', 'openclaw-overlay', 'registration.json');
                                 if (!fs.existsSync(regPath)) {
                                     api.logger?.info?.('[openclaw-overlay] Not yet registered — auto-registering...');
-                                    const regResult = await execFileAsync('node', [cliPath, 'register'], { env, timeout: 60000 });
-                                    const regOutput = parseCliOutput(regResult.stdout);
+                                    applyConfigToEnv(config);
+                                    const regOutput = await cmdRegister();
                                     if (regOutput.success) {
                                         api.logger?.info?.('[openclaw-overlay] Auto-registered on overlay network!');
-                                        await autoAdvertiseServices(env, cliPath, api.logger);
+                                        await autoAdvertiseServices(config, api.logger);
                                     }
                                 }
                             }
@@ -155,26 +128,12 @@ async function startAutoImport(env, cliPath, api) {
         api.logger?.warn?.('[openclaw-overlay] Auto-import setup failed:', err.message);
     }
 }
-function stopAutoImport() {
-    if (autoImportInterval) {
-        clearInterval(autoImportInterval);
-        autoImportInterval = null;
-    }
-}
-async function autoAdvertiseServices(env, cliPath, logger) {
+async function autoAdvertiseServices(config, logger) {
     try {
-        const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
-        if (!fs.existsSync(configPath))
-            return;
         let servicesToAdvertise = [];
-        try {
-            const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-            const pluginConfig = config?.plugins?.entries?.['openclaw-overlay-plugin']?.config || config?.plugins?.entries?.['openclaw-overlay-plugin'];
-            if (pluginConfig?.services && Array.isArray(pluginConfig.services)) {
-                servicesToAdvertise = pluginConfig.services;
-            }
+        if (config?.services && Array.isArray(config.services)) {
+            servicesToAdvertise = config.services;
         }
-        catch { }
         if (servicesToAdvertise.length === 0)
             return;
         for (const serviceId of servicesToAdvertise) {
@@ -182,9 +141,9 @@ async function autoAdvertiseServices(env, cliPath, logger) {
             if (!serviceInfo)
                 continue;
             try {
-                await execFileAsync('node', [
-                    cliPath, 'advertise', serviceId, serviceInfo.name, serviceInfo.description, String(serviceInfo.defaultPrice)
-                ], { env, timeout: 60000 });
+                const { cmdAdvertise } = await import('./src/scripts/overlay/services.js');
+                applyConfigToEnv(config);
+                await cmdAdvertise(serviceId, serviceInfo.name, String(serviceInfo.defaultPrice), serviceInfo.description);
             }
             catch { }
         }
@@ -196,7 +155,7 @@ async function autoAdvertiseServices(env, cliPath, logger) {
 function wakeAgent(text, logger, options = {}) {
     const sessionKey = options.sessionKey || `hook:openclaw-overlay:${Date.now()}`;
     const gatewayPort = process['env'].OPENCLAW_GATEWAY_PORT || '18789';
-    const httpToken = getHooksToken();
+    const httpToken = process['env'].OPENCLAW_HOOKS_TOKEN || null;
     if (!httpToken)
         return;
     fetch(`http://localhost:${gatewayPort}/hooks/agent`, {
@@ -205,31 +164,7 @@ function wakeAgent(text, logger, options = {}) {
         body: JSON.stringify({ prompt: text, sessionKey })
     }).catch(() => { });
 }
-function getHooksToken() {
-    let token = process['env'].OPENCLAW_HOOKS_TOKEN || null;
-    if (!token) {
-        try {
-            const configPath = path.join(os.homedir(), '.openclaw', 'openclaw.json');
-            if (fs.existsSync(configPath)) {
-                const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                token = config.gateway?.hooksToken || null;
-            }
-        }
-        catch { }
-    }
-    return token;
-}
-function categorizeEvent(event) {
-    const base = { ts: Date.now(), from: event.from?.slice(0, 16), fullFrom: event.from };
-    if (event.action === 'queued-for-agent' && event.satoshisReceived) {
-        return { ...base, type: 'incoming_payment', emoji: '💰', serviceId: event.serviceId, sats: event.satoshisReceived, requestId: event.id, message: `Received ${event.satoshisReceived} sats for ${event.serviceId}` };
-    }
-    if (event.type === 'service-response' && event.action === 'received') {
-        return { ...base, type: 'response_received', emoji: '📬', serviceId: event.serviceId, status: event.status, result: event.result, requestId: event.requestId, message: event.formatted || `Response received for ${event.serviceId}: ${event.status}` };
-    }
-    return null;
-}
-function startBackgroundService(env, cliPath, api) {
+function startBackgroundService(config, api) {
     if (backgroundProcess)
         return;
     serviceRunning = true;
@@ -237,10 +172,17 @@ function startBackgroundService(env, cliPath, api) {
         if (serviceRunning)
             wokenRequests.clear();
     }, 5 * 60 * 1000);
-    function spawnConnect() {
+    async function spawnConnect() {
         if (!serviceRunning)
             return;
-        const proc = spawn_orig('node', [cliPath, 'connect'], { env, stdio: ['ignore', 'pipe', 'pipe'] });
+        const { spawn } = await import('node:child_process');
+        const base = __dirname.endsWith('dist') ? __dirname : path.join(__dirname, 'dist');
+        const cliPath = path.join(base, 'src', 'cli.js');
+        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 = config.network || env.BSV_NETWORK || 'mainnet';
+        const proc = spawn('node', [cliPath, 'connect'], { env, stdio: ['ignore', 'pipe', 'pipe'] });
         backgroundProcess = proc;
         proc.stdout?.on('data', (data) => {
             const lines = data.toString().split('\n').filter(Boolean);
@@ -259,17 +201,11 @@ function startBackgroundService(env, cliPath, api) {
                         const wakeText = `📬 Overlay service response received!\n\nService: ${event.serviceId}\nFrom: ${event.from}\nStatus: ${event.status}\n\nFull result:\n${JSON.stringify(event.result, null, 2)}`;
                         wakeAgent(wakeText, api.logger, { sessionKey: `hook:openclaw-overlay:resp-${event.requestId || Date.now()}` });
                     }
-                    const notif = categorizeEvent(event);
-                    if (notif) {
-                        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');
-                    }
                 }
                 catch { }
             }
         });
-        proc.on('exit', (code) => {
+        proc.on('exit', () => {
             backgroundProcess = null;
             if (serviceRunning)
                 setTimeout(spawnConnect, 5000);
@@ -288,20 +224,12 @@ function stopBackgroundService() {
         requestCleanupInterval = null;
     }
     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');
+    if (autoImportInterval) {
+        clearInterval(autoImportInterval);
+        autoImportInterval = null;
+    }
 }
 export 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 || {}) };
@@ -353,37 +281,86 @@ export function register(api) {
     api.registerService({
         id: "openclaw-overlay-relay",
         start: async () => {
-            await ensureCp();
-            // Initialize service system
             try {
                 await initializeServiceSystem();
             }
-            catch (err) {
-                if (api.logger)
-                    api.logger.warn(`[overlay] Service system initialization failed: ${err.message}`);
-            }
-            const env = buildEnvironment(pluginConfig);
-            const cliPath = getCliPath();
-            startBackgroundService(env, cliPath, api);
-            startAutoImport(env, cliPath, api);
+            catch { }
+            startBackgroundService(pluginConfig, api);
+            startAutoImport(pluginConfig, api);
         },
         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("status").description("Show identity and balance").action(async () => {
+            applyConfigToEnv(pluginConfig);
+            const res = await cmdStatus();
+            console.log(JSON.stringify(res.data, null, 2));
+        });
+        overlay.command("balance").description("Show current wallet balance").action(async () => {
+            applyConfigToEnv(pluginConfig);
+            const res = await cmdBalance();
+            console.log(JSON.stringify(res.data, null, 2));
         });
-        overlay.command("balance").action(async () => {
-            await ensureCp();
-            const result = await handleBalance(buildEnvironment(pluginConfig), getCliPath());
-            console.log(JSON.stringify(result, null, 2));
+        overlay.command("discover").description("Find agents and services").option("-s, --service <type>", "Filter by service type").option("-a, --agent <name>", "Filter by agent name").action(async (options) => {
+            applyConfigToEnv(pluginConfig);
+            const args = [];
+            if (options.service)
+                args.push('--service', options.service);
+            if (options.agent)
+                args.push('--agent', options.agent);
+            const res = await cmdDiscover(args);
+            console.log(JSON.stringify(res.data, null, 2));
         });
     }, { commands: ["overlay"] });
 }
+async function executeOverlayAction(params, config, api) {
+    const { action } = params;
+    applyConfigToEnv(config);
+    switch (action) {
+        case "request": {
+            const { service, input } = params;
+            const walletDir = config?.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
+            const discoverOutput = await cmdDiscover(['--service', service]);
+            const providers = discoverOutput.data.services;
+            if (!providers || providers.length === 0)
+                throw new Error(`No providers found for ${service}`);
+            providers.sort((a, b) => (a.pricing?.amountSats || 0) - (b.pricing?.amountSats || 0));
+            const best = providers[0];
+            const price = best.pricing?.amountSats || 0;
+            const budget = checkBudget(walletDir, price, config.dailyBudgetSats || 5000);
+            if (!budget.allowed)
+                throw new Error("Budget exceeded");
+            const output = await cmdRequestService(best.identityKey, service, price.toString(), input ? JSON.stringify(input) : undefined);
+            recordSpend(walletDir, price, service, best.name);
+            return { status: "sent", requestId: output.data?.messageId, message: `Request sent to ${best.name} for ${price} sats.` };
+        }
+        case "discover": return (await cmdDiscover(params.service ? ['--service', params.service] : [])).data;
+        case "balance": return (await cmdBalance()).data;
+        case "status": {
+            const identity = await cmdIdentity();
+            const balance = await cmdBalance();
+            return { identity: identity.data, balance: balance.data };
+        }
+        case "onboard": {
+            await cmdSetup();
+            const addr = (await cmdAddress()).data.address;
+            const bal = (await cmdBalance()).data.walletBalance;
+            if (bal < 1000)
+                return { funded: false, address: addr, message: "Please fund 1000 sats." };
+            await cmdRegister();
+            return { funded: true, registered: true, message: "Onboarding complete." };
+        }
+        case "pending-requests": return (await cmdServiceQueue()).data;
+        case "fulfill": {
+            const { requestId, recipientKey, serviceId, result } = params;
+            return (await cmdRespondService(requestId, recipientKey, serviceId, JSON.stringify(result))).data;
+        }
+        case "unregister": return (await cmdUnregister()).data;
+        default: throw new Error(`Unknown action: ${action}`);
+    }
+}
 export const plugin = {
     id: "openclaw-overlay-plugin",
     name: "BSV Overlay Network",
@@ -392,93 +369,3 @@ export const plugin = {
     register: register
 };
 export default register;
-async function executeOverlayAction(params, config, api) {
-    await ensureCp();
-    const { action } = params;
-    const env = buildEnvironment(config);
-    const cliPath = getCliPath();
-    switch (action) {
-        case "request": return await handleServiceRequest(params, env, cliPath, config, api);
-        case "discover": return await handleDiscover(params, env, cliPath);
-        case "balance": return await handleBalance(env, cliPath);
-        case "status": return await handleStatus(env, cliPath);
-        case "onboard": return await handleOnboard(params, env, cliPath);
-        case "pending-requests": return await handlePendingRequests(env, cliPath);
-        case "fulfill": return await handleFulfill(params, env, cliPath);
-        default: throw new Error(`Unknown action: ${action}`);
-    }
-}
-async function handleServiceRequest(params, env, cliPath, config, api) {
-    const { service, identityKey: targetKey, input } = params;
-    const walletDir = config?.walletDir || path.join(os.homedir(), '.openclaw', 'bsv-wallet');
-    const discoverResult = await execFileAsync('node', [cliPath, 'discover', '--service', service], { env });
-    const discoverOutput = parseCliOutput(discoverResult.stdout);
-    const providers = discoverOutput.data.services;
-    if (!providers || providers.length === 0)
-        throw new Error(`No providers found for ${service}`);
-    providers.sort((a, b) => (a.pricing?.amountSats || 0) - (b.pricing?.amountSats || 0));
-    const best = providers[0];
-    const price = best.pricing?.amountSats || 0;
-    const budget = checkBudget(walletDir, price, config.dailyBudgetSats || 5000);
-    if (!budget.allowed)
-        throw new Error("Budget exceeded");
-    const requestArgs = [cliPath, 'request-service', best.identityKey, service, price.toString()];
-    if (input)
-        requestArgs.push(JSON.stringify(input));
-    const res = await execFileAsync('node', requestArgs, { env });
-    const output = parseCliOutput(res.stdout);
-    recordSpend(walletDir, price, service, best.name);
-    return { status: "sent", requestId: output.data?.messageId, message: `Request sent to ${best.name} for ${price} sats.` };
-}
-async function handleDiscover(params, env, cliPath) {
-    const args = [cliPath, 'discover'];
-    if (params.service)
-        args.push('--service', params.service);
-    const result = await execFileAsync('node', args, { env });
-    return parseCliOutput(result.stdout).data;
-}
-async function handleBalance(env, cliPath) {
-    const result = await execFileAsync('node', [cliPath, 'balance'], { env });
-    return parseCliOutput(result.stdout).data;
-}
-async function handleStatus(env, cliPath) {
-    const identity = parseCliOutput((await execFileAsync('node', [cliPath, 'identity'], { env })).stdout);
-    const balance = parseCliOutput((await execFileAsync('node', [cliPath, 'balance'], { env })).stdout);
-    return { identity: identity.data, balance: balance.data };
-}
-async function handleOnboard(params, env, cliPath) {
-    await execFileAsync('node', [cliPath, 'setup'], { env });
-    const addr = parseCliOutput((await execFileAsync('node', [cliPath, 'address'], { env })).stdout).data.address;
-    const bal = parseCliOutput((await execFileAsync('node', [cliPath, 'balance'], { env })).stdout).data.walletBalance;
-    if (bal < 1000)
-        return { funded: false, address: addr, message: "Please fund 1000 sats." };
-    await execFileAsync('node', [cliPath, 'register'], { env });
-    return { funded: true, registered: true, message: "Onboarding complete." };
-}
-async function handlePendingRequests(env, cliPath) {
-    const result = await execFileAsync('node', [cliPath, 'service-queue'], { env });
-    return parseCliOutput(result.stdout).data;
-}
-async function handleFulfill(params, env, cliPath) {
-    const { requestId, recipientKey, serviceId, result } = params;
-    const res = await execFileAsync('node', [cliPath, 'respond-service', requestId, recipientKey, serviceId, JSON.stringify(result)], { env });
-    return parseCliOutput(res.stdout).data;
-}
-function buildEnvironment(config) {
-    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 = config.network || env.BSV_NETWORK || 'mainnet';
-    env.BSV_ARC_URL = config.arcUrl || (env.BSV_NETWORK === 'testnet' ? 'https://testnet.arc.gorillapool.io' : 'https://arc.gorillapool.io');
-    env.AGENT_NAME = config.agentName || 'openclaw-agent';
-    return env;
-}
-function parseCliOutput(stdout) {
-    try {
-        const str = typeof stdout === 'string' ? stdout : String(stdout || '');
-        return JSON.parse(str.trim());
-    }
-    catch (error) {
-        throw new Error(`Failed to parse CLI output: ${error.message}`);
-    }
-}

package/dist/src/cli.js

@@ -8,7 +8,7 @@
 // Must be set before any imports that might load dotenv
 process['en' + 'v'].DOTENV_CONFIG_QUIET = 'true';
 // Dynamic import to ensure env var is set first
-import('./cli-main.js');
+await import('./cli-main.js');
 // Before importing the library
 globalThis.window = { fetch: globalThis.fetch };
 export {};

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

@@ -24,12 +24,12 @@ export declare function loadBaemailConfig(): Promise<any>;
 /**
  * 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>;
+export declare function cmdBaemailLog(limitStr?: string): Promise<any>;
+export declare function cmdBaemailSetup(priceSatsStr: string, prioritySats?: string, urgentSats?: string, channel?: string): Promise<any>;
+export declare function cmdBaemailConfig(): Promise<any>;
+export declare function cmdBaemailBlock(pubkey: string): Promise<any>;
+export declare function cmdBaemailUnblock(pubkey: string): Promise<any>;
 /**
  * Refund a failed baemail delivery.
  */
-export declare function cmdBaemailRefund(requestId: string | undefined): Promise<never>;
+export declare function cmdBaemailRefund(requestId: string | undefined): Promise<any>;

package/dist/src/scripts/messaging/inbox.d.ts

@@ -4,8 +4,8 @@
 /**
  * Inbox command: fetch pending messages.
  */
-export declare function cmdInbox(args: string[]): Promise<never>;
+export declare function cmdInbox(args: string[]): Promise<any>;
 /**
  * Ack command: acknowledge processed messages.
  */
-export declare function cmdAck(messageIds: string[]): Promise<never>;
+export declare function cmdAck(messageIds: string[]): Promise<any>;

package/dist/src/scripts/messaging/poll.d.ts

@@ -4,4 +4,4 @@
 /**
  * Poll command: fetch all pending messages and process them.
  */
-export declare function cmdPoll(): Promise<never>;
+export declare function cmdPoll(): Promise<any>;

package/dist/src/scripts/messaging/send.d.ts

@@ -4,4 +4,4 @@
 /**
  * Send command: send a typed message to another agent.
  */
-export declare function cmdSend(targetKey: string | undefined, type: string | undefined, payloadStr: string | undefined): Promise<never>;
+export declare function cmdSend(targetKey: string | undefined, type: string | undefined, payloadStr: string | undefined): Promise<any>;

package/dist/src/scripts/output.d.ts

@@ -2,11 +2,12 @@
  * JSON output helpers for CLI commands.
  * All CLI output follows the { success, data/error } wrapper format.
  */
+export declare function setNoExit(value: boolean): void;
 /**
- * Output a successful result and exit.
+ * Output a successful result and exit (unless noExit is set).
  */
-export declare function ok<T>(data: T): never;
+export declare function ok<T>(data: T): any;
 /**
- * Output an error and exit.
+ * Output an error and exit (unless noExit is set).
  */
-export declare function fail(error: string | Error): never;
+export declare function fail(error: string | Error): any;

package/dist/src/scripts/output.js

@@ -2,18 +2,27 @@
  * JSON output helpers for CLI commands.
  * All CLI output follows the { success, data/error } wrapper format.
  */
+// Global flag to prevent exit when used as a library
+let noExitFlag = false;
+export function setNoExit(value) {
+    noExitFlag = value;
+}
 /**
- * Output a successful result and exit.
+ * Output a successful result and exit (unless noExit is set).
  */
 export function ok(data) {
+    if (noExitFlag)
+        return { success: true, data };
     console.log(JSON.stringify({ success: true, data }));
     process.exit(0);
 }
 /**
- * Output an error and exit.
+ * Output an error and exit (unless noExit is set).
  */
 export function fail(error) {
     const message = error instanceof Error ? error.message : String(error);
+    if (noExitFlag)
+        return { success: false, error: message };
     console.log(JSON.stringify({ success: false, error: message }));
     process.exit(1);
 }

package/dist/src/scripts/overlay/advertisement.d.ts

@@ -8,9 +8,9 @@
  * Advertise a SHIP record.
  * Announce that you host a specific Topic Manager (tm_).
  */
-export declare function cmdAdvertiseSHIP(domain?: string, topic?: string): Promise<never>;
+export declare function cmdAdvertiseSHIP(domain?: string, topic?: string): Promise<any>;
 /**
  * Advertise a SLAP record.
  * Announce that you host a specific Lookup Service (ls_).
  */
-export declare function cmdAdvertiseSLAP(domain?: string, service?: string): Promise<never>;
+export declare function cmdAdvertiseSLAP(domain?: string, service?: string): Promise<any>;

package/dist/src/scripts/overlay/discover.d.ts

@@ -4,4 +4,4 @@
 /**
  * Discover command: query the overlay for agents and services.
  */
-export declare function cmdDiscover(args: string[]): Promise<never>;
+export declare function cmdDiscover(args: string[]): Promise<any>;

package/dist/src/scripts/overlay/registration.d.ts

@@ -12,8 +12,8 @@
 /**
  * Register command: register this agent on the overlay network.
  */
-export declare function cmdRegister(): Promise<never>;
+export declare function cmdRegister(): Promise<any>;
 /**
  * Unregister command: submit revocation tx to remove agent from overlay network.
  */
-export declare function cmdUnregister(): Promise<never>;
+export declare function cmdUnregister(): Promise<any>;

package/dist/src/scripts/overlay/services.d.ts

@@ -14,16 +14,16 @@
 /**
  * Services command: list currently advertised services.
  */
-export declare function cmdServices(): Promise<never>;
+export declare function cmdServices(): Promise<any>;
 /**
  * Advertise command: add a new service advertisement.
  */
-export declare function cmdAdvertise(serviceId: string | undefined, name: string | undefined, priceSatsStr: string | undefined, description?: string): Promise<never>;
+export declare function cmdAdvertise(serviceId: string | undefined, name: string | undefined, priceSatsStr: string | undefined, description?: string): Promise<any>;
 /**
  * Remove command: remove a service from local registry.
  */
-export declare function cmdRemove(serviceId: string | undefined): Promise<never>;
+export declare function cmdRemove(serviceId: string | undefined): Promise<any>;
 /**
  * Readvertise command: update an existing service advertisement.
  */
-export declare function cmdReadvertise(serviceId: string | undefined, name?: string, priceSatsStr?: string, description?: string): Promise<never>;
+export declare function cmdReadvertise(serviceId: string | undefined, name?: string, priceSatsStr?: string, description?: string): Promise<any>;