agentcash 0.3.7 → 0.4.1

package/dist/esm/{chunk-ED4QVIZH.js → chunk-2CFQ7ILC.js}

@@ -1,7 +1,7 @@
 import {
   getWalletInfo,
   submitErrorReport
-} from "./chunk-RP5AGYAT.js";
+} from "./chunk-SHAJ42CH.js";
 
 // src/shared/operations/index.ts
 async function getWalletInfo2(surface, address, flags) {
@@ -19,4 +19,4 @@ export {
   getWalletInfo2 as getWalletInfo,
   submitErrorReport2 as submitErrorReport
 };
-//# sourceMappingURL=chunk-ED4QVIZH.js.map
+//# sourceMappingURL=chunk-2CFQ7ILC.js.map

package/dist/esm/chunk-2CFQ7ILC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/operations/index.ts"],"sourcesContent":["/**\n * Published entry point: `agentcash/operations`\n *\n * All exports return plain types (no Result<> from neverthrow) to avoid\n * leaking @agentcash/neverthrow/types into published .d.ts files.\n */\n\nimport type { Address } from 'viem';\nimport type { GlobalFlags } from '@/types';\n\n// ── Discover ──\n// Already returns plain type (DiscoveryResult | null)\nexport {\n  discoverResources,\n  type DiscoveryResult,\n  type OpenApiInfo,\n} from './discover';\n\n// ── Check Endpoint ──\nexport {\n  checkEndpoint,\n  type CheckEndpointOptions,\n  type CheckEndpointResult,\n  type ProbeMethodResult,\n  type PaymentOption,\n  type MppPaymentOption,\n  type X402PaymentOption,\n  type SupportedMethod,\n  SUPPORTED_METHODS,\n} from './check-endpoint';\n\n// ── Wallet Info ──\nimport { getWalletInfo as _getWalletInfo } from './wallet-info';\nexport type { WalletInfoResult } from './wallet-info';\n\nexport async function getWalletInfo(\n  surface: string,\n  address: Address,\n  flags: GlobalFlags\n) {\n  const result = await _getWalletInfo(surface, address, flags);\n  if (result.isErr()) throw new Error(result.error.message);\n  return result.value;\n}\n\n// ── Report Error ──\nimport { submitErrorReport as _submitErrorReport } from './report-error';\nexport type { ErrorReportResult } from './report-error';\n\nexport async function submitErrorReport(\n  surface: string,\n  input: {\n    tool: string;\n    summary: string;\n    errorMessage: string;\n    resource?: string;\n    stack?: string;\n    fullReport?: string;\n  },\n  address: Address,\n  dev: boolean\n) {\n  const result = await _submitErrorReport(surface, input, address, dev);\n  if (result.isErr()) throw new Error(result.error.message);\n  return result.value;\n}\n"],"mappings":";;;;;;AAmCA,eAAsBA,eACpB,SACA,SACA,OACA;AACA,QAAM,SAAS,MAAM,cAAe,SAAS,SAAS,KAAK;AAC3D,MAAI,OAAO,MAAM,EAAG,OAAM,IAAI,MAAM,OAAO,MAAM,OAAO;AACxD,SAAO,OAAO;AAChB;AAMA,eAAsBC,mBACpB,SACA,OAQA,SACA,KACA;AACA,QAAM,SAAS,MAAM,kBAAmB,SAAS,OAAO,SAAS,GAAG;AACpE,MAAI,OAAO,MAAM,EAAG,OAAM,IAAI,MAAM,OAAO,MAAM,OAAO;AACxD,SAAO,OAAO;AAChB;","names":["getWalletInfo","submitErrorReport"]}

package/dist/esm/{chunk-7E4JDDBW.js → chunk-7DEM3OEU.js}

@@ -1,26 +1,24 @@
 import {
   detectPaymentProtocols,
   getTempoBalance,
-  mppErr,
-  mppOk,
-  safeCreateMppCredential,
   safeCreatePaymentPayload,
-  safeGetMppChallenge,
-  safeGetMppReceipt,
   safeGetPaymentRequired,
   safeGetPaymentSettlement,
   tokenStringToNumber,
   x402Err,
   x402Ok
-} from "./chunk-RP5AGYAT.js";
+} from "./chunk-SHAJ42CH.js";
 import {
+  err,
   fetchErr,
   fetchOk,
   getBalance,
   log,
+  ok,
   resultFromPromise,
+  resultFromThrowable,
   safeFetch
-} from "./chunk-PJFATGPH.js";
+} from "./chunk-EO4BIJAO.js";
 
 // src/server/tools/lib/request.ts
 import z from "zod";
