aiecs 1.7.17__py3-none-any.whl → 1.8.4__py3-none-any.whl

aiecs/llm/clients/xai_client.py

@@ -87,6 +87,7 @@ class XAIClient(BaseLLMClient, OpenAICompatibleFunctionCallingMixin):
         model: Optional[str] = None,
         temperature: float = 0.7,
         max_tokens: Optional[int] = None,
+        context: Optional[Dict[str, Any]] = None,
         functions: Optional[List[Dict[str, Any]]] = None,
         tools: Optional[List[Dict[str, Any]]] = None,
         tool_choice: Optional[Any] = None,
@@ -94,8 +95,27 @@ class XAIClient(BaseLLMClient, OpenAICompatibleFunctionCallingMixin):
     ) -> LLMResponse:
         """
         Generate text using xAI API via OpenAI library (supports all Grok models).
-        
+
         xAI API is OpenAI-compatible, so it supports Function Calling.
+
+        Args:
+            messages: List of conversation messages
+            model: Model name (optional, uses default if not provided)
+            temperature: Sampling temperature (0.0 to 1.0)
+            max_tokens: Maximum tokens to generate
+            context: Optional context dictionary containing metadata such as:
+                - user_id: User identifier for tracking/billing
+                - tenant_id: Tenant identifier for multi-tenant setups
+                - request_id: Request identifier for tracing
+                - session_id: Session identifier
+                - Any other custom metadata for observability or middleware
+            functions: List of function schemas (legacy format)
+            tools: List of tool schemas (new format, recommended)
+            tool_choice: Tool choice strategy
+            **kwargs: Additional provider-specific parameters
+
+        Returns:
+            LLMResponse with generated text and metadata
         """
         # Check API key availability
         api_key = self._get_api_key()
@@ -144,6 +164,7 @@ class XAIClient(BaseLLMClient, OpenAICompatibleFunctionCallingMixin):
         model: Optional[str] = None,
         temperature: float = 0.7,
         max_tokens: Optional[int] = None,
+        context: Optional[Dict[str, Any]] = None,
         functions: Optional[List[Dict[str, Any]]] = None,
         tools: Optional[List[Dict[str, Any]]] = None,
         tool_choice: Optional[Any] = None,
@@ -152,11 +173,28 @@ class XAIClient(BaseLLMClient, OpenAICompatibleFunctionCallingMixin):
     ) -> AsyncGenerator[Any, None]:
         """
         Stream text using xAI API via OpenAI library (supports all Grok models).
-        
+
         xAI API is OpenAI-compatible, so it supports Function Calling.
-        
+
         Args:
+            messages: List of conversation messages
+            model: Model name (optional, uses default if not provided)
+            temperature: Sampling temperature (0.0 to 1.0)
+            max_tokens: Maximum tokens to generate
+            context: Optional context dictionary containing metadata such as:
+                - user_id: User identifier for tracking/billing
+                - tenant_id: Tenant identifier for multi-tenant setups
+                - request_id: Request identifier for tracing
+                - session_id: Session identifier
+                - Any other custom metadata for observability or middleware
+            functions: List of function schemas (legacy format)
+            tools: List of tool schemas (new format, recommended)
+            tool_choice: Tool choice strategy
             return_chunks: If True, returns StreamChunk objects with tool_calls info; if False, returns str tokens only
+            **kwargs: Additional provider-specific parameters
+
+        Yields:
+            str or StreamChunk: Text tokens or StreamChunk objects
         """
         # Check API key availability
         api_key = self._get_api_key()

aiecs/llm/protocols.py

@@ -4,7 +4,7 @@ LLM Client Protocols
 Defines Protocol interfaces for LLM clients to enable duck typing and flexible integration.
 """
 
-from typing import Protocol, List, Optional, AsyncGenerator, runtime_checkable
+from typing import Protocol, List, Optional, AsyncGenerator, runtime_checkable, Dict, Any
 from aiecs.llm.clients.base_client import LLMMessage, LLMResponse
 
 
@@ -31,9 +31,12 @@ class LLMClientProtocol(Protocol):
                 model: Optional[str] = None,
                 temperature: float = 0.7,
                 max_tokens: Optional[int] = None,
+                context: Optional[Dict[str, Any]] = None,
                 **kwargs
             ) -> LLMResponse:
                 # Custom implementation
+                # Use context for tracking, billing, observability, etc.
+                user_id = context.get("user_id") if context else None
                 pass
 
             async def stream_text(
@@ -42,6 +45,7 @@ class LLMClientProtocol(Protocol):
                 model: Optional[str] = None,
                 temperature: float = 0.7,
                 max_tokens: Optional[int] = None,
+                context: Optional[Dict[str, Any]] = None,
                 **kwargs
             ) -> AsyncGenerator[str, None]:
                 # Custom implementation
@@ -67,6 +71,7 @@ class LLMClientProtocol(Protocol):
         model: Optional[str] = None,
         temperature: float = 0.7,
         max_tokens: Optional[int] = None,
+        context: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> LLMResponse:
         """
