xgae 0.1.12__tar.gz → 0.1.14__tar.gz

{xgae-0.1.12 → xgae-0.1.14}/.env

@@ -3,17 +3,19 @@ LOG_LEVEL=DEBUG
 LOG_FILE=log/xgae.log
 LOG_ENABLE=True
 
+
 # LANGFUSE
 LANGFUSE_PUBLIC_KEY=
 LANGFUSE_SECRET_KEY=
 LANGFUSE_HOST=https://cloud.langfuse.com
 
+
 # LLM
 LLM_MODEL=openai/qwen3-235b-a22b
 LLM_API_BASE=https://dashscope.aliyuncs.com/compatible-mode/v1
 LLM_API_KEY=
 LLM_MAX_TOKENS=16384
-LLM_TEMPERATURE=0.7
+LLM_TEMPERATURE=0
 LLM_MAX_RETRIES=2
 LLM_STREAM=True
 LLM_ENABLE_THINKING=False

{xgae-0.1.12 → xgae-0.1.14}/.idea/misc.xml

@@ -3,5 +3,5 @@
   <component name="Black">
     <option name="sdkName" value="Python 3.13 (xgae)" />
   </component>
-  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.13 virtualenv at ~/DevProjects/xga/xgae/.venv" project-jdk-type="Python SDK" />
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.13 virtualenv at ~/DevelopSpace/xgae/.venv" project-jdk-type="Python SDK" />
 </project>

xgae-0.1.14/.idea/workspace.xml