@@ -28,7 +26,8 @@ var requestSchema = z.object({
   url: z.url().describe("The endpoint URL"),
   method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).optional().describe("HTTP method. Defaults to GET for fetch operations."),
   body: z.unknown().optional().describe("Request body for POST/PUT/PATCH methods"),
-  headers: z.record(z.string(), z.string()).optional().describe("Additional headers to include").default({})
+  headers: z.record(z.string(), z.string()).optional().describe("Additional headers to include").default({}),
+  timeout: z.number().int().positive().optional().describe("Request timeout in milliseconds")
 });
 var buildRequest = ({
   input,
@@ -48,14 +47,52 @@ var buildRequest = ({
   });
 };
 
+// src/shared/neverthrow/mpp/index.ts
+import { Challenge, Receipt } from "mppx";
+var errorType = "mpp";
+var mppOk = (value) => ok(value);
+var mppErr = (surface, error) => err(errorType, surface, error);
+var mppResultFromPromise = (surface, promise, error) => resultFromPromise(errorType, surface, promise, error);
+var mppResultFromThrowable = (surface, fn, error) => resultFromThrowable(errorType, surface, fn, error);
+var safeGetMppChallenge = (surface, response) => {
+  return mppResultFromThrowable(
+    surface,
+    () => Challenge.fromResponse(response),
+    (error) => ({
+      cause: "parse_mpp_challenge",
+      message: error instanceof Error ? error.message : "Failed to parse MPP challenge from response"
+    })
+  );
+};
+var safeCreateMppCredential = (surface, mppxClient, response) => {
+  return mppResultFromPromise(
+    surface,
+    mppxClient.createCredential(response),
+    (error) => ({
+      cause: "create_mpp_credential",
+      message: error instanceof Error ? error.message : "Failed to create MPP credential"
+    })
+  );
+};
+var safeGetMppReceipt = (surface, response) => {
+  return mppResultFromThrowable(
+    surface,
+    () => Receipt.fromResponse(response),
+    (error) => ({
+      cause: "parse_mpp_receipt",
+      message: error instanceof Error ? error.message : "Failed to parse MPP receipt from response"
+    })
+  );
+};
+
 // src/shared/operations/fetch-with-payment.ts
 import { formatUnits } from "viem";
 function createFetchWithPayment(options) {
-  const { surface, clients, paymentMethod, beforePayment } = options;
+  const { surface, clients, paymentMethod, beforePayment, timeout } = options;
   return async (request) => {
     const clonedRequest = request.clone();
     const fallbackRequest = request.clone();
-    const probeResult = await safeFetch(surface, request);
+    const probeResult = await safeFetch(surface, request, timeout);
     if (probeResult.isErr()) {
       return fetchErr(surface, probeResult.error);
     }
@@ -74,7 +111,8 @@ function createFetchWithPayment(options) {
         response,
         clonedRequest,
         clients.x402,
-        beforePayment
+        beforePayment,
+        timeout
       );
     }
     const available = detectPaymentProtocols(response);
@@ -90,7 +128,8 @@ function createFetchWithPayment(options) {
       response,
       clonedRequest,
       clients.x402,
-      beforePayment
+      beforePayment,
+      timeout
     );
     if (result.isErr() && fallback) {
       return fallback === "mpp" ? handleMppPayment(surface, response, fallbackRequest, options) : handleX402Payment(
@@ -98,7 +137,8 @@ function createFetchWithPayment(options) {
         response,
         fallbackRequest,
         clients.x402,
-        beforePayment
+        beforePayment,
+        timeout
       );
     }
     return result;
@@ -150,7 +190,7 @@ async function pickByBalance(surface, response, options) {
   log.info(`Protocol selection \u2014 x402: $${x402Balance}, mpp: $${mppBalance}`);
   return x402Balance >= mppBalance ? "x402" : "mpp";
 }
-async function handleX402Payment(surface, response, clonedRequest, client, beforePayment) {
+async function handleX402Payment(surface, response, clonedRequest, client, beforePayment, timeout) {
   const paymentRequiredResult = await safeGetPaymentRequired(
     surface,
     client,
@@ -206,34 +246,36 @@ async function handleX402Payment(surface, response, clonedRequest, client, befor
     "Access-Control-Expose-Headers",
     "PAYMENT-RESPONSE,X-PAYMENT-RESPONSE"
   );
-  return await safeFetch(surface, clonedRequest).andThen((paidResponse) => {
-    const settlementResult = safeGetPaymentSettlement(
-      surface,
-      client,
-      paidResponse
-    );
-    return x402Ok({
-      response: paidResponse,
-      paymentInfo: {
-        protocol: "x402",
-        price: tokenStringToNumber(
-          paymentPayload.accepted.amount
-        ).toLocaleString("en-US", {
-          style: "currency",
-          currency: "USD"
-        }),
-        ...settlementResult.isOk() ? {
-          payment: {
-            success: settlementResult.value.success,
-            transactionHash: settlementResult.value.transaction
-          }
-        } : {}
-      }
-    });
-  });
+  return await safeFetch(surface, clonedRequest, timeout).andThen(
+    (paidResponse) => {
+      const settlementResult = safeGetPaymentSettlement(
+        surface,
+        client,
+        paidResponse
+      );
+      return x402Ok({
+        response: paidResponse,
+        paymentInfo: {
+          protocol: "x402",
+          price: tokenStringToNumber(
+            paymentPayload.accepted.amount
+          ).toLocaleString("en-US", {
+            style: "currency",
+            currency: "USD"
+          }),
+          ...settlementResult.isOk() ? {
+            payment: {
+              success: settlementResult.value.success,
+              transactionHash: settlementResult.value.transaction
+            }
+          } : {}
+        }
+      });
+    }
+  );
 }
 async function handleMppPayment(surface, response, clonedRequest, options) {
-  const { clients, beforePayment } = options;
+  const { clients, beforePayment, timeout } = options;
   const mppxClient = clients.mpp;
   if (clonedRequest.headers.has("Authorization")) {
     return mppErr(surface, {
@@ -279,31 +321,37 @@ async function handleMppPayment(surface, response, clonedRequest, options) {
   }
   const credential = credentialResult.value;
   clonedRequest.headers.set("Authorization", credential);
-  return await safeFetch(surface, clonedRequest).andThen((paidResponse) => {
-    const receiptResult = safeGetMppReceipt(surface, paidResponse);
-    const priceDisplay = amount ? Number(formatUnits(BigInt(amount), decimals)).toLocaleString("en-US", {
-      style: "currency",
-      currency: "USD"
-    }) : void 0;
-    return mppOk({
-      response: paidResponse,
-      paymentInfo: {
-        protocol: "mpp",
-        ...priceDisplay ? { price: priceDisplay } : {},
-        ...receiptResult.isOk() ? {
-          payment: {
-            success: true,
-            transactionHash: receiptResult.value.reference
-          }
-        } : {}
-      }
-    });
-  });
+  return await safeFetch(surface, clonedRequest, timeout).andThen(
+    (paidResponse) => {
+      const receiptResult = safeGetMppReceipt(surface, paidResponse);
+      const priceDisplay = amount ? Number(formatUnits(BigInt(amount), decimals)).toLocaleString(
+        "en-US",
+        {
+          style: "currency",
+          currency: "USD"
+        }
+      ) : void 0;
+      return mppOk({
+        response: paidResponse,
+        paymentInfo: {
+          protocol: "mpp",
+          ...priceDisplay ? { price: priceDisplay } : {},
+          ...receiptResult.isOk() ? {
+            payment: {
+              success: true,
+              transactionHash: receiptResult.value.reference
+            }
+          } : {}
+        }
+      });
+    }
+  );
 }
 
 export {
   requestSchema,
   buildRequest,
+  safeGetMppChallenge,
   createFetchWithPayment
 };
-//# sourceMappingURL=chunk-7E4JDDBW.js.map
+//# sourceMappingURL=chunk-7DEM3OEU.js.map

package/dist/esm/chunk-7DEM3OEU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/tools/lib/request.ts","../../src/shared/neverthrow/mpp/index.ts","../../src/shared/operations/fetch-with-payment.ts"],"sourcesContent":["import z from 'zod';\n\nimport type { Address } from 'viem';\n\nexport const requestSchema = z.object({\n  url: z.url().describe('The endpoint URL'),\n  method: z\n    .enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH'])\n    .optional()\n    .describe('HTTP method. Defaults to GET for fetch operations.'),\n  body: z\n    .unknown()\n    .optional()\n    .describe('Request body for POST/PUT/PATCH methods'),\n  headers: z\n    .record(z.string(), z.string())\n    .optional()\n    .describe('Additional headers to include')\n    .default({}),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe('Request timeout in milliseconds'),\n});\n\ninterface BuildRequestProps {\n  input: z.infer<typeof requestSchema>;\n  address?: Address;\n  sessionId?: string;\n  provider?: string;\n}\n\nexport const buildRequest = ({\n  input,\n  address,\n  sessionId,\n  provider,\n}: BuildRequestProps) => {\n  return new Request(input.url, {\n    method: input.method ?? 'GET',\n    body: input.body\n      ? typeof input.body === 'string'\n        ? input.body\n        : JSON.stringify(input.body)\n      : undefined,\n    headers: {\n      ...(input.body ? { 'Content-Type': 'application/json' } : {}),\n      ...input.headers,\n      ...(address\n        ? { 'X-Wallet-Address': address, 'X-Client-ID': provider }\n        : {}),\n      ...(sessionId ? { 'X-Session-ID': sessionId } : {}),\n    },\n  });\n};\n","import { Challenge, Receipt } from 'mppx';\nimport {\n  err,\n  ok,\n  resultFromPromise,\n  resultFromThrowable,\n} from '@agentcash/neverthrow';\n\nimport type { BaseMppError } from './types';\nconst errorType = 'mpp';\n\nexport const mppOk = <T>(value: T) => ok(value);\nexport const mppErr = (surface: string, error: BaseMppError) =>\n  err(errorType, surface, error);\n\nconst mppResultFromPromise = <T>(\n  surface: string,\n  promise: Promise<T>,\n  error: (e: unknown) => BaseMppError\n) => resultFromPromise(errorType, surface, promise, error);\n\nconst mppResultFromThrowable = <T>(\n  surface: string,\n  fn: () => T,\n  error: (e: unknown) => BaseMppError\n) => resultFromThrowable(errorType, surface, fn, error);\n\nexport const safeGetMppChallenge = (surface: string, response: Response) => {\n  return mppResultFromThrowable(\n    surface,\n    () => Challenge.fromResponse(response),\n    error => ({\n      cause: 'parse_mpp_challenge',\n      message:\n        error instanceof Error\n          ? error.message\n          : 'Failed to parse MPP challenge from response',\n    })\n  );\n};\n\nexport const safeCreateMppCredential = (\n  surface: string,\n  mppxClient: { createCredential: (response: Response) => Promise<string> },\n  response: Response\n) => {\n  return mppResultFromPromise(\n    surface,\n    mppxClient.createCredential(response),\n    error => ({\n      cause: 'create_mpp_credential',\n      message:\n        error instanceof Error\n          ? error.message\n          : 'Failed to create MPP credential',\n    })\n  );\n};\n\nexport const safeGetMppReceipt = (surface: string, response: Response) => {\n  return mppResultFromThrowable(\n    surface,\n    () => Receipt.fromResponse(response),\n    error => ({\n      cause: 'parse_mpp_receipt',\n      message:\n        error instanceof Error\n          ? error.message\n          : 'Failed to parse MPP receipt from response',\n    })\n  );\n};\n","import { formatUnits } from 'viem';\n\nimport type { x402HTTPClient } from '@x402/core/client';\nimport type { Address } from 'viem';\nimport type { GlobalFlags } from '@/types';\n\nimport { resultFromPromise } from '@agentcash/neverthrow';\n\nimport { fetchErr, fetchOk, safeFetch } from '@/shared/neverthrow/fetch';\nimport {\n  safeCreatePaymentPayload,\n  safeGetPaymentRequired,\n  safeGetPaymentSettlement,\n  x402Err,\n  x402Ok,\n} from '@/shared/neverthrow/x402';\nimport {\n  safeGetMppChallenge,\n  safeCreateMppCredential,\n  safeGetMppReceipt,\n  mppErr,\n  mppOk,\n} from '@/shared/neverthrow/mpp';\n\nimport { log } from '@/shared/log';\nimport { detectPaymentProtocols } from '@/shared/protocol';\nimport { tokenStringToNumber } from '@/shared/token';\nimport { getBalance } from '@/shared/balance';\nimport { getTempoBalance } from '@/shared/tempo-balance';\n\n/**\n * Hook called before a payment is executed.\n * Throw to abort. Return to proceed.\n * Matches existing checkBalance/checkTempoBalance throw-to-abort behavior.\n */\nexport type BeforePaymentHook = (ctx: {\n  protocol: 'x402' | 'mpp';\n  amount: number;\n  currency: string;\n  network: string;\n}) => Promise<void>;\n\nexport interface PaymentClients {\n  x402: x402HTTPClient;\n  mpp: { createCredential: (response: Response) => Promise<string> };\n}\n\nexport interface PaymentInfo {\n  protocol: 'x402' | 'mpp';\n  price?: string;\n  payment?: {\n    success: boolean;\n    transactionHash?: string;\n  };\n}\n\nexport interface FetchWithPaymentResult {\n  response: Response;\n  paymentInfo: PaymentInfo | null;\n}\n\nexport interface FetchWithPaymentOptions {\n  surface: string;\n  clients: PaymentClients;\n  paymentMethod: 'x402' | 'mpp' | 'auto';\n  account: { address: Address };\n  flags: GlobalFlags;\n  beforePayment?: BeforePaymentHook;\n  timeout?: number;\n}\n\n/**\n * Create a fetch function with automatic dual-protocol payment handling.\n *\n * 1. Makes initial request\n * 2. If 402 response, detects protocol(s)\n * 3. Calls beforePayment hook (for balance checks)\n * 4. Creates payment credential/payload\n * 5. Retries request with payment headers\n */\nexport function createFetchWithPayment(options: FetchWithPaymentOptions) {\n  const { surface, clients, paymentMethod, beforePayment, timeout } = options;\n\n  return async (request: Request) => {\n    const clonedRequest = request.clone();\n    const fallbackRequest = request.clone();\n\n    const probeResult = await safeFetch(surface, request, timeout);\n\n    if (probeResult.isErr()) {\n      return fetchErr(surface, probeResult.error);\n    }\n\n    // Not a 402 response — return as-is\n    if (probeResult.value.status !== 402) {\n      return probeResult.andThen(response =>\n        fetchOk<FetchWithPaymentResult>({ response, paymentInfo: null })\n      );\n    }\n\n    const response = probeResult.value;\n\n    // User explicitly chose a protocol — use that, no fallback\n    if (paymentMethod !== 'auto') {\n      if (paymentMethod === 'mpp') {\n        return handleMppPayment(surface, response, clonedRequest, options);\n      }\n      return handleX402Payment(\n        surface,\n        response,\n        clonedRequest,\n        clients.x402,\n        beforePayment,\n        timeout\n      );\n    }\n\n    // Auto: detect available protocols, pick by higher balance\n    const available = detectPaymentProtocols(response);\n\n    let preferred: 'x402' | 'mpp';\n\n    if (available.length === 1) {\n      preferred = available[0]!;\n    } else {\n      // Both protocols available — pick by balance\n      preferred = await pickByBalance(surface, response, options);\n    }\n\n    const fallback =\n      available.length > 1 ? (preferred === 'mpp' ? 'x402' : 'mpp') : null;\n\n    const result =\n      preferred === 'mpp'\n        ? await handleMppPayment(surface, response, clonedRequest, options)\n        : await handleX402Payment(\n            surface,\n            response,\n            clonedRequest,\n            clients.x402,\n            beforePayment,\n            timeout\n          );\n\n    if (result.isErr() && fallback) {\n      // Preferred failed — try fallback with a fresh request clone\n      return fallback === 'mpp'\n        ? handleMppPayment(surface, response, fallbackRequest, options)\n        : handleX402Payment(\n            surface,\n            response,\n            fallbackRequest,\n            clients.x402,\n            beforePayment,\n            timeout\n          );\n    }\n\n    return result;\n  };\n}\n\n/**\n * Pick the preferred protocol by comparing wallet balances.\n * Falls back to 'mpp' if both balances fail to fetch.\n */\nasync function pickByBalance(\n  surface: string,\n  response: Response,\n  options: FetchWithPaymentOptions\n): Promise<'x402' | 'mpp'> {\n  const { account, flags } = options;\n\n  // Get x402 (USDC on Base) balance\n  const x402BalanceResult = await resultFromPromise(\n    'balance',\n    surface,\n    getBalance({\n      address: account.address,\n      flags,\n      surface,\n    }).then(r => (r.isOk() ? r.value.balance : 0)),\n    () => ({\n      cause: 'x402_balance' as const,\n      message: 'Failed to get x402 balance',\n    })\n  );\n\n  if (x402BalanceResult.isErr()) {\n    log.debug('Balance comparison failed, defaulting to mpp');\n    return 'mpp';\n  }\n\n  const x402Balance = x402BalanceResult.value;\n\n  // Get MPP (Tempo) balance — need token address from the challenge\n  let mppBalance = 0;\n  const challengeResult = safeGetMppChallenge(surface, response);\n  if (challengeResult.isOk()) {\n    const currency = challengeResult.value.request.currency as\n      | string\n      | undefined;\n    const decimals =\n      (challengeResult.value.request.decimals as number | undefined) ?? 6;\n    if (currency) {\n      const tempoResult = await resultFromPromise(\n        'tempo',\n        surface,\n        getTempoBalance({\n          address: account.address,\n          tokenAddress: currency as Address,\n        }),\n        () => ({\n          cause: 'tempo_balance' as const,\n          message: 'Tempo balance check failed',\n        })\n      );\n      if (tempoResult.isOk()) {\n        mppBalance = Number(formatUnits(tempoResult.value.balance, decimals));\n      }\n    }\n  }\n\n  log.info(`Protocol selection — x402: $${x402Balance}, mpp: $${mppBalance}`);\n  return x402Balance >= mppBalance ? 'x402' : 'mpp';\n}\n\nasync function handleX402Payment(\n  surface: string,\n  response: Response,\n  clonedRequest: Request,\n  client: x402HTTPClient,\n  beforePayment?: BeforePaymentHook,\n  timeout?: number\n) {\n  const paymentRequiredResult = await safeGetPaymentRequired(\n    surface,\n    client,\n    response\n  );\n\n  if (paymentRequiredResult.isErr()) {\n    return paymentRequiredResult;\n  }\n\n  const paymentRequired = paymentRequiredResult.value;\n\n  // Call beforePayment hook (e.g. balance check) before signing\n  if (beforePayment) {\n    const accept = paymentRequired.accepts[0];\n    if (accept) {\n      const amount = tokenStringToNumber(accept.amount);\n      const hookResult = await resultFromPromise(\n        'x402',\n        surface,\n        beforePayment({\n          protocol: 'x402',\n          amount,\n          currency: 'USDC',\n          network: accept.network,\n        }),\n        e => ({\n          cause: 'payment_already_attempted' as const,\n          message:\n            e instanceof Error ? e.message : 'Before-payment hook failed',\n        })\n      );\n      if (hookResult.isErr()) {\n        return x402Err(surface, hookResult.error);\n      }\n    }\n  }\n\n  const paymentPayloadResult = await safeCreatePaymentPayload(\n    surface,\n    client,\n    paymentRequired\n  );\n\n  if (paymentPayloadResult.isErr()) {\n    return paymentPayloadResult;\n  }\n\n  const paymentPayload = paymentPayloadResult.value;\n\n  // Encode payment header\n  const paymentHeaders = client.encodePaymentSignatureHeader(paymentPayload);\n\n  // Check if this is already a retry to prevent infinite loops\n  if (\n    clonedRequest.headers.has('PAYMENT-SIGNATURE') ||\n    clonedRequest.headers.has('X-PAYMENT')\n  ) {\n    return x402Err(surface, {\n      cause: 'payment_already_attempted',\n      message: 'Payment already attempted',\n    });\n  }\n\n  // Add payment headers to cloned request\n  for (const [key, value] of Object.entries(paymentHeaders)) {\n    clonedRequest.headers.set(key, value);\n  }\n  clonedRequest.headers.set(\n    'Access-Control-Expose-Headers',\n    'PAYMENT-RESPONSE,X-PAYMENT-RESPONSE'\n  );\n\n  // Retry the request with payment\n  return await safeFetch(surface, clonedRequest, timeout).andThen(\n    paidResponse => {\n      const settlementResult = safeGetPaymentSettlement(\n        surface,\n        client,\n        paidResponse\n      );\n\n      return x402Ok<FetchWithPaymentResult>({\n        response: paidResponse,\n        paymentInfo: {\n          protocol: 'x402',\n          price: tokenStringToNumber(\n            paymentPayload.accepted.amount\n          ).toLocaleString('en-US', {\n            style: 'currency',\n            currency: 'USD',\n          }),\n          ...(settlementResult.isOk()\n            ? {\n                payment: {\n                  success: settlementResult.value.success,\n                  transactionHash: settlementResult.value.transaction,\n                },\n              }\n            : {}),\n        },\n      });\n    }\n  );\n}\n\nasync function handleMppPayment(\n  surface: string,\n  response: Response,\n  clonedRequest: Request,\n  options: FetchWithPaymentOptions\n) {\n  const { clients, beforePayment, timeout } = options;\n  const mppxClient = clients.mpp;\n\n  // Prevent retry loops\n  if (clonedRequest.headers.has('Authorization')) {\n    return mppErr(surface, {\n      cause: 'mpp_payment_already_attempted',\n      message: 'MPP payment already attempted',\n    });\n  }\n\n  // Parse the challenge from the WWW-Authenticate header\n  const challengeResult = safeGetMppChallenge(surface, response);\n\n  if (challengeResult.isErr()) {\n    return challengeResult;\n  }\n\n  const challenge = challengeResult.value;\n\n  // Extract payment info from challenge request\n  const amount = challenge.request.amount as string | undefined;\n  const decimals = (challenge.request.decimals as number | undefined) ?? 6;\n  const currency = challenge.request.currency as string | undefined;\n\n  // Call beforePayment hook (e.g. balance check)\n  if (beforePayment && amount && currency) {\n    const numericAmount = Number(formatUnits(BigInt(amount), decimals));\n    const hookResult = await resultFromPromise(\n      'mpp',\n      surface,\n      beforePayment({\n        protocol: 'mpp',\n        amount: numericAmount,\n        currency,\n        network: `tempo:${challenge.method}`,\n      }),\n      e => ({\n        cause: 'mpp_payment_already_attempted' as const,\n        message: e instanceof Error ? e.message : 'Before-payment hook failed',\n      })\n    );\n    if (hookResult.isErr()) {\n      return mppErr(surface, hookResult.error);\n    }\n  }\n\n  // Create credential (signs transaction on Tempo)\n  const credentialResult = await safeCreateMppCredential(\n    surface,\n    mppxClient,\n    response\n  );\n\n  if (credentialResult.isErr()) {\n    return credentialResult;\n  }\n\n  const credential = credentialResult.value;\n\n  // Set Authorization header on cloned request\n  clonedRequest.headers.set('Authorization', credential);\n\n  // Retry the fetch with the credential\n  return await safeFetch(surface, clonedRequest, timeout).andThen(\n    paidResponse => {\n      // Parse the receipt for transaction hash\n      const receiptResult = safeGetMppReceipt(surface, paidResponse);\n\n      const priceDisplay = amount\n        ? Number(formatUnits(BigInt(amount), decimals)).toLocaleString(\n            'en-US',\n            {\n              style: 'currency',\n              currency: 'USD',\n            }\n          )\n        : undefined;\n\n      return mppOk<FetchWithPaymentResult>({\n        response: paidResponse,\n        paymentInfo: {\n          protocol: 'mpp',\n          ...(priceDisplay ? { price: priceDisplay } : {}),\n          ...(receiptResult.isOk()\n            ? {\n                payment: {\n                  success: true,\n                  transactionHash: receiptResult.value.reference,\n                },\n              }\n            : {}),\n        },\n      });\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,OAAO;AAIP,IAAM,gBAAgB,EAAE,OAAO;AAAA,EACpC,KAAK,EAAE,IAAI,EAAE,SAAS,kBAAkB;AAAA,EACxC,QAAQ,EACL,KAAK,CAAC,OAAO,QAAQ,OAAO,UAAU,OAAO,CAAC,EAC9C,SAAS,EACT,SAAS,oDAAoD;AAAA,EAChE,MAAM,EACH,QAAQ,EACR,SAAS,EACT,SAAS,yCAAyC;AAAA,EACrD,SAAS,EACN,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAC7B,SAAS,EACT,SAAS,+BAA+B,EACxC,QAAQ,CAAC,CAAC;AAAA,EACb,SAAS,EACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,iCAAiC;AAC/C,CAAC;AASM,IAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAyB;AACvB,SAAO,IAAI,QAAQ,MAAM,KAAK;AAAA,IAC5B,QAAQ,MAAM,UAAU;AAAA,IACxB,MAAM,MAAM,OACR,OAAO,MAAM,SAAS,WACpB,MAAM,OACN,KAAK,UAAU,MAAM,IAAI,IAC3B;AAAA,IACJ,SAAS;AAAA,MACP,GAAI,MAAM,OAAO,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,MAC3D,GAAG,MAAM;AAAA,MACT,GAAI,UACA,EAAE,oBAAoB,SAAS,eAAe,SAAS,IACvD,CAAC;AAAA,MACL,GAAI,YAAY,EAAE,gBAAgB,UAAU,IAAI,CAAC;AAAA,IACnD;AAAA,EACF,CAAC;AACH;;;ACxDA,SAAS,WAAW,eAAe;AASnC,IAAM,YAAY;AAEX,IAAM,QAAQ,CAAI,UAAa,GAAG,KAAK;AACvC,IAAM,SAAS,CAAC,SAAiB,UACtC,IAAI,WAAW,SAAS,KAAK;AAE/B,IAAM,uBAAuB,CAC3B,SACA,SACA,UACG,kBAAkB,WAAW,SAAS,SAAS,KAAK;AAEzD,IAAM,yBAAyB,CAC7B,SACA,IACA,UACG,oBAAoB,WAAW,SAAS,IAAI,KAAK;AAE/C,IAAM,sBAAsB,CAAC,SAAiB,aAAuB;AAC1E,SAAO;AAAA,IACL;AAAA,IACA,MAAM,UAAU,aAAa,QAAQ;AAAA,IACrC,YAAU;AAAA,MACR,OAAO;AAAA,MACP,SACE,iBAAiB,QACb,MAAM,UACN;AAAA,IACR;AAAA,EACF;AACF;AAEO,IAAM,0BAA0B,CACrC,SACA,YACA,aACG;AACH,SAAO;AAAA,IACL;AAAA,IACA,WAAW,iBAAiB,QAAQ;AAAA,IACpC,YAAU;AAAA,MACR,OAAO;AAAA,MACP,SACE,iBAAiB,QACb,MAAM,UACN;AAAA,IACR;AAAA,EACF;AACF;AAEO,IAAM,oBAAoB,CAAC,SAAiB,aAAuB;AACxE,SAAO;AAAA,IACL;AAAA,IACA,MAAM,QAAQ,aAAa,QAAQ;AAAA,IACnC,YAAU;AAAA,MACR,OAAO;AAAA,MACP,SACE,iBAAiB,QACb,MAAM,UACN;AAAA,IACR;AAAA,EACF;AACF;;;ACvEA,SAAS,mBAAmB;AAgFrB,SAAS,uBAAuB,SAAkC;AACvE,QAAM,EAAE,SAAS,SAAS,eAAe,eAAe,QAAQ,IAAI;AAEpE,SAAO,OAAO,YAAqB;AACjC,UAAM,gBAAgB,QAAQ,MAAM;AACpC,UAAM,kBAAkB,QAAQ,MAAM;AAEtC,UAAM,cAAc,MAAM,UAAU,SAAS,SAAS,OAAO;AAE7D,QAAI,YAAY,MAAM,GAAG;AACvB,aAAO,SAAS,SAAS,YAAY,KAAK;AAAA,IAC5C;AAGA,QAAI,YAAY,MAAM,WAAW,KAAK;AACpC,aAAO,YAAY;AAAA,QAAQ,CAAAA,cACzB,QAAgC,EAAE,UAAAA,WAAU,aAAa,KAAK,CAAC;AAAA,MACjE;AAAA,IACF;AAEA,UAAM,WAAW,YAAY;AAG7B,QAAI,kBAAkB,QAAQ;AAC5B,UAAI,kBAAkB,OAAO;AAC3B,eAAO,iBAAiB,SAAS,UAAU,eAAe,OAAO;AAAA,MACnE;AACA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAGA,UAAM,YAAY,uBAAuB,QAAQ;AAEjD,QAAI;AAEJ,QAAI,UAAU,WAAW,GAAG;AAC1B,kBAAY,UAAU,CAAC;AAAA,IACzB,OAAO;AAEL,kBAAY,MAAM,cAAc,SAAS,UAAU,OAAO;AAAA,IAC5D;AAEA,UAAM,WACJ,UAAU,SAAS,IAAK,cAAc,QAAQ,SAAS,QAAS;AAElE,UAAM,SACJ,cAAc,QACV,MAAM,iBAAiB,SAAS,UAAU,eAAe,OAAO,IAChE,MAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAEN,QAAI,OAAO,MAAM,KAAK,UAAU;AAE9B,aAAO,aAAa,QAChB,iBAAiB,SAAS,UAAU,iBAAiB,OAAO,IAC5D;AAAA,QACE;AAAA,QACA;AAAA,QACA;AAAA,QACA,QAAQ;AAAA,QACR;AAAA,QACA;AAAA,MACF;AAAA,IACN;AAEA,WAAO;AAAA,EACT;AACF;AAMA,eAAe,cACb,SACA,UACA,SACyB;AACzB,QAAM,EAAE,SAAS,MAAM,IAAI;AAG3B,QAAM,oBAAoB,MAAM;AAAA,IAC9B;AAAA,IACA;AAAA,IACA,WAAW;AAAA,MACT,SAAS,QAAQ;AAAA,MACjB;AAAA,MACA;AAAA,IACF,CAAC,EAAE,KAAK,OAAM,EAAE,KAAK,IAAI,EAAE,MAAM,UAAU,CAAE;AAAA,IAC7C,OAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,IACX;AAAA,EACF;AAEA,MAAI,kBAAkB,MAAM,GAAG;AAC7B,QAAI,MAAM,8CAA8C;AACxD,WAAO;AAAA,EACT;AAEA,QAAM,cAAc,kBAAkB;AAGtC,MAAI,aAAa;AACjB,QAAM,kBAAkB,oBAAoB,SAAS,QAAQ;AAC7D,MAAI,gBAAgB,KAAK,GAAG;AAC1B,UAAM,WAAW,gBAAgB,MAAM,QAAQ;AAG/C,UAAM,WACH,gBAAgB,MAAM,QAAQ,YAAmC;AACpE,QAAI,UAAU;AACZ,YAAM,cAAc,MAAM;AAAA,QACxB;AAAA,QACA;AAAA,QACA,gBAAgB;AAAA,UACd,SAAS,QAAQ;AAAA,UACjB,cAAc;AAAA,QAChB,CAAC;AAAA,QACD,OAAO;AAAA,UACL,OAAO;AAAA,UACP,SAAS;AAAA,QACX;AAAA,MACF;AACA,UAAI,YAAY,KAAK,GAAG;AACtB,qBAAa,OAAO,YAAY,YAAY,MAAM,SAAS,QAAQ,CAAC;AAAA,MACtE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,KAAK,oCAA+B,WAAW,WAAW,UAAU,EAAE;AAC1E,SAAO,eAAe,aAAa,SAAS;AAC9C;AAEA,eAAe,kBACb,SACA,UACA,eACA,QACA,eACA,SACA;AACA,QAAM,wBAAwB,MAAM;AAAA,IAClC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,sBAAsB,MAAM,GAAG;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,kBAAkB,sBAAsB;AAG9C,MAAI,eAAe;AACjB,UAAM,SAAS,gBAAgB,QAAQ,CAAC;AACxC,QAAI,QAAQ;AACV,YAAM,SAAS,oBAAoB,OAAO,MAAM;AAChD,YAAM,aAAa,MAAM;AAAA,QACvB;AAAA,QACA;AAAA,QACA,cAAc;AAAA,UACZ,UAAU;AAAA,UACV;AAAA,UACA,UAAU;AAAA,UACV,SAAS,OAAO;AAAA,QAClB,CAAC;AAAA,QACD,QAAM;AAAA,UACJ,OAAO;AAAA,UACP,SACE,aAAa,QAAQ,EAAE,UAAU;AAAA,QACrC;AAAA,MACF;AACA,UAAI,WAAW,MAAM,GAAG;AACtB,eAAO,QAAQ,SAAS,WAAW,KAAK;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAEA,QAAM,uBAAuB,MAAM;AAAA,IACjC;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,qBAAqB,MAAM,GAAG;AAChC,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB,qBAAqB;AAG5C,QAAM,iBAAiB,OAAO,6BAA6B,cAAc;AAGzE,MACE,cAAc,QAAQ,IAAI,mBAAmB,KAC7C,cAAc,QAAQ,IAAI,WAAW,GACrC;AACA,WAAO,QAAQ,SAAS;AAAA,MACtB,OAAO;AAAA,MACP,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAGA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,cAAc,GAAG;AACzD,kBAAc,QAAQ,IAAI,KAAK,KAAK;AAAA,EACtC;AACA,gBAAc,QAAQ;AAAA,IACpB;AAAA,IACA;AAAA,EACF;AAGA,SAAO,MAAM,UAAU,SAAS,eAAe,OAAO,EAAE;AAAA,IACtD,kBAAgB;AACd,YAAM,mBAAmB;AAAA,QACvB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAEA,aAAO,OAA+B;AAAA,QACpC,UAAU;AAAA,QACV,aAAa;AAAA,UACX,UAAU;AAAA,UACV,OAAO;AAAA,YACL,eAAe,SAAS;AAAA,UAC1B,EAAE,eAAe,SAAS;AAAA,YACxB,OAAO;AAAA,YACP,UAAU;AAAA,UACZ,CAAC;AAAA,UACD,GAAI,iBAAiB,KAAK,IACtB;AAAA,YACE,SAAS;AAAA,cACP,SAAS,iBAAiB,MAAM;AAAA,cAChC,iBAAiB,iBAAiB,MAAM;AAAA,YAC1C;AAAA,UACF,IACA,CAAC;AAAA,QACP;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEA,eAAe,iBACb,SACA,UACA,eACA,SACA;AACA,QAAM,EAAE,SAAS,eAAe,QAAQ,IAAI;AAC5C,QAAM,aAAa,QAAQ;AAG3B,MAAI,cAAc,QAAQ,IAAI,eAAe,GAAG;AAC9C,WAAO,OAAO,SAAS;AAAA,MACrB,OAAO;AAAA,MACP,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAGA,QAAM,kBAAkB,oBAAoB,SAAS,QAAQ;AAE7D,MAAI,gBAAgB,MAAM,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,gBAAgB;AAGlC,QAAM,SAAS,UAAU,QAAQ;AACjC,QAAM,WAAY,UAAU,QAAQ,YAAmC;AACvE,QAAM,WAAW,UAAU,QAAQ;AAGnC,MAAI,iBAAiB,UAAU,UAAU;AACvC,UAAM,gBAAgB,OAAO,YAAY,OAAO,MAAM,GAAG,QAAQ,CAAC;AAClE,UAAM,aAAa,MAAM;AAAA,MACvB;AAAA,MACA;AAAA,MACA,cAAc;AAAA,QACZ,UAAU;AAAA,QACV,QAAQ;AAAA,QACR;AAAA,QACA,SAAS,SAAS,UAAU,MAAM;AAAA,MACpC,CAAC;AAAA,MACD,QAAM;AAAA,QACJ,OAAO;AAAA,QACP,SAAS,aAAa,QAAQ,EAAE,UAAU;AAAA,MAC5C;AAAA,IACF;AACA,QAAI,WAAW,MAAM,GAAG;AACtB,aAAO,OAAO,SAAS,WAAW,KAAK;AAAA,IACzC;AAAA,EACF;AAGA,QAAM,mBAAmB,MAAM;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAEA,MAAI,iBAAiB,MAAM,GAAG;AAC5B,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,iBAAiB;AAGpC,gBAAc,QAAQ,IAAI,iBAAiB,UAAU;AAGrD,SAAO,MAAM,UAAU,SAAS,eAAe,OAAO,EAAE;AAAA,IACtD,kBAAgB;AAEd,YAAM,gBAAgB,kBAAkB,SAAS,YAAY;AAE7D,YAAM,eAAe,SACjB,OAAO,YAAY,OAAO,MAAM,GAAG,QAAQ,CAAC,EAAE;AAAA,QAC5C;AAAA,QACA;AAAA,UACE,OAAO;AAAA,UACP,UAAU;AAAA,QACZ;AAAA,MACF,IACA;AAEJ,aAAO,MAA8B;AAAA,QACnC,UAAU;AAAA,QACV,aAAa;AAAA,UACX,UAAU;AAAA,UACV,GAAI,eAAe,EAAE,OAAO,aAAa,IAAI,CAAC;AAAA,UAC9C,GAAI,cAAc,KAAK,IACnB;AAAA,YACE,SAAS;AAAA,cACP,SAAS;AAAA,cACT,iBAAiB,cAAc,MAAM;AAAA,YACvC;AAAA,UACF,IACA,CAAC;AAAA,QACP;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":["response"]}

package/dist/esm/{chunk-SBLBP4FH.js → chunk-7LPATNAW.js}

@@ -4,7 +4,7 @@ import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 function getVersion() {
   if (true) {
-    return "0.3.7";
+    return "0.4.1";
   }
   const __dirname2 = dirname(fileURLToPath(import.meta.url));
   const pkg = JSON.parse(
@@ -19,4 +19,4 @@ export {
   MCP_VERSION,
   DIST_TAG
 };
-//# sourceMappingURL=chunk-SBLBP4FH.js.map
+//# sourceMappingURL=chunk-7LPATNAW.js.map

package/dist/esm/{chunk-PCCYUD6X.js → chunk-DCP6SZGV.js}

@@ -2,10 +2,10 @@ import {
   DEFAULT_NETWORK,
   getChainName,
   redeemInviteCode
-} from "./chunk-EVE4PTLY.js";
+} from "./chunk-TRGCJSV2.js";
 import {
   getDepositLink
-} from "./chunk-PJFATGPH.js";
+} from "./chunk-EO4BIJAO.js";
 
 // src/cli/lib/deposit.ts
 import chalk from "chalk";
@@ -111,4 +111,4 @@ export {
   wait,
   promptDeposit
 };
-//# sourceMappingURL=chunk-PCCYUD6X.js.map
+//# sourceMappingURL=chunk-DCP6SZGV.js.map

package/dist/esm/{chunk-PJFATGPH.js → chunk-EO4BIJAO.js}

@@ -616,6 +616,8 @@ var safeParse = (surface, schema, value) => {
 
 // src/shared/neverthrow/fetch/index.ts
 import contentType from "content-type";
+var DEFAULT_FETCH_TIMEOUT = 1e4;
+var DEFAULT_USER_FETCH_TIMEOUT = 3e4;
 var IMAGE_TYPES = /* @__PURE__ */ new Set([
   "image/png",
   "image/jpeg",
@@ -635,19 +637,28 @@ var fetchHttpErr = (surface, response) => fetchErr(surface, {
   message: response.statusText,
   response
 });
-var safeFetch = (surface, request) => {
+var safeFetch = (surface, request, timeout) => {
+  const signal = timeout ? AbortSignal.timeout(timeout) : void 0;
   return resultFromPromise(
     errorType2,
     surface,
-    fetch(request),
-    (error) => ({
-      cause: "network",
-      message: error instanceof Error ? error.message : "Network error"
-    })
+    fetch(request, ...signal ? [{ signal }] : []),
+    (error) => {
+      if (error instanceof DOMException && (error.name === "TimeoutError" || error.name === "AbortError")) {
+        return {
+          cause: "timeout",
+          message: timeout ? `Request timed out after ${timeout}ms. You can increase the timeout by passing a larger value in the 'timeout' parameter.` : "Request was aborted"
+        };
+      }
+      return {
+        cause: "network",
+        message: error instanceof Error ? error.message : "Network error"
+      };
+    }
   );
 };
-var safeFetchJson = (surface, request, schema) => {
-  return safeFetch(surface, request).andThen((response) => {
+var safeFetchJson = (surface, request, schema, timeout) => {
+  return safeFetch(surface, request, timeout).andThen((response) => {
     if (!response.ok) {
       return fetchHttpErr(surface, response);
     }
@@ -768,6 +779,8 @@ export {
   ok2 as ok,
   err2 as err,
   safeParse,
+  DEFAULT_FETCH_TIMEOUT,
+  DEFAULT_USER_FETCH_TIMEOUT,
   fetchErr,
   fetchOk,
   fetchHttpErr,
@@ -787,4 +800,4 @@ export {
   openDepositLink,
   getBalance
 };
-//# sourceMappingURL=chunk-PJFATGPH.js.map
+//# sourceMappingURL=chunk-EO4BIJAO.js.map