deprecation: mark JAQCD action type and braket.ir.jaqcd module as deprecated (MCM-150287739)

src/braket/device_schema/device_action_properties.py

@@ -19,6 +19,12 @@
 class DeviceActionType(str, Enum):
     """
     These are the actions supported by Braket.
+
+    .. deprecated:: 1.29.3
+        ``JAQCD`` is deprecated. Amazon Braket service devices no longer accept
+        JAQCD program submissions; use ``OPENQASM`` (OpenQASM 3) instead. The
+        ``JAQCD`` enum member is retained so historical task results and cached
+        capability documents continue to deserialize.
     """
 
     OPENQASM = "braket.ir.openqasm.program"

src/braket/device_schema/jaqcd_device_action_properties.py

@@ -22,6 +22,12 @@ class JaqcdDeviceActionProperties(DeviceActionProperties):
     """
     Defines the schema for properties for the actions that can be supported by JAQCD devices.
 
+    .. deprecated:: 1.29.3
+        ``JaqcdDeviceActionProperties`` is deprecated. Amazon Braket service
+        devices no longer advertise the ``braket.ir.jaqcd.program`` action type;
+        use the OpenQASM action properties instead. This class is retained so
+        cached capability documents continue to deserialize.
+
     Attributes:
         supportedOperations: Operations supported by the JAQCD action.
         supportedResultTypes: Result types that are supported by the JAQCD action.

src/braket/ir/jaqcd/__init__.py

@@ -11,6 +11,17 @@
 # ANY KIND, either express or implied. See the License for the specific
 # language governing permissions and limitations under the License.
 
+"""
+JAQCD intermediate representation.
+
+.. deprecated:: 1.29.3
+    The ``braket.ir.jaqcd`` module is deprecated. Amazon Braket service
+    devices no longer accept JAQCD program submissions; use the OpenQASM 3
+    intermediate representation in :mod:`braket.ir.openqasm` instead. This
+    module is retained so historical task results that contain
+    ``braket.ir.jaqcd.program`` payloads continue to deserialize.
+"""
+
 from braket.ir.jaqcd.instructions import (  # noqa: F401
     CV,
     CY,

src/braket/ir/jaqcd/instructions.py

@@ -11,6 +11,16 @@
 # ANY KIND, either express or implied. See the License for the specific
 # language governing permissions and limitations under the License.
 
+"""
+JAQCD instruction definitions.
+
+.. deprecated:: 1.29.3
+    The instruction classes in this module are deprecated alongside the rest
+    of :mod:`braket.ir.jaqcd`. Amazon Braket service devices no longer accept
+    JAQCD program submissions; use OpenQASM 3 instead. These classes remain
+    importable so historical task results continue to deserialize.
+"""
+
 from enum import Enum
 
 from braket.ir.jaqcd.shared_models import (

src/braket/ir/jaqcd/program_v1.py

@@ -150,6 +150,13 @@ class Program(BraketSchemaBase):
     """
     Root object of the JsonAwsQuantumCircuitDescription IR.
 
+    .. deprecated:: 1.29.3
+        ``Program`` (the JAQCD program type) is deprecated. Amazon Braket
+        service devices no longer accept JAQCD program submissions; submit
+        an OpenQASM 3 program (:class:`braket.ir.openqasm.Program`) instead.
+        This class is retained so historical task results stored as
+        ``braket.ir.jaqcd.program`` payloads continue to deserialize.
+
     Attributes:
         braketSchemaHeader (BraketSchemaHeader): Schema header. Users do not need
             to set this value. Only default is allowed.