@camstack/addon-provider-hikvision 1.2.110 → 1.2.112

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.
Files changed (3) hide show
  1. package/dist/addon.js +367 -26
  2. package/dist/addon.mjs +367 -26
  3. package/package.json +2 -2
package/dist/addon.js CHANGED
@@ -5367,7 +5367,7 @@ var ZodIssueCode = {
5367
5367
  var ZodFirstPartyTypeKind;
5368
5368
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5369
5369
  //#endregion
5370
- //#region ../types/dist/sleep-DEuj7E3j.mjs
5370
+ //#region ../types/dist/sleep-BDR76Ykr.mjs
5371
5371
  /**
5372
5372
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5373
5373
  * window to float samples (D455).
@@ -7252,6 +7252,18 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
7252
7252
  DeviceRole["GenericNotifier"] = "generic-notifier";
7253
7253
  return DeviceRole;
7254
7254
  }({});
7255
+ function deviceCustomAction(input, output, options) {
7256
+ return {
7257
+ input,
7258
+ output,
7259
+ kind: options?.kind ?? "query",
7260
+ auth: options?.auth ?? "protected",
7261
+ scope: {
7262
+ kind: "device",
7263
+ ...options?.deviceTypes ? { deviceTypes: options.deviceTypes } : {}
7264
+ }
7265
+ };
7266
+ }
7255
7267
  var StaticDirOutputSchema = object({ staticDir: string() });
7256
7268
  var VersionOutputSchema = object({ version: string() });
7257
7269
  method(_void(), StaticDirOutputSchema, { auth: "admin" }), method(_void(), VersionOutputSchema, { auth: "admin" });
@@ -11838,6 +11850,21 @@ var streamSignalsCapability = {
11838
11850
  mode: "singleton",
11839
11851
  deviceTypes: Object.values(DeviceType),
11840
11852
  runtimeState: StreamSignalsStatusSchema,
11853
+ /**
11854
+ * Runtime-state durability: **session** — mirrored in RAM, never written.
11855
+ *
11856
+ * The slice holds what the DEVICE says it can emit. That is a probed fact,
11857
+ * not an operator choice: the provider re-declares it on every registration,
11858
+ * so losing it loses nothing and persisting it would freeze an answer the
11859
+ * camera is entitled to change. Measured the same day on the sibling case —
11860
+ * `native-object-detection.supportedClasses` was persisted, and a firmware
11861
+ * class the camera really detected stayed missing for the life of the row
11862
+ * because the fix could not reach it.
11863
+ *
11864
+ * See `RuntimeStateDurability`. Enforced by
11865
+ * `scripts/check-runtime-state-durability.ts`.
11866
+ */
11867
+ durability: "session",
11841
11868
  methods: {
11842
11869
  /**
11843
11870
  * What this device can emit. Empty is a valid and common answer — most
@@ -12811,18 +12838,6 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
12811
12838
  filePath: string(),
12812
12839
  content: string()
12813
12840
  })) }), { auth: "admin" });
12814
- function deviceCustomAction(input, output, options) {
12815
- return {
12816
- input,
12817
- output,
12818
- kind: options?.kind ?? "query",
12819
- auth: options?.auth ?? "protected",
12820
- scope: {
12821
- kind: "device",
12822
- ...options?.deviceTypes ? { deviceTypes: options.deviceTypes } : {}
12823
- }
12824
- };
12825
- }
12826
12841
  /**
12827
12842
  * `custom-model-registry` — collection cap exposing operator-registered
12828
12843
  * custom detection models. Each provider (today: `addon-model-studio`)
@@ -18483,6 +18498,48 @@ var NcAlarmConfigSchema = object({
18483
18498
  settings: NcAlarmSettingsSchema,
18484
18499
  coverage: array(NcAlarmModeCoverageSchema)
18485
18500
  });
18501
+ /**
18502
+ * ONE rule's demand on ONE camera's clip ring.
18503
+ *
18504
+ * A rule, not a camera: the broker takes the MAX over the asks that reach a
18505
+ * camera, so the answer stays a faithful description of the rules and the
18506
+ * bounding (the byte budget, the broker's own ceiling) stays where the cost
18507
+ * lives. A camera that appears in no ask is being told **nothing** — which is
18508
+ * a different thing from never having been told, and only the envelope
18509
+ * (`rulesLoaded`) can tell those apart.
18510
+ */
18511
+ var NcClipRetentionAskSchema = object({
18512
+ /**
18513
+ * The camera this ask is about. **Absent = every camera**, which is what a
18514
+ * rule with no `conditions.devices` means: it can fire anywhere, so it is
18515
+ * asking everywhere.
18516
+ */
18517
+ deviceId: number().int().nonnegative().optional(),
18518
+ /** Seconds of history the rule needs held for it. Never zero — a rule that
18519
+ * needs nothing produces no ask at all. */
18520
+ seconds: number().min(0).max(60),
18521
+ /** The profile the rule cuts from, when it named one. Absent = the cheapest
18522
+ * assigned, which is what the cut defaults to. */
18523
+ profile: CamProfileSchema.optional(),
18524
+ /** Who is asking — so a retention the operator did not expect names a rule. */
18525
+ ruleId: string(),
18526
+ ruleName: string(),
18527
+ /** Why this many seconds: the rule's own window, or the occupancy ceiling. */
18528
+ reason: _enum(["window", "occupancy"])
18529
+ });
18530
+ /**
18531
+ * The whole answer, with the one bit that keeps absence from reading as zero.
18532
+ *
18533
+ * `rulesLoaded` is false until the rule ledger has completed a load at least
18534
+ * once. A centre that is up but has not read its rules yet answers with an
18535
+ * empty ask list that means nothing at all — applying it would drop every
18536
+ * camera's ring to zero for the first events after a restart, which is the
18537
+ * footage this mechanism exists to keep.
18538
+ */
18539
+ var NcClipRetentionPlanSchema = object({
18540
+ rulesLoaded: boolean(),
18541
+ asks: array(NcClipRetentionAskSchema).readonly()
18542
+ });
18486
18543
  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 }), {
18487
18544
  kind: "mutation",
18488
18545
  auth: "admin",
@@ -18503,7 +18560,7 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
18503
18560
  }), object({ success: literal(true) }), {
18504
18561
  kind: "mutation",
18505
18562
  auth: "admin"
18506
- }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
18563
+ }), method(object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
18507
18564
  deviceId: number().int(),
18508
18565
  muted: boolean()
18509
18566
  }), object({ success: literal(true) }), {
@@ -19688,13 +19745,26 @@ var TrackAudioLabelSchema = object({
19688
19745
  * - `audio` — an audio event on the camera itself that was anomalous for
19689
19746
  * THAT camera, loud, and heard while nothing visual was happening (D62).
19690
19747
  *
19748
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
19749
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
19750
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
19751
+ * detector.
19752
+ *
19753
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
19754
+ * a persisted onboard track failed `safeParse` on read and came back with NO
19755
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
19756
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
19757
+ * could not name.
19758
+ *
19691
19759
  * The spatial subsystems (tracker association, occupancy count, re-id /
19692
19760
  * embedding, resurrection) MUST skip every synthetic source. Test for that
19693
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
19694
- * check silently readmits every source added after it was written.
19761
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
19762
+ * `!== 'sensor'` check silently readmits every source added after it was
19763
+ * written.
19695
19764
  */
19696
19765
  var TrackSourceSchema = _enum([
19697
19766
  "pipeline",
19767
+ "onboard",
19698
19768
  "sensor",
19699
19769
  "audio"
19700
19770
  ]);
@@ -21077,6 +21147,33 @@ var RunReplayFrameProcessorResultSchema = object({ tracks: array(object({
21077
21147
  * solid is this track", cheaper than re-deriving it from a trajectory. */
21078
21148
  framesMatched: number().int()
21079
21149
  })).readonly() });
21150
+ /**
21151
+ * The long-term series a camera produces. A closed union so a typo cannot
21152
+ * invent one, and the ONE declaration of it — the addon's `AnalyticsLtsSeries`
21153
+ * is an alias of this, not a second list.
21154
+ */
21155
+ var AnalyticsLtsSeriesSchema = _enum([
21156
+ "motion",
21157
+ "audio-dbfs",
21158
+ "battery",
21159
+ "occupancy"
21160
+ ]);
21161
+ /**
21162
+ * One closed 5-minute bucket of a long-term series.
21163
+ *
21164
+ * `samples` is how many readings the bucket folded — it is the ACTIVITY for a
21165
+ * series like `motion`, and the confidence for one like `occupancy`. A bucket
21166
+ * that exists at all was measured; a bucket that is absent was not, which is a
21167
+ * different claim from zero and the reason this is a sparse series.
21168
+ */
21169
+ var LtsBucketSchema = object({
21170
+ scope: string(),
21171
+ bucketStart: number().int(),
21172
+ samples: number().int().nonnegative(),
21173
+ sum: number(),
21174
+ min: number(),
21175
+ max: number()
21176
+ });
21080
21177
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
21081
21178
  deviceId: number(),
21082
21179
  trackId: string()
@@ -21123,6 +21220,14 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
21123
21220
  kinds: array(string()).optional(),
21124
21221
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
21125
21222
  }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
21223
+ deviceId: number(),
21224
+ series: AnalyticsLtsSeriesSchema,
21225
+ /** Omit for EVERY scope of this series in the range. */
21226
+ scope: string().optional(),
21227
+ from: number(),
21228
+ to: number(),
21229
+ limit: number().int().positive().optional()
21230
+ }), array(LtsBucketSchema).readonly()), method(object({
21126
21231
  deviceId: number(),
21127
21232
  since: number(),
21128
21233
  until: number(),
@@ -21741,6 +21846,40 @@ var MotionSourceEnum = _enum([
21741
21846
  */
21742
21847
  var MotionSourcesSchema = array(MotionSourceEnum);
21743
21848
  /**
21849
+ * Which root detector a camera runs — EXACTLY ONE.
21850
+ *
21851
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
21852
+ * with (`DetectionSource`) rather than a second spelling of the same two
21853
+ * ideas: the value an operator picks here is the value that comes back on the
21854
+ * track, the overlay and the debug row.
21855
+ *
21856
+ * ## Why one, and why it is still an array
21857
+ *
21858
+ * Two roots on one camera is a capability nobody asked for and the operator has
21859
+ * since ruled out. It was never free: both planes feed the SAME per-device
21860
+ * stationary registry, both can promote the same parked object, and the two
21861
+ * detectors disagree about the same box by construction — which is the
21862
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
21863
+ *
21864
+ * The ARRAY shape survives because the stored settings and the attach payload
21865
+ * already speak it on every camera of every fleet, and a cap input that
21866
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
21867
+ * in the one direction that costs an operator their cameras. So the wire stays
21868
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
21869
+ * element rather than refused, and `max(1)` is what every consumer can then
21870
+ * rely on.
21871
+ *
21872
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
21873
+ * a camera an operator left with no root detector — and `planDetectionSources`
21874
+ * has always said so: inventing a root for them is how a default acts without
21875
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
21876
+ * suite caught it.
21877
+ *
21878
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
21879
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
21880
+ */
21881
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
21882
+ /**
21744
21883
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21745
21884
  * so cap-side consumers (the orchestrator forward, the runner addon's
21746
21885
  * cap implementation, tests) can reuse the type instead of redeclaring
@@ -21891,6 +22030,35 @@ var RunnerCameraConfigSchema = object({
21891
22030
  * events; the orchestrator forwards to `reportMotion`.
21892
22031
  */
21893
22032
  motionSources: MotionSourcesSchema.default(["analyzer"]),
22033
+ /**
22034
+ * WHICH root detector runs for this camera. The detection counterpart of
22035
+ * {@link motionSources}, same shape and same discipline: a per-camera list
22036
+ * of sources the system understands, vendor-agnostic, owned here.
22037
+ *
22038
+ * - `pipeline` — this runner's own root step on decoded pixels (`steps`).
22039
+ * - `onboard` — the CAMERA's own detector, admitted only when it is named
22040
+ * here. Its boxes reach post-analysis on the same
22041
+ * `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
22042
+ * track gets the same tracker, the same overlay and the same detail
22043
+ * subtree (face / plate / embedding).
22044
+ *
22045
+ * `['onboard']` alone is the REPLACEMENT: this runner's root step does not
22046
+ * run, and that is where a camera with a usable onboard detector buys back
22047
+ * its share of the accelerator. It saves the root inference, not the decode
22048
+ * — the detail subtree still needs pixels to cut crops from.
22049
+ *
22050
+ * A camera whose onboard detections carry no geometry cannot serve as a root
22051
+ * step at all (there is nothing to track), and the cap that knows this says
22052
+ * so on `native-object-detection.getOptions().geometry`. On Reolink that is
22053
+ * every battery camera: the boxes ride a sub-stream a battery camera never
22054
+ * attaches, so such a camera stays on `['pipeline']` and its onboard AI is
22055
+ * worth exactly what it already is — a wake signal with a class.
22056
+ *
22057
+ * Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
22058
+ * vendor never turns a detector on for the operator, and neither does a
22059
+ * default.
22060
+ */
22061
+ detectionSources: DetectionSourcesSchema.default(["pipeline"]),
21894
22062
  pipelineEnabled: boolean().default(true),
21895
22063
  /** Ordered tree of video steps. Absent → runner skips video detection. */
21896
22064
  steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -22072,7 +22240,47 @@ var RunnerLocalMetricsSchema = object({
22072
22240
  queueDepth: number(),
22073
22241
  frameLazy: FrameLazyMetricsSchema.optional()
22074
22242
  });
22243
+ /**
22244
+ * Pipeline Runner capability — runtime detection workhorse.
22245
+ *
22246
+ * One instance per node. Receives camera assignments from
22247
+ * `addon-pipeline-orchestrator`, subscribes to the local stream-broker for
22248
+ * decoded frames, drains motion + detection queues, calls the local
22249
+ * `motion-detection` and `pipeline-executor` capabilities, and emits typed
22250
+ * `pipeline.inference-result` and `detection.motion-analysis` events on
22251
+ * the bus.
22252
+ *
22253
+ * Distinct from `pipeline-orchestrator` (the hub-side load balancer) — the
22254
+ * runner has zero knowledge of other agents, no global state, and never
22255
+ * makes assignment decisions itself.
22256
+ */
22257
+ /**
22258
+ * Why a runner declined to look at a camera out of band. Named rather than a
22259
+ * bare `false`: a camera asleep on battery (D173), one attached elsewhere, one
22260
+ * already mid-session and one already bursting are four different facts, and a
22261
+ * caller told only "no" cannot tell a protection from a bug.
22262
+ */
22263
+ var OccupancyBurstRefusalSchema = _enum([
22264
+ "not-attached",
22265
+ "battery-asleep",
22266
+ "not-watching",
22267
+ "already-bursting"
22268
+ ]);
22075
22269
  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({
22270
+ deviceId: number(),
22271
+ /** How many frames to collect. The caller sizes this against what its
22272
+ * own confirmation needs; the runner clamps it to the field's range. */
22273
+ frames: number().int().positive().optional(),
22274
+ /** Why, for the log. A burst nobody can attribute is a cost nobody can
22275
+ * defend — the periodic one at least has a timer to point at. */
22276
+ reason: string()
22277
+ }), object({
22278
+ started: boolean(),
22279
+ refusedBecause: OccupancyBurstRefusalSchema.optional()
22280
+ }), {
22281
+ auth: "admin",
22282
+ kind: "mutation"
22283
+ }), method(object({
22076
22284
  handle: FrameHandleSchema,
22077
22285
  bbox: NativeCropBboxSchema,
22078
22286
  maxWidth: number().int().positive().optional(),
@@ -29031,11 +29239,46 @@ var NativeObjectDetectionStatusSchema = object({
29031
29239
  supportedClasses: array(NativeObjectClassEnum).readonly(),
29032
29240
  /**
29033
29241
  * Whether forwarding of onboard AI detections is enabled for this device.
29034
- * Default FALSE (opt-in, cold-start) — onboard AI pushes are noisy/sparse and
29035
- * churn the tracker, so forwarding stays off until the operator enables it.
29242
+ *
29243
+ * Cold-start OFF on every camera. A vendor does not decide which detector a
29244
+ * camera runs — that is the operator's choice, and it is made where every
29245
+ * other detection choice is made. `geometry` on
29246
+ * {@link NativeObjectDetectionOptionsSchema} is how the form says what the
29247
+ * choice would buy this particular camera.
29036
29248
  */
29037
29249
  enabled: boolean()
29038
29250
  });
29251
+ /**
29252
+ * WHEN a camera's onboard detections carry geometry.
29253
+ *
29254
+ * - `boxed` — always. The provider holds a standing channel for the boxes, so
29255
+ * a detection is a trackable subject whenever the camera sees one.
29256
+ * - `while-streaming` — only while some stream of this camera is already open.
29257
+ * The boxes ride the video's own side-channel rather than a feed of their
29258
+ * own, so they cost nothing and they exist only when something is pulling.
29259
+ * On Reolink this is every BATTERY camera: a persistent second feed is real
29260
+ * radio drain, but a camera that is awake is awake precisely because
29261
+ * something is in front of it, and its stream is already being pulled.
29262
+ * - `flag-only` — never. The firmware ships the class and nothing else; the
29263
+ * pipeline needs geometry to make a subject, so such a push reaches the
29264
+ * tracker as motion and no further.
29265
+ *
29266
+ * Reported and not inferred, because the operator's question in front of the
29267
+ * picker is "what do I get", and these are three different answers (D14: the
29268
+ * derived form is only as honest as `getOptions`).
29269
+ */
29270
+ var NativeObjectGeometryEnum = _enum([
29271
+ "boxed",
29272
+ "while-streaming",
29273
+ "flag-only"
29274
+ ]);
29275
+ var NativeObjectDetectionOptionsSchema = object({
29276
+ /** Classes this firmware can detect — the same list the status reports. */
29277
+ supportedClasses: array(NativeObjectClassEnum).readonly(),
29278
+ /** What a detection from this camera carries. */
29279
+ geometry: NativeObjectGeometryEnum
29280
+ });
29281
+ var NativeObjectDetectionSettingsPatchSchema = object({ enabled: boolean().optional() });
29039
29282
  var NativeObjectDetectionRuntimeStateSchema = NativeObjectDetectionStatusSchema.extend({
29040
29283
  /** Required by createRuntimeStateBridge — epoch ms of last refresh. */
29041
29284
  lastFetchedAt: number() });
@@ -29045,13 +29288,23 @@ var nativeObjectDetectionCapability = {
29045
29288
  deviceNative: true,
29046
29289
  mode: "singleton",
29047
29290
  deviceTypes: [DeviceType.Camera],
29048
- methods: { setEnabled: method(object({
29049
- deviceId: number(),
29050
- enabled: boolean()
29051
- }), _void(), {
29052
- kind: "mutation",
29053
- auth: "admin"
29054
- }) },
29291
+ methods: {
29292
+ getOptions: method(object({ deviceId: number() }), NativeObjectDetectionOptionsSchema),
29293
+ setSettings: method(object({
29294
+ deviceId: number(),
29295
+ settings: NativeObjectDetectionSettingsPatchSchema
29296
+ }), _void(), {
29297
+ kind: "mutation",
29298
+ auth: "admin"
29299
+ }),
29300
+ setEnabled: method(object({
29301
+ deviceId: number(),
29302
+ enabled: boolean()
29303
+ }), _void(), {
29304
+ kind: "mutation",
29305
+ auth: "admin"
29306
+ })
29307
+ },
29055
29308
  events: { onDetected: { data: object({
29056
29309
  deviceId: number(),
29057
29310
  detection: NativeDetectionSchema
@@ -34230,7 +34483,28 @@ var PerScopeBreakdownSchema = object({
34230
34483
  /** Total tracked objects in this scope (frame / zone / unzoned). */
34231
34484
  totalObjects: number().int().nonnegative(),
34232
34485
  /** Per-class count. Keys are macro class names (e.g. `person`, `car`). */
34233
- byClass: record(string(), number().int().nonnegative())
34486
+ byClass: record(string(), number().int().nonnegative()),
34487
+ /**
34488
+ * Of `totalObjects`, how many are STANDING — objects the census holds,
34489
+ * present but not going anywhere (a parked car, a bin, a statue).
34490
+ *
34491
+ * The operator's question about a scene has two halves and they answer
34492
+ * different things: "what is parked here" is stable for hours and must not
34493
+ * flap, while "who is walking through" is the thing an alert is about. One
34494
+ * number could only serve one of them, and `totalObjects` served the first
34495
+ * badly — a passer-by moved it and every occupancy rule saw a change.
34496
+ *
34497
+ * `standing + transient === totalObjects`, always. The total keeps its old
34498
+ * meaning exactly, so no rule written against it changes behaviour.
34499
+ *
34500
+ * ABSENT means UNKNOWN, never zero (D393): a snapshot from a node older than
34501
+ * this field cannot say, and a reader that folds absence in as 0 reports "no
34502
+ * parked objects here" about a camera whose lot is full.
34503
+ */
34504
+ standingObjects: number().int().nonnegative().optional(),
34505
+ /** Of `totalObjects`, how many are passing through. See `standingObjects` —
34506
+ * same absence rule. */
34507
+ transientObjects: number().int().nonnegative().optional()
34234
34508
  });
34235
34509
  var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
34236
34510
  zoneId: string(),
@@ -34353,6 +34627,23 @@ var HistoryPointSchema = object({
34353
34627
  * triple covers the three spatial scopes (per-zone, frame-wide,
34354
34628
  * outside-any-zone). Crossing them with `className?` gives the full
34355
34629
  * combinatorial coverage the operator UI requested.
34630
+ *
34631
+ * ## ⚠️ The three history methods are DEPRECATED
34632
+ *
34633
+ * They are served from a 60-MINUTE in-memory ring. It dies with the process,
34634
+ * so after a restart they report nothing about a night that did happen, and any
34635
+ * window past an hour is silently clamped — a caller cannot tell a clamp from
34636
+ * an empty scene. The presets in the occupancy chart existed to hide that
34637
+ * horizon rather than to answer a question.
34638
+ *
34639
+ * Use `pipelineAnalytics.readLongTermSeries({ series: 'occupancy', scope })`
34640
+ * instead. Those rows are already written for every camera, ~60 bytes per
34641
+ * (camera, scope, 5-minute bucket), kept for a year, and survive a restart.
34642
+ * Spell the scope with `occupancyScope(zoneId?, className?)` — the same
34643
+ * function the writer uses, so the two cannot drift.
34644
+ *
34645
+ * The ring stays until these three go, and it is the only thing left reading
34646
+ * it. Do not add a fourth caller.
34356
34647
  */
34357
34648
  var zoneAnalyticsCapability = {
34358
34649
  name: "zone-analytics",
@@ -38985,12 +39276,24 @@ Object.freeze({
38985
39276
  addonId: null,
38986
39277
  access: "create"
38987
39278
  },
39279
+ "nativeObjectDetection.getOptions": {
39280
+ capName: "native-object-detection",
39281
+ capScope: "device",
39282
+ addonId: null,
39283
+ access: "view"
39284
+ },
38988
39285
  "nativeObjectDetection.setEnabled": {
38989
39286
  capName: "native-object-detection",
38990
39287
  capScope: "device",
38991
39288
  addonId: null,
38992
39289
  access: "create"
38993
39290
  },
39291
+ "nativeObjectDetection.setSettings": {
39292
+ capName: "native-object-detection",
39293
+ capScope: "device",
39294
+ addonId: null,
39295
+ access: "create"
39296
+ },
38994
39297
  "navigation.getFeatures": {
38995
39298
  capName: "navigation",
38996
39299
  capScope: "device",
@@ -39255,6 +39558,12 @@ Object.freeze({
39255
39558
  addonId: null,
39256
39559
  access: "view"
39257
39560
  },
39561
+ "notificationRules.getClipRetentionAsks": {
39562
+ capName: "notification-rules",
39563
+ capScope: "system",
39564
+ addonId: null,
39565
+ access: "view"
39566
+ },
39258
39567
  "notificationRules.getConditionCatalog": {
39259
39568
  capName: "notification-rules",
39260
39569
  capScope: "system",
@@ -39765,6 +40074,12 @@ Object.freeze({
39765
40074
  addonId: null,
39766
40075
  access: "create"
39767
40076
  },
40077
+ "pipelineAnalytics.readLongTermSeries": {
40078
+ capName: "pipeline-analytics",
40079
+ capScope: "device",
40080
+ addonId: null,
40081
+ access: "view"
40082
+ },
39768
40083
  "pipelineAnalytics.rebuildObjectEmbeddings": {
39769
40084
  capName: "pipeline-analytics",
39770
40085
  capScope: "device",
@@ -40437,6 +40752,12 @@ Object.freeze({
40437
40752
  addonId: null,
40438
40753
  access: "create"
40439
40754
  },
40755
+ "pipelineRunner.requestOccupancyBurst": {
40756
+ capName: "pipeline-runner",
40757
+ capScope: "system",
40758
+ addonId: null,
40759
+ access: "create"
40760
+ },
40440
40761
  "pipelineRunner.runDetailSubtree": {
40441
40762
  capName: "pipeline-runner",
40442
40763
  capScope: "system",
@@ -43217,11 +43538,21 @@ Object.freeze({
43217
43538
  form: "single",
43218
43539
  optional: false
43219
43540
  }],
43541
+ "nativeObjectDetection.getOptions": [{
43542
+ name: "deviceId",
43543
+ form: "single",
43544
+ optional: false
43545
+ }],
43220
43546
  "nativeObjectDetection.setEnabled": [{
43221
43547
  name: "deviceId",
43222
43548
  form: "single",
43223
43549
  optional: false
43224
43550
  }],
43551
+ "nativeObjectDetection.setSettings": [{
43552
+ name: "deviceId",
43553
+ form: "single",
43554
+ optional: false
43555
+ }],
43225
43556
  "navigation.getFeatures": [{
43226
43557
  name: "deviceId",
43227
43558
  form: "single",
@@ -43571,6 +43902,11 @@ Object.freeze({
43571
43902
  form: "single",
43572
43903
  optional: false
43573
43904
  }],
43905
+ "pipelineAnalytics.readLongTermSeries": [{
43906
+ name: "deviceId",
43907
+ form: "single",
43908
+ optional: false
43909
+ }],
43574
43910
  "pipelineAnalytics.rebuildObjectEmbeddings": [{
43575
43911
  name: "deviceId",
43576
43912
  form: "single",
@@ -43761,6 +44097,11 @@ Object.freeze({
43761
44097
  form: "single",
43762
44098
  optional: false
43763
44099
  }],
44100
+ "pipelineRunner.requestOccupancyBurst": [{
44101
+ name: "deviceId",
44102
+ form: "single",
44103
+ optional: false
44104
+ }],
43764
44105
  "pipelineRunner.runDetailSubtree": [{
43765
44106
  name: "deviceId",
43766
44107
  form: "single",
package/dist/addon.mjs CHANGED
@@ -5368,7 +5368,7 @@ var ZodIssueCode = {
5368
5368
  var ZodFirstPartyTypeKind;
5369
5369
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5370
5370
  //#endregion
5371
- //#region ../types/dist/sleep-DEuj7E3j.mjs
5371
+ //#region ../types/dist/sleep-BDR76Ykr.mjs
5372
5372
  /**
5373
5373
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5374
5374
  * window to float samples (D455).
@@ -7253,6 +7253,18 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
7253
7253
  DeviceRole["GenericNotifier"] = "generic-notifier";
7254
7254
  return DeviceRole;
7255
7255
  }({});
7256
+ function deviceCustomAction(input, output, options) {
7257
+ return {
7258
+ input,
7259
+ output,
7260
+ kind: options?.kind ?? "query",
7261
+ auth: options?.auth ?? "protected",
7262
+ scope: {
7263
+ kind: "device",
7264
+ ...options?.deviceTypes ? { deviceTypes: options.deviceTypes } : {}
7265
+ }
7266
+ };
7267
+ }
7256
7268
  var StaticDirOutputSchema = object({ staticDir: string() });
7257
7269
  var VersionOutputSchema = object({ version: string() });
7258
7270
  method(_void(), StaticDirOutputSchema, { auth: "admin" }), method(_void(), VersionOutputSchema, { auth: "admin" });
@@ -11839,6 +11851,21 @@ var streamSignalsCapability = {
11839
11851
  mode: "singleton",
11840
11852
  deviceTypes: Object.values(DeviceType),
11841
11853
  runtimeState: StreamSignalsStatusSchema,
11854
+ /**
11855
+ * Runtime-state durability: **session** — mirrored in RAM, never written.
11856
+ *
11857
+ * The slice holds what the DEVICE says it can emit. That is a probed fact,
11858
+ * not an operator choice: the provider re-declares it on every registration,
11859
+ * so losing it loses nothing and persisting it would freeze an answer the
11860
+ * camera is entitled to change. Measured the same day on the sibling case —
11861
+ * `native-object-detection.supportedClasses` was persisted, and a firmware
11862
+ * class the camera really detected stayed missing for the life of the row
11863
+ * because the fix could not reach it.
11864
+ *
11865
+ * See `RuntimeStateDurability`. Enforced by
11866
+ * `scripts/check-runtime-state-durability.ts`.
11867
+ */
11868
+ durability: "session",
11842
11869
  methods: {
11843
11870
  /**
11844
11871
  * What this device can emit. Empty is a valid and common answer — most
@@ -12812,18 +12839,6 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
12812
12839
  filePath: string(),
12813
12840
  content: string()
12814
12841
  })) }), { auth: "admin" });
12815
- function deviceCustomAction(input, output, options) {
12816
- return {
12817
- input,
12818
- output,
12819
- kind: options?.kind ?? "query",
12820
- auth: options?.auth ?? "protected",
12821
- scope: {
12822
- kind: "device",
12823
- ...options?.deviceTypes ? { deviceTypes: options.deviceTypes } : {}
12824
- }
12825
- };
12826
- }
12827
12842
  /**
12828
12843
  * `custom-model-registry` — collection cap exposing operator-registered
12829
12844
  * custom detection models. Each provider (today: `addon-model-studio`)
@@ -18484,6 +18499,48 @@ var NcAlarmConfigSchema = object({
18484
18499
  settings: NcAlarmSettingsSchema,
18485
18500
  coverage: array(NcAlarmModeCoverageSchema)
18486
18501
  });
18502
+ /**
18503
+ * ONE rule's demand on ONE camera's clip ring.
18504
+ *
18505
+ * A rule, not a camera: the broker takes the MAX over the asks that reach a
18506
+ * camera, so the answer stays a faithful description of the rules and the
18507
+ * bounding (the byte budget, the broker's own ceiling) stays where the cost
18508
+ * lives. A camera that appears in no ask is being told **nothing** — which is
18509
+ * a different thing from never having been told, and only the envelope
18510
+ * (`rulesLoaded`) can tell those apart.
18511
+ */
18512
+ var NcClipRetentionAskSchema = object({
18513
+ /**
18514
+ * The camera this ask is about. **Absent = every camera**, which is what a
18515
+ * rule with no `conditions.devices` means: it can fire anywhere, so it is
18516
+ * asking everywhere.
18517
+ */
18518
+ deviceId: number().int().nonnegative().optional(),
18519
+ /** Seconds of history the rule needs held for it. Never zero — a rule that
18520
+ * needs nothing produces no ask at all. */
18521
+ seconds: number().min(0).max(60),
18522
+ /** The profile the rule cuts from, when it named one. Absent = the cheapest
18523
+ * assigned, which is what the cut defaults to. */
18524
+ profile: CamProfileSchema.optional(),
18525
+ /** Who is asking — so a retention the operator did not expect names a rule. */
18526
+ ruleId: string(),
18527
+ ruleName: string(),
18528
+ /** Why this many seconds: the rule's own window, or the occupancy ceiling. */
18529
+ reason: _enum(["window", "occupancy"])
18530
+ });
18531
+ /**
18532
+ * The whole answer, with the one bit that keeps absence from reading as zero.
18533
+ *
18534
+ * `rulesLoaded` is false until the rule ledger has completed a load at least
18535
+ * once. A centre that is up but has not read its rules yet answers with an
18536
+ * empty ask list that means nothing at all — applying it would drop every
18537
+ * camera's ring to zero for the first events after a restart, which is the
18538
+ * footage this mechanism exists to keep.
18539
+ */
18540
+ var NcClipRetentionPlanSchema = object({
18541
+ rulesLoaded: boolean(),
18542
+ asks: array(NcClipRetentionAskSchema).readonly()
18543
+ });
18487
18544
  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 }), {
18488
18545
  kind: "mutation",
18489
18546
  auth: "admin",
@@ -18504,7 +18561,7 @@ method(object({}), object({ rules: array(NcRuleSchema) }), { auth: "admin" }), m
18504
18561
  }), object({ success: literal(true) }), {
18505
18562
  kind: "mutation",
18506
18563
  auth: "admin"
18507
- }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
18564
+ }), method(object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(object({}), object({ mutedDeviceIds: array(number().int()).readonly() }), { auth: "admin" }), method(object({
18508
18565
  deviceId: number().int(),
18509
18566
  muted: boolean()
18510
18567
  }), object({ success: literal(true) }), {
@@ -19689,13 +19746,26 @@ var TrackAudioLabelSchema = object({
19689
19746
  * - `audio` — an audio event on the camera itself that was anomalous for
19690
19747
  * THAT camera, loud, and heard while nothing visual was happening (D62).
19691
19748
  *
19749
+ * - `onboard` — the CAMERA's own firmware, paired with a decoded frame in
19750
+ * that frame's pixel space. A real root detector and a SPATIAL one: its
19751
+ * boxes are the same kind of fact `pipeline`'s are, produced by a different
19752
+ * detector.
19753
+ *
19754
+ * `onboard` was missing here while `DetectionSourceSchema` already had it, so
19755
+ * a persisted onboard track failed `safeParse` on read and came back with NO
19756
+ * source at all — which `isSpatialTrack` then admitted by accident, through the
19757
+ * `undefined` arm rather than by anybody's decision, and which `excludeSources`
19758
+ * could not name.
19759
+ *
19692
19760
  * The spatial subsystems (tracker association, occupancy count, re-id /
19693
19761
  * embedding, resurrection) MUST skip every synthetic source. Test for that
19694
- * with `isSpatialTrack`, which allow-lists `pipeline` — a `!== 'sensor'`
19695
- * check silently readmits every source added after it was written.
19762
+ * with `isSpatialTrack`, which allow-lists the spatial sources explicitly — a
19763
+ * `!== 'sensor'` check silently readmits every source added after it was
19764
+ * written.
19696
19765
  */
19697
19766
  var TrackSourceSchema = _enum([
19698
19767
  "pipeline",
19768
+ "onboard",
19699
19769
  "sensor",
19700
19770
  "audio"
19701
19771
  ]);
@@ -21078,6 +21148,33 @@ var RunReplayFrameProcessorResultSchema = object({ tracks: array(object({
21078
21148
  * solid is this track", cheaper than re-deriving it from a trajectory. */
21079
21149
  framesMatched: number().int()
21080
21150
  })).readonly() });
21151
+ /**
21152
+ * The long-term series a camera produces. A closed union so a typo cannot
21153
+ * invent one, and the ONE declaration of it — the addon's `AnalyticsLtsSeries`
21154
+ * is an alias of this, not a second list.
21155
+ */
21156
+ var AnalyticsLtsSeriesSchema = _enum([
21157
+ "motion",
21158
+ "audio-dbfs",
21159
+ "battery",
21160
+ "occupancy"
21161
+ ]);
21162
+ /**
21163
+ * One closed 5-minute bucket of a long-term series.
21164
+ *
21165
+ * `samples` is how many readings the bucket folded — it is the ACTIVITY for a
21166
+ * series like `motion`, and the confidence for one like `occupancy`. A bucket
21167
+ * that exists at all was measured; a bucket that is absent was not, which is a
21168
+ * different claim from zero and the reason this is a sparse series.
21169
+ */
21170
+ var LtsBucketSchema = object({
21171
+ scope: string(),
21172
+ bucketStart: number().int(),
21173
+ samples: number().int().nonnegative(),
21174
+ sum: number(),
21175
+ min: number(),
21176
+ max: number()
21177
+ });
21081
21178
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
21082
21179
  deviceId: number(),
21083
21180
  trackId: string()
@@ -21124,6 +21221,14 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
21124
21221
  kinds: array(string()).optional(),
21125
21222
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
21126
21223
  }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
21224
+ deviceId: number(),
21225
+ series: AnalyticsLtsSeriesSchema,
21226
+ /** Omit for EVERY scope of this series in the range. */
21227
+ scope: string().optional(),
21228
+ from: number(),
21229
+ to: number(),
21230
+ limit: number().int().positive().optional()
21231
+ }), array(LtsBucketSchema).readonly()), method(object({
21127
21232
  deviceId: number(),
21128
21233
  since: number(),
21129
21234
  until: number(),
@@ -21742,6 +21847,40 @@ var MotionSourceEnum = _enum([
21742
21847
  */
21743
21848
  var MotionSourcesSchema = array(MotionSourceEnum);
21744
21849
  /**
21850
+ * Which root detector a camera runs — EXACTLY ONE.
21851
+ *
21852
+ * Deliberately the SAME vocabulary post-analysis already tags every detection
21853
+ * with (`DetectionSource`) rather than a second spelling of the same two
21854
+ * ideas: the value an operator picks here is the value that comes back on the
21855
+ * track, the overlay and the debug row.
21856
+ *
21857
+ * ## Why one, and why it is still an array
21858
+ *
21859
+ * Two roots on one camera is a capability nobody asked for and the operator has
21860
+ * since ruled out. It was never free: both planes feed the SAME per-device
21861
+ * stationary registry, both can promote the same parked object, and the two
21862
+ * detectors disagree about the same box by construction — which is the
21863
+ * disagreement D505 had to arbitrate. Removing the case removes the arbitration.
21864
+ *
21865
+ * The ARRAY shape survives because the stored settings and the attach payload
21866
+ * already speak it on every camera of every fleet, and a cap input that
21867
+ * suddenly refuses a stored value makes the camera un-attachable — a fail-closed
21868
+ * in the one direction that costs an operator their cameras. So the wire stays
21869
+ * tolerant and the TYPE is exact: a longer list is truncated to its first
21870
+ * element rather than refused, and `max(1)` is what every consumer can then
21871
+ * rely on.
21872
+ *
21873
+ * AT MOST one, not exactly one. The EMPTY list is a legal, deliberate pick —
21874
+ * a camera an operator left with no root detector — and `planDetectionSources`
21875
+ * has always said so: inventing a root for them is how a default acts without
21876
+ * anybody choosing it. Tightening this to `length(1)` broke that, and the
21877
+ * suite caught it.
21878
+ *
21879
+ * Measured before tightening (2026-09-15, this fleet, 6 h of attaches): 3327
21880
+ * `["pipeline"]` and 2 `["onboard"]`. Not one camera had two.
21881
+ */
21882
+ var DetectionSourcesSchema = preprocess((value) => Array.isArray(value) && value.length > 1 ? value.slice(0, 1) : value, array(DetectionSourceSchema).max(1));
21883
+ /**
21745
21884
  * Input shape for `pipeline-runner.reportMotion` cap method. Exported
21746
21885
  * so cap-side consumers (the orchestrator forward, the runner addon's
21747
21886
  * cap implementation, tests) can reuse the type instead of redeclaring
@@ -21892,6 +22031,35 @@ var RunnerCameraConfigSchema = object({
21892
22031
  * events; the orchestrator forwards to `reportMotion`.
21893
22032
  */
21894
22033
  motionSources: MotionSourcesSchema.default(["analyzer"]),
22034
+ /**
22035
+ * WHICH root detector runs for this camera. The detection counterpart of
22036
+ * {@link motionSources}, same shape and same discipline: a per-camera list
22037
+ * of sources the system understands, vendor-agnostic, owned here.
22038
+ *
22039
+ * - `pipeline` — this runner's own root step on decoded pixels (`steps`).
22040
+ * - `onboard` — the CAMERA's own detector, admitted only when it is named
22041
+ * here. Its boxes reach post-analysis on the same
22042
+ * `PipelineInferenceResult` payload as the pipeline's, so an onboard-born
22043
+ * track gets the same tracker, the same overlay and the same detail
22044
+ * subtree (face / plate / embedding).
22045
+ *
22046
+ * `['onboard']` alone is the REPLACEMENT: this runner's root step does not
22047
+ * run, and that is where a camera with a usable onboard detector buys back
22048
+ * its share of the accelerator. It saves the root inference, not the decode
22049
+ * — the detail subtree still needs pixels to cut crops from.
22050
+ *
22051
+ * A camera whose onboard detections carry no geometry cannot serve as a root
22052
+ * step at all (there is nothing to track), and the cap that knows this says
22053
+ * so on `native-object-detection.getOptions().geometry`. On Reolink that is
22054
+ * every battery camera: the boxes ride a sub-stream a battery camera never
22055
+ * attaches, so such a camera stays on `['pipeline']` and its onboard AI is
22056
+ * worth exactly what it already is — a wake signal with a class.
22057
+ *
22058
+ * Defaults to `['pipeline']`, which is byte-for-byte today's behaviour: a
22059
+ * vendor never turns a detector on for the operator, and neither does a
22060
+ * default.
22061
+ */
22062
+ detectionSources: DetectionSourcesSchema.default(["pipeline"]),
21895
22063
  pipelineEnabled: boolean().default(true),
21896
22064
  /** Ordered tree of video steps. Absent → runner skips video detection. */
21897
22065
  steps: array(PipelineStepInputSchema).readonly().optional(),
@@ -22073,7 +22241,47 @@ var RunnerLocalMetricsSchema = object({
22073
22241
  queueDepth: number(),
22074
22242
  frameLazy: FrameLazyMetricsSchema.optional()
22075
22243
  });
22244
+ /**
22245
+ * Pipeline Runner capability — runtime detection workhorse.
22246
+ *
22247
+ * One instance per node. Receives camera assignments from
22248
+ * `addon-pipeline-orchestrator`, subscribes to the local stream-broker for
22249
+ * decoded frames, drains motion + detection queues, calls the local
22250
+ * `motion-detection` and `pipeline-executor` capabilities, and emits typed
22251
+ * `pipeline.inference-result` and `detection.motion-analysis` events on
22252
+ * the bus.
22253
+ *
22254
+ * Distinct from `pipeline-orchestrator` (the hub-side load balancer) — the
22255
+ * runner has zero knowledge of other agents, no global state, and never
22256
+ * makes assignment decisions itself.
22257
+ */
22258
+ /**
22259
+ * Why a runner declined to look at a camera out of band. Named rather than a
22260
+ * bare `false`: a camera asleep on battery (D173), one attached elsewhere, one
22261
+ * already mid-session and one already bursting are four different facts, and a
22262
+ * caller told only "no" cannot tell a protection from a bug.
22263
+ */
22264
+ var OccupancyBurstRefusalSchema = _enum([
22265
+ "not-attached",
22266
+ "battery-asleep",
22267
+ "not-watching",
22268
+ "already-bursting"
22269
+ ]);
22076
22270
  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({
22271
+ deviceId: number(),
22272
+ /** How many frames to collect. The caller sizes this against what its
22273
+ * own confirmation needs; the runner clamps it to the field's range. */
22274
+ frames: number().int().positive().optional(),
22275
+ /** Why, for the log. A burst nobody can attribute is a cost nobody can
22276
+ * defend — the periodic one at least has a timer to point at. */
22277
+ reason: string()
22278
+ }), object({
22279
+ started: boolean(),
22280
+ refusedBecause: OccupancyBurstRefusalSchema.optional()
22281
+ }), {
22282
+ auth: "admin",
22283
+ kind: "mutation"
22284
+ }), method(object({
22077
22285
  handle: FrameHandleSchema,
22078
22286
  bbox: NativeCropBboxSchema,
22079
22287
  maxWidth: number().int().positive().optional(),
@@ -29032,11 +29240,46 @@ var NativeObjectDetectionStatusSchema = object({
29032
29240
  supportedClasses: array(NativeObjectClassEnum).readonly(),
29033
29241
  /**
29034
29242
  * Whether forwarding of onboard AI detections is enabled for this device.
29035
- * Default FALSE (opt-in, cold-start) — onboard AI pushes are noisy/sparse and
29036
- * churn the tracker, so forwarding stays off until the operator enables it.
29243
+ *
29244
+ * Cold-start OFF on every camera. A vendor does not decide which detector a
29245
+ * camera runs — that is the operator's choice, and it is made where every
29246
+ * other detection choice is made. `geometry` on
29247
+ * {@link NativeObjectDetectionOptionsSchema} is how the form says what the
29248
+ * choice would buy this particular camera.
29037
29249
  */
29038
29250
  enabled: boolean()
29039
29251
  });
29252
+ /**
29253
+ * WHEN a camera's onboard detections carry geometry.
29254
+ *
29255
+ * - `boxed` — always. The provider holds a standing channel for the boxes, so
29256
+ * a detection is a trackable subject whenever the camera sees one.
29257
+ * - `while-streaming` — only while some stream of this camera is already open.
29258
+ * The boxes ride the video's own side-channel rather than a feed of their
29259
+ * own, so they cost nothing and they exist only when something is pulling.
29260
+ * On Reolink this is every BATTERY camera: a persistent second feed is real
29261
+ * radio drain, but a camera that is awake is awake precisely because
29262
+ * something is in front of it, and its stream is already being pulled.
29263
+ * - `flag-only` — never. The firmware ships the class and nothing else; the
29264
+ * pipeline needs geometry to make a subject, so such a push reaches the
29265
+ * tracker as motion and no further.
29266
+ *
29267
+ * Reported and not inferred, because the operator's question in front of the
29268
+ * picker is "what do I get", and these are three different answers (D14: the
29269
+ * derived form is only as honest as `getOptions`).
29270
+ */
29271
+ var NativeObjectGeometryEnum = _enum([
29272
+ "boxed",
29273
+ "while-streaming",
29274
+ "flag-only"
29275
+ ]);
29276
+ var NativeObjectDetectionOptionsSchema = object({
29277
+ /** Classes this firmware can detect — the same list the status reports. */
29278
+ supportedClasses: array(NativeObjectClassEnum).readonly(),
29279
+ /** What a detection from this camera carries. */
29280
+ geometry: NativeObjectGeometryEnum
29281
+ });
29282
+ var NativeObjectDetectionSettingsPatchSchema = object({ enabled: boolean().optional() });
29040
29283
  var NativeObjectDetectionRuntimeStateSchema = NativeObjectDetectionStatusSchema.extend({
29041
29284
  /** Required by createRuntimeStateBridge — epoch ms of last refresh. */
29042
29285
  lastFetchedAt: number() });
@@ -29046,13 +29289,23 @@ var nativeObjectDetectionCapability = {
29046
29289
  deviceNative: true,
29047
29290
  mode: "singleton",
29048
29291
  deviceTypes: [DeviceType.Camera],
29049
- methods: { setEnabled: method(object({
29050
- deviceId: number(),
29051
- enabled: boolean()
29052
- }), _void(), {
29053
- kind: "mutation",
29054
- auth: "admin"
29055
- }) },
29292
+ methods: {
29293
+ getOptions: method(object({ deviceId: number() }), NativeObjectDetectionOptionsSchema),
29294
+ setSettings: method(object({
29295
+ deviceId: number(),
29296
+ settings: NativeObjectDetectionSettingsPatchSchema
29297
+ }), _void(), {
29298
+ kind: "mutation",
29299
+ auth: "admin"
29300
+ }),
29301
+ setEnabled: method(object({
29302
+ deviceId: number(),
29303
+ enabled: boolean()
29304
+ }), _void(), {
29305
+ kind: "mutation",
29306
+ auth: "admin"
29307
+ })
29308
+ },
29056
29309
  events: { onDetected: { data: object({
29057
29310
  deviceId: number(),
29058
29311
  detection: NativeDetectionSchema
@@ -34231,7 +34484,28 @@ var PerScopeBreakdownSchema = object({
34231
34484
  /** Total tracked objects in this scope (frame / zone / unzoned). */
34232
34485
  totalObjects: number().int().nonnegative(),
34233
34486
  /** Per-class count. Keys are macro class names (e.g. `person`, `car`). */
34234
- byClass: record(string(), number().int().nonnegative())
34487
+ byClass: record(string(), number().int().nonnegative()),
34488
+ /**
34489
+ * Of `totalObjects`, how many are STANDING — objects the census holds,
34490
+ * present but not going anywhere (a parked car, a bin, a statue).
34491
+ *
34492
+ * The operator's question about a scene has two halves and they answer
34493
+ * different things: "what is parked here" is stable for hours and must not
34494
+ * flap, while "who is walking through" is the thing an alert is about. One
34495
+ * number could only serve one of them, and `totalObjects` served the first
34496
+ * badly — a passer-by moved it and every occupancy rule saw a change.
34497
+ *
34498
+ * `standing + transient === totalObjects`, always. The total keeps its old
34499
+ * meaning exactly, so no rule written against it changes behaviour.
34500
+ *
34501
+ * ABSENT means UNKNOWN, never zero (D393): a snapshot from a node older than
34502
+ * this field cannot say, and a reader that folds absence in as 0 reports "no
34503
+ * parked objects here" about a camera whose lot is full.
34504
+ */
34505
+ standingObjects: number().int().nonnegative().optional(),
34506
+ /** Of `totalObjects`, how many are passing through. See `standingObjects` —
34507
+ * same absence rule. */
34508
+ transientObjects: number().int().nonnegative().optional()
34235
34509
  });
34236
34510
  var ZoneScopeBreakdownSchema = PerScopeBreakdownSchema.extend({
34237
34511
  zoneId: string(),
@@ -34354,6 +34628,23 @@ var HistoryPointSchema = object({
34354
34628
  * triple covers the three spatial scopes (per-zone, frame-wide,
34355
34629
  * outside-any-zone). Crossing them with `className?` gives the full
34356
34630
  * combinatorial coverage the operator UI requested.
34631
+ *
34632
+ * ## ⚠️ The three history methods are DEPRECATED
34633
+ *
34634
+ * They are served from a 60-MINUTE in-memory ring. It dies with the process,
34635
+ * so after a restart they report nothing about a night that did happen, and any
34636
+ * window past an hour is silently clamped — a caller cannot tell a clamp from
34637
+ * an empty scene. The presets in the occupancy chart existed to hide that
34638
+ * horizon rather than to answer a question.
34639
+ *
34640
+ * Use `pipelineAnalytics.readLongTermSeries({ series: 'occupancy', scope })`
34641
+ * instead. Those rows are already written for every camera, ~60 bytes per
34642
+ * (camera, scope, 5-minute bucket), kept for a year, and survive a restart.
34643
+ * Spell the scope with `occupancyScope(zoneId?, className?)` — the same
34644
+ * function the writer uses, so the two cannot drift.
34645
+ *
34646
+ * The ring stays until these three go, and it is the only thing left reading
34647
+ * it. Do not add a fourth caller.
34357
34648
  */
34358
34649
  var zoneAnalyticsCapability = {
34359
34650
  name: "zone-analytics",
@@ -38986,12 +39277,24 @@ Object.freeze({
38986
39277
  addonId: null,
38987
39278
  access: "create"
38988
39279
  },
39280
+ "nativeObjectDetection.getOptions": {
39281
+ capName: "native-object-detection",
39282
+ capScope: "device",
39283
+ addonId: null,
39284
+ access: "view"
39285
+ },
38989
39286
  "nativeObjectDetection.setEnabled": {
38990
39287
  capName: "native-object-detection",
38991
39288
  capScope: "device",
38992
39289
  addonId: null,
38993
39290
  access: "create"
38994
39291
  },
39292
+ "nativeObjectDetection.setSettings": {
39293
+ capName: "native-object-detection",
39294
+ capScope: "device",
39295
+ addonId: null,
39296
+ access: "create"
39297
+ },
38995
39298
  "navigation.getFeatures": {
38996
39299
  capName: "navigation",
38997
39300
  capScope: "device",
@@ -39256,6 +39559,12 @@ Object.freeze({
39256
39559
  addonId: null,
39257
39560
  access: "view"
39258
39561
  },
39562
+ "notificationRules.getClipRetentionAsks": {
39563
+ capName: "notification-rules",
39564
+ capScope: "system",
39565
+ addonId: null,
39566
+ access: "view"
39567
+ },
39259
39568
  "notificationRules.getConditionCatalog": {
39260
39569
  capName: "notification-rules",
39261
39570
  capScope: "system",
@@ -39766,6 +40075,12 @@ Object.freeze({
39766
40075
  addonId: null,
39767
40076
  access: "create"
39768
40077
  },
40078
+ "pipelineAnalytics.readLongTermSeries": {
40079
+ capName: "pipeline-analytics",
40080
+ capScope: "device",
40081
+ addonId: null,
40082
+ access: "view"
40083
+ },
39769
40084
  "pipelineAnalytics.rebuildObjectEmbeddings": {
39770
40085
  capName: "pipeline-analytics",
39771
40086
  capScope: "device",
@@ -40438,6 +40753,12 @@ Object.freeze({
40438
40753
  addonId: null,
40439
40754
  access: "create"
40440
40755
  },
40756
+ "pipelineRunner.requestOccupancyBurst": {
40757
+ capName: "pipeline-runner",
40758
+ capScope: "system",
40759
+ addonId: null,
40760
+ access: "create"
40761
+ },
40441
40762
  "pipelineRunner.runDetailSubtree": {
40442
40763
  capName: "pipeline-runner",
40443
40764
  capScope: "system",
@@ -43218,11 +43539,21 @@ Object.freeze({
43218
43539
  form: "single",
43219
43540
  optional: false
43220
43541
  }],
43542
+ "nativeObjectDetection.getOptions": [{
43543
+ name: "deviceId",
43544
+ form: "single",
43545
+ optional: false
43546
+ }],
43221
43547
  "nativeObjectDetection.setEnabled": [{
43222
43548
  name: "deviceId",
43223
43549
  form: "single",
43224
43550
  optional: false
43225
43551
  }],
43552
+ "nativeObjectDetection.setSettings": [{
43553
+ name: "deviceId",
43554
+ form: "single",
43555
+ optional: false
43556
+ }],
43226
43557
  "navigation.getFeatures": [{
43227
43558
  name: "deviceId",
43228
43559
  form: "single",
@@ -43572,6 +43903,11 @@ Object.freeze({
43572
43903
  form: "single",
43573
43904
  optional: false
43574
43905
  }],
43906
+ "pipelineAnalytics.readLongTermSeries": [{
43907
+ name: "deviceId",
43908
+ form: "single",
43909
+ optional: false
43910
+ }],
43575
43911
  "pipelineAnalytics.rebuildObjectEmbeddings": [{
43576
43912
  name: "deviceId",
43577
43913
  form: "single",
@@ -43762,6 +44098,11 @@ Object.freeze({
43762
44098
  form: "single",
43763
44099
  optional: false
43764
44100
  }],
44101
+ "pipelineRunner.requestOccupancyBurst": [{
44102
+ name: "deviceId",
44103
+ form: "single",
44104
+ optional: false
44105
+ }],
43765
44106
  "pipelineRunner.runDetailSubtree": [{
43766
44107
  name: "deviceId",
43767
44108
  form: "single",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-hikvision",
3
- "version": "1.2.110",
3
+ "version": "1.2.112",
4
4
  "description": "Hikvision camera device provider addon for CamStack — ISAPI over HTTP(S) with digest auth (snapshot, alarm stream, RTSP discovery)",
5
5
  "keywords": [
6
6
  "camstack",
@@ -83,7 +83,7 @@
83
83
  "build": "vite build",
84
84
  "dev": "vite build --watch",
85
85
  "typecheck": "tsc --noEmit",
86
- "publish": "npm publish --access public"
86
+ "publish:npm": "npm publish --access public"
87
87
  },
88
88
  "dependencies": {
89
89
  "werift": "0.22.9"