@camstack/addon-terminal 0.1.43 → 0.1.46

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
@@ -13511,6 +13511,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13511
13511
  limit: number().optional(),
13512
13512
  tags: record(string(), string()).optional()
13513
13513
  }), array(LogEntrySchema).readonly());
13514
+ /**
13515
+ * `failure-contribution` — the capability an addon reports its OWN losses
13516
+ * through, per camera, with the denominator attached. It stores nothing.
13517
+ *
13518
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13519
+ *
13520
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13521
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13522
+ * copied: the contributor reports what it already knows, hub-main adds only
13523
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13524
+ * somebody to forget to edit.
13525
+ *
13526
+ * They are not merged, because their invariants are opposites:
13527
+ *
13528
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13529
+ * claim a camera cost nothing, which is a measurement nobody made;
13530
+ * - a `failure-contribution` zero is the **most valuable value on the
13531
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13532
+ * and it is exactly what an absent entry cannot say.
13533
+ *
13534
+ * Putting a loss counter on a cost entry would also break the reconciliation
13535
+ * that gives `load-contribution` its point: contributions are subtracted from
13536
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13537
+ * has no process.
13538
+ *
13539
+ * ## Why not a log line, since the counters already exist
13540
+ *
13541
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13542
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13543
+ * ends in a log line, and a log line is the thing the operator asked to stop
13544
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13545
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13546
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13547
+ * media blackout were both diagnosed. The counters stay; this is where they can
13548
+ * be READ.
13549
+ *
13550
+ * ## The rate is served with its denominator or not at all
13551
+ *
13552
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13553
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13554
+ * than yesterday" and was **flat across twelve hours** once divided by the
13555
+ * successes on the same path. A surface that publishes only the numerator
13556
+ * reproduces that mistake on every read.
13557
+ *
13558
+ * ## Shape
13559
+ *
13560
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13561
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13562
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13563
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13564
+ * a forked runner's entries reach hub-main over transport that already exists.
13565
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13566
+ * result through `system.getFailureContributions`.
13567
+ */
13568
+ var FailureReasonCountSchema = object({
13569
+ /**
13570
+ * Why the attempt did not land, in the contributor's own vocabulary —
13571
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13572
+ * strings that already appear in this repo's logs and, where one exists, the
13573
+ * same string the per-track `previewMissReason` records (D276): a second
13574
+ * vocabulary for the same loss would make the row and the counter
13575
+ * un-joinable.
13576
+ */
13577
+ reason: string(),
13578
+ count: number().int().nonnegative()
13579
+ });
13580
+ var FailureContributionSchema = object({
13581
+ /**
13582
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13583
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13584
+ * `unit` free: the families are owned by different addons and a shared enum
13585
+ * is a central list that rots invisibly.
13586
+ */
13587
+ family: string(),
13588
+ /**
13589
+ * The NUMERIC device id — the same value every log line carries as
13590
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13591
+ * cannot name the camera must not emit the entry, because a fleet total
13592
+ * cannot answer the only question anybody asks of this surface.
13593
+ */
13594
+ deviceId: number().int().positive(),
13595
+ /**
13596
+ * A second dimension inside the family: the model / step id for an inference
13597
+ * timeout, so "which camera AND which model" is one read. Absent when the
13598
+ * family has a single variant.
13599
+ */
13600
+ variant: string().optional(),
13601
+ /**
13602
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13603
+ * differencing two reads must drop the interval when it changes, because the
13604
+ * counter restarted from zero in a respawned runner. Same discipline as
13605
+ * `LoadContribution.startedAtMs`.
13606
+ */
13607
+ sinceMs: number(),
13608
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13609
+ atMs: number(),
13610
+ /**
13611
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13612
+ * window. A failure count published without it is the mistake this schema
13613
+ * exists to make impossible.
13614
+ */
13615
+ attempts: number().int().nonnegative(),
13616
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13617
+ succeeded: number().int().nonnegative(),
13618
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13619
+ reasons: array(FailureReasonCountSchema).readonly()
13620
+ });
13621
+ method(_void(), array(FailureContributionSchema).readonly());
13514
13622
  var LoadContributionSchema = object({
13515
13623
  role: _enum([
13516
13624
  "decode",
@@ -13818,6 +13926,50 @@ var NodeProcessSchema = object({
13818
13926
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13819
13927
  uptimeSec: number()
13820
13928
  });
13929
+ /**
13930
+ * One retained container-memory reading.
13931
+ *
13932
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13933
+ * a second clock: that is what makes "processes sum to X, container says Y"
13934
+ * subtractable per point rather than an eyeballed comparison of two series
13935
+ * sampled at different instants.
13936
+ *
13937
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13938
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13939
+ * never coexisted, and a mean would smear away the peak this exists to find.
13940
+ */
13941
+ var ContainerMemoryPointSchema = object({
13942
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13943
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13944
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13945
+ currentBytes: number(),
13946
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13947
+ limitBytes: number().nullable(),
13948
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13949
+ anonBytes: number().nullable(),
13950
+ /** Page cache. Charged to the cgroup, owned by no process. */
13951
+ fileBytes: number().nullable(),
13952
+ /**
13953
+ * Shared memory — and the field that explained the largest single surprise.
13954
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13955
+ * hardware-decode session holding DRM objects is charged HERE and appears
13956
+ * nowhere in a `ps` scan.
13957
+ */
13958
+ shmemBytes: number().nullable(),
13959
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13960
+ slabBytes: number().nullable(),
13961
+ /**
13962
+ * Shrinkable i915 GEM object bytes, from debugfs.
13963
+ *
13964
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13965
+ * component of `currentBytes` and must not be subtracted from it; it says
13966
+ * what put the shmem there, where `shmemBytes` only says how much.
13967
+ *
13968
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13969
+ * container today — and on any node with no Intel GPU.
13970
+ */
13971
+ gpuShmemBytes: number().nullable()
13972
+ }).extend({ atMs: number() });
13821
13973
  var DumpHeapSnapshotInputSchema = object({
13822
13974
  /** The addon whose runner should dump a heap snapshot. */
13823
13975
  addonId: string() });
@@ -13881,6 +14033,21 @@ var NodeLoadSeriesSchema = object({
13881
14033
  /** One entry per function seen in the window, heaviest-first. */
13882
14034
  series: array(LoadFunctionSeriesSchema).readonly(),
13883
14035
  /**
14036
+ * The CONTAINER's memory over the same window, oldest-first.
14037
+ *
14038
+ * Sits next to `series` rather than in a method of its own because the whole
14039
+ * question is a subtraction: the per-process rows in `series` sum to one
14040
+ * number and this one is another, and an operator who has to issue two calls
14041
+ * to compare them will compare two different instants. Same reader, same
14042
+ * `sinceMs`, same `bucketMs`, same timestamps.
14043
+ *
14044
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14045
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14046
+ * points at all. A zero here would be indistinguishable from a healthy
14047
+ * container and is precisely the lie this field exists to avoid.
14048
+ */
14049
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14050
+ /**
13884
14051
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13885
14052
  * reduction was needed — so a caller can always say what one point covers
13886
14053
  * without having to know whether it was reduced.
@@ -18101,6 +18268,20 @@ var TrackSchema = object({
18101
18268
  * `=== true` and render nothing otherwise — never infer "no rider".
18102
18269
  */
18103
18270
  hasRider: boolean().optional(),
18271
+ /**
18272
+ * WHY this track ended without a NATIVE best-shot tile
18273
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18274
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18275
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18276
+ * the late-keyFrame upgrade when a native tile lands after all. The
18277
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18278
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18279
+ *
18280
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18281
+ * that predates the field, and every track whose tile landed native all
18282
+ * omit it. Render nothing when absent.
18283
+ */
18284
+ previewMissReason: string().optional(),
18104
18285
  ...TrackFlagFields,
18105
18286
  ...TrackRetrainFields
18106
18287
  });
@@ -27710,10 +27891,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27710
27891
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27711
27892
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27712
27893
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27713
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27714
- * annotations that are not exposed here and must not be treated as an event
27715
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27716
- * (`interfaces/recording-config.ts`).
27894
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27895
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27896
+ * ever read them. Event<->footage joins are by time, padded with the shared
27897
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27717
27898
  */
27718
27899
  var RecordingStatusSchema = object({
27719
27900
  deviceId: number(),
@@ -29424,6 +29605,13 @@ var LoggingSettingsPatchSchema = object({
29424
29605
  * anyone but its owner.
29425
29606
  */
29426
29607
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29608
+ /**
29609
+ * One per-camera failure counter, plus WHO reported it.
29610
+ *
29611
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29612
+ * the hub as it enumerates providers, never by the contributor.
29613
+ */
29614
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29427
29615
  var GetLoggingSettingsInputSchema = object({
29428
29616
  scopeNodeId: string().optional(),
29429
29617
  /**
@@ -29482,7 +29670,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29482
29670
  }), method(_void(), SiteLocationStatusSchema, {
29483
29671
  kind: "mutation",
29484
29672
  auth: "admin"
29485
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29673
+ }), 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, {
29486
29674
  kind: "mutation",
29487
29675
  auth: "admin"
29488
29676
  });
@@ -33470,6 +33658,12 @@ Object.freeze({
33470
33658
  addonId: null,
33471
33659
  access: "create"
33472
33660
  },
33661
+ "failureContribution.list": {
33662
+ capName: "failure-contribution",
33663
+ capScope: "system",
33664
+ addonId: null,
33665
+ access: "view"
33666
+ },
33473
33667
  "fanControl.setDirection": {
33474
33668
  capName: "fan-control",
33475
33669
  capScope: "device",
@@ -36776,6 +36970,12 @@ Object.freeze({
36776
36970
  addonId: null,
36777
36971
  access: "create"
36778
36972
  },
36973
+ "system.getFailureContributions": {
36974
+ capName: "system",
36975
+ capScope: "system",
36976
+ addonId: null,
36977
+ access: "view"
36978
+ },
36779
36979
  "system.getLoadContributions": {
36780
36980
  capName: "system",
36781
36981
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -13488,6 +13488,114 @@ method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
13488
13488
  limit: number().optional(),
13489
13489
  tags: record(string(), string()).optional()
13490
13490
  }), array(LogEntrySchema).readonly());
13491
+ /**
13492
+ * `failure-contribution` — the capability an addon reports its OWN losses
13493
+ * through, per camera, with the denominator attached. It stores nothing.
13494
+ *
13495
+ * ## The twin of `load-contribution`, and why it is a twin and not a field
13496
+ *
13497
+ * `load-contribution` answers *what did this camera COST*. This answers *what
13498
+ * did this camera LOSE*. The reporting discipline is identical and deliberately
13499
+ * copied: the contributor reports what it already knows, hub-main adds only
13500
+ * `addonId`, nothing needs global knowledge, and there is no central list for
13501
+ * somebody to forget to edit.
13502
+ *
13503
+ * They are not merged, because their invariants are opposites:
13504
+ *
13505
+ * - a `load-contribution` measurement is **absent, never zero** — a zero would
13506
+ * claim a camera cost nothing, which is a measurement nobody made;
13507
+ * - a `failure-contribution` zero is the **most valuable value on the
13508
+ * surface** — `attempts: 400, succeeded: 400` is the proof a fix landed,
13509
+ * and it is exactly what an absent entry cannot say.
13510
+ *
13511
+ * Putting a loss counter on a cost entry would also break the reconciliation
13512
+ * that gives `load-contribution` its point: contributions are subtracted from
13513
+ * `metrics.node-processes-snapshot` to find processes nobody claims. A failure
13514
+ * has no process.
13515
+ *
13516
+ * ## Why not a log line, since the counters already exist
13517
+ *
13518
+ * Several of these paths already counted themselves — `CaptureScheduler`'s
13519
+ * per-device window, `KeyFrameCaptureLog`, `bumpCropMetric`. Every one of them
13520
+ * ends in a log line, and a log line is the thing the operator asked to stop
13521
+ * needing: *"possiamo armare questi errori intanto? Così al prossimo giro
13522
+ * ricontrolliamo tutti questi punti"*. Reading them meant grepping Loki and
13523
+ * hand-correlating timestamps, which is how a 22% thumbnail gap and a 3-hour
13524
+ * media blackout were both diagnosed. The counters stay; this is where they can
13525
+ * be READ.
13526
+ *
13527
+ * ## The rate is served with its denominator or not at all
13528
+ *
13529
+ * Every entry carries `attempts` and `succeeded`. A miss count alone is
13530
+ * unreadable: on 2026-08-28 the enrichment-crop miss count read as "35x worse
13531
+ * than yesterday" and was **flat across twelve hours** once divided by the
13532
+ * successes on the same path. A surface that publishes only the numerator
13533
+ * reproduces that mistake on every read.
13534
+ *
13535
+ * ## Shape
13536
+ *
13537
+ * Copied from `load-contribution.cap.ts` (`mode: 'collection'`,
13538
+ * `internal: true`, `mount: { kind: 'skip' }`): no tRPC route of its own and no
13539
+ * generated hooks, while `addons.listCapabilityProviders` still enumerates it
13540
+ * and the hub's `CapabilityRegistry` still holds an RPC proxy per provider — so
13541
+ * a forked runner's entries reach hub-main over transport that already exists.
13542
+ * No new UDS message, no second registry (D3). The operator reads the assembled
13543
+ * result through `system.getFailureContributions`.
13544
+ */
13545
+ var FailureReasonCountSchema = object({
13546
+ /**
13547
+ * Why the attempt did not land, in the contributor's own vocabulary —
13548
+ * `worker-lease-gone`, `queue-overflow`, `timeout`, `empty-read`. The same
13549
+ * strings that already appear in this repo's logs and, where one exists, the
13550
+ * same string the per-track `previewMissReason` records (D276): a second
13551
+ * vocabulary for the same loss would make the row and the counter
13552
+ * un-joinable.
13553
+ */
13554
+ reason: string(),
13555
+ count: number().int().nonnegative()
13556
+ });
13557
+ var FailureContributionSchema = object({
13558
+ /**
13559
+ * The failing path — `enrichment-crop`, `inference`, `plate-ocr`,
13560
+ * `person-over-vehicle`. Free text, for the reason `load-contribution` keeps
13561
+ * `unit` free: the families are owned by different addons and a shared enum
13562
+ * is a central list that rots invisibly.
13563
+ */
13564
+ family: string(),
13565
+ /**
13566
+ * The NUMERIC device id — the same value every log line carries as
13567
+ * `tags.deviceId`. Never nullable and never absent: a contributor that
13568
+ * cannot name the camera must not emit the entry, because a fleet total
13569
+ * cannot answer the only question anybody asks of this surface.
13570
+ */
13571
+ deviceId: number().int().positive(),
13572
+ /**
13573
+ * A second dimension inside the family: the model / step id for an inference
13574
+ * timeout, so "which camera AND which model" is one read. Absent when the
13575
+ * family has a single variant.
13576
+ */
13577
+ variant: string().optional(),
13578
+ /**
13579
+ * Epoch ms this counter started — the INCARNATION MARKER. A consumer
13580
+ * differencing two reads must drop the interval when it changes, because the
13581
+ * counter restarted from zero in a respawned runner. Same discipline as
13582
+ * `LoadContribution.startedAtMs`.
13583
+ */
13584
+ sinceMs: number(),
13585
+ /** Epoch ms it was read. `atMs - sinceMs` is the interval this covers. */
13586
+ atMs: number(),
13587
+ /**
13588
+ * THE DENOMINATOR — every attempt on this path for this camera in the
13589
+ * window. A failure count published without it is the mistake this schema
13590
+ * exists to make impossible.
13591
+ */
13592
+ attempts: number().int().nonnegative(),
13593
+ /** Attempts that landed. `attempts - succeeded` is the loss. */
13594
+ succeeded: number().int().nonnegative(),
13595
+ /** The loss, partitioned. Sums to `attempts - succeeded`. */
13596
+ reasons: array(FailureReasonCountSchema).readonly()
13597
+ });
13598
+ method(_void(), array(FailureContributionSchema).readonly());
13491
13599
  var LoadContributionSchema = object({
13492
13600
  role: _enum([
13493
13601
  "decode",
@@ -13795,6 +13903,50 @@ var NodeProcessSchema = object({
13795
13903
  /** Wall-clock uptime (seconds). Parsed from `ps etime`. */
13796
13904
  uptimeSec: number()
13797
13905
  });
13906
+ /**
13907
+ * One retained container-memory reading.
13908
+ *
13909
+ * `atMs` is the timestamp of the PROCESS snapshot taken in the same tick, not
13910
+ * a second clock: that is what makes "processes sum to X, container says Y"
13911
+ * subtractable per point rather than an eyeballed comparison of two series
13912
+ * sampled at different instants.
13913
+ *
13914
+ * A reduced window keeps the sample with the LARGEST `currentBytes` in each
13915
+ * bucket, WHOLE. Taking a per-field maximum would synthesise a row whose parts
13916
+ * never coexisted, and a mean would smear away the peak this exists to find.
13917
+ */
13918
+ var ContainerMemoryPointSchema = object({
13919
+ /** Which hierarchy answered, so a reading is never ambiguous. */
13920
+ source: _enum(["cgroup-v2", "cgroup-v1"]),
13921
+ /** `memory.current` (v2) / `memory.usage_in_bytes` (v1). Always known. */
13922
+ currentBytes: number(),
13923
+ /** The cgroup's ceiling. `null` = NO LIMIT — never a sentinel, never zero. */
13924
+ limitBytes: number().nullable(),
13925
+ /** Anonymous pages: the closest thing to "what the processes allocated". */
13926
+ anonBytes: number().nullable(),
13927
+ /** Page cache. Charged to the cgroup, owned by no process. */
13928
+ fileBytes: number().nullable(),
13929
+ /**
13930
+ * Shared memory — and the field that explained the largest single surprise.
13931
+ * The i915 driver backs GPU buffers with shmem, so an inference pool or a
13932
+ * hardware-decode session holding DRM objects is charged HERE and appears
13933
+ * nowhere in a `ps` scan.
13934
+ */
13935
+ shmemBytes: number().nullable(),
13936
+ /** Kernel slab charged to this cgroup. `null` on v1, which never publishes it. */
13937
+ slabBytes: number().nullable(),
13938
+ /**
13939
+ * Shrinkable i915 GEM object bytes, from debugfs.
13940
+ *
13941
+ * **Host-wide across every DRM client, NOT cgroup-scoped.** It is not a
13942
+ * component of `currentBytes` and must not be subtracted from it; it says
13943
+ * what put the shmem there, where `shmemBytes` only says how much.
13944
+ *
13945
+ * `null` wherever debugfs is not mounted — which is inside every camstack
13946
+ * container today — and on any node with no Intel GPU.
13947
+ */
13948
+ gpuShmemBytes: number().nullable()
13949
+ }).extend({ atMs: number() });
13798
13950
  var DumpHeapSnapshotInputSchema = object({
13799
13951
  /** The addon whose runner should dump a heap snapshot. */
13800
13952
  addonId: string() });
@@ -13858,6 +14010,21 @@ var NodeLoadSeriesSchema = object({
13858
14010
  /** One entry per function seen in the window, heaviest-first. */
13859
14011
  series: array(LoadFunctionSeriesSchema).readonly(),
13860
14012
  /**
14013
+ * The CONTAINER's memory over the same window, oldest-first.
14014
+ *
14015
+ * Sits next to `series` rather than in a method of its own because the whole
14016
+ * question is a subtraction: the per-process rows in `series` sum to one
14017
+ * number and this one is another, and an operator who has to issue two calls
14018
+ * to compare them will compare two different instants. Same reader, same
14019
+ * `sinceMs`, same `bucketMs`, same timestamps.
14020
+ *
14021
+ * **EMPTY means ABSENT, never zero.** A node with no cgroup — a developer
14022
+ * Mac, a bare-metal host, a container with the hierarchy hidden — reports no
14023
+ * points at all. A zero here would be indistinguishable from a healthy
14024
+ * container and is precisely the lie this field exists to avoid.
14025
+ */
14026
+ containerMemory: array(ContainerMemoryPointSchema).readonly(),
14027
+ /**
13861
14028
  * Width of one returned bucket, in ms. Equals the sampling cadence when no
13862
14029
  * reduction was needed — so a caller can always say what one point covers
13863
14030
  * without having to know whether it was reduced.
@@ -18078,6 +18245,20 @@ var TrackSchema = object({
18078
18245
  * `=== true` and render nothing otherwise — never infer "no rider".
18079
18246
  */
18080
18247
  hasRider: boolean().optional(),
18248
+ /**
18249
+ * WHY this track ended without a NATIVE best-shot tile
18250
+ * ([D276](../decisions/adr-0276-a-stand-in-tile-is-provisional-and-a-close-says-why.md)) —
18251
+ * a composed token line (`no-key-frame capture=keyframe:native-missx4`,
18252
+ * `derive-returned-null tile=standin`, …) written at close and CLEARED by
18253
+ * the late-keyFrame upgrade when a native tile lands after all. The
18254
+ * operator-facing answer to "perché manca l'immagine?" on a track whose
18255
+ * tile is a face/plate stand-in, a raster crop, or an icon.
18256
+ *
18257
+ * **Absent ≠ "missed silently"**: a row written before the column, a hub
18258
+ * that predates the field, and every track whose tile landed native all
18259
+ * omit it. Render nothing when absent.
18260
+ */
18261
+ previewMissReason: string().optional(),
18081
18262
  ...TrackFlagFields,
18082
18263
  ...TrackRetrainFields
18083
18264
  });
@@ -27687,10 +27868,10 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
27687
27868
  * recording config. NOTE on events (source of truth, R5/C3): this cap carries
27688
27869
  * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
27689
27870
  * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
27690
- * rows); the recorder's internal EventMap markers are ephemeral in-RAM
27691
- * annotations that are not exposed here and must not be treated as an event
27692
- * feed. Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
27693
- * (`interfaces/recording-config.ts`).
27871
+ * rows) and are the ONLY event surface the recorder has none. The in-RAM
27872
+ * playback markers it used to build were deleted on 2026-08-29 because nothing
27873
+ * ever read them. Event<->footage joins are by time, padded with the shared
27874
+ * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
27694
27875
  */
27695
27876
  var RecordingStatusSchema = object({
27696
27877
  deviceId: number(),
@@ -29401,6 +29582,13 @@ var LoggingSettingsPatchSchema = object({
29401
29582
  * anyone but its owner.
29402
29583
  */
29403
29584
  var ReportedLoadContributionSchema = LoadContributionSchema.extend({ addonId: string() });
29585
+ /**
29586
+ * One per-camera failure counter, plus WHO reported it.
29587
+ *
29588
+ * Same rule as {@link ReportedLoadContributionSchema}: `addonId` is stamped by
29589
+ * the hub as it enumerates providers, never by the contributor.
29590
+ */
29591
+ var ReportedFailureContributionSchema = FailureContributionSchema.extend({ addonId: string() });
29404
29592
  var GetLoggingSettingsInputSchema = object({
29405
29593
  scopeNodeId: string().optional(),
29406
29594
  /**
@@ -29459,7 +29647,7 @@ method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), met
29459
29647
  }), method(_void(), SiteLocationStatusSchema, {
29460
29648
  kind: "mutation",
29461
29649
  auth: "admin"
29462
- }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
29650
+ }), 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, {
29463
29651
  kind: "mutation",
29464
29652
  auth: "admin"
29465
29653
  });
@@ -33447,6 +33635,12 @@ Object.freeze({
33447
33635
  addonId: null,
33448
33636
  access: "create"
33449
33637
  },
33638
+ "failureContribution.list": {
33639
+ capName: "failure-contribution",
33640
+ capScope: "system",
33641
+ addonId: null,
33642
+ access: "view"
33643
+ },
33450
33644
  "fanControl.setDirection": {
33451
33645
  capName: "fan-control",
33452
33646
  capScope: "device",
@@ -36753,6 +36947,12 @@ Object.freeze({
36753
36947
  addonId: null,
36754
36948
  access: "create"
36755
36949
  },
36950
+ "system.getFailureContributions": {
36951
+ capName: "system",
36952
+ capScope: "system",
36953
+ addonId: null,
36954
+ access: "view"
36955
+ },
36756
36956
  "system.getLoadContributions": {
36757
36957
  capName: "system",
36758
36958
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-terminal",
3
- "version": "0.1.43",
3
+ "version": "0.1.46",
4
4
  "description": "Interactive terminal sessions (pty + xterm) as a CamStack addon",
5
5
  "keywords": [
6
6
  "camstack",