@camstack/addon-post-analysis 1.2.197 → 1.2.199

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.
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-zAv7pMUz.mjs
1
+ //#region ../types/dist/event-category-CnLqLOKs.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -193,6 +193,19 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
193
193
  EventCategory["ProcessCrashed"] = "process.crashed";
194
194
  EventCategory["ProcessRestartScheduled"] = "process.restart_scheduled";
195
195
  EventCategory["ProcessRestarted"] = "process.restarted";
196
+ /**
197
+ * The SET of storage locations changed — one was created, edited, enabled,
198
+ * disabled or deleted through `storage.upsertLocation` / `deleteLocation`.
199
+ *
200
+ * Telemetry, not a transaction (D8/D11): every consumer that re-resolves on
201
+ * it must also converge on its own periodic path, because a dropped event
202
+ * must not leave a node writing to yesterday's disk set forever. It exists
203
+ * because there was NO signal at all — an operator who added a second
204
+ * recordings disk in the admin UI got nothing, and the recorder kept its
205
+ * resolved locations until something else happened to re-resolve them
206
+ * (D387). Payload `StorageLocationsChangedPayload`.
207
+ */
208
+ EventCategory["StorageLocationsChanged"] = "storage.locations-changed";
196
209
  EventCategory["RecordingStarted"] = "recording.started";
197
210
  EventCategory["RecordingStopped"] = "recording.stopped";
198
211
  EventCategory["RecordingError"] = "recording.error";
@@ -8780,6 +8793,100 @@ var StorageCleanupJobSchema = object({
8780
8793
  });
8781
8794
  var StorageCleanupStatusInputSchema = object({ jobId: string().optional() });
8782
8795
  /**
8796
+ * The storage-location STATE MODEL (D385) — one typed state, one policy module.
8797
+ *
8798
+ * A location's state used to be split across two authorities: the typed
8799
+ * `enabled` field (THE write switch since D383) and an untyped `config.readOnly`
8800
+ * key. They did not mean the same thing — `enabled: false` was still evicted
8801
+ * under disk pressure while `config.readOnly` was deliberately excluded — and
8802
+ * neither name said which. Every consumer re-derived the difference, and the
8803
+ * three questions that actually matter were answered in six places.
8804
+ *
8805
+ * This module is the ONLY place in the repo allowed to interpret the state. It
8806
+ * answers three questions and nothing else:
8807
+ *
8808
+ * - may this location be WRITTEN to? {@link modeMayWrite}
8809
+ * - may this location be READ? {@link modeMayRead}
8810
+ * - what is its eviction policy? {@link evictionPolicyForMode}
8811
+ *
8812
+ * | mode | write | read | eviction |
8813
+ * | ---------- | ----- | ---- | ------------------------------ |
8814
+ * | `active` | yes | yes | `normal` (pressure + usage cap) |
8815
+ * | `readonly` | no | yes | `never` |
8816
+ * | `drain` | no | yes | `drain` (paced, until empty) |
8817
+ * | `disabled` | no | no | `never` |
8818
+ *
8819
+ * `scripts/check-storage-location-mode-single-owner.ts` fails the build when
8820
+ * anything outside this module reads `config['readOnly']` or compares `enabled`
8821
+ * directly. A rule nothing checks has already been broken somewhere.
8822
+ */
8823
+ var STORAGE_LOCATION_MODES = [
8824
+ "active",
8825
+ "readonly",
8826
+ "drain",
8827
+ "disabled"
8828
+ ];
8829
+ /**
8830
+ * The one typed state of a storage location. Authoritative Zod schema — the TS
8831
+ * alias below is `z.infer<>` of it, never a second spelling.
8832
+ */
8833
+ var StorageLocationModeSchema = _enum(STORAGE_LOCATION_MODES);
8834
+ _enum([
8835
+ "normal",
8836
+ "never",
8837
+ "drain"
8838
+ ]);
8839
+ /** Is this mode a write target? Only `active` is. */
8840
+ function modeMayWrite(mode) {
8841
+ return mode === "active";
8842
+ }
8843
+ /** What eviction may do here. See {@link StorageEvictionPolicy}. */
8844
+ function evictionPolicyForMode(mode) {
8845
+ switch (mode) {
8846
+ case "active": return "normal";
8847
+ case "drain": return "drain";
8848
+ case "readonly":
8849
+ case "disabled": return "never";
8850
+ }
8851
+ }
8852
+ /**
8853
+ * The mode a LEGACY row implies, or `null` when it implies nothing — the row is
8854
+ * already stamped, or it carried neither flag.
8855
+ *
8856
+ * Both legacy flags fold to `readonly`, which is the CONSERVATIVE direction: a
8857
+ * state change must never start deleting footage on its own, and it must never
8858
+ * make footage that was still being served disappear. `enabled: false` used to
8859
+ * leave the location evictable under pressure; folding it to `readonly` stops
8860
+ * that, which is a strictly safer answer than the one it replaces.
8861
+ */
8862
+ function legacyModeOf(location) {
8863
+ if (location.mode !== void 0) return null;
8864
+ if (location.config["readOnly"] === true) return "readonly";
8865
+ if (location.enabled === false) return "readonly";
8866
+ return null;
8867
+ }
8868
+ /**
8869
+ * The state of a location, stamped or folded. THE one interpretation: a row
8870
+ * that predates D385 is never ambiguous, and a stamped `mode` always wins over
8871
+ * whatever the legacy pair still says.
8872
+ */
8873
+ function resolveLocationMode(location) {
8874
+ return (isStorageLocationMode(location.mode) ? location.mode : void 0) ?? legacyModeOf(location) ?? "active";
8875
+ }
8876
+ /** Is this one of the four states? The stamped value crosses a wire, and a
8877
+ * value nobody defined must not be rendered as if it were a state. */
8878
+ function isStorageLocationMode(value) {
8879
+ return STORAGE_LOCATION_MODES.some((mode) => mode === value);
8880
+ }
8881
+ /** May this location be written to? */
8882
+ function mayWriteToLocation(location) {
8883
+ return modeMayWrite(resolveLocationMode(location));
8884
+ }
8885
+ /** What eviction may do to this location. */
8886
+ function evictionPolicyOfLocation(location) {
8887
+ return evictionPolicyForMode(resolveLocationMode(location));
8888
+ }
8889
+ /**
8783
8890
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8784
8891
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8785
8892
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8845,6 +8952,21 @@ var StorageLocationSchema = object({
8845
8952
  * stops existing rather than being re-derived on every read.
8846
8953
  */
8847
8954
  enabled: boolean().optional(),
8955
+ /**
8956
+ * THE state of this location (D385), and the only authority on what may be
8957
+ * written, read or evicted here. Interpreted in exactly one place —
8958
+ * `storage-location-mode.ts` — which also folds the legacy
8959
+ * `enabled` / `config.readOnly` pair into a mode so an old row is never
8960
+ * ambiguous.
8961
+ *
8962
+ * OPTIONAL only for the wire and for rows written before D385: absence is
8963
+ * resolved by `resolveLocationMode`, and the orchestrator stamps every
8964
+ * unstamped row ONCE at hydrate so absence stops existing rather than being
8965
+ * re-derived on every read. `enabled` survives one release as a DERIVED
8966
+ * mirror (`mode === 'active'`); `withLocationMode` is the only writer of
8967
+ * either, so the two cannot disagree.
8968
+ */
8969
+ mode: StorageLocationModeSchema.optional(),
8848
8970
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
8849
8971
  * for node-local locations it can reach) — never persisted, absent when the
