@camstack/addon-provider-onvif 1.2.37 → 1.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
@@ -13257,6 +13257,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13257
13257
  limit: number().optional(),
13258
13258
  tags: record(string(), string()).optional()
13259
13259
  }), array(LogEntrySchema).readonly());
13260
+ /**
13261
+ * `failure-contribution` — the capability an addon reports its OWN losses
13262
+ * through, per camera, with the denominator attached. It stores nothing.
13263
+ *
13264
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13265
+ *
13266
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13267
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13268
+ * copied: the contributor reports what it already knows, hub-main adds only
13269
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13270
+ * somebody to forget to edit.
13271
+ *
13272
+ * They are not merged, because their invariants are opposites:
13273
+ *
13274
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13275
+ * claim a camera cost nothing, which is a measurement nobody made;
13276
+ * - a `failure-contribution` zero is the **most valuable value on the
13277
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13278
+ * and it is exactly what an absent entry cannot say.
13279
+ *
13280
+ * Putting a loss counter on a cost entry would also break the reconciliation
13281
+ * that gives `load-contribution` its point: contributions are subtracted from
13282
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13283
+ * has no process.
13284
+ *
13285
+ * ## Why not a log line, since the counters already exist
13286
+ *
13287
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13288
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13289
+ * ends in a log line, and a log line is the thing the operator asked to stop
13290
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13291
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13292
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13293
+ * media blackout were both diagnosed. The counters stay; this is where they can
13294
+ * be READ.
13295
+ *
13296
+ * ## The rate is served with its denominator or not at all
13297
+ *
13298
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13299
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13300
+ * than yesterday" and was **flat across twelve hours** once divided by the
13301
+ * successes on the same path. A surface that publishes only the numerator
13302
+ * reproduces that mistake on every read.
13303
+ *
13304
+ * ## Shape
13305
+ *
13306
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13307
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13308
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13309
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13310
+ * a forked runner's entries reach hub-main over transport that already exists.
13311
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13312
+ * result through `system.getFailureContributions`.
13313
+ */
13314
+ var FailureReasonCountSchema = object({
13315
+ /**
13316
+ * Why the attempt did not land, in the contributor's own vocabulary —
13317
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13318
+ * strings that already appear in this repo's logs and, where one exists, the
13319
+ * same string the per-track `previewMissReason` records (D276): a second
13320
+ * vocabulary for the same loss would make the row and the counter
13321
+ * un-joinable.
13322
+ */
13323
+ reason: string(),
13324
+ count: number().int().nonnegative()
13325
+ });
13326
+ var FailureContributionSchema = object({
13327
+ /**
13328
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13329
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13330
+ * `unit` free: the families are owned by different addons and a shared enum
13331
+ * is a central list that rots invisibly.
13332
+ */
13333
+ family: string(),
13334
+ /**
13335
+ * The NUMERIC device id — the same value every log line carries as
13336
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13337
+ * cannot name the camera must not emit the entry, because a fleet total
13338
+ * cannot answer the only question anybody asks of this surface.
13339
+ */
13340
+ deviceId: number().int().positive(),
13341
+ /**
13342
+ * A second dimension inside the family: the model / step id for an inference
13343
+ * timeout, so "which camera AND which model" is one read. Absent when the
13344
+ * family has a single variant.
13345
+ */
13346
+ variant: string().optional(),
13347
+ /**
13348
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13349
+ * differencing two reads must drop the interval when it changes, because the
13350
+ * counter restarted from zero in a respawned runner. Same discipline as
13351
+ * `LoadContribution.startedAtMs`.
13352
+ */
13353
+ sinceMs: number(),
13354
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13355
+ atMs: number(),
13356
+ /**
13357
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13358
+ * window. A failure count published without it is the mistake this schema
13359
+ * exists to make impossible.
13360
+ */
13361
+ attempts: number().int().nonnegative(),
13362
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13363
+ succeeded: number().int().nonnegative(),
13364
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13365
+ reasons: array(FailureReasonCountSchema).readonly()
13366
+ });
13367
+ method(_void(), array(FailureContributionSchema).readonly());
13260
13368
  var LoadContributionSchema = object({
13261
13369
  role: _enum([
13262
13370
  "decode",
@@ -13564,6 +13672,50 @@ var NodeProcessSchema = object({
13564
13672
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13565
13673
  uptimeSec: number()
13566
13674
  });
13675
+ /**
13676
+ * One retained container-memory reading.
13677
+ *
13678
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13679
+ * a second clock: that is what makes "processes sum to X, container says Y"
13680
+ * subtractable per point rather than an eyeballed comparison of two series
13681
+ * sampled at different instants.
13682
+ *
13683
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13684
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13685
+ * never coexisted, and a mean would smear away the peak this exists to find.
13686
+ */
13687
+ var ContainerMemoryPointSchema = object({
13688
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13689
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13690
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13691
+ currentBytes: number(),
13692
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13693
+ limitBytes: number().nullable(),
13694
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13695
+ anonBytes: number().nullable(),
13696
+ /** Page cache. Charged to the cgroup, owned by no process. */
13697
+ fileBytes: number().nullable(),
13698
+ /**
13699
+ * Shared memory — and the field that explained the largest single surprise.
13700
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13701
+ * hardware-decode session holding DRM objects is charged HERE and appears
13702
+ * nowhere in a `ps` scan.
13703
+ */
13704
+ shmemBytes: number().nullable(),
13705
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13706
+ slabBytes: number().nullable(),
13707
+ /**
13708
+ * Shrinkable i915 GEM object bytes, from debugfs.
13709
+ *
13710
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13711
+ * component of `currentBytes` and must not be subtracted from it; it says
13712
+ * what put the shmem there, where `shmemBytes` only says how much.
13713
+ *
13714
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13715
+ * container today — and on any node with no Intel GPU.
13716
+ */
13717
+ gpuShmemBytes: number().nullable()
13718
+ }).extend({ atMs: number() });
13567
13719
  var DumpHeapSnapshotInputSchema = object({
13568
13720
  /** The addon whose runner should dump a heap snapshot. */
13569
13721
  addonId: string() });
@@ -13627,6 +13779,21 @@ var NodeLoadSeriesSchema = object({
13627
13779
  /** One entry per function seen in the window, heaviest-first. */
13628
13780
  series: array(LoadFunctionSeriesSchema).readonly(),
13629
13781
  /**
13782
+ * The CONTAINER's memory over the same window, oldest-first.
13783
+ *
13784
+ * Sits next to `series` rather than in a method of its own because the whole
13785
+ * question is a subtraction: the per-process rows in `series` sum to one
13786
+ * number and this one is another, and an operator who has to issue two calls
13787
+ * to compare them will compare two different instants. Same reader, same
13788
+ * `sinceMs`, same `bucketMs`, same timestamps.
13789
+ *
13790
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13791
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13792
+ * points at all. A zero here would be indistinguishable from a healthy
13793
+ * container and is precisely the lie this field exists to avoid.
13794
+ */
13795
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13796
+ /**
13630
13797
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13631
13798
  * reduction was needed — so a caller can always say what one point covers
13632
13799
  * without having to know whether it was reduced.
@@ -17769,6 +17936,20 @@ var TrackSchema = object({
17769
17936
  * `=== true` and render nothing otherwise — never infer "no rider".
17770
17937
  */
17771
17938
  hasRider: boolean().optional(),
17939
+ /**
17940
+ * WHY this track ended without a NATIVE best-shot tile
17941
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
17942
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
17943
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
17944
+ * the late-keyFrame upgrade when a native tile lands after all. The
17945
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
17946
+ * tile is a face/plate stand-in, a raster crop, or an icon.
17947
+ *
17948
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
17949
+ * that predates the field, and every track whose tile landed native all
17950
+ * omit it. Render nothing when absent.
17951
+ */
17952
+ previewMissReason: string().optional(),
17772
17953
  ...TrackFlagFields,
17773
17954
  ...TrackRetrainFields
17774
17955
  });
@@ -25688,10 +25869,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25688
25869
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25689
25870
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25690
25871
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25691
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25692
- * annotations that are not exposed here and must not be treated as an event
25693
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25694
- * (`interfaces/recording-config.ts`).
25872
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
25873
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25874
+ * ever read them. Event<->footage joins are by time, padded with the shared
25875
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25695
25876
  */
25696
25877
  var RecordingStatusSchema = object({
25697
25878
  deviceId: number(),
@@ -27141,6 +27322,13 @@ var LoggingSettingsPatchSchema = object({
27141
27322
  * anyone but its owner.
27142
27323
  */
27143
27324
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27325
+ /**
27326
+ * One per-camera failure counter, plus WHO reported it.
27327
+ *
27328
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27329
+ * the hub as it enumerates providers, never by the contributor.
27330
+ */
27331
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27144
27332
  var GetLoggingSettingsInputSchema = object({
27145
27333
  scopeNodeId: string().optional(),
27146
27334
  /**
@@ -27199,7 +27387,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27199
27387
  }), method(_void(), SiteLocationStatusSchema, {
27200
27388
  kind: "mutation",
27201
27389
  auth: "admin"
27202
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27390
+ }), 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, {
27203
27391
  kind: "mutation",
27204
27392
  auth: "admin"
27205
27393
  });
@@ -30191,6 +30379,12 @@ Object.freeze({
30191
30379
  addonId: null,
30192
30380
  access: "create"
30193
30381
  },
30382
+ "failureContribution.list": {
30383
+ capName: "failure-contribution",
30384
+ capScope: "system",
30385
+ addonId: null,
30386
+ access: "view"
30387
+ },
30194
30388
  "fanControl.setDirection": {
30195
30389
  capName: "fan-control",
30196
30390
  capScope: "device",
@@ -33497,6 +33691,12 @@ Object.freeze({
33497
33691
  addonId: null,
33498
33692
  access: "create"
33499
33693
  },
33694
+ "system.getFailureContributions": {
33695
+ capName: "system",
33696
+ capScope: "system",
33697
+ addonId: null,
33698
+ access: "view"
33699
+ },
33500
33700
  "system.getLoadContributions": {
33501
33701
  capName: "system",
33502
33702
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13258,6 +13258,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13258
13258
  limit: number().optional(),
13259
13259
  tags: record(string(), string()).optional()
13260
13260
  }), array(LogEntrySchema).readonly());
13261
+ /**
13262
+ * `failure-contribution` — the capability an addon reports its OWN losses
13263
+ * through, per camera, with the denominator attached. It stores nothing.
13264
+ *
13265
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13266
+ *
13267
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13268
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13269
+ * copied: the contributor reports what it already knows, hub-main adds only
13270
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13271
+ * somebody to forget to edit.
13272
+ *
13273
+ * They are not merged, because their invariants are opposites:
13274
+ *
13275
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13276
+ * claim a camera cost nothing, which is a measurement nobody made;
13277
+ * - a `failure-contribution` zero is the **most valuable value on the
13278
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13279
+ * and it is exactly what an absent entry cannot say.
13280
+ *
13281
+ * Putting a loss counter on a cost entry would also break the reconciliation
13282
+ * that gives `load-contribution` its point: contributions are subtracted from
13283
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13284
+ * has no process.
13285
+ *
13286
+ * ## Why not a log line, since the counters already exist
13287
+ *
13288
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13289
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13290
+ * ends in a log line, and a log line is the thing the operator asked to stop
13291
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13292
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13293
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13294
+ * media blackout were both diagnosed. The counters stay; this is where they can
13295
+ * be READ.
13296
+ *
13297
+ * ## The rate is served with its denominator or not at all
13298
+ *
13299
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13300
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13301
+ * than yesterday" and was **flat across twelve hours** once divided by the
13302
+ * successes on the same path. A surface that publishes only the numerator
13303
+ * reproduces that mistake on every read.
13304
+ *
13305
+ * ## Shape
13306
+ *
13307
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13308
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13309
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13310
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13311
+ * a forked runner's entries reach hub-main over transport that already exists.
13312
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13313
+ * result through `system.getFailureContributions`.
13314
+ */
13315
+ var FailureReasonCountSchema = object({
13316
+ /**
13317
+ * Why the attempt did not land, in the contributor's own vocabulary —
13318
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13319
+ * strings that already appear in this repo's logs and, where one exists, the
13320
+ * same string the per-track `previewMissReason` records (D276): a second
13321
+ * vocabulary for the same loss would make the row and the counter
13322
+ * un-joinable.
13323
+ */
13324
+ reason: string(),
13325
+ count: number().int().nonnegative()
13326
+ });
13327
+ var FailureContributionSchema = object({
13328
+ /**
13329
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13330
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13331
+ * `unit` free: the families are owned by different addons and a shared enum
13332
+ * is a central list that rots invisibly.
13333
+ */
13334
+ family: string(),
13335
+ /**
13336
+ * The NUMERIC device id — the same value every log line carries as
13337
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13338
+ * cannot name the camera must not emit the entry, because a fleet total
13339
+ * cannot answer the only question anybody asks of this surface.
13340
+ */
13341
+ deviceId: number().int().positive(),
13342
+ /**
13343
+ * A second dimension inside the family: the model / step id for an inference
13344
+ * timeout, so "which camera AND which model" is one read. Absent when the
13345
+ * family has a single variant.
13346
+ */
13347
+ variant: string().optional(),
13348
+ /**
13349
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13350
+ * differencing two reads must drop the interval when it changes, because the
13351
+ * counter restarted from zero in a respawned runner. Same discipline as
13352
+ * `LoadContribution.startedAtMs`.
13353
+ */
13354
+ sinceMs: number(),
13355
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13356
+ atMs: number(),
13357
+ /**
13358
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13359
+ * window. A failure count published without it is the mistake this schema
13360
+ * exists to make impossible.
13361
+ */
13362
+ attempts: number().int().nonnegative(),
13363
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13364
+ succeeded: number().int().nonnegative(),
13365
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13366
+ reasons: array(FailureReasonCountSchema).readonly()
13367
+ });
13368
+ method(_void(), array(FailureContributionSchema).readonly());
13261
13369
  var LoadContributionSchema = object({
13262
13370
  role: _enum([
13263
13371
  "decode",
@@ -13565,6 +13673,50 @@ var NodeProcessSchema = object({
13565
13673
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13566
13674
  uptimeSec: number()
13567
13675
  });
13676
+ /**
13677
+ * One retained container-memory reading.
13678
+ *
13679
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13680
+ * a second clock: that is what makes "processes sum to X, container says Y"
13681
+ * subtractable per point rather than an eyeballed comparison of two series
13682
+ * sampled at different instants.
13683
+ *
13684
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13685
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13686
+ * never coexisted, and a mean would smear away the peak this exists to find.
13687
+ */
13688
+ var ContainerMemoryPointSchema = object({
13689
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13690
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13691
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13692
+ currentBytes: number(),
13693
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13694
+ limitBytes: number().nullable(),
13695
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13696
+ anonBytes: number().nullable(),
13697
+ /** Page cache. Charged to the cgroup, owned by no process. */
13698
+ fileBytes: number().nullable(),
13699
+ /**
13700
+ * Shared memory — and the field that explained the largest single surprise.
13701
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13702
+ * hardware-decode session holding DRM objects is charged HERE and appears
13703
+ * nowhere in a `ps` scan.
13704
+ */
13705
+ shmemBytes: number().nullable(),
13706
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13707
+ slabBytes: number().nullable(),
13708
+ /**
13709
+ * Shrinkable i915 GEM object bytes, from debugfs.
13710
+ *
13711
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13712
+ * component of `currentBytes` and must not be subtracted from it; it says
13713
+ * what put the shmem there, where `shmemBytes` only says how much.
13714
+ *
13715
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13716
+ * container today — and on any node with no Intel GPU.
13717
+ */
13718
+ gpuShmemBytes: number().nullable()
13719
+ }).extend({ atMs: number() });
13568
13720
  var DumpHeapSnapshotInputSchema = object({
13569
13721
  /** The addon whose runner should dump a heap snapshot. */
13570
13722
  addonId: string() });
@@ -13628,6 +13780,21 @@ var NodeLoadSeriesSchema = object({
13628
13780
  /** One entry per function seen in the window, heaviest-first. */
13629
13781
  series: array(LoadFunctionSeriesSchema).readonly(),
13630
13782
  /**
13783
+ * The CONTAINER's memory over the same window, oldest-first.
13784
+ *
13785
+ * Sits next to `series` rather than in a method of its own because the whole
13786
+ * question is a subtraction: the per-process rows in `series` sum to one
13787
+ * number and this one is another, and an operator who has to issue two calls
13788
+ * to compare them will compare two different instants. Same reader, same
13789
+ * `sinceMs`, same `bucketMs`, same timestamps.
13790
+ *
13791
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13792
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13793
+ * points at all. A zero here would be indistinguishable from a healthy
13794
+ * container and is precisely the lie this field exists to avoid.
13795
+ */
13796
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13797
+ /**
13631
13798
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13632
13799
  * reduction was needed — so a caller can always say what one point covers
13633
13800
  * without having to know whether it was reduced.
@@ -17770,6 +17937,20 @@ var TrackSchema = object({
17770
17937
  * `=== true` and render nothing otherwise — never infer "no rider".
17771
17938
  */
17772
17939
  hasRider: boolean().optional(),
17940
+ /**
17941
+ * WHY this track ended without a NATIVE best-shot tile
17942
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
17943
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
17944
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
17945
+ * the late-keyFrame upgrade when a native tile lands after all. The
17946
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
17947
+ * tile is a face/plate stand-in, a raster crop, or an icon.
17948
+ *
17949
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
17950
+ * that predates the field, and every track whose tile landed native all
17951
+ * omit it. Render nothing when absent.
17952
+ */
17953
+ previewMissReason: string().optional(),
17773
17954
  ...TrackFlagFields,
17774
17955
  ...TrackRetrainFields
17775
17956
  });
@@ -25689,10 +25870,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25689
25870
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25690
25871
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25691
25872
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25692
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25693
- * annotations that are not exposed here and must not be treated as an event
25694
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25695
- * (`interfaces/recording-config.ts`).
25873
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
25874
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25875
+ * ever read them. Event<->footage joins are by time, padded with the shared
25876
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25696
25877
  */
25697
25878
  var RecordingStatusSchema = object({
25698
25879
  deviceId: number(),
@@ -27142,6 +27323,13 @@ var LoggingSettingsPatchSchema = object({
27142
27323
  * anyone but its owner.
27143
27324
  */
27144
27325
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27326
+ /**
27327
+ * One per-camera failure counter, plus WHO reported it.
27328
+ *
27329
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27330
+ * the hub as it enumerates providers, never by the contributor.
27331
+ */
27332
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27145
27333
  var GetLoggingSettingsInputSchema = object({
27146
27334
  scopeNodeId: string().optional(),
27147
27335
  /**
@@ -27200,7 +27388,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27200
27388
  }), method(_void(), SiteLocationStatusSchema, {
27201
27389
  kind: "mutation",
27202
27390
  auth: "admin"
27203
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27391
+ }), 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, {
27204
27392
  kind: "mutation",
27205
27393
  auth: "admin"
27206
27394
  });
@@ -30192,6 +30380,12 @@ Object.freeze({
30192
30380
  addonId: null,
30193
30381
  access: "create"
30194
30382
  },
30383
+ "failureContribution.list": {
30384
+ capName: "failure-contribution",
30385
+ capScope: "system",
30386
+ addonId: null,
30387
+ access: "view"
30388
+ },
30195
30389
  "fanControl.setDirection": {
30196
30390
  capName: "fan-control",
30197
30391
  capScope: "device",
@@ -33498,6 +33692,12 @@ Object.freeze({
33498
33692
  addonId: null,
33499
33693
  access: "create"
33500
33694
  },
33695
+ "system.getFailureContributions": {
33696
+ capName: "system",
33697
+ capScope: "system",
33698
+ addonId: null,
33699
+ access: "view"
33700
+ },
33501
33701
  "system.getLoadContributions": {
33502
33702
  capName: "system",
33503
33703
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-onvif",
3
- "version": "1.2.37",
3
+ "version": "1.2.40",
4
4
  "description": "ONVIF camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",