@matter/node 0.16.0-alpha.0-20251023-bb23617e5 → 0.16.0-alpha.0-20251029-bd92894d4

package/src/behaviors/actions/ActionsInterface.ts

@@ -12,6 +12,8 @@ import { Actions } from "#clusters/actions";
 export namespace ActionsInterface {
     export interface Base {
         /**
+         * This command is used to trigger an instantaneous action.
+         *
          * This command triggers an action (state change) on the involved endpoints, in a "fire and forget" manner.
          * Afterwards, the action’s state shall be Inactive.
          *
@@ -22,6 +24,8 @@ export namespace ActionsInterface {
         instantAction(request: Actions.InstantActionRequest): MaybePromise;
 
         /**
+         * This command is used to trigger an instantaneous action with a transition over a given time.
+         *
          * It is recommended that, where possible (e.g., it is not possible for attributes with Boolean data type), a
          * gradual transition SHOULD take place from the old to the new state over this time period. However, the exact
          * transition is manufacturer dependent.
@@ -37,6 +41,8 @@ export namespace ActionsInterface {
         instantActionWithTransition(request: Actions.InstantActionWithTransitionRequest): MaybePromise;
 
         /**
+         * This command is used to trigger the commencement of an action.
+         *
          * This command triggers the commencement of an action on the involved endpoints. Afterwards, the action’s state
          * shall be Active.
          *
@@ -51,6 +57,8 @@ export namespace ActionsInterface {
         startAction(request: Actions.StartActionRequest): MaybePromise;
 
         /**
+         * This command is used to trigger the commencement of an action with a duration.
+         *
          * This command triggers the commencement of an action on the involved endpoints, and shall change the action’s
          * state to Active. After the specified Duration, the action will stop, and the action’s state shall change to
          * Inactive.
@@ -63,6 +71,8 @@ export namespace ActionsInterface {
         startActionWithDuration(request: Actions.StartActionWithDurationRequest): MaybePromise;
 
         /**
+         * This command is used to stop an action.
+         *
          * This command stops the ongoing action on the involved endpoints. Afterwards, the action’s state shall be
          * Inactive.
          *
@@ -73,6 +83,8 @@ export namespace ActionsInterface {
         stopAction(request: Actions.StopActionRequest): MaybePromise;
 
         /**
+         * This command is used to pause an action.
+         *
          * This command pauses an ongoing action, and shall change the action’s state to Paused.
          *
          * Example: pause a dynamic lighting effect (the lights stay at their current color) which was previously
@@ -83,6 +95,8 @@ export namespace ActionsInterface {
         pauseAction(request: Actions.PauseActionRequest): MaybePromise;
 
         /**
+         * This command is used to pause an action with a duration.
+         *
          * This command pauses an ongoing action, and shall change the action’s state to Paused. After the specified
          * Duration, the ongoing action will be automatically resumed. which shall change the action’s state to Active.
          *
@@ -100,6 +114,8 @@ export namespace ActionsInterface {
         pauseActionWithDuration(request: Actions.PauseActionWithDurationRequest): MaybePromise;
 
         /**
+         * This command is used to resume an action.
+         *
          * This command resumes a previously paused action, and shall change the action’s state to Active.
          *
          * The difference between ResumeAction and StartAction is that ResumeAction will continue the action from the
@@ -113,6 +129,8 @@ export namespace ActionsInterface {
         resumeAction(request: Actions.ResumeActionRequest): MaybePromise;
 
         /**
+         * This command is used to enable an action.
+         *
          * This command enables a certain action or automation. Afterwards, the action’s state shall be Active.
          *
          * Example: enable a motion sensor to control the lights in an area.
@@ -122,6 +140,8 @@ export namespace ActionsInterface {
         enableAction(request: Actions.EnableActionRequest): MaybePromise;
 
         /**
+         * This command is used to enable an action with a duration.
+         *
          * This command enables a certain action or automation, and shall change the action’s state to be Active. After
          * the specified Duration, the action or automation will stop, and the action’s state shall change to Disabled.
          *
@@ -134,6 +154,8 @@ export namespace ActionsInterface {
         enableActionWithDuration(request: Actions.EnableActionWithDurationRequest): MaybePromise;
 
         /**
+         * This command is used to disable an action.
+         *
          * This command disables a certain action or automation, and shall change the action’s state to Inactive.
          *
          * Example: disable a motion sensor to no longer control the lights in an area.
@@ -143,9 +165,12 @@ export namespace ActionsInterface {
         disableAction(request: Actions.DisableActionRequest): MaybePromise;
 
         /**
+         * This command is used to disable an action with a duration.
+         *
          * This command disables a certain action or automation, and shall change the action’s state to Disabled. After
          * the specified Duration, the action or automation will re-start, and the action’s state shall change to either
-         * Inactive or Active, depending on the actions (see examples 4 and 6).
+         * Inactive or Active, depending on the actions (see Section 9.14.8.4, “Example 4: Wake-up routine” and Section
+         * 9.14.8.6, “Example 6: Alarm system”).
          *
          * Example: disable a "wakeup" experience for a period of 1 week when going on holiday (to prevent them from
          * turning on in the morning while you’re not at home). After this period, the wakeup experience will control

package/src/behaviors/application-launcher/ApplicationLauncherInterface.ts

@@ -60,7 +60,9 @@ export namespace ApplicationLauncherInterface {
          * constraints if any. The Status attribute shall be updated to ActiveHidden or Stopped, depending on the action
          * taken, on the Application Basic cluster of the Endpoint corresponding to the application on which the action
          * was taken. The Status attribute shall be updated on any other application whose Status may have changed as a
-         * result of this command. This command returns a Launcher Response.
+         * result of this command.
+         *
+         * This command returns a Launcher Response.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.4.7.3
          */

package/src/behaviors/channel/ChannelInterface.ts

@@ -22,6 +22,10 @@ export namespace ChannelInterface {
          * This command provides channel up and channel down functionality, but allows channel index jumps of size
          * Count.
          *
+         * Jumps are relative to the available list of channels. For example, when the current channel is 100.0 and the
+         * list of available channels is [100.0, 200.0, 201.0, 305.1], a SkipChannel command with jump value of 2 shall
+         * change the channel to 201.0.
+         *
          * When the value of the increase or decrease is larger than the number of channels remaining in the given
          * direction, then the behavior shall be to return to the beginning (or end) of the channel list and continue.
          * For example, if the current channel is at index 0 and count value of -1 is given, then the current channel

package/src/behaviors/color-control/ColorControlInterface.ts

@@ -131,6 +131,10 @@ export namespace ColorControlInterface {
         /**
          * This command is provided to allow MoveTo and Step commands to be stopped.
          *
+         * NOTE This automatically provides symmetry to the Level Control cluster.
+         *
+         * NOTE The StopMoveStep command has no effect on an active color loop.
+         *
          * @see {@link MatterSpecification.v141.Cluster} § 3.2.8.20
          */
         stopMoveStep(request: ColorControl.StopMoveStepRequest): MaybePromise;

package/src/behaviors/color-control/ColorControlServer.ts

@@ -216,11 +216,7 @@ export class ColorControlBaseServer extends ColorControlBase {
      * Sets the current color temperature value in Mireds (0..0xFFFF) and converts into Matter number range.
      */
     set mireds(value: number) {
-        this.state.colorTemperatureMireds = cropValueRange(
-            value,
-            this.minimumColorTemperatureMireds,
-            this.maximumColorTemperatureMireds,
-        );
+        this.state.colorTemperatureMireds = this.#cropColorTemperature(value);
     }
 
     /** Returns the current color temperature value in Kelvin (from internal Mireds). */
@@ -380,7 +376,7 @@ export class ColorControlBaseServer extends ColorControlBase {
             let targetMiredsValue: number | null;
             switch (startUpMiredsValue) {
                 case null:
-                    targetMiredsValue = currentMiredsValue;
+                    targetMiredsValue = this.#cropColorTemperature(currentMiredsValue);
                     break;
                 default:
                     targetMiredsValue = startUpMiredsValue;
@@ -1270,16 +1266,8 @@ export class ColorControlBaseServer extends ColorControlBase {
             if (colorTemperatureMaximumMireds === 0) {
                 colorTemperatureMaximumMireds = this.maximumColorTemperatureMireds;
             }
-            colorTemperatureMinimumMireds = cropValueRange(
-                colorTemperatureMinimumMireds,
-                this.minimumColorTemperatureMireds,
-                this.maximumColorTemperatureMireds,
-            );
-            colorTemperatureMaximumMireds = cropValueRange(
-                colorTemperatureMaximumMireds,
-                this.minimumColorTemperatureMireds,
-                this.maximumColorTemperatureMireds,
-            );
+            colorTemperatureMinimumMireds = this.#cropColorTemperature(colorTemperatureMinimumMireds);
+            colorTemperatureMaximumMireds = this.#cropColorTemperature(colorTemperatureMaximumMireds);
 
             return this.moveColorTemperatureLogic(
                 moveMode,
@@ -1350,16 +1338,8 @@ export class ColorControlBaseServer extends ColorControlBase {
             if (colorTemperatureMaximumMireds === 0) {
                 colorTemperatureMaximumMireds = this.maximumColorTemperatureMireds;
             }
-            colorTemperatureMinimumMireds = cropValueRange(
-                colorTemperatureMinimumMireds,
-                this.minimumColorTemperatureMireds,
-                this.maximumColorTemperatureMireds,
-            );
-            colorTemperatureMaximumMireds = cropValueRange(
-                colorTemperatureMaximumMireds,
-                this.minimumColorTemperatureMireds,
-                this.maximumColorTemperatureMireds,
-            );
+            colorTemperatureMinimumMireds = this.#cropColorTemperature(colorTemperatureMinimumMireds);
+            colorTemperatureMaximumMireds = this.#cropColorTemperature(colorTemperatureMaximumMireds);
 
             return this.stepColorTemperatureLogic(
                 stepMode,
@@ -1773,6 +1753,14 @@ export class ColorControlBaseServer extends ColorControlBase {
         (this.state as any)[fieldName] = cropValueRange(Math.round(value * 65536), MIN_CIE_XY_VALUE, MAX_CIE_XY_VALUE);
     }
 
+    #cropColorTemperature(temperatureMireds: number) {
+        return cropValueRange(
+            temperatureMireds,
+            this.minimumColorTemperatureMireds,
+            this.maximumColorTemperatureMireds,
+        );
+    }
+
     override async [Symbol.asyncDispose]() {
         if (this.internal.transitions) {
             await this.internal.transitions.close();
@@ -1811,6 +1799,17 @@ export namespace ColorControlBaseServer {
          */
         transitionStepInterval = Millis(100);
 
+        // These were the default values specified prior to Matter 1.4.2.  We still need default values so using the
+        // previously specified values which are presumably educated logical defaults
+        override currentX = 24939;
+        override currentY = 24701;
+        override colorTemperatureMireds = 250;
+        override enhancedColorMode = ColorControl.EnhancedColorMode.CurrentXAndCurrentY;
+        override colorLoopTime = 25;
+        override colorLoopStartEnhancedHue = 8960;
+        override colorLoopActive = ColorControl.ColorLoopActive.Inactive;
+        override colorLoopDirection = ColorControl.ColorLoopDirection.Increment;
+
         [Val.properties](endpoint: Endpoint) {
             // Only return remaining time if the attribute is defined in the endpoint
             if (

package/src/behaviors/content-control/ContentControlInterface.ts

@@ -108,7 +108,7 @@ export namespace ContentControlInterface {
          * The purpose of this command is to specify whether programs with no Content rating must be blocked by this
          * media device.
          *
-         * Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUnrated attribute to
+         * Upon receipt of the UnblockUnratedContent command, the media device shall set the BlockUn rated attribute to
          * FALSE.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 6.13.8.9

package/src/behaviors/door-lock/DoorLockInterface.ts

@@ -69,7 +69,7 @@ export namespace DoorLockInterface {
         /**
          * Retrieve user.
          *
-         * An InvokeResponse command shall be sent with an appropriate error (e.g. FAILURE, INVALID_COMMAND, etc.) as
+         * An InvokeResponse command shall be sent with an appropriate error (e.g. FAILURE, INVALID_ COMMAND, etc.) as
          * needed otherwise the GetUserResponse Command shall be sent implying a status of SUCCESS.
          *
          * @see {@link MatterSpecification.v141.Cluster} § 5.2.10.33

package/src/behaviors/door-lock/DoorLockServer.ts

@@ -14,10 +14,17 @@ import LockState = DoorLock.LockState;
  */
 export class DoorLockServer extends DoorLockBehavior {
     override initialize(): MaybePromise {
-        if (this.state.supportedOperatingModes.alwaysSet !== 2047) {
-            throw new ImplementationError(
-                `DoorLockServer: The "alwaysSet" bit-range in supportedOperatingModes must be set. Please check the specification about the meaning of this field because bits are inverted here!`,
-            );
+        if (!Object.values(this.state.supportedOperatingModes).some(v => v)) {
+            // Empty operating modes; default to mandatory ones (note that values are inverted so true indicates not
+            // supported)
+            this.state.supportedOperatingModes = { vacation: true, privacy: true, passage: true, alwaysSet: 2047 };
+        } else {
+            // Warn if it looks like the confusing Matter semantics have confused someone
+            if (this.state.supportedOperatingModes.alwaysSet !== 2047) {
+                throw new ImplementationError(
+                    `DoorLockServer: The "alwaysSet" bit-range in supportedOperatingModes must be set. Please check the specification about the meaning of this field because bits are inverted here!`,
+                );
+            }
         }
     }
 

package/src/behaviors/ethernet-network-diagnostics/EthernetNetworkDiagnosticsInterface.ts

@@ -11,6 +11,8 @@ import { MaybePromise } from "#general";
 export namespace EthernetNetworkDiagnosticsInterface {
     export interface PacketCountsOrErrorCounts {
         /**
+         * This command is used to reset the count attributes.
+         *
          * Reception of this command shall reset the following attributes to 0:
          *
          *   • PacketRxCount
@@ -23,8 +25,6 @@ export namespace EthernetNetworkDiagnosticsInterface {
          *
          *   • OverrunCount
          *
-         * This command has no associated data.
-         *
          * @see {@link MatterSpecification.v141.Core} § 11.16.7.1
          */
         resetCounts(): MaybePromise;

package/src/behaviors/fan-control/FanControlInterface.ts

@@ -12,10 +12,19 @@ import { FanControl } from "#clusters/fan-control";
 export namespace FanControlInterface {
     export interface Step {
         /**
-         * This command speeds up or slows down the fan, in steps, without the client having to know the fan speed. This
-         * command supports, for example, a user operated wall switch, where the user provides the feedback or control
-         * to stop sending this command when the proper speed is reached. The step speed values are implementation
-         * specific. How many step speeds are implemented is implementation specific.
+         * This command indirectly changes the speed-oriented attributes of the fan in steps rather than using the
+         * speed-oriented attributes, FanMode, PercentSetting, or SpeedSetting, directly. This command supports, for
+         * example, a user-operated and wall-mounted toggle switch that can be used to increase or decrease the speed of
+         * the fan by pressing the toggle switch up or down until the desired fan speed is reached. How this command is
+         * interpreted by the server and how it affects the values of the speed-oriented attributes is implementation
+         * specific.
+         *
+         * For example, a fan supports this command, and the value of the FanModeSequence attribute is 0. The current
+         * value of the FanMode attribute is 2, or Medium. This command is received with the Direction field set to
+         * Increase. As per it’s specific implementation, the server reacts to the command by setting the value of the
+         * FanMode attribute to 3, or High, which in turn sets the PercentSetting and SpeedSetting (if present)
+         * attributes to appropriate values, as defined by Section 4.4.6.3.1, “Percent Rules” and Section 4.4.6.6.1,
+         * “Speed Rules” respectively.
          *
          * This command supports these fields:
          *

package/src/behaviors/fan-control/FanControlServer.ts

@@ -4,11 +4,16 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-/*** THIS FILE WILL BE REGENERATED IF YOU DO NOT REMOVE THIS MESSAGE ***/
-
+import { FanControl } from "#clusters/fan-control";
 import { FanControlBehavior } from "./FanControlBehavior.js";
 
 /**
  * This is the default server implementation of {@link FanControlBehavior}.
  */
-export class FanControlServer extends FanControlBehavior {}
+export class FanControlServer extends FanControlBehavior {
+    override initialize() {
+        if (this.state.fanMode === undefined) {
+            this.state.fanMode = FanControl.FanMode.Off;
+        }
+    }
+}

package/src/behaviors/general-commissioning/GeneralCommissioningInterface.ts

@@ -12,6 +12,8 @@ import { GeneralCommissioning } from "#clusters/general-commissioning";
 export namespace GeneralCommissioningInterface {
     export interface Base {
         /**
+         * This command is used to arm or disarm the fail-safe timer.
+         *
          * Success or failure of this command shall be communicated by the ArmFailSafeResponse command, unless some data
          * model validations caused a failure status code to be issued during the processing of the command.
          *
@@ -61,9 +63,9 @@ export namespace GeneralCommissioningInterface {
          *
          *   • Whether an AddNOC command or UpdateNOC command has taken place.
          *
-         *   • A Fabric Index for the fabric-scoping of the context, starting at the accessing fabric index for the
-         *     ArmFailSafe command, and updated with the Fabric Index associated with an AddNOC command or an UpdateNOC
-         *     command being invoked successfully during the ongoing Fail-Safe timer period.
+         *   • A fabric-index for the fabric-scoping of the context, starting at the accessing fabric index for the
+         *     ArmFailSafe command, and updated with the Fabric Index associated with an AddNOC or an UpdateNOC command
+         *     being invoked successfully during the ongoing Fail-Safe timer period.
          *
          *   • The operational credentials associated with any Fabric whose configuration is affected by the UpdateNOC
          *     command.
@@ -100,8 +102,8 @@ export namespace GeneralCommissioningInterface {
          *      “Bootstrapping of the Access Control Cluster”) at the Server.
          *
          *   3. If an AddNOC or UpdateNOC command has been successfully invoked, terminate all CASE sessions associated
-         *      with the Fabric whose Fabric Index is recorded in the Fail-Safe context (see ArmFailSafe) by clearing
-         *      any associated Secure Session Context at the Server.
+         *      with the Fabric whose Fabric Index is recorded in the Fail-Safe context (see Section 11.10.7.2,
+         *      “ArmFailSafe Command”) by clearing any associated Secure Session Context at the Server.
          *
          *   4. Reset the configuration of all Network Commissioning Networks attribute to their state prior to the
          *      Fail-Safe being armed.
@@ -111,14 +113,15 @@ export namespace GeneralCommissioningInterface {
          *      was the subject of the UpdateNOC command.
          *
          *   6. If an AddNOC command had been successfully invoked, achieve the equivalent effect of invoking the
-         *      RemoveFabric command against the Fabric Index stored in the Fail-Safe Context for the Fabric Index that
+         *      RemoveFabric command against the fabric-index stored in the Fail-Safe Context for the Fabric Index that
          *      was the subject of the AddNOC command. This shall remove all associations to that Fabric including all
          *      fabric-scoped data, and may possibly factory-reset the device depending on current device state. This
          *      shall only apply to Fabrics added during the fail-safe period as the result of the AddNOC command.
          *
          *   7. If the CSRRequest command had been successfully invoked, but no AddNOC or UpdateNOC command had been
          *      successfully invoked, then the new operational key pair temporarily generated for the purposes of NOC
-         *      addition or update (see Node Operational CSR Procedure) shall be removed as it is no longer needed.
+         *      addition or update (see Section 6.4.6.1, “Node Operational Certificate Signing Request (NOCSR)
+         *      Procedure”) shall be removed as it is no longer needed.
          *
          *   8. Remove any RCACs added by the AddTrustedRootCertificate command that are not currently referenced by any
          *      entry in the Fabrics attribute.
@@ -133,6 +136,8 @@ export namespace GeneralCommissioningInterface {
         armFailSafe(request: GeneralCommissioning.ArmFailSafeRequest): MaybePromise<GeneralCommissioning.ArmFailSafeResponse>;
 
         /**
+         * This command is used to set the regulatory configuration for the device.
+         *
          * This shall add or update the regulatory configuration in the RegulatoryConfig Attribute to the value provided
          * in the NewRegulatoryConfig field.
          *
@@ -167,7 +172,7 @@ export namespace GeneralCommissioningInterface {
         setRegulatoryConfig(request: GeneralCommissioning.SetRegulatoryConfigRequest): MaybePromise<GeneralCommissioning.SetRegulatoryConfigResponse>;
 
         /**
-         * This command has no data.
+         * This command is used to indicate that the commissioning process is complete.
          *
          * Success or failure of this command shall be communicated by the CommissioningCompleteResponse command, unless
          * some data model validations caused a failure status code to be issued during the processing of the command.
@@ -184,9 +189,7 @@ export namespace GeneralCommissioningInterface {
          * received when no Fail-Safe context exists.
          *
          * If Terms and Conditions are required, then an ErrorCode of TCAcknowledgementsNotReceived shall be responded
-         * to the invoker if the user acknowledgements to the required Terms and Conditions have not been provided. If
-         * the TCAcceptedVersion for the provided acknowledgements is less than TCMinRequiredVersion, then an ErrorCode
-         * of TCMinVersionNotMet shall be responded to the invoker.
+         * to the invoker if the user acknowledgements to the required Terms and Conditions have not been provided.
          *
          * This command is fabric-scoped, so cannot be issued over a session that does not have an associated fabric,
          * i.e. over PASE session prior to an AddNOC command. In addition, this command is only permitted over CASE and
@@ -230,8 +233,8 @@ export namespace GeneralCommissioningInterface {
 
     export interface TermsAndConditions {
         /**
-         * This command sets the user acknowledgements received in the Enhanced Setup Flow Terms & Conditions into the
-         * node.
+         * This command is used to set the user acknowledgements received in the Enhanced Setup Flow Terms & Conditions
+         * into the node.
          *
          * @see {@link MatterSpecification.v141.Core} § 11.10.7.8
          */

package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts

@@ -85,15 +85,11 @@ export class GeneralDiagnosticsServer extends Base {
         this.reactTo(lifecycle.online, this.#online, { lock: true });
         this.reactTo(lifecycle.goingOffline, this.#goingOffline, { lock: true });
 
-        if (this.events.activeHardwareFaults$Changed !== undefined) {
-            this.reactTo(this.events.activeHardwareFaults$Changed, this.#triggerActiveHardwareFaultsChangedEvent);
-        }
-        if (this.events.activeRadioFaults$Changed !== undefined) {
-            this.reactTo(this.events.activeRadioFaults$Changed, this.#triggerActiveRadioFaultsChangedEvent);
-        }
-        if (this.events.activeNetworkFaults$Changed !== undefined) {
-            this.reactTo(this.events.activeNetworkFaults$Changed, this.#triggerActiveNetworkFaultsChangedEvent);
-        }
+        this.maybeReactTo(this.events.activeHardwareFaults$Changed, this.#triggerActiveHardwareFaultsChangedEvent);
+
+        this.maybeReactTo(this.events.activeRadioFaults$Changed, this.#triggerActiveRadioFaultsChangedEvent);
+
+        this.maybeReactTo(this.events.activeNetworkFaults$Changed, this.#triggerActiveNetworkFaultsChangedEvent);
     }
 
     #validateTestEnabledKey(enableKey: Bytes) {

package/src/behaviors/group-key-management/GroupKeyManagementInterface.ts

@@ -27,8 +27,8 @@ export namespace GroupKeyManagementInterface {
          *
          *   • If the EpochStartTime0 is set to 0, then this command shall fail with an INVALID_COMMAND status code
          *     responded to the client. Note that internally, a GroupKeySetStruct’s EpochStartTime0 may be set to zero,
-         *     due to the behavior of the AddNOC command which synthesizes a GroupKeySetStruct (see IPKValue). However,
-         *     the value 0 is illegal in the GroupKeySet field sent by a client.
+         *     due to the behavior of the AddNOC command which synthesizes a GroupKeySetStruct (see Section 11.18.6.8.1,
+         *     “IPKValue Field”). However, the value 0 is illegal in the GroupKeySet field sent by a client.
          *
          *   • If the EpochKey1 field is not null, then the EpochKey0 field shall NOT be null. Otherwise this command
          *     shall fail with an INVALID_COMMAND status code responded to the client.
@@ -69,7 +69,7 @@ export namespace GroupKeyManagementInterface {
          *     SUCCESS.
          *
          *   • If there are insufficient resources on the receiver to store an additional Group Key Set, the status code
-         *     shall be set to RESOURCE_EXHAUSTED (see group key limits);
+         *     shall be set to RESOURCE_EXHAUSTED (see Section 2.11.1.2, “Group Limits”);
          *
          *   • Otherwise, this status code shall be set to FAILURE.
          *

package/src/behaviors/icd-management/IcdManagementInterface.ts

@@ -20,7 +20,25 @@ export namespace IcdManagementInterface {
          * exchanges during that period. The client may slightly overestimate the duration it wants the ICD to be active
          * for, in order to account for network delays.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.4
+         * ### Effect on Receipt
+         *
+         * When receiving a StayActiveRequest command, the server shall calculate the maximum PromisedActiveDuration it
+         * can remain active as the greater of the following two values:
+         *
+         *   • StayActiveDuration: Specified in the received command by the client.
+         *
+         *   • Remaining Active Time: The server’s planned remaining active time based on the ActiveModeThreshold and
+         *     its internal resources and power budget.
+         *
+         * A server may replace StayActiveDuration with Minimum Active Duration in the above calculation.
+         *
+         * PromisedActiveDuration represents the guaranteed minimum time the server will remain active, taking into
+         * account both the requested duration and the server’s capabilities.
+         *
+         * The ICD shall report the calculated PromisedActiveDuration in a StayActiveResponse message back to the
+         * client.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.4
          */
         stayActiveRequest(request: IcdManagement.StayActiveRequest): MaybePromise<IcdManagement.StayActiveResponse>;
     }
@@ -30,7 +48,7 @@ export namespace IcdManagementInterface {
          * This command allows a client to register itself with the ICD to be notified when the device is available for
          * communication.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.1
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.1
          */
         registerClient(request: IcdManagement.RegisterClientRequest): MaybePromise<IcdManagement.RegisterClientResponse>;
 
@@ -39,7 +57,7 @@ export namespace IcdManagementInterface {
          * (e.g. running on a phone which is leaving the home) can (and should) remove its subscriptions and send this
          * UnregisterClient command before leaving to prevent the burden on the ICD of an absent client.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.3
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.3
          */
         unregisterClient(request: IcdManagement.UnregisterClientRequest): MaybePromise;
     }
@@ -54,7 +72,25 @@ export namespace IcdManagementInterface {
          * exchanges during that period. The client may slightly overestimate the duration it wants the ICD to be active
          * for, in order to account for network delays.
          *
-         * @see {@link MatterSpecification.v141.Core} § 9.17.7.4
+         * ### Effect on Receipt
+         *
+         * When receiving a StayActiveRequest command, the server shall calculate the maximum PromisedActiveDuration it
+         * can remain active as the greater of the following two values:
+         *
+         *   • StayActiveDuration: Specified in the received command by the client.
+         *
+         *   • Remaining Active Time: The server’s planned remaining active time based on the ActiveModeThreshold and
+         *     its internal resources and power budget.
+         *
+         * A server may replace StayActiveDuration with Minimum Active Duration in the above calculation.
+         *
+         * PromisedActiveDuration represents the guaranteed minimum time the server will remain active, taking into
+         * account both the requested duration and the server’s capabilities.
+         *
+         * The ICD shall report the calculated PromisedActiveDuration in a StayActiveResponse message back to the
+         * client.
+         *
+         * @see {@link MatterSpecification.v141.Core} § 9.16.7.4
          */
         stayActiveRequest(request: IcdManagement.StayActiveRequest): MaybePromise<IcdManagement.StayActiveResponse>;
     }

package/src/behaviors/index.ts

@@ -16,7 +16,6 @@ export * from "./alarm-base/index.js";
 export * from "./application-basic/index.js";
 export * from "./application-launcher/index.js";
 export * from "./audio-output/index.js";
-export * from "./ballast-configuration/index.js";
 export * from "./basic-information/index.js";
 export * from "./binding/index.js";
 export * from "./boolean-state-configuration/index.js";
@@ -57,8 +56,8 @@ export * from "./hepa-filter-monitoring/index.js";
 export * from "./icd-management/index.js";
 export * from "./identify/index.js";
 export * from "./illuminance-measurement/index.js";
+export * from "./joint-fabric-administrator/index.js";
 export * from "./joint-fabric-datastore/index.js";
-export * from "./joint-fabric-pki/index.js";
 export * from "./keypad-input/index.js";
 export * from "./label/index.js";
 export * from "./laundry-dryer-controls/index.js";
@@ -92,8 +91,6 @@ export * from "./power-source-configuration/index.js";
 export * from "./power-source/index.js";
 export * from "./power-topology/index.js";
 export * from "./pressure-measurement/index.js";
-export * from "./proxy-configuration/index.js";
-export * from "./proxy-discovery/index.js";
 export * from "./pump-configuration-and-control/index.js";
 export * from "./radon-concentration-measurement/index.js";
 export * from "./refrigerator-alarm/index.js";
@@ -121,7 +118,6 @@ export * from "./time-synchronization/index.js";
 export * from "./total-volatile-organic-compounds-concentration-measurement/index.js";
 export * from "./unit-localization/index.js";
 export * from "./user-label/index.js";
-export * from "./valid-proxies/index.js";
 export * from "./valve-configuration-and-control/index.js";
 export * from "./wake-on-lan/index.js";
 export * from "./water-heater-management/index.js";

package/src/behaviors/joint-fabric-administrator/JointFabricAdministratorBehavior.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { JointFabricAdministrator } from "#clusters/joint-fabric-administrator";
+import { ClusterBehavior } from "../../behavior/cluster/ClusterBehavior.js";
+import { JointFabricAdministratorInterface } from "./JointFabricAdministratorInterface.js";
+import { Identity } from "#general";
+
+/**
+ * JointFabricAdministratorBehavior is the base class for objects that support interaction with
+ * {@link JointFabricAdministrator.Cluster}.
+ */
+export const JointFabricAdministratorBehaviorConstructor = ClusterBehavior
+    .withInterface<JointFabricAdministratorInterface>()
+    .for(JointFabricAdministrator.Cluster);
+
+export interface JointFabricAdministratorBehaviorConstructor extends Identity<typeof JointFabricAdministratorBehaviorConstructor> {}
+export const JointFabricAdministratorBehavior: JointFabricAdministratorBehaviorConstructor = JointFabricAdministratorBehaviorConstructor;
+export interface JointFabricAdministratorBehavior extends InstanceType<JointFabricAdministratorBehaviorConstructor> {}
+export namespace JointFabricAdministratorBehavior {
+    export interface State extends InstanceType<typeof JointFabricAdministratorBehavior.State> {}
+}

package/src/behaviors/joint-fabric-administrator/JointFabricAdministratorClient.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import { JointFabricAdministratorBehavior } from "./JointFabricAdministratorBehavior.js";
+import { Identity } from "#general";
+
+export const JointFabricAdministratorClientConstructor = JointFabricAdministratorBehavior;
+export interface JointFabricAdministratorClient extends JointFabricAdministratorBehavior {}
+export interface JointFabricAdministratorClientConstructor extends Identity<typeof JointFabricAdministratorClientConstructor> {}
+export const JointFabricAdministratorClient: JointFabricAdministratorClientConstructor = JointFabricAdministratorClientConstructor;