@camstack/addon-export-alexa 1.2.28 → 1.2.30

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.
@@ -7734,7 +7734,7 @@ var RecordingBandSchema = object({
7734
7734
  postBufferSec: number().min(0).optional()
7735
7735
  });
7736
7736
  ({
7737
- preBufferSec: 10,
7737
+ preBufferSec: 15,
7738
7738
  postBufferSec: 30
7739
7739
  }).postBufferSec * 1e3;
7740
7740
  /**
@@ -13800,128 +13800,103 @@ var COCO_TO_MACRO = {
13800
13800
  var AUDIO_MACRO_LABELS = [
13801
13801
  {
13802
13802
  id: "speech",
13803
- name: "Speech",
13804
- icon: "🗣️"
13803
+ name: "Speech"
13805
13804
  },
13806
13805
  {
13807
13806
  id: "scream",
13808
- name: "Scream / Shout",
13809
- icon: "😱"
13807
+ name: "Scream / Shout"
13810
13808
  },
13811
13809
  {
13812
13810
  id: "crying",
13813
- name: "Crying / Baby",
13814
- icon: "😢"
13811
+ name: "Crying / Baby"
13815
13812
  },
13816
13813
  {
13817
13814
  id: "laughter",
13818
- name: "Laughter",
13819
- icon: "😂"
13815
+ name: "Laughter"
13820
13816
  },
13821
13817
  {
13822
13818
  id: "music",
13823
- name: "Music",
13824
- icon: "🎵"
13819
+ name: "Music"
13825
13820
  },
13826
13821
  {
13827
13822
  id: "dog",
13828
- name: "Dog",
13829
- icon: "🐕"
13823
+ name: "Dog"
13830
13824
  },
13831
13825
  {
13832
13826
  id: "cat",
13833
- name: "Cat",
13834
- icon: "🐈"
13827
+ name: "Cat"
13835
13828
  },
13836
13829
  {
13837
13830
  id: "bird",
13838
- name: "Bird",
13839
- icon: "🐦"
13831
+ name: "Bird"
13840
13832
  },
13841
13833
  {
13842
13834
  id: "animal",
13843
- name: "Animal (other)",
13844
- icon: "🐾"
13835
+ name: "Animal (other)"
13845
13836
  },
13846
13837
  {
13847
13838
  id: "alarm",
13848
- name: "Alarm / Siren",
13849
- icon: "🚨"
13839
+ name: "Alarm / Siren"
13850
13840
  },
13851
13841
  {
13852
13842
  id: "doorbell",
13853
- name: "Doorbell / Knock",
13854
- icon: "🔔"
13843
+ name: "Doorbell / Knock"
13855
13844
  },
13856
13845
  {
13857
13846
  id: "glass_breaking",
13858
- name: "Glass Breaking",
13859
- icon: "💥"
13847
+ name: "Glass Breaking"
13860
13848
  },
13861
13849
  {
13862
13850
  id: "gunshot",
13863
- name: "Gunshot / Explosion",
13864
- icon: "💣"
13851
+ name: "Gunshot / Explosion"
13865
13852
  },
13866
13853
  {
13867
13854
  id: "vehicle",
13868
- name: "Vehicle",
13869
- icon: "🚗"
13855
+ name: "Vehicle"
13870
13856
  },
13871
13857
  {
13872
13858
  id: "siren",
13873
- name: "Emergency Siren",
13874
- icon: "🚑"
13859
+ name: "Emergency Siren"
13875
13860
  },
13876
13861
  {
13877
13862
  id: "fire",
13878
- name: "Fire / Smoke",
13879
- icon: "🔥"
13863
+ name: "Fire / Smoke"
13880
13864
  },
13881
13865
  {
13882
13866
  id: "water",
13883
- name: "Water",
13884
- icon: "💧"
13867
+ name: "Water"
13885
13868
  },
13886
13869
  {
13887
13870
  id: "wind",
13888
- name: "Wind / Weather",
13889
- icon: "🌬️"
13871
+ name: "Wind / Weather"
13890
13872
  },
13891
13873
  {
13892
13874
  id: "door",
13893
- name: "Door",
13894
- icon: "🚪"
13875
+ name: "Door"
13895
13876
  },
13896
13877
  {
13897
13878
  id: "footsteps",
13898
- name: "Footsteps",
13899
- icon: "👣"
13879
+ name: "Footsteps"
13900
13880
  },
13901
13881
  {
13902
13882
  id: "crowd",
13903
- name: "Crowd / Chatter",
13904
- icon: "👥"
13883
+ name: "Crowd / Chatter"
13905
13884
  },
13906
13885
  {
13907
13886
  id: "telephone",
13908
- name: "Telephone",
13909
- icon: "📞"
13887
+ name: "Telephone"
13910
13888
  },
13911
13889
  {
13912
13890
  id: "engine",
13913
- name: "Engine / Motor",
13914
- icon: "⚙️"
13891
+ name: "Engine / Motor"
13915
13892
  },
13916
13893
  {
13917
13894
  id: "tools",
13918
- name: "Tools / Construction",
13919
- icon: "🔨"
13895
+ name: "Tools / Construction"
13920
13896
  },
13921
13897
  {
13922
13898
  id: "silence",
13923
- name: "Silence",
13924
- icon: "🤫"
13899
+ name: "Silence"
13925
13900
  }
13926
13901
  ];
13927
13902
  var YAMNET_TO_MACRO = {
@@ -16391,7 +16366,7 @@ var TrackEnvelopeSchema = object({
16391
16366
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16392
16367
  * keeps every scalar the list surfaces actually render (ids, class(es),
16393
16368
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16394
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16369
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16395
16370
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16396
16371
  * `getTrack`. Mirrors the event-store `projection` convention
16397
16372
  * (`getObjectEvents` et al.).
@@ -16686,6 +16661,35 @@ var TrackSchema = object({
16686
16661
  */
