@camstack/types 0.1.39 → 0.1.41

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
@@ -177,10 +179,10 @@ export declare abstract class BaseAddon<TConfig extends object = Record<string,
      */
     protected schema(schema: TypedConfigUISchema<TConfig>): ConfigUISchema;
     /** Override to provide global-level settings UI schema. */
-    protected globalSettingsSchema(): ConfigUISchema | null;
+    protected globalSettingsSchema(_cap?: string): ConfigUISchema | null;
     /** Override to provide device-level settings UI schema. */
     protected deviceSettingsSchema(): ConfigUISchema | null;
-    getGlobalSettings(overlay?: Record<string, unknown>): Promise<ConfigUISchemaWithValues>;
+    getGlobalSettings(overlay?: Record<string, unknown>, cap?: string): Promise<ConfigUISchemaWithValues>;
     updateGlobalSettings(patch: Partial<TConfig>): Promise<void>;
     /**
      * If any field in `patch` is marked `requiresRestart` in `schema`,
@@ -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/addon-settings.cap.d.ts

@@ -92,6 +92,7 @@ export declare const addonSettingsCapability: {
             addonId: z.ZodString;
             nodeId: z.ZodOptional<z.ZodString>;
             overlay: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            cap: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
             tabs: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 id: z.ZodString;

package/dist/capabilities/addon-settings.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addon-settings.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addon-settings.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AASlG,QAAA,MAAM,0BAA0B;;;;;iBAK9B,CAAA;AAEF,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;;iBAcjC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAA;AAEF,4EAA4E;AAC5E,QAAA,MAAM,mBAAmB,wCAAoC,CAAA;AAE7D,uDAAuD;AACvD,QAAA,MAAM,0BAA0B;;iBAE9B,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCK,CAAA;AAEzC,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAElF,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,GAC3B,CAAA"}
+{"version":3,"file":"addon-settings.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addon-settings.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AASlG,QAAA,MAAM,0BAA0B;;;;;iBAK9B,CAAA;AAEF,QAAA,MAAM,6BAA6B;;;;;;;;;;;;;;;;;iBAcjC,CAAA;AAEF,QAAA,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAA;AAEF,4EAA4E;AAC5E,QAAA,MAAM,mBAAmB,wCAAoC,CAAA;AAE7D,uDAAuD;AACvD,QAAA,MAAM,0BAA0B;;iBAE9B,CAAA;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyCK,CAAA;AAEzC,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAElF,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,0BAA0B,EAC1B,mBAAmB,EACnB,0BAA0B,GAC3B,CAAA"}

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

@@ -95,6 +95,7 @@ declare const PackageUpdateSchema: z.ZodObject<{
         core: "core";
     }>;
     requiresRestart: z.ZodBoolean;
+    isSystem: z.ZodBoolean;
 }, z.core.$strip>;
 declare const PackageVersionInfoSchema: z.ZodObject<{
     version: z.ZodString;
@@ -141,6 +142,72 @@ declare const UpdateFrameworkPackageResultSchema: z.ZodObject<{
     toVersion: z.ZodString;
     restartingAt: z.ZodNumber;
 }, z.core.$strip>;
+declare const BulkUpdateItemStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    queued: "queued";
+    updating: "updating";
+    done: "done";
+    "done-pending-restart": "done-pending-restart";
+}>;
+declare const BulkUpdateItemSchema: z.ZodObject<{
+    name: z.ZodString;
+    isSystem: z.ZodBoolean;
+    fromVersion: z.ZodString;
+    toVersion: z.ZodString;
+    status: z.ZodEnum<{
+        failed: "failed";
+        queued: "queued";
+        updating: "updating";
+        done: "done";
+        "done-pending-restart": "done-pending-restart";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+    startedAtMs: z.ZodOptional<z.ZodNumber>;
+    completedAtMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const BulkUpdatePhaseSchema: z.ZodEnum<{
+    system: "system";
+    regular: "regular";
+    restarting: "restarting";
+    finalizing: "finalizing";
+}>;
+declare const BulkUpdateStateSchema: z.ZodObject<{
+    id: z.ZodString;
+    nodeId: z.ZodString;
+    startedAtMs: z.ZodNumber;
+    completedAtMs: z.ZodOptional<z.ZodNumber>;
+    total: z.ZodNumber;
+    completed: z.ZodNumber;
+    failed: z.ZodNumber;
+    current: z.ZodNullable<z.ZodString>;
+    phase: z.ZodEnum<{
+        system: "system";
+        regular: "regular";
+        restarting: "restarting";
+        finalizing: "finalizing";
+    }>;
+    cancelled: z.ZodBoolean;
+    items: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        isSystem: z.ZodBoolean;
+        fromVersion: z.ZodString;
+        toVersion: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            queued: "queued";
+            updating: "updating";
+            done: "done";
+            "done-pending-restart": "done-pending-restart";
+        }>;
+        error: z.ZodOptional<z.ZodString>;
+        startedAtMs: z.ZodOptional<z.ZodNumber>;
+        completedAtMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type BulkUpdateItemStatus = z.infer<typeof BulkUpdateItemStatusSchema>;
+export type BulkUpdateItem = z.infer<typeof BulkUpdateItemSchema>;
+export type BulkUpdatePhase = z.infer<typeof BulkUpdatePhaseSchema>;
+export type BulkUpdateState = z.infer<typeof BulkUpdateStateSchema>;
 /**
  * One framework package row for the admin-UI "System packages" panel.
  * `latestVersion` is null when the npm lookup failed (offline / registry
@@ -289,6 +356,7 @@ export declare const addonsCapability: {
                 core: "core";
             }>;
             requiresRestart: z.ZodBoolean;
+            isSystem: z.ZodBoolean;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Update one package on a node. `nodeId` omitted (or `'hub'`)
@@ -343,6 +411,7 @@ export declare const addonsCapability: {
                 system: "system";
                 manual: "manual";
                 "framework-update": "framework-update";
+                "framework-bulk-update": "framework-bulk-update";
             }>;
             packageName: z.ZodOptional<z.ZodString>;
             fromVersion: z.ZodOptional<z.ZodString>;
@@ -433,12 +502,129 @@ export declare const addonsCapability: {
         readonly updateFrameworkPackage: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             packageName: z.ZodString;
             version: z.ZodOptional<z.ZodString>;
+            deferRestart: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{
             packageName: z.ZodString;
             fromVersion: z.ZodString;
             toVersion: z.ZodString;
             restartingAt: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Kicks off a server-side bulk update operation and returns the bulk
+         * id immediately. The operation runs asynchronously; observe progress
+         * via the `AddonsBulkUpdateProgress` event or `getBulkUpdateState`.
+         * Items with `isSystem: true` use `deferRestart` — the hub restarts
+         * ONCE at the end of the system phase, after all system packages are
+         * installed.
+         *
+         * `items[].version` is REQUIRED — callers must pass the resolved
+         * version from `listUpdates`. There is no `'latest'` default here
+         * (unlike `updatePackage`) to guarantee deterministic bulk rolls.
+         */
+        readonly startBulkUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            nodeId: z.ZodString;
+            items: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                version: z.ZodString;
+                isSystem: z.ZodBoolean;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Returns the current state of a bulk update by id.
+         * Returns `null` if the id is unknown or has been auto-cleaned
+         * (5 minutes after `completedAt` the record is evicted from memory).
+         */
+        readonly getBulkUpdateState: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+            id: z.ZodString;
+            nodeId: z.ZodString;
+            startedAtMs: z.ZodNumber;
+            completedAtMs: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodNumber;
+            completed: z.ZodNumber;
+            failed: z.ZodNumber;
+            current: z.ZodNullable<z.ZodString>;
+            phase: z.ZodEnum<{
+                system: "system";
+                regular: "regular";
+                restarting: "restarting";
+                finalizing: "finalizing";
+            }>;
+            cancelled: z.ZodBoolean;
+            items: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                isSystem: z.ZodBoolean;
+                fromVersion: z.ZodString;
+                toVersion: z.ZodString;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    queued: "queued";
+                    updating: "updating";
+                    done: "done";
+                    "done-pending-restart": "done-pending-restart";
+                }>;
+                error: z.ZodOptional<z.ZodString>;
+                startedAtMs: z.ZodOptional<z.ZodNumber>;
+                completedAtMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Cancels an in-flight bulk update. The update loop exits after the
+         * currently-processing item completes — cancellation is not
+         * instantaneous. Has no effect once the `restarting` phase has been
+         * entered (the hub is already shutting down at that point).
+         * Returns `{ cancelled: false }` if the id is unknown, the operation
+         * has already completed, or the `restarting` phase is active.
+         */
+        readonly cancelBulkUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            cancelled: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Lists all currently active (non-completed) bulk updates.
+         * If `nodeId` is provided, filters to only bulk updates targeting
+         * that node. Useful for restoring an in-progress banner on a fresh
+         * page load when the UI reconnects mid-operation.
+         */
+        readonly listActiveBulkUpdates: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            nodeId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            nodeId: z.ZodString;
+            startedAtMs: z.ZodNumber;
+            completedAtMs: z.ZodOptional<z.ZodNumber>;
+            total: z.ZodNumber;
+            completed: z.ZodNumber;
+            failed: z.ZodNumber;
+            current: z.ZodNullable<z.ZodString>;
+            phase: z.ZodEnum<{
+                system: "system";
+                regular: "regular";
+                restarting: "restarting";
+                finalizing: "finalizing";
+            }>;
+            cancelled: z.ZodBoolean;
+            items: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                isSystem: z.ZodBoolean;
+                fromVersion: z.ZodString;
+                toVersion: z.ZodString;
+                status: z.ZodEnum<{
+                    failed: "failed";
+                    queued: "queued";
+                    updating: "updating";
+                    done: "done";
+                    "done-pending-restart": "done-pending-restart";
+                }>;
+                error: z.ZodOptional<z.ZodString>;
+                startedAtMs: z.ZodOptional<z.ZodNumber>;
+                completedAtMs: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getVersions: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -525,5 +711,5 @@ export declare const addonsCapability: {
     };
 };
 export type IAddonsProvider = InferProvider<typeof addonsCapability>;
