@camstack/types 1.2.435 → 1.2.437

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.437] - 2026-10-28
+
+### Changed
+
+- The vendor sign-in proxy keeps the vendor's session cookie when the vendor also deletes a same-named cookie on another domain
+- An AI profile can turn the model's thinking off or set its effort
+
+## [1.2.436] - 2026-10-28
+
+### Changed
+
+- Addon manifest entries can declare which Integrations block they belong to (integrationSection)
+- A notifier can declare extra delivery parameters (type, options, default) and a rule target can carry them to it.
+- Vendor sign-in proxy: form fields carrying a proxied address are sent back to the vendor with the vendor's own address
+- A temperature or humidity group can include thermostats and climate devices, read from their current temperature/humidity
+
 ## [1.2.435] - 2026-10-28
 
 ### Changed

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

@@ -51,6 +51,10 @@ declare const AddonListItemSchema: z.ZodObject<{
         }, z.core.$strip>>;
         protected: z.ZodOptional<z.ZodBoolean>;
         removable: z.ZodOptional<z.ZodBoolean>;
+        integrationSection: z.ZodOptional<z.ZodEnum<{
+            providers: "providers";
+            system: "system";
+        }>>;
     }, z.core.$strip>;
     declaration: z.ZodOptional<z.ZodUnknown>;
     source: z.ZodString;
@@ -400,6 +404,10 @@ export declare const addonsCapability: {
                 }, z.core.$strip>>;
                 protected: z.ZodOptional<z.ZodBoolean>;
                 removable: z.ZodOptional<z.ZodBoolean>;
+                integrationSection: z.ZodOptional<z.ZodEnum<{
+                    providers: "providers";
+                    system: "system";
+                }>>;
             }, z.core.$strip>;
             declaration: z.ZodOptional<z.ZodUnknown>;
             source: z.ZodString;

package/dist/capabilities/index.d.ts

