fix(core): match AttachmentsProtocol.upload_async to the concrete overloads

packages/uipath-core/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-core"
-version = "0.5.22"
+version = "0.5.23"
 description = "UiPath Core abstractions"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

packages/uipath-core/src/uipath/core/workspace/protocols.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Protocol, runtime_checkable
+from typing import Protocol, overload, runtime_checkable
 from uuid import UUID
 
 
@@ -20,6 +20,28 @@ async def download_async(
     ) -> str:
         """Download an attachment to a local path."""
 
+    # Overloads mirror the concrete AttachmentsService: content XOR source_path,
+    # so the real service is a structural subtype of this protocol.
+    @overload
+    async def upload_async(
+        self,
+        *,
+        name: str,
+        content: str | bytes,
+        folder_key: str | None = None,
+        folder_path: str | None = None,
+    ) -> UUID: ...
+
+    @overload
+    async def upload_async(
+        self,
+        *,
+        name: str,
+        source_path: str,
+        folder_key: str | None = None,
+        folder_path: str | None = None,
+    ) -> UUID: ...
+
     async def upload_async(
         self,
         *,

packages/uipath-platform/tests/services/test_attachments_service.py

@@ -1193,3 +1193,17 @@ async def test_open_async_write_mode(
         assert upload_request is not None
         assert upload_request.method == "PUT"
         assert upload_request.url == blob_uri_response["BlobFileAccess"]["Uri"]
+
+
+def test_attachments_service_conforms_to_attachments_protocol(
+    service: AttachmentsService,
+) -> None:
+    """AttachmentsService must satisfy AttachmentsProtocol (workspace hydration).
+
+    The static annotation makes mypy verify the upload_async overloads line up;
+    the isinstance check covers the runtime_checkable contract.
+    """
+    from uipath.core.workspace import AttachmentsProtocol
+
+    conforming: AttachmentsProtocol = service
+    assert isinstance(conforming, AttachmentsProtocol)