@camstack/types 1.2.266 → 1.2.268

package/dist/interfaces/kernel-abstractions.d.ts

@@ -10,6 +10,7 @@ import type { FrameInput } from '../types/io.js';
 import type { CropInput } from '../types/detection.js';
 import type { InferenceOutput } from './pipeline-runner.js';
 import type { CapabilityProviderMap } from './capability.js';
+import type { StatusOverlay, StatusOverlayAnswer } from './status-overlay.js';
 /**
  * Capability registry interface exposing what core/addon consumers need.
  * The full CapabilityRegistry in @camstack/system implements this and more.
@@ -37,6 +38,21 @@ export interface ICapabilityRegistry {
      * `getNativeProvider` and `getProviderByAddon`.
      */
     getProviderForDevice<T = unknown>(capName: string, deviceId: number): T | null;
+    /**
+     * Install (or remove, with `null`) the claimed-status overlay (D663, S3).
+     * While installed, `getNativeProvider` / `getProviderForDevice` answer
+     * `getStatus` of a CLAIMED `(cap, device)` from it; every other method is
+     * the provider's own. The device-manager installs it over its mirror.
+     */
+    setStatusOverlay(overlay: StatusOverlay | null): void;
+    /**
+     * The one question every resolution of a device-scoped `getStatus` awaits
+     * before answering: resolves the device's claims first (index, then its row,
+     * single-flight) and answers `claimed` / `unclaimed`; `unknown` only when the
+     * row cannot be read — and then the answer is "not reported", never the
+     * native (D315, D49).
+     */
+    resolveClaimedStatus(capName: string, deviceId: number): Promise<StatusOverlayAnswer>;
     /** Get the addonId that registered a native provider for (cap, device). */
     getNativeAddonId(capName: string, deviceId: number): string | null;
     /** List all capability names with a native registration for a device. */

package/dist/interfaces/status-overlay.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The claimed-status overlay (D663, ruling S3) — the ONE question every
+ * resolution of a device-scoped `getStatus` asks before it is answered: is this
+ * `(cap, device)` claimed on the hub, and if so, what does the merged slice say?
+ *
+ * Declared here, in `@camstack/types`, because `ICapabilityRegistry` carries
+ * the setter and the question; the kernel's `status-overlay.ts` re-exports the
+ * types so the registry and the transport both import from it and neither
+ * imports the other.
+ */
+/**
+ * - `claimed`: `slice` is ALREADY parsed with the cap's `status.schema`; `null`
+ *   means the claim is HELD (a claimed field with no value yet) or the merged
+ *   slice did not parse — "not reported" (D315), never the native value.
+ * - `unclaimed`: the device is KNOWN to carry no claim on this cap — the only
+ *   answer that lets the native provider's own `getStatus` speak.
+ * - `unknown`: the device's claims are not known — its row has not been read
+ *   and the claims index cannot vouch for it, or the row could not be read. A
+ *   consumer answers `null` ("not reported"), never the native: not-yet-known
+ *   must not look like not-claimed (D315, D49).
+ */
+export type StatusOverlayAnswer = {
+    readonly kind: 'claimed';
+    readonly slice: Readonly<Record<string, unknown>> | null;
+} | {
+    readonly kind: 'unclaimed';
+} | {
+    readonly kind: 'unknown';
+};
+/**
+ * Installed by the device-manager over its `DeviceStateMirror`.
+ *
+ * `peek` is synchronous and costs one in-memory lookup: it answers from what is
+ * already known and says `unknown` otherwise. `resolve` makes the claims known
+ * first — the claims index, and when that cannot vouch for the device, its
+ * runtime-state row read once (single-flight) — and answers `unknown` only when
+ * the row cannot be read.
+ */
+export interface StatusOverlay {
+    peek(capName: string, deviceId: number): StatusOverlayAnswer;
+    resolve(capName: string, deviceId: number): Promise<StatusOverlayAnswer>;
+}

package/dist/node.d.ts

@@ -17,6 +17,7 @@ export { writeFileAtomic } from './storage/atomic-write.js';
 export type { PhysicalRoot, RealpathSync } from './storage/physical-root.js';
 export { containsOrEquals, physicalRootOf } from './storage/physical-root.js';
 export { canonicalHash } from './utils/canonical-hash.js';
+export { customizationBlockName } from './composition/customization-name.js';
 export type { VerifyExpiringUrlInput } from './utils/expiring-url-signature.js';
 export { signExpiringUrl, verifyExpiringUrl } from './utils/expiring-url-signature.js';
 export type { DeviceExportShape, ExportDelta, ExportTargetEntry, } from './utils/export-reconciler.js';

