@camstack/addon-import-alexa 0.2.37 → 0.2.40

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.
package/dist/addon.js CHANGED
@@ -13710,6 +13710,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13710
13710
  limit: number().optional(),
13711
13711
  tags: record(string(), string()).optional()
13712
13712
  }), array(LogEntrySchema).readonly());
13713
+ /**
13714
+ * `failure-contribution` — the capability an addon reports its OWN losses
13715
+ * through, per camera, with the denominator attached. It stores nothing.
13716
+ *
13717
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13718
+ *
13719
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13720
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13721
+ * copied: the contributor reports what it already knows, hub-main adds only
13722
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13723
+ * somebody to forget to edit.
13724
+ *
13725
+ * They are not merged, because their invariants are opposites:
13726
+ *
13727
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13728
+ * claim a camera cost nothing, which is a measurement nobody made;
13729
+ * - a `failure-contribution` zero is the **most valuable value on the
13730
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13731
+ * and it is exactly what an absent entry cannot say.
13732
+ *
13733
+ * Putting a loss counter on a cost entry would also break the reconciliation
13734
+ * that gives `load-contribution` its point: contributions are subtracted from
13735
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13736
+ * has no process.
13737
+ *
13738
+ * ## Why not a log line, since the counters already exist
13739
+ *
13740
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13741
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13742
+ * ends in a log line, and a log line is the thing the operator asked to stop
13743
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13744
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13745
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13746
+ * media blackout were both diagnosed. The counters stay; this is where they can
13747
+ * be READ.
13748
+ *
13749
+ * ## The rate is served with its denominator or not at all
13750
+ *
13751
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13752
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13753
+ * than yesterday" and was **flat across twelve hours** once divided by the
13754
+ * successes on the same path. A surface that publishes only the numerator
13755
+ * reproduces that mistake on every read.
13756
+ *
13757
+ * ## Shape
13758
+ *
13759
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13760
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13761
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13762
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13763
+ * a forked runner's entries reach hub-main over transport that already exists.
13764
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13765
+ * result through `system.getFailureContributions`.
13766
+ */
13767
+ var FailureReasonCountSchema = object({
13768
+ /**
13769
+ * Why the attempt did not land, in the contributor's own vocabulary —
13770
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13771
+ * strings that already appear in this repo's logs and, where one exists, the
13772
+ * same string the per-track `previewMissReason` records (D276): a second
13773
+ * vocabulary for the same loss would make the row and the counter
13774
+ * un-joinable.
13775
+ */
13776
+ reason: string(),
13777
+ count: number().int().nonnegative()
13778
+ });
13779
+ var FailureContributionSchema = object({
13780
+ /**
13781
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13782
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13783
+ * `unit` free: the families are owned by different addons and a shared enum
13784
+ * is a central list that rots invisibly.
13785
+ */
13786
+ family: string(),
13787
+ /**
13788
+ * The NUMERIC device id — the same value every log line carries as
13789
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13790
+ * cannot name the camera must not emit the entry, because a fleet total
13791
+ * cannot answer the only question anybody asks of this surface.
13792
+ */
13793
+ deviceId: number().int().positive(),
13794
+ /**
13795
+ * A second dimension inside the family: the model / step id for an inference
13796
+ * timeout, so "which camera AND which model" is one read. Absent when the
13797
+ * family has a single variant.
13798
+ */
13799
+ variant: string().optional(),
13800
+ /**
13801
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13802
+ * differencing two reads must drop the interval when it changes, because the
13803
+ * counter restarted from zero in a respawned runner. Same discipline as
13804
+ * `LoadContribution.startedAtMs`.
13805
+ */
13806
+ sinceMs: number(),
13807
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13808
+ atMs: number(),
13809
+ /**
13810
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13811
+ * window. A failure count published without it is the mistake this schema
13812
+ * exists to make impossible.
13813
+ */
13814
+ attempts: number().int().nonnegative(),
13815
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13816
+ succeeded: number().int().nonnegative(),
13817
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13818
+ reasons: array(FailureReasonCountSchema).readonly()
13819
+ });
13820
+ method(_void(), array(FailureContributionSchema).readonly());
13713
13821
  var LoadContributionSchema = object({
13714
13822
  role: _enum([
13715
13823
  "decode",
@@ -14017,6 +14125,50 @@ var NodeProcessSchema = object({
14017
14125
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14018
14126
  uptimeSec: number()
14019
14127
  });
14128
+ /**
14129
+ * One retained container-memory reading.
14130
+ *
14131
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14132
+ * a second clock: that is what makes "processes sum to X, container says Y"
14133
+ * subtractable per point rather than an eyeballed comparison of two series
14134
+ * sampled at different instants.
14135
+ *
14136
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14137
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14138
+ * never coexisted, and a mean would smear away the peak this exists to find.
14139
+ */
14140
+ var ContainerMemoryPointSchema = object({
14141
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14142
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14143
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14144
+ currentBytes: number(),
14145
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14146
+ limitBytes: number().nullable(),
14147
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14148
+ anonBytes: number().nullable(),
14149
+ /** Page cache. Charged to the cgroup, owned by no process. */
14150
+ fileBytes: number().nullable(),
14151
+ /**
14152
+ * Shared memory — and the field that explained the largest single surprise.
14153
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14154
+ * hardware-decode session holding DRM objects is charged HERE and appears
14155
+ * nowhere in a `ps` scan.
14156
+ */
14157
+ shmemBytes: number().nullable(),
14158
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14159
+ slabBytes: number().nullable(),
14160
+ /**
14161
+ * Shrinkable i915 GEM object bytes, from debugfs.
14162
+ *
14163
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14164
+ * component of `currentBytes` and must not be subtracted from it; it says
14165
+ * what put the shmem there, where `shmemBytes` only says how much.
14166
+ *
14167
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14168
+ * container today — and on any node with no Intel GPU.
14169
+ */
14170
+ gpuShmemBytes: number().nullable()
14171
+ }).extend({ atMs: number() });
14020
14172
  var DumpHeapSnapshotInputSchema = object({
14021
14173
  /** The addon whose runner should dump a heap snapshot. */
14022
14174
  addonId: string() });
@@ -14080,6 +14232,21 @@ var NodeLoadSeriesSchema = object({
14080
14232
  /** One entry per function seen in the window, heaviest-first. */
14081
14233
  series: array(LoadFunctionSeriesSchema).readonly(),
14082
14234
  /**
14235
+ * The CONTAINER's memory over the same window, oldest-first.
14236
+ *
14237
+ * Sits next to `series` rather than in a method of its own because the whole
14238
+ * question is a subtraction: the per-process rows in `series` sum to one
14239
+ * number and this one is another, and an operator who has to issue two calls
14240
+ * to compare them will compare two different instants. Same reader, same
14241
+ * `sinceMs`, same `bucketMs`, same timestamps.
14242
+ *
14243
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14244
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14245
+ * points at all. A zero here would be indistinguishable from a healthy
14246
+ * container and is precisely the lie this field exists to avoid.
14247
+ */
14248
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14249
+ /**
14083
14250
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14084
14251
  * reduction was needed — so a caller can always say what one point covers
14085
14252
  * without having to know whether it was reduced.
@@ -18300,6 +18467,20 @@ var TrackSchema = object({
18300
18467
  * `=== true` and render nothing otherwise — never infer "no rider".
18301
18468
  */
18302
18469
  hasRider: boolean().optional(),
18470
+ /**
18471
+ * WHY this track ended without a NATIVE best-shot tile
18472
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18473
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18474
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18475
+ * the late-keyFrame upgrade when a native tile lands after all. The
18476
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18477
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18478
+ *
18479
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18480
+ * that predates the field, and every track whose tile landed native all
18481
+ * omit it. Render nothing when absent.
18482
+ */
18483
+ previewMissReason: string().optional(),
18303
18484
  ...TrackFlagFields,
18304
18485
  ...TrackRetrainFields
18305
18486
  });
@@ -27778,10 +27959,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27778
27959
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27779
27960
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27780
27961
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27781
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27782
- * annotations that are not exposed here and must not be treated as an event
27783
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27784
- * (`interfaces/recording-config.ts`).
27962
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27963
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27964
+ * ever read them. Event<->footage joins are by time, padded with the shared
27965
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27785
27966
  */
27786
27967
  var RecordingStatusSchema = object({
27787
27968
  deviceId: number(),
@@ -29492,6 +29673,13 @@ var LoggingSettingsPatchSchema = object({
29492
29673
  * anyone but its owner.
29493
29674
  */
29494
29675
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29676
+ /**
29677
+ * One per-camera failure counter, plus WHO reported it.
29678
+ *
29679
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29680
+ * the hub as it enumerates providers, never by the contributor.
29681
+ */
29682
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29495
29683
  var GetLoggingSettingsInputSchema = object({
29496
29684
  scopeNodeId: string().optional(),
29497
29685
  /**
@@ -29550,7 +29738,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29550
29738
  }), method(_void(), SiteLocationStatusSchema, {
29551
29739
  kind: "mutation",
29552
29740
  auth: "admin"
29553
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29741
+ }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(_void(), array(ReportedFailureContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29554
29742
  kind: "mutation",
29555
29743
  auth: "admin"
29556
29744
  });
@@ -33540,6 +33728,12 @@ Object.freeze({
33540
33728
  addonId: null,
33541
33729
  access: "create"
33542
33730
  },
33731
+ "failureContribution.list": {
33732
+ capName: "failure-contribution",
33733
+ capScope: "system",
33734
+ addonId: null,
33735
+ access: "view"
33736
+ },
33543
33737
  "fanControl.setDirection": {
33544
33738
  capName: "fan-control",
33545
33739
  capScope: "device",
@@ -36846,6 +37040,12 @@ Object.freeze({
36846
37040
  addonId: null,
36847
37041
  access: "create"
36848
37042
  },
37043
+ "system.getFailureContributions": {
37044
+ capName: "system",
37045
+ capScope: "system",
37046
+ addonId: null,
37047
+ access: "view"
37048
+ },
36849
37049
  "system.getLoadContributions": {
36850
37050
  capName: "system",
36851
37051
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13710,6 +13710,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13710
13710
  limit: number().optional(),
13711
13711
  tags: record(string(), string()).optional()
13712
13712
  }), array(LogEntrySchema).readonly());
13713
+ /**
13714
+ * `failure-contribution` — the capability an addon reports its OWN losses
13715
+ * through, per camera, with the denominator attached. It stores nothing.
13716
+ *
13717
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13718
+ *
13719
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13720
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13721
+ * copied: the contributor reports what it already knows, hub-main adds only
13722
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13723
+ * somebody to forget to edit.
13724
+ *
13725
+ * They are not merged, because their invariants are opposites:
13726
+ *
13727
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13728
+ * claim a camera cost nothing, which is a measurement nobody made;
13729
+ * - a `failure-contribution` zero is the **most valuable value on the
13730
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13731
+ * and it is exactly what an absent entry cannot say.
13732
+ *
13733
+ * Putting a loss counter on a cost entry would also break the reconciliation
13734
+ * that gives `load-contribution` its point: contributions are subtracted from
13735
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13736
+ * has no process.
13737
+ *
13738
+ * ## Why not a log line, since the counters already exist
13739
+ *
13740
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13741
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13742
+ * ends in a log line, and a log line is the thing the operator asked to stop
13743
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13744
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13745
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13746
+ * media blackout were both diagnosed. The counters stay; this is where they can
13747
+ * be READ.
13748
+ *
13749
+ * ## The rate is served with its denominator or not at all
13750
+ *
13751
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13752
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13753
+ * than yesterday" and was **flat across twelve hours** once divided by the
13754
+ * successes on the same path. A surface that publishes only the numerator
13755
+ * reproduces that mistake on every read.
13756
+ *
13757
+ * ## Shape
13758
+ *
13759
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13760
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13761
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13762
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13763
+ * a forked runner's entries reach hub-main over transport that already exists.
13764
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13765
+ * result through `system.getFailureContributions`.
13766
+ */
13767
+ var FailureReasonCountSchema = object({
13768
+ /**
13769
+ * Why the attempt did not land, in the contributor's own vocabulary —
13770
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13771
+ * strings that already appear in this repo's logs and, where one exists, the
13772
+ * same string the per-track `previewMissReason` records (D276): a second
13773
+ * vocabulary for the same loss would make the row and the counter
13774
+ * un-joinable.
13775
+ */
13776
+ reason: string(),
13777
+ count: number().int().nonnegative()
13778
+ });
13779
+ var FailureContributionSchema = object({
13780
+ /**
13781
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13782
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13783
+ * `unit` free: the families are owned by different addons and a shared enum
13784
+ * is a central list that rots invisibly.
13785
+ */
13786
+ family: string(),
13787
+ /**
13788
+ * The NUMERIC device id — the same value every log line carries as
13789
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13790
+ * cannot name the camera must not emit the entry, because a fleet total
13791
+ * cannot answer the only question anybody asks of this surface.
13792
+ */
13793
+ deviceId: number().int().positive(),
13794
+ /**
13795
+ * A second dimension inside the family: the model / step id for an inference
13796
+ * timeout, so "which camera AND which model" is one read. Absent when the
13797
+ * family has a single variant.
13798
+ */
13799
+ variant: string().optional(),
13800
+ /**
13801
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13802
+ * differencing two reads must drop the interval when it changes, because the
13803
+ * counter restarted from zero in a respawned runner. Same discipline as
13804
+ * `LoadContribution.startedAtMs`.
13805
+ */
13806
+ sinceMs: number(),
13807
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13808
+ atMs: number(),
13809
+ /**
13810
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13811
+ * window. A failure count published without it is the mistake this schema
13812
+ * exists to make impossible.
13813
+ */
13814
+ attempts: number().int().nonnegative(),
13815
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13816
+ succeeded: number().int().nonnegative(),
13817
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13818
+ reasons: array(FailureReasonCountSchema).readonly()
13819
+ });
13820
+ method(_void(), array(FailureContributionSchema).readonly());
13713
13821
  var LoadContributionSchema = object({
13714
13822
  role: _enum([
13715
13823
  "decode",
@@ -14017,6 +14125,50 @@ var NodeProcessSchema = object({
14017
14125
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14018
14126
  uptimeSec: number()
14019
14127
  });
14128
+ /**
14129
+ * One retained container-memory reading.
14130
+ *
14131
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14132
+ * a second clock: that is what makes "processes sum to X, container says Y"
14133
+ * subtractable per point rather than an eyeballed comparison of two series
14134
+ * sampled at different instants.
14135
+ *
14136
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14137
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14138
+ * never coexisted, and a mean would smear away the peak this exists to find.
14139
+ */
14140
+ var ContainerMemoryPointSchema = object({
14141
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14142
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14143
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14144
+ currentBytes: number(),
14145
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14146
+ limitBytes: number().nullable(),
14147
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14148
+ anonBytes: number().nullable(),
14149
+ /** Page cache. Charged to the cgroup, owned by no process. */
14150
+ fileBytes: number().nullable(),
14151
+ /**
14152
+ * Shared memory — and the field that explained the largest single surprise.
14153
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14154
+ * hardware-decode session holding DRM objects is charged HERE and appears
14155
+ * nowhere in a `ps` scan.
14156
+ */
14157
+ shmemBytes: number().nullable(),
14158
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14159
+ slabBytes: number().nullable(),
14160
+ /**
14161
+ * Shrinkable i915 GEM object bytes, from debugfs.
14162
+ *
14163
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14164
+ * component of `currentBytes` and must not be subtracted from it; it says
14165
+ * what put the shmem there, where `shmemBytes` only says how much.
14166
+ *
14167
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14168
+ * container today — and on any node with no Intel GPU.
14169
+ */
14170
+ gpuShmemBytes: number().nullable()
14171
+ }).extend({ atMs: number() });
14020
14172
  var DumpHeapSnapshotInputSchema = object({
14021
14173
  /** The addon whose runner should dump a heap snapshot. */
14022
14174
  addonId: string() });
@@ -14080,6 +14232,21 @@ var NodeLoadSeriesSchema = object({
14080
14232
  /** One entry per function seen in the window, heaviest-first. */
14081
14233
  series: array(LoadFunctionSeriesSchema).readonly(),
14082
14234
  /**
14235
+ * The CONTAINER's memory over the same window, oldest-first.
14236
+ *
14237
+ * Sits next to `series` rather than in a method of its own because the whole
14238
+ * question is a subtraction: the per-process rows in `series` sum to one
14239
+ * number and this one is another, and an operator who has to issue two calls
14240
+ * to compare them will compare two different instants. Same reader, same
14241
+ * `sinceMs`, same `bucketMs`, same timestamps.
14242
+ *
14243
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14244
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14245
+ * points at all. A zero here would be indistinguishable from a healthy
14246
+ * container and is precisely the lie this field exists to avoid.
14247
+ */
14248
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14249
+ /**
14083
14250
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14084
14251
  * reduction was needed — so a caller can always say what one point covers
14085
14252
  * without having to know whether it was reduced.
@@ -18300,6 +18467,20 @@ var TrackSchema = object({
18300
18467
  * `=== true` and render nothing otherwise — never infer "no rider".
18301
18468
  */
18302
18469
  hasRider: boolean().optional(),
18470
+ /**
18471
+ * WHY this track ended without a NATIVE best-shot tile
18472
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18473
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18474
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18475
+ * the late-keyFrame upgrade when a native tile lands after all. The
18476
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18477
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18478
+ *
18479
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18480
+ * that predates the field, and every track whose tile landed native all
18481
+ * omit it. Render nothing when absent.
18482
+ */
18483
+ previewMissReason: string().optional(),
18303
18484
  ...TrackFlagFields,
18304
18485
  ...TrackRetrainFields
18305
18486
  });
@@ -27778,10 +27959,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27778
27959
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27779
27960
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27780
27961
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27781
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27782
- * annotations that are not exposed here and must not be treated as an event
27783
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27784
- * (`interfaces/recording-config.ts`).
27962
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27963
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27964
+ * ever read them. Event<->footage joins are by time, padded with the shared
27965
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27785
27966
  */
27786
27967
  var RecordingStatusSchema = object({
27787
27968
  deviceId: number(),
@@ -29492,6 +29673,13 @@ var LoggingSettingsPatchSchema = object({
29492
29673
  * anyone but its owner.
29493
29674
  */
29494
29675
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29676
+ /**
29677
+ * One per-camera failure counter, plus WHO reported it.
29678
+ *
29679
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29680
+ * the hub as it enumerates providers, never by the contributor.
29681
+ */
29682
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29495
29683
  var GetLoggingSettingsInputSchema = object({
29496
29684
  scopeNodeId: string().optional(),
29497
29685
  /**
@@ -29550,7 +29738,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29550
29738
  }), method(_void(), SiteLocationStatusSchema, {
29551
29739
  kind: "mutation",
29552
29740
  auth: "admin"
29553
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29741
+ }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(_void(), array(ReportedFailureContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29554
29742
  kind: "mutation",
29555
29743
  auth: "admin"
29556
29744
  });
@@ -33540,6 +33728,12 @@ Object.freeze({
33540
33728
  addonId: null,
33541
33729
  access: "create"
33542
33730
  },
33731
+ "failureContribution.list": {
33732
+ capName: "failure-contribution",
33733
+ capScope: "system",
33734
+ addonId: null,
33735
+ access: "view"
33736
+ },
33543
33737
  "fanControl.setDirection": {
33544
33738
  capName: "fan-control",
33545
33739
  capScope: "device",
@@ -36846,6 +37040,12 @@ Object.freeze({
36846
37040
  addonId: null,
36847
37041
  access: "create"
36848
37042
  },
37043
+ "system.getFailureContributions": {
37044
+ capName: "system",
37045
+ capScope: "system",
37046
+ addonId: null,
37047
+ access: "view"
37048
+ },
36849
37049
  "system.getLoadContributions": {
36850
37050
  capName: "system",
36851
37051
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-import-alexa",
3
- "version": "0.2.37",
3
+ "version": "0.2.40",
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",