@camstack/addon-provider-rtsp 1.2.22 → 1.2.24

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 +167 -59
  2. package/dist/addon.mjs +167 -59
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -7622,7 +7622,7 @@ var RecordingBandSchema = object({
7622
7622
  postBufferSec: number().min(0).optional()
7623
7623
  });
7624
7624
  ({
7625
- preBufferSec: 10,
7625
+ preBufferSec: 15,
7626
7626
  postBufferSec: 30
7627
7627
  }).postBufferSec * 1e3;
7628
7628
  /**
@@ -13825,128 +13825,103 @@ var COCO_TO_MACRO = {
13825
13825
  var AUDIO_MACRO_LABELS = [
13826
13826
  {
13827
13827
  id: "speech",
13828
- name: "Speech",
13829
- icon: "🗣️"
13828
+ name: "Speech"
13830
13829
  },
13831
13830
  {
13832
13831
  id: "scream",
13833
- name: "Scream / Shout",
13834
- icon: "😱"
13832
+ name: "Scream / Shout"
13835
13833
  },
13836
13834
  {
13837
13835
  id: "crying",
13838
- name: "Crying / Baby",
13839
- icon: "😢"
13836
+ name: "Crying / Baby"
13840
13837
  },
13841
13838
  {
13842
13839
  id: "laughter",
13843
- name: "Laughter",
13844
- icon: "😂"
13840
+ name: "Laughter"
13845
13841
  },
13846
13842
  {
13847
13843
  id: "music",
13848
- name: "Music",
13849
- icon: "🎵"
13844
+ name: "Music"
13850
13845
  },
13851
13846
  {
13852
13847
  id: "dog",
13853
- name: "Dog",
13854
- icon: "🐕"
13848
+ name: "Dog"
13855
13849
  },
13856
13850
  {
13857
13851
  id: "cat",
13858
- name: "Cat",
13859
- icon: "🐈"
13852
+ name: "Cat"
13860
13853
  },
13861
13854
  {
13862
13855
  id: "bird",
13863
- name: "Bird",
13864
- icon: "🐦"
13856
+ name: "Bird"
13865
13857
  },
13866
13858
  {
13867
13859
  id: "animal",
13868
- name: "Animal (other)",
13869
- icon: "🐾"
13860
+ name: "Animal (other)"
13870
13861
  },
13871
13862
  {
13872
13863
  id: "alarm",
13873
- name: "Alarm / Siren",
13874
- icon: "🚨"
13864
+ name: "Alarm / Siren"
13875
13865
  },
13876
13866
  {
13877
13867
  id: "doorbell",
13878
- name: "Doorbell / Knock",
13879
- icon: "🔔"
13868
+ name: "Doorbell / Knock"
13880
13869
  },
13881
13870
  {
13882
13871
  id: "glass_breaking",
13883
- name: "Glass Breaking",
13884
- icon: "💥"
13872
+ name: "Glass Breaking"
13885
13873
  },
13886
13874
  {
13887
13875
  id: "gunshot",
13888
- name: "Gunshot / Explosion",
13889
- icon: "💣"
13876
+ name: "Gunshot / Explosion"
13890
13877
  },
13891
13878
  {
13892
13879
  id: "vehicle",
13893
- name: "Vehicle",
13894
- icon: "🚗"
13880
+ name: "Vehicle"
13895
13881
  },
13896
13882
  {
13897
13883
  id: "siren",
13898
- name: "Emergency Siren",
13899
- icon: "🚑"
13884
+ name: "Emergency Siren"
13900
13885
  },
13901
13886
  {
13902
13887
  id: "fire",
13903
- name: "Fire / Smoke",
13904
- icon: "🔥"
13888
+ name: "Fire / Smoke"
13905
13889
  },
13906
13890
  {
13907
13891
  id: "water",
13908
- name: "Water",
13909
- icon: "💧"
13892
+ name: "Water"
13910
13893
  },
13911
13894
  {
13912
13895
  id: "wind",
13913
- name: "Wind / Weather",
13914
- icon: "🌬️"
13896
+ name: "Wind / Weather"
13915
13897
  },
13916
13898
  {
13917
13899
  id: "door",
13918
- name: "Door",
13919
- icon: "🚪"
13900
+ name: "Door"
13920
13901
  },
13921
13902
  {
13922
13903
  id: "footsteps",
13923
- name: "Footsteps",
13924
- icon: "👣"
13904
+ name: "Footsteps"
13925
13905
  },
13926
13906
  {
13927
13907
  id: "crowd",
13928
- name: "Crowd / Chatter",
13929
- icon: "👥"
13908
+ name: "Crowd / Chatter"
13930
13909
  },
13931
13910
  {
13932
13911
  id: "telephone",
13933
- name: "Telephone",
13934
- icon: "📞"
13912
+ name: "Telephone"
13935
13913
  },
13936
13914
  {
13937
13915
  id: "engine",
13938
- name: "Engine / Motor",
13939
- icon: "⚙️"
13916
+ name: "Engine / Motor"
13940
13917
  },
13941
13918
  {
13942
13919
  id: "tools",
13943
- name: "Tools / Construction",
13944
- icon: "🔨"
13920
+ name: "Tools / Construction"
13945
13921
  },
13946
13922
  {
13947
13923
  id: "silence",
13948
- name: "Silence",
13949
- icon: "🤫"
13924
+ name: "Silence"
13950
13925
  }
13951
13926
  ];
13952
13927
  var YAMNET_TO_MACRO = {
@@ -16448,7 +16423,7 @@ var TrackEnvelopeSchema = object({
16448
16423
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16449
16424
  * keeps every scalar the list surfaces actually render (ids, class(es),
16450
16425
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16451
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16426
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16452
16427
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16453
16428
  * `getTrack`. Mirrors the event-store `projection` convention
16454
16429
  * (`getObjectEvents` et al.).
@@ -16743,6 +16718,35 @@ var TrackSchema = object({
16743
16718
  */
