@itachisol/plugin-x402-swarms 0.1.0

package/dist/services/x402WalletService.d.ts

@@ -0,0 +1,57 @@
+import { Service, type IAgentRuntime } from "@elizaos/core";
+import { type BudgetAccount, type PaymentReceipt } from "@dexterai/x402/client";
+import type { X402PaymentConfig } from "../types.js";
+export interface PayForResourceOptions {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}
+export interface PayForResourceResult {
+    txHash: string;
+    network: string | undefined;
+    payer: string | undefined;
+    amountUsd: number;
+    receipt: PaymentReceipt | undefined;
+    response: Response;
+}
+/**
+ * Manages the agent's x402 payment wallet via the Dexter SDK.
+ * Uses BudgetAccount for automatic spending controls and payment tracking.
+ */
+export declare class X402WalletService extends Service {
+    static serviceType: string;
+    capabilityDescription: string;
+    private paymentConfig;
+    private budgetAccount;
+    private x402Fetch;
+    private agentRuntime;
+    static start(runtime: IAgentRuntime): Promise<X402WalletService>;
+    stop(): Promise<void>;
+    initialize(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Get the x402-wrapped fetch that auto-pays for 402 responses.
+     */
+    getX402Fetch(): typeof globalThis.fetch;
+    /**
+     * Get the budget-controlled fetch for autonomous agent spending.
+     */
+    getBudgetAccount(): BudgetAccount | null;
+    /**
+     * Pay for an x402-protected resource using the budget account.
+     * The Dexter SDK handles the 402 → sign → retry flow automatically.
+     * Supports arbitrary HTTP methods and bodies.
+     */
+    payForResource(endpoint: string, options?: PayForResourceOptions): Promise<PayForResourceResult>;
+    private mapX402Error;
+    getPaymentHistory(): Array<{
+        amount: number;
+        domain: string;
+        network: string;
+        timestamp: number;
+    }>;
+    getTotalSpentUsd(): number;
+    getRemainingBudget(): number;
+    getHourlySpend(): number;
+    getConfig(): X402PaymentConfig;
+}
+//# sourceMappingURL=x402WalletService.d.ts.map

package/dist/services/x402WalletService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402WalletService.d.ts","sourceRoot":"","sources":["../../src/services/x402WalletService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAKL,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAG3E,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IACpC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,MAAM,CAAC,WAAW,SAAiB;IACnC,qBAAqB,SACwF;IAE7G,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,YAAY,CAA8B;WAErC,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMhE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA4GvD;;OAEG;IACH,YAAY,IAAI,OAAO,UAAU,CAAC,KAAK;IAOvC;;OAEG;IACH,gBAAgB,IAAI,aAAa,GAAG,IAAI;IAIxC;;;;OAIG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IA4GhC,OAAO,CAAC,YAAY;IAsBpB,iBAAiB,IAAI,KAAK,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAKF,gBAAgB,IAAI,MAAM;IAI1B,kBAAkB,IAAI,MAAM;IAI5B,cAAc,IAAI,MAAM;IAIxB,SAAS,IAAI,iBAAiB;CAG/B"}

package/dist/services/x402WalletService.js

@@ -0,0 +1,258 @@
+import { Service } from "@elizaos/core";
+import { wrapFetch, createBudgetAccount, getPaymentReceipt, X402Error, } from "@dexterai/x402/client";
+/**
+ * Manages the agent's x402 payment wallet via the Dexter SDK.
+ * Uses BudgetAccount for automatic spending controls and payment tracking.
+ */
+export class X402WalletService extends Service {
+    static serviceType = "X402_WALLET";
+    capabilityDescription = "Manages x402 micropayments via Dexter SDK with budget controls, access passes, and marketplace discovery";
+    paymentConfig;
+    budgetAccount = null;
+    x402Fetch = null;
+    agentRuntime = null;
+    static async start(runtime) {
+        const instance = new X402WalletService(runtime);
+        await instance.initialize(runtime);
+        return instance;
+    }
+    async stop() {
+        this.budgetAccount = null;
+        this.x402Fetch = null;
+        this.agentRuntime = null;
+    }
+    async initialize(runtime) {
+        this.agentRuntime = runtime;
+        const networkRaw = runtime.getSetting("X402_NETWORK_ID");
+        const receiveRaw = runtime.getSetting("X402_RECEIVE_ADDRESS");
+        const maxPayRaw = runtime.getSetting("X402_MAX_AUTO_PAY_USD");
+        const solanaKey = runtime.getSetting("SOLANA_PRIVATE_KEY");
+        const evmKey = runtime.getSetting("EVM_PRIVATE_KEY");
+        const budgetRaw = runtime.getSetting("X402_BUDGET_USD");
+        const facilitatorRaw = runtime.getSetting("X402_FACILITATOR_URL");
+        const accessTierRaw = runtime.getSetting("X402_ACCESS_PASS_TIER");
+        const accessMaxSpendRaw = runtime.getSetting("X402_ACCESS_PASS_MAX_SPEND");
+        this.paymentConfig = {
+            networkId: networkRaw ?? "base-mainnet",
+            receiveAddress: receiveRaw != null ? String(receiveRaw) : "",
+            maxAutoPayUsd: parseFloat(maxPayRaw != null ? String(maxPayRaw) : "0.10"),
+            solanaPrivateKey: solanaKey != null ? String(solanaKey) : undefined,
+            evmPrivateKey: evmKey != null ? String(evmKey) : undefined,
+            accessPassTier: accessTierRaw != null ? String(accessTierRaw) : undefined,
+            accessPassMaxSpend: accessMaxSpendRaw != null ? String(accessMaxSpendRaw) : undefined,
+        };
+        const hasWallet = !!this.paymentConfig.solanaPrivateKey ||
+            !!this.paymentConfig.evmPrivateKey;
+        if (!hasWallet) {
+            runtime.logger.warn("[X402WalletService] No wallet key configured (SOLANA_PRIVATE_KEY or EVM_PRIVATE_KEY). Payment features disabled.");
+            return;
+        }
+        // Build wrapFetch options
+        const fetchOpts = {
+            verbose: false,
+        };
+        if (this.paymentConfig.solanaPrivateKey) {
+            fetchOpts.walletPrivateKey = this.paymentConfig.solanaPrivateKey;
+        }
+        if (this.paymentConfig.evmPrivateKey) {
+            fetchOpts.evmPrivateKey = this.paymentConfig.evmPrivateKey;
+        }
+        if (facilitatorRaw) {
+            fetchOpts.facilitatorUrl = String(facilitatorRaw);
+        }
+        // Access Pass configuration
+        if (this.paymentConfig.accessPassTier) {
+            fetchOpts.accessPass = {
+                preferTier: this.paymentConfig.accessPassTier,
+                maxSpend: this.paymentConfig.accessPassMaxSpend ?? "2.00",
+                autoRenew: true,
+            };
+        }
+        // Determine preferred network from config
+        const networkMap = {
+            "base-mainnet": "eip155:8453",
+            "base-sepolia": "eip155:84532",
+            "ethereum-mainnet": "eip155:1",
+            "solana-mainnet": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
+            "polygon-mainnet": "eip155:137",
+            "arbitrum-mainnet": "eip155:42161",
+        };
+        const preferred = networkMap[String(networkRaw ?? "base-mainnet")];
+        if (preferred) {
+            fetchOpts.preferredNetwork = preferred;
+        }
+        // Create BudgetAccount for spending controls
+        const totalBudget = budgetRaw != null ? String(budgetRaw) : "10.00";
+        const perRequest = String(this.paymentConfig.maxAutoPayUsd.toFixed(2));
+        this.budgetAccount = createBudgetAccount({
+            ...fetchOpts,
+            budget: {
+                total: totalBudget,
+                perRequest,
+                perHour: String(Math.min(parseFloat(totalBudget), this.paymentConfig.maxAutoPayUsd * 100).toFixed(2)),
+            },
+        });
+        // Also create a plain wrapFetch for direct use
+        this.x402Fetch = wrapFetch(fetch, fetchOpts);
+        runtime.logger.info({
+            network: this.paymentConfig.networkId,
+            maxAutoPayUsd: this.paymentConfig.maxAutoPayUsd,
+            totalBudget,
+            hasSolana: !!this.paymentConfig.solanaPrivateKey,
+            hasEvm: !!this.paymentConfig.evmPrivateKey,
+            accessPass: !!this.paymentConfig.accessPassTier,
+        }, "[X402WalletService] Initialized with Dexter SDK");
+    }
+    /**
+     * Get the x402-wrapped fetch that auto-pays for 402 responses.
+     */
+    getX402Fetch() {
+        if (!this.x402Fetch) {
+            throw new Error("X402 wallet not initialized — no wallet key configured");
+        }
+        return this.x402Fetch;
+    }
+    /**
+     * Get the budget-controlled fetch for autonomous agent spending.
+     */
+    getBudgetAccount() {
+        return this.budgetAccount;
+    }
+    /**
+     * Pay for an x402-protected resource using the budget account.
+     * The Dexter SDK handles the 402 → sign → retry flow automatically.
+     * Supports arbitrary HTTP methods and bodies.
+     */
+    async payForResource(endpoint, options) {
+        if (!this.budgetAccount) {
+            throw new Error("X402 wallet not initialized — no wallet key configured");
+        }
+        // Capture local references so that stop() during an in-flight payment
+        // doesn't null them out from under us.
+        const budgetAccount = this.budgetAccount;
+        const runtime = this.agentRuntime;
+        const spentBefore = budgetAccount.spentAmount;
+        let response;
+        const startTime = Date.now();
+        try {
+            const init = {};
+            if (options?.method)
+                init.method = options.method;
+            if (options?.headers)
+                init.headers = options.headers;
+            if (options?.body)
+                init.body = options.body;
+            response = await budgetAccount.fetch(endpoint, Object.keys(init).length > 0 ? init : undefined);
+        }
+        catch (err) {
+            if (err instanceof X402Error) {
+                const friendly = this.mapX402Error(err);
+                throw new Error(friendly);
+            }
+            throw err;
+        }
+        const responseTimeMs = Date.now() - startTime;
+        const spentAfter = budgetAccount.spentAmount;
+        const amountPaid = spentAfter - spentBefore;
+        // Extract real on-chain receipt from response
+        const receipt = getPaymentReceipt(response);
+        const result = {
+            txHash: receipt?.transaction ?? "no-payment-required",
+            network: receipt?.network,
+            payer: receipt?.payer,
+            amountUsd: amountPaid,
+            receipt,
+            response,
+        };
+        // Log payment details
+        if (amountPaid > 0 && runtime) {
+            runtime.logger.info({
+                endpoint,
+                txHash: result.txHash,
+                network: result.network,
+                payer: result.payer,
+                amountUsd: amountPaid,
+                remainingBudget: budgetAccount.remainingAmount,
+            }, "[X402WalletService] Payment completed");
+        }
+        // Record payment in persistent memory (fire-and-forget)
+        try {
+            const memoryService = runtime?.getService("PAYMENT_MEMORY");
+            if (memoryService) {
+                let domain;
+                try {
+                    domain = new URL(endpoint).hostname;
+                }
+                catch {
+                    domain = "unknown";
+                }
+                const responsePreview = await response
+                    .clone()
+                    .text()
+                    .catch(() => "")
+                    .then((t) => t.slice(0, 200));
+                const record = {
+                    id: crypto.randomUUID(),
+                    agentId: runtime?.agentId ?? "unknown",
+                    endpoint,
+                    domain,
+                    method: options?.method ?? "GET",
+                    amountUsd: amountPaid,
+                    txHash: result.txHash,
+                    network: result.network,
+                    payer: result.payer,
+                    status: "confirmed",
+                    responseStatus: response.status,
+                    responseTimeMs,
+                    responsePreview,
+                    createdAt: Date.now(),
+                };
+                // Catch async rejection so it never becomes an unhandled promise rejection
+                void memoryService.recordPayment(record).catch(() => { });
+            }
+        }
+        catch {
+            // Recording failure must never break the payment flow
+        }
+        return result;
+    }
+    mapX402Error(err) {
+        switch (err.code) {
+            case "insufficient_balance":
+                return `Insufficient USDC balance. Fund your wallet. ${err.message}`;
+            case "amount_exceeds_max":
+                return `Payment exceeds per-request limit ($${this.paymentConfig.maxAutoPayUsd}). ${err.message}`;
+            case "payment_rejected":
+                return `Payment rejected (budget exhausted or domain blocked). ${err.message}`;
+            case "facilitator_settle_failed":
+                return `On-chain settlement failed. ${err.message}`;
+            case "facilitator_timeout":
+            case "rpc_timeout":
+                return `Network timeout during payment. Retry may succeed. ${err.message}`;
+            case "user_rejected_signature":
+                return `Payment signature rejected. ${err.message}`;
+            case "access_pass_expired":
+                return `Access pass expired. A new one will be purchased on next call. ${err.message}`;
+            default:
+                return `x402 error [${err.code}]: ${err.message}`;
+        }
+    }
+    getPaymentHistory() {
+        if (!this.budgetAccount)
+            return [];
+        return [...this.budgetAccount.ledger];
+    }
+    getTotalSpentUsd() {
+        return this.budgetAccount?.spentAmount ?? 0;
+    }
+    getRemainingBudget() {
+        return this.budgetAccount?.remainingAmount ?? 0;
+    }
+    getHourlySpend() {
+        return this.budgetAccount?.hourlySpend ?? 0;
+    }
+    getConfig() {
+        return { ...this.paymentConfig };
+    }
+}
+//# sourceMappingURL=x402WalletService.js.map

package/dist/services/x402WalletService.js.map

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

package/dist/templates/index.d.ts

@@ -0,0 +1,24 @@
+import type { SwarmTemplate } from "../types.js";
+export { researchPipelineTemplate, analysisPanelTemplate, codeReviewTemplate, debateAndDecideTemplate, } from "./swarmTemplates.js";
+/**
+ * Registry of all available swarm templates.
+ * Ordered by specificity — more specific patterns first to avoid false matches.
+ */
+export declare const SWARM_TEMPLATES: SwarmTemplate[];
+/**
+ * Find the first matching template based on regex trigger patterns.
+ * Templates are checked in specificity order (most specific first).
+ * Returns null if no template matches.
+ */
+export declare function findMatchingTemplate(text: string): SwarmTemplate | null;
+/**
+ * Register a custom swarm template at runtime.
+ * Custom templates are appended to the end of the registry (lowest priority).
+ */
+export declare function registerSwarmTemplate(template: SwarmTemplate): void;
+/**
+ * Build a classification prompt listing all available templates.
+ * Used when keyword matching is ambiguous or fails.
+ */
+export declare function buildClassificationPrompt(userMessage: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAQjD,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAK1C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQvE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEnE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAcrE"}

package/dist/templates/index.js

@@ -0,0 +1,51 @@
+import { codeReviewTemplate, debateAndDecideTemplate, researchPipelineTemplate, analysisPanelTemplate, } from "./swarmTemplates.js";
+export { researchPipelineTemplate, analysisPanelTemplate, codeReviewTemplate, debateAndDecideTemplate, } from "./swarmTemplates.js";
+/**
+ * Registry of all available swarm templates.
+ * Ordered by specificity — more specific patterns first to avoid false matches.
+ */
+export const SWARM_TEMPLATES = [
+    codeReviewTemplate, // Most specific triggers (code+review, audit, contract)
+    debateAndDecideTemplate, // Specific triggers (should I, pros/cons, debate)
+    researchPipelineTemplate, // Broader triggers (research, report, summarize)
+    analysisPanelTemplate, // Broadest triggers (analyze, evaluate, assess)
+];
+/**
+ * Find the first matching template based on regex trigger patterns.
+ * Templates are checked in specificity order (most specific first).
+ * Returns null if no template matches.
+ */
+export function findMatchingTemplate(text) {
+    if (!text)
+        return null;
+    for (const template of SWARM_TEMPLATES) {
+        if (template.triggerPatterns.some((pattern) => pattern.test(text))) {
+            return template;
+        }
+    }
+    return null;
+}
+/**
+ * Register a custom swarm template at runtime.
+ * Custom templates are appended to the end of the registry (lowest priority).
+ */
+export function registerSwarmTemplate(template) {
+    SWARM_TEMPLATES.push(template);
+}
+/**
+ * Build a classification prompt listing all available templates.
+ * Used when keyword matching is ambiguous or fails.
+ */
+export function buildClassificationPrompt(userMessage) {
+    const templateList = SWARM_TEMPLATES.map((t) => `- "${t.id}": ${t.description}`).join("\n");
+    return `Classify the user's request into one of these swarm templates, or "custom" if none fit:
+${templateList}
+- "custom": None of the above — needs a custom swarm configuration
+
+Return JSON: { "templateId": "<id or custom>", "task": "<the specific task to perform>" }
+
+User message: "${userMessage}"
+
+Return only valid JSON, no markdown.`;
+}
+//# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,kBAAkB,EAAQ,wDAAwD;IAClF,uBAAuB,EAAG,kDAAkD;IAC5E,wBAAwB,EAAE,iDAAiD;IAC3E,qBAAqB,EAAK,gDAAgD;CAC3E,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAuB;IAC3D,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,WAAW,EAAE,CACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;EACP,YAAY;;;;;iBAKG,WAAW;;qCAES,CAAC;AACtC,CAAC"}

package/dist/templates/swarmTemplates.d.ts

@@ -0,0 +1,22 @@
+import type { SwarmTemplate } from "../types.js";
+/**
+ * ResearchPipeline — Sequential chain: Researcher → FactChecker → Writer
+ * Use for: research tasks, report writing, investigation, summarization
+ */
+export declare const researchPipelineTemplate: SwarmTemplate;
+/**
+ * AnalysisPanel — MixtureOfAgents: 3 domain experts + 1 synthesizer
+ * Use for: multi-perspective analysis, evaluation, assessment
+ */
+export declare const analysisPanelTemplate: SwarmTemplate;
+/**
+ * CodeReview — ConcurrentWorkflow: 3 parallel reviewers
+ * Use for: code review, smart contract audit, security check
+ */
+export declare const codeReviewTemplate: SwarmTemplate;
+/**
+ * DebateAndDecide — MajorityVoting: Proponent + Opponent + Judge
+ * Use for: decision-making, pros/cons analysis, should-I questions
+ */
+export declare const debateAndDecideTemplate: SwarmTemplate;
+//# sourceMappingURL=swarmTemplates.d.ts.map

package/dist/templates/swarmTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarmTemplates.d.ts","sourceRoot":"","sources":["../../src/templates/swarmTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAsDtC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA4DnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAoDhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAoDrC,CAAC"}