@camstack/addon-matter-broker 0.2.115 → 0.2.116

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.
Files changed (3) hide show
  1. package/dist/addon.js +760 -321
  2. package/dist/addon.mjs +760 -321
  3. package/package.json +2 -2
package/dist/addon.mjs CHANGED
@@ -5382,7 +5382,7 @@ var ZodIssueCode = {
5382
5382
  var ZodFirstPartyTypeKind;
5383
5383
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5384
5384
  //#endregion
5385
- //#region ../types/dist/sleep-C-v96WpE.mjs
5385
+ //#region ../types/dist/sleep-gU6hqv4_.mjs
5386
5386
  /**
5387
5387
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5388
5388
  * window to float samples (D455).
@@ -7425,7 +7425,59 @@ function errMsg(err) {
7425
7425
  return String(err);
7426
7426
  }
7427
7427
  //#endregion
7428
- //#region ../types/dist/composition-BK-GTFYb.mjs
7428
+ //#region ../types/dist/composition-Dq42XWp0.mjs
7429
+ /**
7430
+ * The ffmpeg build every CamStack node downloads, per platform and arch.
7431
+ *
7432
+ * ## Why a download, on every node, including the container
7433
+ *
7434
+ * The version of ffmpeg used to be CODE: baked into the image, changeable only
7435
+ * by rebuilding and rolling it. Now it is DATA — this file states the release,
7436
+ * and a node that boots with a different one downloads it. Changing ffmpeg is a
7437
+ * framework bump, not an image rebuild.
7438
+ *
7439
+ * It also settles the licence question by removing it. FFmpeg's licence is
7440
+ * chosen at compile time: the core is LGPL 2.1+, `--enable-gpl` makes it GPL
7441
+ * (for x264/x265), `--enable-version3` makes that v3, and `--enable-nonfree`
7442
+ * makes the result undistributable. These are GPL v3 builds, and we do not
7443
+ * distribute them: the user's own node fetches the archive from the project
7444
+ * that publishes it, so we convey no GPL work and inherit none of the
7445
+ * obligations that come with conveying one. That is the whole reason the image
7446
+ * no longer installs ffmpeg at all — not a technical preference.
7447
+ *
7448
+ * ## Why jellyfin-ffmpeg
7449
+ *
7450
+ * One vendor covering linux-amd64, linux-arm64, darwin-arm64 and darwin-x64
7451
+ * from one release, with the widest hardware surface of anything maintained:
7452
+ * VAAPI, QSV, NVENC/NVDEC, AMF, Vulkan, OpenCL and DRM on amd64, plus Rockchip
7453
+ * MPP on arm64. It reaches the vendor libraries through dlopen trampolines,
7454
+ * so the binary is not linked against a driver stack it may not find.
7455
+ *
7456
+ * **What it still needs from the host, measured 2026-09-19.** On the Unraid
7457
+ * HOST, which has no libva, `-vaapi_device` aborts the process outright —
7458
+ * `implib-gen: libva-drm.so.2: failed to load library ... Assertion '0 &&
7459
+ * "Assertion in generated code"' failed`. Inside our container, which installs
7460
+ * libva plus the iHD driver, the same command encodes: verified end to end with
7461
+ * `testsrc → format=nv12,hwupload → h264_vaapi`. So the image drops ffmpeg and
7462
+ * KEEPS the Intel media stack; the drivers are the part a binary cannot bring.
7463
+ *
7464
+ * ## Why each artifact carries a checksum and a claim
7465
+ *
7466
+ * The download is now the only source, so `sha256` is verified before anything
7467
+ * is extracted — jellyfin publishes no checksums on its release assets, so
7468
+ * these are ours, taken at the version bump. And `expectedHwaccels` is what the
7469
+ * build is supposed to be able to do: a binary that probes short of its own
7470
+ * claim is a source that changed under us, which is precisely what went
7471
+ * unnoticed for months when a static build turned out to carry no VAAPI at all
7472
+ * (D536).
7473
+ */
7474
+ /** The pinned jellyfin-ffmpeg release. Changing this is the version change. */
7475
+ var FFMPEG_RELEASE = "8.1.2-5";
7476
+ var BASE = `https://github.com/jellyfin/jellyfin-ffmpeg/releases/download/v${FFMPEG_RELEASE}`;
7477
+ function portable(target) {
7478
+ return `${BASE}/jellyfin-ffmpeg_${FFMPEG_RELEASE}_portable_${target}-gpl.tar.xz`;
7479
+ }
7480
+ portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac64");
7429
7481
  /**
7430
7482
  * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
7431
7483
  * valutatore puro del suo FRONTE.
@@ -8899,6 +8951,82 @@ var ArchivedDebugNoteQueryInputSchema = object({
8899
8951
  /** Max rows returned, newest-first. */
8900
8952
  limit: number().int().min(1).max(1e3).optional()
8901
8953
  });