16744
16719
  hasFace: boolean().optional(),
16745
16720
  /**
16721
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16722
+ * face an operator could ASSIGN to an identity.
16723
+ *
16724
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16725
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16726
+ * branch, before every gate, and means no more than "a face detector produced
16727
+ * a face detail". This one is stamped at the single moment the gallery row
16728
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16729
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16730
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16731
+ * the crop-store drop. Everything between the detector and that insert can
16732
+ * legitimately refuse the face, so a flag written any earlier promises the
16733
+ * operator something to assign and delivers nothing.
16734
+ *
16735
+ * **Independent of recognition.** A face collected but never auto-matched is
16736
+ * still assignable — it is in fact the face an operator most wants to reach —
16737
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16738
+ * `subLabel`; this says only that the raw material exists.
16739
+ *
16740
+ * **Set once, never cleared.** A track that produced a gallery row produced
16741
+ * one; deleting the row later is the gallery's business, not this flag's.
16742
+ *
16743
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16744
+ * before the column omits it, and so does every server that predates the
16745
+ * field. A consumer must test `=== true` and render nothing otherwise —
16746
+ * never infer "no assignable face".
16747
+ */
16748
+ hasEmbeddedFace: boolean().optional(),
16749
+ /**
16746
16750
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16747
16751
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16748
16752
  * so the passage is tracked once and as a VEHICLE.
@@ -18132,6 +18136,32 @@ var DetailResultSchema = object({
18132
18136
  /** FRAME-space bbox (already mapped back from crop space). */
18133
18137
  bbox: NativeCropBboxSchema.optional(),
18134
18138
  embedding: string().optional(),
18139
+ /**
18140
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18141
+ * so an older runner that does not send it degrades to "unmeasurable", which
18142
+ * the consuming gate treats as accept — never as reject.
18143
+ */
18144
+ embeddingMagnitude: number().optional(),
18145
+ /**
18146
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18147
+ * `label`, and for the same reason: the producing node is the only side that
18148
+ * knows which model actually ran, and re-deriving it downstream is exactly
18149
+ * the inference this model exists to forbid.
18150
+ *
18151
+ * Additive and optional, so a runner that predates it degrades to
18152
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18153
+ * its previous assumption instead of refusing.
18154
+ *
18155
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18156
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18157
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18158
+ * compared the gallery against itself and could never fire. That turned the
18159
+ * one guard protecting the face feature space into a tautology, and it is
18160
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18161
+ * gallery as the catalog comment predicts — it would have scored the new
18162
+ * model's vectors against the old model's samples in one cosine space.
18163
+ */
18164
+ embeddingModelId: string().optional(),
18135
18165
  label: string().optional(),
