@babav/knowledge-core-client 0.22.2 → 0.22.4

package/dist/index.d.ts

@@ -51,6 +51,7 @@ export interface RetrievalContent {
 }
 export interface QueryOverrides {
     generation_model?: string;
+    generation_model_mode?: string;
     max_response_tokens?: number;
     top_k_retrieved_chunks?: number;
     top_k_reranked_chunks?: number;
@@ -68,6 +69,7 @@ export interface QueryOverrides {
 /** Per-request visual overrides (see VisualRequest). */
 export interface VisualOverrides {
     concept_model?: string;
+    concept_model_mode?: string;
     concept_vet_model?: string;
     max_revisions?: number;
     claims_check_model?: string;
@@ -107,8 +109,9 @@ export interface Visual {
         height: number;
     };
 }
-/** First event of the visual stage (streaming): generation has started. `pending` = number of
- *  concepts about to be rendered, or null when not yet known. */
+/** Visual stage (streaming): generation has started. MAY be emitted twice — first with
+ *  `pending: null` (started, count unknown), then again with the ACCURATE post-vet count before
+ *  rendering. Take the LATEST value; `visuals_complete.count` is always authoritative. */
 export interface VisualsPending {
     pending: number | null;
 }
@@ -256,6 +259,7 @@ export interface Agent {
     identity_prompt: string | null;
     response_prompt: string | null;
     generation_model: string | null;
+    generation_model_mode: string | null;
     max_response_tokens: number | null;
     top_k_retrieved_chunks: number | null;
     top_k_reranked_chunks: number | null;
@@ -450,7 +454,7 @@ export declare class KnowledgeCoreClient extends HttpBase {
     folders: {
         create: (corpusId: UUID, name: string) => Promise<Folder>;
         rename: (folderId: UUID, name: string) => Promise<Folder>;
-        delete: (folderId: UUID) => Promise<void>;
+        delete: (folderId: UUID, confirmName?: string) => Promise<void>;
         listDocuments: (folderId: UUID, q?: {
             limit?: number;
             cursor?: string;
@@ -570,6 +574,7 @@ export declare class AdminClient extends HttpBase {
             identity_prompt?: string;
             response_prompt?: string;
             generation_model?: string;
+            generation_model_mode?: string;
             max_response_tokens?: number;
             top_k_retrieved_chunks?: number;
             top_k_reranked_chunks?: number;

package/dist/index.js

@@ -246,7 +246,10 @@ export class KnowledgeCoreClient extends HttpBase {
     folders = {
         create: (corpusId, name) => this.request("POST", `/v1/corpora/${corpusId}/folders`, { json: { name } }),
         rename: (folderId, name) => this.request("PATCH", `/v1/folders/${folderId}`, { json: { name } }),
-        delete: (folderId) => this.request("DELETE", `/v1/folders/${folderId}`),
+        // Plain delete requires the folder to be EMPTY (else 409). Pass `confirmName` (the folder's
+        // name) to CASCADE — delete the folder AND every document in it (async, 202). The default
+        // folder cannot be deleted either way.
+        delete: (folderId, confirmName) => this.request("DELETE", `/v1/folders/${folderId}`, confirmName ? { query: { confirm: confirmName } } : undefined),
         listDocuments: (folderId, q) => this.request("GET", `/v1/folders/${folderId}/documents`, { query: q }),
         /** Count documents in the folder: { total, indexed, in_flight, failed }. */
         countDocuments: (folderId) => this.request("GET", `/v1/folders/${folderId}/documents/count`),

package/package.json

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

@@ -72,6 +72,7 @@ export interface RetrievalContent {
 
 export interface QueryOverrides {
   generation_model?: string;
+  generation_model_mode?: string;   // "reasoning" (adaptive thinking) | "standard" — how the TEXT answer is generated
   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
@@ -90,6 +91,7 @@ export interface QueryOverrides {
 /** Per-request visual overrides (see VisualRequest). */
 export interface VisualOverrides {
   concept_model?: string;
+  concept_model_mode?: string;  // "reasoning" | "standard" — how visual concepts are generated; OVERRULES generation_model_mode when combining
   concept_vet_model?: string;
   max_revisions?: number;
   claims_check_model?: string;
@@ -125,8 +127,9 @@ export interface Visual {
   image?: { url: string; expires_at: number; width: number; height: number };
 }
 
-/** First event of the visual stage (streaming): generation has started. `pending` = number of
- *  concepts about to be rendered, or null when not yet known. */
+/** Visual stage (streaming): generation has started. MAY be emitted twice — first with
+ *  `pending: null` (started, count unknown), then again with the ACCURATE post-vet count before
+ *  rendering. Take the LATEST value; `visuals_complete.count` is always authoritative. */
 export interface VisualsPending {
   pending: number | null;
 }
@@ -274,6 +277,7 @@ export interface Agent {
   identity_prompt: string | null;   // answer-system: who/purpose (null => server default)
   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-agent
   max_response_tokens: number | null;
   top_k_retrieved_chunks: number | null;
   top_k_reranked_chunks: number | null;
@@ -590,7 +594,11 @@ export class KnowledgeCoreClient extends HttpBase {
   folders = {
     create: (corpusId: UUID, name: string) => this.request<Folder>("POST", `/v1/corpora/${corpusId}/folders`, { json: { name } }),
     rename: (folderId: UUID, name: string) => this.request<Folder>("PATCH", `/v1/folders/${folderId}`, { json: { name } }),
-    delete: (folderId: UUID) => this.request<void>("DELETE", `/v1/folders/${folderId}`),
+    // Plain delete requires the folder to be EMPTY (else 409). Pass `confirmName` (the folder's
+    // name) to CASCADE — delete the folder AND every document in it (async, 202). The default
+    // folder cannot be deleted either way.
+    delete: (folderId: UUID, confirmName?: string) =>
+      this.request<void>("DELETE", `/v1/folders/${folderId}`, confirmName ? { query: { confirm: confirmName } } : undefined),
     listDocuments: (folderId: UUID, q?: { limit?: number; cursor?: string }) =>
       this.request<Page<Document>>("GET", `/v1/folders/${folderId}/documents`, { query: q }),
     /** Count documents in the folder: { total, indexed, in_flight, failed }. */
@@ -691,7 +699,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; max_response_tokens?: number; top_k_retrieved_chunks?: number; top_k_reranked_chunks?: number; sibling_window?: number; rerank_instruction?: string; max_subqueries?: number; max_reasoning_rounds?: number; decomposition_model?: string; reasoning_inspect_model?: string; groundedness_verifier_model?: string; groundedness_threshold?: number; grounding_enabled?: boolean; citations_enabled?: boolean }) =>
+    create: (b: { name: string; identity_prompt?: string; response_prompt?: string; generation_model?: string; generation_model_mode?: string; max_response_tokens?: number; top_k_retrieved_chunks?: number; top_k_reranked_chunks?: number; sibling_window?: number; rerank_instruction?: string; max_subqueries?: number; max_reasoning_rounds?: number; decomposition_model?: string; reasoning_inspect_model?: string; groundedness_verifier_model?: string; 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 }),