@babav/knowledge-core-client 0.52.0 → 0.54.0

package/dist/index.d.ts

@@ -77,6 +77,7 @@ export interface VisualOverrides {
     max_revisions?: number;
     claims_check_model?: string;
     vision_judge_model?: string;
+    image_gen_model?: string;
 }
 /** Per-request visual control. Absent => mode resolves from the profile default. All visual
  * PROCESSING is server-side; the client only displays the result. */
@@ -166,6 +167,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). */
@@ -537,6 +539,7 @@ export interface QueryProfile {
     visual_proposer_model: string | null;
     visual_claims_check_model: string | null;
     visual_vision_judge_model: string | null;
+    visual_image_gen_model: string | null;
     visual_max_revisions: number | null;
     visual_combine_generation_and_concept: boolean | null;
     concept_model_mode: string | null;
@@ -718,6 +721,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.52.0",
+  "version": "0.54.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

@@ -99,6 +99,7 @@ export interface VisualOverrides {
   max_revisions?: number;
   claims_check_model?: string;
   vision_judge_model?: string;
+  image_gen_model?: string;  // scenic image generator (profile field: visual_image_gen_model)
 }
 
 /** Per-request visual control. Absent => mode resolves from the profile default. All visual
@@ -198,6 +199,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 {
@@ -504,6 +506,7 @@ export interface QueryProfile {
   visual_proposer_model: string | null;      // authors the HTML figure + chart/structural/scene specs
   visual_claims_check_model: string | null;
   visual_vision_judge_model: string | null;  // Vertex Gemini model
+  visual_image_gen_model: string | null;     // Vertex Gemini image-gen model (scenic register)
   visual_max_revisions: number | null;
   visual_combine_generation_and_concept: boolean | null;
   concept_model_mode: string | null;         // "reasoning" | "standard"; overrules gen mode when combining
@@ -793,6 +796,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. */
@@ -1437,6 +1443,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;