@agent-score/commerce 1.6.0 → 1.8.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-export { AccountVerification, AgentIdentity, AgentMemoryHint, AgentScoreCore, AgentScoreCoreOptions, AssessResult, CreateSessionOnMissing, DenialCode, DenialReason, EvaluateOutcome, OperatorVerification, PolicyCheck, PolicyResult, VerifyWalletSignerMatchOptions, VerifyWalletSignerResult, buildAgentMemoryHint } from './core.mjs';
-export { P as PaymentSigner, S as SignerNetwork, a as extractPaymentSigner, e as extractPaymentSignerAddress, r as readX402PaymentHeader } from './signer-kCAJUZwp.mjs';
-export { F as FIXABLE_DENIAL_REASONS, b as buildContactSupportNextSteps, a as buildSignerMismatchBody, d as denialReasonStatus, c as denialReasonToBody, i as isFixableDenial, v as verificationAgentInstructions } from './_response-DpB-cm2c.mjs';
+export { AccountVerification, AgentIdentity, AgentMemoryHint, AgentScoreCore, AgentScoreCoreOptions, AssessResult, CreateSessionOnMissing, DenialCode, DenialReason, EvaluateOutcome, OperatorVerification, PolicyCheck, PolicyResult, SignerVerdict, VerifyWalletSignerResult, buildAgentMemoryHint } from './core.mjs';
+export { P as PaymentSigner, S as SignerNetwork, e as extractPaymentSigner, r as readX402PaymentHeader } from './signer-CFVQsWjL.mjs';
+export { F as FIXABLE_DENIAL_REASONS, b as buildContactSupportNextSteps, a as buildSignerMismatchBody, d as denialReasonStatus, c as denialReasonToBody, i as isFixableDenial, v as verificationAgentInstructions } from './_response-BMt2y4Or.mjs';
 export { EnforcementMode, GateResult, IdentityStatus, PolicyBlock, buildGateOptionsFromPolicy, runGateWithEnforcement, shippingCountryAllowed, shippingStateAllowed } from './identity/policy.mjs';
 
 /**
@@ -445,13 +445,7 @@ interface AgentScoreGatePolicy {
  *     ],
  *   },
  *   payment_handlers: {
- *     'sh.agentscore.payment.tempo': [{
- *       id: 'tempo',
- *       version: '2026-04-08',
- *       spec: 'https://agentscore.sh/specification/payment-handlers/tempo',
- *       schema: 'https://agentscore.sh/schemas/payment-handlers/tempo.json',
- *       config: { recipient: TEMPO_ADDR },
- *     }],
+ *     ...mppPaymentHandler({ networks: [{ network: 'tempo-mainnet', chain_id: 4217, recipient: TEMPO_ADDR }] }),
  *   },
  *   signing_keys: [signingKey],
  *   agentscore_gate: { require_kyc: true, min_age: 21, allowed_jurisdictions: ['US'] },
@@ -460,6 +454,74 @@ interface AgentScoreGatePolicy {
  */
 declare function buildUCPProfile(input: BuildUCPProfileInput): UCPProfile;
 declare const AGENTSCORE_UCP_CAPABILITY = "sh.agentscore.identity";