@@ -100,7 +100,7 @@ export type { BrokerConnectionDetails, BrokerInfo as MqttBrokerInfo, BrokerStatu
 export { AddBrokerInputSchema, BrokerConnectionDetailsSchema, BrokerInfoSchema as MqttBrokerInfoSchema, MqttBrokerStatusSchema, mqttBrokerCapability, StartEmbeddedInputSchema, } from './mqtt-broker.cap.js';
 export type { NetworkAccessStatus, NetworkEndpoint, NetworkTunnelStartedData, } from './network-access.cap.js';
 export { NetworkAccessStatusSchema, NetworkEndpointSchema, NetworkTunnelStartedDataSchema, networkAccessCapability, } from './network-access.cap.js';
-export { type Attachment, type AttachmentMediaType, AttachmentMediaTypeSchema, AttachmentSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, type NotificationActionIcon, NotificationActionIconSchema, NotificationActionSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, notificationOutputCapability, type ProbeTargetConfigResult, ProbeTargetConfigResultSchema, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, TargetSchema, type TestResult, TestResultSchema, } from './notification-output.cap.js';
+export { type Attachment, type AttachmentMediaType, AttachmentMediaTypeSchema, AttachmentSchema, type DeliveryParam, DeliveryParamSchema, type DeliveryParamValue, DeliveryParamValueSchema, type DiscoveredTarget, DiscoveredTargetSchema, type INotificationOutputProvider, type NotificationAction, type NotificationActionIcon, NotificationActionIconSchema, NotificationActionSchema, type NotificationFormat, NotificationFormatSchema, NotificationSchema, notificationOutputCapability, type ProbeTargetConfigResult, ProbeTargetConfigResultSchema, type RenderedAs, RenderedAsSchema, type SendResult, SendResultSchema, type Target, type TargetKind, type TargetKindCaps, TargetKindCapsSchema, type TargetKindLevel, TargetKindLevelSchema, TargetKindSchema, TargetSchema, type TestResult, TestResultSchema, } from './notification-output.cap.js';
 export { consumableLowPercentOf, type INotificationRulesProvider, isRetiredClearKey, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_NONBLOCKING_MAX, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_AUDIO_DBFS_FLOOR, NC_AUTHORABLE_SYSTEM_EVENT_KINDS, NC_LEGACY_SYSTEM_EVENT_KINDS, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CLIP_POST_ROLL_DEFAULT_SEC, NC_CLIP_PRE_ROLL_DEFAULT_SEC, NC_CLIP_RETENTION_MAX_SEC, NC_CONDITION_CATALOG, NC_CONFIRM_DEFAULT_MAX_IMAGE_PX, NC_CONFIRM_DEFAULT_TIMEOUT_MS, NC_CONFIRM_MAX_TIMEOUT_MS, NC_CONFIRM_MIN_TIMEOUT_MS, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_DEFAULT_SNOOZE_MINUTES, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_HISTORY_LIMIT_DEFAULT, NC_HISTORY_LIMIT_MAX, NC_MAX_PER_TRACK_IMMEDIATE, NC_RULE_CLEARABLE_KEYS, NC_RULE_RETIRED_CLEAR_KEYS, NC_SNOOZE_MAX_MINUTES, type NcActionBinding, NcActionBindingSchema, type NcAlarmBlocking, type NcAlarmBlockingEdit, NcAlarmBlockingEditSchema, NcAlarmBlockingSchema, type NcAlarmConfig, NcAlarmConfigSchema, type NcAlarmCreateProfileInput, NcAlarmCreateProfileInputSchema, type NcAlarmModeCoverage, NcAlarmModeCoverageSchema, type NcAlarmModeDelays, type NcAlarmModeDelaysEdit, NcAlarmModeDelaysEditSchema, NcAlarmModeDelaysSchema, type NcAlarmModeDeviceList, NcAlarmModeDeviceListSchema, type NcAlarmNonBlocking, type NcAlarmNonBlockingEdit, NcAlarmNonBlockingEditSchema, NcAlarmNonBlockingSchema, type NcAlarmPostTriggeredAction, NcAlarmPostTriggeredActionSchema, type NcAlarmProfileIdInput, NcAlarmProfileIdInputSchema, type NcAlarmProfileMeta, NcAlarmProfileMetaSchema, type NcAlarmProfilesView, NcAlarmProfilesViewSchema, type NcAlarmRenameProfileInput, NcAlarmRenameProfileInputSchema, type NcAlarmSecureOnArmEdit, NcAlarmSecureOnArmEditSchema, type NcAlarmSecureOnArmOff, NcAlarmSecureOnArmOffSchema, type NcAlarmSensorReading, NcAlarmSensorReadingSchema, type NcAlarmSensorState, NcAlarmSensorStateSchema, type NcAlarmSensors, type NcAlarmSensorsInput, NcAlarmSensorsInputSchema, NcAlarmSensorsSchema, type NcAlarmSettings, type NcAlarmSettingsPatch, NcAlarmSettingsPatchSchema, NcAlarmSettingsSchema, type NcAlarmSkippedDevice, NcAlarmSkippedDeviceSchema, type NcAlarmSkipReason, NcAlarmSkipReasonSchema, type NcAudioCondition, NcAudioConditionSchema, type NcClipRetentionAsk, NcClipRetentionAskSchema, type NcClipRetentionPlan, NcClipRetentionPlanSchema, type NcConditionDescriptor, NcConditionDescriptorSchema, type NcConditions, NcConditionsSchema, type NcConfirm, type NcConfirmExpect, NcConfirmExpectSchema, NcConfirmSchema, type NcCrossing, NcCrossingSchema, type NcDelivery, NcDeliverySchema, type NcDeviceStateCondition, NcDeviceStateConditionSchema, type NcHistoryEntry, NcHistoryEntrySchema, type NcHistoryFilter, NcHistoryFilterSchema, type NcHistoryRecordKind, NcHistoryRecordKindSchema, type NcHistoryStatus, NcHistoryStatusSchema, type NcHistorySubject, NcHistorySubjectSchema, type NcHookBindings, NcHookBindingsSchema, type NcLegacyRuleActionSequence, NcLegacyRuleActionSequenceSchema, type NcLinkedCameraMode, NcLinkedCameraModeSchema, type NcMediaFrame, NcMediaFrameSchema, type NcMediaImage, NcMediaImageSchema, type NcMediaPolicy, NcMediaPolicySchema, type NcOccupancyCondition, NcOccupancyConditionSchema, type NcPlateMatcher, NcPlateMatcherSchema, type NcRule, type NcRuleAction, NcRuleActionSchema, type NcRuleActionSequence, NcRuleActionSequenceSchema, type NcRuleActions, NcRuleActionsSchema, type NcRuleClearableKey, NcRuleClearableKeySchema, type NcRuleInput, NcRuleInputSchema, NcRuleKindSchema, type NcRuleLastRun, NcRuleLastRunSchema, type NcRuleLastRuns, NcRuleLastRunsSchema, type NcRuleNotificationButton, NcRuleNotificationButtonSchema, type NcRulePatch, NcRulePatchSchema, NcRuleSchema, type NcRuleTarget, NcRuleTargetSchema, type NcRuleUpdateInput, NcRuleUpdateInputSchema, type NcSceneCondition, NcSceneConditionSchema, type NcSchedule, NcScheduleSchema, type NcScheduleWindow, NcScheduleWindowSchema, type NcSensorTransition, NcSensorTransitionSchema, type NcSharedSequence, type NcSharedSequenceInput, NcSharedSequenceInputSchema, NcSharedSequenceSchema, type NcSnooze, type NcSnoozeInput, NcSnoozeInputSchema, NcSnoozeSchema, type NcSnoozeScope, NcSnoozeScopeSchema, type NcSnoozeSuppressed, NcSnoozeSuppressedSchema, type NcStateSummaryPreview, type NcStateSummaryPreviewRow, NcStateSummaryPreviewRowSchema, NcStateSummaryPreviewSchema, type NcStateSummaryPreviewSection, NcStateSummaryPreviewSectionSchema, type NcStateSummarySectionId, NC_STATE_SUMMARY_SECTION_IDS, NcStateSummarySectionIdSchema, type NcStateSummarySplit, NcStateSummarySplitSchema, type NcSystemEventCondition, NcSystemEventConditionSchema, type NcSystemEventDelivery, type NcSystemEventDeliveryMode, NcSystemEventDeliveryModeSchema, NcSystemEventDeliverySchema, type NcSystemEventKind, NcSystemEventKindSchema, type NcTemplateFamily, NcTemplateFamilySchema, type NcTemplateField, NcTemplateFieldSchema, type NcTemplatePreview, type NcTemplatePreviewInput, NcTemplatePreviewInputSchema, NcTemplatePreviewSchema, type NcTemplateVarContext, NcTemplateVarContextSchema, type NcTemplateVarDescriptor, NcTemplateVarDescriptorSchema, type NcTemplateVarGroup, NcTemplateVarGroupSchema, type NcTemplateVarKind, NcTemplateVarKindSchema, type NcTestResult, NcTestResultSchema, type NcThrottle, type NcThrottleGranularity, NcThrottleGranularitySchema, NcThrottleSchema, type NcZoneCondition, NcZoneConditionSchema, notificationRulesCapability, } from './notification-rules.cap.js';
 export { type IOauthIntegrationProvider, type OauthIntegrationDescriptor, OauthIntegrationDescriptorSchema, oauthIntegrationCapability, } from './oauth-integration.cap.js';
 export { type IOidcConnectionsProvider, type OidcConnection, OidcConnectionSchema, type OidcConnectionUpdateInput, OidcConnectionUpdateInputSchema, oidcConnectionsCapability, } from './oidc-connections.cap.js';

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

@@ -63,6 +63,12 @@ export declare const LlmProfileSchema: z.ZodObject<{
     topP: z.ZodOptional<z.ZodNumber>;
     topK: z.ZodOptional<z.ZodNumber>;
     maxTokens: z.ZodOptional<z.ZodNumber>;
+    reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        low: "low";
+        medium: "medium";
+        off: "off";
+    }>>;
     contextLength: z.ZodOptional<z.ZodNumber>;
     systemPrompt: z.ZodOptional<z.ZodString>;
     timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -87,6 +93,7 @@ export declare const LlmProfileFieldSchema: z.ZodEnum<{
     firstTokenTimeoutMs: "firstTokenTimeoutMs";
     idleTimeoutMs: "idleTimeoutMs";
     maxTokens: "maxTokens";
+    reasoningEffort: "reasoningEffort";
     retry: "retry";
     systemPrompt: "systemPrompt";
     temperature: "temperature";
@@ -144,6 +151,7 @@ export declare const LlmProfileKindDescriptorSchema: z.ZodObject<{
         firstTokenTimeoutMs: "firstTokenTimeoutMs";
         idleTimeoutMs: "idleTimeoutMs";
         maxTokens: "maxTokens";
+        reasoningEffort: "reasoningEffort";
         retry: "retry";
         systemPrompt: "systemPrompt";
         temperature: "temperature";
@@ -527,6 +535,7 @@ export declare const llmCapability: {
                 firstTokenTimeoutMs: "firstTokenTimeoutMs";
                 idleTimeoutMs: "idleTimeoutMs";
                 maxTokens: "maxTokens";
+                reasoningEffort: "reasoningEffort";
                 retry: "retry";
                 systemPrompt: "systemPrompt";
                 temperature: "temperature";
@@ -556,6 +565,12 @@ export declare const llmCapability: {
             topP: z.ZodOptional<z.ZodNumber>;
             topK: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                low: "low";
+                medium: "medium";
+                off: "off";
+            }>>;
             contextLength: z.ZodOptional<z.ZodNumber>;
             systemPrompt: z.ZodOptional<z.ZodString>;
             timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -582,6 +597,12 @@ export declare const llmCapability: {
                 topP: z.ZodOptional<z.ZodNumber>;
                 topK: z.ZodOptional<z.ZodNumber>;
                 maxTokens: z.ZodOptional<z.ZodNumber>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    off: "off";
+                }>>;
                 contextLength: z.ZodOptional<z.ZodNumber>;
                 systemPrompt: z.ZodOptional<z.ZodString>;
                 timeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -607,6 +628,12 @@ export declare const llmCapability: {
             topP: z.ZodOptional<z.ZodNumber>;
             topK: z.ZodOptional<z.ZodNumber>;
             maxTokens: z.ZodOptional<z.ZodNumber>;
+            reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                low: "low";
+                medium: "medium";
+                off: "off";
+            }>>;
             contextLength: z.ZodOptional<z.ZodNumber>;
             systemPrompt: z.ZodOptional<z.ZodString>;
             timeoutMs: z.ZodDefault<z.ZodNumber>;

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/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
 });
 /**

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
 });
 /**

package/dist/composition/helpers/index.d.ts

@@ -10,5 +10,5 @@ export { KWH_PER_WATT_MS, wattMillisecondsToKwh } from './energy.js';
 export { type HistoryValue, type IntegralScale, type SeriesBefore, type SeriesKind, type SeriesPoint, type SeriesRead, STATISTIC_STATS, SERIES_KINDS, evaluateDerivative, evaluateStatistic, integrateReading, } from './history-math.js';
 export { type CalendarPeriod, type CalendarWindow, type HistoryRetention, type HistoryTier, type HistoryTierPlan, type OpenRange, type ResetPeriod, type RollingSpan, type RollingWindow, type StatisticWindow, CALENDAR_PERIODS, CalendarWindowSchema, DAY_MS, DEFAULT_HISTORY_RETENTION, HISTORY_FAST_MS, HISTORY_SLOW_MS, HISTORY_TIERS, HOUR_MS, MINUTE_MS, MIN_CUSTOM_MINUTES, RESET_PERIODS, ROLLING_SPANS, RollingWindowSchema, StatisticWindowSchema, integralCadenceMs, maxDurationMs, nextLocalMidnight, openReset, openStatistic, planResetTier, planStatisticTier, rollingDurationMs, statisticCadenceMs, } from './history-window.js';
 export { type HelperMemberFact, helperSaveProblems, } from './save.js';
-export { type SourcePick, type SourcePickAccept, type SourcePickHistory, type SourcePickRequest, type MathSourceKind, sourcePickForHistory, sourcePickForMath, sourcePickForTemplate, } from './source-pick.js';
+export { type SourcePick, type SourcePickAccept, type SourcePickFieldChoice, type SourcePickHistory, type SourcePickRequest, type MathSourceKind, sourcePickForHistory, sourcePickForMath, sourcePickForTemplate, } from './source-pick.js';
 export { ACTIVE_CRITERIA, AGGREGATE_REDUCERS, ActiveCriterionSchema, AggregateReducerSchema, BINARY_AGGREGATES, GROUP_TEMPLATE_IDS, ApplianceHelperSpecSchema, ARITHMETIC_OPS, ArithmeticHelperSpecSchema, DERIVATIVE_UNITS, DerivativeHelperSpecSchema, EXPRESSION_OUTPUTS, ExpressionHelperSpecSchema, ThresholdHelperSpecSchema, GroupHelperSpecSchema, GroupTemplateIdSchema, HelperMemberSchema, HelperSpecSchema, INTEGRAL_OUTPUTS, IntegralHelperSpecSchema, MAX_HELPER_MEMBERS, helperMembers, isHistoryHelper, NUMERIC_AGGREGATES, StatisticHelperSpecSchema, type ActiveCriterion, type AggregateReducer, type BinaryAggregate, type ApplianceHelperSpec, type ArithmeticHelperSpec, type ArithmeticOp, type DerivativeHelperSpec, type DerivativeUnit, type ExpressionHelperSpec, type ExpressionInput, type ExpressionOutput, type ThresholdHelperSpec, type GroupHelperSpec, type GroupTemplateId, type HelperMember, type HelperSpec, type HistoryHelperSpec, type IntegralHelperSpec, type IntegralOutput, type NumericAggregate, type StatisticHelperSpec, type StatisticStat, } from './spec.js';

package/dist/composition/helpers/source-pick.d.ts

@@ -15,7 +15,14 @@ export interface SourcePickHistory {
     readonly required: boolean;
     readonly minRetentionMs: number | null;
 }
+/**
+ * How a device that satisfies several accept entries gets its field. `first-match`
+ * takes the first listed entry the device has (the dedicated sensor before a
+ * climate reading); `operator` waits for the operator to pick (occupancy).
+ */
+export type SourcePickFieldChoice = 'first-match' | 'operator';
 export interface SourcePickRequest {
+    readonly fieldChoice: SourcePickFieldChoice;
     readonly purpose: 'member' | 'reading' | 'historised';
     readonly multiple: boolean;
     readonly max: number;

package/dist/{composition-CZImLpOI.mjs → composition-DwA0uVW5.mjs}

@@ -2266,6 +2266,7 @@ function isApplianceKind(value) {
 /** The member step: one power reading, from a sensor or from the plug itself. */
 function sourcePickForAppliance() {
 	return {
+		fieldChoice: "operator",
 		purpose: "reading",
 		multiple: false,
 		max: 1,

package/dist/{composition-BZf_gqG7.js → composition-WNkEpwkF.js}

@@ -2266,6 +2266,7 @@ function isApplianceKind(value) {
 /** The member step: one power reading, from a sensor or from the plug itself. */
 function sourcePickForAppliance() {
 	return {
+		fieldChoice: "operator",
 		purpose: "reading",
 		multiple: false,
 		max: 1,

package/dist/index.d.ts

@@ -293,6 +293,7 @@ export { AUDIO_SCALE_EPOCH_ISO, AUDIO_SCALE_EPOCH_MS, type AudioScaleEra, audioS
 export { audioIsFailClosed, audioKindId, audioLabelChoices, audioModeOf, audioOrDefaults, isAudioLabelSelected, NC_AUDIO_CONFIRM_HITS_DEFAULT, NC_AUDIO_CONFIRM_HITS_MAX, NC_AUDIO_CONFIRM_HITS_MIN, NC_AUDIO_CONFIRM_WINDOW_MAX_SEC, NC_AUDIO_CONFIRM_WINDOW_MIN_SEC, NC_AUDIO_CONFIRM_WINDOW_SEC_DEFAULT, NC_AUDIO_DB_MAX, NC_AUDIO_DB_MIN, NC_AUDIO_DB_OFFERED, NC_AUDIO_DB_STEP, NC_AUDIO_DEFAULTS, NC_AUDIO_HIT_PERCENT_MAX, NC_AUDIO_HIT_PERCENT_MIN, NC_AUDIO_SAMPLING_MAX_SEC, NC_AUDIO_SAMPLING_MIN_SEC, type NcAudioLabelChoice, type NcAudioMode, type NcAudioPatch, normalizeAudioLabel, patchAudio, toggleAudioLabel, } from './notification/audio-condition.js';
 export { isAudioClassName, isBaseConditionKey, knownValues, NC_BASE_CONDITION_KEYS, type NcBaseConditionKey, pickerForCondition, pickerForRuleClasses, type TaxonomyGroup, type TaxonomyOption, type TaxonomyPicker, } from './notification/condition-taxonomy.js';
 export { type PreparedAction, type PreparedAttachment, type PreparedNotification, prepareNotification, type ResolvedLevel, } from './notification/degrade-engine.js';
+export { deliveryParamsDeclaredBy, resolveDeliveryParams } from './notification/delivery-params.js';
 export { htmlToText, markdownToHtmlLite, markdownToText, type NotificationFormat as NotificationBodyFormat, resolveFormat, textToHtml, transcodeBody, } from './notification/format-transcode.js';
 export { conditionExclusionReason, conditionVisibleForKind, defaultDeliveryForSection, droppedConditionsForKind, isAudioRule, isOccupancyRule, isSystemDelivery, isSystemRuleKind, kindsForDiscriminator, NC_AUDIO_SEED, NC_CAMERA_SCOPE_CAP_NAME, NC_OCCUPANCY_DEFAULTS, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_RULE_SECTIONS, NC_SYSTEM_DELIVERY, NC_SYSTEM_RULE_KINDS, type NcDroppedCondition, type NcKindVisibilitySubject, type NcRuleEditorSection, type NcRuleEditorSectionKey, type NcRuleKind, type NcRuleKindSpec, type NcRuleOwningSectionKey, type NcRuleSection, type NcRuleSectionKey, type NcRuleConditionsSubject, type NcRuleSectionSubject, type NcRuleSeed, parseRuleSection, ruleDeviceCompatCapNames, ruleDeviceCompatCapQueries, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleMatchesSection, ruleSection, ruleSectionOf, ruleSeedForSection, systemFamilyOfKind, systemRuleKindOf, } from './notification/rule-kinds.js';
 export { imageModesForKind, legacyImageMode, NC_MEDIA_IMAGE_MODES, type NcMediaRuleSubject, ncMediaPolicyError, normalizeNcMediaPolicy, resolveNcMediaImage, ruleTriggerZoneIds, subjectHasPath, } from './notification/media-image.js';