langchain-agentx-python 1.9.6__tar.gz → 1.9.7__tar.gz

{langchain-agentx-python-1.9.6/langchain_agentx_python.egg-info → langchain-agentx-python-1.9.7}/PKG-INFO

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

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/langchain_agentx/workflow/base.py

@@ -330,8 +330,7 @@ class BaseWorkflow(ABC):
     ) -> dict:
         """合并 derived scoped structure + caller override，并对 Structured Workflow 做 fail-fast 校验。
 
-        内部委托 ``collect_effective_structure_contract()``；保留此方法供
-        ``astream_langchain_events()`` 与既有测试调用。
+        内部委托 ``collect_effective_structure_contract()``；供 ``run_observe()`` 等入口调用。
         """
         from .structure_collector import collect_effective_structure_contract
 
@@ -616,7 +615,7 @@ class BaseWorkflow(ABC):
         ui_catalog: WorkflowUiCatalog | None = None,
         display_resolver: WorkflowDisplayResolver | None = None,
     ) -> dict[str, Any]:
-        """构建 workflow-aware LangGraph adapter 配置（run_observe / astream_langchain_events 共用）。"""
+        """构建 workflow-aware LangGraph adapter 配置（run_observe 共用）。"""
         config = dict(adapter_config or {})
         workflow_adapter_config = config.get("workflow_adapter")
         if not isinstance(workflow_adapter_config, dict):
@@ -654,10 +653,26 @@ class BaseWorkflow(ABC):
         run_config: RunnableConfig | None = None,
         **kwargs: Any,
     ):
-        """Phase 2 真双轨入口：返回 L0 outcome Task + L1 观测流（F4 producer-consumer）。"""
-        from langchain_agentx.workflow.run_handle import WorkflowRunHandle
+        """Phase 2 真双轨入口：返回 L0 outcome Task + L1 观测流（F4 producer-consumer）。
+
+        消费契约：
+            - L1：``async for event in handle.events``（SSE / 缓冲投影）
+            - L0：``await handle.outcome``（execution authority）
+            - 须**并发或顺序消费 events** 以排空 raw queue；仅 ``await outcome`` 且不读
+              events 会在有界队列上阻塞 L0 drain。
+            - 仅需程序化 L0 结果时用 ``run_with_outcome()``（内部会 drain events）。
+
+        structure fail-fast 在启动 L0 drain 之前执行（``_build_langgraph_adapter_config``）。
+        """
         from langchain_agentx.workflow.run_session import WorkflowRunSession
 