8850
8972
  * volume is remote/unreachable. The single capacity truth every UI reads. */
@@ -8852,11 +8974,46 @@ var StorageLocationSchema = object({
8852
8974
  totalBytes: number(),
8853
8975
  availableBytes: number()
8854
8976
  }).nullable().optional(),
8977
+ /**
8978
+ * How much of that volume CamStack ITSELF holds on this location (D388) —
8979
+ * COMPUTED at read time from the `storage-occupancy` providers' own figures,
8980
+ * never persisted, never a filesystem walk.
8981
+ *
8982
+ * **ABSENT MEANS UNKNOWN, never zero.** No provider has reported for this
8983
+ * location yet — nobody stores here, the owning addon is down, or the first
8984
+ * refresh has not completed. A UI must omit the segment rather than draw it
8985
+ * at zero, which would claim we occupy nothing (D315). It is an OBJECT and
8986
+ * not a bare number precisely so that a `?? 0` on the consuming side has to
8987
+ * be spelled out loud instead of appearing by accident.
8988
+ *
8989
+ * `measuredAtMs` is the OLDEST contributing measurement, so it is honest
8990
+ * about the whole figure rather than about its freshest part.
8991
+ */
8992
+ owned: object({
8993
+ bytes: number().int().nonnegative(),
8994
+ measuredAtMs: number().int().nonnegative()
8995
+ }).optional(),
8855
8996
  createdAt: number(),
8856
8997
  updatedAt: number()
8857
8998
  });
8858
8999
  object({ isDefault: boolean().optional() });
8859
9000
  /**
9001
+ * How far a `drain` has got (D386) — the read a UI renders, and nothing more.
9002
+ *
9003
+ * `estimatedEmptyAtMs` is derived from the growth the ratchet has actually
9004
+ * OBSERVED and is `null` when it has observed none. Never a fabricated date: a
9005
+ * drain with no observed growth has no honest ETA, and inventing one is how an
9006
+ * operator learns not to believe the screen.
9007
+ */
9008
+ var StorageDrainProgressSchema = object({
9009
+ locationId: string(),
9010
+ startedAtMs: number(),
9011
+ startBytes: number(),
9012
+ bytesRemaining: number(),
9013
+ drained: boolean(),
9014
+ estimatedEmptyAtMs: number().nullable()
9015
+ });
9016
+ /**
8860
9017
  * Reference accepted by consumer-facing `api.storage.*` calls.
8861
9018
  * Either:
8862
9019
  * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
@@ -23499,7 +23656,7 @@ method(object({
23499
23656
  }), _void(), {
23500
23657
  kind: "mutation",
23501
23658
  auth: "admin"
23502
- }), method(object({ id: string() }), object({
23659
+ }), method(_void(), array(StorageDrainProgressSchema).readonly()), method(object({ id: string() }), object({
23503
23660
  ok: boolean(),
23504
23661
  error: string().optional()
23505
23662
  }), { auth: "admin" }), method(_void(), array(ProviderListEntrySchema).readonly()), method(object({
@@ -23569,6 +23726,71 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
23569
23726
  kind: "mutation",
23570
23727
  auth: "admin"
23571
23728
  }), method(object({}), array(StorageMigrationJobSchema).readonly(), { auth: "admin" });
23729
+ /**
23730
+ * `storage-occupancy` — how many bytes an addon actually HOLDS on a storage
23731
+ * location (D388).
23732
+ *
23733
+ * ## Why this is not `storage-evictable`
23734
+ *
23735
+ * `storage-evictable.getEvictableUsage` looks like the same question and is
23736
+ * not, in two ways that both matter and both bite hardest on the locations an
23737
+ * operator most wants a figure for:
23738
+ *
23739
+ * - it reports the whole eviction DOMAIN, not the location. `recordings:default`
23740
+ * and `recordingsLow:default` deliberately share one root and evict as one
23741
+ * oldest-first pool, so both answer with the SAME combined total. As an
23742
+ * occupancy figure that double-counts the disk.
23743
+ * - it reports ZERO for a location whose eviction policy is `never` (D385) —
23744
+ * a `readonly` or `disabled` disk. Those are exactly the disks an operator
23745
+ * is retiring and staring at.
23746
+ *
23747
+ * So this is its own contract with its own quantity, and the quantity is
23748
+ * OCCUPIED: every byte the addon holds on that location, whether or not it
23749
+ * would ever be willing to delete it. A provider that can only answer
23750
+ * "evictable" must not register here — a number that silently means different
23751
+ * things per class is worse than no number.
23752
+ *
23753
+ * ## Absence is an answer
23754
+ *
23755
+ * A location nobody reports for is UNKNOWN, never zero (D315). The orchestrator
23756
+ * stamps `StorageLocation.owned` only for locations it has a report for, and
23757
+ * the field is an OBJECT rather than a bare number so that a `?? 0` on the
23758
+ * consuming side has to be written out loud instead of appearing by accident.
23759
+ *
23760
+ * `internal: true` — consumed by the orchestrator's `listLocations` stamp, never
23761
+ * a public client surface. Clients read the stamped `StorageLocation.owned`.
23762
+ */
23763
+ /** One provider's occupancy answer for one location. */
23764
+ var StorageOccupancyReportSchema = object({
23765
+ locationId: string(),
23766
+ /** Bytes this provider holds on THAT location — not its eviction domain, and
23767
+ * not net of what it is willing to delete. */
23768
+ ownedBytes: number().int().nonnegative(),
23769
+ /** When the provider last actually measured this. The orchestrator carries it
23770
+ * through so a UI can say how old the figure is instead of implying "now". */
23771
+ measuredAtMs: number().int().nonnegative()
23772
+ });
23773
+ var storageOccupancyCapability = {
23774
+ name: "storage-occupancy",
23775
+ scope: "system",
23776
+ mode: "collection",
23777
+ internal: true,
23778
+ methods: {
23779
+ /**
23780
+ * Occupancy for the given locations, in ONE round trip.
23781
+ *
23782
+ * A provider answers only for the locations it actually holds bytes on and
23783
+ * OMITS the rest — an omitted location is "I hold nothing measurable here",
23784
+ * which the orchestrator merges as a contribution of nothing rather than as
23785
+ * a claim that the location is empty. Only a location no provider reports
23786
+ * at all stays unknown.
23787
+ *
23788
+ * This must be CHEAP and must never walk a filesystem: it is on the admin
23789
+ * UI's `listLocations` path. The owner keeps its own figure fresh (D224) and
23790
+ * answers from what it already has.
23791
+ */
23792
+ getOccupancy: method(object({ locationIds: array(string()).readonly() }), array(StorageOccupancyReportSchema).readonly(), { auth: "admin" }) }
23793
+ };
23572
23794
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
23573
23795
  providerId: string().min(1),
23574
23796
  displayName: string().min(1),
