@sardis/sdk 0.2.0

package/dist/cjs/integrations/vercel-ai.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSardisTools = void 0;
+const zod_1 = require("zod");
+/**
+ * Create Sardis tools for Vercel AI SDK integration.
+ *
+ * @example
+ * ```typescript
+ * import { generateText } from 'ai';
+ * import { SardisClient } from '@sardis/sdk';
+ * import { createSardisTools } from '@sardis/sdk/integrations/vercel-ai';
+ *
+ * const client = new SardisClient({ apiKey: 'your-api-key' });
+ * const tools = createSardisTools(client, {
+ *   walletId: 'wallet_123',
+ *   agentId: 'agent_456'
+ * });
+ *
+ * const result = await generateText({
+ *   model: yourModel,
+ *   tools,
+ *   prompt: 'Pay $50 to OpenAI for API credits'
+ * });
+ * ```
+ */
+const createSardisTools = (client, options = {}) => {
+    const sardis = client;
+    const defaultWalletId = options.walletId || process.env.SARDIS_WALLET_ID || '';
+    const defaultChain = options.chain || 'base_sepolia';
+    const defaultToken = options.token || 'USDC';
+    return {
+        /**
+         * Execute a secure payment using Sardis MPC wallet.
+         */
+        payVendor: {
+            description: 'Execute a secure payment using Sardis MPC wallet. Validates against spending policies before execution.',
+            parameters: zod_1.z.object({
+                amount: zod_1.z.number().describe('The amount to pay in USD (or token units).'),
+                vendor: zod_1.z.string().describe('The name of the merchant or service provider.'),
+                vendorAddress: zod_1.z.string().optional().describe('The wallet address of the vendor (0x...).'),
+                purpose: zod_1.z.string().optional().describe('The reason for the payment, used for policy validation.'),
+                walletId: zod_1.z.string().optional().describe('The wallet ID to pay from. Defaults to configured wallet.'),
+                token: zod_1.z.enum(['USDC', 'USDT', 'PYUSD', 'EURC']).optional().describe('The stablecoin to use. Defaults to USDC.'),
+                chain: zod_1.z.string().optional().describe('The chain to use (e.g. base_sepolia). Defaults to configured chain.'),
+                domain: zod_1.z.string().optional().describe('Policy context label (e.g. aws.amazon.com). Defaults to vendor.'),
+            }),
+            execute: async ({ amount, vendor, vendorAddress, purpose, walletId, token, chain, domain, }) => {
+                if (!sardis) {
+                    return {
+                        success: false,
+                        error: "SardisClient not initialized. Please provide a client instance."
+                    };
+                }
+                const effectiveWalletId = walletId || defaultWalletId;
+                if (!effectiveWalletId) {
+                    return {
+                        success: false,
+                        error: "No wallet ID provided. Set walletId in options or SARDIS_WALLET_ID env var."
+                    };
+                }
+                try {
+                    const effectiveToken = token || defaultToken;
+                    const effectiveChain = chain || defaultChain;
+                    const effectiveDomain = domain || vendor;
+                    if (!vendorAddress) {
+                        return {
+                            success: false,
+                            error: "Missing vendorAddress (destination). Provide a wallet address (0x...) for the vendor."
+                        };
+                    }
+                    const result = await sardis.wallets.transfer(effectiveWalletId, {
+                        destination: vendorAddress,
+                        amount: amount.toString(),
+                        token: effectiveToken,
+                        chain: effectiveChain,
+                        domain: effectiveDomain,
+                        memo: purpose,
+                    });
+                    return {
+                        success: true,
+                        status: result.status,
+                        transactionHash: result.tx_hash,
+                        chain: result.chain,
+                        auditAnchor: result.audit_anchor,
+                        message: `Payment of $${amount} ${effectiveToken} to ${vendor} ${result.status === 'completed' ? 'completed' : 'initiated'} successfully.`
+                    };
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : 'Payment failed';
+                    // Check if this is a policy violation
+                    if (errorMessage.includes('policy') || errorMessage.includes('blocked') || errorMessage.includes('limit')) {
+                        return {
+                            success: false,
+                            blocked: true,
+                            error: errorMessage,
+                            message: `Payment to ${vendor} was blocked by spending policy: ${errorMessage}`
+                        };
+                    }
+                    return {
+                        success: false,
+                        error: errorMessage
+                    };
+                }
+            },
+        },
+        /**
+         * Check wallet balance before making a payment.
+         */
+        checkBalance: {
+            description: 'Check the current balance of a Sardis wallet.',
+            parameters: zod_1.z.object({
+                walletId: zod_1.z.string().optional().describe('The wallet ID to check. Defaults to configured wallet.'),
+                token: zod_1.z.enum(['USDC', 'USDT', 'PYUSD', 'EURC']).optional().describe('The token to check balance for.'),
+                chain: zod_1.z.string().optional().describe('The chain to check balance on.'),
+            }),
+            execute: async ({ walletId, token, chain }) => {
+                if (!sardis) {
+                    return {
+                        success: false,
+                        error: "SardisClient not initialized"
+                    };
+                }
+                const effectiveWalletId = walletId || defaultWalletId;
+                if (!effectiveWalletId) {
+                    return {
+                        success: false,
+                        error: "No wallet ID provided"
+                    };
+                }
+                try {
+                    const balance = await sardis.wallets.getBalance(effectiveWalletId, chain || defaultChain, token || defaultToken);
+                    return {
+                        success: true,
+                        walletId: balance.wallet_id,
+                        balance: balance.balance,
+                        token: balance.token,
+                        chain: balance.chain,
+                        address: balance.address
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to get balance'
+                    };
+                }
+            },
+        },
+        /**
+         * Get wallet information.
+         */
+        getWallet: {
+            description: 'Get information about a Sardis wallet including spending limits.',
+            parameters: zod_1.z.object({
+                walletId: zod_1.z.string().optional().describe('The wallet ID to get info for. Defaults to configured wallet.'),
+            }),
+            execute: async ({ walletId }) => {
+                if (!sardis) {
+                    return {
+                        success: false,
+                        error: "SardisClient not initialized"
+                    };
+                }
+                const effectiveWalletId = walletId || defaultWalletId;
+                if (!effectiveWalletId) {
+                    return {
+                        success: false,
+                        error: "No wallet ID provided"
+                    };
+                }
+                try {
+                    const wallet = await sardis.wallets.get(effectiveWalletId);
+                    return {
+                        success: true,
+                        wallet: {
+                            id: wallet.id,
+                            agentId: wallet.agent_id,
+                            currency: wallet.currency,
+                            limitPerTx: wallet.limit_per_tx,
+                            limitTotal: wallet.limit_total,
+                            isActive: wallet.is_active,
+                            addresses: wallet.addresses
+                        }
+                    };
+                }
+                catch (error) {
+                    return {
+                        success: false,
+                        error: error instanceof Error ? error.message : 'Failed to get wallet'
+                    };
+                }
+            },
+        },
+    };
+};
+exports.createSardisTools = createSardisTools;
+//# sourceMappingURL=vercel-ai.js.map

