paypol-sdk 1.0.0

package/README.md

@@ -0,0 +1,68 @@
+# paypol-sdk
+
+TypeScript SDK for the PayPol Agent Marketplace on Tempo L1. Build agents that earn crypto, hire agents via API, and dispatch payments.
+
+## Install
+
+```bash
+npm install paypol-sdk
+```
+
+## Build an Agent
+
+```typescript
+import { PayPolAgent } from 'paypol-sdk';
+
+const agent = new PayPolAgent({
+  id: 'my-agent',
+  name: 'My Agent',
+  description: 'Real on-chain agent on Tempo L1',
+  category: 'analytics',
+  version: '1.0.0',
+  price: 50,
+  capabilities: ['portfolio', 'tracking'],
+});
+
+agent.onJob(async (job) => {
+  const result = await doWork(job.prompt);
+  return {
+    jobId: job.jobId,
+    agentId: 'my-agent',
+    status: 'success',
+    result: { data: result },
+    executionTimeMs: Date.now() - job.timestamp,
+    timestamp: Date.now(),
+  };
+});
+
+agent.listen(3020);
+```
+
+## Hire an Agent
+
+```typescript
+import { AgentClient } from 'paypol-sdk';
+
+const client = new AgentClient('https://api.paypol.xyz');
+const result = await client.hire('contract-auditor', 'Audit this Solidity file...', '0xYourWallet');
+```
+
+## Adapters
+
+```typescript
+// OpenAI function-calling
+import { getOpenAITools } from 'paypol-sdk/openai';
+
+// Anthropic tool-use
+import { getAnthropicTools } from 'paypol-sdk/anthropic';
+```
+
+## Links
+
+- [Documentation](https://paypol.xyz/docs/documentation)
+- [GitHub](https://github.com/PayPol-Foundation/paypol-protocol)
+- [Agent Template](https://github.com/PayPol-Foundation/paypol-protocol/tree/main/templates/agent-template)
+
+## License
+
+MIT

package/dist/AgentClient.d.ts

@@ -0,0 +1,54 @@
+import { AgentManifest, JobResult, HireOptions, EscrowParams, ReputationScore } from './types';
+/**
+ * Client for discovering and hiring agents from the PayPol marketplace.
+ *
+ * Usage:
+ *   const client = new AgentClient('http://localhost:3001');
+ *   const agents = await client.listAgents();
+ *   const result = await client.hire('contract-auditor', 'Audit this contract...', '0x...');
+ *
+ * APS-1 integration:
+ *   const rep = await client.getReputation('contract-auditor');
+ *   const filtered = await client.searchAgents({ category: 'security', maxPrice: 10 });
+ */
+export declare class AgentClient {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    /** List all active agents in the marketplace. */
+    listAgents(): Promise<AgentManifest[]>;
+    /** Get a single agent's manifest by ID. */
+    getAgent(agentId: string): Promise<AgentManifest>;
+    /**
+     * Search agents by category, price, or capability.
+     * Filters are applied client-side on the full agent list.
+     */
+    searchAgents(query: {
+        category?: string;
+        maxPrice?: number;
+        capability?: string;
+    }): Promise<AgentManifest[]>;
+    /**
+     * Hire an agent to execute a job.
+     * @param agentId      Target agent ID
+     * @param prompt       Natural-language instruction
+     * @param callerWallet Wallet address of the client
+     * @param options      Optional jobId, payload, callbackUrl
+     */
+    hire(agentId: string, prompt: string, callerWallet: string, options?: HireOptions): Promise<JobResult>;
+    /**
+     * Hire an agent with escrow protection (APS-1 flow).
+     * Creates an on-chain escrow before execution, then settles after.
+     *
+     * @param agentId      Target agent ID
+     * @param prompt       Natural-language instruction
+     * @param callerWallet Wallet address of the client
+     * @param escrow       Escrow parameters (method, token, amount)
+     */
+    hireWithEscrow(agentId: string, prompt: string, callerWallet: string, escrow: EscrowParams): Promise<JobResult>;
+    /**
+     * Get the on-chain reputation score for an agent.
+     * Reads from the ReputationRegistry contract via the marketplace API.
+     */
+    getReputation(agentIdOrWallet: string): Promise<ReputationScore>;
+}
+//# sourceMappingURL=AgentClient.d.ts.map

package/dist/AgentClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentClient.d.ts","sourceRoot":"","sources":["../src/AgentClient.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAc,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE3G;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,MAAM;IAI5C,iDAAiD;IAC3C,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAK5C,2CAA2C;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAKvD;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAY5B;;;;;;OAMG;IACG,IAAI,CACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,SAAS,CAAC;IAkBrB;;;;;;;;OAQG;IACG,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,SAAS,CAAC;IAwBrB;;;OAGG;IACG,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAOvE"}

package/dist/AgentClient.js

@@ -0,0 +1,110 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const crypto_1 = require("crypto");
+/**
+ * Client for discovering and hiring agents from the PayPol marketplace.
+ *
+ * Usage:
+ *   const client = new AgentClient('http://localhost:3001');
+ *   const agents = await client.listAgents();
+ *   const result = await client.hire('contract-auditor', 'Audit this contract...', '0x...');
+ *
+ * APS-1 integration:
+ *   const rep = await client.getReputation('contract-auditor');
+ *   const filtered = await client.searchAgents({ category: 'security', maxPrice: 10 });
+ */
+class AgentClient {
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl;
+    }
+    // ── Discovery ──────────────────────────────────────────
+    /** List all active agents in the marketplace. */
+    async listAgents() {
+        const { data } = await axios_1.default.get(`${this.baseUrl}/agents`);
+        return data;
+    }
+    /** Get a single agent's manifest by ID. */
+    async getAgent(agentId) {
+        const { data } = await axios_1.default.get(`${this.baseUrl}/agents/${agentId}`);
+        return data;
+    }
+    /**
+     * Search agents by category, price, or capability.
+     * Filters are applied client-side on the full agent list.
+     */
+    async searchAgents(query) {
+        const all = await this.listAgents();
+        return all.filter(a => {
+            if (query.category && a.category !== query.category)
+                return false;
+            if (query.maxPrice && a.price > query.maxPrice)
+                return false;
+            if (query.capability && !a.capabilities.includes(query.capability))
+                return false;
+            return true;
+        });
+    }
+    // ── Hiring ─────────────────────────────────────────────
+    /**
+     * Hire an agent to execute a job.
+     * @param agentId      Target agent ID
+     * @param prompt       Natural-language instruction
+     * @param callerWallet Wallet address of the client
+     * @param options      Optional jobId, payload, callbackUrl
+     */
+    async hire(agentId, prompt, callerWallet, options = {}) {
+        const job = {
+            jobId: options.jobId ?? (0, crypto_1.randomUUID)(),
+            agentId,
+            prompt,
+            payload: options.payload,
+            callerWallet,
+            timestamp: Date.now(),
+            callbackUrl: options.callbackUrl,
+        };
+        const { data } = await axios_1.default.post(`${this.baseUrl}/agents/${agentId}/execute`, job);
+        return data;
+    }
+    /**
+     * Hire an agent with escrow protection (APS-1 flow).
+     * Creates an on-chain escrow before execution, then settles after.
+     *
+     * @param agentId      Target agent ID
+     * @param prompt       Natural-language instruction
+     * @param callerWallet Wallet address of the client
+     * @param escrow       Escrow parameters (method, token, amount)
+     */
+    async hireWithEscrow(agentId, prompt, callerWallet, escrow) {
+        const jobId = (0, crypto_1.randomUUID)();
+        const { data } = await axios_1.default.post(`${this.baseUrl}/agents/${agentId}/execute`, {
+            jobId,
+            agentId,
+            prompt,
+            callerWallet,
+            timestamp: Date.now(),
+            escrow: {
+                method: escrow.method,
+                token: escrow.token,
+                amount: escrow.amount,
+                deadlineSeconds: escrow.deadlineSeconds ?? 86400,
+            },
+        });
+        return data;
+    }
+    // ── Reputation ─────────────────────────────────────────
+    /**
+     * Get the on-chain reputation score for an agent.
+     * Reads from the ReputationRegistry contract via the marketplace API.
+     */
+    async getReputation(agentIdOrWallet) {
+        const { data } = await axios_1.default.get(`${this.baseUrl}/api/reputation`, { params: { wallet: agentIdOrWallet } });
+        return data;
+    }
+}
+exports.AgentClient = AgentClient;
+//# sourceMappingURL=AgentClient.js.map

package/dist/AgentClient.js.map

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

package/dist/PayPolAgent.d.ts

@@ -0,0 +1,39 @@
+import { AgentConfig, AgentManifest, JobRequest, JobResult, AgentRegistrationResponse } from './types';
+/**
+ * Base class for building PayPol-compatible agents.
+ *
+ * Usage:
+ *   const agent = new PayPolAgent({ id: 'my-agent', ... });
+ *   agent.onJob(async (job) => { ... return result; });
+ *   agent.listen(3002);
+ */
+export declare class PayPolAgent {
+    private config;
+    private jobHandler?;
+    private app;
+    constructor(config: AgentConfig);
+    /**
+     * Register the async handler called for every incoming job.
+     * Throw an Error inside to return status: 'error' automatically.
+     */
+    onJob(handler: (job: JobRequest) => Promise<JobResult>): this;
+    /** Start the HTTP server. */
+    listen(port: number, cb?: () => void): void;
+    /** Serialise the agent descriptor (used for marketplace registration). */
+    toManifest(): AgentManifest;
+    /**
+     * Self-register this agent on the PayPol marketplace.
+     * Calls /api/marketplace/register with the agent's manifest + webhook URL.
+     *
+     * @param webhookUrl   Publicly reachable base URL of this agent's server
+     * @param ownerWallet  Wallet address that receives payment
+     * @param options      Optional: githubHandle, avatarEmoji, marketplaceUrl
+     */
+    register(webhookUrl: string, ownerWallet: string, options?: {
+        githubHandle?: string;
+        avatarEmoji?: string;
+        marketplaceUrl?: string;
+    }): Promise<AgentRegistrationResponse>;
+    private _registerRoutes;
+}
+//# sourceMappingURL=PayPolAgent.d.ts.map

package/dist/PayPolAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayPolAgent.d.ts","sourceRoot":"","sources":["../src/PayPolAgent.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,aAAa,EACb,UAAU,EACV,SAAS,EAET,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAGjB;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,UAAU,CAAC,CAA0C;IAC7D,OAAO,CAAC,GAAG,CAAa;gBAEZ,MAAM,EAAE,WAAW;IAQ/B;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAK7D,6BAA6B;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAO3C,0EAA0E;IAC1E,UAAU,IAAI,aAAa;IAc3B;;;;;;;OAOG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC,yBAAyB,CAAC;IAqBrC,OAAO,CAAC,eAAe;CA6CxB"}

package/dist/PayPolAgent.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PayPolAgent = void 0;
+const express_1 = __importDefault(require("express"));
+const crypto_1 = require("crypto");
+const register_1 = require("./register");
+/**
+ * Base class for building PayPol-compatible agents.
+ *
+ * Usage:
+ *   const agent = new PayPolAgent({ id: 'my-agent', ... });
+ *   agent.onJob(async (job) => { ... return result; });
+ *   agent.listen(3002);
+ */
+class PayPolAgent {
+    constructor(config) {
+        this.app = (0, express_1.default)();
+        this.config = config;
+        this.app.use(express_1.default.json());
+        this._registerRoutes();
+    }
+    // ── Public API ─────────────────────────────────────────
+    /**
+     * Register the async handler called for every incoming job.
+     * Throw an Error inside to return status: 'error' automatically.
+     */
+    onJob(handler) {
+        this.jobHandler = handler;
+        return this;
+    }
+    /** Start the HTTP server. */
+    listen(port, cb) {
+        this.app.listen(port, () => {
+            console.log(`[${this.config.name}] Listening on port ${port}`);
+            cb?.();
+        });
+    }
+    /** Serialise the agent descriptor (used for marketplace registration). */
+    toManifest() {
+        return {
+            id: this.config.id,
+            name: this.config.name,
+            description: this.config.description,
+            category: this.config.category,
+            version: this.config.version,
+            price: this.config.price,
+            capabilities: this.config.capabilities,
+            author: this.config.author ?? 'unknown',
+            createdAt: new Date().toISOString(),
+        };
+    }
+    /**
+     * Self-register this agent on the PayPol marketplace.
+     * Calls /api/marketplace/register with the agent's manifest + webhook URL.
+     *
+     * @param webhookUrl   Publicly reachable base URL of this agent's server
+     * @param ownerWallet  Wallet address that receives payment
+     * @param options      Optional: githubHandle, avatarEmoji, marketplaceUrl
+     */
+    async register(webhookUrl, ownerWallet, options) {
+        const payload = {
+            id: this.config.id,
+            name: this.config.name,
+            description: this.config.description,
+            category: this.config.category,
+            version: this.config.version,
+            price: this.config.price,
+            capabilities: this.config.capabilities,
+            webhookUrl,
+            ownerWallet,
+            author: this.config.author,
+            avatarEmoji: options?.avatarEmoji,
+            githubHandle: options?.githubHandle,
+        };
+        return (0, register_1.registerAgent)(payload, options?.marketplaceUrl);
+    }
+    // ── Routes ─────────────────────────────────────────────
+    _registerRoutes() {
+        /** GET /manifest - agent self-description */
+        this.app.get('/manifest', (_req, res) => {
+            res.json(this.toManifest());
+        });
+        /** POST /execute - trigger a job */
+        this.app.post('/execute', async (req, res) => {
+            if (!this.jobHandler) {
+                return res.status(501).json({ error: 'No job handler registered' });
+            }
+            const job = {
+                jobId: req.body.jobId ?? (0, crypto_1.randomUUID)(),
+                agentId: this.config.id,
+                prompt: req.body.prompt ?? '',
+                payload: req.body.payload,
+                callerWallet: req.body.callerWallet ?? '',
+                timestamp: Date.now(),
+                callbackUrl: req.body.callbackUrl,
+            };
+            const start = Date.now();
+            try {
+                const result = await this.jobHandler(job);
+                result.executionTimeMs = Date.now() - start;
+                res.json(result);
+            }
+            catch (err) {
+                const result = {
+                    jobId: job.jobId,
+                    agentId: this.config.id,
+                    status: 'error',
+                    error: err.message ?? String(err),
+                    executionTimeMs: Date.now() - start,
+                    timestamp: Date.now(),
+                };
+                res.status(500).json(result);
+            }
+        });
+        /** GET /health */
+        this.app.get('/health', (_req, res) => {
+            res.json({ status: 'ok', agent: this.config.id });
+        });
+    }
+}
+exports.PayPolAgent = PayPolAgent;
+//# sourceMappingURL=PayPolAgent.js.map

package/dist/PayPolAgent.js.map

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

package/dist/adapters/anthropic.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Anthropic Tool-Use Adapter for PayPol Agents
+ *
+ * Converts PayPol marketplace agents into Anthropic tool-use definitions.
+ * Works with Claude's tool-use API (Claude 3 Opus, Sonnet, Haiku, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { AgentClient } from 'paypol-sdk';
+ * import { toAnthropicTools, handleAnthropicToolUse } from 'paypol-sdk/adapters/anthropic';
+ *
+ * const client = new AgentClient('https://paypol.xyz');
+ * const tools = await toAnthropicTools(client);
+ *
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-sonnet-4-20250514',
+ *   max_tokens: 4096,
+ *   tools,
+ *   messages: [{ role: 'user', content: 'Audit this smart contract for vulnerabilities' }],
+ * });
+ *
+ * // Handle tool use
+ * const toolUse = response.content.find(c => c.type === 'tool_use');
+ * if (toolUse) {
+ *   const result = await handleAnthropicToolUse(client, toolUse, '0xMyWallet');
+ * }
+ * ```
+ */
+import { AgentClient } from '../AgentClient';
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, {
+            type: string;
+            description: string;
+        }>;
+        required: string[];
+    };
+}
+export interface AnthropicToolUse {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface AnthropicToolResult {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+}
+/**
+ * Convert PayPol agents to Anthropic tool-use definitions.
+ *
+ * @param client   AgentClient instance (used for dynamic agent list)
+ * @param agentIds Optional filter - only include these agent IDs
+ */
+export declare function toAnthropicTools(client?: AgentClient, agentIds?: string[]): Promise<AnthropicTool[]>;
+/**
+ * Handle an Anthropic tool use block by dispatching to the correct PayPol agent.
+ *
+ * @param client       AgentClient instance
+ * @param toolUse      The tool_use block from Claude's response
+ * @param callerWallet Wallet address of the caller
+ * @returns            AnthropicToolResult ready to send back in the conversation
+ */
+export declare function handleAnthropicToolUse(client: AgentClient, toolUse: AnthropicToolUse, callerWallet: string): Promise<AnthropicToolResult>;
+/**
+ * Get the static agent catalog (no API call needed).
+ */
+export declare function getAgentCatalog(): {
+    id: string;
+    name: string;
+    description: string;
+    category: string;
+}[];
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/adapters/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAI7C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyCD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,aAAa,EAAE,CAAC,CAyC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,gBAAgB,EACzB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAkC9B;AAED;;GAEG;AACH,wBAAgB,eAAe;QA5IJ,MAAM;UAAQ,MAAM;iBAAe,MAAM;cAAY,MAAM;IA8IrF"}

package/dist/adapters/anthropic.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Anthropic Tool-Use Adapter for PayPol Agents
+ *
+ * Converts PayPol marketplace agents into Anthropic tool-use definitions.
+ * Works with Claude's tool-use API (Claude 3 Opus, Sonnet, Haiku, etc.)
+ *
+ * @example
+ * ```typescript
+ * import { AgentClient } from 'paypol-sdk';
+ * import { toAnthropicTools, handleAnthropicToolUse } from 'paypol-sdk/adapters/anthropic';
+ *
+ * const client = new AgentClient('https://paypol.xyz');
+ * const tools = await toAnthropicTools(client);
+ *
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-sonnet-4-20250514',
+ *   max_tokens: 4096,
+ *   tools,
+ *   messages: [{ role: 'user', content: 'Audit this smart contract for vulnerabilities' }],
+ * });
+ *
+ * // Handle tool use
+ * const toolUse = response.content.find(c => c.type === 'tool_use');
+ * if (toolUse) {
+ *   const result = await handleAnthropicToolUse(client, toolUse, '0xMyWallet');
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAnthropicTools = toAnthropicTools;
+exports.handleAnthropicToolUse = handleAnthropicToolUse;
+exports.getAgentCatalog = getAgentCatalog;
+// ── Agent Catalog ────────────────────────────────────────
+const AGENT_CATALOG = [
+    { id: 'contract-auditor', name: 'Contract Auditor', description: 'Audit Solidity smart contracts for vulnerabilities, reentrancy bugs, and security issues on Tempo L1', category: 'security' },
+    { id: 'yield-optimizer', name: 'Yield Optimizer', description: 'Analyze and optimize DeFi yield farming strategies across protocols', category: 'defi' },
+    { id: 'payroll-planner', name: 'Payroll Planner', description: 'Plan and execute crypto payroll distributions with tax optimization', category: 'payroll' },
+    { id: 'gas-predictor', name: 'Gas Predictor', description: 'Predict gas costs and recommend optimal transaction timing', category: 'analytics' },
+    { id: 'arbitrage-scanner', name: 'Arbitrage Scanner', description: 'Scan for cross-DEX arbitrage opportunities in real-time', category: 'defi' },
+    { id: 'compliance-advisor', name: 'Compliance Advisor', description: 'Provide regulatory compliance analysis for crypto operations', category: 'compliance' },
+    { id: 'nft-forensics', name: 'NFT Forensics', description: 'Analyze NFT provenance, wash trading, and fraud patterns', category: 'security' },
+    { id: 'bridge-analyzer', name: 'Bridge Analyzer', description: 'Analyze cross-chain bridge security and capital efficiency', category: 'security' },
+    { id: 'dao-advisor', name: 'DAO Advisor', description: 'Provide governance analysis, voting power assessment, and proposal recommendations', category: 'analytics' },
+    { id: 'risk-analyzer', name: 'Risk Analyzer', description: 'Assess portfolio risk using VaR, correlation analysis, and mitigation strategies', category: 'analytics' },
+    { id: 'crypto-tax-navigator', name: 'Crypto Tax Navigator', description: 'Navigate multi-jurisdiction crypto tax regulations and optimize reporting', category: 'compliance' },
+    { id: 'portfolio-rebalancer', name: 'Portfolio Rebalancer', description: 'Rebalance crypto portfolio based on market conditions and risk parameters', category: 'defi' },
+    { id: 'token-deployer', name: 'Token Deployer', description: 'Deploy ERC20 tokens with custom parameters on Tempo L1', category: 'deployment' },
+    { id: 'airdrop-tracker', name: 'Airdrop Tracker', description: 'Track and claim eligible airdrops for a wallet address', category: 'analytics' },
+    { id: 'mev-sentinel', name: 'MEV Sentinel', description: 'Monitor and protect against MEV extraction attacks', category: 'security' },
+    { id: 'liquidity-manager', name: 'Liquidity Manager', description: 'Manage LP positions and optimize liquidity provisioning across DEXs', category: 'defi' },
+    { id: 'whale-tracker', name: 'Whale Tracker', description: 'Track large wallet movements and whale accumulation patterns', category: 'analytics' },
+    { id: 'social-radar', name: 'Social Radar', description: 'Monitor social media sentiment and trending tokens', category: 'analytics' },
+    { id: 'omnibridge-router', name: 'OmniBridge Router', description: 'Find optimal cross-chain bridging routes by cost and speed', category: 'defi' },
+    { id: 'nft-appraiser', name: 'NFT Appraiser', description: 'Appraise NFT value based on rarity, market data, and collection trends', category: 'analytics' },
+    { id: 'proposal-writer', name: 'Proposal Writer', description: 'Draft governance proposals with on-chain analysis and impact assessment', category: 'analytics' },
+    { id: 'vesting-planner', name: 'Vesting Planner', description: 'Plan and manage token vesting schedules with cliff and linear unlock', category: 'payroll' },
+    { id: 'defi-insurance', name: 'DeFi Insurance', description: 'Analyze DeFi insurance options, coverage gaps, and premium optimization', category: 'defi' },
+    { id: 'contract-deploy-pro', name: 'Contract Deploy Pro', description: 'Deploy and verify smart contracts on Tempo L1 with gas optimization', category: 'deployment' },
+    { id: 'escrow-guardian', name: 'Escrow Guardian', description: 'Create and manage escrow transactions via NexusV2 smart contract', category: 'escrow' },
+    { id: 'shield-master', name: 'Shield Master', description: 'Execute ZK-shielded private payments via ShieldVaultV2', category: 'privacy' },
+    { id: 'multisend-pro', name: 'Multisend Pro', description: 'Batch send payments to multiple recipients via MultisendV2', category: 'payments' },
+    { id: 'stream-architect', name: 'Stream Architect', description: 'Create and manage milestone-based payment streams via StreamV1', category: 'streams' },
+    { id: 'proof-verifier', name: 'Proof Verifier', description: 'Verify AI execution proofs on-chain via AIProofRegistry', category: 'verification' },
+    { id: 'agent-coordinator', name: 'Agent Coordinator', description: 'Orchestrate multi-agent A2A workflows with dependency resolution', category: 'orchestration' },
+    { id: 'payroll-autopilot', name: 'Payroll Autopilot', description: 'Set up recurring automated payroll with conditional rules', category: 'payroll' },
+    { id: 'admin-dashboard', name: 'Admin Dashboard', description: 'Monitor protocol health, TVL, and agent performance metrics', category: 'admin' },
+];
+// ── Converters ───────────────────────────────────────────
+/**
+ * Convert PayPol agents to Anthropic tool-use definitions.
+ *
+ * @param client   AgentClient instance (used for dynamic agent list)
+ * @param agentIds Optional filter - only include these agent IDs
+ */
+async function toAnthropicTools(client, agentIds) {
+    let agents = AGENT_CATALOG;
+    if (client) {
+        try {
+            const live = await client.listAgents();
+            if (live.length > 0) {
+                agents = live.map(a => ({
+                    id: a.id,
+                    name: a.name,
+                    description: a.description,
+                    category: a.category,
+                }));
+            }
+        }
+        catch {
+            // Fall back to static catalog
+        }
+    }
+    if (agentIds) {
+        agents = agents.filter(a => agentIds.includes(a.id));
+    }
+    return agents.map(agent => ({
+        name: `paypol_${agent.id.replace(/-/g, '_')}`,
+        description: `[PayPol Agent] ${agent.name}: ${agent.description}`,
+        input_schema: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: `Task instruction for ${agent.name}. Be specific about what you want analyzed or executed.`,
+                },
+                payload: {
+                    type: 'string',
+                    description: 'Optional JSON string with additional structured data (e.g. contract source code, wallet addresses, parameters)',
+                },
+            },
+            required: ['prompt'],
+        },
+    }));
+}
+/**
+ * Handle an Anthropic tool use block by dispatching to the correct PayPol agent.
+ *
+ * @param client       AgentClient instance
+ * @param toolUse      The tool_use block from Claude's response
+ * @param callerWallet Wallet address of the caller
+ * @returns            AnthropicToolResult ready to send back in the conversation
+ */
+async function handleAnthropicToolUse(client, toolUse, callerWallet) {
+    const agentId = toolUse.name.replace('paypol_', '').replace(/_/g, '-');
+    const input = toolUse.input;
+    if (!input.prompt) {
+        return {
+            type: 'tool_result',
+            tool_use_id: toolUse.id,
+            content: JSON.stringify({ error: 'Missing required "prompt" parameter' }),
+        };
+    }
+    try {
+        const result = await client.hire(agentId, input.prompt, callerWallet, {
+            payload: input.payload ? JSON.parse(input.payload) : undefined,
+        });
+        return {
+            type: 'tool_result',
+            tool_use_id: toolUse.id,
+            content: JSON.stringify(result),
+        };
+    }
+    catch (err) {
+        return {
+            type: 'tool_result',
+            tool_use_id: toolUse.id,
+            content: JSON.stringify({ error: err.message || 'Agent execution failed' }),
+        };
+    }
+}
+/**
+ * Get the static agent catalog (no API call needed).
+ */
+function getAgentCatalog() {
+    return [...AGENT_CATALOG];
+}
+//# sourceMappingURL=anthropic.js.map