@camstack/types 0.1.40 → 0.1.42

package/dist/addon/base-addon.d.ts

@@ -1,5 +1,7 @@
 import type { AddonContext, AddonInitResult, CapabilitiesAccess, ProviderRegistration } from '../interfaces/addon.js';
 import type { ConfigUISchema, ConfigUISchemaWithValues, ConfigField, ConfigSection } from '../interfaces/config-ui.js';
+import { type DurableState } from './durable-state.js';
+import type { ZodType } from 'zod';
 export type { CapabilitiesAccess };
 /**
  * Utility type that constrains a ConfigField's `key` to only accept
@@ -247,6 +249,16 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
      * (e.g. from older versions) without polluting the typed config.
      */
     protected resolveConfig(): Promise<void>;
+    /**
+     * Typed durable handle over ONE key of this addon's store. The whole
+     * Zod-validated value round-trips on every read/write — no hand-listed
+     * fields, so a field can never be silently dropped on persist. Reads use
+     * the same retry budget as config resolution; a corrupt/legacy blob logs
+     * a warning and falls back rather than crashing boot.
+     */
+    protected state<T>(key: string, schema: ZodType<T>, fallback: T): DurableState<T>;
+    /** Per-device variant of {@link state}, backed by the per-device store. */
+    protected deviceState<T>(deviceId: number, key: string, schema: ZodType<T>, fallback: T): DurableState<T>;
     /**
      * Wrap `ctx.settings.readAddonStore()` with a short retry budget so a
      * transient settings-store outage (mid-restart of sqlite-settings, tsx-watch

package/dist/addon/base-addon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-addon.d.ts","sourceRoot":"","sources":["../../src/addon/base-addon.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-addon.d.ts","sourceRoot":"","sources":["../../src/addon/base-addon.ts"],"names":[],"mappings":"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"}

package/dist/addon/durable-state.d.ts

@@ -0,0 +1,33 @@
+import type { ZodType } from 'zod';
+/**
+ * A typed handle over ONE top-level key of an addon/device store. `set`
+ * always writes the whole Zod-validated value for that key, so a field
+ * can never be silently dropped by a hand-written serializer. Sibling
+ * keys are untouched (writes go through the store's patch-merge).
+ */
+export interface DurableState<T> {
+    /** Read + validate. Missing key or parse failure → `fallback`. Never throws. */
+    get(): Promise<T>;
+    /** Validate `next`, then write the WHOLE value under this key. Throws on invalid. */
+    set(next: T): Promise<void>;
+    /** get → fn(prev) → set, as one logical update. */
+    update(fn: (prev: T) => T): Promise<void>;
+}
+export interface DurableStateDeps<T> {
+    readonly key: string;
+    readonly schema: ZodType<T>;
+    readonly fallback: T;
+    readonly read: () => Promise<Record<string, unknown>>;
+    readonly write: (patch: Record<string, unknown>) => Promise<void>;
+    /** Called when a stored blob fails validation (before falling back). */
+    readonly onParseError?: (key: string, error: unknown) => void;
+}
+/**
+ * Build a {@link DurableState} over a single store key. Transport-agnostic:
+ * `read`/`write` are the addon-store or device-store accessors. The whole
+ * validated value round-trips on every read/write — the schema is the
+ * single source of truth for what is persisted, so no hand-listed field
+ * set can drop a key on save.
+ */
+export declare function createDurableState<T>(deps: DurableStateDeps<T>): DurableState<T>;
+//# sourceMappingURL=durable-state.d.ts.map

package/dist/addon/durable-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-state.d.ts","sourceRoot":"","sources":["../../src/addon/durable-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAElC;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,gFAAgF;IAChF,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAA;IACjB,qFAAqF;IACrF,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACrD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC9D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAuBhF"}

package/dist/capabilities/accessories.cap.d.ts

