@camstack/addon-decoder-nodeav 1.2.21 → 1.2.23

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/index.js +167 -59
  2. package/dist/index.mjs +167 -59
  3. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -7566,7 +7566,7 @@ var RecordingBandSchema = object({
7566
7566
  postBufferSec: number().min(0).optional()
7567
7567
  });
7568
7568
  ({
7569
- preBufferSec: 10,
7569
+ preBufferSec: 15,
7570
7570
  postBufferSec: 30
7571
7571
  }).postBufferSec * 1e3;
7572
7572
  /**
@@ -13635,128 +13635,103 @@ var COCO_TO_MACRO = {
13635
13635
  var AUDIO_MACRO_LABELS = [
13636
13636
  {
13637
13637
  id: "speech",
13638
- name: "Speech",
13639
- icon: "🗣️"
13638
+ name: "Speech"
13640
13639
  },
13641
13640
  {
13642
13641
  id: "scream",
13643
- name: "Scream / Shout",
13644
- icon: "😱"
13642
+ name: "Scream / Shout"
13645
13643
  },
13646
13644
  {
13647
13645
  id: "crying",
13648
- name: "Crying / Baby",
13649
- icon: "😢"
13646
+ name: "Crying / Baby"
13650
13647
  },
13651
13648
  {
13652
13649
  id: "laughter",
13653
- name: "Laughter",
13654
- icon: "😂"
13650
+ name: "Laughter"
13655
13651
  },
13656
13652
  {
13657
13653
  id: "music",
13658
- name: "Music",
13659
- icon: "🎵"
13654
+ name: "Music"
13660
13655
  },
13661
13656
  {
13662
13657
  id: "dog",
13663
- name: "Dog",
13664
- icon: "🐕"
13658
+ name: "Dog"
13665
13659
  },
13666
13660
  {
13667
13661
  id: "cat",
13668
- name: "Cat",
13669
- icon: "🐈"
13662
+ name: "Cat"
13670
13663
  },
13671
13664
  {
13672
13665
  id: "bird",
13673
- name: "Bird",
13674
- icon: "🐦"
13666
+ name: "Bird"
13675
13667
  },
13676
13668
  {
13677
13669
  id: "animal",
13678
- name: "Animal (other)",
13679
- icon: "🐾"
13670
+ name: "Animal (other)"
13680
13671
  },
13681
13672
  {
13682
13673
  id: "alarm",
13683
- name: "Alarm / Siren",
13684
- icon: "🚨"
13674
+ name: "Alarm / Siren"
13685
13675
  },
13686
13676
  {
13687
13677
  id: "doorbell",
13688
- name: "Doorbell / Knock",
13689
- icon: "🔔"
13678
+ name: "Doorbell / Knock"
13690
13679
  },
13691
13680
  {
13692
13681
  id: "glass_breaking",
13693
- name: "Glass Breaking",
13694
- icon: "💥"
13682
+ name: "Glass Breaking"
13695
13683
  },
13696
13684
  {
13697
13685
  id: "gunshot",
13698
- name: "Gunshot / Explosion",
13699
- icon: "💣"
13686
+ name: "Gunshot / Explosion"
13700
13687
  },
13701
13688
  {
13702
13689
  id: "vehicle",
13703
- name: "Vehicle",
13704
- icon: "🚗"
13690
+ name: "Vehicle"
13705
13691
  },
13706
13692
  {
13707
13693
  id: "siren",
13708
- name: "Emergency Siren",
13709
- icon: "🚑"
13694
+ name: "Emergency Siren"
13710
13695
  },
13711
13696
  {
13712
13697
  id: "fire",
13713
- name: "Fire / Smoke",
13714
- icon: "🔥"
13698
+ name: "Fire / Smoke"
13715
13699
  },
13716
13700
  {
13717
13701
  id: "water",
13718
- name: "Water",
13719
- icon: "💧"
13702
+ name: "Water"
13720
13703
  },
13721
13704
  {
13722
13705
  id: "wind",
13723
- name: "Wind / Weather",
13724
- icon: "🌬️"
13706
+ name: "Wind / Weather"
13725
13707
  },
13726
13708
  {
13727
13709
  id: "door",
13728
- name: "Door",
13729
- icon: "🚪"
13710
+ name: "Door"
13730
13711
  },
13731
13712
  {
13732
13713
  id: "footsteps",
13733
- name: "Footsteps",
13734
- icon: "👣"
13714
+ name: "Footsteps"
13735
13715
  },
13736
13716
  {
13737
13717
  id: "crowd",
13738
- name: "Crowd / Chatter",
13739
- icon: "👥"
13718
+ name: "Crowd / Chatter"
13740
13719
  },
13741
13720
  {
13742
13721
  id: "telephone",
13743
- name: "Telephone",
13744
- icon: "📞"
13722
+ name: "Telephone"
13745
13723
  },
13746
13724
  {
13747
13725
  id: "engine",
13748
- name: "Engine / Motor",
13749
- icon: "⚙️"
13726
+ name: "Engine / Motor"
13750
13727
  },
13751
13728
  {
13752
13729
  id: "tools",
13753
- name: "Tools / Construction",
13754
- icon: "🔨"
13730
+ name: "Tools / Construction"
13755
13731
  },
13756
13732
  {
13757
13733
  id: "silence",
13758
- name: "Silence",
13759
- icon: "🤫"
13734
+ name: "Silence"
13760
13735
  }
13761
13736
  ];
13762
13737
  var YAMNET_TO_MACRO = {
@@ -16220,7 +16195,7 @@ var TrackEnvelopeSchema = object({
16220
16195
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16221
16196
  * keeps every scalar the list surfaces actually render (ids, class(es),
16222
16197
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16223
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16198
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16224
16199
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16225
16200
  * `getTrack`. Mirrors the event-store `projection` convention
16226
16201
  * (`getObjectEvents` et al.).
@@ -16515,6 +16490,35 @@ var TrackSchema = object({
16515
16490
  */
