@nevermined-io/payments 1.7.0 → 1.9.0

package/README.md

@@ -389,7 +389,8 @@ payments.mcp.registerPrompt(
 ```typescript
 const { info, stop } = await payments.mcp.start({
   port: 3002,
-  agentId: process.env.NVM_AGENT_ID!,
+  planId: process.env.NVM_PLAN_ID!,
+  agentId: process.env.NVM_AGENT_ID, // optional — informational only
   serverName: 'weather-mcp',
   version: '0.1.0',
 })

package/dist/a2a/agent-card.d.ts

@@ -10,6 +10,32 @@
  * information about pricing, credits, and payment configuration.
  */
 import type { AgentCard } from './types.js';
+/**
+ * Canonical A2A agent-card discovery path (A2A 0.3+ and `@a2a-js/sdk`'s own
+ * default, per RFC 8615). Served by Nevermined A2A agents and used as the
+ * default when fetching a remote agent's card.
+ */
+export declare const AGENT_CARD_WELL_KNOWN_PATH = ".well-known/agent-card.json";
+/**
+ * Legacy pre-0.3 discovery path. Still served as a backward-compat alias and
+ * tried as a fetch fallback, so newly-updated clients keep working against
+ * Nevermined agents that have not adopted the canonical path yet.
+ * TODO(a2a): drop the alias + fallback one release after agents are updated.
+ */
+export declare const LEGACY_AGENT_CARD_WELL_KNOWN_PATH = ".well-known/agent.json";
+/**
+ * Nevermined's own payment extension URI. Carries the agent/plan params the
+ * Nevermined paywall reads (agentId, planId, redemptionConfig, …). Kept for one
+ * release alongside the official a2a-x402 extension below for backward compat.
+ */
+export declare const NVM_PAYMENT_EXTENSION_URI = "urn:nevermined:payment";
+/**
+ * Official a2a-x402 extension URI (x402 v2 A2A transport). Declaring it tells
+ * generic A2A clients this agent speaks the standards-compliant in-band x402
+ * flow (payment signalled through Task / Message `x402.payment.*` metadata).
+ * @see https://github.com/google-agentic-commerce/a2a-x402
+ */
+export declare const A2A_X402_EXTENSION_URI = "https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.2";
 /**
  * Payment/pricing information to be included in the AgentCard extensions.
  *

package/dist/a2a/agent-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,WAAW,EAAE,OAAO,GAAG,SAAS,CAAA;IAChC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,EACnB,eAAe,EAAE,wBAAwB,GACxC,SAAS,CAyCX"}
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,gCAAgC,CAAA;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,2BAA2B,CAAA;AAEzE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,2BAA2B,CAAA;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,4EACwC,CAAA;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,WAAW,EAAE,OAAO,GAAG,SAAS,CAAA;IAChC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0CAA0C;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,EACnB,eAAe,EAAE,wBAAwB,GACxC,SAAS,CAmDX"}

package/dist/a2a/agent-card.js

@@ -9,6 +9,32 @@
  * The payment extension uses the URI 'urn:nevermined:payment' and includes
  * information about pricing, credits, and payment configuration.
  */
+/**
+ * Canonical A2A agent-card discovery path (A2A 0.3+ and `@a2a-js/sdk`'s own
+ * default, per RFC 8615). Served by Nevermined A2A agents and used as the
+ * default when fetching a remote agent's card.
+ */
+export const AGENT_CARD_WELL_KNOWN_PATH = '.well-known/agent-card.json';
+/**
+ * Legacy pre-0.3 discovery path. Still served as a backward-compat alias and
+ * tried as a fetch fallback, so newly-updated clients keep working against
+ * Nevermined agents that have not adopted the canonical path yet.
+ * TODO(a2a): drop the alias + fallback one release after agents are updated.
+ */
+export const LEGACY_AGENT_CARD_WELL_KNOWN_PATH = '.well-known/agent.json';
+/**
+ * Nevermined's own payment extension URI. Carries the agent/plan params the
+ * Nevermined paywall reads (agentId, planId, redemptionConfig, …). Kept for one
+ * release alongside the official a2a-x402 extension below for backward compat.
+ */
+export const NVM_PAYMENT_EXTENSION_URI = 'urn:nevermined:payment';
+/**
+ * Official a2a-x402 extension URI (x402 v2 A2A transport). Declaring it tells
+ * generic A2A clients this agent speaks the standards-compliant in-band x402
+ * flow (payment signalled through Task / Message `x402.payment.*` metadata).
+ * @see https://github.com/google-agentic-commerce/a2a-x402
+ */
+export const A2A_X402_EXTENSION_URI = 'https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.2';
 /**
  * Builds an AgentCard with payment/pricing metadata in the capabilities.extensions field.
  *
@@ -83,12 +109,21 @@ export function buildPaymentAgentCard(baseCard, paymentMetadata) {
             extensions: [
                 ...(baseCard.capabilities?.extensions || []),
                 {
-                    uri: 'urn:nevermined:payment',
+                    uri: NVM_PAYMENT_EXTENSION_URI,
                     description: paymentMetadata.costDescription,
                     required: false,
                     // explicit type assertion to satisfy {[key: string]: unknown}
                     params: paymentMetadata,
                 },
+                // Official a2a-x402 extension: signals to generic A2A clients that this
+                // agent supports the standards-compliant in-band x402 v2 payment flow.
+                // Kept additive alongside the Nevermined extension for one release.
+                {
+                    uri: A2A_X402_EXTENSION_URI,
+                    description: paymentMetadata.costDescription ||
+                        'Supports payments using the x402 protocol for on-chain settlement.',
+                    required: false,
+                },
             ],
         },
     };

package/dist/a2a/agent-card.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiCH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAmB,EACnB,eAAyC;IAEzC,2BAA2B;IAC3B,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAC5C,CAAC;IAED,wDAAwD;IACxD,IAAI,eAAe,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC/C,CAAC;IAED,8CAA8C;IAC9C,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,wEAAwE;IAC1E,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,IAAI,CAAC,eAAe,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;IACxC,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,YAAY,EAAE;YACZ,GAAG,QAAQ,CAAC,YAAY;YACxB,UAAU,EAAE;gBACV,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,IAAI,EAAE,CAAC;gBAC5C;oBACE,GAAG,EAAE,wBAAwB;oBAC7B,WAAW,EAAE,eAAe,CAAC,eAAe;oBAC5C,QAAQ,EAAE,KAAK;oBACf,8DAA8D;oBAC9D,MAAM,EAAE,eAA6C;iBACtD;aACF;SACF;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Helper to build an AgentCard with payment/pricing metadata for A2A agents.\n *\n * This module provides utilities for creating A2A agent cards that include\n * payment and pricing information in a standardized way. The payment metadata\n * is embedded in the agent card's capabilities.extensions field following\n * the A2A standard for extensibility.\n *\n * The payment extension uses the URI 'urn:nevermined:payment' and includes\n * information about pricing, credits, and payment configuration.\n */\n\nimport type { AgentCard } from './types.js'\n\n/**\n * Payment/pricing information to be included in the AgentCard extensions.\n *\n * This interface defines the structure for payment metadata that will be\n * embedded in the agent card. The metadata includes information about:\n * - Payment type (fixed or dynamic pricing)\n * - Credit requirements\n * - Plan identification\n * - Cost descriptions\n *\n * Must be compatible with `{[key: string]: unknown}` to comply with A2A standard.\n */\nexport interface PaymentAgentCardMetadata {\n  /** Type of payment model - 'fixed' for set prices, 'dynamic' for variable pricing */\n  paymentType: 'fixed' | 'dynamic'\n  /** Number of credits required for this agent's services (0 for trial plans) */\n  credits: number\n  /** Optional plan ID associated with this agent */\n  planId?: string\n  /** The agent ID for payment validation and tracking */\n  agentId: string\n  /** Human-readable description of the cost */\n  costDescription?: string\n  /** Whether this is a trial plan (allows 0 credits) */\n  isTrialPlan?: boolean\n  /** Additional payment-related metadata */\n  [key: string]: unknown // For compatibility with AgentExtension.params\n}\n\n/**\n * Builds an AgentCard with payment/pricing metadata in the capabilities.extensions field.\n *\n * This function takes a base agent card and payment metadata, then creates a new\n * agent card that includes the payment information in a standardized extension.\n * The payment extension follows the A2A standard for extensibility and uses the\n * URI 'urn:nevermined:payment' to identify payment-related capabilities.\n *\n * The resulting agent card can be used with the PaymentsA2AServer to provide\n * payment-enabled A2A agent functionality.\n *\n * @param baseCard - The base AgentCard (without payment info)\n * @param paymentMetadata - The payment/pricing metadata to include\n * @returns The AgentCard with payment info in capabilities.extensions\n *\n * @example\n * ```typescript\n * const baseCard: AgentCard = {\n *   name: 'My AI Assistant',\n *   description: 'An AI assistant that helps with various tasks',\n *   capabilities: {\n *     tools: ['text-generation', 'image-analysis'],\n *     extensions: []\n *   }\n * }\n *\n * const paymentMetadata: PaymentAgentCardMetadata = {\n *   paymentType: 'fixed',\n *   credits: 10,\n *   agentId: 'agent-123',\n *   planId: 'plan-456',\n *   costDescription: '10 credits per request'\n * }\n *\n * const paymentCard = buildPaymentAgentCard(baseCard, paymentMetadata)\n *\n * // Use with PaymentsA2AServer\n * PaymentsA2AServer.start({\n *   agentCard: paymentCard,\n *   executor: new MyExecutor(),\n *   paymentsService: payments,\n *   port: 41242\n * })\n * ```\n */\nexport function buildPaymentAgentCard(\n  baseCard: AgentCard,\n  paymentMetadata: PaymentAgentCardMetadata,\n): AgentCard {\n  // Validate required fields\n  if (!paymentMetadata.paymentType) {\n    throw new Error('paymentType is required')\n  }\n\n  // Validate credits - negative credits are never allowed\n  if (paymentMetadata.credits < 0) {\n    throw new Error('credits cannot be negative')\n  }\n\n  // Validate credits based on trial plan status\n  if (paymentMetadata.isTrialPlan) {\n    // Trial plans can have 0 credits (already validated not negative above)\n  } else {\n    // Non-trial plans must have positive credits\n    if (!paymentMetadata.credits || paymentMetadata.credits <= 0) {\n      throw new Error('credits must be a positive number for paid plans')\n    }\n  }\n\n  if (!paymentMetadata.agentId) {\n    throw new Error('agentId is required')\n  }\n\n  return {\n    ...baseCard,\n    capabilities: {\n      ...baseCard.capabilities,\n      extensions: [\n        ...(baseCard.capabilities?.extensions || []),\n        {\n          uri: 'urn:nevermined:payment',\n          description: paymentMetadata.costDescription,\n          required: false,\n          // explicit type assertion to satisfy {[key: string]: unknown}\n          params: paymentMetadata as { [key: string]: unknown },\n        },\n      ],\n    },\n  }\n}\n"]}
+{"version":3,"file":"agent-card.js","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,6BAA6B,CAAA;AAEvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,wBAAwB,CAAA;AAEzE;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,yEAAyE,CAAA;AA+B3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAmB,EACnB,eAAyC;IAEzC,2BAA2B;IAC3B,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IAC5C,CAAC;IAED,wDAAwD;IACxD,IAAI,eAAe,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;IAC/C,CAAC;IAED,8CAA8C;IAC9C,IAAI,eAAe,CAAC,WAAW,EAAE,CAAC;QAChC,wEAAwE;IAC1E,CAAC;SAAM,CAAC;QACN,6CAA6C;QAC7C,IAAI,CAAC,eAAe,CAAC,OAAO,IAAI,eAAe,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACrE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;IACxC,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,YAAY,EAAE;YACZ,GAAG,QAAQ,CAAC,YAAY;YACxB,UAAU,EAAE;gBACV,GAAG,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,IAAI,EAAE,CAAC;gBAC5C;oBACE,GAAG,EAAE,yBAAyB;oBAC9B,WAAW,EAAE,eAAe,CAAC,eAAe;oBAC5C,QAAQ,EAAE,KAAK;oBACf,8DAA8D;oBAC9D,MAAM,EAAE,eAA6C;iBACtD;gBACD,wEAAwE;gBACxE,uEAAuE;gBACvE,oEAAoE;gBACpE;oBACE,GAAG,EAAE,sBAAsB;oBAC3B,WAAW,EACT,eAAe,CAAC,eAAe;wBAC/B,oEAAoE;oBACtE,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * Helper to build an AgentCard with payment/pricing metadata for A2A agents.\n *\n * This module provides utilities for creating A2A agent cards that include\n * payment and pricing information in a standardized way. The payment metadata\n * is embedded in the agent card's capabilities.extensions field following\n * the A2A standard for extensibility.\n *\n * The payment extension uses the URI 'urn:nevermined:payment' and includes\n * information about pricing, credits, and payment configuration.\n */\n\nimport type { AgentCard } from './types.js'\n\n/**\n * Canonical A2A agent-card discovery path (A2A 0.3+ and `@a2a-js/sdk`'s own\n * default, per RFC 8615). Served by Nevermined A2A agents and used as the\n * default when fetching a remote agent's card.\n */\nexport const AGENT_CARD_WELL_KNOWN_PATH = '.well-known/agent-card.json'\n\n/**\n * Legacy pre-0.3 discovery path. Still served as a backward-compat alias and\n * tried as a fetch fallback, so newly-updated clients keep working against\n * Nevermined agents that have not adopted the canonical path yet.\n * TODO(a2a): drop the alias + fallback one release after agents are updated.\n */\nexport const LEGACY_AGENT_CARD_WELL_KNOWN_PATH = '.well-known/agent.json'\n\n/**\n * Nevermined's own payment extension URI. Carries the agent/plan params the\n * Nevermined paywall reads (agentId, planId, redemptionConfig, …). Kept for one\n * release alongside the official a2a-x402 extension below for backward compat.\n */\nexport const NVM_PAYMENT_EXTENSION_URI = 'urn:nevermined:payment'\n\n/**\n * Official a2a-x402 extension URI (x402 v2 A2A transport). Declaring it tells\n * generic A2A clients this agent speaks the standards-compliant in-band x402\n * flow (payment signalled through Task / Message `x402.payment.*` metadata).\n * @see https://github.com/google-agentic-commerce/a2a-x402\n */\nexport const A2A_X402_EXTENSION_URI =\n  'https://github.com/google-agentic-commerce/a2a-x402/blob/main/spec/v0.2'\n\n/**\n * Payment/pricing information to be included in the AgentCard extensions.\n *\n * This interface defines the structure for payment metadata that will be\n * embedded in the agent card. The metadata includes information about:\n * - Payment type (fixed or dynamic pricing)\n * - Credit requirements\n * - Plan identification\n * - Cost descriptions\n *\n * Must be compatible with `{[key: string]: unknown}` to comply with A2A standard.\n */\nexport interface PaymentAgentCardMetadata {\n  /** Type of payment model - 'fixed' for set prices, 'dynamic' for variable pricing */\n  paymentType: 'fixed' | 'dynamic'\n  /** Number of credits required for this agent's services (0 for trial plans) */\n  credits: number\n  /** Optional plan ID associated with this agent */\n  planId?: string\n  /** The agent ID for payment validation and tracking */\n  agentId: string\n  /** Human-readable description of the cost */\n  costDescription?: string\n  /** Whether this is a trial plan (allows 0 credits) */\n  isTrialPlan?: boolean\n  /** Additional payment-related metadata */\n  [key: string]: unknown // For compatibility with AgentExtension.params\n}\n\n/**\n * Builds an AgentCard with payment/pricing metadata in the capabilities.extensions field.\n *\n * This function takes a base agent card and payment metadata, then creates a new\n * agent card that includes the payment information in a standardized extension.\n * The payment extension follows the A2A standard for extensibility and uses the\n * URI 'urn:nevermined:payment' to identify payment-related capabilities.\n *\n * The resulting agent card can be used with the PaymentsA2AServer to provide\n * payment-enabled A2A agent functionality.\n *\n * @param baseCard - The base AgentCard (without payment info)\n * @param paymentMetadata - The payment/pricing metadata to include\n * @returns The AgentCard with payment info in capabilities.extensions\n *\n * @example\n * ```typescript\n * const baseCard: AgentCard = {\n *   name: 'My AI Assistant',\n *   description: 'An AI assistant that helps with various tasks',\n *   capabilities: {\n *     tools: ['text-generation', 'image-analysis'],\n *     extensions: []\n *   }\n * }\n *\n * const paymentMetadata: PaymentAgentCardMetadata = {\n *   paymentType: 'fixed',\n *   credits: 10,\n *   agentId: 'agent-123',\n *   planId: 'plan-456',\n *   costDescription: '10 credits per request'\n * }\n *\n * const paymentCard = buildPaymentAgentCard(baseCard, paymentMetadata)\n *\n * // Use with PaymentsA2AServer\n * PaymentsA2AServer.start({\n *   agentCard: paymentCard,\n *   executor: new MyExecutor(),\n *   paymentsService: payments,\n *   port: 41242\n * })\n * ```\n */\nexport function buildPaymentAgentCard(\n  baseCard: AgentCard,\n  paymentMetadata: PaymentAgentCardMetadata,\n): AgentCard {\n  // Validate required fields\n  if (!paymentMetadata.paymentType) {\n    throw new Error('paymentType is required')\n  }\n\n  // Validate credits - negative credits are never allowed\n  if (paymentMetadata.credits < 0) {\n    throw new Error('credits cannot be negative')\n  }\n\n  // Validate credits based on trial plan status\n  if (paymentMetadata.isTrialPlan) {\n    // Trial plans can have 0 credits (already validated not negative above)\n  } else {\n    // Non-trial plans must have positive credits\n    if (!paymentMetadata.credits || paymentMetadata.credits <= 0) {\n      throw new Error('credits must be a positive number for paid plans')\n    }\n  }\n\n  if (!paymentMetadata.agentId) {\n    throw new Error('agentId is required')\n  }\n\n  return {\n    ...baseCard,\n    capabilities: {\n      ...baseCard.capabilities,\n      extensions: [\n        ...(baseCard.capabilities?.extensions || []),\n        {\n          uri: NVM_PAYMENT_EXTENSION_URI,\n          description: paymentMetadata.costDescription,\n          required: false,\n          // explicit type assertion to satisfy {[key: string]: unknown}\n          params: paymentMetadata as { [key: string]: unknown },\n        },\n        // Official a2a-x402 extension: signals to generic A2A clients that this\n        // agent supports the standards-compliant in-band x402 v2 payment flow.\n        // Kept additive alongside the Nevermined extension for one release.\n        {\n          uri: A2A_X402_EXTENSION_URI,\n          description:\n            paymentMetadata.costDescription ||\n            'Supports payments using the x402 protocol for on-chain settlement.',\n          required: false,\n        },\n      ],\n    },\n  }\n}\n"]}