package/dist/cjs/integrations/vercel-ai.js.map

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

package/dist/cjs/resources/a2a.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * A2A (Agent-to-Agent) resource
+ *
+ * Provides inter-agent communication capabilities:
+ * - Discover other agents via agent cards
+ * - Send payment requests
+ * - Verify credentials
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2AResource = void 0;
+const base_js_1 = require("./base.js");
+// ============ Resource ============
+class A2AResource extends base_js_1.BaseResource {
+    /**
+     * Discover an agent by URL
+     *
+     * Fetches the agent card from /.well-known/agent-card.json
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.a2a.discoverAgent('https://agent.example.com');
+     * console.log(agent.card?.capabilities);
+     * ```
+     */
+    async discoverAgent(agentUrl, forceRefresh) {
+        return this._post('/api/v2/a2a/discover', {
+            agent_url: agentUrl,
+            force_refresh: forceRefresh,
+        });
+    }
+    /**
+     * Get our own agent card
+     *
+     * @example
+     * ```typescript
+     * const myCard = await client.a2a.getAgentCard();
+     * console.log(myCard.capabilities);
+     * ```
+     */
+    async getAgentCard() {
+        return this._get('/api/v2/a2a/agent-card');
+    }
+    /**
+     * List all discovered agents
+     *
+     * @example
+     * ```typescript
+     * const agents = await client.a2a.listAgents({
+     *   capability: 'payment.execute',
+     *   available_only: true,
+     * });
+     * ```
+     */
+    async listAgents(options) {
+        const response = await this._get('/api/v2/a2a/agents', options);
+        if (Array.isArray(response)) {
+            return response;
+        }
+        return response.agents || [];
+    }
+    /**
+     * Send a payment request to another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.sendPaymentRequest({
+     *   recipient_agent_url: 'https://merchant.example.com',
+     *   amount_minor: 5000,
+     *   token: 'USDC',
+     *   chain: 'base',
+     *   destination: '0x...',
+     *   purpose: 'Order #12345',
+     * });
+     *
+     * if (response.success) {
+     *   console.log('Payment tx:', response.tx_hash);
+     * }
+     * ```
+     */
+    async sendPaymentRequest(input) {
+        return this._post('/api/v2/a2a/payment-request', input);
+    }
+    /**
+     * Request credential verification from another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.verifyCredential({
+     *   recipient_agent_url: 'https://verifier.example.com',
+     *   credential_type: 'mandate',
+     *   credential_data: mandate,
+     * });
+     *
+     * if (response.valid) {
+     *   console.log('Credential verified!');
+     * }
+     * ```
+     */
+    async verifyCredential(input) {
+        return this._post('/api/v2/a2a/verify-credential', input);
+    }
+    /**
+     * Send a raw A2A message to another agent
+     *
+     * @example
+     * ```typescript
+     * const response = await client.a2a.sendMessage(
+     *   'https://agent.example.com',
+     *   {
+     *     message_type: 'custom',
+     *     payload: { action: 'notify', data: {...} },
+     *   }
+     * );
+     * ```
+     */
+    async sendMessage(recipientUrl, message) {
+        return this._post('/api/v2/a2a/messages', {
+            recipient_url: recipientUrl,
+            ...message,
+        });
+    }
+    /**
+     * List recent A2A messages
+     *
+     * @example
+     * ```typescript
+     * const messages = await client.a2a.listMessages({
+     *   direction: 'inbound',
+     *   message_type: 'payment_request',
+     * });
+     * ```
+     */
+    async listMessages(options) {
+        const response = await this._get('/api/v2/a2a/messages', options);
+        if (Array.isArray(response)) {
+            return response;
+        }
+        return response.messages || [];
+    }
+    /**
+     * Register an agent for discovery
+     *
+     * @example
+     * ```typescript
+     * await client.a2a.registerAgent({
+     *   agent_id: 'my_agent',
+     *   agent_name: 'My Agent',
+     *   agent_url: 'https://my-agent.example.com',
+     * });
+     * ```
+     */
+    async registerAgent(input) {
+        return this._post('/api/v2/a2a/agents/register', input);
+    }
+}
+exports.A2AResource = A2AResource;
+//# sourceMappingURL=a2a.js.map

