@nevermined-io/openclaw-plugin 1.0.12 → 1.0.14

package/dist/paid-endpoint.js

@@ -0,0 +1,142 @@
+import { buildPaymentRequired } from '@nevermined-io/payments';
+/**
+ * Registers a paid HTTP endpoint on the OpenClaw gateway.
+ * The endpoint handles x402 payment verification, processes requests,
+ * and settles credits after successful processing.
+ */
+export function registerPaidEndpoint(api, getPayments, config, agentHandler) {
+    const path = config.agentEndpointPath ?? '/nevermined/agent';
+    const handler = agentHandler ?? mockWeatherHandler;
+    const routeHandler = async (req, res) => {
+        // 1. Extract payment signature
+        const accessToken = getHeader(req.headers, 'payment-signature') ??
+            getHeader(req.headers, 'PAYMENT-SIGNATURE');
+        if (!accessToken) {
+            res.writeHead(402, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Payment required — missing payment-signature header' }));
+            return;
+        }
+        // 2. Build payment required descriptor
+        const planId = config.planId;
+        if (!planId) {
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Server misconfigured — planId not set' }));
+            return;
+        }
+        const paymentRequired = buildPaymentRequired(planId, {
+            endpoint: path,
+            agentId: config.agentId,
+            httpVerb: 'POST',
+        });
+        const maxAmount = BigInt(config.creditsPerRequest ?? 1);
+        // 3. Verify permissions (check credits without burning)
+        try {
+            const verification = await getPayments().facilitator.verifyPermissions({
+                paymentRequired,
+                x402AccessToken: accessToken,
+                maxAmount,
+            });
+            if (!verification.isValid) {
+                res.writeHead(402, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    error: 'Insufficient credits — order the plan first',
+                    details: verification,
+                }));
+                return;
+            }
+        }
+        catch (err) {
+            res.writeHead(402, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                error: 'Payment verification failed',
+                message: err instanceof Error ? err.message : String(err),
+            }));
+            return;
+        }
+        // 4. Parse request body and process
+        const body = await parseBody(req);
+        const prompt = typeof body === 'object' && body !== null && 'prompt' in body
+            ? body.prompt
+            : String(body);
+        let result;
+        try {
+            result = await handler({ prompt });
+        }
+        catch (err) {
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({
+                error: 'Agent processing failed',
+                message: err instanceof Error ? err.message : String(err),
+            }));
+            return;
+        }
+        // 5. Settle permissions (burn credits)
+        let settlement;
+        try {
+            settlement = await getPayments().facilitator.settlePermissions({
+                paymentRequired,
+                x402AccessToken: accessToken,
+                maxAmount,
+            });
+        }
+        catch (err) {
+            // Log settlement failure but still return the result — the agent already processed
+            api.logger.warn(`Credit settlement failed: ${err instanceof Error ? err.message : String(err)}`);
+            settlement = { error: 'settlement_failed' };
+        }
+        // 6. Return response with payment-response header
+        const paymentResponse = Buffer.from(JSON.stringify(settlement)).toString('base64');
+        res.writeHead(200, {
+            'Content-Type': 'application/json',
+            'payment-response': paymentResponse,
+        });
+        res.end(JSON.stringify(result));
+    };
+    api.registerHttpRoute({ path, handler: routeHandler });
+    api.logger.info(`Registered paid endpoint at ${path}`);
+}
+/**
+ * Mock weather forecast handler for demonstration purposes.
+ * Returns simulated weather data based on the prompt.
+ */
+export async function mockWeatherHandler(body) {
+    const city = extractCity(body.prompt) ?? 'Unknown';
+    return {
+        city,
+        forecast: 'Partly cloudy with a chance of innovation',
+        temperature: Math.floor(Math.random() * 30) + 5,
+        unit: 'celsius',
+        humidity: Math.floor(Math.random() * 60) + 30,
+        source: 'Weather Oracle (Nevermined demo)',
+    };
+}
+function extractCity(prompt) {
+    // Simple heuristic: look for "in <City>" or "for <City>" patterns
+    // Use word boundary to avoid matching partial words
+    // Use a lookbehind for word boundary + space to avoid matching "at" inside "What"
+    const match = prompt.match(/(?:^|\s)(?:in|for|at)\s+([A-Z][a-zA-Z\s]{1,30}?)(?:\?|$|\.|\s*,)/);
+    return match ? match[1].trim() : undefined;
+}
+function getHeader(headers, name) {
+    const value = headers[name] ?? headers[name.toLowerCase()];
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(Buffer.from(chunk)));
+        req.on('end', () => {
+            const raw = Buffer.concat(chunks).toString('utf-8');
+            try {
+                resolve(raw ? JSON.parse(raw) : {});
+            }
+            catch {
+                resolve(raw);
+            }
+        });
+        req.on('error', reject);
+    });
+}
+//# sourceMappingURL=paid-endpoint.js.map

