@camstack/types 1.2.278 → 1.2.280

package/dist/capabilities/index.d.ts

@@ -88,8 +88,8 @@ export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthI
 export { AnalyticsLtsSeriesSchema, type AudioEvent, type AudioEventDraft, AudioEventSchema, type DetectionSource, DetectionSourceSchema, EVENT_DENSITY_BATCH_MAX, type EventDensityBucket, EventDensityBucketSchema, type EventDensityForDevice, EventDensityForDeviceSchema, type EventKind, type EventKindCategory, EventKindCategorySchema, type EventKindDescriptor, EventKindDescriptorSchema, type EventKindIcon, EventKindIconSchema, EventKindSchema, type EventKindsForDevice, EventKindsForDeviceSchema, type EventMediaKindBreakdown, type EventMediaKindFootprint, type EventPruneCounts, type EventStoreDeviceFootprint, type EventStoreFootprint, type IPipelineAnalyticsProvider, type KeyEvent, KeyEventSchema, type KeyEventsForDevice, type LabelAttribution, LabelAttributionSchema, type LabelTier, LabelTierSchema, LTS_SCOPE_CLASS_SEPARATOR, type LtsBucket, LtsBucketSchema, MAX_TRACK_DEBUG_NOTE_LEN, type MediaFile, type MediaFileBytes, type MediaFileInfo, MediaFileInfoSchema, type MediaFileKind, MediaFileKindEnum, type MediaFileRef, MediaFileRefSchema, MediaFileSchema, type MotionEvent, type MotionEventDraft, MotionEventSchema, type ObjectEvent, type ObjectEventDraft, ObjectEventSchema, occupancyScope, parseOccupancyScope, pipelineAnalyticsCapability, type RecentTracksPage, RecentTracksPageSchema, type RecentTracksQuery, RecentTracksQueryInput, type RetrainAnnotation, type RetrainAnnotationDraft, RetrainAnnotationDraftSchema, RetrainAnnotationKindSchema, RetrainAnnotationSchema, RetrainAnnotationSourceSchema, type RetrainAssistResult, RetrainAssistResultSchema, RetrainAssistSubjectSchema, RetrainCopyRefusalSchema, type RetrainFrame, type RetrainFrameCandidate, RetrainFrameCandidateSchema, type RetrainFrameList, RetrainFrameListSchema, RetrainFrameSchema, type RetrainFrameSelection, RetrainFrameSelectionSchema, type RetrainMacroClass, RetrainMacroClassSchema, type RetrainStatus, RetrainStatusSchema, type RetrainTrack, RetrainTrackSchema, type RetrainTransitionResult, RetrainTransitionResultSchema, type RebuildObjectEmbeddingsRefusal, RebuildObjectEmbeddingsRefusalSchema, type ScoredObjectEvent, ScoredObjectEventSchema, type SensorEvent, SensorEventSchema, type Track, type TrackCascadeCounts, TrackCascadeCountsSchema, type TrackEnvelope, TrackEnvelopeSchema, TrackedDetectionSchema, type TrackFlags, type TrackFlagsPatch, TrackFlagsPatchSchema, TrackFlagsSchema, type TrackProjection, TrackProjectionSchema, TrackSchema, type TrackSource, TrackSourceSchema, type TrackState, TrackStateSchema, type TrackZoneFilter, TrackZoneFilterSchema, type TrainingExportDeviceTotals, TrainingExportDeviceTotalsSchema, type TrainingExportSummary, TrainingExportSummarySchema, type ZoneCrossing, type ZoneCrossingDirection, ZoneCrossingDirectionSchema, ZoneCrossingSchema, } from './pipeline-analytics.cap.js';
 export type { EffectiveTuning, EffectiveTuningInput, NativeCropRef, PipelineStepInputOutput, PipelineValidationIssue, PipelineValidationResult, } from './pipeline-executor.cap.js';
 export { EffectiveTuningSchema, ModelSubstitutionSchema, NativeCropRefSchema, 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, CameraStatusDegradation, CameraStatusDegradationReason, CameraStatusStage, ClusterModelChoice, ClusterModelChoiceUnreadableReason, DiskReconcileJob, InferenceDeviceExclusionReason, IngestOwner, NodeInferenceDevice, NodeInferenceDevices, SetCameraSensorsInput, } from './pipeline-orchestrator.cap.js';
