@camstack/types 1.2.356 → 1.2.358

package/dist/index.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-BFVY4_xY.js");
+const require_sleep = require("./sleep-CEqsJkV5.js");
 const require_event_category = require("./event-category-T43rdQWR.js");
 const require_composition = require("./composition-DCYnv4I6.js");
 const require_node_color = require("./node-color.js");
@@ -9260,6 +9260,16 @@ var BrokerClientsSchema = zod.z.object({
 	/** Total encoded + raw-RTP callback subscriber count (sum of `encoded[].length`). */
 	encodedSubscribers: zod.z.number()
 });
+/**
+* How many people are watching one camera LIVE right now — see
+* `getLiveViewerCounts`. A camera with nobody watching is absent from the list
+* (so `viewers` is always at least 1): the listing carries the cameras that
+* have viewers, never a row of zeros.
+*/
+var LiveViewerCountSchema = zod.z.object({
+	deviceId: zod.z.number().int().nonnegative(),
+	viewers: zod.z.number().int().positive()
+});
 var PlaceholderReasonSchema = zod.z.enum([
 	"reconnecting",
 	"sleeping",
@@ -9743,6 +9753,24 @@ var streamBrokerCapability = {
 			auth: "admin"
 		}),
 		listClients: require_sleep.method(zod.z.object({ brokerId: zod.z.string() }), BrokerClientsSchema),
+		/**
+		* People watching each camera LIVE right now, for every camera at once —
+		* cheap enough to poll (a walk of the live session maps, no I/O).
+		*
+		* Counts EXTERNAL viewers only: WebRTC sessions of a viewer kind
+		* (`webrtc-browser` / `-mobile` / `-whep`, `alexa`, `homekit`) that are on
+		* the live edge, plus RTSP restream clients from outside that are playing.
+		* The system's own consumers are never counted: the detection decoder, the
+		* recorder, snapshots, the prebuffer hold, audio analysis, and the RTSP
+		* dials an agent's derived broker makes. One WebRTC session or RTSP
+		* connection is one viewer, so two tabs on one camera read 2.
+		*
+		* The count is read off the live session maps at call time, so a session
+		* that ends — cleanly or by the peer vanishing — stops counting with no
+		* counter to leak. It covers the sessions THIS provider serves; a node
+		* with its own stream-broker is asked with a `nodeId` pin.
+		*/
+		getLiveViewerCounts: require_sleep.method(zod.z.void(), zod.z.array(LiveViewerCountSchema).readonly()),
 		killClient: require_sleep.method(zod.z.object({
 			brokerId: zod.z.string(),
 			channel: zod.z.enum(["rtsp", "audio"]),
@@ -30249,19 +30277,6 @@ var RunnerCameraDeviceUIFields = [
 			label: MOTION_SOURCE_LABELS[value]
 		})
 	},
-	{
-		key: "detectionSources",
-		type: "multiselect",
-		label: "Detection Sources",
-		default: ["pipeline"],
-		options: [{
-			value: "pipeline",
-			label: "This node (ML root step on decoded frames)"
-		}, {
-			value: "onboard",
-			label: "Camera onboard AI (replaces the root step when picked alone)"
-		}]
-	},
 	{
 		key: "motionFps",
 		type: "slider",
@@ -30952,6 +30967,12 @@ var CameraStepOverridePatchSchema = zod.z.object({
 	settings: zod.z.record(zod.z.string(), zod.z.unknown()).readonly().optional()
 });
 var CameraStepSettingsSchema = zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.unknown()).readonly());
+/** The three root-detector choices a camera has (D507: at most one root). */
+var CameraDetectionSourceSchema = zod.z.enum([
+	"pipeline",
+	"onboard",
+	"none"
+]);
 var CameraPipelineSettingsSchema = zod.z.object({
 	stepToggles: zod.z.record(zod.z.string(), zod.z.boolean()).optional(),
 	stepSettings: CameraStepSettingsSchema.optional(),
@@ -31896,6 +31917,41 @@ var pipelineOrchestratorCapability = {
 			kind: "mutation",
 			auth: "admin"
 		}),
+		/**
+		* Where this camera's first-level detections come from: this node's own
+		* root step (`pipeline`), the camera's onboard detector alone (`onboard`),
+		* or no root detector (`none`). A camera runs at most one root detector
+		* (D507), so there is no "both". Read from the camera's stored
+		* `detectionSources` — the one authority; `explicit` is false while the
+		* operator has never picked and the default stands.
+		*/
+		getCameraDetectionSource: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.object({
+			source: CameraDetectionSourceSchema,
+			explicit: zod.z.boolean(),
+			onboard: zod.z.object({
+				/** The camera has an onboard detector this system can read. */
+				available: zod.z.boolean(),
+				/** What its detections carry — a camera with no box cannot be a root step. */
+				geometry: zod.z.enum([
+					"boxed",
+					"while-streaming",
+					"flag-only",
+					"unknown"
+				])
+			})
+		})),
+		/**
+		* Pick where this camera's detections come from. Writes `detectionSources`
+		* and arms (or disarms) the vendor's boxed sub-stream that the choice
+		* drives. Refuses `onboard` on a camera with no onboard detector.
+		*/
+		setCameraDetectionSource: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number(),
+			source: CameraDetectionSourceSchema
+		}), zod.z.object({ success: zod.z.literal(true) }), {
+			kind: "mutation",
+			auth: "admin"
+		}),
 		/** Read every per-(node,device) override map for a device. Null when device has no overrides. */
 		getCameraStepOverrides: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), zod.z.record(zod.z.string(), CameraStepOverridePatchSchema))).nullable()),
 		/**
@@ -37086,6 +37142,17 @@ var BatteryStatusSchema = zod.z.object({
 	*/
 	lastContactAt: zod.z.number().optional(),
 	/**
+	* Ms epoch of the last COMPLETE scheduled refresh — every fact the provider
+	* holds for the device (level, charging, link, device info, state slices) and
+	* its cached snapshot, read together. Absent = never since this slice was
+	* born. Unlike `lastUpdated` (any write, even a push of one field) this is
+	* the staleness an operator can trust: the provider owns the device fact and
+	* so owns the window on its age (D224, D847). Not a clock in the
+	* runtime-state-durability sense: it moves once per window and must survive
+	* a restart, or every restart would owe the camera a wake.
+	*/
+	lastFullRefreshAt: zod.z.number().optional(),
+	/**
 	* True when the source is a BINARY low-battery indicator (HA
 	* `binary_sensor` device_class=battery / `LOW_BAT`) that has no real
 	* charge level — `percentage` is then a coarse stand-in (100 = normal,
@@ -42494,7 +42561,14 @@ var TopologyNodeSchema = zod.z.object({
 	* completed a mutual-TLS handshake, `clear` otherwise. Absent for the hub,
 	* for offline rows and when the hub cannot tell.
 	*/
