fix(api): update PipetteNotReadyToAspirateError message to not just blowouts (#19087)

# Overview

Currently, if you try to aspirate after the plunger has been pushed
below the zero position, you get an error message like:
```
Pipette cannot aspirate in place because of a previous blow out.
The first aspirate following a blow-out must be from a specific well
so the plunger can be reset in a known safe position.
```

This is misleading because the `PipetteNotReadyToAspirateError` can be
triggered by blowouts, pushouts, or dispenses with correction volumes.
In fact, all the recent bugs we encountered with
`PipetteNotReadyToAspirateError` have been due to actions that are
**not** blowouts, so this message text is confusing to users.

This PR changes the error message to explain that the
`PipetteNotReadyToAspirateError` is happening because of a previous
dispense or blowout.

## Test Plan and Hands on Testing

Updated unit tests. Will rely on CI to see if there's anything else I
need to update.

## Review requests

@ecormany Want to help me with the wording?

## Risk assessment

Low.

Author: ddcc4

api/src/opentrons/protocol_engine/commands/air_gap_in_place.py

@@ -89,9 +89,10 @@ async def execute(self, params: AirGapInPlaceParams) -> _ExecuteReturn:
         )
         if not ready_to_aspirate:
             raise PipetteNotReadyToAspirateError(
-                "Pipette cannot air gap in place because of a previous blow out."
-                " The first aspirate following a blow-out must be from a specific well"
-                " so the plunger can be reset in a known safe position."
+                "Pipette cannot air gap in place because a previous dispense or blowout"
+                " pushed the plunger beyond the bottom position."
+                " The subsequent aspirate must be from a specific well so the plunger"
+                " can be reset in a known safe position."
             )
 
         state_update = StateUpdate()

api/src/opentrons/protocol_engine/commands/aspirate_in_place.py

@@ -87,9 +87,10 @@ async def execute(self, params: AspirateInPlaceParams) -> _ExecuteReturn:
         )
         if not ready_to_aspirate:
             raise PipetteNotReadyToAspirateError(
-                "Pipette cannot aspirate in place because of a previous blow out."
-                " The first aspirate following a blow-out must be from a specific well"
-                " so the plunger can be reset in a known safe position."
+                "Pipette cannot aspirate in place because a previous dispense or blowout"
+                " pushed the plunger beyond the bottom position."
+                " The subsequent aspirate must be from a specific well so the plunger"
+                " can be reset in a known safe position."
             )
 
         current_position = await self._gantry_mover.get_position(params.pipetteId)

api/src/opentrons/protocol_engine/commands/aspirate_while_tracking.py

@@ -100,9 +100,10 @@ async def execute(self, params: AspirateWhileTrackingParams) -> _ExecuteReturn:
         )
         if not ready_to_aspirate:
             raise PipetteNotReadyToAspirateError(
-                "Pipette cannot aspirate while tracking because of a previous blow out."
-                " The first aspirate following a blow-out must be from a specific well"
-                " so the plunger can be reset in a known safe position."
+                "Pipette cannot aspirate while tracking because a previous dispense or"
+                " blowout pushed the plunger beyond the bottom position."
+                " The subsequent aspirate must be from a specific well so the plunger"
+                " can be reset in a known safe position."
             )
         state_update = StateUpdate()
 

api/src/opentrons/protocol_engine/commands/liquid_probe.py

@@ -156,7 +156,8 @@ async def _execute_common(  # noqa: C901
         # only way for this to happen is if someone tries to do a liquid probe with
         # a tip that's previously held liquid, which they should avoid anyway.
         raise PipetteNotReadyToAspirateError(
-            "The pipette cannot probe liquid because of a previous blow out."
+            "The pipette cannot probe liquid because a previous dispense or blowout"
+            " pushed the plunger beyond the bottom position."
             " The plunger must be reset while the tip is somewhere away from liquid."
         )
     elif aspirated_volume != 0:

api/tests/opentrons/protocol_engine/commands/test_air_gap_in_place.py

@@ -171,9 +171,7 @@ async def test_handle_air_gap_in_place_request_not_ready_to_aspirate(
 
     with pytest.raises(
         PipetteNotReadyToAspirateError,
-        match="Pipette cannot air gap in place because of a previous blow out."
-        " The first aspirate following a blow-out must be from a specific well"
-        " so the plunger can be reset in a known safe position.",
+        match="Pipette cannot air gap in place because a previous",
     ):
         await subject.execute(params=data)
 

api/tests/opentrons/protocol_engine/commands/test_aspirate_in_place.py

@@ -199,9 +199,7 @@ async def test_handle_aspirate_in_place_request_not_ready_to_aspirate(
     ).then_return(False)
     with pytest.raises(
         PipetteNotReadyToAspirateError,
-        match="Pipette cannot aspirate in place because of a previous blow out."
-        " The first aspirate following a blow-out must be from a specific well"
-        " so the plunger can be reset in a known safe position.",
+        match="Pipette cannot aspirate in place because a previous",
     ):
         await subject.execute(params=data)
 

api/tests/opentrons/protocol_engine/commands/test_aspirate_while_tracking.py

@@ -237,9 +237,7 @@ async def test_handle_aspirate_while_tracking_request_not_ready_to_aspirate(
     )
     with pytest.raises(
         PipetteNotReadyToAspirateError,
-        match="Pipette cannot aspirate while tracking because of a previous blow out."
-        " The first aspirate following a blow-out must be from a specific well"
-        " so the plunger can be reset in a known safe position.",
+        match="Pipette cannot aspirate while tracking because a previous",
     ):
         await subject.execute(params=data)