PyPI - langchain-agentx-python - Versions diffs - 0.6.3__tar.gz → 0.6.5__tar.gz - Mend

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain-agentx-python
-Version: 0.6.3
+Version: 0.6.5
 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__ = "0.6.3"
+__version__ = "0.6.5"
 from .loop import (  # noqa: F401
     create_loop_agent,

@@ -137,6 +137,26 @@ class AgentLoopConfig:
     # -----------------------------------------------------------------------
     debug: bool = False
     headless: bool | None = None
+    # permission_mode 双生命周期说明：
+    #
+    # [Compile-time] AgentLoopConfig.permission_mode 是编译期快照，用于
+    #   - 子代理派生时的初始值继承（父代理 configurable → 子代理 config）
+    #   - _FlatLoopConfig.loop_config.permission_mode（只读，运行期不可变）
+    #
+    # [Runtime]   configurable["permission_mode"] 是运行期权威值，用于
+    #   - AutoModeAuthHook._get_permission_mode()（只从此路径读取）
+    #   - PolicyEngine.decide() 的动态权限模式切换
+    #   - 用户通过 graph.with_config({"configurable": {"permission_mode": "auto"}}) 切换
+    #
+    # 切换规则：运行期 configurable 优先于编译期 config.permission_mode。
+    #   - 每次工具调用时，AutoModeAuthHook 从 configurable["permission_mode"] 读取
+    #   - 若需切换权限模式，使用 agent.invoke(..., config={"configurable": {"permission_mode": "..."}})
+    #
+    # 禁止：运行期直接修改 _FlatLoopConfig.permission_mode（会触发 AttributeError）。
+    #
+    # 参见：langchain_agentx/loop/graph/factory.py _FlatLoopConfig.__setattr__
+    #       langchain_agentx/tool_runtime/auto_mode/hook.py _get_permission_mode()
     permission_mode: str = "default"
     network_access_allowed: bool = True
     enable_session_memory: bool = False

@@ -197,10 +197,45 @@ class _FlatLoopConfig:
     因此不能用普通 dict。本类提供属性访问接口。
     __getattr__ 对缺失字段返回 None，与 legacy dataclass 行为对齐。
+    ═══════════════════════════════════════════════════════════════════════
+    permission_mode 双生命周期（重要）
+    ═══════════════════════════════════════════════════════════════════════
+    [Compile-time] _FlatLoopConfig.permission_mode 是编译期快照：
+        - 用途：子代理派生时的初始值继承（父代理 → 子代理）
+        - 特性：只读，运行期不可变（__setattr__ 拦截）
+        - 来源：AgentLoopConfig.permission_mode → _flatten_config_for_runtime()
+    [Runtime]   configurable["permission_mode"] 是运行期权威值：
+        - 用途：AutoModeAuthHook._get_permission_mode()（唯一读源）
+        - 切换：agent.invoke(..., config={"configurable": {"permission_mode": "auto"}})
+        - 特性：每次工具调用时从 configurable 读取最新值
+    切换规则：运行期 configurable 优先于编译期 config.permission_mode。
+        - AutoModeAuthHook 只从 configurable["permission_mode"] 读取
+        - 禁止运行期修改 _FlatLoopConfig.permission_mode（触发 AttributeError）
+    参见：
+        - langchain_agentx/tool_runtime/auto_mode/hook.py _get_permission_mode()
+        - langchain_agentx/loop/config/loop_config.py permission_mode 字段注释
+    ═══════════════════════════════════════════════════════════════════════
     """
+    _FROZEN_AFTER_INIT = False
     def __init__(self, **kwargs: Any) -> None:
-        self._data = kwargs
+        object.__setattr__(self, "_data", kwargs)
+        object.__setattr__(self, "_FROZEN_AFTER_INIT", True)
+    def __setattr__(self, name: str, value: Any) -> None:
+        if getattr(self, "_FROZEN_AFTER_INIT", False) and name != "_data":
+            raise AttributeError(
+                f"_FlatLoopConfig is internal and immutable. "
+                f"To change runtime fields like permission_mode, use "
+                f'graph.with_config({{"configurable": {{"permission_mode": "..."}}}}). '
+                f"Attempted to set: {name}"
+            )
+        object.__setattr__(self, name, value)
     def __getattr__(self, name: str) -> Any:
         # 返回 None 而非抛出异常，与 legacy dataclass 行为对齐

@@ -382,19 +382,18 @@ class AutoModeAuthHook:
     def _get_permission_mode(self, ctx: "ToolExecutionContext") -> str:
         """获取当前权限模式。
-        读取顺序：loop_config.permission_mode → configurable.permission_mode → "default"
+        权威读源：configurable["permission_mode"]（运行期可变）。
+        adapter.py 每次工具调用都会从 configurable["permission_mode"] 注入到
+        tool_flags["permission_mode"]，因此本函数只信任 configurable 这条路径。
+        loop_config.permission_mode 仅作为 compile-time 初始快照存在，用于
+        子代理派生时的继承。运行期切换应通过 graph.with_config() 更新
+        configurable，而非 mutate loop_config。
         """
-        # 从 runnable_config 获取 permission_mode
         if ctx.runnable_config is not None:
             configurable = getattr(ctx.runnable_config, "configurable", {})
             if isinstance(configurable, dict):
-                # 优先从 loop_config 读取
-                loop_config = configurable.get("loop_config")
-                if loop_config is not None:
-                    mode = getattr(loop_config, "permission_mode", None)
-                    if isinstance(mode, str):
-                        return mode
-                # 兜底：直接从 configurable 读取（兼容旧版配置）
                 return configurable.get("permission_mode", "default")
         return "default"

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

langchain-agentx-python 0.6.3__tar.gz → 0.6.5__tar.gz

langchain-agentx-python 0.6.3tar.gz → 0.6.5tar.gz