@camstack/addon-pipeline 1.2.288 → 1.2.290

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 (33) hide show
  1. package/dist/audio-analyzer/index.js +2 -2
  2. package/dist/audio-analyzer/index.mjs +2 -2
  3. package/dist/{default-detection-model-DTvsx_iX.mjs → default-detection-model-B64MIW2h.mjs} +1 -1
  4. package/dist/{default-detection-model-D5kMByfZ.js → default-detection-model-CN_Iu8NF.js} +1 -1
  5. package/dist/detection-pipeline/index.js +4 -4
  6. package/dist/detection-pipeline/index.mjs +4 -4
  7. package/dist/{dist-CegiJ2Pw.js → dist-BIlnUdBn.js} +1223 -860
  8. package/dist/{dist-mEtwupOP.mjs → dist-C4JqXCw-.mjs} +1206 -861
  9. package/dist/motion-wasm/index.js +1 -1
  10. package/dist/motion-wasm/index.mjs +1 -1
  11. package/dist/{node-B8p-rV9H.mjs → node-C-WfKJ6b.mjs} +1 -1
  12. package/dist/{node-C8jhiPW2.js → node-CVlJhqng.js} +1 -1
  13. package/dist/pipeline-runner/index.js +3 -3
  14. package/dist/pipeline-runner/index.mjs +3 -3
  15. package/dist/{process-memory-C5bRH8-t.mjs → process-memory-CJKKFNar.mjs} +1 -1
  16. package/dist/{process-memory-lPbJ1ta2.js → process-memory-ZUucMC8Z.js} +1 -1
  17. package/dist/recorder/index.js +7426 -7264
  18. package/dist/recorder/index.mjs +7426 -7264
  19. package/dist/{segment-demux-js-BP5vqRPY.mjs → segment-demux-js-4OAHyQ3t.mjs} +1 -1
  20. package/dist/{segment-demux-js-Dv1EPPdH.js → segment-demux-js-D0mqN4RC.js} +1 -1
  21. package/dist/stream-broker/_stub.js +2 -2
  22. package/dist/stream-broker/{_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-BqjkSRCu.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-r5TULO-I.mjs} +2 -2
  23. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-D7VLO8g1.mjs +26 -0
  24. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-UqRrHdtw.mjs +26 -0
  25. package/dist/stream-broker/demux-worker-child.js +1 -1
  26. package/dist/stream-broker/demux-worker-child.mjs +1 -1
  27. package/dist/stream-broker/{hostInit-C4EuFQ_w.mjs → hostInit-DPdwl8-T.mjs} +2 -2
  28. package/dist/stream-broker/index.js +412 -44
  29. package/dist/stream-broker/index.mjs +412 -44
  30. package/dist/stream-broker/remoteEntry.js +1 -1
  31. package/package.json +5 -3
  32. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-DqcT4fRG.mjs +0 -26
  33. package/dist/stream-broker/_virtual_mf___mfe_internal__addon_stream_broker_widgets__loadShare___mf_0_camstack_mf_1_ui_mf_2_library__loadShare__.js-DCbVs3IC.mjs +0 -26
