@babav/knowledge-core-client 0.14.0 → 0.16.0

package/dist/index.d.ts

@@ -51,9 +51,14 @@ export interface RetrievalContent {
 }
 export interface QueryOverrides {
     generation_model?: string;
-    top_k?: number;
+    max_response_tokens?: number;
+    top_k_retrieved_chunks?: number;
+    top_k_reranked_chunks?: number;
+    sibling_window?: number;
     rerank_instruction?: string;
     max_hops?: number;
+    decomposition_model?: string;
+    groundedness_verifier_model?: string;
     groundedness_threshold?: number;
     grounding_enabled?: boolean;
     citations_enabled?: boolean;
@@ -199,9 +204,14 @@ export interface Agent {
     identity_prompt: string | null;
     response_prompt: string | null;
     generation_model: string | null;
-    top_k: number | null;
+    max_response_tokens: number | null;
+    top_k_retrieved_chunks: number | null;
+    top_k_reranked_chunks: number | null;
+    sibling_window: number | null;
     rerank_instruction: string | null;
     max_hops: number | null;
+    decomposition_model: string | null;
+    groundedness_verifier_model: string | null;
     groundedness_threshold: number | null;
     grounding_enabled: boolean | null;
     citations_enabled: boolean | null;
@@ -291,7 +301,8 @@ export declare class KnowledgeCoreClient extends HttpBase {
     retrieve(body: {
         query: string;
         corpus_ids: UUID[];
-        top_k?: number;
+        top_k_retrieved_chunks?: number;
+        top_k_reranked_chunks?: number;
         rerank?: boolean;
         instruction?: string;
         filter?: MetadataFilter;
@@ -496,9 +507,14 @@ export declare class AdminClient extends HttpBase {
             identity_prompt?: string;
             response_prompt?: string;
             generation_model?: string;
-            top_k?: number;
+            max_response_tokens?: number;
+            top_k_retrieved_chunks?: number;
+            top_k_reranked_chunks?: number;
+            sibling_window?: number;
             rerank_instruction?: string;
             max_hops?: number;
+            decomposition_model?: string;
+            groundedness_verifier_model?: string;
             groundedness_threshold?: number;
             grounding_enabled?: boolean;
             citations_enabled?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babav/knowledge-core-client",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "TypeScript client for the Babav Knowledge Core API (Deno + Node 18+, zero deps).",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -61,9 +61,14 @@ export interface RetrievalContent {
 
 export interface QueryOverrides {
   generation_model?: string;
-  top_k?: number;
+  max_response_tokens?: number;     // max answer tokens
+  top_k_retrieved_chunks?: number;  // candidate pool pulled from hybrid search (recall net)
+  top_k_reranked_chunks?: number;   // sections kept after rerank -> the LLM
+  sibling_window?: number;          // adjacent sections fetched each side of a hit
   rerank_instruction?: string;
   max_hops?: number;
+  decomposition_model?: string;     // model for query decomposition
+  groundedness_verifier_model?: string;  // model for the groundedness LLM judge
   groundedness_threshold?: number;
   grounding_enabled?: boolean;   // groundedness score (default off)
   citations_enabled?: boolean;   // source attribution (default on)
@@ -212,9 +217,14 @@ export interface Agent {
   identity_prompt: string | null;   // answer-system: who/purpose (null => server default)
   response_prompt: string | null;   // answer-system: output guidelines (null => server default)
   generation_model: string | null;
-  top_k: number | null;
+  max_response_tokens: number | null;
+  top_k_retrieved_chunks: number | null;
+  top_k_reranked_chunks: number | null;
+  sibling_window: number | null;
   rerank_instruction: string | null;
   max_hops: number | null;
+  decomposition_model: string | null;
+  groundedness_verifier_model: string | null;
   groundedness_threshold: number | null;
   grounding_enabled: boolean | null;
   citations_enabled: boolean | null;
@@ -456,7 +466,7 @@ export class KnowledgeCoreClient extends HttpBase {
   }
 
   // --- retrieve (cross-corpus primitive, no generation) ---
-  retrieve(body: { query: string; corpus_ids: UUID[]; top_k?: number; rerank?: boolean; instruction?: string; filter?: MetadataFilter; }): Promise<{ retrieval_contents: RetrievalContent[] }> {
+  retrieve(body: { query: string; corpus_ids: UUID[]; top_k_retrieved_chunks?: number; top_k_reranked_chunks?: number; rerank?: boolean; instruction?: string; filter?: MetadataFilter; }): Promise<{ retrieval_contents: RetrievalContent[] }> {
     return this.request("POST", "/v1/retrieve", { json: body });
   }
 
@@ -632,7 +642,7 @@ export class AdminClient extends HttpBase {
 
   // Agents are query agents, global for now.
   agents = {
-    create: (b: { name: string; identity_prompt?: string; response_prompt?: string; generation_model?: string; top_k?: number; rerank_instruction?: string; max_hops?: number; groundedness_threshold?: number; grounding_enabled?: boolean; citations_enabled?: boolean }) =>
+    create: (b: { name: string; identity_prompt?: string; response_prompt?: string; generation_model?: string; max_response_tokens?: number; top_k_retrieved_chunks?: number; top_k_reranked_chunks?: number; sibling_window?: number; rerank_instruction?: string; max_hops?: number; decomposition_model?: string; groundedness_verifier_model?: string; groundedness_threshold?: number; grounding_enabled?: boolean; citations_enabled?: boolean }) =>
       this.request<Agent>("POST", "/v1/agents", { json: b }),
     update: (id: UUID, b: Partial<Omit<Agent, "id">>) =>
       this.request<Agent>("PATCH", `/v1/agents/${id}`, { json: b }),