@camstack/addon-export-alexa 1.2.44 → 1.2.47

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.
@@ -13498,6 +13498,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13498
13498
  limit: number().optional(),
13499
13499
  tags: record(string(), string()).optional()
13500
13500
  }), array(LogEntrySchema).readonly());
13501
+ /**
13502
+ * `failure-contribution` — the capability an addon reports its OWN losses
13503
+ * through, per camera, with the denominator attached. It stores nothing.
13504
+ *
13505
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13506
+ *
13507
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13508
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13509
+ * copied: the contributor reports what it already knows, hub-main adds only
13510
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13511
+ * somebody to forget to edit.
13512
+ *
13513
+ * They are not merged, because their invariants are opposites:
13514
+ *
13515
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13516
+ * claim a camera cost nothing, which is a measurement nobody made;
13517
+ * - a `failure-contribution` zero is the **most valuable value on the
13518
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13519
+ * and it is exactly what an absent entry cannot say.
13520
+ *
13521
+ * Putting a loss counter on a cost entry would also break the reconciliation
13522
+ * that gives `load-contribution` its point: contributions are subtracted from
13523
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13524
+ * has no process.
13525
+ *
13526
+ * ## Why not a log line, since the counters already exist
13527
+ *
13528
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13529
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13530
+ * ends in a log line, and a log line is the thing the operator asked to stop
13531
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13532
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13533
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13534
+ * media blackout were both diagnosed. The counters stay; this is where they can
13535
+ * be READ.
13536
+ *
13537
+ * ## The rate is served with its denominator or not at all
13538
+ *
13539
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13540
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13541
+ * than yesterday" and was **flat across twelve hours** once divided by the
13542
+ * successes on the same path. A surface that publishes only the numerator
13543
+ * reproduces that mistake on every read.
13544
+ *
13545
+ * ## Shape
13546
+ *
13547
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13548
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13549
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13550
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13551
+ * a forked runner's entries reach hub-main over transport that already exists.
13552
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13553
+ * result through `system.getFailureContributions`.
13554
+ */
13555
+ var FailureReasonCountSchema = object({
13556
+ /**
13557
+ * Why the attempt did not land, in the contributor's own vocabulary —
13558
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13559
+ * strings that already appear in this repo's logs and, where one exists, the
13560
+ * same string the per-track `previewMissReason` records (D276): a second
13561
+ * vocabulary for the same loss would make the row and the counter
13562
+ * un-joinable.
13563
+ */
13564
+ reason: string(),
13565
+ count: number().int().nonnegative()
13566
+ });
13567
+ var FailureContributionSchema = object({
13568
+ /**
13569
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13570
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13571
+ * `unit` free: the families are owned by different addons and a shared enum
13572
+ * is a central list that rots invisibly.
13573
+ */
13574
+ family: string(),
13575
+ /**
13576
+ * The NUMERIC device id — the same value every log line carries as
13577
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13578
+ * cannot name the camera must not emit the entry, because a fleet total
13579
+ * cannot answer the only question anybody asks of this surface.
13580
+ */
13581
+ deviceId: number().int().positive(),
13582
+ /**
13583
+ * A second dimension inside the family: the model / step id for an inference
13584
+ * timeout, so "which camera AND which model" is one read. Absent when the
13585
+ * family has a single variant.
13586
+ */
13587
+ variant: string().optional(),
13588
+ /**
13589
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13590
+ * differencing two reads must drop the interval when it changes, because the
13591
+ * counter restarted from zero in a respawned runner. Same discipline as
13592
+ * `LoadContribution.startedAtMs`.
13593
+ */
13594
+ sinceMs: number(),
13595
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13596
+ atMs: number(),
13597
+ /**
13598
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13599
+ * window. A failure count published without it is the mistake this schema
13600
+ * exists to make impossible.
13601
+ */
13602
+ attempts: number().int().nonnegative(),
13603
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13604
+ succeeded: number().int().nonnegative(),
13605
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13606
+ reasons: array(FailureReasonCountSchema).readonly()
13607
+ });
13608
+ method(_void(), array(FailureContributionSchema).readonly());
13501
13609
  var LoadContributionSchema = object({
13502
13610
  role: _enum([
13503
13611
  "decode",
@@ -13805,6 +13913,50 @@ var NodeProcessSchema = object({
13805
13913
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13806
13914
  uptimeSec: number()
13807
13915
  });
13916
+ /**
13917
+ * One retained container-memory reading.
13918
+ *
13919
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13920
+ * a second clock: that is what makes "processes sum to X, container says Y"
13921
+ * subtractable per point rather than an eyeballed comparison of two series
13922
+ * sampled at different instants.
13923
+ *
13924
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13925
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13926
+ * never coexisted, and a mean would smear away the peak this exists to find.
13927
+ */
13928
+ var ContainerMemoryPointSchema = object({
13929
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13930
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13931
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13932
+ currentBytes: number(),
13933
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13934
+ limitBytes: number().nullable(),
13935
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13936
+ anonBytes: number().nullable(),
13937
+ /** Page cache. Charged to the cgroup, owned by no process. */
13938
+ fileBytes: number().nullable(),
13939
+ /**
13940
+ * Shared memory — and the field that explained the largest single surprise.
13941
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13942
+ * hardware-decode session holding DRM objects is charged HERE and appears
13943
+ * nowhere in a `ps` scan.
13944
+ */
13945
+ shmemBytes: number().nullable(),
13946
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13947
+ slabBytes: number().nullable(),
13948
+ /**
13949
+ * Shrinkable i915 GEM object bytes, from debugfs.
13950
+ *
13951
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13952
+ * component of `currentBytes` and must not be subtracted from it; it says
13953
+ * what put the shmem there, where `shmemBytes` only says how much.
13954
+ *
13955
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13956
+ * container today — and on any node with no Intel GPU.
13957
+ */
13958
+ gpuShmemBytes: number().nullable()
13959
+ }).extend({ atMs: number() });
13808
13960
  var DumpHeapSnapshotInputSchema = object({
13809
13961
  /** The addon whose runner should dump a heap snapshot. */
13810
13962
  addonId: string() });
@@ -13868,6 +14020,21 @@ var NodeLoadSeriesSchema = object({
13868
14020
  /** One entry per function seen in the window, heaviest-first. */
13869
14021
  series: array(LoadFunctionSeriesSchema).readonly(),
13870
14022
  /**
14023
+ * The CONTAINER's memory over the same window, oldest-first.
14024
+ *
14025
+ * Sits next to `series` rather than in a method of its own because the whole
14026
+ * question is a subtraction: the per-process rows in `series` sum to one
14027
+ * number and this one is another, and an operator who has to issue two calls
14028
+ * to compare them will compare two different instants. Same reader, same
14029
+ * `sinceMs`, same `bucketMs`, same timestamps.
14030
+ *
14031
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14032
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14033
+ * points at all. A zero here would be indistinguishable from a healthy
14034
+ * container and is precisely the lie this field exists to avoid.
14035
+ */
14036
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14037
+ /**
13871
14038
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13872
14039
  * reduction was needed — so a caller can always say what one point covers
13873
14040
  * without having to know whether it was reduced.
@@ -18026,6 +18193,20 @@ var TrackSchema = object({
18026
18193
  * `=== true` and render nothing otherwise — never infer "no rider".
18027
18194
  */
18028
18195
  hasRider: boolean().optional(),
18196
+ /**
18197
+ * WHY this track ended without a NATIVE best-shot tile
18198
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18199
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18200
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18201
+ * the late-keyFrame upgrade when a native tile lands after all. The
18202
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18203
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18204
+ *
18205
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18206
+ * that predates the field, and every track whose tile landed native all
18207
+ * omit it. Render nothing when absent.
18208
+ */
18209
+ previewMissReason: string().optional(),
18029
18210
  ...TrackFlagFields,
18030
18211
  ...TrackRetrainFields
18031
18212
  });
@@ -25799,10 +25980,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25799
25980
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25800
25981
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25801
25982
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25802
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25803
- * annotations that are not exposed here and must not be treated as an event
25804
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25805
- * (`interfaces/recording-config.ts`).
25983
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
25984
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25985
+ * ever read them. Event<->footage joins are by time, padded with the shared
25986
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25806
25987
  */
25807
25988
  var RecordingStatusSchema = object({
25808
25989
  deviceId: number(),
@@ -27252,6 +27433,13 @@ var LoggingSettingsPatchSchema = object({
27252
27433
  * anyone but its owner.
27253
27434
  */
27254
27435
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27436
+ /**
27437
+ * One per-camera failure counter, plus WHO reported it.
27438
+ *
27439
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27440
+ * the hub as it enumerates providers, never by the contributor.
27441
+ */
27442
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27255
27443
  var GetLoggingSettingsInputSchema = object({
27256
27444
  scopeNodeId: string().optional(),
27257
27445
  /**
@@ -27310,7 +27498,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27310
27498
  }), method(_void(), SiteLocationStatusSchema, {
27311
27499
  kind: "mutation",
27312
27500
  auth: "admin"
27313
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27501
+ }), 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, {
27314
27502
  kind: "mutation",
27315
27503
  auth: "admin"
27316
27504
  });
@@ -29892,6 +30080,12 @@ Object.freeze({
29892
30080
  addonId: null,
29893
30081
  access: "create"
29894
30082
  },
30083
+ "failureContribution.list": {
30084
+ capName: "failure-contribution",
30085
+ capScope: "system",
30086
+ addonId: null,
30087
+ access: "view"
30088
+ },
29895
30089
  "fanControl.setDirection": {
29896
30090
  capName: "fan-control",
29897
30091
  capScope: "device",
@@ -33198,6 +33392,12 @@ Object.freeze({
33198
33392
  addonId: null,
33199
33393
  access: "create"
33200
33394
  },
33395
+ "system.getFailureContributions": {
33396
+ capName: "system",
33397
+ capScope: "system",
33398
+ addonId: null,
33399
+ access: "view"
33400
+ },
33201
33401
  "system.getLoadContributions": {
33202
33402
  capName: "system",
33203
33403
  capScope: "system",
@@ -13471,6 +13471,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13471
13471
  limit: number().optional(),
13472
13472
  tags: record(string(), string()).optional()
13473
13473
  }), array(LogEntrySchema).readonly());
13474
+ /**
13475
+ * `failure-contribution` — the capability an addon reports its OWN losses
13476
+ * through, per camera, with the denominator attached. It stores nothing.
13477
+ *
13478
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13479
+ *
13480
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13481
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13482
+ * copied: the contributor reports what it already knows, hub-main adds only
13483
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13484
+ * somebody to forget to edit.
13485
+ *
13486
+ * They are not merged, because their invariants are opposites:
13487
+ *
13488
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13489
+ * claim a camera cost nothing, which is a measurement nobody made;
13490
+ * - a `failure-contribution` zero is the **most valuable value on the
13491
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13492
+ * and it is exactly what an absent entry cannot say.
13493
+ *
13494
+ * Putting a loss counter on a cost entry would also break the reconciliation
13495
+ * that gives `load-contribution` its point: contributions are subtracted from
13496
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13497
+ * has no process.
13498
+ *
13499
+ * ## Why not a log line, since the counters already exist
13500
+ *
13501
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13502
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13503
+ * ends in a log line, and a log line is the thing the operator asked to stop
13504
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13505
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13506
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13507
+ * media blackout were both diagnosed. The counters stay; this is where they can
13508
+ * be READ.
13509
+ *
13510
+ * ## The rate is served with its denominator or not at all
13511
+ *
13512
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13513
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13514
+ * than yesterday" and was **flat across twelve hours** once divided by the
13515
+ * successes on the same path. A surface that publishes only the numerator
13516
+ * reproduces that mistake on every read.
13517
+ *
13518
+ * ## Shape
13519
+ *
13520
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13521
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13522
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13523
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13524
+ * a forked runner's entries reach hub-main over transport that already exists.
13525
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13526
+ * result through `system.getFailureContributions`.
13527
+ */
13528
+ var FailureReasonCountSchema = object({
13529
+ /**
13530
+ * Why the attempt did not land, in the contributor's own vocabulary —
13531
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13532
+ * strings that already appear in this repo's logs and, where one exists, the
13533
+ * same string the per-track `previewMissReason` records (D276): a second
13534
+ * vocabulary for the same loss would make the row and the counter
13535
+ * un-joinable.
13536
+ */
13537
+ reason: string(),
13538
+ count: number().int().nonnegative()
13539
+ });
13540
+ var FailureContributionSchema = object({
13541
+ /**
13542
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13543
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13544
+ * `unit` free: the families are owned by different addons and a shared enum
13545
+ * is a central list that rots invisibly.
13546
+ */
13547
+ family: string(),
13548
+ /**
13549
+ * The NUMERIC device id — the same value every log line carries as
13550
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13551
+ * cannot name the camera must not emit the entry, because a fleet total
13552
+ * cannot answer the only question anybody asks of this surface.
13553
+ */
13554
+ deviceId: number().int().positive(),
13555
+ /**
13556
+ * A second dimension inside the family: the model / step id for an inference
13557
+ * timeout, so "which camera AND which model" is one read. Absent when the
13558
+ * family has a single variant.
13559
+ */
13560
+ variant: string().optional(),
13561
+ /**
13562
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13563
+ * differencing two reads must drop the interval when it changes, because the
13564
+ * counter restarted from zero in a respawned runner. Same discipline as
13565
+ * `LoadContribution.startedAtMs`.
13566
+ */
13567
+ sinceMs: number(),
13568
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13569
+ atMs: number(),
13570
+ /**
13571
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13572
+ * window. A failure count published without it is the mistake this schema
13573
+ * exists to make impossible.
13574
+ */
13575
+ attempts: number().int().nonnegative(),
13576
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13577
+ succeeded: number().int().nonnegative(),
13578
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13579
+ reasons: array(FailureReasonCountSchema).readonly()
13580
+ });
13581
+ method(_void(), array(FailureContributionSchema).readonly());
13474
13582
  var LoadContributionSchema = object({
13475
13583
  role: _enum([
13476
13584
  "decode",
@@ -13778,6 +13886,50 @@ var NodeProcessSchema = object({
13778
13886
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13779
13887
  uptimeSec: number()
13780
13888
  });
13889
+ /**
13890
+ * One retained container-memory reading.
13891
+ *
13892
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13893
+ * a second clock: that is what makes "processes sum to X, container says Y"
13894
+ * subtractable per point rather than an eyeballed comparison of two series
13895
+ * sampled at different instants.
13896
+ *
13897
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13898
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13899
+ * never coexisted, and a mean would smear away the peak this exists to find.
13900
+ */
13901
+ var ContainerMemoryPointSchema = object({
13902
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13903
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13904
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13905
+ currentBytes: number(),
13906
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13907
+ limitBytes: number().nullable(),
13908
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13909
+ anonBytes: number().nullable(),
13910
+ /** Page cache. Charged to the cgroup, owned by no process. */
13911
+ fileBytes: number().nullable(),
13912
+ /**
13913
+ * Shared memory — and the field that explained the largest single surprise.
13914
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13915
+ * hardware-decode session holding DRM objects is charged HERE and appears
13916
+ * nowhere in a `ps` scan.
13917
+ */
13918
+ shmemBytes: number().nullable(),
13919
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13920
+ slabBytes: number().nullable(),
13921
+ /**
13922
+ * Shrinkable i915 GEM object bytes, from debugfs.
13923
+ *
13924
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13925
+ * component of `currentBytes` and must not be subtracted from it; it says
13926
+ * what put the shmem there, where `shmemBytes` only says how much.
13927
+ *
13928
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13929
+ * container today — and on any node with no Intel GPU.
13930
+ */
13931
+ gpuShmemBytes: number().nullable()
13932
+ }).extend({ atMs: number() });
13781
13933
  var DumpHeapSnapshotInputSchema = object({
13782
13934
  /** The addon whose runner should dump a heap snapshot. */
13783
13935
  addonId: string() });
@@ -13841,6 +13993,21 @@ var NodeLoadSeriesSchema = object({
13841
13993
  /** One entry per function seen in the window, heaviest-first. */
13842
13994
  series: array(LoadFunctionSeriesSchema).readonly(),
13843
13995
  /**
13996
+ * The CONTAINER's memory over the same window, oldest-first.
13997
+ *
13998
+ * Sits next to `series` rather than in a method of its own because the whole
13999
+ * question is a subtraction: the per-process rows in `series` sum to one
14000
+ * number and this one is another, and an operator who has to issue two calls
14001
+ * to compare them will compare two different instants. Same reader, same
14002
+ * `sinceMs`, same `bucketMs`, same timestamps.
14003
+ *
14004
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14005
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14006
+ * points at all. A zero here would be indistinguishable from a healthy
14007
+ * container and is precisely the lie this field exists to avoid.
14008
+ */
14009
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14010
+ /**
13844
14011
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13845
14012
  * reduction was needed — so a caller can always say what one point covers
13846
14013
  * without having to know whether it was reduced.
@@ -17999,6 +18166,20 @@ var TrackSchema = object({
17999
18166
  * `=== true` and render nothing otherwise — never infer "no rider".
18000
18167
  */
18001
18168
  hasRider: boolean().optional(),
18169
+ /**
18170
+ * WHY this track ended without a NATIVE best-shot tile
18171
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18172
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18173
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18174
+ * the late-keyFrame upgrade when a native tile lands after all. The
18175
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18176
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18177
+ *
18178
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18179
+ * that predates the field, and every track whose tile landed native all
18180
+ * omit it. Render nothing when absent.
18181
+ */
18182
+ previewMissReason: string().optional(),
18002
18183
  ...TrackFlagFields,
18003
18184
  ...TrackRetrainFields
18004
18185
  });
@@ -25772,10 +25953,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25772
25953
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25773
25954
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25774
25955
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25775
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25776
- * annotations that are not exposed here and must not be treated as an event
25777
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25778
- * (`interfaces/recording-config.ts`).
25956
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
25957
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25958
+ * ever read them. Event<->footage joins are by time, padded with the shared
25959
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25779
25960
  */
25780
25961
  var RecordingStatusSchema = object({
25781
25962
  deviceId: number(),
@@ -27225,6 +27406,13 @@ var LoggingSettingsPatchSchema = object({
27225
27406
  * anyone but its owner.
27226
27407
  */
27227
27408
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27409
+ /**
27410
+ * One per-camera failure counter, plus WHO reported it.
27411
+ *
27412
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27413
+ * the hub as it enumerates providers, never by the contributor.
27414
+ */
27415
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27228
27416
  var GetLoggingSettingsInputSchema = object({
27229
27417
  scopeNodeId: string().optional(),
27230
27418
  /**
@@ -27283,7 +27471,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27283
27471
  }), method(_void(), SiteLocationStatusSchema, {
27284
27472
  kind: "mutation",
27285
27473
  auth: "admin"
27286
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27474
+ }), 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, {
27287
27475
  kind: "mutation",
27288
27476
  auth: "admin"
27289
27477
  });
@@ -29865,6 +30053,12 @@ Object.freeze({
29865
30053
  addonId: null,
29866
30054
  access: "create"
29867
30055
  },
30056
+ "failureContribution.list": {
30057
+ capName: "failure-contribution",
30058
+ capScope: "system",
30059
+ addonId: null,
30060
+ access: "view"
30061
+ },
29868
30062
  "fanControl.setDirection": {
29869
30063
  capName: "fan-control",
29870
30064
  capScope: "device",
@@ -33171,6 +33365,12 @@ Object.freeze({
33171
33365
  addonId: null,
33172
33366
  access: "create"
33173
33367
  },
33368
+ "system.getFailureContributions": {
33369
+ capName: "system",
33370
+ capScope: "system",
33371
+ addonId: null,
33372
+ access: "view"
33373
+ },
33174
33374
  "system.getLoadContributions": {
33175
33375
  capName: "system",
33176
33376
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-alexa",
3
- "version": "1.2.44",
3
+ "version": "1.2.47",
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",