@babav/knowledge-core-client 0.51.0 → 0.53.0

package/dist/index.d.ts

@@ -77,6 +77,7 @@ export interface VisualOverrides {
     max_revisions?: number;
     claims_check_model?: string;
     vision_judge_model?: string;
+    image_gen_model?: string;
 }
 /** Per-request visual control. Absent => mode resolves from the profile default. All visual
  * PROCESSING is server-side; the client only displays the result. */
@@ -537,10 +538,11 @@ export interface QueryProfile {
     visual_proposer_model: string | null;
     visual_claims_check_model: string | null;
     visual_vision_judge_model: string | null;
+    visual_image_gen_model: string | null;
     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;
@@ -589,7 +591,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.51.0",
+  "version": "0.53.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

@@ -99,6 +99,7 @@ export interface VisualOverrides {
   max_revisions?: number;
   claims_check_model?: string;
   vision_judge_model?: string;
+  image_gen_model?: string;  // scenic image generator (profile field: visual_image_gen_model)
 }
 
 /** Per-request visual control. Absent => mode resolves from the profile default. All visual
@@ -504,13 +505,18 @@ export interface QueryProfile {
   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_image_gen_model: string | null;     // Vertex Gemini image-gen model (scenic register)
   visual_max_revisions: number | null;
   visual_combine_generation_and_concept: boolean | null;
   concept_model_mode: string | null;         // "reasoning" | "standard"; overrules gen mode when combining
   // --- 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
@@ -549,7 +555,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>;