langchain-agentx-python 1.4.2__tar.gz → 1.4.3__tar.gz

{langchain-agentx-python-1.4.2/langchain_agentx_python.egg-info → langchain-agentx-python-1.4.3}/PKG-INFO

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

{langchain-agentx-python-1.4.2 → langchain-agentx-python-1.4.3}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.4.2 → langchain-agentx-python-1.4.3}/langchain_agentx/workflow/event_adapter/handlers/parallel_handler.py

@@ -13,6 +13,10 @@ parallel_handler.py — ParallelizationWorkflow 事件处理器
 当前裁剪范围：
     - 只处理 parallel_* 前缀的节点和 aggregate 节点
     - 不支持动态并发控制（max_concurrency 由 LangGraph 处理）
+
+Phase 1 收敛：
+    - parallel item 事件 payload 必带 item_index / item_key / item_total，与 stage_total 对齐
+    - 失败事件统一使用 PARALLEL_ITEM_FAILED / PARALLEL_AGGREGATE_FAILED，不与 DONE 共用 + error
 """
 
 from typing import Any, Dict, List
@@ -178,16 +182,23 @@ class ParallelHandler:
         )
 
     def _handle_parallel_item(self, event: Dict[str, Any], event_type: str, node: str) -> List[WorkflowEvent]:
-        """处理 parallel_* 并行项事件"""
+        """处理 parallel_* 并行项事件
+
+        Phase 1 收敛：payload top-level 必带 item_index / item_key / item_total，
+        与 stage_total 对齐；item_total 缺失时（无 structure spec）置 0 以保持类型稳定。
+        """
         events: List[WorkflowEvent] = []
 
         # 提取并行项索引（structure 映射优先，旧数字后缀 fallback）
         item_index = resolve_item_index(self._config, node, prefix=self._prefix)
+        item_total_raw = resolve_item_total(self._config)
+        item_total = item_total_raw if isinstance(item_total_raw, int) else 0
 
         if event_type == "on_chain_start":
             data = {
                 "item_index": item_index,
                 "item_key": node,
+                "item_total": item_total,
             }
             self._attach_item_display(data, WorkflowEventType.PARALLEL_ITEM_START, node, item_index)
             events.append(WorkflowEvent(
@@ -202,6 +213,7 @@ class ParallelHandler:
             data = {
                 "item_index": item_index,
                 "item_key": node,
+                "item_total": item_total,
             }
             self._attach_item_display(data, WorkflowEventType.PARALLEL_ITEM_DONE, node, item_index)
             events.append(WorkflowEvent(
@@ -218,6 +230,7 @@ class ParallelHandler:
             data = {
                 "item_index": item_index,
                 "item_key": node,
+                "item_total": item_total,
                 "error": str(error_info),
                 "error_type": type(error_info).__name__ if isinstance(error_info, Exception) else "WorkflowParallelItemError",
             }

{langchain-agentx-python-1.4.2 → langchain-agentx-python-1.4.3}/langchain_agentx/workflow/event_adapter/types.py

@@ -5,6 +5,7 @@ types.py — Workflow 事件适配器类型定义
     - 定义 WorkflowEvent 数据类
     - 定义 WorkflowEventType 枚举
     - 定义 WorkflowAdapterState 状态类
+    - 收敛结构事件 payload 字段命名与 display 必填/可选边界
 
 链路位置：
     - Layer 3: Workflow 事件适配器
@@ -13,6 +14,32 @@ types.py — Workflow 事件适配器类型定义
 当前裁剪范围：
     - 不包含 OrchestratorWorkflow 事件类型（Phase 2+）
     - 不包含 Agent 层事件类型（由 LangchainAgentEvent 处理）
+
+事件契约（Phase 1 收敛）：
+    - root workflow 失败 → WORKFLOW_FAILED（仅在 depth == 0 由 adapter 主路径发出）
+    - 局部失败（stage/item/aggregate/branch）→ 对应 *_FAILED 事件，且必带 error / error_type
+    - done / failed 不复用同一事件类型 + error 字段；done 不携带 error
+    - parallel item 事件 payload 必带 item_index / item_key / item_total（与 stage_total 对齐）
+
+data.display 必填字段（display 存在时）：
+    - version: int            display schema 版本
+    - scope:   str            workflow / stage / item / branch / aggregate / subworkflow
+    - status:  str            running / completed / failed / pending / ...
+
+data.display 可选字段（按 scope 出现）：
+    - title / description     UI 显示主标题与 subtitle（description 仅做 subtitle，不挂正文 preview）
+    - breadcrumb              层级路径数组
+    - progress_current / progress_total / progress_label / progress_indeterminate
+    - workflow_title / workflow_description / parent_title
+    - item_index / item_total / decision_label
+    - metrics_completed / metrics_running / metrics_failed / metrics_total
+    - status_reason / icon
+    - pattern / debug_key     运行期辅助字段，非展示语义
+
+subtitle 边界（与正文 preview 分离）：
+    - display.description ⇒ 容器 subtitle（一行简短摘要）
+    - agent / tool / message 等内容事件 ⇒ 挂在容器下作为 body / preview
+    - SDK 不在结构事件 data 中混入 agent 内容（如 reasoning_content / messages）
 """
 
 from dataclasses import dataclass, field

{langchain-agentx-python-1.4.2 → langchain-agentx-python-1.4.3/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.4.2 → langchain-agentx-python-1.4.3}/pyproject.toml

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