@camstack/types 1.2.417 → 1.2.418

package/dist/{composition-kEl9mevu.mjs → composition-B85l9j1M.mjs}

@@ -2160,6 +2160,78 @@ 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 = z.object({
+	/** The owning addon; `stableId` is unique only within it. */
+	addonId: z.string().min(1),
+	stableId: 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"
+];
+var NUMERIC_AGGREGATES = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum"
+];
+var BINARY_AGGREGATES = ["any", "all"];
+var AGGREGATE_REDUCERS = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum",
+	"any",
+	"all"
+];
+var GroupTemplateIdSchema = z.enum(GROUP_TEMPLATE_IDS);
+var AggregateReducerSchema = z.enum(AGGREGATE_REDUCERS);
+/** One member. The field is stored so occupancy can name motion or binary. */
+var HelperMemberSchema = z.object({
+	source: CompositionSourceRefSchema,
+	cap: z.string().min(1),
+	fieldPath: 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 = z.object({
+	kind: z.literal("group"),
+	templateId: GroupTemplateIdSchema,
+	aggregate: AggregateReducerSchema,
+	members: z.array(HelperMemberSchema).min(1).max(64)
+});
+var HelperSpecSchema = z.discriminatedUnion("kind", [GroupHelperSpecSchema]);
+//#endregion
 //#region src/composition/composition.ts
 /**
 * A COMPOSITION: a device assembled from other devices' state (D659).
@@ -2195,11 +2267,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 = z.object({
-	/** The owning addon; `stableId` is unique only within it. */
-	addonId: z.string().min(1),
-	stableId: z.string().min(1)
-});
 /** One field of one capability of one source device. */
 var CompositionFieldReadSchema = z.object({
 	source: CompositionSourceRefSchema,
@@ -2242,10 +2309,42 @@ var CompositionCodeSourceSchema = z.object({
 	kind: z.literal("code"),
 	code: 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 = z.object({
+	kind: z.literal("aggregate"),
+	reducer: z.enum([
+		"mean",
+		"median",
+		"min",
+		"max",
+		"sum",
+		"any",
+		"all"
+	]),
+	reads: z.array(CompositionFieldReadSchema).min(1).max(64),
+	/** `value` is the reading; the others are the member counts. */
+	publish: z.enum([
+		"value",
+		"included",
+		"excluded",
+		"total"
+	]),
+	/** What a `value` publish does when nobody is included. Counts ignore this. */
+	empty: z.enum([
+		"null",
+		"omit",
+		"offline"
+	])
+});
 var CompositionFieldSourceSchema = z.discriminatedUnion("kind", [
 	CompositionFromSourceSchema,
 	CompositionExpressionSourceSchema,
-	CompositionCodeSourceSchema
+	CompositionCodeSourceSchema,
+	CompositionAggregateSourceSchema
 ]);
 /** `forward`: RESERVED for slice 3. Argument mapping arrives there as an additive optional `args`. */
 var CompositionForwardCommandSchema = z.object({
@@ -2311,7 +2410,13 @@ var CompositionExistingTargetSchema = z.object({
 var CompositionTargetSchema = z.discriminatedUnion("kind", [CompositionNewTargetSchema, CompositionExistingTargetSchema]);
 var CompositionSchema = z.object({
 	target: CompositionTargetSchema,
-	features: z.array(CompositionFeatureSchema).min(1).max(16)
+	features: 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 +2463,7 @@ function fieldReads(source) {
 			cap: binding.cap,
 			fieldPath: binding.fieldPath
 		}] : []);
+		case "aggregate": return source.reads;
 		case "code": return [];
 	}
 }
@@ -2384,4 +2490,4 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
-export { MAX_EXPRESSION_AST_NODES as $, compositionFeatureEnabled as A, Fmp4BoxSplitter as At, createStatefulExpressionMemory as B, pickVideoEncoder as Bt, CompositionTargetSchema as C, FFMPEG_PATH_ENV as Ct, MAX_COMPOSITION_ITEMS as D, getFfmpegArtifact as Dt, MAX_COMPOSITION_FIELDS_PER_FEATURE as E, FFMPEG_RELEASE as Et, featureFieldEntries as F, buildInputArgs as Ft, createExpressionScope as G, evaluateStatefulExpressionCall as H, featureSources as I, buildVideoArgs as It, compileExpressionSafe as J, evaluateAst as K, fieldReads as L, invocationFromEncodeProfile as Lt, compositionReadKey as M, audioPlanFromEncodeProfile as Mt, compositionSliceKey as N, buildAudioArgs as Nt, composedDeviceRef as O, getFfmpegDownloadUrl as Ot, compositionSourceKey as P, buildFfmpegArgs as Pt, EXPRESSION_IDENTIFIER_RE as Q, EXPRESSION_INJECTED_NOW as R, isSoftwareDecode as Rt, CompositionSourceRefSchema as S, sliceChangedAt as St, MAX_COMPOSITION_FEATURES as T, ffmpegBinaryName as Tt, toExpressionValue as U, evaluateExpressionSource as V, resolveStreamMaps as Vt, validateExpressionSource as W, tokenize as X, parseExpression as Y, EXPRESSION_COMPILE_CACHE_CAPACITY as Z, CompositionItemEntrySchema as _, SOURCE_DEVICE_TYPES as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, EXPRESSION_BUILTINS as at, CompositionPassthroughFeatureSchema as b, isSourceCap as bt, CompositionCommandTargetSchema as c, evaluateCount as ct, CompositionFeatureSchema as d, ExpressionEvalError as dt, MAX_EXPRESSION_BINDINGS as et, CompositionFieldReadSchema as f, ExpressionParseError as ft, CompositionFromSourceSchema as g, SOURCE_CAP_CHANGED_AT_FIELD as gt, CompositionForwardCommandSchema as h, SOURCE_CAP_ACTIVE_FIELD as ht, COMPOSITION_ITEM_KEY_RE as i, RESERVED_BINDING_NAMES as it, compositionItemFieldPath as j, AUDIO_PRESETS as jt, composedDeviceStableId as k, canonicalHash as kt, CompositionExistingTargetSchema as l, evaluateRose as lt, CompositionFieldsFeatureSchema as m, SOURCE_CAPS as mt, COMPOSER_ADDON_ID as n, MAX_EXPRESSION_EVAL_STEPS as nt, CompositionBindingSchema as o, EXPRESSION_BUILTIN_NAMES as ot, CompositionFieldSourceSchema as p, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as pt, compileExpression as q, COMPOSITION_ITEM_ARRAY_PATH as r, MAX_EXPRESSION_SOURCE_LENGTH as rt, CompositionCodeSourceSchema as s, disarmRoseMemory as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, MAX_EXPRESSION_CALL_ARGS as tt, CompositionExpressionSourceSchema as u, isStatefulBuiltin as ut, CompositionLiteralBindingSchema as v, evaluateSensorEdge as vt, MAX_COMPOSITION_CODE_LENGTH as w, chooseFfmpegBinary as wt, CompositionSchema as x, sliceActiveValue as xt, CompositionNewTargetSchema as y, evaluateSensorLevelEdge as yt, cloneStatefulExpressionMemory as z, logBannerArgs as zt };
+export { evaluateStatefulExpressionCall as $, compositionFeatureEnabled as A, evaluateSensorLevelEdge as At, BINARY_AGGREGATES as B, canonicalHash as Bt, CompositionTargetSchema as C, ExpressionParseError as Ct, MAX_COMPOSITION_ITEMS as D, SOURCE_CAP_CHANGED_AT_FIELD as Dt, MAX_COMPOSITION_FIELDS_PER_FEATURE as E, SOURCE_CAP_ACTIVE_FIELD as Et, featureFieldEntries as F, chooseFfmpegBinary as Ft, HelperSpecSchema as G, buildFfmpegArgs as Gt, GroupHelperSpecSchema as H, AUDIO_PRESETS as Ht, featureSources as I, ffmpegBinaryName as It, CompositionSourceRefSchema as J, invocationFromEncodeProfile as Jt, MAX_HELPER_MEMBERS as K, buildInputArgs as Kt, fieldReads as L, FFMPEG_RELEASE as Lt, compositionReadKey as M, sliceActiveValue as Mt, compositionSliceKey as N, sliceChangedAt as Nt, composedDeviceRef as O, SOURCE_DEVICE_TYPES as Ot, compositionSourceKey as P, FFMPEG_PATH_ENV as Pt, evaluateExpressionSource as Q, resolveStreamMaps as Qt, AGGREGATE_REDUCERS as R, getFfmpegArtifact as Rt, CompositionSchema as S, ExpressionEvalError as St, MAX_COMPOSITION_FEATURES as T, SOURCE_CAPS as Tt, GroupTemplateIdSchema as U, audioPlanFromEncodeProfile as Ut, GROUP_TEMPLATE_IDS as V, Fmp4BoxSplitter as Vt, HelperMemberSchema as W, buildAudioArgs as Wt, cloneStatefulExpressionMemory as X, logBannerArgs as Xt, EXPRESSION_INJECTED_NOW as Y, isSoftwareDecode as Yt, createStatefulExpressionMemory as Z, pickVideoEncoder as Zt, CompositionFromSourceSchema as _, EXPRESSION_BUILTIN_NAMES as _t, CUSTOMIZATION_BLOCK_NAME_PREFIX as a, compileExpressionSafe as at, CompositionNewTargetSchema as b, evaluateRose as bt, CompositionCodeSourceSchema as c, EXPRESSION_COMPILE_CACHE_CAPACITY as ct, CompositionExpressionSourceSchema as d, MAX_EXPRESSION_BINDINGS as dt, toExpressionValue as et, CompositionFeatureSchema as f, MAX_EXPRESSION_CALL_ARGS as ft, CompositionForwardCommandSchema as g, EXPRESSION_BUILTINS as gt, CompositionFieldsFeatureSchema as h, RESERVED_BINDING_NAMES as ht, COMPOSITION_ITEM_KEY_RE as i, compileExpression as it, compositionItemFieldPath as j, isSourceCap as jt, composedDeviceStableId as k, evaluateSensorEdge as kt, CompositionCommandTargetSchema as l, EXPRESSION_IDENTIFIER_RE as lt, CompositionFieldSourceSchema as m, MAX_EXPRESSION_SOURCE_LENGTH as mt, COMPOSER_ADDON_ID as n, createExpressionScope as nt, CompositionAggregateSourceSchema as o, parseExpression as ot, CompositionFieldReadSchema as p, MAX_EXPRESSION_EVAL_STEPS as pt, NUMERIC_AGGREGATES as q, buildVideoArgs as qt, COMPOSITION_ITEM_ARRAY_PATH as r, evaluateAst as rt, CompositionBindingSchema as s, tokenize as st, COMPOSED_DEVICE_STABLE_ID_PREFIX as t, validateExpressionSource as tt, CompositionExistingTargetSchema as u, MAX_EXPRESSION_AST_NODES as ut, CompositionItemEntrySchema as v, disarmRoseMemory as vt, MAX_COMPOSITION_CODE_LENGTH as w, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as wt, CompositionPassthroughFeatureSchema as x, isStatefulBuiltin as xt, CompositionLiteralBindingSchema as y, evaluateCount as yt, AggregateReducerSchema as z, getFfmpegDownloadUrl as zt };

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

@@ -2160,6 +2160,78 @@ 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"
+];
+var NUMERIC_AGGREGATES = [
+	"mean",
+	"median",
+	"min",
+	"max",
+	"sum"
+];
+var BINARY_AGGREGATES = ["any", "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);
+/** 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)
+});
+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 +2267,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 +2309,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 +2410,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 +2463,7 @@ function fieldReads(source) {
 			cap: binding.cap,
 			fieldPath: binding.fieldPath
 		}] : []);
+		case "aggregate": return source.reads;
 		case "code": return [];
 	}
 }
@@ -2384,12 +2490,30 @@ function featureSources(feature) {
 	return featureFieldEntries(feature).map((e) => e.source);
 }
 //#endregion
+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, "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 +2544,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 +2724,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 +2808,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-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/generated/addon-api.d.ts

@@ -3843,6 +3843,20 @@ export type AppRouter = TrpcCoreRouter<{
             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,7 @@ 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 { 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 +112,7 @@ export type CapStatusTypeMap = {
     readonly 'feature-probe': z.infer<typeof FeatureProbeStatusSchema>;
     readonly 'flood': z.infer<typeof FloodStatusSchema>;
     readonly 'gas': z.infer<typeof GasStatusSchema>;
+    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 +165,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-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,7 @@ 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 { 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 +255,7 @@ export declare const CAPABILITY_NAMES: {
     readonly filesystemBrowse: 'filesystem-browse';
     readonly flood: 'flood';
     readonly gas: 'gas';
+    readonly groupStatus: 'group-status';
     readonly heatingValve: 'heating-valve';
     readonly humidifier: 'humidifier';
     readonly humiditySensor: 'humidity-sensor';
@@ -449,6 +451,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
     readonly filesystemBrowse: TRouter;
     readonly flood: TRouter;
     readonly gas: TRouter;
+    readonly groupStatus: TRouter;
     readonly heatingValve: TRouter;
     readonly humidifier: TRouter;
     readonly humiditySensor: TRouter;
@@ -557,8 +560,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` (147 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-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,7 @@ 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 { 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 +112,7 @@ export interface DeviceLocalState {
     featureProbe: InferRuntimeState<typeof featureProbeCapability>;
     flood: InferRuntimeState<typeof floodCapability>;
     gas: InferRuntimeState<typeof gasCapability>;
+    groupStatus: InferRuntimeState<typeof groupStatusCapability>;
     heatingValve: InferRuntimeState<typeof heatingValveCapability>;
     humidifier: InferRuntimeState<typeof humidifierCapability>;
     humiditySensor: InferRuntimeState<typeof humiditySensorCapability>;
@@ -205,6 +207,7 @@ export interface CapNameToRuntimeStateMap {
     'feature-probe': InferRuntimeState<typeof featureProbeCapability>;
     'flood': InferRuntimeState<typeof floodCapability>;
     'gas': InferRuntimeState<typeof gasCapability>;
+    '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,7 @@ 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 { 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 +146,7 @@ export interface DeviceProxyState {
     readonly featureProbe: SliceHandle<InferRuntimeState<typeof featureProbeCapability>>;
     readonly flood: SliceHandle<InferRuntimeState<typeof floodCapability>>;
     readonly gas: SliceHandle<InferRuntimeState<typeof gasCapability>>;
+    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 +248,7 @@ export interface DeviceProxy {
     readonly featureProbe?: InferDeviceProxyCap<typeof featureProbeCapability>;
     readonly flood?: InferDeviceProxyCap<typeof floodCapability>;
     readonly gas?: InferDeviceProxyCap<typeof gasCapability>;
+    readonly groupStatus?: InferDeviceProxyCap<typeof groupStatusCapability>;
     readonly heatingValve?: InferDeviceProxyCap<typeof heatingValveCapability>;
     readonly humidifier?: InferDeviceProxyCap<typeof humidifierCapability>;
     readonly humiditySensor?: InferDeviceProxyCap<typeof humiditySensorCapability>;

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), 31 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: 1383 method paths across 182 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: 547 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`. 73 caps: 38 `restored`, 35 `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.