@camstack/addon-ai 0.4.127 → 0.4.128

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 +690 -390
  2. package/dist/addon.mjs +690 -390
  3. package/package.json +2 -2
package/dist/addon.mjs CHANGED
@@ -5561,7 +5561,7 @@ function number(params) {
5561
5561
  return /* @__PURE__ */ _coercedNumber(ZodNumber, params);
5562
5562
  }
5563
5563
  //#endregion
5564
- //#region ../types/dist/sleep-DlrgY4Qb.mjs
5564
+ //#region ../types/dist/sleep-gU6hqv4_.mjs
5565
5565
  /**
5566
5566
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5567
5567
  * window to float samples (D455).
@@ -7649,7 +7649,59 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
7649
7649
  return DeviceRole;
7650
7650
  }({});
7651
7651
  //#endregion
7652
- //#region ../types/dist/composition-BK-GTFYb.mjs
7652
+ //#region ../types/dist/composition-Dq42XWp0.mjs
7653
+ /**
7654
+ * The ffmpeg build every CamStack node downloads, per platform and arch.
7655
+ *
7656
+ * ## Why a download, on every node, including the container
7657
+ *
7658
+ * The version of ffmpeg used to be CODE: baked into the image, changeable only
7659
+ * by rebuilding and rolling it. Now it is DATA — this file states the release,
7660
+ * and a node that boots with a different one downloads it. Changing ffmpeg is a
7661
+ * framework bump, not an image rebuild.
7662
+ *
7663
+ * It also settles the licence question by removing it. FFmpeg's licence is
7664
+ * chosen at compile time: the core is LGPL 2.1+, `--enable-gpl` makes it GPL
7665
+ * (for x264/x265), `--enable-version3` makes that v3, and `--enable-nonfree`
7666
+ * makes the result undistributable. These are GPL v3 builds, and we do not
7667
+ * distribute them: the user's own node fetches the archive from the project
7668
+ * that publishes it, so we convey no GPL work and inherit none of the
7669
+ * obligations that come with conveying one. That is the whole reason the image
7670
+ * no longer installs ffmpeg at all — not a technical preference.
7671
+ *
7672
+ * ## Why jellyfin-ffmpeg
7673
+ *
7674
+ * One vendor covering linux-amd64, linux-arm64, darwin-arm64 and darwin-x64
7675
+ * from one release, with the widest hardware surface of anything maintained:
7676
+ * VAAPI, QSV, NVENC/NVDEC, AMF, Vulkan, OpenCL and DRM on amd64, plus Rockchip
7677
+ * MPP on arm64. It reaches the vendor libraries through dlopen trampolines,
7678
+ * so the binary is not linked against a driver stack it may not find.
7679
+ *
7680
+ * **What it still needs from the host, measured 2026-09-19.** On the Unraid
7681
+ * HOST, which has no libva, `-vaapi_device` aborts the process outright —
7682
+ * `implib-gen: libva-drm.so.2: failed to load library ... Assertion '0 &&
7683
+ * "Assertion in generated code"' failed`. Inside our container, which installs
7684
+ * libva plus the iHD driver, the same command encodes: verified end to end with
7685
+ * `testsrc → format=nv12,hwupload → h264_vaapi`. So the image drops ffmpeg and
7686
+ * KEEPS the Intel media stack; the drivers are the part a binary cannot bring.
7687
+ *
7688
+ * ## Why each artifact carries a checksum and a claim
7689
+ *
7690
+ * The download is now the only source, so `sha256` is verified before anything
7691
+ * is extracted — jellyfin publishes no checksums on its release assets, so
7692
+ * these are ours, taken at the version bump. And `expectedHwaccels` is what the
7693
+ * build is supposed to be able to do: a binary that probes short of its own
7694
+ * claim is a source that changed under us, which is precisely what went
7695
+ * unnoticed for months when a static build turned out to carry no VAAPI at all
7696
+ * (D536).
7697
+ */
7698
+ /** The pinned jellyfin-ffmpeg release. Changing this is the version change. */
7699
+ var FFMPEG_RELEASE = "8.1.2-5";
7700
+ var BASE = `https://github.com/jellyfin/jellyfin-ffmpeg/releases/download/v${FFMPEG_RELEASE}`;
7701
+ function portable(target) {
7702
+ return `${BASE}/jellyfin-ffmpeg_${FFMPEG_RELEASE}_portable_${target}-gpl.tar.xz`;
7703
+ }
7704
+ portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac64");
7653
7705
  /**
7654
7706
  * LA tabella "quale booleano di questo tipo di device conta come ALTO", e il
7655
7707
  * valutatore puro del suo FRONTE.
@@ -8453,7 +8505,6 @@ var CompositionSchema = object({
8453
8505
  });
8454
8506
  new Set([
8455
8507
  "track",
8456
- "summary",
8457
8508
  "face",
8458
8509
  "identity",
8459
8510
  "plate",
@@ -9122,6 +9173,82 @@ var ArchivedDebugNoteQueryInputSchema = object({
9122
9173
  /** Max rows returned, newest-first. */
9123
9174
  limit: number$1().int().min(1).max(1e3).optional()
9124
9175
  });
