@camstack/types 1.1.40 → 1.1.42

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-Dqd2OlRi.js");
+const require_sleep = require("./sleep-ByctZsHo.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 exports.BaseAddon = require_sleep.BaseAddon;
 exports.DATAPLANE_SECRET_HEADER = require_sleep.DATAPLANE_SECRET_HEADER;

package/dist/addon.mjs

@@ -1,3 +1,3 @@
-import { A as parseJsonUnknown, D as asString, I as scopeKey, M as ReadinessRegistry, N as ReadinessTimeoutError, S as DeviceType, T as asJsonObject, a as viewerUiCapability, bt as EventCategory, ct as BaseAddon, ft as emitReadiness, i as deviceOpsCapability, j as DATAPLANE_SECRET_HEADER, lt as normalizeAddonInitResult, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep, xt as DisposerChain } from "./sleep-b4Jf2n33.mjs";
+import { A as parseJsonUnknown, D as asString, I as scopeKey, M as ReadinessRegistry, N as ReadinessTimeoutError, S as DeviceType, T as asJsonObject, a as viewerUiCapability, bt as EventCategory, ct as BaseAddon, ft as emitReadiness, i as deviceOpsCapability, j as DATAPLANE_SECRET_HEADER, lt as normalizeAddonInitResult, m as expandCapMethods, o as adminUiCapability, s as createDeviceProxy, t as sleep, xt as DisposerChain } from "./sleep-BC9Yqte7.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 export { BaseAddon, DATAPLANE_SECRET_HEADER, DeviceType, DisposerChain, EventCategory, ReadinessRegistry, ReadinessTimeoutError, adminUiCapability, asJsonObject, asString, createDeviceProxy, deviceOpsCapability, emitReadiness, errMsg, expandCapMethods, normalizeAddonInitResult, parseJsonUnknown, scopeKey, sleep, viewerUiCapability };

package/dist/capabilities/face-gallery.cap.d.ts

@@ -28,6 +28,13 @@ declare const FaceInfoSchema: z.ZodObject<{
     identityName: z.ZodOptional<z.ZodString>;
     assigned: z.ZodBoolean;
     base64: z.ZodOptional<z.ZodString>;
+    faceBbox: z.ZodOptional<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>>;
+    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type FaceInfo = z.infer<typeof FaceInfoSchema>;
 export declare const faceGalleryCapability: {
@@ -90,6 +97,13 @@ export declare const faceGalleryCapability: {
             identityName: z.ZodOptional<z.ZodString>;
             assigned: z.ZodBoolean;
             base64: z.ZodOptional<z.ZodString>;
+            faceBbox: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getFaceByTrack: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -103,6 +117,13 @@ export declare const faceGalleryCapability: {
             identityName: z.ZodOptional<z.ZodString>;
             assigned: z.ZodBoolean;
             base64: z.ZodOptional<z.ZodString>;
+            faceBbox: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getFaceMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             faceId: z.ZodString;

package/dist/capabilities/index.d.ts

@@ -74,7 +74,7 @@ export type { NetworkAccessStatus, NetworkEndpoint } from './network-access.cap.
 export { NetworkAccessStatusSchema, NetworkEndpointSchema, networkAccessCapability, } from './network-access.cap.js';
 export { type Attachment, AttachmentMediaTypeSchema, type AttachmentMediaType, AttachmentSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, NotificationActionSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, TargetSchema, type TestResult, TestResultSchema, notificationOutputCapability, } from './notification-output.cap.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
-export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, EventKindSchema, type IPipelineAnalyticsProvider, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type ScoredObjectEvent, ScoredObjectEventSchema, type Track, TrackedDetectionSchema, TrackSchema, type TrackState, TrackStateSchema, } from './pipeline-analytics.cap.js';
+export { type AudioEvent, AudioEventSchema, type DetectionSource, DetectionSourceSchema, type EventKind, EventKindSchema, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type MediaFile, type MediaFileKind, MediaFileSchema, type MotionEvent, MotionEventSchema, type ObjectEvent, ObjectEventSchema, pipelineAnalyticsCapability, type ScoredObjectEvent, ScoredObjectEventSchema, type Track, TrackedDetectionSchema, TrackSchema, type TrackState, TrackStateSchema, } from './pipeline-analytics.cap.js';
 export type { PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
 export { ModelSubstitutionSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, pipelineExecutorCapability, } from './pipeline-executor.cap.js';
 export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderShm, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraSourceStream, CameraStatus, IngestOwner, } from './pipeline-orchestrator.cap.js';

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

@@ -82,6 +82,9 @@ declare const TrackSchema: z.ZodObject<{
         entered: "entered";
     }>;
     active: z.ZodBoolean;
+    importance: z.ZodOptional<z.ZodNumber>;
+    bestEventId: z.ZodOptional<z.ZodString>;
+    importanceReason: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Track = z.infer<typeof TrackSchema>;
 declare const MotionEventSchema: z.ZodObject<{
@@ -146,7 +149,9 @@ declare const ObjectEventSchema: z.ZodObject<{
     frameWidth: z.ZodOptional<z.ZodNumber>;
     frameHeight: z.ZodOptional<z.ZodNumber>;
     mediaKey: z.ZodOptional<z.ZodString>;
+    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
     mediaUrl: z.ZodOptional<z.ZodString>;
+    importance: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     deviceId: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -177,6 +182,7 @@ declare const MediaFileKindEnum: z.ZodEnum<{
     fullFrameBoxed: "fullFrameBoxed";
     faceCrop: "faceCrop";
     plateCrop: "plateCrop";
+    keyFrame: "keyFrame";
 }>;
 export type MediaFileKind = z.infer<typeof MediaFileKindEnum>;
 declare const MediaFileSchema: z.ZodObject<{
@@ -191,12 +197,24 @@ declare const MediaFileSchema: z.ZodObject<{
         fullFrameBoxed: "fullFrameBoxed";
         faceCrop: "faceCrop";
         plateCrop: "plateCrop";
+        keyFrame: "keyFrame";
     }>;
     base64: z.ZodString;
     sizeBytes: z.ZodNumber;
     timestamp: z.ZodNumber;
 }, z.core.$strip>;
 export type MediaFile = z.infer<typeof MediaFileSchema>;
+declare const KeyEventSchema: z.ZodObject<{
+    id: z.ZodString;
+    trackId: z.ZodString;
+    timestamp: z.ZodNumber;
+    className: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    importance: z.ZodNumber;
+    bestEventId: z.ZodString;
+    windowMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type KeyEvent = z.infer<typeof KeyEventSchema>;
 declare const TrackedDetectionSchema: z.ZodObject<{
     trackId: z.ZodString;
     className: z.ZodString;
@@ -244,7 +262,9 @@ export declare const ScoredObjectEventSchema: z.ZodObject<{
     frameWidth: z.ZodOptional<z.ZodNumber>;
     frameHeight: z.ZodOptional<z.ZodNumber>;
     mediaKey: z.ZodOptional<z.ZodString>;
+    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
     mediaUrl: z.ZodOptional<z.ZodString>;
+    importance: z.ZodOptional<z.ZodNumber>;
     id: z.ZodString;
     deviceId: z.ZodNumber;
     timestamp: z.ZodNumber;
@@ -305,6 +325,9 @@ export declare const pipelineAnalyticsCapability: {
                 entered: "entered";
             }>;
             active: z.ZodBoolean;
+            importance: z.ZodOptional<z.ZodNumber>;
+            bestEventId: z.ZodOptional<z.ZodString>;
+            importanceReason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getTrack: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -352,6 +375,9 @@ export declare const pipelineAnalyticsCapability: {
                 entered: "entered";
             }>;
             active: z.ZodBoolean;
+            importance: z.ZodOptional<z.ZodNumber>;
+            bestEventId: z.ZodOptional<z.ZodString>;
+            importanceReason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Historical completed tracks for a device. Queried from the
          *  persisted `pipeline-analytics:tracks` collection; active tracks
@@ -404,6 +430,9 @@ export declare const pipelineAnalyticsCapability: {
                 entered: "entered";
             }>;
             active: z.ZodBoolean;
+            importance: z.ZodOptional<z.ZodNumber>;
+            bestEventId: z.ZodOptional<z.ZodString>;
+            importanceReason: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly clearTracks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -475,7 +504,9 @@ export declare const pipelineAnalyticsCapability: {
             frameWidth: z.ZodOptional<z.ZodNumber>;
             frameHeight: z.ZodOptional<z.ZodNumber>;
             mediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
             mediaUrl: z.ZodOptional<z.ZodString>;
+            importance: z.ZodOptional<z.ZodNumber>;
             id: z.ZodString;
             deviceId: z.ZodNumber;
             timestamp: z.ZodNumber;
@@ -503,6 +534,31 @@ export declare const pipelineAnalyticsCapability: {
             deviceId: z.ZodNumber;
             timestamp: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Importance-ranked highlights for a device+window. Queries completed
+         * tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
+         * the persisted score), filters by minImportance/classFilter, orders by
+         * importance desc, and returns up to `limit` compact key events mapped to
+         * each track's best event. Legacy tracks lacking a persisted score are
+         * scored on-read (no write). Degrades to `[]` on error.
+         */
+        readonly getKeyEvents: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            since: z.ZodNumber;
+            until: z.ZodNumber;
+            limit: z.ZodDefault<z.ZodNumber>;
+            minImportance: z.ZodOptional<z.ZodNumber>;
+            classFilter: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            trackId: z.ZodString;
+            timestamp: z.ZodNumber;
+            className: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            importance: z.ZodNumber;
+            bestEventId: z.ZodString;
+            windowMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** Server-side bucketed event counts for the 24-hour timeline.
          *  Returns one entry per non-empty bucket; empty buckets are omitted. */
         readonly getEventDensity: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -544,6 +600,7 @@ export declare const pipelineAnalyticsCapability: {
                 fullFrameBoxed: "fullFrameBoxed";
                 faceCrop: "faceCrop";
                 plateCrop: "plateCrop";
+                keyFrame: "keyFrame";
             }>>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -557,6 +614,7 @@ export declare const pipelineAnalyticsCapability: {
                 fullFrameBoxed: "fullFrameBoxed";
                 faceCrop: "faceCrop";
                 plateCrop: "plateCrop";
+                keyFrame: "keyFrame";
             }>;
             base64: z.ZodString;
             sizeBytes: z.ZodNumber;
@@ -576,6 +634,7 @@ export declare const pipelineAnalyticsCapability: {
                 fullFrameBoxed: "fullFrameBoxed";
                 faceCrop: "faceCrop";
                 plateCrop: "plateCrop";
+                keyFrame: "keyFrame";
             }>;
             base64: z.ZodString;
             sizeBytes: z.ZodNumber;
@@ -625,7 +684,9 @@ export declare const pipelineAnalyticsCapability: {
             frameWidth: z.ZodOptional<z.ZodNumber>;
             frameHeight: z.ZodOptional<z.ZodNumber>;
             mediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
             mediaUrl: z.ZodOptional<z.ZodString>;
+            importance: z.ZodOptional<z.ZodNumber>;
             id: z.ZodString;
             deviceId: z.ZodNumber;
             timestamp: z.ZodNumber;
@@ -699,4 +760,4 @@ export declare const pipelineAnalyticsCapability: {
     };
 };
 export type IPipelineAnalyticsProvider = InferProvider<typeof pipelineAnalyticsCapability>;
-export { TrackStateSchema, EventKindSchema, TrackSchema, MotionEventSchema, ObjectEventSchema, AudioEventSchema, MediaFileKindEnum, MediaFileSchema, TrackedDetectionSchema, };
+export { TrackStateSchema, EventKindSchema, TrackSchema, KeyEventSchema, MotionEventSchema, ObjectEventSchema, AudioEventSchema, MediaFileKindEnum, MediaFileSchema, TrackedDetectionSchema, };

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

@@ -156,6 +156,7 @@ declare const PipelineAddonSchemaSchema: z.ZodObject<{
     defaultModelId: z.ZodString;
     defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     enabledByDefault: z.ZodOptional<z.ZodBoolean>;
+    backfillIntoExistingOverrides: z.ZodOptional<z.ZodBoolean>;
     defaultConfidence: z.ZodNumber;
     group: z.ZodOptional<z.ZodString>;
     configSchema: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<ConfigField, ConfigField>>>>;
@@ -221,6 +222,7 @@ declare const PipelineSlotSchemaSchema: z.ZodObject<{
         defaultModelId: z.ZodString;
         defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         enabledByDefault: z.ZodOptional<z.ZodBoolean>;
+        backfillIntoExistingOverrides: z.ZodOptional<z.ZodBoolean>;
         defaultConfidence: z.ZodNumber;
         group: z.ZodOptional<z.ZodString>;
         configSchema: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<ConfigField, ConfigField>>>>;
@@ -326,6 +328,7 @@ declare const PipelineSchemaSchema: z.ZodObject<{
             defaultModelId: z.ZodString;
             defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
             enabledByDefault: z.ZodOptional<z.ZodBoolean>;
+            backfillIntoExistingOverrides: z.ZodOptional<z.ZodBoolean>;
             defaultConfidence: z.ZodNumber;
             group: z.ZodOptional<z.ZodString>;
             configSchema: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<ConfigField, ConfigField>>>>;
@@ -644,6 +647,7 @@ export declare const pipelineExecutorCapability: {
                     defaultModelId: z.ZodString;
                     defaultModelIdByFormat: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
                     enabledByDefault: z.ZodOptional<z.ZodBoolean>;
+                    backfillIntoExistingOverrides: z.ZodOptional<z.ZodBoolean>;
                     defaultConfidence: z.ZodNumber;
                     group: z.ZodOptional<z.ZodString>;
                     configSchema: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodCustom<ConfigField, ConfigField>>>>;

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

@@ -1,6 +1,26 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 import type { ConfigField } from '../interfaces/config-ui.js';
+/**
+ * A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
+ * decode worker resolves it against the RETAINED native frame's real pixel dims,
+ * so the caller supplies only the detection-res bbox divided by the detection
+ * dims — no native resolution to plumb.
+ */
+export declare const NativeCropBboxSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strip>;
+/** Result of a best-effort native-resolution crop (`getNativeCrop`). */
+export declare const NativeCropResultSchema: z.ZodObject<{
+    bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+export type NativeCropBbox = z.infer<typeof NativeCropBboxSchema>;
+export type NativeCropCapResult = z.infer<typeof NativeCropResultSchema>;
 /**
  * Source enum for motion signals fed to the runner. Extensible — add
  * new variants here when new motion-trigger paths are wired in
@@ -375,6 +395,47 @@ export declare const pipelineRunnerCapability: {
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /** List the deviceIds currently attached to this runner. */
         readonly getLocalCameras: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodNumber>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Best-effort NATIVE-resolution crop of a retention-ring frame. Given the
+         * `FrameHandle` that rode an inference-result event and a normalized `bbox`,
+         * the runner asks the decode worker still holding that frame's NATIVE
+         * surface to GPU/CPU-crop ONLY the ROI at native res and download just the
+         * crop. Returns `null` on a miss (handle not registered, or the worker's
+         * tiny native-retention ring already evicted the frame) — the caller falls
+         * back to a detection-frame crop. Routed to the frame's owning node by
+         * `handle.nodeId`; NEVER ships a full native frame.
+         */
+        readonly getNativeCrop: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            handle: z.ZodObject<{
+                shmId: z.ZodString;
+                slot: z.ZodNumber;
+                seq: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                format: z.ZodEnum<{
+                    jpeg: "jpeg";
+                    rgb: "rgb";
+                    bgr: "bgr";
+                    yuv420: "yuv420";
+                    gray: "gray";
+                }>;
+                pts: z.ZodNumber;
+                byteLength: z.ZodNumber;
+                nodeId: z.ZodString;
+                slotCount: z.ZodNumber;
+            }, z.core.$strip>;
+            bbox: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, z.core.$strip>;
+            maxWidth: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            bytes: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
     };
 };
 export type IPipelineRunnerProvider = InferProvider<typeof pipelineRunnerCapability>;

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

@@ -8856,6 +8856,9 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                importance?: number | undefined;
+                bestEventId?: string | undefined;
+                importanceReason?: string | undefined;
             }[];
             meta: object;
         }>;
@@ -8902,6 +8905,9 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                importance?: number | undefined;
+                bestEventId?: string | undefined;
+                importanceReason?: string | undefined;
             } | null;
             meta: object;
         }>;
@@ -8950,6 +8956,9 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                importance?: number | undefined;
+                bestEventId?: string | undefined;
+                importanceReason?: string | undefined;
             }[];
             meta: object;
         }>;
@@ -9025,6 +9034,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 frameHeight?: number | undefined;
                 mediaKey?: string | undefined;
                 mediaUrl?: string | undefined;
+                importance?: number | undefined;
             }[];
             meta: object;
         }>;
@@ -9053,6 +9063,28 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             }[];
             meta: object;
         }>;
+        getKeyEvents: import("@trpc/server").TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+                deviceId: number;
+                since: number;
+                until: number;
+                limit?: number | undefined;
+                minImportance?: number | undefined;
+                classFilter?: string | undefined;
+            };
+            output: readonly {
+                id: string;
+                trackId: string;
+                timestamp: number;
+                className: string;
+                importance: number;
+                bestEventId: string;
+                label?: string | undefined;
+                windowMs?: number | undefined;
+            }[];
+            meta: object;
+        }>;
         getEventDensity: import("@trpc/server").TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -9146,6 +9178,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 frameHeight?: number | undefined;
                 mediaKey?: string | undefined;
                 mediaUrl?: string | undefined;
+                importance?: number | undefined;
             }[];
             meta: object;
         }>;