package/dist/cjs/resources/a2a.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.js","sourceRoot":"","sources":["../../../src/resources/a2a.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,uCAAyC;AAiIzC,qCAAqC;AAErC,MAAa,WAAY,SAAQ,sBAAY;IAC3C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,YAAsB;QAC1D,OAAO,IAAI,CAAC,KAAK,CAAkB,sBAAsB,EAAE;YACzD,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,YAAY;SAC5B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY;QAChB,OAAO,IAAI,CAAC,IAAI,CAAY,wBAAwB,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,UAAU,CAAC,OAKhB;QACC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAC9B,oBAAoB,EACpB,OAAO,CACR,CAAC;QAEF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,KAAK,CAAC,kBAAkB,CAAC,KAA0B;QACjD,OAAO,IAAI,CAAC,KAAK,CAAkB,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,gBAAgB,CAAC,KAA4B;QACjD,OAAO,IAAI,CAAC,KAAK,CAAqB,+BAA+B,EAAE,KAAK,CAAC,CAAC;IAChF,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,WAAW,CACf,YAAoB,EACpB,OAA4B;QAE5B,OAAO,IAAI,CAAC,KAAK,CAAa,sBAAsB,EAAE;YACpD,aAAa,EAAE,YAAY;YAC3B,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAAC,OAMlB;QACC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAC9B,sBAAsB,EACtB,OAAO,CACR,CAAC;QAEF,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,aAAa,CAAC,KAKnB;QACC,OAAO,IAAI,CAAC,KAAK,CAAkB,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;CACF;AAhLD,kCAgLC"}

