@matter/types 0.17.4 → 0.17.5-alpha.0-20260702-a2cd6f764

package/dist/cjs/clusters/ambient-context-sensing.d.ts

@@ -0,0 +1,706 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+
+import type { ClusterType, ClusterTyping } from "../cluster/ClusterType.js";
+import type { ClusterId } from "../datatype/ClusterId.js";
+import type { ClusterModel } from "@matter/model";
+import type { ModeSelect } from "./mode-select.js";
+
+/**
+ * Definitions for the AmbientContextSensing cluster.
+ *
+ * This server cluster provides an interface to ambient context sensing functionality.
+ *
+ * > [!NOTE]
+ *
+ * > NOTE: Support for this cluster is provisional.
+ *
+ * @see {@link MatterSpecification.v16.Cluster} § 2.16
+ */
+export declare namespace AmbientContextSensing {
+    /**
+     * The Matter protocol cluster identifier.
+     */
+    export const id: ClusterId & 0x0431;
+
+    /**
+     * Textual cluster identifier.
+     */
+    export const name: "AmbientContextSensing";
+
+    /**
+     * The cluster revision assigned by {@link MatterSpecification.v16.Cluster}.
+     */
+    export const revision: 1;
+
+    /**
+     * Canonical metadata for the AmbientContextSensing cluster.
+     *
+     * This is the exhaustive runtime metadata source that matter.js considers canonical.
+     */
+    export const schema: ClusterModel;
+
+    /**
+     * {@link AmbientContextSensing} always supports these elements.
+     */
+    export interface BaseAttributes {
+        /**
+         * Indicates the maximum number of simultaneous multiple ambient context detections supported by the server. If
+         * an additional detection event causes the total number of simultaneous detection events to exceed a
+         * SimultaneousDetectionLimit, the oldest ambient sensing detection event shall be removed and the latest
+         * detection shall be added. The same type of ambient context sensing event occurred consecutively within the
+         * HoldTime duration shall not increase the total number of simultaneous detection events. If a simultaneous
+         * detection feature is not supported, then the value shall be set to 1.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.9
+         */
+        simultaneousDetectionLimit: number;
+
+        /**
+         * Indicates the time duration of True state, in seconds, before the sensor changes its sensing detection state
+         * from True to False after the last detection. Low values of HoldTime SHOULD be avoided since they could lead
+         * to generating overly frequent data reports on subscriptions. This is equivalent to the HoldTime attribute of
+         * the OccupancySensing cluster attribute. For further information, refer to the HoldTime attribute description
+         * of the Occupancy Sensing Cluster. The HoldTime shall be applied to each ambient context detection occurrence
+         * individually. A more detail HoldTime implementation example over multiple simultaneous ambient context
+         * detections can be found in theMultipleAmbientSensingDetection section.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.10
+         */
+        holdTime: number;
+
+        /**
+         * Indicates the server's limits, and default value, for the HoldTime attribute. This is equivalent to the
+         * HoldTimeLimits attribute of the Occupancy Sensing Cluster attribute. For further information, refer to the
+         * HoldTimeLimits attribute description of the Occupancy Sensing Cluster.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.11
+         */
+        holdTimeLimits: HoldTimeLimits;
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature "HumanActivity".
+     */
+    export interface HumanActivityAttributes {
+        /**
+         * Indicates the human activity detection in Boolean data. The detected human activity type can be found from
+         * the AmbientContextType attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.1
+         */
+        humanActivityDetected: boolean;
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature "ObjectIdentification".
+     */
+    export interface ObjectIdentificationAttributes {
+        /**
+         * Indicates the occurrence of object identification in Boolean data. The detail object identification can be
+         * found from the AmbientContextType attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.2
+         */
+        objectIdentified: boolean;
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature "SoundIdentification".
+     */
+    export interface SoundIdentificationAttributes {
+        /**
+         * Indicates the ambient audio context detection in Boolean data. The detected audio context type can be found
+         * from the AmbientContextType attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.3
+         */
+        audioContextDetected: boolean;
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature
+     * "HumanActivityOrObjectIdentificationOrSoundIdentification".
+     */
+    export interface HumanActivityOrObjectIdentificationOrSoundIdentificationAttributes {
+        /**
+         * Indicates the details for the currently observed and detected ambient context. This attribute supports
+         * multiple simultaneous ambient context detections. The attribute expression rule is provided in the
+         * MultipleAmbientSensingDetection section. The total number of simultaneous ambient context detections is
+         * limited by the SimultaneousDetectionLimit attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.4
+         */
+        ambientContextType: AmbientContextType[];
+
+        /**
+         * Indicates the list of ambient context detection types supported by the server. Each supported ambient context
+         * detection type element shall be of a type supported in the AmbientContextFeatureMap and shall indicate a
+         * supported ambient context detection SemanticTagStruct from one of the following namespaces: Identified Human
+         * Activity Namespace, Identified Object Namespace, Identified Sound Namespace in the StandardNamespaces.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.5
+         */
+        ambientContextTypeSupported: ModeSelect.SemanticTag[];
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature
+     * "ObjectCountingAndObjectIdentification".
+     */
+    export interface ObjectCountingAndObjectIdentificationAttributes {
+        /**
+         * Indicates whether the number of an object being counted is greater or equal to the threshold specified by the
+         * ObjectCountThreshold. The counting object shall be limited to one identified object type and identified by
+         * the Identified Object namespace tag ID from presented in the AmbientContextTypeSupported attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.6
+         */
+        objectCountReached: boolean;
+
+        /**
+         * Indicates configuration parameters to support an object counting feature. The attribute specifies the object
+         * to be detected and counted and the counting threshold value for the object counting purpose.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.7
+         */
+        objectCountConfig: ObjectCountConfig;
+
+        /**
+         * Indicates the number of objects detected in the area covered by the sensor. ObjectCount shall be exposed only
+         * when ObjectCountReached is true.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.8
+         */
+        objectCount?: number;
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature "PredictedActivity".
+     */
+    export interface PredictedActivityAttributes {
+        /**
+         * Indicates the server's prediction of upcoming changes to the monitored area's ambient context.
+         *
+         * The value of the StartTimestamp field on each PredictedActivityStruct in this list other than the first shall
+         * be greater than the value of the EndTimestamp field on the previous PredictedActivityStruct in this list.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.12
+         */
+        predictedActivity: PredictedActivity[];
+    }
+
+    /**
+     * Attributes that may appear in {@link AmbientContextSensing}.
+     *
+     * Some properties may be optional if device support is not mandatory. Device support may also be affected by a
+     * device's supported {@link Features}.
+     */
+    export interface Attributes {
+        /**
+         * Indicates the maximum number of simultaneous multiple ambient context detections supported by the server. If
+         * an additional detection event causes the total number of simultaneous detection events to exceed a
+         * SimultaneousDetectionLimit, the oldest ambient sensing detection event shall be removed and the latest
+         * detection shall be added. The same type of ambient context sensing event occurred consecutively within the
+         * HoldTime duration shall not increase the total number of simultaneous detection events. If a simultaneous
+         * detection feature is not supported, then the value shall be set to 1.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.9
+         */
+        simultaneousDetectionLimit: number;
+
+        /**
+         * Indicates the time duration of True state, in seconds, before the sensor changes its sensing detection state
+         * from True to False after the last detection. Low values of HoldTime SHOULD be avoided since they could lead
+         * to generating overly frequent data reports on subscriptions. This is equivalent to the HoldTime attribute of
+         * the OccupancySensing cluster attribute. For further information, refer to the HoldTime attribute description
+         * of the Occupancy Sensing Cluster. The HoldTime shall be applied to each ambient context detection occurrence
+         * individually. A more detail HoldTime implementation example over multiple simultaneous ambient context
+         * detections can be found in theMultipleAmbientSensingDetection section.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.10
+         */
+        holdTime: number;
+
+        /**
+         * Indicates the server's limits, and default value, for the HoldTime attribute. This is equivalent to the
+         * HoldTimeLimits attribute of the Occupancy Sensing Cluster attribute. For further information, refer to the
+         * HoldTimeLimits attribute description of the Occupancy Sensing Cluster.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.11
+         */
+        holdTimeLimits: HoldTimeLimits;
+
+        /**
+         * Indicates the human activity detection in Boolean data. The detected human activity type can be found from
+         * the AmbientContextType attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.1
+         */
+        humanActivityDetected: boolean;
+
+        /**
+         * Indicates the occurrence of object identification in Boolean data. The detail object identification can be
+         * found from the AmbientContextType attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.2
+         */
+        objectIdentified: boolean;
+
+        /**
+         * Indicates the ambient audio context detection in Boolean data. The detected audio context type can be found
+         * from the AmbientContextType attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.3
+         */
+        audioContextDetected: boolean;
+
+        /**
+         * Indicates the details for the currently observed and detected ambient context. This attribute supports
+         * multiple simultaneous ambient context detections. The attribute expression rule is provided in the
+         * MultipleAmbientSensingDetection section. The total number of simultaneous ambient context detections is
+         * limited by the SimultaneousDetectionLimit attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.4
+         */
+        ambientContextType: AmbientContextType[];
+
+        /**
+         * Indicates the list of ambient context detection types supported by the server. Each supported ambient context
+         * detection type element shall be of a type supported in the AmbientContextFeatureMap and shall indicate a
+         * supported ambient context detection SemanticTagStruct from one of the following namespaces: Identified Human
+         * Activity Namespace, Identified Object Namespace, Identified Sound Namespace in the StandardNamespaces.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.5
+         */
+        ambientContextTypeSupported: ModeSelect.SemanticTag[];
+
+        /**
+         * Indicates whether the number of an object being counted is greater or equal to the threshold specified by the
+         * ObjectCountThreshold. The counting object shall be limited to one identified object type and identified by
+         * the Identified Object namespace tag ID from presented in the AmbientContextTypeSupported attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.6
+         */
+        objectCountReached: boolean;
+
+        /**
+         * Indicates configuration parameters to support an object counting feature. The attribute specifies the object
+         * to be detected and counted and the counting threshold value for the object counting purpose.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.7
+         */
+        objectCountConfig: ObjectCountConfig;
+
+        /**
+         * Indicates the number of objects detected in the area covered by the sensor. ObjectCount shall be exposed only
+         * when ObjectCountReached is true.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.8
+         */
+        objectCount: number;
+
+        /**
+         * Indicates the server's prediction of upcoming changes to the monitored area's ambient context.
+         *
+         * The value of the StartTimestamp field on each PredictedActivityStruct in this list other than the first shall
+         * be greater than the value of the EndTimestamp field on the previous PredictedActivityStruct in this list.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.7.12
+         */
+        predictedActivity: PredictedActivity[];
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature
+     * "HumanActivityOrObjectIdentificationOrSoundIdentification".
+     */
+    export interface HumanActivityOrObjectIdentificationOrSoundIdentificationEvents {
+        /**
+         * This event shall be generated when a new different ambient context detection is added to AmbientContextType.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1
+         */
+        ambientContextDetectStarted: AmbientContextDetectStartedEvent;
+
+        /**
+         * This event shall be generated when the ambient context detection that generated the
+         * AmbientContextDetectStarted event is removed from AmbientContextType. This end event doesn't necessary
+         * reflect the end of the actual event progression. For example, both AmbientContextDetectStarted and
+         * AmbientContextDetectEnded events are used to inform the "sleeping" event occurrence where
+         * AmbientContextDetectEnded event doesn't necessarily indicate the actual end of "sleeping" action.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.2
+         */
+        ambientContextDetectEnded: AmbientContextDetectEndedEvent;
+    }
+
+    /**
+     * {@link AmbientContextSensing} supports these elements if it supports feature
+     * "ObjectCountingAndObjectIdentification".
+     */
+    export interface ObjectCountingAndObjectIdentificationEvents {
+        /**
+         * This event shall be generated when a new different ambient context detection is added to AmbientContextType.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1
+         */
+        ambientContextDetectStarted: AmbientContextDetectStartedEvent;
+
+        /**
+         * This event shall be generated when the ambient context detection that generated the
+         * AmbientContextDetectStarted event is removed from AmbientContextType. This end event doesn't necessary
+         * reflect the end of the actual event progression. For example, both AmbientContextDetectStarted and
+         * AmbientContextDetectEnded events are used to inform the "sleeping" event occurrence where
+         * AmbientContextDetectEnded event doesn't necessarily indicate the actual end of "sleeping" action.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.2
+         */
+        ambientContextDetectEnded: AmbientContextDetectEndedEvent;
+    }
+
+    /**
+     * Events that may appear in {@link AmbientContextSensing}.
+     *
+     * Some properties may be optional if device support is not mandatory. Device support may also be affected by a
+     * device's supported {@link Features}.
+     */
+    export interface Events {
+        /**
+         * This event shall be generated when a new different ambient context detection is added to AmbientContextType.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1
+         */
+        ambientContextDetectStarted: AmbientContextDetectStartedEvent;
+
+        /**
+         * This event shall be generated when the ambient context detection that generated the
+         * AmbientContextDetectStarted event is removed from AmbientContextType. This end event doesn't necessary
+         * reflect the end of the actual event progression. For example, both AmbientContextDetectStarted and
+         * AmbientContextDetectEnded events are used to inform the "sleeping" event occurrence where
+         * AmbientContextDetectEnded event doesn't necessarily indicate the actual end of "sleeping" action.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.2
+         */
+        ambientContextDetectEnded: AmbientContextDetectEndedEvent;
+    }
+
+    export type Components = [
+        { flags: {}, attributes: BaseAttributes },
+        { flags: { humanActivity: true }, attributes: HumanActivityAttributes },
+        { flags: { objectIdentification: true }, attributes: ObjectIdentificationAttributes },
+        { flags: { soundIdentification: true }, attributes: SoundIdentificationAttributes },
+        {
+            flags: { humanActivity: true },
+            attributes: HumanActivityOrObjectIdentificationOrSoundIdentificationAttributes,
+            events: HumanActivityOrObjectIdentificationOrSoundIdentificationEvents
+        },
+        {
+            flags: { objectIdentification: true },
+            attributes: HumanActivityOrObjectIdentificationOrSoundIdentificationAttributes,
+            events: HumanActivityOrObjectIdentificationOrSoundIdentificationEvents
+        },
+        {
+            flags: { soundIdentification: true },
+            attributes: HumanActivityOrObjectIdentificationOrSoundIdentificationAttributes,
+            events: HumanActivityOrObjectIdentificationOrSoundIdentificationEvents
+        },
+        {
+            flags: { objectCounting: true, objectIdentification: true },
+            attributes: ObjectCountingAndObjectIdentificationAttributes,
+            events: ObjectCountingAndObjectIdentificationEvents
+        },
+        { flags: { predictedActivity: true }, attributes: PredictedActivityAttributes }
+    ];
+
+    export type Features = "HumanActivity" | "ObjectCounting" | "ObjectIdentification" | "SoundIdentification" | "PredictedActivity";
+
+    /**
+     * These are optional features supported by AmbientContextSensingCluster.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.5
+     */
+    export enum Feature {
+        /**
+         * HumanActivity (HA)
+         *
+         * Supports various human actions and activities classification
+         */
+        HumanActivity = "HumanActivity",
+
+        /**
+         * ObjectCounting (OC)
+         *
+         * Supports object counting
+         */
+        ObjectCounting = "ObjectCounting",
+
+        /**
+         * ObjectIdentification (OI)
+         *
+         * Supports object identification
+         */
+        ObjectIdentification = "ObjectIdentification",
+
+        /**
+         * SoundIdentification (AUD)
+         *
+         * Supports sound identification
+         */
+        SoundIdentification = "SoundIdentification",
+
+        /**
+         * PredictedActivity (PRED)
+         *
+         * Supports predicting various human actions and activities.
+         */
+        PredictedActivity = "PredictedActivity"
+    }
+
+    /**
+     * This structure provides information on the server's supported values for the HoldTime attribute.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.1
+     */
+    export class HoldTimeLimits {
+        constructor(values?: Partial<HoldTimeLimits>);
+
+        /**
+         * This field shall specify the minimum value supported by the server for the HoldTime attribute, in seconds.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.1.1
+         */
+        holdTimeMin?: number;
+
+        /**
+         * This field shall specify the maximum value supported by the server for the HoldTime attribute, in seconds.
+         * This field also specifies the maximum duration time that is allowed to be continuously in triggered detection
+         * state.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.1.2
+         */
+        holdTimeMax?: number;
+
+        /**
+         * This field shall specify the (manufacturer-determined) default value of the server's HoldTime attribute, in
+         * seconds. This is the value that a client who wants to reset the settings to a valid default SHOULD use.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.1.3
+         */
+        holdTimeDefault?: number;
+    }
+
+    /**
+     * This structure provides information on the server's supported values for the Ambient Context type attribute.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.2
+     */
+    export class AmbientContextType {
+        constructor(values?: Partial<AmbientContextType>);
+
+        /**
+         * This field specifies the detail ambient context information related to the Boolean detection attributes,
+         * HumanActivityDetected, ObjectIdentified, and AudioContextDetected. The detail ambient context information
+         * shall be presented by the namespace ID and semantic tag ID of the SemanticTagStruct available from Identified
+         * Human Activity Namespace, Identified Object Namespace, Identified Sound Namespace in the StandardNamespaces.
+         * When AmbientContextSensed field contains more than one data element, it shall indicate a combined ambient
+         * context event instead of unrelated independent ambient context events. For an example, if a joint event
+         * exposure of "Child Fall" is intended, then the AmbientContextType attribute can be exposed as
+         *
+         * where AmbientContextSensed field contains the SemanticTag data list of "Child" tag ID (=2) from
+         * IdentifiedObject namespace (=0x4B) and "Fall" tag ID (=1) from IdentifiedHumanActivity namespace (=0x49).
+         * However, if two independent events exposure is intended, then the AmbientContextType attribute can be exposed
+         * as
+         *
+         * where AmbientContextSensed field contains only one individual ambient sensing context. In order to avoid
+         * confusion arising from many possible joint permutations, AmbientContextSensed field shall NOT include more
+         * than 2 ambient context events.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.2.1
+         */
+        ambientContextSensed?: ModeSelect.SemanticTag[];
+    }
+
+    /**
+     * This structure provides information on the server's supported values for the ObjectCountConfig attribute.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.3
+     */
+    export class ObjectCountConfig {
+        constructor(values?: Partial<ObjectCountConfig>);
+
+        /**
+         * This field shall indicate an object to be detected and counted. If the MfgCode field, in CountingObject, is
+         * NULL, it shall be specified by ObjectIdentified namespace ID and its tag number available from the
+         * AmbientContextTypeSupported attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.3.1
+         */
+        countingObject?: ModeSelect.SemanticTag;
+
+        /**
+         * This field shall indicate the minimum number of detected objects to render the true Boolean state of
+         * CountThresholdReached attribute.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.3.2
+         */
+        objectCountThreshold?: number;
+    }
+
+    /**
+     * This data structure provides information on future predicted activities.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4
+     */
+    export class PredictedActivity {
+        constructor(values?: Partial<PredictedActivity>);
+
+        /**
+         * This field shall indicate the predicted start time for the predicted activity.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4.1
+         */
+        startTimestamp?: number;
+
+        /**
+         * This field shall indicate the predicted end time for the predicted activity.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4.2
+         */
+        endTimestamp?: number;
+
+        /**
+         * This field shall indicate the predicted state of the AmbientContextType attribute for the specified time
+         * period.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4.3
+         */
+        ambientContextType?: ModeSelect.SemanticTag[];
+
+        /**
+         * This field shall indicate the predicted state of the CrowdDetected attribute for the specified time period.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4.4
+         */
+        crowdDetected?: boolean;
+
+        /**
+         * This field shall indicate the predicted value of the CrowdCount attribute for the specified time period.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4.5
+         */
+        crowdCount?: number;
+
+        /**
+         * This field shall indicate confidence level for the predicted activity state.
+         *
+         * A value of 100% shall indicate a complete certainty of the predicted occupancy state, while a 0% value shall
+         * indicate no certainty. The algorithm to calculate the likelihood of a predicted occupancy state is not
+         * specified and is considered manufacturer specific.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.6.4.6
+         */
+        confidence?: number;
+    }
+
+    /**
+     * This event shall be generated when a new different ambient context detection is added to AmbientContextType.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1
+     */
+    export class AmbientContextDetectStartedEvent {
+        constructor(values?: Partial<AmbientContextDetectStartedEvent>);
+
+        /**
+         * This field shall indicate the detail ambient context information that triggers this event reporting. The
+         * detail ambient context information shall be presented by the namespace ID and semantic tag ID available from
+         * Identified Human Activity Namespace, Identified Object Namespace, Identified Sound Namespace in the
+         * StandardNamespaces. For object counting feature, the AmbientContextDetected field represents the object being
+         * counted.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1.1
+         */
+        ambientContextDetected?: AmbientContextType;
+
+        /**
+         * This field shall indicate an ObjectCountReached attribute value when the event reporting is triggered by the
+         * object counting threshold detection.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1.2
+         */
+        objectCountReached?: boolean;
+
+        /**
+         * This field shall indicate the number of objects detected in the area covered by the sensor when
+         * ObjectCountReached attribute is changed to True.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.1.3
+         */
+        objectCount?: number;
+    }
+
+    /**
+     * This event shall be generated when the ambient context detection that generated the AmbientContextDetectStarted
+     * event is removed from AmbientContextType. This end event doesn't necessary reflect the end of the actual event
+     * progression. For example, both AmbientContextDetectStarted and AmbientContextDetectEnded events are used to
+     * inform the "sleeping" event occurrence where AmbientContextDetectEnded event doesn't necessarily indicate the
+     * actual end of "sleeping" action.
+     *
+     * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.2
+     */
+    export class AmbientContextDetectEndedEvent {
+        constructor(values?: Partial<AmbientContextDetectEndedEvent>);
+
+        /**
+         * This field shall indicate the system time stamp or the epoch time stamp when the corresponding
+         * AmbientContextDetectStarted Event was generated.
+         *
+         * @see {@link MatterSpecification.v16.Cluster} § 2.16.8.2.1
+         */
+        eventStartTime?: number | bigint;
+    }
+
+    /**
+     * Attribute metadata objects keyed by name.
+     */
+    export const attributes: ClusterType.AttributeObjects<Attributes>;
+
+    /**
+     * Event metadata objects keyed by name.
+     */
+    export const events: ClusterType.EventObjects<Events>;
+
+    /**
+     * Feature metadata objects keyed by name.
+     */
+    export const features: ClusterType.Features<Features>;
+
+    /**
+     * @deprecated Use {@link AmbientContextSensing}.
+     */
+    export const Cluster: ClusterType.WithCompat<typeof AmbientContextSensing, AmbientContextSensing>;
+
+    /**
+     * @deprecated Use {@link AmbientContextSensing}.
+     */
+    export const Complete: typeof AmbientContextSensing;
+
+    export const Typing: AmbientContextSensing;
+}
+
+/**
+ * @deprecated Use {@link AmbientContextSensing}.
+ */
+export declare const AmbientContextSensingCluster: typeof AmbientContextSensing;
+
+export interface AmbientContextSensing extends ClusterTyping {
+    Attributes: AmbientContextSensing.Attributes;
+    Events: AmbientContextSensing.Events;
+    Features: AmbientContextSensing.Features;
+    Components: AmbientContextSensing.Components;
+}