benchling-sdk 1.21.1__tar.gz → 1.22.0a0__tar.gz

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: benchling-sdk
-Version: 1.21.1
+Version: 1.22.0a0
 Summary: SDK for interacting with the Benchling Platform.
 License: Apache-2.0
 Author: Benchling Support
@@ -16,7 +16,7 @@ Provides-Extra: python-jose
 Requires-Dist: PyYAML (>=6.0,<7.0)
 Requires-Dist: attrs (>=20.1.0)
 Requires-Dist: backoff (>=1.10.0,<3)
-Requires-Dist: benchling-api-client (==2.0.342)
+Requires-Dist: benchling-api-client (==2.0.387)
 Requires-Dist: certifi (>=2022.12.7)
 Requires-Dist: cryptography (>=42.0.0) ; extra == "cryptography"
 Requires-Dist: dataclasses-json (>=0.5.2,<0.6.0)
@@ -26,6 +26,7 @@ Requires-Dist: ordered-set (>=4.1.0,<5.0.0)
 Requires-Dist: psutil (>=5.9.4,<6.0.0) ; python_version >= "3.11" and python_version < "4.0"
 Requires-Dist: python-dateutil (>=2.8.0,<3.0.0)
 Requires-Dist: python-jose[cryptography] (>=3.3.0,<4.0.0) ; extra == "python-jose"
+Requires-Dist: setuptools (==68.0.0)
 Description-Content-Type: text/markdown
 
 # Benchling SDK

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/canvas/types.py

