@camstack/addon-smtp-nodemailer 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.
@@ -13224,6 +13224,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13224
13224
  limit: number().optional(),
13225
13225
  tags: record(string(), string()).optional()
13226
13226
  }), array(LogEntrySchema).readonly());
13227
+ /**
13228
+ * `failure-contribution` — the capability an addon reports its OWN losses
13229
+ * through, per camera, with the denominator attached. It stores nothing.
13230
+ *
13231
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13232
+ *
13233
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13234
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13235
+ * copied: the contributor reports what it already knows, hub-main adds only
13236
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13237
+ * somebody to forget to edit.
13238
+ *
13239
+ * They are not merged, because their invariants are opposites:
13240
+ *
13241
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13242
+ * claim a camera cost nothing, which is a measurement nobody made;
13243
+ * - a `failure-contribution` zero is the **most valuable value on the
13244
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13245
+ * and it is exactly what an absent entry cannot say.
13246
+ *
13247
+ * Putting a loss counter on a cost entry would also break the reconciliation
13248
+ * that gives `load-contribution` its point: contributions are subtracted from
13249
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13250
+ * has no process.
13251
+ *
13252
+ * ## Why not a log line, since the counters already exist
13253
+ *
13254
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13255
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13256
+ * ends in a log line, and a log line is the thing the operator asked to stop
13257
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13258
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13259
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13260
+ * media blackout were both diagnosed. The counters stay; this is where they can
13261
+ * be READ.
13262
+ *
13263
+ * ## The rate is served with its denominator or not at all
13264
+ *
13265
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13266
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13267
+ * than yesterday" and was **flat across twelve hours** once divided by the
13268
+ * successes on the same path. A surface that publishes only the numerator
13269
+ * reproduces that mistake on every read.
13270
+ *
13271
+ * ## Shape
13272
+ *
13273
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13274
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13275
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13276
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13277
+ * a forked runner's entries reach hub-main over transport that already exists.
13278
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13279
+ * result through `system.getFailureContributions`.
13280
+ */
13281
+ var FailureReasonCountSchema = object({
13282
+ /**
13283
+ * Why the attempt did not land, in the contributor's own vocabulary —
13284
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13285
+ * strings that already appear in this repo's logs and, where one exists, the
13286
+ * same string the per-track `previewMissReason` records (D276): a second
13287
+ * vocabulary for the same loss would make the row and the counter
13288
+ * un-joinable.
13289
+ */
13290
+ reason: string(),
13291
+ count: number().int().nonnegative()
13292
+ });
13293
+ var FailureContributionSchema = object({
13294
+ /**
13295
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13296
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13297
+ * `unit` free: the families are owned by different addons and a shared enum
13298
+ * is a central list that rots invisibly.
13299
+ */
13300
+ family: string(),
13301
+ /**
13302
+ * The NUMERIC device id — the same value every log line carries as
13303
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13304
+ * cannot name the camera must not emit the entry, because a fleet total
13305
+ * cannot answer the only question anybody asks of this surface.
13306
+ */
13307
+ deviceId: number().int().positive(),
13308
+ /**
13309
+ * A second dimension inside the family: the model / step id for an inference
13310
+ * timeout, so "which camera AND which model" is one read. Absent when the
13311
+ * family has a single variant.
13312
+ */
13313
+ variant: string().optional(),
13314
+ /**
13315
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13316
+ * differencing two reads must drop the interval when it changes, because the
13317
+ * counter restarted from zero in a respawned runner. Same discipline as
13318
+ * `LoadContribution.startedAtMs`.
13319
+ */
13320
+ sinceMs: number(),
13321
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13322
+ atMs: number(),
13323
+ /**
13324
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13325
+ * window. A failure count published without it is the mistake this schema
13326
+ * exists to make impossible.
13327
+ */
13328
+ attempts: number().int().nonnegative(),
13329
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13330
+ succeeded: number().int().nonnegative(),
13331
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13332
+ reasons: array(FailureReasonCountSchema).readonly()
13333
+ });
13334
+ method(_void(), array(FailureContributionSchema).readonly());
13227
13335
  var LoadContributionSchema = object({
13228
13336
  role: _enum([
13229
13337
  "decode",
@@ -13531,6 +13639,50 @@ var NodeProcessSchema = object({
13531
13639
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13532
13640
  uptimeSec: number()
13533
13641
  });
13642
+ /**
13643
+ * One retained container-memory reading.
13644
+ *
13645
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13646
+ * a second clock: that is what makes "processes sum to X, container says Y"
13647
+ * subtractable per point rather than an eyeballed comparison of two series
13648
+ * sampled at different instants.
13649
+ *
13650
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13651
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13652
+ * never coexisted, and a mean would smear away the peak this exists to find.
13653
+ */
13654
+ var ContainerMemoryPointSchema = object({
13655
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13656
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13657
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13658
+ currentBytes: number(),
13659
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13660
+ limitBytes: number().nullable(),
13661
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13662
+ anonBytes: number().nullable(),
13663
+ /** Page cache. Charged to the cgroup, owned by no process. */
13664
+ fileBytes: number().nullable(),
13665
+ /**
13666
+ * Shared memory — and the field that explained the largest single surprise.
13667
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13668
+ * hardware-decode session holding DRM objects is charged HERE and appears
13669
+ * nowhere in a `ps` scan.
13670
+ */
13671
+ shmemBytes: number().nullable(),
13672
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13673
+ slabBytes: number().nullable(),
13674
+ /**
13675
+ * Shrinkable i915 GEM object bytes, from debugfs.
13676
+ *
13677
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13678
+ * component of `currentBytes` and must not be subtracted from it; it says
13679
+ * what put the shmem there, where `shmemBytes` only says how much.
13680
+ *
13681
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13682
+ * container today — and on any node with no Intel GPU.
13683
+ */
13684
+ gpuShmemBytes: number().nullable()
13685
+ }).extend({ atMs: number() });
13534
13686
  var DumpHeapSnapshotInputSchema = object({
13535
13687
  /** The addon whose runner should dump a heap snapshot. */
13536
13688
  addonId: string() });
@@ -13594,6 +13746,21 @@ var NodeLoadSeriesSchema = object({
13594
13746
  /** One entry per function seen in the window, heaviest-first. */
13595
13747
  series: array(LoadFunctionSeriesSchema).readonly(),
13596
13748
  /**
13749
+ * The CONTAINER's memory over the same window, oldest-first.
13750
+ *
13751
+ * Sits next to `series` rather than in a method of its own because the whole
13752
+ * question is a subtraction: the per-process rows in `series` sum to one
13753
+ * number and this one is another, and an operator who has to issue two calls
13754
+ * to compare them will compare two different instants. Same reader, same
13755
+ * `sinceMs`, same `bucketMs`, same timestamps.
13756
+ *
13757
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13758
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13759
+ * points at all. A zero here would be indistinguishable from a healthy
13760
+ * container and is precisely the lie this field exists to avoid.
13761
+ */
13762
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13763
+ /**
13597
13764
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13598
13765
  * reduction was needed — so a caller can always say what one point covers
13599
13766
  * without having to know whether it was reduced.
@@ -17736,6 +17903,20 @@ var TrackSchema = object({
17736
17903
  * `=== true` and render nothing otherwise — never infer "no rider".
17737
17904
  */
17738
17905
  hasRider: boolean().optional(),
17906
+ /**
17907
+ * WHY this track ended without a NATIVE best-shot tile
17908
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
17909
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
17910
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
17911
+ * the late-keyFrame upgrade when a native tile lands after all. The
17912
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
17913
+ * tile is a face/plate stand-in, a raster crop, or an icon.
17914
+ *
17915
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
17916
+ * that predates the field, and every track whose tile landed native all
17917
+ * omit it. Render nothing when absent.
17918
+ */
17919
+ previewMissReason: string().optional(),
17739
17920
  ...TrackFlagFields,
17740
17921
  ...TrackRetrainFields
17741
17922
  });
@@ -25522,10 +25703,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25522
25703
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25523
25704
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25524
25705
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25525
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25526
- * annotations that are not exposed here and must not be treated as an event
25527
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25528
- * (`interfaces/recording-config.ts`).
25706
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
25707
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25708
+ * ever read them. Event<->footage joins are by time, padded with the shared
25709
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25529
25710
  */
25530
25711
  var RecordingStatusSchema = object({
25531
25712
  deviceId: number(),
@@ -26975,6 +27156,13 @@ var LoggingSettingsPatchSchema = object({
26975
27156
  * anyone but its owner.
26976
27157
  */
26977
27158
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27159
+ /**
27160
+ * One per-camera failure counter, plus WHO reported it.
27161
+ *
27162
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27163
+ * the hub as it enumerates providers, never by the contributor.
27164
+ */
27165
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
26978
27166
  var GetLoggingSettingsInputSchema = object({
26979
27167
  scopeNodeId: string().optional(),
26980
27168
  /**
@@ -27033,7 +27221,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27033
27221
  }), method(_void(), SiteLocationStatusSchema, {
27034
27222
  kind: "mutation",
27035
27223
  auth: "admin"
27036
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27224
+ }), 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, {
27037
27225
  kind: "mutation",
27038
27226
  auth: "admin"
27039
27227
  });
@@ -29615,6 +29803,12 @@ Object.freeze({
29615
29803
  addonId: null,
29616
29804
  access: "create"
29617
29805
  },
29806
+ "failureContribution.list": {
29807
+ capName: "failure-contribution",
29808
+ capScope: "system",
29809
+ addonId: null,
29810
+ access: "view"
29811
+ },
29618
29812
  "fanControl.setDirection": {
29619
29813
  capName: "fan-control",
29620
29814
  capScope: "device",
@@ -32921,6 +33115,12 @@ Object.freeze({
32921
33115
  addonId: null,
32922
33116
  access: "create"
32923
33117
  },
33118
+ "system.getFailureContributions": {
33119
+ capName: "system",
33120
+ capScope: "system",
33121
+ addonId: null,
33122
+ access: "view"
33123
+ },
32924
33124
  "system.getLoadContributions": {
32925
33125
  capName: "system",
32926
33126
  capScope: "system",
@@ -13222,6 +13222,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13222
13222
  limit: number().optional(),
13223
13223
  tags: record(string(), string()).optional()
13224
13224
  }), array(LogEntrySchema).readonly());
13225
+ /**
13226
+ * `failure-contribution` — the capability an addon reports its OWN losses
13227
+ * through, per camera, with the denominator attached. It stores nothing.
13228
+ *
13229
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13230
+ *
13231
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13232
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13233
+ * copied: the contributor reports what it already knows, hub-main adds only
13234
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13235
+ * somebody to forget to edit.
13236
+ *
13237
+ * They are not merged, because their invariants are opposites:
13238
+ *
13239
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13240
+ * claim a camera cost nothing, which is a measurement nobody made;
13241
+ * - a `failure-contribution` zero is the **most valuable value on the
13242
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13243
+ * and it is exactly what an absent entry cannot say.
13244
+ *
13245
+ * Putting a loss counter on a cost entry would also break the reconciliation
13246
+ * that gives `load-contribution` its point: contributions are subtracted from
13247
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13248
+ * has no process.
13249
+ *
13250
+ * ## Why not a log line, since the counters already exist
13251
+ *
13252
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13253
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13254
+ * ends in a log line, and a log line is the thing the operator asked to stop
13255
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13256
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13257
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13258
+ * media blackout were both diagnosed. The counters stay; this is where they can
13259
+ * be READ.
13260
+ *
13261
+ * ## The rate is served with its denominator or not at all
13262
+ *
13263
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13264
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13265
+ * than yesterday" and was **flat across twelve hours** once divided by the
13266
+ * successes on the same path. A surface that publishes only the numerator
13267
+ * reproduces that mistake on every read.
13268
+ *
13269
+ * ## Shape
13270
+ *
13271
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13272
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13273
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13274
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13275
+ * a forked runner's entries reach hub-main over transport that already exists.
13276
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13277
+ * result through `system.getFailureContributions`.
13278
+ */
13279
+ var FailureReasonCountSchema = object({
13280
+ /**
13281
+ * Why the attempt did not land, in the contributor's own vocabulary —
13282
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13283
+ * strings that already appear in this repo's logs and, where one exists, the
13284
+ * same string the per-track `previewMissReason` records (D276): a second
13285
+ * vocabulary for the same loss would make the row and the counter
13286
+ * un-joinable.
13287
+ */
13288
+ reason: string(),
13289
+ count: number().int().nonnegative()
13290
+ });
13291
+ var FailureContributionSchema = object({
13292
+ /**
13293
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13294
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13295
+ * `unit` free: the families are owned by different addons and a shared enum
13296
+ * is a central list that rots invisibly.
13297
+ */
13298
+ family: string(),
13299
+ /**
13300
+ * The NUMERIC device id — the same value every log line carries as
13301
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13302
+ * cannot name the camera must not emit the entry, because a fleet total
13303
+ * cannot answer the only question anybody asks of this surface.
13304
+ */
13305
+ deviceId: number().int().positive(),
13306
+ /**
13307
+ * A second dimension inside the family: the model / step id for an inference
13308
+ * timeout, so "which camera AND which model" is one read. Absent when the
13309
+ * family has a single variant.
13310
+ */
13311
+ variant: string().optional(),
13312
+ /**
13313
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13314
+ * differencing two reads must drop the interval when it changes, because the
13315
+ * counter restarted from zero in a respawned runner. Same discipline as
13316
+ * `LoadContribution.startedAtMs`.
13317
+ */
13318
+ sinceMs: number(),
13319
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13320
+ atMs: number(),
13321
+ /**
13322
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13323
+ * window. A failure count published without it is the mistake this schema
13324
+ * exists to make impossible.
13325
+ */
13326
+ attempts: number().int().nonnegative(),
13327
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13328
+ succeeded: number().int().nonnegative(),
13329
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13330
+ reasons: array(FailureReasonCountSchema).readonly()
13331
+ });
13332
+ method(_void(), array(FailureContributionSchema).readonly());
13225
13333
  var LoadContributionSchema = object({
13226
13334
  role: _enum([
13227
13335
  "decode",
@@ -13529,6 +13637,50 @@ var NodeProcessSchema = object({
13529
13637
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13530
13638
  uptimeSec: number()
13531
13639
  });
13640
+ /**
13641
+ * One retained container-memory reading.
13642
+ *
13643
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13644
+ * a second clock: that is what makes "processes sum to X, container says Y"
13645
+ * subtractable per point rather than an eyeballed comparison of two series
13646
+ * sampled at different instants.
13647
+ *
13648
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13649
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13650
+ * never coexisted, and a mean would smear away the peak this exists to find.
13651
+ */
13652
+ var ContainerMemoryPointSchema = object({
13653
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13654
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13655
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13656
+ currentBytes: number(),
13657
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13658
+ limitBytes: number().nullable(),
13659
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13660
+ anonBytes: number().nullable(),
13661
+ /** Page cache. Charged to the cgroup, owned by no process. */
13662
+ fileBytes: number().nullable(),
13663
+ /**
13664
+ * Shared memory — and the field that explained the largest single surprise.
13665
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13666
+ * hardware-decode session holding DRM objects is charged HERE and appears
13667
+ * nowhere in a `ps` scan.
13668
+ */
13669
+ shmemBytes: number().nullable(),
13670
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13671
+ slabBytes: number().nullable(),
13672
+ /**
13673
+ * Shrinkable i915 GEM object bytes, from debugfs.
13674
+ *
13675
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13676
+ * component of `currentBytes` and must not be subtracted from it; it says
13677
+ * what put the shmem there, where `shmemBytes` only says how much.
13678
+ *
13679
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13680
+ * container today — and on any node with no Intel GPU.
13681
+ */
13682
+ gpuShmemBytes: number().nullable()
13683
+ }).extend({ atMs: number() });
13532
13684
  var DumpHeapSnapshotInputSchema = object({
13533
13685
  /** The addon whose runner should dump a heap snapshot. */
13534
13686
  addonId: string() });
@@ -13592,6 +13744,21 @@ var NodeLoadSeriesSchema = object({
13592
13744
  /** One entry per function seen in the window, heaviest-first. */
13593
13745
  series: array(LoadFunctionSeriesSchema).readonly(),
13594
13746
  /**
13747
+ * The CONTAINER's memory over the same window, oldest-first.
13748
+ *
13749
+ * Sits next to `series` rather than in a method of its own because the whole
13750
+ * question is a subtraction: the per-process rows in `series` sum to one
13751
+ * number and this one is another, and an operator who has to issue two calls
13752
+ * to compare them will compare two different instants. Same reader, same
13753
+ * `sinceMs`, same `bucketMs`, same timestamps.
13754
+ *
13755
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13756
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13757
+ * points at all. A zero here would be indistinguishable from a healthy
13758
+ * container and is precisely the lie this field exists to avoid.
13759
+ */
13760
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13761
+ /**
13595
13762
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13596
13763
  * reduction was needed — so a caller can always say what one point covers
13597
13764
  * without having to know whether it was reduced.
@@ -17734,6 +17901,20 @@ var TrackSchema = object({
17734
17901
  * `=== true` and render nothing otherwise — never infer "no rider".
17735
17902
  */
17736
17903
  hasRider: boolean().optional(),
17904
+ /**
17905
+ * WHY this track ended without a NATIVE best-shot tile
17906
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
17907
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
17908
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
17909
+ * the late-keyFrame upgrade when a native tile lands after all. The
17910
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
17911
+ * tile is a face/plate stand-in, a raster crop, or an icon.
17912
+ *
17913
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
17914
+ * that predates the field, and every track whose tile landed native all
17915
+ * omit it. Render nothing when absent.
17916
+ */
17917
+ previewMissReason: string().optional(),
17737
17918
  ...TrackFlagFields,
17738
17919
  ...TrackRetrainFields
17739
17920
  });
@@ -25520,10 +25701,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25520
25701
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25521
25702
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25522
25703
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25523
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25524
- * annotations that are not exposed here and must not be treated as an event
25525
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25526
- * (`interfaces/recording-config.ts`).
25704
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
25705
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25706
+ * ever read them. Event<->footage joins are by time, padded with the shared
25707
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25527
25708
  */
25528
25709
  var RecordingStatusSchema = object({
25529
25710
  deviceId: number(),
@@ -26973,6 +27154,13 @@ var LoggingSettingsPatchSchema = object({
26973
27154
  * anyone but its owner.
26974
27155
  */
26975
27156
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27157
+ /**
27158
+ * One per-camera failure counter, plus WHO reported it.
27159
+ *
27160
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27161
+ * the hub as it enumerates providers, never by the contributor.
27162
+ */
27163
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
26976
27164
  var GetLoggingSettingsInputSchema = object({
26977
27165
  scopeNodeId: string().optional(),
26978
27166
  /**
@@ -27031,7 +27219,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27031
27219
  }), method(_void(), SiteLocationStatusSchema, {
27032
27220
  kind: "mutation",
27033
27221
  auth: "admin"
27034
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27222
+ }), 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, {
27035
27223
  kind: "mutation",
27036
27224
  auth: "admin"
27037
27225
  });
@@ -29613,6 +29801,12 @@ Object.freeze({
29613
29801
  addonId: null,
29614
29802
  access: "create"
29615
29803
  },
29804
+ "failureContribution.list": {
29805
+ capName: "failure-contribution",
29806
+ capScope: "system",
29807
+ addonId: null,
29808
+ access: "view"
29809
+ },
29616
29810
  "fanControl.setDirection": {
29617
29811
  capName: "fan-control",
29618
29812
  capScope: "device",
@@ -32919,6 +33113,12 @@ Object.freeze({
32919
33113
  addonId: null,
32920
33114
  access: "create"
32921
33115
  },
33116
+ "system.getFailureContributions": {
33117
+ capName: "system",
33118
+ capScope: "system",
33119
+ addonId: null,
33120
+ access: "view"
33121
+ },
32922
33122
  "system.getLoadContributions": {
32923
33123
  capName: "system",
32924
33124
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-smtp-nodemailer",
3
- "version": "1.2.37",
3
+ "version": "1.2.40",
4
4
  "description": "SMTP email provider addon for CamStack — wraps `nodemailer` and registers a `smtp-provider` cap collection entry. Used by magic-link login + notifier addons.",
5
5
  "keywords": [
6
6
  "camstack",