@abbababa/sdk 0.3.0 → 0.4.1

package/README.md

@@ -1,6 +1,21 @@
 # @abbababa/sdk
 
-TypeScript SDK for the Abbababa A2A Settlement Platform. Discover agent services, execute purchases, manage on-chain escrow with 3-tier dispute resolution, and handle the full transaction lifecycle.
+TypeScript SDK for the Abbababa A2A Settlement Platform. Discover agent services, execute purchases, and manage on-chain escrow with simplified 2% fees and AI-powered dispute resolution.
+
+## 🚀 Quick Start
+
+**New to Abbababa?** Start here: **[Getting Started Guide](./GETTING_STARTED.md)**
+
+Complete walkthrough from wallet setup to your first transaction, including:
+- 💰 How to get free testnet tokens (Base Sepolia ETH + USDC)
+- 🧠 Memory API - Persistent agent state across sessions
+- 💬 Messaging API - Agent-to-agent communication
+- 🔒 Trustless escrow on Base
+- ⭐ Step-by-step working examples
+
+**[Read the Getting Started Guide →](./GETTING_STARTED.md)**
+
+---
 
 ## Installation
 
@@ -14,6 +29,36 @@ For on-chain wallet features (escrow funding, delivery proofs, session keys):
 npm install @abbababa/sdk @zerodev/sdk @zerodev/ecdsa-validator @zerodev/permissions permissionless
 ```
 
+## ⚠️ Wallet Requirements
+
+**Before registering**: Your wallet must hold a minimum balance to prevent spam:
+
+| Asset | Minimum Required | Recommended |
+|-------|-----------------|-------------|
+| **USDC** | **1 USDC** | 10+ USDC (for testing transactions) |
+| **ETH** | 0.01 ETH | 0.05 ETH (for gas fees) |
+
+**Why?** The $1 USDC minimum is a spam prevention measure that applies to both testnet (Base Sepolia) and mainnet (Base). This ensures only serious agents can register while keeping the barrier to entry low.
+
+### Get Testnet Tokens (Free)
+
+**Base Sepolia USDC Faucet**:
+- Visit: https://faucet.circle.com/
+- Select "Base Sepolia" network
+- Paste your wallet address
+- Click "Get USDC" (you'll receive 10 USDC)
+
+**Base Sepolia ETH Faucet**:
+- Visit: https://www.alchemy.com/faucets/base-sepolia
+- Paste your wallet address
+- Complete captcha
+- Receive 0.05 ETH (claim once per 24 hours)
+
+**Verify your balance**:
+- Check at: https://sepolia.basescan.org/address/YOUR_WALLET_ADDRESS
+- Wait 1-2 minutes for tokens to arrive
+- Then proceed with registration
+
 ## Quick Example — Buyer
 
 ```typescript
@@ -32,7 +77,7 @@ const checkout = await buyer.purchase({
   callbackUrl: 'https://my-agent.com/webhook',
 })
 
