@camstack/types 1.2.433 → 1.2.435

package/CHANGELOG.md

@@ -7,11 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.435] - 2026-10-28
+
+### Changed
+
+- Device value fields are named after their quantity (power, level, speed, signal...) instead of their unit; run the quantity-field migration after updating
+
+## [1.2.434] - 2026-10-28
+
+### Added
+
+- Automations can start on a parked object appearing or leaving, filtered by camera, class and zone, and check whether one is present
+
 ## [1.2.433] - 2026-10-28
 
 ### Changed
 
 - Unknown event kinds, state words and class names read as words instead of raw ids
+- Automations can start on, and be conditioned by, a parked object (appeared or departed, with class and zone filters)
 
 ## [1.2.432] - 2026-10-28
 

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-5zRztaHa.js");
-const require_event_category = require("./event-category-BhzwWQCH.js");
+const require_sleep = require("./sleep-DHitF_e4.js");
+const require_event_category = require("./event-category-E17zaHjN.js");
 const require_err_msg = require("./err-msg-U7lLUMNz.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
-import { $ as expandCapMethods, $n as REVALIDATE_AFTER_MS, $r as isSecretMarker, $t as RecordFieldPathSchema, A as HF_REPO, An as RecordUniqueViolationError, Ar as buildSecretRef, B as withoutCallerStamp, Bn as RECORD_CLASSES, C as addonSliceHandleApi, Cn as InvalidRecordError, Dn as RecordNotFoundError, En as RECORDS_ERROR_CODES, Fn as UnknownRecordKindError, Fr as parseSecretRef, G as adminUiCapability, Gn as RECORD_MAX_DATA_BYTES, Hn as RECORD_DEFAULT_MAX_DATA_BYTES, I as deviceOpsCapability, In as asRecordsError, Jn as RECORD_QUERY_MAX, Jt as defineEntryKind, Kn as RECORD_MAX_INDEXES, L as viewerUiCapability, Ln as recordsErrorFromMessage, M as CAP_ADVANCE_FIELDS, Mn as RevConflictError, Mr as globalSecretScope, Nn as TransactRefusedError, Nr as isSecretRef, On as RecordSecretUnavailableError, Or as SECRET_REF_SCHEME, P as CAP_STATE_LEAVES, Pn as UnindexedFilterError, Pr as normalizeSecretOwner, Qn as resolveSecretViewsIn, Qr as isSecretFieldView, Qt as EntryDescriptorSchema, R as DEVICE_CHILDREN_BATCH_MAX, Rn as RECORD_BATCH_MAX, Rr as createEvent, Sn as ForeignSecretMarkerError, Tn as PlaintextSecretError, U as describeCustomActions, Un as RECORD_DELETE_BATCH, Vn as RECORD_DATABASES, Wn as RECORD_ID_MAX_LENGTH, Xn as RECORD_SETTINGS_MAX_ROWS, Xr as classifySecretWrite, Xt as createRecordsAccess, Yn as RECORD_SECRET_COLLECTION_PREFIX, Yr as SECRET_CLEAR, Yt as entryBody, Zn as RECORD_SWEEP_INTERVAL_MS, Zr as isSecretClear, Zt as assertTransactScope, _ as readErrorI18n, _n as collectZodSecretPaths, an as assertValidDeclaration, ar as registerKnownSecret, b as isDeviceScopedCap, bn as DeclarationRefusedError, c as asString, cn as REMOVE_LEAF, cr as PEER_BYTES_CHUNK_BYTES, ct as readNodePin, d as parseJsonUnknown, dn as parseSecretPath, dr as PEER_BYTES_TICKET_TTL_MS, dt as ReadinessRegistry, ei as isSecretMarkerLike, en as RecordIndexSchema, er as createSecretsAccess, f as hfModelUrl, fn as recordArrayItemPath, ft as ReadinessTimeoutError, g as ErrorI18nPayloadSchema, gr as BaseAddon, hn as secretArrayPrefixes, hr as DisposerChain, ht as scopeKey, in as StoredRecordKindDeclarationSchema, ir as knownSecretCount, jn as RecordsError, jr as formatSecretScope, kn as RecordTooLargeError, kr as arrayItemFieldPath, ln as collectSecretLeaves, lr as PEER_BYTES_MAX_OUTSTANDING, mn as recordSecretRef, ni as toSecretFieldView, nn as RecordKindNameSchema, nr as clearKnownSecrets, o as asJsonObject, on as declarationsOf, or as scrubKnownSecrets, p as BOOT_RECOVERY_BACKOFF_MS, pn as recordSecretCollection, pr as DATAPLANE_SECRET_HEADER, qn as RECORD_MAX_INDEX_FIELDS, qt as makeInMemoryRecords, r as maskUrlCredentials, rn as RecordRetentionSchema, rr as forgetKnownSecret, sn as defineRecordKinds, sr as shortSecretRefHash, st as nodePin, t as sleep, ti as makeSecretMarker, tn as RecordKindDeclarationSchema, tr as MIN_SCRUBBED_LENGTH, un as mapSecretLeaves, ur as PEER_BYTES_STALL_MS, ut as MODEL_FORMATS, vn as isZodSecret, vr as normalizeAddonInitResult, w as createEventBusSliceSource, wn as NoCallerError, x as createDeviceProxy, xn as FilterRequiredError, y as DEVICE_SCOPED_CAPS, yn as BatchTooLargeError, z as CALLER_STAMPED_CAPABILITIES, zn as RECORD_BATCH_MAX_BYTES, zr as emitReadiness } from "./sleep-BHjNez61.mjs";
-import { t as EventCategory } from "./event-category-hdMR7CTW.mjs";
+import { $ as expandCapMethods, $n as REVALIDATE_AFTER_MS, $r as isSecretMarker, $t as RecordFieldPathSchema, A as HF_REPO, An as RecordUniqueViolationError, Ar as buildSecretRef, B as withoutCallerStamp, Bn as RECORD_CLASSES, C as addonSliceHandleApi, Cn as InvalidRecordError, Dn as RecordNotFoundError, En as RECORDS_ERROR_CODES, Fn as UnknownRecordKindError, Fr as parseSecretRef, G as adminUiCapability, Gn as RECORD_MAX_DATA_BYTES, Hn as RECORD_DEFAULT_MAX_DATA_BYTES, I as deviceOpsCapability, In as asRecordsError, Jn as RECORD_QUERY_MAX, Jt as defineEntryKind, Kn as RECORD_MAX_INDEXES, L as viewerUiCapability, Ln as recordsErrorFromMessage, M as CAP_ADVANCE_FIELDS, Mn as RevConflictError, Mr as globalSecretScope, Nn as TransactRefusedError, Nr as isSecretRef, On as RecordSecretUnavailableError, Or as SECRET_REF_SCHEME, P as CAP_STATE_LEAVES, Pn as UnindexedFilterError, Pr as normalizeSecretOwner, Qn as resolveSecretViewsIn, Qr as isSecretFieldView, Qt as EntryDescriptorSchema, R as DEVICE_CHILDREN_BATCH_MAX, Rn as RECORD_BATCH_MAX, Rr as createEvent, Sn as ForeignSecretMarkerError, Tn as PlaintextSecretError, U as describeCustomActions, Un as RECORD_DELETE_BATCH, Vn as RECORD_DATABASES, Wn as RECORD_ID_MAX_LENGTH, Xn as RECORD_SETTINGS_MAX_ROWS, Xr as classifySecretWrite, Xt as createRecordsAccess, Yn as RECORD_SECRET_COLLECTION_PREFIX, Yr as SECRET_CLEAR, Yt as entryBody, Zn as RECORD_SWEEP_INTERVAL_MS, Zr as isSecretClear, Zt as assertTransactScope, _ as readErrorI18n, _n as collectZodSecretPaths, an as assertValidDeclaration, ar as registerKnownSecret, b as isDeviceScopedCap, bn as DeclarationRefusedError, c as asString, cn as REMOVE_LEAF, cr as PEER_BYTES_CHUNK_BYTES, ct as readNodePin, d as parseJsonUnknown, dn as parseSecretPath, dr as PEER_BYTES_TICKET_TTL_MS, dt as ReadinessRegistry, ei as isSecretMarkerLike, en as RecordIndexSchema, er as createSecretsAccess, f as hfModelUrl, fn as recordArrayItemPath, ft as ReadinessTimeoutError, g as ErrorI18nPayloadSchema, gr as BaseAddon, hn as secretArrayPrefixes, hr as DisposerChain, ht as scopeKey, in as StoredRecordKindDeclarationSchema, ir as knownSecretCount, jn as RecordsError, jr as formatSecretScope, kn as RecordTooLargeError, kr as arrayItemFieldPath, ln as collectSecretLeaves, lr as PEER_BYTES_MAX_OUTSTANDING, mn as recordSecretRef, ni as toSecretFieldView, nn as RecordKindNameSchema, nr as clearKnownSecrets, o as asJsonObject, on as declarationsOf, or as scrubKnownSecrets, p as BOOT_RECOVERY_BACKOFF_MS, pn as recordSecretCollection, pr as DATAPLANE_SECRET_HEADER, qn as RECORD_MAX_INDEX_FIELDS, qt as makeInMemoryRecords, r as maskUrlCredentials, rn as RecordRetentionSchema, rr as forgetKnownSecret, sn as defineRecordKinds, sr as shortSecretRefHash, st as nodePin, t as sleep, ti as makeSecretMarker, tn as RecordKindDeclarationSchema, tr as MIN_SCRUBBED_LENGTH, un as mapSecretLeaves, ur as PEER_BYTES_STALL_MS, ut as MODEL_FORMATS, vn as isZodSecret, vr as normalizeAddonInitResult, w as createEventBusSliceSource, wn as NoCallerError, x as createDeviceProxy, xn as FilterRequiredError, y as DEVICE_SCOPED_CAPS, yn as BatchTooLargeError, z as CALLER_STAMPED_CAPABILITIES, zn as RECORD_BATCH_MAX_BYTES, zr as emitReadiness } from "./sleep-Crlmu_tO.mjs";
+import { t as EventCategory } from "./event-category-DmZDPDf_.mjs";
 import { a as DeviceType, t as errMsg } from "./err-msg-DIorGYeC.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/automation/index.d.ts

@@ -14,11 +14,13 @@ export type { ConditionEvaluation, ConditionReader, MirrorRefreshFetchers, Mirro
 export { collectMirrorSources, ConditionMirror, evaluateConditionTree, } from './condition-eval.js';
 export type { DetectionDecision, DetectionTrigger, DetectionVars, TrackLifecycleInput, } from './detection-trigger.js';
 export { DetectionTriggerFilter, detectionClassMatches, FIRED_MAX, FIRED_TTL_MS, } from './detection-trigger.js';
+export type { StationaryChangedInput, StationaryDecision, StationaryTrigger, StationaryVars, } from './stationary-trigger.js';
+export { evaluateStationaryTrigger } from './stationary-trigger.js';
 export type { CooldownInput, CooldownVerdict, RunGateAdmission } from './run-gate.js';
 export { RunGate } from './run-gate.js';
 export type { AutomationConditionTraceNode, AutomationRunOutcome, AutomationRunTrace, AutomationRunVerdict, AutomationStateDoc, AutomationStepTrace, AutomationTriggerTrace, TraceNodeOutcome, TraceValue, } from './trace.js';
 export { AutomationConditionTraceNodeSchema, EMPTY_AUTOMATION_STATE, mergeSkipTraces, AutomationRunOutcomeSchema, AutomationRunTraceSchema, AutomationRunVerdictSchema, AutomationStateDocSchema, AutomationStepTraceSchema, AutomationTriggerTraceSchema, appendTrace, buildTriggerTrace, isSkippedTrace, skipSignature, TraceNodeOutcomeSchema, TraceValueSchema, } from './trace.js';
-export type { ActionStep, AutomationAction, AutomationCondition, AutomationConditionAll, AutomationConditionAny, AutomationConditionExpression, AutomationConditionLeaf, AutomationConditionNot, AutomationConditionOperator, AutomationRecipe, AutomationRunMode, AutomationTrigger, } from './recipe.js';
+export type { ActionStep, AutomationAction, AutomationCondition, AutomationConditionAll, AutomationConditionAny, AutomationConditionExpression, AutomationConditionLeaf, AutomationConditionNot, AutomationConditionOperator, AutomationConditionStationaryPresent, AutomationRecipe, AutomationRunMode, AutomationTrigger, } from './recipe.js';
 export { ActionStepSchema, AutomationActionSchema, AutomationCapStepSchema, AutomationWaitStepSchema, AutomationConditionOperatorSchema, AutomationConditionSchema, AutomationRecipeSchema, AutomationRunModeSchema, AutomationTriggerSchema, conditionDepth, countConditionLeaves, DEFAULT_TRACE_KEEP, MAX_TRACE_KEEP, MAX_CONDITION_DEPTH, MAX_CONDITION_LEAVES, validateRecipeBounds, } from './recipe.js';
 export * from './action.js';
 export * from './step-runner.js';

package/dist/automation/recipe.d.ts

@@ -11,10 +11,10 @@
  *
  * Three vocabularies, each salvaged rather than invented:
  *
- *  - **Triggers** — the only genuinely new surface. Six members, none of which
+ *  - **Triggers** — the only genuinely new surface. Seven members, none of which
  *    touches notification delivery. The NC keeps its four *pipeline* triggers;
  *    these are device/time triggers and the two sets do not overlap.
- *  - **Conditions** — `ALL`/`ANY`/`NOT` over two leaf kinds, bounded. The
+ *  - **Conditions** — `ALL`/`ANY`/`NOT` over three leaf kinds, bounded. The
  *    expression leaf is the bounded engine at `../expression/`, which is where
  *    arithmetic between two device fields lives and the only place it lives.
  *  - **Actions** — `NcRuleActionSchema`'s two steps, plus the `{kind:'code'}`
@@ -66,6 +66,18 @@ export interface AutomationConditionExpression {
     readonly expr: string;
     readonly bindings: Readonly<Record<string, ExpressionBindingSource>>;
 }
+/**
+ * True when the camera currently has a PARKED object (stationary registry)
+ * matching `classes` (macro classes match like the detection trigger) in at
+ * least one of `zones`. Reads the zone-analytics snapshot through the same
+ * mirror as every other leaf, so a dropped event never decides it (D49).
+ */
+export interface AutomationConditionStationaryPresent {
+    readonly kind: 'stationary-present';
+    readonly deviceId: number;
+    readonly classes?: readonly string[];
+    readonly zones?: readonly string[];
+}
 export interface AutomationConditionAll {
     readonly kind: 'all';
     readonly children: readonly AutomationCondition[];
@@ -78,7 +90,7 @@ export interface AutomationConditionNot {
     readonly kind: 'not';
     readonly child: AutomationCondition;
 }
-export type AutomationCondition = AutomationConditionAll | AutomationConditionAny | AutomationConditionNot | AutomationConditionLeaf | AutomationConditionExpression;
+export type AutomationCondition = AutomationConditionAll | AutomationConditionAny | AutomationConditionNot | AutomationConditionLeaf | AutomationConditionExpression | AutomationConditionStationaryPresent;
 export declare const AutomationConditionSchema: z.ZodType<AutomationCondition>;
 /**
  * What starts a run.
@@ -114,6 +126,15 @@ export declare const AutomationTriggerSchema: z.ZodDiscriminatedUnion<[z.ZodObje
     deviceIds: z.ZodArray<z.ZodNumber>;
     zones: z.ZodOptional<z.ZodArray<z.ZodString>>;
     minScore: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"stationary">;
+    deviceIds: z.ZodArray<z.ZodNumber>;
+    classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    zones: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    phase: z.ZodEnum<{
+        appeared: "appeared";
+        departed: "departed";
+    }>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"interval">;
     minutes: z.ZodNumber;
@@ -243,6 +264,15 @@ export declare const AutomationRecipeSchema: z.ZodObject<{
         deviceIds: z.ZodArray<z.ZodNumber>;
         zones: z.ZodOptional<z.ZodArray<z.ZodString>>;
         minScore: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"stationary">;
+        deviceIds: z.ZodArray<z.ZodNumber>;
+        classes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        zones: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        phase: z.ZodEnum<{
+            appeared: "appeared";
+            departed: "departed";
+        }>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"interval">;
         minutes: z.ZodNumber;

package/dist/automation/stationary-trigger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The `stationary` trigger's per-event decision: does this parked-object change
+ * start a run, and if not, WHY not.
+ *
+ * Source: `EventCategory.PipelineAnalyticsStationaryChanged` — payload
+ * {@link PipelineAnalyticsStationaryChangedPayload} (`deviceId`, `entryId`,
+ * `className`, `phase` appeared|departed, `zones`). The device is in the DATA.
+ *
+ * Stateless: the registry emits one event per transition, so there is no
+ * once-per-subject set to keep (unlike `detection`, whose track emits many
+ * updates). A change of the OTHER phase is not this trigger's business and is
+ * ignored without a trace. Events are telemetry (D8): a dropped one delays or
+ * misses a fire, and nothing durable depends on it.
+ */
+import type { PipelineAnalyticsStationaryChangedPayload } from '../interfaces/event-bus.js';
+import type { AutomationTrigger } from './recipe.js';
+export type StationaryTrigger = Extract<AutomationTrigger, {
+    kind: 'stationary';
+}>;
+/** The fields of a stationary-changed event the trigger reads (all `unknown`: off the bus). */
+export interface StationaryChangedInput {
+    readonly deviceId?: unknown;
+    readonly entryId?: unknown;
+    readonly className?: unknown;
+    readonly phase?: unknown;
+    readonly zones?: unknown;
+}
+/** What a stationary run exposes to conditions and actions. */
+export interface StationaryVars {
+    readonly deviceId: number;
+    readonly className: string;
+    readonly zones: readonly string[];
+    readonly phase: PipelineAnalyticsStationaryChangedPayload['phase'];
+    readonly entryId: string;
+}
+export type StationaryDecision = {
+    readonly kind: 'ignore';
+    readonly why: string;
+} | {
+    readonly kind: 'reject';
+    readonly reason: string;
+    readonly vars: StationaryVars;
+} | {
+    readonly kind: 'fire';
+    readonly reason: string;
+    readonly vars: StationaryVars;
+};
+export declare function evaluateStationaryTrigger(trigger: StationaryTrigger, event: StationaryChangedInput): StationaryDecision;

package/dist/automation/trace.d.ts

@@ -52,6 +52,7 @@ export declare const AutomationConditionTraceNodeSchema: z.ZodObject<{
         condition: "condition";
         expression: "expression";
         not: "not";
+        "stationary-present": "stationary-present";
     }>;
     outcome: z.ZodEnum<{
         fail: "fail";
@@ -131,6 +132,7 @@ export declare const AutomationRunTraceSchema: z.ZodObject<{
             condition: "condition";
             expression: "expression";
             not: "not";
+            "stationary-present": "stationary-present";
         }>;
         outcome: z.ZodEnum<{
             fail: "fail";
@@ -226,6 +228,7 @@ export declare const AutomationStateDocSchema: z.ZodObject<{
                 condition: "condition";
                 expression: "expression";
                 not: "not";
+                "stationary-present": "stationary-present";
             }>;
             outcome: z.ZodEnum<{
                 fail: "fail";
@@ -319,7 +322,7 @@ export declare function mergeSkipTraces(prev: AutomationRunTrace, next: Automati
 export declare function appendTrace(ring: readonly AutomationRunTrace[], trace: AutomationRunTrace, keep: number): AutomationRunTrace[];
 /**
  * The trigger stage of a trace from the bag a trigger handed to `run()`:
- * primitives only (a device-state `to` that is an object is left out), minus the
+ * primitives and short lists of them (a device-state `to` that is an object is left out), minus the
  * bookkeeping keys `kind` and `at`.
  */
 export declare function buildTriggerTrace(trigger: Readonly<Record<string, unknown>>, outcome: 'pass' | 'fail', reason: string): AutomationTriggerTrace;

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

@@ -157,6 +157,7 @@ export declare const actionsCapability: {
                         condition: "condition";
                         expression: "expression";
                         not: "not";
+                        "stationary-present": "stationary-present";
                     }>;
                     outcome: z.ZodEnum<{
                         fail: "fail";

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

@@ -11,8 +11,8 @@ import { DeviceType } from '../device/device-type.js';
  * 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>;
+    co2: z.ZodOptional<z.ZodNumber>;
+    voc: z.ZodOptional<z.ZodNumber>;
     pm25: z.ZodOptional<z.ZodNumber>;
     pm10: z.ZodOptional<z.ZodNumber>;
     aqi: z.ZodOptional<z.ZodNumber>;
@@ -28,8 +28,8 @@ export declare const airQualitySensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            co2Ppm: z.ZodOptional<z.ZodNumber>;
-            vocPpb: z.ZodOptional<z.ZodNumber>;
+            co2: z.ZodOptional<z.ZodNumber>;
+            voc: z.ZodOptional<z.ZodNumber>;
             pm25: z.ZodOptional<z.ZodNumber>;
             pm10: z.ZodOptional<z.ZodNumber>;
             aqi: z.ZodOptional<z.ZodNumber>;
@@ -38,8 +38,8 @@ export declare const airQualitySensorCapability: {
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        co2Ppm: z.ZodOptional<z.ZodNumber>;
-        vocPpb: z.ZodOptional<z.ZodNumber>;
+        co2: z.ZodOptional<z.ZodNumber>;
+        voc: z.ZodOptional<z.ZodNumber>;
         pm25: z.ZodOptional<z.ZodNumber>;
         pm10: z.ZodOptional<z.ZodNumber>;
         aqi: z.ZodOptional<z.ZodNumber>;
@@ -57,12 +57,12 @@ export declare const airQualitySensorCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly co2Ppm: {
+            readonly co2: {
                 readonly kind: 'gauge';
                 readonly unit: 'ppm';
                 readonly deadband: 5;
             };
-            readonly vocPpb: {
+            readonly voc: {
                 readonly kind: 'gauge';
                 readonly unit: 'ppb';
                 readonly deadband: 5;

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

@@ -6,7 +6,7 @@ import { DeviceType } from '../device/device-type.js';
  * entries with `device_class: illuminance`.
  */
 export declare const AmbientLightSensorStatusSchema: z.ZodObject<{
-    lux: z.ZodNullable<z.ZodNumber>;
+    illuminance: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type AmbientLightSensorStatus = z.infer<typeof AmbientLightSensorStatusSchema>;
@@ -19,13 +19,13 @@ export declare const ambientLightSensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            lux: z.ZodNullable<z.ZodNumber>;
+            illuminance: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        lux: z.ZodNullable<z.ZodNumber>;
+        illuminance: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
@@ -40,7 +40,7 @@ export declare const ambientLightSensorCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly lux: {
+            readonly illuminance: {
                 readonly kind: 'gauge';
                 readonly unit: 'lx';
                 readonly deadbandPct: 10;

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

@@ -9,7 +9,7 @@ import { DeviceType } from '../device/device-type.js';
  * threshold.
  */
 export declare const BatteryStatusSchema: z.ZodObject<{
-    percentage: z.ZodNullable<z.ZodNumber>;
+    level: z.ZodNullable<z.ZodNumber>;
     charging: z.ZodEnum<{
         dc: "dc";
         none: "none";
@@ -18,7 +18,7 @@ export declare const BatteryStatusSchema: z.ZodObject<{
     }>;
     sleeping: z.ZodBoolean;
     lastUpdated: z.ZodNumber;
-    volts: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    voltage: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     lastContactAt: z.ZodOptional<z.ZodNumber>;
     lastFullRefreshAt: z.ZodOptional<z.ZodNumber>;
     binary: z.ZodOptional<z.ZodBoolean>;
@@ -81,7 +81,7 @@ export declare const batteryCapability: {
             readonly data: z.ZodObject<{
                 deviceId: z.ZodNumber;
                 status: z.ZodObject<{
-                    percentage: z.ZodNullable<z.ZodNumber>;
+                    level: z.ZodNullable<z.ZodNumber>;
                     charging: z.ZodEnum<{
                         dc: "dc";
                         none: "none";
@@ -90,7 +90,7 @@ export declare const batteryCapability: {
                     }>;
                     sleeping: z.ZodBoolean;
                     lastUpdated: z.ZodNumber;
-                    volts: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    voltage: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
                     lastContactAt: z.ZodOptional<z.ZodNumber>;
                     lastFullRefreshAt: z.ZodOptional<z.ZodNumber>;
                     binary: z.ZodOptional<z.ZodBoolean>;
@@ -100,7 +100,7 @@ export declare const batteryCapability: {
     };
     readonly status: {
         readonly schema: z.ZodObject<{
-            percentage: z.ZodNullable<z.ZodNumber>;
+            level: z.ZodNullable<z.ZodNumber>;
             charging: z.ZodEnum<{
                 dc: "dc";
                 none: "none";
@@ -109,14 +109,14 @@ export declare const batteryCapability: {
             }>;
             sleeping: z.ZodBoolean;
             lastUpdated: z.ZodNumber;
-            volts: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            voltage: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
             lastContactAt: z.ZodOptional<z.ZodNumber>;
             lastFullRefreshAt: z.ZodOptional<z.ZodNumber>;
             binary: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
         readonly kind: 'push';
         readonly empty: {
-            readonly percentage: null;
+            readonly level: null;
             readonly charging: 'unknown';
             readonly sleeping: false;
             readonly lastUpdated: 0;
@@ -132,7 +132,7 @@ export declare const batteryCapability: {
      * the underlying driver.
      */
     readonly runtimeState: z.ZodObject<{
-        percentage: z.ZodNullable<z.ZodNumber>;
+        level: z.ZodNullable<z.ZodNumber>;
         charging: z.ZodEnum<{
             dc: "dc";
             none: "none";
@@ -141,7 +141,7 @@ export declare const batteryCapability: {
         }>;
         sleeping: z.ZodBoolean;
         lastUpdated: z.ZodNumber;
-        volts: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        voltage: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         lastContactAt: z.ZodOptional<z.ZodNumber>;
         lastFullRefreshAt: z.ZodOptional<z.ZodNumber>;
         binary: z.ZodOptional<z.ZodBoolean>;
@@ -158,11 +158,11 @@ export declare const batteryCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly percentage: {
+            readonly level: {
                 readonly kind: 'gauge';
                 readonly unit: '%';
             };
-            readonly volts: {
+            readonly voltage: {
                 readonly kind: 'gauge';
                 readonly unit: 'V';
             };
@@ -171,15 +171,15 @@ export declare const batteryCapability: {
     readonly customize: {
         readonly version: 1;
         readonly targets: readonly [{
-            readonly id: 'percentage';
+            readonly id: 'level';
             readonly cardinality: 'scalar';
             readonly vocabulary: {
                 readonly cap: 'battery';
-                readonly stateField: 'percentage';
+                readonly stateField: 'level';
             };
             readonly deviceTypes: readonly [DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.EventEmitter];
             readonly apply: 'add';
-            readonly path: 'percentage';
+            readonly path: 'level';
             readonly sources: readonly [{
                 readonly kind: 'field';
                 readonly valueKinds: readonly ["number", "string"];

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

@@ -8,13 +8,13 @@ import { DeviceType } from '../device/device-type.js';
  * controls to this single-method surface.
  *
  * The cap is intentionally minimal: a single `setBrightness({deviceId,
- * percentage})` mutation plus the auto-injected `getStatus`. Drivers
+ * level})` mutation plus the auto-injected `getStatus`. Drivers
  * that expose richer controls (color temperature, scenes, schedules)
  * should surface those via the device's `getSettingsUISchema()`
  * instead of bloating this cap.
  */
 export declare const BrightnessStatusSchema: z.ZodObject<{
-    percentage: z.ZodNumber;
+    level: z.ZodNumber;
     lastChangedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type BrightnessStatus = z.infer<typeof BrightnessStatusSchema>;
@@ -27,7 +27,7 @@ export declare const brightnessCapability: {
     readonly methods: {
         readonly setBrightness: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-            percentage: z.ZodNumber;
+            level: z.ZodNumber;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
     readonly events: {
@@ -39,14 +39,14 @@ export declare const brightnessCapability: {
         readonly onBrightnessChanged: {
             readonly data: z.ZodObject<{
                 deviceId: z.ZodNumber;
-                percentage: z.ZodNumber;
+                level: z.ZodNumber;
                 lastChangedAt: z.ZodNumber;
             }, z.core.$strip>;
         };
     };
     readonly status: {
         readonly schema: z.ZodObject<{
-            percentage: z.ZodNumber;
+            level: z.ZodNumber;
             lastChangedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'command-driven';
@@ -57,7 +57,7 @@ export declare const brightnessCapability: {
      * sliders surface the current level without polling the provider.
      */
     readonly runtimeState: z.ZodObject<{
-        percentage: z.ZodNumber;
+        level: z.ZodNumber;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
@@ -72,7 +72,7 @@ export declare const brightnessCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly percentage: {
+            readonly level: {
                 readonly kind: 'gauge';
                 readonly unit: '%';
                 readonly minIntervalMs: 0;

package/dist/capabilities/capability-definition.d.ts

@@ -406,7 +406,7 @@ export declare const HISTORY_UNIT_LABELS: Readonly<Record<HistoryUnit, string>>;
 export interface CapabilityHistoryField {
     /**
      * `gauge` — a level, averaged in a rollup. `counter` — a MONOTONIC hardware
-     * meter only (`kwhTotal`); a drop is a reset, never a negative reading. A
+     * meter only (`energy`); a drop is a reset, never a negative reading. A
      * counter that restarts with the addon (`pressCountSinceStart`) is not one.
      * `boolean` — stored 0/1; a rollup gives the fraction of time true.
      * `enum` — a STATE (a `z.enum`, or a `z.string` whose values are learned):
@@ -444,7 +444,7 @@ export interface CapabilityHistoryField {
     readonly deadband?: number;
     /**
      * Drop a change smaller than this percentage of the last recorded value
-     * (RELATIVE) — for a wide-range gauge such as lux. Applied together with
+     * (RELATIVE) — for a wide-range gauge such as illuminance. Applied together with
      * {@link deadband} when both are set: a change must clear both.
      */
     readonly deadbandPct?: number;
@@ -608,7 +608,7 @@ export interface CapabilityDefinition<TName extends string = string, TMethods ex
      * redeclare it, they just write through `this.runtimeState
      * .setCapState('<capName>', value)`. Examples:
      *
-     *   - `batteryCapability.runtimeState`: `{ percentage, charging,
+     *   - `batteryCapability.runtimeState`: `{ level, charging,
      *     sleeping, lastUpdated }`. A Reolink Argus, a sensor proxy,
      *     an ONVIF battery cam — every provider stores the
      *     same shape under `state.battery`.

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

@@ -51,7 +51,7 @@ declare const ColorInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     mode: z.ZodLiteral<"mired">;
-    mireds: z.ZodNumber;
+    colorTemperature: z.ZodNumber;
 }, z.core.$strip>], "mode">;
 export declare const ColorStatusSchema: z.ZodObject<{
     mode: z.ZodEnum<{
@@ -69,7 +69,7 @@ export declare const ColorStatusSchema: z.ZodObject<{
         s: z.ZodNumber;
         v: z.ZodNumber;
     }, z.core.$strip>>;
-    mireds: z.ZodOptional<z.ZodNumber>;
+    colorTemperature: z.ZodOptional<z.ZodNumber>;
     lastChangedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type ColorStatus = z.infer<typeof ColorStatusSchema>;
@@ -102,7 +102,7 @@ export declare const colorCapability: {
                 }, z.core.$strip>;
             }, z.core.$strip>, z.ZodObject<{
                 mode: z.ZodLiteral<"mired">;
-                mireds: z.ZodNumber;
+                colorTemperature: z.ZodNumber;
             }, z.core.$strip>], "mode">;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
@@ -130,7 +130,7 @@ export declare const colorCapability: {
                     s: z.ZodNumber;
                     v: z.ZodNumber;
                 }, z.core.$strip>>;
-                mireds: z.ZodOptional<z.ZodNumber>;
+                colorTemperature: z.ZodOptional<z.ZodNumber>;
                 lastChangedAt: z.ZodNumber;
             }, z.core.$strip>;
         };
@@ -152,7 +152,7 @@ export declare const colorCapability: {
                 s: z.ZodNumber;
                 v: z.ZodNumber;
             }, z.core.$strip>>;
-            mireds: z.ZodOptional<z.ZodNumber>;
+            colorTemperature: z.ZodOptional<z.ZodNumber>;
             lastChangedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'command-driven';
@@ -178,7 +178,7 @@ export declare const colorCapability: {
             s: z.ZodNumber;
             v: z.ZodNumber;
         }, z.core.$strip>>;
-        mireds: z.ZodOptional<z.ZodNumber>;
+        colorTemperature: z.ZodOptional<z.ZodNumber>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**