@@ -0,0 +1,200 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="0f1352ac-e106-4041-9704-6775ec0c7096" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="FileTemplateManagerImpl">
+    <option name="RECENT_TEMPLATES">
+      <list>
+        <option value="Python Script" />
+      </list>
+    </option>
+  </component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 7
+}</component>
+  <component name="ProjectId" id="31InXSONOzq9VTdmbkoD0F0ho9q" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
+    &quot;Python.__init__.executor&quot;: &quot;Run&quot;,
+    &quot;Python.llm_client.executor&quot;: &quot;Run&quot;,
+    &quot;Python.run_general_tools.executor&quot;: &quot;Run&quot;,
+    &quot;Python.run_xga_engine.executor&quot;: &quot;Run&quot;,
+    &quot;Python.setup_env.executor&quot;: &quot;Run&quot;,
+    &quot;Python.utils.executor&quot;: &quot;Run&quot;,
+    &quot;Python.xga_engine.executor&quot;: &quot;Run&quot;,
+    &quot;Python.xga_mcp_tool_box.executor&quot;: &quot;Run&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;last_opened_file_path&quot;: &quot;/Users/goosezzy/DevelopSpace/xgae&quot;,
+    &quot;node.js.detected.package.eslint&quot;: &quot;true&quot;,
+    &quot;node.js.detected.package.tslint&quot;: &quot;true&quot;,
+    &quot;node.js.selected.package.eslint&quot;: &quot;(autodetect)&quot;,
+    &quot;node.js.selected.package.tslint&quot;: &quot;(autodetect)&quot;,
+    &quot;nodejs_package_manager_path&quot;: &quot;npm&quot;,
+    &quot;settings.editor.selected.configurable&quot;: &quot;preferences.pluginManager&quot;,
+    &quot;vue.rearranger.settings.migration&quot;: &quot;true&quot;
+  }
+}</component>
+  <component name="RecentsManager">
+    <key name="MoveFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$/src/xgae/engine/responser" />
+    </key>
+  </component>
+  <component name="RunManager">
+    <configuration default="true" type="PythonConfigurationType" factoryName="Python">
+      <module name="xgae" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="false" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <EXTENSION ID="net.ashald.envfile">
+        <option name="IS_ENABLED" value="false" />
+        <option name="IS_SUBST" value="false" />
+        <option name="IS_PATH_MACRO_SUPPORTED" value="false" />
+        <option name="IS_IGNORE_MISSING_FILES" value="false" />
+        <option name="IS_ENABLE_EXPERIMENTAL_INTEGRATIONS" value="false" />
+        <ENTRIES>
+          <ENTRY IS_ENABLED="true" PARSER="runconfig" IS_EXECUTABLE="false" />
+        </ENTRIES>
+      </EXTENSION>
+      <option name="SCRIPT_NAME" value="" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="run_xga_engine" type="PythonConfigurationType" factoryName="Python" temporary="true">
+      <module name="xgae" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <EXTENSION ID="net.ashald.envfile">
+        <option name="IS_ENABLED" value="false" />
+        <option name="IS_SUBST" value="false" />
+        <option name="IS_PATH_MACRO_SUPPORTED" value="false" />
+        <option name="IS_IGNORE_MISSING_FILES" value="false" />
+        <option name="IS_ENABLE_EXPERIMENTAL_INTEGRATIONS" value="false" />
+        <ENTRIES>
+          <ENTRY IS_ENABLED="true" PARSER="runconfig" IS_EXECUTABLE="false" />
+        </ENTRIES>
+      </EXTENSION>
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/src/xgae/engine/task_engine.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python.run_xga_engine" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-09060db00ec0-JavaScript-PY-251.26927.90" />
+        <option value="bundled-python-sdk-41e8cd69c857-64d779b69b7a-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-251.26927.90" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="0f1352ac-e106-4041-9704-6775ec0c7096" name="Changes" comment="" />
+      <created>1755220495138</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1755220495138</updated>
+      <workItem from="1755220497295" duration="14755000" />
+      <workItem from="1755239458855" duration="4586000" />
+      <workItem from="1755244406907" duration="6284000" />
+      <workItem from="1755262332599" duration="306000" />
+      <workItem from="1755270285722" duration="12068000" />
+      <workItem from="1755283728206" duration="1511000" />
+      <workItem from="1755286552901" duration="3130000" />
+      <workItem from="1755307767865" duration="337000" />
+      <workItem from="1755308113420" duration="2825000" />
+      <workItem from="1755321931380" duration="8531000" />
+      <workItem from="1755330830188" duration="229000" />
+      <workItem from="1755396985976" duration="6435000" />
+      <workItem from="1755415614018" duration="461000" />
+      <workItem from="1755416476555" duration="256000" />
+      <workItem from="1755419142521" duration="150000" />
+      <workItem from="1755429851003" duration="290000" />
+      <workItem from="1755430331676" duration="21000" />
+      <workItem from="1755529583730" duration="1643000" />
+      <workItem from="1755609955702" duration="37000" />
+      <workItem from="1755612319869" duration="621000" />
+      <workItem from="1755690345086" duration="6847000" />
+      <workItem from="1755781193226" duration="485000" />
+      <workItem from="1755781685826" duration="38000" />
+      <workItem from="1755781735460" duration="170000" />
+      <workItem from="1755817545372" duration="285000" />
+      <workItem from="1755862006389" duration="1051000" />
+      <workItem from="1755863094184" duration="553000" />
+      <workItem from="1755863979826" duration="4236000" />
+      <workItem from="1755875255916" duration="2308000" />
+      <workItem from="1755877576514" duration="2000" />
+      <workItem from="1755878805800" duration="3590000" />
+      <workItem from="1755904284653" duration="7803000" />
+      <workItem from="1755912586948" duration="1553000" />
+      <workItem from="1755915353109" duration="5872000" />
+      <workItem from="1755997335603" duration="7717000" />
+      <workItem from="1756031865610" duration="2215000" />
+      <workItem from="1756297162586" duration="193000" />
+      <workItem from="1756297512397" duration="274000" />
+      <workItem from="1756481503906" duration="343000" />
+      <workItem from="1756482175678" duration="11417000" />
+      <workItem from="1756602064592" duration="9720000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="com.intellij.coverage.CoverageDataManagerImpl">
+    <SUITE FILE_PATH="coverage/xgae$xga_mcp_tool_box.coverage" NAME="xga_mcp_tool_box Coverage Results" MODIFIED="1755864064753" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$llm_client.coverage" NAME="llm_client Coverage Results" MODIFIED="1755247632274" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$setup_env.coverage" NAME="setup_env Coverage Results" MODIFIED="1755876041210" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$run_general_tools.coverage" NAME="run_general_tools Coverage Results" MODIFIED="1756521020235" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$run_xga_engine.coverage" NAME="run_xga_engine Coverage Results" MODIFIED="1756611961256" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$__init__.coverage" NAME="__init__ Coverage Results" MODIFIED="1756483267122" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$xga_engine.coverage" NAME="xga_engine Coverage Results" MODIFIED="1755876180376" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/xgae$utils.coverage" NAME="utils Coverage Results" MODIFIED="1755226923439" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+  </component>
+</project>

