keyring-agent-core 0.2.0 → 0.2.2

package/dist/tools/builtin/wallet/index.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SendNftTool = exports.BaseNftMessageTool = exports.TransactionByHashTool = exports.WalletDefiProtocolPositionsTool = exports.WalletDefiPositionsTool = exports.WalletDefiSummaryTool = exports.WalletApprovalsTool = exports.WalletPnlTool = exports.WalletPnlSummaryTool = exports.WalletNetWorthTool = exports.WalletNftTransfersTool = exports.WalletTokenTransfersTool = exports.WalletHistoryTool = exports.WalletTokenBalancesTool = void 0;
-var WalletTokenBalancesTool_1 = require("./WalletTokenBalancesTool");
-Object.defineProperty(exports, "WalletTokenBalancesTool", { enumerable: true, get: function () { return WalletTokenBalancesTool_1.WalletTokenBalancesTool; } });
-var WalletHistoryTool_1 = require("./WalletHistoryTool");
-Object.defineProperty(exports, "WalletHistoryTool", { enumerable: true, get: function () { return WalletHistoryTool_1.WalletHistoryTool; } });
-var WalletTokenTransfersTool_1 = require("./WalletTokenTransfersTool");
-Object.defineProperty(exports, "WalletTokenTransfersTool", { enumerable: true, get: function () { return WalletTokenTransfersTool_1.WalletTokenTransfersTool; } });
-var WalletNftTransfersTool_1 = require("./WalletNftTransfersTool");
-Object.defineProperty(exports, "WalletNftTransfersTool", { enumerable: true, get: function () { return WalletNftTransfersTool_1.WalletNftTransfersTool; } });
-var WalletNetWorthTool_1 = require("./WalletNetWorthTool");
-Object.defineProperty(exports, "WalletNetWorthTool", { enumerable: true, get: function () { return WalletNetWorthTool_1.WalletNetWorthTool; } });
-var WalletPnlSummaryTool_1 = require("./WalletPnlSummaryTool");
-Object.defineProperty(exports, "WalletPnlSummaryTool", { enumerable: true, get: function () { return WalletPnlSummaryTool_1.WalletPnlSummaryTool; } });
-var WalletPnlTool_1 = require("./WalletPnlTool");
-Object.defineProperty(exports, "WalletPnlTool", { enumerable: true, get: function () { return WalletPnlTool_1.WalletPnlTool; } });
-var WalletApprovalsTool_1 = require("./WalletApprovalsTool");
-Object.defineProperty(exports, "WalletApprovalsTool", { enumerable: true, get: function () { return WalletApprovalsTool_1.WalletApprovalsTool; } });
-var WalletDefiSummaryTool_1 = require("./WalletDefiSummaryTool");
-Object.defineProperty(exports, "WalletDefiSummaryTool", { enumerable: true, get: function () { return WalletDefiSummaryTool_1.WalletDefiSummaryTool; } });
-var WalletDefiPositionsTool_1 = require("./WalletDefiPositionsTool");
-Object.defineProperty(exports, "WalletDefiPositionsTool", { enumerable: true, get: function () { return WalletDefiPositionsTool_1.WalletDefiPositionsTool; } });
-var WalletDefiProtocolPositionsTool_1 = require("./WalletDefiProtocolPositionsTool");
-Object.defineProperty(exports, "WalletDefiProtocolPositionsTool", { enumerable: true, get: function () { return WalletDefiProtocolPositionsTool_1.WalletDefiProtocolPositionsTool; } });
-var TransactionByHashTool_1 = require("./TransactionByHashTool");
-Object.defineProperty(exports, "TransactionByHashTool", { enumerable: true, get: function () { return TransactionByHashTool_1.TransactionByHashTool; } });
-var BaseNftMessageTool_1 = require("../nft/BaseNftMessageTool");
-Object.defineProperty(exports, "BaseNftMessageTool", { enumerable: true, get: function () { return BaseNftMessageTool_1.BaseNftMessageTool; } });
-var SendNftTool_1 = require("../nft/SendNftTool");
-Object.defineProperty(exports, "SendNftTool", { enumerable: true, get: function () { return SendNftTool_1.SendNftTool; } });
-//# sourceMappingURL=index.js.map

package/dist/tools/builtin/wallet/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet/index.ts"],"names":[],"mappings":";;;AAAA,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAEhC,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AAEjC,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA;AAE/B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAE3B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAE7B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAE5B,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAE9B,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAEhC,qFAAoF;AAA3E,kJAAA,+BAA+B,OAAA;AAExC,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAE9B,gEAA+D;AAAtD,wHAAA,kBAAkB,OAAA;AAE3B,kDAAiD;AAAxC,0GAAA,WAAW,OAAA"}

