@camstack/types 1.1.43 → 1.1.45

package/dist/capabilities/scene-monitor.cap.d.ts

@@ -0,0 +1,483 @@
+import { z } from 'zod';
+import { type InferNativeProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * scene-monitor — device-scoped reference-region state cap. An operator marks
+ * a rect ROI on a camera frame and names one or more states; the engine
+ * (pipeline-analytics, designated post-processing node) reports which state is
+ * active on an ongoing basis. Two operator-selectable check modes share every-
+ * thing except the comparator: `similarity` (CLIP cosine at the same ROI coords
+ * vs condition-tagged references) and `llm` (vision-LLM judgment over the crop).
+ *
+ * D14 device-config archetype (`deviceConfig.ui.kind:'widget'`) — the framework
+ * derives the device-detail contribution; the provider carries NO hand-written
+ * settings-contribution methods. `status.kind:'push'` — the engine pushes on
+ * every hysteresis flip / availability change; consumers never poll.
+ */
+/** Extensible condition tag. Seeded 'day' | 'night'; open by design so more can
+ *  be added without a wire break (matching falls back to any-condition refs). */
+export declare const SceneConditionSchema: z.ZodString;
+/** One captured reference — condition-tagged, model-version-gated. `embedding`
+ *  is `number[]` (Float32Array does NOT survive MsgPack/UDS). */
+export declare const SceneReferenceSchema: z.ZodObject<{
+    embedding: z.ZodArray<z.ZodNumber>;
+    modelId: z.ZodString;
+    condition: z.ZodString;
+    capturedAt: z.ZodNumber;
+    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SceneMonitorStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    references: z.ZodArray<z.ZodObject<{
+        embedding: z.ZodArray<z.ZodNumber>;
+        modelId: z.ZodString;
+        condition: z.ZodString;
+        capturedAt: z.ZodNumber;
+        thumbnailMediaId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    referenceCount: z.ZodNumber;
+    currentlyMatched: z.ZodBoolean;
+}, z.core.$strip>;
+/** Per-mode comparator params in a discriminated union so an `llm` scene never
+ *  carries similarity knobs and vice-versa. */
+export declare const SceneCheckSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"similarity">;
+    threshold: z.ZodNumber;
+    hysteresisCount: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"llm">;
+    prompt: z.ZodString;
+    profileId: z.ZodOptional<z.ZodString>;
+    hysteresisCount: z.ZodNumber;
+}, z.core.$strip>], "mode">;
+export declare const SceneMonitorSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    roi: z.ZodObject<{
+        kind: z.ZodLiteral<"rect">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>;
+    enabled: z.ZodBoolean;
+    triggerMode: z.ZodEnum<{
+        both: "both";
+        "on-motion": "on-motion";
+        periodic: "periodic";
+    }>;
+    checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+    check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"similarity">;
+        threshold: z.ZodNumber;
+        hysteresisCount: z.ZodNumber;
+    }, z.core.$strip>, z.ZodObject<{
+        mode: z.ZodLiteral<"llm">;
+        prompt: z.ZodString;
+        profileId: z.ZodOptional<z.ZodString>;
+        hysteresisCount: z.ZodNumber;
+    }, z.core.$strip>], "mode">;
+    states: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        references: z.ZodArray<z.ZodObject<{
+            embedding: z.ZodArray<z.ZodNumber>;
+            modelId: z.ZodString;
+            condition: z.ZodString;
+            capturedAt: z.ZodNumber;
+            thumbnailMediaId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        referenceCount: z.ZodNumber;
+        currentlyMatched: z.ZodBoolean;
+    }, z.core.$strip>>;
+    currentStateId: z.ZodNullable<z.ZodString>;
+    lastCheckedAt: z.ZodNullable<z.ZodNumber>;
+    lastConfidence: z.ZodNullable<z.ZodNumber>;
+    currentCondition: z.ZodNullable<z.ZodString>;
+    availability: z.ZodEnum<{
+        ok: "ok";
+        unavailable: "unavailable";
+    }>;
+    unavailableReason: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const SceneMonitorStatusSchema: z.ZodObject<{
+    monitors: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        roi: z.ZodObject<{
+            kind: z.ZodLiteral<"rect">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+        enabled: z.ZodBoolean;
+        triggerMode: z.ZodEnum<{
+            both: "both";
+            "on-motion": "on-motion";
+            periodic: "periodic";
+        }>;
+        checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+        check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            mode: z.ZodLiteral<"similarity">;
+            threshold: z.ZodNumber;
+            hysteresisCount: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            mode: z.ZodLiteral<"llm">;
+            prompt: z.ZodString;
+            profileId: z.ZodOptional<z.ZodString>;
+            hysteresisCount: z.ZodNumber;
+        }, z.core.$strip>], "mode">;
+        states: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            references: z.ZodArray<z.ZodObject<{
+                embedding: z.ZodArray<z.ZodNumber>;
+                modelId: z.ZodString;
+                condition: z.ZodString;
+                capturedAt: z.ZodNumber;
+                thumbnailMediaId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            referenceCount: z.ZodNumber;
+            currentlyMatched: z.ZodBoolean;
+        }, z.core.$strip>>;
+        currentStateId: z.ZodNullable<z.ZodString>;
+        lastCheckedAt: z.ZodNullable<z.ZodNumber>;
+        lastConfidence: z.ZodNullable<z.ZodNumber>;
+        currentCondition: z.ZodNullable<z.ZodString>;
+        availability: z.ZodEnum<{
+            ok: "ok";
+            unavailable: "unavailable";
+        }>;
+        unavailableReason: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    lastFetchedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type SceneCondition = z.infer<typeof SceneConditionSchema>;
+export type SceneReference = z.infer<typeof SceneReferenceSchema>;
+export type SceneMonitorState = z.infer<typeof SceneMonitorStateSchema>;
+export type SceneCheck = z.infer<typeof SceneCheckSchema>;
+export type SceneMonitor = z.infer<typeof SceneMonitorSchema>;
+export type SceneMonitorStatus = z.infer<typeof SceneMonitorStatusSchema>;
+export declare const sceneMonitorCapability: {
+    readonly name: "scene-monitor";
+    readonly scope: "device";
+    readonly mode: "singleton";
+    readonly kind: "wrapper";
+    readonly defaultActive: true;
+    readonly deviceTypes: readonly [DeviceType.Camera];
+    readonly deviceConfig: {
+        readonly ui: {
+            readonly kind: "widget";
+            readonly widgetId: "host/scene-monitor-editor";
+            readonly tab: "scenes";
+            readonly label: "Scenes";
+        };
+    };
+    readonly methods: {
+        readonly listScenes: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            monitors: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                roi: z.ZodObject<{
+                    kind: z.ZodLiteral<"rect">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>;
+                enabled: z.ZodBoolean;
+                triggerMode: z.ZodEnum<{
+                    both: "both";
+                    "on-motion": "on-motion";
+                    periodic: "periodic";
+                }>;
+                checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+                check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    mode: z.ZodLiteral<"similarity">;
+                    threshold: z.ZodNumber;
+                    hysteresisCount: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    mode: z.ZodLiteral<"llm">;
+                    prompt: z.ZodString;
+                    profileId: z.ZodOptional<z.ZodString>;
+                    hysteresisCount: z.ZodNumber;
+                }, z.core.$strip>], "mode">;
+                states: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    references: z.ZodArray<z.ZodObject<{
+                        embedding: z.ZodArray<z.ZodNumber>;
+                        modelId: z.ZodString;
+                        condition: z.ZodString;
+                        capturedAt: z.ZodNumber;
+                        thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    referenceCount: z.ZodNumber;
+                    currentlyMatched: z.ZodBoolean;
+                }, z.core.$strip>>;
+                currentStateId: z.ZodNullable<z.ZodString>;
+                lastCheckedAt: z.ZodNullable<z.ZodNumber>;
+                lastConfidence: z.ZodNullable<z.ZodNumber>;
+                currentCondition: z.ZodNullable<z.ZodString>;
+                availability: z.ZodEnum<{
+                    ok: "ok";
+                    unavailable: "unavailable";
+                }>;
+                unavailableReason: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            lastFetchedAt: z.ZodNumber;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly createScene: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            label: z.ZodString;
+            roi: z.ZodObject<{
+                kind: z.ZodLiteral<"rect">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>;
+            check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                mode: z.ZodLiteral<"similarity">;
+                threshold: z.ZodNumber;
+                hysteresisCount: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                mode: z.ZodLiteral<"llm">;
+                prompt: z.ZodString;
+                profileId: z.ZodOptional<z.ZodString>;
+                hysteresisCount: z.ZodNumber;
+            }, z.core.$strip>], "mode">;
+            triggerMode: z.ZodOptional<z.ZodEnum<{
+                both: "both";
+                "on-motion": "on-motion";
+                periodic: "periodic";
+            }>>;
+            checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            roi: z.ZodObject<{
+                kind: z.ZodLiteral<"rect">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>;
+            enabled: z.ZodBoolean;
+            triggerMode: z.ZodEnum<{
+                both: "both";
+                "on-motion": "on-motion";
+                periodic: "periodic";
+            }>;
+            checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+            check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                mode: z.ZodLiteral<"similarity">;
+                threshold: z.ZodNumber;
+                hysteresisCount: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                mode: z.ZodLiteral<"llm">;
+                prompt: z.ZodString;
+                profileId: z.ZodOptional<z.ZodString>;
+                hysteresisCount: z.ZodNumber;
+            }, z.core.$strip>], "mode">;
+            states: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    embedding: z.ZodArray<z.ZodNumber>;
+                    modelId: z.ZodString;
+                    condition: z.ZodString;
+                    capturedAt: z.ZodNumber;
+                    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                referenceCount: z.ZodNumber;
+                currentlyMatched: z.ZodBoolean;
+            }, z.core.$strip>>;
+            currentStateId: z.ZodNullable<z.ZodString>;
+            lastCheckedAt: z.ZodNullable<z.ZodNumber>;
+            lastConfidence: z.ZodNullable<z.ZodNumber>;
+            currentCondition: z.ZodNullable<z.ZodString>;
+            availability: z.ZodEnum<{
+                ok: "ok";
+                unavailable: "unavailable";
+            }>;
+            unavailableReason: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        readonly updateScene: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            monitorId: z.ZodString;
+            patch: z.ZodObject<{
+                label: z.ZodOptional<z.ZodString>;
+                roi: z.ZodOptional<z.ZodObject<{
+                    kind: z.ZodLiteral<"rect">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>;
+                enabled: z.ZodOptional<z.ZodBoolean>;
+                triggerMode: z.ZodOptional<z.ZodEnum<{
+                    both: "both";
+                    "on-motion": "on-motion";
+                    periodic: "periodic";
+                }>>;
+                checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+                check: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    mode: z.ZodLiteral<"similarity">;
+                    threshold: z.ZodNumber;
+                    hysteresisCount: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    mode: z.ZodLiteral<"llm">;
+                    prompt: z.ZodString;
+                    profileId: z.ZodOptional<z.ZodString>;
+                    hysteresisCount: z.ZodNumber;
+                }, z.core.$strip>], "mode">>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly deleteScene: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            monitorId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly captureReference: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            monitorId: z.ZodString;
+            stateId: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            condition: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            stateId: z.ZodString;
+            referenceCount: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        readonly deleteReference: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            monitorId: z.ZodString;
+            stateId: z.ZodString;
+            index: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly recheckNow: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            monitorId: z.ZodString;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            monitors: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                roi: z.ZodObject<{
+                    kind: z.ZodLiteral<"rect">;
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>;
+                enabled: z.ZodBoolean;
+                triggerMode: z.ZodEnum<{
+                    both: "both";
+                    "on-motion": "on-motion";
+                    periodic: "periodic";
+                }>;
+                checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+                check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    mode: z.ZodLiteral<"similarity">;
+                    threshold: z.ZodNumber;
+                    hysteresisCount: z.ZodNumber;
+                }, z.core.$strip>, z.ZodObject<{
+                    mode: z.ZodLiteral<"llm">;
+                    prompt: z.ZodString;
+                    profileId: z.ZodOptional<z.ZodString>;
+                    hysteresisCount: z.ZodNumber;
+                }, z.core.$strip>], "mode">;
+                states: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    label: z.ZodString;
+                    references: z.ZodArray<z.ZodObject<{
+                        embedding: z.ZodArray<z.ZodNumber>;
+                        modelId: z.ZodString;
+                        condition: z.ZodString;
+                        capturedAt: z.ZodNumber;
+                        thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    referenceCount: z.ZodNumber;
+                    currentlyMatched: z.ZodBoolean;
+                }, z.core.$strip>>;
+                currentStateId: z.ZodNullable<z.ZodString>;
+                lastCheckedAt: z.ZodNullable<z.ZodNumber>;
+                lastConfidence: z.ZodNullable<z.ZodNumber>;
+                currentCondition: z.ZodNullable<z.ZodString>;
+                availability: z.ZodEnum<{
+                    ok: "ok";
+                    unavailable: "unavailable";
+                }>;
+                unavailableReason: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>>;
+            lastFetchedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        readonly kind: "push";
+    };
+    readonly runtimeState: z.ZodObject<{
+        monitors: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            roi: z.ZodObject<{
+                kind: z.ZodLiteral<"rect">;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strip>;
+            enabled: z.ZodBoolean;
+            triggerMode: z.ZodEnum<{
+                both: "both";
+                "on-motion": "on-motion";
+                periodic: "periodic";
+            }>;
+            checkIntervalSec: z.ZodOptional<z.ZodNumber>;
+            check: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                mode: z.ZodLiteral<"similarity">;
+                threshold: z.ZodNumber;
+                hysteresisCount: z.ZodNumber;
+            }, z.core.$strip>, z.ZodObject<{
+                mode: z.ZodLiteral<"llm">;
+                prompt: z.ZodString;
+                profileId: z.ZodOptional<z.ZodString>;
+                hysteresisCount: z.ZodNumber;
+            }, z.core.$strip>], "mode">;
+            states: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                references: z.ZodArray<z.ZodObject<{
+                    embedding: z.ZodArray<z.ZodNumber>;
+                    modelId: z.ZodString;
+                    condition: z.ZodString;
+                    capturedAt: z.ZodNumber;
+                    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                referenceCount: z.ZodNumber;
+                currentlyMatched: z.ZodBoolean;
+            }, z.core.$strip>>;
+            currentStateId: z.ZodNullable<z.ZodString>;
+            lastCheckedAt: z.ZodNullable<z.ZodNumber>;
+            lastConfidence: z.ZodNullable<z.ZodNumber>;
+            currentCondition: z.ZodNullable<z.ZodString>;
+            availability: z.ZodEnum<{
+                ok: "ok";
+                unavailable: "unavailable";
+            }>;
+            unavailableReason: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        lastFetchedAt: z.ZodNumber;
+    }, z.core.$strip>;
+};
+export type ISceneMonitorProvider = InferNativeProvider<typeof sceneMonitorCapability>;

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