{xgae-0.1.12 → xgae-0.1.14}/.idea/xgae.iml

@@ -5,7 +5,7 @@
       <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
       <excludeFolder url="file://$MODULE_DIR$/.venv" />
     </content>
-    <orderEntry type="jdk" jdkName="Python 3.13 virtualenv at ~/DevProjects/xga/xgae/.venv" jdkType="Python SDK" />
+    <orderEntry type="jdk" jdkName="Python 3.13 virtualenv at ~/DevelopSpace/xgae/.venv" jdkType="Python SDK" />
     <orderEntry type="sourceFolder" forTests="false" />
   </component>
 </module>

{xgae-0.1.12 → xgae-0.1.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xgae
-Version: 0.1.12
+Version: 0.1.14
 Summary: Extreme General Agent Engine
 Requires-Python: >=3.13
 Requires-Dist: colorlog==6.9.0

{xgae-0.1.12 → xgae-0.1.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "xgae"
-version = "0.1.12"
+version = "0.1.14"
 description = "Extreme General Agent Engine"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -23,4 +23,4 @@ exclude = ["log/*"]
 [project.scripts]
 xgae = "xgae.cli_app:main"
 xgae-tools = "xgae.tools.without_general_tools_app:main"
-custom_fault_tools = "examples.tools.custom_fault_tools_app:main"
+example-fault-tools = "examples.tools.custom_fault_tools_app:main"

{xgae-0.1.12 → xgae-0.1.14}/src/examples/agent/langgraph/react/react_agent.py

@@ -10,7 +10,7 @@ from langgraph.graph.message import add_messages
 from xgae.engine.engine_base import XGATaskResult, XGAResponseMessage
 from xgae.engine.mcp_tool_box import XGAMcpToolBox
 from xgae.utils.setup_env import setup_langfuse, setup_logging
-from xgae.utils import handle_error
+from xgae.utils import log_trace
 from xgae.utils.misc import read_file
 from xgae.engine.task_engine import XGATaskEngine
 
@@ -183,9 +183,8 @@ class XGAReactAgent:
 
             return result
         except Exception as e:
-            logging.error("### Error ManagerAgent _agent_work for user_input '%s': %s ###", user_input, str(e))
-            handle_error(e)
-            result = XGATaskResult(type="error", content="Never get result, Unexpected Error")
+            log_trace(e, f"XReactAgent generate: user_input={user_input}")
+            result = XGATaskResult(type="error", content=f"React Agent error: {e}")
             return result
 
 

xgae-0.1.14/src/examples/engine/run_general_tools.py

@@ -0,0 +1,16 @@
+import asyncio
+
+from xgae.engine.task_engine import XGATaskEngine
+from xgae.utils.setup_env import setup_logging
+
+
+setup_logging()
+
+async def main() -> None:
+    engine = XGATaskEngine(general_tools=["*"])
+
+    user_input =  "This week's gold price"
+    final_result = await engine.run_task_with_final_answer(task_message={"role": "user", "content": user_input})
+    print("FINAL RESULT:", final_result)
+
+asyncio.run(main())

{xgae-0.1.12 → xgae-0.1.14}/src/examples/engine/run_human_in_loop.py

@@ -11,7 +11,7 @@ setup_logging()
 langfuse = setup_langfuse()
 
 async def main() -> None:
-    # Before Run Exec: uv run custom_fault_tools
+    # Before Run Exec: uv run example-fault-tools
     tool_box = XGAMcpToolBox(custom_mcp_server_file="mcpservers/custom_servers.json")
     system_prompt = read_file("templates/example/fault_user_prompt.txt")
 

{xgae-0.1.12 → xgae-0.1.14}/src/examples/engine/run_user_prompt.py

@@ -9,7 +9,7 @@ from xgae.utils.setup_env import setup_logging
 setup_logging(log_level="ERROR")
 
 async def main() -> None:
-    # Before Run Exec: uv run custom_fault_tools
+    # Before Run Exec: uv run example-fault-tools
     tool_box = XGAMcpToolBox(custom_mcp_server_file="mcpservers/custom_servers.json")
     system_prompt = read_file("templates/example/fault_user_prompt.txt")
 

{xgae-0.1.12 → xgae-0.1.14}/src/examples/tools/custom_fault_tools_app.py

@@ -89,7 +89,8 @@ def main(transport: str, host: str, port: int, alarmtype:int):
     if transport != "stdio":
         from xgae.utils.setup_env import setup_logging
         setup_logging()
-        logging.info("=" * 20 + f"   Custom Fault Tools Sever Started in {transport} mode   " + "=" * 20)
+        logging.info("=" * 10 + f"   Example Fault Tools Sever Started   " + "=" * 10)
+        logging.info(f"=== transport={transport}, host={host}, port={port}, alarmtype={alarmtype}")
 
     global alarm_type
     alarm_type = alarmtype

{xgae-0.1.12 → xgae-0.1.14}/src/xgae/engine/mcp_tool_box.py

@@ -113,15 +113,20 @@ class XGAMcpToolBox(XGAToolBox):
         async with self._mcp_client.session(server_name) as session:
             tools = await load_mcp_tools(session)
             mcp_tool = next((t for t in tools if t.name == tool_name), None)
-
+            is_general_tool = False
             if mcp_tool:
                 tool_args = args or {}
                 if server_name == self.GENERAL_MCP_SERVER_NAME:
                     tool_args = dict({"task_id": task_id}, **tool_args)
+                    is_general_tool = True
 
                 try:
                     tool_result = await mcp_tool.arun(tool_args)
-                    result = XGAToolResult(success=True, output=str(tool_result))
+                    if is_general_tool:
+                        tool_result = json.loads(tool_result)
+                        result = XGAToolResult(success=tool_result['success'], output=str(tool_result['output']))
+                    else:
+                        result = XGAToolResult(success=True, output=str(tool_result))
                 except Exception as e:
                     error = f"Call mcp tool '{tool_name}' error: {str(e)}"
                     logging.error(f"McpToolBox call_tool: {error}")
@@ -195,7 +200,7 @@ if __name__ == "__main__":
     setup_logging()
 
     async def main():
-        ## Before Run Exec: uv run custom_fault_tools
+        ## Before Run Exec: uv run example-fault-tools
         mcp_tool_box = XGAMcpToolBox(custom_mcp_server_file="mcpservers/custom_servers.json")
         #mcp_tool_box = XGAMcpToolBox()
 

{xgae-0.1.12 → xgae-0.1.14}/src/xgae/engine/responser/non_stream_responser.py

@@ -2,7 +2,7 @@ import logging
 
 from typing import List, Dict, Any, AsyncGenerator, override,Optional
 
-from xgae.utils import handle_error
+from xgae.utils import log_trace
 from xgae.utils.json_helpers import format_for_yield
 
 from xgae.engine.responser.responser_base import TaskResponseProcessor, TaskResponserContext, TaskRunContinuousState
@@ -61,8 +61,7 @@ class NonStreamTaskResponser(TaskResponseProcessor):
                     parsing_details = parsed_xml_item['parsing_details']
                     assistant_msg_id = assistant_msg['message_id'] if assistant_msg else None
 
-                    tool_context = self._create_tool_context(tool_call, tool_index, assistant_msg_id, parsing_details)
-                    tool_context.result = tool_result
+                    tool_context = self._create_tool_context(tool_call, tool_index, assistant_msg_id, parsing_details, tool_result)
 
                     tool_start_msg = self._add_tool_start_message(tool_context)
                     yield format_for_yield(tool_start_msg)
@@ -88,11 +87,10 @@ class NonStreamTaskResponser(TaskResponseProcessor):
                 finish_msg = self.add_response_message(type="status", content=finish_content, is_llm_message=False)
                 yield format_for_yield(finish_msg)
         except Exception as e:
-            logging.error(f"NonStreamResp: Process response llm_content: {llm_content}")
-            handle_error(e)
+            trace = log_trace(e, f"NonStreamResp: Process response llm_content:\n {llm_content}")
             self.root_span.event(name="non_stream_process_response_error", level="ERROR",
                                  status_message=f"Process non-streaming response error: {e}",
-                                 metadata={"content": llm_content})
+                                 metadata={"content": llm_content, "trace": trace})
 
             content = {"role": "system", "status_type": "error", "message": f"Process non-streaming response error: {e}"}
             error_msg = self.add_response_message(type="status", content=content, is_llm_message=False)