@camstack/addon-export-hap 1.2.49 → 1.2.52

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.
@@ -14004,6 +14004,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
14004
14004
  limit: number().optional(),
14005
14005
  tags: record(string(), string()).optional()
14006
14006
  }), array(LogEntrySchema).readonly());
14007
+ /**
14008
+ * `failure-contribution` — the capability an addon reports its OWN losses
14009
+ * through, per camera, with the denominator attached. It stores nothing.
14010
+ *
14011
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14012
+ *
14013
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14014
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14015
+ * copied: the contributor reports what it already knows, hub-main adds only
14016
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14017
+ * somebody to forget to edit.
14018
+ *
14019
+ * They are not merged, because their invariants are opposites:
14020
+ *
14021
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14022
+ * claim a camera cost nothing, which is a measurement nobody made;
14023
+ * - a `failure-contribution` zero is the **most valuable value on the
14024
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14025
+ * and it is exactly what an absent entry cannot say.
14026
+ *
14027
+ * Putting a loss counter on a cost entry would also break the reconciliation
14028
+ * that gives `load-contribution` its point: contributions are subtracted from
14029
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14030
+ * has no process.
14031
+ *
14032
+ * ## Why not a log line, since the counters already exist
14033
+ *
14034
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14035
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14036
+ * ends in a log line, and a log line is the thing the operator asked to stop
14037
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14038
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14039
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14040
+ * media blackout were both diagnosed. The counters stay; this is where they can
14041
+ * be READ.
14042
+ *
14043
+ * ## The rate is served with its denominator or not at all
14044
+ *
14045
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14046
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14047
+ * than yesterday" and was **flat across twelve hours** once divided by the
14048
+ * successes on the same path. A surface that publishes only the numerator
14049
+ * reproduces that mistake on every read.
14050
+ *
14051
+ * ## Shape
14052
+ *
14053
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14054
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14055
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14056
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14057
+ * a forked runner's entries reach hub-main over transport that already exists.
14058
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14059
+ * result through `system.getFailureContributions`.
14060
+ */
14061
+ var FailureReasonCountSchema = object({
14062
+ /**
14063
+ * Why the attempt did not land, in the contributor's own vocabulary —
14064
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14065
+ * strings that already appear in this repo's logs and, where one exists, the
14066
+ * same string the per-track `previewMissReason` records (D276): a second
14067
+ * vocabulary for the same loss would make the row and the counter
14068
+ * un-joinable.
14069
+ */
14070
+ reason: string(),
14071
+ count: number().int().nonnegative()
14072
+ });
14073
+ var FailureContributionSchema = object({
14074
+ /**
14075
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14076
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14077
+ * `unit` free: the families are owned by different addons and a shared enum
14078
+ * is a central list that rots invisibly.
14079
+ */
14080
+ family: string(),
14081
+ /**
14082
+ * The NUMERIC device id — the same value every log line carries as
14083
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14084
+ * cannot name the camera must not emit the entry, because a fleet total
14085
+ * cannot answer the only question anybody asks of this surface.
14086
+ */
14087
+ deviceId: number().int().positive(),
14088
+ /**
14089
+ * A second dimension inside the family: the model / step id for an inference
14090
+ * timeout, so "which camera AND which model" is one read. Absent when the
14091
+ * family has a single variant.
14092
+ */
14093
+ variant: string().optional(),
14094
+ /**
14095
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14096
+ * differencing two reads must drop the interval when it changes, because the
14097
+ * counter restarted from zero in a respawned runner. Same discipline as
14098
+ * `LoadContribution.startedAtMs`.
14099
+ */
14100
+ sinceMs: number(),
14101
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14102
+ atMs: number(),
14103
+ /**
14104
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14105
+ * window. A failure count published without it is the mistake this schema
14106
+ * exists to make impossible.
14107
+ */
14108
+ attempts: number().int().nonnegative(),
14109
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14110
+ succeeded: number().int().nonnegative(),
14111
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14112
+ reasons: array(FailureReasonCountSchema).readonly()
14113
+ });
14114
+ method(_void(), array(FailureContributionSchema).readonly());
14007
14115
  var LoadContributionSchema = object({
14008
14116
  role: _enum([
14009
14117
  "decode",
@@ -14311,6 +14419,50 @@ var NodeProcessSchema = object({
14311
14419
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14312
14420
  uptimeSec: number()
14313
14421
  });
14422
+ /**
14423
+ * One retained container-memory reading.
14424
+ *
14425
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14426
+ * a second clock: that is what makes "processes sum to X, container says Y"
14427
+ * subtractable per point rather than an eyeballed comparison of two series
14428
+ * sampled at different instants.
14429
+ *
14430
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14431
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14432
+ * never coexisted, and a mean would smear away the peak this exists to find.
14433
+ */
14434
+ var ContainerMemoryPointSchema = object({
14435
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14436
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14437
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14438
+ currentBytes: number(),
14439
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14440
+ limitBytes: number().nullable(),
14441
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14442
+ anonBytes: number().nullable(),
14443
+ /** Page cache. Charged to the cgroup, owned by no process. */
14444
+ fileBytes: number().nullable(),
14445
+ /**
14446
+ * Shared memory — and the field that explained the largest single surprise.
14447
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14448
+ * hardware-decode session holding DRM objects is charged HERE and appears
14449
+ * nowhere in a `ps` scan.
14450
+ */
14451
+ shmemBytes: number().nullable(),
14452
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14453
+ slabBytes: number().nullable(),
14454
+ /**
14455
+ * Shrinkable i915 GEM object bytes, from debugfs.
14456
+ *
14457
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14458
+ * component of `currentBytes` and must not be subtracted from it; it says
14459
+ * what put the shmem there, where `shmemBytes` only says how much.
14460
+ *
14461
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14462
+ * container today — and on any node with no Intel GPU.
14463
+ */
14464
+ gpuShmemBytes: number().nullable()
14465
+ }).extend({ atMs: number() });
14314
14466
  var DumpHeapSnapshotInputSchema = object({
14315
14467
  /** The addon whose runner should dump a heap snapshot. */
14316
14468
  addonId: string() });
@@ -14374,6 +14526,21 @@ var NodeLoadSeriesSchema = object({
14374
14526
  /** One entry per function seen in the window, heaviest-first. */
14375
14527
  series: array(LoadFunctionSeriesSchema).readonly(),
14376
14528
  /**
14529
+ * The CONTAINER's memory over the same window, oldest-first.
14530
+ *
14531
+ * Sits next to `series` rather than in a method of its own because the whole
14532
+ * question is a subtraction: the per-process rows in `series` sum to one
14533
+ * number and this one is another, and an operator who has to issue two calls
14534
+ * to compare them will compare two different instants. Same reader, same
14535
+ * `sinceMs`, same `bucketMs`, same timestamps.
14536
+ *
14537
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14538
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14539
+ * points at all. A zero here would be indistinguishable from a healthy
14540
+ * container and is precisely the lie this field exists to avoid.
14541
+ */
14542
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14543
+ /**
14377
14544
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14378
14545
  * reduction was needed — so a caller can always say what one point covers
14379
14546
  * without having to know whether it was reduced.
@@ -18516,6 +18683,20 @@ var TrackSchema = object({
18516
18683
  * `=== true` and render nothing otherwise — never infer "no rider".
18517
18684
  */
18518
18685
  hasRider: boolean().optional(),
18686
+ /**
18687
+ * WHY this track ended without a NATIVE best-shot tile
18688
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18689
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18690
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18691
+ * the late-keyFrame upgrade when a native tile lands after all. The
18692
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18693
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18694
+ *
18695
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18696
+ * that predates the field, and every track whose tile landed native all
18697
+ * omit it. Render nothing when absent.
18698
+ */
18699
+ previewMissReason: string().optional(),
18519
18700
  ...TrackFlagFields,
18520
18701
  ...TrackRetrainFields
18521
18702
  });
@@ -26337,10 +26518,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
26337
26518
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
26338
26519
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
26339
26520
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
26340
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
26341
- * annotations that are not exposed here and must not be treated as an event
26342
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
26343
- * (`interfaces/recording-config.ts`).
26521
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
26522
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
26523
+ * ever read them. Event<->footage joins are by time, padded with the shared
26524
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
26344
26525
  */
26345
26526
  var RecordingStatusSchema = object({
26346
26527
  deviceId: number(),
@@ -27799,6 +27980,13 @@ var LoggingSettingsPatchSchema = object({
27799
27980
  * anyone but its owner.
27800
27981
  */
27801
27982
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27983
+ /**
27984
+ * One per-camera failure counter, plus WHO reported it.
27985
+ *
27986
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27987
+ * the hub as it enumerates providers, never by the contributor.
27988
+ */
27989
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27802
27990
  var GetLoggingSettingsInputSchema = object({
27803
27991
  scopeNodeId: string().optional(),
27804
27992
  /**
@@ -27857,7 +28045,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27857
28045
  }), method(_void(), SiteLocationStatusSchema, {
27858
28046
  kind: "mutation",
27859
28047
  auth: "admin"
27860
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
28048
+ }), 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, {
27861
28049
  kind: "mutation",
27862
28050
  auth: "admin"
27863
28051
  });
@@ -30455,6 +30643,12 @@ Object.freeze({
30455
30643
  addonId: null,
30456
30644
  access: "create"
30457
30645
  },
30646
+ "failureContribution.list": {
30647
+ capName: "failure-contribution",
30648
+ capScope: "system",
30649
+ addonId: null,
30650
+ access: "view"
30651
+ },
30458
30652
  "fanControl.setDirection": {
30459
30653
  capName: "fan-control",
30460
30654
  capScope: "device",
@@ -33761,6 +33955,12 @@ Object.freeze({
33761
33955
  addonId: null,
33762
33956
  access: "create"
33763
33957
  },
33958
+ "system.getFailureContributions": {
33959
+ capName: "system",
33960
+ capScope: "system",
33961
+ addonId: null,
33962
+ access: "view"
33963
+ },
33764
33964
  "system.getLoadContributions": {
33765
33965
  capName: "system",
33766
33966
  capScope: "system",
@@ -13992,6 +13992,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13992
13992
  limit: number().optional(),
13993
13993
  tags: record(string(), string()).optional()
13994
13994
  }), array(LogEntrySchema).readonly());
13995
+ /**
13996
+ * `failure-contribution` — the capability an addon reports its OWN losses
13997
+ * through, per camera, with the denominator attached. It stores nothing.
13998
+ *
13999
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14000
+ *
14001
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14002
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14003
+ * copied: the contributor reports what it already knows, hub-main adds only
14004
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14005
+ * somebody to forget to edit.
14006
+ *
14007
+ * They are not merged, because their invariants are opposites:
14008
+ *
14009
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14010
+ * claim a camera cost nothing, which is a measurement nobody made;
14011
+ * - a `failure-contribution` zero is the **most valuable value on the
14012
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14013
+ * and it is exactly what an absent entry cannot say.
14014
+ *
14015
+ * Putting a loss counter on a cost entry would also break the reconciliation
14016
+ * that gives `load-contribution` its point: contributions are subtracted from
14017
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14018
+ * has no process.
14019
+ *
14020
+ * ## Why not a log line, since the counters already exist
14021
+ *
14022
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14023
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14024
+ * ends in a log line, and a log line is the thing the operator asked to stop
14025
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14026
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14027
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14028
+ * media blackout were both diagnosed. The counters stay; this is where they can
14029
+ * be READ.
14030
+ *
14031
+ * ## The rate is served with its denominator or not at all
14032
+ *
14033
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14034
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14035
+ * than yesterday" and was **flat across twelve hours** once divided by the
14036
+ * successes on the same path. A surface that publishes only the numerator
14037
+ * reproduces that mistake on every read.
14038
+ *
14039
+ * ## Shape
14040
+ *
14041
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14042
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14043
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14044
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14045
+ * a forked runner's entries reach hub-main over transport that already exists.
14046
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14047
+ * result through `system.getFailureContributions`.
14048
+ */
14049
+ var FailureReasonCountSchema = object({
14050
+ /**
14051
+ * Why the attempt did not land, in the contributor's own vocabulary —
14052
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14053
+ * strings that already appear in this repo's logs and, where one exists, the
14054
+ * same string the per-track `previewMissReason` records (D276): a second
14055
+ * vocabulary for the same loss would make the row and the counter
14056
+ * un-joinable.
14057
+ */
14058
+ reason: string(),
14059
+ count: number().int().nonnegative()
14060
+ });
14061
+ var FailureContributionSchema = object({
14062
+ /**
14063
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14064
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14065
+ * `unit` free: the families are owned by different addons and a shared enum
14066
+ * is a central list that rots invisibly.
14067
+ */
14068
+ family: string(),
14069
+ /**
14070
+ * The NUMERIC device id — the same value every log line carries as
14071
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14072
+ * cannot name the camera must not emit the entry, because a fleet total
14073
+ * cannot answer the only question anybody asks of this surface.
14074
+ */
14075
+ deviceId: number().int().positive(),
14076
+ /**
14077
+ * A second dimension inside the family: the model / step id for an inference
14078
+ * timeout, so "which camera AND which model" is one read. Absent when the
14079
+ * family has a single variant.
14080
+ */
14081
+ variant: string().optional(),
14082
+ /**
14083
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14084
+ * differencing two reads must drop the interval when it changes, because the
14085
+ * counter restarted from zero in a respawned runner. Same discipline as
14086
+ * `LoadContribution.startedAtMs`.
14087
+ */
14088
+ sinceMs: number(),
14089
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14090
+ atMs: number(),
14091
+ /**
14092
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14093
+ * window. A failure count published without it is the mistake this schema
14094
+ * exists to make impossible.
14095
+ */
14096
+ attempts: number().int().nonnegative(),
14097
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14098
+ succeeded: number().int().nonnegative(),
14099
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14100
+ reasons: array(FailureReasonCountSchema).readonly()
14101
+ });
14102
+ method(_void(), array(FailureContributionSchema).readonly());
13995
14103
  var LoadContributionSchema = object({
13996
14104
  role: _enum([
13997
14105
  "decode",
@@ -14299,6 +14407,50 @@ var NodeProcessSchema = object({
14299
14407
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14300
14408
  uptimeSec: number()
14301
14409
  });
14410
+ /**
14411
+ * One retained container-memory reading.
14412
+ *
14413
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
14414
+ * a second clock: that is what makes "processes sum to X, container says Y"
14415
+ * subtractable per point rather than an eyeballed comparison of two series
14416
+ * sampled at different instants.
14417
+ *
14418
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
14419
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
14420
+ * never coexisted, and a mean would smear away the peak this exists to find.
14421
+ */
14422
+ var ContainerMemoryPointSchema = object({
14423
+ /** Which hierarchy answered, so a reading is never ambiguous. */
14424
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
14425
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
14426
+ currentBytes: number(),
14427
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
14428
+ limitBytes: number().nullable(),
14429
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
14430
+ anonBytes: number().nullable(),
14431
+ /** Page cache. Charged to the cgroup, owned by no process. */
14432
+ fileBytes: number().nullable(),
14433
+ /**
14434
+ * Shared memory — and the field that explained the largest single surprise.
14435
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
14436
+ * hardware-decode session holding DRM objects is charged HERE and appears
14437
+ * nowhere in a `ps` scan.
14438
+ */
14439
+ shmemBytes: number().nullable(),
14440
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
14441
+ slabBytes: number().nullable(),
14442
+ /**
14443
+ * Shrinkable i915 GEM object bytes, from debugfs.
14444
+ *
14445
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
14446
+ * component of `currentBytes` and must not be subtracted from it; it says
14447
+ * what put the shmem there, where `shmemBytes` only says how much.
14448
+ *
14449
+ * `null` wherever debugfs is not mounted — which is inside every camstack
14450
+ * container today — and on any node with no Intel GPU.
14451
+ */
14452
+ gpuShmemBytes: number().nullable()
14453
+ }).extend({ atMs: number() });
14302
14454
  var DumpHeapSnapshotInputSchema = object({
14303
14455
  /** The addon whose runner should dump a heap snapshot. */
14304
14456
  addonId: string() });
@@ -14362,6 +14514,21 @@ var NodeLoadSeriesSchema = object({
14362
14514
  /** One entry per function seen in the window, heaviest-first. */
14363
14515
  series: array(LoadFunctionSeriesSchema).readonly(),
14364
14516
  /**
14517
+ * The CONTAINER's memory over the same window, oldest-first.
14518
+ *
14519
+ * Sits next to `series` rather than in a method of its own because the whole
14520
+ * question is a subtraction: the per-process rows in `series` sum to one
14521
+ * number and this one is another, and an operator who has to issue two calls
14522
+ * to compare them will compare two different instants. Same reader, same
14523
+ * `sinceMs`, same `bucketMs`, same timestamps.
14524
+ *
14525
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14526
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14527
+ * points at all. A zero here would be indistinguishable from a healthy
14528
+ * container and is precisely the lie this field exists to avoid.
14529
+ */
14530
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14531
+ /**
14365
14532
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14366
14533
  * reduction was needed — so a caller can always say what one point covers
14367
14534
  * without having to know whether it was reduced.
@@ -18504,6 +18671,20 @@ var TrackSchema = object({
18504
18671
  * `=== true` and render nothing otherwise — never infer "no rider".
18505
18672
  */
18506
18673
  hasRider: boolean().optional(),
18674
+ /**
18675
+ * WHY this track ended without a NATIVE best-shot tile
18676
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18677
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18678
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18679
+ * the late-keyFrame upgrade when a native tile lands after all. The
18680
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18681
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18682
+ *
18683
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18684
+ * that predates the field, and every track whose tile landed native all
18685
+ * omit it. Render nothing when absent.
18686
+ */
18687
+ previewMissReason: string().optional(),
18507
18688
  ...TrackFlagFields,
18508
18689
  ...TrackRetrainFields
18509
18690
  });
@@ -26325,10 +26506,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
26325
26506
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
26326
26507
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
26327
26508
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
26328
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
26329
- * annotations that are not exposed here and must not be treated as an event
26330
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
26331
- * (`interfaces/recording-config.ts`).
26509
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
26510
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
26511
+ * ever read them. Event<->footage joins are by time, padded with the shared
26512
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
26332
26513
  */
26333
26514
  var RecordingStatusSchema = object({
26334
26515
  deviceId: number(),
@@ -27787,6 +27968,13 @@ var LoggingSettingsPatchSchema = object({
27787
27968
  * anyone but its owner.
27788
27969
  */
27789
27970
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27971
+ /**
27972
+ * One per-camera failure counter, plus WHO reported it.
27973
+ *
27974
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27975
+ * the hub as it enumerates providers, never by the contributor.
27976
+ */
27977
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27790
27978
  var GetLoggingSettingsInputSchema = object({
27791
27979
  scopeNodeId: string().optional(),
27792
27980
  /**
@@ -27845,7 +28033,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27845
28033
  }), method(_void(), SiteLocationStatusSchema, {
27846
28034
  kind: "mutation",
27847
28035
  auth: "admin"
27848
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
28036
+ }), 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, {
27849
28037
  kind: "mutation",
27850
28038
  auth: "admin"
27851
28039
  });
@@ -30443,6 +30631,12 @@ Object.freeze({
30443
30631
  addonId: null,
30444
30632
  access: "create"
30445
30633
  },
30634
+ "failureContribution.list": {
30635
+ capName: "failure-contribution",
30636
+ capScope: "system",
30637
+ addonId: null,
30638
+ access: "view"
30639
+ },
30446
30640
  "fanControl.setDirection": {
30447
30641
  capName: "fan-control",
30448
30642
  capScope: "device",
@@ -33749,6 +33943,12 @@ Object.freeze({
33749
33943
  addonId: null,
33750
33944
  access: "create"
33751
33945
  },
33946
+ "system.getFailureContributions": {
33947
+ capName: "system",
33948
+ capScope: "system",
33949
+ addonId: null,
33950
+ access: "view"
33951
+ },
33752
33952
  "system.getLoadContributions": {
33753
33953
  capName: "system",
33754
33954
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-hap",
3
- "version": "1.2.49",
3
+ "version": "1.2.52",
4
4
  "description": "HomeKit (HAP) exporter for CamStack devices. Publishes each exposed device as its own HomeKit accessory: cameras and doorbells with SRTP streaming, HomeKit Secure Video, motion, two-way audio, PTZ and battery; switches, lights, locks and sensors through a capability→service table.",
5
5
  "keywords": [
6
6
  "camstack",