@agentxv2/sdk 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './core';
+export * from './agent';
+export * from './registry';
+export * from './subscription';
+export * from './a2a';
+export * from './mcp';
+export * from './reputation';
+export * from './config';
+export * from './react';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,32 @@
+// ---------------------------------------------------------------------------
+// agentx-protocol — Main Entry
+// ---------------------------------------------------------------------------
+// AgentX: Decentralized AI Agent Platform SDK
+//
+//   Agent = Prompt + Skills[] + MCP
+//
+// Quick start:
+//   import { AgentRunner } from 'agentx-protocol'
+//
+//   const runner = new AgentRunner({ reader, wallet })
+//   const ctx = await runner.useAgent(42)
+//   // ctx.prompt → inject as LLM system prompt
+//   // ctx.skills → inject as LLM tools
+//
+// Modules:
+//   agentx-protocol/core         — Types, AES-256-GCM + ECIES crypto
+//   agentx-protocol/registry     — Agent registration & discovery
+//   agentx-protocol/subscription  — Subscription purchase + AgentX402 gate
+//   agentx-protocol/a2a          — Agent-to-Agent protocol
+//   agentx-protocol/react        — React hooks (useAgent, etc.)
+// ---------------------------------------------------------------------------
+export * from './core';
+export * from './agent';
+export * from './registry';
+export * from './subscription';
+export * from './a2a';
+export * from './mcp';
+export * from './reputation';
+export * from './config';
+export * from './react';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAC9E,8CAA8C;AAC9C,EAAE;AACF,oCAAoC;AACpC,EAAE;AACF,eAAe;AACf,kDAAkD;AAClD,EAAE;AACF,uDAAuD;AACvD,0CAA0C;AAC1C,gDAAgD;AAChD,wCAAwC;AACxC,EAAE;AACF,WAAW;AACX,qEAAqE;AACrE,kEAAkE;AAClE,2EAA2E;AAC3E,2DAA2D;AAC3D,gEAAgE;AAChE,8EAA8E;AAE9E,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,OAAO,CAAA;AACrB,cAAc,OAAO,CAAA;AACrB,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA"}

package/dist/mcp/connector.d.ts

@@ -0,0 +1,43 @@
+import type { McpConnection } from '../core/types';
+export interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface MCPCallResult {
+    content: {
+        type: string;
+        text?: string;
+        data?: string;
+    }[];
+    isError?: boolean;
+}
+export interface MCPConnectorConfig {
+    /** MCP server base URL */
+    url: string;
+    /** Transport type */
+    transport?: 'http' | 'sse';
+    /** Auth header value (e.g. "Bearer xxx") */
+    authHeader?: string;
+    /** Request timeout in ms (default: 30_000) */
+    timeoutMs?: number;
+    /** Optional: subscriber address for subscription-gated MCP servers */
+    subscriberAddress?: string;
+    /** Optional: wallet signature for authentication */
+    signature?: string;
+    timestamp?: number;
+}
+export declare class MCPConnector {
+    private config;
+    constructor(config: MCPConnectorConfig);
+    /** Create from an Agent's McpConnection. */
+    static fromAgent(mcp: McpConnection, opts?: Partial<MCPConnectorConfig>): MCPConnector;
+    /** List available tools from the MCP server. */
+    listTools(): Promise<MCPTool[]>;
+    /** Call a tool on the MCP server. */
+    callTool(name: string, args?: Record<string, unknown>): Promise<MCPCallResult>;
+    listResources(): Promise<unknown[]>;
+    readResource(uri: string): Promise<unknown>;
+    private _request;
+}
+//# sourceMappingURL=connector.d.ts.map

package/dist/mcp/connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../src/mcp/connector.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAIlD,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,kBAAkB;IAItC,4CAA4C;IAC5C,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY;IAWtF,gDAAgD;IAC1C,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOrC,qCAAqC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAMlF,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKnC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAMnC,QAAQ;CAuCvB"}

