@camstack/addon-provider-homeassistant 1.2.149 → 1.2.150

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.
@@ -11789,6 +11789,68 @@ method(object({
11789
11789
  password: string()
11790
11790
  }), AuthResultSchema.nullable(), { kind: "mutation" }), method(object({ state: string() }), string()), method(record(string(), string()), AuthResultSchema, { kind: "mutation" }), method(object({ token: string() }), AuthResultSchema.nullable());
11791
11791
  /**
11792
+ * How long one snapshot may take end to end: the pinned copy of the whole
11793
+ * database plus `PRAGMA integrity_check` over the copy, on the hub's slowest
11794
+ * disk. ~800 MB at a pessimistic 10 MB/s is under 3 minutes; the bound is
11795
+ * generous because a timeout fails the whole backup run.
11796
+ */
11797
+ var DATABASE_SNAPSHOT_TIMEOUT_MS = 30 * 6e4;
11798
+ /**
11799
+ * The databases an owner snapshots — declared by the OWNER, so a caller never
11800
+ * guesses which file is live from what sits beside it (a cleanly closed
11801
+ * database has no sidecars and is just as owned). Paths are absolute on the
11802
+ * owner's host.
11803
+ */
11804
+ var DatabaseSnapshotTargetsSchema = object({ databases: array(object({ livePath: string() })) });
11805
+ /** One b-tree table of the snapshot and the rows it holds. */
11806
+ var DatabaseSnapshotTableSchema = object({
11807
+ name: string(),
11808
+ rows: number().int().nonnegative()
11809
+ });
11810
+ /**
11811
+ * What the owner wrote. Every path is ABSOLUTE on the owner's host — the
11812
+ * caller pins the call to its own node, so it can read the file; a caller
11813
+ * that finds the path outside its own data root refuses it rather than
11814
+ * archiving something it cannot place.
11815
+ */
11816
+ var DatabaseSnapshotResultSchema = object({
11817
+ /** The live database the snapshot copies. Never to be copied as a file. */
11818
+ livePath: string(),
11819
+ /** The verified copy: `<livePath>` + {@link DATABASE_SNAPSHOT_SUFFIX}. */
11820
+ snapshotPath: string(),
11821
+ sizeBytes: number().int().nonnegative(),
11822
+ pageCount: number().int().nonnegative(),
11823
+ pageSize: number().int().positive(),
11824
+ /**
11825
+ * Every b-tree table with its row count. Read inside the SAME read
11826
+ * transaction the copy was taken from, and found EQUAL on the copy — so
11827
+ * this is the content of the snapshot, not an estimate of the source.
11828
+ */
11829
+ tables: array(DatabaseSnapshotTableSchema),
11830
+ /** Wall time of the pinned copy (row counts included). */
11831
+ copyMs: number().nonnegative(),
11832
+ /** Wall time of the checks on the copy (`integrity_check`, row counts). */
11833
+ verifyMs: number().nonnegative(),
11834
+ /** When the pinned read transaction began (ms epoch) — the snapshot's instant. */
11835
+ takenAt: number()
11836
+ });
11837
+ /**
11838
+ * A snapshot as an ARCHIVE records it (`ArchiveManifest.sqliteSnapshots`):
11839
+ * the same facts, with both paths relative to the archive root (the node's
11840
+ * data dir), because an archive outlives the host that made it.
11841
+ */
11842
+ var ArchiveSqliteSnapshotSchema = DatabaseSnapshotResultSchema.extend({
11843
+ /** Archive-relative path of the live database the archive does NOT carry. */
11844
+ livePath: string(),
11845
+ /** Archive-relative path of the verified copy it carries in its place. */
11846
+ snapshotPath: string()
11847
+ });
11848
+ method(object({}), DatabaseSnapshotTargetsSchema, { auth: "admin" }), method(object({}), DatabaseSnapshotResultSchema, {
11849
+ kind: "mutation",
11850
+ auth: "admin",
11851
+ timeoutMs: DATABASE_SNAPSHOT_TIMEOUT_MS
11852
+ });
11853
+ /**
11792
11854
  * Orchestrator-side destination metadata. The orchestrator computes
11793
11855
  * `id = <addonId>:<subId>` from its provider lookup so consumers
11794
11856
  * (admin UI, restore flow) see one canonical key.
@@ -11899,7 +11961,12 @@ var ArchiveManifestSchema = object({
11899
11961
  locations: array(string()),
11900
11962
  entries: array(ArchiveEntrySchema),
11901
11963
  totalBytes: number(),
11902
- totalFiles: number()
11964
+ totalFiles: number(),
11965
+ /**
11966
+ * Live SQLite databases this archive carries as their OWNER's verified
11967
+ * snapshot instead of as files (D693). Absent on archives made before.
11968
+ */
11969
+ sqliteSnapshots: array(ArchiveSqliteSnapshotSchema).optional()
11903
11970
  });