-export { AddonListItemSchema, InstalledPackageSchema, PackageUpdateSchema, PackageVersionInfoSchema, SearchResultSchema, AutoUpdateSettingsSchema, AddonAutoUpdateSchema, LogStreamEntrySchema, CustomActionInputSchema, LogLevelSchema, ChannelSchema, ChannelWithInheritSchema, UpdateFrameworkPackageResultSchema, FrameworkPackageStatusSchema, };
+export { AddonListItemSchema, InstalledPackageSchema, PackageUpdateSchema, PackageVersionInfoSchema, SearchResultSchema, AutoUpdateSettingsSchema, AddonAutoUpdateSchema, LogStreamEntrySchema, CustomActionInputSchema, LogLevelSchema, ChannelSchema, ChannelWithInheritSchema, UpdateFrameworkPackageResultSchema, FrameworkPackageStatusSchema, BulkUpdateItemStatusSchema, BulkUpdateItemSchema, BulkUpdatePhaseSchema, BulkUpdateStateSchema, };
 //# sourceMappingURL=addons.cap.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"addons.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addons.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAElG;;;;;;;;;;;;;;GAcG;AAYH,QAAA,MAAM,cAAc;;;;;EAA6C,CAAA;AACjE,QAAA,MAAM,aAAa;;;;EAAoC,CAAA;AACvD,QAAA,MAAM,wBAAwB;;;;;EAA+C,CAAA;AAiE7E,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAevB,CAAA;AAEF,QAAA,MAAM,sBAAsB;;;;;iBAK1B,CAAA;AAEF,QAAA,MAAM,mBAAmB;;;;;;;;;iBAMvB,CAAA;AAEF,QAAA,MAAM,wBAAwB;;;;;iBAK5B,CAAA;AAEF,QAAA,MAAM,kBAAkB;;;;;;;;;iBAStB,CAAA;AAEF,QAAA,MAAM,wBAAwB;;;;;;;iBAG5B,CAAA;AAEF,QAAA,MAAM,qBAAqB;;;;;EAA2B,CAAA;AAOtD;;;;;;;;GAQG;AACH,QAAA,MAAM,kCAAkC;;;;;iBAMtC,CAAA;AAEF;;;;GAIG;AACH,QAAA,MAAM,4BAA4B;;;;;;iBAOhC,CAAA;AAGF,QAAA,MAAM,oBAAoB;;;;;iBAKxB,CAAA;AAQF,QAAA,MAAM,uBAAuB;;;;iBAI3B,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoDzB;;;;;WAKG;;;;;;;;;;;;;QAMH;;;;;WAKG;;;;;;QAUH;;;;;;;;;;;WAWG;;;;;;QAMH;;6CAEqC;;;;;;;QAWrC;;;;;;;;;;WAUG;;;;;;;;;;;;;QAaH;;;;;;;WAOG;;;;;;;;QAMH;;;;;;;;;;;;;;;;;;;WAmBG;;;;;;;;;;;QASH;;;;;;;;;;;;;WAaG;;;;;;;;QAUH;;;;;;;;;;;;;WAaG;;;;;;;;;;;;;;;;;;;;;QAmBH;;;;;WAKG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDkC,CAAA;AAEzC,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEpE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,kCAAkC,EAClC,4BAA4B,GAC7B,CAAA"}
+{"version":3,"file":"addons.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/addons.cap.ts"],"names":[],"mappings":"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"}

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"}