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

langchain_agentx/__init__.py

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

langchain_agentx/loop/config/loop_config.py

@@ -81,8 +81,13 @@ class TraceConfig:
     """观测追踪配置。
 
     CC 对照：options.debug / queryTracking 等。
+
+    - ``enabled``：是否挂 TraceCollector 埋点（lifecycle / callback）。
+    - ``persist``：是否挂 ``SqliteTraceStore`` 写 traces.db；默认 False，避免盘胀。
+      亦可经环境变量 ``LANGCHAIN_AGENTX_TRACE_PERSIST=1`` 打开（见 persist_policy）。
     """
     enabled: bool = True
+    persist: bool = False
     visibility: str | None = None
     parent_run_id: str | None = None
     parent_tool_call_id: str | None = None

langchain_agentx/loop/config/loop_runtime_overlay.py

@@ -9,7 +9,8 @@ loop_runtime_overlay.py — L4 graph_factory 运行期 overlay（IF-G6）
     → graph_factory(overlay) → apply_to(AgentLoopConfig) → create_loop_agent
 
 当前裁剪范围：
-    仅 session_id、trace 父链、subagent 标记、capabilities、enable_trace；不含 container_type。
+    仅 session_id、trace 父链、subagent 标记、capabilities、enable_trace / trace_persist；
+    不含 container_type。
 """
 
 from __future__ import annotations
@@ -26,6 +27,7 @@ class LoopRuntimeOverlay:
 
     session_id: str | None = None
     enable_trace: bool | None = None
+    trace_persist: bool | None = None
     capabilities: Any = None
     parent_conversation_session_id: str | None = None
     is_subagent: bool | None = None
@@ -41,6 +43,9 @@ class LoopRuntimeOverlay:
         if self.enable_trace is not None:
             trace = replace(trace, enabled=self.enable_trace)
             trace_changed = True
+        if self.trace_persist is not None:
+            trace = replace(trace, persist=self.trace_persist)
+            trace_changed = True
         if self.parent_conversation_session_id is not None:
             trace = replace(trace, parent_conversation_session_id=self.parent_conversation_session_id)
             trace_changed = True

langchain_agentx/loop/graph/factory.py

@@ -305,6 +305,7 @@ def _flatten_config_for_runtime(config: AgentLoopConfig) -> _FlatLoopConfig:
         agent_depth=config.agent_depth,
         subagent_type=config.subagent.subagent_type,
         trace_enabled=config.trace.enabled,
+        trace_persist=config.trace.persist,
         headless=config.headless,
         model_profile=config.model_profile,
         model_profile_registry=config.model_profile_registry,
@@ -1143,9 +1144,28 @@ class LoopGraphBuilder:
         if not self._config.trace.enabled:
             return None
         if self._services.trace_collector is not None:
+            # 显式注入：调用方自管 store 生命周期（测试 / 宿主）
             return self._services.trace_collector
-        if self._services.capabilities is not None and self._services.capabilities.trace_collector is not None:
-            return self._services.capabilities.trace_collector
+
+        from ...observability.trace.persist_policy import resolve_trace_persist
+
+        persist = resolve_trace_persist(configured=bool(self._config.trace.persist))
+        caps = self._services.capabilities
+        caps_collector = (
+            caps.trace_collector
+            if caps is not None and getattr(caps, "trace_collector", None) is not None
+            else None
+        )
+
+        if not persist:
+            # 不落盘：复用 caps 上无 store 的 collector；若 caps 误带 store 则改用内存 collector，避免写库。
+            if caps_collector is not None and getattr(caps_collector, "_store", None) is None:
+                return caps_collector
+            return TraceCollector(store=None)
+
+        # persist=True：必须挂有 store 的 collector；caps 无 store 时兜底 from_env，避免「开了 persist 仍不落盘」。
+        if caps_collector is not None and getattr(caps_collector, "_store", None) is not None:
+            return caps_collector
         return TraceCollector(SqliteTraceStore.from_env())
 
     def _resolve_response_format_setup(

langchain_agentx/loop/runtime/context_factory.py

@@ -167,6 +167,7 @@ class RuntimeContextFactory:
             ),
             trace=TraceConfig(
                 enabled=bool(getattr(parent_ctx, "trace_enabled", True)),
+                persist=bool(getattr(parent_ctx, "trace_persist", False)),
             ),
             subagent=SubagentLinkage(
                 is_subagent=True,

langchain_agentx/loop/subagent/context.py

@@ -91,6 +91,7 @@ class SubagentContext:
     parent_tool_call_id: str | None = None  # 触发本子 Agent 的 tool_call_id
     parent_conversation_session_id: str | None = None
     enable_trace: bool = True
+    trace_persist: bool = False
     runnable_config: Any = None  # 父 runnable_config：仅供 tool_progress custom event 回调链；非子 raw 合并
     isolation: str = "none"
     worktree_dir: str | None = None
@@ -324,6 +325,7 @@ def create_subagent_context(
         parent_tool_call_id=parent_tool_call_id,
         parent_conversation_session_id=parent_conversation_id,
         enable_trace=bool(getattr(parent_ctx, "trace_enabled", True)),
+        trace_persist=bool(getattr(parent_ctx, "trace_persist", False)),
         isolation=isolation,
         worktree_dir=worktree_dir,
         workspace_root=str(parent_workspace_root),
@@ -476,6 +478,7 @@ class SubagentContextFactory:
             parent_run_id=parent_runtime.parent_run_id,
             parent_conversation_session_id=parent_runtime.parent_conversation_session_id,
             enable_trace=not skip_transcript,
+            trace_persist=bool(getattr(parent_runtime, "trace_persist", False)),
             workspace_root=workspace_root,
             agent_home_segment=agent_home_segment,
             cwd=effective_cwd,

langchain_agentx/loop/subagent/graph.py

@@ -108,6 +108,7 @@ def create_subagent_graph(
         ),
         trace=TraceConfig(
             enabled=ctx.enable_trace,
+            persist=ctx.trace_persist,
             # 背景 fork / 异步子代理默认隐藏
             visibility=(
                 "hidden"

langchain_agentx/observability/trace/__init__.py

@@ -13,6 +13,11 @@ from .sqlite_store import SqliteTraceStore
 from .trace_lifecycle_collector import TraceLifecycleCollector
 from .trace_callback import TraceCallbackHandler
 from .hook_event_emitter import HookEventEmitter
+from .persist_policy import (
+    ENV_TRACE_PERSIST,
+    env_trace_persist_enabled,
+    resolve_trace_persist,
+)
 
 __all__ = [
     "TraceSession",
@@ -22,4 +27,7 @@ __all__ = [
     "TraceLifecycleCollector",
     "TraceCallbackHandler",
     "HookEventEmitter",
+    "ENV_TRACE_PERSIST",
+    "env_trace_persist_enabled",
+    "resolve_trace_persist",
 ]

langchain_agentx/observability/trace/persist_policy.py

@@ -0,0 +1,40 @@
+"""
+persist_policy.py — Trace SQLite 落盘开关解析
+
+职责：
+    统一 ``TraceConfig.persist`` 与环境变量的合成规则；默认不落盘。
+
+链路位置：
+    RuntimeCapabilities / Loop factory / AgentSession → resolve_trace_persist
+
+当前裁剪范围：
+    仅布尔开关；不负责 db 路径（路径仍由 SqliteTraceStore / AGENTX_TRACE_DB_PATH）。
+"""
+
+from __future__ import annotations
+
+import os
+
+ENV_TRACE_PERSIST = "LANGCHAIN_AGENTX_TRACE_PERSIST"
+
+
+def env_trace_persist_enabled() -> bool:
+    """环境变量是否打开落盘（``1`` / ``true`` / ``yes`` / ``on``）。"""
+    val = os.getenv(ENV_TRACE_PERSIST, "").strip().lower()
+    return val in ("1", "true", "yes", "on")
+
+
+def resolve_trace_persist(*, configured: bool = False) -> bool:
+    """合成是否挂 SqliteTraceStore。
+
+    规则：``configured`` OR env；默认 False。
+    单独设置 ``AGENTX_TRACE_DB_PATH`` **不会**自动打开 persist。
+    """
+    return bool(configured) or env_trace_persist_enabled()
+
+
+__all__ = [
+    "ENV_TRACE_PERSIST",
+    "env_trace_persist_enabled",
+    "resolve_trace_persist",
+]

langchain_agentx/session/agent_session.py

@@ -82,6 +82,7 @@ class AgentSession:
         transcript_writer: SubagentTranscriptStore | None = None,
         container_type: str = "interactive",
         enable_trace: bool = True,
+        trace_persist: bool = False,
         capabilities: RuntimeCapabilities | None = None,
     ) -> None:
         self._graph = graph
@@ -93,6 +94,7 @@ class AgentSession:
         self._messages: list[Any] = []
         self._container_type = container_type
         self._enable_trace = enable_trace
+        self._trace_persist = trace_persist
         self._transcript_writer = transcript_writer
         self._last_transcript_uuid: str | None = None
         self._last_finish_outcome: dict[str, Any] | None = None
@@ -100,6 +102,7 @@ class AgentSession:
         self._capabilities = capabilities or RuntimeCapabilities.build(
             resource_root=workspace_cfg.workspace_root,
             agent_home_segment=workspace_cfg.agent_home_segment,
+            trace_persist=trace_persist,
         )
         self._skill_registry = SkillRegistry(workspace_root=workspace_cfg.workspace_root)
         self._command_registry = PluginCommandRegistry()
@@ -544,6 +547,7 @@ class AgentSession:
         return self._graph_factory(
             LoopRuntimeOverlay(
                 enable_trace=self._enable_trace,
+                trace_persist=self._trace_persist,
                 capabilities=self._capabilities,
             ),
             active_files_getter=getter,

langchain_agentx/session/factory.py

@@ -94,6 +94,7 @@ def create_agent_session(
         transcript_writer=transcript_writer,
         container_type=cfg.container_type,
         enable_trace=cfg.trace.enabled,
+        trace_persist=cfg.trace.persist,
         capabilities=svcs.capabilities,
     )
 

langchain_agentx/tool_runtime/adapter.py

@@ -653,10 +653,15 @@ class LangChainAdapter:
 
     @staticmethod
     def _envelope_to_event_artifact_dict(env: ToolResultEnvelope) -> dict[str, Any]:
+        from langchain_agentx.tool_runtime.cancel_projection import (
+            resolve_artifact_terminal_state,
+        )
+
         raw = asdict(env)
         raw["schema_version"] = "2"
         result = LangChainAdapter._json_safe_value(raw)
-        result["terminal_state"] = "completed"
+        meta = result.get("meta") if isinstance(result.get("meta"), dict) else {}
+        result["terminal_state"] = resolve_artifact_terminal_state(meta=meta)
         # B1/C3 方案 B：blocks/hints/artifacts 同时落 meta.envelope_extensions，
         # CLI Bridge 只消费 meta/display/payload，不扩字段面。
         extensions: dict[str, Any] = {}

langchain_agentx/tool_runtime/cancel_projection.py

@@ -0,0 +1,85 @@
+"""
+tool_runtime/cancel_projection.py — 工具取消投影（层 C · D-TR）
+
+职责：判定取消窄条件，解析 artifact ``terminal_state`` 与 model payload 双轨哨兵。
+链路位置：``AgentRuntimeTool.present`` → adapter/pipeline ``envelope → artifact``。
+对照 CC：``CANCEL_MESSAGE`` / ``INTERRUPT_MESSAGE_FOR_TOOL_USE``；设计 D-TR-1…4。
+当前裁剪：不扩 ``ToolResultEnvelope.status``；禁止仅凭散文含 cancel 推断。
+"""
+
+from __future__ import annotations
+
+from typing import Any, Literal, Mapping
+
+from langchain_agentx.loop.exit.reason_codes import (
+    TERMINAL_REASON_ABORTED_STREAMING,
+    TERMINAL_REASON_ABORTED_TOOLS,
+    TERMINAL_REASON_HOOK_STOPPED,
+)
+from langchain_agentx.tool_runtime.messages import (
+    CANCEL_MESSAGE,
+    INTERRUPT_MESSAGE_FOR_TOOL_USE,
+)
+
+CANCEL_ERROR_KINDS = frozenset({"aborted", "user_cancelled", "cancelled"})
+
+ABORT_LIKE_TERMINAL_REASONS = frozenset(
+    {
+        TERMINAL_REASON_ABORTED_STREAMING,
+        TERMINAL_REASON_ABORTED_TOOLS,
+        TERMINAL_REASON_HOOK_STOPPED,
+    }
+)
+
+
+def is_cancel_projection(
+    *,
+    source_status: str | None = None,
+    error_kind: str | None = None,
+    terminal_reason: str | None = None,
+) -> bool:
+    """D-TR-3：满足其一即视为用户取消投影（窄条件）。"""
+    if source_status == "interrupted":
+        return True
+    if error_kind in CANCEL_ERROR_KINDS:
+        return True
+    if terminal_reason in ABORT_LIKE_TERMINAL_REASONS:
+        return True
+    return False
+
+
+def resolve_cancel_model_payload(*, error_kind: str | None) -> str:
+    """D-TR-4：Stop 轨 ``user_cancelled`` → CANCEL；其余取消 → INTERRUPT_FOR_TOOL_USE。"""
+    if error_kind == "user_cancelled":
+        return CANCEL_MESSAGE
+    return INTERRUPT_MESSAGE_FOR_TOOL_USE
+
+
+def resolve_artifact_terminal_state(
+    *,
+    meta: Mapping[str, Any] | None = None,
+    terminal_reason: str | None = None,
+) -> Literal["completed", "cancelled"]:
+    """adapter/pipeline 共用：取消 → ``cancelled``，否则 ``completed``。"""
+    m = meta if isinstance(meta, Mapping) else {}
+    reason = terminal_reason if terminal_reason is not None else m.get("terminal_reason")
+    kind = m.get("error_kind")
+    source = m.get("source_status")
+    if is_cancel_projection(
+        source_status=str(source) if source is not None else None,
+        error_kind=str(kind) if kind is not None else None,
+        terminal_reason=str(reason) if reason is not None else None,
+    ):
+        return "cancelled"
+    return "completed"
+
+
+__all__ = [
+    "ABORT_LIKE_TERMINAL_REASONS",
+    "CANCEL_ERROR_KINDS",
+    "CANCEL_MESSAGE",
+    "INTERRUPT_MESSAGE_FOR_TOOL_USE",
+    "is_cancel_projection",
+    "resolve_artifact_terminal_state",
+    "resolve_cancel_model_payload",
+]

langchain_agentx/tool_runtime/pipeline.py

@@ -684,7 +684,12 @@ class ToolExecutorPipeline:
 
         artifact = json_safe(asdict(envelope))
         artifact["schema_version"] = "2"
-        artifact["terminal_state"] = "completed"
+        from langchain_agentx.tool_runtime.cancel_projection import (
+            resolve_artifact_terminal_state,
+        )
+
+        meta = artifact.get("meta") if isinstance(artifact.get("meta"), dict) else {}
+        artifact["terminal_state"] = resolve_artifact_terminal_state(meta=meta)
 
         # display 可选（CC renderToolResultMessage?）；无 Output 跳过；抛错不炸 pipeline
         if (

langchain_agentx/tools/agent/tool.py

@@ -17,6 +17,10 @@ import logging
 from typing import Any, Literal
 
 from langchain_agentx.tool_runtime.base import RuntimeTool
+from langchain_agentx.tool_runtime.cancel_projection import (
+    is_cancel_projection,
+    resolve_cancel_model_payload,
+)
 from langchain_agentx.tool_runtime.models import (
     AuthorizationDecision,
     L1PermissionResult,
@@ -355,7 +359,14 @@ class AgentRuntimeTool(RuntimeTool):
                 },
             )
         if out.status == "error":
-            payload = out.error_message or (out.errors[0] if out.errors else "Subagent execution failed")
+            if is_cancel_projection(
+                error_kind=out.error_kind,
+                terminal_reason=out.terminal_reason,
+            ):
+                return self._present_cancelled(inp, out, source_status="error")
+            payload = out.error_message or (
+                out.errors[0] if out.errors else "Subagent execution failed"
+            )
             return ToolResultEnvelope(
                 status="error",
                 tool_name=self.name,
@@ -368,16 +379,31 @@ class AgentRuntimeTool(RuntimeTool):
                     **_agent_termination_meta(out),
                 },
             )
+        # interrupted（及未知非 completed/async）→ 取消投影（D-TR-3/4）
+        return self._present_cancelled(inp, out, source_status="interrupted")
+
+    def _present_cancelled(
+        self,
+        inp: AgentToolInput,
+        out: AgentToolOutput,
+        *,
+        source_status: str,
+    ) -> ToolResultEnvelope:
+        """层 C：取消双轨 payload；Envelope.status 仍为 error（D-TR-2）。"""
+        error_kind = out.error_kind or "aborted"
+        term = _agent_termination_meta(out)
+        term["error_kind"] = error_kind
         return ToolResultEnvelope(
             status="error",
             tool_name=self.name,
             summary=f"Agent({inp.subagent_type}) interrupted",
-            payload=out.content or "Subagent execution interrupted",
+            payload=resolve_cancel_model_payload(error_kind=error_kind),
             meta={
                 "agent_id": out.agent_id,
                 "terminal_reason": out.terminal_reason,
                 "mode": self._mode,
-                **_agent_termination_meta(out),
+                "source_status": source_status,
+                **term,
             },
         )
 

langchain_agentx/workspace/capabilities.py

@@ -18,7 +18,8 @@ workspace/capabilities.py — RuntimeCapabilities 单例与分档协作者
     - B 档：WorkspaceDefaults（default_skills_dir / default_agents_dir）
     - Overrides：NodeWorkspaceOverrides（skills_dir / agents_dir + validate）
     - provider 凭证管理暂沿用原 provider 模块，后续另迁
-    - 不承载目录副作用创建；trace_collector 失败降级不写磁盘，仅发 hook 告警
+    - 不承载目录副作用创建；trace_collector 默认不挂 Sqlite（persist=False）；
+      失败降级不写磁盘，仅发 hook 告警
 """
 
 from __future__ import annotations
