keyring-agent-core 0.2.6 → 0.2.8

package/README.md

@@ -31,17 +31,12 @@ User Message
 ```
 
 ### Key patterns
+
 - **Plan → Task → Get Data → Answer**: The Planner creates a structured execution plan; the Executor runs tools and gathers data; the Synthesizer produces the answer.
 - **ReAct (Reason + Act)**: The Executor uses a Think → Act → Observe loop, allowing multi-step reasoning with tool calls.
 - **Multi-agent**: Planner, Executor, and Synthesizer are independent agents, each with specialised system prompts.
 - **Conversation memory**: Automatic chat history management with LLM-based summarisation when the conversation grows too long.
 
-## Installation
-
-```bash
-npm install keyring-agent-core @google/generative-ai
-```
-
 ## Quick Start
 
 ```typescript
@@ -117,6 +112,7 @@ Each tool is **independent** — add or remove tools without affecting others.
 ## Chat History & Summarisation
 
 The agent automatically manages conversation history:
+
 - Messages are stored in a `ChatHistory` instance
 - When the history exceeds `maxHistoryMessages`, it is automatically summarised using the LLM and compacted
 - You can persist/restore history:
@@ -135,17 +131,17 @@ agent.restoreHistory(saved);
 
 ### `AgentCore`
 
-| Method | Description |
-|---|---|
-| `chat(message: string)` | Process a user message and get an answer |
-| `registerTool(tool)` | Register a tool |
-| `registerTools(tools)` | Register multiple tools |
-| `unregisterTool(name)` | Remove a tool |
-| `listTools()` | List registered tool names |
-| `getHistory()` | Get full conversation history |
-| `clearHistory()` | Clear conversation history |
-| `serialiseHistory()` | Serialise history for persistence |
-| `restoreHistory(messages)` | Restore history from saved data |
+| Method                     | Description                              |
+| -------------------------- | ---------------------------------------- |
+| `chat(message: string)`    | Process a user message and get an answer |
+| `registerTool(tool)`       | Register a tool                          |
+| `registerTools(tools)`     | Register multiple tools                  |
+| `unregisterTool(name)`     | Remove a tool                            |
+| `listTools()`              | List registered tool names               |
+| `getHistory()`             | Get full conversation history            |
+| `clearHistory()`           | Clear conversation history               |
+| `serialiseHistory()`       | Serialise history for persistence        |
+| `restoreHistory(messages)` | Restore history from saved data          |
 
 ### `AgentConfig`
 

package/dist/index.d.ts

@@ -448,6 +448,43 @@ declare class PoolService {
     _keccak(hex: string): string;
 }
 
+/**
+ * Canonical hex ids of every chain this core CAN support (EVM only). This is the
+ * immutable CATALOG; the ACTIVE set may be narrowed at runtime via
+ * {@link configureSupportedChains} and can only ever be a subset of this.
+ */
+declare const SUPPORTED_CHAINS: readonly ["0x1", "0xa", "0x38", "0x89", "0x2105", "0xa4b1", "0xa86a", "0xe708"];
+/** Canonical hex id of a built-in chain (the immutable catalog), e.g. "0x2105". */
+type SupportedChainId = (typeof SUPPORTED_CHAINS)[number];
+/** Human-readable name of a built-in chain — the other accepted selector form. */
+type SupportedChainName = 'ethereum' | 'optimism' | 'bsc' | 'polygon' | 'base' | 'arbitrum' | 'avalanche' | 'linea';
+/**
+ * Any identifier accepted where a built-in chain must be named (e.g.
+ * {@link configureSupportedChains} / `AgentConfig.excludeChains`): the canonical
+ * hex id OR its human name. Decimal ids ("10") still resolve at runtime but are
+ * intentionally left out of the type so editor autocomplete stays clean and
+ * typos are caught at compile time.
+ */
+type ChainSelector = SupportedChainId | SupportedChainName;
+/** Preferred default if still active, otherwise the first remaining active chain. */
+declare let DEFAULT_CHAIN: string;
+/** Human-readable list of ACTIVE supported chains, for user-facing messages. */
+declare let SUPPORTED_CHAINS_LABEL: string;
+/**
+ * Narrow the ACTIVE supported-chain set by REMOVING the given chains from the
+ * catalog. You can only ever remove — the active set is always a subset of
+ * {@link SUPPORTED_CHAINS}. Guards (per design):
+ *   - entries that aren't a catalog chain (unknown id/name, non-EVM) are ignored;
+ *   - an exclude list that would remove EVERY chain is ignored (the set is left
+ *     at the full catalog) — we never produce an empty supported set;
+ *   - if the preferred default (Ethereum) is removed, {@link DEFAULT_CHAIN} falls
+ *     back to the first still-active chain.
+ *
+ * Call once at startup (AgentCore does this from `config.excludeChains`). Updates
+ * every resolver plus the exported `DEFAULT_CHAIN` / `SUPPORTED_CHAINS_LABEL`.
+ */
+declare function configureSupportedChains(exclude?: Iterable<ChainSelector>): void;
+
 /** Role inside a conversation */
 type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
 /** A single message in the conversation */