package/dist/tools/builtin/wallet-action/ApproveTokenTool.d.ts

@@ -1,25 +0,0 @@
-import type { MoralisServiceConfig } from '../../../services/MoralisService';
-import type { ToolParameter, UserContext, WalletActionType } from '../../../types';
-import { BaseWalletActionTool } from './BaseWalletActionTool';
-/**
- * Tool: open-approve-token-form
- *
- * Opens the ERC-20 `approve` form. `amount` is optional — when omitted the FE
- * defaults to unlimited (max uint256). Either `contract_address` or
- * `token_symbol` must be provided; the symbol is resolved to an address via
- * the connected wallet's balances first, then a Pantograph search.
- */
-export declare class ApproveTokenTool extends BaseWalletActionTool {
-    name: string;
-    protected readonly actionType: WalletActionType;
-    protected readonly component = "ApproveTokenForm";
-    protected readonly userInputFields: readonly [{
-        readonly key: "spender_address";
-        readonly label: "the spender address to approve";
-    }];
-    constructor(config?: MoralisServiceConfig);
-    description: string;
-    parameters: ToolParameter[];
-    protected buildParameters(args: Record<string, unknown>, userContext?: UserContext): Promise<Record<string, string>>;
-}
-//# sourceMappingURL=ApproveTokenTool.d.ts.map

package/dist/tools/builtin/wallet-action/ApproveTokenTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ApproveTokenTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet-action/ApproveTokenTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;IACxD,IAAI,SAA6B;IACjC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAmB;IAClE,SAAS,CAAC,QAAQ,CAAC,SAAS,sBAAsB;IAIlD,SAAS,CAAC,QAAQ,CAAC,eAAe;;;OAAkF;gBAExG,MAAM,CAAC,EAAE,oBAAoB;IAIzC,WAAW,SAMkB;IAE7B,UAAU,EAAE,aAAa,EAAE,CA8BzB;cAEc,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;CAqCzF"}

package/dist/tools/builtin/wallet-action/ApproveTokenTool.js

@@ -1,98 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApproveTokenTool = void 0;
-const BaseWalletActionTool_1 = require("./BaseWalletActionTool");
-/**
- * Tool: open-approve-token-form
- *
- * Opens the ERC-20 `approve` form. `amount` is optional — when omitted the FE
- * defaults to unlimited (max uint256). Either `contract_address` or
- * `token_symbol` must be provided; the symbol is resolved to an address via
- * the connected wallet's balances first, then a Pantograph search.
- */
-class ApproveTokenTool extends BaseWalletActionTool_1.BaseWalletActionTool {
-    name = 'open-approve-token-form';
-    actionType = 'approve_token';
-    component = 'ApproveTokenForm';
-    // `amount` is intentionally NOT listed: blank = unlimited approval, a valid
-    // default — so we never ask the user to fill it. Only the spender is required.
-    userInputFields = [{ key: 'spender_address', label: 'the spender address to approve' }];
-    constructor(config) {
-        super(config);
-    }
-    description = 'Open the APPROVE TOKEN form so the user can grant a spender allowance on an ERC-20 token. Use ' +
-        'when the user says "approve USDC for Uniswap", "cấp quyền 100 USDT cho 0x…", "revoke approval". ' +
-        'Pass `contract_address` when you have it; otherwise pass `token_symbol` (e.g. "USDC") and the tool ' +
-        'auto-resolves the contract. Always pass `spender_address` (the contract being approved). ' +
-        'Pass `amount` for a specific allowance; omit for unlimited (max uint256). For approving 0 to ' +
-        'revoke, pass amount="0".';
-    parameters = [
-        { name: 'chain', type: 'string', description: 'Hex chain id. Defaults to connected chain.', required: false },
-        {
-            name: 'contract_address',
-            type: 'string',
-            description: 'ERC-20 token contract address (0x…). Pass when known. Otherwise leave empty and provide token_symbol.',
-            required: false,
-        },
-        {
-            name: 'token_symbol',
-            type: 'string',
-            description: 'Token symbol (e.g. "USDC"). Required when contract_address is not given. Used to auto-resolve the contract.',
-            required: false,
-        },
-        { name: 'decimals', type: 'number', description: 'Token decimals.', required: false },
-        {
-            name: 'spender_address',
-            type: 'string',
-            description: 'EVM address of the spender contract being approved (0x…). Omit when unknown — the form will prompt the user.',
-            required: false,
-        },
-        {
-            name: 'amount',
-            type: 'string',
-            description: 'Human-readable allowance amount. Omit for UNLIMITED (max uint256). Pass "0" to revoke.',
-            required: false,
-        },
-    ];
-    async buildParameters(args, userContext) {
-        const chain = this.requireChain(args, userContext) ?? undefined;
-        const resolved = await this.resolveTokenRef({
-            contractArg: args.contract_address,
-            symbolArg: args.token_symbol,
-            decimalsArg: args.decimals,
-            chain,
-            walletAddress: userContext?.walletAddress ?? undefined,
-        });
-        if ('error' in resolved) {
-            return {
-                error: 'token_not_found',
-                symbol: resolved.key,
-                _instructions: `Could not resolve token "${resolved.key}" to a contract address on this chain. Ask the user to provide the token contract directly.`,
-            };
-        }
-        const token = resolved.token;
-        const spender = this.normaliseAddress(args.spender_address);
-        const params = {};
-        if (token?.address)
-            params.contract_address = token.address;
-        if (spender)
-            params.spender_address = spender;
-        if (token?.symbol)
-            params.token_symbol = token.symbol;
-        if (token?.decimals !== undefined)
-            params.decimals = String(token.decimals);
-        // Amount is optional: pass through "0" for revoke, positive numbers as-is.
-        if (typeof args.amount === 'string' && args.amount.trim()) {
-            const v = args.amount.trim();
-            const n = parseFloat(v);
-            if (Number.isFinite(n) && n >= 0)
-                params.amount = v;
-        }
-        else if (typeof args.amount === 'number' && Number.isFinite(args.amount) && args.amount >= 0) {
-            params.amount = String(args.amount);
-        }
-        return params;
-    }
-}
-exports.ApproveTokenTool = ApproveTokenTool;
-//# sourceMappingURL=ApproveTokenTool.js.map

