langchain-agentx-python 1.2.7__py3-none-any.whl → 1.2.8__py3-none-any.whl

langchain_agentx/__init__.py

@@ -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,

langchain_agentx/loop/graph/graph_edges.py

@@ -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,

langchain_agentx/loop/hook/__init__.py

@@ -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",

langchain_agentx/loop/hook/async_hook_runner.py

@@ -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",
+]

langchain_agentx/loop/hook/graph_wiring.py

@@ -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")

langchain_agentx/task_runtime/tasklist/store.py

@@ -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:

{langchain_agentx_python-1.2.7.dist-info → langchain_agentx_python-1.2.8.dist-info}/METADATA

@@ -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

{langchain_agentx_python-1.2.7.dist-info → langchain_agentx_python-1.2.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langchain_agentx/__init__.py,sha256=Eo8mhs--d9e_b3hUzJW5IlhNE-9Jeqp2Ho5fkUKQZgc,1678
+langchain_agentx/__init__.py,sha256=b-u3BUFUQ27sY5qq7MGKGyTccmPP4VsDNwXrDWhXR24,1678
 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
@@ -66,14 +66,14 @@ langchain_agentx/loop/exit/withheld_error.py,sha256=LfX3j7Rgd9VoMzlz7GOs9TPuRe7R
 langchain_agentx/loop/graph/__init__.py,sha256=9pUUqn7G87n3lV45iYIU24j0wcTHyCD--SSdtv3urh4,136
 langchain_agentx/loop/graph/builtin_loop_control.py,sha256=jagBvSo8fj6Yjl95rkp5A0W8RgyVf4P-EXMmGweURl8,7184
 langchain_agentx/loop/graph/factory.py,sha256=Pjc36mds2PYEo8rNSUawfUN8jiO0U6BO4AIDpCvNP3Q,91663
-langchain_agentx/loop/graph/graph_edges.py,sha256=YisRMKFh3-vEJmrC6JF2RGlJgltf6TtdvApv5SoywSs,43356
+langchain_agentx/loop/graph/graph_edges.py,sha256=A82WBrKfNCbx55xNz0If-oaPs1tr2R0inTnQFJSUu4E,43401
 langchain_agentx/loop/graph/reactive_compact_node.py,sha256=AN31reohf25zRiqdPTmFCIQ1N6VwKn1oIkRkRuGAp4k,8725
 langchain_agentx/loop/graph/runtime_tools_node.py,sha256=5iBPvHl2hOdfnRZrwtnoD4J_SzEuQKC6VQUJyPuthgA,5089
-langchain_agentx/loop/hook/__init__.py,sha256=itzo-r53bwbMgqXFwt7A9spBZMhTZrwzZJOet2N-C0c,2004
-langchain_agentx/loop/hook/async_hook_runner.py,sha256=UIrdpgAcUumyxs7ASeJh6ehK2NSo-FDQVj9ICpuPook,2146
+langchain_agentx/loop/hook/__init__.py,sha256=rOjc1cqWBxrcp651w_SQX50dWY7o28L2c-r8iVs-SWU,2167
+langchain_agentx/loop/hook/async_hook_runner.py,sha256=SNyuYnQoowZzBTBHQb6o5L9wTG2Rl7qryeMtqFyEsxI,3195
 langchain_agentx/loop/hook/config.py,sha256=f8XtGGHtyjuRvZNhkU8ohbhyqOHD7mHZn_w0rVXMX_o,9157
 langchain_agentx/loop/hook/engine.py,sha256=s18KUN1QY0eC5T01mG8yO2lNxLg-GDa8ZhIXFjo1BSk,14865
-langchain_agentx/loop/hook/graph_wiring.py,sha256=5boUnrr4v1GkrU6pZTkY1M7BlqbEN-hr8WnxQ2nFB_g,8012
+langchain_agentx/loop/hook/graph_wiring.py,sha256=Bh40IsQzoYT_2ThdwFQB2uFiy8S6DZQ6NN8LBslcJJs,8057
 langchain_agentx/loop/hook/hook_projection.py,sha256=B2PgU2YPx6Mnpdpcac6g_8SlkmR1bllNNPIn8jp2hyU,5966
 langchain_agentx/loop/hook/progress_payload.py,sha256=bbNUEguw_cYbI3l0RJZ4VAtfgaRhD0jqwk3eE5AzgCE,4532
 langchain_agentx/loop/hook/registry.py,sha256=X8k9NEzyBnasQyAWdJZmbLtX_OlV_KqUkFY4roYPLKo,11958
@@ -313,7 +313,7 @@ langchain_agentx/task_runtime/tasklist/notifier.py,sha256=ylFrvD220TJTpvxGzkSt3r
 langchain_agentx/task_runtime/tasklist/path_resolver.py,sha256=mCo4I-dZiHpNVHHm6rT5ByFs9bfsfmtspejFKMo_Xq8,2604
 langchain_agentx/task_runtime/tasklist/paths.py,sha256=pvrKiUK4kUa_mCWQz6_e4T2U6jXTOevBQRJmSfCquto,2284
 langchain_agentx/task_runtime/tasklist/reader.py,sha256=PIc_GJ2uhp2dskX5Sb_jJxz_miZOkiHy-7nQrXd80E8,2295
-langchain_agentx/task_runtime/tasklist/store.py,sha256=gCv9nf7u2cbdjTd_U1NknLaL3mUp0IU_n9RFHxS95_8,19816
+langchain_agentx/task_runtime/tasklist/store.py,sha256=RShUySLEJlGbv1KY2zXTRVm57YCbtB6pXd09T8YDcyQ,20065
 langchain_agentx/task_runtime/tasks/__init__.py,sha256=G_a_TVE5c3thIiETiOtKov5yMDAkob0dqzfwDsVsfPk,2041
 langchain_agentx/task_runtime/tasks/ai_analysis/__init__.py,sha256=f_1U_gULXWWdrE9zCXNGfC2M-627X8p0K1Yj9CB_SHc,455
 langchain_agentx/task_runtime/tasks/ai_analysis/base.py,sha256=bSIBCBlQyg_2sygKrZenUOmz4sLM7lpKrxEroMTf-9I,2702
@@ -667,8 +667,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.2.7.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-langchain_agentx_python-1.2.7.dist-info/METADATA,sha256=i36FJyJItNCQwqXc8FDOn3RppwJvvb90dM0ICEN3ihI,24846
-langchain_agentx_python-1.2.7.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
-langchain_agentx_python-1.2.7.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
-langchain_agentx_python-1.2.7.dist-info/RECORD,,
+langchain_agentx_python-1.2.8.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+langchain_agentx_python-1.2.8.dist-info/METADATA,sha256=GEO2zoN_6c-aydS3qR6yS6zRRIJB79FR_IX6YFePh3g,24846
+langchain_agentx_python-1.2.8.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+langchain_agentx_python-1.2.8.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
+langchain_agentx_python-1.2.8.dist-info/RECORD,,