16516
16491
  hasFace: boolean().optional(),
16517
16492
  /**
16493
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16494
+ * face an operator could ASSIGN to an identity.
16495
+ *
16496
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16497
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16498
+ * branch, before every gate, and means no more than "a face detector produced
16499
+ * a face detail". This one is stamped at the single moment the gallery row
16500
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16501
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16502
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16503
+ * the crop-store drop. Everything between the detector and that insert can
16504
+ * legitimately refuse the face, so a flag written any earlier promises the
16505
+ * operator something to assign and delivers nothing.
16506
+ *
16507
+ * **Independent of recognition.** A face collected but never auto-matched is
16508
+ * still assignable — it is in fact the face an operator most wants to reach —
16509
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16510
+ * `subLabel`; this says only that the raw material exists.
16511
+ *
16512
+ * **Set once, never cleared.** A track that produced a gallery row produced
16513
+ * one; deleting the row later is the gallery's business, not this flag's.
16514
+ *
16515
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16516
+ * before the column omits it, and so does every server that predates the
16517
+ * field. A consumer must test `=== true` and render nothing otherwise —
16518
+ * never infer "no assignable face".
16519
+ */
16520
+ hasEmbeddedFace: boolean().optional(),
16521
+ /**
16518
16522
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16519
16523
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16520
16524
  * so the passage is tracked once and as a VEHICLE.
@@ -17864,6 +17868,32 @@ var DetailResultSchema = object({
17864
17868
  /** FRAME-space bbox (already mapped back from crop space). */
17865
17869
  bbox: NativeCropBboxSchema.optional(),
17866
17870
  embedding: string().optional(),
17871
+ /**
17872
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
17873
+ * so an older runner that does not send it degrades to "unmeasurable", which
17874
+ * the consuming gate treats as accept — never as reject.
17875
+ */
17876
+ embeddingMagnitude: number().optional(),
17877
+ /**
17878
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
17879
+ * `label`, and for the same reason: the producing node is the only side that
17880
+ * knows which model actually ran, and re-deriving it downstream is exactly
17881
+ * the inference this model exists to forbid.
17882
+ *
17883
+ * Additive and optional, so a runner that predates it degrades to
17884
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
17885
+ * its previous assumption instead of refusing.
17886
+ *
17887
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
17888
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
17889
+ * with nothing on the wire it took the id from the GALLERY, so the gate
17890
+ * compared the gallery against itself and could never fire. That turned the
17891
+ * one guard protecting the face feature space into a tautology, and it is
17892
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
17893
+ * gallery as the catalog comment predicts — it would have scored the new
17894
+ * model's vectors against the old model's samples in one cosine space.
17895
+ */
17896
+ embeddingModelId: string().optional(),
17867
17897
  label: string().optional(),
