@camstack/types 1.2.4 → 1.2.5

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

@@ -1285,8 +1285,26 @@ export declare const pipelineAnalyticsCapability: {
             sizeBytes: z.ZodNumber;
             timestamp: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /** All media rows owned by a track. `kinds` narrows to a kind subset so a
+         *  client can fetch the SMALL display variants on open and pull the
+         *  multi-MB native variants only on demand (mirrors `getEventMedia.kind`).
+         *  Absent ⇒ every kind (back-compat). */
         readonly getTrackMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             trackId: z.ZodString;
+            kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                snapshot: "snapshot";
+                crop: "crop";
+                thumbnail: "thumbnail";
+                firstFrame: "firstFrame";
+                lastFrame: "lastFrame";
+                fullFrame: "fullFrame";
+                fullFrameBoxed: "fullFrameBoxed";
+                faceCrop: "faceCrop";
+                plateCrop: "plateCrop";
+                keyFrame: "keyFrame";
+                keyFrameSmall: "keyFrameSmall";
+                thumbnailSmall: "thumbnailSmall";
+            }>>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
             kind: z.ZodEnum<{

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

@@ -183,6 +183,7 @@ declare const RunnerCameraConfigSchema: z.ZodObject<{
         "on-motion": "on-motion";
     }>>;
     motionCooldownMs: z.ZodDefault<z.ZodNumber>;
+    maxSessionHoldMs: z.ZodOptional<z.ZodNumber>;
     motionFps: z.ZodDefault<z.ZodNumber>;
     detectionFps: z.ZodDefault<z.ZodNumber>;
     motionStreamId: z.ZodString;
@@ -314,6 +315,7 @@ export declare const pipelineRunnerCapability: {
                 "on-motion": "on-motion";
             }>>;
             motionCooldownMs: z.ZodDefault<z.ZodNumber>;
+            maxSessionHoldMs: z.ZodOptional<z.ZodNumber>;
             motionFps: z.ZodDefault<z.ZodNumber>;
             detectionFps: z.ZodDefault<z.ZodNumber>;
             motionStreamId: z.ZodString;

package/dist/generated/addon-api.d.ts

@@ -10217,6 +10217,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             input: {
                 [x: string]: unknown;
                 trackId: string;
+                kinds?: ("snapshot" | "crop" | "thumbnail" | "firstFrame" | "lastFrame" | "fullFrame" | "fullFrameBoxed" | "faceCrop" | "plateCrop" | "keyFrame" | "keyFrameSmall" | "thumbnailSmall")[] | undefined;
             };
             output: readonly {
                 key: string;
@@ -11757,6 +11758,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 detectionMode?: "disabled" | "always-on" | "on-motion" | undefined;
                 audioMode?: "disabled" | "always-on" | "on-motion" | undefined;
                 motionCooldownMs?: number | undefined;
+                maxSessionHoldMs?: number | undefined;
                 motionFps?: number | undefined;
                 detectionFps?: number | undefined;
                 motionSources?: ("onboard" | "analyzer")[] | undefined;
@@ -27038,6 +27040,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             input: {
                 [x: string]: unknown;
                 trackId: string;
+                kinds?: ("snapshot" | "crop" | "thumbnail" | "firstFrame" | "lastFrame" | "fullFrame" | "fullFrameBoxed" | "faceCrop" | "plateCrop" | "keyFrame" | "keyFrameSmall" | "thumbnailSmall")[] | undefined;
             };
             output: readonly {
                 key: string;
@@ -28578,6 +28581,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 detectionMode?: "disabled" | "always-on" | "on-motion" | undefined;
                 audioMode?: "disabled" | "always-on" | "on-motion" | undefined;
                 motionCooldownMs?: number | undefined;
+                maxSessionHoldMs?: number | undefined;
                 motionFps?: number | undefined;
                 detectionFps?: number | undefined;
                 motionSources?: ("onboard" | "analyzer")[] | undefined;

package/dist/index.js

@@ -8563,6 +8563,12 @@ var motionCooldownMsField = {
 	default: 3e4,
 	step: 500
 };
+var maxSessionHoldMsField = {
+	min: 0,
+	max: 6e5,
+	default: 12e4,
+	step: 5e3
+};
 var motionFpsField = {
 	min: 1,
 	max: 30,
@@ -8710,6 +8716,19 @@ var RunnerCameraConfigSchema = zod.z.object({
 		"on-motion"
 	]).default("always-on"),
 	motionCooldownMs: zod.z.number().min(motionCooldownMsField.min).default(motionCooldownMsField.default),
+	/**
+	* Orchestrator-side on-motion session-hold cap (ms). While an on-motion
+	* detection session is active and ≥1 confirmed non-stationary track is
+	* still live, the orchestrator keeps the session open past
+	* `motionCooldownMs` (a slowly-moving subject can stop re-triggering the
+	* camera's VMD yet is still being tracked frame-to-frame) — up to this many
+	* ms since the session opened, after which it closes regardless. `0`
+	* disables the hold (legacy cooldown-only teardown). Not consumed by the
+	* runner itself — carried here so it shares the per-camera device-settings
+	* surface with `motionCooldownMs`; the orchestrator reads it off the
+	* resolved `CameraDetectionConfig`.
+	*/
+	maxSessionHoldMs: zod.z.number().min(maxSessionHoldMsField.min).max(maxSessionHoldMsField.max).optional(),
 	motionFps: zod.z.number().min(motionFpsField.min).max(motionFpsField.max).default(motionFpsField.default),
 	detectionFps: zod.z.number().min(detectionFpsField.min).max(detectionFpsField.max).default(detectionFpsField.default),
 	motionStreamId: zod.z.string(),
@@ -8873,6 +8892,21 @@ var RunnerCameraDeviceUIFields = [
 		nullable: true,
 		nullLabel: "Default"
 	},
+	{
+		key: "maxSessionHoldMs",
+		type: "slider",
+		label: "Max session hold",
+		description: "Upper bound on how long detection keeps running past the motion cooldown while a subject is still moving in-frame but no longer triggering motion. Prevents the detection box from stopping on a slow-moving subject. Set to 0 to disable.",
+		min: maxSessionHoldMsField.min,
+		max: maxSessionHoldMsField.max,
+		step: maxSessionHoldMsField.step,
+		default: maxSessionHoldMsField.default,
+		showValue: true,
+		unit: "s",
+		displayScale: 1e3,
+		nullable: true,
+		nullLabel: "Default"
+	},
 	{
 		key: "onboardMotionDrivesAnalyzer",
 		type: "boolean",
@@ -19468,7 +19502,14 @@ var pipelineAnalyticsCapability = {
 			eventId: zod.z.string(),
 			kind: MediaFileKindEnum.optional()
 		}), zod.z.array(MediaFileSchema).readonly()),
-		getTrackMedia: require_sleep.method(zod.z.object({ trackId: zod.z.string() }), zod.z.array(MediaFileSchema).readonly()),
+		/** All media rows owned by a track. `kinds` narrows to a kind subset so a
+		*  client can fetch the SMALL display variants on open and pull the
+		*  multi-MB native variants only on demand (mirrors `getEventMedia.kind`).
+		*  Absent ⇒ every kind (back-compat). */
+		getTrackMedia: require_sleep.method(zod.z.object({
+			trackId: zod.z.string(),
+			kinds: zod.z.array(MediaFileKindEnum).optional()
+		}), zod.z.array(MediaFileSchema).readonly()),
 		/**
 		* Search object events by text query using CLIP cosine similarity.
 		* Encodes `text` via the `embedding-encoder` cap, queries the

package/dist/index.mjs

@@ -8562,6 +8562,12 @@ var motionCooldownMsField = {
 	default: 3e4,
 	step: 500
 };
+var maxSessionHoldMsField = {
+	min: 0,
+	max: 6e5,
+	default: 12e4,
+	step: 5e3
+};
 var motionFpsField = {
 	min: 1,
 	max: 30,
@@ -8709,6 +8715,19 @@ var RunnerCameraConfigSchema = z.object({
 		"on-motion"
 	]).default("always-on"),
 	motionCooldownMs: z.number().min(motionCooldownMsField.min).default(motionCooldownMsField.default),
+	/**
+	* Orchestrator-side on-motion session-hold cap (ms). While an on-motion
+	* detection session is active and ≥1 confirmed non-stationary track is
+	* still live, the orchestrator keeps the session open past
+	* `motionCooldownMs` (a slowly-moving subject can stop re-triggering the
+	* camera's VMD yet is still being tracked frame-to-frame) — up to this many
+	* ms since the session opened, after which it closes regardless. `0`
+	* disables the hold (legacy cooldown-only teardown). Not consumed by the
+	* runner itself — carried here so it shares the per-camera device-settings
+	* surface with `motionCooldownMs`; the orchestrator reads it off the
+	* resolved `CameraDetectionConfig`.
+	*/
+	maxSessionHoldMs: z.number().min(maxSessionHoldMsField.min).max(maxSessionHoldMsField.max).optional(),
 	motionFps: z.number().min(motionFpsField.min).max(motionFpsField.max).default(motionFpsField.default),
 	detectionFps: z.number().min(detectionFpsField.min).max(detectionFpsField.max).default(detectionFpsField.default),
 	motionStreamId: z.string(),
@@ -8872,6 +8891,21 @@ var RunnerCameraDeviceUIFields = [
 		nullable: true,
 		nullLabel: "Default"
 	},
+	{
+		key: "maxSessionHoldMs",
+		type: "slider",
+		label: "Max session hold",
+		description: "Upper bound on how long detection keeps running past the motion cooldown while a subject is still moving in-frame but no longer triggering motion. Prevents the detection box from stopping on a slow-moving subject. Set to 0 to disable.",
+		min: maxSessionHoldMsField.min,
+		max: maxSessionHoldMsField.max,
+		step: maxSessionHoldMsField.step,
+		default: maxSessionHoldMsField.default,
+		showValue: true,
+		unit: "s",
+		displayScale: 1e3,
+		nullable: true,
+		nullLabel: "Default"
+	},
 	{
 		key: "onboardMotionDrivesAnalyzer",
 		type: "boolean",
@@ -19467,7 +19501,14 @@ var pipelineAnalyticsCapability = {
 			eventId: z.string(),
 			kind: MediaFileKindEnum.optional()
 		}), z.array(MediaFileSchema).readonly()),
-		getTrackMedia: method(z.object({ trackId: z.string() }), z.array(MediaFileSchema).readonly()),
+		/** All media rows owned by a track. `kinds` narrows to a kind subset so a
+		*  client can fetch the SMALL display variants on open and pull the
+		*  multi-MB native variants only on demand (mirrors `getEventMedia.kind`).
+		*  Absent ⇒ every kind (back-compat). */
+		getTrackMedia: method(z.object({
+			trackId: z.string(),
+			kinds: z.array(MediaFileKindEnum).optional()
+		}), z.array(MediaFileSchema).readonly()),
 		/**
 		* Search object events by text query using CLIP cosine similarity.
 		* Encodes `text` via the `embedding-encoder` cap, queries the

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

@@ -133,6 +133,18 @@ export interface PipelineAnalyticsFrameTrackedPayload {
     readonly frameWidth: number;
     readonly frameHeight: number;
     readonly detections: readonly ObjectDetection[];
+    /**
+     * True when ≥1 tracked object on this frame is NON-stationary (track state
+     * `moving` / `entered` / `left`) — i.e. a real subject is actively moving
+     * through the scene, as opposed to a parked/idle object. Consumed by the
+     * orchestrator's on-motion session-hold: while a moving track is live the
+     * detection session is kept open past the motion cooldown (a slowly-moving
+     * subject can evade the camera's VMD yet still be tracked frame-to-frame),
+     * so the box never stops following it mid-session. Absent ⇒ treat as
+     * `false` (no hold). Telemetry-lossy (D8) — a dropped frame just lets the
+     * session close slightly earlier, never a correctness bug.
+     */
+    readonly hasMovingTrack?: boolean;
     [key: string]: unknown;
 }
 /** Lifecycle phase of a tracked object: it appears (`start`), its best

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

@@ -409,6 +409,14 @@ export interface CameraDetectionConfig {
     readonly motionFps: number;
     readonly detectionFps: number;
     readonly motionCooldownMs: number;
+    /**
+     * Orchestrator on-motion session-hold cap (ms). While the session is active
+     * and a confirmed non-stationary track is still live, the orchestrator holds
+     * the session open past `motionCooldownMs` — up to this many ms since it
+     * opened — so a slow subject that stops re-triggering VMD is still tracked.
+     * Absent ⇒ the orchestrator's built-in default; `0` disables the hold.
+     */
+    readonly maxSessionHoldMs?: number;
     readonly audioStreamId?: string;
     /**
      * Operator-facing scheduling modes. Forwarded to `RunnerCameraConfig`;

package/package.json

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