agents 0.26.0 → 0.28.0

package/dist/mcp/client/x402.d.ts

@@ -2,7 +2,7 @@ import {
   n as LegacyCallToolResultSchema,
   t as CompatibleMcpClient
 } from "../../invoker-CG0_p_Wq.js";
-import { ZodRawShape } from "zod";
+import { ZodRawShape, z } from "zod";
 import {
   CallToolRequest,
   CallToolRequestOptions
@@ -12,8 +12,14 @@ import {
   ToolAnnotations
 } from "@modelcontextprotocol/sdk/types.js";
 import {
+  CallToolResult as CallToolResult$1,
   McpServer,
   RegisteredTool,
+  ServerContext
+} from "@modelcontextprotocol/server";
+import {
+  McpServer as McpServer$1,
+  RegisteredTool as RegisteredTool$1,
   ToolCallback
 } from "@modelcontextprotocol/sdk/server/mcp.js";
 import {
@@ -48,19 +54,43 @@ type X402Config = {
   facilitator?: FacilitatorConfig$1 /** @deprecated No longer used in v2. The protocol version is determined automatically. */;
   version?: number;
 };
-interface X402AugmentedServer {
+/**
+ * The tool body passed to `paidTool`. On an SDK v1 server it is the v1
+ * `ToolCallback`; on an SDK v2 server it receives the v2 `ServerContext`.
+ */
+type PaidToolCallback<
+  Args extends ZodRawShape,
+  Server extends McpServer$1 | McpServer = McpServer$1
+> = Server extends McpServer
+  ? (
+      args: z.infer<z.ZodObject<Args>>,
+      ctx: ServerContext
+    ) => CallToolResult$1 | Promise<CallToolResult$1>
+  : ToolCallback<Args>;
+interface X402AugmentedServer<
+  Server extends McpServer$1 | McpServer = McpServer$1
+> {
   paidTool<Args extends ZodRawShape>(
     name: string,
     description: string,
     priceUSD: number,
     paramsSchema: Args,
     annotations: ToolAnnotations,
-    cb: ToolCallback<Args>
-  ): RegisteredTool;
+    cb: PaidToolCallback<Args, Server>
+  ): Server extends McpServer ? RegisteredTool : RegisteredTool$1;
 }
+/**
+ * Add `paidTool` to an MCP server. Accepts an SDK v1 `McpServer`
+ * (`@modelcontextprotocol/sdk`) or an SDK v2 `McpServer`
+ * (`@modelcontextprotocol/server`).
+ */
 declare function withX402<T extends McpServer>(
   server: T,
   cfg: X402Config
+): T & X402AugmentedServer<McpServer>;
+declare function withX402<T extends McpServer$1>(
+  server: T,
+  cfg: X402Config
 ): T & X402AugmentedServer;
 interface X402AugmentedClient {
   callTool(
@@ -109,6 +139,7 @@ export {
   type ClientEvmSigner,
   type FacilitatorConfig,
   type Network,
+  PaidToolCallback,
   type PaymentRequired,
   type PaymentRequirements,
   X402AugmentedClient,

package/dist/mcp/client/x402.js

@@ -21,6 +21,27 @@ const LEGACY_NETWORK_MAP = {
 function normalizeNetwork(network) {
 	return LEGACY_NETWORK_MAP[network] ?? network;
 }
+function readHeader(headers, name) {
+	if (!headers) return void 0;
+	if (typeof headers.get === "function") return headers.get(name) ?? void 0;
+	const wanted = name.toLowerCase();
+	for (const [key, value] of Object.entries(headers)) {
+		if (key.toLowerCase() !== wanted) continue;
+		const first = Array.isArray(value) ? value[0] : value;
+		if (typeof first === "string") return first;
+	}
+}
+/**
+* Read the x402 payment token from a tool handler context of either SDK
+* generation. Request `_meta` wins over headers, and header names match
+* case-insensitively. `PAYMENT-SIGNATURE` is x402 v2; `X-PAYMENT` is v1.
+*/
+function readPaymentToken(extra) {
+	const ctx = extra ?? {};
+	const meta = ctx.mcpReq?._meta ?? ctx._meta;
+	const headers = ctx.http?.req?.headers ?? ctx.requestInfo?.headers;
+	return meta?.["x402/payment"] ?? readHeader(headers, "PAYMENT-SIGNATURE") ?? readHeader(headers, "X-PAYMENT");
+}
 function withX402(server, cfg) {
 	const network = normalizeNetwork(cfg.network);
 	const resourceServer = new x402ResourceServer(new HTTPFacilitatorClient(cfg.facilitator ?? { url: "https://x402.org/facilitator" }));
@@ -33,7 +54,8 @@ function withX402(server, cfg) {
 		});
 		return initPromise;
 	}
-	function paidTool(name, description, priceUSD, paramsSchema, annotations, cb) {
+	function paidTool(name, description, priceUSD, paramsSchema, annotations, toolCb) {
+		const cb = toolCb;
 		return server.registerTool(name, {
 			description,
 			inputSchema: paramsSchema,
@@ -73,8 +95,7 @@ function withX402(server, cfg) {
 				description,
 				mimeType: "application/json"
 			};
-			const headers = extra?.requestInfo?.headers ?? {};
-			const token = extra?._meta?.["x402/payment"] ?? headers["PAYMENT-SIGNATURE"] ?? headers["X-PAYMENT"];
+			const token = readPaymentToken(extra);
 			const paymentRequired = (reason = "PAYMENT_REQUIRED", extraFields = {}) => {
 				const payload = {
 					x402Version: 2,

package/dist/mcp/client/x402.js.map

@@ -1 +1 @@
-{"version":3,"file":"x402.js","names":[],"sources":["../../../src/mcp/client/x402.ts"],"sourcesContent":["/**\n * X402 MCP Integration (v2)\n *\n * Based on:\n * - Coinbase's x402 (Apache 2.0): https://github.com/coinbase/x402\n * - @ethanniser and his work at https://github.com/ethanniser/x402-mcp\n */\n\nimport type {\n  McpServer,\n  RegisteredTool,\n  ToolCallback\n} from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type {\n  CallToolRequest,\n  CallToolRequestOptions,\n  Client as MCPClient\n} from \"@modelcontextprotocol/client\";\nimport type {\n  CallToolResult,\n  ToolAnnotations\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport {\n  bindMcpClient,\n  type CallToolSchemaOrOptions,\n  type CompatibleMcpClient,\n  type LegacyCallToolResultSchema\n} from \"./invoker\";\nimport type { ZodRawShape } from \"zod\";\n\n// v2 imports from @x402/core\nimport { x402ResourceServer, HTTPFacilitatorClient } from \"@x402/core/server\";\nimport type { FacilitatorConfig, ResourceConfig } from \"@x402/core/server\";\nimport { x402Client } from \"@x402/core/client\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  PaymentRequired,\n  Network\n} from \"@x402/core/types\";\n\n// v2 imports from @x402/evm\nimport { registerExactEvmScheme as registerServerEvmScheme } from \"@x402/evm/exact/server\";\nimport { registerExactEvmScheme as registerClientEvmScheme } from \"@x402/evm/exact/client\";\nimport type { ClientEvmSigner } from \"@x402/evm\";\n\n// Re-export commonly used types for consumer convenience\nexport type {\n  PaymentRequirements,\n  PaymentRequired,\n  Network\n} from \"@x402/core/types\";\nexport type { FacilitatorConfig } from \"@x402/core/server\";\nexport type { ClientEvmSigner } from \"@x402/evm\";\n\n/**\n * Map of legacy v1 network names to CAIP-2 identifiers.\n * Allows backward compatibility with v1 config.\n */\nconst LEGACY_NETWORK_MAP: Record<string, string> = {\n  \"base-sepolia\": \"eip155:84532\",\n  base: \"eip155:8453\",\n  ethereum: \"eip155:1\",\n  sepolia: \"eip155:11155111\"\n};\n\n/**\n * Normalize a network identifier to CAIP-2 format.\n * Accepts both legacy v1 names (\"base-sepolia\") and CAIP-2 (\"eip155:84532\").\n */\nexport function normalizeNetwork(network: string): Network {\n  return (LEGACY_NETWORK_MAP[network] ?? network) as Network;\n}\n\n/*\n  ======= SERVER SIDE =======\n*/\n\nexport type X402Config = {\n  /**\n   * Network identifier.\n   * Accepts both legacy names (\"base-sepolia\") and CAIP-2 format (\"eip155:84532\").\n   */\n  network: string;\n  /** Payment recipient address */\n  recipient: `0x${string}`;\n  /** Facilitator configuration. Defaults to https://x402.org/facilitator */\n  facilitator?: FacilitatorConfig;\n  /** @deprecated No longer used in v2. The protocol version is determined automatically. */\n  version?: number;\n};\n\nexport interface X402AugmentedServer {\n  paidTool<Args extends ZodRawShape>(\n    name: string,\n    description: string,\n    priceUSD: number,\n    paramsSchema: Args,\n    annotations: ToolAnnotations,\n    cb: ToolCallback<Args>\n  ): RegisteredTool;\n}\n\nexport function withX402<T extends McpServer>(\n  server: T,\n  cfg: X402Config\n): T & X402AugmentedServer {\n  const network = normalizeNetwork(cfg.network);\n  const facilitatorConfig: FacilitatorConfig = cfg.facilitator ?? {\n    url: \"https://x402.org/facilitator\"\n  };\n\n  // Create v2 resource server with facilitator client\n  const facilitatorClient = new HTTPFacilitatorClient(facilitatorConfig);\n  const resourceServer = new x402ResourceServer(facilitatorClient);\n  registerServerEvmScheme(resourceServer);\n\n  // Lazy initialization: fetch supported kinds from facilitator on first use\n  let initPromise: Promise<void> | null = null;\n  function ensureInitialized(): Promise<void> {\n    if (!initPromise) {\n      initPromise = resourceServer.initialize().catch((err) => {\n        initPromise = null; // allow retry on failure\n        throw err;\n      });\n    }\n    return initPromise;\n  }\n\n  function paidTool<Args extends ZodRawShape>(\n    name: string,\n    description: string,\n    priceUSD: number,\n    paramsSchema: Args,\n    annotations: ToolAnnotations,\n    cb: ToolCallback<Args>\n  ): RegisteredTool {\n    return server.registerTool(\n      name,\n      {\n        description,\n        inputSchema: paramsSchema,\n        annotations,\n        _meta: {\n          \"agents-x402/paymentRequired\": true,\n          \"agents-x402/priceUSD\": priceUSD\n        }\n      },\n      (async (args, extra) => {\n        await ensureInitialized();\n\n        // Build v2 payment requirements for this tool call\n        const resourceConfig: ResourceConfig = {\n          scheme: \"exact\",\n          payTo: cfg.recipient,\n          price: priceUSD,\n          network,\n          maxTimeoutSeconds: 300\n        };\n\n        let requirements: PaymentRequirements[];\n        try {\n          requirements =\n            await resourceServer.buildPaymentRequirements(resourceConfig);\n        } catch {\n          const payload = { x402Version: 2, error: \"PRICE_COMPUTE_FAILED\" };\n          return {\n            isError: true,\n            _meta: { \"x402/error\": payload },\n            content: [{ type: \"text\", text: JSON.stringify(payload) }]\n          } as const;\n        }\n\n        const resourceInfo = {\n          url: `x402://${name}`,\n          description,\n          mimeType: \"application/json\"\n        };\n\n        // Get payment token from MCP _meta or HTTP headers\n        // Support both v2 (PAYMENT-SIGNATURE) and v1 (X-PAYMENT) header names\n        const headers = extra?.requestInfo?.headers ?? {};\n        const token =\n          (extra?._meta?.[\"x402/payment\"] as string | undefined) ??\n          headers[\"PAYMENT-SIGNATURE\"] ??\n          headers[\"X-PAYMENT\"];\n\n        const paymentRequired = (\n          reason = \"PAYMENT_REQUIRED\",\n          extraFields: Record<string, unknown> = {}\n        ) => {\n          const payload = {\n            x402Version: 2,\n            error: reason,\n            resource: resourceInfo,\n            accepts: requirements,\n            ...extraFields\n          };\n          return {\n            isError: true,\n            _meta: { \"x402/error\": payload },\n            content: [{ type: \"text\", text: JSON.stringify(payload) }]\n          } as const;\n        };\n\n        if (!token || typeof token !== \"string\") return paymentRequired();\n\n        // Decode the payment payload (base64-encoded JSON)\n        let paymentPayload: PaymentPayload;\n        try {\n          paymentPayload = JSON.parse(atob(token));\n        } catch {\n          return paymentRequired(\"INVALID_PAYMENT\");\n        }\n\n        // Find matching requirements for this payment\n        const matchingReq = resourceServer.findMatchingRequirements(\n          requirements,\n          paymentPayload\n        );\n        if (!matchingReq) {\n          return paymentRequired(\"INVALID_PAYMENT\");\n        }\n\n        // Verify payment with facilitator\n        try {\n          const vr = await resourceServer.verifyPayment(\n            paymentPayload,\n            matchingReq\n          );\n          if (!vr.isValid) {\n            return paymentRequired(vr.invalidReason ?? \"INVALID_PAYMENT\", {\n              payer: vr.payer\n            });\n          }\n        } catch {\n          return paymentRequired(\"INVALID_PAYMENT\");\n        }\n\n        // Execute the tool callback\n        let result: CallToolResult;\n        let failed = false;\n        try {\n          result = await cb(args, extra);\n          if (\n            result &&\n            typeof result === \"object\" &&\n            \"isError\" in result &&\n            result.isError\n          ) {\n            failed = true;\n          }\n        } catch (e) {\n          failed = true;\n          result = {\n            isError: true,\n            content: [\n              { type: \"text\", text: `Tool execution failed: ${String(e)}` }\n            ]\n          };\n        }\n\n        // Settle payment only on success\n        if (!failed) {\n          try {\n            const s = await resourceServer.settlePayment(\n              paymentPayload,\n              matchingReq\n            );\n            if (s.success) {\n              result._meta ??= {};\n              result._meta[\"x402/payment-response\"] = {\n                success: true,\n                transaction: s.transaction,\n                network: s.network,\n                payer: s.payer\n              };\n            } else {\n              return paymentRequired(s.errorReason ?? \"SETTLEMENT_FAILED\");\n            }\n          } catch {\n            return paymentRequired(\"SETTLEMENT_FAILED\");\n          }\n        }\n\n        return result;\n      }) as ToolCallback<Args>\n    );\n  }\n\n  Object.defineProperty(server, \"paidTool\", {\n    value: paidTool,\n    writable: false,\n    enumerable: false,\n    configurable: true\n  });\n\n  // Tell TS the object now also has the paidTool method\n  return server as T & X402AugmentedServer;\n}\n\n/*\n  ======= CLIENT SIDE =======\n*/\n\nexport interface X402AugmentedClient {\n  callTool(\n    x402ConfirmationCallback:\n      | ((payment: PaymentRequirements[]) => Promise<boolean>)\n      | null,\n    params: CallToolRequest[\"params\"],\n    options?: CallToolRequestOptions\n  ): Promise<CallToolResult>;\n  /**\n   * @deprecated Prefer the request-options overload. Explicit legacy result\n   * schemas remain honored through the SDK v2 request funnel.\n   */\n  callTool(\n    x402ConfirmationCallback:\n      | ((payment: PaymentRequirements[]) => Promise<boolean>)\n      | null,\n    params: CallToolRequest[\"params\"],\n    resultSchema: LegacyCallToolResultSchema,\n    options?: CallToolRequestOptions\n  ): Promise<CallToolResult>;\n}\n\nexport type X402ClientConfig = {\n  /**\n   * EVM account/signer for signing payment authorizations.\n   * Use `privateKeyToAccount()` from viem/accounts to create one.\n   */\n  account: ClientEvmSigner;\n  /**\n   * Preferred network identifier (optional).\n   * Accepts both legacy names (\"base-sepolia\") and CAIP-2 format (\"eip155:84532\").\n   * When set, the client prefers payment requirements matching this network.\n   * If omitted, the client automatically selects from available requirements.\n   */\n  network?: string;\n  /** Maximum payment value in atomic units (default: 0.10 USDC = 100000) */\n  maxPaymentValue?: bigint;\n  /** @deprecated No longer used in v2. The protocol version is determined automatically. */\n  version?: number;\n  /** Confirmation callback for payment approval */\n  confirmationCallback?: (payment: PaymentRequirements[]) => Promise<boolean>;\n};\n\nclass PaymentCapError extends Error {}\n// Thrown when the selected requirement cannot be cap-checked; the caller\n// returns the server's original 402 result, as before the hook existed.\nclass PaymentPassthroughError extends Error {}\n\nexport function withX402Client<T extends CompatibleMcpClient>(\n  client: T,\n  x402Config: X402ClientConfig\n): X402AugmentedClient & T {\n  const invoker = bindMcpClient(client);\n  const { account } = x402Config;\n\n  const maxPaymentValue = x402Config.maxPaymentValue ?? BigInt(100_000); // 0.10 USDC\n\n  // Create v2 x402 payment client with EVM scheme support\n  const paymentClient = new x402Client();\n  registerClientEvmScheme(paymentClient, { signer: account });\n\n  // Payment requests whose selection reached the hook below. x402 selects a\n  // requirement before it runs any hook, so a request that failed without\n  // getting here offered nothing this client can sign.\n  const selected = new WeakSet<PaymentRequired>();\n\n  // Selection applies scheme support and network preference before this hook.\n  // Enforce the cap on the requirement that will actually be signed. We throw\n  // rather than return `{ abort: true }` because @x402/core rewraps an abort in\n  // a plain Error, which would lose the typed errors the catch below relies on.\n  paymentClient.onBeforePaymentCreation(\n    async ({ paymentRequired, selectedRequirements }) => {\n      selected.add(paymentRequired);\n      const { scheme, amount } = selectedRequirements;\n      if (scheme !== \"exact\") throw new PaymentPassthroughError();\n      let value: bigint;\n      try {\n        value = BigInt(amount);\n      } catch {\n        throw new PaymentPassthroughError(); // malformed amount\n      }\n      if (value < 0n) throw new PaymentPassthroughError();\n      if (value > maxPaymentValue) {\n        throw new PaymentCapError(\n          `Payment exceeds client cap: ${value} > ${maxPaymentValue}`\n        );\n      }\n    }\n  );\n\n  // If a preferred network is specified, register a policy to prefer it\n  if (x402Config.network) {\n    const preferredNetwork = normalizeNetwork(x402Config.network);\n    paymentClient.registerPolicy((_version, reqs) => {\n      const matching = reqs.filter((r) => r.network === preferredNetwork);\n      return matching.length > 0 ? matching : reqs;\n    });\n  }\n\n  const listTools = async (\n    params?: Parameters<MCPClient[\"listTools\"]>[0],\n    options?: Parameters<MCPClient[\"listTools\"]>[1]\n  ) => {\n    const toolsRes = await invoker.listTools(params, options);\n    return {\n      ...toolsRes,\n      tools: toolsRes.tools.map((tool) => {\n        let description = tool.description;\n        // Check _meta for payment information (agents-x402/ is our extension for pre-advertising prices)\n        if (tool._meta?.[\"agents-x402/paymentRequired\"]) {\n          const cost = tool._meta?.[\"agents-x402/priceUSD\"]\n            ? `$${tool._meta?.[\"agents-x402/priceUSD\"]}`\n            : \"an unknown amount\";\n          description += ` (This is a paid tool, you will be charged ${cost} for its execution)`;\n        }\n        return {\n          ...tool,\n          description\n        };\n      })\n    };\n  };\n\n  const callToolWithPayment = async (\n    x402ConfirmationCallback:\n      | ((payment: PaymentRequirements[]) => Promise<boolean>)\n      | null,\n    params: CallToolRequest[\"params\"],\n    schemaOrOptions?: CallToolSchemaOrOptions,\n    options?: CallToolRequestOptions\n  ): ReturnType<MCPClient[\"callTool\"]> => {\n    const invoke = (callParams: CallToolRequest[\"params\"]) =>\n      invoker.callTool(callParams, schemaOrOptions, options);\n    const res = await invoke(params);\n\n    // Check for x402 payment required error in response metadata\n    const maybeX402Error = res._meta?.[\"x402/error\"] as\n      | (PaymentRequired & Record<string, unknown>)\n      | undefined;\n\n    if (\n      res.isError &&\n      maybeX402Error &&\n      maybeX402Error.accepts &&\n      Array.isArray(maybeX402Error.accepts) &&\n      maybeX402Error.accepts.length > 0\n    ) {\n      // Snapshot the requirements: what is cap-checked and signed below is\n      // this copy, not the server's result object or anything aliasing it.\n      const accepts = structuredClone(\n        maybeX402Error.accepts\n      ) as PaymentRequirements[];\n      const confirmationCallback =\n        x402ConfirmationCallback ?? x402Config.confirmationCallback;\n\n      // Use the confirmation callback if provided. It receives deep copies\n      // so a retained reference cannot alter what is cap-checked and signed.\n      if (\n        confirmationCallback &&\n        !(await confirmationCallback(\n          accepts.map((req) => structuredClone(req))\n        ))\n      ) {\n        return {\n          isError: true,\n          content: [{ type: \"text\", text: \"User declined payment\" }]\n        };\n      }\n\n      // Reconstruct the PaymentRequired response for the v2 x402 client\n      const paymentRequiredResponse: PaymentRequired = {\n        x402Version: (maybeX402Error.x402Version as number) ?? 2,\n        resource: (maybeX402Error.resource as PaymentRequired[\"resource\"]) ?? {\n          url: \"\",\n          description: \"\",\n          mimeType: \"application/json\"\n        },\n        accepts,\n        extensions: maybeX402Error.extensions as\n          | Record<string, unknown>\n          | undefined\n      };\n\n      // Create the payment payload using the v2 x402 client\n      let paymentPayload: PaymentPayload;\n      try {\n        paymentPayload = await paymentClient.createPaymentPayload(\n          paymentRequiredResponse\n        );\n      } catch (error) {\n        // Nothing this client can sign, or a selection it cannot cap-check:\n        // return the server's 402 with its payment options, as before.\n        if (\n          error instanceof PaymentPassthroughError ||\n          !selected.has(paymentRequiredResponse)\n        ) {\n          return res;\n        }\n        return {\n          isError: true,\n          content: [\n            {\n              type: \"text\",\n              text:\n                error instanceof PaymentCapError\n                  ? error.message\n                  : \"Failed to create payment payload\"\n            }\n          ]\n        };\n      }\n\n      // Encode the payment payload as a base64 JSON token for MCP transport\n      const token = btoa(JSON.stringify(paymentPayload));\n\n      // Retry the tool call with the payment token\n      return invoke({\n        ...params,\n        _meta: {\n          ...params._meta,\n          \"x402/payment\": token\n        }\n      });\n    }\n\n    return res;\n  };\n\n  const _client = client as X402AugmentedClient & T;\n  Object.defineProperty(_client, \"listTools\", {\n    value: listTools,\n    writable: false,\n    enumerable: false,\n    configurable: true\n  });\n  Object.defineProperty(_client, \"callTool\", {\n    value: callToolWithPayment,\n    writable: false,\n    enumerable: false,\n    configurable: true\n  });\n\n  return _client;\n}\n"],"mappings":"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"}
+{"version":3,"file":"x402.js","names":[],"sources":["../../../src/mcp/client/x402.ts"],"sourcesContent":["/**\n * X402 MCP Integration (v2)\n *\n * Based on:\n * - Coinbase's x402 (Apache 2.0): https://github.com/coinbase/x402\n * - @ethanniser and his work at https://github.com/ethanniser/x402-mcp\n */\n\nimport type {\n  McpServer,\n  RegisteredTool,\n  ToolCallback\n} from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type {\n  CallToolRequest,\n  CallToolRequestOptions,\n  Client as MCPClient\n} from \"@modelcontextprotocol/client\";\nimport type {\n  CallToolResult as V2CallToolResult,\n  McpServer as V2McpServer,\n  RegisteredTool as V2RegisteredTool,\n  ServerContext as V2ServerContext\n} from \"@modelcontextprotocol/server\";\nimport type {\n  CallToolResult,\n  ToolAnnotations\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport {\n  bindMcpClient,\n  type CallToolSchemaOrOptions,\n  type CompatibleMcpClient,\n  type LegacyCallToolResultSchema\n} from \"./invoker\";\nimport type { z, ZodRawShape } from \"zod\";\n\n// v2 imports from @x402/core\nimport { x402ResourceServer, HTTPFacilitatorClient } from \"@x402/core/server\";\nimport type { FacilitatorConfig, ResourceConfig } from \"@x402/core/server\";\nimport { x402Client } from \"@x402/core/client\";\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  PaymentRequired,\n  Network\n} from \"@x402/core/types\";\n\n// v2 imports from @x402/evm\nimport { registerExactEvmScheme as registerServerEvmScheme } from \"@x402/evm/exact/server\";\nimport { registerExactEvmScheme as registerClientEvmScheme } from \"@x402/evm/exact/client\";\nimport type { ClientEvmSigner } from \"@x402/evm\";\n\n// Re-export commonly used types for consumer convenience\nexport type {\n  PaymentRequirements,\n  PaymentRequired,\n  Network\n} from \"@x402/core/types\";\nexport type { FacilitatorConfig } from \"@x402/core/server\";\nexport type { ClientEvmSigner } from \"@x402/evm\";\n\n/**\n * Map of legacy v1 network names to CAIP-2 identifiers.\n * Allows backward compatibility with v1 config.\n */\nconst LEGACY_NETWORK_MAP: Record<string, string> = {\n  \"base-sepolia\": \"eip155:84532\",\n  base: \"eip155:8453\",\n  ethereum: \"eip155:1\",\n  sepolia: \"eip155:11155111\"\n};\n\n/**\n * Normalize a network identifier to CAIP-2 format.\n * Accepts both legacy v1 names (\"base-sepolia\") and CAIP-2 (\"eip155:84532\").\n */\nexport function normalizeNetwork(network: string): Network {\n  return (LEGACY_NETWORK_MAP[network] ?? network) as Network;\n}\n\n/*\n  ======= SERVER SIDE =======\n*/\n\nexport type X402Config = {\n  /**\n   * Network identifier.\n   * Accepts both legacy names (\"base-sepolia\") and CAIP-2 format (\"eip155:84532\").\n   */\n  network: string;\n  /** Payment recipient address */\n  recipient: `0x${string}`;\n  /** Facilitator configuration. Defaults to https://x402.org/facilitator */\n  facilitator?: FacilitatorConfig;\n  /** @deprecated No longer used in v2. The protocol version is determined automatically. */\n  version?: number;\n};\n\n/**\n * The tool body passed to `paidTool`. On an SDK v1 server it is the v1\n * `ToolCallback`; on an SDK v2 server it receives the v2 `ServerContext`.\n */\nexport type PaidToolCallback<\n  Args extends ZodRawShape,\n  Server extends McpServer | V2McpServer = McpServer\n> = Server extends V2McpServer\n  ? (\n      args: z.infer<z.ZodObject<Args>>,\n      ctx: V2ServerContext\n    ) => V2CallToolResult | Promise<V2CallToolResult>\n  : ToolCallback<Args>;\n\nexport interface X402AugmentedServer<\n  Server extends McpServer | V2McpServer = McpServer\n> {\n  paidTool<Args extends ZodRawShape>(\n    name: string,\n    description: string,\n    priceUSD: number,\n    paramsSchema: Args,\n    annotations: ToolAnnotations,\n    cb: PaidToolCallback<Args, Server>\n  ): Server extends V2McpServer ? V2RegisteredTool : RegisteredTool;\n}\n\ntype RequestMeta = Record<string, unknown>;\ntype HeaderGetter = { get(name: string): string | null };\ntype HeaderRecord = Record<string, string | string[] | undefined>;\n\n/**\n * The parts of a tool handler's second argument that x402 reads. SDK v1\n * passes `{ _meta, requestInfo: { headers } }`, where headers is a plain\n * object (every SDK v1 transport lowercases the keys). SDK v2 passes\n * `{ mcpReq: { _meta }, http: { req } }`, where `req` is the web `Request`.\n */\ntype ToolHandlerContext = {\n  _meta?: RequestMeta;\n  requestInfo?: { headers?: HeaderGetter | HeaderRecord };\n  mcpReq?: { _meta?: RequestMeta };\n  http?: { req?: { headers?: HeaderGetter } };\n};\n\nfunction readHeader(\n  headers: HeaderGetter | HeaderRecord | undefined,\n  name: string\n): string | undefined {\n  if (!headers) return undefined;\n  if (typeof headers.get === \"function\") {\n    return (headers as HeaderGetter).get(name) ?? undefined;\n  }\n  const wanted = name.toLowerCase();\n  for (const [key, value] of Object.entries(headers as HeaderRecord)) {\n    if (key.toLowerCase() !== wanted) continue;\n    const first = Array.isArray(value) ? value[0] : value;\n    if (typeof first === \"string\") return first;\n  }\n  return undefined;\n}\n\n/**\n * Read the x402 payment token from a tool handler context of either SDK\n * generation. Request `_meta` wins over headers, and header names match\n * case-insensitively. `PAYMENT-SIGNATURE` is x402 v2; `X-PAYMENT` is v1.\n */\nfunction readPaymentToken(extra: unknown): unknown {\n  const ctx = (extra ?? {}) as ToolHandlerContext;\n  const meta = ctx.mcpReq?._meta ?? ctx._meta;\n  const headers = ctx.http?.req?.headers ?? ctx.requestInfo?.headers;\n  return (\n    meta?.[\"x402/payment\"] ??\n    readHeader(headers, \"PAYMENT-SIGNATURE\") ??\n    readHeader(headers, \"X-PAYMENT\")\n  );\n}\n\n/**\n * Add `paidTool` to an MCP server. Accepts an SDK v1 `McpServer`\n * (`@modelcontextprotocol/sdk`) or an SDK v2 `McpServer`\n * (`@modelcontextprotocol/server`).\n */\nexport function withX402<T extends V2McpServer>(\n  server: T,\n  cfg: X402Config\n): T & X402AugmentedServer<V2McpServer>;\n// The SDK v1 overload is last so `ReturnType<typeof withX402>` and generic\n// v1 callers resolve to exactly the pre-v2 types.\nexport function withX402<T extends McpServer>(\n  server: T,\n  cfg: X402Config\n): T & X402AugmentedServer;\nexport function withX402(\n  server: McpServer | V2McpServer,\n  cfg: X402Config\n): (McpServer | V2McpServer) & X402AugmentedServer<McpServer | V2McpServer> {\n  const network = normalizeNetwork(cfg.network);\n  const facilitatorConfig: FacilitatorConfig = cfg.facilitator ?? {\n    url: \"https://x402.org/facilitator\"\n  };\n\n  // Create v2 resource server with facilitator client\n  const facilitatorClient = new HTTPFacilitatorClient(facilitatorConfig);\n  const resourceServer = new x402ResourceServer(facilitatorClient);\n  registerServerEvmScheme(resourceServer);\n\n  // Lazy initialization: fetch supported kinds from facilitator on first use\n  let initPromise: Promise<void> | null = null;\n  function ensureInitialized(): Promise<void> {\n    if (!initPromise) {\n      initPromise = resourceServer.initialize().catch((err) => {\n        initPromise = null; // allow retry on failure\n        throw err;\n      });\n    }\n    return initPromise;\n  }\n\n  function paidTool<Args extends ZodRawShape>(\n    name: string,\n    description: string,\n    priceUSD: number,\n    paramsSchema: Args,\n    annotations: ToolAnnotations,\n    toolCb: PaidToolCallback<Args, McpServer | V2McpServer>\n  ) {\n    // Both SDK generations accept a raw Zod shape and call the handler as\n    // (args, ctx), so one registration serves either server. The public\n    // callback type is enforced by X402AugmentedServer; internally the\n    // context is opaque and forwarded to the tool body unchanged.\n    const cb = toolCb as unknown as (\n      args: unknown,\n      extra: unknown\n    ) => CallToolResult | Promise<CallToolResult>;\n    return (server as McpServer).registerTool(\n      name,\n      {\n        description,\n        inputSchema: paramsSchema,\n        annotations,\n        _meta: {\n          \"agents-x402/paymentRequired\": true,\n          \"agents-x402/priceUSD\": priceUSD\n        }\n      },\n      (async (args, extra) => {\n        await ensureInitialized();\n\n        // Build v2 payment requirements for this tool call\n        const resourceConfig: ResourceConfig = {\n          scheme: \"exact\",\n          payTo: cfg.recipient,\n          price: priceUSD,\n          network,\n          maxTimeoutSeconds: 300\n        };\n\n        let requirements: PaymentRequirements[];\n        try {\n          requirements =\n            await resourceServer.buildPaymentRequirements(resourceConfig);\n        } catch {\n          const payload = { x402Version: 2, error: \"PRICE_COMPUTE_FAILED\" };\n          return {\n            isError: true,\n            _meta: { \"x402/error\": payload },\n            content: [{ type: \"text\", text: JSON.stringify(payload) }]\n          } as const;\n        }\n\n        const resourceInfo = {\n          url: `x402://${name}`,\n          description,\n          mimeType: \"application/json\"\n        };\n\n        const token = readPaymentToken(extra);\n\n        const paymentRequired = (\n          reason = \"PAYMENT_REQUIRED\",\n          extraFields: Record<string, unknown> = {}\n        ) => {\n          const payload = {\n            x402Version: 2,\n            error: reason,\n            resource: resourceInfo,\n            accepts: requirements,\n            ...extraFields\n          };\n          return {\n            isError: true,\n            _meta: { \"x402/error\": payload },\n            content: [{ type: \"text\", text: JSON.stringify(payload) }]\n          } as const;\n        };\n\n        if (!token || typeof token !== \"string\") return paymentRequired();\n\n        // Decode the payment payload (base64-encoded JSON)\n        let paymentPayload: PaymentPayload;\n        try {\n          paymentPayload = JSON.parse(atob(token));\n        } catch {\n          return paymentRequired(\"INVALID_PAYMENT\");\n        }\n\n        // Find matching requirements for this payment\n        const matchingReq = resourceServer.findMatchingRequirements(\n          requirements,\n          paymentPayload\n        );\n        if (!matchingReq) {\n          return paymentRequired(\"INVALID_PAYMENT\");\n        }\n\n        // Verify payment with facilitator\n        try {\n          const vr = await resourceServer.verifyPayment(\n            paymentPayload,\n            matchingReq\n          );\n          if (!vr.isValid) {\n            return paymentRequired(vr.invalidReason ?? \"INVALID_PAYMENT\", {\n              payer: vr.payer\n            });\n          }\n        } catch {\n          return paymentRequired(\"INVALID_PAYMENT\");\n        }\n\n        // Execute the tool callback\n        let result: CallToolResult;\n        let failed = false;\n        try {\n          result = await cb(args, extra);\n          if (\n            result &&\n            typeof result === \"object\" &&\n            \"isError\" in result &&\n            result.isError\n          ) {\n            failed = true;\n          }\n        } catch (e) {\n          failed = true;\n          result = {\n            isError: true,\n            content: [\n              { type: \"text\", text: `Tool execution failed: ${String(e)}` }\n            ]\n          };\n        }\n\n        // Settle payment only on success\n        if (!failed) {\n          try {\n            const s = await resourceServer.settlePayment(\n              paymentPayload,\n              matchingReq\n            );\n            if (s.success) {\n              result._meta ??= {};\n              result._meta[\"x402/payment-response\"] = {\n                success: true,\n                transaction: s.transaction,\n                network: s.network,\n                payer: s.payer\n              };\n            } else {\n              return paymentRequired(s.errorReason ?? \"SETTLEMENT_FAILED\");\n            }\n          } catch {\n            return paymentRequired(\"SETTLEMENT_FAILED\");\n          }\n        }\n\n        return result;\n      }) as ToolCallback<Args>\n    );\n  }\n\n  Object.defineProperty(server, \"paidTool\", {\n    value: paidTool,\n    writable: false,\n    enumerable: false,\n    configurable: true\n  });\n\n  // Tell TS the object now also has the paidTool method\n  return server as (McpServer | V2McpServer) &\n    X402AugmentedServer<McpServer | V2McpServer>;\n}\n\n/*\n  ======= CLIENT SIDE =======\n*/\n\nexport interface X402AugmentedClient {\n  callTool(\n    x402ConfirmationCallback:\n      | ((payment: PaymentRequirements[]) => Promise<boolean>)\n      | null,\n    params: CallToolRequest[\"params\"],\n    options?: CallToolRequestOptions\n  ): Promise<CallToolResult>;\n  /**\n   * @deprecated Prefer the request-options overload. Explicit legacy result\n   * schemas remain honored through the SDK v2 request funnel.\n   */\n  callTool(\n    x402ConfirmationCallback:\n      | ((payment: PaymentRequirements[]) => Promise<boolean>)\n      | null,\n    params: CallToolRequest[\"params\"],\n    resultSchema: LegacyCallToolResultSchema,\n    options?: CallToolRequestOptions\n  ): Promise<CallToolResult>;\n}\n\nexport type X402ClientConfig = {\n  /**\n   * EVM account/signer for signing payment authorizations.\n   * Use `privateKeyToAccount()` from viem/accounts to create one.\n   */\n  account: ClientEvmSigner;\n  /**\n   * Preferred network identifier (optional).\n   * Accepts both legacy names (\"base-sepolia\") and CAIP-2 format (\"eip155:84532\").\n   * When set, the client prefers payment requirements matching this network.\n   * If omitted, the client automatically selects from available requirements.\n   */\n  network?: string;\n  /** Maximum payment value in atomic units (default: 0.10 USDC = 100000) */\n  maxPaymentValue?: bigint;\n  /** @deprecated No longer used in v2. The protocol version is determined automatically. */\n  version?: number;\n  /** Confirmation callback for payment approval */\n  confirmationCallback?: (payment: PaymentRequirements[]) => Promise<boolean>;\n};\n\nclass PaymentCapError extends Error {}\n// Thrown when the selected requirement cannot be cap-checked; the caller\n// returns the server's original 402 result, as before the hook existed.\nclass PaymentPassthroughError extends Error {}\n\nexport function withX402Client<T extends CompatibleMcpClient>(\n  client: T,\n  x402Config: X402ClientConfig\n): X402AugmentedClient & T {\n  const invoker = bindMcpClient(client);\n  const { account } = x402Config;\n\n  const maxPaymentValue = x402Config.maxPaymentValue ?? BigInt(100_000); // 0.10 USDC\n\n  // Create v2 x402 payment client with EVM scheme support\n  const paymentClient = new x402Client();\n  registerClientEvmScheme(paymentClient, { signer: account });\n\n  // Payment requests whose selection reached the hook below. x402 selects a\n  // requirement before it runs any hook, so a request that failed without\n  // getting here offered nothing this client can sign.\n  const selected = new WeakSet<PaymentRequired>();\n\n  // Selection applies scheme support and network preference before this hook.\n  // Enforce the cap on the requirement that will actually be signed. We throw\n  // rather than return `{ abort: true }` because @x402/core rewraps an abort in\n  // a plain Error, which would lose the typed errors the catch below relies on.\n  paymentClient.onBeforePaymentCreation(\n    async ({ paymentRequired, selectedRequirements }) => {\n      selected.add(paymentRequired);\n      const { scheme, amount } = selectedRequirements;\n      if (scheme !== \"exact\") throw new PaymentPassthroughError();\n      let value: bigint;\n      try {\n        value = BigInt(amount);\n      } catch {\n        throw new PaymentPassthroughError(); // malformed amount\n      }\n      if (value < 0n) throw new PaymentPassthroughError();\n      if (value > maxPaymentValue) {\n        throw new PaymentCapError(\n          `Payment exceeds client cap: ${value} > ${maxPaymentValue}`\n        );\n      }\n    }\n  );\n\n  // If a preferred network is specified, register a policy to prefer it\n  if (x402Config.network) {\n    const preferredNetwork = normalizeNetwork(x402Config.network);\n    paymentClient.registerPolicy((_version, reqs) => {\n      const matching = reqs.filter((r) => r.network === preferredNetwork);\n      return matching.length > 0 ? matching : reqs;\n    });\n  }\n\n  const listTools = async (\n    params?: Parameters<MCPClient[\"listTools\"]>[0],\n    options?: Parameters<MCPClient[\"listTools\"]>[1]\n  ) => {\n    const toolsRes = await invoker.listTools(params, options);\n    return {\n      ...toolsRes,\n      tools: toolsRes.tools.map((tool) => {\n        let description = tool.description;\n        // Check _meta for payment information (agents-x402/ is our extension for pre-advertising prices)\n        if (tool._meta?.[\"agents-x402/paymentRequired\"]) {\n          const cost = tool._meta?.[\"agents-x402/priceUSD\"]\n            ? `$${tool._meta?.[\"agents-x402/priceUSD\"]}`\n            : \"an unknown amount\";\n          description += ` (This is a paid tool, you will be charged ${cost} for its execution)`;\n        }\n        return {\n          ...tool,\n          description\n        };\n      })\n    };\n  };\n\n  const callToolWithPayment = async (\n    x402ConfirmationCallback:\n      | ((payment: PaymentRequirements[]) => Promise<boolean>)\n      | null,\n    params: CallToolRequest[\"params\"],\n    schemaOrOptions?: CallToolSchemaOrOptions,\n    options?: CallToolRequestOptions\n  ): ReturnType<MCPClient[\"callTool\"]> => {\n    const invoke = (callParams: CallToolRequest[\"params\"]) =>\n      invoker.callTool(callParams, schemaOrOptions, options);\n    const res = await invoke(params);\n\n    // Check for x402 payment required error in response metadata\n    const maybeX402Error = res._meta?.[\"x402/error\"] as\n      | (PaymentRequired & Record<string, unknown>)\n      | undefined;\n\n    if (\n      res.isError &&\n      maybeX402Error &&\n      maybeX402Error.accepts &&\n      Array.isArray(maybeX402Error.accepts) &&\n      maybeX402Error.accepts.length > 0\n    ) {\n      // Snapshot the requirements: what is cap-checked and signed below is\n      // this copy, not the server's result object or anything aliasing it.\n      const accepts = structuredClone(\n        maybeX402Error.accepts\n      ) as PaymentRequirements[];\n      const confirmationCallback =\n        x402ConfirmationCallback ?? x402Config.confirmationCallback;\n\n      // Use the confirmation callback if provided. It receives deep copies\n      // so a retained reference cannot alter what is cap-checked and signed.\n      if (\n        confirmationCallback &&\n        !(await confirmationCallback(\n          accepts.map((req) => structuredClone(req))\n        ))\n      ) {\n        return {\n          isError: true,\n          content: [{ type: \"text\", text: \"User declined payment\" }]\n        };\n      }\n\n      // Reconstruct the PaymentRequired response for the v2 x402 client\n      const paymentRequiredResponse: PaymentRequired = {\n        x402Version: (maybeX402Error.x402Version as number) ?? 2,\n        resource: (maybeX402Error.resource as PaymentRequired[\"resource\"]) ?? {\n          url: \"\",\n          description: \"\",\n          mimeType: \"application/json\"\n        },\n        accepts,\n        extensions: maybeX402Error.extensions as\n          | Record<string, unknown>\n          | undefined\n      };\n\n      // Create the payment payload using the v2 x402 client\n      let paymentPayload: PaymentPayload;\n      try {\n        paymentPayload = await paymentClient.createPaymentPayload(\n          paymentRequiredResponse\n        );\n      } catch (error) {\n        // Nothing this client can sign, or a selection it cannot cap-check:\n        // return the server's 402 with its payment options, as before.\n        if (\n          error instanceof PaymentPassthroughError ||\n          !selected.has(paymentRequiredResponse)\n        ) {\n          return res;\n        }\n        return {\n          isError: true,\n          content: [\n            {\n              type: \"text\",\n              text:\n                error instanceof PaymentCapError\n                  ? error.message\n                  : \"Failed to create payment payload\"\n            }\n          ]\n        };\n      }\n\n      // Encode the payment payload as a base64 JSON token for MCP transport\n      const token = btoa(JSON.stringify(paymentPayload));\n\n      // Retry the tool call with the payment token\n      return invoke({\n        ...params,\n        _meta: {\n          ...params._meta,\n          \"x402/payment\": token\n        }\n      });\n    }\n\n    return res;\n  };\n\n  const _client = client as X402AugmentedClient & T;\n  Object.defineProperty(_client, \"listTools\", {\n    value: listTools,\n    writable: false,\n    enumerable: false,\n    configurable: true\n  });\n  Object.defineProperty(_client, \"callTool\", {\n    value: callToolWithPayment,\n    writable: false,\n    enumerable: false,\n    configurable: true\n  });\n\n  return _client;\n}\n"],"mappings":"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"}

package/dist/mcp/index.d.ts

@@ -33,7 +33,7 @@ import {
   vn as SSEEdgeClientTransport,
   yn as StreamableHTTPEdgeClientTransport,
   zt as MCPClientOAuthResult
-} from "../agent-routing-0DR0Tk2v.js";
+} from "../agent-routing-QDcchcQP.js";
 import {
   a as McpAuthContext,
   n as StatelessMcpHandler,

package/dist/mcp/index.js

@@ -1,7 +1,7 @@
 import { getAgentByName } from "../agent-routing.js";
 import "../types.js";
-import { i as getCurrentAgent, t as Agent } from "../src-BZeu-SCD.js";
-import { c as RPCServerTransport, i as normalizeServerId, l as RPC_DO_PREFIX, n as MCP_SERVER_ID_MAX_LENGTH, s as RPCClientTransport, u as isDurableObjectNamespace } from "../client-fyQrLGkD.js";
+import { i as getCurrentAgent, t as Agent } from "../src-CQxJFv4l.js";
+import { c as RPCServerTransport, i as normalizeServerId, l as RPC_DO_PREFIX, n as MCP_SERVER_ID_MAX_LENGTH, s as RPCClientTransport, u as isDurableObjectNamespace } from "../client-BnYbNT3z.js";
 import { n as getMcpAuthContext, r as runWithAuthContext, t as createStatelessMcpHandler } from "../handler-stateless-VvrWSAVA.js";
 import { SSEClientTransport, StreamableHTTPClientTransport } from "@modelcontextprotocol/client";
 import { ElicitRequestSchema, InitializeRequestSchema, JSONRPCMessageSchema, SUPPORTED_PROTOCOL_VERSIONS, isInitializeRequest, isJSONRPCErrorResponse, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResultResponse } from "@modelcontextprotocol/sdk/types.js";

package/dist/models/ai-sdk/index.d.ts

@@ -1,21 +1,23 @@
 import {
-  _ as KnownSpeechModelId,
+  c as CloudflareRerankingModelId,
+  d as KnownImageModelId,
+  f as KnownSpeechModelId,
+  i as ProviderGatewaySettings,
+  l as CloudflareSpeechModelId,
+  n as GatewayOptions,
+  o as CloudflareEmbeddingModelId,
+  p as WorkersAIModelId,
+  r as ModelOptions$1,
+  s as CloudflareImageModelId,
+  t as AISettings,
+  u as CloudflareTranscriptionModelId
+} from "../../settings-NgGwF7Qt.js";
+import {
   a as CloudflareAIError$1,
-  c as GatewayOptions,
-  d as CloudflareEmbeddingModelId,
-  f as CloudflareImageModelId,
-  g as KnownImageModelId,
-  h as CloudflareTranscriptionModelId,
   i as CloudflareAIAttempt,
-  l as ModelOptions$1,
-  m as CloudflareSpeechModelId,
   o as CloudflareAIErrorCode,
-  p as CloudflareRerankingModelId,
-  s as AISettings,
-  t as Transport,
-  u as ProviderGatewaySettings,
-  v as WorkersAIModelId
-} from "../../transport-PfFnt-Ld.js";
+  t as Transport
+} from "../../transport-k2mFrtL8.js";
 import {
   APICallError,
   EmbeddingModelV4,