keyring-agent-core 0.2.8 → 0.2.9

package/dist/index.d.ts

@@ -1006,6 +1006,13 @@ interface UserContext {
     walletAddress?: string | null;
     /** Current chain the wallet is on (e.g. "ethereum", "arbitrum", "base"). */
     chain?: string | null;
+    /**
+     * The raw user query for this turn (verbatim phrasing). Tools that need to
+     * disambiguate LLM-extracted args against what the user actually typed read it
+     * — e.g. BuyToken checks which token an amount sits next to to decide whether
+     * it's the buy-side or pay-side amount. Optional; absent on programmatic calls.
+     */
+    query?: string;
 }
 /**
  * Platform-agnostic storage interface.
@@ -1271,6 +1278,14 @@ interface ChatOptions {
     maxRetries?: number;
     /** Delay between retries in ms */
     retryDelayMs?: number;
+    /**
+     * Force the model to call one of the supplied `tools` instead of answering in
+     * text (Gemini `functionCallingConfig.mode = "ANY"`). Used by action subagents
+     * that MUST open a form, so the first turn calls a tool directly instead of
+     * burning a round-trip on a text answer that then has to be re-prompted.
+     * Ignored when no tools are passed.
+     */
+    forceToolUse?: boolean;
 }
 interface LLMProvider {
     /** Send messages to the LLM and get a response */
@@ -1608,6 +1623,14 @@ declare class AgentCore {
      * this turn (e.g. a token-picker after the user said "send token" without
      * naming one). Preserves emission order; drops malformed entries.
      */
+    /**
+     * Uppercase only the FIRST character of a button click-prompt so it reads as
+     * a proper sentence when echoed as the user's sent message. Language-agnostic:
+     * locale-aware casing on the leading character only, a harmless no-op for
+     * scripts without letter case (e.g. Japanese/Chinese). Uses code-point
+     * iteration so a leading surrogate-pair/emoji isn't split.
+     */
+    private capitalizeFirst;
     private collectActionButtons;
     private collectUiActions;
     /**
@@ -5881,6 +5904,32 @@ declare class BuyTokenTool extends BaseTool {
     private buildResult;
     private normaliseAddress;
     private normaliseAmount;
+    /**
+     * Deterministically fix which SIDE an amount belongs to. The LLM occasionally
+     * assigns the spend amount to the wrong field — e.g. "buy WETH with 0.0000011
+     * WBTC" arriving as buy_amount="0.0000011" when 0.0000011 is the WBTC (pay)
+     * amount. When EXACTLY one amount is present and BOTH token symbols are named,
+     * we read the RAW user query and assign the amount to whichever symbol it
+     * physically sits next to. Language-agnostic: proximity/position only, never
+     * prepositions ("with"/"bằng"/"で"). Only corrects when the number AND both
+     * symbols are found verbatim in the query (high confidence); otherwise it
+     * leaves the LLM's assignment untouched, so a correct call is never worsened.
+     */
+    private correctAmountSide;
+    /**
+     * Decide which named token an amount sits next to in the raw query by text
+     * proximity. Returns 'buy' / 'pay' for the closer symbol, or `null` when the
+     * number or either symbol can't be located as a standalone token (caller then
+     * declines to override). Symbols match on token boundaries so "ETH" is not
+     * found inside "WETH".
+     */
+    private nearestSymbolSide;
+    /**
+     * indexOf for a symbol token that must stand alone (not be a substring of a
+     * larger alphanumeric word) — so "eth" matches in "with eth" but not in "weth".
+     * Returns the symbol's index, or -1 when not present as a standalone token.
+     */
+    private indexOfToken;
     private requireChain;
     /**
      * Resolve a token reference (symbol "USDC" or address "0x…") on a chain.