@@ -15,6 +15,9 @@ from benchling_sdk.models import (
     DropdownUiBlock,
     DropdownUiBlockCreate,
     DropdownUiBlockUpdate,
+    FileUploadUiBlock,
+    FileUploadUiBlockCreate,
+    FileUploadUiBlockUpdate,
     MarkdownUiBlock,
     MarkdownUiBlockCreate,
     MarkdownUiBlockUpdate,
@@ -46,6 +49,7 @@ UiBlock = Union[
     ChipUiBlock,
     DropdownMultiValueUiBlock,
     DropdownUiBlock,
+    FileUploadUiBlock,
     MarkdownUiBlock,
     SearchInputMultiValueUiBlock,
     SearchInputUiBlock,
@@ -67,6 +71,7 @@ _UiBlockCreate = Union[
     ChipUiBlockCreate,
     DropdownMultiValueUiBlockCreate,
     DropdownUiBlockCreate,
+    FileUploadUiBlockCreate,
     MarkdownUiBlockCreate,
     SearchInputMultiValueUiBlockCreate,
     SearchInputUiBlockCreate,
@@ -83,6 +88,7 @@ _UiBlockUpdate = Union[
     ChipUiBlockUpdate,
     DropdownMultiValueUiBlockUpdate,
     DropdownUiBlockUpdate,
+    FileUploadUiBlockUpdate,
     MarkdownUiBlockUpdate,
     SearchInputMultiValueUiBlockUpdate,
     SearchInputUiBlockUpdate,
@@ -99,6 +105,7 @@ _UI_BLOCK_MAPPINGS_CREATE = {
     ChipUiBlock: ChipUiBlockCreate,
     DropdownMultiValueUiBlock: DropdownMultiValueUiBlockCreate,
     DropdownUiBlock: DropdownUiBlockCreate,
+    FileUploadUiBlock: FileUploadUiBlockCreate,
     MarkdownUiBlock: MarkdownUiBlockCreate,
     SearchInputMultiValueUiBlock: SearchInputMultiValueUiBlockCreate,
     SearchInputUiBlock: SearchInputUiBlockCreate,
@@ -114,6 +121,7 @@ _UI_BLOCK_MAPPINGS_UPDATE = {
     ChipUiBlock: ChipUiBlockUpdate,
     DropdownMultiValueUiBlock: DropdownMultiValueUiBlockUpdate,
     DropdownUiBlock: DropdownUiBlockUpdate,
+    FileUploadUiBlock: FileUploadUiBlockUpdate,
     MarkdownUiBlock: MarkdownUiBlockUpdate,
     SearchInputMultiValueUiBlock: SearchInputMultiValueUiBlockUpdate,
     SearchInputUiBlock: SearchInputUiBlockUpdate,

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/config/framework.py

@@ -228,7 +228,7 @@ class ConfigItemStore:
     _configuration_provider: ConfigProvider
     _configuration: Optional[List[ConfigurationReference]] = None
     _configuration_dict: Optional[Dict[ConfigItemPath, ConfigItemWrapper]] = None
-    _array_path_row_names: Dict[Tuple[str, ...], OrderedSet[str]] = dict()
+    _array_path_row_names: Dict[Tuple[str, ...], OrderedSet[str]]
 
     def __init__(self, configuration_provider: ConfigProvider):
         """
@@ -302,7 +302,7 @@ class ConfigItemStore:
                     # The +1 is the name of the array row
                     if len(config_item.path) >= len(path) + 1
                     # Ignoring flake8 error E203 because black keeps putting in whitespace padding :
-                    and config_item.path[0 : len(path_tuple)] == path  # noqa: E203
+                    and config_item.path[0 : len(path_tuple)] == path
                     and config_item.value is not None
                 ]
             )

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/config/helpers.py

@@ -1,6 +1,6 @@
 from datetime import datetime
 from enum import Enum
-from functools import lru_cache
+from functools import cache
 from typing import cast, List, Optional, Union
 
 from benchling_api_client.v2.beta.extensions import Enums
@@ -47,7 +47,8 @@ class _UnsupportedSubTypeError(Exception):
 
 
 class _ScalarConfigTypes(Enums.KnownString):
-    """Enum type copied from an earlier version of benchling-api-client, for internal use only.
+    """
+    Enum type copied from an earlier version of benchling-api-client, for internal use only.
 
     See BNCH-108704.
     """
@@ -65,12 +66,12 @@ class _ScalarConfigTypes(Enums.KnownString):
         return str(self.value)
 
     @staticmethod
-    @lru_cache(maxsize=None)
+    @cache
     def of_unknown(val: str) -> "_ScalarConfigTypes":
         if not isinstance(val, str):
             raise ValueError(f"Value of _ScalarConfigTypes must be a string (encountered: {val})")
         newcls = Enum("_ScalarConfigTypes", {"_UNKNOWN": val}, type=Enums.UnknownString)  # type: ignore
-        return cast(_ScalarConfigTypes, getattr(newcls, "_UNKNOWN"))
+        return cast(_ScalarConfigTypes, newcls._UNKNOWN)
 
 
 def _field_definitions_from_dependency(
@@ -122,7 +123,7 @@ def _enum_from_dependency(
 
 
 # TODO BNCH-57036 All element definitions currently deserialize to UnknownType. Hack around this temporarily
-def _fix_element_definition_deserialization(
+def _fix_element_definition_deserialization(  # noqa:PLR0911
     element: Union[UnknownType, _ArrayElementDependency]
 ) -> _ArrayElementDependency:
     if isinstance(element, UnknownType):

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/config/mock_config.py

@@ -345,7 +345,7 @@ def mock_text_app_config_item(path: List[str], value: Optional[str]) -> TextAppC
     )
 
 
-def _mock_dependency(
+def _mock_dependency(  # noqa:PLR0911
     dependency: ManifestDependencies,
     parent_path: Optional[List[str]] = None,
 ) -> List[AppConfigItem]:
@@ -451,7 +451,7 @@ def _convert_entity_subtype(manifest_subtype: SchemaDependencySubtypesBeta) -> S
     return SchemaDependencySubtypes(source_value)
 
 
-def _mock_scalar_dependency(
+def _mock_scalar_dependency(  # noqa:PLR0911
     dependency: ManifestScalarConfig, parent_path: Optional[List[str]] = None
 ) -> AppConfigItem:
     parent_path = parent_path if parent_path else []
@@ -502,7 +502,7 @@ def _mock_array_dependency(
 ) -> List[AppConfigItem]:
     config_rows = []
     parent_path = parent_path if parent_path else []
-    for i in range(rows):
+    for _ in range(rows):
         row = _mock_array_row(dependency, parent_path=parent_path)
         elements = _element_definition_from_dependency(dependency)
         element_configs = [_mock_dependency(element, row.path) for element in elements]
@@ -594,7 +594,7 @@ def _mock_linked_resource(id: str, name: Optional[str] = None) -> LinkedAppConfi
     return LinkedAppConfigResourceSummary(id=id, name=name if name else _random_string("Resource Name"))
 
 
-def _mock_scalar_value(
+def _mock_scalar_value(  # noqa:PLR0911
     dependency: ManifestScalarConfig,
 ) -> Union[bool, date, datetime, int, float, str, Dict[str, Union[str, float]]]:
     """Mock a scalar config value from its manifest definition."""

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/helpers/webhook_helpers.py

@@ -276,8 +276,8 @@ def _verify_timestamp(timestamp_header: str) -> None:
     now = datetime.now(tz=timezone.utc)
     try:
         timestamp = datetime.fromtimestamp(float(timestamp_header), tz=timezone.utc)
-    except Exception:
-        raise WebhookVerificationError("Invalid Signature Headers")
+    except Exception as exc:
+        raise WebhookVerificationError("Invalid Signature Headers") from exc
     if timestamp < (now - webhook_tolerance):
         raise WebhookVerificationError("Message timestamp too old")
     if timestamp > (now + webhook_tolerance):

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/status/framework.py

@@ -286,10 +286,7 @@ class SessionClosingContextExitHandler(SessionContextExitHandler):
         error_messages: Optional[Iterable[AppSessionMessageCreate]] = [
             AppSessionMessageCreate(_DEFAULT_APP_ERROR_MESSAGE, style=AppSessionMessageStyle.ERROR)
         ],
-        error_processors: List[Type[SessionContextErrorProcessor]] = [
-            AppUserFacingErrorProcessor,
-            BenchlingBadRequestErrorProcessor,
-        ],
+        error_processors: Optional[List[Type[SessionContextErrorProcessor]]] = None,
         enable_attached_canvas_on_error: bool = True,
     ):
         """
@@ -300,7 +297,10 @@ class SessionClosingContextExitHandler(SessionContextExitHandler):
         """
         self._success_messages = success_messages
         self._error_messages = error_messages
-        self._error_processors = error_processors
+        self._error_processors = error_processors or [
+            AppUserFacingErrorProcessor,
+            BenchlingBadRequestErrorProcessor,
+        ]
         self._enable_attached_canvas_on_error = enable_attached_canvas_on_error
 
     def on_success(self, context: SessionContextManager) -> bool:

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/apps/status/helpers.py

@@ -13,6 +13,7 @@ def ref(reference: ReferencedSessionLinkType) -> str:
     Example:
         dna_sequence = benchling.dna_sequences.get_by_id("seq_1234")
         AppSessionMessageCreate(f"This is my DNA sequence {ref(dna_sequence)} for analysis")
+
     """
     return ref_by_id(reference.id)
 
@@ -28,6 +29,7 @@ def ref_by_id(reference_id: str) -> str:
     Example:
         dna_sequence_id: str = "seq_asQya4lk"
         AppSessionMessageCreate(f"This is my DNA sequence {ref_by_id(dna_sequence_id)} for analysis")
+
     """
     assert reference_id, "reference_id cannot be empty or None"
     return _encode_id(reference_id)

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/auth/client_credentials_oauth2.py

@@ -1,9 +1,10 @@
 from __future__ import annotations
 
 import base64
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from json import JSONDecodeError
 import threading
+import typing
 from typing import NoReturn, Optional
 from urllib.parse import urljoin
 
@@ -31,7 +32,7 @@ class Token:
 
     def valid(self) -> bool:
         """Return whether token is still valid for use or should be regenerated."""
-        return datetime.now() < self.refresh_time
+        return datetime.now(timezone.utc) < self.refresh_time
 
     @classmethod
     def from_token_response(cls, token_response) -> Token:
@@ -50,7 +51,7 @@ class Token:
         # Add in a buffer to safeguard against race conditions with token expiration.
         # Buffer is 10% of expires_in time, clamped between [1, MINIMUM_TOKEN_EXPIRY_BUFFER] seconds.
         refresh_delta = expires_in - max(1, min(MINIMUM_TOKEN_EXPIRY_BUFFER, expires_in * 0.1))
-        refresh_time = datetime.now() + timedelta(seconds=refresh_delta)
+        refresh_time = datetime.now(timezone.utc) + timedelta(seconds=refresh_delta)
         return cls(access_token, refresh_time)
 
 
@@ -62,7 +63,7 @@ class ClientCredentialsOAuth2(AuthorizationMethod):
     type.
     """
 
-    _data_for_token_request = {
+    _data_for_token_request: typing.ClassVar[dict] = {
         "grant_type": "client_credentials",
     }
 

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/benchling.py

@@ -1,4 +1,5 @@
 """Provides the Benchling class, which is the main interface for accessing Benchling's API functionality."""
+
 from __future__ import annotations
 
 from functools import cached_property
@@ -18,12 +19,16 @@ if TYPE_CHECKING:
     from benchling_sdk.services.v2.stable.app_service import AppService
     from benchling_sdk.services.v2.stable.assay_result_service import AssayResultService
     from benchling_sdk.services.v2.stable.assay_run_service import AssayRunService
+    from benchling_sdk.services.v2.stable.audit_service import AuditService
     from benchling_sdk.services.v2.stable.blob_service import BlobService
     from benchling_sdk.services.v2.stable.box_service import BoxService
     from benchling_sdk.services.v2.stable.codon_usage_table_service import CodonUsageTableService
+    from benchling_sdk.services.v2.stable.connect_service import ConnectService
     from benchling_sdk.services.v2.stable.container_service import ContainerService
     from benchling_sdk.services.v2.stable.custom_entity_service import CustomEntityService
     from benchling_sdk.services.v2.stable.custom_notation_service import CustomNotationService
+    from benchling_sdk.services.v2.stable.data_frame_service import DataFrameService
+    from benchling_sdk.services.v2.stable.dataset_service import DatasetService
     from benchling_sdk.services.v2.stable.dna_alignments_service import DnaAlignmentsService
     from benchling_sdk.services.v2.stable.dna_oligo_service import DnaOligoService
     from benchling_sdk.services.v2.stable.dna_sequence_service import DnaSequenceService
@@ -34,11 +39,13 @@ if TYPE_CHECKING:
     from benchling_sdk.services.v2.stable.event_service import EventService
     from benchling_sdk.services.v2.stable.export_service import ExportService
     from benchling_sdk.services.v2.stable.feature_library_service import FeatureLibraryService
+    from benchling_sdk.services.v2.stable.file_service import FileService
     from benchling_sdk.services.v2.stable.folder_service import FolderService
     from benchling_sdk.services.v2.stable.instrument_query_service import InstrumentQueryService
     from benchling_sdk.services.v2.stable.inventory_service import InventoryService
     from benchling_sdk.services.v2.stable.lab_automation_service import LabAutomationService
     from benchling_sdk.services.v2.stable.label_template_service import LabelTemplateService
+    from benchling_sdk.services.v2.stable.legacy_request_service import LegacyRequestService
     from benchling_sdk.services.v2.stable.location_service import LocationService
     from benchling_sdk.services.v2.stable.mixture_service import MixtureService
     from benchling_sdk.services.v2.stable.molecule_service import MoleculeService
@@ -50,12 +57,12 @@ if TYPE_CHECKING:
     from benchling_sdk.services.v2.stable.printer_service import PrinterService
     from benchling_sdk.services.v2.stable.project_service import ProjectService
     from benchling_sdk.services.v2.stable.registry_service import RegistryService
-    from benchling_sdk.services.v2.stable.request_service import RequestService
     from benchling_sdk.services.v2.stable.rna_oligo_service import RnaOligoService
     from benchling_sdk.services.v2.stable.rna_sequence_service import RnaSequenceService
     from benchling_sdk.services.v2.stable.schema_service import SchemaService
     from benchling_sdk.services.v2.stable.task_service import TaskService
     from benchling_sdk.services.v2.stable.team_service import TeamService
+    from benchling_sdk.services.v2.stable.test_order_service import TestOrderService
     from benchling_sdk.services.v2.stable.user_service import UserService
     from benchling_sdk.services.v2.stable.warehouse_service import WarehouseService
     from benchling_sdk.services.v2.stable.workflow_flowchart_config_version_service import (
@@ -96,7 +103,7 @@ _DEFAULT_BASE_PATH = "/api/v2"
 _DEFAULT_RETRY_STRATEGY = RetryStrategy()
 
 
-class Benchling(object):
+class Benchling:
     """
     A facade for interactions with the Benchling platform.
 
@@ -213,7 +220,7 @@ class Benchling(object):
 
         See https://benchling.com/api/reference#/Apps
         and https://docs.benchling.com/docs/getting-started-benchling-apps
-        """
+        """  # noqa:RUF002  # Ruff gets confused by a trailing apostrophe with a plural noun
         return self.v2.stable.apps
 
     @property
@@ -239,6 +246,17 @@ class Benchling(object):
         """
         return self.v2.stable.assay_runs
 
+    @property
+    def audit(self) -> AuditService:
+        """
+        Audits.
+
+        Export audit log data for Benchling objects.
+
+        https://benchling.com/api/reference#/Audit
+        """
+        return self.v2.stable.audit
+
     @property
     def blobs(self) -> BlobService:
         """
@@ -281,6 +299,17 @@ class Benchling(object):
         """
         return self.v2.stable.codon_usage_tables
 
+    @property
+    def connect(self) -> ConnectService:
+        """
+        Connect.
+
+        Connect endpoints support Benchling Connect actions, like instrument data conversion.
+
+        See https://benchling.com/api/reference#/Connect
+        """
+        return self.v2.stable.connect
+
     @property
     def containers(self) -> ContainerService:
         """
@@ -323,6 +352,29 @@ class Benchling(object):
         """
         return self.v2.stable.custom_notations
 
+    @property
+    def data_frames(self) -> DataFrameService:
+        """
+        DataFrames.
+
+        DataFrames are Benchling objects that represent tabular data with typed columns and rows of data.
+
+        See https://benchling.com/api/v2/reference#/Data%20Frames
+        """
+        return self.v2.stable.data_frames
+
+    @property
+    def datasets(self) -> DatasetService:
+        """
+        Datasets.
+
+        Datasets are Benchling objects that represent tabular data with typed columns and rows of data. Unlike
+        Data Frames, Datasets are located in folders and can be searched in the UI.
+
+        See https://benchling.com/api/v2/reference#/Datasets
+        """
+        return self.v2.stable.datasets
+
     @property
     def dna_alignments(self) -> DnaAlignmentsService:
         """
@@ -451,6 +503,19 @@ class Benchling(object):
         """
         return self.v2.stable.feature_libraries
 
+    @property
+    def files(self) -> FileService:
+        """
+        Files.
+
+        Files are Benchling objects that represent files and their metadata. Compared to Blobs, which are used
+        by most Benchling products for attachments, Files are primarily used in the Analysis and Connect
+        product.
+
+        See https://benchling.com/api/v2/reference#/Files
+        """
+        return self.v2.stable.files
+
     @property
     def folders(self) -> FolderService:
         """
@@ -507,6 +572,17 @@ class Benchling(object):
         """
         return self.v2.stable.label_templates
 
+    @property
+    def legacy_requests(self) -> LegacyRequestService:
+        """
+        Legacy Requests.
+
+        Legacy Requests allow scientists and teams to collaborate around experimental assays and workflows.
+
+        See https://benchling.com/api/reference#/Legacy%20Requests
+        """
+        return self.v2.stable.legacy_requests
+
     @property
     def locations(self) -> LocationService:
         """
@@ -642,17 +718,6 @@ class Benchling(object):
         """
         return self.v2.stable.registry
 
-    @property
-    def requests(self) -> RequestService:
-        """
-        Requests.
-
-        Requests allow scientists and teams to collaborate around experimental assays and workflows.
-
-        See https://benchling.com/api/reference#/Requests
-        """
-        return self.v2.stable.requests
-
     @property
     def rna_oligos(self) -> RnaOligoService:
         """
@@ -706,6 +771,17 @@ class Benchling(object):
         """
         return self.v2.stable.teams
 
+    @property
+    def test_orders(self) -> TestOrderService:
+        """
+        Test Orders.
+
+        Test orders enable users to order tests for specific sample/container combinations that will be fulfilled in assays.
+
+        See https://benchling.com/api/reference?availability=la#/Test%20Orders/
+        """
+        return self.v2.stable.test_orders
+
     @property
     def users(self) -> UserService:
         """

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/errors.py

@@ -26,7 +26,8 @@ logger = default_logger()
 
 @dataclass
 class BenchlingError(Exception):
-    """An error resulting from communicating with the Benchling API.
+    """
+    An error resulting from communicating with the Benchling API.
 
     This could be an error returned from the API intentionally (e.g., 400 Bad Request) or an
     unexpected transport error (e.g., 502 Bad Gateway)
@@ -53,7 +54,7 @@ class BenchlingError(Exception):
     ]
 
     @classmethod
-    def from_response(cls, response: Response) -> "BenchlingError":
+    def from_response(cls, response: Response) -> BenchlingError:
         """Create a BenchlingError from a generated Response."""
         json_body = _parse_error_body(response.content)
         return cls(
@@ -95,7 +96,7 @@ class RegistrationError(Exception):
     task_status: Optional[AsyncTaskStatus] = None
 
     @classmethod
-    def from_task(cls, task: AsyncTask) -> "RegistrationError":
+    def from_task(cls, task: AsyncTask) -> RegistrationError:
         """Create a RegistrationError from a failed AsyncTask."""
         task_errors = unset_as_none(task.errors)
         errors_dict: Dict[Any, Any] = task_errors.to_dict() if task_errors else dict()  # type: ignore

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/helpers/retry_helpers.py

@@ -14,7 +14,7 @@ logging.getLogger("backoff").setLevel(logging.CRITICAL)
 
 
 @dataclass(frozen=True, eq=True)
-class RetryStrategy(object):
+class RetryStrategy:
     """Specify a strategy for automatically retrying failed HTTP calls."""
 
     # Passing in None results in unbounded retries

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/helpers/serialization_helpers.py

@@ -29,7 +29,8 @@ class SerializableModel(DataClassJsonMixin):
 
 @dataclass
 class DeserializableModel(DataClassJsonMixin):
-    """Provide an interface for deserialization to a custom model.
+    """
+    Provide an interface for deserialization to a custom model.
 
     For deserializing models when using raw API calls (e.g., Benchling.api)
     Override deserialize() for customized behavior.
@@ -50,7 +51,8 @@ class DeserializableModelNoContent(DeserializableModel):
 
 
 def optional_array_query_param(inputs: Optional[Iterable[str]]) -> Optional[str]:
-    """Collapse an Iterable to a comma-separated string if present.
+    """
+    Collapse an Iterable to a comma-separated string if present.
 
     Add leading and trailing quotes if the item contains "," and not quoted
     """
@@ -58,7 +60,8 @@ def optional_array_query_param(inputs: Optional[Iterable[str]]) -> Optional[str]
 
 
 def array_query_param(inputs: Iterable[str]) -> str:
-    """Collapse an Iterable to a comma-separated string.
+    """
+    Collapse an Iterable to a comma-separated string.
 
     Add leading and trailing quotes if the item contains "," and not quoted
     """

{benchling_sdk-1.21.1 → benchling_sdk-1.22.0a0}/benchling_sdk/helpers/task_helpers.py

@@ -1,10 +1,10 @@
 from dataclasses import dataclass
-from typing import Any, cast, Generic, Optional, Type, TypeVar
+from typing import Any, cast, Generic, List, Optional, Type, TypeVar, Union
 
 from benchling_api_client.v2.stable.client import Client
 
 from benchling_sdk.helpers.serialization_helpers import unset_as_none
-from benchling_sdk.models import AsyncTaskErrors, AsyncTaskLink, AsyncTaskStatus
+from benchling_sdk.models import AsyncTaskErrors, AsyncTaskErrorsItem, AsyncTaskLink, AsyncTaskStatus
 
 ResponseT = TypeVar("ResponseT")
 
@@ -14,7 +14,7 @@ class TaskCompletion(Generic[ResponseT]):
     """Return type for TaskHelper.wait_for_task, same as AsyncTask but with a typed response."""
 
     success: bool
-    errors: Optional[AsyncTaskErrors] = None
+    errors: Optional[Union[AsyncTaskErrors, List[AsyncTaskErrorsItem]]] = None
     message: Optional[str] = None
     response: Optional[ResponseT] = None
 
@@ -23,7 +23,7 @@ class TaskCompletion(Generic[ResponseT]):
 class TaskFailureException(Exception):
     """Exception type used by :py:class:`.TaskHelper` methods."""
 
-    errors: AsyncTaskErrors
+    errors: Union[AsyncTaskErrors, List[AsyncTaskErrorsItem]]
     message: Optional[str]
 
 
@@ -37,7 +37,8 @@ EMPTY_TASK_RESPONSE = EmptyTaskResponse()
 
 
 class TaskHelper(AsyncTaskLink, Generic[ResponseT]):
-    """Used by Benchling async task endpoints to provide the task response in an appropriate type.
+    """
+    Used by Benchling async task endpoints to provide the task response in an appropriate type.
 
     In the API spec, endpoints that create a long-running task are defined as returning an
     :py:class:`benchling_sdk.models.AsyncTaskLink`, which can be used with
@@ -70,12 +71,13 @@ class TaskHelper(AsyncTaskLink, Generic[ResponseT]):
 
         if response_class is not EmptyTaskResponse:
             assert hasattr(response_class, "from_dict")
-            self._response_decoder = getattr(response_class, "from_dict")
+            self._response_decoder = getattr(response_class, "from_dict")  # noqa: B009
 
     def wait_for_completion(
         self, interval_wait_seconds: int = 1, max_wait_seconds: int = 600
     ) -> TaskCompletion[ResponseT]:
-        """Wait for the task to succeed or fail.
+        """
+        Wait for the task to succeed or fail.
 
         This is equivalent to the :py:meth:`benchling_sdk.services.v2.stable.task_service.TaskService.wait_for_task`
         method in :py:class:`benchling_sdk.services.v2.stable.task_service.TaskService`, except that
@@ -110,13 +112,14 @@ class TaskHelper(AsyncTaskLink, Generic[ResponseT]):
         message = None if task.status != AsyncTaskStatus.FAILED else unset_as_none(task.message)
         return TaskCompletion(
             success=task.status == AsyncTaskStatus.SUCCEEDED,
-            errors=errors,
+            errors=errors,  # type: ignore
             message=message,
             response=response,
         )
 
     def wait_for_response(self, interval_wait_seconds: int = 1, max_wait_seconds: int = 600) -> ResponseT:
-        """Wait for the task and return the response object on success, or raise an exception on failure.
+        """
+        Wait for the task and return the response object on success, or raise an exception on failure.
 
         This is a convenience method for calling :py:meth:`wait_for_completion` and then getting the
         `response` property of the returned object if the task succeeded, in cases where you're not