@camstack/system 1.2.195 → 1.2.197

package/dist/{dist-Cr3ChLtE.mjs → dist-DWnHJI2T.mjs}

@@ -1783,6 +1783,21 @@ var CameraStreamSchema = z.object({
 	*/
 	autoEligible: z.boolean().optional(),
 	/**
+	* The profile slot the PUBLISHER says this stream is: `low` for a stream
+	* whose only sensible role is the low-bandwidth one, `high` for a main
+	* stream. Consulted by the broker's automatic ranking
+	* (`rankInitialAssignment`) BEFORE the pixel-count heuristic, and only there:
+	* an operator's manual assignment still wins, and an absent hint is the
+	* pixel-ranked default every camera had before this field existed.
+	*
+	* Why it exists: a camera with ONE stream ranked to `mid` — the slot no
+	* storage class is written for on its own (`recordings` is high|mid,
+	* `recordingsLow` is low) and the one profile scrub does not read. The robot
+	* camera's single 720p relay is a `low` in every respect except the slot the
+	* heuristic put it in.
+	*/
+	profileHint: CamProfileSchema.optional(),
+	/**
 	* Transport-specific opaque metadata. The broker passes it through to
 	* the source reader without inspecting it. Currently used by
 	* `pull-rfc4571` streams to carry the upstream SDP (so the reader can
@@ -4094,7 +4109,22 @@ var RecordingTriggersSchema = z.object({
 	* il livello: un contatto trovato già aperto al riavvio del runner non fa
 	* registrare.
 	*/
-	sensorDeviceIds: z.array(z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional()
+	sensorDeviceIds: z.array(z.number().int().positive()).min(1).max(16).refine(noDuplicates, { message: "sensorDeviceIds must not repeat a device" }).optional(),
+	/**
+	* La camera registra per tutta la durata del SEGNALE che lei stessa
+	* pubblica — la cap `recording-signal` (`active: true` mentre il device è in
+	* funzione: un robot che pulisce). È un LIVELLO, non un fronte: la finestra
+	* resta aperta finché il segnale è alto e si chiude `postBufferSec` dopo la
+	* caduta, così una pulizia di quaranta minuti è UNA clip.
+	*
+	* Non nomina un device: il segnale è della camera stessa, tenuto fresco dal
+	* suo provider (D224); il recorder lo ascolta su `DeviceStateChanged` e lo
+	* riconcilia leggendo la slice via RPC, con un tetto oltre il quale un
+	* segnale mai abbassato (un evento perso) non può tenere aperta una
+	* registrazione (D11). Vedi `recorder/addon/band-decision.ts`
+	* (`holdTrigger` / `releaseTrigger`).
+	*/
+	deviceSignal: z.boolean().optional()
 });
 /**
 * Mode of a single recording band — the recorder per-band vocabulary.
@@ -8199,6 +8229,8 @@ var streamBrokerCapability = {
 			label: z.string().optional(),
 			deviceFeatures: z.array(z.string()).optional(),
 			autoEligible: z.boolean().optional(),
+			/** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+			profileHint: CamProfileSchema.optional(),
 			metadata: z.record(z.string(), z.unknown()).optional(),
 			/** Required when kind === 'derived' — the source camStreamId the
 			*  derived broker reads its encoded plane from.
@@ -31520,6 +31552,77 @@ var recordingExportCapability = {
 	}
 };
 /**
+* 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.
+*/
+var RecordingSignalStatusSchema = z.object({
+	/** True while the device asks to be recorded. */
+	active: z.boolean(),
+	/**
+	* Why, in the provider's own vocabulary (a vacuum's `cleaning` / `docked`,
+	* …). Free text for the log line and the UI badge; the recorder never
+	* branches on it.
+	*/
+	reason: z.string(),
+	/** Ms epoch of the last `active` transition. 0 if never observed. */
+	lastChangedAt: z.number()
+});
+/** The runtime-state slice: the status plus the clock every slice carries. */
+var RecordingSignalRuntimeStateSchema = RecordingSignalStatusSchema.extend({ lastFetchedAt: z.number() });
+var recordingSignalCapability = {
+	name: "recording-signal",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.Camera],
+	methods: { 
+	/** The current level, straight from the slice the provider keeps fresh. */
+getStatus: method(z.object({ deviceId: z.number() }), RecordingSignalStatusSchema) },
+	status: {
+		schema: RecordingSignalStatusSchema,
+		kind: "push",
+		empty: {
+			active: false,
+			reason: "unknown",
+			lastChangedAt: 0
+		}
+	},
+	runtimeState: RecordingSignalRuntimeStateSchema,
+	/**
+	* 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`.
+	*/
+	durability: "session"
+};
+/**
 * scene-monitor — device-scoped reference-region state cap. An operator marks
 * a rect ROI on a camera frame and names one or more states; the engine
 * (pipeline-analytics, designated post-processing node) reports which state is
@@ -32017,6 +32120,8 @@ var CamStreamDescriptorSchema = z.object({
 	deviceFeatures: z.array(z.string()).optional(),
 	/** Eligible for automatic profile assignment. Absent = `true`. */
 	autoEligible: z.boolean().optional(),
+	/** The slot the publisher says this stream IS — see `CameraStreamSchema.profileHint`. */
+	profileHint: CamProfileSchema.optional(),
 	/** Transport-specific opaque metadata (e.g. rfc4571 SDP). */
 	metadata: z.record(z.string(), z.unknown()).optional()
 });
