@camstack/addon-matter-broker 0.2.21 → 0.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/addon.js +167 -59
  2. package/dist/addon.mjs +167 -59
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -7580,7 +7580,7 @@ var RecordingBandSchema = object({
7580
7580
  postBufferSec: number().min(0).optional()
7581
7581
  });
7582
7582
  ({
7583
- preBufferSec: 10,
7583
+ preBufferSec: 15,
7584
7584
  postBufferSec: 30
7585
7585
  }).postBufferSec * 1e3;
7586
7586
  /**
@@ -13849,128 +13849,103 @@ var COCO_TO_MACRO = {
13849
13849
  var AUDIO_MACRO_LABELS = [
13850
13850
  {
13851
13851
  id: "speech",
13852
- name: "Speech",
13853
- icon: "🗣️"
13852
+ name: "Speech"
13854
13853
  },
13855
13854
  {
13856
13855
  id: "scream",
13857
- name: "Scream / Shout",
13858
- icon: "😱"
13856
+ name: "Scream / Shout"
13859
13857
  },
13860
13858
  {
13861
13859
  id: "crying",
13862
- name: "Crying / Baby",
13863
- icon: "😢"
13860
+ name: "Crying / Baby"
13864
13861
  },
13865
13862
  {
13866
13863
  id: "laughter",
13867
- name: "Laughter",
13868
- icon: "😂"
13864
+ name: "Laughter"
13869
13865
  },
13870
13866
  {
13871
13867
  id: "music",
13872
- name: "Music",
13873
- icon: "🎵"
13868
+ name: "Music"
13874
13869
  },
13875
13870
  {
13876
13871
  id: "dog",
13877
- name: "Dog",
13878
- icon: "🐕"
13872
+ name: "Dog"
13879
13873
  },
13880
13874
  {
13881
13875
  id: "cat",
13882
- name: "Cat",
13883
- icon: "🐈"
13876
+ name: "Cat"
13884
13877
  },
13885
13878
  {
13886
13879
  id: "bird",
13887
- name: "Bird",
13888
- icon: "🐦"
13880
+ name: "Bird"
13889
13881
  },
13890
13882
  {
13891
13883
  id: "animal",
13892
- name: "Animal (other)",
13893
- icon: "🐾"
13884
+ name: "Animal (other)"
13894
13885
  },
13895
13886
  {
13896
13887
  id: "alarm",
13897
- name: "Alarm / Siren",
13898
- icon: "🚨"
13888
+ name: "Alarm / Siren"
13899
13889
  },
13900
13890
  {
13901
13891
  id: "doorbell",
13902
- name: "Doorbell / Knock",
13903
- icon: "🔔"
13892
+ name: "Doorbell / Knock"
13904
13893
  },
13905
13894
  {
13906
13895
  id: "glass_breaking",
13907
- name: "Glass Breaking",
13908
- icon: "💥"
13896
+ name: "Glass Breaking"
13909
13897
  },
13910
13898
  {
13911
13899
  id: "gunshot",
13912
- name: "Gunshot / Explosion",
13913
- icon: "💣"
13900
+ name: "Gunshot / Explosion"
13914
13901
  },
13915
13902
  {
13916
13903
  id: "vehicle",
13917
- name: "Vehicle",
13918
- icon: "🚗"
13904
+ name: "Vehicle"
13919
13905
  },
13920
13906
  {
13921
13907
  id: "siren",
13922
- name: "Emergency Siren",
13923
- icon: "🚑"
13908
+ name: "Emergency Siren"
13924
13909
  },
13925
13910
  {
13926
13911
  id: "fire",
13927
- name: "Fire / Smoke",
13928
- icon: "🔥"
13912
+ name: "Fire / Smoke"
13929
13913
  },
13930
13914
  {
13931
13915
  id: "water",
13932
- name: "Water",
13933
- icon: "💧"
13916
+ name: "Water"
13934
13917
  },
13935
13918
  {
13936
13919
  id: "wind",
13937
- name: "Wind / Weather",
13938
- icon: "🌬️"
13920
+ name: "Wind / Weather"
13939
13921
  },
13940
13922
  {
13941
13923
  id: "door",
13942
- name: "Door",
13943
- icon: "🚪"
13924
+ name: "Door"
13944
13925
  },
13945
13926
  {
13946
13927
  id: "footsteps",
13947
- name: "Footsteps",
13948
- icon: "👣"
13928
+ name: "Footsteps"
13949
13929
  },
13950
13930
  {
13951
13931
  id: "crowd",
13952
- name: "Crowd / Chatter",
13953
- icon: "👥"
13932
+ name: "Crowd / Chatter"
13954
13933
  },
13955
13934
  {
13956
13935
  id: "telephone",
13957
- name: "Telephone",
13958
- icon: "📞"
13936
+ name: "Telephone"
13959
13937
  },
13960
13938
  {
13961
13939
  id: "engine",
13962
- name: "Engine / Motor",
13963
- icon: "⚙️"
13940
+ name: "Engine / Motor"
13964
13941
  },
13965
13942
  {
13966
13943
  id: "tools",
13967
- name: "Tools / Construction",
13968
- icon: "🔨"
13944
+ name: "Tools / Construction"
13969
13945
  },
13970
13946
  {
13971
13947
  id: "silence",
13972
- name: "Silence",
13973
- icon: "🤫"
13948
+ name: "Silence"
13974
13949
  }
13975
13950
  ];
13976
13951
  var YAMNET_TO_MACRO = {
@@ -16472,7 +16447,7 @@ var TrackEnvelopeSchema = object({
16472
16447
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16473
16448
  * keeps every scalar the list surfaces actually render (ids, class(es),
16474
16449
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16475
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16450
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16476
16451
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16477
16452
  * `getTrack`. Mirrors the event-store `projection` convention
16478
16453
  * (`getObjectEvents` et al.).
@@ -16767,6 +16742,35 @@ var TrackSchema = object({
16767
16742
  */