@@ -688,7 +725,7 @@ interface AddLiquidityFormProps {
     /** CoinPool gateway contract address on this chain */
     gatewayAddress: string;
 }
-type WalletActionType = 'send_native' | 'send_token' | 'approve_token' | 'wrap_native' | 'unwrap_native';
+type WalletActionType = 'send_native' | 'send_token' | 'approve_token' | 'send_nft';
 /**
  * Common envelope every wallet-action tool returns as its UI payload `props`.
  * The FE renders the form keyed by `action`, pre-fills inputs from `parameters`,
@@ -1064,6 +1101,15 @@ interface AgentConfig {
      * built-in public default for that chain.
      */
     rpcUrls?: Record<string, string>;
+    /**
+     * Restrict which of the built-in supported chains are active by REMOVING the
+     * listed ones. Each entry is a {@link ChainSelector} — the chain's canonical
+     * hex id ("0xa") or its human name ("optimism") — so typos are caught at
+     * compile time. You can ONLY remove chains from the built-in set; a list
+     * covering every chain is ignored (the full set is kept). Omit to keep all
+     * built-in chains enabled.
+     */
+    excludeChains?: ChainSelector[];
     /** Maximum number of ReAct iterations before forcing an answer */
     maxIterations?: number;
     /** Maximum number of messages to keep in history before summarising */
