@camstack/types 1.2.417 → 1.2.419

package/dist/{composition-DsmkwP9-.js → composition-re1aezX9.js}

@@ -2160,6 +2160,85 @@ function evaluateExpressionSource(expr, bindingValues, now, opts) {
 	}
 }
 //#endregion
+//#region src/composition/source-ref.ts
+/**
+* A composition source identity: `(addonId, stableId)`, never a numeric device
+* id. Split out so helper schemas can name it without a cycle through
+* `composition.ts` (D659).
+*/
+var CompositionSourceRefSchema = zod.z.object({
+	/** The owning addon; `stableId` is unique only within it. */
+	addonId: zod.z.string().min(1),
+	stableId: zod.z.string().min(1)
+});
+//#endregion
+//#region src/composition/helpers/spec.ts
+/**
+* A helper spec is what the editor stores and reads back (D944). The compiled
+* features are a projection; the editor never edits the expression.
+*/
+/** A group may name more members than an expression call (the 16-arg cap). */
+var MAX_HELPER_MEMBERS = 64;
+var GROUP_TEMPLATE_IDS = [
+	"temperature",
+	"humidity",
+	"pressure",
+	"illuminance",
+	"power",
+	"energy",
+	"battery",
+	"numeric",
+	"motion",
+	"contact",
+	"leak",
+	"smoke",
+	"occupancy",
+	"binary",
+	"switch",
+	"light"
+];
+var NUMERIC_AGGREGATES = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum"
+];
+var BINARY_AGGREGATES = ["any", "all"];
+/** How an actuator group decides it is on. Unknown members never count as off. */
+var ACTIVE_CRITERIA = ["at-least-one", "all"];
+var AGGREGATE_REDUCERS = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum",
+	"any",
+	"all"
+];
+var GroupTemplateIdSchema = zod.z.enum(GROUP_TEMPLATE_IDS);
+var AggregateReducerSchema = zod.z.enum(AGGREGATE_REDUCERS);
+var ActiveCriterionSchema = zod.z.enum(ACTIVE_CRITERIA);
+/** One member. The field is stored so occupancy can name motion or binary. */
+var HelperMemberSchema = zod.z.object({
+	source: CompositionSourceRefSchema,
+	cap: zod.z.string().min(1),
+	fieldPath: zod.z.string().min(1)
+});
+/**
+* Phase 1a is groups only. Math, integral and statistics stay off this union
+* until the composer can run them — a control must not save a spec it cannot.
+*/
+var GroupHelperSpecSchema = zod.z.object({
+	kind: zod.z.literal("group"),
+	templateId: GroupTemplateIdSchema,
+	aggregate: AggregateReducerSchema,
+	members: zod.z.array(HelperMemberSchema).min(1).max(64),
+	/** Actuator groups only. Readings leave this unset. */
+	active: ActiveCriterionSchema.optional()
+});
+var HelperSpecSchema = zod.z.discriminatedUnion("kind", [GroupHelperSpecSchema]);
+//#endregion
 //#region src/composition/composition.ts
 /**
 * A COMPOSITION: a device assembled from other devices' state (D659).
@@ -2195,11 +2274,6 @@ var MAX_COMPOSITION_FEATURES = 16;
 var MAX_COMPOSITION_FIELDS_PER_FEATURE = 32;
 /** Longest snippet a `code` source may carry (slice 4). */
 var MAX_COMPOSITION_CODE_LENGTH = 2e4;
