@xpr-agents/openclaw 0.1.0

package/dist/tools/indexer.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Indexer query tools (4 tools)
+ * All read-only. Query the XPR Agents indexer REST API.
+ *
+ * xpr_search_agents, xpr_get_events, xpr_get_stats, xpr_indexer_health
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerIndexerTools = registerIndexerTools;
+async function fetchIndexer(indexerUrl, path) {
+    const url = `${indexerUrl.replace(/\/$/, '')}/api${path}`;
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Indexer request failed: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+async function fetchHealth(indexerUrl) {
+    const url = `${indexerUrl.replace(/\/$/, '')}/health`;
+    const response = await fetch(url);
+    return {
+        status: response.status,
+        ...await response.json(),
+    };
+}
+function registerIndexerTools(api, config) {
+    const indexerUrl = config.indexerUrl;
+    api.registerTool({
+        name: 'xpr_search_agents',
+        description: 'Full-text search across agents by account name, display name, or description via the indexer.',
+        parameters: {
+            type: 'object',
+            required: ['query'],
+            properties: {
+                query: { type: 'string', description: 'Search query string' },
+                limit: { type: 'number', description: 'Max results (default 20, max 50)' },
+            },
+        },
+        handler: async ({ query, limit = 20 }) => {
+            if (!query || typeof query !== 'string') {
+                throw new Error('query is required');
+            }
+            const params = new URLSearchParams({
+                q: query,
+                limit: String(Math.min(limit, 50)),
+            });
+            return fetchIndexer(indexerUrl, `/search?${params}`);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_events',
+        description: 'Get recent blockchain events from the indexer. Filter by contract and/or action.',
+        parameters: {
+            type: 'object',
+            properties: {
+                contract: {
+                    type: 'string',
+                    enum: ['agentcore', 'agentfeed', 'agentvalid', 'agentescrow'],
+                    description: 'Filter events by contract',
+                },
+                action: { type: 'string', description: 'Filter events by action name' },
+                limit: { type: 'number', description: 'Max results (default 50, max 200)' },
+            },
+        },
+        handler: async ({ contract, action, limit = 50 }) => {
+            const params = new URLSearchParams();
+            if (contract)
+                params.set('contract', contract);
+            if (action)
+                params.set('action', action);
+            params.set('limit', String(Math.min(limit, 200)));
+            return fetchIndexer(indexerUrl, `/events?${params}`);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_stats',
+        description: 'Get global registry statistics: total agents, active agents, validators, feedback, jobs, etc.',
+        parameters: { type: 'object', properties: {} },
+        handler: async () => {
+            return fetchIndexer(indexerUrl, '/stats');
+        },
+    });
+    api.registerTool({
+        name: 'xpr_indexer_health',
+        description: 'Check the health and connection status of the XPR Agents indexer.',
+        parameters: { type: 'object', properties: {} },
+        handler: async () => {
+            try {
+                return await fetchHealth(indexerUrl);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return { status: 'unreachable', error: message, indexerUrl };
+            }
+        },
+    });
+}
+//# sourceMappingURL=indexer.js.map

package/dist/tools/indexer.js.map

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

package/dist/tools/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validation tools (9 tools)
+ * Reads: xpr_get_validator, xpr_list_validators, xpr_get_validation,
+ *        xpr_list_agent_validations, xpr_get_challenge
+ * Writes: xpr_register_validator, xpr_submit_validation,
+ *         xpr_challenge_validation, xpr_stake_validator
+ */
+import type { PluginApi, PluginConfig } from '../types';
+export declare function registerValidationTools(api: PluginApi, config: PluginConfig): void;
+//# sourceMappingURL=validation.d.ts.map

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

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

package/dist/tools/validation.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Validation tools (9 tools)
+ * Reads: xpr_get_validator, xpr_list_validators, xpr_get_validation,
+ *        xpr_list_agent_validations, xpr_get_challenge
+ * Writes: xpr_register_validator, xpr_submit_validation,
+ *         xpr_challenge_validation, xpr_stake_validator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerValidationTools = registerValidationTools;
+const sdk_1 = require("@xpr-agents/sdk");
+const validate_1 = require("../util/validate");
+const confirm_1 = require("../util/confirm");
+function registerValidationTools(api, config) {
+    const contracts = config.contracts;
+    // ---- READ TOOLS ----
+    api.registerTool({
+        name: 'xpr_get_validator',
+        description: 'Get details for a validator including stake, accuracy score, and specializations.',
+        parameters: {
+            type: 'object',
+            required: ['account'],
+            properties: {
+                account: { type: 'string', description: 'Validator account name' },
+            },
+        },
+        handler: async ({ account }) => {
+            (0, validate_1.validateAccountName)(account);
+            const registry = new sdk_1.ValidationRegistry(config.rpc, undefined, contracts.agentvalid);
+            const validator = await registry.getValidator(account);
+            if (!validator) {
+                return { error: `Validator '${account}' not found` };
+            }
+            return validator;
+        },
+    });
+    api.registerTool({
+        name: 'xpr_list_validators',
+        description: 'List registered validators with optional filtering by active status, minimum stake, and accuracy.',
+        parameters: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Max results (default 20, max 100)' },
+                active_only: { type: 'boolean', description: 'Only active validators (default true)' },
+                min_stake: { type: 'number', description: 'Minimum stake in XPR smallest units' },
+                min_accuracy: { type: 'number', description: 'Minimum accuracy score (0-10000)' },
+            },
+        },
+        handler: async ({ limit = 20, active_only = true, min_stake, min_accuracy }) => {
+            const registry = new sdk_1.ValidationRegistry(config.rpc, undefined, contracts.agentvalid);
+            const validators = await registry.listValidators({
+                limit: Math.min(limit, 100),
+                active_only,
+                min_stake,
+                min_accuracy,
+            });
+            return { validators, count: validators.length };
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_validation',
+        description: 'Get a specific validation record by ID.',
+        parameters: {
+            type: 'object',
+            required: ['id'],
+            properties: {
+                id: { type: 'number', description: 'Validation ID' },
+            },
+        },
+        handler: async ({ id }) => {
+            (0, validate_1.validatePositiveInt)(id, 'id');
+            const registry = new sdk_1.ValidationRegistry(config.rpc, undefined, contracts.agentvalid);
+            const validation = await registry.getValidation(id);
+            if (!validation) {
+                return { error: `Validation #${id} not found` };
+            }
+            return validation;
+        },
+    });
+    api.registerTool({
+        name: 'xpr_list_agent_validations',
+        description: 'List all validations for a specific agent.',
+        parameters: {
+            type: 'object',
+            required: ['agent'],
+            properties: {
+                agent: { type: 'string', description: 'Agent account name' },
+                limit: { type: 'number', description: 'Max results (default 20, max 100)' },
+            },
+        },
+        handler: async ({ agent, limit = 20 }) => {
+            (0, validate_1.validateAccountName)(agent);
+            const registry = new sdk_1.ValidationRegistry(config.rpc, undefined, contracts.agentvalid);
+            const validations = await registry.listValidationsForAgent(agent, Math.min(limit, 100));
+            return { validations, count: validations.length };
+        },
+    });
+    api.registerTool({
+        name: 'xpr_get_challenge',
+        description: 'Get details of a validation challenge by ID, including status, stake, and resolution.',
+        parameters: {
+            type: 'object',
+            required: ['id'],
+            properties: {
+                id: { type: 'number', description: 'Challenge ID' },
+            },
+        },
+        handler: async ({ id }) => {
+            (0, validate_1.validatePositiveInt)(id, 'id');
+            const registry = new sdk_1.ValidationRegistry(config.rpc, undefined, contracts.agentvalid);
+            const challenge = await registry.getChallenge(id);
+            if (!challenge) {
+                return { error: `Challenge #${id} not found` };
+            }
+            return challenge;
+        },
+    });
+    // ---- WRITE TOOLS ----
+    api.registerTool({
+        name: 'xpr_register_validator',
+        description: 'Register as a validator. Requires staking separately via xpr_stake_validator.',
+        parameters: {
+            type: 'object',
+            required: ['method', 'specializations'],
+            properties: {
+                method: { type: 'string', description: 'Validation method description' },
+                specializations: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of specialization areas (e.g., ["code-review", "data-analysis"])',
+                },
+            },
+        },
+        handler: async ({ method, specializations }) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            (0, validate_1.validateRequired)(method, 'method');
+            const registry = new sdk_1.ValidationRegistry(config.rpc, config.session, contracts.agentvalid);
+            return registry.registerValidator(method, specializations);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_submit_validation',
+        description: 'Submit a validation result for an agent\'s job output.',
+        parameters: {
+            type: 'object',
+            required: ['agent', 'job_hash', 'result', 'confidence'],
+            properties: {
+                agent: { type: 'string', description: 'Agent account being validated' },
+                job_hash: { type: 'string', description: 'Hash of the job being validated' },
+                result: { type: 'string', enum: ['fail', 'pass', 'partial'], description: 'Validation result' },
+                confidence: { type: 'number', description: 'Confidence level 0-100' },
+                evidence_uri: { type: 'string', description: 'URI to validation evidence' },
+                fee_amount: { type: 'number', description: 'Validation fee in XPR' },
+            },
+        },
+        handler: async (params) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            (0, validate_1.validateAccountName)(params.agent, 'agent');
+            (0, validate_1.validateRequired)(params.job_hash, 'job_hash');
+            (0, validate_1.validateValidationResult)(params.result);
+            (0, validate_1.validateConfidence)(params.confidence);
+            if (params.evidence_uri)
+                (0, validate_1.validateUrl)(params.evidence_uri, 'evidence_uri');
+            if (params.fee_amount) {
+                (0, validate_1.validateAmount)((0, validate_1.xprToSmallestUnits)(params.fee_amount), config.maxTransferAmount);
+            }
+            const registry = new sdk_1.ValidationRegistry(config.rpc, config.session, contracts.agentvalid);
+            const data = {
+                agent: params.agent,
+                job_hash: params.job_hash,
+                result: params.result,
+                confidence: params.confidence,
+                evidence_uri: params.evidence_uri,
+            };
+            if (params.fee_amount) {
+                return registry.validateWithFee(data, `${params.fee_amount.toFixed(4)} XPR`);
+            }
+            return registry.validate(data);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_challenge_validation',
+        description: 'Challenge a validation result. Must be funded separately via token transfer with memo "challenge:CHALLENGE_ID".',
+        parameters: {
+            type: 'object',
+            required: ['validation_id', 'reason'],
+            properties: {
+                validation_id: { type: 'number', description: 'ID of the validation to challenge' },
+                reason: { type: 'string', description: 'Reason for the challenge' },
+                evidence_uri: { type: 'string', description: 'URI to supporting evidence' },
+            },
+        },
+        handler: async ({ validation_id, reason, evidence_uri }) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            (0, validate_1.validatePositiveInt)(validation_id, 'validation_id');
+            (0, validate_1.validateRequired)(reason, 'reason');
+            if (evidence_uri)
+                (0, validate_1.validateUrl)(evidence_uri, 'evidence_uri');
+            const registry = new sdk_1.ValidationRegistry(config.rpc, config.session, contracts.agentvalid);
+            return registry.challenge(validation_id, reason, evidence_uri);
+        },
+    });
+    api.registerTool({
+        name: 'xpr_stake_validator',
+        description: 'Stake XPR as a validator. Staked tokens are slashable if validations are successfully challenged.',
+        parameters: {
+            type: 'object',
+            required: ['amount'],
+            properties: {
+                amount: { type: 'number', description: 'Amount to stake in XPR (e.g., 1000.0)' },
+                confirmed: { type: 'boolean', description: 'Set to true to execute after reviewing the confirmation prompt' },
+            },
+        },
+        handler: async ({ amount, confirmed }) => {
+            if (!config.session)
+                throw new Error('Session required: set XPR_ACCOUNT and XPR_PRIVATE_KEY environment variables');
+            if (amount <= 0)
+                throw new Error('amount must be positive');
+            (0, validate_1.validateAmount)((0, validate_1.xprToSmallestUnits)(amount), config.maxTransferAmount);
+            const confirmation = (0, confirm_1.needsConfirmation)(config.confirmHighRisk, confirmed, 'Stake Validator', { amount: `${amount} XPR`, note: 'Staked tokens are slashable' }, `Stake ${amount} XPR as validator collateral (slashable if challenged successfully)`);
+            if (confirmation)
+                return confirmation;
+            const registry = new sdk_1.ValidationRegistry(config.rpc, config.session, contracts.agentvalid);
+            return registry.stake(`${amount.toFixed(4)} XPR`);
+        },
+    });
+}
+//# sourceMappingURL=validation.js.map