@@ -5360,7 +5360,7 @@ var ZodIssueCode = {
5360
5360
  var ZodFirstPartyTypeKind;
5361
5361
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5362
5362
  //#endregion
5363
- //#region ../types/dist/sleep-COWaSCAi.mjs
5363
+ //#region ../types/dist/sleep-PEo0-Fz9.mjs
5364
5364
  /**
5365
5365
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5366
5366
  * window to float samples (D455).
@@ -6544,6 +6544,24 @@ function normalizeAddonInitResult(result) {
6544
6544
  if (Array.isArray(result)) return { providers: result };
6545
6545
  return result;
6546
6546
  }
6547
+ /** The wire shape of {@link PeerBytesTicket} — see the type for what it is. */
6548
+ var PeerBytesTicketSchema = object({
6549
+ /** `http://127.0.0.1:<port>/<token>`. One `GET` takes it. */
6550
+ url: string().min(1),
6551
+ /**
6552
+ * The HOST node this URL means something on — the hub or a named agent,
6553
+ * never a runner. {@link AddonPeerBytes.open} compares it to its own and
6554
+ * refuses `cross-node` by name when they differ, without dialling.
6555
+ */
6556
+ hostNodeId: string().min(1),
6557
+ expiresAtMs: number().int().nonnegative(),
6558
+ /**
6559
+ * What the producer DECLARED the body to be, when it knows — `null` when it
6560
+ * does not. Never `0` for unknown (D393): a consumer sizing a bound off this
6561
+ * must be able to tell "the producer did not say" from "the body is empty".
6562
+ */
6563
+ declaredBytes: number().int().nonnegative().nullable()
6564
+ });
6547
6565
  /** Shared Zod schemas used across streaming capabilities. */
6548
6566
  var CamProfileSchema = _enum([
6549
6567
  "high",
@@ -8740,24 +8758,6 @@ object({
8740
8758
  unreachable: number()
8741
8759
  })
8742
8760
  });
8743
- /** The wire shape of {@link PeerBytesTicket} — see the type for what it is. */
8744
- var PeerBytesTicketSchema = object({
8745
- /** `http://127.0.0.1:<port>/<token>`. One `GET` takes it. */
8746
- url: string().min(1),
8747
- /**
8748
- * The HOST node this URL means something on — the hub or a named agent,
8749
- * never a runner. {@link AddonPeerBytes.open} compares it to its own and
8750
- * refuses `cross-node` by name when they differ, without dialling.
8751
- */
8752
- hostNodeId: string().min(1),
8753
- expiresAtMs: number().int().nonnegative(),
8754
- /**
8755
- * What the producer DECLARED the body to be, when it knows — `null` when it
8756
- * does not. Never `0` for unknown (D393): a consumer sizing a bound off this
8757
- * must be able to tell "the producer did not say" from "the body is empty".
8758
- */
8759
- declaredBytes: number().int().nonnegative().nullable()
8760
- });
8761
8761
  /**
8762
8762
  * Adoption job — the background form of `device-adoption.adopt`.
8763
8763
  *
@@ -8869,7 +8869,7 @@ var AdoptionJobSchema = object({
8869
8869
  * component's original options — detection to the detection-pipeline wrapper
8870
8870
  * binding, audio analysis to its own, recording to `RecordingConfig.enabled`
8871
8871
  * (which was always first-class; the switch was a veneer over
8872
- * `recording.setDeviceConfig`), notifications to a notification-center
8872
+ * `recordingArchive.setDeviceConfig`), notifications to a notification-center
8873
8873
  * per-device setting, the two camera planes to their own components.
8874
8874
  *
8875
8875
  * What survives is {@link composeSwitchedOff}: `CameraStatus.switchedOff`, the
@@ -8895,7 +8895,7 @@ var AdoptionJobSchema = object({
8895
8895
  * | `stream-broker` | `deviceManager.setDisabled` | `StreamBrokerManager.reconcileAllCatalogs` releases the brokers; `ensureBroker` refuses re-creation |
8896
8896
  * | `object-detection` | `deviceManager.setWrapperActive('detection-pipeline')` | `PipelineSettingsStore.resolvePipelineForDevice` returns `{ steps: [], audio: null }` |
8897
8897
  * | `audio-analysis` | `deviceManager.setWrapperActive('audio-analysis')` | `AudioSubscriptionController.subscribeAudioStream` returns `null` before opening the stream |
8898
- * | `recording` | `recording.setDeviceConfig` → `RecordingConfig.enabled` | `band-decision.shouldRecord` returns false; the controller detaches the device |
8898
+ * | `recording` | `recordingArchive.setDeviceConfig` → `RecordingConfig.enabled` | `band-decision.shouldRecord` returns false; the controller detaches the device |
8899
8899
  * | `notifications` | `notificationRules.setDeviceMuted` | `NotificationCenter.evaluateAndEnqueue` returns before any rule is evaluated |
8900
8900
  * | `privacy-mask` | `privacyMask.setMask({ enabled })` → the CAMERA | the camera blanks the masked regions itself; every stream and recording carries the black boxes |
8901
8901
  * | `device-audio` | `privacyMask.setAudioEnabled` → the CAMERA | the camera stops encoding an audio track at all; every consumer sees silent video |
@@ -13610,58 +13610,6 @@ method(ListInputSchema, array(BrokerInfoSchema$1)), method(GetInputSchema, Broke
13610
13610
  auth: "admin"
13611
13611
  }), method(GetStateInputSchema, unknown().nullable()), method(_void(), RegistryStatusSchema);
13612
13612
  DeviceType.Camera;
13613
- /**
13614
- * The signals a device can emit to WAKE its own stream.
13615
- *
13616
- * A camera whose stream is built on demand sleeps until something asks for it,
13617
- * and "something" cannot be a consumer that is merely attached — a Frigate-style
13618
- * puller holds a session open for ever, and treating that as demand would keep
13619
- * a battery camera awake for ever, which is the whole thing the battery is for
13620
- * (D173). So the wake has to come from the CAMERA: an event it noticed by
13621
- * itself, with no stream running.
13622
- *
13623
- * ## The vocabulary is the PROVIDER'S, not ours
13624
- *
13625
- * Like `consumables`, this cap declares no vocabulary of its own. A provider
13626
- * names each signal with a `code` it chooses and a `label` an operator reads.
13627
- * Reolink offers motion and camera-native detection; another provider may offer
13628
- * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
13629
- * yet. A fixed enum here would mean every new signal is a framework release.
13630
- *
13631
- * It is deliberately NOT derived from the caps a device already binds. Whether
13632
- * a camera CAN push firmware motion is expressed by `motionSources` containing
13633
- * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
13634
- * binding — but both answer "what drives the detection pipeline", which is a
13635
- * different question from "what may wake a sleeping stream". A camera can do
13636
- * the first and not be trusted with the second, and the operator picks per
13637
- * camera. Two questions, two authorities.
13638
- *
13639
- * ## Availability is not permission
13640
- *
13641
- * `listSignals` says what the device CAN emit. Whether a given signal actually
13642
- * wakes the stream is the operator's per-camera choice, held by the broker
13643
- * alongside the cooldown — see the stream-broker cap's wake settings. A
13644
- * provider declaring a signal is not a provider enabling it.
13645
- */
13646
- /** One signal a device can emit. */
13647
- var StreamSignalSchema = object({
13648
- /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
13649
- code: string().min(1),
13650
- /** What an operator reads in the picker. The provider's own wording. */
13651
- label: string().min(1),
13652
- /**
13653
- * Whether the provider recommends this signal ON when a camera is first set
13654
- * up. A provider knows which of its signals are cheap and reliable; an
13655
- * operator should not have to discover that by trial. Reolink recommends
13656
- * both of its own.
13657
- */
13658
- recommended: boolean()
13659
- });
13660
- object({
13661
- signals: array(StreamSignalSchema),
13662
- lastFetchedAt: number()
13663
- });
13664
- Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
13665
13613
  /** Stream delivery format. (Relocated from the retired `streaming-engine` cap.) */
13666
13614
  var StreamFormatSchema = _enum([
13667
13615
  "webrtc",
@@ -15410,6 +15358,97 @@ var detectionPipelineCapability = {
15410
15358
  methods: {}
15411
15359
  };
15412
15360
  /**
15361
+ * device-admin-link — "this device has a management page of its own, and here
15362
+ * is its address".
15363
+ *
15364
+ * ## Why this is not a `deviceConfig` cap
15365
+ *
15366
+ * There is nothing to edit. A `deviceConfig` cap (D14) exists so the framework
15367
+ * can DERIVE a settings form from `getOptions` + `getStatus` and route a flat
15368
+ * patch back through a setter; it costs a `builderId` reducer in
15369
+ * `device-config-contribution.ts` and a `*-config-schema.ts` beside it, and it
15370
+ * renders a form section. This cap answers ONE question with ONE read and
15371
+ * renders a button. Nothing about it is a form, so it carries no `deviceConfig`
15372
+ * block, no `settings`, no `runtimeState` and no reducer — exactly like
15373
+ * `reboot`, the other pure-RPC device-native cap.
15374
+ *
15375
+ * ## Absent, and the difference between "no page" and "we cannot say"
15376
+ *
15377
+ * The two are answered at DIFFERENT layers, on purpose:
15378
+ *
15379
+ * - **"We cannot say"** → the provider never registers the cap for that
15380
+ * device. A VeSync humidifier, a Petkit feeder, a Dreame vacuum and a Dreo
15381
+ * fan are reached only through a vendor cloud; there is no address to hand
15382
+ * out and no page to open. A Tuya plug, a Wyze camera and a Gree air
15383
+ * conditioner DO have a LAN IP, and still have no HTTP management page
15384
+ * behind it. None of them register, so `deviceManager.getBindings` never
15385
+ * lists the cap and no surface asks.
15386
+ * - **"This device has no page, and I know that"** → the provider registers
15387
+ * and `getAdminLink` returns `null`. This is the answer for a device whose
15388
+ * sibling DOES have a page: a Reolink battery camera reached over UDP by
15389
+ * `uid` with a blank `host`, an Ecowitt gateway configured in `listener`
15390
+ * transport, a Home Assistant broker authenticated by supervisor token
15391
+ * (which carries no `baseUrl` at all).
15392
+ *
15393
+ * Both draw NOTHING. A button that opens a browser error is worse than no
15394
+ * button, and D62 is the same rule from the other side: an off switch is
15395
+ * reported off, never made to look broken. There is no third state where the
15396
+ * UI renders a disabled button "because the device might have a page".
15397
+ *
15398
+ * ## The URL never carries credentials
15399
+ *
15400
+ * Not in userinfo, not in a query string. Every provider builds through
15401
+ * `buildDeviceAdminUrl` (`device-admin-link-url.ts`), which takes host, port,
15402
+ * scheme and path as separate arguments — there is no parameter a secret could
15403
+ * arrive in — and re-checks its own output for the `scheme://user:pass@` shape
15404
+ * that `scripts/check-no-credential-urls-in-fixtures.ts` bans from recorded
15405
+ * output. `scripts/check-admin-link-builder-is-the-only-url-source.ts` is what
15406
+ * keeps providers from hand-rolling one anyway.
15407
+ *
15408
+ * This matters here more than anywhere else in the repo, because every provider
15409
+ * that knows a device's host knows its PASSWORD too: `{ host, port, username,
15410
+ * password }` sit in one object on Hikvision, Amcrest, Reolink and ONVIF alike,
15411
+ * and `http://admin:hunter2@192.168.50.139/` is a URL a browser accepts. The
15412
+ * camera's own page will ask for its own login. That is correct, and pre-
15413
+ * filling it is the operator's business, not ours.
15414
+ *
15415
+ * ## It is a LAN fact
15416
+ *
15417
+ * The URL addresses the device where the NODE can see it. It is not proxied,
15418
+ * not made reachable from outside, and not sent anywhere. A surface renders it
15419
+ * as a link the operator's own browser follows, on the operator's own network,
15420
+ * or renders nothing.
15421
+ */
15422
+ /**
15423
+ * Whose page is it. The distinction is for the OPERATOR, who needs to know
15424
+ * before clicking whether he is about to land on a camera's own web server or
15425
+ * inside Home Assistant.
15426
+ */
15427
+ var AdminLinkTargetEnum = _enum(["device", "integration"]);
15428
+ var DeviceAdminLinkSchema = object({
15429
+ /**
15430
+ * Absolute `http(s)://` URL. Built by `buildDeviceAdminUrl` and therefore
15431
+ * free of userinfo and of any credential-shaped query key.
15432
+ */
15433
+ url: string(),
15434
+ /**
15435
+ * What the surface calls it — "Web UI", "Home Assistant", "UniFi controller".
15436
+ * The PROVIDER names it, because only the provider knows what the page is;
15437
+ * a UI that invented the label from the addon id would call the Home
15438
+ * Assistant device page "Provider Homeassistant".
15439
+ */
15440
+ label: string(),
15441
+ target: AdminLinkTargetEnum,
15442
+ /**
15443
+ * Host the URL points at, without scheme, port or path — for the tooltip, so
15444
+ * an operator can see WHERE the button goes before he follows it. Redundant
15445
+ * with `url` by construction; carried separately so no surface has to parse
15446
+ * a URL to show it.
15447
+ */
15448
+ host: string()
15449
+ });
15450
+ method(object({ deviceId: number().int().nonnegative() }), DeviceAdminLinkSchema.nullable(), { auth: "admin" });
15451
+ /**
15413
15452
  * Identity envelope for a device's upstream-system metadata.
15414
15453
  *
15415
15454
  * Two jobs:
@@ -15737,97 +15776,6 @@ method(object({ integrationId: string() }), object({ filters: array(AdoptionFilt
15737
15776
  auth: "admin"
15738
15777
  });
15739
15778
  /**
15740
- * device-admin-link — "this device has a management page of its own, and here
15741
- * is its address".
15742
- *
15743
- * ## Why this is not a `deviceConfig` cap
15744
- *
15745
- * There is nothing to edit. A `deviceConfig` cap (D14) exists so the framework
15746
- * can DERIVE a settings form from `getOptions` + `getStatus` and route a flat
15747
- * patch back through a setter; it costs a `builderId` reducer in
15748
- * `device-config-contribution.ts` and a `*-config-schema.ts` beside it, and it
15749
- * renders a form section. This cap answers ONE question with ONE read and
15750
- * renders a button. Nothing about it is a form, so it carries no `deviceConfig`
15751
- * block, no `settings`, no `runtimeState` and no reducer — exactly like
15752
- * `reboot`, the other pure-RPC device-native cap.
15753
- *
15754
- * ## Absent, and the difference between "no page" and "we cannot say"
15755
- *
15756
- * The two are answered at DIFFERENT layers, on purpose:
15757
- *
15758
- * - **"We cannot say"** → the provider never registers the cap for that
15759
- * device. A VeSync humidifier, a Petkit feeder, a Dreame vacuum and a Dreo
15760
- * fan are reached only through a vendor cloud; there is no address to hand
15761
- * out and no page to open. A Tuya plug, a Wyze camera and a Gree air
15762
- * conditioner DO have a LAN IP, and still have no HTTP management page
15763
- * behind it. None of them register, so `deviceManager.getBindings` never
15764
- * lists the cap and no surface asks.
15765
- * - **"This device has no page, and I know that"** → the provider registers
15766
- * and `getAdminLink` returns `null`. This is the answer for a device whose
15767
- * sibling DOES have a page: a Reolink battery camera reached over UDP by
15768
- * `uid` with a blank `host`, an Ecowitt gateway configured in `listener`
15769
- * transport, a Home Assistant broker authenticated by supervisor token
15770
- * (which carries no `baseUrl` at all).
15771
- *
15772
- * Both draw NOTHING. A button that opens a browser error is worse than no
15773
- * button, and D62 is the same rule from the other side: an off switch is
15774
- * reported off, never made to look broken. There is no third state where the
15775
- * UI renders a disabled button "because the device might have a page".
15776
- *
15777
- * ## The URL never carries credentials
15778
- *
15779
- * Not in userinfo, not in a query string. Every provider builds through
15780
- * `buildDeviceAdminUrl` (`device-admin-link-url.ts`), which takes host, port,
15781
- * scheme and path as separate arguments — there is no parameter a secret could
15782
- * arrive in — and re-checks its own output for the `scheme://user:pass@` shape
15783
- * that `scripts/check-no-credential-urls-in-fixtures.ts` bans from recorded
15784
- * output. `scripts/check-admin-link-builder-is-the-only-url-source.ts` is what
15785
- * keeps providers from hand-rolling one anyway.
15786
- *
15787
- * This matters here more than anywhere else in the repo, because every provider
15788
- * that knows a device's host knows its PASSWORD too: `{ host, port, username,
15789
- * password }` sit in one object on Hikvision, Amcrest, Reolink and ONVIF alike,
15790
- * and `http://admin:hunter2@192.168.50.139/` is a URL a browser accepts. The
15791
- * camera's own page will ask for its own login. That is correct, and pre-
15792
- * filling it is the operator's business, not ours.
15793
- *
15794
- * ## It is a LAN fact
15795
- *
15796
- * The URL addresses the device where the NODE can see it. It is not proxied,
15797
- * not made reachable from outside, and not sent anywhere. A surface renders it
15798
- * as a link the operator's own browser follows, on the operator's own network,
15799
- * or renders nothing.
15800
- */
15801
- /**
15802
- * Whose page is it. The distinction is for the OPERATOR, who needs to know
15803
- * before clicking whether he is about to land on a camera's own web server or
15804
- * inside Home Assistant.
15805
- */
15806
- var AdminLinkTargetEnum = _enum(["device", "integration"]);
15807
- var DeviceAdminLinkSchema = object({
15808
- /**
15809
- * Absolute `http(s)://` URL. Built by `buildDeviceAdminUrl` and therefore
15810
- * free of userinfo and of any credential-shaped query key.
15811
- */
15812
- url: string(),
15813
- /**
15814
- * What the surface calls it — "Web UI", "Home Assistant", "UniFi controller".
15815
- * The PROVIDER names it, because only the provider knows what the page is;
15816
- * a UI that invented the label from the addon id would call the Home
15817
- * Assistant device page "Provider Homeassistant".
15818
- */
15819
- label: string(),
15820
- target: AdminLinkTargetEnum,
15821
- /**
15822
- * Host the URL points at, without scheme, port or path — for the tooltip, so
15823
- * an operator can see WHERE the button goes before he follows it. Redundant
15824
- * with `url` by construction; carried separately so no surface has to parse
15825
- * a URL to show it.
15826
- */
15827
- host: string()
15828
- });
15829
- method(object({ deviceId: number().int().nonnegative() }), DeviceAdminLinkSchema.nullable(), { auth: "admin" });
15830
- /**
15831
15779
  * `device-export` — collection cap for addons that export camstack
15832
15780
  * devices to external ecosystems (HomeAssistant via MQTT discovery,
15833
15781
  * HomeKit/HAP, Alexa Smart Home, …).
@@ -26762,6 +26710,58 @@ method(_void(), ProviderInfoSchema, { auth: "admin" }), method(object({ config:
26762
26710
  kind: "mutation",
26763
26711
  auth: "admin"
26764
26712
  });
26713
+ /**
26714
+ * The signals a device can emit to WAKE its own stream.
26715
+ *
26716
+ * A camera whose stream is built on demand sleeps until something asks for it,
26717
+ * and "something" cannot be a consumer that is merely attached — a Frigate-style
26718
+ * puller holds a session open for ever, and treating that as demand would keep
26719
+ * a battery camera awake for ever, which is the whole thing the battery is for
26720
+ * (D173). So the wake has to come from the CAMERA: an event it noticed by
26721
+ * itself, with no stream running.
26722
+ *
26723
+ * ## The vocabulary is the PROVIDER'S, not ours
26724
+ *
26725
+ * Like `consumables`, this cap declares no vocabulary of its own. A provider
26726
+ * names each signal with a `code` it chooses and a `label` an operator reads.
26727
+ * Reolink offers motion and camera-native detection; another provider may offer
26728
+ * a tamper, a doorbell press, a PIR, or something no camera in this fleet has
26729
+ * yet. A fixed enum here would mean every new signal is a framework release.
26730
+ *
26731
+ * It is deliberately NOT derived from the caps a device already binds. Whether
26732
+ * a camera CAN push firmware motion is expressed by `motionSources` containing
26733
+ * `'onboard'`, and whether it does AI on-camera by the `native-object-detection`
26734
+ * binding — but both answer "what drives the detection pipeline", which is a
26735
+ * different question from "what may wake a sleeping stream". A camera can do
26736
+ * the first and not be trusted with the second, and the operator picks per
26737
+ * camera. Two questions, two authorities.
26738
+ *
26739
+ * ## Availability is not permission
26740
+ *
26741
+ * `listSignals` says what the device CAN emit. Whether a given signal actually
26742
+ * wakes the stream is the operator's per-camera choice, held by the broker
26743
+ * alongside the cooldown — see the stream-broker cap's wake settings. A
26744
+ * provider declaring a signal is not a provider enabling it.
26745
+ */
26746
+ /** One signal a device can emit. */
26747
+ var StreamSignalSchema = object({
26748
+ /** Stable id chosen by the provider, e.g. `'motion'`, `'person'`, `'tamper'`. */
26749
+ code: string().min(1),
26750
+ /** What an operator reads in the picker. The provider's own wording. */
26751
+ label: string().min(1),
26752
+ /**
26753
+ * Whether the provider recommends this signal ON when a camera is first set
26754
+ * up. A provider knows which of its signals are cheap and reliable; an
26755
+ * operator should not have to discover that by trial. Reolink recommends
26756
+ * both of its own.
26757
+ */
26758
+ recommended: boolean()
26759
+ });
26760
+ object({
26761
+ signals: array(StreamSignalSchema),
26762
+ lastFetchedAt: number()
26763
+ });
26764
+ Object.values(DeviceType), method(_void(), array(StreamSignalSchema).readonly());
26765
26765
  /** Profile-exported FormBuilder schema. Shape is ConfigUISchema at the UI. */
26766
26766
  var ProfileSettingsSchemaBridge = unknown().nullable();
26767
26767
  var ProfileSettingsBagSchema = record(string(), unknown());
@@ -27745,25 +27745,44 @@ var ClipStreamDialSchema = object({
27745
27745
  audioReason: ClipStreamAudioReasonSchema.optional()
27746
27746
  });
27747
27747
  /**
27748
- * The playback rates a clip can be DELIVERED at, ascending, always with `1`.
27748
+ * The playback rates the broker can pace over media it HOLDS, ascending,
27749
+ * always with `1` — and the WIDEST ladder there is. It is the domain the
27750
+ * broker's `clampPlaybackRate` is derived from, at both ends.
27749
27751
  *
27750
27752
  * These are the BROKER's: it re-paces frames it has already demuxed — the
27751
27753
  * `MonotonicClock` divides source elapsed time by the factor and the pacer
27752
- * pushes that much faster — so the domain is the recorded one, {0} ∪ [0.25, 4],
27753
- * and this is the discrete ladder drawn from it. `1.5` is in it because a
27754
- * re-pacer has no reason to refuse it.
27755
- *
27756
- * `8` and `16` are deliberately NOT here. They are the CAMERA's own
27757
- * `<playSpeed>` (Reolink cmd-5 replay), a different mechanism, still unwired
27758
- * (D597, D600) — a rate change there costs a new dial and a new stream, and
27759
- * the camera's 8x would need a resample the clip audio path has no decoder
27760
- * for. Offering them today accepts a rate and delivers 1x, which is the whole
27761
- * defect this list exists to end (D612). When `playSpeed` IS wired its rates
27762
- * join THIS array — a second list elsewhere is the second authority D62
27763
- * forbids.
27764
- *
27765
- * Every entry must survive the broker's `clampPlaybackRate` unchanged: a set
27766
- * that offers what the clamp then moves is the same lie one step later.
27754
+ * pushes that much faster. `1.5` is in it because a re-pacer has no reason to
27755
+ * refuse it.
27756
+ *
27757
+ * **`8` is here since D621, and it is the pacer's, not a camera's.** D620
27758
+ * measured the thing that was assumed for a year and was never true: a
27759
+ * Reolink `<playSpeed>` does not time-compress anything. At 1, 2, 4 and 8 the
27760
+ * transfer is byte-identical — same 947 472 bytes, same 594 access units,
27761
+ * same 39.855 s presentation span, same 624 AAC frames — and only the wall
27762
+ * clock moves. It buys SUPPLY, never speed. So there was never a second
27763
+ * mechanism to wire for 8×: there is one, this one, and what it needs is
27764
+ * media in hand and a clamp that does not move the number.
27765
+ *
27766
+ * **`16` is deliberately NOT here, and will not join by widening this array.**
27767
+ * The camera's `playSpeed 16` is not a rate at all but an I-frame-only MODE —
27768
+ * measured on 592: 10 access units for a whole 36.3 s sub clip, 20 for the
27769
+ * main twin at a 2 025 ms median spacing, and no audio track. That is
27770
+ * different CONTENT, a stream of its own, and the honest broker-side twin of
27771
+ * it would be a pacer that DROPS whole GOPs rather than one that pushes 16×
27772
+ * the bitrate at a live WebRTC track. Neither exists. A `16` in this array
27773
+ * today would be a rate accepted and delivered at 8 — D612's defect, which
27774
+ * this list exists to end, one number further along.
27775
+ *
27776
+ * Every entry must survive the broker's `clampPlaybackRate` unchanged. Since
27777
+ * D621 that is structural rather than a discipline: the clamp reads this
27778
+ * array's own ends. What still has to be proved behaviourally — and is, in
27779
+ * the broker's `clip-stream-feeder.spec` — is that the PACER really empties a
27780
+ * clip `rate` times faster, because a clamp agreeing with a ladder is a
27781
+ * constant compared against itself.
27782
+ *
27783
+ * Narrower ladders exist for transports whose SUPPLY is bounded; they are
27784
+ * subsets of this one ({@link CLIP_STREAM_SOURCE_RATES},
27785
+ * {@link CLIP_REALTIME_SOURCE_RATES}).
27767
27786
  */
27768
27787
  var CLIP_BROKER_PACED_RATES = [
27769
27788
  .25,
@@ -27771,7 +27790,8 @@ var CLIP_BROKER_PACED_RATES = [
27771
27790
  1,
27772
27791
  1.5,
27773
27792
  2,
27774
- 4
27793
+ 4,
27794
+ 8
27775
27795
  ];
27776
27796
  /**
27777
27797
  * What a surface may DRAW for this provider's clips — the answer to
@@ -29442,6 +29462,143 @@ DeviceType.Camera, method(object({ deviceId: number() }), CameraCredentialsSchem
29442
29462
  kind: "query",
29443
29463
  auth: "admin"
29444
29464
  });
29465
+ /**
29466
+ * camera-grid-layout — the geometry of a COMPOSITE camera, on the camera's own
29467
+ * page.
29468
+ *
29469
+ * ## Why this is a capability and not an addon settings schema
29470
+ *
29471
+ * It was one, and it did not render. The addon declared the editor as a
29472
+ * `type: 'widget'` field inside its own `deviceSettingsSchema()`; the hub
29473
+ * returned that section correctly and `ConfigFormField` renders `type:'widget'`
29474
+ * perfectly well — and nothing ever asked camera-grid for it. The Cluster →
29475
+ * Pipeline → Device Overrides page interrogates a HAND-WRITTEN list of four
29476
+ * addons (`PIPELINE_CLUSTER_DEVICE_ADDONS`), whose own comment says an addon
29477
+ * not on it "falls off silently".
29478
+ *
29479
+ * Adding a fifth name to that list would have been the wrong fix twice over:
29480
+ * that page is per-camera DETECTION tuning, and a grid's geometry belongs
29481
+ * beside PTZ and motion zones on the camera itself. The device page is
29482
+ * BINDING-driven (D12), so the way in is a capability bound to the device —
29483
+ * and this cap carries its section the way `recording` does, by RETURNING it
29484
+ * from `getDeviceSettingsContribution`.
29485
+ *
29486
+ * Seven other widgets are still declared the other way, through a
29487
+ * `deviceConfig.ui` block the framework derives a section from. That route
29488
+ * gives the addon no say in where its own panel lands and no way to decline
29489
+ * for a device the panel does not suit, which is why this one does not use it.
29490
+ *
29491
+ * ## Why one addon may implement it
29492
+ *
29493
+ * It is a device-scoped NATIVE cap, registered by the grid camera device
29494
+ * itself. Nothing else declares a composite camera, so nothing else has a
29495
+ * layout — and the device-scoped route means the widget asks THE camera, not
29496
+ * "the camera-grid addon", which is what let the old custom-action pair be
29497
+ * reached only by a caller that already knew the addon id.
29498
+ *
29499
+ * ## The tab
29500
+ *
29501
+ * `streaming`, not a top-tab of its own. A grid's geometry IS what its stream
29502
+ * is, so the Streaming tab is where it belongs; a `grid` top-tab would need an
29503
+ * entry in `WELL_KNOWN_TAB_MAP` or the device page renders the raw id as the
29504
+ * label (measured on the robot camera, 2026-09-06 — a tab called "navigation"
29505
+ * next to "PTZ").
29506
+ */
29507
+ /** A rectangle in normalized [0,1] coordinates of whatever contains it. */
29508
+ var GridNormalizedRectSchema = object({
29509
+ x: number().min(0).max(1),
29510
+ y: number().min(0).max(1),
29511
+ width: number().gt(0).max(1),
29512
+ height: number().gt(0).max(1)
29513
+ });
29514
+ /**
29515
+ * One source camera, the part of its picture taken, and where that part lands.
29516
+ *
29517
+ * Both rectangles are NORMALIZED (D519): a source camera can change resolution
29518
+ * — a profile switch, a firmware update, a substream that comes back different
29519
+ * — and a stored PIXEL rectangle would quietly start cutting the wrong region,
29520
+ * which is the class of bug nobody files.
29521
+ */
29522
+ var GridLayoutCellSchema = object({
29523
+ deviceId: number().int().positive(),
29524
+ /** The part of the SOURCE taken, normalized against the source. */
29525
+ source: GridNormalizedRectSchema,
29526
+ /** Where it lands, normalized against the CANVAS. */
29527
+ cell: GridNormalizedRectSchema
29528
+ });
29529
+ /**
29530
+ * Which profiles this grid can actually compose, and why not.
29531
+ *
29532
+ * A grid's `high` composes its sources' `high` and its `low` their `low`, so a
29533
+ * profile is on offer only when EVERY source can serve it. The refusal NAMES
29534
+ * the sources, because "this grid has no low" is not a finding — "615 has no
29535
+ * low" is, and it is the one an operator can act on.
29536
+ */
29537
+ var GridProfileOfferSchema = object({
29538
+ profile: _enum([
29539
+ "high",
29540
+ "mid",
29541
+ "low"
29542
+ ]),
29543
+ offered: boolean(),
29544
+ /** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
29545
+ missingSources: array(number().int().positive()),
29546
+ /**
29547
+ * The canvas this profile composes onto, `WxH`, or empty when it is not
29548
+ * offered. DERIVED from the cells and the sources' own size at this profile —
29549
+ * it is reported because nothing else in the system would ever say what the
29550
+ * grid came out as, and because it is the number an operator would otherwise
29551
+ * expect to type.
29552
+ */
29553
+ canvas: string(),
29554
+ /**
29555
+ * Whether this profile is PUBLISHED, of the ones the grid could serve.
29556
+ *
29557
+ * A grid's `high` is composed of its sources' `high`, so on a 4K fleet it is
29558
+ * a 4K canvas built from 4K decodes — something to opt into, not something a
29559
+ * viewer's adaptive should be handed by climbing to the top rung it can see.
29560
+ * Default is `mid` + `low`.
29561
+ */
29562
+ published: boolean()
29563
+ });
29564
+ var GridLayoutViewSchema = object({
29565
+ /** The persisted grid row this camera was declared from. */
29566
+ instanceId: string(),
29567
+ deviceId: number().int().nonnegative(),
29568
+ name: string(),
29569
+ /**
29570
+ * NO canvas size. A grid's resolution is not authored: each profile derives
29571
+ * its own from the cells and its sources' dimensions. The two numbers that
29572
+ * used to be here were a text field that silently decided both how much the
29573
+ * composite cost and how sharp it was — see `profiles[].canvas` for what it
29574
+ * came out as.
29575
+ */
29576
+ fps: number().int(),
29577
+ cells: array(GridLayoutCellSchema),
29578
+ /** What the catalog will publish, and what it refuses to. Read-only. */
29579
+ profiles: array(GridProfileOfferSchema)
29580
+ });
29581
+ var GridLayoutPatchSchema = object({
29582
+ deviceId: number().int().nonnegative(),
29583
+ name: string().min(1).max(160).optional(),
29584
+ fps: number().int().min(1).max(60).optional(),
29585
+ /** Which profiles to publish. See `GridProfileOffer.published`. */
29586
+ publishedProfiles: array(_enum([
29587
+ "high",
29588
+ "mid",
29589
+ "low"
29590
+ ])).max(3).optional(),
29591
+ /**
29592
+ * The whole cell list at once. A per-cell patch would need an ordering the
29593
+ * editor does not have, and a half-applied layout is a picture nobody asked
29594
+ * for.
29595
+ */
29596
+ cells: array(GridLayoutCellSchema).max(16)
29597
+ });
29598
+ DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), GridLayoutViewSchema.nullable(), { auth: "admin" }), method(GridLayoutPatchSchema, GridLayoutViewSchema, {
29599
+ kind: "mutation",
29600
+ auth: "admin"
29601
+ });
29445
29602
  object({
29446
29603
  detected: boolean(),
29447
29604
  /** Ms epoch of the last transition. 0 if never observed. */
@@ -29915,307 +30072,6 @@ DeviceType.Camera, method(object({ deviceId: number() }), DayNightOptionsSchema)
29915
30072
  auth: "admin"
29916
30073
  });
29917
30074
  /**
29918
- * Vendor-neutral **onboard** recording + storage cap — what the CAMERA
29919
- * writes to the CAMERA's own card, on the camera's own schedule.
29920
- *
29921
- * This is NOT `recording.cap.ts`. That one is CamStack's recorder: our
29922
- * footage ledger, our storage locations, our retention. This one has a
29923
- * different authority — the camera's firmware — and per D62 it stores
29924
- * nothing of its own. Every value here is read from the camera and every
29925
- * write goes back to the camera; there is no CamStack-side mirror that
29926
- * could disagree with the device.
29927
- *
29928
- * ## One shape, two firmwares
29929
- *
29930
- * Measured 2026-09-22 against the live fleet:
29931
- *
29932
- * | fact | Hikvision (ISAPI) | Reolink (Baichuan) |
29933
- * | --- | --- | --- |
29934
- * | storage | `ContentMgmt/Storage` `<hdd>` rows: status, capacity, freeSpace (MB) | `getHddInfoList` (cmd 102): `mount`, `format`, `capacity` GB + `capacityM` MB remainder |
29935
- * | tracks | several (101 **and** 103 on both 1436 and 3833), each with its own schedule | one per channel |
29936
- * | schedule | per track, 7 `ScheduleAction` blocks: DayOfWeek + TimeOfDay range + ONE `ActionRecordingMode` | per trigger type, a 168-char weekly HOUR mask |
29937
- * | triggers | `CMR`, `MOTION` | `Normal`, `MD`, `people`, `vehicle`, `dog_cat`, `crossline`, `intrude`, `loitering` |
29938
- * | pre-record | `PreRecordTimeSeconds` | `preRecordTime` |
29939
- * | post-record | `PostRecordTimeSeconds` | `recordDelayTime` |
29940
- * | overwrite | per track `LoopEnable` | `cycle`, with `cycleList` enumerating the accepted values |
29941
- * | segment length | not exposed on V5.7.1 | `packageTime` (minutes) |
29942
- *
29943
- * The two schedule models look different and are the same thing in
29944
- * different coordinates: both answer "for this trigger, during which
29945
- * weekly windows does the camera record". {@link RecordWindow} is that
29946
- * question in one shape — Hikvision's ranges map straight onto it,
29947
- * Reolink's mask expands into hour-aligned windows.
29948
- *
29949
- * ## Union, not intersection
29950
- *
29951
- * **The same fields exist on every camera.** What differs per device is
29952
- * which VALUES that device accepts, and that is what {@link
29953
- * RecordingOnboardOptions} reports — a `{ readable, writable, reason }`
29954
- * per field plus the schedule's own limits. A control a camera cannot
29955
- * honour is rendered DISABLED WITH ITS REASON, never missing and never
29956
- * dead: disabled must not look like broken.
29957
- *
29958
- * ## Refusal by name
29959
- *
29960
- * A write a camera cannot honour is refused with a sentence the operator
29961
- * can read — never accepted and dropped. Both providers refuse through
29962
- * {@link describeOnboardRefusal}, so the vocabulary is one function and
29963
- * one test, not two hand-written vendor opinions.
29964
- *
29965
- * Follows the D14 `deviceConfig` archetype (see `stream-params.cap.ts`):
29966
- * `getOptions` advertises per-camera availability, `getStatus` (auto-
29967
- * injected from `status`) reports the live values, and a single
29968
- * `setSettings` mutation applies a partial change. No hand-written
29969
- * settings-contribution methods.
29970
- */
29971
- /**
29972
- * What makes the camera start recording during a window.
29973
- *
29974
- * The union of both vendors' vocabularies. `continuous` is Hikvision's
29975
- * `CMR` and Reolink's `Normal`; `motion` is `MOTION` / `MD`. The
29976
- * object-class triggers are Reolink-only today and the smart-event ones
29977
- * (`lineCrossing`, `intrusion`, `loitering`) are Reolink-only on the
29978
- * firmwares measured — a camera that cannot record on a trigger simply
29979
- * does not list it in `options.schedule.triggers`, and a window naming
29980
- * it is REFUSED, not dropped.
29981
- */
29982
- var RecordTriggerSchema = _enum([
29983
- "continuous",
29984
- "motion",
29985
- "person",
29986
- "vehicle",
29987
- "animal",
29988
- "lineCrossing",
29989
- "intrusion",
29990
- "loitering",
29991
- "alarmInput"
29992
- ]);
29993
- /**
29994
- * One weekly recording window: "on `day`, from `startMinute` to
29995
- * `endMinute`, record on `trigger`".
29996
- *
29997
- * `day` is 0 = Monday … 6 = Sunday (ISO order, which is also the order
29998
- * both firmwares enumerate). Minutes are local camera time since
29999
- * midnight; `endMinute` may be 1440, meaning end of day — that is
30000
- * Hikvision's literal `24:00` and Reolink's 24th mask slot, and
30001
- * collapsing it to 0 would turn a whole-day window into an empty one.
30002
- */
30003
- var RecordWindowSchema = object({
30004
- trigger: RecordTriggerSchema,
30005
- day: number().int().min(0).max(6),
30006
- startMinute: number().int().min(0).max(1439),
30007
- endMinute: number().int().min(1).max(1440)
30008
- });
30009
- /** Status of one physical volume, as the camera itself describes it. */
30010
- var OnboardStorageVolumeSchema = object({
30011
- /** The camera's own id for the volume (`hdd/id`, Reolink `HddInfo/number`). */
30012
- id: string(),
30013
- /** The camera's own name for it, when it gives one (`hddName`). */
30014
- label: string().optional(),
30015
- status: _enum([
30016
- "ok",
30017
- "unformatted",
30018
- "error",
30019
- "offline",
30020
- "unknown"
30021
- ]),
30022
- /**
30023
- * Total size in MB, or **null when the camera did not say**.
30024
- *
30025
- * Never 0 for an unreadable value: a measurement that failed is not a
30026
- * measurement (D393), and a card whose size is unknown must not be
30027
- * rendered as a card of size zero.
30028
- */
30029
- capacityMb: number().nullable(),
30030
- /**
30031
- * Free space in MB, or null when unknown.
30032
- *
30033
- * **Not a proxy for "has footage".** Measured 2026-09-22: 1436 and
30034
- * 1439 both report exactly 11776 MB free — the fixed reserve a looping
30035
- * card converges on once it has wrapped. At loop steady state the
30036
- * number is identical whether the camera recorded yesterday or stopped
30037
- * a month ago.
30038
- */
30039
- freeMb: number().nullable(),
30040
- /** True when the camera reports the volume writable (`property` RW). */
30041
- writable: boolean().optional()
30042
- });
30043
- object({
30044
- storage: discriminatedUnion("kind", [
30045
- object({
30046
- kind: literal("present"),
30047
- volumes: array(OnboardStorageVolumeSchema)
30048
- }),
30049
- object({
30050
- kind: literal("absent"),
30051
- reason: string()
30052
- }),
30053
- object({
30054
- kind: literal("unknown"),
30055
- reason: string()
30056
- })
30057
- ]),
30058
- tracks: array(object({
30059
- id: string(),
30060
- enabled: boolean(),
30061
- isVideo: boolean(),
30062
- /** From the camera's own track description. Null when it does not say. */
30063
- codec: string().nullable(),
30064
- resolution: string().nullable(),
30065
- /** Per-track overwrite flag, where the firmware keeps it per track. */
30066
- overwriteWhenFull: boolean().nullable()
30067
- })),
30068
- /**
30069
- * The track the write path targets — the enabled VIDEO one. Null when
30070
- * no track could be identified, which is itself a refusal reason.
30071
- */
30072
- primaryTrackId: string().nullable(),
30073
- /** Master "record to the card at all" switch. */
30074
- enabled: boolean().nullable(),
30075
- overwriteWhenFull: boolean().nullable(),
30076
- preRecordSec: number().nullable(),
30077
- postRecordSec: number().nullable(),
30078
- /** Length of one recorded file, in minutes. */
30079
- segmentMinutes: number().nullable(),
30080
- /** The primary track's weekly windows, flattened. */
30081
- windows: array(RecordWindowSchema),
30082
- /**
30083
- * How many windows the camera described that CamStack could NOT read —
30084
- * an unrecognised trigger, an unparseable clock, a weekday it does not
30085
- * name.
30086
- *
30087
- * A dropped window is work the reader threw away, and a schedule that
30088
- * silently shows fewer rows than the camera holds is how an operator
30089
- * saves back a schedule shorter than the one they were looking at
30090
- * (D391). Non-zero means the window list is INCOMPLETE and a write
30091
- * that replaces it would delete what was not shown — which is why a
30092
- * provider reporting a non-zero count also reports the schedule as not
30093
- * writable.
30094
- */
30095
- unreadableWindows: number(),
30096
- /**
30097
- * The camera is scheduled to record and has NO usable storage.
30098
- *
30099
- * A first-class fact because it is the fleet's most common silent
30100
- * defect: measured 2026-09-22, 1441 and 3831 are both motion-recording
30101
- * to a card that is not there. Neither the schedule nor the storage
30102
- * read says anything wrong on its own; only the pair does.
30103
- */
30104
- recordingToNowhere: boolean(),
30105
- lastFetchedAt: number()
30106
- });
30107
- /** Numeric range descriptor — `{ min, max, step }` per the getOptions convention. */
30108
- var RangeSchema = object({
30109
- min: number(),
30110
- max: number(),
30111
- step: number()
30112
- });
30113
- /**
30114
- * The values a camera actually takes for a numeric field, when they are a SET
30115
- * rather than a range.
30116
- *
30117
- * `{min,max,step}` cannot say what these two firmwares do. Measured on 1436
30118
- * (I91DN) on 2026-09-22 by writing each value and reading it back:
30119
- *
30120
- * - pre-record: `0, 5, 10, 15, 20, 25, 30` and `2147483647` (INT32_MAX, the
30121
- * camera's "no limit" — `-1` and `4294967295` both land on it);
30122
- * - post-record: `5, 10, 30, 60, 120, 300, 600`.
30123
- *
30124
- * Neither is expressible as a step: the first has a sentinel two billion away
30125
- * from its neighbours, the second doubles and then jumps. A range that tried
30126
- * would forbid values the camera takes AND permit values it silently replaces
30127
- * with 5 — wrong in both directions at once.
30128
- *
30129
- * `sentinel` names the member that is not a duration, so a surface can render
30130
- * "no limit" instead of `2147483647` seconds.
30131
- */
30132
- var AllowedValuesSchema = object({
30133
- values: array(number()).min(1),
30134
- sentinel: object({
30135
- value: number(),
30136
- meaning: _enum(["no-limit", "disabled"])
30137
- }).optional()
30138
- });
30139
- /**
30140
- * Per-field availability on ONE camera.
30141
- *
30142
- * The field exists on every camera — this says whether this one can be
30143
- * read and whether it can be written, and `reason` says why not when
30144
- * either is false. The UI renders the control DISABLED with the reason
30145
- * rather than hiding it, so a limitation is legible instead of looking
30146
- * like a missing feature.
30147
- */
30148
- var OnboardFieldSupportSchema = object({
30149
- readable: boolean(),
30150
- writable: boolean(),
30151
- /** Required whenever `readable` or `writable` is false. */
30152
- reason: string().optional()
30153
- });
30154
- /** What this camera's schedule model can express. */
30155
- var OnboardScheduleSupportSchema = object({
30156
- support: OnboardFieldSupportSchema,
30157
- /**
30158
- * The smallest time step the camera can express, in minutes.
30159
- *
30160
- * Hikvision takes arbitrary minutes (`00:05:00`–`23:57:00` observed on
30161
- * 1436's track 103). Reolink's schedule is a 7×24 HOUR mask, so 60. A
30162
- * window whose edges are not a multiple of this is REFUSED rather than
30163
- * quietly rounded — rounding is how an operator's 06:30 becomes 06:00
30164
- * and nothing says so.
30165
- */
30166
- granularityMinutes: number(),
30167
- /** Triggers this camera can record on. A window naming another is refused. */
30168
- triggers: array(RecordTriggerSchema),
30169
- /**
30170
- * False when the camera stores ONE trigger per time range, so two
30171
- * windows overlapping on the same day cannot carry different triggers.
30172
- * True on Reolink, whose mask is per-trigger and independent.
30173
- */
30174
- supportsOverlappingTriggers: boolean()
30175
- });
30176
- var RecordingOnboardOptionsSchema = object({
30177
- enabled: OnboardFieldSupportSchema,
30178
- overwriteWhenFull: OnboardFieldSupportSchema,
30179
- preRecordSec: OnboardFieldSupportSchema,
30180
- preRecordSecRange: RangeSchema.optional(),
30181
- /** Preferred over the range when the camera takes a SET, not a span. */
30182
- preRecordSecAllowed: AllowedValuesSchema.optional(),
30183
- postRecordSec: OnboardFieldSupportSchema,
30184
- postRecordSecRange: RangeSchema.optional(),
30185
- /** Preferred over the range when the camera takes a SET, not a span. */
30186
- postRecordSecAllowed: AllowedValuesSchema.optional(),
30187
- segmentMinutes: OnboardFieldSupportSchema,
30188
- segmentMinutesRange: RangeSchema.optional(),
30189
- /** Preferred over the range when the camera takes a SET, not a span. */
30190
- segmentMinutesAllowed: AllowedValuesSchema.optional(),
30191
- schedule: OnboardScheduleSupportSchema
30192
- });
30193
- /**
30194
- * A partial change. Every field optional.
30195
- *
30196
- * Unlike the other `deviceConfig` caps, a provider here does **NOT**
30197
- * silently ignore a field it cannot support — it refuses, by name,
30198
- * through {@link describeOnboardRefusal}. Silence on a recording setting
30199
- * is the failure D62 exists to prevent: the operator believes the camera
30200
- * is recording the way the form says, and it is not.
30201
- */
30202
- var RecordingOnboardPatchSchema = object({
30203
- enabled: boolean().optional(),
30204
- overwriteWhenFull: boolean().optional(),
30205
- preRecordSec: number().optional(),
30206
- postRecordSec: number().optional(),
30207
- segmentMinutes: number().optional(),
30208
- /** The complete new window set for the primary track — not a delta. */
30209
- windows: array(RecordWindowSchema).optional()
30210
- });
30211
- DeviceType.Camera, method(object({ deviceId: number() }), RecordingOnboardOptionsSchema), method(object({
30212
- deviceId: number(),
30213
- settings: RecordingOnboardPatchSchema
30214
- }), _void(), {
30215
- kind: "mutation",
30216
- auth: "admin"
30217
- });
30218
- /**
30219
30075
  * Generic device-level status snapshot. Auto-registered by `BaseDevice`
30220
30076
  * for every device, regardless of provider — the kernel needs a uniform
30221
30077
  * cap-keyed slice for the basic device flags every consumer expects to
@@ -30309,30 +30165,6 @@ object({
30309
30165
  eventCountSinceStart: number()
30310
30166
  });
30311
30167
  DeviceType.EventEmitter;
30312
- var EventItemSchema = object({
30313
- id: string(),
30314
- type: string(),
30315
- timestamp: number(),
30316
- label: string().optional(),
30317
- thumbnailUrl: string().optional(),
30318
- clipUrl: string().optional(),
30319
- metadata: record(string(), unknown()).optional()
30320
- });
30321
- DeviceType.Camera, method(object({
30322
- deviceId: number(),
30323
- from: number().optional(),
30324
- to: number().optional(),
30325
- limit: number().optional()
30326
- }), array(EventItemSchema)), method(object({
30327
- deviceId: number(),
30328
- eventId: string()
30329
- }), object({
30330
- base64: string(),
30331
- contentType: string()
30332
- }).nullable()), method(object({
30333
- deviceId: number(),
30334
- eventId: string()
30335
- }), string().nullable());
30336
30168
  var IdentitySchema = object({
30337
30169
  id: string(),
30338
30170
  name: string(),
@@ -32029,143 +31861,6 @@ DeviceType.Light, DeviceType.Siren, DeviceType.Switch, method(object({
32029
31861
  lastChangedAt: number()
32030
31862
  });
32031
31863
  /**
32032
- * camera-grid-layout — the geometry of a COMPOSITE camera, on the camera's own
32033
- * page.
32034
- *
32035
- * ## Why this is a capability and not an addon settings schema
32036
- *
32037
- * It was one, and it did not render. The addon declared the editor as a
32038
- * `type: 'widget'` field inside its own `deviceSettingsSchema()`; the hub
32039
- * returned that section correctly and `ConfigFormField` renders `type:'widget'`
32040
- * perfectly well — and nothing ever asked camera-grid for it. The Cluster →
32041
- * Pipeline → Device Overrides page interrogates a HAND-WRITTEN list of four
32042
- * addons (`PIPELINE_CLUSTER_DEVICE_ADDONS`), whose own comment says an addon
32043
- * not on it "falls off silently".
32044
- *
32045
- * Adding a fifth name to that list would have been the wrong fix twice over:
32046
- * that page is per-camera DETECTION tuning, and a grid's geometry belongs
32047
- * beside PTZ and motion zones on the camera itself. The device page is
32048
- * BINDING-driven (D12), so the way in is a capability bound to the device —
32049
- * and this cap carries its section the way `recording` does, by RETURNING it
32050
- * from `getDeviceSettingsContribution`.
32051
- *
32052
- * Seven other widgets are still declared the other way, through a
32053
- * `deviceConfig.ui` block the framework derives a section from. That route
32054
- * gives the addon no say in where its own panel lands and no way to decline
32055
- * for a device the panel does not suit, which is why this one does not use it.
32056
- *
32057
- * ## Why one addon may implement it
32058
- *
32059
- * It is a device-scoped NATIVE cap, registered by the grid camera device
32060
- * itself. Nothing else declares a composite camera, so nothing else has a
32061
- * layout — and the device-scoped route means the widget asks THE camera, not
32062
- * "the camera-grid addon", which is what let the old custom-action pair be
32063
- * reached only by a caller that already knew the addon id.
32064
- *
32065
- * ## The tab
32066
- *
32067
- * `streaming`, not a top-tab of its own. A grid's geometry IS what its stream
32068
- * is, so the Streaming tab is where it belongs; a `grid` top-tab would need an
32069
- * entry in `WELL_KNOWN_TAB_MAP` or the device page renders the raw id as the
32070
- * label (measured on the robot camera, 2026-09-06 — a tab called "navigation"
32071
- * next to "PTZ").
32072
- */
32073
- /** A rectangle in normalized [0,1] coordinates of whatever contains it. */
32074
- var GridNormalizedRectSchema = object({
32075
- x: number().min(0).max(1),
32076
- y: number().min(0).max(1),
32077
- width: number().gt(0).max(1),
32078
- height: number().gt(0).max(1)
32079
- });
32080
- /**
32081
- * One source camera, the part of its picture taken, and where that part lands.
32082
- *
32083
- * Both rectangles are NORMALIZED (D519): a source camera can change resolution
32084
- * — a profile switch, a firmware update, a substream that comes back different
32085
- * — and a stored PIXEL rectangle would quietly start cutting the wrong region,
32086
- * which is the class of bug nobody files.
32087
- */
32088
- var GridLayoutCellSchema = object({
32089
- deviceId: number().int().positive(),
32090
- /** The part of the SOURCE taken, normalized against the source. */
32091
- source: GridNormalizedRectSchema,
32092
- /** Where it lands, normalized against the CANVAS. */
32093
- cell: GridNormalizedRectSchema
32094
- });
32095
- /**
32096
- * Which profiles this grid can actually compose, and why not.
32097
- *
32098
- * A grid's `high` composes its sources' `high` and its `low` their `low`, so a
32099
- * profile is on offer only when EVERY source can serve it. The refusal NAMES
32100
- * the sources, because "this grid has no low" is not a finding — "615 has no
32101
- * low" is, and it is the one an operator can act on.
32102
- */
32103
- var GridProfileOfferSchema = object({
32104
- profile: _enum([
32105
- "high",
32106
- "mid",
32107
- "low"
32108
- ]),
32109
- offered: boolean(),
32110
- /** Sources that cannot serve it. Empty when it is offered, or when there are no cells. */
32111
- missingSources: array(number().int().positive()),
32112
- /**
32113
- * The canvas this profile composes onto, `WxH`, or empty when it is not
32114
- * offered. DERIVED from the cells and the sources' own size at this profile —
32115
- * it is reported because nothing else in the system would ever say what the
32116
- * grid came out as, and because it is the number an operator would otherwise
32117
- * expect to type.
32118
- */
32119
- canvas: string(),
32120
- /**
32121
- * Whether this profile is PUBLISHED, of the ones the grid could serve.
32122
- *
32123
- * A grid's `high` is composed of its sources' `high`, so on a 4K fleet it is
32124
- * a 4K canvas built from 4K decodes — something to opt into, not something a
32125
- * viewer's adaptive should be handed by climbing to the top rung it can see.
32126
- * Default is `mid` + `low`.
32127
- */
32128
- published: boolean()
32129
- });
32130
- var GridLayoutViewSchema = object({
32131
- /** The persisted grid row this camera was declared from. */
32132
- instanceId: string(),
32133
- deviceId: number().int().nonnegative(),
32134
- name: string(),
32135
- /**
32136
- * NO canvas size. A grid's resolution is not authored: each profile derives
32137
- * its own from the cells and its sources' dimensions. The two numbers that
32138
- * used to be here were a text field that silently decided both how much the
32139
- * composite cost and how sharp it was — see `profiles[].canvas` for what it
32140
- * came out as.
32141
- */
32142
- fps: number().int(),
32143
- cells: array(GridLayoutCellSchema),
32144
- /** What the catalog will publish, and what it refuses to. Read-only. */
32145
- profiles: array(GridProfileOfferSchema)
32146
- });
32147
- var GridLayoutPatchSchema = object({
32148
- deviceId: number().int().nonnegative(),
32149
- name: string().min(1).max(160).optional(),
32150
- fps: number().int().min(1).max(60).optional(),
32151
- /** Which profiles to publish. See `GridProfileOffer.published`. */
32152
- publishedProfiles: array(_enum([
32153
- "high",
32154
- "mid",
32155
- "low"
32156
- ])).max(3).optional(),
32157
- /**
32158
- * The whole cell list at once. A per-cell patch would need an ordering the
32159
- * editor does not have, and a half-applied layout is a picture nobody asked
32160
- * for.
32161
- */
32162
- cells: array(GridLayoutCellSchema).max(16)
32163
- });
32164
- DeviceType.Camera, method(object({ deviceId: number().int().nonnegative() }), GridLayoutViewSchema.nullable(), { auth: "admin" }), method(GridLayoutPatchSchema, GridLayoutViewSchema, {
32165
- kind: "mutation",
32166
- auth: "admin"
32167
- });
32168
- /**
32169
31864
  * Motion-zones share the same MaskShape vocabulary as privacy-mask — the
32170
31865
  * on-camera motion-detection mask is a single `grid` region (a row-major
32171
31866
  * boolean cell lattice the camera's onboard VMD evaluates). Composing it as
@@ -33978,36 +33673,95 @@ DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceI
33978
33673
  auth: "admin"
33979
33674
  });
33980
33675
  /**
33981
- * `recording` cap — footage availability + HLS playback manifests + per-device
33982
- * recording config. NOTE on events (source of truth, R5/C3): this cap carries
33983
- * NO event surface — `getPlaybackManifest` returns playlist URLs only. Timeline
33984
- * events (motion/object/audio) come from `pipelineAnalytics` (durable SQLite
33985
- * rows) and are the ONLY event surface — the recorder has none. The in-RAM
33986
- * playback markers it used to build were deleted on 2026-08-29 because nothing
33987
- * ever read them. Event<->footage joins are by time, padded with the shared
33988
- * `EVENT_PAD_MS` (`interfaces/recording-config.ts`).
33676
+ * `recording` — a camera's recorded COVERAGE and PLAYBACK, from whichever
33677
+ * source the operator picked.
33678
+ *
33679
+ * A device-scoped wrapper COLLECTION since D625, and the five lines that make
33680
+ * it one (`scope`/`mode`/`kind`/`defaultActive`/`deviceTypes`) are copied from
33681
+ * `videoclips.cap.ts` deliberately: `scope: 'device'` + `mode: 'collection'` is
33682
+ * what makes `resolveCapMount` keep the PER-DEVICE mount while the collection
33683
+ * dispatcher fans out, and a device's sources are then its BINDINGS
33684
+ * (`deviceManager.getBindings`, D554 amended) rather than "every addon that
33685
+ * registered the cap somewhere".
33686
+ *
33687
+ * ## What is here and what is not
33688
+ *
33689
+ * FIVE of them — `listSources`, `getAvailability`, `getDaysWithRecordings`,
33690
+ * `getPlayback`, `getPlaybackOptions`. Every source must be able to answer
33691
+ * these or it is not a source. Everything else that used to live on this cap —
33692
+ * storage locations, retention, relocation, rebalance, the ops log, the
33693
+ * placement table, the `mfra` byte plane, `getDeviceConfig`/`setDeviceConfig`
33694
+ * and the two batch reads — is on `recording-archive`, a system singleton, and
33695
+ * the reasons are argued there.
33696
+ *
33697
+ * ## The default is OURS, and there is nowhere to say otherwise
33698
+ *
33699
+ * {@link RECORDING_SOURCE_CAMSTACK} is RESERVED. The absence of an operator
33700
+ * choice MEANS that value; it is not a row that happened to sort first. Clips
33701
+ * end their resolver with `?? sources[0]` and that is right for clips — a
33702
+ * camera full of onboard clips that says "no clips" is the defect that work
33703
+ * exists to end. For a TIMELINE it is wrong and the measurement says why: on
33704
+ * 592, ours covers 85 362 s of the day and the card 21 388 s, and
33705
+ * `videoclips.listSources` answers the ONBOARD row first. A silent fall to the
33706
+ * first row would swap a 98.8 % bar for a 24.8 % one with nothing saying so.
33707
+ *
33708
+ * So a surface that cannot find our row says `ours-absent` and offers the
33709
+ * others as a CHOICE; it never takes one on the operator's behalf. The
33710
+ * reservation is enforced in the collection dispatcher — a `listSources` row
33711
+ * carrying this id from any addon but the recorder is refused by name — and by
33712
+ * `scripts/check-reserved-collection-sources.ts` in CI.
33713
+ *
33714
+ * NOTE on events (source of truth, R5/C3): this cap carries NO event surface.
33715
+ * Timeline events (motion/object/audio) come from `pipelineAnalytics` (durable
33716
+ * SQLite rows) and are the ONLY event surface — the recorder has none.
33717
+ * Event<->footage joins are by time, padded with the shared `EVENT_PAD_MS`
33718
+ * (`interfaces/recording-config.ts`).
33989
33719
  */
33990
- var RecordingStatusSchema = object({
33991
- deviceId: number(),
33992
- enabled: boolean(),
33993
- /** THE derived storage mode, from the one definition
33994
- * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
33995
- * `on-device-decision` could have reached the recorder and not the status. */
33996
- activeMode: RecordingStorageModeSchema,
33997
- nodeId: string(),
33998
- storageBytes: number()
33999
- });
33720
+ /**
33721
+ * OUR recorder's source id. RESERVED: no other provider may return it from
33722
+ * `listSources`, and the absence of an operator choice MEANS this value.
33723
+ *
33724
+ * Reserved is ENFORCED, not requested — `device-collection-dispatch.ts` drops a
33725
+ * row spelling it from any addon but {@link RECORDING_SOURCE_CAMSTACK_ADDON},
33726
+ * naming the impostor, and `scripts/check-reserved-collection-sources.ts`
33727
+ * fails CI on a provider package that spells it at all. A rule nothing checks
33728
+ * has already been broken somewhere.
33729
+ */
33730
+ var RECORDING_SOURCE_CAMSTACK = "camstack";
33731
+ /** The one addon allowed to serve {@link RECORDING_SOURCE_CAMSTACK}: the
33732
+ * recorder, which is the addon that writes the footage (D560). */
33733
+ var RECORDING_SOURCE_CAMSTACK_ADDON = "recorder";
34000
33734
  var RecordingRangeSchema = object({
34001
33735
  profile: string(),
34002
33736
  startMs: number(),
34003
33737
  endMs: number()
34004
33738
  });
33739
+ /**
33740
+ * How a source ANSWERED, on every singular read of this cap.
33741
+ *
33742
+ * `'read'` — it looked. `ranges: []` / `days: []` is then a real claim: this
33743
+ * source has no coverage in the window. `'unreadable'` — nobody could look
33744
+ * (the camera was unreachable, the calendar rung threw, the location is
33745
+ * unmounted, the node is still on the old build), and the emptiness beside it
33746
+ * means NOTHING.
33747
+ *
33748
+ * The batch rows have carried this since the grid existed; the SINGULAR
33749
+ * answers gained it with the collection (D625 §10.4), because they are the
33750
+ * ones the single-camera picker uses and because a half-converted fleet makes
33751
+ * "nobody looked" common for the length of a deploy. Without it the timeline
33752
+ * has no vocabulary for it, and `(data ?? [])` in a viewer turns a rollout into
33753
+ * a fleet of cameras that appear to have lost their recordings (D315, D393).
33754
+ */
33755
+ var RecordingReadSchema = _enum(["read", "unreadable"]);
34005
33756
  var RecordingAvailabilitySchema = object({
34006
33757
  deviceId: number(),
33758
+ /** See {@link RecordingReadSchema}. An `'unreadable'` answer carries an empty
33759
+ * `ranges` that means nothing — never draw it as "no footage". */
33760
+ read: RecordingReadSchema,
34007
33761
  ranges: array(RecordingRangeSchema),
34008
33762
  /**
34009
- * Every profile this camera has footage in — not only the one `ranges`
34010
- * describes (D433).
33763
+ * Every profile this camera has footage in AT THIS SOURCE — not only the one
33764
+ * `ranges` describes (D433).
34011
33765
  *
34012
33766
  * `ranges` answers for ONE profile by design: the timeline is a single bar,
34013
33767
  * and enumerating all of them triples the directory reads for a bar that
@@ -34024,15 +33778,344 @@ var RecordingAvailabilitySchema = object({
34024
33778
  });
34025
33779
  var RecordingDaysSchema = object({
34026
33780
  deviceId: number(),
33781
+ /** See {@link RecordingReadSchema}. `days: []` on an `'unreadable'` answer is
33782
+ * "nobody could look", and the date-picker must not spell it the same as
33783
+ * "no footage this month". */
33784
+ read: RecordingReadSchema,
34027
33785
  /** Local-midnight epochs (UTC ms) of days that have ≥1 recorded segment. */
34028
33786
  days: array(number())
34029
33787
  });
33788
+ var RecordingManifestSchema = object({
33789
+ deviceId: number(),
33790
+ /** Local filesystem path to the master playlist; null when no recording exists for the requested range. */
33791
+ localMasterPath: string().nullable(),
33792
+ /** HTTP(S) URL to the master playlist on the recording node's playback server
33793
+ * (the PRIMARY candidate); null when no recording / server. Carries the
33794
+ * scoped playback token in its path. */
33795
+ playbackUrl: string().nullable(),
33796
+ /**
33797
+ * Candidate master-playlist URLs the client tries in order (LAN first, then
33798
+ * remote — Tailscale/Cloudflare if the operator configured extra hosts), each
33799
+ * carrying the same scoped token. `playbackUrl` is the first entry. Empty when
33800
+ * there is no recording / server.
33801
+ */
33802
+ playbackEndpoints: array(string())
33803
+ });
33804
+ var RecordingSourceAvailabilitySchema = object({
33805
+ state: _enum([
33806
+ "ok",
33807
+ "sleeping",
33808
+ "unreachable",
33809
+ "no-storage",
33810
+ "index-empty"
33811
+ ]),
33812
+ /** Free text, shown verbatim. Names the camera's own refusal when there is one. */
33813
+ reason: string().optional(),
33814
+ /** When this source's coverage was last CONFIRMED. A cached answer is never
33815
+ * drawn as current: the surface shows the age whenever it is older than the
33816
+ * refresh interval. The clip catalog's `catalogAsOf`, under the name the
33817
+ * timeline uses for it. */
33818
+ coverageAsOf: number().optional()
33819
+ });
33820
+ /**
33821
+ * One SOURCE of recorded coverage for a camera — a row of the picker.
33822
+ *
33823
+ * A provider lists the sources IT serves for that device, and answers for each
33824
+ * of them whether it can answer at all. A provider with nothing to offer on a
33825
+ * camera returns `[]` — it is not that camera's business. The five availability
33826
+ * states are `ClipSourceAvailability`'s verbatim: they mean exactly the same
33827
+ * things about a coverage index as about a clip catalog, and `sleeping` in
33828
+ * particular is what stops a battery camera being woken to paint a bar.
33829
+ */
33830
+ var RecordingSourceSchema = object({
33831
+ /** The source id. {@link RECORDING_SOURCE_CAMSTACK} for ours (RESERVED), a
33832
+ * vendor namespace (`native:reolink:onboard`, …) for a camera's own store. */
33833
+ source: string(),
33834
+ /** Operator-facing name of the source ("CamStack recordings", "SD card"). */
33835
+ label: string(),
33836
+ /**
33837
+ * The addon that SERVES this row, and the value a later call passes as
33838
+ * `provider`.
33839
+ *
33840
+ * Optional for version skew only. The collection dispatcher stamps it from
33841
+ * the registry, so a row that travelled through the fan-out carries the
33842
+ * authoritative id whatever the provider filled in (D557 §4).
33843
+ */
33844
+ addonId: string().optional(),
33845
+ availability: RecordingSourceAvailabilitySchema
33846
+ });
33847
+ /**
33848
+ * What a surface may DRAW for this (camera, source) — D612's rule applied to a
33849
+ * timeline: **the source declares what it can do, and the surface draws what
33850
+ * was declared. It never assumes, and never offers a gesture it will then
33851
+ * refuse.** D612 exists because `8` and `16` were offered as clip rates, the
33852
+ * broker clamped them to `4`, and no line anywhere said so.
33853
+ *
33854
+ * Asked once per (camera, source) before anything is drawn — never replaced by
33855
+ * a constant the surface keeps, which is the second authority D612 ends.
33856
+ */
33857
+ var RecordingSourceOptionsSchema = object({
33858
+ /** How this source's media reaches the player.
33859
+ * `archive` = our own indexed segment tree; `stream` = the provider's
33860
+ * forward-only fMP4 (D597); `realtime` = a replay bound to wall clock. */
33861
+ transport: _enum([
33862
+ "archive",
33863
+ "stream",
33864
+ "realtime"
33865
+ ]),
33866
+ /** What the BAR means. `continuous` = gaps are holes in a recording;
33867
+ * `sparse` = gaps are the absence of one, and must be drawn as such.
33868
+ *
33869
+ * Not an onboard-only concession: measured 2026-09-24, OUR bar covers 98.8 %
33870
+ * of 592's day and 1.2 % of 1436's. It is a fact about a (source, camera)
33871
+ * pair, and ours answers it per camera from `deriveRecordingMode`. */
33872
+ coverage: _enum(["continuous", "sparse"]),
33873
+ /** Where the playhead may be put.
33874
+ * `free` — anywhere, to the frame.
33875
+ * `forward` — only ahead of the current position.
33876
+ * `segment` — a position SNAPS to the head of the covering segment; a finer
33877
+ * ask is accepted by the camera and SILENTLY IGNORED. Measured
33878
+ * on 1436 (Hikvision V5.7.1, 2026-09-23): a window-narrowed
33879
+ * `ContentMgmt/search` returns a row and a `playbackURI`, the
33880
+ * replay opens 200 and delivers media — and the burned-in OSD of
33881
+ * the first frame reads the SEGMENT HEAD every time. Calling
33882
+ * that `forward` would tell the surface it may move the playhead
33883
+ * ahead within a loaded segment, which it may not. */
33884
+ seek: _enum([
33885
+ "free",
33886
+ "forward",
33887
+ "segment"
33888
+ ]),
33889
+ /** Frame-step BACKWARD is meaningful. */
33890
+ stepBack: boolean(),
33891
+ /** Whether the drag-scrub gesture is served, as opposed to refused by name. */
33892
+ scrub: boolean(),
33893
+ /** Deliverable rates, ascending, always containing `1`. The surface draws its
33894
+ * picker from this and from NOTHING else (D612, D620, D621). `0` is not a
33895
+ * member: pause is the absence of a rate. */
33896
+ rates: array(number().positive()).min(1).readonly(),
33897
+ /** TRUE when a read of this source HOLDS the camera's only playback session.
33898
+ * A surface with this set makes at most ONE read at a time and draws no
33899
+ * scrub-thumbnail strip, no hover preview, no prefetch and no background
33900
+ * refresh. The precedent is exact and expensive: filling one screen of
33901
+ * Hikvision thumbnails at 1.01× realtime consumed fifteen minutes of that
33902
+ * camera's only playback session (1.2.126, reported within minutes), and a
33903
+ * timeline is a screenful of reads by construction. */
33904
+ exclusive: boolean()
33905
+ });
33906
+ /**
33907
+ * How to PLAY the instant that was asked for, from the chosen source.
33908
+ *
33909
+ * No new media transport is built for onboard sources: the `clip` arm is a
33910
+ * DELEGATION to the `videoclips` transport that vendor already has (D597 /
33911
+ * D616 / D617). The onboard half of this collection is a PROJECTION of
33912
+ * `videoclips` for coverage and a delegation to it for bytes.
33913
+ */
33914
+ var RecordingPlaybackSchema = discriminatedUnion("kind", [
33915
+ object({
33916
+ kind: literal("hls"),
33917
+ manifest: RecordingManifestSchema
33918
+ }),
33919
+ object({
33920
+ kind: literal("clip"),
33921
+ /** The `videoclips` source namespace this clip id belongs to. */
33922
+ source: string(),
33923
+ clipId: string(),
33924
+ /** Where this clip actually STARTS. On a `seek: 'segment'` source the
33925
+ * playhead lands here, not at the requested instant — the surface must be
33926
+ * TOLD, not left to discover it from a burned-in OSD. */
33927
+ startsAtMs: number()
33928
+ }),
33929
+ object({
33930
+ kind: literal("none"),
33931
+ reason: string()
33932
+ })
33933
+ ]);
33934
+ var recordingCapability = {
33935
+ name: "recording",
33936
+ scope: "device",
33937
+ /** Several sources per camera, listed beside each other. The mount stays
33938
+ * `device-scoped` — see `resolveCapMount`'s ordering and D554: per-device
33939
+ * wins over the global collection fan-out. */
33940
+ mode: "collection",
33941
+ kind: "wrapper",
33942
+ defaultActive: true,
33943
+ /** Recorded coverage is a property of a camera — the cap is meaningless on a
33944
+ * sensor, a button or an event emitter, and the `defaultActive` auto-bind
33945
+ * reads this to decide which devices it may claim. */
33946
+ deviceTypes: [DeviceType.Camera],
33947
+ methods: {
33948
+ /**
33949
+ * The sources this camera has, WITH the reason any of them cannot answer.
33950
+ *
33951
+ * Asked separately from `getAvailability` because an empty bar is
33952
+ * ambiguous and this is the only place the ambiguity is resolved: every
33953
+ * bound provider contributes its own rows, and a provider that could not be
33954
+ * reached at all still produces one row saying so. A surface that draws "no
33955
+ * recordings" without reading this is drawing a guess.
33956
+ *
33957
+ * The ONLY method here without a `provider` — it is the call that tells the
33958
+ * caller what to put there.
33959
+ */
33960
+ listSources: method(object({ deviceId: number() }), array(RecordingSourceSchema).readonly(), {
33961
+ kind: "query",
33962
+ auth: "protected"
33963
+ }),
33964
+ /**
33965
+ * Recorded coverage of `[fromMs, toMs)` at ONE source — the timeline bar.
33966
+ *
33967
+ * `protected`, not `admin`: a per-camera read is exactly what a camera
33968
+ * viewer is FOR, and the device-scoped mount routes through
33969
+ * `getProviderForDevice`, so a camera outside the caller's scope is refused
33970
+ * before a provider is reached.
33971
+ */
33972
+ getAvailability: method(object({
33973
+ deviceId: number(),
33974
+ /**
33975
+ * WHICH provider to ask — the `addonId` a {@link RecordingSourceSchema}
33976
+ * row carries, never a source id and never a list. **REQUIRED**, in the
33977
+ * schema, where the generated types make it unomittable rather than
33978
+ * merely discouraged (D554 amended).
33979
+ *
33980
+ * It was learned the expensive way on `videoclips.listClips`: measured
33981
+ * on the live hub 2026-09-20, device 592 bound to `recorder` AND
33982
+ * `provider-reolink`, a bare call with `limit: 3` answered SIX rows,
33983
+ * three from each source, merged — `device-collection-dispatch.ts`
33984
+ * leaves an unpinned fan-out un-narrowed, so absence buys the union the
33985
+ * method exists not to be. An un-narrowed `getAvailability` would do
33986
+ * that to a TIMELINE: our ranges and the card's clips unioned into one
33987
+ * bar, which is "two sources are never drawn together" broken in the
33988
+ * one place it matters most.
33989
+ *
33990
+ * A provider the device is not bound to is refused BY NAME (D552's
33991
+ * `rejectUnresolvedAddonPin`), never answered by another one.
33992
+ */
33993
+ provider: string().min(1),
33994
+ fromMs: number(),
33995
+ toMs: number(),
33996
+ /**
33997
+ * Answer for THIS profile instead of the source's preferred one (D433).
33998
+ * Absent keeps the timeline's behaviour — one bar, one profile, one set
33999
+ * of reads. `profilesWithFootage` on the answer says what may be asked
34000
+ * for.
34001
+ */
34002
+ profile: string().optional()
34003
+ }), RecordingAvailabilitySchema, {
34004
+ kind: "query",
34005
+ auth: "protected"
34006
+ }),
34007
+ /** Which calendar days in [fromMs,toMs) this source has ≥1 recording in,
34008
+ * bucketed by the client's local day (`tzOffsetMinutes` = minutes to add
34009
+ * to UTC). Drives the theater date-picker's day dots. `provider` is
34010
+ * REQUIRED for the reason `getAvailability` states. */
34011
+ getDaysWithRecordings: method(object({
34012
+ deviceId: number(),
34013
+ provider: string().min(1),
34014
+ fromMs: number(),
34015
+ toMs: number(),
34016
+ tzOffsetMinutes: number()
34017
+ }), RecordingDaysSchema, {
34018
+ kind: "query",
34019
+ auth: "protected"
34020
+ }),
34021
+ /**
34022
+ * How to PLAY `[fromMs, toMs)` at this source.
34023
+ *
34024
+ * It was `getPlaybackManifest`, and the rename is not cosmetic: a
34025
+ * "manifest" is an HLS master playlist, which is a property of OUR recorder
34026
+ * and of nothing else. Keeping the name would make every onboard
34027
+ * implementation a lie in its signature. The old shape survives verbatim
34028
+ * inside the union's `hls` arm, so the recorder's implementation is
34029
+ * unchanged behind it.
34030
+ */
34031
+ getPlayback: method(object({
34032
+ deviceId: number(),
34033
+ provider: string().min(1),
34034
+ fromMs: number(),
34035
+ toMs: number(),
34036
+ profile: CamProfileSchema.optional()
34037
+ }), RecordingPlaybackSchema, {
34038
+ kind: "query",
34039
+ auth: "protected"
34040
+ }),
34041
+ /**
34042
+ * What this (camera, source) can actually DO — asked before anything is
34043
+ * drawn. See {@link RecordingSourceOptionsSchema}; a constant the surface
34044
+ * keeps instead is the second authority D612 exists to end.
34045
+ */
34046
+ getPlaybackOptions: method(object({
34047
+ deviceId: number(),
34048
+ provider: string().min(1)
34049
+ }), RecordingSourceOptionsSchema, {
34050
+ kind: "query",
34051
+ auth: "protected"
34052
+ })
34053
+ }
34054
+ };
34055
+ /**
34056
+ * `recording-archive` — OUR archive, and the intent that fills it.
34057
+ *
34058
+ * The system-singleton half of the 2026-09-24 cut (D625). `recording` used to
34059
+ * be one 33-method system singleton holding two unrelated subjects: three
34060
+ * per-camera READS about coverage and playback, and everything else — storage
34061
+ * locations, retention, relocation, rebalance, the ops log, the placement
34062
+ * table and the byte-plane primitives our scrub and export are built on.
34063
+ *
34064
+ * The reads became a device-scoped COLLECTION, so a camera's own card can be a
34065
+ * source beside ours (`recording.cap.ts`). Everything that is about OUR store,
34066
+ * or unimplementable by a camera, stayed here.
34067
+ *
34068
+ * ## On the name
34069
+ *
34070
+ * `recording-storage` was the obvious choice and is wrong: this cap also holds
34071
+ * `getDeviceConfig`/`setDeviceConfig`, which are recording INTENT — bands,
34072
+ * retention, the D62 switch authority — and a name that says "storage" invites
34073
+ * the next reader to move them out again. An archive is a thing we keep, and
34074
+ * what we keep it under is a policy; the name covers both halves honestly and
34075
+ * sits in the existing family (`recording-onboard`, `recording-export`,
34076
+ * `recording-signal`).
34077
+ *
34078
+ * ## What must NOT happen to it
34079
+ *
34080
+ * It stays a SINGLETON. It is registered by `recorder`, which is
34081
+ * `placement: 'any-node'` and runs on every recording node; the hub dispatches
34082
+ * to one of them. Putting the ledger, the placement table or the relocation
34083
+ * jobs behind a fan-out is the one genuinely dangerous move in this cut.
34084
+ *
34085
+ * `getDeviceConfig` / `setDeviceConfig` in particular are the D62 recording
34086
+ * authority (`CameraSwitch.authority`). If a write reached a different provider
34087
+ * than the read — which a collection fan-out permits — two authorities would
34088
+ * decide when one camera records, and the symptom (recording silently off, or
34089
+ * a `bands` array clobbered by a partial write) is durable and silent. Keeping
34090
+ * them here means the worst case during a rollout is a 412: the switch refuses
34091
+ * to flip and SAYS so. **Do not move them into the collection, at any point,
34092
+ * for any reason.**
34093
+ *
34094
+ * ## The two batch reads
34095
+ *
34096
+ * `getAvailabilityBatch` / `getDaysWithRecordingsBatch` take `deviceIds:
34097
+ * number[]` with no single `deviceId`, and a device-scoped mount routes
34098
+ * through `getProviderForDevice(deviceId)` — there is nothing for it to route
34099
+ * on. They stay here, and on this cap the batch is explicitly OURS: a grid has
34100
+ * no per-camera picker, and a caller that wants another source's coverage asks
34101
+ * `recording.getAvailability` per device with that source's `provider`.
34102
+ */
34103
+ var RecordingStatusSchema = object({
34104
+ deviceId: number(),
34105
+ enabled: boolean(),
34106
+ /** THE derived storage mode, from the one definition
34107
+ * (`deriveRecordingMode`) — never a second enum. A duplicated list is how
34108
+ * `on-device-decision` could have reached the recorder and not the status. */
34109
+ activeMode: RecordingStorageModeSchema,
34110
+ nodeId: string(),
34111
+ storageBytes: number()
34112
+ });
34030
34113
  /**
34031
34114
  * One camera's row in a `getAvailabilityBatch` answer.
34032
34115
  *
34033
- * `ranges` is EXACTLY what `getAvailability` returns for that camera — the
34034
- * batch collapses the transport, not the work — plus the one thing the singular
34035
- * method never had to say:
34116
+ * `ranges` is EXACTLY what `recording.getAvailability` returns for that camera
34117
+ * at OUR source — the batch collapses the transport, not the work — plus the
34118
+ * `read` mark the singular answer now carries too (D625):
34036
34119
  *
34037
34120
  * - `read: 'read'` — answered. `ranges: []` means "read, and this camera has
34038
34121
  * no footage in the window", which is a real claim.
@@ -34064,22 +34147,6 @@ var RecordingDaysForDeviceSchema = object({
34064
34147
  /** Local-midnight epochs (UTC ms) of days that have ≥1 recorded segment. */
34065
34148
  days: array(number()).readonly()
34066
34149
  });