-export { AgentLoadSummarySchema, CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS, ClusterModelChoiceSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusDegradationReasonSchema, CameraStatusDegradationSchema, CameraStatusSchema, CameraStatusStageSchema, CapabilityBindingsSchema, DiskReconcileJobSchema, GlobalMetricsSchema, INFERENCE_DEVICE_EXCLUSION_REASONS, InferenceDeviceExclusionReasonSchema, IngestOwnerSchema, PipelineAssignmentSchema, pipelineOrchestratorCapability, SetCameraSensorsInputSchema, } from './pipeline-orchestrator.cap.js';
+export type { CameraAssignmentStatus, CameraAudioStatus, CameraBrokerProfile, CameraBrokerStatus, CameraDecoderShm, CameraDecoderStatus, CameraDetectionPhase, CameraDetectionProvisioning, CameraDetectionProvisioningState, CameraDetectionStatus, CameraMotionStatus, CameraRecordingMode, CameraRecordingStatus, CameraSourceStatus, CameraSourceStream, CameraStatus, CameraStatusDegradation, CameraStatusDegradationReason, CameraStatusStage, ClusterModelChoice, ClusterModelChoiceUnreadableReason, DiskReconcileJob, InferenceDeviceExclusionReason, IngestOwner, NodeInferenceDevice, NodeInferenceDevices, OccupancyLookAnswer, OccupancyLookRefusal, OccupancyLookRequest, SetCameraSensorsInput, } from './pipeline-orchestrator.cap.js';
+export { AgentLoadSummarySchema, CLUSTER_MODEL_CHOICE_UNREADABLE_REASONS, ClusterModelChoiceSchema, CameraAssignmentStatusSchema, CameraAudioStatusSchema, CameraBrokerProfileSchema, CameraBrokerStatusSchema, CameraDecoderShmSchema, CameraDecoderStatusSchema, CameraDetectionPhaseSchema, CameraDetectionProvisioningSchema, CameraDetectionProvisioningStateSchema, CameraDetectionStatusSchema, CameraMotionStatusSchema, CameraRecordingModeSchema, CameraRecordingStatusSchema, CameraSourceStatusSchema, CameraSourceStreamSchema, CameraStatusDegradationReasonSchema, CameraStatusDegradationSchema, CameraStatusSchema, CameraStatusStageSchema, CapabilityBindingsSchema, DiskReconcileJobSchema, GlobalMetricsSchema, INFERENCE_DEVICE_EXCLUSION_REASONS, InferenceDeviceExclusionReasonSchema, IngestOwnerSchema, OccupancyLookAnswerSchema, OccupancyLookRefusalSchema, OccupancyLookRequestSchema, PipelineAssignmentSchema, pipelineOrchestratorCapability, SetCameraSensorsInputSchema, } from './pipeline-orchestrator.cap.js';
 export type { DetailParent, DetailResult, MotionSource, MotionSources, OccupancyBurstRefusal, ParkedFrameKind, ParkedTrackFrame, ParkRefusal, ParkTrackFrameResult, ReportMotionInput, RunDetailSubtreeInput, RunDetailSubtreeResult, RunnerFrameSource, RunnerInferenceDevice, RunnerJumpStepProvisioning, RunStatelessStepInput, RunStatelessStepResult, StatelessStepRefusal, } from './pipeline-runner.cap.js';
 export { type DetectionSources, DetectionSourcesSchema, FrameLazyCountersSchema, FrameLazyMetricsSchema, MOTION_SOURCE_LABELS, MotionSourceEnum, MotionSourcesSchema, motionSourceLabel, type NativeCropBbox, NativeCropBboxSchema, NativeCropResultSchema, OccupancyBurstRefusalSchema, ParkedFrameKindSchema, ParkedTrackFrameSchema, ParkRefusalSchema, ParkTrackFrameResultSchema, pipelineRunnerCapability, ReportMotionInputSchema, RunnerCameraConfigSchema, RunnerCameraDeviceUIFields, RunnerFrameSourceSchema, RunnerInferenceDeviceSchema, RunnerJumpStepProvisioningSchema, RunnerLocalLoadSchema, RunnerLocalMetricsSchema, } from './pipeline-runner.cap.js';
 export { AUDIO_NOT_CLASSIFIED_REASONS, AudioChunkInputSchema, AudioClassificationLabelSchema, AudioClassifyOutcomeSchema, AudioLevelSchema, BoundingBoxSchema, FrameInputSchema, SpatialDetectionSchema, } from './schemas/detection-shared.js';

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