@@ -1192,9 +1238,9 @@ interface AgentConfig {
         isProduction?: boolean;
     } | false;
     /**
-     * Website link for the NFT tools (`send-nft` and the nft-agent data tools:
-     * `get-wallet-nfts`, `get-nft-metadata`, `get-nft-contract-info`). Supplied
-     * at AgentCore construction.
+     * Website link for the NFT notice tools (`get-wallet-nfts`,
+     * `get-nft-metadata`, `get-nft-contract-info`). Supplied at AgentCore
+     * construction.
      *
      * Each tool emits a fixed message containing the phrase "this website". When
      * this URL is set, that phrase is rendered as a Markdown link to it; when
@@ -1692,7 +1738,7 @@ declare function createWalletAgent(llm: LLMProvider, registry: ToolRegistry, opt
 declare const TOKEN_AGENT_TOOL_NAMES: readonly ["get-token-info", "get-token-holders", "get-token-analytics", "get-token-score", "get-trending-tokens", "get-top-gainers", "gemini-search-ai"];
 declare function createTokenAgent(llm: LLMProvider, registry: ToolRegistry, options?: SubagentOptions): Subagent;
 
-declare const NFT_AGENT_TOOL_NAMES: readonly ["get-wallet-nfts", "get-nft-metadata", "get-nft-contract-info", "send-nft", "gemini-search-ai"];
+declare const NFT_AGENT_TOOL_NAMES: readonly ["get-wallet-nfts", "get-nft-metadata", "get-nft-contract-info", "open-send-nft-form", "gemini-search-ai"];
 declare function createNftAgent(llm: LLMProvider, registry: ToolRegistry, options?: SubagentOptions): Subagent;
 
 declare const AI_AGENT_TOOL_NAMES: readonly ["gemini-search-ai"];
@@ -3370,7 +3416,7 @@ type TopGainersToolConfig = MoralisServiceConfig;
  * Queries Pantograph's `GET /token-list/top-gainers/{chain}?duration=…` — the
  * tokens with the largest USD price increase over a chosen window. Single-chain
  * (Pantograph has no cross-chain feed); defaults to the connected chain, then
- * Base. Returns the canonical trending-token shape: price, market cap, 24h
+ * Ethereum. Returns the canonical trending-token shape: price, market cap, 24h
  * volume, and the price change over the selected window.
  */
 declare class TopGainersTool extends BaseTool {
@@ -3423,7 +3469,7 @@ declare class WalletTokenBalancesTool extends BaseTool {
         walletAddress: string;
         chain: string;
         tokenCount: number;
-        tokens: TokenBalance[];
+        tokens: string[];
         totalUsdValue: number;
         error?: undefined;
     }>;
@@ -4115,8 +4161,8 @@ interface NftMessageToolConfig {
     url?: string;
 }
 /**
- * Shared base for the canned-message NFT notice tools (`send-nft`,
- * `get-wallet-nfts`, `get-nft-metadata`, `get-nft-contract-info`).
+ * Shared base for the canned-message NFT notice tools (`get-wallet-nfts`,
+ * `get-nft-metadata`, `get-nft-contract-info`).
  *
  * Each tool emits one fixed sentence that points the user at a website. The
  * phrase "this website" is rendered as a Markdown link to `config.url` when one
@@ -4139,19 +4185,6 @@ declare abstract class BaseNftMessageTool extends BaseTool {
     protected run(): Promise<unknown>;
 }
 
-/**
- * Tool: send-nft
- *
- * Points the user to the website to send/transfer an NFT. Emits a fixed
- * message; "this website" links to the configured `nftLink` URL when one is
- * set, otherwise it stays plain text.
- */
-declare class SendNftTool extends BaseNftMessageTool {
-    name: string;
-    description: string;
-    protected readonly template = "Please select the NFT you would like to send from the list and proceed via {link}.";
-}
-
 type WalletNFTsToolConfig = NftMessageToolConfig;
 /**
  * Tool: get-wallet-nfts
@@ -5421,7 +5454,6 @@ declare class SubgraphCoinPoolPairsTool extends BaseTool {
  * is `balance − gasReserve`, where `gasReserve = gasLimit × gasPrice`:
  *
  *   - send native: gasLimit 30_000  (a plain value transfer).
- *   - wrap native: gasLimit 40_000  (a WETH deposit() call).
  *   - buy / swap:  gasLimit 1_000_000 (a router call + possible approval).
  *
  * The gas price is read live via `eth_gasPrice` against the chain's RPC (a
@@ -5434,8 +5466,6 @@ declare class SubgraphCoinPoolPairsTool extends BaseTool {
 /** Gas limits per native action kind (matches the FE's tx builders). */
 declare const NATIVE_GAS_LIMIT: {
     readonly send: 30000n;
-    /** wrap native → wrapped ERC-20 via the WETH-style `deposit()` payable call. */
-    readonly wrap: 40000n;
     /** buy and swap both go through a router call (+ possible approval). */
     readonly swap: 1000000n;
 };
@@ -5768,45 +5798,6 @@ declare class ApproveTokenTool extends BaseWalletActionTool {
     protected buildParameters(args: Record<string, unknown>, userContext?: UserContext): Promise<Record<string, string>>;
 }
 
-/**
- * Tool: open-wrap-native-form
- *
- * Opens the WRAP NATIVE form (e.g. ETH → WETH, BNB → WBNB).
- */
-declare class WrapNativeTool extends BaseWalletActionTool {
-    name: string;
-    protected readonly actionType: WalletActionType;
-    protected readonly component = "WrapNativeForm";
-    protected readonly userInputFields: readonly [{
-        readonly key: "amount";
-        readonly label: "the amount to wrap";
-    }];
-    description: string;
-    parameters: ToolParameter[];
-    protected buildParameters(args: Record<string, unknown>, userContext?: UserContext): Promise<Record<string, string> | {
-        error: string;
-        _instructions: string;
-    }>;
-}
-
-/**
- * Tool: open-unwrap-native-form
- *
- * Opens the UNWRAP NATIVE form (WETH → ETH, WBNB → BNB, …).
- */
-declare class UnwrapNativeTool extends BaseWalletActionTool {
-    name: string;
-    protected readonly actionType: WalletActionType;
-    protected readonly component = "UnwrapNativeForm";
-    protected readonly userInputFields: readonly [{
-        readonly key: "amount";
-        readonly label: "the amount to unwrap";
-    }];
-    description: string;
-    parameters: ToolParameter[];
-    protected buildParameters(args: Record<string, unknown>, _userContext?: UserContext): Promise<Record<string, string>>;
-}
-
 /**
  * Tool: open-buy-token-form
  *
@@ -6288,11 +6279,61 @@ declare class SwapTokenTool extends BaseTool {
     private formatPrice;
 }
 
+/** Optional NFT website link, shown when more than one owned NFT matches. */
+interface SendNftToolConfig {
+    url?: string;
+}
+/**
+ * Tool: open-send-nft-form
+ *
+ * Resolves a "send NFT" intent and asks the FE to render its `SendNftForm`.
+ * Mirrors the chatbot SDK's `send_nft` schema:
+ *   { contract_address, token_id, to_address, token_standard, amount, maxAmount, nft_name }
+ *
+ * Resolution rules (in order):
+ *  - No identifier at all → emit a fixed "no NFT specified" notice.
+ *  - contract_address + token_id → confirm ownership; emit form (image + name +
+ *    token_standard + maxAmount come from the wallet row). Not held → error.
+ *  - contract_address only → list the user's holdings in that collection.
+ *      • 0 → error  • 1 → form  • >1 → website notice.
+ *  - token_id only → list all owned NFTs whose token_id matches.
+ *      • 0 → error  • 1 → form  • >1 → website notice.
+ *  - nft_name only → fuzzy-match against owned NFTs' names.
+ *      • 0 → error  • 1 → form  • >1 → website notice.
+ *
+ * When more than one owned NFT matches we cannot safely pick one for the user,
+ * so we return a fixed notice pointing them to the NFT website (Markdown link
+ * when `url` is configured, plain text otherwise) — matching the pattern used
+ * by the other NFT notice tools.
+ */
+declare class SendNftTool extends BaseWalletActionTool {
+    name: string;
+    protected readonly actionType: WalletActionType;
+    protected readonly component = "SendNftForm";
+    protected readonly userInputFields: readonly [{
+        readonly key: "to_address";
+        readonly label: "the recipient address";
+    }];
+    /** Resolved (trimmed) NFT website URL, used when >1 owned NFTs match. */
+    private readonly url?;
+    constructor(config?: MoralisServiceConfig, options?: SendNftToolConfig);
+    description: string;
+    parameters: ToolParameter[];
+    protected buildParameters(args: Record<string, unknown>, userContext?: UserContext): Promise<Record<string, string>>;
+    private normaliseString;
+    private normaliseTokenId;
+    private normaliseAmountInt;
+    private nftDisplayName;
+    private matchNfts;
+    private paramsFromInputs;
+    private paramsFromNft;
+}
+
 /**
  * Shared JSON-RPC client + default public RPC endpoints.
  *
- * Kept dependency-free (no imports from PoolService / swap) so both
- * `PoolService` and the swap adapters can use it without a circular import.
+ * Kept free of PoolService / swap imports so both `PoolService` and the swap
+ * adapters can use it without a circular import.
  */
 /** Default public RPC endpoint per hex chain id. Single source of truth. */
 declare const DEFAULT_RPC_BY_CHAIN: Record<string, string>;
@@ -6386,7 +6427,7 @@ declare class PantographService {
      * `tokenAddress` work unchanged.
      *
      * Pantograph scopes results to a single chain (it has no cross-chain feed),
-     * so when no `chain` is given we fall back to Base ("0x2105").
+     * so when no `chain` is given we fall back to {@link DEFAULT_CHAIN} (Ethereum).
      */
     getTrendingTokens(params?: {
         chain?: string;
@@ -6410,7 +6451,7 @@ declare class PantographService {
      * returned in the canonical {@link TrendingToken} shape.
      *
      * Pantograph scopes results to a single chain (no cross-chain feed), so when
-     * no `chain` is given we fall back to Base ("0x2105").
+     * no `chain` is given we fall back to {@link DEFAULT_CHAIN} (Ethereum).
      *
      * `duration` accepts Pantograph windows: "1h", "24h", "7d", "30d".
      */
@@ -6689,4 +6730,4 @@ declare class Summarizer {
     summarize(messages: ChatMessage[]): Promise<string>;
 }
 
-export { AI_AGENT_TOOL_NAMES, type AddLiquidityFormProps, type AddLiquiditySummary, type AffiliateFee, type AgentConfig, AgentCore, type AgentResponse, ApproveTokenTool, BaseNftMessageTool, BaseSwapService, BaseTool, BaseWalletActionTool, type BuyTokenConfirmTxProps, type BuyTokenSide, BuyTokenTool, type ChainMeta, type ChainRef, ChatHistory, type ChatMessage, type ChatOptions, type ChatRole, type CheckApprovalParams, type CheckApprovalResult, type ConfirmAddLiquidityTxProps, type CortexResponse, DEFAULT_PROVIDER, DEFAULT_RPC_BY_CHAIN, DebridgeAdapter, type DecodedCall, type DecodedEvent, type DecodedParam, type DefaultSubagentName, type DefiPosition, type DefiPositionDetails, type DefiPositionToken, type DefiProtocolSummary, EstimatePoolYieldTool, type EstimatePoolYieldToolConfig, type ExchangeProviderConfig, type ExecuteSwapParams, type ExecuteSwapResult, GeminiProvider, GeminiSearchAiTool, type GeminiSearchAiToolConfig, HEX_TO_PANTOGRAPH, type HolderChangePeriod, type HolderSupplyTier, type IngestKnowledgeBaseInput, type IngestKnowledgeBaseResult, type InputTokenInfo, type KBSearchResult, KnowledgeBase, type KnowledgeBaseEntry, type KnowledgeBaseProvider, type LLMProvider, type LLMProviderConfig, type LLMResponse, type LLMToolCall, type MoralisApiResponse, MoralisService, type MoralisServiceConfig, NFTContractInfoTool, type NFTContractInfoToolConfig, type NFTContractMetadata, type NFTItem, type NFTLastSale, type NFTMetadata, NFTMetadataTool, type NFTMetadataToolConfig, NFT_AGENT_TOOL_NAMES, type NativeTokenInfo, type NftMessageToolConfig, type NftTransferLastSale, OpenAddLiquidityFormTool, type OpenAddLiquidityFormToolConfig, POOL_AGENT_TOOL_NAMES, PantographService, type PantographServiceConfig, type PaymentToken, PoolByAddressTool, type PoolByAddressToolConfig, PoolDetailTool, type PoolDetailToolConfig, type PoolDisplayInfo, type PoolOnchainInfo, PoolSearchTool, type PoolSearchToolConfig, PoolService, type PoolServiceConfig, type PresetInputs, PreviewAddLiquidityTool, type PreviewAddLiquidityToolConfig, type PriceBounds, type PriceRangePrefill, type ProviderName, type QuickRate, type RangePreset, type ReActPhase, type ReActStep, type ReActTrace, RelayAdapter, type ResolvedRange, Router, type RouterAssignment, type RouterDecision, SWAP_PROVIDER_CONFIG, SendNativeTool, SendNftTool, SendTokenTool, type StorageProvider, Subagent, type SubagentCard, type SubagentOptions, type SubagentParams, type SubagentResult, type SubagentTask, type SubagentToggles, SubgraphCoinPoolPairsTool, type SubgraphCoinPoolPairsToolConfig, SubgraphPoolByAddressTool, type SubgraphPoolByAddressToolConfig, SubgraphPoolByPositionIdTool, type SubgraphPoolByPositionIdToolConfig, SubgraphPoolSearchTool, type SubgraphPoolSearchToolConfig, SubgraphPositionDetailTool, type SubgraphPositionDetailToolConfig, SubgraphTrendingPoolsTool, type SubgraphTrendingPoolsToolConfig, type SuggestedAction, Summarizer, type SwapQuoteParams, type SwapQuoteResult, type SwapServiceConfig, SwapServiceFactory, type SwapTokenConfirmTxProps, SwapTokenTool, type SwapTxData, Synthesizer, TOKEN_AGENT_TOOL_NAMES, TRANSFER_TOPIC, TRENDING_DEFAULT_BY_HEX_CHAIN, type TokenAnalyticsResponse, type TokenAnalyticsTimeframeBuckets, TokenAnalyticsTool, type TokenAnalyticsToolConfig, type TokenApproval, type TokenApprovalSpender, type TokenApprovalToken, type TokenBalance, type TokenDisplay, type TokenHoldersResponse, TokenHoldersTool, type TokenHoldersToolConfig, TokenInfoTool, type TokenInfoToolConfig, type TokenMetadata, type TokenScoreMetrics, type TokenScoreResponse, type TokenScoreSupply, type TokenScoreTimeframeBuckets, TokenScoreTool, type TokenScoreToolConfig, type Tool, type ToolDefinition, type ToolKind, type ToolParameter, ToolRegistry, type ToolResult, type TopGainerTimeFrames, type TopGainerToken, type TopGainersTimeFrame, TopGainersTool, type TopGainersToolConfig, TopPoolsTool, type TopPoolsToolConfig, type TrackStatus, type TrackTransactionParams, type TrackTransactionResult, type TransactionByHashResponse, TransactionByHashTool, type TransactionByHashToolConfig, type TransactionLog, type TransactionReceipt, type TransactionReceiptLog, type TrendingToken, type TrendingTokenTimeframeBuckets, TrendingTokensTool, type TrendingTokensToolConfig, type UIPayload, UNISWAP_CHAIN_SLUG, type UnsignedTx, UnwrapNativeTool, type UpstashEmbedStrategy, type UpstashFusionAlgorithm, type UpstashKBUpsertEntry, UpstashKnowledgeBase, type UpstashKnowledgeBaseConfig, type UserContext, type VectorKBConfig, WALLET_ACTION_AGENT_TOOL_NAMES, WALLET_AGENT_TOOL_NAMES, type WalletActionProps, type WalletActionType, type WalletApprovalsResponse, WalletApprovalsTool, type WalletApprovalsToolConfig, type WalletDefiPositionSummary, WalletDefiPositionsTool, type WalletDefiPositionsToolConfig, type WalletDefiPositionsV1Response, type WalletDefiProtocolPositionsResponse, WalletDefiProtocolPositionsTool, type WalletDefiProtocolPositionsToolConfig, type WalletDefiProtocolPositionsV1Response, type WalletDefiSummaryResponse, WalletDefiSummaryTool, type WalletDefiSummaryToolConfig, type WalletHistoryCategory, type WalletHistoryContractInteraction, type WalletHistoryErc20Transfer, type WalletHistoryItem, type WalletHistoryNativeTransfer, type WalletHistoryNftTransfer, type WalletHistoryResponse, WalletHistoryTool, type WalletHistoryToolConfig, WalletNFTsTool, type WalletNFTsToolConfig, type WalletNetWorthChainBreakdown, type WalletNetWorthResponse, WalletNetWorthTool, type WalletNetWorthToolConfig, type WalletNetWorthUnavailableChain, type WalletNftTransferItem, type WalletNftTransfersResponse, WalletNftTransfersTool, type WalletNftTransfersToolConfig, type WalletPnlDaysWindow, type WalletPnlResponse, type WalletPnlSummaryResponse, WalletPnlSummaryTool, type WalletPnlSummaryToolConfig, type WalletPnlTokenItem, WalletPnlTool, type WalletPnlToolConfig, WalletTokenBalancesTool, type WalletTokenBalancesToolConfig, type WalletTokenTransferItem, type WalletTokenTransfersResponse, WalletTokenTransfersTool, type WalletTokenTransfersToolConfig, WrapNativeTool, ZERO_ADDRESS, buildRangePresets, buildUniswapPoolUrl, clampTick, createAiAgent, createDefaultSubagents, createNftAgent, createPoolAgent, createTokenAgent, createWalletActionAgent, createWalletAgent, ethCallAt, ethCallByChain, getAffiliateFee, getChainMeta, getDefaultRpcUrl, getGatewayAddress, getNativeTokenInfo, getPositionManagerAddress, getProviderByChain, ingestKnowledgeBase, priceToTick, resolveRpcUrl, roundTickToSpacing, rpcCall, setRpcOverrides, swapServiceFactory, tickToPrice, toPantographChain };
+export { AI_AGENT_TOOL_NAMES, type AddLiquidityFormProps, type AddLiquiditySummary, type AffiliateFee, type AgentConfig, AgentCore, type AgentResponse, ApproveTokenTool, BaseNftMessageTool, BaseSwapService, BaseTool, BaseWalletActionTool, type BuyTokenConfirmTxProps, type BuyTokenSide, BuyTokenTool, type ChainMeta, type ChainRef, type ChainSelector, ChatHistory, type ChatMessage, type ChatOptions, type ChatRole, type CheckApprovalParams, type CheckApprovalResult, type ConfirmAddLiquidityTxProps, type CortexResponse, DEFAULT_CHAIN, DEFAULT_PROVIDER, DEFAULT_RPC_BY_CHAIN, DebridgeAdapter, type DecodedCall, type DecodedEvent, type DecodedParam, type DefaultSubagentName, type DefiPosition, type DefiPositionDetails, type DefiPositionToken, type DefiProtocolSummary, EstimatePoolYieldTool, type EstimatePoolYieldToolConfig, type ExchangeProviderConfig, type ExecuteSwapParams, type ExecuteSwapResult, GeminiProvider, GeminiSearchAiTool, type GeminiSearchAiToolConfig, HEX_TO_PANTOGRAPH, type HolderChangePeriod, type HolderSupplyTier, type IngestKnowledgeBaseInput, type IngestKnowledgeBaseResult, type InputTokenInfo, type KBSearchResult, KnowledgeBase, type KnowledgeBaseEntry, type KnowledgeBaseProvider, type LLMProvider, type LLMProviderConfig, type LLMResponse, type LLMToolCall, type MoralisApiResponse, MoralisService, type MoralisServiceConfig, NFTContractInfoTool, type NFTContractInfoToolConfig, type NFTContractMetadata, type NFTItem, type NFTLastSale, type NFTMetadata, NFTMetadataTool, type NFTMetadataToolConfig, NFT_AGENT_TOOL_NAMES, type NativeTokenInfo, type NftMessageToolConfig, type NftTransferLastSale, OpenAddLiquidityFormTool, type OpenAddLiquidityFormToolConfig, POOL_AGENT_TOOL_NAMES, PantographService, type PantographServiceConfig, type PaymentToken, PoolByAddressTool, type PoolByAddressToolConfig, PoolDetailTool, type PoolDetailToolConfig, type PoolDisplayInfo, type PoolOnchainInfo, PoolSearchTool, type PoolSearchToolConfig, PoolService, type PoolServiceConfig, type PresetInputs, PreviewAddLiquidityTool, type PreviewAddLiquidityToolConfig, type PriceBounds, type PriceRangePrefill, type ProviderName, type QuickRate, type RangePreset, type ReActPhase, type ReActStep, type ReActTrace, RelayAdapter, type ResolvedRange, Router, type RouterAssignment, type RouterDecision, SUPPORTED_CHAINS, SUPPORTED_CHAINS_LABEL, SWAP_PROVIDER_CONFIG, SendNativeTool, SendNftTool, SendTokenTool, type StorageProvider, Subagent, type SubagentCard, type SubagentOptions, type SubagentParams, type SubagentResult, type SubagentTask, type SubagentToggles, SubgraphCoinPoolPairsTool, type SubgraphCoinPoolPairsToolConfig, SubgraphPoolByAddressTool, type SubgraphPoolByAddressToolConfig, SubgraphPoolByPositionIdTool, type SubgraphPoolByPositionIdToolConfig, SubgraphPoolSearchTool, type SubgraphPoolSearchToolConfig, SubgraphPositionDetailTool, type SubgraphPositionDetailToolConfig, SubgraphTrendingPoolsTool, type SubgraphTrendingPoolsToolConfig, type SuggestedAction, Summarizer, type SupportedChainId, type SupportedChainName, type SwapQuoteParams, type SwapQuoteResult, type SwapServiceConfig, SwapServiceFactory, type SwapTokenConfirmTxProps, SwapTokenTool, type SwapTxData, Synthesizer, TOKEN_AGENT_TOOL_NAMES, TRANSFER_TOPIC, TRENDING_DEFAULT_BY_HEX_CHAIN, type TokenAnalyticsResponse, type TokenAnalyticsTimeframeBuckets, TokenAnalyticsTool, type TokenAnalyticsToolConfig, type TokenApproval, type TokenApprovalSpender, type TokenApprovalToken, type TokenBalance, type TokenDisplay, type TokenHoldersResponse, TokenHoldersTool, type TokenHoldersToolConfig, TokenInfoTool, type TokenInfoToolConfig, type TokenMetadata, type TokenScoreMetrics, type TokenScoreResponse, type TokenScoreSupply, type TokenScoreTimeframeBuckets, TokenScoreTool, type TokenScoreToolConfig, type Tool, type ToolDefinition, type ToolKind, type ToolParameter, ToolRegistry, type ToolResult, type TopGainerTimeFrames, type TopGainerToken, type TopGainersTimeFrame, TopGainersTool, type TopGainersToolConfig, TopPoolsTool, type TopPoolsToolConfig, type TrackStatus, type TrackTransactionParams, type TrackTransactionResult, type TransactionByHashResponse, TransactionByHashTool, type TransactionByHashToolConfig, type TransactionLog, type TransactionReceipt, type TransactionReceiptLog, type TrendingToken, type TrendingTokenTimeframeBuckets, TrendingTokensTool, type TrendingTokensToolConfig, type UIPayload, UNISWAP_CHAIN_SLUG, type UnsignedTx, type UpstashEmbedStrategy, type UpstashFusionAlgorithm, type UpstashKBUpsertEntry, UpstashKnowledgeBase, type UpstashKnowledgeBaseConfig, type UserContext, type VectorKBConfig, WALLET_ACTION_AGENT_TOOL_NAMES, WALLET_AGENT_TOOL_NAMES, type WalletActionProps, type WalletActionType, type WalletApprovalsResponse, WalletApprovalsTool, type WalletApprovalsToolConfig, type WalletDefiPositionSummary, WalletDefiPositionsTool, type WalletDefiPositionsToolConfig, type WalletDefiPositionsV1Response, type WalletDefiProtocolPositionsResponse, WalletDefiProtocolPositionsTool, type WalletDefiProtocolPositionsToolConfig, type WalletDefiProtocolPositionsV1Response, type WalletDefiSummaryResponse, WalletDefiSummaryTool, type WalletDefiSummaryToolConfig, type WalletHistoryCategory, type WalletHistoryContractInteraction, type WalletHistoryErc20Transfer, type WalletHistoryItem, type WalletHistoryNativeTransfer, type WalletHistoryNftTransfer, type WalletHistoryResponse, WalletHistoryTool, type WalletHistoryToolConfig, WalletNFTsTool, type WalletNFTsToolConfig, type WalletNetWorthChainBreakdown, type WalletNetWorthResponse, WalletNetWorthTool, type WalletNetWorthToolConfig, type WalletNetWorthUnavailableChain, type WalletNftTransferItem, type WalletNftTransfersResponse, WalletNftTransfersTool, type WalletNftTransfersToolConfig, type WalletPnlDaysWindow, type WalletPnlResponse, type WalletPnlSummaryResponse, WalletPnlSummaryTool, type WalletPnlSummaryToolConfig, type WalletPnlTokenItem, WalletPnlTool, type WalletPnlToolConfig, WalletTokenBalancesTool, type WalletTokenBalancesToolConfig, type WalletTokenTransferItem, type WalletTokenTransfersResponse, WalletTokenTransfersTool, type WalletTokenTransfersToolConfig, ZERO_ADDRESS, buildRangePresets, buildUniswapPoolUrl, clampTick, configureSupportedChains, createAiAgent, createDefaultSubagents, createNftAgent, createPoolAgent, createTokenAgent, createWalletActionAgent, createWalletAgent, ethCallAt, ethCallByChain, getAffiliateFee, getChainMeta, getDefaultRpcUrl, getGatewayAddress, getNativeTokenInfo, getPositionManagerAddress, getProviderByChain, ingestKnowledgeBase, priceToTick, resolveRpcUrl, roundTickToSpacing, rpcCall, setRpcOverrides, swapServiceFactory, tickToPrice, toPantographChain };