xgae 0.1.7__py3-none-any.whl → 0.1.9__py3-none-any.whl

xgae/utils/setup_env.py

@@ -1,22 +1,17 @@
 import logging
 import os
 
+from dotenv import load_dotenv
 from langfuse import Langfuse
 
-def setup_logging() -> None:
-    import colorlog
-    from dotenv import load_dotenv
-    load_dotenv()
+from xgae.utils import to_bool
 
-    env_log_level = os.getenv("LOG_LEVEL", "INFO")
-    env_log_file = os.getenv("LOG_FILE", "log/xga.log")
-    log_level = getattr(logging, env_log_level.upper(), logging.INFO)
+load_dotenv()
 
-    log_dir = os.path.dirname(env_log_file)
-    if log_dir and not os.path.exists(log_dir):
-        os.makedirs(log_dir, exist_ok=True)
-    else:
-        os.remove(env_log_file)
+def setup_logging(log_file: str=None, log_level: str="INFO") :
+    import colorlog
+
+    logging_level = getattr(logging, log_level.upper(), logging.INFO)
 
     logger = logging.getLogger()
     for handler in logger.handlers[:]:
@@ -35,46 +30,54 @@ def setup_logging() -> None:
         datefmt='%Y-%m-%d %H:%M:%S'
     )
 
-    file_formatter = logging.Formatter(
-        '%(asctime)s -%(levelname)-8s  %(message)s',
-        datefmt='%Y-%m-%d %H:%M:%S'
-    )
-
     console_handler = logging.StreamHandler()
     console_handler.setFormatter(console_formatter)
+    logger.addHandler(console_handler)
 
-    file_handler = logging.FileHandler(env_log_file, encoding='utf-8')
-    file_handler.setFormatter(file_formatter)
+    if log_file:
+        log_dir = os.path.dirname(log_file)
+        if log_dir and not os.path.exists(log_dir):
+            os.makedirs(log_dir, exist_ok=True)
+        else:
+            os.remove(log_file)
 
-    logger.addHandler(console_handler)
-    logger.addHandler(file_handler)
+        file_formatter = logging.Formatter(
+            '%(asctime)s -%(levelname)-8s  %(message)s',
+            datefmt='%Y-%m-%d %H:%M:%S'
+        )
 
-    logger.setLevel(log_level)
+        file_handler = logging.FileHandler(log_file, encoding='utf-8')
+        file_handler.setFormatter(file_formatter)
+        logger.addHandler(file_handler)
 
-    logging.info(f"Logger is initialized, log_level={env_log_level}, log_file={env_log_file}")
+    logger.setLevel(logging_level)
 
+    logging.info(f"📡 XGAE_LOGGING is initialized, log_level={log_level}, log_file={log_file}")
+
+def setup_env_logging():
+    log_enable = to_bool(os.getenv("LOG_ENABLE", True))
+    log_level = os.getenv("LOG_LEVEL", "INFO")
+    log_file = os.getenv("LOG_FILE", "log/xga.log")
+    if log_enable :
+        setup_logging(log_file, log_level)
 
 def setup_langfuse() -> Langfuse:
-    _langfuse = None
     env_public_key = os.getenv("LANGFUSE_PUBLIC_KEY")
     env_secret_key = os.getenv("LANGFUSE_SECRET_KEY")
     env_host = os.getenv("LANGFUSE_HOST", "https://cloud.langfuse.com")
     if env_public_key and env_secret_key:
-        _langfuse = Langfuse(tracing_enabled=True,
+        _langfuse = Langfuse(enabled=True,
                             public_key=env_public_key,
                             secret_key=env_secret_key,
                             host=env_host)
 
-        logging.info("Langfuse initialized Successfully by Key !")
+        logging.info("📡 XGAE_LANGFUSE initialized Successfully by Key !")
     else:
-        _langfuse = Langfuse(tracing_enabled=False)
-        logging.warning("Not set key, Langfuse is disabled!")
+        _langfuse = Langfuse(enabled=False)
+        logging.warning("📡 XGAE_LANGFUSE Not set key, Langfuse is disabled!")
 
     return _langfuse
 
-
 if __name__ == "__main__":
-        from xgae.utils import langfuse
-
-        trace_id = langfuse.create_trace_id()
-        logging.warning(f"trace_id={trace_id}")
+    langfuse = setup_langfuse()
+    logging.warning(f"langfuse is enable={langfuse.enabled}")

xgae/utils/xml_tool_parser.py

@@ -68,16 +68,16 @@ class XMLToolParser:
         # Find function_calls blocks
         function_calls_matches = self.FUNCTION_CALLS_PATTERN.findall(content)
         
-        for fc_content in function_calls_matches:
+        for func_content in function_calls_matches:
             # Find all invoke blocks within this function_calls block
-            invoke_matches = self.INVOKE_PATTERN.findall(fc_content)
+            invoke_matches = self.INVOKE_PATTERN.findall(func_content)
             
             for function_name, invoke_content in invoke_matches:
                 try:
                     tool_call = self._parse_invoke_block(
                         function_name, 
                         invoke_content,
-                        fc_content
+                        func_content
                     )
                     if tool_call:
                         tool_calls.append(tool_call)
@@ -98,17 +98,11 @@ class XMLToolParser:
             "function_name": function_name,
             "raw_parameters": {}
         }
