keyring-agent-core 0.2.14 → 0.2.16

package/dist/index.d.ts

@@ -1220,9 +1220,9 @@ interface AgentConfig {
     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=…`). */
+        /** CoinPool pair API base url (`<base>/pair/v2?chainId=…`). */
         coinPoolBaseUrl?: string;
-        /** Keyring pool API base url (`<base>/user/positions-details/v3?…`). */
+        /** @deprecated No longer used — CoinPool `/pair/v2` returns APR + ranges directly. */
         keyringPoolBaseUrl?: string;
         /** Override subgraph URLs per hex chain id. */
         subgraphUrls?: Record<string, string>;
@@ -1653,10 +1653,23 @@ declare class AgentCore {
      */
     private stampLanguage;
     private addUserMessage;
-    /** Single KB lookup — callers reuse the result for both context + short-circuit. */
+    /**
+     * Single KB lookup — callers reuse the result for both context + short-circuit.
+     *
+     * We fetch the FULL candidate set (minScore floor bypassed) in ONE query. The
+     * minScore gating is then applied locally by the consumers: `formatKBContext`
+     * keeps only above-threshold hits as reference material, while the intent
+     * guard in `tryAnswerFromKB` widens to every candidate (so a truly-equivalent
+     * FAQ the embedding underscored below minScore is still considered, provided
+     * at least one hit cleared the threshold).
+     */
     private searchKB;
     private snippet;
-    /** Format KB hits as a reference-block string for LLM consumption. */
+    /**
+     * Format KB hits as a reference-block string for LLM consumption. Only hits
+     * that clear `kbAnswerThreshold` become reference material — `searchKB`
+     * returns the unfiltered candidate set, so the score floor is enforced here.
+     */
     private formatKBContext;
     private tryAnswerFromKB;
     private answerDirectly;
@@ -5074,9 +5087,9 @@ declare class EstimatePoolYieldTool extends BaseTool {
 interface SubgraphServiceConfig {
     /** The Graph API key. Falls back to a public demo key. */
     theGraphApiKey?: string;
-    /** CoinPool pair list base url (`/pair/pure-list`). */
+    /** CoinPool pair API base url (`/pair/v2`). */
     coinPoolBaseUrl?: string;
-    /** Keyring pool API base url (`/user/positions-details/v3`). */
+    /** @deprecated No longer used — CoinPool `/pair/v2` returns APR + ranges directly. */
     keyringPoolBaseUrl?: string;
     /** Override a subgraph URL by chain hex id. */
     subgraphUrls?: Record<string, string>;
@@ -5483,8 +5496,8 @@ type SubgraphCoinPoolPairsToolConfig = SubgraphServiceConfig;
  * user asks about price ranges, "which range to pick", or "best range"
  * for a known token pair.
  *
- * Requires both `coinPoolBaseUrl` and `keyringPoolBaseUrl` to be set in
- * SubgraphServiceConfig — otherwise the tool returns an empty list.
+ * Backed by the CoinPool `/pair/v2` endpoint (`coinPoolBaseUrl`). Returns an
+ * empty list when that base url is unset or the chain is unsupported.
  */
 declare class SubgraphCoinPoolPairsTool extends BaseTool {
     name: string;
@@ -6912,7 +6925,14 @@ declare class UpstashKnowledgeBase implements KnowledgeBaseProvider {
     private readonly fusionAlgorithm;
     private readonly debug;
     constructor(config?: UpstashKnowledgeBaseConfig);
-    search(query: string, maxResults?: number): Promise<KBSearchResult[]>;
+    /**
+     * @param opts.applyMinScore When `false`, every retrieved candidate is
+     *   returned regardless of the `minScore` floor (callers do their own
+     *   gating). Defaults to `true` — drop hits below `minScore`.
+     */
+    search(query: string, maxResults?: number, opts?: {
+        applyMinScore?: boolean;
+    }): Promise<KBSearchResult[]>;
     /**
      * Upsert one or more entries. Idempotent — same `id` overwrites the
      * existing record. When `id` is omitted, a stable hash of the question