@camstack/addon-tailscale 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.
@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
24
24
  enumerable: true
25
25
  }) : target, mod));
26
26
  //#endregion
27
- const require_dist = require("../dist-1cd9nLqr.js");
27
+ const require_dist = require("../dist-DUIjkoxj.js");
28
28
  let node_child_process = require("node:child_process");
29
29
  let node_util = require("node:util");
30
30
  let node_fs = require("node:fs");
@@ -1,4 +1,4 @@
1
- import { a as EventCategory, i as BaseAddon, n as networkAccessCapability, r as BOOT_RECOVERY_BACKOFF_MS, t as meshNetworkCapability } from "../dist-Bw48pf94.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability, r as BOOT_RECOVERY_BACKOFF_MS, t as meshNetworkCapability } from "../dist-B1QxlHJT.mjs";
2
2
  import { execFile, spawn } from "node:child_process";
3
3
  import { promisify } from "node:util";
4
4
  import * as fs from "node:fs";
@@ -13220,6 +13220,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13220
13220
  limit: number().optional(),
13221
13221
  tags: record(string(), string()).optional()
13222
13222
  }), array(LogEntrySchema).readonly());
13223
+ /**
13224
+ * `failure-contribution` — the capability an addon reports its OWN losses
13225
+ * through, per camera, with the denominator attached. It stores nothing.
13226
+ *
13227
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13228
+ *
13229
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13230
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13231
+ * copied: the contributor reports what it already knows, hub-main adds only
13232
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13233
+ * somebody to forget to edit.
13234
+ *
13235
+ * They are not merged, because their invariants are opposites:
13236
+ *
13237
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13238
+ * claim a camera cost nothing, which is a measurement nobody made;
13239
+ * - a `failure-contribution` zero is the **most valuable value on the
13240
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13241
+ * and it is exactly what an absent entry cannot say.
13242
+ *
13243
+ * Putting a loss counter on a cost entry would also break the reconciliation
13244
+ * that gives `load-contribution` its point: contributions are subtracted from
13245
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13246
+ * has no process.
13247
+ *
13248
+ * ## Why not a log line, since the counters already exist
13249
+ *
13250
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13251
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13252
+ * ends in a log line, and a log line is the thing the operator asked to stop
13253
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13254
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13255
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13256
+ * media blackout were both diagnosed. The counters stay; this is where they can
13257
+ * be READ.
13258
+ *
13259
+ * ## The rate is served with its denominator or not at all
13260
+ *
13261
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13262
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13263
+ * than yesterday" and was **flat across twelve hours** once divided by the
13264
+ * successes on the same path. A surface that publishes only the numerator
13265
+ * reproduces that mistake on every read.
13266
+ *
13267
+ * ## Shape
13268
+ *
13269
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13270
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13271
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13272
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13273
+ * a forked runner's entries reach hub-main over transport that already exists.
13274
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13275
+ * result through `system.getFailureContributions`.
13276
+ */
13277
+ var FailureReasonCountSchema = object({
13278
+ /**
13279
+ * Why the attempt did not land, in the contributor's own vocabulary —
13280
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13281
+ * strings that already appear in this repo's logs and, where one exists, the
13282
+ * same string the per-track `previewMissReason` records (D276): a second
13283
+ * vocabulary for the same loss would make the row and the counter
13284
+ * un-joinable.
13285
+ */
13286
+ reason: string(),
13287
+ count: number().int().nonnegative()
13288
+ });
13289
+ var FailureContributionSchema = object({
13290
+ /**
13291
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13292
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13293
+ * `unit` free: the families are owned by different addons and a shared enum
13294
+ * is a central list that rots invisibly.
13295
+ */
13296
+ family: string(),
13297
+ /**
13298
+ * The NUMERIC device id — the same value every log line carries as
13299
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13300
+ * cannot name the camera must not emit the entry, because a fleet total
13301
+ * cannot answer the only question anybody asks of this surface.
13302
+ */
13303
+ deviceId: number().int().positive(),
13304
+ /**
13305
+ * A second dimension inside the family: the model / step id for an inference
13306
+ * timeout, so "which camera AND which model" is one read. Absent when the
13307
+ * family has a single variant.
13308
+ */
13309
+ variant: string().optional(),
13310
+ /**
13311
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13312
+ * differencing two reads must drop the interval when it changes, because the
13313
+ * counter restarted from zero in a respawned runner. Same discipline as
13314
+ * `LoadContribution.startedAtMs`.
13315
+ */
13316
+ sinceMs: number(),
13317
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13318
+ atMs: number(),
13319
+ /**
13320
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13321
+ * window. A failure count published without it is the mistake this schema
13322
+ * exists to make impossible.
13323
+ */
13324
+ attempts: number().int().nonnegative(),
13325
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13326
+ succeeded: number().int().nonnegative(),
13327
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13328
+ reasons: array(FailureReasonCountSchema).readonly()
13329
+ });
13330
+ method(_void(), array(FailureContributionSchema).readonly());
13223
13331
  var LoadContributionSchema = object({
13224
13332
  role: _enum([
13225
13333
  "decode",
@@ -13527,6 +13635,50 @@ var NodeProcessSchema = object({
13527
13635
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13528
13636
  uptimeSec: number()
13529
13637
  });
13638
+ /**
13639
+ * One retained container-memory reading.
13640
+ *
13641
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13642
+ * a second clock: that is what makes "processes sum to X, container says Y"
13643
+ * subtractable per point rather than an eyeballed comparison of two series
13644
+ * sampled at different instants.
13645
+ *
13646
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13647
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13648
+ * never coexisted, and a mean would smear away the peak this exists to find.
13649
+ */
13650
+ var ContainerMemoryPointSchema = object({
13651
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13652
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13653
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13654
+ currentBytes: number(),
13655
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13656
+ limitBytes: number().nullable(),
13657
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13658
+ anonBytes: number().nullable(),
13659
+ /** Page cache. Charged to the cgroup, owned by no process. */
13660
+ fileBytes: number().nullable(),
13661
+ /**
13662
+ * Shared memory — and the field that explained the largest single surprise.
13663
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13664
+ * hardware-decode session holding DRM objects is charged HERE and appears
13665
+ * nowhere in a `ps` scan.
13666
+ */
13667
+ shmemBytes: number().nullable(),
13668
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13669
+ slabBytes: number().nullable(),
13670
+ /**
13671
+ * Shrinkable i915 GEM object bytes, from debugfs.
13672
+ *
13673
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13674
+ * component of `currentBytes` and must not be subtracted from it; it says
13675
+ * what put the shmem there, where `shmemBytes` only says how much.
13676
+ *
13677
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13678
+ * container today — and on any node with no Intel GPU.
13679
+ */
13680
+ gpuShmemBytes: number().nullable()
13681
+ }).extend({ atMs: number() });
13530
13682
  var DumpHeapSnapshotInputSchema = object({
13531
13683
  /** The addon whose runner should dump a heap snapshot. */
13532
13684
  addonId: string() });
@@ -13590,6 +13742,21 @@ var NodeLoadSeriesSchema = object({
13590
13742
  /** One entry per function seen in the window, heaviest-first. */
13591
13743
  series: array(LoadFunctionSeriesSchema).readonly(),
13592
13744
  /**
13745
+ * The CONTAINER's memory over the same window, oldest-first.
13746
+ *
13747
+ * Sits next to `series` rather than in a method of its own because the whole
13748
+ * question is a subtraction: the per-process rows in `series` sum to one
13749
+ * number and this one is another, and an operator who has to issue two calls
13750
+ * to compare them will compare two different instants. Same reader, same
13751
+ * `sinceMs`, same `bucketMs`, same timestamps.
13752
+ *
13753
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13754
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13755
+ * points at all. A zero here would be indistinguishable from a healthy
13756
+ * container and is precisely the lie this field exists to avoid.
13757
+ */
13758
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13759
+ /**
13593
13760
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13594
13761
  * reduction was needed — so a caller can always say what one point covers
13595
13762
  * without having to know whether it was reduced.
@@ -17749,6 +17916,20 @@ var TrackSchema = object({
17749
17916
  * `=== true` and render nothing otherwise — never infer "no rider".
17750
17917
  */
17751
17918
  hasRider: boolean().optional(),
17919
+ /**
17920
+ * WHY this track ended without a NATIVE best-shot tile
17921
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
17922
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
17923
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
17924
+ * the late-keyFrame upgrade when a native tile lands after all. The
17925
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
17926
+ * tile is a face/plate stand-in, a raster crop, or an icon.
17927
+ *
17928
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
17929
+ * that predates the field, and every track whose tile landed native all
17930
+ * omit it. Render nothing when absent.
17931
+ */
17932
+ previewMissReason: string().optional(),
17752
17933
  ...TrackFlagFields,
17753
17934
  ...TrackRetrainFields
17754
17935
  });
@@ -25583,10 +25764,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25583
25764
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25584
25765
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25585
25766
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25586
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25587
- * annotations that are not exposed here and must not be treated as an event
25588
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25589
- * (`interfaces/recording-config.ts`).
25767
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
25768
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25769
+ * ever read them. Event<->footage joins are by time, padded with the shared
25770
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25590
25771
  */
25591
25772
  var RecordingStatusSchema = object({
25592
25773
  deviceId: number(),
@@ -27036,6 +27217,13 @@ var LoggingSettingsPatchSchema = object({
27036
27217
  * anyone but its owner.
27037
27218
  */
27038
27219
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27220
+ /**
27221
+ * One per-camera failure counter, plus WHO reported it.
27222
+ *
27223
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27224
+ * the hub as it enumerates providers, never by the contributor.
27225
+ */
27226
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27039
27227
  var GetLoggingSettingsInputSchema = object({
27040
27228
  scopeNodeId: string().optional(),
27041
27229
  /**
@@ -27094,7 +27282,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27094
27282
  }), method(_void(), SiteLocationStatusSchema, {
27095
27283
  kind: "mutation",
27096
27284
  auth: "admin"
27097
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27285
+ }), 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, {
27098
27286
  kind: "mutation",
27099
27287
  auth: "admin"
27100
27288
  });
@@ -29676,6 +29864,12 @@ Object.freeze({
29676
29864
  addonId: null,
29677
29865
  access: "create"
29678
29866
  },
29867
+ "failureContribution.list": {
29868
+ capName: "failure-contribution",
29869
+ capScope: "system",
29870
+ addonId: null,
29871
+ access: "view"
29872
+ },
29679
29873
  "fanControl.setDirection": {
29680
29874
  capName: "fan-control",
29681
29875
  capScope: "device",
@@ -32982,6 +33176,12 @@ Object.freeze({
32982
33176
  addonId: null,
32983
33177
  access: "create"
32984
33178
  },
33179
+ "system.getFailureContributions": {
33180
+ capName: "system",
33181
+ capScope: "system",
33182
+ addonId: null,
33183
+ access: "view"
33184
+ },
32985
33185
  "system.getLoadContributions": {
32986
33186
  capName: "system",
32987
33187
  capScope: "system",
@@ -13220,6 +13220,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13220
13220
  limit: number().optional(),
13221
13221
  tags: record(string(), string()).optional()
13222
13222
  }), array(LogEntrySchema).readonly());
13223
+ /**
13224
+ * `failure-contribution` — the capability an addon reports its OWN losses
13225
+ * through, per camera, with the denominator attached. It stores nothing.
13226
+ *
13227
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13228
+ *
13229
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13230
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13231
+ * copied: the contributor reports what it already knows, hub-main adds only
13232
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13233
+ * somebody to forget to edit.
13234
+ *
13235
+ * They are not merged, because their invariants are opposites:
13236
+ *
13237
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13238
+ * claim a camera cost nothing, which is a measurement nobody made;
13239
+ * - a `failure-contribution` zero is the **most valuable value on the
13240
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13241
+ * and it is exactly what an absent entry cannot say.
13242
+ *
13243
+ * Putting a loss counter on a cost entry would also break the reconciliation
13244
+ * that gives `load-contribution` its point: contributions are subtracted from
13245
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13246
+ * has no process.
13247
+ *
13248
+ * ## Why not a log line, since the counters already exist
13249
+ *
13250
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13251
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13252
+ * ends in a log line, and a log line is the thing the operator asked to stop
13253
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13254
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13255
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13256
+ * media blackout were both diagnosed. The counters stay; this is where they can
13257
+ * be READ.
13258
+ *
13259
+ * ## The rate is served with its denominator or not at all
13260
+ *
13261
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13262
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13263
+ * than yesterday" and was **flat across twelve hours** once divided by the
13264
+ * successes on the same path. A surface that publishes only the numerator
13265
+ * reproduces that mistake on every read.
13266
+ *
13267
+ * ## Shape
13268
+ *
13269
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13270
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13271
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13272
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13273
+ * a forked runner's entries reach hub-main over transport that already exists.
13274
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13275
+ * result through `system.getFailureContributions`.
13276
+ */
13277
+ var FailureReasonCountSchema = object({
13278
+ /**
13279
+ * Why the attempt did not land, in the contributor's own vocabulary —
13280
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13281
+ * strings that already appear in this repo's logs and, where one exists, the
13282
+ * same string the per-track `previewMissReason` records (D276): a second
13283
+ * vocabulary for the same loss would make the row and the counter
13284
+ * un-joinable.
13285
+ */
13286
+ reason: string(),
13287
+ count: number().int().nonnegative()
13288
+ });
13289
+ var FailureContributionSchema = object({
13290
+ /**
13291
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13292
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13293
+ * `unit` free: the families are owned by different addons and a shared enum
13294
+ * is a central list that rots invisibly.
13295
+ */
13296
+ family: string(),
13297
+ /**
13298
+ * The NUMERIC device id — the same value every log line carries as
13299
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13300
+ * cannot name the camera must not emit the entry, because a fleet total
13301
+ * cannot answer the only question anybody asks of this surface.
13302
+ */
13303
+ deviceId: number().int().positive(),
13304
+ /**
13305
+ * A second dimension inside the family: the model / step id for an inference
13306
+ * timeout, so "which camera AND which model" is one read. Absent when the
13307
+ * family has a single variant.
13308
+ */
13309
+ variant: string().optional(),
13310
+ /**
13311
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13312
+ * differencing two reads must drop the interval when it changes, because the
13313
+ * counter restarted from zero in a respawned runner. Same discipline as
13314
+ * `LoadContribution.startedAtMs`.
13315
+ */
13316
+ sinceMs: number(),
13317
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13318
+ atMs: number(),
13319
+ /**
13320
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13321
+ * window. A failure count published without it is the mistake this schema
13322
+ * exists to make impossible.
13323
+ */
13324
+ attempts: number().int().nonnegative(),
13325
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13326
+ succeeded: number().int().nonnegative(),
13327
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13328
+ reasons: array(FailureReasonCountSchema).readonly()
13329
+ });
13330
+ method(_void(), array(FailureContributionSchema).readonly());
13223
13331
  var LoadContributionSchema = object({
13224
13332
  role: _enum([
13225
13333
  "decode",
@@ -13527,6 +13635,50 @@ var NodeProcessSchema = object({
13527
13635
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13528
13636
  uptimeSec: number()
13529
13637
  });
13638
+ /**
13639
+ * One retained container-memory reading.
13640
+ *
13641
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13642
+ * a second clock: that is what makes "processes sum to X, container says Y"
13643
+ * subtractable per point rather than an eyeballed comparison of two series
13644
+ * sampled at different instants.
13645
+ *
13646
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13647
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13648
+ * never coexisted, and a mean would smear away the peak this exists to find.
13649
+ */
13650
+ var ContainerMemoryPointSchema = object({
13651
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13652
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13653
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13654
+ currentBytes: number(),
13655
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13656
+ limitBytes: number().nullable(),
13657
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13658
+ anonBytes: number().nullable(),
13659
+ /** Page cache. Charged to the cgroup, owned by no process. */
13660
+ fileBytes: number().nullable(),
13661
+ /**
13662
+ * Shared memory — and the field that explained the largest single surprise.
13663
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13664
+ * hardware-decode session holding DRM objects is charged HERE and appears
13665
+ * nowhere in a `ps` scan.
13666
+ */
13667
+ shmemBytes: number().nullable(),
13668
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13669
+ slabBytes: number().nullable(),
13670
+ /**
13671
+ * Shrinkable i915 GEM object bytes, from debugfs.
13672
+ *
13673
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13674
+ * component of `currentBytes` and must not be subtracted from it; it says
13675
+ * what put the shmem there, where `shmemBytes` only says how much.
13676
+ *
13677
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13678
+ * container today — and on any node with no Intel GPU.
13679
+ */
13680
+ gpuShmemBytes: number().nullable()
13681
+ }).extend({ atMs: number() });
13530
13682
  var DumpHeapSnapshotInputSchema = object({
13531
13683
  /** The addon whose runner should dump a heap snapshot. */
13532
13684
  addonId: string() });
@@ -13590,6 +13742,21 @@ var NodeLoadSeriesSchema = object({
13590
13742
  /** One entry per function seen in the window, heaviest-first. */
13591
13743
  series: array(LoadFunctionSeriesSchema).readonly(),
13592
13744
  /**
13745
+ * The CONTAINER's memory over the same window, oldest-first.
13746
+ *
13747
+ * Sits next to `series` rather than in a method of its own because the whole
13748
+ * question is a subtraction: the per-process rows in `series` sum to one
13749
+ * number and this one is another, and an operator who has to issue two calls
13750
+ * to compare them will compare two different instants. Same reader, same
13751
+ * `sinceMs`, same `bucketMs`, same timestamps.
13752
+ *
13753
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
13754
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
13755
+ * points at all. A zero here would be indistinguishable from a healthy
13756
+ * container and is precisely the lie this field exists to avoid.
13757
+ */
13758
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
13759
+ /**
13593
13760
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13594
13761
  * reduction was needed — so a caller can always say what one point covers
13595
13762
  * without having to know whether it was reduced.
@@ -17749,6 +17916,20 @@ var TrackSchema = object({
17749
17916
  * `=== true` and render nothing otherwise — never infer "no rider".
17750
17917
  */
17751
17918
  hasRider: boolean().optional(),
17919
+ /**
17920
+ * WHY this track ended without a NATIVE best-shot tile
17921
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
17922
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
17923
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
17924
+ * the late-keyFrame upgrade when a native tile lands after all. The
17925
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
17926
+ * tile is a face/plate stand-in, a raster crop, or an icon.
17927
+ *
17928
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
17929
+ * that predates the field, and every track whose tile landed native all
17930
+ * omit it. Render nothing when absent.
17931
+ */
17932
+ previewMissReason: string().optional(),
17752
17933
  ...TrackFlagFields,
17753
17934
  ...TrackRetrainFields
17754
17935
  });
@@ -25583,10 +25764,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
25583
25764
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
25584
25765
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
25585
25766
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
25586
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
25587
- * annotations that are not exposed here and must not be treated as an event
25588
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
25589
- * (`interfaces/recording-config.ts`).
25767
+ * rows) and are the ONLY event surface — the recorder has none. The in-RAM
25768
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
25769
+ * ever read them. Event<->footage joins are by time, padded with the shared
25770
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
25590
25771
  */
25591
25772
  var RecordingStatusSchema = object({
25592
25773
  deviceId: number(),
@@ -27036,6 +27217,13 @@ var LoggingSettingsPatchSchema = object({
27036
27217
  * anyone but its owner.
27037
27218
  */
27038
27219
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
27220
+ /**
27221
+ * One per-camera failure counter, plus WHO reported it.
27222
+ *
27223
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
27224
+ * the hub as it enumerates providers, never by the contributor.
27225
+ */
27226
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
27039
27227
  var GetLoggingSettingsInputSchema = object({
27040
27228
  scopeNodeId: string().optional(),
27041
27229
  /**
@@ -27094,7 +27282,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
27094
27282
  }), method(_void(), SiteLocationStatusSchema, {
27095
27283
  kind: "mutation",
27096
27284
  auth: "admin"
27097
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
27285
+ }), 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, {
27098
27286
  kind: "mutation",
27099
27287
  auth: "admin"
27100
27288
  });
@@ -29676,6 +29864,12 @@ Object.freeze({
29676
29864
  addonId: null,
29677
29865
  access: "create"
29678
29866
  },
29867
+ "failureContribution.list": {
29868
+ capName: "failure-contribution",
29869
+ capScope: "system",
29870
+ addonId: null,
29871
+ access: "view"
29872
+ },
29679
29873
  "fanControl.setDirection": {
29680
29874
  capName: "fan-control",
29681
29875
  capScope: "device",
@@ -32982,6 +33176,12 @@ Object.freeze({
32982
33176
  addonId: null,
32983
33177
  access: "create"
32984
33178
  },
33179
+ "system.getFailureContributions": {
33180
+ capName: "system",
33181
+ capScope: "system",
33182
+ addonId: null,
33183
+ access: "view"
33184
+ },
32985
33185
  "system.getLoadContributions": {
32986
33186
  capName: "system",
32987
33187
  capScope: "system",
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-1cd9nLqr.js");
5
+ const require_dist = require("../dist-DUIjkoxj.js");
6
6
  let node_crypto = require("node:crypto");
7
7
  let node_child_process = require("node:child_process");
8
8
  //#region src/ingress/tailscale-cli.ts
@@ -1,4 +1,4 @@
1
- import { a as EventCategory, i as BaseAddon, n as networkAccessCapability } from "../dist-Bw48pf94.mjs";
1
+ import { a as EventCategory, i as BaseAddon, n as networkAccessCapability } from "../dist-B1QxlHJT.mjs";
2
2
  import { randomUUID } from "node:crypto";
3
3
  import { execFile } from "node:child_process";
4
4
  import { promisify } from "node:util";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-tailscale",
3
- "version": "1.2.38",
3
+ "version": "1.2.41",
4
4
  "description": "Tailscale bundle for CamStack — joins the host to a tailnet (client) and exposes the hub via Serve/Funnel (ingress). Multi-entry npm package shipping 2 addons under a single bundle.",
5
5
  "keywords": [
6
6
  "camstack",