@camstack/system 1.2.390 → 1.2.391

package/dist/builtins/device-manager/device-meta-actions.d.ts

@@ -1,337 +1,338 @@
-import { AddonContext, deviceManagerCapability, InferProvider } from '@camstack/types';
-import { DeviceMetaStore } from './device-meta-store.js';
-import { ProviderContext } from './device-provider-context.js';
+import type { AddonContext } from "@camstack/types";
+import { deviceManagerCapability, InferProvider } from "@camstack/types";
+import type { DeviceMetaStore } from "./device-meta-store.js";
+import type { ProviderContext } from "./device-provider-context.js";
 type IDeviceManagerProvider = InferProvider<typeof deviceManagerCapability>;
 /**
- * Stamp (or update) the owning integration id on a device's meta row + emit
- * `DeviceMetaChanged`. The device-manager chokepoint shared by the
- * `setIntegrationId` cap handler AND the create/adopt forwarders (queries)
- * that stamp an integration's ownership onto every device it materializes.
- * Idempotent. Takes its low-level deps directly (not the full `ProviderContext`)
- * because `ProviderContext.stampIntegrationId` delegates HERE — passing the
- * context would be a capture cycle.
- */
+* Stamp (or update) the owning integration id on a device's meta row + emit
+* `DeviceMetaChanged`. The device-manager chokepoint shared by the
+* `setIntegrationId` cap handler AND the create/adopt forwarders (queries)
+* that stamp an integration's ownership onto every device it materializes.
+* Idempotent. Takes its low-level deps directly (not the full `ProviderContext`)
+* because `ProviderContext.stampIntegrationId` delegates HERE — passing the
+* context would be a capture cycle.
+*/
 export declare function stampIntegrationId(metaStore: DeviceMetaStore, ctx: AddonContext, deviceId: number, integrationId: string): Promise<void>;
