@camstack/types 1.2.188 → 1.2.190

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DXsYD0RX.js");
-const require_event_category = require("./event-category-yW4s1MGD.js");
+const require_sleep = require("./sleep-B8nfmQ8a.js");
+const require_event_category = require("./event-category-BVfsrBYA.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 { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, St as normalizeAddonInitResult, Tt as emitReadiness, V as ReadinessRegistry, a as asJsonObject, b as deviceOpsCapability, bt as DisposerChain, 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, vt as DATAPLANE_SECRET_HEADER, x as viewerUiCapability, xt as BaseAddon, z as readNodePin } from "./sleep-DBKu2-U5.mjs";
-import { t as EventCategory } from "./event-category-ZyX6jcse.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, St as normalizeAddonInitResult, Tt as emitReadiness, V as ReadinessRegistry, a as asJsonObject, b as deviceOpsCapability, bt as DisposerChain, 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, vt as DATAPLANE_SECRET_HEADER, x as viewerUiCapability, xt as BaseAddon, z as readNodePin } from "./sleep-BEyvfshj.mjs";
+import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/camera/stream-pick.d.ts

@@ -0,0 +1,71 @@
+/**
+ * THE ranking behind `cameraStreams.pickStream` — one place where "which
+ * stream should this consumer get" is answered.
+ *
+ * It is pure, and it lives here rather than inside the broker, because the
+ * point of the exercise was that there be exactly ONE of it. On 2026-09-13
+ * there were two: this picker, and a private scorer inside the Alexa exporter
+ * written the same day because the picker could not express Amazon's ceiling.
+ * A second authority for a question that already had one is the defect this
+ * repo keeps paying for — two knobs where the second outranks the first (D62),
+ * a pin no UI could show, a flag that never reached ffmpeg.
+ *
+ * Each consumer passes ITS OWN numbers. Alexa's floor is Amazon's 480p and its
+ * ceiling 1080p; HomeKit's are its own. The thresholds belong to whoever has
+ * the requirement, never to a default in here.
+ */
+export interface PickCandidate {
+    readonly camStreamId: string;
+    readonly codec?: string | undefined;
+    readonly height?: number | undefined;
+    readonly width?: number | undefined;
+}
+export interface PickRanking {
+    /** Codecs usable with no transcode. Empty ⇒ every codec is usable. */
+    readonly acceptCodecs: readonly string[];
+    /** Whether a codec outside `acceptCodecs` may win, transcoded. */
+    readonly allowTranscode: boolean;
+    /** Ordered provider prefixes; earlier wins. */
+    readonly preferredProviders: readonly string[];
+    /** `highest` / `lowest`, used when `targetHeight` is absent. */
+    readonly resolutionPreference: 'highest' | 'lowest';
+    /** The height the consumer means to deliver. See the cap's docblock. */
+    readonly targetHeight?: number | undefined;
+}
+export interface RankedPick {
+    readonly candidate: PickCandidate;
+    readonly transcodes: boolean;
+}
+/**
+ * THE target rule: which of two sizes serves a consumer better.
+ *
+ * "Prefer at or above the target so the consumer downscales instead of
+ * upscaling; among those the SMALLEST, because the extra pixels are thrown
+ * away and the decode is not; among the rest the LARGEST, because it is the
+ * closest we can get." One sentence, and until now it was written twice — once
+ * here in lines, once in `stream-selection.ts` in pixels, for the same two
+ * exporters. The two agreed, which is luck, not a property.
+ *
+ * The `size` is whatever measure the caller ranks by: the cap ranks by LINES
+ * (a consumer's requirement is stated in p), the RTSP picker by PIXELS (it
+ * compares entries of possibly different aspect). The rule is the same either
+ * way and the measure is the caller's business.
+ *
+ * Returns a sort delta: negative when `a` should come first.
+ */
+export declare function compareToTarget(a: number, b: number, target: number): number;
+export declare function codecIsAccepted(codec: string | undefined, accept: readonly string[]): boolean;
+/**
+ * Order the candidates and return the winner, or `null` when none qualifies.
+ *
+ * The order, and every term is there for a measured reason:
+ *
+ *  1. **A stream we can take AS IS beats one we must re-encode.** A transcode
+ *     is a decode plus an encode for as long as the session lasts, and on this
+ *     hub a concurrent HEVC decode is what exhausted the VAAPI device.
+ *  2. **Provider preference**, unchanged — a native dial beats a relayed one.
+ *  3. **The target**, when the consumer named one: the smallest stream that
+ *     reaches it, else the tallest that does not. Absent, the caller's
+ *     `resolutionPreference` decides, exactly as before.
+ */
+export declare function rankStreams(candidates: readonly PickCandidate[], ranking: PickRanking): RankedPick | null;

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

@@ -22,6 +22,7 @@ export declare const PickStreamRequirementsSchema: z.ZodReadonly<z.ZodObject<{
         vp9: "vp9";
     }>>>>;
     minHeight: z.ZodOptional<z.ZodNumber>;
+    maxHeight: z.ZodOptional<z.ZodNumber>;
     minWidth: z.ZodOptional<z.ZodNumber>;
     excludeDerived: z.ZodOptional<z.ZodBoolean>;
     requireSiblingCodec: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
@@ -33,6 +34,7 @@ export declare const PickStreamRequirementsSchema: z.ZodReadonly<z.ZodObject<{
         vp8: "vp8";
         vp9: "vp9";
     }>>>>;
+    allowTranscode: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>>;
 export declare const PickStreamPreferencesSchema: z.ZodReadonly<z.ZodObject<{
     preferredProviders: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -40,7 +42,10 @@ export declare const PickStreamPreferencesSchema: z.ZodReadonly<z.ZodObject<{
         highest: "highest";
         lowest: "lowest";
     }>>;
+    targetHeight: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
+export type PickStreamRequirements = z.infer<typeof PickStreamRequirementsSchema>;
+export type PickStreamPreferences = z.infer<typeof PickStreamPreferencesSchema>;
 export declare const PickedCamStreamSchema: z.ZodObject<{
     camStreamId: z.ZodString;
     codec: z.ZodOptional<z.ZodString>;
@@ -48,6 +53,7 @@ export declare const PickedCamStreamSchema: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
     }, z.core.$strip>>;
+    transcodes: z.ZodBoolean;
     reason: z.ZodString;
 }, z.core.$strip>;
 export type PickedCamStream = z.infer<typeof PickedCamStreamSchema>;
@@ -213,6 +219,7 @@ export declare const cameraStreamsCapability: {
                     vp9: "vp9";
                 }>>>>;
                 minHeight: z.ZodOptional<z.ZodNumber>;
+                maxHeight: z.ZodOptional<z.ZodNumber>;
                 minWidth: z.ZodOptional<z.ZodNumber>;
                 excludeDerived: z.ZodOptional<z.ZodBoolean>;
                 requireSiblingCodec: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodEnum<{
@@ -224,6 +231,7 @@ export declare const cameraStreamsCapability: {
                     vp8: "vp8";
                     vp9: "vp9";
                 }>>>>;
+                allowTranscode: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
             preferences: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
                 preferredProviders: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -231,6 +239,7 @@ export declare const cameraStreamsCapability: {
                     highest: "highest";
                     lowest: "lowest";
                 }>>;
+                targetHeight: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
             camStreamId: z.ZodString;
@@ -239,6 +248,7 @@ export declare const cameraStreamsCapability: {
                 width: z.ZodNumber;
                 height: z.ZodNumber;
             }, z.core.$strip>>;
+            transcodes: z.ZodBoolean;
             reason: z.ZodString;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
     };

package/dist/capabilities/index.d.ts

@@ -34,7 +34,8 @@ export { AuthResultSchema, authProviderCapability } from './auth-provider.cap.js
 export { ArchiveEntrySchema, ArchiveManifestSchema, BackupDestinationInfoSchema, BackupEntrySchema, type BackupRun, type BackupRunPhase, BackupRunPhaseSchema, BackupRunSchema, type BackupRunState, BackupRunStateSchema, type BackupTriggerResult, BackupTriggerResultSchema, backupCapability, type IBackupProvider, LocationStatSchema, } from './backup.cap.js';
 export { BrokerAddInputSchema, BrokerGetStateInputSchema, type BrokerInfo as UnifiedBrokerInfo, BrokerInfoSchema as UnifiedBrokerInfoSchema, type BrokerProviderInfo, BrokerProviderInfoSchema, BrokerPublishInputSchema, BrokerRegistryStatusSchema, type BrokerStatus as UnifiedBrokerStatus, BrokerStatusEnum, BrokerSubscribeInputSchema, BrokerSubscribeResultSchema, BrokerTestConnectionResultSchema, BrokerUnsubscribeInputSchema, brokerCapability, type IBrokerProvider, } from './broker.cap.js';
 export { cameraPipelineConfigCapability, type ICameraPipelineConfigProvider, } from './camera-pipeline-config.cap.js';
-export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, PickStreamPreferencesSchema, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
+export { streamSignalsCapability, type IStreamSignalsProvider, type StreamSignal, StreamSignalSchema, type StreamSignalsStatus, StreamSignalsStatusSchema, } from './stream-signals.cap.js';
+export { cameraStreamsCapability, type ICameraStreamsProvider, type PickedCamStream, PickedCamStreamSchema, type PickStreamPreferences, PickStreamPreferencesSchema, type PickStreamRequirements, PickStreamRequirementsSchema, type StreamCodec, StreamCodecSchema, } from './camera-streams.cap.js';
 export { extractNestedAddonId, isArrayOutputSchema, isCollectionArrayMethod, isObjectInput, isVoidInput, kebabToCamel, looseSchema, objectInputDeclaresAddonId, procedureAuthKey, resolveMethodAuth, } from './cap-router-predicates.js';
 export type { CapabilityDefinition, CapabilityEventSchema, CapabilityMethodAuth, CapabilityMethodCaller, CapabilityMethodKind, CapabilityMethodOptions, CapabilityMethodSchema, CapabilityMountHint, CapabilityMountKind, CapabilityStatusItemArray, CapabilityStatusKind, CapabilityStatusSchema, CapCaller, DeviceConfigDerivedFormUi, DeviceConfigSpec, DeviceConfigUiSpec, DeviceConfigWidgetUi, DeviceSettingsContribution, InferDeviceProxyCap, InferEvents, InferName, InferNativeProvider, InferProvider, InferRuntimeState, ProviderKind, RuntimeStateDurability, UiContribution, UiContributionKind, UiContributionRemote, } from './capability-definition.js';
 export { DEFAULT_RUNTIME_STATE_DURABILITY, DEVICE_SETTINGS_CONTRIBUTION_METHODS, DEVICE_STATUS_METHOD, event, expandCapMethods, isDeviceConfigCap, method, resolveCapMount, } from './capability-definition.js';
@@ -169,7 +170,7 @@ export { type IMeshNetworkProvider, type MeshEndpoint, type MeshPeer, MeshPeerSc
 export { type IMotionProvider, MOTION_CLOSE_AFTER_MS, type MotionOnMotionChangedData, MotionOnMotionChangedDataSchema, type MotionStatus, MotionStatusSchema, motionCapability, } from './motion.cap.js';
 export { type IMotionTriggerProvider, type MotionTriggerRuntimeState, MotionTriggerRuntimeStateSchema, type MotionTriggerStatus, MotionTriggerStatusSchema, motionTriggerCapability, } from './motion-trigger.cap.js';
 export { type IMotionZonesProvider, type MotionZoneOptions, MotionZoneOptionsSchema, type MotionZonePatch, MotionZonePatchSchema, type MotionZoneRegion, MotionZoneRegionSchema, type MotionZoneStatus, MotionZoneStatusSchema, motionZonesCapability, } from './motion-zones.cap.js';
-export { type INativeObjectDetectionProvider, type NativeDetection, NativeDetectionSchema, type NativeObjectClass, NativeObjectClassEnum, type NativeObjectDetectionRuntimeState, NativeObjectDetectionRuntimeStateSchema, type NativeObjectDetectionStatus, NativeObjectDetectionStatusSchema, nativeObjectDetectionCapability, } from './native-object-detection.cap.js';
+export { type INativeObjectDetectionProvider, type NativeDetection, NativeDetectionSchema, type NativeObjectClass, NativeObjectClassEnum, type NativeObjectDetectionOptions, NativeObjectDetectionOptionsSchema, type NativeObjectDetectionRuntimeState, NativeObjectDetectionRuntimeStateSchema, type NativeObjectDetectionSettingsPatch, NativeObjectDetectionSettingsPatchSchema, type NativeObjectDetectionStatus, NativeObjectDetectionStatusSchema, type NativeObjectGeometry, NativeObjectGeometryEnum, nativeObjectDetectionCapability, } from './native-object-detection.cap.js';
 export { type INavigationProvider, NAVIGATION_ACTION_CATALOG, NAVIGATION_LIGHT_LEVEL_MAX, NAVIGATION_LIGHT_LEVEL_MIN, type NavigationActionEntry, NavigationActionEntrySchema, type NavigationActionId, NavigationActionIdSchema, type NavigationEntryKind, NavigationEntryKindSchema, type NavigationFeatures, NavigationFeaturesSchema, type NavigationLightMode, NavigationLightModeSchema, type NavigationMode, NavigationModeSchema, type NavigationMoveCommand, NavigationMoveCommandSchema, type NavigationPoint, NavigationPointSchema, type NavigationRuntimeState, NavigationRuntimeStateSchema, type NavigationStatus, NavigationStatusSchema, navigationCapability, } from './navigation.cap.js';
 export { type INetworkLinkProvider, NETWORK_LINK_TYPES, NETWORK_LINK_UNKNOWN, type NetworkLinkStatus, NetworkLinkStatusSchema, type NetworkLinkType, networkLinkCapability, signalPercentFromBars, signalPercentFromRssi, } from './network-link.cap.js';
 export { ClientNetworkStatsSchema, DeviceNetworkStatsSchema, type INetworkQualityProvider, networkQualityCapability, StreamNetworkStatsSchema, } from './network-quality.cap.js';
@@ -241,6 +242,7 @@ import type { brokerCapability } from './broker.cap.js';
 import type { buttonCapability } from './button.cap.js';
 import type { cameraCredentialsCapability } from './camera-credentials.cap.js';
 import type { cameraPipelineConfigCapability } from './camera-pipeline-config.cap.js';
+import type { streamSignalsCapability } from './stream-signals.cap.js';
 import type { cameraStreamsCapability } from './camera-streams.cap.js';
 import type { carbonMonoxideCapability } from './carbon-monoxide.cap.js';
 import type { climateControlCapability } from './climate-control.cap.js';
@@ -370,6 +372,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 storageOccupancyCapability | 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;
+type AnyCapability = typeof streamSignalsCapability | typeof addonSettingsCapability | typeof alertsCapability | typeof storageCapability | typeof storageMigrationCapability | typeof storageProviderCapability | typeof storageEvictableCapability | typeof storageOccupancyCapability | 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/native-object-detection.cap.d.ts

@@ -66,6 +66,44 @@ export declare const NativeObjectDetectionStatusSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
 }, z.core.$strip>;
 export type NativeObjectDetectionStatus = z.infer<typeof NativeObjectDetectionStatusSchema>;
+/**
+ * What a camera's onboard detections actually CARRY.
+ *
+ * `boxed` — the firmware ships a bounding box with the class, so a detection is
+ * a subject the pipeline can track, crop and score.
+ * `flag-only` — the firmware ships the class and nothing else. The pipeline
+ * needs geometry to make a subject out of it, so such a push reaches the
+ * tracker as motion and no further. On Reolink this is every battery camera:
+ * the boxes ride the BcMedia sub-stream, which a battery camera never attaches.
+ *
+ * Reported and not inferred, because the operator's question in front of the
+ * toggle is "what do I get", and "a class with no box" and "a subject" are
+ * different answers (D14: the derived form is only as honest as `getOptions`).
+ */
+export declare const NativeObjectGeometryEnum: z.ZodEnum<{
+    boxed: "boxed";
+    "flag-only": "flag-only";
+}>;
+export type NativeObjectGeometry = z.infer<typeof NativeObjectGeometryEnum>;
+export declare const NativeObjectDetectionOptionsSchema: z.ZodObject<{
+    supportedClasses: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+        package: "package";
+        face: "face";
+        other: "other";
+    }>>>;
+    geometry: z.ZodEnum<{
+        boxed: "boxed";
+        "flag-only": "flag-only";
+    }>;
+}, z.core.$strip>;
+export type NativeObjectDetectionOptions = z.infer<typeof NativeObjectDetectionOptionsSchema>;
+export declare const NativeObjectDetectionSettingsPatchSchema: z.ZodObject<{
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type NativeObjectDetectionSettingsPatch = z.infer<typeof NativeObjectDetectionSettingsPatchSchema>;
 export declare const NativeObjectDetectionRuntimeStateSchema: z.ZodObject<{
     lastByClass: z.ZodRecord<z.ZodEnum<{
         person: "person";
@@ -104,7 +142,36 @@ export declare const nativeObjectDetectionCapability: {
     readonly deviceNative: true;
     readonly mode: "singleton";
     readonly deviceTypes: readonly [DeviceType.Camera];
+    readonly deviceConfig: {
+        readonly ui: {
+            readonly kind: "derived-form";
+            readonly builderId: "native-object-detection";
+            readonly tab: "motion";
+        };
+    };
     readonly methods: {
+        readonly getOptions: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            supportedClasses: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+                package: "package";
+                face: "face";
+                other: "other";
+            }>>>;
+            geometry: z.ZodEnum<{
+                boxed: "boxed";
+                "flag-only": "flag-only";
+            }>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly setSettings: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            settings: z.ZodObject<{
+                enabled: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
         readonly setEnabled: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             enabled: z.ZodBoolean;