thordata-sdk 1.5.0__tar.gz → 1.7.0__tar.gz

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thordata-sdk
-Version: 1.5.0
+Version: 1.7.0
 Summary: The Official Python SDK for Thordata - AI Data Infrastructure & Proxy Network.
 Author-email: Thordata Developer Team <support@thordata.com>
 License: MIT
@@ -63,9 +63,9 @@ Dynamic: license-file
 
 ## 📖 Introduction
 
-The **Thordata Python SDK v1.5.0** is a production-ready wrapper for Thordata's AI data infrastructure. It is architected for high reliability, strict type safety, and maximum performance.
+The **Thordata Python SDK v1.6.0** is a production-ready wrapper for Thordata's AI data infrastructure. It is architected for high reliability, strict type safety, and maximum performance.
 
-**Why v1.5.0?**
+**Why v1.6.0?**
 *   **🛡️ Bulletproof Networking**: Custom core handles `HTTP`, `HTTPS`, and `SOCKS5h` (Remote DNS) tunneling, solving common SSL/TLS handshake issues in complex network environments.
 *   **⚡ Async First**: First-class `asyncio` support with `aiohttp` for high-concurrency scraping (1000+ RPS).
 *   **🧩 100% API Coverage**: Every endpoint documented by Thordata (including Hourly Usage, Server Monitor, and Task Management) is implemented.
@@ -83,7 +83,7 @@ pip install thordata-sdk
 
 ## 🔐 Configuration
 
-Set environment variables to avoid hardcoding credentials.
+Set environment variables to avoid hardcoding credentials. **Full reference:** copy [.env.example](.env.example) to `.env` and fill in values.
 
 ```bash
 # [Scraping APIs]
@@ -93,13 +93,19 @@ export THORDATA_SCRAPER_TOKEN="your_scraper_token"
 export THORDATA_PUBLIC_TOKEN="your_public_token"
 export THORDATA_PUBLIC_KEY="your_public_key"
 
-# [Proxy Network]
+# [Proxy: Residential / Unlimited / Datacenter / Mobile / ISP]
 export THORDATA_RESIDENTIAL_USERNAME="your_username"
 export THORDATA_RESIDENTIAL_PASSWORD="your_password"
-# Optional: Set upstream proxy for local dev (e.g., Clash)
-# export THORDATA_UPSTREAM_PROXY="http://127.0.0.1:7890"
+# Optional: Unlimited (high-bandwidth) if your plan has separate credentials
+# export THORDATA_UNLIMITED_USERNAME="..."
+# export THORDATA_UNLIMITED_PASSWORD="..."
+
+# Optional: Upstream proxy when behind firewall (e.g. Clash Verge port 7897)
+# export THORDATA_UPSTREAM_PROXY="http://127.0.0.1:7897"
 ```
 
+Default proxy port is **9999** (residential); other products use different ports (see `.env.example`).
+
 ---
 
 ## 🚀 Quick Start
