PyPI - langchain-agentx-python - Versions diffs - 1.2.7__tar.gz → 1.2.8__tar.gz - Mend

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

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

@@ -32,7 +32,7 @@ from langchain_core.messages import AIMessage, AnyMessage, HumanMessage, ToolMes
 from langgraph._internal._runnable import RunnableCallable
 from langgraph.graph.state import StateGraph
 from langgraph.prebuilt.tool_node import ToolNode
-from ..hook.async_hook_runner import AsyncHookRunner
+from ..hook.async_hook_runner import AsyncHookRunner, get_process_async_hook_runner
 from ..hook.hook_projection import hook_result_to_event_dict
 from ..hook.types import HookContext, HookEvent
@@ -96,7 +96,7 @@ def _execute_hook_common(
         return None
     hook_runner = state.get("_hook_runner")
     if not isinstance(hook_runner, AsyncHookRunner):
-        hook_runner = AsyncHookRunner()
+        hook_runner = get_process_async_hook_runner()
     ctx_kwargs: dict[str, Any] = {
         "event": event,
         "state": state,

@@ -12,7 +12,11 @@ loop.hook — Hook 子系统（P1/P2）。
     Phase 1：新增 HookProgressPayloadBuilder 用于 progress 展示元数据构建。
 """
-from .async_hook_runner import AsyncHookRunner
+from .async_hook_runner import (
+    AsyncHookRunner,
+    get_process_async_hook_runner,
+    shutdown_process_async_hook_runner,
+)
 from .config import HookCandidate, HookCandidateDecision, HookSpec, HooksConfigSnapshot
 from .engine import HookEngine
 from .executors import AgentExecutor, CommandExecutor, HttpExecutor, PromptExecutor
@@ -40,6 +44,8 @@ from .types import (
 __all__ = [
     "AggregatedHookResult",
     "AsyncHookRunner",
+    "get_process_async_hook_runner",
+    "shutdown_process_async_hook_runner",
     "ATTACHMENT_HOOK_BLOCKING_ERROR",
     "ATTACHMENT_HOOK_CANCELLED",
     "ATTACHMENT_HOOK_NON_BLOCKING_ERROR",

@@ -8,12 +8,14 @@ async_hook_runner.py — Hook 同步入口的异步执行协作者。
     HookGraphWiring 与 graph_edges 通过本协作者调用 HookEngine.execute()。
 当前裁剪范围：
-    P1 仅实现线程桥接执行；不引入 nest_asyncio，不修改外部事件循环。
+    P1 仅实现线程桥接执行；不引入 nest_asyncio，不修改外部 event loop。
+    进程级单例 ThreadPoolExecutor，atexit 显式 shutdown，禁止 fallback 裸 new。
 """
 from __future__ import annotations
 import asyncio
+import atexit
 from concurrent.futures import ThreadPoolExecutor
 from threading import Lock
@@ -45,7 +47,10 @@ class AsyncHookRunner:
     def _get_or_create_executor(self) -> ThreadPoolExecutor:
         with self._executor_lock:
             if self._executor is None:
-                self._executor = ThreadPoolExecutor(max_workers=1)
+                self._executor = ThreadPoolExecutor(
+                    max_workers=1,
+                    thread_name_prefix="async-hook-runner",
+                )
             return self._executor
     def close(self) -> None:
@@ -59,4 +64,33 @@ class AsyncHookRunner:
         return asyncio.run(hook_engine.execute(ctx))
-__all__ = ["AsyncHookRunner"]
+_process_runner: AsyncHookRunner | None = None
+_process_runner_lock = Lock()
+def get_process_async_hook_runner() -> AsyncHookRunner:
+    """进程级 Hook 桥接 runner（单例，避免 graph_edges fallback 泄漏线程池）。"""
+    global _process_runner
+    with _process_runner_lock:
+        if _process_runner is None:
+            _process_runner = AsyncHookRunner()
+        return _process_runner
+def shutdown_process_async_hook_runner() -> None:
+    """关闭进程级 runner 线程池（测试 / 进程退出）。"""
+    global _process_runner
+    with _process_runner_lock:
+        if _process_runner is not None:
+            _process_runner.close()
+            _process_runner = None
+atexit.register(shutdown_process_async_hook_runner)
+__all__ = [
+    "AsyncHookRunner",
+    "get_process_async_hook_runner",
+    "shutdown_process_async_hook_runner",
+]

@@ -17,7 +17,7 @@ from dataclasses import dataclass, field
 from typing import Any
 from uuid import uuid4
-from .async_hook_runner import AsyncHookRunner
+from .async_hook_runner import AsyncHookRunner, get_process_async_hook_runner
 from .engine import HookEngine
 from .hook_projection import derive_hook_outcome, hook_result_to_event_dict
 from .types import AggregatedHookResult, HookContext, HookEvent
@@ -44,7 +44,7 @@ class HookGraphWiring:
     workspace_cfg: Any | None = None
     session_id: str | None = None
     container_type: str = "interactive"
-    hook_runner: AsyncHookRunner = field(default_factory=AsyncHookRunner)
+    hook_runner: AsyncHookRunner = field(default_factory=get_process_async_hook_runner)
     def loop_start_node(self, state: dict[str, Any], runtime: Any) -> dict[str, Any]:
         run_id = state.get("_run_id")

@@ -29,6 +29,7 @@ task_runtime/tasklist/store.py — 任务存储核心
 from __future__ import annotations
 import asyncio
+import atexit
 import json
 from collections.abc import Coroutine
 from concurrent.futures import ThreadPoolExecutor
@@ -514,6 +515,14 @@ _T = TypeVar("_T")
 _ASYNC_RUNNER = ThreadPoolExecutor(max_workers=1, thread_name_prefix="taskstore-sync")
+def shutdown_taskstore_async_runner(*, wait: bool = True) -> None:
+    """关闭 TaskStoreSync 桥接线程池（测试 / 进程退出）。"""
+    _ASYNC_RUNNER.shutdown(wait=wait)
+atexit.register(shutdown_taskstore_async_runner)
 def _run_async(coro_factory: Callable[[], Coroutine[Any, Any, _T]]) -> _T:
     """在同步上下文中执行协程；若已有 running loop 则在线程内 asyncio.run。"""
     try:

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

langchain-agentx-python 1.2.7__tar.gz → 1.2.8__tar.gz

langchain-agentx-python 1.2.7tar.gz → 1.2.8tar.gz