@agentxv2/sdk 0.5.2 → 0.5.3

package/dist/endpoint/index.js

@@ -0,0 +1,193 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/endpoint/index.ts
+var endpoint_exports = {};
+__export(endpoint_exports, {
+  MultiEndpointClient: () => MultiEndpointClient
+});
+module.exports = __toCommonJS(endpoint_exports);
+
+// src/endpoint/multi-endpoint.ts
+var ABI = [
+  {
+    name: "getActiveAgentEndpoints",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getAgentEndpoints",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "createEndpoint",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "name", type: "string" },
+      { name: "endpointType", type: "string" },
+      { name: "protocol", type: "string" },
+      { name: "url", type: "string" },
+      { name: "description", type: "string" }
+    ],
+    outputs: [{ name: "endpointId", type: "uint256" }]
+  },
+  {
+    name: "getEndpoint",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "endpointId", type: "uint256" }],
+    outputs: [{
+      type: "tuple",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getSupportedProtocols",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ type: "string[]" }]
+  },
+  {
+    name: "getAgentEndpointStats",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [
+      { name: "totalEndpoints", type: "uint256" },
+      { name: "activeEndpoints", type: "uint256" },
+      { name: "httpEndpoints", type: "uint256" },
+      { name: "websocketEndpoints", type: "uint256" },
+      { name: "grpcEndpoints", type: "uint256" }
+    ]
+  }
+];
+var MultiEndpointClient = class {
+  address;
+  publicClient;
+  constructor(config, publicClient) {
+    this.address = config.address;
+    this.publicClient = publicClient ?? null;
+  }
+  setPublicClient(client) {
+    this.publicClient = client;
+  }
+  async getActiveEndpoints(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getActiveAgentEndpoints",
+      args: [agentId]
+    });
+  }
+  async getAllEndpoints(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentEndpoints",
+      args: [agentId]
+    });
+  }
+  async getEndpoint(endpointId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getEndpoint",
+      args: [endpointId]
+    });
+  }
+  async getStats(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentEndpointStats",
+      args: [agentId]
+    });
+  }
+  /** Pick best active endpoint for the agent — prefer HTTP, take first active */
+  async pickBestEndpoint(agentId) {
+    const endpoints = await this.getActiveEndpoints(agentId);
+    if (endpoints.length === 0) return null;
+    const http = endpoints.find((e) => e.protocol === "HTTP");
+    return http ?? endpoints[0] ?? null;
+  }
+  /** Pick any active endpoint URL — for MCP connector */
+  async getBestMCPUrl(agentId) {
+    const best = await this.pickBestEndpoint(agentId);
+    return best?.url ?? null;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MultiEndpointClient
+});
+//# sourceMappingURL=index.js.map