@@ -25418,88 +25640,6 @@ onStatusChanged: { data: object({
25418
25640
  volatileStateFields: ["lastUpdated"]
25419
25641
  };
25420
25642
  /**
25421
- * Network-link snapshot. Same shape for every provider (a Reolink wifi
25422
- * camera, a Home Assistant device with a signal-strength sensor, a Tapo
25423
- * plug): one slice under `device.runtimeState['network-link']`, one badge,
25424
- * one Home Assistant projection.
25425
- */
25426
- var NetworkLinkStatusSchema = object({
25427
- /** The link the device is on. `'unknown'` = not read yet, not "no link". */
25428
- type: _enum([
25429
- "wifi",
25430
- "ethernet",
25431
- "cellular",
25432
- "unknown"
25433
- ]),
25434
- /**
25435
- * Link quality, 0..100 inclusive, normalised by the provider from whatever
25436
- * the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
25437
- * KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
25438
- * one whose reading has not landed must not be drawn at 0 %. Consumers
25439
- * SKIP a null rather than coerce it.
25440
- */
25441
- signalPercent: number().min(0).max(100).nullable(),
25442
- /** Raw received signal strength in dBm, when the firmware reports one. */
25443
- rssiDbm: number().optional(),
25444
- /** Network name of a wireless link, when the firmware reports it. */
25445
- ssid: string().optional(),
25446
- /** Ms epoch of the last observation. Lets consumers reason about freshness. */
25447
- lastUpdated: number()
25448
- });
25449
- var networkLinkCapability = {
25450
- name: "network-link",
25451
- scope: "device",
25452
- deviceNative: true,
25453
- mode: "singleton",
25454
- deviceTypes: [
25455
- DeviceType.Camera,
25456
- DeviceType.Sensor,
25457
- DeviceType.Button,
25458
- DeviceType.Switch,
25459
- DeviceType.Light,
25460
- DeviceType.Lock,
25461
- DeviceType.Siren
25462
- ],
25463
- methods: {},
25464
- events: {
25465
- /**
25466
- * Emitted whenever the cached status changes (a link switch, a signal
25467
- * reading that moved). Mirrored on the parent chain by the
25468
- * DeviceEventPropagator like `battery.onStatusChanged`.
25469
- */
25470
- onStatusChanged: { data: object({
25471
- deviceId: number(),
25472
- status: NetworkLinkStatusSchema
25473
- }) } },
25474
- status: {
25475
- schema: NetworkLinkStatusSchema,
25476
- kind: "push",
25477
- empty: {
25478
- type: "unknown",
25479
- signalPercent: null,
25480
- lastUpdated: 0
25481
- }
25482
- },
25483
- /**
25484
- * Runtime-state slice — every provider stores the same shape under
25485
- * `device.runtimeState['network-link']`, read once by the badge and the
25486
- * Home Assistant projector regardless of the driver.
25487
- */
25488
- runtimeState: NetworkLinkStatusSchema,
25489
- /**
25490
- * Runtime-state durability: **restored** — a link reading is slow to
25491
- * change and a sleeping battery camera may not report for hours; the
25492
- * restored slice is what the badge shows until the next read.
25493
- *
25494
- * See `RuntimeStateDurability`. Enforced by
25495
- * `scripts/check-runtime-state-durability.ts`.
25496
- */
25497
- durability: "restored",
25498
- /** Clock fields: written, but excluded from the compare that decides
25499
- * whether persisting is worth a SQLite commit. */
25500
- volatileStateFields: ["lastUpdated"]
25501
- };
25502
- /**
25503
25643
  * Generic boolean sensor — last-resort fallback when no domain-
25504
25644
  * specific binary cap fits (Home Assistant `binary_sensor` without a
25505
25645
  * known `device_class`, or a domain we haven't typed yet). Pure
@@ -29055,6 +29195,369 @@ var nativeObjectDetectionCapability = {
29055
29195
  volatileStateFields: ["lastFetchedAt"]
29056
29196
  };
29057
29197
  /**
29198
+ * `navigation` — a device-scoped capability that natively expresses the FULL
29199
+ * navigation / action surface of a robot that DRIVES ITSELF and carries an
29200
+ * on-board camera (the Dreame robot-vacuum camera is the first provider).
29201
+ *
29202
+ * Why a NEW cap rather than overloading `ptz`:
29203
+ * - `ptz` moves a *gimbal* on a fixed camera (pan/tilt/zoom of the lens). A
29204
+ * robot vacuum has no gimbal — the whole chassis drives, turns and spins.
29205
+ * The two are different physical models: PTZ is absolute-position + presets,
29206
+ * navigation is momentary drive nudges + discrete robot ACTIONS
29207
+ * (dock / spot-clean / follow-pet / go-to-point / …).
29208
+ * - This cap is the SOURCE OF TRUTH. Two consumers adapt from it rather than
29209
+ * the reverse:
29210
+ * 1. a native CamStack navigation panel (data-driven from `listActions`
29211
+ * / `getOptions`), and
29212
+ * 2. the PTZ surface — a thin adapter mimics `ptz` from `navigation` so a
29213
+ * robot camera shows up in the existing PTZ control path without every
29214
+ * PTZ provider learning about robots. The mapping lives in the adapter,
29215
+ * not here (see the addon design note):
29216
+ * ptz.continuousMove({pan,tilt}) → navigation.move({pan,tilt})
29217
+ * ptz.stop() → navigation.stop()
29218
+ * ptz.goHome() → navigation.runAction('goHome')
29219
+ * ptz.getPresets() → navigation.listActions() (id→preset)
29220
+ * ptz.goToPreset(id) → navigation.runAction(id)
29221
+ *
29222
+ * ## Continuous drive
29223
+ *
29224
+ * `move` is MOMENTARY. Fluid navigation comes from the UI (or the PTZ adapter)
29225
+ * sending `move({pan,tilt})` REPEATEDLY at ~1 Hz while a direction is held, and
29226
+ * one `stop()` on release — exactly like the robot app's remote-drive joystick.
29227
+ * The provider forwards EACH `move` to one drive write; it must NOT debounce or
29228
+ * coalesce them. The UI owns the cadence.
29229
+ *
29230
+ * ## The action dictionary
29231
+ *
29232
+ * The discrete controls (dock / locate / spot-clean / follow / flash / sounds)
29233
+ * are a DATA-DRIVEN dictionary the cap exposes via `listActions()`. Each entry
29234
+ * carries `{ id, kind, label, icon }` (plus `soundId` for sound entries) so the
29235
+ * native panel AND the PTZ mimic render buttons WITHOUT hardcoding a
29236
+ * vendor-specific list. `kind: 'action'` entries are triggered with
29237
+ * `runAction({ actionId })`; `kind: 'sound'` entries with `playSound({ soundId })`
29238
+ * (the entry carries the `soundId` to pass). The general primitives — `move`,
29239
+ * `stop`, `goToPoint` — stay as first-class methods, not dictionary entries.
29240
+ *
29241
+ * NOTE (provider wiring): the first provider (Dreame) drives this with the RAW
29242
+ * `callAction(siid,aiid,in)` / `setProperty({siid,piid,value})` MIoT primitives
29243
+ * that the currently-published `@apocaliss92/nodedreame` already exposes on
29244
+ * every device handle. A future nodedreame publish adds a typed
29245
+ * `DreameCameraController` (drive / playPetSound / spotClean / findPet / …); the
29246
+ * provider can then swap the raw calls for the typed methods with no change to
29247
+ * THIS contract.
29248
+ */
29249
+ /**
29250
+ * A momentary drive nudge. The robot MOVES (no gimbal) for as long as the caller
29251
+ * keeps sending nudges (~1 Hz); an explicit `stop` (or letting the nudges lapse)
29252
+ * halts it.
29253
+ *
29254
+ * - `pan` — turn: negative = left, positive = right, 0 = straight.
29255
+ * - `tilt` — throttle: positive = forward, negative = spin / turn-around.
29256
+ * - `speed` — optional intensity hint [0, 1]; the provider may scale the drive
29257
+ * vector by it (drivers without proportional drive ignore it).
29258
+ *
29259
+ * `pan` / `tilt` are normalized [-1, 1]. Both optional so a caller can nudge one
29260
+ * axis alone; an all-undefined nudge is a no-op.
29261
+ */
29262
+ var NavigationMoveCommandSchema = object({
29263
+ pan: number().min(-1).max(1).optional(),
29264
+ tilt: number().min(-1).max(1).optional(),
29265
+ speed: number().min(0).max(1).optional()
29266
+ });
29267
+ /**
29268
+ * The enumerated discrete actions a navigation-capable robot can perform via
29269
+ * `runAction`. This is the CLOSED vocabulary; a given device advertises the
29270
+ * subset it supports through `listActions`. Sounds are NOT here — they go through
29271
+ * `playSound` (see the `sound` dictionary entries).
29272
+ */
29273
+ var NavigationActionIdSchema = _enum([
29274
+ "goHome",
29275
+ "locate",
29276
+ "spotClean",
29277
+ "findPet",
29278
+ "personFollow",
29279
+ "stop",
29280
+ "startClean",
29281
+ "pauseClean",
29282
+ "dockWash",
29283
+ "autoEmpty",
29284
+ "flashOn",
29285
+ "flashOff"
29286
+ ]);
29287
+ /** Whether a dictionary entry is a `runAction` action or a `playSound` sound. */
29288
+ var NavigationEntryKindSchema = _enum(["action", "sound"]);
29289
+ /**
29290
+ * One entry in the navigation action dictionary — the DATA-DRIVEN unit both the
29291
+ * native panel and the PTZ mimic render as a button.
29292
+ *
29293
+ * - `id` — stable id. For `kind:'action'` it is a {@link NavigationActionId}
29294
+ * (pass to `runAction`); for `kind:'sound'` it is a namespaced id
29295
+ * (`sound:meow`) whose `soundId` is passed to `playSound`.
29296
+ * - `icon` — icon HINT (lucide-style name; the UI maps it to its own set).
29297
+ * - `label` — operator-facing English label.
29298
+ * - `soundId` — wire sound id, present only on `kind:'sound'` entries.
29299
+ * - `enabled` — per-device FEATURE FLAG. `listActions` reports it so the UI /
29300
+ * PTZ render ONLY enabled entries. Data-driven: the provider
29301
+ * flips it from config, never by editing code.
29302
+ */
29303
+ var NavigationActionEntrySchema = object({
29304
+ id: string(),
29305
+ kind: NavigationEntryKindSchema,
29306
+ label: string(),
29307
+ icon: string(),
29308
+ /** Present only on `kind:'sound'` entries — the id to pass to `playSound`. */
29309
+ soundId: number().int().optional(),
29310
+ /** Per-device feature flag — render this entry only when true. */
29311
+ enabled: boolean()
29312
+ });
29313
+ /** Coordinates for `goToPoint` — a point on the robot's live map. */
29314
+ var NavigationPointSchema = object({
29315
+ x: number(),
29316
+ y: number()
29317
+ });
29318
+ /**
29319
+ * Per-device FEATURE-FLAG report for the general (non-dictionary) primitives.
29320
+ * The cap reports which are enabled so the UI / PTZ render only the controls
29321
+ * that are turned on for THIS device. Data-driven: the provider derives these
29322
+ * from config + probe, never hardcoded in the UI. The per-DICTIONARY-entry flags
29323
+ * live on {@link NavigationActionEntrySchema.enabled}; these gate the primitives
29324
+ * that are not dictionary entries.
29325
+ *
29326
+ * - `move` / `stop` — the momentary drive joystick.
29327
+ * - `goToPoint` — send-to-map-coordinate. Ships OFF on Dreame until the
29328
+ * map-coordinate plumbing is wired.
29329
+ * - `runAction` — the discrete action buttons (dictionary `kind:'action'`).
29330
+ * - `playSound` — the sound buttons (dictionary `kind:'sound'`).
29331
+ * - `light` — the on/off fill-light toggle (works anytime).
29332
+ * - `lightMode` — the auto/manual selector + manual level slider (a
29333
+ * camera-service control; needs an active stream).
29334
+ */
29335
+ var NavigationFeaturesSchema = object({
29336
+ move: boolean(),
29337
+ stop: boolean(),
29338
+ goToPoint: boolean(),
29339
+ runAction: boolean(),
29340
+ playSound: boolean(),
29341
+ light: boolean(),
29342
+ lightMode: boolean()
29343
+ });
29344
+ /** Light mode: `auto` lets the camera choose brightness; `manual` uses `level`. */
29345
+ var NavigationLightModeSchema = _enum(["auto", "manual"]);
29346
+ /**
29347
+ * Live navigation state so the UI can reflect what the robot is doing:
29348
+ * - `mode` — coarse activity (idle / cleaning / following / …).
29349
+ * - `following` — person/pet follow is currently armed.
29350
+ * - `flash` — the on-camera fill light is on.
29351
+ * - `lightMode` — auto vs manual fill-light mode.
29352
+ * - `lightLevel` — manual fill-light level (40..100); meaningful when
29353
+ * `lightMode === 'manual'`.
29354
+ */
29355
+ var NavigationStatusSchema = object({
29356
+ mode: _enum([
29357
+ "idle",
29358
+ "cleaning",
29359
+ "spot",
29360
+ "following",
29361
+ "goto",
29362
+ "returning",
29363
+ "paused",
29364
+ "unknown"
29365
+ ]),
29366
+ following: boolean(),
29367
+ flash: boolean(),
29368
+ lightMode: NavigationLightModeSchema,
29369
+ lightLevel: number().min(40).max(100),
29370
+ /** Ms epoch when the slice was last updated. */
29371
+ lastChangedAt: number()
29372
+ });
29373
+ /**
29374
+ * Runtime-state slice owned by this cap (kernel-managed: validated, mirrored,
29375
+ * observable). Adds `lastFetchedAt` on top of the status shape per the
29376
+ * convention.
29377
+ */
29378
+ var NavigationRuntimeStateSchema = NavigationStatusSchema.extend({ lastFetchedAt: number() });
29379
+ var navigationCapability = {
29380
+ name: "navigation",
29381
+ scope: "device",
29382
+ deviceNative: true,
29383
+ mode: "singleton",
29384
+ deviceTypes: [DeviceType.Camera],
29385
+ deviceConfig: { ui: {
29386
+ kind: "widget",
29387
+ widgetId: "host/navigation-panel",
29388
+ tab: "navigation",
29389
+ topTab: true,
29390
+ label: "Navigation",
29391
+ order: 0
29392
+ } },
29393
+ methods: {
29394
+ /**
29395
+ * Momentary drive nudge (the robot moves). `protected` — mirrors
29396
+ * `ptz.continuousMove` so the Viewer navigation panel (and the PTZ-mimic
29397
+ * path) works for any authenticated user, not admin-only. The UI sends
29398
+ * these at ~1 Hz while a control is held; the provider forwards each one to
29399
+ * a single drive write WITHOUT debouncing.
29400
+ */
29401
+ move: method(NavigationMoveCommandSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }),
29402
+ /** Halt all motion immediately (zero drive vector). */
29403
+ stop: method(object({ deviceId: number() }), _void(), { kind: "mutation" }),
29404
+ /** Send the robot to a point on its live map. */
29405
+ goToPoint: method(NavigationPointSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }),
29406
+ /**
29407
+ * Enumerate the discrete controls THIS device supports (data-driven UI +
29408
+ * PTZ mimic). Camera-probed subset of {@link NAVIGATION_ACTION_CATALOG}.
29409
+ */
29410
+ listActions: method(object({ deviceId: number() }), array(NavigationActionEntrySchema)),
29411
+ /**
29412
+ * Run one discrete action (a `kind:'action'` dictionary entry). Invalid /
29413
+ * unsupported action ids are rejected by the provider.
29414
+ */
29415
+ runAction: method(object({
29416
+ deviceId: number(),
29417
+ actionId: NavigationActionIdSchema
29418
+ }), _void(), { kind: "mutation" }),
29419
+ /** Play a sound by its wire id (the `soundId` of a `kind:'sound'` entry). */
29420
+ playSound: method(object({
29421
+ deviceId: number(),
29422
+ soundId: number().int()
29423
+ }), _void(), { kind: "mutation" }),
29424
+ /**
29425
+ * Turn the on-camera fill light on / off (the `OpenFullLight` control —
29426
+ * works anytime, no active stream required).
29427
+ */
29428
+ setLightOn: method(object({
29429
+ deviceId: number(),
29430
+ on: boolean()
29431
+ }), _void(), { kind: "mutation" }),
29432
+ /**
29433
+ * Set the fill-light mode (auto vs manual). `manual` optionally carries the
29434
+ * initial `level`. The auto/manual + level control is a CAMERA-service
29435
+ * action that generally needs an active camera stream/monitor session — the
29436
+ * UI shows the manual level slider ONLY when `mode === 'manual'`.
29437
+ */
29438
+ setLightMode: method(object({
29439
+ deviceId: number(),
29440
+ mode: NavigationLightModeSchema,
29441
+ level: number().min(40).max(100).optional()
29442
+ }), _void(), { kind: "mutation" }),
29443
+ /** Set the MANUAL fill-light level (40..100). Implies `manual` mode. */
29444
+ setLightLevel: method(object({
29445
+ deviceId: number(),
29446
+ level: number().min(40).max(100)
29447
+ }), _void(), { kind: "mutation" }),
29448
+ /**
29449
+ * Per-device FEATURE-FLAG report for the general primitives — drives which
29450
+ * controls the UI shows (the per-entry flags for the dictionary come back on
29451
+ * `listActions`).
29452
+ */
29453
+ getFeatures: method(object({ deviceId: number() }), NavigationFeaturesSchema)
29454
+ },
29455
+ events: { onStatusChanged: { data: object({
29456
+ deviceId: number(),
29457
+ status: NavigationStatusSchema
29458
+ }) } },
29459
+ status: {
29460
+ schema: NavigationStatusSchema,
29461
+ kind: "push"
29462
+ },
29463
+ /**
29464
+ * Runtime-state slice mirrored by the kernel. The navigation panel watches it
29465
+ * for live mode / follow / flash changes.
29466
+ */
29467
+ runtimeState: NavigationRuntimeStateSchema,
29468
+ /**
29469
+ * Runtime-state durability: **session** — like `vacuum-control`, a restored
29470
+ * `mode: cleaning` / `following: true` is a robot that is not actually doing
29471
+ * that. The live handle re-publishes on connect.
29472
+ *
29473
+ * See `RuntimeStateDurability`. Enforced by
29474
+ * `scripts/check-runtime-state-durability.ts`.
29475
+ */
29476
+ durability: "session"
29477
+ };
29478
+ /**
29479
+ * Network-link snapshot. Same shape for every provider (a Reolink wifi
29480
+ * camera, a Home Assistant device with a signal-strength sensor, a Tapo
29481
+ * plug): one slice under `device.runtimeState['network-link']`, one badge,
29482
+ * one Home Assistant projection.
29483
+ */
29484
+ var NetworkLinkStatusSchema = object({
29485
+ /** The link the device is on. `'unknown'` = not read yet, not "no link". */
29486
+ type: _enum([
29487
+ "wifi",
29488
+ "ethernet",
29489
+ "cellular",
29490
+ "unknown"
29491
+ ]),
29492
+ /**
29493
+ * Link quality, 0..100 inclusive, normalised by the provider from whatever
29494
+ * the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
29495
+ * KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
29496
+ * one whose reading has not landed must not be drawn at 0 %. Consumers
29497
+ * SKIP a null rather than coerce it.
29498
+ */
29499
+ signalPercent: number().min(0).max(100).nullable(),
29500
+ /** Raw received signal strength in dBm, when the firmware reports one. */
29501
+ rssiDbm: number().optional(),
29502
+ /** Network name of a wireless link, when the firmware reports it. */
29503
+ ssid: string().optional(),
29504
+ /** Ms epoch of the last observation. Lets consumers reason about freshness. */
29505
+ lastUpdated: number()
29506
+ });
29507
+ var networkLinkCapability = {
29508
+ name: "network-link",
29509
+ scope: "device",
29510
+ deviceNative: true,
29511
+ mode: "singleton",
29512
+ deviceTypes: [
29513
+ DeviceType.Camera,
29514
+ DeviceType.Sensor,
29515
+ DeviceType.Button,
29516
+ DeviceType.Switch,
29517
+ DeviceType.Light,
29518
+ DeviceType.Lock,
29519
+ DeviceType.Siren
29520
+ ],
29521
+ methods: {},
29522
+ events: {
29523
+ /**
29524
+ * Emitted whenever the cached status changes (a link switch, a signal
29525
+ * reading that moved). Mirrored on the parent chain by the
29526
+ * DeviceEventPropagator like `battery.onStatusChanged`.
29527
+ */
29528
+ onStatusChanged: { data: object({
29529
+ deviceId: number(),
29530
+ status: NetworkLinkStatusSchema
29531
+ }) } },
29532
+ status: {
29533
+ schema: NetworkLinkStatusSchema,
29534
+ kind: "push",
29535
+ empty: {
29536
+ type: "unknown",
29537
+ signalPercent: null,
29538
+ lastUpdated: 0
29539
+ }
29540
+ },
29541
+ /**
29542
+ * Runtime-state slice — every provider stores the same shape under
29543
+ * `device.runtimeState['network-link']`, read once by the badge and the
29544
+ * Home Assistant projector regardless of the driver.
29545
+ */
29546
+ runtimeState: NetworkLinkStatusSchema,
29547
+ /**
29548
+ * Runtime-state durability: **restored** — a link reading is slow to
29549
+ * change and a sleeping battery camera may not report for hours; the
29550
+ * restored slice is what the badge shows until the next read.
29551
+ *
29552
+ * See `RuntimeStateDurability`. Enforced by
29553
+ * `scripts/check-runtime-state-durability.ts`.
29554
+ */
29555
+ durability: "restored",
29556
+ /** Clock fields: written, but excluded from the compare that decides
29557
+ * whether persisting is worth a SQLite commit. */
29558
+ volatileStateFields: ["lastUpdated"]
29559
+ };
29560
+ /**
29058
29561
  * network-quality — system-scoped singleton capability tracking RTT,
29059
29562
  * jitter, and observed/peak bandwidth per device + per client.
29060
29563
  *
@@ -30669,287 +31172,6 @@ var ptzAutotrackCapability = {
30669
31172
  */