@@ -9310,6 +9343,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         defaultConfidence: number;
                         defaultModelIdByFormat?: Record<string, string> | undefined;
                         enabledByDefault?: boolean | undefined;
+                        backfillIntoExistingOverrides?: boolean | undefined;
                         group?: string | undefined;
                         configSchema?: readonly import("@camstack/types").ConfigField[] | undefined;
                     }[];
@@ -10719,6 +10753,36 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             output: readonly number[];
             meta: object;
         }>;
+        getNativeCrop: import("@trpc/server").TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+                handle: {
+                    shmId: string;
+                    slot: number;
+                    seq: number;
+                    width: number;
+                    height: number;
+                    format: "rgb" | "jpeg" | "bgr" | "yuv420" | "gray";
+                    pts: number;
+                    byteLength: number;
+                    nodeId: string;
+                    slotCount: number;
+                };
+                bbox: {
+                    x: number;
+                    y: number;
+                    w: number;
+                    h: number;
+                };
+                maxWidth?: number | undefined;
+            };
+            output: {
+                bytes: Uint8Array<ArrayBuffer>;
+                width: number;
+                height: number;
+            } | null;
+            meta: object;
+        }>;
     }>>;
     plateGallery: import("@trpc/server").TRPCBuiltRouter<{
         ctx: TrpcContext;
@@ -23772,6 +23836,9 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                importance?: number | undefined;
+                bestEventId?: string | undefined;
+                importanceReason?: string | undefined;
             }[];
             meta: object;
         }>;
@@ -23818,6 +23885,9 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                importance?: number | undefined;
+                bestEventId?: string | undefined;
+                importanceReason?: string | undefined;
             } | null;
             meta: object;
         }>;
@@ -23866,6 +23936,9 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 state: "idle" | "left" | "moving" | "new" | "entered";
                 active: boolean;
                 label?: string | undefined;
+                importance?: number | undefined;
+                bestEventId?: string | undefined;
+                importanceReason?: string | undefined;
             }[];
             meta: object;
         }>;
@@ -23941,6 +24014,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 frameHeight?: number | undefined;
                 mediaKey?: string | undefined;
                 mediaUrl?: string | undefined;
+                importance?: number | undefined;
             }[];
             meta: object;
         }>;
@@ -23969,6 +24043,28 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             }[];
             meta: object;
         }>;
+        getKeyEvents: import("@trpc/server").TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+                deviceId: number;
+                since: number;
+                until: number;
+                limit?: number | undefined;
+                minImportance?: number | undefined;
+                classFilter?: string | undefined;
+            };
+            output: readonly {
+                id: string;
+                trackId: string;
+                timestamp: number;
+                className: string;
+                importance: number;
+                bestEventId: string;
+                label?: string | undefined;
+                windowMs?: number | undefined;
+            }[];
+            meta: object;
+        }>;
         getEventDensity: import("@trpc/server").TRPCQueryProcedure<{
             input: {
                 [x: string]: unknown;
@@ -24062,6 +24158,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 frameHeight?: number | undefined;
                 mediaKey?: string | undefined;
                 mediaUrl?: string | undefined;
+                importance?: number | undefined;
             }[];
             meta: object;
         }>;
@@ -24226,6 +24323,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                         defaultConfidence: number;
                         defaultModelIdByFormat?: Record<string, string> | undefined;
                         enabledByDefault?: boolean | undefined;
+                        backfillIntoExistingOverrides?: boolean | undefined;
                         group?: string | undefined;
                         configSchema?: readonly import("@camstack/types").ConfigField[] | undefined;
                     }[];
@@ -25635,6 +25733,36 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
             output: readonly number[];
             meta: object;
         }>;