package/dist/endpoint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoint/index.ts","../../src/endpoint/multi-endpoint.ts"],"sourcesContent":["export * from './multi-endpoint'\n","/**\n * MultiEndpointRegistry SDK\n * OxaChain L1 + Sepolia — multi-endpoint management for AI Agents\n */\nimport { type PublicClient, type WalletClient, type Address, type Hash, type Chain } from 'viem'\n\nexport interface EndpointRecord {\n  endpointId: bigint\n  agentId: bigint\n  name: string\n  endpointType: string\n  protocol: string\n  url: string\n  description: string\n  isActive: boolean\n  createdAt: bigint\n  updatedAt: bigint\n  createdBy: Address\n}\n\nexport interface MultiEndpointConfig {\n  address: Address\n}\n\nconst ABI = [\n  {\n    name: 'getActiveAgentEndpoints',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple[]',\n      components: [\n        { name: 'endpointId', type: 'uint256' },\n        { name: 'agentId', type: 'uint256' },\n        { name: 'name', type: 'string' },\n        { name: 'endpointType', type: 'string' },\n        { name: 'protocol', type: 'string' },\n        { name: 'url', type: 'string' },\n        { name: 'description', type: 'string' },\n        { name: 'isActive', type: 'bool' },\n        { name: 'createdAt', type: 'uint256' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'createdBy', type: 'address' },\n      ]\n    }],\n  },\n  {\n    name: 'getAgentEndpoints',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple[]',\n      components: [\n        { name: 'endpointId', type: 'uint256' },\n        { name: 'agentId', type: 'uint256' },\n        { name: 'name', type: 'string' },\n        { name: 'endpointType', type: 'string' },\n        { name: 'protocol', type: 'string' },\n        { name: 'url', type: 'string' },\n        { name: 'description', type: 'string' },\n        { name: 'isActive', type: 'bool' },\n        { name: 'createdAt', type: 'uint256' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'createdBy', type: 'address' },\n      ]\n    }],\n  },\n  {\n    name: 'createEndpoint',\n    type: 'function',\n    stateMutability: 'nonpayable',\n    inputs: [\n      { name: 'agentId', type: 'uint256' },\n      { name: 'name', type: 'string' },\n      { name: 'endpointType', type: 'string' },\n      { name: 'protocol', type: 'string' },\n      { name: 'url', type: 'string' },\n      { name: 'description', type: 'string' },\n    ],\n    outputs: [{ name: 'endpointId', type: 'uint256' }],\n  },\n  {\n    name: 'getEndpoint',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'endpointId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple',\n      components: [\n        { name: 'endpointId', type: 'uint256' },\n        { name: 'agentId', type: 'uint256' },\n        { name: 'name', type: 'string' },\n        { name: 'endpointType', type: 'string' },\n        { name: 'protocol', type: 'string' },\n        { name: 'url', type: 'string' },\n        { name: 'description', type: 'string' },\n        { name: 'isActive', type: 'bool' },\n        { name: 'createdAt', type: 'uint256' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'createdBy', type: 'address' },\n      ]\n    }],\n  },\n  {\n    name: 'getSupportedProtocols',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [],\n    outputs: [{ type: 'string[]' }],\n  },\n  {\n    name: 'getAgentEndpointStats',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [\n      { name: 'totalEndpoints', type: 'uint256' },\n      { name: 'activeEndpoints', type: 'uint256' },\n      { name: 'httpEndpoints', type: 'uint256' },\n      { name: 'websocketEndpoints', type: 'uint256' },\n      { name: 'grpcEndpoints', type: 'uint256' },\n    ],\n  },\n] as const\n\nexport class MultiEndpointClient {\n  private address: Address\n  private publicClient: PublicClient | null\n\n  constructor(config: MultiEndpointConfig, publicClient?: PublicClient) {\n    this.address = config.address\n    this.publicClient = publicClient ?? null\n  }\n\n  setPublicClient(client: PublicClient) {\n    this.publicClient = client\n  }\n\n  async getActiveEndpoints(agentId: bigint): Promise<EndpointRecord[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getActiveAgentEndpoints',\n      args: [agentId],\n    })) as EndpointRecord[]\n  }\n\n  async getAllEndpoints(agentId: bigint): Promise<EndpointRecord[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getAgentEndpoints',\n      args: [agentId],\n    })) as EndpointRecord[]\n  }\n\n  async getEndpoint(endpointId: bigint): Promise<EndpointRecord> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getEndpoint',\n      args: [endpointId],\n    })) as EndpointRecord\n  }\n\n  async getStats(agentId: bigint) {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getAgentEndpointStats',\n      args: [agentId],\n    })) as [bigint, bigint, bigint, bigint, bigint]\n  }\n\n  /** Pick best active endpoint for the agent — prefer HTTP, take first active */\n  async pickBestEndpoint(agentId: bigint): Promise<EndpointRecord | null> {\n    const endpoints = await this.getActiveEndpoints(agentId)\n    if (endpoints.length === 0) return null\n    // prefer HTTP endpoints\n    const http = endpoints.find(e => e.protocol === 'HTTP')\n    return http ?? endpoints[0] ?? null\n  }\n\n  /** Pick any active endpoint URL — for MCP connector */\n  async getBestMCPUrl(agentId: bigint): Promise<string | null> {\n    const best = await this.pickBestEndpoint(agentId)\n    return best?.url ?? null\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/endpoint/index.mjs

@@ -0,0 +1,166 @@
+// src/endpoint/multi-endpoint.ts
+var ABI = [
+  {
+    name: "getActiveAgentEndpoints",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getAgentEndpoints",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [{
+      type: "tuple[]",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "createEndpoint",
+    type: "function",
+    stateMutability: "nonpayable",
+    inputs: [
+      { name: "agentId", type: "uint256" },
+      { name: "name", type: "string" },
+      { name: "endpointType", type: "string" },
+      { name: "protocol", type: "string" },
+      { name: "url", type: "string" },
+      { name: "description", type: "string" }
+    ],
+    outputs: [{ name: "endpointId", type: "uint256" }]
+  },
+  {
+    name: "getEndpoint",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "endpointId", type: "uint256" }],
+    outputs: [{
+      type: "tuple",
+      components: [
+        { name: "endpointId", type: "uint256" },
+        { name: "agentId", type: "uint256" },
+        { name: "name", type: "string" },
+        { name: "endpointType", type: "string" },
+        { name: "protocol", type: "string" },
+        { name: "url", type: "string" },
+        { name: "description", type: "string" },
+        { name: "isActive", type: "bool" },
+        { name: "createdAt", type: "uint256" },
+        { name: "updatedAt", type: "uint256" },
+        { name: "createdBy", type: "address" }
+      ]
+    }]
+  },
+  {
+    name: "getSupportedProtocols",
+    type: "function",
+    stateMutability: "view",
+    inputs: [],
+    outputs: [{ type: "string[]" }]
+  },
+  {
+    name: "getAgentEndpointStats",
+    type: "function",
+    stateMutability: "view",
+    inputs: [{ name: "agentId", type: "uint256" }],
+    outputs: [
+      { name: "totalEndpoints", type: "uint256" },
+      { name: "activeEndpoints", type: "uint256" },
+      { name: "httpEndpoints", type: "uint256" },
+      { name: "websocketEndpoints", type: "uint256" },
+      { name: "grpcEndpoints", type: "uint256" }
+    ]
+  }
+];
+var MultiEndpointClient = class {
+  address;
+  publicClient;
+  constructor(config, publicClient) {
+    this.address = config.address;
+    this.publicClient = publicClient ?? null;
+  }
+  setPublicClient(client) {
+    this.publicClient = client;
+  }
+  async getActiveEndpoints(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getActiveAgentEndpoints",
+      args: [agentId]
+    });
+  }
+  async getAllEndpoints(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentEndpoints",
+      args: [agentId]
+    });
+  }
+  async getEndpoint(endpointId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getEndpoint",
+      args: [endpointId]
+    });
+  }
+  async getStats(agentId) {
+    if (!this.publicClient) throw new Error("publicClient not set");
+    return await this.publicClient.readContract({
+      address: this.address,
+      abi: ABI,
+      functionName: "getAgentEndpointStats",
+      args: [agentId]
+    });
+  }
+  /** Pick best active endpoint for the agent — prefer HTTP, take first active */
+  async pickBestEndpoint(agentId) {
+    const endpoints = await this.getActiveEndpoints(agentId);
+    if (endpoints.length === 0) return null;
+    const http = endpoints.find((e) => e.protocol === "HTTP");
+    return http ?? endpoints[0] ?? null;
+  }
+  /** Pick any active endpoint URL — for MCP connector */
+  async getBestMCPUrl(agentId) {
+    const best = await this.pickBestEndpoint(agentId);
+    return best?.url ?? null;
+  }
+};
+export {
+  MultiEndpointClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/endpoint/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/endpoint/multi-endpoint.ts"],"sourcesContent":["/**\n * MultiEndpointRegistry SDK\n * OxaChain L1 + Sepolia — multi-endpoint management for AI Agents\n */\nimport { type PublicClient, type WalletClient, type Address, type Hash, type Chain } from 'viem'\n\nexport interface EndpointRecord {\n  endpointId: bigint\n  agentId: bigint\n  name: string\n  endpointType: string\n  protocol: string\n  url: string\n  description: string\n  isActive: boolean\n  createdAt: bigint\n  updatedAt: bigint\n  createdBy: Address\n}\n\nexport interface MultiEndpointConfig {\n  address: Address\n}\n\nconst ABI = [\n  {\n    name: 'getActiveAgentEndpoints',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple[]',\n      components: [\n        { name: 'endpointId', type: 'uint256' },\n        { name: 'agentId', type: 'uint256' },\n        { name: 'name', type: 'string' },\n        { name: 'endpointType', type: 'string' },\n        { name: 'protocol', type: 'string' },\n        { name: 'url', type: 'string' },\n        { name: 'description', type: 'string' },\n        { name: 'isActive', type: 'bool' },\n        { name: 'createdAt', type: 'uint256' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'createdBy', type: 'address' },\n      ]\n    }],\n  },\n  {\n    name: 'getAgentEndpoints',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple[]',\n      components: [\n        { name: 'endpointId', type: 'uint256' },\n        { name: 'agentId', type: 'uint256' },\n        { name: 'name', type: 'string' },\n        { name: 'endpointType', type: 'string' },\n        { name: 'protocol', type: 'string' },\n        { name: 'url', type: 'string' },\n        { name: 'description', type: 'string' },\n        { name: 'isActive', type: 'bool' },\n        { name: 'createdAt', type: 'uint256' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'createdBy', type: 'address' },\n      ]\n    }],\n  },\n  {\n    name: 'createEndpoint',\n    type: 'function',\n    stateMutability: 'nonpayable',\n    inputs: [\n      { name: 'agentId', type: 'uint256' },\n      { name: 'name', type: 'string' },\n      { name: 'endpointType', type: 'string' },\n      { name: 'protocol', type: 'string' },\n      { name: 'url', type: 'string' },\n      { name: 'description', type: 'string' },\n    ],\n    outputs: [{ name: 'endpointId', type: 'uint256' }],\n  },\n  {\n    name: 'getEndpoint',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'endpointId', type: 'uint256' }],\n    outputs: [{\n      type: 'tuple',\n      components: [\n        { name: 'endpointId', type: 'uint256' },\n        { name: 'agentId', type: 'uint256' },\n        { name: 'name', type: 'string' },\n        { name: 'endpointType', type: 'string' },\n        { name: 'protocol', type: 'string' },\n        { name: 'url', type: 'string' },\n        { name: 'description', type: 'string' },\n        { name: 'isActive', type: 'bool' },\n        { name: 'createdAt', type: 'uint256' },\n        { name: 'updatedAt', type: 'uint256' },\n        { name: 'createdBy', type: 'address' },\n      ]\n    }],\n  },\n  {\n    name: 'getSupportedProtocols',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [],\n    outputs: [{ type: 'string[]' }],\n  },\n  {\n    name: 'getAgentEndpointStats',\n    type: 'function',\n    stateMutability: 'view',\n    inputs: [{ name: 'agentId', type: 'uint256' }],\n    outputs: [\n      { name: 'totalEndpoints', type: 'uint256' },\n      { name: 'activeEndpoints', type: 'uint256' },\n      { name: 'httpEndpoints', type: 'uint256' },\n      { name: 'websocketEndpoints', type: 'uint256' },\n      { name: 'grpcEndpoints', type: 'uint256' },\n    ],\n  },\n] as const\n\nexport class MultiEndpointClient {\n  private address: Address\n  private publicClient: PublicClient | null\n\n  constructor(config: MultiEndpointConfig, publicClient?: PublicClient) {\n    this.address = config.address\n    this.publicClient = publicClient ?? null\n  }\n\n  setPublicClient(client: PublicClient) {\n    this.publicClient = client\n  }\n\n  async getActiveEndpoints(agentId: bigint): Promise<EndpointRecord[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getActiveAgentEndpoints',\n      args: [agentId],\n    })) as EndpointRecord[]\n  }\n\n  async getAllEndpoints(agentId: bigint): Promise<EndpointRecord[]> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getAgentEndpoints',\n      args: [agentId],\n    })) as EndpointRecord[]\n  }\n\n  async getEndpoint(endpointId: bigint): Promise<EndpointRecord> {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getEndpoint',\n      args: [endpointId],\n    })) as EndpointRecord\n  }\n\n  async getStats(agentId: bigint) {\n    if (!this.publicClient) throw new Error('publicClient not set')\n    return (await this.publicClient.readContract({\n      address: this.address,\n      abi: ABI,\n      functionName: 'getAgentEndpointStats',\n      args: [agentId],\n    })) as [bigint, bigint, bigint, bigint, bigint]\n  }\n\n  /** Pick best active endpoint for the agent — prefer HTTP, take first active */\n  async pickBestEndpoint(agentId: bigint): Promise<EndpointRecord | null> {\n    const endpoints = await this.getActiveEndpoints(agentId)\n    if (endpoints.length === 0) return null\n    // prefer HTTP endpoints\n    const http = endpoints.find(e => e.protocol === 'HTTP')\n    return http ?? endpoints[0] ?? null\n  }\n\n  /** Pick any active endpoint URL — for MCP connector */\n  async getBestMCPUrl(agentId: bigint): Promise<string | null> {\n    const best = await this.pickBestEndpoint(agentId)\n    return best?.url ?? null\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index-BlD1-fQt.d.mts

@@ -0,0 +1,209 @@
+import { E as EncryptedPayload, g as AgentPayload, P as PackResult } from './types-2aHUvS4M.mjs';
+import { Address, PublicClient, WalletClient, Hash } from 'viem';
+
+interface IPFSFetcherConfig {
+    /** Primary IPFS gateway (default: ipfs.io) */
+    gateway?: string;
+    /** Fallback gateways in order of preference */
+    fallbackGateways?: string[];
+    /** Request timeout in ms (default: 10_000) */
+    timeoutMs?: number;
+    /** Max cached entries (LRU-like eviction, default: 200) */
+    maxCache?: number;
+}
+declare class IPFSFetcher {
+    private gateway;
+    private fallbackGateways;
+    private timeoutMs;
+    private cache;
+    private maxCache;
+    private pending;
+    private failed;
+    constructor(config?: IPFSFetcherConfig);
+    /** Fetch JSON from a single IPFS CID. */
+    fetchJSON<T = unknown>(cid: string): Promise<T>;
+    /** Fetch encrypted agent payload (validates algorithm). */
+    fetchEncryptedPayload(cid: string): Promise<EncryptedPayload>;
+    /** Batch fetch multiple CIDs with concurrency control. */
+    fetchBatch<T = unknown>(cids: string[], concurrency?: number): Promise<Map<string, T>>;
+    /** Check if a string looks like a valid IPFS CID. */
+    isValidCID(cid: string): boolean;
+    /** Clear cache (optionally for a specific CID). */
+    clearCache(cid?: string): void;
+    /** Number of cached entries. */
+    get cacheSize(): number;
+    private _doFetch;
+    private _fetchFrom;
+    private _cacheSet;
+}
+/** Singleton-friendly default instance. */
+declare const defaultIPFSFetcher: IPFSFetcher;
+
+/** Minimal on-chain reader interface — implement with viem. */
+interface OnChainReader {
+    /** Read tokenURI from IdentityRegistry by tokenId. */
+    getTokenURI(agentId: number): Promise<string>;
+    /** Get agent metadata attributes (returned as key-value pairs). */
+    getAttributes(agentId: number): Promise<Record<string, string>>;
+    /** Check if `address` has an active subscription for `agentId`. */
+    hasActiveSubscription(address: string, agentId: number): Promise<boolean>;
+}
+/** Minimal wallet signer interface — implement with wagmi/viem. */
+interface WalletSigner {
+    /** Sign a message (for authentication to MCP servers). */
+    signMessage(message: string): Promise<string>;
+    /** Get the current wallet address. */
+    getAddress(): Promise<string>;
+    /** Get the wallet's ECDSA private key (required for ECIES decryption). */
+    getPrivateKey?(): Promise<string>;
+}
+interface AgentRunnerConfig {
+    /** On-chain data reader (injected from viem/wagmi). */
+    reader: OnChainReader;
+    /** Wallet signer (injected from wagmi). */
+    wallet: WalletSigner;
+    /** IPFS fetcher instance (creates default if omitted). */
+    ipfsFetcher?: IPFSFetcher;
+    /** IPFS gateway list (overrides IPFSFetcher defaults). */
+    ipfsGateways?: string[];
+}
+interface AgentRunContext {
+    /** Agent NFT token ID */
+    agentId: number;
+    /** System prompt — inject into LLM conversation */
+    prompt: string;
+    /** All skills with execution metadata */
+    skills: RunnableSkill[];
+    /** MCP connection info */
+    mcp: {
+        type: string;
+        url?: string;
+        toolFilter?: string[];
+    };
+    /** Subscription expiry timestamp (0 = unknown) */
+    subscriptionExpiry: number;
+}
+interface RunnableSkill {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    /** Execution mode */
+    mode: 'open' | 'mcp' | 'a2a';
+    /** If mode='a2a', the on-chain Agent ID being delegated to */
+    a2aTargetAgentId?: number;
+    /**
+     * Execute this skill with the given input.
+     * - Open: runs locally (caller provides implementation)
+     * - MCP: POSTs to the publisher's MCP server
+     * - A2A: loads target Agent context (prompt+skills) via AgentRunner
+     */
+    execute(input: Record<string, unknown>): Promise<unknown>;
+}
+/**
+ * Standard return type for A2A skill execution.
+ * The calling LLM receives the sub-Agent's prompt and skills
+ * and can inject them into the conversation.
+ */
+interface A2ASkillResult {
+    /** On-chain Agent ID that was delegated to */
+    agentId: number;
+    /** Sub-Agent's decrypted system prompt */
+    prompt: string;
+    /** Sub-Agent's skills (name + description + schema only, no execute) */
+    skills: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+    }[];
+    /** The original input passed by the caller */
+    callerInput: Record<string, unknown>;
+}
+declare class AgentRunner {
+    private reader;
+    private wallet;
+    private ipfs;
+    constructor(config: AgentRunnerConfig);
+    /**
+     * Load and decrypt an Agent, returning a run context ready to inject
+     * into any LLM conversation.
+     *
+     * Steps:
+     *   1. Verify on-chain subscription (frontend check)
+     *   2. Fetch metadata → get encryptedPayloadCid + eciesEncryptedKey
+     *   3. IPFS fetch encrypted payload
+     *   4. ECIES decrypt AES key (using wallet private key)
+     *   5. AES-256-GCM decrypt payload → { prompt, skills, mcp }
+     *   6. Build RunnableSkill wrappers (Open: local stub, Closed: MCP remote)
+     */
+    useAgent(agentId: number): Promise<AgentRunContext>;
+    /**
+     * Pack an AgentPayload for publishing (encryption only, no IPFS upload).
+     * Caller is responsible for IPFS upload and on-chain registration.
+     */
+    packForPublish(payload: AgentPayload, publicKey: string): PackResult;
+    /** Wrap a SkillDef into a RunnableSkill with execute(). */
+    private _wrapSkill;
+    /** Call a tool on the publisher's MCP server (Closed skill). */
+    private _executeMCPTool;
+    /**
+     * Execute an A2A skill — delegate to another AgentX Agent.
+     *
+     * Standard Interface:
+     *   Input:  { task, ...taskSpecificParams }
+     *   Output: { agentId, prompt, skills[] }
+     *
+     * The caller (LLM) receives the sub-Agent's prompt + skill list.
+     * The LLM then decides how to use the sub-Agent — typically by
+     * injecting the sub-Agent's system prompt and calling its skills.
+     */
+    private _executeA2ASkill;
+    private _getPrivateKey;
+}
+
+interface ChainConfig {
+    chainId: number;
+    contracts: {
+        identityRegistry: Address;
+        subscriptionManager: Address;
+        paymentGateway: Address;
+        a2aProtocolRegistry: Address;
+        reputationRegistry: Address;
+        configurationRegistry: Address;
+        multiEndpointRegistry: Address;
+    };
+    ipfsGateways: string[];
+    rpcUrl?: string;
+}
+declare const KNOWN_CHAINS: Record<number, ChainConfig>;
+interface ConfigRegistryOpts {
+    contractAddress: Address;
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+}
+declare class ConfigurationRegistry {
+    private address;
+    private publicClient;
+    private walletClient;
+    constructor(opts: ConfigRegistryOpts);
+    private get account();
+    set(key: string, value: string): Promise<Hash>;
+    get(key: string): Promise<string>;
+    getAll(): Promise<Record<string, string>>;
+}
+
+interface UseAgentRunnerConfig {
+    agentId: number;
+    chainConfig?: ChainConfig;
+    ipfsGateways?: string[];
+}
+interface UseAgentRunnerResult {
+    ctx: AgentRunContext | null;
+    isLoading: boolean;
+    error: Error | null;
+    /** Re-trigger the load (e.g. after connecting wallet or subscribing) */
+    refetch: () => void;
+}
+declare function useAgentRunner(config: UseAgentRunnerConfig): UseAgentRunnerResult;
+
+export { type A2ASkillResult as A, type ChainConfig as C, IPFSFetcher as I, KNOWN_CHAINS as K, type OnChainReader as O, type RunnableSkill as R, type UseAgentRunnerConfig as U, type WalletSigner as W, type AgentRunContext as a, AgentRunner as b, type AgentRunnerConfig as c, type ConfigRegistryOpts as d, ConfigurationRegistry as e, type IPFSFetcherConfig as f, type UseAgentRunnerResult as g, defaultIPFSFetcher as h, useAgentRunner as u };