package/dist/tools/builtin/wallet-action/ApproveTokenTool.js.map

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

package/dist/tools/builtin/wallet-action/BaseWalletActionTool.d.ts

@@ -1,211 +0,0 @@
-import { BaseTool } from '../../BaseTool';
-import { MoralisService, type MoralisServiceConfig } from '../../../services/MoralisService';
-import { type NativeActionKind } from './gasReserve';
-import type { SuggestedAction, ToolKind, ToolResult, UIPayload, UserContext, WalletActionType } from '../../../types';
-/** Resolved token identity used to pre-fill a wallet-action form. */
-export interface ResolvedToken {
-    address: string;
-    symbol?: string;
-    name?: string;
-    decimals?: number;
-}
-/**
- * Shared base for wallet-action tools.
- *
- * Each concrete tool resolves identifiers + validates inputs, then returns the
- * `WalletActionProps` payload below. The FE owns the form and the on-chain tx;
- * the agent only forwards a structured intent.
- *
- * Subclasses implement `buildAction()` returning the fully-shaped payload (or
- * an `{ error, _instructions }` object that aborts before emitting UI).
- */
-export declare abstract class BaseWalletActionTool extends BaseTool {
-    kind: ToolKind;
-    category: string;
-    noSuggestions: boolean;
-    protected abstract readonly actionType: WalletActionType;
-    protected abstract readonly component: string;
-    /**
-     * The fields the *user* is expected to fill in the form, with a friendly,
-     * user-facing label (in English — the LLM translates to the user's language).
-     *
-     * Used to build the `_instructions`: any of these whose value the tool could
-     * NOT pre-resolve is listed back to the LLM so it can ask the user to enter
-     * exactly those. Internal/derived fields (contract_address, decimals, …) must
-     * NOT appear here — the user never types them.
-     *
-     * Order matters: it's the order the LLM should mention missing fields in.
-     *
-     * `key` may be a single param name or an array — for an array, the field
-     * counts as filled when ANY of the listed params has a value (e.g. a buy
-     * amount that can be expressed as either `buy_amount` or `pay_with_amount`).
-     */
-    protected readonly userInputFields: ReadonlyArray<{
-        key: string | readonly string[];
-        label: string;
-    }>;
-    /**
-     * Optional Moralis service used to resolve token symbols → contract addresses.
-     * Concrete tools that accept a `token_symbol` parameter should accept a
-     * `MoralisServiceConfig` in their constructor and forward it to `super()`.
-     */
-    protected readonly moralis?: MoralisService;
-    constructor(config?: MoralisServiceConfig);
-    /**
-     * Resolve a token reference — a SYMBOL ("USDC") or a contract ADDRESS
-     * ("0x…") — to a full `ResolvedToken` on a given chain. The Pantograph search
-     * endpoint and wallet balances both key on either, so a single path handles
-     * both: callers no longer need to special-case address vs symbol.
-     *
-     * 1. Connected wallet's balances (most reliable — the user actually holds it).
-     * 2. Pantograph token search (fallback).
-     *
-     * Matching: when `key` is an address we match on `token_address`; otherwise on
-     * `symbol`. Returns undefined when moralis is not configured or nothing
-     * matches — callers decide whether to error or leave the field blank.
-     *
-     * Mirrors the pattern in TokenScoreTool / TokenAnalyticsTool / TokenHoldersTool.
-     */
-    protected resolveContractAddress(key: string, chain?: string, walletAddress?: string): Promise<ResolvedToken | undefined>;
-    /** Parse a decimals arg (number or numeric string) → integer, or undefined. */
-    protected parseDecimals(value: unknown): number | undefined;
-    /**
-     * Shared token-resolution for any tool that accepts a `contract_address` +
-     * `token_symbol` (+ optional `decimals`) pair. Handles the common flow once:
-     *
-     *  - A valid address in `contractArg` is used directly (and still enriched
-     *    with symbol/decimals via lookup when possible).
-     *  - Otherwise the address OR symbol in `contractArg`/`symbolArg` is resolved
-     *    through {@link resolveContractAddress} (which now matches either).
-     *  - Returns `{ token: undefined }` when nothing was supplied — the caller
-     *    decides whether that's a picker, an error, or a blank form field.
-     *  - Returns `{ error: 'token_not_found' }` when a ref was given but could
-     *    not be resolved on this chain.
-     *
-     * `decimalsArg` (if a valid integer) always wins over the looked-up decimals.
-     */
-    protected resolveTokenRef(input: {
-        contractArg?: unknown;
-        symbolArg?: unknown;
-        decimalsArg?: unknown;
-        chain?: string;
-        walletAddress?: string;
-    }): Promise<{
-        token?: ResolvedToken;
-    } | {
-        error: 'token_not_found';
-        key: string;
-    }>;
-    /**
-     * Build the parameters map for this action. Possible return shapes:
-     *  - `Record<string, string>` — open the form pre-filled with these params.
-     *  - `{ error, _instructions, … }` — abort; the LLM surfaces the error.
-     *  - `{ actionButtons: SuggestedAction[], _instructions?, message? }` — do
-     *    NOT open the form; instead emit clickable buttons (e.g. token picker
-     *    when the user said "send token" without naming one). The agent's
-     *    answer is the `_instructions` text — kept short, addressed to the user.
-     *  - `{ ui: UIPayload, _instructions?, … }` — bypass the default form UI
-     *    payload; emit a custom one (e.g. a swap-preview component). The base
-     *    forwards `ui` as-is to AgentCore.uiActions.
-     */
-    protected abstract buildParameters(args: Record<string, unknown>, userContext?: UserContext): Promise<Record<string, string> | {
-        error: string;
-        _instructions?: string;
-        [k: string]: unknown;
-    } | {
-        actionButtons: SuggestedAction[];
-        _instructions?: string;
-        message?: string;
-        [k: string]: unknown;
-    } | {
-        ui: UIPayload;
-        _instructions?: string;
-        [k: string]: unknown;
-    }>;
-    protected requireWallet(userContext?: UserContext): {
-        ok: true;
-        address: string;
-    } | {
-        ok: false;
-        payload: unknown;
-    };
-    protected requireChain(args: Record<string, unknown>, userContext?: UserContext): string | null;
-    protected normaliseAddress(value: unknown): string | null;
-    protected normaliseAmount(value: unknown): string | null;
-    /**
-     * Resolve a user-supplied amount that may be a plain token amount ("100"), a
-     * PERCENT of the held balance ("50%"), or a USD value ("5$"). Plain amounts
-     * pass straight through; percent/usd need the token's balance + USD price,
-     * read here from the wallet's balances in one call (works for an ERC-20
-     * address or the `'native'` sentinel).
-     *
-     * Returns:
-     *   - `{ amount }`  — concrete token amount string (plain decimal).
-     *   - `null`        — no amount was given (empty/invalid) → caller leaves it blank.
-     *   - `{ error, _instructions }` — a percent/usd was given but we couldn't get
-     *     the balance/price needed to convert it; caller surfaces the message.
-     */
-    protected resolveAmountInput(input: {
-        rawAmount: unknown;
-        tokenAddress: string;
-        symbol?: string;
-        chain?: string;
-        walletAddress?: string;
-        /**
-         * When set AND `tokenAddress` is the native coin, the amount is sized off the
-         * SPENDABLE balance (`balance − gasReserve`) instead of the raw balance, so a
-         * percent ("100%") never leaves the user unable to pay gas, and a plain amount
-         * that exceeds spendable is rejected. The reserve is estimated silently and
-         * never surfaced — the user only ever sees the spendable figure. Omit for
-         * ERC-20 spends (gas is paid in the native coin, not the token).
-         */
-        gasKind?: NativeActionKind;
-    }): Promise<{
-        amount: string;
-    } | {
-        error: string;
-        _instructions: string;
-    } | null>;
-    /**
-     * Spendable native balance (`held − gasReserve`) in human token units, given a
-     * balance already read from the wallet. Silently falls back to the full balance
-     * when the gas price / chain decimals can't be resolved. See {@link gasReserve}.
-     */
-    protected computeNativeSpendable(chain: string, gasKind: NativeActionKind, balanceNum: number): Promise<number>;
-    /**
-     * Resolve the SPENDABLE native balance for the form card as a plain-decimal
-     * STRING (`held − gasReserve`). Returns undefined when the wallet's native
-     * balance can't be read — the FE then falls back to the raw balance it already
-     * fetches for itself. Best-effort and silent; never throws.
-     */
-    protected resolveNativeSpendableFormatted(chain: string | undefined, walletAddress: string | undefined, gasKind: NativeActionKind): Promise<string | undefined>;
-    /**
-     * Read a single token's held balance + USD price from the connected wallet's
-     * balances (one Moralis call). `tokenAddress` may be an ERC-20 address or the
-     * `'native'` sentinel. Returns `undefined` when balances can't be read or the
-     * token isn't held; `balance`/`usdPrice` are individually `undefined` when the
-     * source omits them.
-     */
-    protected readTokenBalanceAndPrice(tokenAddress: string, chain?: string, walletAddress?: string): Promise<{
-        balance?: number;
-        usdPrice?: number;
-        balanceFormatted?: string;
-        symbol?: string;
-    } | undefined>;
-    /**
-     * Sanitize an amount STRING from an external source (e.g. Moralis
-     * `balance_formatted`): expand e-notation to a plain decimal; otherwise pass
-     * the original string through unchanged so we never lose precision by
-     * round-tripping a large/precise balance through `Number`.
-     */
-    protected cleanAmountString(s: string): string;
-    /** Format a number as a plain decimal string, expanding any e-notation. */
-    protected toPlainDecimal(n: number): string;
-    /**
-     * Override `execute` so the `ui` payload we return from `run()` is lifted
-     * onto the ToolResult envelope (BaseTool only copies `data`).
-     */
-    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
-    protected run(args: Record<string, unknown>, userContext?: UserContext): Promise<unknown>;
-}
-//# sourceMappingURL=BaseWalletActionTool.d.ts.map