+        getNativeCrop: import("@trpc/server").TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+                handle: {
+                    shmId: string;
+                    slot: number;
+                    seq: number;
+                    width: number;
+                    height: number;
+                    format: "rgb" | "jpeg" | "bgr" | "yuv420" | "gray";
+                    pts: number;
+                    byteLength: number;
+                    nodeId: string;
+                    slotCount: number;
+                };
+                bbox: {
+                    x: number;
+                    y: number;
+                    w: number;
+                    h: number;
+                };
+                maxWidth?: number | undefined;
+            };
+            output: {
+                bytes: Uint8Array<ArrayBuffer>;
+                width: number;
+                height: number;
+            } | null;
+            meta: object;
+        }>;
     }>>;
     plateGallery: import("@trpc/server").TRPCBuiltRouter<{
         ctx: TrpcContext;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 735 method paths across 112 capabilities.
+ * Coverage: 737 method paths across 112 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/system-proxy.d.ts

@@ -74,7 +74,7 @@ export interface SystemProxy {
     readonly notificationOutput: Pick<InferProvider<typeof notificationOutputCapability>, 'listTargetKinds' | 'listTargets' | 'discoverTargets' | 'send' | 'testTarget' | 'upsertTarget' | 'deleteTarget' | 'setTargetEnabled'>;
     readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'reprobeEngine' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'getSchema' | 'getGlobalSteps' | 'getGlobalPipelineConfig' | 'getOrchestratorConfigSchema' | 'validatePipeline' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate' | 'getCapabilities' | 'getAddonModels' | 'downloadModel' | 'deleteModel' | 'cacheFrameInPool' | 'inferCached' | 'uncacheFrame' | 'getEffectiveTuning' | 'listLoadedEngines' | 'spinEngine' | 'killEngine' | 'listReferenceImages' | 'getReferenceImage' | 'getReferenceAudioFiles' | 'getReferenceAudio' | 'getAudioCapabilities' | 'runAudioTest' | 'getDetectionConfigSchema'>;
     readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAgentSettings' | 'listAgentSettings' | 'setAgentAddonDefaults' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentReachableHost' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
-    readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras'>;
+    readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate'>;
     readonly recording: Pick<InferProvider<typeof recordingCapability>, 'getStorageUsage'>;
     readonly serverManagement: Pick<InferProvider<typeof serverManagementCapability>, 'getServerPackageStatus' | 'checkServerUpdate' | 'applyServerUpdate' | 'rollbackServerUpdate' | 'restartServer'>;

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-Dqd2OlRi.js");
+const require_sleep = require("./sleep-ByctZsHo.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");
 //#region src/health/wiring-health.ts
@@ -7589,6 +7589,7 @@ var PipelineAddonSchemaSchema = zod.z.object({
 	defaultModelId: zod.z.string(),
 	defaultModelIdByFormat: zod.z.record(zod.z.string(), zod.z.string()).optional(),
 	enabledByDefault: zod.z.boolean().optional(),
+	backfillIntoExistingOverrides: zod.z.boolean().optional(),
 	defaultConfidence: zod.z.number(),
 	group: zod.z.string().optional(),
 	configSchema: zod.z.array(ConfigFieldBridge).readonly().optional()
@@ -8095,6 +8096,25 @@ var zonesCapability = {
 //#endregion
 //#region src/capabilities/pipeline-runner.cap.ts
 /**
+* A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
+* decode worker resolves it against the RETAINED native frame's real pixel dims,
+* so the caller supplies only the detection-res bbox divided by the detection
+* dims — no native resolution to plumb.
+*/
+var NativeCropBboxSchema = zod.z.object({
+	x: zod.z.number(),
+	y: zod.z.number(),
+	w: zod.z.number(),
+	h: zod.z.number()
+});
+/** Result of a best-effort native-resolution crop (`getNativeCrop`). */
+var NativeCropResultSchema = zod.z.object({
+	/** Packed rgb (24-bit) pixels of the crop. */
+	bytes: zod.z.instanceof(Uint8Array),
+	width: zod.z.number().int().positive(),
+	height: zod.z.number().int().positive()
+});
+/**
 * Per-camera tunable ranges + defaults. Single source of truth used
 * by both the Zod data schema (validation + default fallback) and
 * the device settings UI (slider min/max/step). Touch one place and
@@ -8522,7 +8542,22 @@ var pipelineRunnerCapability = {
 		/** All per-camera metrics in one round-trip. */
 		getAllCameraMetrics: require_sleep.method(zod.z.void(), zod.z.array(CameraMetricsWithDeviceIdSchema).readonly()),
 		/** List the deviceIds currently attached to this runner. */
-		getLocalCameras: require_sleep.method(zod.z.void(), zod.z.array(zod.z.number()).readonly())
+		getLocalCameras: require_sleep.method(zod.z.void(), zod.z.array(zod.z.number()).readonly()),
+		/**
+		* Best-effort NATIVE-resolution crop of a retention-ring frame. Given the
+		* `FrameHandle` that rode an inference-result event and a normalized `bbox`,
+		* the runner asks the decode worker still holding that frame's NATIVE
+		* surface to GPU/CPU-crop ONLY the ROI at native res and download just the
+		* crop. Returns `null` on a miss (handle not registered, or the worker's
+		* tiny native-retention ring already evicted the frame) — the caller falls
+		* back to a detection-frame crop. Routed to the frame's owning node by
+		* `handle.nodeId`; NEVER ships a full native frame.
+		*/
+		getNativeCrop: require_sleep.method(zod.z.object({
+			handle: require_sleep.FrameHandleSchema,
+			bbox: NativeCropBboxSchema,
+			maxWidth: zod.z.number().int().positive().optional()
+		}), NativeCropResultSchema.nullable())
 	}
 };
 //#endregion
@@ -12614,7 +12649,8 @@ function createSystemProxy(api) {
 			getLocalLoad: (input) => dispatch("pipelineRunner", "getLocalLoad", "query", input),
 			getLocalMetrics: (input) => dispatch("pipelineRunner", "getLocalMetrics", "query", input),
 			getAllCameraMetrics: (input) => dispatch("pipelineRunner", "getAllCameraMetrics", "query", input),
-			getLocalCameras: (input) => dispatch("pipelineRunner", "getLocalCameras", "query", input)
+			getLocalCameras: (input) => dispatch("pipelineRunner", "getLocalCameras", "query", input),
+			getNativeCrop: (input) => dispatch("pipelineRunner", "getNativeCrop", "query", input)
 		},
 		plateGallery: {
 			getPlateMedia: (input) => dispatch("plateGallery", "getPlateMedia", "query", input),
@@ -17430,7 +17466,17 @@ var TrackSchema = zod.z.object({
 	/** Cumulative normalized distance travelled (0..1 units = full frame width). */
 	totalDistance: zod.z.number(),
 	state: TrackStateSchema,
-	active: zod.z.boolean()
+	active: zod.z.boolean(),
+	/** Deterministic key-event importance score in [0,1] (server-computed at
+	*  track expiry, recomputed on late label). Absent on legacy rows written
+	*  before scoring shipped — consumers degrade to absence / compute-on-read. */
+	importance: zod.z.number().optional(),
+	/** Id of the track's highest-confidence ObjectEvent (its representative
+	*  "best" frame). Absent when the track produced no object events. */
+	bestEventId: zod.z.string().optional(),
+	/** Tag of the importance sub-signal that dominated the score
+	*  (identity|dwell|proximity|class|confidence|travel|zone). */
+	importanceReason: zod.z.string().optional()
 });
 var BaseEventFields = {
 	id: zod.z.string(),
@@ -17495,8 +17541,18 @@ var ObjectEventSchema = zod.z.object({
 	frameHeight: zod.z.number().optional(),
 	/** MediaStore key for the crop attached to this event (if any). */
 	mediaKey: zod.z.string().optional(),
+	/** Design B: MediaStore key of the track's native-resolution key frame (the
+	*  best-detection full frame). Resolve via the event-media data-plane
+	*  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`) for a detail view that
+	*  draws `bbox` over the native frame. Absent on legacy rows / non-decoded
+	*  sources — consumers fall back to `mediaKey` (the tight crop). */
+	keyFrameMediaKey: zod.z.string().optional(),
 	/** Populated by B5 (recording playback URL for this event). */
-	mediaUrl: zod.z.string().optional()
+	mediaUrl: zod.z.string().optional(),
+	/** The parent track's key-event importance [0,1], propagated to every object
+	*  event of the track (so an event row can be sorted by importance without a
+	*  track join). Absent on legacy rows / before the track was scored. */
+	importance: zod.z.number().optional()
 });
 var AudioEventSchema = zod.z.object({
 	...BaseEventFields,
@@ -17520,7 +17576,8 @@ var MediaFileKindEnum = zod.z.enum([
 	"fullFrame",
 	"fullFrameBoxed",
 	"faceCrop",
-	"plateCrop"
+	"plateCrop",
+	"keyFrame"
 ]);
 var MediaFileSchema = zod.z.object({
 	key: zod.z.string(),
@@ -17541,6 +17598,32 @@ var DeviceEventQueryInput = zod.z.object({
 	projection: zod.z.enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: zod.z.string().optional() });
+var KeyEventQueryInput = zod.z.object({
+	deviceId: zod.z.number(),
+	/** Window lower bound (track firstSeen ≥ since). */
+	since: zod.z.number(),
+	/** Window upper bound (track firstSeen ≤ until). */
+	until: zod.z.number(),
+	limit: zod.z.number().int().min(1).max(200).default(50),
+	/** Drop tracks scoring below this importance. */
+	minImportance: zod.z.number().min(0).max(1).optional(),
+	/** Restrict to a single class (e.g. 'person'). */
+	classFilter: zod.z.string().optional()
+});
+var KeyEventSchema = zod.z.object({
+	/** The representative event id (the track's best ObjectEvent, else its trackId). */
+	id: zod.z.string(),
+	trackId: zod.z.string(),
+	/** Track start time (firstSeen). */
+	timestamp: zod.z.number(),
+	className: zod.z.string(),
+	label: zod.z.string().optional(),
+	importance: zod.z.number(),
+	/** Highest-confidence ObjectEvent id for the track (empty when none). */
+	bestEventId: zod.z.string(),
+	/** Track lifetime in ms (lastSeen - firstSeen). */
+	windowMs: zod.z.number().optional()
+});
 var TrackedDetectionSchema = zod.z.object({
 	trackId: zod.z.string(),
 	className: zod.z.string(),
@@ -17589,6 +17672,15 @@ var pipelineAnalyticsCapability = {
 		getMotionEvents: require_sleep.method(DeviceEventQueryInput, zod.z.array(MotionEventSchema).readonly()),
 		getObjectEvents: require_sleep.method(ObjectEventQueryInput, zod.z.array(ObjectEventSchema).readonly()),
 		getAudioEvents: require_sleep.method(DeviceEventQueryInput, zod.z.array(AudioEventSchema).readonly()),
+		/**
+		* Importance-ranked highlights for a device+window. Queries completed
+		* tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
+		* the persisted score), filters by minImportance/classFilter, orders by
+		* importance desc, and returns up to `limit` compact key events mapped to
+		* each track's best event. Legacy tracks lacking a persisted score are
+		* scored on-read (no write). Degrades to `[]` on error.
+		*/
+		getKeyEvents: require_sleep.method(KeyEventQueryInput, zod.z.array(KeyEventSchema).readonly()),
 		/** Server-side bucketed event counts for the 24-hour timeline.
 		*  Returns one entry per non-empty bucket; empty buckets are omitted. */
 		getEventDensity: require_sleep.method(zod.z.object({
@@ -20492,7 +20584,17 @@ var FaceInfoSchema = zod.z.object({
 	recognizedIdentityId: zod.z.string().optional(),
 	identityName: zod.z.string().optional(),
 	assigned: zod.z.boolean(),
-	base64: zod.z.string().optional()
+	base64: zod.z.string().optional(),
+	/** Design B: the face bbox (pixel space) on the key frame — lets a detail
+	*  view draw the box over the native `keyFrameMediaKey` frame. Absent on
+	*  legacy rows written before design B. */
+	faceBbox: BoundingBoxSchema.optional(),
+	/** Design B: MediaStore key of the track's native-resolution key frame.
+	*  Fetch the native JPEG via the event-media data-plane
+	*  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`). Absent when the
+	*  track produced no key frame (e.g. native/onboard source) — the UI falls
+	*  back to the inline `base64` face crop. */
+	keyFrameMediaKey: zod.z.string().optional()
 });
 var FaceFilterEnum = zod.z.enum([
 	"unassigned",
@@ -26377,6 +26479,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getKeyEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getMotionEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -26905,6 +27013,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineRunner.getNativeCrop": {
+		capName: "pipeline-runner",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineRunner.reportMotion": {
 		capName: "pipeline-runner",
 		capScope: "system",
@@ -29272,6 +29386,7 @@ exports.IntegrationWithStateSchema = IntegrationWithStateSchema;
 exports.IntercomAbilitySchema = IntercomAbilitySchema;
 exports.IntercomStatusSchema = IntercomStatusSchema;
 exports.KNOWN_CAP_NAMES = KNOWN_CAP_NAMES;
+exports.KeyEventSchema = KeyEventSchema;
 exports.LabelDefinitionSchema = LabelDefinitionSchema;
 exports.LawnMowerActivitySchema = LawnMowerActivitySchema;
 exports.LawnMowerControlStatusSchema = LawnMowerControlStatusSchema;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { $ as StreamSourceSchema, A as parseJsonUnknown, B as CamProfileSchema, C as asBoolean, D as asString, E as asNumber, F as readinessKey, G as DecodedFrameSchema, H as CamStreamResolutionSchema, I as scopeKey, J as FrameHandleSchema, K as EncodedPacketSchema, L as BrokerStatsSchema, M as ReadinessRegistry, N as ReadinessTimeoutError, O as parseJsonArray, P as emitDownForOwnedCaps, Q as StreamSourceEntrySchema, R as BrokerStatusSchema, S as DeviceType, T as asJsonObject, U as CameraStreamSchema, V as CamStreamKindSchema, W as DecodedAudioChunkSchema, X as ProfileSlotSchema, Y as ProfileRtspEntrySchema, Z as ProfileSlotStatusSchema, _ as resolveCapMount, _t as collectHydratedFieldValues, a as viewerUiCapability, at as makeSourceBrokerId, b as DeviceFeature, bt as EventCategory, c as createLazyTrpcSource, ct as BaseAddon, d as DEVICE_SETTINGS_CONTRIBUTION_METHODS, dt as createEvent, et as SubscribeAudioChunksInputSchema, f as DEVICE_STATUS_METHOD, ft as emitReadiness, g as method, gt as collectHydratedFieldEntries, h as isDeviceConfigCap, ht as WELL_KNOWN_TAB_MAP, i as deviceOpsCapability, it as makeProfileBrokerId, j as DATAPLANE_SECRET_HEADER, k as parseJsonObject, l as createMirrorSource, lt as normalizeAddonInitResult, m as expandCapMethods, mt as WELL_KNOWN_TABS, n as sleepCancellable, nt as SubscribeFramesInputSchema, o as adminUiCapability, ot as parseProfileBrokerId, p as event, pt as isEvent, q as FrameHandleFormatSchema, r as RawStateResultSchema, rt as SubscribeFramesResultSchema, s as createDeviceProxy, st as selectAssignedProfileSlots, t as sleep, tt as SubscribeAudioChunksResultSchema, u as createSliceHandle, ut as createDurableState, v as systemMethod, vt as hydrateSchema, w as asJsonArray, x as DeviceRole, xt as DisposerChain, y as ChargingStatus, yt as resolveHydratedFieldValue, z as CAM_PROFILE_ORDER } from "./sleep-b4Jf2n33.mjs";
+import { $ as StreamSourceSchema, A as parseJsonUnknown, B as CamProfileSchema, C as asBoolean, D as asString, E as asNumber, F as readinessKey, G as DecodedFrameSchema, H as CamStreamResolutionSchema, I as scopeKey, J as FrameHandleSchema, K as EncodedPacketSchema, L as BrokerStatsSchema, M as ReadinessRegistry, N as ReadinessTimeoutError, O as parseJsonArray, P as emitDownForOwnedCaps, Q as StreamSourceEntrySchema, R as BrokerStatusSchema, S as DeviceType, T as asJsonObject, U as CameraStreamSchema, V as CamStreamKindSchema, W as DecodedAudioChunkSchema, X as ProfileSlotSchema, Y as ProfileRtspEntrySchema, Z as ProfileSlotStatusSchema, _ as resolveCapMount, _t as collectHydratedFieldValues, a as viewerUiCapability, at as makeSourceBrokerId, b as DeviceFeature, bt as EventCategory, c as createLazyTrpcSource, ct as BaseAddon, d as DEVICE_SETTINGS_CONTRIBUTION_METHODS, dt as createEvent, et as SubscribeAudioChunksInputSchema, f as DEVICE_STATUS_METHOD, ft as emitReadiness, g as method, gt as collectHydratedFieldEntries, h as isDeviceConfigCap, ht as WELL_KNOWN_TAB_MAP, i as deviceOpsCapability, it as makeProfileBrokerId, j as DATAPLANE_SECRET_HEADER, k as parseJsonObject, l as createMirrorSource, lt as normalizeAddonInitResult, m as expandCapMethods, mt as WELL_KNOWN_TABS, n as sleepCancellable, nt as SubscribeFramesInputSchema, o as adminUiCapability, ot as parseProfileBrokerId, p as event, pt as isEvent, q as FrameHandleFormatSchema, r as RawStateResultSchema, rt as SubscribeFramesResultSchema, s as createDeviceProxy, st as selectAssignedProfileSlots, t as sleep, tt as SubscribeAudioChunksResultSchema, u as createSliceHandle, ut as createDurableState, v as systemMethod, vt as hydrateSchema, w as asJsonArray, x as DeviceRole, xt as DisposerChain, y as ChargingStatus, yt as resolveHydratedFieldValue, z as CAM_PROFILE_ORDER } from "./sleep-BC9Yqte7.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { z } from "zod";
 //#region src/health/wiring-health.ts
@@ -7588,6 +7588,7 @@ var PipelineAddonSchemaSchema = z.object({
 	defaultModelId: z.string(),
 	defaultModelIdByFormat: z.record(z.string(), z.string()).optional(),
 	enabledByDefault: z.boolean().optional(),
+	backfillIntoExistingOverrides: z.boolean().optional(),
 	defaultConfidence: z.number(),
 	group: z.string().optional(),
 	configSchema: z.array(ConfigFieldBridge).readonly().optional()
@@ -8094,6 +8095,25 @@ var zonesCapability = {
 //#endregion
 //#region src/capabilities/pipeline-runner.cap.ts
 /**
+* A bounding box in NORMALIZED [0,1] frame coordinates for `getNativeCrop`. The
+* decode worker resolves it against the RETAINED native frame's real pixel dims,
+* so the caller supplies only the detection-res bbox divided by the detection
+* dims — no native resolution to plumb.
+*/
+var NativeCropBboxSchema = z.object({
+	x: z.number(),
+	y: z.number(),
+	w: z.number(),
+	h: z.number()
+});
+/** Result of a best-effort native-resolution crop (`getNativeCrop`). */
+var NativeCropResultSchema = z.object({
+	/** Packed rgb (24-bit) pixels of the crop. */
+	bytes: z.instanceof(Uint8Array),
+	width: z.number().int().positive(),
+	height: z.number().int().positive()
+});
+/**
 * Per-camera tunable ranges + defaults. Single source of truth used
 * by both the Zod data schema (validation + default fallback) and
 * the device settings UI (slider min/max/step). Touch one place and
@@ -8521,7 +8541,22 @@ var pipelineRunnerCapability = {
 		/** All per-camera metrics in one round-trip. */
 		getAllCameraMetrics: method(z.void(), z.array(CameraMetricsWithDeviceIdSchema).readonly()),
 		/** List the deviceIds currently attached to this runner. */
-		getLocalCameras: method(z.void(), z.array(z.number()).readonly())
+		getLocalCameras: method(z.void(), z.array(z.number()).readonly()),
+		/**
+		* Best-effort NATIVE-resolution crop of a retention-ring frame. Given the
+		* `FrameHandle` that rode an inference-result event and a normalized `bbox`,
+		* the runner asks the decode worker still holding that frame's NATIVE
+		* surface to GPU/CPU-crop ONLY the ROI at native res and download just the
+		* crop. Returns `null` on a miss (handle not registered, or the worker's
+		* tiny native-retention ring already evicted the frame) — the caller falls
+		* back to a detection-frame crop. Routed to the frame's owning node by
+		* `handle.nodeId`; NEVER ships a full native frame.
+		*/
+		getNativeCrop: method(z.object({
+			handle: FrameHandleSchema,
+			bbox: NativeCropBboxSchema,
+			maxWidth: z.number().int().positive().optional()
+		}), NativeCropResultSchema.nullable())
 	}
 };
 //#endregion
@@ -12613,7 +12648,8 @@ function createSystemProxy(api) {
 			getLocalLoad: (input) => dispatch("pipelineRunner", "getLocalLoad", "query", input),
 			getLocalMetrics: (input) => dispatch("pipelineRunner", "getLocalMetrics", "query", input),
 			getAllCameraMetrics: (input) => dispatch("pipelineRunner", "getAllCameraMetrics", "query", input),
-			getLocalCameras: (input) => dispatch("pipelineRunner", "getLocalCameras", "query", input)
+			getLocalCameras: (input) => dispatch("pipelineRunner", "getLocalCameras", "query", input),
+			getNativeCrop: (input) => dispatch("pipelineRunner", "getNativeCrop", "query", input)
 		},
 		plateGallery: {
 			getPlateMedia: (input) => dispatch("plateGallery", "getPlateMedia", "query", input),
@@ -17429,7 +17465,17 @@ var TrackSchema = z.object({
 	/** Cumulative normalized distance travelled (0..1 units = full frame width). */
 	totalDistance: z.number(),
 	state: TrackStateSchema,
-	active: z.boolean()
+	active: z.boolean(),
+	/** Deterministic key-event importance score in [0,1] (server-computed at
+	*  track expiry, recomputed on late label). Absent on legacy rows written
+	*  before scoring shipped — consumers degrade to absence / compute-on-read. */
+	importance: z.number().optional(),
+	/** Id of the track's highest-confidence ObjectEvent (its representative
+	*  "best" frame). Absent when the track produced no object events. */
+	bestEventId: z.string().optional(),
+	/** Tag of the importance sub-signal that dominated the score
+	*  (identity|dwell|proximity|class|confidence|travel|zone). */
+	importanceReason: z.string().optional()
 });
 var BaseEventFields = {
 	id: z.string(),
@@ -17494,8 +17540,18 @@ var ObjectEventSchema = z.object({
 	frameHeight: z.number().optional(),
 	/** MediaStore key for the crop attached to this event (if any). */
 	mediaKey: z.string().optional(),
+	/** Design B: MediaStore key of the track's native-resolution key frame (the
+	*  best-detection full frame). Resolve via the event-media data-plane
+	*  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`) for a detail view that
+	*  draws `bbox` over the native frame. Absent on legacy rows / non-decoded
+	*  sources — consumers fall back to `mediaKey` (the tight crop). */
+	keyFrameMediaKey: z.string().optional(),
 	/** Populated by B5 (recording playback URL for this event). */
-	mediaUrl: z.string().optional()
+	mediaUrl: z.string().optional(),
+	/** The parent track's key-event importance [0,1], propagated to every object
+	*  event of the track (so an event row can be sorted by importance without a
+	*  track join). Absent on legacy rows / before the track was scored. */
+	importance: z.number().optional()
 });
 var AudioEventSchema = z.object({
 	...BaseEventFields,
@@ -17519,7 +17575,8 @@ var MediaFileKindEnum = z.enum([
 	"fullFrame",
 	"fullFrameBoxed",
 	"faceCrop",
-	"plateCrop"
+	"plateCrop",
+	"keyFrame"
 ]);
 var MediaFileSchema = z.object({
 	key: z.string(),
@@ -17540,6 +17597,32 @@ var DeviceEventQueryInput = z.object({
 	projection: z.enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: z.string().optional() });
+var KeyEventQueryInput = z.object({
+	deviceId: z.number(),
+	/** Window lower bound (track firstSeen ≥ since). */
+	since: z.number(),
+	/** Window upper bound (track firstSeen ≤ until). */
+	until: z.number(),
+	limit: z.number().int().min(1).max(200).default(50),
+	/** Drop tracks scoring below this importance. */
+	minImportance: z.number().min(0).max(1).optional(),
+	/** Restrict to a single class (e.g. 'person'). */
+	classFilter: z.string().optional()
+});
+var KeyEventSchema = z.object({
+	/** The representative event id (the track's best ObjectEvent, else its trackId). */
+	id: z.string(),
+	trackId: z.string(),
+	/** Track start time (firstSeen). */
+	timestamp: z.number(),
+	className: z.string(),
+	label: z.string().optional(),
+	importance: z.number(),
+	/** Highest-confidence ObjectEvent id for the track (empty when none). */
+	bestEventId: z.string(),
+	/** Track lifetime in ms (lastSeen - firstSeen). */
+	windowMs: z.number().optional()
+});
 var TrackedDetectionSchema = z.object({
 	trackId: z.string(),
 	className: z.string(),
@@ -17588,6 +17671,15 @@ var pipelineAnalyticsCapability = {
 		getMotionEvents: method(DeviceEventQueryInput, z.array(MotionEventSchema).readonly()),
 		getObjectEvents: method(ObjectEventQueryInput, z.array(ObjectEventSchema).readonly()),
 		getAudioEvents: method(DeviceEventQueryInput, z.array(AudioEventSchema).readonly()),
+		/**
+		* Importance-ranked highlights for a device+window. Queries completed
+		* tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
+		* the persisted score), filters by minImportance/classFilter, orders by
+		* importance desc, and returns up to `limit` compact key events mapped to
+		* each track's best event. Legacy tracks lacking a persisted score are
+		* scored on-read (no write). Degrades to `[]` on error.
+		*/
+		getKeyEvents: method(KeyEventQueryInput, z.array(KeyEventSchema).readonly()),
 		/** Server-side bucketed event counts for the 24-hour timeline.
 		*  Returns one entry per non-empty bucket; empty buckets are omitted. */
 		getEventDensity: method(z.object({
@@ -20491,7 +20583,17 @@ var FaceInfoSchema = z.object({
 	recognizedIdentityId: z.string().optional(),
 	identityName: z.string().optional(),
 	assigned: z.boolean(),
-	base64: z.string().optional()
+	base64: z.string().optional(),
+	/** Design B: the face bbox (pixel space) on the key frame — lets a detail
+	*  view draw the box over the native `keyFrameMediaKey` frame. Absent on
+	*  legacy rows written before design B. */
+	faceBbox: BoundingBoxSchema.optional(),
+	/** Design B: MediaStore key of the track's native-resolution key frame.
+	*  Fetch the native JPEG via the event-media data-plane
+	*  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`). Absent when the
+	*  track produced no key frame (e.g. native/onboard source) — the UI falls
+	*  back to the inline `base64` face crop. */
+	keyFrameMediaKey: z.string().optional()
 });
 var FaceFilterEnum = z.enum([
 	"unassigned",
@@ -26376,6 +26478,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getKeyEvents": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getMotionEvents": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -26904,6 +27012,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineRunner.getNativeCrop": {
+		capName: "pipeline-runner",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineRunner.reportMotion": {
 		capName: "pipeline-runner",
 		capScope: "system",
@@ -29013,4 +29127,4 @@ function scoreRuntimes(hw) {
 	};
 }
 //#endregion
-export { ACCESSORY_LABEL, ALL_CAPABILITY_DEFINITIONS, APPLE_SA_TO_MACRO, AUDIO_BACKEND_CHOICES, AUDIO_MACRO_LABELS, AccessoriesStatusSchema, AccessoryKind, AddBrokerInputSchema, AddonAutoUpdateSchema, AddonListItemSchema, AddonPageDeclarationSchema, AddonPageInfoSchema, AdoptInputSchema as AdoptionAdoptInputSchema, AdoptResultSchema as AdoptionAdoptResultSchema, AdoptionFilterSchema, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, AdoptionStatusSchema, AgentLoadSummarySchema, AirQualitySensorStatusSchema, AlarmArmModeSchema, AlarmPanelStatusSchema, AlarmStateSchema, AlertSchema, AlertSeveritySchema, AlertSourceSchema, AlertStatusSchema, AmbientLightSensorStatusSchema, ApiKeyRecordSchema, ApiKeySummarySchema, ArchiveEntrySchema, ArchiveManifestSchema, AttachmentMediaTypeSchema, AttachmentSchema, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioChunkInputSchema, AudioClassSummarySchema, AudioClassificationLabelSchema, AudioClassificationResultSchema, AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodeSchema, AudioEncodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEventSchema, AudioLevelSchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, AudioMetricsSnapshotSchema, AudioPcmChunkSchema, AuthResultSchema, AutoUpdateSettingsSchema, AutomationControlStatusSchema, AvailableIntegrationTypeSchema, BACKEND_TO_FORMAT, BATTERY_DEVICE_PROFILE, BacklightModeSchema, BackupDestinationInfoSchema, BackupEntrySchema, BaseAddon, BaseDevice, BaseDeviceProvider, BatteryStatusSchema, BinaryStatusSchema, BoundingBoxSchema, BrightnessStatusSchema, AddInputSchema as BrokerAddInputSchema, BrokerAudioClientSchema, BrokerClientsSchema, BrokerConnectionDetailsSchema, BrokerConsumerAttributionSchema, BrokerConsumerKindSchema, BrokerDecodedClientSchema, BrokerEncodedClientSchema, GetStateInputSchema as BrokerGetStateInputSchema, BrokerInfoSchema, BrokerProviderInfoSchema, PublishInputSchema as BrokerPublishInputSchema, RegistryStatusSchema as BrokerRegistryStatusSchema, BrokerRtspClientSchema, BrokerStatsSchema, BrokerStatusEnum, BrokerStatusSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, TestConnectionResultSchema as BrokerTestConnectionResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, CAM_PROFILE_ORDER, CAPABILITY_NAMES, CAPABILITY_ROUTER_KEYS, CAP_NAMES_WITH_STATUS, CAP_NODE_PIN_CONTEXT_KEY, CAP_PROVIDER_KIND_MAP, COCO_80_LABELS, COCO_TO_MACRO, CamProfileSchema, CamStreamDescriptorSchema, CamStreamKindSchema, CamStreamResolutionSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraCredentialsSchema, CameraCredentialsStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CameraStreamSchema, CandidateQueryFilterSchema, CapScopeSchema, CapabilityBindingsSchema, CarbonMonoxideStatusSchema, ChargingStatus, ClientNetworkStatsSchema, ClimateControlStatusSchema, ClipPlaybackSchema, ClipSchema, ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, CollectionColumnSchema, CollectionIndexSchema, ColorStatusSchema, ConfigEntrySchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, ConnectivityStatusSchema, ConsumableItemSchema, ConsumablesStatusSchema, ContactStatusSchema, ControlKindSchema, ControlStatusSchema, ConvertArtifactSchema, ConvertResultSchema, ConvertTargetSchema, CoverStateSchema, CoverStatusSchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateIntegrationInputSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, CustomActionInputSchema, CustomModelDescriptorSchema, DATAPLANE_SECRET_HEADER, DEFAULT_ADDON_PLACEMENT, DEFAULT_AUDIO_ANALYZER_CONFIG, DEFAULT_DECODER_HWACCEL_CONFIG, DEFAULT_FEATURES, DEFAULT_RETENTION, DEVICE_CAP_NAMES, DEVICE_PROFILES, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DEVICE_TYPE_INFO, DayNightModeSchema, DayNightOptionsSchema, DayNightSettingsPatchSchema, DayNightStatusSchema, DecodedAudioChunkSchema, DecodedFrameSchema, DecoderSessionConfigSchema, DecoderStatsSchema, DeleteIntegrationResultSchema, DetectionSourceSchema, DeviceCodeSeveritySchema, DeviceConfig, DeviceDiscoveryStatusSchema, ExposeInputSchema as DeviceExportExposeInputSchema, DeviceExportStatusSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, DeviceFeature, DeviceInfoSchema, DeviceNetworkStatsSchema, DeviceRole, DeviceRuntimeState, DeviceStatusSchema, DeviceType, DiscoveredChildDeviceSchema, DiscoveredChildStatusSchema, DiscoveredDeviceSchema, DiscoveredTargetSchema, DisposerChain, DoorbellPressEventSchema, DoorbellStatusSchema, EVENT_PAD_MS, EXPRESSION_BUILTINS, EXPRESSION_BUILTIN_NAMES, EXPRESSION_COMPILE_CACHE_CAPACITY, EXPRESSION_IDENTIFIER_RE, EXPRESSION_INJECTED_NOW, ElementConfigStore, EmbeddingInfoSchema, EmbeddingResultSchema, EncodeProfileSchema, EncodedPacketSchema, EnrichedWidgetMetadataSchema, EnumSensorDateTimeFormatSchema, EnumSensorStatusSchema, EventCategory, EventEmitterStatusSchema, EventFireSchema, EventItemSchema, EventKindSchema, EventSourceType, ExportSetupFieldSchema, ExportSetupSchema, ExposedDeviceSchema, ExposureModeSchema, ExpressionEvalError, ExpressionParseError, FanControlStatusSchema, FanDirectionSchema, FeatureManifestSchema, FeatureProbeStatusSchema, FloodStatusSchema, FrameHandleFormatSchema, FrameHandleSchema, FrameInputSchema, GasStatusSchema, GetStreamWithCodecInputSchema, GlobalMetricsSchema, HF_BASE_URL, HF_REPO, HWACCEL_OPTIONS, HealthStatusSchema, HistoryPointSchema, HistoryResolutionEnum, HumidifierStatusSchema, HumiditySensorStatusSchema, HvacModeSchema, ImageRotateSchema, ImageSettingsOptionsSchema, ImageSettingsPatchSchema, ImageSettingsStatusSchema, ImageStatusSchema, IngestOwnerSchema, InstalledPackageSchema, IntegrationLiteSchema, IntegrationWithStateSchema, IntercomAbilitySchema, IntercomStatusSchema, KNOWN_CAP_NAMES, LabelDefinitionSchema, LawnMowerActivitySchema, LawnMowerControlStatusSchema, LocateSegmentResultSchema, LocationStatSchema, LockControlStatusSchema, LockStateSchema, LogEntrySchema, LogLevelSchema, LogStreamEntrySchema, LoginMethodContributionSchema, LoginStageEnum, MACRO_LABELS, MAX_EXPRESSION_AST_NODES, MAX_EXPRESSION_BINDINGS, MAX_EXPRESSION_CALL_ARGS, MAX_EXPRESSION_EVAL_STEPS, MAX_EXPRESSION_SOURCE_LENGTH, METHOD_ACCESS_MAP, MODEL_FORMATS, MaskGridDimsSchema, MaskGridShapeSchema, MaskLineShapeSchema, MaskPointSchema, MaskPolygonShapeSchema, MaskPolygonVerticesSchema, MaskRectShapeSchema, MaskShapeKindSchema, MaskShapeSchema, MediaFileSchema, MediaPlayerRepeatSchema, MediaPlayerStateSchema, MediaPlayerStatusSchema, MeshPeerSchema, MeshStatusSchema, MethodAccessSchema, ModelCatalogEntrySchema, ModelConvertInputSchema, ModelConvertMetadataSchema, ModelDistributeInputSchema, ModelDistributeResultSchema, ModelExtraFileSchema, ModelFormatEntrySchema, ModelFormatsSchema, ModelSubstitutionSchema, ModelVariantGroupSchema, MotionAnalysisResultSchema, MotionEventSchema, MotionOnMotionChangedDataSchema, MotionRegionSchema, MotionSourceEnum, MotionSourcesSchema, MotionStatusSchema, MotionTriggerRuntimeStateSchema, MotionTriggerStatusSchema, MotionZoneOptionsSchema, MotionZonePatchSchema, MotionZoneRegionSchema, MotionZoneStatusSchema, StatusSchema as MqttBrokerStatusSchema, NativeDetectionSchema, NativeObjectClassEnum, NativeObjectDetectionRuntimeStateSchema, NativeObjectDetectionStatusSchema, NetworkAccessStatusSchema, NetworkAddressSchema, NetworkEndpointSchema, NotificationActionSchema, NotificationFormatSchema, NotificationHistoryEntrySchema, NotificationRuleSchema, NotificationSchema, NotifierStatusSchema, NumericSensorStatusSchema, OauthIntegrationDescriptorSchema, ObjectEventSchema, OrchestratorMetricsSchema, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, OsdPositionEnum, OsdStatusSchema, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, PIPELINE_FLOW_CAPABILITY_NAMES, PIPELINE_OWNER_CAPABILITY_NAMES, PROVIDER_KIND_CAP_NAMES, PYTHON_SCRIPT, PackageUpdateSchema, PackageVersionInfoSchema, PasskeySummarySchema, PcmSampleFormatSchema, PerScopeBreakdownSchema, PetFeederStatusSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, PickedCamStreamSchema, PipelineAssignmentSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, PlaceholderReasonSchema, PolygonPointSchema, PowerMeterStatusSchema, PresenceStatusSchema, PressureSensorStatusSchema, PrivacyMaskOptionsSchema, PrivacyMaskPatchSchema, PrivacyMaskRegionSchema, PrivacyMaskShapeSchema, PrivacyMaskStatusSchema, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, ProviderStatusSchema, PtzAutotrackRuntimeStateSchema, PtzAutotrackSettingsSchema, PtzAutotrackStatusSchema, PtzAutotrackTargetOptionSchema, PtzMoveCommandSchema, PtzPositionSchema, PtzPresetSchema, PtzStatusSchema, QueryFilterSchema, REACHABILITY_FAILURES_TO_OFFLINE, REACHABILITY_POLL_INTERVAL_MS, REACHABILITY_PROBE_TIMEOUT_MS, RECOGNITION_TYPES, RESERVED_BINDING_NAMES, RUNTIME_DEFAULTS, RUNTIME_TO_FORMAT, RawStateResultSchema, ReadSegmentBytesResultSchema, ReadinessRegistry, ReadinessTimeoutError, RecordingAvailabilitySchema, RecordingBandModeSchema, RecordingBandSchema, RecordingBandTriggersSchema, RecordingConfigSchema, RecordingDaysSchema, RecordingDeviceUsageSchema, RecordingLocationUsageSchema, RecordingManifestSchema, RecordingModeSchema, RecordingRangeSchema, RecordingRetentionSchema, RecordingRuleSchema, RecordingScheduleSchema, RecordingStatusSchema, RecordingStorageModeSchema, RecordingStorageUsageSchema, RecordingTriggersSchema, RecordingWeekdaySchema, RedirectLoginMethodSchema, RenderedAsSchema, ReportMotionInputSchema, RingBuffer, RtpSourceSchema, RtspRestreamEntrySchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, SCOPE_PRESETS, SOURCE_INFO_METADATA_KEY, STREAM_PROFILE_META, STREAM_QUALITY_LABELS, SUB_DETECTION_TYPES, SYSTEM_CAP_NAMES, ScopedTokenSchema, ScopedTokenSummarySchema, ScoredObjectEventSchema, ScriptRunnerStatusSchema, SearchResultSchema, SendEmailInputSchema, SendEmailResultSchema, SendResultSchema, ServerBootModeSchema, ServerPackageStatusSchema, ServerRollbackInfoSchema, ServerUpdateActionResultSchema, ServerUpdateCheckResultSchema, ServerUpdateStateSchema, SettingsPatchSchema, SettingsRecordSchema, SettingsSchemaWithValuesSchema, SettingsUpdateResultSchema, ShmRingStatsSchema, SmokeStatusSchema, SmtpStatusSchema, SnapshotImageSchema, SourceInfoSchema, SpatialDetectionSchema, SsoBridgeClaimsSchema, StartEmbeddedInputSchema, AbortUploadInputSchema as StorageAbortUploadInputSchema, BeginDownloadInputSchema as StorageBeginDownloadInputSchema, BeginDownloadResultSchema as StorageBeginDownloadResultSchema, BeginUploadInputSchema as StorageBeginUploadInputSchema, BeginUploadResultSchema as StorageBeginUploadResultSchema, EndDownloadInputSchema as StorageEndDownloadInputSchema, FinalizeUploadInputSchema as StorageFinalizeUploadInputSchema, StorageLocationDeclarationSchema, StorageLocationRefSchema, StorageLocationSchema, StorageLocationTypeSchema, ProviderInfoSchema as StorageProviderInfoSchema, ReadChunkInputSchema as StorageReadChunkInputSchema, TestLocationResultSchema as StorageTestLocationResultSchema, WriteChunkInputSchema as StorageWriteChunkInputSchema, StreamCodecSchema, StreamFormatSchema, StreamNetworkStatsSchema, StreamParamsOptionsSchema, StreamParamsStatusSchema, StreamProfileConfigSchema, StreamProfileOptionsSchema, StreamProfilePatchSchema, StreamProfileSchema, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, SwitchStatusSchema, SystemMetricsSchema, SystemMirror, TIMEZONES, TamperStatusSchema, TankStatusSchema, TargetKindCapsSchema, TargetKindLevelSchema, TargetKindSchema, TargetSchema, TemperatureSensorStatusSchema, TestConnectionResultSchema$1 as TestConnectionResultSchema, TestResultSchema, ToastSchema, TokenScopeSchema, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, TrackSchema, TrackStateSchema, TrackedDetectionSchema, TurnServerSchema, UNIT_TABLE, BrokerInfoSchema$1 as UnifiedBrokerInfoSchema, UnitConversionError, UpdateIntegrationInputSchema, UpdateStatusSchema, UpdateUserInputSchema, UserRecordSchema, UserSummarySchema, VacuumControlStatusSchema, VacuumStateSchema, ValveStateSchema, ValveStatusSchema, VibrationStatusSchema, VideoEncodeSchema, WELL_KNOWN_TABS, WELL_KNOWN_TAB_MAP, WaterHeaterStatusSchema, WeatherStatusSchema, WebrtcStreamChoiceSchema, WebrtcStreamTargetSchema, WhiteBalanceModeSchema, WidgetHostEnum, WidgetLoginMethodSchema, WidgetMetadataSchema, WidgetRemoteSchema, WidgetSizeEnum, YAMNET_TO_MACRO, ZoneKindEnum, ZoneRuleModeEnum, ZoneRuleSchema, ZoneRuleStageEnum, ZoneRulesArraySchema, ZoneSchema, ZoneScopeBreakdownSchema, accessoriesCapability, accessoryStableId, addonPagesCapability, addonPagesSourceCapability, addonRoutesCapability, addonSettingsCapability, addonWidgetsCapability, addonWidgetsSourceCapability, addonsCapability, adminUiCapability, advancedNotifierCapability, airQualitySensorCapability, alarmPanelCapability, alertsCapability, ambientLightSensorCapability, applyTransform, asBoolean, asJsonArray, asJsonObject, asNumber, asString, audioAnalysisCapability, audioAnalyzerCapability, audioCodecCapability, audioMetricsCapability, authProviderCapability, autoAssignProfiles, automationControlCapability, backupCapability, batteryCapability, bestLocationMatch, binaryCapability, bindAddonActions, brightnessCapability, brokerCapability, buildAddonRouteProvider, buildModelVariantGroups, buildStreamParamsConfigSchema, buttonCapability, cameraCredentialsCapability, cameraPipelineConfigCapability, cameraStreamsCapability, canConvertUnit, carbonMonoxideCapability, cellsToRects, classifyStream, classifyStreams, climateControlCapability, collectHydratedFieldEntries, collectHydratedFieldValues, colorCapability, compileExpression, compileExpressionSafe, connectivityCapability, consumablesCapability, contactCapability, controlCapability, convertUnit, cosineSimilarity, coverCapability, createDeviceProxy, createDurableState, createEvent, createExpressionScope, createLazyTrpcSource, createMirrorSource, createRuntimeStateBridge, createSliceHandle, createSystemProxy, customAction, customModelRegistryCapability, dayNightCapability, decoderCapability, defaultDeviceFor, defineCustomActions, describeModelVariant, detectionPipelineCapability, deviceAdoptionCapability, deviceCustomAction, deviceDiscoveryCapability, deviceExportCapability, deviceManagerCapability, deviceMatchesProfile, deviceOpsCapability, deviceProviderCapability, deviceStateCapability, deviceStatusCapability, doorbellCapability, embeddingEncoderCapability, emitDownForOwnedCaps, emitReadiness, encodeProfileFromStreamShape, enumSensorCapability, enumerateItemArrayFields, enumerateSchemaFields, errMsg, evaluateAst, evaluateLinkExpression, evaluateZoneRules, event, eventEmitterCapability, eventsCapability, expandCapMethods, extractSourceInfoFromMetadata, faceGalleryCapability, fanControlCapability, featureProbeCapability, filesystemBrowseCapability, findTimezone, floodCapability, formatForBackend, formatForRuntime, frameworkSwapConfirmSchema, frameworkSwapPackageSchema, gasCapability, getAudioMacroClassIds, getByPath, getCapsByProviderKind, hfModelUrl, htmlToText, humidifierCapability, humiditySensorCapability, hydrateSchema, imageCapability, imageSettingsCapability, integrationsCapability, intercomCapability, isAgentOnlyPlacement, isArrayOutputSchema, isDeployableToAgent, isDeviceConfigCap, isEvent, isObjectInput, isVoidInput, jobKindSchema, kebabToCamel, lawnMowerControlCapability, lifecycleJobSchema, lifecycleJobScopeSchema, lifecycleJobStateSchema, lifecycleTaskSchema, localNetworkCapability, locationSimilarity, lockControlCapability, logDestinationCapability, loginMethodCapability, looseSchema, makeProfileBrokerId, makeSourceBrokerId, mapAudioLabelToMacro, markdownToHtmlLite, markdownToText, maskUrlCredentials, mediaPlayerCapability, mergeSourceInfo, meshNetworkCapability, method, metricsProviderCapability, migrateConfigToBands, modelConvertCapability, modelDistributorCapability, modelFormatForRuntime, motionCapability, motionDetectionCapability, motionTriggerCapability, motionZonesCapability, mqttBrokerCapability, nativeObjectDetectionCapability, networkAccessCapability, networkQualityCapability, nodePin, nodesCapability, normalizeAddonInitResult, normalizeUnit, notificationOutputCapability, notifierCapability, numericSensorCapability, oauthIntegrationCapability, osdCapability, parseCameraStreamConfig, parseExpression, parseJsonArray, parseJsonObject, parseJsonUnknown, parseProfileBrokerId, parseStreamParamsFormPatch, pendingFrameworkSwapSchema, petFeederCapability, pickPreferredRtspEntry, pipelineAnalyticsCapability, pipelineExecutorCapability, pipelineOrchestratorCapability, pipelineRunnerCapability, plateGalleryCapability, platformProbeCapability, powerMeterCapability, prepareNotification, presenceCapability, pressureSensorCapability, privacyMaskCapability, procedureAuthKey, ptzAutotrackCapability, ptzCapability, pythonScriptForBackend, readNodePin, readinessKey, rebootCapability, recordingCapability, rectsToCells, requiresPython, resolveAddonExecution, resolveAddonGroup, resolveAddonPlacement, resolveAddonRuntime, resolveCapMount, resolveDetectionRuntime, resolveDeviceProfile, resolveFormat, resolveHydratedFieldValue, resolveModelFormat, resolveRunnerId, resolveVariantModelId, runInferenceStep, runtimeDevices, scopeKey, scoreRuntimes, scriptRunnerCapability, selectAssignedProfileSlots, serverManagementCapability, setByPath, settingsStoreCapability, sleep, sleepCancellable, smokeCapability, smtpProviderCapability, snapshotCapability, ssoBridgeCapability, startReachabilityPoll, storageCapability, storageEvictableCapability, storageProviderCapability, streamBrokerCapability, streamCatalogCapability, streamParamsCapability, streamPixels, streamQualityLabel, supportedRuntimes, switchCapability, synthesizeSourceInfo, systemCapability, tamperCapability, taskLogEntrySchema, taskPhaseSchema, taskTargetSchema, temperatureSensorCapability, textToHtml, toDeviceSummary, toExpressionValue, toStreamSourceEntry, toastCapability, tokenize, transcodeBody, tryConvertUnit, turnProviderCapability, unitDimension, unitsForDimension, updateCapability, userManagementCapability, userPasskeysCapability, vacuumControlCapability, validateExpressionSource, valveCapability, vibrationCapability, videoclipsCapability, viewerUiCapability, waterHeaterCapability, weatherCapability, webrtcClientHintsSchema, webrtcSessionCapability, wiringAddonHealthSchema, wiringHealthSnapshotSchema, wiringNodeHealthSchema, wiringProbeKindSchema, wiringProbeResultSchema, zodEntriesToConfigUI, zoneAnalyticsCapability, zoneRulesCapability, zonesCapability };
+export { ACCESSORY_LABEL, ALL_CAPABILITY_DEFINITIONS, APPLE_SA_TO_MACRO, AUDIO_BACKEND_CHOICES, AUDIO_MACRO_LABELS, AccessoriesStatusSchema, AccessoryKind, AddBrokerInputSchema, AddonAutoUpdateSchema, AddonListItemSchema, AddonPageDeclarationSchema, AddonPageInfoSchema, AdoptInputSchema as AdoptionAdoptInputSchema, AdoptResultSchema as AdoptionAdoptResultSchema, AdoptionFilterSchema, GetCandidateInputSchema as AdoptionGetCandidateInputSchema, ListCandidatesInputSchema as AdoptionListCandidatesInputSchema, ListCandidatesOutputSchema as AdoptionListCandidatesOutputSchema, ReleaseInputSchema as AdoptionReleaseInputSchema, AdoptionStatusSchema, AgentLoadSummarySchema, AirQualitySensorStatusSchema, AlarmArmModeSchema, AlarmPanelStatusSchema, AlarmStateSchema, AlertSchema, AlertSeveritySchema, AlertSourceSchema, AlertStatusSchema, AmbientLightSensorStatusSchema, ApiKeyRecordSchema, ApiKeySummarySchema, ArchiveEntrySchema, ArchiveManifestSchema, AttachmentMediaTypeSchema, AttachmentSchema, AudioAnalysisResultSchema, AudioAnalysisSettingsSchema, AudioChunkInputSchema, AudioClassSummarySchema, AudioClassificationLabelSchema, AudioClassificationResultSchema, AudioCodecInfoSchema, AudioDecodeSessionConfigSchema, AudioEncodeSchema, AudioEncodeSessionConfigSchema, AudioEncodedChunkSchema, AudioEventSchema, AudioLevelSchema, AudioMetricsHistoryPointSchema, AudioMetricsHistorySchema, AudioMetricsSnapshotSchema, AudioPcmChunkSchema, AuthResultSchema, AutoUpdateSettingsSchema, AutomationControlStatusSchema, AvailableIntegrationTypeSchema, BACKEND_TO_FORMAT, BATTERY_DEVICE_PROFILE, BacklightModeSchema, BackupDestinationInfoSchema, BackupEntrySchema, BaseAddon, BaseDevice, BaseDeviceProvider, BatteryStatusSchema, BinaryStatusSchema, BoundingBoxSchema, BrightnessStatusSchema, AddInputSchema as BrokerAddInputSchema, BrokerAudioClientSchema, BrokerClientsSchema, BrokerConnectionDetailsSchema, BrokerConsumerAttributionSchema, BrokerConsumerKindSchema, BrokerDecodedClientSchema, BrokerEncodedClientSchema, GetStateInputSchema as BrokerGetStateInputSchema, BrokerInfoSchema, BrokerProviderInfoSchema, PublishInputSchema as BrokerPublishInputSchema, RegistryStatusSchema as BrokerRegistryStatusSchema, BrokerRtspClientSchema, BrokerStatsSchema, BrokerStatusEnum, BrokerStatusSchema, SubscribeInputSchema as BrokerSubscribeInputSchema, SubscribeResultSchema as BrokerSubscribeResultSchema, TestConnectionResultSchema as BrokerTestConnectionResultSchema, UnsubscribeInputSchema as BrokerUnsubscribeInputSchema, CAM_PROFILE_ORDER, CAPABILITY_NAMES, CAPABILITY_ROUTER_KEYS, CAP_NAMES_WITH_STATUS, CAP_NODE_PIN_CONTEXT_KEY, CAP_PROVIDER_KIND_MAP, COCO_80_LABELS, COCO_TO_MACRO, CamProfileSchema, CamStreamDescriptorSchema, CamStreamKindSchema, CamStreamResolutionSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraCredentialsSchema, CameraCredentialsStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMetricsSchema, CameraMetricsWithDeviceIdSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusSchema, CameraStreamSchema, CandidateQueryFilterSchema, CapScopeSchema, CapabilityBindingsSchema, CarbonMonoxideStatusSchema, ChargingStatus, ClientNetworkStatsSchema, ClimateControlStatusSchema, ClipPlaybackSchema, ClipSchema, ClusterAddonNodeDeploymentSchema, ClusterAddonStatusEntrySchema, CollectionColumnSchema, CollectionIndexSchema, ColorStatusSchema, ConfigEntrySchema, ConfigSectionWithValuesSchema, ConfigTabDeclarationSchema, ConnectivityStatusSchema, ConsumableItemSchema, ConsumablesStatusSchema, ContactStatusSchema, ControlKindSchema, ControlStatusSchema, ConvertArtifactSchema, ConvertResultSchema, ConvertTargetSchema, CoverStateSchema, CoverStatusSchema, CreateApiKeyInputSchema, CreateApiKeyResultSchema, CreateIntegrationInputSchema, CreateScopedTokenInputSchema, CreateScopedTokenResultSchema, CreateUserInputSchema, CustomActionInputSchema, CustomModelDescriptorSchema, DATAPLANE_SECRET_HEADER, DEFAULT_ADDON_PLACEMENT, DEFAULT_AUDIO_ANALYZER_CONFIG, DEFAULT_DECODER_HWACCEL_CONFIG, DEFAULT_FEATURES, DEFAULT_RETENTION, DEVICE_CAP_NAMES, DEVICE_PROFILES, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, DEVICE_TYPE_INFO, DayNightModeSchema, DayNightOptionsSchema, DayNightSettingsPatchSchema, DayNightStatusSchema, DecodedAudioChunkSchema, DecodedFrameSchema, DecoderSessionConfigSchema, DecoderStatsSchema, DeleteIntegrationResultSchema, DetectionSourceSchema, DeviceCodeSeveritySchema, DeviceConfig, DeviceDiscoveryStatusSchema, ExposeInputSchema as DeviceExportExposeInputSchema, DeviceExportStatusSchema, UnexposeInputSchema as DeviceExportUnexposeInputSchema, DeviceFeature, DeviceInfoSchema, DeviceNetworkStatsSchema, DeviceRole, DeviceRuntimeState, DeviceStatusSchema, DeviceType, DiscoveredChildDeviceSchema, DiscoveredChildStatusSchema, DiscoveredDeviceSchema, DiscoveredTargetSchema, DisposerChain, DoorbellPressEventSchema, DoorbellStatusSchema, EVENT_PAD_MS, EXPRESSION_BUILTINS, EXPRESSION_BUILTIN_NAMES, EXPRESSION_COMPILE_CACHE_CAPACITY, EXPRESSION_IDENTIFIER_RE, EXPRESSION_INJECTED_NOW, ElementConfigStore, EmbeddingInfoSchema, EmbeddingResultSchema, EncodeProfileSchema, EncodedPacketSchema, EnrichedWidgetMetadataSchema, EnumSensorDateTimeFormatSchema, EnumSensorStatusSchema, EventCategory, EventEmitterStatusSchema, EventFireSchema, EventItemSchema, EventKindSchema, EventSourceType, ExportSetupFieldSchema, ExportSetupSchema, ExposedDeviceSchema, ExposureModeSchema, ExpressionEvalError, ExpressionParseError, FanControlStatusSchema, FanDirectionSchema, FeatureManifestSchema, FeatureProbeStatusSchema, FloodStatusSchema, FrameHandleFormatSchema, FrameHandleSchema, FrameInputSchema, GasStatusSchema, GetStreamWithCodecInputSchema, GlobalMetricsSchema, HF_BASE_URL, HF_REPO, HWACCEL_OPTIONS, HealthStatusSchema, HistoryPointSchema, HistoryResolutionEnum, HumidifierStatusSchema, HumiditySensorStatusSchema, HvacModeSchema, ImageRotateSchema, ImageSettingsOptionsSchema, ImageSettingsPatchSchema, ImageSettingsStatusSchema, ImageStatusSchema, IngestOwnerSchema, InstalledPackageSchema, IntegrationLiteSchema, IntegrationWithStateSchema, IntercomAbilitySchema, IntercomStatusSchema, KNOWN_CAP_NAMES, KeyEventSchema, LabelDefinitionSchema, LawnMowerActivitySchema, LawnMowerControlStatusSchema, LocateSegmentResultSchema, LocationStatSchema, LockControlStatusSchema, LockStateSchema, LogEntrySchema, LogLevelSchema, LogStreamEntrySchema, LoginMethodContributionSchema, LoginStageEnum, MACRO_LABELS, MAX_EXPRESSION_AST_NODES, MAX_EXPRESSION_BINDINGS, MAX_EXPRESSION_CALL_ARGS, MAX_EXPRESSION_EVAL_STEPS, MAX_EXPRESSION_SOURCE_LENGTH, METHOD_ACCESS_MAP, MODEL_FORMATS, MaskGridDimsSchema, MaskGridShapeSchema, MaskLineShapeSchema, MaskPointSchema, MaskPolygonShapeSchema, MaskPolygonVerticesSchema, MaskRectShapeSchema, MaskShapeKindSchema, MaskShapeSchema, MediaFileSchema, MediaPlayerRepeatSchema, MediaPlayerStateSchema, MediaPlayerStatusSchema, MeshPeerSchema, MeshStatusSchema, MethodAccessSchema, ModelCatalogEntrySchema, ModelConvertInputSchema, ModelConvertMetadataSchema, ModelDistributeInputSchema, ModelDistributeResultSchema, ModelExtraFileSchema, ModelFormatEntrySchema, ModelFormatsSchema, ModelSubstitutionSchema, ModelVariantGroupSchema, MotionAnalysisResultSchema, MotionEventSchema, MotionOnMotionChangedDataSchema, MotionRegionSchema, MotionSourceEnum, MotionSourcesSchema, MotionStatusSchema, MotionTriggerRuntimeStateSchema, MotionTriggerStatusSchema, MotionZoneOptionsSchema, MotionZonePatchSchema, MotionZoneRegionSchema, MotionZoneStatusSchema, StatusSchema as MqttBrokerStatusSchema, NativeDetectionSchema, NativeObjectClassEnum, NativeObjectDetectionRuntimeStateSchema, NativeObjectDetectionStatusSchema, NetworkAccessStatusSchema, NetworkAddressSchema, NetworkEndpointSchema, NotificationActionSchema, NotificationFormatSchema, NotificationHistoryEntrySchema, NotificationRuleSchema, NotificationSchema, NotifierStatusSchema, NumericSensorStatusSchema, OauthIntegrationDescriptorSchema, ObjectEventSchema, OrchestratorMetricsSchema, OsdOverlayKindEnum, OsdOverlayPatchSchema, OsdOverlaySchema, OsdPositionEnum, OsdStatusSchema, PET_FEEDER_MANUAL_FEED_MAX, PET_FEEDER_MANUAL_FEED_MIN, PIPELINE_FLOW_CAPABILITY_NAMES, PIPELINE_OWNER_CAPABILITY_NAMES, PROVIDER_KIND_CAP_NAMES, PYTHON_SCRIPT, PackageUpdateSchema, PackageVersionInfoSchema, PasskeySummarySchema, PcmSampleFormatSchema, PerScopeBreakdownSchema, PetFeederStatusSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, PickedCamStreamSchema, PipelineAssignmentSchema, PipelineDefaultStepSchema, PipelineEngineChoiceSchema, PipelineRunResultBridge, PipelineStepInputSchema, PipelineValidationIssueSchema, PipelineValidationResultSchema, PlaceholderReasonSchema, PolygonPointSchema, PowerMeterStatusSchema, PresenceStatusSchema, PressureSensorStatusSchema, PrivacyMaskOptionsSchema, PrivacyMaskPatchSchema, PrivacyMaskRegionSchema, PrivacyMaskShapeSchema, PrivacyMaskStatusSchema, ProfileRtspEntrySchema, ProfileSlotSchema, ProfileSlotStatusSchema, ProviderStatusSchema, PtzAutotrackRuntimeStateSchema, PtzAutotrackSettingsSchema, PtzAutotrackStatusSchema, PtzAutotrackTargetOptionSchema, PtzMoveCommandSchema, PtzPositionSchema, PtzPresetSchema, PtzStatusSchema, QueryFilterSchema, REACHABILITY_FAILURES_TO_OFFLINE, REACHABILITY_POLL_INTERVAL_MS, REACHABILITY_PROBE_TIMEOUT_MS, RECOGNITION_TYPES, RESERVED_BINDING_NAMES, RUNTIME_DEFAULTS, RUNTIME_TO_FORMAT, RawStateResultSchema, ReadSegmentBytesResultSchema, ReadinessRegistry, ReadinessTimeoutError, RecordingAvailabilitySchema, RecordingBandModeSchema, RecordingBandSchema, RecordingBandTriggersSchema, RecordingConfigSchema, RecordingDaysSchema, RecordingDeviceUsageSchema, RecordingLocationUsageSchema, RecordingManifestSchema, RecordingModeSchema, RecordingRangeSchema, RecordingRetentionSchema, RecordingRuleSchema, RecordingScheduleSchema, RecordingStatusSchema, RecordingStorageModeSchema, RecordingStorageUsageSchema, RecordingTriggersSchema, RecordingWeekdaySchema, RedirectLoginMethodSchema, RenderedAsSchema, ReportMotionInputSchema, RingBuffer, RtpSourceSchema, RtspRestreamEntrySchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, SCOPE_PRESETS, SOURCE_INFO_METADATA_KEY, STREAM_PROFILE_META, STREAM_QUALITY_LABELS, SUB_DETECTION_TYPES, SYSTEM_CAP_NAMES, ScopedTokenSchema, ScopedTokenSummarySchema, ScoredObjectEventSchema, ScriptRunnerStatusSchema, SearchResultSchema, SendEmailInputSchema, SendEmailResultSchema, SendResultSchema, ServerBootModeSchema, ServerPackageStatusSchema, ServerRollbackInfoSchema, ServerUpdateActionResultSchema, ServerUpdateCheckResultSchema, ServerUpdateStateSchema, SettingsPatchSchema, SettingsRecordSchema, SettingsSchemaWithValuesSchema, SettingsUpdateResultSchema, ShmRingStatsSchema, SmokeStatusSchema, SmtpStatusSchema, SnapshotImageSchema, SourceInfoSchema, SpatialDetectionSchema, SsoBridgeClaimsSchema, StartEmbeddedInputSchema, AbortUploadInputSchema as StorageAbortUploadInputSchema, BeginDownloadInputSchema as StorageBeginDownloadInputSchema, BeginDownloadResultSchema as StorageBeginDownloadResultSchema, BeginUploadInputSchema as StorageBeginUploadInputSchema, BeginUploadResultSchema as StorageBeginUploadResultSchema, EndDownloadInputSchema as StorageEndDownloadInputSchema, FinalizeUploadInputSchema as StorageFinalizeUploadInputSchema, StorageLocationDeclarationSchema, StorageLocationRefSchema, StorageLocationSchema, StorageLocationTypeSchema, ProviderInfoSchema as StorageProviderInfoSchema, ReadChunkInputSchema as StorageReadChunkInputSchema, TestLocationResultSchema as StorageTestLocationResultSchema, WriteChunkInputSchema as StorageWriteChunkInputSchema, StreamCodecSchema, StreamFormatSchema, StreamNetworkStatsSchema, StreamParamsOptionsSchema, StreamParamsStatusSchema, StreamProfileConfigSchema, StreamProfileOptionsSchema, StreamProfilePatchSchema, StreamProfileSchema, StreamSourceEntrySchema, StreamSourceSchema, SubscribeAudioChunksInputSchema, SubscribeAudioChunksResultSchema, SubscribeFramesInputSchema, SubscribeFramesResultSchema, SwitchStatusSchema, SystemMetricsSchema, SystemMirror, TIMEZONES, TamperStatusSchema, TankStatusSchema, TargetKindCapsSchema, TargetKindLevelSchema, TargetKindSchema, TargetSchema, TemperatureSensorStatusSchema, TestConnectionResultSchema$1 as TestConnectionResultSchema, TestResultSchema, ToastSchema, TokenScopeSchema, TopologyNodeSchema, TopologyProcessSchema, TopologyServiceSchema, TrackSchema, TrackStateSchema, TrackedDetectionSchema, TurnServerSchema, UNIT_TABLE, BrokerInfoSchema$1 as UnifiedBrokerInfoSchema, UnitConversionError, UpdateIntegrationInputSchema, UpdateStatusSchema, UpdateUserInputSchema, UserRecordSchema, UserSummarySchema, VacuumControlStatusSchema, VacuumStateSchema, ValveStateSchema, ValveStatusSchema, VibrationStatusSchema, VideoEncodeSchema, WELL_KNOWN_TABS, WELL_KNOWN_TAB_MAP, WaterHeaterStatusSchema, WeatherStatusSchema, WebrtcStreamChoiceSchema, WebrtcStreamTargetSchema, WhiteBalanceModeSchema, WidgetHostEnum, WidgetLoginMethodSchema, WidgetMetadataSchema, WidgetRemoteSchema, WidgetSizeEnum, YAMNET_TO_MACRO, ZoneKindEnum, ZoneRuleModeEnum, ZoneRuleSchema, ZoneRuleStageEnum, ZoneRulesArraySchema, ZoneSchema, ZoneScopeBreakdownSchema, accessoriesCapability, accessoryStableId, addonPagesCapability, addonPagesSourceCapability, addonRoutesCapability, addonSettingsCapability, addonWidgetsCapability, addonWidgetsSourceCapability, addonsCapability, adminUiCapability, advancedNotifierCapability, airQualitySensorCapability, alarmPanelCapability, alertsCapability, ambientLightSensorCapability, applyTransform, asBoolean, asJsonArray, asJsonObject, asNumber, asString, audioAnalysisCapability, audioAnalyzerCapability, audioCodecCapability, audioMetricsCapability, authProviderCapability, autoAssignProfiles, automationControlCapability, backupCapability, batteryCapability, bestLocationMatch, binaryCapability, bindAddonActions, brightnessCapability, brokerCapability, buildAddonRouteProvider, buildModelVariantGroups, buildStreamParamsConfigSchema, buttonCapability, cameraCredentialsCapability, cameraPipelineConfigCapability, cameraStreamsCapability, canConvertUnit, carbonMonoxideCapability, cellsToRects, classifyStream, classifyStreams, climateControlCapability, collectHydratedFieldEntries, collectHydratedFieldValues, colorCapability, compileExpression, compileExpressionSafe, connectivityCapability, consumablesCapability, contactCapability, controlCapability, convertUnit, cosineSimilarity, coverCapability, createDeviceProxy, createDurableState, createEvent, createExpressionScope, createLazyTrpcSource, createMirrorSource, createRuntimeStateBridge, createSliceHandle, createSystemProxy, customAction, customModelRegistryCapability, dayNightCapability, decoderCapability, defaultDeviceFor, defineCustomActions, describeModelVariant, detectionPipelineCapability, deviceAdoptionCapability, deviceCustomAction, deviceDiscoveryCapability, deviceExportCapability, deviceManagerCapability, deviceMatchesProfile, deviceOpsCapability, deviceProviderCapability, deviceStateCapability, deviceStatusCapability, doorbellCapability, embeddingEncoderCapability, emitDownForOwnedCaps, emitReadiness, encodeProfileFromStreamShape, enumSensorCapability, enumerateItemArrayFields, enumerateSchemaFields, errMsg, evaluateAst, evaluateLinkExpression, evaluateZoneRules, event, eventEmitterCapability, eventsCapability, expandCapMethods, extractSourceInfoFromMetadata, faceGalleryCapability, fanControlCapability, featureProbeCapability, filesystemBrowseCapability, findTimezone, floodCapability, formatForBackend, formatForRuntime, frameworkSwapConfirmSchema, frameworkSwapPackageSchema, gasCapability, getAudioMacroClassIds, getByPath, getCapsByProviderKind, hfModelUrl, htmlToText, humidifierCapability, humiditySensorCapability, hydrateSchema, imageCapability, imageSettingsCapability, integrationsCapability, intercomCapability, isAgentOnlyPlacement, isArrayOutputSchema, isDeployableToAgent, isDeviceConfigCap, isEvent, isObjectInput, isVoidInput, jobKindSchema, kebabToCamel, lawnMowerControlCapability, lifecycleJobSchema, lifecycleJobScopeSchema, lifecycleJobStateSchema, lifecycleTaskSchema, localNetworkCapability, locationSimilarity, lockControlCapability, logDestinationCapability, loginMethodCapability, looseSchema, makeProfileBrokerId, makeSourceBrokerId, mapAudioLabelToMacro, markdownToHtmlLite, markdownToText, maskUrlCredentials, mediaPlayerCapability, mergeSourceInfo, meshNetworkCapability, method, metricsProviderCapability, migrateConfigToBands, modelConvertCapability, modelDistributorCapability, modelFormatForRuntime, motionCapability, motionDetectionCapability, motionTriggerCapability, motionZonesCapability, mqttBrokerCapability, nativeObjectDetectionCapability, networkAccessCapability, networkQualityCapability, nodePin, nodesCapability, normalizeAddonInitResult, normalizeUnit, notificationOutputCapability, notifierCapability, numericSensorCapability, oauthIntegrationCapability, osdCapability, parseCameraStreamConfig, parseExpression, parseJsonArray, parseJsonObject, parseJsonUnknown, parseProfileBrokerId, parseStreamParamsFormPatch, pendingFrameworkSwapSchema, petFeederCapability, pickPreferredRtspEntry, pipelineAnalyticsCapability, pipelineExecutorCapability, pipelineOrchestratorCapability, pipelineRunnerCapability, plateGalleryCapability, platformProbeCapability, powerMeterCapability, prepareNotification, presenceCapability, pressureSensorCapability, privacyMaskCapability, procedureAuthKey, ptzAutotrackCapability, ptzCapability, pythonScriptForBackend, readNodePin, readinessKey, rebootCapability, recordingCapability, rectsToCells, requiresPython, resolveAddonExecution, resolveAddonGroup, resolveAddonPlacement, resolveAddonRuntime, resolveCapMount, resolveDetectionRuntime, resolveDeviceProfile, resolveFormat, resolveHydratedFieldValue, resolveModelFormat, resolveRunnerId, resolveVariantModelId, runInferenceStep, runtimeDevices, scopeKey, scoreRuntimes, scriptRunnerCapability, selectAssignedProfileSlots, serverManagementCapability, setByPath, settingsStoreCapability, sleep, sleepCancellable, smokeCapability, smtpProviderCapability, snapshotCapability, ssoBridgeCapability, startReachabilityPoll, storageCapability, storageEvictableCapability, storageProviderCapability, streamBrokerCapability, streamCatalogCapability, streamParamsCapability, streamPixels, streamQualityLabel, supportedRuntimes, switchCapability, synthesizeSourceInfo, systemCapability, tamperCapability, taskLogEntrySchema, taskPhaseSchema, taskTargetSchema, temperatureSensorCapability, textToHtml, toDeviceSummary, toExpressionValue, toStreamSourceEntry, toastCapability, tokenize, transcodeBody, tryConvertUnit, turnProviderCapability, unitDimension, unitsForDimension, updateCapability, userManagementCapability, userPasskeysCapability, vacuumControlCapability, validateExpressionSource, valveCapability, vibrationCapability, videoclipsCapability, viewerUiCapability, waterHeaterCapability, weatherCapability, webrtcClientHintsSchema, webrtcSessionCapability, wiringAddonHealthSchema, wiringHealthSnapshotSchema, wiringNodeHealthSchema, wiringProbeKindSchema, wiringProbeResultSchema, zodEntriesToConfigUI, zoneAnalyticsCapability, zoneRulesCapability, zonesCapability };

package/dist/{sleep-b4Jf2n33.mjs → sleep-BC9Yqte7.mjs}

@@ -3408,6 +3408,7 @@ function createDeviceProxy(api, binding, opts) {
 			getMotionEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getMotionEvents", "query", input),
 			getObjectEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getObjectEvents", "query", input),
 			getAudioEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getAudioEvents", "query", input),
+			getKeyEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getKeyEvents", "query", input),
 			getEventDensity: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventDensity", "query", input),
 			pruneEventsBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEventsBefore", "mutation", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),

package/dist/{sleep-Dqd2OlRi.js → sleep-ByctZsHo.js}

@@ -3408,6 +3408,7 @@ function createDeviceProxy(api, binding, opts) {
 			getMotionEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getMotionEvents", "query", input),
 			getObjectEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getObjectEvents", "query", input),
 			getAudioEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getAudioEvents", "query", input),
+			getKeyEvents: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getKeyEvents", "query", input),
 			getEventDensity: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventDensity", "query", input),
 			pruneEventsBefore: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "pruneEventsBefore", "mutation", input),
 			getEventMedia: (input) => dispatch("pipeline-analytics", "pipelineAnalytics", "getEventMedia", "query", input),

package/dist/types/pipeline-step.d.ts

@@ -48,6 +48,22 @@ export interface StepDefinition {
      * rather than out).
      */
     readonly enabledByDefault?: boolean;
+    /**
+     * Opt-in: when `true`, this step is BACK-FILLED into a camera's stored
+     * wholesale pipeline override (`cameraSettings.pipelineByAgent`) at resolve
+     * time if it is absent from that snapshot — see
+     * `mergeEnabledByDefaultSteps`. Set this ONLY on a genuinely-NEW default
+     * step that shipped AFTER existing snapshots were captured and must reach
+     * them (e.g. `clip-embedding` for object semantic search).
+     *
+     * It exists because absence-from-a-snapshot is ambiguous: it can mean
+     * "predates this step" OR "operator deliberately pruned it". A broad
+     * "back-fill every default" would resurrect deliberate removals of
+     * long-existing steps (face-detection, etc.). This flag makes back-fill
+     * strictly opt-in so only a new step re-enters existing overrides; absent
+     * (the default) preserves operator intent verbatim. Absent = `false`.
+     */
+    readonly backfillIntoExistingOverrides?: boolean;
     /** Default confidence threshold */
     readonly defaultConfidence: number;
     /** Runtime label lookup (e.g., class name arrays for softmax, charset for CTC) */

package/package.json

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