@mixrpay/agent-sdk 0.8.8 → 0.9.5

package/dist/index.js

@@ -1,4365 +1,31 @@
-// src/session-key.ts
-import {
-  privateKeyToAccount,
-  signTypedData,
-  signMessage as viemSignMessage
-} from "viem/accounts";
+export{c as deleteCredentials,e as getCredentialsFilePath,d as hasCredentials,b as loadCredentials,a as saveCredentials}from'./chunk-IBXQMJ7G.js';import {fileURLToPath}from'url';import {join,dirname}from'path';import {privateKeyToAccount,signMessage,generatePrivateKey,signTypedData}from'viem/accounts';import {createWalletClient,http,parseUnits,encodeFunctionData}from'viem';import {base}from'viem/chains';import {existsSync,mkdirSync,writeFileSync,chmodSync,readFileSync}from'fs';import {homedir}from'os';var l=class extends Error{code;retryAfterMs;constructor(e,t="MIXRPAY_ERROR",s){super(e),this.name="MixrPayError",this.code=t,this.retryAfterMs=s,Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor);}isRetryable(){return  false}},S=class extends l{required;available;topUpUrl;constructor(e,t){let s=e-t;super(`Insufficient balance: need $${e.toFixed(2)}, have $${t.toFixed(2)} (short $${s.toFixed(2)}). Top up your wallet to continue.`,"INSUFFICIENT_BALANCE"),this.name="InsufficientBalanceError",this.required=e,this.available=t,this.topUpUrl="https://mixrpay.com/manage/wallet";}},$=class extends l{expiredAt;constructor(e){super(`Session key expired at ${e}. Request a new session key from the wallet owner at https://mixrpay.com/manage/invites`,"SESSION_KEY_EXPIRED"),this.name="SessionKeyExpiredError",this.expiredAt=e;}},v=class extends l{limitType;limit;attempted;constructor(e,t,s){let a={per_tx:"Per-transaction",daily:"Daily",total:"Total",client_max:"Client-side"}[e]||e,r=e==="daily"?"Wait until tomorrow or request a higher limit.":e==="client_max"?"Increase maxPaymentUsd in your AgentWallet configuration.":"Request a new session key with a higher limit.";super(`${a} spending limit exceeded: limit is $${t.toFixed(2)}, attempted $${s.toFixed(2)}. ${r}`,"SPENDING_LIMIT_EXCEEDED"),this.name="SpendingLimitExceededError",this.limitType=e,this.limit=t,this.attempted=s;}isRetryable(){return this.limitType==="daily"}},A=class extends l{reason;txHash;constructor(e,t){let s=`Payment failed: ${e}`;t&&(s+=` (tx: ${t} - check on basescan.org)`),super(s,"PAYMENT_FAILED"),this.name="PaymentFailedError",this.reason=e,this.txHash=t;}isRetryable(){return  true}},_=class extends l{reason;constructor(e="Invalid session key format"){super(`${e}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from https://mixrpay.com/manage/invites`,"INVALID_SESSION_KEY"),this.name="InvalidSessionKeyError",this.reason=e;}},k=class extends l{reason;constructor(e){super(`x402 protocol error: ${e}. This may indicate a server configuration issue. If the problem persists, contact the API provider.`,"X402_PROTOCOL_ERROR"),this.name="X402ProtocolError",this.reason=e;}isRetryable(){return  true}},C=class extends l{sessionId;expiredAt;constructor(e,t){super(`Session ${e} has expired${t?` at ${t}`:""}. A new session will be created automatically on your next request.`,"SESSION_EXPIRED"),this.name="SessionExpiredError",this.sessionId=e,this.expiredAt=t;}},U=class extends l{sessionId;limit;requested;remaining;constructor(e,t,s,n){super(`Session spending limit exceeded: limit is $${e.toFixed(2)}, requested $${t.toFixed(2)}, remaining $${s.toFixed(2)}. Create a new session with a higher limit to continue.`,"SESSION_LIMIT_EXCEEDED"),this.name="SessionLimitExceededError",this.sessionId=n,this.limit=e,this.requested=t,this.remaining=s;}},P=class extends l{sessionId;constructor(e){super(`Session ${e} not found. It may have been deleted or never existed. Create a new session with getOrCreateSession().`,"SESSION_NOT_FOUND"),this.name="SessionNotFoundError",this.sessionId=e;}},I=class extends l{sessionId;reason;constructor(e,t){super(`Session ${e} has been revoked${t?`: ${t}`:""}. Create a new session with getOrCreateSession().`,"SESSION_REVOKED"),this.name="SessionRevokedError",this.sessionId=e,this.reason=t;}},D=class extends l{attempted;allowedPatterns;constructor(e,t){let s=t.slice(0,3).join(", "),n=t.length>3?"...":"";super(`Payment to "${e}" not allowed. Session allowlist: ${s}${n}. Update the session allowlist or create a new session.`,"MERCHANT_NOT_ALLOWED"),this.name="MerchantNotAllowedError",this.attempted=e,this.allowedPatterns=t;}},M=class extends l{constructor(e=6e4,t){super(t||`Rate limit exceeded. Please wait ${Math.ceil(e/1e3)} seconds before retrying.`,"RATE_LIMIT_EXCEEDED",e),this.name="RateLimitError";}isRetryable(){return  true}},N=class extends l{reason;constructor(e,t){super(`Network error: ${e}. Check your connection and try again.`,"NETWORK_ERROR",5e3),this.name="NetworkError",this.reason=e,t?.stack&&(this.stack=t.stack);}isRetryable(){return  true}},L=class extends l{reason;statusCode;constructor(e,t=401){super(`Authentication failed: ${e}`,t===401?"UNAUTHORIZED":"FORBIDDEN"),this.name="AuthenticationError",this.reason=e,this.statusCode=t;}isRetryable(){return  false}};function ue(d){return d instanceof l}function ge(d){return d instanceof l||d instanceof Error?d.message:String(d)}var ye={8453:"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",84532:"0x036CbD53842c5426634e7929541eC2318f3dCF7e"},fe={name:"USD Coin",version:"2"},we={TransferWithAuthorization:[{name:"from",type:"address"},{name:"to",type:"address"},{name:"value",type:"uint256"},{name:"validAfter",type:"uint256"},{name:"validBefore",type:"uint256"},{name:"nonce",type:"bytes32"}]},O=class d{privateKey;account;address;isTest;constructor(e,t){this.privateKey=e,this.account=privateKeyToAccount(e),this.address=this.account.address,this.isTest=t;}toString(){return `${this.isTest?"sk_test_":"sk_live_"}${this.privateKey.slice(2)}`}get privateKeyHex(){return this.privateKey.slice(2)}get rawPrivateKey(){return this.privateKey}static fromString(e){let t=/^sk_(live|test)_([a-fA-F0-9]{64})$/,s=e.match(t);if(!s)throw new _("Session key must be in format sk_live_{64_hex} or sk_test_{64_hex}");let n=s[1],a=s[2];try{let r=`0x${a}`;return new d(r,n==="test")}catch(r){throw new _(`Failed to decode session key: ${r}`)}}async signTransferAuthorization(e,t){return signTypedData({privateKey:this.privateKey,domain:e,types:we,primaryType:"TransferWithAuthorization",message:t})}async signMessage(e){return signMessage({privateKey:this.privateKey,message:e})}getDefaultChainId(){return this.isTest?84532:8453}};function X(d){let e=ye[d.chainId];if(!e)throw new Error(`USDC not supported on chain ${d.chainId}`);let t={...fe,chainId:d.chainId,verifyingContract:e},s={from:d.fromAddress,to:d.toAddress,value:d.value,validAfter:d.validAfter,validBefore:d.validBefore,nonce:d.nonce};return {domain:t,message:s}}function F(){let d=new Uint8Array(32);return crypto.getRandomValues(d),`0x${Array.from(d).map(e=>e.toString(16).padStart(2,"0")).join("")}`}function be(d,e){return `MixrPay:${d}:${e.toLowerCase()}`}async function Y(d){let e=Date.now(),t=be(e,d.address),s=await d.signMessage(t);return {address:d.address,timestamp:e,signature:s}}var ve="0.9.2",z=".config/mixrpay",ke="wallet.json";function Z(){let d=process.env.MIXRPAY_WORKSPACE_DIR||process.env.OPENCLAW_WORKSPACE_DIR;return d?join(d,z):join(homedir(),z)}function R(){return join(Z(),ke)}async function W(d,e){let t=Z(),s=R();existsSync(t)||mkdirSync(t,{recursive:true,mode:448});let n={address:e.toLowerCase(),privateKey:d,createdAt:new Date().toISOString(),sdkVersion:ve};writeFileSync(s,JSON.stringify(n,null,2),{encoding:"utf-8",mode:384});try{chmodSync(s,384);}catch{}}async function K(){let d=process.env.MIXRPAY_WALLET_KEY;if(d){if(d.startsWith("0x")&&d.length===66)return d;if(d.length===64)return `0x${d}`;console.warn("[MixrPay] MIXRPAY_WALLET_KEY has invalid format, ignoring");}let e=R();if(!existsSync(e))return null;try{let t=readFileSync(e,"utf-8"),s=JSON.parse(t);return !s.privateKey||!s.privateKey.startsWith("0x")?(console.warn("[MixrPay] Wallet file has invalid format"),null):s.privateKey}catch(t){return console.warn("[MixrPay] Failed to read wallet file:",t),null}}async function Te(){let d=R();if(!existsSync(d)){let e=process.env.MIXRPAY_WALLET_KEY;return e&&(e.startsWith("0x")?e:`0x${e}`).length===66,null}try{let e=readFileSync(d,"utf-8");return JSON.parse(e)}catch{return null}}async function q(){let d=process.env.MIXRPAY_WALLET_KEY;return d&&(d.length===64||d.startsWith("0x")&&d.length===66)?true:existsSync(R())}function Ue(){return R()}async function Pe(){let d=R();if(!existsSync(d))return  false;try{let{unlinkSync:e}=await import('fs');return e(d),!0}catch{return  false}}async function Q(d){let e=null,t=d.headers.get("X-Payment-Required");if(t)try{e=JSON.parse(t);}catch{}if(!e){let n=d.headers.get("WWW-Authenticate");if(n?.startsWith("X-402 "))try{let a=n.slice(6);e=JSON.parse(atob(a));}catch{}}if(!e)try{e=await d.json();}catch{}if(!e)throw new k("Could not parse payment requirements from 402 response");if(!e.recipient)throw new k("Missing recipient in payment requirements");if(!e.amount)throw new k("Missing amount in payment requirements");let s=Math.floor(Date.now()/1e3);return {recipient:e.recipient,amount:BigInt(e.amount),currency:e.currency||"USDC",chainId:e.chainId||e.chain_id||8453,facilitatorUrl:e.facilitatorUrl||e.facilitator_url||"https://x402.org/facilitator",nonce:e.nonce||F().slice(2),expiresAt:e.expiresAt||e.expires_at||s+300,description:e.description}}async function ee(d,e,t){let s=d.nonce.length===64?`0x${d.nonce}`:F(),a=BigInt(Math.floor(Date.now()/1e3))-60n,r=BigInt(d.expiresAt),{domain:i,message:o}=X({fromAddress:t,toAddress:d.recipient,value:d.amount,validAfter:a,validBefore:r,nonce:s,chainId:d.chainId}),c=await e.signTransferAuthorization(i,o),p={x402Version:1,scheme:"exact",network:d.chainId===8453?"base":"base-sepolia",payload:{signature:c,authorization:{from:t,to:d.recipient,value:d.amount.toString(),validAfter:a.toString(),validBefore:r.toString(),nonce:s}}};return btoa(JSON.stringify(p))}function te(d){return Date.now()/1e3>d.expiresAt}function B(d){return Number(d.amount)/1e6}var re="0.9.4",b=process.env.MIXRPAY_BASE_URL||"https://www.mixrpay.com";var je=3e4,ne={BASE_MAINNET:{chainId:8453,name:"Base",isTestnet:false},BASE_SEPOLIA:{chainId:84532,name:"Base Sepolia",isTestnet:true}},ae={debug:0,info:1,warn:2,error:3,none:4},J=class{level;prefix;constructor(e="none",t="[MixrPay]"){this.level=e,this.prefix=t;}setLevel(e){this.level=e;}shouldLog(e){return ae[e]>=ae[this.level]}debug(...e){this.shouldLog("debug")&&console.log(`${this.prefix} \u{1F50D}`,...e);}info(...e){this.shouldLog("info")&&console.log(`${this.prefix} \u2139\uFE0F`,...e);}warn(...e){this.shouldLog("warn")&&console.warn(`${this.prefix} \u26A0\uFE0F`,...e);}error(...e){this.shouldLog("error")&&console.error(`${this.prefix} \u274C`,...e);}payment(e,t,s){if(this.shouldLog("info")){let n=s?` for "${s}"`:"";console.log(`${this.prefix} \u{1F4B8} Paid $${e.toFixed(4)} to ${t.slice(0,10)}...${n}`);}}},G=class d{sessionKey;walletAddress;maxPaymentUsd;onPayment;baseUrl;timeout;logger;payments=[];totalSpentUsd=0;sessionKeyInfo;sessionKeyInfoFetchedAt;allowlist;allowlistFetchedAt;selfCustodyAddress;selfCustodyKey;agentInstanceId;apiKey;constructor(e){this.validateConfig(e),this.sessionKey=O.fromString(e.sessionKey),this.walletAddress=e.walletAddress||this.sessionKey.address,this.maxPaymentUsd=e.maxPaymentUsd,this.onPayment=e.onPayment,this.baseUrl=(e.baseUrl||b).replace(/\/$/,""),this.timeout=e.timeout||je,e.apiKey&&(this.apiKey=e.apiKey),this.logger=new J(e.logLevel||"none"),this.logger.debug("AgentWallet initialized",{walletAddress:this.walletAddress,isTestnet:this.isTestnet(),maxPaymentUsd:this.maxPaymentUsd,hasApiKey:!!this.apiKey});}validateConfig(e){if(!e.sessionKey)throw new _("Session key is required. Get one from the wallet owner at https://mixrpay.com/manage/invites");let t=e.sessionKey.trim();if(!t.startsWith("sk_live_")&&!t.startsWith("sk_test_")){let a=t.slice(0,8);throw new _(`Invalid session key prefix. Expected 'sk_live_' (mainnet) or 'sk_test_' (testnet), got '${a}'`)}let s=72;if(t.length!==s)throw new _(`Invalid session key length. Expected ${s} characters, got ${t.length}. Make sure you copied the complete key.`);let n=t.slice(8);if(!/^[0-9a-fA-F]+$/.test(n))throw new _("Invalid session key format. The key should contain only hexadecimal characters after the prefix.");if(e.maxPaymentUsd!==void 0){if(e.maxPaymentUsd<=0)throw new l("maxPaymentUsd must be a positive number");e.maxPaymentUsd>1e4&&this.logger?.warn("maxPaymentUsd is very high ($"+e.maxPaymentUsd+"). Consider using a lower limit for safety.");}}async fetchAllowlist(){if(this.allowlist!==void 0&&this.allowlistFetchedAt&&Date.now()-this.allowlistFetchedAt<3e5)return this.allowlist;try{let t=await this.getSessionKeyInfo();return this.allowlist=t.allowedMerchants||[],this.allowlistFetchedAt=Date.now(),this.logger.debug("Fetched allowlist",{patterns:this.allowlist.length,allowAll:this.allowlist.length===0}),this.allowlist}catch(t){return this.logger.warn("Failed to fetch allowlist, allowing all merchants",{error:t}),this.allowlist=[],this.allowlistFetchedAt=Date.now(),this.allowlist}}async validateMerchantAllowed(e,t){let s=await this.fetchAllowlist();if(s.length===0)return;if(!this.matchesAllowlist(e,s,t))throw new D(e,s)}matchesAllowlist(e,t,s){for(let n of t)if(this.matchPattern(e,n,s))return  true;return  false}matchPattern(e,t,s){return s==="url"?this.matchUrlPattern(e,t):this.matchToolPattern(e,t)}matchUrlPattern(e,t){let s;try{e.includes("://")?s=new URL(e).hostname.toLowerCase():s=e.toLowerCase();}catch{return  false}let a=t.toLowerCase().trim();if(a.includes("://"))try{a=new URL(a).hostname;}catch{}if(s===a)return  true;if(a.startsWith("*.")){let r=a.substring(2);if(s.endsWith(`.${r}`)&&s!==r)return  true}return  false}matchToolPattern(e,t){let s=e.toLowerCase().trim(),n=t.toLowerCase().trim();if(s===n)return  true;if(n.endsWith("/*")){let a=n.substring(0,n.length-2);if(s.startsWith(`${a}/`))return  true}return  false}static async register(e){let{privateKey:t,name:s}=e,n=(e.baseUrl||b).replace(/\/$/,""),r=privateKeyToAccount(t).address,i=await fetch(`${n}/api/v1/agent/challenge?wallet=${r}&action=register`);if(!i.ok){let h=await i.json().catch(()=>({}));throw new l(h.error||`Failed to get challenge: ${i.status}`)}let{challenge:o,message:c}=await i.json(),p=await signMessage({message:c,privateKey:t}),u=await fetch(`${n}/api/v1/agent/register`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({challenge:o,external_wallet:r,signature:p,name:s})});if(!u.ok){let h=await u.json().catch(()=>({})),y=h.error||`Registration failed with status ${u.status}`,m=h.request_id,f=(h.code||"").toLowerCase(),w="";u.status===503?w=" The service may be temporarily unavailable. Please try again later.":u.status===500?w=" This is a server error. Please contact support with the request ID.":(f==="missing_challenge"||f==="missing_signature")&&(w=" This may indicate an SDK bug. Please update to the latest version.");let j=m?`${y} (request_id: ${m})${w}`:`${y}${w}`;throw new l(j)}let g=await u.json();return {userId:g.user_id,depositAddress:g.deposit_address}}static async checkServerHealth(e){let t=(e||b).replace(/\/$/,"");try{let s=await fetch(`${t}/api/health/ready?details=true`);if(!s.ok)return {healthy:!1,database:"unknown",agentRegistrationAvailable:!1,walletServiceConfigured:!1,error:`Health check failed with status ${s.status}`};let n=await s.json();return {healthy:n.status==="ready",database:n.database||"unknown",agentRegistrationAvailable:n.services?.agentRegistration?.available??!1,walletServiceConfigured:n.services?.wallet?.configured??!1}}catch(s){return {healthy:false,database:"unreachable",agentRegistrationAvailable:false,walletServiceConfigured:false,error:s instanceof Error?s.message:"Failed to reach server"}}}static async getSessionKey(e){let{privateKey:t,spendingLimitUsd:s,maxPerTxUsd:n,maxDailyUsd:a,durationDays:r}=e,i=(e.baseUrl||b).replace(/\/$/,""),c=privateKeyToAccount(t).address,p=await fetch(`${i}/api/v1/agent/challenge?wallet=${c}&action=session-key`);if(!p.ok){let f=await p.json().catch(()=>({}));throw new l(f.error||`Failed to get challenge: ${p.status}`)}let{challenge:u,message:g}=await p.json(),h=await signMessage({message:g,privateKey:t}),y=await fetch(`${i}/api/v1/agent/session-key`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({challenge:u,external_wallet:c,signature:h,spending_limit_usd:s,max_per_tx_usd:n,max_daily_usd:a,duration_days:r})});if(!y.ok){let f=await y.json().catch(()=>({}));throw new l(f.error||`Session key creation failed: ${y.status}`)}let m=await y.json();return {sessionKey:m.session_key,address:m.address,sessionKeyId:m.session_key_id,expiresAt:new Date(m.expires_at),limits:{maxTotalUsd:m.limits.max_total_usd,maxPerTxUsd:m.limits.max_per_tx_usd,maxDailyUsd:m.limits.max_daily_usd}}}static async getStatus(e){let{privateKey:t}=e,s=(e.baseUrl||b).replace(/\/$/,""),a=privateKeyToAccount(t).address,r=await fetch(`${s}/api/v1/agent/challenge?wallet=${a}&action=status`);if(!r.ok){let g=await r.json().catch(()=>({}));throw new l(g.error||`Failed to get challenge: ${r.status}`)}let{challenge:i,message:o}=await r.json(),c=await signMessage({message:o,privateKey:t}),p=await fetch(`${s}/api/v1/agent/status?challenge=${i}&external_wallet=${a}&signature=${encodeURIComponent(c)}`);if(!p.ok){let g=await p.json().catch(()=>({}));throw new l(g.error||`Failed to get status: ${p.status}`)}let u=await p.json();return {depositAddress:u.deposit_address,balanceUsd:u.balance_usd,activeSessions:u.active_sessions.map(g=>({id:g.id,expiresAt:new Date(g.expires_at),totalSpentUsd:g.total_spent_usd,remainingUsd:g.remaining_usd,maxTotalUsd:g.max_total_usd})),totalSpentUsd:u.total_spent_usd}}static async revokeSessionKey(e){let{privateKey:t,sessionKeyId:s}=e,n=(e.baseUrl||b).replace(/\/$/,""),r=privateKeyToAccount(t).address,i=await fetch(`${n}/api/v1/agent/challenge?wallet=${r}&action=revoke`);if(!i.ok){let g=await i.json().catch(()=>({}));throw new l(g.error||`Failed to get challenge: ${i.status}`)}let{challenge:o,message:c}=await i.json(),p=await signMessage({message:c,privateKey:t}),u=await fetch(`${n}/api/v1/agent/session-key/revoke`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({challenge:o,external_wallet:r,signature:p,session_key_id:s})});if(!u.ok){let g=await u.json().catch(()=>({}));throw new l(g.error||`Revocation failed: ${u.status}`)}return  true}static async withdraw(e){let{privateKey:t,amountUsd:s}=e,n=(e.baseUrl||b).replace(/\/$/,""),r=privateKeyToAccount(t).address,i=await fetch(`${n}/api/v1/agent/challenge?wallet=${r}&action=withdraw`);if(!i.ok){let h=await i.json().catch(()=>({}));throw new l(h.error||`Failed to get challenge: ${i.status}`)}let{challenge:o,message:c}=await i.json(),p=await signMessage({message:c,privateKey:t}),u=await fetch(`${n}/api/v1/agent/withdraw`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({challenge:o,external_wallet:r,signature:p,to_address:r,amount_usd:s})});if(!u.ok){let h=await u.json().catch(()=>({}));throw new l(h.error||`Withdrawal failed: ${u.status}`)}let g=await u.json();return {txHash:g.tx_hash,amountUsd:g.amount_usd,remainingBalanceUsd:g.remaining_balance_usd}}static async claimInvite(e){let{inviteCode:t,privateKey:s}=e,n=(e.baseUrl||b).replace(/\/$/,""),r=privateKeyToAccount(s).address,i=await fetch(`${n}/api/v1/agent/challenge?wallet=${r}&action=claim-invite`);if(!i.ok){let h=await i.json().catch(()=>({}));throw new l(h.error||`Failed to get challenge: ${i.status}`)}let{challenge:o,message:c}=await i.json(),p=await signMessage({message:c,privateKey:s}),u=await fetch(`${n}/api/v1/agent/claim-invite`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({invite_code:t,challenge:o,agent_wallet_address:r,signature:p})});if(!u.ok){let y=(await u.json().catch(()=>({}))).error||`Failed to claim invite: ${u.status}`,m="";throw u.status===404?m=" The invite code may be invalid or misspelled.":u.status===400&&(y.includes("already claimed")?m=" This invite has already been used by another agent.":y.includes("expired")?m=" Ask the wallet owner to create a new invite.":y.includes("revoked")&&(m=" The wallet owner has revoked this invite.")),new l(`${y}${m}`)}let g=await u.json();return {sessionKey:g.session_key,address:g.address,sessionKeyId:g.session_key_id,expiresAt:new Date(g.expires_at),limits:{budgetUsd:g.limits.budget_usd,budgetPeriod:g.limits.budget_period,maxPerTxUsd:g.limits.max_per_tx_usd},allowedMerchants:g.allowed_merchants||[],inviterName:g.inviter_name||"Anonymous"}}static async activate(e,t){let s=(t?.baseUrl||b).replace(/\/$/,""),n=new d({sessionKey:e,baseUrl:s}),a=await n.getSessionAuthHeaders(),r=await fetch(`${s}/api/v2/agent/activate`,{method:"POST",headers:{"Content-Type":"application/json",...a}});if(!r.ok){let o=await r.json().catch(()=>({}));throw new l(o.error||`Activation failed: ${r.status}`)}let i=await r.json();return {wallet:n,budget:{maxTotalUsd:i.budget.max_total_usd,maxDailyUsd:i.budget.max_daily_usd,maxPerTxUsd:i.budget.max_per_tx_usd,spentUsd:i.budget.spent_usd,remainingUsd:i.budget.remaining_usd},capabilities:{executeTransactions:i.capabilities.execute_transactions,gasSponsored:i.capabilities.gas_sponsored,batchedTx:i.capabilities.batched_tx},skills:i.skills||[],tools:i.tools||[],gatewayProviders:i.gateway_providers||[]}}static async connect(e){let t=(e?.baseUrl||process.env.MIXRPAY_BASE_URL||b).replace(/\/$/,""),s=e?.logLevel||"none",n=process.env.MIXRPAY_INSTANCE_ID;if(e?.sessionKey){let p=new d({sessionKey:e.sessionKey,baseUrl:t,logLevel:s,maxPaymentUsd:e?.maxPaymentUsd,onPayment:e?.onPayment});return n&&p.setAgentInstanceId(n),p}let a=process.env.MIXRPAY_SESSION_KEY;if(a){let p=new d({sessionKey:a,baseUrl:t,logLevel:s,maxPaymentUsd:e?.maxPaymentUsd,onPayment:e?.onPayment});return n&&p.setAgentInstanceId(n),p}let r=process.env.MIXRPAY_API_KEY||process.env.MIXRPAY_AGENT_TOKEN;if(r&&(r.startsWith("agt_live_")||r.startsWith("agt_test_")))return d.fromApiKey(r,{baseUrl:t,logLevel:s});let i=e?.accessCode||process.env.MIXRPAY_ACCESS_CODE;if(i)return d.fromAccessCode(i,{baseUrl:t,logLevel:s});let o=e?.masterKey||process.env.MIXRPAY_MASTER_KEY,c=e?.agentName||process.env.MIXRPAY_AGENT_NAME;if(o&&c)return d.fromMasterKey(o,c,{baseUrl:t,logLevel:s});try{let{loadCredentials:p}=await import('./credentials-Z4HQDXFU.js'),u=p();if(u.success&&u.credentials.sessionKey){let g=new d({sessionKey:u.credentials.sessionKey,baseUrl:u.credentials.baseUrl||t,logLevel:s,maxPaymentUsd:e?.maxPaymentUsd,onPayment:e?.onPayment,apiKey:u.credentials.apiToken});return n&&g.setAgentInstanceId(n),g}if(u.success&&u.credentials.apiToken)return d.fromApiKey(u.credentials.apiToken,{baseUrl:t,logLevel:s});if(u.success&&u.credentials.masterKey&&u.credentials.defaultAgentName)return d.fromMasterKey(u.credentials.masterKey,u.credentials.defaultAgentName,{baseUrl:t,logLevel:s})}catch{}if(e?.interactive)return d.deviceFlowLogin({baseUrl:t,logLevel:s});throw new l(`No MixrPay credentials found. Options:
+  1. Set MIXRPAY_SESSION_KEY environment variable
+  2. Set MIXRPAY_API_KEY or MIXRPAY_AGENT_TOKEN environment variable (agt_live_xxx)
+  3. Set MIXRPAY_ACCESS_CODE environment variable (mixr-xxx)
+  4. Pass sessionKey or accessCode to connect()
+  5. Run \`npx mixrpay login\` to cache credentials
+  6. Use connect({ interactive: true }) for browser login`)}static async fromApiKey(e,t){let s=(t?.baseUrl||b).replace(/\/$/,"");if(!e.startsWith("agt_live_")&&!e.startsWith("agt_test_"))throw new l(`Invalid API key format. Expected 'agt_live_' or 'agt_test_' prefix, got '${e.slice(0,9)}...'`);let n=await fetch(`${s}/api/v2/agent/session-from-token`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e}`}});if(!n.ok){let o=await n.json().catch(()=>({}));throw new l(o.error||`Failed to exchange API key for session: ${n.status}`)}let a=await n.json(),r=a.session_key;if(!r)throw new l("No session_key in API response");let i=new d({sessionKey:r,baseUrl:s,logLevel:t?.logLevel});return i.setApiKey(e),a.agent_instance_id&&i.setAgentInstanceId(a.agent_instance_id),i}static async fromAccessCode(e,t){let s=(t?.baseUrl||b).replace(/\/$/,"");if(!e.startsWith("mixr-"))throw new l(`Invalid access code format. Expected 'mixr-' prefix, got '${e.slice(0,5)}...'`);let n=await fetch(`${s}/api/v2/agent/connect`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({code:e})});if(!n.ok){let p=await n.json().catch(()=>({})),u=(p.code||"").toLowerCase(),g="";throw n.status===404||u==="invalid_code"?g=" Check the code for typos or get a new one from the MixrPay dashboard.":n.status===400&&(u==="code_claimed"?g=" This code has already been used. Get a new code from the dashboard.":u==="code_expired"?g=" This code has expired. Get a new code from the dashboard.":u==="code_revoked"&&(g=" This code has been revoked by the owner.")),new l((p.error||`Failed to activate access code: ${n.status}`)+g)}let a=await n.json(),r=a.session_key,i=a.token,o=a.agent_id;if(!r)throw new l("No session_key in access code response");try{let{saveCredentials:p}=await import('./credentials-Z4HQDXFU.js');p({sessionKey:r,apiToken:i,baseUrl:s});}catch{}let c=new d({sessionKey:r,baseUrl:s,logLevel:t?.logLevel});return i&&(c.apiKey=i),o&&(c.agentInstanceId=o),c}static async fromMasterKey(e,t,s){let n=(s?.baseUrl||b).replace(/\/$/,"");if(!e.startsWith("mk_live_")&&!e.startsWith("mk_test_"))throw new l("Invalid master key format. Expected 'mk_live_' or 'mk_test_' prefix.");let a=await fetch(`${n}/api/v2/master-keys/session`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${e}`},body:JSON.stringify({agent_name:t})});if(!a.ok){let c=await a.json().catch(()=>({}));throw a.status===404?new l(`Agent '${t}' not found. Use the MixrPay dashboard to create it.`):new l(c.error||`Failed to get session from master key: ${a.status}`)}let r=await a.json(),i=r.session_key;if(!i)throw new l("No session_key in master key response");let o=new d({sessionKey:i,baseUrl:n,logLevel:s?.logLevel});return r.agent?.id&&(o.agentInstanceId=r.agent.id),o}static async deviceFlowLogin(e){let t=(e?.baseUrl||b).replace(/\/$/,""),s=await fetch(`${t}/api/v2/auth/device/authorize`,{method:"POST",headers:{"Content-Type":"application/json"}});if(!s.ok){let h=await s.json().catch(()=>({}));throw new l(h.error||`Device flow initiation failed: ${s.status}`)}let n=await s.json(),{device_code:a,user_code:r,verification_uri:i,verification_uri_complete:o,expires_in:c,interval:p}=n;console.log(`
+\u{1F510} MixrPay Login
+`),console.log(`Visit: ${o||i}`),console.log(`Enter code: ${r}
+`),console.log(`Waiting for authentication...
+`);let u=(p||5)*1e3,g=Date.now()+(c||300)*1e3;for(;Date.now()<g;){await new Promise(f=>setTimeout(f,u));let h=await fetch(`${t}/api/v2/auth/device/token`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({device_code:a})});if(h.ok){let w=(await h.json()).session_key;if(w){console.log(`\u2705 Authenticated successfully!
+`);try{let{saveCredentials:j}=await import('./credentials-Z4HQDXFU.js');j({sessionKey:w,baseUrl:t});}catch{}return new d({sessionKey:w,baseUrl:t,logLevel:e?.logLevel})}}let m=(await h.json().catch(()=>({}))).error;if(m!=="authorization_pending")if(m==="slow_down"){await new Promise(f=>setTimeout(f,u));continue}else {if(m==="expired_token")throw new l("Device code expired. Please try again.");if(m==="access_denied")throw new l("Authentication was denied by the user.");if(m)throw new l(`Device flow error: ${m}`)}}throw new l("Device flow timed out. Please try again.")}async spawnChildInvite(e){let{budgetUsd:t,name:s,allowedMerchants:n,expiresInDays:a}=e,r=await this.getSessionAuthHeaders(),i=await fetch(`${this.baseUrl}/api/v1/agent/spawn`,{method:"POST",headers:{"Content-Type":"application/json",...r},body:JSON.stringify({budget_usd:t,name:s,allowed_merchants:n,expires_in_days:a})});if(!i.ok){let c=await i.json().catch(()=>({}));throw i.status===409?new l("Concurrent modification - please retry"):i.status===429?new l("Rate limited - too many spawn attempts"):new l(c.error||`Failed to spawn child: ${i.status}`)}let o=await i.json();return {inviteCode:o.invite_code,inviteId:o.invite_id,budgetUsd:o.budget_usd,expiresAt:new Date(o.expires_at),depth:o.depth,maxSpawnBudget:o.max_spawn_budget,allowedMerchants:o.allowed_merchants||[]}}async getAvailableBudget(){let e=await this.getSessionAuthHeaders(),t=await fetch(`${this.baseUrl}/api/v1/agent/descendants`,{method:"GET",headers:e});if(!t.ok){let n=await t.json().catch(()=>({}));throw new l(n.error||`Failed to get budget: ${t.status}`)}let s=await t.json();return {totalBudget:s.budget.total_usd,spent:s.budget.spent_usd,allocatedToChildren:s.budget.allocated_to_children_usd,available:s.budget.available_usd,maxSpawnBudget:s.max_spawn_budget,canSpawn:s.can_spawn}}async getChildSessions(){let e=await this.getSessionAuthHeaders(),t=await fetch(`${this.baseUrl}/api/v1/agent/descendants`,{method:"GET",headers:e});if(!t.ok){let n=await t.json().catch(()=>({}));throw new l(n.error||`Failed to get children: ${t.status}`)}return (await t.json()).children||[]}async listChildSessions(){return this.getChildSessions()}async fetch(e,t){this.logger.debug(`Fetching ${t?.method||"GET"} ${e}`),await this.validateMerchantAllowed(e,"url");let s=crypto.randomUUID(),n=this.extractCorrelationId(t?.headers),a=new AbortController,r=setTimeout(()=>a.abort(),this.timeout);try{let i=await fetch(e,{...t,signal:a.signal});return this.logger.debug(`Initial response: ${i.status}`),i.status===402&&(this.logger.info(`Payment required for ${e}`),i=await this.handlePaymentRequired(e,t,i,s,n)),i}catch(i){throw i instanceof Error&&i.name==="AbortError"?new l(`Request timeout after ${this.timeout}ms`):i}finally{clearTimeout(r);}}extractCorrelationId(e){if(!e)return;if(e instanceof Headers)return e.get("X-Correlation-Id")||e.get("x-correlation-id")||void 0;if(Array.isArray(e)){let s=e.find(([n])=>n.toLowerCase()==="x-correlation-id");return s?s[1]:void 0}let t=e;return t["X-Correlation-Id"]||t["x-correlation-id"]||void 0}async handlePaymentRequired(e,t,s,n,a){let r;try{r=await Q(s),this.logger.debug("Payment requirements:",{amount:`$${B(r).toFixed(4)}`,recipient:r.recipient,description:r.description});}catch(u){throw this.logger.error("Failed to parse payment requirements:",u),new A(`Failed to parse payment requirements: ${u}. The server may not be properly configured for x402 payments.`)}if(te(r))throw new A("Payment requirements have expired. This usually means the request took too long. Try again.");let i=B(r);if(this.maxPaymentUsd!==void 0&&i>this.maxPaymentUsd)throw new v("client_max",this.maxPaymentUsd,i);let o;try{this.logger.debug("Signing payment authorization..."),o=await ee(r,this.sessionKey,this.walletAddress);}catch(u){throw this.logger.error("Failed to sign payment:",u),new A(`Failed to sign payment: ${u}. This may indicate an issue with the session key.`)}this.logger.debug("Retrying request with payment...");let c=new Headers(t?.headers);c.set("X-PAYMENT",o);let p=await fetch(e,{...t,headers:c});if(p.status!==402){let u={amountUsd:i,recipient:r.recipient,txHash:p.headers.get("X-Payment-TxHash"),timestamp:new Date,description:r.description,url:e,requestId:n,correlationId:a};this.payments.push(u),this.totalSpentUsd+=i,this.logger.payment(i,r.recipient,r.description),this.onPayment&&this.onPayment(u);}else await this.handlePaymentError(p);return p}async handlePaymentError(e){let t={};try{t=await e.json();}catch{}let s=(t.error_code||"").toLowerCase(),n=t.error||t.message||"Payment required";if(this.logger.error("Payment failed:",{errorCode:s,errorMessage:n,errorData:t}),s==="insufficient_balance"){let a=t.required||0,r=t.available||0;throw new S(a,r)}else throw s==="session_key_expired"?new $(t.expired_at||"unknown"):s==="spending_limit_exceeded"?new v(t.limit_type||"unknown",t.limit||0,t.attempted||0):new A(n)}getWalletAddress(){return this.walletAddress}isTestnet(){return this.sessionKey.isTest}getNetwork(){return this.isTestnet()?ne.BASE_SEPOLIA:ne.BASE_MAINNET}async getBalance(){this.logger.debug("Fetching wallet balance...");try{let e=await fetch(`${this.baseUrl}/api/v1/session-key/info`,{headers:{"X-Session-Key":this.sessionKey.address.toLowerCase()}});if(!e.ok)throw new Error("Failed to get session key info");let t=await e.json(),s=t.wallet_address||t.walletAddress;if(!s)throw new Error("No wallet address in session key info");let n=await fetch(`${this.baseUrl}/api/wallet/balance?address=${s}&chain=base`);if(n.ok){let a=await n.json(),r=a.balance_usdc||a.balance_usd||0;return this.logger.debug(`Balance: $${r}`),r}}catch(e){this.logger.warn("Failed to fetch balance:",e);}return this.logger.debug("Using estimated balance based on tracking"),Math.max(0,100-this.totalSpentUsd)}async canAfford(e){let t=await this.getBalance(),s=t>=e;return {canAfford:s,balance:t,shortfall:s?0:e-t,remainingAfter:s?t-e:0}}async getSessionKeyInfo(e=false){let t=this.sessionKeyInfoFetchedAt?Date.now()-this.sessionKeyInfoFetchedAt:1/0;if(!e&&this.sessionKeyInfo&&t<6e4)return this.sessionKeyInfo;this.logger.debug("Fetching session key info...");try{let s=await fetch(`${this.baseUrl}/api/v1/session-key/info`,{headers:{"X-Session-Key":this.sessionKey.address.toLowerCase()}});if(s.ok){let n=await s.json();return this.sessionKeyInfo={address:this.sessionKey.address,walletAddress:n.wallet_address??n.walletAddress??null,isValid:n.is_valid??n.isValid??!0,limits:{perTxUsd:n.per_tx_limit_usd??n.perTxLimitUsd??null,dailyUsd:n.daily_limit_usd??n.dailyLimitUsd??null,totalUsd:n.total_limit_usd??n.totalLimitUsd??null},usage:{todayUsd:n.today_spent_usd??n.todaySpentUsd??0,totalUsd:n.total_spent_usd??n.totalSpentUsd??0,txCount:n.tx_count??n.txCount??0},expiresAt:n.expires_at?new Date(n.expires_at):null,createdAt:n.created_at?new Date(n.created_at):null,name:n.name,allowedMerchants:n.allowed_merchants??n.allowedMerchants??[]},this.sessionKeyInfoFetchedAt=Date.now(),this.sessionKeyInfo}}catch(s){this.logger.warn("Failed to fetch session key info:",s);}return {address:this.sessionKey.address,walletAddress:null,isValid:true,limits:{perTxUsd:null,dailyUsd:null,totalUsd:null},usage:{todayUsd:this.totalSpentUsd,totalUsd:this.totalSpentUsd,txCount:this.payments.length},expiresAt:null,createdAt:null}}async getSpendingStats(){this.logger.debug("Fetching spending stats...");try{let e=await fetch(`${this.baseUrl}/api/v1/session-key/stats`,{headers:{"X-Session-Key":this.sessionKey.address.toLowerCase()}});if(e.ok){let t=await e.json();return {totalSpentUsd:t.total_spent_usd||t.totalSpentUsd||this.totalSpentUsd,txCount:t.tx_count||t.txCount||this.payments.length,remainingDailyUsd:t.remaining_daily_usd||t.remainingDailyUsd||null,remainingTotalUsd:t.remaining_total_usd||t.remainingTotalUsd||null,expiresAt:t.expires_at?new Date(t.expires_at):null}}}catch(e){this.logger.warn("Failed to fetch spending stats:",e);}return {totalSpentUsd:this.totalSpentUsd,txCount:this.payments.length,remainingDailyUsd:null,remainingTotalUsd:null,expiresAt:null}}getPaymentHistory(){return [...this.payments]}getTotalSpent(){return this.totalSpentUsd}async createSelfCustodyWallet(){if(!this.agentInstanceId)throw new l("Agent instance ID is required for self-custody wallet. Use AgentWallet.fromApiKey() or set MIXRPAY_INSTANCE_ID environment variable.","NO_AGENT_INSTANCE_ID");let e=await K();if(e){let i=privateKeyToAccount(e);return this.selfCustodyAddress=i.address,this.selfCustodyKey=e,this.logger.info("Loaded existing self-custody wallet",{address:i.address}),{address:i.address,privateKey:e}}let t=generatePrivateKey(),s=privateKeyToAccount(t),n=Date.now(),a=`MixrPay Wallet Registration
+Address: ${s.address}
+Timestamp: ${n}`,r=await s.signMessage({message:a});return await this.registerWalletAddress(s.address,r,n),await W(t,s.address),this.selfCustodyAddress=s.address,this.selfCustodyKey=t,this.logger.info("Created self-custody wallet",{address:s.address}),{address:s.address,privateKey:t}}async registerWalletAddress(e,t,s){if(!this.apiKey)throw new l("API key is required for wallet registration. Use AgentWallet.fromApiKey() to initialize.","NO_API_KEY");let n=await fetch(`${this.baseUrl}/api/v2/agent/wallet/register`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`},body:JSON.stringify({address:e,signature:t,timestamp:s})});if(!n.ok){let a=await n.json().catch(()=>({}));throw new l(a.error||`Failed to register wallet: ${n.status}`,"WALLET_REGISTRATION_FAILED")}}async loadSelfCustodyWallet(){let e=await K();if(!e)return  false;let t=privateKeyToAccount(e);return this.selfCustodyAddress=t.address,this.selfCustodyKey=e,this.logger.debug("Loaded self-custody wallet",{address:t.address}),true}async hasSelfCustodyWallet(){return await q()}getSelfCustodyAddress(){return this.selfCustodyAddress||null}async executeFromOwnWallet(e){if(!this.selfCustodyKey||!this.selfCustodyAddress)throw new l("Self-custody wallet not loaded. Call loadSelfCustodyWallet() or createSelfCustodyWallet() first.","WALLET_NOT_LOADED");let{to:t,value:s,data:n,gasLimit:a}=e,r=privateKeyToAccount(this.selfCustodyKey),i=createWalletClient({account:r,chain:base,transport:http()});this.logger.debug("Executing transaction from self-custody wallet",{from:this.selfCustodyAddress,to:t,value:s?.toString()});try{let o=await i.sendTransaction({to:t,value:s??BigInt(0),data:n,gas:a});this.logger.info("Transaction submitted",{txHash:o});let c=!1;try{await this.reportTransaction(o,t,s??BigInt(0)),c=!0;}catch(p){this.logger.warn("Failed to report transaction to MixrPay",{txHash:o,error:p instanceof Error?p.message:p});}return {txHash:o,reportedToMixrPay:c}}catch(o){throw this.logger.error("Transaction failed",{error:o instanceof Error?o.message:o}),new l(`Transaction failed: ${o instanceof Error?o.message:"Unknown error"}`,"TRANSACTION_FAILED")}}async transferUSDC(e){if(!this.selfCustodyKey||!this.selfCustodyAddress)throw new l("Self-custody wallet not loaded. Call loadSelfCustodyWallet() or createSelfCustodyWallet() first.","WALLET_NOT_LOADED");let{to:t,amountUsdc:s}=e,n="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",a=6,r=parseUnits(s.toFixed(a),a),i=encodeFunctionData({abi:[{name:"transfer",type:"function",inputs:[{name:"to",type:"address"},{name:"amount",type:"uint256"}],outputs:[{type:"bool"}]}],functionName:"transfer",args:[t,r]});return this.logger.debug("Transferring USDC",{from:this.selfCustodyAddress,to:t,amountUsdc:s,amountMinorUnits:r.toString()}),(await this.executeFromOwnWallet({to:n,data:i})).txHash}async reportTransaction(e,t,s){if(!this.apiKey){this.logger.warn("Cannot report transaction - no API key set");return}let n=await fetch(`${this.baseUrl}/api/v2/agent/tx/report`,{method:"POST",headers:{"Content-Type":"application/json",Authorization:`Bearer ${this.apiKey}`},body:JSON.stringify({tx_hash:e,to_address:t,value:s.toString(),chain_id:base.id})});if(!n.ok){let a=await n.json().catch(()=>({}));throw new l(a.error||`Failed to report transaction: ${n.status}`,"TX_REPORT_FAILED")}}getAgentInstanceId(){return this.agentInstanceId}setAgentInstanceId(e){this.agentInstanceId=e;}setApiKey(e){this.apiKey=e;}mcp(){let e=join(dirname(fileURLToPath(import.meta.url)),"mcp-server.js"),t={MIXRPAY_SESSION_KEY:this.sessionKey.toString(),MIXRPAY_BASE_URL:this.baseUrl};return this.apiKey&&(t.MIXRPAY_API_KEY=this.apiKey),this.agentInstanceId&&(t.MIXRPAY_INSTANCE_ID=this.agentInstanceId),this.selfCustodyKey&&(t.AGENT_WALLET_KEY=this.selfCustodyKey),this.maxPaymentUsd&&(t.MIXRPAY_MAX_PAYMENT_USD=String(this.maxPaymentUsd)),{command:"node",args:[e],env:t}}async runDiagnostics(){this.logger.info("Running diagnostics...");let e=[],t=[],s={},n,a;s.sessionKeyFormat=true;try{let o=Date.now(),c=await fetch(`${this.baseUrl}/health`,{method:"GET",signal:AbortSignal.timeout(5e3)});n=Date.now()-o,s.apiConnectivity=c.ok,c.ok||(e.push(`API server returned ${c.status}. Check baseUrl configuration.`),t.push("Verify the baseUrl configuration points to a valid MixrPay server.")),n>2e3&&(e.push(`High API latency: ${n}ms. This may cause timeouts.`),t.push("Consider using a server closer to your region or check network connectivity."));}catch{s.apiConnectivity=false,e.push("Cannot connect to MixrPay API. Check your network connection and baseUrl."),t.push("Verify network connectivity and that the MixrPay server is running.");}try{let o=await this.getSessionKeyInfo(!0);s.sessionKeyValid=o.isValid,o.isValid||(e.push("Session key is invalid or has been revoked."),t.push("Request a new session key from the wallet owner at https://mixrpay.com/manage/invites"));let c=new Date,p=null;o.expiresAt&&(p=(o.expiresAt.getTime()-c.getTime())/(1e3*60*60),o.expiresAt<c?(s.sessionKeyValid=!1,e.push(`Session key expired on ${o.expiresAt.toISOString()}`),t.push("Create a new session key to continue making payments.")):p<24&&(e.push(`Session key expires in ${p.toFixed(1)} hours.`),t.push("Consider creating a new session key before the current one expires.")));let u=await this.getSpendingStats();a={remainingDailyUsd:u.remainingDailyUsd,remainingTotalUsd:u.remainingTotalUsd,expiresAt:o.expiresAt,expiresInHours:p},u.remainingDailyUsd!==null&&u.remainingDailyUsd<1&&(e.push(`Daily limit nearly exhausted: $${u.remainingDailyUsd.toFixed(2)} remaining.`),t.push("Wait until tomorrow for daily limit to reset, or request a higher daily limit.")),u.remainingTotalUsd!==null&&u.remainingTotalUsd<1&&(e.push(`Total limit nearly exhausted: $${u.remainingTotalUsd.toFixed(2)} remaining.`),t.push("Request a new session key with a higher total limit."));}catch{s.sessionKeyValid=false,e.push("Could not verify session key validity."),t.push("Check network connectivity and try again.");}let r=0;try{r=await this.getBalance(),s.hasBalance=r>0,r<=0?(e.push("Wallet has no USDC balance. Top up at https://mixrpay.com/manage/wallet"),t.push("Deposit USDC to your wallet address to enable payments.")):r<1&&(e.push(`Low balance: $${r.toFixed(2)}. Consider topping up.`),t.push("Top up your wallet balance to avoid payment failures."));}catch{s.hasBalance=false,e.push("Could not fetch wallet balance."),t.push("Check network connectivity and try again.");}let i=e.length===0;return this.logger.info("Diagnostics complete:",{healthy:i,issues:e,latencyMs:n}),{healthy:i,issues:e,checks:s,sdkVersion:re,network:this.getNetwork().name,walletAddress:this.walletAddress,sessionLimits:a,latencyMs:n,recommendations:t}}async generateSiwe(e){let{domain:t,uri:s,statement:n,nonce:a=crypto.randomUUID(),issuedAt:r=new Date,expirationTime:i,notBefore:o,requestId:c,resources:p}=e,u=this.sessionKey.address,g=this.getNetwork().chainId,h="1",y=`${t} wants you to sign in with your Ethereum account:
+`;if(y+=`${u}
 
-// src/errors.ts
-var MixrPayError = class extends Error {
-  /** Error code for programmatic handling */
-  code;
-  /** Optional hint for how long to wait before retrying (in milliseconds) */
-  retryAfterMs;
-  constructor(message, code = "MIXRPAY_ERROR", retryAfterMs) {
-    super(message);
-    this.name = "MixrPayError";
-    this.code = code;
-    this.retryAfterMs = retryAfterMs;
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, this.constructor);
-    }
-  }
-  /**
-   * Check if this error is retryable.
-   * 
-   * Returns true if the operation might succeed on retry (e.g., transient network issues).
-   * Returns false if the error requires user action to resolve (e.g., insufficient balance).
-   * 
-   * @returns true if the operation should be retried, false otherwise
-   * 
-   * @example
-   * ```typescript
-   * try {
-   *   await wallet.fetch(...);
-   * } catch (error) {
-   *   if (error instanceof MixrPayError && error.isRetryable()) {
-   *     // Retry the operation
-   *     await retry();
-   *   } else {
-   *     // Handle permanent failure
-   *     throw error;
-   *   }
-   * }
-   * ```
-   */
-  isRetryable() {
-    return false;
-  }
-};
-var InsufficientBalanceError = class extends MixrPayError {
-  /** Amount required for the payment in USD */
-  required;
-  /** Current available balance in USD */
-  available;
-  /** URL where the user can top up their wallet */
-  topUpUrl;
-  constructor(required, available) {
-    const shortage = required - available;
-    super(
-      `Insufficient balance: need $${required.toFixed(2)}, have $${available.toFixed(2)} (short $${shortage.toFixed(2)}). Top up your wallet to continue.`,
-      "INSUFFICIENT_BALANCE"
-    );
-    this.name = "InsufficientBalanceError";
-    this.required = required;
-    this.available = available;
-    this.topUpUrl = "https://mixrpay.com/manage/wallet";
-  }
-};
-var SessionKeyExpiredError = class extends MixrPayError {
-  /** When the session key expired */
-  expiredAt;
-  constructor(expiredAt) {
-    super(
-      `Session key expired at ${expiredAt}. Request a new session key from the wallet owner at https://mixrpay.com/manage/invites`,
-      "SESSION_KEY_EXPIRED"
-    );
-    this.name = "SessionKeyExpiredError";
-    this.expiredAt = expiredAt;
-  }
-};
-var SpendingLimitExceededError = class extends MixrPayError {
-  /** Type of limit that was exceeded */
-  limitType;
-  /** The limit amount in USD */
-  limit;
-  /** The amount that was attempted in USD */
-  attempted;
-  constructor(limitType, limit, attempted) {
-    const limitNames = {
-      per_tx: "Per-transaction",
-      daily: "Daily",
-      total: "Total",
-      client_max: "Client-side"
-    };
-    const limitName = limitNames[limitType] || limitType;
-    const suggestion = limitType === "daily" ? "Wait until tomorrow or request a higher limit." : limitType === "client_max" ? "Increase maxPaymentUsd in your AgentWallet configuration." : "Request a new session key with a higher limit.";
-    super(
-      `${limitName} spending limit exceeded: limit is $${limit.toFixed(2)}, attempted $${attempted.toFixed(2)}. ${suggestion}`,
-      "SPENDING_LIMIT_EXCEEDED"
-    );
-    this.name = "SpendingLimitExceededError";
-    this.limitType = limitType;
-    this.limit = limit;
-    this.attempted = attempted;
-  }
-  /**
-   * Daily limits reset at midnight, so those are retryable (after waiting).
-   * Other limit types require user action (new session key, config change).
-   * @returns true only for daily limits
-   */
-  isRetryable() {
-    return this.limitType === "daily";
-  }
-};
-var PaymentFailedError = class extends MixrPayError {
-  /** Detailed reason for the failure */
-  reason;
-  /** Transaction hash if the tx was submitted (for debugging) */
-  txHash;
-  constructor(reason, txHash) {
-    let message = `Payment failed: ${reason}`;
-    if (txHash) {
-      message += ` (tx: ${txHash} - check on basescan.org)`;
-    }
-    super(message, "PAYMENT_FAILED");
-    this.name = "PaymentFailedError";
-    this.reason = reason;
-    this.txHash = txHash;
-  }
-  /**
-   * Payment failures are often transient (network issues, temporary server errors).
-   * @returns true - payment failures should generally be retried
-   */
-  isRetryable() {
-    return true;
-  }
-};
-var InvalidSessionKeyError = class extends MixrPayError {
-  /** Detailed reason why the key is invalid */
-  reason;
-  constructor(reason = "Invalid session key format") {
-    super(
-      `${reason}. Session keys should be in format: sk_live_<64 hex chars> or sk_test_<64 hex chars>. Get one from https://mixrpay.com/manage/invites`,
-      "INVALID_SESSION_KEY"
-    );
-    this.name = "InvalidSessionKeyError";
-    this.reason = reason;
-  }
-};
-var X402ProtocolError = class extends MixrPayError {
-  /** Detailed reason for the protocol error */
-  reason;
-  constructor(reason) {
-    super(
-      `x402 protocol error: ${reason}. This may indicate a server configuration issue. If the problem persists, contact the API provider.`,
-      "X402_PROTOCOL_ERROR"
-    );
-    this.name = "X402ProtocolError";
-    this.reason = reason;
-  }
-  /**
-   * Protocol errors may be caused by temporary server issues.
-   * @returns true - worth retrying in case server recovers
-   */
-  isRetryable() {
-    return true;
-  }
-};
-var SessionExpiredError = class extends MixrPayError {
-  /** ID of the expired session */
-  sessionId;
-  /** When the session expired (ISO string or Date) */
-  expiredAt;
-  constructor(sessionId, expiredAt) {
-    super(
-      `Session ${sessionId} has expired${expiredAt ? ` at ${expiredAt}` : ""}. A new session will be created automatically on your next request.`,
-      "SESSION_EXPIRED"
-    );
-    this.name = "SessionExpiredError";
-    this.sessionId = sessionId;
-    this.expiredAt = expiredAt;
-  }
-};
-var SessionLimitExceededError = class extends MixrPayError {
-  /** ID of the session */
-  sessionId;
-  /** The session's spending limit in USD */
-  limit;
-  /** The amount requested in USD */
-  requested;
-  /** Remaining balance in the session (limit - used) */
-  remaining;
-  constructor(limit, requested, remaining, sessionId) {
-    super(
-      `Session spending limit exceeded: limit is $${limit.toFixed(2)}, requested $${requested.toFixed(2)}, remaining $${remaining.toFixed(2)}. Create a new session with a higher limit to continue.`,
-      "SESSION_LIMIT_EXCEEDED"
-    );
-    this.name = "SessionLimitExceededError";
-    this.sessionId = sessionId;
-    this.limit = limit;
-    this.requested = requested;
-    this.remaining = remaining;
-  }
-};
-var SessionNotFoundError = class extends MixrPayError {
-  /** The session ID that was not found */
-  sessionId;
-  constructor(sessionId) {
-    super(
-      `Session ${sessionId} not found. It may have been deleted or never existed. Create a new session with getOrCreateSession().`,
-      "SESSION_NOT_FOUND"
-    );
-    this.name = "SessionNotFoundError";
-    this.sessionId = sessionId;
-  }
-};
-var SessionRevokedError = class extends MixrPayError {
-  /** The session ID that was revoked */
-  sessionId;
-  /** Optional reason for revocation */
-  reason;
-  constructor(sessionId, reason) {
-    super(
-      `Session ${sessionId} has been revoked${reason ? `: ${reason}` : ""}. Create a new session with getOrCreateSession().`,
-      "SESSION_REVOKED"
-    );
-    this.name = "SessionRevokedError";
-    this.sessionId = sessionId;
-    this.reason = reason;
-  }
-};
-var MerchantNotAllowedError = class extends MixrPayError {
-  /** The merchant/tool that was attempted */
-  attempted;
-  /** The patterns that are allowed by the session */
-  allowedPatterns;
-  constructor(attempted, allowedPatterns) {
-    const patternsPreview = allowedPatterns.slice(0, 3).join(", ");
-    const suffix = allowedPatterns.length > 3 ? "..." : "";
-    super(
-      `Payment to "${attempted}" not allowed. Session allowlist: ${patternsPreview}${suffix}. Update the session allowlist or create a new session.`,
-      "MERCHANT_NOT_ALLOWED"
-    );
-    this.name = "MerchantNotAllowedError";
-    this.attempted = attempted;
-    this.allowedPatterns = allowedPatterns;
-  }
-};
-function isMixrPayError(error) {
-  return error instanceof MixrPayError;
-}
-function getErrorMessage(error) {
-  if (error instanceof MixrPayError) {
-    return error.message;
-  }
-  if (error instanceof Error) {
-    return error.message;
-  }
-  return String(error);
-}
+`,n&&(y+=`${n}
 
