@camstack/addon-provider-velux 0.2.48 → 0.2.50

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 +478 -73
  2. package/dist/addon.mjs +478 -73
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -8018,6 +8018,20 @@ var RelocateJobSchema = object({
8018
8018
  * in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
8019
8019
  */
8020
8020
  rowsReconciled: number().int().nonnegative().optional(),
8021
+ /**
8022
+ * Rows this run FORGOT because the file they name is not on disk.
8023
+ *
8024
+ * The mover derived the path from the row's own fields and `stat`ed it; an
8025
+ * ENOENT there is a per-path confirmation that the segment is gone (D296),
8026
+ * and the durable row is dropped through the same channel eviction uses. It
8027
+ * is reported for the same reason `rowsReconciled` is: this is a durable
8028
+ * mutation nobody asked for, and a migration that quietly erases hour rows is
8029
+ * the same failure as one that quietly skips them (D295).
8030
+ *
8031
+ * The production drain of 2026-08-30 would have reported 11 074 here — the
8032
+ * ledger claimed 5.65 GB of footage that no longer existed.
8033
+ */
8034
+ rowsForgotten: number().int().nonnegative().optional(),
8021
8035
  startedAt: number(),
8022
8036
  finishedAt: number().nullable(),
8023
8037
  error: string().nullable()
@@ -8082,6 +8096,13 @@ var MediaRelocateModeSchema = _enum([
8082
8096
  ]);
8083
8097
  var RelocateMediaInputSchema = object({
8084
8098
  toLocationId: string(),
8099
+ /**
8100
+ * Restrict the pass to rows currently on this location. Omitted / `'*'` =
8101
+ * every row that is not already on `toLocationId` (the historical
8102
+ * behaviour). A named source is what a from→to migration needs: without it
8103
+ * "move events off disk 2" also emptied disk 1.
8104
+ */
8105
+ fromLocationId: string().optional(),
8085
8106
  throttleMbps: number().min(1).max(1e3).optional(),
8086
8107
  /** Omitted = `move`, the pre-existing behaviour. */
8087
8108
  mode: MediaRelocateModeSchema.optional()
@@ -8149,6 +8170,19 @@ var StorageMigrationDestinationsSchema = object({
8149
8170
  galleryMedia: string().min(1).optional()
8150
8171
  }).refine((value) => Object.keys(value).length > 0, { message: "select at least one storage class" });
8151
8172
  /**
8173
+ * Optional named source per class. Omitted = the class's current default
8174
+ * (the historical behaviour). A named source that is NOT the default is a
8175
+ * drain of that disk: bytes move, the default stays, and the source is
8176
+ * disabled when the move finishes.
8177
+ */
8178
+ var StorageMigrationSourcesSchema = object({
8179
+ recordings: string().min(1).optional(),
8180
+ recordingsLow: string().min(1).optional(),
8181
+ eventMedia: string().min(1).optional(),
8182
+ backups: string().min(1).optional(),
8183
+ galleryMedia: string().min(1).optional()
8184
+ }).optional();
8185
+ /**
8152
8186
  * How a migration sequences the cutover against the byte move.
8153
8187
  *
8154
8188
  * - `blocking` — the historical order: pause, move every byte, repoint,
@@ -8170,6 +8204,8 @@ var StorageMigrationModeSchema = _enum(["blocking", "nonBlocking"]);
8170
8204
  /** Shared input for planning and starting an orchestrated storage migration. */
8171
8205
  var StorageMigrationInputSchema = object({
8172
8206
  destinations: StorageMigrationDestinationsSchema,
8207
+ /** Omitted = each class's current default. */
8208
+ sources: StorageMigrationSourcesSchema,
8173
8209
  throttleMbps: number().min(1).max(1e3).optional(),
8174
8210
  /** Omitted = `blocking`, which stays the default. */
8175
8211
  mode: StorageMigrationModeSchema.optional()
@@ -8249,6 +8285,13 @@ var StorageMigrationMoveSchema = object({
8249
8285
  storageClass: StorageMigrationClassSchema,
8250
8286
  fromLocationId: string(),
8251
8287
  toLocationId: string(),
8288
+ /**
8289
+ * True when `from` was NOT the class default at plan time. The move still
8290
+ * copies bytes, but the default is left alone and the source is disabled
8291
+ * once the copy verifies. Absent on jobs planned before this field existed
8292
+ * — those jobs always repointed, which is `false`.
8293
+ */
8294
+ freezeSource: boolean().optional(),
8252
8295
  moverJobId: string().nullable(),
8253
8296
  state: RelocateJobStateSchema.nullable(),
8254
8297
  error: string().nullable(),
@@ -8262,6 +8305,7 @@ var StorageMigrationJobSchema = object({
8262
8305
  * can tell a seconds-long cutover from a thirty-hour one. */
8263
8306
  mode: StorageMigrationModeSchema,
8264
8307
  destinations: StorageMigrationDestinationsSchema,
8308
+ sources: StorageMigrationSourcesSchema,
8265
8309
  throttleMbps: number(),
8266
8310
  moves: array(StorageMigrationMoveSchema),
8267
8311
  pauseLeaseId: string().nullable(),
@@ -8287,6 +8331,7 @@ var StorageMigrationFindingSchema = object({
8287
8331
  });
8288
8332
  var StorageMigrationPlanSchema = object({
8289
8333
  destinations: StorageMigrationDestinationsSchema,
8334
+ sources: StorageMigrationSourcesSchema,
8290
8335
  /** The mode this plan was built for. A plan is only valid for its mode: the
8291
8336
  * `eventMedia` seal gate and the single-cardinality refusal both depend on
8292
8337
  * it. */
@@ -8294,7 +8339,8 @@ var StorageMigrationPlanSchema = object({
8294
8339
  moves: array(object({
8295
8340
  storageClass: StorageMigrationClassSchema,
8296
8341
  fromLocationId: string(),
8297
- toLocationId: string()
8342
+ toLocationId: string(),
8343
+ freezeSource: boolean().optional()
8298
8344
  })),
8299
8345
  findings: array(StorageMigrationFindingSchema)
8300
8346
  });
@@ -8381,16 +8427,142 @@ var RelocateResidueSchema = object({
8381
8427
  segments: number().int().nonnegative(),
8382
8428
  bytes: number().int().nonnegative()
8383
8429
  }).nullable();
8430
+ /**
8431
+ * Ask one location whether its durable hour rows describe the disk — the walk
8432
+ * (D319).
8433
+ *
8434
+ * `apply` DEFAULTS TO FALSE and that default is the product: the operator's
8435
+ * missing tool is the question, and the dry run is how they sanity-check the
8436
+ * destructive run before authorising it.
8437
+ */
8438
+ var LedgerWalkInputSchema = object({
8439
+ locationId: string().min(1),
8440
+ /** Forget the confirmed-absent rows, rather than only counting them. */
8441
+ apply: boolean().optional(),
8442
+ /** Narrow to one camera. */
8443
+ deviceId: number().int().positive().optional(),
8444
+ /** Narrow to these recording profiles; empty/absent = every profile. */
8445
+ profiles: array(string().min(1)).optional()
8446
+ });
8447
+ /** Why a whole walk did nothing. Every one leaves the ledger untouched. */
8448
+ var LedgerWalkRefusalSchema = _enum([
8449
+ "location-unknown",
8450
+ "source-writable",
8451
+ "no-ledger",
8452
+ "archive-unreadable",
8453
+ "anchor-absent",
8454
+ "anchor-unreadable",
8455
+ "anchor-moved"
8456
+ ]);
8457
+ _enum([
8458
+ "live-tail",
8459
+ "listing-error",
8460
+ "path-mismatch",
8461
+ "durable-refused"
8462
+ ]);
8463
+ /** Every skip reason, always present, always a number — so a reason that never
8464
+ * fired reports as zero rather than absent and the report shape is constant
8465
+ * between passes. Spelled out rather than `z.record` for exactly that. */
8466
+ var LedgerWalkSkipCountsSchema = object({
8467
+ "live-tail": number().int().nonnegative(),
8468
+ "listing-error": number().int().nonnegative(),
8469
+ "path-mismatch": number().int().nonnegative(),
8470
+ "durable-refused": number().int().nonnegative()
8471
+ });
8472
+ /** One camera's share of a walk, so a report names cameras and not rows. */
8473
+ var LedgerWalkDeviceReportSchema = object({
8474
+ deviceId: number().int(),
8475
+ hoursWalked: number().int().nonnegative(),
8476
+ hoursMissing: number().int().nonnegative(),
8477
+ ghostSegments: number().int().nonnegative(),
8478
+ ghostBytes: number().int().nonnegative(),
8479
+ forgottenSegments: number().int().nonnegative(),
8480
+ orphanFiles: number().int().nonnegative()
8481
+ });
8482
+ /**
8483
+ * What one walk claimed, listed, found and (only when armed) forgot.
8484
+ *
8485
+ * `archiveSegments` is the **M** and `segmentsClaimed` the **N** (D295), so a
8486
+ * walk that saw a fraction of the location is visible in its own report rather
8487
+ * than in the absence of one.
8488
+ */
8489
+ var LedgerWalkReportSchema = object({
8490
+ locationId: string(),
8491
+ applied: boolean(),
8492
+ refused: LedgerWalkRefusalSchema.nullable(),
8493
+ archiveSegments: number().int().nonnegative().nullable(),
8494
+ archiveBytes: number().int().nonnegative().nullable(),
8495
+ hoursClaimed: number().int().nonnegative(),
8496
+ hoursWalked: number().int().nonnegative(),
8497
+ hoursMissing: number().int().nonnegative(),
8498
+ /** `readdir` calls issued — the cost, stated in the unit that is paid. */
8499
+ listings: number().int().nonnegative(),
8500
+ segmentsClaimed: number().int().nonnegative(),
8501
+ ghostSegments: number().int().nonnegative(),
8502
+ ghostBytes: number().int().nonnegative(),
8503
+ ghostHoursWhole: number().int().nonnegative(),
8504
+ forgottenSegments: number().int().nonnegative(),
8505
+ forgottenBytes: number().int().nonnegative(),
8506
+ /** Files under a claimed hour that no durable row names. Never deleted. */
8507
+ orphanFiles: number().int().nonnegative(),
8508
+ orphanSample: array(string()).readonly(),
8509
+ hoursSkipped: number().int().nonnegative(),
8510
+ skippedByReason: LedgerWalkSkipCountsSchema,
8511
+ /** The walk stopped at its per-pass hour bound with claims unwalked. */
8512
+ bounded: boolean(),
8513
+ byDevice: array(LedgerWalkDeviceReportSchema).readonly()
8514
+ });
8384
8515
  /** How many rows a media pass would still act on against a given target — the
8385
8516
  * media lane's denominator AND its residue, from ONE derivation so the two can
8386
8517
  * never disagree. `null` = the count could not be taken. */
8387
8518
  var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
8388
8519
  var RelocatableMediaCountInputSchema = object({
8389
8520
  toLocationId: string().min(1),
8521
+ /** Restrict the count to one source; omitted / `'*'` = every non-target row. */
8522
+ fromLocationId: string().optional(),
8390
8523
  /** Omitted = `move`. */
8391
8524
  mode: MediaRelocateModeSchema.optional()
8392
8525
  });
8393
8526
  /**
8527
+ * Operator cleanup of leftover analytics rows, optional debug media, and
8528
+ * ghost ledger entries on frozen footage locations.
8529
+ *
8530
+ * A pass is tens of minutes on a standing backlog. The hub method RETURNS
8531
+ * `{ jobId }` immediately; progress is `cleanupStatus`. Awaiting the work
8532
+ * is how `addons.custom` hit the 60 s UDS deadline while reclaim continued
8533
+ * with no operator-visible status.
8534
+ */
8535
+ var StorageCleanupPhaseSchema = _enum([
8536
+ "orphans",
8537
+ "debug-media",
8538
+ "ghost-ledger",
8539
+ "done",
8540
+ "failed",
8541
+ "cancelled"
8542
+ ]);
8543
+ var StorageCleanupInputSchema = object({
8544
+ /** Also walk motion stills / track filmstrips. Off by default. */
8545
+ includeDebugMedia: boolean().optional() });
8546
+ var StorageCleanupJobSchema = object({
8547
+ jobId: string(),
8548
+ phase: StorageCleanupPhaseSchema,
8549
+ includeDebugMedia: boolean(),
8550
+ orphansReclaimed: number().int().nonnegative(),
8551
+ orphanBytesReclaimed: number().int().nonnegative(),
8552
+ debugMediaReclaimed: number().int().nonnegative(),
8553
+ debugMediaBytesReclaimed: number().int().nonnegative(),
8554
+ ghostsForgotten: number().int().nonnegative(),
8555
+ ghostBytesForgotten: number().int().nonnegative(),
8556
+ /** Short operator-facing line: current collection, pass, or location. */
8557
+ detail: string().nullable(),
8558
+ cancelRequested: boolean(),
8559
+ startedAt: number(),
8560
+ updatedAt: number(),
8561
+ finishedAt: number().nullable(),
8562
+ error: string().nullable()
8563
+ });
8564
+ var StorageCleanupStatusInputSchema = object({ jobId: string().optional() });
8565
+ /**
8394
8566
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8395
8567
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8396
8568
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8418,11 +8590,10 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
8418
8590
  * The default location for a type uses `id === <type>:default` by
8419
8591
  * convention (the bare type ref like `'backups'` resolves to it).
8420
8592
  *
8421
- * `isSystem: true` marks a location as orchestrator-seeded and
8422
- * undeletable. The bootstrap-installed defaults (one per type) carry
8423
- * this flag; operator-added locations don't. Editing the config of
8424
- * a system location is allowed (path migration, provider swap) but
8425
- * deleting it is rejected at the cap level.
8593
+ * `isSystem` is a legacy persisted flag. Seed still creates the initial
8594
+ * `<type>:default` locations; the flag is no longer a lock, a badge, or a
8595
+ * prune selector. New writes leave it false. Deletion is gated on uniqueness
8596
+ * / last-enabled, not on this bit.
8426
8597
  */
8427
8598
  var StorageLocationSchema = object({
8428
8599
  id: string().regex(/^[a-z][a-zA-Z0-9-]*:[a-zA-Z0-9-]+$/),
@@ -12948,6 +13119,12 @@ method(object({
12948
13119
  }), _void(), {
12949
13120
  kind: "mutation",
12950
13121
  auth: "admin"
13122
+ }), method(object({
13123
+ from: string(),
13124
+ to: string()
13125
+ }), object({ moved: number() }), {
13126
+ kind: "mutation",
13127
+ auth: "admin"
12951
13128
  }), method(object({
12952
13129
  deviceId: number(),
12953
13130
  disabled: boolean()
@@ -18956,53 +19133,15 @@ var RecentTracksPageSchema = object({
18956
19133
  /** Cursor for the next page, or null when this page is the last. */
18957
19134
  nextCursor: string().nullable()
18958
19135
  });
18959
- var LIST_GROUPS_DEFAULT_LIMIT = 40;
18960
- var LIST_GROUPS_MAX_LIMIT = 100;
18961
- var AnalyticsGroupRecordSchema = object({
18962
- id: string(),
18963
- deviceId: number().int(),
18964
- openedAt: number().int(),
18965
- closedAt: number().int(),
18966
- timestamp: number().int(),
18967
- memberCount: number().int(),
18968
- memberTrackIds: array(string()).readonly(),
18969
- className: string(),
18970
- classes: array(string()).readonly(),
18971
- /** Relative event-media path, or null when the group has no picture yet. */
18972
- mediaUrl: string().nullable(),
18973
- singleton: boolean()
18974
- });
18975
- var AnalyticsGroupMemberSchema = object({
18976
- trackId: string(),
18977
- deviceId: number().int(),
18978
- className: string(),
18979
- firstSeen: number().int(),
18980
- lastSeen: number().int(),
18981
- mediaUrl: string().nullable()
18982
- });
18983
- var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: array(AnalyticsGroupMemberSchema).readonly() });
18984
- var ListGroupsQueryInput = object({
18985
- /** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
18986
- deviceIds: array(number()),
18987
- /** Window lower bound on `closedAt` (inclusive). */
18988
- since: number().optional(),
18989
- /** Window upper bound on `openedAt` (inclusive). */
18990
- until: number().optional(),
18991
- limit: number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
18992
- /** Opaque continuation cursor from a previous page's `nextCursor`. */
18993
- cursor: string().optional()
18994
- });
18995
- var ListGroupsPageSchema = object({
18996
- groups: array(AnalyticsGroupRecordSchema).readonly(),
18997
- nextCursor: string().nullable()
18998
- });
19136
+ var KEY_EVENTS_DEFAULT_LIMIT = 50;
19137
+ var KEY_EVENTS_MAX_LIMIT = 200;
18999
19138
  var KeyEventQueryInput = object({
19000
19139
  deviceId: number(),
19001
19140
  /** Window lower bound (track firstSeen ≥ since). */
19002
19141
  since: number(),
19003
19142
  /** Window upper bound (track firstSeen ≤ until). */
19004
19143
  until: number(),
19005
- limit: number().int().min(1).max(200).default(50),
19144
+ limit: number().int().min(1).max(KEY_EVENTS_MAX_LIMIT).default(KEY_EVENTS_DEFAULT_LIMIT),
19006
19145
  /** Drop tracks scoring below this importance. */
19007
19146
  minImportance: number().min(0).max(1).optional(),
19008
19147
  /** Restrict to a single class (e.g. 'person'). */
@@ -19024,6 +19163,32 @@ var KeyEventSchema = object({
19024
19163
  ...TrackFlagFields,
19025
19164
  ...TrackRetrainFields
19026
19165
  });
19166
+ /** `getKeyEvents`' window and filters, asked of a SET of cameras at once. */
19167
+ var KeyEventBatchQueryInput = object({
19168
+ deviceIds: array(number()).min(1).max(200),
19169
+ since: number(),
19170
+ until: number(),
19171
+ /** Applied PER CAMERA, exactly as `getKeyEvents.limit` is — never a total
19172
+ * across the set, which would let a busy camera starve a quiet one of its
19173
+ * rows and change what the merged feed contains. */
19174
+ limit: number().int().min(1).max(KEY_EVENTS_MAX_LIMIT).default(KEY_EVENTS_DEFAULT_LIMIT),
19175
+ minImportance: number().min(0).max(1).optional(),
19176
+ classFilter: string().optional()
19177
+ });
19178
+ /**
19179
+ * One camera's key events in a batch answer.
19180
+ *
19181
+ * The row exists for every requested id. `getKeyEvents` degrades to `[]` on
19182
+ * error rather than throwing, so a camera whose store read failed and one with
19183
+ * no events in the window were ALREADY indistinguishable per camera — the
19184
+ * batch does not make that worse, and the row keeps the deviceId the single
19185
+ * method's output never carried (the caller used to stamp it from the fan-out
19186
+ * key, which only worked because there was one query per camera).
19187
+ */
19188
+ var KeyEventsForDeviceSchema = object({
19189
+ deviceId: number(),
19190
+ events: array(KeyEventSchema).readonly()
19191
+ });
19027
19192
  object({
19028
19193
  trackId: string(),
19029
19194
  className: string(),
@@ -19071,9 +19236,7 @@ var TrackCascadeCountsSchema = object({
19071
19236
  /** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
19072
19237
  plates: number().int(),
19073
19238
  /** Per-track CLIP search vectors removed (best-effort). */
19074
- embeddings: number().int(),
19075
- /** Group membership + group rows removed with their last member (best-effort). */
19076
- groups: number().int()
19239
+ embeddings: number().int()
19077
19240
  });
19078
19241
  /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
19079
19242
  var DiskReconcileCountsSchema = object({
@@ -19243,6 +19406,47 @@ var RebuildStatusSchema = object({
19243
19406
  /** Present when the pass ended by throwing. */
19244
19407
  error: string().nullable()
19245
19408
  });
19409
+ /**
19410
+ * Acknowledgement that a debug-media reclaim STARTED.
19411
+ *
19412
+ * The pass is paced at ~2 MB/s over a standing 100 GB — tens of minutes — so
19413
+ * it runs detached and this returns immediately. Awaiting it is how the
19414
+ * `addons.custom` door hit the 60 s UDS deadline while the walk carried on
19415
+ * with no status. Poll {@link pipelineAnalyticsCapability.methods.getMediaReclaimStatus}.
19416
+ */
19417
+ var MediaReclaimStartResultSchema = object({
19418
+ started: boolean(),
19419
+ /** True when a pass was already running; the new request is ignored. */
19420
+ alreadyRunning: boolean()
19421
+ });
19422
+ var MediaReclaimInputSchema = object({
19423
+ mode: _enum(["report", "reclaim"]).default("report"),
19424
+ scopes: array(_enum(["motion-still", "track-filmstrip"])).min(1).optional(),
19425
+ deviceIds: array(number().int()).min(1).optional(),
19426
+ restart: boolean().optional(),
19427
+ pageSize: number().int().min(50).max(5e3).optional(),
19428
+ maxRowsPerDevice: number().int().min(1).max(5e5).optional(),
19429
+ maxReclaimPerDevice: number().int().min(1).max(5e5).optional(),
19430
+ maxBytesPerRun: number().int().min(1).optional(),
19431
+ budgetMinutes: number().int().min(1).max(720).optional(),
19432
+ throttleBytesPerSec: number().int().min(64 * 1024).optional(),
19433
+ graceMinutes: number().int().min(1).max(10080).optional()
19434
+ });
19435
+ var MediaReclaimStatusSchema = object({
19436
+ running: boolean(),
19437
+ mode: _enum(["report", "reclaim"]).nullable(),
19438
+ totalExamined: number(),
19439
+ totalEligible: number(),
19440
+ totalReclaimed: number(),
19441
+ totalBytesReclaimed: number(),
19442
+ totalRefused: number(),
19443
+ /** Device+scope windows finished in this pass. */
19444
+ devicesDone: number(),
19445
+ complete: boolean().nullable(),
19446
+ startedAtMs: number().nullable(),
19447
+ finishedAtMs: number().nullable(),
19448
+ error: string().nullable()
19449
+ });
19246
19450
  var ReplayFrameInputSchema = object({
19247
19451
  timestamp: number(),
19248
19452
  frame: PipelineRunResultBridge
@@ -19281,10 +19485,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19281
19485
  * stationary registry). Default false: the timeline lists passages,
19282
19486
  * not parking records (operator decision, 2026-08-15). */
19283
19487
  includeStationary: boolean().optional()
19284
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(ListGroupsQueryInput, ListGroupsPageSchema), method(object({
19285
- deviceId: number(),
19286
- groupId: string().min(1)
19287
- }), AnalyticsGroupDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
19488
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
19288
19489
  kind: "mutation",
19289
19490
  auth: "admin"
19290
19491
  }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -19293,7 +19494,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19293
19494
  until: number().optional(),
19294
19495
  kinds: array(string()).optional(),
19295
19496
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
19296
- }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(object({
19497
+ }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
19297
19498
  deviceId: number(),
19298
19499
  since: number(),
19299
19500
  until: number(),
@@ -19384,6 +19585,12 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19384
19585
  }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
19385
19586
  kind: "query",
19386
19587
  auth: "admin"
19588
+ }), method(MediaReclaimInputSchema, MediaReclaimStartResultSchema, {
19589
+ kind: "mutation",
19590
+ auth: "admin"
19591
+ }), method(object({}), MediaReclaimStatusSchema, {
19592
+ kind: "query",
19593
+ auth: "admin"
19387
19594
  }), method(object({ deviceIds: array(number()).optional() }), TrainingExportSummarySchema, {
19388
19595
  kind: "query",
19389
19596
  auth: "admin"
@@ -21354,7 +21561,13 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
21354
21561
  }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
21355
21562
  kind: "mutation",
21356
21563
  auth: "admin"
21357
- });
21564
+ }), method(StorageCleanupInputSchema, object({ jobId: string() }), {
21565
+ kind: "mutation",
21566
+ auth: "admin"
21567
+ }), method(StorageCleanupStatusInputSchema, StorageCleanupJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
21568
+ kind: "mutation",
21569
+ auth: "admin"
21570
+ }), method(object({}), array(StorageMigrationJobSchema).readonly(), { auth: "admin" });
21358
21571
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
21359
21572
  providerId: string().min(1),
21360
21573
  displayName: string().min(1),
@@ -28447,6 +28660,33 @@ var RecordingRebalanceInputSchema = object({
28447
28660
  minMoveGb: number().min(0).optional()
28448
28661
  });
28449
28662
  /**
28663
+ * Operator-facing placement of one camera onto a recordings location.
28664
+ *
28665
+ * `pinLocationId` is the operator instruction: a location id, or `null` for
28666
+ * Auto (the planner may move this camera). `locationId` is where high/mid
28667
+ * currently write — the plan, which may disagree with the pin when Auto.
28668
+ */
28669
+ var RecordingDevicePlacementSchema = object({
28670
+ deviceId: number().int(),
28671
+ profile: string(),
28672
+ locationId: string()
28673
+ });
28674
+ var RecordingDevicePinSchema = object({
28675
+ deviceId: number().int(),
28676
+ /** Recordings-class location this camera is pinned to. */
28677
+ locationId: string()
28678
+ });
28679
+ var RecordingPlacementViewSchema = object({
28680
+ assignments: array(RecordingDevicePlacementSchema),
28681
+ pins: array(RecordingDevicePinSchema),
28682
+ defaultLocations: record(string(), string())
28683
+ });
28684
+ var RecordingSetDevicePlacementInputSchema = object({
28685
+ deviceId: number().int(),
28686
+ /** `null` = Auto. Otherwise a `recordings:*` location id. */
28687
+ locationId: string().nullable()
28688
+ });
28689
+ /**
28450
28690
  * Result of locating footage at a wall-clock instant for one device/profile.
28451
28691
  * `segment` carries the covering segment's window; `gap` reports the forward
28452
28692
  * nearest covered edge (`null` past the end of footage / when none exists)
@@ -28660,6 +28900,9 @@ method(object({
28660
28900
  }), method(RelocateResidueInputSchema, RelocateResidueSchema, {
28661
28901
  kind: "query",
28662
28902
  auth: "admin"
28903
+ }), method(LedgerWalkInputSchema, LedgerWalkReportSchema, {
28904
+ kind: "mutation",
28905
+ auth: "admin"
28663
28906
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
28664
28907
  kind: "mutation",
28665
28908
  auth: "admin"
@@ -28669,6 +28912,12 @@ method(object({
28669
28912
  }), method(RecordingRebalanceInputSchema, RecordingRebalancePlanSchema, {
28670
28913
  kind: "mutation",
28671
28914
  auth: "admin"
28915
+ }), method(object({}), RecordingPlacementViewSchema, {
28916
+ kind: "query",
28917
+ auth: "admin"
28918
+ }), method(RecordingSetDevicePlacementInputSchema, object({ ok: literal(true) }), {
28919
+ kind: "mutation",
28920
+ auth: "admin"
28672
28921
  });
28673
28922
  /**
28674
28923
  * `recording-export` cap — render a footage time range into a single downloadable
@@ -29051,6 +29300,25 @@ var SceneMonitorStatusSchema = object({
29051
29300
  monitors: array(SceneMonitorSchema),
29052
29301
  lastFetchedAt: number()
29053
29302
  });
29303
+ /**
29304
+ * One camera's row in a `listScenesBatch` answer.
29305
+ *
29306
+ * `status` is NULLABLE and the nullability is the whole point. `scene-monitor`
29307
+ * is a `defaultActive` wrapper, so every camera is asked; a camera whose
29308
+ * provider is absent (pipeline-analytics not deployed, the post-processing node
29309
+ * down) cannot answer, and that is not the same fact as a camera with no scenes
29310
+ * configured. Fanned out per camera the difference was visible — one query
29311
+ * errored while the others resolved — and a batch that returned only the rows
29312
+ * it managed would have destroyed it, silently, by making an unreachable camera
29313
+ * indistinguishable from one that answered `monitors: []`.
29314
+ *
29315
+ * So: EVERY requested deviceId gets a row. `status: null` means "this camera
29316
+ * could not be read"; `status.monitors: []` means "read, and it has none".
29317
+ */
29318
+ var SceneMonitorStatusForDeviceSchema = object({
29319
+ deviceId: number(),
29320
+ status: SceneMonitorStatusSchema.nullable()
29321
+ });
29054
29322
  var sceneMonitorCapability = {
29055
29323
  name: "scene-monitor",
29056
29324
  scope: "device",
@@ -29060,6 +29328,22 @@ var sceneMonitorCapability = {
29060
29328
  deviceTypes: [DeviceType.Camera],
29061
29329
  methods: {
29062
29330
  listScenes: method(object({ deviceId: number() }), SceneMonitorStatusSchema),
29331
+ /**
29332
+ * The same answer, for a SET of cameras, in one round trip.
29333
+ *
29334
+ * `/scenes` renders every camera and re-reads them on a 30s safety-net
29335
+ * poll behind the push slice. Fanned out client-side that was one query
29336
+ * per camera — 29 round trips through the browser, the hub and the
29337
+ * post-analysis runner every 30 seconds to read an in-memory map the
29338
+ * owner had already merged. The work is unchanged (`statusFor` per
29339
+ * device, all in-process at the owner); what collapses is the transport.
29340
+ *
29341
+ * A camera that cannot answer still gets a row, with `status: null` —
29342
+ * see {@link SceneMonitorStatusForDeviceSchema}. Never fewer rows than
29343
+ * ids: a caller that asked for twenty-nine and got twenty-seven cannot
29344
+ * tell which two are missing, or that any are.
29345
+ */
29346
+ listScenesBatch: method(object({ deviceIds: array(number()).min(1).max(200) }), array(SceneMonitorStatusForDeviceSchema).readonly()),
29063
29347
  createScene: method(object({
29064
29348
  deviceId: number(),
29065
29349
  label: string(),
@@ -30895,6 +31179,27 @@ var CameraOccupancySnapshotSchema = object({
30895
31179
  stationaryObjects: array(StationaryObjectSchema).readonly().optional()
30896
31180
  });
30897
31181
  /**
31182
+ * One camera's row in a `getCurrentSnapshotBatch` answer.
31183
+ *
31184
+ * THREE outcomes, and the single-camera method could only express two of them
31185
+ * because `snapshot: null` was already spoken for:
31186
+ *
31187
+ * - `read: 'read'`, `snapshot` present — the live occupancy reading.
31188
+ * - `read: 'read'`, `snapshot: null` — read, and this camera has no reading
31189
+ * yet: no frame since boot, and no parked-object registry to hydrate from.
31190
+ * - `read: 'unreadable'` — the owner could not answer for this
31191
+ * camera. `snapshot` is null, and it does NOT mean "nothing parked here".
31192
+ *
31193
+ * Collapsing the last two is the failure this field exists to prevent: a
31194
+ * hydration that threw would otherwise render as an empty Stationary section,
31195
+ * which is a definite claim about a camera nobody could read.
31196
+ */
31197
+ var CameraOccupancySnapshotForDeviceSchema = object({
31198
+ deviceId: number(),
31199
+ read: _enum(["read", "unreadable"]),
31200
+ snapshot: CameraOccupancySnapshotSchema.nullable()
31201
+ });
31202
+ /**
30898
31203
  * Time-series resolution. The history methods return one bucket per
30899
31204
  * step over the requested range. Smaller resolutions cost more
30900
31205
  * memory + bandwidth; bound to discrete steps so caller cannot ask
@@ -30951,6 +31256,20 @@ var zoneAnalyticsCapability = {
30951
31256
  * (no inference result emitted since boot or since binding was
30952
31257
  * activated). */
30953
31258
  getCurrentSnapshot: method(object({ deviceId: number() }), CameraOccupancySnapshotSchema.nullable()),
31259
+ /**
31260
+ * The same snapshot, for a SET of cameras, in one round trip.
31261
+ *
31262
+ * The Events page's Stationary section polls this every 15s for every
31263
+ * selected camera. Fanned out client-side that is one query per camera to
31264
+ * read a `Map.get` at the owner — the answer costs nothing, the round trip
31265
+ * costs everything. Batched, N transports become one and the per-device
31266
+ * work is unchanged.
31267
+ *
31268
+ * Every requested deviceId gets a row, tagged `read` — see
31269
+ * {@link CameraOccupancySnapshotForDeviceSchema}. A camera the owner could
31270
+ * not answer for is `'unreadable'`, never an empty reading.
31271
+ */
31272
+ getCurrentSnapshotBatch: method(object({ deviceIds: array(number()).min(1).max(200) }), array(CameraOccupancySnapshotForDeviceSchema).readonly()),
30954
31273
  /** Time-series object count inside one zone. `className` optional —
30955
31274
  * omit to count every class in the zone. */
30956
31275
  getZoneHistory: method(object({
@@ -33668,6 +33987,12 @@ Object.freeze({
33668
33987
  addonId: null,
33669
33988
  access: "delete"
33670
33989
  },
33990
+ "deviceManager.renameLocation": {
33991
+ capName: "device-manager",
33992
+ capScope: "system",
33993
+ addonId: null,
33994
+ access: "create"
33995
+ },
33671
33996
  "deviceManager.runDeviceAction": {
33672
33997
  capName: "device-manager",
33673
33998
  capScope: "system",
@@ -35360,13 +35685,19 @@ Object.freeze({
35360
35685
  addonId: null,
35361
35686
  access: "view"
35362
35687
  },
35363
- "pipelineAnalytics.getGroup": {
35688
+ "pipelineAnalytics.getKeyEvents": {
35364
35689
  capName: "pipeline-analytics",
35365
35690
  capScope: "device",
35366
35691
  addonId: null,
35367
35692
  access: "view"
35368
35693
  },
35369
- "pipelineAnalytics.getKeyEvents": {
35694
+ "pipelineAnalytics.getKeyEventsBatch": {
35695
+ capName: "pipeline-analytics",
35696
+ capScope: "device",
35697
+ addonId: null,
35698
+ access: "view"
35699
+ },
35700
+ "pipelineAnalytics.getMediaReclaimStatus": {
35370
35701
  capName: "pipeline-analytics",
35371
35702
  capScope: "device",
35372
35703
  addonId: null,
@@ -35456,12 +35787,6 @@ Object.freeze({
35456
35787
  addonId: null,
35457
35788
  access: "view"
35458
35789
  },
35459
- "pipelineAnalytics.listGroups": {
35460
- capName: "pipeline-analytics",
35461
- capScope: "device",
35462
- addonId: null,
35463
- access: "view"
35464
- },
35465
35790
  "pipelineAnalytics.listOpsLog": {
35466
35791
  capName: "pipeline-analytics",
35467
35792
  capScope: "device",
@@ -35546,6 +35871,12 @@ Object.freeze({
35546
35871
  addonId: null,
35547
35872
  access: "create"
35548
35873
  },
35874
+ "pipelineAnalytics.reclaimDebugMedia": {
35875
+ capName: "pipeline-analytics",
35876
+ capScope: "device",
35877
+ addonId: null,
35878
+ access: "create"
35879
+ },
35549
35880
  "pipelineAnalytics.reconcileFromDisk": {
35550
35881
  capName: "pipeline-analytics",
35551
35882
  capScope: "device",
@@ -36470,6 +36801,12 @@ Object.freeze({
36470
36801
  addonId: null,
36471
36802
  access: "view"
36472
36803
  },
36804
+ "recording.getPlacement": {
36805
+ capName: "recording",
36806
+ capScope: "system",
36807
+ addonId: null,
36808
+ access: "view"
36809
+ },
36473
36810
  "recording.getPlaybackManifest": {
36474
36811
  capName: "recording",
36475
36812
  capScope: "system",
@@ -36548,6 +36885,12 @@ Object.freeze({
36548
36885
  addonId: null,
36549
36886
  access: "view"
36550
36887
  },
36888
+ "recording.reconcileLedgerAgainstDisk": {
36889
+ capName: "recording",
36890
+ capScope: "system",
36891
+ addonId: null,
36892
+ access: "create"
36893
+ },
36551
36894
  "recording.refreshStorageLocationsForMigration": {
36552
36895
  capName: "recording",
36553
36896
  capScope: "system",
@@ -36590,6 +36933,12 @@ Object.freeze({
36590
36933
  addonId: null,
36591
36934
  access: "create"
36592
36935
  },
36936
+ "recording.setDevicePlacement": {
36937
+ capName: "recording",
36938
+ capScope: "system",
36939
+ addonId: null,
36940
+ access: "create"
36941
+ },
36593
36942
  "recording.startStorageMigrationMove": {
36594
36943
  capName: "recording",
36595
36944
  capScope: "system",
@@ -36674,6 +37023,12 @@ Object.freeze({
36674
37023
  addonId: null,
36675
37024
  access: "view"
36676
37025
  },
37026
+ "sceneMonitor.listScenesBatch": {
37027
+ capName: "scene-monitor",
37028
+ capScope: "device",
37029
+ addonId: null,
37030
+ access: "view"
37031
+ },
36677
37032
  "sceneMonitor.recheckNow": {
36678
37033
  capName: "scene-monitor",
36679
37034
  capScope: "device",
@@ -37028,12 +37383,36 @@ Object.freeze({
37028
37383
  addonId: null,
37029
37384
  access: "create"
37030
37385
  },
37386
+ "storageMigration.cleanupCancel": {
37387
+ capName: "storage-migration",
37388
+ capScope: "system",
37389
+ addonId: null,
37390
+ access: "create"
37391
+ },
37392
+ "storageMigration.cleanupStart": {
37393
+ capName: "storage-migration",
37394
+ capScope: "system",
37395
+ addonId: null,
37396
+ access: "create"
37397
+ },
37398
+ "storageMigration.cleanupStatus": {
37399
+ capName: "storage-migration",
37400
+ capScope: "system",
37401
+ addonId: null,
37402
+ access: "view"
37403
+ },
37031
37404
  "storageMigration.drain": {
37032
37405
  capName: "storage-migration",
37033
37406
  capScope: "system",
37034
37407
  addonId: null,
37035
37408
  access: "create"
37036
37409
  },
37410
+ "storageMigration.history": {
37411
+ capName: "storage-migration",
37412
+ capScope: "system",
37413
+ addonId: null,
37414
+ access: "view"
37415
+ },
37037
37416
  "storageMigration.movers": {
37038
37417
  capName: "storage-migration",
37039
37418
  capScope: "system",
@@ -38030,6 +38409,12 @@ Object.freeze({
38030
38409
  addonId: null,
38031
38410
  access: "view"
38032
38411
  },
38412
+ "zoneAnalytics.getCurrentSnapshotBatch": {
38413
+ capName: "zone-analytics",
38414
+ capScope: "device",
38415
+ addonId: null,
38416
+ access: "view"
38417
+ },
38033
38418
  "zoneAnalytics.getUnzonedHistory": {
38034
38419
  capName: "zone-analytics",
38035
38420
  capScope: "device",
@@ -39024,14 +39409,14 @@ Object.freeze({
39024
39409
  form: "single",
39025
39410
  optional: true
39026
39411
  }],
39027
- "pipelineAnalytics.getGroup": [{
39412
+ "pipelineAnalytics.getKeyEvents": [{
39028
39413
  name: "deviceId",
39029
39414
  form: "single",
39030
39415
  optional: false
39031
39416
  }],
39032
- "pipelineAnalytics.getKeyEvents": [{
39033
- name: "deviceId",
39034
- form: "single",
39417
+ "pipelineAnalytics.getKeyEventsBatch": [{
39418
+ name: "deviceIds",
39419
+ form: "array",
39035
39420
  optional: false
39036
39421
  }],
39037
39422
  "pipelineAnalytics.getMotionEvents": [{
@@ -39089,11 +39474,6 @@ Object.freeze({
39089
39474
  form: "single",
39090
39475
  optional: false
39091
39476
  }],
39092
- "pipelineAnalytics.listGroups": [{
39093
- name: "deviceIds",
39094
- form: "array",
39095
- optional: false
39096
- }],
39097
39477
  "pipelineAnalytics.listOpsLog": [{
39098
39478
  name: "deviceId",
39099
39479
  form: "single",
@@ -39139,6 +39519,11 @@ Object.freeze({
39139
39519
  form: "single",
39140
39520
  optional: true
39141
39521
  }],
39522
+ "pipelineAnalytics.reclaimDebugMedia": [{
39523
+ name: "deviceIds",
39524
+ form: "array",
39525
+ optional: true
39526
+ }],
39142
39527
  "pipelineAnalytics.reconcileFromDisk": [{
39143
39528
  name: "deviceId",
39144
39529
  form: "single",
@@ -39474,6 +39859,11 @@ Object.freeze({
39474
39859
  form: "single",
39475
39860
  optional: false
39476
39861
  }],
39862
+ "recording.reconcileLedgerAgainstDisk": [{
39863
+ name: "deviceId",
39864
+ form: "single",
39865
+ optional: true
39866
+ }],
39477
39867
  "recording.relocateFootage": [{
39478
39868
  name: "deviceId",
39479
39869
  form: "single",
@@ -39499,6 +39889,11 @@ Object.freeze({
39499
39889
  form: "single",
39500
39890
  optional: false
39501
39891
  }],
39892
+ "recording.setDevicePlacement": [{
39893
+ name: "deviceId",
39894
+ form: "single",
39895
+ optional: false
39896
+ }],
39502
39897
  "recording.startStorageMigrationMove": [{
39503
39898
  name: "deviceId",
39504
39899
  form: "single",
@@ -39539,6 +39934,11 @@ Object.freeze({
39539
39934
  form: "single",
39540
39935
  optional: false
39541
39936
  }],
39937
+ "sceneMonitor.listScenesBatch": [{
39938
+ name: "deviceIds",
39939
+ form: "array",
39940
+ optional: false
39941
+ }],
39542
39942
  "sceneMonitor.recheckNow": [{
39543
39943
  name: "deviceId",
39544
39944
  form: "single",
@@ -39800,6 +40200,11 @@ Object.freeze({
39800
40200
  form: "single",
39801
40201
  optional: false
39802
40202
  }],
40203
+ "zoneAnalytics.getCurrentSnapshotBatch": [{
40204
+ name: "deviceIds",
40205
+ form: "array",
40206
+ optional: false
40207
+ }],
39803
40208
  "zoneAnalytics.getUnzonedHistory": [{
39804
40209
  name: "deviceId",
39805
40210
  form: "single",