langchain-agentx-python 1.4.2__py3-none-any.whl → 1.5.4__py3-none-any.whl

langchain_agentx/__init__.py

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

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/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.dist-info → langchain_agentx_python-1.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain-agentx-python
-Version: 1.4.2
+Version: 1.5.4
 Summary: LangChain/LangGraph-based agent utilities for CodeBaseX.
 Author-email: GoodMood2008 <GoodMood2008@users.noreply.github.com>
 License: Apache License
@@ -216,15 +216,15 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: langgraph<1.3.0,>=1.1.1
-Requires-Dist: langgraph-prebuilt<1.2.0,>=1.0.8
-Requires-Dist: langchain<2.0.0,>=1.2.10
-Requires-Dist: langchain-core<2.0.0,>=1.2.10
+Requires-Dist: langgraph<1.3.0,>=1.2.5
+Requires-Dist: langgraph-prebuilt<1.2.0,>=1.1.0
+Requires-Dist: langchain<2.0.0,>=1.3.9
+Requires-Dist: langchain-core<2.0.0,>=1.4.7
 Requires-Dist: langchain-text-splitters>=1.1.0
-Requires-Dist: langchain-anthropic<2.0.0,>=1.3.3
+Requires-Dist: langchain-anthropic<2.0.0,>=1.4.6
 Requires-Dist: langchain-google-genai<5.0.0,>=4.2.0
-Requires-Dist: langchain-community>=0.4.1
-Requires-Dist: langchain-openai>=1.1.3
+Requires-Dist: langchain-community>=0.4.2
+Requires-Dist: langchain-openai>=1.3.2
 Requires-Dist: openai
 Requires-Dist: tree-sitter==0.21.3
 Requires-Dist: tree-sitter-languages>=1.10.2

{langchain_agentx_python-1.4.2.dist-info → langchain_agentx_python-1.5.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langchain_agentx/__init__.py,sha256=t-TmHbOUpqwE-NSyvTsCucQxBWcLoDD7TzuWPdWNERE,1614
+langchain_agentx/__init__.py,sha256=usHZv4utHyCCpHzCj6g7iTRghMj5BFBhJE5R3BBOBFc,1614
 langchain_agentx/command/__init__.py,sha256=Ej260S5uFQcmEtGZQG_NH7BYjHoStrpBLtGUsBTxyZk,631
 langchain_agentx/command/allowed_tools.py,sha256=TVA0VM8rm98H-QbLK_GRiX5RhEAZFxKawliMi4kk96A,3359
 langchain_agentx/command/context.py,sha256=DIGOGPBw5UGDBm0WNNJlKx1h_9rCRmcdROv4DT61Qug,731
@@ -692,10 +692,10 @@ langchain_agentx/workflow/event_adapter/adapter.py,sha256=RXreqtL4jJaCkdN8iwVfGO
 langchain_agentx/workflow/event_adapter/depth_resolver.py,sha256=MLUTSoVbAtUieQjV79rR0HKFhEYbNuCYpArG2rv8E6c,5181
 langchain_agentx/workflow/event_adapter/stack.py,sha256=Y5ZfRTbSAYB78XQsVrl9kyWwLspFyh6y53HUHxbrzzQ,3916
 langchain_agentx/workflow/event_adapter/structure_utils.py,sha256=EYUKYouB44zhkppXAULlIdFZ0vz81PSnpCYCCfkJdZQ,2991
-langchain_agentx/workflow/event_adapter/types.py,sha256=Ued9b028WScL385DJbSkjSZvfXEYfTDAc053Sa1_9AU,6599
+langchain_agentx/workflow/event_adapter/types.py,sha256=WF4pEJdqzXTAxr8aGXrS26ucMWJW7AHaPebPnkL7SUk,8259
 langchain_agentx/workflow/event_adapter/handlers/__init__.py,sha256=oiEWh29Vw1dJbKlS4RIaKxh4EnvRVDVDRsfGyI16b-E,493
 langchain_agentx/workflow/event_adapter/handlers/display_support.py,sha256=pEp3SxvXzXIvms9QM3o4G0AMgUVlY_9hTqbphvq0BwI,1843
-langchain_agentx/workflow/event_adapter/handlers/parallel_handler.py,sha256=XeSH9WNfvSfVluZlXPZpmmlUCKW2W44U08mImXW6iv0,9854
+langchain_agentx/workflow/event_adapter/handlers/parallel_handler.py,sha256=jFxjlniVMTzT_yZRF2KDxLateXGVLTUp-e6tydceFr8,10552
 langchain_agentx/workflow/event_adapter/handlers/route_handler.py,sha256=OA7jKvFghHyyDpCNLCXCe1tY_Z0cMu1OQqShhzi5tBc,6189
 langchain_agentx/workflow/event_adapter/handlers/stage_handler.py,sha256=7B8ZY-x9O7gVv1-xlZM2OtAnsnKXbUFTsuHxrBnkTCU,6437
 langchain_agentx/workflow/patterns/__init__.py,sha256=JB021EXUCNO7ZdReqlc_QVCzr5BlIOY-UDjIBj1UzKA,930
@@ -722,8 +722,8 @@ langchain_agentx/workspace/root_grant_manager.py,sha256=W3gy8HTevbERbXqIgRcjzOXO
 langchain_agentx/workspace/tool_boundary.py,sha256=UDwX6swpSLsx9HNkYuuRRiV5o7ZZG_Bru2Yn0c5kNX8,5724
 langchain_agentx/workspace/validators.py,sha256=tQt-6TOcL8Fw7Ig5ebA9S7vGWh1rby920eFW6x8Tk9E,1439
 langchain_agentx/workspace/view.py,sha256=Ip02CZNI-ZjF5k0OYT3q7RUR_auMEw83VJ6rQsaBcYU,4588
-langchain_agentx_python-1.4.2.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-langchain_agentx_python-1.4.2.dist-info/METADATA,sha256=EQ1IvSK5HzVtcVqGil_nxIapXV2cKnfnuwlrofy3iBY,24252
-langchain_agentx_python-1.4.2.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
-langchain_agentx_python-1.4.2.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
-langchain_agentx_python-1.4.2.dist-info/RECORD,,
+langchain_agentx_python-1.5.4.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+langchain_agentx_python-1.5.4.dist-info/METADATA,sha256=i-8TFeLuqFuuACvejSDk5q7EBnoHcYwDo0ovNTBVykM,24250
+langchain_agentx_python-1.5.4.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+langchain_agentx_python-1.5.4.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
+langchain_agentx_python-1.5.4.dist-info/RECORD,,