9176
+ var TrackRelationKindSchema = _enum(["same-subject", "different-subjects"]);
9177
+ var TrackSideSchema = _enum(["before", "after"]);
9178
+ var TrackPurityValueSchema = _enum(["mixed", "not-a-subject"]);
9179
+ var TrackRelationSchema = object({
9180
+ id: string(),
9181
+ deviceId: number$1().int(),
9182
+ leftTrackId: string(),
9183
+ rightTrackId: string(),
9184
+ leftSide: TrackSideSchema.nullable(),
9185
+ rightSide: TrackSideSchema.nullable(),
9186
+ relation: TrackRelationKindSchema,
9187
+ presence: literal("continuous").nullable(),
9188
+ leftStartedAt: number$1().int().nullable(),
9189
+ rightStartedAt: number$1().int().nullable(),
9190
+ createdAt: number$1().int(),
9191
+ updatedAt: number$1().int(),
9192
+ author: string().nullable()
9193
+ });
9194
+ var TrackPuritySchema = object({
9195
+ id: string(),
9196
+ deviceId: number$1().int(),
9197
+ sourceTrackId: string(),
9198
+ purity: TrackPurityValueSchema,
9199
+ switchAtMs: number$1().int().nullable(),
9200
+ startedAt: number$1().int().nullable(),
9201
+ createdAt: number$1().int(),
9202
+ updatedAt: number$1().int(),
9203
+ author: string().nullable()
9204
+ });
9205
+ var SetTrackRelationInputSchema = object({
9206
+ deviceId: number$1().int(),
9207
+ trackId: string().min(1),
9208
+ otherTrackId: string().min(1),
9209
+ relation: TrackRelationKindSchema,
9210
+ presence: literal("continuous").optional(),
9211
+ trackSide: TrackSideSchema.optional(),
9212
+ otherSide: TrackSideSchema.optional()
9213
+ });
9214
+ var ClearTrackRelationInputSchema = object({
9215
+ deviceId: number$1().int(),
9216
+ trackId: string().min(1),
9217
+ otherTrackId: string().min(1)
9218
+ });
9219
+ var ClearTrackRelationResultSchema = object({ cleared: boolean() });
9220
+ var SetTrackPurityInputSchema = object({
9221
+ deviceId: number$1().int(),
9222
+ trackId: string().min(1),
9223
+ purity: _enum([
9224
+ "pure",
9225
+ "mixed",
9226
+ "not-a-subject"
9227
+ ]),
9228
+ switchAtMs: number$1().int().optional()
9229
+ });
9230
+ /** `null` when `pure` cleared the row. */
9231
+ var SetTrackPurityResultSchema = object({ purity: TrackPuritySchema.nullable() });
9232
+ var ListTrackRelationsInputSchema = object({
9233
+ deviceId: number$1().int(),
9234
+ trackId: string().optional(),
9235
+ since: number$1().int().optional(),
9236
+ until: number$1().int().optional(),
9237
+ limit: number$1().int().min(1).max(5e3).optional()
9238
+ });
9239
+ var ListTrackRelationsResultSchema = object({
9240
+ relations: array(TrackRelationSchema).readonly(),
9241
+ purities: array(TrackPuritySchema).readonly(),
9242
+ truncated: boolean()
9243
+ });
9244
+ _enum([
9245
+ "unknown-track",
9246
+ "cross-device",
9247
+ "self-relation",
9248
+ "contradiction",
9249
+ "switch-outside-track",
9250
+ "switch-needs-mixed"
9251
+ ]);
9125
9252
  /**
9126
9253
  * Ops-log — the durable, append-only operations audit shared by the
9127
9254
  * recordings and events management surfaces.
@@ -11675,6 +11802,68 @@ method(object({
11675
11802
  password: string()
11676
11803
  }), AuthResultSchema.nullable(), { kind: "mutation" }), method(object({ state: string() }), string()), method(record(string(), string()), AuthResultSchema, { kind: "mutation" }), method(object({ token: string() }), AuthResultSchema.nullable());
11677
11804
  /**
11805
+ * How long one snapshot may take end to end: the pinned copy of the whole
11806
+ * database plus `PRAGMA integrity_check` over the copy, on the hub's slowest
11807
+ * disk. ~800 MB at a pessimistic 10 MB/s is under 3 minutes; the bound is
11808
+ * generous because a timeout fails the whole backup run.
11809
+ */
11810
+ var DATABASE_SNAPSHOT_TIMEOUT_MS = 30 * 6e4;
11811
+ /**
11812
+ * The databases an owner snapshots — declared by the OWNER, so a caller never
11813
+ * guesses which file is live from what sits beside it (a cleanly closed
11814
+ * database has no sidecars and is just as owned). Paths are absolute on the
11815
+ * owner's host.
11816
+ */
11817
+ var DatabaseSnapshotTargetsSchema = object({ databases: array(object({ livePath: string() })) });
11818
+ /** One b-tree table of the snapshot and the rows it holds. */
11819
+ var DatabaseSnapshotTableSchema = object({
11820
+ name: string(),
11821
+ rows: number$1().int().nonnegative()
11822
+ });
11823
+ /**
11824
+ * What the owner wrote. Every path is ABSOLUTE on the owner's host — the
11825
+ * caller pins the call to its own node, so it can read the file; a caller
11826
+ * that finds the path outside its own data root refuses it rather than
11827
+ * archiving something it cannot place.
11828
+ */
11829
+ var DatabaseSnapshotResultSchema = object({
11830
+ /** The live database the snapshot copies. Never to be copied as a file. */
11831
+ livePath: string(),
11832
+ /** The verified copy: `<livePath>` + {@link DATABASE_SNAPSHOT_SUFFIX}. */
11833
+ snapshotPath: string(),
11834
+ sizeBytes: number$1().int().nonnegative(),
11835
+ pageCount: number$1().int().nonnegative(),
11836
+ pageSize: number$1().int().positive(),
11837
+ /**
11838
+ * Every b-tree table with its row count. Read inside the SAME read
11839
+ * transaction the copy was taken from, and found EQUAL on the copy — so
11840
+ * this is the content of the snapshot, not an estimate of the source.
11841
+ */
11842
+ tables: array(DatabaseSnapshotTableSchema),
11843
+ /** Wall time of the pinned copy (row counts included). */
11844
+ copyMs: number$1().nonnegative(),
11845
+ /** Wall time of the checks on the copy (`integrity_check`, row counts). */
11846
+ verifyMs: number$1().nonnegative(),
11847
+ /** When the pinned read transaction began (ms epoch) — the snapshot's instant. */
11848
+ takenAt: number$1()
11849
+ });
11850
+ /**
11851
+ * A snapshot as an ARCHIVE records it (`ArchiveManifest.sqliteSnapshots`):
11852
+ * the same facts, with both paths relative to the archive root (the node's
11853
+ * data dir), because an archive outlives the host that made it.
11854
+ */
11855
+ var ArchiveSqliteSnapshotSchema = DatabaseSnapshotResultSchema.extend({
11856
+ /** Archive-relative path of the live database the archive does NOT carry. */
11857
+ livePath: string(),
11858
+ /** Archive-relative path of the verified copy it carries in its place. */
11859
+ snapshotPath: string()
11860
+ });
11861
+ method(object({}), DatabaseSnapshotTargetsSchema, { auth: "admin" }), method(object({}), DatabaseSnapshotResultSchema, {
11862
+ kind: "mutation",
11863
+ auth: "admin",
11864
+ timeoutMs: DATABASE_SNAPSHOT_TIMEOUT_MS
11865
+ });
11866
+ /**
11678
11867
  * Orchestrator-side destination metadata. The orchestrator computes
11679
11868
  * `id = <addonId>:<subId>` from its provider lookup so consumers
11680
11869
  * (admin UI, restore flow) see one canonical key.
@@ -11785,7 +11974,12 @@ var ArchiveManifestSchema = object({
11785
11974
  locations: array(string()),
11786
11975
  entries: array(ArchiveEntrySchema),
11787
11976
  totalBytes: number$1(),
11788
- totalFiles: number$1()
11977
+ totalFiles: number$1(),
11978
+ /**
11979
+ * Live SQLite databases this archive carries as their OWNER's verified
11980
+ * snapshot instead of as files (D693). Absent on archives made before.
11981
+ */
11982
+ sqliteSnapshots: array(ArchiveSqliteSnapshotSchema).optional()
11789
11983
  });
