keyring-agent-core 0.2.15 → 0.2.16

package/dist/index.d.ts

@@ -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;
@@ -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