@@ -428,7 +428,7 @@ export type NcSensorTransition = z.infer<typeof NcSensorTransitionSchema>;
 /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
 export declare const NcZoneConditionSchema: z.ZodObject<{
     ids: z.ZodArray<z.ZodString>;
-    match: z.ZodDefault<z.ZodEnum<{
+    match: z.ZodOptional<z.ZodEnum<{
         any: "any";
         all: "all";
     }>>;
@@ -672,7 +672,7 @@ export declare const NcConditionsSchema: z.ZodObject<{
     minConfidence: z.ZodOptional<z.ZodNumber>;
     zones: z.ZodOptional<z.ZodObject<{
         ids: z.ZodArray<z.ZodString>;
-        match: z.ZodDefault<z.ZodEnum<{
+        match: z.ZodOptional<z.ZodEnum<{
             any: "any";
             all: "all";
         }>>;
@@ -1015,7 +1015,7 @@ export declare const NcRuleInputSchema: z.ZodObject<{
         minConfidence: z.ZodOptional<z.ZodNumber>;
         zones: z.ZodOptional<z.ZodObject<{
             ids: z.ZodArray<z.ZodString>;
-            match: z.ZodDefault<z.ZodEnum<{
+            match: z.ZodOptional<z.ZodEnum<{
                 any: "any";
                 all: "all";
             }>>;
@@ -1415,7 +1415,7 @@ export declare const NcRulePatchSchema: z.ZodObject<{
         minConfidence: z.ZodOptional<z.ZodNumber>;
         zones: z.ZodOptional<z.ZodObject<{
             ids: z.ZodArray<z.ZodString>;
-            match: z.ZodDefault<z.ZodEnum<{
+            match: z.ZodOptional<z.ZodEnum<{
                 any: "any";
                 all: "all";
             }>>;
@@ -1730,7 +1730,7 @@ export declare const NcRuleUpdateInputSchema: z.ZodObject<{
             minConfidence: z.ZodOptional<z.ZodNumber>;
             zones: z.ZodOptional<z.ZodObject<{
                 ids: z.ZodArray<z.ZodString>;
-                match: z.ZodDefault<z.ZodEnum<{
+                match: z.ZodOptional<z.ZodEnum<{
                     any: "any";
                     all: "all";
                 }>>;
@@ -1931,7 +1931,7 @@ export declare const NcRuleSchema: z.ZodObject<{
         minConfidence: z.ZodOptional<z.ZodNumber>;
         zones: z.ZodOptional<z.ZodObject<{
             ids: z.ZodArray<z.ZodString>;
-            match: z.ZodDefault<z.ZodEnum<{
+            match: z.ZodOptional<z.ZodEnum<{
                 any: "any";
                 all: "all";
             }>>;
@@ -3358,7 +3358,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -3655,7 +3655,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -3950,7 +3950,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -4239,7 +4239,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -4639,7 +4639,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -4838,7 +4838,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -5215,7 +5215,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -5529,7 +5529,7 @@ export declare const notificationRulesCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;

package/dist/capabilities/osd-manager.cap.d.ts

@@ -109,7 +109,7 @@ export declare const OsdSlotBindingSchema: z.ZodObject<{
         minConfidence: z.ZodOptional<z.ZodNumber>;
         zones: z.ZodOptional<z.ZodObject<{
             ids: z.ZodArray<z.ZodString>;
-            match: z.ZodDefault<z.ZodEnum<{
+            match: z.ZodOptional<z.ZodEnum<{
                 any: "any";
                 all: "all";
             }>>;
@@ -294,7 +294,7 @@ export declare const OsdSlotViewSchema: z.ZodObject<{
             minConfidence: z.ZodOptional<z.ZodNumber>;
             zones: z.ZodOptional<z.ZodObject<{
                 ids: z.ZodArray<z.ZodString>;
-                match: z.ZodDefault<z.ZodEnum<{
+                match: z.ZodOptional<z.ZodEnum<{
                     any: "any";
                     all: "all";
                 }>>;
@@ -551,7 +551,7 @@ export declare const osdManagerCapability: {
                         minConfidence: z.ZodOptional<z.ZodNumber>;
                         zones: z.ZodOptional<z.ZodObject<{
                             ids: z.ZodArray<z.ZodString>;
-                            match: z.ZodDefault<z.ZodEnum<{
+                            match: z.ZodOptional<z.ZodEnum<{
                                 any: "any";
                                 all: "all";
                             }>>;
@@ -827,7 +827,7 @@ export declare const osdManagerCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;
@@ -1011,7 +1011,7 @@ export declare const osdManagerCapability: {
                         minConfidence: z.ZodOptional<z.ZodNumber>;
                         zones: z.ZodOptional<z.ZodObject<{
                             ids: z.ZodArray<z.ZodString>;
-                            match: z.ZodDefault<z.ZodEnum<{
+                            match: z.ZodOptional<z.ZodEnum<{
                                 any: "any";
                                 all: "all";
                             }>>;
@@ -1227,7 +1227,7 @@ export declare const osdManagerCapability: {
                     minConfidence: z.ZodOptional<z.ZodNumber>;
                     zones: z.ZodOptional<z.ZodObject<{
                         ids: z.ZodArray<z.ZodString>;
-                        match: z.ZodDefault<z.ZodEnum<{
+                        match: z.ZodOptional<z.ZodEnum<{
                             any: "any";
                             all: "all";
                         }>>;

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

@@ -2890,6 +2890,11 @@ export declare const pipelineAnalyticsCapability: {
          *
          * Operator-driven from the DI Events page (batch delete). Routes through
          * the same widened track-deletion cascade (design §5.2).
+         *
+         * `sparedMediaIds` (D683 Task 14): media rows the cascade LEFT because a
+         * live stationary entry vouches for them (its key frame, owned by a track
+         * that moved and was kept). Released when the entry retires. Optional:
+         * absent from a provider that predates it.
          */
         readonly deleteTracks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -2897,6 +2902,7 @@ export declare const pipelineAnalyticsCapability: {
         }, z.core.$strip>, z.ZodObject<{
             deleted: z.ZodNumber;
             failed: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            sparedMediaIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>;
         }, z.core.$strip>, "mutation">;
         /**
          * Set the per-track operator flags (`markForTrain`, `debug`, `favourited`) on ONE track.

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

@@ -712,6 +712,45 @@ export declare const SetCameraSensorsInputSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type SetCameraSensorsInput = z.infer<typeof SetCameraSensorsInputSchema>;
+/**
+ * Why an early occupancy look (D691) was not scheduled.
+ *
+ * - `unknown-camera` — no session was ever dispatched for it, so there is no
+ *   node and no config to attach a burst with.
+ * - `out-of-range` — the ask is negative or further out than the orchestrator
+ *   will hold a timer for; the parked-object cadence is the answer there.
+ * - `no-burst-producer` — this build has no burst producer at all.
+ * - `already-looked` — this camera's ONE early look since its last session has
+ *   been spent. A look's own burst can re-arm a flickering flip, and a look
+ *   per arm would chain a burst every ~30 s forever (review H2); the next
+ *   real session re-arms the budget.
+ */
+export declare const OccupancyLookRefusalSchema: z.ZodEnum<{
+    "unknown-camera": "unknown-camera";
+    "out-of-range": "out-of-range";
+    "no-burst-producer": "no-burst-producer";
+    "already-looked": "already-looked";
+}>;
+export type OccupancyLookRefusal = z.infer<typeof OccupancyLookRefusalSchema>;
+/** The input of `requestOccupancyLook` (D691). */
+export declare const OccupancyLookRequestSchema: z.ZodObject<{
+    deviceId: z.ZodNumber;
+    afterMs: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type OccupancyLookRequest = z.infer<typeof OccupancyLookRequestSchema>;
+/** The answer of `requestOccupancyLook` (D691). */
+export declare const OccupancyLookAnswerSchema: z.ZodObject<{
+    scheduled: z.ZodBoolean;
+    dueInMs: z.ZodOptional<z.ZodNumber>;
+    refusedBecause: z.ZodOptional<z.ZodEnum<{
+        "unknown-camera": "unknown-camera";
+        "out-of-range": "out-of-range";
+        "no-burst-producer": "no-burst-producer";
+        "already-looked": "already-looked";
+    }>>;
+}, z.core.$strip>;
+export type OccupancyLookAnswer = z.infer<typeof OccupancyLookAnswerSchema>;
 export declare const pipelineOrchestratorCapability: {
     readonly name: "pipeline-orchestrator";
     readonly scope: "system";
@@ -719,6 +758,29 @@ export declare const pipelineOrchestratorCapability: {
     readonly nodeIdMode: "data";
     readonly exposesDeviceSettings: true;
     readonly methods: {
+        /**
+         * D691 — an occupancy flip is pending on this camera and can commit
+         * `afterMs` from now: dial ONE occupancy burst at the end of its sustain
+         * window instead of leaving the commit to the 300 s parked-object cadence.
+         * Called by the notification centre, the only component that knows a flip
+         * is pending; the dial is the recheck's own (attach on the last session
+         * node, `requestOccupancyBurst`, detach). One pending look per camera; a
+         * session open at the due time is the look, and no burst is dialled.
+         */
+        readonly requestOccupancyLook: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            afterMs: z.ZodNumber;
+            reason: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            scheduled: z.ZodBoolean;
+            dueInMs: z.ZodOptional<z.ZodNumber>;
+            refusedBecause: z.ZodOptional<z.ZodEnum<{
+                "unknown-camera": "unknown-camera";
+                "out-of-range": "out-of-range";
+                "no-burst-producer": "no-burst-producer";
+                "already-looked": "already-looked";
+            }>>;
+        }, z.core.$strip>, "mutation">;
         /** Internal storage-migration participant lease. While held, dispatch
          * requests are accepted as pending but no new runner attachment starts. */
         readonly pauseForStorageMigration: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{

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

@@ -6131,6 +6131,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof DEVICE_SETTINGS_CONTRIBUTION_METHODS.applyDeviceSettingsPatch.output>;
             meta: object;
         }>;
+        requestOccupancyLook: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof pipelineOrchestratorCapability.methods.requestOccupancyLook.input>;
+            output: z.infer<typeof pipelineOrchestratorCapability.methods.requestOccupancyLook.output>;
+            meta: object;
+        }>;
         pauseForStorageMigration: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;

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: 1195 method paths across 162 capabilities.
+ * Coverage: 1196 method paths across 162 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,8 +6,8 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 407 methods carry a device reference, of which
- * 144 are on SYSTEM-scope caps.
+ * Coverage: 408 methods carry a device reference, of which
+ * 145 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying
  * a numeric device field (targets[].deviceId) are all mapped; the matcher

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

@@ -86,7 +86,7 @@ export interface SystemProxy {
     readonly notificationRules: Pick<InferProvider<typeof notificationRulesCapability>, 'listRules' | 'getRule' | 'createRule' | 'updateRule' | 'deleteRule' | 'setRuleEnabled' | 'getClipRetentionAsks' | 'listDeviceMutes' | 'testRule' | 'previewStateSummary' | 'getConditionCatalog' | 'getTemplateCatalog' | 'previewTemplate' | 'getHistory' | 'getRuleLastRuns' | 'resolveArtifactUrl' | 'listSnoozes' | 'createSnooze' | 'cancelSnooze' | 'getAlarmConfig' | 'setAlarmConfig'>;
     readonly osdManager: Pick<InferProvider<typeof osdManagerCapability>, 'getConditionSupport' | 'copyDeviceConfiguration'>;
     readonly pipelineExecutor: Pick<InferProvider<typeof pipelineExecutorCapability>, 'getAvailableEngines' | 'getSelectedEngine' | 'getDefaultSteps' | 'getEngineProvisioning' | 'getVideoPipelineSteps' | 'setVideoPipelineSteps' | 'clearDeviceOverrides' | 'getInferenceDeviceHealth' | 'rearmInferenceDevice' | '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>, 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'setCameraSensors' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
+    readonly pipelineOrchestrator: Pick<InferProvider<typeof pipelineOrchestratorCapability>, 'requestOccupancyLook' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'rebalance' | 'getPipelineAssignments' | 'getAgentLoad' | 'getClusterModelChoice' | 'getGlobalMetrics' | 'getCapabilityBindings' | 'setCapabilityBinding' | 'getIngestOwner' | 'getAudioNodeLoad' | 'getAudioAssignments' | 'getAgentSettings' | 'listAgentSettings' | 'removeAgentSettings' | 'setAgentMaxCameras' | 'setAgentDetectWeight' | 'setAgentCapabilities' | 'setAgentDecodeLimits' | 'setAgentReachableHost' | 'setAgentInferenceDevices' | 'getNodeInferenceDevices' | 'resetNodePipelineDefaults' | 'getCameraStatuses' | 'setCameraSensors' | 'reconcileFromDisk' | 'getReconcileFromDiskStatus' | 'listTemplates' | 'saveTemplate' | 'updateTemplate' | 'deleteTemplate'>;
     readonly pipelineRunner: Pick<InferProvider<typeof pipelineRunnerCapability>, 'attachCamera' | 'reportMotion' | 'getLocalLoad' | 'getLocalMetrics' | 'getAllCameraMetrics' | 'getLocalCameras' | 'getNativeCrop' | 'runStatelessStep'>;
     readonly plateGallery: Pick<InferProvider<typeof plateGalleryCapability>, 'getPlateMedia' | 'searchPlates' | 'suggestPlateClusters' | 'correctPlateText' | 'deletePlate' | 'listVehicles' | 'createVehicle' | 'renameVehicle' | 'deleteVehicle' | 'listVehicleSamples' | 'removeVehicleSample' | 'assignPlate' | 'unassignPlate' | 'assignPlates' | 'unassignPlates'>;
     readonly recordingArchive: Pick<InferProvider<typeof recordingArchiveCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;

package/dist/i18n/state-labels.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ONE dictionary of human labels for the state words the rule editors show
+ * (R7, D690).
+ *
+ * A device-state gate offers the words the engine compares against —
+ * `armed_away`, `not_home`, `unlocking` — and both rule editors printed them
+ * verbatim. The words are the WIRE vocabulary and must stay what they are (a
+ * rule stores them); what the operator reads is a label, and two editors that
+ * each translate on their own are two editors that disagree. Both the admin UI
+ * and the viewer resolve through {@link stateLabel}.
+ *
+ * Keys are the raw values themselves, flat: the vocabularies are disjoint where
+ * they differ and agree where they overlap (`open` is the same word on a cover
+ * and on a contact). An OPEN vocabulary (a presence zone the operator named,
+ * a cover state a new integration invents) falls back to the raw word — never
+ * an exception, never an empty chip.
+ *
+ * Covered, and held to their sources by the spec: the alarm panel's states,
+ * the cover's, the lock's, the boolean readers' words
+ * (`DEVICE_STATE_READERS`), presence's canonical `home`/`not_home`, and the
+ * scene gate's verdicts and read modes.
+ */
+/** A label in every locale both editors ship. */
+export interface StateLabel {
+    readonly en: string;
+    readonly it: string;
+}
+/** The locales a {@link StateLabel} carries. */
+export type StateLabelLocale = keyof StateLabel;
+/** Every key the dictionary answers for, in a stable order. */
+export declare const STATE_LABEL_KEYS: readonly ["disarmed", "armed_home", "armed_away", "armed_night", "armed_vacation", "armed_custom_bypass", "arming", "disarming", "pending", "triggered", "open", "opening", "closing", "closed", "stopped", "locked", "unlocked", "locking", "unlocking", "jammed", "on", "off", "home", "not_home", "matched", "diverged", "unknown", "latched", "live"];
+/** A key {@link STATE_LABELS} answers for. */
+export type StateLabelKey = (typeof STATE_LABEL_KEYS)[number];
+export declare const STATE_LABELS: Readonly<Record<StateLabelKey, StateLabel>>;
+/** Is `key` one the dictionary answers for? An own key only — never `toString`. */
+export declare function isStateLabelKey(key: string): key is StateLabelKey;
+/**
+ * The human label of a state word in `locale`, or the word itself when the
+ * dictionary does not know it. Never throws.
+ */
+export declare function stateLabel(key: string, locale: StateLabelLocale): string;

package/dist/index.d.ts

@@ -124,6 +124,7 @@ export { emitDownForOwnedCaps, ReadinessRegistry, ReadinessTimeoutError, readine
 export * from './stream-selection.js';
 export type { AgentAddonConfig, AgentPipelineSettings, CameraPipelineSettings, CameraStepOverridePatch, DeviceStepConfig, } from './types/agent-pipeline-settings.js';
 export * from './types/analytics.js';
+export * from './types/appearance.js';
 export type { CameraPipelineConfig, PipelineTemplate as CameraPipelineTemplate, } from './types/camera-pipeline.js';
 export * from './types/config.js';
 export * from './types/detection.js';
@@ -232,7 +233,7 @@ export { STREAM_QUALITY_LABELS, streamQualityLabel, } from './interfaces/device-
 export * from './lifecycle/index.js';
 export { AUDIO_SCALE_EPOCH_ISO, AUDIO_SCALE_EPOCH_MS, type AudioScaleEra, audioScaleEraOf, G711_SCALE_CORRECTION_DB, type G711Law, ituDbfsFromPreEpoch, } from './audio/audio-scale-epoch.js';
 export { audioIsFailClosed, audioKindId, audioLabelChoices, audioModeOf, audioOrDefaults, isAudioLabelSelected, NC_AUDIO_CONFIRM_HITS_DEFAULT, NC_AUDIO_CONFIRM_HITS_MAX, NC_AUDIO_CONFIRM_HITS_MIN, NC_AUDIO_CONFIRM_WINDOW_MAX_SEC, NC_AUDIO_CONFIRM_WINDOW_MIN_SEC, NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, NC_AUDIO_DB_MAX, NC_AUDIO_DB_MIN, NC_AUDIO_DB_OFFERED, NC_AUDIO_DB_STEP, NC_AUDIO_DEFAULTS, NC_AUDIO_HIT_PERCENT_MAX, NC_AUDIO_HIT_PERCENT_MIN, NC_AUDIO_SAMPLING_MAX_SEC, NC_AUDIO_SAMPLING_MIN_SEC, type NcAudioLabelChoice, type NcAudioMode, type NcAudioPatch, normalizeAudioLabel, patchAudio, toggleAudioLabel, } from './notification/audio-condition.js';
-export { isBaseConditionKey, knownValues, NC_BASE_CONDITION_KEYS, type NcBaseConditionKey, pickerForCondition, type TaxonomyGroup, type TaxonomyOption, type TaxonomyPicker, } from './notification/condition-taxonomy.js';
+export { isAudioClassName, isBaseConditionKey, knownValues, NC_BASE_CONDITION_KEYS, type NcBaseConditionKey, pickerForCondition, pickerForRuleClasses, type TaxonomyGroup, type TaxonomyOption, type TaxonomyPicker, } from './notification/condition-taxonomy.js';
 export { type PreparedAction, type PreparedAttachment, type PreparedNotification, prepareNotification, type ResolvedLevel, } from './notification/degrade-engine.js';
 export { htmlToText, markdownToHtmlLite, markdownToText, type NotificationFormat as NotificationBodyFormat, resolveFormat, textToHtml, transcodeBody, } from './notification/format-transcode.js';
 export { conditionExclusionReason, conditionVisibleForKind, defaultDeliveryForSection, droppedConditionsForKind, isAudioRule, isOccupancyRule, isSystemDelivery, isSystemRuleKind, kindsForDiscriminator, NC_AUDIO_SEED, NC_OCCUPANCY_DEFAULTS, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_RULE_SECTIONS, NC_SYSTEM_DELIVERY, NC_SYSTEM_RULE_KINDS, type NcDroppedCondition, type NcKindVisibilitySubject, type NcRuleEditorSection, type NcRuleEditorSectionKey, type NcRuleKind, type NcRuleKindSpec, type NcRuleOwningSectionKey, type NcRuleSection, type NcRuleSectionKey, type NcRuleSectionSubject, type NcRuleSeed, parseRuleSection, ruleEditorSectionsForKind, ruleKindOf, ruleKindSpec, ruleMatchesSection, ruleSection, ruleSectionOf, ruleSeedForSection, systemFamilyOfKind, systemRuleKindOf, } from './notification/rule-kinds.js';
@@ -245,6 +246,8 @@ export { describeSystemEventFamilyProblem, isSystemEventFamily, NC_SYSTEM_EVENT_
 export { describeSystemEventDeliveryProblem, isSystemEventSummaryRule, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, type NcSummarySendTime, type NcSystemEventDeliveryProblem, type NcSystemEventDeliverySubject, scheduleForSendTimes, sendTimesOfSchedule, systemEventDeliveryProblems, systemEventSummaryScheduleOf, templateCarriesSummary, } from './notification/system-event-summary.js';
 export { NC_SERVER_PACKAGE_NAME, NC_UPDATE_EVENT_PACKAGE_NAMES, type NcInstalledPackageLike, type NcScopePickerItem, nodePickerItems, packagePickerItems, } from './notification/scope-picker-items.js';
 export type { TimelapseCadencePair, TimelapsePreviewMode, TimelapseRule, TimelapseRuleInput, TimelapseRulePatch, TimelapseTemplate, } from './notification/timelapse-rule.js';
+export type { StateLabel, StateLabelKey, StateLabelLocale } from './i18n/state-labels.js';
+export { isStateLabelKey, STATE_LABEL_KEYS, STATE_LABELS, stateLabel, } from './i18n/state-labels.js';
 export { assertTimelapseCadences, DEFAULT_TIMELAPSE_PREVIEW_TEXT, readTimelapseGeneratedAt, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleInputSchema, TimelapseRulePatchSchema, TimelapseRuleSchema, TimelapseTemplateSchema, } from './notification/timelapse-rule.js';
 export { CLUSTER_MODEL_SCOPED_STEPS, CLUSTER_MODEL_SECTION_ID, CLUSTER_STEP_SETTING_FIELDS, type ClusterModelScopedStep, type ClusterStepModels, type ClusterStepSettingField, type ClusterStepSettings, clusterModelSettingKey, clusterStepSettingFieldsFor, clusterStepSettingKey, DEFAULT_CLUSTER_STEP_MODELS, DEFAULT_CLUSTER_STEP_SETTINGS, DEFAULT_MIN_LANDMARK_FACE_SIZE_PX, type HydratedClusterSection, type HydratedClusterView, interpretStoredClusterModel, type InvalidClusterStepModelEntry, invalidClusterStepModelEntries, isClusterScopedStep, overlayClusterStepSettings, pickClusterStepModels, pickClusterStepSettings, pickInvalidClusterStepModels, readClusterStepModels, readClusterStepSettings, resolveClusterStepModelId, type StepModelScope, type StoredClusterModelInterpretation, } from './pipeline/cluster-model-scope.js';
 export { CAMERA_SENSORS_NOT_LOADED, CAMERA_SENSORS_SETTINGS_KEY, CAMERA_TRIGGER, type CameraSensorAttachment, CameraSensorAttachmentSchema, type CameraSensorRef, CameraSensorRefSchema, cameraSensorRefKey, type CameraSensorsConfig, CameraSensorsConfigSchema, type CameraSensorsMode, CameraSensorsModeSchema, type CameraSensorsNotForwarded, CameraSensorsNotForwardedSchema, type CameraSensorsStatus, CameraSensorsStatusSchema, MAX_CAMERA_SENSORS, type MotionTriggeredBy, type MotionTriggeredByReading, MotionTriggeredBySchema, readMotionTriggeredBy, } from './pipeline/camera-sensors.js';