package/dist/mcp/connector.js

@@ -0,0 +1,79 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — MCP Connector
+// ---------------------------------------------------------------------------
+// Minimal MCP (Model Context Protocol) client for HTTP/SSE transports.
+// Used by AgentRunner for Closed Skill remote execution.
+// ---------------------------------------------------------------------------
+// ── MCP Connector ──────────────────────────────────────────────────────────
+export class MCPConnector {
+    config;
+    constructor(config) {
+        this.config = { timeoutMs: 30_000, transport: 'http', ...config };
+    }
+    /** Create from an Agent's McpConnection. */
+    static fromAgent(mcp, opts) {
+        return new MCPConnector({
+            url: mcp.url ?? '',
+            transport: mcp.type === 'sse' ? 'sse' : 'http',
+            authHeader: mcp.authHeader,
+            ...opts,
+        });
+    }
+    // ── Tool Discovery ───────────────────────────────────────────────────────
+    /** List available tools from the MCP server. */
+    async listTools() {
+        const res = await this._request('tools/list', {});
+        return (res.tools ?? []);
+    }
+    // ── Tool Execution ───────────────────────────────────────────────────────
+    /** Call a tool on the MCP server. */
+    async callTool(name, args = {}) {
+        return this._request('tools/call', { name, arguments: args });
+    }
+    // ── Resources (optional) ─────────────────────────────────────────────────
+    async listResources() {
+        const res = await this._request('resources/list', {});
+        return (res.resources ?? []);
+    }
+    async readResource(uri) {
+        return this._request('resources/read', { uri });
+    }
+    // ── Internal ─────────────────────────────────────────────────────────────
+    async _request(method, params) {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.config.authHeader) {
+            headers['Authorization'] = this.config.authHeader;
+        }
+        if (this.config.subscriberAddress) {
+            headers['X-Subscriber-Address'] = this.config.subscriberAddress;
+        }
+        if (this.config.signature) {
+            headers['X-Signature'] = this.config.signature;
+        }
+        if (this.config.timestamp) {
+            headers['X-Timestamp'] = String(this.config.timestamp);
+        }
+        const res = await fetch(this.config.url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: Date.now(),
+                method,
+                params,
+            }),
+            signal: AbortSignal.timeout(this.config.timeoutMs ?? 30_000),
+        });
+        if (!res.ok) {
+            throw new Error(`MCP request failed: HTTP ${res.status}`);
+        }
+        const data = await res.json();
+        if (data.error) {
+            throw new Error(`MCP error: ${data.error.message}`);
+        }
+        return data.result ?? {};
+    }
+}
+//# sourceMappingURL=connector.js.map

package/dist/mcp/connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../src/mcp/connector.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAC9E,uEAAuE;AACvE,yDAAyD;AACzD,8EAA8E;AAiC9E,8EAA8E;AAE9E,MAAM,OAAO,YAAY;IACf,MAAM,CAAoB;IAElC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;IACnE,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,SAAS,CAAC,GAAkB,EAAE,IAAkC;QACrE,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;YAClB,SAAS,EAAE,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;YAC9C,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,GAAG,IAAI;SACR,CAAC,CAAA;IACJ,CAAC;IAED,4EAA4E;IAE5E,gDAAgD;IAChD,KAAK,CAAC,SAAS;QACb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAc,CAAA;IACvC,CAAC;IAED,4EAA4E;IAE5E,qCAAqC;IACrC,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAgC,EAAE;QAC7D,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAsC,CAAA;IACpG,CAAC;IAED,4EAA4E;IAE5E,KAAK,CAAC,aAAa;QACjB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;QACrD,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAc,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,GAAW;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;IACjD,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,MAA+B;QACpE,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3B,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAA;QACnD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClC,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAA;QACjE,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAA;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACxD,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;gBACd,MAAM;gBACN,MAAM;aACP,CAAC;YACF,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC;SAC7D,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAuE,CAAA;QAClG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACrD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,4 @@
+export { MCPConnector } from './connector';
+export type { MCPConnectorConfig, MCPTool, MCPCallResult } from './connector';
+export declare const MCP_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC7E,eAAO,MAAM,WAAW,UAAU,CAAA"}