30670
31173
  durability: "session"
30671
31174
  };
30672
- /**
30673
- * `navigation` — a device-scoped capability that natively expresses the FULL
30674
- * navigation / action surface of a robot that DRIVES ITSELF and carries an
30675
- * on-board camera (the Dreame robot-vacuum camera is the first provider).
30676
- *
30677
- * Why a NEW cap rather than overloading `ptz`:
30678
- * - `ptz` moves a *gimbal* on a fixed camera (pan/tilt/zoom of the lens). A
30679
- * robot vacuum has no gimbal — the whole chassis drives, turns and spins.
30680
- * The two are different physical models: PTZ is absolute-position + presets,
30681
- * navigation is momentary drive nudges + discrete robot ACTIONS
30682
- * (dock / spot-clean / follow-pet / go-to-point / …).
30683
- * - This cap is the SOURCE OF TRUTH. Two consumers adapt from it rather than
30684
- * the reverse:
30685
- * 1. a native CamStack navigation panel (data-driven from `listActions`
30686
- * / `getOptions`), and
30687
- * 2. the PTZ surface — a thin adapter mimics `ptz` from `navigation` so a
30688
- * robot camera shows up in the existing PTZ control path without every
30689
- * PTZ provider learning about robots. The mapping lives in the adapter,
30690
- * not here (see the addon design note):
30691
- * ptz.continuousMove({pan,tilt}) → navigation.move({pan,tilt})
30692
- * ptz.stop() → navigation.stop()
30693
- * ptz.goHome() → navigation.runAction('goHome')
30694
- * ptz.getPresets() → navigation.listActions() (id→preset)
30695
- * ptz.goToPreset(id) → navigation.runAction(id)
30696
- *
30697
- * ## Continuous drive
30698
- *
30699
- * `move` is MOMENTARY. Fluid navigation comes from the UI (or the PTZ adapter)
30700
- * sending `move({pan,tilt})` REPEATEDLY at ~1 Hz while a direction is held, and
30701
- * one `stop()` on release — exactly like the robot app's remote-drive joystick.
30702
- * The provider forwards EACH `move` to one drive write; it must NOT debounce or
30703
- * coalesce them. The UI owns the cadence.
30704
- *
30705
- * ## The action dictionary
30706
- *
30707
- * The discrete controls (dock / locate / spot-clean / follow / flash / sounds)
30708
- * are a DATA-DRIVEN dictionary the cap exposes via `listActions()`. Each entry
30709
- * carries `{ id, kind, label, icon }` (plus `soundId` for sound entries) so the
30710
- * native panel AND the PTZ mimic render buttons WITHOUT hardcoding a
30711
- * vendor-specific list. `kind: 'action'` entries are triggered with
30712
- * `runAction({ actionId })`; `kind: 'sound'` entries with `playSound({ soundId })`
30713
- * (the entry carries the `soundId` to pass). The general primitives — `move`,
30714
- * `stop`, `goToPoint` — stay as first-class methods, not dictionary entries.
30715
- *
30716
- * NOTE (provider wiring): the first provider (Dreame) drives this with the RAW
30717
- * `callAction(siid,aiid,in)` / `setProperty({siid,piid,value})` MIoT primitives
30718
- * that the currently-published `@apocaliss92/nodedreame` already exposes on
30719
- * every device handle. A future nodedreame publish adds a typed
30720
- * `DreameCameraController` (drive / playPetSound / spotClean / findPet / …); the
30721
- * provider can then swap the raw calls for the typed methods with no change to
30722
- * THIS contract.
30723
- */
30724
- /**
30725
- * A momentary drive nudge. The robot MOVES (no gimbal) for as long as the caller
30726
- * keeps sending nudges (~1 Hz); an explicit `stop` (or letting the nudges lapse)
30727
- * halts it.
30728
- *
30729
- * - `pan` — turn: negative = left, positive = right, 0 = straight.
30730
- * - `tilt` — throttle: positive = forward, negative = spin / turn-around.
30731
- * - `speed` — optional intensity hint [0, 1]; the provider may scale the drive
30732
- * vector by it (drivers without proportional drive ignore it).
30733
- *
30734
- * `pan` / `tilt` are normalized [-1, 1]. Both optional so a caller can nudge one
30735
- * axis alone; an all-undefined nudge is a no-op.
30736
- */
30737
- var NavigationMoveCommandSchema = object({
30738
- pan: number().min(-1).max(1).optional(),
30739
- tilt: number().min(-1).max(1).optional(),
30740
- speed: number().min(0).max(1).optional()
30741
- });
30742
- /**
30743
- * The enumerated discrete actions a navigation-capable robot can perform via
30744
- * `runAction`. This is the CLOSED vocabulary; a given device advertises the
30745
- * subset it supports through `listActions`. Sounds are NOT here — they go through
30746
- * `playSound` (see the `sound` dictionary entries).
30747
- */
30748
- var NavigationActionIdSchema = _enum([
30749
- "goHome",
30750
- "locate",
30751
- "spotClean",
30752
- "findPet",
30753
- "personFollow",
30754
- "stop",
30755
- "startClean",
30756
- "pauseClean",
30757
- "dockWash",
30758
- "autoEmpty",
30759
- "flashOn",
30760
- "flashOff"
30761
- ]);
30762
- /** Whether a dictionary entry is a `runAction` action or a `playSound` sound. */
30763
- var NavigationEntryKindSchema = _enum(["action", "sound"]);
30764
- /**
30765
- * One entry in the navigation action dictionary — the DATA-DRIVEN unit both the
30766
- * native panel and the PTZ mimic render as a button.
30767
- *
30768
- * - `id` — stable id. For `kind:'action'` it is a {@link NavigationActionId}
30769
- * (pass to `runAction`); for `kind:'sound'` it is a namespaced id
30770
- * (`sound:meow`) whose `soundId` is passed to `playSound`.
30771
- * - `icon` — icon HINT (lucide-style name; the UI maps it to its own set).
30772
- * - `label` — operator-facing English label.
30773
- * - `soundId` — wire sound id, present only on `kind:'sound'` entries.
30774
- * - `enabled` — per-device FEATURE FLAG. `listActions` reports it so the UI /
30775
- * PTZ render ONLY enabled entries. Data-driven: the provider
30776
- * flips it from config, never by editing code.
30777
- */
30778
- var NavigationActionEntrySchema = object({
30779
- id: string(),
30780
- kind: NavigationEntryKindSchema,
30781
- label: string(),
30782
- icon: string(),
30783
- /** Present only on `kind:'sound'` entries — the id to pass to `playSound`. */
30784
- soundId: number().int().optional(),
30785
- /** Per-device feature flag — render this entry only when true. */
30786
- enabled: boolean()
30787
- });
30788
- /** Coordinates for `goToPoint` — a point on the robot's live map. */
30789
- var NavigationPointSchema = object({
30790
- x: number(),
30791
- y: number()
30792
- });
30793
- /**
30794
- * Per-device FEATURE-FLAG report for the general (non-dictionary) primitives.
30795
- * The cap reports which are enabled so the UI / PTZ render only the controls
30796
- * that are turned on for THIS device. Data-driven: the provider derives these
30797
- * from config + probe, never hardcoded in the UI. The per-DICTIONARY-entry flags
30798
- * live on {@link NavigationActionEntrySchema.enabled}; these gate the primitives
30799
- * that are not dictionary entries.
30800
- *
30801
- * - `move` / `stop` — the momentary drive joystick.
30802
- * - `goToPoint` — send-to-map-coordinate. Ships OFF on Dreame until the
30803
- * map-coordinate plumbing is wired.
30804
- * - `runAction` — the discrete action buttons (dictionary `kind:'action'`).
30805
- * - `playSound` — the sound buttons (dictionary `kind:'sound'`).
30806
- * - `light` — the on/off fill-light toggle (works anytime).
30807
- * - `lightMode` — the auto/manual selector + manual level slider (a
30808
- * camera-service control; needs an active stream).
30809
- */
30810
- var NavigationFeaturesSchema = object({
30811
- move: boolean(),
30812
- stop: boolean(),
30813
- goToPoint: boolean(),
30814
- runAction: boolean(),
30815
- playSound: boolean(),
30816
- light: boolean(),
30817
- lightMode: boolean()
30818
- });
30819
- /** Light mode: `auto` lets the camera choose brightness; `manual` uses `level`. */
30820
- var NavigationLightModeSchema = _enum(["auto", "manual"]);
30821
- /**
30822
- * Live navigation state so the UI can reflect what the robot is doing:
30823
- * - `mode` — coarse activity (idle / cleaning / following / …).
30824
- * - `following` — person/pet follow is currently armed.
30825
- * - `flash` — the on-camera fill light is on.
30826
- * - `lightMode` — auto vs manual fill-light mode.
30827
- * - `lightLevel` — manual fill-light level (40..100); meaningful when
30828
- * `lightMode === 'manual'`.
30829
- */
30830
- var NavigationStatusSchema = object({
30831
- mode: _enum([
30832
- "idle",
30833
- "cleaning",
30834
- "spot",
30835
- "following",
30836
- "goto",
30837
- "returning",
30838
- "paused",
30839
- "unknown"
30840
- ]),
30841
- following: boolean(),
30842
- flash: boolean(),
30843
- lightMode: NavigationLightModeSchema,
30844
- lightLevel: number().min(40).max(100),
30845
- /** Ms epoch when the slice was last updated. */
30846
- lastChangedAt: number()
30847
- });
30848
- /**
30849
- * Runtime-state slice owned by this cap (kernel-managed: validated, mirrored,
30850
- * observable). Adds `lastFetchedAt` on top of the status shape per the
30851
- * convention.
30852
- */
30853
- var NavigationRuntimeStateSchema = NavigationStatusSchema.extend({ lastFetchedAt: number() });
30854
- var navigationCapability = {
30855
- name: "navigation",
30856
- scope: "device",
30857
- deviceNative: true,
30858
- mode: "singleton",
30859
- deviceTypes: [DeviceType.Camera],
30860
- deviceConfig: { ui: {
30861
- kind: "widget",
30862
- widgetId: "host/navigation-panel",
30863
- tab: "navigation",
30864
- topTab: true,
30865
- label: "Navigation",
30866
- order: 0
30867
- } },
30868
- methods: {
30869
- /**
30870
- * Momentary drive nudge (the robot moves). `protected` — mirrors
30871
- * `ptz.continuousMove` so the Viewer navigation panel (and the PTZ-mimic
30872
- * path) works for any authenticated user, not admin-only. The UI sends
30873
- * these at ~1 Hz while a control is held; the provider forwards each one to
30874
- * a single drive write WITHOUT debouncing.
30875
- */
30876
- move: method(NavigationMoveCommandSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }),
30877
- /** Halt all motion immediately (zero drive vector). */
30878
- stop: method(object({ deviceId: number() }), _void(), { kind: "mutation" }),
30879
- /** Send the robot to a point on its live map. */
30880
- goToPoint: method(NavigationPointSchema.extend({ deviceId: number() }), _void(), { kind: "mutation" }),
30881
- /**
30882
- * Enumerate the discrete controls THIS device supports (data-driven UI +
30883
- * PTZ mimic). Camera-probed subset of {@link NAVIGATION_ACTION_CATALOG}.
30884
- */
30885
- listActions: method(object({ deviceId: number() }), array(NavigationActionEntrySchema)),
30886
- /**
30887
- * Run one discrete action (a `kind:'action'` dictionary entry). Invalid /
30888
- * unsupported action ids are rejected by the provider.
30889
- */
30890
- runAction: method(object({
30891
- deviceId: number(),
30892
- actionId: NavigationActionIdSchema
30893
- }), _void(), { kind: "mutation" }),
30894
- /** Play a sound by its wire id (the `soundId` of a `kind:'sound'` entry). */
30895
- playSound: method(object({
30896
- deviceId: number(),
30897
- soundId: number().int()
30898
- }), _void(), { kind: "mutation" }),
30899
- /**
30900
- * Turn the on-camera fill light on / off (the `OpenFullLight` control —
30901
- * works anytime, no active stream required).
30902
- */
30903
- setLightOn: method(object({
30904
- deviceId: number(),
30905
- on: boolean()
30906
- }), _void(), { kind: "mutation" }),
30907
- /**
30908
- * Set the fill-light mode (auto vs manual). `manual` optionally carries the
30909
- * initial `level`. The auto/manual + level control is a CAMERA-service
30910
- * action that generally needs an active camera stream/monitor session — the
30911
- * UI shows the manual level slider ONLY when `mode === 'manual'`.
30912
- */
30913
- setLightMode: method(object({
30914
- deviceId: number(),
30915
- mode: NavigationLightModeSchema,
30916
- level: number().min(40).max(100).optional()
30917
- }), _void(), { kind: "mutation" }),
30918
- /** Set the MANUAL fill-light level (40..100). Implies `manual` mode. */
30919
- setLightLevel: method(object({
30920
- deviceId: number(),
30921
- level: number().min(40).max(100)
30922
- }), _void(), { kind: "mutation" }),
30923
- /**
30924
- * Per-device FEATURE-FLAG report for the general primitives — drives which
30925
- * controls the UI shows (the per-entry flags for the dictionary come back on
30926
- * `listActions`).
30927
- */
30928
- getFeatures: method(object({ deviceId: number() }), NavigationFeaturesSchema)
30929
- },
30930
- events: { onStatusChanged: { data: object({
30931
- deviceId: number(),
30932
- status: NavigationStatusSchema
30933
- }) } },
30934
- status: {
30935
- schema: NavigationStatusSchema,
30936
- kind: "push"
30937
- },
30938
- /**
30939
- * Runtime-state slice mirrored by the kernel. The navigation panel watches it
30940
- * for live mode / follow / flash changes.
30941
- */
30942
- runtimeState: NavigationRuntimeStateSchema,
30943
- /**
30944
- * Runtime-state durability: **session** — like `vacuum-control`, a restored
30945
- * `mode: cleaning` / `following: true` is a robot that is not actually doing
30946
- * that. The live handle re-publishes on connect.
30947
- *
30948
- * See `RuntimeStateDurability`. Enforced by
30949
- * `scripts/check-runtime-state-durability.ts`.
30950
- */
30951
- durability: "session"
30952
- };
30953
31175
  DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