@@ -199,6 +205,48 @@ if status == "finished":
     print(f"Download: {data_url}")
 ```
 
+### Web Scraper Tools (120+ Pre-built Tools)
+
+Use pre-built tools for popular platforms. See [Tool Coverage Matrix](docs/TOOL_COVERAGE_MATRIX.md) for full list.
+
+```python
+from thordata import ThordataClient
+from thordata.tools import Amazon, GoogleMaps, YouTube, TikTok, eBay, Walmart
+
+client = ThordataClient()
+
+# Amazon Product by ASIN
+task_id = client.run_tool(Amazon.ProductByAsin(asin="B0BZYCJK89"))
+
+# Google Maps by Place ID
+task_id = client.run_tool(GoogleMaps.DetailsByPlaceId(place_id="ChIJPTacEpBQwokRKwIlDXelxkA"))
+
+# YouTube Video Download
+from thordata import CommonSettings
+settings = CommonSettings(resolution="<=360p", video_codec="vp9")
+task_id = client.run_tool(YouTube.VideoDownload(
+    url="https://www.youtube.com/watch?v=jNQXAC9IVRw",
+    common_settings=settings
+))
+
+# Wait and get results
+status = client.wait_for_task(task_id, max_wait=300)
+if status == "ready":
+    download_url = client.get_task_result(task_id)
+    print(f"Results: {download_url}")
+```
+
+**Available Platforms:**
+- **E-Commerce**: Amazon, eBay, Walmart
+- **Social Media**: TikTok, Instagram, Facebook, Twitter/X, Reddit, LinkedIn
+- **Search**: Google Maps, Google Shopping, Google Play
+- **Video**: YouTube (download, info, subtitles)
+- **Code**: GitHub
+- **Professional**: Indeed, Glassdoor, Crunchbase
+- **Travel/Real Estate**: Booking, Airbnb, Zillow
+
+See `examples/tools/` for more examples.
+
 ---
 
 ## 🛠️ Management APIs
@@ -226,6 +274,14 @@ monitor = client.unlimited.get_server_monitor(
 
 ---
 
+## 🧪 Development & Testing
+
+- **Full env reference**: Copy [.env.example](.env.example) to `.env` and fill in credentials.
+- **Unit tests** (no network): `pytest` or `python -m coverage run -m pytest -p no:cov tests && python -m coverage report -m`
+- **Integration tests** (live API/proxy): Set `THORDATA_INTEGRATION=true` in `.env`; optional `THORDATA_UPSTREAM_PROXY` (e.g. Clash) if behind a firewall. See [CONTRIBUTING.md](CONTRIBUTING.md#-testing-guidelines).
+
+---
+
 ## 📄 License
 
 MIT License. See [LICENSE](LICENSE) for details.

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/README.md

@@ -19,9 +19,9 @@
 
 ## 📖 Introduction
 
-The **Thordata Python SDK v1.5.0** is a production-ready wrapper for Thordata's AI data infrastructure. It is architected for high reliability, strict type safety, and maximum performance.
+The **Thordata Python SDK v1.6.0** is a production-ready wrapper for Thordata's AI data infrastructure. It is architected for high reliability, strict type safety, and maximum performance.
 
-**Why v1.5.0?**
+**Why v1.6.0?**
 *   **🛡️ Bulletproof Networking**: Custom core handles `HTTP`, `HTTPS`, and `SOCKS5h` (Remote DNS) tunneling, solving common SSL/TLS handshake issues in complex network environments.
 *   **⚡ Async First**: First-class `asyncio` support with `aiohttp` for high-concurrency scraping (1000+ RPS).
 *   **🧩 100% API Coverage**: Every endpoint documented by Thordata (including Hourly Usage, Server Monitor, and Task Management) is implemented.
@@ -39,7 +39,7 @@ pip install thordata-sdk
 
 ## 🔐 Configuration
 
-Set environment variables to avoid hardcoding credentials.
+Set environment variables to avoid hardcoding credentials. **Full reference:** copy [.env.example](.env.example) to `.env` and fill in values.
 
 ```bash
 # [Scraping APIs]
@@ -49,13 +49,19 @@ export THORDATA_SCRAPER_TOKEN="your_scraper_token"
 export THORDATA_PUBLIC_TOKEN="your_public_token"
 export THORDATA_PUBLIC_KEY="your_public_key"
 
-# [Proxy Network]
+# [Proxy: Residential / Unlimited / Datacenter / Mobile / ISP]
 export THORDATA_RESIDENTIAL_USERNAME="your_username"
 export THORDATA_RESIDENTIAL_PASSWORD="your_password"
-# Optional: Set upstream proxy for local dev (e.g., Clash)
-# export THORDATA_UPSTREAM_PROXY="http://127.0.0.1:7890"
+# Optional: Unlimited (high-bandwidth) if your plan has separate credentials
+# export THORDATA_UNLIMITED_USERNAME="..."
+# export THORDATA_UNLIMITED_PASSWORD="..."
+
+# Optional: Upstream proxy when behind firewall (e.g. Clash Verge port 7897)
+# export THORDATA_UPSTREAM_PROXY="http://127.0.0.1:7897"
 ```
 
+Default proxy port is **9999** (residential); other products use different ports (see `.env.example`).
+
 ---
 
 ## 🚀 Quick Start
@@ -155,6 +161,48 @@ if status == "finished":
     print(f"Download: {data_url}")
 ```
 
