camstack 1.2.146 → 1.2.149

package/dist/{chunk-F3AFDVKF.js → chunk-IGFZA22D.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-DBKu2-U5.mjs
+// ../types/dist/sleep-DEuj7E3j.mjs
 var AUDIO_CHUNK_FORMATS = [
   "f32le",
   "pcmu",
@@ -18788,6 +18788,39 @@ var cameraPipelineConfigCapability = {
   exposesDeviceSettings: true,
   methods: {}
 };
+var StreamSignalSchema = external_exports.object({
+  /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
+  code: external_exports.string().min(1),
+  /** What an operator reads in the picker. The provider's own wording. */
+  label: external_exports.string().min(1),
+  /**
+  * Whether the provider recommends this signal ON when a camera is first set
+  * up. A provider knows which of its signals are cheap and reliable; an
+  * operator should not have to discover that by trial. Reolink recommends
+  * both of its own.
+  */
+  recommended: external_exports.boolean()
+});
+var StreamSignalsStatusSchema = external_exports.object({
+  signals: external_exports.array(StreamSignalSchema),
+  lastFetchedAt: external_exports.number()
+});
+var streamSignalsCapability = {
+  name: "stream-signals",
+  scope: "device",
+  deviceNative: true,
+  mode: "singleton",
+  deviceTypes: Object.values(DeviceType),
+  runtimeState: StreamSignalsStatusSchema,
+  methods: {
+    /**
+    * What this device can emit. Empty is a valid and common answer — most
+    * cameras have nothing to offer here, and an empty list is what makes the
+    * broker's picker show nothing rather than a false choice.
+    */
+    listSignals: method(external_exports.void(), external_exports.array(StreamSignalSchema).readonly())
+  }
+};
 var StreamFormatSchema = external_exports.enum([
   "webrtc",
   "hls",
@@ -19140,6 +19173,46 @@ var streamBrokerCapability = {
   mode: "singleton",
   exposesDeviceSettings: true,
   methods: {
+    /**
+    * A device reporting that one of ITS OWN signals just fired.
+    *
+    * The provider calls this; nothing polls. The broker then decides whether
+    * to wake the source, and the decision has two terms that must BOTH hold:
+    *
+    *  - the signal is ENABLED for this camera (the operator's per-camera
+    *    choice — a camera may declare a signal the operator does not want
+    *    waking anything), and
+    *  - a consumer is actually attached and waiting on the prestream. Waking
+    *    a camera nobody is watching is the one thing a battery camera must
+    *    never do, and a signal arriving with no consumer is exactly that.
+    *
+    * Reported, never inferred: a signal that fires while the stream is
+    * already up refreshes the hold instead of starting a second one, which is
+    * what makes continuous motion keep a camera awake without stacking
+    * timers.
+    *
+    * `code` is the provider's own, from `streamSignals.listSignals`. An
+    * unknown code is REFUSED rather than treated as a wildcard wake — a
+    * provider and an operator disagreeing about a name must not become a
+    * camera that wakes for everything.
+    */
+    reportStreamSignal: method(external_exports.object({
+      deviceId: external_exports.number().int().nonnegative(),
+      /** The provider's signal code. */
+      code: external_exports.string().min(1),
+      /** Ms epoch. Absent ⇒ now. */
+      at: external_exports.number().optional()
+    }), external_exports.object({
+      /** Whether the broker acted on it, and if not, why. */
+      accepted: external_exports.boolean(),
+      reason: external_exports.enum([
+        "woke",
+        "hold-extended",
+        "not-enabled",
+        "no-consumer",
+        "unknown-code"
+      ])
+    }), { kind: "mutation" }),
     publishCameraStream: method(external_exports.object({
       deviceId: external_exports.number().int().nonnegative(),
       camStreamId: external_exports.string().min(1),
@@ -19617,6 +19690,16 @@ var PickStreamRequirementsSchema = external_exports.object({
   acceptCodecs: external_exports.array(StreamCodecSchema).readonly().optional(),
   /** Minimum vertical resolution. Streams shorter than this are dropped. */
   minHeight: external_exports.number().int().positive().optional(),
+  /**
+  * Maximum vertical resolution. Streams TALLER than this are dropped.
+  *
+  * A consumer can have a ceiling as real as its floor: Alexa documents
+  * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
+  * Without this the ceiling had to be re-implemented by every caller — and
+  * one caller implementing it privately is how a second scoring authority
+  * gets born.
+  */
+  maxHeight: external_exports.number().int().positive().optional(),
   /** Minimum horizontal resolution. */
   minWidth: external_exports.number().int().positive().optional(),
   /**
@@ -19633,7 +19716,22 @@ var PickStreamRequirementsSchema = external_exports.object({
   * transcoded" guard: if the device is already serving the consumer's
   * codec end-to-end, there's nothing to optimise.
   */
-  requireSiblingCodec: external_exports.array(StreamCodecSchema).readonly().optional()
+  requireSiblingCodec: external_exports.array(StreamCodecSchema).readonly().optional(),
+  /**
+  * Whether a stream the consumer CANNOT decode may still be picked, on the
+  * understanding that it will be transcoded.
+  *
+  * Default `false` — today's behaviour, and the right one for a bypass
+  * question ("is there a stream I can forward untouched?"). Set `true` to
+  * ask the larger question: "what is the best stream for me, transcoding if
+  * I must?" A stream that satisfies `acceptCodecs` always outranks one that
+  * does not, so a passthrough is never lost to a transcode; the answer says
+  * which it is in {@link PickedCamStreamSchema.transcodes}.
+  *
+  * This is what lets one picker serve both the bypass and the full source
+  * choice, instead of a consumer scoring privately when the bypass misses.
+  */
+  allowTranscode: external_exports.boolean().optional()
 }).readonly();
 var PickStreamPreferencesSchema = external_exports.object({
   /**
@@ -19647,12 +19745,32 @@ var PickStreamPreferencesSchema = external_exports.object({
   * picks the tallest stream; `'lowest'` picks the shortest (used by
   * memory-constrained consumers / Apple Home guest sessions).
   */
-  resolutionPreference: external_exports.enum(["highest", "lowest"]).optional()
+  resolutionPreference: external_exports.enum(["highest", "lowest"]).optional(),
+  /**
+  * The height the consumer actually wants to DELIVER.
+  *
+  * Not a constraint — an ordering. With it set, the SMALLEST stream at or
+  * above the target wins, and only if nothing reaches it does the tallest
+  * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
+  * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
+  * express that: it says "as big as possible", which is a different wish.
+  *
+  * Ignored when absent, so every existing caller keeps its ordering.
+  */
+  targetHeight: external_exports.number().int().positive().optional()
 }).readonly();
 var PickedCamStreamSchema = external_exports.object({
   camStreamId: external_exports.string(),
   codec: external_exports.string().optional(),
   resolution: CamStreamResolutionSchema.optional(),
+  /**
+  * Whether serving this stream requires a decode + re-encode.
+  *
+  * `false` is a stream the consumer can take as it stands. Only ever `true`
+  * when the caller asked for it with `allowTranscode`, so a caller that did
+  * not ask cannot be handed a cost it never agreed to pay.
+  */
+  transcodes: external_exports.boolean(),
   /** One-line explanation of why this stream won — for logs / debug UI. */
   reason: external_exports.string()
 });
@@ -24463,6 +24581,8 @@ var NcSystemEventKindSchema = external_exports.enum([
   "device-enabled",
   "device-battery-low",
   "device-battery-normal",
+  "device-consumable-low",
+  "device-consumable-normal",
   "stream-online",
   "stream-offline",
   "node-online",
@@ -24481,6 +24601,7 @@ var NcSystemEventKindSchema = external_exports.enum([
   "addon-updated",
   "server-updated",
   "export-completed",
+  "backup-completed",
   "camera-online",
   "camera-offline",
   "camera-disabled",
@@ -32245,10 +32366,28 @@ var webrtcSessionCapability = {
     getSessionState: method(external_exports.object({
       deviceId: external_exports.number().int().nonnegative(),
       sessionId: external_exports.string()
-    }), external_exports.object({ pendingRenegotiation: external_exports.object({
-      target: WebrtcStreamTargetSchema,
-      epoch: external_exports.number()
-    }).nullable() }))
+    }), external_exports.object({
+      pendingRenegotiation: external_exports.object({
+        target: WebrtcStreamTargetSchema,
+        epoch: external_exports.number()
+      }).nullable(),
+      /**
+      * Whether the session still EXISTS.
+      *
+      * A consumer that holds a resource for the life of a session needs to
+      * be able to ask, because a session does not always end the way it
+      * began. Measured on this hub 2026-09-13: an Echo that got stuck never
+      * sent `SessionDisconnected`, so the Alexa exporter's
+      * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
+      * H.264 transcode kept running for NOBODY for more than twenty
+      * minutes. The WebRTC session had logged `WebRTC session closed`
+      * minutes earlier — the broker knew; the holder had no way to ask.
+      *
+      * `false` for a session id the provider has never heard of, which is
+      * the same answer as "it ended": either way nothing is holding it up.
+      */
+      alive: external_exports.boolean()
+    }))
   },
   /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
   mount: { kind: "server-provided" }
@@ -46536,6 +46675,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "streamBroker.reportStreamSignal": {
+    capName: "stream-broker",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "streamBroker.restartProfile": {
     capName: "stream-broker",
     capScope: "system",
@@ -46620,6 +46765,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "streamSignals.listSignals": {
+    capName: "stream-signals",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "switch.setState": {
     capName: "switch",
     capScope: "device",
@@ -48992,6 +49143,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
     form: "single",
     optional: false
   }],
+  "streamBroker.reportStreamSignal": [{
+    name: "deviceId",
+    form: "single",
+    optional: false
+  }],
   "streamBroker.restartProfile": [{
     name: "deviceId",
     form: "single",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-F3AFDVKF.js";
+} from "./chunk-IGFZA22D.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-L5YPTDNE.js");
+  await import("./launcher-26BZ4JHD.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-L5YPTDNE.js");
+  await import("./launcher-26BZ4JHD.js");
 }
 
 // src/commands/setup.ts
@@ -1140,7 +1140,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-CLO7P5ID.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-ZCOCQKSU.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-CLO7P5ID.js → discover-ZCOCQKSU.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-F3AFDVKF.js";
+} from "./chunk-IGFZA22D.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/dist/{launcher-L5YPTDNE.js → launcher-26BZ4JHD.js}

@@ -23633,9 +23633,9 @@ var require_zod = __commonJS({
   }
 });
 
-// ../system/dist/dist-DUSfUAgz.js
-var require_dist_DUSfUAgz = __commonJS({
-  "../system/dist/dist-DUSfUAgz.js"(exports) {
+// ../system/dist/dist-CEIkHEdy.js
+var require_dist_CEIkHEdy = __commonJS({
+  "../system/dist/dist-CEIkHEdy.js"(exports) {
     "use strict";
     var zod = require_zod();
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
@@ -23776,6 +23776,7 @@ var require_dist_DUSfUAgz = __commonJS({
       EventCategory2["LocalNetworkChanged"] = "network.local.changed";
       EventCategory2["MeshNetworkChanged"] = "network.mesh.changed";
       EventCategory2["BackupCompleted"] = "backup.completed";
+      EventCategory2["BackupRunCompleted"] = "backup.run-completed";
       EventCategory2["BackupRestored"] = "backup.restored";
       EventCategory2["NotificationDispatched"] = "notification.dispatched";
       EventCategory2["NotificationFailed"] = "notification.failed";
@@ -29446,6 +29447,39 @@ var require_dist_DUSfUAgz = __commonJS({
       exposesDeviceSettings: true,
       methods: {}
     };
+    var StreamSignalSchema = zod.z.object({
+      /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
+      code: zod.z.string().min(1),
+      /** What an operator reads in the picker. The provider's own wording. */
+      label: zod.z.string().min(1),
+      /**
+      * Whether the provider recommends this signal ON when a camera is first set
+      * up. A provider knows which of its signals are cheap and reliable; an
+      * operator should not have to discover that by trial. Reolink recommends
+      * both of its own.
+      */
+      recommended: zod.z.boolean()
+    });
+    var StreamSignalsStatusSchema = zod.z.object({
+      signals: zod.z.array(StreamSignalSchema),
+      lastFetchedAt: zod.z.number()
+    });
+    var streamSignalsCapability = {
+      name: "stream-signals",
+      scope: "device",
+      deviceNative: true,
+      mode: "singleton",
+      deviceTypes: Object.values(DeviceType),
+      runtimeState: StreamSignalsStatusSchema,
+      methods: {
+        /**
+        * What this device can emit. Empty is a valid and common answer — most
+        * cameras have nothing to offer here, and an empty list is what makes the
+        * broker's picker show nothing rather than a false choice.
+        */
+        listSignals: method(zod.z.void(), zod.z.array(StreamSignalSchema).readonly())
+      }
+    };
     var StreamFormatSchema = zod.z.enum([
       "webrtc",
       "hls",
@@ -29798,6 +29832,46 @@ var require_dist_DUSfUAgz = __commonJS({
       mode: "singleton",
       exposesDeviceSettings: true,
       methods: {
+        /**
+        * A device reporting that one of ITS OWN signals just fired.
+        *
+        * The provider calls this; nothing polls. The broker then decides whether
+        * to wake the source, and the decision has two terms that must BOTH hold:
+        *
+        *  - the signal is ENABLED for this camera (the operator's per-camera
+        *    choice — a camera may declare a signal the operator does not want
+        *    waking anything), and
+        *  - a consumer is actually attached and waiting on the prestream. Waking
+        *    a camera nobody is watching is the one thing a battery camera must
+        *    never do, and a signal arriving with no consumer is exactly that.
+        *
+        * Reported, never inferred: a signal that fires while the stream is
+        * already up refreshes the hold instead of starting a second one, which is
+        * what makes continuous motion keep a camera awake without stacking
+        * timers.
+        *
+        * `code` is the provider's own, from `streamSignals.listSignals`. An
+        * unknown code is REFUSED rather than treated as a wildcard wake — a
+        * provider and an operator disagreeing about a name must not become a
+        * camera that wakes for everything.
+        */
+        reportStreamSignal: method(zod.z.object({
+          deviceId: zod.z.number().int().nonnegative(),
+          /** The provider's signal code. */
+          code: zod.z.string().min(1),
+          /** Ms epoch. Absent ⇒ now. */
+          at: zod.z.number().optional()
+        }), zod.z.object({
+          /** Whether the broker acted on it, and if not, why. */
+          accepted: zod.z.boolean(),
+          reason: zod.z.enum([
+            "woke",
+            "hold-extended",
+            "not-enabled",
+            "no-consumer",
+            "unknown-code"
+          ])
+        }), { kind: "mutation" }),
         publishCameraStream: method(zod.z.object({
           deviceId: zod.z.number().int().nonnegative(),
           camStreamId: zod.z.string().min(1),
@@ -30275,6 +30349,16 @@ var require_dist_DUSfUAgz = __commonJS({
       acceptCodecs: zod.z.array(StreamCodecSchema).readonly().optional(),
       /** Minimum vertical resolution. Streams shorter than this are dropped. */
       minHeight: zod.z.number().int().positive().optional(),
+      /**
+      * Maximum vertical resolution. Streams TALLER than this are dropped.
+      *
+      * A consumer can have a ceiling as real as its floor: Alexa documents
+      * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
+      * Without this the ceiling had to be re-implemented by every caller — and
+      * one caller implementing it privately is how a second scoring authority
+      * gets born.
+      */
+      maxHeight: zod.z.number().int().positive().optional(),
       /** Minimum horizontal resolution. */
       minWidth: zod.z.number().int().positive().optional(),
       /**
@@ -30291,7 +30375,22 @@ var require_dist_DUSfUAgz = __commonJS({
       * transcoded" guard: if the device is already serving the consumer's
       * codec end-to-end, there's nothing to optimise.
       */
-      requireSiblingCodec: zod.z.array(StreamCodecSchema).readonly().optional()
+      requireSiblingCodec: zod.z.array(StreamCodecSchema).readonly().optional(),
+      /**
+      * Whether a stream the consumer CANNOT decode may still be picked, on the
+      * understanding that it will be transcoded.
+      *
+      * Default `false` — today's behaviour, and the right one for a bypass
+      * question ("is there a stream I can forward untouched?"). Set `true` to
+      * ask the larger question: "what is the best stream for me, transcoding if
+      * I must?" A stream that satisfies `acceptCodecs` always outranks one that
+      * does not, so a passthrough is never lost to a transcode; the answer says
+      * which it is in {@link PickedCamStreamSchema.transcodes}.
+      *
+      * This is what lets one picker serve both the bypass and the full source
+      * choice, instead of a consumer scoring privately when the bypass misses.
+      */
+      allowTranscode: zod.z.boolean().optional()
     }).readonly();
     var PickStreamPreferencesSchema = zod.z.object({
       /**
@@ -30305,12 +30404,32 @@ var require_dist_DUSfUAgz = __commonJS({
       * picks the tallest stream; `'lowest'` picks the shortest (used by
       * memory-constrained consumers / Apple Home guest sessions).
       */
-      resolutionPreference: zod.z.enum(["highest", "lowest"]).optional()
+      resolutionPreference: zod.z.enum(["highest", "lowest"]).optional(),
+      /**
+      * The height the consumer actually wants to DELIVER.
+      *
+      * Not a constraint — an ordering. With it set, the SMALLEST stream at or
+      * above the target wins, and only if nothing reaches it does the tallest
+      * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
+      * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
+      * express that: it says "as big as possible", which is a different wish.
+      *
+      * Ignored when absent, so every existing caller keeps its ordering.
+      */
+      targetHeight: zod.z.number().int().positive().optional()
     }).readonly();
     var PickedCamStreamSchema = zod.z.object({
       camStreamId: zod.z.string(),
       codec: zod.z.string().optional(),
       resolution: CamStreamResolutionSchema.optional(),
+      /**
+      * Whether serving this stream requires a decode + re-encode.
+      *
+      * `false` is a stream the consumer can take as it stands. Only ever `true`
+      * when the caller asked for it with `allowTranscode`, so a caller that did
+      * not ask cannot be handed a cost it never agreed to pay.
+      */
+      transcodes: zod.z.boolean(),
       /** One-line explanation of why this stream won — for logs / debug UI. */
       reason: zod.z.string()
     });
@@ -35224,6 +35343,8 @@ var require_dist_DUSfUAgz = __commonJS({
       "device-enabled",
       "device-battery-low",
       "device-battery-normal",
+      "device-consumable-low",
+      "device-consumable-normal",
       "stream-online",
       "stream-offline",
       "node-online",
@@ -35242,6 +35363,7 @@ var require_dist_DUSfUAgz = __commonJS({
       "addon-updated",
       "server-updated",
       "export-completed",
+      "backup-completed",
       "camera-online",
       "camera-offline",
       "camera-disabled",
@@ -42830,10 +42952,28 @@ var require_dist_DUSfUAgz = __commonJS({
         getSessionState: method(zod.z.object({
           deviceId: zod.z.number().int().nonnegative(),
           sessionId: zod.z.string()
-        }), zod.z.object({ pendingRenegotiation: zod.z.object({
-          target: WebrtcStreamTargetSchema,
-          epoch: zod.z.number()
-        }).nullable() }))
+        }), zod.z.object({
+          pendingRenegotiation: zod.z.object({
+            target: WebrtcStreamTargetSchema,
+            epoch: zod.z.number()
+          }).nullable(),
+          /**
+          * Whether the session still EXISTS.
+          *
+          * A consumer that holds a resource for the life of a session needs to
+          * be able to ask, because a session does not always end the way it
+          * began. Measured on this hub 2026-09-13: an Echo that got stuck never
+          * sent `SessionDisconnected`, so the Alexa exporter's
+          * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
+          * H.264 transcode kept running for NOBODY for more than twenty
+          * minutes. The WebRTC session had logged `WebRTC session closed`
+          * minutes earlier — the broker knew; the holder had no way to ask.
+          *
+          * `false` for a session id the provider has never heard of, which is
+          * the same answer as "it ended": either way nothing is holding it up.
+          */
+          alive: zod.z.boolean()
+        }))
       },
       /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
       mount: { kind: "server-provided" }
@@ -52506,6 +52646,7 @@ var require_dist_DUSfUAgz = __commonJS({
       streamBrokerCapability,
       streamCatalogCapability,
       streamParamsCapability,
+      streamSignalsCapability,
       switchCapability,
       systemCapability,
       tamperCapability,
@@ -57948,6 +58089,12 @@ var require_dist_DUSfUAgz = __commonJS({
         addonId: null,
         access: "create"
       },
+      "streamBroker.reportStreamSignal": {
+        capName: "stream-broker",
+        capScope: "system",
+        addonId: null,
+        access: "create"
+      },
       "streamBroker.restartProfile": {
         capName: "stream-broker",
         capScope: "system",
@@ -58032,6 +58179,12 @@ var require_dist_DUSfUAgz = __commonJS({
         addonId: null,
         access: "create"
       },
+      "streamSignals.listSignals": {
+        capName: "stream-signals",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "switch.setState": {
         capName: "switch",
         capScope: "device",
@@ -60404,6 +60557,11 @@ var require_dist_DUSfUAgz = __commonJS({
         form: "single",
         optional: false
       }],
+      "streamBroker.reportStreamSignal": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "streamBroker.restartProfile": [{
         name: "deviceId",
         form: "single",
@@ -60855,6 +61013,10 @@ var require_dist_DUSfUAgz = __commonJS({
         durability: "restored",
         volatileFields: ["lastFetchedAt"]
       },
+      "stream-signals": {
+        durability: "session",
+        volatileFields: []
+      },
       "switch": {
         durability: "restored",
         volatileFields: ["lastChangedAt"]
@@ -62139,7 +62301,7 @@ var require_alerts_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     function selectExpired(alerts, cutoffMs) {
       return alerts.filter((a) => a.createdAt < cutoffMs).sort((a, b) => a.createdAt - b.createdAt).map((a) => a.id);
     }
@@ -62958,7 +63120,7 @@ var require_console_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var require_formatter = require_formatter_DqAKDlvN();
     var LEVEL_RANK = {
       debug: 0,
@@ -63052,7 +63214,7 @@ var require_core_blocks_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     node_fs_promises = require_chunk.__toESM(node_fs_promises);
@@ -63949,11 +64111,11 @@ var require_core_blocks = __commonJS({
   }
 });
 
-// ../system/dist/retired-settings-keys-D61PxN8L.js
-var require_retired_settings_keys_D61PxN8L = __commonJS({
-  "../system/dist/retired-settings-keys-D61PxN8L.js"(exports) {
+// ../system/dist/retired-settings-keys-FLZlwa2U.js
+var require_retired_settings_keys_FLZlwa2U = __commonJS({
+  "../system/dist/retired-settings-keys-FLZlwa2U.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     function settingsStoreIsAuthoritativeHere(env) {
       const raw = (env["CAMSTACK_ROLE"] ?? "").trim().toLowerCase();
       return raw === "" || raw === "hub";
@@ -66190,8 +66352,8 @@ var require_device_manager_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
-    var require_retired_settings_keys = require_retired_settings_keys_D61PxN8L();
+    var require_dist10 = require_dist_CEIkHEdy();
+    var require_retired_settings_keys = require_retired_settings_keys_FLZlwa2U();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
     var JOB_HISTORY = 20;
@@ -71816,7 +71978,7 @@ var require_hub_forwarder = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var require_formatter = require_formatter_DqAKDlvN();
     var DEFAULT_OUTBOUND_BUFFER_SIZE = 500;
     var HubForwarderDestination = class {
@@ -71953,7 +72115,7 @@ var require_liveness_monitor_addon = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var NO_DEVICES = "liveness:no-devices";
     var ALL_OFFLINE = "liveness:all-devices-offline";
     var NO_FOOTAGE_PREFIX = "liveness:no-footage:";
@@ -72149,7 +72311,7 @@ var require_local_auth_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var node_crypto = __require("crypto");
     node_crypto = require_chunk.__toESM(node_crypto);
     var crypto$1 = __require("crypto");
@@ -79962,7 +80124,7 @@ var require_loki_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     function sanitizeLabelName(raw) {
       const replaced = raw.replaceAll(/[^a-zA-Z0-9_]/g, "_");
       return /^[a-zA-Z_]/.test(replaced) ? replaced : `_${replaced}`;
@@ -80549,7 +80711,7 @@ var require_native_metrics_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var node_fs_promises = __require("fs/promises");
     var node_fs = __require("fs");
     node_fs = require_chunk.__toESM(node_fs);
@@ -83302,7 +83464,7 @@ var require_filesystem_storage_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var node_crypto = __require("crypto");
     var node_fs_promises = __require("fs/promises");
     var node_path = __require("path");
@@ -84529,8 +84691,8 @@ var require_sqlite_settings_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
-    var require_retired_settings_keys = require_retired_settings_keys_D61PxN8L();
+    var require_dist10 = require_dist_CEIkHEdy();
+    var require_retired_settings_keys = require_retired_settings_keys_FLZlwa2U();
     var require_wal_checkpoint_policy = require_wal_checkpoint_policy_CCJZngds();
     var node_crypto = __require("crypto");
     var node_path = __require("path");
@@ -87317,7 +87479,7 @@ var require_storage_orchestrator_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var require_hub_cap_forward = require_hub_cap_forward_DmHNjbB0();
     var zod = require_zod();
     var node_crypto = __require("crypto");
@@ -91044,7 +91206,7 @@ var require_system_config_addon = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var SECTION_TITLES = {
       server: "Server",
       auth: "Authentication"
@@ -109105,7 +109267,7 @@ var require_winston_logging = __commonJS({
       [Symbol.toStringTag]: { value: "Module" }
     });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var require_formatter = require_formatter_DqAKDlvN();
     var node_path = __require("path");
     node_path = require_chunk.__toESM(node_path);
@@ -110974,9 +111136,9 @@ ${(0, node_fs.readFileSync)(ca.caCertPath, "utf-8").trimEnd()}
   }
 });
 
-// ../types/dist/event-category-yW4s1MGD.js
-var require_event_category_yW4s1MGD = __commonJS({
-  "../types/dist/event-category-yW4s1MGD.js"(exports) {
+// ../types/dist/event-category-BVfsrBYA.js
+var require_event_category_BVfsrBYA = __commonJS({
+  "../types/dist/event-category-BVfsrBYA.js"(exports) {
     "use strict";
     var EventCategory = /* @__PURE__ */ (function(EventCategory2) {
       EventCategory2["SystemBoot"] = "system.boot";
@@ -111116,6 +111278,7 @@ var require_event_category_yW4s1MGD = __commonJS({
       EventCategory2["LocalNetworkChanged"] = "network.local.changed";
       EventCategory2["MeshNetworkChanged"] = "network.mesh.changed";
       EventCategory2["BackupCompleted"] = "backup.completed";
+      EventCategory2["BackupRunCompleted"] = "backup.run-completed";
       EventCategory2["BackupRestored"] = "backup.restored";
       EventCategory2["NotificationDispatched"] = "notification.dispatched";
       EventCategory2["NotificationFailed"] = "notification.failed";
@@ -111142,11 +111305,11 @@ var require_event_category_yW4s1MGD = __commonJS({
   }
 });
 
-// ../types/dist/sleep-DXsYD0RX.js
-var require_sleep_DXsYD0RX = __commonJS({
-  "../types/dist/sleep-DXsYD0RX.js"(exports) {
+// ../types/dist/sleep-D7dV-FZB.js
+var require_sleep_D7dV_FZB = __commonJS({
+  "../types/dist/sleep-D7dV-FZB.js"(exports) {
     "use strict";
-    var require_event_category = require_event_category_yW4s1MGD();
+    var require_event_category = require_event_category_BVfsrBYA();
     var zod = require_zod();
     var AUDIO_CHUNK_FORMATS = [
       "f32le",
@@ -113641,6 +113804,7 @@ var require_sleep_DXsYD0RX = __commonJS({
           smoke: createSliceHandle(stateSource, binding.deviceId, "smoke"),
           streamCatalog: createSliceHandle(stateSource, binding.deviceId, "stream-catalog"),
           streamParams: createSliceHandle(stateSource, binding.deviceId, "stream-params"),
+          streamSignals: createSliceHandle(stateSource, binding.deviceId, "stream-signals"),
           switch: createSliceHandle(stateSource, binding.deviceId, "switch"),
           tamper: createSliceHandle(stateSource, binding.deviceId, "tamper"),
           temperatureSensor: createSliceHandle(stateSource, binding.deviceId, "temperature-sensor"),
@@ -114055,6 +114219,7 @@ var require_sleep_DXsYD0RX = __commonJS({
           getConfigSchema: (input) => dispatch("stream-params", "streamParams", "getConfigSchema", "query", input),
           getStatus: (input) => dispatch("stream-params", "streamParams", "getStatus", "query", input)
         },
+        streamSignals: { listSignals: (input) => dispatch("stream-signals", "streamSignals", "listSignals", "query", input) },
         switch: {
           setState: (input) => dispatch("switch", "switch", "setState", "mutation", input),
           getStatus: (input) => dispatch("switch", "switch", "getStatus", "query", input)
@@ -114264,6 +114429,7 @@ var require_sleep_DXsYD0RX = __commonJS({
         },
         recordingExport: { listExports: (input) => dispatchSystem("recordingExport", "listExports", "query", input) },
         streamBroker: {
+          reportStreamSignal: (input) => dispatchSystem("streamBroker", "reportStreamSignal", "mutation", input),
           publishCameraStream: (input) => dispatchSystem("streamBroker", "publishCameraStream", "mutation", input),
           retractCameraStream: (input) => dispatchSystem("streamBroker", "retractCameraStream", "mutation", input),
           assignProfile: (input) => dispatchSystem("streamBroker", "assignProfile", "mutation", input),
@@ -114350,6 +114516,7 @@ var require_sleep_DXsYD0RX = __commonJS({
       "snapshot",
       "stream-catalog",
       "stream-params",
+      "stream-signals",
       "switch",
       "tamper",
       "temperature-sensor",
@@ -114977,8 +115144,8 @@ var require_addon = __commonJS({
   "../types/dist/addon.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_sleep = require_sleep_DXsYD0RX();
-    var require_event_category = require_event_category_yW4s1MGD();
+    var require_sleep = require_sleep_D7dV_FZB();
+    var require_event_category = require_event_category_BVfsrBYA();
     var require_err_msg = require_err_msg_COpsHMw2();
     var CAP_INPUT_DEFAULTS = Object.freeze({
       "addons": { "getLogs": { "limit": 100 } },
@@ -131387,11 +131554,11 @@ var require_manifest_system_deps_CrSP0Kkp = __commonJS({
   }
 });
 
-// ../system/dist/custom-action-registry-DAFhWd0h.js
-var require_custom_action_registry_DAFhWd0h = __commonJS({
-  "../system/dist/custom-action-registry-DAFhWd0h.js"(exports) {
+// ../system/dist/custom-action-registry-YHpAdksL.js
+var require_custom_action_registry_YHpAdksL = __commonJS({
+  "../system/dist/custom-action-registry-YHpAdksL.js"(exports) {
     "use strict";
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var CustomActionRegistry = class {
       byAddon = /* @__PURE__ */ new Map();
       registerAddon(addonId, catalog, handler) {
@@ -135205,7 +135372,7 @@ var require_dist3 = __commonJS({
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
     var require_chunk = require_chunk_Cek0wNdY();
-    var require_dist10 = require_dist_DUSfUAgz();
+    var require_dist10 = require_dist_CEIkHEdy();
     var require_builtins_alerts_alerts_addon = require_alerts_addon();
     require_alerts();
     var require_formatter = require_formatter_DqAKDlvN();
@@ -135234,7 +135401,7 @@ var require_dist3 = __commonJS({
     var require_tls$1 = require_tls_BFs4PzoW();
     var require_manifest_system_deps = require_manifest_system_deps_CrSP0Kkp();
     var require_resource_monitor = require_resource_monitor_LVE1BoLs();
-    var require_custom_action_registry = require_custom_action_registry_DAFhWd0h();
+    var require_custom_action_registry = require_custom_action_registry_YHpAdksL();
     var zod = require_zod();
     var node_crypto = __require("crypto");
     var _camstack_types_node = require_node();
@@ -216323,7 +216490,7 @@ var require_enums = __commonJS({
   "../types/dist/enums.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_event_category = require_event_category_yW4s1MGD();
+    var require_event_category = require_event_category_BVfsrBYA();
     var EventSourceType = /* @__PURE__ */ (function(EventSourceType2) {
       EventSourceType2["Addon"] = "addon";
       EventSourceType2["Core"] = "core";
@@ -216343,8 +216510,8 @@ var require_dist4 = __commonJS({
   "../types/dist/index.js"(exports) {
     "use strict";
     Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-    var require_sleep = require_sleep_DXsYD0RX();
-    var require_event_category = require_event_category_yW4s1MGD();
+    var require_sleep = require_sleep_D7dV_FZB();
+    var require_event_category = require_event_category_BVfsrBYA();
     var require_canonical_hash = require_canonical_hash_9lydiEzx();
     var require_enums2 = require_enums();
     var require_err_msg = require_err_msg_COpsHMw2();
@@ -216586,6 +216753,50 @@ var require_dist4 = __commonJS({
         audio: "passthrough"
       };
     }
+    function compareToTarget(a, b, target) {
+      const aReaches = a >= target;
+      if (aReaches !== b >= target) return aReaches ? -1 : 1;
+      return aReaches ? a - b : b - a;
+    }
+    function canonicalCodec(value) {
+      const v = value.toLowerCase().replace(/[.\s-]/g, "");
+      if (v === "hevc" || v === "hvc1" || v === "hev1") return "h265";
+      if (v === "avc" || v === "avc1") return "h264";
+      return v;
+    }
+    function codecIsAccepted(codec, accept) {
+      if (accept.length === 0) return true;
+      if (codec === void 0) return false;
+      const c = canonicalCodec(codec);
+      return accept.some((a) => canonicalCodec(a) === c);
+    }
+    function providerRank(camStreamId, preferred) {
+      for (let i = 0; i < preferred.length; i += 1) if (camStreamId.startsWith(preferred[i])) return i;
+      return preferred.length;
+    }
+    function rankStreams(candidates, ranking) {
+      const usable = candidates.filter((c) => ranking.allowTranscode || codecIsAccepted(c.codec, ranking.acceptCodecs));
+      if (usable.length === 0) return null;
+      const target = ranking.targetHeight;
+      const scored = usable.map((candidate) => ({
+        candidate,
+        transcodes: !codecIsAccepted(candidate.codec, ranking.acceptCodecs),
+        provider: providerRank(candidate.camStreamId, ranking.preferredProviders),
+        height: candidate.height ?? 0
+      }));
+      scored.sort((a, b) => {
+        if (a.transcodes !== b.transcodes) return a.transcodes ? 1 : -1;
+        if (a.provider !== b.provider) return a.provider - b.provider;
+        if (target !== void 0) return compareToTarget(a.height, b.height, target);
+        return ranking.resolutionPreference === "highest" ? b.height - a.height : a.height - b.height;
+      });
+      const winner = scored[0];
+      if (winner === void 0) return null;
+      return {
+        candidate: winner.candidate,
+        transcodes: winner.transcodes
+      };
+    }
     var BASE_LIVE_EGRESS_PROFILE = {
       video: {
         codec: "h264",
@@ -219104,22 +219315,10 @@ var require_dist4 = __commonJS({
     }
     function pickClosestResolution(entries2, target) {
       const targetPixels = target.width * target.height;
-      let bestAbove;
-      let bestBelow;
-      for (const e of entries2) {
-        if (e.resolution === void 0) continue;
-        const pixels = e.resolution.width * e.resolution.height;
-        if (pixels >= targetPixels) {
-          if (!bestAbove || pixels < bestAbove.pixels) bestAbove = {
-            entry: e,
-            pixels
-          };
-        } else if (!bestBelow || pixels > bestBelow.pixels) bestBelow = {
-          entry: e,
-          pixels
-        };
-      }
-      return bestAbove?.entry ?? bestBelow?.entry;
+      return [...entries2.flatMap((entry) => entry.resolution === void 0 ? [] : [{
+        entry,
+        pixels: entry.resolution.width * entry.resolution.height
+      }])].sort((a, b) => compareToTarget(a.pixels, b.pixels, targetPixels))[0]?.entry;
     }
     var FORMAT_KEYS = [
       "onnx",
@@ -221981,6 +222180,39 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       exposesDeviceSettings: true,
       methods: {}
     };
+    var StreamSignalSchema = zod.z.object({
+      /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
+      code: zod.z.string().min(1),
+      /** What an operator reads in the picker. The provider's own wording. */
+      label: zod.z.string().min(1),
+      /**
+      * Whether the provider recommends this signal ON when a camera is first set
+      * up. A provider knows which of its signals are cheap and reliable; an
+      * operator should not have to discover that by trial. Reolink recommends
+      * both of its own.
+      */
+      recommended: zod.z.boolean()
+    });
+    var StreamSignalsStatusSchema = zod.z.object({
+      signals: zod.z.array(StreamSignalSchema),
+      lastFetchedAt: zod.z.number()
+    });
+    var streamSignalsCapability = {
+      name: "stream-signals",
+      scope: "device",
+      deviceNative: true,
+      mode: "singleton",
+      deviceTypes: Object.values(require_sleep.DeviceType),
+      runtimeState: StreamSignalsStatusSchema,
+      methods: {
+        /**
+        * What this device can emit. Empty is a valid and common answer — most
+        * cameras have nothing to offer here, and an empty list is what makes the
+        * broker's picker show nothing rather than a false choice.
+        */
+        listSignals: require_sleep.method(zod.z.void(), zod.z.array(StreamSignalSchema).readonly())
+      }
+    };
     var StreamFormatSchema = zod.z.enum([
       "webrtc",
       "hls",
@@ -222333,6 +222565,46 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       mode: "singleton",
       exposesDeviceSettings: true,
       methods: {
+        /**
+        * A device reporting that one of ITS OWN signals just fired.
+        *
+        * The provider calls this; nothing polls. The broker then decides whether
+        * to wake the source, and the decision has two terms that must BOTH hold:
+        *
+        *  - the signal is ENABLED for this camera (the operator's per-camera
+        *    choice — a camera may declare a signal the operator does not want
+        *    waking anything), and
+        *  - a consumer is actually attached and waiting on the prestream. Waking
+        *    a camera nobody is watching is the one thing a battery camera must
+        *    never do, and a signal arriving with no consumer is exactly that.
+        *
+        * Reported, never inferred: a signal that fires while the stream is
+        * already up refreshes the hold instead of starting a second one, which is
+        * what makes continuous motion keep a camera awake without stacking
+        * timers.
+        *
+        * `code` is the provider's own, from `streamSignals.listSignals`. An
+        * unknown code is REFUSED rather than treated as a wildcard wake — a
+        * provider and an operator disagreeing about a name must not become a
+        * camera that wakes for everything.
+        */
+        reportStreamSignal: require_sleep.method(zod.z.object({
+          deviceId: zod.z.number().int().nonnegative(),
+          /** The provider's signal code. */
+          code: zod.z.string().min(1),
+          /** Ms epoch. Absent ⇒ now. */
+          at: zod.z.number().optional()
+        }), zod.z.object({
+          /** Whether the broker acted on it, and if not, why. */
+          accepted: zod.z.boolean(),
+          reason: zod.z.enum([
+            "woke",
+            "hold-extended",
+            "not-enabled",
+            "no-consumer",
+            "unknown-code"
+          ])
+        }), { kind: "mutation" }),
         publishCameraStream: require_sleep.method(zod.z.object({
           deviceId: zod.z.number().int().nonnegative(),
           camStreamId: zod.z.string().min(1),
@@ -222810,6 +223082,16 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       acceptCodecs: zod.z.array(StreamCodecSchema).readonly().optional(),
       /** Minimum vertical resolution. Streams shorter than this are dropped. */
       minHeight: zod.z.number().int().positive().optional(),
+      /**
+      * Maximum vertical resolution. Streams TALLER than this are dropped.
+      *
+      * A consumer can have a ceiling as real as its floor: Alexa documents
+      * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
+      * Without this the ceiling had to be re-implemented by every caller — and
+      * one caller implementing it privately is how a second scoring authority
+      * gets born.
+      */
+      maxHeight: zod.z.number().int().positive().optional(),
       /** Minimum horizontal resolution. */
       minWidth: zod.z.number().int().positive().optional(),
       /**
@@ -222826,7 +223108,22 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       * transcoded" guard: if the device is already serving the consumer's
       * codec end-to-end, there's nothing to optimise.
       */
-      requireSiblingCodec: zod.z.array(StreamCodecSchema).readonly().optional()
+      requireSiblingCodec: zod.z.array(StreamCodecSchema).readonly().optional(),
+      /**
+      * Whether a stream the consumer CANNOT decode may still be picked, on the
+      * understanding that it will be transcoded.
+      *
+      * Default `false` — today's behaviour, and the right one for a bypass
+      * question ("is there a stream I can forward untouched?"). Set `true` to
+      * ask the larger question: "what is the best stream for me, transcoding if
+      * I must?" A stream that satisfies `acceptCodecs` always outranks one that
+      * does not, so a passthrough is never lost to a transcode; the answer says
+      * which it is in {@link PickedCamStreamSchema.transcodes}.
+      *
+      * This is what lets one picker serve both the bypass and the full source
+      * choice, instead of a consumer scoring privately when the bypass misses.
+      */
+      allowTranscode: zod.z.boolean().optional()
     }).readonly();
     var PickStreamPreferencesSchema = zod.z.object({
       /**
@@ -222840,12 +223137,32 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       * picks the tallest stream; `'lowest'` picks the shortest (used by
       * memory-constrained consumers / Apple Home guest sessions).
       */
-      resolutionPreference: zod.z.enum(["highest", "lowest"]).optional()
+      resolutionPreference: zod.z.enum(["highest", "lowest"]).optional(),
+      /**
+      * The height the consumer actually wants to DELIVER.
+      *
+      * Not a constraint — an ordering. With it set, the SMALLEST stream at or
+      * above the target wins, and only if nothing reaches it does the tallest
+      * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
+      * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
+      * express that: it says "as big as possible", which is a different wish.
+      *
+      * Ignored when absent, so every existing caller keeps its ordering.
+      */
+      targetHeight: zod.z.number().int().positive().optional()
     }).readonly();
     var PickedCamStreamSchema = zod.z.object({
       camStreamId: zod.z.string(),
       codec: zod.z.string().optional(),
       resolution: require_sleep.CamStreamResolutionSchema.optional(),
+      /**
+      * Whether serving this stream requires a decode + re-encode.
+      *
+      * `false` is a stream the consumer can take as it stands. Only ever `true`
+      * when the caller asked for it with `allowTranscode`, so a caller that did
+      * not ask cannot be handed a cost it never agreed to pay.
+      */
+      transcodes: zod.z.boolean(),
       /** One-line explanation of why this stream won — for logs / debug UI. */
       reason: zod.z.string()
     });
@@ -228224,6 +228541,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "device-enabled",
       "device-battery-low",
       "device-battery-normal",
+      "device-consumable-low",
+      "device-consumable-normal",
       "stream-online",
       "stream-offline",
       "node-online",
@@ -228242,6 +228561,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "addon-updated",
       "server-updated",
       "export-completed",
+      "backup-completed",
       "camera-online",
       "camera-offline",
       "camera-disabled",
@@ -229103,10 +229423,22 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
             value: "server-updated",
             label: "Server updated"
           },
+          {
+            value: "device-consumable-low",
+            label: "Consumable low"
+          },
+          {
+            value: "device-consumable-normal",
+            label: "Consumable replaced"
+          },
           {
             value: "export-completed",
             label: "Export completed"
           },
+          {
+            value: "backup-completed",
+            label: "Backup completed"
+          },
           {
             value: "alarm-arming",
             label: "Alarm arming (exit delay)"
@@ -236491,10 +236823,28 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         getSessionState: require_sleep.method(zod.z.object({
           deviceId: zod.z.number().int().nonnegative(),
           sessionId: zod.z.string()
-        }), zod.z.object({ pendingRenegotiation: zod.z.object({
-          target: WebrtcStreamTargetSchema,
-          epoch: zod.z.number()
-        }).nullable() }))
+        }), zod.z.object({
+          pendingRenegotiation: zod.z.object({
+            target: WebrtcStreamTargetSchema,
+            epoch: zod.z.number()
+          }).nullable(),
+          /**
+          * Whether the session still EXISTS.
+          *
+          * A consumer that holds a resource for the life of a session needs to
+          * be able to ask, because a session does not always end the way it
+          * began. Measured on this hub 2026-09-13: an Echo that got stuck never
+          * sent `SessionDisconnected`, so the Alexa exporter's
+          * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
+          * H.264 transcode kept running for NOBODY for more than twenty
+          * minutes. The WebRTC session had logged `WebRTC session closed`
+          * minutes earlier — the broker knew; the holder had no way to ask.
+          *
+          * `false` for a session id the provider has never heard of, which is
+          * the same answer as "it ended": either way nothing is holding it up.
+          */
+          alive: zod.z.boolean()
+        }))
       },
       /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
       mount: { kind: "server-provided" }
@@ -246161,6 +246511,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       smoke: smokeCapability,
       streamCatalog: streamCatalogCapability,
       streamParams: streamParamsCapability,
+      streamSignals: streamSignalsCapability,
       switch: switchCapability,
       tamper: tamperCapability,
       temperatureSensor: temperatureSensorCapability,
@@ -248898,6 +249249,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       streamBroker: "stream-broker",
       streamCatalog: "stream-catalog",
       streamParams: "stream-params",
+      streamSignals: "stream-signals",
       switch: "switch",
       system: "system",
       tamper: "tamper",
@@ -249458,6 +249810,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         key: "streamParams",
         name: "stream-params"
       },
+      {
+        key: "streamSignals",
+        name: "stream-signals"
+      },
       {
         key: "switch",
         name: "switch"
@@ -249682,6 +250038,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       streamBrokerCapability,
       streamCatalogCapability,
       streamParamsCapability,
+      streamSignalsCapability,
       switchCapability,
       systemCapability,
       tamperCapability,
@@ -255124,6 +255481,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "create"
       },
+      "streamBroker.reportStreamSignal": {
+        capName: "stream-broker",
+        capScope: "system",
+        addonId: null,
+        access: "create"
+      },
       "streamBroker.restartProfile": {
         capName: "stream-broker",
         capScope: "system",
@@ -255208,6 +255571,12 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         addonId: null,
         access: "create"
       },
+      "streamSignals.listSignals": {
+        capName: "stream-signals",
+        capScope: "device",
+        addonId: null,
+        access: "view"
+      },
       "switch.setState": {
         capName: "switch",
         capScope: "device",
@@ -256011,6 +256380,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "stream-broker",
       "stream-catalog",
       "stream-params",
+      "stream-signals",
       "switch",
       "system",
       "terminal-session",
@@ -256077,6 +256447,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "snapshot",
       "stream-catalog",
       "stream-params",
+      "stream-signals",
       "switch",
       "update",
       "vacuum-control",
@@ -257844,6 +258215,11 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         form: "single",
         optional: false
       }],
+      "streamBroker.reportStreamSignal": [{
+        name: "deviceId",
+        form: "single",
+        optional: false
+      }],
       "streamBroker.restartProfile": [{
         name: "deviceId",
         form: "single",
@@ -258201,6 +258577,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
       "streamBroker.produceEventMedia",
       "streamBroker.publishCameraStream",
       "streamBroker.renderPreBufferClip",
+      "streamBroker.reportStreamSignal",
       "streamBroker.restartProfile",
       "streamBroker.retractCameraStream",
       "streamBroker.setDeviceAudioMute",
@@ -258450,6 +258827,10 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
         durability: "restored",
         volatileFields: ["lastFetchedAt"]
       },
+      "stream-signals": {
+        durability: "session",
+        volatileFields: []
+      },
       "switch": {
         durability: "restored",
         volatileFields: ["lastChangedAt"]
@@ -262908,6 +263289,8 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.StreamProfileOptionsSchema = StreamProfileOptionsSchema;
     exports.StreamProfilePatchSchema = StreamProfilePatchSchema;
     exports.StreamProfileSchema = StreamProfileSchema;
+    exports.StreamSignalSchema = StreamSignalSchema;
+    exports.StreamSignalsStatusSchema = StreamSignalsStatusSchema;
     exports.StreamSourceEntrySchema = require_sleep.StreamSourceEntrySchema;
     exports.StreamSourceSchema = require_sleep.StreamSourceSchema;
     exports.SubscribeAudioChunksInputSchema = require_sleep.SubscribeAudioChunksInputSchema;
@@ -263093,12 +263476,14 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.clusterModelSettingKey = clusterModelSettingKey;
     exports.clusterStepSettingFieldsFor = clusterStepSettingFieldsFor;
     exports.clusterStepSettingKey = clusterStepSettingKey;
+    exports.codecIsAccepted = codecIsAccepted;
     exports.collectHydratedFieldEntries = require_sleep.collectHydratedFieldEntries;
     exports.collectHydratedFieldValues = require_sleep.collectHydratedFieldValues;
     exports.collectSecretConfigKeys = collectSecretConfigKeys;
     exports.colorCapability = colorCapability;
     exports.colorForKind = colorForKind;
     exports.commitWatchdogRestart = commitWatchdogRestart;
+    exports.compareToTarget = compareToTarget;
     exports.compileExpression = compileExpression;
     exports.compileExpressionSafe = compileExpressionSafe;
     exports.composeSwitchedOff = composeSwitchedOff;
@@ -263357,6 +263742,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.ptzAutotrackCapability = ptzAutotrackCapability;
     exports.ptzCapability = ptzCapability;
     exports.pythonScriptForBackend = pythonScriptForBackend;
+    exports.rankStreams = rankStreams;
     exports.readClusterStepModels = readClusterStepModels;
     exports.readClusterStepSettings = readClusterStepSettings;
     exports.readDetailCropConvention = readDetailCropConvention;
@@ -263441,6 +263827,7 @@ ${recipe.triggers.map((t, i) => emitTrigger(t, i)).join("\n\n")}
     exports.streamParamsCapability = streamParamsCapability;
     exports.streamPixels = streamPixels;
     exports.streamQualityLabel = streamQualityLabel;
+    exports.streamSignalsCapability = streamSignalsCapability;
     exports.stripRetiredBandPreBufferSec = stripRetiredBandPreBufferSec;
     exports.strippedOfLegacyReadOnly = strippedOfLegacyReadOnly;
     exports.subKindsOf = subKindsOf;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.2.146",
+  "version": "1.2.149",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",