@camstack/types 1.2.16 → 1.2.18

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

@@ -46,9 +46,9 @@ import { type InferProvider } from './capability-definition.js';
  * one trigger.
  */
 export declare const NcDeliverySchema: z.ZodEnum<{
+    "device-event": "device-event";
     immediate: "immediate";
     "track-end": "track-end";
-    "device-event": "device-event";
     "package-event": "package-event";
 }>;
 export type NcDelivery = z.infer<typeof NcDeliverySchema>;
@@ -108,6 +108,30 @@ export declare const NcOccupancyConditionSchema: z.ZodObject<{
     sustainSeconds: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 export type NcOccupancyCondition = z.infer<typeof NcOccupancyConditionSchema>;
+/**
+ * Which zone-crossing DIRECTION a rule accepts (`ObjectEvent.zoneCrossing`).
+ *
+ * The values are not symmetric, and deliberately so — the absent value has to
+ * mean exactly what every rule authored before this condition existed already
+ * does:
+ *  - `enter` — entries and every NON-crossing record (movement state,
+ *    package, sensor). Exits are rejected. **This is the absent behaviour**:
+ *    an operator who never asked for exits must not start receiving them.
+ *  - `exit`  — ONLY an exit crossing. A record that is not a crossing at all
+ *    fails closed, because "the car left the drive" is a question about a
+ *    boundary, not about a detection.
+ *  - `any`   — no direction filter; entries, exits and non-crossings alike.
+ *
+ * A rule asking for a direction should normally also scope `zones`, which the
+ * engine evaluates against the crossed zone as well as the current membership
+ * (an exit's membership no longer contains the zone it just left).
+ */
+export declare const NcCrossingSchema: z.ZodEnum<{
+    any: "any";
+    enter: "enter";
+    exit: "exit";
+}>;
+export type NcCrossing = z.infer<typeof NcCrossingSchema>;
 /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
 export declare const NcZoneConditionSchema: z.ZodObject<{
     ids: z.ZodArray<z.ZodString>;
@@ -134,6 +158,11 @@ export declare const NcConditionsSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    crossing: z.ZodOptional<z.ZodEnum<{
+        any: "any";
+        enter: "enter";
+        exit: "exit";
+    }>>;
     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
     plates: z.ZodOptional<z.ZodObject<{
@@ -197,6 +226,22 @@ export type NcRuleTarget = z.infer<typeof NcRuleTargetSchema>;
  *  - `keyFrame` — the clean scene frame (no subject box).
  *  - `none` — no attachment.
  */
+/**
+ * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
+ * conflate it with the selection strategy and betray the request: asking for
+ * the clean scene frame on an object-event owner used to start at
+ * `fullFrameBoxed`, i.e. the annotated frame (2026-07-30).
+ *  - `cropped` — the subject, tight. What "who is at the door" wants.
+ *  - `full`    — the clean scene, no annotation. What "what is going on" wants.
+ *  - `boxed`   — the scene WITH the detection boxes drawn, for verifying what
+ *                the pipeline actually saw.
+ */
+export declare const NcMediaFrameSchema: z.ZodEnum<{
+    full: "full";
+    cropped: "cropped";
+    boxed: "boxed";
+}>;
+export type NcMediaFrame = z.infer<typeof NcMediaFrameSchema>;
 export declare const NcMediaPolicySchema: z.ZodObject<{
     attach: z.ZodDefault<z.ZodEnum<{
         none: "none";
@@ -204,8 +249,40 @@ export declare const NcMediaPolicySchema: z.ZodObject<{
         "best-matching": "best-matching";
         keyFrame: "keyFrame";
     }>>;
+    frame: z.ZodOptional<z.ZodEnum<{
+        full: "full";
+        cropped: "cropped";
+        boxed: "boxed";
+    }>>;
+    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+    gif: z.ZodOptional<z.ZodBoolean>;
+    clip: z.ZodOptional<z.ZodBoolean>;
+    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+    profile: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>>;
 }, z.core.$strip>;
 export type NcMediaPolicy = z.infer<typeof NcMediaPolicySchema>;
+/**
+ * Cooldown GRANULARITY over the subject's class — how much a fired
+ * notification suppresses.
+ *  - `shared` (default, and the absent value) — one window for the whole
+ *    rule/scope: a cat silences the next dog for `cooldownSec`.
+ *  - `per-class` — an independent window per detected class, so cat→dog fires
+ *    at once and cat→cat still waits.
+ *
+ * AUDIO subjects are ALWAYS per-class regardless of this setting: a scream
+ * must not be swallowed by a bark's window (the precedent this generalizes —
+ * see `cooldownKey` in the rule engine).
+ */
+export declare const NcThrottleGranularitySchema: z.ZodEnum<{
+    shared: "shared";
+    "per-class": "per-class";
+}>;
+export type NcThrottleGranularity = z.infer<typeof NcThrottleGranularitySchema>;
 /** Throttle — cooldown survives restarts (rebuilt from the outbox on boot). */
 export declare const NcThrottleSchema: z.ZodObject<{
     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -213,6 +290,10 @@ export declare const NcThrottleSchema: z.ZodObject<{
         rule: "rule";
         "rule-device": "rule-device";
     }>>;
+    granularity: z.ZodOptional<z.ZodEnum<{
+        shared: "shared";
+        "per-class": "per-class";
+    }>>;
 }, z.core.$strip>;
 export type NcThrottle = z.infer<typeof NcThrottleSchema>;
 /** Client-supplied rule fields (server stamps id/createdBy/createdAt/updatedAt). */
@@ -220,9 +301,9 @@ export declare const NcRuleInputSchema: z.ZodObject<{
     name: z.ZodString;
     enabled: z.ZodDefault<z.ZodBoolean>;
     delivery: z.ZodEnum<{
+        "device-event": "device-event";
         immediate: "immediate";
         "track-end": "track-end";
-        "device-event": "device-event";
         "package-event": "package-event";
     }>;
     conditions: z.ZodDefault<z.ZodObject<{
@@ -238,6 +319,11 @@ export declare const NcRuleInputSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        crossing: z.ZodOptional<z.ZodEnum<{
+            any: "any";
+            enter: "enter";
+            exit: "exit";
+        }>>;
         labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
         identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
         plates: z.ZodOptional<z.ZodObject<{
@@ -294,6 +380,7 @@ export declare const NcRuleInputSchema: z.ZodObject<{
         targetId: z.ZodString;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
+    targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     media: z.ZodDefault<z.ZodObject<{
         attach: z.ZodDefault<z.ZodEnum<{
             none: "none";
@@ -301,6 +388,21 @@ export declare const NcRuleInputSchema: z.ZodObject<{
             "best-matching": "best-matching";
             keyFrame: "keyFrame";
         }>>;
+        frame: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            cropped: "cropped";
+            boxed: "boxed";
+        }>>;
+        zoneCrop: z.ZodOptional<z.ZodBoolean>;
+        gif: z.ZodOptional<z.ZodBoolean>;
+        clip: z.ZodOptional<z.ZodBoolean>;
+        clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+        clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+        profile: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            mid: "mid";
+            low: "low";
+        }>>;
     }, z.core.$strip>>;
     throttle: z.ZodDefault<z.ZodObject<{
         cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -308,6 +410,10 @@ export declare const NcRuleInputSchema: z.ZodObject<{
             rule: "rule";
             "rule-device": "rule-device";
         }>>;
+        granularity: z.ZodOptional<z.ZodEnum<{
+            shared: "shared";
+            "per-class": "per-class";
+        }>>;
     }, z.core.$strip>>;
     template: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -330,9 +436,9 @@ export declare const NcRulePatchSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     delivery: z.ZodOptional<z.ZodEnum<{
+        "device-event": "device-event";
         immediate: "immediate";
         "track-end": "track-end";
-        "device-event": "device-event";
         "package-event": "package-event";
     }>>;
     conditions: z.ZodOptional<z.ZodDefault<z.ZodObject<{
@@ -348,6 +454,11 @@ export declare const NcRulePatchSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        crossing: z.ZodOptional<z.ZodEnum<{
+            any: "any";
+            enter: "enter";
+            exit: "exit";
+        }>>;
         labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
         identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
         plates: z.ZodOptional<z.ZodObject<{
@@ -404,6 +515,7 @@ export declare const NcRulePatchSchema: z.ZodObject<{
         targetId: z.ZodString;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
+    targetUsers: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     media: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         attach: z.ZodDefault<z.ZodEnum<{
             none: "none";
@@ -411,6 +523,21 @@ export declare const NcRulePatchSchema: z.ZodObject<{
             "best-matching": "best-matching";
             keyFrame: "keyFrame";
         }>>;
+        frame: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            cropped: "cropped";
+            boxed: "boxed";
+        }>>;
+        zoneCrop: z.ZodOptional<z.ZodBoolean>;
+        gif: z.ZodOptional<z.ZodBoolean>;
+        clip: z.ZodOptional<z.ZodBoolean>;
+        clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+        clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+        profile: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            mid: "mid";
+            low: "low";
+        }>>;
     }, z.core.$strip>>>;
     throttle: z.ZodOptional<z.ZodDefault<z.ZodObject<{
         cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -418,6 +545,10 @@ export declare const NcRulePatchSchema: z.ZodObject<{
             rule: "rule";
             "rule-device": "rule-device";
         }>>;
+        granularity: z.ZodOptional<z.ZodEnum<{
+            shared: "shared";
+            "per-class": "per-class";
+        }>>;
     }, z.core.$strip>>>;
     template: z.ZodOptional<z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -433,9 +564,9 @@ export declare const NcRuleSchema: z.ZodObject<{
     name: z.ZodString;
     enabled: z.ZodDefault<z.ZodBoolean>;
     delivery: z.ZodEnum<{
+        "device-event": "device-event";
         immediate: "immediate";
         "track-end": "track-end";
-        "device-event": "device-event";
         "package-event": "package-event";
     }>;
     conditions: z.ZodDefault<z.ZodObject<{
@@ -451,6 +582,11 @@ export declare const NcRuleSchema: z.ZodObject<{
             }>>;
         }, z.core.$strip>>;
         zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        crossing: z.ZodOptional<z.ZodEnum<{
+            any: "any";
+            enter: "enter";
+            exit: "exit";
+        }>>;
         labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
         identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
         plates: z.ZodOptional<z.ZodObject<{
@@ -507,6 +643,7 @@ export declare const NcRuleSchema: z.ZodObject<{
         targetId: z.ZodString;
         params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
+    targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     media: z.ZodDefault<z.ZodObject<{
         attach: z.ZodDefault<z.ZodEnum<{
             none: "none";
@@ -514,6 +651,21 @@ export declare const NcRuleSchema: z.ZodObject<{
             "best-matching": "best-matching";
             keyFrame: "keyFrame";
         }>>;
+        frame: z.ZodOptional<z.ZodEnum<{
+            full: "full";
+            cropped: "cropped";
+            boxed: "boxed";
+        }>>;
+        zoneCrop: z.ZodOptional<z.ZodBoolean>;
+        gif: z.ZodOptional<z.ZodBoolean>;
+        clip: z.ZodOptional<z.ZodBoolean>;
+        clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+        clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+        profile: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            mid: "mid";
+            low: "low";
+        }>>;
     }, z.core.$strip>>;
     throttle: z.ZodDefault<z.ZodObject<{
         cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -521,6 +673,10 @@ export declare const NcRuleSchema: z.ZodObject<{
             rule: "rule";
             "rule-device": "rule-device";
         }>>;
+        granularity: z.ZodOptional<z.ZodEnum<{
+            shared: "shared";
+            "per-class": "per-class";
+        }>>;
     }, z.core.$strip>>;
     template: z.ZodOptional<z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
@@ -577,6 +733,7 @@ export declare const NcConditionDescriptorSchema: z.ZodObject<{
         zoneSelection: "zoneSelection";
         zoneIdList: "zoneIdList";
         plateMatcher: "plateMatcher";
+        crossingSelect: "crossingSelect";
         polygonDraw: "polygonDraw";
     }>;
     operator: z.ZodEnum<{
@@ -589,9 +746,9 @@ export declare const NcConditionDescriptorSchema: z.ZodObject<{
         withinSchedule: "withinSchedule";
     }>;
     appliesTo: z.ZodArray<z.ZodEnum<{
+        "device-event": "device-event";
         immediate: "immediate";
         "track-end": "track-end";
-        "device-event": "device-event";
         "package-event": "package-event";
     }>>;
     phase: z.ZodString;
@@ -623,8 +780,8 @@ export declare const NcHistoryStatusSchema: z.ZodEnum<{
 export type NcHistoryStatus = z.infer<typeof NcHistoryStatusSchema>;
 /** The evaluated record kind a history row descends from (one per trigger). */
 export declare const NcHistoryRecordKindSchema: z.ZodEnum<{
-    "track-end": "track-end";
     "device-event": "device-event";
+    "track-end": "track-end";
     "package-event": "package-event";
     "object-event": "object-event";
 }>;
@@ -654,16 +811,16 @@ export declare const NcHistoryEntrySchema: z.ZodObject<{
     ruleId: z.ZodString;
     ruleName: z.ZodString;
     delivery: z.ZodEnum<{
+        "device-event": "device-event";
         immediate: "immediate";
         "track-end": "track-end";
-        "device-event": "device-event";
         "package-event": "package-event";
     }>;
     targetId: z.ZodString;
     deviceId: z.ZodNumber;
     recordKind: z.ZodEnum<{
-        "track-end": "track-end";
         "device-event": "device-event";
+        "track-end": "track-end";
         "package-event": "package-event";
         "object-event": "object-event";
     }>;
@@ -719,9 +876,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodString;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 conditions: z.ZodDefault<z.ZodObject<{
@@ -737,6 +894,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -793,6 +955,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>;
+                targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 media: z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -800,6 +963,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>;
                 throttle: z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -807,6 +985,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>;
                 template: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -828,9 +1010,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodString;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 conditions: z.ZodDefault<z.ZodObject<{
@@ -846,6 +1028,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -902,6 +1089,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>;
+                targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 media: z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -909,6 +1097,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>;
                 throttle: z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -916,6 +1119,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>;
                 template: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -935,9 +1142,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodString;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 conditions: z.ZodDefault<z.ZodObject<{
@@ -953,6 +1160,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -1009,6 +1221,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>;
+                targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 media: z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -1016,6 +1229,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>;
                 throttle: z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -1023,6 +1251,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>;
                 template: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1036,9 +1268,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodString;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 conditions: z.ZodDefault<z.ZodObject<{
@@ -1054,6 +1286,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -1110,6 +1347,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>;
+                targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 media: z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -1117,6 +1355,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>;
                 throttle: z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -1124,6 +1377,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>;
                 template: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1146,9 +1403,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodOptional<z.ZodString>;
                 enabled: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
                 delivery: z.ZodOptional<z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>>;
                 conditions: z.ZodOptional<z.ZodDefault<z.ZodObject<{
@@ -1164,6 +1421,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -1220,6 +1482,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>>;
+                targetUsers: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
                 media: z.ZodOptional<z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -1227,6 +1490,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>>;
                 throttle: z.ZodOptional<z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -1234,6 +1512,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>>;
                 template: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1248,9 +1530,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodString;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 conditions: z.ZodDefault<z.ZodObject<{
@@ -1266,6 +1548,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -1322,6 +1609,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>;
+                targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 media: z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -1329,6 +1617,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>;
                 throttle: z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -1336,6 +1639,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>;
                 template: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1373,9 +1680,9 @@ export declare const notificationRulesCapability: {
                 name: z.ZodString;
                 enabled: z.ZodDefault<z.ZodBoolean>;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 conditions: z.ZodDefault<z.ZodObject<{
@@ -1391,6 +1698,11 @@ export declare const notificationRulesCapability: {
                         }>>;
                     }, z.core.$strip>>;
                     zonesExclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    crossing: z.ZodOptional<z.ZodEnum<{
+                        any: "any";
+                        enter: "enter";
+                        exit: "exit";
+                    }>>;
                     labelEquals: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     identities: z.ZodOptional<z.ZodArray<z.ZodString>>;
                     plates: z.ZodOptional<z.ZodObject<{
@@ -1447,6 +1759,7 @@ export declare const notificationRulesCapability: {
                     targetId: z.ZodString;
                     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                 }, z.core.$strip>>;
+                targetUsers: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 media: z.ZodDefault<z.ZodObject<{
                     attach: z.ZodDefault<z.ZodEnum<{
                         none: "none";
@@ -1454,6 +1767,21 @@ export declare const notificationRulesCapability: {
                         "best-matching": "best-matching";
                         keyFrame: "keyFrame";
                     }>>;
+                    frame: z.ZodOptional<z.ZodEnum<{
+                        full: "full";
+                        cropped: "cropped";
+                        boxed: "boxed";
+                    }>>;
+                    zoneCrop: z.ZodOptional<z.ZodBoolean>;
+                    gif: z.ZodOptional<z.ZodBoolean>;
+                    clip: z.ZodOptional<z.ZodBoolean>;
+                    clipPreRollSec: z.ZodOptional<z.ZodNumber>;
+                    clipPostRollSec: z.ZodOptional<z.ZodNumber>;
+                    profile: z.ZodOptional<z.ZodEnum<{
+                        high: "high";
+                        mid: "mid";
+                        low: "low";
+                    }>>;
                 }, z.core.$strip>>;
                 throttle: z.ZodDefault<z.ZodObject<{
                     cooldownSec: z.ZodDefault<z.ZodNumber>;
@@ -1461,6 +1789,10 @@ export declare const notificationRulesCapability: {
                         rule: "rule";
                         "rule-device": "rule-device";
                     }>>;
+                    granularity: z.ZodOptional<z.ZodEnum<{
+                        shared: "shared";
+                        "per-class": "per-class";
+                    }>>;
                 }, z.core.$strip>>;
                 template: z.ZodOptional<z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
@@ -1487,6 +1819,16 @@ export declare const notificationRulesCapability: {
                 label: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * The machine-readable condition surface a rule editor renders from, plus
+         * the picker VOCABULARY those conditions draw on.
+         *
+         * `taxonomy` is optional so an older provider that only returns `catalog`
+         * still validates; a client that receives none keeps free-text inputs.
+         * It was previously served ONLY on the `nc.getConditionCatalog` bridge
+         * action, which is why the viewer had grouped pickers and the admin UI —
+         * which reaches this cap — was stuck typing `person` from memory.
+         */
         readonly getConditionCatalog: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{}, z.core.$strip>, z.ZodObject<{
             catalog: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
@@ -1514,6 +1856,7 @@ export declare const notificationRulesCapability: {
                     zoneSelection: "zoneSelection";
                     zoneIdList: "zoneIdList";
                     plateMatcher: "plateMatcher";
+                    crossingSelect: "crossingSelect";
                     polygonDraw: "polygonDraw";
                 }>;
                 operator: z.ZodEnum<{
@@ -1526,14 +1869,31 @@ export declare const notificationRulesCapability: {
                     withinSchedule: "withinSchedule";
                 }>;
                 appliesTo: z.ZodArray<z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>>;
                 phase: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
+            taxonomy: z.ZodOptional<z.ZodObject<{
+                videoClasses: z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                    label: z.ZodString;
+                    parentKind: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                audioKinds: z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                    label: z.ZodString;
+                    parentKind: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                labels: z.ZodArray<z.ZodObject<{
+                    kind: z.ZodString;
+                    label: z.ZodString;
+                    parentKind: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Queryable delivery history — a read-only view over the durable outbox
@@ -1563,16 +1923,16 @@ export declare const notificationRulesCapability: {
                 ruleId: z.ZodString;
                 ruleName: z.ZodString;
                 delivery: z.ZodEnum<{
+                    "device-event": "device-event";
                     immediate: "immediate";
                     "track-end": "track-end";
-                    "device-event": "device-event";
                     "package-event": "package-event";
                 }>;
                 targetId: z.ZodString;
                 deviceId: z.ZodNumber;
                 recordKind: z.ZodEnum<{
-                    "track-end": "track-end";
                     "device-event": "device-event";
+                    "track-end": "track-end";
                     "package-event": "package-event";
                     "object-event": "object-event";
                 }>;