@camstack/types 1.2.434 → 1.2.436

package/dist/capabilities/media-player.cap.d.ts

@@ -58,8 +58,8 @@ export declare const MediaPlayerStatusSchema: z.ZodObject<{
         album: z.ZodOptional<z.ZodString>;
         imageUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
-    positionMs: z.ZodNullable<z.ZodNumber>;
-    durationMs: z.ZodNullable<z.ZodNumber>;
+    position: z.ZodNullable<z.ZodNumber>;
+    duration: z.ZodNullable<z.ZodNumber>;
     shuffle: z.ZodNullable<z.ZodBoolean>;
     repeat: z.ZodNullable<z.ZodEnum<{
         all: "all";
@@ -93,7 +93,7 @@ export declare const mediaPlayerCapability: {
         }, z.core.$strip>, z.ZodVoid, "mutation">;
         readonly seek: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
-            positionMs: z.ZodNumber;
+            position: z.ZodNumber;
         }, z.core.$strip>, z.ZodVoid, "mutation">;
         readonly setVolume: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
@@ -147,8 +147,8 @@ export declare const mediaPlayerCapability: {
                 album: z.ZodOptional<z.ZodString>;
                 imageUrl: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
-            positionMs: z.ZodNullable<z.ZodNumber>;
-            durationMs: z.ZodNullable<z.ZodNumber>;
+            position: z.ZodNullable<z.ZodNumber>;
+            duration: z.ZodNullable<z.ZodNumber>;
             shuffle: z.ZodNullable<z.ZodBoolean>;
             repeat: z.ZodNullable<z.ZodEnum<{
                 all: "all";
@@ -185,8 +185,8 @@ export declare const mediaPlayerCapability: {
             album: z.ZodOptional<z.ZodString>;
             imageUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
-        positionMs: z.ZodNullable<z.ZodNumber>;
-        durationMs: z.ZodNullable<z.ZodNumber>;
+        position: z.ZodNullable<z.ZodNumber>;
+        duration: z.ZodNullable<z.ZodNumber>;
         shuffle: z.ZodNullable<z.ZodBoolean>;
         repeat: z.ZodNullable<z.ZodEnum<{
             all: "all";
@@ -205,7 +205,7 @@ export declare const mediaPlayerCapability: {
     /**
      * History (D850): volume (a level an operator or an automation sets; the
      * default 10 s floor folds a slider drag into its end value) and mute.
-     * `positionMs` is not recorded: it moves continuously while playing.
+     * `position` is not recorded: it moves continuously while playing.
      */
     readonly history: {
         readonly fields: {

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
 import { DeviceType } from '../device/device-type.js';
 /**
- * A monotonic total between resets (D944). Energy uses `power-meter.kwhTotal`
+ * A monotonic total between resets (D944). Energy uses `power-meter.energy`
  * so dashboards keep one series; every other instantaneous reading lands here.
  * `value` is the time integral in the source quantity's accumulated base
  * (base-unit seconds, or kWh on the power meter). `null` is a gap, never zero.

package/dist/capabilities/network-link.cap.d.ts

@@ -30,8 +30,8 @@ export declare const NetworkLinkStatusSchema: z.ZodObject<{
         unknown: "unknown";
         wifi: "wifi";
     }>;
-    signalPercent: z.ZodNullable<z.ZodNumber>;
-    rssiDbm: z.ZodOptional<z.ZodNumber>;
+    signal: z.ZodNullable<z.ZodNumber>;
+    rssi: z.ZodOptional<z.ZodNumber>;
     ssid: z.ZodOptional<z.ZodString>;
     lastUpdated: z.ZodNumber;
 }, z.core.$strip>;
@@ -48,7 +48,7 @@ export declare function signalPercentFromBars(bars: number | undefined, maxBars:
  * below is 0 %, -50 dBm and above is 100 %, linear between. Non-finite or
  * positive input is not an RSSI: `null`.
  */
-export declare function signalPercentFromRssi(rssiDbm: number | undefined): number | null;
+export declare function signalPercentFromRssi(rssi: number | undefined): number | null;
 export declare const networkLinkCapability: {
     readonly name: 'network-link';
     readonly scope: 'device';
@@ -72,8 +72,8 @@ export declare const networkLinkCapability: {
                         unknown: "unknown";
                         wifi: "wifi";
                     }>;
-                    signalPercent: z.ZodNullable<z.ZodNumber>;
-                    rssiDbm: z.ZodOptional<z.ZodNumber>;
+                    signal: z.ZodNullable<z.ZodNumber>;
+                    rssi: z.ZodOptional<z.ZodNumber>;
                     ssid: z.ZodOptional<z.ZodString>;
                     lastUpdated: z.ZodNumber;
                 }, z.core.$strip>;
@@ -88,16 +88,16 @@ export declare const networkLinkCapability: {
                 unknown: "unknown";
                 wifi: "wifi";
             }>;
-            signalPercent: z.ZodNullable<z.ZodNumber>;
-            rssiDbm: z.ZodOptional<z.ZodNumber>;
+            signal: z.ZodNullable<z.ZodNumber>;
+            rssi: z.ZodOptional<z.ZodNumber>;
             ssid: z.ZodOptional<z.ZodString>;
             lastUpdated: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
         readonly empty: {
             type: "cellular" | "ethernet" | "unknown" | "wifi";
-            signalPercent: number | null;
-            rssiDbm?: number | undefined;
+            signal: number | null;
+            rssi?: number | undefined;
             ssid?: string | undefined;
             lastUpdated: number;
         };
@@ -114,8 +114,8 @@ export declare const networkLinkCapability: {
             unknown: "unknown";
             wifi: "wifi";
         }>;
-        signalPercent: z.ZodNullable<z.ZodNumber>;
-        rssiDbm: z.ZodOptional<z.ZodNumber>;
+        signal: z.ZodNullable<z.ZodNumber>;
+        rssi: z.ZodOptional<z.ZodNumber>;
         ssid: z.ZodOptional<z.ZodString>;
         lastUpdated: z.ZodNumber;
     }, z.core.$strip>;
@@ -133,13 +133,13 @@ export declare const networkLinkCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly signalPercent: {
+            readonly signal: {
                 readonly kind: 'gauge';
                 readonly unit: '%';
                 readonly deadband: 3;
                 readonly minIntervalMs: 60000;
             };
-            readonly rssiDbm: {
+            readonly rssi: {
                 readonly kind: 'gauge';
                 readonly unit: 'dBm';
                 readonly deadband: 2;

package/dist/capabilities/notification-output.cap.d.ts

@@ -157,6 +157,37 @@ export declare const NotificationActionSchema: z.ZodObject<{
     }>>;
 }, z.core.$strip>;
 export type NotificationAction = z.infer<typeof NotificationActionSchema>;
+/** A delivery parameter value: what a notifier declared it takes. */
+export declare const DeliveryParamValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+export type DeliveryParamValue = z.infer<typeof DeliveryParamValueSchema>;
+/**
+ * One extra delivery parameter a notifier KIND declares (D938). A rule that
+ * addresses a target of that kind may set it; a kind that declares nothing is
+ * never handed one. The admin UI derives its control from this descriptor —
+ * no editor knows a service by name.
+ *
+ * Optional fields are `.optional()`, never `.default()` (a Zod default does not
+ * run on the addon cap path).
+ */
+export declare const DeliveryParamSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+    labelKey: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        boolean: "boolean";
+        enum: "enum";
+        number: "number";
+        string: "string";
+    }>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    min: z.ZodOptional<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+}, z.core.$strip>;
+export type DeliveryParam = z.infer<typeof DeliveryParamSchema>;
 /**
  * The canonical notification. `body` is the only hard field (Apprise model).
  * `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
@@ -225,6 +256,7 @@ export declare const NotificationSchema: z.ZodObject<{
     deviceId: z.ZodOptional<z.ZodNumber>;
     eventId: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    delivery: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
 }, z.core.$strip>;
 /** One declared native severity/priority level for a kind. */
 export declare const TargetKindLevelSchema: z.ZodObject<{
@@ -310,6 +342,24 @@ export declare const TargetKindSchema: z.ZodObject<{
     configSchema: z.ZodUnknown;
     destinationKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
     supportsDiscovery: z.ZodBoolean;
+    deliveryParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        labelKey: z.ZodOptional<z.ZodString>;
+        type: z.ZodEnum<{
+            boolean: "boolean";
+            enum: "enum";
+            number: "number";
+            string: "string";
+        }>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+    }, z.core.$strip>>>;
     caps: z.ZodObject<{
         attachments: z.ZodObject<{
             mediaTypes: z.ZodArray<z.ZodEnum<{
@@ -453,6 +503,24 @@ export declare const notificationOutputCapability: {
             configSchema: z.ZodUnknown;
             destinationKeys: z.ZodOptional<z.ZodArray<z.ZodString>>;
             supportsDiscovery: z.ZodBoolean;
+            deliveryParams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                label: z.ZodString;
+                labelKey: z.ZodOptional<z.ZodString>;
+                type: z.ZodEnum<{
+                    boolean: "boolean";
+                    enum: "enum";
+                    number: "number";
+                    string: "string";
+                }>;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strip>>>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                default: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
+            }, z.core.$strip>>>;
             caps: z.ZodObject<{
                 attachments: z.ZodObject<{
                     mediaTypes: z.ZodArray<z.ZodEnum<{
@@ -601,6 +669,7 @@ export declare const notificationOutputCapability: {
                 deviceId: z.ZodOptional<z.ZodNumber>;
                 eventId: z.ZodOptional<z.ZodString>;
                 metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                delivery: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
             }, z.core.$strip>;
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodBoolean;
@@ -680,6 +749,7 @@ export declare const notificationOutputCapability: {
                 deviceId: z.ZodOptional<z.ZodNumber>;
                 eventId: z.ZodOptional<z.ZodString>;
                 metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                delivery: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>, z.ZodObject<{
             success: z.ZodBoolean;

package/dist/capabilities/power-meter.cap.d.ts

@@ -17,11 +17,11 @@ import { DeviceType } from '../device/device-type.js';
  * in real-world devices.
  */
 export declare const PowerMeterStatusSchema: z.ZodObject<{
-    watts: z.ZodOptional<z.ZodNumber>;
-    kwhTotal: z.ZodOptional<z.ZodNumber>;
-    volts: z.ZodOptional<z.ZodNumber>;
-    amps: z.ZodOptional<z.ZodNumber>;
-    va: z.ZodOptional<z.ZodNumber>;
+    power: z.ZodOptional<z.ZodNumber>;
+    energy: z.ZodOptional<z.ZodNumber>;
+    voltage: z.ZodOptional<z.ZodNumber>;
+    current: z.ZodOptional<z.ZodNumber>;
+    apparentPower: z.ZodOptional<z.ZodNumber>;
     powerFactor: z.ZodOptional<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
@@ -35,62 +35,62 @@ export declare const powerMeterCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            watts: z.ZodOptional<z.ZodNumber>;
-            kwhTotal: z.ZodOptional<z.ZodNumber>;
-            volts: z.ZodOptional<z.ZodNumber>;
-            amps: z.ZodOptional<z.ZodNumber>;
-            va: z.ZodOptional<z.ZodNumber>;
+            power: z.ZodOptional<z.ZodNumber>;
+            energy: z.ZodOptional<z.ZodNumber>;
+            voltage: z.ZodOptional<z.ZodNumber>;
+            current: z.ZodOptional<z.ZodNumber>;
+            apparentPower: z.ZodOptional<z.ZodNumber>;
             powerFactor: z.ZodOptional<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        watts: z.ZodOptional<z.ZodNumber>;
-        kwhTotal: z.ZodOptional<z.ZodNumber>;
-        volts: z.ZodOptional<z.ZodNumber>;
-        amps: z.ZodOptional<z.ZodNumber>;
-        va: z.ZodOptional<z.ZodNumber>;
+        power: z.ZodOptional<z.ZodNumber>;
+        energy: z.ZodOptional<z.ZodNumber>;
+        voltage: z.ZodOptional<z.ZodNumber>;
+        current: z.ZodOptional<z.ZodNumber>;
+        apparentPower: z.ZodOptional<z.ZodNumber>;
         powerFactor: z.ZodOptional<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
-     * Runtime-state durability: **restored** — as `numeric-sensor`; `kwhTotal` is an accumulator whose restored value is the baseline.
+     * Runtime-state durability: **restored** — as `numeric-sensor`; `energy` is an accumulator whose restored value is the baseline.
      *
      * See `RuntimeStateDurability`. Enforced by
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
     /**
-     * History (D850): recorded series. Gauges are floored at 30 s; `kwhTotal` is the one monotonic meter (counter).
+     * History (D850): recorded series. Gauges are floored at 30 s; `energy` is the one monotonic meter (counter).
      */
     readonly history: {
         readonly fields: {
-            readonly watts: {
+            readonly power: {
                 readonly kind: 'gauge';
                 readonly unit: 'W';
                 readonly deadband: 1;
                 readonly minIntervalMs: 30000;
             };
-            readonly kwhTotal: {
+            readonly energy: {
                 readonly kind: 'counter';
                 readonly unit: 'kWh';
                 readonly deadband: 0.01;
                 readonly minIntervalMs: 60000;
             };
-            readonly volts: {
+            readonly voltage: {
                 readonly kind: 'gauge';
                 readonly unit: 'V';
                 readonly deadband: 1;
                 readonly minIntervalMs: 30000;
             };
-            readonly amps: {
+            readonly current: {
                 readonly kind: 'gauge';
                 readonly unit: 'A';
                 readonly deadband: 0.05;
                 readonly minIntervalMs: 30000;
             };
-            readonly va: {
+            readonly apparentPower: {
                 readonly kind: 'gauge';
                 readonly unit: 'VA';
                 readonly deadband: 1;

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

@@ -31,7 +31,6 @@ export declare const PresenceStatusSchema: z.ZodObject<{
         longitude: z.ZodNumber;
         accuracyMeters: z.ZodNumber;
     }, z.core.$strip>>;
-    batteryPercent: z.ZodNullable<z.ZodNumber>;
     lastChangedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type PresenceStatus = z.infer<typeof PresenceStatusSchema>;
@@ -51,7 +50,6 @@ export declare const presenceCapability: {
                 longitude: z.ZodNumber;
                 accuracyMeters: z.ZodNumber;
             }, z.core.$strip>>;
-            batteryPercent: z.ZodNullable<z.ZodNumber>;
             lastChangedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
@@ -70,7 +68,6 @@ export declare const presenceCapability: {
             longitude: z.ZodNumber;
             accuracyMeters: z.ZodNumber;
         }, z.core.$strip>>;
-        batteryPercent: z.ZodNullable<z.ZodNumber>;
         lastChangedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
@@ -80,18 +77,7 @@ export declare const presenceCapability: {
      * `scripts/check-runtime-state-durability.ts`.
      */
     readonly durability: 'restored';
-    /**
-     * History (D850): recorded series.
-     */
-    readonly history: {
-        readonly fields: {
-            readonly batteryPercent: {
-                readonly kind: 'gauge';
-                readonly unit: '%';
-                readonly deadband: 1;
-            };
-        };
-    };
+    readonly history: 'none';
     /** Clock fields: written, but excluded from the compare that decides
      *  whether persisting is worth a SQLite commit. */
     readonly volatileStateFields: readonly ["lastChangedAt"];

package/dist/capabilities/pressure-sensor.cap.d.ts

@@ -10,7 +10,7 @@ import { DeviceType } from '../device/device-type.js';
  * `sourceInfo`.
  */
 export declare const PressureSensorStatusSchema: z.ZodObject<{
-    hpa: z.ZodNullable<z.ZodNumber>;
+    pressure: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type PressureSensorStatus = z.infer<typeof PressureSensorStatusSchema>;
@@ -23,13 +23,13 @@ export declare const pressureSensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            hpa: z.ZodNullable<z.ZodNumber>;
+            pressure: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        hpa: z.ZodNullable<z.ZodNumber>;
+        pressure: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
@@ -44,7 +44,7 @@ export declare const pressureSensorCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly hpa: {
+            readonly pressure: {
                 readonly kind: 'gauge';
                 readonly unit: 'hPa';
                 readonly deadband: 0.1;

package/dist/capabilities/temperature-sensor.cap.d.ts

@@ -14,7 +14,7 @@ import { DeviceType } from '../device/device-type.js';
  * changed" steady state.
  */
 export declare const TemperatureSensorStatusSchema: z.ZodObject<{
-    celsius: z.ZodNullable<z.ZodNumber>;
+    temperature: z.ZodNullable<z.ZodNumber>;
     lastFetchedAt: z.ZodNumber;
 }, z.core.$strip>;
 export type TemperatureSensorStatus = z.infer<typeof TemperatureSensorStatusSchema>;
@@ -27,13 +27,13 @@ export declare const temperatureSensorCapability: {
     readonly methods: {};
     readonly status: {
         readonly schema: z.ZodObject<{
-            celsius: z.ZodNullable<z.ZodNumber>;
+            temperature: z.ZodNullable<z.ZodNumber>;
             lastFetchedAt: z.ZodNumber;
         }, z.core.$strip>;
         readonly kind: 'push';
     };
     readonly runtimeState: z.ZodObject<{
-        celsius: z.ZodNullable<z.ZodNumber>;
+        temperature: z.ZodNullable<z.ZodNumber>;
         lastFetchedAt: z.ZodNumber;
     }, z.core.$strip>;
     /**
@@ -48,7 +48,7 @@ export declare const temperatureSensorCapability: {
      */
     readonly history: {
         readonly fields: {
-            readonly celsius: {
+            readonly temperature: {
                 readonly kind: 'gauge';
                 readonly unit: '°C';
                 readonly deadband: 0.1;

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

@@ -44,7 +44,7 @@ export declare const VacuumControlStatusSchema: z.ZodObject<{
     batteryLevel: z.ZodNullable<z.ZodNumber>;
     fanSpeed: z.ZodNullable<z.ZodString>;
     availableFanSpeeds: z.ZodArray<z.ZodString>;
-    progressPercent: z.ZodNullable<z.ZodNumber>;
+    progress: z.ZodNullable<z.ZodNumber>;
     errorCode: z.ZodNullable<z.ZodNumber>;
     errorLabel: z.ZodNullable<z.ZodString>;
     lastChangedAt: z.ZodNumber;
@@ -91,7 +91,7 @@ export declare const vacuumControlCapability: {
             batteryLevel: z.ZodNullable<z.ZodNumber>;
             fanSpeed: z.ZodNullable<z.ZodString>;
             availableFanSpeeds: z.ZodArray<z.ZodString>;
-            progressPercent: z.ZodNullable<z.ZodNumber>;
+            progress: z.ZodNullable<z.ZodNumber>;
             errorCode: z.ZodNullable<z.ZodNumber>;
             errorLabel: z.ZodNullable<z.ZodString>;
             lastChangedAt: z.ZodNumber;
@@ -115,7 +115,7 @@ export declare const vacuumControlCapability: {
         batteryLevel: z.ZodNullable<z.ZodNumber>;
         fanSpeed: z.ZodNullable<z.ZodString>;
         availableFanSpeeds: z.ZodArray<z.ZodString>;
-        progressPercent: z.ZodNullable<z.ZodNumber>;
+        progress: z.ZodNullable<z.ZodNumber>;
         errorCode: z.ZodNullable<z.ZodNumber>;
         errorLabel: z.ZodNullable<z.ZodString>;
         lastChangedAt: z.ZodNumber;

package/dist/client.js

@@ -21321,6 +21321,43 @@ var NotificationActionSchema = zod.z.object({
 	*/
 	mode: zod.z.enum(["navigate", "background"]).optional()
 });
+/** A delivery parameter value: what a notifier declared it takes. */
+var DeliveryParamValueSchema = zod.z.union([
+	zod.z.string(),
+	zod.z.number(),
+	zod.z.boolean()
+]);
+/**
+* One extra delivery parameter a notifier KIND declares (D938). A rule that
+* addresses a target of that kind may set it; a kind that declares nothing is
+* never handed one. The admin UI derives its control from this descriptor —
+* no editor knows a service by name.
+*
+* Optional fields are `.optional()`, never `.default()` (a Zod default does not
+* run on the addon cap path).
+*/
+var DeliveryParamSchema = zod.z.object({
+	key: zod.z.string().min(1),
+	label: zod.z.string(),
+	/** i18n key of the label, resolved by the declaring addon's namespace. */
+	labelKey: zod.z.string().optional(),
+	type: zod.z.enum([
+		"enum",
+		"number",
+		"boolean",
+		"string"
+	]),
+	/** `enum` only: the closed set of accepted values. */
+	options: zod.z.array(zod.z.object({
+		value: zod.z.string(),
+		label: zod.z.string()
+	})).optional(),
+	/** `number` only. */
+	min: zod.z.number().optional(),
+	max: zod.z.number().optional(),
+	/** What the notifier does when the rule sets nothing; shown as the placeholder. */
+	default: DeliveryParamValueSchema.optional()
+});
 /**
 * The canonical notification. `body` is the only hard field (Apprise model).
 * `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
@@ -21343,7 +21380,13 @@ var NotificationSchema = zod.z.object({
 	tag: zod.z.string().optional(),
 	deviceId: zod.z.number().optional(),
 	eventId: zod.z.string().optional(),
-	metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	/**
+	* Values for the parameters the target's kind DECLARES in
+	* {@link TargetKindSchema} `deliveryParams`. Already validated against the
+	* declaration by the sender; a notifier reads only the keys it declared.
+	*/
+	delivery: zod.z.record(zod.z.string(), DeliveryParamValueSchema).optional()
 });
 /** One declared native severity/priority level for a kind. */
 var TargetKindLevelSchema = zod.z.object({
@@ -21451,6 +21494,11 @@ var TargetKindSchema = zod.z.object({
 	*/
 	destinationKeys: zod.z.array(zod.z.string()).optional(),
 	supportsDiscovery: zod.z.boolean(),
+	/**
+	* Extra delivery parameters a rule may set for a target of this kind (D938).
+	* Absent = none; the rule editor then offers nothing.
+	*/
+	deliveryParams: zod.z.array(DeliveryParamSchema).optional(),
 	caps: TargetKindCapsSchema
 });
 /**
@@ -26538,7 +26586,7 @@ function createMirrorSource(mirror, listeners, api) {
 *
 *   const dev = createDeviceProxy(api, binding)
 *   dev.state.battery.value           // BatteryStatus | undefined
-*   dev.state.battery.value?.percentage
+*   dev.state.battery.value?.level
 *
 * Two-arg form (deprecated path, kept for spec compatibility):
 * passes the api directly, builds a per-handle lazy source. New

package/dist/client.mjs

@@ -21320,6 +21320,43 @@ var NotificationActionSchema = z.object({
 	*/
 	mode: z.enum(["navigate", "background"]).optional()
 });
+/** A delivery parameter value: what a notifier declared it takes. */
+var DeliveryParamValueSchema = z.union([
+	z.string(),
+	z.number(),
+	z.boolean()
+]);
+/**
+* One extra delivery parameter a notifier KIND declares (D938). A rule that
+* addresses a target of that kind may set it; a kind that declares nothing is
+* never handed one. The admin UI derives its control from this descriptor —
+* no editor knows a service by name.
+*
+* Optional fields are `.optional()`, never `.default()` (a Zod default does not
+* run on the addon cap path).
+*/
+var DeliveryParamSchema = z.object({
+	key: z.string().min(1),
+	label: z.string(),
+	/** i18n key of the label, resolved by the declaring addon's namespace. */
+	labelKey: z.string().optional(),
+	type: z.enum([
+		"enum",
+		"number",
+		"boolean",
+		"string"
+	]),
+	/** `enum` only: the closed set of accepted values. */
+	options: z.array(z.object({
+		value: z.string(),
+		label: z.string()
+	})).optional(),
+	/** `number` only. */
+	min: z.number().optional(),
+	max: z.number().optional(),
+	/** What the notifier does when the rule sets nothing; shown as the placeholder. */
+	default: DeliveryParamValueSchema.optional()
+});
 /**
 * The canonical notification. `body` is the only hard field (Apprise model).
 * `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
@@ -21342,7 +21379,13 @@ var NotificationSchema = z.object({
 	tag: z.string().optional(),
 	deviceId: z.number().optional(),
 	eventId: z.string().optional(),
-	metadata: z.record(z.string(), z.unknown()).optional()
+	metadata: z.record(z.string(), z.unknown()).optional(),
+	/**
+	* Values for the parameters the target's kind DECLARES in
+	* {@link TargetKindSchema} `deliveryParams`. Already validated against the
+	* declaration by the sender; a notifier reads only the keys it declared.
+	*/
+	delivery: z.record(z.string(), DeliveryParamValueSchema).optional()
 });
 /** One declared native severity/priority level for a kind. */
 var TargetKindLevelSchema = z.object({
@@ -21450,6 +21493,11 @@ var TargetKindSchema = z.object({
 	*/
 	destinationKeys: z.array(z.string()).optional(),
 	supportsDiscovery: z.boolean(),
+	/**
+	* Extra delivery parameters a rule may set for a target of this kind (D938).
+	* Absent = none; the rule editor then offers nothing.
+	*/
+	deliveryParams: z.array(DeliveryParamSchema).optional(),
 	caps: TargetKindCapsSchema
 });
 /**
@@ -26537,7 +26585,7 @@ function createMirrorSource(mirror, listeners, api) {
 *
 *   const dev = createDeviceProxy(api, binding)
 *   dev.state.battery.value           // BatteryStatus | undefined
-*   dev.state.battery.value?.percentage
+*   dev.state.battery.value?.level
 *
 * Two-arg form (deprecated path, kept for spec compatibility):
 * passes the api directly, builds a per-handle lazy source. New

package/dist/composition/composition-report.d.ts

@@ -33,7 +33,7 @@ export declare const CompositionProblemCodeSchema: z.ZodEnum<{
     "wrong-device-type": "wrong-device-type";
 }>;
 export type CompositionProblemCode = z.infer<typeof CompositionProblemCodeSchema>;
-/** One refusal, named (D391). `path` points into the composition, e.g. `features[0].fields.celsius`. */
+/** One refusal, named (D391). `path` points into the composition, e.g. `features[0].fields.temperature`. */
 export declare const CompositionProblemSchema: z.ZodObject<{
     code: z.ZodEnum<{
         cycle: "cycle";

package/dist/composition/examples.d.ts

@@ -22,7 +22,7 @@ export declare function roomCompositionExample(input: RoomExampleInput): Composi
  * an `enum-sensor` whose `value` is the raw STRING state — `number(d)` reads it,
  * and anything that is not a number is `null`, never 0 (D393). The battery
  * status sensor is an `enum-sensor` too (`unavailable` keeps its cold `''`, so
- * `percentage` is `null`). `charging` maps `battery_charging` off to
+ * `level` is `null`). `charging` maps `battery_charging` off to
  * `'unknown'`, never `'none'`: off does not prove "on battery alone" (the
  * operator confirms the real semantics live).
  */