openclaw-overlay-plugin 0.8.14 → 0.8.16

package/dist/src/scripts/services/request.js

@@ -1,82 +0,0 @@
-/**
- * Service request command.
- */
-import { OVERLAY_URL } from '../config.js';
-import { ok, fail } from '../output.js';
-import { loadIdentity, signRelayMessage } from '../wallet/identity.js';
-import { buildDirectPayment } from '../payment/build.js';
-/**
- * Request service command: send a service request with optional payment.
- */
-export async function cmdRequestService(targetKey, serviceId, satsStr, inputJsonStr) {
-    if (!targetKey || !serviceId) {
-        return fail('Usage: request-service <identityKey> <serviceId> [sats] [inputJson]');
-    }
-    if (!/^0[23][0-9a-fA-F]{64}$/.test(targetKey)) {
-        return fail('Target must be a compressed public key (66 hex chars, 02/03 prefix)');
-    }
-    const { identityKey, privKey } = await loadIdentity();
-    const sats = parseInt(satsStr || '5', 10);
-    // Parse optional input JSON
-    let inputData = null;
-    if (inputJsonStr) {
-        try {
-            inputData = JSON.parse(inputJsonStr);
-        }
-        catch {
-            return fail('inputJson must be valid JSON');
-        }
-    }
-    // Build the service request payload
-    let paymentData = null;
-    if (sats > 0) {
-        try {
-            const payment = await buildDirectPayment(targetKey, sats, `service-request: ${serviceId}`);
-            paymentData = {
-                beef: payment.beef,
-                txid: payment.txid,
-                satoshis: payment.satoshis,
-                derivationPrefix: payment.derivationPrefix,
-                derivationSuffix: payment.derivationSuffix,
-                senderIdentityKey: payment.senderIdentityKey,
-            };
-        }
-        catch (err) {
-            // Payment failed — send request without payment
-            paymentData = { error: String(err.message || err) };
-        }
-    }
-    const requestPayload = {
-        serviceId,
-        ...(inputData ? { input: inputData } : {}),
-        payment: paymentData,
-        requestedAt: new Date().toISOString(),
-    };
-    const signature = await signRelayMessage(privKey, targetKey, 'service-request', requestPayload);
-    const resp = await fetch(`${OVERLAY_URL}/relay/send`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-            from: identityKey,
-            to: targetKey,
-            type: 'service-request',
-            payload: requestPayload,
-            signature,
-        }),
-    });
-    if (!resp.ok) {
-        const body = await resp.text();
-        return fail(`Relay send failed (${resp.status}): ${body}`);
-    }
-    const result = await resp.json();
-    return ok({
-        sent: true,
-        requestId: result.id,
-        to: targetKey,
-        serviceId,
-        paymentIncluded: paymentData && !paymentData.error,
-        paymentTxid: paymentData?.txid || null,
-        satoshis: paymentData?.satoshis || 0,
-        note: 'Poll for service-response to get the result',
-    });
-}

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

@@ -1,11 +0,0 @@
-/**
- * Service response commands.
- */
-/**
- * Respond to a service request.
- */
-export declare function cmdRespondService(requestId: string | undefined, recipientKey: string | undefined, serviceId: string | undefined, resultJson: string | undefined): Promise<any>;
-/**
- * Respond to a research request with results.
- */
-export declare function cmdResearchRespond(resultJsonPath: string | undefined): Promise<any>;

package/dist/src/scripts/services/respond.js