@@ -2,38 +2,86 @@ import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
 /**
- * List of accessory children linked to a parent device (camera, hub).
- * Returns only numeric device ids — the rest (role, deviceType, name,
- * caps) is derived by fetching each child via `device-manager.getDevice`.
+ * List of accessory children linked to a parent device. The cap surfaces
+ * the grouping and the per-child UI-visibility flag — the single source
+ * of truth for what an accessory IS remains the child device itself
+ * (resolved via `device-manager.getDevice` from the listed numeric ids).
  *
- * The single-source-of-truth for what an accessory IS remains the child
- * device itself; this cap only surfaces the grouping.
+ * Two parallel arrays:
+ *   - `childDeviceIds` — every accessory child the parent recognises
+ *   - `hiddenChildIds` — subset that the operator chose to hide from
+ *     the parent's UI surface (panels / detail page / grid). The hidden
+ *     children remain registered and continue to receive state updates;
+ *     they're omitted only from the parent's UI accessories view.
+ *
+ * Use cases:
+ *   - Camera parents hiding seldom-used accessories (e.g. a chime that
+ *     was provisioned but isn't connected to anything).
+ *   - HA-integration parents hiding entity-children the user doesn't
+ *     care about (an "Aqara plug" exposes one switch + 3 sensors —
+ *     the operator may want only the switch visible).
+ *
+ * Toggling visibility is the parent provider's responsibility — it
+ * implements `setChildHidden` and persists the set so reboots survive.
  */
 export declare const AccessoriesStatusSchema: z.ZodObject<{
     childDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+    hiddenChildIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strip>;
 export type AccessoriesStatus = z.infer<typeof AccessoriesStatusSchema>;
 export declare const accessoriesCapability: {
     readonly name: "accessories";
     readonly scope: "device";
+    readonly deviceNative: true;
     readonly mode: "singleton";
-    readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub];
-    readonly methods: {};
+    readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Hub, DeviceType.Switch, DeviceType.Light, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Cover, DeviceType.Lock, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Generic];
+    readonly methods: {
+        /**
+         * Toggle the UI-visibility of a single accessory child. Hidden
+         * children stay registered and continue to receive state updates;
+         * they're omitted only from the parent's UI accessories panel.
+         *
+         * Idempotent — hiding an already-hidden child or unhiding a
+         * non-hidden child is a no-op. Providers that don't support
+         * per-child visibility may implement this as a no-op (the UI hide
+         * toggle gracefully degrades).
+         */
+        readonly setChildHidden: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            childDeviceId: z.ZodNumber;
+            hidden: z.ZodBoolean;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+    };
     readonly events: {
         /**
          * Emitted when a child device is created, removed, or its parent
-         * assignment changes. Payload carries the fresh list.
+         * assignment changes. Payload carries the fresh list and the
+         * hidden subset.
          */
         readonly onAccessoriesChanged: {
             readonly data: z.ZodObject<{
                 deviceId: z.ZodNumber;
                 childDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+                hiddenChildIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+            }, z.core.$strip>;
+        };
+        /**
+         * Emitted when the operator toggles a child's UI-visibility.
+         * Subscribers (admin UI accessories panel) re-render off this
+         * signal without re-fetching the full status block.
+         */
+        readonly onChildVisibilityChanged: {
+            readonly data: z.ZodObject<{
+                deviceId: z.ZodNumber;
+                childDeviceId: z.ZodNumber;
+                hidden: z.ZodBoolean;
             }, z.core.$strip>;
         };
     };
     readonly status: {
         readonly schema: z.ZodObject<{
             childDeviceIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
+            hiddenChildIds: z.ZodReadonly<z.ZodArray<z.ZodNumber>>;
         }, z.core.$strip>;
         readonly kind: "command-driven";
     };

package/dist/capabilities/accessories.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessories.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/accessories.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;iBAElC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,qBAAqB;;;;;;;QAO9B;;;WAGG;;;;;;;;;;;;;;CAUkC,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,OAAO,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"accessories.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/accessories.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,uBAAuB;;;iBAMlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,qBAAqB;;;;;;;QAwB9B;;;;;;;;;WASG;;;;;;;;QAYH;;;;WAIG;;;;;;;;QAMH;;;;WAIG;;;;;;;;;;;;;;;;CAWkC,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/capabilities/advanced-notifier.cap.d.ts

@@ -17,6 +17,7 @@ declare const NotificationRuleConditionsSchema: z.ZodObject<{
     }, z.core.$strip>>;
     cooldownSeconds: z.ZodOptional<z.ZodNumber>;
     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