34067
- var RecordingManifestSchema = object({
34068
- deviceId: number(),
34069
- /** Local filesystem path to the master playlist; null when no recording exists for the requested range. */
34070
- localMasterPath: string().nullable(),
34071
- /** HTTP(S) URL to the master playlist on the recording node's playback server
34072
- * (the PRIMARY candidate); null when no recording / server. Carries the
34073
- * scoped playback token in its path. */
34074
- playbackUrl: string().nullable(),
34075
- /**
34076
- * Candidate master-playlist URLs the client tries in order (LAN first, then
34077
- * remote — Tailscale/Cloudflare if the operator configured extra hosts), each
34078
- * carrying the same scoped token. `playbackUrl` is the first entry. Empty when
34079
- * there is no recording / server.
34080
- */
34081
- playbackEndpoints: array(string())
34082
- });
34083
34150
  /**
34084
34151
  * Recording storage usage for one camera — what the ARCHIVE holds for it,
34085
34152
  * across every profile and every resolvable location on this node.
@@ -34337,33 +34404,22 @@ var ReadWindowBytesResultSchema = discriminatedUnion("kind", [object({
34337
34404
  * not a retry hint (retrying the same window would refuse again). */
34338
34405
  segmentEndMs: number()
34339
34406
  })]);
34340
- var recordingCapability = {
34341
- name: "recording",
34407
+ var recordingArchiveCapability = {
34408
+ name: "recording-archive",
34342
34409
  scope: "system",
34343
34410
  mode: "singleton",
34411
+ /** Moves here with the config pair — the derived Recording settings
34412
+ * section is a view over `getDeviceConfig`/`setDeviceConfig` (D14), and
34413
+ * those did not move (D625). */
34344
34414
  exposesDeviceSettings: true,
34345
34415
  status: {
34346
34416
  schema: RecordingStatusSchema,
34347
34417
  kind: "command-driven"
34348
34418
  },
34349
34419
  methods: {
34350
- getAvailability: method(object({
34351
- deviceId: number(),
34352
- fromMs: number(),
34353
- toMs: number(),
34354
- /**
34355
- * Answer for THIS profile instead of the preferred one (D433). Absent
34356
- * keeps the timeline's behaviour — one bar, one profile, one set of
34357
- * reads. `profilesWithFootage` on the answer says what may be asked
34358
- * for.
34359
- */
34360
- profile: string().optional()
34361
- }), RecordingAvailabilitySchema, {
34362
- kind: "query",
34363
- auth: "protected"
34364
- }),
34365
34420
  /**
34366
- * `getAvailability` for a SET of cameras, in one round trip.
34421
+ * `recording.getAvailability` for a SET of cameras, in one round trip, at
34422
+ * OUR source.
34367
34423
  *
34368
34424
  * A multi-camera timeline re-asks availability for every camera in the grid
34369
34425
  * on every day change; fanned out that is one request per camera for N
@@ -34371,6 +34427,13 @@ var recordingCapability = {
34371
34427
  * `availabilityProfileFor` + `rangesIn`, run concurrently inside the
34372
34428
  * recorder) — only the transport collapses.
34373
34429
  *
34430
+ * It lives on the ARCHIVE, not on the `recording` collection, because it
34431
+ * takes `deviceIds` with no single `deviceId` and a device-scoped mount has
34432
+ * nothing to route on (D625 §10.2). The consequence is stated rather than
34433
+ * hidden: the batch answers for OURS. A caller that needs another source's
34434
+ * coverage asks `recording.getAvailability` per device, naming that
34435
+ * source's provider.
34436
+ *
34374
34437
  * `protected` for the same reason the singular method is: every id in
34375
34438
  * `deviceIds` is a device reference, so the F1 #3 gate refuses any camera
34376
34439
  * outside the caller's scope — one id out of scope refuses the CALL, it
@@ -34388,20 +34451,10 @@ var recordingCapability = {
34388
34451
  kind: "query",
34389
34452
  auth: "protected"
34390
34453
  }),
34391
- /** Which calendar days in [fromMs,toMs) have ≥1 recorded segment, bucketed by
34392
- * the client's local day (`tzOffsetMinutes` = minutes to add to UTC). Drives
34393
- * the theater date-picker's day dots. */
34394
- getDaysWithRecordings: method(object({
34395
- deviceId: number(),
34396
- fromMs: number(),
34397
- toMs: number(),
34398
- tzOffsetMinutes: number()
34399
- }), RecordingDaysSchema, {
34400
- kind: "query",
34401
- auth: "protected"
34402
- }),
34403
34454
  /**
34404
- * `getDaysWithRecordings` for a SET of cameras, in one round trip.
34455
+ * `recording.getDaysWithRecordings` for a SET of cameras, in one round
34456
+ * trip, at OUR source. Same placement argument as
34457
+ * {@link getAvailabilityBatch}.
34405
34458
  *
34406
34459
  * The cheapest question in the product, asked once per camera per month
34407
34460
  * change. One directory read per day per camera at the owner, unchanged;
@@ -34420,14 +34473,6 @@ var recordingCapability = {
34420
34473
  kind: "query",
34421
34474
  auth: "protected"
34422
34475
  }),
34423
- getPlaybackManifest: method(object({
34424
- deviceId: number(),
34425
- fromMs: number(),
34426
- toMs: number()
34427
- }), RecordingManifestSchema, {
34428
- kind: "query",
34429
- auth: "protected"
34430
- }),
34431
34476
  getStorageUsage: method(object({}), RecordingStorageUsageSchema, {
34432
34477
  kind: "query",
34433
34478
  auth: "admin"
@@ -34443,6 +34488,10 @@ var recordingCapability = {
34443
34488
  * value (D315, D393, D590). It carries schedules and retention, no secret,
34444
34489
  * and the per-device gate in `scope-access.ts` still applies; `setDeviceConfig`
34445
34490
  * stays `admin`.
34491
+ *
34492
+ * It is a SINGLETON method and stays one (D625 §16.2): it is the D62
34493
+ * recording authority, and an authority that several providers could answer
34494
+ * is the "two knobs over one decision" D62 forbids.
34446
34495
  */
34447
34496
  getDeviceConfig: method(object({ deviceId: number() }), RecordingConfigSchema, {
34448
34497
  kind: "query",
@@ -34450,7 +34499,13 @@ var recordingCapability = {
34450
34499
  }),
34451
34500
  /** Locate footage at a wall-clock instant: the covering segment's window,
34452
34501
  * or a gap with the forward nearest covered edge. Used by a feeder running
34453
- * in another addon process to seek recorded footage over tRPC. */
34502
+ * in another addon process to seek recorded footage over tRPC.
34503
+ *
34504
+ * BYTE PLANE: defined by `mfra` byte ranges over OUR own MP4 segment tree.
34505
+ * There is no vendor-neutral statement of it, its only callers are feeders
34506
+ * in other addon processes (the stream broker, the replay-clip source),
34507
+ * and an onboard source that ever needs bytes delegates to the
34508
+ * `videoclips` transport its vendor already has (D625 §9.3, §10.5). */
34454
34509
  locateSegment: method(object({
34455
34510
  deviceId: number(),
34456
34511
  profile: string(),
@@ -35183,6 +35238,307 @@ var recordingExportCapability = {
35183
35238
  }
35184
35239
  };
35185
35240
  /**
35241
+ * Vendor-neutral **onboard** recording + storage cap — what the CAMERA
35242
+ * writes to the CAMERA's own card, on the camera's own schedule.
35243
+ *
35244
+ * This is NOT `recording.cap.ts`. That one is CamStack's recorder: our
35245
+ * footage ledger, our storage locations, our retention. This one has a
35246
+ * different authority — the camera's firmware — and per D62 it stores
35247
+ * nothing of its own. Every value here is read from the camera and every
35248
+ * write goes back to the camera; there is no CamStack-side mirror that
35249
+ * could disagree with the device.
35250
+ *
35251
+ * ## One shape, two firmwares
35252
+ *
35253
+ * Measured 2026-09-22 against the live fleet:
35254
+ *
35255
+ * | fact | Hikvision (ISAPI) | Reolink (Baichuan) |
35256
+ * | --- | --- | --- |
35257
+ * | storage | `ContentMgmt/Storage` `<hdd>` rows: status, capacity, freeSpace (MB) | `getHddInfoList` (cmd 102): `mount`, `format`, `capacity` GB + `capacityM` MB remainder |
35258
+ * | tracks | several (101 **and** 103 on both 1436 and 3833), each with its own schedule | one per channel |
35259
+ * | schedule | per track, 7 `ScheduleAction` blocks: DayOfWeek + TimeOfDay range + ONE `ActionRecordingMode` | per trigger type, a 168-char weekly HOUR mask |
35260
+ * | triggers | `CMR`, `MOTION` | `Normal`, `MD`, `people`, `vehicle`, `dog_cat`, `crossline`, `intrude`, `loitering` |
35261
+ * | pre-record | `PreRecordTimeSeconds` | `preRecordTime` |
35262
+ * | post-record | `PostRecordTimeSeconds` | `recordDelayTime` |
35263
+ * | overwrite | per track `LoopEnable` | `cycle`, with `cycleList` enumerating the accepted values |
35264
+ * | segment length | not exposed on V5.7.1 | `packageTime` (minutes) |
35265
+ *
35266
+ * The two schedule models look different and are the same thing in
35267
+ * different coordinates: both answer "for this trigger, during which
35268
+ * weekly windows does the camera record". {@link RecordWindow} is that
35269
+ * question in one shape — Hikvision's ranges map straight onto it,
35270
+ * Reolink's mask expands into hour-aligned windows.
35271
+ *
35272
+ * ## Union, not intersection
35273
+ *
35274
+ * **The same fields exist on every camera.** What differs per device is
35275
+ * which VALUES that device accepts, and that is what {@link
35276
+ * RecordingOnboardOptions} reports — a `{ readable, writable, reason }`
35277
+ * per field plus the schedule's own limits. A control a camera cannot
35278
+ * honour is rendered DISABLED WITH ITS REASON, never missing and never
35279
+ * dead: disabled must not look like broken.
35280
+ *
35281
+ * ## Refusal by name
35282
+ *
35283
+ * A write a camera cannot honour is refused with a sentence the operator
35284
+ * can read — never accepted and dropped. Both providers refuse through
35285
+ * {@link describeOnboardRefusal}, so the vocabulary is one function and
35286
+ * one test, not two hand-written vendor opinions.
35287
+ *
35288
+ * Follows the D14 `deviceConfig` archetype (see `stream-params.cap.ts`):
35289
+ * `getOptions` advertises per-camera availability, `getStatus` (auto-
35290
+ * injected from `status`) reports the live values, and a single
35291
+ * `setSettings` mutation applies a partial change. No hand-written
35292
+ * settings-contribution methods.
35293
+ */
35294
+ /**
35295
+ * What makes the camera start recording during a window.
35296
+ *
35297
+ * The union of both vendors' vocabularies. `continuous` is Hikvision's
35298
+ * `CMR` and Reolink's `Normal`; `motion` is `MOTION` / `MD`. The
35299
+ * object-class triggers are Reolink-only today and the smart-event ones
35300
+ * (`lineCrossing`, `intrusion`, `loitering`) are Reolink-only on the
35301
+ * firmwares measured — a camera that cannot record on a trigger simply
35302
+ * does not list it in `options.schedule.triggers`, and a window naming
35303
+ * it is REFUSED, not dropped.
35304
+ */
35305
+ var RecordTriggerSchema = _enum([
35306
+ "continuous",
35307
+ "motion",
35308
+ "person",
35309
+ "vehicle",
35310
+ "animal",
35311
+ "lineCrossing",
35312
+ "intrusion",
35313
+ "loitering",
35314
+ "alarmInput"
35315
+ ]);
35316
+ /**
35317
+ * One weekly recording window: "on `day`, from `startMinute` to
35318
+ * `endMinute`, record on `trigger`".
35319
+ *
35320
+ * `day` is 0 = Monday … 6 = Sunday (ISO order, which is also the order
35321
+ * both firmwares enumerate). Minutes are local camera time since
35322
+ * midnight; `endMinute` may be 1440, meaning end of day — that is
35323
+ * Hikvision's literal `24:00` and Reolink's 24th mask slot, and
35324
+ * collapsing it to 0 would turn a whole-day window into an empty one.
35325
+ */
35326
+ var RecordWindowSchema = object({
35327
+ trigger: RecordTriggerSchema,
35328
+ day: number().int().min(0).max(6),
35329
+ startMinute: number().int().min(0).max(1439),
35330
+ endMinute: number().int().min(1).max(1440)
35331
+ });
35332
+ /** Status of one physical volume, as the camera itself describes it. */
35333
+ var OnboardStorageVolumeSchema = object({
35334
+ /** The camera's own id for the volume (`hdd/id`, Reolink `HddInfo/number`). */
35335
+ id: string(),
35336
+ /** The camera's own name for it, when it gives one (`hddName`). */
35337
+ label: string().optional(),
35338
+ status: _enum([
35339
+ "ok",
35340
+ "unformatted",
35341
+ "error",
35342
+ "offline",
35343
+ "unknown"
35344
+ ]),
35345
+ /**
35346
+ * Total size in MB, or **null when the camera did not say**.
35347
+ *
35348
+ * Never 0 for an unreadable value: a measurement that failed is not a
35349
+ * measurement (D393), and a card whose size is unknown must not be
35350
+ * rendered as a card of size zero.
35351
+ */
35352
+ capacityMb: number().nullable(),
35353
+ /**
35354
+ * Free space in MB, or null when unknown.
35355
+ *
35356
+ * **Not a proxy for "has footage".** Measured 2026-09-22: 1436 and
35357
+ * 1439 both report exactly 11776 MB free — the fixed reserve a looping
35358
+ * card converges on once it has wrapped. At loop steady state the
35359
+ * number is identical whether the camera recorded yesterday or stopped
35360
+ * a month ago.
35361
+ */
35362
+ freeMb: number().nullable(),
35363
+ /** True when the camera reports the volume writable (`property` RW). */
35364
+ writable: boolean().optional()
35365
+ });
35366
+ object({
35367
+ storage: discriminatedUnion("kind", [
35368
+ object({
35369
+ kind: literal("present"),
35370
+ volumes: array(OnboardStorageVolumeSchema)
35371
+ }),
35372
+ object({
35373
+ kind: literal("absent"),
35374
+ reason: string()
35375
+ }),
35376
+ object({
35377
+ kind: literal("unknown"),
35378
+ reason: string()
35379
+ })
35380
+ ]),
35381
+ tracks: array(object({
35382
+ id: string(),
35383
+ enabled: boolean(),
35384
+ isVideo: boolean(),
35385
+ /** From the camera's own track description. Null when it does not say. */
35386
+ codec: string().nullable(),
35387
+ resolution: string().nullable(),
35388
+ /** Per-track overwrite flag, where the firmware keeps it per track. */
35389
+ overwriteWhenFull: boolean().nullable()
35390
+ })),
35391
+ /**
35392
+ * The track the write path targets — the enabled VIDEO one. Null when
35393
+ * no track could be identified, which is itself a refusal reason.
35394
+ */
35395
+ primaryTrackId: string().nullable(),
35396
+ /** Master "record to the card at all" switch. */
35397
+ enabled: boolean().nullable(),
35398
+ overwriteWhenFull: boolean().nullable(),
35399
+ preRecordSec: number().nullable(),
35400
+ postRecordSec: number().nullable(),
35401
+ /** Length of one recorded file, in minutes. */
35402
+ segmentMinutes: number().nullable(),
35403
+ /** The primary track's weekly windows, flattened. */
35404
+ windows: array(RecordWindowSchema),
35405
+ /**
35406
+ * How many windows the camera described that CamStack could NOT read —
35407
+ * an unrecognised trigger, an unparseable clock, a weekday it does not
35408
+ * name.
35409
+ *
35410
+ * A dropped window is work the reader threw away, and a schedule that
35411
+ * silently shows fewer rows than the camera holds is how an operator
35412
+ * saves back a schedule shorter than the one they were looking at
35413
+ * (D391). Non-zero means the window list is INCOMPLETE and a write
35414
+ * that replaces it would delete what was not shown — which is why a
35415
+ * provider reporting a non-zero count also reports the schedule as not
35416
+ * writable.
35417
+ */
35418
+ unreadableWindows: number(),
35419
+ /**
35420
+ * The camera is scheduled to record and has NO usable storage.
35421
+ *
35422
+ * A first-class fact because it is the fleet's most common silent
35423
+ * defect: measured 2026-09-22, 1441 and 3831 are both motion-recording
35424
+ * to a card that is not there. Neither the schedule nor the storage
35425
+ * read says anything wrong on its own; only the pair does.
35426
+ */
35427
+ recordingToNowhere: boolean(),
35428
+ lastFetchedAt: number()
35429
+ });
35430
+ /** Numeric range descriptor — `{ min, max, step }` per the getOptions convention. */
35431
+ var RangeSchema = object({
35432
+ min: number(),
35433
+ max: number(),
35434
+ step: number()
35435
+ });
35436
+ /**
35437
+ * The values a camera actually takes for a numeric field, when they are a SET
35438
+ * rather than a range.
35439
+ *
35440
+ * `{min,max,step}` cannot say what these two firmwares do. Measured on 1436
35441
+ * (I91DN) on 2026-09-22 by writing each value and reading it back:
35442
+ *
35443
+ * - pre-record: `0, 5, 10, 15, 20, 25, 30` and `2147483647` (INT32_MAX, the
35444
+ * camera's "no limit" — `-1` and `4294967295` both land on it);
35445
+ * - post-record: `5, 10, 30, 60, 120, 300, 600`.
35446
+ *
35447
+ * Neither is expressible as a step: the first has a sentinel two billion away
35448
+ * from its neighbours, the second doubles and then jumps. A range that tried
35449
+ * would forbid values the camera takes AND permit values it silently replaces
35450
+ * with 5 — wrong in both directions at once.
35451
+ *
35452
+ * `sentinel` names the member that is not a duration, so a surface can render
35453
+ * "no limit" instead of `2147483647` seconds.
35454
+ */
35455
+ var AllowedValuesSchema = object({
35456
+ values: array(number()).min(1),
35457
+ sentinel: object({
35458
+ value: number(),
35459
+ meaning: _enum(["no-limit", "disabled"])
35460
+ }).optional()
35461
+ });
35462
+ /**
35463
+ * Per-field availability on ONE camera.
35464
+ *
35465
+ * The field exists on every camera — this says whether this one can be
35466
+ * read and whether it can be written, and `reason` says why not when
35467
+ * either is false. The UI renders the control DISABLED with the reason
35468
+ * rather than hiding it, so a limitation is legible instead of looking
35469
+ * like a missing feature.
35470
+ */
35471
+ var OnboardFieldSupportSchema = object({
35472
+ readable: boolean(),
35473
+ writable: boolean(),
35474
+ /** Required whenever `readable` or `writable` is false. */
35475
+ reason: string().optional()
35476
+ });
35477
+ /** What this camera's schedule model can express. */
35478
+ var OnboardScheduleSupportSchema = object({
35479
+ support: OnboardFieldSupportSchema,
35480
+ /**
35481
+ * The smallest time step the camera can express, in minutes.
35482
+ *
35483
+ * Hikvision takes arbitrary minutes (`00:05:00`–`23:57:00` observed on
35484
+ * 1436's track 103). Reolink's schedule is a 7×24 HOUR mask, so 60. A
35485
+ * window whose edges are not a multiple of this is REFUSED rather than
35486
+ * quietly rounded — rounding is how an operator's 06:30 becomes 06:00
35487
+ * and nothing says so.
35488
+ */
35489
+ granularityMinutes: number(),
35490
+ /** Triggers this camera can record on. A window naming another is refused. */
35491
+ triggers: array(RecordTriggerSchema),
35492
+ /**
35493
+ * False when the camera stores ONE trigger per time range, so two
35494
+ * windows overlapping on the same day cannot carry different triggers.
35495
+ * True on Reolink, whose mask is per-trigger and independent.
35496
+ */
35497
+ supportsOverlappingTriggers: boolean()
35498
+ });
35499
+ var RecordingOnboardOptionsSchema = object({
35500
+ enabled: OnboardFieldSupportSchema,
35501
+ overwriteWhenFull: OnboardFieldSupportSchema,
35502
+ preRecordSec: OnboardFieldSupportSchema,
35503
+ preRecordSecRange: RangeSchema.optional(),
35504
+ /** Preferred over the range when the camera takes a SET, not a span. */
35505
+ preRecordSecAllowed: AllowedValuesSchema.optional(),
35506
+ postRecordSec: OnboardFieldSupportSchema,
35507
+ postRecordSecRange: RangeSchema.optional(),
35508
+ /** Preferred over the range when the camera takes a SET, not a span. */
35509
+ postRecordSecAllowed: AllowedValuesSchema.optional(),
35510
+ segmentMinutes: OnboardFieldSupportSchema,
35511
+ segmentMinutesRange: RangeSchema.optional(),
35512
+ /** Preferred over the range when the camera takes a SET, not a span. */
35513
+ segmentMinutesAllowed: AllowedValuesSchema.optional(),
35514
+ schedule: OnboardScheduleSupportSchema
35515
+ });
35516
+ /**
35517
+ * A partial change. Every field optional.
35518
+ *
35519
+ * Unlike the other `deviceConfig` caps, a provider here does **NOT**
35520
+ * silently ignore a field it cannot support — it refuses, by name,
35521
+ * through {@link describeOnboardRefusal}. Silence on a recording setting
35522
+ * is the failure D62 exists to prevent: the operator believes the camera
35523
+ * is recording the way the form says, and it is not.
35524
+ */
35525
+ var RecordingOnboardPatchSchema = object({
35526
+ enabled: boolean().optional(),
35527
+ overwriteWhenFull: boolean().optional(),
35528
+ preRecordSec: number().optional(),
35529
+ postRecordSec: number().optional(),
35530
+ segmentMinutes: number().optional(),
35531
+ /** The complete new window set for the primary track — not a delta. */
35532
+ windows: array(RecordWindowSchema).optional()
35533
+ });
35534
+ DeviceType.Camera, method(object({ deviceId: number() }), RecordingOnboardOptionsSchema), method(object({
35535
+ deviceId: number(),
35536
+ settings: RecordingOnboardPatchSchema
35537
+ }), _void(), {
35538
+ kind: "mutation",
35539
+ auth: "admin"
35540
+ });
35541
+ /**
35186
35542
  * A camera's own "record me NOW" LEVEL — a signal the device raises while
35187
35543
  * something it knows about is happening (a robot vacuum cleaning, a machine
35188
35544
  * running, a gate open) and lowers when it stops.
@@ -40665,24 +41021,6 @@ Object.freeze({
40665
41021
  addonId: null,
40666
41022
  access: "view"
40667
41023
  },
40668
- "events.getEventClipUrl": {
40669
- capName: "events",
40670
- capScope: "device",
40671
- addonId: null,
40672
- access: "view"
40673
- },
40674
- "events.getEvents": {
40675
- capName: "events",
40676
- capScope: "device",
40677
- addonId: null,
40678
- access: "view"
40679
- },
40680
- "events.getEventThumbnail": {
40681
- capName: "events",
40682
- capScope: "device",
40683
- addonId: null,
40684
- access: "view"
40685
- },
40686
41024
  "faceGallery.assignFace": {
40687
41025
  capName: "face-gallery",
40688
41026
  capScope: "system",
@@ -43557,224 +43895,236 @@ Object.freeze({
43557
43895
  addonId: null,
43558
43896
  access: "create"
43559
43897
  },
43560
- "recording.applyDeviceSettingsPatch": {
43898
+ "recording.getAvailability": {
43561
43899
  capName: "recording",
43562
- capScope: "system",
43900
+ capScope: "device",
43563
43901
  addonId: null,
43564
- access: "create"
43902
+ access: "view"
43565
43903
  },
43566
- "recording.cancelRelocateJob": {
43904
+ "recording.getDaysWithRecordings": {
43567
43905
  capName: "recording",
43568
- capScope: "system",
43906
+ capScope: "device",
43569
43907
  addonId: null,
43570
- access: "create"
43908
+ access: "view"
43571
43909
  },
43572
- "recording.cancelStorageMigrationMove": {
43910
+ "recording.getPlayback": {
43573
43911
  capName: "recording",
43574
- capScope: "system",
43912
+ capScope: "device",
43575
43913
  addonId: null,
43576
- access: "create"
43914
+ access: "view"
43577
43915
  },
43578
- "recording.deleteFootprint": {
43916
+ "recording.getPlaybackOptions": {
43579
43917
  capName: "recording",
43580
- capScope: "system",
43918
+ capScope: "device",
43581
43919
  addonId: null,
43582
- access: "delete"
43920
+ access: "view"
43583
43921
  },
43584
- "recording.getAvailability": {
43922
+ "recording.listSources": {
43585
43923
  capName: "recording",
43586
- capScope: "system",
43924
+ capScope: "device",
43587
43925
  addonId: null,
43588
43926
  access: "view"
43589
43927
  },
43590
- "recording.getAvailabilityBatch": {
43591
- capName: "recording",
43928
+ "recordingArchive.applyDeviceSettingsPatch": {
43929
+ capName: "recording-archive",
43592
43930
  capScope: "system",
43593
43931
  addonId: null,
43594
- access: "view"
43932
+ access: "create"
43595
43933
  },
43596
- "recording.getDaysWithRecordings": {
43597
- capName: "recording",
43934
+ "recordingArchive.cancelRelocateJob": {
43935
+ capName: "recording-archive",
43598
43936
  capScope: "system",
43599
43937
  addonId: null,
43600
- access: "view"
43938
+ access: "create"
43601
43939
  },
43602
- "recording.getDaysWithRecordingsBatch": {
43603
- capName: "recording",
43940
+ "recordingArchive.cancelStorageMigrationMove": {
43941
+ capName: "recording-archive",
43942
+ capScope: "system",
43943
+ addonId: null,
43944
+ access: "create"
43945
+ },
43946
+ "recordingArchive.deleteFootprint": {
43947
+ capName: "recording-archive",
43948
+ capScope: "system",
43949
+ addonId: null,
43950
+ access: "delete"
43951
+ },
43952
+ "recordingArchive.getAvailabilityBatch": {
43953
+ capName: "recording-archive",
43604
43954
  capScope: "system",
43605
43955
  addonId: null,
43606
43956
  access: "view"
43607
43957
  },
43608
- "recording.getDeviceConfig": {
43609
- capName: "recording",
43958
+ "recordingArchive.getDaysWithRecordingsBatch": {
43959
+ capName: "recording-archive",
43610
43960
  capScope: "system",
43611
43961
  addonId: null,
43612
43962
  access: "view"
43613
43963
  },
43614
- "recording.getDeviceLiveContribution": {
43615
- capName: "recording",
43964
+ "recordingArchive.getDeviceConfig": {
43965
+ capName: "recording-archive",
43616
43966
  capScope: "system",
43617
43967
  addonId: null,
43618
43968
  access: "view"
43619
43969
  },
43620
- "recording.getDeviceSettingsContribution": {
43621
- capName: "recording",
43970
+ "recordingArchive.getDeviceLiveContribution": {
43971
+ capName: "recording-archive",
43622
43972
  capScope: "system",
43623
43973
  addonId: null,
43624
43974
  access: "view"
43625
43975
  },
43626
- "recording.getPlacement": {
43627
- capName: "recording",
43976
+ "recordingArchive.getDeviceSettingsContribution": {
43977
+ capName: "recording-archive",
43628
43978
  capScope: "system",
43629
43979
  addonId: null,
43630
43980
  access: "view"
43631
43981
  },
43632
- "recording.getPlaybackManifest": {
43633
- capName: "recording",
43982
+ "recordingArchive.getPlacement": {
43983
+ capName: "recording-archive",
43634
43984
  capScope: "system",
43635
43985
  addonId: null,
43636
43986
  access: "view"
43637
43987
  },
43638
- "recording.getRelocateResidue": {
43639
- capName: "recording",
43988
+ "recordingArchive.getRelocateResidue": {
43989
+ capName: "recording-archive",
43640
43990
  capScope: "system",
43641
43991
  addonId: null,
43642
43992
  access: "view"
43643
43993
  },
43644
- "recording.getStatus": {
43645
- capName: "recording",
43994
+ "recordingArchive.getStatus": {
43995
+ capName: "recording-archive",
43646
43996
  capScope: "system",
43647
43997
  addonId: null,
43648
43998
  access: "view"
43649
43999
  },
43650
- "recording.getStorageMigrationMoveStatus": {
43651
- capName: "recording",
44000
+ "recordingArchive.getStorageMigrationMoveStatus": {
44001
+ capName: "recording-archive",
43652
44002
  capScope: "system",
43653
44003
  addonId: null,
43654
44004
  access: "view"
43655
44005
  },
43656
- "recording.getStorageUsage": {
43657
- capName: "recording",
44006
+ "recordingArchive.getStorageUsage": {
44007
+ capName: "recording-archive",
43658
44008
  capScope: "system",
43659
44009
  addonId: null,
43660
44010
  access: "view"
43661
44011
  },
43662
- "recording.listOpsLog": {
43663
- capName: "recording",
44012
+ "recordingArchive.listOpsLog": {
44013
+ capName: "recording-archive",
43664
44014
  capScope: "system",
43665
44015
  addonId: null,
43666
44016
  access: "view"
43667
44017
  },
43668
- "recording.listRelocateJobs": {
43669
- capName: "recording",
44018
+ "recordingArchive.listRelocateJobs": {
44019
+ capName: "recording-archive",
43670
44020
  capScope: "system",
43671
44021
  addonId: null,
43672
44022
  access: "view"
43673
44023
  },
43674
- "recording.locateSegment": {
43675
- capName: "recording",
44024
+ "recordingArchive.locateSegment": {
44025
+ capName: "recording-archive",
43676
44026
  capScope: "system",
43677
44027
  addonId: null,
43678
44028
  access: "view"
43679
44029
  },
43680
- "recording.pauseForStorageMigration": {
43681
- capName: "recording",
44030
+ "recordingArchive.pauseForStorageMigration": {
44031
+ capName: "recording-archive",
43682
44032
  capScope: "system",
43683
44033
  addonId: null,
43684
44034
  access: "create"
43685
44035
  },
43686
- "recording.planStorageRebalance": {
43687
- capName: "recording",
44036
+ "recordingArchive.planStorageRebalance": {
44037
+ capName: "recording-archive",
43688
44038
  capScope: "system",
43689
44039
  addonId: null,
43690
44040
  access: "view"
43691
44041
  },
43692
- "recording.pruneFootage": {
43693
- capName: "recording",
44042
+ "recordingArchive.pruneFootage": {
44043
+ capName: "recording-archive",
43694
44044
  capScope: "system",
43695
44045
  addonId: null,
43696
44046
  access: "create"
43697
44047
  },
43698
- "recording.readGopBytes": {
43699
- capName: "recording",
44048
+ "recordingArchive.readGopBytes": {
44049
+ capName: "recording-archive",
43700
44050
  capScope: "system",
43701
44051
  addonId: null,
43702
44052
  access: "view"
43703
44053
  },
43704
- "recording.readSegmentBytes": {
43705
- capName: "recording",
44054
+ "recordingArchive.readSegmentBytes": {
44055
+ capName: "recording-archive",
43706
44056
  capScope: "system",
43707
44057
  addonId: null,
43708
44058
  access: "view"
43709
44059
  },
43710
- "recording.readWindowBytes": {
43711
- capName: "recording",
44060
+ "recordingArchive.readWindowBytes": {
44061
+ capName: "recording-archive",
43712
44062
  capScope: "system",
43713
44063
  addonId: null,
43714
44064
  access: "view"
43715
44065
  },
43716
- "recording.reconcileLedgerAgainstDisk": {
43717
- capName: "recording",
44066
+ "recordingArchive.reconcileLedgerAgainstDisk": {
44067
+ capName: "recording-archive",
43718
44068
  capScope: "system",
43719
44069
  addonId: null,
43720
44070
  access: "create"
43721
44071
  },
43722
- "recording.refreshStorageLocationsForMigration": {
43723
- capName: "recording",
44072
+ "recordingArchive.refreshStorageLocationsForMigration": {
44073
+ capName: "recording-archive",
43724
44074
  capScope: "system",
43725
44075
  addonId: null,
43726
44076
  access: "create"
43727
44077
  },
43728
- "recording.relocateFootage": {
43729
- capName: "recording",
44078
+ "recordingArchive.relocateFootage": {
44079
+ capName: "recording-archive",
43730
44080
  capScope: "system",
43731
44081
  addonId: null,
43732
44082
  access: "create"
43733
44083
  },
43734
- "recording.renderClip": {
43735
- capName: "recording",
44084
+ "recordingArchive.renderClip": {
44085
+ capName: "recording-archive",
43736
44086
  capScope: "system",
43737
44087
  addonId: null,
43738
44088
  access: "create"
43739
44089
  },
43740
- "recording.renderGif": {
43741
- capName: "recording",
44090
+ "recordingArchive.renderGif": {
44091
+ capName: "recording-archive",
43742
44092
  capScope: "system",
43743
44093
  addonId: null,
43744
44094
  access: "create"
43745
44095
  },
43746
- "recording.rescanStorage": {
43747
- capName: "recording",
44096
+ "recordingArchive.rescanStorage": {
44097
+ capName: "recording-archive",
43748
44098
  capScope: "system",
43749
44099
  addonId: null,
43750
44100
  access: "create"
43751
44101
  },
43752
- "recording.resumeForStorageMigration": {
43753
- capName: "recording",
44102
+ "recordingArchive.resumeForStorageMigration": {
44103
+ capName: "recording-archive",
43754
44104
  capScope: "system",
43755
44105
  addonId: null,
43756
44106
  access: "create"
43757
44107
  },
43758
- "recording.setDeviceConfig": {
43759
- capName: "recording",
44108
+ "recordingArchive.setDeviceConfig": {
44109
+ capName: "recording-archive",
43760
44110
  capScope: "system",
43761
44111
  addonId: null,
43762
44112
  access: "create"
43763
44113
  },
43764
- "recording.setDevicePlacement": {
43765
- capName: "recording",
44114
+ "recordingArchive.setDevicePlacement": {
44115
+ capName: "recording-archive",
43766
44116
  capScope: "system",
43767
44117
  addonId: null,
43768
44118
  access: "create"
43769
44119
  },
43770
- "recording.startStorageMigrationMove": {
43771
- capName: "recording",
44120
+ "recordingArchive.startStorageMigrationMove": {
44121
+ capName: "recording-archive",
43772
44122
  capScope: "system",
43773
44123
  addonId: null,
43774
44124
  access: "create"
43775
44125
  },
43776
- "recording.startStorageRebalance": {
43777
- capName: "recording",
44126
+ "recordingArchive.startStorageRebalance": {
44127
+ capName: "recording-archive",
43778
44128
  capScope: "system",
43779
44129
  addonId: null,
43780
44130
  access: "create"
@@ -46079,21 +46429,6 @@ Object.freeze({
46079
46429
  form: "single",
46080
46430
  optional: false
46081
46431
  }],
46082
- "events.getEventClipUrl": [{
46083
- name: "deviceId",
46084
- form: "single",
46085
- optional: false
46086
- }],
46087
- "events.getEvents": [{
46088
- name: "deviceId",
46089
- form: "single",
46090
- optional: false
46091
- }],
46092
- "events.getEventThumbnail": [{
46093
- name: "deviceId",
46094
- form: "single",
46095
- optional: false
46096
- }],
46097
46432
  "faceGallery.getFaceByTrack": [{
46098
46433
  name: "deviceId",
46099
46434
  form: "single",
@@ -47012,107 +47347,117 @@ Object.freeze({
47012
47347
  form: "single",
47013
47348
  optional: false
47014
47349
  }],
47015
- "recording.deleteFootprint": [{
47350
+ "recording.getAvailability": [{
47016
47351
  name: "deviceId",
47017
47352
  form: "single",
47018
47353
  optional: false
47019
47354
  }],
47020
- "recording.getAvailability": [{
47355
+ "recording.getDaysWithRecordings": [{
47021
47356
  name: "deviceId",
47022
47357
  form: "single",
47023
47358
  optional: false
47024
47359
  }],
47025
- "recording.getAvailabilityBatch": [{
47026
- name: "deviceIds",
47027
- form: "array",
47360
+ "recording.getPlayback": [{
47361
+ name: "deviceId",
47362
+ form: "single",
47028
47363
  optional: false
47029
47364
  }],
47030
- "recording.getDaysWithRecordings": [{
47365
+ "recording.getPlaybackOptions": [{
47031
47366
  name: "deviceId",
47032
47367
  form: "single",
47033
47368
  optional: false
47034
47369
  }],
47035
- "recording.getDaysWithRecordingsBatch": [{
47036
- name: "deviceIds",
47037
- form: "array",
47370
+ "recording.listSources": [{
47371
+ name: "deviceId",
47372
+ form: "single",
47038
47373
  optional: false
47039
47374
  }],
47040
- "recording.getDeviceConfig": [{
47375
+ "recordingArchive.deleteFootprint": [{
47041
47376
  name: "deviceId",
47042
47377
  form: "single",
47043
47378
  optional: false
47044
47379
  }],
47045
- "recording.getPlaybackManifest": [{
47380
+ "recordingArchive.getAvailabilityBatch": [{
47381
+ name: "deviceIds",
47382
+ form: "array",
47383
+ optional: false
47384
+ }],
47385
+ "recordingArchive.getDaysWithRecordingsBatch": [{
47386
+ name: "deviceIds",
47387
+ form: "array",
47388
+ optional: false
47389
+ }],
47390
+ "recordingArchive.getDeviceConfig": [{
47046
47391
  name: "deviceId",
47047
47392
  form: "single",
47048
47393
  optional: false
47049
47394
  }],
47050
- "recording.listOpsLog": [{
47395
+ "recordingArchive.listOpsLog": [{
47051
47396
  name: "deviceId",
47052
47397
  form: "single",
47053
47398
  optional: true
47054
47399
  }],
47055
- "recording.locateSegment": [{
47400
+ "recordingArchive.locateSegment": [{
47056
47401
  name: "deviceId",
47057
47402
  form: "single",
47058
47403
  optional: false
47059
47404
  }],
47060
- "recording.pruneFootage": [{
47405
+ "recordingArchive.pruneFootage": [{
47061
47406
  name: "deviceId",
47062
47407
  form: "single",
47063
47408
  optional: false
47064
47409
  }],
47065
- "recording.readGopBytes": [{
47410
+ "recordingArchive.readGopBytes": [{
47066
47411
  name: "deviceId",
47067
47412
  form: "single",
47068
47413
  optional: false
47069
47414
  }],
47070
- "recording.readSegmentBytes": [{
47415
+ "recordingArchive.readSegmentBytes": [{
47071
47416
  name: "deviceId",
47072
47417
  form: "single",
47073
47418
  optional: false
47074
47419
  }],
47075
- "recording.readWindowBytes": [{
47420
+ "recordingArchive.readWindowBytes": [{
47076
47421
  name: "deviceId",
47077
47422
  form: "single",
47078
47423
  optional: false
47079
47424
  }],
47080
- "recording.reconcileLedgerAgainstDisk": [{
47425
+ "recordingArchive.reconcileLedgerAgainstDisk": [{
47081
47426
  name: "deviceId",
47082
47427
  form: "single",
47083
47428
  optional: true
47084
47429
  }],
47085
- "recording.relocateFootage": [{
47430
+ "recordingArchive.relocateFootage": [{
47086
47431
  name: "deviceId",
47087
47432
  form: "single",
47088
47433
  optional: true
47089
47434
  }],
47090
- "recording.renderClip": [{
47435
+ "recordingArchive.renderClip": [{
47091
47436
  name: "deviceId",
47092
47437
  form: "single",
47093
47438
  optional: false
47094
47439
  }],
47095
- "recording.renderGif": [{
47440
+ "recordingArchive.renderGif": [{
47096
47441
  name: "deviceId",
47097
47442
  form: "single",
47098
47443
  optional: false
47099
47444
  }],
47100
- "recording.rescanStorage": [{
47445
+ "recordingArchive.rescanStorage": [{
47101
47446
  name: "deviceId",
47102
47447
  form: "single",
47103
47448
  optional: false
47104
47449
  }],
47105
- "recording.setDeviceConfig": [{
47450
+ "recordingArchive.setDeviceConfig": [{
47106
47451
  name: "deviceId",
47107
47452
  form: "single",
47108
47453
  optional: false
47109
47454
  }],
47110
- "recording.setDevicePlacement": [{
47455
+ "recordingArchive.setDevicePlacement": [{
47111
47456
  name: "deviceId",
47112
47457
  form: "single",
47113
47458
  optional: false
47114
47459
  }],
47115
- "recording.startStorageMigrationMove": [{
47460
+ "recordingArchive.startStorageMigrationMove": [{
47116
47461
  name: "deviceId",
47117
47462
  form: "single",
47118
47463
  optional: true
@@ -49409,6 +49754,18 @@ Object.defineProperty(exports, "RECORDING_EXPORT_MAX_READ_BYTES", {
49409
49754
  return RECORDING_EXPORT_MAX_READ_BYTES;
49410
49755
  }
49411
49756
  });
49757
+ Object.defineProperty(exports, "RECORDING_SOURCE_CAMSTACK", {
49758
+ enumerable: true,
49759
+ get: function() {
49760
+ return RECORDING_SOURCE_CAMSTACK;
49761
+ }
49762
+ });
49763
+ Object.defineProperty(exports, "RECORDING_SOURCE_CAMSTACK_ADDON", {
49764
+ enumerable: true,
49765
+ get: function() {
49766
+ return RECORDING_SOURCE_CAMSTACK_ADDON;
49767
+ }
49768
+ });
49412
49769
  Object.defineProperty(exports, "RecordingConfigSchema", {
49413
49770
  enumerable: true,
49414
49771
  get: function() {
@@ -49883,6 +50240,12 @@ Object.defineProperty(exports, "record", {
49883
50240
  return record;
49884
50241
  }
49885
50242
  });
50243
+ Object.defineProperty(exports, "recordingArchiveCapability", {
50244
+ enumerable: true,
50245
+ get: function() {
50246
+ return recordingArchiveCapability;
50247
+ }
50248
+ });
49886
50249
  Object.defineProperty(exports, "recordingCapability", {
49887
50250
  enumerable: true,
49888
50251
  get: function() {