@matter/protocol 0.17.3 → 0.17.4-alpha.0-20260623-5647634fc

package/dist/esm/peer/PeerAddressMonitor.js

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import {
+  Abort,
   ChannelType,
   Diagnostic,
   isIpNetworkChannel,
@@ -14,6 +15,7 @@ import {
 } from "@matter/general";
 import { PeerUnresponsiveError } from "./PeerCommunicationError.js";
 const logger = Logger.get("PeerAddressMonitor");
+const PROBE_MAX_RETRANSMISSIONS = 2;
 class PeerAddressMonitor {
   #peer;
   #abort;
@@ -22,9 +24,8 @@ class PeerAddressMonitor {
   #cooldownMax;
   #trackWork;
   #probing;
-  // Fibonacci backoff state — resets when probed IP changes
+  // Fibonacci backoff state — grows on each successful probe, resets only on a real reachability scare
   #lastProbeAt;
-  #lastProbedIp;
   #fibPrev = 0;
   #fibCurr = 0;
   constructor(peer, stabilizationDelay, probeCooldown, abort, trackWork) {
@@ -34,13 +35,7 @@ class PeerAddressMonitor {
     this.#cooldownMax = probeCooldown.maximum;
     this.#trackWork = trackWork;
     this.#timer = Time.getTimer("address check stabilization", stabilizationDelay, () => {
-      if (!this.#probing) {
-        this.#probing = this.#check().finally(() => {
-          this.#probing = void 0;
-          this.schedule();
-        });
-        this.#trackWork(this.#probing);
-      }
+      this.#trackWork(this.verifyReachability({ reason: "address-change", abort: this.#abort }));
     });
   }
   /**
@@ -59,79 +54,119 @@ class PeerAddressMonitor {
   stop() {
     this.#timer.stop();
   }
-  async #check() {
+  /**
+   * Tear down: stop the timer and await any in-flight run so teardown does not race a probe.  The
+   * caller is expected to have aborted the peer first, so the in-flight run unwinds promptly.
+   */
+  async close() {
+    this.#timer.stop();
+    await this.#probing;
+  }
+  /**
+   * Verify the peer is reachable, driving recovery.  Coalesces concurrent triggers into one run.
+   *
+   * An `address-change` run probes the current address then walks discovered alternates (migrating in
+   * place on success); a `session-suspect` run only probes the current address and never walks alternates.
+   * Returns `true` if the session is usable afterward (current address answered, or an alternate
+   * answered and the session migrated); `false` if no address answered and the session was closed.
+   */
+  async verifyReachability(options) {
+    if (this.#probing === void 0) {
+      this.#probing = this.#run(options.reason).finally(() => {
+        this.#probing = void 0;
+        if (options.reason === "address-change") {
+          this.schedule();
+        }
+      });
+    }
+    const run = this.#probing;
+    return options.abort !== void 0 && options.abort !== this.#abort ? await Abort.race(options.abort, run) ?? false : run;
+  }
+  async #run(reason) {
+    const abort = this.#abort;
     const session = this.#peer.newestSession();
     const interaction = this.#peer.interaction;
     if (!session || !interaction) {
-      return;
+      return false;
     }
     const channel = session.channel.transportChannel;
