agent0-sdk 1.6.0 → 1.7.0

package/dist/core/x402-types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * x402 payment-required types and 402 response parsing.
+ */
+/**
+ * A single payment option from a 402 response (PAYMENT-REQUIRED header).
+ * Each entry has at least price and token; optional fields for network, scheme, etc.
+ */
+export interface X402Accept {
+    /** Amount in smallest units (e.g. USDC 6 decimals). May be string for large values. */
+    price: string;
+    /** Token contract address or symbol. */
+    token: string;
+    /** Chain id (number or string e.g. "base-sepolia", "eip155:84532"). */
+    network?: string;
+    scheme?: string;
+    description?: string;
+    /** Max amount required when variable. */
+    maxAmountRequired?: string;
+    /** Destination / pay-to address (recipient or verifying contract). */
+    destination?: string;
+    /** Asset address (alias for token in some 402 body shapes). */
+    asset?: string;
+    /** Additional fields from server (e.g. payTo, paymentRequirements). */
+    [key: string]: unknown;
+}
+/**
+ * Payment-required payload returned when the server responds with HTTP 402.
+ * Always includes accepts[]; when there is a single accept, convenience fields may be set.
+ */
+export interface X402Payment<T = unknown> {
+    /** Array of accepted payment options. Always present. */
+    accepts: X402Accept[];
+    /** x402 version from server's PAYMENT-REQUIRED header (e.g. 1 or 2). */
+    x402Version?: number;
+    /** V1/V2 human-readable error message from 402 response when present. */
+    error?: string;
+    /** V2 ResourceInfo from 402 response when present. */
+    resource?: ResourceInfo;
+    /** When single accept: convenience price (same as accepts[0].price). */
+    price?: string;
+    /** When single accept: convenience token (same as accepts[0].token). */
+    token?: string;
+    /** When single accept: convenience network (same as accepts[0].network). */
+    network?: string;
+    /**
+     * Performs payment and retries the request.
+     * No arg = use single accept; number = accepts[index]; X402Accept = chosen option.
+     * Resolves to the same shape as a successful request (no x402Required).
+     */
+    pay(accept?: X402Accept | number): Promise<T>;
+    /**
+     * When present (deps provided checkBalance): pays using the first accept for which
+     * the signer has sufficient token balance on that chain. Throws if none have sufficient balance.
+     */
+    payFirst?(): Promise<T>;
+}
+/**
+ * Options for the generic x402 HTTP request.
+ */
+export interface X402RequestOptions<T = unknown> {
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+    body?: string | ArrayBuffer | Uint8Array;
+    /**
+     * Optional parser for 2xx response body. If omitted, the body is parsed as JSON (res.json()).
+     */
+    parseResponse?: (response: Response) => Promise<T>;
+    /**
+     * Optional payment to send with the first request (e.g. base64 PAYMENT-SIGNATURE payload).
+     * If provided and server returns 2xx, one round trip; if 402, normal x402 flow.
+     */
+    payment?: string;
+}
+/**
+ * Response when server returns HTTP 402. Caller checks x402Required and may call x402Payment.pay().
+ */
+export interface X402RequiredResponse<T> {
+    x402Required: true;
+    x402Payment: X402Payment<T>;
+}
+/**
+ * Result of sdk.request(): either the parsed success value or the 402 response object.
+ * Success branch is typed with x402Required?: false so you can always read result.x402Required
+ * (undefined/false on success, true on 402) and use if (result.x402Required) to narrow.
+ */
+export type X402RequestResult<T> = (T & {
+    x402Required?: false;
+}) | X402RequiredResponse<T>;
+/**
+ * Type guard: result is 402 response. Returns false for null/undefined.
+ */
+export declare function isX402Required<T>(result: X402RequestResult<T> | null | undefined): result is X402RequiredResponse<T>;
+/** Filter accepts to EVM-only (Solana and other non-EVM options removed). Applied when building 402 response. */
+export declare function filterEvmAccepts(accepts: X402Accept[]): X402Accept[];
+/**
+ * Result of parsing PAYMENT-REQUIRED header (accepts + optional version, resource, error).
+ */
+export interface Parse402FromHeaderResult {
+    accepts: X402Accept[];
+    x402Version?: number;
+    /** V2 PaymentRequired top-level resource (ResourceInfo). Present when server sends it. */
+    resource?: ResourceInfo;
+    /** V1 PaymentRequirementsResponse human-readable error message. Present when server sends it. */
+    error?: string;
+}
+/** V2 ResourceInfo: url, optional description and mimeType (x402 spec §5.1). */
+export interface ResourceInfo {
+    url?: string;
+    description?: string;
+    mimeType?: string;
+}
+/** Settlement response (SettlementResponse / SettleResponse) from PAYMENT-RESPONSE header or body after successful pay. */
+export interface X402SettlementResponse {
+    success: boolean;
+    errorReason?: string;
+    transaction?: string;
+    network?: string;
+    payer?: string;
+}
+/**
+ * Parse PAYMENT-REQUIRED header (x402 spec: base64-encoded JSON with accepts array).
+ * Returns accepts, x402Version, and when present resource (v2) and error (v1).
+ */
+export declare function parse402FromHeader(headerValue: string | null): Parse402FromHeaderResult;
+/**
+ * Parse WWW-Authenticate header with x402 challenge (e.g. 402payment-test.com).
+ * Format: x402 address="0x...", amount="0.01", chainId="8453", token="0x..."
+ * Returns a single accept; amount is converted to atomic units if it looks like a decimal (USDC 6 decimals).
+ */
+export declare function parse402FromWWWAuthenticate(headerValue: string | null): Parse402FromHeaderResult;
+/**
+ * Parse 402 response body (JSON with accepts array). Used when server sends payment options in body (e.g. httpay.xyz).
+ * Returns accepts, x402Version, and when present resource (v2) and error (v1).
+ */
+export declare function parse402FromBody(bodyText: string | null): Parse402FromHeaderResult;
+/**
+ * Parse PAYMENT-REQUIRED header (x402 spec: base64-encoded JSON with accepts array).
+ * Server sends payment options in header; body may be empty. Returns [] if header missing/invalid.
+ */
+export declare function parse402AcceptsFromHeader(headerValue: string | null): X402Accept[];
+/**
+ * Parse PAYMENT-RESPONSE header (base64-encoded JSON) after successful pay.
+ * Returns settlement info (success, transaction, network, payer) when present and valid.
+ */
+export declare function parse402SettlementFromHeader(headerValue: string | null): X402SettlementResponse | undefined;
+//# sourceMappingURL=x402-types.d.ts.map

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

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