-var CompositionSourceRefSchema = zod.z.object({
-	/** The owning addon; `stableId` is unique only within it. */
-	addonId: zod.z.string().min(1),
-	stableId: zod.z.string().min(1)
-});
 /** One field of one capability of one source device. */
 var CompositionFieldReadSchema = zod.z.object({
 	source: CompositionSourceRefSchema,
@@ -2242,10 +2316,42 @@ var CompositionCodeSourceSchema = zod.z.object({
 	kind: zod.z.literal("code"),
 	code: zod.z.string().min(1).max(MAX_COMPOSITION_CODE_LENGTH)
 });
+/**
+* `aggregate`: a group reducer. Offline and unknown reads are excluded, not
+* folded in as 0 or false (D944). Free expressions stay `expression` so a
+* stale member is still included there.
+*/
+var CompositionAggregateSourceSchema = zod.z.object({
+	kind: zod.z.literal("aggregate"),
+	reducer: zod.z.enum([
+		"mean",
+		"median",
+		"min",
+		"max",
+		"sum",
+		"any",
+		"all"
+	]),
+	reads: zod.z.array(CompositionFieldReadSchema).min(1).max(64),
+	/** `value` is the reading; the others are the member counts. */
+	publish: zod.z.enum([
+		"value",
+		"included",
+		"excluded",
+		"total"
+	]),
+	/** What a `value` publish does when nobody is included. Counts ignore this. */
+	empty: zod.z.enum([
+		"null",
+		"omit",
+		"offline"
+	])
+});
 var CompositionFieldSourceSchema = zod.z.discriminatedUnion("kind", [
 	CompositionFromSourceSchema,
 	CompositionExpressionSourceSchema,
-	CompositionCodeSourceSchema
+	CompositionCodeSourceSchema,
+	CompositionAggregateSourceSchema
 ]);
 /** `forward`: RESERVED for slice 3. Argument mapping arrives there as an additive optional `args`. */
 var CompositionForwardCommandSchema = zod.z.object({
@@ -2311,7 +2417,13 @@ var CompositionExistingTargetSchema = zod.z.object({
 var CompositionTargetSchema = zod.z.discriminatedUnion("kind", [CompositionNewTargetSchema, CompositionExistingTargetSchema]);
 var CompositionSchema = zod.z.object({
 	target: CompositionTargetSchema,
-	features: zod.z.array(CompositionFeatureSchema).min(1).max(16)
+	features: zod.z.array(CompositionFeatureSchema).min(1).max(16),
+	/**
+	* Present when the block is a helper template. Absent on a free
+	* composition (the room example, device 4603). The editor reads this,
+	* never the compiled features.
+	*/
+	helper: HelperSpecSchema.optional()
 }).superRefine((composition, ctx) => {
 	const seen = /* @__PURE__ */ new Set();
 	composition.features.forEach((feature, index) => {
@@ -2358,6 +2470,7 @@ function fieldReads(source) {
 			cap: binding.cap,
 			fieldPath: binding.fieldPath
 		}] : []);
+		case "aggregate": return source.reads;
 		case "code": return [];
 	}
 }
@@ -2384,12 +2497,42 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
+Object.defineProperty(exports, "ACTIVE_CRITERIA", {
+	enumerable: true,
+	get: function() {
+		return ACTIVE_CRITERIA;
+	}
+});
+Object.defineProperty(exports, "AGGREGATE_REDUCERS", {
+	enumerable: true,
+	get: function() {
+		return AGGREGATE_REDUCERS;
+	}
+});
 Object.defineProperty(exports, "AUDIO_PRESETS", {
 	enumerable: true,
 	get: function() {
 		return AUDIO_PRESETS;
 	}
 });
+Object.defineProperty(exports, "ActiveCriterionSchema", {
+	enumerable: true,
+	get: function() {
+		return ActiveCriterionSchema;
+	}
+});
+Object.defineProperty(exports, "AggregateReducerSchema", {
+	enumerable: true,
+	get: function() {
+		return AggregateReducerSchema;
+	}
+});
+Object.defineProperty(exports, "BINARY_AGGREGATES", {
+	enumerable: true,
+	get: function() {
+		return BINARY_AGGREGATES;
+	}
+});
 Object.defineProperty(exports, "COMPOSED_DEVICE_STABLE_ID_PREFIX", {
 	enumerable: true,
 	get: function() {
@@ -2420,6 +2563,12 @@ Object.defineProperty(exports, "CUSTOMIZATION_BLOCK_NAME_PREFIX", {
 		return CUSTOMIZATION_BLOCK_NAME_PREFIX;
 	}
 });
+Object.defineProperty(exports, "CompositionAggregateSourceSchema", {
+	enumerable: true,
+	get: function() {
+		return CompositionAggregateSourceSchema;
+	}
+});
 Object.defineProperty(exports, "CompositionBindingSchema", {
 	enumerable: true,
 	get: function() {
@@ -2594,6 +2743,36 @@ Object.defineProperty(exports, "Fmp4BoxSplitter", {
 		return Fmp4BoxSplitter;
 	}
 });
+Object.defineProperty(exports, "GROUP_TEMPLATE_IDS", {
+	enumerable: true,
+	get: function() {
+		return GROUP_TEMPLATE_IDS;
+	}
+});
+Object.defineProperty(exports, "GroupHelperSpecSchema", {
+	enumerable: true,
+	get: function() {
+		return GroupHelperSpecSchema;
+	}
+});
+Object.defineProperty(exports, "GroupTemplateIdSchema", {
+	enumerable: true,
+	get: function() {
+		return GroupTemplateIdSchema;
+	}
+});
+Object.defineProperty(exports, "HelperMemberSchema", {
+	enumerable: true,
+	get: function() {
+		return HelperMemberSchema;
+	}
+});
+Object.defineProperty(exports, "HelperSpecSchema", {
+	enumerable: true,
+	get: function() {
+		return HelperSpecSchema;
+	}
+});
 Object.defineProperty(exports, "MAX_COMPOSITION_CODE_LENGTH", {
 	enumerable: true,
 	get: function() {
@@ -2648,6 +2827,18 @@ Object.defineProperty(exports, "MAX_EXPRESSION_SOURCE_LENGTH", {
 		return MAX_EXPRESSION_SOURCE_LENGTH;
 	}
 });
+Object.defineProperty(exports, "MAX_HELPER_MEMBERS", {
+	enumerable: true,
+	get: function() {
+		return MAX_HELPER_MEMBERS;
+	}
+});
+Object.defineProperty(exports, "NUMERIC_AGGREGATES", {
+	enumerable: true,
+	get: function() {
+		return NUMERIC_AGGREGATES;
+	}
+});
 Object.defineProperty(exports, "RESERVED_BINDING_NAMES", {
 	enumerable: true,
 	get: function() {

package/dist/device/cap-vocabulary/entries/sensors.d.ts

@@ -1,5 +1,5 @@
 import type { CapVocabularySlice } from '../types.js';
-type SensorCap = 'air-quality-sensor' | 'ambient-light-sensor' | 'binary' | 'carbon-monoxide' | 'connectivity' | 'contact' | 'enum-sensor' | 'flood' | 'gas' | 'humidity-sensor' | 'motion' | 'numeric-sensor' | 'power-meter' | 'presence' | 'pressure-sensor' | 'smoke' | 'tamper' | 'temperature-sensor' | 'vibration' | 'weather' | 'battery' | 'network-link' | 'device-status' | 'doorbell' | 'event-emitter';
+type SensorCap = 'air-quality-sensor' | 'ambient-light-sensor' | 'binary' | 'carbon-monoxide' | 'connectivity' | 'contact' | 'enum-sensor' | 'flood' | 'gas' | 'group-commands' | 'group-status' | 'humidity-sensor' | 'motion' | 'numeric-sensor' | 'power-meter' | 'presence' | 'pressure-sensor' | 'smoke' | 'tamper' | 'temperature-sensor' | 'vibration' | 'weather' | 'battery' | 'network-link' | 'device-status' | 'doorbell' | 'event-emitter';
 /** The sensor family of the vocabulary. */
 export declare const SENSOR_CAP_VOCABULARY: CapVocabularySlice<SensorCap>;
 export {};

package/dist/enums/event-category.d.ts

@@ -322,6 +322,14 @@ export declare enum EventCategory {
     PipelineMotionNoisy = "pipeline.motion-noisy",
     /** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
     PipelineMotionCalm = "pipeline.motion-calm",
+    /**
+     * A camera's package LLM confirm has failed closed three times in a row
+     * (D931, 2026-10-26). One edge per camera until
+     * {@link PipelinePackageLlmAnswered}.
+     */
+    PipelinePackageLlmSilent = "pipeline.package-llm-silent",
+    /** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+    PipelinePackageLlmAnswered = "pipeline.package-llm-answered",
     /**
      * Per-camera pipeline config was mutated by the orchestrator
      * (a settings change via `setAgentInferenceDevices` /

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-DXZ3f9Q5.js");
+const require_event_category = require("./event-category-Ave2VSxY.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-DHXxB8t9.mjs";
+import { t as EventCategory } from "./event-category-CT-hz5Rb.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-DXZ3f9Q5.js → event-category-Ave2VSxY.js}

@@ -324,6 +324,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
 	EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
 	/**
+	* A camera's package LLM confirm has failed closed three times in a row
+	* (D931, 2026-10-26). One edge per camera until
+	* {@link PipelinePackageLlmAnswered}.
+	*/
+	EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
+	/** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+	EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (a settings change via `setAgentInferenceDevices` /
 	* `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator

package/dist/{event-category-DHXxB8t9.mjs → event-category-CT-hz5Rb.mjs}

@@ -324,6 +324,14 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** The recovery edge of {@link PipelineMotionNoisy}: the motion fell back, or a detection arrived. */
 	EventCategory["PipelineMotionCalm"] = "pipeline.motion-calm";
 	/**
+	* A camera's package LLM confirm has failed closed three times in a row
+	* (D931, 2026-10-26). One edge per camera until
+	* {@link PipelinePackageLlmAnswered}.
+	*/
+	EventCategory["PipelinePackageLlmSilent"] = "pipeline.package-llm-silent";
+	/** The recovery edge of {@link PipelinePackageLlmSilent}: a confirm returned yes or no. */
+	EventCategory["PipelinePackageLlmAnswered"] = "pipeline.package-llm-answered";
+	/**
 	* Per-camera pipeline config was mutated by the orchestrator
 	* (a settings change via `setAgentInferenceDevices` /
 	* `setCameraStepToggle` / `setCameraStepSettings`). Orchestrator

package/dist/generated/addon-api.d.ts

@@ -438,6 +438,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof addonsCapability.methods.getVersions.output>;
             meta: object;
         }>;
+        getPackageDocs: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof addonsCapability.methods.getPackageDocs.input>;
+            output: z.infer<typeof addonsCapability.methods.getPackageDocs.output>;
+            meta: object;
+        }>;
         restartAddon: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -3843,6 +3850,34 @@ export type AppRouter = TrpcCoreRouter<{
             meta: object;
         }>;
     }>>;
+    groupCommands: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof DEVICE_STATUS_METHOD.getStatus.input>;
+            output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
+            meta: object;
+        }>;
+    }>>;
+    groupStatus: TRPCBuiltRouter<{
+        ctx: TrpcContext;
+        meta: object;
+        errorShape: AugmentedErrorShape;
+        transformer: true;
+    }, TRPCDecorateCreateRouterOptions<{
+        getStatus: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof DEVICE_STATUS_METHOD.getStatus.input>;
+            output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
+            meta: object;
+        }>;
+    }>>;
     heatingValve: TRPCBuiltRouter<{
         ctx: TrpcContext;
         meta: object;

package/dist/generated/addon-cap-facts.d.ts

@@ -5,7 +5,7 @@
  * `ALL_CAPABILITY_DEFINITIONS` (the whole Zod schema graph, ~+100 MB heap per
  * runner). See docs/decisions/adr-0028.md.
  *
- * Coverage: 1 advance-derived caps, 74 caps with 348 state leaves.
+ * Coverage: 1 advance-derived caps, 75 caps with 351 state leaves.
  */
 /** A bindable scalar in a capability's runtime state. */
 export interface CapStateLeaf {

package/dist/generated/cap-status-types.d.ts

@@ -30,6 +30,8 @@ import type { FanControlStatusSchema } from '../capabilities/fan-control.cap.js'
 import type { FeatureProbeStatusSchema } from '../capabilities/feature-probe.cap.js';
 import type { FloodStatusSchema } from '../capabilities/flood.cap.js';
 import type { GasStatusSchema } from '../capabilities/gas.cap.js';
+import type { groupCommandsCapability } from '../capabilities/group-commands.cap.js';
+import type { groupStatusCapability } from '../capabilities/group-status.cap.js';
 import type { HeatingValveStatusSchema } from '../capabilities/heating-valve.cap.js';
 import type { HumidifierStatusSchema } from '../capabilities/humidifier.cap.js';
 import type { HumiditySensorStatusSchema } from '../capabilities/humidity-sensor.cap.js';
@@ -111,6 +113,8 @@ export type CapStatusTypeMap = {
     readonly 'feature-probe': z.infer<typeof FeatureProbeStatusSchema>;
     readonly 'flood': z.infer<typeof FloodStatusSchema>;
     readonly 'gas': z.infer<typeof GasStatusSchema>;
+    readonly 'group-commands': z.infer<(typeof groupCommandsCapability)['status']['schema']>;
+    readonly 'group-status': z.infer<(typeof groupStatusCapability)['status']['schema']>;
     readonly 'heating-valve': z.infer<typeof HeatingValveStatusSchema>;
     readonly 'humidifier': z.infer<typeof HumidifierStatusSchema>;
     readonly 'humidity-sensor': z.infer<typeof HumiditySensorStatusSchema>;
@@ -163,4 +167,4 @@ export type CapNameWithStatus = keyof CapStatusTypeMap;
  * aggregator to enumerate caps whose `status` should be polled +
  * streamed via `subscribeDeviceStatusAggregate`.
  */
-export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "dishwasher", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "heating-valve", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording-archive", "recording-onboard", "recording-signal", "running-state", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];
+export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-discovery", "device-export", "device-status", "dishwasher", "doorbell", "enum-sensor", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "group-commands", "group-status", "heating-valve", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "recording-archive", "recording-onboard", "recording-signal", "running-state", "scene-monitor", "script-runner", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather"];

package/dist/generated/capability-router-map.d.ts

@@ -72,6 +72,8 @@ export { featureProbeCapability } from '../capabilities/feature-probe.cap.js';
 export { filesystemBrowseCapability } from '../capabilities/filesystem-browse.cap.js';
 export { floodCapability } from '../capabilities/flood.cap.js';
 export { gasCapability } from '../capabilities/gas.cap.js';
+export { groupCommandsCapability } from '../capabilities/group-commands.cap.js';
+export { groupStatusCapability } from '../capabilities/group-status.cap.js';
 export { heatingValveCapability } from '../capabilities/heating-valve.cap.js';
 export { humidifierCapability } from '../capabilities/humidifier.cap.js';
 export { humiditySensorCapability } from '../capabilities/humidity-sensor.cap.js';
@@ -254,6 +256,8 @@ export declare const CAPABILITY_NAMES: {
     readonly filesystemBrowse: 'filesystem-browse';
     readonly flood: 'flood';
     readonly gas: 'gas';
+    readonly groupCommands: 'group-commands';
+    readonly groupStatus: 'group-status';
     readonly heatingValve: 'heating-valve';
     readonly humidifier: 'humidifier';
     readonly humiditySensor: 'humidity-sensor';
@@ -449,6 +453,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly filesystemBrowse: TRouter;
     readonly flood: TRouter;
     readonly gas: TRouter;
+    readonly groupCommands: TRouter;
+    readonly groupStatus: TRouter;
     readonly heatingValve: TRouter;
     readonly humidifier: TRouter;
     readonly humiditySensor: TRouter;
@@ -557,8 +563,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly zoneRules: TRouter;
     readonly zones: TRouter;
 }
-/** Capability names whose mode is `singleton` (146 caps). */
-export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-state', 'device-status', 'dishwasher', 'display-palette', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'heating-valve', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'metrics-provider', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'oidc-connections', 'osd', 'osd-manager', 'pet-feeder', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'running-state', 'scene-monitor', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
+/** Capability names whose mode is `singleton` (148 caps). */
+export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-state', 'device-status', 'dishwasher', 'display-palette', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-commands', 'group-status', 'heating-valve', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'metrics-provider', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'oidc-connections', 'osd', 'osd-manager', 'pet-feeder', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'running-state', 'scene-monitor', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
 /** Union of singleton capability names (literal string union). */
 export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
 /** Capability names whose mode is `collection` (35 caps). */

package/dist/generated/device-local-state.d.ts

@@ -27,6 +27,8 @@ import { fanControlCapability } from '../capabilities/fan-control.cap.js';
 import { featureProbeCapability } from '../capabilities/feature-probe.cap.js';
 import { floodCapability } from '../capabilities/flood.cap.js';
 import { gasCapability } from '../capabilities/gas.cap.js';
+import { groupCommandsCapability } from '../capabilities/group-commands.cap.js';
+import { groupStatusCapability } from '../capabilities/group-status.cap.js';
 import { heatingValveCapability } from '../capabilities/heating-valve.cap.js';
 import { humidifierCapability } from '../capabilities/humidifier.cap.js';
 import { humiditySensorCapability } from '../capabilities/humidity-sensor.cap.js';
@@ -111,6 +113,8 @@ export interface DeviceLocalState {
     featureProbe: InferRuntimeState<typeof featureProbeCapability>;
     flood: InferRuntimeState<typeof floodCapability>;
     gas: InferRuntimeState<typeof gasCapability>;
+    groupCommands: InferRuntimeState<typeof groupCommandsCapability>;
+    groupStatus: InferRuntimeState<typeof groupStatusCapability>;
     heatingValve: InferRuntimeState<typeof heatingValveCapability>;
     humidifier: InferRuntimeState<typeof humidifierCapability>;
     humiditySensor: InferRuntimeState<typeof humiditySensorCapability>;
@@ -205,6 +209,8 @@ export interface CapNameToRuntimeStateMap {
     'feature-probe': InferRuntimeState<typeof featureProbeCapability>;
     'flood': InferRuntimeState<typeof floodCapability>;
     'gas': InferRuntimeState<typeof gasCapability>;
+    'group-commands': InferRuntimeState<typeof groupCommandsCapability>;
+    'group-status': InferRuntimeState<typeof groupStatusCapability>;
     'heating-valve': InferRuntimeState<typeof heatingValveCapability>;
     'humidifier': InferRuntimeState<typeof humidifierCapability>;
     'humidity-sensor': InferRuntimeState<typeof humiditySensorCapability>;

package/dist/generated/device-proxy.d.ts

@@ -40,6 +40,8 @@ import type { fanControlCapability } from '../capabilities/fan-control.cap.js';
 import type { featureProbeCapability } from '../capabilities/feature-probe.cap.js';
 import type { floodCapability } from '../capabilities/flood.cap.js';
 import type { gasCapability } from '../capabilities/gas.cap.js';
+import type { groupCommandsCapability } from '../capabilities/group-commands.cap.js';
+import type { groupStatusCapability } from '../capabilities/group-status.cap.js';
 import type { heatingValveCapability } from '../capabilities/heating-valve.cap.js';
 import type { humidifierCapability } from '../capabilities/humidifier.cap.js';
 import type { humiditySensorCapability } from '../capabilities/humidity-sensor.cap.js';
@@ -145,6 +147,8 @@ export interface DeviceProxyState {
     readonly featureProbe: SliceHandle<InferRuntimeState<typeof featureProbeCapability>>;
     readonly flood: SliceHandle<InferRuntimeState<typeof floodCapability>>;
     readonly gas: SliceHandle<InferRuntimeState<typeof gasCapability>>;
+    readonly groupCommands: SliceHandle<InferRuntimeState<typeof groupCommandsCapability>>;
+    readonly groupStatus: SliceHandle<InferRuntimeState<typeof groupStatusCapability>>;
     readonly heatingValve: SliceHandle<InferRuntimeState<typeof heatingValveCapability>>;
     readonly humidifier: SliceHandle<InferRuntimeState<typeof humidifierCapability>>;
     readonly humiditySensor: SliceHandle<InferRuntimeState<typeof humiditySensorCapability>>;
@@ -246,6 +250,8 @@ export interface DeviceProxy {
     readonly featureProbe?: InferDeviceProxyCap<typeof featureProbeCapability>;
     readonly flood?: InferDeviceProxyCap<typeof floodCapability>;
     readonly gas?: InferDeviceProxyCap<typeof gasCapability>;
+    readonly groupCommands?: InferDeviceProxyCap<typeof groupCommandsCapability>;
+    readonly groupStatus?: InferDeviceProxyCap<typeof groupStatusCapability>;
     readonly heatingValve?: InferDeviceProxyCap<typeof heatingValveCapability>;
     readonly humidifier?: InferDeviceProxyCap<typeof humidifierCapability>;
     readonly humiditySensor?: InferDeviceProxyCap<typeof humiditySensorCapability>;

package/dist/generated/device-scoped-caps.d.ts

@@ -5,7 +5,7 @@
  * can answer "may a rule actuate this?" without importing the schema barrel
  * (~144MB RSS per runner, D28).
  *
- * Coverage: 91 device-scoped capabilities.
+ * Coverage: 93 device-scoped capabilities.
  */
 export declare const DEVICE_SCOPED_CAPS: ReadonlySet<string>;
 /**

package/dist/generated/history-catalog.d.ts

@@ -1,7 +1,7 @@
 import type { CapabilityHistoryField, CapabilityHistoryItems } from '../capabilities/capability-definition.js';
 /**
  * Cap history catalog, projected from every `*.cap.ts` `history` block.
- * 41 caps with series (75 series), 30 caps answered `'none'`.
+ * 41 caps with series (75 series), 32 caps answered `'none'`.
  * Field keys are `runtimeState` paths (`a.b` into fixed objects only).
  */
 export declare const HISTORY_CATALOG: Readonly<Record<string, Readonly<Record<string, CapabilityHistoryField>>>>;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1382 method paths across 181 capabilities.
+ * Coverage: 1385 method paths across 183 capabilities.
  */
 import type { MethodRole } from '../auth/viewer-access.js';
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';

package/dist/generated/method-device-selectors.d.ts

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 546 methods carry a device reference, of which
+ * Coverage: 548 methods carry a device reference, of which
  * 174 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/generated/runtime-state-durability.d.ts

@@ -11,7 +11,7 @@ export interface RuntimeStatePolicy {
 }
 /**
  * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
- * `runtimeState`. 72 caps: 38 `restored`, 34 `session`.
+ * `runtimeState`. 74 caps: 38 `restored`, 36 `session`.
  *
  * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
  * with `durability: 'session'` has one and has decided not to keep it.

package/dist/generated/system-proxy.d.ts

@@ -64,7 +64,7 @@ import type { userManagementCapability } from '../capabilities/user-management.c
  */
 export interface SystemProxy {
     readonly addonPages: Pick<InferProvider<typeof addonPagesCapability>, 'listPages'>;
-    readonly addons: Pick<InferProvider<typeof addonsCapability>, 'list' | 'getLogs' | 'listPackages' | 'installPackage' | 'installFromWorkspace' | 'isWorkspaceAvailable' | 'listWorkspacePackages' | 'uninstallPackage' | 'listInstallations' | 'reloadPackages' | 'searchAvailable' | 'listUpdates' | 'updatePackage' | 'rollbackPackage' | 'forceRefresh' | 'restartServer' | 'getLastRestart' | 'listFrameworkPackages' | 'listCapabilityProviders' | 'setCapabilityProviderEnabled' | 'getVersions' | 'restartAddon' | 'retryLoad' | 'getAutoUpdateSettings' | 'setAutoUpdateSettings' | 'getAddonAutoUpdate' | 'setAddonAutoUpdate' | 'applyAutoUpdateToAll' | 'custom' | 'startJob' | 'getJob' | 'listJobs' | 'cancelJob' | 'onAddonLogs'>;
+    readonly addons: Pick<InferProvider<typeof addonsCapability>, 'list' | 'getLogs' | 'listPackages' | 'installPackage' | 'installFromWorkspace' | 'isWorkspaceAvailable' | 'listWorkspacePackages' | 'uninstallPackage' | 'listInstallations' | 'reloadPackages' | 'searchAvailable' | 'listUpdates' | 'updatePackage' | 'rollbackPackage' | 'forceRefresh' | 'restartServer' | 'getLastRestart' | 'listFrameworkPackages' | 'listCapabilityProviders' | 'setCapabilityProviderEnabled' | 'getVersions' | 'getPackageDocs' | 'restartAddon' | 'retryLoad' | 'getAutoUpdateSettings' | 'setAutoUpdateSettings' | 'getAddonAutoUpdate' | 'setAddonAutoUpdate' | 'applyAutoUpdateToAll' | 'custom' | 'startJob' | 'getJob' | 'listJobs' | 'cancelJob' | 'onAddonLogs'>;
     readonly addonSettings: Pick<InferProvider<typeof addonSettingsCapability>, 'getGlobalSettings' | 'updateGlobalSettings' | 'getIntegrationSettings'>;
     readonly addonWidgets: Pick<InferProvider<typeof addonWidgetsCapability>, 'listWidgets'>;
     readonly alerts: Pick<InferProvider<typeof alertsCapability>, 'emit' | 'update' | 'list' | 'getUnreadCount' | 'markRead' | 'markAllRead' | 'dismiss'>;