package/dist/node.js

@@ -21,8 +21,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_canonical_hash = require("./canonical-hash-CSE4ioRi.js");
-const require_err_msg = require("./err-msg-COpsHMw2.js");
+const require_composition = require("./composition-QlOB7QTG.js");
+const require_err_msg = require("./err-msg-Dx2Kor0g.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = __toESM(node_fs);
@@ -794,7 +794,7 @@ var Fmp4FragmentChild = class {
 	deps;
 	args;
 	child = null;
-	splitter = new require_canonical_hash.Fmp4BoxSplitter();
+	splitter = new require_composition.Fmp4BoxSplitter();
 	stopped = false;
 	unitsOut = 0;
 	activeHwAccel = null;
@@ -811,7 +811,7 @@ var Fmp4FragmentChild = class {
 			return;
 		} catch (err) {
 			if (this.stopped) throw err;
-			if (requested === null || require_canonical_hash.isSoftwareDecode(requested)) throw err;
+			if (requested === null || require_composition.isSoftwareDecode(requested)) throw err;
 			this.deps.logger.warn("fmp4 fragment child: hardware decode produced NO fragment — retrying in SOFTWARE", {
 				tags: { deviceId: this.args.deviceId },
 				meta: {
@@ -821,7 +821,7 @@ var Fmp4FragmentChild = class {
 				}
 			});
 			this.killChild();
-			this.splitter = new require_canonical_hash.Fmp4BoxSplitter();
+			this.splitter = new require_composition.Fmp4BoxSplitter();
 			this.activeHwAccel = null;
 			await this.spawnAttempt(null);
 		}
@@ -839,7 +839,7 @@ var Fmp4FragmentChild = class {
 		this.args.plane.end("the fragment child stopped");
 	}
 	spawnAttempt(decodeHwAccel) {
-		const args = require_canonical_hash.buildFfmpegArgs({
+		const args = require_composition.buildFfmpegArgs({
 			...this.args.invocation,
 			decodeHwAccel,
 			sink: {
@@ -2010,6 +2010,26 @@ function containsOrEquals(outer, inner) {
 	return relative !== "" && !relative.startsWith("..") && !node_path.default.isAbsolute(relative);
 }
 //#endregion
+//#region src/composition/customization-name.ts
+/**
+* The stored name of the implicit block that customizes an existing device
+* (D663). The ONLY composition file that imports `node:crypto`, which is why it
+* is exported from `@camstack/types/node` and never from the browser barrel.
+*/
+/** `CompositionBlockInputSchema.name` is `max(120)` (`core-blocks.cap.ts`). */
+var MAX_BLOCK_NAME_LENGTH = 120;
+var HASH_HEX_LENGTH = 32;
+/**
+* Derived by the SERVER on save, never sent by the client; never shown as the
+* device's name. Unique per target: the plain ref when it fits, else a hash.
+*/
+function customizationBlockName(ref) {
+	const key = require_composition.compositionSourceKey(ref);
+	const plain = `${require_composition.CUSTOMIZATION_BLOCK_NAME_PREFIX}${key}`;
+	if (plain.length <= MAX_BLOCK_NAME_LENGTH) return plain;
+	return `${require_composition.CUSTOMIZATION_BLOCK_NAME_PREFIX}#${(0, node_crypto.createHash)("sha256").update(key).digest("hex").slice(0, HASH_HEX_LENGTH)}`;
+}
+//#endregion
 //#region src/utils/expiring-url-signature.ts
 /**
 * The ONE derivation of "a signed, expiring URL".
@@ -2073,7 +2093,7 @@ function verifyExpiringUrl(input) {
 */
 function canonicalDeviceFingerprint(shape) {
 	const features = [...new Set(shape.features)].toSorted();
-	return require_canonical_hash.canonicalHash({
+	return require_composition.canonicalHash({
 		deviceType: shape.deviceType,
 		features
 	});
@@ -2131,8 +2151,9 @@ exports.NO_COST_CLAIM = NO_COST_CLAIM;
 exports.PYTHON_VERSION = PYTHON_VERSION;
 exports.buildBinaryPath = buildBinaryPath;
 exports.canonicalDeviceFingerprint = canonicalDeviceFingerprint;
-exports.canonicalHash = require_canonical_hash.canonicalHash;
+exports.canonicalHash = require_composition.canonicalHash;
 exports.containsOrEquals = containsOrEquals;
+exports.customizationBlockName = customizationBlockName;
 exports.diffExportTargets = diffExportTargets;
 exports.downloadBinary = downloadBinary;
 exports.ensureBinary = ensureBinary;

package/dist/node.mjs

@@ -1,5 +1,5 @@
-import { n as Fmp4BoxSplitter, o as buildFfmpegArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-CPK2Dy60.mjs";
-import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
+import { N as compositionSourceKey, a as CUSTOMIZATION_BLOCK_NAME_PREFIX, at as canonicalHash, mt as isSoftwareDecode, ot as Fmp4BoxSplitter, ut as buildFfmpegArgs } from "./composition-CPFIlFfw.mjs";
+import { t as errMsg } from "./err-msg-DX6i_MY4.mjs";
 import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import * as fs from "node:fs";
 import { chmodSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
@@ -1987,6 +1987,26 @@ function containsOrEquals(outer, inner) {
 	return relative !== "" && !relative.startsWith("..") && !path.isAbsolute(relative);
 }
 //#endregion
+//#region src/composition/customization-name.ts
+/**
+* The stored name of the implicit block that customizes an existing device
+* (D663). The ONLY composition file that imports `node:crypto`, which is why it
+* is exported from `@camstack/types/node` and never from the browser barrel.
+*/
+/** `CompositionBlockInputSchema.name` is `max(120)` (`core-blocks.cap.ts`). */
+var MAX_BLOCK_NAME_LENGTH = 120;
+var HASH_HEX_LENGTH = 32;
+/**
+* Derived by the SERVER on save, never sent by the client; never shown as the
+* device's name. Unique per target: the plain ref when it fits, else a hash.
+*/
+function customizationBlockName(ref) {
+	const key = compositionSourceKey(ref);
+	const plain = `${CUSTOMIZATION_BLOCK_NAME_PREFIX}${key}`;
+	if (plain.length <= MAX_BLOCK_NAME_LENGTH) return plain;
+	return `${CUSTOMIZATION_BLOCK_NAME_PREFIX}#${createHash("sha256").update(key).digest("hex").slice(0, HASH_HEX_LENGTH)}`;
+}
+//#endregion
 //#region src/utils/expiring-url-signature.ts
 /**
 * The ONE derivation of "a signed, expiring URL".
@@ -2098,4 +2118,4 @@ function resolveExportFingerprint(input) {
 	return input.persisted ?? input.fresh;
 }
 //#endregion
-export { ChildCostRegistry, FFMPEG_RELEASE, FfmpegProcess, FilesystemStorageProvider, Fmp4FragmentChild, Fmp4FragmentPlane, NO_COST_CLAIM, PYTHON_VERSION, buildBinaryPath, canonicalDeviceFingerprint, canonicalHash, containsOrEquals, diffExportTargets, downloadBinary, ensureBinary, ensureFfmpeg, ensurePython, findInPath, getFfmpegArtifact, getFfmpegDownloadUrl, getPlatformInfo, getPythonDownloadUrl, installPythonPackages, installPythonRequirements, nodeProcStatReader, parseFfmpegCapabilities, parseProcCpuSeconds, parseProcRssBytes, physicalRootOf, probeFfmpegBinary, readProcessCost, resolveExportFingerprint, signExpiringUrl, verifyExpiringUrl, writeFileAtomic };
+export { ChildCostRegistry, FFMPEG_RELEASE, FfmpegProcess, FilesystemStorageProvider, Fmp4FragmentChild, Fmp4FragmentPlane, NO_COST_CLAIM, PYTHON_VERSION, buildBinaryPath, canonicalDeviceFingerprint, canonicalHash, containsOrEquals, customizationBlockName, diffExportTargets, downloadBinary, ensureBinary, ensureFfmpeg, ensurePython, findInPath, getFfmpegArtifact, getFfmpegDownloadUrl, getPlatformInfo, getPythonDownloadUrl, installPythonPackages, installPythonRequirements, nodeProcStatReader, parseFfmpegCapabilities, parseProcCpuSeconds, parseProcRssBytes, physicalRootOf, probeFfmpegBinary, readProcessCost, resolveExportFingerprint, signExpiringUrl, verifyExpiringUrl, writeFileAtomic };

package/dist/{sleep-8K9gue-H.js → sleep-BSzia-xT.js}

@@ -1,4 +1,4 @@
-const require_event_category = require("./event-category-BVfsrBYA.js");
+const require_event_category = require("./event-category-MbnB-6AN.js");
 let zod = require("zod");
 //#region src/audio/audio-chunk-format.ts
 /**
@@ -2589,332 +2589,6 @@ var adminUiCapability = {
 	}
 };
 //#endregion
-//#region src/device/device-type.ts
-var DeviceType = /* @__PURE__ */ function(DeviceType) {
-	DeviceType["Camera"] = "camera";
-	DeviceType["Hub"] = "hub";
-	DeviceType["Light"] = "light";
-	DeviceType["Siren"] = "siren";
-	DeviceType["Switch"] = "switch";
-	DeviceType["Sensor"] = "sensor";
-	DeviceType["Thermostat"] = "thermostat";
-	/** Air-conditioner / heat-pump climate device (HVAC) — shares the
-	*  `climate-control` cap surface with `Thermostat` but renders a
-	*  dedicated AC-appropriate control UI (mode chips, fan speed,
-	*  independent vertical/horizontal swing). Sources: native Gree, and
-	*  reusable by other AC integrations. */
-	DeviceType["Climate"] = "climate";
-	DeviceType["Button"] = "button";
-	/** Generic stateless event emitter — carries a device's EXACT declared
-	*  event vocabulary verbatim (no normalization). Installed with the
-	*  `event-emitter` cap. Sources: HA `event.*` entities (structured) and
-	*  HA bus events (e.g. `zha_event`, generic). */
-	DeviceType["EventEmitter"] = "event-emitter";
-	/** Firmware/software update entity — current vs available version,
-	*  updatable flag, update state, and an install action. Installed with
-	*  the `update` cap. Sources: Homematic firmware-update channels (and
-	*  reusable by other providers, e.g. HA `update.*` entities). */
-	DeviceType["Update"] = "update";
-	DeviceType["Generic"] = "generic";
-	/** Generic notification delivery target (HA `notify.<service>`, future
-	*  Telegram / Discord / ntfy / SMTP, …). One device per delivery
-	*  endpoint; the `notifier` cap defines the send surface. */
-	DeviceType["Notifier"] = "notifier";
-	/** Pre-recorded action sequence with optional parameters
-	*  (HA `script.*`). Runnable via `script-runner` cap. */
-	DeviceType["Script"] = "script";
-	/** Automation rule (HA `automation.*`) — enable/disable + manual
-	*  trigger surface exposed via `automation-control` cap. */
-	DeviceType["Automation"] = "automation";
-	/** Door / smart lock device (HA `lock.*`). `lock-control` cap. */
-	DeviceType["Lock"] = "lock";
-	/** Window covering, blinds, garage door, valve, etc. (HA `cover.*`,
-	*  `valve.*`). `cover` cap with sub-roles for variant. */
-	DeviceType["Cover"] = "cover";
-	/** Pipe / water / gas valve with open/close/stop and optional
-	*  position (HA `valve.*`). `valve` cap — a cover-sibling actuator
-	*  modelled on the same open/closed lifecycle. */
-	DeviceType["Valve"] = "valve";
-	/** Humidifier / dehumidifier with on/off + target humidity + mode
-	*  (HA `humidifier.*`). `humidifier` cap — a climate-family actuator
-	*  modelled on the same target / mode lifecycle. */
-	DeviceType["Humidifier"] = "humidifier";
-	/** Water heater / boiler with target temperature + operation mode +
-	*  away mode (HA `water_heater.*`). `water-heater` cap — a
-	*  climate-family actuator. */
-	DeviceType["WaterHeater"] = "water-heater";
-	/** Ceiling / standing / exhaust fan (HA `fan.*`). `fan-control` cap. */
-	DeviceType["Fan"] = "fan";
-	/** Audio / video playback endpoint (HA `media_player.*`). Disjoint from
-	*  the camera surface — those use `Camera`. `media-player` cap. */
-	DeviceType["MediaPlayer"] = "media-player";
-	/** Security panel / alarm system (HA `alarm_control_panel.*`).
-	*  `alarm-panel` cap. */
-	DeviceType["AlarmPanel"] = "alarm-panel";
-	/** Generic user-settable input (HA `number` / `input_number` / `select`
-	*  / `input_select` / `text` / `input_text` / `input_datetime`).
-	*  Sub-type via `DeviceRole`: NumericControl / SelectControl /
-	*  TextControl / DateTimeControl. */
-	DeviceType["Control"] = "control";
-	/** Person / device-tracker presence (HA `person.*`, `device_tracker.*`).
-	*  `presence` cap. */
-	DeviceType["Presence"] = "presence";
-	/** Weather provider (HA `weather.*`). Tier-3, low MVP priority.
-	*  `weather` cap. */
-	DeviceType["Weather"] = "weather";
-	/** Robot vacuum (HA `vacuum.*`). Tier-3. `vacuum-control` cap. */
-	DeviceType["Vacuum"] = "vacuum";
-	/** Robotic lawn mower (HA `lawn_mower.*`). Tier-3.
-	*  `lawn-mower-control` cap. */
-	DeviceType["LawnMower"] = "lawn-mower";
-	/** Physical HA device group — parent container for entity-children
-	*  adopted from a single HA device entry. Not renderable as a
-	*  standalone device; exists only to anchor child entities. */
-	DeviceType["Container"] = "container";
-	/** Single still-image entity (HA `image.*`). Read-only display of an
-	*  `entity_picture` signed URL the browser loads directly. `image` cap. */
-	DeviceType["Image"] = "image";
-	/** Smart pet feeder — cloud-connected food dispenser with a bowl food
-	*  level, battery, desiccant life, feeding state and manual-feed /
-	*  call-pet / maintenance actions. Installed with the `pet-feeder` cap;
-	*  dual-hopper models (D4S/D4SH) expose per-hopper portions. Sources:
-	*  native PetKit (`nodepetkit` `FeederDevice`), reusable by other feeder
-	*  integrations sharing the same food/desiccant/hopper surface. */
-	DeviceType["PetFeeder"] = "pet-feeder";
-	return DeviceType;
-}({});
-var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
-	DeviceFeature["BatteryOperated"] = "battery-operated";
-	DeviceFeature["Rebootable"] = "rebootable";
-	/**
-	* Device supports an on-demand re-sync of its derived spec with its
-	* upstream source — drives the generic Re-sync button. The owning
-	* provider implements the action via the `device-adoption.resync` cap.
-	*/
-	DeviceFeature["Resyncable"] = "resyncable";
-	DeviceFeature["NativeSnapshot"] = "native-snapshot";
-	DeviceFeature["DoorbellButton"] = "doorbell-button";
-	DeviceFeature["TwoWayAudio"] = "two-way-audio";
-	DeviceFeature["PanTiltZoom"] = "pan-tilt-zoom";
-	/**
-	* Camera supports the on-firmware autotrack subsystem (subject-
-	* following). Distinct from `PanTiltZoom` because not every PTZ
-	* camera ships autotrack — the admin UI uses this flag to gate
-	* the autotrack toggle / settings card without re-deriving from
-	* the cap registry. Mirrors `ptz-autotrack` cap registration:
-	* driver sets this feature when probe confirms the firmware
-	* surface, and registers the cap in the same code path.
-	*/
-	DeviceFeature["PtzAutotrack"] = "ptz-autotrack";
-	/**
-	* Accessory exposes a "trigger on motion" toggle — the parent camera's
-	* motion detection automatically activates this device. Mirrors
-	* `motion-trigger` cap registration: drivers set this feature in the
-	* same code path that calls `ctx.registerNativeCap(motionTriggerCapability, ...)`.
-	*
-	* Used by admin UI (gate the in-hero `MotionTriggerToggle` against a
-	* fast scalar without binding fetch), notifier rules, and `listAll`
-	* filters that want "all devices with on-motion behaviour".
-	*/
-	DeviceFeature["MotionTrigger"] = "motion-trigger";
-	/** Light supports rgb-triplet color via `color` cap. */
-	DeviceFeature["LightColorRgb"] = "light-color-rgb";
-	/** Light supports HSV color via `color` cap. */
-	DeviceFeature["LightColorHsv"] = "light-color-hsv";
-	/** Light supports color-temperature (mired) via `color` cap. */
-	DeviceFeature["LightColorMired"] = "light-color-mired";
-	/** Thermostat supports a `heat_cool` dual setpoint (targetLow +
-	*  targetHigh). Gates the range slider UI. */
-	DeviceFeature["ClimateDualSetpoint"] = "climate-dual-setpoint";
-	/** Thermostat exposes target humidity and/or current humidity
-	*  readings. Gates the humidity controls. */
-	DeviceFeature["ClimateHumidity"] = "climate-humidity";
-	/** Thermostat exposes a fan-mode selector. */
-	DeviceFeature["ClimateFanMode"] = "climate-fan-mode";
-	/** Thermostat exposes preset modes (eco / away / sleep / vendor). */
-	DeviceFeature["ClimatePreset"] = "climate-preset";
-	/** Thermostat exposes a vertical louver swing toggle. Gates the
-	*  vertical-swing switch in the climate UI. Independent of horizontal. */
-	DeviceFeature["ClimateSwingVertical"] = "climate-swing-vertical";
-	/** Thermostat exposes a horizontal louver swing toggle. Gates the
-	*  horizontal-swing switch in the climate UI. Independent of vertical. */
-	DeviceFeature["ClimateSwingHorizontal"] = "climate-swing-horizontal";
-	/** Cover exposes intermediate position control (0..100). Gates the
-	*  position slider UI. */
-	DeviceFeature["CoverPositionable"] = "cover-positionable";
-	/** Cover exposes slat-tilt control. Gates the tilt slider UI. */
-	DeviceFeature["CoverTilt"] = "cover-tilt";
-	/** Valve exposes intermediate position control (0..100). Gates the
-	*  position slider / drag surface UI. */
-	DeviceFeature["ValvePositionable"] = "valve-positionable";
-	/** Fan exposes a speed-percentage setter. Gates the speed slider UI. */
-	DeviceFeature["FanSpeed"] = "fan-speed";
-	/** Fan exposes a preset mode selector. */
-	DeviceFeature["FanPreset"] = "fan-preset";
-	/** Fan exposes blade direction (forward/reverse) — typical of
-	*  ceiling fans. */
-	DeviceFeature["FanDirection"] = "fan-direction";
-	/** Fan exposes an oscillation toggle. */
-	DeviceFeature["FanOscillating"] = "fan-oscillating";
-	/** Lock requires a PIN code on lock/unlock. Gates the code-entry
-	*  field on the UI lock-controls panel. */
-	DeviceFeature["LockPinRequired"] = "lock-pin-required";
-	/** Lock supports a latch-release ("open door") action distinct from
-	*  unlock. Mirrors HA `LockEntityFeature.OPEN` (bit 1) in
-	*  `supported_features`. Gates the Open Door button in the UI. */
-	DeviceFeature["LockOpen"] = "lock-open";
-	/** Media player exposes a seek-to-position surface. */
-	DeviceFeature["MediaPlayerSeek"] = "media-player-seek";
-	/** Media player exposes a volume-level setter. */
-	DeviceFeature["MediaPlayerVolume"] = "media-player-volume";
-	/** Media player exposes a mute toggle distinct from volume=0. */
-	DeviceFeature["MediaPlayerMute"] = "media-player-mute";
-	/** Media player exposes a shuffle toggle. */
-	DeviceFeature["MediaPlayerShuffle"] = "media-player-shuffle";
-	/** Media player exposes a repeat mode (off / all / one). */
-	DeviceFeature["MediaPlayerRepeat"] = "media-player-repeat";
-	/** Media player exposes a source / input selector. */
-	DeviceFeature["MediaPlayerSelectSource"] = "media-player-select-source";
-	/** Media player exposes a play-arbitrary-media surface (URL / id). */
-	DeviceFeature["MediaPlayerPlayMedia"] = "media-player-play-media";
-	/** Media player exposes next-track. */
-	DeviceFeature["MediaPlayerNext"] = "media-player-next";
-	/** Media player exposes previous-track. */
-	DeviceFeature["MediaPlayerPrevious"] = "media-player-previous";
-	/** Media player exposes stop distinct from pause. */
-	DeviceFeature["MediaPlayerStop"] = "media-player-stop";
-	/** Alarm panel requires a PIN code on arm/disarm. */
-	DeviceFeature["AlarmPinRequired"] = "alarm-pin-required";
-	/** Presence device carries GPS coordinates (lat/lng/accuracy) in
-	*  addition to a textual location. */
-	DeviceFeature["PresenceGps"] = "presence-gps";
-	/** Notifier accepts an inline / URL image attachment. */
-	DeviceFeature["NotifierImage"] = "notifier-image";
-	/** Notifier accepts a priority hint (high/normal/low). */
-	DeviceFeature["NotifierPriority"] = "notifier-priority";
-	/** Notifier accepts a free-form `data` payload for platform-specific
-	*  fields. */
-	DeviceFeature["NotifierData"] = "notifier-data";
-	/** Notifier supports interactive action buttons / callbacks. */
-	DeviceFeature["NotifierActions"] = "notifier-actions";
-	/** Notifier supports per-call recipient targeting (multi-user). */
-	DeviceFeature["NotifierRecipients"] = "notifier-recipients";
-	/** Script runner accepts a variables map on each run invocation. */
-	DeviceFeature["ScriptVariables"] = "script-variables";
-	/** Automation `trigger` accepts a skipCondition flag — fires the
-	*  automation's actions while bypassing its condition block. */
-	DeviceFeature["AutomationSkipCondition"] = "automation-skip-condition";
-	/** Robot vacuum exposes a live cleaning map (image child). Gates the
-	*  map tile in the vacuum UI. */
-	DeviceFeature["VacuumHasMap"] = "vacuum-has-map";
-	/** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
-	*  switches group. */
-	DeviceFeature["VacuumHasAi"] = "vacuum-has-ai";
-	/** Robot mower exposes a live mowing map (SVG image child). Gates the
-	*  mower map tile. */
-	DeviceFeature["MowerHasMap"] = "mower-has-map";
-	/** Robot mower exposes targeted mowing (all-area / zones / edges /
-	*  spots) — gates the Mow action + map selectors. */
-	DeviceFeature["MowerHasTargetedMowing"] = "mower-has-targeted-mowing";
-	return DeviceFeature;
-}({});
-var ChargingStatus = /* @__PURE__ */ function(ChargingStatus) {
-	ChargingStatus["ChargingDC"] = "charging-dc";
-	ChargingStatus["ChargingSolar"] = "charging-solar";
-	ChargingStatus["NotCharging"] = "not-charging";
-	return ChargingStatus;
-}({});
-/**
-* Semantic role a device plays within its parent. Populated by driver
-* addons when creating accessory devices (Reolink siren/floodlight/
-* PIR/chime/autotrack/doorbell, ONVIF relay outputs, …). Used by the
-* admin UI to pick icons, labels, and widgets — a `Switch` with
-* `role: Floodlight` renders as a bulb with a brightness slider,
-* whereas a `Switch` with `role: Siren` renders as a klaxon.
-*
-* Undefined for top-level devices (cameras, NVRs, hubs). Persisted in
-* sqlite as a nullable TEXT column — old rows keep working unchanged.
-*/
-var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
-	DeviceRole["Siren"] = "siren";
-	DeviceRole["Floodlight"] = "floodlight";
-	DeviceRole["Spotlight"] = "spotlight";
-	DeviceRole["PirSensor"] = "pir-sensor";
-	DeviceRole["Chime"] = "chime";
-	DeviceRole["Autotrack"] = "autotrack";
-	DeviceRole["Nightvision"] = "nightvision";
-	DeviceRole["PrivacyMask"] = "privacy-mask";
-	DeviceRole["Doorbell"] = "doorbell";
-	/** Virtual HA toggle (input_boolean.*) — distinguishable from a
-	*  real Switch device for UI rendering / export adapters. */
-	DeviceRole["BinaryHelper"] = "binary-helper";
-	/** Generic motion / occupancy / moving event source. Distinct from
-	*  the camera accessory PirSensor role: that one is a camera child;
-	*  this is a standalone HA / 3rd-party motion sensor. */
-	DeviceRole["MotionSensor"] = "motion-sensor";
-	DeviceRole["ContactSensor"] = "contact-sensor";
-	DeviceRole["LeakSensor"] = "leak-sensor";
-	DeviceRole["SmokeSensor"] = "smoke-sensor";
-	DeviceRole["COSensor"] = "co-sensor";
-	DeviceRole["GasSensor"] = "gas-sensor";
-	DeviceRole["TamperSensor"] = "tamper-sensor";
-	DeviceRole["VibrationSensor"] = "vibration-sensor";
-	DeviceRole["ConnectivitySensor"] = "connectivity-sensor";
-	DeviceRole["SoundSensor"] = "sound-sensor";
-	/** Fallback for `binary_sensor` without a known `device_class`. */
-	DeviceRole["BinarySensor"] = "binary-sensor";
-	DeviceRole["TemperatureSensor"] = "temperature-sensor";
-	DeviceRole["HumiditySensor"] = "humidity-sensor";
-	DeviceRole["AmbientLightSensor"] = "ambient-light-sensor";
-	DeviceRole["PressureSensor"] = "pressure-sensor";
-	/** Wind speed or direction (weather-station `wind-sensor` cap). */
-	DeviceRole["WindSensor"] = "wind-sensor";
-	/** Rain accumulation or rate (weather-station `rain-sensor` cap). */
-	DeviceRole["RainSensor"] = "rain-sensor";
-	/** UV index (weather-station `uv-sensor` cap). */
-	DeviceRole["UvSensor"] = "uv-sensor";
-	/** Solar irradiance W/m² (weather-station `solar-radiation-sensor` cap).
-	*  Distinct from AmbientLightSensor (lux). */
-	DeviceRole["SolarRadiationSensor"] = "solar-radiation-sensor";
-	/** Soil moisture % (garden/weather `soil-moisture-sensor` cap). */
-	DeviceRole["SoilMoistureSensor"] = "soil-moisture-sensor";
-	DeviceRole["PowerSensor"] = "power-sensor";
-	DeviceRole["EnergySensor"] = "energy-sensor";
-	DeviceRole["VoltageSensor"] = "voltage-sensor";
-	DeviceRole["CurrentSensor"] = "current-sensor";
-	DeviceRole["AirQualitySensor"] = "air-quality-sensor";
-	/** Battery level (numeric % via `sensor` OR low-bool via
-	*  `binary_sensor` — the cap distinguishes via the value type). */
-	DeviceRole["BatterySensor"] = "battery-sensor";
-	/** Fallback for `sensor` numeric without a known `device_class`. */
-	DeviceRole["NumericSensor"] = "numeric-sensor";
-	/** String / enum state (HA `sensor` with `state_class: enum` or
-	*  `attributes.options`). */
-	DeviceRole["EnumSensor"] = "enum-sensor";
-	/** Date / timestamp state (HA `sensor` with `device_class: timestamp`
-	*  or `date`). The slice carries the raw ISO string verbatim (hosted on
-	*  the `enum-sensor` cap); the UI renders it locale-formatted. */
-	DeviceRole["DateTimeSensor"] = "datetime-sensor";
-	/** Last-resort fallback when nothing else matches. */
-	DeviceRole["GenericSensor"] = "generic-sensor";
-	DeviceRole["NumericControl"] = "numeric-control";
-	DeviceRole["SelectControl"] = "select-control";
-	DeviceRole["TextControl"] = "text-control";
-	DeviceRole["DateTimeControl"] = "datetime-control";
-	/** Mobile push notifier (HA `notify.mobile_app_*`) — supports
-	*  rich features (image, priority, channel routing). */
-	DeviceRole["MobilePushNotifier"] = "mobile-push-notifier";
-	/** Chat / messaging service (HA `notify.telegram_*`,
-	*  `notify.discord_*`, etc.). */
-	DeviceRole["MessagingNotifier"] = "messaging-notifier";
-	/** Email-based delivery (HA `notify.smtp`, etc.). */
-	DeviceRole["EmailNotifier"] = "email-notifier";
-	/** Fallback when the notifier service name doesn't match a known
-	*  pattern. */
-	DeviceRole["GenericNotifier"] = "generic-notifier";
-	return DeviceRole;
-}({});
-//#endregion
 //#region src/capabilities/custom-actions.ts
 /**
 * Identity — preserves literal types for downstream inference.
@@ -4083,7 +3757,11 @@ function createDeviceProxy(api, binding, opts) {
 		deviceState: {
 			getSnapshot: (input) => dispatchSystem("deviceState", "getSnapshot", "query", input),
 			getCapSlice: (input) => dispatchSystem("deviceState", "getCapSlice", "query", input),
-			setCapSlice: (input) => dispatchSystem("deviceState", "setCapSlice", "mutation", input)
+			setCapSlice: (input) => dispatchSystem("deviceState", "setCapSlice", "mutation", input),
+			claimFields: (input) => dispatchSystem("deviceState", "claimFields", "mutation", input),
+			patchOwnedFields: (input) => dispatchSystem("deviceState", "patchOwnedFields", "mutation", input),
+			releaseClaim: (input) => dispatchSystem("deviceState", "releaseClaim", "mutation", input),
+			getNativeCapSlice: (input) => dispatchSystem("deviceState", "getNativeCapSlice", "query", input)
 		},
 		faceGallery: {
 			listRecentFaces: (input) => dispatchSystem("faceGallery", "listRecentFaces", "query", input),
@@ -4519,12 +4197,6 @@ Object.defineProperty(exports, "CameraStreamSchema", {
 		return CameraStreamSchema;
 	}
 });
-Object.defineProperty(exports, "ChargingStatus", {
-	enumerable: true,
-	get: function() {
-		return ChargingStatus;
-	}
-});
 Object.defineProperty(exports, "DATAPLANE_SECRET_HEADER", {
 	enumerable: true,
 	get: function() {
@@ -4573,24 +4245,6 @@ Object.defineProperty(exports, "DecodedFrameSchema", {
 		return DecodedFrameSchema;
 	}
 });
-Object.defineProperty(exports, "DeviceFeature", {
-	enumerable: true,
-	get: function() {
-		return DeviceFeature;
-	}
-});
-Object.defineProperty(exports, "DeviceRole", {
-	enumerable: true,
-	get: function() {
-		return DeviceRole;
-	}
-});
-Object.defineProperty(exports, "DeviceType", {
-	enumerable: true,
-	get: function() {
-		return DeviceType;
-	}
-});
 Object.defineProperty(exports, "DisposerChain", {
 	enumerable: true,
 	get: function() {