@camstack/addon-provider-rtsp 1.2.38 → 1.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
@@ -13523,6 +13523,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13523
13523
  limit: number().optional(),
13524
13524
  tags: record(string(), string()).optional()
13525
13525
  }), array(LogEntrySchema).readonly());
13526
+ /**
13527
+ * `failure-contribution` — the capability an addon reports its OWN losses
13528
+ * through, per camera, with the denominator attached. It stores nothing.
13529
+ *
13530
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13531
+ *
13532
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13533
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13534
+ * copied: the contributor reports what it already knows, hub-main adds only
13535
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13536
+ * somebody to forget to edit.
13537
+ *
13538
+ * They are not merged, because their invariants are opposites:
13539
+ *
13540
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13541
+ * claim a camera cost nothing, which is a measurement nobody made;
13542
+ * - a `failure-contribution` zero is the **most valuable value on the
13543
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13544
+ * and it is exactly what an absent entry cannot say.
13545
+ *
13546
+ * Putting a loss counter on a cost entry would also break the reconciliation
13547
+ * that gives `load-contribution` its point: contributions are subtracted from
13548
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13549
+ * has no process.
13550
+ *
13551
+ * ## Why not a log line, since the counters already exist
13552
+ *
13553
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13554
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13555
+ * ends in a log line, and a log line is the thing the operator asked to stop
13556
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13557
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13558
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13559
+ * media blackout were both diagnosed. The counters stay; this is where they can
13560
+ * be READ.
13561
+ *
13562
+ * ## The rate is served with its denominator or not at all
13563
+ *
13564
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13565
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13566
+ * than yesterday" and was **flat across twelve hours** once divided by the
13567
+ * successes on the same path. A surface that publishes only the numerator
13568
+ * reproduces that mistake on every read.
13569
+ *
13570
+ * ## Shape
13571
+ *
13572
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13573
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13574
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13575
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13576
+ * a forked runner's entries reach hub-main over transport that already exists.
13577
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13578
+ * result through `system.getFailureContributions`.
13579
+ */
13580
+ var FailureReasonCountSchema = object({
13581
+ /**
13582
+ * Why the attempt did not land, in the contributor's own vocabulary —
13583
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13584
+ * strings that already appear in this repo's logs and, where one exists, the
13585
+ * same string the per-track `previewMissReason` records (D276): a second
13586
+ * vocabulary for the same loss would make the row and the counter
13587
+ * un-joinable.
13588
+ */
13589
+ reason: string(),
13590
+ count: number().int().nonnegative()
13591
+ });
13592
+ var FailureContributionSchema = object({
13593
+ /**
13594
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13595
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13596
+ * `unit` free: the families are owned by different addons and a shared enum
13597
+ * is a central list that rots invisibly.
13598
+ */
13599
+ family: string(),
13600
+ /**
13601
+ * The NUMERIC device id — the same value every log line carries as
13602
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13603
+ * cannot name the camera must not emit the entry, because a fleet total
13604
+ * cannot answer the only question anybody asks of this surface.
13605
+ */
13606
+ deviceId: number().int().positive(),
13607
+ /**
13608
+ * A second dimension inside the family: the model / step id for an inference
13609
+ * timeout, so "which camera AND which model" is one read. Absent when the
13610
+ * family has a single variant.
13611
+ */
13612
+ variant: string().optional(),
13613
+ /**
13614
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13615
+ * differencing two reads must drop the interval when it changes, because the
13616
+ * counter restarted from zero in a respawned runner. Same discipline as
13617
+ * `LoadContribution.startedAtMs`.
13618
+ */
13619
+ sinceMs: number(),
13620
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13621
+ atMs: number(),
13622
+ /**
13623
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13624
+ * window. A failure count published without it is the mistake this schema
13625
+ * exists to make impossible.
13626
+ */
13627
+ attempts: number().int().nonnegative(),
13628
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13629
+ succeeded: number().int().nonnegative(),
13630
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13631
+ reasons: array(FailureReasonCountSchema).readonly()
13632
+ });
13633
+ method(_void(), array(FailureContributionSchema).readonly());
13526
13634
  var LoadContributionSchema = object({
13527
13635
  role: _enum([
13528
13636
  "decode",
@@ -13830,6 +13938,50 @@ var NodeProcessSchema = object({
13830
13938
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13831
13939
  uptimeSec: number()
13832
13940
  });
13941
+ /**
13942
+ * One retained container-memory reading.
13943
+ *
13944
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13945
+ * a second clock: that is what makes "processes sum to X, container says Y"
13946
+ * subtractable per point rather than an eyeballed comparison of two series
13947
+ * sampled at different instants.
13948
+ *
13949
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13950
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13951
+ * never coexisted, and a mean would smear away the peak this exists to find.
13952
+ */
13953
+ var ContainerMemoryPointSchema = object({
13954
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13955
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13956
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13957
+ currentBytes: number(),
13958
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13959
+ limitBytes: number().nullable(),
13960
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13961
+ anonBytes: number().nullable(),
13962
+ /** Page cache. Charged to the cgroup, owned by no process. */
13963
+ fileBytes: number().nullable(),
13964
+ /**
13965
+ * Shared memory — and the field that explained the largest single surprise.
13966
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13967
+ * hardware-decode session holding DRM objects is charged HERE and appears
13968
+ * nowhere in a `ps` scan.
13969
+ */
13970
+ shmemBytes: number().nullable(),
13971
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13972
+ slabBytes: number().nullable(),
13973
+ /**
13974
+ * Shrinkable i915 GEM object bytes, from debugfs.
13975
+ *
13976
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13977
+ * component of `currentBytes` and must not be subtracted from it; it says
13978
+ * what put the shmem there, where `shmemBytes` only says how much.
13979
+ *
13980
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13981
+ * container today — and on any node with no Intel GPU.
13982
+ */
13983
+ gpuShmemBytes: number().nullable()
13984
+ }).extend({ atMs: number() });
13833
13985
  var DumpHeapSnapshotInputSchema = object({
13834
13986
  /** The addon whose runner should dump a heap snapshot. */
13835
13987
  addonId: string() });
@@ -13893,6 +14045,21 @@ var NodeLoadSeriesSchema = object({
13893
14045
  /** One entry per function seen in the window, heaviest-first. */
13894
14046
  series: array(LoadFunctionSeriesSchema).readonly(),
13895
14047
  /**
14048
+ * The CONTAINER's memory over the same window, oldest-first.
14049
+ *
14050
+ * Sits next to `series` rather than in a method of its own because the whole
14051
+ * question is a subtraction: the per-process rows in `series` sum to one
14052
+ * number and this one is another, and an operator who has to issue two calls
14053
+ * to compare them will compare two different instants. Same reader, same
14054
+ * `sinceMs`, same `bucketMs`, same timestamps.
14055
+ *
14056
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14057
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14058
+ * points at all. A zero here would be indistinguishable from a healthy
14059
+ * container and is precisely the lie this field exists to avoid.
14060
+ */
14061
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14062
+ /**
13896
14063
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13897
14064
  * reduction was needed — so a caller can always say what one point covers
13898
14065
  * without having to know whether it was reduced.
@@ -18113,6 +18280,20 @@ var TrackSchema = object({
18113
18280
  * `=== true` and render nothing otherwise — never infer "no rider".
18114
18281
  */
18115
18282
  hasRider: boolean().optional(),
18283
+ /**
18284
+ * WHY this track ended without a NATIVE best-shot tile
18285
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18286
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18287
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18288
+ * the late-keyFrame upgrade when a native tile lands after all. The
18289
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18290
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18291
+ *
18292
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18293
+ * that predates the field, and every track whose tile landed native all
18294
+ * omit it. Render nothing when absent.
18295
+ */
18296
+ previewMissReason: string().optional(),
18116
18297
  ...TrackFlagFields,
18117
18298
  ...TrackRetrainFields
18118
18299
  });
@@ -27686,10 +27867,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27686
27867
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27687
27868
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27688
27869
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27689
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27690
- * annotations that are not exposed here and must not be treated as an event
27691
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27692
- * (`interfaces/recording-config.ts`).
27870
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27871
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27872
+ * ever read them. Event<->footage joins are by time, padded with the shared
27873
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27693
27874
  */
27694
27875
  var RecordingStatusSchema = object({
27695
27876
  deviceId: number(),
@@ -29400,6 +29581,13 @@ var LoggingSettingsPatchSchema = object({
29400
29581
  * anyone but its owner.
29401
29582
  */
29402
29583
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29584
+ /**
29585
+ * One per-camera failure counter, plus WHO reported it.
29586
+ *
29587
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29588
+ * the hub as it enumerates providers, never by the contributor.
29589
+ */
29590
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29403
29591
  var GetLoggingSettingsInputSchema = object({
29404
29592
  scopeNodeId: string().optional(),
29405
29593
  /**
@@ -29458,7 +29646,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29458
29646
  }), method(_void(), SiteLocationStatusSchema, {
29459
29647
  kind: "mutation",
29460
29648
  auth: "admin"
29461
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29649
+ }), 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, {
29462
29650
  kind: "mutation",
29463
29651
  auth: "admin"
29464
29652
  });
@@ -33514,6 +33702,12 @@ Object.freeze({
33514
33702
  addonId: null,
33515
33703
  access: "create"
33516
33704
  },
33705
+ "failureContribution.list": {
33706
+ capName: "failure-contribution",
33707
+ capScope: "system",
33708
+ addonId: null,
33709
+ access: "view"
33710
+ },
33517
33711
  "fanControl.setDirection": {
33518
33712
  capName: "fan-control",
33519
33713
  capScope: "device",
@@ -36820,6 +37014,12 @@ Object.freeze({
36820
37014
  addonId: null,
36821
37015
  access: "create"
36822
37016
  },
37017
+ "system.getFailureContributions": {
37018
+ capName: "system",
37019
+ capScope: "system",
37020
+ addonId: null,
37021
+ access: "view"
37022
+ },
36823
37023
  "system.getLoadContributions": {
36824
37024
  capName: "system",
36825
37025
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13499,6 +13499,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13499
13499
  limit: number().optional(),
13500
13500
  tags: record(string(), string()).optional()
13501
13501
  }), array(LogEntrySchema).readonly());
13502
+ /**
13503
+ * `failure-contribution` — the capability an addon reports its OWN losses
13504
+ * through, per camera, with the denominator attached. It stores nothing.
13505
+ *
13506
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13507
+ *
13508
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13509
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13510
+ * copied: the contributor reports what it already knows, hub-main adds only
13511
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13512
+ * somebody to forget to edit.
13513
+ *
13514
+ * They are not merged, because their invariants are opposites:
13515
+ *
13516
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13517
+ * claim a camera cost nothing, which is a measurement nobody made;
13518
+ * - a `failure-contribution` zero is the **most valuable value on the
13519
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13520
+ * and it is exactly what an absent entry cannot say.
13521
+ *
13522
+ * Putting a loss counter on a cost entry would also break the reconciliation
13523
+ * that gives `load-contribution` its point: contributions are subtracted from
13524
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13525
+ * has no process.
13526
+ *
13527
+ * ## Why not a log line, since the counters already exist
13528
+ *
13529
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13530
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13531
+ * ends in a log line, and a log line is the thing the operator asked to stop
13532
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13533
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13534
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13535
+ * media blackout were both diagnosed. The counters stay; this is where they can
13536
+ * be READ.
13537
+ *
13538
+ * ## The rate is served with its denominator or not at all
13539
+ *
13540
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13541
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13542
+ * than yesterday" and was **flat across twelve hours** once divided by the
13543
+ * successes on the same path. A surface that publishes only the numerator
13544
+ * reproduces that mistake on every read.
13545
+ *
13546
+ * ## Shape
13547
+ *
13548
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13549
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13550
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13551
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13552
+ * a forked runner's entries reach hub-main over transport that already exists.
13553
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13554
+ * result through `system.getFailureContributions`.
13555
+ */
13556
+ var FailureReasonCountSchema = object({
13557
+ /**
13558
+ * Why the attempt did not land, in the contributor's own vocabulary —
13559
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13560
+ * strings that already appear in this repo's logs and, where one exists, the
13561
+ * same string the per-track `previewMissReason` records (D276): a second
13562
+ * vocabulary for the same loss would make the row and the counter
13563
+ * un-joinable.
13564
+ */
13565
+ reason: string(),
13566
+ count: number().int().nonnegative()
13567
+ });
13568
+ var FailureContributionSchema = object({
13569
+ /**
13570
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13571
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13572
+ * `unit` free: the families are owned by different addons and a shared enum
13573
+ * is a central list that rots invisibly.
13574
+ */
13575
+ family: string(),
13576
+ /**
13577
+ * The NUMERIC device id — the same value every log line carries as
13578
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13579
+ * cannot name the camera must not emit the entry, because a fleet total
13580
+ * cannot answer the only question anybody asks of this surface.
13581
+ */
13582
+ deviceId: number().int().positive(),
13583
+ /**
13584
+ * A second dimension inside the family: the model / step id for an inference
13585
+ * timeout, so "which camera AND which model" is one read. Absent when the
13586
+ * family has a single variant.
13587
+ */
13588
+ variant: string().optional(),
13589
+ /**
13590
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13591
+ * differencing two reads must drop the interval when it changes, because the
13592
+ * counter restarted from zero in a respawned runner. Same discipline as
13593
+ * `LoadContribution.startedAtMs`.
13594
+ */
13595
+ sinceMs: number(),
13596
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13597
+ atMs: number(),
13598
+ /**
13599
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13600
+ * window. A failure count published without it is the mistake this schema
13601
+ * exists to make impossible.
13602
+ */
13603
+ attempts: number().int().nonnegative(),
13604
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13605
+ succeeded: number().int().nonnegative(),
13606
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13607
+ reasons: array(FailureReasonCountSchema).readonly()
13608
+ });
13609
+ method(_void(), array(FailureContributionSchema).readonly());
13502
13610
  var LoadContributionSchema = object({
13503
13611
  role: _enum([
13504
13612
  "decode",
@@ -13806,6 +13914,50 @@ var NodeProcessSchema = object({
13806
13914
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13807
13915
  uptimeSec: number()
13808
13916
  });
13917
+ /**
13918
+ * One retained container-memory reading.
13919
+ *
13920
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13921
+ * a second clock: that is what makes "processes sum to X, container says Y"
13922
+ * subtractable per point rather than an eyeballed comparison of two series
13923
+ * sampled at different instants.
13924
+ *
13925
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13926
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13927
+ * never coexisted, and a mean would smear away the peak this exists to find.
13928
+ */
13929
+ var ContainerMemoryPointSchema = object({
13930
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13931
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13932
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13933
+ currentBytes: number(),
13934
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13935
+ limitBytes: number().nullable(),
13936
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13937
+ anonBytes: number().nullable(),
13938
+ /** Page cache. Charged to the cgroup, owned by no process. */
13939
+ fileBytes: number().nullable(),
13940
+ /**
13941
+ * Shared memory — and the field that explained the largest single surprise.
13942
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13943
+ * hardware-decode session holding DRM objects is charged HERE and appears
13944
+ * nowhere in a `ps` scan.
13945
+ */
13946
+ shmemBytes: number().nullable(),
13947
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13948
+ slabBytes: number().nullable(),
13949
+ /**
13950
+ * Shrinkable i915 GEM object bytes, from debugfs.
13951
+ *
13952
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13953
+ * component of `currentBytes` and must not be subtracted from it; it says
13954
+ * what put the shmem there, where `shmemBytes` only says how much.
13955
+ *
13956
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13957
+ * container today — and on any node with no Intel GPU.
13958
+ */
13959
+ gpuShmemBytes: number().nullable()
13960
+ }).extend({ atMs: number() });
13809
13961
  var DumpHeapSnapshotInputSchema = object({
13810
13962
  /** The addon whose runner should dump a heap snapshot. */
13811
13963
  addonId: string() });
@@ -13869,6 +14021,21 @@ var NodeLoadSeriesSchema = object({
13869
14021
  /** One entry per function seen in the window, heaviest-first. */
13870
14022
  series: array(LoadFunctionSeriesSchema).readonly(),
13871
14023
  /**
14024
+ * The CONTAINER's memory over the same window, oldest-first.
14025
+ *
14026
+ * Sits next to `series` rather than in a method of its own because the whole
14027
+ * question is a subtraction: the per-process rows in `series` sum to one
14028
+ * number and this one is another, and an operator who has to issue two calls
14029
+ * to compare them will compare two different instants. Same reader, same
14030
+ * `sinceMs`, same `bucketMs`, same timestamps.
14031
+ *
14032
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14033
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14034
+ * points at all. A zero here would be indistinguishable from a healthy
14035
+ * container and is precisely the lie this field exists to avoid.
14036
+ */
14037
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14038
+ /**
13872
14039
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13873
14040
  * reduction was needed — so a caller can always say what one point covers
13874
14041
  * without having to know whether it was reduced.
@@ -18089,6 +18256,20 @@ var TrackSchema = object({
18089
18256
  * `=== true` and render nothing otherwise — never infer "no rider".
18090
18257
  */
18091
18258
  hasRider: boolean().optional(),
18259
+ /**
18260
+ * WHY this track ended without a NATIVE best-shot tile
18261
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18262
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18263
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18264
+ * the late-keyFrame upgrade when a native tile lands after all. The
18265
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18266
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18267
+ *
18268
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18269
+ * that predates the field, and every track whose tile landed native all
18270
+ * omit it. Render nothing when absent.
18271
+ */
18272
+ previewMissReason: string().optional(),
18092
18273
  ...TrackFlagFields,
18093
18274
  ...TrackRetrainFields
18094
18275
  });
@@ -27662,10 +27843,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27662
27843
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27663
27844
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27664
27845
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27665
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27666
- * annotations that are not exposed here and must not be treated as an event
27667
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27668
- * (`interfaces/recording-config.ts`).
27846
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27847
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27848
+ * ever read them. Event<->footage joins are by time, padded with the shared
27849
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27669
27850
  */
27670
27851
  var RecordingStatusSchema = object({
27671
27852
  deviceId: number(),
@@ -29376,6 +29557,13 @@ var LoggingSettingsPatchSchema = object({
29376
29557
  * anyone but its owner.
29377
29558
  */
29378
29559
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29560
+ /**
29561
+ * One per-camera failure counter, plus WHO reported it.
29562
+ *
29563
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29564
+ * the hub as it enumerates providers, never by the contributor.
29565
+ */
29566
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29379
29567
  var GetLoggingSettingsInputSchema = object({
29380
29568
  scopeNodeId: string().optional(),
29381
29569
  /**
@@ -29434,7 +29622,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29434
29622
  }), method(_void(), SiteLocationStatusSchema, {
29435
29623
  kind: "mutation",
29436
29624
  auth: "admin"
29437
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29625
+ }), 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, {
29438
29626
  kind: "mutation",
29439
29627
  auth: "admin"
29440
29628
  });
@@ -33490,6 +33678,12 @@ Object.freeze({
33490
33678
  addonId: null,
33491
33679
  access: "create"
33492
33680
  },
33681
+ "failureContribution.list": {
33682
+ capName: "failure-contribution",
33683
+ capScope: "system",
33684
+ addonId: null,
33685
+ access: "view"
33686
+ },
33493
33687
  "fanControl.setDirection": {
33494
33688
  capName: "fan-control",
33495
33689
  capScope: "device",
@@ -36796,6 +36990,12 @@ Object.freeze({
36796
36990
  addonId: null,
36797
36991
  access: "create"
36798
36992
  },
36993
+ "system.getFailureContributions": {
36994
+ capName: "system",
36995
+ capScope: "system",
36996
+ addonId: null,
36997
+ access: "view"
36998
+ },
36799
36999
  "system.getLoadContributions": {
36800
37000
  capName: "system",
36801
37001
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rtsp",
3
- "version": "1.2.38",
3
+ "version": "1.2.41",
4
4
  "description": "Generic RTSP camera device provider addon for CamStack",
5
5
  "keywords": [
6
6
  "camstack",