opentrons 8.7.0a1__py3-none-any.whl → 8.7.0a2__py3-none-any.whl

opentrons/hardware_control/types.py

@@ -2,12 +2,26 @@ from asyncio import Queue
 import enum
 import logging
 from dataclasses import dataclass
-from typing import cast, Tuple, Union, List, Callable, Dict, TypeVar, Type
+from typing import (
+    cast,
+    Tuple,
+    Union,
+    List,
+    Callable,
+    Dict,
+    TypeVar,
+    Type,
+    TYPE_CHECKING,
+)
 from typing_extensions import Literal
 from opentrons import types as top_types
 from opentrons_shared_data.pipette.types import PipetteChannelType
+from opentrons_shared_data.errors.exceptions import EnumeratedError
 from opentrons.config import feature_flags
 
+if TYPE_CHECKING:
+    from .modules.types import ModuleModel
+
 MODULE_LOG = logging.getLogger(__name__)
 
 
@@ -384,6 +398,7 @@ class HardwareEventType(enum.Enum):
     DOOR_SWITCH_CHANGE = enum.auto()
     ERROR_MESSAGE = enum.auto()
     ESTOP_CHANGE = enum.auto()
+    ASYNCHRONOUS_MODULE_ERROR = enum.auto()
 
 
 @dataclass
@@ -428,10 +443,24 @@ class ErrorMessageNotification:
     event: Literal[HardwareEventType.ERROR_MESSAGE] = HardwareEventType.ERROR_MESSAGE
 
 
+@dataclass(frozen=True)
+class AsynchronousModuleErrorNotification:
+    exception: EnumeratedError
+    module_serial: str | None
+    module_model: "ModuleModel"
+    port: str
+    event: Literal[
+        HardwareEventType.ASYNCHRONOUS_MODULE_ERROR
+    ] = HardwareEventType.ASYNCHRONOUS_MODULE_ERROR
+
+
 # new event types get new dataclasses
 # when we add more event types we add them here
 HardwareEvent = Union[
-    DoorStateNotification, ErrorMessageNotification, EstopStateNotification
+    DoorStateNotification,
+    ErrorMessageNotification,
+    EstopStateNotification,
+    AsynchronousModuleErrorNotification,
 ]
 
 HardwareEventHandler = Callable[[HardwareEvent], None]

opentrons/legacy_commands/protocol_commands.py

@@ -1,6 +1,7 @@
 from datetime import timedelta
 from typing import Optional
 from . import types as command_types
+from opentrons.protocol_api.tasks import Task
 
 
 def comment(msg: str) -> command_types.CommentCommand:
@@ -52,3 +53,22 @@ def move_labware(text: str) -> command_types.MoveLabwareCommand:
         "name": command_types.MOVE_LABWARE,
         "payload": {"text": text},
     }
+
+
+def wait_for_tasks(tasks: list[Task]) -> command_types.WaitForTasksCommand:
+    task_ids = [task.created_at.strftime("%Y-%m-%d %H:%M:%S") for task in tasks]
+    msg = f"Waiting for tasks that started at: {task_ids}."
+    return {
+        "name": command_types.WAIT_FOR_TASKS,
+        "payload": {"text": msg},
+    }
+
+
+def create_timer(seconds: float) -> command_types.CreateTimerCommand:
+    return {
+        "name": command_types.CREATE_TIMER,
+        "payload": {
+            "text": f"Creating background timer for {seconds} seconds.",
+            "time": seconds,
+        },
+    }

opentrons/legacy_commands/types.py

@@ -102,6 +102,10 @@ ROBOT_MOVE_RELATIVE_TO: Final = "command.ROBOT_MOVE_RELATIVE_TO"
 ROBOT_OPEN_GRIPPER_JAW: Final = "command.ROBOT_OPEN_GRIPPER_JAW"
 ROBOT_CLOSE_GRIPPER_JAW: Final = "command.ROBOT_CLOSE_GRIPPER_JAW"
 