@@ -145,7 +146,8 @@ class _TraceCollectorFactory:
     """trace_collector 构造 + 失败降级的小协作者。
 
     将"构造 / retry / 降级 / hook 告警"聚合为一个职责，避免 capabilities.build
-    变成过程式堆叠。失败降级为 ``TraceCollector(store=None)``（内存空操作）。
+    变成过程式堆叠。``persist=False`` 时直接 ``TraceCollector(store=None)``，
+    不建库；失败降级同样为 store=None（内存空操作）。
     """
 
     _RETRYABLE_ERRORS: tuple[type[BaseException], ...] = (ConnectionError, TimeoutError)
@@ -154,16 +156,21 @@ class _TraceCollectorFactory:
         self,
         *,
         primary_home_dir: Path,
+        persist: bool = False,
         hook_registry: Any | None = None,
         store_builder: Optional[Callable[[Path], Any]] = None,
     ) -> None:
         self._primary_home_dir = primary_home_dir
+        self._persist = persist
         self._hook_registry = hook_registry
         self._store_builder = store_builder
 
     def build(self) -> Any:
         from langchain_agentx.observability.trace import TraceCollector
 
+        if not self._persist:
+            return TraceCollector(store=None)
+
         try:
             return self._build_once()
         except self._RETRYABLE_ERRORS as e:
@@ -237,6 +244,7 @@ class RuntimeCapabilities:
         hook_registry: Any | None = None,
         profile_registry_loader: Optional[Callable[[Path], ModelProfileRegistry]] = None,
         trace_store_builder: Optional[Callable[[Path], Any]] = None,
+        trace_persist: bool | None = None,
     ) -> "RuntimeCapabilities":
         """构造 RuntimeCapabilities 单例。
 
@@ -248,7 +256,10 @@ class RuntimeCapabilities:
             hook_registry: 可选 hook 注册表，用于 trace_collector 失败告警。
             profile_registry_loader: 注入点，便于测试 mock ``ModelProfileRegistry.from_files``。
             trace_store_builder: 注入点，便于测试替换 store 构造。
+            trace_persist: 是否挂 SqliteTraceStore；``None`` 时仅看环境变量，默认不落盘。
         """
+        from langchain_agentx.observability.trace.persist_policy import resolve_trace_persist
+
         from .resolver import resolve_agent_home_string, resolve_workspace_root_path
 
         resolved_root = resolve_workspace_root_path(resource_root)
@@ -258,8 +269,10 @@ class RuntimeCapabilities:
             lambda home: ModelProfileRegistry.from_files(agent_home_dir=home)
         )
         registry = loader(primary_home_dir)
+        persist = resolve_trace_persist(configured=bool(trace_persist))
         collector = _TraceCollectorFactory(
             primary_home_dir=primary_home_dir,
+            persist=persist,
             hook_registry=hook_registry,
             store_builder=trace_store_builder,
         ).build()
@@ -286,6 +299,7 @@ class RuntimeCapabilities:
         hook_registry: Any | None = None,
         profile_registry_loader: Optional[Callable[[Path], ModelProfileRegistry]] = None,
         trace_store_builder: Optional[Callable[[Path], Any]] = None,
+        trace_persist: bool | None = None,
     ) -> "RuntimeCapabilities":
         """从 ResolvedAgentStateConfig 构造 RuntimeCapabilities 的便捷入口。
 
@@ -296,6 +310,7 @@ class RuntimeCapabilities:
             hook_registry: 可选 hook 注册表，用于 trace_collector 失败告警
             profile_registry_loader: 注入点，便于测试 mock ModelProfileRegistry.from_files
             trace_store_builder: 注入点，便于测试替换 store 构造
+            trace_persist: 是否挂 SqliteTraceStore；默认不落盘（见 ``resolve_trace_persist``）
 
         Returns:
             构造好的 RuntimeCapabilities 实例
@@ -319,6 +334,7 @@ class RuntimeCapabilities:
             hook_registry=hook_registry,
             profile_registry_loader=profile_registry_loader,
             trace_store_builder=trace_store_builder,
+            trace_persist=trace_persist,
         )
 
 

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

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

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

@@ -1,4 +1,4 @@
-langchain_agentx/__init__.py,sha256=YCgjkZ-ETOiTsxprdpJbKhr-a726t37vZ6KsVTZcr2M,1614
+langchain_agentx/__init__.py,sha256=Ap7xVSHcnVF6vuJw2G3SKTcI2QDzn2JSGQZSj-zuHjY,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
@@ -32,8 +32,8 @@ langchain_agentx/loop/run_context.py,sha256=dhNiLhvqD_QYacGMA0B5P3wWpSe3O6wU_XcV
 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
-langchain_agentx/loop/config/loop_config.py,sha256=jZfjC8msbNTtYDZ2bJxTOMlWj9l1kt0qlM-DI1csCQg,15375
-langchain_agentx/loop/config/loop_runtime_overlay.py,sha256=70FDSWs9b-Y5tZ8O3D_7PricJa8mxpy0NCDpA6wbxCo,2242
+langchain_agentx/loop/config/loop_config.py,sha256=f_McUyP8xJAhBka3bPOkk7dkPCe1ZLRX0HI5gsEb370,15680
+langchain_agentx/loop/config/loop_runtime_overlay.py,sha256=PuB4vFdqCHXRbAFhAJIrtwq9pUIrHafyn0ApD4s06KU,2440
 langchain_agentx/loop/config/model_context_resolver.py,sha256=o9RR0Vnu07TD4Y3V8jk5V1NfkMcPcLjE8uaaLOe22Qo,4067
 langchain_agentx/loop/config/model_retry_config.py,sha256=bakCbGeNRO-_SXMT_LLE3nu3m9scZe1MSxPdyEGO99w,8178
 langchain_agentx/loop/config/runtime_settings.py,sha256=uKkwyxgx5u34qbjP1DFrIRt0EygRCtsH8tMN0kWA0Yo,1551
@@ -68,7 +68,7 @@ langchain_agentx/loop/exit/terminal.py,sha256=_DAZk-kS4Xd0nxMlayLo60-uj1Y5ozgBjL
 langchain_agentx/loop/exit/withheld_error.py,sha256=LfX3j7Rgd9VoMzlz7GOs9TPuRe7RXr_Gxweyotx3tqQ,1846
 langchain_agentx/loop/graph/__init__.py,sha256=9pUUqn7G87n3lV45iYIU24j0wcTHyCD--SSdtv3urh4,136
 langchain_agentx/loop/graph/builtin_loop_control.py,sha256=QpiHe8b_yp4fyLlZ8nSXlW19cTrWGvYUkOGQZrXE9Ow,8722
-langchain_agentx/loop/graph/factory.py,sha256=vo98tu_tbWI0s5q_fcCJgoN1yVQ5E2l0OG8LTJP9BZo,103009
+langchain_agentx/loop/graph/factory.py,sha256=TthwQtNiOeT5K-bgBhuW89yrkdP6iyYXCcL4tn-puJk,103958
 langchain_agentx/loop/graph/graph_edges.py,sha256=kW6Npx-nMIPzcaisCxVPkTwf5Y9GOKy1NWCNkJWeJBQ,47370
 langchain_agentx/loop/graph/reactive_compact_node.py,sha256=633b5hTnR3BK8GBEKWhzOwGB0BQrVRKozNxDomWFjLo,8762
 langchain_agentx/loop/graph/runtime_tools_node.py,sha256=Elppfi83hgSy_9_st4-eZ4sX_usBm2l5dlJyLDqwFjw,7062
@@ -128,7 +128,7 @@ langchain_agentx/loop/prompt/tool_aware_sections.py,sha256=vST7Z5y2eoITTTcsBo9ol
 langchain_agentx/loop/prompt/using_your_tools.py,sha256=NVLscfx2jzCHOx5R1jcoTwcOMsFkPx2Y9p_XD0Von3U,5251
 langchain_agentx/loop/runtime/__init__.py,sha256=7FEIC1nvNHIbe2azfJzg5AWH9GWYfCQopQWx8a5OMqM,555
 langchain_agentx/loop/runtime/context.py,sha256=dJHQvhs79c6xJZMrkB6-aUNFVax2R7V20Oj48nFePJs,1242
-langchain_agentx/loop/runtime/context_factory.py,sha256=w6VyDH5eQjMY_abZ4VDQpf_LPB0fiK19DdcHMlbffuE,7669
+langchain_agentx/loop/runtime/context_factory.py,sha256=m3ics_dOTqEKNlf6ETIOnVj6LxVLTayuE8NIMoEl0kY,7744
 langchain_agentx/loop/runtime/subagent_execution_paths.py,sha256=Bgyiom48uta1FZcnIE7fIxyrD-VFCRsw7s8IxIxmLb4,4033
 langchain_agentx/loop/stream/graph_driver.py,sha256=qMZHEw3wJ19Tfbz31-VPLy8Mt6e90xKougIjAoaEFCE,3935
 langchain_agentx/loop/stream/helpers.py,sha256=b2sqtwrAa5ic5B5AzNqItU8pmDHw13iGs3hBiShSIZk,1390
@@ -141,13 +141,13 @@ langchain_agentx/loop/subagent/active_run_registry.py,sha256=KurhAMDTBnRkdxNidaM
 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
+langchain_agentx/loop/subagent/context.py,sha256=tjUKMOCdgrWXdQokCoA0IHI2WR8Q73pWaDGFfR_rxTs,22483
 langchain_agentx/loop/subagent/display_projector.py,sha256=AKsGWS1c9reH0kuD5u4oQ24KsBgyt7X10iZM3ere6Fs,3504
 langchain_agentx/loop/subagent/fork_boilerplate.py,sha256=2Uh3cwegL7V-DvtLIxjX7ik5uW5mXfY2NBzP-biREso,5005
 langchain_agentx/loop/subagent/fork_ports.py,sha256=hZATCvlYOxNVZtR3PoOVbI1GkA0KhHEyux6lUIjG5_4,1323
 langchain_agentx/loop/subagent/fork_worktree_notice.py,sha256=WKAJVxvRMJfbzRe_07Mgrm_zQIQCYx4RwsUnWSSOnkg,1389
 langchain_agentx/loop/subagent/forked_runner.py,sha256=ZEwkNlbwp1-PlJB5COHMKUu_w8EnSMLRc8s0umZ4NuM,6667
-langchain_agentx/loop/subagent/graph.py,sha256=EbwEE9A1-pDdLADsGdWuNQwl-cw7j1_Xia5lW7Wb-kQ,5215
+langchain_agentx/loop/subagent/graph.py,sha256=2UnkvIFzwtYAERJ7mTpK-YeQOsotPZyayMyV85SFRjw,5254
 langchain_agentx/loop/subagent/orchestrator.py,sha256=jO4312_4ReCja3Lvv0PZ6WniWtrVqwGURYtewiwLQb0,34338
 langchain_agentx/loop/subagent/progress.py,sha256=_4YCDnVDH8sBiwXhCQVB8OHaUQwsCOGdUTP_Z_yOdsU,6522
 langchain_agentx/loop/subagent/progress_dispatcher.py,sha256=e1Kd16WRUOAJSeAjupukrlxHoyCR_JO84SHqntMCzdQ,3831
@@ -241,11 +241,12 @@ langchain_agentx/observability/replay/cli.py,sha256=qqF6zY0I8PHl59C5MvgXBHfcNub0
 langchain_agentx/observability/replay/service.py,sha256=1sogs2sepaapj2pi6Uf1dW2GjuzRngZHBbdM9Ptdc1A,2706
 langchain_agentx/observability/replay/store.py,sha256=R7_v2mXb1lRSmIdN--tV2TVzuQRjsTsoSvJ0r5XvhrQ,9539
 langchain_agentx/observability/replay/ui.py,sha256=EE8Hk9IPSudMHD6pYIqn4MTmU99-Cr1Yf8P1LH3Kh8I,1456
-langchain_agentx/observability/trace/__init__.py,sha256=eoOpjOgASSqYNUUerOpkq-RePj7VeqDRMeWvvDgo2cM,685
+langchain_agentx/observability/trace/__init__.py,sha256=nFg9C3WPbhQxP61niPiFmPn7XZL26V8bfDOXJIk1nUg,885
 langchain_agentx/observability/trace/collector.py,sha256=ySah82wEU1CRCsSvk317wsK1PVBEoDoekWGXHtXmLtA,25103
 langchain_agentx/observability/trace/event_emitter.py,sha256=gElYR4VSpGvJWznDmFAFXVD07qOo2m-rPEBEEdB7Wdc,5054
 langchain_agentx/observability/trace/hook_event_emitter.py,sha256=B9errn3PjRjk6JKCYvmRUMAwGdq5HVrmqYcT8ib4E4o,3536
 langchain_agentx/observability/trace/models.py,sha256=COcD-_8rNx0TYQOrlYfR2TizkzlFolEZc2VI3xsGJy0,5010
+langchain_agentx/observability/trace/persist_policy.py,sha256=Q-IaQkIGPc2FDsTYZc-ip-tDOYtSs8YvWArvJAI8b2A,1125
 langchain_agentx/observability/trace/sqlite_store.py,sha256=Ix9GkAgS8LDJK0jGtHqpN3hhrXjuz_DecnxOJGlGBDw,36316
 langchain_agentx/observability/trace/trace_callback.py,sha256=K3tFiS_i5FruZbQlWIwrqYQKbkmFbETaQr0RHoZHRd4,12551
 langchain_agentx/observability/trace/trace_lifecycle_collector.py,sha256=b5QN2LPr45ifBHg8VmuLIoZJ7FY8RpGXp28W0vOBtvk,4309
@@ -293,12 +294,12 @@ 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=NEIKJIjp-whbpmduSatBaF1b6YIcebvUYB1ginu12WE,24617
+langchain_agentx/session/agent_session.py,sha256=u2tyI82FTZVbH8MoRSxja_6Ggor1rkQDSqJllExEphw,24790
 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=aQJBZlQsgg2-q_it4qvRwhPkvKNODDZ1TDsrMXMwvCE,17563
-langchain_agentx/session/factory.py,sha256=qzZF8EkELFKPzQ-fRI2C72Usnqk_hASWB1GM8_mYjZ8,6172
+langchain_agentx/session/factory.py,sha256=9sRKDXTPe1LYphCK3qpUKUdfracv0ckKV4Es2BQdhe4,6213
 langchain_agentx/session/plan_mode.py,sha256=GjPLBG6eVrTB7M-CeMwLqkHCQDdD93cCgwIAvOF0wRM,4710
 langchain_agentx/session/plan_mode_attachments.py,sha256=byIJC2F3RTJ9BTWVhpbE1e1rRwahAH5anPKsMXFvUE8,13861
 langchain_agentx/session/protocol.py,sha256=uNkNiQ2MD9ReJgPaYe5bF0x6JzVqv2TL-hAG8ME1Obs,622
@@ -389,9 +390,10 @@ langchain_agentx/task_runtime/tasks/trace_cleanup/executor.py,sha256=qez3WnzBTag
 langchain_agentx/task_runtime/tasks/trace_cleanup/scheduler.py,sha256=lqWlCqucs26fhr4M9LfgY8I0xuNDxwSLkre6XjAJDhA,6877
 langchain_agentx/tool_runtime/__init__.py,sha256=C4ZrS6UWSL65ErfNWMvBuZBnht6ZuGb0PBXwA0Xke74,5144
 langchain_agentx/tool_runtime/accept_edits_fast_path.py,sha256=UMCOF9Ws7hx3pcYvL-Kq7vzIAGvOGdEfx69ccUDXT-k,2281
-langchain_agentx/tool_runtime/adapter.py,sha256=vl2o9aTx4wb2-1KIn41gOtqArbw9hFbowIny5PZFriE,33608
+langchain_agentx/tool_runtime/adapter.py,sha256=rM-Y2zSZ--N-TIvx1HtI1J7ralPU0w4jJuX3bBvIVxM,33847
 langchain_agentx/tool_runtime/agent_home_bypass.py,sha256=na9xQPgJ02qA3YiJ1F8jN0Uv4uBDPzqRk3lfPPE089g,8010
 langchain_agentx/tool_runtime/base.py,sha256=Ez9W42DsaiZcWDDO8UfRKv3E7_Z6WBcABkwdAi6qTK8,21390
+langchain_agentx/tool_runtime/cancel_projection.py,sha256=81_Bvg8ZiuPdl1usePt7ykXFuO6Sg7UXogYQBX6aysQ,2788
 langchain_agentx/tool_runtime/capabilities.py,sha256=KHwu5KLqrpPKLOTwHhnvIIs9MTmQYeuS2hAFmI_Nsy8,3837
 langchain_agentx/tool_runtime/classifier_denial_bridge.py,sha256=Wv40rYc5U3Mn7G3H7sUWrcG78HyLKnrRXvv7Yv9wI5U,2743
 langchain_agentx/tool_runtime/classifier_denial_limit.py,sha256=RVLELUNO346_0ssg46bap52TRTp1dVzCOqdfjpuOpek,3793
@@ -419,7 +421,7 @@ langchain_agentx/tool_runtime/permission_rules.py,sha256=ev6-Hm3N8YtbJO3SLGpoGMU
 langchain_agentx/tool_runtime/permission_settings_loader.py,sha256=Xu6dso0ghh4pb7Puf8nj20nXxjGeQvL4kIGycavwG_o,5624
 langchain_agentx/tool_runtime/permission_settings_sync.py,sha256=g6TvjWwa7D0kw5rDznPsoMv7xylESPOyWA2vZW4HDm0,4590
 langchain_agentx/tool_runtime/permission_snapshot.py,sha256=xFoi9fIcZjSw_zrIoyglneM-vJsDOLCEjiVoazr5Ack,1947
-langchain_agentx/tool_runtime/pipeline.py,sha256=gdpYiv3_TT68insZm--5LWcbEdVzGbJLDFdWThe2Xhw,54041
+langchain_agentx/tool_runtime/pipeline.py,sha256=b4ZlEMH5i3_rqWjPx3g7BD6Yv2hvk-R6qgKFgo-b3eU,54284
 langchain_agentx/tool_runtime/policy.py,sha256=PLk_-5wu69_Gjqig0pj71brcu6VfLvGSIHsAUHOiYIQ,30068
 langchain_agentx/tool_runtime/policy_decorator.py,sha256=XWbgh_TRlPJ-J-RFo1FKjIN_n_Z9rtLTfSwBQoyLTTg,2264
 langchain_agentx/tool_runtime/process_loader.py,sha256=1YMn6ntnpdbIHJbO7wF1xuz7gNKYxK0UJAOxq96dZX4,6166
@@ -505,7 +507,7 @@ langchain_agentx/tools/agent/models.py,sha256=jPxah6JgPt0UlZVyrAQxQeZmVUDOBV7xyl
 langchain_agentx/tools/agent/prompt.py,sha256=QQA40AfA5sEIl_LG7kn7UlUKFBOzsHSs_M8c5n-p7YU,8093
 langchain_agentx/tools/agent/prompt_scope.py,sha256=xQup3hosuN0B6TFq7jYV5SE6gzZNwR6BOQ552dfef5I,2677
 langchain_agentx/tools/agent/scope.py,sha256=6F2ZJgSvt-gFeciyKIQxaIiW5PBW9zUeTj3P0uxqrrg,6324
-langchain_agentx/tools/agent/tool.py,sha256=X2_o5QdoaDnyQV09k_taTpbMJUbia68WV3GIFOONb_w,17006
+langchain_agentx/tools/agent/tool.py,sha256=h6yw2vDsla6teu47D5drOlVOn0KO_e973n_aih24qSU,17972
 langchain_agentx/tools/agent/built_in/__init__.py,sha256=4YUHj8nUcUOvJW9p158W_t_RBoQt8Uh7eTt0idnCTE4,657
 langchain_agentx/tools/agent/built_in/agentx_guide.py,sha256=Wz4791lK_URpAGtKWceEMvJlD_cu79KfmNQka5yXeUs,2719
 langchain_agentx/tools/agent/built_in/explore.py,sha256=H5757yjmudceFVaMN0O4YDH267DKfFPMSxGR83waNkk,3504
@@ -742,7 +744,7 @@ langchain_agentx/workflow/patterns/routing.py,sha256=jsMcFEbV7T3bU5O1MpQXuA8Ygdl
 langchain_agentx/workflow/patterns/specs.py,sha256=nR_TPOxO7qNEpaj-hYvDkpjLz3dgG4HDHGa8trlljNw,1696
 langchain_agentx/workspace/__init__.py,sha256=QhrN4zcq4vX9Sh2td632-nyFiBDXCGl_AUGU1wcJ4-U,2821
 langchain_agentx/workspace/boundary.py,sha256=5XyWXXLyshc1Nl3cSMKGwcy0QayDZVIdz7aMl7Y1JpM,4102
-langchain_agentx/workspace/capabilities.py,sha256=dSsbwBkUn-bOArg08s7wJK65K2t96hERaDeWKg7f2ck,13339
+langchain_agentx/workspace/capabilities.py,sha256=KQxGsnB8RtNi_wtXgTo4K6bDLDfwnouYnL78CAlsp3c,14129
 langchain_agentx/workspace/config.py,sha256=w3p2usd9LNJ6_alZ_VTZw3Vpm9ceITLW-gvTFvt9DqM,9537
 langchain_agentx/workspace/errors.py,sha256=qeqf4LdhnroC867aKRXkrGsUxFN-HdnFiyzG3_2ghKo,1481
 langchain_agentx/workspace/grant.py,sha256=bhqmrHx_iH1UuXINdGswZ4q3VnQOS8ltzgVG2V0fZag,911
@@ -757,8 +759,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.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,,
+langchain_agentx_python-2.1.9.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+langchain_agentx_python-2.1.9.dist-info/METADATA,sha256=6jvj-EwhulXBUBtaJgpJEaiyiFDPgxUnU7nX6dvS6Zk,24250
+langchain_agentx_python-2.1.9.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+langchain_agentx_python-2.1.9.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
+langchain_agentx_python-2.1.9.dist-info/RECORD,,