package/dist/tools/validation.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Internal types for the OpenClaw plugin.
+ */
+import type { JsonRpc, ProtonSession } from '@xpr-agents/sdk';
+export interface PluginConfig {
+    rpc: JsonRpc;
+    session?: ProtonSession;
+    network: 'mainnet' | 'testnet';
+    rpcEndpoint: string;
+    indexerUrl: string;
+    contracts: ContractNames;
+    confirmHighRisk: boolean;
+    maxTransferAmount: number;
+}
+export interface ContractNames {
+    agentcore: string;
+    agentfeed: string;
+    agentvalid: string;
+    agentescrow: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        required?: string[];
+        properties: Record<string, unknown>;
+    };
+    handler: (params: any) => Promise<unknown>;
+}
+/**
+ * OpenClaw plugin API interface.
+ * This matches the OpenClaw extension registration pattern.
+ */
+export interface PluginApi {
+    registerTool(tool: ToolDefinition): void;
+    getConfig(): Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;IACF,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Internal types for the OpenClaw plugin.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/util/confirm.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Confirmation gate for high-risk write tools.
+ *
+ * When confirmHighRisk is enabled and `confirmed` is not true, high-risk
+ * tools return a confirmation prompt instead of executing. The agent relays
+ * the prompt to the user. On the next call the agent passes confirmed=true
+ * and the tool executes normally.
+ */
+export interface ConfirmationResult {
+    needs_confirmation: true;
+    action: string;
+    details: Record<string, unknown>;
+    message: string;
+}
+/**
+ * Returns a confirmation prompt if the action has not been confirmed yet.
+ * Returns null (proceed) when either:
+ *   - confirmHighRisk is disabled in config, or
+ *   - the caller already set confirmed=true
+ */
+export declare function needsConfirmation(confirmHighRisk: boolean, confirmed: boolean | undefined, action: string, details: Record<string, unknown>, message: string): ConfirmationResult | null;
+export declare function formatConfirmation(action: string, details: Record<string, unknown>): string;
+//# sourceMappingURL=confirm.d.ts.map

package/dist/util/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../src/util/confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,OAAO,EACxB,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,MAAM,GACd,kBAAkB,GAAG,IAAI,CAW3B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAQR"}

package/dist/util/confirm.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Confirmation gate for high-risk write tools.
+ *
+ * When confirmHighRisk is enabled and `confirmed` is not true, high-risk
+ * tools return a confirmation prompt instead of executing. The agent relays
+ * the prompt to the user. On the next call the agent passes confirmed=true
+ * and the tool executes normally.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.needsConfirmation = needsConfirmation;
+exports.formatConfirmation = formatConfirmation;
+/**
+ * Returns a confirmation prompt if the action has not been confirmed yet.
+ * Returns null (proceed) when either:
+ *   - confirmHighRisk is disabled in config, or
+ *   - the caller already set confirmed=true
+ */
+function needsConfirmation(confirmHighRisk, confirmed, action, details, message) {
+    if (!confirmHighRisk || confirmed === true) {
+        return null;
+    }
+    return {
+        needs_confirmation: true,
+        action,
+        details,
+        message,
+    };
+}
+function formatConfirmation(action, details) {
+    const lines = [`Action: ${action}`];
+    for (const [key, value] of Object.entries(details)) {
+        if (value !== undefined && value !== null && value !== '') {
+            lines.push(`  ${key}: ${typeof value === 'object' ? JSON.stringify(value) : value}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=confirm.js.map

package/dist/util/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../src/util/confirm.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAeH,8CAiBC;AAED,gDAWC;AApCD;;;;;GAKG;AACH,SAAgB,iBAAiB,CAC/B,eAAwB,EACxB,SAA8B,EAC9B,MAAc,EACd,OAAgC,EAChC,OAAe;IAEf,IAAI,CAAC,eAAe,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,kBAAkB,EAAE,IAAI;QACxB,MAAM;QACN,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAgB,kBAAkB,CAChC,MAAc,EACd,OAAgC;IAEhC,MAAM,KAAK,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/util/validate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Input validation helpers for OpenClaw tool parameters.
+ * Reuses patterns from the SDK's utils.ts.
+ */
+export declare function validateAccountName(name: string, field?: string): void;
+export declare function validateScore(score: number): void;
+export declare function validateConfidence(confidence: number): void;
+export declare function validateUrl(url: string, field?: string): void;
+export declare function validateAmount(amount: number, maxAmount: number): void;
+export declare function validatePositiveInt(value: number, field: string): void;
+export declare function validateRequired(value: unknown, field: string): void;
+export declare function validateValidationResult(result: string): void;
+export declare function validateClientPercent(percent: number): void;
+/**
+ * Convert a human-readable XPR amount to smallest units using integer math.
+ * Avoids floating-point precision issues (e.g., 0.7 * 10000 = 6999).
+ */
+export declare function xprToSmallestUnits(amount: number): number;
+//# sourceMappingURL=validate.d.ts.map

package/dist/util/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/util/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,IAAI,CAUjF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAOjD;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO3D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAc,GAAG,IAAI,CASpE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAOtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAItE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAO3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/util/validate.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Input validation helpers for OpenClaw tool parameters.
+ * Reuses patterns from the SDK's utils.ts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAccountName = validateAccountName;
+exports.validateScore = validateScore;
+exports.validateConfidence = validateConfidence;
+exports.validateUrl = validateUrl;
+exports.validateAmount = validateAmount;
+exports.validatePositiveInt = validatePositiveInt;
+exports.validateRequired = validateRequired;
+exports.validateValidationResult = validateValidationResult;
+exports.validateClientPercent = validateClientPercent;
+exports.xprToSmallestUnits = xprToSmallestUnits;
+function validateAccountName(name, field = 'account') {
+    if (!name || typeof name !== 'string') {
+        throw new Error(`${field} is required`);
+    }
+    if (name.length > 12) {
+        throw new Error(`${field} must be 12 characters or fewer`);
+    }
+    if (!/^[a-z1-5.]+$/.test(name)) {
+        throw new Error(`${field} must contain only a-z, 1-5, and '.'`);
+    }
+}
+function validateScore(score) {
+    if (typeof score !== 'number' || !Number.isInteger(score)) {
+        throw new Error('score must be an integer');
+    }
+    if (score < 1 || score > 5) {
+        throw new Error('score must be between 1 and 5');
+    }
+}
+function validateConfidence(confidence) {
+    if (typeof confidence !== 'number' || !Number.isInteger(confidence)) {
+        throw new Error('confidence must be an integer');
+    }
+    if (confidence < 0 || confidence > 100) {
+        throw new Error('confidence must be between 0 and 100');
+    }
+}
+function validateUrl(url, field = 'url') {
+    if (!url || typeof url !== 'string') {
+        throw new Error(`${field} is required`);
+    }
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new Error(`${field} must be a valid URL`);
+    }
+}
+function validateAmount(amount, maxAmount) {
+    if (typeof amount !== 'number' || amount <= 0) {
+        throw new Error('amount must be a positive number');
+    }
+    if (amount > maxAmount) {
+        throw new Error(`amount exceeds maximum allowed (${maxAmount / 10000} XPR)`);
+    }
+}
+function validatePositiveInt(value, field) {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+        throw new Error(`${field} must be a non-negative integer`);
+    }
+}
+function validateRequired(value, field) {
+    if (value === undefined || value === null || value === '') {
+        throw new Error(`${field} is required`);
+    }
+}
+function validateValidationResult(result) {
+    if (!['fail', 'pass', 'partial'].includes(result)) {
+        throw new Error("result must be 'fail', 'pass', or 'partial'");
+    }
+}
+function validateClientPercent(percent) {
+    if (typeof percent !== 'number' || !Number.isInteger(percent)) {
+        throw new Error('client_percent must be an integer');
+    }
+    if (percent < 0 || percent > 100) {
+        throw new Error('client_percent must be between 0 and 100');
+    }
+}
+/**
+ * Convert a human-readable XPR amount to smallest units using integer math.
+ * Avoids floating-point precision issues (e.g., 0.7 * 10000 = 6999).
+ */
+function xprToSmallestUnits(amount) {
+    const str = amount.toFixed(4);
+    const [whole, frac = ''] = str.split('.');
+    const paddedFrac = frac.padEnd(4, '0').slice(0, 4);
+    return parseInt(whole, 10) * 10000 + parseInt(paddedFrac, 10);
+}
+//# sourceMappingURL=validate.js.map

package/dist/util/validate.js.map

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