@camstack/types 1.2.315 → 1.2.317

package/dist/pipeline/best-settings/recommend.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The Best settings recommender (D745): one detector per node, from ONE family
+ * (YOLOv9) for the whole cluster, chosen from static hardware facts × the
+ * measured latency table × the node's detection demand. Pure; no benchmark.
+ *
+ * Per node:
+ *  1. Classify the hardware (`classifyInferenceHardware`). An unknown class,
+ *     an offline node or a node with nothing to recommend is left untouched.
+ *  2. The node's ACCELERATORS (NPU, iGPU, Neural Engine) that are enabled and
+ *     available share ONE model — so a camera's floors never flip with the
+ *     device the balancer rotated it onto. A candidate must have a build for
+ *     every accelerator's format and a latency cell for each.
+ *  3. A candidate FITS a device when its throughput, less the headroom, covers
+ *     the device's demand and the single fastest camera that can land on it.
+ *  4. Among candidates that fit everywhere, the most accurate wins (person
+ *     recall at the shipped floor); within `RECALL_TIE` of the best, the
+ *     fastest wins. That IS the step-down order the data gives: the first
+ *     variant down from m-640 is s-640-int8, not m-320.
+ *  5. An enabled CPU device (the fallback pool) gets its own pick the same
+ *     way; a Coral is never touched (no YOLOv9 build), only reported.
+ */
+import type { HardwareInfo } from '../../interfaces/platform.js';
+import type { ModelFormat } from '../../types/models.js';
+import { type DetectorPerfTable } from './detector-performance.js';
+import type { DeviceDemand, NodeRecommendation } from './plan-schemas.js';
+/** The family the cluster runs. */
+export declare const BEST_SETTINGS_FAMILY = "yolov9";
+/** Recall within this of the best counts as a tie — the faster one wins. */
+export declare const RECALL_TIE = 0.02;
+/** Default share of an accelerator's throughput kept free. */
+export declare const DEFAULT_HEADROOM = 0.4;
+/** One device of a node, as the recommender reads it. */
+export interface BestSettingsDeviceInput {
+    readonly key: string;
+    readonly format: ModelFormat;
+    readonly enabled: boolean;
+    readonly available: boolean;
+}
+/** One node, as the recommender reads it. */
+export interface BestSettingsNodeInput {
+    readonly nodeId: string;
+    readonly reachable: boolean;
+    readonly hardware: HardwareInfo | null;
+    readonly devices: readonly BestSettingsDeviceInput[];
+    /** Object-detection model id → the formats it has a build for, from the node's catalog. */
+    readonly formatsByModel: Readonly<Record<string, readonly ModelFormat[]>>;
+}
+/** Recommend one node. See the module header. */
+export declare function recommendNode(input: {
+    readonly node: BestSettingsNodeInput;
+    readonly demand: readonly DeviceDemand[];
+    readonly headroom?: number;
+    readonly perf?: DetectorPerfTable;
+}): NodeRecommendation;

package/dist/pipeline/model-bound-settings.d.ts

@@ -33,6 +33,7 @@
  * runner (`addon-pipeline`) and the editors (`ui-library`, `addon-admin-ui`)
  * apply the same rule.
  */
+import type { ConfigField } from '../interfaces/config-ui.js';
 /** `minConfidencePerson` → `minConfidencePersonModelId`. */
 export declare function modelBindingKey(key: string): string;
 /** A loose step-settings bag, as it is stored and travels. */
@@ -80,3 +81,9 @@ export declare function hasModelBoundOverrides(settings: ModelBoundSettingsBag |
  * that model runs.
  */
 export declare function clearModelBoundOverrides(settings: ModelBoundSettingsBag | undefined, boundKeys: readonly string[], modelId: string | undefined): Record<string, unknown>;
+/**
+ * The keys of every `bindsToModel` field of a step's config schema, groups
+ * flattened (D738). One definition for the runner (which applies the binding)
+ * and the orchestrator's Best settings (which clears those overrides, D745).
+ */
+export declare function collectModelBoundKeys(fields: readonly ConfigField[]): string[];

package/dist/types/models.d.ts

@@ -27,6 +27,51 @@ export declare const ModelFormatEntrySchema: z.ZodObject<{
     revision: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ModelFormatEntry = z.infer<typeof ModelFormatEntrySchema>;
+/**
+ * What a node holds for one (model, format) (D746). `current` is a complete
+ * copy at its catalog revision — exactly what `downloaded: true` means.
+ * `stale` is bytes on disk that are not (yet) proven current under D743/D744:
+ * no or a different revision record, or a missing sibling. `missing` is no
+ * copy. `downloaded` alone folds `stale` into "not downloaded", which hid
+ * reclaimable bytes and a copy about to be replaced.
+ */
+export declare const ModelOnDiskStateSchema: z.ZodEnum<{
+    missing: "missing";
+    current: "current";
+    stale: "stale";
+}>;
+export type ModelOnDiskState = z.infer<typeof ModelOnDiskStateSchema>;
+/**
+ * The numeric precision of one format's BUILD (D746) — reported only when the
+ * build states it (file-name token, an INT8 variant, an EdgeTPU compile, a
+ * CamStack Core ML export). Absent means "not stated", never "fp32".
+ */
+export declare const ModelFormatPrecisionSchema: z.ZodEnum<{
+    fp32: "fp32";
+    fp16: "fp16";
+    int8: "int8";
+}>;
+export type ModelFormatPrecision = z.infer<typeof ModelFormatPrecisionSchema>;
+/**
+ * One format of one model as a node's `pipelineExecutor.getSchema` reports it.
+ * `onDisk` / `precision` are optional for version skew: a runner that predates
+ * them omits them, and a reader falls back to `downloaded`.
+ */
+export declare const PipelineModelFormatStatusSchema: z.ZodObject<{
+    downloaded: z.ZodBoolean;
+    sizeMB: z.ZodNumber;
+    onDisk: z.ZodOptional<z.ZodEnum<{
+        missing: "missing";
+        current: "current";
+        stale: "stale";
+    }>>;
+    precision: z.ZodOptional<z.ZodEnum<{
+        fp32: "fp32";
+        fp16: "fp16";
+        int8: "int8";
+    }>>;
+}, z.core.$strip>;
+export type PipelineModelFormatStatus = z.infer<typeof PipelineModelFormatStatusSchema>;
 /**
  * Extra file that must be downloaded alongside the model (e.g., labels JSON, dict.txt).
  * The downloader fetches from `url` and saves to `{modelsDir}/{filename}`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.315",
+  "version": "1.2.317",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",