16687
16662
  hasFace: boolean().optional(),
16688
16663
  /**
16664
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16665
+ * face an operator could ASSIGN to an identity.
16666
+ *
16667
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16668
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16669
+ * branch, before every gate, and means no more than "a face detector produced
16670
+ * a face detail". This one is stamped at the single moment the gallery row
16671
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16672
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16673
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16674
+ * the crop-store drop. Everything between the detector and that insert can
16675
+ * legitimately refuse the face, so a flag written any earlier promises the
16676
+ * operator something to assign and delivers nothing.
16677
+ *
16678
+ * **Independent of recognition.** A face collected but never auto-matched is
16679
+ * still assignable — it is in fact the face an operator most wants to reach —
16680
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16681
+ * `subLabel`; this says only that the raw material exists.
16682
+ *
16683
+ * **Set once, never cleared.** A track that produced a gallery row produced
16684
+ * one; deleting the row later is the gallery's business, not this flag's.
16685
+ *
16686
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16687
+ * before the column omits it, and so does every server that predates the
16688
+ * field. A consumer must test `=== true` and render nothing otherwise —
16689
+ * never infer "no assignable face".
16690
+ */
16691
+ hasEmbeddedFace: boolean().optional(),
16692
+ /**
16689
16693
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16690
16694
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16691
16695
  * so the passage is tracked once and as a VEHICLE.
@@ -18035,6 +18039,32 @@ var DetailResultSchema = object({
18035
18039
  /** FRAME-space bbox (already mapped back from crop space). */
18036
18040
  bbox: NativeCropBboxSchema.optional(),
18037
18041
  embedding: string().optional(),
18042
+ /**
18043
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18044
+ * so an older runner that does not send it degrades to "unmeasurable", which
18045
+ * the consuming gate treats as accept — never as reject.
18046
+ */
18047
+ embeddingMagnitude: number().optional(),
18048
+ /**
18049
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18050
+ * `label`, and for the same reason: the producing node is the only side that
18051
+ * knows which model actually ran, and re-deriving it downstream is exactly
18052
+ * the inference this model exists to forbid.
18053
+ *
18054
+ * Additive and optional, so a runner that predates it degrades to
18055
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18056
+ * its previous assumption instead of refusing.
18057
+ *
18058
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18059
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18060
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18061
+ * compared the gallery against itself and could never fire. That turned the
18062
+ * one guard protecting the face feature space into a tautology, and it is
18063
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18064
+ * gallery as the catalog comment predicts — it would have scored the new
18065
+ * model's vectors against the old model's samples in one cosine space.
18066
+ */
18067
+ embeddingModelId: string().optional(),
18038
18068
  label: string().optional(),