8954
+ var TrackRelationKindSchema = _enum(["same-subject", "different-subjects"]);
8955
+ var TrackSideSchema = _enum(["before", "after"]);
8956
+ var TrackPurityValueSchema = _enum(["mixed", "not-a-subject"]);
8957
+ var TrackRelationSchema = object({
8958
+ id: string$2(),
8959
+ deviceId: number().int(),
8960
+ leftTrackId: string$2(),
8961
+ rightTrackId: string$2(),
8962
+ leftSide: TrackSideSchema.nullable(),
8963
+ rightSide: TrackSideSchema.nullable(),
8964
+ relation: TrackRelationKindSchema,
8965
+ presence: literal("continuous").nullable(),
8966
+ leftStartedAt: number().int().nullable(),
8967
+ rightStartedAt: number().int().nullable(),
8968
+ createdAt: number().int(),
8969
+ updatedAt: number().int(),
8970
+ author: string$2().nullable()
8971
+ });
8972
+ var TrackPuritySchema = object({
8973
+ id: string$2(),
8974
+ deviceId: number().int(),
8975
+ sourceTrackId: string$2(),
8976
+ purity: TrackPurityValueSchema,
8977
+ switchAtMs: number().int().nullable(),
8978
+ startedAt: number().int().nullable(),
8979
+ createdAt: number().int(),
8980
+ updatedAt: number().int(),
8981
+ author: string$2().nullable()
8982
+ });
8983
+ var SetTrackRelationInputSchema = object({
8984
+ deviceId: number().int(),
8985
+ trackId: string$2().min(1),
8986
+ otherTrackId: string$2().min(1),
8987
+ relation: TrackRelationKindSchema,
8988
+ presence: literal("continuous").optional(),
8989
+ trackSide: TrackSideSchema.optional(),
8990
+ otherSide: TrackSideSchema.optional()
8991
+ });
8992
+ var ClearTrackRelationInputSchema = object({
8993
+ deviceId: number().int(),
8994
+ trackId: string$2().min(1),
8995
+ otherTrackId: string$2().min(1)
8996
+ });
8997
+ var ClearTrackRelationResultSchema = object({ cleared: boolean() });
8998
+ var SetTrackPurityInputSchema = object({
8999
+ deviceId: number().int(),
9000
+ trackId: string$2().min(1),
9001
+ purity: _enum([
9002
+ "pure",
9003
+ "mixed",
9004
+ "not-a-subject"
9005
+ ]),
9006
+ switchAtMs: number().int().optional()
9007
+ });
9008
+ /** `null` when `pure` cleared the row. */
9009
+ var SetTrackPurityResultSchema = object({ purity: TrackPuritySchema.nullable() });
9010
+ var ListTrackRelationsInputSchema = object({
9011
+ deviceId: number().int(),
9012
+ trackId: string$2().optional(),
9013
+ since: number().int().optional(),
9014
+ until: number().int().optional(),
9015
+ limit: number().int().min(1).max(5e3).optional()
9016
+ });
9017
+ var ListTrackRelationsResultSchema = object({
9018
+ relations: array(TrackRelationSchema).readonly(),
9019
+ purities: array(TrackPuritySchema).readonly(),
9020
+ truncated: boolean()
9021
+ });
9022
+ _enum([
9023
+ "unknown-track",
9024
+ "cross-device",
9025
+ "self-relation",
9026
+ "contradiction",
9027
+ "switch-outside-track",
9028
+ "switch-needs-mixed"
9029
+ ]);
8902
9030
  /**
8903
9031
  * Ops-log — the durable, append-only operations audit shared by the
8904
9032
  * recordings and events management surfaces.
@@ -11452,6 +11580,68 @@ method(object({
11452
11580
  password: string$2()
11453
11581
  }), AuthResultSchema.nullable(), { kind: "mutation" }), method(object({ state: string$2() }), string$2()), method(record(string$2(), string$2()), AuthResultSchema, { kind: "mutation" }), method(object({ token: string$2() }), AuthResultSchema.nullable());
11454
11582
  /**
11583
+ * How long one snapshot may take end to end: the pinned copy of the whole
11584
+ * database plus `PRAGMA integrity_check` over the copy, on the hub's slowest
11585
+ * disk. ~800 MB at a pessimistic 10 MB/s is under 3 minutes; the bound is
11586
+ * generous because a timeout fails the whole backup run.
11587
+ */
11588
+ var DATABASE_SNAPSHOT_TIMEOUT_MS = 30 * 6e4;
11589
+ /**
11590
+ * The databases an owner snapshots — declared by the OWNER, so a caller never
11591
+ * guesses which file is live from what sits beside it (a cleanly closed
11592
+ * database has no sidecars and is just as owned). Paths are absolute on the
11593
+ * owner's host.
11594
+ */
11595
+ var DatabaseSnapshotTargetsSchema = object({ databases: array(object({ livePath: string$2() })) });
11596
+ /** One b-tree table of the snapshot and the rows it holds. */
11597
+ var DatabaseSnapshotTableSchema = object({
11598
+ name: string$2(),
11599
+ rows: number().int().nonnegative()
11600
+ });
11601
+ /**
11602
+ * What the owner wrote. Every path is ABSOLUTE on the owner's host — the
11603
+ * caller pins the call to its own node, so it can read the file; a caller
11604
+ * that finds the path outside its own data root refuses it rather than
11605
+ * archiving something it cannot place.
11606
+ */
11607
+ var DatabaseSnapshotResultSchema = object({
11608
+ /** The live database the snapshot copies. Never to be copied as a file. */
11609
+ livePath: string$2(),
11610
+ /** The verified copy: `<livePath>` + {@link DATABASE_SNAPSHOT_SUFFIX}. */
11611
+ snapshotPath: string$2(),
11612
+ sizeBytes: number().int().nonnegative(),
11613
+ pageCount: number().int().nonnegative(),
11614
+ pageSize: number().int().positive(),
11615
+ /**
11616
+ * Every b-tree table with its row count. Read inside the SAME read
11617
+ * transaction the copy was taken from, and found EQUAL on the copy — so
11618
+ * this is the content of the snapshot, not an estimate of the source.
11619
+ */
11620
+ tables: array(DatabaseSnapshotTableSchema),
11621
+ /** Wall time of the pinned copy (row counts included). */
11622
+ copyMs: number().nonnegative(),
11623
+ /** Wall time of the checks on the copy (`integrity_check`, row counts). */
11624
+ verifyMs: number().nonnegative(),
11625
+ /** When the pinned read transaction began (ms epoch) — the snapshot's instant. */
11626
+ takenAt: number()
11627
+ });
11628
+ /**
11629
+ * A snapshot as an ARCHIVE records it (`ArchiveManifest.sqliteSnapshots`):
11630
+ * the same facts, with both paths relative to the archive root (the node's
11631
+ * data dir), because an archive outlives the host that made it.
11632
+ */
11633
+ var ArchiveSqliteSnapshotSchema = DatabaseSnapshotResultSchema.extend({
11634
+ /** Archive-relative path of the live database the archive does NOT carry. */
11635
+ livePath: string$2(),
11636
+ /** Archive-relative path of the verified copy it carries in its place. */
11637
+ snapshotPath: string$2()
11638
+ });
11639
+ method(object({}), DatabaseSnapshotTargetsSchema, { auth: "admin" }), method(object({}), DatabaseSnapshotResultSchema, {
11640
+ kind: "mutation",
11641
+ auth: "admin",
11642
+ timeoutMs: DATABASE_SNAPSHOT_TIMEOUT_MS
11643
+ });
11644
+ /**
11455
11645
  * Orchestrator-side destination metadata. The orchestrator computes
11456
11646
  * `id = <addonId>:<subId>` from its provider lookup so consumers
11457
11647
  * (admin UI, restore flow) see one canonical key.
@@ -11562,7 +11752,12 @@ var ArchiveManifestSchema = object({
11562
11752
  locations: array(string$2()),
11563
11753
  entries: array(ArchiveEntrySchema),
11564
11754
  totalBytes: number(),
11565
- totalFiles: number()
11755
+ totalFiles: number(),
11756
+ /**
11757
+ * Live SQLite databases this archive carries as their OWNER's verified
11758
+ * snapshot instead of as files (D693). Absent on archives made before.
11759
+ */
11760
+ sqliteSnapshots: array(ArchiveSqliteSnapshotSchema).optional()
11566
11761
  });