30954
31176
  kind: "mutation",
30955
31177
  auth: "admin"
@@ -40213,6 +40435,12 @@ Object.freeze({
40213
40435
  addonId: null,
40214
40436
  access: "view"
40215
40437
  },
40438
+ "storage.listDrainProgress": {
40439
+ capName: "storage",
40440
+ capScope: "system",
40441
+ addonId: null,
40442
+ access: "view"
40443
+ },
40216
40444
  "storage.listLocationDeclarations": {
40217
40445
  capName: "storage",
40218
40446
  capScope: "system",
@@ -40357,6 +40585,12 @@ Object.freeze({
40357
40585
  addonId: null,
40358
40586
  access: "view"
40359
40587
  },
40588
+ "storageOccupancy.getOccupancy": {
40589
+ capName: "storage-occupancy",
40590
+ capScope: "system",
40591
+ addonId: null,
40592
+ access: "view"
40593
+ },
40360
40594
  "storageProvider.abortUpload": {
40361
40595
  capName: "storage-provider",
40362
40596
  capScope: "system",
@@ -44360,4 +44594,4 @@ function vectorDimFromBase64(encoded) {
44360
44594
  return Math.floor(Buffer.from(encoded, "base64").byteLength / 4);
44361
44595
  }
44362
44596
  //#endregion
44363
- export { audioModeOf as $, NcSnoozeSchema as A, BaseAddon as At, SCENE_DEFAULT_UNCOVERED_POLICY as B, boolean as Bt, NcConditionDescriptorSchema as C, sceneMonitorCapability as Ct, NcRuleTargetSchema as D, videoclipsCapability as Dt, NcRuleSchema as E, vectorDimFromBase64 as Et, PoolMemoryWatchdog as F, isDeviceScopedCap as Ft, TimelapseRulePatchSchema as G, partialRecord as Gt, SceneMonitorSchema as H, literal as Ht, RECORDING_EXPORT_MAX_READ_BYTES as I, nodePin as It, VISIT_MERGE_GAP_MS as J, unknown as Jt, TimelapseRuleSchema as K, record as Kt, RetrainStatusSchema as L, sleep as Lt, NcSystemEventKindSchema as M, DeviceType as Mt, NcTaxonomySchema as N, createEvent as Nt, NcScheduleSchema as O, zoneAnalyticsCapability as Ot, OpsLogEntrySchema as P, hydrateSchema as Pt, audioMetricsCapability as Q, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS as R, _enum as Rt, NC_TAXONOMY as S, resolvePoolMemoryPolicy as St, NcRulePatchSchema as T, systemEventFilterApplies as Tt, TIMELAPSE_DENSE_FLOOR_SEC as U, number as Ut, SCENE_DIVERGED as V, discriminatedUnion as Vt, TimelapseRuleInputSchema as W, object as Wt, alarmPanelCapability as X, addonWidgetsSourceCapability as Y, EventCategory as Yt, assertTimelapseCadences as Z, MediaFileKindEnum as _, pickClusterStepModels as _t, DEFAULT_EVENT_COLOR as a, embeddingEncoderCapability as at, NC_DEFAULT_SNOOZE_MINUTES as b, readDeviceStateFrom as bt, DETECTION_MACRO_CLASSES as c, faceGalleryCapability as ct, EVENT_KIND_BY_CAP as d, isDetectionMacroClass as dt, buildEventKindDescriptor as et, EVENT_PAD_MS as f, isScheduleActive as ft, MACRO_LABELS as g, parseProcStatus as gt, LabelAttributionSchema as h, notificationRulesCapability as ht, COCO_TO_MACRO as i, deriveRecordingMode as it, NcSnoozeSuppressedSchema as j, CamProfileSchema as jt, NcSnoozeInputSchema as k, errMsg as kt, DETECTION_PIPELINE_CAP_NAME as l, failureContributionCapability as lt, FailureCounters as m, kebabToCamel as mt, BaseDevice as n, customAction as nt, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as o, encodeVectorBase64 as ot, FULL_IMAGE_BBOX as p, isSourceCap as pt, TrackSourceSchema as q, string as qt, CLUSTER_MODEL_SCOPED_STEPS as r, defineCustomActions as rt, DEFAULT_TIMELAPSE_PREVIEW_TEXT as s, evaluateSensorEdge as st, AUDIO_MACRO_LABELS as t, cosineSimilarity as tt, DeclaredDevices as u, hfModelUrl as ut, NC_ALARM_SYSTEM_EVENT_KINDS as v, pipelineAnalyticsCapability as vt, NcRuleInputSchema as w, subKindsOf as wt, NC_SNOOZE_MAX_MINUTES as x, readTimelapseGeneratedAt as xt, NC_CONDITION_CATALOG as y, plateGalleryCapability as yt, SCENE_DEFAULT_ANCHOR_THRESHOLD as z, array as zt };
44597
+ export { audioModeOf as $, EventCategory as $t, NcSnoozeSchema as A, vectorDimFromBase64 as At, SCENE_DEFAULT_UNCOVERED_POLICY as B, nodePin as Bt, NcConditionDescriptorSchema as C, readTimelapseGeneratedAt as Ct, NcRuleTargetSchema as D, storageOccupancyCapability as Dt, NcRuleSchema as E, sceneMonitorCapability as Et, PoolMemoryWatchdog as F, CamProfileSchema as Ft, TimelapseRulePatchSchema as G, discriminatedUnion as Gt, SceneMonitorSchema as H, _enum as Ht, RECORDING_EXPORT_MAX_READ_BYTES as I, DeviceType as It, VISIT_MERGE_GAP_MS as J, object as Jt, TimelapseRuleSchema as K, literal as Kt, RetrainStatusSchema as L, createEvent as Lt, NcSystemEventKindSchema as M, zoneAnalyticsCapability as Mt, NcTaxonomySchema as N, errMsg as Nt, NcScheduleSchema as O, subKindsOf as Ot, OpsLogEntrySchema as P, BaseAddon as Pt, audioMetricsCapability as Q, unknown as Qt, SCENE_CONFIRM_DEFAULT_TIMEOUT_MS as R, hydrateSchema as Rt, NC_TAXONOMY as S, readDeviceStateFrom as St, NcRulePatchSchema as T, resolvePoolMemoryPolicy as Tt, TIMELAPSE_DENSE_FLOOR_SEC as U, array as Ut, SCENE_DIVERGED as V, sleep as Vt, TimelapseRuleInputSchema as W, boolean as Wt, alarmPanelCapability as X, record as Xt, addonWidgetsSourceCapability as Y, partialRecord as Yt, assertTimelapseCadences as Z, string as Zt, MediaFileKindEnum as _, notificationRulesCapability as _t, DEFAULT_EVENT_COLOR as a, embeddingEncoderCapability as at, NC_DEFAULT_SNOOZE_MINUTES as b, pipelineAnalyticsCapability as bt, DETECTION_MACRO_CLASSES as c, evictionPolicyOfLocation as ct, EVENT_KIND_BY_CAP as d, hfModelUrl as dt, buildEventKindDescriptor as et, EVENT_PAD_MS as f, isDetectionMacroClass as ft, MACRO_LABELS as g, mayWriteToLocation as gt, LabelAttributionSchema as h, kebabToCamel as ht, COCO_TO_MACRO as i, deriveRecordingMode as it, NcSnoozeSuppressedSchema as j, videoclipsCapability as jt, NcSnoozeInputSchema as k, systemEventFilterApplies as kt, DETECTION_PIPELINE_CAP_NAME as l, faceGalleryCapability as lt, FailureCounters as m, isSourceCap as mt, BaseDevice as n, customAction as nt, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as o, encodeVectorBase64 as ot, FULL_IMAGE_BBOX as p, isScheduleActive as pt, TrackSourceSchema as q, number as qt, CLUSTER_MODEL_SCOPED_STEPS as r, defineCustomActions as rt, DEFAULT_TIMELAPSE_PREVIEW_TEXT as s, evaluateSensorEdge as st, AUDIO_MACRO_LABELS as t, cosineSimilarity as tt, DeclaredDevices as u, failureContributionCapability as ut, NC_ALARM_SYSTEM_EVENT_KINDS as v, parseProcStatus as vt, NcRuleInputSchema as w, resolveLocationMode as wt, NC_SNOOZE_MAX_MINUTES as x, plateGalleryCapability as xt, NC_CONDITION_CATALOG as y, pickClusterStepModels as yt, SCENE_DEFAULT_ANCHOR_THRESHOLD as z, isDeviceScopedCap as zt };