17868
17898
  /**
17869
17899
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19274,6 +19304,7 @@ DeviceType.Camera, method(object({
19274
19304
  isBattery: boolean(),
19275
19305
  reason: _enum([
19276
19306
  "disabled",
19307
+ "offline",
19277
19308
  "sleeping",
19278
19309
  "unreachable",
19279
19310
  "waking"
@@ -19319,9 +19350,17 @@ targets: array(object({
19319
19350
  sleeping: boolean(),
19320
19351
  /** Current device state rendered over the cached frame. State images
19321
19352
  * remain authoritative even when their photographic background is
19322
- * old; null means the link must carry a current camera frame. */
19353
+ * old; null means the link must carry a current camera frame.
19354
+ *
19355
+ * **This is the ONLY source a surface may derive an inactive tile
19356
+ * from.** A client that reads a device's `online`/`disabled` flags and
19357
+ * draws its own verdict will disagree with the pixels it is painting
19358
+ * — the frame comes from here, and so must the sentence over it
19359
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19360
+ * state. */
19323
19361
  stateReason: _enum([
19324
19362
  "disabled",
19363
+ "offline",
19325
19364
  "sleeping",
19326
19365
  "unreachable",
19327
19366
  "waking"
@@ -24352,9 +24391,21 @@ var RecordingLocationUsageSchema = object({
24352
24391
  * previously rendered as two identical "disks" with a nonsensical used
24353
24392
  * split — hydrate attribution across aliases is arbitrary by nature. */
24354
24393
  locationIds: array(string()).optional(),
24355
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
24394
+ /**
24395
+ * Filesystem root of the physical volume this row accounts — the only
24396
+ * operator-legible identity when a location has no `displayName` yet, and
24397
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
24398
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
24399
+ * it, and this schema must keep validating that older provider's payload.
24400
+ */
24401
+ root: string().optional(),
24402
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
24403
+ * the footage's SHARE of the volume, not how full the volume is — the disk
24404
+ * also holds everything that is not recordings. Volume fill is
24405
+ * `(totalBytes - availableBytes) / totalBytes`. */
24356
24406
  usedBytes: number(),
24357
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
24407
+ /** Free bytes on the location's volume; null when capacity is unknown
24408
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
24358
24409
  availableBytes: number().nullable(),
24359
24410
  /** Total bytes of the location's volume; null when unknown. */
24360
24411
  totalBytes: number().nullable()
@@ -24366,7 +24417,15 @@ var RecordingStorageUsageSchema = object({
24366
24417
  nodeId: string(),
24367
24418
  totalUsedBytes: number(),
24368
24419
  devices: array(RecordingDeviceUsageSchema),
24369
- locations: array(RecordingLocationUsageSchema)
24420
+ /**
24421
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
24422
+ * of the payload without it: the hub serves this method through a BAKED
24423
+ * router, so a hub whose framework train predates a change to this array
24424
+ * strips it out of an answer a newer recorder happily produced. A UI that
24425
+ * dereferences it unconditionally crashes the whole Storage page over a
24426
+ * missing disk bar.
24427
+ */
24428
+ locations: array(RecordingLocationUsageSchema).optional()
24370
24429
  });
24371
24430
  /**
24372
24431
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -33482,8 +33541,13 @@ Object.freeze({
33482
33541
  "network-access": "ingress",
33483
33542
  "smtp-provider": "email"
33484
33543
  });
33485
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33544
+ /** Schema defaults an untouched sub-field must author exactly these. */
33545
+ var NC_AUDIO_DEFAULTS = {
33546
+ hitPercent: 60,
33547
+ samplingSeconds: 10
33548
+ };
33486
33549
  new Set(["devices", "classes"]);
33550
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
33487
33551
  /**
33488
33552
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
33489
33553
  *
@@ -33715,6 +33779,39 @@ TimelapseRuleInputSchema.extend({
33715
33779
  createdAt: number(),
33716
33780
  updatedAt: number()
33717
33781
  });
33782
+ Object.freeze(Object.fromEntries([{
33783
+ stepId: "face-embedding",
33784
+ label: "Face recognition model",
33785
+ defaultModelId: "arcface-r100",
33786
+ indexName: "the enrolled face gallery",
33787
+ options: [
33788
+ {
33789
+ id: "arcface-r100",
33790
+ label: "ArcFace (ResNet34)"
33791
+ },
33792
+ {
33793
+ id: "auraface-r100",
33794
+ label: "AuraFace R100"
33795
+ },
33796
+ {
33797
+ id: "inception-resnet-v1",
33798
+ label: "Inception ResNet V1"
33799
+ }
33800
+ ]
33801
+ }, {
33802
+ stepId: "clip-embedding",
33803
+ label: "Semantic search model",
33804
+ defaultModelId: "mobileclip-s1",
33805
+ indexName: "the object semantic-search index",
33806
+ options: [{
33807
+ id: "mobileclip-s1",
33808
+ label: "MobileCLIP S1"
33809
+ }, {
33810
+ id: "mobileclip-s2",
33811
+ label: "MobileCLIP S2"
33812
+ }]
33813
+ }].map((s) => [s.stepId, s.defaultModelId])));
33814
+ string().min(1);
33718
33815
  object({
33719
33816
  /**
33720
33817
  * Fraction of the box's own size added on EACH side before cutting.
@@ -33735,10 +33832,21 @@ object({
33735
33832
  */
33736
33833
  square: boolean()
33737
33834
  });
33738
- ({
33835
+ /**
33836
+ * The convention in force when nobody has configured one — byte-for-byte the
33837
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
33838
+ */
33839
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
33739
33840
  paddingRatio: .15,
33740
33841
  square: false
33741
- }).paddingRatio;
33842
+ };
33843
+ Object.freeze({
33844
+ x: 0,
33845
+ y: 0,
33846
+ w: 1,
33847
+ h: 1
33848
+ });
33849
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
33742
33850
  /**
33743
33851
  * WHICH delivered frames the decode worker retains a native copy of.
33744
33852
  *
package/dist/index.mjs CHANGED
@@ -7562,7 +7562,7 @@ var RecordingBandSchema = object({
7562
7562
  postBufferSec: number().min(0).optional()
7563
7563
  });
7564
7564
  ({
7565
- preBufferSec: 10,
7565
+ preBufferSec: 15,
7566
7566
  postBufferSec: 30
7567
7567
  }).postBufferSec * 1e3;
7568
7568
  /**
@@ -13631,128 +13631,103 @@ var COCO_TO_MACRO = {
13631
13631
  var AUDIO_MACRO_LABELS = [
13632
13632
  {
13633
13633
  id: "speech",
13634
- name: "Speech",
13635
- icon: "🗣️"
13634
+ name: "Speech"
13636
13635
  },
13637
13636
  {
13638
13637
  id: "scream",
13639
- name: "Scream / Shout",
13640
- icon: "😱"
13638
+ name: "Scream / Shout"
13641
13639
  },
13642
13640
  {
13643
13641
  id: "crying",
13644
- name: "Crying / Baby",
13645
- icon: "😢"
13642
+ name: "Crying / Baby"
13646
13643
  },
13647
13644
  {
13648
13645
  id: "laughter",
13649
- name: "Laughter",
13650
- icon: "😂"
13646
+ name: "Laughter"
13651
13647
  },
13652
13648
  {
13653
13649
  id: "music",
13654
- name: "Music",
13655
- icon: "🎵"
13650
+ name: "Music"
13656
13651
  },
13657
13652
  {
13658
13653
  id: "dog",
13659
- name: "Dog",
13660
- icon: "🐕"
13654
+ name: "Dog"
13661
13655
  },
13662
13656
  {
13663
13657
  id: "cat",
13664
- name: "Cat",
13665
- icon: "🐈"
13658
+ name: "Cat"
13666
13659
  },
13667
13660
  {
13668
13661
  id: "bird",
13669
- name: "Bird",
13670
- icon: "🐦"
13662
+ name: "Bird"
13671
13663
  },
13672
13664
  {
13673
13665
  id: "animal",
13674
- name: "Animal (other)",
13675
- icon: "🐾"
13666
+ name: "Animal (other)"
13676
13667
  },
13677
13668
  {
13678
13669
  id: "alarm",
13679
- name: "Alarm / Siren",
13680
- icon: "🚨"
13670
+ name: "Alarm / Siren"
13681
13671
  },
13682
13672
  {
13683
13673
  id: "doorbell",
13684
- name: "Doorbell / Knock",
13685
- icon: "🔔"
13674
+ name: "Doorbell / Knock"
13686
13675
  },
13687
13676
  {
13688
13677
  id: "glass_breaking",
13689
- name: "Glass Breaking",
13690
- icon: "💥"
13678
+ name: "Glass Breaking"
13691
13679
  },
13692
13680
  {
13693
13681
  id: "gunshot",
13694
- name: "Gunshot / Explosion",
13695
- icon: "💣"
13682
+ name: "Gunshot / Explosion"
13696
13683
  },
13697
13684
  {
13698
13685
  id: "vehicle",
13699
- name: "Vehicle",
13700
- icon: "🚗"
13686
+ name: "Vehicle"
13701
13687
  },
13702
13688
  {
13703
13689
  id: "siren",
13704
- name: "Emergency Siren",
13705
- icon: "🚑"
13690
+ name: "Emergency Siren"
13706
13691
  },
13707
13692
  {
13708
13693
  id: "fire",
13709
- name: "Fire / Smoke",
13710
- icon: "🔥"
13694
+ name: "Fire / Smoke"
13711
13695
  },
13712
13696
  {
13713
13697
  id: "water",
13714
- name: "Water",
13715
- icon: "💧"
13698
+ name: "Water"
13716
13699
  },
13717
13700
  {
13718
13701
  id: "wind",
13719
- name: "Wind / Weather",
13720
- icon: "🌬️"
13702
+ name: "Wind / Weather"
13721
13703
  },
13722
13704
  {
13723
13705
  id: "door",
13724
- name: "Door",
13725
- icon: "🚪"
13706
+ name: "Door"
13726
13707
  },
13727
13708
  {
13728
13709
  id: "footsteps",
13729
- name: "Footsteps",
13730
- icon: "👣"
13710
+ name: "Footsteps"
13731
13711
  },
13732
13712
  {
13733
13713
  id: "crowd",
13734
- name: "Crowd / Chatter",
13735
- icon: "👥"
13714
+ name: "Crowd / Chatter"
13736
13715
  },
13737
13716
  {
13738
13717
  id: "telephone",
13739
- name: "Telephone",
13740
- icon: "📞"
13718
+ name: "Telephone"
13741
13719
  },
13742
13720
  {
13743
13721
  id: "engine",
13744
- name: "Engine / Motor",
13745
- icon: "⚙️"
13722
+ name: "Engine / Motor"
13746
13723
  },
13747
13724
  {
13748
13725
  id: "tools",
13749
- name: "Tools / Construction",
13750
- icon: "🔨"
13726
+ name: "Tools / Construction"
13751
13727
  },
13752
13728
  {
13753
13729
  id: "silence",
13754
- name: "Silence",
13755
- icon: "🤫"
13730
+ name: "Silence"
13756
13731
  }
13757
13732
  ];
13758
13733
  var YAMNET_TO_MACRO = {
@@ -16216,7 +16191,7 @@ var TrackEnvelopeSchema = object({
16216
16191
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16217
16192
  * keeps every scalar the list surfaces actually render (ids, class(es),
16218
16193
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16219
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16194
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16220
16195
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16221
16196
  * `getTrack`. Mirrors the event-store `projection` convention
16222
16197
  * (`getObjectEvents` et al.).
@@ -16511,6 +16486,35 @@ var TrackSchema = object({
16511
16486
  */
16512
16487
  hasFace: boolean().optional(),
16513
16488
  /**
16489
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16490
+ * face an operator could ASSIGN to an identity.
16491
+ *
16492
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16493
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16494
+ * branch, before every gate, and means no more than "a face detector produced
16495
+ * a face detail". This one is stamped at the single moment the gallery row
16496
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16497
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16498
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16499
+ * the crop-store drop. Everything between the detector and that insert can
16500
+ * legitimately refuse the face, so a flag written any earlier promises the
16501
+ * operator something to assign and delivers nothing.
16502
+ *
16503
+ * **Independent of recognition.** A face collected but never auto-matched is
16504
+ * still assignable — it is in fact the face an operator most wants to reach —
16505
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16506
+ * `subLabel`; this says only that the raw material exists.
16507
+ *
16508
+ * **Set once, never cleared.** A track that produced a gallery row produced
16509
+ * one; deleting the row later is the gallery's business, not this flag's.
16510
+ *
16511
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16512
+ * before the column omits it, and so does every server that predates the
16513
+ * field. A consumer must test `=== true` and render nothing otherwise —
16514
+ * never infer "no assignable face".
16515
+ */
16516
+ hasEmbeddedFace: boolean().optional(),
16517
+ /**
16514
16518
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16515
16519
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16516
16520
  * so the passage is tracked once and as a VEHICLE.
@@ -17860,6 +17864,32 @@ var DetailResultSchema = object({
17860
17864
  /** FRAME-space bbox (already mapped back from crop space). */
17861
17865
  bbox: NativeCropBboxSchema.optional(),
17862
17866
  embedding: string().optional(),
17867
+ /**
17868
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
17869
+ * so an older runner that does not send it degrades to "unmeasurable", which
17870
+ * the consuming gate treats as accept — never as reject.
17871
+ */
17872
+ embeddingMagnitude: number().optional(),
17873
+ /**
17874
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
17875
+ * `label`, and for the same reason: the producing node is the only side that
17876
+ * knows which model actually ran, and re-deriving it downstream is exactly
17877
+ * the inference this model exists to forbid.
17878
+ *
17879
+ * Additive and optional, so a runner that predates it degrades to
17880
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
17881
+ * its previous assumption instead of refusing.
17882
+ *
17883
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
17884
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
17885
+ * with nothing on the wire it took the id from the GALLERY, so the gate
17886
+ * compared the gallery against itself and could never fire. That turned the
17887
+ * one guard protecting the face feature space into a tautology, and it is
17888
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
17889
+ * gallery as the catalog comment predicts — it would have scored the new
17890
+ * model's vectors against the old model's samples in one cosine space.
17891
+ */
17892
+ embeddingModelId: string().optional(),
17863
17893
  label: string().optional(),
17864
17894
  /**
17865
17895
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19270,6 +19300,7 @@ DeviceType.Camera, method(object({
19270
19300
  isBattery: boolean(),
19271
19301
  reason: _enum([
19272
19302
  "disabled",
19303
+ "offline",
19273
19304
  "sleeping",
19274
19305
  "unreachable",
19275
19306
  "waking"
@@ -19315,9 +19346,17 @@ targets: array(object({
19315
19346
  sleeping: boolean(),
19316
19347
  /** Current device state rendered over the cached frame. State images
19317
19348
  * remain authoritative even when their photographic background is
19318
- * old; null means the link must carry a current camera frame. */
19349
+ * old; null means the link must carry a current camera frame.
19350
+ *
19351
+ * **This is the ONLY source a surface may derive an inactive tile
19352
+ * from.** A client that reads a device's `online`/`disabled` flags and
19353
+ * draws its own verdict will disagree with the pixels it is painting
19354
+ * — the frame comes from here, and so must the sentence over it
19355
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19356
+ * state. */
19319
19357
  stateReason: _enum([
19320
19358
  "disabled",
19359
+ "offline",
19321
19360
  "sleeping",
19322
19361
  "unreachable",
19323
19362
  "waking"
@@ -24348,9 +24387,21 @@ var RecordingLocationUsageSchema = object({
24348
24387
  * previously rendered as two identical "disks" with a nonsensical used
24349
24388
  * split — hydrate attribution across aliases is arbitrary by nature. */
24350
24389
  locationIds: array(string()).optional(),
24351
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
24390
+ /**
24391
+ * Filesystem root of the physical volume this row accounts — the only
24392
+ * operator-legible identity when a location has no `displayName` yet, and
24393
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
24394
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
24395
+ * it, and this schema must keep validating that older provider's payload.
24396
+ */
24397
+ root: string().optional(),
24398
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
24399
+ * the footage's SHARE of the volume, not how full the volume is — the disk
24400
+ * also holds everything that is not recordings. Volume fill is
24401
+ * `(totalBytes - availableBytes) / totalBytes`. */
24352
24402
  usedBytes: number(),
24353
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
24403
+ /** Free bytes on the location's volume; null when capacity is unknown
24404
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
24354
24405
  availableBytes: number().nullable(),
24355
24406
  /** Total bytes of the location's volume; null when unknown. */
24356
24407
  totalBytes: number().nullable()
@@ -24362,7 +24413,15 @@ var RecordingStorageUsageSchema = object({
24362
24413
  nodeId: string(),
24363
24414
  totalUsedBytes: number(),
24364
24415
  devices: array(RecordingDeviceUsageSchema),
24365
- locations: array(RecordingLocationUsageSchema)
24416
+ /**
24417
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
24418
+ * of the payload without it: the hub serves this method through a BAKED
24419
+ * router, so a hub whose framework train predates a change to this array
24420
+ * strips it out of an answer a newer recorder happily produced. A UI that
24421
+ * dereferences it unconditionally crashes the whole Storage page over a
24422
+ * missing disk bar.
24423
+ */
24424
+ locations: array(RecordingLocationUsageSchema).optional()
24366
24425
  });
24367
24426
  /**
24368
24427
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -33478,8 +33537,13 @@ Object.freeze({
33478
33537
  "network-access": "ingress",
33479
33538
  "smtp-provider": "email"
33480
33539
  });
33481
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33540
+ /** Schema defaults an untouched sub-field must author exactly these. */
33541
+ var NC_AUDIO_DEFAULTS = {
33542
+ hitPercent: 60,
33543
+ samplingSeconds: 10
33544
+ };
33482
33545
  new Set(["devices", "classes"]);
33546
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
33483
33547
  /**
33484
33548
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
33485
33549
  *
@@ -33711,6 +33775,39 @@ TimelapseRuleInputSchema.extend({
33711
33775
  createdAt: number(),
33712
33776
  updatedAt: number()
33713
33777
  });
33778
+ Object.freeze(Object.fromEntries([{
33779
+ stepId: "face-embedding",
33780
+ label: "Face recognition model",
33781
+ defaultModelId: "arcface-r100",
33782
+ indexName: "the enrolled face gallery",
33783
+ options: [
33784
+ {
33785
+ id: "arcface-r100",
33786
+ label: "ArcFace (ResNet34)"
33787
+ },
33788
+ {
33789
+ id: "auraface-r100",
33790
+ label: "AuraFace R100"
33791
+ },
33792
+ {
33793
+ id: "inception-resnet-v1",
33794
+ label: "Inception ResNet V1"
33795
+ }
33796
+ ]
33797
+ }, {
33798
+ stepId: "clip-embedding",
33799
+ label: "Semantic search model",
33800
+ defaultModelId: "mobileclip-s1",
33801
+ indexName: "the object semantic-search index",
33802
+ options: [{
33803
+ id: "mobileclip-s1",
33804
+ label: "MobileCLIP S1"
33805
+ }, {
33806
+ id: "mobileclip-s2",
33807
+ label: "MobileCLIP S2"
33808
+ }]
33809
+ }].map((s) => [s.stepId, s.defaultModelId])));
33810
+ string().min(1);
33714
33811
  object({
33715
33812
  /**
33716
33813
  * Fraction of the box's own size added on EACH side before cutting.
@@ -33731,10 +33828,21 @@ object({
33731
33828
  */
33732
33829
  square: boolean()
33733
33830
  });
33734
- ({
33831
+ /**
33832
+ * The convention in force when nobody has configured one — byte-for-byte the
33833
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
33834
+ */
33835
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
33735
33836
  paddingRatio: .15,
33736
33837
  square: false
33737
- }).paddingRatio;
33838
+ };
33839
+ Object.freeze({
33840
+ x: 0,
33841
+ y: 0,
33842
+ w: 1,
33843
+ h: 1
33844
+ });
33845
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
33738
33846
  /**
33739
33847
  * WHICH delivered frames the decode worker retains a native copy of.
33740
33848
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-decoder-nodeav",
3
- "version": "1.2.21",
3
+ "version": "1.2.23",
4
4
  "description": "Standalone in-process node-av decoder addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",