11904
11971
  var LocationStatSchema = object({
11905
11972
  name: string(),
@@ -13474,6 +13541,52 @@ var CompositionBlockStateSchema = object({
13474
13541
  reason: string().optional(),
13475
13542
  fields: array(CompositionFieldStateSchema)
13476
13543
  });
13544
+ var ComposerBlockSchema = object({
13545
+ id: string().min(1),
13546
+ name: string().min(1).max(120),
13547
+ enabled: boolean(),
13548
+ updatedAt: number(),
13549
+ composition: CompositionSchema
13550
+ });
13551
+ /**
13552
+ * A stored composition row that no longer PARSES — a schema a release
13553
+ * tightened, a row written by a newer build. Sent by id so the composer keeps
13554
+ * its device as a placeholder and reports the block `failed` naming the parse
13555
+ * error. Leaving it out would read, twice, exactly like a delete (D49).
13556
+ */
13557
+ var ComposerUnreadableBlockSchema = object({
13558
+ id: string().min(1),
13559
+ /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
13560
+ name: string().nullable(),
13561
+ /** The parse error, in the operator's words. */
13562
+ error: string()
13563
+ });
13564
+ method(object({
13565
+ /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
13566
+ integrationId: string().nullable(),
13567
+ /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
13568
+ storeLoaded: boolean(),
13569
+ blocks: array(ComposerBlockSchema),
13570
+ /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
13571
+ restartBlockIds: array(string()),
13572
+ /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
13573
+ unreadableBlocks: array(ComposerUnreadableBlockSchema)
13574
+ }), object({
13575
+ blocks: array(object({
13576
+ blockId: string(),
13577
+ status: CompositionRunStatusSchema,
13578
+ reason: string().optional()
13579
+ })),
13580
+ /**
13581
+ * False when the composer declared and withdrew NOTHING (store not loaded,
13582
+ * integration unknown, its own rows unread or read empty once). An empty
13583
+ * apply the caller owes is paid off only by one the composer acted on (D49).
13584
+ */
13585
+ acted: boolean()
13586
+ }), {
13587
+ kind: "mutation",
13588
+ auth: "admin"
13589
+ }), method(object({ blockIds: array(string()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
13477
13590
  var NUMBER = {
13478
13591
  kind: "fixed",
13479
13592
  result: ["number"]
@@ -13710,52 +13823,6 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
13710
13823
  auth: "admin",
13711
13824
  access: "view"
13712
13825
  });
13713
- var ComposerBlockSchema = object({
13714
- id: string().min(1),
13715
- name: string().min(1).max(120),
13716
- enabled: boolean(),
13717
- updatedAt: number(),
13718
- composition: CompositionSchema
13719
- });
13720
- /**
13721
- * A stored composition row that no longer PARSES — a schema a release
13722
- * tightened, a row written by a newer build. Sent by id so the composer keeps
13723
- * its device as a placeholder and reports the block `failed` naming the parse
13724
- * error. Leaving it out would read, twice, exactly like a delete (D49).
13725
- */
13726
- var ComposerUnreadableBlockSchema = object({
13727
- id: string().min(1),
13728
- /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
13729
- name: string().nullable(),
13730
- /** The parse error, in the operator's words. */
13731
- error: string()
13732
- });
13733
- method(object({
13734
- /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
13735
- integrationId: string().nullable(),
13736
- /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
13737
- storeLoaded: boolean(),
13738
- blocks: array(ComposerBlockSchema),
13739
- /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
13740
- restartBlockIds: array(string()),
13741
- /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
13742
- unreadableBlocks: array(ComposerUnreadableBlockSchema)
13743
- }), object({
13744
- blocks: array(object({
13745
- blockId: string(),
13746
- status: CompositionRunStatusSchema,
13747
- reason: string().optional()
13748
- })),
13749
- /**
13750
- * False when the composer declared and withdrew NOTHING (store not loaded,
13751
- * integration unknown, its own rows unread or read empty once). An empty
13752
- * apply the caller owes is paid off only by one the composer acted on (D49).
13753
- */
13754
- acted: boolean()
13755
- }), {
13756
- kind: "mutation",
13757
- auth: "admin"
13758
- }), method(object({ blockIds: array(string()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
13759
13826
  /**
13760
13827
  * `custom-model-registry` — collection cap exposing operator-registered
13761
13828
  * custom detection models. Each provider (today: `addon-model-studio`)
@@ -16027,6 +16094,219 @@ method(object({
16027
16094
  caps: array(string()).readonly().optional()
16028
16095
  }), record(string(), record(string(), unknown().nullable())));
16029
16096
  /**
16097
+ * Doorbell button cap. Two kinds of providers coexist behind this cap
16098
+ * name (same pattern as `snapshot`):
16099
+ *
16100
+ * - **Native** providers: registered per-device by device-driver
16101
+ * addons via `ctx.registerNativeCap` — either on a
16102
+ * `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
16103
+ * or directly on the camera (Reolink registers at camera level).
16104
+ * Emits an `onPressed` event every time the firmware pushes a
16105
+ * ring; status tracks the last press and a pressCount since start
16106
+ * (diagnostic).
16107
+ *
16108
+ * - **Wrapper** provider: the `virtual-doorbell` system builtin
16109
+ * (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
16110
+ * device (contact / switch / event-emitter …) into a doorbell for
16111
+ * a camera. `defaultActive: false` — the operator explicitly binds
16112
+ * it per camera in the device-bindings UI, then picks the source
16113
+ * device + trigger in the per-device settings.
16114
+ *
16115
+ * The DeviceEventPropagator re-emits `onPressed` on the camera parent
16116
+ * — subscribers listening at the camera level receive ring events
16117
+ * with `via[]` populated. No code on the parent needed.
16118
+ */
16119
+ var DoorbellStatusSchema = object({
16120
+ /** Ms epoch of the last press. null = never observed since this provider started. */
16121
+ lastPressedAt: number().nullable(),
16122
+ /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
16123
+ pressCountSinceStart: number()
16124
+ });
16125
+ var DoorbellPressEventSchema = object({
16126
+ deviceId: number(),
16127
+ timestamp: number()
16128
+ });
16129
+ /**
16130
+ * The `doorbell-source` extension slot's editable value (D648): the camera's
16131
+ * virtual-doorbell trigger devices, exactly what the wrapper's
16132
+ * `doorbellSources` persists (as `{ deviceId }` records).
16133
+ */
16134
+ var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number().int().positive()) });
16135
+ /**
16136
+ * The `doorbell-source` slot — which devices ring this camera's VIRTUAL
16137
+ * doorbell, owned by the `virtual-doorbell` wrapper over its
16138
+ * `doorbellSources` store (D648). A source rings when one of its
16139
+ * `SOURCE_CAPS` rises. Whether the wrapper is bound to the camera at all is a
16140
+ * different authority (`deviceManager.setWrapperActive`, D62) — the slot
16141
+ * reports it, it never writes it.
16142
+ */
16143
+ var DOORBELL_SOURCE_SLOT = {
16144
+ id: "doorbell-source",
16145
+ label: "Doorbell trigger devices",
16146
+ description: "Any of these becoming active rings this camera's virtual doorbell: a binary sensor when it goes active, a switch when it turns on.",
16147
+ shape: "association",
16148
+ hostDeviceTypes: [DeviceType.Camera],
16149
+ sourceCaps: SOURCE_CAPS,
16150
+ cardinality: "many",
16151
+ value: DoorbellSourceSlotValueSchema
16152
+ };
16153
+ var doorbellCapability = {
16154
+ name: "doorbell",
16155
+ scope: "device",
16156
+ deviceNative: true,
16157
+ mode: "singleton",
16158
+ kind: "wrapper",
16159
+ defaultActive: false,
16160
+ deviceTypes: [DeviceType.Button, DeviceType.Camera],
16161
+ extensionSlots: [DOORBELL_SOURCE_SLOT],
16162
+ methods: {},
16163
+ events: {
16164
+ /**
16165
+ * Fires once per physical press. Reolink delivers via Baichuan
16166
+ * push (`ReolinkSimpleEvent.type === 'doorbell'`). There is no
16167
+ * release/duration — it's a pulse.
16168
+ */
16169
+ onPressed: {
16170
+ data: DoorbellPressEventSchema,
16171
+ fromState: {
16172
+ field: "lastPressedAt",
16173
+ on: "advance"
16174
+ }
16175
+ } },
16176
+ status: {
16177
+ schema: DoorbellStatusSchema,
16178
+ kind: "push"
16179
+ },
16180
+ /**
16181
+ * Runtime-state slice — last press timestamp + lifetime press count.
16182
+ * Mirrored by the kernel and readable via
16183
+ * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
16184
+ * without subscribing.
16185
+ */
16186
+ runtimeState: DoorbellStatusSchema,
16187
+ /**
16188
+ * Runtime-state durability: **restored** — a monotonic accumulator: the slice IS the record. `lastPressedAt` is content here, not a clock, so it is deliberately NOT volatile.
16189
+ *
16190
+ * See `RuntimeStateDurability`. Enforced by
16191
+ * `scripts/check-runtime-state-durability.ts`.
16192
+ */
16193
+ durability: "restored"
16194
+ };
16195
+ var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
16196
+ DeviceType.Camera, DeviceType.Camera;
16197
+ /** A slot's editable value, discriminated on `slot`. */
16198
+ var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
16199
+ DeviceType.Camera;
16200
+ var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
16201
+ state: literal("unreachable"),
16202
+ reason: string()
16203
+ })]);
16204
+ /** One provider of slots — the D554 source-listing row. */
16205
+ var ExtensionSourceSchema = object({
16206
+ /** The routing prefix of every `slotRef` this provider serves. */
16207
+ source: string(),
16208
+ label: string(),
16209
+ /** Stamped by the dispatcher from the registry (D557). */
16210
+ addonId: string().optional(),
16211
+ availability: ExtensionSourceAvailabilitySchema
16212
+ });
16213
+ /**
16214
+ * How one picked source stands. `missing` — no such device (deleted, or an id
16215
+ * that never existed); `foreign` — a device the slot's owner cannot read from
16216
+ * (a source owned by another addon); `unavailable` — it exists but is not a
16217
+ * valid source now (a container, which is never a pick). A source in any of
16218
+ * these states is SHOWN, never silently dropped or re-pointed.
16219
+ */
16220
+ var ExtensionSourceHealthSchema = _enum([
16221
+ "ok",
16222
+ "missing",
16223
+ "foreign",
16224
+ "unavailable"
16225
+ ]);
16226
+ var ExtensionSlotSourceSchema = object({
16227
+ deviceId: number().int(),
16228
+ /** The device's name, or null when it could not be resolved (`missing`). */
16229
+ name: string().nullable(),
16230
+ health: ExtensionSourceHealthSchema,
16231
+ detail: string().optional()
16232
+ });
16233
+ /**
16234
+ * A DIFFERENT authority that gates whether the slot's sources do anything —
16235
+ * reported read-only, named, never written through this contract (D62). The
16236
+ * virtual doorbell's sources ring only while the wrapper is bound to the
16237
+ * camera, and that binding belongs to `deviceManager.setWrapperActive`.
16238
+ * `unknown` means the gate could not be read; it is not "inactive" (D315).
16239
+ */
16240
+ var ExtensionSlotActivationSchema = object({
16241
+ state: _enum([
16242
+ "active",
16243
+ "inactive",
16244
+ "unknown"
16245
+ ]),
16246
+ authority: string(),
16247
+ detail: string().optional()
16248
+ });
16249
+ var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
16250
+ state: literal("ok"),
16251
+ /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
16252
+ slotRef: string(),
16253
+ slot: ExtensionSlotIdSchema,
16254
+ /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
16255
+ authority: string(),
16256
+ activation: ExtensionSlotActivationSchema.nullable(),
16257
+ value: ExtensionSlotValueSchema,
16258
+ sources: array(ExtensionSlotSourceSchema),
16259
+ /**
16260
+ * Devices the owner links to the host ON ITS OWN, by structure, and that
16261
+ * are therefore not in `value` (D655): a camera's device-tree children, and
16262
+ * the child a picked container stands for (D356 — a container is never a
16263
+ * pick, its children are). Read-only; the editor shows them and may offer
16264
+ * per-device options on them (the linked-devices tracked-event opt-in).
16265
+ * Absent when the owner links nothing beyond the picks, and from an owner
16266
+ * older than D655.
16267
+ */
16268
+ impliedSources: array(ExtensionSlotSourceSchema).optional()
16269
+ }), object({
16270
+ state: literal("unreachable"),
16271
+ addonId: string(),
16272
+ reason: string()
16273
+ })]);
16274
+ var ExtensionCandidatesSchema = object({ candidates: array(object({
16275
+ deviceId: number().int(),
16276
+ name: string(),
16277
+ type: string(),
16278
+ location: string().nullable(),
16279
+ /** The container a child belongs to — "Spotlight 2" alone does not say which. */
16280
+ parentName: string().nullable(),
16281
+ /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
16282
+ suggested: boolean(),
16283
+ /** Why it is suggested ("same location"), null when it is not. */
16284
+ reason: string().nullable()
16285
+ })) });
16286
+ /**
16287
+ * What a write did. `none` — applied in place. `host` / `parent` — the owner
16288
+ * reloaded the host (or, for an accessory child, its parent) because the
16289
+ * write changed what the host REGISTERS. A slot never adds a capability to its
16290
+ * host — that is a composition (D663) — so today's owners answer `none`.
16291
+ */
16292
+ var ExtensionSetResultSchema = object({
16293
+ applied: literal(true),
16294
+ reload: _enum([
16295
+ "none",
16296
+ "host",
16297
+ "parent"
16298
+ ])
16299
+ });
16300
+ var ExtensionSlotRefInputSchema = object({
16301
+ deviceId: number().int(),
16302
+ slotRef: string().min(1)
16303
+ });
16304
+ var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
16305
+ method(object({ deviceId: number().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
16306
+ kind: "mutation",
16307
+ auth: "admin"
16308
+ });
16309
+ /**
16030
16310
  * Per-field ownership (D663). A composition may CLAIM fields of a native
16031
16311
  * cap's runtime-state slice on an existing device: `replace` overlays the
16032
16312
  * claimed fields on the native slice, `add` builds a slice the device does
@@ -19050,17 +19330,25 @@ var NcScheduleSchema = object({
19050
19330
  */
19051
19331
  var NcSystemEventDeliveryModeSchema = _enum(["instant", "summary"]);
19052
19332
  /**
19333
+ * How a summary window is SENT (D698): `rule` (absent) = ONE notification with
19334
+ * every section; `section` = one notification per section with something to
19335
+ * say (an unavailable section included), each titled by its section.
19336
+ */
19337
+ var NcStateSummarySplitSchema = _enum(["rule", "section"]);
19338
+ /**
19053
19339
  * `summary`: the rule sends NOTHING per event. When a window of `schedule`
19054
19340
  * CLOSES, it sends one notification with the current state of its kinds
19055
19341
  * (low batteries, consumables to replace, devices offline, updates
19056
- * available, ...), after its own filters. Nothing to report sends nothing.
19342
+ * available, ...), after its own filters — or, with `split: 'section'`
19343
+ * (D698), one notification per section. Nothing to report sends nothing.
19057
19344
  * The schedule is the ordinary `NcSchedule` (weekly windows, IANA timezone,
19058
19345
  * midnight crossing); the send time is each window's END. Refused on the
19059
19346
  * `alarm` family, which stays instant (`systemEventDeliveryProblems`).
19060
19347
  */
19061
19348
  var NcSystemEventDeliverySchema = discriminatedUnion("mode", [object({ mode: literal("instant") }), object({
19062
19349
  mode: literal("summary"),
19063
- schedule: NcScheduleSchema
19350
+ schedule: NcScheduleSchema,
19351
+ split: NcStateSummarySplitSchema.optional()
19064
19352
  })]);
19065
19353
  /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
19066
19354
  var NcPlateMatcherSchema = object({
@@ -19711,10 +19999,12 @@ var NcMediaPolicySchema = object({
19711
19999
  /**
19712
20000
  * Cooldown GRANULARITY over the subject's class — how much a fired
19713
20001
  * notification suppresses.
19714
- * - `shared` (default, and the absent value) — one window for the whole
19715
- * rule/scope: a cat silences the next dog for `cooldownSec`.
19716
- * - `per-class` — an independent window per detected class, so cat→dog fires
19717
- * at once and cat→cat still waits.
20002
+ * - `per-class` (default, and the absent value since 2026-10-01 — D36) — an
20003
+ * independent window per detected class: cat→dog fires at once, cat→cat
20004
+ * still waits.
20005
+ * - `shared` — one window for the whole rule/scope: a cat silences the next
20006
+ * dog for `cooldownSec`. Only written when an operator picks it; it is no
20007
+ * longer what an unset rule means.
19718
20008
  *
19719
20009
  * AUDIO subjects are ALWAYS per-class regardless of this setting: a scream
19720
20010
  * must not be swallowed by a bark's window (the precedent this generalizes —
@@ -19729,8 +20019,11 @@ var NcThrottleSchema = object({
19729
20019
  /**
19730
20020
  * Class granularity of the cooldown key. Optional rather than defaulted:
19731
20021
  * a Zod default does NOT run on the addon→addon cap path, so a persisted
19732
- * rule authored before this field simply carries none — and the engine
19733
- * reads absent as `shared`, the pre-existing behaviour.
20022
+ * rule authored before this field simply carries none. The engine used to
20023
+ * read absent as `shared` (D36); since 2026-10-01 it reads absent as
20024
+ * `per-class` — the operator's default — and only an explicit `shared`
20025
+ * still means `shared`. See `cooldownKey` / `keysPerClass` in the rule
20026
+ * engine, and D36's dated note.
19734
20027
  */
19735
20028
  granularity: NcThrottleGranularitySchema.optional()
19736
20029
  });
@@ -20054,11 +20347,23 @@ var NcStateSummaryPreviewSectionSchema = object({
20054
20347
  reason: string().optional()
20055
20348
  });
20056
20349
  /**
20350
+ * One notification a previewed summary would send (D698): the whole summary on
20351
+ * a `rule` split (no `section`), one section's on a `section` split.
20352
+ */
20353
+ var NcStateSummaryPreviewRowSchema = object({
20354
+ section: string().optional(),
20355
+ /** The section's name on a per-section row; every reported section's, joined, on a combined one. */
20356
+ title: string(),
20357
+ text: string(),
20358
+ count: number().int().nonnegative()
20359
+ });
20360
+ /**
20057
20361
  * The summary a rule would send now. `empty` = nothing to report and every
20058
20362
  * section read: such a summary is NOT sent. `dropped` counts the open states
20059
20363
  * the rule's own filters (or a camera mute) left out, by reason.
20060
20364
  * `excludedGroups` names the kind groups selected that have no state to report
20061
- * (backups & exports).
20365
+ * (backups & exports). `split` and `rows` (D698) say how it would be sent —
20366
+ * optional, so an older hub's answer still parses.
20062
20367
  */
20063
20368
  var NcStateSummaryPreviewSchema = object({
20064
20369
  empty: boolean(),
@@ -20066,7 +20371,9 @@ var NcStateSummaryPreviewSchema = object({
20066
20371
  text: string(),
20067
20372
  sections: array(NcStateSummaryPreviewSectionSchema),
20068
20373
  dropped: record(string(), number().int().nonnegative()),
20069
- excludedGroups: array(string())
20374
+ excludedGroups: array(string()),
20375
+ split: NcStateSummarySplitSchema.optional(),
20376
+ rows: array(NcStateSummaryPreviewRowSchema).optional()
20070
20377
  });
20071
20378
  var NcTestResultSchema = object({
20072
20379
  recordId: string(),
@@ -27631,219 +27938,6 @@ DeviceType.Camera, method(object({
27631
27938
  auth: "protected"
27632
27939
  });
27633
27940
  /**
27634
- * Doorbell button cap. Two kinds of providers coexist behind this cap
27635
- * name (same pattern as `snapshot`):
27636
- *
27637
- * - **Native** providers: registered per-device by device-driver
27638
- * addons via `ctx.registerNativeCap` — either on a
27639
- * `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
27640
- * or directly on the camera (Reolink registers at camera level).
27641
- * Emits an `onPressed` event every time the firmware pushes a
27642
- * ring; status tracks the last press and a pressCount since start
27643
- * (diagnostic).
27644
- *
27645
- * - **Wrapper** provider: the `virtual-doorbell` system builtin
27646
- * (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
27647
- * device (contact / switch / event-emitter …) into a doorbell for
27648
- * a camera. `defaultActive: false` — the operator explicitly binds
27649
- * it per camera in the device-bindings UI, then picks the source
27650
- * device + trigger in the per-device settings.
27651
- *
27652
- * The DeviceEventPropagator re-emits `onPressed` on the camera parent
27653
- * — subscribers listening at the camera level receive ring events
27654
- * with `via[]` populated. No code on the parent needed.
27655
- */
27656
- var DoorbellStatusSchema = object({
27657
- /** Ms epoch of the last press. null = never observed since this provider started. */
27658
- lastPressedAt: number().nullable(),
27659
- /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
27660
- pressCountSinceStart: number()
27661
- });
27662
- var DoorbellPressEventSchema = object({
27663
- deviceId: number(),
27664
- timestamp: number()
27665
- });
27666
- /**
27667
- * The `doorbell-source` extension slot's editable value (D648): the camera's
27668
- * virtual-doorbell trigger devices, exactly what the wrapper's
27669
- * `doorbellSources` persists (as `{ deviceId }` records).
27670
- */
27671
- var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number().int().positive()) });
27672
- /**
27673
- * The `doorbell-source` slot — which devices ring this camera's VIRTUAL
27674
- * doorbell, owned by the `virtual-doorbell` wrapper over its
27675
- * `doorbellSources` store (D648). A source rings when one of its
27676
- * `SOURCE_CAPS` rises. Whether the wrapper is bound to the camera at all is a
27677
- * different authority (`deviceManager.setWrapperActive`, D62) — the slot
27678
- * reports it, it never writes it.
27679
- */
27680
- var DOORBELL_SOURCE_SLOT = {
27681
- id: "doorbell-source",
27682
- label: "Doorbell trigger devices",
27683
- description: "Any of these becoming active rings this camera's virtual doorbell: a binary sensor when it goes active, a switch when it turns on.",
27684
- shape: "association",
27685
- hostDeviceTypes: [DeviceType.Camera],
27686
- sourceCaps: SOURCE_CAPS,
27687
- cardinality: "many",
27688
- value: DoorbellSourceSlotValueSchema
27689
- };
27690
- var doorbellCapability = {
27691
- name: "doorbell",
27692
- scope: "device",
27693
- deviceNative: true,
27694
- mode: "singleton",
27695
- kind: "wrapper",
27696
- defaultActive: false,
27697
- deviceTypes: [DeviceType.Button, DeviceType.Camera],
27698
- extensionSlots: [DOORBELL_SOURCE_SLOT],
27699
- methods: {},
27700
- events: {
27701
- /**
27702
- * Fires once per physical press. Reolink delivers via Baichuan
27703
- * push (`ReolinkSimpleEvent.type === 'doorbell'`). There is no
27704
- * release/duration — it's a pulse.
27705
- */
27706
- onPressed: {
27707
- data: DoorbellPressEventSchema,
27708
- fromState: {
27709
- field: "lastPressedAt",
27710
- on: "advance"
27711
- }
27712
- } },
27713
- status: {
27714
- schema: DoorbellStatusSchema,
27715
- kind: "push"
27716
- },
27717
- /**
27718
- * Runtime-state slice — last press timestamp + lifetime press count.
27719
- * Mirrored by the kernel and readable via
27720
- * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
27721
- * without subscribing.
27722
- */
27723
- runtimeState: DoorbellStatusSchema,
27724
- /**
27725
- * Runtime-state durability: **restored** — a monotonic accumulator: the slice IS the record. `lastPressedAt` is content here, not a clock, so it is deliberately NOT volatile.
27726
- *
27727
- * See `RuntimeStateDurability`. Enforced by
27728
- * `scripts/check-runtime-state-durability.ts`.
27729
- */
27730
- durability: "restored"
27731
- };
27732
- var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
27733
- DeviceType.Camera, DeviceType.Camera;
27734
- /** A slot's editable value, discriminated on `slot`. */
27735
- var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
27736
- DeviceType.Camera;
27737
- var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
27738
- state: literal("unreachable"),
27739
- reason: string()
27740
- })]);
27741
- /** One provider of slots — the D554 source-listing row. */
27742
- var ExtensionSourceSchema = object({
27743
- /** The routing prefix of every `slotRef` this provider serves. */
27744
- source: string(),
27745
- label: string(),
27746
- /** Stamped by the dispatcher from the registry (D557). */
27747
- addonId: string().optional(),
27748
- availability: ExtensionSourceAvailabilitySchema
27749
- });
27750
- /**
27751
- * How one picked source stands. `missing` — no such device (deleted, or an id
27752
- * that never existed); `foreign` — a device the slot's owner cannot read from
27753
- * (a source owned by another addon); `unavailable` — it exists but is not a
27754
- * valid source now (a container, which is never a pick). A source in any of
27755
- * these states is SHOWN, never silently dropped or re-pointed.
27756
- */
27757
- var ExtensionSourceHealthSchema = _enum([
27758
- "ok",
27759
- "missing",
27760
- "foreign",
27761
- "unavailable"
27762
- ]);
27763
- var ExtensionSlotSourceSchema = object({
27764
- deviceId: number().int(),
27765
- /** The device's name, or null when it could not be resolved (`missing`). */
27766
- name: string().nullable(),
27767
- health: ExtensionSourceHealthSchema,
27768
- detail: string().optional()
27769
- });
27770
- /**
27771
- * A DIFFERENT authority that gates whether the slot's sources do anything —
27772
- * reported read-only, named, never written through this contract (D62). The
27773
- * virtual doorbell's sources ring only while the wrapper is bound to the
27774
- * camera, and that binding belongs to `deviceManager.setWrapperActive`.
27775
- * `unknown` means the gate could not be read; it is not "inactive" (D315).
27776
- */
27777
- var ExtensionSlotActivationSchema = object({
27778
- state: _enum([
27779
- "active",
27780
- "inactive",
27781
- "unknown"
27782
- ]),
27783
- authority: string(),
27784
- detail: string().optional()
27785
- });
27786
- var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
27787
- state: literal("ok"),
27788
- /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
27789
- slotRef: string(),
27790
- slot: ExtensionSlotIdSchema,
27791
- /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
27792
- authority: string(),
27793
- activation: ExtensionSlotActivationSchema.nullable(),
27794
- value: ExtensionSlotValueSchema,
27795
- sources: array(ExtensionSlotSourceSchema),
27796
- /**
27797
- * Devices the owner links to the host ON ITS OWN, by structure, and that
27798
- * are therefore not in `value` (D655): a camera's device-tree children, and
27799
- * the child a picked container stands for (D356 — a container is never a
27800
- * pick, its children are). Read-only; the editor shows them and may offer
27801
- * per-device options on them (the linked-devices tracked-event opt-in).
27802
- * Absent when the owner links nothing beyond the picks, and from an owner
27803
- * older than D655.
27804
- */
27805
- impliedSources: array(ExtensionSlotSourceSchema).optional()
27806
- }), object({
27807
- state: literal("unreachable"),
27808
- addonId: string(),
27809
- reason: string()
27810
- })]);
27811
- var ExtensionCandidatesSchema = object({ candidates: array(object({
27812
- deviceId: number().int(),
27813
- name: string(),
27814
- type: string(),
27815
- location: string().nullable(),
27816
- /** The container a child belongs to — "Spotlight 2" alone does not say which. */
27817
- parentName: string().nullable(),
27818
- /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
27819
- suggested: boolean(),
27820
- /** Why it is suggested ("same location"), null when it is not. */
27821
- reason: string().nullable()
27822
- })) });
27823
- /**
27824
- * What a write did. `none` — applied in place. `host` / `parent` — the owner
27825
- * reloaded the host (or, for an accessory child, its parent) because the
27826
- * write changed what the host REGISTERS. A slot never adds a capability to its
27827
- * host — that is a composition (D663) — so today's owners answer `none`.
27828
- */
27829
- var ExtensionSetResultSchema = object({
27830
- applied: literal(true),
27831
- reload: _enum([
27832
- "none",
27833
- "host",
27834
- "parent"
27835
- ])
27836
- });
27837
- var ExtensionSlotRefInputSchema = object({
27838
- deviceId: number().int(),
27839
- slotRef: string().min(1)
27840
- });
27841
- var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
27842
- method(object({ deviceId: number().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
27843
- kind: "mutation",
27844
- auth: "admin"
27845
- });
27846
- /**
27847
27941
  * Optional client-side hints sent at session creation to help the provider
27848
27942
  * pick the best native source. All fields optional — a viewer that knows
27849
27943
  * nothing still gets a sane default. (Relocated from the retired `webrtc`
@@ -43127,6 +43221,18 @@ Object.freeze({
43127
43221
  addonId: null,
43128
43222
  access: "view"
43129
43223
  },
43224
+ "databaseSnapshot.listDatabases": {
43225
+ capName: "database-snapshot",
43226
+ capScope: "system",
43227
+ addonId: null,
43228
+ access: "view"
43229
+ },
43230
+ "databaseSnapshot.writeSnapshot": {
43231
+ capName: "database-snapshot",
43232
+ capScope: "system",
43233
+ addonId: null,
43234
+ access: "create"
43235
+ },
43130
43236
  "dataStoreProvider.aggregate": {
43131
43237
  capName: "data-store-provider",
43132
43238
  capScope: "system",
@@ -51862,6 +51968,18 @@ var STATE_SUMMARY_VARS = [
51862
51968
  systemEventKinds: [...SUMMARISABLE],
51863
51969
  systemEventDeliveries: ["summary"]
51864
51970
  },
51971
+ {
51972
+ name: "summarySection",
51973
+ label: "Summary: this section",
51974
+ description: "The section a per-section summary row is about (D698); on a summary sent as one message, every section it reports, comma-separated.",
51975
+ example: "Batterie scariche",
51976
+ group: "system",
51977
+ families: ["rule"],
51978
+ fields: [...RULE_TEXT],
51979
+ kinds: ["system"],
51980
+ systemEventKinds: [...SUMMARISABLE],
51981
+ systemEventDeliveries: ["summary"]
51982
+ },
51865
51983
  ...STATE_SUMMARY_SECTION_VARS.map((v) => ({
51866
51984
  name: v.name,
51867
51985
  label: v.label,