+    eventTypeTokens: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
 }, z.core.$strip>;
 declare const NotificationRuleTemplateSchema: z.ZodObject<{
     title: z.ZodString;
@@ -50,6 +51,7 @@ declare const NotificationRuleSchema: z.ZodObject<{
         }, z.core.$strip>>;
         cooldownSeconds: z.ZodOptional<z.ZodNumber>;
         minDwellSeconds: z.ZodOptional<z.ZodNumber>;
+        eventTypeTokens: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
     outputs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
     template: z.ZodOptional<z.ZodObject<{
@@ -123,6 +125,7 @@ export declare const advancedNotifierCapability: {
                     }, z.core.$strip>>;
                     cooldownSeconds: z.ZodOptional<z.ZodNumber>;
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
+                    eventTypeTokens: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 }, z.core.$strip>;
                 outputs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 template: z.ZodOptional<z.ZodObject<{
@@ -166,6 +169,7 @@ export declare const advancedNotifierCapability: {
                     }, z.core.$strip>>;
                     cooldownSeconds: z.ZodOptional<z.ZodNumber>;
                     minDwellSeconds: z.ZodOptional<z.ZodNumber>;
+                    eventTypeTokens: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
                 }, z.core.$strip>;
                 outputs: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 template: z.ZodOptional<z.ZodObject<{

package/dist/capabilities/advanced-notifier.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advanced-notifier.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/advanced-notifier.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAElG,QAAA,MAAM,gCAAgC;;;;;;;;;;;;;;;;;iBAapC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;iBAIlC,CAAA;AAEF,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS1B,CAAA;AAEF,QAAA,MAAM,4BAA4B;;;;;;iBAMhC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;;iBAUlC,CAAA;AAEF,QAAA,MAAM,+BAA+B;;;;;;iBAMnC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BE,CAAA;AAEzC,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAExF,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,GAChC,CAAA"}
+{"version":3,"file":"advanced-notifier.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/advanced-notifier.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAElG,QAAA,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;iBAiBpC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;iBAIlC,CAAA;AAEF,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS1B,CAAA;AAEF,QAAA,MAAM,4BAA4B;;;;;;iBAMhC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;;iBAUlC,CAAA;AAEF,QAAA,MAAM,+BAA+B;;;;;;iBAMnC,CAAA;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BE,CAAA;AAEzC,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAExF,OAAO,EACL,sBAAsB,EACtB,gCAAgC,EAChC,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,GAChC,CAAA"}

package/dist/capabilities/air-quality-sensor.cap.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * Multi-metric air-quality slice. Covers CO₂, total VOCs, particulate
+ * matter at PM2.5 / PM10, and a derived AQI index — all optional so
+ * a single-metric source populates only what it observes. Mirrors
+ * the HA `sensor` device_class set (`co2`, `volatile_organic_compounds`,
+ * `pm25`, `pm10`, `aqi`) collapsed into one cap because a typical
+ * air-quality node reports several of these together; modelling them
+ * as siblings keeps a single timestamp + one slice subscription.
+ */
+export declare const AirQualitySensorStatusSchema: z.ZodObject<{
+    co2Ppm: z.ZodOptional<z.ZodNumber>;
+    vocPpb: z.ZodOptional<z.ZodNumber>;
+    pm25: z.ZodOptional<z.ZodNumber>;
+    pm10: z.ZodOptional<z.ZodNumber>;
+    aqi: z.ZodOptional<z.ZodNumber>;
+    lastFetchedAt: z.ZodNumber;
+    unit: z.ZodOptional<z.ZodString>;
+    precision: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AirQualitySensorStatus = z.infer<typeof AirQualitySensorStatusSchema>;
+export declare const airQualitySensorCapability: {
+    readonly name: "air-quality-sensor";
+    readonly scope: "device";
+    readonly deviceNative: true;
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.Sensor];
+    readonly methods: {};
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            co2Ppm: z.ZodOptional<z.ZodNumber>;
+            vocPpb: z.ZodOptional<z.ZodNumber>;
+            pm25: z.ZodOptional<z.ZodNumber>;
+            pm10: z.ZodOptional<z.ZodNumber>;
+            aqi: z.ZodOptional<z.ZodNumber>;
+            lastFetchedAt: z.ZodNumber;
+            unit: z.ZodOptional<z.ZodString>;
+            precision: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly kind: "push";
+    };
+    readonly runtimeState: z.ZodObject<{
+        co2Ppm: z.ZodOptional<z.ZodNumber>;
+        vocPpb: z.ZodOptional<z.ZodNumber>;
+        pm25: z.ZodOptional<z.ZodNumber>;
+        pm10: z.ZodOptional<z.ZodNumber>;
+        aqi: z.ZodOptional<z.ZodNumber>;
+        lastFetchedAt: z.ZodNumber;
+        unit: z.ZodOptional<z.ZodString>;
+        precision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+};
+export type IAirQualitySensorProvider = InferProvider<typeof airQualitySensorCapability>;
+//# sourceMappingURL=air-quality-sensor.cap.d.ts.map

package/dist/capabilities/air-quality-sensor.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"air-quality-sensor.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/air-quality-sensor.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;iBAuBvC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEjF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYE,CAAA;AAEzC,MAAM,MAAM,yBAAyB,GAAG,aAAa,CAAC,OAAO,0BAA0B,CAAC,CAAA"}

package/dist/capabilities/alarm-panel.cap.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * Alarm-panel cap. Models HA `alarm_control_panel.*` on
+ * `DeviceType.AlarmPanel`. State follows HA's canonical lifecycle
+ * across disarmed / armed_(home|away|night|vacation|custom_bypass) /
+ * arming / pending / triggered / disarming.
+ *
+ * Many panels require a PIN code on arm / disarm — the optional
+ * `code` field on the methods passes it through to the upstream
+ * service; it's NEVER persisted in the runtime slice or any event
+ * payload. The presence of a required code is signalled by
+ * `DeviceFeature.AlarmPinRequired` so the UI gates a code-entry
+ * field without a slice fetch.
+ *
+ * `availableModes` mirrors HA's `supported_features`-derived arm
+ * mode list — the UI renders only the buttons the panel accepts.
+ */
+export declare const AlarmStateSchema: z.ZodEnum<{
+    pending: "pending";
+    disarmed: "disarmed";
+    armed_home: "armed_home";
+    armed_away: "armed_away";
+    armed_night: "armed_night";
+    armed_vacation: "armed_vacation";
+    armed_custom_bypass: "armed_custom_bypass";
+    arming: "arming";
+    disarming: "disarming";
+    triggered: "triggered";
+}>;
+export type AlarmState = z.infer<typeof AlarmStateSchema>;
+export declare const AlarmArmModeSchema: z.ZodEnum<{
+    home: "home";
+    away: "away";
+    night: "night";
+    vacation: "vacation";
+    custom_bypass: "custom_bypass";
+}>;
+export type AlarmArmMode = z.infer<typeof AlarmArmModeSchema>;
+export declare const AlarmPanelStatusSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        pending: "pending";
+        disarmed: "disarmed";
+        armed_home: "armed_home";
+        armed_away: "armed_away";
+        armed_night: "armed_night";
+        armed_vacation: "armed_vacation";
+        armed_custom_bypass: "armed_custom_bypass";
+        arming: "arming";
+        disarming: "disarming";
+        triggered: "triggered";
+    }>;
+    availableModes: z.ZodArray<z.ZodEnum<{
+        home: "home";
+        away: "away";
+        night: "night";
+        vacation: "vacation";
+        custom_bypass: "custom_bypass";
+    }>>;
+    requiresCode: z.ZodBoolean;
+    lastChangedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type AlarmPanelStatus = z.infer<typeof AlarmPanelStatusSchema>;
+export declare const alarmPanelCapability: {
+    readonly name: "alarm-panel";
+    readonly scope: "device";
+    readonly deviceNative: true;
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.AlarmPanel];
+    readonly methods: {
+        readonly arm: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            mode: z.ZodEnum<{
+                home: "home";
+                away: "away";
+                night: "night";
+                vacation: "vacation";
+                custom_bypass: "custom_bypass";
+            }>;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly disarm: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /**
+         * Force the panel into the `triggered` state — used by HA
+         * automations to surface external sensor events through the panel
+         * (e.g. a Reolink camera intrusion event firing the security
+         * system). Provider rejects when the panel hardware doesn't
+         * support a software-initiated trigger.
+         */
+        readonly trigger: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            state: z.ZodEnum<{
+                pending: "pending";
+                disarmed: "disarmed";
+                armed_home: "armed_home";
+                armed_away: "armed_away";
+                armed_night: "armed_night";
+                armed_vacation: "armed_vacation";
+                armed_custom_bypass: "armed_custom_bypass";
+                arming: "arming";
+                disarming: "disarming";
+                triggered: "triggered";
+            }>;
+            availableModes: z.ZodArray<z.ZodEnum<{
+                home: "home";
+                away: "away";
+                night: "night";
+                vacation: "vacation";
+                custom_bypass: "custom_bypass";
+            }>>;
+            requiresCode: z.ZodBoolean;
+            lastChangedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        readonly kind: "push";
+    };
+    /**
+     * Runtime-state slice — mirrored by the kernel. UI panel reads the
+     * full slice; renders an arm button per `availableModes` entry and
+     * a PIN field iff `requiresCode === true`.
+     */
+    readonly runtimeState: z.ZodObject<{
+        state: z.ZodEnum<{
+            pending: "pending";
+            disarmed: "disarmed";
+            armed_home: "armed_home";
+            armed_away: "armed_away";
+            armed_night: "armed_night";
+            armed_vacation: "armed_vacation";
+            armed_custom_bypass: "armed_custom_bypass";
+            arming: "arming";
+            disarming: "disarming";
+            triggered: "triggered";
+        }>;
+        availableModes: z.ZodArray<z.ZodEnum<{
+            home: "home";
+            away: "away";
+            night: "night";
+            vacation: "vacation";
+            custom_bypass: "custom_bypass";
+        }>>;
+        requiresCode: z.ZodBoolean;
+        lastChangedAt: z.ZodNumber;
+    }, z.core.$strip>;
+};
+export type IAlarmPanelProvider = InferProvider<typeof alarmPanelCapability>;
+//# sourceMappingURL=alarm-panel.cap.d.ts.map