11567
11762
  var LocationStatSchema = object({
11568
11763
  name: string$2(),
@@ -13137,6 +13332,116 @@ var CompositionBlockStateSchema = object({
13137
13332
  reason: string$2().optional(),
13138
13333
  fields: array(CompositionFieldStateSchema)
13139
13334
  });
13335
+ var ComposerBlockSchema = object({
13336
+ id: string$2().min(1),
13337
+ name: string$2().min(1).max(120),
13338
+ enabled: boolean(),
13339
+ updatedAt: number(),
13340
+ composition: CompositionSchema
13341
+ });
13342
+ /**
13343
+ * A stored composition row that no longer PARSES — a schema a release
13344
+ * tightened, a row written by a newer build. Sent by id so the composer keeps
13345
+ * its device as a placeholder and reports the block `failed` naming the parse
13346
+ * error. Leaving it out would read, twice, exactly like a delete (D49).
13347
+ */
13348
+ var ComposerUnreadableBlockSchema = object({
13349
+ id: string$2().min(1),
13350
+ /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
13351
+ name: string$2().nullable(),
13352
+ /** The parse error, in the operator's words. */
13353
+ error: string$2()
13354
+ });
13355
+ method(object({
13356
+ /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
13357
+ integrationId: string$2().nullable(),
13358
+ /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
13359
+ storeLoaded: boolean(),
13360
+ blocks: array(ComposerBlockSchema),
13361
+ /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
13362
+ restartBlockIds: array(string$2()),
13363
+ /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
13364
+ unreadableBlocks: array(ComposerUnreadableBlockSchema)
13365
+ }), object({
13366
+ blocks: array(object({
13367
+ blockId: string$2(),
13368
+ status: CompositionRunStatusSchema,
13369
+ reason: string$2().optional()
13370
+ })),
13371
+ /**
13372
+ * False when the composer declared and withdrew NOTHING (store not loaded,
13373
+ * integration unknown, its own rows unread or read empty once). An empty
13374
+ * apply the caller owes is paid off only by one the composer acted on (D49).
13375
+ */
13376
+ acted: boolean()
13377
+ }), {
13378
+ kind: "mutation",
13379
+ auth: "admin"
13380
+ }), method(object({ blockIds: array(string$2()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
13381
+ var NUMBER = {
13382
+ kind: "fixed",
13383
+ result: ["number"]
13384
+ };
13385
+ var BOOLEAN = {
13386
+ kind: "fixed",
13387
+ result: ["boolean"]
13388
+ };
13389
+ Object.freeze({
13390
+ min: NUMBER,
13391
+ max: NUMBER,
13392
+ abs: NUMBER,
13393
+ floor: NUMBER,
13394
+ ceil: NUMBER,
13395
+ sqrt: NUMBER,
13396
+ round: NUMBER,
13397
+ pow: NUMBER,
13398
+ clamp: NUMBER,
13399
+ avg: NUMBER,
13400
+ sum: NUMBER,
13401
+ age: NUMBER,
13402
+ convert: NUMBER,
13403
+ coalesce: { kind: "coalesce" },
13404
+ any: BOOLEAN,
13405
+ all: BOOLEAN,
13406
+ within: BOOLEAN,
13407
+ latest: {
13408
+ kind: "fixed",
13409
+ result: ["number", "null"]
13410
+ },
13411
+ number: {
13412
+ kind: "fixed",
13413
+ result: ["number", "null"]
13414
+ },
13415
+ rose: {
13416
+ kind: "fixed",
13417
+ result: ["number", "null"]
13418
+ },
13419
+ count: NUMBER
13420
+ });
13421
+ `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
13422
+ /**
13423
+ * What a composition may BUILD on a device type (G2, D676): the caps a new
13424
+ * device of that type, or an existing one that lacks them, can be given. The
13425
+ * blockers are the validator's own refusal codes, and a spec compares this
13426
+ * listing with `planComposition` for every capability — the editor can never
13427
+ * offer a feature the save would refuse for the same reason.
13428
+ */
13429
+ var ComposableFieldSchema = object({
13430
+ path: string$2(),
13431
+ kind: CompositionFieldKindSchema,
13432
+ nullable: boolean(),
13433
+ required: boolean(),
13434
+ enumValues: array(string$2()).optional()
13435
+ });
13436
+ var ComposableCapabilitiesSchema = object({ caps: array(object({
13437
+ cap: string$2(),
13438
+ fields: array(ComposableFieldSchema),
13439
+ /** Present for an item-array cap (`consumables.items`). */
13440
+ itemArray: object({
13441
+ path: string$2(),
13442
+ keyField: string$2()
13443
+ }).optional()
13444
+ })) });
13140
13445
  /** Where a block runs. The operator chooses — a block driving a device on an
13141
13446
  * agent is the reason placement is not fixed to the hub. */
13142
13447
  var CoreBlockPlacementSchema = union([literal("hub"), string$2().min(1)]);
@@ -13301,7 +13606,7 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
13301
13606
  }), method(object({ blockId: string$2() }), CompositionGetReadSchema, { auth: "admin" }), method(object({}), CompositionListReadSchema, { auth: "admin" }), method(object({
13302
13607
  addonId: string$2().min(1),
13303
13608
  stableId: string$2().min(1)
13304
- }), CompositionCustomizationReadSchema, { auth: "admin" }), method(object({
13609
+ }), CompositionCustomizationReadSchema, { auth: "admin" }), method(object({ deviceType: _enum(DeviceType) }), ComposableCapabilitiesSchema, { auth: "admin" }), method(object({
13305
13610
  composition: CompositionSchema,
13306
13611
  blockId: string$2().optional()
13307
13612
  }), CompositionValidationSchema, {
@@ -13309,52 +13614,6 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
13309
13614
  auth: "admin",
13310
13615
  access: "view"
13311
13616
  });
13312
- var ComposerBlockSchema = object({
13313
- id: string$2().min(1),
13314
- name: string$2().min(1).max(120),
13315
- enabled: boolean(),
13316
- updatedAt: number(),
13317
- composition: CompositionSchema
13318
- });
13319
- /**
13320
- * A stored composition row that no longer PARSES — a schema a release
13321
- * tightened, a row written by a newer build. Sent by id so the composer keeps
13322
- * its device as a placeholder and reports the block `failed` naming the parse
13323
- * error. Leaving it out would read, twice, exactly like a delete (D49).
13324
- */
13325
- var ComposerUnreadableBlockSchema = object({
13326
- id: string$2().min(1),
13327
- /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
13328
- name: string$2().nullable(),
13329
- /** The parse error, in the operator's words. */
13330
- error: string$2()
13331
- });
13332
- method(object({
13333
- /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
13334
- integrationId: string$2().nullable(),
13335
- /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
13336
- storeLoaded: boolean(),
13337
- blocks: array(ComposerBlockSchema),
13338
- /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
13339
- restartBlockIds: array(string$2()),
13340
- /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
13341
- unreadableBlocks: array(ComposerUnreadableBlockSchema)
13342
- }), object({
13343
- blocks: array(object({
13344
- blockId: string$2(),
13345
- status: CompositionRunStatusSchema,
13346
- reason: string$2().optional()
13347
- })),
13348
- /**
13349
- * False when the composer declared and withdrew NOTHING (store not loaded,
13350
- * integration unknown, its own rows unread or read empty once). An empty
13351
- * apply the caller owes is paid off only by one the composer acted on (D49).
13352
- */
13353
- acted: boolean()
13354
- }), {
13355
- kind: "mutation",
13356
- auth: "admin"
13357
- }), method(object({ blockIds: array(string$2()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
13358
13617
  /**
13359
13618
  * `custom-model-registry` — collection cap exposing operator-registered
13360
13619
  * custom detection models. Each provider (today: `addon-model-studio`)
@@ -15409,6 +15668,219 @@ method(object({
15409
15668
  caps: array(string$2()).readonly().optional()
15410
15669
  }), record(string$2(), record(string$2(), unknown().nullable())));
15411
15670
  /**
15671
+ * Doorbell button cap. Two kinds of providers coexist behind this cap
15672
+ * name (same pattern as `snapshot`):
15673
+ *
15674
+ * - **Native** providers: registered per-device by device-driver
15675
+ * addons via `ctx.registerNativeCap` — either on a
15676
+ * `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
15677
+ * or directly on the camera (Reolink registers at camera level).
15678
+ * Emits an `onPressed` event every time the firmware pushes a
15679
+ * ring; status tracks the last press and a pressCount since start
15680
+ * (diagnostic).
15681
+ *
15682
+ * - **Wrapper** provider: the `virtual-doorbell` system builtin
15683
+ * (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
15684
+ * device (contact / switch / event-emitter …) into a doorbell for
15685
+ * a camera. `defaultActive: false` — the operator explicitly binds
15686
+ * it per camera in the device-bindings UI, then picks the source
15687
+ * device + trigger in the per-device settings.
15688
+ *
15689
+ * The DeviceEventPropagator re-emits `onPressed` on the camera parent
15690
+ * — subscribers listening at the camera level receive ring events
15691
+ * with `via[]` populated. No code on the parent needed.
15692
+ */
15693
+ var DoorbellStatusSchema = object({
15694
+ /** Ms epoch of the last press. null = never observed since this provider started. */
15695
+ lastPressedAt: number().nullable(),
15696
+ /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
15697
+ pressCountSinceStart: number()
15698
+ });
15699
+ var DoorbellPressEventSchema = object({
15700
+ deviceId: number(),
15701
+ timestamp: number()
15702
+ });
15703
+ /**
15704
+ * The `doorbell-source` extension slot's editable value (D648): the camera's
15705
+ * virtual-doorbell trigger devices, exactly what the wrapper's
15706
+ * `doorbellSources` persists (as `{ deviceId }` records).
15707
+ */
15708
+ var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number().int().positive()) });
15709
+ /**
15710
+ * The `doorbell-source` slot — which devices ring this camera's VIRTUAL
15711
+ * doorbell, owned by the `virtual-doorbell` wrapper over its
15712
+ * `doorbellSources` store (D648). A source rings when one of its
15713
+ * `SOURCE_CAPS` rises. Whether the wrapper is bound to the camera at all is a
15714
+ * different authority (`deviceManager.setWrapperActive`, D62) — the slot
15715
+ * reports it, it never writes it.
15716
+ */
15717
+ var DOORBELL_SOURCE_SLOT = {
15718
+ id: "doorbell-source",
15719
+ label: "Doorbell trigger devices",
15720
+ 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.",
15721
+ shape: "association",
15722
+ hostDeviceTypes: [DeviceType.Camera],
15723
+ sourceCaps: SOURCE_CAPS,
15724
+ cardinality: "many",
15725
+ value: DoorbellSourceSlotValueSchema
15726
+ };
15727
+ var doorbellCapability = {
15728
+ name: "doorbell",
15729
+ scope: "device",
15730
+ deviceNative: true,
15731
+ mode: "singleton",
15732
+ kind: "wrapper",
15733
+ defaultActive: false,
15734
+ deviceTypes: [DeviceType.Button, DeviceType.Camera],
15735
+ extensionSlots: [DOORBELL_SOURCE_SLOT],
15736
+ methods: {},
15737
+ events: {
15738
+ /**
15739
+ * Fires once per physical press. Reolink delivers via Baichuan
15740
+ * push (`ReolinkSimpleEvent.type === 'doorbell'`). There is no
15741
+ * release/duration — it's a pulse.
15742
+ */
15743
+ onPressed: {
15744
+ data: DoorbellPressEventSchema,
15745
+ fromState: {
15746
+ field: "lastPressedAt",
15747
+ on: "advance"
15748
+ }
15749
+ } },
15750
+ status: {
15751
+ schema: DoorbellStatusSchema,
15752
+ kind: "push"
15753
+ },
15754
+ /**
15755
+ * Runtime-state slice — last press timestamp + lifetime press count.
15756
+ * Mirrored by the kernel and readable via
15757
+ * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
15758
+ * without subscribing.
15759
+ */
15760
+ runtimeState: DoorbellStatusSchema,
15761
+ /**
15762
+ * 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.
15763
+ *
15764
+ * See `RuntimeStateDurability`. Enforced by
15765
+ * `scripts/check-runtime-state-durability.ts`.
15766
+ */
15767
+ durability: "restored"
15768
+ };
15769
+ var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
15770
+ DeviceType.Camera, DeviceType.Camera;
15771
+ /** A slot's editable value, discriminated on `slot`. */
15772
+ var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
15773
+ DeviceType.Camera;
15774
+ var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
15775
+ state: literal("unreachable"),
15776
+ reason: string$2()
15777
+ })]);
15778
+ /** One provider of slots — the D554 source-listing row. */
15779
+ var ExtensionSourceSchema = object({
15780
+ /** The routing prefix of every `slotRef` this provider serves. */
15781
+ source: string$2(),
15782
+ label: string$2(),
15783
+ /** Stamped by the dispatcher from the registry (D557). */
15784
+ addonId: string$2().optional(),
15785
+ availability: ExtensionSourceAvailabilitySchema
15786
+ });
15787
+ /**
15788
+ * How one picked source stands. `missing` — no such device (deleted, or an id
15789
+ * that never existed); `foreign` — a device the slot's owner cannot read from
15790
+ * (a source owned by another addon); `unavailable` — it exists but is not a
15791
+ * valid source now (a container, which is never a pick). A source in any of
15792
+ * these states is SHOWN, never silently dropped or re-pointed.
15793
+ */
15794
+ var ExtensionSourceHealthSchema = _enum([
15795
+ "ok",
15796
+ "missing",
15797
+ "foreign",
15798
+ "unavailable"
15799
+ ]);
15800
+ var ExtensionSlotSourceSchema = object({
15801
+ deviceId: number().int(),
15802
+ /** The device's name, or null when it could not be resolved (`missing`). */
15803
+ name: string$2().nullable(),
15804
+ health: ExtensionSourceHealthSchema,
15805
+ detail: string$2().optional()
15806
+ });
15807
+ /**
15808
+ * A DIFFERENT authority that gates whether the slot's sources do anything —
15809
+ * reported read-only, named, never written through this contract (D62). The
15810
+ * virtual doorbell's sources ring only while the wrapper is bound to the
15811
+ * camera, and that binding belongs to `deviceManager.setWrapperActive`.
15812
+ * `unknown` means the gate could not be read; it is not "inactive" (D315).
15813
+ */
15814
+ var ExtensionSlotActivationSchema = object({
15815
+ state: _enum([
15816
+ "active",
15817
+ "inactive",
15818
+ "unknown"
15819
+ ]),
15820
+ authority: string$2(),
15821
+ detail: string$2().optional()
15822
+ });
15823
+ var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
15824
+ state: literal("ok"),
15825
+ /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
15826
+ slotRef: string$2(),
15827
+ slot: ExtensionSlotIdSchema,
15828
+ /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
15829
+ authority: string$2(),
15830
+ activation: ExtensionSlotActivationSchema.nullable(),
15831
+ value: ExtensionSlotValueSchema,
15832
+ sources: array(ExtensionSlotSourceSchema),
15833
+ /**
15834
+ * Devices the owner links to the host ON ITS OWN, by structure, and that
15835
+ * are therefore not in `value` (D655): a camera's device-tree children, and
15836
+ * the child a picked container stands for (D356 — a container is never a
15837
+ * pick, its children are). Read-only; the editor shows them and may offer
15838
+ * per-device options on them (the linked-devices tracked-event opt-in).
15839
+ * Absent when the owner links nothing beyond the picks, and from an owner
15840
+ * older than D655.
15841
+ */
15842
+ impliedSources: array(ExtensionSlotSourceSchema).optional()
15843
+ }), object({
15844
+ state: literal("unreachable"),
15845
+ addonId: string$2(),
15846
+ reason: string$2()
15847
+ })]);
15848
+ var ExtensionCandidatesSchema = object({ candidates: array(object({
15849
+ deviceId: number().int(),
15850
+ name: string$2(),
15851
+ type: string$2(),
15852
+ location: string$2().nullable(),
15853
+ /** The container a child belongs to — "Spotlight 2" alone does not say which. */
15854
+ parentName: string$2().nullable(),
15855
+ /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
15856
+ suggested: boolean(),
15857
+ /** Why it is suggested ("same location"), null when it is not. */
15858
+ reason: string$2().nullable()
15859
+ })) });
15860
+ /**
15861
+ * What a write did. `none` — applied in place. `host` / `parent` — the owner
15862
+ * reloaded the host (or, for an accessory child, its parent) because the
15863
+ * write changed what the host REGISTERS. A slot never adds a capability to its
15864
+ * host — that is a composition (D663) — so today's owners answer `none`.
15865
+ */
15866
+ var ExtensionSetResultSchema = object({
15867
+ applied: literal(true),
15868
+ reload: _enum([
15869
+ "none",
15870
+ "host",
15871
+ "parent"
15872
+ ])
15873
+ });
15874
+ var ExtensionSlotRefInputSchema = object({
15875
+ deviceId: number().int(),
15876
+ slotRef: string$2().min(1)
15877
+ });
15878
+ var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
15879
+ method(object({ deviceId: number().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
15880
+ kind: "mutation",
15881
+ auth: "admin"
15882
+ });
15883
+ /**
15412
15884
  * Per-field ownership (D663). A composition may CLAIM fields of a native
15413
15885
  * cap's runtime-state slice on an existing device: `replace` overlays the
15414
15886
  * claimed fields on the native slice, `add` builds a slice the device does
@@ -18418,17 +18890,25 @@ var NcScheduleSchema = object({
18418
18890
  */
18419
18891
  var NcSystemEventDeliveryModeSchema = _enum(["instant", "summary"]);
18420
18892
  /**
18893
+ * How a summary window is SENT (D698): `rule` (absent) = ONE notification with
18894
+ * every section; `section` = one notification per section with something to
18895
+ * say (an unavailable section included), each titled by its section.
18896
+ */
18897
+ var NcStateSummarySplitSchema = _enum(["rule", "section"]);
18898
+ /**
18421
18899
  * `summary`: the rule sends NOTHING per event. When a window of `schedule`
18422
18900
  * CLOSES, it sends one notification with the current state of its kinds
18423
18901
  * (low batteries, consumables to replace, devices offline, updates
18424
- * available, ...), after its own filters. Nothing to report sends nothing.
18902
+ * available, ...), after its own filters — or, with `split: 'section'`
18903
+ * (D698), one notification per section. Nothing to report sends nothing.
18425
18904
  * The schedule is the ordinary `NcSchedule` (weekly windows, IANA timezone,
18426
18905
  * midnight crossing); the send time is each window's END. Refused on the
18427
18906
  * `alarm` family, which stays instant (`systemEventDeliveryProblems`).
18428
18907
  */
18429
18908
  var NcSystemEventDeliverySchema = discriminatedUnion("mode", [object({ mode: literal("instant") }), object({
18430
18909
  mode: literal("summary"),
18431
- schedule: NcScheduleSchema
18910
+ schedule: NcScheduleSchema,
18911
+ split: NcStateSummarySplitSchema.optional()
18432
18912
  })]);
18433
18913
  /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
18434
18914
  var NcPlateMatcherSchema = object({
@@ -18568,8 +19048,14 @@ var NcSensorTransitionSchema = _enum(["raised", "cleared"]);
18568
19048
  /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
18569
19049
  var NcZoneConditionSchema = object({
18570
19050
  ids: array(string$2().min(1)).min(1),
18571
- /** Quantifier over `ids` — at least one / every one visited. */
18572
- match: _enum(["any", "all"]).default("any")
19051
+ /**
19052
+ * LEGACY quantifier over `ids`. Absent = `any` (at least one visited), which
19053
+ * is what both editors mean and all they write since D690: "all of" was
19054
+ * removed from the editors because on an immediate rule it asked one
19055
+ * detection to stand in every zone at once. Still ACCEPTED, and `all` still
19056
+ * evaluated, so a stored rule keeps parsing and meaning what it meant.
19057
+ */
19058
+ match: _enum(["any", "all"]).optional()
18573
19059
  });
18574
19060
  /**
18575
19061
  * The P1 condition set — a flat AND of groups; absent group = pass;
@@ -19073,10 +19559,12 @@ var NcMediaPolicySchema = object({
19073
19559
  /**
19074
19560
  * Cooldown GRANULARITY over the subject's class — how much a fired
19075
19561
  * notification suppresses.
19076
- * - `shared` (default, and the absent value) — one window for the whole
19077
- * rule/scope: a cat silences the next dog for `cooldownSec`.
19078
- * - `per-class` — an independent window per detected class, so cat→dog fires
19079
- * at once and cat→cat still waits.
19562
+ * - `per-class` (default, and the absent value since 2026-10-01 — D36) — an
19563
+ * independent window per detected class: cat→dog fires at once, cat→cat
19564
+ * still waits.
19565
+ * - `shared` — one window for the whole rule/scope: a cat silences the next
19566
+ * dog for `cooldownSec`. Only written when an operator picks it; it is no
19567
+ * longer what an unset rule means.
19080
19568
  *
19081
19569
  * AUDIO subjects are ALWAYS per-class regardless of this setting: a scream
19082
19570
  * must not be swallowed by a bark's window (the precedent this generalizes —
@@ -19091,8 +19579,11 @@ var NcThrottleSchema = object({
19091
19579
  /**
19092
19580
  * Class granularity of the cooldown key. Optional rather than defaulted:
19093
19581
  * a Zod default does NOT run on the addon→addon cap path, so a persisted
19094
- * rule authored before this field simply carries none — and the engine
19095
- * reads absent as `shared`, the pre-existing behaviour.
19582
+ * rule authored before this field simply carries none. The engine used to
19583
+ * read absent as `shared` (D36); since 2026-10-01 it reads absent as
19584
+ * `per-class` — the operator's default — and only an explicit `shared`
19585
+ * still means `shared`. See `cooldownKey` / `keysPerClass` in the rule
19586
+ * engine, and D36's dated note.
19096
19587
  */
19097
19588
  granularity: NcThrottleGranularitySchema.optional()
19098
19589
  });
@@ -19416,11 +19907,23 @@ var NcStateSummaryPreviewSectionSchema = object({
19416
19907
  reason: string$2().optional()
19417
19908
  });
19418
19909
  /**
19910
+ * One notification a previewed summary would send (D698): the whole summary on
19911
+ * a `rule` split (no `section`), one section's on a `section` split.
19912
+ */
19913
+ var NcStateSummaryPreviewRowSchema = object({
19914
+ section: string$2().optional(),
19915
+ /** The section's name on a per-section row; every reported section's, joined, on a combined one. */
19916
+ title: string$2(),
19917
+ text: string$2(),
19918
+ count: number().int().nonnegative()
19919
+ });
19920
+ /**
19419
19921
  * The summary a rule would send now. `empty` = nothing to report and every
19420
19922
  * section read: such a summary is NOT sent. `dropped` counts the open states
19421
19923
  * the rule's own filters (or a camera mute) left out, by reason.
19422
19924
  * `excludedGroups` names the kind groups selected that have no state to report
19423
- * (backups & exports).
19925
+ * (backups & exports). `split` and `rows` (D698) say how it would be sent —
19926
+ * optional, so an older hub's answer still parses.
19424
19927
  */
19425
19928
  var NcStateSummaryPreviewSchema = object({
19426
19929
  empty: boolean(),
@@ -19428,7 +19931,9 @@ var NcStateSummaryPreviewSchema = object({
19428
19931
  text: string$2(),
19429
19932
  sections: array(NcStateSummaryPreviewSectionSchema),
19430
19933
  dropped: record(string$2(), number().int().nonnegative()),
19431
- excludedGroups: array(string$2())
19934
+ excludedGroups: array(string$2()),
19935
+ split: NcStateSummarySplitSchema.optional(),
19936
+ rows: array(NcStateSummaryPreviewRowSchema).optional()
19432
19937
  });
19433
19938
  var NcTestResultSchema = object({
19434
19939
  recordId: string$2(),
@@ -20444,7 +20949,7 @@ function cameraSensorRefKey(ref) {
20444
20949
  }
20445
20950
  /** CS-1 accepts exactly one mode; CS-2 (D673) widens it to confirm / replace. */
20446
20951
  var CameraSensorsModeSchema = _enum(["in-addition"]);
20447
- object({
20952
+ var CameraSensorsConfigSchema = object({
20448
20953
  mode: CameraSensorsModeSchema,
20449
20954
  sensors: array(CameraSensorRefSchema).min(1).max(8)
20450
20955
  }).superRefine((value, ctx) => {
@@ -22349,7 +22854,8 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
22349
22854
  trackIds: array(string$2()).min(1)
22350
22855
  }), object({
22351
22856
  deleted: number().int(),
22352
- failed: array(string$2()).readonly()
22857
+ failed: array(string$2()).readonly(),
22858
+ sparedMediaIds: array(number().int()).readonly().optional()
22353
22859
  }), {
22354
22860
  kind: "mutation",
22355
22861
  auth: "admin"
@@ -22358,7 +22864,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
22358
22864
  deviceId: number(),
22359
22865
  trackId: string$2(),
22360
22866
  flags: TrackFlagsPatchSchema
22361
- }), TrackFlagsSchema, { kind: "mutation" }), method(ArchivedDebugNoteQueryInputSchema, array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }), method(BirthDecisionQueryInputSchema, array(BirthDecisionRecordSchema).readonly(), { kind: "query" }), method(object({}), EventStoreFootprintSchema, {
22867
+ }), TrackFlagsSchema, { kind: "mutation" }), method(ArchivedDebugNoteQueryInputSchema, array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }), method(SetTrackRelationInputSchema, TrackRelationSchema, { kind: "mutation" }), method(ClearTrackRelationInputSchema, ClearTrackRelationResultSchema, { kind: "mutation" }), method(SetTrackPurityInputSchema, SetTrackPurityResultSchema, { kind: "mutation" }), method(ListTrackRelationsInputSchema, ListTrackRelationsResultSchema, { kind: "query" }), method(BirthDecisionQueryInputSchema, array(BirthDecisionRecordSchema).readonly(), { kind: "query" }), method(object({}), EventStoreFootprintSchema, {
22362
22868
  kind: "query",
22363
22869
  auth: "admin"
22364
22870
  }), method(object({ deviceId: number().int().optional() }), EventMediaKindBreakdownSchema, {
@@ -24556,7 +25062,64 @@ var NodeInferenceDevicesSchema = object({
24556
25062
  reachable: boolean(),
24557
25063
  devices: array(NodeInferenceDeviceSchema).readonly()
24558
25064
  });
24559
- method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
25065
+ /**
25066
+ * Pipeline Orchestrator capability — global load balancer + camera dispatcher.
25067
+ *
25068
+ * Lives on the hub. Tracks the camera-to-agent assignment map, listens to
25069
+ * device lifecycle events, queries each runner's capacity + hardware
25070
+ * profile, and dispatches `attachCamera` / `detachCamera` cap calls to the
25071
+ * appropriate runner instances. Persists assignments via the multi-level
25072
+ * settings store so they survive hub restarts.
25073
+ *
25074
+ * Strictly the control plane: never sees a frame, never calls inference,
25075
+ * never drains queues. The runner does that work locally on each agent.
25076
+ */
25077
+ /**
25078
+ * The input of `setCameraSensors` (G5, D676): the ONE typed write path of a
25079
+ * camera's attached sensors (D672). `config: null` removes the attachment —
25080
+ * the camera reads `not-configured` again, never `unreadable`.
25081
+ */
25082
+ var SetCameraSensorsInputSchema = object({
25083
+ deviceId: number().int().nonnegative(),
25084
+ /** `null` removes the attachment: the camera goes back to `not-configured`. */
25085
+ config: CameraSensorsConfigSchema.nullable()
25086
+ });
25087
+ /**
25088
+ * Why an early occupancy look (D691) was not scheduled.
25089
+ *
25090
+ * - `unknown-camera` — no session was ever dispatched for it, so there is no
25091
+ * node and no config to attach a burst with.
25092
+ * - `out-of-range` — the ask is negative or further out than the orchestrator
25093
+ * will hold a timer for; the parked-object cadence is the answer there.
25094
+ * - `no-burst-producer` — this build has no burst producer at all.
25095
+ * - `already-looked` — this camera's ONE early look since its last session has
25096
+ * been spent. A look's own burst can re-arm a flickering flip, and a look
25097
+ * per arm would chain a burst every ~30 s forever (review H2); the next
25098
+ * real session re-arms the budget.
25099
+ */
25100
+ var OccupancyLookRefusalSchema = _enum([
25101
+ "unknown-camera",
25102
+ "out-of-range",
25103
+ "no-burst-producer",
25104
+ "already-looked"
25105
+ ]);
25106
+ method(object({
25107
+ deviceId: number().int().nonnegative(),
25108
+ /** How long from NOW until the pending flip's sustain window ends. RELATIVE,
25109
+ * so the caller's clock and the orchestrator's never have to agree. */
25110
+ afterMs: number().finite(),
25111
+ /** Why, for the log. */
25112
+ reason: string$2()
25113
+ }), object({
25114
+ scheduled: boolean(),
25115
+ /** When `scheduled`: how long until the burst is dialled. */
25116
+ dueInMs: number().optional(),
25117
+ /** When not `scheduled`: why. */
25118
+ refusedBecause: OccupancyLookRefusalSchema.optional()
25119
+ }), {
25120
+ kind: "mutation",
25121
+ auth: "admin"
25122
+ }), method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
24560
25123
  kind: "mutation",
24561
25124
  auth: "admin"
24562
25125
  }), method(StorageMigrationLeaseInputSchema, object({ resumed: literal(true) }), {
@@ -24710,7 +25273,10 @@ method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
24710
25273
  }), CameraSwitchGroupSchema, {
24711
25274
  kind: "mutation",
24712
25275
  auth: "admin"
24713
- }), method(object({ deviceId: number() }), CameraStatusSchema), method(object({ deviceIds: array(number()).optional() }), array(CameraStatusSchema).readonly()), method(_void(), DiskReconcileJobSchema, {
25276
+ }), method(object({ deviceId: number() }), CameraStatusSchema), method(object({ deviceIds: array(number()).optional() }), array(CameraStatusSchema).readonly()), method(SetCameraSensorsInputSchema, object({ success: literal(true) }), {
25277
+ kind: "mutation",
25278
+ auth: "admin"
25279
+ }), method(_void(), DiskReconcileJobSchema, {
24714
25280
  kind: "mutation",
24715
25281
  auth: "admin"
24716
25282
  }), method(_void(), DiskReconcileJobSchema, { auth: "admin" }), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
@@ -26916,219 +27482,6 @@ DeviceType.Camera, method(object({
26916
27482
  auth: "protected"
26917
27483
  });
26918
27484
  /**
26919
- * Doorbell button cap. Two kinds of providers coexist behind this cap
26920
- * name (same pattern as `snapshot`):
26921
- *
26922
- * - **Native** providers: registered per-device by device-driver
26923
- * addons via `ctx.registerNativeCap` — either on a
26924
- * `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
26925
- * or directly on the camera (Reolink registers at camera level).
26926
- * Emits an `onPressed` event every time the firmware pushes a
26927
- * ring; status tracks the last press and a pressCount since start
26928
- * (diagnostic).
26929
- *
26930
- * - **Wrapper** provider: the `virtual-doorbell` system builtin
26931
- * (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
26932
- * device (contact / switch / event-emitter …) into a doorbell for
26933
- * a camera. `defaultActive: false` — the operator explicitly binds
26934
- * it per camera in the device-bindings UI, then picks the source
26935
- * device + trigger in the per-device settings.
26936
- *
26937
- * The DeviceEventPropagator re-emits `onPressed` on the camera parent
26938
- * — subscribers listening at the camera level receive ring events
26939
- * with `via[]` populated. No code on the parent needed.
26940
- */
26941
- var DoorbellStatusSchema = object({
26942
- /** Ms epoch of the last press. null = never observed since this provider started. */
26943
- lastPressedAt: number().nullable(),
26944
- /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
26945
- pressCountSinceStart: number()
26946
- });
26947
- var DoorbellPressEventSchema = object({
26948
- deviceId: number(),
26949
- timestamp: number()
26950
- });
26951
- /**
26952
- * The `doorbell-source` extension slot's editable value (D648): the camera's
26953
- * virtual-doorbell trigger devices, exactly what the wrapper's
26954
- * `doorbellSources` persists (as `{ deviceId }` records).
26955
- */
26956
- var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number().int().positive()) });
26957
- /**
26958
- * The `doorbell-source` slot — which devices ring this camera's VIRTUAL
26959
- * doorbell, owned by the `virtual-doorbell` wrapper over its
26960
- * `doorbellSources` store (D648). A source rings when one of its
26961
- * `SOURCE_CAPS` rises. Whether the wrapper is bound to the camera at all is a
26962
- * different authority (`deviceManager.setWrapperActive`, D62) — the slot
26963
- * reports it, it never writes it.
26964
- */
26965
- var DOORBELL_SOURCE_SLOT = {
26966
- id: "doorbell-source",
26967
- label: "Doorbell trigger devices",
26968
- 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.",
26969
- shape: "association",
26970
- hostDeviceTypes: [DeviceType.Camera],
26971
- sourceCaps: SOURCE_CAPS,
26972
- cardinality: "many",
26973
- value: DoorbellSourceSlotValueSchema
26974
- };
26975
- var doorbellCapability = {
26976
- name: "doorbell",
26977
- scope: "device",
26978
- deviceNative: true,
26979
- mode: "singleton",
26980
- kind: "wrapper",
26981
- defaultActive: false,
26982
- deviceTypes: [DeviceType.Button, DeviceType.Camera],
26983
- extensionSlots: [DOORBELL_SOURCE_SLOT],
26984
- methods: {},
26985
- events: {
26986
- /**
26987
- * Fires once per physical press. Reolink delivers via Baichuan
26988
- * push (`ReolinkSimpleEvent.type === 'doorbell'`). There is no
26989
- * release/duration — it's a pulse.
26990
- */
26991
- onPressed: {
26992
- data: DoorbellPressEventSchema,
26993
- fromState: {
26994
- field: "lastPressedAt",
26995
- on: "advance"
26996
- }
26997
- } },
26998
- status: {
26999
- schema: DoorbellStatusSchema,
27000
- kind: "push"
27001
- },
27002
- /**
27003
- * Runtime-state slice — last press timestamp + lifetime press count.
27004
- * Mirrored by the kernel and readable via
27005
- * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
27006
- * without subscribing.
27007
- */
27008
- runtimeState: DoorbellStatusSchema,
27009
- /**
27010
- * 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.
27011
- *
27012
- * See `RuntimeStateDurability`. Enforced by
27013
- * `scripts/check-runtime-state-durability.ts`.
27014
- */
27015
- durability: "restored"
27016
- };
27017
- var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
27018
- DeviceType.Camera, DeviceType.Camera;
27019
- /** A slot's editable value, discriminated on `slot`. */
27020
- var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
27021
- DeviceType.Camera;
27022
- var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
27023
- state: literal("unreachable"),
27024
- reason: string$2()
27025
- })]);
27026
- /** One provider of slots — the D554 source-listing row. */
27027
- var ExtensionSourceSchema = object({
27028
- /** The routing prefix of every `slotRef` this provider serves. */
27029
- source: string$2(),
27030
- label: string$2(),
27031
- /** Stamped by the dispatcher from the registry (D557). */
27032
- addonId: string$2().optional(),
27033
- availability: ExtensionSourceAvailabilitySchema
27034
- });
27035
- /**
27036
- * How one picked source stands. `missing` — no such device (deleted, or an id
27037
- * that never existed); `foreign` — a device the slot's owner cannot read from
27038
- * (a source owned by another addon); `unavailable` — it exists but is not a
27039
- * valid source now (a container, which is never a pick). A source in any of
27040
- * these states is SHOWN, never silently dropped or re-pointed.
27041
- */
27042
- var ExtensionSourceHealthSchema = _enum([
27043
- "ok",
27044
- "missing",
27045
- "foreign",
27046
- "unavailable"
27047
- ]);
27048
- var ExtensionSlotSourceSchema = object({
27049
- deviceId: number().int(),
27050
- /** The device's name, or null when it could not be resolved (`missing`). */
27051
- name: string$2().nullable(),
27052
- health: ExtensionSourceHealthSchema,
27053
- detail: string$2().optional()
27054
- });
27055
- /**
27056
- * A DIFFERENT authority that gates whether the slot's sources do anything —
27057
- * reported read-only, named, never written through this contract (D62). The
27058
- * virtual doorbell's sources ring only while the wrapper is bound to the
27059
- * camera, and that binding belongs to `deviceManager.setWrapperActive`.
27060
- * `unknown` means the gate could not be read; it is not "inactive" (D315).
27061
- */
27062
- var ExtensionSlotActivationSchema = object({
27063
- state: _enum([
27064
- "active",
27065
- "inactive",
27066
- "unknown"
27067
- ]),
27068
- authority: string$2(),
27069
- detail: string$2().optional()
27070
- });
27071
- var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
27072
- state: literal("ok"),
27073
- /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
27074
- slotRef: string$2(),
27075
- slot: ExtensionSlotIdSchema,
27076
- /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
27077
- authority: string$2(),
27078
- activation: ExtensionSlotActivationSchema.nullable(),
27079
- value: ExtensionSlotValueSchema,
27080
- sources: array(ExtensionSlotSourceSchema),
27081
- /**
27082
- * Devices the owner links to the host ON ITS OWN, by structure, and that
27083
- * are therefore not in `value` (D655): a camera's device-tree children, and
27084
- * the child a picked container stands for (D356 — a container is never a
27085
- * pick, its children are). Read-only; the editor shows them and may offer
27086
- * per-device options on them (the linked-devices tracked-event opt-in).
27087
- * Absent when the owner links nothing beyond the picks, and from an owner
27088
- * older than D655.
27089
- */
27090
- impliedSources: array(ExtensionSlotSourceSchema).optional()
27091
- }), object({
27092
- state: literal("unreachable"),
27093
- addonId: string$2(),
27094
- reason: string$2()
27095
- })]);
27096
- var ExtensionCandidatesSchema = object({ candidates: array(object({
27097
- deviceId: number().int(),
27098
- name: string$2(),
27099
- type: string$2(),
27100
- location: string$2().nullable(),
27101
- /** The container a child belongs to — "Spotlight 2" alone does not say which. */
27102
- parentName: string$2().nullable(),
27103
- /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
27104
- suggested: boolean(),
27105
- /** Why it is suggested ("same location"), null when it is not. */
27106
- reason: string$2().nullable()
27107
- })) });
27108
- /**
27109
- * What a write did. `none` — applied in place. `host` / `parent` — the owner
27110
- * reloaded the host (or, for an accessory child, its parent) because the
27111
- * write changed what the host REGISTERS. A slot never adds a capability to its
27112
- * host — that is a composition (D663) — so today's owners answer `none`.
27113
- */
27114
- var ExtensionSetResultSchema = object({
27115
- applied: literal(true),
27116
- reload: _enum([
27117
- "none",
27118
- "host",
27119
- "parent"
27120
- ])
27121
- });
27122
- var ExtensionSlotRefInputSchema = object({
27123
- deviceId: number().int(),
27124
- slotRef: string$2().min(1)
27125
- });
27126
- var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
27127
- method(object({ deviceId: number().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
27128
- kind: "mutation",
27129
- auth: "admin"
27130
- });
27131
- /**
27132
27485
  * Optional client-side hints sent at session creation to help the provider
27133
27486
  * pick the best native source. All fields optional — a viewer that knows
27134
27487
  * nothing still gets a sane default. (Relocated from the retired `webrtc`
@@ -38311,47 +38664,6 @@ var zoneRulesCapability = {
38311
38664
  */
38312
38665
  durability: "restored"
38313
38666
  };
