langchain-agentx-python 1.5.7__tar.gz → 1.5.8__tar.gz

{langchain-agentx-python-1.5.7/langchain_agentx_python.egg-info → langchain-agentx-python-1.5.8}/PKG-INFO

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

{langchain-agentx-python-1.5.7 → langchain-agentx-python-1.5.8}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.5.7 → langchain-agentx-python-1.5.8}/langchain_agentx/observability/events/agent_event_projector.py

@@ -38,6 +38,9 @@ from langchain_agentx.observability.events.subagent_event_mapper import (
     SubagentBoundaryPayloadBuilder,
     SubagentProgressEventMapper,
 )
+from langchain_agentx.observability.events.subagent_window_text_guard import (
+    SubagentWindowTextGuard,
+)
 from langchain_agentx.observability.events.tool_call_id_resolver import (
     ToolCallIdResolver,
 )
@@ -151,6 +154,9 @@ class EventAdapterState:
     current_tool: Optional[str] = None
     tool_input_chunks: list[str] = field(default_factory=list)
     subagent_boundary_by_tool_call_id: Dict[str, Dict[str, str]] = field(default_factory=dict)
+    subagent_window_text_guard: SubagentWindowTextGuard = field(
+        default_factory=SubagentWindowTextGuard
+    )
     accumulated_answer: str = ""
     accumulated_reasoning: str = ""
     last_chain_end_name: str = ""
@@ -418,6 +424,16 @@ class AgentEventProjector:
         snapshot = self.state.subagent_boundary_by_tool_call_id.pop(tool_call_id, {})
         return snapshot.get("agent_id", ""), snapshot.get("subagent_type", "")
 
+    def _should_suppress_main_tier_text_stream(self) -> bool:
+        """D28 SDK-1：子 Agent 窗口内不 emit 父 main-tier TEXT_* / REASONING_*。"""
+        return self.state.subagent_window_text_guard.should_suppress_main_tier_stream
+
+    def _on_subagent_start_boundary(self) -> None:
+        self.state.subagent_window_text_guard.on_subagent_start()
+
+    def _on_subagent_end_boundary(self) -> None:
+        self.state.subagent_window_text_guard.on_subagent_end()
+
     def _hook_event_from_name(self, name: str) -> str:
         mapping = {
             "hook_loop_start": "loop_start",
@@ -791,6 +807,9 @@ class AgentEventProjector:
         if not chunk:
             return
 
+        if self._should_suppress_main_tier_text_stream():
+            return
+
         reasoning_segments: list[str] = []
         text_segments: list[str] = []
 
@@ -897,6 +916,11 @@ class AgentEventProjector:
     async def _handle_model_end(
         self, name: str, data: Dict[str, Any]
     ) -> AsyncGenerator[Optional[LangchainAgentEvent], None]:
+        if self._should_suppress_main_tier_text_stream():
+            self.state.subagent_window_text_guard.reset_active_stream_flags(self.state)
+            self.state.is_model_started = False
+            return
+
         if self.enable_reasoning_events and self.state.is_reasoning_active:
             yield self._event(
                 event_type=LangchainAgentEventType.REASONING_END,
@@ -1022,6 +1046,7 @@ class AgentEventProjector:
                 step_index=self.state.step_index,
                 tool_name=name,
             )
+            self._on_subagent_start_boundary()
 
         if self.synthesize_tool_call:
             yield self._event(
@@ -1073,6 +1098,7 @@ class AgentEventProjector:
                 tool_name=name,
                 session_id=str(child_session_id) if child_session_id else None,
             )
+            self._on_subagent_end_boundary()
 
         self.state.current_tool = None
 

langchain-agentx-python-1.5.8/langchain_agentx/observability/events/subagent_window_text_guard.py

@@ -0,0 +1,42 @@
+"""
+subagent_window_text_guard.py — D28 SDK-1 子 Agent 窗口 main-tier 流抑制
+
+职责：跟踪 open subagent 计数；窗口内禁止父 adapter emit TEXT_* / REASONING_*，
+      子 Agent 正文仅经 SUBAGENT_TRANSCRIPT / subagent-tool-* progress 冒泡。
+链路位置：AgentEventProjector._handle_model_stream / _handle_model_end
+当前裁剪范围：SUBAGENT_START/END 计数；不新增 subagent-text-delta 事件类型
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from langchain_agentx.observability.events.agent_event_projector import EventAdapterState
+
+
+@dataclass
+class SubagentWindowTextGuard:
+    """D28：子 Agent 运行窗口内抑制父 main-tier 流式正文。"""
+
+    open_runs: int = 0
+
+    def on_subagent_start(self) -> None:
+        self.open_runs += 1
+
+    def on_subagent_end(self) -> None:
+        if self.open_runs > 0:
+            self.open_runs -= 1
+
+    @property
+    def should_suppress_main_tier_stream(self) -> bool:
+        return self.open_runs > 0
+
+    def reset_active_stream_flags(self, state: EventAdapterState) -> None:
+        """抑制 emit 时清理由半开 stream 留下的 active 标志（不补发 END）。"""
+        state.is_reasoning_active = False
+        state.is_text_active = False
+
+
+__all__ = ["SubagentWindowTextGuard"]

{langchain-agentx-python-1.5.7 → langchain-agentx-python-1.5.8/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.5.7 → langchain-agentx-python-1.5.8}/langchain_agentx_python.egg-info/SOURCES.txt

@@ -218,6 +218,7 @@ langchain_agentx/observability/events/finish_outcome.py
 langchain_agentx/observability/events/langchain_agentx_event_adapter.py
 langchain_agentx/observability/events/model_end_text_backfill.py
 langchain_agentx/observability/events/subagent_event_mapper.py
+langchain_agentx/observability/events/subagent_window_text_guard.py
 langchain_agentx/observability/events/tool_call_id_resolver.py
 langchain_agentx/observability/events/tool_outcome_resolver.py
 langchain_agentx/observability/events/workflow_aware_event_adapter.py

{langchain-agentx-python-1.5.7 → langchain-agentx-python-1.5.8}/pyproject.toml

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