@camstack/addon-auth 1.2.108 → 1.2.110

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-BDR76Ykr.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).
@@ -11653,6 +11667,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11653
11667
  auth: "admin"
11654
11668
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11655
11669
  DeviceType.Camera;
11670
+ /**
11671
+ * The signals a device can emit to WAKE its own stream.
11672
+ *
11673
+ * A camera whose stream is built on demand sleeps until something asks for it,
11674
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11675
+ * puller holds a session open for ever, and treating that as demand would keep
11676
+ * a battery camera awake for ever, which is the whole thing the battery is for
11677
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11678
+ * itself, with no stream running.
11679
+ *
11680
+ * ## The vocabulary is the PROVIDER'S, not ours
11681
+ *
11682
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11683
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11684
+ * Reolink offers motion and camera-native detection; another provider may offer
11685
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11686
+ * yet. A fixed enum here would mean every new signal is a framework release.
11687
+ *
11688
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11689
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11690
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11691
+ * binding — but both answer "what drives the detection pipeline", which is a
11692
+ * different question from "what may wake a sleeping stream". A camera can do
11693
+ * the first and not be trusted with the second, and the operator picks per
11694
+ * camera. Two questions, two authorities.
11695
+ *
11696
+ * ## Availability is not permission
11697
+ *
11698
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11699
+ * wakes the stream is the operator's per-camera choice, held by the broker
11700
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11701
+ * provider declaring a signal is not a provider enabling it.
11702
+ */
11703
+ /** One signal a device can emit. */
11704
+ var StreamSignalSchema = object({
11705
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11706
+ code: string().min(1),
11707
+ /** What an operator reads in the picker. The provider's own wording. */
11708
+ label: string().min(1),
11709
+ /**
11710
+ * Whether the provider recommends this signal ON when a camera is first set
11711
+ * up. A provider knows which of its signals are cheap and reliable; an
11712
+ * operator should not have to discover that by trial. Reolink recommends
11713
+ * both of its own.
11714
+ */
11715
+ recommended: boolean()
11716
+ });
11717
+ object({
11718
+ signals: array(StreamSignalSchema),
11719
+ lastFetchedAt: number()
11720
+ });
11721
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11656
11722
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11657
11723
  var StreamFormatSchema = _enum([
11658
11724
  "webrtc",
@@ -12049,6 +12115,22 @@ var EgressTranscodeSchema = object({
12049
12115
  camStreamId: string().nullable()
12050
12116
  });
12051
12117
  method(object({
12118
+ deviceId: number().int().nonnegative(),
12119
+ /** The provider's signal code. */
12120
+ code: string().min(1),
12121
+ /** Ms epoch. Absent ⇒ now. */
12122
+ at: number().optional()
12123
+ }), object({
12124
+ /** Whether the broker acted on it, and if not, why. */
12125
+ accepted: boolean(),
12126
+ reason: _enum([
12127
+ "woke",
12128
+ "hold-extended",
12129
+ "not-enabled",
12130
+ "no-consumer",
12131
+ "unknown-code"
12132
+ ])
12133
+ }), { kind: "mutation" }), method(object({
12052
12134
  deviceId: number().int().nonnegative(),
12053
12135
  camStreamId: string().min(1),
12054
12136
  kind: CamStreamKindSchema,
@@ -12303,6 +12385,16 @@ var PickStreamRequirementsSchema = object({
12303
12385
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12304
12386
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12305
12387
  minHeight: number().int().positive().optional(),
12388
+ /**
12389
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12390
+ *
12391
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12392
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12393
+ * Without this the ceiling had to be re-implemented by every caller — and
12394
+ * one caller implementing it privately is how a second scoring authority
12395
+ * gets born.
12396
+ */
12397
+ maxHeight: number().int().positive().optional(),
12306
12398
  /** Minimum horizontal resolution. */
12307
12399
  minWidth: number().int().positive().optional(),
12308
12400
  /**
@@ -12319,7 +12411,22 @@ var PickStreamRequirementsSchema = object({
12319
12411
  * transcoded" guard: if the device is already serving the consumer's
12320
12412
  * codec end-to-end, there's nothing to optimise.
12321
12413
  */
12322
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12414
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12415
+ /**
12416
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12417
+ * understanding that it will be transcoded.
12418
+ *
12419
+ * Default `false` — today's behaviour, and the right one for a bypass
12420
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12421
+ * ask the larger question: "what is the best stream for me, transcoding if
12422
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12423
+ * does not, so a passthrough is never lost to a transcode; the answer says
12424
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12425
+ *
12426
+ * This is what lets one picker serve both the bypass and the full source
12427
+ * choice, instead of a consumer scoring privately when the bypass misses.
12428
+ */
12429
+ allowTranscode: boolean().optional()
12323
12430
  }).readonly();
12324
12431
  var PickStreamPreferencesSchema = object({
12325
12432
  /**
@@ -12333,12 +12440,32 @@ var PickStreamPreferencesSchema = object({
12333
12440
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12334
12441
  * memory-constrained consumers / Apple Home guest sessions).
12335
12442
  */
12336
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12443
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12444
+ /**
12445
+ * The height the consumer actually wants to DELIVER.
12446
+ *
12447
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12448
+ * above the target wins, and only if nothing reaches it does the tallest
12449
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12450
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12451
+ * express that: it says "as big as possible", which is a different wish.
12452
+ *
12453
+ * Ignored when absent, so every existing caller keeps its ordering.
12454
+ */
12455
+ targetHeight: number().int().positive().optional()
12337
12456
  }).readonly();
12338
12457
  var PickedCamStreamSchema = object({
12339
12458
  camStreamId: string(),
12340
12459
  codec: string().optional(),
12341
12460
  resolution: CamStreamResolutionSchema.optional(),
12461
+ /**
12462
+ * Whether serving this stream requires a decode + re-encode.
12463
+ *
12464
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12465
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12466
+ * not ask cannot be handed a cost it never agreed to pay.
12467
+ */
12468
+ transcodes: boolean(),
12342
12469
  /** One-line explanation of why this stream won — for logs / debug UI. */
12343
12470
  reason: string()
12344
12471
  });
@@ -16535,6 +16662,8 @@ var NcSystemEventKindSchema = _enum([
16535
16662
  "device-enabled",
16536
16663
  "device-battery-low",
16537
16664
  "device-battery-normal",
16665
+ "device-consumable-low",
16666
+ "device-consumable-normal",
16538
16667
  "stream-online",
16539
16668
  "stream-offline",
16540
16669
  "node-online",
@@ -16553,6 +16682,7 @@ var NcSystemEventKindSchema = _enum([
16553
16682
  "addon-updated",
16554
16683
  "server-updated",
16555
16684
  "export-completed",
16685
+ "backup-completed",
16556
16686
  "camera-online",
16557
16687
  "camera-offline",
16558
16688
  "camera-disabled",
@@ -17875,6 +18005,48 @@ var NcAlarmConfigSchema = object({
17875
18005
  settings: NcAlarmSettingsSchema,
17876
18006
  coverage: array(NcAlarmModeCoverageSchema)
17877
18007
  });
18008
+ /**
18009
+ * ONE rule's demand on ONE camera's clip ring.
18010
+ *
18011
+ * A rule, not a camera: the broker takes the MAX over the asks that reach a
18012
+ * camera, so the answer stays a faithful description of the rules and the
18013
+ * bounding (the byte budget, the broker's own ceiling) stays where the cost
18014
+ * lives. A camera that appears in no ask is being told **nothing** — which is
18015
+ * a different thing from never having been told, and only the envelope
18016
+ * (`rulesLoaded`) can tell those apart.
18017
+ */
18018
+ var NcClipRetentionAskSchema = object({
18019
+ /**
18020
+ * The camera this ask is about. **Absent = every camera**, which is what a
18021
+ * rule with no `conditions.devices` means: it can fire anywhere, so it is
18022
+ * asking everywhere.
18023
+ */
18024
+ deviceId: number().int().nonnegative().optional(),
18025
+ /** Seconds of history the rule needs held for it. Never zero — a rule that
18026
+ * needs nothing produces no ask at all. */
18027
+ seconds: number().min(0).max(60),
18028
+ /** The profile the rule cuts from, when it named one. Absent = the cheapest
18029
+ * assigned, which is what the cut defaults to. */
18030
+ profile: CamProfileSchema.optional(),
18031
+ /** Who is asking — so a retention the operator did not expect names a rule. */
18032
+ ruleId: string(),
18033
+ ruleName: string(),
18034
+ /** Why this many seconds: the rule's own window, or the occupancy ceiling. */
18035
+ reason: _enum(["window", "occupancy"])
18036
+ });
18037
+ /**
18038
+ * The whole answer, with the one bit that keeps absence from reading as zero.
18039
+ *
18040
+ * `rulesLoaded` is false until the rule ledger has completed a load at least
18041
+ * once. A centre that is up but has not read its rules yet answers with an
18042
+ * empty ask list that means nothing at all — applying it would drop every
18043
+ * camera's ring to zero for the first events after a restart, which is the
18044
+ * footage this mechanism exists to keep.
18045
+ */
18046
+ var NcClipRetentionPlanSchema = object({
18047
+ rulesLoaded: boolean(),
18048
+ asks: array(NcClipRetentionAskSchema).readonly()
18049
+ });
17878
18050
  method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), method(object({ ruleId: string() }), object({ rule: NcRuleSchema.nullable() }), { auth: "admin" }), method(object({ rule: NcRuleInputSchema }), object({ rule: NcRuleSchema }), {
17879
18051
  kind: "mutation",
17880
18052
  auth: "admin",
@@ -17895,7 +18067,7 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
17895
18067
  }), object({ success: literal(true) }), {
17896
18068
  kind: "mutation",
17897
18069
  auth: "admin"
17898
- }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
18070
+ }), method(object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
17899
18071
  deviceId: number().int(),
17900
18072
  muted: boolean()
17901
18073
  }), object({ success: literal(true) }), {
@@ -20429,6 +20601,33 @@ var RunReplayFrameProcessorResultSchema = object({ tracks: array(object({
20429
20601
  * solid is this track", cheaper than re-deriving it from a trajectory. */
20430
20602
  framesMatched: number().int()
20431
20603
  })).readonly() });
20604
+ /**
20605
+ * The long-term series a camera produces. A closed union so a typo cannot
20606
+ * invent one, and the ONE declaration of it — the addon's `AnalyticsLtsSeries`
20607
+ * is an alias of this, not a second list.
20608
+ */
20609
+ var AnalyticsLtsSeriesSchema = _enum([
20610
+ "motion",
20611
+ "audio-dbfs",
20612
+ "battery",
20613
+ "occupancy"
20614
+ ]);
20615
+ /**
20616
+ * One closed 5-minute bucket of a long-term series.
20617
+ *
20618
+ * `samples` is how many readings the bucket folded — it is the ACTIVITY for a
20619
+ * series like `motion`, and the confidence for one like `occupancy`. A bucket
20620
+ * that exists at all was measured; a bucket that is absent was not, which is a
20621
+ * different claim from zero and the reason this is a sparse series.
20622
+ */
20623
+ var LtsBucketSchema = object({
20624
+ scope: string(),
20625
+ bucketStart: number().int(),
20626
+ samples: number().int().nonnegative(),
20627
+ sum: number(),
20628
+ min: number(),
20629
+ max: number()
20630
+ });
20432
20631
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
20433
20632
  deviceId: number(),
20434
20633
  trackId: string()
@@ -20475,6 +20674,14 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20475
20674
  kinds: array(string()).optional(),
20476
20675
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
20477
20676
  }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
20677
+ deviceId: number(),
20678
+ series: AnalyticsLtsSeriesSchema,
20679
+ /** Omit for EVERY scope of this series in the range. */
20680
+ scope: string().optional(),
20681
+ from: number(),
20682
+ to: number(),
20683
+ limit: number().int().positive().optional()
20684
+ }), array(LtsBucketSchema).readonly()), method(object({
20478
20685
  deviceId: number(),
20479
20686
  since: number(),
20480
20687
  until: number(),
@@ -21093,6 +21300,14 @@ var MotionSourceEnum = _enum([
21093
21300
  */
21094
21301
  var MotionSourcesSchema = array(MotionSourceEnum);
21095
21302
  /**
21303
+ * Which root detectors a camera runs. Deliberately the SAME vocabulary
21304
+ * post-analysis already tags every detection with (`DetectionSource`) rather
21305
+ * than a second spelling of the same two ideas — the value an operator picks
21306
+ * here is the value that comes back on the track, the overlay and the debug
21307
+ * row.
21308
+ */
21309
+ var DetectionSourcesSchema = array(DetectionSourceSchema);
21310
+ /**
21096
21311
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21097
21312
  * so cap-side consumers (the orchestrator forward, the runner addon's
21098
21313
  * cap implementation, tests) can reuse the type instead of redeclaring
@@ -21243,6 +21458,35 @@ var RunnerCameraConfigSchema = object({
21243
21458
  * events; the orchestrator forwards to `reportMotion`.
21244
21459
  */
21245
21460
  motionSources: MotionSourcesSchema.default(["analyzer"]),
21461
+ /**
21462
+ * WHICH root detector runs for this camera. The detection counterpart of
21463
+ * {@link motionSources}, same shape and same discipline: a per-camera list
21464
+ * of sources the system understands, vendor-agnostic, owned here.
21465
+ *
21466
+ * - `pipeline` — this runner's own root step on decoded pixels (`steps`).
21467
+ * - `onboard` — the CAMERA's own detector, admitted only when it is named
21468
+ * here. Its boxes reach post-analysis on the same
21469
+ * `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
21470
+ * track gets the same tracker, the same overlay and the same detail
21471
+ * subtree (face / plate / embedding).
21472
+ *
21473
+ * `['onboard']` alone is the REPLACEMENT: this runner's root step does not
21474
+ * run, and that is where a camera with a usable onboard detector buys back
21475
+ * its share of the accelerator. It saves the root inference, not the decode
21476
+ * — the detail subtree still needs pixels to cut crops from.
21477
+ *
21478
+ * A camera whose onboard detections carry no geometry cannot serve as a root
21479
+ * step at all (there is nothing to track), and the cap that knows this says
21480
+ * so on `native-object-detection.getOptions().geometry`. On Reolink that is
21481
+ * every battery camera: the boxes ride a sub-stream a battery camera never
21482
+ * attaches, so such a camera stays on `['pipeline']` and its onboard AI is
21483
+ * worth exactly what it already is — a wake signal with a class.
21484
+ *
21485
+ * Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
21486
+ * vendor never turns a detector on for the operator, and neither does a
21487
+ * default.
21488
+ */
21489
+ detectionSources: DetectionSourcesSchema.default(["pipeline"]),
21246
21490
  pipelineEnabled: boolean().default(true),
21247
21491
  /** Ordered tree of video steps. Absent → runner skips video detection. */
21248
21492
  steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -21424,7 +21668,47 @@ var RunnerLocalMetricsSchema = object({
21424
21668
  queueDepth: number(),
21425
21669
  frameLazy: FrameLazyMetricsSchema.optional()
21426
21670
  });
21671
+ /**
21672
+ * Pipeline Runner capability — runtime detection workhorse.
21673
+ *
21674
+ * One instance per node. Receives camera assignments from
21675
+ * `addon-pipeline-orchestrator`, subscribes to the local stream-broker for
21676
+ * decoded frames, drains motion + detection queues, calls the local
21677
+ * `motion-detection` and `pipeline-executor` capabilities, and emits typed
21678
+ * `pipeline.inference-result` and `detection.motion-analysis` events on
21679
+ * the bus.
21680
+ *
21681
+ * Distinct from `pipeline-orchestrator` (the hub-side load balancer) — the
21682
+ * runner has zero knowledge of other agents, no global state, and never
21683
+ * makes assignment decisions itself.
21684
+ */
21685
+ /**
21686
+ * Why a runner declined to look at a camera out of band. Named rather than a
21687
+ * bare `false`: a camera asleep on battery (D173), one attached elsewhere, one
21688
+ * already mid-session and one already bursting are four different facts, and a
21689
+ * caller told only "no" cannot tell a protection from a bug.
21690
+ */
21691
+ var OccupancyBurstRefusalSchema = _enum([
21692
+ "not-attached",
21693
+ "battery-asleep",
21694
+ "not-watching",
21695
+ "already-bursting"
21696
+ ]);
21427
21697
  method(RunnerCameraConfigSchema, object({ success: literal(true) }), { kind: "mutation" }), method(object({ deviceId: number() }), object({ success: literal(true) }), { kind: "mutation" }), method(ReportMotionInputSchema, object({ success: literal(true) }), { kind: "mutation" }), method(_void(), RunnerLocalLoadSchema), method(_void(), RunnerLocalMetricsSchema), method(object({ deviceId: number() }), CameraMetricsSchema.nullable()), method(_void(), array(CameraMetricsWithDeviceIdSchema).readonly()), method(_void(), array(number()).readonly()), method(object({
21698
+ deviceId: number(),
21699
+ /** How many frames to collect. The caller sizes this against what its
21700
+ * own confirmation needs; the runner clamps it to the field's range. */
21701
+ frames: number().int().positive().optional(),
21702
+ /** Why, for the log. A burst nobody can attribute is a cost nobody can
21703
+ * defend — the periodic one at least has a timer to point at. */
21704
+ reason: string()
21705
+ }), object({
21706
+ started: boolean(),
21707
+ refusedBecause: OccupancyBurstRefusalSchema.optional()
21708
+ }), {
21709
+ auth: "admin",
21710
+ kind: "mutation"
21711
+ }), method(object({
21428
21712
  handle: FrameHandleSchema,
21429
21713
  bbox: NativeCropBboxSchema,
21430
21714
  maxWidth: number().int().positive().optional(),
@@ -23829,10 +24113,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23829
24113
  }), boolean()), method(object({
23830
24114
  deviceId: number().int().nonnegative(),
23831
24115
  sessionId: string()
23832
- }), object({ pendingRenegotiation: object({
23833
- target: WebrtcStreamTargetSchema,
23834
- epoch: number()
23835
- }).nullable() }));
24116
+ }), object({
24117
+ pendingRenegotiation: object({
24118
+ target: WebrtcStreamTargetSchema,
24119
+ epoch: number()
24120
+ }).nullable(),
24121
+ /**
24122
+ * Whether the session still EXISTS.
24123
+ *
24124
+ * A consumer that holds a resource for the life of a session needs to
24125
+ * be able to ask, because a session does not always end the way it
24126
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
24127
+ * sent `SessionDisconnected`, so the Alexa exporter's
24128
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
24129
+ * H.264 transcode kept running for NOBODY for more than twenty
24130
+ * minutes. The WebRTC session had logged `WebRTC session closed`
24131
+ * minutes earlier — the broker knew; the holder had no way to ask.
24132
+ *
24133
+ * `false` for a session id the provider has never heard of, which is
24134
+ * the same answer as "it ended": either way nothing is holding it up.
24135
+ */
24136
+ alive: boolean()
24137
+ }));
23836
24138
  object({
23837
24139
  /** All accessory children of the parent. */
23838
24140
  childDeviceIds: array(number()).readonly(),
@@ -26910,7 +27212,7 @@ var NativeDetectionSchema = object({
26910
27212
  /** Firmware-provided confidence [0..1]. Reolink pushes don't carry it → undefined. */
26911
27213
  confidence: number().min(0).max(1).optional()
26912
27214
  });
26913
- object({
27215
+ var NativeObjectDetectionStatusSchema = object({
26914
27216
  /**
26915
27217
  * Last observed instance per class. Missing entries mean the class
26916
27218
  * is supported but nothing has been seen since the provider started.
@@ -26927,14 +27229,56 @@ object({
26927
27229
  supportedClasses: array(NativeObjectClassEnum).readonly(),
26928
27230
  /**
26929
27231
  * Whether forwarding of onboard AI detections is enabled for this device.
26930
- * Default FALSE (opt-in, cold-start) — onboard AI pushes are noisy/sparse and
26931
- * churn the tracker, so forwarding stays off until the operator enables it.
27232
+ *
27233
+ * Cold-start OFF on every camera. A vendor does not decide which detector a
27234
+ * camera runs — that is the operator's choice, and it is made where every
27235
+ * other detection choice is made. `geometry` on
27236
+ * {@link NativeObjectDetectionOptionsSchema} is how the form says what the
27237
+ * choice would buy this particular camera.
26932
27238
  */
26933
27239
  enabled: boolean()
26934
- }).extend({
27240
+ });
27241
+ /**
27242
+ * WHEN a camera's onboard detections carry geometry.
27243
+ *
27244
+ * - `boxed` — always. The provider holds a standing channel for the boxes, so
27245
+ * a detection is a trackable subject whenever the camera sees one.
27246
+ * - `while-streaming` — only while some stream of this camera is already open.
27247
+ * The boxes ride the video's own side-channel rather than a feed of their
27248
+ * own, so they cost nothing and they exist only when something is pulling.
27249
+ * On Reolink this is every BATTERY camera: a persistent second feed is real
27250
+ * radio drain, but a camera that is awake is awake precisely because
27251
+ * something is in front of it, and its stream is already being pulled.
27252
+ * - `flag-only` — never. The firmware ships the class and nothing else; the
27253
+ * pipeline needs geometry to make a subject, so such a push reaches the
27254
+ * tracker as motion and no further.
27255
+ *
27256
+ * Reported and not inferred, because the operator's question in front of the
27257
+ * picker is "what do I get", and these are three different answers (D14: the
27258
+ * derived form is only as honest as `getOptions`).
27259
+ */
27260
+ var NativeObjectGeometryEnum = _enum([
27261
+ "boxed",
27262
+ "while-streaming",
27263
+ "flag-only"
27264
+ ]);
27265
+ var NativeObjectDetectionOptionsSchema = object({
27266
+ /** Classes this firmware can detect — the same list the status reports. */
27267
+ supportedClasses: array(NativeObjectClassEnum).readonly(),
27268
+ /** What a detection from this camera carries. */
27269
+ geometry: NativeObjectGeometryEnum
27270
+ });
27271
+ var NativeObjectDetectionSettingsPatchSchema = object({ enabled: boolean().optional() });
27272
+ NativeObjectDetectionStatusSchema.extend({
26935
27273
  /** Required by createRuntimeStateBridge — epoch ms of last refresh. */
26936
27274
  lastFetchedAt: number() });
26937
- DeviceType.Camera, method(object({
27275
+ DeviceType.Camera, method(object({ deviceId: number() }), NativeObjectDetectionOptionsSchema), method(object({
27276
+ deviceId: number(),
27277
+ settings: NativeObjectDetectionSettingsPatchSchema
27278
+ }), _void(), {
27279
+ kind: "mutation",
27280
+ auth: "admin"
27281
+ }), method(object({
26938
27282
  deviceId: number(),
26939
27283
  enabled: boolean()
26940
27284
  }), _void(), {
@@ -30733,7 +31077,28 @@ var PerScopeBreakdownSchema = object({
30733
31077
  /** Total tracked objects in this scope (frame / zone / unzoned). */
30734
31078
  totalObjects: number().int().nonnegative(),
30735
31079
  /** Per-class count. Keys are macro class names (e.g. `person`, `car`). */
30736
- byClass: record(string(), number().int().nonnegative())
31080
+ byClass: record(string(), number().int().nonnegative()),
31081
+ /**
31082
+ * Of `totalObjects`, how many are STANDING — objects the census holds,
31083
+ * present but not going anywhere (a parked car, a bin, a statue).
31084
+ *
31085
+ * The operator's question about a scene has two halves and they answer
31086
+ * different things: "what is parked here" is stable for hours and must not
31087
+ * flap, while "who is walking through" is the thing an alert is about. One
31088
+ * number could only serve one of them, and `totalObjects` served the first
31089
+ * badly — a passer-by moved it and every occupancy rule saw a change.
31090
+ *
31091
+ * `standing + transient === totalObjects`, always. The total keeps its old
31092
+ * meaning exactly, so no rule written against it changes behaviour.
31093
+ *
31094
+ * ABSENT means UNKNOWN, never zero (D393): a snapshot from a node older than
31095
+ * this field cannot say, and a reader that folds absence in as 0 reports "no
31096
+ * parked objects here" about a camera whose lot is full.
31097
+ */
31098
+ standingObjects: number().int().nonnegative().optional(),
31099
+ /** Of `totalObjects`, how many are passing through. See `standingObjects` —
31100
+ * same absence rule. */
31101
+ transientObjects: number().int().nonnegative().optional()
30737
31102
  });
30738
31103
  var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
30739
31104
  zoneId: string(),
@@ -33672,12 +34037,24 @@ Object.freeze({
33672
34037
  addonId: null,
33673
34038
  access: "create"
33674
34039
  },
34040
+ "nativeObjectDetection.getOptions": {
34041
+ capName: "native-object-detection",
34042
+ capScope: "device",
34043
+ addonId: null,
34044
+ access: "view"
34045
+ },
33675
34046
  "nativeObjectDetection.setEnabled": {
33676
34047
  capName: "native-object-detection",
33677
34048
  capScope: "device",
33678
34049
  addonId: null,
33679
34050
  access: "create"
33680
34051
  },
34052
+ "nativeObjectDetection.setSettings": {
34053
+ capName: "native-object-detection",
34054
+ capScope: "device",
34055
+ addonId: null,
34056
+ access: "create"
34057
+ },
33681
34058
  "navigation.getFeatures": {
33682
34059
  capName: "navigation",
33683
34060
  capScope: "device",
@@ -33942,6 +34319,12 @@ Object.freeze({
33942
34319
  addonId: null,
33943
34320
  access: "view"
33944
34321
  },
34322
+ "notificationRules.getClipRetentionAsks": {
34323
+ capName: "notification-rules",
34324
+ capScope: "system",
34325
+ addonId: null,
34326
+ access: "view"
34327
+ },
33945
34328
  "notificationRules.getConditionCatalog": {
33946
34329
  capName: "notification-rules",
33947
34330
  capScope: "system",
@@ -34452,6 +34835,12 @@ Object.freeze({
34452
34835
  addonId: null,
34453
34836
  access: "create"
34454
34837
  },
34838
+ "pipelineAnalytics.readLongTermSeries": {
34839
+ capName: "pipeline-analytics",
34840
+ capScope: "device",
34841
+ addonId: null,
34842
+ access: "view"
34843
+ },
34455
34844
  "pipelineAnalytics.rebuildObjectEmbeddings": {
34456
34845
  capName: "pipeline-analytics",
34457
34846
  capScope: "device",
@@ -35124,6 +35513,12 @@ Object.freeze({
35124
35513
  addonId: null,
35125
35514
  access: "create"
35126
35515
  },
35516
+ "pipelineRunner.requestOccupancyBurst": {
35517
+ capName: "pipeline-runner",
35518
+ capScope: "system",
35519
+ addonId: null,
35520
+ access: "create"
35521
+ },
35127
35522
  "pipelineRunner.runDetailSubtree": {
35128
35523
  capName: "pipeline-runner",
35129
35524
  capScope: "system",
@@ -36336,6 +36731,12 @@ Object.freeze({
36336
36731
  addonId: null,
36337
36732
  access: "create"
36338
36733
  },
36734
+ "streamBroker.reportStreamSignal": {
36735
+ capName: "stream-broker",
36736
+ capScope: "system",
36737
+ addonId: null,
36738
+ access: "create"
36739
+ },
36339
36740
  "streamBroker.restartProfile": {
36340
36741
  capName: "stream-broker",
36341
36742
  capScope: "system",
@@ -36420,6 +36821,12 @@ Object.freeze({
36420
36821
  addonId: null,
36421
36822
  access: "create"
36422
36823
  },
36824
+ "streamSignals.listSignals": {
36825
+ capName: "stream-signals",
36826
+ capScope: "device",
36827
+ addonId: null,
36828
+ access: "view"
36829
+ },
36423
36830
  "switch.setState": {
36424
36831
  capName: "switch",
36425
36832
  capScope: "device",
@@ -37892,11 +38299,21 @@ Object.freeze({
37892
38299
  form: "single",
37893
38300
  optional: false
37894
38301
  }],
38302
+ "nativeObjectDetection.getOptions": [{
38303
+ name: "deviceId",
38304
+ form: "single",
38305
+ optional: false
38306
+ }],
37895
38307
  "nativeObjectDetection.setEnabled": [{
37896
38308
  name: "deviceId",
37897
38309
  form: "single",
37898
38310
  optional: false
37899
38311
  }],
38312
+ "nativeObjectDetection.setSettings": [{
38313
+ name: "deviceId",
38314
+ form: "single",
38315
+ optional: false
38316
+ }],
37900
38317
  "navigation.getFeatures": [{
37901
38318
  name: "deviceId",
37902
38319
  form: "single",
@@ -38246,6 +38663,11 @@ Object.freeze({
38246
38663
  form: "single",
38247
38664
  optional: false
38248
38665
  }],
38666
+ "pipelineAnalytics.readLongTermSeries": [{
38667
+ name: "deviceId",
38668
+ form: "single",
38669
+ optional: false
38670
+ }],
38249
38671
  "pipelineAnalytics.rebuildObjectEmbeddings": [{
38250
38672
  name: "deviceId",
38251
38673
  form: "single",
@@ -38436,6 +38858,11 @@ Object.freeze({
38436
38858
  form: "single",
38437
38859
  optional: false
38438
38860
  }],
38861
+ "pipelineRunner.requestOccupancyBurst": [{
38862
+ name: "deviceId",
38863
+ form: "single",
38864
+ optional: false
38865
+ }],
38439
38866
  "pipelineRunner.runDetailSubtree": [{
38440
38867
  name: "deviceId",
38441
38868
  form: "single",
@@ -38792,6 +39219,11 @@ Object.freeze({
38792
39219
  form: "single",
38793
39220
  optional: false
38794
39221
  }],
39222
+ "streamBroker.reportStreamSignal": [{
39223
+ name: "deviceId",
39224
+ form: "single",
39225
+ optional: false
39226
+ }],
38795
39227
  "streamBroker.restartProfile": [{
38796
39228
  name: "deviceId",
38797
39229
  form: "single",