@@ -1,132 +0,0 @@
-/**
- * Service response commands.
- */
-import fs from 'node:fs';
-import { OVERLAY_URL, PATHS } from '../config.js';
-import { ok, fail } from '../output.js';
-import { loadIdentity, signRelayMessage } from '../wallet/identity.js';
-import { updateServiceQueueStatus } from '../utils/storage.js';
-/**
- * Respond to a service request.
- */
-export async function cmdRespondService(requestId, recipientKey, serviceId, resultJson) {
-    if (!requestId || !recipientKey || !serviceId || !resultJson) {
-        return fail('Usage: respond-service <requestId> <recipientKey> <serviceId> <resultJson>');
-    }
-    let result;
-    try {
-        result = JSON.parse(resultJson);
-    }
-    catch {
-        return fail('resultJson must be valid JSON');
-    }
-    const { identityKey, privKey } = await loadIdentity();
-    // Check if already processed before sending response (idempotency)
-    if (fs.existsSync(PATHS.serviceQueue)) {
-        const lines = fs.readFileSync(PATHS.serviceQueue, 'utf-8').trim().split('\n').filter(Boolean);
-        const finalStatuses = ['fulfilled', 'rejected', 'delivery_failed', 'failed', 'error'];
-        for (const line of lines) {
-            try {
-                const entry = JSON.parse(line);
-                if (entry.requestId === requestId && finalStatuses.includes(entry.status)) {
-                    return ok({
-                        sent: false,
-                        requestId,
-                        serviceId,
-                        to: recipientKey,
-                        message: `Request already processed with status: ${entry.status}`,
-                        alreadyProcessed: true,
-                        previousStatus: entry.status
-                    });
-                }
-            }
-            catch { }
-        }
-    }
-    const responsePayload = {
-        requestId,
-        serviceId,
-        status: 'fulfilled',
-        result,
-    };
-    const sig = await signRelayMessage(privKey, recipientKey, 'service-response', responsePayload);
-    const resp = await fetch(`${OVERLAY_URL}/relay/send`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-            from: identityKey,
-            to: recipientKey,
-            type: 'service-response',
-            payload: responsePayload,
-            signature: sig,
-        }),
-    });
-    if (!resp.ok) {
-        // Mark as failed in queue using atomic update
-        updateServiceQueueStatus(requestId, 'failed', {
-            failedAt: Date.now(),
-            error: `Relay send failed: ${resp.status}`
-        });
-        return fail(`Relay send failed: ${resp.status}`);
-    }
-    // Mark as fulfilled in queue using atomic update
-    updateServiceQueueStatus(requestId, 'fulfilled', {
-        fulfilledAt: Date.now()
-    });
-    return ok({ sent: true, requestId, serviceId, to: recipientKey });
-}
-/**
- * Respond to a research request with results.
- */
-export async function cmdResearchRespond(resultJsonPath) {
-    if (!resultJsonPath)
-        return fail('Usage: research-respond <resultJsonFile>');
-    if (!fs.existsSync(resultJsonPath))
-        return fail(`File not found: ${resultJsonPath}`);
-    const result = JSON.parse(fs.readFileSync(resultJsonPath, 'utf-8'));
-    const { requestId, from: recipientKey, query, research } = result;
-    if (!requestId || !recipientKey || !research) {
-        return fail('Result JSON must have: requestId, from, query, research');
-    }
-    const { identityKey, privKey } = await loadIdentity();
-    const responsePayload = {
-        requestId,
-        serviceId: 'web-research',
-        status: 'fulfilled',
-        result: research,
-        paymentAccepted: true,
-        paymentTxid: result.paymentTxid || null,
-        satoshisReceived: result.satoshisReceived || 0,
-        walletAccepted: result.walletAccepted ?? true,
-    };
-    const sig = await signRelayMessage(privKey, recipientKey, 'service-response', responsePayload);
-    const sendResp = await fetch(`${OVERLAY_URL}/relay/send`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify({
-            from: identityKey,
-            to: recipientKey,
-            type: 'service-response',
-            payload: responsePayload,
-            signature: sig,
-        }),
-    });
-    if (!sendResp.ok) {
-        return fail(`Failed to send response: ${await sendResp.text()}`);
-    }
-    const sendResult = await sendResp.json();
-    // Remove from queue
-    if (fs.existsSync(PATHS.researchQueue)) {
-        const lines = fs.readFileSync(PATHS.researchQueue, 'utf-8').trim().split('\n').filter(Boolean);
-        const remaining = lines.filter((l) => {
-            try {
-                return JSON.parse(l).requestId !== requestId;
-            }
-            catch {
-                return true;
-            }
-        });
-        fs.writeFileSync(PATHS.researchQueue, remaining.length ? remaining.join('\n') + '\n' : '');
-    }
-    return ok({ responded: true, requestId, to: recipientKey, query, pushed: sendResult.pushed });
-}

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

