@babav/knowledge-core-client 0.33.0 → 0.35.0

package/dist/index.d.ts

@@ -417,6 +417,7 @@ export interface Feedback {
 }
 export interface Agent {
     id: UUID;
+    tenant_id: UUID | null;
     name: string;
     identity_prompt: string | null;
     response_prompt: string | null;
@@ -435,6 +436,41 @@ export interface Agent {
     groundedness_threshold: number | null;
     grounding_enabled: boolean | null;
     citations_enabled: boolean | null;
+    visual_mode_default: string | null;
+    visual_concept_model: string | null;
+    visual_concept_vet_model: string | null;
+    visual_proposer_model: string | null;
+    visual_claims_check_model: string | null;
+    visual_vision_judge_model: string | null;
+    visual_max_revisions: number | null;
+    visual_combine_generation_and_concept: boolean | null;
+    concept_model_mode: string | null;
+}
+/** Fields settable when creating/updating an agent. All optional (null/omit => server default); model
+ *  fields must be one of `getModelOptions().fields[field].supported`. `tenant_id` is create-only. */
+export type AgentWrite = Partial<Omit<Agent, "id" | "tenant_id">>;
+/** Model catalog for the agent-config UI (GET /v1/agents/model-options). `models` maps id → its
+ *  capabilities; `fields` gives each agent model-field its supported ids + default (+ usage metadata);
+ *  `modes` says which model field governs each mode (reasoning is valid only if that model's
+ *  supports_reasoning is true). KC provides the data; the UI decides presentation. */
+export interface ModelOptions {
+    models: Record<string, {
+        label: string;
+        provider: "anthropic" | "vertex";
+        kind: "text" | "vision";
+        supports_reasoning: boolean;
+    }>;
+    fields: Record<string, {
+        supported: string[];
+        default: string;
+        applies_when?: string;
+        applies_to?: string[];
+        note?: string;
+    }>;
+    modes: Record<string, {
+        depends_on: string;
+        values: string[];
+    }>;
 }
 export interface Tenant {
     id: UUID;
@@ -923,28 +959,24 @@ export declare class AdminClient extends HttpBase {
         revokeApiKey: (tenantId: UUID, keyId: UUID) => Promise<void>;
     };
     agents: {
-        create: (b: {
+        /** List agents (admin). Pass `tenant_id` for one tenant's agents (+ global); omit for all agents
+         *  across every tenant. (A tenant lists its own via KnowledgeCoreClient.agents.list.) */
+        list: (q?: {
+            tenant_id?: UUID;
+            limit?: number;
+            cursor?: string;
+        }) => Promise<Page<Agent>>;
+        listAll: (tenantId?: UUID) => Promise<Agent[]>;
+        get: (id: UUID) => Promise<Agent>;
+        create: (b: AgentWrite & {
             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;
+            tenant_id?: UUID | null;
         }) => Promise<Agent>;
-        update: (id: UUID, b: Partial<Omit<Agent, "id">>) => Promise<Agent>;
+        update: (id: UUID, b: AgentWrite) => Promise<Agent>;
         delete: (id: UUID) => Promise<void>;
+        /** The model catalog for an agent-config UI: supported models + default per field, per-model
+         *  capabilities (`supports_reasoning`), and mode↔model dependencies. */
+        modelOptions: () => Promise<ModelOptions>;
     };
 }
 export interface ChatSendOptions extends StreamHandlers {

package/dist/index.js

@@ -490,11 +490,20 @@ export class AdminClient extends HttpBase {
         listApiKeys: (tenantId, q) => this.request("GET", `/v1/tenants/${tenantId}/api-keys`, { query: q }),
         revokeApiKey: (tenantId, keyId) => this.request("DELETE", `/v1/tenants/${tenantId}/api-keys/${keyId}`),
     };
-    // Agents are query agents, global for now.
+    // Agent provisioning (query agents). Pass `tenant_id` on create for a per-tenant agent; omit (or
+    // null) for a Babav-global one. Model fields are validated against the model registry server-side.
     agents = {
+        /** List agents (admin). Pass `tenant_id` for one tenant's agents (+ global); omit for all agents
+         *  across every tenant. (A tenant lists its own via KnowledgeCoreClient.agents.list.) */
+        list: (q) => this.request("GET", "/v1/agents", { query: q }),
+        listAll: (tenantId) => this.pageAll("/v1/agents", tenantId ? { tenant_id: tenantId } : {}),
+        get: (id) => this.request("GET", `/v1/agents/${id}`),
         create: (b) => this.request("POST", "/v1/agents", { json: b }),
         update: (id, b) => this.request("PATCH", `/v1/agents/${id}`, { json: b }),
         delete: (id) => this.request("DELETE", `/v1/agents/${id}`),
+        /** The model catalog for an agent-config UI: supported models + default per field, per-model
+         *  capabilities (`supports_reasoning`), and mode↔model dependencies. */
+        modelOptions: () => this.request("GET", "/v1/agents/model-options"),
     };
 }
 /** A chat session bound to ONE conversation (created via `kc.chat(...)`). Every `send()` is ALWAYS

package/package.json

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

@@ -399,6 +399,7 @@ export interface Feedback {
 }
 export interface Agent {
   id: UUID;
+  tenant_id: UUID | null;            // null => Babav-global agent; a tenant id => per-tenant
   name: string;
   identity_prompt: string | null;   // answer-system: who/purpose (null => server default)
   response_prompt: string | null;   // answer-system: output guidelines (null => server default)
@@ -417,6 +418,30 @@ export interface Agent {
   groundedness_threshold: number | null;
   grounding_enabled: boolean | null;
   citations_enabled: boolean | null;
+  // Visual pipeline defaults (null => server default; overridable per request).
+  visual_mode_default: string | null;        // "off" | "on"
+  visual_concept_model: string | null;
+  visual_concept_vet_model: string | null;
+  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_max_revisions: number | null;
+  visual_combine_generation_and_concept: boolean | null;
+  concept_model_mode: string | null;         // "reasoning" | "standard"; overrules gen mode when combining
+}
+
+/** Fields settable when creating/updating an agent. All optional (null/omit => server default); model
+ *  fields must be one of `getModelOptions().fields[field].supported`. `tenant_id` is create-only. */
+export type AgentWrite = Partial<Omit<Agent, "id" | "tenant_id">>;
+
+/** Model catalog for the agent-config UI (GET /v1/agents/model-options). `models` maps id → its
+ *  capabilities; `fields` gives each agent model-field its supported ids + default (+ usage metadata);
+ *  `modes` says which model field governs each mode (reasoning is valid only if that model's
+ *  supports_reasoning is true). KC provides the data; the UI decides presentation. */
+export interface ModelOptions {
+  models: Record<string, { label: string; provider: "anthropic" | "vertex"; kind: "text" | "vision"; supports_reasoning: boolean }>;
+  fields: Record<string, { supported: string[]; default: string; applies_when?: string; applies_to?: string[]; note?: string }>;
+  modes: Record<string, { depends_on: string; values: string[] }>;
 }
 export interface Tenant {
   id: UUID;
@@ -1065,13 +1090,23 @@ export class AdminClient extends HttpBase {
     revokeApiKey: (tenantId: UUID, keyId: UUID) => this.request<void>("DELETE", `/v1/tenants/${tenantId}/api-keys/${keyId}`),
   };
 
-  // Agents are query agents, global for now.
+  // Agent provisioning (query agents). Pass `tenant_id` on create for a per-tenant agent; omit (or
+  // null) for a Babav-global one. Model fields are validated against the model registry server-side.
   agents = {
-    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 }) =>
+    /** List agents (admin). Pass `tenant_id` for one tenant's agents (+ global); omit for all agents
+     *  across every tenant. (A tenant lists its own via KnowledgeCoreClient.agents.list.) */
+    list: (q?: { tenant_id?: UUID; limit?: number; cursor?: string }) =>
+      this.request<Page<Agent>>("GET", "/v1/agents", { query: q }),
+    listAll: (tenantId?: UUID) => this.pageAll<Agent>("/v1/agents", tenantId ? { tenant_id: tenantId } : {}),
+    get: (id: UUID) => this.request<Agent>("GET", `/v1/agents/${id}`),
+    create: (b: AgentWrite & { name: string; tenant_id?: UUID | null }) =>
       this.request<Agent>("POST", "/v1/agents", { json: b }),
-    update: (id: UUID, b: Partial<Omit<Agent, "id">>) =>
+    update: (id: UUID, b: AgentWrite) =>
       this.request<Agent>("PATCH", `/v1/agents/${id}`, { json: b }),
     delete: (id: UUID) => this.request<void>("DELETE", `/v1/agents/${id}`),
+    /** The model catalog for an agent-config UI: supported models + default per field, per-model
+     *  capabilities (`supports_reasoning`), and mode↔model dependencies. */
+    modelOptions: () => this.request<ModelOptions>("GET", "/v1/agents/model-options"),
   };
 }