iobroker.yamaha 2.6.0 → 2.7.2

package/README.md

@@ -108,6 +108,18 @@ On the very first contact the adapter asks the receiver which functions it suppo
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 2.7.2 (2026-09-09)
+
+- (krobipd) Fixed: The volume readout now follows the scale the receiver is actually showing, so a receiver set to numbers no longer reports them as decibels.
+- (krobipd) New: Inputs now appear under the names the receiver carries for them, so a socket named “Apple TV” reads that way instead of HDMI1.
+- (krobipd) Changed: After this update every receiver is asked about its abilities once more, so the first start takes a little longer than usual.
+
+### 2.7.1 (2026-09-09)
+
+- (krobipd) Improved: The first connection asks a receiver only what its generation can answer, so zones, trigger sockets and per-input settings follow the device, not a catalogue.
+- (krobipd) New: A datapoint the receiver reveals later now appears at once — a function it starts answering, a value it reports for the first time, a status field it begins delivering.
+- (krobipd) Changed: A datapoint that never carried a value is removed only after two starts confirm it, so a receiver left in standby no longer loses datapoints it still has.
+
 ### 2.6.0 (2026-09-09)
 
 - (krobipd) Fixed: input and sound program lists now offer only what the receiver itself declares or proves it has, instead of every value any Yamaha may have (#619)
@@ -126,21 +138,6 @@ On the very first contact the adapter asks the receiver which functions it suppo
 
 - (krobipd) Changed: installing straight from GitHub is no longer offered — the adapter is built before publishing, so it is installed from the ioBroker repository instead
 
-### 2.5.0 (2026-09-07)
-
-- (krobipd) Fixed: switching off a datapoint group now clears it in every zone — turning off "Sound" used to leave the zone 2/3/4 sound datapoints standing, and "Playback" left 304 of them
-- (krobipd) Fixed: folders explain themselves on all three protocols now — on MusicCast and older XML receivers the explanation was missing, so a speaker or soundbar got almost none
-- (krobipd) Improved: numeric datapoints carry the limits the device itself declares, so a slider offers exactly the range the receiver accepts instead of an open number field
-- (krobipd) New: 61 setup datapoints of the 2010 receiver generation — speaker configuration, HDMI and lip-sync settings, trigger assignment, subwoofer trim, YPAO volume and the RDS clock
-- (krobipd) New: the device-wide MusicCast settings are readable and writable — automatic standby, display brightness and the two HDMI outputs, created only where the device really offers them
-- (krobipd) Fixed: bass, treble and subwoofer trim showed doubled values on MusicCast receivers — that scale counts in half decibels and was labelled as decibels
-- (krobipd) Fixed: a receiver that was in standby when the adapter started could end up with an empty media menu until the next restart
-
-### 2.4.0 (2026-09-03)
-
-- (krobipd) New: the on-screen remote reaches every protocol now — the cursor pad and the menu keys work on YNCA and pre-2010 XML receivers, not just on MusicCast
-- (krobipd) Changed: stepping one menu level back no longer switches to a substitute key on a receiver that rejects it — on those models the new cursor pad does it
-
 [Older changelogs can be found there](CHANGELOG_OLD.md)
 
 ## History

package/admin/i18n/de.json

@@ -256,6 +256,7 @@
   "volume": "Lautstärke",
   "descVolume": "Wie laut die Zone spielt: die beiden Text-Protokolle melden Dezibel, MusicCast seine eigene Schrittzahl — die Einheit sagt, welche.",
   "volumeDB": "Lautstärke (dB)",
+  "volumeDisplay": "Lautstärke (Anzeige)",
   "volumeDisplayMode": "Lautstärke-Anzeigeart",
   "volumeInterlock": "Lautstärke-Kopplung",
   "yncaControlPort": "YNCA-Steuerport",
@@ -384,6 +385,7 @@
   "descElapsedTime": "In Sekunden, damit man damit rechnen kann; die lesbare Form steht daneben.",
   "descTotalTime": "In Sekunden, damit man damit rechnen kann; die lesbare Form steht daneben.",
   "descVolumeDB": "Dieselbe Lautstärke, wie sie das Display des Receivers zeigt, in Dezibel.",
+  "descVolumeDisplay": "Dieselbe Lautstärke, wie sie das Display des Receivers zeigt, in der gerade eingestellten Skala.",
   "descVolumeDisplayMode": "Ob der Receiver die Lautstärke in Dezibel oder als schlichte Zahl anzeigt.",
   "descAudioSelect": "Von welcher Buchse der aktuelle Eingang seinen Ton nimmt: automatisch, HDMI, koaxial/optisch oder analog.",
   "descLinkControl": "Wägt Stabilität gegen Verzögerung ab, wenn an verbundene Geräte gestreamt wird.",

package/admin/i18n/en.json

@@ -256,6 +256,7 @@
   "volume": "Volume",
   "descVolume": "How loud the zone plays: the two text protocols report decibels, MusicCast its own step count — the unit tells you which.",
   "volumeDB": "Volume (dB)",
+  "volumeDisplay": "Volume (display)",
   "volumeDisplayMode": "Volume display mode",
   "volumeInterlock": "Volume interlock",
   "yncaControlPort": "YNCA control port",
@@ -384,6 +385,7 @@
   "descElapsedTime": "In seconds, so it can be calculated with; a readable form sits next to it.",
   "descTotalTime": "In seconds, so it can be calculated with; a readable form sits next to it.",
   "descVolumeDB": "The same volume as the receiver's own display shows it, in decibels.",
+  "descVolumeDisplay": "The same volume the receiver's display shows, in whichever scale it is set to.",
   "descVolumeDisplayMode": "Whether the receiver shows volume in decibels or as a plain number.",
   "descAudioSelect": "Which terminal's sound the current input uses: automatic, HDMI, coaxial/optical or analogue.",
   "descLinkControl": "Trades stability against delay when streaming to linked devices.",

package/admin/i18n/es.json

@@ -256,6 +256,7 @@
   "volume": "Volumen",
   "descVolume": "Lo alto que suena la zona: los dos protocolos de texto dan decibelios, MusicCast sus propios pasos — la unidad indica cuál.",
   "volumeDB": "Volumen (dB)",
+  "volumeDisplay": "Volumen (pantalla)",
   "volumeDisplayMode": "Modo de visualización del volumen",
   "volumeInterlock": "Bloqueo de volumen",
   "yncaControlPort": "Puerto de control YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "En segundos, para poder calcular; la forma legible está al lado.",
   "descTotalTime": "En segundos, para poder calcular; la forma legible está al lado.",
   "descVolumeDB": "El mismo volumen que muestra la pantalla del receptor, en decibelios.",
+  "descVolumeDisplay": "El mismo volumen que muestra la pantalla del receptor, en la escala seleccionada actualmente.",
   "descVolumeDisplayMode": "Si el receptor muestra el volumen en decibelios o como número.",
   "descAudioSelect": "De qué terminal toma el sonido la entrada actual: automático, HDMI, coaxial/óptico o analógico.",
   "descLinkControl": "Equilibra estabilidad y retardo al transmitir a aparatos enlazados.",

package/admin/i18n/fr.json

@@ -256,6 +256,7 @@
   "volume": "Volume",
   "descVolume": "Le niveau sonore de la zone : les deux protocoles texte donnent des décibels, MusicCast ses propres pas — l'unité indique lequel.",
   "volumeDB": "Volume (dB)",
+  "volumeDisplay": "Volume (afficheur)",
   "volumeDisplayMode": "Mode d'affichage du volume",
   "volumeInterlock": "Verrouillage du volume",
   "yncaControlPort": "Port de commande YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "En secondes, pour pouvoir calculer ; la forme lisible est à côté.",
   "descTotalTime": "En secondes, pour pouvoir calculer ; la forme lisible est à côté.",
   "descVolumeDB": "Le même volume que l'afficheur de l'ampli, en décibels.",
+  "descVolumeDisplay": "Le même volume que l'afficheur de l'ampli, dans l'échelle actuellement réglée.",
   "descVolumeDisplayMode": "Si l'ampli affiche le volume en décibels ou en nombre simple.",
   "descAudioSelect": "De quelle prise l'entrée actuelle tire son son : automatique, HDMI, coaxiale/optique ou analogique.",
   "descLinkControl": "Arbitre entre stabilité et latence lors de la diffusion vers les appareils liés.",

package/admin/i18n/it.json

@@ -256,6 +256,7 @@
   "volume": "Volume",
   "descVolume": "Quanto forte suona la zona: i due protocolli testuali danno decibel, MusicCast i propri passi — l'unità dice quale.",
   "volumeDB": "Volume (dB)",
+  "volumeDisplay": "Volume (display)",
   "volumeDisplayMode": "Modalità di visualizzazione del volume",
   "volumeInterlock": "Blocco volume",
   "yncaControlPort": "Porta di controllo YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "In secondi, così è calcolabile; la forma leggibile è accanto.",
   "descTotalTime": "In secondi, così è calcolabile; la forma leggibile è accanto.",
   "descVolumeDB": "Lo stesso volume mostrato dal display del ricevitore, in decibel.",
+  "descVolumeDisplay": "Lo stesso volume mostrato dal display del ricevitore, nella scala attualmente impostata.",
   "descVolumeDisplayMode": "Se il ricevitore mostra il volume in decibel o come numero.",
   "descAudioSelect": "Da quale terminale l'ingresso corrente prende l'audio: automatico, HDMI, coassiale/ottico o analogico.",
   "descLinkControl": "Bilancia stabilità e ritardo nello streaming verso apparecchi collegati.",

package/admin/i18n/nl.json

@@ -256,6 +256,7 @@
   "volume": "Volume",
   "descVolume": "Hoe hard de zone speelt: de twee tekstprotocollen geven decibel, MusicCast zijn eigen stappen — de eenheid zegt welke.",
   "volumeDB": "Volume (dB)",
+  "volumeDisplay": "Volume (display)",
   "volumeDisplayMode": "Weergavemodus volume",
   "volumeInterlock": "Volumekoppeling",
   "yncaControlPort": "YNCA-besturingspoort",
@@ -384,6 +385,7 @@
   "descElapsedTime": "In seconden, zodat ermee gerekend kan worden; de leesbare vorm staat ernaast.",
   "descTotalTime": "In seconden, zodat ermee gerekend kan worden; de leesbare vorm staat ernaast.",
   "descVolumeDB": "Hetzelfde volume als op het display van de receiver, in decibel.",
+  "descVolumeDisplay": "Hetzelfde volume als op het display van de receiver, in de nu ingestelde schaal.",
   "descVolumeDisplayMode": "Of de receiver het volume in decibel of als getal toont.",
   "descAudioSelect": "Van welke aansluiting de huidige ingang zijn geluid neemt: automatisch, HDMI, coaxiaal/optisch of analoog.",
   "descLinkControl": "Weegt stabiliteit tegen vertraging af bij streamen naar gekoppelde apparaten.",

package/admin/i18n/pl.json

@@ -256,6 +256,7 @@
   "volume": "Głośność",
   "descVolume": "Jak głośno gra strefa: dwa protokoły tekstowe podają decybele, MusicCast własne kroki — jednostka mówi, który z nich.",
   "volumeDB": "Głośność (dB)",
+  "volumeDisplay": "Głośność (wyświetlacz)",
   "volumeDisplayMode": "Tryb wyświetlania głośności",
   "volumeInterlock": "Sprzężenie głośności",
   "yncaControlPort": "Port sterowania YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "W sekundach, by dało się liczyć; czytelna forma obok.",
   "descTotalTime": "W sekundach, by dało się liczyć; czytelna forma obok.",
   "descVolumeDB": "Ta sama głośność co na wyświetlaczu amplitunera, w decybelach.",
+  "descVolumeDisplay": "Ta sama głośność co na wyświetlaczu amplitunera, w aktualnie ustawionej skali.",
   "descVolumeDisplayMode": "Czy amplituner pokazuje głośność w decybelach, czy jako liczbę.",
   "descAudioSelect": "Z którego gniazda bieżące wejście pobiera dźwięk: automatycznie, HDMI, koncentryczne/optyczne lub analogowe.",
   "descLinkControl": "Równoważy stabilność i opóźnienie przy przesyłaniu do połączonych urządzeń.",

package/admin/i18n/pt.json

@@ -256,6 +256,7 @@
   "volume": "Volume",
   "descVolume": "Quão alto a zona toca: os dois protocolos de texto dão decibéis, o MusicCast os seus próprios passos — a unidade indica qual.",
   "volumeDB": "Volume (dB)",
+  "volumeDisplay": "Volume (visor)",
   "volumeDisplayMode": "Modo de exibição do volume",
   "volumeInterlock": "Bloqueio de volume",
   "yncaControlPort": "Porta de controlo YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "Em segundos, para poder calcular; a forma legível está ao lado.",
   "descTotalTime": "Em segundos, para poder calcular; a forma legível está ao lado.",
   "descVolumeDB": "O mesmo volume que o visor do recetor mostra, em decibéis.",
+  "descVolumeDisplay": "O mesmo volume que o visor do recetor mostra, na escala atualmente selecionada.",
   "descVolumeDisplayMode": "Se o recetor mostra o volume em decibéis ou como número simples.",
   "descAudioSelect": "De que terminal o som da entrada atual vem: automático, HDMI, coaxial/ótico ou analógico.",
   "descLinkControl": "Equilibra estabilidade e atraso ao transmitir para aparelhos ligados.",

package/admin/i18n/ru.json

@@ -256,6 +256,7 @@
   "volume": "Громкость",
   "descVolume": "Насколько громко играет зона: два текстовых протокола дают децибелы, MusicCast — свои шаги; единица измерения показывает, что именно.",
   "volumeDB": "Громкость (дБ)",
+  "volumeDisplay": "Громкость (дисплей)",
   "volumeDisplayMode": "Режим отображения громкости",
   "volumeInterlock": "Связка громкости",
   "yncaControlPort": "Порт управления YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "В секундах, чтобы с этим можно было считать; читаемая форма рядом.",
   "descTotalTime": "В секундах, чтобы с этим можно было считать; читаемая форма рядом.",
   "descVolumeDB": "Та же громкость, что показывает дисплей ресивера, в децибелах.",
+  "descVolumeDisplay": "Та же громкость, что показывает дисплей ресивера, в текущей выбранной шкале.",
   "descVolumeDisplayMode": "Показывает ли ресивер громкость в децибелах или простым числом.",
   "descAudioSelect": "Звук какого разъёма использует текущий вход: автоматически, HDMI, коаксиальный/оптический или аналоговый.",
   "descLinkControl": "Баланс стабильности и задержки при передаче на связанные устройства.",

package/admin/i18n/uk.json

@@ -256,6 +256,7 @@
   "volume": "Гучність",
   "descVolume": "Наскільки гучно грає зона: два текстові протоколи дають децибели, MusicCast — власні кроки; одиниця показує, що саме.",
   "volumeDB": "Гучність (дБ)",
+  "volumeDisplay": "Гучність (дисплей)",
   "volumeDisplayMode": "Режим показу гучності",
   "volumeInterlock": "Зв'язка гучності",
   "yncaControlPort": "Порт керування YNCA",
@@ -384,6 +385,7 @@
   "descElapsedTime": "У секундах, щоб можна було рахувати; зручна форма поруч.",
   "descTotalTime": "У секундах, щоб можна було рахувати; зручна форма поруч.",
   "descVolumeDB": "Та сама гучність, що на дисплеї ресивера, у децибелах.",
+  "descVolumeDisplay": "Та сама гучність, що на дисплеї ресивера, у поточно вибраній шкалі.",
   "descVolumeDisplayMode": "Чи показує ресивер гучність у децибелах, чи простим числом.",
   "descAudioSelect": "Звук якого роз'єму використовує поточний вхід: автоматично, HDMI, коаксіальний/оптичний чи аналоговий.",
   "descLinkControl": "Баланс стабільності та затримки при передачі на пов'язані пристрої.",

package/admin/i18n/zh-cn.json

@@ -256,6 +256,7 @@
   "volume": "音量",
   "descVolume": "该区域的音量：两种文本协议给出分贝，MusicCast 给出自身的步进值，单位标明是哪一种。",
   "volumeDB": "音量 (dB)",
+  "volumeDisplay": "音量（显示）",
   "volumeDisplayMode": "音量显示方式",
   "volumeInterlock": "音量联动",
   "yncaControlPort": "YNCA 控制端口",
@@ -384,6 +385,7 @@
   "descElapsedTime": "以秒为单位便于计算；易读形式在旁边。",
   "descTotalTime": "以秒为单位便于计算；易读形式在旁边。",
   "descVolumeDB": "与功放显示屏一致的音量，单位分贝。",
+  "descVolumeDisplay": "与功放显示屏一致的音量，采用当前设置的刻度。",
   "descVolumeDisplayMode": "功放以分贝还是普通数字显示音量。",
   "descAudioSelect": "当前输入使用哪个端子的声音：自动、HDMI、同轴/光纤或模拟。",
   "descLinkControl": "向联动设备串流时在稳定性与延迟之间取舍。",

package/build/lib/device-controller.js

@@ -158,6 +158,12 @@ class YncaDeviceController {
   presentSubunits = /* @__PURE__ */ new Set();
   /** The enum values this device ever reported (see OBSERVED_KEY), persisted on every addition. */
   observed = {};
+  /** The (group-filtered) catalog of this connection, for rebuilding objects mid-session. */
+  catalog = [];
+  /** The capability shape the current object tree was built from — grown by pushes and refreshes. */
+  shape = { model: "", subunits: {} };
+  /** Object id → the definition last upserted, so a republish writes only what really changed. */
+  published = /* @__PURE__ */ new Map();
   /**
    * Connect, sweep the device from the catalog, and create its object tree; wire
    * up push updates. The catalog is the single source: it drives the sweep, the
@@ -169,6 +175,7 @@ class YncaDeviceController {
     var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     await this.deps.client.connect();
     const catalog = this.deps.isEntryEnabled ? import_catalog.YNCA_CATALOG.filter((entry) => this.deps.isEntryEnabled(entry.id)) : import_catalog.YNCA_CATALOG;
+    this.catalog = catalog;
     const resolved = await this.resolveCapabilities(catalog);
     const { capabilities, fromCache } = resolved;
     const present = (0, import_catalog.presentYncaEntries)(capabilities, catalog);
@@ -184,6 +191,7 @@ class YncaDeviceController {
     this.recordObservedAll(capabilities);
     this.recordObservedAll(live);
     const evidence = this.inputEvidence(capabilities);
+    this.shape = { model: capabilities.model, subunits: capabilities.subunits };
     const objects = (0, import_catalog.yncaObjectsFor)(capabilities, catalog, this.statesResolver(live, evidence));
     if (objects.length === 0) {
       this.deps.log.warn(`${this.deviceId}: no capabilities reported \u2014 creating no objects`);
@@ -212,7 +220,7 @@ class YncaDeviceController {
       if (titles !== void 0 && titles.length > 0) {
         object.common.states = Object.fromEntries(titles.map((scene) => [scene.num, scene.title]));
       }
-      await this.deps.upsertObject(`${this.deviceId}.${object.id}`, object);
+      await this.upsertTracked(object);
     }
     for (const zone of YNCA_ZONES) {
       const titles = zone.key === "main" ? this.sceneTitles : this.zoneSceneTitles.get(zone.key);
@@ -318,7 +326,8 @@ class YncaDeviceController {
       (_h = this.deps.probeMemory) == null ? void 0 : _h.set(CAPS_KEY, {
         model: capabilities.model,
         firmware: (_g = (_f = capabilities.subunits.SYS) == null ? void 0 : _f.VERSION) != null ? _g : firmware,
-        subunits: capabilities.subunits
+        subunits: capabilities.subunits,
+        complete: true
       });
     } else {
       (_i = this.deps.probeMemory) == null ? void 0 : _i.drop((key) => key === STATIC_KEY);
@@ -372,9 +381,9 @@ class YncaDeviceController {
    * subunits — the answers stream into the states through the live message handler,
    * so current values arrive within the usual sweep time WITHOUT having gated the
    * ready line. Completion refreshes the persisted layers (capabilities, statics)
-   * and the write map; a SHAPE change (a function newly answered) is only persisted —
-   * its object appears on the next start, because the unified tree is coordinated
-   * once per connect and a late upsert would not materialize.
+   * and the write map; a SHAPE change (a function newly answered) is persisted AND published —
+   * since 2.7.0 the objects are rebuilt from the grown shape and the handle re-coordinates the
+   * unified tree, so the datapoint appears in this session instead of one start later.
    *
    * @param catalog the (group-filtered) catalog
    */
@@ -385,7 +394,7 @@ class YncaDeviceController {
       const gets = (0, import_catalog.sweepGets)(catalog).filter(
         (get) => get.subunit === "SYS" || !cached || cached.subunits.includes(get.subunit)
       );
-      const fresh = await this.deps.client.readCapabilities(gets);
+      const fresh = await this.sweepInPasses((0, import_catalog.planSweep)(gets, this.inputEvidence({ model: "", subunits: {} })));
       if (!fresh.model) {
         return;
       }
@@ -403,10 +412,13 @@ class YncaDeviceController {
       (_g = this.deps.probeMemory) == null ? void 0 : _g.set(CAPS_KEY, {
         model: fresh.model,
         firmware: (_f = (_e = fresh.subunits.SYS) == null ? void 0 : _e.VERSION) != null ? _f : "",
-        subunits
+        subunits,
+        complete: true
       });
       this.presentEntries = (0, import_catalog.presentYncaEntries)({ model: fresh.model, subunits }, catalog);
       this.writeMap = (0, import_catalog.idToEntry)(this.presentEntries);
+      this.shape = { model: fresh.model || this.shape.model, subunits };
+      await this.republishObjects();
       const titles = sceneTitlesOf(subunits);
       if (JSON.stringify(titles) !== JSON.stringify(this.sceneTitles)) {
         this.sceneTitles = titles;
@@ -495,9 +507,11 @@ class YncaDeviceController {
       (get) => (get.subunit === "SYS" || present.has(get.subunit)) && !answered.has(`${get.subunit}:${get.func}`)
     );
     const remembered = (_a = this.deps.probeMemory) == null ? void 0 : _a.remembered(STATIC_KEY);
-    const swept = await this.deps.client.readCapabilities(
-      remembered ? gets.filter((get) => !STATIC_FUNC.test(get.func)) : gets
+    const plan = (0, import_catalog.planSweep)(
+      remembered ? gets.filter((get) => !STATIC_FUNC.test(get.func)) : gets,
+      this.inputEvidence(basic)
     );
+    const swept = await this.sweepInPasses(plan);
     const capabilities = {
       model: swept.model || basic.model,
       subunits: (0, import_capability.mergeYncaSubunits)(basic.subunits, swept.subunits)
@@ -519,6 +533,27 @@ class YncaDeviceController {
     (_c = this.deps.probeMemory) == null ? void 0 : _c.set(STATIC_KEY, statics);
     return capabilities;
   }
+  /**
+   * Send a planned sweep: the first pass, then — only for the SYS families whose head answered
+   * in it — the family members (`planSweep`, `SYS_FUNCTION_FAMILIES`). One GET on the head
+   * decides up to 43 GETs of a family a device has as a whole or not at all.
+   *
+   * @param plan the planned GET lists
+   * @returns the merged answers of both passes
+   */
+  async sweepInPasses(plan) {
+    const first = await this.deps.client.readCapabilities(plan.first);
+    const answeredHeads = import_catalog.SYS_FUNCTION_FAMILIES.filter((family) => {
+      var _a;
+      return ((_a = first.subunits.SYS) == null ? void 0 : _a[family.head]) !== void 0;
+    });
+    const second = plan.families.filter((get) => answeredHeads.some((family) => get.func.startsWith(family.prefix)));
+    if (second.length === 0) {
+      return first;
+    }
+    const members = await this.deps.client.readCapabilities(second);
+    return { model: first.model || members.model, subunits: (0, import_capability.mergeYncaSubunits)(first.subunits, members.subunits) };
+  }
   /**
    * Read every bundle of the present subunits (BASIC and SCENENAME per zone, SIGINFO/RDSINFO on
    * the tuner, METAINFO per player — see `bundleGets`) in ONE paced request list; the answers
@@ -591,6 +626,49 @@ class YncaDeviceController {
     }
     list.push(value);
     (_e = this.deps.probeMemory) == null ? void 0 : _e.set(OBSERVED_KEY, this.observed);
+    void this.republishObjects();
+  }
+  /**
+   * Rebuild this transport's objects from the shape it knows now and upsert them. Idempotent by
+   * construction: the transport adapter keeps the last definition per id, so an unchanged object
+   * is neither written nor signalled — only a real change reaches the handle's re-coordination.
+   * Silent before the tree stood (no shape yet) and while nothing is present.
+   */
+  async republishObjects() {
+    if (this.presentEntries.length === 0 || Object.keys(this.shape.subunits).length === 0) {
+      return;
+    }
+    try {
+      const objects = (0, import_catalog.yncaObjectsFor)(
+        this.shape,
+        this.catalog,
+        this.statesResolver(this.shape, this.inputEvidence(this.shape))
+      );
+      for (const object of objects) {
+        const titles = this.sceneTitlesFor(object.id);
+        if (titles !== void 0 && titles.length > 0) {
+          object.common.states = Object.fromEntries(titles.map((scene) => [scene.num, scene.title]));
+        }
+        await this.upsertTracked(object);
+      }
+    } catch (e) {
+      this.deps.log.debug(`${this.deviceId}: could not republish the object tree: ${String(e)}`);
+    }
+  }
+  /**
+   * Upsert an object and remember its definition, so the next republish writes only what really
+   * changed. A device answering a new value republishes the whole tree; without this every one of
+   * ~250 definitions would be handed on, and the handle would re-coordinate for each of them.
+   *
+   * @param object the object definition to write
+   */
+  async upsertTracked(object) {
+    const fingerprint = JSON.stringify(object);
+    if (this.published.get(object.id) === fingerprint) {
+      return;
+    }
+    this.published.set(object.id, fingerprint);
+    await this.deps.upsertObject(`${this.deviceId}.${object.id}`, object);
   }
   /**
    * What this connect learned about the device's inputs: the probe's verdicts (present /