package/dist/mcp/index.js

@@ -0,0 +1,4 @@
+// @agentx/sdk — MCP module
+export { MCPConnector } from './connector';
+export const MCP_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA"}

package/dist/react/index.d.ts

@@ -0,0 +1,4 @@
+export { useAgentRunner } from './useAgentRunner';
+export type { UseAgentRunnerConfig, UseAgentRunnerResult } from './useAgentRunner';
+export type { AgentRunContext, RunnableSkill, OnChainReader, WalletSigner } from '../agent/agent-runner';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAClF,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/react/index.js

@@ -0,0 +1,3 @@
+// @agentx/sdk — React Hooks
+export { useAgentRunner } from './useAgentRunner';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/react/useAgentRunner.d.ts

@@ -0,0 +1,16 @@
+import type { AgentRunContext } from '../agent/agent-runner';
+import type { ChainConfig } from '../config/config';
+export interface UseAgentRunnerConfig {
+    agentId: number;
+    chainConfig?: ChainConfig;
+    ipfsGateways?: string[];
+}
+export interface UseAgentRunnerResult {
+    ctx: AgentRunContext | null;
+    isLoading: boolean;
+    error: Error | null;
+    /** Re-trigger the load (e.g. after connecting wallet or subscribing) */
+    refetch: () => void;
+}
+export declare function useAgentRunner(config: UseAgentRunnerConfig): UseAgentRunnerResult;
+//# sourceMappingURL=useAgentRunner.d.ts.map

package/dist/react/useAgentRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAgentRunner.d.ts","sourceRoot":"","sources":["../../src/react/useAgentRunner.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,uBAAuB,CAAA;AAG3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAyCnD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,eAAe,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,wEAAwE;IACxE,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AA0ED,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAoGjF"}

package/dist/react/useAgentRunner.js