package/dist/cjs/resources/agents.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Agents resource
+ *
+ * Agents are the core identity entities in Sardis. They can:
+ * - Own wallets
+ * - Issue mandates
+ * - Be subject to spending policies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentsResource = void 0;
+const base_js_1 = require("./base.js");
+class AgentsResource extends base_js_1.BaseResource {
+    _normalize(agent) {
+        // Provide backwards-compatible alias: id := agent_id
+        if (!agent.id) {
+            agent.id = agent.agent_id;
+        }
+        return agent;
+    }
+    /**
+     * Create a new agent
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.agents.create({
+     *   name: 'Shopping Agent',
+     *   description: 'Agent for e-commerce purchases',
+     *   spending_limits: {
+     *     per_transaction: '100.00',
+     *     daily: '500.00',
+     *   },
+     * });
+     * ```
+     */
+    async create(input, options) {
+        const agent = await this._post('/api/v2/agents', input, options);
+        return this._normalize(agent);
+    }
+    /**
+     * Get an agent by ID
+     *
+     * @example
+     * ```typescript
+     * const agent = await client.agents.get('agent_abc123');
+     * console.log(agent.name, agent.is_active);
+     * ```
+     */
+    async get(agentId, options) {
+        const agent = await this._get(`/api/v2/agents/${agentId}`, undefined, options);
+        return this._normalize(agent);
+    }
+    /**
+     * List all agents
+     *
+     * @example
+     * ```typescript
+     * // List all agents
+     * const agents = await client.agents.list();
+     *
+     * // List with pagination
+     * const page = await client.agents.list({ limit: 10, offset: 20 });
+     *
+     * // List only active agents
+     * const active = await client.agents.list({ is_active: true });
+     * ```
+     */
+    async list(options) {
+        const params = {};
+        if (options?.limit !== undefined) {
+            params.limit = options.limit;
+        }
+        if (options?.offset !== undefined) {
+            params.offset = options.offset;
+        }
+        if (options?.is_active !== undefined) {
+            params.is_active = options.is_active;
+        }
+        const response = await this._get('/api/v2/agents', Object.keys(params).length > 0 ? params : undefined);
+        // Handle both array and object response formats
+        if (Array.isArray(response)) {
+            return response.map((a) => this._normalize(a));
+        }
+        return (response.agents || []).map((a) => this._normalize(a));
+    }
+    /**
+     * Update an agent
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.agents.update('agent_abc123', {
+     *   name: 'Updated Name',
+     *   is_active: false,
+     * });
+     * ```
+     */
+    async update(agentId, input) {
+        const agent = await this._patch(`/api/v2/agents/${agentId}`, input);
+        return this._normalize(agent);
+    }
+    /**
+     * Delete an agent
+     *
+     * Note: This is a soft delete - the agent is deactivated, not removed.
+     *
+     * @example
+     * ```typescript
+     * await client.agents.delete('agent_abc123');
+     * ```
+     */
+    async delete(agentId) {
+        await this._delete(`/api/v2/agents/${agentId}`);
+    }
+    /**
+     * Get an agent's associated wallet
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.agents.getWallet('agent_abc123');
+     * console.log(wallet.addresses);
+     * ```
+     */
+    async getWallet(agentId) {
+        return this._get(`/api/v2/agents/${agentId}/wallet`);
+    }
+    /**
+     * Create a wallet for an agent
+     *
+     * @example
+     * ```typescript
+     * const wallet = await client.agents.createWallet('agent_abc123', {
+     *   currency: 'USDC',
+     *   limit_per_tx: '100.00',
+     * });
+     * ```
+     */
+    async createWallet(agentId, options) {
+        return this._post(`/api/v2/agents/${agentId}/wallet`, options || {});
+    }
+}
+exports.AgentsResource = AgentsResource;
+//# sourceMappingURL=agents.js.map

