@babav/knowledge-core-client 0.50.0 → 0.52.0

package/dist/index.d.ts

@@ -540,7 +540,7 @@ export interface QueryProfile {
     visual_max_revisions: number | null;
     visual_combine_generation_and_concept: boolean | null;
     concept_model_mode: string | null;
-    scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale" | null;
+    scoring_status: "no_score" | "queued" | "running" | "scored" | null;
     scoring_progress_done: number | null;
     scoring_progress_total: number | null;
     scoring_updated_at: string | null;
@@ -555,7 +555,8 @@ export type QueryProfileWrite = Partial<Omit<QueryProfile, "id" | "tenant_id" |
 /** Model catalog for the query-profile-config UI (GET /v1/query-profiles/model-options). `models` maps id → its
  *  capabilities; `fields` gives each profile 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. */
+ *  supports_reasoning is true); `rerankers` gives the supported values for a profile's `reranker_provider`
+ *  field + the system default. KC provides the data; the UI decides presentation. */
 export interface ModelOptions {
     models: Record<string, {
         label: string;
@@ -574,6 +575,11 @@ export interface ModelOptions {
         depends_on: string;
         values: string[];
     }>;
+    /** Supported `reranker_provider` values (null on a profile => system default). */
+    rerankers: {
+        supported: string[];
+        default: string;
+    };
 }
 export type BenchmarkTier = "client_quick" | "screening" | "full";
 export type BenchmarkCategory = "quality" | "quality_cost" | "quality_latency";
@@ -583,7 +589,7 @@ export interface BenchmarkScore {
     cache_hit: boolean;
     config_hash: string;
     eval_version: string | null;
-    scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale";
+    scoring_status: "no_score" | "queued" | "running" | "scored";
     composite_q: number | null;
     sub_scores: Record<string, unknown>;
     per_language: Record<string, number>;

package/package.json

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

@@ -510,7 +510,11 @@ export interface QueryProfile {
   // --- score-my-profile status/progress (READ-only; not settable) ---------------------------------
   // Durable on the profile so a client can kick scoring, leave, and see the status/result on any later
   // read. score_composite_q/score_scored_at are the cached score for the CURRENT eval version.
-  scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale" | null;
+  // Authoritative, derived from reality on every read: "scored" (a score exists), "running"/"queued"
+  // (a run is actively in progress, see scoring_progress_*), or "no_score" (no score and nothing
+  // running — covers never-scored, a failed/interrupted attempt, or a config change). Never a lingering
+  // "failed". null only transiently before the first read enriches it — treat null as "no_score".
+  scoring_status: "no_score" | "queued" | "running" | "scored" | null;
   scoring_progress_done: number | null;
   scoring_progress_total: number | null;
   scoring_updated_at: string | null;         // ISO timestamp; heartbeat while running
@@ -529,11 +533,14 @@ export type QueryProfileWrite = Partial<Omit<QueryProfile,
 /** Model catalog for the query-profile-config UI (GET /v1/query-profiles/model-options). `models` maps id → its
  *  capabilities; `fields` gives each profile 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. */
+ *  supports_reasoning is true); `rerankers` gives the supported values for a profile's `reranker_provider`
+ *  field + the system default. KC provides the data; the UI decides presentation. */
 export interface ModelOptions {
   models: Record<string, { label: string; provider: "anthropic" | "vertex" | "moonshot"; 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[] }>;
+  /** Supported `reranker_provider` values (null on a profile => system default). */
+  rerankers: { supported: string[]; default: string };
 }
 
 // ---- benchmark (score-my-profile + leaderboards) --------------------------
@@ -546,7 +553,7 @@ export interface BenchmarkScore {
   cache_hit: boolean;
   config_hash: string;
   eval_version: string | null;
-  scoring_status: "unscored" | "queued" | "running" | "scored" | "failed" | "stale";
+  scoring_status: "no_score" | "queued" | "running" | "scored";
   composite_q: number | null;
   sub_scores: Record<string, unknown>;
   per_language: Record<string, number>;