package/dist/capabilities/alarm-panel.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarm-panel.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/alarm-panel.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;EAW3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,kBAAkB;;;;;;EAM7B,CAAA;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;iBAWjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;QA0B7B;;;;;;WAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAWL;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;CAEoC,CAAA;AAEzC,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/capabilities/ambient-light-sensor.cap.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * Ambient illuminance reading in lux. Drives Home Assistant `sensor`
+ * entries with `device_class: illuminance`.
+ */
+export declare const AmbientLightSensorStatusSchema: z.ZodObject<{
+    lux: z.ZodNumber;
+    lastFetchedAt: z.ZodNumber;
+    unit: z.ZodOptional<z.ZodString>;
+    precision: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type AmbientLightSensorStatus = z.infer<typeof AmbientLightSensorStatusSchema>;
+export declare const ambientLightSensorCapability: {
+    readonly name: "ambient-light-sensor";
+    readonly scope: "device";
+    readonly deviceNative: true;
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.Sensor];
+    readonly methods: {};
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            lux: z.ZodNumber;
+            lastFetchedAt: z.ZodNumber;
+            unit: z.ZodOptional<z.ZodString>;
+            precision: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly kind: "push";
+    };
+    readonly runtimeState: z.ZodObject<{
+        lux: z.ZodNumber;
+        lastFetchedAt: z.ZodNumber;
+        unit: z.ZodOptional<z.ZodString>;
+        precision: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+};
+export type IAmbientLightSensorProvider = InferProvider<typeof ambientLightSensorCapability>;
+//# sourceMappingURL=ambient-light-sensor.cap.d.ts.map