@@ -0,0 +1,204 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — useAgentRunner React Hook
+// ---------------------------------------------------------------------------
+// Wraps AgentRunner.useAgent() for React + wagmi integration.
+//
+//   const { ctx, isLoading, error } = useAgentRunner(agentId)
+//   // ctx.prompt → inject into LLM
+//   // ctx.skills → RunnableSkill[] with execute()
+//   // ctx.mcp    → MCP connection info
+// ---------------------------------------------------------------------------
+'use client';
+import { useState, useEffect, useRef } from 'react';
+import { usePublicClient, useWalletClient } from 'wagmi';
+import { AgentRunner } from '../agent/agent-runner';
+import { IPFSFetcher } from '../registry/ipfs-fetcher';
+import { KNOWN_CHAINS } from '../config/config';
+// ── IdentityRegistry ABI (minimal — only what useAgent needs) ──────────────
+const IDENTITY_REGISTRY_ABI = [
+    // getAgentMetadata returns MetadataEntry[] with key+value strings
+    {
+        name: 'getAgentMetadata',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        outputs: [
+            {
+                name: '',
+                type: 'tuple[]',
+                components: [
+                    { name: 'key', type: 'string' },
+                    { name: 'value', type: 'bytes' },
+                ],
+            },
+        ],
+    },
+];
+// ── SubscriptionManager ABI (minimal) ─────────────────────────────────────
+const SUBSCRIPTION_MANAGER_ABI = [
+    {
+        name: 'hasActiveSubscription',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'subscriber', type: 'address' },
+            { name: 'agentId', type: 'uint256' },
+        ],
+        outputs: [{ name: '', type: 'bool' }],
+    },
+];
+// ── OnChainReader Implementation (viem) ────────────────────────────────────
+class ViemOnChainReader {
+    publicClient;
+    chainConfig;
+    constructor(publicClient, chainConfig) {
+        this.publicClient = publicClient;
+        this.chainConfig = chainConfig;
+    }
+    async getTokenURI(_agentId) {
+        // tokenURI is standard ERC-721 metadata — not needed for our flow
+        // Metadata is fetched via getAgentMetadata
+        return '';
+    }
+    async getAttributes(agentId) {
+        if (!this.publicClient)
+            throw new Error('Public client not available');
+        const entries = (await this.publicClient.readContract({
+            address: this.chainConfig.contracts.identityRegistry,
+            abi: IDENTITY_REGISTRY_ABI,
+            functionName: 'getAgentMetadata',
+            args: [BigInt(agentId)],
+        }));
+        const attrs = {};
+        for (const entry of entries) {
+            // value is bytes — convert to string
+            const hexStr = entry.value;
+            if (hexStr && hexStr !== '0x') {
+                attrs[entry.key] = hexToStringUTF8(hexStr);
+            }
+            else {
+                attrs[entry.key] = '';
+            }
+        }
+        return attrs;
+    }
+    async hasActiveSubscription(address, agentId) {
+        if (!this.publicClient)
+            return false;
+        try {
+            return (await this.publicClient.readContract({
+                address: this.chainConfig.contracts.subscriptionManager,
+                abi: SUBSCRIPTION_MANAGER_ABI,
+                functionName: 'hasActiveSubscription',
+                args: [address, BigInt(agentId)],
+            }));
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function hexToStringUTF8(hex) {
+    if (!hex.startsWith('0x'))
+        return hex;
+    const hexClean = hex.slice(2);
+    if (hexClean.length === 0)
+        return '';
+    try {
+        const bytes = new Uint8Array(hexClean.length / 2);
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = parseInt(hexClean.substring(i * 2, i * 2 + 2), 16);
+        }
+        return new TextDecoder().decode(bytes);
+    }
+    catch {
+        return hex;
+    }
+}
+// ── Hook ───────────────────────────────────────────────────────────────────
+export function useAgentRunner(config) {
+    const { agentId, chainConfig: chainConfigOverride, ipfsGateways } = config;
+    const publicClient = usePublicClient();
+    const { data: walletClient } = useWalletClient();
+    const [ctx, setCtx] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [refetchKey, setRefetchKey] = useState(0);
+    const runnerRef = useRef(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    useEffect(() => {
+        if (!publicClient || !walletClient) {
+            setError(new Error('Wallet not connected'));
+            return;
+        }
+        const chainConfig = chainConfigOverride ?? (publicClient.chain?.id ? KNOWN_CHAINS[publicClient.chain.id] : undefined);
+        if (!chainConfig) {
+            setError(new Error(`Chain ${publicClient.chain?.id} not supported`));
+            return;
+        }
+        // Create OnChainReader
+        const reader = new ViemOnChainReader(publicClient, chainConfig);
+        // WalletSigner from wagmi
+        const signer = {
+            async signMessage(message) {
+                if (!walletClient.account)
+                    throw new Error('Wallet not connected');
+                return walletClient.signMessage({ account: walletClient.account, message });
+            },
+            async getAddress() {
+                if (!walletClient.account)
+                    throw new Error('Wallet not connected');
+                return walletClient.account.address;
+            },
+            async getPrivateKey() {
+                // wagmi walletClient doesn't expose private key
+                // ECIES decryption requires private key — must be injected from wallet provider
+                throw new Error('Private key not available via wagmi. ' +
+                    'Use window.ethereum.request({ method: "eth_private_key" }) or inject getPrivateKey via custom WalletSigner.');
+            },
+        };
+        // IPFS Fetcher
+        const ipfsFetcher = new IPFSFetcher({
+            fallbackGateways: ipfsGateways ?? chainConfig.ipfsGateways ?? [
+                'gateway.pinata.cloud',
+                'dweb.link',
+                'cf-ipfs.com',
+            ],
+        });
+        runnerRef.current = new AgentRunner({
+            reader,
+            wallet: signer,
+            ipfsFetcher,
+        });
+        setIsLoading(true);
+        setError(null);
+        runnerRef.current
+            .useAgent(agentId)
+            .then(result => {
+            if (mountedRef.current) {
+                setCtx(result);
+                setIsLoading(false);
+            }
+        })
+            .catch(err => {
+            if (mountedRef.current) {
+                setError(err instanceof Error ? err : new Error(String(err)));
+                setIsLoading(false);
+            }
+        });
+        return () => {
+            mountedRef.current = false;
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [agentId, publicClient?.chain?.id, publicClient, walletClient, refetchKey]);
+    const refetch = () => setRefetchKey(k => k + 1);
+    return { ctx, isLoading, error, refetch };
+}
+//# sourceMappingURL=useAgentRunner.js.map

package/dist/react/useAgentRunner.js.map

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

package/dist/registry/agent-registry.d.ts

@@ -0,0 +1,52 @@
+import type { PublicClient, WalletClient, Address, Hash } from 'viem';
+export interface AgentRegistryConfig {
+    /** IdentityRegistry contract address */
+    contractAddress: Address;
+    /** viem PublicClient for read calls */
+    publicClient: PublicClient;
+    /** viem WalletClient for write calls */
+    walletClient: WalletClient;
+}
+export declare class AgentRegistry {
+    private address;
+    private publicClient;
+    private walletClient;
+    constructor(config: AgentRegistryConfig);
+    /**
+     * Register a new Agent NFT on-chain.
+     *
+     * @param tokenURI    IPFS URI of the public metadata (ipfs://...)
+     * @param metadata    Key-value metadata (encryptedPayloadCid, eciesEncryptedKey, etc.)
+     * @param valueWei    Optional: native currency to send with registration
+     * @returns           { agentId: number, txHash: Hash }
+     */
+    register(tokenURI: string, metadata: {
+        key: string;
+        value: string;
+    }[], valueWei?: bigint): Promise<{
+        agentId: number;
+        txHash: Hash;
+    }>;
+    /**
+     * Simple register — just a tokenURI, no extra metadata.
+     */
+    registerSimple(tokenURI: string, valueWei?: bigint): Promise<{
+        agentId: number;
+        txHash: Hash;
+    }>;
+    /** Get all agent IDs owned by an address. */
+    getAgentsByOwner(owner: Address): Promise<number[]>;
+    /** Get the current total agent count. */
+    getCurrentAgentId(): Promise<number>;
+    /** Check if an agent exists. */
+    agentExists(agentId: number): Promise<boolean>;
+    /** Get the tokenURI for an agent. */
+    tokenURI(agentId: number): Promise<string>;
+    /** Get all metadata attributes for an agent as key-value pairs. */
+    getAttributes(agentId: number): Promise<Record<string, string>>;
+    /** Extract tokenId from the Transfer event in the receipt. */
+    private _parseAgentIdFromReceipt;
+}
+/** Extract IPFS CID from an ipfs:// URI. */
+export declare function cidFromURI(uri: string): string;
+//# sourceMappingURL=agent-registry.d.ts.map

package/dist/registry/agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-registry.d.ts","sourceRoot":"","sources":["../../src/registry/agent-registry.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AA8ErE,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,eAAe,EAAE,OAAO,CAAA;IACxB,uCAAuC;IACvC,YAAY,EAAE,YAAY,CAAA;IAC1B,wCAAwC;IACxC,YAAY,EAAE,YAAY,CAAA;CAC3B;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;gBAEtB,MAAM,EAAE,mBAAmB;IAQvC;;;;;;;OAOG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,EAC1C,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC;IA0B7C;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC;IA2BrG,6CAA6C;IACvC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUzD,yCAAyC;IACnC,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1C,gCAAgC;IAC1B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUpD,qCAAqC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhD,mEAAmE;IAC7D,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAgBrE,8DAA8D;IAC9D,OAAO,CAAC,wBAAwB;CAUjC;AAID,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C"}