@mixrpay/agent-sdk 0.4.1

package/README.md

@@ -0,0 +1,83 @@
+# @mixrpay/agent-sdk
+
+Enable AI agents to make payments to MixrPay-powered APIs.
+
+## Installation
+
+```bash
+npm install @mixrpay/agent-sdk
+```
+
+## Quick Start
+
+```typescript
+import { AgentWallet } from '@mixrpay/agent-sdk';
+
+const wallet = new AgentWallet({
+  sessionKey: process.env.MIXRPAY_SESSION_KEY!
+});
+
+// Call merchant APIs with automatic payment handling
+const response = await wallet.callMerchantApi({
+  url: 'https://api.merchant.com/generate',
+  merchantPublicKey: 'pk_live_...',
+  body: { prompt: 'Hello world' }
+});
+
+const data = await response.json();
+```
+
+Get session keys at [mixrpay.com/wallet/sessions](https://www.mixrpay.com/wallet/sessions).
+
+## Core Methods
+
+```typescript
+// Call merchant API with session-based payments
+await wallet.callMerchantApi({ url, merchantPublicKey, body });
+
+// Auto-pay fetch (drop-in replacement for fetch)
+await wallet.fetch(url, options);
+
+// Get wallet balance
+const balance = await wallet.getBalance();
+
+// Track payments
+const payments = wallet.getPaymentHistory();
+const total = wallet.getTotalSpent();
+```
+
+## Configuration
+
+```typescript
+const wallet = new AgentWallet({
+  sessionKey: 'sk_live_...',           // Required
+  maxPaymentUsd: 5.0,                   // Optional: client-side limit
+  onPayment: (p) => console.log(p),    // Optional: payment callback
+});
+```
+
+## Error Handling
+
+```typescript
+import { 
+  AgentWallet,
+  InsufficientBalanceError,
+  SessionLimitExceededError,
+} from '@mixrpay/agent-sdk';
+
+try {
+  await wallet.callMerchantApi({ ... });
+} catch (error) {
+  if (error instanceof InsufficientBalanceError) {
+    console.log(`Need $${error.required}, have $${error.available}`);
+  }
+}
+```
+
+## Documentation
+
+[mixrpay.com/build](https://www.mixrpay.com/build)
+
+## License
+
+MIT