-        
-        # Extract all parameters
+
         param_matches = self.PARAMETER_PATTERN.findall(invoke_content)
-        
         for param_name, param_value in param_matches:
-            # Clean up the parameter value
             param_value = param_value.strip()
-            
-            # Try to parse as JSON if it looks like JSON
             parsed_value = self._parse_parameter_value(param_value)
-            
             parameters[param_name] = parsed_value
             parsing_details["raw_parameters"][param_name] = param_value
         
@@ -161,73 +155,3 @@ class XMLToolParser:
         
         # Return as string
         return value
-    
-    
-    def format_tool_call(self, function_name: str, parameters: Dict[str, Any]) -> str:
-        """
-        Format a tool call in the XML format.
-        
-        Args:
-            function_name: Name of the function to call
-            parameters: Dictionary of parameters
-            
-        Returns:
-            Formatted XML string
-        """
-        lines = ['<function_calls>', '<invoke name="{}">'.format(function_name)]
-        
-        for param_name, param_value in parameters.items():
-            # Convert value to string representation
-            if isinstance(param_value, (dict, list)):
-                value_str = json.dumps(param_value)
-            elif isinstance(param_value, bool):
-                value_str = str(param_value).lower()
-            else:
-                value_str = str(param_value)
-            
-            lines.append('<parameter name="{}">{}</parameter>'.format(
-                param_name, value_str
-            ))
-        
-        lines.extend(['</invoke>', '</function_calls>'])
-        return '\n'.join(lines)
-    
-    def validate_tool_call(self, tool_call: XMLToolCall, expected_params: Optional[Dict[str, type]] = None) -> Tuple[bool, Optional[str]]:
-        """
-        Validate a tool call against expected parameters.
-        
-        Args:
-            tool_call: The XMLToolCall to validate
-            expected_params: Optional dict of parameter names to expected types
-            
-        Returns:
-            Tuple of (is_valid, error_message)
-        """
-        if not tool_call.function_name:
-            return False, "Function name is required"
-        
-        if expected_params:
-            for param_name, expected_type in expected_params.items():
-                if param_name not in tool_call.parameters:
-                    return False, f"Missing required parameter: {param_name}"
-                
-                param_value = tool_call.parameters[param_name]
-                if not isinstance(param_value, expected_type):
-                    return False, f"Parameter {param_name} should be of type {expected_type.__name__}"
-        
-        return True, None
-
-
-# Convenience function for quick parsing
-def parse_xml_tool_calls(content: str) -> List[XMLToolCall]:
-    """
-    Parse XML tool calls from content.
-    
-    Args:
-        content: The text content potentially containing XML tool calls
-        
-    Returns:
-        List of parsed XMLToolCall objects
-    """
-    parser = XMLToolParser()
-    return parser.parse_content(content) 

xgae-0.1.9.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: xgae
+Version: 0.1.9
+Summary: Extreme General Agent Engine
+Requires-Python: >=3.13
+Requires-Dist: colorlog==6.9.0
+Requires-Dist: langchain-mcp-adapters==0.1.9
+Requires-Dist: langfuse==2.60.9
+Requires-Dist: langgraph==0.6.5
+Requires-Dist: litellm==1.74.15
+Requires-Dist: mcp==1.13.0

xgae-0.1.9.dist-info/RECORD

@@ -0,0 +1,20 @@
+xgae/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+xgae/engine/engine_base.py,sha256=ioywuTpDMHEmyVcd6BInoU-vR70PhQStE2MVRWoEiJg,1768
+xgae/engine/mcp_tool_box.py,sha256=ZSCBSXRWhISwyZ1uEIbt3esjesM46g-ktv6CxvyPVDU,10030
+xgae/engine/prompt_builder.py,sha256=X9bS7YIms6LYplCpNHeUmi74xFP5MwFXmXNqOt1Xz-Q,4356
+xgae/engine/task_engine.py,sha256=BLy32wJUbBFGkjAPfHcbSpCUPQm2uZAmLHtZVqvXwx0,18026
+xgae/engine/task_langfuse.py,sha256=-WMnlMcBGfDuJpV0ZYKnVzlO0HizGOfFVGyzVkP6Rag,2260
+xgae/engine/responser/non_stream_responser.py,sha256=80ZFcitjXpQJANxbYpQ0LlhVzIxmURNJi9Fbo953Uak,6349
+xgae/engine/responser/responser_base.py,sha256=8PcsvQHP68FEhu6v3dT9hDCc_rLKs38i4txWLcJD4ck,29851
+xgae/engine/responser/stream_responser.py,sha256=oPGtrT1nedGMjiBAwPzUlu6Z_rPWeVSODC1xQ6D8cTY,52055
+xgae/tools/without_general_tools_app.py,sha256=FGMV6njcOKwwfitc0j_nUov0RC-eWlhO1IP8_KHz1tQ,3788
+xgae/utils/__init__.py,sha256=tMSYguPrubusr7IyKZn6iPYE6qbN7sOsEVDeJPRdPa8,351
+xgae/utils/json_helpers.py,sha256=6BkqiyEF3jV3Irb4Z6-wGY2_FNaLlxE1WKlMJHHT6E0,4645
+xgae/utils/llm_client.py,sha256=nOhPlllUj4mASdj2dU5HkSmDqYZ8ZMpDa7AKQwUWJnQ,13600
+xgae/utils/misc.py,sha256=M8lMXYp1pHiY6Ee8ZTUG88GpOAsE5fbYoRO_hcBFUCE,953
+xgae/utils/setup_env.py,sha256=XD6WmGNyMFDKVzNU_ufYtqJNd2Otq4hzLs9YZ2aSz6g,2613
+xgae/utils/xml_tool_parser.py,sha256=I9xAZC_ElwBY19PNUq-WLXe9FSIJMeAv2Xs-VlajI7Y,4782
+xgae-0.1.9.dist-info/METADATA,sha256=q4_B-_Kt2hswi0kGX9B_H3uI_7C7SWiJOo6HnzoMF8g,309
+xgae-0.1.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+xgae-0.1.9.dist-info/entry_points.txt,sha256=bYzQ-1iabCduosArMzq1hktJrCjp8jq4_E8Sg8-gEic,137
+xgae-0.1.9.dist-info/RECORD,,

