synapse-sdk 2025.10.1__py3-none-any.whl → 2025.10.3__py3-none-any.whl

synapse_sdk/plugins/categories/upload/templates/README.md

@@ -0,0 +1,365 @@
+# Upload Plugin
+
+The Upload Plugin provides comprehensive file and data upload functionality with support for various storage backends, flexible asset path configuration, and Excel metadata integration.
+
+## Quick Start Usage
+
+### CLI Usage Examples
+
+#### Standard Upload (Single Directory)
+```bash
+synapse plugin run upload '{
+  "name": "Dataset Upload",
+  "storage": 1,
+  "collection": 2,
+  "use_single_path": false,
+  "assets": {
+    "path": "/data/dataset",
+    "recursive": true
+  }
+}'
+```
+
+#### Multi-Path Upload (Different Locations)
+```bash
+synapse plugin run upload '{
+  "name": "Complex Dataset Upload",
+  "storage": 1,
+  "collection": 2,
+  "use_single_path": true,
+  "assets": {
+    "images": {"path": "/images", "recursive": true},
+    "pointclouds": {"path": "/pcd", "recursive": false},
+    "annotations": {"path": "/labels", "recursive": true}
+  },
+  "excel_metadata_path": "/metadata/dataset_info.xlsx"
+}' --debug
+```
+
+### Common Use Cases
+
+#### 1. Simple Dataset Upload
+```json
+{
+  "name": "Training Dataset",
+  "storage": 1,
+  "collection": 2,
+  "assets": {
+    "path": "/datasets/training",
+    "recursive": true
+  }
+}
+```
+
+#### 2. Multi-Source Dataset Upload
+```json
+{
+  "name": "Multi-Camera Dataset",
+  "storage": 1,
+  "collection": 2,
+  "use_single_path": true,
+  "assets": {
+    "front_camera": {"path": "/cameras/front", "recursive": true},
+    "rear_camera": {"path": "/cameras/rear", "recursive": true},
+    "lidar": {"path": "/sensors/lidar", "recursive": false}
+  }
+}
+```
+
+#### 3. Dataset with Metadata
+```json
+{
+  "name": "Annotated Dataset",
+  "storage": 1,
+  "collection": 2,
+  "assets": {
+    "path": "/data/annotated",
+    "recursive": true
+  },
+  "excel_metadata_path": "/data/metadata.xlsx"
+}
+```
+
+## Configuration Parameters
+
+### Required Parameters
+
+| Parameter | Type | Description | Example |
+|-----------|------|-------------|---------|
+| `name` | string | Display name for the upload | `"My Dataset"` |
+| `storage` | integer | Storage backend ID | `1` |
+| `collection` | integer | Collection ID defining file specs | `2` |
+| `assets` | object | Path configuration (varies by mode) | See examples below |
+
+### Optional Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `description` | string | `null` | Upload description |
+| `project` | integer | `null` | Project ID to associate |
+| `use_single_path` | boolean | `false` | Enable individual path mode |
+| `is_recursive` | boolean | `false` | Global recursive setting |
+| `excel_metadata_path` | `string` | `null` | File path to Excel metadata file (will be deprecated in future, consider using `excel_metadata`) |
+| `excel_metadata` | `object` | `null` | Base64 encoded Excel metadata (recommended) |
+
+## Excel Metadata Support
+
+The upload plugin provides advanced Excel metadata processing with flexible header support, comprehensive filename matching, and two distinct input methods.
+
+### Input Methods
+
+There are two separate parameters for providing Excel metadata:
+
+#### 1. File Path Method (`excel_metadata_path`)
+
+:::info Future Deprecation Notice
+This parameter will be deprecated in a future version.
+We recommend using the `excel_metadata` parameter with base64 encoding for new implementations.
+:::
+
+**Use case:** Traditional file-based uploads where the Excel file exists on the server's file system.
+
+Simple string path to an Excel file:
+
+```json
+{
+  "excel_metadata_path": "/data/metadata.xlsx"
+}
+```
+
+**Advantages:**
+- Backward compatible with existing implementations
+- Simple and straightforward
+- Direct file system access
+
+**Note:** Consider migrating to base64 encoded method for future compatibility (see Method 2 below)
+
+#### 2. Base64 Encoded Method (`excel_metadata`) - **RECOMMENDED**
+
+**Use case:** Web frontends, APIs, and cloud integrations where files are transmitted as encoded data.
+
+Send Excel file as base64-encoded data with original filename:
+
+```json
+{
+  "excel_metadata": {
+    "data": "UEsDBBQABgAIAAAAIQDd4Z...",
+    "filename": "metadata.xlsx"
+  }
+}
+```
+
+**Advantages:**
+- No intermediate file storage required
+- Perfect for web upload forms
+- API-friendly JSON payload
+- Automatic temporary file cleanup
+- **This is the recommended method going forward**
+
+**Important:** You cannot use both `excel_metadata_path` and `excel_metadata` at the same time
+
+**Future-Proof Migration Example:**
+```python
+import base64
+
+# Current approach (will be deprecated in future)
+params = {
+    "excel_metadata_path": "/data/metadata.xlsx"
+}
+
+# Recommended approach for new implementations
+with open("/data/metadata.xlsx", "rb") as f:
+    encoded = base64.b64encode(f.read()).decode("utf-8")
+params = {
+    "excel_metadata": {
+        "data": encoded,
+        "filename": "metadata.xlsx"
+    }
+}
+```
+
+### Excel Format Example
+| filename | category | quality | notes |
+|----------|----------|---------|-------|
+| sample001 | vehicle | high | Clear visibility |
+| sample002 | pedestrian | medium | Partial occlusion |
+
+### Security Limits
+- Max file size: 10MB
+- Max rows: 10,000
+- Max columns: 50
+
+## File Matching Logic
+
+Files are matched by **stem name** (filename without extension):
+- `sample001.jpg` → stem: "sample001"
+- `sample001.pcd` → stem: "sample001"
+- `sample001.json` → stem: "sample001"
+
+These files form a single dataset named "sample001".
+
+## Troubleshooting Guide
+
+### Common Issues
+
+#### "No Files Found" Error
+```bash
+# Check path exists and is readable
+ls -la /path/to/data
+test -r /path/to/data && echo "Readable" || echo "Not readable"
+
+# Verify files exist
+find /path/to/data -name "*.jpg" | head -10
+```
+
+#### Excel Processing Errors
+```bash
+# Check file format and size
+file /path/to/metadata.xlsx
+ls -lh /path/to/metadata.xlsx
+
+# Validate Excel content
+python -c "
+from openpyxl import load_workbook
+wb = load_workbook('/path/to/metadata.xlsx')
+print(f'Sheets: {wb.sheetnames}')
+print(f'Rows: {wb.active.max_row}')
+"
+```
+
+#### Upload Failures
+```bash
+# Test storage connection
+synapse storage test --storage-id 1
+
+# Verify collection configuration
+synapse collection show --id 2
+
+# Run with debug mode
+synapse plugin run upload '{}' --debug
+```
+
+## Best Practices
+
+### Directory Organization
+- Use clear, descriptive directory names
+- Keep reasonable directory sizes (< 10,000 files)
+- Use absolute paths for reliability
+
+### Performance Optimization
+- Enable recursive only when needed
+- Keep Excel files under 5MB
+- Organize files in balanced directory structures
+
+### Security Considerations
+- Validate all paths before processing
+- Use read-only permissions for source data
+- Set appropriate Excel size limits
+
+## Advanced Features
+
+### Batch Processing
+The plugin automatically optimizes batch sizes based on dataset size:
+- Small datasets (< 50 files): batch size 50
+- Large datasets: dynamic batch size (10-100)
+
+### Progress Tracking
+Real-time progress updates with categories:
+- Collection analysis: 2%
+- File upload: 38%
+- Data unit generation: 60%
+
+### Error Handling
+Comprehensive validation at multiple levels:
+- Parameter validation (Pydantic)
+- Runtime path validation
+- File format validation
+- Excel security checks
+
+## Environment Variables
+
+Configure Excel processing limits:
+```bash
+# File size limits
+EXCEL_MAX_FILE_SIZE_MB=10
+EXCEL_MAX_MEMORY_MB=30
+
+# Content limits
+EXCEL_MAX_ROWS=10000
+EXCEL_MAX_COLUMNS=50
+
+# String length limits
+EXCEL_MAX_FILENAME_LENGTH=255
+EXCEL_MAX_METADATA_VALUE_LENGTH=1000
+```
+
+## Migration Guide
+
+### Upgrading from Previous Versions
+All existing configurations continue to work. New features are additive:
+
+#### Test Current Configuration
+```bash
+synapse plugin run upload '{}' --debug
+```
+
+#### Convert to Explicit Mode
+```python
+# Add explicit mode setting
+config["use_single_path"] = False  # or True for single path mode
+```
+
+#### Gradual Migration to Single Path Mode
+```python
+# Start with subset
+test_config = {
+    "use_single_path": True,
+    "assets": {
+        "test_images": {"path": "/existing/path/images", "recursive": True}
+    }
+}
+
+# Then migrate all assets
+production_config = {
+    "use_single_path": True,
+    "assets": {
+        "images": {"path": "/optimized/path1", "recursive": True},
+        "annotations": {"path": "/optimized/path2", "recursive": False}
+    }
+}
+```
+
+## Storage Backend Support
+
+The plugin supports multiple storage backends:
+- **Local filesystem**: Optimized for high I/O
+- **S3/GCS**: Cloud storage with retry logic
+- **SFTP**: Connection pooling for remote servers
+- **HTTP**: Streaming uploads for large files
+
+## API Reference
+
+### Plugin Class
+```python
+from synapse import Plugin
+
+plugin = Plugin("upload")
+result = plugin.run(config, debug=True)
+```
+
+### Result Structure
+```python
+{
+    "status": "success",
+    "uploaded_files": 150,
+    "data_units_created": 50,
+    "errors": [],
+    "metadata": {}
+}
+```
+
+## Support and Resources
+
+- **Documentation**: Full API documentation at [synapse-docs]
+- **Issues**: Report bugs at [issue-tracker]
+- **Examples**: More examples at [examples-repo]

