@agentxv2/sdk 0.5.0 → 0.5.2

package/dist/index.d.ts

@@ -1,269 +0,0 @@
-import { A as AgentSubscription, a as A2AAgentCard, b as A2ATask, M as McpConnection, c as AgentReview, d as AgentReputation } from './types-2aHUvS4M.js';
-export { e as A2ASkillExecution, f as A2ATaskStatus, g as AgentPayload, h as AgentPricing, i as AgentPrivatePayload, j as AgentPublicPayload, k as AgentSearchQuery, l as AgentSearchResult, m as AgentXConfig, n as AgentXContracts, o as AgentXError, p as AgentXErrorCode, E as EncryptedPayload, J as JSONSchema, q as JSONSchemaProperty, r as McpTransport, O as OnChainAgentMetadata, P as PackResult, s as PricingType, R as RegisteredAgent, S as SkillDef, t as SkillExecutionMode, u as SkillExecutionRemote, v as SubscriptionRequired, w as SubscriptionStatus, U as UnpackResult } from './types-2aHUvS4M.js';
-export { aesDecrypt, aesEncrypt, decryptPayload, eciesDecrypt, eciesEncrypt, encryptPayload, generateAesKey, generateKeyPair, getPublicKey, packAgentForPublish, randomBytes, unpackAgent } from './core/index.js';
-export { A as A2ASkillResult, a as AgentRunContext, b as AgentRunner, c as AgentRunnerConfig, C as ChainConfig, d as ConfigRegistryOpts, e as ConfigurationRegistry, I as IPFSFetcher, f as IPFSFetcherConfig, K as KNOWN_CHAINS, O as OnChainReader, R as RunnableSkill, U as UseAgentRunnerConfig, g as UseAgentRunnerResult, W as WalletSigner, h as defaultIPFSFetcher, u as useAgentRunner } from './index-DhXVi_ub.js';
-import { Address, PublicClient, WalletClient, Hash } from 'viem';
-export { bytesToHex, hexToBytes } from '@noble/ciphers/utils.js';
-
-interface AgentRegistryConfig {
-    /** IdentityRegistry contract address */
-    contractAddress: Address;
-    /** viem PublicClient for read calls */
-    publicClient: PublicClient;
-    /** viem WalletClient for write calls */
-    walletClient: WalletClient;
-}
-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. */
-declare function cidFromURI(uri: string): string;
-
-declare const REGISTRY_VERSION = "0.1.0";
-
-interface SubscriptionConfig {
-    contractAddress: Address;
-    publicClient: PublicClient;
-    walletClient: WalletClient;
-}
-interface PlanDetail {
-    planId: number;
-    agentId: number;
-    creator: Address;
-    price: bigint;
-    period: string;
-    active: boolean;
-    payToken: Address;
-    trialDays: number;
-}
-interface SubscriptionDetail {
-    subscriptionId: number;
-    subscriber: Address;
-    agentId: number;
-    status: number;
-    startedAt: number;
-    expiresAt: number;
-    period: string;
-    payToken: Address;
-    amountPaid: bigint;
-    trialActive: boolean;
-    trialEndsAt: number;
-    fundsReleased: boolean;
-}
-declare class SubscriptionManager {
-    private address;
-    private publicClient;
-    private walletClient;
-    constructor(config: SubscriptionConfig);
-    /** Get current platform fee in basis points (e.g. 250 = 2.5%). */
-    getPlatformFeeBps(): Promise<number>;
-    /** Check if a token is whitelisted for payments. */
-    isTokenWhitelisted(token: Address): Promise<boolean>;
-    /** Get full plan details with v2 fields. */
-    getPlan(planId: number): Promise<PlanDetail>;
-    /**
-     * Subscribe to a plan.
-     * For ETH plans: pass valueWei = plan.price.
-     * For ERC20 plans: auto-detects from plan.payToken, calls approve + subscribe.
-     *                    User must have approved this contract for plan.price tokens.
-     */
-    subscribe(planId: number, opts?: {
-        valueWei?: bigint;
-        approveTokenFirst?: boolean;
-    }): Promise<{
-        subscriptionId: number;
-        txHash: Hash;
-    }>;
-    /** Release escrowed funds to creator after trial window ends. */
-    releaseFunds(subscriptionId: number): Promise<Hash>;
-    /** Cancel subscription (trial refund if within window). */
-    cancel(subscriptionId: number): Promise<Hash>;
-    hasActiveSubscription(subscriber: Address, agentId: number): Promise<boolean>;
-    getSubscription(subscriber: Address, agentId: number): Promise<AgentSubscription | null>;
-    /** Get full subscription detail with v2 fields (trial, payToken, fundsReleased). */
-    getSubscriptionDetail(subscriptionId: number): Promise<SubscriptionDetail>;
-    getUserSubscriptions(user: Address): Promise<number[]>;
-}
-declare function guardSubscription(manager: SubscriptionManager, user: Address, agentId: number): Promise<AgentSubscription>;
-
-interface AgentX402Config {
-    subscriptionManagerAddress: Address;
-    publicClient: PublicClient;
-    walletClient: WalletClient;
-}
-declare class AgentX402 {
-    private config;
-    constructor(config: AgentX402Config);
-    /**
-     * Require active subscription — or throw with auto-pay info.
-     *
-     * Usage:
-     *   await x402.requireSubscription(agentId, address, { planIds: [1,2,3] })
-     *
-     * On success, returns silently.
-     * On failure, throws AgentXError with paymentInfo populated
-     * so the caller can auto-pay via wallet/X402.
-     */
-    requireSubscription(agentId: number, address: Address, opts?: {
-        planIds?: number[];
-    }): Promise<void>;
-    /**
-     * Subscribe to a plan + wait for receipt.
-     * Returns subscriptionId from the Subscribed event.
-     *
-     * NOTE: For ERC20 plans, the caller must approve token spending
-     * BEFORE calling this method. Use X402 SDK or wagmi's useWriteContract
-     * for the approve step.
-     */
-    subscribeAndWait(planId: number, price: bigint, payToken: Address): Promise<number>;
-}
-
-declare const SUBSCRIPTION_VERSION = "0.2.0";
-
-interface A2AConfig {
-    contractAddress: Address;
-    publicClient: PublicClient;
-    walletClient: WalletClient;
-}
-declare class A2AProtocol {
-    private address;
-    private publicClient;
-    private walletClient;
-    constructor(config: A2AConfig);
-    private get account();
-    createAgentCard(agentId: number, card: {
-        name: string;
-        description: string;
-        version: string;
-        capabilities: string[];
-        supportedTasks: string[];
-        commProtocol?: string;
-        authMethod?: string;
-        cardURI?: string;
-    }): Promise<{
-        cardId: number;
-        txHash: Hash;
-    }>;
-    getAgentCard(agentId: number): Promise<A2AAgentCard | null>;
-    createTask(agentId: number, taskType: string, input: Record<string, unknown>): Promise<{
-        taskId: number;
-        txHash: Hash;
-    }>;
-    completeTask(taskId: number, output: unknown): Promise<Hash>;
-    getTask(taskId: number): Promise<A2ATask | null>;
-    getUserTasks(user: Address): Promise<number[]>;
-    private _parseUintFromLog;
-}
-
-declare const A2A_VERSION = "0.1.0";
-
-interface MCPTool {
-    name: string;
-    description?: string;
-    inputSchema: Record<string, unknown>;
-}
-interface MCPCallResult {
-    content: {
-        type: string;
-        text?: string;
-        data?: string;
-    }[];
-    isError?: boolean;
-}
-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;
-}
-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;
-}
-
-declare const MCP_VERSION = "0.1.0";
-
-interface ReputationConfig {
-    contractAddress: Address;
-    publicClient: PublicClient;
-    walletClient: WalletClient;
-}
-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>;
-}
-
-declare const REPUTATION_VERSION = "0.1.0";
-
-declare const CONFIG_VERSION = "0.1.0";
-
-export { A2AAgentCard, type A2AConfig, A2AProtocol, A2ATask, A2A_VERSION, AgentRegistry, type AgentRegistryConfig, AgentReputation, AgentReview, AgentSubscription, AgentX402, type AgentX402Config, CONFIG_VERSION, type MCPCallResult, MCPConnector, type MCPConnectorConfig, type MCPTool, MCP_VERSION, McpConnection, type PlanDetail, REGISTRY_VERSION, REPUTATION_VERSION, type ReputationConfig, ReputationRegistry, SUBSCRIPTION_VERSION, type SubscriptionConfig, type SubscriptionDetail, SubscriptionManager, cidFromURI, guardSubscription };

