@camstack/addon-import-alexa 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
@@ -7724,7 +7724,7 @@ var RecordingBandSchema = object({
7724
7724
  postBufferSec: number().min(0).optional()
7725
7725
  });
7726
7726
  ({
7727
- preBufferSec: 10,
7727
+ preBufferSec: 15,
7728
7728
  postBufferSec: 30
7729
7729
  }).postBufferSec * 1e3;
7730
7730
  /**
@@ -14012,128 +14012,103 @@ var COCO_TO_MACRO = {
14012
14012
  var AUDIO_MACRO_LABELS = [
14013
14013
  {
14014
14014
  id: "speech",
14015
- name: "Speech",
14016
- icon: "🗣️"
14015
+ name: "Speech"
14017
14016
  },
14018
14017
  {
14019
14018
  id: "scream",
14020
- name: "Scream / Shout",
14021
- icon: "😱"
14019
+ name: "Scream / Shout"
14022
14020
  },
14023
14021
  {
14024
14022
  id: "crying",
14025
- name: "Crying / Baby",
14026
- icon: "😢"
14023
+ name: "Crying / Baby"
14027
14024
  },
14028
14025
  {
14029
14026
  id: "laughter",
14030
- name: "Laughter",
14031
- icon: "😂"
14027
+ name: "Laughter"
14032
14028
  },
14033
14029
  {
14034
14030
  id: "music",
14035
- name: "Music",
14036
- icon: "🎵"
14031
+ name: "Music"
14037
14032
  },
14038
14033
  {
14039
14034
  id: "dog",
14040
- name: "Dog",
14041
- icon: "🐕"
14035
+ name: "Dog"
14042
14036
  },
14043
14037
  {
14044
14038
  id: "cat",
14045
- name: "Cat",
14046
- icon: "🐈"
14039
+ name: "Cat"
14047
14040
  },
14048
14041
  {
14049
14042
  id: "bird",
14050
- name: "Bird",
14051
- icon: "🐦"
14043
+ name: "Bird"
14052
14044
  },
14053
14045
  {
14054
14046
  id: "animal",
14055
- name: "Animal (other)",
14056
- icon: "🐾"
14047
+ name: "Animal (other)"
14057
14048
  },
14058
14049
  {
14059
14050
  id: "alarm",
14060
- name: "Alarm / Siren",
14061
- icon: "🚨"
14051
+ name: "Alarm / Siren"
14062
14052
  },
14063
14053
  {
14064
14054
  id: "doorbell",
14065
- name: "Doorbell / Knock",
14066
- icon: "🔔"
14055
+ name: "Doorbell / Knock"
14067
14056
  },
14068
14057
  {
14069
14058
  id: "glass_breaking",
14070
- name: "Glass Breaking",
14071
- icon: "💥"
14059
+ name: "Glass Breaking"
14072
14060
  },
14073
14061
  {
14074
14062
  id: "gunshot",
14075
- name: "Gunshot / Explosion",
14076
- icon: "💣"
14063
+ name: "Gunshot / Explosion"
14077
14064
  },
14078
14065
  {
14079
14066
  id: "vehicle",
14080
- name: "Vehicle",
14081
- icon: "🚗"
14067
+ name: "Vehicle"
14082
14068
  },
14083
14069
  {
14084
14070
  id: "siren",
14085
- name: "Emergency Siren",
14086
- icon: "🚑"
14071
+ name: "Emergency Siren"
14087
14072
  },
14088
14073
  {
14089
14074
  id: "fire",
14090
- name: "Fire / Smoke",
14091
- icon: "🔥"
14075
+ name: "Fire / Smoke"
14092
14076
  },
14093
14077
  {
14094
14078
  id: "water",
14095
- name: "Water",
14096
- icon: "💧"
14079
+ name: "Water"
14097
14080
  },
14098
14081
  {
14099
14082
  id: "wind",
14100
- name: "Wind / Weather",
14101
- icon: "🌬️"
14083
+ name: "Wind / Weather"
14102
14084
  },
14103
14085
  {
14104
14086
  id: "door",
14105
- name: "Door",
14106
- icon: "🚪"
14087
+ name: "Door"
14107
14088
  },
14108
14089
  {
14109
14090
  id: "footsteps",
14110
- name: "Footsteps",
14111
- icon: "👣"
14091
+ name: "Footsteps"
14112
14092
  },
14113
14093
  {
14114
14094
  id: "crowd",
14115
- name: "Crowd / Chatter",
14116
- icon: "👥"
14095
+ name: "Crowd / Chatter"
14117
14096
  },
14118
14097
  {
14119
14098
  id: "telephone",
14120
- name: "Telephone",
14121
- icon: "📞"
14099
+ name: "Telephone"
14122
14100
  },
14123
14101
  {
14124
14102
  id: "engine",
14125
- name: "Engine / Motor",
14126
- icon: "⚙️"
14103
+ name: "Engine / Motor"
14127
14104
  },
14128
14105
  {
14129
14106
  id: "tools",
14130
- name: "Tools / Construction",
14131
- icon: "🔨"
14107
+ name: "Tools / Construction"
14132
14108
  },
14133
14109
  {
14134
14110
  id: "silence",
14135
- name: "Silence",
14136
- icon: "🤫"
14111
+ name: "Silence"
14137
14112
  }
14138
14113
  ];
14139
14114
  var YAMNET_TO_MACRO = {
@@ -16635,7 +16610,7 @@ var TrackEnvelopeSchema = object({
16635
16610
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16636
16611
  * keeps every scalar the list surfaces actually render (ids, class(es),
16637
16612
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16638
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16613
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16639
16614
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16640
16615
  * `getTrack`. Mirrors the event-store `projection` convention
16641
16616
  * (`getObjectEvents` et al.).
@@ -16930,6 +16905,35 @@ var TrackSchema = object({
16930
16905
  */