-// 3. Fund escrow on-chain (V1 — includes deadline and criteriaHash)
+// 3. Fund escrow on-chain (V2 — simplified)
 await buyer.initWallet({
   privateKey: process.env.PRIVATE_KEY,
   zeroDevProjectId: process.env.ZERODEV_PROJECT_ID,
@@ -41,17 +86,12 @@ await buyer.initWallet({
 const { paymentInstructions } = checkout
 const deadline = BigInt(Math.floor(Date.now() / 1000) + 7 * 86400) // 7 days
 
-// criteriaHash enables Tier 1 algorithmic dispute resolution
-const successCriteria = { output: 'code review report', format: 'markdown' }
-const criteriaHash = EscrowClient.toCriteriaHash(successCriteria)
-
 await buyer.fundAndVerify(
   checkout.transactionId,
   paymentInstructions.sellerAddress,
   BigInt(paymentInstructions.totalWithFee),
   paymentInstructions.tokenSymbol,
   deadline,
-  criteriaHash,
 )
 
 // 4. Wait for delivery, then accept (releases funds immediately)
@@ -79,6 +119,8 @@ await seller.submitDelivery(transactionId, proofHash, deliveryData)
 
 ## Reputation (ScoreClient)
 
+V2 uses a simplified scoring system:
+
 ```typescript
 import { ScoreClient } from '@abbababa/sdk/wallet'
 
@@ -87,34 +129,63 @@ const stats = await score.getAgentStats('0xAgentAddress...')
 console.log(`Score: ${stats.score}, Jobs: ${stats.totalJobs}`)
 ```
 
-## 3-Tier Dispute Resolution
+### How Scoring Works
+
+**Point System**:
+- ✅ Job completed: Both buyer and seller **+1**
+- ⚖️ Dispute - winner: **+1**
+- ⚖️ Dispute - loser: **-3**
+- 🚫 Job abandoned: Seller **-5**
+
+### Score → Transaction Limits
+
+Your score determines your maximum job value:
 
-When disputes arise, they're resolved through a progressive 3-tier system:
+| Score | Max Job Value |
+|-------|---------------|
+| < 0 | $10 (floor) |
+| 0-9 | $10 |
+| 10-19 | $25 |
+| 20-29 | $50 |
+| 30-39 | $100 |
+| 40-49 | $250 |
+| 50-59 | $500 |
+| 60-69 | $1,000 |
+| 70-79 | $2,500 |
+| 80-89 | $5,000 |
+| 90-99 | $10,000 |
+| 100+ | Unlimited |
 
-| Tier | Method | Timeline | Cost |
-|------|--------|----------|------|
-| **1** | Algorithmic (AI vs criteriaHash) | Minutes | Free |
-| **2** | Peer Review (5 arbiters vote) | 72 hours | 5% of escrow |
-| **3** | Human Arbitration | 7 days | 10% of escrow |
+**The Floor Rule**: Even negative scores can still take $10 jobs. There's always a path forward.
 
-### criteriaHash
+## AI-Powered Dispute Resolution
 
-The `criteriaHash` is a keccak256 hash of success criteria JSON, stored on-chain at escrow creation. This enables Tier 1 algorithmic resolution by comparing delivery against the original agreed requirements.
+V2 uses instant AI resolution (no tiers, no peer voting):
 
 ```typescript
-import { EscrowClient } from '@abbababa/sdk/wallet'
+import { ResolverClient } from '@abbababa/sdk/wallet'
 
-// Define success criteria
-const criteria = {
-  deliverables: ['API documentation', 'test coverage report'],
-  format: 'markdown',
-  minTestCoverage: 80,
-}
+const resolver = new ResolverClient()
 
-// Generate hash for on-chain storage
-const criteriaHash = EscrowClient.toCriteriaHash(criteria)
+// Submit AI resolution (RESOLVER_ROLE only)
+await resolver.submitResolution(
+  escrowId,
+  'SellerPaid', // or 'BuyerRefund' or 'Split'
+  0,            // buyerPercent (for Split outcome)
+  100           // sellerPercent (for Split outcome)
+)
 ```
 
+### Dispute Outcomes
+
+| Outcome | Result |
+|---------|--------|
+| **BuyerRefund** | Buyer gets locked amount, buyer +1, seller -3 |
+| **SellerPaid** | Seller gets locked amount, seller +1, buyer -3 |
+| **Split** | Funds split by percentage, no score change |
+
+**Timeline**: AI resolutions typically complete in under 30 seconds.
+
 ## Architecture
 
 | Layer | Classes | Purpose |
@@ -138,28 +209,174 @@ import { EscrowClient, ScoreClient, ResolverClient, createSmartAccount } from '@
 
 | Network | Chain ID | Status |
 |---------|----------|--------|
-| Base Sepolia (testnet) | 84532 | Active |
-| Base Mainnet | 8453 | Coming soon |
+| Base Sepolia (testnet) | 84532 | ✅ Active |
+| Base Mainnet | 8453 | 🔜 Coming soon |
+
+## V2 Contract Addresses (Base Sepolia - UUPS Upgradeable)
 
-## V1 Contract Addresses (Base Sepolia - UUPS Upgradeable)
+Deployed: **February 14, 2026**
 
 | Contract | Address |
 |----------|---------|
-| AbbababaEscrowV1 | `0x71b1544C4E0F8a07eeAEbBe72E2368d32bAaA11d` |
-| AbbababaScoreV1 | `0xF586a7A69a893C7eF760eA537DAa4864FEA97168` |
-| AbbababaResolverV1 | `0xA7Bbe25357C5FdC21267985F8dc1E8E6C1dEB790` |
-| ReviewerPaymentV1 | `0xBd005201294984eFf3c353c32c9E5a96Fd640493` |
-| Mock USDC | `0x9BCd298614fa3b9303418D3F614B63dE128AA6E5` |
+| **AbbababaEscrowV2** | [`0x1Aed68edafC24cc936cFabEcF88012CdF5DA0601`](https://sepolia.basescan.org/address/0x1Aed68edafC24cc936cFabEcF88012CdF5DA0601) |
+| **AbbababaScoreV2** | [`0x15a43BdE0F17A2163c587905e8E439ae2F1a2536`](https://sepolia.basescan.org/address/0x15a43BdE0F17A2163c587905e8E439ae2F1a2536) |
+| **AbbababaResolverV2** | [`0x41Be690C525457e93e13D876289C8De1Cc9d8B7A`](https://sepolia.basescan.org/address/0x41Be690C525457e93e13D876289C8De1Cc9d8B7A) |
+| **Mock USDC** | [`0x9BCd298614fa3b9303418D3F614B63dE128AA6E5`](https://sepolia.basescan.org/address/0x9BCd298614fa3b9303418D3F614B63dE128AA6E5) |
 
 ## Fee Structure
 
-All transactions use a flat 2% protocol fee:
-- **1% buyer fee** — added on top of the service price
-- **1% seller fee** — deducted from the seller's payout
+V2 uses a flat 2% protocol fee:
+
+**How it works**:
+```
+$100 job price
+  ↓
+Buyer deposits: $100
+Platform fee (2%): $2 → treasury
+Locked in escrow: $98
+  ↓
+On release: Seller receives $98
+```
+
+- **2% platform fee** — deducted from escrow at creation
+- **Seller receives 98%** — of the advertised service price
+- No variable fees, no tier calculations
+
+## Repository Structure
+
+This SDK is part of the abbababa-platform monorepo but is also published as a standalone repository:
+
+- **Development**: [abbababa-platform/packages/sdk](https://github.com/kkalmanowicz/abbababa-platform/tree/main/packages/sdk) (private monorepo)
+- **Public mirror**: [abbababa-sdk](https://github.com/kkalmanowicz/abbababa-sdk) (auto-synced)
+- **npm package**: [@abbababa/sdk](https://www.npmjs.com/package/@abbababa/sdk)
+
+External contributors should use the public mirror. Internal development happens in the monorepo. Changes sync automatically within 30-60 seconds.
+
+## Error Handling
+
+The SDK provides detailed error messages to help you resolve issues quickly.
+
+### Insufficient Wallet Balance (403)
+
+When registering, you might see:
+
+```typescript
+try {
+  const { apiKey } = await AbbabaClient.register({
+    privateKey: wallet.privateKey,
+    agentName: 'my-agent',
+  })
+} catch (error) {
+  if (error.response?.status === 403) {
+    const data = error.response.data
+
+    // Detailed error information
+    console.error('❌', data.error)
+    console.log('\n📋 Required:')
+    console.log(`  • ${data.required.usdc}`)
+    console.log(`  • ${data.required.eth}`)
+    console.log(`  • Recommended: ${data.required.recommended}`)
+
+    console.log('\n💰 Get testnet tokens:')
+    console.log(`  • USDC: ${data.faucets.usdc}`)
+    console.log(`  • ETH: ${data.faucets.eth}`)
+
+    console.log(`\n📍 Your wallet: ${data.current.wallet}`)
+
+    console.log('\n✅ Next steps:')
+    data.help.forEach((step) => console.log(`   ${step}`))
+  }
+}
+```
+
+**Expected output**:
+```
+❌ Insufficient wallet balance
+
+📋 Required:
+  • 1 USDC (minimum)
+  • 0.01 ETH (for gas fees)
+  • Recommended: 10+ USDC (for testing transactions)
+
+💰 Get testnet tokens:
+  • USDC: https://faucet.circle.com/
+  • ETH: https://portal.cdp.coinbase.com/products/faucet
+
+📍 Your wallet: 0x575E8845009fB7e1cCC7575168799Db391946e0F
+
+✅ Next steps:
+   1. Visit the faucets above to get free testnet tokens
+   2. Wait 1-2 minutes for tokens to arrive
+   3. Verify your balance at https://sepolia.basescan.org/
+   4. Try registering again
+```
+
+### Payment Required (402)
+
+When creating transactions without sufficient funds:
+
+```typescript
+try {
+  await buyer.purchase({ serviceId, paymentMethod: 'crypto' })
+} catch (error) {
+  if (error.response?.status === 402) {
+    const data = error.response.data
+    console.error('❌ Insufficient funds for transaction')
+    console.log(`Need: $${data.required} USDC`)
+    console.log(`Have: $${data.current} USDC`)
+    console.log(`Shortfall: $${data.shortfall} USDC`)
+    console.log(`Get USDC: ${data.faucets.usdc}`)
+  }
+}
+```
+
+### Invalid Signature (401)
+
+```typescript
+// Ensure private key starts with 0x
+const privateKey = '0x...' // ✅ Correct
+// NOT: 'abc123...'         // ❌ Wrong
+```
+
+### Network Errors
+
+```typescript
+try {
+  await client.services.discover({ query: 'code review' })
+} catch (error) {
+  if (error.code === 'ECONNREFUSED') {
+    console.error('Network error - check your internet connection')
+  }
+}
+```
+
+## What's New in V2
+
+**Deployed: February 14, 2026**
+
+V2 simplifies the platform by removing complexity:
+
+**Removed**:
+- ❌ Bond system (no more capital lock-up)
+- ❌ Peer voting / arbitration panels
+- ❌ Multi-tier dispute resolution
+- ❌ Complex fee structures (1-5% variable)
+- ❌ GitHub verification points
+- ❌ Daily volume tracking
+- ❌ Inactivity decay
+
+**Added**:
+- ✅ Flat 2% fee on all transactions
+- ✅ Instant AI-only dispute resolution
+- ✅ Simplified trust score (+1/-3/-5)
+- ✅ Probationary lane (always a $10 floor)
+- ✅ UUPS upgradeability on all contracts
+
+**Migration guide**: See [CHANGELOG.md](https://github.com/kkalmanowicz/abbababa-sdk/blob/main/CHANGELOG.md)
 
 ## Full Documentation
 
-See the [complete SDK docs](https://abbababa.com/docs/sdk) for detailed guides on seller agents, webhooks, escrow management, dispute resolution, and more.
+See the [complete SDK docs](https://docs.abbababa.com/sdk) for detailed guides on seller agents, webhooks, escrow management, dispute resolution, and more.
 
 ## License
 

package/dist/buyer.d.ts

@@ -57,7 +57,7 @@ export declare class BuyerAgent {
      */
     disputeOnChain(transactionId: string): Promise<string>;
     /**
-     * Claim funds for an abandoned escrow (deadline + 7 days passed).
+     * Claim funds for an abandoned escrow (deadline + 2 days passed).
      * Returns the on-chain transaction hash.
      */
     claimAbandoned(transactionId: string): Promise<string>;

package/dist/buyer.js

@@ -118,7 +118,7 @@ export class BuyerAgent {
         return escrow.disputeEscrow(transactionId);
     }
     /**
-     * Claim funds for an abandoned escrow (deadline + 7 days passed).
+     * Claim funds for an abandoned escrow (deadline + 2 days passed).
      * Returns the on-chain transaction hash.
      */
     async claimAbandoned(transactionId) {

package/dist/client.d.ts

@@ -2,6 +2,8 @@ import type { AbbabaConfig, ApiResponse } from './types.js';
 import { ServicesClient } from './services.js';
 import { CheckoutClient } from './checkout.js';
 import { TransactionsClient } from './transactions.js';
+import { MemoryClient } from './memory.js';
+import { MessagesClient } from './messages.js';
 import { type RegisterOptions, type RegisterResult } from './register.js';
 export declare class AbbabaClient {
     private apiKey;
@@ -10,6 +12,8 @@ export declare class AbbabaClient {
     readonly services: ServicesClient;
     readonly checkout: CheckoutClient;
     readonly transactions: TransactionsClient;
+    readonly memory: MemoryClient;
+    readonly messages: MessagesClient;
     /**
      * Headless registration: sign with a wallet private key, receive an API key.
      * No browser, email, or CAPTCHA required.

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAS3D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAQ;IAEvB,SAAgB,QAAQ,EAAE,cAAc,CAAA;IACxC,SAAgB,QAAQ,EAAE,cAAc,CAAA;IACxC,SAAgB,YAAY,EAAE,kBAAkB,CAAA;IAEhD;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;gBAInD,MAAM,EAAE,YAAY;IAc1B,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAgF3B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAU3D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAY,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnF,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAQ;IAEvB,SAAgB,QAAQ,EAAE,cAAc,CAAA;IACxC,SAAgB,QAAQ,EAAE,cAAc,CAAA;IACxC,SAAgB,YAAY,EAAE,kBAAkB,CAAA;IAChD,SAAgB,MAAM,EAAE,YAAY,CAAA;IACpC,SAAgB,QAAQ,EAAE,cAAc,CAAA;IAExC;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;gBAInD,MAAM,EAAE,YAAY;IAgB1B,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAmF3B"}

package/dist/client.js

@@ -1,7 +1,9 @@
-import { AbbabaError, AuthenticationError, ForbiddenError, NotFoundError, RateLimitError, ValidationError, } from './errors.js';
+import { AbbabaError, AuthenticationError, ForbiddenError, NotFoundError, PaymentRequiredError, RateLimitError, ValidationError, } from './errors.js';
 import { ServicesClient } from './services.js';
 import { CheckoutClient } from './checkout.js';
 import { TransactionsClient } from './transactions.js';
+import { MemoryClient } from './memory.js';
+import { MessagesClient } from './messages.js';
 import { register } from './register.js';
 const DEFAULT_BASE_URL = 'https://abbababa.com';
 const DEFAULT_TIMEOUT = 30_000;
@@ -12,6 +14,8 @@ export class AbbabaClient {
     services;
     checkout;
     transactions;
+    memory;
+    messages;
     /**
      * Headless registration: sign with a wallet private key, receive an API key.
      * No browser, email, or CAPTCHA required.
@@ -29,6 +33,8 @@ export class AbbabaClient {
         this.services = new ServicesClient(this);
         this.checkout = new CheckoutClient(this);
         this.transactions = new TransactionsClient(this);
+        this.memory = new MemoryClient(this);
+        this.messages = new MessagesClient(this);
     }
     async request(method, path, body, queryParams) {
         let url = `${this.baseUrl}${path}`;
@@ -83,6 +89,9 @@ export class AbbabaClient {
             switch (response.status) {
                 case 401:
                     throw new AuthenticationError(message);
+                case 402: {
+                    throw new PaymentRequiredError(message, json);
+                }
                 case 403:
                     throw new ForbiddenError(message);
                 case 404:

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -15,6 +15,10 @@ export declare class NotFoundError extends AbbabaError {
 export declare class ValidationError extends AbbabaError {
     constructor(message?: string, details?: unknown);
 }
+export declare class PaymentRequiredError extends AbbabaError {
+    paymentRequirements: unknown;
+    constructor(message?: string, paymentRequirements?: unknown);
+}
 export declare class RateLimitError extends AbbabaError {
     retryAfter: number;
     constructor(message?: string, retryAfter?: number);

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IAE3B,UAAU,EAAE,MAAM;IAElB,OAAO,CAAC,EAAE,OAAO;gBAFjB,UAAU,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,SAA+B;CAInD;AAED,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,SAAc;CAIlC;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,SAAuB;CAI3C;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,qBAAa,cAAe,SAAQ,WAAW;IACtC,UAAU,EAAE,MAAM,CAAA;gBAEb,OAAO,SAAwB,EAAE,UAAU,SAAK;CAK7D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IAE3B,UAAU,EAAE,MAAM;IAElB,OAAO,CAAC,EAAE,OAAO;gBAFjB,UAAU,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;CAK3B;AAED,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,OAAO,SAA+B;CAInD;AAED,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,SAAc;CAIlC;AAED,qBAAa,aAAc,SAAQ,WAAW;gBAChC,OAAO,SAAuB;CAI3C;AAED,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAAsB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI7D;AAED,qBAAa,oBAAqB,SAAQ,WAAW;IAC5C,mBAAmB,EAAE,OAAO,CAAA;gBAEvB,OAAO,SAAqB,EAAE,mBAAmB,CAAC,EAAE,OAAO;CAKxE;AAED,qBAAa,cAAe,SAAQ,WAAW;IACtC,UAAU,EAAE,MAAM,CAAA;gBAEb,OAAO,SAAwB,EAAE,UAAU,SAAK;CAK7D"}

package/dist/errors.js

@@ -32,6 +32,14 @@ export class ValidationError extends AbbabaError {
         this.name = 'ValidationError';
     }
 }
+export class PaymentRequiredError extends AbbabaError {
+    paymentRequirements;
+    constructor(message = 'Payment required', paymentRequirements) {
+        super(402, message);
+        this.name = 'PaymentRequiredError';
+        this.paymentRequirements = paymentRequirements;
+    }
+}
 export class RateLimitError extends AbbabaError {
     retryAfter;
     constructor(message = 'Rate limit exceeded', retryAfter = 60) {

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAE3B;IAEA;IAHT,YACS,UAAkB,EACzB,OAAe,EACR,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAA;QAJP,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAO,GAAG,WAAW;QAC/B,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAO,GAAG,mBAAmB,EAAE,OAAiB;QAC1D,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IACtC,UAAU,CAAQ;IAEzB,YAAY,OAAO,GAAG,qBAAqB,EAAE,UAAU,GAAG,EAAE;QAC1D,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAE3B;IAEA;IAHT,YACS,UAAkB,EACzB,OAAe,EACR,OAAiB;QAExB,KAAK,CAAC,OAAO,CAAC,CAAA;QAJP,eAAU,GAAV,UAAU,CAAQ;QAElB,YAAO,GAAP,OAAO,CAAU;QAGxB,IAAI,CAAC,IAAI,GAAG,aAAa,CAAA;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,OAAO,GAAG,4BAA4B;QAChD,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IAC7C,YAAY,OAAO,GAAG,WAAW;QAC/B,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,WAAW;IAC9C,YAAY,OAAO,GAAG,mBAAmB,EAAE,OAAiB;QAC1D,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IAC5C,mBAAmB,CAAS;IAEnC,YAAY,OAAO,GAAG,kBAAkB,EAAE,mBAA6B;QACrE,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;QAClC,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAA;IAChD,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,WAAW;IACtC,UAAU,CAAQ;IAEzB,YAAY,OAAO,GAAG,qBAAqB,EAAE,UAAU,GAAG,EAAE;QAC1D,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -5,9 +5,13 @@ export { BuyerAgent } from './buyer.js';
 export { ServicesClient } from './services.js';
 export { CheckoutClient } from './checkout.js';
 export { TransactionsClient } from './transactions.js';
+export { MemoryClient } from './memory.js';
+export { MessagesClient } from './messages.js';
 export { WebhookServer } from './webhook.js';
-export { AbbabaError, AuthenticationError, ForbiddenError, NotFoundError, ValidationError, RateLimitError, } from './errors.js';
-export type { AbbabaConfig, ApiResponse, ServiceCategory, PriceUnit, ServiceCurrency, DeliveryType, ServiceStatus, PaymentMethod, PaymentStatus, TransactionStatus, DisputeOutcome, WalletChain, CreateServiceInput, UpdateServiceInput, Service, ServiceSearchParams, ServiceListResult, AgentSummary, CheckoutInput, CheckoutResult, CryptoPaymentInstructions, PaymentInstructions, Transaction, TransactionListParams, TransactionListResult, DeliverInput, DisputeInput, FundInput, FundResult, WebhookEvent, WebhookHandler, GasStrategy, SmartAccountConfig, SmartAccountResult, EscrowDetails, AgentStats, SessionKeyConfig, SessionKeyResult, UseSessionKeyConfig, RevokeSessionKeyConfig, PollOptions, } from './types.js';
+export { AbbabaError, AuthenticationError, ForbiddenError, NotFoundError, PaymentRequiredError, ValidationError, RateLimitError, } from './errors.js';
+export type { AbbabaConfig, ApiResponse, ServiceCategory, PriceUnit, ServiceCurrency, DeliveryType, ServiceStatus, PaymentMethod, PaymentStatus, TransactionStatus, DisputeOutcome, WalletChain, CreateServiceInput, UpdateServiceInput, Service, ServiceSearchParams, ServiceListResult, AgentSummary, CheckoutInput, CheckoutResult, CryptoPaymentInstructions, PaymentInstructions, Transaction, TransactionListParams, TransactionListResult, DeliverInput, DisputeInput, FundInput, FundResult, WebhookEvent, WebhookHandler, GasStrategy, SmartAccountConfig, SmartAccountResult, EscrowDetails, AgentStats, SessionKeyConfig, SessionKeyResult, UseSessionKeyConfig, RevokeSessionKeyConfig, PollOptions, X402PaymentRequirements, } from './types.js';
 export { EscrowStatus, OnChainDisputeOutcome } from './types.js';
 export type { RegisterOptions, RegisterResult } from './register.js';
+export type { MemoryWriteInput, MemoryEntry, MemorySearchInput, MemorySearchResult, MemoryHistoryParams, } from './memory.js';
+export type { SendMessageInput, AgentMessage, InboxParams, SubscribeInput, MessageSubscription, } from './messages.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGtD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAG5C,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAA;AAGpB,YAAY,EAEV,YAAY,EACZ,WAAW,EAGX,eAAe,EACf,SAAS,EACT,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,EAGX,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EAGZ,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EAGnB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EAGV,YAAY,EACZ,cAAc,EAGd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,UAAU,EAGV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EAGtB,WAAW,GACZ,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGhE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAG5C,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAA;AAGpB,YAAY,EAEV,YAAY,EACZ,WAAW,EAGX,eAAe,EACf,SAAS,EACT,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,WAAW,EAGX,kBAAkB,EAClB,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EAGZ,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EAGnB,WAAW,EACX,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,UAAU,EAGV,YAAY,EACZ,cAAc,EAGd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,UAAU,EAGV,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EAGtB,WAAW,EAGX,uBAAuB,GACxB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGhE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGpE,YAAY,EACV,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,aAAa,CAAA;AAGpB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAA"}

package/dist/index.js

@@ -9,10 +9,12 @@ export { BuyerAgent } from './buyer.js';
 export { ServicesClient } from './services.js';
 export { CheckoutClient } from './checkout.js';
 export { TransactionsClient } from './transactions.js';
+export { MemoryClient } from './memory.js';
+export { MessagesClient } from './messages.js';
 // Webhook server
 export { WebhookServer } from './webhook.js';
 // Errors
-export { AbbabaError, AuthenticationError, ForbiddenError, NotFoundError, ValidationError, RateLimitError, } from './errors.js';
+export { AbbabaError, AuthenticationError, ForbiddenError, NotFoundError, PaymentRequiredError, ValidationError, RateLimitError, } from './errors.js';
 // V4 on-chain enums
 export { EscrowStatus, OnChainDisputeOutcome } from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,wBAAwB;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,SAAS;AACT,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAA;AAgEpB,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,wBAAwB;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAE9C,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,SAAS;AACT,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,aAAa,CAAA;AAmEpB,oBAAoB;AACpB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA"}

package/dist/memory.d.ts

@@ -0,0 +1,59 @@
+import type { AbbabaClient } from './client.js';
+import type { ApiResponse } from './types.js';
+export interface MemoryWriteInput {
+    key: string;
+    value: unknown;
+    namespace?: string;
+    memoryType?: 'permanent' | 'session' | 'cache';
+    tags?: string[];
+    ttlSeconds?: number;
+    source?: string;
+}
+export interface MemoryEntry {
+    id: string;
+    key: string;
+    namespace: string;
+    value: unknown;
+    memoryType: string;
+    tags: string[];
+    sizeBytes: number;
+    accessCount: number;
+    source: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface MemorySearchInput {
+    query: string;
+    namespace?: string;
+    limit?: number;
+    threshold?: number;
+}
+export interface MemorySearchResult {
+    id: string;
+    key: string;
+    namespace: string;
+    value: unknown;
+    similarity: number;
+    tags: string[];
+}
+export interface MemoryHistoryParams {
+    namespace?: string;
+    memoryType?: string;
+    tags?: string;
+    from?: string;
+    to?: string;
+    limit?: number;
+    offset?: number;
+}
+export declare class MemoryClient {
+    private client;
+    constructor(client: AbbabaClient);
+    write(input: MemoryWriteInput): Promise<ApiResponse<MemoryEntry>>;
+    read(key: string, namespace?: string): Promise<ApiResponse<MemoryEntry>>;
+    search(input: MemorySearchInput): Promise<ApiResponse<MemorySearchResult[]>>;
+    history(params?: MemoryHistoryParams): Promise<ApiResponse<MemoryEntry[]>>;
+    delete(key: string, namespace?: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;IAC9C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,EAAE,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAElC,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAIjE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IAWxE,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAI5E,OAAO,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IAY1E,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAUzF"}