@@ -29,6 +29,32 @@ declare const ZoneScopeBreakdownSchema: z.ZodObject<{
     zoneName: z.ZodString;
     trackIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
+/**
+ * A parked ("stationary") object surfaced alongside occupancy — an object that
+ * settled and stopped moving. It is NO LONGER a tracked object (the tracker was
+ * told to forget it so it stops re-spawning tracks/events), but it IS still
+ * physically present, so it keeps counting toward `frame` occupancy and is
+ * listed here so the UI can show it in a dedicated "Stationary" section instead
+ * of flooding the live event feed.
+ */
+declare const StationaryObjectSchema: z.ZodObject<{
+    id: z.ZodString;
+    className: z.ZodString;
+    bbox: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    frameWidth: z.ZodNumber;
+    frameHeight: z.ZodNumber;
+    firstSeenAt: z.ZodNumber;
+    becameStationaryAt: z.ZodNumber;
+    lastConfirmedAt: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StationaryObject = z.infer<typeof StationaryObjectSchema>;
 export declare const CameraOccupancySnapshotSchema: z.ZodObject<{
     ts: z.ZodNumber;
     frameWidth: z.ZodNumber;
@@ -48,6 +74,23 @@ export declare const CameraOccupancySnapshotSchema: z.ZodObject<{
         totalObjects: z.ZodNumber;
         byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
     }, z.core.$strip>;
+    stationaryObjects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        className: z.ZodString;
+        bbox: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>;
+        frameWidth: z.ZodNumber;
+        frameHeight: z.ZodNumber;
+        firstSeenAt: z.ZodNumber;
+        becameStationaryAt: z.ZodNumber;
+        lastConfirmedAt: z.ZodNumber;
+        label: z.ZodOptional<z.ZodString>;
+        keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export type CameraOccupancySnapshot = z.infer<typeof CameraOccupancySnapshotSchema>;
 export type ZoneScopeBreakdown = z.infer<typeof ZoneScopeBreakdownSchema>;
@@ -131,6 +174,23 @@ export declare const zoneAnalyticsCapability: {
                 totalObjects: z.ZodNumber;
                 byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
             }, z.core.$strip>;
+            stationaryObjects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                className: z.ZodString;
+                bbox: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    w: z.ZodNumber;
+                    h: z.ZodNumber;
+                }, z.core.$strip>;
+                frameWidth: z.ZodNumber;
+                frameHeight: z.ZodNumber;
+                firstSeenAt: z.ZodNumber;
+                becameStationaryAt: z.ZodNumber;
+                lastConfirmedAt: z.ZodNumber;
+                label: z.ZodOptional<z.ZodString>;
+                keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Time-series object count inside one zone. `className` optional —
          *  omit to count every class in the zone. */
@@ -206,7 +266,24 @@ export declare const zoneAnalyticsCapability: {
             totalObjects: z.ZodNumber;
             byClass: z.ZodRecord<z.ZodString, z.ZodNumber>;
         }, z.core.$strip>;
+        stationaryObjects: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            className: z.ZodString;
+            bbox: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>;
+            frameWidth: z.ZodNumber;
+            frameHeight: z.ZodNumber;
+            firstSeenAt: z.ZodNumber;
+            becameStationaryAt: z.ZodNumber;
+            lastConfirmedAt: z.ZodNumber;
+            label: z.ZodOptional<z.ZodString>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
     }, z.core.$strip>;
 };
 export type IZoneAnalyticsProvider = InferProvider<typeof zoneAnalyticsCapability>;