-// src/session-key.ts
-var USDC_ADDRESSES = {
-  8453: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
-  // Base Mainnet
-  84532: "0x036CbD53842c5426634e7929541eC2318f3dCF7e"
-  // Base Sepolia
-};
-var USDC_EIP712_DOMAIN_BASE = {
-  name: "USD Coin",
-  version: "2"
-};
-var TRANSFER_WITH_AUTHORIZATION_TYPES = {
-  TransferWithAuthorization: [
-    { name: "from", type: "address" },
-    { name: "to", type: "address" },
-    { name: "value", type: "uint256" },
-    { name: "validAfter", type: "uint256" },
-    { name: "validBefore", type: "uint256" },
-    { name: "nonce", type: "bytes32" }
-  ]
-};
-var SessionKey = class _SessionKey {
-  privateKey;
-  account;
-  address;
-  isTest;
-  constructor(privateKey, isTest) {
-    this.privateKey = privateKey;
-    this.account = privateKeyToAccount(privateKey);
-    this.address = this.account.address;
-    this.isTest = isTest;
-  }
-  /**
-   * Get the private key as hex string (without 0x prefix).
-   * Used for API authentication headers.
-   */
-  get privateKeyHex() {
-    return this.privateKey.slice(2);
-  }
-  /**
-   * Get the raw private key with 0x prefix.
-   * Used internally for signing operations.
-   */
-  get rawPrivateKey() {
-    return this.privateKey;
-  }
-  /**
-   * Parse a session key string into a SessionKey object.
-   * 
-   * @param sessionKey - Session key in format sk_live_... or sk_test_...
-   * @returns SessionKey object
-   * @throws InvalidSessionKeyError if the format is invalid
-   */
-  static fromString(sessionKey) {
-    const pattern = /^sk_(live|test)_([a-fA-F0-9]{64})$/;
-    const match = sessionKey.match(pattern);
-    if (!match) {
-      throw new InvalidSessionKeyError(
-        "Session key must be in format sk_live_{64_hex} or sk_test_{64_hex}"
-      );
-    }
-    const env = match[1];
-    const hexKey = match[2];
-    try {
-      const privateKey = `0x${hexKey}`;
-      return new _SessionKey(privateKey, env === "test");
-    } catch (e) {
-      throw new InvalidSessionKeyError(`Failed to decode session key: ${e}`);
-    }
-  }
-  /**
-   * Sign EIP-712 typed data for TransferWithAuthorization.
-   * 
-   * @param domain - EIP-712 domain
-   * @param message - Transfer authorization message
-   * @returns Hex-encoded signature
-   */
-  async signTransferAuthorization(domain, message) {
-    return signTypedData({
-      privateKey: this.privateKey,
-      domain,
-      types: TRANSFER_WITH_AUTHORIZATION_TYPES,
-      primaryType: "TransferWithAuthorization",
-      message
-    });
-  }
-  /**
-   * Sign a plain message (EIP-191 personal sign).
-   * 
-   * @param message - Message to sign
-   * @returns Hex-encoded signature
-   */
-  async signMessage(message) {
-    return viemSignMessage({
-      privateKey: this.privateKey,
-      message
-    });
-  }
-  /**
-   * Get the chain ID based on whether this is a test key.
-   */
-  getDefaultChainId() {
-    return this.isTest ? 84532 : 8453;
-  }
-};
-function buildTransferAuthorizationData(params) {
-  const usdcAddress = USDC_ADDRESSES[params.chainId];
-  if (!usdcAddress) {
-    throw new Error(`USDC not supported on chain ${params.chainId}`);
-  }
-  const domain = {
-    ...USDC_EIP712_DOMAIN_BASE,
-    chainId: params.chainId,
-    verifyingContract: usdcAddress
-  };
-  const message = {
-    from: params.fromAddress,
-    to: params.toAddress,
-    value: params.value,
-    validAfter: params.validAfter,
-    validBefore: params.validBefore,
-    nonce: params.nonce
-  };
-  return { domain, message };
-}
-function generateNonce() {
-  const bytes = new Uint8Array(32);
-  crypto.getRandomValues(bytes);
-  return `0x${Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("")}`;
-}
-function buildSessionAuthMessage(timestamp, address) {
-  return `MixrPay:${timestamp}:${address.toLowerCase()}`;
-}
-async function createSessionAuthPayload(sessionKey) {
-  const timestamp = Date.now();
-  const message = buildSessionAuthMessage(timestamp, sessionKey.address);
-  const signature = await sessionKey.signMessage(message);
-  return {
-    address: sessionKey.address,
-    timestamp,
-    signature
-  };
-}
-
-// src/agent-wallet.ts
-import { privateKeyToAccount as privateKeyToAccount2, signMessage } from "viem/accounts";
-
-// src/x402.ts
-async function parse402Response(response) {
-  let paymentData = null;
-  const paymentHeader = response.headers.get("X-Payment-Required");
-  if (paymentHeader) {
-    try {
-      paymentData = JSON.parse(paymentHeader);
-    } catch {
-    }
-  }
-  if (!paymentData) {
-    const authHeader = response.headers.get("WWW-Authenticate");
-    if (authHeader?.startsWith("X-402 ")) {
-      try {
-        const encoded = authHeader.slice(6);
-        paymentData = JSON.parse(atob(encoded));
-      } catch {
-      }
-    }
-  }
-  if (!paymentData) {
-    try {
-      paymentData = await response.json();
-    } catch {
-    }
-  }
-  if (!paymentData) {
-    throw new X402ProtocolError("Could not parse payment requirements from 402 response");
-  }
-  if (!paymentData.recipient) {
-    throw new X402ProtocolError("Missing recipient in payment requirements");
-  }
-  if (!paymentData.amount) {
-    throw new X402ProtocolError("Missing amount in payment requirements");
-  }
-  const now = Math.floor(Date.now() / 1e3);
-  return {
-    recipient: paymentData.recipient,
-    amount: BigInt(paymentData.amount),
-    currency: paymentData.currency || "USDC",
-    chainId: paymentData.chainId || paymentData.chain_id || 8453,
-    facilitatorUrl: paymentData.facilitatorUrl || paymentData.facilitator_url || "https://x402.org/facilitator",
-    nonce: paymentData.nonce || generateNonce().slice(2),
-    // Remove 0x prefix for storage
-    expiresAt: paymentData.expiresAt || paymentData.expires_at || now + 300,
-    description: paymentData.description
-  };
-}
-async function buildXPaymentHeader(requirements, sessionKey, walletAddress) {
-  const nonceHex = requirements.nonce.length === 64 ? `0x${requirements.nonce}` : generateNonce();
-  const now = BigInt(Math.floor(Date.now() / 1e3));
-  const validAfter = now - 60n;
-  const validBefore = BigInt(requirements.expiresAt);
-  const { domain, message } = buildTransferAuthorizationData({
-    fromAddress: walletAddress,
-    toAddress: requirements.recipient,
-    value: requirements.amount,
-    validAfter,
-    validBefore,
-    nonce: nonceHex,
-    chainId: requirements.chainId
-  });
-  const signature = await sessionKey.signTransferAuthorization(domain, message);
-  const paymentPayload = {
-    x402Version: 1,
-    scheme: "exact",
-    network: requirements.chainId === 8453 ? "base" : "base-sepolia",
-    payload: {
-      signature,
-      authorization: {
-        from: walletAddress,
-        to: requirements.recipient,
-        value: requirements.amount.toString(),
-        validAfter: validAfter.toString(),
-        validBefore: validBefore.toString(),
-        nonce: nonceHex
-      }
-    }
-  };
-  return btoa(JSON.stringify(paymentPayload));
-}
-function isPaymentExpired(requirements) {
-  return Date.now() / 1e3 > requirements.expiresAt;
-}
-function getAmountUsd(requirements) {
-  return Number(requirements.amount) / 1e6;
-}
-
-// src/agent-wallet.ts
-var SDK_VERSION = "0.8.7";
-var DEFAULT_BASE_URL = process.env.MIXRPAY_BASE_URL || "https://www.mixrpay.com";
-var DEFAULT_TIMEOUT = 3e4;
-var NETWORKS = {
-  BASE_MAINNET: { chainId: 8453, name: "Base", isTestnet: false },
-  BASE_SEPOLIA: { chainId: 84532, name: "Base Sepolia", isTestnet: true }
-};
-var LOG_LEVELS = {
-  debug: 0,
-  info: 1,
-  warn: 2,
-  error: 3,
-  none: 4
-};
-var Logger = class {
-  level;
-  prefix;
-  constructor(level = "none", prefix = "[MixrPay]") {
-    this.level = level;
-    this.prefix = prefix;
-  }
-  setLevel(level) {
-    this.level = level;
-  }
-  shouldLog(level) {
-    return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
-  }
-  debug(...args) {
-    if (this.shouldLog("debug")) {
-      console.log(`${this.prefix} \u{1F50D}`, ...args);
-    }
-  }
-  info(...args) {
-    if (this.shouldLog("info")) {
-      console.log(`${this.prefix} \u2139\uFE0F`, ...args);
-    }
-  }
-  warn(...args) {
-    if (this.shouldLog("warn")) {
-      console.warn(`${this.prefix} \u26A0\uFE0F`, ...args);
-    }
-  }
-  error(...args) {
-    if (this.shouldLog("error")) {
-      console.error(`${this.prefix} \u274C`, ...args);
-    }
-  }
-  payment(amount, recipient, description) {
-    if (this.shouldLog("info")) {
-      const desc = description ? ` for "${description}"` : "";
-      console.log(`${this.prefix} \u{1F4B8} Paid $${amount.toFixed(4)} to ${recipient.slice(0, 10)}...${desc}`);
-    }
-  }
-};
-var AgentWallet = class {
-  sessionKey;
-  walletAddress;
-  maxPaymentUsd;
-  onPayment;
-  baseUrl;
-  timeout;
-  logger;
-  // Payment tracking
-  payments = [];
-  totalSpentUsd = 0;
-  // Session key info cache
-  sessionKeyInfo;
-  sessionKeyInfoFetchedAt;
-  // Merchant allowlist (fetched from server)
-  allowlist;
-  allowlistFetchedAt;
-  /**
-   * Create a new AgentWallet instance.
-   * 
-   * @param config - Configuration options
-   * @throws {InvalidSessionKeyError} If the session key format is invalid
-   * 
-   * @example Basic initialization
-   * ```typescript
-   * const wallet = new AgentWallet({
-   *   sessionKey: 'sk_live_abc123...'
-   * });
-   * ```
-   * 
-   * @example With all options
-   * ```typescript
-   * const wallet = new AgentWallet({
-   *   sessionKey: 'sk_live_abc123...',
-   *   maxPaymentUsd: 5.0,           // Client-side safety limit
-   *   onPayment: (p) => log(p),     // Track payments
-   *   logLevel: 'info',             // Enable logging
-   *   timeout: 60000,               // 60s timeout
-   * });
-   * ```
-   */
-  constructor(config) {
-    this.validateConfig(config);
-    this.sessionKey = SessionKey.fromString(config.sessionKey);
-    this.walletAddress = config.walletAddress || this.sessionKey.address;
-    this.maxPaymentUsd = config.maxPaymentUsd;
-    this.onPayment = config.onPayment;
-    this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    this.timeout = config.timeout || DEFAULT_TIMEOUT;
-    this.logger = new Logger(config.logLevel || "none");
-    this.logger.debug("AgentWallet initialized", {
-      walletAddress: this.walletAddress,
-      isTestnet: this.isTestnet(),
-      maxPaymentUsd: this.maxPaymentUsd
-    });
-  }
-  /**
-   * Validate the configuration before initialization.
-   */
-  validateConfig(config) {
-    if (!config.sessionKey) {
-      throw new InvalidSessionKeyError(
-        "Session key is required. Get one from the wallet owner at https://mixrpay.com/manage/invites"
-      );
-    }
-    const key = config.sessionKey.trim();
-    if (!key.startsWith("sk_live_") && !key.startsWith("sk_test_")) {
-      throw new InvalidSessionKeyError(
-        `Invalid session key prefix. Expected 'sk_live_' (mainnet) or 'sk_test_' (testnet), got '${key.slice(0, 10)}...'`
-      );
-    }
-    const expectedLength = 8 + 64;
-    if (key.length !== expectedLength) {
-      throw new InvalidSessionKeyError(
-        `Invalid session key length. Expected ${expectedLength} characters, got ${key.length}. Make sure you copied the complete key.`
-      );
-    }
-    const hexPortion = key.slice(8);
-    if (!/^[0-9a-fA-F]+$/.test(hexPortion)) {
-      throw new InvalidSessionKeyError(
-        "Invalid session key format. The key should contain only hexadecimal characters after the prefix."
-      );
-    }
-    if (config.maxPaymentUsd !== void 0) {
-      if (config.maxPaymentUsd <= 0) {
-        throw new MixrPayError("maxPaymentUsd must be a positive number");
-      }
-      if (config.maxPaymentUsd > 1e4) {
-        this.logger?.warn("maxPaymentUsd is very high ($" + config.maxPaymentUsd + "). Consider using a lower limit for safety.");
-      }
-    }
-  }
-  // ===========================================================================
-  // Merchant Allowlist Validation
-  // ===========================================================================
-  /**
-   * Fetch the merchant allowlist from the server.
-   * Caches the result for 5 minutes to avoid excessive API calls.
-   */
-  async fetchAllowlist() {
-    const CACHE_TTL_MS = 5 * 60 * 1e3;
-    if (this.allowlist !== void 0 && this.allowlistFetchedAt) {
-      const age = Date.now() - this.allowlistFetchedAt;
-      if (age < CACHE_TTL_MS) {
-        return this.allowlist;
-      }
-    }
-    try {
-      const info = await this.getSessionKeyInfo();
-      this.allowlist = info.allowedMerchants || [];
-      this.allowlistFetchedAt = Date.now();
-      this.logger.debug("Fetched allowlist", {
-        patterns: this.allowlist.length,
-        allowAll: this.allowlist.length === 0
-      });
-      return this.allowlist;
-    } catch (error) {
-      this.logger.warn("Failed to fetch allowlist, allowing all merchants", { error });
-      this.allowlist = [];
-      this.allowlistFetchedAt = Date.now();
-      return this.allowlist;
-    }
-  }
-  /**
-   * Validate that a target is allowed by the session's allowlist.
-   * 
-   * @param target - URL, domain, or tool name to check
-   * @param type - Type of target: 'url' for HTTP requests, 'tool' for MCP tools
-   * @throws {MerchantNotAllowedError} If target is not in allowlist
-   */
-  async validateMerchantAllowed(target, type) {
-    const allowlist = await this.fetchAllowlist();
-    if (allowlist.length === 0) {
-      return;
-    }
-    const isAllowed = this.matchesAllowlist(target, allowlist, type);
-    if (!isAllowed) {
-      throw new MerchantNotAllowedError(target, allowlist);
-    }
-  }
-  /**
-   * Check if a target matches any pattern in the allowlist.
-   */
-  matchesAllowlist(target, allowlist, type) {
-    for (const pattern of allowlist) {
-      if (this.matchPattern(target, pattern, type)) {
-        return true;
-      }
-    }
-    return false;
-  }
-  /**
-   * Check if a target matches a single pattern.
-   */
-  matchPattern(target, pattern, type) {
-    if (type === "url") {
-      return this.matchUrlPattern(target, pattern);
-    } else {
-      return this.matchToolPattern(target, pattern);
-    }
-  }
-  /**
-   * Match a URL or domain against a pattern.
-   */
-  matchUrlPattern(target, pattern) {
-    let hostname;
-    try {
-      if (target.includes("://")) {
-        const url = new URL(target);
-        hostname = url.hostname.toLowerCase();
-      } else {
-        hostname = target.toLowerCase();
-      }
-    } catch {
-      return false;
-    }
-    const normalizedPattern = pattern.toLowerCase().trim();
-    let patternDomain = normalizedPattern;
-    if (patternDomain.includes("://")) {
-      try {
-        patternDomain = new URL(patternDomain).hostname;
-      } catch {
-      }
-    }
-    if (hostname === patternDomain) {
-      return true;
-    }
-    if (patternDomain.startsWith("*.")) {
-      const baseDomain = patternDomain.substring(2);
-      if (hostname.endsWith(`.${baseDomain}`) && hostname !== baseDomain) {
-        return true;
-      }
-    }
-    return false;
-  }
-  /**
-   * Match an MCP tool name against a pattern.
-   */
-  matchToolPattern(toolName, pattern) {
-    const normalizedTool = toolName.toLowerCase().trim();
-    const normalizedPattern = pattern.toLowerCase().trim();
-    if (normalizedTool === normalizedPattern) {
-      return true;
-    }
-    if (normalizedPattern.endsWith("/*")) {
-      const baseProvider = normalizedPattern.substring(0, normalizedPattern.length - 2);
-      if (normalizedTool.startsWith(`${baseProvider}/`)) {
-        return true;
-      }
-    }
-    return false;
-  }
-  // ===========================================================================
-  // Static Agent Registration Methods
-  // ===========================================================================
-  /**
-   * Register a new agent with MixrPay.
-   * 
-   * This creates a Privy-managed embedded wallet for the agent's payments.
-   * The agent proves ownership of their external wallet by signing a challenge.
-   * 
-   * @param options - Registration options including the private key
-   * @returns Registration result with deposit address
-   * @throws {MixrPayError} If registration fails
-   * 
-   * @example
-   * ```typescript
-   * const { depositAddress, userId } = await AgentWallet.register({
-   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
-   *   name: 'My Trading Agent',
-   * });
-   * 
-   * console.log(`Fund your agent at: ${depositAddress}`);
-   * ```
-   */
-  static async register(options) {
-    const { privateKey, name } = options;
-    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
-    const walletAddress = account.address;
-    const challengeResponse = await fetch(
-      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=register`
-    );
-    if (!challengeResponse.ok) {
-      const error = await challengeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
-    }
-    const { challenge, message } = await challengeResponse.json();
-    const signature = await signMessage({ message, privateKey });
-    const registerResponse = await fetch(`${baseUrl}/api/v1/agent/register`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        challenge,
-        external_wallet: walletAddress,
-        signature,
-        name
-      })
-    });
-    if (!registerResponse.ok) {
-      const error = await registerResponse.json().catch(() => ({}));
-      const errorMessage = error.error || `Registration failed with status ${registerResponse.status}`;
-      const requestId = error.request_id;
-      const errorCode = error.code;
-      let helpText = "";
-      if (registerResponse.status === 503) {
-        helpText = " The service may be temporarily unavailable. Please try again later.";
-      } else if (registerResponse.status === 500) {
-        helpText = " This is a server error. Please contact support with the request ID.";
-      } else if (errorCode === "MISSING_CHALLENGE" || errorCode === "MISSING_SIGNATURE") {
-        helpText = " This may indicate an SDK bug. Please update to the latest version.";
-      }
-      const fullMessage = requestId ? `${errorMessage} (request_id: ${requestId})${helpText}` : `${errorMessage}${helpText}`;
-      throw new MixrPayError(fullMessage);
-    }
-    const data = await registerResponse.json();
-    return {
-      userId: data.user_id,
-      depositAddress: data.deposit_address
-    };
-  }
-  /**
-   * Check if the MixrPay server is properly configured for agent registration.
-   * 
-   * Use this to diagnose registration issues before attempting to register.
-   * 
-   * @param baseUrl - MixrPay API base URL (default: https://www.mixrpay.com)
-   * @returns Server health status including agent registration availability
-   * 
-   * @example
-   * ```typescript
-   * const status = await AgentWallet.checkServerHealth();
-   * if (!status.agentRegistrationAvailable) {
-   *   console.error('Agent registration is not available:', status);
-   * }
-   * ```
-   */
-  static async checkServerHealth(baseUrl) {
-    const url = (baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    try {
-      const response = await fetch(`${url}/api/health/ready?details=true`);
-      if (!response.ok) {
-        return {
-          healthy: false,
-          database: "unknown",
-          agentRegistrationAvailable: false,
-          privyConfigured: false,
-          error: `Health check failed with status ${response.status}`
-        };
-      }
-      const data = await response.json();
-      return {
-        healthy: data.status === "ready",
-        database: data.database || "unknown",
-        agentRegistrationAvailable: data.services?.agentRegistration?.available ?? false,
-        privyConfigured: data.services?.privy?.configured ?? false
-      };
-    } catch (error) {
-      return {
-        healthy: false,
-        database: "unreachable",
-        agentRegistrationAvailable: false,
-        privyConfigured: false,
-        error: error instanceof Error ? error.message : "Failed to reach server"
-      };
-    }
-  }
-  /**
-   * Get a session key for an already-registered agent.
-   * 
-   * Session keys allow the agent to make payments within the specified limits.
-   * The private key is returned ONCE - store it securely!
-   * 
-   * @param options - Session key options
-   * @returns Session key result with the sk_live_ format key
-   * @throws {MixrPayError} If session key creation fails
-   * 
-   * @example
-   * ```typescript
-   * const result = await AgentWallet.getSessionKey({
-   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
-   *   spendingLimitUsd: 100,
-   *   durationDays: 30,
-   * });
-   * 
-   * // Store this securely - it's your payment key!
-   * console.log(`Session key: ${result.sessionKey}`);
-   * 
-   * // Use it to create an AgentWallet
-   * const wallet = new AgentWallet({ sessionKey: result.sessionKey });
-   * ```
-   */
-  static async getSessionKey(options) {
-    const { privateKey, spendingLimitUsd, maxPerTxUsd, maxDailyUsd, durationDays } = options;
-    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
-    const walletAddress = account.address;
-    const challengeResponse = await fetch(
-      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=session-key`
-    );
-    if (!challengeResponse.ok) {
-      const error = await challengeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
-    }
-    const { challenge, message } = await challengeResponse.json();
-    const signature = await signMessage({ message, privateKey });
-    const sessionKeyResponse = await fetch(`${baseUrl}/api/v1/agent/session-key`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        challenge,
-        external_wallet: walletAddress,
-        signature,
-        spending_limit_usd: spendingLimitUsd,
-        max_per_tx_usd: maxPerTxUsd,
-        max_daily_usd: maxDailyUsd,
-        duration_days: durationDays
-      })
-    });
-    if (!sessionKeyResponse.ok) {
-      const error = await sessionKeyResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Session key creation failed: ${sessionKeyResponse.status}`);
-    }
-    const data = await sessionKeyResponse.json();
-    return {
-      sessionKey: data.session_key,
-      address: data.address,
-      sessionKeyId: data.session_key_id,
-      expiresAt: new Date(data.expires_at),
-      limits: {
-        maxTotalUsd: data.limits.max_total_usd,
-        maxPerTxUsd: data.limits.max_per_tx_usd,
-        maxDailyUsd: data.limits.max_daily_usd
-      }
-    };
-  }
-  /**
-   * Get the status of a registered agent.
-   * 
-   * Returns balance, active sessions, and spending information.
-   * 
-   * @param options - Status options
-   * @returns Agent status
-   * @throws {MixrPayError} If status fetch fails
-   * 
-   * @example
-   * ```typescript
-   * const status = await AgentWallet.getStatus({
-   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
-   * });
-   * 
-   * console.log(`Balance: $${status.balanceUsd}`);
-   * console.log(`Active sessions: ${status.activeSessions.length}`);
-   * ```
-   */
-  static async getStatus(options) {
-    const { privateKey } = options;
-    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
-    const walletAddress = account.address;
-    const challengeResponse = await fetch(
-      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=status`
-    );
-    if (!challengeResponse.ok) {
-      const error = await challengeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
-    }
-    const { challenge, message } = await challengeResponse.json();
-    const signature = await signMessage({ message, privateKey });
-    const statusResponse = await fetch(
-      `${baseUrl}/api/v1/agent/status?challenge=${challenge}&external_wallet=${walletAddress}&signature=${encodeURIComponent(signature)}`
-    );
-    if (!statusResponse.ok) {
-      const error = await statusResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get status: ${statusResponse.status}`);
-    }
-    const data = await statusResponse.json();
-    return {
-      depositAddress: data.deposit_address,
-      balanceUsd: data.balance_usd,
-      activeSessions: data.active_sessions.map((s) => ({
-        id: s.id,
-        expiresAt: new Date(s.expires_at),
-        totalSpentUsd: s.total_spent_usd,
-        remainingUsd: s.remaining_usd,
-        maxTotalUsd: s.max_total_usd
-      })),
-      totalSpentUsd: data.total_spent_usd
-    };
-  }
-  /**
-   * Revoke a session key.
-   * 
-   * After revocation, the session key can no longer be used for payments.
-   * 
-   * @param options - Revoke options
-   * @returns true if revoked successfully
-   * @throws {MixrPayError} If revocation fails
-   * 
-   * @example
-   * ```typescript
-   * const success = await AgentWallet.revokeSessionKey({
-   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
-   *   sessionKeyId: 'session-key-uuid',
-   * });
-   * 
-   * if (success) {
-   *   console.log('Session key revoked');
-   * }
-   * ```
-   */
-  static async revokeSessionKey(options) {
-    const { privateKey, sessionKeyId } = options;
-    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
-    const walletAddress = account.address;
-    const challengeResponse = await fetch(
-      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=revoke`
-    );
-    if (!challengeResponse.ok) {
-      const error = await challengeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
-    }
-    const { challenge, message } = await challengeResponse.json();
-    const signature = await signMessage({ message, privateKey });
-    const revokeResponse = await fetch(`${baseUrl}/api/v1/agent/session-key/revoke`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        challenge,
-        external_wallet: walletAddress,
-        signature,
-        session_key_id: sessionKeyId
-      })
-    });
-    if (!revokeResponse.ok) {
-      const error = await revokeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Revocation failed: ${revokeResponse.status}`);
-    }
-    return true;
-  }
-  /**
-   * Withdraw USDC from agent's MixrPay wallet to their external wallet.
-   * 
-   * SECURITY: Withdrawals can ONLY go to the agent's own registration wallet
-   * (the wallet used during `register()`). This prevents prompt injection
-   * attacks where a compromised agent might be tricked into withdrawing
-   * to an attacker's address.
-   * 
-   * @param options - Withdrawal options
-   * @returns Withdrawal result with transaction hash
-   * @throws {MixrPayError} If withdrawal fails
-   * 
-   * @example
-   * ```typescript
-   * const result = await AgentWallet.withdraw({
-   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
-   *   amountUsd: 50.00,
-   * });
-   * 
-   * console.log(`Withdrew $${result.amountUsd}`);
-   * console.log(`Transaction: ${result.txHash}`);
-   * console.log(`Remaining balance: $${result.remainingBalanceUsd}`);
-   * ```
-   */
-  static async withdraw(options) {
-    const { privateKey, amountUsd } = options;
-    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
-    const walletAddress = account.address;
-    const challengeResponse = await fetch(
-      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=withdraw`
-    );
-    if (!challengeResponse.ok) {
-      const error = await challengeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
-    }
-    const { challenge, message } = await challengeResponse.json();
-    const signature = await signMessage({ message, privateKey });
-    const withdrawResponse = await fetch(`${baseUrl}/api/v1/agent/withdraw`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        challenge,
-        external_wallet: walletAddress,
-        signature,
-        to_address: walletAddress,
-        // Always withdraw to self
-        amount_usd: amountUsd
-      })
-    });
-    if (!withdrawResponse.ok) {
-      const error = await withdrawResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Withdrawal failed: ${withdrawResponse.status}`);
-    }
-    const data = await withdrawResponse.json();
-    return {
-      txHash: data.tx_hash,
-      amountUsd: data.amount_usd,
-      remainingBalanceUsd: data.remaining_balance_usd
-    };
-  }
-  /**
-   * Claim an agent invite code to receive a session key for the inviter's wallet.
-   * 
-   * This allows an agent to get a pre-configured session key from a human wallet owner
-   * without needing to register their own wallet or fund it. The human sets the budget
-   * limits and merchant whitelist when creating the invite.
-   * 
-   * @param options - Claim invite options including the invite code and agent's private key
-   * @returns Claim result with the new session key
-   * @throws {MixrPayError} If claiming fails (e.g., invalid code, already claimed, expired)
-   * 
-   * @example
-   * ```typescript
-   * // Human creates invite at https://mixrpay.com/manage/invites, shares code "mixr-abc123"
-   * 
-   * const result = await AgentWallet.claimInvite({
-   *   inviteCode: 'mixr-abc123',
-   *   privateKey: process.env.AGENT_WALLET_KEY as `0x${string}`,
-   * });
-   * 
-   * console.log(`Got session key: ${result.sessionKey}`);
-   * console.log(`Budget: $${result.limits.budgetUsd}/${result.limits.budgetPeriod}`);
-   * console.log(`Invited by: ${result.inviterName}`);
-   * 
-   * // Use the session key to make payments
-   * const wallet = new AgentWallet({ sessionKey: result.sessionKey });
-   * const response = await wallet.fetch('https://api.example.com/endpoint');
-   * ```
-   */
-  static async claimInvite(options) {
-    const { inviteCode, privateKey } = options;
-    const baseUrl = (options.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const account = privateKeyToAccount2(privateKey);
-    const walletAddress = account.address;
-    const challengeResponse = await fetch(
-      `${baseUrl}/api/v1/agent/challenge?wallet=${walletAddress}&action=claim-invite`
-    );
-    if (!challengeResponse.ok) {
-      const error = await challengeResponse.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get challenge: ${challengeResponse.status}`);
-    }
-    const { challenge, message } = await challengeResponse.json();
-    const signature = await signMessage({ message, privateKey });
-    const claimResponse = await fetch(`${baseUrl}/api/v1/agent/claim-invite`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        invite_code: inviteCode,
-        challenge,
-        agent_wallet_address: walletAddress,
-        signature
-      })
-    });
-    if (!claimResponse.ok) {
-      const error = await claimResponse.json().catch(() => ({}));
-      const errorMessage = error.error || `Failed to claim invite: ${claimResponse.status}`;
-      let helpText = "";
-      if (claimResponse.status === 404) {
-        helpText = " The invite code may be invalid or misspelled.";
-      } else if (claimResponse.status === 400) {
-        if (errorMessage.includes("already claimed")) {
-          helpText = " This invite has already been used by another agent.";
-        } else if (errorMessage.includes("expired")) {
-          helpText = " Ask the wallet owner to create a new invite.";
-        } else if (errorMessage.includes("revoked")) {
-          helpText = " The wallet owner has revoked this invite.";
-        }
-      }
-      throw new MixrPayError(`${errorMessage}${helpText}`);
-    }
-    const data = await claimResponse.json();
-    return {
-      sessionKey: data.session_key,
-      address: data.address,
-      sessionKeyId: data.session_key_id,
-      expiresAt: new Date(data.expires_at),
-      limits: {
-        budgetUsd: data.limits.budget_usd,
-        budgetPeriod: data.limits.budget_period,
-        maxPerTxUsd: data.limits.max_per_tx_usd
-      },
-      allowedMerchants: data.allowed_merchants || [],
-      inviterName: data.inviter_name || "Anonymous"
-    };
-  }
-  // ===========================================================================
-  // Nested Budget Delegation Methods
-  // ===========================================================================
-  /**
-   * Spawn a child invite for sub-agents.
-   * 
-   * Allows an agent to create an invite code for a sub-agent with a portion
-   * of their remaining budget (max 20%). The child inherits merchant restrictions
-   * and cannot outlive the parent session.
-   * 
-   * @param options - Spawn options
-   * @returns The created child invite details
-   * 
-   * @throws {MixrPayError} If spawning fails (insufficient budget, depth limit, etc.)
-   * 
-   * @example
-   * ```typescript
-   * const wallet = new AgentWallet({ sessionKey: 'sk_live_...' });
-   * 
-   * // Spawn a child invite for a sub-agent
-   * const childInvite = await wallet.spawnChildInvite({
-   *   budgetUsd: 10.00,  // Max 20% of available budget
-   *   name: 'Research Sub-Agent',
-   *   allowedMerchants: ['firecrawl.dev'],  // Must be subset of parent
-   *   expiresInDays: 7,  // Will be capped to parent's expiry
-   * });
-   * 
-   * console.log(`Share with sub-agent: ${childInvite.inviteCode}`);
-   * console.log(`Child can spawn up to: $${childInvite.maxSpawnBudget}`);
-   * ```
-   */
-  async spawnChildInvite(options) {
-    const { budgetUsd, name, allowedMerchants, expiresInDays } = options;
-    const timestamp = Date.now();
-    const nonce = crypto.randomUUID();
-    const message = `spawn:${timestamp}:${nonce}`;
-    const signature = await signMessage({
-      message,
-      privateKey: this.sessionKey.rawPrivateKey
-    });
-    const response = await fetch(`${this.baseUrl}/api/v1/agent/spawn`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        session_key: this.sessionKey.toString(),
-        signature,
-        message,
-        budget_usd: budgetUsd,
-        name,
-        allowed_merchants: allowedMerchants,
-        expires_in_days: expiresInDays
-      })
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      if (response.status === 409) {
-        throw new MixrPayError("Concurrent modification - please retry");
-      }
-      if (response.status === 429) {
-        throw new MixrPayError("Rate limited - too many spawn attempts");
-      }
-      throw new MixrPayError(error.error || `Failed to spawn child: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      inviteCode: data.invite_code,
-      inviteId: data.invite_id,
-      budgetUsd: data.budget_usd,
-      expiresAt: new Date(data.expires_at),
-      depth: data.depth,
-      maxSpawnBudget: data.max_spawn_budget,
-      allowedMerchants: data.allowed_merchants || []
-    };
-  }
-  /**
-   * Get available budget information for spawning.
-   * 
-   * Returns the current budget status including how much can be spawned
-   * to child agents (20% of available).
-   * 
-   * @returns Budget information
-   * 
-   * @example
-   * ```typescript
-   * const budget = await wallet.getAvailableBudget();
-   * 
-   * console.log(`Total budget: $${budget.totalBudget}`);
-   * console.log(`Spent: $${budget.spent}`);
-   * console.log(`Allocated to children: $${budget.allocatedToChildren}`);
-   * console.log(`Available: $${budget.available}`);
-   * console.log(`Max spawn budget: $${budget.maxSpawnBudget}`);
-   * 
-   * if (budget.canSpawn && budget.maxSpawnBudget >= 5.00) {
-   *   // Safe to spawn a $5 child
-   * }
-   * ```
-   */
-  async getAvailableBudget() {
-    const response = await fetch(`${this.baseUrl}/api/v1/agent/descendants`, {
-      method: "GET",
-      headers: {
-        "Authorization": `Bearer ${this.sessionKey.toString()}`
-      }
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get budget: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      totalBudget: data.budget.total_usd,
-      spent: data.budget.spent_usd,
-      allocatedToChildren: data.budget.allocated_to_children_usd,
-      available: data.budget.available_usd,
-      maxSpawnBudget: data.max_spawn_budget,
-      canSpawn: data.can_spawn
-    };
-  }
-  /**
-   * Get all child sessions spawned by this session.
-   * 
-   * Returns a tree of child invites/sessions including their spending status.
-   * 
-   * @returns Array of child sessions
-   * 
-   * @example
-   * ```typescript
-   * const children = await wallet.getChildSessions();
-   * 
-   * for (const child of children) {
-   *   console.log(`${child.name}: $${child.spentUsd}/$${child.budgetUsd}`);
-   *   console.log(`  Status: ${child.status}`);
-   *   console.log(`  Depth: ${child.depth}`);
-   *   
-   *   if (child.children) {
-   *     console.log(`  Has ${child.children.length} grandchildren`);
-   *   }
-   * }
-   * ```
-   */
-  async getChildSessions() {
-    const response = await fetch(`${this.baseUrl}/api/v1/agent/descendants`, {
-      method: "GET",
-      headers: {
-        "Authorization": `Bearer ${this.sessionKey.toString()}`
-      }
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get children: ${response.status}`);
-    }
-    const data = await response.json();
-    return data.children || [];
-  }
-  /**
-   * List child sessions spawned by this agent.
-   * 
-   * Alias for `getChildSessions()` for naming consistency.
-   * 
-   * @returns Array of child session info
-   */
-  async listChildSessions() {
-    return this.getChildSessions();
-  }
-  // ===========================================================================
-  // Core Methods
-  // ===========================================================================
-  /**
-   * Make an HTTP request, automatically handling x402 payment if required.
-   * 
-   * This is a drop-in replacement for the native `fetch()` function.
-   * If the server returns 402 Payment Required:
-   * 1. Parse payment requirements from response
-   * 2. Sign transferWithAuthorization using session key
-   * 3. Retry request with X-PAYMENT header
-   * 
-   * @param url - Request URL
-   * @param init - Request options (same as native fetch)
-   * @returns Response from the server
-   * 
-   * @throws {InsufficientBalanceError} If wallet doesn't have enough USDC
-   * @throws {SessionKeyExpiredError} If session key has expired
-   * @throws {SpendingLimitExceededError} If payment would exceed limits
-   * @throws {PaymentFailedError} If payment transaction failed
-   * 
-   * @example GET request
-   * ```typescript
-   * const response = await wallet.fetch('https://api.example.com/data');
-   * const data = await response.json();
-   * ```
-   * 
-   * @example POST request with JSON
-   * ```typescript
-   * const response = await wallet.fetch('https://api.example.com/generate', {
-   *   method: 'POST',
-   *   headers: { 'Content-Type': 'application/json' },
-   *   body: JSON.stringify({ prompt: 'Hello world' })
-   * });
-   * ```
-   */
-  async fetch(url, init) {
-    this.logger.debug(`Fetching ${init?.method || "GET"} ${url}`);
-    await this.validateMerchantAllowed(url, "url");
-    const requestId = crypto.randomUUID();
-    const correlationId = this.extractCorrelationId(init?.headers);
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      let response = await fetch(url, {
-        ...init,
-        signal: controller.signal
-      });
-      this.logger.debug(`Initial response: ${response.status}`);
-      if (response.status === 402) {
-        this.logger.info(`Payment required for ${url}`);
-        response = await this.handlePaymentRequired(url, init, response, requestId, correlationId);
-      }
-      return response;
-    } catch (error) {
-      if (error instanceof Error && error.name === "AbortError") {
-        throw new MixrPayError(`Request timeout after ${this.timeout}ms`);
-      }
-      throw error;
-    } finally {
-      clearTimeout(timeoutId);
-    }
-  }
-  /**
-   * Extract correlation ID from request headers.
-   */
-  extractCorrelationId(headers) {
-    if (!headers) return void 0;
-    if (headers instanceof Headers) {
-      return headers.get("X-Correlation-Id") || headers.get("x-correlation-id") || void 0;
-    }
-    if (Array.isArray(headers)) {
-      const entry = headers.find(
-        ([key]) => key.toLowerCase() === "x-correlation-id"
-      );
-      return entry ? entry[1] : void 0;
-    }
-    const record = headers;
-    return record["X-Correlation-Id"] || record["x-correlation-id"] || void 0;
-  }
-  /**
-   * Handle a 402 Payment Required response.
-   */
-  async handlePaymentRequired(url, init, response, requestId, correlationId) {
-    let requirements;
-    try {
-      requirements = await parse402Response(response);
-      this.logger.debug("Payment requirements:", {
-        amount: `$${getAmountUsd(requirements).toFixed(4)}`,
-        recipient: requirements.recipient,
-        description: requirements.description
-      });
-    } catch (e) {
-      this.logger.error("Failed to parse payment requirements:", e);
-      throw new PaymentFailedError(
-        `Failed to parse payment requirements: ${e}. The server may not be properly configured for x402 payments.`
-      );
-    }
-    if (isPaymentExpired(requirements)) {
-      throw new PaymentFailedError(
-        "Payment requirements have expired. This usually means the request took too long. Try again."
-      );
-    }
-    const amountUsd = getAmountUsd(requirements);
-    if (this.maxPaymentUsd !== void 0 && amountUsd > this.maxPaymentUsd) {
-      throw new SpendingLimitExceededError(
-        "client_max",
-        this.maxPaymentUsd,
-        amountUsd
-      );
-    }
-    let xPayment;
-    try {
-      this.logger.debug("Signing payment authorization...");
-      xPayment = await buildXPaymentHeader(
-        requirements,
-        this.sessionKey,
-        this.walletAddress
-      );
-    } catch (e) {
-      this.logger.error("Failed to sign payment:", e);
-      throw new PaymentFailedError(
-        `Failed to sign payment: ${e}. This may indicate an issue with the session key.`
-      );
-    }
-    this.logger.debug("Retrying request with payment...");
-    const headers = new Headers(init?.headers);
-    headers.set("X-PAYMENT", xPayment);
-    const retryResponse = await fetch(url, {
-      ...init,
-      headers
-    });
-    if (retryResponse.status !== 402) {
-      const payment = {
-        amountUsd,
-        recipient: requirements.recipient,
-        txHash: retryResponse.headers.get("X-Payment-TxHash"),
-        timestamp: /* @__PURE__ */ new Date(),
-        description: requirements.description,
-        url,
-        requestId,
-        correlationId
-      };
-      this.payments.push(payment);
-      this.totalSpentUsd += amountUsd;
-      this.logger.payment(amountUsd, requirements.recipient, requirements.description);
-      if (this.onPayment) {
-        this.onPayment(payment);
-      }
-    } else {
-      await this.handlePaymentError(retryResponse);
-    }
-    return retryResponse;
-  }
-  /**
-   * Handle payment-specific errors from the response.
-   */
-  async handlePaymentError(response) {
-    let errorData = {};
-    try {
-      errorData = await response.json();
-    } catch {
-    }
-    const errorCode = errorData.error_code || "";
-    const errorMessage = errorData.error || errorData.message || "Payment required";
-    this.logger.error("Payment failed:", { errorCode, errorMessage, errorData });
-    if (errorCode === "insufficient_balance") {
-      const required = errorData.required || 0;
-      const available = errorData.available || 0;
-      throw new InsufficientBalanceError(required, available);
-    } else if (errorCode === "session_key_expired") {
-      throw new SessionKeyExpiredError(errorData.expired_at || "unknown");
-    } else if (errorCode === "spending_limit_exceeded") {
-      throw new SpendingLimitExceededError(
-        errorData.limit_type || "unknown",
-        errorData.limit || 0,
-        errorData.attempted || 0
-      );
-    } else {
-      throw new PaymentFailedError(errorMessage);
-    }
-  }
-  // ===========================================================================
-  // Wallet Information
-  // ===========================================================================
-  /**
-   * Get the wallet address.
-   * 
-   * @returns The Ethereum address of the smart wallet
-   */
-  getWalletAddress() {
-    return this.walletAddress;
-  }
-  /**
-   * Check if using testnet session key.
-   * 
-   * @returns true if using Base Sepolia (testnet), false if using Base Mainnet
-   */
-  isTestnet() {
-    return this.sessionKey.isTest;
-  }
-  /**
-   * Get the network information.
-   * 
-   * @returns Network details including chain ID and name
-   */
-  getNetwork() {
-    return this.isTestnet() ? NETWORKS.BASE_SEPOLIA : NETWORKS.BASE_MAINNET;
-  }
-  /**
-   * Get current USDC balance of the wallet.
-   * 
-   * @returns USDC balance in USD
-   * 
-   * @example
-   * ```typescript
-   * const balance = await wallet.getBalance();
-   * console.log(`Balance: $${balance.toFixed(2)}`);
-   * ```
-   */
-  async getBalance() {
-    this.logger.debug("Fetching wallet balance...");
-    try {
-      const infoResponse = await fetch(`${this.baseUrl}/api/v1/session-key/info`, {
-        headers: {
-          "X-Session-Key": this.sessionKey.address.toLowerCase()
-        }
-      });
-      if (!infoResponse.ok) {
-        throw new Error("Failed to get session key info");
-      }
-      const info = await infoResponse.json();
-      const walletAddress = info.wallet_address || info.walletAddress;
-      if (!walletAddress) {
-        throw new Error("No wallet address in session key info");
-      }
-      const response = await fetch(
-        `${this.baseUrl}/api/wallet/balance?address=${walletAddress}&chain=base`
-      );
-      if (response.ok) {
-        const data = await response.json();
-        const balance = data.balance_usdc || data.balance_usd || 0;
-        this.logger.debug(`Balance: $${balance}`);
-        return balance;
-      }
-    } catch (error) {
-      this.logger.warn("Failed to fetch balance:", error);
-    }
-    this.logger.debug("Using estimated balance based on tracking");
-    return Math.max(0, 100 - this.totalSpentUsd);
-  }
-  /**
-   * Check if the wallet can afford a specific amount.
-   * 
-   * This is a convenience method to check balance before making a request
-   * when you know the expected cost.
-   * 
-   * @param amountUsd - Amount to check in USD
-   * @returns Object with affordability information
-   * 
-   * @example
-   * ```typescript
-   * const check = await wallet.canAfford(5.00);
-   * if (check.canAfford) {
-   *   console.log(`Can afford! Will have $${check.remainingAfter.toFixed(2)} left`);
-   *   await wallet.fetch(url);
-   * } else {
-   *   console.log(`Need $${check.shortfall.toFixed(2)} more`);
-   * }
-   * ```
-   */
-  async canAfford(amountUsd) {
-    const balance = await this.getBalance();
-    const canAfford = balance >= amountUsd;
-    return {
-      canAfford,
-      balance,
-      shortfall: canAfford ? 0 : amountUsd - balance,
-      remainingAfter: canAfford ? balance - amountUsd : 0
-    };
-  }
-  /**
-   * Get information about the session key.
-   * 
-   * @param refresh - Force refresh from server (default: use cache if < 60s old)
-   * @returns Session key details including limits and expiration
-   * 
-   * @example
-   * ```typescript
-   * const info = await wallet.getSessionKeyInfo();
-   * console.log(`Daily limit: $${info.limits.dailyUsd}`);
-   * console.log(`Expires: ${info.expiresAt}`);
-   * ```
-   */
-  async getSessionKeyInfo(refresh = false) {
-    const cacheAge = this.sessionKeyInfoFetchedAt ? Date.now() - this.sessionKeyInfoFetchedAt : Infinity;
-    if (!refresh && this.sessionKeyInfo && cacheAge < 6e4) {
-      return this.sessionKeyInfo;
-    }
-    this.logger.debug("Fetching session key info...");
-    try {
-      const response = await fetch(`${this.baseUrl}/api/v1/session-key/info`, {
-        headers: {
-          "X-Session-Key": this.sessionKey.address.toLowerCase()
-        }
-      });
-      if (response.ok) {
-        const data = await response.json();
-        this.sessionKeyInfo = {
-          address: this.sessionKey.address,
-          walletAddress: data.wallet_address ?? data.walletAddress ?? null,
-          isValid: data.is_valid ?? data.isValid ?? true,
-          limits: {
-            perTxUsd: data.per_tx_limit_usd ?? data.perTxLimitUsd ?? null,
-            dailyUsd: data.daily_limit_usd ?? data.dailyLimitUsd ?? null,
-            totalUsd: data.total_limit_usd ?? data.totalLimitUsd ?? null
-          },
-          usage: {
-            todayUsd: data.today_spent_usd ?? data.todaySpentUsd ?? 0,
-            totalUsd: data.total_spent_usd ?? data.totalSpentUsd ?? 0,
-            txCount: data.tx_count ?? data.txCount ?? 0
-          },
-          expiresAt: data.expires_at ? new Date(data.expires_at) : null,
-          createdAt: data.created_at ? new Date(data.created_at) : null,
-          name: data.name,
-          allowedMerchants: data.allowed_merchants ?? data.allowedMerchants ?? []
-        };
-        this.sessionKeyInfoFetchedAt = Date.now();
-        return this.sessionKeyInfo;
-      }
-    } catch (error) {
-      this.logger.warn("Failed to fetch session key info:", error);
-    }
-    return {
-      address: this.sessionKey.address,
-      walletAddress: null,
-      isValid: true,
-      limits: { perTxUsd: null, dailyUsd: null, totalUsd: null },
-      usage: { todayUsd: this.totalSpentUsd, totalUsd: this.totalSpentUsd, txCount: this.payments.length },
-      expiresAt: null,
-      createdAt: null
-    };
-  }
-  /**
-   * Get spending stats for this session key.
-   * 
-   * @returns Spending statistics
-   * 
-   * @example
-   * ```typescript
-   * const stats = await wallet.getSpendingStats();
-   * console.log(`Spent: $${stats.totalSpentUsd.toFixed(2)}`);
-   * console.log(`Remaining daily: $${stats.remainingDailyUsd?.toFixed(2) ?? 'unlimited'}`);
-   * ```
-   */
-  async getSpendingStats() {
-    this.logger.debug("Fetching spending stats...");
-    try {
-      const response = await fetch(`${this.baseUrl}/api/v1/session-key/stats`, {
-        headers: {
-          "X-Session-Key": this.sessionKey.address.toLowerCase()
-        }
-      });
-      if (response.ok) {
-        const data = await response.json();
-        return {
-          totalSpentUsd: data.total_spent_usd || data.totalSpentUsd || this.totalSpentUsd,
-          txCount: data.tx_count || data.txCount || this.payments.length,
-          remainingDailyUsd: data.remaining_daily_usd || data.remainingDailyUsd || null,
-          remainingTotalUsd: data.remaining_total_usd || data.remainingTotalUsd || null,
-          expiresAt: data.expires_at ? new Date(data.expires_at) : null
-        };
-      }
-    } catch (error) {
-      this.logger.warn("Failed to fetch spending stats:", error);
-    }
-    return {
-      totalSpentUsd: this.totalSpentUsd,
-      txCount: this.payments.length,
-      remainingDailyUsd: null,
-      remainingTotalUsd: null,
-      expiresAt: null
-    };
-  }
-  /**
-   * Get list of payments made in this session.
-   * 
-   * @returns Array of payment events
-   */
-  getPaymentHistory() {
-    return [...this.payments];
-  }
-  /**
-   * Get the total amount spent in this session.
-   * 
-   * @returns Total spent in USD
-   */
-  getTotalSpent() {
-    return this.totalSpentUsd;
-  }
-  // ===========================================================================
-  // Diagnostics
-  // ===========================================================================
-  /**
-   * Run diagnostics to verify the wallet is properly configured.
-   * 
-   * This is useful for debugging integration issues.
-   * 
-   * @returns Diagnostic results with status and any issues found
-   * 
-   * @example
-   * ```typescript
-   * const diagnostics = await wallet.runDiagnostics();
-   * if (diagnostics.healthy) {
-   *   console.log('✅ Wallet is ready to use');
-   * } else {
-   *   console.log('❌ Issues found:');
-   *   diagnostics.issues.forEach(issue => console.log(`  - ${issue}`));
-   * }
-   * ```
-   */
-  async runDiagnostics() {
-    this.logger.info("Running diagnostics...");
-    const issues = [];
-    const recommendations = [];
-    const checks = {};
-    let latencyMs;
-    let sessionLimits;
-    checks.sessionKeyFormat = true;
-    try {
-      const startTime = Date.now();
-      const response = await fetch(`${this.baseUrl}/health`, {
-        method: "GET",
-        signal: AbortSignal.timeout(5e3)
-      });
-      latencyMs = Date.now() - startTime;
-      checks.apiConnectivity = response.ok;
-      if (!response.ok) {
-        issues.push(`API server returned ${response.status}. Check baseUrl configuration.`);
-        recommendations.push("Verify the baseUrl configuration points to a valid MixrPay server.");
-      }
-      if (latencyMs > 2e3) {
-        issues.push(`High API latency: ${latencyMs}ms. This may cause timeouts.`);
-        recommendations.push("Consider using a server closer to your region or check network connectivity.");
-      }
-    } catch {
-      checks.apiConnectivity = false;
-      issues.push("Cannot connect to MixrPay API. Check your network connection and baseUrl.");
-      recommendations.push("Verify network connectivity and that the MixrPay server is running.");
-    }
-    try {
-      const info = await this.getSessionKeyInfo(true);
-      checks.sessionKeyValid = info.isValid;
-      if (!info.isValid) {
-        issues.push("Session key is invalid or has been revoked.");
-        recommendations.push("Request a new session key from the wallet owner at https://mixrpay.com/manage/invites");
-      }
-      const now = /* @__PURE__ */ new Date();
-      let expiresInHours = null;
-      if (info.expiresAt) {
-        expiresInHours = (info.expiresAt.getTime() - now.getTime()) / (1e3 * 60 * 60);
-        if (info.expiresAt < now) {
-          checks.sessionKeyValid = false;
-          issues.push(`Session key expired on ${info.expiresAt.toISOString()}`);
-          recommendations.push("Create a new session key to continue making payments.");
-        } else if (expiresInHours < 24) {
-          issues.push(`Session key expires in ${expiresInHours.toFixed(1)} hours.`);
-          recommendations.push("Consider creating a new session key before the current one expires.");
-        }
-      }
-      const stats = await this.getSpendingStats();
-      sessionLimits = {
-        remainingDailyUsd: stats.remainingDailyUsd,
-        remainingTotalUsd: stats.remainingTotalUsd,
-        expiresAt: info.expiresAt,
-        expiresInHours
-      };
-      if (stats.remainingDailyUsd !== null && stats.remainingDailyUsd < 1) {
-        issues.push(`Daily limit nearly exhausted: $${stats.remainingDailyUsd.toFixed(2)} remaining.`);
-        recommendations.push("Wait until tomorrow for daily limit to reset, or request a higher daily limit.");
-      }
-      if (stats.remainingTotalUsd !== null && stats.remainingTotalUsd < 1) {
-        issues.push(`Total limit nearly exhausted: $${stats.remainingTotalUsd.toFixed(2)} remaining.`);
-        recommendations.push("Request a new session key with a higher total limit.");
-      }
-    } catch {
-      checks.sessionKeyValid = false;
-      issues.push("Could not verify session key validity.");
-      recommendations.push("Check network connectivity and try again.");
-    }
-    let balance = 0;
-    try {
-      balance = await this.getBalance();
-      checks.hasBalance = balance > 0;
-      if (balance <= 0) {
-        issues.push("Wallet has no USDC balance. Top up at https://mixrpay.com/manage/wallet");
-        recommendations.push("Deposit USDC to your wallet address to enable payments.");
-      } else if (balance < 1) {
-        issues.push(`Low balance: $${balance.toFixed(2)}. Consider topping up.`);
-        recommendations.push("Top up your wallet balance to avoid payment failures.");
-      }
-    } catch {
-      checks.hasBalance = false;
-      issues.push("Could not fetch wallet balance.");
-      recommendations.push("Check network connectivity and try again.");
-    }
-    const healthy = issues.length === 0;
-    this.logger.info("Diagnostics complete:", { healthy, issues, latencyMs });
-    return {
-      healthy,
-      issues,
-      checks,
-      sdkVersion: SDK_VERSION,
-      network: this.getNetwork().name,
-      walletAddress: this.walletAddress,
-      sessionLimits,
-      latencyMs,
-      recommendations
-    };
-  }
-  /**
-   * Enable or disable debug logging.
-   * 
-   * @param enable - true to enable debug logging, false to disable
-   * 
-   * @example
-   * ```typescript
-   * wallet.setDebug(true);  // Enable detailed logs
-   * await wallet.fetch(...);
-   * wallet.setDebug(false); // Disable logs
-   * ```
-   */
-  setDebug(enable) {
-    this.logger.setLevel(enable ? "debug" : "none");
-  }
-  /**
-   * Set the log level.
-   * 
-   * @param level - 'debug' | 'info' | 'warn' | 'error' | 'none'
-   */
-  setLogLevel(level) {
-    this.logger.setLevel(level);
-  }
-  // ===========================================================================
-  // Session Authorization Methods (for MixrPay Merchants)
-  // ===========================================================================
-  /**
-   * Create the X-Session-Auth header for secure API authentication.
-   * Uses signature-based authentication - private key is NEVER transmitted.
-   * 
-   * @returns Headers object with X-Session-Auth
-   */
-  async getSessionAuthHeaders() {
-    const payload = await createSessionAuthPayload(this.sessionKey);
-    return {
-      "X-Session-Auth": JSON.stringify(payload)
-    };
-  }
-  /**
-   * Get an existing session or create a new one with a MixrPay merchant.
-   * 
-   * This is the recommended way to interact with MixrPay-enabled APIs.
-   * If an active session exists, it will be returned. Otherwise, a new
-   * session authorization request will be created and confirmed.
-   * 
-   * @param options - Session creation options
-   * @returns Active session authorization
-   * 
-   * @throws {MixrPayError} If merchant is not found or session creation fails
-   * 
-   * @example
-   * ```typescript
-   * const session = await wallet.getOrCreateSession({
-   *   merchantPublicKey: 'pk_live_abc123...',
-   *   spendingLimitUsd: 25.00,
-   *   durationDays: 7,
-   * });
-   * 
-   * console.log(`Session active: $${session.remainingLimitUsd} remaining`);
-   * ```
-   */
-  async getOrCreateSession(options) {
-    this.logger.debug("getOrCreateSession called", options);
-    const { merchantPublicKey, spendingLimitUsd = 25, durationDays = 7 } = options;
-    try {
-      const existingSession = await this.getSessionByMerchant(merchantPublicKey);
-      if (existingSession && existingSession.status === "active") {
-        this.logger.debug("Found existing active session", existingSession.id);
-        return existingSession;
-      }
-    } catch {
-    }
-    this.logger.info(`Creating new session with merchant ${merchantPublicKey.slice(0, 20)}...`);
-    const authHeaders = await this.getSessionAuthHeaders();
-    const authorizeResponse = await fetch(`${this.baseUrl}/api/v2/session/authorize`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify({
-        merchant_public_key: merchantPublicKey,
-        spending_limit_usd: spendingLimitUsd,
-        duration_days: durationDays
-      })
-    });
-    if (!authorizeResponse.ok) {
-      const error = await authorizeResponse.json().catch(() => ({}));
-      throw new MixrPayError(
-        error.message || error.error || `Failed to create session: ${authorizeResponse.status}`
-      );
-    }
-    const authorizeData = await authorizeResponse.json();
-    const sessionId = authorizeData.session_id;
-    const messageToSign = authorizeData.message_to_sign;
-    if (!sessionId || !messageToSign) {
-      throw new MixrPayError("Invalid authorize response: missing session_id or message_to_sign");
-    }
-    this.logger.debug("Signing session authorization message...");
-    const signature = await this.sessionKey.signMessage(messageToSign);
-    const confirmResponse = await fetch(`${this.baseUrl}/api/v2/session/confirm`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json"
-      },
-      body: JSON.stringify({
-        session_id: sessionId,
-        signature,
-        wallet_address: this.walletAddress
-      })
-    });
-    if (!confirmResponse.ok) {
-      const error = await confirmResponse.json().catch(() => ({}));
-      throw new MixrPayError(
-        error.message || `Failed to confirm session: ${confirmResponse.status}`
-      );
-    }
-    const confirmData = await confirmResponse.json();
-    this.logger.info(`Session created: ${confirmData.session?.id || sessionId}`);
-    return this.parseSessionResponse(confirmData.session || confirmData);
-  }
-  /**
-   * Get session status for a specific merchant.
-   * 
-   * @param merchantPublicKey - The merchant's public key
-   * @returns Session authorization or null if not found
-   */
-  async getSessionByMerchant(merchantPublicKey) {
-    this.logger.debug("getSessionByMerchant", merchantPublicKey);
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/session/status?merchant_public_key=${encodeURIComponent(merchantPublicKey)}`, {
-      headers: authHeaders
-    });
-    if (response.status === 404) {
-      return null;
-    }
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.message || `Failed to get session: ${response.status}`);
-    }
-    const data = await response.json();
-    return data.session ? this.parseSessionResponse(data.session) : null;
-  }
-  /**
-   * List all session authorizations for this wallet.
-   * 
-   * @returns Array of session authorizations
-   * 
-   * @example
-   * ```typescript
-   * const sessions = await wallet.listSessions();
-   * for (const session of sessions) {
-   *   console.log(`${session.merchantName}: $${session.remainingLimitUsd} remaining`);
-   * }
-   * ```
-   */
-  async listSessions() {
-    this.logger.debug("listSessions");
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/session/list`, {
-      headers: authHeaders
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.message || `Failed to list sessions: ${response.status}`);
-    }
-    const data = await response.json();
-    return (data.sessions || []).map((s) => this.parseSessionResponse(s));
-  }
-  /**
-   * Revoke a session authorization.
-   * 
-   * After revocation, no further charges can be made against this session.
-   * 
-   * @param sessionId - The session ID to revoke
-   * @returns true if revoked successfully
-   * 
-   * @example
-   * ```typescript
-   * const revoked = await wallet.revokeSession('sess_abc123');
-   * if (revoked) {
-   *   console.log('Session revoked successfully');
-   * }
-   * ```
-   */
-  async revokeSession(sessionId) {
-    this.logger.debug("revokeSession", sessionId);
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/session/revoke`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify({ session_id: sessionId })
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      this.logger.error("Failed to revoke session:", error);
-      return false;
-    }
-    this.logger.info(`Session ${sessionId} revoked`);
-    return true;
-  }
-  /**
-   * Get statistics about all session authorizations.
-   * 
-   * This provides an overview of active, expired, and revoked sessions,
-   * along with aggregate spending information.
-   * 
-   * @returns Session statistics
-   * 
-   * @example
-   * ```typescript
-   * const stats = await wallet.getSessionStats();
-   * console.log(`Active sessions: ${stats.activeCount}`);
-   * console.log(`Total authorized: $${stats.totalAuthorizedUsd.toFixed(2)}`);
-   * console.log(`Total remaining: $${stats.totalRemainingUsd.toFixed(2)}`);
-   * 
-   * for (const session of stats.activeSessions) {
-   *   console.log(`${session.merchantName}: $${session.remainingUsd} remaining`);
-   * }
-   * ```
-   */
-  async getSessionStats() {
-    this.logger.debug("getSessionStats");
-    const sessions = await this.listSessions();
-    const now = /* @__PURE__ */ new Date();
-    const active = [];
-    const expired = [];
-    const revoked = [];
-    for (const session of sessions) {
-      if (session.status === "revoked") {
-        revoked.push(session);
-      } else if (session.status === "expired" || session.expiresAt && session.expiresAt < now) {
-        expired.push(session);
-      } else if (session.status === "active") {
-        active.push(session);
-      }
-    }
-    const totalAuthorizedUsd = active.reduce((sum, s) => sum + s.spendingLimitUsd, 0);
-    const totalSpentUsd = sessions.reduce((sum, s) => sum + s.amountUsedUsd, 0);
-    const totalRemainingUsd = active.reduce((sum, s) => sum + s.remainingLimitUsd, 0);
-    return {
-      activeCount: active.length,
-      expiredCount: expired.length,
-      revokedCount: revoked.length,
-      totalAuthorizedUsd,
-      totalSpentUsd,
-      totalRemainingUsd,
-      activeSessions: active.map((s) => ({
-        id: s.id,
-        merchantName: s.merchantName,
-        merchantPublicKey: s.merchantId,
-        // merchantId is the public key in this context
-        spendingLimitUsd: s.spendingLimitUsd,
-        remainingUsd: s.remainingLimitUsd,
-        expiresAt: s.expiresAt
-      }))
-    };
-  }
-  /**
-   * Charge against an active session authorization.
-   * 
-   * This is useful when you need to manually charge a session outside of
-   * the `callMerchantApi()` flow.
-   * 
-   * @param sessionId - The session ID to charge
-   * @param amountUsd - Amount to charge in USD
-   * @param options - Additional charge options
-   * @returns Charge result
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.chargeSession('sess_abc123', 0.05, {
-   *   feature: 'ai-generation',
-   *   idempotencyKey: 'unique-key-123',
-   * });
-   * 
-   * console.log(`Charged $${result.amountUsd}, remaining: $${result.remainingSessionBalanceUsd}`);
-   * ```
-   */
-  async chargeSession(sessionId, amountUsd, options = {}) {
-    this.logger.debug("chargeSession", { sessionId, amountUsd, options });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/charge`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify({
-        session_id: sessionId,
-        price_usd: amountUsd,
-        feature: options.feature,
-        idempotency_key: options.idempotencyKey,
-        metadata: options.metadata
-      })
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      const errorCode = error.error || error.error_code || "";
-      if (response.status === 402) {
-        if (errorCode === "session_limit_exceeded") {
-          const limit = error.sessionLimitUsd || error.session_limit_usd || 0;
-          const remaining = error.remainingUsd || error.remaining_usd || 0;
-          throw new SessionLimitExceededError(limit, amountUsd, remaining, sessionId);
-        }
-        if (errorCode === "insufficient_balance") {
-          throw new InsufficientBalanceError(
-            amountUsd,
-            error.availableUsd || error.available_usd || 0
-          );
-        }
-      }
-      if (response.status === 404 || errorCode === "session_not_found") {
-        throw new SessionNotFoundError(sessionId);
-      }
-      if (errorCode === "session_expired") {
-        throw new SessionExpiredError(sessionId, error.expiredAt || error.expires_at);
-      }
-      if (errorCode === "session_revoked") {
-        throw new SessionRevokedError(sessionId, error.reason);
-      }
-      throw new MixrPayError(error.message || `Charge failed: ${response.status}`);
-    }
-    const data = await response.json();
-    this.logger.payment(amountUsd, sessionId, options.feature);
-    return {
-      success: true,
-      chargeId: data.chargeId || data.charge_id,
-      amountUsd: data.amountUsd || data.amount_usd || amountUsd,
-      txHash: data.txHash || data.tx_hash,
-      remainingSessionBalanceUsd: data.remainingSessionBalanceUsd || data.remaining_session_balance_usd || 0
-    };
-  }
-  /**
-   * Call a MixrPay merchant's API with automatic session management.
-   * 
-   * This is the recommended way to interact with MixrPay-enabled APIs.
-   * It automatically:
-   * 1. Gets or creates a session authorization
-   * 2. Adds the `X-Mixr-Session` header to the request
-   * 3. Handles payment errors and session expiration
-   * 
-   * @param options - API call options
-   * @returns Response from the merchant API
-   * 
-   * @example
-   * ```typescript
-   * const response = await wallet.callMerchantApi({
-   *   url: 'https://api.merchant.com/generate',
-   *   merchantPublicKey: 'pk_live_abc123...',
-   *   method: 'POST',
-   *   body: { prompt: 'Hello world' },
-   *   priceUsd: 0.05,
-   * });
-   * 
-   * const data = await response.json();
-   * ```
-   */
-  async callMerchantApi(options) {
-    const {
-      url,
-      method = "POST",
-      body,
-      headers: customHeaders = {},
-      merchantPublicKey,
-      priceUsd,
-      feature
-    } = options;
-    this.logger.debug("callMerchantApi", { url, method, merchantPublicKey, priceUsd });
-    await this.validateMerchantAllowed(url, "url");
-    if (priceUsd !== void 0 && this.maxPaymentUsd !== void 0 && priceUsd > this.maxPaymentUsd) {
-      throw new SpendingLimitExceededError("client_max", this.maxPaymentUsd, priceUsd);
-    }
-    const session = await this.getOrCreateSession({
-      merchantPublicKey,
-      spendingLimitUsd: 25,
-      // Default limit
-      durationDays: 7
-    });
-    const headers = {
-      "Content-Type": "application/json",
-      "X-Mixr-Session": session.id,
-      ...customHeaders
-    };
-    if (feature) {
-      headers["X-Mixr-Feature"] = feature;
-    }
-    const requestBody = body !== void 0 ? typeof body === "string" ? body : JSON.stringify(body) : void 0;
-    const response = await fetch(url, {
-      method,
-      headers,
-      body: requestBody,
-      signal: AbortSignal.timeout(this.timeout)
-    });
-    const chargedAmount = response.headers.get("X-Mixr-Charged");
-    if (chargedAmount) {
-      const amountUsd = parseFloat(chargedAmount);
-      if (!isNaN(amountUsd)) {
-        const payment = {
-          amountUsd,
-          recipient: merchantPublicKey,
-          txHash: response.headers.get("X-Payment-TxHash"),
-          timestamp: /* @__PURE__ */ new Date(),
-          description: feature || "API call",
-          url,
-          requestId: crypto.randomUUID(),
-          correlationId: this.extractCorrelationId(customHeaders)
-        };
-        this.payments.push(payment);
-        this.totalSpentUsd += amountUsd;
-        this.logger.payment(amountUsd, merchantPublicKey, feature);
-        if (this.onPayment) {
-          this.onPayment(payment);
-        }
-      }
-    }
-    if (response.status === 402) {
-      const errorData = await response.json().catch(() => ({}));
-      const errorCode = errorData.error || errorData.error_code || "";
-      if (errorCode === "session_expired") {
-        this.logger.info("Session expired, creating new one...");
-        const newSession = await this.getOrCreateSession({
-          merchantPublicKey,
-          spendingLimitUsd: 25,
-          durationDays: 7
-        });
-        headers["X-Mixr-Session"] = newSession.id;
-        return fetch(url, {
-          method,
-          headers,
-          body: requestBody,
-          signal: AbortSignal.timeout(this.timeout)
-        });
-      }
-      if (errorCode === "session_limit_exceeded") {
-        const limit = errorData.sessionLimitUsd || errorData.session_limit_usd || 0;
-        const remaining = errorData.remainingUsd || errorData.remaining_usd || 0;
-        throw new SessionLimitExceededError(limit, priceUsd || 0, remaining, session.id);
-      }
-      if (errorCode === "session_revoked") {
-        throw new SessionRevokedError(session.id, errorData.reason);
-      }
-      if (errorCode === "session_not_found") {
-        throw new SessionNotFoundError(session.id);
-      }
-      if (errorCode === "insufficient_balance") {
-        throw new InsufficientBalanceError(
-          priceUsd || 0,
-          errorData.availableUsd || errorData.available_usd || 0
-        );
-      }
-    }
-    return response;
-  }
-  /**
-   * Parse session response data into SessionAuthorization object.
-   */
-  parseSessionResponse(data) {
-    return {
-      id: data.id || data.session_id || data.sessionId,
-      merchantId: data.merchantId || data.merchant_id,
-      merchantName: data.merchantName || data.merchant_name || "Unknown",
-      status: data.status || "active",
-      spendingLimitUsd: Number(data.spendingLimitUsd || data.spending_limit_usd || data.spendingLimit || 0),
-      amountUsedUsd: Number(data.amountUsedUsd || data.amount_used_usd || data.amountUsed || 0),
-      remainingLimitUsd: Number(
-        data.remainingLimitUsd || data.remaining_limit_usd || data.remainingLimit || Number(data.spendingLimitUsd || data.spending_limit_usd || 0) - Number(data.amountUsedUsd || data.amount_used_usd || 0)
-      ),
-      expiresAt: new Date(data.expiresAt || data.expires_at),
-      createdAt: new Date(data.createdAt || data.created_at)
-    };
-  }
-  // ===========================================================================
-  // MCP (Model Context Protocol) Methods
-  // ===========================================================================
-  /**
-   * Get authentication headers for MCP wallet-based authentication.
-   * 
-   * These headers prove wallet ownership without transmitting the private key.
-   * Use for direct pay-per-call mode (no session needed).
-   * 
-   * @returns Headers object with X-Mixr-Wallet, X-Mixr-Signature, X-Mixr-Timestamp
-   * 
-   * @example
-   * ```typescript
-   * const headers = await wallet.getMCPAuthHeaders();
-   * const response = await fetch('https://mixrpay.com/api/mcp', {
-   *   method: 'POST',
-   *   headers: {
-   *     'Content-Type': 'application/json',
-   *     ...headers,
-   *   },
-   *   body: JSON.stringify({
-   *     jsonrpc: '2.0',
-   *     method: 'tools/list',
-   *     id: 1,
-   *   }),
-   * });
-   * ```
-   */
-  async getMCPAuthHeaders() {
-    const timestamp = Date.now().toString();
-    const message = `MixrPay MCP Auth
+`),y+=`URI: ${s}
+`,y+=`Version: ${h}
+`,y+=`Chain ID: ${g}
+`,y+=`Nonce: ${a}
+`,y+=`Issued At: ${r.toISOString()}`,i&&(y+=`
+Expiration Time: ${i.toISOString()}`),o&&(y+=`
+Not Before: ${o.toISOString()}`),c&&(y+=`
+Request ID: ${c}`),p&&p.length>0){y+=`
+Resources:`;for(let f of p)y+=`
+- ${f}`;}let m=await this.sessionKey.signMessage(y);return {message:y,signature:m,address:u,chainId:g,nonce:a,issuedAt:r,expirationTime:i}}setDebug(e){this.logger.setLevel(e?"debug":"none");}setLogLevel(e){this.logger.setLevel(e);}async getSessionAuthHeaders(){let e=await Y(this.sessionKey);return {"X-Session-Auth":JSON.stringify(e)}}async getOrCreateSession(e){this.logger.debug("getOrCreateSession called",e);let{merchantPublicKey:t,spendingLimitUsd:s,durationDays:n}=e;try{let h=await this.getSessionByMerchant(t);if(h&&h.status==="active")return this.logger.debug("Found existing active session",h.id),h}catch{}this.logger.info(`Creating new session with merchant ${t.slice(0,20)}...`);let a=await this.getSessionAuthHeaders(),r=await fetch(`${this.baseUrl}/api/v2/session/authorize`,{method:"POST",headers:{"Content-Type":"application/json",...a},body:JSON.stringify({merchant_public_key:t,spending_limit_usd:s,duration_days:n})});if(!r.ok){let h=await r.json().catch(()=>({}));throw new l(h.message||h.error||`Failed to create session: ${r.status}`)}let i=await r.json(),o=i.session_id,c=i.message_to_sign;if(!o||!c)throw new l("Invalid authorize response: missing session_id or message_to_sign");this.logger.debug("Signing session authorization message...");let p=await this.sessionKey.signMessage(c),u=await fetch(`${this.baseUrl}/api/v2/session/confirm`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({session_id:o,signature:p,wallet_address:this.walletAddress})});if(!u.ok){let h=await u.json().catch(()=>({}));throw new l(h.message||`Failed to confirm session: ${u.status}`)}let g=await u.json();return this.logger.info(`Session created: ${g.session?.id||o}`),this.parseSessionResponse(g.session||g)}async getSessionByMerchant(e){this.logger.debug("getSessionByMerchant",e);let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/session/status?merchant_public_key=${encodeURIComponent(e)}`,{headers:t});if(s.status===404)return null;if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.message||`Failed to get session: ${s.status}`)}let n=await s.json();return n.session?this.parseSessionResponse(n.session):null}async listSessions(){this.logger.debug("listSessions");let e=await this.getSessionAuthHeaders(),t=await fetch(`${this.baseUrl}/api/v2/session/list`,{headers:e});if(!t.ok){let n=await t.json().catch(()=>({}));throw new l(n.message||`Failed to list sessions: ${t.status}`)}return ((await t.json()).sessions||[]).map(n=>this.parseSessionResponse(n))}async revokeSession(e){this.logger.debug("revokeSession",e);let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/session/revoke`,{method:"POST",headers:{"Content-Type":"application/json",...t},body:JSON.stringify({session_id:e})});if(!s.ok){let n=await s.json().catch(()=>({}));return this.logger.error("Failed to revoke session:",n),false}return this.logger.info(`Session ${e} revoked`),true}async getSessionStats(){this.logger.debug("getSessionStats");let e=await this.listSessions(),t=new Date,s=[],n=[],a=[];for(let c of e)c.status==="revoked"?a.push(c):c.status==="expired"||c.expiresAt&&c.expiresAt<t?n.push(c):c.status==="active"&&s.push(c);let r=s.reduce((c,p)=>c+p.spendingLimitUsd,0),i=e.reduce((c,p)=>c+p.amountUsedUsd,0),o=s.reduce((c,p)=>c+p.remainingLimitUsd,0);return {activeCount:s.length,expiredCount:n.length,revokedCount:a.length,totalAuthorizedUsd:r,totalSpentUsd:i,totalRemainingUsd:o,activeSessions:s.map(c=>({id:c.id,merchantName:c.merchantName,merchantPublicKey:c.merchantId,spendingLimitUsd:c.spendingLimitUsd,remainingUsd:c.remainingLimitUsd,expiresAt:c.expiresAt}))}}async chargeSession(e,t,s={}){this.logger.debug("chargeSession",{sessionId:e,amountUsd:t,options:s});let n=await this.getSessionAuthHeaders(),a=await fetch(`${this.baseUrl}/api/v2/charge`,{method:"POST",headers:{"Content-Type":"application/json",...n},body:JSON.stringify({session_id:e,price_usd:t,feature:s.feature,idempotency_key:s.idempotencyKey,metadata:s.metadata})});if(!a.ok){let i=await a.json().catch(()=>({})),o=(i.error||i.error_code||"").toLowerCase();if(a.status===402){if(o==="session_limit_exceeded"){let c=i.sessionLimitUsd||i.session_limit_usd||0,p=i.remainingUsd||i.remaining_usd||0;throw new U(c,t,p,e)}if(o==="insufficient_balance")throw new S(t,i.availableUsd||i.available_usd||0)}throw a.status===404||o==="session_not_found"?new P(e):o==="session_expired"?new C(e,i.expiredAt||i.expires_at):o==="session_revoked"?new I(e,i.reason):new l(i.message||`Charge failed: ${a.status}`)}let r=await a.json();return this.logger.payment(t,e,s.feature),{success:true,chargeId:r.chargeId||r.charge_id,amountUsd:r.amountUsd||r.amount_usd||t,txHash:r.txHash||r.tx_hash,remainingSessionBalanceUsd:r.remainingSessionBalanceUsd||r.remaining_session_balance_usd||0}}async callMerchantApi(e){let{url:t,method:s="POST",body:n,headers:a={},merchantPublicKey:r,priceUsd:i,feature:o}=e;if(this.logger.debug("callMerchantApi",{url:t,method:s,merchantPublicKey:r,priceUsd:i}),await this.validateMerchantAllowed(t,"url"),i!==void 0&&this.maxPaymentUsd!==void 0&&i>this.maxPaymentUsd)throw new v("client_max",this.maxPaymentUsd,i);let c=await this.getOrCreateSession({merchantPublicKey:r}),p={"Content-Type":"application/json","X-Mixr-Session":c.id,...a};o&&(p["X-Mixr-Feature"]=o);let u=n!==void 0?typeof n=="string"?n:JSON.stringify(n):void 0,g=await fetch(t,{method:s,headers:p,body:u,signal:AbortSignal.timeout(this.timeout)}),h=g.headers.get("X-Mixr-Charged");if(h){let y=parseFloat(h);if(!isNaN(y)){let m={amountUsd:y,recipient:r,txHash:g.headers.get("X-Payment-TxHash"),timestamp:new Date,description:o||"API call",url:t,requestId:crypto.randomUUID(),correlationId:this.extractCorrelationId(a)};this.payments.push(m),this.totalSpentUsd+=y,this.logger.payment(y,r,o),this.onPayment&&this.onPayment(m);}}if(g.status===402){let y=await g.json().catch(()=>({})),m=(y.error||y.error_code||"").toLowerCase();if(m==="session_expired"){this.logger.info("Session expired, creating new one...");let f=await this.getOrCreateSession({merchantPublicKey:r});return p["X-Mixr-Session"]=f.id,fetch(t,{method:s,headers:p,body:u,signal:AbortSignal.timeout(this.timeout)})}if(m==="session_limit_exceeded"){let f=y.sessionLimitUsd||y.session_limit_usd||0,w=y.remainingUsd||y.remaining_usd||0;throw new U(f,i||0,w,c.id)}if(m==="session_revoked")throw new I(c.id,y.reason);if(m==="session_not_found")throw new P(c.id);if(m==="insufficient_balance")throw new S(i||0,y.availableUsd||y.available_usd||0)}return g}parseSessionResponse(e){return {id:e.id||e.session_id||e.sessionId,merchantId:e.merchantId||e.merchant_id,merchantName:e.merchantName||e.merchant_name||"Unknown",status:e.status||"active",spendingLimitUsd:Number(e.spendingLimitUsd||e.spending_limit_usd||e.spendingLimit||0),amountUsedUsd:Number(e.amountUsedUsd||e.amount_used_usd||e.amountUsed||0),remainingLimitUsd:Number(e.remainingLimitUsd||e.remaining_limit_usd||e.remainingLimit||Number(e.spendingLimitUsd||e.spending_limit_usd||0)-Number(e.amountUsedUsd||e.amount_used_usd||0)),expiresAt:new Date(e.expiresAt||e.expires_at),createdAt:new Date(e.createdAt||e.created_at)}}async getMCPAuthHeaders(){let e=Date.now().toString(),t=`MixrPay MCP Auth
 Wallet: ${this.walletAddress}
-Timestamp: ${timestamp}`;
-    const signature = await this.sessionKey.signMessage(message);
-    return {
-      "X-Mixr-Wallet": this.walletAddress,
-      "X-Mixr-Signature": signature,
-      "X-Mixr-Timestamp": timestamp
-    };
-  }
-  /**
-   * List available MCP tools from the MixrPay gateway.
-   * 
-   * Returns all tools exposed by MCP providers on the MixrPay marketplace.
-   * Each tool includes pricing information.
-   * 
-   * @returns Array of MCP tools with pricing and metadata
-   * 
-   * @example
-   * ```typescript
-   * const tools = await wallet.listMCPTools();
-   * for (const tool of tools) {
-   *   console.log(`${tool.name}: $${tool.priceUsd} - ${tool.description}`);
-   * }
-   * ```
-   */
-  async listMCPTools() {
-    this.logger.debug("listMCPTools");
-    const response = await fetch(`${this.baseUrl}/api/mcp`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        method: "tools/list",
-        id: Date.now()
-      })
-    });
-    if (!response.ok) {
-      throw new MixrPayError(`Failed to list MCP tools: ${response.status}`);
-    }
-    const result = await response.json();
-    if (result.error) {
-      throw new MixrPayError(result.error.message || "Failed to list MCP tools");
-    }
-    return (result.result?.tools || []).map((tool) => ({
-      name: tool.name,
-      description: tool.description,
-      inputSchema: tool.inputSchema,
-      priceUsd: tool["x-mixrpay"]?.priceUsd || 0,
-      merchantName: tool["x-mixrpay"]?.merchantName,
-      merchantSlug: tool["x-mixrpay"]?.merchantSlug,
-      verified: tool["x-mixrpay"]?.verified || false
-    }));
-  }
-  /**
-   * Call an MCP tool with wallet authentication (direct pay per call).
-   * 
-   * This method signs a fresh auth message for each call, charging
-   * directly from your wallet balance without needing a session.
-   * 
-   * @param toolName - The tool name in format "merchant/tool"
-   * @param args - Arguments to pass to the tool
-   * @returns Tool execution result
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.callMCPTool('firecrawl/scrape', {
-   *   url: 'https://example.com',
-   * });
-   * console.log(result.data);
-   * console.log(`Charged: $${result.chargedUsd}`);
-   * ```
-   */
-  async callMCPTool(toolName, args = {}) {
-    this.logger.debug("callMCPTool", { toolName, args });
-    await this.validateMerchantAllowed(toolName, "tool");
-    const authHeaders = await this.getMCPAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/mcp`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        method: "tools/call",
-        params: { name: toolName, arguments: args },
-        id: Date.now()
-      })
-    });
-    const result = await response.json();
-    if (result.error) {
-      throw new MixrPayError(result.error.message || "MCP tool call failed");
-    }
-    const content = result.result?.content?.[0];
-    const data = content?.text ? JSON.parse(content.text) : null;
-    const mixrpay = result.result?._mixrpay || {};
-    if (mixrpay.chargedUsd) {
-      const payment = {
-        amountUsd: mixrpay.chargedUsd,
-        recipient: toolName.split("/")[0] || toolName,
-        txHash: mixrpay.txHash,
-        timestamp: /* @__PURE__ */ new Date(),
-        description: `MCP: ${toolName}`,
-        url: `${this.baseUrl}/api/mcp`,
-        requestId: crypto.randomUUID()
-      };
-      this.payments.push(payment);
-      this.totalSpentUsd += mixrpay.chargedUsd;
-      this.logger.payment(mixrpay.chargedUsd, toolName, "MCP call");
-      if (this.onPayment) {
-        this.onPayment(payment);
-      }
-    }
-    return {
-      data,
-      chargedUsd: mixrpay.chargedUsd || 0,
-      txHash: mixrpay.txHash,
-      latencyMs: mixrpay.latencyMs
-    };
-  }
-  // ===========================================================================
-  // JIT MCP Server Methods
-  // ===========================================================================
-  /**
-   * Deploy a JIT MCP server from the Glama directory.
-   * 
-   * Deploys any remote-capable MCP server to Cloudflare Workers.
-   * Charges $1 from your session budget.
-   * 
-   * @param options - Deployment options including Glama server details and env vars
-   * @returns Deployed instance with private endpoint URL
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.deployJitMcp({
-   *   glamaId: 'notion-mcp',
-   *   glamaNamespace: 'notion',
-   *   glamaSlug: 'notion-mcp',
-   *   toolName: 'My Notion Server',
-   *   envVars: { NOTION_API_KEY: 'secret_...' },
-   *   ttlHours: 24,
-   * });
-   * 
-   * console.log('Endpoint:', result.instance.endpointUrl);
-   * console.log('Expires:', result.instance.expiresAt);
-   * ```
-   */
-  async deployJitMcp(options) {
-    this.logger.debug("deployJitMcp", { glamaId: options.glamaId, toolName: options.toolName });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/jit/deploy`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify({
-        glama_id: options.glamaId,
-        glama_namespace: options.glamaNamespace,
-        glama_slug: options.glamaSlug,
-        tool_name: options.toolName,
-        tool_description: options.toolDescription,
-        env_vars: options.envVars,
-        ttl_hours: options.ttlHours || 24
-        // session_id not needed - derived from X-Session-Auth
-      })
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `JIT deploy failed: ${response.status}`);
-    }
-    const data = await response.json();
-    if (data.payment?.amount_usd > 0) {
-      const payment = {
-        amountUsd: data.payment.amount_usd,
-        recipient: "mixrpay-jit-deploy",
-        txHash: data.payment.tx_hash,
-        timestamp: /* @__PURE__ */ new Date(),
-        description: `JIT Deploy: ${options.toolName}`,
-        url: `${this.baseUrl}/api/v2/jit/deploy`,
-        requestId: data.request_id || crypto.randomUUID()
-      };
-      this.payments.push(payment);
-      this.totalSpentUsd += data.payment.amount_usd;
-      this.logger.payment(data.payment.amount_usd, "jit-deploy", options.toolName);
-      if (this.onPayment) {
-        this.onPayment(payment);
-      }
-    }
-    return {
-      instance: this.parseJitInstance(data.instance),
-      payment: {
-        method: data.payment.method,
-        amountUsd: data.payment.amount_usd,
-        txHash: data.payment.tx_hash
-      }
-    };
-  }
-  /**
-   * List your deployed JIT MCP server instances.
-   * 
-   * @param options - Optional filters
-   * @returns Array of JIT instances
-   * 
-   * @example
-   * ```typescript
-   * const instances = await wallet.listJitInstances({ status: 'active' });
-   * for (const inst of instances) {
-   *   console.log(`${inst.toolName}: ${inst.endpointUrl}`);
-   * }
-   * ```
-   */
-  async listJitInstances(options) {
-    this.logger.debug("listJitInstances", options);
-    const authHeaders = await this.getSessionAuthHeaders();
-    const params = new URLSearchParams();
-    if (options?.status) params.set("status", options.status);
-    const response = await fetch(
-      `${this.baseUrl}/api/v2/jit/instances?${params}`,
-      { headers: authHeaders }
-    );
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to list JIT instances: ${response.status}`);
-    }
-    const data = await response.json();
-    return (data.instances || []).map((i) => this.parseJitInstance(i));
-  }
-  /**
-   * Stop a running JIT MCP server instance.
-   * 
-   * Instance will be marked as stopped and Worker cleaned up.
-   * No refund is given - instances are billed at deploy time.
-   * 
-   * @param instanceId - The instance ID to stop
-   * 
-   * @example
-   * ```typescript
-   * await wallet.stopJitInstance('inst_abc123');
-   * console.log('Instance stopped');
-   * ```
-   */
-  async stopJitInstance(instanceId) {
-    this.logger.debug("stopJitInstance", { instanceId });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(
-      `${this.baseUrl}/api/v2/jit/instances/${instanceId}`,
-      { method: "DELETE", headers: authHeaders }
-    );
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to stop JIT instance: ${response.status}`);
-    }
-  }
-  /**
-   * Parse JIT instance response data.
-   */
-  parseJitInstance(data) {
-    return {
-      id: data.id,
-      endpointUrl: data.endpoint_url,
-      toolName: data.tool_name,
-      glamaId: data.glama_id,
-      glamaNamespace: data.glama_namespace,
-      glamaSlug: data.glama_slug,
-      status: data.status,
-      mode: data.mode,
-      ttlHours: data.ttl_hours,
-      expiresAt: new Date(data.expires_at),
-      createdAt: new Date(data.created_at)
-    };
-  }
-  /**
-   * Get details of a specific JIT MCP server instance.
-   * 
-   * @param instanceId - The instance ID to retrieve
-   * @returns Full instance details including endpoint URL
-   * 
-   * @example
-   * ```typescript
-   * const instance = await wallet.getJitInstance('inst_abc123');
-   * console.log('Endpoint:', instance.endpointUrl);
-   * console.log('Expires:', instance.expiresAt);
-   * ```
-   */
-  async getJitInstance(instanceId) {
-    this.logger.debug("getJitInstance", { instanceId });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(
-      `${this.baseUrl}/api/v2/jit/instances/${instanceId}`,
-      { headers: authHeaders }
-    );
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get JIT instance: ${response.status}`);
-    }
-    const data = await response.json();
-    return this.parseJitInstance(data.instance);
-  }
-  // ===========================================================================
-  // Glama MCP Directory Methods
-  // ===========================================================================
-  /**
-   * Search the Glama MCP server directory.
-   * 
-   * Glama indexes 15,000+ MCP servers. Use this to discover tools
-   * that can be deployed as JIT servers.
-   * 
-   * Note: This is a public API and does not require authentication.
-   * 
-   * @param query - Search query (e.g., "notion", "github", "database")
-   * @returns Array of matching servers with hosting info
-   * 
-   * @example
-   * ```typescript
-   * const results = await wallet.searchGlamaDirectory('notion');
-   * 
-   * // Filter to only hostable servers
-   * const hostable = results.servers.filter(s => s.canHost);
-   * console.log(`Found ${hostable.length} deployable servers`);
-   * 
-   * // Deploy one
-   * if (hostable.length > 0) {
-   *   const server = hostable[0];
-   *   await wallet.deployJitMcp({
-   *     glamaId: server.id,
-   *     glamaNamespace: server.namespace,
-   *     glamaSlug: server.slug,
-   *     toolName: server.name,
-   *     envVars: { API_KEY: '...' },
-   *   });
-   * }
-   * ```
-   */
-  async searchGlamaDirectory(query) {
-    this.logger.debug("searchGlamaDirectory", { query });
-    const params = new URLSearchParams({ q: query });
-    const response = await fetch(`${this.baseUrl}/api/mcp/glama?${params}`);
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Glama search failed: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
-      pageInfo: data.pageInfo,
-      query: data.query
-    };
-  }
-  /**
-   * Get featured/popular MCP servers from the Glama directory.
-   * 
-   * Returns curated list of popular servers when you don't have
-   * a specific search query.
-   * 
-   * Note: This is a public API and does not require authentication.
-   * 
-   * @returns Array of featured servers with hosting info
-   * 
-   * @example
-   * ```typescript
-   * const { servers } = await wallet.getFeaturedGlamaServers();
-   * console.log('Featured servers:', servers.map(s => s.name));
-   * ```
-   */
-  async getFeaturedGlamaServers() {
-    this.logger.debug("getFeaturedGlamaServers");
-    const response = await fetch(`${this.baseUrl}/api/mcp/glama`);
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get featured servers: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      servers: (data.servers || []).map((s) => this.parseGlamaServer(s)),
-      featured: data.featured
-    };
-  }
-  /**
-   * Parse Glama server response data.
-   */
-  parseGlamaServer(data) {
-    const importData = data.importData;
-    return {
-      id: data.id,
-      name: data.name,
-      namespace: data.namespace,
-      slug: data.slug,
-      description: data.description,
-      url: data.url,
-      attributes: data.attributes,
-      canHost: data.canHost,
-      tools: data.tools || [],
-      repository: data.repository,
-      license: data.spdxLicense?.name,
-      importData: importData ? {
-        glamaId: importData.glamaId,
-        glamaNamespace: importData.glamaNamespace,
-        glamaSlug: importData.glamaSlug,
-        suggestedName: importData.suggestedName,
-        suggestedDescription: importData.suggestedDescription,
-        hostingType: importData.hostingType,
-        requiredEnvVars: importData.requiredEnvVars,
-        optionalEnvVars: importData.optionalEnvVars
-      } : void 0
-    };
-  }
-  // ===========================================================================
-  // JIT Task Agent Methods
-  // ===========================================================================
-  /**
-   * Deploy a JIT Task Agent - a serverless agent that executes a specific task.
-   * 
-   * JIT Task Agents run on Cloudflare Workers and execute an agentic loop
-   * (LLM + tools) within a budget cap. They self-destruct when complete.
-   * 
-   * @param options - Task agent deployment options
-   * @returns Deployed task agent instance with endpoints
-   * 
-   * @example Basic usage
-   * ```typescript
-   * const result = await wallet.deployTaskAgent({
-   *   name: 'Research Agent',
-   *   prompt: 'Research the top 5 AI startups in San Francisco',
-   *   budgetUsd: 5.00,
-   *   tools: ['platform/exa-search', 'platform/firecrawl-scrape'],
-   * });
-   * 
-   * console.log('Task ID:', result.instance.id);
-   * console.log('Status URL:', result.instance.statusUrl);
-   * ```
-   * 
-   * @example With auto-run
-   * ```typescript
-   * const result = await wallet.deployTaskAgent({
-   *   name: 'Data Collector',
-   *   prompt: 'Collect pricing data from competitor websites',
-   *   budgetUsd: 10.00,
-   *   tools: ['platform/firecrawl-scrape'],
-   *   autoRun: true, // Start immediately
-   * });
-   * 
-   * // Wait for completion
-   * const finalResult = await wallet.waitForTaskAgent(result.instance.id);
-   * console.log('Result:', finalResult.result);
-   * ```
-   */
-  async deployTaskAgent(options) {
-    this.logger.debug("deployTaskAgent", { name: options.name, budgetUsd: options.budgetUsd });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/jit-task/deploy`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify({
-        name: options.name,
-        prompt: options.prompt,
-        system_prompt: options.systemPrompt,
-        model: options.model || "claude-sonnet-4-5",
-        tools: options.tools || [],
-        budget_usd: options.budgetUsd,
-        ttl_hours: options.ttlHours || 24,
-        max_iterations: options.maxIterations || 10,
-        plan_id: options.planId,
-        task_id: options.taskId,
-        idempotency_key: options.idempotencyKey,
-        auto_run: options.autoRun || false
-      })
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Task agent deploy failed: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      instance: this.parseTaskAgentInstance(data.instance),
-      idempotent: data.idempotent || false,
-      requestId: data.request_id
-    };
-  }
-  /**
-   * Get the status of a JIT Task Agent.
-   * 
-   * @param instanceId - The task agent instance ID
-   * @returns Current status and details
-   * 
-   * @example
-   * ```typescript
-   * const status = await wallet.getTaskAgentStatus('cuid_abc123');
-   * console.log('Status:', status.status);
-   * console.log('Iterations:', status.iterations.current, '/', status.iterations.max);
-   * console.log('Spent:', status.budget.spentUsd, '/', status.budget.totalUsd);
-   * ```
-   */
-  async getTaskAgentStatus(instanceId) {
-    this.logger.debug("getTaskAgentStatus", { instanceId });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/jit-task/${instanceId}`, {
-      method: "GET",
-      headers: authHeaders
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get task status: ${response.status}`);
-    }
-    const data = await response.json();
-    return this.parseTaskAgentStatus(data);
-  }
-  /**
-   * Trigger execution of a JIT Task Agent.
-   * 
-   * Only works for agents in 'active' status (not yet started).
-   * 
-   * @param instanceId - The task agent instance ID
-   * @returns Trigger result
-   * 
-   * @example
-   * ```typescript
-   * // Deploy without auto-run
-   * const { instance } = await wallet.deployTaskAgent({
-   *   name: 'Research',
-   *   prompt: 'Research AI trends',
-   *   budgetUsd: 5.00,
-   * });
-   * 
-   * // Later, trigger execution
-   * await wallet.triggerTaskAgent(instance.id);
-   * ```
-   */
-  async triggerTaskAgent(instanceId) {
-    this.logger.debug("triggerTaskAgent", { instanceId });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/jit-task/${instanceId}`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      }
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to trigger task: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      success: data.success,
-      status: data.status
-    };
-  }
-  /**
-   * Cancel a JIT Task Agent.
-   * 
-   * Stops execution and marks the task as cancelled.
-   * Cannot cancel tasks that are already completed/failed.
-   * 
-   * @param instanceId - The task agent instance ID
-   * @returns Cancel result
-   * 
-   * @example
-   * ```typescript
-   * await wallet.cancelTaskAgent('cuid_abc123');
-   * console.log('Task cancelled');
-   * ```
-   */
-  async cancelTaskAgent(instanceId) {
-    this.logger.debug("cancelTaskAgent", { instanceId });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/jit-task/${instanceId}`, {
-      method: "DELETE",
-      headers: authHeaders
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to cancel task: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      success: data.success,
-      status: data.status
-    };
-  }
-  /**
-   * List JIT Task Agents for the authenticated user.
-   * 
-   * Returns deployed task agents with optional filtering by status,
-   * plan, or task. Includes pagination and summary statistics.
-   * 
-   * @param options - Optional filter and pagination parameters
-   * @returns List of task agents with pagination and stats
-   * 
-   * @example List all task agents
-   * ```typescript
-   * const { taskAgents, pagination, stats } = await wallet.listTaskAgents();
-   * console.log(`${pagination.total} total agents, ${stats.active} active`);
-   * ```
-   * 
-   * @example Filter by status
-   * ```typescript
-   * const { taskAgents } = await wallet.listTaskAgents({ status: 'running' });
-   * for (const agent of taskAgents) {
-   *   console.log(`${agent.name}: $${agent.budget.spentUsd}/$${agent.budget.totalUsd}`);
-   * }
-   * ```
-   * 
-   * @example Filter by plan
-   * ```typescript
-   * const { taskAgents } = await wallet.listTaskAgents({ planId: 'plan_abc' });
-   * ```
-   */
-  async listTaskAgents(options) {
-    this.logger.debug("listTaskAgents", { options });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const searchParams = new URLSearchParams();
-    if (options?.status) searchParams.set("status", options.status);
-    if (options?.planId) searchParams.set("plan_id", options.planId);
-    if (options?.taskId) searchParams.set("task_id", options.taskId);
-    if (options?.limit !== void 0) searchParams.set("limit", String(options.limit));
-    if (options?.offset !== void 0) searchParams.set("offset", String(options.offset));
-    const qs = searchParams.toString();
-    const url = `${this.baseUrl}/api/v2/jit-task${qs ? `?${qs}` : ""}`;
-    const response = await fetch(url, {
-      method: "GET",
-      headers: authHeaders
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to list task agents: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      taskAgents: (data.task_agents || []).map((agent) => {
-        const budget = agent.budget;
-        const iterations = agent.iterations;
-        const usage = agent.usage;
-        const plan = agent.plan;
-        const task = agent.task;
-        return {
-          id: agent.id,
-          name: agent.name,
-          prompt: agent.prompt,
-          model: agent.model,
-          tools: agent.tools,
-          status: agent.status,
-          budget: {
-            totalUsd: budget.total_usd,
-            spentUsd: budget.spent_usd,
-            remainingUsd: budget.remaining_usd
-          },
-          iterations: {
-            current: iterations.current,
-            max: iterations.max
-          },
-          usage: {
-            toolCalls: usage.tool_calls,
-            inputTokens: usage.input_tokens,
-            outputTokens: usage.output_tokens
-          },
-          result: agent.result,
-          error: agent.error,
-          depth: agent.depth,
-          plan: plan ? { id: plan.id, title: plan.title } : null,
-          task: task ? { id: task.id, title: task.title } : null,
-          ttlHours: agent.ttl_hours,
-          expiresAt: new Date(agent.expires_at),
-          createdAt: new Date(agent.created_at),
-          startedAt: agent.started_at ? new Date(agent.started_at) : void 0,
-          completedAt: agent.completed_at ? new Date(agent.completed_at) : void 0
-        };
-      }),
-      pagination: {
-        total: data.pagination.total,
-        limit: data.pagination.limit,
-        offset: data.pagination.offset,
-        hasMore: data.pagination.has_more
-      },
-      stats: {
-        active: data.stats.active ?? 0,
-        completed: data.stats.completed ?? 0,
-        failed: data.stats.failed ?? 0,
-        totalSpentUsd: data.stats.total_spent_usd ?? 0
-      }
-    };
-  }
-  /**
-   * Wait for a JIT Task Agent to complete.
-   * 
-   * Polls the status until the task reaches a terminal state
-   * (completed, failed, cancelled, budget_exceeded, expired).
-   * 
-   * @param instanceId - The task agent instance ID
-   * @param options - Wait options
-   * @returns Final task result
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.waitForTaskAgent('cuid_abc123', {
-   *   pollIntervalMs: 2000,
-   *   timeoutMs: 300000, // 5 minutes
-   * });
-   * 
-   * if (result.status === 'completed') {
-   *   console.log('Result:', result.result);
-   * } else {
-   *   console.log('Failed:', result.error);
-   * }
-   * ```
-   */
-  async waitForTaskAgent(instanceId, options) {
-    const pollIntervalMs = options?.pollIntervalMs || 2e3;
-    const timeoutMs = options?.timeoutMs || 3e5;
-    const startTime = Date.now();
-    this.logger.debug("waitForTaskAgent", { instanceId, pollIntervalMs, timeoutMs });
-    while (true) {
-      const status = await this.getTaskAgentStatus(instanceId);
-      if (["completed", "failed", "cancelled", "budget_exceeded", "expired"].includes(status.status)) {
-        return {
-          id: status.id,
-          status: status.status,
-          result: status.result,
-          error: status.error,
-          spentUsd: status.budget.spentUsd,
-          iterations: status.iterations.current,
-          toolCalls: status.usage.toolCalls,
-          completedAt: status.completedAt
-        };
-      }
-      if (Date.now() - startTime > timeoutMs) {
-        throw new MixrPayError(`Task agent wait timeout after ${timeoutMs}ms`);
-      }
-      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
-    }
-  }
-  /**
-   * Parse task agent instance from API response.
-   */
-  parseTaskAgentInstance(data) {
-    return {
-      id: data.id,
-      name: data.name,
-      endpointUrl: data.endpoint_url,
-      statusUrl: data.status_url,
-      triggerUrl: data.trigger_url,
-      cancelUrl: data.cancel_url,
-      resultUrl: data.result_url,
-      status: data.status,
-      budgetUsd: data.budget_usd,
-      expiresAt: new Date(data.expires_at),
-      depth: data.depth,
-      maxIterations: data.max_iterations
-    };
-  }
-  /**
-   * Parse task agent status from API response.
-   */
-  parseTaskAgentStatus(data) {
-    const budget = data.budget;
-    const iterations = data.iterations;
-    const usage = data.usage;
-    const endpoints = data.endpoints;
-    return {
-      id: data.id,
-      name: data.name,
-      prompt: data.prompt,
-      model: data.model,
-      tools: data.tools,
-      status: data.status,
-      budget: {
-        totalUsd: budget?.total_usd ?? 0,
-        spentUsd: budget?.spent_usd ?? 0,
-        remainingUsd: budget?.remaining_usd ?? 0
-      },
-      iterations: {
-        current: iterations?.current ?? 0,
-        max: iterations?.max ?? 0
-      },
-      usage: {
-        toolCalls: usage?.tool_calls ?? 0,
-        inputTokens: usage?.input_tokens ?? 0,
-        outputTokens: usage?.output_tokens ?? 0
-      },
-      result: data.result,
-      error: data.error,
-      depth: data.depth,
-      planId: data.plan_id,
-      taskId: data.task_id,
-      endpoints: {
-        statusUrl: endpoints?.status_url ?? "",
-        triggerUrl: endpoints?.trigger_url ?? "",
-        cancelUrl: endpoints?.cancel_url ?? "",
-        resultUrl: endpoints?.result_url ?? ""
-      },
-      ttlHours: data.ttl_hours,
-      expiresAt: new Date(data.expires_at),
-      createdAt: new Date(data.created_at),
-      startedAt: data.started_at ? new Date(data.started_at) : void 0,
-      completedAt: data.completed_at ? new Date(data.completed_at) : void 0
-    };
-  }
-  // ===========================================================================
-  // LLM Completion Methods
-  // ===========================================================================
-  /**
-   * Simple LLM completion - single-turn, no tools.
-   * 
-   * This is a convenience method for agents that just need to call an LLM
-   * without the full agentic loop. Useful when Clawdbot spawns agents
-   * that need to make their own LLM calls through MixrPay.
-   * 
-   * @param prompt - The user prompt to send
-   * @param options - Optional configuration
-   * @returns The LLM response text and cost
-   * 
-   * @example Basic usage
-   * ```typescript
-   * const result = await wallet.complete('Summarize this text: ...');
-   * console.log(result.text);
-   * console.log(`Cost: $${result.costUsd.toFixed(4)}`);
-   * ```
-   * 
-   * @example With custom model
-   * ```typescript
-   * const result = await wallet.complete(
-   *   'Write a haiku about coding',
-   *   { model: 'gpt-4o', systemPrompt: 'You are a poet.' }
-   * );
-   * ```
-   */
-  async complete(prompt, options) {
-    this.logger.debug("complete", { promptLength: prompt.length, model: options?.model });
-    const result = await this.runAgent({
-      messages: [{ role: "user", content: prompt }],
-      config: {
-        model: options?.model || "gpt-4o-mini",
-        maxIterations: 1,
-        tools: [],
-        // No tools - pure LLM completion
-        systemPrompt: options?.systemPrompt
-      }
-    });
-    return {
-      text: result.response,
-      costUsd: result.cost.totalUsd,
-      tokens: result.tokens,
-      model: options?.model || "gpt-4o-mini"
-    };
-  }
-  // ===========================================================================
-  // Agent Runtime API
-  // ===========================================================================
-  /**
-   * Run an AI agent with LLM and tool execution.
-   * 
-   * This method orchestrates a full agentic loop:
-   * - Multi-turn reasoning with LLM
-   * - Automatic tool execution
-   * - Bundled billing (single charge at end)
-   * - Optional streaming via SSE
-   * 
-   * @param options - Agent run options
-   * @returns Agent run result with response and cost breakdown
-   * 
-   * @example Basic usage
-   * ```typescript
-   * const result = await wallet.runAgent({
-   *   sessionId: 'sess_abc123',
-   *   messages: [{ role: 'user', content: 'Find AI startups in SF' }],
-   * });
-   * 
-   * console.log(result.response);
-   * console.log(`Cost: $${result.cost.totalUsd.toFixed(4)}`);
-   * ```
-   * 
-   * @example With custom config
-   * ```typescript
-   * const result = await wallet.runAgent({
-   *   sessionId: 'sess_abc123',
-   *   messages: [{ role: 'user', content: 'Research quantum computing' }],
-   *   config: {
-   *     model: 'gpt-4o',
-   *     maxIterations: 15,
-   *     tools: ['platform/exa-search', 'platform/firecrawl-scrape'],
-   *     systemPrompt: 'You are a research assistant.',
-   *   },
-   * });
-   * ```
-   * 
-   * @example With streaming
-   * ```typescript
-   * await wallet.runAgent({
-   *   sessionId: 'sess_abc123',
-   *   messages: [{ role: 'user', content: 'Analyze this company' }],
-   *   stream: true,
-   *   onEvent: (event) => {
-   *     if (event.type === 'llm_chunk') {
-   *       process.stdout.write(event.delta);
-   *     } else if (event.type === 'tool_call') {
-   *       console.log(`Calling tool: ${event.tool}`);
-   *     }
-   *   },
-   * });
-   * ```
-   */
-  async runAgent(options) {
-    const {
-      sessionId,
-      messages,
-      config = {},
-      stream = false,
-      idempotencyKey,
-      onEvent
-    } = options;
-    this.logger.debug("runAgent", { sessionId: sessionId || "(from signature)", messageCount: messages.length, config, stream });
-    const body = {
-      messages: messages.map((m) => ({ role: m.role, content: m.content })),
-      config: {
-        model: config.model,
-        max_iterations: config.maxIterations,
-        tools: config.tools,
-        system_prompt: config.systemPrompt
-      },
-      stream,
-      idempotency_key: idempotencyKey
-    };
-    if (sessionId) {
-      body.session_id = sessionId;
-    }
-    const AGENT_RUN_TIMEOUT = 18e4;
-    if (!stream) {
-      const authHeaders = await this.getSessionAuthHeaders();
-      const response = await fetch(`${this.baseUrl}/api/v2/agent/run`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          ...authHeaders
-        },
-        body: JSON.stringify(body),
-        signal: AbortSignal.timeout(AGENT_RUN_TIMEOUT)
-      });
-      if (!response.ok) {
-        const error = await response.json().catch(() => ({}));
-        throw new MixrPayError(error.error || `Agent run failed: ${response.status}`);
-      }
-      const data = await response.json();
-      if (data.cost?.total_usd > 0) {
-        const payment = {
-          amountUsd: data.cost.total_usd,
-          recipient: "mixrpay-agent-run",
-          txHash: data.tx_hash,
-          timestamp: /* @__PURE__ */ new Date(),
-          description: `Agent run: ${data.run_id}`,
-          url: `${this.baseUrl}/api/v2/agent/run`,
-          requestId: idempotencyKey || crypto.randomUUID()
-        };
-        this.payments.push(payment);
-        this.totalSpentUsd += data.cost.total_usd;
-        this.logger.payment(data.cost.total_usd, "agent-run", data.run_id);
-        if (this.onPayment) {
-          this.onPayment(payment);
-        }
-      }
-      return {
-        runId: data.run_id,
-        status: data.status,
-        response: data.response,
-        iterations: data.iterations,
-        toolsUsed: data.tools_used,
-        cost: {
-          llmUsd: data.cost.llm_usd,
-          toolsUsd: data.cost.tools_usd,
-          totalUsd: data.cost.total_usd
-        },
-        tokens: data.tokens,
-        sessionRemainingUsd: data.session_remaining_usd,
-        txHash: data.tx_hash
-      };
-    }
-    return this.runAgentStreaming(body, onEvent);
-  }
-  /**
-   * Internal: Handle streaming agent run via SSE
-   */
-  async runAgentStreaming(body, onEvent) {
-    const STREAMING_TIMEOUT = 3e5;
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/agent/run`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...authHeaders
-      },
-      body: JSON.stringify(body),
-      signal: AbortSignal.timeout(STREAMING_TIMEOUT)
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Agent run failed: ${response.status}`);
-    }
-    const reader = response.body?.getReader();
-    if (!reader) {
-      throw new MixrPayError("No response body for streaming");
-    }
-    const decoder = new TextDecoder();
-    let buffer = "";
-    let result = null;
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buffer += decoder.decode(value, { stream: true });
-      const lines = buffer.split("\n");
-      buffer = lines.pop() || "";
-      let currentEvent = "";
-      for (const line of lines) {
-        if (line.startsWith("event: ")) {
-          currentEvent = line.slice(7).trim();
-        } else if (line.startsWith("data: ") && currentEvent) {
-          try {
-            const data = JSON.parse(line.slice(6));
-            const event = this.parseSSEEvent(currentEvent, data);
-            if (event) {
-              onEvent?.(event);
-              if (currentEvent === "complete") {
-                result = {
-                  runId: data.run_id,
-                  status: "completed",
-                  response: data.response,
-                  iterations: data.iterations,
-                  toolsUsed: data.tools_used,
-                  cost: {
-                    llmUsd: 0,
-                    // Not provided in streaming complete
-                    toolsUsd: 0,
-                    totalUsd: data.total_cost_usd
-                  },
-                  tokens: { prompt: 0, completion: 0 },
-                  sessionRemainingUsd: 0,
-                  txHash: data.tx_hash
-                };
-                if (data.total_cost_usd > 0) {
-                  const payment = {
-                    amountUsd: data.total_cost_usd,
-                    recipient: "mixrpay-agent-run",
-                    txHash: data.tx_hash,
-                    timestamp: /* @__PURE__ */ new Date(),
-                    description: `Agent run: ${data.run_id}`,
-                    url: `${this.baseUrl}/api/v2/agent/run`,
-                    requestId: body.idempotency_key || crypto.randomUUID()
-                  };
-                  this.payments.push(payment);
-                  this.totalSpentUsd += data.total_cost_usd;
-                  if (this.onPayment) {
-                    this.onPayment(payment);
-                  }
-                }
-              }
-              if (currentEvent === "error") {
-                throw new MixrPayError(data.error || "Agent run failed");
-              }
-            }
-          } catch (e) {
-            if (e instanceof MixrPayError) throw e;
-            this.logger.warn("Failed to parse SSE event:", e);
-          }
-          currentEvent = "";
-        }
-      }
-    }
-    if (!result) {
-      throw new MixrPayError("Agent run completed without final result");
-    }
-    return result;
-  }
-  /**
-   * Internal: Parse SSE event into typed event object
-   */
-  parseSSEEvent(eventType, data) {
-    switch (eventType) {
-      case "run_start":
-        return { type: "run_start", runId: data.run_id };
-      case "iteration_start":
-        return { type: "iteration_start", iteration: data.iteration };
-      case "llm_chunk":
-        return { type: "llm_chunk", delta: data.delta };
-      case "tool_call":
-        return { type: "tool_call", tool: data.tool, arguments: data.arguments };
-      case "tool_result":
-        return {
-          type: "tool_result",
-          tool: data.tool,
-          success: data.success,
-          costUsd: data.cost_usd,
-          error: data.error
-        };
-      case "iteration_complete":
-        return {
-          type: "iteration_complete",
-          iteration: data.iteration,
-          tokens: data.tokens,
-          costUsd: data.cost_usd
-        };
-      case "complete":
-        return {
-          type: "complete",
-          runId: data.run_id,
-          response: data.response,
-          totalCostUsd: data.total_cost_usd,
-          txHash: data.tx_hash,
-          iterations: data.iterations,
-          toolsUsed: data.tools_used
-        };
-      case "error":
-        return {
-          type: "error",
-          error: data.error,
-          partialCostUsd: data.partial_cost_usd
-        };
-      default:
-        return null;
-    }
-  }
-  /**
-   * Get the status of an agent run by ID.
-   * 
-   * @param runId - The agent run ID
-   * @param sessionId - The session ID (for authentication)
-   * @returns Agent run status and results
-   * 
-   * @example
-   * ```typescript
-   * const status = await wallet.getAgentRunStatus('run_abc123', 'sess_xyz789');
-   * console.log(`Status: ${status.status}`);
-   * if (status.status === 'completed') {
-   *   console.log(status.response);
-   * }
-   * ```
-   */
-  async getAgentRunStatus(runId, _sessionId) {
-    this.logger.debug("getAgentRunStatus", { runId });
-    const authHeaders = await this.getSessionAuthHeaders();
-    const response = await fetch(`${this.baseUrl}/api/v2/agent/run/${runId}`, {
-      headers: authHeaders
-    });
-    if (!response.ok) {
-      const error = await response.json().catch(() => ({}));
-      throw new MixrPayError(error.error || `Failed to get run status: ${response.status}`);
-    }
-    const data = await response.json();
-    return {
-      runId: data.run_id,
-      status: data.status,
-      response: data.response,
-      iterations: data.iterations,
-      toolsUsed: data.tools_used,
-      cost: {
-        llmUsd: data.cost.llm_usd,
-        toolsUsd: data.cost.tools_usd,
-        totalUsd: data.cost.total_usd
-      },
-      tokens: data.tokens,
-      txHash: data.tx_hash,
-      error: data.error,
-      startedAt: new Date(data.started_at),
-      completedAt: data.completed_at ? new Date(data.completed_at) : void 0
-    };
-  }
-  /**
-   * Call an MCP tool using session authorization (pre-authorized spending limit).
-   * 
-   * Use this when you've already created a session with the tool provider
-   * and want to use that spending limit instead of direct wallet charges.
-   * 
-   * @param sessionId - The session ID for the tool provider
-   * @param toolName - The tool name in format "merchant/tool"
-   * @param args - Arguments to pass to the tool
-   * @returns Tool execution result
-   * 
-   * @example
-   * ```typescript
-   * // Create session with provider first
-   * const session = await wallet.getOrCreateSession({
-   *   merchantPublicKey: 'pk_live_firecrawl_...',
-   *   spendingLimitUsd: 50,
-   * });
-   * 
-   * // Use session for multiple calls
-   * const result = await wallet.callMCPToolWithSession(
-   *   session.id,
-   *   'firecrawl/scrape',
-   *   { url: 'https://example.com' }
-   * );
-   * ```
-   */
-  async callMCPToolWithSession(sessionId, toolName, args = {}) {
-    this.logger.debug("callMCPToolWithSession", { sessionId, toolName, args });
-    await this.validateMerchantAllowed(toolName, "tool");
-    const response = await fetch(`${this.baseUrl}/api/mcp`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "X-Mixr-Session": sessionId
-      },
-      body: JSON.stringify({
-        jsonrpc: "2.0",
-        method: "tools/call",
-        params: { name: toolName, arguments: args },
-        id: Date.now()
-      })
-    });
-    const result = await response.json();
-    if (result.error) {
-      throw new MixrPayError(result.error.message || "MCP tool call failed");
-    }
-    const content = result.result?.content?.[0];
-    const data = content?.text ? JSON.parse(content.text) : null;
-    const mixrpay = result.result?._mixrpay || {};
-    if (mixrpay.chargedUsd) {
-      const payment = {
-        amountUsd: mixrpay.chargedUsd,
-        recipient: toolName.split("/")[0] || toolName,
-        txHash: mixrpay.txHash,
-        timestamp: /* @__PURE__ */ new Date(),
-        description: `MCP: ${toolName}`,
-        url: `${this.baseUrl}/api/mcp`,
-        requestId: crypto.randomUUID()
-      };
-      this.payments.push(payment);
-      this.totalSpentUsd += mixrpay.chargedUsd;
-      this.logger.payment(mixrpay.chargedUsd, toolName, "MCP call (session)");
-      if (this.onPayment) {
-        this.onPayment(payment);
-      }
-    }
-    return {
-      data,
-      chargedUsd: mixrpay.chargedUsd || 0,
-      txHash: mixrpay.txHash,
-      latencyMs: mixrpay.latencyMs
-    };
-  }
-  // ===========================================================================
-  // Task Board Methods
-  // ===========================================================================
-  /**
-   * Create a new task on the Task Board.
-   * 
-   * Users (human or agent) can post tasks with budgets for other agents to complete.
-   * The listing fee is charged when an agent is accepted, not at creation time.
-   * 
-   * @param params - Task creation parameters
-   * @returns The created task
-   * 
-   * @example
-   * ```typescript
-   * const task = await wallet.createTask({
-   *   title: 'Research crypto regulations',
-   *   description: 'Research and summarize crypto regulations in the EU...',
-   *   budgetUsd: 100,
-   *   deliverables: ['PDF report', 'Summary document'],
-   *   category: 'research',
-   * });
-   * console.log(`Task created: ${task.id}`);
-   * ```
-   */
-  async createTask(params) {
-    this.logger.info(`Creating task: ${params.title}`);
-    const response = await this.callApi("/api/v2/tasks", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        title: params.title,
-        description: params.description,
-        budget_usd: params.budgetUsd,
-        deliverables: params.deliverables,
-        category: params.category,
-        expires_in_days: params.expiresInDays
-      })
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to create task");
-    }
-    return this.parseTask(result.task);
-  }
-  /**
-   * List open tasks on the Task Board.
-   * 
-   * Browse available tasks that agents can request to work on.
-   * 
-   * @param params - Optional filter parameters
-   * @returns List of tasks with pagination
-   * 
-   * @example
-   * ```typescript
-   * const { tasks, pagination } = await wallet.listTasks({
-   *   minBudget: 50,
-   *   category: 'research',
-   * });
-   * console.log(`Found ${pagination.total} matching tasks`);
-   * ```
-   */
-  async listTasks(params) {
-    const searchParams = new URLSearchParams();
-    if (params?.status) searchParams.set("status", params.status);
-    if (params?.category) searchParams.set("category", params.category);
-    if (params?.minBudget !== void 0) searchParams.set("min_budget", String(params.minBudget));
-    if (params?.maxBudget !== void 0) searchParams.set("max_budget", String(params.maxBudget));
-    if (params?.limit !== void 0) searchParams.set("limit", String(params.limit));
-    if (params?.offset !== void 0) searchParams.set("offset", String(params.offset));
-    const url = `/api/v2/tasks${searchParams.toString() ? `?${searchParams}` : ""}`;
-    const response = await this.callApi(url, { method: "GET" });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to list tasks");
-    }
-    return {
-      tasks: result.tasks.map((t) => this.parseTask(t)),
-      pagination: result.pagination
-    };
-  }
-  /**
-   * Get details for a specific task.
-   * 
-   * @param taskId - The task ID
-   * @returns Task details
-   */
-  async getTask(taskId) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}`, { method: "GET" });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to get task");
-    }
-    return this.parseTask(result.task);
-  }
-  /**
-   * Get tasks created by or assigned to the authenticated user.
-   * 
-   * @param options - Filter and pagination options
-   * @returns List of tasks with pagination info
-   * 
-   * @example
-   * ```typescript
-   * // Get all my tasks
-   * const { tasks, pagination } = await wallet.getMyTasks();
-   * 
-   * // Get only tasks I created
-   * const created = await wallet.getMyTasks({ role: 'creator' });
-   * 
-   * // Get only tasks assigned to me
-   * const assigned = await wallet.getMyTasks({ role: 'agent' });
-   * 
-   * // Filter by status
-   * const pending = await wallet.getMyTasks({ status: 'submitted' });
-   * ```
-   */
-  async getMyTasks(options = {}) {
-    const params = new URLSearchParams();
-    if (options.role) params.set("role", options.role);
-    if (options.status) params.set("status", options.status);
-    if (options.page) params.set("page", options.page.toString());
-    if (options.limit) params.set("limit", options.limit.toString());
-    const queryString = params.toString();
-    const url = `/api/v2/tasks/my${queryString ? `?${queryString}` : ""}`;
-    const response = await this.callApi(url, { method: "GET" });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to get tasks");
-    }
-    return {
-      tasks: result.tasks.map((t) => ({
-        ...this.parseTask(t),
-        isCreator: t.is_creator,
-        isAgent: t.is_agent
-      })),
-      pagination: {
-        page: result.pagination.page,
-        limit: result.pagination.limit,
-        total: result.pagination.total,
-        totalPages: result.pagination.total_pages
-      }
-    };
-  }
-  /**
-   * Request to claim a task.
-   * 
-   * Agents use this to express interest in completing a task.
-   * The task creator will review requests and accept one agent.
-   * 
-   * @param taskId - The task ID to request
-   * @param message - Optional pitch/message to the task creator
-   * @returns The created request
-   * 
-   * @example
-   * ```typescript
-   * const request = await wallet.requestTask('task_123', 
-   *   'I have experience with crypto research and can deliver within 24 hours.'
-   * );
-   * console.log(`Request submitted: ${request.id}`);
-   * ```
-   */
-  async requestTask(taskId, message) {
-    this.logger.info(`Requesting task: ${taskId}`);
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/request`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: message ? JSON.stringify({ message }) : "{}"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to request task");
-    }
-    return {
-      id: result.request.id,
-      taskId: result.request.task_id,
-      status: result.request.status,
-      message: result.request.message,
-      createdAt: new Date(result.request.created_at)
-    };
-  }
-  /**
-   * Get requests for a task you created.
-   * 
-   * @param taskId - The task ID
-   * @returns List of agent requests
-   */
-  async getTaskRequests(taskId) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/requests`, { method: "GET" });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to get task requests");
-    }
-    return result.requests.map((r) => ({
-      id: r.id,
-      status: r.status,
-      message: r.message,
-      createdAt: new Date(r.created_at),
-      reviewedAt: r.reviewed_at ? new Date(r.reviewed_at) : void 0,
-      agent: r.agent
-    }));
-  }
-  /**
-   * Accept an agent's request to work on your task.
-   * 
-   * This will:
-   * - Charge the listing fee from your wallet
-   * - Create a session for the agent with your task budget
-   * - Mark the task as claimed
-   * - Reject all other pending requests
-   * 
-   * @param taskId - The task ID
-   * @param requestId - The request ID to accept
-   * @returns Acceptance result with session info
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.acceptTaskRequest('task_123', 'req_456');
-   * console.log(`Agent accepted! Session budget: $${result.session.budgetUsd}`);
-   * ```
-   */
-  async acceptTaskRequest(taskId, requestId) {
-    this.logger.info(`Accepting request ${requestId} for task ${taskId}`);
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/requests/${requestId}/accept`, {
-      method: "POST"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to accept request");
-    }
-    return {
-      success: result.success,
-      task: {
-        id: result.task.id,
-        status: result.task.status,
-        agentUserId: result.task.agent_user_id
-      },
-      session: {
-        id: result.session.id,
-        sessionKey: result.session.session_key,
-        // Agent needs this to authenticate API calls
-        address: result.session.address,
-        expiresAt: new Date(result.session.expires_at),
-        budgetUsd: result.session.budget_usd,
-        allowedMerchants: result.session.allowed_merchants || []
-      },
-      invite: {
-        id: result.invite.id,
-        code: result.invite.code
-      },
-      listingFeeTxHash: result.listing_fee_tx_hash
-    };
-  }
-  /**
-   * Reject an agent's request.
-   * 
-   * @param taskId - The task ID
-   * @param requestId - The request ID to reject
-   */
-  async rejectTaskRequest(taskId, requestId) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/requests/${requestId}/reject`, {
-      method: "POST"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to reject request");
-    }
-  }
-  /**
-   * Submit deliverables for a task you're working on.
-   * 
-   * After being accepted to work on a task, use this to submit your work
-   * for the task creator's review.
-   * 
-   * @param taskId - The task ID
-   * @param output - The deliverables (text and/or URL)
-   * 
-   * @example
-   * ```typescript
-   * await wallet.submitTask('task_123', {
-   *   text: 'Here is my research report...',
-   *   url: 'https://docs.google.com/document/d/...',
-   * });
-   * ```
-   */
-  async submitTask(taskId, output) {
-    this.logger.info(`Submitting task: ${taskId}`);
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/submit`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        output_text: output.text,
-        output_url: output.url
-      })
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to submit task");
-    }
-  }
-  /**
-   * Approve a submitted task and pay the agent.
-   * 
-   * This will:
-   * - Calculate remaining budget (budget - spent on tools)
-   * - Transfer remaining budget to the agent's wallet
-   * - Mark the task as completed
-   * - Revoke the agent's session
-   * 
-   * @param taskId - The task ID
-   * @returns Payout details
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.approveTask('task_123');
-   * console.log(`Paid agent $${result.payout.amountUsd}`);
-   * ```
-   */
-  async approveTask(taskId) {
-    this.logger.info(`Approving task: ${taskId}`);
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/approve`, {
-      method: "POST"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to approve task");
-    }
-    return {
-      success: result.success,
-      task: {
-        id: result.task.id,
-        status: result.task.status,
-        completedAt: new Date(result.task.completed_at)
-      },
-      payout: {
-        status: result.payout.status,
-        amountUsd: result.payout.amount_usd,
-        txHash: result.payout.tx_hash
-      }
-    };
-  }
-  /**
-   * Reject a task submission and send it back for revision.
-   * 
-   * @param taskId - The task ID
-   * @param feedback - Optional feedback for the agent
-   */
-  async rejectTaskSubmission(taskId, feedback) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/reject`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: feedback ? JSON.stringify({ feedback }) : "{}"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to reject task");
-    }
-  }
-  /**
-   * Cancel a task you created.
-   * 
-   * Can only cancel tasks in 'open' or 'claimed' status.
-   * If the task was claimed, the agent's session will be revoked.
-   * 
-   * @param taskId - The task ID
-   */
-  async cancelTask(taskId) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}`, {
-      method: "DELETE"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to cancel task");
-    }
-  }
-  // ===========================================================================
-  // Mission Control: Subtask Management
-  // ===========================================================================
-  /**
-   * Create a subtask under an existing task.
-   * Requires session key authentication.
-   * Budget is allocated from the parent task's remaining budget.
-   * 
-   * @param options - Subtask creation options
-   * @returns The created subtask
-   * 
-   * @example
-   * ```typescript
-   * const subtask = await wallet.createSubtask({
-   *   parentTaskId: 'task_123',
-   *   title: 'Research competitor pricing',
-   *   description: 'Find pricing info for top 5 competitors',
-   *   budgetUsd: 10,
-   * });
-   * ```
-   */
-  async createSubtask(options) {
-    this.logger.info(`Creating subtask: ${options.title}`);
-    const response = await this.callApi("/api/v2/tasks/create-subtask", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        parent_task_id: options.parentTaskId,
-        title: options.title,
-        description: options.description,
-        deliverables: options.deliverables,
-        category: options.category,
-        budget_usd: options.budgetUsd,
-        allow_sub_agents: options.allowSubAgents,
-        expires_in_days: options.expiresInDays,
-        idempotency_key: options.idempotencyKey
-      })
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to create subtask");
-    }
-    return this.parseTask(result.task);
-  }
-  /**
-   * Update the status of a task.
-   * Requires session key authentication.
-   * Creates an audit trail via TaskStatusUpdate records.
-   * 
-   * @param taskId - The task ID
-   * @param status - New status
-   * @param note - Optional note explaining the status change
-   * @returns The updated task
-   * 
-   * @example
-   * ```typescript
-   * await wallet.updateTaskStatus('task_123', 'submitted', 'All deliverables completed');
-   * ```
-   */
-  async updateTaskStatus(taskId, status, note, idempotencyKey) {
-    this.logger.info(`Updating task ${taskId} status to ${status}`);
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/status`, {
-      method: "PATCH",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        status,
-        note,
-        idempotency_key: idempotencyKey
-      })
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to update task status");
-    }
-    return this.parseTask(result.task);
-  }
-  /**
-   * Get subtasks of a task.
-   * Requires session key authentication.
-   * 
-   * @param taskId - The parent task ID
-   * @returns List of subtasks
-   * 
-   * @example
-   * ```typescript
-   * const subtasks = await wallet.getSubtasks('task_123');
-   * console.log(`Found ${subtasks.length} subtasks`);
-   * ```
-   */
-  async getSubtasks(taskId) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/subtasks`, {
-      method: "GET"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to get subtasks");
-    }
-    return (result.subtasks || []).map((t) => this.parseTask(t));
-  }
-  /**
-   * Get the status history of a task.
-   * Requires session key authentication.
-   * 
-   * @param taskId - The task ID
-   * @returns Status history with audit trail
-   * 
-   * @example
-   * ```typescript
-   * const history = await wallet.getTaskStatusHistory('task_123');
-   * for (const entry of history.history) {
-   *   console.log(`${entry.oldStatus} -> ${entry.newStatus}: ${entry.note}`);
-   * }
-   * ```
-   */
-  async getTaskStatusHistory(taskId) {
-    const response = await this.callApi(`/api/v2/tasks/${taskId}/status`, {
-      method: "GET"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to get task status history");
-    }
-    return {
-      taskId: result.task_id,
-      currentStatus: result.current_status,
-      history: (result.history || []).map((h) => ({
-        id: h.id,
-        oldStatus: h.old_status,
-        newStatus: h.new_status,
-        note: h.note,
-        createdAt: new Date(h.created_at)
-      }))
-    };
-  }
-  // ===========================================================================
-  // Mission Control: Approval System
-  // ===========================================================================
-  /**
-   * Request approval from a human user for an action.
-   * Returns immediately if the action is auto-approved.
-   * 
-   * @param options - Approval request options
-   * @returns Approval request or auto-approval result
-   * 
-   * @example
-   * ```typescript
-   * const result = await wallet.requestApproval({
-   *   actionType: 'external_communication',
-   *   actionPayload: { recipient: 'user@example.com', message: 'Hello!' },
-   *   context: 'Sending welcome email to new customer',
-   * });
-   * 
-   * if ('autoApproved' in result) {
-   *   console.log('Auto-approved:', result.reason);
-   * } else {
-   *   console.log('Waiting for approval:', result.id);
-   * }
-   * ```
-   */
-  async requestApproval(options) {
-    this.logger.info(`Requesting approval for: ${options.actionType}`);
-    const response = await this.callApi("/api/v2/approvals/request", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        action_type: options.actionType,
-        action_payload: options.actionPayload,
-        context: options.context,
-        expires_in_hours: options.expiresInHours,
-        idempotency_key: options.idempotencyKey
-      })
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to request approval");
-    }
-    if (result.auto_approved) {
-      return {
-        autoApproved: true,
-        reason: result.reason
-      };
-    }
-    return this.parseApprovalRequest(result.approval_request);
-  }
-  /**
-   * Check the status of an approval request.
-   * 
-   * @param requestId - The approval request ID
-   * @returns Current status of the request
-   * 
-   * @example
-   * ```typescript
-   * const status = await wallet.checkApprovalStatus('req_123');
-   * if (status.status === 'approved') {
-   *   console.log('Approved! Proceeding with action...');
-   * }
-   * ```
-   */
-  async checkApprovalStatus(requestId) {
-    const response = await this.callApi(`/api/v2/approvals/check?request_id=${requestId}`, {
-      method: "GET"
-    });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to check approval status");
-    }
-    return {
-      requestId: result.request_id,
-      status: result.status,
-      responseNote: result.response_note,
-      approvalScope: result.approval_scope,
-      respondedAt: result.responded_at ? new Date(result.responded_at) : void 0
-    };
-  }
-  /**
-   * Check if an action type needs approval before execution.
-   * 
-   * @param actionType - The type of action to check
-   * @param amountUsd - Optional amount for spend actions
-   * @returns Whether approval is needed
-   * 
-   * @example
-   * ```typescript
-   * const check = await wallet.checkActionPermission('external_communication');
-   * if (check.needsApproval) {
-   *   const approval = await wallet.requestApproval({ ... });
-   * }
-   * ```
-   */
-  async checkActionPermission(actionType, amountUsd) {
-    let url = `/api/v2/approvals/check?action_type=${encodeURIComponent(actionType)}`;
-    if (amountUsd !== void 0) {
-      url += `&amount_usd=${amountUsd}`;
-    }
-    const response = await this.callApi(url, { method: "GET" });
-    const result = await response.json();
-    if (!response.ok) {
-      throw new MixrPayError(result.error || "Failed to check action permission");
-    }
-    return {
-      actionType: result.action_type,
-      needsApproval: result.needs_approval,
-      reason: result.reason
-    };
-  }
-  /**
-   * Wait for an approval request to be resolved.
-   * Polls the status until approved, rejected, or expired.
-   * 
-   * @param requestId - The approval request ID
-   * @param options - Polling options
-   * @returns Final status of the request
-   * 
-   * @example
-   * ```typescript
-   * const approval = await wallet.requestApproval({ ... });
-   * if (!('autoApproved' in approval)) {
-   *   const result = await wallet.waitForApproval(approval.id, { timeoutMs: 60000 });
-   *   if (result.status === 'approved') {
-   *     // Proceed with action
-   *   }
-   * }
-   * ```
-   */
-  async waitForApproval(requestId, options = {}) {
-    const pollInterval = options.pollIntervalMs || 5e3;
-    const timeout = options.timeoutMs || 3e5;
-    const startTime = Date.now();
-    while (Date.now() - startTime < timeout) {
-      const status = await this.checkApprovalStatus(requestId);
-      if (status.status !== "pending") {
-        return status;
-      }
-      await new Promise((resolve) => setTimeout(resolve, pollInterval));
-    }
-    return {
-      requestId,
-      status: "expired"
-    };
-  }
-  /** Helper to parse approval request from API response */
-  parseApprovalRequest(r) {
-    return {
-      id: r.id,
-      actionType: r.action_type,
-      actionPayload: r.action_payload,
-      context: r.context,
-      status: r.status,
-      responseNote: r.response_note,
-      approvalScope: r.approval_scope,
-      createdAt: new Date(r.created_at),
-      expiresAt: new Date(r.expires_at),
-      respondedAt: r.responded_at ? new Date(r.responded_at) : void 0
-    };
-  }
-  /** Helper to parse task from API response */
-  parseTask(t) {
-    return {
-      id: t.id,
-      title: t.title,
-      description: t.description,
-      deliverables: t.deliverables || [],
-      category: t.category,
-      budgetUsd: t.budget_usd,
-      listingFeeUsd: t.listing_fee_usd,
-      status: t.status,
-      createdAt: new Date(t.created_at),
-      updatedAt: t.updated_at ? new Date(t.updated_at) : void 0,
-      expiresAt: t.expires_at ? new Date(t.expires_at) : void 0,
-      claimedAt: t.claimed_at ? new Date(t.claimed_at) : void 0,
-      submittedAt: t.submitted_at ? new Date(t.submitted_at) : void 0,
-      completedAt: t.completed_at ? new Date(t.completed_at) : void 0,
-      creator: t.creator,
-      assignedAgent: t.assigned_agent,
-      requestCount: t.request_count,
-      output: t.output,
-      payment: t.payment
-    };
-  }
-  /** Helper to call our API with auth */
-  async callApi(path, init = {}) {
-    const url = `${this.baseUrl}${path}`;
-    const headers = {
-      ...init.headers
-    };
-    if (this.sessionKey) {
-      const account = privateKeyToAccount2(this.sessionKey.rawPrivateKey);
-      const address = account.address.toLowerCase();
-      const timestamp = Date.now();
-      const message = `MixrPay:${timestamp}:${address}`;
-      const signature = await signMessage({
-        message,
-        privateKey: this.sessionKey.rawPrivateKey
-      });
-      headers["X-Session-Auth"] = JSON.stringify({
-        address,
-        timestamp,
-        signature
-      });
-    }
-    return fetch(url, {
-      ...init,
-      headers
-    });
-  }
-};
-export {
-  AgentWallet,
-  InsufficientBalanceError,
-  InvalidSessionKeyError,
-  MerchantNotAllowedError,
-  MixrPayError,
-  PaymentFailedError,
-  SDK_VERSION,
-  SessionExpiredError,
-  SessionKeyExpiredError,
-  SessionLimitExceededError,
-  SessionNotFoundError,
-  SessionRevokedError,
-  SpendingLimitExceededError,
-  X402ProtocolError,
-  getErrorMessage,
-  isMixrPayError
-};
+Timestamp: ${e}`,s=await this.sessionKey.signMessage(t);return {"X-Mixr-Wallet":this.walletAddress,"X-Mixr-Signature":s,"X-Mixr-Timestamp":e}}async listTools(){this.logger.debug("listTools");let e=await fetch(`${this.baseUrl}/api/mcp`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({jsonrpc:"2.0",method:"tools/list",id:Date.now()})});if(!e.ok)throw new l(`Failed to list MCP tools: ${e.status}`);let t=await e.json();if(t.error)throw new l(t.error.message||"Failed to list MCP tools");return (t.result?.tools||[]).map(s=>({name:s.name,description:s.description,inputSchema:s.inputSchema,priceUsd:s["x-mixrpay"]?.priceUsd||0,merchantName:s["x-mixrpay"]?.merchantName,merchantSlug:s["x-mixrpay"]?.merchantSlug,verified:s["x-mixrpay"]?.verified||false}))}async listMCPTools(){return this.listTools()}async callTool(e,t={}){this.logger.debug("callTool",{toolName:e,args:t}),await this.validateMerchantAllowed(e,"tool");let s=await this.getMCPAuthHeaders(),a=await(await fetch(`${this.baseUrl}/api/mcp`,{method:"POST",headers:{"Content-Type":"application/json",...s},body:JSON.stringify({jsonrpc:"2.0",method:"tools/call",params:{name:e,arguments:t},id:Date.now()})})).json();if(a.error)throw new l(a.error.message||"MCP tool call failed");let r=a.result?.content?.[0],i=r?.text?JSON.parse(r.text):null,o=a.result?._mixrpay||{};if(o.chargedUsd){let c={amountUsd:o.chargedUsd,recipient:e.split("/")[0]||e,txHash:o.txHash,timestamp:new Date,description:`MCP: ${e}`,url:`${this.baseUrl}/api/mcp`,requestId:crypto.randomUUID()};this.payments.push(c),this.totalSpentUsd+=o.chargedUsd,this.logger.payment(o.chargedUsd,e,"MCP call"),this.onPayment&&this.onPayment(c);}return {data:i,chargedUsd:o.chargedUsd||0,txHash:o.txHash,latencyMs:o.latencyMs}}async callMCPTool(e,t={}){return this.callTool(e,t)}async deployJitMcp(e){this.logger.debug("deployJitMcp",{glamaId:e.glamaId,toolName:e.toolName});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit/deploy`,{method:"POST",headers:{"Content-Type":"application/json",...t},body:JSON.stringify({glama_id:e.glamaId,glama_namespace:e.glamaNamespace,glama_slug:e.glamaSlug,tool_name:e.toolName,tool_description:e.toolDescription,env_vars:e.envVars,ttl_hours:e.ttlHours||24})});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`JIT deploy failed: ${s.status}`)}let n=await s.json();if(n.payment?.amount_usd>0){let a={amountUsd:n.payment.amount_usd,recipient:"mixrpay-jit-deploy",txHash:n.payment.tx_hash,timestamp:new Date,description:`JIT Deploy: ${e.toolName}`,url:`${this.baseUrl}/api/v2/jit/deploy`,requestId:n.request_id||crypto.randomUUID()};this.payments.push(a),this.totalSpentUsd+=n.payment.amount_usd,this.logger.payment(n.payment.amount_usd,"jit-deploy",e.toolName),this.onPayment&&this.onPayment(a);}return {instance:this.parseJitInstance(n.instance),payment:{method:n.payment.method,amountUsd:n.payment.amount_usd,txHash:n.payment.tx_hash}}}async listJitInstances(e){this.logger.debug("listJitInstances",e);let t=await this.getSessionAuthHeaders(),s=new URLSearchParams;e?.status&&s.set("status",e.status);let n=await fetch(`${this.baseUrl}/api/v2/jit/instances?${s}`,{headers:t});if(!n.ok){let r=await n.json().catch(()=>({}));throw new l(r.error||`Failed to list JIT instances: ${n.status}`)}return ((await n.json()).instances||[]).map(r=>this.parseJitInstance(r))}async stopJitInstance(e){this.logger.debug("stopJitInstance",{instanceId:e});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit/instances/${e}`,{method:"DELETE",headers:t});if(!s.ok){let n=await s.json().catch(()=>({}));throw new l(n.error||`Failed to stop JIT instance: ${s.status}`)}}parseJitInstance(e){return {id:e.id,endpointUrl:e.endpoint_url,toolName:e.tool_name,glamaId:e.glama_id,glamaNamespace:e.glama_namespace,glamaSlug:e.glama_slug,status:e.status,mode:e.mode,ttlHours:e.ttl_hours,expiresAt:new Date(e.expires_at),createdAt:new Date(e.created_at)}}async getJitInstance(e){this.logger.debug("getJitInstance",{instanceId:e});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit/instances/${e}`,{headers:t});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Failed to get JIT instance: ${s.status}`)}let n=await s.json();return this.parseJitInstance(n.instance)}async executeTransaction(e){this.logger.debug("executeTransaction",{to:e.to,estimatedCostUsd:e.estimatedCostUsd});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/tx/execute`,{method:"POST",headers:{"Content-Type":"application/json",...t},body:JSON.stringify({to:e.to,data:e.data,value:e.value?.toString()??"0",chain_id:e.chainId,estimated_cost_usd:e.estimatedCostUsd,description:e.description,idempotency_key:e.idempotencyKey})}),n=await s.json().catch(()=>({}));if(!s.ok){let a=(n.error_code||"tx_failed").toLowerCase(),r=n.error||`Transaction execution failed: ${s.status}`;throw a==="budget_exceeded"?new l(r,"SPENDING_LIMIT_EXCEEDED"):new l(r,a)}return this.logger.info("Transaction executed",{txHash:n.tx_hash,estimatedCostUsd:e.estimatedCostUsd,remainingBudgetUsd:n.remaining_budget_usd}),{success:true,txHash:n.tx_hash,chargeId:n.charge_id,estimatedCostUsd:n.estimated_cost_usd,remainingBudgetUsd:n.remaining_budget_usd}}async useSkill(e,t){this.logger.debug("useSkill",{skillId:e,options:t});let s=await this.getSessionAuthHeaders(),n=await fetch(`${this.baseUrl}/api/v2/skills/${e}/use`,{method:"POST",headers:{"Content-Type":"application/json",...s},body:JSON.stringify({ttl_hours:t?.ttlHours||24})});if(!n.ok){let r=await n.json().catch(()=>({}));throw r.configure_url?new l(`${r.error||"Skill not configured"}. Configure at: ${this.baseUrl}${r.configure_url}`,"SKILL_NOT_CONFIGURED"):new l(r.error||`Failed to use skill: ${n.status}`)}let a=await n.json();return {skillId:a.skill_id,endpoint:a.endpoint,tools:a.tools||[],expiresAt:new Date(a.expires_at),instanceId:a.instance_id}}async listSkills(){this.logger.debug("listSkills");let e=await this.getSessionAuthHeaders(),t=await fetch(`${this.baseUrl}/api/v2/skills`,{headers:e});if(!t.ok){let n=await t.json().catch(()=>({}));throw new l(n.error||`Failed to list skills: ${t.status}`)}return (await t.json()).skills||[]}async getConnectedApps(){this.logger.debug("getConnectedApps");let e=await this.getSessionAuthHeaders(),t=await fetch(`${this.baseUrl}/api/v2/skills/composio/connections`,{headers:e});if(!t.ok){let a=await t.json().catch(()=>({}));throw new l(a.error||`Failed to get connected apps: ${t.status}`,"CONNECTED_APPS_FAILED")}let s=await t.json();return {connected:(s.connections||[]).filter(a=>a.status==="connected").map(a=>a.app.toLowerCase()),connections:s.connections||[],oauthConnections:s.oauth_connections||[],apiKeyConnections:s.api_key_connections||[]}}async getSkillStatus(e){this.logger.debug("getSkillStatus",{skillId:e});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/skills/${e}/configure`,{headers:t});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Failed to get skill status: ${s.status}`)}let n=await s.json();return {skillId:n.skill_id,status:n.status,configuredVars:n.configured_vars||[],lastUsedAt:n.last_used_at?new Date(n.last_used_at):void 0,errorMessage:n.error_message}}async configureSkill(e,t){this.logger.debug("configureSkill",{skillId:e,varNames:Object.keys(t)});let s=await this.getSessionAuthHeaders(),n=await fetch(`${this.baseUrl}/api/v2/skills/${e}/configure`,{method:"POST",headers:{"Content-Type":"application/json",...s},body:JSON.stringify({env_vars:t})});if(!n.ok){let r=await n.json().catch(()=>({}));throw new l(r.error||`Failed to configure skill: ${n.status}`,r.error_code)}let a=await n.json();return {success:true,skillId:a.skill_id,configuredVars:a.configured_vars||[]}}async searchGlamaDirectory(e){this.logger.debug("searchGlamaDirectory",{query:e});let t=new URLSearchParams({q:e}),s=await fetch(`${this.baseUrl}/api/mcp/glama?${t}`);if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Glama search failed: ${s.status}`)}let n=await s.json();return {servers:(n.servers||[]).map(a=>this.parseGlamaServer(a)),pageInfo:n.pageInfo,query:n.query}}async getFeaturedGlamaServers(){this.logger.debug("getFeaturedGlamaServers");let e=await fetch(`${this.baseUrl}/api/mcp/glama`);if(!e.ok){let s=await e.json().catch(()=>({}));throw new l(s.error||`Failed to get featured servers: ${e.status}`)}let t=await e.json();return {servers:(t.servers||[]).map(s=>this.parseGlamaServer(s)),featured:t.featured}}parseGlamaServer(e){let t=e.importData;return {id:e.id,name:e.name,namespace:e.namespace,slug:e.slug,description:e.description,url:e.url,attributes:e.attributes,canHost:e.canHost,tools:e.tools||[],repository:e.repository,license:e.spdxLicense?.name,importData:t?{glamaId:t.glamaId,glamaNamespace:t.glamaNamespace,glamaSlug:t.glamaSlug,suggestedName:t.suggestedName,suggestedDescription:t.suggestedDescription,hostingType:t.hostingType,requiredEnvVars:t.requiredEnvVars,optionalEnvVars:t.optionalEnvVars}:void 0}}async deployTaskAgent(e){this.logger.debug("deployTaskAgent",{name:e.name,budgetUsd:e.budgetUsd});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit-task/deploy`,{method:"POST",headers:{"Content-Type":"application/json",...t},body:JSON.stringify({name:e.name,prompt:e.prompt,system_prompt:e.systemPrompt,model:e.model||"claude-sonnet-4-5",tools:e.tools||[],budget_usd:e.budgetUsd,ttl_hours:e.ttlHours||24,max_iterations:e.maxIterations||10,plan_id:e.planId,task_id:e.taskId,idempotency_key:e.idempotencyKey,auto_run:e.autoRun||false})});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Task agent deploy failed: ${s.status}`)}let n=await s.json();return {instance:this.parseTaskAgentInstance(n.instance),idempotent:n.idempotent||false,requestId:n.request_id}}async getTaskAgentStatus(e){this.logger.debug("getTaskAgentStatus",{instanceId:e});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit-task/${e}`,{method:"GET",headers:t});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Failed to get task status: ${s.status}`)}let n=await s.json();return this.parseTaskAgentStatus(n)}async triggerTaskAgent(e){this.logger.debug("triggerTaskAgent",{instanceId:e});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit-task/${e}`,{method:"POST",headers:{"Content-Type":"application/json",...t}});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Failed to trigger task: ${s.status}`)}let n=await s.json();return {success:n.success,status:n.status}}async cancelTaskAgent(e){this.logger.debug("cancelTaskAgent",{instanceId:e});let t=await this.getSessionAuthHeaders(),s=await fetch(`${this.baseUrl}/api/v2/jit-task/${e}`,{method:"DELETE",headers:t});if(!s.ok){let a=await s.json().catch(()=>({}));throw new l(a.error||`Failed to cancel task: ${s.status}`)}let n=await s.json();return {success:n.success,status:n.status}}async listTaskAgents(e){this.logger.debug("listTaskAgents",{options:e});let t=await this.getSessionAuthHeaders(),s=new URLSearchParams;e?.status&&s.set("status",e.status),e?.planId&&s.set("plan_id",e.planId),e?.taskId&&s.set("task_id",e.taskId),e?.limit!==void 0&&s.set("limit",String(e.limit)),e?.offset!==void 0&&s.set("offset",String(e.offset));let n=s.toString(),a=`${this.baseUrl}/api/v2/jit-task${n?`?${n}`:""}`,r=await fetch(a,{method:"GET",headers:t});if(!r.ok){let o=await r.json().catch(()=>({}));throw new l(o.error||`Failed to list task agents: ${r.status}`)}let i=await r.json();return {taskAgents:(i.task_agents||[]).map(o=>{let c=o.budget,p=o.iterations,u=o.usage,g=o.plan,h=o.task;return {id:o.id,name:o.name,prompt:o.prompt,model:o.model,tools:o.tools,status:o.status,budget:{totalUsd:c.total_usd,spentUsd:c.spent_usd,remainingUsd:c.remaining_usd},iterations:{current:p.current,max:p.max},usage:{toolCalls:u.tool_calls,inputTokens:u.input_tokens,outputTokens:u.output_tokens},result:o.result,error:o.error,depth:o.depth,plan:g?{id:g.id,title:g.title}:null,task:h?{id:h.id,title:h.title}:null,ttlHours:o.ttl_hours,expiresAt:new Date(o.expires_at),createdAt:new Date(o.created_at),startedAt:o.started_at?new Date(o.started_at):void 0,completedAt:o.completed_at?new Date(o.completed_at):void 0}}),pagination:{total:i.pagination.total,limit:i.pagination.limit,offset:i.pagination.offset,hasMore:i.pagination.has_more},stats:{active:i.stats.active??0,completed:i.stats.completed??0,failed:i.stats.failed??0,totalSpentUsd:i.stats.total_spent_usd??0}}}async waitForTaskAgent(e,t){let s=t?.pollIntervalMs||2e3,n=t?.timeoutMs||3e5,a=Date.now();for(this.logger.debug("waitForTaskAgent",{instanceId:e,pollIntervalMs:s,timeoutMs:n});;){let r=await this.getTaskAgentStatus(e);if(["completed","failed","cancelled","budget_exceeded","expired"].includes(r.status))return {id:r.id,status:r.status,result:r.result,error:r.error,spentUsd:r.budget.spentUsd,iterations:r.iterations.current,toolCalls:r.usage.toolCalls,completedAt:r.completedAt};if(Date.now()-a>n)throw new l(`Task agent wait timeout after ${n}ms`);await new Promise(i=>setTimeout(i,s));}}parseTaskAgentInstance(e){return {id:e.id,name:e.name,endpointUrl:e.endpoint_url,statusUrl:e.status_url,triggerUrl:e.trigger_url,cancelUrl:e.cancel_url,resultUrl:e.result_url,status:e.status,budgetUsd:e.budget_usd,expiresAt:new Date(e.expires_at),depth:e.depth,maxIterations:e.max_iterations}}parseTaskAgentStatus(e){let t=e.budget,s=e.iterations,n=e.usage,a=e.endpoints;return {id:e.id,name:e.name,prompt:e.prompt,model:e.model,tools:e.tools,status:e.status,budget:{totalUsd:t?.total_usd??0,spentUsd:t?.spent_usd??0,remainingUsd:t?.remaining_usd??0},iterations:{current:s?.current??0,max:s?.max??0},usage:{toolCalls:n?.tool_calls??0,inputTokens:n?.input_tokens??0,outputTokens:n?.output_tokens??0},result:e.result,error:e.error,depth:e.depth,planId:e.plan_id,taskId:e.task_id,endpoints:{statusUrl:a?.status_url??"",triggerUrl:a?.trigger_url??"",cancelUrl:a?.cancel_url??"",resultUrl:a?.result_url??""},ttlHours:e.ttl_hours,expiresAt:new Date(e.expires_at),createdAt:new Date(e.created_at),startedAt:e.started_at?new Date(e.started_at):void 0,completedAt:e.completed_at?new Date(e.completed_at):void 0}}async complete(e,t){this.logger.debug("complete",{promptLength:e.length,model:t?.model});let s=await this.runAgent({messages:[{role:"user",content:e}],config:{model:t?.model||"gpt-4o-mini",maxIterations:1,tools:[],systemPrompt:t?.systemPrompt}});return {text:s.response,costUsd:s.cost.totalUsd,tokens:s.tokens,model:t?.model||"gpt-4o-mini"}}async runAgent(e){let{sessionId:t,messages:s,config:n={},stream:a=false,idempotencyKey:r,onEvent:i}=e;this.logger.debug("runAgent",{sessionId:t||"(from signature)",messageCount:s.length,config:n,stream:a});let o={messages:s.map(p=>({role:p.role,content:p.content})),config:{model:n.model,max_iterations:n.maxIterations,tools:n.tools,system_prompt:n.systemPrompt},stream:a,idempotency_key:r};t&&(o.session_id=t);let c=18e4;if(!a){let p=await this.getSessionAuthHeaders(),u=await fetch(`${this.baseUrl}/api/v2/agent/run`,{method:"POST",headers:{"Content-Type":"application/json",...p},body:JSON.stringify(o),signal:AbortSignal.timeout(c)});if(!u.ok){let h=await u.json().catch(()=>({}));throw new l(h.error||`Agent run failed: ${u.status}`)}let g=await u.json();if(g.cost?.total_usd>0){let h={amountUsd:g.cost.total_usd,recipient:"mixrpay-agent-run",txHash:g.tx_hash,timestamp:new Date,description:`Agent run: ${g.run_id}`,url:`${this.baseUrl}/api/v2/agent/run`,requestId:r||crypto.randomUUID()};this.payments.push(h),this.totalSpentUsd+=g.cost.total_usd,this.logger.payment(g.cost.total_usd,"agent-run",g.run_id),this.onPayment&&this.onPayment(h);}return {runId:g.run_id,status:g.status,response:g.response,iterations:g.iterations,toolsUsed:g.tools_used,cost:{llmUsd:g.cost.llm_usd,toolsUsd:g.cost.tools_usd,totalUsd:g.cost.total_usd},tokens:g.tokens,sessionRemainingUsd:g.session_remaining_usd,txHash:g.tx_hash}}return this.runAgentStreaming(o,i)}async runAgentStreaming(e,t){let n=await this.getSessionAuthHeaders(),a=await fetch(`${this.baseUrl}/api/v2/agent/run`,{method:"POST",headers:{"Content-Type":"application/json",...n},body:JSON.stringify(e),signal:AbortSignal.timeout(3e5)});if(!a.ok){let p=await a.json().catch(()=>({}));throw new l(p.error||`Agent run failed: ${a.status}`)}let r=a.body?.getReader();if(!r)throw new l("No response body for streaming");let i=new TextDecoder,o="",c=null;for(;;){let{done:p,value:u}=await r.read();if(p)break;o+=i.decode(u,{stream:true});let g=o.split(`
+`);o=g.pop()||"";let h="";for(let y of g)if(y.startsWith("event: "))h=y.slice(7).trim();else if(y.startsWith("data: ")&&h){try{let m=JSON.parse(y.slice(6)),f=this.parseSSEEvent(h,m);if(f){if(t?.(f),h==="complete"&&(c={runId:m.run_id,status:"completed",response:m.response,iterations:m.iterations,toolsUsed:m.tools_used,cost:{llmUsd:0,toolsUsd:0,totalUsd:m.total_cost_usd},tokens:{prompt:0,completion:0},sessionRemainingUsd:0,txHash:m.tx_hash},m.total_cost_usd>0)){let w={amountUsd:m.total_cost_usd,recipient:"mixrpay-agent-run",txHash:m.tx_hash,timestamp:new Date,description:`Agent run: ${m.run_id}`,url:`${this.baseUrl}/api/v2/agent/run`,requestId:e.idempotency_key||crypto.randomUUID()};this.payments.push(w),this.totalSpentUsd+=m.total_cost_usd,this.onPayment&&this.onPayment(w);}if(h==="error")throw new l(m.error||"Agent run failed")}}catch(m){if(m instanceof l)throw m;this.logger.warn("Failed to parse SSE event:",m);}h="";}}if(!c)throw new l("Agent run completed without final result");return c}parseSSEEvent(e,t){switch(e){case "run_start":return {type:"run_start",runId:t.run_id};case "iteration_start":return {type:"iteration_start",iteration:t.iteration};case "llm_chunk":return {type:"llm_chunk",delta:t.delta};case "tool_call":return {type:"tool_call",tool:t.tool,arguments:t.arguments};case "tool_result":return {type:"tool_result",tool:t.tool,success:t.success,costUsd:t.cost_usd,error:t.error};case "iteration_complete":return {type:"iteration_complete",iteration:t.iteration,tokens:t.tokens,costUsd:t.cost_usd};case "complete":return {type:"complete",runId:t.run_id,response:t.response,totalCostUsd:t.total_cost_usd,txHash:t.tx_hash,iterations:t.iterations,toolsUsed:t.tools_used};case "error":return {type:"error",error:t.error,partialCostUsd:t.partial_cost_usd};default:return null}}async getAgentRunStatus(e,t){this.logger.debug("getAgentRunStatus",{runId:e});let s=await this.getSessionAuthHeaders(),n=await fetch(`${this.baseUrl}/api/v2/agent/run/${e}`,{headers:s});if(!n.ok){let r=await n.json().catch(()=>({}));throw new l(r.error||`Failed to get run status: ${n.status}`)}let a=await n.json();return {runId:a.run_id,status:a.status,response:a.response,iterations:a.iterations,toolsUsed:a.tools_used,cost:{llmUsd:a.cost.llm_usd,toolsUsd:a.cost.tools_usd,totalUsd:a.cost.total_usd},tokens:a.tokens,txHash:a.tx_hash,error:a.error,startedAt:new Date(a.started_at),completedAt:a.completed_at?new Date(a.completed_at):void 0}}async callToolWithSession(e,t,s={}){this.logger.debug("callToolWithSession",{sessionId:e,toolName:t,args:s}),await this.validateMerchantAllowed(t,"tool");let a=await(await fetch(`${this.baseUrl}/api/mcp`,{method:"POST",headers:{"Content-Type":"application/json","X-Mixr-Session":e},body:JSON.stringify({jsonrpc:"2.0",method:"tools/call",params:{name:t,arguments:s},id:Date.now()})})).json();if(a.error)throw new l(a.error.message||"MCP tool call failed");let r=a.result?.content?.[0],i=r?.text?JSON.parse(r.text):null,o=a.result?._mixrpay||{};if(o.chargedUsd){let c={amountUsd:o.chargedUsd,recipient:t.split("/")[0]||t,txHash:o.txHash,timestamp:new Date,description:`MCP: ${t}`,url:`${this.baseUrl}/api/mcp`,requestId:crypto.randomUUID()};this.payments.push(c),this.totalSpentUsd+=o.chargedUsd,this.logger.payment(o.chargedUsd,t,"MCP call (session)"),this.onPayment&&this.onPayment(c);}return {data:i,chargedUsd:o.chargedUsd||0,txHash:o.txHash,latencyMs:o.latencyMs}}async callMCPToolWithSession(e,t,s={}){return this.callToolWithSession(e,t,s)}async createTask(e){this.logger.info(`Creating task: ${e.title}`);let t=await this.callApi("/api/v2/tasks",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({title:e.title,description:e.description,budget_usd:e.budgetUsd,deliverables:e.deliverables,category:e.category,expires_in_days:e.expiresInDays})}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to create task");return this.parseTask(s.task)}async listTasks(e){let t=new URLSearchParams;e?.status&&t.set("status",e.status),e?.category&&t.set("category",e.category),e?.minBudget!==void 0&&t.set("min_budget",String(e.minBudget)),e?.maxBudget!==void 0&&t.set("max_budget",String(e.maxBudget)),e?.limit!==void 0&&t.set("limit",String(e.limit)),e?.offset!==void 0&&t.set("offset",String(e.offset));let s=`/api/v2/tasks${t.toString()?`?${t}`:""}`,n=await this.callApi(s,{method:"GET"}),a=await n.json();if(!n.ok)throw new l(a.error||"Failed to list tasks");return {tasks:a.tasks.map(r=>this.parseTask(r)),pagination:a.pagination}}async getTask(e){let t=await this.callApi(`/api/v2/tasks/${e}`,{method:"GET"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to get task");return this.parseTask(s.task)}async getMyTasks(e={}){let t=new URLSearchParams;e.role&&t.set("role",e.role),e.status&&t.set("status",e.status),e.page&&t.set("page",e.page.toString()),e.limit&&t.set("limit",e.limit.toString());let s=t.toString(),n=`/api/v2/tasks/my${s?`?${s}`:""}`,a=await this.callApi(n,{method:"GET"}),r=await a.json();if(!a.ok)throw new l(r.error||"Failed to get tasks");return {tasks:r.tasks.map(i=>({...this.parseTask(i),isCreator:i.is_creator,isAgent:i.is_agent})),pagination:{page:r.pagination.page,limit:r.pagination.limit,total:r.pagination.total,totalPages:r.pagination.total_pages}}}async requestTask(e,t){this.logger.info(`Requesting task: ${e}`);let s=await this.callApi(`/api/v2/tasks/${e}/request`,{method:"POST",headers:{"Content-Type":"application/json"},body:t?JSON.stringify({message:t}):"{}"}),n=await s.json();if(!s.ok)throw new l(n.error||"Failed to request task");return {id:n.request.id,taskId:n.request.task_id,status:n.request.status,message:n.request.message,createdAt:new Date(n.request.created_at)}}async getTaskRequests(e){let t=await this.callApi(`/api/v2/tasks/${e}/requests`,{method:"GET"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to get task requests");return s.requests.map(n=>({id:n.id,status:n.status,message:n.message,createdAt:new Date(n.created_at),reviewedAt:n.reviewed_at?new Date(n.reviewed_at):void 0,agent:n.agent}))}async acceptTaskRequest(e,t){this.logger.info(`Accepting request ${t} for task ${e}`);let s=await this.callApi(`/api/v2/tasks/${e}/requests/${t}/accept`,{method:"POST"}),n=await s.json();if(!s.ok)throw new l(n.error||"Failed to accept request");return {success:n.success,task:{id:n.task.id,status:n.task.status,agentUserId:n.task.agent_user_id},session:{id:n.session.id,sessionKey:n.session.session_key,address:n.session.address,expiresAt:new Date(n.session.expires_at),budgetUsd:n.session.budget_usd,allowedMerchants:n.session.allowed_merchants||[]},invite:{id:n.invite.id,code:n.invite.code},listingFeeTxHash:n.listing_fee_tx_hash}}async rejectTaskRequest(e,t){let s=await this.callApi(`/api/v2/tasks/${e}/requests/${t}/reject`,{method:"POST"}),n=await s.json();if(!s.ok)throw new l(n.error||"Failed to reject request")}async submitTask(e,t){this.logger.info(`Submitting task: ${e}`);let s=await this.callApi(`/api/v2/tasks/${e}/submit`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({output_text:t.text,output_url:t.url})}),n=await s.json();if(!s.ok)throw new l(n.error||"Failed to submit task")}async approveTask(e){this.logger.info(`Approving task: ${e}`);let t=await this.callApi(`/api/v2/tasks/${e}/approve`,{method:"POST"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to approve task");return {success:s.success,task:{id:s.task.id,status:s.task.status,completedAt:new Date(s.task.completed_at)},payout:{status:s.payout.status,amountUsd:s.payout.amount_usd,txHash:s.payout.tx_hash}}}async rejectTaskSubmission(e,t){let s=await this.callApi(`/api/v2/tasks/${e}/reject`,{method:"POST",headers:{"Content-Type":"application/json"},body:t?JSON.stringify({feedback:t}):"{}"}),n=await s.json();if(!s.ok)throw new l(n.error||"Failed to reject task")}async cancelTask(e){let t=await this.callApi(`/api/v2/tasks/${e}`,{method:"DELETE"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to cancel task")}async createSubtask(e){this.logger.info(`Creating subtask: ${e.title}`);let t=await this.callApi("/api/v2/tasks/create-subtask",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({parent_task_id:e.parentTaskId,title:e.title,description:e.description,deliverables:e.deliverables,category:e.category,budget_usd:e.budgetUsd,allow_sub_agents:e.allowSubAgents,expires_in_days:e.expiresInDays,idempotency_key:e.idempotencyKey})}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to create subtask");return this.parseTask(s.task)}async updateTaskStatus(e,t,s,n){this.logger.info(`Updating task ${e} status to ${t}`);let a=await this.callApi(`/api/v2/tasks/${e}/status`,{method:"PATCH",headers:{"Content-Type":"application/json"},body:JSON.stringify({status:t,note:s,idempotency_key:n})}),r=await a.json();if(!a.ok)throw new l(r.error||"Failed to update task status");return this.parseTask(r.task)}async getSubtasks(e){let t=await this.callApi(`/api/v2/tasks/${e}/subtasks`,{method:"GET"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to get subtasks");return (s.subtasks||[]).map(n=>this.parseTask(n))}async getTaskStatusHistory(e){let t=await this.callApi(`/api/v2/tasks/${e}/status`,{method:"GET"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to get task status history");return {taskId:s.task_id,currentStatus:s.current_status,history:(s.history||[]).map(n=>({id:n.id,oldStatus:n.old_status,newStatus:n.new_status,note:n.note,createdAt:new Date(n.created_at)}))}}async requestApproval(e){this.logger.info(`Requesting approval for: ${e.actionType}`);let t=await this.callApi("/api/v2/approvals/request",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({action_type:e.actionType,action_payload:e.actionPayload,context:e.context,expires_in_hours:e.expiresInHours,idempotency_key:e.idempotencyKey})}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to request approval");return s.auto_approved?{autoApproved:true,reason:s.reason}:this.parseApprovalRequest(s.approval_request)}async checkApprovalStatus(e){let t=await this.callApi(`/api/v2/approvals/check?request_id=${e}`,{method:"GET"}),s=await t.json();if(!t.ok)throw new l(s.error||"Failed to check approval status");return {requestId:s.request_id,status:s.status,responseNote:s.response_note,approvalScope:s.approval_scope,respondedAt:s.responded_at?new Date(s.responded_at):void 0}}async checkActionPermission(e,t){let s=`/api/v2/approvals/check?action_type=${encodeURIComponent(e)}`;t!==void 0&&(s+=`&amount_usd=${t}`);let n=await this.callApi(s,{method:"GET"}),a=await n.json();if(!n.ok)throw new l(a.error||"Failed to check action permission");return {actionType:a.action_type,needsApproval:a.needs_approval,reason:a.reason}}async waitForApproval(e,t={}){let s=t.pollIntervalMs||5e3,n=t.timeoutMs||3e5,a=Date.now();for(;Date.now()-a<n;){let r=await this.checkApprovalStatus(e);if(r.status!=="pending")return r;await new Promise(i=>setTimeout(i,s));}return {requestId:e,status:"expired"}}parseApprovalRequest(e){return {id:e.id,actionType:e.action_type,actionPayload:e.action_payload,context:e.context,status:e.status,responseNote:e.response_note,approvalScope:e.approval_scope,createdAt:new Date(e.created_at),expiresAt:new Date(e.expires_at),respondedAt:e.responded_at?new Date(e.responded_at):void 0}}parseTask(e){return {id:e.id,title:e.title,description:e.description,deliverables:e.deliverables||[],category:e.category,budgetUsd:e.budget_usd,listingFeeUsd:e.listing_fee_usd,status:e.status,createdAt:new Date(e.created_at),updatedAt:e.updated_at?new Date(e.updated_at):void 0,expiresAt:e.expires_at?new Date(e.expires_at):void 0,claimedAt:e.claimed_at?new Date(e.claimed_at):void 0,submittedAt:e.submitted_at?new Date(e.submitted_at):void 0,completedAt:e.completed_at?new Date(e.completed_at):void 0,creator:e.creator,assignedAgent:e.assigned_agent,requestCount:e.request_count,output:e.output,payment:e.payment}}async getBalances(){let e=await this.callApiWithAuth("/api/v2/agent/balances",{method:"GET"});if(!e.ok){let t=await e.json().catch(()=>({}));throw new l(t.error||`Failed to get balances: ${e.status}`)}return e.json()}async transfer(e,t,s="USDC"){let n=await this.callApiWithAuth("/api/v2/agent/transfer",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({to:e,amount:t,currency:s})});if(!n.ok){let a=await n.json().catch(()=>({}));throw new l(a.error||`Transfer failed: ${n.status}`)}return n.json()}async swap(e,t,s,n=100){let a=await this.callApiWithAuth("/api/v2/agent/swap",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({sell_token:e,buy_token:t,sell_amount:s,slippage_bps:n})});if(!a.ok){let r=await a.json().catch(()=>({}));throw new l(r.error||`Swap failed: ${a.status}`)}return a.json()}async bridge(e,t,s,n){let a=await this.callApiWithAuth("/api/v2/agent/bridge",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({token:e,amount:t,dest_chain:s,dest_address:n})});if(!a.ok){let r=await a.json().catch(()=>({}));throw new l(r.error||`Bridge failed: ${a.status}`)}return a.json()}async getBridgeStatus(e){let t=await this.callApiWithAuth(`/api/v2/agent/bridge/status?order_id=${encodeURIComponent(e)}`,{method:"GET"});if(!t.ok){let s=await t.json().catch(()=>({}));throw new l(s.error||`Bridge status check failed: ${t.status}`)}return t.json()}async fetchPaid(e,t){let s=await this.callApiWithAuth("/api/v2/agent/fetch",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({url:e,method:t?.method||"GET",headers:t?.headers,body:t?.body,max_payment_usd:t?.maxPaymentUsd})});if(!s.ok){let n=await s.json().catch(()=>({}));throw new l(n.error||`Fetch failed: ${s.status}`)}return s.json()}async callApiWithAuth(e,t={}){let s=`${this.baseUrl}${e}`,n={...t.headers};if(this.apiKey)n.Authorization=`Bearer ${this.apiKey}`;else {let a=await this.getSessionAuthHeaders();Object.assign(n,a);}return fetch(s,{...t,headers:n})}async callApi(e,t={}){let s=`${this.baseUrl}${e}`,n={...t.headers};if(this.sessionKey){let r=privateKeyToAccount(this.sessionKey.rawPrivateKey).address.toLowerCase(),i=Date.now(),o=`MixrPay:${i}:${r}`,c=await signMessage({message:o,privateKey:this.sessionKey.rawPrivateKey});n["X-Session-Auth"]=JSON.stringify({address:r,timestamp:i,signature:c});}return fetch(s,{...t,headers:n})}};export{G as AgentWallet,L as AuthenticationError,S as InsufficientBalanceError,_ as InvalidSessionKeyError,D as MerchantNotAllowedError,l as MixrPayError,N as NetworkError,A as PaymentFailedError,M as RateLimitError,re as SDK_VERSION,C as SessionExpiredError,$ as SessionKeyExpiredError,U as SessionLimitExceededError,P as SessionNotFoundError,I as SessionRevokedError,v as SpendingLimitExceededError,k as X402ProtocolError,Pe as deleteWalletKey,ge as getErrorMessage,Ue as getWalletStoragePath,q as hasWalletKey,ue as isMixrPayError,Te as loadWalletData,K as loadWalletKey,W as saveWalletKey};