keyring-agent-core 0.2.0 → 0.2.2

package/dist/types/index.d.ts

@@ -1,777 +0,0 @@
-import type { PoolOnchainInfo } from '../services/PoolService';
-/** Role inside a conversation */
-export type ChatRole = 'user' | 'assistant' | 'system' | 'tool';
-/** A single message in the conversation */
-export interface ChatMessage {
-    role: ChatRole;
-    content: string;
-    /** If role === 'tool', the name of the tool that produced this message */
-    toolName?: string;
-    /** If role === 'tool', the call id this result belongs to */
-    toolCallId?: string;
-    /** If role === 'assistant' and the model made function calls */
-    toolCalls?: LLMToolCall[];
-    /**
-     * Names of the subagents that produced this assistant message (if any).
-     * Used for follow-up resolution: if this turn was handled by ["wallet-agent"],
-     * a short reply like "more" / "tiếp" almost certainly still belongs to wallet.
-     * Only set on role === 'assistant' (the final user-facing answer).
-     */
-    subagents?: string[];
-    /**
-     * Suggested follow-up prompts attached to this assistant turn. Persisted with
-     * history so that when a session is restored, the FE can re-render the same
-     * suggestion chips next to the message. Only set on role === 'assistant'.
-     */
-    suggestedPrompts?: string[];
-    /**
-     * UI payloads (forms / confirms / result widgets) emitted by tools during
-     * this turn. Persisted with history so the FE can re-render these widgets
-     * after a reload. Only set on role === 'assistant'.
-     */
-    uiActions?: UIPayload[];
-    /**
-     * Tool-emitted clickable buttons attached to this assistant turn (e.g. a
-     * token picker after the user said "send token"). Persisted with history so
-     * the FE can re-render them after a reload. Only set on role === 'assistant'.
-     */
-    actionButtons?: SuggestedAction[];
-    /**
-     * Stable id of the response turn (matches `AgentResponse.messageId`). Lets
-     * the FE key persistent widgets across reloads. Only set on role === 'assistant'.
-     */
-    messageId?: string;
-    /**
-     * Internal flag — set on the bridging assistant message that `persistToolMessages`
-     * injects after each subagent's tool exchange (to satisfy Gemini's rule that
-     * function-response turns must be followed by a model turn). These messages
-     * must be stripped before building a Synthesiser or direct-LLM history so they
-     * don't appear as duplicate model turns alongside the synthesised answer.
-     */
-    _intermediate?: boolean;
-    timestamp: number;
-}
-/** Describes a parameter for a tool */
-export interface ToolParameter {
-    name: string;
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    description: string;
-    required: boolean;
-    default?: unknown;
-    /** For array types, the type of items in the array (default: 'string') */
-    items?: {
-        type: 'string' | 'number' | 'boolean' | 'object';
-    };
-}
-/**
- * Tool kind — drives how the orchestrator handles the result.
- *  - 'data'   (default): result fed back into the LLM for synthesis
- *  - 'ui'     : result includes a `ui` payload that the FE renders as a component
- *  - 'action' : result includes an unsigned transaction the FE will sign + send
- */
-export type ToolKind = 'data' | 'ui' | 'action';
-/** Definition of a single tool that the agent can invoke */
-export interface ToolDefinition {
-    /** Unique tool name (slug-style, e.g. "get-faq") */
-    name: string;
-    /** Human-readable description – sent to the LLM so it knows when to use the tool */
-    description: string;
-    /** The parameters the tool accepts */
-    parameters: ToolParameter[];
-    /** Optional category for grouping */
-    category?: string;
-    /** Whether this tool returns plain data, a UI payload, or an unsigned action. Default 'data'. */
-    kind?: ToolKind;
-    /**
-     * When true, AgentCore skips generating `suggestedPrompts` for any turn in
-     * which this tool was executed. Use on tools that already drive the user to
-     * a concrete next step (e.g. pool action forms, wallet-action forms) where
-     * generic suggestions add noise instead of helping.
-     * Default false.
-     */
-    noSuggestions?: boolean;
-}
-/**
- * UI payload emitted by a tool. The FE has pre-built components keyed by
- * `component`; it dispatches on the name and forwards `props` verbatim.
- *
- * `TProps` is the typed shape of `props`. Tools that ship typed props should
- * narrow this generic (e.g. `UIPayload<AddLiquidityFormProps>`) so the FE can
- * `props as AddLiquidityFormProps` without losing type-safety.
- */
-export interface UIPayload<TProps = Record<string, unknown>> {
-    /** Component name registered on the FE (e.g. "AddLiquidityForm") */
-    component: string;
-    /** Props forwarded to that component as-is */
-    props: TProps;
-    /**
-     * BCP-47 language tag (e.g. "en", "vi", "zh", "ja") detected from the
-     * CURRENT user message. Stamped by AgentCore so the FE renders this
-     * component in whichever language the user just typed in — independent of
-     * the FE's app locale. Tools do NOT set this themselves.
-     */
-    language?: string;
-}
-/** Identifies a chain in BE↔FE payloads. */
-export interface ChainRef {
-    /** Hex chain id, e.g. "0x2105" for Base */
-    hexId: string;
-    /** Human-readable chain name, e.g. "Base" */
-    name: string;
-}
-/** A token shown to the user inside a pool/strategy display. */
-export interface TokenDisplay {
-    address: string;
-    symbol?: string;
-    name?: string;
-    decimals?: number;
-    logo?: string;
-}
-/** On-chain + display state of a Uniswap V3 pool, normalised for the FE. */
-export interface PoolDisplayInfo {
-    address: string;
-    /** Fee tier in basis points (e.g. 500 for 0.05%) */
-    fee: number;
-    /** Same as `fee / 10_000` — pre-computed for convenience */
-    feePercent: number;
-    tickSpacing: number;
-    currentTick: number;
-    /** Decimal-adjusted price (token1 per token0) */
-    currentPrice: number;
-    /** Stringified bigint — sqrt price in Q96 fixed-point */
-    sqrtPriceX96: string;
-    token0: TokenDisplay;
-    token1: TokenDisplay;
-}
-/**
- * Hard bounds for the price-range inputs (token1 per token0, decimal-adjusted).
- * The form should clamp user inputs to this window — anything outside the
- * Uniswap V3 valid tick range is unmintable.
- */
-export interface PriceBounds {
-    /** Decimal-adjusted absolute minimum (corresponds to MIN_TICK). */
-    min: number;
-    /** Decimal-adjusted absolute maximum (corresponds to MAX_TICK). */
-    max: number;
-}
-/** Pre-computed quick-pick chip (e.g. "25% of spendable"). */
-export interface QuickRate {
-    percent: number;
-    /** Wei as decimal string */
-    amountWei: string;
-    /** Human-readable amount in token units */
-    amount: number;
-}
-/**
- * Self-contained block describing the input field of the AddLiquidityForm.
- * The CoinPool gateway only accepts native coin as input — the FE renders a
- * locked input bound to this single token.
- */
-export interface InputTokenInfo {
-    /** Always zeroAddress for native */
-    address: string;
-    /** Always true today — kept for forward compatibility */
-    isNative: boolean;
-    symbol: string;
-    name: string;
-    decimals: number;
-    /** USD price; null when the price oracle was unavailable */
-    priceUsd: number | null;
-    balanceWei: string;
-    balance: number;
-    gasReserveWei: string;
-    spendableWei: string;
-    spendable: number;
-    /** spendable × priceUsd; null when priceUsd is null */
-    spendableUsd: number | null;
-    /** Quick-pick chips (25/50/75/100% of spendable) */
-    quickRates: QuickRate[];
-    /** Minimum USD value the user must add (e.g. 10) */
-    minProvideUsd: number;
-    /** Machine-readable warning code; null when balance is fine */
-    warning: 'no_balance' | 'insufficient_balance' | null;
-    /** Optional human-language hint mirroring `warning` */
-    warningMessage: string | null;
-    /**
-     * Pre-fill amount the FE should populate the input with on first render.
-     * Set when the user supplied an amount before choosing a pool (e.g.
-     * "add 0.1 ETH to USDC/WETH"). null when no pre-fill is available.
-     */
-    prefillAmount: number | null;
-    prefillAmountWei: string | null;
-}
-/**
- * Pre-filled price range for the AddLiquidityForm. The FE should populate the
- * min/max inputs with these values on first render, but MUST keep the inputs
- * editable so the user can override before submitting.
- */
-export interface PriceRangePrefill {
-    /**
-     * How the range was derived:
-     *  - "user": user passed explicit minPrice / maxPrice
-     *  - "stable": ±tickSpacing × N around currentTick (narrow, high-yield, high-out-of-range risk)
-     *  - "wide": currentPrice × [0.5, 2.0] (broad, lower yield, less rebalancing)
-     *  - "full": [priceBounds.min, priceBounds.max] (full V3 tick range, lowest yield, no out-of-range risk)
-     */
-    strategy: 'user' | 'stable' | 'wide' | 'full';
-    /** Decimal-adjusted prices in token1-per-token0 units (same as pool.currentPrice). */
-    minPrice: number;
-    maxPrice: number;
-}
-/** Props for the FE `AddLiquidityForm` component. */
-export interface AddLiquidityFormProps {
-    chain: ChainRef;
-    pool: PoolDisplayInfo;
-    inputToken: InputTokenInfo;
-    /**
-     * Allowed bounds for the user-entered price range, in token1-per-token0 units
-     * (decimal-adjusted, the same unit as `pool.currentPrice`). The form should
-     * not let the user submit values outside this window.
-     */
-    priceBounds: PriceBounds;
-    /**
-     * Optional pre-fill for the min/max price inputs. Populated when the user
-     * named explicit prices ("range 1800 to 2200") or asked for a preset strategy
-     * ("safe range", "wide range"). null when no pre-fill was requested. The FE
-     * must keep the inputs editable in all cases.
-     */
-    prefillRange: PriceRangePrefill | null;
-    /** CoinPool gateway contract address on this chain */
-    gatewayAddress: string;
-}
-export type WalletActionType = 'send_native' | 'send_token' | 'approve_token' | 'wrap_native' | 'unwrap_native';
-/**
- * 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`,
- * and submits the on-chain tx itself.
- *
- * `parameters` mirrors the field set declared in the chatbot SDK's
- * `ACTION_SCHEMAS` (keyring-chatbot-agent-sdk) so the FE can reuse its existing
- * `<ActionForm>` rendering without changes.
- */
-export interface WalletActionProps {
-    action: WalletActionType;
-    /** Hex chain id, e.g. "0x1", "0x2105". Falls back to userContext.chain. */
-    chainId: string;
-    /** Connected wallet that will sign the tx. */
-    walletAddress: string;
-    /**
-     * Field values to pre-fill in the form. Keys match the chatbot SDK schema
-     * (e.g. to_address, amount, contract_address, token_symbol, decimals, …).
-     * Missing keys mean "ask the user for this field".
-     */
-    parameters: Record<string, string>;
-}
-/** Unsigned EVM transaction the FE will pass to the connected wallet. */
-export interface UnsignedTx {
-    /** Hex chain id */
-    chainId: string;
-    to: string;
-    data: string;
-    /** Wei as decimal string */
-    value: string;
-    from: string;
-}
-/** One side of a buy, with whatever identity the tool could resolve. */
-export interface BuyTokenSide {
-    /** Contract address (0x…) or the literal "native". */
-    address: string;
-    symbol?: string;
-    decimals?: number;
-    /** Human-readable amount (e.g. "10" for 10 USDC). */
-    amount?: string;
-    /** Amount in the token's smallest unit (wei-equivalent), as a decimal string. */
-    rawAmount?: string;
-}
-/**
- * Props for the FE `BuyTokenConfirmTx` component — the single data cube the
- * BuyTokenTool ships once the user has supplied pay token + dest token + a
- * spend amount.
- *
- * The tool has already: fetched a swap quote (so `estimatedOut` is the expected
- * receive amount), built the raw swap transaction (`swapTx`), and checked
- * allowance (`approveTx` is set only when an approval must run first). The FE
- * renders a confirmation panel and executes approve (if any) then swap itself —
- * no further BE round-trip is needed. This is NOT a wallet-action form payload:
- * BuyTokenTool emits its own UI component, so `buy_token` is intentionally NOT
- * a member of WalletActionType.
- */
-export interface BuyTokenConfirmTxProps {
-    chain: ChainRef;
-    /** Token the user spends. */
-    payToken: BuyTokenSide;
-    /** Token the user receives. */
-    buyToken: BuyTokenSide;
-    /** Estimated receive amount of buyToken (human-readable), when the provider reported one. */
-    estimatedOut?: string;
-    /** Estimated receive amount of buyToken in smallest units, when available. */
-    estimatedOutRaw?: string;
-    /** Swap provider that produced the quote (e.g. "debridge", "relay"). */
-    provider?: string;
-    /** Raw swap transaction the FE signs + broadcasts. */
-    swapTx: UnsignedTx;
-    /**
-     * Raw ERC-20 approve transaction to run BEFORE the swap. Present only when an
-     * allowance is required (native pay token or sufficient allowance ⇒ omitted).
-     */
-    approveTx?: UnsignedTx;
-}
-/**
- * Props for the FE `SwapTokenConfirmTx` component — the single data cube the
- * SwapTokenTool ships once the user has supplied a SOURCE token they hold,
- * a destination token, and a source amount.
- *
- * Mechanically identical to {@link BuyTokenConfirmTxProps} (deBridge EXACT_INPUT
- * quote → raw swap tx → optional approve), but the framing is "swap FROM a token
- * I already hold TO another token": `fromToken` is the user's held source token
- * (always balance-checked) and `toToken` is what they receive. Like buy, this is
- * NOT a wallet-action form payload — SwapTokenTool emits its own UI component, so
- * `swap_token` is intentionally NOT a member of WalletActionType.
- */
-export interface SwapTokenConfirmTxProps {
-    chain: ChainRef;
-    /** Token the user spends (the source they already hold). */
-    fromToken: BuyTokenSide;
-    /** Token the user receives. */
-    toToken: BuyTokenSide;
-    /** Estimated receive amount of toToken (human-readable), when the provider reported one. */
-    estimatedOut?: string;
-    /** Estimated receive amount of toToken in smallest units, when available. */
-    estimatedOutRaw?: string;
-    /** Swap provider that produced the quote (e.g. "debridge", "relay"). */
-    provider?: string;
-    /** Raw swap transaction the FE signs + broadcasts. */
-    swapTx: UnsignedTx;
-    /**
-     * Raw ERC-20 approve transaction to run BEFORE the swap. Present only when an
-     * allowance is required (native source token or sufficient allowance ⇒ omitted).
-     */
-    approveTx?: UnsignedTx;
-}
-/** Human-readable summary of an add-liquidity tx, shown above the Confirm button. */
-export interface AddLiquiditySummary {
-    nativeIn: number;
-    nativeInUsd: number | null;
-    ratio: {
-        token0Percent: number;
-        token1Percent: number;
-    };
-    expectedToken0: number;
-    expectedToken1: number;
-    amount0Min: string;
-    amount1Min: string;
-    slippageBps: number | string;
-}
-/**
- * Resolved range for an add-liquidity action — both the protocol-level ticks
- * (used in the on-chain mint) and the human prices the user entered.
- */
-export interface ResolvedRange {
-    tickLower: number;
-    tickUpper: number;
-    /** Decimal-adjusted price (token1 per token0) at tickLower */
-    minPrice: number;
-    /** Decimal-adjusted price at tickUpper */
-    maxPrice: number;
-}
-/** Props for the FE `ConfirmAddLiquidityTx` component. */
-export interface ConfirmAddLiquidityTxProps {
-    chain: ChainRef;
-    unsignedTx: UnsignedTx;
-    summary: AddLiquiditySummary;
-    pool: Omit<PoolOnchainInfo, 'token0' | 'token1'> & {
-        token0: TokenDisplay;
-        token1: TokenDisplay;
-        feePercent: number;
-    };
-    range: ResolvedRange;
-    gatewayAddress: string;
-}
-/**
- * A clickable suggested action emitted by a tool — the FE renders it as a
- * button below the assistant message. When the user clicks, the FE submits
- * `prompt` as the next user message.
- *
- * Distinct from `AgentResponse.suggestedPrompts`: those are LLM-generated
- * generic follow-ups; these are deterministic, tool-emitted picker / disambig
- * buttons (e.g. "Send USDC", "Send WETH" when the user said "send token"
- * without naming one).
- */
-export interface SuggestedAction {
-    /** Button label shown to the user. */
-    label: string;
-    /** Message submitted on click — fed back into the agent as a new user turn. */
-    prompt: string;
-    /**
-     * BCP-47 language tag of the conversation when this button was emitted,
-     * stamped by AgentCore. The `prompt` is a synthetic, often-English command
-     * (e.g. "buy PEPE"), so on click the FE should pass this back as
-     * `chat(prompt, { language })` — otherwise the next turn's auto-detection
-     * sees English and renders the resulting form/reply in the wrong language.
-     */
-    language?: string;
-}
-/** The result returned after a tool executes */
-export interface ToolResult {
-    toolName: string;
-    callId: string;
-    success: boolean;
-    data?: unknown;
-    error?: string;
-    /** Execution time in ms */
-    duration: number;
-    /**
-     * Optional UI payload. Set by tools with kind='ui' or 'action' to ask the FE
-     * to render a component. AgentCore aggregates these into AgentResponse.uiActions.
-     */
-    ui?: UIPayload;
-    /**
-     * Optional set of clickable buttons rendered below the assistant message.
-     * Used by tools that need to disambiguate before completing (e.g. "which
-     * token do you want to send?"). AgentCore aggregates these into
-     * `AgentResponse.actionButtons`.
-     */
-    actionButtons?: SuggestedAction[];
-}
-/** A concrete handler for a tool (provided by the consumer) */
-export interface Tool extends ToolDefinition {
-    /** Execute the tool with the given arguments and return a result */
-    execute(args: Record<string, unknown>, userContext?: UserContext): Promise<ToolResult>;
-}
-export type ReActPhase = 'think' | 'act' | 'observe';
-export interface ReActStep {
-    phase: ReActPhase;
-    content: string;
-    toolCall?: {
-        toolName: string;
-        args: Record<string, unknown>;
-    };
-    toolResult?: ToolResult;
-    timestamp: number;
-}
-export interface ReActTrace {
-    steps: ReActStep[];
-    finalAnswer: string;
-}
-/**
- * A capability card advertised by a subagent to the Router.
- * Only `name` + `description` are sent to the Router's LLM, so they must
- * be dense and token-efficient.
- */
-export interface SubagentCard {
-    /** Unique subagent id, e.g. "wallet-agent" */
-    name: string;
-    /** When to use this subagent (one-liner, shown to the router LLM) */
-    description: string;
-    /** High-level domain tag for logging / UI */
-    domain: string;
-}
-/** A focused sub-query dispatched to a single subagent. */
-export interface SubagentTask {
-    /** Domain-scoped query rewritten by the router */
-    query: string;
-    /** Router's reason for assigning this subagent (optional, for logging) */
-    reasoning?: string;
-    /**
-     * BCP-47 language tag of the current turn (e.g. "en", "vi", "ja"), detected
-     * by the QueryRewriter. Passed through so the subagent LLM can write any
-     * user-facing strings it generates as tool arguments (e.g. localized
-     * action-button prompts) in the right language. Empty when undetected.
-     */
-    language?: string;
-}
-/** Output of a single subagent run (tool calls + final summary). */
-export interface SubagentResult {
-    /** Name of the subagent that produced this result */
-    subagentName: string;
-    /** ReAct steps (think/act/observe) produced internally */
-    steps: ReActStep[];
-    /** Subagent's summarised answer for its domain */
-    finalAnswer: string;
-    /** Raw tool results from the run (useful for synthesiser and debugging) */
-    toolResults: ToolResult[];
-    /**
-     * Interleaved assistant-with-toolCalls + role:'tool' result messages.
-     * AgentCore appends these to ChatHistory so the next turn can reference
-     * previous tool data — pagination cursors, raw results, etc.
-     * Tool result content is truncated to cap history size.
-     */
-    toolMessages: ChatMessage[];
-}
-/** A single routing assignment the Router emits. */
-export interface RouterAssignment {
-    /** Name of the subagent to invoke */
-    subagent: string;
-    /** Focused sub-query for that subagent, in the user's language */
-    query: string;
-    /** Router's reason */
-    reasoning: string;
-}
-/** The Router's decision for a user query. */
-export interface RouterDecision {
-    /** Brief intent analysis (user-language) */
-    analysis: string;
-    /** Subagents to invoke. Empty array = no subagent needed (answer directly). */
-    assignments: RouterAssignment[];
-}
-/** Context about the connected wallet — set/updated by the UI layer. */
-export interface UserContext {
-    /** Connected wallet address (e.g. "0x…"). null/undefined = not connected. */
-    walletAddress?: string | null;
-    /** Current chain the wallet is on (e.g. "ethereum", "arbitrum", "base"). */
-    chain?: string | null;
-}
-/**
- * Platform-agnostic storage interface.
- * - Web: pass `localStorage` directly (or a wrapper).
- * - React Native: pass `AsyncStorage` (all methods return Promise).
- * - Node: pass any key-value store.
- *
- * All methods may return a value OR a Promise — the SDK awaits either.
- */
-export interface StorageProvider {
-    getItem(key: string): string | null | Promise<string | null>;
-    setItem(key: string, value: string): void | Promise<void>;
-    removeItem(key: string): void | Promise<void>;
-}
-/** A single entry in the knowledge base. */
-export interface KnowledgeBaseEntry {
-    /** The question or topic. Used for matching against user queries. */
-    question: string;
-    /** The reference answer content. The LLM will use this as source material (not returned verbatim). */
-    answer: string;
-}
-/** A scored knowledge-base hit. Score is in [0, 1] — higher is better. */
-export interface KBSearchResult {
-    entry: KnowledgeBaseEntry;
-    score: number;
-}
-/**
- * Pluggable knowledge-base backend. The agent only needs `search()`; ingestion
- * is the responsibility of each concrete provider (in-memory, Upstash, pgvector…).
- */
-export interface KnowledgeBaseProvider {
-    /** Find the top-K most relevant entries for the query. */
-    search(query: string, maxResults?: number): Promise<KBSearchResult[]>;
-}
-/** Vector-backed KB config (Upstash-flavoured by default). */
-export interface VectorKBConfig {
-    /**
-     * Master switch. `true` → use vector search. `false`/omitted → legacy
-     * LLM-based matcher (unchanged behaviour).
-     */
-    enabled: boolean;
-    /**
-     * Upstash Vector REST URL. Falls back to UPSTASH_VECTOR_REST_URL env var.
-     */
-    url?: string;
-    /**
-     * Upstash Vector REST token. Falls back to UPSTASH_VECTOR_REST_TOKEN env var.
-     */
-    token?: string;
-    /** Optional namespace for multi-tenant isolation. */
-    namespace?: string;
-    /** Minimum cosine score (0..1) for a hit to be returned. Default 0.7. */
-    minScore?: number;
-    /** Default top-K. Default 3. */
-    defaultTopK?: number;
-    /**
-     * If true, the agent upserts `config.knowledgeBase` entries to Upstash the
-     * first time it runs. Idempotent — same entries produce the same ids, so
-     * re-running does not duplicate. Default false (manage ingestion yourself).
-     */
-    autoIngest?: boolean;
-    /**
-     * Bring your own provider. Overrides every other field above when set —
-     * useful for swapping in pgvector, Pinecone, or test doubles.
-     */
-    provider?: KnowledgeBaseProvider;
-}
-export interface LLMProviderConfig {
-    /** Model name, e.g. "gemini-2.5-flash-lite" */
-    model?: string;
-    /** Max tokens for generation */
-    maxTokens?: number;
-    /** Temperature (0-2) */
-    temperature?: number;
-    /** Base URL for the Gemini API proxy. Defaults to "https://nft.keyring.app/api/gemini-cortex/proxy" */
-    baseUrl?: string;
-}
-export interface AgentConfig {
-    /** LLM provider configuration */
-    llm: LLMProviderConfig;
-    /**
-     * Core-wide RPC overrides, keyed by hex chain id (e.g. `{ '0x1': 'https://…' }`).
-     * The single place to configure RPC endpoints — shared by every on-chain read
-     * in the core: gas-reserve estimation for wallet actions, the swap allowance
-     * check, and the pool tools. A chain that is not listed falls back to the
-     * built-in public default for that chain.
-     */
-    rpcUrls?: Record<string, string>;
-    /** Maximum number of ReAct iterations before forcing an answer */
-    maxIterations?: number;
-    /** Maximum number of messages to keep in history before summarising */
-    maxHistoryMessages?: number;
-    /** System prompt prepended to every LLM call */
-    systemPrompt?: string;
-    /** Enable debug logging */
-    debug?: boolean;
-    /**
-     * Cross-platform storage for persisting chat history.
-     * - Web: pass `localStorage`
-     * - React Native: pass `AsyncStorage`
-     * If omitted, history is in-memory only (lost on reload).
-     */
-    storage?: StorageProvider;
-    /**
-     * Key used in storage. Defaults to "keyring-agent-history".
-     * Useful when running multiple agent instances.
-     */
-    storageKey?: string;
-    /**
-     * Whether chat history is persisted across app restarts. Default true.
-     *
-     * When false, the agent does NOT load prior history from `storage` on the
-     * first turn and does NOT write subsequent turns back — every app launch
-     * starts a fresh session. Useful for incognito-style chats or to opt out
-     * even when a storage provider is configured globally.
-     *
-     * Note: when `storage` is omitted, history is in-memory only regardless
-     * of this flag.
-     */
-    persistHistory?: boolean;
-    /**
-     * Pre-defined Q&A knowledge base entries. By default the agent matches them
-     * with an LLM (sends the whole list each call — fine up to ~50 entries).
-     * Toggle `vectorKB.enabled` to switch to Upstash vector search instead.
-     */
-    knowledgeBase?: KnowledgeBaseEntry[];
-    /**
-     * Vector-backed knowledge base config. When `enabled: true`, the agent
-     * searches via Upstash Vector instead of the LLM matcher. When omitted or
-     * `enabled: false`, behaviour is identical to versions without this flag.
-     */
-    vectorKB?: VectorKBConfig;
-    /**
-     * Minimum top-hit score (0..1) at which the agent answers directly from
-     * the KB and skips the Router/Subagent pipeline entirely. Default 0.8.
-     *
-     * Vector backends (e.g. Upstash bge-m3 hybrid) commonly produce scores in
-     * the 0.7–0.85 range for genuinely relevant matches; lowering this to
-     * around 0.7 typically gives better KB recall in production.
-     */
-    kbAnswerThreshold?: number;
-    /**
-     * Whether to generate suggested follow-up prompts after each answer.
-     * Default true. Set to false to skip the extra LLM call and omit
-     * `suggestedPrompts` from every response.
-     */
-    generateSuggestions?: boolean;
-    /** Moralis AI tool config. Set to false to disable the built-in Moralis tool. */
-    moralis?: {
-        /** Base URL for Moralis proxy (default: https://nft.keyring.app) */
-        baseUrl?: string;
-        /** Base URL for DeFi APIs — uses /api/moralis-v1/proxy route (default:  https://nft-demo.keyring.app) */
-        v1BaseUrl?: string;
-        /** Pantograph API base URL for price enrichment */
-        pantographUrl?: string;
-    } | false;
-    /**
-     * Enable/disable individual built-in subagents. Defaults to all-enabled.
-     * Set any key to `false` to skip that subagent — it won't be created or
-     * routed to. Custom subagents added via `registerSubagent()` are not affected.
-     *
-     * Names mirror `DefaultSubagentName` in agent/subagents.
-     */
-    subagents?: {
-        wallet?: boolean;
-        'wallet-action'?: boolean;
-        token?: boolean;
-        nft?: boolean;
-        pool?: boolean;
-        /**
-         * Subgraph-backed pool agent (Uniswap V3 via The Graph + DefiLlama APR + CoinPool ranges).
-         * Mutually exclusive with `pool`. Enabling this (true) automatically disables `pool`
-         * unless `pool` is also explicitly set to true. Defaults to false.
-         */
-        'pool-subgraph'?: boolean;
-        ai?: boolean;
-    };
-    /**
-     * Configuration for the subgraph-backed pool tools (used by the
-     * `pool-subgraph` subagent). Set to `false` to skip registering them.
-     *
-     * Independent of `uniswap` — the subgraph stack does not need RPC URLs or
-     * the Uniswap interface gateway. To actually route queries to it, also set
-     * `subagents['pool-subgraph']: true`.
-     */
-    subgraph?: {
-        /** The Graph gateway API key. Falls back to a public demo key. */
-        theGraphApiKey?: string;
-        /** CoinPool pair-list base url (`<base>/pair/pure-list?chainId=…`). */
-        coinPoolBaseUrl?: string;
-        /** Keyring pool API base url (`<base>/user/positions-details/v3?…`). */
-        keyringPoolBaseUrl?: string;
-        /** Override subgraph URLs per hex chain id. */
-        subgraphUrls?: Record<string, string>;
-        /**
-         * Website link for adding liquidity / creating a pool. When set, the
-         * `pool-subgraph` subagent appends this exact URL at the end of its
-         * answer whenever the user asks to add liquidity / add a pool / create
-         * a pair ("add liquidity", "create pool", "thêm thanh khoản", …). When
-         * omitted, the subagent says add-liquidity is not handled, as before.
-         */
-        linkAddLiquidity?: string;
-    } | false;
-    /** Uniswap Explore gateway config. Set to false to disable the built-in pool tools. */
-    uniswap?: {
-        /** Base URL for the Uniswap interface gateway (default: https://interface.gateway.uniswap.org) */
-        baseUrl?: string;
-        /** Minimum USD value the user must supply to add liquidity. Default 10. */
-        minProvideUsd?: number;
-        /**
-         * Hit production endpoints (coinpool.app) for addresses + bridge-provider
-         * mapping. Set false for staging. Default true.
-         */
-        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.
-     *
-     * 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
-     * omitted, it stays as plain text. A single link is shared by all NFT tools.
-     */
-    nftLink?: string;
-}
-export interface LLMToolCall {
-    toolName: string;
-    args: Record<string, unknown>;
-    callId: string;
-}
-export interface LLMResponse {
-    text: string;
-    toolCalls: LLMToolCall[];
-    /** Raw usage stats from the provider */
-    usage?: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-}
-/** Optional flags for an LLM call */
-export interface ChatOptions {
-    /** Enable Google Search grounding (Gemini only) */
-    googleSearch?: boolean;
-    /** Maximum number of retries for transient errors */
-    maxRetries?: number;
-    /** Delay between retries in ms */
-    retryDelayMs?: number;
-}
-export interface LLMProvider {
-    /** Send messages to the LLM and get a response */
-    chat(messages: ChatMessage[], tools?: ToolDefinition[], options?: ChatOptions): Promise<LLMResponse>;
-}
-//# sourceMappingURL=index.d.ts.map