@xpr-agents/openclaw 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * XPR Agents OpenClaw Plugin
+ *
+ * Registers 43 tools for interacting with the XPR Network Trustless Agent Registry:
+ * - 10 Agent Core tools (registration, profile, plugins, trust scores)
+ * - 7 Feedback tools (ratings, disputes, scores)
+ * - 9 Validation tools (validators, validations, challenges)
+ * - 13 Escrow tools (jobs, milestones, disputes, arbitration)
+ * - 4 Indexer tools (search, events, stats, health)
+ */
+import type { PluginApi } from './types';
+export default function xprAgentsPlugin(api: PluginApi): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAEvD,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAgD5D"}

package/dist/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * XPR Agents OpenClaw Plugin
+ *
+ * Registers 43 tools for interacting with the XPR Network Trustless Agent Registry:
+ * - 10 Agent Core tools (registration, profile, plugins, trust scores)
+ * - 7 Feedback tools (ratings, disputes, scores)
+ * - 9 Validation tools (validators, validations, challenges)
+ * - 13 Escrow tools (jobs, milestones, disputes, arbitration)
+ * - 4 Indexer tools (search, events, stats, health)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = xprAgentsPlugin;
+const session_1 = require("./session");
+const agent_1 = require("./tools/agent");
+const feedback_1 = require("./tools/feedback");
+const validation_1 = require("./tools/validation");
+const escrow_1 = require("./tools/escrow");
+const indexer_1 = require("./tools/indexer");
+function xprAgentsPlugin(api) {
+    const rawConfig = api.getConfig();
+    const rpcEndpoint = rawConfig.rpcEndpoint || 'https://tn1.protonnz.com';
+    const hasCredentials = !!process.env.XPR_PRIVATE_KEY && !!process.env.XPR_ACCOUNT;
+    // Create RPC connection and optional session
+    let rpc;
+    let session;
+    if (hasCredentials) {
+        const result = (0, session_1.createSession)({ rpcEndpoint });
+        rpc = result.rpc;
+        session = result.session;
+    }
+    else {
+        rpc = (0, session_1.createReadOnlyRpc)(rpcEndpoint);
+    }
+    const contractsRaw = (rawConfig.contracts || {});
+    const config = {
+        rpc: rpc,
+        session,
+        network: rawConfig.network || 'testnet',
+        rpcEndpoint,
+        indexerUrl: rawConfig.indexerUrl || 'http://localhost:3001',
+        contracts: {
+            agentcore: contractsRaw.agentcore || 'agentcore',
+            agentfeed: contractsRaw.agentfeed || 'agentfeed',
+            agentvalid: contractsRaw.agentvalid || 'agentvalid',
+            agentescrow: contractsRaw.agentescrow || 'agentescrow',
+        },
+        confirmHighRisk: rawConfig.confirmHighRisk !== false,
+        maxTransferAmount: rawConfig.maxTransferAmount || 1000000,
+    };
+    // Register all tool groups
+    (0, agent_1.registerAgentTools)(api, config);
+    (0, feedback_1.registerFeedbackTools)(api, config);
+    (0, validation_1.registerValidationTools)(api, config);
+    (0, escrow_1.registerEscrowTools)(api, config);
+    (0, indexer_1.registerIndexerTools)(api, config);
+    if (!hasCredentials) {
+        console.log('[xpr-agents] Read-only mode: XPR_PRIVATE_KEY and XPR_ACCOUNT not set. Write tools will fail.');
+    }
+    console.log(`[xpr-agents] Plugin loaded: ${config.network} (${rpcEndpoint})`);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAUH,kCAgDC;AAxDD,uCAA6D;AAC7D,yCAAmD;AACnD,+CAAyD;AACzD,mDAA6D;AAC7D,2CAAqD;AACrD,6CAAuD;AAGvD,SAAwB,eAAe,CAAC,GAAc;IACpD,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;IAElC,MAAM,WAAW,GAAI,SAAS,CAAC,WAAsB,IAAI,0BAA0B,CAAC;IACpF,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAElF,6CAA6C;IAC7C,IAAI,GAAG,CAAC;IACR,IAAI,OAAO,CAAC;IAEZ,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAA,uBAAa,EAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QAC9C,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACjB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,IAAA,2BAAiB,EAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAA2B,CAAC;IAE3E,MAAM,MAAM,GAAiB;QAC3B,GAAG,EAAE,GAAU;QACf,OAAO;QACP,OAAO,EAAG,SAAS,CAAC,OAAiC,IAAI,SAAS;QAClE,WAAW;QACX,UAAU,EAAG,SAAS,CAAC,UAAqB,IAAI,uBAAuB;QACvE,SAAS,EAAE;YACT,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,WAAW;YAChD,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,WAAW;YAChD,UAAU,EAAE,YAAY,CAAC,UAAU,IAAI,YAAY;YACnD,WAAW,EAAE,YAAY,CAAC,WAAW,IAAI,aAAa;SACvD;QACD,eAAe,EAAE,SAAS,CAAC,eAAe,KAAK,KAAK;QACpD,iBAAiB,EAAG,SAAS,CAAC,iBAA4B,IAAI,OAAO;KACtE,CAAC;IAEF,2BAA2B;IAC3B,IAAA,0BAAkB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAChC,IAAA,gCAAqB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACnC,IAAA,oCAAuB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,IAAA,4BAAmB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACjC,IAAA,8BAAoB,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAElC,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,8FAA8F,CAAC,CAAC;IAC9G,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,OAAO,KAAK,WAAW,GAAG,CAAC,CAAC;AAChF,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,24 @@
+import { JsonRpc } from '@proton/js';
+import type { ProtonSession } from '@xpr-agents/sdk';
+export interface SessionConfig {
+    rpcEndpoint: string;
+    privateKey?: string;
+    account?: string;
+    permission?: string;
+}
+/**
+ * Create a server-side ProtonSession from environment variables.
+ * Uses @proton/js (no browser dependency).
+ *
+ * Required env vars: XPR_PRIVATE_KEY, XPR_ACCOUNT
+ * Optional: XPR_PERMISSION (defaults to 'active')
+ */
+export declare function createSession(config: SessionConfig): {
+    rpc: JsonRpc;
+    session: ProtonSession;
+};
+/**
+ * Create a read-only RPC connection (no session/signing needed).
+ */
+export declare function createReadOnlyRpc(rpcEndpoint: string): JsonRpc;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,OAAO,EAAuB,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAmC,MAAM,iBAAiB,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CA8B7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/session.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSession = createSession;
+exports.createReadOnlyRpc = createReadOnlyRpc;
+const js_1 = require("@proton/js");
+/**
+ * Create a server-side ProtonSession from environment variables.
+ * Uses @proton/js (no browser dependency).
+ *
+ * Required env vars: XPR_PRIVATE_KEY, XPR_ACCOUNT
+ * Optional: XPR_PERMISSION (defaults to 'active')
+ */
+function createSession(config) {
+    const privateKey = config.privateKey || process.env.XPR_PRIVATE_KEY;
+    const account = config.account || process.env.XPR_ACCOUNT;
+    const permission = config.permission || process.env.XPR_PERMISSION || 'active';
+    if (!privateKey) {
+        throw new Error('XPR_PRIVATE_KEY environment variable is required');
+    }
+    if (!account) {
+        throw new Error('XPR_ACCOUNT environment variable is required');
+    }
+    const rpc = new js_1.JsonRpc(config.rpcEndpoint);
+    const signatureProvider = new js_1.JsSignatureProvider([privateKey]);
+    const api = new js_1.Api({ rpc, signatureProvider });
+    const session = {
+        auth: { actor: account, permission },
+        link: {
+            transact: async (args) => {
+                const result = await api.transact({ actions: args.actions }, { blocksBehind: 3, expireSeconds: 30 });
+                return result;
+            },
+        },
+    };
+    return { rpc, session };
+}
+/**
+ * Create a read-only RPC connection (no session/signing needed).
+ */
+function createReadOnlyRpc(rpcEndpoint) {
+    return new js_1.JsonRpc(rpcEndpoint);
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":";;AAiBA,sCA8BC;AAKD,8CAEC;AAtDD,mCAA+D;AAU/D;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,MAAqB;IACjD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC;IAE/E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,YAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,iBAAiB,GAAG,IAAI,wBAAmB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,MAAM,GAAG,GAAG,IAAI,QAAG,CAAC,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAkB;QAC7B,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE;QACpC,IAAI,EAAE;YACJ,QAAQ,EAAE,KAAK,EAAE,IAAkB,EAA8B,EAAE;gBACjE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,QAAQ,CAC/B,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EACzB,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CACvC,CAAC;gBACF,OAAO,MAAsC,CAAC;YAChD,CAAC;SACF;KACF,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,WAAmB;IACnD,OAAO,IAAI,YAAO,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC"}

package/dist/tools/agent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agent Core tools (10 tools)
+ * Reads: xpr_get_agent, xpr_list_agents, xpr_get_trust_score,
+ *        xpr_get_agent_plugins, xpr_list_plugins, xpr_get_core_config
+ * Writes: xpr_register_agent, xpr_update_agent, xpr_set_agent_status,
+ *         xpr_manage_plugin
+ */
+import type { PluginApi, PluginConfig } from '../types';
+export declare function registerAgentTools(api: PluginApi, config: PluginConfig): void;
+//# sourceMappingURL=agent.d.ts.map

package/dist/tools/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAIxD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0R7E"}

package/dist/tools/agent.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Agent Core tools (10 tools)
+ * Reads: xpr_get_agent, xpr_list_agents, xpr_get_trust_score,
+ *        xpr_get_agent_plugins, xpr_list_plugins, xpr_get_core_config
+ * Writes: xpr_register_agent, xpr_update_agent, xpr_set_agent_status,
+ *         xpr_manage_plugin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentTools = registerAgentTools;
+const sdk_1 = require("@xpr-agents/sdk");
+const validate_1 = require("../util/validate");
+const confirm_1 = require("../util/confirm");
+function registerAgentTools(api, config) {
+    const contracts = config.contracts;
+    // ---- READ TOOLS ----
+    api.registerTool({
+        name: 'xpr_get_agent',
+        description: 'Get detailed information about a registered agent including profile, capabilities, ownership, and job count.',
+        parameters: {
+            type: 'object',
+            required: ['account'],
+            properties: {
+                account: { type: 'string', description: 'Agent account name (1-12 chars, a-z1-5.)' },
+            },
+        },
+        handler: async ({ account }) => {
+            (0, validate_1.validateAccountName)(account);
+            const registry = new sdk_1.AgentRegistry(config.rpc, undefined, contracts.agentcore);
+            const agent = await registry.getAgent(account);
+            if (!agent) {
+                return { error: `Agent '${account}' not found` };
+            }
+            return agent;
+        },
+    });
+    api.registerTool({
+        name: 'xpr_list_agents',
+        description: 'List registered agents with optional filtering by active status. Returns paginated results.',
+        parameters: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max results (default 20, max 100)' },
+                cursor: { type: 'string', description: 'Pagination cursor from previous result' },
+                active_only: { type: 'boolean', description: 'Only show active agents (default true)' },
+            },
+        },
+        handler: async ({ limit = 20, cursor, active_only = true }) => {
+            const registry = new sdk_1.AgentRegistry(config.rpc, undefined, contracts.agentcore);
+            return registry.listAgents({
+                limit: Math.min(limit, 100),
+                cursor,
+                active_only,
+            });
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_trust_score',
+        description: 'Get the trust score breakdown for an agent. Score components: KYC (0-30), Stake (0-20), Reputation (0-40), Longevity (0-10) = max 100.',
+        parameters: {
+            type: 'object',
+            required: ['account'],
+            properties: {
+                account: { type: 'string', description: 'Agent account name' },
+            },
+        },
+        handler: async ({ account }) => {
+            (0, validate_1.validateAccountName)(account);
+            const registry = new sdk_1.AgentRegistry(config.rpc, undefined, contracts.agentcore);
+            const trustScore = await registry.getTrustScore(account);
+            if (!trustScore) {
+                return { error: `Agent '${account}' not found` };
+            }
+            return trustScore;
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_agent_plugins',
+        description: 'Get all plugins installed on an agent.',
+        parameters: {
+            type: 'object',
+            required: ['account'],
+            properties: {
+                account: { type: 'string', description: 'Agent account name' },
+            },
+        },
+        handler: async ({ account }) => {
+            (0, validate_1.validateAccountName)(account);
+            const registry = new sdk_1.AgentRegistry(config.rpc, undefined, contracts.agentcore);
+            return { plugins: await registry.getAgentPlugins(account) };
+        },
+    });
+    api.registerTool({
+        name: 'xpr_list_plugins',
+        description: 'List available plugins in the registry, optionally filtered by category.',
+        parameters: {
+            type: 'object',
+            properties: {
+                category: {
+                    type: 'string',
+                    enum: ['compute', 'storage', 'oracle', 'payment', 'messaging', 'ai'],
+                    description: 'Filter by plugin category',
+                },
+            },
+        },
+        handler: async ({ category }) => {
+            const registry = new sdk_1.AgentRegistry(config.rpc, undefined, contracts.agentcore);
+            return { plugins: await registry.listPlugins(category) };
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_core_config',
+        description: 'Get the agentcore contract configuration including fees, minimum stake, and linked contracts.',
+        parameters: { type: 'object', properties: {} },
+        handler: async () => {
+            const registry = new sdk_1.AgentRegistry(config.rpc, undefined, contracts.agentcore);
+            return registry.getConfig();
+        },
+    });
+    // ---- WRITE TOOLS ----
+    api.registerTool({
+        name: 'xpr_register_agent',
+        description: 'Register a new agent on the XPR Network registry. Requires XPR_ACCOUNT and XPR_PRIVATE_KEY env vars. May require a registration fee.',
+        parameters: {
+            type: 'object',
+            required: ['name', 'description', 'endpoint', 'protocol', 'capabilities'],
+            properties: {
+                name: { type: 'string', description: 'Display name for the agent' },
+                description: { type: 'string', description: 'Agent description' },
+                endpoint: { type: 'string', description: 'API endpoint URL' },
+                protocol: { type: 'string', description: 'Communication protocol. Must be one of: http, https, grpc, websocket, mqtt, wss' },
+                capabilities: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of agent capabilities',
+                },
+                fee_amount: { type: 'number', description: 'Registration fee in XPR (e.g., 10.0). Check xpr_get_core_config for current fee.' },
+                confirmed: { type: 'boolean', description: 'Set to true to execute after reviewing the confirmation prompt' },
+            },
+        },
+        handler: async (params) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            (0, validate_1.validateRequired)(params.name, 'name');
+            (0, validate_1.validateRequired)(params.endpoint, 'endpoint');
+            (0, validate_1.validateUrl)(params.endpoint, 'endpoint');
+            if (params.fee_amount) {
+                (0, validate_1.validateAmount)((0, validate_1.xprToSmallestUnits)(params.fee_amount), config.maxTransferAmount);
+            }
+            const confirmation = (0, confirm_1.needsConfirmation)(config.confirmHighRisk, params.confirmed, 'Register Agent', { name: params.name, endpoint: params.endpoint, fee: params.fee_amount ? `${params.fee_amount} XPR` : 'none' }, `Register agent "${params.name}" at ${params.endpoint}` + (params.fee_amount ? ` (fee: ${params.fee_amount} XPR)` : ''));
+            if (confirmation)
+                return confirmation;
+            const registry = new sdk_1.AgentRegistry(config.rpc, config.session, contracts.agentcore);
+            const data = {
+                name: params.name,
+                description: params.description,
+                endpoint: params.endpoint,
+                protocol: params.protocol,
+                capabilities: params.capabilities,
+            };
+            if (params.fee_amount) {
+                return registry.registerWithFee(data, `${params.fee_amount.toFixed(4)} XPR`);
+            }
+            return registry.register(data);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_update_agent',
+        description: 'Update the current agent profile (name, description, endpoint, protocol, capabilities).',
+        parameters: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'New display name' },
+                description: { type: 'string', description: 'New description' },
+                endpoint: { type: 'string', description: 'New API endpoint URL' },
+                protocol: { type: 'string', description: 'New protocol' },
+                capabilities: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New capabilities list',
+                },
+            },
+        },
+        handler: async (params) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            if (params.endpoint)
+                (0, validate_1.validateUrl)(params.endpoint, 'endpoint');
+            const registry = new sdk_1.AgentRegistry(config.rpc, config.session, contracts.agentcore);
+            return registry.update(params);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_set_agent_status',
+        description: 'Set the active/inactive status of the current agent.',
+        parameters: {
+            type: 'object',
+            required: ['active'],
+            properties: {
+                active: { type: 'boolean', description: 'true to activate, false to deactivate' },
+            },
+        },
+        handler: async ({ active }) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            const registry = new sdk_1.AgentRegistry(config.rpc, config.session, contracts.agentcore);
+            return registry.setStatus(active);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_manage_plugin',
+        description: 'Add, remove, or toggle a plugin on the current agent.',
+        parameters: {
+            type: 'object',
+            required: ['action'],
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['add', 'remove', 'toggle'],
+                    description: 'Plugin management action',
+                },
+                plugin_id: { type: 'number', description: 'Plugin ID (required for add)' },
+                agentplugin_id: { type: 'number', description: 'Agent-plugin assignment ID (required for remove/toggle)' },
+                config: { type: 'object', description: 'Plugin configuration (for add)' },
+                enabled: { type: 'boolean', description: 'Enable/disable state (for toggle)' },
+            },
+        },
+        handler: async (params) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            const registry = new sdk_1.AgentRegistry(config.rpc, config.session, contracts.agentcore);
+            switch (params.action) {
+                case 'add':
+                    (0, validate_1.validateRequired)(params.plugin_id, 'plugin_id');
+                    return registry.addPlugin(params.plugin_id, params.config);
+                case 'remove':
+                    (0, validate_1.validateRequired)(params.agentplugin_id, 'agentplugin_id');
+                    return registry.removePlugin(params.agentplugin_id);
+                case 'toggle': {
+                    (0, validate_1.validateRequired)(params.agentplugin_id, 'agentplugin_id');
+                    // Toggle requires knowing current state; SDK toggleplug sets enabled directly
+                    return config.session.link.transact({
+                        actions: [{
+                                account: contracts.agentcore,
+                                name: 'toggleplug',
+                                authorization: [{ actor: config.session.auth.actor, permission: config.session.auth.permission }],
+                                data: {
+                                    agent: config.session.auth.actor,
+                                    agentplugin_id: params.agentplugin_id,
+                                    enabled: params.enabled ?? true,
+                                },
+                            }],
+                    });
+                }
+                default:
+                    throw new Error(`Unknown action: ${params.action}`);
+            }
+        },
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/tools/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/tools/agent.ts"],"names":[],"mappings":"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"}

package/dist/tools/escrow.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Escrow tools (14 tools)
+ * Reads: xpr_get_job, xpr_list_jobs, xpr_get_milestones,
+ *        xpr_get_job_dispute, xpr_list_arbitrators
+ * Writes: xpr_create_job, xpr_fund_job, xpr_accept_job,
+ *         xpr_deliver_job, xpr_approve_delivery, xpr_raise_dispute,
+ *         xpr_submit_milestone, xpr_arbitrate, xpr_resolve_timeout
+ */
+import type { PluginApi, PluginConfig } from '../types';
+export declare function registerEscrowTools(api: PluginApi, config: PluginConfig): void;
+//# sourceMappingURL=escrow.d.ts.map

package/dist/tools/escrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escrow.d.ts","sourceRoot":"","sources":["../../src/tools/escrow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAYxD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAub9E"}