16931
16906
  hasFace: boolean().optional(),
16932
16907
  /**
16908
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16909
+ * face an operator could ASSIGN to an identity.
16910
+ *
16911
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16912
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16913
+ * branch, before every gate, and means no more than "a face detector produced
16914
+ * a face detail". This one is stamped at the single moment the gallery row
16915
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16916
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16917
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16918
+ * the crop-store drop. Everything between the detector and that insert can
16919
+ * legitimately refuse the face, so a flag written any earlier promises the
16920
+ * operator something to assign and delivers nothing.
16921
+ *
16922
+ * **Independent of recognition.** A face collected but never auto-matched is
16923
+ * still assignable — it is in fact the face an operator most wants to reach —
16924
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16925
+ * `subLabel`; this says only that the raw material exists.
16926
+ *
16927
+ * **Set once, never cleared.** A track that produced a gallery row produced
16928
+ * one; deleting the row later is the gallery's business, not this flag's.
16929
+ *
16930
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16931
+ * before the column omits it, and so does every server that predates the
16932
+ * field. A consumer must test `=== true` and render nothing otherwise —
16933
+ * never infer "no assignable face".
16934
+ */
16935
+ hasEmbeddedFace: boolean().optional(),
16936
+ /**
16933
16937
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16934
16938
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16935
16939
  * so the passage is tracked once and as a VEHICLE.
@@ -18319,6 +18323,32 @@ var DetailResultSchema = object({
18319
18323
  /** FRAME-space bbox (already mapped back from crop space). */
18320
18324
  bbox: NativeCropBboxSchema.optional(),
18321
18325
  embedding: string().optional(),
18326
+ /**
18327
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18328
+ * so an older runner that does not send it degrades to "unmeasurable", which
18329
+ * the consuming gate treats as accept — never as reject.
18330
+ */
18331
+ embeddingMagnitude: number().optional(),
18332
+ /**
18333
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18334
+ * `label`, and for the same reason: the producing node is the only side that
18335
+ * knows which model actually ran, and re-deriving it downstream is exactly
18336
+ * the inference this model exists to forbid.
18337
+ *
18338
+ * Additive and optional, so a runner that predates it degrades to
18339
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18340
+ * its previous assumption instead of refusing.
18341
+ *
18342
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18343
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18344
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18345
+ * compared the gallery against itself and could never fire. That turned the
18346
+ * one guard protecting the face feature space into a tautology, and it is
18347
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18348
+ * gallery as the catalog comment predicts — it would have scored the new
18349
+ * model's vectors against the old model's samples in one cosine space.
18350
+ */
18351
+ embeddingModelId: string().optional(),
18322
18352
  label: string().optional(),