+        self._build_langgraph_adapter_config(
+            adapter_config=adapter_config,
+            workflow_structure=workflow_structure,
+            ui_catalog=ui_catalog,
+            display_resolver=display_resolver,
+        )
+
         astream_kwargs = {
             key: value
             for key, value in kwargs.items()
@@ -705,50 +720,6 @@ class BaseWorkflow(ABC):
             pass
         return await handle.outcome
 
-    async def astream_langchain_events(
-        self,
-        initial_state: dict,
-        *,
-        parent_workflow: "BaseWorkflow | None" = None,
-        adapter_config: dict | None = None,
-        workflow_structure: dict | None = None,
-        ui_catalog: WorkflowUiCatalog | None = None,
-        display_resolver: WorkflowDisplayResolver | None = None,
-        run_config: RunnableConfig | None = None,
-        **kwargs,
-    ) -> AsyncIterator[Any]:
-        """流式执行 Workflow，返回统一的 LangchainAgentEvent 公共事件流。
-
-        Phase 2：observe-only 入口，内部委托 ``run_observe()`` 观测轨。
-        L0 authority 请使用 ``run_with_outcome()`` / ``WorkflowRunHandle.outcome``。
-
-        Args:
-            initial_state: 初始状态
-            parent_workflow: 父 Workflow
-            adapter_config: workflow-aware adapter 配置（workflow_adapter 命名空间）
-            workflow_structure: 结构信息（如 total_stages）
-            ui_catalog: 本次调用覆盖的 Workflow UI 目录（缺省时使用实例级 catalog）
-            display_resolver: 本次调用覆盖的 display 解析器（缺省时使用实例级 resolver）
-            run_config: LangGraph 运行配置，透传至 astream_events
-            **kwargs: 传递给 astream_events 的其他参数
-
-        Yields:
-            LangchainAgentEvent: workflow 与 agent 统一的公共事件协议
-        """
-        handle = self.run_observe(
-            initial_state,
-            parent_workflow=parent_workflow,
-            adapter_config=adapter_config,
-            workflow_structure=workflow_structure,
-            ui_catalog=ui_catalog,
-            display_resolver=display_resolver,
-            run_config=run_config,
-            **kwargs,
-        )
-        async for event in handle.events:
-            yield event
-
-
     async def _emit_workflow_end_best_effort(self, ctx: dict) -> None:
         """WORKFLOW_END 降级为 best-effort：失败不阻断 drain / config 恢复。"""
         try:

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/langchain_agentx/workflow/catalog_registry.py

@@ -8,7 +8,7 @@ catalog_registry.py — Workflow UI catalog 注册表
 
 链路位置：
     - Layer 3: workflow 领域 UI 语义层
-    - BaseWorkflow.compile / astream_langchain_events 前收集 → display resolver 按 ctx.workflow_id 路由
+    - BaseWorkflow.compile / run_observe 前收集 → display resolver 按 ctx.workflow_id 路由
 
 当前裁剪范围：
     - 仅静态 catalog 收集与只读 lookup，不负责运行期 display 计算

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/langchain_agentx/workflow/run_handle.py

@@ -29,7 +29,15 @@ if TYPE_CHECKING:
 
 @dataclass
 class WorkflowRunHandle:
-    """真双轨句柄：authority 读 outcome；SSE/缓冲读 events。"""
+    """真双轨句柄：authority 读 outcome；SSE/缓冲读 events。
+
+    消费契约（F4 producer-consumer）：
+        - ``events`` 与 ``outcome`` 由 ``WorkflowRunSession`` 的 L0/L1 双 task 驱动。
+        - 宿主须消费 ``events``（全量 drain 或投影边读边写），否则 L0 可能在有界
+          raw queue 上阻塞，``outcome`` 无法完成。
+        - F6：观测方 early break / aclose 不 cancel L0；仍应 ``await outcome`` 取 authority。
+        - 仅要 L0 结果时用 ``BaseWorkflow.run_with_outcome()``。
+    """
 
     outcome: asyncio.Task[WorkflowRunOutcome]
     events: AsyncIterator[LangchainAgentEvent]

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/langchain_agentx/workflow/run_session.py

@@ -10,6 +10,12 @@ run_session.py — Workflow L0/L1 真双轨编排（Phase 2 F4 producer-consumer
 
 当前裁剪范围：
     不含 stream_ui / new_agent 薄封装；不含内层 LoopStreamDriver 上抛。
+
+消费契约：
+    L0 经有界 ``asyncio.Queue`` 向 L1 喂 raw 事件；调用方必须消费
+    ``WorkflowRunHandle.events``（或 ``run_with_outcome()`` 内部 drain），
+    否则 L0 ``put`` 可能阻塞、``outcome`` 无法完成。structure fail-fast 由
+    ``BaseWorkflow.run_observe()`` 在 ``start()`` 之前完成。
 """
 
 from __future__ import annotations

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/langchain_agentx/workflow/structure_validation.py

@@ -10,7 +10,7 @@ structure_validation.py — Workflow event adapter structure contract 校验
 
 链路位置：
     - Layer 3: workflow 领域层
-    - 由 BaseWorkflow.astream_langchain_events() 在创建 adapter 前调用
+    - 由 BaseWorkflow.run_observe() 在创建 adapter 前调用
 
 当前裁剪范围：
     - 仅显式支持 ChainingWorkflow / ParallelizationWorkflow / RoutingWorkflow

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.9.6 → langchain-agentx-python-1.9.7}/pyproject.toml

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