@camstack/types 1.2.163 → 1.2.165

package/dist/capabilities/data-store-provider.cap.d.ts

@@ -93,6 +93,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -150,6 +151,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             deleted: z.ZodNumber;
@@ -163,6 +165,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>, z.ZodObject<{
@@ -177,6 +180,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -208,6 +212,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -234,6 +239,7 @@ export declare const dataStoreProviderCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{

package/dist/capabilities/motion.cap.d.ts

@@ -32,6 +32,7 @@ export declare const MotionOnMotionChangedDataSchema: z.ZodObject<{
     source: z.ZodEnum<{
         onboard: "onboard";
         analyzer: "analyzer";
+        "device-activity": "device-activity";
     }>;
     regions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
         bbox: z.ZodObject<{
@@ -96,6 +97,7 @@ export declare const motionCapability: {
                 source: z.ZodEnum<{
                     onboard: "onboard";
                     analyzer: "analyzer";
+                    "device-activity": "device-activity";
                 }>;
                 regions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
                     bbox: z.ZodObject<{

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

@@ -247,6 +247,44 @@ export declare const TrackSourceSchema: z.ZodEnum<{
     pipeline: "pipeline";
 }>;
 export type TrackSource = z.infer<typeof TrackSourceSchema>;
+/**
+ * The `excludeSources` filter on `listTracks` / `listRecentTracks`: track
+ * SOURCES to leave out. ABSENT or EMPTY excludes nothing.
+ *
+ * ## Why the query needs a source dimension at all
+ *
+ * `classes` cannot express it, and trying made a filter that lies. A synthetic
+ * row carries no accumulated `classes[]`, and `whereJsonArrayAny` is a
+ * deliberate SUPERSET — an unreadable column keeps its row. So on the live hub
+ * every class selection returned every synthetic row: `classes: ['person']`
+ * came back with 66 contact markers and 29 audio markers attached, and a class
+ * that exists nowhere at all still answered 116 rows, all of them synthetic.
+ * "Sensor" and "Audio" selected the identical set, because neither selected
+ * anything — they merely failed to exclude the rows the escape hatch keeps.
+ *
+ * Provenance is `source`, never a class name (D189 put every audio row on
+ * `className: 'audio'` precisely so the audio VOCABULARY could stop colliding
+ * with the detection one). This is the filter that speaks it.
+ *
+ * ## Why EXCLUDE and not an allow-list
+ *
+ * A stored client preference outlives this enum. An allow-list persisted by a
+ * viewer that has never heard of a source added next year would hide it
+ * forever, silently — the same shape as the `!== 'sensor'` check this file
+ * already warns about. An exclusion list can only ever hide what it names.
+ *
+ * ## NULL is `pipeline`
+ *
+ * Pipeline rows carry no `source` at all (the column is nullable and the
+ * completed-track persist omits it), so the provider compiles this as a
+ * NULL-safe `whereNotIn` when `pipeline` is NOT excluded, and as a positive
+ * `whereIn` over the surviving sources when it is. Both are exact; neither
+ * leaves a row's fate to a default.
+ *
+ * It is a REAL query filter, not a post-read drop: paging must tell the truth
+ * about how much is left.
+ */
+export type ExcludeSourcesDoc = readonly TrackSource[];
 /**
  * Where a track sits in the RETRAIN lifecycle (D81).
  *
@@ -261,10 +299,12 @@ export type TrackSource = z.infer<typeof TrackSourceSchema>;
  *    Terminal for the plain `markForTrain` toggle: returning it to `staging` is
  *    a deliberate action of the retrain page, not a side effect of a checkbox.
  *
- * There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` because
- * the store's filter language has only positive equality and `whereIn` — no
- * negation, no IS NULL — so a NULL would be unselectable by ANY predicate and
- * would make the entire pre-column history immortal in one deploy.
+ * There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` so that
+ * every row is selectable by a positive predicate. (The filter language has
+ * since grown the NULL-safe `whereNot` / `whereNotIn` and an `IS NULL` reading
+ * of `where: { f: null }`, which is how {@link TrackSourceSchema} can be
+ * filtered on a NULLABLE column — see `excludeSources`. It did not when this
+ * column was designed, and a NOT NULL column is still the better shape.)
  */
 export declare const RetrainStatusSchema: z.ZodEnum<{
     none: "none";
@@ -1121,6 +1161,11 @@ declare const RecentTracksQueryInput: z.ZodObject<{
     }>>;
     includeStationary: z.ZodOptional<z.ZodBoolean>;
     classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sensor: "sensor";
+        audio: "audio";
+        pipeline: "pipeline";
+    }>>>;
 }, z.core.$strip>;
 export type RecentTracksQuery = z.infer<typeof RecentTracksQueryInput>;
 /**
@@ -1854,6 +1899,11 @@ export declare const pipelineAnalyticsCapability: {
             }>>;
             includeStationary: z.ZodOptional<z.ZodBoolean>;
             classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                sensor: "sensor";
+                audio: "audio";
+                pipeline: "pipeline";
+            }>>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             retrainStatus: z.ZodOptional<z.ZodEnum<{
                 none: "none";
@@ -1972,6 +2022,11 @@ export declare const pipelineAnalyticsCapability: {
             }>>;
             includeStationary: z.ZodOptional<z.ZodBoolean>;
             classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            excludeSources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                sensor: "sensor";
+                audio: "audio";
+                pipeline: "pipeline";
+            }>>>;
         }, z.core.$strip>, z.ZodObject<{
             tracks: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 retrainStatus: z.ZodOptional<z.ZodEnum<{

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

@@ -93,10 +93,24 @@ export type StatelessStepRefusal = z.infer<typeof StatelessStepRefusalSchema>;
  * (analyzer attaches detected `regions[]`; onboard does not — the
  * camera typically only reports a binary signal plus an optional
  * channel/AI class which lives in dedicated event channels).
+ *
+ * - `onboard` — the camera's firmware said something moved.
+ * - `analyzer` — this runner's frame-diff said so, and attaches `regions[]`.
+ * - `device-activity` — the DEVICE said it is doing its job: the
+ *   `recording-signal` LEVEL the same device raises for the recorder
+ *   ([D380](../../../../docs/decisions/adr-0380-a-device-decided-recording-is-a-mode-with-no-schedule-seeded-once.md)),
+ *   republished as a motion source. It attaches **nothing** — no regions, no
+ *   class: the only fact it carries is that the device is active, and a robot
+ *   vacuum that is itself the moving object has no region worth sending. It is
+ *   a LEVEL, so unlike `onboard` it has a real falling edge, and unlike
+ *   `analyzer` it must not open the frame-diff side-channel — the runner's
+ *   `handleOnboardMotionAnalyzer` gate is `source === 'onboard'` and stays that
+ *   way ([D392](../../../../docs/decisions/adr-0392-a-device-that-says-it-is-working-is-a-motion-source-of-its-own.md)).
  */
 export declare const MotionSourceEnum: z.ZodEnum<{
     onboard: "onboard";
     analyzer: "analyzer";
+    "device-activity": "device-activity";
 }>;
 export type MotionSource = z.infer<typeof MotionSourceEnum>;
 /**
@@ -116,6 +130,7 @@ export type MotionSource = z.infer<typeof MotionSourceEnum>;
 export declare const MotionSourcesSchema: z.ZodArray<z.ZodEnum<{
     onboard: "onboard";
     analyzer: "analyzer";
+    "device-activity": "device-activity";
 }>>;
 export type MotionSources = z.infer<typeof MotionSourcesSchema>;
 /**
@@ -130,6 +145,7 @@ export declare const ReportMotionInputSchema: z.ZodObject<{
     source: z.ZodDefault<z.ZodEnum<{
         onboard: "onboard";
         analyzer: "analyzer";
+        "device-activity": "device-activity";
     }>>;
     regions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
         bbox: z.ZodObject<{
@@ -218,6 +234,7 @@ declare const RunnerCameraConfigSchema: z.ZodObject<{
     motionSources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
         onboard: "onboard";
         analyzer: "analyzer";
+        "device-activity": "device-activity";
     }>>>;
     pipelineEnabled: z.ZodDefault<z.ZodBoolean>;
     steps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown, z.core.$ZodTypeInternals<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown>>>>>;
@@ -477,6 +494,7 @@ export declare const pipelineRunnerCapability: {
             motionSources: z.ZodDefault<z.ZodArray<z.ZodEnum<{
                 onboard: "onboard";
                 analyzer: "analyzer";
+                "device-activity": "device-activity";
             }>>>;
             pipelineEnabled: z.ZodDefault<z.ZodBoolean>;
             steps: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodType<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown, z.core.$ZodTypeInternals<import("./pipeline-executor.cap.js").PipelineStepInputOutput, unknown>>>>>;
@@ -545,6 +563,7 @@ export declare const pipelineRunnerCapability: {
             source: z.ZodDefault<z.ZodEnum<{
                 onboard: "onboard";
                 analyzer: "analyzer";
+                "device-activity": "device-activity";
             }>>;
             regions: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 bbox: z.ZodObject<{

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

@@ -8,6 +8,7 @@ declare const QueryFilterSchema: z.ZodObject<{
     whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
     whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
     whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
     orderBy: z.ZodOptional<z.ZodObject<{
         field: z.ZodString;
         direction: z.ZodEnum<{
@@ -32,6 +33,7 @@ declare const MutationFilterSchema: z.ZodObject<{
     whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
     whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
     whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
 }, z.core.$strip>;
 /**
  * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -177,6 +179,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -269,6 +272,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             deleted: z.ZodNumber;
@@ -286,6 +290,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
             }, z.core.$strip>;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>, z.ZodObject<{
@@ -300,6 +305,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -348,6 +354,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{
@@ -374,6 +381,7 @@ export declare const settingsStoreCapability: {
                 whereIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 whereBetween: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodTuple<[z.ZodUnknown, z.ZodUnknown], null>>>;
                 whereNot: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                whereNotIn: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
                 orderBy: z.ZodOptional<z.ZodObject<{
                     field: z.ZodString;
                     direction: z.ZodEnum<{

package/dist/device/device-profile.d.ts

@@ -105,7 +105,7 @@ export interface DeviceProfileDefaults {
      *  explicitly to enable SW motion). PIR-sourced motion currently
      *  flows through `'onboard'` because Reolink's accessory PIRs feed
      *  the parent camera's firmware motion event channel. */
-    readonly motionSources?: readonly ('onboard' | 'analyzer')[];
+    readonly motionSources?: import('../capabilities/pipeline-runner.cap.js').MotionSources;
     readonly audioMode?: PipelinePhaseMode;
     readonly detectionMode?: PipelinePhaseMode;
 }

package/dist/index.js

@@ -9137,6 +9137,9 @@ var QueryFilterSchema = zod.z.object({
 	whereBetween: zod.z.record(zod.z.string(), zod.z.tuple([zod.z.unknown(), zod.z.unknown()])).optional(),
 	/** NULL-safe exclusion: matches rows whose field is NULL OR != the value. */
 	whereNot: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	/** NULL-safe exclusion of a SET — `whereNot` for more than one value. An
+	*  empty list excludes nothing. See `QueryFilter.whereNotIn`. */
+	whereNotIn: zod.z.record(zod.z.string(), zod.z.array(zod.z.unknown())).optional(),
 	orderBy: zod.z.object({
 		field: zod.z.string(),
 		direction: zod.z.enum(["asc", "desc"])
@@ -9157,7 +9160,8 @@ var MutationFilterSchema = zod.z.object({
 	where: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
 	whereIn: zod.z.record(zod.z.string(), zod.z.array(zod.z.unknown())).optional(),
 	whereBetween: zod.z.record(zod.z.string(), zod.z.tuple([zod.z.unknown(), zod.z.unknown()])).optional(),
-	whereNot: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	whereNot: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	whereNotIn: zod.z.record(zod.z.string(), zod.z.array(zod.z.unknown())).optional()
 });
 /**
 * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -18649,10 +18653,12 @@ var TrackSourceSchema = zod.z.enum([
 *    Terminal for the plain `markForTrain` toggle: returning it to `staging` is
 *    a deliberate action of the retrain page, not a side effect of a checkbox.
 *
-* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` because
-* the store's filter language has only positive equality and `whereIn` — no
-* negation, no IS NULL — so a NULL would be unselectable by ANY predicate and
-* would make the entire pre-column history immortal in one deploy.
+* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` so that
+* every row is selectable by a positive predicate. (The filter language has
+* since grown the NULL-safe `whereNot` / `whereNotIn` and an `IS NULL` reading
+* of `where: { f: null }`, which is how {@link TrackSourceSchema} can be
+* filtered on a NULLABLE column — see `excludeSources`. It did not when this
+* column was designed, and a NOT NULL column is still the better shape.)
 */
 var RetrainStatusSchema = zod.z.enum([
 	"none",
@@ -19433,7 +19439,9 @@ var RecentTracksQueryInput = zod.z.object({
 	* whose class list is unreadable are kept, and the client's rule stays the
 	* exact one.
 	*/
-	classes: zod.z.array(zod.z.string()).optional()
+	classes: zod.z.array(zod.z.string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: zod.z.array(TrackSourceSchema).optional()
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
@@ -19893,7 +19901,9 @@ var pipelineAnalyticsCapability = {
 			* selected is an operator who has not narrowed anything, and an empty
 			* timeline would read as a camera that saw nothing.
 			*/
-			classes: zod.z.array(zod.z.string()).optional()
+			classes: zod.z.array(zod.z.string()).optional(),
+			/** See {@link ExcludeSourcesDoc}. */
+			excludeSources: zod.z.array(TrackSourceSchema).optional()
 		}), zod.z.array(TrackSchema).readonly()),
 		/**
 		* Batched cluster-wide track listing — ONE call for the events page /
@@ -20939,8 +20949,25 @@ var occupancyRecheckFramesField = {
 * (analyzer attaches detected `regions[]`; onboard does not — the
 * camera typically only reports a binary signal plus an optional
 * channel/AI class which lives in dedicated event channels).
-*/
-var MotionSourceEnum = zod.z.enum(["onboard", "analyzer"]);
+*
+* - `onboard` — the camera's firmware said something moved.
+* - `analyzer` — this runner's frame-diff said so, and attaches `regions[]`.
+* - `device-activity` — the DEVICE said it is doing its job: the
+*   `recording-signal` LEVEL the same device raises for the recorder
+*   ([D380](../../../../docs/decisions/adr-0380-a-device-decided-recording-is-a-mode-with-no-schedule-seeded-once.md)),
+*   republished as a motion source. It attaches **nothing** — no regions, no
+*   class: the only fact it carries is that the device is active, and a robot
+*   vacuum that is itself the moving object has no region worth sending. It is
+*   a LEVEL, so unlike `onboard` it has a real falling edge, and unlike
+*   `analyzer` it must not open the frame-diff side-channel — the runner's
+*   `handleOnboardMotionAnalyzer` gate is `source === 'onboard'` and stays that
+*   way ([D392](../../../../docs/decisions/adr-0392-a-device-that-says-it-is-working-is-a-motion-source-of-its-own.md)).
+*/
+var MotionSourceEnum = zod.z.enum([
+	"onboard",
+	"analyzer",
+	"device-activity"
+]);
 /**
 * List of motion sources active on a camera. Empty array is valid:
 * "no source" — happens for battery cams without firmware motion when
@@ -21204,13 +21231,20 @@ var RunnerCameraDeviceUIFields = [
 		type: "multiselect",
 		label: "Motion Sources",
 		default: ["analyzer"],
-		options: [{
-			value: "analyzer",
-			label: "Frame-diff Analyzer (motion addon)"
-		}, {
-			value: "onboard",
-			label: "Camera Onboard Sensor"
-		}]
+		options: [
+			{
+				value: "analyzer",
+				label: "Frame-diff Analyzer (motion addon)"
+			},
+			{
+				value: "onboard",
+				label: "Camera Onboard Sensor"
+			},
+			{
+				value: "device-activity",
+				label: "Device activity (the device says it is working)"
+			}
+		]
 	},
 	{
 		key: "motionFps",

package/dist/index.mjs

@@ -9136,6 +9136,9 @@ var QueryFilterSchema = z.object({
 	whereBetween: z.record(z.string(), z.tuple([z.unknown(), z.unknown()])).optional(),
 	/** NULL-safe exclusion: matches rows whose field is NULL OR != the value. */
 	whereNot: z.record(z.string(), z.unknown()).optional(),
+	/** NULL-safe exclusion of a SET — `whereNot` for more than one value. An
+	*  empty list excludes nothing. See `QueryFilter.whereNotIn`. */
+	whereNotIn: z.record(z.string(), z.array(z.unknown())).optional(),
 	orderBy: z.object({
 		field: z.string(),
 		direction: z.enum(["asc", "desc"])
@@ -9156,7 +9159,8 @@ var MutationFilterSchema = z.object({
 	where: z.record(z.string(), z.unknown()).optional(),
 	whereIn: z.record(z.string(), z.array(z.unknown())).optional(),
 	whereBetween: z.record(z.string(), z.tuple([z.unknown(), z.unknown()])).optional(),
-	whereNot: z.record(z.string(), z.unknown()).optional()
+	whereNot: z.record(z.string(), z.unknown()).optional(),
+	whereNotIn: z.record(z.string(), z.array(z.unknown())).optional()
 });
 /**
 * One scalar an {@link settingsStoreCapability.methods.aggregate} call asks for.
@@ -18648,10 +18652,12 @@ var TrackSourceSchema = z.enum([
 *    Terminal for the plain `markForTrain` toggle: returning it to `staging` is
 *    a deliberate action of the retrain page, not a side effect of a checkbox.
 *
-* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` because
-* the store's filter language has only positive equality and `whereIn` — no
-* negation, no IS NULL — so a NULL would be unselectable by ANY predicate and
-* would make the entire pre-column history immortal in one deploy.
+* There is no `null`. The state is stored `TEXT NOT NULL DEFAULT 'none'` so that
+* every row is selectable by a positive predicate. (The filter language has
+* since grown the NULL-safe `whereNot` / `whereNotIn` and an `IS NULL` reading
+* of `where: { f: null }`, which is how {@link TrackSourceSchema} can be
+* filtered on a NULLABLE column — see `excludeSources`. It did not when this
+* column was designed, and a NOT NULL column is still the better shape.)
 */
 var RetrainStatusSchema = z.enum([
 	"none",
@@ -19432,7 +19438,9 @@ var RecentTracksQueryInput = z.object({
 	* whose class list is unreadable are kept, and the client's rule stays the
 	* exact one.
 	*/
-	classes: z.array(z.string()).optional()
+	classes: z.array(z.string()).optional(),
+	/** See {@link ExcludeSourcesDoc}. */
+	excludeSources: z.array(TrackSourceSchema).optional()
 });
 /**
 * A Summary (D359): the per-camera session envelope that references tracks.
@@ -19892,7 +19900,9 @@ var pipelineAnalyticsCapability = {
 			* selected is an operator who has not narrowed anything, and an empty
 			* timeline would read as a camera that saw nothing.
 			*/
-			classes: z.array(z.string()).optional()
+			classes: z.array(z.string()).optional(),
+			/** See {@link ExcludeSourcesDoc}. */
+			excludeSources: z.array(TrackSourceSchema).optional()
 		}), z.array(TrackSchema).readonly()),
 		/**
 		* Batched cluster-wide track listing — ONE call for the events page /
@@ -20938,8 +20948,25 @@ var occupancyRecheckFramesField = {
 * (analyzer attaches detected `regions[]`; onboard does not — the
 * camera typically only reports a binary signal plus an optional
 * channel/AI class which lives in dedicated event channels).
-*/
-var MotionSourceEnum = z.enum(["onboard", "analyzer"]);
+*
+* - `onboard` — the camera's firmware said something moved.
+* - `analyzer` — this runner's frame-diff said so, and attaches `regions[]`.
+* - `device-activity` — the DEVICE said it is doing its job: the
+*   `recording-signal` LEVEL the same device raises for the recorder
+*   ([D380](../../../../docs/decisions/adr-0380-a-device-decided-recording-is-a-mode-with-no-schedule-seeded-once.md)),
+*   republished as a motion source. It attaches **nothing** — no regions, no
+*   class: the only fact it carries is that the device is active, and a robot
+*   vacuum that is itself the moving object has no region worth sending. It is
+*   a LEVEL, so unlike `onboard` it has a real falling edge, and unlike
+*   `analyzer` it must not open the frame-diff side-channel — the runner's
+*   `handleOnboardMotionAnalyzer` gate is `source === 'onboard'` and stays that
+*   way ([D392](../../../../docs/decisions/adr-0392-a-device-that-says-it-is-working-is-a-motion-source-of-its-own.md)).
+*/
+var MotionSourceEnum = z.enum([
+	"onboard",
+	"analyzer",
+	"device-activity"
+]);
 /**
 * List of motion sources active on a camera. Empty array is valid:
 * "no source" — happens for battery cams without firmware motion when
@@ -21203,13 +21230,20 @@ var RunnerCameraDeviceUIFields = [
 		type: "multiselect",
 		label: "Motion Sources",
 		default: ["analyzer"],
-		options: [{
-			value: "analyzer",
-			label: "Frame-diff Analyzer (motion addon)"
-		}, {
-			value: "onboard",
-			label: "Camera Onboard Sensor"
-		}]
+		options: [
+			{
+				value: "analyzer",
+				label: "Frame-diff Analyzer (motion addon)"
+			},
+			{
+				value: "onboard",
+				label: "Camera Onboard Sensor"
+			},
+			{
+				value: "device-activity",
+				label: "Device activity (the device says it is working)"
+			}
+		]
 	},
 	{
 		key: "motionFps",

package/dist/interfaces/event-bus.d.ts

@@ -409,8 +409,10 @@ export interface PhaseTransitionPayload {
     from: 'watching' | 'active';
     to: 'watching' | 'active';
     reason: 'motion_detected' | 'cooldown_expired';
-    /** Motion source that armed the cooldown — present on both ON and OFF. */
-    source?: 'onboard' | 'analyzer';
+    /** Motion source that armed the cooldown — present on both ON and OFF.
+     *  The enum itself, never a hand-copied union: this was a second list of
+     *  the sources and it silently excluded every variant added after it. */
+    source?: import('../capabilities/pipeline-runner.cap.js').MotionSource;
     /** Cooldown window in ms that was/is active for this transition. */
     cooldownMs?: number;
     /** Ms epoch of the transition. */

package/dist/interfaces/storage.d.ts

@@ -208,6 +208,25 @@ export interface QueryFilter {
      * kind-exclusion must KEEP).
      */
     whereNot?: Record<string, unknown>;
+    /**
+     * NULL-safe exclusion of SEVERAL values — `whereNot` for a set.
+     *
+     * A row matches when its field is NULL OR not one of the listed values, for
+     * the same reason `whereNot` is NULL-safe: on a nullable column the NULL
+     * rows are the ones written before the column existed, and a "not these
+     * kinds" filter must keep them.
+     *
+     * It exists because `whereNot` is a `Record` keyed by field, so ONE field
+     * can carry exactly one excluded value. Excluding two members of a small
+     * enum (the case that produced it: `Track.source`, hiding the synthetic
+     * `audio` and `sensor` projections at once) was otherwise inexpressible —
+     * and the alternative, dropping the rows in the caller after the read, makes
+     * paging lie about how much is left.
+     *
+     * An EMPTY list is no filter, never "matches nothing": it is a chip row with
+     * nothing selected. Same rule as `whereJsonArrayAny`.
+     */
+    whereNotIn?: Record<string, unknown[]>;
     /**
      * "This JSON array column contains at least one of these values."
      *

package/dist/interfaces/stream-broker.d.ts

@@ -395,6 +395,21 @@ export interface CameraDetectionConfig {
     readonly detectionStreamId: string;
     readonly motionFps: number;
     readonly detectionFps: number;
+    /**
+     * The detection rate a session opened by the `device-activity` source is
+     * capped to (D392). A device-activity session is LONG — a cleaning run is
+     * tens of minutes of continuous activity — so it is analysed at a rate that
+     * can be sustained for that long, while a session any other trigger opens
+     * keeps `detectionFps`. Resolved by the orchestrator and applied at dispatch
+     * (`detectionFpsForTrigger`), so what reaches a runner is still a plain
+     * `detectionFps` and no runner needs to know this field exists.
+     *
+     * OPTIONAL because this config is built at several sites, not all of which
+     * resolve the device store. Absent means "not resolved here" and the cap
+     * still applies at `ACTIVITY_DETECTION_FPS_DEFAULT` — the safe direction: a
+     * long session runs slow rather than at full rate for an hour.
+     */
+    readonly activityDetectionFps?: number;
     readonly motionCooldownMs: number;
     /**
      * Orchestrator on-motion session-hold cap (ms). While the session is active

package/package.json

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