@@ -1,107 +0,0 @@
-/**
- * Shared TypeScript interfaces for the overlay CLI.
- */
-export interface WalletIdentity {
-    rootKeyHex: string;
-    identityKey: string;
-    network: 'mainnet' | 'testnet';
-}
-export interface PaymentResult {
-    beef: string;
-    txid: string;
-    satoshis: number;
-    derivationPrefix: string;
-    derivationSuffix: string;
-    senderIdentityKey: string;
-}
-export interface PaymentParams {
-    to: string;
-    satoshis: number;
-    description?: string;
-}
-export interface ServiceAdvertisement {
-    serviceId: string;
-    name: string;
-    description: string;
-    priceSats: number;
-    txid?: string;
-    registeredAt?: string;
-}
-export interface Message {
-    id: string;
-    from: string;
-    to: string;
-    type: string;
-    payload: unknown;
-    signature?: string;
-    timestamp?: number;
-}
-export interface CommandResult<T = unknown> {
-    success: boolean;
-    data?: T;
-    error?: string;
-}
-export interface Registration {
-    identityKey: string;
-    agentName: string;
-    agentDescription: string;
-    overlayUrl: string;
-    identityTxid: string;
-    serviceTxid: string | null;
-    funded: string;
-    registeredAt: string;
-}
-export interface OverlayPayload {
-    protocol: string;
-    type: string;
-    identityKey?: string;
-    [key: string]: unknown;
-}
-export interface VerifyAndAcceptResult {
-    accepted: boolean;
-    txid: string | null;
-    satoshis: number;
-    outputIndex: number;
-    walletAccepted: boolean;
-    error: string | null;
-}
-export interface ProcessMessageResult {
-    id: string;
-    type: string;
-    action: string;
-    from: string;
-    ack: boolean;
-    [key: string]: unknown;
-}
-export interface RelayMessage {
-    id: string;
-    from: string;
-    to: string;
-    type: string;
-    payload: Record<string, unknown>;
-    signature?: string;
-}
-export interface XVerification {
-    identityKey: string;
-    xHandle: string;
-    xUserId: string;
-    tweetId: string;
-    tweetUrl: string;
-    signature: string;
-    verifiedAt: string;
-    txid?: string | null;
-}
-export interface StoredChange {
-    txHex: string;
-    txid: string;
-    vout: number;
-    satoshis: number;
-    sourceChain?: SourceChainEntry[];
-    savedAt: string;
-}
-export interface SourceChainEntry {
-    txHex: string;
-    txid: string;
-    merklePathHex?: string;
-    blockHeight?: number;
-}

package/dist/src/scripts/types.js

@@ -1,4 +0,0 @@
-/**
- * Shared TypeScript interfaces for the overlay CLI.
- */
-export {};

package/dist/src/scripts/utils/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Utility module exports.
- */
-export * from './woc.js';
-export * from './storage.js';
-export * from './merkle.js';

package/dist/src/scripts/utils/index.js

@@ -1,6 +0,0 @@
-/**
- * Utility module exports.
- */
-export * from './woc.js';
-export * from './storage.js';
-export * from './merkle.js';

package/dist/src/scripts/utils/merkle.d.ts

@@ -1,12 +0,0 @@
-/**
- * Merkle path utilities for SPV proofs.
- */
-import type { MerklePath as MerklePathType } from '@bsv/sdk';
-/**
- * Build a MerklePath from TSC (Transaction Status Check) proof data.
- * @param txid - Transaction ID
- * @param txIndex - Transaction's index in the block
- * @param nodes - Array of sibling hashes (or '*' for duplicate)
- * @param blockHeight - Block height
- */
-export declare function buildMerklePathFromTSC(txid: string, txIndex: number, nodes: string[], blockHeight: number): Promise<MerklePathType>;

package/dist/src/scripts/utils/merkle.js

@@ -1,47 +0,0 @@
-/**
- * Merkle path utilities for SPV proofs.
- */
-// We'll import MerklePath dynamically to avoid issues with ESM resolution
-let _MerklePath = null;
-async function getMerklePath() {
-    if (_MerklePath)
-        return _MerklePath;
-    const sdk = await import('@bsv/sdk');
-    _MerklePath = sdk.MerklePath;
-    return _MerklePath;
-}
-/**
- * Build a MerklePath from TSC (Transaction Status Check) proof data.
- * @param txid - Transaction ID
- * @param txIndex - Transaction's index in the block
- * @param nodes - Array of sibling hashes (or '*' for duplicate)
- * @param blockHeight - Block height
- */
-export async function buildMerklePathFromTSC(txid, txIndex, nodes, blockHeight) {
-    const MerklePath = await getMerklePath();
-    const treeHeight = nodes.length;
-    const mpPath = [];
-    // Level 0
-    const level0 = [
-        { offset: txIndex, hash: txid, txid: true }
-    ];
-    if (nodes[0] === '*') {
-        level0.push({ offset: txIndex ^ 1, duplicate: true });
-    }
-    else {
-        level0.push({ offset: txIndex ^ 1, hash: nodes[0] });
-    }
-    level0.sort((a, b) => a.offset - b.offset);
-    mpPath.push(level0);
-    // Higher levels
-    for (let i = 1; i < treeHeight; i++) {
-        const siblingOffset = (txIndex >> i) ^ 1;
-        if (nodes[i] === '*') {
-            mpPath.push([{ offset: siblingOffset, duplicate: true }]);
-        }
-        else {
-            mpPath.push([{ offset: siblingOffset, hash: nodes[i] }]);
-        }
-    }
-    return new MerklePath(blockHeight, mpPath);
-}

