@camstack/addon-provider-gree 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
@@ -13470,6 +13470,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13470
13470
  limit: number().optional(),
13471
13471
  tags: record(string(), string()).optional()
13472
13472
  }), array(LogEntrySchema).readonly());
13473
+ /**
13474
+ * `failure-contribution` — the capability an addon reports its OWN losses
13475
+ * through, per camera, with the denominator attached. It stores nothing.
13476
+ *
13477
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13478
+ *
13479
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13480
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13481
+ * copied: the contributor reports what it already knows, hub-main adds only
13482
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13483
+ * somebody to forget to edit.
13484
+ *
13485
+ * They are not merged, because their invariants are opposites:
13486
+ *
13487
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13488
+ * claim a camera cost nothing, which is a measurement nobody made;
13489
+ * - a `failure-contribution` zero is the **most valuable value on the
13490
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13491
+ * and it is exactly what an absent entry cannot say.
13492
+ *
13493
+ * Putting a loss counter on a cost entry would also break the reconciliation
13494
+ * that gives `load-contribution` its point: contributions are subtracted from
13495
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13496
+ * has no process.
13497
+ *
13498
+ * ## Why not a log line, since the counters already exist
13499
+ *
13500
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13501
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13502
+ * ends in a log line, and a log line is the thing the operator asked to stop
13503
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13504
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13505
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13506
+ * media blackout were both diagnosed. The counters stay; this is where they can
13507
+ * be READ.
13508
+ *
13509
+ * ## The rate is served with its denominator or not at all
13510
+ *
13511
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13512
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13513
+ * than yesterday" and was **flat across twelve hours** once divided by the
13514
+ * successes on the same path. A surface that publishes only the numerator
13515
+ * reproduces that mistake on every read.
13516
+ *
13517
+ * ## Shape
13518
+ *
13519
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13520
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13521
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13522
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13523
+ * a forked runner's entries reach hub-main over transport that already exists.
13524
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13525
+ * result through `system.getFailureContributions`.
13526
+ */
13527
+ var FailureReasonCountSchema = object({
13528
+ /**
13529
+ * Why the attempt did not land, in the contributor's own vocabulary —
13530
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13531
+ * strings that already appear in this repo's logs and, where one exists, the
13532
+ * same string the per-track `previewMissReason` records (D276): a second
13533
+ * vocabulary for the same loss would make the row and the counter
13534
+ * un-joinable.
13535
+ */
13536
+ reason: string(),
13537
+ count: number().int().nonnegative()
13538
+ });
13539
+ var FailureContributionSchema = object({
13540
+ /**
13541
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13542
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13543
+ * `unit` free: the families are owned by different addons and a shared enum
13544
+ * is a central list that rots invisibly.
13545
+ */
13546
+ family: string(),
13547
+ /**
13548
+ * The NUMERIC device id — the same value every log line carries as
13549
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13550
+ * cannot name the camera must not emit the entry, because a fleet total
13551
+ * cannot answer the only question anybody asks of this surface.
13552
+ */
13553
+ deviceId: number().int().positive(),
13554
+ /**
13555
+ * A second dimension inside the family: the model / step id for an inference
13556
+ * timeout, so "which camera AND which model" is one read. Absent when the
13557
+ * family has a single variant.
13558
+ */
13559
+ variant: string().optional(),
13560
+ /**
13561
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13562
+ * differencing two reads must drop the interval when it changes, because the
13563
+ * counter restarted from zero in a respawned runner. Same discipline as
13564
+ * `LoadContribution.startedAtMs`.
13565
+ */
13566
+ sinceMs: number(),
13567
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13568
+ atMs: number(),
13569
+ /**
13570
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13571
+ * window. A failure count published without it is the mistake this schema
13572
+ * exists to make impossible.
13573
+ */
13574
+ attempts: number().int().nonnegative(),
13575
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13576
+ succeeded: number().int().nonnegative(),
13577
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13578
+ reasons: array(FailureReasonCountSchema).readonly()
13579
+ });
13580
+ method(_void(), array(FailureContributionSchema).readonly());
13473
13581
  var LoadContributionSchema = object({
13474
13582
  role: _enum([
13475
13583
  "decode",
@@ -13777,6 +13885,50 @@ var NodeProcessSchema = object({
13777
13885
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13778
13886
  uptimeSec: number()
13779
13887
  });
13888
+ /**
13889
+ * One retained container-memory reading.
13890
+ *
13891
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13892
+ * a second clock: that is what makes "processes sum to X, container says Y"
13893
+ * subtractable per point rather than an eyeballed comparison of two series
13894
+ * sampled at different instants.
13895
+ *
13896
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13897
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13898
+ * never coexisted, and a mean would smear away the peak this exists to find.
13899
+ */
13900
+ var ContainerMemoryPointSchema = object({
13901
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13902
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13903
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13904
+ currentBytes: number(),
13905
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13906
+ limitBytes: number().nullable(),
13907
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13908
+ anonBytes: number().nullable(),
13909
+ /** Page cache. Charged to the cgroup, owned by no process. */
13910
+ fileBytes: number().nullable(),
13911
+ /**
13912
+ * Shared memory — and the field that explained the largest single surprise.
13913
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13914
+ * hardware-decode session holding DRM objects is charged HERE and appears
13915
+ * nowhere in a `ps` scan.
13916
+ */
13917
+ shmemBytes: number().nullable(),
13918
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13919
+ slabBytes: number().nullable(),
13920
+ /**
13921
+ * Shrinkable i915 GEM object bytes, from debugfs.
13922
+ *
13923
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13924
+ * component of `currentBytes` and must not be subtracted from it; it says
13925
+ * what put the shmem there, where `shmemBytes` only says how much.
13926
+ *
13927
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13928
+ * container today — and on any node with no Intel GPU.
13929
+ */
13930
+ gpuShmemBytes: number().nullable()
13931
+ }).extend({ atMs: number() });
13780
13932
  var DumpHeapSnapshotInputSchema = object({
13781
13933
  /** The addon whose runner should dump a heap snapshot. */
13782
13934
  addonId: string() });
@@ -13840,6 +13992,21 @@ var NodeLoadSeriesSchema = object({
13840
13992
  /** One entry per function seen in the window, heaviest-first. */
13841
13993
  series: array(LoadFunctionSeriesSchema).readonly(),
13842
13994
  /**
13995
+ * The CONTAINER's memory over the same window, oldest-first.
13996
+ *
13997
+ * Sits next to `series` rather than in a method of its own because the whole
13998
+ * question is a subtraction: the per-process rows in `series` sum to one
13999
+ * number and this one is another, and an operator who has to issue two calls
14000
+ * to compare them will compare two different instants. Same reader, same
14001
+ * `sinceMs`, same `bucketMs`, same timestamps.
14002
+ *
14003
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14004
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14005
+ * points at all. A zero here would be indistinguishable from a healthy
14006
+ * container and is precisely the lie this field exists to avoid.
14007
+ */
14008
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14009
+ /**
13843
14010
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13844
14011
  * reduction was needed — so a caller can always say what one point covers
13845
14012
  * without having to know whether it was reduced.
@@ -18060,6 +18227,20 @@ var TrackSchema = object({
18060
18227
  * `=== true` and render nothing otherwise — never infer "no rider".
18061
18228
  */
18062
18229
  hasRider: boolean().optional(),
18230
+ /**
18231
+ * WHY this track ended without a NATIVE best-shot tile
18232
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18233
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18234
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18235
+ * the late-keyFrame upgrade when a native tile lands after all. The
18236
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18237
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18238
+ *
18239
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18240
+ * that predates the field, and every track whose tile landed native all
18241
+ * omit it. Render nothing when absent.
18242
+ */
18243
+ previewMissReason: string().optional(),
18063
18244
  ...TrackFlagFields,
18064
18245
  ...TrackRetrainFields
18065
18246
  });
@@ -27521,10 +27702,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27521
27702
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27522
27703
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27523
27704
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27524
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27525
- * annotations that are not exposed here and must not be treated as an event
27526
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27527
- * (`interfaces/recording-config.ts`).
27705
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27706
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27707
+ * ever read them. Event<->footage joins are by time, padded with the shared
27708
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27528
27709
  */
27529
27710
  var RecordingStatusSchema = object({
27530
27711
  deviceId: number(),
@@ -29235,6 +29416,13 @@ var LoggingSettingsPatchSchema = object({
29235
29416
  * anyone but its owner.
29236
29417
  */
29237
29418
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29419
+ /**
29420
+ * One per-camera failure counter, plus WHO reported it.
29421
+ *
29422
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29423
+ * the hub as it enumerates providers, never by the contributor.
29424
+ */
29425
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29238
29426
  var GetLoggingSettingsInputSchema = object({
29239
29427
  scopeNodeId: string().optional(),
29240
29428
  /**
@@ -29293,7 +29481,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29293
29481
  }), method(_void(), SiteLocationStatusSchema, {
29294
29482
  kind: "mutation",
29295
29483
  auth: "admin"
29296
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29484
+ }), 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, {
29297
29485
  kind: "mutation",
29298
29486
  auth: "admin"
29299
29487
  });
@@ -33283,6 +33471,12 @@ Object.freeze({
33283
33471
  addonId: null,
33284
33472
  access: "create"
33285
33473
  },
33474
+ "failureContribution.list": {
33475
+ capName: "failure-contribution",
33476
+ capScope: "system",
33477
+ addonId: null,
33478
+ access: "view"
33479
+ },
33286
33480
  "fanControl.setDirection": {
33287
33481
  capName: "fan-control",
33288
33482
  capScope: "device",
@@ -36589,6 +36783,12 @@ Object.freeze({
36589
36783
  addonId: null,
36590
36784
  access: "create"
36591
36785
  },
36786
+ "system.getFailureContributions": {
36787
+ capName: "system",
36788
+ capScope: "system",
36789
+ addonId: null,
36790
+ access: "view"
36791
+ },
36592
36792
  "system.getLoadContributions": {
36593
36793
  capName: "system",
36594
36794
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13469,6 +13469,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13469
13469
  limit: number().optional(),
13470
13470
  tags: record(string(), string()).optional()
13471
13471
  }), array(LogEntrySchema).readonly());
13472
+ /**
13473
+ * `failure-contribution` — the capability an addon reports its OWN losses
13474
+ * through, per camera, with the denominator attached. It stores nothing.
13475
+ *
13476
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13477
+ *
13478
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13479
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13480
+ * copied: the contributor reports what it already knows, hub-main adds only
13481
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13482
+ * somebody to forget to edit.
13483
+ *
13484
+ * They are not merged, because their invariants are opposites:
13485
+ *
13486
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13487
+ * claim a camera cost nothing, which is a measurement nobody made;
13488
+ * - a `failure-contribution` zero is the **most valuable value on the
13489
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13490
+ * and it is exactly what an absent entry cannot say.
13491
+ *
13492
+ * Putting a loss counter on a cost entry would also break the reconciliation
13493
+ * that gives `load-contribution` its point: contributions are subtracted from
13494
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13495
+ * has no process.
13496
+ *
13497
+ * ## Why not a log line, since the counters already exist
13498
+ *
13499
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13500
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13501
+ * ends in a log line, and a log line is the thing the operator asked to stop
13502
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13503
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13504
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13505
+ * media blackout were both diagnosed. The counters stay; this is where they can
13506
+ * be READ.
13507
+ *
13508
+ * ## The rate is served with its denominator or not at all
13509
+ *
13510
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13511
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13512
+ * than yesterday" and was **flat across twelve hours** once divided by the
13513
+ * successes on the same path. A surface that publishes only the numerator
13514
+ * reproduces that mistake on every read.
13515
+ *
13516
+ * ## Shape
13517
+ *
13518
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13519
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13520
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13521
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13522
+ * a forked runner's entries reach hub-main over transport that already exists.
13523
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13524
+ * result through `system.getFailureContributions`.
13525
+ */
13526
+ var FailureReasonCountSchema = object({
13527
+ /**
13528
+ * Why the attempt did not land, in the contributor's own vocabulary —
13529
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13530
+ * strings that already appear in this repo's logs and, where one exists, the
13531
+ * same string the per-track `previewMissReason` records (D276): a second
13532
+ * vocabulary for the same loss would make the row and the counter
13533
+ * un-joinable.
13534
+ */
13535
+ reason: string(),
13536
+ count: number().int().nonnegative()
13537
+ });
13538
+ var FailureContributionSchema = object({
13539
+ /**
13540
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13541
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13542
+ * `unit` free: the families are owned by different addons and a shared enum
13543
+ * is a central list that rots invisibly.
13544
+ */
13545
+ family: string(),
13546
+ /**
13547
+ * The NUMERIC device id — the same value every log line carries as
13548
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13549
+ * cannot name the camera must not emit the entry, because a fleet total
13550
+ * cannot answer the only question anybody asks of this surface.
13551
+ */
13552
+ deviceId: number().int().positive(),
13553
+ /**
13554
+ * A second dimension inside the family: the model / step id for an inference
13555
+ * timeout, so "which camera AND which model" is one read. Absent when the
13556
+ * family has a single variant.
13557
+ */
13558
+ variant: string().optional(),
13559
+ /**
13560
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13561
+ * differencing two reads must drop the interval when it changes, because the
13562
+ * counter restarted from zero in a respawned runner. Same discipline as
13563
+ * `LoadContribution.startedAtMs`.
13564
+ */
13565
+ sinceMs: number(),
13566
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13567
+ atMs: number(),
13568
+ /**
13569
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13570
+ * window. A failure count published without it is the mistake this schema
13571
+ * exists to make impossible.
13572
+ */
13573
+ attempts: number().int().nonnegative(),
13574
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13575
+ succeeded: number().int().nonnegative(),
13576
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13577
+ reasons: array(FailureReasonCountSchema).readonly()
13578
+ });
13579
+ method(_void(), array(FailureContributionSchema).readonly());
13472
13580
  var LoadContributionSchema = object({
13473
13581
  role: _enum([
13474
13582
  "decode",
@@ -13776,6 +13884,50 @@ var NodeProcessSchema = object({
13776
13884
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13777
13885
  uptimeSec: number()
13778
13886
  });
13887
+ /**
13888
+ * One retained container-memory reading.
13889
+ *
13890
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13891
+ * a second clock: that is what makes "processes sum to X, container says Y"
13892
+ * subtractable per point rather than an eyeballed comparison of two series
13893
+ * sampled at different instants.
13894
+ *
13895
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13896
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13897
+ * never coexisted, and a mean would smear away the peak this exists to find.
13898
+ */
13899
+ var ContainerMemoryPointSchema = object({
13900
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13901
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13902
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13903
+ currentBytes: number(),
13904
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13905
+ limitBytes: number().nullable(),
13906
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13907
+ anonBytes: number().nullable(),
13908
+ /** Page cache. Charged to the cgroup, owned by no process. */
13909
+ fileBytes: number().nullable(),
13910
+ /**
13911
+ * Shared memory — and the field that explained the largest single surprise.
13912
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13913
+ * hardware-decode session holding DRM objects is charged HERE and appears
13914
+ * nowhere in a `ps` scan.
13915
+ */
13916
+ shmemBytes: number().nullable(),
13917
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13918
+ slabBytes: number().nullable(),
13919
+ /**
13920
+ * Shrinkable i915 GEM object bytes, from debugfs.
13921
+ *
13922
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13923
+ * component of `currentBytes` and must not be subtracted from it; it says
13924
+ * what put the shmem there, where `shmemBytes` only says how much.
13925
+ *
13926
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13927
+ * container today — and on any node with no Intel GPU.
13928
+ */
13929
+ gpuShmemBytes: number().nullable()
13930
+ }).extend({ atMs: number() });
13779
13931
  var DumpHeapSnapshotInputSchema = object({
13780
13932
  /** The addon whose runner should dump a heap snapshot. */
13781
13933
  addonId: string() });
@@ -13839,6 +13991,21 @@ var NodeLoadSeriesSchema = object({
13839
13991
  /** One entry per function seen in the window, heaviest-first. */
13840
13992
  series: array(LoadFunctionSeriesSchema).readonly(),
13841
13993
  /**
13994
+ * The CONTAINER's memory over the same window, oldest-first.
13995
+ *
13996
+ * Sits next to `series` rather than in a method of its own because the whole
13997
+ * question is a subtraction: the per-process rows in `series` sum to one
13998
+ * number and this one is another, and an operator who has to issue two calls
13999
+ * to compare them will compare two different instants. Same reader, same
14000
+ * `sinceMs`, same `bucketMs`, same timestamps.
14001
+ *
14002
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14003
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14004
+ * points at all. A zero here would be indistinguishable from a healthy
14005
+ * container and is precisely the lie this field exists to avoid.
14006
+ */
14007
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14008
+ /**
13842
14009
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13843
14010
  * reduction was needed — so a caller can always say what one point covers
13844
14011
  * without having to know whether it was reduced.
@@ -18059,6 +18226,20 @@ var TrackSchema = object({
18059
18226
  * `=== true` and render nothing otherwise — never infer "no rider".
18060
18227
  */
18061
18228
  hasRider: boolean().optional(),
18229
+ /**
18230
+ * WHY this track ended without a NATIVE best-shot tile
18231
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18232
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18233
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18234
+ * the late-keyFrame upgrade when a native tile lands after all. The
18235
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18236
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18237
+ *
18238
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18239
+ * that predates the field, and every track whose tile landed native all
18240
+ * omit it. Render nothing when absent.
18241
+ */
18242
+ previewMissReason: string().optional(),
18062
18243
  ...TrackFlagFields,
18063
18244
  ...TrackRetrainFields
18064
18245
  });
@@ -27520,10 +27701,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27520
27701
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27521
27702
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27522
27703
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27523
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27524
- * annotations that are not exposed here and must not be treated as an event
27525
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27526
- * (`interfaces/recording-config.ts`).
27704
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
27705
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27706
+ * ever read them. Event<->footage joins are by time, padded with the shared
27707
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27527
27708
  */
27528
27709
  var RecordingStatusSchema = object({
27529
27710
  deviceId: number(),
@@ -29234,6 +29415,13 @@ var LoggingSettingsPatchSchema = object({
29234
29415
  * anyone but its owner.
29235
29416
  */
29236
29417
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29418
+ /**
29419
+ * One per-camera failure counter, plus WHO reported it.
29420
+ *
29421
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29422
+ * the hub as it enumerates providers, never by the contributor.
29423
+ */
29424
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29237
29425
  var GetLoggingSettingsInputSchema = object({
29238
29426
  scopeNodeId: string().optional(),
29239
29427
  /**
@@ -29292,7 +29480,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29292
29480
  }), method(_void(), SiteLocationStatusSchema, {
29293
29481
  kind: "mutation",
29294
29482
  auth: "admin"
29295
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29483
+ }), 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, {
29296
29484
  kind: "mutation",
29297
29485
  auth: "admin"
29298
29486
  });
@@ -33282,6 +33470,12 @@ Object.freeze({
33282
33470
  addonId: null,
33283
33471
  access: "create"
33284
33472
  },
33473
+ "failureContribution.list": {
33474
+ capName: "failure-contribution",
33475
+ capScope: "system",
33476
+ addonId: null,
33477
+ access: "view"
33478
+ },
33285
33479
  "fanControl.setDirection": {
33286
33480
  capName: "fan-control",
33287
33481
  capScope: "device",
@@ -36588,6 +36782,12 @@ Object.freeze({
36588
36782
  addonId: null,
36589
36783
  access: "create"
36590
36784
  },
36785
+ "system.getFailureContributions": {
36786
+ capName: "system",
36787
+ capScope: "system",
36788
+ addonId: null,
36789
+ access: "view"
36790
+ },
36591
36791
  "system.getLoadContributions": {
36592
36792
  capName: "system",
36593
36793
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-gree",
3
- "version": "0.2.37",
3
+ "version": "0.2.40",
4
4
  "description": "Gree air-conditioner device-provider addon for CamStack — wraps the @apocaliss92/nodegree local-UDP client (LAN discovery + AES control), exposing climate-control and fan-control",
5
5
  "keywords": [
6
6
  "camstack",