agentcash 0.14.4 → 0.15.0

package/dist/esm/chunk-MKA2PTOE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/operations/bridge.ts","../../src/shared/network.ts","../../../../internal/bridge/src/quote.ts","../../../../internal/bridge/src/client.ts","../../../../internal/bridge/src/execute.ts","../../../../internal/bridge/src/relay-svm-wallet-adapter.ts","../../src/shared/neverthrow/bridge/index.ts"],"sourcesContent":["import z from 'zod';\n\nimport { createWalletClient, http } from 'viem';\n\nimport { EVM_CONFIGS, Network, networkSchema } from '@agentcash/networks';\n\nimport { toTypedNetworkAddress } from '@/shared/network';\nimport { TOOL_PARAMS } from '@/shared/descriptions';\nimport {\n  safeExecuteQuote,\n  safeExecuteSolana,\n  safeGetBridgeDepositQuote,\n} from '@/shared/neverthrow/bridge';\nimport { safeFetchJson } from '@/shared/neverthrow/fetch';\nimport { getBaseUrl } from '@/shared/utils';\n\nimport type { Wallets } from '@/wallet';\nimport type { Execute } from '@agentcash/bridge';\nimport type { GlobalFlags } from '@/types';\n\nexport const bridgeSchema = z\n  .object({\n    from: networkSchema.describe(TOOL_PARAMS.bridge.from),\n    to: networkSchema.describe(TOOL_PARAMS.bridge.to),\n    amount: z.number().positive().describe(TOOL_PARAMS.bridge.amount),\n  })\n  .refine(({ from, to }) => from !== to, {\n    message: 'From and to networks cannot be the same',\n  });\n\nexport type BridgeInput = z.input<typeof bridgeSchema>;\n\nexport const bridge = async (\n  args: GlobalFlags<z.infer<typeof bridgeSchema>>,\n  wallets: Wallets\n) => {\n  const { from, to, amount } = args;\n\n  if (from === Network.SOLANA) {\n    const request = new Request(`${getBaseUrl(args.dev)}/api/bridge/solana`, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n      },\n      body: JSON.stringify({\n        fromAddress: wallets.svm.address,\n        to: toTypedNetworkAddress(to, wallets),\n        amount,\n      }),\n    });\n    const response = await safeFetchJson(\n      'bridge',\n      request,\n      z.object({\n        success: z.literal(true),\n        partiallySignedTransaction: z.string(),\n        quote: z.custom<Execute>(),\n      })\n    );\n\n    if (response.isErr()) {\n      return response;\n    }\n\n    const { partiallySignedTransaction, quote } = response.value;\n\n    const executeResult = await safeExecuteSolana('bridge', {\n      quote,\n      signer: wallets.svm,\n      partiallySignedTransaction,\n    });\n\n    return executeResult.map(\n      result => result.data.details ?? { success: true }\n    );\n  } else {\n    const quote = await safeGetBridgeDepositQuote('bridge', {\n      from: toTypedNetworkAddress(from, wallets),\n      to: toTypedNetworkAddress(to, wallets),\n      amount,\n    });\n\n    if (quote.isErr()) {\n      return quote;\n    }\n\n    const executeResult = await safeExecuteQuote(\n      'bridge',\n      quote.value,\n      createWalletClient({\n        account: wallets.evm,\n        chain: EVM_CONFIGS[from].chain,\n        transport: http(EVM_CONFIGS[from].rpcUrl),\n      })\n    );\n\n    return executeResult.map(\n      result => result.data.details ?? { success: true }\n    );\n  }\n};\n","import { Network } from '@agentcash/networks';\n\nimport type { TypedNetworkAddress } from '@agentcash/networks';\nimport type { Wallets } from '@/wallet';\n\nexport const toTypedNetworkAddress = (\n  network: Network,\n  wallets: Wallets\n): TypedNetworkAddress => {\n  if (network === Network.SOLANA) {\n    return {\n      address: wallets.svm.address,\n      network: Network.SOLANA,\n    };\n  }\n  return {\n    address: wallets.evm.address,\n    network: network,\n  };\n};\n","import {\n  Network,\n  solanaAddressSchema,\n  typedAddressSchema,\n  usdc,\n} from '@agentcash/networks';\nimport z from 'zod';\n\nimport { relayClient, relayChainId } from './client';\n\nexport const getBridgeDepositQuoteSchema = z.object({\n  from: typedAddressSchema,\n  to: typedAddressSchema,\n  amount: z.number(),\n  depositFeePayer: solanaAddressSchema.optional(),\n});\n\nexport const getBridgeDepositQuote = async (\n  input: z.input<typeof getBridgeDepositQuoteSchema>\n) => {\n  const parseResult = getBridgeDepositQuoteSchema.safeParse(input);\n  if (!parseResult.success) {\n    throw new Error('Invalid input');\n  }\n\n  const { from, to, amount, depositFeePayer } = parseResult.data;\n\n  const fromCurrency = usdc(from.network);\n  const toCurrency = usdc(to.network);\n\n  return await relayClient.actions.getQuote({\n    chainId: relayChainId(from.network),\n    toChainId: relayChainId(to.network),\n    currency: fromCurrency.address,\n    toCurrency: toCurrency.address,\n    tradeType: 'EXACT_INPUT',\n    user: from.address,\n    recipient: to.address,\n    amount: (amount * 10 ** fromCurrency.decimals).toString(),\n    options: {\n      refundTo: from.address,\n      depositFeePayer:\n        from.network === Network.SOLANA ? depositFeePayer : undefined,\n      usePermit: from.network !== Network.SOLANA,\n    },\n  });\n};\n","import {\n  createClient,\n  convertViemChainToRelayChain,\n  MAINNET_RELAY_API,\n} from '@relayprotocol/relay-sdk';\n\nimport { Network, chainId, EVM_CONFIGS } from '@agentcash/networks';\n\nimport type { RelayChain } from '@relayprotocol/relay-sdk';\n\nexport const SOLANA_RELAY_CHAIN: RelayChain = {\n  id: 792703809,\n  name: 'solana',\n  displayName: 'Solana',\n  httpRpcUrl: 'https://api.mainnet-beta.solana.com',\n  wsRpcUrl: '',\n  explorerUrl: 'https://solscan.io',\n  depositEnabled: true,\n  tokenSupport: 'All',\n  currency: {\n    id: 'sol',\n    symbol: 'SOL',\n    name: 'Solana',\n    address: '11111111111111111111111111111111',\n    decimals: 9,\n    supportsBridging: true,\n  },\n  featuredTokens: [\n    {\n      id: 'sol',\n      symbol: 'SOL',\n      name: 'Solana',\n      address: '11111111111111111111111111111111',\n      decimals: 9,\n      supportsBridging: true,\n      metadata: {\n        logoURI:\n          'https://upload.wikimedia.org/wikipedia/en/b/b9/Solana_logo.png',\n      },\n    },\n    {\n      id: 'usdc',\n      symbol: 'USDC',\n      name: 'USD Coin',\n      address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n      decimals: 6,\n      supportsBridging: true,\n      metadata: {\n        logoURI:\n          'https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694',\n      },\n    },\n    {\n      id: 'usdt',\n      symbol: 'USDT',\n      name: 'USDT',\n      address: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n      decimals: 6,\n      supportsBridging: true,\n      metadata: {\n        logoURI:\n          'https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661',\n      },\n    },\n  ],\n  erc20Currencies: [\n    {\n      id: 'pengu',\n      symbol: 'PENGU',\n      name: 'Pudgy Penguins',\n      address: '2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv',\n      decimals: 6,\n      supportsBridging: true,\n      withdrawalFee: 25,\n      depositFee: 0,\n      surgeEnabled: false,\n    },\n    {\n      id: 'usdc',\n      symbol: 'USDC',\n      name: 'USD Coin',\n      address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n      decimals: 6,\n      supportsBridging: true,\n      supportsPermit: true,\n      withdrawalFee: 2.25,\n      depositFee: 2,\n      surgeEnabled: false,\n    },\n    {\n      id: 'usdt',\n      symbol: 'USDT',\n      name: 'USDT',\n      address: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n      decimals: 6,\n      supportsBridging: true,\n      withdrawalFee: 5,\n      depositFee: 2,\n      surgeEnabled: false,\n    },\n    {\n      id: 'cash',\n      symbol: 'CASH',\n      name: 'CASH',\n      address: 'CASHx9KJUStyftLFWGvEVf59SGeG9sh5FfcnZMVPCASH',\n      decimals: 6,\n      supportsBridging: true,\n      withdrawalFee: 25,\n      depositFee: 0,\n      surgeEnabled: false,\n    },\n    {\n      id: 'pyusd',\n      symbol: 'PYUSD',\n      name: 'PayPal USD',\n      address: '2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo',\n      decimals: 6,\n      supportsBridging: true,\n      withdrawalFee: 25,\n      depositFee: 0,\n      surgeEnabled: false,\n    },\n  ],\n  solverCurrencies: [\n    {\n      id: 'pengu',\n      symbol: 'PENGU',\n      name: 'Pudgy Penguins',\n      address: '2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv',\n      decimals: 6,\n    },\n    {\n      id: 'usdc',\n      symbol: 'USDC',\n      name: 'USD Coin',\n      address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n      decimals: 6,\n    },\n    {\n      id: 'usdt',\n      symbol: 'USDT',\n      name: 'USDT',\n      address: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',\n      decimals: 6,\n    },\n    {\n      id: 'cash',\n      symbol: 'CASH',\n      name: 'CASH',\n      address: 'CASHx9KJUStyftLFWGvEVf59SGeG9sh5FfcnZMVPCASH',\n      decimals: 6,\n    },\n    {\n      id: 'pyusd',\n      symbol: 'PYUSD',\n      name: 'PayPal USD',\n      address: '2b1kV6DkPAnxd5ixfnxCpjxmKwqjjaYmCZfHsFu24GXo',\n      decimals: 6,\n    },\n    {\n      id: 'sol',\n      symbol: 'SOL',\n      name: 'Solana',\n      address: '11111111111111111111111111111111',\n      decimals: 9,\n    },\n  ],\n  iconUrl: 'https://assets.relay.link/icons/792703809/light.png',\n  vmType: 'svm',\n  baseChainId: 1,\n  tags: [],\n  protocol: {\n    v2: {\n      chainId: 'solana',\n      depository: '99vQwtBwYtrqqD9YSXbdum3KBdxPAVxYTaQ3cfnJSrN2',\n    },\n  },\n};\n\nexport const relayChainId = (network: Network) => {\n  switch (network) {\n    case Network.BASE:\n    case Network.TEMPO:\n      return chainId(network);\n    case Network.SOLANA:\n      return SOLANA_RELAY_CHAIN.id;\n  }\n};\n\nexport const relayClient = createClient({\n  baseApiUrl: MAINNET_RELAY_API,\n  source: 'https://agentcash.dev',\n  chains: [\n    ...Object.values(EVM_CONFIGS).map(config =>\n      convertViemChainToRelayChain(config.chain)\n    ),\n    SOLANA_RELAY_CHAIN,\n  ],\n});\n","import { adaptViemWallet } from '@relayprotocol/relay-sdk';\n\nimport { relayClient } from './client';\nimport type { AdaptSolanaKitWalletParams } from './relay-svm-wallet-adapter';\nimport { adaptSolanaKitWallet } from './relay-svm-wallet-adapter';\n\nimport type { WalletClient } from 'viem';\nimport type { Execute } from '@relayprotocol/relay-sdk';\n\nexport const executeQuote = async (quote: Execute, account: WalletClient) => {\n  return await relayClient.actions.execute({\n    wallet: adaptViemWallet(account),\n    quote,\n  });\n};\n\nexport interface ExecuteSolanaParams extends AdaptSolanaKitWalletParams {\n  quote: Execute;\n}\n\nexport const executeSolana = async ({\n  quote,\n  ...rest\n}: ExecuteSolanaParams) => {\n  return await relayClient.actions.execute({\n    wallet: adaptSolanaKitWallet(rest),\n    quote,\n  });\n};\n","import {\n  assertIsSendableTransaction,\n  assertIsTransactionWithinSizeLimit,\n  createSolanaRpc,\n  getBase64EncodedWireTransaction,\n  getCompiledTransactionMessageDecoder,\n  getSignatureFromTransaction,\n  getTransactionDecoder,\n  getTransactionLifetimeConstraintFromCompiledTransactionMessage,\n  isTransactionModifyingSigner,\n  isTransactionPartialSigner,\n  isTransactionSendingSigner,\n} from '@solana/kit';\nimport { LogLevel, getClient } from '@relayprotocol/relay-sdk';\n\nimport { SOLANA_RELAY_CHAIN } from './client';\n\nimport type { AdaptedWallet } from '@relayprotocol/relay-sdk';\nimport type {\n  ClusterUrl,\n  Signature,\n  Transaction,\n  TransactionSigner,\n  TransactionWithLifetime,\n  TransactionWithinSizeLimit,\n} from '@solana/kit';\n\nconst BASE58_SIGNATURE_REGEX = /^[1-9A-HJ-NP-Za-km-z]+$/;\nconst DEFAULT_CONFIRM_TIMEOUT_MS = 120_000;\nconst DEFAULT_CONFIRM_POLL_MS = 2_000;\n\nexport interface AdaptSolanaKitWalletParams {\n  signer: TransactionSigner;\n  partiallySignedTransaction: string;\n  rpcUrl?: ClusterUrl;\n}\n\ntype SignableTransaction = Transaction &\n  TransactionWithLifetime &\n  TransactionWithinSizeLimit;\n\nconst assertBase58TransactionSignature = (signature: string | undefined) => {\n  if (\n    typeof signature !== 'string' ||\n    signature.length === 0 ||\n    !BASE58_SIGNATURE_REGEX.test(signature)\n  ) {\n    throw new Error('Invalid Solana signature: expected base58.');\n  }\n};\n\nconst sleep = async (ms: number) =>\n  await new Promise(resolve => setTimeout(resolve, ms));\n\nasync function decodePartiallySignedTransaction(\n  partiallySignedTransaction: string\n): Promise<SignableTransaction> {\n  const decodedTransaction = getTransactionDecoder().decode(\n    Uint8Array.from(Buffer.from(partiallySignedTransaction, 'base64'))\n  );\n  const compiledTransactionMessage =\n    getCompiledTransactionMessageDecoder().decode(\n      decodedTransaction.messageBytes\n    );\n  const lifetimeConstraint =\n    await getTransactionLifetimeConstraintFromCompiledTransactionMessage(\n      compiledTransactionMessage\n    );\n  const transactionWithLifetime = {\n    ...decodedTransaction,\n    lifetimeConstraint,\n  };\n\n  assertIsTransactionWithinSizeLimit(transactionWithLifetime);\n\n  return transactionWithLifetime;\n}\n\nasync function signTransactionWithSigner(\n  transaction: SignableTransaction,\n  signer: TransactionSigner\n): Promise<SignableTransaction> {\n  if (isTransactionModifyingSigner(signer)) {\n    const [signedTransaction] = await signer.modifyAndSignTransactions([\n      transaction,\n    ]);\n\n    if (!signedTransaction) {\n      throw new Error('Modifying signer did not return a signed transaction');\n    }\n\n    return signedTransaction;\n  }\n\n  if (isTransactionPartialSigner(signer)) {\n    const [signatureDictionary] = await signer.signTransactions([transaction]);\n\n    if (!signatureDictionary) {\n      throw new Error('Transaction signer did not return signatures');\n    }\n\n    return {\n      ...transaction,\n      signatures: Object.freeze({\n        ...transaction.signatures,\n        ...signatureDictionary,\n      }),\n    };\n  }\n\n  if (isTransactionSendingSigner(signer)) {\n    throw new Error(\n      'TransactionSendingSigner is not supported by Relay Solana adapter'\n    );\n  }\n\n  throw new Error(\n    'Unsupported Solana transaction signer provided to Relay adapter'\n  );\n}\n\nexport const adaptSolanaKitWallet = ({\n  rpcUrl = SOLANA_RELAY_CHAIN.httpRpcUrl as ClusterUrl,\n  signer,\n  partiallySignedTransaction,\n}: AdaptSolanaKitWalletParams): AdaptedWallet => {\n  const rpc = createSolanaRpc(rpcUrl);\n  return {\n    vmType: 'svm',\n    getChainId: () => Promise.resolve(SOLANA_RELAY_CHAIN.id),\n    address: () => Promise.resolve(signer.address),\n    handleSignMessageStep: () => {\n      throw new Error('Message signing not implemented for Solana');\n    },\n    handleSendTransactionStep: async () => {\n      const client = getClient();\n      const decodedTransaction = await decodePartiallySignedTransaction(\n        partiallySignedTransaction\n      );\n      const signedTransaction = await signTransactionWithSigner(\n        decodedTransaction,\n        signer\n      );\n\n      assertIsSendableTransaction(signedTransaction);\n      const wireTransaction =\n        getBase64EncodedWireTransaction(signedTransaction);\n      const signature = getSignatureFromTransaction(signedTransaction);\n\n      await rpc\n        .sendTransaction(wireTransaction, {\n          encoding: 'base64',\n          skipPreflight: false,\n          preflightCommitment: 'confirmed',\n        })\n        .send();\n\n      assertBase58TransactionSignature(signature);\n\n      client.log(\n        ['Transaction Signature obtained', { signature }],\n        LogLevel.Verbose\n      );\n\n      return signature;\n    },\n    handleConfirmTransactionStep: async txHash => {\n      assertBase58TransactionSignature(txHash);\n\n      const deadline = Date.now() + DEFAULT_CONFIRM_TIMEOUT_MS;\n\n      while (Date.now() < deadline) {\n        const { value: statuses } = await rpc\n          .getSignatureStatuses([txHash as Signature])\n          .send();\n\n        const status = statuses[0];\n\n        if (status) {\n          if (status.err) {\n            throw new Error(\n              `Transaction failed: ${JSON.stringify(status.err)}`\n            );\n          }\n\n          if (\n            status.confirmationStatus === 'confirmed' ||\n            status.confirmationStatus === 'finalized'\n          ) {\n            return {\n              blockHash: status.slot.toString(),\n              blockNumber: Number(status.slot),\n              txHash,\n            };\n          }\n        }\n\n        await sleep(DEFAULT_CONFIRM_POLL_MS);\n      }\n\n      throw new Error(\n        `Transaction not confirmed within ${DEFAULT_CONFIRM_TIMEOUT_MS}ms: ${txHash}`\n      );\n    },\n    switchChain: () => {\n      throw new Error('Switching chains not implemented for Solana');\n    },\n  };\n};\n","import {\n  executeQuote,\n  executeSolana,\n  getBridgeDepositQuote,\n} from '@agentcash/bridge';\nimport { err, resultFromPromise } from '@agentcash/neverthrow';\n\nimport type { BaseBridgeError } from './types';\n\nconst errorType = 'bridge';\n\nexport const bridgeErr = (surface: string, error: BaseBridgeError) =>\n  err(errorType, surface, error);\n\nconst bridgeResultFromPromise = <T>(\n  surface: string,\n  promise: Promise<T>,\n  error: (e: unknown) => BaseBridgeError\n) => resultFromPromise(errorType, surface, promise, error);\n\nconst getErrorMessage = (error: unknown, fallback: string) => {\n  if (error instanceof Error && error.message) {\n    return error.message;\n  }\n\n  if (typeof error === 'string' && error.length > 0) {\n    return error;\n  }\n\n  return fallback;\n};\n\nexport const safeGetBridgeDepositQuote = (\n  surface: string,\n  ...args: Parameters<typeof getBridgeDepositQuote>\n) =>\n  bridgeResultFromPromise(surface, getBridgeDepositQuote(...args), error => {\n    const errorMessage = getErrorMessage(\n      error,\n      'Failed to get bridge deposit quote'\n    );\n\n    return {\n      cause: 'get_bridge_deposit_quote',\n      errorMessage,\n      message: `Failed to get bridge deposit quote: ${errorMessage}`,\n    };\n  });\n\nexport const safeExecuteQuote = (\n  surface: string,\n  ...args: Parameters<typeof executeQuote>\n) =>\n  bridgeResultFromPromise(surface, executeQuote(...args), error => {\n    const errorMessage = getErrorMessage(error, 'Failed to execute quote');\n\n    return {\n      cause: 'execute_quote',\n      errorMessage,\n      message: `Failed to execute quote: ${errorMessage}`,\n    };\n  });\n\nexport const safeExecuteSolana = (\n  surface: string,\n  ...args: Parameters<typeof executeSolana>\n) =>\n  bridgeResultFromPromise(surface, executeSolana(...args), error => {\n    const errorMessage = getErrorMessage(\n      error,\n      'Failed to execute Solana bridge transaction'\n    );\n\n    return {\n      cause: 'execute_solana',\n      errorMessage,\n      message: `Failed to execute Solana bridge transaction: ${errorMessage}`,\n    };\n  });\n"],"mappings":"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","names":["z","z"]}

package/dist/esm/{chunk-ONGJJBKT.js → chunk-MZPHS3IS.js}

@@ -1,12 +1,12 @@
 import {
   TOOL_PARAMS
-} from "./chunk-3PYQIEMA.js";
+} from "./chunk-W37JKCLN.js";
 import {
   executeFetch
-} from "./chunk-JVMJVMWB.js";
+} from "./chunk-HNDMHX4B.js";
 import {
   safeParseResponse
-} from "./chunk-BFOYXXLG.js";
+} from "./chunk-RAS5DZPQ.js";
 import {
   log
 } from "./chunk-QZCSZB7E.js";