package/dist/capabilities/ambient-light-sensor.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-light-sensor.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/ambient-light-sensor.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;iBAczC,CAAA;AAEF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAErF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;CAYA,CAAA;AAEzC,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,OAAO,4BAA4B,CAAC,CAAA"}

package/dist/capabilities/automation-control.cap.d.ts

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/**
+ * Automation-control cap. Models HA `automation.*` entities on
+ * `DeviceType.Automation`. An automation is a trigger+condition+
+ * action rule that can be enabled / disabled and manually fired
+ * via the `trigger` method.
+ *
+ * `trigger` accepts an optional `skipCondition` flag — when true,
+ * the automation's action block runs WITHOUT evaluating its
+ * condition block. Pair with `DeviceFeature.AutomationSkipCondition`
+ * to gate the UI checkbox for the manual-trigger dialog.
+ */
+export declare const AutomationControlStatusSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    isRunning: z.ZodBoolean;
+    lastTriggeredAt: z.ZodNumber;
+    lastError: z.ZodNullable<z.ZodString>;
+    lastChangedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type AutomationControlStatus = z.infer<typeof AutomationControlStatusSchema>;
+export declare const automationControlCapability: {
+    readonly name: "automation-control";
+    readonly scope: "device";
+    readonly deviceNative: true;
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.Automation];
+    readonly methods: {
+        readonly enable: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly disable: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        readonly trigger: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            skipCondition: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            enabled: z.ZodBoolean;
+            isRunning: z.ZodBoolean;
+            lastTriggeredAt: z.ZodNumber;
+            lastError: z.ZodNullable<z.ZodString>;
+            lastChangedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        readonly kind: "push";
+    };
+    /**
+     * Runtime-state slice — mirrored by the kernel. UI automation tile
+     * reads `enabled` (toggle) + `isRunning` (spinner) + `lastError`
+     * (badge) directly.
+     */
+    readonly runtimeState: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        isRunning: z.ZodBoolean;
+        lastTriggeredAt: z.ZodNumber;
+        lastError: z.ZodNullable<z.ZodString>;
+        lastChangedAt: z.ZodNumber;
+    }, z.core.$strip>;
+};
+export type IAutomationControlProvider = InferProvider<typeof automationControlCapability>;
+//# sourceMappingURL=automation-control.cap.d.ts.map