package/dist/paid-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paid-endpoint.js","sourceRoot":"","sources":["../src/paid-endpoint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AAM9D;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAsB,EACtB,WAA2B,EAC3B,MAA8B,EAC9B,YAA2B;IAE3B,MAAM,IAAI,GAAG,MAAM,CAAC,iBAAiB,IAAI,mBAAmB,CAAA;IAC5D,MAAM,OAAO,GAAG,YAAY,IAAI,kBAAkB,CAAA;IAElD,MAAM,YAAY,GAAqB,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACxD,+BAA+B;QAC/B,MAAM,WAAW,GACf,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC;YAC3C,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAA;QAE7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;YAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC,CAAC,CAAA;YACzF,OAAM;QACR,CAAC;QAED,uCAAuC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;YAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAAC,CAAA;YAC3E,OAAM;QACR,CAAC;QAED,MAAM,eAAe,GAAG,oBAAoB,CAAC,MAAM,EAAE;YACnD,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;QAEF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAA;QAEvD,wDAAwD;QACxD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,WAAW,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC;gBACrE,eAAe;gBACf,eAAe,EAAE,WAAW;gBAC5B,SAAS;aACV,CAAC,CAAA;YAEF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;gBAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;oBACrB,KAAK,EAAE,6CAA6C;oBACpD,OAAO,EAAE,YAAY;iBACtB,CAAC,CAAC,CAAA;gBACH,OAAM;YACR,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;YAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrB,KAAK,EAAE,6BAA6B;gBACpC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC,CAAA;YACH,OAAM;QACR,CAAC;QAED,oCAAoC;QACpC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,IAAI,IAAI;YAC1E,CAAC,CAAE,IAA2B,CAAC,MAAM;YACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAEhB,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAA;YAC1D,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACrB,KAAK,EAAE,yBAAyB;gBAChC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC,CAAA;YACH,OAAM;QACR,CAAC;QAED,uCAAuC;QACvC,IAAI,UAAmB,CAAA;QACvB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,WAAW,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC;gBAC7D,eAAe;gBACf,eAAe,EAAE,WAAW;gBAC5B,SAAS;aACV,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,mFAAmF;YACnF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAChG,UAAU,GAAG,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAA;QAC7C,CAAC;QAED,kDAAkD;QAClD,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAClF,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,kBAAkB;YAClC,kBAAkB,EAAE,eAAe;SACpC,CAAC,CAAA;QACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,CAAC,CAAA;IAED,GAAG,CAAC,iBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAA;IACvD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,EAAE,CAAC,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAwB;IAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAA;IAClD,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,2CAA2C;QACrD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;QAC/C,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE;QAC7C,MAAM,EAAE,kCAAkC;KAC3C,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,kEAAkE;IAClE,oDAAoD;IACpD,kFAAkF;IAClF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,kEAAkE,CAAC,CAAA;IAC9F,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;AAC5C,CAAC;AASD,SAAS,SAAS,CAAC,OAAsD,EAAE,IAAY;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAA;IACzC,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,SAAS,CAAC,GAAoB;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAmB,CAAC,CAAC,CAAC,CAAA;QACjF,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YACnD,IAAI,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,CAAA;YACd,CAAC;QACH,CAAC,CAAC,CAAA;QACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools.d.ts

