@camstack/addon-provider-amcrest 0.2.39 → 0.2.42

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
@@ -13460,6 +13460,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13460
13460
  limit: number().optional(),
13461
13461
  tags: record(string(), string()).optional()
13462
13462
  }), array(LogEntrySchema).readonly());
13463
+ /**
13464
+ * `failure-contribution` — the capability an addon reports its OWN losses
13465
+ * through, per camera, with the denominator attached. It stores nothing.
13466
+ *
13467
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13468
+ *
13469
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13470
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13471
+ * copied: the contributor reports what it already knows, hub-main adds only
13472
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13473
+ * somebody to forget to edit.
13474
+ *
13475
+ * They are not merged, because their invariants are opposites:
13476
+ *
13477
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13478
+ * claim a camera cost nothing, which is a measurement nobody made;
13479
+ * - a `failure-contribution` zero is the **most valuable value on the
13480
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13481
+ * and it is exactly what an absent entry cannot say.
13482
+ *
13483
+ * Putting a loss counter on a cost entry would also break the reconciliation
13484
+ * that gives `load-contribution` its point: contributions are subtracted from
13485
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13486
+ * has no process.
13487
+ *
13488
+ * ## Why not a log line, since the counters already exist
13489
+ *
13490
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13491
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13492
+ * ends in a log line, and a log line is the thing the operator asked to stop
13493
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13494
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13495
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13496
+ * media blackout were both diagnosed. The counters stay; this is where they can
13497
+ * be READ.
13498
+ *
13499
+ * ## The rate is served with its denominator or not at all
13500
+ *
13501
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13502
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13503
+ * than yesterday" and was **flat across twelve hours** once divided by the
13504
+ * successes on the same path. A surface that publishes only the numerator
13505
+ * reproduces that mistake on every read.
13506
+ *
13507
+ * ## Shape
13508
+ *
13509
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13510
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13511
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13512
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13513
+ * a forked runner's entries reach hub-main over transport that already exists.
13514
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13515
+ * result through `system.getFailureContributions`.
13516
+ */
13517
+ var FailureReasonCountSchema = object({
13518
+ /**
13519
+ * Why the attempt did not land, in the contributor's own vocabulary —
13520
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13521
+ * strings that already appear in this repo's logs and, where one exists, the
13522
+ * same string the per-track `previewMissReason` records (D276): a second
13523
+ * vocabulary for the same loss would make the row and the counter
13524
+ * un-joinable.
13525
+ */
13526
+ reason: string(),
13527
+ count: number().int().nonnegative()
13528
+ });
13529
+ var FailureContributionSchema = object({
13530
+ /**
13531
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13532
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13533
+ * `unit` free: the families are owned by different addons and a shared enum
13534
+ * is a central list that rots invisibly.
13535
+ */
13536
+ family: string(),
13537
+ /**
13538
+ * The NUMERIC device id — the same value every log line carries as
13539
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13540
+ * cannot name the camera must not emit the entry, because a fleet total
13541
+ * cannot answer the only question anybody asks of this surface.
13542
+ */
13543
+ deviceId: number().int().positive(),
13544
+ /**
13545
+ * A second dimension inside the family: the model / step id for an inference
13546
+ * timeout, so "which camera AND which model" is one read. Absent when the
13547
+ * family has a single variant.
13548
+ */
13549
+ variant: string().optional(),
13550
+ /**
13551
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13552
+ * differencing two reads must drop the interval when it changes, because the
13553
+ * counter restarted from zero in a respawned runner. Same discipline as
13554
+ * `LoadContribution.startedAtMs`.
13555
+ */
13556
+ sinceMs: number(),
13557
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13558
+ atMs: number(),
13559
+ /**
13560
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13561
+ * window. A failure count published without it is the mistake this schema
13562
+ * exists to make impossible.
13563
+ */
13564
+ attempts: number().int().nonnegative(),
13565
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13566
+ succeeded: number().int().nonnegative(),
13567
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13568
+ reasons: array(FailureReasonCountSchema).readonly()
13569
+ });
13570
+ method(_void(), array(FailureContributionSchema).readonly());
13463
13571
  var LoadContributionSchema = object({
13464
13572
  role: _enum([
13465
13573
  "decode",
@@ -13767,6 +13875,50 @@ var NodeProcessSchema = object({
13767
13875
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13768
13876
  uptimeSec: number()
13769
13877
  });
13878
+ /**
13879
+ * One retained container-memory reading.
13880
+ *
13881
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13882
+ * a second clock: that is what makes "processes sum to X, container says Y"
13883
+ * subtractable per point rather than an eyeballed comparison of two series
13884
+ * sampled at different instants.
13885
+ *
13886
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13887
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13888
+ * never coexisted, and a mean would smear away the peak this exists to find.
13889
+ */
13890
+ var ContainerMemoryPointSchema = object({
13891
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13892
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13893
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13894
+ currentBytes: number(),
13895
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13896
+ limitBytes: number().nullable(),
13897
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13898
+ anonBytes: number().nullable(),
13899
+ /** Page cache. Charged to the cgroup, owned by no process. */
13900
+ fileBytes: number().nullable(),
13901
+ /**
13902
+ * Shared memory — and the field that explained the largest single surprise.
13903
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13904
+ * hardware-decode session holding DRM objects is charged HERE and appears
13905
+ * nowhere in a `ps` scan.
13906
+ */
13907
+ shmemBytes: number().nullable(),
13908
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13909
+ slabBytes: number().nullable(),
13910
+ /**
13911
+ * Shrinkable i915 GEM object bytes, from debugfs.
13912
+ *
13913
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13914
+ * component of `currentBytes` and must not be subtracted from it; it says
13915
+ * what put the shmem there, where `shmemBytes` only says how much.
13916
+ *
13917
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13918
+ * container today — and on any node with no Intel GPU.
13919
+ */
13920
+ gpuShmemBytes: number().nullable()
13921
+ }).extend({ atMs: number() });
13770
13922
  var DumpHeapSnapshotInputSchema = object({
13771
13923
  /** The addon whose runner should dump a heap snapshot. */
13772
13924
  addonId: string() });
@@ -13830,6 +13982,21 @@ var NodeLoadSeriesSchema = object({
13830
13982
  /** One entry per function seen in the window, heaviest-first. */
13831
13983
  series: array(LoadFunctionSeriesSchema).readonly(),
13832
13984
  /**
13985
+ * The CONTAINER's memory over the same window, oldest-first.
13986
+ *
13987
+ * Sits next to `series` rather than in a method of its own because the whole
13988
+ * question is a subtraction: the per-process rows in `series` sum to one
13989
+ * number and this one is another, and an operator who has to issue two calls
13990
+ * to compare them will compare two different instants. Same reader, same
13991
+ * `sinceMs`, same `bucketMs`, same timestamps.
13992
+ *
13993
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13994
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13995
+ * points at all. A zero here would be indistinguishable from a healthy
13996
+ * container and is precisely the lie this field exists to avoid.
13997
+ */
13998
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13999
+ /**
13833
14000
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13834
14001
  * reduction was needed — so a caller can always say what one point covers
13835
14002
  * without having to know whether it was reduced.
@@ -18050,6 +18217,20 @@ var TrackSchema = object({
18050
18217
  * `=== true` and render nothing otherwise — never infer "no rider".
18051
18218
  */
18052
18219
  hasRider: boolean().optional(),
18220
+ /**
18221
+ * WHY this track ended without a NATIVE best-shot tile
18222
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18223
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18224
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18225
+ * the late-keyFrame upgrade when a native tile lands after all. The
18226
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18227
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18228
+ *
18229
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18230
+ * that predates the field, and every track whose tile landed native all
18231
+ * omit it. Render nothing when absent.
18232
+ */
18233
+ previewMissReason: string().optional(),
18053
18234
  ...TrackFlagFields,
18054
18235
  ...TrackRetrainFields
18055
18236
  });
@@ -27703,10 +27884,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27703
27884
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27704
27885
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27705
27886
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27706
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27707
- * annotations that are not exposed here and must not be treated as an event
27708
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27709
- * (`interfaces/recording-config.ts`).
27887
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27888
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27889
+ * ever read them. Event<->footage joins are by time, padded with the shared
27890
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27710
27891
  */
27711
27892
  var RecordingStatusSchema = object({
27712
27893
  deviceId: number(),
@@ -29615,6 +29796,13 @@ var LoggingSettingsPatchSchema = object({
29615
29796
  * anyone but its owner.
29616
29797
  */
29617
29798
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29799
+ /**
29800
+ * One per-camera failure counter, plus WHO reported it.
29801
+ *
29802
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29803
+ * the hub as it enumerates providers, never by the contributor.
29804
+ */
29805
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29618
29806
  var GetLoggingSettingsInputSchema = object({
29619
29807
  scopeNodeId: string().optional(),
29620
29808
  /**
@@ -29673,7 +29861,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29673
29861
  }), method(_void(), SiteLocationStatusSchema, {
29674
29862
  kind: "mutation",
29675
29863
  auth: "admin"
29676
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29864
+ }), 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, {
29677
29865
  kind: "mutation",
29678
29866
  auth: "admin"
29679
29867
  });
@@ -33869,6 +34057,12 @@ Object.freeze({
33869
34057
  addonId: null,
33870
34058
  access: "create"
33871
34059
  },
34060
+ "failureContribution.list": {
34061
+ capName: "failure-contribution",
34062
+ capScope: "system",
34063
+ addonId: null,
34064
+ access: "view"
34065
+ },
33872
34066
  "fanControl.setDirection": {
33873
34067
  capName: "fan-control",
33874
34068
  capScope: "device",
@@ -37175,6 +37369,12 @@ Object.freeze({
37175
37369
  addonId: null,
37176
37370
  access: "create"
37177
37371
  },
37372
+ "system.getFailureContributions": {
37373
+ capName: "system",
37374
+ capScope: "system",
37375
+ addonId: null,
37376
+ access: "view"
37377
+ },
37178
37378
  "system.getLoadContributions": {
37179
37379
  capName: "system",
37180
37380
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13461,6 +13461,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13461
13461
  limit: number().optional(),
13462
13462
  tags: record(string(), string()).optional()
13463
13463
  }), array(LogEntrySchema).readonly());
13464
+ /**
13465
+ * `failure-contribution` — the capability an addon reports its OWN losses
13466
+ * through, per camera, with the denominator attached. It stores nothing.
13467
+ *
13468
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13469
+ *
13470
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13471
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13472
+ * copied: the contributor reports what it already knows, hub-main adds only
13473
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13474
+ * somebody to forget to edit.
13475
+ *
13476
+ * They are not merged, because their invariants are opposites:
13477
+ *
13478
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13479
+ * claim a camera cost nothing, which is a measurement nobody made;
13480
+ * - a `failure-contribution` zero is the **most valuable value on the
13481
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13482
+ * and it is exactly what an absent entry cannot say.
13483
+ *
13484
+ * Putting a loss counter on a cost entry would also break the reconciliation
13485
+ * that gives `load-contribution` its point: contributions are subtracted from
13486
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13487
+ * has no process.
13488
+ *
13489
+ * ## Why not a log line, since the counters already exist
13490
+ *
13491
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13492
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13493
+ * ends in a log line, and a log line is the thing the operator asked to stop
13494
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13495
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13496
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13497
+ * media blackout were both diagnosed. The counters stay; this is where they can
13498
+ * be READ.
13499
+ *
13500
+ * ## The rate is served with its denominator or not at all
13501
+ *
13502
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13503
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13504
+ * than yesterday" and was **flat across twelve hours** once divided by the
13505
+ * successes on the same path. A surface that publishes only the numerator
13506
+ * reproduces that mistake on every read.
13507
+ *
13508
+ * ## Shape
13509
+ *
13510
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13511
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13512
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13513
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13514
+ * a forked runner's entries reach hub-main over transport that already exists.
13515
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13516
+ * result through `system.getFailureContributions`.
13517
+ */
13518
+ var FailureReasonCountSchema = object({
13519
+ /**
13520
+ * Why the attempt did not land, in the contributor's own vocabulary —
13521
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13522
+ * strings that already appear in this repo's logs and, where one exists, the
13523
+ * same string the per-track `previewMissReason` records (D276): a second
13524
+ * vocabulary for the same loss would make the row and the counter
13525
+ * un-joinable.
13526
+ */
13527
+ reason: string(),
13528
+ count: number().int().nonnegative()
13529
+ });
13530
+ var FailureContributionSchema = object({
13531
+ /**
13532
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13533
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13534
+ * `unit` free: the families are owned by different addons and a shared enum
13535
+ * is a central list that rots invisibly.
13536
+ */
13537
+ family: string(),
13538
+ /**
13539
+ * The NUMERIC device id — the same value every log line carries as
13540
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13541
+ * cannot name the camera must not emit the entry, because a fleet total
13542
+ * cannot answer the only question anybody asks of this surface.
13543
+ */
13544
+ deviceId: number().int().positive(),
13545
+ /**
13546
+ * A second dimension inside the family: the model / step id for an inference
13547
+ * timeout, so "which camera AND which model" is one read. Absent when the
13548
+ * family has a single variant.
13549
+ */
13550
+ variant: string().optional(),
13551
+ /**
13552
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13553
+ * differencing two reads must drop the interval when it changes, because the
13554
+ * counter restarted from zero in a respawned runner. Same discipline as
13555
+ * `LoadContribution.startedAtMs`.
13556
+ */
13557
+ sinceMs: number(),
13558
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13559
+ atMs: number(),
13560
+ /**
13561
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13562
+ * window. A failure count published without it is the mistake this schema
13563
+ * exists to make impossible.
13564
+ */
13565
+ attempts: number().int().nonnegative(),
13566
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13567
+ succeeded: number().int().nonnegative(),
13568
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13569
+ reasons: array(FailureReasonCountSchema).readonly()
13570
+ });
13571
+ method(_void(), array(FailureContributionSchema).readonly());
13464
13572
  var LoadContributionSchema = object({
13465
13573
  role: _enum([
13466
13574
  "decode",
@@ -13768,6 +13876,50 @@ var NodeProcessSchema = object({
13768
13876
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13769
13877
  uptimeSec: number()
13770
13878
  });
13879
+ /**
13880
+ * One retained container-memory reading.
13881
+ *
13882
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13883
+ * a second clock: that is what makes "processes sum to X, container says Y"
13884
+ * subtractable per point rather than an eyeballed comparison of two series
13885
+ * sampled at different instants.
13886
+ *
13887
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13888
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13889
+ * never coexisted, and a mean would smear away the peak this exists to find.
13890
+ */
13891
+ var ContainerMemoryPointSchema = object({
13892
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13893
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13894
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13895
+ currentBytes: number(),
13896
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13897
+ limitBytes: number().nullable(),
13898
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13899
+ anonBytes: number().nullable(),
13900
+ /** Page cache. Charged to the cgroup, owned by no process. */
13901
+ fileBytes: number().nullable(),
13902
+ /**
13903
+ * Shared memory — and the field that explained the largest single surprise.
13904
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13905
+ * hardware-decode session holding DRM objects is charged HERE and appears
13906
+ * nowhere in a `ps` scan.
13907
+ */
13908
+ shmemBytes: number().nullable(),
13909
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13910
+ slabBytes: number().nullable(),
13911
+ /**
13912
+ * Shrinkable i915 GEM object bytes, from debugfs.
13913
+ *
13914
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13915
+ * component of `currentBytes` and must not be subtracted from it; it says
13916
+ * what put the shmem there, where `shmemBytes` only says how much.
13917
+ *
13918
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13919
+ * container today — and on any node with no Intel GPU.
13920
+ */
13921
+ gpuShmemBytes: number().nullable()
13922
+ }).extend({ atMs: number() });
13771
13923
  var DumpHeapSnapshotInputSchema = object({
13772
13924
  /** The addon whose runner should dump a heap snapshot. */
13773
13925
  addonId: string() });
@@ -13831,6 +13983,21 @@ var NodeLoadSeriesSchema = object({
13831
13983
  /** One entry per function seen in the window, heaviest-first. */
13832
13984
  series: array(LoadFunctionSeriesSchema).readonly(),
13833
13985
  /**
13986
+ * The CONTAINER's memory over the same window, oldest-first.
13987
+ *
13988
+ * Sits next to `series` rather than in a method of its own because the whole
13989
+ * question is a subtraction: the per-process rows in `series` sum to one
13990
+ * number and this one is another, and an operator who has to issue two calls
13991
+ * to compare them will compare two different instants. Same reader, same
13992
+ * `sinceMs`, same `bucketMs`, same timestamps.
13993
+ *
13994
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13995
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13996
+ * points at all. A zero here would be indistinguishable from a healthy
13997
+ * container and is precisely the lie this field exists to avoid.
13998
+ */
13999
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14000
+ /**
13834
14001
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13835
14002
  * reduction was needed — so a caller can always say what one point covers
13836
14003
  * without having to know whether it was reduced.
@@ -18051,6 +18218,20 @@ var TrackSchema = object({
18051
18218
  * `=== true` and render nothing otherwise — never infer "no rider".
18052
18219
  */
18053
18220
  hasRider: boolean().optional(),
18221
+ /**
18222
+ * WHY this track ended without a NATIVE best-shot tile
18223
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18224
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18225
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18226
+ * the late-keyFrame upgrade when a native tile lands after all. The
18227
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18228
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18229
+ *
18230
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18231
+ * that predates the field, and every track whose tile landed native all
18232
+ * omit it. Render nothing when absent.
18233
+ */
18234
+ previewMissReason: string().optional(),
18054
18235
  ...TrackFlagFields,
18055
18236
  ...TrackRetrainFields
18056
18237
  });
@@ -27704,10 +27885,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27704
27885
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27705
27886
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27706
27887
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27707
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27708
- * annotations that are not exposed here and must not be treated as an event
27709
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27710
- * (`interfaces/recording-config.ts`).
27888
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27889
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27890
+ * ever read them. Event<->footage joins are by time, padded with the shared
27891
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27711
27892
  */
27712
27893
  var RecordingStatusSchema = object({
27713
27894
  deviceId: number(),
@@ -29616,6 +29797,13 @@ var LoggingSettingsPatchSchema = object({
29616
29797
  * anyone but its owner.
29617
29798
  */
29618
29799
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29800
+ /**
29801
+ * One per-camera failure counter, plus WHO reported it.
29802
+ *
29803
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29804
+ * the hub as it enumerates providers, never by the contributor.
29805
+ */
29806
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29619
29807
  var GetLoggingSettingsInputSchema = object({
29620
29808
  scopeNodeId: string().optional(),
29621
29809
  /**
@@ -29674,7 +29862,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29674
29862
  }), method(_void(), SiteLocationStatusSchema, {
29675
29863
  kind: "mutation",
29676
29864
  auth: "admin"
29677
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29865
+ }), 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, {
29678
29866
  kind: "mutation",
29679
29867
  auth: "admin"
29680
29868
  });
@@ -33870,6 +34058,12 @@ Object.freeze({
33870
34058
  addonId: null,
33871
34059
  access: "create"
33872
34060
  },
34061
+ "failureContribution.list": {
34062
+ capName: "failure-contribution",
34063
+ capScope: "system",
34064
+ addonId: null,
34065
+ access: "view"
34066
+ },
33873
34067
  "fanControl.setDirection": {
33874
34068
  capName: "fan-control",
33875
34069
  capScope: "device",
@@ -37176,6 +37370,12 @@ Object.freeze({
37176
37370
  addonId: null,
37177
37371
  access: "create"
37178
37372
  },
37373
+ "system.getFailureContributions": {
37374
+ capName: "system",
37375
+ capScope: "system",
37376
+ addonId: null,
37377
+ access: "view"
37378
+ },
37179
37379
  "system.getLoadContributions": {
37180
37380
  capName: "system",
37181
37381
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-amcrest",
3
- "version": "0.2.39",
3
+ "version": "0.2.42",
4
4
  "description": "Amcrest/Dahua camera device provider addon for CamStack — Dahua CGI over HTTP(S) with digest auth (snapshot, RTSP catalog, PTZ, image/day-night config)",
5
5
  "keywords": [
6
6
  "camstack",