package/dist/src/scripts/utils/storage.d.ts

@@ -1,66 +0,0 @@
-/**
- * File-based storage helpers for registration, services, and queues.
- */
-import type { Registration, ServiceAdvertisement, XVerification, StoredChange } from '../types.js';
-/**
- * Ensure the overlay state directory exists.
- */
-export declare function ensureStateDir(): void;
-/**
- * Load registration data from disk.
- */
-export declare function loadRegistration(): Registration | null;
-/**
- * Save registration data to disk.
- */
-export declare function saveRegistration(data: Registration): void;
-/**
- * Delete registration file.
- */
-export declare function deleteRegistration(): void;
-/**
- * Load services list from disk.
- */
-export declare function loadServices(): ServiceAdvertisement[];
-/**
- * Save services list to disk.
- */
-export declare function saveServices(services: ServiceAdvertisement[]): void;
-/**
- * Load X verifications from disk.
- */
-export declare function loadXVerifications(): XVerification[];
-/**
- * Save X verifications to disk.
- */
-export declare function saveXVerifications(verifications: XVerification[]): void;
-/**
- * Append a line to a JSONL file.
- */
-export declare function appendToJsonl(filePath: string, entry: Record<string, unknown>): void;
-/**
- * Read and parse a JSONL file.
- */
-export declare function readJsonl<T>(filePath: string): T[];
-/**
- * Load stored change BEEF data.
- */
-export declare function loadStoredChange(): StoredChange | null;
-/**
- * Save stored change BEEF data.
- */
-export declare function saveStoredChange(data: StoredChange): void;
-/**
- * Delete stored change file.
- */
-export declare function deleteStoredChange(): void;
-/**
- * Clean up old entries from service queue.
- * Removes entries older than maxAgeMs or entries with final statuses older than finalStatusMaxAgeMs.
- */
-export declare function cleanupServiceQueue(maxAgeMs?: number, finalStatusMaxAgeMs?: number): void;
-/**
- * Atomically update a service queue entry status.
- * Returns true if the entry was found and updated, false otherwise.
- */
-export declare function updateServiceQueueStatus(requestId: string, newStatus: string, additionalFields?: Record<string, any>): boolean;

package/dist/src/scripts/utils/storage.js