+type MppNetwork = 'tempo-mainnet' | 'tempo-testnet' | 'mpp-solana-mainnet' | 'mpp-solana-devnet' | (string & {});
+interface MppNetworkEntry {
+    network: MppNetwork;
+    /** EVM-style chain id (e.g. 4217 for Tempo mainnet). Omit for non-EVM networks. */
+    chain_id?: number;
+    /** Static settlement address. Omit for per-order recipients (e.g. Stripe-derived deposits). */
+    recipient?: string;
+    [k: string]: unknown;
+}
+interface MppPaymentHandlerInput {
+    networks: MppNetworkEntry[];
+}
+type X402Network = `base-${number}` | 'solana-mainnet-beta' | 'solana-devnet' | 'stellar-pubnet' | 'stellar-testnet' | (string & {});
+interface X402NetworkEntry {
+    network: X402Network;
+    /** Static settlement address. Omit for per-order recipients. */
+    recipient?: string;
+    [k: string]: unknown;
+}
+interface X402PaymentHandlerInput {
+    networks: X402NetworkEntry[];
+}
+interface StripeSptPaymentHandlerInput {
+    /** Stripe profile id (the merchant-side network identifier the agent's SPT is scoped to). */
+    profile_id: string;
+}
+/**
+ * Build the `sh.agentscore.payment.mpp` payment handler block for a UCP profile.
+ *
+ * @example
+ * ```ts
+ * buildUCPProfile({
+ *   ...,
+ *   payment_handlers: {
+ *     ...mppPaymentHandler({ networks: [{ network: 'tempo-mainnet', chain_id: 4217 }] }),
+ *   },
+ * });
+ * ```
+ */
+declare function mppPaymentHandler(input: MppPaymentHandlerInput): Record<string, UCPPaymentHandlerBinding[]>;
+/**
+ * Build the `sh.agentscore.payment.x402` payment handler block for a UCP profile.
+ *
+ * @example
+ * ```ts
+ * buildUCPProfile({
+ *   ...,
+ *   payment_handlers: {
+ *     ...x402PaymentHandler({ networks: [{ network: 'base-8453', recipient: '0xabc...' }] }),
+ *   },
+ * });
+ * ```
+ */
+declare function x402PaymentHandler(input: X402PaymentHandlerInput): Record<string, UCPPaymentHandlerBinding[]>;
+/**
+ * Build the `sh.agentscore.payment.stripe_spt` payment handler block for a UCP profile.
+ *
+ * @example
+ * ```ts
+ * buildUCPProfile({
+ *   ...,
+ *   payment_handlers: {
+ *     ...stripeSptPaymentHandler({ profile_id: 'profile_5xKvNqM9BaH' }),
+ *   },
+ * });
+ * ```
+ */
+declare function stripeSptPaymentHandler(input: StripeSptPaymentHandlerInput): Record<string, UCPPaymentHandlerBinding[]>;
 
 /**
  * UCP profile signing helpers (JWKS + JWS).
@@ -592,4 +654,4 @@ declare function verifyUCPProfile(profile: SignedUCPProfile, jwks: JWKSResponse)
  */
 declare function buildJWKSResponse(keys: UCPSigningKey[]): JWKSResponse;
 