@@ -77,6 +82,12 @@ class LLMClientProtocol(Protocol):
             model: Model name (optional, uses default if not provided)
             temperature: Sampling temperature (0.0 to 1.0)
             max_tokens: Maximum tokens to generate
+            context: Optional context dictionary containing metadata such as:
+                - user_id: User identifier for tracking/billing
+                - tenant_id: Tenant identifier for multi-tenant setups
+                - request_id: Request identifier for tracing
+                - session_id: Session identifier
+                - Any other custom metadata for observability or middleware
             **kwargs: Additional provider-specific parameters
 
         Returns:
@@ -90,6 +101,7 @@ class LLMClientProtocol(Protocol):
         model: Optional[str] = None,
         temperature: float = 0.7,
         max_tokens: Optional[int] = None,
+        context: Optional[Dict[str, Any]] = None,
         **kwargs,
     ) -> AsyncGenerator[str, None]:
         """
@@ -100,6 +112,12 @@ class LLMClientProtocol(Protocol):
             model: Model name (optional, uses default if not provided)
             temperature: Sampling temperature (0.0 to 1.0)
             max_tokens: Maximum tokens to generate
+            context: Optional context dictionary containing metadata such as:
+                - user_id: User identifier for tracking/billing
+                - tenant_id: Tenant identifier for multi-tenant setups
+                - request_id: Request identifier for tracing
+                - session_id: Session identifier
+                - Any other custom metadata for observability or middleware
             **kwargs: Additional provider-specific parameters
 
         Yields:

aiecs/llm/utils/image_utils.py

@@ -0,0 +1,179 @@
+"""
+Image processing utilities for LLM vision support.
+
+This module provides functions to handle images in various formats:
+- Image URLs
+- Base64-encoded images
+- Local file paths
+"""
+
+import os
+import base64
+import mimetypes
+from typing import Union, Optional, Dict, Any
+from urllib.parse import urlparse
+import logging
+
+logger = logging.getLogger(__name__)
+
+
+class ImageContent:
+    """Represents image content for LLM messages."""
+
+    def __init__(
+        self,
+        source: str,
+        mime_type: Optional[str] = None,
+        detail: Optional[str] = None,
+    ):
+        """
+        Initialize image content.
+
+        Args:
+            source: Image source - can be URL, base64 data URI, or file path
+            mime_type: MIME type (e.g., 'image/jpeg', 'image/png'). Auto-detected if not provided.
+            detail: Detail level for OpenAI API ('low', 'high', 'auto'). Defaults to 'auto'.
+        """
+        self.source = source
+        self.mime_type = mime_type or self._detect_mime_type(source)
+        self.detail = detail or "auto"
+
+    def _detect_mime_type(self, source: str) -> str:
+        """Detect MIME type from source."""
+        # Check if it's a data URI
+        if source.startswith("data:"):
+            header = source.split(",")[0]
+            mime_type = header.split(":")[1].split(";")[0]
+            return mime_type
+
+        # Check if it's a URL
+        if source.startswith(("http://", "https://")):
+            parsed = urlparse(source)
+            mime_type, _ = mimetypes.guess_type(parsed.path)
+            if mime_type and mime_type.startswith("image/"):
+                return mime_type
+
+        # Check if it's a file path
+        if os.path.exists(source):
+            mime_type, _ = mimetypes.guess_type(source)
+            if mime_type and mime_type.startswith("image/"):
+                return mime_type
+
+        # Default to jpeg if cannot detect
+        logger.warning(f"Could not detect MIME type for {source}, defaulting to image/jpeg")
+        return "image/jpeg"
+
+    def is_url(self) -> bool:
+        """Check if source is a URL."""
+        return self.source.startswith(("http://", "https://"))
+
+    def is_base64(self) -> bool:
+        """Check if source is a base64 data URI."""
+        return self.source.startswith("data:")
+
+    def is_file_path(self) -> bool:
+        """Check if source is a local file path."""
+        return os.path.exists(self.source) and not self.is_url() and not self.is_base64()
+
+    def get_base64_data(self) -> str:
+        """
+        Get base64-encoded image data.
+
+        Returns:
+            Base64 string without data URI prefix
+        """
+        if self.is_base64():
+            # Extract base64 data from data URI
+            return self.source.split(",", 1)[1]
+        elif self.is_file_path():
+            # Read file and encode to base64
+            with open(self.source, "rb") as f:
+                return base64.b64encode(f.read()).decode("utf-8")
+        else:
+            raise ValueError(f"Cannot get base64 data from URL: {self.source}. Use URL directly or download first.")
+
+    def get_url(self) -> str:
+        """
+        Get image URL.
+
+        Returns:
+            URL string
+        """
+        if self.is_url():
+            return self.source
+        else:
+            raise ValueError(f"Source is not a URL: {self.source}")
+
+
+def parse_image_source(source: Union[str, Dict[str, Any]]) -> ImageContent:
+    """
+    Parse image source into ImageContent object.
+
+    Args:
+        source: Can be:
+            - String URL (http://... or https://...)
+            - String base64 data URI (data:image/...;base64,...)
+            - String file path
+            - Dict with 'url', 'data', or 'path' key
+
+    Returns:
+        ImageContent object
+    """
+    if isinstance(source, dict):
+        # Handle dict format
+        if "url" in source:
+            return ImageContent(
+                source=source["url"],
+                mime_type=source.get("mime_type"),
+                detail=source.get("detail"),
+            )
+        elif "data" in source:
+            # Base64 data
+            mime_type = source.get("mime_type", "image/jpeg")
+            data = source["data"]
+            if not data.startswith("data:"):
+                data = f"data:{mime_type};base64,{data}"
+            return ImageContent(
+                source=data,
+                mime_type=mime_type,
+                detail=source.get("detail"),
+            )
+        elif "path" in source:
+            return ImageContent(
+                source=source["path"],
+                mime_type=source.get("mime_type"),
+                detail=source.get("detail"),
+            )
+        else:
+            raise ValueError(f"Invalid image dict format: {source}")
+    elif isinstance(source, str):
+        return ImageContent(source=source)
+    else:
+        raise TypeError(f"Image source must be str or dict, got {type(source)}")
+
+
+def validate_image_source(source: str) -> bool:
+    """
+    Validate that image source is accessible.
+
+    Args:
+        source: Image source (URL, base64, or file path)
+
+    Returns:
+        True if source is valid and accessible
+    """
+    try:
+        img = ImageContent(source)
+        if img.is_file_path():
+            return os.path.exists(source) and os.path.isfile(source)
+        elif img.is_url():
+            # URL validation - just check format, not accessibility
+            parsed = urlparse(source)
+            return bool(parsed.scheme and parsed.netloc)
+        elif img.is_base64():
+            # Base64 validation - check format
+            parts = source.split(",", 1)
+            return len(parts) == 2 and parts[0].startswith("data:image/")
+        return False
+    except Exception:
+        return False

aiecs/main.py

@@ -142,7 +142,7 @@ async def lifespan(app: FastAPI):
 app = FastAPI(
     title="AIECS - AI Execute Services",
     description="Middleware service for AI-powered task execution and tool orchestration",
-    version="1.7.17",
+    version="1.8.4",
     lifespan=lifespan,
 )
 
@@ -164,7 +164,7 @@ socket_app = socketio.ASGIApp(sio, other_asgi_app=app)
 @app.get("/health")
 async def health_check():
     """Health check endpoint"""
-    return {"status": "healthy", "service": "aiecs", "version": "1.7.17"}
+    return {"status": "healthy", "service": "aiecs", "version": "1.8.4"}
 
 
 # Metrics health check endpoint

aiecs/tools/task_tools/scraper_tool.py

@@ -100,7 +100,7 @@ class ScraperTool(BaseTool):
     # Configuration schema
     class Config(BaseSettings):
         """Configuration for the scraper tool
-        
+
         Automatically reads from environment variables with SCRAPER_TOOL_ prefix.
         Example: SCRAPER_TOOL_USER_AGENT -> user_agent
         """
@@ -126,6 +126,10 @@ class ScraperTool(BaseTool):
             default=False,
             description="Whether Playwright is available (auto-detected)",
         )
+        use_stealth: bool = Field(
+            default=False,
+            description="Whether to use stealth mode with Playwright to avoid bot detection",
+        )
 
     # Schema definitions
     class Get_httpxSchema(BaseModel):
@@ -508,6 +512,7 @@ class ScraperTool(BaseTool):
         headers: Optional[Dict[str, str]] = None,
         output_format: Optional[OutputFormat] = None,
         output_path: Optional[str] = None,
+        use_stealth: Optional[bool] = None,
     ) -> Dict[str, Any]:
         """
         Render a web page using a headless browser (Playwright).
@@ -523,6 +528,7 @@ class ScraperTool(BaseTool):
             headers (Optional[Dict[str, str]]): Custom headers.
             output_format (Optional[OutputFormat]): Output format.
             output_path (Optional[str]): Path to save output.
+            use_stealth (Optional[bool]): Whether to use stealth mode. If None, uses config value.
 
         Returns:
             Dict[str, Any]: Rendered page content {'html': str, 'title': str, 'url': str, 'screenshot': Optional[str]}.
@@ -541,6 +547,7 @@ class ScraperTool(BaseTool):
                     scroll_to_bottom,
                     screenshot,
                     screenshot_path,
+                    use_stealth if use_stealth is not None else self.config.use_stealth,
                 )
             else:
                 raise RenderingError(f"Unsupported rendering engine: {engine}. Only PLAYWRIGHT is supported.")