11790
11984
  var LocationStatSchema = object({
11791
11985
  name: string(),
@@ -13209,6 +13403,116 @@ var CompositionBlockStateSchema = object({
13209
13403
  reason: string().optional(),
13210
13404
  fields: array(CompositionFieldStateSchema)
13211
13405
  });
13406
+ var ComposerBlockSchema = object({
13407
+ id: string().min(1),
13408
+ name: string().min(1).max(120),
13409
+ enabled: boolean(),
13410
+ updatedAt: number$1(),
13411
+ composition: CompositionSchema
13412
+ });
13413
+ /**
13414
+ * A stored composition row that no longer PARSES — a schema a release
13415
+ * tightened, a row written by a newer build. Sent by id so the composer keeps
13416
+ * its device as a placeholder and reports the block `failed` naming the parse
13417
+ * error. Leaving it out would read, twice, exactly like a delete (D49).
13418
+ */
13419
+ var ComposerUnreadableBlockSchema = object({
13420
+ id: string().min(1),
13421
+ /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
13422
+ name: string().nullable(),
13423
+ /** The parse error, in the operator's words. */
13424
+ error: string()
13425
+ });
13426
+ method(object({
13427
+ /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
13428
+ integrationId: string().nullable(),
13429
+ /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
13430
+ storeLoaded: boolean(),
13431
+ blocks: array(ComposerBlockSchema),
13432
+ /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
13433
+ restartBlockIds: array(string()),
13434
+ /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
13435
+ unreadableBlocks: array(ComposerUnreadableBlockSchema)
13436
+ }), object({
13437
+ blocks: array(object({
13438
+ blockId: string(),
13439
+ status: CompositionRunStatusSchema,
13440
+ reason: string().optional()
13441
+ })),
13442
+ /**
13443
+ * False when the composer declared and withdrew NOTHING (store not loaded,
13444
+ * integration unknown, its own rows unread or read empty once). An empty
13445
+ * apply the caller owes is paid off only by one the composer acted on (D49).
13446
+ */
13447
+ acted: boolean()
13448
+ }), {
13449
+ kind: "mutation",
13450
+ auth: "admin"
13451
+ }), method(object({ blockIds: array(string()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
13452
+ var NUMBER = {
13453
+ kind: "fixed",
13454
+ result: ["number"]
13455
+ };
13456
+ var BOOLEAN = {
13457
+ kind: "fixed",
13458
+ result: ["boolean"]
13459
+ };
13460
+ Object.freeze({
13461
+ min: NUMBER,
13462
+ max: NUMBER,
13463
+ abs: NUMBER,
13464
+ floor: NUMBER,
13465
+ ceil: NUMBER,
13466
+ sqrt: NUMBER,
13467
+ round: NUMBER,
13468
+ pow: NUMBER,
13469
+ clamp: NUMBER,
13470
+ avg: NUMBER,
13471
+ sum: NUMBER,
13472
+ age: NUMBER,
13473
+ convert: NUMBER,
13474
+ coalesce: { kind: "coalesce" },
13475
+ any: BOOLEAN,
13476
+ all: BOOLEAN,
13477
+ within: BOOLEAN,
13478
+ latest: {
13479
+ kind: "fixed",
13480
+ result: ["number", "null"]
13481
+ },
13482
+ number: {
13483
+ kind: "fixed",
13484
+ result: ["number", "null"]
13485
+ },
13486
+ rose: {
13487
+ kind: "fixed",
13488
+ result: ["number", "null"]
13489
+ },
13490
+ count: NUMBER
13491
+ });
13492
+ `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
13493
+ /**
13494
+ * What a composition may BUILD on a device type (G2, D676): the caps a new
13495
+ * device of that type, or an existing one that lacks them, can be given. The
13496
+ * blockers are the validator's own refusal codes, and a spec compares this
13497
+ * listing with `planComposition` for every capability — the editor can never
13498
+ * offer a feature the save would refuse for the same reason.
13499
+ */
13500
+ var ComposableFieldSchema = object({
13501
+ path: string(),
13502
+ kind: CompositionFieldKindSchema,
13503
+ nullable: boolean(),
13504
+ required: boolean(),
13505
+ enumValues: array(string()).optional()
13506
+ });
13507
+ var ComposableCapabilitiesSchema = object({ caps: array(object({
13508
+ cap: string(),
13509
+ fields: array(ComposableFieldSchema),
13510
+ /** Present for an item-array cap (`consumables.items`). */
13511
+ itemArray: object({
13512
+ path: string(),
13513
+ keyField: string()
13514
+ }).optional()
13515
+ })) });
13212
13516
  /** Where a block runs. The operator chooses — a block driving a device on an
13213
13517
  * agent is the reason placement is not fixed to the hub. */
13214
13518
  var CoreBlockPlacementSchema = union([literal("hub"), string().min(1)]);
@@ -13373,7 +13677,7 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
13373
13677
  }), method(object({ blockId: string() }), CompositionGetReadSchema, { auth: "admin" }), method(object({}), CompositionListReadSchema, { auth: "admin" }), method(object({
13374
13678
  addonId: string().min(1),
13375
13679
  stableId: string().min(1)
13376
- }), CompositionCustomizationReadSchema, { auth: "admin" }), method(object({
13680
+ }), CompositionCustomizationReadSchema, { auth: "admin" }), method(object({ deviceType: _enum(DeviceType) }), ComposableCapabilitiesSchema, { auth: "admin" }), method(object({
13377
13681
  composition: CompositionSchema,
13378
13682
  blockId: string().optional()
13379
13683
  }), CompositionValidationSchema, {
@@ -13381,52 +13685,6 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
13381
13685
  auth: "admin",
13382
13686
  access: "view"
13383
13687
  });
13384
- var ComposerBlockSchema = object({
13385
- id: string().min(1),
13386
- name: string().min(1).max(120),
13387
- enabled: boolean(),
13388
- updatedAt: number$1(),
13389
- composition: CompositionSchema
13390
- });
13391
- /**
13392
- * A stored composition row that no longer PARSES — a schema a release
13393
- * tightened, a row written by a newer build. Sent by id so the composer keeps
13394
- * its device as a placeholder and reports the block `failed` naming the parse
13395
- * error. Leaving it out would read, twice, exactly like a delete (D49).
13396
- */
13397
- var ComposerUnreadableBlockSchema = object({
13398
- id: string().min(1),
13399
- /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
13400
- name: string().nullable(),
13401
- /** The parse error, in the operator's words. */
13402
- error: string()
13403
- });
13404
- method(object({
13405
- /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
13406
- integrationId: string().nullable(),
13407
- /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
13408
- storeLoaded: boolean(),
13409
- blocks: array(ComposerBlockSchema),
13410
- /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
13411
- restartBlockIds: array(string()),
13412
- /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
13413
- unreadableBlocks: array(ComposerUnreadableBlockSchema)
13414
- }), object({
13415
- blocks: array(object({
13416
- blockId: string(),
13417
- status: CompositionRunStatusSchema,
13418
- reason: string().optional()
13419
- })),
13420
- /**
13421
- * False when the composer declared and withdrew NOTHING (store not loaded,
13422
- * integration unknown, its own rows unread or read empty once). An empty
13423
- * apply the caller owes is paid off only by one the composer acted on (D49).
13424
- */
13425
- acted: boolean()
13426
- }), {
13427
- kind: "mutation",
13428
- auth: "admin"
13429
- }), method(object({ blockIds: array(string()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
13430
13688
  /**
13431
13689
  * `custom-model-registry` — collection cap exposing operator-registered
13432
13690
  * custom detection models. Each provider (today: `addon-model-studio`)
@@ -15275,6 +15533,138 @@ method(object({
15275
15533
  deviceIds: array(number$1()).readonly(),
15276
15534
  caps: array(string()).readonly().optional()
15277
15535
  }), record(string(), record(string(), unknown().nullable())));
15536
+ object({
15537
+ /** Ms epoch of the last press. null = never observed since this provider started. */
15538
+ lastPressedAt: number$1().nullable(),
15539
+ /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
15540
+ pressCountSinceStart: number$1()
15541
+ });
15542
+ object({
15543
+ deviceId: number$1(),
15544
+ timestamp: number$1()
15545
+ });
15546
+ /**
15547
+ * The `doorbell-source` extension slot's editable value (D648): the camera's
15548
+ * virtual-doorbell trigger devices, exactly what the wrapper's
15549
+ * `doorbellSources` persists (as `{ deviceId }` records).
15550
+ */
15551
+ var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number$1().int().positive()) });
15552
+ DeviceType.Camera;
15553
+ DeviceType.Button, DeviceType.Camera;
15554
+ var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
15555
+ DeviceType.Camera, DeviceType.Camera;
15556
+ /** A slot's editable value, discriminated on `slot`. */
15557
+ var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
15558
+ DeviceType.Camera;
15559
+ var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
15560
+ state: literal("unreachable"),
15561
+ reason: string()
15562
+ })]);
15563
+ /** One provider of slots — the D554 source-listing row. */
15564
+ var ExtensionSourceSchema = object({
15565
+ /** The routing prefix of every `slotRef` this provider serves. */
15566
+ source: string(),
15567
+ label: string(),
15568
+ /** Stamped by the dispatcher from the registry (D557). */
15569
+ addonId: string().optional(),
15570
+ availability: ExtensionSourceAvailabilitySchema
15571
+ });
15572
+ /**
15573
+ * How one picked source stands. `missing` — no such device (deleted, or an id
15574
+ * that never existed); `foreign` — a device the slot's owner cannot read from
15575
+ * (a source owned by another addon); `unavailable` — it exists but is not a
15576
+ * valid source now (a container, which is never a pick). A source in any of
15577
+ * these states is SHOWN, never silently dropped or re-pointed.
15578
+ */
15579
+ var ExtensionSourceHealthSchema = _enum([
15580
+ "ok",
15581
+ "missing",
15582
+ "foreign",
15583
+ "unavailable"
15584
+ ]);
15585
+ var ExtensionSlotSourceSchema = object({
15586
+ deviceId: number$1().int(),
15587
+ /** The device's name, or null when it could not be resolved (`missing`). */
15588
+ name: string().nullable(),
15589
+ health: ExtensionSourceHealthSchema,
15590
+ detail: string().optional()
15591
+ });
15592
+ /**
15593
+ * A DIFFERENT authority that gates whether the slot's sources do anything —
15594
+ * reported read-only, named, never written through this contract (D62). The
15595
+ * virtual doorbell's sources ring only while the wrapper is bound to the
15596
+ * camera, and that binding belongs to `deviceManager.setWrapperActive`.
15597
+ * `unknown` means the gate could not be read; it is not "inactive" (D315).
15598
+ */
15599
+ var ExtensionSlotActivationSchema = object({
15600
+ state: _enum([
15601
+ "active",
15602
+ "inactive",
15603
+ "unknown"
15604
+ ]),
15605
+ authority: string(),
15606
+ detail: string().optional()
15607
+ });
15608
+ var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
15609
+ state: literal("ok"),
15610
+ /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
15611
+ slotRef: string(),
15612
+ slot: ExtensionSlotIdSchema,
15613
+ /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
15614
+ authority: string(),
15615
+ activation: ExtensionSlotActivationSchema.nullable(),
15616
+ value: ExtensionSlotValueSchema,
15617
+ sources: array(ExtensionSlotSourceSchema),
15618
+ /**
15619
+ * Devices the owner links to the host ON ITS OWN, by structure, and that
15620
+ * are therefore not in `value` (D655): a camera's device-tree children, and
15621
+ * the child a picked container stands for (D356 — a container is never a
15622
+ * pick, its children are). Read-only; the editor shows them and may offer
15623
+ * per-device options on them (the linked-devices tracked-event opt-in).
15624
+ * Absent when the owner links nothing beyond the picks, and from an owner
15625
+ * older than D655.
15626
+ */
15627
+ impliedSources: array(ExtensionSlotSourceSchema).optional()
15628
+ }), object({
15629
+ state: literal("unreachable"),
15630
+ addonId: string(),
15631
+ reason: string()
15632
+ })]);
15633
+ var ExtensionCandidatesSchema = object({ candidates: array(object({
15634
+ deviceId: number$1().int(),
15635
+ name: string(),
15636
+ type: string(),
15637
+ location: string().nullable(),
15638
+ /** The container a child belongs to — "Spotlight 2" alone does not say which. */
15639
+ parentName: string().nullable(),
15640
+ /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
15641
+ suggested: boolean(),
15642
+ /** Why it is suggested ("same location"), null when it is not. */
15643
+ reason: string().nullable()
15644
+ })) });
15645
+ /**
15646
+ * What a write did. `none` — applied in place. `host` / `parent` — the owner
15647
+ * reloaded the host (or, for an accessory child, its parent) because the
15648
+ * write changed what the host REGISTERS. A slot never adds a capability to its
15649
+ * host — that is a composition (D663) — so today's owners answer `none`.
15650
+ */
15651
+ var ExtensionSetResultSchema = object({
15652
+ applied: literal(true),
15653
+ reload: _enum([
15654
+ "none",
15655
+ "host",
15656
+ "parent"
15657
+ ])
15658
+ });
15659
+ var ExtensionSlotRefInputSchema = object({
15660
+ deviceId: number$1().int(),
15661
+ slotRef: string().min(1)
15662
+ });
15663
+ var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
15664
+ method(object({ deviceId: number$1().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number$1().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
15665
+ kind: "mutation",
15666
+ auth: "admin"
15667
+ });
15278
15668
  /**
15279
15669
  * Per-field ownership (D663). A composition may CLAIM fields of a native
15280
15670
  * cap's runtime-state slice on an existing device: `replace` overlays the
@@ -18355,17 +18745,25 @@ var NcScheduleSchema = object({
18355
18745
  */
18356
18746
  var NcSystemEventDeliveryModeSchema = _enum(["instant", "summary"]);
18357
18747
  /**
18748
+ * How a summary window is SENT (D698): `rule` (absent) = ONE notification with
18749
+ * every section; `section` = one notification per section with something to
18750
+ * say (an unavailable section included), each titled by its section.
18751
+ */
18752
+ var NcStateSummarySplitSchema = _enum(["rule", "section"]);
18753
+ /**
18358
18754
  * `summary`: the rule sends NOTHING per event. When a window of `schedule`
18359
18755
  * CLOSES, it sends one notification with the current state of its kinds
18360
18756
  * (low batteries, consumables to replace, devices offline, updates
18361
- * available, ...), after its own filters. Nothing to report sends nothing.
18757
+ * available, ...), after its own filters — or, with `split: 'section'`
18758
+ * (D698), one notification per section. Nothing to report sends nothing.
18362
18759
  * The schedule is the ordinary `NcSchedule` (weekly windows, IANA timezone,
18363
18760
  * midnight crossing); the send time is each window's END. Refused on the
18364
18761
  * `alarm` family, which stays instant (`systemEventDeliveryProblems`).
18365
18762
  */
18366
18763
  var NcSystemEventDeliverySchema = discriminatedUnion("mode", [object({ mode: literal("instant") }), object({
18367
18764
  mode: literal("summary"),
18368
- schedule: NcScheduleSchema
18765
+ schedule: NcScheduleSchema,
18766
+ split: NcStateSummarySplitSchema.optional()
18369
18767
  })]);
18370
18768
  /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
18371
18769
  var NcPlateMatcherSchema = object({
@@ -18505,8 +18903,14 @@ var NcSensorTransitionSchema = _enum(["raised", "cleared"]);
18505
18903
  /** Admin-zone membership condition (zone IDs as stamped by the ZoneEngine). */
18506
18904
  var NcZoneConditionSchema = object({
18507
18905
  ids: array(string().min(1)).min(1),
18508
- /** Quantifier over `ids` — at least one / every one visited. */
18509
- match: _enum(["any", "all"]).default("any")
18906
+ /**
18907
+ * LEGACY quantifier over `ids`. Absent = `any` (at least one visited), which
18908
+ * is what both editors mean and all they write since D690: "all of" was
18909
+ * removed from the editors because on an immediate rule it asked one
18910
+ * detection to stand in every zone at once. Still ACCEPTED, and `all` still
18911
+ * evaluated, so a stored rule keeps parsing and meaning what it meant.
18912
+ */
18913
+ match: _enum(["any", "all"]).optional()
18510
18914
  });
18511
18915
  /**
18512
18916
  * The P1 condition set — a flat AND of groups; absent group = pass;
@@ -19010,10 +19414,12 @@ var NcMediaPolicySchema = object({
19010
19414
  /**
19011
19415
  * Cooldown GRANULARITY over the subject's class — how much a fired
19012
19416
  * notification suppresses.
19013
- * - `shared` (default, and the absent value) — one window for the whole
19014
- * rule/scope: a cat silences the next dog for `cooldownSec`.
19015
- * - `per-class` — an independent window per detected class, so cat→dog fires
19016
- * at once and cat→cat still waits.
19417
+ * - `per-class` (default, and the absent value since 2026-10-01 — D36) — an
19418
+ * independent window per detected class: cat→dog fires at once, cat→cat
19419
+ * still waits.
19420
+ * - `shared` — one window for the whole rule/scope: a cat silences the next
19421
+ * dog for `cooldownSec`. Only written when an operator picks it; it is no
19422
+ * longer what an unset rule means.
19017
19423
  *
19018
19424
  * AUDIO subjects are ALWAYS per-class regardless of this setting: a scream
19019
19425
  * must not be swallowed by a bark's window (the precedent this generalizes —
@@ -19028,8 +19434,11 @@ var NcThrottleSchema = object({
19028
19434
  /**
19029
19435
  * Class granularity of the cooldown key. Optional rather than defaulted:
19030
19436
  * a Zod default does NOT run on the addon→addon cap path, so a persisted
19031
- * rule authored before this field simply carries none — and the engine
19032
- * reads absent as `shared`, the pre-existing behaviour.
19437
+ * rule authored before this field simply carries none. The engine used to
19438
+ * read absent as `shared` (D36); since 2026-10-01 it reads absent as
19439
+ * `per-class` — the operator's default — and only an explicit `shared`
19440
+ * still means `shared`. See `cooldownKey` / `keysPerClass` in the rule
19441
+ * engine, and D36's dated note.
19033
19442
  */
19034
19443
  granularity: NcThrottleGranularitySchema.optional()
19035
19444
  });
@@ -19353,11 +19762,23 @@ var NcStateSummaryPreviewSectionSchema = object({
19353
19762
  reason: string().optional()
19354
19763
  });
19355
19764
  /**
19765
+ * One notification a previewed summary would send (D698): the whole summary on
19766
+ * a `rule` split (no `section`), one section's on a `section` split.
19767
+ */
19768
+ var NcStateSummaryPreviewRowSchema = object({
19769
+ section: string().optional(),
19770
+ /** The section's name on a per-section row; every reported section's, joined, on a combined one. */
19771
+ title: string(),
19772
+ text: string(),
19773
+ count: number$1().int().nonnegative()
19774
+ });
19775
+ /**
19356
19776
  * The summary a rule would send now. `empty` = nothing to report and every
19357
19777
  * section read: such a summary is NOT sent. `dropped` counts the open states
19358
19778
  * the rule's own filters (or a camera mute) left out, by reason.
19359
19779
  * `excludedGroups` names the kind groups selected that have no state to report
19360
- * (backups & exports).
19780
+ * (backups & exports). `split` and `rows` (D698) say how it would be sent —
19781
+ * optional, so an older hub's answer still parses.
19361
19782
  */
19362
19783
  var NcStateSummaryPreviewSchema = object({
19363
19784
  empty: boolean(),
@@ -19365,7 +19786,9 @@ var NcStateSummaryPreviewSchema = object({
19365
19786
  text: string(),
19366
19787
  sections: array(NcStateSummaryPreviewSectionSchema),
19367
19788
  dropped: record(string(), number$1().int().nonnegative()),
19368
- excludedGroups: array(string())
19789
+ excludedGroups: array(string()),
19790
+ split: NcStateSummarySplitSchema.optional(),
19791
+ rows: array(NcStateSummaryPreviewRowSchema).optional()
19369
19792
  });
19370
19793
  var NcTestResultSchema = object({
19371
19794
  recordId: string(),
@@ -20381,7 +20804,7 @@ function cameraSensorRefKey(ref) {
20381
20804
  }
20382
20805
  /** CS-1 accepts exactly one mode; CS-2 (D673) widens it to confirm / replace. */
20383
20806
  var CameraSensorsModeSchema = _enum(["in-addition"]);
20384
- object({
20807
+ var CameraSensorsConfigSchema = object({
20385
20808
  mode: CameraSensorsModeSchema,
20386
20809
  sensors: array(CameraSensorRefSchema).min(1).max(8)
20387
20810
  }).superRefine((value, ctx) => {
@@ -21371,6 +21794,21 @@ var ObjectEventSchema = object({
21371
21794
  keyFrameMediaId: number$1().int().optional(),
21372
21795
  /** Populated by B5 (recording playback URL for this event). */
21373
21796
  mediaUrl: string().optional(),
21797
+ /**
21798
+ * When the change this row records HAPPENED, epoch ms, when that is earlier
21799
+ * than {@link timestamp} and the producer could date it (D684).
21800
+ *
21801
+ * Set on a package PICK-UP row only: its `timestamp` is when the departure
21802
+ * was CONCLUDED — five minutes of unseen observed time after the parcel went
21803
+ * — and a notification's footage has to be cut around the pick-up, not the
21804
+ * empty doormat after it (D682). Stored so every path that rebuilds a
21805
+ * notification subject from the row (the boot reconcile, a dry-run) anchors
21806
+ * on the same instant the live hook did.
21807
+ *
21808
+ * `timestamp` keeps its meaning. Absent on every other row and on every
21809
+ * pick-up written before D684 — UNKNOWN, never 0 and never `timestamp`.
21810
+ */
21811
+ observedAt: number$1().optional(),
21374
21812
  /** The parent track's key-event importance [0,1], propagated to every object
21375
21813
  * event of the track (so an event row can be sorted by importance without a
21376
21814
  * track join). Absent on legacy rows / before the track was scored. */
@@ -21706,131 +22144,6 @@ var RecentTracksQueryInput = object({
21706
22144
  /** See {@link ExcludeSourcesDoc}. */
21707
22145
  excludeSources: array(TrackSourceSchema).optional()
21708
22146
  });
21709
- /**
21710
- * A Summary (D359): the per-camera session envelope that references tracks.
21711
- * `groupShotMediaId` is the media ROW id of its group shot (`ownerKind:
21712
- * 'summary'`, served by the event-media plane at `/m/<id>`), null until the
21713
- * first frame with a member visible has been materialised (D482 — it was the
21714
- * row's composite key, which embedded the owner and could name another table's
21715
- * row once event ids became per-table rowids).
21716
- */
21717
- var SummarySchema = object({
21718
- id: string(),
21719
- deviceId: number$1(),
21720
- openedAt: number$1(),
21721
- lastActiveAt: number$1(),
21722
- sealedAt: number$1().nullable(),
21723
- memberCount: number$1().int().nonnegative(),
21724
- groupShotMediaId: number$1().int().nullable()
21725
- });
21726
- var SummariesQueryInput = object({
21727
- deviceIds: array(number$1()).min(1),
21728
- since: number$1().optional(),
21729
- until: number$1().optional(),
21730
- limit: number$1().int().min(1).max(200).default(50),
21731
- /** The same member-wise filter {@link listRecentSummaries} takes — one
21732
- * meaning of "dog" on every summary surface. */
21733
- classes: array(string().min(1).max(60)).max(40).optional()
21734
- });
21735
- var SummaryDetailSchema = object({
21736
- summary: SummarySchema,
21737
- /** Members in absorption order, oldest join first. */
21738
- members: array(object({
21739
- trackId: string(),
21740
- /**
21741
- * The track's class at the time it JOINED, or `null` when it was unresolved
21742
- * and the track no longer exists to fill it.
21743
- *
21744
- * The join, not the latest opinion: class voting can re-decide a track's
21745
- * class afterwards, and a group's composition is the history of who came
21746
- * together. A consumer counts these to badge a thumbnail — "two people and a
21747
- * dog" — rather than being handed a second, denormalised tally that would
21748
- * drift from the members it claims to describe.
21749
- */
21750
- className: string().nullable(),
21751
- /** `primary` is the one member that carries the group's identity. */
21752
- role: _enum([
21753
- "primary",
21754
- "sibling",
21755
- "child"
21756
- ]).nullable(),
21757
- joinedAt: number$1(),
21758
- /** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
21759
- * at read time. Absent when nothing resolved, never an empty string. */
21760
- label: string().optional(),
21761
- /** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
21762
- * recognised nobody, and absent for a member whose track has been pruned —
21763
- * a thumbnail that names the wrong person is worse than one naming nobody. */
21764
- subLabel: string().optional()
21765
- })).readonly()
21766
- });
21767
- /**
21768
- * What a LIST of groups carries: the envelope plus what it is MADE OF.
21769
- *
21770
- * Coarse on purpose — the operator's rule is "only the rough data on the list,
21771
- * we extend when we notice we need more". Enough to draw the card ("two people
21772
- * and a dog") and no more. The MEMBERS, their names and the per-member links
21773
- * are on {@link getSummary}: shipping every member of every group so a client
21774
- * can count them turns a page of two hundred groups into a thousand records to
21775
- * draw two hundred badges.
21776
- */
21777
- var SummaryListItemSchema = object({
21778
- summary: SummarySchema,
21779
- /** Class counts, most numerous first; `className: null` is a member whose
21780
- * class never resolved, counted so the counts add up to `memberCount`. */
21781
- classes: array(object({
21782
- className: string().nullable(),
21783
- count: number$1().int().positive()
21784
- })).readonly()
21785
- });
21786
- var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
21787
- /**
21788
- * The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
21789
- *
21790
- * The reel on the cameras page and the Events gallery both ride a cursor, so a
21791
- * summaries feed that could only answer "the last N for these cameras"
21792
- * (`listSummaries`) would make groups available in the timeline and nowhere
21793
- * else. Two feeds with different ordering contracts would be two ideas of what
21794
- * "newest" means, on one screen.
21795
- */
21796
- var RecentSummariesQueryInput = object({
21797
- /** Devices to merge. An empty array yields an empty page. */
21798
- deviceIds: array(number$1()),
21799
- /** Window lower bound on `lastActiveAt` (inclusive). */
21800
- since: number$1().optional(),
21801
- /** Window upper bound on `lastActiveAt` (inclusive). */
21802
- until: number$1().optional(),
21803
- limit: number$1().int().min(1).max(500).default(100),
21804
- /** Opaque continuation cursor from a previous page's `nextCursor`. */
21805
- cursor: string().optional(),
21806
- /**
21807
- * Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
21808
- * deliberately the same name: the events filter tree emits one list of ticked
21809
- * taxonomy nodes, and a summaries feed that called it something else would
21810
- * make the operator's one filter component produce two shapes.
21811
- *
21812
- * A question about the MEMBERS: a group matches when ANY of them does. "Show
21813
- * me the arrivals with a dog" has to return the group of four people who had
21814
- * one with them; a filter on the group's own fields could only ever answer
21815
- * about its primary.
21816
- *
21817
- * Matched against all THREE tiers of a member — the class (`animal`), the
21818
- * sub-class (`dog`) and the instance (a name, a plate) — because which tier a
21819
- * ticked node lives on is the taxonomy's business, not the caller's. `dog` is
21820
- * an event kind in the tree and a tier-1 label on an `animal` track; a filter
21821
- * that read only the class would answer "animal" and never "dog".
21822
- *
21823
- * ABSENT or EMPTY means no filter — absent is not a selection of none.
21824
- */
21825
- classes: array(string().min(1).max(60)).max(40).optional()
21826
- });
21827
- var RecentSummariesPageSchema = object({
21828
- /** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
21829
- * {@link listSummaries} — one list shape, so a card renders the same
21830
- * whichever feed drew it. */
21831
- summaries: array(SummaryListItemSchema).readonly(),
21832
- nextCursor: string().nullable()
21833
- });
21834
22147
  var RecentTracksPageSchema = object({
21835
22148
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
21836
22149
  tracks: array(TrackSchema).readonly(),
@@ -22342,7 +22655,7 @@ DeviceType.Camera, method(object({ deviceId: number$1() }), array(TrackSchema).r
22342
22655
  classes: array(string()).optional(),
22343
22656
  /** See {@link ExcludeSourcesDoc}. */
22344
22657
  excludeSources: array(TrackSourceSchema).optional()
22345
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(RecentSummariesQueryInput, RecentSummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number$1() }), _void(), {
22658
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number$1() }), _void(), {
22346
22659
  kind: "mutation",
22347
22660
  auth: "admin"
22348
22661
  }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number$1() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number$1()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -22396,7 +22709,8 @@ DeviceType.Camera, method(object({ deviceId: number$1() }), array(TrackSchema).r
22396
22709
  trackIds: array(string()).min(1)
22397
22710
  }), object({
22398
22711
  deleted: number$1().int(),
22399
- failed: array(string()).readonly()
22712
+ failed: array(string()).readonly(),
22713
+ sparedMediaIds: array(number$1().int()).readonly().optional()
22400
22714
  }), {
22401
22715
  kind: "mutation",
22402
22716
  auth: "admin"
@@ -22405,7 +22719,7 @@ DeviceType.Camera, method(object({ deviceId: number$1() }), array(TrackSchema).r
22405
22719
  deviceId: number$1(),
22406
22720
  trackId: string(),
22407
22721
  flags: TrackFlagsPatchSchema
22408
- }), TrackFlagsSchema, { kind: "mutation" }), method(ArchivedDebugNoteQueryInputSchema, array(ArchivedDebugNoteSchema).readonly(), { kind: "query" }), method(BirthDecisionQueryInputSchema, array(BirthDecisionRecordSchema).readonly(), { kind: "query" }), method(object({}), EventStoreFootprintSchema, {
22722
+ }), 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, {
22409
22723
  kind: "query",
22410
22724
  auth: "admin"
22411
22725
  }), method(object({ deviceId: number$1().int().optional() }), EventMediaKindBreakdownSchema, {
@@ -24563,7 +24877,64 @@ var NodeInferenceDevicesSchema = object({
24563
24877
  reachable: boolean(),
24564
24878
  devices: array(NodeInferenceDeviceSchema).readonly()
24565
24879
  });
24566
- method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
24880
+ /**
24881
+ * Pipeline Orchestrator capability — global load balancer + camera dispatcher.
24882
+ *
24883
+ * Lives on the hub. Tracks the camera-to-agent assignment map, listens to
24884
+ * device lifecycle events, queries each runner's capacity + hardware
24885
+ * profile, and dispatches `attachCamera` / `detachCamera` cap calls to the
24886
+ * appropriate runner instances. Persists assignments via the multi-level
24887
+ * settings store so they survive hub restarts.
24888
+ *
24889
+ * Strictly the control plane: never sees a frame, never calls inference,
24890
+ * never drains queues. The runner does that work locally on each agent.
24891
+ */
24892
+ /**
24893
+ * The input of `setCameraSensors` (G5, D676): the ONE typed write path of a
24894
+ * camera's attached sensors (D672). `config: null` removes the attachment —
24895
+ * the camera reads `not-configured` again, never `unreadable`.
24896
+ */
24897
+ var SetCameraSensorsInputSchema = object({
24898
+ deviceId: number$1().int().nonnegative(),
24899
+ /** `null` removes the attachment: the camera goes back to `not-configured`. */
24900
+ config: CameraSensorsConfigSchema.nullable()
24901
+ });
24902
+ /**
24903
+ * Why an early occupancy look (D691) was not scheduled.
24904
+ *
24905
+ * - `unknown-camera` — no session was ever dispatched for it, so there is no
24906
+ * node and no config to attach a burst with.
24907
+ * - `out-of-range` — the ask is negative or further out than the orchestrator
24908
+ * will hold a timer for; the parked-object cadence is the answer there.
24909
+ * - `no-burst-producer` — this build has no burst producer at all.
24910
+ * - `already-looked` — this camera's ONE early look since its last session has
24911
+ * been spent. A look's own burst can re-arm a flickering flip, and a look
24912
+ * per arm would chain a burst every ~30 s forever (review H2); the next
24913
+ * real session re-arms the budget.
24914
+ */
24915
+ var OccupancyLookRefusalSchema = _enum([
24916
+ "unknown-camera",
24917
+ "out-of-range",
24918
+ "no-burst-producer",
24919
+ "already-looked"
24920
+ ]);
24921
+ method(object({
24922
+ deviceId: number$1().int().nonnegative(),
24923
+ /** How long from NOW until the pending flip's sustain window ends. RELATIVE,
24924
+ * so the caller's clock and the orchestrator's never have to agree. */
24925
+ afterMs: number$1().finite(),
24926
+ /** Why, for the log. */
24927
+ reason: string()
24928
+ }), object({
24929
+ scheduled: boolean(),
24930
+ /** When `scheduled`: how long until the burst is dialled. */
24931
+ dueInMs: number$1().optional(),
24932
+ /** When not `scheduled`: why. */
24933
+ refusedBecause: OccupancyLookRefusalSchema.optional()
24934
+ }), {
24935
+ kind: "mutation",
24936
+ auth: "admin"
24937
+ }), method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
24567
24938
  kind: "mutation",
24568
24939
  auth: "admin"
24569
24940
  }), method(StorageMigrationLeaseInputSchema, object({ resumed: literal(true) }), {
@@ -24717,7 +25088,10 @@ method(StorageMigrationLeaseInputSchema, object({ paused: literal(true) }), {
24717
25088
  }), CameraSwitchGroupSchema, {
24718
25089
  kind: "mutation",
24719
25090
  auth: "admin"
24720
- }), method(object({ deviceId: number$1() }), CameraStatusSchema), method(object({ deviceIds: array(number$1()).optional() }), array(CameraStatusSchema).readonly()), method(_void(), DiskReconcileJobSchema, {
25091
+ }), method(object({ deviceId: number$1() }), CameraStatusSchema), method(object({ deviceIds: array(number$1()).optional() }), array(CameraStatusSchema).readonly()), method(SetCameraSensorsInputSchema, object({ success: literal(true) }), {
25092
+ kind: "mutation",
25093
+ auth: "admin"
25094
+ }), method(_void(), DiskReconcileJobSchema, {
24721
25095
  kind: "mutation",
24722
25096
  auth: "admin"
24723
25097
  }), method(_void(), DiskReconcileJobSchema, { auth: "admin" }), method(_void(), array(PipelineTemplateSchema).readonly()), method(object({
@@ -26893,138 +27267,6 @@ DeviceType.Camera, method(object({
26893
27267
  kind: "query",
26894
27268
  auth: "protected"
26895
27269
  });
26896
- object({
26897
- /** Ms epoch of the last press. null = never observed since this provider started. */
26898
- lastPressedAt: number$1().nullable(),
26899
- /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
26900
- pressCountSinceStart: number$1()
26901
- });
26902
- object({
26903
- deviceId: number$1(),
26904
- timestamp: number$1()
26905
- });
26906
- /**
26907
- * The `doorbell-source` extension slot's editable value (D648): the camera's
26908
- * virtual-doorbell trigger devices, exactly what the wrapper's
26909
- * `doorbellSources` persists (as `{ deviceId }` records).
26910
- */
26911
- var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number$1().int().positive()) });
26912
- DeviceType.Camera;
26913
- DeviceType.Button, DeviceType.Camera;
26914
- var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
26915
- DeviceType.Camera, DeviceType.Camera;
26916
- /** A slot's editable value, discriminated on `slot`. */
26917
- var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
26918
- DeviceType.Camera;
26919
- var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
26920
- state: literal("unreachable"),
26921
- reason: string()
26922
- })]);
26923
- /** One provider of slots — the D554 source-listing row. */
26924
- var ExtensionSourceSchema = object({
26925
- /** The routing prefix of every `slotRef` this provider serves. */
26926
- source: string(),
26927
- label: string(),
26928
- /** Stamped by the dispatcher from the registry (D557). */
26929
- addonId: string().optional(),
26930
- availability: ExtensionSourceAvailabilitySchema
26931
- });
26932
- /**
26933
- * How one picked source stands. `missing` — no such device (deleted, or an id
26934
- * that never existed); `foreign` — a device the slot's owner cannot read from
26935
- * (a source owned by another addon); `unavailable` — it exists but is not a
26936
- * valid source now (a container, which is never a pick). A source in any of
26937
- * these states is SHOWN, never silently dropped or re-pointed.
26938
- */
26939
- var ExtensionSourceHealthSchema = _enum([
26940
- "ok",
26941
- "missing",
26942
- "foreign",
26943
- "unavailable"
26944
- ]);
26945
- var ExtensionSlotSourceSchema = object({
26946
- deviceId: number$1().int(),
26947
- /** The device's name, or null when it could not be resolved (`missing`). */
26948
- name: string().nullable(),
26949
- health: ExtensionSourceHealthSchema,
26950
- detail: string().optional()
26951
- });
26952
- /**
26953
- * A DIFFERENT authority that gates whether the slot's sources do anything —
26954
- * reported read-only, named, never written through this contract (D62). The
26955
- * virtual doorbell's sources ring only while the wrapper is bound to the
26956
- * camera, and that binding belongs to `deviceManager.setWrapperActive`.
26957
- * `unknown` means the gate could not be read; it is not "inactive" (D315).
26958
- */
26959
- var ExtensionSlotActivationSchema = object({
26960
- state: _enum([
26961
- "active",
26962
- "inactive",
26963
- "unknown"
26964
- ]),
26965
- authority: string(),
26966
- detail: string().optional()
26967
- });
26968
- var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
26969
- state: literal("ok"),
26970
- /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
26971
- slotRef: string(),
26972
- slot: ExtensionSlotIdSchema,
26973
- /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
26974
- authority: string(),
26975
- activation: ExtensionSlotActivationSchema.nullable(),
26976
- value: ExtensionSlotValueSchema,
26977
- sources: array(ExtensionSlotSourceSchema),
26978
- /**
26979
- * Devices the owner links to the host ON ITS OWN, by structure, and that
26980
- * are therefore not in `value` (D655): a camera's device-tree children, and
26981
- * the child a picked container stands for (D356 — a container is never a
26982
- * pick, its children are). Read-only; the editor shows them and may offer
26983
- * per-device options on them (the linked-devices tracked-event opt-in).
26984
- * Absent when the owner links nothing beyond the picks, and from an owner
26985
- * older than D655.
26986
- */
26987
- impliedSources: array(ExtensionSlotSourceSchema).optional()
26988
- }), object({
26989
- state: literal("unreachable"),
26990
- addonId: string(),
26991
- reason: string()
26992
- })]);
26993
- var ExtensionCandidatesSchema = object({ candidates: array(object({
26994
- deviceId: number$1().int(),
26995
- name: string(),
26996
- type: string(),
26997
- location: string().nullable(),
26998
- /** The container a child belongs to — "Spotlight 2" alone does not say which. */
26999
- parentName: string().nullable(),
27000
- /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
27001
- suggested: boolean(),
27002
- /** Why it is suggested ("same location"), null when it is not. */
27003
- reason: string().nullable()
27004
- })) });
27005
- /**
27006
- * What a write did. `none` — applied in place. `host` / `parent` — the owner
27007
- * reloaded the host (or, for an accessory child, its parent) because the
27008
- * write changed what the host REGISTERS. A slot never adds a capability to its
27009
- * host — that is a composition (D663) — so today's owners answer `none`.
27010
- */
27011
- var ExtensionSetResultSchema = object({
27012
- applied: literal(true),
27013
- reload: _enum([
27014
- "none",
27015
- "host",
27016
- "parent"
27017
- ])
27018
- });
27019
- var ExtensionSlotRefInputSchema = object({
27020
- deviceId: number$1().int(),
27021
- slotRef: string().min(1)
27022
- });
27023
- var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
27024
- method(object({ deviceId: number$1().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number$1().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
27025
- kind: "mutation",
27026
- auth: "admin"
27027
- });
27028
27270
  /**
27029
27271
  * Optional client-side hints sent at session creation to help the provider
27030
27272
  * pick the best native source. All fields optional — a viewer that knows
@@ -35618,47 +35860,6 @@ DeviceType.Camera, method(object({
35618
35860
  detection: array(ZoneRuleSchema).readonly(),
35619
35861
  package: array(ZoneRuleSchema).readonly()
35620
35862
  });
35621
- var NUMBER = {
35622
- kind: "fixed",
35623
- result: ["number"]
35624
- };
35625
- var BOOLEAN = {
35626
- kind: "fixed",
35627
- result: ["boolean"]
35628
- };
35629
- Object.freeze({
35630
- min: NUMBER,
35631
- max: NUMBER,
35632
- abs: NUMBER,
35633
- floor: NUMBER,
35634
- ceil: NUMBER,
35635
- sqrt: NUMBER,
35636
- round: NUMBER,
35637
- pow: NUMBER,
35638
- clamp: NUMBER,
35639
- avg: NUMBER,
35640
- sum: NUMBER,
35641
- age: NUMBER,
35642
- convert: NUMBER,
35643
- coalesce: { kind: "coalesce" },
35644
- any: BOOLEAN,
35645
- all: BOOLEAN,
35646
- within: BOOLEAN,
35647
- latest: {
35648
- kind: "fixed",
35649
- result: ["number", "null"]
35650
- },
35651
- number: {
35652
- kind: "fixed",
35653
- result: ["number", "null"]
35654
- },
35655
- rose: {
35656
- kind: "fixed",
35657
- result: ["number", "null"]
35658
- },
35659
- count: NUMBER
35660
- });
35661
- `${COMPOSED_DEVICE_STABLE_ID_PREFIX}`;
35662
35863
  /**
35663
35864
  * Accessory device helpers — shared across drivers.
35664
35865
  *
@@ -38081,6 +38282,12 @@ Object.freeze({
38081
38282
  addonId: null,
38082
38283
  access: "view"
38083
38284
  },
38285
+ "coreBlocks.listComposableCaps": {
38286
+ capName: "core-blocks",
38287
+ capScope: "system",
38288
+ addonId: null,
38289
+ access: "view"
38290
+ },
38084
38291
  "coreBlocks.listCompositions": {
38085
38292
  capName: "core-blocks",
38086
38293
  capScope: "system",
@@ -38159,6 +38366,18 @@ Object.freeze({
38159
38366
  addonId: null,
38160
38367
  access: "view"
38161
38368
  },
38369
+ "databaseSnapshot.listDatabases": {
38370
+ capName: "database-snapshot",
38371
+ capScope: "system",
38372
+ addonId: null,
38373
+ access: "view"
38374
+ },
38375
+ "databaseSnapshot.writeSnapshot": {
38376
+ capName: "database-snapshot",
38377
+ capScope: "system",
38378
+ addonId: null,
38379
+ access: "create"
38380
+ },
38162
38381
  "dataStoreProvider.aggregate": {
38163
38382
  capName: "data-store-provider",
38164
38383
  capScope: "system",
@@ -40895,6 +41114,12 @@ Object.freeze({
40895
41114
  addonId: null,
40896
41115
  access: "create"
40897
41116
  },
41117
+ "pipelineAnalytics.clearTrackRelation": {
41118
+ capName: "pipeline-analytics",
41119
+ capScope: "device",
41120
+ addonId: null,
41121
+ access: "delete"
41122
+ },
40898
41123
  "pipelineAnalytics.clearTracks": {
40899
41124
  capName: "pipeline-analytics",
40900
41125
  capScope: "device",
@@ -41051,12 +41276,6 @@ Object.freeze({
41051
41276
  addonId: null,
41052
41277
  access: "view"
41053
41278
  },
41054
- "pipelineAnalytics.getSummary": {
41055
- capName: "pipeline-analytics",
41056
- capScope: "device",
41057
- addonId: null,
41058
- access: "view"
41059
- },
41060
41279
  "pipelineAnalytics.getTrack": {
41061
41280
  capName: "pipeline-analytics",
41062
41281
  capScope: "device",
@@ -41117,12 +41336,6 @@ Object.freeze({
41117
41336
  addonId: null,
41118
41337
  access: "view"
41119
41338
  },
41120
- "pipelineAnalytics.listRecentSummaries": {
41121
- capName: "pipeline-analytics",
41122
- capScope: "device",
41123
- addonId: null,
41124
- access: "view"
41125
- },
41126
41339
  "pipelineAnalytics.listRecentTracks": {
41127
41340
  capName: "pipeline-analytics",
41128
41341
  capScope: "device",
@@ -41153,13 +41366,13 @@ Object.freeze({
41153
41366
  addonId: null,
41154
41367
  access: "view"
41155
41368
  },
41156
- "pipelineAnalytics.listSummaries": {
41369
+ "pipelineAnalytics.listTrackMedia": {
41157
41370
  capName: "pipeline-analytics",
41158
41371
  capScope: "device",
41159
41372
  addonId: null,
41160
41373
  access: "view"
41161
41374
  },
41162
- "pipelineAnalytics.listTrackMedia": {
41375
+ "pipelineAnalytics.listTrackRelations": {
41163
41376
  capName: "pipeline-analytics",
41164
41377
  capScope: "device",
41165
41378
  addonId: null,
@@ -41279,6 +41492,18 @@ Object.freeze({
41279
41492
  addonId: null,
41280
41493
  access: "create"
41281
41494
  },
41495
+ "pipelineAnalytics.setTrackPurity": {
41496
+ capName: "pipeline-analytics",
41497
+ capScope: "device",
41498
+ addonId: null,
41499
+ access: "create"
41500
+ },
41501
+ "pipelineAnalytics.setTrackRelation": {
41502
+ capName: "pipeline-analytics",
41503
+ capScope: "device",
41504
+ addonId: null,
41505
+ access: "create"
41506
+ },
41282
41507
  "pipelineAnalytics.startStorageMigrationMove": {
41283
41508
  capName: "pipeline-analytics",
41284
41509
  capScope: "device",
@@ -41717,6 +41942,12 @@ Object.freeze({
41717
41942
  addonId: null,
41718
41943
  access: "delete"
41719
41944
  },
41945
+ "pipelineOrchestrator.requestOccupancyLook": {
41946
+ capName: "pipeline-orchestrator",
41947
+ capScope: "system",
41948
+ addonId: null,
41949
+ access: "create"
41950
+ },
41720
41951
  "pipelineOrchestrator.resetNodePipelineDefaults": {
41721
41952
  capName: "pipeline-orchestrator",
41722
41953
  capScope: "system",
@@ -41783,6 +42014,12 @@ Object.freeze({
41783
42014
  addonId: null,
41784
42015
  access: "create"
41785
42016
  },
42017
+ "pipelineOrchestrator.setCameraSensors": {
42018
+ capName: "pipeline-orchestrator",
42019
+ capScope: "system",
42020
+ addonId: null,
42021
+ access: "create"
42022
+ },
41786
42023
  "pipelineOrchestrator.setCameraStepOverride": {
41787
42024
  capName: "pipeline-orchestrator",
41788
42025
  capScope: "system",
@@ -45193,6 +45430,11 @@ Object.freeze({
45193
45430
  form: "single",
45194
45431
  optional: false
45195
45432
  }],
45433
+ "pipelineAnalytics.clearTrackRelation": [{
45434
+ name: "deviceId",
45435
+ form: "single",
45436
+ optional: false
45437
+ }],
45196
45438
  "pipelineAnalytics.clearTracks": [{
45197
45439
  name: "deviceId",
45198
45440
  form: "single",
@@ -45328,11 +45570,6 @@ Object.freeze({
45328
45570
  form: "single",
45329
45571
  optional: true
45330
45572
  }],
45331
- "pipelineAnalytics.listRecentSummaries": [{
45332
- name: "deviceIds",
45333
- form: "array",
45334
- optional: false
45335
- }],
45336
45573
  "pipelineAnalytics.listRecentTracks": [{
45337
45574
  name: "deviceIds",
45338
45575
  form: "array",
@@ -45343,12 +45580,12 @@ Object.freeze({
45343
45580
  form: "array",
45344
45581
  optional: true
45345
45582
  }],
45346
- "pipelineAnalytics.listSummaries": [{
45347
- name: "deviceIds",
45348
- form: "array",
45583
+ "pipelineAnalytics.listTrackMedia": [{
45584
+ name: "deviceId",
45585
+ form: "single",
45349
45586
  optional: false
45350
45587
  }],
45351
- "pipelineAnalytics.listTrackMedia": [{
45588
+ "pipelineAnalytics.listTrackRelations": [{
45352
45589
  name: "deviceId",
45353
45590
  form: "single",
45354
45591
  optional: false
@@ -45423,6 +45660,16 @@ Object.freeze({
45423
45660
  form: "single",
45424
45661
  optional: false
45425
45662
  }],
45663
+ "pipelineAnalytics.setTrackPurity": [{
45664
+ name: "deviceId",
45665
+ form: "single",
45666
+ optional: false
45667
+ }],
45668
+ "pipelineAnalytics.setTrackRelation": [{
45669
+ name: "deviceId",
45670
+ form: "single",
45671
+ optional: false
45672
+ }],
45426
45673
  "pipelineAnalytics.wipeAllAnalytics": [{
45427
45674
  name: "deviceId",
45428
45675
  form: "single",
@@ -45493,6 +45740,11 @@ Object.freeze({
45493
45740
  form: "single",
45494
45741
  optional: false
45495
45742
  }],
45743
+ "pipelineOrchestrator.requestOccupancyLook": [{
45744
+ name: "deviceId",
45745
+ form: "single",
45746
+ optional: false
45747
+ }],
45496
45748
  "pipelineOrchestrator.resolvePipeline": [{
45497
45749
  name: "deviceId",
45498
45750
  form: "single",
@@ -45503,6 +45755,11 @@ Object.freeze({
45503
45755
  form: "single",
45504
45756
  optional: false
45505
45757
  }],
45758
+ "pipelineOrchestrator.setCameraSensors": [{
45759
+ name: "deviceId",
45760
+ form: "single",
45761
+ optional: false
45762
+ }],
45506
45763
  "pipelineOrchestrator.setCameraStepOverride": [{
45507
45764
  name: "deviceId",
45508
45765
  form: "single",
@@ -46649,6 +46906,18 @@ var STATE_SUMMARY_VARS = [
46649
46906
  systemEventKinds: [...SUMMARISABLE],
46650
46907
  systemEventDeliveries: ["summary"]
46651
46908
  },
46909
+ {
46910
+ name: "summarySection",
46911
+ label: "Summary: this section",
46912
+ description: "The section a per-section summary row is about (D698); on a summary sent as one message, every section it reports, comma-separated.",
46913
+ example: "Batterie scariche",
46914
+ group: "system",
46915
+ families: ["rule"],
46916
+ fields: [...RULE_TEXT],
46917
+ kinds: ["system"],
46918
+ systemEventKinds: [...SUMMARISABLE],
46919
+ systemEventDeliveries: ["summary"]
46920
+ },
46652
46921
  ...STATE_SUMMARY_SECTION_VARS.map((v) => ({
46653
46922
  name: v.name,
46654
46923
  label: v.label,
@@ -46725,6 +46994,37 @@ var STATE_SUMMARY_VARS = [
46725
46994
  [...RULE_TEXT],
46726
46995
  ...STATE_SUMMARY_VARS
46727
46996
  ];
46997
+ new Set([
46998
+ "disarmed",
46999
+ "armed_home",
47000
+ "armed_away",
47001
+ "armed_night",
47002
+ "armed_vacation",
47003
+ "armed_custom_bypass",
47004
+ "arming",
47005
+ "disarming",
47006
+ "pending",
47007
+ "triggered",
47008
+ "open",
47009
+ "opening",
47010
+ "closing",
47011
+ "closed",
47012
+ "stopped",
47013
+ "locked",
47014
+ "unlocked",
47015
+ "locking",
47016
+ "unlocking",
47017
+ "jammed",
47018
+ "on",
47019
+ "off",
47020
+ "home",
47021
+ "not_home",
47022
+ "matched",
47023
+ "diverged",
47024
+ "unknown",
47025
+ "latched",
47026
+ "live"
47027
+ ]);
46728
47028
  /**
46729
47029
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
46730
47030
  *