@@ -34994,6 +35099,7 @@ var CAP_NAMES_WITH_STATUS = [
 	"ptz",
 	"ptz-autotrack",
 	"recording",
+	"recording-signal",
 	"scene-monitor",
 	"script-runner",
 	"smoke",
@@ -35136,6 +35242,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	rebootCapability,
 	recordingCapability,
 	recordingExportCapability,
+	recordingSignalCapability,
 	sceneMonitorCapability,
 	scriptRunnerCapability,
 	serverManagementCapability,
@@ -39813,6 +39920,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"recordingSignal.getStatus": {
+		capName: "recording-signal",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"sceneMonitor.captureReference": {
 		capName: "scene-monitor",
 		capScope: "device",
@@ -42805,6 +42918,11 @@ Object.freeze({
 		form: "single",
 		optional: true
 	}],
+	"recordingSignal.getStatus": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"sceneMonitor.captureReference": [{
 		name: "deviceId",
 		form: "single",
@@ -43158,7 +43276,7 @@ Object.freeze({
 });
 /**
 * 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.
@@ -43360,6 +43478,10 @@ var RUNTIME_STATE_POLICY = {
 		durability: "session",
 		volatileFields: []
 	},
+	"recording-signal": {
+		durability: "session",
+		volatileFields: []
+	},
 	"scene-monitor": {
 		durability: "session",
 		volatileFields: []

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-Qnc3kuba.js");
+const require_dist = require("./dist-BNaW68aZ.js");
 const require_builtins_alerts_alerts_addon = require("./builtins/alerts/alerts.addon.js");
 require("./builtins/alerts/index.js");
 const require_formatter = require("./formatter-DqAKDlvN.js");

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { a as __toCommonJS, i as __require, n as __esmMin, o as __toESM$1, r as __exportAll, t as __commonJSMin$1 } from "./chunk-CNf5ZN-e.mjs";
-import { Ct as scopesAllowAddon, Ft as errMsg$1, Jt as asString$1, Kt as asJsonObject$1, Lt as DATAPLANE_SECRET_HEADER$1, O as addonSettingsCapability, Qt as expandCapMethods, Rt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Ut as ReadinessRegistry, Wt as ReadinessTimeoutError, Xt as emitDownForOwnedCaps, Yt as createEvent, Z as extractNestedAddonId, _t as procedureAuthKey, an as resolveCapMount, at as isVoidInput, cn as EventCategory$1, dt as looseSchema, et as isArrayOutputSchema, g as RUNTIME_DEFAULTS, in as readinessKey, m as METHOD_ACCESS_MAP, mt as objectInputDeclaresAddonId, nn as parseJsonObject, nt as isObjectInput, on as scopeKey, ot as kebabToCamel, p as LOG_LEVEL_RANK, qt as asNumber, rn as parseJsonUnknown, st as lifecycleJobSchema, t as ALL_CAPABILITY_DEFINITIONS, tt as isCollectionArrayMethod, ut as logLevelAtMost, wt as scopesAllowDeviceCap, xt as resolveMethodAuth, zt as DEVICE_STATUS_METHOD } from "./dist-Cr3ChLtE.mjs";
+import { Ct as scopesAllowAddon, Ft as errMsg$1, Jt as asString$1, Kt as asJsonObject$1, Lt as DATAPLANE_SECRET_HEADER$1, O as addonSettingsCapability, Qt as expandCapMethods, Rt as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Ut as ReadinessRegistry, Wt as ReadinessTimeoutError, Xt as emitDownForOwnedCaps, Yt as createEvent, Z as extractNestedAddonId, _t as procedureAuthKey, an as resolveCapMount, at as isVoidInput, cn as EventCategory$1, dt as looseSchema, et as isArrayOutputSchema, g as RUNTIME_DEFAULTS, in as readinessKey, m as METHOD_ACCESS_MAP, mt as objectInputDeclaresAddonId, nn as parseJsonObject, nt as isObjectInput, on as scopeKey, ot as kebabToCamel, p as LOG_LEVEL_RANK, qt as asNumber, rn as parseJsonUnknown, st as lifecycleJobSchema, t as ALL_CAPABILITY_DEFINITIONS, tt as isCollectionArrayMethod, ut as logLevelAtMost, wt as scopesAllowDeviceCap, xt as resolveMethodAuth, zt as DEVICE_STATUS_METHOD } from "./dist-DWnHJI2T.mjs";
 import { AlertCenterAddon } from "./builtins/alerts/alerts.addon.mjs";
 import "./builtins/alerts/index.mjs";
 import { t as formatLogLine } from "./formatter-B7qW8bPJ.mjs";

package/dist/{retired-settings-keys-C_h6HXZi.js → retired-settings-keys-FwgzdSHJ.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-Qnc3kuba.js");
+const require_dist = require("./dist-BNaW68aZ.js");
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/dist/{retired-settings-keys-BG6g74f1.mjs → retired-settings-keys-cjLVvYV0.mjs}

@@ -1,4 +1,4 @@
-import { Kt as asJsonObject } from "./dist-Cr3ChLtE.mjs";
+import { Kt as asJsonObject } from "./dist-DWnHJI2T.mjs";
 //#region src/builtins/sqlite-storage/retired-settings-keys.ts
 /**
 * Is THIS node the one whose settings store is the cluster's authority?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.195",
+  "version": "1.2.197",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",