langchain-agentx-python 0.4.7__tar.gz → 0.4.8__tar.gz

{langchain-agentx-python-0.4.7 → langchain-agentx-python-0.4.8}/PKG-INFO

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

{langchain-agentx-python-0.4.7 → langchain-agentx-python-0.4.8}/langchain_agentx/__init__.py

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

{langchain-agentx-python-0.4.7 → langchain-agentx-python-0.4.8}/langchain_agentx/tool_runtime/auto_mode/hook.py

@@ -8,9 +8,10 @@ tool_runtime/auto_mode/hook.py — Auto Mode Auth Hook
 链路位置：
     PolicyEngine.decide() → AutoModeAuthHook() → HookResult.permission_behavior
 
-当前裁剪范围（Phase 2）：
+当前裁剪范围（Phase 2 + Phase 4 SDK）：
     - 实现 L1 工具白名单 + L3 Bash 启发式 + L4 LLM 分类器
     - L2 acceptEdits fast-path 留空（后续扩展）
+    - 事件发射：AutoModeDecisionEvent 通过 event_bus 下发（Phase 4 SDK）
 
 CC 源码对照：
     - src/utils/permissions/permissions.ts:540-700（决策入口）
@@ -30,6 +31,7 @@ from .decision import (
     _passthrough,
 )
 from .state import get_auto_mode_state
+from .events import AutoModeDecisionEvent
 
 if TYPE_CHECKING:
     from .allowlist import SafeToolAllowlist
@@ -87,6 +89,89 @@ class AutoModeAuthHook:
         self._tool_registry = tool_registry
         self._event_bus = event_bus
 
+    def _emit_event(
+        self,
+        decision: AutoModeDecision,
+        tool_name: str,
+        tool_input: dict[str, Any],
+        ctx: "ToolExecutionContext",
+    ) -> None:
+        """安全地发射决策事件到 event_bus。
+
+        Args:
+            decision: Auto Mode 决策结果
+            tool_name: 工具名称
+            tool_input: 工具输入
+            ctx: 工具执行上下文
+        """
+        if self._event_bus is None:
+            return
+
+        try:
+            event = AutoModeDecisionEvent.from_decision(
+                decision=decision,
+                tool_name=tool_name,
+                tool_input_preview=self._build_input_preview(tool_name, tool_input),
+                session_id=self._get_session_id(ctx),
+                tool_use_id=self._get_tool_use_id(ctx),
+            )
+            self._event_bus.emit(event)
+        except Exception:
+            # 事件发射失败不应影响主流程
+            import logging
+            logger = logging.getLogger(__name__)
+            logger.debug("Failed to emit AutoModeDecisionEvent", exc_info=True)
+
+    def _build_input_preview(self, tool_name: str, tool_input: dict[str, Any]) -> str:
+        """构建工具输入预览（脱敏）。
+
+        Args:
+            tool_name: 工具名称
+            tool_input: 工具输入
+
+        Returns:
+            脱敏后的输入预览字符串
+        """
+        import json
+
+        preview = json.dumps(tool_input, ensure_ascii=False, default=str)
+        # 限制长度，避免事件过大
+        if len(preview) > 500:
+            preview = preview[:500] + "..."
+        return preview
+
+    def _get_session_id(self, ctx: "ToolExecutionContext") -> str | None:
+        """获取会话 ID。
+
+        Args:
+            ctx: 工具执行上下文
+
+        Returns:
+            会话 ID 或 None
+        """
+        if hasattr(ctx, "session_id"):
+            return ctx.session_id
+        # 尝试从 state 中获取
+        if hasattr(ctx, "state") and isinstance(ctx.state, dict):
+            return ctx.state.get("session_id")
+        return None
+
+    def _get_tool_use_id(self, ctx: "ToolExecutionContext") -> str | None:
+        """获取工具调用 ID。
+
+        Args:
+            ctx: 工具执行上下文
+
+        Returns:
+            工具调用 ID 或 None
+        """
+        # 尝试从 runnable_config 中获取
+        if ctx.runnable_config is not None:
+            configurable = getattr(ctx.runnable_config, "configurable", {})
+            if isinstance(configurable, dict):
+                return configurable.get("tool_use_id")
+        return None
+
     @property
     def enabled(self) -> bool:
         """检查 Auto Mode 是否启用。"""
@@ -114,22 +199,27 @@ class AutoModeAuthHook:
         # 检查是否启用 auto mode
         permission_mode = self._get_permission_mode(ctx)
         if not self.enabled or permission_mode != "auto":
-            return _passthrough(elapsed_ms=_ms_since(start_time))
+            decision = _passthrough(elapsed_ms=_ms_since(start_time))
+            self._emit_event(decision, tool_name, tool_input, ctx)
+            return decision
 
         # L1: 工具白名单
         if self._allowlist.contains(tool_name):
-            return _allow(
+            decision = _allow(
                 layer="L1",
                 reason=AutoModeReason.ALLOWLIST,
                 matched_pattern=tool_name,
                 elapsed_ms=_ms_since(start_time),
             )
+            self._emit_event(decision, tool_name, tool_input, ctx)
+            return decision
 
         # L3: Bash 启发式
         if tool_name == "bash":
             bash_decision = await self._decide_bash(tool_input, start_time)
             # L3 allow 则直接返回，miss 则继续到 L4
             if bash_decision.behavior == "allow":
+                self._emit_event(bash_decision, tool_name, tool_input, ctx)
                 return bash_decision
             # L3 miss（behavor == "ask"），继续到 L4
 
@@ -138,16 +228,19 @@ class AutoModeAuthHook:
             llm_decision = await self._decide_llm(tool_name, tool_input, ctx, start_time)
             # L4 给出明确判断，直接返回
             if llm_decision.behavior in ("allow", "deny"):
+                self._emit_event(llm_decision, tool_name, tool_input, ctx)
                 return llm_decision
             # L4 不可用（behavior == "ask"），继续到 L5
 
         # L5: 兜底 ask
-        return _ask(
+        decision = _ask(
             layer="L5",
             reason=AutoModeReason.NOT_IN_FAST_PATH,
             explanation="Operation not in fast-path, requires user approval",
             elapsed_ms=_ms_since(start_time),
         )
+        self._emit_event(decision, tool_name, tool_input, ctx)
+        return decision
 
     async def _decide_bash(
         self,

{langchain-agentx-python-0.4.7 → langchain-agentx-python-0.4.8}/langchain_agentx_python.egg-info/PKG-INFO

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

{langchain-agentx-python-0.4.7 → langchain-agentx-python-0.4.8}/pyproject.toml

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