@@ -1,16 +1,23 @@
 import type { Payments } from '@nevermined-io/payments';
 import type { NeverminedPluginConfig } from './config.js';
-export interface ToolParam {
+/**
+ * Creates all Nevermined payment tools for the OpenClaw plugin.
+ * Each tool is an object with { name, description, parameters, execute }
+ * compatible with the OpenClaw AnyAgentTool interface.
+ */
+export declare function createTools(getPayments: () => Payments, config: NeverminedPluginConfig): ToolObject[];
+interface ToolObject {
     name: string;
-    type: string;
+    label: string;
     description: string;
-    required: boolean;
+    parameters: Record<string, unknown>;
+    execute: (_id: string, params: Record<string, unknown>) => Promise<ToolResult>;
 }
-export interface ToolDefinition {
-    name: string;
-    description: string;
-    params: ToolParam[];
-    handler: (payments: Payments, config: NeverminedPluginConfig, params: Record<string, unknown>) => Promise<unknown>;
+interface ToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
 }
-export declare const allTools: ToolDefinition[];
+export {};
 //# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,OAAO,EAAE,CACP,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAA;CACtB;AAqPD,eAAO,MAAM,QAAQ,EAAE,cAAc,EAUpC,CAAA"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAIzD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,QAAQ,EAC3B,MAAM,EAAE,sBAAsB,GAC7B,UAAU,EAAE,CAqQd;AAID,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CAC/E;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/C"}

package/dist/tools.js

@@ -1,218 +1,256 @@
-function requireParam(params, name) {
-    const value = params[name];
-    if (value === undefined || value === null || value === '') {
-        throw new Error(`Missing required parameter: ${name}`);
-    }
-    return String(value);
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+/**
+ * Creates all Nevermined payment tools for the OpenClaw plugin.
+ * Each tool is an object with { name, description, parameters, execute }
+ * compatible with the OpenClaw AnyAgentTool interface.
+ */
+export function createTools(getPayments, config) {
+    return [
+        // --- Subscriber tools ---
+        {
+            name: 'nevermined_checkBalance',
+            label: 'Nevermined Check Balance',
+            description: 'Check the credit balance for a Nevermined payment plan',
+            parameters: {
+                type: 'object',
+                properties: {
+                    planId: { type: 'string', description: 'The payment plan ID (uses config default if omitted)' },
+                },
+            },
+            async execute(_id, params) {
+                const planId = str(params, 'planId') ?? config.planId;
+                if (!planId)
+                    throw new Error('planId is required — provide it as a parameter or in the plugin config');
+                const balance = await getPayments().plans.getPlanBalance(planId);
+                return result({
+                    planId: balance.planId,
+                    planName: balance.planName,
+                    balance: balance.balance.toString(),
+                    isSubscriber: balance.isSubscriber,
+                });
+            },
+        },
+        {
+            name: 'nevermined_getAccessToken',
+            label: 'Nevermined Get Access Token',
+            description: 'Get an x402 access token for authenticating requests to a Nevermined agent',
+            parameters: {
+                type: 'object',
+                properties: {
+                    planId: { type: 'string', description: 'The payment plan ID' },
+                    agentId: { type: 'string', description: 'The agent ID' },
+                },
+            },
+            async execute(_id, params) {
+                const planId = str(params, 'planId') ?? config.planId;
+                if (!planId)
+                    throw new Error('planId is required — provide it as a parameter or in the plugin config');
+                const agentId = str(params, 'agentId') ?? config.agentId;
+                const token = await getPayments().x402.getX402AccessToken(planId, agentId);
+                return result({ accessToken: token.accessToken });
+            },
+        },
+        {
+            name: 'nevermined_orderPlan',
+            label: 'Nevermined Order Plan',
+            description: 'Order (purchase) a Nevermined payment plan',
+            parameters: {
+                type: 'object',
+                properties: {
+                    planId: { type: 'string', description: 'The payment plan ID to order' },
+                },
+            },
+            async execute(_id, params) {
+                const planId = str(params, 'planId') ?? config.planId;
+                if (!planId)
+                    throw new Error('planId is required — provide it as a parameter or in the plugin config');
+                const res = await getPayments().plans.orderPlan(planId);
+                return result(res);
+            },
+        },
+        {
+            name: 'nevermined_queryAgent',
+            label: 'Nevermined Query Agent',
+            description: 'Query a Nevermined AI agent end-to-end: acquires an x402 access token, sends the prompt to the agent, and returns the response',
+            parameters: {
+                type: 'object',
+                properties: {
+                    agentUrl: { type: 'string', description: 'The URL of the agent to query' },
+                    prompt: { type: 'string', description: 'The prompt to send to the agent' },
+                    planId: { type: 'string', description: 'The payment plan ID' },
+                    agentId: { type: 'string', description: 'The agent ID' },
+                    method: { type: 'string', description: 'HTTP method (default: POST)' },
+                },
+                required: ['agentUrl', 'prompt'],
+            },
+            async execute(_id, params) {
+                const agentUrl = requireStr(params, 'agentUrl');
+                const prompt = requireStr(params, 'prompt');
+                const planId = str(params, 'planId') ?? config.planId;
+                if (!planId)
+                    throw new Error('planId is required — provide it as a parameter or in the plugin config');
+                const agentId = str(params, 'agentId') ?? config.agentId;
+                const method = str(params, 'method') ?? 'POST';
+                const { accessToken } = await getPayments().x402.getX402AccessToken(planId, agentId);
+                const response = await fetch(agentUrl, {
+                    method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'PAYMENT-SIGNATURE': accessToken,
+                    },
+                    body: method !== 'GET' ? JSON.stringify({ prompt }) : undefined,
+                });
+                if (response.status === 402) {
+                    return result({
+                        error: 'Payment required — insufficient credits. Order the plan first using nevermined_orderPlan.',
+                        status: 402,
+                    });
+                }
+                if (!response.ok) {
+                    return result({
+                        error: `Agent returned HTTP ${response.status}: ${response.statusText}`,
+                        status: response.status,
+                    });
+                }
+                const body = await response.json();
+                return result(body);
+            },
+        },
+        // --- Builder tools ---
+        {
+            name: 'nevermined_registerAgent',
+            label: 'Nevermined Register Agent',
+            description: 'Register a new AI agent with an associated payment plan on Nevermined',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Agent name' },
+                    description: { type: 'string', description: 'Agent description' },
+                    agentUrl: { type: 'string', description: 'The endpoint URL for the agent' },
+                    planName: { type: 'string', description: 'Name for the payment plan' },
+                    priceAmounts: { type: 'string', description: 'Comma-separated price amounts in wei' },
+                    priceReceivers: { type: 'string', description: 'Comma-separated receiver addresses' },
+                    creditsAmount: { type: 'number', description: 'Number of credits in the plan' },
+                    tokenAddress: { type: 'string', description: 'ERC20 token address (e.g. USDC). Omit for native token.' },
+                },
+                required: ['name', 'agentUrl', 'planName', 'priceAmounts', 'priceReceivers', 'creditsAmount'],
+            },
+            async execute(_id, params) {
+                const name = requireStr(params, 'name');
+                const description = str(params, 'description') ?? '';
+                const agentUrl = requireStr(params, 'agentUrl');
+                const planName = requireStr(params, 'planName');
+                const priceAmounts = requireStr(params, 'priceAmounts')
+                    .split(',')
+                    .map((s) => BigInt(s.trim()));
+                const priceReceivers = requireStr(params, 'priceReceivers')
+                    .split(',')
+                    .map((s) => s.trim());
+                const creditsAmount = Number(requireStr(params, 'creditsAmount'));
+                const tokenAddress = str(params, 'tokenAddress');
+                const priceConfig = {
+                    amounts: priceAmounts,
+                    receivers: priceReceivers,
+                    isCrypto: true,
+                    tokenAddress: tokenAddress ?? ZERO_ADDRESS,
+                    contractAddress: ZERO_ADDRESS,
+                    feeController: ZERO_ADDRESS,
+                    externalPriceAddress: ZERO_ADDRESS,
+                    templateAddress: ZERO_ADDRESS,
+                };
+                const res = await getPayments().agents.registerAgentAndPlan({ name, description }, { endpoints: [{ POST: agentUrl }], agentDefinitionUrl: agentUrl }, { name: planName }, priceConfig, {
+                    isRedemptionAmountFixed: true,
+                    redemptionType: 4,
+                    proofRequired: false,
+                    durationSecs: 0n,
+                    amount: BigInt(creditsAmount),
+                    minAmount: 1n,
+                    maxAmount: BigInt(creditsAmount),
+                });
+                return result({ agentId: res.agentId, planId: res.planId, txHash: res.txHash });
+            },
+        },
+        {
+            name: 'nevermined_createPlan',
+            label: 'Nevermined Create Plan',
+            description: 'Create a new payment plan on Nevermined',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Plan name' },
+                    description: { type: 'string', description: 'Plan description' },
+                    priceAmounts: { type: 'string', description: 'Comma-separated price amounts in wei' },
+                    priceReceivers: { type: 'string', description: 'Comma-separated receiver addresses' },
+                    creditsAmount: { type: 'number', description: 'Number of credits in the plan' },
+                    accessLimit: { type: 'string', description: '"credits" or "time" (default: credits)' },
+                    tokenAddress: { type: 'string', description: 'ERC20 token address (e.g. USDC). Omit for native token.' },
+                },
+                required: ['name', 'priceAmounts', 'priceReceivers', 'creditsAmount'],
+            },
+            async execute(_id, params) {
+                const name = requireStr(params, 'name');
+                const description = str(params, 'description') ?? '';
+                const priceAmounts = requireStr(params, 'priceAmounts')
+                    .split(',')
+                    .map((s) => BigInt(s.trim()));
+                const priceReceivers = requireStr(params, 'priceReceivers')
+                    .split(',')
+                    .map((s) => s.trim());
+                const creditsAmount = Number(requireStr(params, 'creditsAmount'));
+                const accessLimit = (str(params, 'accessLimit') ?? 'credits');
+                const tokenAddress = str(params, 'tokenAddress');
+                const priceConfig = {
+                    amounts: priceAmounts,
+                    receivers: priceReceivers,
+                    isCrypto: true,
+                    tokenAddress: tokenAddress ?? ZERO_ADDRESS,
+                    contractAddress: ZERO_ADDRESS,
+                    feeController: ZERO_ADDRESS,
+                    externalPriceAddress: ZERO_ADDRESS,
+                    templateAddress: ZERO_ADDRESS,
+                };
+                const res = await getPayments().plans.registerPlan({ name, description, accessLimit }, priceConfig, {
+                    isRedemptionAmountFixed: true,
+                    redemptionType: 4,
+                    proofRequired: false,
+                    durationSecs: 0n,
+                    amount: BigInt(creditsAmount),
+                    minAmount: 1n,
+                    maxAmount: BigInt(creditsAmount),
+                }, undefined, accessLimit);
+                return result({ planId: res.planId });
+            },
+        },
+        {
+            name: 'nevermined_listPlans',
+            label: 'Nevermined List Plans',
+            description: "List the builder's payment plans on Nevermined",
+            parameters: {
+                type: 'object',
+                properties: {},
+            },
+            async execute() {
+                const res = await getPayments().plans.getPlans();
+                return result(res);
+            },
+        },
+    ];
 }