-export { type A2AAgentCard, type A2AAgentCardCapabilities, type A2AAgentCardExtension, type A2AAgentCardSignature, type A2AAgentInterface, type A2AAgentProvider, type A2AAgentSkill, AGENTSCORE_UCP_CAPABILITY, type AgentScoreGatePolicy, type BuildA2AAgentCardInput, type BuildUCPProfileInput, type GeneratedUCPKey, type JWKSResponse, type SignUCPProfileOptions, type SignedUCPProfile, type UCPCapabilityBinding, type UCPPaymentHandlerBinding, type UCPProfile, type UCPProfileBody, type UCPServiceBinding, UCPSigningKey, UCPVerificationError, UCP_A2A_EXTENSION_URI, buildA2AAgentCard, buildJWKSResponse, buildUCPProfile, generateUCPSigningKey, signUCPProfile, ucpA2AExtension, verifyUCPProfile };
+export { type A2AAgentCard, type A2AAgentCardCapabilities, type A2AAgentCardExtension, type A2AAgentCardSignature, type A2AAgentInterface, type A2AAgentProvider, type A2AAgentSkill, AGENTSCORE_UCP_CAPABILITY, type AgentScoreGatePolicy, type BuildA2AAgentCardInput, type BuildUCPProfileInput, type GeneratedUCPKey, type JWKSResponse, type MppNetworkEntry, type MppPaymentHandlerInput, type SignUCPProfileOptions, type SignedUCPProfile, type StripeSptPaymentHandlerInput, type UCPCapabilityBinding, type UCPPaymentHandlerBinding, type UCPProfile, type UCPProfileBody, type UCPServiceBinding, UCPSigningKey, UCPVerificationError, UCP_A2A_EXTENSION_URI, type X402NetworkEntry, type X402PaymentHandlerInput, buildA2AAgentCard, buildJWKSResponse, buildUCPProfile, generateUCPSigningKey, mppPaymentHandler, signUCPProfile, stripeSptPaymentHandler, ucpA2AExtension, verifyUCPProfile, x402PaymentHandler };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { AccountVerification, AgentIdentity, AgentMemoryHint, AgentScoreCore, AgentScoreCoreOptions, AssessResult, CreateSessionOnMissing, DenialCode, DenialReason, EvaluateOutcome, OperatorVerification, PolicyCheck, PolicyResult, VerifyWalletSignerMatchOptions, VerifyWalletSignerResult, buildAgentMemoryHint } from './core.js';
-export { P as PaymentSigner, S as SignerNetwork, a as extractPaymentSigner, e as extractPaymentSignerAddress, r as readX402PaymentHeader } from './signer-kCAJUZwp.js';
-export { F as FIXABLE_DENIAL_REASONS, b as buildContactSupportNextSteps, a as buildSignerMismatchBody, d as denialReasonStatus, c as denialReasonToBody, i as isFixableDenial, v as verificationAgentInstructions } from './_response-C2yFQoIA.js';
+export { AccountVerification, AgentIdentity, AgentMemoryHint, AgentScoreCore, AgentScoreCoreOptions, AssessResult, CreateSessionOnMissing, DenialCode, DenialReason, EvaluateOutcome, OperatorVerification, PolicyCheck, PolicyResult, SignerVerdict, VerifyWalletSignerResult, buildAgentMemoryHint } from './core.js';
+export { P as PaymentSigner, S as SignerNetwork, e as extractPaymentSigner, r as readX402PaymentHeader } from './signer-CFVQsWjL.js';
+export { F as FIXABLE_DENIAL_REASONS, b as buildContactSupportNextSteps, a as buildSignerMismatchBody, d as denialReasonStatus, c as denialReasonToBody, i as isFixableDenial, v as verificationAgentInstructions } from './_response-DyJ3mWI3.js';
 export { EnforcementMode, GateResult, IdentityStatus, PolicyBlock, buildGateOptionsFromPolicy, runGateWithEnforcement, shippingCountryAllowed, shippingStateAllowed } from './identity/policy.js';
 
 /**
@@ -445,13 +445,7 @@ interface AgentScoreGatePolicy {
  *     ],
  *   },
  *   payment_handlers: {
- *     'sh.agentscore.payment.tempo': [{
- *       id: 'tempo',
- *       version: '2026-04-08',
- *       spec: 'https://agentscore.sh/specification/payment-handlers/tempo',
- *       schema: 'https://agentscore.sh/schemas/payment-handlers/tempo.json',
- *       config: { recipient: TEMPO_ADDR },
- *     }],
+ *     ...mppPaymentHandler({ networks: [{ network: 'tempo-mainnet', chain_id: 4217, recipient: TEMPO_ADDR }] }),
  *   },
  *   signing_keys: [signingKey],
  *   agentscore_gate: { require_kyc: true, min_age: 21, allowed_jurisdictions: ['US'] },
@@ -460,6 +454,74 @@ interface AgentScoreGatePolicy {
  */
 declare function buildUCPProfile(input: BuildUCPProfileInput): UCPProfile;
 declare const AGENTSCORE_UCP_CAPABILITY = "sh.agentscore.identity";
