synapse-sdk 2025.9.5__py3-none-any.whl → 2025.10.6__py3-none-any.whl

synapse_sdk/utils/file/download.py

@@ -13,6 +13,58 @@ from .io import get_temp_path
 
 
 def download_file(url, path_download, name=None, coerce=None, use_cached=True):
+    """Download a file from a URL to a specified directory.
+
+    This function downloads a file from a URL with support for caching, custom naming,
+    and optional path transformation. Downloads are streamed in chunks for memory efficiency.
+
+    Args:
+        url (str): The URL to download from. Query parameters and fragments are cleaned
+            before generating the cached filename.
+        path_download (str | Path): Directory path where the file will be saved.
+        name (str, optional): Custom filename for the downloaded file (without extension).
+            If provided, caching is disabled. If None, a hash of the URL is used as the name.
+        coerce (callable, optional): A function to transform the downloaded file path.
+            Called with the Path object after download completes.
+            Example: lambda p: str(p) to convert Path to string
+        use_cached (bool): If True (default), skip download if file already exists.
+            Automatically set to False when a custom name is provided.
+
+    Returns:
+        Path | Any: Path object pointing to the downloaded file, or the result of
+            coerce(path) if a coerce function was provided.
+
+    Raises:
+        requests.HTTPError: If the HTTP request fails (e.g., 404, 500 errors).
+        IOError: If file write fails due to permissions or disk space.
+
+    Examples:
+        Basic download with caching:
+        >>> path = download_file('https://example.com/image.jpg', '/tmp/downloads')
+        >>> print(path)  # /tmp/downloads/abc123def456.jpg (hash-based name)
+
+        Custom filename without caching:
+        >>> path = download_file(
+        ...     'https://example.com/data.json',
+        ...     '/tmp/downloads',
+        ...     name='my_data'
+        ... )
+        >>> print(path)  # /tmp/downloads/my_data.json
+
+        With path coercion to string:
+        >>> path_str = download_file(
+        ...     'https://example.com/file.txt',
+        ...     '/tmp',
+        ...     coerce=str
+        ... )
+        >>> print(type(path_str))  # <class 'str'>
+
+    Note:
+        - Downloads are streamed in 50MB chunks for memory efficiency
+        - URL is cleaned (query params removed) before generating cached filename
+        - File extension is preserved from the cleaned URL
+        - Existing files are reused when use_cached=True
+    """
     chunk_size = 1024 * 1024 * 50
     cleaned_url = clean_url(url)  # remove query params and fragment
 
@@ -40,6 +92,50 @@ def download_file(url, path_download, name=None, coerce=None, use_cached=True):
 
 
 def files_url_to_path(files, coerce=None, file_field=None):
+    """Convert file URLs to local file paths by downloading them.
+
+    This function downloads files from URLs and replaces the URLs with local paths
+    in the provided dictionary. Supports both flat dictionaries and nested structures.
+
+    Args:
+        files (dict): Dictionary containing file URLs or file objects.
+            - If values are strings: treated as URLs and replaced with local paths
+            - If values are dicts with 'url' key: 'url' is replaced with 'path'
+        coerce (callable, optional): Function to transform downloaded paths.
+            Applied to each downloaded file path.
+        file_field (str, optional): Specific field name to process. If provided,
+            only this field is processed. If None, all fields are processed.
+
+    Returns:
+        None: Modifies the files dictionary in-place.
+
+    Examples:
+        Simple URL replacement:
+        >>> files = {'image': 'https://example.com/img.jpg'}
+        >>> files_url_to_path(files)
+        >>> print(files['image'])  # Path('/tmp/media/abc123.jpg')
+
+        With nested objects:
+        >>> files = {'video': {'url': 'https://example.com/vid.mp4', 'size': 1024}}
+        >>> files_url_to_path(files)
+        >>> print(files['video'])  # {'path': Path('/tmp/media/def456.mp4'), 'size': 1024}
+
+        Process specific field only:
+        >>> files = {'image': 'https://ex.com/a.jpg', 'doc': 'https://ex.com/b.pdf'}
+        >>> files_url_to_path(files, file_field='image')
+        >>> # Only 'image' is downloaded, 'doc' remains as URL
+
+        With path coercion:
+        >>> files = {'data': 'https://example.com/data.csv'}
+        >>> files_url_to_path(files, coerce=str)
+        >>> print(type(files['data']))  # <class 'str'>
+
+    Note:
+        - Downloads to temporary media directory: get_temp_path('media')
+        - Creates download directory if it doesn't exist
+        - Modifies input dictionary in-place
+        - Uses caching by default (via download_file)
+    """
     path_download = get_temp_path('media')
     path_download.mkdir(parents=True, exist_ok=True)
     if file_field:
@@ -53,6 +149,66 @@ def files_url_to_path(files, coerce=None, file_field=None):
 
 
 def files_url_to_path_from_objs(objs, files_fields, coerce=None, is_list=False, is_async=False):
+    """Convert file URLs to paths for multiple objects with nested field support.
+
+    This function processes one or more objects, extracting file URLs from specified
+    nested fields and replacing them with local file paths. Supports both synchronous
+    and asynchronous operation.
+
+    Args:
+        objs (dict | list): Single object or list of objects to process.
+            If is_list=False, can be a single dict.
+            If is_list=True, should be a list of dicts.
+        files_fields (list[str]): List of field paths to process.
+            Supports dot notation for nested fields (e.g., 'data.files', 'meta.image').
+        coerce (callable, optional): Function to transform downloaded paths.
+        is_list (bool): If True, objs is treated as a list. If False, objs is wrapped
+            in a list for processing. Default False.
+        is_async (bool): If True, uses async download (afiles_url_to_path_from_objs).
+            If False, uses synchronous download. Default False.
+
+    Returns:
+        None: Modifies objects in-place, replacing URLs with local paths.
+
+    Examples:
+        Single object with simple field:
+        >>> obj = {'files': {'image': 'https://example.com/img.jpg'}}
+        >>> files_url_to_path_from_objs(obj, files_fields=['files'])
+        >>> print(obj['files']['image'])  # Path('/tmp/media/abc123.jpg')
+
+        Multiple objects with nested fields:
+        >>> objs = [
+        ...     {'data': {'files': {'img': 'https://ex.com/1.jpg'}}},
+        ...     {'data': {'files': {'img': 'https://ex.com/2.jpg'}}}
+        ... ]
+        >>> files_url_to_path_from_objs(objs, files_fields=['data.files'], is_list=True)
+        >>> # Both images are downloaded and URLs replaced with paths
+
+        Async download for better performance:
+        >>> objs = [{'files': {'a': 'url1', 'b': 'url2'}} for _ in range(10)]
+        >>> files_url_to_path_from_objs(
+        ...     objs,
+        ...     files_fields=['files'],
+        ...     is_list=True,
+        ...     is_async=True
+        ... )
+        >>> # All files downloaded concurrently
+
+        Multiple field paths:
+        >>> obj = {
+        ...     'images': {'photo': 'https://ex.com/photo.jpg'},
+        ...     'videos': {'clip': 'https://ex.com/video.mp4'}
+        ... }
+        >>> files_url_to_path_from_objs(obj, files_fields=['images', 'videos'])
+        >>> # Both images and videos fields are processed
+
+    Note:
+        - Silently skips missing fields (KeyError is caught and ignored)
+        - Supports dot notation for nested field access
+        - Async mode (is_async=True) provides better performance for multiple files
+        - Commonly used with API responses containing file URLs
+        - Used by BaseClient._list() with url_conversion parameter
+    """
     if is_async:
         asyncio.run(afiles_url_to_path_from_objs(objs, files_fields, coerce=coerce, is_list=is_list))
     else:
@@ -72,6 +228,36 @@ def files_url_to_path_from_objs(objs, files_fields, coerce=None, is_list=False,
 
 
 async def adownload_file(url, path_download, name=None, coerce=None, use_cached=True):
+    """Asynchronously download a file from a URL to a specified directory.
+
+    Async version of download_file() using aiohttp for concurrent downloads.
+    All parameters and behavior are identical to download_file().
+
+    Args:
+        url (str): The URL to download from.
+        path_download (str | Path): Directory path where the file will be saved.
+        name (str, optional): Custom filename (without extension).
+        coerce (callable, optional): Function to transform the downloaded file path.
+        use_cached (bool): If True (default), skip download if file exists.
+
+    Returns:
+        Path | Any: Path to downloaded file, or coerce(path) if provided.
+
+    Examples:
+        Basic async download:
+        >>> path = await adownload_file('https://example.com/large.zip', '/tmp')
+
+        Multiple concurrent downloads:
+        >>> urls = ['https://ex.com/1.jpg', 'https://ex.com/2.jpg']
+        >>> paths = await asyncio.gather(*[
+        ...     adownload_file(url, '/tmp') for url in urls
+        ... ])
+
+    Note:
+        - Uses aiohttp.ClientSession for async HTTP requests
+        - Downloads in 50MB chunks for memory efficiency
+        - Recommended for downloading multiple files concurrently
+    """
     chunk_size = 1024 * 1024 * 50
     cleaned_url = clean_url(url)  # remove query params and fragment
 
@@ -98,6 +284,41 @@ async def adownload_file(url, path_download, name=None, coerce=None, use_cached=
 
 
 async def afiles_url_to_path(files, coerce=None):
+    """Asynchronously convert file URLs to local paths by downloading them.
+
+    Async version of files_url_to_path() for concurrent file downloads.
+    Processes all files in the dictionary concurrently for better performance.
+
+    Args:
+        files (dict): Dictionary containing file URLs or file objects.
+        coerce (callable, optional): Function to transform downloaded paths.
+
+    Returns:
+        None: Modifies the files dictionary in-place.
+
+    Examples:
+        Download multiple files concurrently:
+        >>> files = {
+        ...     'image1': 'https://ex.com/1.jpg',
+        ...     'image2': 'https://ex.com/2.jpg',
+        ...     'image3': 'https://ex.com/3.jpg'
+        ... }
+        >>> await afiles_url_to_path(files)
+        >>> # All 3 files downloaded concurrently
+
+        With nested file objects:
+        >>> files = {
+        ...     'thumb': {'url': 'https://ex.com/thumb.jpg'},
+        ...     'full': {'url': 'https://ex.com/full.jpg'}
+        ... }
+        >>> await afiles_url_to_path(files)
+        >>> print(files['thumb']['path'])  # Path object
+
+    Note:
+        - All files are downloaded concurrently using asyncio
+        - More efficient than synchronous version for multiple files
+        - Does not support file_field parameter (processes all fields)
+    """
     path_download = get_temp_path('media')
     path_download.mkdir(parents=True, exist_ok=True)
     for file_name in files:
@@ -108,6 +329,46 @@ async def afiles_url_to_path(files, coerce=None):
 
 
 async def afiles_url_to_path_from_objs(objs, files_fields, coerce=None, is_list=False):
+    """Asynchronously convert file URLs to paths for multiple objects.
+
+    Async version of files_url_to_path_from_objs() that downloads all files
+    concurrently using asyncio.gather() for maximum performance.
+
+    Args:
+        objs (dict | list): Single object or list of objects to process.
+        files_fields (list[str]): List of field paths to process (supports dot notation).
+        coerce (callable, optional): Function to transform downloaded paths.
+        is_list (bool): If True, objs is treated as a list. Default False.
+
+    Returns:
+        None: Modifies objects in-place, replacing URLs with local paths.
+
+    Examples:
+        Download files from multiple objects concurrently:
+        >>> objs = [
+        ...     {'files': {'img': 'https://ex.com/1.jpg'}},
+        ...     {'files': {'img': 'https://ex.com/2.jpg'}},
+        ...     {'files': {'img': 'https://ex.com/3.jpg'}}
+        ... ]
+        >>> await afiles_url_to_path_from_objs(objs, ['files'], is_list=True)
+        >>> # All 3 images downloaded concurrently
+
+        Process large dataset efficiently:
+        >>> # 100 objects with multiple files each
+        >>> objs = [{'data': {'files': {...}}} for _ in range(100)]
+        >>> await afiles_url_to_path_from_objs(
+        ...     objs,
+        ...     files_fields=['data.files'],
+        ...     is_list=True
+        ... )
+        >>> # All files downloaded in parallel, much faster than sync version
+
+    Note:
+        - All file downloads happen concurrently using asyncio.gather()
+        - Significantly faster than synchronous version for large datasets
+        - Ideal for processing API responses with many file URLs
+        - Used internally when is_async=True in files_url_to_path_from_objs()
+    """
     if not is_list:
         objs = [objs]
 

{synapse_sdk-2025.9.5.dist-info → synapse_sdk-2025.10.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 2025.9.5
+Version: 2025.10.6
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT
@@ -26,7 +26,7 @@ Requires-Dist: websockets
 Requires-Dist: ffmpeg-python==0.2.0
 Requires-Dist: sentry-sdk==2.38.0
 Provides-Extra: all
-Requires-Dist: ray[all]==2.49.1; extra == "all"
+Requires-Dist: ray[all]==2.50.0; extra == "all"
 Requires-Dist: python-nmap; extra == "all"
 Requires-Dist: hyperopt; extra == "all"
 Requires-Dist: bayesian-optimization==1.4.3; extra == "all"
@@ -62,6 +62,19 @@ A Python SDK for building and managing ML plugins, data annotation workflows, an
 - **🛠️ Development Tools**: Interactive web dashboard for monitoring and debugging
 - **⚡ CLI Interface**: Command-line tool for configuration, plugin management, and development
 
+## 📅 Versioning
+
+Synapse SDK uses **CalVer (Calendar Versioning)**.  
+The version format is `YYYY.MM.PATCH`, based on the release year and month.
+
+Examples:
+
+- `2025.9.5` → 5th release in September 2025  
+- `2025.10.1` → 1st release in October 2025  
+
+We recommend using the latest monthly release.  
+If needed, you can pin to a specific month, e.g. `2025.9.*`.
+
 ## 🚀 Quick Start
 
 ```bash

{synapse_sdk-2025.9.5.dist-info → synapse_sdk-2025.10.6.dist-info}/RECORD

@@ -24,7 +24,7 @@ synapse_sdk/cli/plugin/create.py,sha256=HpYTpohV1NbSrULaVUlc4jWLWznPrx7glgydTM3s
 synapse_sdk/cli/plugin/publish.py,sha256=wok85WnfXzb4j6Aix7gRWM3kXW3E2eC31Q3bsDrn-vw,1547
 synapse_sdk/cli/plugin/run.py,sha256=xz5LRm3zh8Y9DMjw5FFRFVRWSCWtYfZJskfCmrPikaQ,2598
 synapse_sdk/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synapse_sdk/clients/base.py,sha256=U14AN6MwAzYd1HR8PfIlXad1OtmqWy8O-NmO984v5DY,13355
+synapse_sdk/clients/base.py,sha256=10A3LRfZ_ZN_arQjOR-qj_PJPEwYDnuP3ZxX21AuREU,19162
 synapse_sdk/clients/exceptions.py,sha256=ylv7x10eOp4aA3a48jwonnvqvkiYwzJYXjkVkRTAjwk,220
 synapse_sdk/clients/utils.py,sha256=8pPJTdzHiRPSbZMoQYHAgR2BAMO6u_R_jMV6a2p34iQ,392
 synapse_sdk/clients/agent/__init__.py,sha256=FqYbtzMJdzRfuU2SA-Yxdc0JKmVP1wxH6OlUNmB4lH8,2230
@@ -53,7 +53,7 @@ synapse_sdk/devtools/docs/README.md,sha256=yBzWf0K1ef4oymFXDaHo0nYWEgMQJqsOyrkNh
 synapse_sdk/devtools/docs/docusaurus.config.ts,sha256=K1b002RS0x0tsOyib_6CSgUlASEULC9vAX8YDpbsRN4,3229
 synapse_sdk/devtools/docs/package-lock.json,sha256=dtepgbPC8gq5uz-hdcac4hIU-Cs209tX0sfBuB7RfEQ,705694
 synapse_sdk/devtools/docs/package.json,sha256=8veqayA4U3OLpdQaz6AzB59RQwTU-5soeYlYYWIxq28,1187
-synapse_sdk/devtools/docs/sidebars.ts,sha256=4uZVcHAIJ6irPdBVOyplr0BxyW3WzfPgZLI47w5U6bI,1856
+synapse_sdk/devtools/docs/sidebars.ts,sha256=gAicvdVmym1PZnR9tZH3SDb6PgOGLuX8U-nAOC4eaOQ,3365
 synapse_sdk/devtools/docs/tsconfig.json,sha256=O9BNlRPjPiaVHW2_boShMbmTnh0Z2k0KQO6Alf9FMVY,215
 synapse_sdk/devtools/docs/blog/2019-05-28-first-blog-post.md,sha256=iP7gl_FPqo-qX13lkSRcRoT6ayJNmCkXoyvlm7GH248,312
 synapse_sdk/devtools/docs/blog/2019-05-29-long-blog-post.md,sha256=cM-dhhTeurEWMcdn0Kx-NpNts2YUUraSI_XFk_gVHEE,3122
@@ -75,7 +75,7 @@ synapse_sdk/devtools/docs/docs/api/index.md,sha256=l5EA65asRKZpPLKp1agn8jIQjzURz
 synapse_sdk/devtools/docs/docs/api/clients/agent.md,sha256=QbtdFQA-7rZhtnOh9tGSE9tKQQFeYGE7Z7RmxjVJzuw,786
 synapse_sdk/devtools/docs/docs/api/clients/annotation-mixin.md,sha256=bGbeUG8HjyOslTPAv1iBFkXlWny197Ys58ZQCYmuw5E,8512
 synapse_sdk/devtools/docs/docs/api/clients/backend.md,sha256=DXAxa82FIJiEThCdXu0t_7GeIomHXD-85Y3aZtNCICs,8906
-synapse_sdk/devtools/docs/docs/api/clients/base.md,sha256=IxRGjYFI9KjZU3TFkjdWVdw9sgH40WAtOgIPJjORysc,720
+synapse_sdk/devtools/docs/docs/api/clients/base.md,sha256=mO2X_Tn7ajPNAJpPQmBsuBM3m5lmzgz92FGPJTtHfz4,8636
 synapse_sdk/devtools/docs/docs/api/clients/core-mixin.md,sha256=AmUKBCU64BHaMkWOfAFIhNBCRe9ZCUx-gwAQGQOgA30,14442
 synapse_sdk/devtools/docs/docs/api/clients/data-collection-mixin.md,sha256=WTz4GsgEnY5jpv54YjNCt31zYWE-E_L9-JVZKW_V4v4,12294
 synapse_sdk/devtools/docs/docs/api/clients/hitl-mixin.md,sha256=8jrAn6DjAcqdbTnUq5btpaJNu67aUZiqhS9oPX7iurQ,16745
@@ -84,7 +84,7 @@ synapse_sdk/devtools/docs/docs/api/clients/integration-mixin.md,sha256=s0K_qjweC
 synapse_sdk/devtools/docs/docs/api/clients/ml-mixin.md,sha256=b4GxUBltwJOjdy0b8MPIVAv2LevzSFBwQKe2uTvslJ4,16739
 synapse_sdk/devtools/docs/docs/api/clients/ray.md,sha256=dnrqIT3MeCUnCH-9yUH59RSm46ZUtdRuncpfjFoPMXY,8089
 synapse_sdk/devtools/docs/docs/api/plugins/categories.md,sha256=8zRHyyl3JQ2p0zKU86-nE-NDeWZLMwp0bh8ZF-PSx9M,839
-synapse_sdk/devtools/docs/docs/api/plugins/models.md,sha256=XRMTD2DBilZwmO6AmPhLgdzNfBpcFkAdrBg9mgOMTUs,1060
+synapse_sdk/devtools/docs/docs/api/plugins/models.md,sha256=GWjh_4TUIQNKa5xLSf_pfF8AWn6V2PlPStUz65X1fq8,2935
 synapse_sdk/devtools/docs/docs/api/plugins/utils.md,sha256=39soJ1JLROm_mygR9UWG6XqZ1i5ESmTeZGijrAfUh-o,8389
 synapse_sdk/devtools/docs/docs/concepts/index.md,sha256=ezn67P568PvFRPVE4T74j5MuEikgVOX7DV6MxIQBOHo,760
 synapse_sdk/devtools/docs/docs/examples/index.md,sha256=IZnF8veO7PqJYtAQevL1VHt1rBzieCSaXoWTQoXS4lA,504
@@ -94,10 +94,16 @@ synapse_sdk/devtools/docs/docs/features/utils/file.md,sha256=H4vzxZiJ0X-US8OCfgf
 synapse_sdk/devtools/docs/docs/features/utils/network.md,sha256=IOYMhC7bM6BwpvaJosj9vxHXr0Vc5_qP09HP8OVuM64,9734
 synapse_sdk/devtools/docs/docs/features/utils/storage.md,sha256=uIpc37trKUm4XHe1fd4auw56vMq3DvAMjJveSfN4rqU,1000
 synapse_sdk/devtools/docs/docs/features/utils/types.md,sha256=l84J1Ooa40xBYdvK1YpeKBT9kaqaWQUMNIFPUiC2e_U,1046
-synapse_sdk/devtools/docs/docs/plugins/developing-upload-template.md,sha256=PFgxKDDdXb0RiANTcv0n9k0_VhbJ1pTB1nZGbxo9hBw,52689
-synapse_sdk/devtools/docs/docs/plugins/export-plugins.md,sha256=2l4rkGuTwgSmqR5o4-psprhODquC7UDcSorsbK4iEJ4,35761
-synapse_sdk/devtools/docs/docs/plugins/plugins.md,sha256=2WMjbTKjIXTAdeODeTvJkDSsR9PiA58_VnCFuBnWRw4,24358
-synapse_sdk/devtools/docs/docs/plugins/upload-plugins.md,sha256=78-7Z1ZtukPGPRbRAb7eAN35Z_gANMzCp2AF1eFxOrA,64603
+synapse_sdk/devtools/docs/docs/plugins/export-plugins.md,sha256=Wajf3CZRQiytRx6SS1lIBlGO5o4F2vOw-xog51JiHJU,37074
+synapse_sdk/devtools/docs/docs/plugins/plugins.md,sha256=G6y3XZZHuC65ApfKE0fYHCAC5TOFnZqzE7VR-KOExVk,25074
+synapse_sdk/devtools/docs/docs/plugins/categories/neural-net-plugins/train-action-overview.md,sha256=lEo7EILXwFan3L5zyqeQKqtEpWbHbN-xn7JmLyHVmNc,17123
+synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/pre-annotation-plugin-overview.md,sha256=Dhnlqd7okB3SoOZ5RYRYqeBBZnGfctZrlCYo1A7GWyA,6832
+synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/to-task-action-development.md,sha256=itkXVOV-pZNsqX0PIA9YhCJNp8iNgxVdQvM0sVahHJ4,47810
+synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/to-task-overview.md,sha256=J-z2KkLt5WWTgbJGRxvqrZQxfHvur_QtCGA6iT5a0Og,17134
+synapse_sdk/devtools/docs/docs/plugins/categories/pre-annotation-plugins/to-task-template-development.md,sha256=ARirm2jq5X2fVXWpZFX6ezh0aSIK5PCWvYC9nvsXIwY,41159
+synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-action.md,sha256=GmTZYLyPDuUC9WzjNjf_zNh5FkN-VYzLuSo_dQzewWw,30796
+synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-overview.md,sha256=Q4jqN_W3AB-7PEDpkCxwKjmrjERGpb-UNqYA9I0O63Y,16513
+synapse_sdk/devtools/docs/docs/plugins/categories/upload-plugins/upload-plugin-template.md,sha256=HpqGQ9yUYy4673gkdPNsqFZRdAXnDv3xbrC87brG50o,22288
 synapse_sdk/devtools/docs/docs/tutorial-basics/_category_.json,sha256=qQVHZ1p0CxHg5Gb4CYNxUSeqZ3LVo4nXN_N0yUMVpDM,180
 synapse_sdk/devtools/docs/docs/tutorial-basics/congratulations.md,sha256=zJbcwKNVYGpLAGJO7e3cTdptFhb6m_NUzYDU5i6MWgc,1078
 synapse_sdk/devtools/docs/docs/tutorial-basics/create-a-blog-post.md,sha256=FNk-D3eiMmoc7sdVKazXibjsKl7-6b65KuEYkGOwcYk,886
@@ -111,7 +117,7 @@ synapse_sdk/devtools/docs/docs/tutorial-extras/translate-your-site.md,sha256=z1_
 synapse_sdk/devtools/docs/docs/tutorial-extras/img/docsVersionDropdown.png,sha256=Xawg1DHAiB7XvkMRSl92jMNsmmINQ1kHfyjEKH-CMbU,25427
 synapse_sdk/devtools/docs/docs/tutorial-extras/img/localeDropdown.png,sha256=WEVjtAuurY7CMNvx86IP-ewXnTYUIJBANOqwTQbXA5c,27841
 synapse_sdk/devtools/docs/i18n/ko/code.json,sha256=LiQsxfVNxxr6Iivhnf3c_ibOdTiJi4Rh4gP7AnxZSnU,13493
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current.json,sha256=kkLZvbvW_KnHxZFdzNkUbJ7jfFiGCXWGlle3JUJSmYo,770
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current.json,sha256=zLfDdDB_tk1o6aki5Yr36Mt__6A086MYJ_uSWUvQJNM,1304
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/categories.md,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/cli-usage.md,sha256=2XFSZBtbKzfxc-TksSAEJ07eyYdTH98euhkwg6QDZ0U,7926
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/configuration.md,sha256=UTTC7G4t-ssX_cNnJfpOB99QB0fWJD2c-UARSpS-Z-M,2487
@@ -125,7 +131,7 @@ synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/ind
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/agent.md,sha256=UVllVNexQYmiHAk6dVVvd0MPQt6S9vBcK5Ur-BeLP2M,827
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/annotation-mixin.md,sha256=YnF9Ww5_rT89Sps6FP1val3ygd0CqJCISokg1ObgNA4,7237
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/backend.md,sha256=uRXPub52H-BAPsnHFerowQHrLpFomFykzgn1zqZOpj8,9722
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/base.md,sha256=cn8B5Py1TQjQc3a1B8wT_UuOGmb9eCk2IrKWSZnPlmA,804
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/base.md,sha256=9NfpRI_5d1CqNtZUYk37jyP3-ZLtys5sy14t6yhg1z4,9644
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/core-mixin.md,sha256=y9Jxzw_AstCnQzNlinEod-xJAkLBXapp7hcz9pebgt8,13346
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/data-collection-mixin.md,sha256=EH-rD25EzmhUYfWfJSvb-16fgmbsJzVnOGIlPLwdh7E,10806
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/hitl-mixin.md,sha256=IEWchj4OhSLPrwC4K7rwAJxAS9fLmrzUGz5x_G4AkZg,5533
@@ -133,6 +139,7 @@ synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/cli
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/integration-mixin.md,sha256=zimwBCoCUwfUFl8IlGm-JyLUVzM2R7e77sjBdEFdDVE,11823
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/ml-mixin.md,sha256=iZG-Fk6rx9UTYDbQnEAPc390tEKz5JtWJsr0s6Ekwjc,8440
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/clients/ray.md,sha256=m7yxYeDMnRdYPrzTPuSk9EHuDRjEMZRY6q-ty4-HmGs,8931
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/api/plugins/models.md,sha256=fOBaoh5bKinRltEsC7Zx2Mj1PlBzXhjXORlVkPyXvhQ,3177
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/concepts/index.md,sha256=6o-8H7khfiMhQSXBAvkYpf6jzOEndPje1QAGdlGfskw,843
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/examples/index.md,sha256=pMAc1VLUXnHCv2xvvx-GBqVQ1Uh4h-u4nrco5UZ2z-Y,613
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/index.md,sha256=X0haPkqUY89K5R3LiGLQX9Boh_BpLxUsHA13skTTAp8,1015
@@ -141,10 +148,16 @@ synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/feature
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/network.md,sha256=_jYDA25anaQ7FdfJmapACjqDvw3D2J8wj0RWCnXXpLY,10348
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/storage.md,sha256=V-IIUSVJjwh9n6KVZI5DxrU_T0l3AOtcCrAC2PRs43Q,1048
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/features/utils/types.md,sha256=JdDMC2FKovAU55pPEBoIUPPniU5mKAvA5w1Zb36u9AE,1207
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/developing-upload-template.md,sha256=Eg2c2li9GfkJpNVNJnNoBAUXweO7X5hRUV6PGuhj--M,54001
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/export-plugins.md,sha256=AwAR1NT19PWpjAe3bv8v9T1ccC4-ng_NeuoHOuKl5zI,37299
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/export-plugins.md,sha256=XcvZuio6NUDuDSe_XhYq1ACDaAJThmekP3anEzOCRks,38804
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/plugins.md,sha256=wUuuOmQQY1dURZzJ0HSpiABaJWqKbxQn31Xfn-wUf8E,4947
-synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/upload-plugins.md,sha256=BPG3Ykku3DTEuANPQqZn_vfDNC8vdxLGi__s4lyoKdo,72605
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/neural-net-plugins/train-action-overview.md,sha256=4xu_pThx4ctWRnrL7bYuBsnsYv9fvZKls0S83vVutc4,18112
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/pre-annotation-plugins/pre-annotation-plugin-overview.md,sha256=JlPxHFzeyXx0xi2vpGXc-GTkFeg9R-Smpap0OjCyE7g,7592
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/pre-annotation-plugins/to-task-action-development.md,sha256=UowD_fqWFVD81ubJKguX-O9fSf7L07i6Pft8DFdfVn0,48803
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/pre-annotation-plugins/to-task-overview.md,sha256=InL4EI0BkVXgjs-j7cPRYaRXDVxxMgBYYLs_9FdyKxk,18408
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/pre-annotation-plugins/to-task-template-development.md,sha256=Ab8EeSYMWZclb_qxvBaLaz4IdCXySrKN2o68s24VT6I,42441
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-action.md,sha256=zaodG2yGwNQiPLrI59dhShB0WxZ1EMNdXnQx9E5Kzlk,32523
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-overview.md,sha256=7xo-N4NwDvF3QFVKafZosjG1IbtwI-BzTTTyo4kzU44,17953
+synapse_sdk/devtools/docs/i18n/ko/docusaurus-plugin-content-docs/current/plugins/categories/upload-plugins/upload-plugin-template.md,sha256=Rldxjo5DKmHfEBMoF86yLkgYGoip99gVkF7gBSkqNxM,23603
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-theme-classic/footer.json,sha256=SCLmysIhJ6XEEfnL7cOQb3s08EG4LA-ColdRRxecIH8,1601
 synapse_sdk/devtools/docs/i18n/ko/docusaurus-theme-classic/navbar.json,sha256=M-ly81cWnesYYtCRcfMvOsKl5P0z52K9kiw0T6GIQ60,429
 synapse_sdk/devtools/docs/src/components/HomepageFeatures/index.tsx,sha256=xaUQaq9OuqoaRAZQo-ZWev0vbmIkn9l04QfUBxlhnnU,1923
@@ -179,14 +192,14 @@ synapse_sdk/devtools/streamlit_app/utils/json_viewer.py,sha256=W1OH27fq3dazrENBC
 synapse_sdk/devtools/streamlit_app/utils/log_formatter.py,sha256=fQZoEGP-FK9Sgoqh0Z-o1zX_MHpiXVZXLu_4WMcvYNQ,1292
 synapse_sdk/devtools/streamlit_app/utils/styles.py,sha256=ivVBlHzJll9uVZX25Sdbu5Hq40SOmaRamrCqY9A9aFY,5147
 synapse_sdk/devtools/streamlit_app/utils/ui_components.py,sha256=ciSyNEhPYNU6KqnfgDI9RZr1tGFZeiOJ9qBDhlXqmUY,9557
-synapse_sdk/plugins/README.md,sha256=S0xowL7ukJZf0_zjNnWz0g_-b731GrIkdkwaS2ubpz0,27991
+synapse_sdk/plugins/README.md,sha256=sBPJ0siFXr5QBfofFCstMQQPbgIKqsuE2co0Ov3R_J8,42528
 synapse_sdk/plugins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/enums.py,sha256=ibixwqA3sCNSriG1jAtL54JQc_Zwo3MufwYUqGhVncc,523
 synapse_sdk/plugins/exceptions.py,sha256=Qs7qODp_RRLO9y2otU2T4ryj5LFwIZODvSIXkAh91u0,691
-synapse_sdk/plugins/models.py,sha256=Dx0bKwGdAqohjWa7Vk9R0kQ3PThM1udTcyul_GzwARw,5920
+synapse_sdk/plugins/models.py,sha256=fuc1LryTjdoH4u6xVA_jDc-VVciF9lDCrai9r5NGpPY,8428
 synapse_sdk/plugins/upload.py,sha256=VJOotYMayylOH0lNoAGeGHRkLdhP7jnC_A0rFQMvQpQ,3228
 synapse_sdk/plugins/categories/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synapse_sdk/plugins/categories/base.py,sha256=j8FrNUb9CAxiDmpG2uw83ByMCPFAQFu0VcN1Cg9Pryg,11564
+synapse_sdk/plugins/categories/base.py,sha256=An_MbDqoKm6-KSzpsUQ6KA5rtXkysOcYPUhxcZcmZbc,11602
 synapse_sdk/plugins/categories/decorators.py,sha256=Gw6T-UHwpCKrSt596X-g2sZbY_Z1zbbogowClj7Pr5Q,518
 synapse_sdk/plugins/categories/registry.py,sha256=KdQR8SUlLT-3kgYzDNWawS1uJnAhrcw2j4zFaTpilRs,636
 synapse_sdk/plugins/categories/templates.py,sha256=FF5FerhkZMeW1YcKLY5cylC0SkWSYdJODA_Qcm4OGYQ,887
@@ -199,23 +212,23 @@ synapse_sdk/plugins/categories/data_validation/templates/plugin/validation.py,sh
 synapse_sdk/plugins/categories/export/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/export/actions/__init__.py,sha256=crCFQ3tTUFjI3UhszDBpsE7eYi7zpswSHjQgTh3tccI,61
 synapse_sdk/plugins/categories/export/actions/export/__init__.py,sha256=6y0WRhcqyhxbZIfbRCF0ZI6CQgqSXmqCRLP1hTkdBPc,727
-synapse_sdk/plugins/categories/export/actions/export/action.py,sha256=-jlPIkm8BGxouq6rr0Q8nBSCIFAGEmMOlmmbX4DZxYI,6125
+synapse_sdk/plugins/categories/export/actions/export/action.py,sha256=hh1_to4xPmY6Dv-4Ge24oGbyj3J92Wy95Dl0XIaS36Q,6303
 synapse_sdk/plugins/categories/export/actions/export/enums.py,sha256=XO4CF8jWt0c9lcUenKcjaKb0iXqQBFLyVMHmLm2_Nv8,3601
 synapse_sdk/plugins/categories/export/actions/export/exceptions.py,sha256=cDXVQetJvSlTbijN3elNwDLACELn2UxjyGnM2ALlKOk,1753
 synapse_sdk/plugins/categories/export/actions/export/models.py,sha256=NM9mSJAhcFFREUVlCy1LRbmq4Tm8rH_FGyZimS2aXho,2779
 synapse_sdk/plugins/categories/export/actions/export/run.py,sha256=bmilGnxfMWtIIvdIoY9sHkCPkQf_1-myur10I5TUEFY,6912
-synapse_sdk/plugins/categories/export/actions/export/utils.py,sha256=rbqoOIcgAOjlHV9Vn-2czHk6nzsxQUNu_lJzjkU9XfM,6367
-synapse_sdk/plugins/categories/export/templates/config.yaml,sha256=fAqi-9dH7qEkFDSDFvt0BcZ72d2qbyt1P83L2ti6ELM,58
+synapse_sdk/plugins/categories/export/actions/export/utils.py,sha256=rr-PajbTmFagVCDBJzPgeh34jgPzjW6eDwS70Wwp76o,10902
+synapse_sdk/plugins/categories/export/templates/config.yaml,sha256=fkbSPp7ISZ9NJ1Vvcz1dBSWoYjseVp1eJKyu5PPoboM,516
 synapse_sdk/plugins/categories/export/templates/plugin/__init__.py,sha256=oC8hczDebLaWoTaxANw0n9uMjVR5sydBs7pgTw78rbM,16057
-synapse_sdk/plugins/categories/export/templates/plugin/export.py,sha256=3dZUEdhj-4YySJ-cPyNAqQvj5xcAXIX4KmXKcacTtd0,2754
+synapse_sdk/plugins/categories/export/templates/plugin/export.py,sha256=q9dbJIM3iCNu8W7J6HfIqQ5zeCx1QfyUaj7adhBvshI,6892
 synapse_sdk/plugins/categories/neural_net/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/neural_net/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/neural_net/actions/deployment.py,sha256=njhDp05KXbNB9VCa46VgWa8-ftc_f9HcAVpUr0836AM,1838
 synapse_sdk/plugins/categories/neural_net/actions/gradio.py,sha256=jBkonh0JHRIKFPxv-XBBFM8Da3dSJs-vyJu_KGT73DQ,4508
 synapse_sdk/plugins/categories/neural_net/actions/inference.py,sha256=0a655ELqNVjPFZTJDiw4EUdcMCPGveUEKyoYqpwMFBU,1019
 synapse_sdk/plugins/categories/neural_net/actions/test.py,sha256=JY25eg-Fo6WbgtMkGoo_qNqoaZkp3AQNEypJmeGzEog,320
-synapse_sdk/plugins/categories/neural_net/actions/train.py,sha256=Vwr8Lbv6LWvuYpF3JX8Oh4Nu2rh8lJXiLjQSto8-xGM,5449
-synapse_sdk/plugins/categories/neural_net/actions/tune.py,sha256=C2zv3o0S-5Hjjsms8ULDGD-ad_DdNTqCPOcDqXa0v1Y,13494
+synapse_sdk/plugins/categories/neural_net/actions/train.py,sha256=D0LN-eMIv3SEeYPBn-4k60kyHlJP3SMQ1LidJYeOk38,26503
+synapse_sdk/plugins/categories/neural_net/actions/tune.py,sha256=l95PeA-m4ypkgSDVGZUck1XUz6bX30pQPnR6DCLS3Hk,18390
 synapse_sdk/plugins/categories/neural_net/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/neural_net/base/inference.py,sha256=R5DASI6-5vzsjDOYxqeGGMBjnav5qHF4hNJT8zNUR3I,1097
 synapse_sdk/plugins/categories/neural_net/templates/config.yaml,sha256=TMdvthf0zQYYTHf0IibKJ6InziRCWM4100C1DKkJVqU,1094
@@ -230,9 +243,26 @@ synapse_sdk/plugins/categories/post_annotation/templates/config.yaml,sha256=2g9S
 synapse_sdk/plugins/categories/post_annotation/templates/plugin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/post_annotation/templates/plugin/post_annotation.py,sha256=GTsGq6zOZDWQSgP-XPr74qVWil480sYrLIBdk28ZMvQ,108
 synapse_sdk/plugins/categories/pre_annotation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synapse_sdk/plugins/categories/pre_annotation/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+synapse_sdk/plugins/categories/pre_annotation/actions/__init__.py,sha256=ML8ronGy5pyFy0mQG_ZggkWpaLlvjkGWR6T5sLQvJOw,147
 synapse_sdk/plugins/categories/pre_annotation/actions/pre_annotation.py,sha256=6ib3RmnGrjpsQ0e_G-mRH1lfFunQ3gh2M831vuDn7HU,344
 synapse_sdk/plugins/categories/pre_annotation/actions/to_task.py,sha256=WSoLkQWKfLdS6qaCJEO780_fUNMi3--7zPf84YJET-Y,42006
+synapse_sdk/plugins/categories/pre_annotation/actions/pre_annotation/__init__.py,sha256=vPpkJg7r3h1D6aTCoE-UgOkFGC0nVGIaE4ygmrmrI28,75
+synapse_sdk/plugins/categories/pre_annotation/actions/pre_annotation/action.py,sha256=6ib3RmnGrjpsQ0e_G-mRH1lfFunQ3gh2M831vuDn7HU,344
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/__init__.py,sha256=st43RA700jdz7ZeQzCWRTpF6CKca3z3m4tv1489Q6NI,857
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/action.py,sha256=2DNCaCeRzBIjFXYmm0L8Hgv6DDufezlI05m2G1__wKo,5514
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/enums.py,sha256=0ewRgUUf1s1qqKzzGhpquAipfuFCqYAT968x9GRxctM,9740
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/exceptions.py,sha256=NSXLepDybwqgcZM4JYOs8SRYtOKz6azrA8tjPRhr_MU,446
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/factory.py,sha256=Aw1sIWRURhEo504nxjnImJdhkeEiiBUzvtuWOLOIp_c,3170
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/models.py,sha256=6bF4sEVcS5wsosR7-IYO4v-h48c0-z2_cMiE3PSgIUs,2920
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/orchestrator.py,sha256=xcO1QVtVHatVSyVYdtO2PVv4xMlJwPaIWkbLcCkH8MI,10854
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/run.py,sha256=erClqrmuh3etSoQ6Iu_m_Yvt7VhAyWWFzEtWHe-Hf-A,2529
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/__init__.py,sha256=XkNpVzPQ2X8skz-1K9_O1ViMvxOYFayVRiCC-BEWVc4,348
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/annotation.py,sha256=BcZm3EyCaxIJW6MPMmFaxP-MoS9QIh8zrqw8aWr3w5Y,13638
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/base.py,sha256=8XFPL8qQyxKi3TAYxup73LzOsmGeFGp8z70VqgiI4zs,5573
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/extraction.py,sha256=7-AqPFFBQXyRL1Zs3LJLNG-7CCshwLbB2UhWIhr9nMM,2946
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/metrics.py,sha256=idrLcZGLspwTHw5L2Xn41d9bWr7pkpfmSG2Op5tZocE,3354
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/preprocessor.py,sha256=nkvJEej_TUcnwKuArrREltfrvVGtuqA2hhgYy7dkFao,5419
+synapse_sdk/plugins/categories/pre_annotation/actions/to_task/strategies/validation.py,sha256=80JrOrJbaJgFWtiQ38tTVVYW12BdYKRihOnA4jGCSZg,5944
 synapse_sdk/plugins/categories/pre_annotation/templates/config.yaml,sha256=VREoCp9wsvZ8T2E1d_MEKlR8TC_herDJGVQtu3ezAYU,589
 synapse_sdk/plugins/categories/pre_annotation/templates/plugin/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/pre_annotation/templates/plugin/pre_annotation.py,sha256=HBHxHuv2gMBzDB2alFfrzI_SZ1Ztk6mo7eFbR5GqHKw,106
@@ -245,26 +275,26 @@ synapse_sdk/plugins/categories/smart_tool/templates/plugin/__init__.py,sha256=47
 synapse_sdk/plugins/categories/smart_tool/templates/plugin/auto_label.py,sha256=eevNg0nOcYFR4z_L_R-sCvVOYoLWSAH1jwDkAf3YCjY,320
 synapse_sdk/plugins/categories/upload/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse_sdk/plugins/categories/upload/actions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synapse_sdk/plugins/categories/upload/actions/upload/__init__.py,sha256=PcnEPlztb69MCgDjrzIcoVcpXGOoZzAj6phvtiCxz60,504
-synapse_sdk/plugins/categories/upload/actions/upload/action.py,sha256=fFAZpNk_pZImaipeCcVKL4HdCnnj3BMr12mPduE-Cg0,9993
-synapse_sdk/plugins/categories/upload/actions/upload/context.py,sha256=RbAt1aag42H5h-m7VWv98e0X_7rVjlfBfILsQqrsK_c,6329
+synapse_sdk/plugins/categories/upload/actions/upload/__init__.py,sha256=ShmALSr3rncCMHYlSJkYwdvEOsEHUxAzG5-hoERhmI0,548
+synapse_sdk/plugins/categories/upload/actions/upload/action.py,sha256=RtOV-Q2oG5oLggJQ5A2FKFj7axmIJT8wUcaF0zJTTZo,10357
+synapse_sdk/plugins/categories/upload/actions/upload/context.py,sha256=4sBWs-IRstzK5U-9N-Ag1vuux6zos_D1P8MFQMaPrKk,6292
 synapse_sdk/plugins/categories/upload/actions/upload/enums.py,sha256=TQ-HiGI_-15rc11XQiCT6O5hRzmjkdCnRhX3Ci3bKk0,7856
 synapse_sdk/plugins/categories/upload/actions/upload/exceptions.py,sha256=QIpts9h78OD8GWCIGjX9jSV4v3Gb0cqH9Eo-6OwN1Qk,1223
 synapse_sdk/plugins/categories/upload/actions/upload/factory.py,sha256=n8PE_LEz8ajLWmRg-CacBt0Bo0vhpDp89_QhvY2VMnQ,6336
-synapse_sdk/plugins/categories/upload/actions/upload/models.py,sha256=5MCgHCszvc8LXnibqpgNZ1sC3mQvmx63X2QxAFs1CJY,7718
+synapse_sdk/plugins/categories/upload/actions/upload/models.py,sha256=EVacyLmRI-3AxTFpKVuhqju-8HT-A1XJaJuoMh62EqQ,9092
 synapse_sdk/plugins/categories/upload/actions/upload/orchestrator.py,sha256=P5SGejY4Rb9TyQwO6S0l9mOBqVOr9J88_3bd7Y-qOmI,7116
 synapse_sdk/plugins/categories/upload/actions/upload/registry.py,sha256=RrRvVJANlb-RdqFeWrHf-vLtWSgsjwSVMMXEXsZiQAk,4093
 synapse_sdk/plugins/categories/upload/actions/upload/run.py,sha256=BZRwy_AtJQtlKjgHx2qadHUS9IC-E_w0zEMpwKgR-P0,6389
 synapse_sdk/plugins/categories/upload/actions/upload/utils.py,sha256=4GiboK06bPhM3y8LIKNbMzEkLj4TSV3T6ihnKnxTSL4,8063
 synapse_sdk/plugins/categories/upload/actions/upload/steps/__init__.py,sha256=-OM-Ruidj0w7wVuyg8BtJcN4Au9DJSKQpra9WPJ67js,57
 synapse_sdk/plugins/categories/upload/actions/upload/steps/base.py,sha256=yzOmjQKlcsmlB5XZqGgQbCyNwwUiKa9nWd2-Pn22Vls,3682
-synapse_sdk/plugins/categories/upload/actions/upload/steps/cleanup.py,sha256=68hFsnUQvZEjgr_7XhvJLla7UMXxtizHgpGBBZxP81A,2130
+synapse_sdk/plugins/categories/upload/actions/upload/steps/cleanup.py,sha256=JAc1L9UfiEhNQ2NWnBMX2Bs4Vej08QPYML6Mb0-a0jg,2200
 synapse_sdk/plugins/categories/upload/actions/upload/steps/collection.py,sha256=zLm4BOuu4d8YqXOjOEDhbEUFQ2t4eSsPJB5e_FKYczI,2345
-synapse_sdk/plugins/categories/upload/actions/upload/steps/generate.py,sha256=ooShRR1w7lAaA2STAtOo3LaLPnK_tC08oefP3dZ2V60,3366
-synapse_sdk/plugins/categories/upload/actions/upload/steps/initialize.py,sha256=ymnTfsaVJj58r7U8nWIbjHgIdm0kXFjZlvl2PHJWksI,2401
-synapse_sdk/plugins/categories/upload/actions/upload/steps/metadata.py,sha256=T5YtyBaAFi7Tpj3LsouWxYl5LxTMY0PtmwwNpqYYo6E,4358
-synapse_sdk/plugins/categories/upload/actions/upload/steps/organize.py,sha256=CMxB_SYlwoJ_sfx50upTRNKwgG1avztEz1Y6tRlFx68,3610
-synapse_sdk/plugins/categories/upload/actions/upload/steps/upload.py,sha256=cuWjxfWrmHrklTt5rcM8XYJ40qE7IRXE4KdY5oK5ga4,3893
+synapse_sdk/plugins/categories/upload/actions/upload/steps/generate.py,sha256=dekCGjg-uSTBY7eNcM7emptl9Yxr038xup86Kfea-NE,3604
+synapse_sdk/plugins/categories/upload/actions/upload/steps/initialize.py,sha256=JaPK1Mn7Cq4z69AIYps6iOsvVztownW5RnvyhbKhiGk,3137
+synapse_sdk/plugins/categories/upload/actions/upload/steps/metadata.py,sha256=bQ9V8BaZ0LW42_cCsojA3hyQoa7RUCUGOzEaNCqN9wM,9197
+synapse_sdk/plugins/categories/upload/actions/upload/steps/organize.py,sha256=0MqkqeFxDjVFt5Jn_eOwHCrjhUNJU6xnS8H71eGkPdE,8712
+synapse_sdk/plugins/categories/upload/actions/upload/steps/upload.py,sha256=GPw5RyTZLAPY2uPeay1iTMf0U86lTDT3n99FdRsBzgA,4147
 synapse_sdk/plugins/categories/upload/actions/upload/steps/validate.py,sha256=31N7lb41G1-LlwLaGkCQkKB8ep4FPxxtLhp0sv3-1Vs,2427
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/__init__.py,sha256=JXysLlVGJDVtqZYFE6WIGcKgFNHcjqTzC0HO233Sak0,54
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/base.py,sha256=fMzTpZA6M-qqi9ZHBQ134a5w97QChiafHoi03AqwTpA,2488
@@ -272,8 +302,8 @@ synapse_sdk/plugins/categories/upload/actions/upload/strategies/data_unit/__init
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/data_unit/batch.py,sha256=YzKq5wHvrQ1_Tv__1xsX1ArLOEwgJNkDilZHg9k7GTY,1475
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/data_unit/single.py,sha256=bjvWu5t_nAK9Z8AWM_n1uwusMWd9G-7ddqSmwsH39l0,1344
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/__init__.py,sha256=ELVncVuhTFvPrbGUjZZAD7upvV3IEsaRi9eTXyjaOU8,42
-synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/flat.py,sha256=OW_EyZJYi40Qgri4MhRKGj98M-0SOUz58ldM-de00Cc,9866
-synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/recursive.py,sha256=gdIaOFB9QyO7MZTQTnX_iI_fn_ysEfRLKQRyRHzZkLE,11072
+synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/flat.py,sha256=QLd8pS9y3NyeNRQf1Ch5xFkwGRFjJoYXgV6QmHAn8hs,11155
+synapse_sdk/plugins/categories/upload/actions/upload/strategies/file_discovery/recursive.py,sha256=Q2tvBmuhlNndBVHR9asBaRH_N2Sx7N4doCXT1uLkP-M,12243
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/metadata/__init__.py,sha256=d3sSL9boHCmYmbWupbJ7s8LOBakGCgjiPKRQIbfDCs8,36
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/metadata/excel.py,sha256=LlykEvwfyuRRCWozExQoolvIfHH1-B4vHOu7dykSTnQ,7333
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/metadata/none.py,sha256=RGcSmc4N9JnqxC8R-AEo_4_wmg1KS0lij1PxXij9ipk,507
@@ -281,7 +311,8 @@ synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/__init__.
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/async_upload.py,sha256=Jn-yK0BqLgx1zRmIh9AJCDPsM2B9Yzu_0im5U305vnw,5720
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/sync.py,sha256=IkRpy561HMHE1Ji0l2Nv21CfH9ZiCrm4qBCADeZFTXs,1875
 synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/__init__.py,sha256=aq-sI8tScvc0rX21qlLeBgJyKaVpC0hziMB5vcg5K3Y,38
-synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/default.py,sha256=3v-nBoI8osnRKCYE0YqXRiA-yqe2_JRklVQ-Lo03LgY,1830
+synapse_sdk/plugins/categories/upload/actions/upload/strategies/validation/default.py,sha256=3_jLBqw2snnBAtDuKKwVS6ImMwDZHeOSnqph_jCq2nE,2515
+synapse_sdk/plugins/categories/upload/templates/README.md,sha256=D0U6lay1qrUY7WwOi9_GOVD6aCtJ9yK9aKfn7-CZFmo,9532
 synapse_sdk/plugins/categories/upload/templates/config.yaml,sha256=xrLMhK6QTvxnqep7ulrEuq8DxVPS7TOI2cogCaBxK2g,1127
 synapse_sdk/plugins/categories/upload/templates/plugin/__init__.py,sha256=G8xv24PGWmL84Y77tElaEJhbjyjxklkqqdmxmZ834L0,11239
 synapse_sdk/plugins/categories/upload/templates/plugin/upload.py,sha256=ylEbp2KFiLQosVr-Jl5SDeMNSgr9mwb4eNzuEq73BJA,3588
@@ -330,7 +361,7 @@ synapse_sdk/utils/file/__init__.py,sha256=1FFrQVddZ8GgjcXkpWh4YcKLdzzCIB0p8bGmE3
 synapse_sdk/utils/file/archive.py,sha256=Wdn4f7vkqePNCE2JPMzZnyIfLrQ33LuPRvEGwB4Ieg4,1107
 synapse_sdk/utils/file/checksum.py,sha256=9TArSECBHVwb0-NmtlJyNjZXXXMMOtwGxXW1p350B1g,1570
 synapse_sdk/utils/file/chunking.py,sha256=IC1FPMqRwtuDFTZOZDvhCuUfo2LBMIC4Tf-LeLB0A1Q,1088
-synapse_sdk/utils/file/download.py,sha256=Zsd0ik7ajRexwcRoQvx7AlZbe4uD9hhurZYs3eGw_1s,3931
+synapse_sdk/utils/file/download.py,sha256=5lKfrmbnm7qFDnvWLOxHj7F-DGxZ-5TN953JfsB_Y4g,15323
 synapse_sdk/utils/file/encoding.py,sha256=wcmWJuqhOnO94Umz03z_7znhtKwgpKIK9CsEagNdIwc,1124
 synapse_sdk/utils/file/io.py,sha256=fl_PvRrdnAkGMmxcDth6nshudv94nalibkPOaI7KIOk,447
 synapse_sdk/utils/file/video/__init__.py,sha256=mlmTtmx22-XZmrf5acPTOo2Ra2MMtVxUkxkDdQht4UE,614
@@ -347,9 +378,9 @@ synapse_sdk/utils/storage/providers/gcp.py,sha256=i2BQCu1Kej1If9SuNr2_lEyTcr5M_n
 synapse_sdk/utils/storage/providers/http.py,sha256=2DhIulND47JOnS5ZY7MZUex7Su3peAPksGo1Wwg07L4,5828
 synapse_sdk/utils/storage/providers/s3.py,sha256=ZmqekAvIgcQBdRU-QVJYv1Rlp6VHfXwtbtjTSphua94,2573
 synapse_sdk/utils/storage/providers/sftp.py,sha256=_8s9hf0JXIO21gvm-JVS00FbLsbtvly4c-ETLRax68A,1426
-synapse_sdk-2025.9.5.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
-synapse_sdk-2025.9.5.dist-info/METADATA,sha256=_B17n5pQ03tYuVoCy83dR2yjDMdnL2lLLyYvtsJMq4Q,3815
-synapse_sdk-2025.9.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-synapse_sdk-2025.9.5.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
-synapse_sdk-2025.9.5.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
-synapse_sdk-2025.9.5.dist-info/RECORD,,
+synapse_sdk-2025.10.6.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
+synapse_sdk-2025.10.6.dist-info/METADATA,sha256=jkNAyTDluLpDX8MiGonLV6aL5tdWAFCAJqkmUMjX1p8,4186
+synapse_sdk-2025.10.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+synapse_sdk-2025.10.6.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
+synapse_sdk-2025.10.6.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
+synapse_sdk-2025.10.6.dist-info/RECORD,,