langchain-agentx-python 0.9.5__tar.gz → 0.9.6__tar.gz

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/PKG-INFO

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

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/__init__.py

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

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/loop/exit/reason_codes.py

@@ -15,6 +15,7 @@ TERMINAL_REASON_STOP_HOOK_PREVENTED = "stop_hook_prevented"
 TERMINAL_REASON_ERROR = "error"
 TERMINAL_REASON_API_ERROR = "api_error"
 TERMINAL_REASON_GRAPH_RUNTIME_ERROR = "graph_runtime_error"
+TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED = "runtime_budget_exhausted"
 TERMINAL_REASON_PROMPT_TOO_LONG = "prompt_too_long"
 TERMINAL_REASON_MAX_OUTPUT_TOKENS = "max_output_tokens"
 TERMINAL_REASON_INVARIANT_VIOLATION = "invariant_violation"
@@ -50,6 +51,7 @@ ERROR_TERMINAL_REASONS = frozenset(
         TERMINAL_REASON_ERROR,
         TERMINAL_REASON_API_ERROR,
         TERMINAL_REASON_GRAPH_RUNTIME_ERROR,
+        TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED,
         TERMINAL_REASON_PROMPT_TOO_LONG,
         TERMINAL_REASON_MAX_OUTPUT_TOKENS,
         TERMINAL_REASON_INVARIANT_VIOLATION,
@@ -69,6 +71,7 @@ __all__ = [
     "TERMINAL_REASON_ERROR",
     "TERMINAL_REASON_API_ERROR",
     "TERMINAL_REASON_GRAPH_RUNTIME_ERROR",
+    "TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED",
     "TERMINAL_REASON_PROMPT_TOO_LONG",
     "TERMINAL_REASON_MAX_OUTPUT_TOKENS",
     "TERMINAL_REASON_INVARIANT_VIOLATION",

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/loop/exit/terminal.py

@@ -24,6 +24,7 @@ from .reason_codes import (
     TERMINAL_REASON_STOP_HOOK_PREVENTED,
     TERMINAL_REASON_API_ERROR,
     TERMINAL_REASON_GRAPH_RUNTIME_ERROR,
+    TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED,
     TERMINAL_REASON_INVARIANT_VIOLATION,
     TERMINAL_REASON_MAX_OUTPUT_TOKENS,
     TERMINAL_REASON_MAX_TOKENS,
@@ -53,6 +54,7 @@ _ERROR_TERMINAL_REASONS = frozenset(
         TERMINAL_REASON_CONTENT_FILTER,
         TERMINAL_REASON_API_ERROR,
         TERMINAL_REASON_GRAPH_RUNTIME_ERROR,
+        TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED,
         TERMINAL_REASON_HOOK_STOPPED,
         TERMINAL_REASON_ABORTED_STREAMING,
         TERMINAL_REASON_ABORTED_TOOLS,

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/loop/stream/graph_driver.py

@@ -16,6 +16,8 @@ from __future__ import annotations
 import logging
 from typing import Any, AsyncIterator
 
+from langgraph.errors import GraphRecursionError
+
 from .result import StreamDriverResult
 from .synthetic_events import (
     build_synthetic_error_visible_event,
@@ -50,6 +52,24 @@ class GraphStreamDriver:
                 self._observe_event(event)
                 yield event
             self.result.graph_completed = True
+        except GraphRecursionError as exc:
+            self.result.final_error = exc
+            logger.exception("GraphStreamDriver recursion limit exceeded: %s", exc)
+            if not self.result.saw_error_visible_surface:
+                self.result.saw_error_visible_surface = True
+                yield build_synthetic_error_visible_event(
+                    message="Runtime budget exhausted (recursion limit reached)",
+                    error_kind="graph_recursion_error",
+                )
+            if not self.result.saw_finish_surface:
+                synthetic_output = dict(self.result.graph_output or {})
+                if "messages" not in synthetic_output:
+                    synthetic_output["messages"] = []
+                self.result.graph_output = synthetic_output
+                self.result.saw_finish_surface = True
+                self.result.saw_root_chain_end = True
+                yield build_synthetic_root_chain_end(graph_output=synthetic_output)
+            raise
         except Exception as exc:
             self.result.final_error = exc
             logger.exception("GraphStreamDriver graph stream failed: %s", exc)

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/loop/stream/loop_driver.py

@@ -16,7 +16,12 @@ from __future__ import annotations
 import logging
 from typing import Any, AsyncIterator
 
-from ..exit.reason_codes import TERMINAL_REASON_GRAPH_RUNTIME_ERROR
+from langgraph.errors import GraphRecursionError
+
+from ..exit.reason_codes import (
+    TERMINAL_REASON_GRAPH_RUNTIME_ERROR,
+    TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED,
+)
 from ..exit.terminal import apply_terminal_reason_projection, build_loop_terminal
 from .result import StreamDriverResult
 from .synthetic_events import (
@@ -60,6 +65,36 @@ class LoopStreamDriver:
                 self._observe_event(event)
                 yield event
             self.result.graph_completed = True
+        except GraphRecursionError as exc:
+            self.result.final_error = exc
+            self._log_catch_error(exc)
+            for repair in self._orphan_tool_result_repairs():
+                yield repair
+            if not self.result.saw_error_visible_surface:
+                self.result.saw_error_visible_surface = True
+                yield build_synthetic_error_visible_event(
+                    message="Runtime budget exhausted (recursion limit reached)",
+                    error_kind="graph_recursion_error",
+                )
+            if not self.result.saw_finish_surface:
+                terminal = build_loop_terminal(
+                    reason=TERMINAL_REASON_RUNTIME_BUDGET_EXHAUSTED,
+                    error_kind="graph_recursion_error",
+                    step=(self.result.last_loop_snapshot or {}).get("step"),
+                    turn_count=(self.result.last_loop_snapshot or {}).get("turn_count"),
+                    provider_finish_reason=(self.result.last_loop_snapshot or {}).get("finish_reason"),
+                    errors=[str(exc)],
+                    metadata={
+                        "langgraph_error_type": "GraphRecursionError",
+                    },
+                )
+                self.result.terminal = terminal
+                synthetic_output = self._build_synthetic_graph_output(terminal)
+                self.result.graph_output = synthetic_output
+                self.result.saw_finish_surface = True
+                yield build_synthetic_root_chain_end(graph_output=synthetic_output)
+            self._log_catch_error_diagnostic(exc)
+            raise
         except Exception as exc:
             self.result.final_error = exc
             # CC catch 协议 §5.3.3：先记录日志 / 观测，再补 stream surface，最后 re-raise

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/observability/events/langchain_agentx_event_adapter.py

@@ -820,6 +820,35 @@ class LangGraphToLangchainAgentEventAdapter:
 
         # 图结束：如果仍有打开的 step，先补齐 finish-step，再发 finish
         if name == self.state.graph_name:
+            # ===== 兜底：关闭可能未完成的 model 输出状态 =====
+            # 原因：LangGraph 不保证 100% 发出 on_chat_model_end（见 LangChain callback 体系限制）
+            # 可能不发出的场景：
+            #   1. 流异常中断（网络断、超时、进程被杀）
+            #   2. LLM 节点内部用 sync invoke，吞掉细粒度事件
+            #   3. RunnableConfig 未透传，子 runnable 事件丢失
+            #   4. 自定义节点直接写 state，不走标准 LLM 回调
+            #   5. 大参数工具调用阻塞（见 github.com/langchain-ai/langchain/issues/24021）
+            # 而 on_chain_end(LangGraph) 是可靠信号，在此处兜底可确保事件成对。
+            #
+            # 注意：正常流程下 on_chat_model_end 已发出，is_text_active/is_reasoning_active
+            #       已为 false，此代码不会重复发事件。
+            if self.enable_reasoning_events and self.state.is_reasoning_active:
+                yield self._event(
+                    event_type=LangchainAgentEventType.REASONING_END,
+                    data={},
+                    step_index=self.state.step_index,
+                )
+                self.state.is_reasoning_active = False
+
+            if self.state.is_text_active:
+                yield self._event(
+                    event_type=LangchainAgentEventType.TEXT_END,
+                    data={},
+                    step_index=self.state.step_index,
+                )
+                self.state.is_text_active = False
+            # ===== 兜底结束 =====
+
             if self.enable_step_events and self.state.is_step_started and self.state.step_index > 0:
                 yield self._event(
                     event_type=LangchainAgentEventType.FINISH_STEP,

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx/tools/bash/backend.py

@@ -1254,15 +1254,18 @@ class BashBackend:
         shell_exe = self._posix_shell_executable(env)
         spawn_env = self._spawn_env_with_shell(env, shell_exe)
         effective_cwd, reset_prefix = _prepare_spawn_cwd(cwd, fallback=fallback_cwd)
-        if effective_cwd is None:
-            msg = reset_prefix.strip() or "Shell cwd invalid and no valid fallback"
-            return ExecuteResult(
-                stdout="",
+        # effective_cwd is None 有两种情况：
+        # 1. reset_prefix 为空：用户未指定 cwd，使用当前进程工作目录（有效）
+        # 2. reset_prefix 非空：cwd 无效且无有效 fallback（错误）
+        if effective_cwd is None and reset_prefix:
+            yield BashStreamEvent(kind="chunk", chunk=reset_prefix)
+            yield BashStreamEvent(
+                kind="final",
                 exit_code=126,
                 interrupted=False,
-                stderr=msg + "\n",
-                cwd_warning=msg,
+                cwd_after=None,
             )
+            return
         if reset_prefix:
             yield BashStreamEvent(kind="chunk", chunk=reset_prefix)
         _cf = self._win32_creationflags()

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/langchain_agentx_python.egg-info/PKG-INFO

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

{langchain-agentx-python-0.9.5 → langchain-agentx-python-0.9.6}/pyproject.toml

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