@@ -559,8 +566,22 @@ class ScraperTool(BaseTool):
         scroll_to_bottom: bool,
         screenshot: bool,
         screenshot_path: Optional[str],
+        use_stealth: bool = False,
     ) -> Dict[str, Any]:
-        """Render a web page using Playwright with async API."""
+        """Render a web page using Playwright with async API.
+
+        Args:
+            url (str): URL to render.
+            wait_time (int): Time to wait for JS execution.
+            wait_selector (Optional[str]): CSS selector to wait for.
+            scroll_to_bottom (bool): Whether to scroll to the bottom of the page.
+            screenshot (bool): Whether to take a screenshot.
+            screenshot_path (Optional[str]): Path to save the screenshot.
+            use_stealth (bool): Whether to use stealth mode to avoid bot detection.
+
+        Returns:
+            Dict[str, Any]: Rendered page content.
+        """
         from playwright.async_api import async_playwright
 
         async with async_playwright() as p:
@@ -569,6 +590,22 @@ class ScraperTool(BaseTool):
                 user_agent=self.config.user_agent,
                 viewport={"width": 1280, "height": 800},
             )
+
+            # Apply stealth mode if enabled
+            if use_stealth:
+                try:
+                    from playwright_stealth import stealth_async
+                    await stealth_async(page)
+                    self.logger.info("Stealth mode enabled for Playwright")
+                except ImportError:
+                    self.logger.warning(
+                        "playwright-stealth is not installed. "
+                        "Install it with 'pip install playwright-stealth' to use stealth mode. "
+                        "Continuing without stealth mode."
+                    )
+                except Exception as e:
+                    self.logger.warning(f"Failed to apply stealth mode: {str(e)}. Continuing without stealth mode.")
+
             try:
                 await page.goto(url)
                 if wait_selector:

{aiecs-1.7.17.dist-info → aiecs-1.8.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aiecs
-Version: 1.7.17
+Version: 1.8.4
 Summary: AI Execute Services - A middleware framework for AI-powered task execution and tool orchestration
 Author-email: AIECS Team <iretbl@gmail.com>
 License-Expression: MIT
@@ -48,7 +48,7 @@ Requires-Dist: langgraph<0.6.0,>=0.5.3
 Requires-Dist: weasel==0.4.1
 Requires-Dist: spacy<4.0.0,>=3.8.7
 Requires-Dist: rake-nltk<2.0.0,>=1.0.6
-Requires-Dist: numpy<3.0.0,>=2.2.6
+Requires-Dist: numpy<3.0.0,>=2.4.1
 Requires-Dist: pandas<3.0.0,>=2.2.3
 Requires-Dist: scipy<2.0.0,>=1.15.3
 Requires-Dist: scikit-learn<2.0.0,>=1.5.0
@@ -105,6 +105,8 @@ Requires-Dist: sphinx-rtd-theme<3.0.0,>=2.0.0; extra == "docs"
 Requires-Dist: sphinx-autodoc-typehints<3.0.0,>=2.0.0; extra == "docs"
 Requires-Dist: myst-parser<3.0.0,>=2.0.0; extra == "docs"
 Requires-Dist: sphinx-copybutton<1.0.0,>=0.5.0; extra == "docs"
+Provides-Extra: scraper
+Requires-Dist: playwright-stealth<2.0.0,>=1.0.6; extra == "scraper"
 Dynamic: license-file
 
 # AIECS - AI Execute Services

{aiecs-1.7.17.dist-info → aiecs-1.8.4.dist-info}/RECORD

@@ -1,7 +1,7 @@
-aiecs/__init__.py,sha256=E2PYbWAzU7vTEUbmirpTecpqae3VBiyuZsyNM2KQ3h0,1837
+aiecs/__init__.py,sha256=ds9O4SZM1WtfWi6P9v356CyH94U05goAkzlv6XezMGQ,1836
 aiecs/__main__.py,sha256=SUsWL1jOdR3zv6yOi1dAdNH4wvzSVg07Vhlb6I9-bQY,1048
 aiecs/aiecs_client.py,sha256=CjSeiPZ9X0u6xkJcpVRXmCbIm0Wqyx3ejl7o7CaTzUI,18039
-aiecs/main.py,sha256=zYHFgadRkqvbzGBwargGVKHIxWDNm5EkMv3REMGiY6s,10722
+aiecs/main.py,sha256=H7VzC04IaH7P-ucBJ8I8yq5afFptk-q4pvM5WOBCAUA,10720
 aiecs/application/__init__.py,sha256=NkmrUH1DqxJ3vaVC8QwscNdlWqHfC7ZagL4k3nZ_qz4,192
 aiecs/application/executors/__init__.py,sha256=WIl7L9HBsEhNfbNtJdvBvFUJXzESvNZVaiAA6tdtJcs,191
 aiecs/application/executors/operation_executor.py,sha256=WXPLnSYesTrkyVMd5HbOKG705k4eJiEV8200-ZSL0L8,14798
@@ -18,7 +18,7 @@ aiecs/application/knowledge_graph/builder/structured_pipeline.py,sha256=domjvcxK
 aiecs/application/knowledge_graph/builder/text_chunker.py,sha256=jvs4fxPocL_mobLPQqtqsk0Waub11EqUb1PIsLAbxZk,9567
 aiecs/application/knowledge_graph/extractors/__init__.py,sha256=FtCvr-R7CTDcEV4SqtUARoJ5OnULLhw26Ad4NRq8Cmg,705
 aiecs/application/knowledge_graph/extractors/base.py,sha256=XQisuU3UKteHqskqeV0uE_edz7-P03fgJyXDc1YqX1U,3336
-aiecs/application/knowledge_graph/extractors/llm_entity_extractor.py,sha256=0hvZr1ozuf6_ld40OBo4CsDCGlc9Un0ejWIIv90IPrA,15263
+aiecs/application/knowledge_graph/extractors/llm_entity_extractor.py,sha256=dEV3xrCZ_r5PazT3wR4APaoybcyu1jDBuAkl3rQvO44,15400
 aiecs/application/knowledge_graph/extractors/llm_relation_extractor.py,sha256=4OPvAjy_qj0NaVIA6c50cazu7ILOs_uBXXfcxJHOeM4,11484
 aiecs/application/knowledge_graph/extractors/ner_entity_extractor.py,sha256=2yiGGK3tzjOD-ncMI_5_psKtJyLwpUQ-yuED8q3JZn0,7806
 aiecs/application/knowledge_graph/fusion/__init__.py,sha256=xQ30M8uhOx8-RV8eJ_Mzs2WhNYdu0piYmlncq_MluZ4,2217
@@ -57,7 +57,7 @@ aiecs/application/knowledge_graph/reasoning/logic_parser/error_handler.py,sha256
 aiecs/application/knowledge_graph/reasoning/logic_parser/parser.py,sha256=-WzYFryZTF_BB_P8NRBZztl_KRtyNtd6Hxz8JIm-Sto,12810
 aiecs/application/knowledge_graph/reasoning/logic_parser/query_context.py,sha256=xM9wk_h16TNCffWaqLE8K1LqewBtoTW709KAW3ZoRSw,6429
 aiecs/application/knowledge_graph/retrieval/__init__.py,sha256=pgbycGTCTo4rJQ2dWJrSENlVcf9y3kXpEIazqoJC83k,664
-aiecs/application/knowledge_graph/retrieval/query_intent_classifier.py,sha256=D0XK-oLYrvzv3-dzdD_NPkVm9IPUdJ9bvJKK8SctXvw,6808
+aiecs/application/knowledge_graph/retrieval/query_intent_classifier.py,sha256=T5bCIM_ngLti29L6qsWIq9ClZhevvegoA8Zt7Uyyqr0,7003
 aiecs/application/knowledge_graph/retrieval/retrieval_strategies.py,sha256=ya0HbnToPImGvgQyo8gZW_E9V8WX0J1cme8iJW68QZk,18626
 aiecs/application/knowledge_graph/retrieval/strategy_types.py,sha256=HI7yhC1bTD76TtQodk0cQpNO5285IxRkdD_K0p7BlHU,706
 aiecs/application/knowledge_graph/search/__init__.py,sha256=3-c89qUNQq9qcRofVPQanOnKO7G1PEAemJPm98ZRGx4,1471
@@ -76,7 +76,7 @@ aiecs/common/__init__.py,sha256=6XzlzbA5JU8sFIAEF9-MZTGCbksTqCickXqEITT6cpI,116
 aiecs/common/knowledge_graph/__init__.py,sha256=RBvTWuB_PzolXDYBAdqJrFYpQV34VGW0v21t4Bja8Uo,294
 aiecs/common/knowledge_graph/runnable.py,sha256=BLsV9HHfO4lT3_LkFQbf_rUT_iXloZi4D-ztwFqVNuY,15233
 aiecs/config/__init__.py,sha256=aQk0xVquxBZmLTol8wvF4Jv8Yl9G6qyMvA1RL_JE99k,974
-aiecs/config/config.py,sha256=jI5d4xLbU-7NoUcQIydpB9CCKUFyXElJt_OENaHGy_8,33657
+aiecs/config/config.py,sha256=FzBVG7ZZ7Nq6shbEEL8Hf9XzNbgr7axl9cZkUi_7GZk,33895
 aiecs/config/graph_config.py,sha256=9-Xrgd1kswfoIep5nzKmVhEz2vPENqtm_l9nZkXLXL0,3993
 aiecs/config/tool_config.py,sha256=iuMBlHlNWoXzcXxVaGuU1BOruh0yQbAZtPTrAqkNPkQ,16301
 aiecs/core/__init__.py,sha256=WnY-iEE0BpdRg26vVSCILvERzcXg6kajS4IiO2-NovI,1471
@@ -90,10 +90,10 @@ aiecs/domain/agent/__init__.py,sha256=yMDE7r_z8EHGmteWc4E9JoNBVRgeR72VNU7p3c5Obl
 aiecs/domain/agent/base_agent.py,sha256=r6jn8Ux9FswRAYXSx8IrsB_SigeCC5VebPLCb7OmJMk,148078
 aiecs/domain/agent/exceptions.py,sha256=axBRJebHP_JpMfjDstOGRxRXsvPXpmZ78Tccv5TxUs0,2951
 aiecs/domain/agent/graph_aware_mixin.py,sha256=1LScf_JuAU67JtuUgoL7DRCQ6WNJA66-U7AXdgEms1Q,18665
-aiecs/domain/agent/hybrid_agent.py,sha256=EmuAqUZvlPiquMhHiAEsG0N9ZEi3qqhNXGj5rVlfDD4,72468
-aiecs/domain/agent/knowledge_aware_agent.py,sha256=xkCY12RFK1cNwrRdFGIOKkX6BuwBFO0jIjRRCCsn-ew,74013
+aiecs/domain/agent/hybrid_agent.py,sha256=CAIR6CO9orQmRfjJdxMAEdlaSh0WQoGbr23tlBcP4zg,76325
+aiecs/domain/agent/knowledge_aware_agent.py,sha256=YuIz1nhZUYwH5yGQq0c71d_LFgNNsYMxiVR0g9g2JLA,74096
 aiecs/domain/agent/lifecycle.py,sha256=Mqi0YJYBsTfsD-NC0EZOA1Di889qrnRPzQAehxZO32M,8719
-aiecs/domain/agent/llm_agent.py,sha256=Aj6MvoiKTC8Qxfm6JtCruz77onLa5qUah98SituU8XU,24592
+aiecs/domain/agent/llm_agent.py,sha256=B0RFbchi8QgJHX-VcypOtCLLqyD2DRFPamljB4L9nKY,24658
 aiecs/domain/agent/models.py,sha256=c7cgW5Oydw86zcfT39CctByWTuZk2FpvWLFjpWjd9pw,36751
 aiecs/domain/agent/observability.py,sha256=BjCzX0f7GJkusEYsYrVZKFXuIoRO9kH3wgVgHb-W5T0,13806
 aiecs/domain/agent/persistence.py,sha256=Qfd8LWR9am4vueJp5eAjjBKuPxlbGsOScSQkUbIwt84,14399
@@ -195,24 +195,26 @@ aiecs/infrastructure/persistence/database_manager.py,sha256=Oe8Sl-itZBs7bGKcM_50
 aiecs/infrastructure/persistence/file_storage.py,sha256=4cZ8AbPMdajfJHUL8ZnuVuLRm7gW74HNQl1fUyfJ90A,26838
 aiecs/infrastructure/persistence/redis_client.py,sha256=oL2C2wmDJC5lFpTEfPle7a1-lvP-3TBxPTIyrskpTlk,7569
 aiecs/llm/__init__.py,sha256=vLn52v1LQgz75iZy6CvTb_vq5rMYbpZFZMFPKxJV-1k,2183
-aiecs/llm/client_factory.py,sha256=in7ZyKxHHdz1jqD8jA0TOeZoT9VRE0M8NC4j97JFTGA,20031
+aiecs/llm/client_factory.py,sha256=gij-1cXXVRRhZZ7X3RRQK5Wj5rD3sNxCDiJiulbwUjU,20389
 aiecs/llm/client_resolver.py,sha256=rRyHYajOk6YpsTRJJW6Y2FwWwpJLe0b77ncaJXX2fwU,5075
-aiecs/llm/protocols.py,sha256=8Qj7ryOGQ07_j5Xd-UHsIU9wiBU1BxLE-tdzf_bj__4,4516
+aiecs/llm/protocols.py,sha256=PVS-MkS_bmm2FvGXk-NFMqNVbEVPOwNonvSEim3A6N0,5684
 aiecs/llm/callbacks/__init__.py,sha256=u02K5Tvlu-87NXxYzXuxFHuhHAF4OPIje_IvPIF93Lw,191
-aiecs/llm/callbacks/custom_callbacks.py,sha256=g87NK2Zpgvpd_-6PLRFG_fTgIYqGucWL_xEnuU3Kq0g,9904
+aiecs/llm/callbacks/custom_callbacks.py,sha256=RFonkZSpgEDgCZ4GhFCLVa7MGBfTddwMGnmmcid-otc,10164
 aiecs/llm/clients/__init__.py,sha256=GaUkYc0mnKrsBceGrjDZ3K6LZUVxGxHqxjB9zSxWRq8,822
-aiecs/llm/clients/base_client.py,sha256=8L3C9dK3-cHqVCLGISBZIA89j36HM_2G5mhpmvTskbY,11144
+aiecs/llm/clients/base_client.py,sha256=X_wILA3bxftatMQ2FBAzT922-9SwaHRfBpJvCGwi-ig,13103
 aiecs/llm/clients/google_function_calling_mixin.py,sha256=od9-kgnhKtqJc_b-M0Xi2VGAlu8QwGR5MyXt0XpoxdM,16636
-aiecs/llm/clients/googleai_client.py,sha256=c5tPbKQS8JVE687CYP_izStf4x0upgyyBT6eNmXOqcQ,12039
-aiecs/llm/clients/openai_client.py,sha256=sgrYM7KGfCKNOe-wtz3fwVhG27VqYCvnz2hQggt12oM,5582
-aiecs/llm/clients/openai_compatible_mixin.py,sha256=uJfycFcDF8Zlv5x2xAVVB0n6mUND4IcJ1pEInaxHB1s,14463
-aiecs/llm/clients/vertex_client.py,sha256=z-3bfsS9yyZwKyyC5159PmzWMlYMscSHx7nKD8Pq1Bk,54527
-aiecs/llm/clients/xai_client.py,sha256=mJW8hV12FcJtI8nhU34NV-by5o4Xhzv-Ua3Go8ET1kQ,7172
+aiecs/llm/clients/googleai_client.py,sha256=-DM2V8RaoXLoAG7hH0j56LnCvWrhI3pRv56VaQXKb3Y,17107
+aiecs/llm/clients/openai_client.py,sha256=LacvKQlxEcoN7TWuRvBNTz4mM2JhVBdz8lk9ZNB3LL4,6328
+aiecs/llm/clients/openai_compatible_mixin.py,sha256=51tvJQCi-GgDJNN-V_1iTe-N1xFqmd0A5kR1w-udcJc,16224
+aiecs/llm/clients/openrouter_client.py,sha256=bN4aaicZHYv7UHoT4L7_7HhZcNf854DAbaSp2A67-Gg,10357
+aiecs/llm/clients/vertex_client.py,sha256=9yRDvrR9KIt5_K0u9xk-ZwrxUNDmzpePcvEwf5__yNs,58147
+aiecs/llm/clients/xai_client.py,sha256=e76ZuwnLZ4t1zjGtnnyTAm_8lE2VJyaqG1Pgh6uK74E,9162
 aiecs/llm/config/__init__.py,sha256=LCPZXrV4-zUMh6IS32WaUBMT43pSF8dqbhqH3xBcwJU,1107
 aiecs/llm/config/config_loader.py,sha256=Jhd6y4FyMQO73Mwv45Qq--pmPh8XRAzbVxi1xqAgWF8,8653
 aiecs/llm/config/config_validator.py,sha256=6pXxn7O8wSdoWf3zJdmCbufqR-ojWlDKaYrkly55D9Y,7235
 aiecs/llm/config/model_config.py,sha256=ZlUmjlhS_U_BdRe3Y3Zk5M1029ctXHBSwdYqF07H_z8,5687
 aiecs/llm/utils/__init__.py,sha256=zKlDyNjvJsv5URW0B1g4C9cimuB7jmKkcfxkLsTAOVY,239
+aiecs/llm/utils/image_utils.py,sha256=yBuc1vH6YS4DIb7R3zL7ofUItgJzeOJw5S_CC8v70-Y,5744
 aiecs/llm/utils/validate_config.py,sha256=lfi30kPSWoFqDfZvbZTjQfBWMvupBpDh_CzHfDKU3Sw,2959
 aiecs/scripts/__init__.py,sha256=cVxQ5iqym520eDQSpV7B6hWolndCLMOVdvhC_D280PE,66
 aiecs/scripts/aid/VERSION_MANAGEMENT.md,sha256=e0ZL0-ou9R6TW1U4QXNDNfiXVjK6m6SDub9KuJzu98Y,3162
@@ -315,7 +317,7 @@ aiecs/tools/task_tools/office_tool.py,sha256=0Nw5ppP9sXnnk65yVt9BQYy3Nil8Td33N6u
 aiecs/tools/task_tools/pandas_tool.py,sha256=5MHoVz24p178xBZPhIo_dsiej4645jmZvEiy_i0e1mo,41832
 aiecs/tools/task_tools/report_tool.py,sha256=8vIoFLfQvmOjUhFoht2tyZ5Wq7DqsPfXvx0lzORnxs0,34934
 aiecs/tools/task_tools/research_tool.py,sha256=comD38XNHMwrQyGYuP5KWVeobF4inN2o3JCPsox6ixE,19198
-aiecs/tools/task_tools/scraper_tool.py,sha256=Z_yY7b3bNYe_BEUPVy9d9DlagdhMv9bleC762bFK2L8,29538
+aiecs/tools/task_tools/scraper_tool.py,sha256=LXEp7IOBaiyfsrUyLzk8MZpK3yXKqssmsxGI7AVQgAk,31281
 aiecs/tools/task_tools/stats_tool.py,sha256=f_PrPgOOiJXpW-aA9_hXhyhpW7D2-QkPjnYF0Duh7tg,33563
 aiecs/tools/tool_executor/__init__.py,sha256=sR2ss7Ep7OKSu0d0566rd14DDkH3tkYmbMLxpEs6kO8,783
 aiecs/tools/tool_executor/tool_executor.py,sha256=WrQMwiiVi-GM8o41zIcT8hUZzvcOXdAhOenBPe998sw,30387
@@ -329,9 +331,9 @@ aiecs/utils/prompt_loader.py,sha256=iNBNeUSnvbSE1SrllOlBllDdQXtfzq5dO5rjkcFEsSw,
 aiecs/utils/token_usage_repository.py,sha256=gFTu-AHawFmScq35T3ib5pTElZrXezu3ijxRRCxW6vc,10497
 aiecs/ws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 aiecs/ws/socket_server.py,sha256=4jJBx93DEOKs2JO-gZAH9R_MfMTVtLLTLtyYnRyCVew,1591
-aiecs-1.7.17.dist-info/licenses/LICENSE,sha256=_1YRaIS0eZu1pv6xfz245UkU0i1Va2B841hv3OWRwqg,12494
-aiecs-1.7.17.dist-info/METADATA,sha256=EJfH7jPBLmDasjx0k48dHRWQmtb6iNhwxlPSbFntMXQ,18101
-aiecs-1.7.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aiecs-1.7.17.dist-info/entry_points.txt,sha256=t_mIkFuLDmK-2si0thMfgK0WIBg-Ub94V3MchpWMaAs,899
-aiecs-1.7.17.dist-info/top_level.txt,sha256=22IlUlOqh9Ni3jXlQNMNUqzbW8dcxXPeR_EQ-BJVcV8,6
-aiecs-1.7.17.dist-info/RECORD,,
+aiecs-1.8.4.dist-info/licenses/LICENSE,sha256=_1YRaIS0eZu1pv6xfz245UkU0i1Va2B841hv3OWRwqg,12494
+aiecs-1.8.4.dist-info/METADATA,sha256=kb1vMbolQckKE0Mu2hmpsgjB6DZ4fCauGypdgPsETF0,18192
+aiecs-1.8.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aiecs-1.8.4.dist-info/entry_points.txt,sha256=t_mIkFuLDmK-2si0thMfgK0WIBg-Ub94V3MchpWMaAs,899
+aiecs-1.8.4.dist-info/top_level.txt,sha256=22IlUlOqh9Ni3jXlQNMNUqzbW8dcxXPeR_EQ-BJVcV8,6
+aiecs-1.8.4.dist-info/RECORD,,