+### Web Scraper Tools (120+ Pre-built Tools)
+
+Use pre-built tools for popular platforms. See [Tool Coverage Matrix](docs/TOOL_COVERAGE_MATRIX.md) for full list.
+
+```python
+from thordata import ThordataClient
+from thordata.tools import Amazon, GoogleMaps, YouTube, TikTok, eBay, Walmart
+
+client = ThordataClient()
+
+# Amazon Product by ASIN
+task_id = client.run_tool(Amazon.ProductByAsin(asin="B0BZYCJK89"))
+
+# Google Maps by Place ID
+task_id = client.run_tool(GoogleMaps.DetailsByPlaceId(place_id="ChIJPTacEpBQwokRKwIlDXelxkA"))
+
+# YouTube Video Download
+from thordata import CommonSettings
+settings = CommonSettings(resolution="<=360p", video_codec="vp9")
+task_id = client.run_tool(YouTube.VideoDownload(
+    url="https://www.youtube.com/watch?v=jNQXAC9IVRw",
+    common_settings=settings
+))
+
+# Wait and get results
+status = client.wait_for_task(task_id, max_wait=300)
+if status == "ready":
+    download_url = client.get_task_result(task_id)
+    print(f"Results: {download_url}")
+```
+
+**Available Platforms:**
+- **E-Commerce**: Amazon, eBay, Walmart
+- **Social Media**: TikTok, Instagram, Facebook, Twitter/X, Reddit, LinkedIn
+- **Search**: Google Maps, Google Shopping, Google Play
+- **Video**: YouTube (download, info, subtitles)
+- **Code**: GitHub
+- **Professional**: Indeed, Glassdoor, Crunchbase
+- **Travel/Real Estate**: Booking, Airbnb, Zillow
+
+See `examples/tools/` for more examples.
+
 ---
 
 ## 🛠️ Management APIs