@@ -89,4 +89,4 @@ export {
   searchSchema,
   search
 };
-//# sourceMappingURL=chunk-ONGJJBKT.js.map
+//# sourceMappingURL=chunk-MZPHS3IS.js.map

package/dist/esm/{chunk-2SZ6MZS3.js → chunk-O57QVTLM.js}

@@ -1,6 +1,6 @@
 import {
   discoverResources
-} from "./chunk-L4U6AJW3.js";
+} from "./chunk-K3WB4R2P.js";
 import {
   errorResponse
 } from "./chunk-7EBJ4BCH.js";
@@ -52,4 +52,4 @@ function resolveDescription(result) {
 export {
   resolveOrigin
 };
-//# sourceMappingURL=chunk-2SZ6MZS3.js.map
+//# sourceMappingURL=chunk-O57QVTLM.js.map

package/dist/esm/{chunk-BFOYXXLG.js → chunk-RAS5DZPQ.js}

@@ -62,6 +62,19 @@ var safeFetchJson = (surface, request, schema, timeout) => {
     }));
   }).andThen((data) => safeParse(surface, schema, data));
 };
+var safeReadResponseText = (surface, response) => {
+  return resultFromPromise(
+    errorType,
+    surface,
+    (async () => response.clone().text())(),
+    () => ({
+      cause: "parse",
+      message: "Failed to read response body as text",
+      statusCode: response.status,
+      contentType: response.headers.get("content-type") ?? "Not specified"
+    })
+  );
+};
 var safeParseResponse = (surface, response) => {
   return resultFromPromise(
     errorType,
@@ -134,7 +147,8 @@ export {
   fetchHttpErr,
   safeFetch,
   safeFetchJson,
+  safeReadResponseText,
   safeParseResponse,
   isFetchError
 };
-//# sourceMappingURL=chunk-BFOYXXLG.js.map
+//# sourceMappingURL=chunk-RAS5DZPQ.js.map

package/dist/esm/chunk-RAS5DZPQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/neverthrow/fetch/index.ts"],"sourcesContent":["import contentType from 'content-type';\nimport { err, ok, resultFromPromise } from '@agentcash/neverthrow';\n\nimport type z from 'zod';\n\nimport type { BaseError, Error } from '@agentcash/neverthrow/types';\nimport type { BaseFetchError, FetchError, ParsedResponse } from './types';\nimport type { JsonObject } from '../json/types';\nimport { safeParse } from '../parse';\n\nconst DEFAULT_USER_FETCH_TIMEOUT = 30_000;\n\nconst IMAGE_TYPES = new Set([\n  'image/png',\n  'image/jpeg',\n  'image/gif',\n  'image/webp',\n  'image/svg+xml',\n  'image/tiff',\n  'image/bmp',\n  'image/ico',\n]);\n\nconst errorType = 'fetch';\n\nexport const fetchErr = (surface: string, error: BaseFetchError) =>\n  err(errorType, surface, error);\nexport const fetchOk = <T>(value: T) => ok(value);\n\nexport const fetchHttpErr = (surface: string, response: Response) =>\n  fetchErr(surface, {\n    cause: 'http' as const,\n    statusCode: response.status,\n    message: response.statusText,\n    response,\n  });\n\nexport const safeFetch = (\n  surface: string,\n  request: Request,\n  timeout = DEFAULT_USER_FETCH_TIMEOUT\n) => {\n  const signal = AbortSignal.timeout(timeout);\n\n  return resultFromPromise(\n    errorType,\n    surface,\n    fetch(request, ...(signal ? [{ signal }] : [])),\n    error => {\n      if (\n        error instanceof DOMException &&\n        (error.name === 'TimeoutError' || error.name === 'AbortError')\n      ) {\n        return {\n          cause: 'timeout',\n          message: timeout\n            ? `Request timed out after ${timeout}ms. You can increase the timeout by passing a larger value in the 'timeout' parameter.`\n            : 'Request was aborted',\n        } as BaseFetchError;\n      }\n\n      return {\n        cause: 'network',\n        message: error instanceof Error ? error.message : 'Network error',\n      } as BaseFetchError;\n    }\n  );\n};\n\nexport const safeFetchJson = <T>(\n  surface: string,\n  request: Request,\n  schema: z.ZodSchema<T>,\n  timeout?: number\n) => {\n  return safeFetch(surface, request, timeout)\n    .andThen(response => {\n      if (!response.ok) {\n        return fetchHttpErr(surface, response);\n      }\n\n      return resultFromPromise(errorType, surface, response.json(), () => ({\n        cause: 'parse' as const,\n        message: 'Could not parse JSON from response',\n        statusCode: response.status,\n        contentType: response.headers.get('content-type') ?? 'Not specified',\n      }));\n    })\n    .andThen(data => safeParse(surface, schema, data));\n};\n\nexport const safeReadResponseText = (surface: string, response: Response) => {\n  // async IIFE so a sync throw from `.clone()` becomes a rejection alongside\n  // any `.text()` rejection — `resultFromPromise` captures both.\n  return resultFromPromise(\n    errorType,\n    surface,\n    (async () => response.clone().text())(),\n    () => ({\n      cause: 'parse' as const,\n      message: 'Failed to read response body as text',\n      statusCode: response.status,\n      contentType: response.headers.get('content-type') ?? 'Not specified',\n    })\n  );\n};\n\nexport const safeParseResponse = (surface: string, response: Response) => {\n  return resultFromPromise(\n    errorType,\n    surface,\n    (async (): Promise<ParsedResponse> => {\n      const header = response.headers.get('content-type');\n      const { type: mimeType } = header\n        ? contentType.parse(header)\n        : { type: 'application/octet-stream' };\n\n      switch (mimeType) {\n        case 'application/json':\n          return {\n            type: 'json' as const,\n            data: (await response.json()) as JsonObject,\n          };\n        case 'application/pdf':\n          return {\n            type: 'pdf' as const,\n            mimeType,\n            data: await response.arrayBuffer(),\n          };\n        case 'application/octet-stream':\n          return {\n            type: 'octet-stream' as const,\n            mimeType,\n            data: await response.arrayBuffer(),\n          };\n        case 'multipart/form-data':\n          return { type: 'formData' as const, data: await response.formData() };\n      }\n\n      if (IMAGE_TYPES.has(mimeType)) {\n        return {\n          type: 'image' as const,\n          mimeType,\n          data: await response.arrayBuffer(),\n        };\n      }\n\n      if (mimeType.startsWith('audio/')) {\n        return {\n          type: 'audio' as const,\n          mimeType,\n          data: await response.arrayBuffer(),\n        };\n      }\n\n      if (mimeType.startsWith('video/')) {\n        return {\n          type: 'video' as const,\n          mimeType,\n          data: await response.arrayBuffer(),\n        };\n      }\n\n      if (mimeType.startsWith('text/')) {\n        return { type: 'text' as const, data: await response.text() };\n      }\n\n      throw new Error(`Unsupported content type: ${header}`);\n    })(),\n    e => ({\n      cause: 'parse' as const,\n      message: e instanceof Error ? e.message : 'Could not parse response',\n      statusCode: response.status,\n      contentType: response.headers.get('content-type') ?? 'Not specified',\n    })\n  );\n};\n\nexport const isFetchError = (error: Error<BaseError>): error is FetchError => {\n  return error.type === errorType;\n};\n"],"mappings":"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","names":[]}

package/dist/esm/{chunk-7KT6UCTT.js → chunk-SLTRGQ7W.js}

@@ -1,7 +1,7 @@
 import {
   REQUEST_FETCH_PARAMS,
   REQUEST_PARAMS
-} from "./chunk-3PYQIEMA.js";
+} from "./chunk-W37JKCLN.js";
 import {
   RequestMethod
 } from "./chunk-LNJIXYCU.js";
@@ -30,7 +30,12 @@ var fetchShape = {
   paymentNetwork: z.enum(paymentNetworks).optional().describe(REQUEST_FETCH_PARAMS.paymentNetwork),
   paymentProtocol: z.enum(paymentProtocols).optional().describe(REQUEST_FETCH_PARAMS.paymentProtocol),
   maxAmount: z.number().positive().optional().describe(REQUEST_FETCH_PARAMS.maxAmount),
-  timeout: z.number().int().positive().optional().describe(REQUEST_PARAMS.timeout)
+  timeout: z.number().int().positive().optional().describe(REQUEST_PARAMS.timeout),
+  stream: z.boolean().optional().describe(REQUEST_FETCH_PARAMS.stream),
+  channelId: z.string().regex(
+    /^0x[0-9a-fA-F]{64}$/,
+    "channelId must be a 0x-prefixed 32-byte hex string"
+  ).optional().describe(REQUEST_FETCH_PARAMS.channelId)
 };
 
 export {
@@ -40,4 +45,4 @@ export {
   paymentProtocols,
   fetchShape
 };
-//# sourceMappingURL=chunk-7KT6UCTT.js.map
+//# sourceMappingURL=chunk-SLTRGQ7W.js.map

package/dist/esm/{chunk-7KT6UCTT.js.map → chunk-SLTRGQ7W.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../../src/shared/request/schemas/core.ts"],"sourcesContent":["import z from 'zod';\n\nimport { REQUEST_PARAMS, REQUEST_FETCH_PARAMS } from '@/shared/descriptions';\nimport { PaymentProtocol } from '@/shared/protocols/types';\nimport { Network } from '@agentcash/networks';\nimport { zodUrl } from '@/shared/url';\n\nimport { RequestMethod } from '../types';\n\nexport const requestMethodValues: readonly RequestMethod[] =\n  Object.values(RequestMethod);\n\nconst methodSchema = z\n  .enum(RequestMethod)\n  .optional()\n  .default(RequestMethod.GET)\n  .describe(REQUEST_PARAMS.method);\n\nexport const coreRequestSchema = z.object({\n  url: zodUrl.describe(REQUEST_PARAMS.url),\n  method: methodSchema,\n});\n\nexport const paymentNetworks: Network[] = [\n  Network.BASE,\n  Network.SOLANA,\n  Network.TEMPO,\n];\n\nexport const paymentProtocols: PaymentProtocol[] = [\n  PaymentProtocol.X402,\n  PaymentProtocol.MPP,\n];\n\nexport const fetchShape = {\n  paymentNetwork: z\n    .enum(paymentNetworks)\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.paymentNetwork),\n  paymentProtocol: z\n    .enum(paymentProtocols)\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.paymentProtocol),\n  maxAmount: z\n    .number()\n    .positive()\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.maxAmount),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(REQUEST_PARAMS.timeout),\n};\n"],"mappings":";;;;;;;;;;;;AAAA,OAAO,OAAO;AASP,IAAM,sBACX,OAAO,OAAO,aAAa;AAE7B,IAAM,eAAe,EAClB,KAAK,aAAa,EAClB,SAAS,EACT,uBAAyB,EACzB,SAAS,eAAe,MAAM;AAE1B,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,KAAK,OAAO,SAAS,eAAe,GAAG;AAAA,EACvC,QAAQ;AACV,CAAC;AAEM,IAAM,kBAA6B;AAAA;AAAA;AAAA;AAI1C;AAEO,IAAM,mBAAsC;AAAA;AAAA;AAGnD;AAEO,IAAM,aAAa;AAAA,EACxB,gBAAgB,EACb,KAAK,eAAe,EACpB,SAAS,EACT,SAAS,qBAAqB,cAAc;AAAA,EAC/C,iBAAiB,EACd,KAAK,gBAAgB,EACrB,SAAS,EACT,SAAS,qBAAqB,eAAe;AAAA,EAChD,WAAW,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,qBAAqB,SAAS;AAAA,EAC1C,SAAS,EACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,eAAe,OAAO;AACpC;","names":[]}
+{"version":3,"sources":["../../src/shared/request/schemas/core.ts"],"sourcesContent":["import z from 'zod';\n\nimport { REQUEST_PARAMS, REQUEST_FETCH_PARAMS } from '@/shared/descriptions';\nimport { PaymentProtocol } from '@/shared/protocols/types';\nimport { Network } from '@agentcash/networks';\nimport { zodUrl } from '@/shared/url';\n\nimport { RequestMethod } from '../types';\n\nexport const requestMethodValues: readonly RequestMethod[] =\n  Object.values(RequestMethod);\n\nconst methodSchema = z\n  .enum(RequestMethod)\n  .optional()\n  .default(RequestMethod.GET)\n  .describe(REQUEST_PARAMS.method);\n\nexport const coreRequestSchema = z.object({\n  url: zodUrl.describe(REQUEST_PARAMS.url),\n  method: methodSchema,\n});\n\nexport const paymentNetworks: Network[] = [\n  Network.BASE,\n  Network.SOLANA,\n  Network.TEMPO,\n];\n\nexport const paymentProtocols: PaymentProtocol[] = [\n  PaymentProtocol.X402,\n  PaymentProtocol.MPP,\n];\n\nexport const fetchShape = {\n  paymentNetwork: z\n    .enum(paymentNetworks)\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.paymentNetwork),\n  paymentProtocol: z\n    .enum(paymentProtocols)\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.paymentProtocol),\n  maxAmount: z\n    .number()\n    .positive()\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.maxAmount),\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .optional()\n    .describe(REQUEST_PARAMS.timeout),\n  stream: z.boolean().optional().describe(REQUEST_FETCH_PARAMS.stream),\n  channelId: z\n    .string()\n    .regex(\n      /^0x[0-9a-fA-F]{64}$/,\n      'channelId must be a 0x-prefixed 32-byte hex string'\n    )\n    .optional()\n    .describe(REQUEST_FETCH_PARAMS.channelId),\n};\n"],"mappings":";;;;;;;;;;;;AAAA,OAAO,OAAO;AASP,IAAM,sBACX,OAAO,OAAO,aAAa;AAE7B,IAAM,eAAe,EAClB,KAAK,aAAa,EAClB,SAAS,EACT,uBAAyB,EACzB,SAAS,eAAe,MAAM;AAE1B,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,KAAK,OAAO,SAAS,eAAe,GAAG;AAAA,EACvC,QAAQ;AACV,CAAC;AAEM,IAAM,kBAA6B;AAAA;AAAA;AAAA;AAI1C;AAEO,IAAM,mBAAsC;AAAA;AAAA;AAGnD;AAEO,IAAM,aAAa;AAAA,EACxB,gBAAgB,EACb,KAAK,eAAe,EACpB,SAAS,EACT,SAAS,qBAAqB,cAAc;AAAA,EAC/C,iBAAiB,EACd,KAAK,gBAAgB,EACrB,SAAS,EACT,SAAS,qBAAqB,eAAe;AAAA,EAChD,WAAW,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,qBAAqB,SAAS;AAAA,EAC1C,SAAS,EACN,OAAO,EACP,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,eAAe,OAAO;AAAA,EAClC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,qBAAqB,MAAM;AAAA,EACnE,WAAW,EACR,OAAO,EACP;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,SAAS,EACT,SAAS,qBAAqB,SAAS;AAC5C;","names":[]}

package/dist/esm/chunk-TX7S7QGG.js

@@ -0,0 +1,146 @@
+import {
+  createTempoClient,
+  mppErr,
+  mppOk,
+  mppResultFromPromise,
+  mppResultFromThrowable,
+  safeGetMppChallenge,
+  sessionCloseFailedErr
+} from "./chunk-FBGNOXFP.js";
+import {
+  safeFetch,
+  safeReadResponseText
+} from "./chunk-RAS5DZPQ.js";
+
+// src/operations/sessions/close.ts
+import { Mppx, tempo as tempoMethod } from "mppx/client";
+import { Session } from "mppx/tempo";
+var DEFAULT_ESCROW_CONTRACT = "0x33b901018174DDabE4841042ab76ba85D4e24f25";
+async function closeMppSession(input, options) {
+  const { surface, wallets } = options;
+  const { channelId, url, cumulativeAmountRaw } = input;
+  const probeResult = await safeFetch(
+    surface,
+    new Request(url, { method: "POST" })
+  );
+  if (probeResult.isErr()) {
+    return mppErr(
+      surface,
+      sessionCloseFailedErr(
+        probeResult.error.message,
+        `Failed to probe ${url} for a session challenge`
+      )
+    );
+  }
+  const probeResponse = probeResult.value;
+  if (probeResponse.status !== 402) {
+    return mppErr(surface, {
+      cause: "mpp_session_close_no_challenge",
+      message: `Expected a 402 session challenge from ${url}, received ${probeResponse.status} ${probeResponse.statusText}. The endpoint may not be MPP-protected or the channel has already been closed.`
+    });
+  }
+  const challengeResult = safeGetMppChallenge(surface, probeResponse);
+  if (challengeResult.isErr()) {
+    return challengeResult;
+  }
+  const challenge = challengeResult.value;
+  if (challenge.intent !== "session") {
+    return mppErr(surface, {
+      cause: "mpp_session_close_no_challenge",
+      message: `${url} returned a ${challenge.method}:${challenge.intent} challenge, not a session challenge.`
+    });
+  }
+  const methodDetails = challenge.request.methodDetails;
+  const escrowContract = methodDetails?.escrowContract ?? DEFAULT_ESCROW_CONTRACT;
+  const cumulativeResult = await resolveCloseCumulative({
+    surface,
+    channelId,
+    escrowContract,
+    cumulativeAmountRaw
+  });
+  if (cumulativeResult.isErr()) {
+    return cumulativeResult;
+  }
+  const cumulativeRaw = cumulativeResult.value;
+  const mppx = Mppx.create({
+    polyfill: false,
+    methods: [
+      tempoMethod({ account: wallets.evm, getClient: createTempoClient })
+    ]
+  });
+  const credentialResult = await mppResultFromPromise(
+    surface,
+    mppx.createCredential(probeResponse, {
+      action: "close",
+      channelId,
+      cumulativeAmountRaw: cumulativeRaw
+    }),
+    (e) => sessionCloseFailedErr(e, "Failed to sign close credential")
+  );
+  if (credentialResult.isErr()) {
+    return credentialResult;
+  }
+  const closeResult = await safeFetch(
+    surface,
+    new Request(url, {
+      method: "POST",
+      headers: { Authorization: credentialResult.value }
+    })
+  );
+  if (closeResult.isErr()) {
+    return mppErr(
+      surface,
+      sessionCloseFailedErr(
+        closeResult.error.message,
+        `Close POST to ${url} failed`
+      )
+    );
+  }
+  const closeResponse = closeResult.value;
+  if (!closeResponse.ok) {
+    const body = await safeReadResponseText(surface, closeResponse).unwrapOr(
+      ""
+    );
+    const detail = body ? `: ${body}` : "";
+    return mppErr(
+      surface,
+      sessionCloseFailedErr(
+        `Server rejected close credential with ${closeResponse.status} ${closeResponse.statusText}${detail}. The cumulative-amount may be below the server's voucher state \u2014 retry with --cumulative-amount-raw set to the server's expected value.`
+      )
+    );
+  }
+  const receiptHeader = closeResponse.headers.get("Payment-Receipt");
+  const receipt = receiptHeader ? Session.Receipt.deserializeSessionReceipt(receiptHeader) : null;
+  return mppOk({
+    channelId,
+    cumulativeAmount: receipt?.spent ?? cumulativeRaw,
+    ...receipt?.txHash ? { transactionHash: receipt.txHash } : {}
+  });
+}
+async function resolveCloseCumulative(args) {
+  const { surface, channelId, escrowContract, cumulativeAmountRaw } = args;
+  if (cumulativeAmountRaw !== void 0) {
+    return mppResultFromThrowable(
+      surface,
+      () => BigInt(cumulativeAmountRaw).toString(),
+      (e) => sessionCloseFailedErr(e, "Invalid cumulativeAmountRaw")
+    );
+  }
+  return mppResultFromPromise(
+    surface,
+    Session.Chain.getOnChainChannel(
+      createTempoClient(),
+      escrowContract,
+      channelId
+    ).then((onChain) => onChain.settled.toString()),
+    (e) => sessionCloseFailedErr(
+      e,
+      `Failed to read on-chain channel state for ${channelId}`
+    )
+  );
+}
+
+export {
+  closeMppSession
+};
+//# sourceMappingURL=chunk-TX7S7QGG.js.map

package/dist/esm/chunk-TX7S7QGG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/operations/sessions/close.ts"],"sourcesContent":["import type { Address, Hex } from 'viem';\n\nimport { Mppx, tempo as tempoMethod } from 'mppx/client';\nimport { Session } from 'mppx/tempo';\n\nimport { safeFetch, safeReadResponseText } from '@/shared/neverthrow/fetch';\nimport {\n  createTempoClient,\n  mppErr,\n  mppOk,\n  mppResultFromPromise,\n  mppResultFromThrowable,\n  safeGetMppChallenge,\n  sessionCloseFailedErr,\n} from '@/shared/protocols/mpp';\n\nimport type { GlobalFlags } from '@/types';\nimport type { Wallets } from '@/wallet';\n\nconst DEFAULT_ESCROW_CONTRACT: Address =\n  '0x33b901018174DDabE4841042ab76ba85D4e24f25';\n\nexport interface CloseSessionInput {\n  channelId: Hex;\n  url: string;\n  cumulativeAmountRaw?: string;\n}\n\nexport interface CloseSessionOptions {\n  surface: string;\n  wallets: Wallets;\n  flags: GlobalFlags;\n}\n\nexport interface CloseSessionResult {\n  channelId: Hex;\n  cumulativeAmount: string;\n  transactionHash?: string;\n}\n\nexport async function closeMppSession(\n  input: CloseSessionInput,\n  options: CloseSessionOptions\n) {\n  const { surface, wallets } = options;\n  const { channelId, url, cumulativeAmountRaw } = input;\n\n  const probeResult = await safeFetch(\n    surface,\n    new Request(url, { method: 'POST' })\n  );\n  if (probeResult.isErr()) {\n    return mppErr(\n      surface,\n      sessionCloseFailedErr(\n        probeResult.error.message,\n        `Failed to probe ${url} for a session challenge`\n      )\n    );\n  }\n  const probeResponse = probeResult.value;\n\n  if (probeResponse.status !== 402) {\n    return mppErr(surface, {\n      cause: 'mpp_session_close_no_challenge',\n      message: `Expected a 402 session challenge from ${url}, received ${probeResponse.status} ${probeResponse.statusText}. The endpoint may not be MPP-protected or the channel has already been closed.`,\n    });\n  }\n\n  const challengeResult = safeGetMppChallenge(surface, probeResponse);\n  if (challengeResult.isErr()) {\n    return challengeResult;\n  }\n  const challenge = challengeResult.value;\n\n  if (challenge.intent !== 'session') {\n    return mppErr(surface, {\n      cause: 'mpp_session_close_no_challenge',\n      message: `${url} returned a ${challenge.method}:${challenge.intent} challenge, not a session challenge.`,\n    });\n  }\n\n  const methodDetails = challenge.request.methodDetails as\n    | { escrowContract?: string }\n    | undefined;\n  const escrowContract = (methodDetails?.escrowContract ??\n    DEFAULT_ESCROW_CONTRACT) as Address;\n\n  const cumulativeResult = await resolveCloseCumulative({\n    surface,\n    channelId,\n    escrowContract,\n    cumulativeAmountRaw,\n  });\n  if (cumulativeResult.isErr()) {\n    return cumulativeResult;\n  }\n  const cumulativeRaw = cumulativeResult.value;\n\n  const mppx = Mppx.create({\n    polyfill: false,\n    methods: [\n      tempoMethod({ account: wallets.evm, getClient: createTempoClient }),\n    ],\n  });\n\n  const credentialResult = await mppResultFromPromise(\n    surface,\n    mppx.createCredential(probeResponse, {\n      action: 'close',\n      channelId,\n      cumulativeAmountRaw: cumulativeRaw,\n    }),\n    e => sessionCloseFailedErr(e, 'Failed to sign close credential')\n  );\n  if (credentialResult.isErr()) {\n    return credentialResult;\n  }\n\n  const closeResult = await safeFetch(\n    surface,\n    new Request(url, {\n      method: 'POST',\n      headers: { Authorization: credentialResult.value },\n    })\n  );\n  if (closeResult.isErr()) {\n    return mppErr(\n      surface,\n      sessionCloseFailedErr(\n        closeResult.error.message,\n        `Close POST to ${url} failed`\n      )\n    );\n  }\n  const closeResponse = closeResult.value;\n\n  if (!closeResponse.ok) {\n    const body = await safeReadResponseText(surface, closeResponse).unwrapOr(\n      ''\n    );\n    const detail = body ? `: ${body}` : '';\n    return mppErr(\n      surface,\n      sessionCloseFailedErr(\n        `Server rejected close credential with ${closeResponse.status} ${closeResponse.statusText}${detail}. The cumulative-amount may be below the server's voucher state — retry with --cumulative-amount-raw set to the server's expected value.`\n      )\n    );\n  }\n\n  const receiptHeader = closeResponse.headers.get('Payment-Receipt');\n  const receipt = receiptHeader\n    ? Session.Receipt.deserializeSessionReceipt(receiptHeader)\n    : null;\n\n  return mppOk<CloseSessionResult>({\n    channelId,\n    cumulativeAmount: receipt?.spent ?? cumulativeRaw,\n    ...(receipt?.txHash ? { transactionHash: receipt.txHash } : {}),\n  });\n}\n\nasync function resolveCloseCumulative(args: {\n  surface: string;\n  channelId: Hex;\n  escrowContract: Address;\n  cumulativeAmountRaw: string | undefined;\n}) {\n  const { surface, channelId, escrowContract, cumulativeAmountRaw } = args;\n\n  if (cumulativeAmountRaw !== undefined) {\n    return mppResultFromThrowable(\n      surface,\n      () => BigInt(cumulativeAmountRaw).toString(),\n      e => sessionCloseFailedErr(e, 'Invalid cumulativeAmountRaw')\n    );\n  }\n\n  return mppResultFromPromise(\n    surface,\n    Session.Chain.getOnChainChannel(\n      createTempoClient(),\n      escrowContract,\n      channelId\n    ).then(onChain => onChain.settled.toString()),\n    e =>\n      sessionCloseFailedErr(\n        e,\n        `Failed to read on-chain channel state for ${channelId}`\n      )\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/esm/{chunk-QOMU3YLK.js → chunk-ULB5PPKW.js}

@@ -4,7 +4,7 @@ import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 function getVersion() {
   if (true) {
-    return "0.14.4";
+    return "0.15.0";
   }
   const __dirname2 = dirname(fileURLToPath(import.meta.url));
   const pkg = JSON.parse(
@@ -23,4 +23,4 @@ export {
   MCP_VERSION,
   INSTALL_PACKAGE_SPECIFIER
 };
-//# sourceMappingURL=chunk-QOMU3YLK.js.map
+//# sourceMappingURL=chunk-ULB5PPKW.js.map

package/dist/esm/{chunk-WRNDLZ3K.js → chunk-VGKAPM5S.js}

@@ -1,9 +1,9 @@
 import {
   MCP_VERSION
-} from "./chunk-QOMU3YLK.js";
+} from "./chunk-ULB5PPKW.js";
 import {
   safeFetchJson
-} from "./chunk-BFOYXXLG.js";
+} from "./chunk-RAS5DZPQ.js";
 import {
   getBaseUrl
 } from "./chunk-U6FRXL3X.js";
@@ -51,4 +51,4 @@ async function submitErrorReport(surface, input, address, dev) {
 export {
   submitErrorReport
 };
-//# sourceMappingURL=chunk-WRNDLZ3K.js.map
+//# sourceMappingURL=chunk-VGKAPM5S.js.map

package/dist/esm/{chunk-3PYQIEMA.js → chunk-W37JKCLN.js}

@@ -39,6 +39,22 @@ var ORIGIN_METADATA = {
   ["https://stablemerch.dev" /* StableMerch */]: {
     title: "StableMerch",
     description: "Create shirts and mugs with custom images and have them shipped to your address."
+  },
+  ["https://stablevoice.dev" /* StableVoice */]: {
+    title: "StableVoice",
+    description: "Text-to-speech with 20+ bundled voices, custom voice cloning, multi-language support (23 languages), mp3/wav output"
+  },
+  ["https://stabletube.dev" /* StableTube */]: {
+    title: "StableTube",
+    description: "YouTube video downloads \u2014 POST a URL, get a direct CDN download link (expires ~6h)"
+  },
+  ["https://stablekey.dev" /* StableKey */]: {
+    title: "StableKey",
+    description: "VFX-grade neural green-screen unmixing (CorridorKey) \u2014 submit a green-screen plate, get alpha + foreground + RGBA outputs"
+  },
+  ["https://stablememes.dev" /* StableMemes */]: {
+    title: "StableMemes",
+    description: "Generate memes \u2014 caption templates, search 1M+ memes, auto-caption, AI meme generation"
   }
 };
 var PRIMARY_ORIGINS = [
@@ -47,7 +63,11 @@ var PRIMARY_ORIGINS = [
   "https://stablestudio.dev" /* StableStudio */,
   "https://stableupload.dev" /* StableUpload */,
   "https://stableemail.dev" /* StableEmail */,
-  "https://stablemerch.dev" /* StableMerch */
+  "https://stablemerch.dev" /* StableMerch */,
+  "https://stablevoice.dev" /* StableVoice */,
+  "https://stabletube.dev" /* StableTube */,
+  "https://stablekey.dev" /* StableKey */,
+  "https://stablememes.dev" /* StableMemes */
 ];
 var DESCRIPTIONS = {
   bridge: {
@@ -133,6 +153,12 @@ Set broad=true to widen the search to include newer, unvetted tools that may not
   getSettings: {
     mcp: `Get current user settings. Returns persisted values from ~/.agentcash/settings.json with defaults applied.`,
     cli: `Get current user settings from ~/.agentcash/settings.json, with defaults applied.`
+  },
+  closeSession: {
+    mcp: `Close an MPP \`tempo:session\` payment channel. Pass the channelId surfaced in a prior fetch's paymentInfo together with the same URL you originally fetched. Signs a close credential with the on-chain settled cumulative amount and POSTs it to the server, returning the on-chain settlement transaction hash when available. Use this when you want to finalize a channel rather than leaving it open for the server to settle on its own schedule.`,
+    cli: `Close an MPP session payment channel. Provide the channelId (printed in a prior fetch's paymentInfo) and the endpoint URL the channel was opened against. Reads on-chain channel state for the cumulative settled amount, signs a close credential, and POSTs it to the server.`,
+    epilogue: `agentcash sessions close 0xabc... --url https://example.dev/api/stream
+Pass --cumulative-amount-raw <atomic-units> only when the server reports vouchers above the on-chain cumulative.`
   }
 };
 var WORKFLOW = [
@@ -173,7 +199,9 @@ var REQUEST_FETCH_PARAMS = {
   ...REQUEST_PARAMS,
   paymentProtocol: "Payment protocol to use when payment is required. If not specified, the payment protocol will be auto-detected.",
   paymentNetwork: "Chain to use for SIWX and payment when applicable. If not specified, the network will be auto-detected.",
-  maxAmount: "Maximum amount (in USD) to pay per request. Aborts if the endpoint requests more. Defaults to $5. Pass a higher value for known-expensive endpoints."
+  maxAmount: "Maximum amount (in USD) to pay per request. Aborts if the endpoint requests more. Defaults to $5. Pass a higher value for known-expensive endpoints.",
+  stream: "Escape hatch for streaming MPP session endpoints. Typically unnecessary \u2014 a correctly configured server advertises `streaming: true` in its 402 challenge and the signer handles it automatically. Only pass this when the response is actually a stream AND the server fails to advertise it; otherwise long streams may stall once the initial deposit is exhausted.",
+  channelId: "Reuse an existing MPP `tempo:session` payment channel instead of opening a new one. Pass the `channelId` surfaced in a prior fetch's paymentInfo. The channel must still have positive on-chain deposit and not be finalized; if it cannot be recovered, the request fails fast rather than silently opening a new channel. 0x-prefixed 32-byte hex string. Ignored by x402 (non-session) endpoints."
 };
 var TOOL_PARAMS = {
   bridge: {
@@ -225,6 +253,16 @@ var TOOL_PARAMS = {
     url: "The origin URL to discover endpoints on (e.g. https://stableenrich.dev)",
     includeGuidance: "Request the origin's usage guidance. true=always include, false=never include, omit=auto (included when compact). Guidance explains how to compose multiple endpoints and covers edge cases."
   },
+  closeSession: {
+    channelId: "The payment-channel id to close (the `channelId` field from a prior fetch's paymentInfo).",
+    url: "The endpoint URL the channel was opened against (the same URL passed to the original fetch).",
+    cumulativeAmountRaw: 'Optional override for the cumulative amount the close credential attests to, in raw atomic units (e.g. "12345" = 0.012345 USDC at 6 decimals). Defaults to the on-chain settled amount. Provide this only when the server has accepted vouchers above the on-chain cumulative.',
+    output: {
+      channelId: "The closed channel id",
+      cumulativeAmount: "The cumulative amount (raw atomic units) the channel was settled at",
+      transactionHash: "Settlement transaction hash, when the server returns one in the Payment-Receipt header"
+    }
+  },
   reportError: {
     tool: "MCP tool name",
     resource: "Resource URL",
@@ -248,4 +286,4 @@ export {
   REQUEST_FETCH_PARAMS,
   TOOL_PARAMS
 };
-//# sourceMappingURL=chunk-3PYQIEMA.js.map
+//# sourceMappingURL=chunk-W37JKCLN.js.map

package/dist/esm/chunk-W37JKCLN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/descriptions.ts"],"sourcesContent":["/**\n * Single source of truth for all LLM-facing text in the MCP package.\n *\n * `DESCRIPTIONS` covers every tool with both an `mcp` variant (detailed,\n * AI-audience) and a `cli` variant (concise, human-readable for --help).\n * `serverInstructions` is shared across both surfaces.\n *\n * Additional exports cover parameter/output schema descriptions, origin\n * metadata, and prompt content — all LLM-facing text in one place.\n */\n\nimport type { UserOrigin } from './user-origins';\nimport { Origin } from './origins';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Origin metadata (used for MCP resource registration descriptions)\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const ORIGIN_METADATA: Record<\n  string,\n  { title: string; description: string }\n> = {\n  [Origin.StableEnrich]: {\n    title: 'StableEnrich',\n    description:\n      'People/org search, Google Maps, Exa web search, LinkedIn data, Firecrawl scrape, WhitePages, email enrichment',\n  },\n  [Origin.StableSocial]: {\n    title: 'StableSocial',\n    description: 'Social media data for TikTok, Instagram, Facebook, Reddit',\n  },\n  [Origin.StableStudio]: {\n    title: 'StableStudio',\n    description: 'Generate and edit images and videos',\n  },\n  [Origin.StableUpload]: {\n    title: 'StableUpload',\n    description: 'Pay to upload files, get a permanent download URL.',\n  },\n  [Origin.StableEmail]: {\n    title: 'StableEmail',\n    description: 'Send emails',\n  },\n  [Origin.X402Scan]: {\n    title: 'X402 Scan',\n    description: 'x402 protocol explorer',\n  },\n  [Origin.Shirt]: {\n    title: 'Shirt',\n    description: 'Shirt.sh',\n  },\n  [Origin.X402Puppet]: {\n    title: 'X402 Puppet',\n    description: 'Browser automation',\n  },\n  [Origin.X402Facilitator]: {\n    title: 'X402 Facilitator',\n    description: 'Payment facilitation',\n  },\n  [Origin.StableMerch]: {\n    title: 'StableMerch',\n    description:\n      'Create shirts and mugs with custom images and have them shipped to your address.',\n  },\n  [Origin.StableVoice]: {\n    title: 'StableVoice',\n    description:\n      'Text-to-speech with 20+ bundled voices, custom voice cloning, multi-language support (23 languages), mp3/wav output',\n  },\n  [Origin.StableTube]: {\n    title: 'StableTube',\n    description:\n      'YouTube video downloads — POST a URL, get a direct CDN download link (expires ~6h)',\n  },\n  [Origin.StableKey]: {\n    title: 'StableKey',\n    description:\n      'VFX-grade neural green-screen unmixing (CorridorKey) — submit a green-screen plate, get alpha + foreground + RGBA outputs',\n  },\n  [Origin.StableMemes]: {\n    title: 'StableMemes',\n    description:\n      'Generate memes — caption templates, search 1M+ memes, auto-caption, AI meme generation',\n  },\n};\n\nexport const PRIMARY_ORIGINS = [\n  Origin.StableEnrich,\n  Origin.StableSocial,\n  Origin.StableStudio,\n  Origin.StableUpload,\n  Origin.StableEmail,\n  Origin.StableMerch,\n  Origin.StableVoice,\n  Origin.StableTube,\n  Origin.StableKey,\n  Origin.StableMemes,\n] as const;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Tool descriptions — { mcp, cli } per tool + shared serverInstructions\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const DESCRIPTIONS = {\n  bridge: {\n    toolNames: {\n      cli: 'bridge',\n      mcp: 'bridge',\n    },\n    title: 'Bridge Between Networks',\n    mcp: `Bridge USDC between supported networks using the current wallet. Requires a source network, destination network, and amount. Use this when funds are on one supported network and the user needs them moved to another. Bridging is subject to fees.`,\n    cli: `Bridge USDC between supported networks using the current wallet. Requires --from, --to, and --amount. Bridging is subject to fees.`,\n  },\n\n  getBalance: {\n    mcp: `Get your total USDC balance across all supported networks. Auto-creates the wallet on first use (~/.agentcash/wallet.json). Use this before paid API calls to confirm you have funds available.`,\n    cli: `Get your total USDC balance across all supported networks. Creates the wallet on first use (~/.agentcash/wallet.json). Use this before paid API calls to confirm you have funds available.`,\n  },\n\n  fetch: {\n    mcp: `HTTP fetch with automatic authentication and payment handling. Makes the request, retries with SIGN-IN-WITH-X when the route exposes a SIWX challenge, and only pays if the route still returns 402. Returns response data along with payment details (price, tx hash) if a payment was made.\\n\\nFor endpoints you haven't called before in this session, you MUST call check_endpoint_schema first to confirm the request body schema. Skipping this causes 400 errors from wrong field names.`,\n    cli: `HTTP fetch with automatic authentication and payment handling. If the endpoint returns 402, agentcash attempts authentication first and only falls back to payment if the route still requires it. Run 'check <url>' first to confirm the request body schema; skipping this causes 400 errors from wrong field names.`,\n    epilogue: `Workflow: check <url> → fetch <url> -m POST -b '{\"field\":\"value\"}'\\nAuth mode is advisory only; fetch handles both SIWX and paid routes.`,\n  },\n\n  fetchWithAuth: {\n    mcp: `Deprecated alias for fetch. Uses the same unified flow: probe the route, attempt SIWX when available, and only pay if the route still returns 402.\\n\\nFor new integrations, prefer fetch.`,\n    cli: `Deprecated alias for fetch. Uses the same unified auth-and-payment flow, but new integrations should call 'fetch' directly.`,\n    epilogue: `Deprecated: use agentcash fetch <url>. This alias is kept for compatibility.`,\n  },\n\n  listAccounts: {\n    mcp: `List wallet accounts for each supported network. Returns the network, address, balance, and deposit link for every supported network so you can see where to fund the wallet. Auto-creates the wallet on first use (~/.agentcash/wallet.json). If onboardingCta is present, show its message to the user — it means they haven't onboarded yet and need to either visit the onboard link or deposit directly.`,\n    cli: `List wallet accounts for each supported network, including network, address, balance, and deposit link. Creates the wallet on first use (~/.agentcash/wallet.json). Use this when you need the per-network funding addresses and deposit links.`,\n  },\n\n  getWalletInfo: {\n    mcp: `Legacy combined wallet view. Returns both the total balance and the per-network account list. Prefer calling get_balance for available funds and list_accounts when you need network-specific addresses or deposit links.`,\n    cli: `Legacy combined wallet view. Returns both the total balance and the per-network account list. Prefer 'balance' for available funds and 'accounts' for network-specific addresses or deposit links.`,\n  },\n\n  checkEndpointSchema: {\n    mcp: [\n      `Get the input/output schema and auth mode (paid or SIWX) for a single endpoint.`,\n      `Call this to see exactly what fields the request body expects and what the response contains.`,\n      `Returns the schema from the origin's OpenAPI spec. Optionally pass sample_input_body to probe the endpoint live (without payment) for an exact price quote — do this when pricing is dynamic (range-based or variable), or when you're unsure about the input schema. Treat auth mode as advisory: fetch handles both SIWX and paid routes.`,\n    ].join('\\n\\n'),\n    cli: `Get the input/output schema and auth mode (paid or SIWX) for an endpoint. Returns exact field names from the OpenAPI spec — call this before 'fetch' to avoid 400 errors. Pass --body to probe the endpoint live for an exact price quote when pricing is dynamic or unclear.`,\n    epilogue: `Auth mode is advisory:\\n  paid  → agentcash fetch <url>\\n  SIWX  → agentcash fetch <url>`,\n  },\n\n  discoverApiEndpoints: {\n    mcp: [\n      `List available endpoints at an API origin. Returns endpoint URLs with descriptions of what each does and the auth mode for each (paid or SIWX). Works with any origin, not just the registered ones.`,\n      `Call this when you need to see what routes are available at an origin — whether it's one of the registered origins or any other origin you've identified as useful. Treat the auth mode as guidance for what the route may require; fetch handles both SIWX and payment.`,\n      `The response always indicates whether guidance is available. Guidance is documentation published by the API provider explaining how endpoints work together, edge cases, and usage tips. compact guidance is included automatically; set include_guidance=true to force-include full usage documentation when you need to compose two or more endpoints or need clarification on how the origin works.`,\n    ].join('\\n\\n'),\n    cli: `List available endpoints at an API origin with descriptions and auth modes (paid or SIWX). Works with any origin, not just registered ones. Add --include-guidance for full provider docs when composing multiple endpoints or when usage is unclear. Fetch handles both auth modes.`,\n    epilogue: `Registered origins:\\n${PRIMARY_ORIGINS.flatMap(o => (ORIGIN_METADATA[o] ? [`  ${o} — ${ORIGIN_METADATA[o].description}`] : [])).join('\\n')}`,\n  },\n\n  redeemInvite: {\n    mcp: `Redeem an invite code for free USDC on Base. One-time use per code. Returns amount received and transaction hash. Use get_balance after to verify funds, or list_accounts if you need the per-network deposit links as well.`,\n    cli: `Redeem an invite code for free USDC on Base. One-time use per code. Run 'balance' after to verify the balance landed.`,\n  },\n\n  try: {\n    cli: `Fetch a new origin for its resources and return a prompt guiding the user through the process of calling the first endpoint.`,\n  },\n\n  search: {\n    mcp: `Search for relevant paid API services by describing what you need in natural language. Returns the best matching origins with endpoint details and pricing. The top result includes the full input/output schema so you can call it immediately via fetch.\n\nOnly use this when you DON'T already know which registered origin to use. If the task clearly maps to a registered origin (e.g. people search → StableEnrich, image generation → StableStudio), skip search and go straight to discover_api_endpoints on that origin. Search is for discovering NEW or UNKNOWN capabilities outside the registered origins.\n\nSet broad=true to widen the search to include newer, unvetted tools that may not have established trust. Use this if the default results don't cover what you need.`,\n    cli: `Search for paid API services by natural language query. Returns matching origins with endpoints and pricing. Use --broad to include newer, unvetted tools that may not have established trust.`,\n  },\n\n  reportError: {\n    mcp: `EMERGENCY ONLY. Report critical MCP tool bugs. Do NOT use for normal errors (balance, network, 4xx) — those are recoverable.`,\n    cli: `Report a critical bug to the agentcash team (emergency only). Do NOT use for normal errors like low balance, network timeouts, or 4xx responses — those are recoverable without filing a report.`,\n  },\n\n  updateSettings: {\n    mcp: `Update user settings (persisted to ~/.agentcash/settings.json). Currently supports maxAmount — the maximum USD amount allowed per fetch request. If a fetch response requests more than this, the payment is rejected. Returns the current settings after applying changes.`,\n    cli: `Update user settings (persisted to ~/.agentcash/settings.json). Currently supports maxAmount, which caps how much a single fetch request can spend.`,\n  },\n\n  getSettings: {\n    mcp: `Get current user settings. Returns persisted values from ~/.agentcash/settings.json with defaults applied.`,\n    cli: `Get current user settings from ~/.agentcash/settings.json, with defaults applied.`,\n  },\n\n  closeSession: {\n    mcp: `Close an MPP \\`tempo:session\\` payment channel. Pass the channelId surfaced in a prior fetch's paymentInfo together with the same URL you originally fetched. Signs a close credential with the on-chain settled cumulative amount and POSTs it to the server, returning the on-chain settlement transaction hash when available. Use this when you want to finalize a channel rather than leaving it open for the server to settle on its own schedule.`,\n    cli: `Close an MPP session payment channel. Provide the channelId (printed in a prior fetch's paymentInfo) and the endpoint URL the channel was opened against. Reads on-chain channel state for the cumulative settled amount, signs a close credential, and POSTs it to the server.`,\n    epilogue: `agentcash sessions close 0xabc... --url https://example.dev/api/stream\\nPass --cumulative-amount-raw <atomic-units> only when the server reports vouchers above the on-chain cumulative.`,\n  },\n} as const;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Dynamic server instructions (includes user-added origins at runtime)\n// ─────────────────────────────────────────────────────────────────────────────\n\nconst WORKFLOW = [\n  `Workflow:`,\n  `1. If you don't already know your balance, call get_balance. You need a balance for paid endpoints. SIWX endpoints don't require one. You don't need to call this every turn, just before your first paid call or whenever you're unsure.`,\n  `2. If the balance is zero, or if the user needs a funding link or wallet addresses, call list_accounts and share the relevant deposit link. If onboardingCta is present, show it to the user.`,\n  `3. If the task doesn't clearly map to any registered origin above, call search() to find relevant APIs. Skip this step when you already know the right origin — go straight to step 4.`,\n  `4. Call discover_api_endpoints() to get the endpoint index — a list of available routes with descriptions and auth modes. The auth mode is advisory and tells you what the route may require.`,\n  `5. Call check_endpoint_schema() to get the exact input/output schema and auth mode for the endpoint you want to call, so you know what fields to pass and what the response contains. Both discover_api_endpoints and check_endpoint_schema return the auth mode.`,\n  `6. Call fetch with the correct input schema. It will attempt SIWX first when available and only pay if the route still returns 402.`,\n].join('\\n');\n\nexport function buildServerInstructions(\n  userOrigins: UserOrigin[] = []\n): string {\n  const allOrigins = [\n    ...userOrigins.map(o => `  - ${o.url} — ${o.description}`),\n    ...PRIMARY_ORIGINS.flatMap(o =>\n      ORIGIN_METADATA[o] ? [`  - ${o} — ${ORIGIN_METADATA[o].description}`] : []\n    ),\n  ].join('\\n');\n\n  return [\n    `AgentCash lets you call protected APIs — handling both x402 micropayments and SIWX authentication seamlessly. It manages a USDC wallet for paid endpoints and signs wallet proofs for identity-gated endpoints through fetch.`,\n    `The user has installed agentcash because they want to use paid and SIWX-protected APIs as their preferred way to accomplish related tasks.`,\n    `Paid endpoints require a wallet balance. SIWX endpoints are free — they only require a wallet identity.`,\n    `If a task could be accomplished by one of these registered origins, run the workflow below. If you're unsure which origin to use, or the task doesn't match a registered origin, call search() to find relevant APIs.\\n${allOrigins}`,\n    `discover_api_endpoints also works with any origin beyond this list. If you identify another origin that would be useful for a task, you can use it.`,\n    WORKFLOW,\n    `If you need to compose multiple endpoints in sequence, or anything about the origin's capabilities is unclear, call discover_api_endpoints with include_guidance=true to retrieve the origin's full usage documentation.`,\n  ].join('\\n\\n');\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Shared request schema parameter descriptions\n// (used by fetch, fetch_with_auth tools)\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const REQUEST_PARAMS = {\n  url: 'The endpoint URL',\n  method: 'HTTP method. Defaults to GET for fetch operations.',\n  body: 'Raw request body string. Passed through to the underlying fetch call as-is.',\n  headers:\n    'Additional headers to include. Each entry must be a string in \"Name: value\" format.',\n  timeout: 'Request timeout in milliseconds',\n} as const;\n\nexport const REQUEST_FETCH_PARAMS = {\n  ...REQUEST_PARAMS,\n  paymentProtocol:\n    'Payment protocol to use when payment is required. If not specified, the payment protocol will be auto-detected.',\n  paymentNetwork:\n    'Chain to use for SIWX and payment when applicable. If not specified, the network will be auto-detected.',\n  maxAmount:\n    'Maximum amount (in USD) to pay per request. Aborts if the endpoint requests more. Defaults to $5. Pass a higher value for known-expensive endpoints.',\n  stream:\n    'Escape hatch for streaming MPP session endpoints. Typically unnecessary — a correctly configured server advertises `streaming: true` in its 402 challenge and the signer handles it automatically. Only pass this when the response is actually a stream AND the server fails to advertise it; otherwise long streams may stall once the initial deposit is exhausted.',\n  channelId:\n    \"Reuse an existing MPP `tempo:session` payment channel instead of opening a new one. Pass the `channelId` surfaced in a prior fetch's paymentInfo. The channel must still have positive on-chain deposit and not be finalized; if it cannot be recovered, the request fails fast rather than silently opening a new channel. 0x-prefixed 32-byte hex string. Ignored by x402 (non-session) endpoints.\",\n} as const;\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Per-tool parameter and output schema descriptions\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport const TOOL_PARAMS = {\n  bridge: {\n    from: 'The network to bridge from',\n    to: 'The network to bridge to',\n    amount: 'The amount of USDC to bridge',\n  },\n  fetch: REQUEST_FETCH_PARAMS,\n  fetchWithAuth: REQUEST_FETCH_PARAMS,\n  checkEndpointSchema: {\n    ...REQUEST_PARAMS,\n    method:\n      'HTTP method to check. If omitted, all methods declared in the spec are returned.',\n    body: 'Optional. A sample request body to probe the endpoint live (without payment) for exact pricing. Use when pricing is range-based or quote-based, or when you need to verify the input schema. Omit to get the static schema and advisory pricing from the spec.',\n  },\n  try: {\n    url: 'The origin URL to explore',\n  },\n  add: {\n    url: 'The origin URL to add',\n  },\n\n  listAccounts: {\n    output: {\n      accounts: 'Wallet accounts for each supported network',\n      address: 'Wallet address for this network',\n      balance: 'USDC balance on this network',\n      network: 'Supported payment network name',\n      isNewWallet: 'Whether the wallet is new and needs to be funded',\n      depositLink:\n        'Link to deposit USDC directly into the wallet for this network',\n      onboardingCta:\n        'Present when the user has not yet redeemed an invite code. Show the message to the user — it directs them to onboard or deposit.',\n      onboardingCtaOnboardLink: 'Link to the onboarding page',\n      onboardingCtaDepositLink: 'Link to deposit USDC directly',\n      onboardingCtaMessage: 'Human-readable CTA to show the user',\n    },\n  },\n\n  redeemInvite: {\n    code: 'The invite code',\n    output: {\n      amount: 'Amount with unit (e.g., \"5 USDC\")',\n      txHash: 'Transaction hash on Base',\n    },\n  },\n\n  search: {\n    query:\n      'Natural language description of what you need (e.g. \"send physical mail\", \"generate music\", \"flight prices\")',\n    broad:\n      'Include broader results that may contain newer, unvetted tools. Default is false.',\n    limit: 'Maximum number of results to return (1-50). Default is 10.',\n    page: 'Page number for pagination. Default is 1.',\n  },\n\n  discoverApiEndpoints: {\n    url: 'The origin URL to discover endpoints on (e.g. https://stableenrich.dev)',\n    includeGuidance:\n      \"Request the origin's usage guidance. true=always include, false=never include, omit=auto (included when compact). Guidance explains how to compose multiple endpoints and covers edge cases.\",\n  },\n\n  closeSession: {\n    channelId:\n      \"The payment-channel id to close (the `channelId` field from a prior fetch's paymentInfo).\",\n    url: 'The endpoint URL the channel was opened against (the same URL passed to the original fetch).',\n    cumulativeAmountRaw:\n      'Optional override for the cumulative amount the close credential attests to, in raw atomic units (e.g. \"12345\" = 0.012345 USDC at 6 decimals). Defaults to the on-chain settled amount. Provide this only when the server has accepted vouchers above the on-chain cumulative.',\n    output: {\n      channelId: 'The closed channel id',\n      cumulativeAmount:\n        'The cumulative amount (raw atomic units) the channel was settled at',\n      transactionHash:\n        'Settlement transaction hash, when the server returns one in the Payment-Receipt header',\n    },\n  },\n\n  reportError: {\n    tool: 'MCP tool name',\n    resource: 'Resource URL',\n    summary: '1-2 sentence summary',\n    errorMessage: 'Error message',\n    stack: 'Stack trace',\n    fullReport: 'Detailed report with context, logs, repro steps',\n    output: {\n      reportId: 'Unique report ID for tracking',\n      message: 'Confirmation message',\n    },\n  },\n} as const;\n"],"mappings":"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","names":[]}

package/dist/esm/{chunk-TTAO2EJK.js → chunk-YPFBBTA2.js}

@@ -7,4 +7,4 @@ var BLACKLISTED_ORIGINS = [
 export {
   BLACKLISTED_ORIGINS
 };
-//# sourceMappingURL=chunk-TTAO2EJK.js.map
+//# sourceMappingURL=chunk-YPFBBTA2.js.map

package/dist/esm/chunk-YPFBBTA2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/origins.ts"],"sourcesContent":["/**\n * Known x402-protected API origins.\n * Using const enum so values are inlined at build time.\n */\nexport const enum Origin {\n  StableEnrich = 'https://stableenrich.dev',\n  StableSocial = 'https://stablesocial.dev',\n  StableStudio = 'https://stablestudio.dev',\n  StableUpload = 'https://stableupload.dev',\n  StableEmail = 'https://stableemail.dev',\n  StableVoice = 'https://stablevoice.dev',\n  StableTube = 'https://stabletube.dev',\n  StableKey = 'https://stablekey.dev',\n  StableMemes = 'https://stablememes.dev',\n  X402Scan = 'https://x402scan.com',\n  Shirt = 'https://shirt.sh',\n  X402Puppet = 'https://x402puppet.com',\n  X402Facilitator = 'https://x402facilitator.com',\n  StableMerch = 'https://stablemerch.dev',\n}\n\n/**\n * Origins that are no longer available and should be rejected.\n */\nexport const BLACKLISTED_ORIGINS = [\n  'https://twit.sh',\n  'https://x402.twit.sh',\n] as const;\n"],"mappings":";AAwBO,IAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AACF;","names":[]}

package/dist/esm/{discover-TE2BZJMA.js → discover-TXEJNB5A.js}

@@ -1,16 +1,16 @@
 import {
   discoverResources
-} from "./chunk-L4U6AJW3.js";
-import "./chunk-3PYQIEMA.js";
+} from "./chunk-K3WB4R2P.js";
+import "./chunk-W37JKCLN.js";
 import "./chunk-FB5CMO3J.js";
 import "./chunk-U6FRXL3X.js";
+import "./chunk-QZCSZB7E.js";
 import {
   errorResponse,
   outputAndExit,
   successResponse
 } from "./chunk-7EBJ4BCH.js";
-import "./chunk-QZCSZB7E.js";
-import "./chunk-TTAO2EJK.js";
+import "./chunk-YPFBBTA2.js";
 import "./chunk-YWNBUUBR.js";
 import "./chunk-ITCDZXBZ.js";
 
@@ -37,4 +37,4 @@ var discoverCommand = async (input) => {
 export {
   discoverCommand
 };
-//# sourceMappingURL=discover-TE2BZJMA.js.map
+//# sourceMappingURL=discover-TXEJNB5A.js.map