package/dist/tools/builtin/wallet-action/BaseWalletActionTool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BaseWalletActionTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/builtin/wallet-action/BaseWalletActionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAqB,MAAM,kCAAkC,CAAC;AAGhH,OAAO,EAAgD,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,KAAK,EACV,eAAe,EACf,QAAQ,EACR,UAAU,EACV,SAAS,EACT,WAAW,EAEX,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,8BAAsB,oBAAqB,SAAQ,QAAQ;IACzD,IAAI,EAAE,QAAQ,CAAY;IAC1B,QAAQ,SAAmB;IAG3B,aAAa,UAAQ;IAErB,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACzD,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE9C;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAM;IAE3G;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;gBAEhC,MAAM,CAAC,EAAE,oBAAoB;IAOzC;;;;;;;;;;;;;;OAcG;cACa,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAuCrC,+EAA+E;IAC/E,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAS3D;;;;;;;;;;;;;;OAcG;cACa,eAAe,CAAC,KAAK,EAAE;QACrC,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC;QAAE,KAAK,CAAC,EAAE,aAAa,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,iBAAiB,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAsClF;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAC/D;QAAE,aAAa,EAAE,eAAe,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GACpG;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAClE;IAED,SAAS,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE;IAenH,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAQ/F,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAMzD,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IASxD;;;;;;;;;;;;OAYG;cACa,kBAAkB,CAAC,KAAK,EAAE;QACxC,SAAS,EAAE,OAAO,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;;;;WAOG;QACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;KAC5B,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA+DjF;;;;OAIG;cACa,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAKlB;;;;;OAKG;cACa,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAY9B;;;;;;OAMG;cACa,wBAAwB,CACtC,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAyB3G;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAM9C,2EAA2E;IAC3E,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAwB3C;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;cAkC5E,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW;CAqH7E"}