-	meshTransport: zod.z.enum(["tls", "clear"]).optional()
+	meshTransport: zod.z.enum(["tls", "clear"]).optional(),
+	/**
+	* Whether the hub holds this online AGENT's capability registration (its
+	* `registerNode` manifest). `false` = online in the mesh but not ready: the
+	* hub dropped the registration on a disconnect only it saw and the agent has
+	* not re-sent it. Absent for the hub and offline rows.
+	*/
+	capabilitiesRegistered: zod.z.boolean().optional()
 });
 var CapUsageEdgeSchema = zod.z.object({
 	callerAddonId: zod.z.string(),
@@ -59183,6 +59257,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineOrchestrator.getCameraDetectionSource": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineOrchestrator.getCameraMetrics": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -59411,6 +59491,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"pipelineOrchestrator.setCameraDetectionSource": {
+		capName: "pipeline-orchestrator",
+		capScope: "system",
+		addonId: null,
+		access: "create"
+	},
 	"pipelineOrchestrator.setCameraPipelineForAgent": {
 		capName: "pipeline-orchestrator",
 		capScope: "system",
@@ -60863,6 +60949,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"streamBroker.getLiveViewerCounts": {
+		capName: "stream-broker",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"streamBroker.getPreBufferInfo": {
 		capName: "stream-broker",
 		capScope: "system",
@@ -68418,6 +68510,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineOrchestrator.getCameraDetectionSource": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineOrchestrator.getCameraMetrics": [{
 		name: "deviceId",
 		form: "single",
@@ -68478,6 +68575,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"pipelineOrchestrator.setCameraDetectionSource": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"pipelineOrchestrator.setCameraPipelineForAgent": [{
 		name: "deviceId",
 		form: "single",
@@ -69472,6 +69574,7 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"pipelineOrchestrator.assignAudio",
 	"pipelineOrchestrator.assignPipeline",
 	"pipelineOrchestrator.getAudioAssignment",
+	"pipelineOrchestrator.getCameraDetectionSource",
 	"pipelineOrchestrator.getCameraMetrics",
 	"pipelineOrchestrator.getCameraSettings",
 	"pipelineOrchestrator.getCameraStatus",
@@ -69484,6 +69587,7 @@ var SYSTEM_SCOPE_DEVICE_METHODS = [
 	"pipelineOrchestrator.getPipelineDevicePin",
 	"pipelineOrchestrator.requestOccupancyLook",
 	"pipelineOrchestrator.resolvePipeline",
+	"pipelineOrchestrator.setCameraDetectionSource",
 	"pipelineOrchestrator.setCameraPipelineForAgent",
 	"pipelineOrchestrator.setCameraSensors",
 	"pipelineOrchestrator.setCameraStepOverride",
@@ -70665,6 +70769,7 @@ function createSystemProxy(api) {
 			getBrokerStats: (input) => dispatch("streamBroker", "getBrokerStats", "query", input),
 			probeStream: (input) => dispatch("streamBroker", "probeStream", "mutation", input),
 			listClients: (input) => dispatch("streamBroker", "listClients", "query", input),
+			getLiveViewerCounts: (input) => dispatch("streamBroker", "getLiveViewerCounts", "query", input),
 			killClient: (input) => dispatch("streamBroker", "killClient", "mutation", input),
 			getStreamUrl: (input) => dispatch("streamBroker", "getStreamUrl", "query", input),
 			getStreamWithCodec: (input) => dispatch("streamBroker", "getStreamWithCodec", "mutation", input),
@@ -79442,6 +79547,7 @@ exports.CameraDecoderStatusSchema = CameraDecoderStatusSchema;
 exports.CameraDetectionPhaseSchema = CameraDetectionPhaseSchema;
 exports.CameraDetectionProvisioningSchema = CameraDetectionProvisioningSchema;
 exports.CameraDetectionProvisioningStateSchema = CameraDetectionProvisioningStateSchema;
+exports.CameraDetectionSourceSchema = CameraDetectionSourceSchema;
 exports.CameraDetectionStatusSchema = CameraDetectionStatusSchema;
 exports.CameraMetricsSchema = CameraMetricsSchema;
 exports.CameraMetricsWithDeviceIdSchema = CameraMetricsWithDeviceIdSchema;
@@ -79920,6 +80026,7 @@ exports.LinkedDevicesSlotValueSchema = LinkedDevicesSlotValueSchema;
 exports.ListNodeBenchmarkResultsInputSchema = ListNodeBenchmarkResultsInputSchema;
 exports.ListTrackRelationsInputSchema = ListTrackRelationsInputSchema;
 exports.ListTrackRelationsResultSchema = ListTrackRelationsResultSchema;
+exports.LiveViewerCountSchema = LiveViewerCountSchema;
 exports.LlmDefaultSchema = LlmDefaultSchema;
 exports.LlmDefaultSelectorSchema = LlmDefaultSelectorSchema;
 exports.LlmDownloadProgressSchema = LlmDownloadProgressSchema;