package/dist/a2a/paymentsClient.d.ts

@@ -18,7 +18,7 @@ export declare class PaymentsClient extends A2AClient {
      * @param payments - The Payments object.
      * @param agentId - The ID of the agent.
      * @param planId - The ID of the plan.
-     * @param agentCardPath - Optional path to the agent card relative to base URL (defaults to '.well-known/agent.json').
+     * @param agentCardPath - Optional path to the agent card relative to base URL (defaults to '.well-known/agent-card.json').
      */
     private constructor();
     /**
@@ -26,6 +26,13 @@ export declare class PaymentsClient extends A2AClient {
      * constructing the underlying A2AClient with the AgentCard object.
      */
     static create(agentBaseUrl: string, payments: Payments, agentId: string, planId: string, agentCardPath?: string, delegationConfig?: DelegationConfig): Promise<PaymentsClient>;
+    /**
+     * Fetches a remote agent card, trying the requested (canonical) path first and
+     * falling back to the legacy '.well-known/agent.json' so updated clients keep
+     * working against agents that have not adopted the canonical path yet.
+     * TODO(a2a): drop the fallback one release after agents are updated.
+     */
+    private static _fetchAgentCard;
     /**
      * Gets and caches the access token for this client instance.
      * @returns The access token string.
@@ -35,6 +42,39 @@ export declare class PaymentsClient extends A2AClient {
      * Clears the cached access token for this client instance.
      */
     clearToken(): void;
+    /**
+     * Build the in-band x402 message metadata (x402 v2 A2A transport).
+     *
+     * The server consumes the same base64 access token whether it arrives in the
+     * deprecated `payment-signature` header or in band, so the in-band
+     * `x402.payment.payload` is just the decoded PaymentPayload object. Falls back
+     * to wrapping the raw token if it is not decodable (never expected for real
+     * Nevermined tokens, which are base64 JSON).
+     *
+     * @param accessToken - The x402 access token string
+     * @returns The message-metadata fragment carrying status + payload
+     */
+    private _buildInBandPaymentMetadata;
+    /**
+     * Return a copy of the message params with the in-band x402 payment metadata
+     * merged into `message.metadata`, optionally correlating to a taskId returned
+     * by a prior `input-required` (payment-required) response. Immutable: the
+     * caller's params object is never mutated.
+     *
+     * @param params - The original message send params
+     * @param accessToken - The x402 access token to embed in band
+     * @param taskId - Optional taskId to correlate a payment-required follow-up
+     */
+    private _withInBandPayment;
+    /**
+     * Detect a payment-required response (x402 v2 A2A transport): an
+     * `input-required` task whose status message carries
+     * `x402.payment.status: payment-required`. Returns the task id to correlate a
+     * follow-up payment, or `undefined` when the response is not payment-required.
+     *
+     * @param response - The JSON-RPC send-message response
+     */
+    private _paymentRequiredTaskId;
     /**
      * Type guard to check if a JSON-RPC response is an error response.
      * @param response - The JSON-RPC response to check

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

@@ -1 +1 @@
-{"version":3,"file":"paymentsClient.d.ts","sourceRoot":"","sources":["../../src/a2a/paymentsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtC,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,qCAAqC,EACrC,YAAY,EACZ,qCAAqC,EACrC,eAAe,EACf,oBAAoB,EACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAI9C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS;IACpC,QAAQ,EAAE,QAAQ,CAAA;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAkB;IACpD,OAAO,CAAC,WAAW,CAAe;IAElC;;;;;;;OAOG;IACH,OAAO;IAeP;;;OAGG;WACiB,MAAM,CACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,aAAa,SAA2B,EACxC,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,cAAc,CAAC;IAO1B;;;OAGG;YACW,mBAAmB;IAyBjC;;OAEG;IACI,UAAU;IAIjB;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,oBAAoB;IAI5E;;;;OAIG;IACU,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAUpF;;;;;;;;OAQG;IACW,oBAAoB,CAChC,MAAM,EAAE,iBAAiB,GACxB,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IAsDvC;;;;;;;;OAQG;YACY,eAAe;IAoD9B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuDzB;;;;;;OAMG;IACW,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IAsD5F;;;;OAIG;IACU,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAU1E;;;;OAIG;IACU,gCAAgC,CAC3C,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,qCAAqC,CAAC;IASjD;;;;OAIG;IACU,gCAAgC,CAC3C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,qCAAqC,CAAC;IAUjD;;;;;;OAMG;cACa,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;CA2CtB;AAED,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,qCAAqC,EACrC,YAAY,EACZ,qCAAqC,GACtC,MAAM,aAAa,CAAA"}
+{"version":3,"file":"paymentsClient.d.ts","sourceRoot":"","sources":["../../src/a2a/paymentsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGtC,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,qCAAqC,EACrC,YAAY,EACZ,qCAAqC,EACrC,eAAe,EACf,oBAAoB,EACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAO9C;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS;IACpC,QAAQ,EAAE,QAAQ,CAAA;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAkB;IACpD,OAAO,CAAC,WAAW,CAAe;IAElC;;;;;;;OAOG;IACH,OAAO;IAeP;;;OAGG;WACiB,MAAM,CACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,aAAa,SAA6B,EAC1C,gBAAgB,CAAC,EAAE,gBAAgB,GAClC,OAAO,CAAC,cAAc,CAAC;IAK1B;;;;;OAKG;mBACkB,eAAe;IAsCpC;;;OAGG;YACW,mBAAmB;IAyBjC;;OAEG;IACI,UAAU;IAIjB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,2BAA2B;IAQnC;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,QAAQ,IAAI,oBAAoB;IAI5E;;;;OAIG;IACU,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4BpF;;;;;;;;OAQG;IACW,oBAAoB,CAChC,MAAM,EAAE,iBAAiB,GACxB,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IAyDvC;;;;;;;;OAQG;YACY,eAAe;IAoD9B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuDzB;;;;;;OAMG;IACW,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC;IAsD5F;;;;OAIG;IACU,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAU1E;;;;OAIG;IACU,gCAAgC,CAC3C,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,qCAAqC,CAAC;IASjD;;;;OAIG;IACU,gCAAgC,CAC3C,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,qCAAqC,CAAC;IAUjD;;;;;;OAMG;cACa,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAC3D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,SAAS,CAAC;CA2CtB;AAED,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,qCAAqC,EACrC,YAAY,EACZ,qCAAqC,GACtC,MAAM,aAAa,CAAA"}

package/dist/a2a/paymentsClient.js

@@ -2,6 +2,9 @@ import { PaymentsError } from '../common/payments.error.js';
 import { resolveScheme } from '../x402/facilitator-api.js';
 import { A2AClient } from '@a2a-js/sdk/client';
 import { v4 as uuidv4 } from 'uuid';
+import { AGENT_CARD_WELL_KNOWN_PATH, LEGACY_AGENT_CARD_WELL_KNOWN_PATH } from './agent-card.js';
+import { decodeAccessToken } from '../utils.js';
+import { PaymentStatus, x402A2AUtils, X402A2AMetadata } from './x402-a2a.js';
 /**
  * PaymentsClient is a high-level client for A2A agents with payments integration.
  * Each instance is bound to a specific agentId and planId.
@@ -13,7 +16,7 @@ export class PaymentsClient extends A2AClient {
      * @param payments - The Payments object.
      * @param agentId - The ID of the agent.
      * @param planId - The ID of the plan.
-     * @param agentCardPath - Optional path to the agent card relative to base URL (defaults to '.well-known/agent.json').
+     * @param agentCardPath - Optional path to the agent card relative to base URL (defaults to '.well-known/agent-card.json').
      */
     constructor(agentCard, payments, agentId, planId, delegationConfig) {
         super(agentCard);
@@ -27,12 +30,44 @@ export class PaymentsClient extends A2AClient {
      * Creates a PaymentsClient by fetching the AgentCard first and then
      * constructing the underlying A2AClient with the AgentCard object.
      */
-    static async create(agentBaseUrl, payments, agentId, planId, agentCardPath = '.well-known/agent.json', delegationConfig) {
-        const agentCardUrl = new URL(agentCardPath, agentBaseUrl).toString();
-        const a2a = await A2AClient.fromCardUrl(agentCardUrl);
-        const agentCard = await a2a.getAgentCard();
+    static async create(agentBaseUrl, payments, agentId, planId, agentCardPath = AGENT_CARD_WELL_KNOWN_PATH, delegationConfig) {
+        const agentCard = await PaymentsClient._fetchAgentCard(agentBaseUrl, agentCardPath);
         return new PaymentsClient(agentCard, payments, agentId, planId, delegationConfig);
     }
+    /**
+     * Fetches a remote agent card, trying the requested (canonical) path first and
+     * falling back to the legacy '.well-known/agent.json' so updated clients keep
+     * working against agents that have not adopted the canonical path yet.
+     * TODO(a2a): drop the fallback one release after agents are updated.
+     */
+    static async _fetchAgentCard(agentBaseUrl, agentCardPath) {
+        const load = async (path) => {
+            const a2a = await A2AClient.fromCardUrl(new URL(path, agentBaseUrl).toString());
+            return (await a2a.getAgentCard());
+        };
+        try {
+            return await load(agentCardPath);
+        }
+        catch (err) {
+            if (agentCardPath === LEGACY_AGENT_CARD_WELL_KNOWN_PATH) {
+                throw err;
+            }
+            // Canonical path failed — fall back to the legacy path. Warn, because a
+            // silent fallback to a typosquattable legacy path is a discovery risk.
+            console.warn(`[PaymentsA2A] agent card not found at '${agentCardPath}', falling back to '${LEGACY_AGENT_CARD_WELL_KNOWN_PATH}':`, err instanceof Error ? err.message : String(err));
+            try {
+                return await load(LEGACY_AGENT_CARD_WELL_KNOWN_PATH);
+            }
+            catch (legacyErr) {
+                // Both failed. Surface the legacy error but preserve the canonical-path
+                // root cause (a TLS/DNS/5xx there is otherwise masked by a clean 404).
+                const message = legacyErr instanceof Error ? legacyErr.message : String(legacyErr);
+                // `new Error(msg, { cause })` would be idiomatic but the ES2020 lib target
+                // types Error with 0-1 args, so attach `cause` via Object.assign instead.
+                throw Object.assign(new Error(`Failed to fetch agent card from '${agentCardPath}' or legacy '${LEGACY_AGENT_CARD_WELL_KNOWN_PATH}': ${message}`), { cause: err });
+            }
+        }
+    }
     /**
      * Gets and caches the access token for this client instance.
      * @returns The access token string.
@@ -62,6 +97,67 @@ export class PaymentsClient extends A2AClient {
     clearToken() {
         this.accessToken = null;
     }
+    /**
+     * Build the in-band x402 message metadata (x402 v2 A2A transport).
+     *
+     * The server consumes the same base64 access token whether it arrives in the
+     * deprecated `payment-signature` header or in band, so the in-band
+     * `x402.payment.payload` is just the decoded PaymentPayload object. Falls back
+     * to wrapping the raw token if it is not decodable (never expected for real
+     * Nevermined tokens, which are base64 JSON).
+     *
+     * @param accessToken - The x402 access token string
+     * @returns The message-metadata fragment carrying status + payload
+     */
+    _buildInBandPaymentMetadata(accessToken) {
+        const payload = decodeAccessToken(accessToken) ?? { token: accessToken };
+        return {
+            [X402A2AMetadata.STATUS_KEY]: PaymentStatus.PAYMENT_SUBMITTED,
+            [X402A2AMetadata.PAYLOAD_KEY]: payload,
+        };
+    }
+    /**
+     * Return a copy of the message params with the in-band x402 payment metadata
+     * merged into `message.metadata`, optionally correlating to a taskId returned
+     * by a prior `input-required` (payment-required) response. Immutable: the
+     * caller's params object is never mutated.
+     *
+     * @param params - The original message send params
+     * @param accessToken - The x402 access token to embed in band
+     * @param taskId - Optional taskId to correlate a payment-required follow-up
+     */
+    _withInBandPayment(params, accessToken, taskId) {
+        return {
+            ...params,
+            message: {
+                ...params.message,
+                ...(taskId ? { taskId } : {}),
+                metadata: {
+                    ...(params.message.metadata || {}),
+                    ...this._buildInBandPaymentMetadata(accessToken),
+                },
+            },
+        };
+    }
+    /**
+     * Detect a payment-required response (x402 v2 A2A transport): an
+     * `input-required` task whose status message carries
+     * `x402.payment.status: payment-required`. Returns the task id to correlate a
+     * follow-up payment, or `undefined` when the response is not payment-required.
+     *
+     * @param response - The JSON-RPC send-message response
+     */
+    _paymentRequiredTaskId(response) {
+        if (this.isErrorResponse(response)) {
+            return undefined;
+        }
+        const result = response.result;
+        if (!result || result.kind !== 'task' || result.status?.state !== 'input-required') {
+            return undefined;
+        }
+        const status = x402A2AUtils.getPaymentStatus(result);
+        return status === PaymentStatus.PAYMENT_REQUIRED ? result.id : undefined;
+    }
     /**
      * Type guard to check if a JSON-RPC response is an error response.
      * @param response - The JSON-RPC response to check
@@ -77,8 +173,21 @@ export class PaymentsClient extends A2AClient {
      */
     async sendA2AMessage(params) {
         const accessToken = await this._getX402AccessToken();
+        // Primary path (x402 v2 A2A transport): carry the payment in band. Keep the
+        // deprecated `payment-signature` header for one release so servers that have
+        // not adopted the in-band transport still authorize the request.
         const headers = { 'payment-signature': accessToken };
-        return this._postRpcRequestWithHeaders('message/send', params, headers);
+        const inBandParams = this._withInBandPayment(params, accessToken);
+        const response = await this._postRpcRequestWithHeaders('message/send', inBandParams, headers);
+        // Reactive flow: if the server replied with an `input-required`
+        // payment-required task (it did not accept the in-band payload, e.g. it sent
+        // requirements first), resubmit the payment correlated to that task id.
+        const taskId = this._paymentRequiredTaskId(response);
+        if (taskId) {
+            const followUp = this._withInBandPayment(params, accessToken, taskId);
+            return this._postRpcRequestWithHeaders('message/send', followUp, headers);
+        }
+        return response;
     }
     /**
      * Sends a message to the agent and streams back responses using Server-Sent Events (SSE).
@@ -96,13 +205,16 @@ export class PaymentsClient extends A2AClient {
         }
         const endpoint = await this._getServiceEndpoint();
         const clientRequestId = uuidv4();
+        const accessToken = await this._getX402AccessToken();
+        // Carry the payment in band (x402 v2 A2A transport); keep the deprecated
+        // header for one release as a fallback.
+        const inBandParams = this._withInBandPayment(params, accessToken);
         const rpcRequest = {
             jsonrpc: '2.0',
             method: 'message/stream',
-            params: params,
+            params: inBandParams,
             id: clientRequestId,
         };
-        const accessToken = await this._getX402AccessToken();
         const response = await fetch(endpoint, {
             method: 'POST',
             headers: {

package/dist/a2a/paymentsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"paymentsClient.js","sourceRoot":"","sources":["../../src/a2a/paymentsClient.ts"],"names":[],"mappings":"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","sourcesContent":["import { Payments } from '../index.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { resolveScheme } from '../x402/facilitator-api.js'\nimport type { X402TokenOptions, DelegationConfig } from '../common/types.js'\nimport {\n  MessageSendParams,\n  SendMessageResponse,\n  TaskQueryParams,\n  GetTaskResponse,\n  TaskPushNotificationConfig,\n  SetTaskPushNotificationConfigResponse,\n  TaskIdParams,\n  GetTaskPushNotificationConfigResponse,\n  JSONRPCResponse,\n  JSONRPCErrorResponse,\n} from '@a2a-js/sdk'\nimport { A2AClient } from '@a2a-js/sdk/client'\nimport { v4 as uuidv4 } from 'uuid'\nimport type { AgentCard } from './types.js'\n\n/**\n * PaymentsClient is a high-level client for A2A agents with payments integration.\n * Each instance is bound to a specific agentId and planId.\n */\nexport class PaymentsClient extends A2AClient {\n  public payments: Payments\n  private readonly agentId: string\n  private readonly planId: string\n  private readonly delegationConfig?: DelegationConfig\n  private accessToken: string | null\n\n  /**\n   * Creates a new PaymentsClient instance.\n   * @param agentBaseUrl - The base URL of the agent (e.g. http://localhost:3005/a2a/).\n   * @param payments - The Payments object.\n   * @param agentId - The ID of the agent.\n   * @param planId - The ID of the plan.\n   * @param agentCardPath - Optional path to the agent card relative to base URL (defaults to '.well-known/agent.json').\n   */\n  private constructor(\n    agentCard: AgentCard,\n    payments: Payments,\n    agentId: string,\n    planId: string,\n    delegationConfig?: DelegationConfig,\n  ) {\n    super(agentCard)\n    this.payments = payments\n    this.agentId = agentId\n    this.planId = planId\n    this.delegationConfig = delegationConfig\n    this.accessToken = null\n  }\n\n  /**\n   * Creates a PaymentsClient by fetching the AgentCard first and then\n   * constructing the underlying A2AClient with the AgentCard object.\n   */\n  public static async create(\n    agentBaseUrl: string,\n    payments: Payments,\n    agentId: string,\n    planId: string,\n    agentCardPath = '.well-known/agent.json',\n    delegationConfig?: DelegationConfig,\n  ): Promise<PaymentsClient> {\n    const agentCardUrl = new URL(agentCardPath, agentBaseUrl).toString()\n    const a2a = await A2AClient.fromCardUrl(agentCardUrl)\n    const agentCard = await (a2a as any).getAgentCard()\n    return new PaymentsClient(agentCard as AgentCard, payments, agentId, planId, delegationConfig)\n  }\n\n  /**\n   * Gets and caches the access token for this client instance.\n   * @returns The access token string.\n   */\n  private async _getX402AccessToken(): Promise<string> {\n    if (this.accessToken) {\n      return this.accessToken\n    }\n    const scheme = await resolveScheme(this.payments, this.planId)\n    if (!this.delegationConfig) {\n      throw PaymentsError.internal(\n        `${scheme} scheme requires delegationConfig. Pass it to PaymentsClient.create().`,\n      )\n    }\n    let tokenOptions: X402TokenOptions | undefined\n    if (scheme !== 'nvm:erc4337') {\n      tokenOptions = { scheme, delegationConfig: this.delegationConfig }\n    } else {\n      tokenOptions = { delegationConfig: this.delegationConfig }\n    }\n    const accessParams = await this.payments.x402.getX402AccessToken(\n      this.planId,\n      this.agentId,\n      tokenOptions,\n    )\n    this.accessToken = accessParams.accessToken\n    return this.accessToken\n  }\n\n  /**\n   * Clears the cached access token for this client instance.\n   */\n  public clearToken() {\n    this.accessToken = null\n  }\n\n  /**\n   * Type guard to check if a JSON-RPC response is an error response.\n   * @param response - The JSON-RPC response to check\n   * @returns true if the response contains an error, false otherwise\n   */\n  isErrorResponse(response: JSONRPCResponse): response is JSONRPCErrorResponse {\n    return response != null && typeof response === 'object' && 'error' in response\n  }\n\n  /**\n   * Sends a message to the agent, managing authentication automatically.\n   * @param params - The parameters for sending the message.\n   * @returns The response from the agent.\n   */\n  public async sendA2AMessage(params: MessageSendParams): Promise<SendMessageResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<MessageSendParams, SendMessageResponse>(\n      'message/send',\n      params,\n      headers,\n    )\n  }\n\n  /**\n   * Sends a message to the agent and streams back responses using Server-Sent Events (SSE).\n   * Push notification configuration can be specified in `params.configuration`.\n   * Optionally, `params.message.contextId` or `params.message.taskId` can be provided.\n   * Requires the agent to support streaming (`capabilities.streaming: true` in AgentCard).\n   * @param params - The parameters for sending the message.\n   * @returns An AsyncGenerator yielding A2AStreamEventData (Message, Task, TaskStatusUpdateEvent, or TaskArtifactUpdateEvent).\n   * The generator throws an error if streaming is not supported or if an HTTP/SSE error occurs.\n   */\n  public async *sendA2AMessageStream(\n    params: MessageSendParams,\n  ): AsyncGenerator<any, void, undefined> {\n    const agentCard = await (this as any).agentCardPromise\n    if (!agentCard.capabilities?.streaming) {\n      throw new Error(\n        'Agent does not support streaming (AgentCard.capabilities.streaming is not true).',\n      )\n    }\n    const endpoint = await (this as any)._getServiceEndpoint()\n    const clientRequestId = uuidv4()\n    const rpcRequest = {\n      jsonrpc: '2.0',\n      method: 'message/stream',\n      params: params as { [key: string]: any },\n      id: clientRequestId,\n    }\n    const accessToken = await this._getX402AccessToken()\n    const response = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n        'payment-signature': accessToken,\n      },\n      body: JSON.stringify(rpcRequest),\n    })\n    if (!response.ok) {\n      let errorBody = ''\n      try {\n        errorBody = await response.text()\n        const errorJson = JSON.parse(errorBody)\n        if (errorJson.error) {\n          throw new Error(\n            `HTTP error establishing stream for message/stream: ${response.status} ${response.statusText}. RPC Error: ${errorJson.error.message} (Code: ${errorJson.error.code})`,\n          )\n        }\n      } catch (e: any) {\n        if (e.message.startsWith('HTTP error establishing stream')) throw e\n        throw new Error(\n          `HTTP error establishing stream for message/stream: ${response.status} ${response.statusText}. Response: ${errorBody || '(empty)'}`,\n        )\n      }\n      throw new Error(\n        `HTTP error establishing stream for message/stream: ${response.status} ${response.statusText}`,\n      )\n    }\n    if (!response.headers.get('Content-Type')?.startsWith('text/event-stream')) {\n      throw new Error(\"Invalid response Content-Type for SSE stream. Expected 'text/event-stream'.\")\n    }\n    // Parse and yield SSE events\n    for await (const event of this._parseA2AStream(response, clientRequestId)) {\n      yield event\n    }\n  }\n\n  /**\n   * Parses an HTTP response body as an A2A Server-Sent Event stream.\n   * Each 'data' field of an SSE event is expected to be a JSON-RPC 2.0 Response object,\n   * specifically a SendStreamingMessageResponse (or similar structure for resubscribe).\n   * @param response -The HTTP Response object whose body is the SSE stream.\n   * @param originalRequestId - The ID of the client's JSON-RPC request that initiated this stream.\n   * Used to validate the `id` in the streamed JSON-RPC responses.\n   * @returns An AsyncGenerator yielding the `result` field of each valid JSON-RPC success response from the stream.\n   */\n  private async *_parseA2AStream<TStreamItem>(\n    response: Response,\n    originalRequestId: number | string | null,\n  ): AsyncGenerator<TStreamItem, void, undefined> {\n    if (!response.body) {\n      throw new Error('SSE response body is undefined. Cannot read stream.')\n    }\n    const reader = response.body.pipeThrough(new TextDecoderStream()).getReader()\n    let buffer = '' // Holds incomplete lines from the stream\n    let eventDataBuffer = '' // Holds accumulated 'data:' lines for the current event\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          // Process any final buffered event data if the stream ends abruptly after a 'data:' line\n          if (eventDataBuffer.trim()) {\n            const result = this._processEventData<TStreamItem>(eventDataBuffer, originalRequestId)\n            yield result\n          }\n          break // Stream finished\n        }\n\n        buffer += value // Append new chunk to buffer\n        let lineEndIndex\n        // Process all complete lines in the buffer\n        while ((lineEndIndex = buffer.indexOf('\\n')) >= 0) {\n          const line = buffer.substring(0, lineEndIndex).trim() // Get and trim the line\n          buffer = buffer.substring(lineEndIndex + 1) // Remove processed line from buffer\n\n          if (line === '') {\n            // Empty line: signifies the end of an event\n            if (eventDataBuffer) {\n              // If we have accumulated data for an event\n              const result = this._processEventData<TStreamItem>(eventDataBuffer, originalRequestId)\n              yield result\n              eventDataBuffer = '' // Reset buffer for the next event\n            }\n          } else if (line.startsWith('data:')) {\n            eventDataBuffer += line.substring(5).trimStart() + '\\n' // Append data (multi-line data is possible)\n          } else if (line.startsWith(':')) {\n            // This is a comment line in SSE, ignore it.\n          }\n        }\n      }\n    } catch (error: any) {\n      throw new PaymentsError(error.message, 'payments_error')\n    } finally {\n      reader.releaseLock() // Ensure the reader lock is released\n    }\n  }\n\n  /**\n   * Processes a single SSE event's data string, expecting it to be a JSON-RPC response.\n   * @param jsonData - The string content from one or more 'data:' lines of an SSE event.\n   * @param originalRequestId - The ID of the client's request that initiated the stream.\n   * @returns The `result` field of the parsed JSON-RPC success response.\n   * @throws Error if data is not valid JSON, not a valid JSON-RPC response, an error response, or ID mismatch.\n   */\n  private _processEventData<TStreamItem>(\n    jsonData: string,\n    originalRequestId: number | string | null,\n  ): TStreamItem {\n    if (!jsonData.trim()) {\n      throw new Error('Attempted to process empty SSE event data.')\n    }\n    try {\n      // SSE data can be multi-line, ensure it's treated as a single JSON string.\n      const sseJsonRpcResponse = JSON.parse(jsonData.replace(/\\n$/, ''))\n\n      // Type assertion to SendStreamingMessageResponse, as this is the expected structure for A2A streams.\n      const a2aStreamResponse: any = sseJsonRpcResponse\n\n      if (a2aStreamResponse.id !== originalRequestId) {\n        // According to JSON-RPC spec, notifications (which SSE events can be seen as) might not have an ID,\n        // or if they do, it should match. A2A spec implies streamed events are tied to the initial request.\n        throw new PaymentsError(\n          `SSE Event's JSON-RPC response ID mismatch. Client request ID: ${originalRequestId}, event response ID: ${a2aStreamResponse.id}.`,\n          'payments_error',\n        )\n      }\n\n      if (this.isErrorResponse && this.isErrorResponse(a2aStreamResponse)) {\n        const err = a2aStreamResponse.error\n        throw new PaymentsError(\n          `SSE event contained an error: ${err.message} (Code: ${err.code}) Data: ${JSON.stringify(err.data)}`,\n        )\n      }\n\n      // Check if 'result' exists, as it's mandatory for successful JSON-RPC responses\n      if (!('result' in a2aStreamResponse) || typeof a2aStreamResponse.result === 'undefined') {\n        throw new PaymentsError(\n          `SSE event JSON-RPC response is missing 'result' field. Data: ${jsonData}`,\n          'payments_error',\n        )\n      }\n\n      return a2aStreamResponse as TStreamItem\n    } catch (e: any) {\n      // Catch errors from JSON.parse or if it's an error response that was thrown by this function\n      if (\n        e.message.startsWith('SSE event contained an error') ||\n        e.message.startsWith(\"SSE event JSON-RPC response is missing 'result' field\")\n      ) {\n        throw new PaymentsError(e.message, 'payments_error')\n      }\n\n      throw new PaymentsError(\n        `Failed to parse SSE event data: \"${jsonData.substring(0, 100)}...\". Original error: ${e.message}`,\n        'payments_error',\n      )\n    }\n  }\n\n  /**\n   * Resubscribes to a task's event stream using Server-Sent Events (SSE).\n   * This is used if a previous SSE connection for an active task was broken.\n   * Requires the agent to support streaming (`capabilities.streaming: true` in AgentCard).\n   * @param params - Parameters containing the taskId.\n   * @returns An AsyncGenerator yielding A2AStreamEventData (Message, Task, TaskStatusUpdateEvent, or TaskArtifactUpdateEvent).\n   */\n  public async *resubscribeA2ATask(params: TaskIdParams): AsyncGenerator<any, void, undefined> {\n    const agentCard = await (this as any).agentCardPromise\n    if (!agentCard.capabilities?.streaming) {\n      throw new Error('Agent does not support streaming (required for tasks/resubscribe).')\n    }\n    const endpoint = await (this as any)._getServiceEndpoint()\n    const clientRequestId = uuidv4()\n    const rpcRequest = {\n      jsonrpc: '2.0',\n      method: 'tasks/resubscribe',\n      params: params as { [key: string]: any },\n      id: clientRequestId,\n    }\n    const accessToken = await this._getX402AccessToken()\n    const response = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n        'payment-signature': accessToken,\n      },\n      body: JSON.stringify(rpcRequest),\n    })\n    if (!response.ok) {\n      let errorBody = ''\n      try {\n        errorBody = await response.text()\n        const errorJson = JSON.parse(errorBody)\n        if (errorJson.error) {\n          throw new Error(\n            `HTTP error establishing stream for tasks/resubscribe: ${response.status} ${response.statusText}. RPC Error: ${errorJson.error.message} (Code: ${errorJson.error.code})`,\n          )\n        }\n      } catch (e: any) {\n        if (e.message.startsWith('HTTP error establishing stream')) throw e\n        throw new Error(\n          `HTTP error establishing stream for tasks/resubscribe: ${response.status} ${response.statusText}. Response: ${errorBody || '(empty)'}`,\n        )\n      }\n      throw new Error(\n        `HTTP error establishing stream for tasks/resubscribe: ${response.status} ${response.statusText}`,\n      )\n    }\n    if (!response.headers.get('Content-Type')?.startsWith('text/event-stream')) {\n      throw new Error(\n        \"Invalid response Content-Type for SSE stream on resubscribe. Expected 'text/event-stream'.\",\n      )\n    }\n    // Parse and yield SSE events\n    for await (const event of this._parseA2AStream(response, clientRequestId)) {\n      yield event\n    }\n  }\n\n  /**\n   * Retrieves a task by its ID, managing authentication automatically.\n   * @param params - The parameters for the task query.\n   * @returns The task response.\n   */\n  public async getA2ATask(params: TaskQueryParams): Promise<GetTaskResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<TaskQueryParams, GetTaskResponse>(\n      'tasks/get',\n      params,\n      headers,\n    )\n  }\n\n  /**\n   * Sets or updates the push notification configuration for a given task, managing authentication automatically.\n   * @param params - The parameters for the task push notification configuration.\n   * @returns The response from the agent.\n   */\n  public async setA2ATaskPushNotificationConfig(\n    params: TaskPushNotificationConfig,\n  ): Promise<SetTaskPushNotificationConfigResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<\n      TaskPushNotificationConfig,\n      SetTaskPushNotificationConfigResponse\n    >('tasks/pushNotificationConfig/set', params, headers)\n  }\n\n  /**\n   * Gets the push notification configuration for a given task, managing authentication automatically.\n   * @param params - The parameters for the task push notification configuration.\n   * @returns The response from the agent.\n   */\n  public async getA2ATaskPushNotificationConfig(\n    params: TaskIdParams,\n  ): Promise<GetTaskPushNotificationConfigResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<TaskIdParams, GetTaskPushNotificationConfigResponse>(\n      'tasks/pushNotificationConfig/get',\n      params,\n      headers,\n    )\n  }\n\n  /**\n   * Internal helper to make a JSON-RPC POST request with custom headers.\n   * @param method - The RPC method name.\n   * @param params - The parameters for the RPC method.\n   * @param headers - Optional custom headers.\n   * @returns The response from the agent.\n   */\n  protected async _postRpcRequestWithHeaders<TParams, TResponse>(\n    method: string,\n    params: TParams,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const endpoint = await (this as any)._getServiceEndpoint()\n    const requestId = uuidv4()\n    const rpcRequest = { jsonrpc: '2.0', method, params, id: requestId }\n    const httpResponse = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        ...(headers || {}),\n      },\n      body: JSON.stringify(rpcRequest),\n    })\n    if (!httpResponse.ok) {\n      let errorBodyText = '(empty or non-JSON response)'\n      try {\n        errorBodyText = await httpResponse.text()\n        const errorJson = JSON.parse(errorBodyText)\n        if (!errorJson.jsonrpc && errorJson.error) {\n          throw new Error(\n            `RPC error for ${method}: ${errorJson.error.message} (Code: ${errorJson.error.code}, HTTP Status: ${httpResponse.status}) Data: ${JSON.stringify(errorJson.error.data)}`,\n          )\n        } else if (!errorJson.jsonrpc) {\n          throw new Error(\n            `HTTP error for ${method}! Status: ${httpResponse.status} ${httpResponse.statusText}. Response: ${errorBodyText}`,\n          )\n        }\n      } catch (e: any) {\n        if (e.message.startsWith('RPC error for') || e.message.startsWith('HTTP error for')) throw e\n        throw new Error(\n          `HTTP error for ${method}! Status: ${httpResponse.status} ${httpResponse.statusText}. Response: ${errorBodyText}`,\n        )\n      }\n    }\n    const rpcResponse = await httpResponse.json()\n    if (rpcResponse.id !== requestId) {\n      throw new PaymentsError(\n        `CRITICAL: RPC response ID mismatch for method ${method}. Expected ${requestId}, got ${rpcResponse.id}. This may lead to incorrect response handling.`,\n        'payments_error',\n      )\n    }\n    return rpcResponse as TResponse\n  }\n}\n\nexport type {\n  MessageSendParams,\n  SendMessageResponse,\n  TaskQueryParams,\n  GetTaskResponse,\n  TaskPushNotificationConfig,\n  SetTaskPushNotificationConfigResponse,\n  TaskIdParams,\n  GetTaskPushNotificationConfigResponse,\n} from '@a2a-js/sdk'\n"]}
+{"version":3,"file":"paymentsClient.js","sourceRoot":"","sources":["../../src/a2a/paymentsClient.ts"],"names":[],"mappings":"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","sourcesContent":["import { Payments } from '../index.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { resolveScheme } from '../x402/facilitator-api.js'\nimport type { X402TokenOptions, DelegationConfig } from '../common/types.js'\nimport {\n  MessageSendParams,\n  SendMessageResponse,\n  TaskQueryParams,\n  GetTaskResponse,\n  TaskPushNotificationConfig,\n  SetTaskPushNotificationConfigResponse,\n  TaskIdParams,\n  GetTaskPushNotificationConfigResponse,\n  JSONRPCResponse,\n  JSONRPCErrorResponse,\n} from '@a2a-js/sdk'\nimport { A2AClient } from '@a2a-js/sdk/client'\nimport { v4 as uuidv4 } from 'uuid'\nimport type { AgentCard } from './types.js'\nimport { AGENT_CARD_WELL_KNOWN_PATH, LEGACY_AGENT_CARD_WELL_KNOWN_PATH } from './agent-card.js'\nimport { decodeAccessToken } from '../utils.js'\nimport { PaymentStatus, x402A2AUtils, X402A2AMetadata } from './x402-a2a.js'\n\n/**\n * PaymentsClient is a high-level client for A2A agents with payments integration.\n * Each instance is bound to a specific agentId and planId.\n */\nexport class PaymentsClient extends A2AClient {\n  public payments: Payments\n  private readonly agentId: string\n  private readonly planId: string\n  private readonly delegationConfig?: DelegationConfig\n  private accessToken: string | null\n\n  /**\n   * Creates a new PaymentsClient instance.\n   * @param agentBaseUrl - The base URL of the agent (e.g. http://localhost:3005/a2a/).\n   * @param payments - The Payments object.\n   * @param agentId - The ID of the agent.\n   * @param planId - The ID of the plan.\n   * @param agentCardPath - Optional path to the agent card relative to base URL (defaults to '.well-known/agent-card.json').\n   */\n  private constructor(\n    agentCard: AgentCard,\n    payments: Payments,\n    agentId: string,\n    planId: string,\n    delegationConfig?: DelegationConfig,\n  ) {\n    super(agentCard)\n    this.payments = payments\n    this.agentId = agentId\n    this.planId = planId\n    this.delegationConfig = delegationConfig\n    this.accessToken = null\n  }\n\n  /**\n   * Creates a PaymentsClient by fetching the AgentCard first and then\n   * constructing the underlying A2AClient with the AgentCard object.\n   */\n  public static async create(\n    agentBaseUrl: string,\n    payments: Payments,\n    agentId: string,\n    planId: string,\n    agentCardPath = AGENT_CARD_WELL_KNOWN_PATH,\n    delegationConfig?: DelegationConfig,\n  ): Promise<PaymentsClient> {\n    const agentCard = await PaymentsClient._fetchAgentCard(agentBaseUrl, agentCardPath)\n    return new PaymentsClient(agentCard, payments, agentId, planId, delegationConfig)\n  }\n\n  /**\n   * Fetches a remote agent card, trying the requested (canonical) path first and\n   * falling back to the legacy '.well-known/agent.json' so updated clients keep\n   * working against agents that have not adopted the canonical path yet.\n   * TODO(a2a): drop the fallback one release after agents are updated.\n   */\n  private static async _fetchAgentCard(\n    agentBaseUrl: string,\n    agentCardPath: string,\n  ): Promise<AgentCard> {\n    const load = async (path: string): Promise<AgentCard> => {\n      const a2a = await A2AClient.fromCardUrl(new URL(path, agentBaseUrl).toString())\n      return (await (a2a as any).getAgentCard()) as AgentCard\n    }\n    try {\n      return await load(agentCardPath)\n    } catch (err) {\n      if (agentCardPath === LEGACY_AGENT_CARD_WELL_KNOWN_PATH) {\n        throw err\n      }\n      // Canonical path failed — fall back to the legacy path. Warn, because a\n      // silent fallback to a typosquattable legacy path is a discovery risk.\n      console.warn(\n        `[PaymentsA2A] agent card not found at '${agentCardPath}', falling back to '${LEGACY_AGENT_CARD_WELL_KNOWN_PATH}':`,\n        err instanceof Error ? err.message : String(err),\n      )\n      try {\n        return await load(LEGACY_AGENT_CARD_WELL_KNOWN_PATH)\n      } catch (legacyErr) {\n        // Both failed. Surface the legacy error but preserve the canonical-path\n        // root cause (a TLS/DNS/5xx there is otherwise masked by a clean 404).\n        const message = legacyErr instanceof Error ? legacyErr.message : String(legacyErr)\n        // `new Error(msg, { cause })` would be idiomatic but the ES2020 lib target\n        // types Error with 0-1 args, so attach `cause` via Object.assign instead.\n        throw Object.assign(\n          new Error(\n            `Failed to fetch agent card from '${agentCardPath}' or legacy '${LEGACY_AGENT_CARD_WELL_KNOWN_PATH}': ${message}`,\n          ),\n          { cause: err },\n        )\n      }\n    }\n  }\n\n  /**\n   * Gets and caches the access token for this client instance.\n   * @returns The access token string.\n   */\n  private async _getX402AccessToken(): Promise<string> {\n    if (this.accessToken) {\n      return this.accessToken\n    }\n    const scheme = await resolveScheme(this.payments, this.planId)\n    if (!this.delegationConfig) {\n      throw PaymentsError.internal(\n        `${scheme} scheme requires delegationConfig. Pass it to PaymentsClient.create().`,\n      )\n    }\n    let tokenOptions: X402TokenOptions | undefined\n    if (scheme !== 'nvm:erc4337') {\n      tokenOptions = { scheme, delegationConfig: this.delegationConfig }\n    } else {\n      tokenOptions = { delegationConfig: this.delegationConfig }\n    }\n    const accessParams = await this.payments.x402.getX402AccessToken(\n      this.planId,\n      this.agentId,\n      tokenOptions,\n    )\n    this.accessToken = accessParams.accessToken\n    return this.accessToken\n  }\n\n  /**\n   * Clears the cached access token for this client instance.\n   */\n  public clearToken() {\n    this.accessToken = null\n  }\n\n  /**\n   * Build the in-band x402 message metadata (x402 v2 A2A transport).\n   *\n   * The server consumes the same base64 access token whether it arrives in the\n   * deprecated `payment-signature` header or in band, so the in-band\n   * `x402.payment.payload` is just the decoded PaymentPayload object. Falls back\n   * to wrapping the raw token if it is not decodable (never expected for real\n   * Nevermined tokens, which are base64 JSON).\n   *\n   * @param accessToken - The x402 access token string\n   * @returns The message-metadata fragment carrying status + payload\n   */\n  private _buildInBandPaymentMetadata(accessToken: string): Record<string, unknown> {\n    const payload = decodeAccessToken(accessToken) ?? { token: accessToken }\n    return {\n      [X402A2AMetadata.STATUS_KEY]: PaymentStatus.PAYMENT_SUBMITTED,\n      [X402A2AMetadata.PAYLOAD_KEY]: payload,\n    }\n  }\n\n  /**\n   * Return a copy of the message params with the in-band x402 payment metadata\n   * merged into `message.metadata`, optionally correlating to a taskId returned\n   * by a prior `input-required` (payment-required) response. Immutable: the\n   * caller's params object is never mutated.\n   *\n   * @param params - The original message send params\n   * @param accessToken - The x402 access token to embed in band\n   * @param taskId - Optional taskId to correlate a payment-required follow-up\n   */\n  private _withInBandPayment(\n    params: MessageSendParams,\n    accessToken: string,\n    taskId?: string,\n  ): MessageSendParams {\n    return {\n      ...params,\n      message: {\n        ...params.message,\n        ...(taskId ? { taskId } : {}),\n        metadata: {\n          ...(params.message.metadata || {}),\n          ...this._buildInBandPaymentMetadata(accessToken),\n        },\n      },\n    }\n  }\n\n  /**\n   * Detect a payment-required response (x402 v2 A2A transport): an\n   * `input-required` task whose status message carries\n   * `x402.payment.status: payment-required`. Returns the task id to correlate a\n   * follow-up payment, or `undefined` when the response is not payment-required.\n   *\n   * @param response - The JSON-RPC send-message response\n   */\n  private _paymentRequiredTaskId(response: SendMessageResponse): string | undefined {\n    if (this.isErrorResponse(response as JSONRPCResponse)) {\n      return undefined\n    }\n    const result = (response as { result?: any }).result\n    if (!result || result.kind !== 'task' || result.status?.state !== 'input-required') {\n      return undefined\n    }\n    const status = x402A2AUtils.getPaymentStatus(result)\n    return status === PaymentStatus.PAYMENT_REQUIRED ? (result.id as string) : undefined\n  }\n\n  /**\n   * Type guard to check if a JSON-RPC response is an error response.\n   * @param response - The JSON-RPC response to check\n   * @returns true if the response contains an error, false otherwise\n   */\n  isErrorResponse(response: JSONRPCResponse): response is JSONRPCErrorResponse {\n    return response != null && typeof response === 'object' && 'error' in response\n  }\n\n  /**\n   * Sends a message to the agent, managing authentication automatically.\n   * @param params - The parameters for sending the message.\n   * @returns The response from the agent.\n   */\n  public async sendA2AMessage(params: MessageSendParams): Promise<SendMessageResponse> {\n    const accessToken = await this._getX402AccessToken()\n    // Primary path (x402 v2 A2A transport): carry the payment in band. Keep the\n    // deprecated `payment-signature` header for one release so servers that have\n    // not adopted the in-band transport still authorize the request.\n    const headers = { 'payment-signature': accessToken }\n    const inBandParams = this._withInBandPayment(params, accessToken)\n    const response = await this._postRpcRequestWithHeaders<MessageSendParams, SendMessageResponse>(\n      'message/send',\n      inBandParams,\n      headers,\n    )\n\n    // Reactive flow: if the server replied with an `input-required`\n    // payment-required task (it did not accept the in-band payload, e.g. it sent\n    // requirements first), resubmit the payment correlated to that task id.\n    const taskId = this._paymentRequiredTaskId(response)\n    if (taskId) {\n      const followUp = this._withInBandPayment(params, accessToken, taskId)\n      return this._postRpcRequestWithHeaders<MessageSendParams, SendMessageResponse>(\n        'message/send',\n        followUp,\n        headers,\n      )\n    }\n    return response\n  }\n\n  /**\n   * Sends a message to the agent and streams back responses using Server-Sent Events (SSE).\n   * Push notification configuration can be specified in `params.configuration`.\n   * Optionally, `params.message.contextId` or `params.message.taskId` can be provided.\n   * Requires the agent to support streaming (`capabilities.streaming: true` in AgentCard).\n   * @param params - The parameters for sending the message.\n   * @returns An AsyncGenerator yielding A2AStreamEventData (Message, Task, TaskStatusUpdateEvent, or TaskArtifactUpdateEvent).\n   * The generator throws an error if streaming is not supported or if an HTTP/SSE error occurs.\n   */\n  public async *sendA2AMessageStream(\n    params: MessageSendParams,\n  ): AsyncGenerator<any, void, undefined> {\n    const agentCard = await (this as any).agentCardPromise\n    if (!agentCard.capabilities?.streaming) {\n      throw new Error(\n        'Agent does not support streaming (AgentCard.capabilities.streaming is not true).',\n      )\n    }\n    const endpoint = await (this as any)._getServiceEndpoint()\n    const clientRequestId = uuidv4()\n    const accessToken = await this._getX402AccessToken()\n    // Carry the payment in band (x402 v2 A2A transport); keep the deprecated\n    // header for one release as a fallback.\n    const inBandParams = this._withInBandPayment(params, accessToken)\n    const rpcRequest = {\n      jsonrpc: '2.0',\n      method: 'message/stream',\n      params: inBandParams as { [key: string]: any },\n      id: clientRequestId,\n    }\n    const response = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n        'payment-signature': accessToken,\n      },\n      body: JSON.stringify(rpcRequest),\n    })\n    if (!response.ok) {\n      let errorBody = ''\n      try {\n        errorBody = await response.text()\n        const errorJson = JSON.parse(errorBody)\n        if (errorJson.error) {\n          throw new Error(\n            `HTTP error establishing stream for message/stream: ${response.status} ${response.statusText}. RPC Error: ${errorJson.error.message} (Code: ${errorJson.error.code})`,\n          )\n        }\n      } catch (e: any) {\n        if (e.message.startsWith('HTTP error establishing stream')) throw e\n        throw new Error(\n          `HTTP error establishing stream for message/stream: ${response.status} ${response.statusText}. Response: ${errorBody || '(empty)'}`,\n        )\n      }\n      throw new Error(\n        `HTTP error establishing stream for message/stream: ${response.status} ${response.statusText}`,\n      )\n    }\n    if (!response.headers.get('Content-Type')?.startsWith('text/event-stream')) {\n      throw new Error(\"Invalid response Content-Type for SSE stream. Expected 'text/event-stream'.\")\n    }\n    // Parse and yield SSE events\n    for await (const event of this._parseA2AStream(response, clientRequestId)) {\n      yield event\n    }\n  }\n\n  /**\n   * Parses an HTTP response body as an A2A Server-Sent Event stream.\n   * Each 'data' field of an SSE event is expected to be a JSON-RPC 2.0 Response object,\n   * specifically a SendStreamingMessageResponse (or similar structure for resubscribe).\n   * @param response -The HTTP Response object whose body is the SSE stream.\n   * @param originalRequestId - The ID of the client's JSON-RPC request that initiated this stream.\n   * Used to validate the `id` in the streamed JSON-RPC responses.\n   * @returns An AsyncGenerator yielding the `result` field of each valid JSON-RPC success response from the stream.\n   */\n  private async *_parseA2AStream<TStreamItem>(\n    response: Response,\n    originalRequestId: number | string | null,\n  ): AsyncGenerator<TStreamItem, void, undefined> {\n    if (!response.body) {\n      throw new Error('SSE response body is undefined. Cannot read stream.')\n    }\n    const reader = response.body.pipeThrough(new TextDecoderStream()).getReader()\n    let buffer = '' // Holds incomplete lines from the stream\n    let eventDataBuffer = '' // Holds accumulated 'data:' lines for the current event\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          // Process any final buffered event data if the stream ends abruptly after a 'data:' line\n          if (eventDataBuffer.trim()) {\n            const result = this._processEventData<TStreamItem>(eventDataBuffer, originalRequestId)\n            yield result\n          }\n          break // Stream finished\n        }\n\n        buffer += value // Append new chunk to buffer\n        let lineEndIndex\n        // Process all complete lines in the buffer\n        while ((lineEndIndex = buffer.indexOf('\\n')) >= 0) {\n          const line = buffer.substring(0, lineEndIndex).trim() // Get and trim the line\n          buffer = buffer.substring(lineEndIndex + 1) // Remove processed line from buffer\n\n          if (line === '') {\n            // Empty line: signifies the end of an event\n            if (eventDataBuffer) {\n              // If we have accumulated data for an event\n              const result = this._processEventData<TStreamItem>(eventDataBuffer, originalRequestId)\n              yield result\n              eventDataBuffer = '' // Reset buffer for the next event\n            }\n          } else if (line.startsWith('data:')) {\n            eventDataBuffer += line.substring(5).trimStart() + '\\n' // Append data (multi-line data is possible)\n          } else if (line.startsWith(':')) {\n            // This is a comment line in SSE, ignore it.\n          }\n        }\n      }\n    } catch (error: any) {\n      throw new PaymentsError(error.message, 'payments_error')\n    } finally {\n      reader.releaseLock() // Ensure the reader lock is released\n    }\n  }\n\n  /**\n   * Processes a single SSE event's data string, expecting it to be a JSON-RPC response.\n   * @param jsonData - The string content from one or more 'data:' lines of an SSE event.\n   * @param originalRequestId - The ID of the client's request that initiated the stream.\n   * @returns The `result` field of the parsed JSON-RPC success response.\n   * @throws Error if data is not valid JSON, not a valid JSON-RPC response, an error response, or ID mismatch.\n   */\n  private _processEventData<TStreamItem>(\n    jsonData: string,\n    originalRequestId: number | string | null,\n  ): TStreamItem {\n    if (!jsonData.trim()) {\n      throw new Error('Attempted to process empty SSE event data.')\n    }\n    try {\n      // SSE data can be multi-line, ensure it's treated as a single JSON string.\n      const sseJsonRpcResponse = JSON.parse(jsonData.replace(/\\n$/, ''))\n\n      // Type assertion to SendStreamingMessageResponse, as this is the expected structure for A2A streams.\n      const a2aStreamResponse: any = sseJsonRpcResponse\n\n      if (a2aStreamResponse.id !== originalRequestId) {\n        // According to JSON-RPC spec, notifications (which SSE events can be seen as) might not have an ID,\n        // or if they do, it should match. A2A spec implies streamed events are tied to the initial request.\n        throw new PaymentsError(\n          `SSE Event's JSON-RPC response ID mismatch. Client request ID: ${originalRequestId}, event response ID: ${a2aStreamResponse.id}.`,\n          'payments_error',\n        )\n      }\n\n      if (this.isErrorResponse && this.isErrorResponse(a2aStreamResponse)) {\n        const err = a2aStreamResponse.error\n        throw new PaymentsError(\n          `SSE event contained an error: ${err.message} (Code: ${err.code}) Data: ${JSON.stringify(err.data)}`,\n        )\n      }\n\n      // Check if 'result' exists, as it's mandatory for successful JSON-RPC responses\n      if (!('result' in a2aStreamResponse) || typeof a2aStreamResponse.result === 'undefined') {\n        throw new PaymentsError(\n          `SSE event JSON-RPC response is missing 'result' field. Data: ${jsonData}`,\n          'payments_error',\n        )\n      }\n\n      return a2aStreamResponse as TStreamItem\n    } catch (e: any) {\n      // Catch errors from JSON.parse or if it's an error response that was thrown by this function\n      if (\n        e.message.startsWith('SSE event contained an error') ||\n        e.message.startsWith(\"SSE event JSON-RPC response is missing 'result' field\")\n      ) {\n        throw new PaymentsError(e.message, 'payments_error')\n      }\n\n      throw new PaymentsError(\n        `Failed to parse SSE event data: \"${jsonData.substring(0, 100)}...\". Original error: ${e.message}`,\n        'payments_error',\n      )\n    }\n  }\n\n  /**\n   * Resubscribes to a task's event stream using Server-Sent Events (SSE).\n   * This is used if a previous SSE connection for an active task was broken.\n   * Requires the agent to support streaming (`capabilities.streaming: true` in AgentCard).\n   * @param params - Parameters containing the taskId.\n   * @returns An AsyncGenerator yielding A2AStreamEventData (Message, Task, TaskStatusUpdateEvent, or TaskArtifactUpdateEvent).\n   */\n  public async *resubscribeA2ATask(params: TaskIdParams): AsyncGenerator<any, void, undefined> {\n    const agentCard = await (this as any).agentCardPromise\n    if (!agentCard.capabilities?.streaming) {\n      throw new Error('Agent does not support streaming (required for tasks/resubscribe).')\n    }\n    const endpoint = await (this as any)._getServiceEndpoint()\n    const clientRequestId = uuidv4()\n    const rpcRequest = {\n      jsonrpc: '2.0',\n      method: 'tasks/resubscribe',\n      params: params as { [key: string]: any },\n      id: clientRequestId,\n    }\n    const accessToken = await this._getX402AccessToken()\n    const response = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n        'payment-signature': accessToken,\n      },\n      body: JSON.stringify(rpcRequest),\n    })\n    if (!response.ok) {\n      let errorBody = ''\n      try {\n        errorBody = await response.text()\n        const errorJson = JSON.parse(errorBody)\n        if (errorJson.error) {\n          throw new Error(\n            `HTTP error establishing stream for tasks/resubscribe: ${response.status} ${response.statusText}. RPC Error: ${errorJson.error.message} (Code: ${errorJson.error.code})`,\n          )\n        }\n      } catch (e: any) {\n        if (e.message.startsWith('HTTP error establishing stream')) throw e\n        throw new Error(\n          `HTTP error establishing stream for tasks/resubscribe: ${response.status} ${response.statusText}. Response: ${errorBody || '(empty)'}`,\n        )\n      }\n      throw new Error(\n        `HTTP error establishing stream for tasks/resubscribe: ${response.status} ${response.statusText}`,\n      )\n    }\n    if (!response.headers.get('Content-Type')?.startsWith('text/event-stream')) {\n      throw new Error(\n        \"Invalid response Content-Type for SSE stream on resubscribe. Expected 'text/event-stream'.\",\n      )\n    }\n    // Parse and yield SSE events\n    for await (const event of this._parseA2AStream(response, clientRequestId)) {\n      yield event\n    }\n  }\n\n  /**\n   * Retrieves a task by its ID, managing authentication automatically.\n   * @param params - The parameters for the task query.\n   * @returns The task response.\n   */\n  public async getA2ATask(params: TaskQueryParams): Promise<GetTaskResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<TaskQueryParams, GetTaskResponse>(\n      'tasks/get',\n      params,\n      headers,\n    )\n  }\n\n  /**\n   * Sets or updates the push notification configuration for a given task, managing authentication automatically.\n   * @param params - The parameters for the task push notification configuration.\n   * @returns The response from the agent.\n   */\n  public async setA2ATaskPushNotificationConfig(\n    params: TaskPushNotificationConfig,\n  ): Promise<SetTaskPushNotificationConfigResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<\n      TaskPushNotificationConfig,\n      SetTaskPushNotificationConfigResponse\n    >('tasks/pushNotificationConfig/set', params, headers)\n  }\n\n  /**\n   * Gets the push notification configuration for a given task, managing authentication automatically.\n   * @param params - The parameters for the task push notification configuration.\n   * @returns The response from the agent.\n   */\n  public async getA2ATaskPushNotificationConfig(\n    params: TaskIdParams,\n  ): Promise<GetTaskPushNotificationConfigResponse> {\n    const accessToken = await this._getX402AccessToken()\n    const headers = { 'payment-signature': accessToken }\n    return this._postRpcRequestWithHeaders<TaskIdParams, GetTaskPushNotificationConfigResponse>(\n      'tasks/pushNotificationConfig/get',\n      params,\n      headers,\n    )\n  }\n\n  /**\n   * Internal helper to make a JSON-RPC POST request with custom headers.\n   * @param method - The RPC method name.\n   * @param params - The parameters for the RPC method.\n   * @param headers - Optional custom headers.\n   * @returns The response from the agent.\n   */\n  protected async _postRpcRequestWithHeaders<TParams, TResponse>(\n    method: string,\n    params: TParams,\n    headers?: Record<string, string>,\n  ): Promise<TResponse> {\n    const endpoint = await (this as any)._getServiceEndpoint()\n    const requestId = uuidv4()\n    const rpcRequest = { jsonrpc: '2.0', method, params, id: requestId }\n    const httpResponse = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Accept: 'application/json',\n        ...(headers || {}),\n      },\n      body: JSON.stringify(rpcRequest),\n    })\n    if (!httpResponse.ok) {\n      let errorBodyText = '(empty or non-JSON response)'\n      try {\n        errorBodyText = await httpResponse.text()\n        const errorJson = JSON.parse(errorBodyText)\n        if (!errorJson.jsonrpc && errorJson.error) {\n          throw new Error(\n            `RPC error for ${method}: ${errorJson.error.message} (Code: ${errorJson.error.code}, HTTP Status: ${httpResponse.status}) Data: ${JSON.stringify(errorJson.error.data)}`,\n          )\n        } else if (!errorJson.jsonrpc) {\n          throw new Error(\n            `HTTP error for ${method}! Status: ${httpResponse.status} ${httpResponse.statusText}. Response: ${errorBodyText}`,\n          )\n        }\n      } catch (e: any) {\n        if (e.message.startsWith('RPC error for') || e.message.startsWith('HTTP error for')) throw e\n        throw new Error(\n          `HTTP error for ${method}! Status: ${httpResponse.status} ${httpResponse.statusText}. Response: ${errorBodyText}`,\n        )\n      }\n    }\n    const rpcResponse = await httpResponse.json()\n    if (rpcResponse.id !== requestId) {\n      throw new PaymentsError(\n        `CRITICAL: RPC response ID mismatch for method ${method}. Expected ${requestId}, got ${rpcResponse.id}. This may lead to incorrect response handling.`,\n        'payments_error',\n      )\n    }\n    return rpcResponse as TResponse\n  }\n}\n\nexport type {\n  MessageSendParams,\n  SendMessageResponse,\n  TaskQueryParams,\n  GetTaskResponse,\n  TaskPushNotificationConfig,\n  SetTaskPushNotificationConfigResponse,\n  TaskIdParams,\n  GetTaskPushNotificationConfigResponse,\n} from '@a2a-js/sdk'\n"]}

package/dist/a2a/paymentsRequestHandler.d.ts

@@ -105,6 +105,29 @@ export declare class PaymentsRequestHandler extends DefaultRequestHandler {
      * @returns Object containing PaymentsRequestContext and related data
      */
     private createPaymentsRequestContext;
+    /**
+     * x402 v2 A2A transport: if the request is payment-gated and arrived with no
+     * token (the middleware stored a `paymentRequired` on the HTTP context), build
+     * and return the spec-shaped `input-required` task carrying the
+     * X402PaymentRequired object under `x402.payment.required` — WITHOUT executing
+     * the agent. Returns `undefined` when a token was present (normal flow).
+     *
+     * @param params - The incoming message send parameters
+     * @returns The `input-required` Task to return to the client, or `undefined`
+     */
+    private buildPaymentRequiredTaskIfNeeded;
+    /**
+     * Stamp x402 settlement state onto the final task's metadata, in band, per the
+     * x402 v2 A2A transport. Only applied when the token arrived in band (so the
+     * legacy `payment-signature` header path is unchanged). On success the task
+     * carries `x402.payment.status: payment-completed` + `x402.payment.receipts`;
+     * on failure `payment-failed` + `x402.payment.error` + receipts.
+     *
+     * @param task - The current task (mutated in place)
+     * @param httpContext - The request's HTTP context
+     * @param settlement - The settlement result, or undefined when none ran
+     */
+    private recordInBandSettlement;
     /**
      * Processes streaming events with finalization (credits burning and push notifications).
      * Similar to processEventsWithFinalization but yields events for streaming.
@@ -115,7 +138,7 @@ export declare class PaymentsRequestHandler extends DefaultRequestHandler {
      * @param validation - The validation result
      * @returns Async generator yielding processed events
      */
-    protected processStreamingEventsWithFinalization(taskId: string, resultManager: ResultManager, eventQueue: ExecutionEventQueue, bearerToken: string): AsyncGenerator<A2AStreamEvent, void, undefined>;
+    protected processStreamingEventsWithFinalization(taskId: string, resultManager: ResultManager, eventQueue: ExecutionEventQueue, bearerToken: string, requestHttpContext?: HttpRequestContext): AsyncGenerator<A2AStreamEvent, void, undefined>;
     /**
      * Processes all events, calling handleTaskFinalization when a terminal status-update event is received.
      * In async mode, it can be launched in background.
@@ -123,7 +146,7 @@ export declare class PaymentsRequestHandler extends DefaultRequestHandler {
     protected processEventsWithFinalization(taskId: string, resultManager: ResultManager, eventQueue: ExecutionEventQueue, bearerToken: string, validation: StartAgentRequest, options?: {
         firstResultResolver?: (event: any) => void;
         firstResultRejector?: (err: any) => void;
-    }): Promise<void>;
+    }, requestHttpContext?: HttpRequestContext): Promise<void>;
     /**
      * Sends a message, validating credits before execution and burning credits after.
      * Also sends a push notification if the task reaches a terminal state.