+type MppNetwork = 'tempo-mainnet' | 'tempo-testnet' | 'mpp-solana-mainnet' | 'mpp-solana-devnet' | (string & {});
+interface MppNetworkEntry {
+    network: MppNetwork;
+    /** EVM-style chain id (e.g. 4217 for Tempo mainnet). Omit for non-EVM networks. */
+    chain_id?: number;
+    /** Static settlement address. Omit for per-order recipients (e.g. Stripe-derived deposits). */
+    recipient?: string;
+    [k: string]: unknown;
+}
+interface MppPaymentHandlerInput {
+    networks: MppNetworkEntry[];
+}
+type X402Network = `base-${number}` | 'solana-mainnet-beta' | 'solana-devnet' | 'stellar-pubnet' | 'stellar-testnet' | (string & {});
+interface X402NetworkEntry {
+    network: X402Network;
+    /** Static settlement address. Omit for per-order recipients. */
+    recipient?: string;
+    [k: string]: unknown;
+}
+interface X402PaymentHandlerInput {
+    networks: X402NetworkEntry[];
+}
+interface StripeSptPaymentHandlerInput {
+    /** Stripe profile id (the merchant-side network identifier the agent's SPT is scoped to). */
+    profile_id: string;
+}
+/**
+ * Build the `sh.agentscore.payment.mpp` payment handler block for a UCP profile.
+ *
+ * @example
+ * ```ts
+ * buildUCPProfile({
+ *   ...,
+ *   payment_handlers: {
+ *     ...mppPaymentHandler({ networks: [{ network: 'tempo-mainnet', chain_id: 4217 }] }),
+ *   },
+ * });
+ * ```
+ */
+declare function mppPaymentHandler(input: MppPaymentHandlerInput): Record<string, UCPPaymentHandlerBinding[]>;
+/**
+ * Build the `sh.agentscore.payment.x402` payment handler block for a UCP profile.
+ *
+ * @example
+ * ```ts
+ * buildUCPProfile({
+ *   ...,
+ *   payment_handlers: {
+ *     ...x402PaymentHandler({ networks: [{ network: 'base-8453', recipient: '0xabc...' }] }),
+ *   },
+ * });
+ * ```
+ */
+declare function x402PaymentHandler(input: X402PaymentHandlerInput): Record<string, UCPPaymentHandlerBinding[]>;
+/**
+ * Build the `sh.agentscore.payment.stripe_spt` payment handler block for a UCP profile.
+ *
+ * @example
+ * ```ts
+ * buildUCPProfile({
+ *   ...,
+ *   payment_handlers: {
+ *     ...stripeSptPaymentHandler({ profile_id: 'profile_5xKvNqM9BaH' }),
+ *   },
+ * });
+ * ```
+ */
+declare function stripeSptPaymentHandler(input: StripeSptPaymentHandlerInput): Record<string, UCPPaymentHandlerBinding[]>;
 
 /**
  * UCP profile signing helpers (JWKS + JWS).
@@ -592,4 +654,4 @@ declare function verifyUCPProfile(profile: SignedUCPProfile, jwks: JWKSResponse)
  */
 declare function buildJWKSResponse(keys: UCPSigningKey[]): JWKSResponse;
 
-export { type A2AAgentCard, type A2AAgentCardCapabilities, type A2AAgentCardExtension, type A2AAgentCardSignature, type A2AAgentInterface, type A2AAgentProvider, type A2AAgentSkill, AGENTSCORE_UCP_CAPABILITY, type AgentScoreGatePolicy, type BuildA2AAgentCardInput, type BuildUCPProfileInput, type GeneratedUCPKey, type JWKSResponse, type SignUCPProfileOptions, type SignedUCPProfile, type UCPCapabilityBinding, type UCPPaymentHandlerBinding, type UCPProfile, type UCPProfileBody, type UCPServiceBinding, UCPSigningKey, UCPVerificationError, UCP_A2A_EXTENSION_URI, buildA2AAgentCard, buildJWKSResponse, buildUCPProfile, generateUCPSigningKey, signUCPProfile, ucpA2AExtension, verifyUCPProfile };
+export { type A2AAgentCard, type A2AAgentCardCapabilities, type A2AAgentCardExtension, type A2AAgentCardSignature, type A2AAgentInterface, type A2AAgentProvider, type A2AAgentSkill, AGENTSCORE_UCP_CAPABILITY, type AgentScoreGatePolicy, type BuildA2AAgentCardInput, type BuildUCPProfileInput, type GeneratedUCPKey, type JWKSResponse, type MppNetworkEntry, type MppPaymentHandlerInput, type SignUCPProfileOptions, type SignedUCPProfile, type StripeSptPaymentHandlerInput, type UCPCapabilityBinding, type UCPPaymentHandlerBinding, type UCPProfile, type UCPProfileBody, type UCPServiceBinding, UCPSigningKey, UCPVerificationError, UCP_A2A_EXTENSION_URI, type X402NetworkEntry, type X402PaymentHandlerInput, buildA2AAgentCard, buildJWKSResponse, buildUCPProfile, generateUCPSigningKey, mppPaymentHandler, signUCPProfile, stripeSptPaymentHandler, ucpA2AExtension, verifyUCPProfile, x402PaymentHandler };

package/dist/index.js

