@crossworks/client-types 0.232.220 → 0.232.222

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/client-types",
-  "version": "0.232.220",
+  "version": "0.232.222",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/dto/rows.ts

@@ -702,6 +702,19 @@ export type ContextSnapshot = {
     ms: number;
     cached: boolean;
   };
+  /** The decider's `version_grouping` use, when it ran on this turn. Part A
+   *  (code): hits whose living successor is also in the pool. Part B (the
+   *  model): passages judged a version of a higher-ranked passage from an
+   *  unlinked node. `shadow`: counts only; `live`: dropped. */
+  versionGrouping?: {
+    mode: 'shadow' | 'live';
+    threshold: number;
+    wouldDrop: { superseded: number; versions: number };
+    /** Candidate pairs asked about (0 = no model call). */
+    pairs: number;
+    ms: number;
+    cached: boolean;
+  };
 };
 
 export type BackupFrequency = 'daily' | 'weekly';

package/src/dto/views.ts

@@ -86,6 +86,21 @@ export type ModelSpend = {
   tokensOut: number;
   cacheReadTokens: number;
   calls: number;
+  /** Per-use split of this model's calls, for models that serve typed
+   *  decisions (trace_steps.meta.use, the decider's uses). Absent otherwise. */
+  uses?: UseSpend[];
+};
+
+/** One decider use's share of a model's spend (see ModelSpend.uses). */
+export type UseSpend = {
+  use: string;
+  costMicroUsd: number;
+  tokensIn: number;
+  calls: number;
+  /** Calls that returned no decision (step skipped: decision_failed). */
+  failed: number;
+  /** Mean call time over the answered calls, from meta.decision_ms. */
+  avgMs: number | null;
 };
 
 export type DailySpend = {