-export declare function allocateDeviceId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['allocateDeviceId']>[0]): ReturnType<IDeviceManagerProvider['allocateDeviceId']>;
+export declare function allocateDeviceId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["allocateDeviceId"]>[0]): ReturnType<IDeviceManagerProvider["allocateDeviceId"]>;
 /**
- * Replace a camera: the new hardware inherits the number the system knows.
- *
- * The composition lives in `migrate-device.ts`, deliberately free of this
- * file's context so the decisions it carries — above all "never report a switch
- * as off when it could not be written" — are testable without a hub. This is
- * the wiring: the real dependencies, and the write lock.
- *
- * The temp id comes from `allocateNextDeviceId`, the monotonic counter, so the
- * value a crash could park a row on was never used and will never be reused.
- * `swapIds` therefore runs INSIDE the same lock the id was allocated under.
- *
- * Retry-safe since 2026-09-04 (`migrate-guard.ts`): a concurrent call touching
- * either device is REFUSED before it can queue on the lock, and a repeat of a
- * completed swap — matched against the `addonId`/`stableId` fingerprint the
- * swap left on the rows — is a no-op returning the original report. A client
- * retry ran a second full cycle on 2026-09-01 and swapped two cameras back;
- * neither path can re-run a swap any more.
- */
-export declare function migrateDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['migrateDevice']>[0]): ReturnType<IDeviceManagerProvider['migrateDevice']>;
-export declare function registerDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['registerDevice']>[0]): ReturnType<IDeviceManagerProvider['registerDevice']>;
-export declare function removeDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['removeDevice']>[0]): ReturnType<IDeviceManagerProvider['removeDevice']>;
-export declare function persistConfig(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['persistConfig']>[0]): ReturnType<IDeviceManagerProvider['persistConfig']>;
-export declare function loadConfig(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['loadConfig']>[0]): ReturnType<IDeviceManagerProvider['loadConfig']>;
+* Replace a camera: the new hardware inherits the number the system knows.
+*
+* The composition lives in `migrate-device.ts`, deliberately free of this
+* file's context so the decisions it carries — above all "never report a switch
+* as off when it could not be written" — are testable without a hub. This is
+* the wiring: the real dependencies, and the write lock.
+*
+* The temp id comes from `allocateNextDeviceId`, the monotonic counter, so the
+* value a crash could park a row on was never used and will never be reused.
+* `swapIds` therefore runs INSIDE the same lock the id was allocated under.
+*
+* Retry-safe since 2026-09-04 (`migrate-guard.ts`): a concurrent call touching
+* either device is REFUSED before it can queue on the lock, and a repeat of a
+* completed swap — matched against the `addonId`/`stableId` fingerprint the
+* swap left on the rows — is a no-op returning the original report. A client
+* retry ran a second full cycle on 2026-09-01 and swapped two cameras back;
+* neither path can re-run a swap any more.
+*/
+export declare function migrateDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["migrateDevice"]>[0]): ReturnType<IDeviceManagerProvider["migrateDevice"]>;
+export declare function registerDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["registerDevice"]>[0]): ReturnType<IDeviceManagerProvider["registerDevice"]>;
+export declare function removeDevice(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["removeDevice"]>[0]): ReturnType<IDeviceManagerProvider["removeDevice"]>;
+export declare function persistConfig(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["persistConfig"]>[0]): ReturnType<IDeviceManagerProvider["persistConfig"]>;
+export declare function loadConfig(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["loadConfig"]>[0]): ReturnType<IDeviceManagerProvider["loadConfig"]>;
 /**
- * Load the operator-organisational meta surface for one device
- * (`name` / `location` / `disabled` / `type` / `parentDeviceId`
- * / `addonId` + `id` / `stableId`). Used by the kernel proxy's
- * device-context factory to populate `ctx.deviceMeta` before
- * the device class constructor runs. Returns `null` when no
- * persisted row exists for the id.
- *
- * Reads default `location` to `null` and `disabled` to `false`
- * for legacy rows that predate the field — production code
- * relies on the IDevice type contract that both are present.
- */
-export declare function loadMeta(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['loadMeta']>[0]): ReturnType<IDeviceManagerProvider['loadMeta']>;
+* Load the operator-organisational meta surface for one device
+* (`name` / `location` / `disabled` / `type` / `parentDeviceId`
+* / `addonId` + `id` / `stableId`). Used by the kernel proxy's
+* device-context factory to populate `ctx.deviceMeta` before
+* the device class constructor runs. Returns `null` when no
+* persisted row exists for the id.
+*
+* Reads default `location` to `null` and `disabled` to `false`
+* for legacy rows that predate the field — production code
+* relies on the IDevice type contract that both are present.
+*/
+export declare function loadMeta(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["loadMeta"]>[0]): ReturnType<IDeviceManagerProvider["loadMeta"]>;
 /**
- * Update the operator-edited display name. Writes the meta
- * row, emits a `DeviceMetaChanged` event so live consumers
- * (UI device list, alert center) see the rename without
- * polling. The live `IDevice.name` mirror is updated by the
- * kernel proxy on its side (`device-cap-proxy.ts`).
- */
-export declare function setName(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setName']>[0]): ReturnType<IDeviceManagerProvider['setName']>;
+* Update the operator-edited display name. Writes the meta
+* row, emits a `DeviceMetaChanged` event so live consumers
+* (UI device list, alert center) see the rename without
+* polling. The live `IDevice.name` mirror is updated by the
+* kernel proxy on its side (`device-cap-proxy.ts`).
+*/
+export declare function setName(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setName"]>[0]): ReturnType<IDeviceManagerProvider["setName"]>;
 /**
- * Update the operator-organisational location label. `null`
- * clears it. Mirrors the same persist-then-emit shape as
- * `setName`; consumers subscribe to `DeviceMetaChanged` and
- * filter on `field: 'location'`.
- *
- * CASCADE (operator decision, 2026-08-26; widened to EVERY parent 2026-09-01):
- * supersedes the read-time inheritance `device-linked-devices.ts` used to
- * resolve. The SAME location is written to every descendant's own `location`
- * column, recursively, in this exact call — never resolved live by a reader
- * again. This DELIBERATELY overwrites a descendant's own, possibly different,
- * location: a cascade is a write, and a write that stops at an existing value
- * is not a cascade — the operator setting the parent's location is understood
- * as organising the whole subtree by it.
- *
- * NO TYPE PREDICATE. The cascade used to fire only for `DeviceType.Container`,
- * which split the fleet by an accident of provider modelling: on the measured
- * hub, 50 containers cascaded to 440 children while 13 non-container parents
- * (11 `camera`, 2 `hub`) left 20 accessories behind. The Locations page tells
- * the operator "assign the parent, the accessories follow"; a predicate here
- * would make that a lie for exactly the cameras. `collectDescendants` is
- * type-agnostic, and so is this.
- *
- * RETROACTIVITY: this only runs when `setLocation` is called. A parent that
- * already had a location before this shipped does NOT retroactively align its
- * descendants — they stay unaligned until the operator re-saves the parent's
- * location.
- *
- * ATOMICITY: the whole cascade runs inside ONE `withMetaWriteLock` critical
- * section, so no concurrent writer can interleave a read or a write into the
- * middle of it — but it is still N separate row writes, not one transaction.
- * A row write that throws does NOT abort the cascade (a swallowed continue,
- * not a silent one): it is collected as a failure, every other descendant is
- * still attempted, and if any failed the outcome is logged at `error` with
- * every failing id — never indistinguishable from a clean cascade. A
- * `DeviceMetaChanged` event fires for the parent itself and for every
- * descendant actually written (never for one that failed), so linked-device
- * consumers (the linked-devices picker, which suggests by location) see exactly what landed.
- */
-export declare function setLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocation']>[0]): ReturnType<IDeviceManagerProvider['setLocation']>;
+* Update the operator-organisational location label. `null`
+* clears it. Mirrors the same persist-then-emit shape as
+* `setName`; consumers subscribe to `DeviceMetaChanged` and
+* filter on `field: 'location'`.
+*
+* CASCADE (operator decision, 2026-08-26; widened to EVERY parent 2026-09-01):
+* supersedes the read-time inheritance `device-linked-devices.ts` used to
+* resolve. The SAME location is written to every descendant's own `location`
+* column, recursively, in this exact call — never resolved live by a reader
+* again. This DELIBERATELY overwrites a descendant's own, possibly different,
+* location: a cascade is a write, and a write that stops at an existing value
+* is not a cascade — the operator setting the parent's location is understood
+* as organising the whole subtree by it.
+*
+* NO TYPE PREDICATE. The cascade used to fire only for `DeviceType.Container`,
+* which split the fleet by an accident of provider modelling: on the measured
+* hub, 50 containers cascaded to 440 children while 13 non-container parents
+* (11 `camera`, 2 `hub`) left 20 accessories behind. The Locations page tells
+* the operator "assign the parent, the accessories follow"; a predicate here
+* would make that a lie for exactly the cameras. `collectDescendants` is
+* type-agnostic, and so is this.
+*
+* RETROACTIVITY: this only runs when `setLocation` is called. A parent that
+* already had a location before this shipped does NOT retroactively align its
+* descendants — they stay unaligned until the operator re-saves the parent's
+* location.
+*
+* ATOMICITY: the whole cascade runs inside ONE `withMetaWriteLock` critical
+* section, so no concurrent writer can interleave a read or a write into the
+* middle of it — but it is still N separate row writes, not one transaction.
+* A row write that throws does NOT abort the cascade (a swallowed continue,
+* not a silent one): it is collected as a failure, every other descendant is
+* still attempted, and if any failed the outcome is logged at `error` with
+* every failing id — never indistinguishable from a clean cascade. A
+* `DeviceMetaChanged` event fires for the parent itself and for every
+* descendant actually written (never for one that failed), so linked-device
+* consumers (the linked-devices picker, which suggests by location) see exactly what landed.
+*/
+export declare function setLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setLocation"]>[0]): ReturnType<IDeviceManagerProvider["setLocation"]>;
 /**
- * Update the device type. Writes the meta row, emits a
- * `DeviceMetaChanged` event. Used by the kernel to apply
- * `initialMeta.type` before device construction so the device
- * constructs with its real type instead of the `allocateDeviceId`
- * placeholder `'generic'`.
- */
-export declare function setType(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setType']>[0]): ReturnType<IDeviceManagerProvider['setType']>;
+* Update the device type. Writes the meta row, emits a
+* `DeviceMetaChanged` event. Used by the kernel to apply
+* `initialMeta.type` before device construction so the device
+* constructs with its real type instead of the `allocateDeviceId`
+* placeholder `'generic'`.
+*/
+export declare function setType(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setType"]>[0]): ReturnType<IDeviceManagerProvider["setType"]>;
 /**
- * Stamp (or update) the owning integration id on the device's
- * meta row. Called by the kernel's `create()` pre-seed path
- * when `initialMeta.integrationId` is set (analogous to
- * `setName` / `setType`). Idempotent.
- */
-export declare function setIntegrationId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setIntegrationId']>[0]): ReturnType<IDeviceManagerProvider['setIntegrationId']>;
+* Stamp (or update) the owning integration id on the device's
+* meta row. Called by the kernel's `create()` pre-seed path
+* when `initialMeta.integrationId` is set (analogous to
+* `setName` / `setType`). Idempotent.
+*/
+export declare function setIntegrationId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setIntegrationId"]>[0]): ReturnType<IDeviceManagerProvider["setIntegrationId"]>;
 /**
- * Stamp (or update) the linked device id on the device's meta
- * row. Called by the kernel's `create()` pre-seed path when
- * `initialMeta.linkDeviceId` is set (analogous to `setIntegrationId`).
- * Idempotent. `null` explicitly clears a previous link.
- */
-export declare function setLinkDeviceId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLinkDeviceId']>[0]): ReturnType<IDeviceManagerProvider['setLinkDeviceId']>;
+* Stamp (or update) the linked device id on the device's meta
+* row. Called by the kernel's `create()` pre-seed path when
+* `initialMeta.linkDeviceId` is set (analogous to `setIntegrationId`).
+* Idempotent. `null` explicitly clears a previous link.
+*/
+export declare function setLinkDeviceId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setLinkDeviceId"]>[0]): ReturnType<IDeviceManagerProvider["setLinkDeviceId"]>;
 /**
- * Set (or clear) the durable primary-child override on a CONTAINER
- * device's meta row, keyed on the chosen child's re-sync/rename-stable
- * `entityId`. Mirrors `setLinkDeviceId` but persists a string entityId
- * (survives a re-sync that reallocates the child's numeric id) instead
- * of the numeric child id. `null` clears the override → priority default.
- */
-export declare function setPrimaryChildEntityId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setPrimaryChildEntityId']>[0]): ReturnType<IDeviceManagerProvider['setPrimaryChildEntityId']>;
+* Set (or clear) the durable primary-child override on a CONTAINER
+* device's meta row, keyed on the chosen child's re-sync/rename-stable
+* `entityId`. Mirrors `setLinkDeviceId` but persists a string entityId
+* (survives a re-sync that reallocates the child's numeric id) instead
+* of the numeric child id. `null` clears the override → priority default.
+*/
+export declare function setPrimaryChildEntityId(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setPrimaryChildEntityId"]>[0]): ReturnType<IDeviceManagerProvider["setPrimaryChildEntityId"]>;
 /**
- * Set (or replace) the container-level `childLayout` on a device's
- * meta row. Mirrors `setPrimaryChildEntityId` but persists the
- * accordion-section layout array (parent-only). Persisted, projected,
- * and preserved across re-register/restore.
- */
-export declare function setChildLayout(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setChildLayout']>[0]): ReturnType<IDeviceManagerProvider['setChildLayout']>;
+* Set (or replace) the container-level `childLayout` on a device's
+* meta row. Mirrors `setPrimaryChildEntityId` but persists the
+* accordion-section layout array (parent-only). Persisted, projected,
+* and preserved across re-register/restore.
+*/
+export declare function setChildLayout(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setChildLayout"]>[0]): ReturnType<IDeviceManagerProvider["setChildLayout"]>;
 /**
- * Stamp (or update) the semantic role on the device's meta row.
- * Called by the kernel's `create()` / `spawnAccessoryChild`
- * pre-seed when `initialMeta.role` is set (analogous to
- * `setIntegrationId`). Idempotent. `null` clears a previous role.
- */
-export declare function setRole(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setRole']>[0]): ReturnType<IDeviceManagerProvider['setRole']>;
+* Stamp (or update) the semantic role on the device's meta row.
+* Called by the kernel's `create()` / `spawnAccessoryChild`
+* pre-seed when `initialMeta.role` is set (analogous to
+* `setIntegrationId`). Idempotent. `null` clears a previous role.
+*/
+export declare function setRole(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setRole"]>[0]): ReturnType<IDeviceManagerProvider["setRole"]>;
 /**
- * Set (or clear) the per-device display override on a device's meta row.
- * Mirrors `setChildLayout` persistence; `null` REMOVES the `display` key
- * entirely (immutable rest-destructure — matches the "absent ⇒ no override"
- * projection contract, never persists `display: undefined`). Override units are
- * normalized at write so the render path always looks up canonical spellings.
- */
-export declare function setDisplay(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setDisplay']>[0]): ReturnType<IDeviceManagerProvider['setDisplay']>;
+* Set (or clear) the per-device display override on a device's meta row.
+* Mirrors `setChildLayout` persistence; `null` REMOVES the `display` key
+* entirely (immutable rest-destructure — matches the "absent ⇒ no override"
+* projection contract, never persists `display: undefined`). Override units are
+* normalized at write so the render path always looks up canonical spellings.
+*/
+export declare function setDisplay(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setDisplay"]>[0]): ReturnType<IDeviceManagerProvider["setDisplay"]>;
 /**
- * Read the operator-authored per-role display defaults. Empty record when none
- * set. Not per-device — a plain top-level-key read.
- */
-export declare function getRoleDisplayDefaults(pctx: ProviderContext, _input: Parameters<IDeviceManagerProvider['getRoleDisplayDefaults']>[0]): ReturnType<IDeviceManagerProvider['getRoleDisplayDefaults']>;
+* Read the operator-authored per-role display defaults. Empty record when none
+* set. Not per-device — a plain top-level-key read.
+*/
+export declare function getRoleDisplayDefaults(pctx: ProviderContext, _input: Parameters<IDeviceManagerProvider["getRoleDisplayDefaults"]>[0]): ReturnType<IDeviceManagerProvider["getRoleDisplayDefaults"]>;
 /**
- * Replace the per-role display defaults whole-record (full replace). Override
- * units are normalized (`normalizeUnit`) at write so the render path always
- * looks up canonical spellings. Not per-device, so no event is emitted; the UI
- * invalidates its own query on mutate.
- *
- * This key is not itself read-modify-written, but `writeAddonStore` IS — the
- * door loads this addon's whole key range, merges the patch and re-inserts the
- * range (`settings-door-view.ts`). An unordered write of ANY key on that range
- * can therefore carry a stale copy of every other key, so it takes the same
- * lock as `deviceBindings` and `locations`. The old comment here claimed "no
- * lock, no RMW", which described the top-level key and not the write.
- */
-export declare function setRoleDisplayDefaults(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setRoleDisplayDefaults']>[0]): ReturnType<IDeviceManagerProvider['setRoleDisplayDefaults']>;
+* Replace the per-role display defaults whole-record (full replace). Override
+* units are normalized (`normalizeUnit`) at write so the render path always
+* looks up canonical spellings. Not per-device, so no event is emitted; the UI
+* invalidates its own query on mutate.
+*
+* This key is not itself read-modify-written, but `writeAddonStore` IS — the
+* door loads this addon's whole key range, merges the patch and re-inserts the
+* range (`settings-door-view.ts`). An unordered write of ANY key on that range
+* can therefore carry a stale copy of every other key, so it takes the same
+* lock as `deviceBindings` and `locations`. The old comment here claimed "no
+* lock, no RMW", which described the top-level key and not the write.
+*/
+export declare function setRoleDisplayDefaults(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setRoleDisplayDefaults"]>[0]): ReturnType<IDeviceManagerProvider["setRoleDisplayDefaults"]>;
 /**
- * Batched meta pre-seed. Applies every provided field to the
- * device's meta row in ONE read-modify-write under a single
- * `withMetaWriteLock` acquisition (one row write),
- * then emits one `DeviceMetaChanged` event per field that was
- * supplied — preserving the exact semantics of the individual
- * setters (`setName` / `setLocation` / `setType` /
- * `setIntegrationId` / `setLinkDeviceId` / `setRole`). Omitted
- * fields are left untouched; `null` clears `location` /
- * `linkDeviceId` / `role`. Idempotent.
- *
- * Collapses the per-child meta pre-seed (up to 6 individual
- * setter round-trips, each its own lock + write) into one — the
- * dominant cost when the kernel's `spawnAccessoryChild` reconciles
- * a many-entity container.
- */
-export declare function applyInitialMeta(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['applyInitialMeta']>[0]): ReturnType<IDeviceManagerProvider['applyInitialMeta']>;
+* Batched meta pre-seed. Applies every provided field to the
+* device's meta row in ONE read-modify-write under a single
+* `withMetaWriteLock` acquisition (one row write),
+* then emits one `DeviceMetaChanged` event per field that was
+* supplied — preserving the exact semantics of the individual
+* setters (`setName` / `setLocation` / `setType` /
+* `setIntegrationId` / `setLinkDeviceId` / `setRole`). Omitted
+* fields are left untouched; `null` clears `location` /
+* `linkDeviceId` / `role`. Idempotent.
+*
+* Collapses the per-child meta pre-seed (up to 6 individual
+* setter round-trips, each its own lock + write) into one — the
+* dominant cost when the kernel's `spawnAccessoryChild` reconciles
+* a many-entity container.
+*/
+export declare function applyInitialMeta(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["applyInitialMeta"]>[0]): ReturnType<IDeviceManagerProvider["applyInitialMeta"]>;
 /**
- * Patch the device's hardware-identity metadata blob. Shallow
- * merge — `null` removes a key, anything else overwrites.
- * Drivers populate factual fields on first probe; operators
- * augment via the Device Info tab. Idempotent: a no-op patch
- * (every key already present with the same value) doesn't emit
- * the meta-changed event.
- */
-export declare function setMetadata(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setMetadata']>[0]): ReturnType<IDeviceManagerProvider['setMetadata']>;
-export declare function setDisabled(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setDisabled']>[0]): ReturnType<IDeviceManagerProvider['setDisabled']>;
-export declare function loadRuntimeState(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['loadRuntimeState']>[0]): ReturnType<IDeviceManagerProvider['loadRuntimeState']>;
+* Patch the device's hardware-identity metadata blob. Shallow
+* merge — `null` removes a key, anything else overwrites.
+* Drivers populate factual fields on first probe; operators
+* augment via the Device Info tab. Idempotent: a no-op patch
+* (every key already present with the same value) doesn't emit
+* the meta-changed event.
+*/
+export declare function setMetadata(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setMetadata"]>[0]): ReturnType<IDeviceManagerProvider["setMetadata"]>;
+export declare function setDisabled(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setDisabled"]>[0]): ReturnType<IDeviceManagerProvider["setDisabled"]>;
+export declare function loadRuntimeState(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["loadRuntimeState"]>[0]): ReturnType<IDeviceManagerProvider["loadRuntimeState"]>;
 /**
- * Union of (1) operator-curated location registry and (2) labels
- * currently in use on persisted devices. Case-insensitive
- * dedupe (preserves the first-seen casing). Sorted
- * case-insensitively for stable UI. Drives the Device Info
- * location autocomplete.
- */
-export declare function listLocations(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listLocations']>;
+* Union of (1) operator-curated location registry and (2) labels
+* currently in use on persisted devices. Case-insensitive
+* dedupe (preserves the first-seen casing). Sorted
+* case-insensitively for stable UI. Drives the Device Info
+* location autocomplete.
+*/
+export declare function listLocations(pctx: ProviderContext): ReturnType<IDeviceManagerProvider["listLocations"]>;
 /**
- * Add a label to the curated location registry. Idempotent:
- * existing entries (case-insensitive match) are silently kept.
- * Empty / whitespace-only inputs throw — operators must supply a
- * meaningful label.
- */
-export declare function addLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['addLocation']>[0]): ReturnType<IDeviceManagerProvider['addLocation']>;
+* Add a label to the curated location registry. Idempotent:
+* existing entries (case-insensitive match) are silently kept.
+* Empty / whitespace-only inputs throw — operators must supply a
+* meaningful label.
+*/
+export declare function addLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["addLocation"]>[0]): ReturnType<IDeviceManagerProvider["addLocation"]>;
 /**
- * Every location that carries an icon, as `(locationKey, icon)` pairs.
- *
- * ADDITIVE beside `listLocations`, which still answers `string[]` — the
- * autocomplete, the HA adoption import and the recorder all read a list of
- * LABELS and a shape change there would break every one of them. A surface
- * that wants icons asks for them and joins on `locationIconKey`.
- *
- * Returns only what was actually stored. A location with no assignment is
- * ABSENT, never `map-pin`: the fallback belongs to the renderer
- * (`resolveLocationIcon`), and folding it in here would make "the operator
- * picked the pin" indistinguishable from "the operator picked nothing" —
- * which is the difference an icon picker has to draw.
- */
-export declare function listLocationIcons(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listLocationIcons']>;
+* Every location that carries an icon, as `(locationKey, icon)` pairs.
+*
+* ADDITIVE beside `listLocations`, which still answers `string[]` — the
+* autocomplete, the HA adoption import and the recorder all read a list of
+* LABELS and a shape change there would break every one of them. A surface
+* that wants icons asks for them and joins on `locationIconKey`.
+*
+* Returns only what was actually stored. A location with no assignment is
+* ABSENT, never `map-pin`: the fallback belongs to the renderer
+* (`resolveLocationIcon`), and folding it in here would make "the operator
+* picked the pin" indistinguishable from "the operator picked nothing" —
+* which is the difference an icon picker has to draw.
+*/
+export declare function listLocationIcons(pctx: ProviderContext): ReturnType<IDeviceManagerProvider["listLocationIcons"]>;
 /**
- * Set (or clear) the icon of a location label.
- *
- * Keyed on `locationIconKey` — trimmed + lower-cased, the equality the
- * registry matches on everywhere — so a case-only rename keeps the icon and
- * two spellings of one room can never carry two different icons.
- *
- * The label need NOT be registered: `setLocation` accepts a free-form string
- * and `listLocations` folds in whatever devices carry, so requiring
- * registration here would leave exactly the ad-hoc rooms unable to have an
- * icon. An empty label throws — there is no room to name.
- *
- * Same read-modify-write and same lock as `addLocation`: the map is one key of
- * the addon store, and `writeAddonStore` re-inserts the whole key range, so an
- * unordered write carries a stale copy of every other key.
- */
-export declare function setLocationIcon(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationIcon']>[0]): ReturnType<IDeviceManagerProvider['setLocationIcon']>;
+* Set (or clear) the icon of a location label.
+*
+* Keyed on `locationIconKey` — trimmed + lower-cased, the equality the
+* registry matches on everywhere — so a case-only rename keeps the icon and
+* two spellings of one room can never carry two different icons.
+*
+* The label need NOT be registered: `setLocation` accepts a free-form string
+* and `listLocations` folds in whatever devices carry, so requiring
+* registration here would leave exactly the ad-hoc rooms unable to have an
+* icon. An empty label throws — there is no room to name.
+*
+* Same read-modify-write and same lock as `addLocation`: the map is one key of
+* the addon store, and `writeAddonStore` re-inserts the whole key range, so an
+* unordered write carries a stale copy of every other key.
+*/
+export declare function setLocationIcon(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setLocationIcon"]>[0]): ReturnType<IDeviceManagerProvider["setLocationIcon"]>;
 /**
- * Every location that carries a description, sorted by key.
- *
- * Only what was WRITTEN — a location with no description is absent, and the
- * digest then tells the model the location name alone, exactly as it did
- * before descriptions existed.
- */
-export declare function listLocationDescriptions(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listLocationDescriptions']>;
+* Every location that carries a description, sorted by key.
+*
+* Only what was WRITTEN — a location with no description is absent, and the
+* digest then tells the model the location name alone, exactly as it did
+* before descriptions existed.
+*/
+export declare function listLocationDescriptions(pctx: ProviderContext): ReturnType<IDeviceManagerProvider["listLocationDescriptions"]>;
 /**
- * Set (or clear) a location's description.
- *
- * A BLANK description clears, exactly as `null` does: an empty line handed to
- * a vision model costs attention and says nothing, so the two must not be
- * different states. The label is folded with `locationIconKey` — the same key
- * the icon uses, which is the whole point of this living here.
- *
- * Same read-modify-write and same lock as `setLocationIcon`; `writeAddonStore`
- * re-inserts the whole key range, so an unordered write carries a stale copy
- * of every other key.
- */
-export declare function setLocationDescription(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationDescription']>[0]): ReturnType<IDeviceManagerProvider['setLocationDescription']>;
+* Set (or clear) a location's description.
+*
+* A BLANK description clears, exactly as `null` does: an empty line handed to
+* a vision model costs attention and says nothing, so the two must not be
+* different states. The label is folded with `locationIconKey` — the same key
+* the icon uses, which is the whole point of this living here.
+*
+* Same read-modify-write and same lock as `setLocationIcon`; `writeAddonStore`
+* re-inserts the whole key range, so an unordered write carries a stale copy
+* of every other key.
+*/
+export declare function setLocationDescription(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setLocationDescription"]>[0]): ReturnType<IDeviceManagerProvider["setLocationDescription"]>;
 /**
- * Every site zone, with its rooms, sorted by key.
- *
- * Membership is inverted HERE rather than stored both ways: the store keeps
- * `location → zone`, which is what makes "one zone per room" structural, and a
- * second copy keyed the other way is a second thing that can disagree with the
- * first.
- */
-export declare function listSiteZones(pctx: ProviderContext): ReturnType<IDeviceManagerProvider['listSiteZones']>;
+* Every site zone, with its rooms, sorted by key.
+*
+* Membership is inverted HERE rather than stored both ways: the store keeps
+* `location → zone`, which is what makes "one zone per room" structural, and a
+* second copy keyed the other way is a second thing that can disagree with the
+* first.
+*/
+export declare function listSiteZones(pctx: ProviderContext): ReturnType<IDeviceManagerProvider["listSiteZones"]>;
 /**
- * Create a zone, or set the icon of one that already exists.
- *
- * `icon: null` clears the icon and KEEPS the zone. Conflating the two would
- * make a mis-click on "no icon" delete every room's membership — the icon is a
- * decoration and the grouping is the data.
- *
- * `icon` OMITTED leaves whatever icon is there: creating a zone from a screen
- * with no picker must not silently clear the glyph a previous screen set.
- */
-export declare function setSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setSiteZone']>[0]): ReturnType<IDeviceManagerProvider['setSiteZone']>;
+* Create a zone, or set the icon of one that already exists.
+*
+* `icon: null` clears the icon and KEEPS the zone. Conflating the two would
+* make a mis-click on "no icon" delete every room's membership — the icon is a
+* decoration and the grouping is the data.
+*
+* `icon` OMITTED leaves whatever icon is there: creating a zone from a screen
+* with no picker must not silently clear the glyph a previous screen set.
+*/
+export declare function setSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setSiteZone"]>[0]): ReturnType<IDeviceManagerProvider["setSiteZone"]>;
 /**
- * Delete a zone. Its LOCATIONS survive, unattached.
- *
- * Deleting a grouping must never delete what was grouped — the rooms exist
- * independently and the devices in them were never touched to begin with.
- */
-export declare function removeSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['removeSiteZone']>[0]): ReturnType<IDeviceManagerProvider['removeSiteZone']>;
+* Delete a zone. Its LOCATIONS survive, unattached.
+*
+* Deleting a grouping must never delete what was grouped — the rooms exist
+* independently and the devices in them were never touched to begin with.
+*/
+export declare function removeSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["removeSiteZone"]>[0]): ReturnType<IDeviceManagerProvider["removeSiteZone"]>;
 /**
- * Rename a zone, carrying its icon AND every room in it.
- *
- * It exists so that renaming is not delete-then-recreate, which drops both.
- * A rename onto an existing zone MERGES: the target keeps its own icon and the
- * rooms are unioned, the same rule `renameLocation` follows.
- */
-export declare function renameSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['renameSiteZone']>[0]): ReturnType<IDeviceManagerProvider['renameSiteZone']>;
+* Rename a zone, carrying its icon AND every room in it.
+*
+* It exists so that renaming is not delete-then-recreate, which drops both.
+* A rename onto an existing zone MERGES: the target keeps its own icon and the
+* rooms are unioned, the same rule `renameLocation` follows.
+*/
+export declare function renameSiteZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["renameSiteZone"]>[0]): ReturnType<IDeviceManagerProvider["renameSiteZone"]>;
 /**
- * Put a location in a zone, or take it out with `zone: null`.
- *
- * ONE slot per location, so a second call moves the room rather than listing it
- * twice. The zone is created if it does not exist — a screen that assigns
- * before creating is a normal order, and refusing it would be the only place in
- * this registry that demands registration first.
- */
-export declare function setLocationZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['setLocationZone']>[0]): ReturnType<IDeviceManagerProvider['setLocationZone']>;
+* Put a location in a zone, or take it out with `zone: null`.
+*
+* ONE slot per location, so a second call moves the room rather than listing it
+* twice. The zone is created if it does not exist — a screen that assigns
+* before creating is a normal order, and refusing it would be the only place in
+* this registry that demands registration first.
+*/
+export declare function setLocationZone(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["setLocationZone"]>[0]): ReturnType<IDeviceManagerProvider["setLocationZone"]>;
 /**
- * Remove a label from the curated registry. Match is
- * case-insensitive. Devices that still reference this label keep
- * their `meta.location` value (the registry is a suggestion
- * list, not a foreign key) — pass `cascade: true` to also clear
- * `setLocation` on every device that referenced this exact
- * label. Cascade only matches case-insensitively + trimmed, same
- * as the registry equality check.
- */
+* Remove a label from the curated registry. Match is
+* case-insensitive. Devices that still reference this label keep
+* their `meta.location` value (the registry is a suggestion
+* list, not a foreign key) — pass `cascade: true` to also clear
+* `setLocation` on every device that referenced this exact
+* label. Cascade only matches case-insensitively + trimmed, same
+* as the registry equality check.
+*/
 /**
- * Rename a room in ONE server operation: the registry label in place, then
- * every device that carried it.
- *
- * The lock order is the one `removeLocation` documents and must not be
- * "simplified": the registry edit takes the addon-store lock and RELEASES it
- * before the cascade takes the meta lock. Holding both, in that order, is the
- * reverse of `allocateNextDeviceId`'s meta ⊃ addon-store nesting — the pair
- * that deadlocks.
- *
- * Validation happens BEFORE either lock. A rename that throws halfway is the
- * exact failure this function exists to remove, so an empty target must be
- * refused while nothing has been written yet.
- */
-export declare function renameLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['renameLocation']>[0]): ReturnType<IDeviceManagerProvider['renameLocation']>;
-export declare function removeLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider['removeLocation']>[0]): ReturnType<IDeviceManagerProvider['removeLocation']>;
+* Rename a room in ONE server operation: the registry label in place, then
+* every device that carried it.
+*
+* The lock order is the one `removeLocation` documents and must not be
+* "simplified": the registry edit takes the addon-store lock and RELEASES it
+* before the cascade takes the meta lock. Holding both, in that order, is the
+* reverse of `allocateNextDeviceId`'s meta ⊃ addon-store nesting — the pair
+* that deadlocks.
+*
+* Validation happens BEFORE either lock. A rename that throws halfway is the
+* exact failure this function exists to remove, so an empty target must be
+* refused while nothing has been written yet.
+*/
+export declare function renameLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["renameLocation"]>[0]): ReturnType<IDeviceManagerProvider["renameLocation"]>;
+export declare function removeLocation(pctx: ProviderContext, input: Parameters<IDeviceManagerProvider["removeLocation"]>[0]): ReturnType<IDeviceManagerProvider["removeLocation"]>;
 export {};