langchain-agentx-python 1.8.1__tar.gz → 1.8.3__tar.gz

{langchain-agentx-python-1.8.1/langchain_agentx_python.egg-info → langchain-agentx-python-1.8.3}/PKG-INFO

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

{langchain-agentx-python-1.8.1 → langchain-agentx-python-1.8.3}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.8.1 → langchain-agentx-python-1.8.3}/langchain_agentx/observability/events/workflow_aware_event_adapter.py

@@ -12,6 +12,7 @@ workflow_aware_event_adapter.py — Workflow 场景下的统一公共事件适
 
 当前裁剪范围：
     - 只桥接 workflow + agent 事件到统一公共流
+    - 流外发三路径：仅 raw 流正常耗尽时 outward yield finalize()；aclose/异常不 yield
     - 不引入工厂入口；工厂在后续 Phase 处理
 """
 
@@ -54,6 +55,7 @@ class WorkflowAwareLangGraphEventAdapter:
     async def adapt(
         self, events: AsyncIterator[Dict[str, Any]]
     ) -> AsyncIterator[LangchainAgentEvent]:
+        stream_exhausted = False
         try:
             async for raw_event in events:
                 root_session_id = self._extract_session_id(raw_event)
@@ -76,11 +78,14 @@ class WorkflowAwareLangGraphEventAdapter:
 
                 async for agent_event in self._agent_projector.consume(raw_event):
                     yield agent_event
+            stream_exhausted = True
         finally:
-            for workflow_event in self._workflow_adapter.finalize():
-                mapped = self._workflow_mapper.map(workflow_event)
-                if mapped is not None:
-                    yield mapped
+            finalized = self._workflow_adapter.finalize()
+            if stream_exhausted:
+                for workflow_event in finalized:
+                    mapped = self._workflow_mapper.map(workflow_event)
+                    if mapped is not None:
+                        yield mapped
 
     def _sync_workflow_session_id(self, raw_event: Dict[str, Any]) -> None:
         """Deprecated: session 同步已内联至 adapt()（先 reconcile stack 再派生 loop session）。"""

{langchain-agentx-python-1.8.1 → langchain-agentx-python-1.8.3}/langchain_agentx/provider/compatible_chat_openai.py

@@ -27,12 +27,17 @@ from langchain_core.messages import AIMessage, AIMessageChunk, BaseMessageChunk
 from langchain_core.outputs import ChatGenerationChunk
 from langchain_openai import ChatOpenAI
 
+from .env import resolve_openai_stream_chunk_timeout
+
 
 class CompatibleChatOpenAI(ChatOpenAI):
     """OpenAI 兼容 ChatModel 封装（支持 reasoning_content）。
 
     重要：本类默认禁用 OpenAI SDK 内置重试（max_retries=0），由外层 ModelCallRetrier
     统一管理重试逻辑，避免双层重试导致请求放大问题。
+
+    流式 chunk-gap 超时默认 300s（可通过构造参数或
+    LANGCHAIN_AGENTX_OPENAI_STREAM_CHUNK_TIMEOUT_S / LANGCHAIN_OPENAI_STREAM_CHUNK_TIMEOUT_S 覆盖）。
     """
 
     def __init__(
@@ -48,6 +53,8 @@ class CompatibleChatOpenAI(ChatOpenAI):
                         如需启用 SDK 内置重试，显式传入 max_retries > 0。
             **kwargs: 传递给 ChatOpenAI 的其他参数。
         """
+        if "stream_chunk_timeout" not in kwargs:
+            kwargs["stream_chunk_timeout"] = resolve_openai_stream_chunk_timeout()
         super().__init__(max_retries=max_retries, **kwargs)
 
     def _get_request_payload(

{langchain-agentx-python-1.8.1 → langchain-agentx-python-1.8.3}/langchain_agentx/provider/env.py

@@ -11,6 +11,8 @@ from __future__ import annotations
 
 import os
 
+DEFAULT_OPENAI_STREAM_CHUNK_TIMEOUT_S = 300.0
+
 
 def get_env_first(*names: str) -> str | None:
     for name in names:
@@ -30,6 +32,29 @@ def parse_positive_int(raw: str | None) -> int | None:
     return value if value > 0 else None
 
 
+def parse_positive_float(raw: str | None) -> float | None:
+    if raw is None:
+        return None
+    try:
+        value = float(str(raw).strip())
+    except ValueError:
+        return None
+    return value if value > 0 else None
+
+
+def resolve_openai_stream_chunk_timeout() -> float:
+    """OpenAI 兼容流式 per-chunk gap timeout（秒）。
+
+    优先级：LANGCHAIN_AGENTX_OPENAI_STREAM_CHUNK_TIMEOUT_S →
+    LANGCHAIN_OPENAI_STREAM_CHUNK_TIMEOUT_S → DEFAULT_OPENAI_STREAM_CHUNK_TIMEOUT_S。
+    """
+    raw = get_env_first(
+        "LANGCHAIN_AGENTX_OPENAI_STREAM_CHUNK_TIMEOUT_S",
+        "LANGCHAIN_OPENAI_STREAM_CHUNK_TIMEOUT_S",
+    )
+    return parse_positive_float(raw) or DEFAULT_OPENAI_STREAM_CHUNK_TIMEOUT_S
+
+
 def parse_bool(raw: str | None) -> bool | None:
     if raw is None:
         return None
@@ -41,5 +66,12 @@ def parse_bool(raw: str | None) -> bool | None:
     return None
 
 
-__all__ = ["get_env_first", "parse_bool", "parse_positive_int"]
+__all__ = [
+    "DEFAULT_OPENAI_STREAM_CHUNK_TIMEOUT_S",
+    "get_env_first",
+    "parse_bool",
+    "parse_positive_float",
+    "parse_positive_int",
+    "resolve_openai_stream_chunk_timeout",
+]
 

{langchain-agentx-python-1.8.1 → langchain-agentx-python-1.8.3/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.8.1 → langchain-agentx-python-1.8.3}/pyproject.toml

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