{synapse_sdk-2025.10.1.dist-info → synapse_sdk-2025.10.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapse-sdk
-Version: 2025.10.1
+Version: 2025.10.3
 Summary: synapse sdk
 Author-email: datamaker <developer@datamaker.io>
 License: MIT

{synapse_sdk-2025.10.1.dist-info → synapse_sdk-2025.10.3.dist-info}/RECORD

@@ -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=fwwyZVFAHAVVB5c1-NtkalpF9_1sHZo1AVaZ1X-tZEk,1999
+synapse_sdk/devtools/docs/sidebars.ts,sha256=6MuXgPLBmk-URt37Jnv1uJjiL98xiqSCiHvu-utCXq4,2427
 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
@@ -94,10 +94,11 @@ 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=Wajf3CZRQiytRx6SS1lIBlGO5o4F2vOw-xog51JiHJU,37074
-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/plugins.md,sha256=G6y3XZZHuC65ApfKE0fYHCAC5TOFnZqzE7VR-KOExVk,25074
+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=E42ycC5Jfb19DBdLZ2QnCiABUuXkJW4a0ZEQwnXi2ZY,15740
+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 +112,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
@@ -142,10 +143,11 @@ 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=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/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=mcqq_bbC13KAgNZX6OUEbHxt03QhGMN9vF2MmU0WW-A,17111
+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
@@ -180,7 +182,7 @@ 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
@@ -231,9 +233,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
@@ -246,25 +265,25 @@ 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/__init__.py,sha256=ShmALSr3rncCMHYlSJkYwdvEOsEHUxAzG5-hoERhmI0,548
 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/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/metadata.py,sha256=xgBVneUZQFeHe6l2MWc5ZZ5PCGtq_l7AHX8NLdmEQvg,8473
+synapse_sdk/plugins/categories/upload/actions/upload/steps/organize.py,sha256=ftphDYloGG0G0pmRHyMAF8pIpQPiofxYyHRR4RTxxAU,6932
 synapse_sdk/plugins/categories/upload/actions/upload/steps/upload.py,sha256=cuWjxfWrmHrklTt5rcM8XYJ40qE7IRXE4KdY5oK5ga4,3893
 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
@@ -283,6 +302,7 @@ synapse_sdk/plugins/categories/upload/actions/upload/strategies/upload/async_upl
 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/templates/README.md,sha256=30BC3CpHrPmjPeLExFtjnYi6qZrBcDdn4fOc5F-uMmc,8995
 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
@@ -348,9 +368,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.10.1.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
-synapse_sdk-2025.10.1.dist-info/METADATA,sha256=no_NdFTFHDpqgaKhiwrpbPZ-vCybuHbT89Hb9lXVt9A,4186
-synapse_sdk-2025.10.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-synapse_sdk-2025.10.1.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
-synapse_sdk-2025.10.1.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
-synapse_sdk-2025.10.1.dist-info/RECORD,,
+synapse_sdk-2025.10.3.dist-info/licenses/LICENSE,sha256=bKzmC5YAg4V1Fhl8OO_tqY8j62hgdncAkN7VrdjmrGk,1101
+synapse_sdk-2025.10.3.dist-info/METADATA,sha256=wvNWIgxu6dCxIudxnaO9yKxC-mg0xApM6CRul_s95m0,4186
+synapse_sdk-2025.10.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+synapse_sdk-2025.10.3.dist-info/entry_points.txt,sha256=VNptJoGoNJI8yLXfBmhgUefMsmGI0m3-0YoMvrOgbxo,48
+synapse_sdk-2025.10.3.dist-info/top_level.txt,sha256=ytgJMRK1slVOKUpgcw3LEyHHP7S34J6n_gJzdkcSsw8,12
+synapse_sdk-2025.10.3.dist-info/RECORD,,