package/dist/core/x402-types.js

@@ -0,0 +1,190 @@
+/**
+ * x402 payment-required types and 402 response parsing.
+ */
+/**
+ * Type guard: result is 402 response. Returns false for null/undefined.
+ */
+export function isX402Required(result) {
+    return typeof result === 'object' && result !== null && 'x402Required' in result && result.x402Required === true;
+}
+/** True if the accept is EVM (eip155:* or numeric network). Used to filter out Solana etc. */
+function isEvmAccept(a) {
+    const n = a.network;
+    if (n == null || n === '')
+        return true;
+    const s = String(n);
+    return /^eip155:\d+$/.test(s) || /^\d+$/.test(s);
+}
+/** Filter accepts to EVM-only (Solana and other non-EVM options removed). Applied when building 402 response. */
+export function filterEvmAccepts(accepts) {
+    return accepts.filter(isEvmAccept);
+}
+/**
+ * Normalize a single accept entry from PAYMENT-REQUIRED header (amount/asset/payTo → price/token/destination).
+ */
+function normalizeAcceptEntry(entry) {
+    const pr = entry.paymentRequirements || entry;
+    const price = pr.price ?? pr.amount ?? pr.maxAmountRequired ?? '0';
+    const token = pr.token ?? pr.asset ?? '';
+    return {
+        price: String(price),
+        token: String(token),
+        network: pr.network,
+        scheme: pr.scheme,
+        description: pr.description,
+        maxAmountRequired: pr.maxAmountRequired,
+        destination: pr.destination ?? pr.payTo,
+        asset: pr.asset,
+        ...entry,
+    };
+}
+function decodeBase64(b64) {
+    if (typeof Buffer !== 'undefined') {
+        return Buffer.from(b64, 'base64').toString('utf8');
+    }
+    return atob(b64);
+}
+function parseResourceInfo(obj) {
+    if (obj == null || typeof obj !== 'object' || Array.isArray(obj))
+        return undefined;
+    const r = obj;
+    const url = typeof r.url === 'string' ? r.url : undefined;
+    if (url === undefined)
+        return undefined;
+    return {
+        url,
+        description: typeof r.description === 'string' ? r.description : undefined,
+        mimeType: typeof r.mimeType === 'string' ? r.mimeType : undefined,
+    };
+}
+/**
+ * Parse PAYMENT-REQUIRED header (x402 spec: base64-encoded JSON with accepts array).
+ * Returns accepts, x402Version, and when present resource (v2) and error (v1).
+ */
+export function parse402FromHeader(headerValue) {
+    if (!headerValue || typeof headerValue !== 'string')
+        return { accepts: [] };
+    try {
+        const json = JSON.parse(decodeBase64(headerValue.trim()));
+        if (json == null || typeof json !== 'object')
+            return { accepts: [] };
+        const list = json.accepts;
+        const accepts = Array.isArray(list)
+            ? list
+                .filter((e) => typeof e === 'object' && e !== null)
+                .map(normalizeAcceptEntry)
+            : [];
+        const x402Version = typeof json.x402Version === 'number' ? json.x402Version : undefined;
+        const resource = parseResourceInfo(json.resource);
+        const error = typeof json.error === 'string' ? json.error : undefined;
+        return { accepts, x402Version, resource, error };
+    }
+    catch {
+        return { accepts: [] };
+    }
+}
+/**
+ * Parse WWW-Authenticate header with x402 challenge (e.g. 402payment-test.com).
+ * Format: x402 address="0x...", amount="0.01", chainId="8453", token="0x..."
+ * Returns a single accept; amount is converted to atomic units if it looks like a decimal (USDC 6 decimals).
+ */
+export function parse402FromWWWAuthenticate(headerValue) {
+    if (!headerValue || typeof headerValue !== 'string')
+        return { accepts: [] };
+    const x402Match = headerValue.match(/\bx402\s+(.+)/i);
+    if (!x402Match)
+        return { accepts: [] };
+    const rest = x402Match[1];
+    const pairs = {};
+    const re = /(\w+)\s*=\s*([^\s,]+|"[^"]*")/g;
+    let m;
+    while ((m = re.exec(rest)) !== null) {
+        const key = m[1].toLowerCase();
+        let val = m[2];
+        if (val.startsWith('"') && val.endsWith('"'))
+            val = val.slice(1, -1);
+        pairs[key] = val;
+    }
+    const address = pairs.address ?? pairs.payto;
+    const amount = pairs.amount ?? '0';
+    const chainId = pairs.chainid ?? pairs.chain_id ?? '';
+    const token = pairs.token ?? pairs.asset ?? '';
+    if (!address || !token)
+        return { accepts: [] };
+    // If amount looks like decimal (e.g. "0.01"), assume USDC 6 decimals for atomic units
+    let price = amount;
+    if (/^\d*\.\d+$/.test(amount)) {
+        const n = parseFloat(amount);
+        if (Number.isFinite(n))
+            price = String(Math.round(n * 1e6));
+    }
+    const networkStr = chainId ? (chainId.includes(':') ? chainId : `eip155:${chainId}`) : undefined;
+    const accept = {
+        price,
+        token,
+        destination: address,
+        payTo: address,
+        network: networkStr,
+        scheme: 'exact',
+    };
+    // Servers that advertise chainId (e.g. 402payment-test.com) often expect v2 (PAYMENT-SIGNATURE + CAIP-2).
+    const x402Version = networkStr && /^eip155:\d+$/.test(networkStr) ? 2 : 1;
+    return { accepts: [accept], x402Version };
+}
+/**
+ * Parse 402 response body (JSON with accepts array). Used when server sends payment options in body (e.g. httpay.xyz).
+ * Returns accepts, x402Version, and when present resource (v2) and error (v1).
+ */
+export function parse402FromBody(bodyText) {
+    if (!bodyText || typeof bodyText !== 'string')
+        return { accepts: [] };
+    try {
+        const json = JSON.parse(bodyText.trim());
+        if (json == null || typeof json !== 'object')
+            return { accepts: [] };
+        const list = json.accepts;
+        const accepts = Array.isArray(list)
+            ? list
+                .filter((e) => typeof e === 'object' && e !== null)
+                .map(normalizeAcceptEntry)
+            : [];
+        const x402Version = typeof json.x402Version === 'number' ? json.x402Version : undefined;
+        const resource = parseResourceInfo(json.resource);
+        const error = typeof json.error === 'string' ? json.error : undefined;
+        return { accepts, x402Version, resource, error };
+    }
+    catch {
+        return { accepts: [] };
+    }
+}
+/**
+ * Parse PAYMENT-REQUIRED header (x402 spec: base64-encoded JSON with accepts array).
+ * Server sends payment options in header; body may be empty. Returns [] if header missing/invalid.
+ */
+export function parse402AcceptsFromHeader(headerValue) {
+    return parse402FromHeader(headerValue).accepts;
+}
+/**
+ * Parse PAYMENT-RESPONSE header (base64-encoded JSON) after successful pay.
+ * Returns settlement info (success, transaction, network, payer) when present and valid.
+ */
+export function parse402SettlementFromHeader(headerValue) {
+    if (!headerValue || typeof headerValue !== 'string')
+        return undefined;
+    try {
+        const json = JSON.parse(decodeBase64(headerValue.trim()));
+        if (json == null || typeof json !== 'object')
+            return undefined;
+        return {
+            success: json.success === true,
+            errorReason: typeof json.errorReason === 'string' ? json.errorReason : undefined,
+            transaction: typeof json.transaction === 'string' ? json.transaction : undefined,
+            network: typeof json.network === 'string' ? json.network : undefined,
+            payer: typeof json.payer === 'string' ? json.payer : undefined,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=x402-types.js.map

package/dist/core/x402-types.js.map

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

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './utils/index.js';
 export { SDK } from './core/sdk.js';
 export type { SDKConfig } from './core/sdk.js';
 export { Agent } from './core/agent.js';
+export { A2AClientFromSummary } from './core/a2a-summary-client.js';
 export { ViemChainClient } from './core/viem-chain-client.js';
 export type { ChainClient, TransactionOptions } from './core/chain-client.js';
 export { IPFSClient } from './core/ipfs-client.js';
@@ -19,4 +20,6 @@ export { AgentIndexer } from './core/indexer.js';
 export { TransactionHandle } from './core/transaction-handle.js';
 export type { TransactionMined, TransactionWaitOptions } from './core/transaction-handle.js';
 export * from './core/contracts.js';
+export type { X402Accept, X402Payment, X402RequestOptions, X402RequiredResponse, X402RequestResult, ResourceInfo, X402SettlementResponse, Parse402FromHeaderResult, } from './core/x402-types.js';
+export { isX402Required, parse402AcceptsFromHeader, parse402FromBody, parse402FromHeader, parse402SettlementFromHeader, parse402FromWWWAuthenticate, } from './core/x402-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAG7F,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAG7F,cAAc,qBAAqB,CAAC;AAGpC,YAAY,EACV,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@ export * from './utils/index.js';
 // Export core classes
 export { SDK } from './core/sdk.js';
 export { Agent } from './core/agent.js';
+export { A2AClientFromSummary } from './core/a2a-summary-client.js';
 export { ViemChainClient } from './core/viem-chain-client.js';
 export { IPFSClient } from './core/ipfs-client.js';
 export { SubgraphClient } from './core/subgraph-client.js';
@@ -18,4 +19,5 @@ export { AgentIndexer } from './core/indexer.js';
 export { TransactionHandle } from './core/transaction-handle.js';
 // Export contract definitions
 export * from './core/contracts.js';
+export { isX402Required, parse402AcceptsFromHeader, parse402FromBody, parse402FromHeader, parse402SettlementFromHeader, parse402FromWWWAuthenticate, } from './core/x402-types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAElC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,sBAAsB;AACtB,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE,8BAA8B;AAC9B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAElC,mBAAmB;AACnB,cAAc,kBAAkB,CAAC;AAEjC,sBAAsB;AACtB,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGjE,8BAA8B;AAC9B,cAAc,qBAAqB,CAAC;AAapC,OAAO,EACL,cAAc,EACd,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAC"}

package/dist/models/a2a.d.ts

@@ -0,0 +1,176 @@
+/**
+ * A2A (Agent-to-Agent) types.
+ */
+/** Credential as object; string is normalized to { apiKey: string }. */
+export interface CredentialObject {
+    apiKey?: string;
+    bearer?: string;
+    [key: string]: unknown;
+}
+/** Options for messageA2A (blocking, contextId, taskId, credential, payment per §2.1, §4.2). */
+export interface MessageA2AOptions {
+    blocking?: boolean;
+    contextId?: string;
+    taskId?: string;
+    /** When the agent's endpoint requires auth: string (→ apiKey) or object (e.g. { apiKey } or { bearer }). */
+    credential?: string | CredentialObject;
+    /** Optional payment payload (e.g. base64 PAYMENT-SIGNATURE) to send with the first request; if server accepts, 2xx and no 402. */
+    payment?: string;
+    /** SendMessageConfiguration: accepted output modes (e.g. stream, push). */
+    acceptedOutputModes?: string[];
+    /** SendMessageConfiguration: requested history length for the task. */
+    historyLength?: number;
+    /** SendMessageConfiguration: push notification config (v0.3 / v1). */
+    pushNotificationConfig?: Record<string, unknown>;
+    /** SendMessageConfiguration: return immediately without waiting (v1). */
+    returnImmediately?: boolean;
+}
+/** OpenAPI-style apiKey scheme: where to send the value and under what name. */
+export interface SecuritySchemeApiKey {
+    type: 'apiKey';
+    in: 'header' | 'query' | 'cookie';
+    name: string;
+    description?: string;
+}
+/** OpenAPI-style http (Bearer) scheme. */
+export interface SecuritySchemeHttp {
+    type: 'http';
+    scheme: 'bearer' | 'basic';
+    bearerFormat?: string;
+    description?: string;
+}
+/** Supported A2A security scheme types (per spec §2.5). */
+export type SecurityScheme = SecuritySchemeApiKey | SecuritySchemeHttp;
+/** AgentCard auth shape: securitySchemes and which are required. */
+export interface AgentCardAuth {
+    securitySchemes?: Record<string, SecurityScheme>;
+    security?: Array<Record<string, string[]>>;
+}
+/**
+ * Part: smallest unit of content in a Message or Artifact.
+ * Per A2A Protocol: text, url, data, or raw.
+ */
+export interface Part {
+    text?: string;
+    url?: string;
+    data?: string;
+    raw?: string;
+    [key: string]: unknown;
+}
+/**
+ * Direct message response from an A2A server (no task created).
+ * No `task` or `taskId`; discriminate from TaskResponse by 'task' in msg.
+ * Has x402Required?: false so you can use if (result.x402Required) to detect 402.
+ */
+export interface MessageResponse {
+    x402Required?: false;
+    content?: string;
+    parts?: Part[];
+    contextId?: string;
+}
+/**
+ * Task state returned by task.query() or after cancel.
+ * Server-specific status values; common: open, working, completed, failed, canceled, rejected.
+ */
+export interface TaskState {
+    state?: string;
+    [key: string]: unknown;
+}
+/**
+ * When an A2A request returns HTTP 402. Caller may call x402Payment.pay() to pay and retry.
+ * Compatible with X402RequiredResponse from core/x402-types (used by a2a-client).
+ */
+export interface A2APaymentRequired<T = unknown> {
+    x402Required: true;
+    x402Payment: {
+        pay(accept?: unknown): Promise<T>;
+        /** When present: pays using first accept with sufficient token balance. */
+        payFirst?(): Promise<T>;
+        accepts: unknown[];
+        price?: string;
+        token?: string;
+        network?: string;
+    };
+}
+/** Result of task.query(): state or 402. */
+export type TaskQueryResult = {
+    taskId: string;
+    contextId: string;
+    status?: TaskState;
+    artifacts?: unknown[];
+    messages?: unknown[];
+};
+/** Result of task.cancel(): state or 402. */
+export type TaskCancelResult = {
+    taskId: string;
+    contextId: string;
+    status?: TaskState;
+};
+/** Summary of a task returned by listTasks. */
+export interface TaskSummary {
+    x402Required?: false;
+    taskId: string;
+    contextId: string;
+    status?: TaskState;
+    /** Optional message history when historyLength > 0. */
+    messages?: unknown[];
+    [key: string]: unknown;
+}
+/** Options for listTasks (filter, historyLength, credential, payment per §2.3, §4.2). */
+export interface ListTasksOptions {
+    filter?: {
+        contextId?: string;
+        status?: string;
+        [key: string]: unknown;
+    };
+    historyLength?: number;
+    credential?: string | CredentialObject;
+    /** Optional payment payload to send with the first request; if server accepts, 2xx and no 402. */
+    payment?: string;
+}
+/**
+ * Task handle: read-only taskId, contextId, and methods query, message, cancel.
+ * Returned by response.task and by agent.loadTask(taskId).
+ * Methods may return 402 (A2APaymentRequired); use pay() to retry.
+ */
+export interface AgentTask {
+    readonly taskId: string;
+    readonly contextId: string;
+    query(options?: {
+        historyLength?: number;
+    }): Promise<TaskQueryResult | A2APaymentRequired<TaskQueryResult>>;
+    message(content: string | {
+        parts: Part[];
+    }): Promise<MessageResponse | TaskResponse | A2APaymentRequired<MessageResponse | TaskResponse>>;
+    cancel(): Promise<TaskCancelResult | A2APaymentRequired<TaskCancelResult>>;
+}
+/**
+ * Response when the server created a task.
+ * Discriminate from MessageResponse by 'task' in response.
+ * Has x402Required?: false so you can use if (result.x402Required) to detect 402.
+ */
+export interface TaskResponse {
+    x402Required?: false;
+    taskId: string;
+    contextId: string;
+    task: AgentTask;
+    /** Optional task snapshot from send response */
+    status?: TaskState;
+}
+/** Options for loadTask (credential, payment). */
+export interface LoadTaskOptions {
+    credential?: string | CredentialObject;
+    payment?: string;
+}
+/**
+ * Interface for A2A-capable clients. Implemented by Agent and A2AClientFromSummary
+ * so that loaded agents and agent summaries can be used interchangeably for A2A.
+ */
+export interface A2AClient {
+    messageA2A(content: string | {
+        parts: Part[];
+    }, options?: MessageA2AOptions): Promise<MessageResponse | TaskResponse | A2APaymentRequired<MessageResponse | TaskResponse>>;
+    listTasks(options?: ListTasksOptions): Promise<TaskSummary[] | A2APaymentRequired<TaskSummary[]>>;
+    loadTask(taskId: string, options?: LoadTaskOptions): Promise<AgentTask | A2APaymentRequired<AgentTask>>;
+}
+//# sourceMappingURL=a2a.d.ts.map

package/dist/models/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../../src/models/a2a.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,kIAAkI;IAClI,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,kBAAkB,CAAC;AAEvE,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,IAAI;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW,EAAE;QACX,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,2EAA2E;QAC3E,QAAQ,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED,4CAA4C;AAC5C,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAErI,6CAA6C;AAC7C,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAEzF,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC;IAC5G,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,GAAG,YAAY,GAAG,kBAAkB,CAAC,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC;IAC3I,MAAM,IAAI,OAAO,CAAC,gBAAgB,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC;CAC5E;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,CACR,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,EACnC,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,eAAe,GAAG,YAAY,GAAG,kBAAkB,CAAC,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC;IAChG,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,GAAG,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAClG,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,SAAS,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC,CAAC;CACvD"}

package/dist/models/a2a.js

@@ -0,0 +1,5 @@
+/**
+ * A2A (Agent-to-Agent) types.
+ */
+export {};
+//# sourceMappingURL=a2a.js.map

package/dist/models/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../../src/models/a2a.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/models/index.d.ts

@@ -5,4 +5,5 @@
 export * from './types.js';
 export * from './enums.js';
 export * from './interfaces.js';
+export * from './a2a.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/dist/models/index.js

@@ -5,4 +5,5 @@
 export * from './types.js';
 export * from './enums.js';
 export * from './interfaces.js';
+export * from './a2a.js';
 //# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent0-sdk",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "TypeScript SDK for agent portability, discovery and trust based on ERC-8004",
   "type": "module",
   "main": "dist/index.js",
@@ -26,6 +26,14 @@
     "test": "jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
+    "x402-server": "node tests/x402-server/server.mjs",
+    "test:x402-integration": "RUN_X402_INTEGRATION=1 jest --testPathPattern=x402-integration",
+    "test:x402-anvil": "RUN_X402_ANVIL=1 jest --testPathPattern=x402-anvil",
+    "a2a-server": "node tests/a2a-server/server.mjs",
+    "test:a2a-integration": "RUN_A2A_INTEGRATION=1 jest --testPathPattern=a2a-integration",
+    "test:a2a-anvil": "RUN_A2A_ANVIL=1 jest --testPathPattern=a2a-anvil",
+    "forge:build": "forge build",
+    "anvil:node": "anvil --port 8545",
     "lint": "eslint src",
     "format": "prettier --write src",
     "clean": "rm -rf dist"