16768
16743
  hasFace: boolean().optional(),
16769
16744
  /**
16745
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16746
+ * face an operator could ASSIGN to an identity.
16747
+ *
16748
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16749
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16750
+ * branch, before every gate, and means no more than "a face detector produced
16751
+ * a face detail". This one is stamped at the single moment the gallery row
16752
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16753
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16754
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16755
+ * the crop-store drop. Everything between the detector and that insert can
16756
+ * legitimately refuse the face, so a flag written any earlier promises the
16757
+ * operator something to assign and delivers nothing.
16758
+ *
16759
+ * **Independent of recognition.** A face collected but never auto-matched is
16760
+ * still assignable — it is in fact the face an operator most wants to reach —
16761
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16762
+ * `subLabel`; this says only that the raw material exists.
16763
+ *
16764
+ * **Set once, never cleared.** A track that produced a gallery row produced
16765
+ * one; deleting the row later is the gallery's business, not this flag's.
16766
+ *
16767
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16768
+ * before the column omits it, and so does every server that predates the
16769
+ * field. A consumer must test `=== true` and render nothing otherwise —
16770
+ * never infer "no assignable face".
16771
+ */
16772
+ hasEmbeddedFace: boolean().optional(),
16773
+ /**
16770
16774
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16771
16775
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16772
16776
  * so the passage is tracked once and as a VEHICLE.
@@ -18156,6 +18160,32 @@ var DetailResultSchema = object({
18156
18160
  /** FRAME-space bbox (already mapped back from crop space). */
18157
18161
  bbox: NativeCropBboxSchema.optional(),
18158
18162
  embedding: string$2().optional(),
18163
+ /**
18164
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18165
+ * so an older runner that does not send it degrades to "unmeasurable", which
18166
+ * the consuming gate treats as accept — never as reject.
18167
+ */
18168
+ embeddingMagnitude: number().optional(),
18169
+ /**
18170
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18171
+ * `label`, and for the same reason: the producing node is the only side that
18172
+ * knows which model actually ran, and re-deriving it downstream is exactly
18173
+ * the inference this model exists to forbid.
18174
+ *
18175
+ * Additive and optional, so a runner that predates it degrades to
18176
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18177
+ * its previous assumption instead of refusing.
18178
+ *
18179
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18180
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18181
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18182
+ * compared the gallery against itself and could never fire. That turned the
18183
+ * one guard protecting the face feature space into a tautology, and it is
18184
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18185
+ * gallery as the catalog comment predicts — it would have scored the new
18186
+ * model's vectors against the old model's samples in one cosine space.
18187
+ */
18188
+ embeddingModelId: string$2().optional(),
18159
18189
  label: string$2().optional(),
