PyPI - langchain-agentx-python - Versions diffs - 1.1.5__tar.gz → 1.1.6__tar.gz - Mend

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain-agentx-python
-Version: 1.1.5
+Version: 1.1.6
 Summary: LangChain/LangGraph-based agent utilities for CodeBaseX.
 Author-email: GoodMood2008 <GoodMood2008@users.noreply.github.com>
 License:                                  Apache License

@@ -11,7 +11,7 @@ from langchain_agentx import create_loop_agent
 ```
 """
-__version__ = "1.1.5"
+__version__ = "1.1.6"
 from .loop import (  # noqa: F401
     create_loop_agent,

@@ -1046,6 +1046,7 @@ class LoopGraphBuilder:
             model = ToolCallDegradationCorrector(
                 llm=model,
                 allowed_tool_names=allowed_tool_names,
+                agent_home_segment=self._config.workspace.agent_home_segment,
             )
         self._default_tools = default_tools
         self._model = model

@@ -22,6 +22,8 @@ import json
 import logging
 import re
 import uuid
+from datetime import datetime
+from pathlib import Path
 from typing import Any, Dict, List, Optional, Sequence, Set
 from langchain.agents.structured_output import OutputToolBinding
@@ -29,6 +31,11 @@ from langchain_core.messages import AIMessage
 logger = logging.getLogger(__name__)
+# 延迟导入 resolve_config_home_dir 以避免循环依赖
+def _get_resolve_config_home_dir():
+    from langchain_agentx.workspace import resolve_config_home_dir
+    return resolve_config_home_dir
 # <tool_call>...</tool_call> 标签格式
 _TOOL_CALL_TAG_RE = re.compile(r"<tool_call>(.*?)</tool_call>", re.DOTALL)
@@ -112,9 +119,11 @@ class ToolCallDegradationCorrector:
         self,
         llm: Any,
         allowed_tool_names: Set[str],
+        agent_home_segment: str = ".langchain_agentx",
     ) -> None:
         self._llm = llm
         self._allowed_tool_names = allowed_tool_names
+        self._agent_home_segment = agent_home_segment
     # ----------------------------
     # 属性透传（例如 llm.streaming）
@@ -160,6 +169,7 @@ class ToolCallDegradationCorrector:
         return ToolCallDegradationCorrector(
             llm=bound,
             allowed_tool_names=self._allowed_tool_names | new_names,
+            agent_home_segment=self._agent_home_segment,
         )
     def bind(self, **kwargs: Any) -> "ToolCallDegradationCorrector":
@@ -257,6 +267,16 @@ class ToolCallDegradationCorrector:
         # 支持多种退化格式，从文本中尽力解析 tool_calls
         parsed_tool_calls = self._parse_text_tool_calls(content)
         if not parsed_tool_calls:
+            # 检测可疑的退化文本（即使未能解析）
+            if self._has_suspicious_degradation_markers(content):
+                logger.warning(
+                    "content 包含疑似退化工具调用标记，但未能解析为 tool_calls | "
+                    "content 前 200 字符=%s | "
+                    "allowed_tools=%s",
+                    content[:200],
+                    sorted(self._allowed_tool_names),
+                )
+                self._record_degradation_failure(content)
             return resp
         # 清理所有退化格式残留文本
@@ -479,6 +499,66 @@ class ToolCallDegradationCorrector:
             **kwargs,
         )
+    def _has_suspicious_degradation_markers(self, content: str) -> bool:
+        """检测 content 是否包含疑似退化标记但未能解析。"""
+        # 检查是否包含退化格式的标记
+        suspicious_patterns = [
+            "✀",  # Unicode 开始标记
+            "CALL_TOOL:",
+            "TOOL_CALL:",
+            "```json",  # JSON 代码块（可能包含退化格式）
+            '{"name":',  # 可能的工具调用 JSON 开始
+        ]
+        content_lower = content.lower()
+        for pattern in suspicious_patterns:
+            if pattern in content or pattern.lower() in content_lower:
+                return True
+        return False
+    def _record_degradation_failure(self, content: str) -> None:
+        """记录退化失败到文件系统。"""
+        try:
+            resolve_config_home_dir = _get_resolve_config_home_dir()
+            config_home = resolve_config_home_dir(self._agent_home_segment)
+            degradations_dir = config_home / "tool_degrations"
+            degradations_dir.mkdir(parents=True, exist_ok=True)
+            # 生成文件名：uuid_time(YYYYMMDDHHMMSS).md
+            timestamp = datetime.now().strftime("%Y%m%d%H%M%S")
+            file_id = uuid.uuid4().hex
+            filename = f"{file_id}_{timestamp}.md"
+            file_path = degradations_dir / filename
+            # 写入记录
+            record_content = f"""# Tool Degradation Failure
+**Timestamp:** {datetime.now().isoformat()}
+**Agent Home Segment:** {self._agent_home_segment}
+**Allowed Tools:** {sorted(self._allowed_tool_names)}
+## Degraded Content
+```
+{content}
+```
+## Notes
+This degradation was detected but could not be parsed into valid tool_calls.
+The content contained suspicious degradation markers but failed JSON parsing
+or referenced tools not in the allowed list.
+"""
+            file_path.write_text(record_content, encoding="utf-8")
+            logger.info(
+                "退化失败已记录到文件 | path=%s",
+                file_path,
+            )
+        except Exception as e:
+            logger.warning(
+                "记录退化失败时出错 | error=%s",
+                e,
+            )
 def _build_allowed_tool_names_for_degradation_correction(
     *,

@@ -172,6 +172,8 @@ def _git_output(args: list[str], cwd: Path) -> str | None:
             cwd=cwd,
             capture_output=True,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             timeout=30,
             check=False,
         )
@@ -179,7 +181,10 @@ def _git_output(args: list[str], cwd: Path) -> str | None:
         return None
     if completed.returncode != 0:
         return None
-    return completed.stdout.strip() or None
+    stdout = completed.stdout
+    if stdout is None:
+        return None
+    return stdout.strip() or None
 __all__ = [

@@ -4,7 +4,7 @@
  [project]
  name = "langchain-agentx-python"
- version = "1.1.5"
+ version = "1.1.6"
  description = "LangChain/LangGraph-based agent utilities for CodeBaseX."
  readme = "README.md"
  requires-python = ">=3.11"

langchain-agentx-python 1.1.5__tar.gz → 1.1.6__tar.gz

langchain-agentx-python 1.1.5tar.gz → 1.1.6tar.gz