@@ -1,211 +0,0 @@
-/**
- * File-based storage helpers for registration, services, and queues.
- */
-import fs from 'node:fs';
-import { OVERLAY_STATE_DIR, PATHS } from '../config.js';
-/**
- * Ensure the overlay state directory exists.
- */
-export function ensureStateDir() {
-    fs.mkdirSync(OVERLAY_STATE_DIR, { recursive: true });
-}
-/**
- * Load registration data from disk.
- */
-export function loadRegistration() {
-    try {
-        if (fs.existsSync(PATHS.registration)) {
-            return JSON.parse(fs.readFileSync(PATHS.registration, 'utf-8'));
-        }
-    }
-    catch {
-        // Ignore parse errors
-    }
-    return null;
-}
-/**
- * Save registration data to disk.
- */
-export function saveRegistration(data) {
-    ensureStateDir();
-    fs.writeFileSync(PATHS.registration, JSON.stringify(data, null, 2), 'utf-8');
-}
-/**
- * Delete registration file.
- */
-export function deleteRegistration() {
-    try {
-        fs.unlinkSync(PATHS.registration);
-    }
-    catch {
-        // Ignore if file doesn't exist
-    }
-}
-/**
- * Load services list from disk.
- */
-export function loadServices() {
-    try {
-        if (fs.existsSync(PATHS.services)) {
-            return JSON.parse(fs.readFileSync(PATHS.services, 'utf-8'));
-        }
-    }
-    catch {
-        // Ignore parse errors
-    }
-    return [];
-}
-/**
- * Save services list to disk.
- */
-export function saveServices(services) {
-    ensureStateDir();
-    fs.writeFileSync(PATHS.services, JSON.stringify(services, null, 2), 'utf-8');
-}
-/**
- * Load X verifications from disk.
- */
-export function loadXVerifications() {
-    try {
-        if (fs.existsSync(PATHS.xVerifications)) {
-            return JSON.parse(fs.readFileSync(PATHS.xVerifications, 'utf-8'));
-        }
-    }
-    catch {
-        // Ignore parse errors
-    }
-    return [];
-}
-/**
- * Save X verifications to disk.
- */
-export function saveXVerifications(verifications) {
-    ensureStateDir();
-    fs.writeFileSync(PATHS.xVerifications, JSON.stringify(verifications, null, 2), 'utf-8');
-}
-/**
- * Append a line to a JSONL file.
- */
-export function appendToJsonl(filePath, entry) {
-    ensureStateDir();
-    fs.appendFileSync(filePath, JSON.stringify(entry) + '\n');
-}
-/**
- * Read and parse a JSONL file.
- */
-export function readJsonl(filePath) {
-    if (!fs.existsSync(filePath))
-        return [];
-    const lines = fs.readFileSync(filePath, 'utf-8').trim().split('\n').filter(Boolean);
-    return lines.map((line) => {
-        try {
-            return JSON.parse(line);
-        }
-        catch {
-            return null;
-        }
-    }).filter(Boolean);
-}
-/**
- * Load stored change BEEF data.
- */
-export function loadStoredChange() {
-    try {
-        if (fs.existsSync(PATHS.latestChange)) {
-            return JSON.parse(fs.readFileSync(PATHS.latestChange, 'utf-8'));
-        }
-    }
-    catch {
-        // Ignore parse errors
-    }
-    return null;
-}
-/**
- * Save stored change BEEF data.
- */
-export function saveStoredChange(data) {
-    ensureStateDir();
-    fs.writeFileSync(PATHS.latestChange, JSON.stringify(data));
-}
-/**
- * Delete stored change file.
- */
-export function deleteStoredChange() {
-    try {
-        fs.unlinkSync(PATHS.latestChange);
-    }
-    catch {
-        // Ignore if file doesn't exist
-    }
-}
-/**
- * Clean up old entries from service queue.
- * Removes entries older than maxAgeMs or entries with final statuses older than finalStatusMaxAgeMs.
- */
-export function cleanupServiceQueue(maxAgeMs = 24 * 60 * 60 * 1000, finalStatusMaxAgeMs = 2 * 60 * 60 * 1000) {
-    if (!fs.existsSync(PATHS.serviceQueue))
-        return;
-    const now = Date.now();
-    const finalStatuses = ['fulfilled', 'rejected', 'delivery_failed', 'failed', 'error'];
-    const lines = fs.readFileSync(PATHS.serviceQueue, 'utf-8').trim().split('\n').filter(Boolean);
-    const keptLines = [];
-    let removedCount = 0;
-    for (const line of lines) {
-        try {
-            const entry = JSON.parse(line);
-            const entryAge = now - (entry._ts || 0);
-            // Always keep pending entries that aren't too old
-            if (entry.status === 'pending' && entryAge < maxAgeMs) {
-                keptLines.push(line);
-                continue;
-            }
-            // Keep final status entries only if they're recent
-            if (finalStatuses.includes(entry.status) && entryAge < finalStatusMaxAgeMs) {
-                keptLines.push(line);
-                continue;
-            }
-            // Remove this entry
-            removedCount++;
-        }
-        catch {
-            // Keep malformed entries to avoid data loss
-            keptLines.push(line);
-        }
-    }
-    if (removedCount > 0) {
-        fs.writeFileSync(PATHS.serviceQueue, keptLines.join('\n') + (keptLines.length ? '\n' : ''));
-        console.error(JSON.stringify({ event: 'queue-cleanup', removed: removedCount, kept: keptLines.length }));
-    }
-}
-/**
- * Atomically update a service queue entry status.
- * Returns true if the entry was found and updated, false otherwise.
- */
-export function updateServiceQueueStatus(requestId, newStatus, additionalFields = {}) {
-    if (!fs.existsSync(PATHS.serviceQueue))
-        return false;
-    const lines = fs.readFileSync(PATHS.serviceQueue, 'utf-8').trim().split('\n').filter(Boolean);
-    let updated = false;
-    const updatedLines = lines.map(line => {
-        try {
-            const entry = JSON.parse(line);
-            if (entry.requestId === requestId) {
-                updated = true;
-                return JSON.stringify({
-                    ...entry,
-                    status: newStatus,
-                    ...additionalFields,
-                    updatedAt: Date.now()
-                });
-            }
-            return line;
-        }
-        catch {
-            return line;
-        }
-    });
-    if (updated) {
-        fs.writeFileSync(PATHS.serviceQueue, updatedLines.join('\n') + '\n');
-    }
-    return updated;
-}