18160
18190
  /**
18161
18191
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19566,6 +19596,7 @@ DeviceType.Camera, method(object({
19566
19596
  isBattery: boolean(),
19567
19597
  reason: _enum([
19568
19598
  "disabled",
19599
+ "offline",
19569
19600
  "sleeping",
19570
19601
  "unreachable",
19571
19602
  "waking"
@@ -19611,9 +19642,17 @@ targets: array(object({
19611
19642
  sleeping: boolean(),
19612
19643
  /** Current device state rendered over the cached frame. State images
19613
19644
  * remain authoritative even when their photographic background is
19614
- * old; null means the link must carry a current camera frame. */
19645
+ * old; null means the link must carry a current camera frame.
19646
+ *
19647
+ * **This is the ONLY source a surface may derive an inactive tile
19648
+ * from.** A client that reads a device's `online`/`disabled` flags and
19649
+ * draws its own verdict will disagree with the pixels it is painting
19650
+ * — the frame comes from here, and so must the sentence over it
19651
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19652
+ * state. */
19615
19653
  stateReason: _enum([
19616
19654
  "disabled",
19655
+ "offline",
19617
19656
  "sleeping",
19618
19657
  "unreachable",
19619
19658
  "waking"
@@ -26349,9 +26388,21 @@ var RecordingLocationUsageSchema = object({
26349
26388
  * previously rendered as two identical "disks" with a nonsensical used
26350
26389
  * split — hydrate attribution across aliases is arbitrary by nature. */
26351
26390
  locationIds: array(string$2()).optional(),
26352
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
26391
+ /**
26392
+ * Filesystem root of the physical volume this row accounts — the only
26393
+ * operator-legible identity when a location has no `displayName` yet, and
26394
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
26395
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
26396
+ * it, and this schema must keep validating that older provider's payload.
26397
+ */
26398
+ root: string$2().optional(),
26399
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
26400
+ * the footage's SHARE of the volume, not how full the volume is — the disk
26401
+ * also holds everything that is not recordings. Volume fill is
26402
+ * `(totalBytes - availableBytes) / totalBytes`. */
26353
26403
  usedBytes: number(),
26354
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
26404
+ /** Free bytes on the location's volume; null when capacity is unknown
26405
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
26355
26406
  availableBytes: number().nullable(),
26356
26407
  /** Total bytes of the location's volume; null when unknown. */
26357
26408
  totalBytes: number().nullable()
@@ -26363,7 +26414,15 @@ var RecordingStorageUsageSchema = object({
26363
26414
  nodeId: string$2(),
26364
26415
  totalUsedBytes: number(),
26365
26416
  devices: array(RecordingDeviceUsageSchema),
26366
- locations: array(RecordingLocationUsageSchema)
26417
+ /**
26418
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
26419
+ * of the payload without it: the hub serves this method through a BAKED
26420
+ * router, so a hub whose framework train predates a change to this array
26421
+ * strips it out of an answer a newer recorder happily produced. A UI that
26422
+ * dereferences it unconditionally crashes the whole Storage page over a
26423
+ * missing disk bar.
26424
+ */
26425
+ locations: array(RecordingLocationUsageSchema).optional()
26367
26426
  });
26368
26427
  /**
26369
26428
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -37148,8 +37207,13 @@ Object.freeze({
37148
37207
  "network-access": "ingress",
37149
37208
  "smtp-provider": "email"
37150
37209
  });
37151
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
37210
+ /** Schema defaults — an untouched sub-field must author exactly these. */
37211
+ var NC_AUDIO_DEFAULTS = {
37212
+ hitPercent: 60,
37213
+ samplingSeconds: 10
37214
+ };
37152
37215
  new Set(["devices", "classes"]);
37216
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
37153
37217
  /**
37154
37218
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
37155
37219
  *
@@ -37381,6 +37445,39 @@ TimelapseRuleInputSchema.extend({
37381
37445
  createdAt: number(),
37382
37446
  updatedAt: number()
37383
37447
  });
37448
+ Object.freeze(Object.fromEntries([{
37449
+ stepId: "face-embedding",
37450
+ label: "Face recognition model",
37451
+ defaultModelId: "arcface-r100",
37452
+ indexName: "the enrolled face gallery",
37453
+ options: [
37454
+ {
37455
+ id: "arcface-r100",
37456
+ label: "ArcFace (ResNet34)"
37457
+ },
37458
+ {
37459
+ id: "auraface-r100",
37460
+ label: "AuraFace R100"
37461
+ },
37462
+ {
37463
+ id: "inception-resnet-v1",
37464
+ label: "Inception ResNet V1"
37465
+ }
37466
+ ]
37467
+ }, {
37468
+ stepId: "clip-embedding",
37469
+ label: "Semantic search model",
37470
+ defaultModelId: "mobileclip-s1",
37471
+ indexName: "the object semantic-search index",
37472
+ options: [{
37473
+ id: "mobileclip-s1",
37474
+ label: "MobileCLIP S1"
37475
+ }, {
37476
+ id: "mobileclip-s2",
37477
+ label: "MobileCLIP S2"
37478
+ }]
37479
+ }].map((s) => [s.stepId, s.defaultModelId])));
37480
+ string$2().min(1);
37384
37481
  object({
37385
37482
  /**
37386
37483
  * Fraction of the box's own size added on EACH side before cutting.
@@ -37401,10 +37498,21 @@ object({
37401
37498
  */
37402
37499
  square: boolean()
37403
37500
  });
37404
- ({
37501
+ /**
37502
+ * The convention in force when nobody has configured one — byte-for-byte the
37503
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
37504
+ */
37505
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
37405
37506
  paddingRatio: .15,
37406
37507
  square: false
37407
- }).paddingRatio;
37508
+ };
37509
+ Object.freeze({
37510
+ x: 0,
37511
+ y: 0,
37512
+ w: 1,
37513
+ h: 1
37514
+ });
37515
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
37408
37516
  /**
37409
37517
  * WHICH delivered frames the decode worker retains a native copy of.
37410
37518
  *
package/dist/addon.mjs CHANGED
@@ -7578,7 +7578,7 @@ var RecordingBandSchema = object({
7578
7578
  postBufferSec: number().min(0).optional()
7579
7579
  });
7580
7580
  ({
7581
- preBufferSec: 10,
7581
+ preBufferSec: 15,
7582
7582
  postBufferSec: 30
7583
7583
  }).postBufferSec * 1e3;
7584
7584
  /**
@@ -13847,128 +13847,103 @@ var COCO_TO_MACRO = {
13847
13847
  var AUDIO_MACRO_LABELS = [
13848
13848
  {
13849
13849
  id: "speech",
13850
- name: "Speech",
13851
- icon: "🗣️"
13850
+ name: "Speech"
13852
13851
  },
13853
13852
  {
13854
13853
  id: "scream",
13855
- name: "Scream / Shout",
13856
- icon: "😱"
13854
+ name: "Scream / Shout"
13857
13855
  },
13858
13856
  {
13859
13857
  id: "crying",
13860
- name: "Crying / Baby",
13861
- icon: "😢"
13858
+ name: "Crying / Baby"
13862
13859
  },
13863
13860
  {
13864
13861
  id: "laughter",
13865
- name: "Laughter",
13866
- icon: "😂"
13862
+ name: "Laughter"
13867
13863
  },
13868
13864
  {
13869
13865
  id: "music",
13870
- name: "Music",
13871
- icon: "🎵"
13866
+ name: "Music"
13872
13867
  },
13873
13868
  {
13874
13869
  id: "dog",
13875
- name: "Dog",
13876
- icon: "🐕"
13870
+ name: "Dog"
13877
13871
  },
13878
13872
  {
13879
13873
  id: "cat",
13880
- name: "Cat",
13881
- icon: "🐈"
13874
+ name: "Cat"
13882
13875
  },
13883
13876
  {
13884
13877
  id: "bird",
13885
- name: "Bird",
13886
- icon: "🐦"
13878
+ name: "Bird"
13887
13879
  },
13888
13880
  {
13889
13881
  id: "animal",
13890
- name: "Animal (other)",
13891
- icon: "🐾"
13882
+ name: "Animal (other)"
13892
13883
  },
13893
13884
  {
13894
13885
  id: "alarm",
13895
- name: "Alarm / Siren",
13896
- icon: "🚨"
13886
+ name: "Alarm / Siren"
13897
13887
  },
13898
13888
  {
13899
13889
  id: "doorbell",
13900
- name: "Doorbell / Knock",
13901
- icon: "🔔"
13890
+ name: "Doorbell / Knock"
13902
13891
  },
13903
13892
  {
13904
13893
  id: "glass_breaking",
13905
- name: "Glass Breaking",
13906
- icon: "💥"
13894
+ name: "Glass Breaking"
13907
13895
  },
13908
13896
  {
13909
13897
  id: "gunshot",
13910
- name: "Gunshot / Explosion",
13911
- icon: "💣"
13898
+ name: "Gunshot / Explosion"
13912
13899
  },
13913
13900
  {
13914
13901
  id: "vehicle",
13915
- name: "Vehicle",
13916
- icon: "🚗"
13902
+ name: "Vehicle"
13917
13903
  },
13918
13904
  {
13919
13905
  id: "siren",
13920
- name: "Emergency Siren",
13921
- icon: "🚑"
13906
+ name: "Emergency Siren"
13922
13907
  },
13923
13908
  {
13924
13909
  id: "fire",
13925
- name: "Fire / Smoke",
13926
- icon: "🔥"
13910
+ name: "Fire / Smoke"
13927
13911
  },
13928
13912
  {
13929
13913
  id: "water",
13930
- name: "Water",
13931
- icon: "💧"
13914
+ name: "Water"
13932
13915
  },
13933
13916
  {
13934
13917
  id: "wind",
13935
- name: "Wind / Weather",
13936
- icon: "🌬️"
13918
+ name: "Wind / Weather"
13937
13919
  },
13938
13920
  {
13939
13921
  id: "door",
13940
- name: "Door",
13941
- icon: "🚪"
13922
+ name: "Door"
13942
13923
  },
13943
13924
  {
13944
13925
  id: "footsteps",
13945
- name: "Footsteps",
13946
- icon: "👣"
13926
+ name: "Footsteps"
13947
13927
  },
13948
13928
  {
13949
13929
  id: "crowd",
13950
- name: "Crowd / Chatter",
13951
- icon: "👥"
13930
+ name: "Crowd / Chatter"
13952
13931
  },
13953
13932
  {
13954
13933
  id: "telephone",
13955
- name: "Telephone",
13956
- icon: "📞"
13934
+ name: "Telephone"
13957
13935
  },
13958
13936
  {
13959
13937
  id: "engine",
13960
- name: "Engine / Motor",
13961
- icon: "⚙️"
13938
+ name: "Engine / Motor"
13962
13939
  },
13963
13940
  {
13964
13941
  id: "tools",
13965
- name: "Tools / Construction",
13966
- icon: "🔨"
13942
+ name: "Tools / Construction"
13967
13943
  },
13968
13944
  {
13969
13945
  id: "silence",
13970
- name: "Silence",
13971
- icon: "🤫"
13946
+ name: "Silence"
13972
13947
  }
13973
13948
  ];
13974
13949
  var YAMNET_TO_MACRO = {
@@ -16470,7 +16445,7 @@ var TrackEnvelopeSchema = object({
16470
16445
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16471
16446
  * keeps every scalar the list surfaces actually render (ids, class(es),
16472
16447
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16473
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16448
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16474
16449
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16475
16450
  * `getTrack`. Mirrors the event-store `projection` convention
16476
16451
  * (`getObjectEvents` et al.).
@@ -16765,6 +16740,35 @@ var TrackSchema = object({
16765
16740
  */
16766
16741
  hasFace: boolean().optional(),
16767
16742
  /**
16743
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16744
+ * face an operator could ASSIGN to an identity.
16745
+ *
16746
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16747
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16748
+ * branch, before every gate, and means no more than "a face detector produced
16749
+ * a face detail". This one is stamped at the single moment the gallery row
16750
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16751
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16752
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16753
+ * the crop-store drop. Everything between the detector and that insert can
16754
+ * legitimately refuse the face, so a flag written any earlier promises the
16755
+ * operator something to assign and delivers nothing.
16756
+ *
16757
+ * **Independent of recognition.** A face collected but never auto-matched is
16758
+ * still assignable — it is in fact the face an operator most wants to reach —
16759
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16760
+ * `subLabel`; this says only that the raw material exists.
16761
+ *
16762
+ * **Set once, never cleared.** A track that produced a gallery row produced
16763
+ * one; deleting the row later is the gallery's business, not this flag's.
16764
+ *
16765
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16766
+ * before the column omits it, and so does every server that predates the
16767
+ * field. A consumer must test `=== true` and render nothing otherwise —
16768
+ * never infer "no assignable face".
16769
+ */
16770
+ hasEmbeddedFace: boolean().optional(),
16771
+ /**
16768
16772
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16769
16773
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16770
16774
  * so the passage is tracked once and as a VEHICLE.
@@ -18154,6 +18158,32 @@ var DetailResultSchema = object({
18154
18158
  /** FRAME-space bbox (already mapped back from crop space). */
18155
18159
  bbox: NativeCropBboxSchema.optional(),
18156
18160
  embedding: string$2().optional(),
18161
+ /**
18162
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18163
+ * so an older runner that does not send it degrades to "unmeasurable", which
18164
+ * the consuming gate treats as accept — never as reject.
18165
+ */
18166
+ embeddingMagnitude: number().optional(),
18167
+ /**
18168
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18169
+ * `label`, and for the same reason: the producing node is the only side that
18170
+ * knows which model actually ran, and re-deriving it downstream is exactly
18171
+ * the inference this model exists to forbid.
18172
+ *
18173
+ * Additive and optional, so a runner that predates it degrades to
18174
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18175
+ * its previous assumption instead of refusing.
18176
+ *
18177
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18178
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18179
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18180
+ * compared the gallery against itself and could never fire. That turned the
18181
+ * one guard protecting the face feature space into a tautology, and it is
18182
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18183
+ * gallery as the catalog comment predicts — it would have scored the new
18184
+ * model's vectors against the old model's samples in one cosine space.
18185
+ */
18186
+ embeddingModelId: string$2().optional(),
18157
18187
  label: string$2().optional(),
18158
18188
  /**
18159
18189
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19564,6 +19594,7 @@ DeviceType.Camera, method(object({
19564
19594
  isBattery: boolean(),
19565
19595
  reason: _enum([
19566
19596
  "disabled",
19597
+ "offline",
19567
19598
  "sleeping",
19568
19599
  "unreachable",
19569
19600
  "waking"
@@ -19609,9 +19640,17 @@ targets: array(object({
19609
19640
  sleeping: boolean(),
19610
19641
  /** Current device state rendered over the cached frame. State images
19611
19642
  * remain authoritative even when their photographic background is
19612
- * old; null means the link must carry a current camera frame. */
19643
+ * old; null means the link must carry a current camera frame.
19644
+ *
19645
+ * **This is the ONLY source a surface may derive an inactive tile
19646
+ * from.** A client that reads a device's `online`/`disabled` flags and
19647
+ * draws its own verdict will disagree with the pixels it is painting
19648
+ * — the frame comes from here, and so must the sentence over it
19649
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19650
+ * state. */
19613
19651
  stateReason: _enum([
19614
19652
  "disabled",
19653
+ "offline",
19615
19654
  "sleeping",
19616
19655
  "unreachable",
19617
19656
  "waking"
@@ -26347,9 +26386,21 @@ var RecordingLocationUsageSchema = object({
26347
26386
  * previously rendered as two identical "disks" with a nonsensical used
26348
26387
  * split — hydrate attribution across aliases is arbitrary by nature. */
26349
26388
  locationIds: array(string$2()).optional(),
26350
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
26389
+ /**
26390
+ * Filesystem root of the physical volume this row accounts — the only
26391
+ * operator-legible identity when a location has no `displayName` yet, and
26392
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
26393
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
26394
+ * it, and this schema must keep validating that older provider's payload.
26395
+ */
26396
+ root: string$2().optional(),
26397
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
26398
+ * the footage's SHARE of the volume, not how full the volume is — the disk
26399
+ * also holds everything that is not recordings. Volume fill is
26400
+ * `(totalBytes - availableBytes) / totalBytes`. */
26351
26401
  usedBytes: number(),
26352
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
26402
+ /** Free bytes on the location's volume; null when capacity is unknown
26403
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
26353
26404
  availableBytes: number().nullable(),
26354
26405
  /** Total bytes of the location's volume; null when unknown. */
26355
26406
  totalBytes: number().nullable()
@@ -26361,7 +26412,15 @@ var RecordingStorageUsageSchema = object({
26361
26412
  nodeId: string$2(),
26362
26413
  totalUsedBytes: number(),
26363
26414
  devices: array(RecordingDeviceUsageSchema),
26364
- locations: array(RecordingLocationUsageSchema)
26415
+ /**
26416
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
26417
+ * of the payload without it: the hub serves this method through a BAKED
26418
+ * router, so a hub whose framework train predates a change to this array
26419
+ * strips it out of an answer a newer recorder happily produced. A UI that
26420
+ * dereferences it unconditionally crashes the whole Storage page over a
26421
+ * missing disk bar.
26422
+ */
26423
+ locations: array(RecordingLocationUsageSchema).optional()
26365
26424
  });
26366
26425
  /**
26367
26426
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -37146,8 +37205,13 @@ Object.freeze({
37146
37205
  "network-access": "ingress",
37147
37206
  "smtp-provider": "email"
37148
37207
  });
37149
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
37208
+ /** Schema defaults — an untouched sub-field must author exactly these. */
37209
+ var NC_AUDIO_DEFAULTS = {
37210
+ hitPercent: 60,
37211
+ samplingSeconds: 10
37212
+ };
37150
37213
  new Set(["devices", "classes"]);
37214
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
37151
37215
  /**
37152
37216
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
37153
37217
  *
@@ -37379,6 +37443,39 @@ TimelapseRuleInputSchema.extend({
37379
37443
  createdAt: number(),
37380
37444
  updatedAt: number()
37381
37445
  });
37446
+ Object.freeze(Object.fromEntries([{
37447
+ stepId: "face-embedding",
37448
+ label: "Face recognition model",
37449
+ defaultModelId: "arcface-r100",
37450
+ indexName: "the enrolled face gallery",
37451
+ options: [
37452
+ {
37453
+ id: "arcface-r100",
37454
+ label: "ArcFace (ResNet34)"
37455
+ },
37456
+ {
37457
+ id: "auraface-r100",
37458
+ label: "AuraFace R100"
37459
+ },
37460
+ {
37461
+ id: "inception-resnet-v1",
37462
+ label: "Inception ResNet V1"
37463
+ }
37464
+ ]
37465
+ }, {
37466
+ stepId: "clip-embedding",
37467
+ label: "Semantic search model",
37468
+ defaultModelId: "mobileclip-s1",
37469
+ indexName: "the object semantic-search index",
37470
+ options: [{
37471
+ id: "mobileclip-s1",
37472
+ label: "MobileCLIP S1"
37473
+ }, {
37474
+ id: "mobileclip-s2",
37475
+ label: "MobileCLIP S2"
37476
+ }]
37477
+ }].map((s) => [s.stepId, s.defaultModelId])));
37478
+ string$2().min(1);
37382
37479
  object({
37383
37480
  /**
37384
37481
  * Fraction of the box's own size added on EACH side before cutting.
@@ -37399,10 +37496,21 @@ object({
37399
37496
  */
37400
37497
  square: boolean()
37401
37498
  });
37402
- ({
37499
+ /**
37500
+ * The convention in force when nobody has configured one — byte-for-byte the
37501
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
37502
+ */
37503
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
37403
37504
  paddingRatio: .15,
37404
37505
  square: false
37405
- }).paddingRatio;
37506
+ };
37507
+ Object.freeze({
37508
+ x: 0,
37509
+ y: 0,
37510
+ w: 1,
37511
+ h: 1
37512
+ });
37513
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
37406
37514
  /**
37407
37515
  * WHICH delivered frames the decode worker retains a native copy of.
37408
37516
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-matter-broker",
3
- "version": "0.2.21",
3
+ "version": "0.2.23",
4
4
  "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
5
5
  "keywords": [
6
6
  "camstack",