+# Tasks #
+WAIT_FOR_TASKS: Final = "command.WAIT_FOR_TASKS"
+CREATE_TIMER: Final = "command.CREATE_TIMER"
+
 
 class TextOnlyPayload(TypedDict):
     text: str
@@ -714,6 +718,27 @@ class RobotCloseGripperJawCommand(TypedDict):
     payload: GripperCommandPayload
 
 
+# Task Commands and Payloads
+
+
+class WaitForTasksPayload(TextOnlyPayload):
+    pass
+
+
+class CreateTimerPayload(TextOnlyPayload):
+    time: float
+
+
+class WaitForTasksCommand(TypedDict):
+    name: Literal["command.WAIT_FOR_TASKS"]
+    payload: WaitForTasksPayload
+
+
+class CreateTimerCommand(TypedDict):
+    name: Literal["command.CREATE_TIMER"]
+    payload: CreateTimerPayload
+
+
 Command = Union[
     DropTipCommand,
     DropTipInDisposalLocationCommand,
@@ -782,6 +807,9 @@ Command = Union[
     FlexStackerStoreCommand,
     FlexStackerEmptyCommand,
     FlexStackerFillCommand,
+    # Task commands
+    WaitForTasksCommand,
+    CreateTimerCommand,
 ]
 
 
@@ -842,6 +870,9 @@ CommandPayload = Union[
     RobotMoveAxisRelativeCommandPayload,
     RobotMoveAxisToCommandPayload,
     GripperCommandPayload,
+    # Task payloads
+    WaitForTasksPayload,
+    CreateTimerPayload,
 ]
 
 
@@ -1124,6 +1155,14 @@ class RobotCloseGripperJawMessage(CommandMessageFields, RobotCloseGripperJawComm
     pass
 
 
+class WaitForTasksMessage(CommandMessageFields, WaitForTasksCommand):
+    pass
+
+
+class CreateTimerMessage(CommandMessageFields, CreateTimerCommand):
+    pass
+
+
 CommandMessage = Union[
     DropTipMessage,
     DropTipInDisposalLocationMessage,
@@ -1183,4 +1222,7 @@ CommandMessage = Union[
     FlexStackerStoreMessage,
     FlexStackerEmptyMessage,
     FlexStackerFillMessage,
+    # Task Messages
+    WaitForTasksMessage,
+    CreateTimerMessage,
 ]

opentrons/motion_planning/waypoints.py

@@ -7,7 +7,6 @@ from opentrons.hardware_control.types import CriticalPoint
 
 from .types import Waypoint, MoveType, GripperMovementWaypointsWithJawStatus
 from .errors import DestinationOutOfBoundsError, ArcOutOfBoundsError
-from ..protocol_engine.types import LabwareMovementOffsetData
 
 DEFAULT_GENERAL_ARC_Z_MARGIN: Final[float] = 10.0
 DEFAULT_IN_LABWARE_ARC_Z_MARGIN: Final[float] = 5.0
@@ -125,47 +124,41 @@ def get_gripper_labware_movement_waypoints(
     from_labware_center: Point,
     to_labware_center: Point,
     gripper_home_z: float,
-    offset_data: LabwareMovementOffsetData,
     post_drop_slide_offset: Optional[Point],
     gripper_home_z_offset: Optional[float] = None,
 ) -> List[GripperMovementWaypointsWithJawStatus]:
     """Get waypoints for moving labware using a gripper."""
-    pick_up_offset = offset_data.pickUpOffset
-    drop_offset = offset_data.dropOffset
-
-    pick_up_location = from_labware_center + Point(
-        pick_up_offset.x, pick_up_offset.y, pick_up_offset.z
-    )
-    drop_location = to_labware_center + Point(
-        drop_offset.x, drop_offset.y, drop_offset.z
-    )
-
     gripper_max_z_home = gripper_home_z - (gripper_home_z_offset or 0)
-
-    post_drop_home_pos = Point(drop_location.x, drop_location.y, gripper_home_z)
+    post_drop_home_pos = Point(to_labware_center.x, to_labware_center.y, gripper_home_z)
 
     waypoints_with_jaw_status = [
         GripperMovementWaypointsWithJawStatus(
-            position=Point(pick_up_location.x, pick_up_location.y, gripper_home_z),
+            position=Point(
+                from_labware_center.x, from_labware_center.y, gripper_home_z
+            ),
             jaw_open=False,
             dropping=False,
         ),
         GripperMovementWaypointsWithJawStatus(
-            position=pick_up_location, jaw_open=True, dropping=False
+            position=from_labware_center, jaw_open=True, dropping=False
         ),
         # Gripper grips the labware here
         GripperMovementWaypointsWithJawStatus(
-            position=Point(pick_up_location.x, pick_up_location.y, gripper_max_z_home),
+            position=Point(
+                from_labware_center.x, from_labware_center.y, gripper_max_z_home
+            ),
             jaw_open=False,
             dropping=False,
         ),
         GripperMovementWaypointsWithJawStatus(
-            position=Point(drop_location.x, drop_location.y, gripper_max_z_home),
+            position=Point(
+                to_labware_center.x, to_labware_center.y, gripper_max_z_home
+            ),
             jaw_open=False,
             dropping=False,
         ),
         GripperMovementWaypointsWithJawStatus(
-            position=drop_location, jaw_open=False, dropping=False
+            position=to_labware_center, jaw_open=False, dropping=False
         ),
         # Gripper ungrips here
         GripperMovementWaypointsWithJawStatus(
@@ -189,25 +182,18 @@ def get_gripper_labware_movement_waypoints(
 def get_gripper_labware_placement_waypoints(
     to_labware_center: Point,
     gripper_home_z: float,
-    drop_offset: Optional[Point],
 ) -> List[GripperMovementWaypointsWithJawStatus]:
     """Get waypoints for placing labware using a gripper."""
-    drop_offset = drop_offset or Point()
-
-    drop_location = to_labware_center + Point(
-        drop_offset.x, drop_offset.y, drop_offset.z
-    )
-
-    post_drop_home_pos = Point(drop_location.x, drop_location.y, gripper_home_z)
+    post_drop_home_pos = Point(to_labware_center.x, to_labware_center.y, gripper_home_z)
 
     return [
         GripperMovementWaypointsWithJawStatus(
-            position=Point(drop_location.x, drop_location.y, gripper_home_z),
+            position=Point(to_labware_center.x, to_labware_center.y, gripper_home_z),
             jaw_open=False,
             dropping=False,
         ),
         GripperMovementWaypointsWithJawStatus(
-            position=drop_location, jaw_open=False, dropping=False
+            position=to_labware_center, jaw_open=False, dropping=False
         ),
         # Gripper ungrips here
         GripperMovementWaypointsWithJawStatus(

opentrons/protocol_api/__init__.py

@@ -30,9 +30,11 @@ from .module_contexts import (
     AbsorbanceReaderContext,
     FlexStackerContext,
 )
+from .tasks import Task
 from .disposal_locations import TrashBin, WasteChute
 from ._liquid import Liquid, LiquidClass
 from ._types import (
+    OffDeckType,
     OFF_DECK,
     PLUNGER_BLOWOUT,
     PLUNGER_TOP,
@@ -88,6 +90,7 @@ __all__ = [
     "ROW",
     "ALL",
     # Deck location types
+    "OffDeckType",
     "OFF_DECK",
     # Pipette plunger types
     "PLUNGER_BLOWOUT",
@@ -99,6 +102,8 @@ __all__ = [
     "BLOWOUT_ACTION",
     "RuntimeParameterRequiredError",
     "CSVParameter",
+    # Concurrent task types
+    "Task",
     # For internal Opentrons use only:
     "create_protocol_context",
     "ProtocolEngineCoreRequiredError",

opentrons/protocol_api/_types.py

@@ -3,8 +3,13 @@ from typing_extensions import Final
 import enum
 
 
-# TODO (tz, 5-18-23): think about a better name for it that would also work when we include staging area slots in the type.
+# Implemented with an enum to support type narrowing via `== OFF_DECK`.
 class OffDeckType(enum.Enum):
+    """The type of the :py:obj:`OFF_DECK` constant.
+
+    Do not use directly, except in type annotations and ``isinstance`` calls.
+    """
+
     OFF_DECK = "off-deck"
 
 

opentrons/protocol_api/core/common.py

@@ -16,6 +16,7 @@ from .module import (
 from .protocol import AbstractProtocol
 from .well import AbstractWellCore
 from .robot import AbstractRobot
+from .tasks import AbstractTaskCore
 
 
 WellCore = AbstractWellCore
@@ -30,4 +31,5 @@ MagneticBlockCore = AbstractMagneticBlockCore[LabwareCore]
 AbsorbanceReaderCore = AbstractAbsorbanceReaderCore[LabwareCore]
 FlexStackerCore = AbstractFlexStackerCore[LabwareCore]
 RobotCore = AbstractRobot
-ProtocolCore = AbstractProtocol[InstrumentCore, LabwareCore, ModuleCore]
+TaskCore = AbstractTaskCore
+ProtocolCore = AbstractProtocol[InstrumentCore, LabwareCore, ModuleCore, TaskCore]

opentrons/protocol_api/core/engine/_default_labware_versions.py

@@ -112,6 +112,37 @@ DEFAULT_LABWARE_VERSIONS: DefaultLabwareVersions = {
         "thermoscientificnunc_96_wellplate_2000ul": 3,
         "usascientific_96_wellplate_2.4ml_deep": 3,
     },
+    APIVersion(2, 27): {
+        "agilent_1_reservoir_290ml": 4,
+        "axygen_1_reservoir_90ml": 3,
+        "biorad_96_wellplate_200ul_pcr": 5,
+        "corning_12_wellplate_6.9ml_flat": 5,
+        "corning_24_wellplate_3.4ml_flat": 5,
+        "corning_384_wellplate_112ul_flat": 5,
+        "corning_48_wellplate_1.6ml_flat": 6,
+        "corning_6_wellplate_16.8ml_flat": 5,
+        "corning_96_wellplate_360ul_flat": 5,
+        "nest_12_reservoir_15ml": 3,
+        "nest_1_reservoir_195ml": 4,
+        "nest_1_reservoir_290ml": 4,
+        "nest_96_wellplate_100ul_pcr_full_skirt": 5,
+        "nest_96_wellplate_200ul_flat": 5,
+        "nest_96_wellplate_2ml_deep": 5,
+        "opentrons_10_tuberack_falcon_4x50ml_6x15ml_conical": 3,
+        "opentrons_15_tuberack_falcon_15ml_conical": 3,
+        "opentrons_24_aluminumblock_nest_0.5ml_screwcap": 4,
+        "opentrons_24_aluminumblock_nest_1.5ml_screwcap": 3,
+        "opentrons_24_aluminumblock_nest_1.5ml_snapcap": 3,
+        "opentrons_24_aluminumblock_nest_2ml_screwcap": 3,
+        "opentrons_24_aluminumblock_nest_2ml_snapcap": 3,
+        "opentrons_24_tuberack_eppendorf_1.5ml_safelock_snapcap": 3,
+        "opentrons_24_tuberack_eppendorf_2ml_safelock_snapcap": 3,
+        "opentrons_24_tuberack_nest_0.5ml_screwcap": 4,
+        "opentrons_6_tuberack_nest_50ml_conical": 3,
+        "opentrons_96_aluminumblock_generic_pcr_strip_200ul": 4,
+        "usascientific_12_reservoir_22ml": 4,
+        "usascientific_96_wellplate_2.4ml_deep": 4,
+    },
 }
 
 
@@ -139,17 +170,7 @@ KNOWN_EXCEPTIONS_FOR_TESTS: set[str] = {
     "schema3test_flex_tiprack_lid",
     "schema3test_tough_pcr_auto_sealing_lid",
     "schema3test_universal_flat_adapter",
-    # These were supposed to be short-lived drafts as part of of a one-two punch of
-    # https://github.com/Opentrons/opentrons/pull/18266 + https://github.com/Opentrons/opentrons/pull/18284,
-    # but the second punch took a while. We should merge the second punch after v8.6.0
-    # and remove these exceptions as part of that.
-    "agilent_1_reservoir_290ml",
-    "corning_384_wellplate_112ul_flat",
-    "nest_1_reservoir_290ml",
-    "opentrons_24_aluminumblock_nest_0.5ml_screwcap",
-    "opentrons_24_tuberack_nest_0.5ml_screwcap",
-    "opentrons_96_aluminumblock_generic_pcr_strip_200ul",
-    "usascientific_12_reservoir_22ml",
+    "schema3test_96_wellplate_360ul_flat",
 }
 
 

opentrons/protocol_api/core/engine/labware.py

@@ -23,6 +23,7 @@ from opentrons.protocol_engine.clients import SyncClient as ProtocolEngineClient
 from opentrons.protocol_engine.types import (
     LabwareOffsetCreate,
     LabwareOffsetVector,
+    TipRackWellState,
 )
 from opentrons.types import DeckSlotName, NozzleMapInterface, Point, StagingSlotName
 
@@ -165,7 +166,13 @@ class LabwareCore(AbstractLabware[WellCore]):
 
     def reset_tips(self) -> None:
         if self.is_tip_rack():
-            self._engine_client.reset_tips(labware_id=self.labware_id)
+            self._engine_client.execute_command(
+                cmd.SetTipStateParams(
+                    labwareId=self._labware_id,
+                    wellNames=list(self._definition.wells),
+                    tipWellState=TipRackWellState.CLEAN,
+                )
+            )
         else:
             raise TypeError(f"{self.get_display_name()} is not a tip rack.")
 

opentrons/protocol_api/core/engine/module_core.py

@@ -317,6 +317,7 @@ class ThermocyclerModuleCore(ModuleCore, AbstractThermocyclerCore[LabwareCore]):
     def set_target_block_temperature(
         self,
         celsius: float,
+        ramp_rate: Optional[float],
         hold_time_seconds: Optional[float] = None,
         block_max_volume: Optional[float] = None,
     ) -> None:
@@ -327,6 +328,7 @@ class ThermocyclerModuleCore(ModuleCore, AbstractThermocyclerCore[LabwareCore]):
                 celsius=celsius,
                 blockMaxVolumeUl=block_max_volume,
                 holdTimeSeconds=hold_time_seconds,
+                ramp_rate=ramp_rate,
             )
         )
 
@@ -361,6 +363,7 @@ class ThermocyclerModuleCore(ModuleCore, AbstractThermocyclerCore[LabwareCore]):
             cmd.thermocycler.RunProfileStepParams(
                 celsius=step["temperature"],
                 holdSeconds=step["hold_time_seconds"],
+                rampRate=step["ramp_rate"],
             )
             for step in steps
         ]
@@ -389,6 +392,7 @@ class ThermocyclerModuleCore(ModuleCore, AbstractThermocyclerCore[LabwareCore]):
                     cmd.thermocycler.ProfileStep(
                         celsius=step["temperature"],
                         holdSeconds=step["hold_time_seconds"],
+                        rampRate=step["ramp_rate"],
                     )
                     for step in steps
                 ],

opentrons/protocol_api/core/engine/protocol.py

@@ -1,7 +1,7 @@
 """ProtocolEngine-based Protocol API core implementation."""
 
 from __future__ import annotations
-from typing import Dict, Optional, Type, Union, List, Tuple, TYPE_CHECKING
+from typing import Dict, Optional, Type, Union, List, Tuple, TYPE_CHECKING, Sequence
 
 from opentrons_shared_data.liquid_classes import LiquidClassDefinitionDoesNotExist
 from opentrons_shared_data.deck.types import DeckDefinitionV5, SlotDefV3
@@ -64,6 +64,7 @@ from ...disposal_locations import TrashBin, WasteChute
 from ..protocol import AbstractProtocol
 from ..labware import LabwareLoadParams
 from .labware import LabwareCore
+from .tasks import EngineTaskCore
 from .instrument import InstrumentCore
 from .robot import RobotCore
 from .module_core import (
@@ -95,6 +96,7 @@ class ProtocolCore(
         InstrumentCore,
         LabwareCore,
         Union[ModuleCore, NonConnectedModuleCore],
+        EngineTaskCore,
     ]
 ):
     """Protocol API core using a ProtocolEngine.
@@ -875,6 +877,21 @@ class ProtocolCore(
             cmd.WaitForDurationParams(seconds=seconds, message=msg)
         )
 
+    def wait_for_tasks(self, task_cores: Sequence[EngineTaskCore]) -> None:
+        """Wait for specified tasks to complete."""
+        task_ids = [task._id for task in task_cores]
+        self._engine_client.execute_command(cmd.WaitForTasksParams(task_ids=task_ids))
+
+    def create_timer(self, seconds: float) -> EngineTaskCore:
+        """Create a timer task that runs in the background."""
+        result = self._engine_client.execute_command_without_recovery(
+            cmd.CreateTimerParams(time=seconds)
+        )
+        timer_task = EngineTaskCore(
+            engine_client=self._engine_client, task_id=result.task_id
+        )
+        return timer_task
+
     def home(self) -> None:
         """Move all axes to their home positions."""
         self._engine_client.execute_command(cmd.HomeParams(axes=None))

opentrons/protocol_api/core/engine/tasks.py

@@ -0,0 +1,35 @@
+from datetime import datetime
+from ..tasks import AbstractTaskCore
+from opentrons.protocol_engine.clients import SyncClient as ProtocolEngineClient
+from opentrons.protocol_engine.errors.exceptions import NoTaskFoundError
+
+
+class EngineTaskCore(AbstractTaskCore):
+    def __init__(self, task_id: str, engine_client: ProtocolEngineClient) -> None:
+        self._id = task_id
+        self._engine_client = engine_client
+
+    def get_created_at_timestamp(self) -> datetime:
+        task = self._engine_client.state.tasks.get(self._id)
+        return task.createdAt
+
+    def is_done(self) -> bool:
+        try:
+            self._engine_client.state.tasks.get_finished(self._id)
+            return True
+        except NoTaskFoundError:
+            return False
+
+    def is_started(self) -> bool:
+        try:
+            self._engine_client.state.tasks.get_current(self._id)
+            return True
+        except NoTaskFoundError:
+            return self.is_done()
+
+    def get_finished_at_timestamp(self) -> datetime | None:
+        try:
+            finished_task = self._engine_client.state.tasks.get_finished(self._id)
+            return finished_task.finishedAt
+        except NoTaskFoundError:
+            return None

opentrons/protocol_api/core/legacy/legacy_module_core.py

@@ -263,6 +263,7 @@ class LegacyThermocyclerCore(
     def set_target_block_temperature(
         self,
         celsius: float,
+        ramp_rate: Optional[float],
         hold_time_seconds: Optional[float] = None,
         block_max_volume: Optional[float] = None,
     ) -> None:
@@ -271,6 +272,7 @@ class LegacyThermocyclerCore(
             celsius=celsius,
             hold_time_seconds=hold_time_seconds,
             volume=block_max_volume,
+            ramp_rate=ramp_rate,
         )
 
     def wait_for_block_temperature(self) -> None:

opentrons/protocol_api/core/legacy/legacy_protocol_core.py

@@ -1,5 +1,5 @@
 import logging
-from typing import Dict, List, Optional, Set, Union, cast, Tuple
+from typing import Dict, List, Optional, Set, Union, cast, Tuple, Sequence
 
 from opentrons_shared_data.deck.types import DeckDefinitionV5, SlotDefV3
 from opentrons_shared_data.labware.types import LabwareDefinition
@@ -34,6 +34,7 @@ from .legacy_instrument_core import LegacyInstrumentCore
 from .labware_offset_provider import AbstractLabwareOffsetProvider
 from .legacy_labware_core import LegacyLabwareCore
 from .load_info import LoadInfo, InstrumentLoadInfo, LabwareLoadInfo, ModuleLoadInfo
+from .tasks import LegacyTaskCore
 
 logger = logging.getLogger(__name__)
 
@@ -43,6 +44,7 @@ class LegacyProtocolCore(
         LegacyInstrumentCore,
         LegacyLabwareCore,
         legacy_module_core.LegacyModuleCore,
+        LegacyTaskCore,
     ]
 ):
     def __init__(
@@ -610,3 +612,11 @@ class LegacyProtocolCore(
     ]:
         """Get labware parent location."""
         assert False, "get_labware_location only supported on engine core"
+
+    def wait_for_tasks(self, task: Sequence[LegacyTaskCore]) -> None:
+        """Wait for list of tasks to complete before executing subsequent commands."""
+        assert False, "wait_for_tasks only supported on engine core"
+
+    def create_timer(self, seconds: float) -> LegacyTaskCore:
+        """Create a timer task that runs in the background."""
+        assert False, "create_timer only supported on engine core"

opentrons/protocol_api/core/legacy/tasks.py

@@ -0,0 +1,19 @@
+from ..tasks import AbstractTaskCore
+from datetime import datetime
+
+
+class LegacyTaskCore(AbstractTaskCore):
+    def __init__(self, created_at: datetime) -> None:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def get_created_at_timestamp(self) -> datetime:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def is_done(self) -> bool:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def is_started(self) -> bool:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def get_finished_at_timestamp(self) -> datetime | None:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")

opentrons/protocol_api/core/legacy_simulator/legacy_protocol_core.py

@@ -1,5 +1,5 @@
 import logging
-from typing import Dict, Optional
+from typing import Dict, Optional, Sequence
 
 from opentrons_shared_data.pipette.types import PipetteNameType
 from opentrons_shared_data.pipette.pipette_load_name_conversions import (
@@ -16,6 +16,7 @@ from ..legacy.legacy_module_core import LegacyModuleCore
 from ..legacy.load_info import InstrumentLoadInfo
 
 from .legacy_instrument_core import LegacyInstrumentCoreSimulator
+from .tasks import LegacyTaskCore
 
 logger = logging.getLogger(__name__)
 
@@ -23,7 +24,10 @@ logger = logging.getLogger(__name__)
 class LegacyProtocolCoreSimulator(
     LegacyProtocolCore,
     AbstractProtocol[
-        LegacyInstrumentCoreSimulator, LegacyLabwareCore, LegacyModuleCore
+        LegacyInstrumentCoreSimulator,
+        LegacyLabwareCore,
+        LegacyModuleCore,
+        LegacyTaskCore,
     ],
 ):
     _instruments: Dict[Mount, Optional[LegacyInstrumentCoreSimulator]]  # type: ignore[assignment]
@@ -83,3 +87,11 @@ class LegacyProtocolCoreSimulator(
         )
 
         return new_instr
+
+        def wait_for_tasks(self, task: Sequence[LegacyTaskCore]) -> None:
+            """Wait for list of tasks to complete before executing subsequent commands."""
+            assert False, "wait_for_tasks only supported on engine core"
+
+        def create_timer(self, seconds: float) -> LegacyTaskCore:
+            """Create a timer task that runs in the background."""
+            assert False, "create_timer only supported on engine core"

opentrons/protocol_api/core/legacy_simulator/tasks.py

@@ -0,0 +1,19 @@
+from ..tasks import AbstractTaskCore
+from datetime import datetime
+
+
+class LegacyTaskCore(AbstractTaskCore):
+    def __init__(self, created_at: datetime) -> None:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def get_created_at_timestamp(self) -> datetime:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def is_done(self) -> bool:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def is_started(self) -> bool:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")
+
+    def get_finished_at_timestamp(self) -> datetime | None:
+        raise NotImplementedError("Legacy protocols do not implement tasks.")

opentrons/protocol_api/core/module.py

@@ -161,6 +161,7 @@ class AbstractThermocyclerCore(
     def set_target_block_temperature(
         self,
         celsius: float,
+        ramp_rate: Optional[float],
         hold_time_seconds: Optional[float] = None,
         block_max_volume: Optional[float] = None,
     ) -> None: