langchain-agentx-python 2.1.6__py3-none-any.whl → 2.1.7__py3-none-any.whl

langchain_agentx/__init__.py

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

langchain_agentx/loop/exit/reason_codes.py

@@ -48,6 +48,7 @@ TRANSITION_TOKEN_BUDGET_CONTINUATION = "token_budget_continuation"
 DEFAULT_TOKEN_BUDGET_MAX_CONTINUATIONS = 3
 
 # 错误结束 terminal_reason 集合（finish payload is_error 判据）
+# D-EVT-3：含 aborted_* / hook_stopped，与 build_loop_terminal 对齐
 ERROR_TERMINAL_REASONS = frozenset(
     {
         TERMINAL_REASON_ERROR,
@@ -60,6 +61,9 @@ ERROR_TERMINAL_REASONS = frozenset(
         TERMINAL_REASON_MAX_TOKENS,
         TERMINAL_REASON_BLOCKING_LIMIT,
         TERMINAL_REASON_CLASSIFIER_DENIAL_LIMIT,
+        TERMINAL_REASON_ABORTED_STREAMING,
+        TERMINAL_REASON_ABORTED_TOOLS,
+        TERMINAL_REASON_HOOK_STOPPED,
     }
 )
 

langchain_agentx/loop/run_context.py

@@ -42,6 +42,9 @@ class RunContext:
     child_tasks: set[asyncio.Task] = field(default_factory=set)
     child_threads: set[threading.Thread] = field(default_factory=set)
     cancel_requested: bool = False
+    # D-EVT-6：宿主在 cancel_tree / killAll 时写入；finish 投影读取；缺省 unknown。
+    # 取值：escape | workflow_stop | kill_agents | unknown；禁止从「是否有后台」猜测。
+    cancel_source: str | None = None
 
     def register_child(self, task: asyncio.Task) -> None:
         self.child_tasks.add(task)

langchain_agentx/loop/subagent/async_runner.py

@@ -13,6 +13,7 @@ loop/subagent/async_runner.py — 子 Agent 异步生命周期管理
 
 当前裁剪范围：
   P0：删除 C4；后台仅 C3。P2：killAll 仅遍历 _BACKGROUND_HANDLES（可 Task.cancel）。
+  P2 投影：lifecycle / _mark_cancelled_terminal → OOB task-notification（D-EVT-5）。
 """
 
 from __future__ import annotations
@@ -22,7 +23,7 @@ import logging
 import os
 import uuid
 from dataclasses import dataclass
-from typing import Any
+from typing import Any, Literal
 
 from langchain_agentx.loop.exit.reason_codes import (
     TERMINAL_REASON_ABORTED_STREAMING,
@@ -106,11 +107,34 @@ def _is_cancel_like_result(result: Any) -> bool:
     return getattr(result, "error_kind", None) == "aborted"
 
 
+def _emit_task_notification_bookend(
+    *,
+    task_id: str,
+    status: Literal["completed", "failed", "stopped"],
+    output_file: str = "",
+    summary: str = "",
+    agent_id: str | None = None,
+    terminal_reason: str | None = None,
+) -> None:
+    """D-EVT-5：后台终态 OOB bookend；同 task_id 去重在 sink 内完成。"""
+    from langchain_agentx.observability.events.oob_event_sink import get_oob_event_sink
+
+    get_oob_event_sink().emit_task_notification(
+        task_id=task_id,
+        status=status,
+        output_file=output_file,
+        summary=summary,
+        agent_id=agent_id,
+        terminal_reason=terminal_reason,
+    )
+
+
 def _mark_cancelled_terminal(
     *,
     task_id: str,
     output_file: str,
     task_runtime: Any | None,
+    agent_id: str | None = None,
 ) -> None:
     """写 cancelled 输出 + TaskRuntime STOPPED（对齐 TaskRuntime.cancel / CC killed）。"""
     try:
@@ -119,18 +143,27 @@ def _mark_cancelled_terminal(
             fp.write("cancelled")
     except Exception:
         logger.debug("failed to write cancelled output for task_id=%s", task_id, exc_info=True)
-    if task_runtime is None:
-        return
-    try:
-        task_runtime.mark_terminal(
-            task_id,
-            TaskStatus.STOPPED,
-            "subagent cancelled",
-            output_file=output_file,
-            terminal_reason="cancelled",
-        )
-    except Exception:
-        logger.debug("failed to mark cancelled terminal for task_id=%s", task_id, exc_info=True)
+    if task_runtime is not None:
+        try:
+            task_runtime.mark_terminal(
+                task_id,
+                TaskStatus.STOPPED,
+                "subagent cancelled",
+                output_file=output_file,
+                terminal_reason="cancelled",
+            )
+        except Exception:
+            logger.debug(
+                "failed to mark cancelled terminal for task_id=%s", task_id, exc_info=True
+            )
+    _emit_task_notification_bookend(
+        task_id=task_id,
+        status="stopped",
+        output_file=output_file,
+        summary="cancelled",
+        agent_id=agent_id,
+        terminal_reason="cancelled",
+    )
 
 
 async def _execute_background_lifecycle(
@@ -146,6 +179,7 @@ async def _execute_background_lifecycle(
     """共享后台生命周期：run_subagent → 写 output → task_runtime 终态。"""
     execution_ctx = ctx
     execution_ctx.is_async = False
+    agent_id = getattr(ctx, "agent_id", None)
     try:
         result = await run_subagent(
             ctx=execution_ctx,
@@ -160,37 +194,64 @@ async def _execute_background_lifecycle(
                 task_id=task_id,
                 output_file=output_file,
                 task_runtime=task_runtime,
+                agent_id=agent_id,
             )
             return
         with open(output_file, "w", encoding="utf-8") as fp:
             fp.write(result.content)
+        summary = (
+            result.content[:500]
+            if result.content
+            else (result.error_message or "subagent completed")
+        )
+        notif_status: Literal["completed", "failed"] = (
+            "completed" if result.status == "completed" else "failed"
+        )
         if task_runtime is not None:
             status = TaskStatus.COMPLETED if result.status == "completed" else TaskStatus.FAILED
             task_runtime.mark_terminal(
                 task_id,
                 status,
-                result.content[:500] if result.content else (result.error_message or "subagent completed"),
+                summary,
                 output_file=output_file,
                 terminal_reason=result.terminal_reason or None,
             )
+        _emit_task_notification_bookend(
+            task_id=task_id,
+            status=notif_status,
+            output_file=output_file,
+            summary=summary,
+            agent_id=agent_id,
+            terminal_reason=result.terminal_reason or None,
+        )
     except asyncio.CancelledError:
         _mark_cancelled_terminal(
             task_id=task_id,
             output_file=output_file,
             task_runtime=task_runtime,
+            agent_id=agent_id,
         )
         raise
     except Exception as exc:
         with open(output_file, "w", encoding="utf-8") as fp:
             fp.write(str(exc))
+        summary = f"Subagent background lifecycle failed: {exc}"
         if task_runtime is not None:
             task_runtime.mark_terminal(
                 task_id,
                 TaskStatus.FAILED,
-                f"Subagent background lifecycle failed: {exc}",
+                summary,
                 output_file=output_file,
                 terminal_reason=TERMINAL_REASON_GRAPH_RUNTIME_ERROR,
             )
+        _emit_task_notification_bookend(
+            task_id=task_id,
+            status="failed",
+            output_file=output_file,
+            summary=summary,
+            agent_id=agent_id,
+            terminal_reason=TERMINAL_REASON_GRAPH_RUNTIME_ERROR,
+        )
 
 
 def register_background_agent(
@@ -309,6 +370,7 @@ def kill_background_agent(task_id: str) -> bool:
         task_id=task_id,
         output_file=handle.output_file,
         task_runtime=handle.task_runtime,
+        agent_id=handle.agent_id,
     )
     return True
 

langchain_agentx/observability/__init__.py

@@ -10,13 +10,21 @@ from .events import (
     LangchainAgentEvent,
     LangchainAgentEventType,
     LangGraphToLangchainAgentEventAdapter,
+    OOB_EVENT_QUEUE_CAP,
+    OobEventSink,
     RecoveryAction,
     RecoveryActionResolver,
     RecoveryPolicy,
     RecoveryPolicyMode,
     coerce_recovery_policy,
     create_langgraph_event_adapter,
+    drain_oob_events,
     enrich_run_result,
+    ensure_oob_event_sink,
+    get_oob_event_sink,
+    install_oob_event_sink,
+    reset_oob_event_sink,
+    teardown_oob_event_sink,
 )
 from .replay.service import (
     export_call_chain,
@@ -62,6 +70,8 @@ __all__ = [
     "LogContext",
     "LoggingConfigBuilder",
     "OBS_SCHEMA_VERSION",
+    "OOB_EVENT_QUEUE_CAP",
+    "OobEventSink",
     "ObservabilityLoggerAdapter",
     "build_log_context",
     "configure_logging_once",
@@ -69,6 +79,12 @@ __all__ = [
     "LangchainAgentEventType",
     "LangGraphToLangchainAgentEventAdapter",
     "create_langgraph_event_adapter",
+    "drain_oob_events",
+    "ensure_oob_event_sink",
+    "get_oob_event_sink",
+    "install_oob_event_sink",
+    "reset_oob_event_sink",
+    "teardown_oob_event_sink",
     "RecoveryAction",
     "RecoveryActionResolver",
     "RecoveryPolicy",

langchain_agentx/observability/events/__init__.py

@@ -22,6 +22,16 @@ from .factory import (
     ILangGraphEventAdapter,
     create_langgraph_event_adapter,
 )
+from .oob_event_sink import (
+    OOB_EVENT_QUEUE_CAP,
+    OobEventSink,
+    drain_oob_events,
+    ensure_oob_event_sink,
+    get_oob_event_sink,
+    install_oob_event_sink,
+    reset_oob_event_sink,
+    teardown_oob_event_sink,
+)
 
 __all__ = [
     "LangchainAgentEventType",
@@ -40,4 +50,12 @@ __all__ = [
     "enrich_run_result",
     "ILangGraphEventAdapter",
     "create_langgraph_event_adapter",
+    "OOB_EVENT_QUEUE_CAP",
+    "OobEventSink",
+    "drain_oob_events",
+    "ensure_oob_event_sink",
+    "get_oob_event_sink",
+    "install_oob_event_sink",
+    "reset_oob_event_sink",
+    "teardown_oob_event_sink",
 ]

langchain_agentx/observability/events/agent_event_projector.py

@@ -139,6 +139,8 @@ class LangchainAgentEventType(Enum):
     TASK_NOTIFICATION_ENQUEUED = "task-notification-enqueued"
     TASK_NOTIFICATION_CONSUMED = "task-notification-consumed"
     TASK_TERMINATED = "task-terminated"
+    # D-EVT-5：OOB 后台终态书档（对标 CC system/task_notification）
+    TASK_NOTIFICATION = "task-notification"
 
 
 @dataclass
@@ -1249,6 +1251,22 @@ class AgentEventProjector:
                 tool_name=name,
                 session_id=str(child_session_id) if child_session_id else None,
             )
+            # D-EVT-5′：图内 SUBAGENT_END 覆盖时登记；若 payload 含 task_id 则抑制同 id OOB
+            end_task_id: str | None = None
+            if isinstance(output, dict):
+                raw_tid = output.get("task_id")
+                if not isinstance(raw_tid, str):
+                    artifact = output.get("artifact")
+                    if isinstance(artifact, dict):
+                        raw_tid = artifact.get("task_id")
+                if isinstance(raw_tid, str) and raw_tid.strip():
+                    end_task_id = raw_tid.strip()
+            if end_task_id:
+                from langchain_agentx.observability.events.oob_event_sink import (
+                    get_oob_event_sink,
+                )
+
+                get_oob_event_sink().note_terminal_projected(end_task_id)
             self._on_subagent_end_boundary()
 
         self.state.current_tool = None

langchain_agentx/observability/events/finish_event_payload_composer.py

@@ -11,6 +11,7 @@ finish_event_payload_composer.py — finish 事件 data 组装协作者
 当前裁剪范围：
     - 不发射事件、不读 LangGraph raw event
     - 不处理 SubAgent 终态；model_retry 进度见 retry_progress.py（Phase 6）
+    - INTERRUPT 文案仅经 display_interrupt_text 投影（D-EVT-4），不入 messages
 """
 
 from __future__ import annotations
@@ -22,8 +23,11 @@ from langchain_core.messages import AIMessage
 
 from langchain_agentx.loop.exit.reason_codes import (
     ERROR_TERMINAL_REASONS,
+    TERMINAL_REASON_ABORTED_STREAMING,
+    TERMINAL_REASON_ABORTED_TOOLS,
     TERMINAL_REASON_COMPLETED,
     TERMINAL_REASON_ERROR,
+    TERMINAL_REASON_HOOK_STOPPED,
     TERMINAL_REASON_MAX_TOKENS,
     TRANSITION_API_ERROR_TERMINAL,
     TRANSITION_CONTEXT_WINDOW_RECOVERY_EXHAUSTED,
@@ -32,6 +36,7 @@ from langchain_agentx.loop.exit.reason_codes import (
 )
 from langchain_agentx.loop.exit.terminal import read_terminal_reason
 from langchain_agentx.loop.exit.withheld_error import resolve_overflow_kind
+from langchain_agentx.loop.run_context import get_run_context
 
 _RECOVERY_EXHAUSTED_TRANSITIONS = frozenset(
     {
@@ -41,6 +46,17 @@ _RECOVERY_EXHAUSTED_TRANSITIONS = frozenset(
     }
 )
 
+# D-EVT-2/4：用户取消 display 文案（对齐 CC INTERRUPT；禁止注入 messages）
+DEFAULT_DISPLAY_INTERRUPT_TEXT = "[Request interrupted by user]"
+ERROR_KIND_USER_CANCELLED = "user_cancelled"
+ERROR_KIND_HOOK_STOPPED = "hook_stopped"
+_USER_CANCELLED_TERMINAL_REASONS = frozenset(
+    {
+        TERMINAL_REASON_ABORTED_STREAMING,
+        TERMINAL_REASON_ABORTED_TOOLS,
+    }
+)
+
 _SENSITIVE_PATTERNS: tuple[tuple[re.Pattern[str], str], ...] = (
     (re.compile(r"sk-[a-zA-Z0-9_-]{8,}", re.I), "<redacted_api_key>"),
     (re.compile(r"bearer\s+\S+", re.I), "Bearer <redacted>"),
@@ -157,7 +173,7 @@ class FinishEventPayloadComposer:
             messages=messages,
         )
 
-        return {
+        payload: dict[str, Any] = {
             "graph_name": graph_name,
             "answer": answer,
             "terminal_reason": terminal_reason,
@@ -168,6 +184,10 @@ class FinishEventPayloadComposer:
             "error_kind": error_kind,
             "recovery_exhausted": recovery_exhausted,
         }
+        if error_kind == ERROR_KIND_USER_CANCELLED:
+            payload["display_interrupt_text"] = DEFAULT_DISPLAY_INTERRUPT_TEXT
+            payload["cancel_source"] = self._resolve_cancel_source(snap)
+        return payload
 
     @staticmethod
     def _resolve_terminal_reason(
@@ -265,6 +285,25 @@ class FinishEventPayloadComposer:
         if terminal_reason == TERMINAL_REASON_COMPLETED:
             return "unknown"
 
+        if terminal_reason in _USER_CANCELLED_TERMINAL_REASONS:
+            return ERROR_KIND_USER_CANCELLED
+
+        if terminal_reason == TERMINAL_REASON_HOOK_STOPPED:
+            return ERROR_KIND_HOOK_STOPPED
+
+        return "unknown"
+
+    @staticmethod
+    def _resolve_cancel_source(snap: dict[str, Any]) -> str:
+        """D-EVT-6：宿主写入优先；缺省 unknown；禁止猜测反推。"""
+        raw = snap.get("cancel_source")
+        if raw is not None and str(raw):
+            return str(raw)
+        ctx = get_run_context()
+        if ctx is not None:
+            source = getattr(ctx, "cancel_source", None)
+            if source is not None and str(source):
+                return str(source)
         return "unknown"
 
     @staticmethod
@@ -323,6 +362,9 @@ class FinishEventPayloadComposer:
 
 
 __all__ = [
+    "DEFAULT_DISPLAY_INTERRUPT_TEXT",
+    "ERROR_KIND_HOOK_STOPPED",
+    "ERROR_KIND_USER_CANCELLED",
     "FinishEventPayloadComposer",
     "sanitize_finish_error_message",
 ]

langchain_agentx/observability/events/finish_outcome.py

@@ -20,8 +20,15 @@ from dataclasses import dataclass
 from enum import Enum
 from typing import Any, Literal
 
+from langchain_agentx.loop.exit.reason_codes import (
+    TERMINAL_REASON_ABORTED_STREAMING,
+    TERMINAL_REASON_ABORTED_TOOLS,
+    TERMINAL_REASON_HOOK_STOPPED,
+)
 from langchain_agentx.loop.exit.terminal import read_terminal_reason
 from langchain_agentx.observability.events.finish_event_payload_composer import (
+    ERROR_KIND_HOOK_STOPPED,
+    ERROR_KIND_USER_CANCELLED,
     FinishEventPayloadComposer,
 )
 
@@ -53,6 +60,27 @@ FINISH_OUTCOME_KEYS = frozenset(
 
 RecoveryPolicyMode = Literal["interactive", "auto"]
 
+_CANCEL_ERROR_KINDS = frozenset(
+    {
+        ERROR_KIND_USER_CANCELLED,
+        ERROR_KIND_HOOK_STOPPED,
+    }
+)
+_CANCEL_TERMINAL_REASONS = frozenset(
+    {
+        TERMINAL_REASON_ABORTED_STREAMING,
+        TERMINAL_REASON_ABORTED_TOOLS,
+        TERMINAL_REASON_HOOK_STOPPED,
+    }
+)
+
+
+def _is_cancel_outcome(outcome: "FinishOutcome") -> bool:
+    """用户取消 / hook 终局：禁止建议 compact（D-EVT-2 / CLI 投影）。"""
+    if outcome.error_kind in _CANCEL_ERROR_KINDS:
+        return True
+    return outcome.terminal_reason in _CANCEL_TERMINAL_REASONS
+
 
 @dataclass(frozen=True)
 class RecoveryPolicy:
@@ -149,6 +177,7 @@ class FinishOutcomeParser:
         snap = dict(state or {})
         terminal = snap.get("terminal") if isinstance(snap.get("terminal"), dict) else None
         if terminal is not None and "is_error" in terminal:
+            # from_terminal 已对缺失 error_kind 做 composer 对齐补推（D-EVT-2）
             return self.from_terminal(terminal, answer=answer)
         msgs = messages if messages is not None else snap.get("messages")
         if not isinstance(msgs, list):
@@ -178,11 +207,23 @@ class FinishOutcomeParser:
         *,
         answer: str = "",
     ) -> FinishOutcome:
+        terminal_reason = _optional_str(read_terminal_reason(terminal))
+        is_error = bool(terminal.get("is_error"))
+        error_kind = _optional_str(terminal.get("error_kind"))
+        if is_error and error_kind is None:
+            error_kind = FinishEventPayloadComposer._infer_error_kind(
+                terminal_reason=terminal_reason,
+                is_error=True,
+                withheld_error=None,
+                transition_reason=None,
+                terminal=terminal,
+                messages=None,
+            )
         return FinishOutcome(
-            terminal_reason=_optional_str(read_terminal_reason(terminal)),
-            is_error=bool(terminal.get("is_error")),
+            terminal_reason=terminal_reason,
+            is_error=is_error,
             recoverable=bool(terminal.get("recoverable")),
-            error_kind=_optional_str(terminal.get("error_kind")),
+            error_kind=error_kind,
             recovery_exhausted=bool(terminal.get("recovery_exhausted")),
             errors=tuple(str(e) for e in (terminal.get("errors") or []) if e),
             answer=answer,
@@ -220,6 +261,8 @@ class RecoveryActionResolver:
     ) -> RecoveryAction:
         if not outcome.is_error:
             return RecoveryAction.NONE
+        if _is_cancel_outcome(outcome):
+            return RecoveryAction.FAIL
         if not outcome.recoverable:
             return RecoveryAction.FAIL
 
@@ -242,12 +285,13 @@ class RecoveryActionResolver:
 
     @staticmethod
     def blocks_auto_compact(outcome: FinishOutcome) -> bool:
-        """Workflow 门禁：recovery_exhausted 后禁止再次 auto-compact（Phase 5.5）。"""
+        """Workflow 门禁：cancel / recovery_exhausted 后禁止再次 auto-compact。"""
         if not outcome.is_error:
             return False
+        if _is_cancel_outcome(outcome):
+            return True
         return outcome.recovery_exhausted
 
-
 def enrich_run_result(
     result: dict[str, Any],
     *,

langchain_agentx/observability/events/langchain_agentx_event_adapter.py

@@ -28,6 +28,7 @@ from langchain_agentx.observability.events.agent_event_projector import (
     LangchainAgentEvent,
     LangchainAgentEventType,
 )
+from langchain_agentx.observability.events.oob_event_sink import drain_oob_events
 
 
 class LangGraphToLangchainAgentEventAdapter:
@@ -51,12 +52,19 @@ class LangGraphToLangchainAgentEventAdapter:
     async def adapt(
         self, events: AsyncIterator[Dict[str, Any]]
     ) -> AsyncIterator[LangchainAgentEvent]:
-        """主转换函数：将 LangGraph 事件流转换为 LangChain AgentX 风格事件流。"""
+        """主转换函数：将 LangGraph 事件流转换为 LangChain AgentX 风格事件流。
+
+        每批 raw 事件后合并 OOB task-notification（D-EVT-5 / D-EVT-10）。
+        """
         self._projector.reset_stream_closeout_diagnostics()
         try:
             async for event in events:
                 async for oc_event in self._projector.consume(event):
                     yield oc_event
+                for oob in drain_oob_events():
+                    yield oob
+            for oob in drain_oob_events():
+                yield oob
         finally:
             self._projector.log_stream_closeout_diagnostics()
 

langchain_agentx/observability/events/oob_event_sink.py

@@ -0,0 +1,183 @@
+"""
+oob_event_sink.py — 后台 task 终态 OOB 事件队列（对标 CC sdkEventQueue）
+
+职责：
+    入队 task-notification（completed|failed|stopped）；按 task_id 去重（D-EVT-5′）；
+    供 Session/adapter drain 合并进 LangchainAgentEvent 流（D-EVT-10）。
+
+链路位置：
+    async_runner lifecycle / _mark_cancelled_terminal → emit
+    LangGraphToLangchainAgentEventAdapter.adapt / Workflow adapt_isolated → drain
+
+当前裁剪范围：
+    - 始终 enqueue（无 TUI/headless 分叉，D-EVT-10）
+    - cap=1000 丢最旧；不依赖 langchain_agentx_trace
+"""
+
+from __future__ import annotations
+
+import logging
+from collections import deque
+from contextvars import ContextVar, Token
+from typing import Literal
+
+from langchain_agentx.observability.events.agent_event_projector import (
+    LangchainAgentEvent,
+    LangchainAgentEventType,
+)
+
+logger = logging.getLogger(__name__)
+
+OOB_EVENT_QUEUE_CAP = 1000
+
+TaskNotificationStatus = Literal["completed", "failed", "stopped"]
+
+_current_sink: ContextVar["OobEventSink | None"] = ContextVar(
+    "oob_event_sink", default=None
+)
+_module_sink: OobEventSink | None = None
+
+
+class OobEventSink:
+    """Out-of-band LangchainAgentEvent 队列（task-notification bookend）。"""
+
+    def __init__(self, *, capacity: int = OOB_EVENT_QUEUE_CAP) -> None:
+        self._capacity = max(1, int(capacity))
+        self._queue: deque[LangchainAgentEvent] = deque()
+        self._projected_task_ids: set[str] = set()
+        self._dropped = 0
+
+    @property
+    def dropped_count(self) -> int:
+        return self._dropped
+
+    @property
+    def pending_count(self) -> int:
+        return len(self._queue)
+
+    def clear(self) -> None:
+        """测试 / 会话重置：清空队列与去重登记。"""
+        self._queue.clear()
+        self._projected_task_ids.clear()
+        self._dropped = 0
+
+    def note_terminal_projected(self, task_id: str) -> None:
+        """D-EVT-5′：图内 SUBAGENT_END（或其它终态）已覆盖时登记，后续 OOB no-op。"""
+        tid = str(task_id or "").strip()
+        if tid:
+            self._projected_task_ids.add(tid)
+
+    def emit_task_notification(
+        self,
+        *,
+        task_id: str,
+        status: TaskNotificationStatus,
+        output_file: str = "",
+        summary: str = "",
+        tool_use_id: str | None = None,
+        agent_id: str | None = None,
+        terminal_reason: str | None = None,
+    ) -> bool:
+        """入队一条 task-notification；同 task_id 已投影则 no-op。返回是否入队。"""
+        tid = str(task_id or "").strip()
+        if not tid:
+            return False
+        if tid in self._projected_task_ids:
+            return False
+        self._projected_task_ids.add(tid)
+
+        data: dict[str, object] = {
+            "task_id": tid,
+            "status": status,
+            "output_file": output_file or "",
+            "summary": summary or "",
+        }
+        if tool_use_id is not None:
+            data["tool_use_id"] = tool_use_id
+        if agent_id is not None:
+            data["agent_id"] = agent_id
+        if terminal_reason is not None:
+            data["terminal_reason"] = terminal_reason
+
+        event = LangchainAgentEvent(
+            event_type=LangchainAgentEventType.TASK_NOTIFICATION,
+            data=data,
+        )
+        if len(self._queue) >= self._capacity:
+            self._queue.popleft()
+            self._dropped += 1
+            logger.debug(
+                "OobEventSink capacity=%s exceeded; dropped oldest (total_dropped=%s)",
+                self._capacity,
+                self._dropped,
+            )
+        self._queue.append(event)
+        return True
+
+    def drain(self) -> list[LangchainAgentEvent]:
+        """取出并清空当前队列（保留 projected_task_ids 去重）。"""
+        items = list(self._queue)
+        self._queue.clear()
+        return items
+
+
+def get_oob_event_sink() -> OobEventSink:
+    """当前 ContextVar sink，否则模块级单例（D-EVT-10：始终可 enqueue）。"""
+    global _module_sink
+    current = _current_sink.get()
+    if current is not None:
+        return current
+    if _module_sink is None:
+        _module_sink = OobEventSink()
+    return _module_sink
+
+
+def install_oob_event_sink(sink: OobEventSink | None = None) -> tuple[OobEventSink, Token]:
+    """安装 ContextVar 级 sink（测试 / 隔离会话）。"""
+    target = sink if sink is not None else OobEventSink()
+    token = _current_sink.set(target)
+    return target, token
+
+
+def ensure_oob_event_sink() -> tuple[OobEventSink, Token | None]:
+    """若 ContextVar 已有 sink 则复用（嵌套 Workflow）；否则安装新 sink。
+
+    返回的 Token 为 None 表示未新装，teardown 时应跳过。
+    """
+    current = _current_sink.get()
+    if current is not None:
+        return current, None
+    sink, token = install_oob_event_sink()
+    return sink, token
+
+
+def reset_oob_event_sink(token: Token) -> None:
+    _current_sink.reset(token)
+
+
+def teardown_oob_event_sink(token: Token | None) -> None:
+    """clear + reset；token 为 None 时 no-op（嵌套复用父 sink）。"""
+    if token is None:
+        return
+    try:
+        get_oob_event_sink().clear()
+    finally:
+        reset_oob_event_sink(token)
+
+
+def drain_oob_events() -> list[LangchainAgentEvent]:
+    """便捷：drain 当前 sink。"""
+    return get_oob_event_sink().drain()
+
+
+__all__ = [
+    "OOB_EVENT_QUEUE_CAP",
+    "OobEventSink",
+    "TaskNotificationStatus",
+    "drain_oob_events",
+    "ensure_oob_event_sink",
+    "get_oob_event_sink",
+    "install_oob_event_sink",
+    "reset_oob_event_sink",
+    "teardown_oob_event_sink",
+]

langchain_agentx/observability/events/workflow_aware_event_adapter.py

@@ -28,6 +28,7 @@ from langchain_agentx.observability.events.agent_event_projector import (
     EventAdapterState,
     LangchainAgentEvent,
 )
+from langchain_agentx.observability.events.oob_event_sink import drain_oob_events
 from langchain_agentx.observability.events.workflow_event_mapper import (
     WorkflowEventMapper,
 )
@@ -80,6 +81,8 @@ class WorkflowAwareLangGraphEventAdapter:
                 try:
                     async for mapped in self._project_raw_event(raw_event):
                         yield mapped
+                    for oob in drain_oob_events():
+                        yield oob
                 except (GeneratorExit, asyncio.CancelledError):
                     raise
                 except (WorkflowScopeResolutionError, ValueError) as exc:
@@ -108,6 +111,8 @@ class WorkflowAwareLangGraphEventAdapter:
                     mapped = self._workflow_mapper.map(workflow_event)
                     if mapped is not None:
                         yield mapped
+                for oob in drain_oob_events():
+                    yield oob
 
     async def _project_raw_event(
         self, raw_event: Dict[str, Any]
@@ -145,6 +150,8 @@ class WorkflowAwareLangGraphEventAdapter:
                 async for raw_event in events:
                     async for mapped in self._project_raw_event(raw_event):
                         yield mapped
+                    for oob in drain_oob_events():
+                        yield oob
                 emit_finalize = True
             except (GeneratorExit, asyncio.CancelledError):
                 raise
@@ -158,6 +165,8 @@ class WorkflowAwareLangGraphEventAdapter:
                     mapped = self._workflow_mapper.map(workflow_event)
                     if mapped is not None:
                         yield mapped
+                for oob in drain_oob_events():
+                    yield oob
 
     def _sync_workflow_session_id(self, raw_event: Dict[str, Any]) -> None:
         """Deprecated: session 同步已内联至 _project_raw_event()。"""

langchain_agentx/session/agent_session.py

@@ -123,6 +123,7 @@ class AgentSession:
             )
         self._cleanup_registry = CleanupRegistry()
         self._session_closing = False
+        self._oob_sink_token = None
 
     def register_cleanup(
         self,
@@ -143,8 +144,13 @@ class AgentSession:
         )
 
     async def __aenter__(self) -> "AgentSession":
+        from langchain_agentx.observability.events.oob_event_sink import (
+            install_oob_event_sink,
+        )
+
         if self._graph is None:
             self._graph = self._build_graph()
+        _, self._oob_sink_token = install_oob_event_sink()
         if self._plugin_loader is not None:
             load_result = await self._plugin_loader.load_all(container_type="interactive")
             load_result.log_errors(logger)
@@ -152,6 +158,10 @@ class AgentSession:
         return self
 
     async def __aexit__(self, *_) -> None:
+        from langchain_agentx.observability.events.oob_event_sink import (
+            teardown_oob_event_sink,
+        )
+
         self._session_closing = True
         self._cleanup_registry.mark_closing()
         try:
@@ -193,6 +203,8 @@ class AgentSession:
                                 )
         finally:
             self._cleanup_registry.clear()
+            teardown_oob_event_sink(self._oob_sink_token)
+            self._oob_sink_token = None
 
     async def run_loop(self, user_input: str) -> dict[str, Any]:
         result = await self._run_loop_turn(user_input=user_input)
@@ -356,6 +368,16 @@ class AgentSession:
                     self._session_id,
                 )
 
+    def drain_oob_agent_events(self) -> list[Any]:
+        """拉取 OOB task-notification（D-EVT-10）。
+
+        经 LangchainAgentEvent adapter 消费时已自动 drain；raw ``stream_loop_events``
+        宿主可在 kill / tick 后调用本方法合并到 UI。
+        """
+        from langchain_agentx.observability.events.oob_event_sink import drain_oob_events
+
+        return drain_oob_events()
+
     @property
     def last_finish_outcome(self) -> dict[str, Any] | None:
         """最近一次 run_loop / resume / stream 结束后的 finish_outcome 快照。

langchain_agentx/session/conversation_session.py

@@ -100,6 +100,7 @@ class ConversationSession:
             )
         self._cleanup_registry = CleanupRegistry()
         self._session_closing = False
+        self._oob_sink_token = None
 
     def register_cleanup(
         self,
@@ -120,6 +121,11 @@ class ConversationSession:
         )
 
     async def __aenter__(self) -> "ConversationSession":
+        from langchain_agentx.observability.events.oob_event_sink import (
+            install_oob_event_sink,
+        )
+
+        _, self._oob_sink_token = install_oob_event_sink()
         if self._plugin_loader is not None:
             load_result = await self._plugin_loader.load_all(container_type="conversation")
             load_result.log_errors(logger)
@@ -127,6 +133,10 @@ class ConversationSession:
         return self
 
     async def __aexit__(self, *_) -> None:
+        from langchain_agentx.observability.events.oob_event_sink import (
+            teardown_oob_event_sink,
+        )
+
         self._session_closing = True
         self._cleanup_registry.mark_closing()
         try:
@@ -168,6 +178,8 @@ class ConversationSession:
                                 )
         finally:
             self._cleanup_registry.clear()
+            teardown_oob_event_sink(self._oob_sink_token)
+            self._oob_sink_token = None
 
     async def run_turn(self, user_input: str) -> dict[str, Any]:
         """每次用户请求调用一次，graph 每次新建。"""

langchain_agentx/workflow/base.py

@@ -415,6 +415,12 @@ class BaseWorkflow(ABC):
         }
         parent_ctx = get_run_context() if parent_workflow is not None else None
         run_ctx, run_ctx_token = install_run_context(parent=parent_ctx)
+        from langchain_agentx.observability.events.oob_event_sink import (
+            ensure_oob_event_sink,
+            teardown_oob_event_sink,
+        )
+
+        _, oob_token = ensure_oob_event_sink()
 
         try:
             return await graph.ainvoke(initial_state, config=effective_config)
@@ -428,7 +434,10 @@ class BaseWorkflow(ABC):
                     try:
                         await self._drain_pending_memory_extractions()
                     finally:
-                        self._active_run_config = previous_active
+                        try:
+                            teardown_oob_event_sink(oob_token)
+                        finally:
+                            self._active_run_config = previous_active
 
     def as_node(
         self,
@@ -575,6 +584,12 @@ class BaseWorkflow(ABC):
         }
         parent_ctx = get_run_context() if parent_workflow is not None else None
         run_ctx, run_ctx_token = install_run_context(parent=parent_ctx)
+        from langchain_agentx.observability.events.oob_event_sink import (
+            ensure_oob_event_sink,
+            teardown_oob_event_sink,
+        )
+
+        _, oob_token = ensure_oob_event_sink()
         try:
             graph = self.compile()
             effective_config = self._resolve_effective_run_config(
@@ -605,7 +620,10 @@ class BaseWorkflow(ABC):
                     try:
                         await self._drain_pending_memory_extractions()
                     finally:
-                        self._active_run_config = previous_active
+                        try:
+                            teardown_oob_event_sink(oob_token)
+                        finally:
+                            self._active_run_config = previous_active
 
     def _build_langgraph_adapter_config(
         self,

{langchain_agentx_python-2.1.6.dist-info → langchain_agentx_python-2.1.7.dist-info}/METADATA

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

{langchain_agentx_python-2.1.6.dist-info → langchain_agentx_python-2.1.7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langchain_agentx/__init__.py,sha256=9kp41PlLsu1OkW2UNEbKapzGwd3QF4HmbnZsX16b0fQ,1614
+langchain_agentx/__init__.py,sha256=YCgjkZ-ETOiTsxprdpJbKhr-a726t37vZ6KsVTZcr2M,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
@@ -28,7 +28,7 @@ langchain_agentx/loop/__init__.py,sha256=DspRAfaf_j6NkMByH6TqG1jTis8gyFGAipREVfn
 langchain_agentx/loop/benchmark_frozen_config.py,sha256=YI4IaDVMBOEucF36F2oNv5mw1TqMG_rm_LJSpKAnFWM,13942
 langchain_agentx/loop/loop_abort.py,sha256=IWcbqDA1ye4k00e2-mRjCgOtQl15EDk9tTosbgR4haU,2459
 langchain_agentx/loop/message_contract.py,sha256=Twl83TneU2PRdxgGRBxs6S9_ovRT6cb5WeCUzd6oJnE,2196
-langchain_agentx/loop/run_context.py,sha256=effS742NxcKV6i7Te4LDItw8czKnB40sz_7FSQ9FuxY,8062
+langchain_agentx/loop/run_context.py,sha256=dhNiLhvqD_QYacGMA0B5P3wWpSe3O6wU_XcVEzb86Z4,8303
 langchain_agentx/loop/config/__init__.py,sha256=WdRQVXuvGU4myaGOZ8guFFvUb66jfsAIp9DLANJGieg,1083
 langchain_agentx/loop/config/agent_config.py,sha256=tOnAHFor6dkle3FvUOVx0YsmiYVTH11UrWSyTmOLV0c,3100
 langchain_agentx/loop/config/interaction_profile.py,sha256=UWrlI3aTWjYRq1mDeXL-xL-iCrQU-bXDXhETP6q9icY,10020
@@ -62,7 +62,7 @@ langchain_agentx/loop/exit/__init__.py,sha256=3-CMz5ApkJeBc549vRfgNABenyYKVbib4I
 langchain_agentx/loop/exit/api_error_detection.py,sha256=QzyMTov4VrkpHmn288Tw7DN00hiyJNXMKlOrCbvsiAA,1479
 langchain_agentx/loop/exit/exit_logic.py,sha256=nJzerVtTmS1iIY3PyBRet7jZ9v9pi-jUO3mJwzqxcnw,13922
 langchain_agentx/loop/exit/query_source.py,sha256=b_VB13zxNbLAqUAuDt1E3SII3jNLagY-FdN6SbczTsI,2082
-langchain_agentx/loop/exit/reason_codes.py,sha256=jIakFkKSgfO2hPDxEMA95b1ekOd_pHlVb7yFU9vCu1M,4616
+langchain_agentx/loop/exit/reason_codes.py,sha256=Nk1x2ipftRIRa4U1Z2goyXXWB9TsPFL9TW6WfvtMCEo,4810
 langchain_agentx/loop/exit/resolution.py,sha256=taIMHzAUtgrQoU9446-CUXBN0PyCujhl6wBQfbxR1qI,1427
 langchain_agentx/loop/exit/terminal.py,sha256=_DAZk-kS4Xd0nxMlayLo60-uj1Y5ozgBjLlWUP6RDdc,3524
 langchain_agentx/loop/exit/withheld_error.py,sha256=LfX3j7Rgd9VoMzlz7GOs9TPuRe7RXr_Gxweyotx3tqQ,1846
@@ -138,7 +138,7 @@ langchain_agentx/loop/stream/synthetic_events.py,sha256=Z3JT3iTuB9UQOoQXUprAYvaF
 langchain_agentx/loop/stream/transcript_gate.py,sha256=4AH3O0l8OrY_GQdqf-TOKOVS3selPLUC0jYLWQUTfkg,4690
 langchain_agentx/loop/subagent/__init__.py,sha256=V5G_R0STODOi2Of0ALq1ZxiMPllw_mxDhgb5bc9HuqA,2677
 langchain_agentx/loop/subagent/active_run_registry.py,sha256=KurhAMDTBnRkdxNidaMUynCTRzdDy67Tu2NwJt3UC_g,4310
-langchain_agentx/loop/subagent/async_runner.py,sha256=CU5tqieWzHDXz16KaQ1FYEIKsXdpkSf9LlUAdJsR9uw,11744
+langchain_agentx/loop/subagent/async_runner.py,sha256=gGx8UMZbsnxUMPzc_7-XkWgd1EiuRcFAoOVUfjhFltE,13740
 langchain_agentx/loop/subagent/boundary_snapshot.py,sha256=9cQuqN29nJDRnHnx9c8b09KRmODE2zv15Z06QyjVJps,10008
 langchain_agentx/loop/subagent/cache_safe_params.py,sha256=-qcgdazEYRy6s4ILQuttpxraE3gsxq17Ro7LYBnuv3E,4460
 langchain_agentx/loop/subagent/context.py,sha256=skkSPvnshEN4Lh5kWoD7zjUtCOKcjdb4Ho1eM1apXFo,22297
@@ -201,7 +201,7 @@ langchain_agentx/memory/session/extractor.py,sha256=UUprKKtcMqn0pVhEWSnwCcc2tlB6
 langchain_agentx/memory/session/prompts.py,sha256=MA6UaNQsn9jrV78YuPbTTSKTmzvex_HY7kAaM9gVhUA,7690
 langchain_agentx/memory/session/session_memory.py,sha256=DdHkX-3rGOkyuxc3byq1hWNkHgucyo-n1jwUEWjxuP8,16642
 langchain_agentx/memory/session/tool_scope.py,sha256=DDhhzy_BEdZZe9SsisqZ9GOgMyt-aWUnCX-NH3QSPng,1684
-langchain_agentx/observability/__init__.py,sha256=UTV3th78Bw_b-Mo14EkxT7zpO_UoviHcZv17P5nCnY8,2177
+langchain_agentx/observability/__init__.py,sha256=hKf_W4rTExbGQbK1ZyrrvmJ2aX-5Tx5hhY-Q8-gwkSg,2591
 langchain_agentx/observability/evaluation/__init__.py,sha256=yqkw8noWqD-7p6xnhlF-M4F2FwYukS2XDpEYoXFNYZ4,430
 langchain_agentx/observability/evaluation/retention_scheduler.py,sha256=8iKw9G8jImIaKfmGhO9Xtm3GhvSICuGwEZp7GGczDNo,2250
 langchain_agentx/observability/evaluation/service.py,sha256=E0MZIBY67aVDooOYuri3_vTM_uguXJxCxNqQ5rJxFOg,3660
@@ -214,21 +214,22 @@ langchain_agentx/observability/evaluation/checkers/degradation.py,sha256=80-oENY
 langchain_agentx/observability/evaluation/checkers/exit_quality.py,sha256=kcV2VYLeavinm5-hysCVhNfIjv2Gj_m4Xt65B403FoY,1274
 langchain_agentx/observability/evaluation/checkers/session_memory.py,sha256=jYDdIDUAhYktggsymkBADBunrSbxdC66veM-tZt3a3s,1579
 langchain_agentx/observability/evaluation/checkers/tool_behavior.py,sha256=o1nH8SeE9145H7ej4naahRcmgw_9st21dY1W3IQa2sg,2097
-langchain_agentx/observability/events/__init__.py,sha256=9IfY3IcALgQjxdsircWrwTCFuSwr8MTKBDstC8CXPHY,1051
+langchain_agentx/observability/events/__init__.py,sha256=Zr9Iguf9XsJQLsCJy13YFdBtXHPEnI9aSWXWmA2MisA,1497
 langchain_agentx/observability/events/accumulated_text_scope.py,sha256=M4OvuQTgReF8SFrOmr-M5vyOJpzfvxj_DKD5bVpGb70,3169
 langchain_agentx/observability/events/agent_defaults.py,sha256=gmX0P__lux5xbCb8dtAlVCb3wZ7avaqFleoW4Q5anw4,1187
-langchain_agentx/observability/events/agent_event_projector.py,sha256=0xm_lWv5wtlhI05aL08yPSwTuA_Gj4cDXB00ni5bihI,62075
+langchain_agentx/observability/events/agent_event_projector.py,sha256=eMri832yK_BZbwsB_APwUN9vu66zMpZVxTstChG5l0A,63010
 langchain_agentx/observability/events/api_retry_projection.py,sha256=XGb09sNOi6k1ZGW4YqMLBE8GDxNwNMprk62jV9TS9dQ,2433
 langchain_agentx/observability/events/factory.py,sha256=gqMATIK9tBQzaPWSPhCCSPuCq-WF562ZDTnFUaMm9Qc,1570
-langchain_agentx/observability/events/finish_event_payload_composer.py,sha256=W4jLFy6868GX122qljjeLJowsG7g26o4eKVbHEa7DJc,11481
-langchain_agentx/observability/events/finish_outcome.py,sha256=I1-1RKQYMRXA5Kw0wDPXFpjdrGS421RM2fIL3gAY2kA,8926
-langchain_agentx/observability/events/langchain_agentx_event_adapter.py,sha256=plPZpoqYwDFR_XgdjH5NMQnl_oO6-rixBNl4sGJ0XRw,7519
+langchain_agentx/observability/events/finish_event_payload_composer.py,sha256=v7MyLNSZ_gR5u5WFxPJu_0MYNDvC9s9gI2iNNt9Vbr4,13189
+langchain_agentx/observability/events/finish_outcome.py,sha256=igoueAwduzuuGDwg6u9AbBB-T2UBiqbUfNoxWCBYc_g,10401
+langchain_agentx/observability/events/langchain_agentx_event_adapter.py,sha256=ujtD6G8erb9bwnHLvJYa-soWjzP99vjAE0tNKSMUGe8,7841
 langchain_agentx/observability/events/model_end_text_backfill.py,sha256=7RBnxWLi1Oe-Bw9WTYqN-B6IdytFlY-Jso1STtQr6rE,5157
+langchain_agentx/observability/events/oob_event_sink.py,sha256=ijE2AI8gfoMPRPXDwQszNWi_aCKwODywpG884blo08E,5670
 langchain_agentx/observability/events/subagent_event_mapper.py,sha256=9M9cKzMz7_OXOod0JKtLb-FtUhAKiAVikKGRF6h6Ttk,6860
 langchain_agentx/observability/events/subagent_window_text_guard.py,sha256=myo4SSV2TKZjpyrCoe-g5beNGmZnYZefa8nqW76q0Xc,3101
 langchain_agentx/observability/events/tool_call_id_resolver.py,sha256=Mun8jNb91tbV7hvIUkFG9g6NJGHVMW0kHS7Zt6N2gUA,4530
 langchain_agentx/observability/events/tool_outcome_resolver.py,sha256=YqF9Io9-0xdIdz7iYQuJkY-PiUXLC0zR26Eb9n35L9g,4357
-langchain_agentx/observability/events/workflow_aware_event_adapter.py,sha256=GlKN4vQcnXUSC9vcBWbrg4B6Td3aglzcOr4zDUfsXXw,7490
+langchain_agentx/observability/events/workflow_aware_event_adapter.py,sha256=AxJ_TjfZsUKHifGUl_3JvG5dDk8rc-IhuNLVw1ffhf8,7896
 langchain_agentx/observability/events/workflow_container_projector.py,sha256=0UdtZwKBM9k9yWV7gbbwMquT0I_cZlNqnjO0SCbvZ9s,22414
 langchain_agentx/observability/events/workflow_event_mapper.py,sha256=EA0GFWmrSIyqCOehixKnYvylF0NOj5RkRhdLA50_qrU,3703
 langchain_agentx/observability/logging/__init__.py,sha256=mDtPOxYZZFx8ezQCSwnmnfrdVi305DeJFzThwHBtnrY,508
@@ -292,11 +293,11 @@ langchain_agentx/provider/semantics/families/openai_finish_reason.py,sha256=t5eb
 langchain_agentx/provider/semantics/families/openai_interpreter.py,sha256=zT7EFfHJ5fmYZ_F59vDfyrYdEwcMJANxkoW1Pt3iocI,1915
 langchain_agentx/provider/semantics/families/openai_normalizer.py,sha256=oaf2Riz8EY6VQpc6SNKtsb-naMELw3gYV3IsnZoRBYU,2155
 langchain_agentx/session/__init__.py,sha256=uXxjBzhW1FtvSfDTTaGZPbyeSFRzRQb2MfxDumKViug,1234
-langchain_agentx/session/agent_session.py,sha256=bxjtuWDsWB3AK6Ij4jjnrCp6AtWn1NcS-2H5HieEWB0,23771
+langchain_agentx/session/agent_session.py,sha256=NEIKJIjp-whbpmduSatBaF1b6YIcebvUYB1ginu12WE,24617
 langchain_agentx/session/cleanup_registry.py,sha256=aaPUn9psCwgZ27fB1qW7lzc1TeKaBvQAxhcHDiNs2Rs,4137
 langchain_agentx/session/conversation_factory.py,sha256=zsGBx9OwAOW21sqFsjK4d9mYLRRyxC5Bp1R9OCijxzI,5911
 langchain_agentx/session/conversation_recovery.py,sha256=OXzaxywRmqRwNA2Q1UNOpUvMlIjBzgdbsNPxPGHwoaA,5803
-langchain_agentx/session/conversation_session.py,sha256=xHbZfor4ZR9l0ANCgkZ2FUnzpY3cE6afHxZn6ZeKqQg,17125
+langchain_agentx/session/conversation_session.py,sha256=aQJBZlQsgg2-q_it4qvRwhPkvKNODDZ1TDsrMXMwvCE,17563
 langchain_agentx/session/factory.py,sha256=qzZF8EkELFKPzQ-fRI2C72Usnqk_hASWB1GM8_mYjZ8,6172
 langchain_agentx/session/plan_mode.py,sha256=GjPLBG6eVrTB7M-CeMwLqkHCQDdD93cCgwIAvOF0wRM,4710
 langchain_agentx/session/plan_mode_attachments.py,sha256=byIJC2F3RTJ9BTWVhpbE1e1rRwahAH5anPKsMXFvUE8,13861
@@ -691,7 +692,7 @@ langchain_agentx/utils/permissions/filesystem.py,sha256=79vRSRPnPadHlDOOYvvbuJaJ
 langchain_agentx/utils/settings/__init__.py,sha256=UXzHZmrBJsO8ZpDmHfclHXpS7rfpmqRoXEnmTFbtVpE,172
 langchain_agentx/utils/settings/managed_path.py,sha256=MVcw4F9bTrhKqTLom8ZiiqSqCREMbGcAK9Lt8hkD67M,1155
 langchain_agentx/workflow/__init__.py,sha256=wgjJM2wW0DbFHjsNbq2bKYgFs3BIPFRuQbH8Ry5kfys,4324
-langchain_agentx/workflow/base.py,sha256=nAXw5iXFyL0s5NCRhpAHXs2uGb3vLZ3dHa1i2RbLXwc,32741
+langchain_agentx/workflow/base.py,sha256=rzZTH0ciepTglXfhDMkhl1uiJV4d_bXkOgpHlmu-N0w,33409
 langchain_agentx/workflow/batch.py,sha256=rdE9xbQ2-SI3-6yNTsKoSylDoTD5B0djLSKwqy1BdZ8,5474
 langchain_agentx/workflow/catalog_registry.py,sha256=tYUny5FkHwQU-RRUxOdxaJhiRV_9VRXU636Yn_Gzt-g,2109
 langchain_agentx/workflow/dag.py,sha256=Y1IR1IwnM79Xuev6HZnOvAE3Q23MRnA9lu4vg2Cie48,4469
@@ -756,8 +757,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=PGasqTaqhlD03SXXazHuw4RHfV681AIdlsYqL70pEjc,4774
-langchain_agentx_python-2.1.6.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-langchain_agentx_python-2.1.6.dist-info/METADATA,sha256=Jk8RM9LRkZ7JXk8iU7fxbJeBgtLHKXiHUJ3tN14BrkU,24250
-langchain_agentx_python-2.1.6.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
-langchain_agentx_python-2.1.6.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
-langchain_agentx_python-2.1.6.dist-info/RECORD,,
+langchain_agentx_python-2.1.7.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+langchain_agentx_python-2.1.7.dist-info/METADATA,sha256=l7wjAieBJ28Tvtsfo0pNg503DMYjggzW8kQHm8t4T3M,24250
+langchain_agentx_python-2.1.7.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+langchain_agentx_python-2.1.7.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
+langchain_agentx_python-2.1.7.dist-info/RECORD,,