-function optionalParam(params, name, fallback) {
-    const value = params[name];
-    if (value === undefined || value === null || value === '') {
-        return fallback;
-    }
-    return String(value);
+function result(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    };
+}
+function str(params, key) {
+    const v = params[key];
+    if (v === undefined || v === null || v === '')
+        return undefined;
+    return String(v);
+}
+function requireStr(params, key) {
+    const v = str(params, key);
+    if (!v)
+        throw new Error(`Missing required parameter: ${key}`);
+    return v;
 }
-// --- Subscriber tools ---
-const checkBalance = {
-    name: 'nevermined.checkBalance',
-    description: 'Check the credit balance for a Nevermined payment plan',
-    params: [
-        { name: 'planId', type: 'string', description: 'The payment plan ID', required: false },
-    ],
-    handler: async (payments, config, params) => {
-        const planId = optionalParam(params, 'planId', config.planId);
-        if (!planId) {
-            throw new Error('planId is required — provide it as a parameter or in the plugin config');
-        }
-        const balance = await payments.plans.getPlanBalance(planId);
-        return {
-            planId: balance.planId,
-            planName: balance.planName,
-            balance: balance.balance.toString(),
-            isSubscriber: balance.isSubscriber,
-        };
-    },
-};
-const getAccessToken = {
-    name: 'nevermined.getAccessToken',
-    description: 'Get an x402 access token for authenticating requests to a Nevermined agent',
-    params: [
-        { name: 'planId', type: 'string', description: 'The payment plan ID', required: false },
-        { name: 'agentId', type: 'string', description: 'The agent ID', required: false },
-    ],
-    handler: async (payments, config, params) => {
-        const planId = optionalParam(params, 'planId', config.planId);
-        if (!planId) {
-            throw new Error('planId is required — provide it as a parameter or in the plugin config');
-        }
-        const agentId = optionalParam(params, 'agentId', config.agentId);
-        const result = await payments.x402.getX402AccessToken(planId, agentId);
-        return { accessToken: result.accessToken };
-    },
-};
-const orderPlan = {
-    name: 'nevermined.orderPlan',
-    description: 'Order (purchase) a Nevermined payment plan',
-    params: [
-        { name: 'planId', type: 'string', description: 'The payment plan ID to order', required: false },
-    ],
-    handler: async (payments, config, params) => {
-        const planId = optionalParam(params, 'planId', config.planId);
-        if (!planId) {
-            throw new Error('planId is required — provide it as a parameter or in the plugin config');
-        }
-        const result = await payments.plans.orderPlan(planId);
-        return result;
-    },
-};
-const queryAgent = {
-    name: 'nevermined.queryAgent',
-    description: 'Query a Nevermined AI agent end-to-end: acquires an x402 access token, sends the prompt to the agent, and returns the response',
-    params: [
-        { name: 'agentUrl', type: 'string', description: 'The URL of the agent to query', required: true },
-        { name: 'prompt', type: 'string', description: 'The prompt to send to the agent', required: true },
-        { name: 'planId', type: 'string', description: 'The payment plan ID', required: false },
-        { name: 'agentId', type: 'string', description: 'The agent ID', required: false },
-        { name: 'method', type: 'string', description: 'HTTP method (default: POST)', required: false },
-    ],
-    handler: async (payments, config, params) => {
-        const agentUrl = requireParam(params, 'agentUrl');
-        const prompt = requireParam(params, 'prompt');
-        const planId = optionalParam(params, 'planId', config.planId);
-        if (!planId) {
-            throw new Error('planId is required — provide it as a parameter or in the plugin config');
-        }
-        const agentId = optionalParam(params, 'agentId', config.agentId);
-        const method = optionalParam(params, 'method', 'POST') ?? 'POST';
-        const { accessToken } = await payments.x402.getX402AccessToken(planId, agentId);
-        const response = await fetch(agentUrl, {
-            method,
-            headers: {
-                'Content-Type': 'application/json',
-                'PAYMENT-SIGNATURE': accessToken,
-            },
-            body: method !== 'GET' ? JSON.stringify({ prompt }) : undefined,
-        });
-        if (response.status === 402) {
-            return {
-                error: 'Payment required — insufficient credits. Order the plan first using nevermined.orderPlan.',
-                status: 402,
-            };
-        }
-        if (!response.ok) {
-            return {
-                error: `Agent returned HTTP ${response.status}: ${response.statusText}`,
-                status: response.status,
-            };
-        }
-        const body = await response.json();
-        return body;
-    },
-};
-// --- Builder tools ---
-const registerAgent = {
-    name: 'nevermined.registerAgent',
-    description: 'Register a new AI agent with an associated payment plan on Nevermined',
-    params: [
-        { name: 'name', type: 'string', description: 'Agent name', required: true },
-        { name: 'description', type: 'string', description: 'Agent description', required: false },
-        { name: 'agentUrl', type: 'string', description: 'The endpoint URL for the agent', required: true },
-        { name: 'planName', type: 'string', description: 'Name for the payment plan', required: true },
-        { name: 'priceAmounts', type: 'string', description: 'Comma-separated price amounts in wei', required: true },
-        { name: 'priceReceivers', type: 'string', description: 'Comma-separated receiver addresses', required: true },
-        { name: 'creditsAmount', type: 'number', description: 'Number of credits in the plan', required: true },
-    ],
-    handler: async (payments, _config, params) => {
-        const name = requireParam(params, 'name');
-        const description = optionalParam(params, 'description', '');
-        const agentUrl = requireParam(params, 'agentUrl');
-        const planName = requireParam(params, 'planName');
-        const priceAmounts = requireParam(params, 'priceAmounts')
-            .split(',')
-            .map((s) => BigInt(s.trim()));
-        const priceReceivers = requireParam(params, 'priceReceivers')
-            .split(',')
-            .map((s) => s.trim());
-        const creditsAmount = Number(requireParam(params, 'creditsAmount'));
-        const result = await payments.agents.registerAgentAndPlan({ name, description }, {
-            endpoints: [{ POST: agentUrl }],
-            agentDefinitionUrl: agentUrl,
-        }, { name: planName }, {
-            amounts: priceAmounts,
-            receivers: priceReceivers,
-            isCrypto: true,
-        }, {
-            isRedemptionAmountFixed: true,
-            redemptionType: 4, // ONLY_SUBSCRIBER
-            proofRequired: false,
-            durationSecs: 0n,
-            amount: BigInt(creditsAmount),
-            minAmount: 1n,
-            maxAmount: BigInt(creditsAmount),
-        });
-        return {
-            agentId: result.agentId,
-            planId: result.planId,
-            txHash: result.txHash,
-        };
-    },
-};
-const createPlan = {
-    name: 'nevermined.createPlan',
-    description: 'Create a new payment plan on Nevermined',
-    params: [
-        { name: 'name', type: 'string', description: 'Plan name', required: true },
-        { name: 'description', type: 'string', description: 'Plan description', required: false },
-        { name: 'priceAmounts', type: 'string', description: 'Comma-separated price amounts in wei', required: true },
-        { name: 'priceReceivers', type: 'string', description: 'Comma-separated receiver addresses', required: true },
-        { name: 'creditsAmount', type: 'number', description: 'Number of credits in the plan', required: true },
-        { name: 'accessLimit', type: 'string', description: '"credits" or "time" (default: credits)', required: false },
-    ],
-    handler: async (payments, _config, params) => {
-        const name = requireParam(params, 'name');
-        const description = optionalParam(params, 'description', '');
-        const priceAmounts = requireParam(params, 'priceAmounts')
-            .split(',')
-            .map((s) => BigInt(s.trim()));
-        const priceReceivers = requireParam(params, 'priceReceivers')
-            .split(',')
-            .map((s) => s.trim());
-        const creditsAmount = Number(requireParam(params, 'creditsAmount'));
-        const accessLimit = optionalParam(params, 'accessLimit', 'credits');
-        const result = await payments.plans.registerPlan({ name, description, accessLimit }, {
-            amounts: priceAmounts,
-            receivers: priceReceivers,
-            isCrypto: true,
-        }, {
-            isRedemptionAmountFixed: true,
-            redemptionType: 4,
-            proofRequired: false,
-            durationSecs: 0n,
-            amount: BigInt(creditsAmount),
-            minAmount: 1n,
-            maxAmount: BigInt(creditsAmount),
-        }, undefined, accessLimit);
-        return { planId: result.planId };
-    },
-};
-const listPlans = {
-    name: 'nevermined.listPlans',
-    description: "List the builder's payment plans on Nevermined",
-    params: [],
-    handler: async (payments) => {
-        const result = await payments.plans.getPlans();
-        return result;
-    },
-};
-export const allTools = [
-    // Subscriber
-    checkBalance,
-    getAccessToken,
-    orderPlan,
-    queryAgent,
-    // Builder
-    registerAgent,
-    createPlan,
-    listPlans,
-];
 //# sourceMappingURL=tools.js.map