@babav/knowledge-core-client 0.27.0 → 0.28.0

package/dist/index.d.ts

@@ -468,8 +468,12 @@ declare class HttpBase {
     protected pageAll<T>(path: string, query?: RequestOpts["query"]): Promise<T[]>;
 }
 export interface StreamHandlers {
+    /** Retrieval milestone. `retrieval_contents` is the reranked top_k (unchanged).
+     *  `retrieved_count` is the total distinct candidate chunks fetched across ALL corpora
+     *  (and sub-queries) BEFORE reranking/truncation — i.e. the recall-net size. */
     onSources?: (d: {
         retrieval_contents: RetrievalContent[];
+        retrieved_count: number;
     }) => void;
     onToken?: (text: string) => void;
     /** A citation, emitted inline as the answer streams (Claude/native path). Also

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@babav/knowledge-core-client",
-  "version": "0.27.0",
+  "version": "0.28.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

@@ -551,7 +551,10 @@ const MULTIPART_MAX_BYTES = 30 * 1024 * 1024;
 // SSE handlers
 // ---------------------------------------------------------------------------
 export interface StreamHandlers {
-  onSources?: (d: { retrieval_contents: RetrievalContent[] }) => void;
+  /** Retrieval milestone. `retrieval_contents` is the reranked top_k (unchanged).
+   *  `retrieved_count` is the total distinct candidate chunks fetched across ALL corpora
+   *  (and sub-queries) BEFORE reranking/truncation — i.e. the recall-net size. */
+  onSources?: (d: { retrieval_contents: RetrievalContent[]; retrieved_count: number }) => void;
   onToken?: (text: string) => void;
   /** A citation, emitted inline as the answer streams (Claude/native path). Also
    *  present aggregated in the `final` event. */