keyring-chatbot-agent 1.0.25 → 1.0.49

package/dist/lib.d.ts

@@ -1,10 +1,58 @@
+import { AgentConfig } from 'keyring-agent-core';
+import { AgentCore } from 'keyring-agent-core';
+import { AgentResponse } from 'keyring-agent-core';
+import { Chain } from 'viem/chains';
+import { CSSProperties } from 'react';
+import { Dispatch } from 'react';
 import { JSX } from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { SetStateAction } from 'react';
 
 export declare interface Account {
     address: string;
     chainId: number | string;
 }
 
+export declare const ActionForm: ({ action, initialValues, onSubmit, onCancel, isSubmitting, tokenInfo, nftInfo, disabled, language, validateGas, }: ActionFormProps) => JSX.Element | null;
+
+declare interface ActionFormProps {
+    action: AgentActionType;
+    disabled?: boolean;
+    initialValues: Record<string, string>;
+    onSubmit: (action: AgentActionType, values: Record<string, string>) => void;
+    onCancel: () => void;
+    isSubmitting?: boolean;
+    tokenInfo?: MessageTokenInfo;
+    nftInfo?: MessageNftInfo;
+    /** BCP-47 tag core stamped on this action; the form translates against it. */
+    language?: string;
+    /**
+     * Pre-flight check that the connected wallet has enough native balance to
+     * cover `gasLimit × gasPrice + value` for the tx that will be built from
+     * `values`. Called on submit BEFORE `onSubmit`. When `{ok:false}` is
+     * returned, the form shows `message` as an inline error above the submit
+     * button and does NOT proceed. Optional — when omitted, submit proceeds
+     * directly (a deeper check in the host stays as the safety net).
+     */
+    validateGas?: (values: Record<string, string>) => Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        message: string;
+    }>;
+}
+
+declare interface AddMessageOptions {
+    walletActions?: MessageWalletAction[];
+    actionButtons?: MessageActionButton[];
+}
+
+export declare type AgentActionType = 'send_native' | 'send_token' | 'swap_token' | 'approve_token' | 'wrap_native' | 'unwrap_native' | 'send_nft' | 'view_nfts' | 'view_balances' | 'check_balance' | 'token_info' | 'chat';
+
+export { AgentConfig }
+
+export { AgentResponse }
+
 export declare interface ChatUICustomization {
     chatTitle?: string;
     welcomeMessage?: string;
@@ -14,46 +62,7 @@ export declare interface ChatUICustomization {
     chatIcon?: string;
 }
 
-/**
- * `ChatWidget` is the main entry point for embedding the Keyring AI chat assistant
- * into your dApp. It renders a floating chat button that opens a full-featured
- * chat modal with AI-powered responses, token/NFT lookups, and on-chain transaction support.
- *
- * @example
- * ```tsx
- * import { ChatWidget } from '@keyringpro/chatbot-agent-sdk';
- *
- * function App() {
- *   const { account, sendTransaction } = useWallet(); // your wallet hook
- *
- *   return (
- *     <ChatWidget
- *       account={{ address: account.address, chainId: account.chainId }}
- *       onTransaction={sendTransaction}
- *       language="en"
- *       position="bottom-right"
- *       theme={{ primaryColor: '#6366f1', buttonSize: 56 }}
- *       rpcUrls={{ 1: 'https://mainnet.infura.io/v3/YOUR_KEY' }}
- *     />
- *   );
- * }
- * ```
- *
- * @param position   - Corner to anchor the widget. `'bottom-right'` (default) or `'bottom-left'`.
- * @param theme      - Visual customisation: `primaryColor` (hex/CSS), `buttonSize` (px), `zIndex`.
- * @param defaultOpen - If `true`, the chat modal is open on first render. Defaults to `false`.
- * @param onOpen     - Callback fired when the chat modal opens.
- * @param onClose    - Callback fired when the chat modal closes.
- * @param account    - Connected wallet info (`address` + `chainId`). Pass `undefined` when not connected.
- * @param onTransaction - **Required for on-chain actions.** Receives an unsigned transaction object
- *                        and must return a promise that resolves to `{ status, transactionHash?, error? }`.
- *                        The widget uses this to sign & broadcast swap / send transactions.
- * @param language   - UI language: `'en'` (English, default), `'ja'` (Japanese), `'cn'` (Chinese).
- * @param rpcUrls    - Optional map of `chainId → RPC URL`. When provided, these URLs take priority
- *                     over the built-in defaults for balance queries and fee estimation.
- *                     e.g. `{ 1: 'https://...', 137: 'https://...' }`
- */
-export declare const ChatWidget: ({ position, theme, defaultOpen, onOpen, onClose, account, onTransaction, language, rpcUrls, chatTitle, welcomeMessage, customSuggestions, additionalSuggestions, buttonIcon, chatIcon, customChatButton, styleButtonChat, }: ChatWidgetProps) => JSX.Element | null;
+export declare const ChatWidget: ({ position, theme, defaultOpen, onOpen, onClose, account, language, rpcUrls, chatTitle, welcomeMessage, customSuggestions, additionalSuggestions, buttonIcon, chatIcon, customChatButton, styleButtonChat, modalConfig, onTransaction, }: ChatWidgetProps) => JSX.Element | null;
 
 /** Alias kept for backwards-compatibility */
 export declare type ChatWidgetLanguage = Language;
@@ -65,7 +74,6 @@ export declare interface ChatWidgetProps {
     onOpen?: () => void;
     onClose?: () => void;
     account?: Account;
-    onTransaction?: (tx: Transaction) => Promise<TransactionResult>;
     language?: ChatWidgetLanguage;
     rpcUrls?: Record<number, string>;
     chatTitle?: string;
@@ -74,8 +82,19 @@ export declare interface ChatWidgetProps {
     additionalSuggestions?: SuggestionButtonConfig[];
     buttonIcon?: string;
     chatIcon?: string;
-    customChatButton?: React.ReactNode;
-    styleButtonChat?: React.CSSProperties;
+    customChatButton?: ReactNode;
+    styleButtonChat?: CSSProperties;
+    modalConfig?: {
+        isShowIcon?: boolean;
+    };
+    /**
+     * Invoked when the user confirms an `ActionForm` or `BuyTokenConfirmTx`. The
+     * widget hands over the unsigned tx `{from, to, data, value, chainId}`; the
+     * host signs and broadcasts, then returns
+     * `{status, transactionHash?, error?}`. Required for send / approve /
+     * wrap / unwrap / send_nft / buy.
+     */
+    onTransaction?: (tx: Transaction) => Promise<TransactionResult>;
 }
 
 export declare interface ChatWidgetTheme {
@@ -101,29 +120,314 @@ export declare interface Config {
     [key: string]: unknown;
 }
 
+declare interface ConfigContextValue {
+    config: Config | null;
+}
+
+export declare const ConfigProvider: ({ children, initialConfig, }: ConfigProviderProps) => JSX.Element;
+
+declare interface ConfigProviderProps {
+    children: React.ReactNode;
+    initialConfig?: Config;
+}
+
+declare interface ConnectContextDerived extends ConnectContextValue {
+    chainData: IChainData | undefined;
+    chainId: number | string | undefined;
+    chainType: string;
+    chainTypeMoralis: string;
+    isChainSupported: boolean;
+}
+
+declare interface ConnectContextValue {
+    account: Account | null;
+}
+
+export declare const ConnectProvider: ({ children, initialAccount, }: ConnectProviderProps) => JSX.Element;
+
+declare interface ConnectProviderProps {
+    children: React.ReactNode;
+    initialAccount?: Account | null;
+}
+
+declare const _default: {
+    "chatTitle": "Keyring Agent",
+    "closeChat": "Close chat",
+    "messagePlaceholder": "Message ....",
+    "sendMessage": "Send message",
+    "botIsTyping": "Bot is typing",
+    "canIHelpYou": "Can I help you with anything?",
+    "suggestionAskText": "Ask a question",
+    "suggestionAskUserMessage": "I have a question",
+    "suggestionAskBotReply": "Ask me anything",
+    "suggestionBuyText": "Buy trending token",
+    "walletConnectedChainUnsupported": "Your wallet is connected but the chain is not supported for trading. Please switch to a supported chain to see trending tokens.",
+    "walletNotConnected": "Please connect your wallet to see trending tokens.",
+    "actionProcessing": "⏳ Processing transaction...",
+    "actionSuccess": "Transaction completed",
+    "actionFail": "❌ Action cancelled or failed",
+    "txSubmitted": "⏳ Transaction submitted. Waiting for confirmation...",
+    "txConfirmed": "Transaction confirmed!",
+    "txReverted": "❌ Transaction reverted on-chain.",
+    "txTimeout": "Transaction submitted but confirmation timed out. Please check manually.",
+    "txSuccessful": "Transaction successful!",
+    "txFailed": "❌ Transaction failed. Please try again.",
+    "txNoHandler": "No transaction handler configured.",
+    "txInsufficientGas": "⚠️Insufficient {symbol} for gas! You have {balance} {symbol} but need ~{fee} {symbol} for the transaction fee. Please top up your wallet and try again.",
+    "txError": "❌ Error: {message}",
+    "txErrRecipientRequired": "Recipient address is required.",
+    "txErrAmountRequired": "Amount is required.",
+    "txErrTokenContractRequired": "Token contract address is required.",
+    "txErrSpenderRequired": "Spender address is required.",
+    "txErrNftContractRequired": "NFT contract address is required.",
+    "txErrTokenIdRequired": "Token ID is required.",
+    "txErrWrapUnsupported": "Wrapped native token is not supported on chain {chainId}.",
+    "txErrUnsupportedAction": "Action \"{action}\" is not a supported transaction action.",
+    "swapConfirmButton": "Confirm",
+    "swapConfirmValue": "Confirm swap",
+    "swapReadyToProceed": "Ready to proceed with the swap?",
+    "swapEstimationError": "Unable to get swap estimation. Error: {error}",
+    "formCancel": "Cancel",
+    "formExecute": "Execute",
+    "formProcessing": "⏳ Processing...",
+    "formBalance": "Balance:",
+    "formTokenNotFound": "Token not found in your wallet.",
+    "formNoBalance": "You have no {symbol} balance in your wallet.",
+    "formInsufficientBalance": "Insufficient balance. Spendable: {balance} {symbol}",
+    "formFieldRequired": "{field} is required",
+    "formInvalidAddress": "Invalid address (Must contain 0x and 40 hex chars)",
+    "formMustBePositive": "Must be a positive number",
+    "formMustBeValidNumber": "Must be a valid number",
+    "openChat": "Open chat",
+    "openChatTitle": "Open chat support",
+    "walletBalanceSpendable": "This is the spendable balance of your wallet on {chain} chain. Please choose the coins you want to use for this trade.",
+    "walletNoTokensFound": "Sorry, I couldn't find any tokens in your wallet on {chain} chain. Please make sure you have some tokens to trade.",
+    "walletFetchFailed": "Sorry, I could not fetch your wallet balance. Please try again.",
+    "walletFetchError": "Sorry, I encountered an error fetching your wallet balance.",
+    "insufficientFeeToken": "Insufficient fee. Please ensure you have enough {symbol} to cover the transaction fees, or select a different token.",
+    "selectAmountOf": "Select the amount of {symbol} to use:\n\nSpendable: {balance} {symbol}",
+    "swapFeeWarning": "\n**Insufficient {symbol} for fees!**\n You have {balance} {symbol} but need ~{needed} {symbol}.\n",
+    "swapNeedApprove": "You need to approve {symbol} first before swapping.",
+    "swapApproveButton": "Approve {symbol}",
+    "swapApproveValue": "Approve {symbol} for swap",
+    "swapNoSourceToken": "You don't have the source token in your wallet or balance is 0.",
+    "swapSelectAmount": "Swap {from} → {to}\n\nSelect the amount of {from} to swap:\n\nSpendable: {balance} {from}",
+    "swapApprovalRequired": "Token approval required before swapping.\n\nStep 1: Approve {symbol}\nStep 2: Confirm Swap",
+    "swapEstimationFailed": "Failed to get swap estimation. Please try again.",
+    "swapInsufficientNativeBalance": "Insufficient balance! You have {balance} {symbol} but need {amount} {symbol}. Please top up your wallet or reduce the amount.",
+    "swapTokenNotInWallet": "You don't have {symbol} in your wallet. Please acquire some first before swapping.",
+    "swapInsufficientTokenBalance": "Insufficient balance! You have {balance} {symbol} but need {amount} {symbol}. Please reduce the amount or add more tokens.",
+    "selectAmountToSwap": "Select the amount of {symbol} to swap:\n\nSpendable: {balance} {symbol}",
+    "couldNotLoadTokenList": "Could not load token list. Please specify the destination token.",
+    "trendingTokensForReceive": "📈 Trending tokens on {chain} chain. Pick the token you want to receive or type the token you want to receive:",
+    "txProcessing": "⏳ Transaction processing... Please confirm in your wallet.",
+    "txConfirmedSwap": "Transaction confirmed! Your swap has been completed.",
+    "txRevertedSwap": "❌ Transaction reverted on-chain. Please try again.",
+    "txSuccessfulSwap": "Transaction successful! Your swap has been completed.",
+    "txSuccessfulSendToken": "Sent successfully **{amount} {symbol}** to {to}",
+    "txSuccessfulSendNative": "Sent successfully  **{amount} {symbol}** to {to}",
+    "txSuccessfulSendNft": "Sent successfully NFT **{name}** (#{tokenId}) to {to}",
+    "txSuccessfulWrapNative": "Wrapped successfully **{amount} {from}** → **{to}**",
+    "txSuccessfulUnwrapNative": "Unwrapped successfully **{amount} {from}** → **{to}**",
+    "txDataNotAvailable": "Transaction data not available.",
+    "approvalDataNotAvailable": "Approval data not available.",
+    "approving": "Approving {symbol}... Please confirm in your wallet.",
+    "approvalSuccess": "{symbol} approved successfully!",
+    "approvalConfirmSwap": "Now you can execute the swap.",
+    "confirmSwapButton": "Confirm Swap",
+    "approvalFailed": "❌ Approval failed. Please try again.",
+    "couldNotFetchBalance": "Could not fetch your wallet balance.",
+    "couldNotLoadBalance": "Could not load balance. Please try again.",
+    "couldNotFetchBalanceRetry": "Could not fetch your balance. Please try again.",
+    "nftSendReview": "📤 Send **{name}** ({standard} #{tokenId})\n\nPlease review and fill in the recipient address below:",
+    "nftCollectionHeader": "Your NFTs :\n\n{list}",
+    "nftMoreItems": "\n\nAnd {count} more NFTs...",
+    "nftSelectBelow": "\n\nSelect an NFT below to send",
+    "nftNoCollection": "You don't have any NFTs in your wallet on this chain.",
+    "nftMultipleMatchesForTokenId": "I found {count} NFTs with Token ID #{tokenId} in your wallet. Please select the one you want to send:",
+    "nftNotFoundInWallet": "I couldn't find \"{name}\" in your NFT collection. You don't own this NFT on this chain.",
+    "nftFetchError": "Sorry, I encountered an error fetching your NFTs.",
+    "trendingTokensHeader": "📈 Here is the list of tokens that are currently trending upwards on {chain} chain",
+    "trendingTokensQuestion": "\nIs there any token you want to buy?",
+    "trendingTokensError": "Sorry, I encountered an error fetching trending tokens.",
+    "errorProcessingRequest": "Sorry, I encountered an error processing your request.Please try again in a few moments.",
+    "buttonBuyWith": "Buy with {symbol}",
+    "buttonUsePercent": "Use {percent}% of {symbol}",
+    "buttonBuyToken": "Buy {name} ({symbol})",
+    "buttonSendNft": "Send {name}",
+    "buttonSwapTo": "Swap to {name} ({symbol})",
+    "buttonBuySymbol": "Buy {symbol}",
+    "viewBalancesLoading": "Fetching your wallet balances...",
+    "viewBalancesHeader": "Your token balances on {chain}:\n\n{list}",
+    "viewBalancesEmpty": "You don't have any tokens in your wallet on this chain.",
+    "viewBalancesFetchError": "Sorry, I encountered an error fetching your balances.",
+    "buttonSendToken": "Send {symbol}",
+    "formMax": "MAX",
+    "buttonSwapToken": "Swap {symbol}",
+    "buttonBuyMoreToken": "Buy more {symbol}",
+    "actionSendNativeLabel": "Send Native Token",
+    "actionSendNativeDesc": "Send native token (ETH, BNB, MATIC, etc.) to an address",
+    "actionSendTokenLabel": "Send Token (ERC20)",
+    "actionSendTokenDesc": "Send an ERC20 token to an address",
+    "actionSwapTokenLabel": "Swap Token",
+    "actionSwapTokenDesc": "Swap one token for another",
+    "actionApproveTokenLabel": "Approve Token",
+    "actionApproveTokenDesc": "Approve a spender to use your tokens",
+    "actionWrapNativeLabel": "Wrap Native Token",
+    "actionWrapNativeDesc": "Wrap native token (ETH → WETH)",
+    "actionUnwrapNativeLabel": "Unwrap Native Token",
+    "actionUnwrapNativeDesc": "Unwrap native token (WETH → ETH)",
+    "actionSendNftLabel": "Send NFT",
+    "actionSendNftDesc": "Transfer an ERC721 or ERC1155 NFT to another address",
+    "fieldToAddress": "Recipient Address",
+    "fieldAmount": "Amount",
+    "fieldTokenContract": "Token Contract",
+    "fieldTokenSymbol": "Token Symbol",
+    "fieldDecimals": "Decimals",
+    "fieldTokenIn": "From Token",
+    "fieldTokenInSymbol": "From Symbol",
+    "fieldTokenOut": "To Token",
+    "fieldTokenOutSymbol": "To Symbol",
+    "fieldTokenInDecimals": "From Decimals",
+    "fieldTokenOutDecimals": "To Decimals",
+    "fieldSpenderAddress": "Spender Address",
+    "fieldAmountUnlimited": "Amount (empty = unlimited)",
+    "fieldNftContract": "NFT Contract",
+    "fieldTokenId": "Token ID",
+    "fieldTokenStandard": "Token Standard",
+    "fieldNftName": "NFT Name",
+    "formMustBePositiveInteger": "Must be a positive integer",
+    "formAmountExceedsNft": "Amount cannot exceed available balance {max}",
+    "receivedButtonValue": "Received: {value}",
+    "actionExecutedFor": "Action \"{action}\" executed for: {value}",
+    "buyTokenHelp": "I'll help you buy {symbol}. Let me show your available tokens to trade with.",
+    "tokenNotFoundOnChain": "I couldn't find the token \"{symbol}\" on this chain. Here are the trending tokens you can buy",
+    "swapPreparing": "Preparing your swap...",
+    "swapConfirmYes": "Yes",
+    "swapChooseFrom": "Please choose which token you want to swap from:",
+    "swapChooseTo": "You want to swap {symbol}. Please choose which token you want to receive:",
+    "swapNeedDetails": "I need more details for your swap. Please specify which tokens you want to swap (e.g. \"Swap 1 ETH to USDC\").",
+    "viewNftsLoading": "Let me show you your NFT collection!",
+    "sendTokenNotInWallet": "You don't have {symbol} in your wallet on this chain. Please acquire some first before sending.",
+    "sendTokenChoose": "Which token would you like to send?",
+    "sendNftChoose": "Which NFT would you like to send?",
+    "swapChooseToken": "Which token would you like to swap? Here are your current balances:",
+    "spendable": "Spendable",
+    "welcomeMessage": "**Welcome! 🚀**\nYou’re now connected and ready to explore the world of Blockchain. I can assist you anytime with NFT insights, trading, price tracking, and portfolio analysis.",
+    "sendOtherNfts": "\nIf the NFT you want to send is not in the list above, please visit our website to send it.",
+    "sendNftViaWebsite": "Please select the NFT you would like to send from the list and proceed via this website.",
+    "sendNftViaWebsiteWithLink": "Please select the NFT you would like to send from the list and proceed via [this website]({link}).",
+    "viewNftViaWebsite": "Please view your NFT collection on this website for more details.",
+    "viewNftViaWebsiteWithLink": "Please view your NFT collection on [this website]({link}) for more details.",
+    "buyingOnChain": "Buying {symbol} on {chain}",
+    "viewOnExplorer": "View on Explorer",
+    "copyWalletAddress": "Copy wallet address",
+    "copied": "Copied!",
+    "copyAddress": "Copy address",
+    "poolGeneralInfoIntro": "💧 **Liquidity Pools** are smart contracts where users deposit token pairs to provide liquidity for DEX trading (like Uniswap). Liquidity providers (LPs) earn trading fees from each swap.",
+    "poolGeneralInfoMetricsTitle": "**Key Metrics:**",
+    "poolGeneralInfoMetricTVL": "**TVL** - Total Value Locked in the pool",
+    "poolGeneralInfoMetricAPR": "**APR** - Estimated annual return from fees",
+    "poolGeneralInfoMetricVol24h": "**Volume 24h** - Trading volume in last 24 hours",
+    "poolGeneralInfoMetricFeeTier": "**Fee Tier** - Trading fee (0.01%, 0.05%, 0.3%, 1%)",
+    "poolGeneralInfoTryAsk": "Try asking something specific, like: *\"ETH/USDC pools on Base\"* or *\"Highest APR pools\"*.",
+    "poolNoMatch": "❌ No matching pools found.",
+    "poolNoMatchForTokenOnChain": "❌ No matching pools found for **{token}** on **{chain}**.",
+    "poolSuggestionsTitle": "💡 **Suggestions:**",
+    "poolSuggestionTryChain": "Try a different chain (Ethereum, Base, Arbitrum...)",
+    "poolSuggestionTryPair": "Try a more popular pair (ETH/USDC, ETH/USDT)",
+    "poolSuggestionRelaxFilters": "Remove filters if too narrow",
+    "poolHeaderBest": "🏆 Best Pool",
+    "poolHeaderSafe": "🛡️ Safest Pools",
+    "poolHeaderTrending": "🔥 Trending Pools",
+    "poolHeaderHighApr": "📈 Highest APR Pools",
+    "poolHeaderLowFee": "💰 Lowest Fee Pools",
+    "poolHeaderCompare": "⚖️ Pool Comparison",
+    "poolHeaderDetail": "🔎 Pool Details",
+    "poolHeaderGeneral": "💧 Pool Info",
+    "poolHeaderSearch": "🔍 Search Results",
+    "poolTableMetric": "Metric",
+    "poolTableValue": "Value",
+    "poolTableLink": "Link",
+    "poolLinkView": "View on Uniswap",
+    "poolRecommendationHighApr": "👉 **Recommended:** [{pair}]({link}) - Highest APR at **{apr}%**. _Note: Higher APR may come with higher risk._",
+    "poolRecommendationLowFee": "👉 **Recommended:** [{pair}]({link}) - Lowest fee at **{fee}%**, ideal for frequent trading.",
+    "poolRecommendationSafe": "👉 **Recommended:** [{pair}]({link}) - Highest TVL at **{tvl}**, deep liquidity and stable.",
+    "poolRecommendationTrending": "👉 **Most Active:** [{pair}]({link}) - 24h Volume **{volume}**, highest trading activity.",
+    "poolRecommendationTopPick": "👉 **Top pick:** [{pair}]({link}) - TVL **{tvl}**, best match for your criteria.",
+    "sendPositionNoId": "Please provide your LP position ID to send it. For example: \"send position 12345 to 0x...\".",
+    "sendPositionNotFound": "Position #{id} was not found in your wallet on {chain}. Please make sure you own this position.",
+    "sendPositionReview": "📤 Send LP Position **#{positionId}** ({pair})\n\nPlease enter the recipient address below:",
+    "sendPositionFetchError": "Error fetching your positions. Please try again.",
+    "poolUnsupportedChain": "This chain is not supported for data queries. Sorry for the inconvenience.",
+    "poolUniswapV3Only": "I can only get information of pools that is on Subgraph Uniswap V3.",
+    "today": "Today",
+    "yesterday": "Yesterday"
+};
+
+declare interface IChainData extends Chain {
+    logo?: string;
+    chainId?: number | string;
+    chainType?: string;
+    chainTypeMoralis?: string;
+    customName?: string;
+    isSupported?: boolean;
+}
+
 export declare type Language = 'en' | 'ja' | 'cn';
 
+declare interface LanguageContextValue {
+    language: Language;
+    setLanguage: (language: Language) => void;
+    /** Translate `key` into the current language. */
+    t: (key: TranslationKey) => string;
+    /** Translate `key` and substitute `{placeholder}` tokens in one step. */
+    ti: (key: TranslationKey, vars: Record<string, string>) => string;
+}
+
+export declare const LanguageProvider: ({ children, initialLanguage, }: LanguageProviderProps) => JSX.Element;
+
+declare interface LanguageProviderProps {
+    children: React.ReactNode;
+    initialLanguage?: Language;
+}
+
 export declare interface Message {
     id: string;
     text: string;
     sender: 'user' | 'bot';
     timestamp: Date;
-    replyTo?: {
-        id: string;
-        text: string;
-        sender: 'user' | 'bot';
-    };
     buttons?: MessageButton[];
-    actionData?: {
-        action: string;
-        parameters: Record<string, string>;
-        status?: 'pending' | 'submitted' | 'success' | 'fail' | 'idle';
-        tokenInfo?: MessageTokenInfo;
-        nftInfo?: MessageNftInfo;
-    };
+    /**
+     * One or more wallet-action forms the FE should render below this message
+     * (send/swap/wrap/approve/...). Populated from `AgentResponse.uiActions`.
+     */
+    walletActions?: MessageWalletAction[];
+    /**
+     * Agent-suggested follow-up buttons rendered at the bottom of this message.
+     * Each one re-submits its `prompt` when clicked. Stacked one-per-line.
+     */
+    actionButtons?: MessageActionButton[];
     typeChat?: TypeChat;
 }
 
+/**
+ * Suggested-action button emitted by the agent (`AgentResponse.actionButtons`).
+ * Click submits `prompt` as the next user message.
+ */
+export declare interface MessageActionButton {
+    /** Display text on the button. */
+    label: string;
+    /** Text sent back to the agent on click. */
+    prompt: string;
+    /**
+     * BCP-47 language tag of the conversation when this button was emitted.
+     * `prompt` is often a synthetic English command, so on click pass this back
+     * as `chat(prompt, { language })` to keep the reply in the right language.
+     */
+    language?: string;
+}
+
 export declare interface MessageButton {
     id: string;
     text: string;
@@ -133,7 +437,7 @@ export declare interface MessageButton {
     fullWidth?: boolean;
 }
 
-declare interface MessageNftInfo {
+export declare interface MessageNftInfo {
     name: string;
     image?: string;
     tokenId: string;
@@ -146,6 +450,12 @@ export declare interface MessageTokenInfo {
     name: string;
     balance: string;
     balanceFormatted: string;
+    /**
+     * Spendable balance (held − gas reserve) for native coins, as supplied by
+     * core in the action `parameters`. Undefined for ERC-20s and when core
+     * couldn't compute it — callers fall back to `balanceFormatted`.
+     */
+    spendableFormatted?: string;
     usdValue?: number;
     usdPrice?: number;
     decimals: number;
@@ -153,6 +463,55 @@ export declare interface MessageTokenInfo {
     contractAddress: string;
 }
 
+/**
+ * One UI payload emitted by a `wallet-action` tool, attached to a bot message.
+ *
+ * Comes in two shapes:
+ *  - **Form** payloads (`SendNativeForm`, `SendTokenForm`, `SwapTokenForm`,
+ *    …): props is a `WalletActionProps` — `action`, `parameters`, etc.
+ *    populated.
+ *  - **Custom UI** payloads (`BuyTokenConfirmTx`, …): the tool emits a bespoke
+ *    shape. `action` is empty; the raw props are in `componentProps` for the
+ *    matching renderer to consume.
+ */
+export declare interface MessageWalletAction {
+    /** Component the FE renders (e.g. "SendNativeForm", "BuyTokenConfirmTx"). */
+    component: string;
+    /** WalletActionType — empty when this is a custom-UI payload. */
+    action: string;
+    chainId: string;
+    walletAddress: string;
+    parameters: Record<string, string>;
+    /**
+     * Verbatim props for custom-UI payloads (e.g. `BuyTokenConfirmTx`). When set,
+     * the FE switches on `component` and forwards this to a bespoke renderer
+     * instead of `ActionForm`.
+     */
+    componentProps?: Record<string, unknown>;
+    /** Optional BCP-47 tag stamped by AgentCore (en/vi/ja/zh/...). */
+    language?: string;
+    status?: WalletActionStatus;
+    /** Hash returned by `onTransaction` after a successful submit. */
+    transactionHash?: string;
+    /** Error message if the submit fails. */
+    errorMessage?: string;
+    /**
+     * For a `BuyTokenConfirmTx` with an approve step: true once the ERC-20 approve
+     * tx has confirmed on-chain. Persisted with the message so a page reload
+     * resumes at the swap step instead of asking the user to approve again.
+     */
+    approveDone?: boolean;
+    /**
+     * Pre-resolved ERC-20 / native token info — symbol, balance, logo, USD price.
+     * Used by `ActionForm` to render the token info card and to clamp the amount
+     * field against the available balance. Built from `agent.invokeTool` lookups
+     * before the form is shown.
+     */
+    tokenInfo?: MessageTokenInfo;
+    /** Pre-resolved NFT info for `send_nft` forms. */
+    nftInfo?: MessageNftInfo;
+}
+
 export declare interface SuggestionButtonConfig {
     icon?: string;
     text: string;
@@ -183,6 +542,32 @@ export declare interface TransactionResult {
  */
 export declare type TransactionStatus = 'pending' | 'process' | 'success' | 'fail';
 
+/** Union of every valid translation key (derived from the English locale). */
+declare type TranslationKey = keyof typeof _default;
+
 declare type TypeChat = 'web3' | 'normal';
 
+export declare function useAgent(): AgentCore;
+
+export declare function useAgentChat({ agent, addMessage }: UseAgentChatParams): {
+    send: (rawText: string, language?: string) => Promise<void>;
+    isTyping: boolean;
+    suggestedPrompts: string[];
+    setSuggestedPrompts: Dispatch<SetStateAction<string[]>>;
+};
+
+declare interface UseAgentChatParams {
+    agent: AgentCore;
+    addMessage: (text: string, sender: 'user' | 'bot', options?: AddMessageOptions) => Message;
+}
+
+export declare const useConfig: () => ConfigContextValue;
+
+export declare const useConnect: () => ConnectContextDerived;
+
+export declare const useLanguage: () => LanguageContextValue;
+
+/** Status of a wallet-action form attached to a bot message. */
+export declare type WalletActionStatus = 'pending' | 'submitted' | 'success' | 'fail' | 'idle';
+
 export { }