@@ -182,6 +230,14 @@ monitor = client.unlimited.get_server_monitor(
 
 ---
 
+## 🧪 Development & Testing
+
+- **Full env reference**: Copy [.env.example](.env.example) to `.env` and fill in credentials.
+- **Unit tests** (no network): `pytest` or `python -m coverage run -m pytest -p no:cov tests && python -m coverage report -m`
+- **Integration tests** (live API/proxy): Set `THORDATA_INTEGRATION=true` in `.env`; optional `THORDATA_UPSTREAM_PROXY` (e.g. Clash) if behind a firewall. See [CONTRIBUTING.md](CONTRIBUTING.md#-testing-guidelines).
+
+---
+
 ## 📄 License
 
 MIT License. See [LICENSE](LICENSE) for details.

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "thordata-sdk"
-version = "1.5.0"
+version = "1.7.0"
 description = "The Official Python SDK for Thordata - AI Data Infrastructure & Proxy Network."
 readme = "README.md"
 requires-python = ">=3.9"
@@ -115,16 +115,17 @@ check_untyped_defs = false
 strict_optional = false
 show_error_codes = true
 ignore_missing_imports = true
+follow_imports = "skip"
 
 [[tool.mypy.overrides]]
 module = ["aiohttp.*", "requests.*"]
 ignore_missing_imports = true
 
-# Pytest setup
+# Pytest setup (coverage is run separately via coverage CLI for reliability)
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 asyncio_mode = "auto"
-addopts = "-v --cov=thordata --cov-report=term-missing"
+addopts = "-v"
 markers = ["integration: live tests that require real credentials"]
 
 # Coverage setup

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/src/thordata/__init__.py

@@ -5,7 +5,7 @@ Official Python client for Thordata's Proxy Network, SERP API,
 Universal Scraping API (Web Unlocker), and Web Scraper API.
 """
 
-__version__ = "1.5.0"
+__version__ = "1.6.0"
 __author__ = "Thordata Developer Team/Kael Odin"
 __email__ = "support@thordata.com"
 

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/src/thordata/async_client.py

@@ -124,10 +124,10 @@ class AsyncThordataClient:
         ).rstrip("/")
 
         self._gateway_base_url = os.getenv(
-            "THORDATA_GATEWAY_BASE_URL", "https://api.thordata.com/api/gateway"
+            "THORDATA_GATEWAY_BASE_URL", "https://openapi.thordata.com/api/gateway"
         )
         self._child_base_url = os.getenv(
-            "THORDATA_CHILD_BASE_URL", "https://api.thordata.com/api/child"
+            "THORDATA_CHILD_BASE_URL", "https://openapi.thordata.com/api/child"
         )
 
         # URL Construction
@@ -145,7 +145,7 @@ class AsyncThordataClient:
         self._proxy_users_url = f"{shared_api_base}/proxy-users"
 
         whitelist_base = os.getenv(
-            "THORDATA_WHITELIST_BASE_URL", "https://api.thordata.com/api"
+            "THORDATA_WHITELIST_BASE_URL", "https://openapi.thordata.com/api"
         )
         self._whitelist_url = f"{whitelist_base}/whitelisted-ips"
 
@@ -293,28 +293,36 @@ class AsyncThordataClient:
         url: str,
         *,
         js_render: bool = False,
-        output_format: str = "html",
+        output_format: str | list[str] = "html",
         country: str | None = None,
         block_resources: str | None = None,
+        clean_content: str | None = None,
         wait: int | None = None,
         wait_for: str | None = None,
+        follow_redirect: bool | None = None,
+        headers: list[dict[str, str]] | None = None,
+        cookies: list[dict[str, str]] | None = None,
         **kwargs: Any,
-    ) -> str | bytes:
+    ) -> str | bytes | dict[str, str | bytes]:
         request = UniversalScrapeRequest(
             url=url,
             js_render=js_render,
             output_format=output_format,
             country=country,
             block_resources=block_resources,
+            clean_content=clean_content,
             wait=wait,
             wait_for=wait_for,
+            follow_redirect=follow_redirect,
+            headers=headers,
+            cookies=cookies,
             extra_params=kwargs,
         )
         return await self.universal_scrape_advanced(request)
 
     async def universal_scrape_advanced(
         self, request: UniversalScrapeRequest
-    ) -> str | bytes:
+    ) -> str | bytes | dict[str, str | bytes]:
         if not self.scraper_token:
             raise ThordataConfigError("scraper_token required")
         payload = request.to_payload()
@@ -327,9 +335,17 @@ class AsyncThordataClient:
         try:
             resp_json = await response.json()
         except ValueError:
-            if request.output_format.lower() == "png":
-                return await response.read()
-            return await response.text()
+            # If not JSON, return raw content based on format
+            if isinstance(request.output_format, list) or (
+                isinstance(request.output_format, str) and "," in request.output_format
+            ):
+                return {"raw": await response.read()}
+            fmt = (
+                request.output_format.lower()
+                if isinstance(request.output_format, str)
+                else str(request.output_format).lower()
+            )
+            return await response.read() if fmt == "png" else await response.text()
 
         if isinstance(resp_json, dict):
             code = resp_json.get("code")
@@ -337,6 +353,27 @@ class AsyncThordataClient:
                 msg = extract_error_message(resp_json)
                 raise_for_code(f"Universal Error: {msg}", code=code, payload=resp_json)
 
+        # Handle multiple output formats
+        if isinstance(request.output_format, list) or (
+            isinstance(request.output_format, str) and "," in request.output_format
+        ):
+            result: dict[str, str | bytes] = {}
+            formats = (
+                request.output_format
+                if isinstance(request.output_format, list)
+                else [f.strip() for f in request.output_format.split(",")]
+            )
+
+            for fmt in formats:
+                fmt_lower = fmt.lower()
+                if fmt_lower == "html" and "html" in resp_json:
+                    result["html"] = resp_json["html"]
+                elif fmt_lower == "png" and "png" in resp_json:
+                    result["png"] = decode_base64_image(resp_json["png"])
+
+            if result:
+                return result
+
         if "html" in resp_json:
             return resp_json["html"]
         if "png" in resp_json:
@@ -352,7 +389,7 @@ class AsyncThordataClient:
         file_name: str,
         spider_id: str,
         spider_name: str,
-        parameters: dict[str, Any],
+        parameters: dict[str, Any] | list[dict[str, Any]],
         universal_params: dict[str, Any] | None = None,
     ) -> str:
         config = ScraperTaskConfig(
@@ -434,7 +471,7 @@ class AsyncThordataClient:
         file_name: str,
         spider_id: str,
         spider_name: str,
-        parameters: dict[str, Any],
+        parameters: dict[str, Any] | list[dict[str, Any]],
         common_settings: CommonSettings,
     ) -> str:
         config = VideoTaskConfig(
@@ -550,7 +587,7 @@ class AsyncThordataClient:
         file_name: str,
         spider_id: str,
         spider_name: str,
-        parameters: dict[str, Any],
+        parameters: dict[str, Any] | list[dict[str, Any]],
         universal_params: dict[str, Any] | None = None,
         *,
         max_wait: float = 600.0,
@@ -971,7 +1008,12 @@ class AsyncThordataClient:
         if port:
             params["port"] = str(port)
 
-        username = os.getenv("THORDATA_RESIDENTIAL_USERNAME")
+        if product == "unlimited":
+            username = os.getenv("THORDATA_UNLIMITED_USERNAME") or os.getenv(
+                "THORDATA_RESIDENTIAL_USERNAME"
+            )
+        else:
+            username = os.getenv("THORDATA_RESIDENTIAL_USERNAME")
         if username:
             params["td-customer"] = username
 

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/src/thordata/client.py

@@ -53,6 +53,7 @@ from .serp_engines import SerpNamespace
 # Import Types (Modernized)
 from .types import (
     CommonSettings,
+    DataFormat,
     ProxyConfig,
     ProxyProduct,
     ProxyServer,
@@ -159,10 +160,10 @@ class ThordataClient:
         ).rstrip("/")
 
         self._gateway_base_url = os.getenv(
-            "THORDATA_GATEWAY_BASE_URL", "https://api.thordata.com/api/gateway"
+            "THORDATA_GATEWAY_BASE_URL", "https://openapi.thordata.com/api/gateway"
         )
         self._child_base_url = os.getenv(
-            "THORDATA_CHILD_BASE_URL", "https://api.thordata.com/api/child"
+            "THORDATA_CHILD_BASE_URL", "https://openapi.thordata.com/api/child"
         )
 
         # URL Construction
@@ -183,7 +184,7 @@ class ThordataClient:
         self._proxy_users_url = f"{shared_api_base}/proxy-users"
 
         whitelist_base = os.getenv(
-            "THORDATA_WHITELIST_BASE_URL", "https://api.thordata.com/api"
+            "THORDATA_WHITELIST_BASE_URL", "https://openapi.thordata.com/api"
         )
         self._whitelist_url = f"{whitelist_base}/whitelisted-ips"
 
@@ -364,26 +365,36 @@ class ThordataClient:
         url: str,
         *,
         js_render: bool = False,
-        output_format: str = "html",
+        output_format: str | list[str] = "html",
         country: str | None = None,
         block_resources: str | None = None,
+        clean_content: str | None = None,
         wait: int | None = None,
         wait_for: str | None = None,
+        follow_redirect: bool | None = None,
+        headers: list[dict[str, str]] | None = None,
+        cookies: list[dict[str, str]] | None = None,
         **kwargs: Any,
-    ) -> str | bytes:
+    ) -> str | bytes | dict[str, str | bytes]:
         request = UniversalScrapeRequest(
             url=url,
             js_render=js_render,
             output_format=output_format,
             country=country,
             block_resources=block_resources,
+            clean_content=clean_content,
             wait=wait,
             wait_for=wait_for,
+            follow_redirect=follow_redirect,
+            headers=headers,
+            cookies=cookies,
             extra_params=kwargs,
         )
         return self.universal_scrape_advanced(request)
 
-    def universal_scrape_advanced(self, request: UniversalScrapeRequest) -> str | bytes:
+    def universal_scrape_advanced(
+        self, request: UniversalScrapeRequest
+    ) -> str | bytes | dict[str, str | bytes]:
         if not self.scraper_token:
             raise ThordataConfigError("scraper_token required")
 
@@ -405,7 +416,7 @@ class ThordataClient:
         file_name: str,
         spider_id: str,
         spider_name: str,
-        parameters: dict[str, Any],
+        parameters: dict[str, Any] | list[dict[str, Any]],
         universal_params: dict[str, Any] | None = None,
     ) -> str:
         config = ScraperTaskConfig(
@@ -490,7 +501,7 @@ class ThordataClient:
         file_name: str,
         spider_id: str,
         spider_name: str,
-        parameters: dict[str, Any],
+        parameters: dict[str, Any] | list[dict[str, Any]],
         common_settings: CommonSettings,
     ) -> str:
         config = VideoTaskConfig(
@@ -639,7 +650,7 @@ class ThordataClient:
         file_name: str,
         spider_id: str,
         spider_name: str,
-        parameters: dict[str, Any],
+        parameters: dict[str, Any] | list[dict[str, Any]],
         universal_params: dict[str, Any] | None = None,
         *,
         max_wait: float = 600.0,
@@ -648,6 +659,7 @@ class ThordataClient:
         include_errors: bool = True,
         task_type: str = "web",
         common_settings: CommonSettings | None = None,
+        data_format: DataFormat | str | None = None,
     ) -> str:
         import time
 
@@ -671,6 +683,7 @@ class ThordataClient:
                 parameters=parameters,
                 universal_params=universal_params,
                 include_errors=include_errors,
+                data_format=data_format,
             )
             task_id = self.create_scraper_task_advanced(config)
 
@@ -862,7 +875,12 @@ class ThordataClient:
         if port:
             params["port"] = str(port)
 
-        username = os.getenv("THORDATA_RESIDENTIAL_USERNAME")
+        if product == "unlimited":
+            username = os.getenv("THORDATA_UNLIMITED_USERNAME") or os.getenv(
+                "THORDATA_RESIDENTIAL_USERNAME"
+            )
+        else:
+            username = os.getenv("THORDATA_RESIDENTIAL_USERNAME")
         if username:
             params["td-customer"] = username
 
@@ -1207,12 +1225,22 @@ class ThordataClient:
     # =========================================================================
 
     def _process_universal_response(
-        self, response: requests.Response, output_format: str
-    ) -> str | bytes:
+        self, response: requests.Response, output_format: str | list[str]
+    ) -> str | bytes | dict[str, str | bytes]:
+        """Process universal scrape response. Returns single value or dict if multiple formats requested."""
         try:
             resp_json = response.json()
         except ValueError:
-            return response.content if output_format.lower() == "png" else response.text
+            # If not JSON, return raw content based on format
+            if isinstance(output_format, list):
+                # Multiple formats requested but got non-JSON response
+                return {"raw": response.content}
+            fmt = (
+                output_format.lower()
+                if isinstance(output_format, str)
+                else str(output_format).lower()
+            )
+            return response.content if fmt == "png" else response.text
 
         if isinstance(resp_json, dict):
             code = resp_json.get("code")
@@ -1220,6 +1248,29 @@ class ThordataClient:
                 msg = extract_error_message(resp_json)
                 raise_for_code(f"Universal Error: {msg}", code=code, payload=resp_json)
 
+        # Handle multiple output formats
+        if isinstance(output_format, list) or (
+            isinstance(output_format, str) and "," in output_format
+        ):
+            result: dict[str, str | bytes] = {}
+            formats = (
+                output_format
+                if isinstance(output_format, list)
+                else [f.strip() for f in output_format.split(",")]
+            )
+
+            for fmt in formats:
+                fmt_lower = fmt.lower()
+                if fmt_lower == "html" and "html" in resp_json:
+                    result["html"] = resp_json["html"]
+                elif fmt_lower == "png" and "png" in resp_json:
+                    result["png"] = decode_base64_image(resp_json["png"])
+
+            # If we got results, return dict; otherwise return single value for backward compatibility
+            if result:
+                return result
+
+        # Single format (backward compatibility)
         if "html" in resp_json:
             return resp_json["html"]
         if "png" in resp_json:

{thordata_sdk-1.5.0 → thordata_sdk-1.7.0}/src/thordata/enums.py

@@ -1,6 +1,6 @@
 """
 Enumerations for the Thordata Python SDK.
-Moved to thordata.types in v1.5.0.
+Moved to thordata.types in v1.6.0.
 This file is kept for backward compatibility.
 """
 
@@ -21,7 +21,7 @@ from .types import (
     SessionType,
     TaskStatus,
     TimeRange,
-    normalize_enum_value,  # 新增
+    normalize_enum_value,
 )
 
 __all__ = [