@@ -45,17 +45,19 @@ __export(index_exports, {
   denialReasonStatus: () => denialReasonStatus,
   denialReasonToBody: () => denialReasonToBody,
   extractPaymentSigner: () => extractPaymentSigner,
-  extractPaymentSignerAddress: () => extractPaymentSignerAddress,
   generateUCPSigningKey: () => generateUCPSigningKey,
   isFixableDenial: () => isFixableDenial,
+  mppPaymentHandler: () => mppPaymentHandler,
   readX402PaymentHeader: () => readX402PaymentHeader,
   runGateWithEnforcement: () => runGateWithEnforcement,
   shippingCountryAllowed: () => shippingCountryAllowed,
   shippingStateAllowed: () => shippingStateAllowed,
   signUCPProfile: () => signUCPProfile,
+  stripeSptPaymentHandler: () => stripeSptPaymentHandler,
   ucpA2AExtension: () => ucpA2AExtension,
   verificationAgentInstructions: () => verificationAgentInstructions,
-  verifyUCPProfile: () => verifyUCPProfile
+  verifyUCPProfile: () => verifyUCPProfile,
+  x402PaymentHandler: () => x402PaymentHandler
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -79,7 +81,7 @@ function denialReasonStatus(reason) {
 }
 function buildSignerMismatchBody(input) {
   const { result } = input;
-  if (result.kind === "pass" || result.kind === "api_error") return null;
+  if (result.kind === "pass") return null;
   const learnMoreUrl = input.learnMoreUrl ?? "https://docs.agentscore.sh/guides/agent-identity";
   if (result.kind === "wallet_signer_mismatch") {
     const linkedWallets = result.linkedWallets ?? [];
@@ -375,10 +377,6 @@ async function extractPaymentSigner(request, x402PaymentHeader) {
   }
   return null;
 }
-async function extractPaymentSignerAddress(request, x402PaymentHeader) {
-  const result = await extractPaymentSigner(request, x402PaymentHeader);
-  return result?.address ?? null;
-}
 function readX402PaymentHeader(request) {
   return request.headers.get("payment-signature") ?? request.headers.get("x-payment") ?? void 0;
 }
@@ -554,6 +552,42 @@ function buildUCPProfile(input) {
   return profile;
 }
 var AGENTSCORE_UCP_CAPABILITY = AGENTSCORE_CAPABILITY_NAME;
+var HANDLER_VERSION = "2026-04-08";
+var SPEC_BASE = "https://agentscore.sh/specification/payment-handlers";
+var SCHEMA_BASE = "https://agentscore.sh/schemas/payment-handlers";
+function mppPaymentHandler(input) {
+  return {
+    "sh.agentscore.payment.mpp": [{
+      id: "mpp",
+      version: HANDLER_VERSION,
+      spec: `${SPEC_BASE}/mpp`,
+      schema: `${SCHEMA_BASE}/mpp.json`,
+      config: { networks: input.networks }
+    }]
+  };
+}
+function x402PaymentHandler(input) {
+  return {
+    "sh.agentscore.payment.x402": [{
+      id: "x402",
+      version: HANDLER_VERSION,
+      spec: `${SPEC_BASE}/x402`,
+      schema: `${SCHEMA_BASE}/x402.json`,
+      config: { networks: input.networks }
+    }]
+  };
+}
+function stripeSptPaymentHandler(input) {
+  return {
+    "sh.agentscore.payment.stripe_spt": [{
+      id: "stripe-spt",
+      version: HANDLER_VERSION,
+      spec: `${SPEC_BASE}/stripe_spt`,
+      schema: `${SCHEMA_BASE}/stripe_spt.json`,
+      config: { rail: "stripe-spt", profile_id: input.profile_id }
+    }]
+  };
+}
 
 // src/identity/ucp-jwks.ts
 var JOSE_INSTALL_HINT = "Install the optional peer dependency: `npm install jose@^6` (or `bun add jose`). Tested against jose v6.x.";
@@ -890,16 +924,18 @@ function shippingStateAllowed(state, country, policy) {
   denialReasonStatus,
   denialReasonToBody,
   extractPaymentSigner,
-  extractPaymentSignerAddress,
   generateUCPSigningKey,
   isFixableDenial,
+  mppPaymentHandler,
   readX402PaymentHeader,
   runGateWithEnforcement,
   shippingCountryAllowed,
   shippingStateAllowed,
   signUCPProfile,
+  stripeSptPaymentHandler,
   ucpA2AExtension,
   verificationAgentInstructions,
-  verifyUCPProfile
+  verifyUCPProfile,
+  x402PaymentHandler
 });
 //# sourceMappingURL=index.js.map