@agentxv2/sdk 0.3.0

package/dist/core/crypto.js

@@ -0,0 +1,291 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — Crypto Engine
+// ---------------------------------------------------------------------------
+// AES-256-GCM for content encryption (NIST standard, same wire format as
+// aihunter-saas for interop).  ECIES (secp256k1) for key wrapping.
+//
+// Wire format (AES-256-GCM):
+//   base64( IV[12] || ciphertext || authTag[16] )
+//
+// ECIES wire format (compatible with eciesjs):
+//   hex( ephemeralPub[33] || IV[16] || ciphertext || MAC[32] )
+//
+// Pure JS — works in browser, Node, edge. No native deps except @noble/*.
+// ---------------------------------------------------------------------------
+import { gcm } from '@noble/ciphers/aes.js';
+import { secp256k1 } from '@noble/curves/secp256k1.js';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { hkdf } from '@noble/hashes/hkdf.js';
+import { hmac } from '@noble/hashes/hmac.js';
+import { bytesToHex, hexToBytes } from '@noble/ciphers/utils.js';
+// ── randomBytes implementation (cross-runtime: browser / Node) ────────────
+export function randomBytes(length) {
+    // browser: crypto.getRandomValues
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        const buf = new Uint8Array(length);
+        crypto.getRandomValues(buf);
+        return buf;
+    }
+    // Node: crypto.randomBytes
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const nodeCrypto = require('crypto');
+    return new Uint8Array(nodeCrypto.randomBytes(length));
+}
+// ── Re-exports for convenience ─────────────────────────────────────────────
+export { bytesToHex, hexToBytes };
+// ── Constants ──────────────────────────────────────────────────────────────
+const AES_KEY_SIZE = 32;
+const IV_SIZE = 12; // GCM recommended
+const TAG_SIZE = 16; // GCM auth tag
+// ── Base64 helpers (cross-runtime) ─────────────────────────────────────────
+function toBase64(bytes) {
+    // Works in browser (btoa + binary) and Node (Buffer)
+    if (typeof Buffer !== 'undefined')
+        return Buffer.from(bytes).toString('base64');
+    let binary = '';
+    for (let i = 0; i < bytes.length; i++)
+        binary += String.fromCharCode(bytes[i]);
+    return btoa(binary);
+}
+function fromBase64(b64) {
+    if (typeof Buffer !== 'undefined')
+        return new Uint8Array(Buffer.from(b64, 'base64'));
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+// ── AES-256-GCM ────────────────────────────────────────────────────────────
+/**
+ * Encrypt with AES-256-GCM.
+ * Wire format (same as aihunter-saas): base64( IV[12] || ciphertext || authTag[16] )
+ */
+export function aesEncrypt(plaintext, keyHex) {
+    const key = hexToBytes(keyHex);
+    const iv = randomBytes(IV_SIZE);
+    const plainBytes = new TextEncoder().encode(plaintext);
+    const cipher = gcm(key, iv);
+    const encrypted = cipher.encrypt(plainBytes);
+    // noble gcm.encrypt returns: ciphertext || authTag(16)
+    const ciphertext = encrypted.subarray(0, -TAG_SIZE);
+    const authTag = encrypted.subarray(-TAG_SIZE);
+    // Pack: IV || ciphertext || authTag
+    const combined = new Uint8Array(IV_SIZE + ciphertext.length + TAG_SIZE);
+    combined.set(iv, 0);
+    combined.set(ciphertext, IV_SIZE);
+    combined.set(authTag, IV_SIZE + ciphertext.length);
+    return toBase64(combined);
+}
+/**
+ * Decrypt AES-256-GCM (same wire format as aihunter-saas).
+ */
+export function aesDecrypt(encryptedBase64, keyHex) {
+    const key = hexToBytes(keyHex);
+    const combined = fromBase64(encryptedBase64);
+    const iv = combined.subarray(0, IV_SIZE);
+    const ciphertext = combined.subarray(IV_SIZE, -TAG_SIZE);
+    const authTag = combined.subarray(-TAG_SIZE);
+    const cipher = gcm(key, iv);
+    // noble decrypt expects: ciphertext || authTag
+    const ciphertextWithTag = new Uint8Array(ciphertext.length + TAG_SIZE);
+    ciphertextWithTag.set(ciphertext, 0);
+    ciphertextWithTag.set(authTag, ciphertext.length);
+    const decrypted = cipher.decrypt(ciphertextWithTag);
+    return new TextDecoder().decode(decrypted);
+}
+/**
+ * Generate a cryptographically random AES-256 key (hex, 64 chars).
+ */
+export function generateAesKey() {
+    return bytesToHex(randomBytes(AES_KEY_SIZE));
+}
+// ── ECIES (secp256k1) ──────────────────────────────────────────────────────
+//
+// eciesjs-compatible wire format:
+//   ephemeralPub(33B compressed) || IV(16B) || ciphertext || MAC(32B)
+//   Encoding: hex
+//
+// HKDF(SHA-256) derives AES key + HMAC key from ECDH shared secret.
+// ---------------------------------------------------------------------------
+function eciesEncode(ephemeralPub, iv, ciphertext, mac) {
+    const out = new Uint8Array(33 + 16 + ciphertext.length + 32);
+    out.set(ephemeralPub, 0);
+    out.set(iv, 33);
+    out.set(ciphertext, 33 + 16);
+    out.set(mac, 33 + 16 + ciphertext.length);
+    return bytesToHex(out);
+}
+function eciesDecode(dataHex) {
+    const d = hexToBytes(dataHex);
+    return {
+        ephemeralPub: d.subarray(0, 33),
+        iv: d.subarray(33, 49),
+        ciphertext: d.subarray(49, -32),
+        mac: d.subarray(-32),
+    };
+}
+// Simple AES-256-CTR implementation on top of @noble/ciphers AES core
+function aesCtrEncrypt(key, ctrBytes, data) {
+    const blockSize = 16;
+    const cipher = gcm(key, ctrBytes); // GCM internally handles CTR
+    // Use noble's CTR approach: encrypt the plaintext directly with the derived stream
+    // noble uses AES-CTR internally for GCM; simpler: implement CTR with AES-ECB
+    const result = new Uint8Array(data.length);
+    const counter = new Uint8Array(blockSize);
+    counter.set(ctrBytes);
+    for (let i = 0; i < data.length; i += blockSize) {
+        const keystream = gcm(key, counter).encrypt(new Uint8Array(blockSize));
+        for (let j = 0; j < blockSize && i + j < data.length; j++) {
+            result[i + j] = keystream[j] ^ data[i + j];
+        }
+        // Increment counter (big-endian)
+        for (let j = blockSize - 1; j >= 0; j--) {
+            const val = counter[j];
+            if (val !== undefined) {
+                counter[j] = (val + 1) & 0xff;
+                if (counter[j] !== 0)
+                    break;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Encrypt data with recipient's secp256k1 public key (ECIES).
+ *
+ * @param dataHex    The data to encrypt (hex, e.g. AES key)
+ * @param publicKey  Recipient's public key (hex, 04-prefixed uncompressed or 02/03 compressed)
+ */
+export function eciesEncrypt(dataHex, publicKey) {
+    // 1. Ephemeral keypair
+    const ephPriv = randomBytes(32);
+    const ephPub = secp256k1.getPublicKey(ephPriv, true); // 33B compressed
+    // 2. Parse recipient public key
+    let recipientPub;
+    if (publicKey.startsWith('04') && publicKey.length === 130) {
+        recipientPub = hexToBytes(publicKey);
+    }
+    else if (publicKey.startsWith('02') || publicKey.startsWith('03')) {
+        recipientPub = hexToBytes(publicKey);
+    }
+    else {
+        throw new Error('Invalid public key format: expected hex with 02/03/04 prefix');
+    }
+    // 3. ECDH
+    const shared = secp256k1.getSharedSecret(ephPriv, recipientPub);
+    const sharedX = shared.subarray(1, 33); // x-coordinate only
+    const sharedKey = sha256(sharedX);
+    // 4. HKDF: encKey(32) || macKey(32)
+    const hkdfOut = hkdf(sha256, sharedKey, undefined, undefined, 64);
+    const encKey = hkdfOut.subarray(0, 32);
+    const macKey = hkdfOut.subarray(32, 64);
+    // 5. AES-256-CTR encrypt
+    const iv = randomBytes(16);
+    const plaintext = hexToBytes(dataHex);
+    const ciphertext = aesCtrEncrypt(encKey, iv, plaintext);
+    // 6. HMAC: MAC(ephemeralPub || IV || ciphertext)
+    const macInput = new Uint8Array(33 + 16 + ciphertext.length);
+    macInput.set(ephPub, 0);
+    macInput.set(iv, 33);
+    macInput.set(ciphertext, 33 + 16);
+    const mac = hmac(sha256, macKey, macInput);
+    return eciesEncode(ephPub, iv, ciphertext, mac);
+}
+/**
+ * Decrypt ECIES ciphertext with recipient's secp256k1 private key.
+ */
+export function eciesDecrypt(dataHex, privateKey) {
+    const { ephemeralPub, iv, ciphertext, mac } = eciesDecode(dataHex);
+    // 1. ECDH
+    const privBytes = hexToBytes(privateKey);
+    const shared = secp256k1.getSharedSecret(privBytes, ephemeralPub);
+    const sharedX = shared.subarray(1, 33);
+    const sharedKey = sha256(sharedX);
+    // 2. HKDF
+    const hkdfOut = hkdf(sha256, sharedKey, undefined, undefined, 64);
+    const encKey = hkdfOut.subarray(0, 32);
+    const macKey = hkdfOut.subarray(32, 64);
+    // 3. Verify MAC
+    const macInput = new Uint8Array(33 + 16 + ciphertext.length);
+    macInput.set(ephemeralPub, 0);
+    macInput.set(iv, 33);
+    macInput.set(ciphertext, 33 + 16);
+    const expectedMac = hmac(sha256, macKey, macInput);
+    if (!constantTimeEqual(mac, expectedMac)) {
+        throw new Error('ECIES decryption failed: MAC mismatch');
+    }
+    // 4. Decrypt
+    const plaintext = aesCtrEncrypt(encKey, iv, ciphertext); // CTR encrypt = decrypt
+    return bytesToHex(plaintext);
+}
+function constantTimeEqual(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a[i] ^ b[i];
+    return diff === 0;
+}
+// ── High-Level: Agent Pack / Unpack ────────────────────────────────────────
+/**
+ * Encrypt an Agent's private payload with AES-256-GCM.
+ */
+export function encryptPayload(payload, keyHex) {
+    const key = keyHex ?? generateAesKey();
+    return {
+        encrypted: true,
+        algorithm: 'AES-256-GCM',
+        data: aesEncrypt(JSON.stringify(payload), key),
+    };
+}
+/**
+ * Decrypt an EncryptedPayload.
+ */
+export function decryptPayload(encrypted, keyHex) {
+    if (encrypted.algorithm !== 'AES-256-GCM') {
+        throw new Error(`Unsupported algorithm: ${encrypted.algorithm}`);
+    }
+    return JSON.parse(aesDecrypt(encrypted.data, keyHex));
+}
+/**
+ * Pack an AgentPayload for publishing.
+ *   1. Split public/private
+ *   2. AES-256-GCM encrypt private part
+ *   3. ECIES wrap AES key with creator's public key
+ */
+export function packAgentForPublish(agent, publicKey, aesKeyHex) {
+    const key = aesKeyHex ?? generateAesKey();
+    const eciesEncryptedKeyHex = eciesEncrypt(key, publicKey);
+    return {
+        encryptedCid: '', // filled after IPFS upload
+        publicCid: '', // filled after IPFS upload
+        aesKeyHex: key,
+        eciesEncryptedKeyHex,
+    };
+}
+/**
+ * Unpack an Agent:
+ *   1. ECIES decrypt the AES key (private key)
+ *   2. AES-256-GCM decrypt the payload
+ */
+export function unpackAgent(encryptedPayload, eciesEncryptedKey, privateKey) {
+    const aesKeyHex = eciesDecrypt(eciesEncryptedKey, privateKey);
+    return decryptPayload(encryptedPayload, aesKeyHex);
+}
+// ── Key Pair Utilities ─────────────────────────────────────────────────────
+/**
+ * Generate a secp256k1 keypair compatible with Ethereum wallets.
+ */
+export function generateKeyPair() {
+    const priv = randomBytes(32);
+    const pub = secp256k1.getPublicKey(priv, false); // uncompressed 04-prefixed
+    return { privateKey: bytesToHex(priv), publicKey: bytesToHex(pub) };
+}
+/**
+ * Derive public key from private key (hex).
+ */
+export function getPublicKey(privateKey) {
+    return bytesToHex(secp256k1.getPublicKey(hexToBytes(privateKey), false));
+}
+//# sourceMappingURL=crypto.js.map

package/dist/core/crypto.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './crypto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/core/index.js

@@ -0,0 +1,4 @@
+// @agentx/sdk — Core module
+export * from './types';
+export * from './crypto';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,296 @@
+export 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)[];
+}
+export 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.
+ */
+export 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. */
+export type SkillExecutionMode = 'open' | 'mcp' | 'a2a';
+export 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.
+ */
+export 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;
+}
+export type McpTransport = 'http' | 'sse' | 'stdio';
+export 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;
+}
+export type PricingType = 'subscription' | 'pay_per_use' | 'free';
+export 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.
+ */
+export 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 */
+export type AgentPublicPayload = Omit<AgentPayload, 'prompt' | 'skills' | 'mcp'>;
+/** Fields that must be encrypted before IPFS upload */
+export type AgentPrivatePayload = Pick<AgentPayload, 'prompt' | 'skills' | 'mcp'>;
+export interface EncryptedPayload {
+    encrypted: true;
+    algorithm: 'AES-256-GCM';
+    /** base64(iv + ciphertext + authTag) */
+    data: string;
+}
+export 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;
+    };
+}
+export 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;
+}
+export 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;
+}
+export interface AgentSearchResult {
+    agents: RegisteredAgent[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export type SubscriptionStatus = 'active' | 'expired' | 'cancelled' | 'pending';
+export interface AgentSubscription {
+    subscriptionId: number;
+    subscriber: string;
+    agentId: number;
+    status: SubscriptionStatus;
+    startedAt: number;
+    expiresAt: number;
+    period: string;
+}
+export type A2ATaskStatus = 'created' | 'accepted' | 'in_progress' | 'completed' | 'failed';
+export 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;
+}
+export 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;
+}
+export interface AgentReputation {
+    agentId: number;
+    averageRating: number;
+    totalRatings: number;
+    reviews: AgentReview[];
+}
+export interface AgentReview {
+    reviewer: string;
+    rating: number;
+    comment: string;
+    timestamp: number;
+}
+export 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;
+}
+export interface AgentXContracts {
+    identityRegistry: `0x${string}`;
+    subscriptionManager: `0x${string}`;
+    paymentGateway: `0x${string}`;
+    a2aProtocolRegistry: `0x${string}`;
+    reputationRegistry: `0x${string}`;
+    configurationRegistry: `0x${string}`;
+}
+export 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;
+}
+export interface UnpackResult {
+    /** Decrypted AgentPayload */
+    agent: AgentPayload;
+    /** CID where the encrypted payload was fetched from */
+    encryptedCid: string;
+    /** CID of the public metadata */
+    publicCid: string;
+}
+export 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"
+}
+export 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.
+ */
+export interface SubscriptionRequired {
+    agentId: number;
+    /** Plan IDs available for this Agent (on-chain query) */
+    plans?: {
+        planId: number;
+        price: bigint;
+        period: string;
+        payToken: string;
+        trialDays: number;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,30 @@
+// ---------------------------------------------------------------------------
+// @agentx/sdk — Core Type Definitions
+// ---------------------------------------------------------------------------
+// Agent = Prompt + Skills[] + MCP
+// All crypto-related "wire" fields (encryptedPayloadCid, eciesEncryptedKey)
+// live in IPFS metadata attributes → existing ERC8004 contracts are unchanged.
+// ---------------------------------------------------------------------------
+// ── Error Types ────────────────────────────────────────────────────────────
+export var AgentXErrorCode;
+(function (AgentXErrorCode) {
+    AgentXErrorCode["NOT_SUBSCRIBED"] = "NOT_SUBSCRIBED";
+    AgentXErrorCode["SUBSCRIPTION_EXPIRED"] = "SUBSCRIPTION_EXPIRED";
+    AgentXErrorCode["DECRYPTION_FAILED"] = "DECRYPTION_FAILED";
+    AgentXErrorCode["IPFS_FETCH_FAILED"] = "IPFS_FETCH_FAILED";
+    AgentXErrorCode["AGENT_NOT_FOUND"] = "AGENT_NOT_FOUND";
+    AgentXErrorCode["INVALID_SCHEMA"] = "INVALID_SCHEMA";
+    AgentXErrorCode["TX_FAILED"] = "TX_FAILED";
+    AgentXErrorCode["WALLET_NOT_CONNECTED"] = "WALLET_NOT_CONNECTED";
+})(AgentXErrorCode || (AgentXErrorCode = {}));
+export class AgentXError extends Error {
+    code;
+    /** If NOT_SUBSCRIBED, carry enough info for wallet/X402 auto-payment */
+    paymentInfo;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AgentXError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAC9E,kCAAkC;AAClC,4EAA4E;AAC5E,+EAA+E;AAC/E,8EAA8E;AA2U9E,8EAA8E;AAE9E,MAAM,CAAN,IAAY,eASX;AATD,WAAY,eAAe;IACzB,oDAAiC,CAAA;IACjC,gEAA6C,CAAA;IAC7C,0DAAuC,CAAA;IACvC,0DAAuC,CAAA;IACvC,sDAAmC,CAAA;IACnC,oDAAiC,CAAA;IACjC,0CAAuB,CAAA;IACvB,gEAA6C,CAAA;AAC/C,CAAC,EATW,eAAe,KAAf,eAAe,QAS1B;AAED,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAiB;IACrB,wEAAwE;IACxE,WAAW,CAAuB;IAClC,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF"}