langchain-agentx-python 1.6.5__tar.gz → 1.6.7__tar.gz

{langchain-agentx-python-1.6.5/langchain_agentx_python.egg-info → langchain-agentx-python-1.6.7}/PKG-INFO

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

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7}/langchain_agentx/workflow/event_adapter/adapter.py

@@ -229,6 +229,9 @@ class WorkflowEventAdapter:
 
     def _reconcile_stack_from_event(self, event: Dict[str, Any]) -> List[WorkflowEvent]:
         """编排：推断栈对齐目标 → reconcile → 产出 SUBWORKFLOW_* 事件。"""
+        if self._should_skip_reconcile_during_nested_aggregate(event):
+            return []
+
         events: List[WorkflowEvent] = []
         previous_depth = self._stack.current_depth
         previous_child_id = (
@@ -275,6 +278,32 @@ class WorkflowEventAdapter:
 
         return events
 
+    def _open_nested_aggregate_owner_path(self) -> str | None:
+        """返回仍 open 的 nested parallel-aggregate scope path（Doc31-R2-A）。"""
+        for identity in self._lifecycle_guard.open_identities:
+            if "|scope:" not in identity:
+                continue
+            owner_path, scope_key = identity.rsplit("|scope:", 1)
+            if ">" not in owner_path:
+                continue
+            entry = self._scope_resolver.scope_entry_at(f"{owner_path}>{scope_key}")
+            if entry and entry.get("scope_kind") == "aggregate":
+                return owner_path
+        return None
+
+    def _should_skip_reconcile_during_nested_aggregate(
+        self, event: Dict[str, Any]
+    ) -> bool:
+        """Loop aggregate 内层 agent 空 ns 事件不得抖栈退出 nested scope。"""
+        owner_path = self._open_nested_aggregate_owner_path()
+        if not owner_path:
+            return False
+        previous_depth = self._stack.current_depth
+        if previous_depth <= 0:
+            return False
+        alignment = self._depth_resolver.derive_stack_alignment(event)
+        return alignment.target_depth < previous_depth
+
     def _should_emit_subworkflow_lifecycle(self, scope_path: str) -> bool:
         """仅 scope_origin=nested_workflow 时发 subworkflow-* 结构事件。"""
         from langchain_agentx.workflow.structure_collector import (

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7}/langchain_agentx/workflow/event_adapter/depth_resolver.py

@@ -4,6 +4,7 @@ depth_resolver.py — LangGraph 嵌套深度解析器（纯推断，不改栈）
 职责：
     - 从 LangGraph 事件 metadata 推导栈对齐目标（depth + segment_ids）
     - 禁止改 WorkflowStack；栈变更唯一入口为 WorkflowStack.reconcile_to_depth
+    - 过滤 Agent loop 内部 technical 节点（tools / model），不抬升为 public scope path
 
 链路位置：
     - Layer 3: Workflow 事件适配器
@@ -12,6 +13,7 @@ depth_resolver.py — LangGraph 嵌套深度解析器（纯推断，不改栈）
 当前裁剪范围：
     - 仅支持 LangGraph v2 事件格式（langgraph_checkpoint_ns | 分段）
     - 不支持 configurable.workflow_path（经验证不存在于事件 metadata）
+    - internal loop 节点过滤对齐 Doc31 §08.4.1（不校验 LangGraph synthetic/technical 节点）
 
 契约表与 snapshot 见 test_depth_resolver.py（LangGraph 事件变样时只改本模块 + 测试表）。
 """
@@ -21,6 +23,9 @@ from __future__ import annotations
 from dataclasses import dataclass
 from typing import Any
 
+# Agent loop graph 内部 technical 节点；不得进入 public runtime scope path（Doc31 §08.4.1）
+LANGGRAPH_INTERNAL_LOOP_NODE_NAMES = frozenset({"tools", "model"})
+
 
 @dataclass(frozen=True)
 class StackAlignment:
@@ -51,19 +56,30 @@ class DepthResolver:
 
         与真实 LangGraph 嵌套 compiled 子图对齐：内层 parallel item 事件
         通常没有 node=="" 的子图启动事件，需靠 ns 分段 + node 联合推断。
+        Agent loop 内 tools/model 节点对齐到最近 public scope，不额外 push 栈帧。
         """
         metadata = event.get("metadata", {})
         node = metadata.get("langgraph_node", "")
         ns = metadata.get("langgraph_checkpoint_ns", "")
-        segments = [segment for segment in ns.split("|") if segment]
-        if not segments:
+        segment_ids = self.segment_graph_node_ids(ns)
+        if not segment_ids:
             return 0
+        if node in LANGGRAPH_INTERNAL_LOOP_NODE_NAMES:
+            return len(segment_ids)
         if node == "":
-            return len(segments)
-        return max(0, len(segments) - 1)
+            return len(segment_ids)
+        return max(0, len(segment_ids) - 1)
 
     def segment_graph_node_ids(self, checkpoint_ns: str) -> list[str]:
-        """从 checkpoint_ns 提取各层 graph 节点名（不含 uuid）。"""
+        """从 checkpoint_ns 提取各层 graph 节点名（不含 uuid、不含 internal loop 节点）。"""
+        return [
+            segment_id
+            for segment_id in self._raw_segment_graph_node_ids(checkpoint_ns)
+            if segment_id not in LANGGRAPH_INTERNAL_LOOP_NODE_NAMES
+        ]
+
+    @staticmethod
+    def _raw_segment_graph_node_ids(checkpoint_ns: str) -> list[str]:
         return [
             segment.split(":")[0]
             for segment in checkpoint_ns.split("|")
@@ -73,5 +89,6 @@ class DepthResolver:
 
 __all__ = [
     "DepthResolver",
+    "LANGGRAPH_INTERNAL_LOOP_NODE_NAMES",
     "StackAlignment",
 ]

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7}/langchain_agentx/workflow/event_adapter/handlers/stage_handler.py

@@ -75,6 +75,9 @@ class StageHandler:
         stage_total = resolve_stage_total(scope)
 
         if event_type == "on_chain_start":
+            lifecycle_key = f"{self._stack.build_path()}|{stage_key}"
+            if lifecycle_key in self._state.finished_stage_lifecycle_keys:
+                return events
             self._state.current_stage = stage_index
             data = {
                 "stage_index": stage_index,
@@ -114,6 +117,9 @@ class StageHandler:
                 workflow_path=self._stack.build_path(),
                 workflow_depth=self._stack.current_depth,
             ))
+            self._state.finished_stage_lifecycle_keys.add(
+                f"{self._stack.build_path()}|{stage_key}"
+            )
 
         elif event_type == "on_chain_error":
             error_data = event.get("data", {})

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7}/langchain_agentx/workflow/event_adapter/types.py

@@ -240,6 +240,9 @@ class WorkflowAdapterState:
     # === 事件配对追踪 ===
     pending_starts: Dict[str, bool] = field(default_factory=dict)  # 修复（v2.5）：value 类型为 bool
 
+    # === Stage lifecycle（Doc31-R2-B：禁止 LangGraph unwind 重复 stage-start）===
+    finished_stage_lifecycle_keys: set[str] = field(default_factory=set)
+
     # === 辅助判断 ===
     last_seen_node: str = ""
 

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.6.5 → langchain-agentx-python-1.6.7}/pyproject.toml

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