18039
18069
  /**
18040
18070
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19445,6 +19475,7 @@ DeviceType.Camera, method(object({
19445
19475
  isBattery: boolean(),
19446
19476
  reason: _enum([
19447
19477
  "disabled",
19478
+ "offline",
19448
19479
  "sleeping",
19449
19480
  "unreachable",
19450
19481
  "waking"
@@ -19490,9 +19521,17 @@ targets: array(object({
19490
19521
  sleeping: boolean(),
19491
19522
  /** Current device state rendered over the cached frame. State images
19492
19523
  * remain authoritative even when their photographic background is
19493
- * old; null means the link must carry a current camera frame. */
19524
+ * old; null means the link must carry a current camera frame.
19525
+ *
19526
+ * **This is the ONLY source a surface may derive an inactive tile
19527
+ * from.** A client that reads a device's `online`/`disabled` flags and
19528
+ * draws its own verdict will disagree with the pixels it is painting
19529
+ * — the frame comes from here, and so must the sentence over it
19530
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19531
+ * state. */
19494
19532
  stateReason: _enum([
19495
19533
  "disabled",
19534
+ "offline",
19496
19535
  "sleeping",
19497
19536
  "unreachable",
19498
19537
  "waking"
@@ -24523,9 +24562,21 @@ var RecordingLocationUsageSchema = object({
24523
24562
  * previously rendered as two identical "disks" with a nonsensical used
24524
24563
  * split — hydrate attribution across aliases is arbitrary by nature. */
24525
24564
  locationIds: array(string()).optional(),
24526
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
24565
+ /**
24566
+ * Filesystem root of the physical volume this row accounts — the only
24567
+ * operator-legible identity when a location has no `displayName` yet, and
24568
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
24569
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
24570
+ * it, and this schema must keep validating that older provider's payload.
24571
+ */
24572
+ root: string().optional(),
24573
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
24574
+ * the footage's SHARE of the volume, not how full the volume is — the disk
24575
+ * also holds everything that is not recordings. Volume fill is
24576
+ * `(totalBytes - availableBytes) / totalBytes`. */
24527
24577
  usedBytes: number(),
24528
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
24578
+ /** Free bytes on the location's volume; null when capacity is unknown
24579
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
24529
24580
  availableBytes: number().nullable(),
24530
24581
  /** Total bytes of the location's volume; null when unknown. */
24531
24582
  totalBytes: number().nullable()
@@ -24537,7 +24588,15 @@ var RecordingStorageUsageSchema = object({
24537
24588
  nodeId: string(),
24538
24589
  totalUsedBytes: number(),
24539
24590
  devices: array(RecordingDeviceUsageSchema),
24540
- locations: array(RecordingLocationUsageSchema)
24591
+ /**
24592
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
24593
+ * of the payload without it: the hub serves this method through a BAKED
24594
+ * router, so a hub whose framework train predates a change to this array
24595
+ * strips it out of an answer a newer recorder happily produced. A UI that
24596
+ * dereferences it unconditionally crashes the whole Storage page over a
24597
+ * missing disk bar.
24598
+ */
24599
+ locations: array(RecordingLocationUsageSchema).optional()
24541
24600
  });
24542
24601
  /**
24543
24602
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -33653,8 +33712,13 @@ Object.freeze({
33653
33712
  "network-access": "ingress",
33654
33713
  "smtp-provider": "email"
33655
33714
  });
33656
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33715
+ /** Schema defaults an untouched sub-field must author exactly these. */
33716
+ var NC_AUDIO_DEFAULTS = {
33717
+ hitPercent: 60,
33718
+ samplingSeconds: 10
33719
+ };
33657
33720
  new Set(["devices", "classes"]);
33721
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
33658
33722
  /**
33659
33723
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
33660
33724
  *
@@ -33886,6 +33950,39 @@ TimelapseRuleInputSchema.extend({
33886
33950
  createdAt: number(),
33887
33951
  updatedAt: number()
33888
33952
  });
33953
+ Object.freeze(Object.fromEntries([{
33954
+ stepId: "face-embedding",
33955
+ label: "Face recognition model",
33956
+ defaultModelId: "arcface-r100",
33957
+ indexName: "the enrolled face gallery",
33958
+ options: [
33959
+ {
33960
+ id: "arcface-r100",
33961
+ label: "ArcFace (ResNet34)"
33962
+ },
33963
+ {
33964
+ id: "auraface-r100",
33965
+ label: "AuraFace R100"
33966
+ },
33967
+ {
33968
+ id: "inception-resnet-v1",
33969
+ label: "Inception ResNet V1"
33970
+ }
33971
+ ]
33972
+ }, {
33973
+ stepId: "clip-embedding",
33974
+ label: "Semantic search model",
33975
+ defaultModelId: "mobileclip-s1",
33976
+ indexName: "the object semantic-search index",
33977
+ options: [{
33978
+ id: "mobileclip-s1",
33979
+ label: "MobileCLIP S1"
33980
+ }, {
33981
+ id: "mobileclip-s2",
33982
+ label: "MobileCLIP S2"
33983
+ }]
33984
+ }].map((s) => [s.stepId, s.defaultModelId])));
33985
+ string().min(1);
33889
33986
  object({
33890
33987
  /**
33891
33988
  * Fraction of the box's own size added on EACH side before cutting.
@@ -33906,10 +34003,21 @@ object({
33906
34003
  */
33907
34004
  square: boolean()
33908
34005
  });
33909
- ({
34006
+ /**
34007
+ * The convention in force when nobody has configured one — byte-for-byte the
34008
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
34009
+ */
34010
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
33910
34011
  paddingRatio: .15,
33911
34012
  square: false
33912
- }).paddingRatio;
34013
+ };
34014
+ Object.freeze({
34015
+ x: 0,
34016
+ y: 0,
34017
+ w: 1,
34018
+ h: 1
34019
+ });
34020
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
33913
34021
  /**
33914
34022
  * WHICH delivered frames the decode worker retains a native copy of.
33915
34023
  *
@@ -7707,7 +7707,7 @@ var RecordingBandSchema = object({
7707
7707
  postBufferSec: number().min(0).optional()
7708
7708
  });
7709
7709
  ({
7710
- preBufferSec: 10,
7710
+ preBufferSec: 15,
7711
7711
  postBufferSec: 30
7712
7712
  }).postBufferSec * 1e3;
7713
7713
  /**
@@ -13773,128 +13773,103 @@ var COCO_TO_MACRO = {
13773
13773
  var AUDIO_MACRO_LABELS = [
13774
13774
  {
13775
13775
  id: "speech",
13776
- name: "Speech",
13777
- icon: "🗣️"
13776
+ name: "Speech"
13778
13777
  },
13779
13778
  {
13780
13779
  id: "scream",
13781
- name: "Scream / Shout",
13782
- icon: "😱"
13780
+ name: "Scream / Shout"
13783
13781
  },
13784
13782
  {
13785
13783
  id: "crying",
13786
- name: "Crying / Baby",
13787
- icon: "😢"
13784
+ name: "Crying / Baby"
13788
13785
  },
13789
13786
  {
13790
13787
  id: "laughter",
13791
- name: "Laughter",
13792
- icon: "😂"
13788
+ name: "Laughter"
13793
13789
  },
13794
13790
  {
13795
13791
  id: "music",
13796
- name: "Music",
13797
- icon: "🎵"
13792
+ name: "Music"
13798
13793
  },
13799
13794
  {
13800
13795
  id: "dog",
13801
- name: "Dog",
13802
- icon: "🐕"
13796
+ name: "Dog"
13803
13797
  },
13804
13798
  {
13805
13799
  id: "cat",
13806
- name: "Cat",
13807
- icon: "🐈"
13800
+ name: "Cat"
13808
13801
  },
13809
13802
  {
13810
13803
  id: "bird",
13811
- name: "Bird",
13812
- icon: "🐦"
13804
+ name: "Bird"
13813
13805
  },
13814
13806
  {
13815
13807
  id: "animal",
13816
- name: "Animal (other)",
13817
- icon: "🐾"
13808
+ name: "Animal (other)"
13818
13809
  },
13819
13810
  {
13820
13811
  id: "alarm",
13821
- name: "Alarm / Siren",
13822
- icon: "🚨"
13812
+ name: "Alarm / Siren"
13823
13813
  },
13824
13814
  {
13825
13815
  id: "doorbell",
13826
- name: "Doorbell / Knock",
13827
- icon: "🔔"
13816
+ name: "Doorbell / Knock"
13828
13817
  },
13829
13818
  {
13830
13819
  id: "glass_breaking",
13831
- name: "Glass Breaking",
13832
- icon: "💥"
13820
+ name: "Glass Breaking"
13833
13821
  },
13834
13822
  {
13835
13823
  id: "gunshot",
13836
- name: "Gunshot / Explosion",
13837
- icon: "💣"
13824
+ name: "Gunshot / Explosion"
13838
13825
  },
13839
13826
  {
13840
13827
  id: "vehicle",
13841
- name: "Vehicle",
13842
- icon: "🚗"
13828
+ name: "Vehicle"
13843
13829
  },
13844
13830
  {
13845
13831
  id: "siren",
13846
- name: "Emergency Siren",
13847
- icon: "🚑"
13832
+ name: "Emergency Siren"
13848
13833
  },
13849
13834
  {
13850
13835
  id: "fire",
13851
- name: "Fire / Smoke",
13852
- icon: "🔥"
13836
+ name: "Fire / Smoke"
13853
13837
  },
13854
13838
  {
13855
13839
  id: "water",
13856
- name: "Water",
13857
- icon: "💧"
13840
+ name: "Water"
13858
13841
  },
13859
13842
  {
13860
13843
  id: "wind",
13861
- name: "Wind / Weather",
13862
- icon: "🌬️"
13844
+ name: "Wind / Weather"
13863
13845
  },
13864
13846
  {
13865
13847
  id: "door",
13866
- name: "Door",
13867
- icon: "🚪"
13848
+ name: "Door"
13868
13849
  },
13869
13850
  {
13870
13851
  id: "footsteps",
13871
- name: "Footsteps",
13872
- icon: "👣"
13852
+ name: "Footsteps"
13873
13853
  },
13874
13854
  {
13875
13855
  id: "crowd",
13876
- name: "Crowd / Chatter",
13877
- icon: "👥"
13856
+ name: "Crowd / Chatter"
13878
13857
  },
13879
13858
  {
13880
13859
  id: "telephone",
13881
- name: "Telephone",
13882
- icon: "📞"
13860
+ name: "Telephone"
13883
13861
  },
13884
13862
  {
13885
13863
  id: "engine",
13886
- name: "Engine / Motor",
13887
- icon: "⚙️"
13864
+ name: "Engine / Motor"
13888
13865
  },
13889
13866
  {
13890
13867
  id: "tools",
13891
- name: "Tools / Construction",
13892
- icon: "🔨"
13868
+ name: "Tools / Construction"
13893
13869
  },
13894
13870
  {
13895
13871
  id: "silence",
13896
- name: "Silence",
13897
- icon: "🤫"
13872
+ name: "Silence"
13898
13873
  }
13899
13874
  ];
13900
13875
  var YAMNET_TO_MACRO = {
@@ -16364,7 +16339,7 @@ var TrackEnvelopeSchema = object({
16364
16339
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16365
16340
  * keeps every scalar the list surfaces actually render (ids, class(es),
16366
16341
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16367
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16342
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16368
16343
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16369
16344
  * `getTrack`. Mirrors the event-store `projection` convention
16370
16345
  * (`getObjectEvents` et al.).
@@ -16659,6 +16634,35 @@ var TrackSchema = object({
16659
16634
  */
16660
16635
  hasFace: boolean().optional(),
16661
16636
  /**
16637
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16638
+ * face an operator could ASSIGN to an identity.
16639
+ *
16640
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16641
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16642
+ * branch, before every gate, and means no more than "a face detector produced
16643
+ * a face detail". This one is stamped at the single moment the gallery row
16644
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16645
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16646
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16647
+ * the crop-store drop. Everything between the detector and that insert can
16648
+ * legitimately refuse the face, so a flag written any earlier promises the
16649
+ * operator something to assign and delivers nothing.
16650
+ *
16651
+ * **Independent of recognition.** A face collected but never auto-matched is
16652
+ * still assignable — it is in fact the face an operator most wants to reach —
16653
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16654
+ * `subLabel`; this says only that the raw material exists.
16655
+ *
16656
+ * **Set once, never cleared.** A track that produced a gallery row produced
16657
+ * one; deleting the row later is the gallery's business, not this flag's.
16658
+ *
16659
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16660
+ * before the column omits it, and so does every server that predates the
16661
+ * field. A consumer must test `=== true` and render nothing otherwise —
16662
+ * never infer "no assignable face".
16663
+ */
16664
+ hasEmbeddedFace: boolean().optional(),
16665
+ /**
16662
16666
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16663
16667
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16664
16668
  * so the passage is tracked once and as a VEHICLE.
@@ -18008,6 +18012,32 @@ var DetailResultSchema = object({
18008
18012
  /** FRAME-space bbox (already mapped back from crop space). */
18009
18013
  bbox: NativeCropBboxSchema.optional(),
18010
18014
  embedding: string().optional(),
18015
+ /**
18016
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18017
+ * so an older runner that does not send it degrades to "unmeasurable", which
18018
+ * the consuming gate treats as accept — never as reject.
18019
+ */
18020
+ embeddingMagnitude: number().optional(),
18021
+ /**
18022
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18023
+ * `label`, and for the same reason: the producing node is the only side that
18024
+ * knows which model actually ran, and re-deriving it downstream is exactly
18025
+ * the inference this model exists to forbid.
18026
+ *
18027
+ * Additive and optional, so a runner that predates it degrades to
18028
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18029
+ * its previous assumption instead of refusing.
18030
+ *
18031
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18032
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18033
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18034
+ * compared the gallery against itself and could never fire. That turned the
18035
+ * one guard protecting the face feature space into a tautology, and it is
18036
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18037
+ * gallery as the catalog comment predicts — it would have scored the new
18038
+ * model's vectors against the old model's samples in one cosine space.
18039
+ */
18040
+ embeddingModelId: string().optional(),
18011
18041
  label: string().optional(),
18012
18042
  /**
18013
18043
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19418,6 +19448,7 @@ DeviceType.Camera, method(object({
19418
19448
  isBattery: boolean(),
19419
19449
  reason: _enum([
19420
19450
  "disabled",
19451
+ "offline",
19421
19452
  "sleeping",
19422
19453
  "unreachable",
19423
19454
  "waking"
@@ -19463,9 +19494,17 @@ targets: array(object({
19463
19494
  sleeping: boolean(),
19464
19495
  /** Current device state rendered over the cached frame. State images
19465
19496
  * remain authoritative even when their photographic background is
19466
- * old; null means the link must carry a current camera frame. */
19497
+ * old; null means the link must carry a current camera frame.
19498
+ *
19499
+ * **This is the ONLY source a surface may derive an inactive tile
19500
+ * from.** A client that reads a device's `online`/`disabled` flags and
19501
+ * draws its own verdict will disagree with the pixels it is painting
19502
+ * — the frame comes from here, and so must the sentence over it
19503
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19504
+ * state. */
19467
19505
  stateReason: _enum([
19468
19506
  "disabled",
19507
+ "offline",
19469
19508
  "sleeping",
19470
19509
  "unreachable",
19471
19510
  "waking"
@@ -24496,9 +24535,21 @@ var RecordingLocationUsageSchema = object({
24496
24535
  * previously rendered as two identical "disks" with a nonsensical used
24497
24536
  * split — hydrate attribution across aliases is arbitrary by nature. */
24498
24537
  locationIds: array(string()).optional(),
24499
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
24538
+ /**
24539
+ * Filesystem root of the physical volume this row accounts — the only
24540
+ * operator-legible identity when a location has no `displayName` yet, and
24541
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
24542
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
24543
+ * it, and this schema must keep validating that older provider's payload.
24544
+ */
24545
+ root: string().optional(),
24546
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
24547
+ * the footage's SHARE of the volume, not how full the volume is — the disk
24548
+ * also holds everything that is not recordings. Volume fill is
24549
+ * `(totalBytes - availableBytes) / totalBytes`. */
24500
24550
  usedBytes: number(),
24501
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
24551
+ /** Free bytes on the location's volume; null when capacity is unknown
24552
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
24502
24553
  availableBytes: number().nullable(),
24503
24554
  /** Total bytes of the location's volume; null when unknown. */
24504
24555
  totalBytes: number().nullable()
@@ -24510,7 +24561,15 @@ var RecordingStorageUsageSchema = object({
24510
24561
  nodeId: string(),
24511
24562
  totalUsedBytes: number(),
24512
24563
  devices: array(RecordingDeviceUsageSchema),
24513
- locations: array(RecordingLocationUsageSchema)
24564
+ /**
24565
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
24566
+ * of the payload without it: the hub serves this method through a BAKED
24567
+ * router, so a hub whose framework train predates a change to this array
24568
+ * strips it out of an answer a newer recorder happily produced. A UI that
24569
+ * dereferences it unconditionally crashes the whole Storage page over a
24570
+ * missing disk bar.
24571
+ */
24572
+ locations: array(RecordingLocationUsageSchema).optional()
24514
24573
  });
24515
24574
  /**
24516
24575
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -33626,8 +33685,13 @@ Object.freeze({
33626
33685
  "network-access": "ingress",
33627
33686
  "smtp-provider": "email"
33628
33687
  });
33629
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
33688
+ /** Schema defaults an untouched sub-field must author exactly these. */
33689
+ var NC_AUDIO_DEFAULTS = {
33690
+ hitPercent: 60,
33691
+ samplingSeconds: 10
33692
+ };
33630
33693
  new Set(["devices", "classes"]);
33694
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
33631
33695
  /**
33632
33696
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
33633
33697
  *
@@ -33859,6 +33923,39 @@ TimelapseRuleInputSchema.extend({
33859
33923
  createdAt: number(),
33860
33924
  updatedAt: number()
33861
33925
  });
33926
+ Object.freeze(Object.fromEntries([{
33927
+ stepId: "face-embedding",
33928
+ label: "Face recognition model",
33929
+ defaultModelId: "arcface-r100",
33930
+ indexName: "the enrolled face gallery",
33931
+ options: [
33932
+ {
33933
+ id: "arcface-r100",
33934
+ label: "ArcFace (ResNet34)"
33935
+ },
33936
+ {
33937
+ id: "auraface-r100",
33938
+ label: "AuraFace R100"
33939
+ },
33940
+ {
33941
+ id: "inception-resnet-v1",
33942
+ label: "Inception ResNet V1"
33943
+ }
33944
+ ]
33945
+ }, {
33946
+ stepId: "clip-embedding",
33947
+ label: "Semantic search model",
33948
+ defaultModelId: "mobileclip-s1",
33949
+ indexName: "the object semantic-search index",
33950
+ options: [{
33951
+ id: "mobileclip-s1",
33952
+ label: "MobileCLIP S1"
33953
+ }, {
33954
+ id: "mobileclip-s2",
33955
+ label: "MobileCLIP S2"
33956
+ }]
33957
+ }].map((s) => [s.stepId, s.defaultModelId])));
33958
+ string().min(1);
33862
33959
  object({
33863
33960
  /**
33864
33961
  * Fraction of the box's own size added on EACH side before cutting.
@@ -33879,10 +33976,21 @@ object({
33879
33976
  */
33880
33977
  square: boolean()
33881
33978
  });
33882
- ({
33979
+ /**
33980
+ * The convention in force when nobody has configured one — byte-for-byte the
33981
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
33982
+ */
33983
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
33883
33984
  paddingRatio: .15,
33884
33985
  square: false
33885
- }).paddingRatio;
33986
+ };
33987
+ Object.freeze({
33988
+ x: 0,
33989
+ y: 0,
33990
+ w: 1,
33991
+ h: 1
33992
+ });
33993
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
33886
33994
  /**
33887
33995
  * WHICH delivered frames the decode worker retains a native copy of.
33888
33996
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-alexa",
3
- "version": "1.2.28",
3
+ "version": "1.2.30",
4
4
  "description": "Alexa Smart Home Skill export — hub-side OAuth provider + directive handler. The companion AWS Lambda forwards Alexa directives to this addon's /addon/export-alexa/directive endpoint.",
5
5
  "keywords": [
6
6
  "camstack",