@camstack/addon-provider-hikvision 1.2.56 → 1.2.58

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
@@ -8013,6 +8013,20 @@ var RelocateJobSchema = object({
8013
8013
  * in its row, not in its name, so `MediaRelocateEngine` never reconciles one.
8014
8014
  */
8015
8015
  rowsReconciled: number().int().nonnegative().optional(),
8016
+ /**
8017
+ * Rows this run FORGOT because the file they name is not on disk.
8018
+ *
8019
+ * The mover derived the path from the row's own fields and `stat`ed it; an
8020
+ * ENOENT there is a per-path confirmation that the segment is gone (D296),
8021
+ * and the durable row is dropped through the same channel eviction uses. It
8022
+ * is reported for the same reason `rowsReconciled` is: this is a durable
8023
+ * mutation nobody asked for, and a migration that quietly erases hour rows is
8024
+ * the same failure as one that quietly skips them (D295).
8025
+ *
8026
+ * The production drain of 2026-08-30 would have reported 11 074 here — the
8027
+ * ledger claimed 5.65 GB of footage that no longer existed.
8028
+ */
8029
+ rowsForgotten: number().int().nonnegative().optional(),
8016
8030
  startedAt: number(),
8017
8031
  finishedAt: number().nullable(),
8018
8032
  error: string().nullable()
@@ -8077,6 +8091,13 @@ var MediaRelocateModeSchema = _enum([
8077
8091
  ]);
8078
8092
  var RelocateMediaInputSchema = object({
8079
8093
  toLocationId: string(),
8094
+ /**
8095
+ * Restrict the pass to rows currently on this location. Omitted / `'*'` =
8096
+ * every row that is not already on `toLocationId` (the historical
8097
+ * behaviour). A named source is what a from→to migration needs: without it
8098
+ * "move events off disk 2" also emptied disk 1.
8099
+ */
8100
+ fromLocationId: string().optional(),
8080
8101
  throttleMbps: number().min(1).max(1e3).optional(),
8081
8102
  /** Omitted = `move`, the pre-existing behaviour. */
8082
8103
  mode: MediaRelocateModeSchema.optional()
@@ -8144,6 +8165,19 @@ var StorageMigrationDestinationsSchema = object({
8144
8165
  galleryMedia: string().min(1).optional()
8145
8166
  }).refine((value) => Object.keys(value).length > 0, { message: "select at least one storage class" });
8146
8167
  /**
8168
+ * Optional named source per class. Omitted = the class's current default
8169
+ * (the historical behaviour). A named source that is NOT the default is a
8170
+ * drain of that disk: bytes move, the default stays, and the source is
8171
+ * disabled when the move finishes.
8172
+ */
8173
+ var StorageMigrationSourcesSchema = object({
8174
+ recordings: string().min(1).optional(),
8175
+ recordingsLow: string().min(1).optional(),
8176
+ eventMedia: string().min(1).optional(),
8177
+ backups: string().min(1).optional(),
8178
+ galleryMedia: string().min(1).optional()
8179
+ }).optional();
8180
+ /**
8147
8181
  * How a migration sequences the cutover against the byte move.
8148
8182
  *
8149
8183
  * - `blocking` — the historical order: pause, move every byte, repoint,
@@ -8165,6 +8199,8 @@ var StorageMigrationModeSchema = _enum(["blocking", "nonBlocking"]);
8165
8199
  /** Shared input for planning and starting an orchestrated storage migration. */
8166
8200
  var StorageMigrationInputSchema = object({
8167
8201
  destinations: StorageMigrationDestinationsSchema,
8202
+ /** Omitted = each class's current default. */
8203
+ sources: StorageMigrationSourcesSchema,
8168
8204
  throttleMbps: number().min(1).max(1e3).optional(),
8169
8205
  /** Omitted = `blocking`, which stays the default. */
8170
8206
  mode: StorageMigrationModeSchema.optional()
@@ -8244,6 +8280,13 @@ var StorageMigrationMoveSchema = object({
8244
8280
  storageClass: StorageMigrationClassSchema,
8245
8281
  fromLocationId: string(),
8246
8282
  toLocationId: string(),
8283
+ /**
8284
+ * True when `from` was NOT the class default at plan time. The move still
8285
+ * copies bytes, but the default is left alone and the source is disabled
8286
+ * once the copy verifies. Absent on jobs planned before this field existed
8287
+ * — those jobs always repointed, which is `false`.
8288
+ */
8289
+ freezeSource: boolean().optional(),
8247
8290
  moverJobId: string().nullable(),
8248
8291
  state: RelocateJobStateSchema.nullable(),
8249
8292
  error: string().nullable(),
@@ -8257,6 +8300,7 @@ var StorageMigrationJobSchema = object({
8257
8300
  * can tell a seconds-long cutover from a thirty-hour one. */
8258
8301
  mode: StorageMigrationModeSchema,
8259
8302
  destinations: StorageMigrationDestinationsSchema,
8303
+ sources: StorageMigrationSourcesSchema,
8260
8304
  throttleMbps: number(),
8261
8305
  moves: array(StorageMigrationMoveSchema),
8262
8306
  pauseLeaseId: string().nullable(),
@@ -8282,6 +8326,7 @@ var StorageMigrationFindingSchema = object({
8282
8326
  });
8283
8327
  var StorageMigrationPlanSchema = object({
8284
8328
  destinations: StorageMigrationDestinationsSchema,
8329
+ sources: StorageMigrationSourcesSchema,
8285
8330
  /** The mode this plan was built for. A plan is only valid for its mode: the
8286
8331
  * `eventMedia` seal gate and the single-cardinality refusal both depend on
8287
8332
  * it. */
@@ -8289,7 +8334,8 @@ var StorageMigrationPlanSchema = object({
8289
8334
  moves: array(object({
8290
8335
  storageClass: StorageMigrationClassSchema,
8291
8336
  fromLocationId: string(),
8292
- toLocationId: string()
8337
+ toLocationId: string(),
8338
+ freezeSource: boolean().optional()
8293
8339
  })),
8294
8340
  findings: array(StorageMigrationFindingSchema)
8295
8341
  });
@@ -8376,16 +8422,142 @@ var RelocateResidueSchema = object({
8376
8422
  segments: number().int().nonnegative(),
8377
8423
  bytes: number().int().nonnegative()
8378
8424
  }).nullable();
8425
+ /**
8426
+ * Ask one location whether its durable hour rows describe the disk — the walk
8427
+ * (D319).
8428
+ *
8429
+ * `apply` DEFAULTS TO FALSE and that default is the product: the operator's
8430
+ * missing tool is the question, and the dry run is how they sanity-check the
8431
+ * destructive run before authorising it.
8432
+ */
8433
+ var LedgerWalkInputSchema = object({
8434
+ locationId: string().min(1),
8435
+ /** Forget the confirmed-absent rows, rather than only counting them. */
8436
+ apply: boolean().optional(),
8437
+ /** Narrow to one camera. */
8438
+ deviceId: number().int().positive().optional(),
8439
+ /** Narrow to these recording profiles; empty/absent = every profile. */
8440
+ profiles: array(string().min(1)).optional()
8441
+ });
8442
+ /** Why a whole walk did nothing. Every one leaves the ledger untouched. */
8443
+ var LedgerWalkRefusalSchema = _enum([
8444
+ "location-unknown",
8445
+ "source-writable",
8446
+ "no-ledger",
8447
+ "archive-unreadable",
8448
+ "anchor-absent",
8449
+ "anchor-unreadable",
8450
+ "anchor-moved"
8451
+ ]);
8452
+ _enum([
8453
+ "live-tail",
8454
+ "listing-error",
8455
+ "path-mismatch",
8456
+ "durable-refused"
8457
+ ]);
8458
+ /** Every skip reason, always present, always a number — so a reason that never
8459
+ * fired reports as zero rather than absent and the report shape is constant
8460
+ * between passes. Spelled out rather than `z.record` for exactly that. */
8461
+ var LedgerWalkSkipCountsSchema = object({
8462
+ "live-tail": number().int().nonnegative(),
8463
+ "listing-error": number().int().nonnegative(),
8464
+ "path-mismatch": number().int().nonnegative(),
8465
+ "durable-refused": number().int().nonnegative()
8466
+ });
8467
+ /** One camera's share of a walk, so a report names cameras and not rows. */
8468
+ var LedgerWalkDeviceReportSchema = object({
8469
+ deviceId: number().int(),
8470
+ hoursWalked: number().int().nonnegative(),
8471
+ hoursMissing: number().int().nonnegative(),
8472
+ ghostSegments: number().int().nonnegative(),
8473
+ ghostBytes: number().int().nonnegative(),
8474
+ forgottenSegments: number().int().nonnegative(),
8475
+ orphanFiles: number().int().nonnegative()
8476
+ });
8477
+ /**
8478
+ * What one walk claimed, listed, found and (only when armed) forgot.
8479
+ *
8480
+ * `archiveSegments` is the **M** and `segmentsClaimed` the **N** (D295), so a
8481
+ * walk that saw a fraction of the location is visible in its own report rather
8482
+ * than in the absence of one.
8483
+ */
8484
+ var LedgerWalkReportSchema = object({
8485
+ locationId: string(),
8486
+ applied: boolean(),
8487
+ refused: LedgerWalkRefusalSchema.nullable(),
8488
+ archiveSegments: number().int().nonnegative().nullable(),
8489
+ archiveBytes: number().int().nonnegative().nullable(),
8490
+ hoursClaimed: number().int().nonnegative(),
8491
+ hoursWalked: number().int().nonnegative(),
8492
+ hoursMissing: number().int().nonnegative(),
8493
+ /** `readdir` calls issued — the cost, stated in the unit that is paid. */
8494
+ listings: number().int().nonnegative(),
8495
+ segmentsClaimed: number().int().nonnegative(),
8496
+ ghostSegments: number().int().nonnegative(),
8497
+ ghostBytes: number().int().nonnegative(),
8498
+ ghostHoursWhole: number().int().nonnegative(),
8499
+ forgottenSegments: number().int().nonnegative(),
8500
+ forgottenBytes: number().int().nonnegative(),
8501
+ /** Files under a claimed hour that no durable row names. Never deleted. */
8502
+ orphanFiles: number().int().nonnegative(),
8503
+ orphanSample: array(string()).readonly(),
8504
+ hoursSkipped: number().int().nonnegative(),
8505
+ skippedByReason: LedgerWalkSkipCountsSchema,
8506
+ /** The walk stopped at its per-pass hour bound with claims unwalked. */
8507
+ bounded: boolean(),
8508
+ byDevice: array(LedgerWalkDeviceReportSchema).readonly()
8509
+ });
8379
8510
  /** How many rows a media pass would still act on against a given target — the
8380
8511
  * media lane's denominator AND its residue, from ONE derivation so the two can
8381
8512
  * never disagree. `null` = the count could not be taken. */
8382
8513
  var RelocatableMediaCountSchema = object({ rows: number().int().nonnegative() }).nullable();
8383
8514
  var RelocatableMediaCountInputSchema = object({
8384
8515
  toLocationId: string().min(1),
8516
+ /** Restrict the count to one source; omitted / `'*'` = every non-target row. */
8517
+ fromLocationId: string().optional(),
8385
8518
  /** Omitted = `move`. */
8386
8519
  mode: MediaRelocateModeSchema.optional()
8387
8520
  });
8388
8521
  /**
8522
+ * Operator cleanup of leftover analytics rows, optional debug media, and
8523
+ * ghost ledger entries on frozen footage locations.
8524
+ *
8525
+ * A pass is tens of minutes on a standing backlog. The hub method RETURNS
8526
+ * `{ jobId }` immediately; progress is `cleanupStatus`. Awaiting the work
8527
+ * is how `addons.custom` hit the 60 s UDS deadline while reclaim continued
8528
+ * with no operator-visible status.
8529
+ */
8530
+ var StorageCleanupPhaseSchema = _enum([
8531
+ "orphans",
8532
+ "debug-media",
8533
+ "ghost-ledger",
8534
+ "done",
8535
+ "failed",
8536
+ "cancelled"
8537
+ ]);
8538
+ var StorageCleanupInputSchema = object({
8539
+ /** Also walk motion stills / track filmstrips. Off by default. */
8540
+ includeDebugMedia: boolean().optional() });
8541
+ var StorageCleanupJobSchema = object({
8542
+ jobId: string(),
8543
+ phase: StorageCleanupPhaseSchema,
8544
+ includeDebugMedia: boolean(),
8545
+ orphansReclaimed: number().int().nonnegative(),
8546
+ orphanBytesReclaimed: number().int().nonnegative(),
8547
+ debugMediaReclaimed: number().int().nonnegative(),
8548
+ debugMediaBytesReclaimed: number().int().nonnegative(),
8549
+ ghostsForgotten: number().int().nonnegative(),
8550
+ ghostBytesForgotten: number().int().nonnegative(),
8551
+ /** Short operator-facing line: current collection, pass, or location. */
8552
+ detail: string().nullable(),
8553
+ cancelRequested: boolean(),
8554
+ startedAt: number(),
8555
+ updatedAt: number(),
8556
+ finishedAt: number().nullable(),
8557
+ error: string().nullable()
8558
+ });
8559
+ var StorageCleanupStatusInputSchema = object({ jobId: string().optional() });
8560
+ /**
8389
8561
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
8390
8562
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
8391
8563
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -8413,11 +8585,10 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
8413
8585
  * The default location for a type uses `id === <type>:default` by
8414
8586
  * convention (the bare type ref like `'backups'` resolves to it).
8415
8587
  *
8416
- * `isSystem: true` marks a location as orchestrator-seeded and
8417
- * undeletable. The bootstrap-installed defaults (one per type) carry
8418
- * this flag; operator-added locations don't. Editing the config of
8419
- * a system location is allowed (path migration, provider swap) but
8420
- * deleting it is rejected at the cap level.
8588
+ * `isSystem` is a legacy persisted flag. Seed still creates the initial
8589
+ * `<type>:default` locations; the flag is no longer a lock, a badge, or a
8590
+ * prune selector. New writes leave it false. Deletion is gated on uniqueness
8591
+ * / last-enabled, not on this bit.
8421
8592
  */
8422
8593
  var StorageLocationSchema = object({
8423
8594
  id: string().regex(/^[a-z][a-zA-Z0-9-]*:[a-zA-Z0-9-]+$/),
@@ -13236,6 +13407,12 @@ method(object({
13236
13407
  }), _void(), {
13237
13408
  kind: "mutation",
13238
13409
  auth: "admin"
13410
+ }), method(object({
13411
+ from: string(),
13412
+ to: string()
13413
+ }), object({ moved: number() }), {
13414
+ kind: "mutation",
13415
+ auth: "admin"
13239
13416
  }), method(object({
13240
13417
  deviceId: number(),
13241
13418
  disabled: boolean()
@@ -19263,53 +19440,15 @@ var RecentTracksPageSchema = object({
19263
19440
  /** Cursor for the next page, or null when this page is the last. */
19264
19441
  nextCursor: string().nullable()
19265
19442
  });
19266
- var LIST_GROUPS_DEFAULT_LIMIT = 40;
19267
- var LIST_GROUPS_MAX_LIMIT = 100;
19268
- var AnalyticsGroupRecordSchema = object({
19269
- id: string(),
19270
- deviceId: number().int(),
19271
- openedAt: number().int(),
19272
- closedAt: number().int(),
19273
- timestamp: number().int(),
19274
- memberCount: number().int(),
19275
- memberTrackIds: array(string()).readonly(),
19276
- className: string(),
19277
- classes: array(string()).readonly(),
19278
- /** Relative event-media path, or null when the group has no picture yet. */
19279
- mediaUrl: string().nullable(),
19280
- singleton: boolean()
19281
- });
19282
- var AnalyticsGroupMemberSchema = object({
19283
- trackId: string(),
19284
- deviceId: number().int(),
19285
- className: string(),
19286
- firstSeen: number().int(),
19287
- lastSeen: number().int(),
19288
- mediaUrl: string().nullable()
19289
- });
19290
- var AnalyticsGroupDetailSchema = AnalyticsGroupRecordSchema.extend({ members: array(AnalyticsGroupMemberSchema).readonly() });
19291
- var ListGroupsQueryInput = object({
19292
- /** Devices to merge. An empty array yields `{ groups: [], nextCursor: null }`. */
19293
- deviceIds: array(number()),
19294
- /** Window lower bound on `closedAt` (inclusive). */
19295
- since: number().optional(),
19296
- /** Window upper bound on `openedAt` (inclusive). */
19297
- until: number().optional(),
19298
- limit: number().int().min(1).max(LIST_GROUPS_MAX_LIMIT).default(LIST_GROUPS_DEFAULT_LIMIT),
19299
- /** Opaque continuation cursor from a previous page's `nextCursor`. */
19300
- cursor: string().optional()
19301
- });
19302
- var ListGroupsPageSchema = object({
19303
- groups: array(AnalyticsGroupRecordSchema).readonly(),
19304
- nextCursor: string().nullable()
19305
- });
19443
+ var KEY_EVENTS_DEFAULT_LIMIT = 50;
19444
+ var KEY_EVENTS_MAX_LIMIT = 200;
19306
19445
  var KeyEventQueryInput = object({
19307
19446
  deviceId: number(),
19308
19447
  /** Window lower bound (track firstSeen ≥ since). */
19309
19448
  since: number(),
19310
19449
  /** Window upper bound (track firstSeen ≤ until). */
19311
19450
  until: number(),
19312
- limit: number().int().min(1).max(200).default(50),
19451
+ limit: number().int().min(1).max(KEY_EVENTS_MAX_LIMIT).default(KEY_EVENTS_DEFAULT_LIMIT),
19313
19452
  /** Drop tracks scoring below this importance. */
19314
19453
  minImportance: number().min(0).max(1).optional(),
19315
19454
  /** Restrict to a single class (e.g. 'person'). */
@@ -19331,6 +19470,32 @@ var KeyEventSchema = object({
19331
19470
  ...TrackFlagFields,
19332
19471
  ...TrackRetrainFields
19333
19472
  });
19473
+ /** `getKeyEvents`' window and filters, asked of a SET of cameras at once. */
19474
+ var KeyEventBatchQueryInput = object({
19475
+ deviceIds: array(number()).min(1).max(200),
19476
+ since: number(),
19477
+ until: number(),
19478
+ /** Applied PER CAMERA, exactly as `getKeyEvents.limit` is — never a total
19479
+ * across the set, which would let a busy camera starve a quiet one of its
19480
+ * rows and change what the merged feed contains. */
19481
+ limit: number().int().min(1).max(KEY_EVENTS_MAX_LIMIT).default(KEY_EVENTS_DEFAULT_LIMIT),
19482
+ minImportance: number().min(0).max(1).optional(),
19483
+ classFilter: string().optional()
19484
+ });
19485
+ /**
19486
+ * One camera's key events in a batch answer.
19487
+ *
19488
+ * The row exists for every requested id. `getKeyEvents` degrades to `[]` on
19489
+ * error rather than throwing, so a camera whose store read failed and one with
19490
+ * no events in the window were ALREADY indistinguishable per camera — the
19491
+ * batch does not make that worse, and the row keeps the deviceId the single
19492
+ * method's output never carried (the caller used to stamp it from the fan-out
19493
+ * key, which only worked because there was one query per camera).
19494
+ */
19495
+ var KeyEventsForDeviceSchema = object({
19496
+ deviceId: number(),
19497
+ events: array(KeyEventSchema).readonly()
19498
+ });
19334
19499
  object({
19335
19500
  trackId: string(),
19336
19501
  className: string(),
@@ -19378,9 +19543,7 @@ var TrackCascadeCountsSchema = object({
19378
19543
  /** Unassigned plate reads removed (best-effort; plate leg deferred to plate-intelligence). */
19379
19544
  plates: number().int(),
19380
19545
  /** Per-track CLIP search vectors removed (best-effort). */
19381
- embeddings: number().int(),
19382
- /** Group membership + group rows removed with their last member (best-effort). */
19383
- groups: number().int()
19546
+ embeddings: number().int()
19384
19547
  });
19385
19548
  /** Disk-wins reconcile: media rows whose blobs are gone, then empty tracks. */
19386
19549
  var DiskReconcileCountsSchema = object({
@@ -19550,6 +19713,47 @@ var RebuildStatusSchema = object({
19550
19713
  /** Present when the pass ended by throwing. */
19551
19714
  error: string().nullable()
19552
19715
  });
19716
+ /**
19717
+ * Acknowledgement that a debug-media reclaim STARTED.
19718
+ *
19719
+ * The pass is paced at ~2 MB/s over a standing 100 GB — tens of minutes — so
19720
+ * it runs detached and this returns immediately. Awaiting it is how the
19721
+ * `addons.custom` door hit the 60 s UDS deadline while the walk carried on
19722
+ * with no status. Poll {@link pipelineAnalyticsCapability.methods.getMediaReclaimStatus}.
19723
+ */
19724
+ var MediaReclaimStartResultSchema = object({
19725
+ started: boolean(),
19726
+ /** True when a pass was already running; the new request is ignored. */
19727
+ alreadyRunning: boolean()
19728
+ });
19729
+ var MediaReclaimInputSchema = object({
19730
+ mode: _enum(["report", "reclaim"]).default("report"),
19731
+ scopes: array(_enum(["motion-still", "track-filmstrip"])).min(1).optional(),
19732
+ deviceIds: array(number().int()).min(1).optional(),
19733
+ restart: boolean().optional(),
19734
+ pageSize: number().int().min(50).max(5e3).optional(),
19735
+ maxRowsPerDevice: number().int().min(1).max(5e5).optional(),
19736
+ maxReclaimPerDevice: number().int().min(1).max(5e5).optional(),
19737
+ maxBytesPerRun: number().int().min(1).optional(),
19738
+ budgetMinutes: number().int().min(1).max(720).optional(),
19739
+ throttleBytesPerSec: number().int().min(64 * 1024).optional(),
19740
+ graceMinutes: number().int().min(1).max(10080).optional()
19741
+ });
19742
+ var MediaReclaimStatusSchema = object({
19743
+ running: boolean(),
19744
+ mode: _enum(["report", "reclaim"]).nullable(),
19745
+ totalExamined: number(),
19746
+ totalEligible: number(),
19747
+ totalReclaimed: number(),
19748
+ totalBytesReclaimed: number(),
19749
+ totalRefused: number(),
19750
+ /** Device+scope windows finished in this pass. */
19751
+ devicesDone: number(),
19752
+ complete: boolean().nullable(),
19753
+ startedAtMs: number().nullable(),
19754
+ finishedAtMs: number().nullable(),
19755
+ error: string().nullable()
19756
+ });
19553
19757
  var ReplayFrameInputSchema = object({
19554
19758
  timestamp: number(),
19555
19759
  frame: PipelineRunResultBridge
@@ -19588,10 +19792,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19588
19792
  * stationary registry). Default false: the timeline lists passages,
19589
19793
  * not parking records (operator decision, 2026-08-15). */
19590
19794
  includeStationary: boolean().optional()
19591
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(ListGroupsQueryInput, ListGroupsPageSchema), method(object({
19592
- deviceId: number(),
19593
- groupId: string().min(1)
19594
- }), AnalyticsGroupDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
19795
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(object({ deviceId: number() }), _void(), {
19595
19796
  kind: "mutation",
19596
19797
  auth: "admin"
19597
19798
  }), 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({
@@ -19600,7 +19801,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19600
19801
  until: number().optional(),
19601
19802
  kinds: array(string()).optional(),
19602
19803
  limit: number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
19603
- }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(object({
19804
+ }), array(SensorEventSchema).readonly()), method(KeyEventQueryInput, array(KeyEventSchema).readonly()), method(KeyEventBatchQueryInput, array(KeyEventsForDeviceSchema).readonly()), method(object({
19604
19805
  deviceId: number(),
19605
19806
  since: number(),
19606
19807
  until: number(),
@@ -19691,6 +19892,12 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
19691
19892
  }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
19692
19893
  kind: "query",
19693
19894
  auth: "admin"
19895
+ }), method(MediaReclaimInputSchema, MediaReclaimStartResultSchema, {
19896
+ kind: "mutation",
19897
+ auth: "admin"
19898
+ }), method(object({}), MediaReclaimStatusSchema, {
19899
+ kind: "query",
19900
+ auth: "admin"
19694
19901
  }), method(object({ deviceIds: array(number()).optional() }), TrainingExportSummarySchema, {
19695
19902
  kind: "query",
19696
19903
  auth: "admin"
@@ -21765,7 +21972,13 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
21765
21972
  }), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
21766
21973
  kind: "mutation",
21767
21974
  auth: "admin"
21768
- });
21975
+ }), method(StorageCleanupInputSchema, object({ jobId: string() }), {
21976
+ kind: "mutation",
21977
+ auth: "admin"
21978
+ }), method(StorageCleanupStatusInputSchema, StorageCleanupJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
21979
+ kind: "mutation",
21980
+ auth: "admin"
21981
+ }), method(object({}), array(StorageMigrationJobSchema).readonly(), { auth: "admin" });
21769
21982
  var ProviderInfoSchema = discriminatedUnion("shouldSaveDiskSpace", [object({
21770
21983
  providerId: string().min(1),
21771
21984
  displayName: string().min(1),
@@ -28991,6 +29204,33 @@ var RecordingRebalanceInputSchema = object({
28991
29204
  minMoveGb: number().min(0).optional()
28992
29205
  });
28993
29206
  /**
29207
+ * Operator-facing placement of one camera onto a recordings location.
29208
+ *
29209
+ * `pinLocationId` is the operator instruction: a location id, or `null` for
29210
+ * Auto (the planner may move this camera). `locationId` is where high/mid
29211
+ * currently write — the plan, which may disagree with the pin when Auto.
29212
+ */
29213
+ var RecordingDevicePlacementSchema = object({
29214
+ deviceId: number().int(),
29215
+ profile: string(),
29216
+ locationId: string()
29217
+ });
29218
+ var RecordingDevicePinSchema = object({
29219
+ deviceId: number().int(),
29220
+ /** Recordings-class location this camera is pinned to. */
29221
+ locationId: string()
29222
+ });
29223
+ var RecordingPlacementViewSchema = object({
29224
+ assignments: array(RecordingDevicePlacementSchema),
29225
+ pins: array(RecordingDevicePinSchema),
29226
+ defaultLocations: record(string(), string())
29227
+ });
29228
+ var RecordingSetDevicePlacementInputSchema = object({
29229
+ deviceId: number().int(),
29230
+ /** `null` = Auto. Otherwise a `recordings:*` location id. */
29231
+ locationId: string().nullable()
29232
+ });
29233
+ /**
28994
29234
  * Result of locating footage at a wall-clock instant for one device/profile.
28995
29235
  * `segment` carries the covering segment's window; `gap` reports the forward
28996
29236
  * nearest covered edge (`null` past the end of footage / when none exists)
@@ -29204,6 +29444,9 @@ method(object({
29204
29444
  }), method(RelocateResidueInputSchema, RelocateResidueSchema, {
29205
29445
  kind: "query",
29206
29446
  auth: "admin"
29447
+ }), method(LedgerWalkInputSchema, LedgerWalkReportSchema, {
29448
+ kind: "mutation",
29449
+ auth: "admin"
29207
29450
  }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
29208
29451
  kind: "mutation",
29209
29452
  auth: "admin"
@@ -29213,6 +29456,12 @@ method(object({
29213
29456
  }), method(RecordingRebalanceInputSchema, RecordingRebalancePlanSchema, {
29214
29457
  kind: "mutation",
29215
29458
  auth: "admin"
29459
+ }), method(object({}), RecordingPlacementViewSchema, {
29460
+ kind: "query",
29461
+ auth: "admin"
29462
+ }), method(RecordingSetDevicePlacementInputSchema, object({ ok: literal(true) }), {
29463
+ kind: "mutation",
29464
+ auth: "admin"
29216
29465
  });
29217
29466
  /**
29218
29467
  * `recording-export` cap — render a footage time range into a single downloadable
@@ -29595,6 +29844,25 @@ var SceneMonitorStatusSchema = object({
29595
29844
  monitors: array(SceneMonitorSchema),
29596
29845
  lastFetchedAt: number()
29597
29846
  });
29847
+ /**
29848
+ * One camera's row in a `listScenesBatch` answer.
29849
+ *
29850
+ * `status` is NULLABLE and the nullability is the whole point. `scene-monitor`
29851
+ * is a `defaultActive` wrapper, so every camera is asked; a camera whose
29852
+ * provider is absent (pipeline-analytics not deployed, the post-processing node
29853
+ * down) cannot answer, and that is not the same fact as a camera with no scenes
29854
+ * configured. Fanned out per camera the difference was visible — one query
29855
+ * errored while the others resolved — and a batch that returned only the rows
29856
+ * it managed would have destroyed it, silently, by making an unreachable camera
29857
+ * indistinguishable from one that answered `monitors: []`.
29858
+ *
29859
+ * So: EVERY requested deviceId gets a row. `status: null` means "this camera
29860
+ * could not be read"; `status.monitors: []` means "read, and it has none".
29861
+ */
29862
+ var SceneMonitorStatusForDeviceSchema = object({
29863
+ deviceId: number(),
29864
+ status: SceneMonitorStatusSchema.nullable()
29865
+ });
29598
29866
  var sceneMonitorCapability = {
29599
29867
  name: "scene-monitor",
29600
29868
  scope: "device",
@@ -29604,6 +29872,22 @@ var sceneMonitorCapability = {
29604
29872
  deviceTypes: [DeviceType.Camera],
29605
29873
  methods: {
29606
29874
  listScenes: method(object({ deviceId: number() }), SceneMonitorStatusSchema),
29875
+ /**
29876
+ * The same answer, for a SET of cameras, in one round trip.
29877
+ *
29878
+ * `/scenes` renders every camera and re-reads them on a 30s safety-net
29879
+ * poll behind the push slice. Fanned out client-side that was one query
29880
+ * per camera — 29 round trips through the browser, the hub and the
29881
+ * post-analysis runner every 30 seconds to read an in-memory map the
29882
+ * owner had already merged. The work is unchanged (`statusFor` per
29883
+ * device, all in-process at the owner); what collapses is the transport.
29884
+ *
29885
+ * A camera that cannot answer still gets a row, with `status: null` —
29886
+ * see {@link SceneMonitorStatusForDeviceSchema}. Never fewer rows than
29887
+ * ids: a caller that asked for twenty-nine and got twenty-seven cannot
29888
+ * tell which two are missing, or that any are.
29889
+ */
29890
+ listScenesBatch: method(object({ deviceIds: array(number()).min(1).max(200) }), array(SceneMonitorStatusForDeviceSchema).readonly()),
29607
29891
  createScene: method(object({
29608
29892
  deviceId: number(),
29609
29893
  label: string(),
@@ -31637,6 +31921,27 @@ var CameraOccupancySnapshotSchema = object({
31637
31921
  stationaryObjects: array(StationaryObjectSchema).readonly().optional()
31638
31922
  });
31639
31923
  /**
31924
+ * One camera's row in a `getCurrentSnapshotBatch` answer.
31925
+ *
31926
+ * THREE outcomes, and the single-camera method could only express two of them
31927
+ * because `snapshot: null` was already spoken for:
31928
+ *
31929
+ * - `read: 'read'`, `snapshot` present — the live occupancy reading.
31930
+ * - `read: 'read'`, `snapshot: null` — read, and this camera has no reading
31931
+ * yet: no frame since boot, and no parked-object registry to hydrate from.
31932
+ * - `read: 'unreadable'` — the owner could not answer for this
31933
+ * camera. `snapshot` is null, and it does NOT mean "nothing parked here".
31934
+ *
31935
+ * Collapsing the last two is the failure this field exists to prevent: a
31936
+ * hydration that threw would otherwise render as an empty Stationary section,
31937
+ * which is a definite claim about a camera nobody could read.
31938
+ */
31939
+ var CameraOccupancySnapshotForDeviceSchema = object({
31940
+ deviceId: number(),
31941
+ read: _enum(["read", "unreadable"]),
31942
+ snapshot: CameraOccupancySnapshotSchema.nullable()
31943
+ });
31944
+ /**
31640
31945
  * Time-series resolution. The history methods return one bucket per
31641
31946
  * step over the requested range. Smaller resolutions cost more
31642
31947
  * memory + bandwidth; bound to discrete steps so caller cannot ask
@@ -31693,6 +31998,20 @@ var zoneAnalyticsCapability = {
31693
31998
  * (no inference result emitted since boot or since binding was
31694
31999
  * activated). */
31695
32000
  getCurrentSnapshot: method(object({ deviceId: number() }), CameraOccupancySnapshotSchema.nullable()),
32001
+ /**
32002
+ * The same snapshot, for a SET of cameras, in one round trip.
32003
+ *
32004
+ * The Events page's Stationary section polls this every 15s for every
32005
+ * selected camera. Fanned out client-side that is one query per camera to
32006
+ * read a `Map.get` at the owner — the answer costs nothing, the round trip
32007
+ * costs everything. Batched, N transports become one and the per-device
32008
+ * work is unchanged.
32009
+ *
32010
+ * Every requested deviceId gets a row, tagged `read` — see
32011
+ * {@link CameraOccupancySnapshotForDeviceSchema}. A camera the owner could
32012
+ * not answer for is `'unreadable'`, never an empty reading.
32013
+ */
32014
+ getCurrentSnapshotBatch: method(object({ deviceIds: array(number()).min(1).max(200) }), array(CameraOccupancySnapshotForDeviceSchema).readonly()),
31696
32015
  /** Time-series object count inside one zone. `className` optional —
31697
32016
  * omit to count every class in the zone. */
31698
32017
  getZoneHistory: method(object({
@@ -34643,6 +34962,12 @@ Object.freeze({
34643
34962
  addonId: null,
34644
34963
  access: "delete"
34645
34964
  },
34965
+ "deviceManager.renameLocation": {
34966
+ capName: "device-manager",
34967
+ capScope: "system",
34968
+ addonId: null,
34969
+ access: "create"
34970
+ },
34646
34971
  "deviceManager.runDeviceAction": {
34647
34972
  capName: "device-manager",
34648
34973
  capScope: "system",
@@ -36335,13 +36660,19 @@ Object.freeze({
36335
36660
  addonId: null,
36336
36661
  access: "view"
36337
36662
  },
36338
- "pipelineAnalytics.getGroup": {
36663
+ "pipelineAnalytics.getKeyEvents": {
36339
36664
  capName: "pipeline-analytics",
36340
36665
  capScope: "device",
36341
36666
  addonId: null,
36342
36667
  access: "view"
36343
36668
  },
36344
- "pipelineAnalytics.getKeyEvents": {
36669
+ "pipelineAnalytics.getKeyEventsBatch": {
36670
+ capName: "pipeline-analytics",
36671
+ capScope: "device",
36672
+ addonId: null,
36673
+ access: "view"
36674
+ },
36675
+ "pipelineAnalytics.getMediaReclaimStatus": {
36345
36676
  capName: "pipeline-analytics",
36346
36677
  capScope: "device",
36347
36678
  addonId: null,
@@ -36431,12 +36762,6 @@ Object.freeze({
36431
36762
  addonId: null,
36432
36763
  access: "view"
36433
36764
  },
36434
- "pipelineAnalytics.listGroups": {
36435
- capName: "pipeline-analytics",
36436
- capScope: "device",
36437
- addonId: null,
36438
- access: "view"
36439
- },
36440
36765
  "pipelineAnalytics.listOpsLog": {
36441
36766
  capName: "pipeline-analytics",
36442
36767
  capScope: "device",
@@ -36521,6 +36846,12 @@ Object.freeze({
36521
36846
  addonId: null,
36522
36847
  access: "create"
36523
36848
  },
36849
+ "pipelineAnalytics.reclaimDebugMedia": {
36850
+ capName: "pipeline-analytics",
36851
+ capScope: "device",
36852
+ addonId: null,
36853
+ access: "create"
36854
+ },
36524
36855
  "pipelineAnalytics.reconcileFromDisk": {
36525
36856
  capName: "pipeline-analytics",
36526
36857
  capScope: "device",
@@ -37445,6 +37776,12 @@ Object.freeze({
37445
37776
  addonId: null,
37446
37777
  access: "view"
37447
37778
  },
37779
+ "recording.getPlacement": {
37780
+ capName: "recording",
37781
+ capScope: "system",
37782
+ addonId: null,
37783
+ access: "view"
37784
+ },
37448
37785
  "recording.getPlaybackManifest": {
37449
37786
  capName: "recording",
37450
37787
  capScope: "system",
@@ -37523,6 +37860,12 @@ Object.freeze({
37523
37860
  addonId: null,
37524
37861
  access: "view"
37525
37862
  },
37863
+ "recording.reconcileLedgerAgainstDisk": {
37864
+ capName: "recording",
37865
+ capScope: "system",
37866
+ addonId: null,
37867
+ access: "create"
37868
+ },
37526
37869
  "recording.refreshStorageLocationsForMigration": {
37527
37870
  capName: "recording",
37528
37871
  capScope: "system",
@@ -37565,6 +37908,12 @@ Object.freeze({
37565
37908
  addonId: null,
37566
37909
  access: "create"
37567
37910
  },
37911
+ "recording.setDevicePlacement": {
37912
+ capName: "recording",
37913
+ capScope: "system",
37914
+ addonId: null,
37915
+ access: "create"
37916
+ },
37568
37917
  "recording.startStorageMigrationMove": {
37569
37918
  capName: "recording",
37570
37919
  capScope: "system",
@@ -37649,6 +37998,12 @@ Object.freeze({
37649
37998
  addonId: null,
37650
37999
  access: "view"
37651
38000
  },
38001
+ "sceneMonitor.listScenesBatch": {
38002
+ capName: "scene-monitor",
38003
+ capScope: "device",
38004
+ addonId: null,
38005
+ access: "view"
38006
+ },
37652
38007
  "sceneMonitor.recheckNow": {
37653
38008
  capName: "scene-monitor",
37654
38009
  capScope: "device",
@@ -38003,12 +38358,36 @@ Object.freeze({
38003
38358
  addonId: null,
38004
38359
  access: "create"
38005
38360
  },
38361
+ "storageMigration.cleanupCancel": {
38362
+ capName: "storage-migration",
38363
+ capScope: "system",
38364
+ addonId: null,
38365
+ access: "create"
38366
+ },
38367
+ "storageMigration.cleanupStart": {
38368
+ capName: "storage-migration",
38369
+ capScope: "system",
38370
+ addonId: null,
38371
+ access: "create"
38372
+ },
38373
+ "storageMigration.cleanupStatus": {
38374
+ capName: "storage-migration",
38375
+ capScope: "system",
38376
+ addonId: null,
38377
+ access: "view"
38378
+ },
38006
38379
  "storageMigration.drain": {
38007
38380
  capName: "storage-migration",
38008
38381
  capScope: "system",
38009
38382
  addonId: null,
38010
38383
  access: "create"
38011
38384
  },
38385
+ "storageMigration.history": {
38386
+ capName: "storage-migration",
38387
+ capScope: "system",
38388
+ addonId: null,
38389
+ access: "view"
38390
+ },
38012
38391
  "storageMigration.movers": {
38013
38392
  capName: "storage-migration",
38014
38393
  capScope: "system",
@@ -39005,6 +39384,12 @@ Object.freeze({
39005
39384
  addonId: null,
39006
39385
  access: "view"
39007
39386
  },
39387
+ "zoneAnalytics.getCurrentSnapshotBatch": {
39388
+ capName: "zone-analytics",
39389
+ capScope: "device",
39390
+ addonId: null,
39391
+ access: "view"
39392
+ },
39008
39393
  "zoneAnalytics.getUnzonedHistory": {
39009
39394
  capName: "zone-analytics",
39010
39395
  capScope: "device",
@@ -39999,14 +40384,14 @@ Object.freeze({
39999
40384
  form: "single",
40000
40385
  optional: true
40001
40386
  }],
40002
- "pipelineAnalytics.getGroup": [{
40387
+ "pipelineAnalytics.getKeyEvents": [{
40003
40388
  name: "deviceId",
40004
40389
  form: "single",
40005
40390
  optional: false
40006
40391
  }],
40007
- "pipelineAnalytics.getKeyEvents": [{
40008
- name: "deviceId",
40009
- form: "single",
40392
+ "pipelineAnalytics.getKeyEventsBatch": [{
40393
+ name: "deviceIds",
40394
+ form: "array",
40010
40395
  optional: false
40011
40396
  }],
40012
40397
  "pipelineAnalytics.getMotionEvents": [{
@@ -40064,11 +40449,6 @@ Object.freeze({
40064
40449
  form: "single",
40065
40450
  optional: false
40066
40451
  }],
40067
- "pipelineAnalytics.listGroups": [{
40068
- name: "deviceIds",
40069
- form: "array",
40070
- optional: false
40071
- }],
40072
40452
  "pipelineAnalytics.listOpsLog": [{
40073
40453
  name: "deviceId",
40074
40454
  form: "single",
@@ -40114,6 +40494,11 @@ Object.freeze({
40114
40494
  form: "single",
40115
40495
  optional: true
40116
40496
  }],
40497
+ "pipelineAnalytics.reclaimDebugMedia": [{
40498
+ name: "deviceIds",
40499
+ form: "array",
40500
+ optional: true
40501
+ }],
40117
40502
  "pipelineAnalytics.reconcileFromDisk": [{
40118
40503
  name: "deviceId",
40119
40504
  form: "single",
@@ -40449,6 +40834,11 @@ Object.freeze({
40449
40834
  form: "single",
40450
40835
  optional: false
40451
40836
  }],
40837
+ "recording.reconcileLedgerAgainstDisk": [{
40838
+ name: "deviceId",
40839
+ form: "single",
40840
+ optional: true
40841
+ }],
40452
40842
  "recording.relocateFootage": [{
40453
40843
  name: "deviceId",
40454
40844
  form: "single",
@@ -40474,6 +40864,11 @@ Object.freeze({
40474
40864
  form: "single",
40475
40865
  optional: false
40476
40866
  }],
40867
+ "recording.setDevicePlacement": [{
40868
+ name: "deviceId",
40869
+ form: "single",
40870
+ optional: false
40871
+ }],
40477
40872
  "recording.startStorageMigrationMove": [{
40478
40873
  name: "deviceId",
40479
40874
  form: "single",
@@ -40514,6 +40909,11 @@ Object.freeze({
40514
40909
  form: "single",
40515
40910
  optional: false
40516
40911
  }],
40912
+ "sceneMonitor.listScenesBatch": [{
40913
+ name: "deviceIds",
40914
+ form: "array",
40915
+ optional: false
40916
+ }],
40517
40917
  "sceneMonitor.recheckNow": [{
40518
40918
  name: "deviceId",
40519
40919
  form: "single",
@@ -40775,6 +41175,11 @@ Object.freeze({
40775
41175
  form: "single",
40776
41176
  optional: false
40777
41177
  }],
41178
+ "zoneAnalytics.getCurrentSnapshotBatch": [{
41179
+ name: "deviceIds",
41180
+ form: "array",
41181
+ optional: false
41182
+ }],
40778
41183
  "zoneAnalytics.getUnzonedHistory": [{
40779
41184
  name: "deviceId",
40780
41185
  form: "single",