@camstack/addon-tailscale 1.2.101 → 1.2.103

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).
@@ -11507,6 +11521,58 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
11507
11521
  auth: "admin"
11508
11522
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
11509
11523
  DeviceType.Camera;
11524
+ /**
11525
+ * The signals a device can emit to WAKE its own stream.
11526
+ *
11527
+ * A camera whose stream is built on demand sleeps until something asks for it,
11528
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
11529
+ * puller holds a session open for ever, and treating that as demand would keep
11530
+ * a battery camera awake for ever, which is the whole thing the battery is for
11531
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
11532
+ * itself, with no stream running.
11533
+ *
11534
+ * ## The vocabulary is the PROVIDER'S, not ours
11535
+ *
11536
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
11537
+ * names each signal with a `code` it chooses and a `label` an operator reads.
11538
+ * Reolink offers motion and camera-native detection; another provider may offer
11539
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
11540
+ * yet. A fixed enum here would mean every new signal is a framework release.
11541
+ *
11542
+ * It is deliberately NOT derived from the caps a device already binds. Whether
11543
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
11544
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
11545
+ * binding — but both answer "what drives the detection pipeline", which is a
11546
+ * different question from "what may wake a sleeping stream". A camera can do
11547
+ * the first and not be trusted with the second, and the operator picks per
11548
+ * camera. Two questions, two authorities.
11549
+ *
11550
+ * ## Availability is not permission
11551
+ *
11552
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
11553
+ * wakes the stream is the operator's per-camera choice, held by the broker
11554
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
11555
+ * provider declaring a signal is not a provider enabling it.
11556
+ */
11557
+ /** One signal a device can emit. */
11558
+ var StreamSignalSchema = object({
11559
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
11560
+ code: string().min(1),
11561
+ /** What an operator reads in the picker. The provider's own wording. */
11562
+ label: string().min(1),
11563
+ /**
11564
+ * Whether the provider recommends this signal ON when a camera is first set
11565
+ * up. A provider knows which of its signals are cheap and reliable; an
11566
+ * operator should not have to discover that by trial. Reolink recommends
11567
+ * both of its own.
11568
+ */
11569
+ recommended: boolean()
11570
+ });
11571
+ object({
11572
+ signals: array(StreamSignalSchema),
11573
+ lastFetchedAt: number()
11574
+ });
11575
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
11510
11576
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
11511
11577
  var StreamFormatSchema = _enum([
11512
11578
  "webrtc",
@@ -11903,6 +11969,22 @@ var EgressTranscodeSchema = object({
11903
11969
  camStreamId: string().nullable()
11904
11970
  });
11905
11971
  method(object({
11972
+ deviceId: number().int().nonnegative(),
11973
+ /** The provider's signal code. */
11974
+ code: string().min(1),
11975
+ /** Ms epoch. Absent ⇒ now. */
11976
+ at: number().optional()
11977
+ }), object({
11978
+ /** Whether the broker acted on it, and if not, why. */
11979
+ accepted: boolean(),
11980
+ reason: _enum([
11981
+ "woke",
11982
+ "hold-extended",
11983
+ "not-enabled",
11984
+ "no-consumer",
11985
+ "unknown-code"
11986
+ ])
11987
+ }), { kind: "mutation" }), method(object({
11906
11988
  deviceId: number().int().nonnegative(),
11907
11989
  camStreamId: string().min(1),
11908
11990
  kind: CamStreamKindSchema,
@@ -12157,6 +12239,16 @@ var PickStreamRequirementsSchema = object({
12157
12239
  acceptCodecs: array(StreamCodecSchema).readonly().optional(),
12158
12240
  /** Minimum vertical resolution. Streams shorter than this are dropped. */
12159
12241
  minHeight: number().int().positive().optional(),
12242
+ /**
12243
+ * Maximum vertical resolution. Streams TALLER than this are dropped.
12244
+ *
12245
+ * A consumer can have a ceiling as real as its floor: Alexa documents
12246
+ * 480p to 1080p, and a 4K stream is as unusable to an Echo as a 360p one.
12247
+ * Without this the ceiling had to be re-implemented by every caller — and
12248
+ * one caller implementing it privately is how a second scoring authority
12249
+ * gets born.
12250
+ */
12251
+ maxHeight: number().int().positive().optional(),
12160
12252
  /** Minimum horizontal resolution. */
12161
12253
  minWidth: number().int().positive().optional(),
12162
12254
  /**
@@ -12173,7 +12265,22 @@ var PickStreamRequirementsSchema = object({
12173
12265
  * transcoded" guard: if the device is already serving the consumer's
12174
12266
  * codec end-to-end, there's nothing to optimise.
12175
12267
  */
12176
- requireSiblingCodec: array(StreamCodecSchema).readonly().optional()
12268
+ requireSiblingCodec: array(StreamCodecSchema).readonly().optional(),
12269
+ /**
12270
+ * Whether a stream the consumer CANNOT decode may still be picked, on the
12271
+ * understanding that it will be transcoded.
12272
+ *
12273
+ * Default `false` — today's behaviour, and the right one for a bypass
12274
+ * question ("is there a stream I can forward untouched?"). Set `true` to
12275
+ * ask the larger question: "what is the best stream for me, transcoding if
12276
+ * I must?" A stream that satisfies `acceptCodecs` always outranks one that
12277
+ * does not, so a passthrough is never lost to a transcode; the answer says
12278
+ * which it is in {@link PickedCamStreamSchema.transcodes}.
12279
+ *
12280
+ * This is what lets one picker serve both the bypass and the full source
12281
+ * choice, instead of a consumer scoring privately when the bypass misses.
12282
+ */
12283
+ allowTranscode: boolean().optional()
12177
12284
  }).readonly();
12178
12285
  var PickStreamPreferencesSchema = object({
12179
12286
  /**
@@ -12187,12 +12294,32 @@ var PickStreamPreferencesSchema = object({
12187
12294
  * picks the tallest stream; `'lowest'` picks the shortest (used by
12188
12295
  * memory-constrained consumers / Apple Home guest sessions).
12189
12296
  */
12190
- resolutionPreference: _enum(["highest", "lowest"]).optional()
12297
+ resolutionPreference: _enum(["highest", "lowest"]).optional(),
12298
+ /**
12299
+ * The height the consumer actually wants to DELIVER.
12300
+ *
12301
+ * Not a constraint — an ordering. With it set, the SMALLEST stream at or
12302
+ * above the target wins, and only if nothing reaches it does the tallest
12303
+ * take over. Pulling 1296 lines to draw 720 on a 1280x800 Echo panel costs
12304
+ * a decode and buys nothing, and `resolutionPreference: 'highest'` cannot
12305
+ * express that: it says "as big as possible", which is a different wish.
12306
+ *
12307
+ * Ignored when absent, so every existing caller keeps its ordering.
12308
+ */
12309
+ targetHeight: number().int().positive().optional()
12191
12310
  }).readonly();
12192
12311
  var PickedCamStreamSchema = object({
12193
12312
  camStreamId: string(),
12194
12313
  codec: string().optional(),
12195
12314
  resolution: CamStreamResolutionSchema.optional(),
12315
+ /**
12316
+ * Whether serving this stream requires a decode + re-encode.
12317
+ *
12318
+ * `false` is a stream the consumer can take as it stands. Only ever `true`
12319
+ * when the caller asked for it with `allowTranscode`, so a caller that did
12320
+ * not ask cannot be handed a cost it never agreed to pay.
12321
+ */
12322
+ transcodes: boolean(),
12196
12323
  /** One-line explanation of why this stream won — for logs / debug UI. */
12197
12324
  reason: string()
12198
12325
  });
@@ -16398,6 +16525,8 @@ var NcSystemEventKindSchema = _enum([
16398
16525
  "device-enabled",
16399
16526
  "device-battery-low",
16400
16527
  "device-battery-normal",
16528
+ "device-consumable-low",
16529
+ "device-consumable-normal",
16401
16530
  "stream-online",
16402
16531
  "stream-offline",
16403
16532
  "node-online",
@@ -16416,6 +16545,7 @@ var NcSystemEventKindSchema = _enum([
16416
16545
  "addon-updated",
16417
16546
  "server-updated",
16418
16547
  "export-completed",
16548
+ "backup-completed",
16419
16549
  "camera-online",
16420
16550
  "camera-offline",
16421
16551
  "camera-disabled",
@@ -17738,6 +17868,48 @@ var NcAlarmConfigSchema = object({
17738
17868
  settings: NcAlarmSettingsSchema,
17739
17869
  coverage: array(NcAlarmModeCoverageSchema)
17740
17870
  });
17871
+ /**
17872
+ * ONE rule's demand on ONE camera's clip ring.
17873
+ *
17874
+ * A rule, not a camera: the broker takes the MAX over the asks that reach a
17875
+ * camera, so the answer stays a faithful description of the rules and the
17876
+ * bounding (the byte budget, the broker's own ceiling) stays where the cost
17877
+ * lives. A camera that appears in no ask is being told **nothing** — which is
17878
+ * a different thing from never having been told, and only the envelope
17879
+ * (`rulesLoaded`) can tell those apart.
17880
+ */
17881
+ var NcClipRetentionAskSchema = object({
17882
+ /**
17883
+ * The camera this ask is about. **Absent = every camera**, which is what a
17884
+ * rule with no `conditions.devices` means: it can fire anywhere, so it is
17885
+ * asking everywhere.
17886
+ */
17887
+ deviceId: number().int().nonnegative().optional(),
17888
+ /** Seconds of history the rule needs held for it. Never zero — a rule that
17889
+ * needs nothing produces no ask at all. */
17890
+ seconds: number().min(0).max(60),
17891
+ /** The profile the rule cuts from, when it named one. Absent = the cheapest
17892
+ * assigned, which is what the cut defaults to. */
17893
+ profile: CamProfileSchema.optional(),
17894
+ /** Who is asking — so a retention the operator did not expect names a rule. */
17895
+ ruleId: string(),
17896
+ ruleName: string(),
17897
+ /** Why this many seconds: the rule's own window, or the occupancy ceiling. */
17898
+ reason: _enum(["window", "occupancy"])
17899
+ });
17900
+ /**
17901
+ * The whole answer, with the one bit that keeps absence from reading as zero.
17902
+ *
17903
+ * `rulesLoaded` is false until the rule ledger has completed a load at least
17904
+ * once. A centre that is up but has not read its rules yet answers with an
17905
+ * empty ask list that means nothing at all — applying it would drop every
17906
+ * camera's ring to zero for the first events after a restart, which is the
17907
+ * footage this mechanism exists to keep.
17908
+ */
17909
+ var NcClipRetentionPlanSchema = object({
17910
+ rulesLoaded: boolean(),
17911
+ asks: array(NcClipRetentionAskSchema).readonly()
17912
+ });
17741
17913
  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 }), {
17742
17914
  kind: "mutation",
17743
17915
  auth: "admin",
@@ -17758,7 +17930,7 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
17758
17930
  }), object({ success: literal(true) }), {
17759
17931
  kind: "mutation",
17760
17932
  auth: "admin"
17761
- }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
17933
+ }), method(object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
17762
17934
  deviceId: number().int(),
17763
17935
  muted: boolean()
17764
17936
  }), object({ success: literal(true) }), {
@@ -20292,6 +20464,33 @@ var RunReplayFrameProcessorResultSchema = object({ tracks: array(object({
20292
20464
  * solid is this track", cheaper than re-deriving it from a trajectory. */
20293
20465
  framesMatched: number().int()
20294
20466
  })).readonly() });
20467
+ /**
20468
+ * The long-term series a camera produces. A closed union so a typo cannot
20469
+ * invent one, and the ONE declaration of it — the addon's `AnalyticsLtsSeries`
20470
+ * is an alias of this, not a second list.
20471
+ */
20472
+ var AnalyticsLtsSeriesSchema = _enum([
20473
+ "motion",
20474
+ "audio-dbfs",
20475
+ "battery",
20476
+ "occupancy"
20477
+ ]);
20478
+ /**
20479
+ * One closed 5-minute bucket of a long-term series.
20480
+ *
20481
+ * `samples` is how many readings the bucket folded — it is the ACTIVITY for a
20482
+ * series like `motion`, and the confidence for one like `occupancy`. A bucket
20483
+ * that exists at all was measured; a bucket that is absent was not, which is a
20484
+ * different claim from zero and the reason this is a sparse series.
20485
+ */
20486
+ var LtsBucketSchema = object({
20487
+ scope: string(),
20488
+ bucketStart: number().int(),
20489
+ samples: number().int().nonnegative(),
20490
+ sum: number(),
20491
+ min: number(),
20492
+ max: number()
20493
+ });
20295
20494
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
20296
20495
  deviceId: number(),
20297
20496
  trackId: string()
@@ -20338,6 +20537,14 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20338
20537
  kinds: array(string()).optional(),
20339
20538
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
20340
20539
  }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
20540
+ deviceId: number(),
20541
+ series: AnalyticsLtsSeriesSchema,
20542
+ /** Omit for EVERY scope of this series in the range. */
20543
+ scope: string().optional(),
20544
+ from: number(),
20545
+ to: number(),
20546
+ limit: number().int().positive().optional()
20547
+ }), array(LtsBucketSchema).readonly()), method(object({
20341
20548
  deviceId: number(),
20342
20549
  since: number(),
20343
20550
  until: number(),
@@ -20956,6 +21163,14 @@ var MotionSourceEnum = _enum([
20956
21163
  */
20957
21164
  var MotionSourcesSchema = array(MotionSourceEnum);
20958
21165
  /**
21166
+ * Which root detectors a camera runs. Deliberately the SAME vocabulary
21167
+ * post-analysis already tags every detection with (`DetectionSource`) rather
21168
+ * than a second spelling of the same two ideas — the value an operator picks
21169
+ * here is the value that comes back on the track, the overlay and the debug
21170
+ * row.
21171
+ */
21172
+ var DetectionSourcesSchema = array(DetectionSourceSchema);
21173
+ /**
20959
21174
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
20960
21175
  * so cap-side consumers (the orchestrator forward, the runner addon's
20961
21176
  * cap implementation, tests) can reuse the type instead of redeclaring
@@ -21106,6 +21321,35 @@ var RunnerCameraConfigSchema = object({
21106
21321
  * events; the orchestrator forwards to `reportMotion`.
21107
21322
  */
21108
21323
  motionSources: MotionSourcesSchema.default(["analyzer"]),
21324
+ /**
21325
+ * WHICH root detector runs for this camera. The detection counterpart of
21326
+ * {@link motionSources}, same shape and same discipline: a per-camera list
21327
+ * of sources the system understands, vendor-agnostic, owned here.
21328
+ *
21329
+ * - `pipeline` — this runner's own root step on decoded pixels (`steps`).
21330
+ * - `onboard` — the CAMERA's own detector, admitted only when it is named
21331
+ * here. Its boxes reach post-analysis on the same
21332
+ * `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
21333
+ * track gets the same tracker, the same overlay and the same detail
21334
+ * subtree (face / plate / embedding).
21335
+ *
21336
+ * `['onboard']` alone is the REPLACEMENT: this runner's root step does not
21337
+ * run, and that is where a camera with a usable onboard detector buys back
21338
+ * its share of the accelerator. It saves the root inference, not the decode
21339
+ * — the detail subtree still needs pixels to cut crops from.
21340
+ *
21341
+ * A camera whose onboard detections carry no geometry cannot serve as a root
21342
+ * step at all (there is nothing to track), and the cap that knows this says
21343
+ * so on `native-object-detection.getOptions().geometry`. On Reolink that is
21344
+ * every battery camera: the boxes ride a sub-stream a battery camera never
21345
+ * attaches, so such a camera stays on `['pipeline']` and its onboard AI is
21346
+ * worth exactly what it already is — a wake signal with a class.
21347
+ *
21348
+ * Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
21349
+ * vendor never turns a detector on for the operator, and neither does a
21350
+ * default.
21351
+ */
21352
+ detectionSources: DetectionSourcesSchema.default(["pipeline"]),
21109
21353
  pipelineEnabled: boolean().default(true),
21110
21354
  /** Ordered tree of video steps. Absent → runner skips video detection. */
21111
21355
  steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -21287,7 +21531,47 @@ var RunnerLocalMetricsSchema = object({
21287
21531
  queueDepth: number(),
21288
21532
  frameLazy: FrameLazyMetricsSchema.optional()
21289
21533
  });
21534
+ /**
21535
+ * Pipeline Runner capability — runtime detection workhorse.
21536
+ *
21537
+ * One instance per node. Receives camera assignments from
21538
+ * `addon-pipeline-orchestrator`, subscribes to the local stream-broker for
21539
+ * decoded frames, drains motion + detection queues, calls the local
21540
+ * `motion-detection` and `pipeline-executor` capabilities, and emits typed
21541
+ * `pipeline.inference-result` and `detection.motion-analysis` events on
21542
+ * the bus.
21543
+ *
21544
+ * Distinct from `pipeline-orchestrator` (the hub-side load balancer) — the
21545
+ * runner has zero knowledge of other agents, no global state, and never
21546
+ * makes assignment decisions itself.
21547
+ */
21548
+ /**
21549
+ * Why a runner declined to look at a camera out of band. Named rather than a
21550
+ * bare `false`: a camera asleep on battery (D173), one attached elsewhere, one
21551
+ * already mid-session and one already bursting are four different facts, and a
21552
+ * caller told only "no" cannot tell a protection from a bug.
21553
+ */
21554
+ var OccupancyBurstRefusalSchema = _enum([
21555
+ "not-attached",
21556
+ "battery-asleep",
21557
+ "not-watching",
21558
+ "already-bursting"
21559
+ ]);
21290
21560
  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({
21561
+ deviceId: number(),
21562
+ /** How many frames to collect. The caller sizes this against what its
21563
+ * own confirmation needs; the runner clamps it to the field's range. */
21564
+ frames: number().int().positive().optional(),
21565
+ /** Why, for the log. A burst nobody can attribute is a cost nobody can
21566
+ * defend — the periodic one at least has a timer to point at. */
21567
+ reason: string()
21568
+ }), object({
21569
+ started: boolean(),
21570
+ refusedBecause: OccupancyBurstRefusalSchema.optional()
21571
+ }), {
21572
+ auth: "admin",
21573
+ kind: "mutation"
21574
+ }), method(object({
21291
21575
  handle: FrameHandleSchema,
21292
21576
  bbox: NativeCropBboxSchema,
21293
21577
  maxWidth: number().int().positive().optional(),
@@ -23657,10 +23941,28 @@ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), ar
23657
23941
  }), boolean()), method(object({
23658
23942
  deviceId: number().int().nonnegative(),
23659
23943
  sessionId: string()
23660
- }), object({ pendingRenegotiation: object({
23661
- target: WebrtcStreamTargetSchema,
23662
- epoch: number()
23663
- }).nullable() }));
23944
+ }), object({
23945
+ pendingRenegotiation: object({
23946
+ target: WebrtcStreamTargetSchema,
23947
+ epoch: number()
23948
+ }).nullable(),
23949
+ /**
23950
+ * Whether the session still EXISTS.
23951
+ *
23952
+ * A consumer that holds a resource for the life of a session needs to
23953
+ * be able to ask, because a session does not always end the way it
23954
+ * began. Measured on this hub 2026-09-13: an Echo that got stuck never
23955
+ * sent `SessionDisconnected`, so the Alexa exporter's
23956
+ * `releaseEgressTranscode` never ran, and a 2304x1296 HEVC to 720p
23957
+ * H.264 transcode kept running for NOBODY for more than twenty
23958
+ * minutes. The WebRTC session had logged `WebRTC session closed`
23959
+ * minutes earlier — the broker knew; the holder had no way to ask.
23960
+ *
23961
+ * `false` for a session id the provider has never heard of, which is
23962
+ * the same answer as "it ended": either way nothing is holding it up.
23963
+ */
23964
+ alive: boolean()
23965
+ }));
23664
23966
  object({
23665
23967
  /** All accessory children of the parent. */
23666
23968
  childDeviceIds: array(number()).readonly(),
@@ -26799,7 +27101,7 @@ var NativeDetectionSchema = object({
26799
27101
  /** Firmware-provided confidence [0..1]. Reolink pushes don't carry it → undefined. */
26800
27102
  confidence: number().min(0).max(1).optional()
26801
27103
  });
26802
- object({
27104
+ var NativeObjectDetectionStatusSchema = object({
26803
27105
  /**
26804
27106
  * Last observed instance per class. Missing entries mean the class
26805
27107
  * is supported but nothing has been seen since the provider started.
@@ -26816,14 +27118,56 @@ object({
26816
27118
  supportedClasses: array(NativeObjectClassEnum).readonly(),
26817
27119
  /**
26818
27120
  * Whether forwarding of onboard AI detections is enabled for this device.
26819
- * Default FALSE (opt-in, cold-start) — onboard AI pushes are noisy/sparse and
26820
- * churn the tracker, so forwarding stays off until the operator enables it.
27121
+ *
27122
+ * Cold-start OFF on every camera. A vendor does not decide which detector a
27123
+ * camera runs — that is the operator's choice, and it is made where every
27124
+ * other detection choice is made. `geometry` on
27125
+ * {@link NativeObjectDetectionOptionsSchema} is how the form says what the
27126
+ * choice would buy this particular camera.
26821
27127
  */
26822
27128
  enabled: boolean()
26823
- }).extend({
27129
+ });
27130
+ /**
27131
+ * WHEN a camera's onboard detections carry geometry.
27132
+ *
27133
+ * - `boxed` — always. The provider holds a standing channel for the boxes, so
27134
+ * a detection is a trackable subject whenever the camera sees one.
27135
+ * - `while-streaming` — only while some stream of this camera is already open.
27136
+ * The boxes ride the video's own side-channel rather than a feed of their
27137
+ * own, so they cost nothing and they exist only when something is pulling.
27138
+ * On Reolink this is every BATTERY camera: a persistent second feed is real
27139
+ * radio drain, but a camera that is awake is awake precisely because
27140
+ * something is in front of it, and its stream is already being pulled.
27141
+ * - `flag-only` — never. The firmware ships the class and nothing else; the
27142
+ * pipeline needs geometry to make a subject, so such a push reaches the
27143
+ * tracker as motion and no further.
27144
+ *
27145
+ * Reported and not inferred, because the operator's question in front of the
27146
+ * picker is "what do I get", and these are three different answers (D14: the
27147
+ * derived form is only as honest as `getOptions`).
27148
+ */
27149
+ var NativeObjectGeometryEnum = _enum([
27150
+ "boxed",
27151
+ "while-streaming",
27152
+ "flag-only"
27153
+ ]);
27154
+ var NativeObjectDetectionOptionsSchema = object({
27155
+ /** Classes this firmware can detect — the same list the status reports. */
27156
+ supportedClasses: array(NativeObjectClassEnum).readonly(),
27157
+ /** What a detection from this camera carries. */
27158
+ geometry: NativeObjectGeometryEnum
27159
+ });
27160
+ var NativeObjectDetectionSettingsPatchSchema = object({ enabled: boolean().optional() });
27161
+ NativeObjectDetectionStatusSchema.extend({
26824
27162
  /** Required by createRuntimeStateBridge — epoch ms of last refresh. */
26825
27163
  lastFetchedAt: number() });
26826
- DeviceType.Camera, method(object({
27164
+ DeviceType.Camera, method(object({ deviceId: number() }), NativeObjectDetectionOptionsSchema), method(object({
27165
+ deviceId: number(),
27166
+ settings: NativeObjectDetectionSettingsPatchSchema
27167
+ }), _void(), {
27168
+ kind: "mutation",
27169
+ auth: "admin"
27170
+ }), method(object({
26827
27171
  deviceId: number(),
26828
27172
  enabled: boolean()
26829
27173
  }), _void(), {
@@ -30622,7 +30966,28 @@ var PerScopeBreakdownSchema = object({
30622
30966
  /** Total tracked objects in this scope (frame / zone / unzoned). */
30623
30967
  totalObjects: number().int().nonnegative(),
30624
30968
  /** Per-class count. Keys are macro class names (e.g. `person`, `car`). */
30625
- byClass: record(string(), number().int().nonnegative())
30969
+ byClass: record(string(), number().int().nonnegative()),
30970
+ /**
30971
+ * Of `totalObjects`, how many are STANDING — objects the census holds,
30972
+ * present but not going anywhere (a parked car, a bin, a statue).
30973
+ *
30974
+ * The operator's question about a scene has two halves and they answer
30975
+ * different things: "what is parked here" is stable for hours and must not
30976
+ * flap, while "who is walking through" is the thing an alert is about. One
30977
+ * number could only serve one of them, and `totalObjects` served the first
30978
+ * badly — a passer-by moved it and every occupancy rule saw a change.
30979
+ *
30980
+ * `standing + transient === totalObjects`, always. The total keeps its old
30981
+ * meaning exactly, so no rule written against it changes behaviour.
30982
+ *
30983
+ * ABSENT means UNKNOWN, never zero (D393): a snapshot from a node older than
30984
+ * this field cannot say, and a reader that folds absence in as 0 reports "no
30985
+ * parked objects here" about a camera whose lot is full.
30986
+ */
30987
+ standingObjects: number().int().nonnegative().optional(),
30988
+ /** Of `totalObjects`, how many are passing through. See `standingObjects` —
30989
+ * same absence rule. */
30990
+ transientObjects: number().int().nonnegative().optional()
30626
30991
  });
30627
30992
  var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
30628
30993
  zoneId: string(),
@@ -33561,12 +33926,24 @@ Object.freeze({
33561
33926
  addonId: null,
33562
33927
  access: "create"
33563
33928
  },
33929
+ "nativeObjectDetection.getOptions": {
33930
+ capName: "native-object-detection",
33931
+ capScope: "device",
33932
+ addonId: null,
33933
+ access: "view"
33934
+ },
33564
33935
  "nativeObjectDetection.setEnabled": {
33565
33936
  capName: "native-object-detection",
33566
33937
  capScope: "device",
33567
33938
  addonId: null,
33568
33939
  access: "create"
33569
33940
  },
33941
+ "nativeObjectDetection.setSettings": {
33942
+ capName: "native-object-detection",
33943
+ capScope: "device",
33944
+ addonId: null,
33945
+ access: "create"
33946
+ },
33570
33947
  "navigation.getFeatures": {
33571
33948
  capName: "navigation",
33572
33949
  capScope: "device",
@@ -33831,6 +34208,12 @@ Object.freeze({
33831
34208
  addonId: null,
33832
34209
  access: "view"
33833
34210
  },
34211
+ "notificationRules.getClipRetentionAsks": {
34212
+ capName: "notification-rules",
34213
+ capScope: "system",
34214
+ addonId: null,
34215
+ access: "view"
34216
+ },
33834
34217
  "notificationRules.getConditionCatalog": {
33835
34218
  capName: "notification-rules",
33836
34219
  capScope: "system",
@@ -34341,6 +34724,12 @@ Object.freeze({
34341
34724
  addonId: null,
34342
34725
  access: "create"
34343
34726
  },
34727
+ "pipelineAnalytics.readLongTermSeries": {
34728
+ capName: "pipeline-analytics",
34729
+ capScope: "device",
34730
+ addonId: null,
34731
+ access: "view"
34732
+ },
34344
34733
  "pipelineAnalytics.rebuildObjectEmbeddings": {
34345
34734
  capName: "pipeline-analytics",
34346
34735
  capScope: "device",
@@ -35013,6 +35402,12 @@ Object.freeze({
35013
35402
  addonId: null,
35014
35403
  access: "create"
35015
35404
  },
35405
+ "pipelineRunner.requestOccupancyBurst": {
35406
+ capName: "pipeline-runner",
35407
+ capScope: "system",
35408
+ addonId: null,
35409
+ access: "create"
35410
+ },
35016
35411
  "pipelineRunner.runDetailSubtree": {
35017
35412
  capName: "pipeline-runner",
35018
35413
  capScope: "system",
@@ -36225,6 +36620,12 @@ Object.freeze({
36225
36620
  addonId: null,
36226
36621
  access: "create"
36227
36622
  },
36623
+ "streamBroker.reportStreamSignal": {
36624
+ capName: "stream-broker",
36625
+ capScope: "system",
36626
+ addonId: null,
36627
+ access: "create"
36628
+ },
36228
36629
  "streamBroker.restartProfile": {
36229
36630
  capName: "stream-broker",
36230
36631
  capScope: "system",
@@ -36309,6 +36710,12 @@ Object.freeze({
36309
36710
  addonId: null,
36310
36711
  access: "create"
36311
36712
  },
36713
+ "streamSignals.listSignals": {
36714
+ capName: "stream-signals",
36715
+ capScope: "device",
36716
+ addonId: null,
36717
+ access: "view"
36718
+ },
36312
36719
  "switch.setState": {
36313
36720
  capName: "switch",
36314
36721
  capScope: "device",
@@ -37781,11 +38188,21 @@ Object.freeze({
37781
38188
  form: "single",
37782
38189
  optional: false
37783
38190
  }],
38191
+ "nativeObjectDetection.getOptions": [{
38192
+ name: "deviceId",
38193
+ form: "single",
38194
+ optional: false
38195
+ }],
37784
38196
  "nativeObjectDetection.setEnabled": [{
37785
38197
  name: "deviceId",
37786
38198
  form: "single",
37787
38199
  optional: false
37788
38200
  }],
38201
+ "nativeObjectDetection.setSettings": [{
38202
+ name: "deviceId",
38203
+ form: "single",
38204
+ optional: false
38205
+ }],
37789
38206
  "navigation.getFeatures": [{
37790
38207
  name: "deviceId",
37791
38208
  form: "single",
@@ -38135,6 +38552,11 @@ Object.freeze({
38135
38552
  form: "single",
38136
38553
  optional: false
38137
38554
  }],
38555
+ "pipelineAnalytics.readLongTermSeries": [{
38556
+ name: "deviceId",
38557
+ form: "single",
38558
+ optional: false
38559
+ }],
38138
38560
  "pipelineAnalytics.rebuildObjectEmbeddings": [{
38139
38561
  name: "deviceId",
38140
38562
  form: "single",
@@ -38325,6 +38747,11 @@ Object.freeze({
38325
38747
  form: "single",
38326
38748
  optional: false
38327
38749
  }],
38750
+ "pipelineRunner.requestOccupancyBurst": [{
38751
+ name: "deviceId",
38752
+ form: "single",
38753
+ optional: false
38754
+ }],
38328
38755
  "pipelineRunner.runDetailSubtree": [{
38329
38756
  name: "deviceId",
38330
38757
  form: "single",
@@ -38681,6 +39108,11 @@ Object.freeze({
38681
39108
  form: "single",
38682
39109
  optional: false
38683
39110
  }],
39111
+ "streamBroker.reportStreamSignal": [{
39112
+ name: "deviceId",
39113
+ form: "single",
39114
+ optional: false
39115
+ }],
38684
39116
  "streamBroker.restartProfile": [{
38685
39117
  name: "deviceId",
38686
39118
  form: "single",