38314
- var NUMBER = {
38315
- kind: "fixed",
38316
- result: ["number"]
38317
- };
38318
- var BOOLEAN = {
38319
- kind: "fixed",
38320
- result: ["boolean"]
38321
- };
38322
- Object.freeze({
38323
- min: NUMBER,
38324
- max: NUMBER,
38325
- abs: NUMBER,
38326
- floor: NUMBER,
38327
- ceil: NUMBER,
38328
- sqrt: NUMBER,
38329
- round: NUMBER,
38330
- pow: NUMBER,
38331
- clamp: NUMBER,
38332
- avg: NUMBER,
38333
- sum: NUMBER,
38334
- age: NUMBER,
38335
- convert: NUMBER,
38336
- coalesce: { kind: "coalesce" },
38337
- any: BOOLEAN,
38338
- all: BOOLEAN,
38339
- within: BOOLEAN,
38340
- latest: {
38341
- kind: "fixed",
38342
- result: ["number", "null"]
38343
- },
38344
- number: {
38345
- kind: "fixed",
38346
- result: ["number", "null"]
38347
- },
38348
- rose: {
38349
- kind: "fixed",
38350
- result: ["number", "null"]
38351
- },
38352
- count: NUMBER
38353
- });
38354
- `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
38355
38667
  /**
38356
38668
  * Accessory device helpers — shared across drivers.
38357
38669
  *
@@ -42297,6 +42609,12 @@ Object.freeze({
42297
42609
  addonId: null,
42298
42610
  access: "view"
42299
42611
  },
42612
+ "coreBlocks.listComposableCaps": {
42613
+ capName: "core-blocks",
42614
+ capScope: "system",
42615
+ addonId: null,
42616
+ access: "view"
42617
+ },
42300
42618
  "coreBlocks.listCompositions": {
42301
42619
  capName: "core-blocks",
42302
42620
  capScope: "system",
@@ -42375,6 +42693,18 @@ Object.freeze({
42375
42693
  addonId: null,
42376
42694
  access: "view"
42377
42695
  },
42696
+ "databaseSnapshot.listDatabases": {
42697
+ capName: "database-snapshot",
42698
+ capScope: "system",
42699
+ addonId: null,
42700
+ access: "view"
42701
+ },
42702
+ "databaseSnapshot.writeSnapshot": {
42703
+ capName: "database-snapshot",
42704
+ capScope: "system",
42705
+ addonId: null,
42706
+ access: "create"
42707
+ },
42378
42708
  "dataStoreProvider.aggregate": {
42379
42709
  capName: "data-store-provider",
42380
42710
  capScope: "system",
@@ -45111,6 +45441,12 @@ Object.freeze({
45111
45441
  addonId: null,
45112
45442
  access: "create"
45113
45443
  },
45444
+ "pipelineAnalytics.clearTrackRelation": {
45445
+ capName: "pipeline-analytics",
45446
+ capScope: "device",
45447
+ addonId: null,
45448
+ access: "delete"
45449
+ },
45114
45450
  "pipelineAnalytics.clearTracks": {
45115
45451
  capName: "pipeline-analytics",
45116
45452
  capScope: "device",
@@ -45363,6 +45699,12 @@ Object.freeze({
45363
45699
  addonId: null,
45364
45700
  access: "view"
45365
45701
  },
45702
+ "pipelineAnalytics.listTrackRelations": {
45703
+ capName: "pipeline-analytics",
45704
+ capScope: "device",
45705
+ addonId: null,
45706
+ access: "view"
45707
+ },
45366
45708
  "pipelineAnalytics.listTracks": {
45367
45709
  capName: "pipeline-analytics",
45368
45710
  capScope: "device",
@@ -45477,6 +45819,18 @@ Object.freeze({
45477
45819
  addonId: null,
45478
45820
  access: "create"
45479
45821
  },
45822
+ "pipelineAnalytics.setTrackPurity": {
45823
+ capName: "pipeline-analytics",
45824
+ capScope: "device",
45825
+ addonId: null,
45826
+ access: "create"
45827
+ },
45828
+ "pipelineAnalytics.setTrackRelation": {
45829
+ capName: "pipeline-analytics",
45830
+ capScope: "device",
45831
+ addonId: null,
45832
+ access: "create"
45833
+ },
45480
45834
  "pipelineAnalytics.startStorageMigrationMove": {
45481
45835
  capName: "pipeline-analytics",
45482
45836
  capScope: "device",
@@ -45915,6 +46269,12 @@ Object.freeze({
45915
46269
  addonId: null,
45916
46270
  access: "delete"
45917
46271
  },
46272
+ "pipelineOrchestrator.requestOccupancyLook": {
46273
+ capName: "pipeline-orchestrator",
46274
+ capScope: "system",
46275
+ addonId: null,
46276
+ access: "create"
46277
+ },
45918
46278
  "pipelineOrchestrator.resetNodePipelineDefaults": {
45919
46279
  capName: "pipeline-orchestrator",
45920
46280
  capScope: "system",
@@ -45981,6 +46341,12 @@ Object.freeze({
45981
46341
  addonId: null,
45982
46342
  access: "create"
45983
46343
  },
46344
+ "pipelineOrchestrator.setCameraSensors": {
46345
+ capName: "pipeline-orchestrator",
46346
+ capScope: "system",
46347
+ addonId: null,
46348
+ access: "create"
46349
+ },
45984
46350
  "pipelineOrchestrator.setCameraStepOverride": {
45985
46351
  capName: "pipeline-orchestrator",
45986
46352
  capScope: "system",
@@ -49391,6 +49757,11 @@ Object.freeze({
49391
49757
  form: "single",
49392
49758
  optional: false
49393
49759
  }],
49760
+ "pipelineAnalytics.clearTrackRelation": [{
49761
+ name: "deviceId",
49762
+ form: "single",
49763
+ optional: false
49764
+ }],
49394
49765
  "pipelineAnalytics.clearTracks": [{
49395
49766
  name: "deviceId",
49396
49767
  form: "single",
@@ -49541,6 +49912,11 @@ Object.freeze({
49541
49912
  form: "single",
49542
49913
  optional: false
49543
49914
  }],
49915
+ "pipelineAnalytics.listTrackRelations": [{
49916
+ name: "deviceId",
49917
+ form: "single",
49918
+ optional: false
49919
+ }],
49544
49920
  "pipelineAnalytics.listTracks": [{
49545
49921
  name: "deviceId",
49546
49922
  form: "single",
@@ -49611,6 +49987,16 @@ Object.freeze({
49611
49987
  form: "single",
49612
49988
  optional: false
49613
49989
  }],
49990
+ "pipelineAnalytics.setTrackPurity": [{
49991
+ name: "deviceId",
49992
+ form: "single",
49993
+ optional: false
49994
+ }],
49995
+ "pipelineAnalytics.setTrackRelation": [{
49996
+ name: "deviceId",
49997
+ form: "single",
49998
+ optional: false
49999
+ }],
49614
50000
  "pipelineAnalytics.wipeAllAnalytics": [{
49615
50001
  name: "deviceId",
49616
50002
  form: "single",
@@ -49681,6 +50067,11 @@ Object.freeze({
49681
50067
  form: "single",
49682
50068
  optional: false
49683
50069
  }],
50070
+ "pipelineOrchestrator.requestOccupancyLook": [{
50071
+ name: "deviceId",
50072
+ form: "single",
50073
+ optional: false
50074
+ }],
49684
50075
  "pipelineOrchestrator.resolvePipeline": [{
49685
50076
  name: "deviceId",
49686
50077
  form: "single",
@@ -49691,6 +50082,11 @@ Object.freeze({
49691
50082
  form: "single",
49692
50083
  optional: false
49693
50084
  }],
50085
+ "pipelineOrchestrator.setCameraSensors": [{
50086
+ name: "deviceId",
50087
+ form: "single",
50088
+ optional: false
50089
+ }],
49694
50090
  "pipelineOrchestrator.setCameraStepOverride": [{
49695
50091
  name: "deviceId",
49696
50092
  form: "single",
@@ -50837,6 +51233,18 @@ var STATE_SUMMARY_VARS = [
50837
51233
  systemEventKinds: [...SUMMARISABLE],
50838
51234
  systemEventDeliveries: ["summary"]
50839
51235
  },
51236
+ {
51237
+ name: "summarySection",
51238
+ label: "Summary: this section",
51239
+ description: "The section a per-section summary row is about (D698); on a summary sent as one message, every section it reports, comma-separated.",
51240
+ example: "Batterie scariche",
51241
+ group: "system",
51242
+ families: ["rule"],
51243
+ fields: [...RULE_TEXT],
51244
+ kinds: ["system"],
51245
+ systemEventKinds: [...SUMMARISABLE],
51246
+ systemEventDeliveries: ["summary"]
51247
+ },
50840
51248
  ...STATE_SUMMARY_SECTION_VARS.map((v) => ({
50841
51249
  name: v.name,
50842
51250
  label: v.label,
@@ -50913,6 +51321,37 @@ var STATE_SUMMARY_VARS = [
50913
51321
  [...RULE_TEXT],
50914
51322
  ...STATE_SUMMARY_VARS
50915
51323
  ];
51324
+ new Set([
51325
+ "disarmed",
51326
+ "armed_home",
51327
+ "armed_away",
51328
+ "armed_night",
51329
+ "armed_vacation",
51330
+ "armed_custom_bypass",
51331
+ "arming",
51332
+ "disarming",
51333
+ "pending",
51334
+ "triggered",
51335
+ "open",
51336
+ "opening",
51337
+ "closing",
51338
+ "closed",
51339
+ "stopped",
51340
+ "locked",
51341
+ "unlocked",
51342
+ "locking",
51343
+ "unlocking",
51344
+ "jammed",
51345
+ "on",
51346
+ "off",
51347
+ "home",
51348
+ "not_home",
51349
+ "matched",
51350
+ "diverged",
51351
+ "unknown",
51352
+ "latched",
51353
+ "live"
51354
+ ]);
50916
51355
  /**
50917
51356
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
50918
51357
  *