@camstack/addon-post-analysis 1.2.234 → 1.2.235

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-ZyX6jcse.mjs
1
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -615,6 +615,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
615
615
  * pull-reconcile from the provider's `getStatus` on reconnect. */
616
616
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
617
617
  EventCategory["BackupCompleted"] = "backup.completed";
618
+ /**
619
+ * A whole backup RUN finished — every destination attempted, win or lose.
620
+ *
621
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
622
+ * a progress UI and the wrong one for a notification: an operator with three
623
+ * destinations would be told three times. And a run where two of three
624
+ * destinations succeeded is not a clean success — a single "backup
625
+ * completed" that hid the failed one would be a lie, so the count of each is
626
+ * carried here and the message says both.
627
+ *
628
+ * Emitted by the backup orchestrator only after the destination loop, so a
629
+ * run that dies during the BUILD phase produces no completion at all.
630
+ */
631
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
618
632
  EventCategory["BackupRestored"] = "backup.restored";
619
633
  EventCategory["NotificationDispatched"] = "notification.dispatched";
620
634
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5345,7 +5359,7 @@ var ZodIssueCode = {
5345
5359
  var ZodFirstPartyTypeKind;
5346
5360
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5347
5361
  //#endregion
5348
- //#region ../types/dist/sleep-DBKu2-U5.mjs
5362
+ //#region ../types/dist/sleep-DEuj7E3j.mjs
5349
5363
  /**
5350
5364
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5351
5365
  * window to float samples (D455).
@@ -7356,7 +7370,7 @@ method(object({ deviceId: number() }), array(StreamSourceEntrySchema)), method(o
7356
7370
  * can answer "may a rule actuate this?" without importing the schema barrel
7357
7371
  * (~144MB RSS per runner, D28).
7358
7372
  *
7359
- * Coverage: 83 device-scoped capabilities.
7373
+ * Coverage: 84 device-scoped capabilities.
7360
7374
  */
7361
7375
  var DEVICE_SCOPED_CAPS = new Set([
7362
7376
  "accessories",
@@ -7428,6 +7442,7 @@ var DEVICE_SCOPED_CAPS = new Set([
7428
7442
  "snapshot",
7429
7443
  "stream-catalog",
7430
7444
  "stream-params",
7445
+ "stream-signals",
7431
7446
  "switch",
7432
7447
  "tamper",
7433
7448
  "temperature-sensor",
@@ -12073,6 +12088,72 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
12073
12088
  auth: "admin"
12074
12089
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
12075
12090
  DeviceType.Camera;
12091
+ /**
12092
+ * The signals a device can emit to WAKE its own stream.
12093
+ *
12094
+ * A camera whose stream is built on demand sleeps until something asks for it,
12095
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
12096
+ * puller holds a session open for ever, and treating that as demand would keep
12097
+ * a battery camera awake for ever, which is the whole thing the battery is for
12098
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
12099
+ * itself, with no stream running.
12100
+ *
12101
+ * ## The vocabulary is the PROVIDER'S, not ours
12102
+ *
12103
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
12104
+ * names each signal with a `code` it chooses and a `label` an operator reads.
12105
+ * Reolink offers motion and camera-native detection; another provider may offer
12106
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
12107
+ * yet. A fixed enum here would mean every new signal is a framework release.
12108
+ *
12109
+ * It is deliberately NOT derived from the caps a device already binds. Whether
12110
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
12111
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
12112
+ * binding — but both answer "what drives the detection pipeline", which is a
12113
+ * different question from "what may wake a sleeping stream". A camera can do
12114
+ * the first and not be trusted with the second, and the operator picks per
12115
+ * camera. Two questions, two authorities.
12116
+ *
12117
+ * ## Availability is not permission
12118
+ *
12119
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
12120
+ * wakes the stream is the operator's per-camera choice, held by the broker
12121
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
12122
+ * provider declaring a signal is not a provider enabling it.
12123
+ */
12124
+ /** One signal a device can emit. */
12125
+ var StreamSignalSchema = object({
12126
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
12127
+ code: string().min(1),
12128
+ /** What an operator reads in the picker. The provider's own wording. */
12129
+ label: string().min(1),
12130
+ /**
12131
+ * Whether the provider recommends this signal ON when a camera is first set
12132
+ * up. A provider knows which of its signals are cheap and reliable; an
12133
+ * operator should not have to discover that by trial. Reolink recommends
12134
+ * both of its own.
12135
+ */
12136
+ recommended: boolean()
12137
+ });
12138
+ var StreamSignalsStatusSchema = object({
12139
+ signals: array(StreamSignalSchema),
12140
+ lastFetchedAt: number()
12141
+ });
12142
+ var streamSignalsCapability = {
12143
+ name: "stream-signals",
12144
+ scope: "device",
12145
+ deviceNative: true,
12146
+ mode: "singleton",
12147
+ deviceTypes: Object.values(DeviceType),
12148
+ runtimeState: StreamSignalsStatusSchema,
12149
+ methods: {
12150
+ /**
12151
+ * What this device can emit. Empty is a valid and common answer — most
12152
+ * cameras have nothing to offer here, and an empty list is what makes the
12153
+ * broker's picker show nothing rather than a false choice.
12154
+ */
12155
+ listSignals: method(_void(), array(StreamSignalSchema).readonly()) }
12156
+ };
12076
12157
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
12077
12158
  var StreamFormatSchema = _enum([
12078
12159
  "webrtc",
@@ -12469,6 +12550,22 @@ var EgressTranscodeSchema = object({
12469
12550
  camStreamId: string().nullable()
12470
12551
  });
12471
12552
  method(object({
12553
+ deviceId: number().int().nonnegative(),
12554
+ /** The provider's signal code. */
12555
+ code: string().min(1),
12556
+ /** Ms epoch. Absent ⇒ now. */
12557
+ at: number().optional()
12558
+ }), object({
12559
+ /** Whether the broker acted on it, and if not, why. */
12560
+ accepted: boolean(),
12561
+ reason: _enum([
12562
+ "woke",
12563
+ "hold-extended",
12564
+ "not-enabled",
12565
+ "no-consumer",
12566
+ "unknown-code"
12567
+ ])
12568
+ }), { kind: "mutation" }), method(object({
12472
12569
  deviceId: number().int().nonnegative(),
12473
12570
  camStreamId: string().min(1),
12474
12571
  kind: CamStreamKindSchema,
@@ -12723,6 +12820,16 @@ var PickStreamRequirementsSchema = object({
12723
12820
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12724
12821
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12725
12822
  minHeight: number().int().positive().optional(),
12823
+ /**
12824
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12825
+ *
12826
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12827
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12828
+ * Without this the ceiling had to be re-implemented by every caller — and
12829
+ * one caller implementing it privately is how a second scoring authority
12830
+ * gets born.
12831
+ */
12832
+ maxHeight: number().int().positive().optional(),
12726
12833
  /** Minimum horizontal resolution. */
12727
12834
  minWidth: number().int().positive().optional(),
12728
12835
  /**
@@ -12739,7 +12846,22 @@ var PickStreamRequirementsSchema = object({
12739
12846
  * transcoded" guard: if the device is already serving the consumer's
12740
12847
  * codec end-to-end, there's nothing to optimise.
12741
12848
  */
12742
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12849
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12850
+ /**
12851
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12852
+ * understanding that it will be transcoded.
12853
+ *
12854
+ * Default `false` — today's behaviour, and the right one for a bypass
12855
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12856
+ * ask the larger question: "what is the best stream for me, transcoding if
12857
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12858
+ * does not, so a passthrough is never lost to a transcode; the answer says
12859
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12860
+ *
12861
+ * This is what lets one picker serve both the bypass and the full source
12862
+ * choice, instead of a consumer scoring privately when the bypass misses.
12863
+ */
12864
+ allowTranscode: boolean().optional()
12743
12865
  }).readonly();
12744
12866
  var PickStreamPreferencesSchema = object({
12745
12867
  /**
@@ -12753,12 +12875,32 @@ var PickStreamPreferencesSchema = object({
12753
12875
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12754
12876
  * memory-constrained consumers / Apple Home guest sessions).
12755
12877
  */
12756
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12878
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12879
+ /**
12880
+ * The height the consumer actually wants to DELIVER.
12881
+ *
12882
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12883
+ * above the target wins, and only if nothing reaches it does the tallest
12884
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12885
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12886
+ * express that: it says "as big as possible", which is a different wish.
12887
+ *
12888
+ * Ignored when absent, so every existing caller keeps its ordering.
12889
+ */
12890
+ targetHeight: number().int().positive().optional()
12757
12891
  }).readonly();
12758
12892
  var PickedCamStreamSchema = object({
12759
12893
  camStreamId: string(),
12760
12894
  codec: string().optional(),
12761
12895
  resolution: CamStreamResolutionSchema.optional(),
12896
+ /**
12897
+ * Whether serving this stream requires a decode + re-encode.
12898
+ *
12899
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12900
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12901
+ * not ask cannot be handed a cost it never agreed to pay.
12902
+ */
12903
+ transcodes: boolean(),
12762
12904
  /** One-line explanation of why this stream won — for logs / debug UI. */
12763
12905
  reason: string()
12764
12906
  });
@@ -17287,6 +17429,8 @@ var NcSystemEventKindSchema = _enum([
17287
17429
  "device-enabled",
17288
17430
  "device-battery-low",
17289
17431
  "device-battery-normal",
17432
+ "device-consumable-low",
17433
+ "device-consumable-normal",
17290
17434
  "stream-online",
17291
17435
  "stream-offline",
17292
17436
  "node-online",
@@ -17305,6 +17449,7 @@ var NcSystemEventKindSchema = _enum([
17305
17449
  "addon-updated",
17306
17450
  "server-updated",
17307
17451
  "export-completed",
17452
+ "backup-completed",
17308
17453
  "camera-online",
17309
17454
  "camera-offline",
17310
17455
  "camera-disabled",
@@ -18455,10 +18600,22 @@ var NC_CONDITION_CATALOG = [
18455
18600
  value: "server-updated",
18456
18601
  label: "Server updated"
18457
18602
  },
18603
+ {
18604
+ value: "device-consumable-low",
18605
+ label: "Consumable low"
18606
+ },
18607
+ {
18608
+ value: "device-consumable-normal",
18609
+ label: "Consumable replaced"
18610
+ },
18458
18611
  {
18459
18612
  value: "export-completed",
18460
18613
  label: "Export completed"
18461
18614
  },
18615
+ {
18616
+ value: "backup-completed",
18617
+ label: "Backup completed"
18618
+ },
18462
18619
  {
18463
18620
  value: "alarm-arming",
18464
18621
  label: "Alarm arming (exit delay)"
@@ -25870,10 +26027,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
25870
26027
  }), boolean()), method(object({
25871
26028
  deviceId: number().int().nonnegative(),
25872
26029
  sessionId: string()
25873
- }), object({ pendingRenegotiation: object({
25874
- target: WebrtcStreamTargetSchema,
25875
- epoch: number()
25876
- }).nullable() }));
26030
+ }), object({
26031
+ pendingRenegotiation: object({
26032
+ target: WebrtcStreamTargetSchema,
26033
+ epoch: number()
26034
+ }).nullable(),
26035
+ /**
26036
+ * Whether the session still EXISTS.
26037
+ *
26038
+ * A consumer that holds a resource for the life of a session needs to
26039
+ * be able to ask, because a session does not always end the way it
26040
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
26041
+ * sent `SessionDisconnected`, so the Alexa exporter's
26042
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
26043
+ * H.264 transcode kept running for NOBODY for more than twenty
26044
+ * minutes. The WebRTC session had logged `WebRTC session closed`
26045
+ * minutes earlier — the broker knew; the holder had no way to ask.
26046
+ *
26047
+ * `false` for a session id the provider has never heard of, which is
26048
+ * the same answer as "it ended": either way nothing is holding it up.
26049
+ */
26050
+ alive: boolean()
26051
+ }));
25877
26052
  object({
25878
26053
  /** All accessory children of the parent. */
25879
26054
  childDeviceIds: array(number()).readonly(),
@@ -36109,6 +36284,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
36109
36284
  smoke: smokeCapability,
36110
36285
  streamCatalog: streamCatalogCapability,
36111
36286
  streamParams: streamParamsCapability,
36287
+ streamSignals: streamSignalsCapability,
36112
36288
  switch: switchCapability,
36113
36289
  tamper: tamperCapability,
36114
36290
  temperatureSensor: temperatureSensorCapability,
@@ -42264,6 +42440,12 @@ Object.freeze({
42264
42440
  addonId: null,
42265
42441
  access: "create"
42266
42442
  },
42443
+ "streamBroker.reportStreamSignal": {
42444
+ capName: "stream-broker",
42445
+ capScope: "system",
42446
+ addonId: null,
42447
+ access: "create"
42448
+ },
42267
42449
  "streamBroker.restartProfile": {
42268
42450
  capName: "stream-broker",
42269
42451
  capScope: "system",
@@ -42348,6 +42530,12 @@ Object.freeze({
42348
42530
  addonId: null,
42349
42531
  access: "create"
42350
42532
  },
42533
+ "streamSignals.listSignals": {
42534
+ capName: "stream-signals",
42535
+ capScope: "device",
42536
+ addonId: null,
42537
+ access: "view"
42538
+ },
42351
42539
  "switch.setState": {
42352
42540
  capName: "switch",
42353
42541
  capScope: "device",
@@ -44720,6 +44908,11 @@ Object.freeze({
44720
44908
  form: "single",
44721
44909
  optional: false
44722
44910
  }],
44911
+ "streamBroker.reportStreamSignal": [{
44912
+ name: "deviceId",
44913
+ form: "single",
44914
+ optional: false
44915
+ }],
44723
44916
  "streamBroker.restartProfile": [{
44724
44917
  name: "deviceId",
44725
44918
  form: "single",
@@ -29,7 +29,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
29
29
  enumerable: true
30
30
  }) : target, mod));
31
31
  //#endregion
32
- //#region ../types/dist/event-category-ZyX6jcse.mjs
32
+ //#region ../types/dist/event-category-BVDXG4tB.mjs
33
33
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
34
34
  EventCategory["SystemBoot"] = "system.boot";
35
35
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -646,6 +646,20 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
646
646
  * pull-reconcile from the provider's `getStatus` on reconnect. */
647
647
  EventCategory["MeshNetworkChanged"] = "network.mesh.changed";
648
648
  EventCategory["BackupCompleted"] = "backup.completed";
649
+ /**
650
+ * A whole backup RUN finished — every destination attempted, win or lose.
651
+ *
652
+ * `backup.completed` fires once per DESTINATION, which is the right grain for
653
+ * a progress UI and the wrong one for a notification: an operator with three
654
+ * destinations would be told three times. And a run where two of three
655
+ * destinations succeeded is not a clean success — a single "backup
656
+ * completed" that hid the failed one would be a lie, so the count of each is
657
+ * carried here and the message says both.
658
+ *
659
+ * Emitted by the backup orchestrator only after the destination loop, so a
660
+ * run that dies during the BUILD phase produces no completion at all.
661
+ */
662
+ EventCategory["BackupRunCompleted"] = "backup.run-completed";
649
663
  EventCategory["BackupRestored"] = "backup.restored";
650
664
  EventCategory["NotificationDispatched"] = "notification.dispatched";
651
665
  EventCategory["NotificationFailed"] = "notification.failed";
@@ -5376,7 +5390,7 @@ var ZodIssueCode = {
5376
5390
  var ZodFirstPartyTypeKind;
5377
5391
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5378
5392
  //#endregion
5379
- //#region ../types/dist/sleep-DBKu2-U5.mjs
5393
+ //#region ../types/dist/sleep-DEuj7E3j.mjs
5380
5394
  /**
5381
5395
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5382
5396
  * window to float samples (D455).
@@ -7387,7 +7401,7 @@ method(object({ deviceId: number() }), array(StreamSourceEntrySchema)), method(o
7387
7401
  * can answer "may a rule actuate this?" without importing the schema barrel
7388
7402
  * (~144MB RSS per runner, D28).
7389
7403
  *
7390
- * Coverage: 83 device-scoped capabilities.
7404
+ * Coverage: 84 device-scoped capabilities.
7391
7405
  */
7392
7406
  var DEVICE_SCOPED_CAPS = new Set([
7393
7407
  "accessories",
@@ -7459,6 +7473,7 @@ var DEVICE_SCOPED_CAPS = new Set([
7459
7473
  "snapshot",
7460
7474
  "stream-catalog",
7461
7475
  "stream-params",
7476
+ "stream-signals",
7462
7477
  "switch",
7463
7478
  "tamper",
7464
7479
  "temperature-sensor",
@@ -12104,6 +12119,72 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
12104
12119
  auth: "admin"
12105
12120
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
12106
12121
  DeviceType.Camera;
12122
+ /**
12123
+ * The signals a device can emit to WAKE its own stream.
12124
+ *
12125
+ * A camera whose stream is built on demand sleeps until something asks for it,
12126
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
12127
+ * puller holds a session open for ever, and treating that as demand would keep
12128
+ * a battery camera awake for ever, which is the whole thing the battery is for
12129
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
12130
+ * itself, with no stream running.
12131
+ *
12132
+ * ## The vocabulary is the PROVIDER'S, not ours
12133
+ *
12134
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
12135
+ * names each signal with a `code` it chooses and a `label` an operator reads.
12136
+ * Reolink offers motion and camera-native detection; another provider may offer
12137
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
12138
+ * yet. A fixed enum here would mean every new signal is a framework release.
12139
+ *
12140
+ * It is deliberately NOT derived from the caps a device already binds. Whether
12141
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
12142
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
12143
+ * binding — but both answer "what drives the detection pipeline", which is a
12144
+ * different question from "what may wake a sleeping stream". A camera can do
12145
+ * the first and not be trusted with the second, and the operator picks per
12146
+ * camera. Two questions, two authorities.
12147
+ *
12148
+ * ## Availability is not permission
12149
+ *
12150
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
12151
+ * wakes the stream is the operator's per-camera choice, held by the broker
12152
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
12153
+ * provider declaring a signal is not a provider enabling it.
12154
+ */
12155
+ /** One signal a device can emit. */
12156
+ var StreamSignalSchema = object({
12157
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
12158
+ code: string().min(1),
12159
+ /** What an operator reads in the picker. The provider's own wording. */
12160
+ label: string().min(1),
12161
+ /**
12162
+ * Whether the provider recommends this signal ON when a camera is first set
12163
+ * up. A provider knows which of its signals are cheap and reliable; an
12164
+ * operator should not have to discover that by trial. Reolink recommends
12165
+ * both of its own.
12166
+ */
12167
+ recommended: boolean()
12168
+ });
12169
+ var StreamSignalsStatusSchema = object({
12170
+ signals: array(StreamSignalSchema),
12171
+ lastFetchedAt: number()
12172
+ });
12173
+ var streamSignalsCapability = {
12174
+ name: "stream-signals",
12175
+ scope: "device",
12176
+ deviceNative: true,
12177
+ mode: "singleton",
12178
+ deviceTypes: Object.values(DeviceType),
12179
+ runtimeState: StreamSignalsStatusSchema,
12180
+ methods: {
12181
+ /**
12182
+ * What this device can emit. Empty is a valid and common answer — most
12183
+ * cameras have nothing to offer here, and an empty list is what makes the
12184
+ * broker's picker show nothing rather than a false choice.
12185
+ */
12186
+ listSignals: method(_void(), array(StreamSignalSchema).readonly()) }
12187
+ };
12107
12188
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
12108
12189
  var StreamFormatSchema = _enum([
12109
12190
  "webrtc",
@@ -12500,6 +12581,22 @@ var EgressTranscodeSchema = object({
12500
12581
  camStreamId: string().nullable()
12501
12582
  });
12502
12583
  method(object({
12584
+ deviceId: number().int().nonnegative(),
12585
+ /** The provider's signal code. */
12586
+ code: string().min(1),
12587
+ /** Ms epoch. Absent ⇒ now. */
12588
+ at: number().optional()
12589
+ }), object({
12590
+ /** Whether the broker acted on it, and if not, why. */
12591
+ accepted: boolean(),
12592
+ reason: _enum([
12593
+ "woke",
12594
+ "hold-extended",
12595
+ "not-enabled",
12596
+ "no-consumer",
12597
+ "unknown-code"
12598
+ ])
12599
+ }), { kind: "mutation" }), method(object({
12503
12600
  deviceId: number().int().nonnegative(),
12504
12601
  camStreamId: string().min(1),
12505
12602
  kind: CamStreamKindSchema,
@@ -12754,6 +12851,16 @@ var PickStreamRequirementsSchema = object({
12754
12851
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12755
12852
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12756
12853
  minHeight: number().int().positive().optional(),
12854
+ /**
12855
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12856
+ *
12857
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12858
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12859
+ * Without this the ceiling had to be re-implemented by every caller — and
12860
+ * one caller implementing it privately is how a second scoring authority
12861
+ * gets born.
12862
+ */
12863
+ maxHeight: number().int().positive().optional(),
12757
12864
  /** Minimum horizontal resolution. */
12758
12865
  minWidth: number().int().positive().optional(),
12759
12866
  /**
@@ -12770,7 +12877,22 @@ var PickStreamRequirementsSchema = object({
12770
12877
  * transcoded" guard: if the device is already serving the consumer's
12771
12878
  * codec end-to-end, there's nothing to optimise.
12772
12879
  */
12773
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12880
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12881
+ /**
12882
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12883
+ * understanding that it will be transcoded.
12884
+ *
12885
+ * Default `false` — today's behaviour, and the right one for a bypass
12886
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12887
+ * ask the larger question: "what is the best stream for me, transcoding if
12888
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12889
+ * does not, so a passthrough is never lost to a transcode; the answer says
12890
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12891
+ *
12892
+ * This is what lets one picker serve both the bypass and the full source
12893
+ * choice, instead of a consumer scoring privately when the bypass misses.
12894
+ */
12895
+ allowTranscode: boolean().optional()
12774
12896
  }).readonly();
12775
12897
  var PickStreamPreferencesSchema = object({
12776
12898
  /**
@@ -12784,12 +12906,32 @@ var PickStreamPreferencesSchema = object({
12784
12906
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12785
12907
  * memory-constrained consumers / Apple Home guest sessions).
12786
12908
  */
12787
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12909
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12910
+ /**
12911
+ * The height the consumer actually wants to DELIVER.
12912
+ *
12913
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12914
+ * above the target wins, and only if nothing reaches it does the tallest
12915
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12916
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12917
+ * express that: it says "as big as possible", which is a different wish.
12918
+ *
12919
+ * Ignored when absent, so every existing caller keeps its ordering.
12920
+ */
12921
+ targetHeight: number().int().positive().optional()
12788
12922
  }).readonly();
12789
12923
  var PickedCamStreamSchema = object({
12790
12924
  camStreamId: string(),
12791
12925
  codec: string().optional(),
12792
12926
  resolution: CamStreamResolutionSchema.optional(),
12927
+ /**
12928
+ * Whether serving this stream requires a decode + re-encode.
12929
+ *
12930
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12931
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12932
+ * not ask cannot be handed a cost it never agreed to pay.
12933
+ */
12934
+ transcodes: boolean(),
12793
12935
  /** One-line explanation of why this stream won — for logs / debug UI. */
12794
12936
  reason: string()
12795
12937
  });
@@ -17318,6 +17460,8 @@ var NcSystemEventKindSchema = _enum([
17318
17460
  "device-enabled",
17319
17461
  "device-battery-low",
17320
17462
  "device-battery-normal",
17463
+ "device-consumable-low",
17464
+ "device-consumable-normal",
17321
17465
  "stream-online",
17322
17466
  "stream-offline",
17323
17467
  "node-online",
@@ -17336,6 +17480,7 @@ var NcSystemEventKindSchema = _enum([
17336
17480
  "addon-updated",
17337
17481
  "server-updated",
17338
17482
  "export-completed",
17483
+ "backup-completed",
17339
17484
  "camera-online",
17340
17485
  "camera-offline",
17341
17486
  "camera-disabled",
@@ -18486,10 +18631,22 @@ var NC_CONDITION_CATALOG = [
18486
18631
  value: "server-updated",
18487
18632
  label: "Server updated"
18488
18633
  },
18634
+ {
18635
+ value: "device-consumable-low",
18636
+ label: "Consumable low"
18637
+ },
18638
+ {
18639
+ value: "device-consumable-normal",
18640
+ label: "Consumable replaced"
18641
+ },
18489
18642
  {
18490
18643
  value: "export-completed",
18491
18644
  label: "Export completed"
18492
18645
  },
18646
+ {
18647
+ value: "backup-completed",
18648
+ label: "Backup completed"
18649
+ },
18493
18650
  {
18494
18651
  value: "alarm-arming",
18495
18652
  label: "Alarm arming (exit delay)"
@@ -25901,10 +26058,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
25901
26058
  }), boolean()), method(object({
25902
26059
  deviceId: number().int().nonnegative(),
25903
26060
  sessionId: string()
25904
- }), object({ pendingRenegotiation: object({
25905
- target: WebrtcStreamTargetSchema,
25906
- epoch: number()
25907
- }).nullable() }));
26061
+ }), object({
26062
+ pendingRenegotiation: object({
26063
+ target: WebrtcStreamTargetSchema,
26064
+ epoch: number()
26065
+ }).nullable(),
26066
+ /**
26067
+ * Whether the session still EXISTS.
26068
+ *
26069
+ * A consumer that holds a resource for the life of a session needs to
26070
+ * be able to ask, because a session does not always end the way it
26071
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
26072
+ * sent `SessionDisconnected`, so the Alexa exporter's
26073
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
26074
+ * H.264 transcode kept running for NOBODY for more than twenty
26075
+ * minutes. The WebRTC session had logged `WebRTC session closed`
26076
+ * minutes earlier — the broker knew; the holder had no way to ask.
26077
+ *
26078
+ * `false` for a session id the provider has never heard of, which is
26079
+ * the same answer as "it ended": either way nothing is holding it up.
26080
+ */
26081
+ alive: boolean()
26082
+ }));
25908
26083
  object({
25909
26084
  /** All accessory children of the parent. */
25910
26085
  childDeviceIds: array(number()).readonly(),
@@ -36140,6 +36315,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
36140
36315
  smoke: smokeCapability,
36141
36316
  streamCatalog: streamCatalogCapability,
36142
36317
  streamParams: streamParamsCapability,
36318
+ streamSignals: streamSignalsCapability,
36143
36319
  switch: switchCapability,
36144
36320
  tamper: tamperCapability,
36145
36321
  temperatureSensor: temperatureSensorCapability,
@@ -42295,6 +42471,12 @@ Object.freeze({
42295
42471
  addonId: null,
42296
42472
  access: "create"
42297
42473
  },
42474
+ "streamBroker.reportStreamSignal": {
42475
+ capName: "stream-broker",
42476
+ capScope: "system",
42477
+ addonId: null,
42478
+ access: "create"
42479
+ },
42298
42480
  "streamBroker.restartProfile": {
42299
42481
  capName: "stream-broker",
42300
42482
  capScope: "system",
@@ -42379,6 +42561,12 @@ Object.freeze({
42379
42561
  addonId: null,
42380
42562
  access: "create"
42381
42563
  },
42564
+ "streamSignals.listSignals": {
42565
+ capName: "stream-signals",
42566
+ capScope: "device",
42567
+ addonId: null,
42568
+ access: "view"
42569
+ },
42382
42570
  "switch.setState": {
42383
42571
  capName: "switch",
42384
42572
  capScope: "device",
@@ -44751,6 +44939,11 @@ Object.freeze({
44751
44939
  form: "single",
44752
44940
  optional: false
44753
44941
  }],
44942
+ "streamBroker.reportStreamSignal": [{
44943
+ name: "deviceId",
44944
+ form: "single",
44945
+ optional: false
44946
+ }],
44754
44947
  "streamBroker.restartProfile": [{
44755
44948
  name: "deviceId",
44756
44949
  form: "single",
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-DTRcLvW5.js");
5
+ const require_dist = require("../dist-IoI_ufBo.js");
6
6
  let node_fs = require("node:fs");
7
7
  node_fs = require_dist.__toESM(node_fs);
8
8
  let node_path = require("node:path");