@agentxv2/sdk 0.3.0

package/dist/registry/agent-registry.js

@@ -0,0 +1,221 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — Agent Registry
+// ---------------------------------------------------------------------------
+// Wraps IdentityRegistry contract interactions (on-chain agent CRUD).
+//
+// Design:
+//   - Takes a viem PublicClient + WalletClient (chain-agnostic).
+//   - No wagmi dependency — works with any wallet provider that implements
+//     the WalletClient interface.
+//   - Methods match the existing ERC8004 IdentityRegistry ABI.
+// ---------------------------------------------------------------------------
+import { stringToHex, hexToString } from 'viem';
+// ── Minimal ABI Fragments ──────────────────────────────────────────────────
+const IDENTITY_REGISTRY_ABI = {
+    // Register
+    register: {
+        inputs: [],
+        name: 'register',
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    registerWithTokenURI: {
+        inputs: [{ name: 'tokenURI', type: 'string' }],
+        name: 'register',
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    registerWithMetadata: {
+        inputs: [
+            { name: 'tokenURI', type: 'string' },
+            {
+                name: 'metadata',
+                type: 'tuple[]',
+                components: [
+                    { name: 'key', type: 'string' },
+                    { name: 'value', type: 'bytes' },
+                ],
+            },
+        ],
+        name: 'registerWithMetadata',
+        outputs: [{ name: 'agentId', type: 'uint256' }],
+        stateMutability: 'payable',
+        type: 'function',
+    },
+    // Queries
+    getAgentsByOwner: {
+        inputs: [{ name: 'owner', type: 'address' }],
+        name: 'getAgentsByOwner',
+        outputs: [{ name: '', type: 'uint256[]' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    getCurrentAgentId: {
+        inputs: [],
+        name: 'getCurrentAgentId',
+        outputs: [{ name: '', type: 'uint256' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    agentExists: {
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        name: 'agentExists',
+        outputs: [{ name: '', type: 'bool' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    tokenURI: {
+        inputs: [{ name: 'tokenId', type: 'uint256' }],
+        name: 'tokenURI',
+        outputs: [{ name: '', type: 'string' }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    getAgentMetadata: {
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        name: 'getAgentMetadata',
+        outputs: [{ name: '', type: 'tuple[]', components: [{ name: 'key', type: 'string' }, { name: 'value', type: 'bytes' }] }],
+        stateMutability: 'view',
+        type: 'function',
+    },
+};
+// ── Agent Registry ─────────────────────────────────────────────────────────
+export class AgentRegistry {
+    address;
+    publicClient;
+    walletClient;
+    constructor(config) {
+        this.address = config.contractAddress;
+        this.publicClient = config.publicClient;
+        this.walletClient = config.walletClient;
+    }
+    // ── Write: Register Agent ───────────────────────────────────────────────
+    /**
+     * 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 }
+     */
+    async register(tokenURI, metadata, valueWei) {
+        const [account] = await this.walletClient.getAddresses();
+        if (!account)
+            throw new Error('Wallet not connected');
+        const encodedMetadata = metadata.map(m => ({
+            key: m.key,
+            value: stringToHex(m.value),
+        }));
+        const { request } = await this.publicClient.simulateContract({
+            account,
+            address: this.address,
+            abi: [IDENTITY_REGISTRY_ABI.registerWithMetadata],
+            functionName: 'registerWithMetadata',
+            args: [tokenURI, encodedMetadata],
+            value: valueWei,
+        });
+        const hash = await this.walletClient.writeContract(request);
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+        // Parse agentId from Transfer event (ERC-721)
+        const agentId = this._parseAgentIdFromReceipt(receipt);
+        return { agentId, txHash: hash };
+    }
+    /**
+     * Simple register — just a tokenURI, no extra metadata.
+     */
+    async registerSimple(tokenURI, valueWei) {
+        const [account] = await this.walletClient.getAddresses();
+        if (!account)
+            throw new Error('Wallet not connected');
+        const abi = tokenURI
+            ? [IDENTITY_REGISTRY_ABI.registerWithTokenURI]
+            : [IDENTITY_REGISTRY_ABI.register];
+        const args = tokenURI ? [tokenURI] : [];
+        const { request } = await this.publicClient.simulateContract({
+            account,
+            address: this.address,
+            abi: abi,
+            functionName: 'register',
+            args: args,
+            value: valueWei,
+        });
+        const hash = await this.walletClient.writeContract(request);
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash });
+        const agentId = this._parseAgentIdFromReceipt(receipt);
+        return { agentId, txHash: hash };
+    }
+    // ── Read: Query ──────────────────────────────────────────────────────────
+    /** Get all agent IDs owned by an address. */
+    async getAgentsByOwner(owner) {
+        const result = await this.publicClient.readContract({
+            address: this.address,
+            abi: [IDENTITY_REGISTRY_ABI.getAgentsByOwner],
+            functionName: 'getAgentsByOwner',
+            args: [owner],
+        });
+        return result.map(Number);
+    }
+    /** Get the current total agent count. */
+    async getCurrentAgentId() {
+        const result = await this.publicClient.readContract({
+            address: this.address,
+            abi: [IDENTITY_REGISTRY_ABI.getCurrentAgentId],
+            functionName: 'getCurrentAgentId',
+        });
+        return Number(result);
+    }
+    /** Check if an agent exists. */
+    async agentExists(agentId) {
+        const result = await this.publicClient.readContract({
+            address: this.address,
+            abi: [IDENTITY_REGISTRY_ABI.agentExists],
+            functionName: 'agentExists',
+            args: [BigInt(agentId)],
+        });
+        return result;
+    }
+    /** Get the tokenURI for an agent. */
+    async tokenURI(agentId) {
+        const result = await this.publicClient.readContract({
+            address: this.address,
+            abi: [IDENTITY_REGISTRY_ABI.tokenURI],
+            functionName: 'tokenURI',
+            args: [BigInt(agentId)],
+        });
+        return result;
+    }
+    /** Get all metadata attributes for an agent as key-value pairs. */
+    async getAttributes(agentId) {
+        const result = await this.publicClient.readContract({
+            address: this.address,
+            abi: [IDENTITY_REGISTRY_ABI.getAgentMetadata],
+            functionName: 'getAgentMetadata',
+            args: [BigInt(agentId)],
+        });
+        const attrs = {};
+        for (const item of result) {
+            attrs[item.key] = hexToString(item.value);
+        }
+        return attrs;
+    }
+    // ── Helpers ──────────────────────────────────────────────────────────────
+    /** Extract tokenId from the Transfer event in the receipt. */
+    _parseAgentIdFromReceipt(receipt) {
+        for (const log of receipt.logs) {
+            // ERC-721 Transfer event: keccak("Transfer(address,address,uint256)")
+            const transferTopic = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef';
+            if (log.topics[0] === transferTopic && log.topics.length >= 4) {
+                return Number(BigInt(log.topics[3]));
+            }
+        }
+        throw new Error('Could not parse agentId from Transfer event in receipt');
+    }
+}
+// ── Utility ─────────────────────────────────────────────────────────────────
+/** Extract IPFS CID from an ipfs:// URI. */
+export function cidFromURI(uri) {
+    return uri.replace(/^ipfs:\/\//, '');
+}
+//# sourceMappingURL=agent-registry.js.map

package/dist/registry/agent-registry.js.map

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

package/dist/registry/index.d.ts

@@ -0,0 +1,7 @@
+export { AgentRegistry, cidFromURI } from './agent-registry';
+export type { AgentRegistryConfig } from './agent-registry';
+export { IPFSFetcher, defaultIPFSFetcher } from './ipfs-fetcher';
+export type { IPFSFetcherConfig } from './ipfs-fetcher';
+export type { RegisteredAgent, AgentSearchQuery, AgentSearchResult, OnChainAgentMetadata, } from '../core/types';
+export declare const REGISTRY_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC5D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAChE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAA;AAEtB,eAAO,MAAM,gBAAgB,UAAU,CAAA"}

package/dist/registry/index.js

@@ -0,0 +1,6 @@
+// @agentx/sdk — Registry module
+// Agent registration, query, and IPFS fetching.
+export { AgentRegistry, cidFromURI } from './agent-registry';
+export { IPFSFetcher, defaultIPFSFetcher } from './ipfs-fetcher';
+export const REGISTRY_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,gDAAgD;AAEhD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG5D,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAWhE,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA"}

package/dist/registry/ipfs-fetcher.d.ts

@@ -0,0 +1,39 @@
+import type { EncryptedPayload } from '../core/types';
+export 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;
+}
+export 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. */
+export declare const defaultIPFSFetcher: IPFSFetcher;
+//# sourceMappingURL=ipfs-fetcher.d.ts.map

package/dist/registry/ipfs-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-fetcher.d.ts","sourceRoot":"","sources":["../../src/registry/ipfs-fetcher.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAIrD,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AASD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,GAAE,iBAAsB;IAa1C,yCAAyC;IACnC,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBrD,2DAA2D;IACrD,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQnE,0DAA0D;IACpD,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,SAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAmBvF,qDAAqD;IACrD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC,mDAAmD;IACnD,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAS9B,gCAAgC;IAChC,IAAI,SAAS,IAAI,MAAM,CAEtB;YAIa,QAAQ;YAsBR,UAAU;IAUxB,OAAO,CAAC,SAAS;CAUlB;AAED,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB,aAAoB,CAAA"}

package/dist/registry/ipfs-fetcher.js

@@ -0,0 +1,139 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — IPFS Fetcher
+// ---------------------------------------------------------------------------
+// Multi-gateway IPFS fetcher with in-memory cache, deduplication, and
+// automatic fallback.  Compatible with the EncryptedPayload wire format.
+// ---------------------------------------------------------------------------
+// ── Implementation ─────────────────────────────────────────────────────────
+export class IPFSFetcher {
+    gateway;
+    fallbackGateways;
+    timeoutMs;
+    cache = new Map();
+    maxCache;
+    pending = new Map();
+    failed = new Set();
+    constructor(config = {}) {
+        this.gateway = config.gateway ?? 'ipfs.io';
+        this.fallbackGateways = config.fallbackGateways ?? [
+            'gateway.pinata.cloud',
+            'dweb.link',
+            'cf-ipfs.com',
+        ];
+        this.timeoutMs = config.timeoutMs ?? 10_000;
+        this.maxCache = config.maxCache ?? 200;
+    }
+    // ── Public API ──────────────────────────────────────────────────────────
+    /** Fetch JSON from a single IPFS CID. */
+    async fetchJSON(cid) {
+        const cached = this.cache.get(cid);
+        if (cached)
+            return cached.data;
+        if (this.failed.has(cid))
+            throw new Error(`CID ${cid} previously failed`);
+        const pending = this.pending.get(cid);
+        if (pending)
+            return pending;
+        const promise = this._doFetch(cid);
+        this.pending.set(cid, promise);
+        try {
+            const data = await promise;
+            this._cacheSet(cid, data);
+            return data;
+        }
+        catch (e) {
+            this.failed.add(cid);
+            throw e;
+        }
+        finally {
+            this.pending.delete(cid);
+        }
+    }
+    /** Fetch encrypted agent payload (validates algorithm). */
+    async fetchEncryptedPayload(cid) {
+        const raw = await this.fetchJSON(cid);
+        if (!raw.encrypted || raw.algorithm !== 'AES-256-GCM' || typeof raw.data !== 'string') {
+            throw new Error(`Invalid EncryptedPayload at CID ${cid}`);
+        }
+        return raw;
+    }
+    /** Batch fetch multiple CIDs with concurrency control. */
+    async fetchBatch(cids, concurrency = 5) {
+        const results = new Map();
+        const unique = [...new Set(cids)].filter(c => this.isValidCID(c));
+        for (let i = 0; i < unique.length; i += concurrency) {
+            const batch = unique.slice(i, i + concurrency);
+            const settled = await Promise.allSettled(batch.map(cid => this.fetchJSON(cid)));
+            settled.forEach((r, j) => {
+                if (r.status === 'fulfilled')
+                    results.set(batch[j], r.value);
+            });
+            if (i + concurrency < unique.length) {
+                await new Promise(r => setTimeout(r, 200));
+            }
+        }
+        return results;
+    }
+    /** Check if a string looks like a valid IPFS CID. */
+    isValidCID(cid) {
+        return /^(Qm[1-9A-HJ-NP-Za-km-z]{44,}|b[a-z2-7]{58,}|[A-Za-z0-9+/]{46,})$/.test(cid);
+    }
+    /** Clear cache (optionally for a specific CID). */
+    clearCache(cid) {
+        if (cid) {
+            this.cache.delete(cid);
+        }
+        else {
+            this.cache.clear();
+        }
+        this.failed.clear();
+    }
+    /** Number of cached entries. */
+    get cacheSize() {
+        return this.cache.size;
+    }
+    // ── Internal ─────────────────────────────────────────────────────────────
+    async _doFetch(cid) {
+        if (!this.isValidCID(cid))
+            throw new Error(`Invalid CID: ${cid}`);
+        // Try primary gateway
+        try {
+            return await this._fetchFrom(cid, this.gateway, this.timeoutMs);
+        }
+        catch {
+            // fall through to alternatives
+        }
+        // Try fallback gateways
+        for (const gw of this.fallbackGateways) {
+            try {
+                return await this._fetchFrom(cid, gw, this.timeoutMs);
+            }
+            catch {
+                // try next
+            }
+        }
+        throw new Error(`All IPFS gateways failed for CID ${cid}`);
+    }
+    async _fetchFrom(cid, gateway, timeoutMs) {
+        const url = `https://${gateway}/ipfs/${cid}`;
+        const res = await fetch(url, {
+            headers: { Accept: 'application/json' },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        return (await res.json());
+    }
+    _cacheSet(cid, data) {
+        this.cache.set(cid, { data, timestamp: Date.now() });
+        // Simple LRU-like eviction
+        if (this.cache.size > this.maxCache) {
+            const oldest = [...this.cache.entries()].sort((a, b) => a[1].timestamp - b[1].timestamp)[0];
+            if (oldest)
+                this.cache.delete(oldest[0]);
+        }
+    }
+}
+/** Singleton-friendly default instance. */
+export const defaultIPFSFetcher = new IPFSFetcher();
+//# sourceMappingURL=ipfs-fetcher.js.map

package/dist/registry/ipfs-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipfs-fetcher.js","sourceRoot":"","sources":["../../src/registry/ipfs-fetcher.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAC9E,sEAAsE;AACtE,yEAAyE;AACzE,8EAA8E;AAsB9E,8EAA8E;AAE9E,MAAM,OAAO,WAAW;IACd,OAAO,CAAQ;IACf,gBAAgB,CAAU;IAC1B,SAAS,CAAQ;IAEjB,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAA;IAC9C,QAAQ,CAAQ;IAChB,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAA;IAC7C,MAAM,GAAG,IAAI,GAAG,EAAU,CAAA;IAElC,YAAY,SAA4B,EAAE;QACxC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAA;QAC1C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI;YACjD,sBAAsB;YACtB,WAAW;YACX,aAAa;SACd,CAAA;QACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAA;QAC3C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAA;IACxC,CAAC;IAED,2EAA2E;IAE3E,yCAAyC;IACzC,KAAK,CAAC,SAAS,CAAc,GAAW;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC,IAAS,CAAA;QAEnC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,oBAAoB,CAAC,CAAA;QAEzE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,OAAO;YAAE,OAAO,OAAqB,CAAA;QAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAI,GAAG,CAAC,CAAA;QACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAE9B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAA;YAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACzB,OAAO,IAAI,CAAA;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACpB,MAAM,CAAC,CAAA;QACT,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,qBAAqB,CAAC,GAAW;QACrC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAA0B,GAAG,CAAC,CAAA;QAC9D,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,KAAK,aAAa,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAA;QAC3D,CAAC;QACD,OAAO,GAAkC,CAAA;IAC3C,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,UAAU,CAAc,IAAc,EAAE,WAAW,GAAG,CAAC;QAC3D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAA;QACpC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;QAEjE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAI,GAAG,CAAC,CAAC,CACzC,CAAA;YACD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBACvB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;oBAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAA;YAC/D,CAAC,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACpC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;YAC5C,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,qDAAqD;IACrD,UAAU,CAAC,GAAW;QACpB,OAAO,mEAAmE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACtF,CAAC;IAED,mDAAmD;IACnD,UAAU,CAAC,GAAY;QACrB,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;IAED,gCAAgC;IAChC,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IACxB,CAAC;IAED,4EAA4E;IAEpE,KAAK,CAAC,QAAQ,CAAI,GAAW;QACnC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAA;QAEjE,sBAAsB;QACtB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QAED,wBAAwB;QACxB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW;YACb,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAA;IAC5D,CAAC;IAEO,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,OAAe,EAAE,SAAiB;QACzE,MAAM,GAAG,GAAG,WAAW,OAAO,SAAS,GAAG,EAAE,CAAA;QAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;QAClD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAA;IAChC,CAAC;IAEO,SAAS,CAAC,GAAW,EAAE,IAAa;QAC1C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QACpD,2BAA2B;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAC1C,CAAC,CAAC,CAAC,CAAA;YACJ,IAAI,MAAM;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,WAAW,EAAE,CAAA"}

package/dist/reputation/index.d.ts

@@ -0,0 +1,4 @@
+export { ReputationRegistry } from './reputation';
+export type { ReputationConfig } from './reputation';
+export declare const REPUTATION_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/reputation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,eAAO,MAAM,kBAAkB,UAAU,CAAA"}

package/dist/reputation/index.js

@@ -0,0 +1,4 @@
+// @agentx/sdk — Reputation module
+export { ReputationRegistry } from './reputation';
+export const REPUTATION_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/reputation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reputation/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAA"}

package/dist/reputation/reputation.d.ts

@@ -0,0 +1,26 @@
+import type { PublicClient, WalletClient, Address, Hash } from 'viem';
+import type { AgentReputation, AgentReview } from '../core/types';
+export interface ReputationConfig {
+    contractAddress: Address;
+    publicClient: PublicClient;
+    walletClient: WalletClient;
+}
+export declare class ReputationRegistry {
+    private address;
+    private publicClient;
+    private walletClient;
+    constructor(config: ReputationConfig);
+    private get account();
+    /** Submit a rating (1-5) with optional comment. */
+    rate(agentId: number, rating: number, comment?: string): Promise<Hash>;
+    /** Get average rating and total count. */
+    getRating(agentId: number): Promise<{
+        averageRating: number;
+        totalRatings: number;
+    }>;
+    /** Get all reviews for an agent. */
+    getReviews(agentId: number): Promise<AgentReview[]>;
+    /** Get full reputation summary. */
+    getReputation(agentId: number): Promise<AgentReputation>;
+}
+//# sourceMappingURL=reputation.d.ts.map

package/dist/reputation/reputation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation.d.ts","sourceRoot":"","sources":["../../src/reputation/reputation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AA4CjE,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,YAAY,CAAA;IAC1B,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;gBAEtB,MAAM,EAAE,gBAAgB;IAMpC,OAAO,KAAK,OAAO,GAKlB;IAED,mDAAmD;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxE,0CAA0C;IACpC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAW1F,oCAAoC;IAC9B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBzD,mCAAmC;IAC7B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;CAO/D"}

package/dist/reputation/reputation.js

@@ -0,0 +1,113 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — Reputation
+// ---------------------------------------------------------------------------
+// Wraps ReputationRegistry contract for agent ratings and reviews.
+// ---------------------------------------------------------------------------
+const REPUTATION_ABI = {
+    rateAgent: {
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'rating', type: 'uint8' },
+            { name: 'comment', type: 'string' },
+        ],
+        name: 'rateAgent',
+        outputs: [],
+        stateMutability: 'nonpayable',
+        type: 'function',
+    },
+    getRating: {
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        name: 'getRating',
+        outputs: [
+            { name: 'averageRating', type: 'uint256' },
+            { name: 'totalRatings', type: 'uint256' },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+    getReviews: {
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        name: 'getReviews',
+        outputs: [
+            {
+                name: '',
+                type: 'tuple[]',
+                components: [
+                    { name: 'reviewer', type: 'address' },
+                    { name: 'rating', type: 'uint8' },
+                    { name: 'comment', type: 'string' },
+                    { name: 'timestamp', type: 'uint256' },
+                ],
+            },
+        ],
+        stateMutability: 'view',
+        type: 'function',
+    },
+};
+export class ReputationRegistry {
+    address;
+    publicClient;
+    walletClient;
+    constructor(config) {
+        this.address = config.contractAddress;
+        this.publicClient = config.publicClient;
+        this.walletClient = config.walletClient;
+    }
+    get account() {
+        return this.walletClient.getAddresses().then(a => {
+            if (!a[0])
+                throw new Error('Wallet not connected');
+            return a[0];
+        });
+    }
+    /** Submit a rating (1-5) with optional comment. */
+    async rate(agentId, rating, comment = '') {
+        if (rating < 1 || rating > 5)
+            throw new Error('Rating must be 1-5');
+        const acct = await this.account;
+        const { request } = await this.publicClient.simulateContract({
+            account: acct,
+            address: this.address,
+            abi: [REPUTATION_ABI.rateAgent],
+            functionName: 'rateAgent',
+            args: [BigInt(agentId), rating, comment],
+        });
+        return this.walletClient.writeContract(request);
+    }
+    /** Get average rating and total count. */
+    async getRating(agentId) {
+        const r = await this.publicClient.readContract({
+            address: this.address,
+            abi: [REPUTATION_ABI.getRating],
+            functionName: 'getRating',
+            args: [BigInt(agentId)],
+        });
+        const [avg, total] = r;
+        return { averageRating: Number(avg), totalRatings: Number(total) };
+    }
+    /** Get all reviews for an agent. */
+    async getReviews(agentId) {
+        const r = await this.publicClient.readContract({
+            address: this.address,
+            abi: [REPUTATION_ABI.getReviews],
+            functionName: 'getReviews',
+            args: [BigInt(agentId)],
+        });
+        return r
+            .map(x => ({
+            reviewer: x.reviewer,
+            rating: x.rating,
+            comment: x.comment,
+            timestamp: Number(x.timestamp),
+        }));
+    }
+    /** Get full reputation summary. */
+    async getReputation(agentId) {
+        const [rating, reviews] = await Promise.all([
+            this.getRating(agentId),
+            this.getReviews(agentId),
+        ]);
+        return { agentId, ...rating, reviews };
+    }
+}
+//# sourceMappingURL=reputation.js.map

package/dist/reputation/reputation.js.map

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