langchain-agentx-python 1.4.0__tar.gz → 1.4.1__tar.gz

{langchain-agentx-python-1.4.0/langchain_agentx_python.egg-info → langchain-agentx-python-1.4.1}/PKG-INFO

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

{langchain-agentx-python-1.4.0 → langchain-agentx-python-1.4.1}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.4.0 → langchain-agentx-python-1.4.1}/langchain_agentx/workflow/base.py

@@ -18,7 +18,8 @@ base.py — BaseWorkflow 基础设施层
     - 不支持 per-item Hook 事件（Phase 2+）
 
 设计原则（Phase 1）：
-    - graph_factory 注入 WorkflowAgentLoopExecutor（LoopTaskNode / Dag / Batch 共用）
+    - graph_factory 注入 WorkflowAgentLoopExecutor（factory-first：Dag/Batch/AgentNode；
+      invocation-first：LoopTaskNode / Rich Node 可 graph_factory=None，仅 run_invocation）
     - parent_workflow 在运行时注入（run() / as_node() 参数），避免循环依赖
     - as_node() 直接返回完整 state，让 LangGraph reducer 处理合并
     - max_concurrency 仅存储配置值，不实例化 Semaphore（由子类按需创建）
@@ -210,12 +211,7 @@ class BaseWorkflow(ABC):
         return ()
 
     def _get_workflow_loop_executor(self) -> WorkflowAgentLoopExecutor:
-        """返回 workflow loop 执行器（兼容层 seam 的单一入口）。"""
-        if self._graph_factory is None:
-            raise RuntimeError(
-                "Workflow loop executor requires graph_factory; "
-                "this workflow should use build_graph()/as_node() instead."
-            )
+        """返回 workflow loop 执行器（factory-first 与 invocation-first 共用）。"""
         if self._workflow_loop_executor is None:
             self._workflow_loop_executor = WorkflowAgentLoopExecutor(
                 graph_factory=self._graph_factory,
@@ -383,6 +379,12 @@ class BaseWorkflow(ABC):
 
         graph 节点路径请使用 WorkflowNodeAdapter + LoopTaskNode，不要调用本方法。
         """
+        if self._graph_factory is None:
+            raise RuntimeError(
+                "BaseWorkflow._run_loop_task requires graph_factory (factory-first); "
+                "invocation-first nodes must build LoopInvocation and use "
+                "WorkflowAgentLoopExecutor.run_invocation instead."
+            )
         context = WorkflowNodeContext(
             workflow_id=self._workflow_id,
             task_key=task_key,

{langchain-agentx-python-1.4.0 → langchain-agentx-python-1.4.1}/langchain_agentx/workflow/event_adapter/handlers/stage_handler.py

@@ -87,8 +87,7 @@ class StageHandler:
         event_type = event.get("event", "")
         node = event.get("metadata", {}).get("langgraph_node", "")
 
-        # 只处理 stage_* 节点
-        if not node.startswith(self._prefix):
+        if not matches_stage_node(self._config, node, prefix=self._prefix):
             return events
 
         stage_key = node

{langchain-agentx-python-1.4.0 → langchain-agentx-python-1.4.1}/langchain_agentx/workflow/execution.py

@@ -13,6 +13,7 @@ workflow/execution.py — Workflow 到 loop graph 的执行边界 SSOT
     - 不处理 pattern 节点分发
     - 不处理 workflow 外层 GraphStreamDriver
     - 内层 agent loop 经 LoopStreamDriver 统一 closeout（run_invocation / stream_invocation）
+    - factory-first（build_invocation / ainvoke）与 invocation-first（run_invocation）双模型
     - 不接管复杂业务节点 lifecycle（precheck/writeback 等）
 """
 
@@ -192,12 +193,17 @@ class LoopInvocation:
 
 
 class WorkflowAgentLoopExecutor:
-    """Workflow → loop graph 调用边界 owner。"""
+    """Workflow → loop graph 调用边界 owner。
+
+    两种执行模型：
+    - factory-first：graph_factory 非空，经 build_invocation / ainvoke 建图
+    - invocation-first：graph_factory 可为 None，仅 run_invocation / stream_invocation
+    """
 
     def __init__(
         self,
         *,
-        graph_factory: WorkflowGraphFactory,
+        graph_factory: WorkflowGraphFactory | None = None,
         trace_collector: Any | None = None,
         semaphore: asyncio.Semaphore | None = None,
     ) -> None:
@@ -205,6 +211,14 @@ class WorkflowAgentLoopExecutor:
         self._trace_collector = trace_collector
         self._semaphore = semaphore
 
+    def _require_graph_factory(self) -> WorkflowGraphFactory:
+        if self._graph_factory is None:
+            raise RuntimeError(
+                "WorkflowAgentLoopExecutor.build_invocation/ainvoke requires graph_factory; "
+                "invocation-first nodes must build LoopInvocation and call run_invocation instead."
+            )
+        return self._graph_factory
+
     def build_invocation(
         self,
         *,
@@ -212,12 +226,13 @@ class WorkflowAgentLoopExecutor:
         messages: list[Any],
         caller_config: dict[str, Any] | None = None,
     ) -> LoopInvocation:
+        graph_factory = self._require_graph_factory()
         runtime = WorkflowAgentRuntime(
             session_id=WorkflowSessionIdPolicy.build_session_id(context),
             parent_conversation_session_id=context.parent_session_id,
             is_subagent=WorkflowSessionIdPolicy.is_subagent(context),
         )
-        graph = self._graph_factory(runtime)
+        graph = graph_factory(runtime)
         return LoopInvocation.from_context(
             context=context,
             messages=messages,

{langchain-agentx-python-1.4.0 → langchain-agentx-python-1.4.1/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.4.0 → langchain-agentx-python-1.4.1}/pyproject.toml

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