{xgae-0.1.7.dist-info → xgae-0.1.9.dist-info}/entry_points.txt

@@ -1,2 +1,3 @@
 [console_scripts]
+custom_fault_tools = examples.tools.custom_fault_tools_app:main
 xgae-tools = xgae.tools.without_general_tools_app:main

xgae-0.1.7.dist-info/METADATA

@@ -1,11 +0,0 @@
-Metadata-Version: 2.4
-Name: xgae
-Version: 0.1.7
-Summary: Extreme General Agent Engine
-Requires-Python: >=3.13
-Requires-Dist: colorlog>=6.9.0
-Requires-Dist: langchain-mcp-adapters>=0.1.4
-Requires-Dist: langfuse>=2.60.5
-Requires-Dist: langgraph>=0.3.21
-Requires-Dist: litellm>=1.74.8
-Requires-Dist: mcp>=1.12.1

xgae-0.1.7.dist-info/RECORD

@@ -1,19 +0,0 @@
-xgae/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-xgae/engine/engine_base.py,sha256=ySERuLy1YWsf-3s0NFKcyTnXQ4g69wR-cQhtnG0OFmU,1747
-xgae/engine/mcp_tool_box.py,sha256=iBfCLWXvbkKWd1JnSgBLA1T1KdSdpEZCrROkC_cXp7g,10132
-xgae/engine/prompt_builder.py,sha256=8_rNRJksn2QLV_K98S0x0qNeHcmxhU0kB_53IZJTGOU,4366
-xgae/engine/task_engine.py,sha256=mjS7oDlJH-1wBohzz1FfFng2nE_K0xL-QaNZDuQss3A,17986
-xgae/engine/responser/non_stream_responser.py,sha256=kOP9kDEhHtrDKMyVnBPWEx0yO-xTvVacfXGJJqFtONU,6395
-xgae/engine/responser/responser_base.py,sha256=rn3-LkS_alZUwdIxPfDGC_zAH_CncSQ2I-euYA6a45w,30524
-xgae/engine/responser/stream_responser.py,sha256=5KzCHApiPplZ-zN_sbbEbSvj2rtvKWBshJKe_-x7RDI,52927
-xgae/tools/without_general_tools_app.py,sha256=QknIF4OW9xvOad8gx-F_sCBwQYXqMalnNFvYvZXkQ_I,3789
-xgae/utils/__init__.py,sha256=jChvD-p_p5gsrCZUVYPUGJs4CS9gIdNFcSOpkRpcM4Y,317
-xgae/utils/json_helpers.py,sha256=K1ja6GJCatrAheW9bEWAYSQbDI42__boBCZgtsv1gtk,4865
-xgae/utils/llm_client.py,sha256=RvID4bL9yZon096uvuoFZPlqAPiHhET9-9qYp6sUERc,12605
-xgae/utils/misc.py,sha256=EK94YesZp8AmRUqWfN-CjTxyEHPWdIIWpFNO17dzm9g,915
-xgae/utils/setup_env.py,sha256=EVk0KG92Sk6ejBxXZbDDr_dc3KM8GFMofMA4HvXqSfM,2409
-xgae/utils/xml_tool_parser.py,sha256=EJ6BjpD4CSdmS_LqViUJ6P8H9GY2R1e4Dh8rLCR6nSE,7474
-xgae-0.1.7.dist-info/METADATA,sha256=AbGuJUOv4574WF9a2nQNaTxuOKEN2K_U7RaACci2PME,309
-xgae-0.1.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-xgae-0.1.7.dist-info/entry_points.txt,sha256=rhQ9Vksnu8nA78lPTjiJxOCZ5k6sH6s5YNMR68y7C-A,73
-xgae-0.1.7.dist-info/RECORD,,