-    if (!isIpNetworkChannel(channel)) {
-      return;
-    }
-    if (channel.type === ChannelType.TCP) {
-      return;
+    if (!isIpNetworkChannel(channel) || channel.type === ChannelType.TCP) {
+      return true;
     }
     const currentAddress = channel.networkAddress;
-    const currentIp = currentAddress.ip;
     const discoveredAddresses = this.#peer.service.addresses;
-    if (!discoveredAddresses.size) {
-      return;
-    }
-    if (discoveredAddresses.has(currentAddress)) {
-      return;
-    }
-    const via = session.via;
-    if (currentIp !== this.#lastProbedIp) {
+    if (reason === "session-suspect") {
       this.#resetBackoff();
     }
-    const lastKnownGood = Timestamp(Math.max(this.#lastProbeAt ?? 0, session.activeTimestamp));
-    const cooldown = this.#currentCooldown;
-    if (lastKnownGood > 0 && Timestamp.delta(lastKnownGood) < cooldown) {
-      return;
+    if (reason === "address-change") {
+      const stillDiscovered = [...discoveredAddresses].some((addr) => ServerAddress.isEqual(addr, currentAddress));
+      if (!discoveredAddresses.size || stillDiscovered) {
+        return true;
+      }
+      const lastKnownGood = Timestamp(Math.max(this.#lastProbeAt ?? 0, session.activeTimestamp));
+      if (lastKnownGood > 0 && Timestamp.delta(lastKnownGood) < this.#currentCooldown) {
+        return true;
+      }
+      logger.info(
+        session.via,
+        "Session address",
+        Diagnostic.strong(ServerAddress.urlFor(currentAddress)),
+        "no longer in mDNS results, probing"
+      );
+      this.#lastProbeAt = Time.nowMs;
     }
-    logger.info(
-      via,
-      "Session address",
-      Diagnostic.strong(ServerAddress.urlFor(currentAddress)),
-      "no longer in mDNS results, probing"
-    );
-    this.#lastProbeAt = Time.nowMs;
-    this.#lastProbedIp = currentIp;
     const network = this.#peer.network;
     const probeNetwork = network.probeAddress ?? network;
-    if (await interaction.probe({ network: probeNetwork.id, abort: this.#abort, suppressPeerLoss: true })) {
-      this.#advanceBackoff();
-      return;
-    }
-    for (const ipAddress of discoveredAddresses) {
-      if (this.#abort.aborted) {
-        return;
+    if (await interaction.probe({
+      network: probeNetwork.id,
+      abort,
+      suppressPeerLoss: true,
+      maxRetransmissions: PROBE_MAX_RETRANSMISSIONS
+    })) {
+      if (reason === "address-change") {
+        this.#advanceBackoff();
       }
-      const address = { ...ipAddress, type: "udp" };
-      if (await interaction.probe({
-        network: probeNetwork.id,
-        abort: this.#abort,
-        addressOverride: address,
-        suppressPeerLoss: true
-      })) {
-        logger.info(
-          via,
-          "Discovered address reachable, migrating session to",
-          Diagnostic.strong(ServerAddress.urlFor(address))
-        );
-        session.channel.networkAddress = address;
-        interaction.subscriptions.closeForPeer(this.#peer.address);
-        this.#resetBackoff();
-        return;
+      return true;
+    }
+    if (reason === "address-change") {
+      for (const ipAddress of discoveredAddresses) {
+        if (abort.aborted) {
+          return false;
+        }
+        if (ServerAddress.isEqual(ipAddress, currentAddress)) {
+          continue;
+        }
+        const address = { ...ipAddress, type: "udp" };
+        if (await interaction.probe({
+          network: probeNetwork.id,
+          abort,
+          addressOverride: address,
+          suppressPeerLoss: true,
+          maxRetransmissions: PROBE_MAX_RETRANSMISSIONS
+        })) {
+          logger.info(
+            session.via,
+            "Discovered address reachable, migrating session to",
+            Diagnostic.strong(ServerAddress.urlFor(address))
+          );
+          session.channel.networkAddress = address;
+          interaction.subscriptions.closeForPeer(this.#peer.address);
+          this.#resetBackoff();
+          return true;
+        }
       }
+      this.#resetBackoff();
     }
-    this.#resetBackoff();
-    if (this.#abort.aborted) {
-      return;
+    if (abort.aborted) {
+      return false;
+    }
+    logger.info(session.via, "All probes failed, closing session");
+    try {
+      await session.handlePeerLoss({ cause: new PeerUnresponsiveError() });
+    } catch (error) {
+      logger.warn(session.via, "Error closing unreachable session", error);
     }
-    logger.info(via, "All probes failed, closing session");
-    await session.handlePeerLoss({ cause: new PeerUnresponsiveError() });
+    return false;
   }
   /** Current cooldown duration based on Fibonacci position. */
   get #currentCooldown() {

package/dist/esm/peer/PeerAddressMonitor.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/peer/PeerAddressMonitor.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/esm/peer/PeerExchangeProvider.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { PeerAddress } from "#peer/PeerAddress.js";
-import { ExchangeProvider, NewExchangeOptions } from "#protocol/ExchangeProvider.js";
+import { ExchangeProvider, NewExchangeOptions, type ReachabilityReason } from "#protocol/ExchangeProvider.js";
 import type { MessageExchange } from "#protocol/MessageExchange.js";
 import { ChannelType, Duration } from "@matter/general";
 import { Peer } from "./Peer.js";
@@ -23,6 +23,10 @@ export declare class PeerExchangeProvider extends ExchangeProvider {
      */
     get channelType(): ChannelType;
     connect(options?: NewExchangeOptions): Promise<void>;
+    verifyReachability(options: {
+        reason: ReachabilityReason;
+        abort?: AbortSignal;
+    }): Promise<boolean>;
     initiateExchange(options?: NewExchangeOptions): Promise<MessageExchange>;
     maximumPeerResponseTime(expectedProcessingTime?: Duration, includeMaximumSendingTime?: boolean): Duration;
 }

package/dist/esm/peer/PeerExchangeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;;IAItD,YAAY,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAKtD;IAED,IAAI,iBAAiB,WAEpB;IAED,IAAI,WAAW,gBAEd;IAED;;;OAGG;IACH,IAAI,WAAW,gBAMd;IAEc,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;IAEc,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwEtF;IAEQ,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAQjH;CACJ"}
+{"version":3,"file":"PeerExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC9G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;;IAItD,YAAY,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAKtD;IAED,IAAI,iBAAiB,WAEpB;IAED,IAAI,WAAW,gBAEd;IAED;;;OAGG;IACH,IAAI,WAAW,gBAMd;IAEc,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE;IAEQ,kBAAkB,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1G;IAEc,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwEtF;IAEQ,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAQjH;CACJ"}

package/dist/esm/peer/PeerExchangeProvider.js

@@ -44,6 +44,9 @@ class PeerExchangeProvider extends ExchangeProvider {
       preferredTransport: options?.preferredTransport
     });
   }
+  verifyReachability(options) {
+    return this.#peer.verifyReachability(options);
+  }
   async initiateExchange(options) {
     const abort = options?.abort;
     const isGroup = PeerAddress.isGroup(this.#peer.address);

package/dist/esm/peer/PeerExchangeProvider.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/peer/PeerExchangeProvider.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

package/dist/esm/peer/PeerTimingParameters.d.ts

@@ -91,11 +91,11 @@ export interface PeerTimingParameters {
      */
     addressChangeStabilizationDelay: Duration;
     /**
-     * Probe cooldown range for address-change probes on the same IP.
+     * Probe cooldown range for address-change probes.
      *
      * When mDNS keeps reporting the session IP as gone but probes succeed, the cooldown grows
      * using a Fibonacci-like sequence from {@link minimum} to {@link maximum}.  The cooldown
-     * resets when the probed IP changes or a probe fails.
+     * resets on a probe failure or a subscription-liveness scare, not on a mere address change.
      *
      * Probes are also suppressed while the session is actively receiving data — the cooldown
      * is measured from whichever is more recent: the last probe or the last received message.

package/dist/esm/peer/PeerTimingParameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerTimingParameters.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerTimingParameters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAmD,MAAM,iBAAiB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,wBAAwB,EAAE,QAAQ,CAAC;IAEnC;;;;OAIG;IACH,oCAAoC,EAAE,QAAQ,CAAC;IAE/C;;;;OAIG;IACH,sBAAsB,EAAE,QAAQ,CAAC;IAEjC;;;;;;;OAOG;IACH,sBAAsB,EAAE,QAAQ,CAAC;IAEjC;;;;OAIG;IACH,mBAAmB,EAAE,QAAQ,CAAC;IAE9B;;;;OAIG;IACH,wBAAwB,EAAE,QAAQ,CAAC;IAEnC;;;;;OAKG;IACH,oBAAoB,EAAE,QAAQ,CAAC;IAE/B;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,oBAAoB,EAAE,QAAQ,CAAC;IAE/B;;;;;OAKG;IACH,mBAAmB,EAAE;QACjB,mEAAmE;QACnE,aAAa,EAAE,QAAQ,CAAC;QAExB,gFAAgF;QAChF,OAAO,EAAE,QAAQ,CAAC;KACrB,CAAC;IAEF;;;;;OAKG;IACH,+BAA+B,EAAE,QAAQ,CAAC;IAE1C;;;;;;;;;OASG;IACH,0BAA0B,EAAE;QACxB,wEAAwE;QACxE,OAAO,EAAE,QAAQ,CAAC;QAElB,wDAAwD;QACxD,OAAO,EAAE,QAAQ,CAAC;KACrB,CAAC;CACL;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,wBAiB3E;AAED,yBAAiB,oBAAoB,CAAC,CAAC;IACnC;;;;;OAKG;IACH,SAAgB,KAAK,CAAC,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAIhH;IAKM,MAAM,QAAQ,EAAE,oBAsBtB,CAAC;CACL"}
+{"version":3,"file":"PeerTimingParameters.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerTimingParameters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAA0D,MAAM,iBAAiB,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,wBAAwB,EAAE,QAAQ,CAAC;IAEnC;;;;OAIG;IACH,oCAAoC,EAAE,QAAQ,CAAC;IAE/C;;;;OAIG;IACH,sBAAsB,EAAE,QAAQ,CAAC;IAEjC;;;;;;;OAOG;IACH,sBAAsB,EAAE,QAAQ,CAAC;IAEjC;;;;OAIG;IACH,mBAAmB,EAAE,QAAQ,CAAC;IAE9B;;;;OAIG;IACH,wBAAwB,EAAE,QAAQ,CAAC;IAEnC;;;;;OAKG;IACH,oBAAoB,EAAE,QAAQ,CAAC;IAE/B;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,CAAC;IAE/B;;;;;;;OAOG;IACH,oBAAoB,EAAE,QAAQ,CAAC;IAE/B;;;;;OAKG;IACH,mBAAmB,EAAE;QACjB,mEAAmE;QACnE,aAAa,EAAE,QAAQ,CAAC;QAExB,gFAAgF;QAChF,OAAO,EAAE,QAAQ,CAAC;KACrB,CAAC;IAEF;;;;;OAKG;IACH,+BAA+B,EAAE,QAAQ,CAAC;IAE1C;;;;;;;;;OASG;IACH,0BAA0B,EAAE;QACxB,wEAAwE;QACxE,OAAO,EAAE,QAAQ,CAAC;QAElB,wDAAwD;QACxD,OAAO,EAAE,QAAQ,CAAC;KACrB,CAAC;CACL;AAQD,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,wBAiB3E;AAED,yBAAiB,oBAAoB,CAAC,CAAC;IACnC;;;;;OAKG;IACH,SAAgB,KAAK,CAAC,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,CAIhH;IAKM,MAAM,QAAQ,EAAE,oBAsBtB,CAAC;CACL"}

package/dist/esm/peer/PeerTimingParameters.js

@@ -3,7 +3,7 @@
  * Copyright 2022-2026 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { merge as mergeObjects, Millis, Minutes, Seconds } from "@matter/general";
+import { Hours, merge as mergeObjects, Millis, Minutes, Seconds } from "@matter/general";
 const complete = /* @__PURE__ */ Symbol("complete-timing-parameters");
 function PeerTimingParameters(options) {
   if (options && options[complete]) {
@@ -47,8 +47,8 @@ function PeerTimingParameters(options) {
     },
     addressChangeStabilizationDelay: Seconds(10),
     addressChangeProbeCooldown: {
-      minimum: Minutes(2),
-      maximum: Minutes(60)
+      minimum: Minutes(10),
+      maximum: Hours(24)
     }
   };
 })(PeerTimingParameters || (PeerTimingParameters = {}));

package/dist/esm/peer/PeerTimingParameters.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/peer/PeerTimingParameters.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAmB,SAAS,cAAc,QAAQ,SAAS,eAAe;AAuH1E,MAAM,WAAW,uBAAO,4BAA4B;AAM7C,SAAS,qBAAqB,SAAyC;AAC1E,MAAI,WAAY,QAAqB,QAAQ,GAAG;AAC5C,WAAO;AAAA,EACX;AAEA,QAAM,SAAS,EAAE,GAAG,qBAAqB,SAAS;AAClD,MAAI,SAAS;AACT,eAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACpC,YAAM,QAAS,QAAoC,GAAG;AACtD,UAAI,UAAU,QAAW;AACrB,eAAO,GAAG,IAAI;AAAA,MAClB;AAAA,IACJ;AAAA,EACJ;AACA,SAAO,QAAQ,IAAI;AAEnB,SAAO;AACX;AAAA,CAEO,CAAUA,0BAAV;AAOI,WAAS,MAAM,MAA4B,WAAgE;AAC9G,UAAM,SAAS,aAAa,MAAM,SAAS;AAC3C,WAAO,QAAQ,IAAI;AACnB,WAAO;AAAA,EACX;AAJO,EAAAA,sBAAS;AAMhB,QAAM,iCAAiC,QAAQ,CAAC;AAGzC,EAAMA,sBAAA,WAAiC;AAAA,IAC1C,0BAA0B,QAAQ,EAAE;AAAA,IACpC,sCAAsC;AAAA;AAAA;AAAA,IAItC,wBAAwB,QAAQ,EAAE;AAAA,IAClC,wBAAwB,QAAQ,EAAE;AAAA,IAClC,qBAAqB,QAAQ,CAAC;AAAA,IAC9B,0BAA0B,QAAQ,CAAC;AAAA,IACnC,sBAAsB,QAAQ,CAAC;AAAA,IAC/B,wBAAwB;AAAA,IACxB,sBAAsB,OAAO,iCAAiC,CAAC;AAAA,IAC/D,qBAAqB;AAAA,MACjB,eAAe,QAAQ,EAAE;AAAA,MACzB,SAAS,QAAQ,EAAE;AAAA,IACvB;AAAA,IACA,iCAAiC,QAAQ,EAAE;AAAA,IAC3C,4BAA4B;AAAA,MACxB,SAAS,QAAQ,CAAC;AAAA,MAClB,SAAS,QAAQ,EAAE;AAAA,IACvB;AAAA,EACJ;AAAA,GAtCa;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAmB,OAAO,SAAS,cAAc,QAAQ,SAAS,eAAe;AAuHjF,MAAM,WAAW,uBAAO,4BAA4B;AAM7C,SAAS,qBAAqB,SAAyC;AAC1E,MAAI,WAAY,QAAqB,QAAQ,GAAG;AAC5C,WAAO;AAAA,EACX;AAEA,QAAM,SAAS,EAAE,GAAG,qBAAqB,SAAS;AAClD,MAAI,SAAS;AACT,eAAW,OAAO,OAAO,KAAK,OAAO,GAAG;AACpC,YAAM,QAAS,QAAoC,GAAG;AACtD,UAAI,UAAU,QAAW;AACrB,eAAO,GAAG,IAAI;AAAA,MAClB;AAAA,IACJ;AAAA,EACJ;AACA,SAAO,QAAQ,IAAI;AAEnB,SAAO;AACX;AAAA,CAEO,CAAUA,0BAAV;AAOI,WAAS,MAAM,MAA4B,WAAgE;AAC9G,UAAM,SAAS,aAAa,MAAM,SAAS;AAC3C,WAAO,QAAQ,IAAI;AACnB,WAAO;AAAA,EACX;AAJO,EAAAA,sBAAS;AAMhB,QAAM,iCAAiC,QAAQ,CAAC;AAGzC,EAAMA,sBAAA,WAAiC;AAAA,IAC1C,0BAA0B,QAAQ,EAAE;AAAA,IACpC,sCAAsC;AAAA;AAAA;AAAA,IAItC,wBAAwB,QAAQ,EAAE;AAAA,IAClC,wBAAwB,QAAQ,EAAE;AAAA,IAClC,qBAAqB,QAAQ,CAAC;AAAA,IAC9B,0BAA0B,QAAQ,CAAC;AAAA,IACnC,sBAAsB,QAAQ,CAAC;AAAA,IAC/B,wBAAwB;AAAA,IACxB,sBAAsB,OAAO,iCAAiC,CAAC;AAAA,IAC/D,qBAAqB;AAAA,MACjB,eAAe,QAAQ,EAAE;AAAA,MACzB,SAAS,QAAQ,EAAE;AAAA,IACvB;AAAA,IACA,iCAAiC,QAAQ,EAAE;AAAA,IAC3C,4BAA4B;AAAA,MACxB,SAAS,QAAQ,EAAE;AAAA,MACnB,SAAS,MAAM,EAAE;AAAA,IACrB;AAAA,EACJ;AAAA,GAtCa;",
   "names": ["PeerTimingParameters"]
 }

package/dist/esm/protocol/ExchangeProvider.d.ts

@@ -50,6 +50,8 @@ export interface NewExchangeOptions extends Omit<InteractionSettings, "transacti
      */
     preferredTransport?: ChannelType;
 }
+/** Why a reachability check was requested. Gates entry conditions, not the probe mechanics. */
+export type ReachabilityReason = "address-change" | "session-suspect";
 /**
  * Interface for obtaining a message exchange with a specific peer.
  */
@@ -74,6 +76,15 @@ export declare abstract class ExchangeProvider {
      * The default implementation is a no-op (already connected).
      */
     connect(_options?: NewExchangeOptions): Promise<void>;
+    /**
+     * Verify the peer is reachable, driving recovery (alternate-address migration or session close).
+     *
+     * The default reports reachable; only peer-backed providers have a reachability authority and override this.
+     */
+    verifyReachability(_options: {
+        reason: ReachabilityReason;
+        abort?: AbortSignal;
+    }): Promise<boolean>;
 }
 /**
  * Manages an exchange over an established channel.

package/dist/esm/protocol/ExchangeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/protocol/ExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAChF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC;CACpC;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IACtB,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,eAAe;IAA/D,YAA+B,eAAe,EAAE,eAAe,EAAI;IAEnE,QAAQ,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACnH,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE7C;;;;;OAKG;IACH,IAAI,OAAO,IAAI,aAAa,GAAG,SAAS,CAEvC;IAED;;;;OAIG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAG;CACjE;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,gBAAgB;;IAGlE,YAAY,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAGnE;IAED,IAAI,iBAAiB,WAEpB;IAEK,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAM7E;IAED,IAAI,WAAW,gBAEd;IAED,IAAa,OAAO,kBAEnB;IAED,uBAAuB,CACnB,sBAAsB,WAAuC,EAC7D,yBAAyB,CAAC,EAAE,OAAO,YAOtC;IAED,IAAI,WAAW;;;kBAId;CACJ"}
+{"version":3,"file":"ExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/protocol/ExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAChF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAE9B;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC;CACpC;AAED,+FAA+F;AAC/F,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAEtE;;GAEG;AACH,8BAAsB,gBAAgB;IACtB,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,eAAe;IAA/D,YAA+B,eAAe,EAAE,eAAe,EAAI;IAEnE,QAAQ,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACnH,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE7C;;;;;OAKG;IACH,IAAI,OAAO,IAAI,aAAa,GAAG,SAAS,CAEvC;IAED;;;;OAIG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAG;IAE9D;;;;OAIG;IACG,kBAAkB,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAExG;CACJ;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,gBAAgB;;IAGlE,YAAY,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAGnE;IAED,IAAI,iBAAiB,WAEpB;IAEK,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAM7E;IAED,IAAI,WAAW,gBAEd;IAED,IAAa,OAAO,kBAEnB;IAED,uBAAuB,CACnB,sBAAsB,WAAuC,EAC7D,yBAAyB,CAAC,EAAE,OAAO,YAOtC;IAED,IAAI,WAAW;;;kBAId;CACJ"}

package/dist/esm/protocol/ExchangeProvider.js

@@ -27,6 +27,14 @@ class ExchangeProvider {
    */
   async connect(_options) {
   }
+  /**
+   * Verify the peer is reachable, driving recovery (alternate-address migration or session close).
+   *
+   * The default reports reachable; only peer-backed providers have a reachability authority and override this.
+   */
+  async verifyReachability(_options) {
+    return true;
+  }
 }
 class DedicatedChannelExchangeProvider extends ExchangeProvider {
   #session;

package/dist/esm/protocol/ExchangeProvider.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/protocol/ExchangeProvider.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AASA,SAAS,mBAAmB;AAG5B,SAAS,+BAA+B;AACxC,SAAS,WAAW;AAqDb,MAAe,iBAAiB;AAAA,EACnC,YAA+B,iBAAkC;AAAlC;AAAA,EAAmC;AAAA,EAAnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc/B,IAAI,UAAqC;AACrC,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ,UAA8C;AAAA,EAAC;AACjE;AAKO,MAAM,yCAAyC,iBAAiB;AAAA,EACnE;AAAA,EAEA,YAAY,iBAAkC,SAAwB;AAClE,UAAM,eAAe;AACrB,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,IAAI,oBAAoB;AACpB,WAAO,KAAK,SAAS,WAAW;AAAA,EACpC;AAAA,EAEA,MAAM,iBAAiB,SAAwD;AAG3E,WAAO,KAAK,gBAAgB,2BAA2B,KAAK,UAAU,yBAAyB;AAAA,MAC3F,wBAAwB,SAAS;AAAA,IACrC,CAAC;AAAA,EACL;AAAA,EAEA,IAAI,cAAc;AACd,WAAO,KAAK,SAAS,QAAQ,iBAAiB;AAAA,EAClD;AAAA,EAEA,IAAa,UAAU;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,wBACI,yBAAyB,IAAI,kCAC7B,2BACF;AACE,WAAO,KAAK,gBAAgB;AAAA,MACxB,KAAK;AAAA,MACL;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,IAAI,cAAc;AACd,QAAI,YAAY,GAAG,KAAK,QAAQ,GAAG;AAC/B,aAAO,KAAK,SAAS;AAAA,IACzB;AAAA,EACJ;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AASA,SAAS,mBAAmB;AAG5B,SAAS,+BAA+B;AACxC,SAAS,WAAW;AAwDb,MAAe,iBAAiB;AAAA,EACnC,YAA+B,iBAAkC;AAAlC;AAAA,EAAmC;AAAA,EAAnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAc/B,IAAI,UAAqC;AACrC,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,QAAQ,UAA8C;AAAA,EAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7D,MAAM,mBAAmB,UAAiF;AACtG,WAAO;AAAA,EACX;AACJ;AAKO,MAAM,yCAAyC,iBAAiB;AAAA,EACnE;AAAA,EAEA,YAAY,iBAAkC,SAAwB;AAClE,UAAM,eAAe;AACrB,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,IAAI,oBAAoB;AACpB,WAAO,KAAK,SAAS,WAAW;AAAA,EACpC;AAAA,EAEA,MAAM,iBAAiB,SAAwD;AAG3E,WAAO,KAAK,gBAAgB,2BAA2B,KAAK,UAAU,yBAAyB;AAAA,MAC3F,wBAAwB,SAAS;AAAA,IACrC,CAAC;AAAA,EACL;AAAA,EAEA,IAAI,cAAc;AACd,WAAO,KAAK,SAAS,QAAQ,iBAAiB;AAAA,EAClD;AAAA,EAEA,IAAa,UAAU;AACnB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,wBACI,yBAAyB,IAAI,kCAC7B,2BACF;AACE,WAAO,KAAK,gBAAgB;AAAA,MACxB,KAAK;AAAA,MACL;AAAA,MACA;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,IAAI,cAAc;AACd,QAAI,YAAY,GAAG,KAAK,QAAQ,GAAG;AAC/B,aAAO,KAAK,SAAS;AAAA,IACzB;AAAA,EACJ;AACJ;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/protocol",
-    "version": "0.17.3",
+    "version": "0.17.4-alpha.0-20260623-5647634fc",
     "description": "Low-level APIs for Matter interaction",
     "keywords": [
         "iot",
@@ -35,12 +35,12 @@
         "#*": "./src/*"
     },
     "dependencies": {
-        "@matter/general": "0.17.3",
-        "@matter/model": "0.17.3",
-        "@matter/types": "0.17.3"
+        "@matter/general": "0.17.4-alpha.0-20260623-5647634fc",
+        "@matter/model": "0.17.4-alpha.0-20260623-5647634fc",
+        "@matter/types": "0.17.4-alpha.0-20260623-5647634fc"
     },
     "devDependencies": {
-        "@matter/testing": "0.17.3"
+        "@matter/testing": "0.17.4-alpha.0-20260623-5647634fc"
     },
     "files": [
         "dist/**/*",

package/src/action/client/ClientInteraction.ts

@@ -299,6 +299,7 @@ export class ClientInteraction<
             await messenger.sendReadRequest(Read({ fabricFilter: false }), {
                 abort,
                 suppressPeerLoss: options?.suppressPeerLoss,
+                maxRetransmissions: options?.maxRetransmissions,
             });
             for await (const _report of messenger.readDataReports({ abort }));
             logger.info(
@@ -968,12 +969,11 @@ export class ClientInteraction<
                 abort: session?.abort,
                 retries: this.#sustainRetries,
                 read,
-                // TCP has 1:1 session-connection binding plus OS keep-alive — the session is
-                // evicted when the connection drops, so no liveness probe is needed.
                 probe: abort =>
                     this.#exchangeProvider.channelType === ChannelType.TCP
-                        ? Promise.resolve(true)
-                        : this.probe({ abort }),
+                        ? // TCP evicts the session when its connection drops, so no liveness probe is needed.
+                          Promise.resolve(true)
+                        : this.#exchangeProvider.verifyReachability({ reason: "session-suspect", abort }),
             });
         } else {
             subscription = await subscribe(request);
@@ -1143,6 +1143,9 @@ export interface ClientProbeOptions {
 
     /** Suppress peer-loss reporting so the session stays alive even if the probe fails. */
     suppressPeerLoss?: boolean;
+
+    /** Cap MRP transmission attempts for this probe (default: MRP.MAX_TRANSMISSIONS). */
+    maxRetransmissions?: number;
 }
 
 async function* readChunks(messenger: InteractionClientMessenger, abort: Abort) {

package/src/peer/Peer.ts

@@ -9,7 +9,7 @@ import type { NodeProtocol } from "#action/protocols.js";
 import { DiscoveryData } from "#common/Scanner.js";
 import { getOperationalDeviceQname } from "#mdns/MdnsConsts.js";
 import { PeerAddress } from "#peer/PeerAddress.js";
-import type { ExchangeProvider } from "#protocol/ExchangeProvider.js";
+import type { ExchangeProvider, ReachabilityReason } from "#protocol/ExchangeProvider.js";
 import type { NodeSession } from "#session/NodeSession.js";
 import { SessionParameters } from "#session/SessionParameters.js";
 import {
@@ -142,7 +142,8 @@ export class Peer {
                         }
                     } else {
                         tagUdp(channel.networkAddress);
-                        channel.networkAddressChanged.on(tagUdp);
+                        // MessageChannel.networkAddressChanged survives socket swaps; the transport channel's does not.
+                        session.channel.networkAddressChanged.on(tagUdp);
                     }
                 }
             }
@@ -150,9 +151,8 @@ export class Peer {
             // Remove session and detach listener when destroyed
             session.closing.on(() => {
                 this.#sessions.delete(session);
-                const channel = session.channel.transportChannel;
-                if (isIpNetworkChannel(channel)) {
-                    channel.networkAddressChanged.off(tagUdp);
+                if (isIpNetworkChannel(session.channel.transportChannel)) {
+                    session.channel.networkAddressChanged.off(tagUdp);
                 }
             });
 
@@ -488,11 +488,11 @@ export class Peer {
 
         this.#observers.close();
 
-        // Cancel pending address check
-        this.#addressMonitor?.stop();
-
         this.#abort(new ClosedError("Peer closed"));
 
+        // Stop the address monitor and await any in-flight reachability run (the abort above makes it unwind).
+        await this.#addressMonitor?.close();
+
         for (const session of this.#context.sessions.sessionsFor(this.address)) {
             await session.initiateClose();
         }
@@ -552,6 +552,18 @@ export class Peer {
         return this.#addressMonitor;
     }
 
+    /**
+     * Verify this peer is reachable, driving recovery via the address monitor.
+     *
+     * Returns `true` if the session is usable afterward, `false` if it was closed.
+     */
+    async verifyReachability(options: { reason: ReachabilityReason; abort?: AbortSignal }): Promise<boolean> {
+        if (!this.hasSession) {
+            return false;
+        }
+        return this.#addressCheck.verifyReachability(options);
+    }
+
     #initiateConnection(options?: Peer.ConnectOptions) {
         if (this.#connecting) {
             if (options?.kick) {