@babav/knowledge-core-client 0.11.0 → 0.12.1

package/dist/index.d.ts

@@ -56,6 +56,7 @@ export interface QueryOverrides {
     max_hops?: number;
     groundedness_threshold?: number;
     grounding_enabled?: boolean;
+    citations_enabled?: boolean;
 }
 export interface QueryRequest {
     corpus_ids: UUID[];
@@ -87,8 +88,11 @@ export interface Citation {
     source_url: string | null;
 }
 export interface GroundednessSentence {
-    /** Char span IN THE ANSWER of this sentence. */
+    /** Char span into the RAW answer (concatenated tokens / `final.answer`). */
     text_span: [number, number];
+    /** The exact sentence text — highlight by matching this in the rendered output
+     *  (robust to markdown rendering + inserted citation markers) rather than offsets. */
+    text: string;
     score: number;
     passed: boolean | null;
 }
@@ -192,6 +196,7 @@ export interface Agent {
     max_hops: number | null;
     groundedness_threshold: number | null;
     grounding_enabled: boolean | null;
+    citations_enabled: boolean | null;
 }
 export interface Tenant {
     id: UUID;
@@ -492,6 +497,7 @@ export declare class AdminClient extends HttpBase {
             max_hops?: number;
             groundedness_threshold?: number;
             grounding_enabled?: boolean;
+            citations_enabled?: boolean;
         }) => Promise<Agent>;
         update: (id: UUID, b: Partial<Omit<Agent, "id">>) => Promise<Agent>;
         delete: (id: UUID) => Promise<void>;

package/package.json

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

package/src/index.ts

@@ -65,7 +65,8 @@ export interface QueryOverrides {
   rerank_instruction?: string;
   max_hops?: number;
   groundedness_threshold?: number;
-  grounding_enabled?: boolean;
+  grounding_enabled?: boolean;   // HHEM groundedness score (default off)
+  citations_enabled?: boolean;   // source attribution (default on)
 }
 
 export interface QueryRequest {
@@ -102,8 +103,11 @@ export interface Citation {
 }
 
 export interface GroundednessSentence {
-  /** Char span IN THE ANSWER of this sentence. */
+  /** Char span into the RAW answer (concatenated tokens / `final.answer`). */
   text_span: [number, number];
+  /** The exact sentence text — highlight by matching this in the rendered output
+   *  (robust to markdown rendering + inserted citation markers) rather than offsets. */
+  text: string;
   score: number;
   passed: boolean | null;
 }
@@ -205,6 +209,7 @@ export interface Agent {
   max_hops: number | null;
   groundedness_threshold: number | null;
   grounding_enabled: boolean | null;
+  citations_enabled: boolean | null;
 }
 export interface Tenant {
   id: UUID;
@@ -623,7 +628,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 }) =>
+    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 }) =>
       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 }),