@camstack/types 1.2.260 → 1.2.262

package/dist/capabilities/notification-rules.cap.d.ts

@@ -421,8 +421,8 @@ export type NcCrossing = z.infer<typeof NcCrossingSchema>;
  * that means the same as absence is a second way to write one rule.
  */
 export declare const NcSensorTransitionSchema: z.ZodEnum<{
-    raised: "raised";
     cleared: "cleared";
+    raised: "raised";
 }>;
 export type NcSensorTransition = z.infer<typeof NcSensorTransitionSchema>;
 /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
@@ -703,8 +703,8 @@ export declare const NcConditionsSchema: z.ZodObject<{
     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sensorTransition: z.ZodOptional<z.ZodEnum<{
-        raised: "raised";
         cleared: "cleared";
+        raised: "raised";
     }>>;
     packagePhase: z.ZodOptional<z.ZodEnum<{
         both: "both";
@@ -840,6 +840,24 @@ export declare const NcLinkedCameraModeSchema: z.ZodEnum<{
     each: "each";
 }>;
 export type NcLinkedCameraMode = z.infer<typeof NcLinkedCameraModeSchema>;
+/**
+ * The clip window a rule gets when it stores no `clipPreRollSec` /
+ * `clipPostRollSec` (D654): 4 s before the moment, 6 s after.
+ *
+ * THE one owner. The Notification Center resolves an absent roll to these at
+ * dispatch and sizes the broker's clip ring from them (`clip-retention-ask`).
+ * The admin editor does not author the roll; the viewer editor still keeps its
+ * own 3 / 7 until it imports these (viewer follow-up). A second copy is how the
+ * viewer came to display 3 / 7 — copied from a stale comment on the schema
+ * below — while the hub cut 4 / 6, and to prune a typed 3 back to "absent",
+ * which the hub then read as 4.
+ *
+ * A product decision of the notification, not the broker's history window
+ * (D381/D382): the clip is cut from the broker's per-camera clip ring, which
+ * the rules size, not from a pre-roll dial.
+ */
+export declare const NC_CLIP_PRE_ROLL_DEFAULT_SEC = 4;
+export declare const NC_CLIP_POST_ROLL_DEFAULT_SEC = 6;
 export declare const NcMediaPolicySchema: z.ZodObject<{
     attach: z.ZodDefault<z.ZodEnum<{
         none: "none";
@@ -1028,8 +1046,8 @@ export declare const NcRuleInputSchema: z.ZodObject<{
         eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorTransition: z.ZodOptional<z.ZodEnum<{
-            raised: "raised";
             cleared: "cleared";
+            raised: "raised";
         }>>;
         packagePhase: z.ZodOptional<z.ZodEnum<{
             both: "both";
@@ -1428,8 +1446,8 @@ export declare const NcRulePatchSchema: z.ZodObject<{
         eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorTransition: z.ZodOptional<z.ZodEnum<{
-            raised: "raised";
             cleared: "cleared";
+            raised: "raised";
         }>>;
         packagePhase: z.ZodOptional<z.ZodEnum<{
             both: "both";
@@ -1743,8 +1761,8 @@ export declare const NcRuleUpdateInputSchema: z.ZodObject<{
             eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
             sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             sensorTransition: z.ZodOptional<z.ZodEnum<{
-                raised: "raised";
                 cleared: "cleared";
+                raised: "raised";
             }>>;
             packagePhase: z.ZodOptional<z.ZodEnum<{
                 both: "both";
@@ -1944,8 +1962,8 @@ export declare const NcRuleSchema: z.ZodObject<{
         eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorTransition: z.ZodOptional<z.ZodEnum<{
-            raised: "raised";
             cleared: "cleared";
+            raised: "raised";
         }>>;
         packagePhase: z.ZodOptional<z.ZodEnum<{
             both: "both";
@@ -3371,8 +3389,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -3668,8 +3686,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -3963,8 +3981,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -4252,8 +4270,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -4652,8 +4670,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -4851,8 +4869,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -5228,8 +5246,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -5542,8 +5560,8 @@ export declare const notificationRulesCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";

package/dist/capabilities/osd-manager.cap.d.ts

@@ -140,8 +140,8 @@ export declare const OsdSlotBindingSchema: z.ZodObject<{
         eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
         sensorTransition: z.ZodOptional<z.ZodEnum<{
-            raised: "raised";
             cleared: "cleared";
+            raised: "raised";
         }>>;
         packagePhase: z.ZodOptional<z.ZodEnum<{
             both: "both";
@@ -325,8 +325,8 @@ export declare const OsdSlotViewSchema: z.ZodObject<{
             eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
             sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
             sensorTransition: z.ZodOptional<z.ZodEnum<{
-                raised: "raised";
                 cleared: "cleared";
+                raised: "raised";
             }>>;
             packagePhase: z.ZodOptional<z.ZodEnum<{
                 both: "both";
@@ -582,8 +582,8 @@ export declare const osdManagerCapability: {
                         eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         sensorTransition: z.ZodOptional<z.ZodEnum<{
-                            raised: "raised";
                             cleared: "cleared";
+                            raised: "raised";
                         }>>;
                         packagePhase: z.ZodOptional<z.ZodEnum<{
                             both: "both";
@@ -858,8 +858,8 @@ export declare const osdManagerCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";
@@ -1042,8 +1042,8 @@ export declare const osdManagerCapability: {
                         eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                         sensorTransition: z.ZodOptional<z.ZodEnum<{
-                            raised: "raised";
                             cleared: "cleared";
+                            raised: "raised";
                         }>>;
                         packagePhase: z.ZodOptional<z.ZodEnum<{
                             both: "both";
@@ -1258,8 +1258,8 @@ export declare const osdManagerCapability: {
                     eventTypeTokens: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     sensorTransition: z.ZodOptional<z.ZodEnum<{
-                        raised: "raised";
                         cleared: "cleared";
+                        raised: "raised";
                     }>>;
                     packagePhase: z.ZodOptional<z.ZodEnum<{
                         both: "both";

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -731,6 +731,7 @@ declare const MediaFileKindEnum: z.ZodEnum<{
     confirmationCrop: "confirmationCrop";
     debugCrop: "debugCrop";
     sceneFrame: "sceneFrame";
+    lastSceneFrame: "lastSceneFrame";
 }>;
 export type MediaFileKind = z.infer<typeof MediaFileKindEnum>;
 /**
@@ -760,6 +761,7 @@ declare const MediaFileRefSchema: z.ZodObject<{
         confirmationCrop: "confirmationCrop";
         debugCrop: "debugCrop";
         sceneFrame: "sceneFrame";
+        lastSceneFrame: "lastSceneFrame";
     }>;
     sizeBytes: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -836,6 +838,7 @@ declare const MediaFileSchema: z.ZodObject<{
         confirmationCrop: "confirmationCrop";
         debugCrop: "debugCrop";
         sceneFrame: "sceneFrame";
+        lastSceneFrame: "lastSceneFrame";
     }>;
     sizeBytes: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -875,6 +878,7 @@ declare const MediaFileInfoSchema: z.ZodObject<{
         confirmationCrop: "confirmationCrop";
         debugCrop: "debugCrop";
         sceneFrame: "sceneFrame";
+        lastSceneFrame: "lastSceneFrame";
     }>;
     mediaId: z.ZodNumber;
     sizeBytes: z.ZodNumber;
@@ -1017,6 +1021,7 @@ export declare const RetrainFrameCandidateSchema: z.ZodObject<{
         confirmationCrop: "confirmationCrop";
         debugCrop: "debugCrop";
         sceneFrame: "sceneFrame";
+        lastSceneFrame: "lastSceneFrame";
     }>;
     timestamp: z.ZodNumber;
     sizeBytes: z.ZodNumber;
@@ -1045,6 +1050,7 @@ export declare const RetrainFrameSchema: z.ZodObject<{
         confirmationCrop: "confirmationCrop";
         debugCrop: "debugCrop";
         sceneFrame: "sceneFrame";
+        lastSceneFrame: "lastSceneFrame";
     }>;
     sizeBytes: z.ZodNumber;
     width: z.ZodNumber;
@@ -1080,6 +1086,7 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
             confirmationCrop: "confirmationCrop";
             debugCrop: "debugCrop";
             sceneFrame: "sceneFrame";
+            lastSceneFrame: "lastSceneFrame";
         }>;
         sizeBytes: z.ZodNumber;
         width: z.ZodNumber;
@@ -1115,6 +1122,7 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
             confirmationCrop: "confirmationCrop";
             debugCrop: "debugCrop";
             sceneFrame: "sceneFrame";
+            lastSceneFrame: "lastSceneFrame";
         }>;
         timestamp: z.ZodNumber;
         sizeBytes: z.ZodNumber;
@@ -1141,6 +1149,7 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
             confirmationCrop: "confirmationCrop";
             debugCrop: "debugCrop";
             sceneFrame: "sceneFrame";
+            lastSceneFrame: "lastSceneFrame";
         }>;
         sizeBytes: z.ZodNumber;
         width: z.ZodNumber;
@@ -1747,6 +1756,7 @@ declare const EventMediaKindFootprintSchema: z.ZodObject<{
         confirmationCrop: "confirmationCrop";
         debugCrop: "debugCrop";
         sceneFrame: "sceneFrame";
+        lastSceneFrame: "lastSceneFrame";
     }>;
     rows: z.ZodNumber;
     bytes: z.ZodNumber;
@@ -1796,6 +1806,7 @@ declare const EventMediaKindBreakdownSchema: z.ZodObject<{
             confirmationCrop: "confirmationCrop";
             debugCrop: "debugCrop";
             sceneFrame: "sceneFrame";
+            lastSceneFrame: "lastSceneFrame";
         }>;
         rows: z.ZodNumber;
         bytes: z.ZodNumber;
@@ -1811,6 +1822,38 @@ declare const EventPruneCountsSchema: z.ZodObject<{
     audio: z.ZodNumber;
 }, z.core.$strip>;
 export type EventPruneCounts = z.infer<typeof EventPruneCountsSchema>;
+/**
+ * Why a rebuild did not start, BY NAME — ONE vocabulary for both gates in front
+ * of a pass (D649 over D651). A bare `started: false` read the same for "the
+ * stores are booting" and "the cluster row names a model with no CLIP
+ * metadata", which need different fixes.
+ *  - `stores-unavailable` — the analytics stores or the API are not up yet.
+ *  - the owner's confirmation of the cluster model (D651, `ClusterPinConfirmer`):
+ *    a pass that rewrites an index needs two agreeing reads of the OWNER's
+ *    answer (`pipelineOrchestrator.getClusterModelChoice`) — a pass that cannot
+ *    name its model does not run (D54):
+ *    - the owner's own `unreadable` reasons (`owner-not-ready`,
+ *      `store-read-failed`, `three-way-read-unavailable`, `invalid-stored`,
+ *      `not-cluster-scoped`);
+ *    - `method-unavailable` — the orchestrator predates the method;
+ *    - `read-failed` — the call failed or answered something unparseable;
+ *    - `reads-disagree` — the two reads named different choices.
+ *  - `not-a-clip-model` — the CONFIRMED id has no CLIP metadata, so there is no
+ *    index to fill and no dimension to check against (D649).
+ */
+export declare const RebuildObjectEmbeddingsRefusalSchema: z.ZodEnum<{
+    "owner-not-ready": "owner-not-ready";
+    "store-read-failed": "store-read-failed";
+    "three-way-read-unavailable": "three-way-read-unavailable";
+    "invalid-stored": "invalid-stored";
+    "not-cluster-scoped": "not-cluster-scoped";
+    "stores-unavailable": "stores-unavailable";
+    "method-unavailable": "method-unavailable";
+    "read-failed": "read-failed";
+    "reads-disagree": "reads-disagree";
+    "not-a-clip-model": "not-a-clip-model";
+}>;
+export type RebuildObjectEmbeddingsRefusal = z.infer<typeof RebuildObjectEmbeddingsRefusalSchema>;
 /**
  * The long-term series a camera produces. A closed union so a typo cannot
  * invent one, and the ONE declaration of it — the addon's `AnalyticsLtsSeries`
@@ -3210,6 +3253,7 @@ export declare const pipelineAnalyticsCapability: {
                     confirmationCrop: "confirmationCrop";
                     debugCrop: "debugCrop";
                     sceneFrame: "sceneFrame";
+                    lastSceneFrame: "lastSceneFrame";
                 }>;
                 rows: z.ZodNumber;
                 bytes: z.ZodNumber;
@@ -3604,6 +3648,7 @@ export declare const pipelineAnalyticsCapability: {
                     confirmationCrop: "confirmationCrop";
                     debugCrop: "debugCrop";
                     sceneFrame: "sceneFrame";
+                    lastSceneFrame: "lastSceneFrame";
                 }>;
                 timestamp: z.ZodNumber;
                 sizeBytes: z.ZodNumber;
@@ -3630,6 +3675,7 @@ export declare const pipelineAnalyticsCapability: {
                     confirmationCrop: "confirmationCrop";
                     debugCrop: "debugCrop";
                     sceneFrame: "sceneFrame";
+                    lastSceneFrame: "lastSceneFrame";
                 }>;
                 sizeBytes: z.ZodNumber;
                 width: z.ZodNumber;
@@ -3678,6 +3724,7 @@ export declare const pipelineAnalyticsCapability: {
                     confirmationCrop: "confirmationCrop";
                     debugCrop: "debugCrop";
                     sceneFrame: "sceneFrame";
+                    lastSceneFrame: "lastSceneFrame";
                 }>;
                 sizeBytes: z.ZodNumber;
                 width: z.ZodNumber;
@@ -4023,6 +4070,7 @@ export declare const pipelineAnalyticsCapability: {
                 confirmationCrop: "confirmationCrop";
                 debugCrop: "debugCrop";
                 sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
             }>>;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -4043,6 +4091,7 @@ export declare const pipelineAnalyticsCapability: {
                 confirmationCrop: "confirmationCrop";
                 debugCrop: "debugCrop";
                 sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
             }>;
             sizeBytes: z.ZodNumber;
             timestamp: z.ZodNumber;
@@ -4071,6 +4120,7 @@ export declare const pipelineAnalyticsCapability: {
                 confirmationCrop: "confirmationCrop";
                 debugCrop: "debugCrop";
                 sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
             }>>>;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -4091,6 +4141,7 @@ export declare const pipelineAnalyticsCapability: {
                 confirmationCrop: "confirmationCrop";
                 debugCrop: "debugCrop";
                 sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
             }>;
             sizeBytes: z.ZodNumber;
             timestamp: z.ZodNumber;
@@ -4133,6 +4184,7 @@ export declare const pipelineAnalyticsCapability: {
                 confirmationCrop: "confirmationCrop";
                 debugCrop: "debugCrop";
                 sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
             }>;
             mediaId: z.ZodNumber;
             sizeBytes: z.ZodNumber;
@@ -4182,6 +4234,7 @@ export declare const pipelineAnalyticsCapability: {
                 confirmationCrop: "confirmationCrop";
                 debugCrop: "debugCrop";
                 sceneFrame: "sceneFrame";
+                lastSceneFrame: "lastSceneFrame";
             }>;
             mediaId: z.ZodNumber;
             sizeBytes: z.ZodNumber;
@@ -4236,7 +4289,13 @@ export declare const pipelineAnalyticsCapability: {
             until: z.ZodOptional<z.ZodNumber>;
             classFilter: z.ZodOptional<z.ZodString>;
             limit: z.ZodDefault<z.ZodNumber>;
-            minScore: z.ZodDefault<z.ZodNumber>;
+            minScore: z.ZodOptional<z.ZodNumber>;
+            strictness: z.ZodOptional<z.ZodEnum<{
+                loose: "loose";
+                balanced: "balanced";
+                strict: "strict";
+            }>>;
+            modelId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             confidence: z.ZodOptional<z.ZodNumber>;
             bbox: z.ZodOptional<z.ZodObject<{
@@ -4302,9 +4361,12 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
             timestamp: z.ZodNumber;
             score: z.ZodNumber;
-        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind> & {
+            readonly caller: "required";
+        };
         readonly wipeObjectEmbeddings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
             deleted: z.ZodNumber;
+            failedIndexes: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>, "mutation">;
         readonly rebuildObjectEmbeddings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodOptional<z.ZodNumber>;
@@ -4316,6 +4378,20 @@ export declare const pipelineAnalyticsCapability: {
         }, z.core.$strip>, z.ZodObject<{
             started: z.ZodBoolean;
             alreadyRunning: z.ZodBoolean;
+            refusal: z.ZodOptional<z.ZodEnum<{
+                "owner-not-ready": "owner-not-ready";
+                "store-read-failed": "store-read-failed";
+                "three-way-read-unavailable": "three-way-read-unavailable";
+                "invalid-stored": "invalid-stored";
+                "not-cluster-scoped": "not-cluster-scoped";
+                "stores-unavailable": "stores-unavailable";
+                "method-unavailable": "method-unavailable";
+                "read-failed": "read-failed";
+                "reads-disagree": "reads-disagree";
+                "not-a-clip-model": "not-a-clip-model";
+            }>>;
+            modelId: z.ZodOptional<z.ZodString>;
+            index: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "mutation">;
         readonly getObjectEmbeddingRebuildStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
             running: z.ZodBoolean;
@@ -4330,6 +4406,8 @@ export declare const pipelineAnalyticsCapability: {
             startedAtMs: z.ZodNullable<z.ZodNumber>;
             finishedAtMs: z.ZodNullable<z.ZodNumber>;
             error: z.ZodNullable<z.ZodString>;
+            modelId: z.ZodNullable<z.ZodString>;
+            index: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
     };
     readonly events: {

package/dist/capabilities/pipeline-executor.cap.d.ts

@@ -1125,6 +1125,7 @@ export declare const pipelineExecutorCapability: {
         readonly inferCached: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             stepId: z.ZodString;
             frameId: z.ZodNumber;
+            modelId: z.ZodString;
         }, z.core.$strip>, z.ZodRecord<z.ZodString, z.ZodUnknown>, "mutation">;
         /**
          * Release a cached frame from the Python pool's memory.

package/dist/capabilities/pipeline-orchestrator.cap.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS } from '../pipeline/cluster-model-scope.js';
 import { type InferProvider } from './capability-definition.js';
 declare const CameraPipelineConfigSchema: z.ZodObject<{
     engine: z.ZodOptional<z.ZodObject<{
@@ -573,6 +574,31 @@ declare const NodeInferenceDeviceSchema: z.ZodObject<{
         "accelerator-preferred": "accelerator-preferred";
     }>>;
 }, z.core.$strip>;
+export { CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS };
+/**
+ * The operator's model choice for one cluster-scoped step, answered by the
+ * addon that OWNS the `clusterModel:*` settings (D651). Three answers, never
+ * folded: a written choice, a key nobody wrote (the cluster runs the default
+ * BY ABSENCE), or no answer. A caller that rewrites an index acts only on the
+ * first two, read twice and agreeing.
+ */
+export declare const ClusterModelChoiceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"stored">;
+    modelId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"absent">;
+    defaultModelId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"unreadable">;
+    reason: z.ZodEnum<{
+        "owner-not-ready": "owner-not-ready";
+        "store-read-failed": "store-read-failed";
+        "three-way-read-unavailable": "three-way-read-unavailable";
+        "invalid-stored": "invalid-stored";
+        "not-cluster-scoped": "not-cluster-scoped";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
 declare const NodeInferenceDevicesSchema: z.ZodObject<{
     nodeId: z.ZodString;
     reachable: z.ZodBoolean;
@@ -701,10 +727,18 @@ export declare const pipelineOrchestratorCapability: {
          * Trigger a full rebalance pass. Iterates over all assigned cameras,
          * recomputes the optimal agent for each one based on current load +
          * hardware affinity, and migrates cameras whose current agent is no
-         * longer optimal. Pinned cameras are never migrated.
+         * longer optimal. Pinned cameras are never migrated. `skipped` names the
+         * cameras the pass wanted to move and could not, with why — a target node
+         * that has not answered its catalog / device health yet, or a device that
+         * cannot run the camera's root (D650).
          */
         readonly rebalance: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             migrated: z.ZodNumber;
+            skipped: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                deviceId: z.ZodNumber;
+                targetNodeId: z.ZodString;
+                reason: z.ZodString;
+            }, z.core.$strip>>>;
         }, z.core.$strip>, "mutation">;
         /** Get the full camera-to-agent assignment map. */
         readonly getPipelineAssignments: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -762,6 +796,31 @@ export declare const pipelineOrchestratorCapability: {
             score: z.ZodNumber;
             decodeHwaccel: z.ZodNullable<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * The operator's STORED model choice for one cluster-scoped step (D651).
+         * Read three-way from this addon's own store, only once its boot has
+         * settled. Unlike `addonSettings.getGlobalSettings`, it never answers a
+         * default as though someone chose it.
+         */
+        readonly getClusterModelChoice: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            stepId: z.ZodString;
+        }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"stored">;
+            modelId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"absent">;
+            defaultModelId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"unreadable">;
+            reason: z.ZodEnum<{
+                "owner-not-ready": "owner-not-ready";
+                "store-read-failed": "store-read-failed";
+                "three-way-read-unavailable": "three-way-read-unavailable";
+                "invalid-stored": "invalid-stored";
+                "not-cluster-scoped": "not-cluster-scoped";
+            }>;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "kind">, import("./capability-definition.js").CapabilityMethodKind>;
         /** Aggregate global metrics across the whole detection cluster. */
         readonly getGlobalMetrics: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
             totalAgents: z.ZodNumber;
@@ -1888,6 +1947,8 @@ export declare const pipelineOrchestratorCapability: {
     };
 };
 export type IPipelineOrchestratorProvider = InferProvider<typeof pipelineOrchestratorCapability>;
+export type ClusterModelChoice = z.infer<typeof ClusterModelChoiceSchema>;
+export type ClusterModelChoiceUnreadableReason = (typeof CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS)[number];
 export type DiskReconcileJob = z.infer<typeof DiskReconcileJobSchema>;
 export type CameraStatus = z.infer<typeof CameraStatusSchema>;
 export type CameraStatusDegradation = z.infer<typeof CameraStatusDegradationSchema>;

package/dist/capabilities/pipeline-runner.cap.d.ts

@@ -291,6 +291,18 @@ export declare const RunnerFrameSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     hubHostnameOverride: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>], "kind">;
 export type RunnerFrameSource = z.infer<typeof RunnerFrameSourceSchema>;
+/**
+ * What ONE step runs with on ONE roster device for THIS camera (D650): the
+ * device's per-(node,device) base with the camera's override for that device
+ * on top — the same `override ?? base` merge the orchestrator applies to the
+ * elected device (`applyDeviceProvisioning`). Absent `modelId` ⇒ the executor
+ * resolves the device format's default, exactly as on the elected device.
+ */
+export declare const RunnerJumpStepProvisioningSchema: z.ZodObject<{
+    modelId: z.ZodOptional<z.ZodString>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type RunnerJumpStepProvisioning = z.infer<typeof RunnerJumpStepProvisioningSchema>;
 /**
  * One ENABLED inference device on the runner's node, as the step-tree
  * device-jump resolver sees it (phase 1). The orchestrator populates this
@@ -304,6 +316,10 @@ export declare const RunnerInferenceDeviceSchema: z.ZodObject<{
     deviceKey: z.ZodString;
     weight: z.ZodDefault<z.ZodNumber>;
     maxSessions: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    steps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        modelId: z.ZodOptional<z.ZodString>;
+        settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type RunnerInferenceDevice = z.infer<typeof RunnerInferenceDeviceSchema>;
 /**
@@ -388,6 +404,10 @@ declare const RunnerCameraConfigSchema: z.ZodObject<{
         deviceKey: z.ZodString;
         weight: z.ZodDefault<z.ZodNumber>;
         maxSessions: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        steps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            modelId: z.ZodOptional<z.ZodString>;
+            settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>>>>;
 }, z.core.$strip>;
 /**
@@ -672,6 +692,10 @@ export declare const pipelineRunnerCapability: {
                 deviceKey: z.ZodString;
                 weight: z.ZodDefault<z.ZodNumber>;
                 maxSessions: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+                steps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    modelId: z.ZodOptional<z.ZodString>;
+                    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
             }, z.core.$strip>>>>;
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodLiteral<true>;

package/dist/capabilities/vector-store.cap.d.ts

@@ -232,6 +232,20 @@ export declare const VectorScanResultSchema: z.ZodObject<{
     }, z.core.$strip>>;
     nextCursor: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
+/**
+ * The ONE error code for "this index exists at another dimension; refusing to
+ * redeclare it" (D649). It rides in the MESSAGE — an Error's own properties do
+ * not survive the UDS/tRPC hop, its message does — and both sides go through
+ * the helpers below, never a copied phrase: a consumer that must tell "this
+ * index can never hold my vectors" from "the provider is unreachable" (a
+ * delete counts the first as nothing-to-delete and the second as still
+ * present) otherwise breaks silently the day the wording changes.
+ */
+export declare const VECTOR_INDEX_DIM_CONFLICT = "vector-index-dim-conflict";
+/** The provider's refusal, carrying {@link VECTOR_INDEX_DIM_CONFLICT}. */
+export declare function vectorIndexDimConflictError(index: string, declaredDim: number, requestedDim: number): Error;
+/** True when `err` (possibly re-wrapped by a transport) is that refusal. */
+export declare function isVectorIndexDimConflict(err: unknown): boolean;
 export declare const VectorStatsInputSchema: z.ZodObject<{
     index: z.ZodString;
 }, z.core.$strip>;

package/dist/device-extension/index.d.ts

@@ -0,0 +1,3 @@
+export type { ExtensionSlotCardinality, ExtensionSlotDescriptor, ExtensionSlotShape, } from './slot-descriptor.js';
+export { createDeviceExtensionProvider, defineExtensionSlotProvider, extensionSlotRef, type DeviceExtensionProviderOptions, type ExtensionSlotImpl, type ExtensionSlotListing, type ExtensionSlotProvider, type ExtensionSlotValueOf, } from './slot-provider.js';
+export { EXTENSION_HOST_DEVICE_TYPES, EXTENSION_SLOT_IDS, EXTENSION_SLOTS, ExtensionSlotIdSchema, ExtensionSlotValueSchema, type ExtensionSlotEntry, type ExtensionSlotId, type ExtensionSlotValue, } from '../generated/extension-slots.js';