18136
18166
  /**
18137
18167
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19596,6 +19626,7 @@ var snapshotCapability = {
19596
19626
  isBattery: boolean(),
19597
19627
  reason: _enum([
19598
19628
  "disabled",
19629
+ "offline",
19599
19630
  "sleeping",
19600
19631
  "unreachable",
19601
19632
  "waking"
@@ -19685,9 +19716,17 @@ targets: array(object({
19685
19716
  sleeping: boolean(),
19686
19717
  /** Current device state rendered over the cached frame. State images
19687
19718
  * remain authoritative even when their photographic background is
19688
- * old; null means the link must carry a current camera frame. */
19719
+ * old; null means the link must carry a current camera frame.
19720
+ *
19721
+ * **This is the ONLY source a surface may derive an inactive tile
19722
+ * from.** A client that reads a device's `online`/`disabled` flags and
19723
+ * draws its own verdict will disagree with the pixels it is painting
19724
+ * — the frame comes from here, and so must the sentence over it
19725
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19726
+ * state. */
19689
19727
  stateReason: _enum([
19690
19728
  "disabled",
19729
+ "offline",
19691
19730
  "sleeping",
19692
19731
  "unreachable",
19693
19732
  "waking"
@@ -26420,9 +26459,21 @@ var RecordingLocationUsageSchema = object({
26420
26459
  * previously rendered as two identical "disks" with a nonsensical used
26421
26460
  * split — hydrate attribution across aliases is arbitrary by nature. */
26422
26461
  locationIds: array(string()).optional(),
26423
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
26462
+ /**
26463
+ * Filesystem root of the physical volume this row accounts — the only
26464
+ * operator-legible identity when a location has no `displayName` yet, and
26465
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
26466
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
26467
+ * it, and this schema must keep validating that older provider's payload.
26468
+ */
26469
+ root: string().optional(),
26470
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
26471
+ * the footage's SHARE of the volume, not how full the volume is — the disk
26472
+ * also holds everything that is not recordings. Volume fill is
26473
+ * `(totalBytes - availableBytes) / totalBytes`. */
26424
26474
  usedBytes: number(),
26425
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
26475
+ /** Free bytes on the location's volume; null when capacity is unknown
26476
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
26426
26477
  availableBytes: number().nullable(),
26427
26478
  /** Total bytes of the location's volume; null when unknown. */
26428
26479
  totalBytes: number().nullable()
@@ -26434,7 +26485,15 @@ var RecordingStorageUsageSchema = object({
26434
26485
  nodeId: string(),
26435
26486
  totalUsedBytes: number(),
26436
26487
  devices: array(RecordingDeviceUsageSchema),
26437
- locations: array(RecordingLocationUsageSchema)
26488
+ /**
26489
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
26490
+ * of the payload without it: the hub serves this method through a BAKED
26491
+ * router, so a hub whose framework train predates a change to this array
26492
+ * strips it out of an answer a newer recorder happily produced. A UI that
26493
+ * dereferences it unconditionally crashes the whole Storage page over a
26494
+ * missing disk bar.
26495
+ */
26496
+ locations: array(RecordingLocationUsageSchema).optional()
26438
26497
  });
26439
26498
  /**
26440
26499
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -37285,8 +37344,13 @@ Object.freeze({
37285
37344
  "network-access": "ingress",
37286
37345
  "smtp-provider": "email"
37287
37346
  });
37288
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
37347
+ /** Schema defaults an untouched sub-field must author exactly these. */
37348
+ var NC_AUDIO_DEFAULTS = {
37349
+ hitPercent: 60,
37350
+ samplingSeconds: 10
37351
+ };
37289
37352
  new Set(["devices", "classes"]);
37353
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
37290
37354
  /**
37291
37355
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
37292
37356
  *
@@ -37518,6 +37582,39 @@ TimelapseRuleInputSchema.extend({
37518
37582
  createdAt: number(),
37519
37583
  updatedAt: number()
37520
37584
  });
37585
+ Object.freeze(Object.fromEntries([{
37586
+ stepId: "face-embedding",
37587
+ label: "Face recognition model",
37588
+ defaultModelId: "arcface-r100",
37589
+ indexName: "the enrolled face gallery",
37590
+ options: [
37591
+ {
37592
+ id: "arcface-r100",
37593
+ label: "ArcFace (ResNet34)"
37594
+ },
37595
+ {
37596
+ id: "auraface-r100",
37597
+ label: "AuraFace R100"
37598
+ },
37599
+ {
37600
+ id: "inception-resnet-v1",
37601
+ label: "Inception ResNet V1"
37602
+ }
37603
+ ]
37604
+ }, {
37605
+ stepId: "clip-embedding",
37606
+ label: "Semantic search model",
37607
+ defaultModelId: "mobileclip-s1",
37608
+ indexName: "the object semantic-search index",
37609
+ options: [{
37610
+ id: "mobileclip-s1",
37611
+ label: "MobileCLIP S1"
37612
+ }, {
37613
+ id: "mobileclip-s2",
37614
+ label: "MobileCLIP S2"
37615
+ }]
37616
+ }].map((s) => [s.stepId, s.defaultModelId])));
37617
+ string().min(1);
37521
37618
  object({
37522
37619
  /**
37523
37620
  * Fraction of the box's own size added on EACH side before cutting.
@@ -37538,10 +37635,21 @@ object({
37538
37635
  */
37539
37636
  square: boolean()
37540
37637
  });
37541
- ({
37638
+ /**
37639
+ * The convention in force when nobody has configured one — byte-for-byte the
37640
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
37641
+ */
37642
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
37542
37643
  paddingRatio: .15,
37543
37644
  square: false
37544
- }).paddingRatio;
37645
+ };
37646
+ Object.freeze({
37647
+ x: 0,
37648
+ y: 0,
37649
+ w: 1,
37650
+ h: 1
37651
+ });
37652
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
37545
37653
  /**
37546
37654
  * WHICH delivered frames the decode worker retains a native copy of.
37547
37655
  *
package/dist/addon.mjs CHANGED
@@ -7598,7 +7598,7 @@ var RecordingBandSchema = object({
7598
7598
  postBufferSec: number().min(0).optional()
7599
7599
  });
7600
7600
  ({
7601
- preBufferSec: 10,
7601
+ preBufferSec: 15,
7602
7602
  postBufferSec: 30
7603
7603
  }).postBufferSec * 1e3;
7604
7604
  /**
@@ -13801,128 +13801,103 @@ var COCO_TO_MACRO = {
13801
13801
  var AUDIO_MACRO_LABELS = [
13802
13802
  {
13803
13803
  id: "speech",
13804
- name: "Speech",
13805
- icon: "🗣️"
13804
+ name: "Speech"
13806
13805
  },
13807
13806
  {
13808
13807
  id: "scream",
13809
- name: "Scream / Shout",
13810
- icon: "😱"
13808
+ name: "Scream / Shout"
13811
13809
  },
13812
13810
  {
13813
13811
  id: "crying",
13814
- name: "Crying / Baby",
13815
- icon: "😢"
13812
+ name: "Crying / Baby"
13816
13813
  },
13817
13814
  {
13818
13815
  id: "laughter",
13819
- name: "Laughter",
13820
- icon: "😂"
13816
+ name: "Laughter"
13821
13817
  },
13822
13818
  {
13823
13819
  id: "music",
13824
- name: "Music",
13825
- icon: "🎵"
13820
+ name: "Music"
13826
13821
  },
13827
13822
  {
13828
13823
  id: "dog",
13829
- name: "Dog",
13830
- icon: "🐕"
13824
+ name: "Dog"
13831
13825
  },
13832
13826
  {
13833
13827
  id: "cat",
13834
- name: "Cat",
13835
- icon: "🐈"
13828
+ name: "Cat"
13836
13829
  },
13837
13830
  {
13838
13831
  id: "bird",
13839
- name: "Bird",
13840
- icon: "🐦"
13832
+ name: "Bird"
13841
13833
  },
13842
13834
  {
13843
13835
  id: "animal",
13844
- name: "Animal (other)",
13845
- icon: "🐾"
13836
+ name: "Animal (other)"
13846
13837
  },
13847
13838
  {
13848
13839
  id: "alarm",
13849
- name: "Alarm / Siren",
13850
- icon: "🚨"
13840
+ name: "Alarm / Siren"
13851
13841
  },
13852
13842
  {
13853
13843
  id: "doorbell",
13854
- name: "Doorbell / Knock",
13855
- icon: "🔔"
13844
+ name: "Doorbell / Knock"
13856
13845
  },
13857
13846
  {
13858
13847
  id: "glass_breaking",
13859
- name: "Glass Breaking",
13860
- icon: "💥"
13848
+ name: "Glass Breaking"
13861
13849
  },
13862
13850
  {
13863
13851
  id: "gunshot",
13864
- name: "Gunshot / Explosion",
13865
- icon: "💣"
13852
+ name: "Gunshot / Explosion"
13866
13853
  },
13867
13854
  {
13868
13855
  id: "vehicle",
13869
- name: "Vehicle",
13870
- icon: "🚗"
13856
+ name: "Vehicle"
13871
13857
  },
13872
13858
  {
13873
13859
  id: "siren",
13874
- name: "Emergency Siren",
13875
- icon: "🚑"
13860
+ name: "Emergency Siren"
13876
13861
  },
13877
13862
  {
13878
13863
  id: "fire",
13879
- name: "Fire / Smoke",
13880
- icon: "🔥"
13864
+ name: "Fire / Smoke"
13881
13865
  },
13882
13866
  {
13883
13867
  id: "water",
13884
- name: "Water",
13885
- icon: "💧"
13868
+ name: "Water"
13886
13869
  },
13887
13870
  {
13888
13871
  id: "wind",
13889
- name: "Wind / Weather",
13890
- icon: "🌬️"
13872
+ name: "Wind / Weather"
13891
13873
  },
13892
13874
  {
13893
13875
  id: "door",
13894
- name: "Door",
13895
- icon: "🚪"
13876
+ name: "Door"
13896
13877
  },
13897
13878
  {
13898
13879
  id: "footsteps",
13899
- name: "Footsteps",
13900
- icon: "👣"
13880
+ name: "Footsteps"
13901
13881
  },
13902
13882
  {
13903
13883
  id: "crowd",
13904
- name: "Crowd / Chatter",
13905
- icon: "👥"
13884
+ name: "Crowd / Chatter"
13906
13885
  },
13907
13886
  {
13908
13887
  id: "telephone",
13909
- name: "Telephone",
13910
- icon: "📞"
13888
+ name: "Telephone"
13911
13889
  },
13912
13890
  {
13913
13891
  id: "engine",
13914
- name: "Engine / Motor",
13915
- icon: "⚙️"
13892
+ name: "Engine / Motor"
13916
13893
  },
13917
13894
  {
13918
13895
  id: "tools",
13919
- name: "Tools / Construction",
13920
- icon: "🔨"
13896
+ name: "Tools / Construction"
13921
13897
  },
13922
13898
  {
13923
13899
  id: "silence",
13924
- name: "Silence",
13925
- icon: "🤫"
13900
+ name: "Silence"
13926
13901
  }
13927
13902
  ];
13928
13903
  var YAMNET_TO_MACRO = {
@@ -16424,7 +16399,7 @@ var TrackEnvelopeSchema = object({
16424
16399
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16425
16400
  * keeps every scalar the list surfaces actually render (ids, class(es),
16426
16401
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16427
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16402
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16428
16403
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16429
16404
  * `getTrack`. Mirrors the event-store `projection` convention
16430
16405
  * (`getObjectEvents` et al.).
@@ -16719,6 +16694,35 @@ var TrackSchema = object({
16719
16694
  */
16720
16695
  hasFace: boolean().optional(),
16721
16696
  /**
16697
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16698
+ * face an operator could ASSIGN to an identity.
16699
+ *
16700
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16701
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16702
+ * branch, before every gate, and means no more than "a face detector produced
16703
+ * a face detail". This one is stamped at the single moment the gallery row
16704
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16705
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16706
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16707
+ * the crop-store drop. Everything between the detector and that insert can
16708
+ * legitimately refuse the face, so a flag written any earlier promises the
16709
+ * operator something to assign and delivers nothing.
16710
+ *
16711
+ * **Independent of recognition.** A face collected but never auto-matched is
16712
+ * still assignable — it is in fact the face an operator most wants to reach —
16713
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16714
+ * `subLabel`; this says only that the raw material exists.
16715
+ *
16716
+ * **Set once, never cleared.** A track that produced a gallery row produced
16717
+ * one; deleting the row later is the gallery's business, not this flag's.
16718
+ *
16719
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16720
+ * before the column omits it, and so does every server that predates the
16721
+ * field. A consumer must test `=== true` and render nothing otherwise —
16722
+ * never infer "no assignable face".
16723
+ */
16724
+ hasEmbeddedFace: boolean().optional(),
16725
+ /**
16722
16726
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16723
16727
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16724
16728
  * so the passage is tracked once and as a VEHICLE.
@@ -18108,6 +18112,32 @@ var DetailResultSchema = object({
18108
18112
  /** FRAME-space bbox (already mapped back from crop space). */
18109
18113
  bbox: NativeCropBboxSchema.optional(),
18110
18114
  embedding: string().optional(),
18115
+ /**
18116
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18117
+ * so an older runner that does not send it degrades to "unmeasurable", which
18118
+ * the consuming gate treats as accept — never as reject.
18119
+ */
18120
+ embeddingMagnitude: number().optional(),
18121
+ /**
18122
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18123
+ * `label`, and for the same reason: the producing node is the only side that
18124
+ * knows which model actually ran, and re-deriving it downstream is exactly
18125
+ * the inference this model exists to forbid.
18126
+ *
18127
+ * Additive and optional, so a runner that predates it degrades to
18128
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18129
+ * its previous assumption instead of refusing.
18130
+ *
18131
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18132
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18133
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18134
+ * compared the gallery against itself and could never fire. That turned the
18135
+ * one guard protecting the face feature space into a tautology, and it is
18136
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18137
+ * gallery as the catalog comment predicts — it would have scored the new
18138
+ * model's vectors against the old model's samples in one cosine space.
18139
+ */
18140
+ embeddingModelId: string().optional(),
18111
18141
  label: string().optional(),
18112
18142
  /**
18113
18143
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19572,6 +19602,7 @@ var snapshotCapability = {
19572
19602
  isBattery: boolean(),
19573
19603
  reason: _enum([
19574
19604
  "disabled",
19605
+ "offline",
19575
19606
  "sleeping",
19576
19607
  "unreachable",
19577
19608
  "waking"
@@ -19661,9 +19692,17 @@ targets: array(object({
19661
19692
  sleeping: boolean(),
19662
19693
  /** Current device state rendered over the cached frame. State images
19663
19694
  * remain authoritative even when their photographic background is
19664
- * old; null means the link must carry a current camera frame. */
19695
+ * old; null means the link must carry a current camera frame.
19696
+ *
19697
+ * **This is the ONLY source a surface may derive an inactive tile
19698
+ * from.** A client that reads a device's `online`/`disabled` flags and
19699
+ * draws its own verdict will disagree with the pixels it is painting
19700
+ * — the frame comes from here, and so must the sentence over it
19701
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19702
+ * state. */
19665
19703
  stateReason: _enum([
19666
19704
  "disabled",
19705
+ "offline",
19667
19706
  "sleeping",
19668
19707
  "unreachable",
19669
19708
  "waking"
@@ -26396,9 +26435,21 @@ var RecordingLocationUsageSchema = object({
26396
26435
  * previously rendered as two identical "disks" with a nonsensical used
26397
26436
  * split — hydrate attribution across aliases is arbitrary by nature. */
26398
26437
  locationIds: array(string()).optional(),
26399
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
26438
+ /**
26439
+ * Filesystem root of the physical volume this row accounts — the only
26440
+ * operator-legible identity when a location has no `displayName` yet, and
26441
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
26442
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
26443
+ * it, and this schema must keep validating that older provider's payload.
26444
+ */
26445
+ root: string().optional(),
26446
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
26447
+ * the footage's SHARE of the volume, not how full the volume is — the disk
26448
+ * also holds everything that is not recordings. Volume fill is
26449
+ * `(totalBytes - availableBytes) / totalBytes`. */
26400
26450
  usedBytes: number(),
26401
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
26451
+ /** Free bytes on the location's volume; null when capacity is unknown
26452
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
26402
26453
  availableBytes: number().nullable(),
26403
26454
  /** Total bytes of the location's volume; null when unknown. */
26404
26455
  totalBytes: number().nullable()
@@ -26410,7 +26461,15 @@ var RecordingStorageUsageSchema = object({
26410
26461
  nodeId: string(),
26411
26462
  totalUsedBytes: number(),
26412
26463
  devices: array(RecordingDeviceUsageSchema),
26413
- locations: array(RecordingLocationUsageSchema)
26464
+ /**
26465
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
26466
+ * of the payload without it: the hub serves this method through a BAKED
26467
+ * router, so a hub whose framework train predates a change to this array
26468
+ * strips it out of an answer a newer recorder happily produced. A UI that
26469
+ * dereferences it unconditionally crashes the whole Storage page over a
26470
+ * missing disk bar.
26471
+ */
26472
+ locations: array(RecordingLocationUsageSchema).optional()
26414
26473
  });
26415
26474
  /**
26416
26475
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -37261,8 +37320,13 @@ Object.freeze({
37261
37320
  "network-access": "ingress",
37262
37321
  "smtp-provider": "email"
37263
37322
  });
37264
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
37323
+ /** Schema defaults an untouched sub-field must author exactly these. */
37324
+ var NC_AUDIO_DEFAULTS = {
37325
+ hitPercent: 60,
37326
+ samplingSeconds: 10
37327
+ };
37265
37328
  new Set(["devices", "classes"]);
37329
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
37266
37330
  /**
37267
37331
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
37268
37332
  *
@@ -37494,6 +37558,39 @@ TimelapseRuleInputSchema.extend({
37494
37558
  createdAt: number(),
37495
37559
  updatedAt: number()
37496
37560
  });
37561
+ Object.freeze(Object.fromEntries([{
37562
+ stepId: "face-embedding",
37563
+ label: "Face recognition model",
37564
+ defaultModelId: "arcface-r100",
37565
+ indexName: "the enrolled face gallery",
37566
+ options: [
37567
+ {
37568
+ id: "arcface-r100",
37569
+ label: "ArcFace (ResNet34)"
37570
+ },
37571
+ {
37572
+ id: "auraface-r100",
37573
+ label: "AuraFace R100"
37574
+ },
37575
+ {
37576
+ id: "inception-resnet-v1",
37577
+ label: "Inception ResNet V1"
37578
+ }
37579
+ ]
37580
+ }, {
37581
+ stepId: "clip-embedding",
37582
+ label: "Semantic search model",
37583
+ defaultModelId: "mobileclip-s1",
37584
+ indexName: "the object semantic-search index",
37585
+ options: [{
37586
+ id: "mobileclip-s1",
37587
+ label: "MobileCLIP S1"
37588
+ }, {
37589
+ id: "mobileclip-s2",
37590
+ label: "MobileCLIP S2"
37591
+ }]
37592
+ }].map((s) => [s.stepId, s.defaultModelId])));
37593
+ string().min(1);
37497
37594
  object({
37498
37595
  /**
37499
37596
  * Fraction of the box's own size added on EACH side before cutting.
@@ -37514,10 +37611,21 @@ object({
37514
37611
  */
37515
37612
  square: boolean()
37516
37613
  });
37517
- ({
37614
+ /**
37615
+ * The convention in force when nobody has configured one — byte-for-byte the
37616
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
37617
+ */
37618
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
37518
37619
  paddingRatio: .15,
37519
37620
  square: false
37520
- }).paddingRatio;
37621
+ };
37622
+ Object.freeze({
37623
+ x: 0,
37624
+ y: 0,
37625
+ w: 1,
37626
+ h: 1
37627
+ });
37628
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
37521
37629
  /**
37522
37630
  * WHICH delivered frames the decode worker retains a native copy of.
37523
37631
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rtsp",
3
- "version": "1.2.22",
3
+ "version": "1.2.24",
4
4
  "description": "Generic RTSP camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",