@babav/knowledge-core-client 0.53.0 → 0.54.0

package/dist/index.d.ts

@@ -167,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). */
@@ -720,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.53.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

@@ -199,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 {
@@ -795,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. */
@@ -1439,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;