-export { CameraOccupancySnapshotSchema as _CameraOccupancySnapshotSchema, HistoryResolutionEnum, HistoryPointSchema, HistoryRangeSchema, ZoneScopeBreakdownSchema, PerScopeBreakdownSchema, };
+export { CameraOccupancySnapshotSchema as _CameraOccupancySnapshotSchema, StationaryObjectSchema, HistoryResolutionEnum, HistoryPointSchema, HistoryRangeSchema, ZoneScopeBreakdownSchema, PerScopeBreakdownSchema, };

package/dist/enums/event-category.d.ts

@@ -407,10 +407,51 @@ export declare enum EventCategory {
     EnrichmentEmbeddingStored = "enrichment.embedding.stored",
     EnrichmentSceneStateChanged = "enrichment.scene.state-changed",
     EnrichmentActivitySummary = "enrichment.activity.summary",
+    /**
+     * Unified track-lifecycle event: ONE category carrying `phase:
+     * 'start' | 'update' | 'end'` with a rich, typed
+     * `PipelineAnalyticsTrackLifecyclePayload`. Supersedes the thin
+     * `PipelineAnalyticsTrackStarted` / `PipelineAnalyticsTrackEnded`
+     * pair — a consumer subscribes once and branches on `phase`.
+     */
+    PipelineAnalyticsTrackLifecycle = "pipeline-analytics.track-lifecycle",
+    /**
+     * @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
+     * (`phase:'start'`). Kept as a soft alias — no known subscribers.
+     */
     PipelineAnalyticsTrackStarted = "pipeline-analytics.track-started",
+    /**
+     * @deprecated Superseded by {@link PipelineAnalyticsTrackLifecycle}
+     * (`phase:'end'`). Kept as a soft alias — no known subscribers.
+     */
     PipelineAnalyticsTrackEnded = "pipeline-analytics.track-ended",
     PipelineAnalyticsDetectionEvent = "pipeline-analytics.detection-event",
     PipelineAnalyticsFrameTracked = "pipeline-analytics.frame-tracked",
+    /**
+     * Fired by `addon-post-analysis` when a parked (stationary) object appears
+     * (a track was promoted to a stationary-registry entry) or departs (the
+     * object moved / was removed). Telemetry (D8): lossy, drives a UI refresh of
+     * the dedicated "Stationary" section — never the live event feed. Payload:
+     * `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
+     */
+    PipelineAnalyticsStationaryChanged = "pipeline-analytics.stationary-changed",
+    /**
+     * Fired by `addon-post-analysis` whenever a gallery face row changes:
+     * `kind:'buffered'` a new detected face was persisted, `'assigned'` /
+     * `'unassigned'` its identity link changed, `'deleted'` the row was
+     * removed. Telemetry semantics (D8): a lost event only delays a refresh,
+     * never a correctness issue. Payload `PipelineAnalyticsFaceGalleryChangedPayload`.
+     */
+    PipelineAnalyticsFaceGalleryChanged = "pipeline-analytics.face-gallery-changed",
+    /**
+     * Fired by `addon-post-analysis` whenever a gallery plate row changes:
+     * `kind:'buffered'` a new read was persisted (`PlateRecognizer.onTrackEnd`),
+     * `'assigned'` / `'unassigned'` its vehicle link changed
+     * (`PlateGalleryProvider`), `'deleted'` the row was removed. Telemetry
+     * semantics (D8): a lost event only delays a refresh, never a correctness
+     * issue. Payload `PipelineAnalyticsPlateGalleryChangedPayload`.
+     */
+    PipelineAnalyticsPlateGalleryChanged = "pipeline-analytics.plate-gallery-changed",
     FrigateLiveEvent = "frigate.live-event",
     CameraStreamsProfileSlotsChanged = "camera-streams.onProfileSlotsChanged",
     /**