package/dist/cjs/resources/agents.js.map

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

package/dist/cjs/resources/base.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Base resource class for all API resources.
+ *
+ * Provides common HTTP methods with support for:
+ * - Request options (params, data, signal, timeout)
+ * - Request cancellation via AbortController
+ * - Consistent error handling
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseResource = void 0;
+/**
+ * Abstract base class for API resources.
+ *
+ * All resource classes extend this class to gain access to
+ * HTTP methods that integrate with the SardisClient.
+ *
+ * @example
+ * ```typescript
+ * class MyResource extends BaseResource {
+ *   async getItem(id: string, options?: RequestOptions) {
+ *     return this._get<Item>(`/api/v2/items/${id}`, undefined, options);
+ *   }
+ * }
+ * ```
+ */
+class BaseResource {
+    /**
+     * Creates a new BaseResource instance.
+     *
+     * @param client - The SardisClient instance
+     */
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Performs a GET request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param params - Query parameters
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._get<Item[]>('/api/v2/items', { limit: 10 });
+     * ```
+     */
+    async _get(path, params, options) {
+        return this.client.request('GET', path, { ...options, params: params ?? options?.params });
+    }
+    /**
+     * Performs a POST request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._post<Item>('/api/v2/items', { name: 'New Item' });
+     * ```
+     */
+    async _post(path, data, options) {
+        return this.client.request('POST', path, { ...options, data: data ?? options?.data });
+    }
+    /**
+     * Performs a PATCH request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body with partial updates
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._patch<Item>('/api/v2/items/123', { name: 'Updated' });
+     * ```
+     */
+    async _patch(path, data, options) {
+        return this.client.request('PATCH', path, { ...options, data: data ?? options?.data });
+    }
+    /**
+     * Performs a PUT request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param data - Request body
+     * @param options - Request options (signal, timeout)
+     * @returns The response data
+     *
+     * @example
+     * ```typescript
+     * const result = await this._put<Item>('/api/v2/items/123', { name: 'Replaced' });
+     * ```
+     */
+    async _put(path, data, options) {
+        return this.client.request('PUT', path, { ...options, data: data ?? options?.data });
+    }
+    /**
+     * Performs a DELETE request.
+     *
+     * @typeParam T - The expected response type
+     * @param path - API path
+     * @param options - Request options (signal, timeout)
+     * @returns The response data (if any)
+     *
+     * @example
+     * ```typescript
+     * await this._delete('/api/v2/items/123');
+     * ```
+     */
+    async _delete(path, options) {
+        return this.client.request('DELETE', path, options);
+    }
+}
+exports.BaseResource = BaseResource;
+//# sourceMappingURL=base.js.map

package/dist/cjs/resources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/resources/base.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAKH;;;;;;;;;;;;;;GAcG;AACH,MAAsB,YAAY;IAOhC;;;;OAIG;IACH,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,IAAI,CAClB,IAAY,EACZ,MAAgC,EAChC,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,KAAK,CACnB,IAAY,EACZ,IAAc,EACd,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,MAAM,CACpB,IAAY,EACZ,IAAc,EACd,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;;;;OAaG;IACO,KAAK,CAAC,IAAI,CAClB,IAAY,EACZ,IAAc,EACd,OAAwB;QAExB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,OAAwB;QAC/D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAI,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;CACF;AAxHD,oCAwHC"}