langchain-agentx-python 1.6.0__tar.gz → 1.6.1__tar.gz

{langchain-agentx-python-1.6.0/langchain_agentx_python.egg-info → langchain-agentx-python-1.6.1}/PKG-INFO

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

{langchain-agentx-python-1.6.0 → langchain-agentx-python-1.6.1}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.6.0 → langchain-agentx-python-1.6.1}/langchain_agentx/workflow/base.py

@@ -73,6 +73,10 @@ from .state import WorkflowState
 logger = logging.getLogger(__name__)
 
 
+class WorkflowStructureDelegationError(ValueError):
+    """Structure delegate 链无效（自引用循环或配置错误）。"""
+
+
 class BaseWorkflow(ABC):
     """基础设施层基类：定义 Workflow 的标准契约和通用能力。
 
@@ -206,9 +210,32 @@ class BaseWorkflow(ABC):
         if nodes:
             validate_loop_session_ids(nodes, workflow_id=self._workflow_id)
 
+    def get_structure_delegate_workflow(self) -> BaseWorkflow | None:
+        """返回承载结构语义的 root workflow；wrapper 覆盖，默认无委托。"""
+        return None
+
+    def _resolve_structure_delegate_workflow(self) -> BaseWorkflow:
+        """解析 structure delegate，含 None / 自引用 / 循环委托保护。"""
+        current = self
+        visited: set[int] = {id(current)}
+        while True:
+            delegate = current.get_structure_delegate_workflow()
+            if delegate is None or delegate is current:
+                return current
+            delegate_id = id(delegate)
+            if delegate_id in visited:
+                raise WorkflowStructureDelegationError(
+                    f"Workflow '{self._workflow_id}' has circular structure delegation"
+                )
+            visited.add(delegate_id)
+            current = delegate
+
     def iter_child_workflows(self) -> Iterable[BaseWorkflow]:
-        """返回直接嵌套的子 workflow（由 pattern 子类覆盖）。"""
-        return ()
+        """返回直接嵌套的子 workflow（wrapper 沿 delegate 解析）。"""
+        source = self._resolve_structure_delegate_workflow()
+        if source is self:
+            return ()
+        return source.iter_child_workflows()
 
     def _get_workflow_loop_executor(self) -> WorkflowAgentLoopExecutor:
         """返回 workflow loop 执行器（factory-first 与 invocation-first 共用）。"""
@@ -258,8 +285,11 @@ class BaseWorkflow(ABC):
         return self.build_graph().compile()
 
     def export_event_adapter_structure(self) -> dict:
-        """导出 event adapter 所需的 workflow_structure（子类 override）。"""
-        return {}
+        """导出 event adapter 所需的 workflow_structure（wrapper 沿 delegate 解析）。"""
+        source = self._resolve_structure_delegate_workflow()
+        if source is self:
+            return {}
+        return source.export_event_adapter_structure()
 
     def _build_effective_event_adapter_structure(
         self,
@@ -602,4 +632,4 @@ class BaseWorkflow(ABC):
             logger.warning(f"Failed to drain pending memory extractions: {e}")
 
 
-__all__ = ["BaseWorkflow"]
+__all__ = ["BaseWorkflow", "WorkflowStructureDelegationError"]

{langchain-agentx-python-1.6.0 → langchain-agentx-python-1.6.1}/langchain_agentx/workflow/catalog_registry.py

@@ -42,7 +42,11 @@ class WorkflowUiCatalogRegistry:
 
 
 def collect_ui_catalog_registry(workflow: BaseWorkflow) -> WorkflowUiCatalogRegistry:
-    """递归收集根 workflow 及嵌套子 workflow 的 catalog。"""
+    """递归收集根 workflow 及嵌套子 workflow 的 catalog。
+
+    wrapper structured workflow 从 ``_resolve_structure_delegate_workflow()``
+    起始遍历，与 ``export_event_adapter_structure()`` 委托视图一致。
+    """
     catalogs: dict[str, WorkflowUiCatalog] = {}
 
     def visit(current: BaseWorkflow) -> None:
@@ -51,7 +55,7 @@ def collect_ui_catalog_registry(workflow: BaseWorkflow) -> WorkflowUiCatalogRegi
         for child in current.iter_child_workflows():
             visit(child)
 
-    visit(workflow)
+    visit(workflow._resolve_structure_delegate_workflow())
     return WorkflowUiCatalogRegistry(catalogs)
 
 

{langchain-agentx-python-1.6.0 → langchain-agentx-python-1.6.1}/langchain_agentx/workflow/structure_validation.py

@@ -11,6 +11,7 @@ structure_validation.py — Workflow event adapter structure contract 校验
 
 当前裁剪范围：
     - 仅显式支持 ChainingWorkflow / ParallelizationWorkflow / RoutingWorkflow
+    - wrapper structured workflow 沿 delegate 校验（与 export 委托一致）
     - Generic Workflow 直接放行；不做 graph 节点扫描或 nested structure merge
 """
 
@@ -31,6 +32,9 @@ class WorkflowEventStructureValidator:
     def validate(self, workflow: BaseWorkflow, structure: dict[str, Any]) -> None:
         """校验 effective structure；Generic Workflow 直接放行。
 
+        wrapper structured workflow 沿 ``_resolve_structure_delegate_workflow()``
+        取 contract source，与 ``export_event_adapter_structure()`` 委托语义一致。
+
         Raises:
             WorkflowEventStructureValidationError: structure 缺失、字段不齐或 key/index 与 spec 不一致
         """
@@ -38,12 +42,14 @@ class WorkflowEventStructureValidator:
         from .patterns.parallelization import ParallelizationWorkflow
         from .patterns.routing import RoutingWorkflow
 
-        if isinstance(workflow, ChainingWorkflow):
-            self._validate_chaining(workflow, structure)
-        elif isinstance(workflow, ParallelizationWorkflow):
-            self._validate_parallelization(workflow, structure)
-        elif isinstance(workflow, RoutingWorkflow):
-            self._validate_routing(workflow, structure)
+        contract_source = workflow._resolve_structure_delegate_workflow()
+
+        if isinstance(contract_source, ChainingWorkflow):
+            self._validate_chaining(contract_source, structure)
+        elif isinstance(contract_source, ParallelizationWorkflow):
+            self._validate_parallelization(contract_source, structure)
+        elif isinstance(contract_source, RoutingWorkflow):
+            self._validate_routing(contract_source, structure)
 
     def _validate_chaining(self, workflow: Any, structure: dict[str, Any]) -> None:
         workflow_id = workflow._workflow_id

{langchain-agentx-python-1.6.0 → langchain-agentx-python-1.6.1/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.6.0 → langchain-agentx-python-1.6.1}/pyproject.toml

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