18323
18353
  /**
18324
18354
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19729,6 +19759,7 @@ DeviceType.Camera, method(object({
19729
19759
  isBattery: boolean(),
19730
19760
  reason: _enum([
19731
19761
  "disabled",
19762
+ "offline",
19732
19763
  "sleeping",
19733
19764
  "unreachable",
19734
19765
  "waking"
@@ -19774,9 +19805,17 @@ targets: array(object({
19774
19805
  sleeping: boolean(),
19775
19806
  /** Current device state rendered over the cached frame. State images
19776
19807
  * remain authoritative even when their photographic background is
19777
- * old; null means the link must carry a current camera frame. */
19808
+ * old; null means the link must carry a current camera frame.
19809
+ *
19810
+ * **This is the ONLY source a surface may derive an inactive tile
19811
+ * from.** A client that reads a device's `online`/`disabled` flags and
19812
+ * draws its own verdict will disagree with the pixels it is painting
19813
+ * — the frame comes from here, and so must the sentence over it
19814
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19815
+ * state. */
19778
19816
  stateReason: _enum([
19779
19817
  "disabled",
19818
+ "offline",
19780
19819
  "sleeping",
19781
19820
  "unreachable",
19782
19821
  "waking"
@@ -26512,9 +26551,21 @@ var RecordingLocationUsageSchema = object({
26512
26551
  * previously rendered as two identical "disks" with a nonsensical used
26513
26552
  * split — hydrate attribution across aliases is arbitrary by nature. */
26514
26553
  locationIds: array(string()).optional(),
26515
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
26554
+ /**
26555
+ * Filesystem root of the physical volume this row accounts — the only
26556
+ * operator-legible identity when a location has no `displayName` yet, and
26557
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
26558
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
26559
+ * it, and this schema must keep validating that older provider's payload.
26560
+ */
26561
+ root: string().optional(),
26562
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
26563
+ * the footage's SHARE of the volume, not how full the volume is — the disk
26564
+ * also holds everything that is not recordings. Volume fill is
26565
+ * `(totalBytes - availableBytes) / totalBytes`. */
26516
26566
  usedBytes: number(),
26517
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
26567
+ /** Free bytes on the location's volume; null when capacity is unknown
26568
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
26518
26569
  availableBytes: number().nullable(),
26519
26570
  /** Total bytes of the location's volume; null when unknown. */
26520
26571
  totalBytes: number().nullable()
@@ -26526,7 +26577,15 @@ var RecordingStorageUsageSchema = object({
26526
26577
  nodeId: string(),
26527
26578
  totalUsedBytes: number(),
26528
26579
  devices: array(RecordingDeviceUsageSchema),
26529
- locations: array(RecordingLocationUsageSchema)
26580
+ /**
26581
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
26582
+ * of the payload without it: the hub serves this method through a BAKED
26583
+ * router, so a hub whose framework train predates a change to this array
26584
+ * strips it out of an answer a newer recorder happily produced. A UI that
26585
+ * dereferences it unconditionally crashes the whole Storage page over a
26586
+ * missing disk bar.
26587
+ */
26588
+ locations: array(RecordingLocationUsageSchema).optional()
26530
26589
  });
26531
26590
  /**
26532
26591
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -37311,8 +37370,13 @@ Object.freeze({
37311
37370
  "network-access": "ingress",
37312
37371
  "smtp-provider": "email"
37313
37372
  });
37314
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
37373
+ /** Schema defaults an untouched sub-field must author exactly these. */
37374
+ var NC_AUDIO_DEFAULTS = {
37375
+ hitPercent: 60,
37376
+ samplingSeconds: 10
37377
+ };
37315
37378
  new Set(["devices", "classes"]);
37379
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
37316
37380
  /**
37317
37381
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
37318
37382
  *
@@ -37544,6 +37608,39 @@ TimelapseRuleInputSchema.extend({
37544
37608
  createdAt: number(),
37545
37609
  updatedAt: number()
37546
37610
  });
37611
+ Object.freeze(Object.fromEntries([{
37612
+ stepId: "face-embedding",
37613
+ label: "Face recognition model",
37614
+ defaultModelId: "arcface-r100",
37615
+ indexName: "the enrolled face gallery",
37616
+ options: [
37617
+ {
37618
+ id: "arcface-r100",
37619
+ label: "ArcFace (ResNet34)"
37620
+ },
37621
+ {
37622
+ id: "auraface-r100",
37623
+ label: "AuraFace R100"
37624
+ },
37625
+ {
37626
+ id: "inception-resnet-v1",
37627
+ label: "Inception ResNet V1"
37628
+ }
37629
+ ]
37630
+ }, {
37631
+ stepId: "clip-embedding",
37632
+ label: "Semantic search model",
37633
+ defaultModelId: "mobileclip-s1",
37634
+ indexName: "the object semantic-search index",
37635
+ options: [{
37636
+ id: "mobileclip-s1",
37637
+ label: "MobileCLIP S1"
37638
+ }, {
37639
+ id: "mobileclip-s2",
37640
+ label: "MobileCLIP S2"
37641
+ }]
37642
+ }].map((s) => [s.stepId, s.defaultModelId])));
37643
+ string().min(1);
37547
37644
  object({
37548
37645
  /**
37549
37646
  * Fraction of the box's own size added on EACH side before cutting.
@@ -37564,10 +37661,21 @@ object({
37564
37661
  */
37565
37662
  square: boolean()
37566
37663
  });
37567
- ({
37664
+ /**
37665
+ * The convention in force when nobody has configured one — byte-for-byte the
37666
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
37667
+ */
37668
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
37568
37669
  paddingRatio: .15,
37569
37670
  square: false
37570
- }).paddingRatio;
37671
+ };
37672
+ Object.freeze({
37673
+ x: 0,
37674
+ y: 0,
37675
+ w: 1,
37676
+ h: 1
37677
+ });
37678
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
37571
37679
  /**
37572
37680
  * WHICH delivered frames the decode worker retains a native copy of.
37573
37681
  *
package/dist/addon.mjs CHANGED
@@ -7724,7 +7724,7 @@ var RecordingBandSchema = object({
7724
7724
  postBufferSec: number().min(0).optional()
7725
7725
  });
7726
7726
  ({
7727
- preBufferSec: 10,
7727
+ preBufferSec: 15,
7728
7728
  postBufferSec: 30
7729
7729
  }).postBufferSec * 1e3;
7730
7730
  /**
@@ -14012,128 +14012,103 @@ var COCO_TO_MACRO = {
14012
14012
  var AUDIO_MACRO_LABELS = [
14013
14013
  {
14014
14014
  id: "speech",
14015
- name: "Speech",
14016
- icon: "🗣️"
14015
+ name: "Speech"
14017
14016
  },
14018
14017
  {
14019
14018
  id: "scream",
14020
- name: "Scream / Shout",
14021
- icon: "😱"
14019
+ name: "Scream / Shout"
14022
14020
  },
14023
14021
  {
14024
14022
  id: "crying",
14025
- name: "Crying / Baby",
14026
- icon: "😢"
14023
+ name: "Crying / Baby"
14027
14024
  },
14028
14025
  {
14029
14026
  id: "laughter",
14030
- name: "Laughter",
14031
- icon: "😂"
14027
+ name: "Laughter"
14032
14028
  },
14033
14029
  {
14034
14030
  id: "music",
14035
- name: "Music",
14036
- icon: "🎵"
14031
+ name: "Music"
14037
14032
  },
14038
14033
  {
14039
14034
  id: "dog",
14040
- name: "Dog",
14041
- icon: "🐕"
14035
+ name: "Dog"
14042
14036
  },
14043
14037
  {
14044
14038
  id: "cat",
14045
- name: "Cat",
14046
- icon: "🐈"
14039
+ name: "Cat"
14047
14040
  },
14048
14041
  {
14049
14042
  id: "bird",
14050
- name: "Bird",
14051
- icon: "🐦"
14043
+ name: "Bird"
14052
14044
  },
14053
14045
  {
14054
14046
  id: "animal",
14055
- name: "Animal (other)",
14056
- icon: "🐾"
14047
+ name: "Animal (other)"
14057
14048
  },
14058
14049
  {
14059
14050
  id: "alarm",
14060
- name: "Alarm / Siren",
14061
- icon: "🚨"
14051
+ name: "Alarm / Siren"
14062
14052
  },
14063
14053
  {
14064
14054
  id: "doorbell",
14065
- name: "Doorbell / Knock",
14066
- icon: "🔔"
14055
+ name: "Doorbell / Knock"
14067
14056
  },
14068
14057
  {
14069
14058
  id: "glass_breaking",
14070
- name: "Glass Breaking",
14071
- icon: "💥"
14059
+ name: "Glass Breaking"
14072
14060
  },
14073
14061
  {
14074
14062
  id: "gunshot",
14075
- name: "Gunshot / Explosion",
14076
- icon: "💣"
14063
+ name: "Gunshot / Explosion"
14077
14064
  },
14078
14065
  {
14079
14066
  id: "vehicle",
14080
- name: "Vehicle",
14081
- icon: "🚗"
14067
+ name: "Vehicle"
14082
14068
  },
14083
14069
  {
14084
14070
  id: "siren",
14085
- name: "Emergency Siren",
14086
- icon: "🚑"
14071
+ name: "Emergency Siren"
14087
14072
  },
14088
14073
  {
14089
14074
  id: "fire",
14090
- name: "Fire / Smoke",
14091
- icon: "🔥"
14075
+ name: "Fire / Smoke"
14092
14076
  },
14093
14077
  {
14094
14078
  id: "water",
14095
- name: "Water",
14096
- icon: "💧"
14079
+ name: "Water"
14097
14080
  },
14098
14081
  {
14099
14082
  id: "wind",
14100
- name: "Wind / Weather",
14101
- icon: "🌬️"
14083
+ name: "Wind / Weather"
14102
14084
  },
14103
14085
  {
14104
14086
  id: "door",
14105
- name: "Door",
14106
- icon: "🚪"
14087
+ name: "Door"
14107
14088
  },
14108
14089
  {
14109
14090
  id: "footsteps",
14110
- name: "Footsteps",
14111
- icon: "👣"
14091
+ name: "Footsteps"
14112
14092
  },
14113
14093
  {
14114
14094
  id: "crowd",
14115
- name: "Crowd / Chatter",
14116
- icon: "👥"
14095
+ name: "Crowd / Chatter"
14117
14096
  },
14118
14097
  {
14119
14098
  id: "telephone",
14120
- name: "Telephone",
14121
- icon: "📞"
14099
+ name: "Telephone"
14122
14100
  },
14123
14101
  {
14124
14102
  id: "engine",
14125
- name: "Engine / Motor",
14126
- icon: "⚙️"
14103
+ name: "Engine / Motor"
14127
14104
  },
14128
14105
  {
14129
14106
  id: "tools",
14130
- name: "Tools / Construction",
14131
- icon: "🔨"
14107
+ name: "Tools / Construction"
14132
14108
  },
14133
14109
  {
14134
14110
  id: "silence",
14135
- name: "Silence",
14136
- icon: "🤫"
14111
+ name: "Silence"
14137
14112
  }
14138
14113
  ];
14139
14114
  var YAMNET_TO_MACRO = {
@@ -16635,7 +16610,7 @@ var TrackEnvelopeSchema = object({
16635
16610
  * `snapshots[]` references — megabytes across a page of tracks. `slim`
16636
16611
  * keeps every scalar the list surfaces actually render (ids, class(es),
16637
16612
  * label / audioLabels / importance enrichment, firstSeen/lastSeen, state,
16638
- * zonesVisited, bestEventId, envelope, hasFace, hasRider) and returns `positions` /
16613
+ * zonesVisited, bestEventId, envelope, hasFace, hasEmbeddedFace, hasRider) and returns `positions` /
16639
16614
  * `snapshots` as EMPTY arrays — detail views re-fetch the full row via
16640
16615
  * `getTrack`. Mirrors the event-store `projection` convention
16641
16616
  * (`getObjectEvents` et al.).
@@ -16930,6 +16905,35 @@ var TrackSchema = object({
16930
16905
  */
16931
16906
  hasFace: boolean().optional(),
16932
16907
  /**
16908
+ * This track has a face row IN THE GALLERY: a crop **and** an embedding — a
16909
+ * face an operator could ASSIGN to an identity.
16910
+ *
16911
+ * The STRICT twin of {@link hasFace}, and the pair only earns its keep
16912
+ * because the two disagree. `hasFace` is stamped at the TOP of the face
16913
+ * branch, before every gate, and means no more than "a face detector produced
16914
+ * a face detail". This one is stamped at the single moment the gallery row
16915
+ * LANDS — after `FaceRecognizer.onTrackEnd` successfully persists it, i.e.
16916
+ * past the embedding-magnitude verdict, the `minFacePx` detection gate, the
16917
+ * candidate gate, the imageless-track drop (no crop was ever captured) and
16918
+ * the crop-store drop. Everything between the detector and that insert can
16919
+ * legitimately refuse the face, so a flag written any earlier promises the
16920
+ * operator something to assign and delivers nothing.
16921
+ *
16922
+ * **Independent of recognition.** A face collected but never auto-matched is
16923
+ * still assignable — it is in fact the face an operator most wants to reach —
16924
+ * so this is NOT gated on `recognizedIdentityId`. Recognition lands in
16925
+ * `subLabel`; this says only that the raw material exists.
16926
+ *
16927
+ * **Set once, never cleared.** A track that produced a gallery row produced
16928
+ * one; deleting the row later is the gallery's business, not this flag's.
16929
+ *
16930
+ * **Absent ≠ false**, the same rule as {@link hasFace}: every row written
16931
+ * before the column omits it, and so does every server that predates the
16932
+ * field. A consumer must test `=== true` and render nothing otherwise —
16933
+ * never infer "no assignable face".
16934
+ */
16935
+ hasEmbeddedFace: boolean().optional(),
16936
+ /**
16933
16937
  * This subject CONTAINS a folded rider — a person the rider-pairing step
16934
16938
  * ([D34](../decisions/adr-0034.md)) removed from the frame BEFORE the tracker,
16935
16939
  * so the passage is tracked once and as a VEHICLE.
@@ -18319,6 +18323,32 @@ var DetailResultSchema = object({
18319
18323
  /** FRAME-space bbox (already mapped back from crop space). */
18320
18324
  bbox: NativeCropBboxSchema.optional(),
18321
18325
  embedding: string().optional(),
18326
+ /**
18327
+ * L2 magnitude of the RAW pre-normalization embedding. Additive and optional
18328
+ * so an older runner that does not send it degrades to "unmeasurable", which
18329
+ * the consuming gate treats as accept — never as reject.
18330
+ */
18331
+ embeddingMagnitude: number().optional(),
18332
+ /**
18333
+ * Model that produced `embedding` — the SAME contract `labelModelId` has for
18334
+ * `label`, and for the same reason: the producing node is the only side that
18335
+ * knows which model actually ran, and re-deriving it downstream is exactly
18336
+ * the inference this model exists to forbid.
18337
+ *
18338
+ * Additive and optional, so a runner that predates it degrades to
18339
+ * "unmeasurable" rather than to a wrong answer — the consumer falls back to
18340
+ * its previous assumption instead of refusing.
18341
+ *
18342
+ * Its absence was not cosmetic. `FaceRecognizer` needs the probe's model id
18343
+ * to use `face-matcher`'s same-model gate (`sample.modelId !== probe.modelId`);
18344
+ * with nothing on the wire it took the id from the GALLERY, so the gate
18345
+ * compared the gallery against itself and could never fire. That turned the
18346
+ * one guard protecting the face feature space into a tautology, and it is
18347
+ * why swapping `face-embedding`'s model would NOT have stranded the enrolled
18348
+ * gallery as the catalog comment predicts — it would have scored the new
18349
+ * model's vectors against the old model's samples in one cosine space.
18350
+ */
18351
+ embeddingModelId: string().optional(),
18322
18352
  label: string().optional(),
18323
18353
  /**
18324
18354
  * The tier `label` occupies, copied VERBATIM from the producing step's
@@ -19729,6 +19759,7 @@ DeviceType.Camera, method(object({
19729
19759
  isBattery: boolean(),
19730
19760
  reason: _enum([
19731
19761
  "disabled",
19762
+ "offline",
19732
19763
  "sleeping",
19733
19764
  "unreachable",
19734
19765
  "waking"
@@ -19774,9 +19805,17 @@ targets: array(object({
19774
19805
  sleeping: boolean(),
19775
19806
  /** Current device state rendered over the cached frame. State images
19776
19807
  * remain authoritative even when their photographic background is
19777
- * old; null means the link must carry a current camera frame. */
19808
+ * old; null means the link must carry a current camera frame.
19809
+ *
19810
+ * **This is the ONLY source a surface may derive an inactive tile
19811
+ * from.** A client that reads a device's `online`/`disabled` flags and
19812
+ * draws its own verdict will disagree with the pixels it is painting
19813
+ * — the frame comes from here, and so must the sentence over it
19814
+ * (D190). Pair with `ageMs` for the age of the photograph behind the
19815
+ * state. */
19778
19816
  stateReason: _enum([
19779
19817
  "disabled",
19818
+ "offline",
19780
19819
  "sleeping",
19781
19820
  "unreachable",
19782
19821
  "waking"
@@ -26512,9 +26551,21 @@ var RecordingLocationUsageSchema = object({
26512
26551
  * previously rendered as two identical "disks" with a nonsensical used
26513
26552
  * split — hydrate attribution across aliases is arbitrary by nature. */
26514
26553
  locationIds: array(string()).optional(),
26515
- /** Bytes of recordings stored on this PHYSICAL volume (all aliases). */
26554
+ /**
26555
+ * Filesystem root of the physical volume this row accounts — the only
26556
+ * operator-legible identity when a location has no `displayName` yet, and
26557
+ * what a "which disk is full" alert has to name. OPTIONAL for the same
26558
+ * train-skew reason as `oldestMs`: a recorder that predates the field omits
26559
+ * it, and this schema must keep validating that older provider's payload.
26560
+ */
26561
+ root: string().optional(),
26562
+ /** Bytes of recordings stored on this PHYSICAL volume (all aliases). This is
26563
+ * the footage's SHARE of the volume, not how full the volume is — the disk
26564
+ * also holds everything that is not recordings. Volume fill is
26565
+ * `(totalBytes - availableBytes) / totalBytes`. */
26516
26566
  usedBytes: number(),
26517
- /** Free bytes on the location's volume; null when capacity is unknown (remote). */
26567
+ /** Free bytes on the location's volume; null when capacity is unknown
26568
+ * (remote/unstattable — the recorder logs the statfs failure with the root). */
26518
26569
  availableBytes: number().nullable(),
26519
26570
  /** Total bytes of the location's volume; null when unknown. */
26520
26571
  totalBytes: number().nullable()
@@ -26526,7 +26577,15 @@ var RecordingStorageUsageSchema = object({
26526
26577
  nodeId: string(),
26527
26578
  totalUsedBytes: number(),
26528
26579
  devices: array(RecordingDeviceUsageSchema),
26529
- locations: array(RecordingLocationUsageSchema)
26580
+ /**
26581
+ * Per-physical-volume capacity. OPTIONAL, and consumers must render the rest
26582
+ * of the payload without it: the hub serves this method through a BAKED
26583
+ * router, so a hub whose framework train predates a change to this array
26584
+ * strips it out of an answer a newer recorder happily produced. A UI that
26585
+ * dereferences it unconditionally crashes the whole Storage page over a
26586
+ * missing disk bar.
26587
+ */
26588
+ locations: array(RecordingLocationUsageSchema).optional()
26530
26589
  });
26531
26590
  /**
26532
26591
  * The OPERATOR-ARMED half of multi-location recordings (D116).
@@ -37311,8 +37370,13 @@ Object.freeze({
37311
37370
  "network-access": "ingress",
37312
37371
  "smtp-provider": "email"
37313
37372
  });
37314
- new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
37373
+ /** Schema defaults an untouched sub-field must author exactly these. */
37374
+ var NC_AUDIO_DEFAULTS = {
37375
+ hitPercent: 60,
37376
+ samplingSeconds: 10
37377
+ };
37315
37378
  new Set(["devices", "classes"]);
37379
+ NC_AUDIO_DEFAULTS.hitPercent, NC_AUDIO_DEFAULTS.samplingSeconds;
37316
37380
  /**
37317
37381
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
37318
37382
  *
@@ -37544,6 +37608,39 @@ TimelapseRuleInputSchema.extend({
37544
37608
  createdAt: number(),
37545
37609
  updatedAt: number()
37546
37610
  });
37611
+ Object.freeze(Object.fromEntries([{
37612
+ stepId: "face-embedding",
37613
+ label: "Face recognition model",
37614
+ defaultModelId: "arcface-r100",
37615
+ indexName: "the enrolled face gallery",
37616
+ options: [
37617
+ {
37618
+ id: "arcface-r100",
37619
+ label: "ArcFace (ResNet34)"
37620
+ },
37621
+ {
37622
+ id: "auraface-r100",
37623
+ label: "AuraFace R100"
37624
+ },
37625
+ {
37626
+ id: "inception-resnet-v1",
37627
+ label: "Inception ResNet V1"
37628
+ }
37629
+ ]
37630
+ }, {
37631
+ stepId: "clip-embedding",
37632
+ label: "Semantic search model",
37633
+ defaultModelId: "mobileclip-s1",
37634
+ indexName: "the object semantic-search index",
37635
+ options: [{
37636
+ id: "mobileclip-s1",
37637
+ label: "MobileCLIP S1"
37638
+ }, {
37639
+ id: "mobileclip-s2",
37640
+ label: "MobileCLIP S2"
37641
+ }]
37642
+ }].map((s) => [s.stepId, s.defaultModelId])));
37643
+ string().min(1);
37547
37644
  object({
37548
37645
  /**
37549
37646
  * Fraction of the box's own size added on EACH side before cutting.
@@ -37564,10 +37661,21 @@ object({
37564
37661
  */
37565
37662
  square: boolean()
37566
37663
  });
37567
- ({
37664
+ /**
37665
+ * The convention in force when nobody has configured one — byte-for-byte the
37666
+ * behaviour of the pre-unification LIVE path (`DETAIL_CROP_PADDING_RATIO`).
37667
+ */
37668
+ var DEFAULT_DETAIL_CROP_CONVENTION = {
37568
37669
  paddingRatio: .15,
37569
37670
  square: false
37570
- }).paddingRatio;
37671
+ };
37672
+ Object.freeze({
37673
+ x: 0,
37674
+ y: 0,
37675
+ w: 1,
37676
+ h: 1
37677
+ });
37678
+ DEFAULT_DETAIL_CROP_CONVENTION.paddingRatio;
37571
37679
  /**
37572
37680
  * WHICH delivered frames the decode worker retains a native copy of.
37573
37681
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-import-alexa",
3
- "version": "0.2.21",
3
+ "version": "0.2.23",
4
4
  "description": "Alexa device-import provider for CamStack — imports the smart-home devices in a user's Alexa account via the unofficial alexa-remote2 cookie/token client (the inverse of the Alexa exporter)",
5
5
  "keywords": [
6
6
  "camstack",