Add delivery confirmation and stagger to Settings and Diagnostics UI

Settings: per-climate "Confirm delivery" switch with timeout and attempts
inputs inside each managed climate row, and a global "Delivery stagger"
seconds input. Diagnostics: confirmation outcome, timestamp and attempt count
in the status and delivery group, new delivery status chips, the
delivery_unconfirmed issue text, and attempt-of-N descriptions in the runtime
log. Adds updateZoneDelivery to the API client, saveZoneDelivery to the
settings controller, DeliverySettings/DeliveryConfirmationStatus types,
translations for all ten languages plus the template, vitest coverage, and
the regenerated integration bundle.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WJhD4sYeWQvoikjYP2CxUr

Author: Cloudore

custom_components/velair/frontend/velair-card.js

@@ -2,6 +2,7 @@ import { DOMAIN } from "../constants";
 import type {
   HomeAssistant,
   ComfortSettings,
+  DeliverySettings,
   DiagnosticsSnapshot,
   DiagnosticHistoryCategory,
   ClimateProfileInput,
@@ -233,6 +234,17 @@ export class VelairApiClient {
     });
   }
 
+  public updateZoneDelivery(
+    entityId: string,
+    delivery: Partial<DeliverySettings>,
+  ): Promise<ScheduleResponse> {
+    return this.hass.connection.sendMessagePromise<ScheduleResponse>({
+      type: "velair/update_zone_delivery",
+      entity_id: entityId,
+      delivery,
+    });
+  }
+
   public resetZonePreconditioningLearning(entityId: string, direction: "heat" | "cool"): Promise<ScheduleResponse> {
     return this.hass.connection.sendMessagePromise<ScheduleResponse>({
       type: "velair/reset_zone_preconditioning_learning",

custom_components/velair/frontend/velair-card.js.map

@@ -25,6 +25,7 @@ import {
 import type {
   BlockDraftSource,
   ComfortSettings,
+  DeliverySettings,
   DraftScheduleBlock,
   DiagnosticsSnapshot,
   EntityDiagnostic,
@@ -120,6 +121,7 @@ import {
   moveSettingsZone,
   saveSettings,
   saveZoneComfort,
+  saveZoneDelivery,
   saveZonePreconditioning,
   resetZonePreconditioningLearning,
   resetZonePreconditioningSettings,
@@ -1445,6 +1447,13 @@ export class VelairCard extends LitElement {
     await saveZoneComfort(asSettingsActionsHost(this), entityId, comfort);
   }
 
+  private async _saveZoneDelivery(
+    entityId: string,
+    delivery: Partial<DeliverySettings>,
+  ): Promise<void> {
+    await saveZoneDelivery(asSettingsActionsHost(this), entityId, delivery);
+  }
+
   private _togglePreconditioningZone(entityId: string): void {
     const expandedZones = new Set(this._expandedPreconditioningZones);
     if (expandedZones.has(entityId)) {

frontend/src/velair/api/client.ts

@@ -21,6 +21,13 @@ export const VELAIR_LOADING_ICON_URL = "/velair_frontend/velair-icon.png";
 export const PROFILE_DESCRIPTION_MAX_LENGTH = 500;
 export const MODE_NAME_MAX_LENGTH = 255;
 export const DEFAULT_EXTERNAL_CHANGE_DURATION_MINUTES = 120;
+export const DEFAULT_DELIVERY_CONFIRM_TIMEOUT_SECONDS = 25;
+export const MIN_DELIVERY_CONFIRM_TIMEOUT_SECONDS = 5;
+export const MAX_DELIVERY_CONFIRM_TIMEOUT_SECONDS = 120;
+export const DEFAULT_DELIVERY_CONFIRM_ATTEMPTS = 3;
+export const MIN_DELIVERY_CONFIRM_ATTEMPTS = 1;
+export const MAX_DELIVERY_CONFIRM_ATTEMPTS = 5;
+export const MAX_DELIVERY_STAGGER_SECONDS = 30;
 export const PANEL_VIEWS: VelairPanelView[] = [
   "overview",
   "schedules",

frontend/src/velair/components/velair-card-element.ts

@@ -1,6 +1,13 @@
 import { WEEKDAYS } from "../constants";
 import type { VelairApiClient } from "../api/client";
-import type { ComfortSettings, PanelSettings, PreconditioningSettings, ScheduleResponse, VelairCardConfig } from "../types";
+import type {
+  ComfortSettings,
+  DeliverySettings,
+  PanelSettings,
+  PreconditioningSettings,
+  ScheduleResponse,
+  VelairCardConfig,
+} from "../types";
 
 type SettingsActionsHost = {
   _config: VelairCardConfig;
@@ -109,6 +116,30 @@ export async function saveZoneComfort(
   }
 }
 
+export async function saveZoneDelivery(
+  host: SettingsActionsHost,
+  entityId: string,
+  delivery: Partial<DeliverySettings>,
+): Promise<void> {
+  const api = host._api();
+  if (!api) {
+    return;
+  }
+
+  host._settingsSaving = true;
+  host._error = undefined;
+  host._saveMessage = undefined;
+  try {
+    const data = await api.updateZoneDelivery(entityId, delivery);
+    host._applyScheduleData(data);
+    host._showSuccess(host._t("deliverySettingsSaved"));
+  } catch (error) {
+    host._error = error instanceof Error ? error.message : host._t("unableSaveSettings");
+  } finally {
+    host._settingsSaving = false;
+  }
+}
+
 export async function resetZonePreconditioningLearning(
   host: SettingsActionsHost,
   entityId: string,

frontend/src/velair/constants.ts

@@ -5,6 +5,7 @@ import type { SupportedLanguage, TranslationKey } from "./translations";
 import type {
   BlockDraftSource,
   ComfortSettings,
+  DeliverySettings,
   DiagnosticsSnapshot,
   DraftScheduleBlock,
   EntityDiagnostic,
@@ -195,6 +196,7 @@ export type VelairViewHost = {
   _resumeAutomaticControl(entityId: string): Promise<void>;
   _enterManualAdjustment(entityId: string): Promise<void>;
   _saveZoneComfort(entityId: string, comfort: Partial<ComfortSettings>): Promise<void>;
+  _saveZoneDelivery(entityId: string, delivery: Partial<DeliverySettings>): Promise<void>;
   _saveZonePreconditioning(entityId: string, preconditioning: Partial<PreconditioningSettings>): Promise<void>;
   _saveTemplate(saveAsNew: boolean): Promise<void>;
   _scheduleTemplates(): ScheduleTemplate[];

frontend/src/velair/controllers/settings-actions.ts

@@ -420,6 +420,14 @@ export const settingsStyles = css`
   padding-inline-end: 7px;
 }
 
+.settings-delivery-confirmation .settings-policy-controls { gap: 10px; }
+
+.settings-delivery-confirmation ha-switch { flex: 0 0 auto; }
+
+.settings-delivery-confirmation .settings-policy-duration { flex: 0 1 96px; min-width: 72px; }
+
+.settings-delivery-stagger .settings-policy-duration { flex: 0 0 96px; }
+
 .settings-zone-identity strong,
 .settings-zone-identity span {
   overflow: hidden;

frontend/src/velair/host-types.ts

@@ -15,6 +15,14 @@ export const de = {
   "externalChangeForDuration": "Für eine Dauer",
   "externalChangeUntilResumed": "Bis zur Fortsetzung",
   "externalChangePolicySaved": "Richtlinie für externe Änderungen gespeichert",
+  "deliveryConfirmation": "Zustellung bestätigen",
+  "deliveryConfirmationDescription": "Nachdem ein Zielwert angenommen wurde, wird dieses Klimagerät beobachtet, bis es den angeforderten Modus und die Temperatur meldet. Konvergiert es nicht vor Ablauf der Zeitüberschreitung, sendet Velair die aktuelle Absicht erneut, bis zur konfigurierten Anzahl an Versuchen. Nur für Geräte aktivieren, die Befehle stillschweigend verwerfen.",
+  "deliveryConfirmationInfoAction": "Über die Zustellbestätigung",
+  "deliveryConfirmTimeout": "Zeitüberschreitung",
+  "deliveryConfirmAttempts": "Versuche",
+  "deliverySettingsSaved": "Zustelleinstellungen gespeichert",
+  "deliveryStagger": "Zustellabstand",
+  "deliveryStaggerDescription": "Mindestabstand in Sekunden zwischen dem Start von Befehlen an verschiedene Klimageräte. Null sendet Befehle ohne geräteübergreifende Taktung. Verwende einen kleinen Wert für Gateways, die direkt aufeinanderfolgende Schreibvorgänge verwerfen.",
   "manualAdjustment": "Manuelle Anpassung",
   "velairControl": "Velair-Steuerung",
   "automaticScheduling": "Automatische Planung",
@@ -691,6 +699,12 @@ export const de = {
   "diagnosticsDeliveryStatus": "Übertragungsstatus",
   "diagnosticsRetryCount": "Wiederholungen",
   "diagnosticsLastError": "Letzter Fehler",
+  "diagnosticsDeliveryConfirmation": "Bestätigung",
+  "diagnosticsDeliveryAttempts": "Bestätigungsversuche",
+  "diagnosticsDeliveryConfirming": "Warte auf Bestätigung",
+  "diagnosticsDeliveryConfirmed": "Vom Klimagerät bestätigt",
+  "diagnosticsDeliveryUnconfirmed": "Das Klimagerät hat den angeforderten Zielwert nicht gemeldet.",
+  "diagnosticsDeliveryAttemptOf": "Versuch {attempt} von {attempts}",
   "diagnosticsScheduleSource": "Zeitplanquelle",
   "diagnosticsMode": "Modus",
   "diagnosticsProfile": "Profil",

frontend/src/velair/styles/settings-styles.ts

@@ -59,6 +59,14 @@ export const en = {
   "externalChangeForDuration": "For a duration",
   "externalChangeUntilResumed": "Until resumed",
   "externalChangePolicySaved": "External change policy saved",
+  "deliveryConfirmation": "Confirm delivery",
+  "deliveryConfirmationDescription": "After a target is accepted, this climate is watched until it reports the requested mode and temperature. If it does not converge before the timeout, Velair sends the current intent again, up to the configured number of attempts. Enable this only for devices that silently drop commands.",
+  "deliveryConfirmationInfoAction": "About delivery confirmation",
+  "deliveryConfirmTimeout": "Timeout",
+  "deliveryConfirmAttempts": "Attempts",
+  "deliverySettingsSaved": "Delivery settings saved",
+  "deliveryStagger": "Delivery stagger",
+  "deliveryStaggerDescription": "Minimum seconds between the start of commands to different climates. Zero sends commands without cross-climate pacing. Use a small value for gateways that drop back-to-back writes.",
   "manualAdjustment": "Manual adjustment",
   "velairControl": "Velair control",
   "automaticScheduling": "Automatic scheduling",
@@ -752,6 +760,12 @@ export const en = {
   "diagnosticsReasonStopped": "Stopped",
   "diagnosticsRetryCount": "Retries",
   "diagnosticsLastError": "Last error",
+  "diagnosticsDeliveryConfirmation": "Confirmation",
+  "diagnosticsDeliveryAttempts": "Confirmation attempts",
+  "diagnosticsDeliveryConfirming": "Awaiting confirmation",
+  "diagnosticsDeliveryConfirmed": "Confirmed by the climate",
+  "diagnosticsDeliveryUnconfirmed": "The climate did not report the requested target.",
+  "diagnosticsDeliveryAttemptOf": "Attempt {attempt} of {attempts}",
   "diagnosticsScheduleSource": "Schedule source",
   "diagnosticsMode": "Mode",
   "diagnosticsProfile": "Profile",