package/dist/react.d.mts

@@ -1,3 +0,0 @@
-export { a as AgentRunContext, O as OnChainReader, R as RunnableSkill, U as UseAgentRunnerConfig, g as UseAgentRunnerResult, W as WalletSigner, u as useAgentRunner } from '../index-eQO4iaOr.mjs';
-import '../types-2aHUvS4M.mjs';
-import 'viem';

package/dist/react.d.ts

@@ -1,3 +0,0 @@
-export { a as AgentRunContext, O as OnChainReader, R as RunnableSkill, U as UseAgentRunnerConfig, g as UseAgentRunnerResult, W as WalletSigner, u as useAgentRunner } from '../index-DhXVi_ub.js';
-import '../types-2aHUvS4M.js';
-import 'viem';

package/dist/types-2aHUvS4M.d.mts

@@ -1,297 +0,0 @@
-interface JSONSchema {
-    type: 'object' | 'array' | 'string' | 'number' | 'boolean' | 'integer' | 'null';
-    properties?: Record<string, JSONSchemaProperty>;
-    required?: string[];
-    description?: string;
-    items?: JSONSchema;
-    enum?: (string | number | boolean | null)[];
-}
-interface JSONSchemaProperty {
-    type?: JSONSchema['type'] | JSONSchema['type'][];
-    description?: string;
-    properties?: Record<string, JSONSchemaProperty>;
-    required?: string[];
-    items?: JSONSchema;
-    enum?: (string | number | boolean | null)[];
-    format?: string;
-    default?: unknown;
-}
-/**
- * A single skill module that an Agent exposes.
- * `inputSchema` and `outputSchema` follow MCP Tool JSON Schema conventions.
- */
-interface SkillDef {
-    /** Unique skill name (e.g. "solidity_audit") */
-    name: string;
-    /** Human-readable description shown in the marketplace */
-    description: string;
-    /** Semantic version of this skill */
-    version: string;
-    /** JSON Schema for the tool's input parameters */
-    inputSchema: JSONSchema;
-    /** JSON Schema for the tool's output return value */
-    outputSchema?: JSONSchema;
-    /**
-     * Execution mode.
-     * - undefined / "open": Source is in the encrypted payload, runs locally.
-     * - { type: "mcp", toolName: "..." }: Source lives on the publisher's
-     *     MCP server.  Subscriber only gets Schema + remote execution endpoint.
-     *     MCP server verifies on-chain subscription on every call.
-     * - { type: "a2a", targetAgentId: 42 }: Delegates to another AgentX Agent.
-     *     The caller's AgentRunner loads + decrypts the target Agent, injects
-     *     its prompt into the LLM context, and exposes its skills as callable
-     *     tools.  This is the core Agent Composition primitive.
-     */
-    execution?: SkillExecutionRemote | A2ASkillExecution;
-}
-/** Where the skill code actually runs. */
-type SkillExecutionMode = 'open' | 'mcp' | 'a2a';
-interface SkillExecutionRemote {
-    type: 'mcp';
-    /** MCP tool name on the publisher's server (e.g. "run_strategy_abc123") */
-    toolName: string;
-    /** Optional: explicit MCP endpoint override */
-    endpoint?: string;
-}
-/**
- * A2A Skill Execution — delegate to another AgentX Agent.
- *
- * Example: A "trading" Agent has a skill:
- *   execution: { type: "a2a", targetAgentId: 42 }
- * → When LLM calls this skill, AgentRunner loads Agent #42,
- *   decrypts its prompt+skills, and the sub-Agent runs in the
- *   same LLM conversation with its own system prompt.
- */
-interface A2ASkillExecution {
-    type: 'a2a';
-    /** On-chain Agent ID to delegate to */
-    targetAgentId: number;
-    /** Optional: restrict which of the target Agent's skills are exposed */
-    skillFilter?: string[];
-    /** Optional: custom system prompt override for the sub-Agent */
-    promptOverride?: string;
-}
-type McpTransport = 'http' | 'sse' | 'stdio';
-interface McpConnection {
-    /** Transport type */
-    type: McpTransport;
-    /** MCP server URL (required for http/sse) */
-    url?: string;
-    /** Optional: limit which tools the Agent exposes to users */
-    toolFilter?: string[];
-    /** Optional: MCP server authentication header / key */
-    authHeader?: string;
-}
-type PricingType = 'subscription' | 'pay_per_use' | 'free';
-interface AgentPricing {
-    type: PricingType;
-    /** Amount in native unit (e.g. "0.01" for 0.01 ETH) */
-    amount: string;
-    /** ERC20 token address, or empty for native currency */
-    currency: string;
-    /** Billing period for subscriptions (e.g. "month", "year", "day") */
-    period?: string;
-}
-/**
- * The complete Agent definition.
- *
- * - Fields above "--- private payload ---" are public (IPFS publicPayloadCid).
- * - Fields below are encrypted with AES-256-GCM and stored at encryptedPayloadCid.
- */
-interface AgentPayload {
-    name: string;
-    description: string;
-    image?: string;
-    version: string;
-    tags: string[];
-    capabilities: string[];
-    supportedTasks: string[];
-    communicationProtocol: 'mcp' | 'a2a';
-    authenticationMethod: 'ecdsa';
-    pricing: AgentPricing;
-    prompt: string;
-    skills: SkillDef[];
-    mcp: McpConnection;
-}
-/** Subset of AgentPayload that is publicly visible */
-type AgentPublicPayload = Omit<AgentPayload, 'prompt' | 'skills' | 'mcp'>;
-/** Fields that must be encrypted before IPFS upload */
-type AgentPrivatePayload = Pick<AgentPayload, 'prompt' | 'skills' | 'mcp'>;
-interface EncryptedPayload {
-    encrypted: true;
-    algorithm: 'AES-256-GCM';
-    /** base64(iv + ciphertext + authTag) */
-    data: string;
-}
-interface OnChainAgentMetadata {
-    tokenURI: string;
-    attributes: {
-        name: string;
-        description: string;
-        /** CID of the AES-256-GCM encrypted payload on IPFS */
-        encryptedPayloadCid: string;
-        /** ECIES-encrypted AES key (secp256k1, hex string) */
-        eciesEncryptedKey: string;
-        /** CID of the public metadata on IPFS */
-        publicPayloadCid: string;
-        capabilities: string[];
-        skills: string[];
-        mcpEndpoint: string;
-        version: string;
-        tags: string[];
-        pricingType: PricingType;
-        pricingAmount: string;
-    };
-}
-interface RegisteredAgent {
-    /** ERC-721 token ID (= agentId) */
-    agentId: number;
-    /** Owner wallet address */
-    owner: string;
-    /** Creator wallet address */
-    creator: string;
-    /** Full on-chain metadata */
-    metadata: OnChainAgentMetadata;
-    /** Block number where agent was registered */
-    registeredAt: number;
-    /** IPFS CID of the full public payload (resolved from tokenURI) */
-    publicPayloadCid: string;
-}
-interface AgentSearchQuery {
-    keyword?: string;
-    capabilities?: string[];
-    tags?: string[];
-    pricingType?: PricingType;
-    maxPrice?: string;
-    owner?: string;
-    sortBy?: 'latest' | 'reputation' | 'price_asc' | 'price_desc';
-    page?: number;
-    pageSize?: number;
-}
-interface AgentSearchResult {
-    agents: RegisteredAgent[];
-    total: number;
-    page: number;
-    pageSize: number;
-}
-type SubscriptionStatus = 'active' | 'expired' | 'cancelled' | 'pending';
-interface AgentSubscription {
-    subscriptionId: number;
-    subscriber: string;
-    agentId: number;
-    status: SubscriptionStatus;
-    startedAt: number;
-    expiresAt: number;
-    period: string;
-}
-type A2ATaskStatus = 'created' | 'accepted' | 'in_progress' | 'completed' | 'failed';
-interface A2AAgentCard {
-    agentId: number;
-    name: string;
-    capabilities: string[];
-    supportedTasks: string[];
-    /** MCP endpoint URL for direct agent-to-agent communication */
-    endpoint: string;
-    /** Public key for ECDSA authentication */
-    publicKey: string;
-}
-interface A2ATask {
-    taskId: number;
-    /** Agent that created the task */
-    creator: string;
-    /** Target agent to execute the task */
-    targetAgentId: number;
-    /** Task type (must be in target's supportedTasks) */
-    taskType: string;
-    /** JSON input payload */
-    input: string;
-    status: A2ATaskStatus;
-    result?: string;
-    createdAt: number;
-    completedAt?: number;
-}
-interface AgentReputation {
-    agentId: number;
-    averageRating: number;
-    totalRatings: number;
-    reviews: AgentReview[];
-}
-interface AgentReview {
-    reviewer: string;
-    rating: number;
-    comment: string;
-    timestamp: number;
-}
-interface AgentXConfig {
-    /** Chain ID (e.g. 11155111 for Sepolia) */
-    chainId: number;
-    /** RPC endpoint override (uses viem's default if omitted) */
-    rpcUrl?: string;
-    /** Contract addresses for the current chain */
-    contracts: AgentXContracts;
-    /** IPFS gateway URLs (ordered by priority) */
-    ipfsGateways: string[];
-    /** Default IPFS pinning service */
-    pinningService?: 'pinata';
-    pinataJwt?: string;
-}
-interface AgentXContracts {
-    identityRegistry: `0x${string}`;
-    subscriptionManager: `0x${string}`;
-    paymentGateway: `0x${string}`;
-    a2aProtocolRegistry: `0x${string}`;
-    reputationRegistry: `0x${string}`;
-    configurationRegistry: `0x${string}`;
-}
-interface PackResult {
-    /** CID of AES-256-GCM encrypted payload on IPFS */
-    encryptedCid: string;
-    /** CID of public metadata on IPFS */
-    publicCid: string;
-    /** Raw AES key (hex) — DO NOT share or upload this */
-    aesKeyHex: string;
-    /** ECIES-encrypted AES key (hex), safe to store on-chain */
-    eciesEncryptedKeyHex: string;
-}
-interface UnpackResult {
-    /** Decrypted AgentPayload */
-    agent: AgentPayload;
-    /** CID where the encrypted payload was fetched from */
-    encryptedCid: string;
-    /** CID of the public metadata */
-    publicCid: string;
-}
-declare enum AgentXErrorCode {
-    NOT_SUBSCRIBED = "NOT_SUBSCRIBED",
-    SUBSCRIPTION_EXPIRED = "SUBSCRIPTION_EXPIRED",
-    DECRYPTION_FAILED = "DECRYPTION_FAILED",
-    IPFS_FETCH_FAILED = "IPFS_FETCH_FAILED",
-    AGENT_NOT_FOUND = "AGENT_NOT_FOUND",
-    INVALID_SCHEMA = "INVALID_SCHEMA",
-    TX_FAILED = "TX_FAILED",
-    WALLET_NOT_CONNECTED = "WALLET_NOT_CONNECTED"
-}
-declare class AgentXError extends Error {
-    code: AgentXErrorCode;
-    /** If NOT_SUBSCRIBED, carry enough info for wallet/X402 auto-payment */
-    paymentInfo?: SubscriptionRequired;
-    constructor(code: AgentXErrorCode, message: string);
-}
-/**
- * Structured info for wallet/X402 auto-subscription.
- * Thrown by AgentRunner.useAgent() when the user/Agent has no
- * active subscription.
- */
-interface SubscriptionRequired {
-    agentId: number;
-    /** Plan IDs available for this Agent (on-chain query) */
-    plans?: {
-        planId: number;
-        price: bigint;
-        period: string;
-        payToken: string;
-        trialDays: number;
-    }[];
-}
-
-export { type AgentSubscription as A, type EncryptedPayload as E, type JSONSchema as J, type McpConnection as M, type OnChainAgentMetadata as O, type PackResult as P, type RegisteredAgent as R, type SkillDef as S, type UnpackResult as U, type A2AAgentCard as a, type A2ATask as b, type AgentReview as c, type AgentReputation as d, type A2ASkillExecution as e, type A2ATaskStatus as f, type AgentPayload as g, type AgentPricing as h, type AgentPrivatePayload as i, type AgentPublicPayload as j, type AgentSearchQuery as k, type AgentSearchResult as l, type AgentXConfig as m, type AgentXContracts as n, AgentXError as o, AgentXErrorCode as p, type JSONSchemaProperty as q, type McpTransport as r, type PricingType as s, type SkillExecutionMode as t, type SkillExecutionRemote as u, type SubscriptionRequired as v, type SubscriptionStatus as w };