@camstack/types 1.2.154 → 1.2.156

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_event_category = require("./event-category-b8kBSOTT.js");
-const require_sleep = require("./sleep-Dp0uukHR.js");
+const require_sleep = require("./sleep-BGiOgxye.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
 import { t as EventCategory } from "./event-category-zAv7pMUz.mjs";
-import { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, V as ReadinessRegistry, _t as DATAPLANE_SECRET_HEADER, a as asJsonObject, b as deviceOpsCapability, bt as BaseAddon, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, wt as emitReadiness, x as viewerUiCapability, xt as normalizeAddonInitResult, yt as DisposerChain, z as readNodePin } from "./sleep-CgijQHtG.mjs";
+import { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, V as ReadinessRegistry, _t as DATAPLANE_SECRET_HEADER, a as asJsonObject, b as deviceOpsCapability, bt as BaseAddon, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, wt as emitReadiness, x as viewerUiCapability, xt as normalizeAddonInitResult, yt as DisposerChain, z as readNodePin } from "./sleep-IaOr7P-z.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/capabilities/camera-streams.cap.d.ts

@@ -101,6 +101,11 @@ export declare const cameraStreamsCapability: {
             label: z.ZodOptional<z.ZodString>;
             deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
             autoEligible: z.ZodOptional<z.ZodBoolean>;
+            profileHint: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getBrokerStreams: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -263,6 +268,11 @@ export declare const cameraStreamsCapability: {
                 label: z.ZodOptional<z.ZodString>;
                 deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 autoEligible: z.ZodOptional<z.ZodBoolean>;
+                profileHint: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    mid: "mid";
+                    low: "low";
+                }>>;
                 metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>>;

package/dist/capabilities/index.d.ts

@@ -189,6 +189,7 @@ export { type INavigationProvider, NAVIGATION_ACTION_CATALOG, NAVIGATION_LIGHT_L
 export { type IRebootProvider, rebootCapability } from './reboot.cap.js';
 export { type IRecordingProvider, type LocateSegmentResult, LocateSegmentResultSchema, RECORDING_TIMELINE_BATCH_MAX, type ReadGopBytesResult, ReadGopBytesResultSchema, type ReadSegmentBytesResult, ReadSegmentBytesResultSchema, type ReadWindowBytesResult, ReadWindowBytesResultSchema, type RecordingAvailability, type RecordingAvailabilityForDevice, RecordingAvailabilityForDeviceSchema, RecordingAvailabilitySchema, type RecordingDays, type RecordingDaysForDevice, RecordingDaysForDeviceSchema, RecordingDaysSchema, type RecordingDeviceUsage, RecordingDeviceUsageSchema, type RecordingLocationUsage, RecordingLocationUsageSchema, type RecordingManifest, RecordingManifestSchema, RecordingRangeSchema, type RecordingRebalanceInput, RecordingRebalanceInputSchema, type RecordingRebalanceMove, RecordingRebalanceMoveSchema, type RecordingRebalancePlan, RecordingRebalancePlanSchema, type RecordingRebalanceSkip, type RecordingRebalanceSkipReason, RecordingRebalanceSkipReasonSchema, RecordingRebalanceSkipSchema, type RecordingStatus, RecordingStatusSchema, type RecordingStorageUsage, RecordingStorageUsageSchema, recordingCapability, } from './recording.cap.js';
 export { EXPORT_DENSE_MAX_RANGES, type ExportBytes, ExportBytesSchema, type ExportDense, type ExportDenseRange, ExportDenseRangeSchema, ExportDenseSchema, type ExportDownload, ExportDownloadSchema, type ExportOptions, ExportOptionsSchema, type ExportRecord, ExportRecordSchema, ExportSpeedSchema, type ExportState, ExportStateSchema, ExportTimelapseSchema, type IRecordingExportProvider, RECORDING_EXPORT_MAX_READ_BYTES, recordingExportCapability, } from './recording-export.cap.js';
+export { type IRecordingSignalProvider, type RecordingSignalRuntimeState, RecordingSignalRuntimeStateSchema, type RecordingSignalStatus, RecordingSignalStatusSchema, recordingSignalCapability, } from './recording-signal.cap.js';
 export { type ISceneMonitorProvider, SCENE_CONDITIONS, SCENE_CONFIRM_DEFAULT_MAX_IMAGE_PX, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS, SCENE_DEFAULT_ANCHOR_THRESHOLD, SCENE_DEFAULT_CHECK_INTERVAL_SEC, SCENE_DEFAULT_OBSERVATION_SPACING_SEC, SCENE_DEFAULT_QUIET_SECONDS, SCENE_DEFAULT_UNCOVERED_POLICY, SCENE_DIVERGED, SCENE_RESET_RECAPTURES, type SceneCheck, SceneCheckSchema, type SceneCondition, SceneConditionSchema, type SceneConfirm, SceneConfirmSchema, type SceneMonitor, SceneMonitorSchema, type SceneMonitorState, SceneMonitorStateSchema, type SceneMonitorStatus, type SceneMonitorStatusForDevice, SceneMonitorStatusForDeviceSchema, SceneMonitorStatusSchema, type SceneReference, SceneReferenceSchema, type SceneUnavailable, SceneUnavailableSchema, type SceneUncoveredPolicy, SceneUncoveredPolicySchema, type SceneVerdict, SceneVerdictSchema, sceneMonitorCapability, } from './scene-monitor.cap.js';
 export { type ZoneRule, type ZoneRuleMode, ZoneRuleModeEnum, ZoneRuleSchema, type ZoneRules, ZoneRulesArraySchema, } from './schemas/zone-rule.js';
 export { type IScriptRunnerProvider, type ScriptRunnerStatus, ScriptRunnerStatusSchema, scriptRunnerCapability, } from './script-runner.cap.js';
@@ -329,6 +330,7 @@ import type { ptzAutotrackCapability } from './ptz-autotrack.cap.js';
 import type { rebootCapability } from './reboot.cap.js';
 import type { recordingCapability } from './recording.cap.js';
 import type { recordingExportCapability } from './recording-export.cap.js';
+import type { recordingSignalCapability } from './recording-signal.cap.js';
 import type { sceneMonitorCapability } from './scene-monitor.cap.js';
 import type { scriptRunnerCapability } from './script-runner.cap.js';
 import type { serverManagementCapability } from './server-management.cap.js';
@@ -366,6 +368,6 @@ import type { webrtcSessionCapability } from './webrtc-session.cap.js';
 import type { zoneAnalyticsCapability } from './zone-analytics.cap.js';
 import type { zoneRulesCapability } from './zone-rules.cap.js';
 import type { zonesCapability } from './zones.cap.js';
-type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof connectionTestCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability;
+type AnyCapability = typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof filesystemBrowseCapability | typeof backupCapability | typeof terminalSessionCapability | typeof settingsStoreCapability | typeof dataStoreProviderCapability | typeof logChannelsCapability | typeof logDestinationCapability | typeof loadContributionCapability | typeof failureContributionCapability | typeof adminUiCapability | typeof viewerUiCapability | typeof ssoBridgeCapability | typeof userPasskeysCapability | typeof smtpProviderCapability | typeof mqttBrokerCapability | typeof brokerCapability | typeof deviceAdoptionCapability | typeof deviceExportCapability | typeof addonPagesCapability | typeof addonPagesSourceCapability | typeof addonWidgetsCapability | typeof addonWidgetsSourceCapability | typeof customModelRegistryCapability | typeof modelDistributorCapability | typeof modelConvertCapability | typeof addonRoutesCapability | typeof streamBrokerCapability | typeof decoderCapability | typeof webrtcSessionCapability | typeof cameraStreamsCapability | typeof motionDetectionCapability | typeof pipelineExecutorCapability | typeof detectionPipelineCapability | typeof cameraPipelineConfigCapability | typeof pipelineRunnerCapability | typeof pipelineOrchestratorCapability | typeof audioAnalyzerCapability | typeof audioAnalysisCapability | typeof audioCodecCapability | typeof embeddingEncoderCapability | typeof vectorStoreCapability | typeof deviceProviderCapability | typeof deviceManagerCapability | typeof deviceStateCapability | typeof authProviderCapability | typeof loginMethodCapability | typeof networkAccessCapability | typeof turnProviderCapability | typeof snapshotCapability | typeof llmCapability | typeof llmRuntimeCapability | typeof notificationOutputCapability | typeof coreBlocksCapability | typeof notificationRulesCapability | typeof pipelineAnalyticsCapability | typeof metricsProviderCapability | typeof ptzCapability | typeof ptzAutotrackCapability | typeof navigationCapability | typeof consumablesCapability | typeof connectionTestCapability | typeof rebootCapability | typeof deviceDiscoveryCapability | typeof brightnessCapability | typeof colorCapability | typeof climateControlCapability | typeof coverCapability | typeof valveCapability | typeof humidifierCapability | typeof waterHeaterCapability | typeof weatherCapability | typeof imageCapability | typeof lockControlCapability | typeof vacuumControlCapability | typeof petFeederCapability | typeof lawnMowerControlCapability | typeof fanControlCapability | typeof controlCapability | typeof notifierCapability | typeof mediaPlayerCapability | typeof alarmPanelCapability | typeof presenceCapability | typeof scriptRunnerCapability | typeof automationControlCapability | typeof motionTriggerCapability | typeof eventsCapability | typeof zonesCapability | typeof zoneRulesCapability | typeof zoneAnalyticsCapability | typeof audioMetricsCapability | typeof motionCapability | typeof contactCapability | typeof floodCapability | typeof smokeCapability | typeof carbonMonoxideCapability | typeof gasCapability | typeof tamperCapability | typeof vibrationCapability | typeof connectivityCapability | typeof binaryCapability | typeof temperatureSensorCapability | typeof humiditySensorCapability | typeof ambientLightSensorCapability | typeof pressureSensorCapability | typeof powerMeterCapability | typeof airQualitySensorCapability | typeof numericSensorCapability | typeof enumSensorCapability | typeof recordingCapability | typeof recordingExportCapability | typeof recordingSignalCapability | typeof deviceOpsCapability | typeof platformProbeCapability | typeof localNetworkCapability | typeof meshNetworkCapability | typeof userManagementCapability | typeof systemCapability | typeof networkQualityCapability | typeof toastCapability | typeof nodesCapability | typeof serverManagementCapability | typeof integrationsCapability | typeof addonsCapability | typeof oauthIntegrationCapability | typeof streamParamsCapability | typeof streamCatalogCapability | typeof motionZonesCapability | typeof sceneMonitorCapability | typeof privacyMaskCapability | typeof dayNightCapability | typeof imageSettingsCapability | typeof osdCapability | typeof osdManagerCapability | typeof accessoriesCapability | typeof batteryCapability | typeof networkLinkCapability | typeof buttonCapability | typeof cameraCredentialsCapability | typeof deviceStatusCapability | typeof doorbellCapability | typeof eventEmitterCapability | typeof faceGalleryCapability | typeof featureProbeCapability | typeof intercomCapability | typeof nativeObjectDetectionCapability | typeof plateGalleryCapability | typeof switchCapability | typeof updateCapability | typeof videoclipsCapability;
 export type CapabilityName = AnyCapability['name'];
 export type ITypedReadinessRegistry = IReadinessRegistry<CapabilityName>;

package/dist/capabilities/recording-signal.cap.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * A camera's own "record me NOW" LEVEL — a signal the device raises while
+ * something it knows about is happening (a robot vacuum cleaning, a machine
+ * running, a gate open) and lowers when it stops.
+ *
+ * It is a level, not an edge. The sensor triggers the recorder already listens
+ * to (`SOURCE_CAP_ACTIVE_FIELD`) fire on a rising edge and record for a fixed
+ * post-buffer; a cleaning lasts forty minutes, and forty minutes of "this is
+ * still happening" cannot be expressed as an edge plus a post-buffer without
+ * either re-triggering on a timer (polling — D224 forbids the consumer keeping
+ * the fact fresh) or picking a post-buffer long enough to cover every job,
+ * which records the dock for that long after every short one. So the recorder
+ * reads the LEVEL: it records for as long as `active` is true, plus the band's
+ * own post-buffer once it falls.
+ *
+ * Who owns the fact: the PROVIDER of the device, which already reads the state
+ * the signal is derived from (the vacuum's lifecycle state, for Dreame). It
+ * writes this slice on every change; consumers subscribe to the kernel's
+ * `DeviceStateChanged` for it and read it back through
+ * `deviceState.getCapSlice` to reconcile — never a second copy, never a poll
+ * against the device (D224, D8/D11).
+ *
+ * Deliberately NOT a `binary` sensor on the camera: a binary sensor is exported
+ * to Home Assistant, HomeKit and the sensor picker as a thing an operator can
+ * bind, and "the camera wants to record" is not a room sensor. It is a fact
+ * about the camera, on the camera.
+ */
+export declare const RecordingSignalStatusSchema: z.ZodObject<{
+    active: z.ZodBoolean;
+    reason: z.ZodString;
+    lastChangedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type RecordingSignalStatus = z.infer<typeof RecordingSignalStatusSchema>;
+/** The runtime-state slice: the status plus the clock every slice carries. */
+export declare const RecordingSignalRuntimeStateSchema: z.ZodObject<{
+    active: z.ZodBoolean;
+    reason: z.ZodString;
+    lastChangedAt: z.ZodNumber;
+    lastFetchedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type RecordingSignalRuntimeState = z.infer<typeof RecordingSignalRuntimeStateSchema>;
+export declare const recordingSignalCapability: {
+    readonly name: "recording-signal";
+    readonly scope: "device";
+    readonly deviceNative: true;
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.Camera];
+    readonly methods: {
+        /** The current level, straight from the slice the provider keeps fresh. */
+        readonly getStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            active: z.ZodBoolean;
+            reason: z.ZodString;
+            lastChangedAt: z.ZodNumber;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            active: z.ZodBoolean;
+            reason: z.ZodString;
+            lastChangedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        readonly kind: "push";
+        readonly empty: {
+            readonly active: false;
+            readonly reason: "unknown";
+            readonly lastChangedAt: 0;
+        };
+    };
+    readonly runtimeState: z.ZodObject<{
+        active: z.ZodBoolean;
+        reason: z.ZodString;
+        lastChangedAt: z.ZodNumber;
+        lastFetchedAt: z.ZodNumber;
+    }, z.core.$strip>;
+    /**
+     * Runtime-state durability: **session** — a restored `active: true` from
+     * before a restart is exactly the stale level the recorder's reconcile bound
+     * exists to end, and the provider re-derives the true level on activation
+     * anyway. Nothing is lost by forgetting it; a lie is avoided.
+     *
+     * See `RuntimeStateDurability`. Enforced by
+     * `scripts/check-runtime-state-durability.ts`.
+     */
+    readonly durability: "session";
+};
+export type IRecordingSignalProvider = InferProvider<typeof recordingSignalCapability>;

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

@@ -486,6 +486,7 @@ export declare const recordingCapability: {
                         animal: "animal";
                     }>>>;
                     sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                    deviceSignal: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
                 preBufferSec: z.ZodOptional<z.ZodNumber>;
                 postBufferSec: z.ZodOptional<z.ZodNumber>;
@@ -587,6 +588,7 @@ export declare const recordingCapability: {
                             animal: "animal";
                         }>>>;
                         sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                        deviceSignal: z.ZodOptional<z.ZodBoolean>;
                     }, z.core.$strip>>;
                     preBufferSec: z.ZodOptional<z.ZodNumber>;
                     postBufferSec: z.ZodOptional<z.ZodNumber>;
@@ -626,6 +628,7 @@ export declare const recordingCapability: {
                         animal: "animal";
                     }>>>;
                     sensorDeviceIds: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                    deviceSignal: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
                 preBufferSec: z.ZodOptional<z.ZodNumber>;
                 postBufferSec: z.ZodOptional<z.ZodNumber>;

package/dist/capabilities/schemas/streaming-shared.d.ts

@@ -44,6 +44,11 @@ export declare const CameraStreamSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
     deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
     autoEligible: z.ZodOptional<z.ZodBoolean>;
+    profileHint: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type CameraStream = z.infer<typeof CameraStreamSchema>;

package/dist/capabilities/stream-broker.cap.d.ts

@@ -563,6 +563,11 @@ export declare const streamBrokerCapability: {
             label: z.ZodOptional<z.ZodString>;
             deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
             autoEligible: z.ZodOptional<z.ZodBoolean>;
+            profileHint: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             sourceCamStreamId: z.ZodOptional<z.ZodString>;
             encodeProfile: z.ZodOptional<z.ZodObject<{
@@ -826,6 +831,11 @@ export declare const streamBrokerCapability: {
             label: z.ZodOptional<z.ZodString>;
             deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
             autoEligible: z.ZodOptional<z.ZodBoolean>;
+            profileHint: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly listAllProfileSlots: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{

package/dist/capabilities/stream-catalog.cap.d.ts

@@ -40,6 +40,11 @@ export declare const CamStreamDescriptorSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
     deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
     autoEligible: z.ZodOptional<z.ZodBoolean>;
+    profileHint: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
 export type CamStreamDescriptor = z.infer<typeof CamStreamDescriptorSchema>;
@@ -94,6 +99,11 @@ declare const StreamCatalogStateSchema: z.ZodObject<{
         label: z.ZodOptional<z.ZodString>;
         deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
         autoEligible: z.ZodOptional<z.ZodBoolean>;
+        profileHint: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            mid: "mid";
+            low: "low";
+        }>>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>;
     lastFetchedAt: z.ZodNumber;
@@ -129,6 +139,11 @@ export declare const streamCatalogCapability: {
             label: z.ZodOptional<z.ZodString>;
             deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
             autoEligible: z.ZodOptional<z.ZodBoolean>;
+            profileHint: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
     };
@@ -154,6 +169,11 @@ export declare const streamCatalogCapability: {
             label: z.ZodOptional<z.ZodString>;
             deviceFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
             autoEligible: z.ZodOptional<z.ZodBoolean>;
+            profileHint: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
             metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
         lastFetchedAt: z.ZodNumber;

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

@@ -93,6 +93,7 @@ import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.j
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
 import type { recordingExportCapability } from '../capabilities/recording-export.cap.js';
+import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { recordingCapability } from '../capabilities/recording.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -6881,6 +6882,20 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    recordingSignal: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof recordingSignalCapability.methods.getStatus.input>;
+            output: z.infer<typeof recordingSignalCapability.methods.getStatus.output>;
+            meta: object;
+        }>;
+    }>>;
     sceneMonitor: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;

package/dist/generated/cap-status-types.d.ts

@@ -55,6 +55,7 @@ import type { PrivacyMaskStatusSchema } from '../capabilities/privacy-mask.cap.j
 import type { PtzStatusSchema } from '../capabilities/ptz.cap.js';
 import type { PtzAutotrackStatusSchema } from '../capabilities/ptz-autotrack.cap.js';
 import type { RecordingStatusSchema } from '../capabilities/recording.cap.js';
+import type { RecordingSignalStatusSchema } from '../capabilities/recording-signal.cap.js';
 import type { SceneMonitorStatusSchema } from '../capabilities/scene-monitor.cap.js';
 import type { ScriptRunnerStatusSchema } from '../capabilities/script-runner.cap.js';
 import type { SmokeStatusSchema } from '../capabilities/smoke.cap.js';
@@ -131,6 +132,7 @@ export type CapStatusTypeMap = {
     readonly 'ptz': z.infer<typeof PtzStatusSchema>;
     readonly 'ptz-autotrack': z.infer<typeof PtzAutotrackStatusSchema>;
     readonly 'recording': z.infer<typeof RecordingStatusSchema>;
+    readonly 'recording-signal': z.infer<typeof RecordingSignalStatusSchema>;
     readonly 'scene-monitor': z.infer<typeof SceneMonitorStatusSchema>;
     readonly 'script-runner': z.infer<typeof ScriptRunnerStatusSchema>;
     readonly 'smoke': z.infer<typeof SmokeStatusSchema>;
@@ -153,4 +155,4 @@ export type CapNameWithStatus = keyof CapStatusTypeMap;
  * aggregator to enumerate caps whose `status` should be polled +
  * streamed via `subscribeDeviceStatusAggregate`.
  */
-export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];
+export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording", "recording-signal", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];

package/dist/generated/capability-router-map.d.ts

@@ -115,6 +115,7 @@ export { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 export { rebootCapability } from '../capabilities/reboot.cap.js';
 export { recordingCapability } from '../capabilities/recording.cap.js';
 export { recordingExportCapability } from '../capabilities/recording-export.cap.js';
+export { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 export { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 export { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 export { serverManagementCapability } from '../capabilities/server-management.cap.js';
@@ -270,6 +271,7 @@ export declare const CAPABILITY_NAMES: {
     readonly reboot: "reboot";
     readonly recording: "recording";
     readonly recordingExport: "recording-export";
+    readonly recordingSignal: "recording-signal";
     readonly sceneMonitor: "scene-monitor";
     readonly scriptRunner: "script-runner";
     readonly serverManagement: "server-management";
@@ -438,6 +440,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly reboot: TRouter;
     readonly recording: TRouter;
     readonly recordingExport: TRouter;
+    readonly recordingSignal: TRouter;
     readonly sceneMonitor: TRouter;
     readonly scriptRunner: TRouter;
     readonly serverManagement: TRouter;
@@ -476,8 +479,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (127 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "videoclips", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
+/** Capability names whose mode is `singleton` (128 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ["accessories", "addon-pages", "addon-settings", "addon-widgets", "addons", "admin-ui", "air-quality-sensor", "alarm-panel", "alerts", "ambient-light-sensor", "audio-analysis", "audio-analyzer", "audio-codec", "audio-metrics", "automation-control", "backup", "battery", "binary", "brightness", "button", "camera-credentials", "camera-pipeline-config", "camera-streams", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "core-blocks", "cover", "day-night", "decoder", "detection-pipeline", "device-adoption", "device-discovery", "device-manager", "device-ops", "device-state", "device-status", "doorbell", "enum-sensor", "event-emitter", "events", "face-gallery", "fan-control", "feature-probe", "filesystem-browse", "flood", "gas", "humidifier", "humidity-sensor", "image", "image-settings", "integrations", "intercom", "lawn-mower-control", "llm-runtime", "local-network", "lock-control", "media-player", "metrics-provider", "model-convert", "model-distributor", "motion", "motion-detection", "motion-trigger", "motion-zones", "native-object-detection", "navigation", "network-link", "network-quality", "nodes", "notification-rules", "notifier", "numeric-sensor", "osd", "osd-manager", "pet-feeder", "pipeline-analytics", "pipeline-executor", "pipeline-orchestrator", "pipeline-runner", "plate-gallery", "platform-probe", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "reboot", "recording", "recording-export", "recording-signal", "scene-monitor", "script-runner", "server-management", "settings-store", "smoke", "snapshot", "sso-bridge", "storage", "storage-migration", "stream-broker", "stream-catalog", "stream-params", "switch", "system", "tamper", "temperature-sensor", "terminal-session", "toast", "update", "user-management", "vacuum-control", "valve", "vector-store", "vibration", "videoclips", "viewer-ui", "water-heater", "weather", "webrtc-session", "zone-analytics", "zone-rules", "zones"];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
 /** Capability names whose mode is `collection` (27 caps). */

package/dist/generated/device-local-state.d.ts

@@ -48,6 +48,7 @@ import { presenceCapability } from '../capabilities/presence.cap.js';
 import { pressureSensorCapability } from '../capabilities/pressure-sensor.cap.js';
 import { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js';
 import { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
+import { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import { smokeCapability } from '../capabilities/smoke.cap.js';
@@ -126,6 +127,7 @@ export interface DeviceLocalState {
     pressureSensor: InferRuntimeState<typeof pressureSensorCapability>;
     privacyMask: InferRuntimeState<typeof privacyMaskCapability>;
     ptzAutotrack: InferRuntimeState<typeof ptzAutotrackCapability>;
+    recordingSignal: InferRuntimeState<typeof recordingSignalCapability>;
     sceneMonitor: InferRuntimeState<typeof sceneMonitorCapability>;
     scriptRunner: InferRuntimeState<typeof scriptRunnerCapability>;
     smoke: InferRuntimeState<typeof smokeCapability>;
@@ -214,6 +216,7 @@ export interface CapNameToRuntimeStateMap {
     'pressure-sensor': InferRuntimeState<typeof pressureSensorCapability>;
     'privacy-mask': InferRuntimeState<typeof privacyMaskCapability>;
     'ptz-autotrack': InferRuntimeState<typeof ptzAutotrackCapability>;
+    'recording-signal': InferRuntimeState<typeof recordingSignalCapability>;
     'scene-monitor': InferRuntimeState<typeof sceneMonitorCapability>;
     'script-runner': InferRuntimeState<typeof scriptRunnerCapability>;
     'smoke': InferRuntimeState<typeof smokeCapability>;

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

@@ -64,6 +64,7 @@ import type { privacyMaskCapability } from '../capabilities/privacy-mask.cap.js'
 import type { ptzCapability } from '../capabilities/ptz.cap.js';
 import type { ptzAutotrackCapability } from '../capabilities/ptz-autotrack.cap.js';
 import type { rebootCapability } from '../capabilities/reboot.cap.js';
+import type { recordingSignalCapability } from '../capabilities/recording-signal.cap.js';
 import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
 import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
 import type { smokeCapability } from '../capabilities/smoke.cap.js';
@@ -156,6 +157,7 @@ export interface DeviceProxyState {
     readonly pressureSensor: SliceHandle<InferRuntimeState<typeof pressureSensorCapability>>;
     readonly privacyMask: SliceHandle<InferRuntimeState<typeof privacyMaskCapability>>;
     readonly ptzAutotrack: SliceHandle<InferRuntimeState<typeof ptzAutotrackCapability>>;
+    readonly recordingSignal: SliceHandle<InferRuntimeState<typeof recordingSignalCapability>>;
     readonly sceneMonitor: SliceHandle<InferRuntimeState<typeof sceneMonitorCapability>>;
     readonly scriptRunner: SliceHandle<InferRuntimeState<typeof scriptRunnerCapability>>;
     readonly smoke: SliceHandle<InferRuntimeState<typeof smokeCapability>>;
@@ -254,6 +256,7 @@ export interface DeviceProxy {
     readonly ptz?: InferDeviceProxyCap<typeof ptzCapability>;
     readonly ptzAutotrack?: InferDeviceProxyCap<typeof ptzAutotrackCapability>;
     readonly reboot?: InferDeviceProxyCap<typeof rebootCapability>;
+    readonly recordingSignal?: InferDeviceProxyCap<typeof recordingSignalCapability>;
     readonly sceneMonitor?: InferDeviceProxyCap<typeof sceneMonitorCapability>;
     readonly scriptRunner?: InferDeviceProxyCap<typeof scriptRunnerCapability>;
     readonly smoke?: InferDeviceProxyCap<typeof smokeCapability>;

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

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

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 366 methods carry a device reference, of which
+ * Coverage: 367 methods carry a device reference, of which
  * 134 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
- * `runtimeState`. 66 caps: 35 `restored`, 31 `session`.
+ * `runtimeState`. 67 caps: 35 `restored`, 32 `session`.
  *
  * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
  * with `durability: 'session'` has one and has decided not to keep it.