package/dist/capabilities/automation-control.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation-control.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/automation-control.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,6BAA6B;;;;;;iBAaxC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiCtC;;;;OAIG;;;;;;;;CAEoC,CAAA;AAEzC,MAAM,MAAM,0BAA0B,GAAG,aAAa,CAAC,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/capabilities/battery.cap.d.ts

@@ -17,14 +17,40 @@ export declare const BatteryStatusSchema: z.ZodObject<{
     }>;
     sleeping: z.ZodBoolean;
     lastUpdated: z.ZodNumber;
+    binary: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type BatteryStatus = z.infer<typeof BatteryStatusSchema>;
 export declare const batteryCapability: {
     readonly name: "battery";
     readonly scope: "device";
+    readonly deviceNative: true;
     readonly mode: "singleton";
     readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch];
-    readonly methods: {};
+    readonly methods: {
+        /**
+         * Explicitly wake the camera from low-power sleep ahead of a
+         * streaming session start. Consumers that initiate a stream
+         * against a sleeping battery cam (HomeKit Secure Video, Alexa
+         * RTCSession, snapshot wrappers) call this with a short timeout
+         * before establishing the media pipeline — the broker's own
+         * passive wake-on-dial works but adds 5–7 seconds to first-frame,
+         * during which the consumer renders a black screen. Pre-waking
+         * compresses that gap.
+         *
+         * Returns `awoke: true` when the firmware acknowledged the wake
+         * before `timeoutMs`. Returns `awoke: false` when it timed out OR
+         * the cap surface is unavailable (no Baichuan / firmware
+         * channel); the caller should still attempt the stream — the
+         * passive broker wake remains as fallback.
+         */
+        readonly wakeForStream: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            timeoutMs: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            awoke: z.ZodBoolean;
+            durationMs: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+    };
     readonly events: {
         /**
          * Emitted whenever the cached status changes (firmware push OR
@@ -44,6 +70,7 @@ export declare const batteryCapability: {
                     }>;
                     sleeping: z.ZodBoolean;
                     lastUpdated: z.ZodNumber;
+                    binary: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>;
             }, z.core.$strip>;
         };
@@ -58,6 +85,7 @@ export declare const batteryCapability: {
             }>;
             sleeping: z.ZodBoolean;
             lastUpdated: z.ZodNumber;
+            binary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
         readonly kind: "push";
     };
@@ -79,6 +107,7 @@ export declare const batteryCapability: {
         }>;
         sleeping: z.ZodBoolean;
         lastUpdated: z.ZodNumber;
+        binary: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 };
 export type IBatteryProvider = InferProvider<typeof batteryCapability>;

package/dist/capabilities/battery.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"battery.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/battery.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAkB9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,iBAAiB;;;;;;;QAO1B;;;;;WAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUL;;;;;;;;OAQG;;;;;;;;;;;CAEoC,CAAA;AAEzC,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,OAAO,iBAAiB,CAAC,CAAA"}
+{"version":3,"file":"battery.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/battery.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;iBA0B9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,iBAAiB;;;;;;;QAO1B;;;;;;;;;;;;;;;WAeG;;;;;;;;;;QAeH;;;;;WAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAUL;;;;;;;;OAQG;;;;;;;;;;;;CAEoC,CAAA;AAEzC,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,OAAO,iBAAiB,CAAC,CAAA"}