@ampersend_ai/ampersend-sdk 0.0.19 → 0.0.22

package/dist/ampersend/marketplace.js

@@ -0,0 +1,91 @@
+import { Schema } from "effect";
+import { AgentMarketplaceListQueryParams, CuratedAgentDTO } from "./curated-agent.js";
+import { ApiError } from "./types.js";
+const DEFAULT_API_URL = "https://api.ampersend.ai";
+/**
+ * Client for the agent marketplace API.
+ *
+ * Reads from the unauthenticated `/api/v1/agents/marketplace` endpoints
+ * to discover curated agents, their endpoints, and their skills.
+ *
+ * @example
+ * ```typescript
+ * import { MarketplaceClient } from "@ampersend_ai/ampersend-sdk/ampersend"
+ *
+ * const client = new MarketplaceClient()
+ *
+ * const agents = await client.listAgents({ source: "catalog" })
+ * const agent = await client.getAgent(agents[0].id)
+ * ```
+ */
+export class MarketplaceClient {
+    baseUrl;
+    timeout;
+    constructor(options = {}) {
+        this.baseUrl = (options.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
+        this.timeout = options.timeout ?? 30000;
+    }
+    /**
+     * List curated agents in the marketplace.
+     *
+     * Filters are optional and combine on the server side. `search` performs a
+     * fuzzy match across name, description, tags, and category.
+     */
+    async listAgents(filters = {}) {
+        Schema.decodeUnknownSync(AgentMarketplaceListQueryParams)(filters);
+        const query = new URLSearchParams();
+        if (filters.source)
+            query.set("source", filters.source);
+        if (filters.category)
+            query.set("category", filters.category);
+        if (filters.search)
+            query.set("search", filters.search);
+        if (filters.network)
+            query.set("network", filters.network);
+        const qs = query.toString();
+        const path = qs ? `/api/v1/agents/marketplace?${qs}` : "/api/v1/agents/marketplace";
+        return this.fetch("GET", path, Schema.Array(CuratedAgentDTO));
+    }
+    /**
+     * Get a single curated agent by its id.
+     *
+     * @throws ApiError with status 404 if the agent is not found.
+     */
+    async getAgent(id) {
+        return this.fetch("GET", `/api/v1/agents/marketplace/${encodeURIComponent(id)}`, CuratedAgentDTO);
+    }
+    async fetch(method, path, schema) {
+        const url = `${this.baseUrl}${path}`;
+        try {
+            const response = await globalThis.fetch(url, {
+                method,
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!response.ok) {
+                let errorMessage = `HTTP ${response.status} ${response.statusText}`;
+                try {
+                    const errorBody = await response.text();
+                    if (errorBody) {
+                        errorMessage += `: ${errorBody}`;
+                    }
+                }
+                catch {
+                    // Ignore error body parsing failures
+                }
+                throw new ApiError(errorMessage, response.status, response);
+            }
+            const data = await response.json();
+            return Schema.decodeUnknownSync(schema)(data);
+        }
+        catch (error) {
+            if (error instanceof ApiError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new ApiError(`Request timeout after ${this.timeout}ms`);
+            }
+            throw new ApiError(`Request failed: ${error}`);
+        }
+    }
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/ampersend/marketplace.js.map

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

package/dist/ampersend/treasurer.d.ts

@@ -1,115 +1,50 @@
 import type { Address, Hex } from "viem";
-import type { PaymentRequirements } from "x402/types";
+import { type PaymentRequest } from "../x402/envelopes.ts";
 import { type Authorization, type PaymentContext, type PaymentStatus, type WalletConfig, type X402Treasurer, type X402Wallet } from "../x402/index.ts";
 import { ApiClient } from "./client.ts";
-/**
- * Simplified configuration for quick setup with smart accounts.
- * This is the recommended way to configure the treasurer for most use cases.
- *
- * @example
- * ```typescript
- * const treasurer = createAmpersendTreasurer({
- *   smartAccountAddress: "0x...",
- *   sessionKeyPrivateKey: "0x...",
- * })
- * ```
- */
+/** Simplified config for the common "smart account + session key" setup. */
 export interface SimpleAmpersendTreasurerConfig {
-    /** Smart account address */
     smartAccountAddress: Address;
-    /** Session key private key for signing */
     sessionKeyPrivateKey: Hex;
-    /** Ampersend API URL (defaults to production) */
+    /** Defaults to the production Ampersend API. */
     apiUrl?: string;
-    /** Chain ID (defaults to Base mainnet 8453) */
-    chainId?: number;
 }
-/**
- * Full configuration for advanced use cases with complete wallet control.
- * Use this when you need EOA wallets or custom authentication settings.
- */
+/** Full config for EOA wallets or custom SIWE auth. */
 export interface FullAmpersendTreasurerConfig {
-    /** Base URL of the Ampersend API server */
     apiUrl: string;
-    /** Wallet configuration (EOA or Smart Account) */
     walletConfig: WalletConfig;
-    /** Optional authentication configuration */
     authConfig?: {
-        /** SIWE domain for authentication */
+        /** SIWE domain. */
         domain?: string;
-        /** SIWE statement for authentication */
+        /** SIWE statement. */
         statement?: string;
     };
 }
-/**
- * Configuration for the Ampersend treasurer.
- * Can be either simplified (recommended) or full configuration.
- */
 export type AmpersendTreasurerConfig = SimpleAmpersendTreasurerConfig | FullAmpersendTreasurerConfig;
 /**
- * AmpersendTreasurer - Ampersend API-based payment authorization with X402Treasurer pattern
- *
- * This treasurer:
- * 1. Authenticates with the Ampersend API using SIWE
- * 2. Requests payment authorization from the API before creating payments
- * 3. Creates payments only when authorized by the API
- * 4. Reports payment lifecycle events back to the API for tracking
- *
- * @example
- * ```typescript
- * const treasurer = createAmpersendTreasurer({
- *   apiUrl: "https://api.example.com",
- *   walletConfig: { type: "eoa", privateKey: "0x..." }
- * })
- * await initializeProxyServer({ transport, treasurer })
- * ```
+ * Forwards the 402 to the Ampersend API, which applies budget/policy and
+ * returns an `acceptsIndex` to sign (plus optional co-signature).
  */
 export declare class AmpersendTreasurer implements X402Treasurer {
     private apiClient;
     private wallet;
     constructor(apiClient: ApiClient, wallet: X402Wallet);
-    /**
-     * Requests payment authorization from API before creating payment.
-     * Only creates payment if API authorizes it.
-     */
-    onPaymentRequired(requirements: ReadonlyArray<PaymentRequirements>, context?: PaymentContext): Promise<Authorization | null>;
-    /**
-     * Reports payment status updates back to API for tracking.
-     * Logs errors but doesn't fail on tracking errors.
-     */
+    onPaymentRequired(request: PaymentRequest, context?: PaymentContext): Promise<Authorization | null>;
     onStatus(status: PaymentStatus, authorization: Authorization, _context?: PaymentContext): Promise<void>;
-    /**
-     * Maps X402 PaymentStatus to legacy PaymentEvent for API compatibility
-     */
     private mapStatusToEvent;
 }
 /**
- * Creates an Ampersend treasurer that consults the Ampersend API before making payments.
- *
- * This treasurer:
- * 1. Authenticates with the Ampersend API using SIWE
- * 2. Requests payment authorization from the API
- * 3. Creates payments only when authorized
- * 4. Reports payment lifecycle events back to the API
- *
- * @example Simple setup (recommended):
+ * @example Simple (recommended):
  * ```typescript
- * const treasurer = createAmpersendTreasurer({
- *   smartAccountAddress: "0x...",
- *   sessionKeyPrivateKey: "0x...",
- * })
+ * createAmpersendTreasurer({ smartAccountAddress: "0x...", sessionKeyPrivateKey: "0x..." })
  * ```
- *
- * @example Full control:
+ * @example Full (EOA or custom auth):
  * ```typescript
- * const treasurer = createAmpersendTreasurer({
+ * createAmpersendTreasurer({
  *   apiUrl: "https://api.ampersend.ai",
- *   walletConfig: { type: "eoa", privateKey: "0x..." }
+ *   walletConfig: { type: "eoa", privateKey: "0x..." },
  * })
  * ```
- *
- * @param config - Configuration for the Ampersend treasurer
- * @returns An X402Treasurer implementation
  */
 export declare function createAmpersendTreasurer(config: AmpersendTreasurerConfig): X402Treasurer;
 //# sourceMappingURL=treasurer.d.ts.map

package/dist/ampersend/treasurer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treasurer.d.ts","sourceRoot":"","sources":["../../src/ampersend/treasurer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAExC,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAIrE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AASvC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,8BAA8B;IAC7C,4BAA4B;IAC5B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,0CAA0C;IAC1C,oBAAoB,EAAE,GAAG,CAAA;IACzB,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,YAAY,EAAE,YAAY,CAAA;IAC1B,4CAA4C;IAC5C,UAAU,CAAC,EAAE;QACX,qCAAqC;QACrC,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,wCAAwC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,GAAG,4BAA4B,CAAA;AASpG;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAEpD,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;gBADN,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,UAAU;IAG5B;;;OAGG;IACG,iBAAiB,CACrB,YAAY,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkDhC;;;OAGG;IACG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7G;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAczB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,aAAa,CA+CxF"}
+{"version":3,"file":"treasurer.d.ts","sourceRoot":"","sources":["../../src/ampersend/treasurer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAIxC,OAAO,EAAsD,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC9G,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAKvC,4EAA4E;AAC5E,MAAM,WAAW,8BAA8B;IAC7C,mBAAmB,EAAE,OAAO,CAAA;IAC5B,oBAAoB,EAAE,GAAG,CAAA;IACzB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,uDAAuD;AACvD,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,YAAY,CAAA;IAC1B,UAAU,CAAC,EAAE;QACX,mBAAmB;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,sBAAsB;QACtB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF;AAED,MAAM,MAAM,wBAAwB,GAAG,8BAA8B,GAAG,4BAA4B,CAAA;AAMpG;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IAEpD,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,MAAM;gBADN,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,UAAU;IAGtB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA4BnG,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7G,OAAO,CAAC,gBAAgB;CAczB;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,wBAAwB,GAAG,aAAa,CAwCxF"}

package/dist/ampersend/treasurer.js

@@ -1,34 +1,15 @@
 import { privateKeyToAccount } from "viem/accounts";
 import { OWNABLE_VALIDATOR } from "../smart-account/index.js";
+import { acceptedOf, resourceUrlOf } from "../x402/envelopes.js";
 import { createWalletFromConfig, } from "../x402/index.js";
 import { ApiClient } from "./client.js";
-/** Default Ampersend API URL */
 const DEFAULT_API_URL = "https://api.ampersend.ai";
-/** Default chain ID (Base mainnet) */
-const DEFAULT_CHAIN_ID = 8453;
-/**
- * Type guard to check if config is the simplified format
- */
 function isSimpleConfig(config) {
     return "smartAccountAddress" in config && "sessionKeyPrivateKey" in config && !("walletConfig" in config);
 }
 /**
- * AmpersendTreasurer - Ampersend API-based payment authorization with X402Treasurer pattern
- *
- * This treasurer:
- * 1. Authenticates with the Ampersend API using SIWE
- * 2. Requests payment authorization from the API before creating payments
- * 3. Creates payments only when authorized by the API
- * 4. Reports payment lifecycle events back to the API for tracking
- *
- * @example
- * ```typescript
- * const treasurer = createAmpersendTreasurer({
- *   apiUrl: "https://api.example.com",
- *   walletConfig: { type: "eoa", privateKey: "0x..." }
- * })
- * await initializeProxyServer({ transport, treasurer })
- * ```
+ * Forwards the 402 to the Ampersend API, which applies budget/policy and
+ * returns an `acceptsIndex` to sign (plus optional co-signature).
  */
 export class AmpersendTreasurer {
     apiClient;
@@ -37,71 +18,39 @@ export class AmpersendTreasurer {
         this.apiClient = apiClient;
         this.wallet = wallet;
     }
-    /**
-     * Requests payment authorization from API before creating payment.
-     * Only creates payment if API authorizes it.
-     */
-    async onPaymentRequired(requirements, context) {
-        try {
-            // Authorize payment with API
-            // Cast needed: x402 PaymentRequirements (zod) → ampersend PaymentRequirements (Effect Schema)
-            // Structurally compatible at runtime, different type systems
-            const response = await this.apiClient.authorizePayment(requirements, context);
-            // Check if any requirements were authorized
-            if (response.authorized.requirements.length === 0) {
-                // Log rejection reasons for debugging
-                const reasons = response.rejected.map((r) => `${r.requirement.resource}: ${r.reason}`).join(", ");
-                console.log(`[AmpersendTreasurer] No requirements authorized. Reasons: ${reasons || "None provided"}`);
-                return null; // Decline
-            }
-            // Use recommended requirement (or first if recommended is null)
-            const recommendedIndex = response.authorized.recommended ?? 0;
-            const authorizedReq = response.authorized.requirements[recommendedIndex];
-            if (!authorizedReq) {
-                throw new Error("Recommended requirement index out of bounds");
-            }
-            // Check if server provided co-signature (for co-signed keys)
-            let payment;
-            if (response.payment) {
-                // Co-signed path: use server-provided authorization data and signature
-                const serverAuth = {
-                    authorizationData: response.payment.authorizationData,
-                    serverSignature: response.payment.serverSignature,
-                };
-                payment = await this.wallet.createPayment(response.payment.requirement, serverAuth);
-            }
-            else {
-                // Full-access path: sign independently
-                payment = await this.wallet.createPayment(authorizedReq.requirement);
-            }
-            return {
-                payment,
-                authorizationId: crypto.randomUUID(),
-            };
-        }
-        catch (error) {
-            console.error("[AmpersendTreasurer] Payment authorization failed:", error);
+    async onPaymentRequired(request, context) {
+        const response = await this.apiClient.authorizePayment(request, context);
+        const selected = response.authorized.selected;
+        if (!selected) {
+            const reasons = response.rejected
+                .map((r) => `${resourceUrlOf(instructionFor(request, r.acceptsIndex))}: ${r.reason}`)
+                .join(", ");
+            console.log(`[AmpersendTreasurer] No options authorized. Reasons: ${reasons || "None provided"}`);
             return null;
         }
+        const instruction = instructionFor(request, selected.acceptsIndex);
+        const serverAuth = selected.coSignature
+            ? {
+                authorizationData: selected.coSignature.authorizationData,
+                serverSignature: selected.coSignature.serverSignature,
+            }
+            : undefined;
+        const payment = await this.wallet.createPayment(instruction, serverAuth);
+        return {
+            payment,
+            authorizationId: crypto.randomUUID(),
+            accepted: acceptedOf(instruction),
+        };
     }
-    /**
-     * Reports payment status updates back to API for tracking.
-     * Logs errors but doesn't fail on tracking errors.
-     */
     async onStatus(status, authorization, _context) {
         try {
-            // Map status to event type for API
             const event = this.mapStatusToEvent(status);
             await this.apiClient.reportPaymentEvent(authorization.authorizationId, authorization.payment, event);
         }
         catch (error) {
-            // Log but don't fail on event tracking errors
             console.error(`[AmpersendTreasurer] Failed to report status ${status}:`, error);
         }
     }
-    /**
-     * Maps X402 PaymentStatus to legacy PaymentEvent for API compatibility
-     */
     mapStatusToEvent(status) {
         switch (status) {
             case "sending":
@@ -117,42 +66,30 @@ export class AmpersendTreasurer {
         }
     }
 }
+function instructionFor(request, acceptsIndex) {
+    return request.protocol === "x402-v1"
+        ? { protocol: "x402-v1", request: request.data, acceptsIndex }
+        : { protocol: "x402-v2", request: request.data, acceptsIndex };
+}
 /**
- * Creates an Ampersend treasurer that consults the Ampersend API before making payments.
- *
- * This treasurer:
- * 1. Authenticates with the Ampersend API using SIWE
- * 2. Requests payment authorization from the API
- * 3. Creates payments only when authorized
- * 4. Reports payment lifecycle events back to the API
- *
- * @example Simple setup (recommended):
+ * @example Simple (recommended):
  * ```typescript
- * const treasurer = createAmpersendTreasurer({
- *   smartAccountAddress: "0x...",
- *   sessionKeyPrivateKey: "0x...",
- * })
+ * createAmpersendTreasurer({ smartAccountAddress: "0x...", sessionKeyPrivateKey: "0x..." })
  * ```
- *
- * @example Full control:
+ * @example Full (EOA or custom auth):
  * ```typescript
- * const treasurer = createAmpersendTreasurer({
+ * createAmpersendTreasurer({
  *   apiUrl: "https://api.ampersend.ai",
- *   walletConfig: { type: "eoa", privateKey: "0x..." }
+ *   walletConfig: { type: "eoa", privateKey: "0x..." },
  * })
  * ```
- *
- * @param config - Configuration for the Ampersend treasurer
- * @returns An X402Treasurer implementation
  */
 export function createAmpersendTreasurer(config) {
     if (isSimpleConfig(config)) {
-        // Simple config - build wallet config automatically
         const walletConfig = {
             type: "smart-account",
             smartAccountAddress: config.smartAccountAddress,
             sessionKeyPrivateKey: config.sessionKeyPrivateKey,
-            chainId: config.chainId ?? DEFAULT_CHAIN_ID,
             validatorAddress: OWNABLE_VALIDATOR,
         };
         const apiClient = new ApiClient({
@@ -164,15 +101,11 @@ export function createAmpersendTreasurer(config) {
         const wallet = createWalletFromConfig(walletConfig);
         return new AmpersendTreasurer(apiClient, wallet);
     }
-    // Full config - existing behavior
     const { apiUrl, authConfig, walletConfig } = config;
-    // Determine which private key to use for API authentication
     const authPrivateKey = walletConfig.type === "eoa" ? walletConfig.privateKey : walletConfig.sessionKeyPrivateKey;
-    // Derive agent address from wallet config
     const agentAddress = walletConfig.type === "smart-account"
         ? walletConfig.smartAccountAddress
         : privateKeyToAccount(walletConfig.privateKey).address;
-    // Create API client
     const apiClient = new ApiClient({
         baseUrl: apiUrl,
         sessionKeyPrivateKey: authPrivateKey,
@@ -180,7 +113,6 @@ export function createAmpersendTreasurer(config) {
         timeout: 30000,
         ...authConfig,
     });
-    // Create wallet from configuration
     const wallet = createWalletFromConfig(walletConfig);
     return new AmpersendTreasurer(apiClient, wallet);
 }

package/dist/ampersend/treasurer.js.map

@@ -1 +1 @@
-{"version":3,"file":"treasurer.js","sourceRoot":"","sources":["../../src/ampersend/treasurer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"treasurer.js","sourceRoot":"","sources":["../../src/ampersend/treasurer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAgD,MAAM,sBAAsB,CAAA;AAC9G,OAAO,EACL,sBAAsB,GAQvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAGvC,MAAM,eAAe,GAAG,0BAA0B,CAAA;AAwBlD,SAAS,cAAc,CAAC,MAAgC;IACtD,OAAO,qBAAqB,IAAI,MAAM,IAAI,sBAAsB,IAAI,MAAM,IAAI,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,CAAA;AAC3G,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAEnB;IACA;IAFV,YACU,SAAoB,EACpB,MAAkB;QADlB,cAAS,GAAT,SAAS,CAAW;QACpB,WAAM,GAAN,MAAM,CAAY;IACzB,CAAC;IAEJ,KAAK,CAAC,iBAAiB,CAAC,OAAuB,EAAE,OAAwB;QACvE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAExE,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAA;QAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ;iBAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;iBACpF,IAAI,CAAC,IAAI,CAAC,CAAA;YACb,OAAO,CAAC,GAAG,CAAC,wDAAwD,OAAO,IAAI,eAAe,EAAE,CAAC,CAAA;YACjG,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAA;QAClE,MAAM,UAAU,GAAwC,QAAQ,CAAC,WAAW;YAC1E,CAAC,CAAC;gBACE,iBAAiB,EAAE,QAAQ,CAAC,WAAW,CAAC,iBAAiB;gBACzD,eAAe,EAAE,QAAQ,CAAC,WAAW,CAAC,eAAe;aACtD;YACH,CAAC,CAAC,SAAS,CAAA;QACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;QAExE,OAAO;YACL,OAAO;YACP,eAAe,EAAE,MAAM,CAAC,UAAU,EAAE;YACpC,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;SAClC,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAqB,EAAE,aAA4B,EAAE,QAAyB;QAC3F,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;YAC3C,MAAM,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,aAAa,CAAC,eAAe,EAAE,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QACtG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gDAAgD,MAAM,GAAG,EAAE,KAAK,CAAC,CAAA;QACjF,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,MAAqB;QAC5C,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,SAAS;gBACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;YAC5B,KAAK,UAAU;gBACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;YAC7B,KAAK,UAAU;gBACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAA;YACnE,KAAK,UAAU;gBACb,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,+BAA+B,EAAE,CAAA;YACtE,KAAK,OAAO;gBACV,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAA;QAChE,CAAC;IACH,CAAC;CACF;AAED,SAAS,cAAc,CAAC,OAAuB,EAAE,YAAoB;IACnE,OAAO,OAAO,CAAC,QAAQ,KAAK,SAAS;QACnC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE;QAC9D,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,CAAA;AAClE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAgC;IACvE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,YAAY,GAA6B;YAC7C,IAAI,EAAE,eAAe;YACrB,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;YAC/C,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,gBAAgB,EAAE,iBAAiB;SACpC,CAAA;QAED,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,IAAI,eAAe;YACzC,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,YAAY,EAAE,MAAM,CAAC,mBAAmB;YACxC,OAAO,EAAE,KAAK;SACf,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;QACnD,OAAO,IAAI,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,MAAM,CAAA;IAEnD,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAA;IAEhH,MAAM,YAAY,GAChB,YAAY,CAAC,IAAI,KAAK,eAAe;QACnC,CAAC,CAAC,YAAY,CAAC,mBAAmB;QAClC,CAAC,CAAC,mBAAmB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,OAAO,CAAA;IAE1D,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,OAAO,EAAE,MAAM;QACf,oBAAoB,EAAE,cAAc;QACpC,YAAY;QACZ,OAAO,EAAE,KAAK;QACd,GAAG,UAAU;KACd,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAA;IAEnD,OAAO,IAAI,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC"}