@camstack/addon-provider-petkit 0.2.38 → 0.2.41

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
@@ -14586,6 +14586,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
14586
14586
  limit: number().optional(),
14587
14587
  tags: record(string(), string()).optional()
14588
14588
  }), array(LogEntrySchema).readonly());
14589
+ /**
14590
+ * `failure-contribution` — the capability an addon reports its OWN losses
14591
+ * through, per camera, with the denominator attached. It stores nothing.
14592
+ *
14593
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14594
+ *
14595
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14596
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14597
+ * copied: the contributor reports what it already knows, hub-main adds only
14598
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14599
+ * somebody to forget to edit.
14600
+ *
14601
+ * They are not merged, because their invariants are opposites:
14602
+ *
14603
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14604
+ * claim a camera cost nothing, which is a measurement nobody made;
14605
+ * - a `failure-contribution` zero is the **most valuable value on the
14606
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14607
+ * and it is exactly what an absent entry cannot say.
14608
+ *
14609
+ * Putting a loss counter on a cost entry would also break the reconciliation
14610
+ * that gives `load-contribution` its point: contributions are subtracted from
14611
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14612
+ * has no process.
14613
+ *
14614
+ * ## Why not a log line, since the counters already exist
14615
+ *
14616
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14617
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14618
+ * ends in a log line, and a log line is the thing the operator asked to stop
14619
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14620
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14621
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14622
+ * media blackout were both diagnosed. The counters stay; this is where they can
14623
+ * be READ.
14624
+ *
14625
+ * ## The rate is served with its denominator or not at all
14626
+ *
14627
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14628
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14629
+ * than yesterday" and was **flat across twelve hours** once divided by the
14630
+ * successes on the same path. A surface that publishes only the numerator
14631
+ * reproduces that mistake on every read.
14632
+ *
14633
+ * ## Shape
14634
+ *
14635
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14636
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14637
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14638
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14639
+ * a forked runner's entries reach hub-main over transport that already exists.
14640
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14641
+ * result through `system.getFailureContributions`.
14642
+ */
14643
+ var FailureReasonCountSchema = object({
14644
+ /**
14645
+ * Why the attempt did not land, in the contributor's own vocabulary —
14646
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14647
+ * strings that already appear in this repo's logs and, where one exists, the
14648
+ * same string the per-track `previewMissReason` records (D276): a second
14649
+ * vocabulary for the same loss would make the row and the counter
14650
+ * un-joinable.
14651
+ */
14652
+ reason: string(),
14653
+ count: number().int().nonnegative()
14654
+ });
14655
+ var FailureContributionSchema = object({
14656
+ /**
14657
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14658
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14659
+ * `unit` free: the families are owned by different addons and a shared enum
14660
+ * is a central list that rots invisibly.
14661
+ */
14662
+ family: string(),
14663
+ /**
14664
+ * The NUMERIC device id — the same value every log line carries as
14665
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14666
+ * cannot name the camera must not emit the entry, because a fleet total
14667
+ * cannot answer the only question anybody asks of this surface.
14668
+ */
14669
+ deviceId: number().int().positive(),
14670
+ /**
14671
+ * A second dimension inside the family: the model / step id for an inference
14672
+ * timeout, so "which camera AND which model" is one read. Absent when the
14673
+ * family has a single variant.
14674
+ */
14675
+ variant: string().optional(),
14676
+ /**
14677
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14678
+ * differencing two reads must drop the interval when it changes, because the
14679
+ * counter restarted from zero in a respawned runner. Same discipline as
14680
+ * `LoadContribution.startedAtMs`.
14681
+ */
14682
+ sinceMs: number(),
14683
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14684
+ atMs: number(),
14685
+ /**
14686
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14687
+ * window. A failure count published without it is the mistake this schema
14688
+ * exists to make impossible.
14689
+ */
14690
+ attempts: number().int().nonnegative(),
14691
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14692
+ succeeded: number().int().nonnegative(),
14693
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14694
+ reasons: array(FailureReasonCountSchema).readonly()
14695
+ });
14696
+ method(_void(), array(FailureContributionSchema).readonly());
14589
14697
  var LoadContributionSchema = object({
14590
14698
  role: _enum([
14591
14699
  "decode",
@@ -14893,6 +15001,50 @@ var NodeProcessSchema = object({
14893
15001
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14894
15002
  uptimeSec: number()
14895
15003
  });
15004
+ /**
15005
+ * One retained container-memory reading.
15006
+ *
15007
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
15008
+ * a second clock: that is what makes "processes sum to X, container says Y"
15009
+ * subtractable per point rather than an eyeballed comparison of two series
15010
+ * sampled at different instants.
15011
+ *
15012
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
15013
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
15014
+ * never coexisted, and a mean would smear away the peak this exists to find.
15015
+ */
15016
+ var ContainerMemoryPointSchema = object({
15017
+ /** Which hierarchy answered, so a reading is never ambiguous. */
15018
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
15019
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
15020
+ currentBytes: number(),
15021
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
15022
+ limitBytes: number().nullable(),
15023
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
15024
+ anonBytes: number().nullable(),
15025
+ /** Page cache. Charged to the cgroup, owned by no process. */
15026
+ fileBytes: number().nullable(),
15027
+ /**
15028
+ * Shared memory — and the field that explained the largest single surprise.
15029
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
15030
+ * hardware-decode session holding DRM objects is charged HERE and appears
15031
+ * nowhere in a `ps` scan.
15032
+ */
15033
+ shmemBytes: number().nullable(),
15034
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
15035
+ slabBytes: number().nullable(),
15036
+ /**
15037
+ * Shrinkable i915 GEM object bytes, from debugfs.
15038
+ *
15039
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
15040
+ * component of `currentBytes` and must not be subtracted from it; it says
15041
+ * what put the shmem there, where `shmemBytes` only says how much.
15042
+ *
15043
+ * `null` wherever debugfs is not mounted — which is inside every camstack
15044
+ * container today — and on any node with no Intel GPU.
15045
+ */
15046
+ gpuShmemBytes: number().nullable()
15047
+ }).extend({ atMs: number() });
14896
15048
  var DumpHeapSnapshotInputSchema = object({
14897
15049
  /** The addon whose runner should dump a heap snapshot. */
14898
15050
  addonId: string() });
@@ -14956,6 +15108,21 @@ var NodeLoadSeriesSchema = object({
14956
15108
  /** One entry per function seen in the window, heaviest-first. */
14957
15109
  series: array(LoadFunctionSeriesSchema).readonly(),
14958
15110
  /**
15111
+ * The CONTAINER's memory over the same window, oldest-first.
15112
+ *
15113
+ * Sits next to `series` rather than in a method of its own because the whole
15114
+ * question is a subtraction: the per-process rows in `series` sum to one
15115
+ * number and this one is another, and an operator who has to issue two calls
15116
+ * to compare them will compare two different instants. Same reader, same
15117
+ * `sinceMs`, same `bucketMs`, same timestamps.
15118
+ *
15119
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
15120
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
15121
+ * points at all. A zero here would be indistinguishable from a healthy
15122
+ * container and is precisely the lie this field exists to avoid.
15123
+ */
15124
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
15125
+ /**
14959
15126
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14960
15127
  * reduction was needed — so a caller can always say what one point covers
14961
15128
  * without having to know whether it was reduced.
@@ -19176,6 +19343,20 @@ var TrackSchema = object({
19176
19343
  * `=== true` and render nothing otherwise — never infer "no rider".
19177
19344
  */
19178
19345
  hasRider: boolean().optional(),
19346
+ /**
19347
+ * WHY this track ended without a NATIVE best-shot tile
19348
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19349
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19350
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19351
+ * the late-keyFrame upgrade when a native tile lands after all. The
19352
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
19353
+ * tile is a face/plate stand-in, a raster crop, or an icon.
19354
+ *
19355
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
19356
+ * that predates the field, and every track whose tile landed native all
19357
+ * omit it. Render nothing when absent.
19358
+ */
19359
+ previewMissReason: string().optional(),
19179
19360
  ...TrackFlagFields,
19180
19361
  ...TrackRetrainFields
19181
19362
  });
@@ -28645,10 +28826,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
28645
28826
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
28646
28827
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
28647
28828
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
28648
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
28649
- * annotations that are not exposed here and must not be treated as an event
28650
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
28651
- * (`interfaces/recording-config.ts`).
28829
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
28830
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
28831
+ * ever read them. Event<->footage joins are by time, padded with the shared
28832
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
28652
28833
  */
28653
28834
  var RecordingStatusSchema = object({
28654
28835
  deviceId: number(),
@@ -30359,6 +30540,13 @@ var LoggingSettingsPatchSchema = object({
30359
30540
  * anyone but its owner.
30360
30541
  */
30361
30542
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
30543
+ /**
30544
+ * One per-camera failure counter, plus WHO reported it.
30545
+ *
30546
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
30547
+ * the hub as it enumerates providers, never by the contributor.
30548
+ */
30549
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
30362
30550
  var GetLoggingSettingsInputSchema = object({
30363
30551
  scopeNodeId: string().optional(),
30364
30552
  /**
@@ -30417,7 +30605,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
30417
30605
  }), method(_void(), SiteLocationStatusSchema, {
30418
30606
  kind: "mutation",
30419
30607
  auth: "admin"
30420
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
30608
+ }), 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, {
30421
30609
  kind: "mutation",
30422
30610
  auth: "admin"
30423
30611
  });
@@ -34407,6 +34595,12 @@ Object.freeze({
34407
34595
  addonId: null,
34408
34596
  access: "create"
34409
34597
  },
34598
+ "failureContribution.list": {
34599
+ capName: "failure-contribution",
34600
+ capScope: "system",
34601
+ addonId: null,
34602
+ access: "view"
34603
+ },
34410
34604
  "fanControl.setDirection": {
34411
34605
  capName: "fan-control",
34412
34606
  capScope: "device",
@@ -37713,6 +37907,12 @@ Object.freeze({
37713
37907
  addonId: null,
37714
37908
  access: "create"
37715
37909
  },
37910
+ "system.getFailureContributions": {
37911
+ capName: "system",
37912
+ capScope: "system",
37913
+ addonId: null,
37914
+ access: "view"
37915
+ },
37716
37916
  "system.getLoadContributions": {
37717
37917
  capName: "system",
37718
37918
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -14585,6 +14585,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
14585
14585
  limit: number().optional(),
14586
14586
  tags: record(string(), string()).optional()
14587
14587
  }), array(LogEntrySchema).readonly());
14588
+ /**
14589
+ * `failure-contribution` — the capability an addon reports its OWN losses
14590
+ * through, per camera, with the denominator attached. It stores nothing.
14591
+ *
14592
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
14593
+ *
14594
+ * `load-contribution` answers *what did this camera COST*. This answers *what
14595
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
14596
+ * copied: the contributor reports what it already knows, hub-main adds only
14597
+ * `addonId`, nothing needs global knowledge, and there is no central list for
14598
+ * somebody to forget to edit.
14599
+ *
14600
+ * They are not merged, because their invariants are opposites:
14601
+ *
14602
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
14603
+ * claim a camera cost nothing, which is a measurement nobody made;
14604
+ * - a `failure-contribution` zero is the **most valuable value on the
14605
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
14606
+ * and it is exactly what an absent entry cannot say.
14607
+ *
14608
+ * Putting a loss counter on a cost entry would also break the reconciliation
14609
+ * that gives `load-contribution` its point: contributions are subtracted from
14610
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
14611
+ * has no process.
14612
+ *
14613
+ * ## Why not a log line, since the counters already exist
14614
+ *
14615
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
14616
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
14617
+ * ends in a log line, and a log line is the thing the operator asked to stop
14618
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
14619
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
14620
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
14621
+ * media blackout were both diagnosed. The counters stay; this is where they can
14622
+ * be READ.
14623
+ *
14624
+ * ## The rate is served with its denominator or not at all
14625
+ *
14626
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
14627
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
14628
+ * than yesterday" and was **flat across twelve hours** once divided by the
14629
+ * successes on the same path. A surface that publishes only the numerator
14630
+ * reproduces that mistake on every read.
14631
+ *
14632
+ * ## Shape
14633
+ *
14634
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
14635
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
14636
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
14637
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
14638
+ * a forked runner's entries reach hub-main over transport that already exists.
14639
+ * No new UDS message, no second registry (D3). The operator reads the assembled
14640
+ * result through `system.getFailureContributions`.
14641
+ */
14642
+ var FailureReasonCountSchema = object({
14643
+ /**
14644
+ * Why the attempt did not land, in the contributor's own vocabulary —
14645
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
14646
+ * strings that already appear in this repo's logs and, where one exists, the
14647
+ * same string the per-track `previewMissReason` records (D276): a second
14648
+ * vocabulary for the same loss would make the row and the counter
14649
+ * un-joinable.
14650
+ */
14651
+ reason: string(),
14652
+ count: number().int().nonnegative()
14653
+ });
14654
+ var FailureContributionSchema = object({
14655
+ /**
14656
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
14657
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
14658
+ * `unit` free: the families are owned by different addons and a shared enum
14659
+ * is a central list that rots invisibly.
14660
+ */
14661
+ family: string(),
14662
+ /**
14663
+ * The NUMERIC device id — the same value every log line carries as
14664
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
14665
+ * cannot name the camera must not emit the entry, because a fleet total
14666
+ * cannot answer the only question anybody asks of this surface.
14667
+ */
14668
+ deviceId: number().int().positive(),
14669
+ /**
14670
+ * A second dimension inside the family: the model / step id for an inference
14671
+ * timeout, so "which camera AND which model" is one read. Absent when the
14672
+ * family has a single variant.
14673
+ */
14674
+ variant: string().optional(),
14675
+ /**
14676
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
14677
+ * differencing two reads must drop the interval when it changes, because the
14678
+ * counter restarted from zero in a respawned runner. Same discipline as
14679
+ * `LoadContribution.startedAtMs`.
14680
+ */
14681
+ sinceMs: number(),
14682
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
14683
+ atMs: number(),
14684
+ /**
14685
+ * THE DENOMINATOR — every attempt on this path for this camera in the
14686
+ * window. A failure count published without it is the mistake this schema
14687
+ * exists to make impossible.
14688
+ */
14689
+ attempts: number().int().nonnegative(),
14690
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
14691
+ succeeded: number().int().nonnegative(),
14692
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
14693
+ reasons: array(FailureReasonCountSchema).readonly()
14694
+ });
14695
+ method(_void(), array(FailureContributionSchema).readonly());
14588
14696
  var LoadContributionSchema = object({
14589
14697
  role: _enum([
14590
14698
  "decode",
@@ -14892,6 +15000,50 @@ var NodeProcessSchema = object({
14892
15000
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
14893
15001
  uptimeSec: number()
14894
15002
  });
15003
+ /**
15004
+ * One retained container-memory reading.
15005
+ *
15006
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
15007
+ * a second clock: that is what makes "processes sum to X, container says Y"
15008
+ * subtractable per point rather than an eyeballed comparison of two series
15009
+ * sampled at different instants.
15010
+ *
15011
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
15012
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
15013
+ * never coexisted, and a mean would smear away the peak this exists to find.
15014
+ */
15015
+ var ContainerMemoryPointSchema = object({
15016
+ /** Which hierarchy answered, so a reading is never ambiguous. */
15017
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
15018
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
15019
+ currentBytes: number(),
15020
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
15021
+ limitBytes: number().nullable(),
15022
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
15023
+ anonBytes: number().nullable(),
15024
+ /** Page cache. Charged to the cgroup, owned by no process. */
15025
+ fileBytes: number().nullable(),
15026
+ /**
15027
+ * Shared memory — and the field that explained the largest single surprise.
15028
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
15029
+ * hardware-decode session holding DRM objects is charged HERE and appears
15030
+ * nowhere in a `ps` scan.
15031
+ */
15032
+ shmemBytes: number().nullable(),
15033
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
15034
+ slabBytes: number().nullable(),
15035
+ /**
15036
+ * Shrinkable i915 GEM object bytes, from debugfs.
15037
+ *
15038
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
15039
+ * component of `currentBytes` and must not be subtracted from it; it says
15040
+ * what put the shmem there, where `shmemBytes` only says how much.
15041
+ *
15042
+ * `null` wherever debugfs is not mounted — which is inside every camstack
15043
+ * container today — and on any node with no Intel GPU.
15044
+ */
15045
+ gpuShmemBytes: number().nullable()
15046
+ }).extend({ atMs: number() });
14895
15047
  var DumpHeapSnapshotInputSchema = object({
14896
15048
  /** The addon whose runner should dump a heap snapshot. */
14897
15049
  addonId: string() });
@@ -14955,6 +15107,21 @@ var NodeLoadSeriesSchema = object({
14955
15107
  /** One entry per function seen in the window, heaviest-first. */
14956
15108
  series: array(LoadFunctionSeriesSchema).readonly(),
14957
15109
  /**
15110
+ * The CONTAINER's memory over the same window, oldest-first.
15111
+ *
15112
+ * Sits next to `series` rather than in a method of its own because the whole
15113
+ * question is a subtraction: the per-process rows in `series` sum to one
15114
+ * number and this one is another, and an operator who has to issue two calls
15115
+ * to compare them will compare two different instants. Same reader, same
15116
+ * `sinceMs`, same `bucketMs`, same timestamps.
15117
+ *
15118
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
15119
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
15120
+ * points at all. A zero here would be indistinguishable from a healthy
15121
+ * container and is precisely the lie this field exists to avoid.
15122
+ */
15123
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
15124
+ /**
14958
15125
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
14959
15126
  * reduction was needed — so a caller can always say what one point covers
14960
15127
  * without having to know whether it was reduced.
@@ -19175,6 +19342,20 @@ var TrackSchema = object({
19175
19342
  * `=== true` and render nothing otherwise — never infer "no rider".
19176
19343
  */
19177
19344
  hasRider: boolean().optional(),
19345
+ /**
19346
+ * WHY this track ended without a NATIVE best-shot tile
19347
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
19348
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
19349
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
19350
+ * the late-keyFrame upgrade when a native tile lands after all. The
19351
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
19352
+ * tile is a face/plate stand-in, a raster crop, or an icon.
19353
+ *
19354
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
19355
+ * that predates the field, and every track whose tile landed native all
19356
+ * omit it. Render nothing when absent.
19357
+ */
19358
+ previewMissReason: string().optional(),
19178
19359
  ...TrackFlagFields,
19179
19360
  ...TrackRetrainFields
19180
19361
  });
@@ -28644,10 +28825,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
28644
28825
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
28645
28826
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
28646
28827
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
28647
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
28648
- * annotations that are not exposed here and must not be treated as an event
28649
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
28650
- * (`interfaces/recording-config.ts`).
28828
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
28829
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
28830
+ * ever read them. Event<->footage joins are by time, padded with the shared
28831
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
28651
28832
  */
28652
28833
  var RecordingStatusSchema = object({
28653
28834
  deviceId: number(),
@@ -30358,6 +30539,13 @@ var LoggingSettingsPatchSchema = object({
30358
30539
  * anyone but its owner.
30359
30540
  */
30360
30541
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
30542
+ /**
30543
+ * One per-camera failure counter, plus WHO reported it.
30544
+ *
30545
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
30546
+ * the hub as it enumerates providers, never by the contributor.
30547
+ */
30548
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
30361
30549
  var GetLoggingSettingsInputSchema = object({
30362
30550
  scopeNodeId: string().optional(),
30363
30551
  /**
@@ -30416,7 +30604,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
30416
30604
  }), method(_void(), SiteLocationStatusSchema, {
30417
30605
  kind: "mutation",
30418
30606
  auth: "admin"
30419
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
30607
+ }), 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, {
30420
30608
  kind: "mutation",
30421
30609
  auth: "admin"
30422
30610
  });
@@ -34406,6 +34594,12 @@ Object.freeze({
34406
34594
  addonId: null,
34407
34595
  access: "create"
34408
34596
  },
34597
+ "failureContribution.list": {
34598
+ capName: "failure-contribution",
34599
+ capScope: "system",
34600
+ addonId: null,
34601
+ access: "view"
34602
+ },
34409
34603
  "fanControl.setDirection": {
34410
34604
  capName: "fan-control",
34411
34605
  capScope: "device",
@@ -37712,6 +37906,12 @@ Object.freeze({
37712
37906
  addonId: null,
37713
37907
  access: "create"
37714
37908
  },
37909
+ "system.getFailureContributions": {
37910
+ capName: "system",
37911
+ capScope: "system",
37912
+ addonId: null,
37913
+ access: "view"
37914
+ },
37715
37915
  "system.getLoadContributions": {
37716
37916
  capName: "system",
37717
37917
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-petkit",
3
- "version": "0.2.38",
3
+ "version": "0.2.41",
4
4
  "description": "PetKit smart-feeder device-provider addon for CamStack — wraps the @apocaliss92/nodepetkit PetKit cloud client",
5
5
  "keywords": [
6
6
  "camstack",