@babav/knowledge-core-client 0.53.0 → 0.55.0

package/dist/index.d.ts

@@ -53,6 +53,7 @@ export interface RetrievalContent {
 export interface QueryOverrides {
     generation_model?: string;
     generation_model_mode?: string;
+    rewrite_model?: string;
     max_response_tokens?: number;
     top_k_retrieved_chunks?: number;
     top_k_reranked_chunks?: number;
@@ -167,6 +168,7 @@ export interface QueryResponse {
     standalone_query: string | null;
     visuals?: Visual[];
     visuals_meta?: VisualsMeta | null;
+    conversation_title?: string | null;
 }
 export interface Citation {
     /** Char span IN THE ANSWER this citation supports (for highlighting). */
@@ -516,6 +518,7 @@ export interface QueryProfile {
     response_prompt: string | null;
     generation_model: string | null;
     generation_model_mode: string | null;
+    rewrite_model: string | null;
     max_response_tokens: number | null;
     top_k_retrieved_chunks: number | null;
     top_k_reranked_chunks: number | null;
@@ -720,6 +723,12 @@ export interface StreamHandlers {
      *  (native path). Also present in `final`. May be `{}` if scoring was unavailable. */
     onGroundedness?: (g: Groundedness | Record<string, never>) => void;
     onFinal?: (d: QueryResponse) => void;
+    /** Conversation auto-title, refreshed after `final` (conversational turns only). Update the
+     *  sidebar title live. Fires at most once per turn; absent when locked/one-shot/disabled. */
+    onConversationTitle?: (t: {
+        conversation_id: UUID;
+        title: string;
+    }) => void;
     /** First event of the trailing visual stage — visual generation has STARTED (fires after
      *  `final`/`groundedness`, before any `visual`). `pending` is how many concepts are about to be
      *  rendered (or null when not yet known). Use it to show a "generating visual(s)" state. */

package/dist/index.js

@@ -648,6 +648,9 @@ function dispatchSse(frame, h) {
         case "final":
             h.onFinal?.(data);
             break;
+        case "conversation_title":
+            h.onConversationTitle?.(data);
+            break;
         case "visuals_pending":
             h.onVisualsPending?.(data);
             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babav/knowledge-core-client",
-  "version": "0.53.0",
+  "version": "0.55.0",
   "description": "TypeScript client for the Babav Knowledge Core API (Deno + Node 18+, zero deps). Includes the babav.visual grammar TYPES at the ./visual subpath (types only; all visual rendering is server-side).",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -74,6 +74,7 @@ export interface RetrievalContent {
 export interface QueryOverrides {
   generation_model?: string;
   generation_model_mode?: string;   // "reasoning" (adaptive thinking) | "standard" — how the TEXT answer is generated
+  rewrite_model?: string;           // conversational rewrite model; null/unset => generation_model
   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
@@ -199,6 +200,7 @@ export interface QueryResponse {
   standalone_query: string | null;
   visuals?: Visual[]; // [] when off/none
   visuals_meta?: VisualsMeta | null;
+  conversation_title?: string | null; // auto-title refreshed this turn (null if locked/one-shot/off)
 }
 
 export interface Citation {
@@ -482,6 +484,7 @@ export interface QueryProfile {
   response_prompt: string | null;   // answer-system: output guidelines (null => server default)
   generation_model: string | null;
   generation_model_mode: string | null;  // "reasoning" (adaptive thinking) | "standard"; per-profile
+  rewrite_model: string | null;          // conversational rewrite model; null => generation_model
   max_response_tokens: number | null;
   top_k_retrieved_chunks: number | null;
   top_k_reranked_chunks: number | null;
@@ -795,6 +798,9 @@ export interface StreamHandlers {
    *  (native path). Also present in `final`. May be `{}` if scoring was unavailable. */
   onGroundedness?: (g: Groundedness | Record<string, never>) => void;
   onFinal?: (d: QueryResponse) => void;
+  /** Conversation auto-title, refreshed after `final` (conversational turns only). Update the
+   *  sidebar title live. Fires at most once per turn; absent when locked/one-shot/disabled. */
+  onConversationTitle?: (t: { conversation_id: UUID; title: string }) => void;
   /** First event of the trailing visual stage — visual generation has STARTED (fires after
    *  `final`/`groundedness`, before any `visual`). `pending` is how many concepts are about to be
    *  rendered (or null when not yet known). Use it to show a "generating visual(s)" state. */
@@ -1439,6 +1445,7 @@ function dispatchSse(frame: string, h: StreamHandlers): void {
     case "citation": h.onCitation?.(data as Citation); break;
     case "groundedness": h.onGroundedness?.(data as never); break;
     case "final": h.onFinal?.(data as QueryResponse); break;
+    case "conversation_title": h.onConversationTitle?.(data as { conversation_id: UUID; title: string }); break;
     case "visuals_pending": h.onVisualsPending?.(data as VisualsPending); break;
     case "visual": h.onVisual?.(data as Visual); break;
     case "visuals_complete": h.onVisualsComplete?.(data as VisualsMeta); break;