PyPI - langchain-agentx-python - Versions diffs - 0.8.4__tar.gz → 0.8.5__tar.gz - Mend

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain-agentx-python
-Version: 0.8.4
+Version: 0.8.5
 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__ = "0.8.4"
+__version__ = "0.8.5"
 from .loop import (  # noqa: F401
     create_loop_agent,

@@ -227,34 +227,52 @@ def determine_should_end(
     返回 (should_end, terminal_reason)。
     terminal_reason 是对外唯一终态标签（CC 对齐枚举），should_end=False 时为 None。
     """
+    # [位置1] 入口日志：记录 determine_should_end 的输入状态
+    # 只调用一次 extract_finish_reason，避免重复打印 "unrecognized finish_reason" 警告
+    finish_reason = extract_finish_reason(response)
+    _logger.warning(
+        "[DETERMINE_ENTRY] finish_reason=%s | max_steps=%s | max_turns=%s | "
+        "step=%s | turn_count=%s | has_response=%s",
+        finish_reason, max_steps, max_turns,
+        state.get("step", 0),
+        int(state.get("turn_count", 0) or 0),
+        response is not None,
+    )
     step = state.get("step", 0)
     turn_count = int(state.get("turn_count", 0) or 0)
+    # 辅助函数：记录返回决策并返回值
+    def _log_and_return(should_end: bool, terminal_reason: str | None, fr: str | None) -> tuple[bool, str | None]:
+        _logger.warning(
+            "[EXIT_DECISION] should_end=%s | terminal_reason=%s | finish_reason=%s | "
+            "step=%s | max_steps=%s | max_turns=%s",
+            should_end, terminal_reason, fr, step, max_steps, max_turns,
+        )
+        return should_end, terminal_reason
     # max_turns 作为工具轮次上限（优先于 finish_reason 判定）
     if max_turns is not None and turn_count >= max_turns:
-        return True, TERMINAL_REASON_MAX_TURNS
+        return _log_and_return(True, TERMINAL_REASON_MAX_TURNS, finish_reason)
     meta_tr = metadata_override_terminal_reason(response)
     if meta_tr:
         if max_steps is not None and step >= max_steps:
-            return True, TERMINAL_REASON_MAX_STEPS
-        return True, meta_tr
-    finish_reason = extract_finish_reason(response)
+            return _log_and_return(True, TERMINAL_REASON_MAX_STEPS, finish_reason)
+        return _log_and_return(True, meta_tr, finish_reason)
     # 需要继续执行的 finish_reason，除非达到 max_steps
     if finish_reason in CONTINUE_FINISH_REASONS:
         if max_steps is not None and step >= max_steps:
-            return True, TERMINAL_REASON_MAX_STEPS
-        return False, None
+            return _log_and_return(True, TERMINAL_REASON_MAX_STEPS, finish_reason)
+        return _log_and_return(False, None, finish_reason)
     # 明确的"结束"类 finish_reason → 直接映射 terminal_reason
     if finish_reason == "stop":
-        return True, TERMINAL_REASON_COMPLETED
+        return _log_and_return(True, TERMINAL_REASON_COMPLETED, finish_reason)
     elif finish_reason == "length":
-        return True, TERMINAL_REASON_MAX_TOKENS
+        return _log_and_return(True, TERMINAL_REASON_MAX_TOKENS, finish_reason)
     elif finish_reason == "content-filter":
-        return True, TERMINAL_REASON_CONTENT_FILTER
+        return _log_and_return(True, TERMINAL_REASON_CONTENT_FILTER, finish_reason)
     # 没有 finish_reason 时，使用 tool_calls 兜底逻辑
     if finish_reason is None:
@@ -265,13 +283,13 @@ def determine_should_end(
             and len(response.tool_calls) > 0  # type: ignore[arg-type]
         )
         if not has_tool_calls:
-            return True, TERMINAL_REASON_COMPLETED
+            return _log_and_return(True, TERMINAL_REASON_COMPLETED, finish_reason)
         if max_steps is not None and step >= max_steps:
-            return True, TERMINAL_REASON_MAX_STEPS
-        return False, None
+            return _log_and_return(True, TERMINAL_REASON_MAX_STEPS, finish_reason)
+        return _log_and_return(False, None, finish_reason)
     # 其他未知 finish_reason：一律视为结束
-    return True, TERMINAL_REASON_ERROR
+    return _log_and_return(True, TERMINAL_REASON_ERROR, finish_reason)
 def create_initial_state(

@@ -236,18 +236,15 @@ class LoopControllerEdge:
         if withheld_result is not None:
             return withheld_result
         # [位置2] 静默决策点日志：记录 loop_controller 的关键决策状态
-        _log = logging.getLogger(__name__)
+        _log = logging.getLogger("loop_controller")
         _log.warning(
             "[LOOP_CTRL] should_end=%s | terminal_reason=%s | step=%s | "
-            "finish_reason=%s | messages=%s | has_tool_calls=%s",
+            "finish_reason=%s | messages=%s",
             state.get("should_end"),
             state.get("terminal_reason"),
             state.get("step"),
             state.get("finish_reason"),
             len(state.get("messages", [])),
-            bool(state.get("messages") and
-                 any(getattr(m, "tool_calls", None) for m in state.get("messages", [])
-                     if hasattr(m, "tool_calls"))),
         )
         if bool(state.get("should_end")):
             return self._handle_terminal(state)

@@ -576,11 +576,10 @@ class ModelNode(Runnable):
         finish_reason = extract_finish_reason(last_ai_message)
         # [位置3] 决策结果日志：记录 determine_should_end 的关键输出
         logger.warning(
-            "[MODEL_DECISION] should_end=%s | terminal_reason=%s | finish_reason=%s | "
-            "last_ai_content=%s | step=%s",
+            "[MODEL_OUT] should_end=%s | terminal_reason=%s | finish_reason=%s | "
+            "last_ai_content=%s...",
             should_end, terminal_reason, finish_reason,
             str(getattr(last_ai_message, 'content', ''))[:200] if last_ai_message else 'None',
-            state.get("step", 0),
         )
         self._log_stop_if_needed(
             should_end=should_end,

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

langchain-agentx-python 0.8.4__tar.gz → 0.8.5__tar.gz

langchain-agentx-python 0.8.4tar.gz → 0.8.5tar.gz