langchain-agentx-python 2.4.6__py3-none-any.whl → 2.4.8__py3-none-any.whl

langchain_agentx/__init__.py

@@ -11,7 +11,7 @@ from langchain_agentx import create_loop_agent
 ```
 """
 
-__version__ = "2.4.6"
+__version__ = "2.4.8"
 
 from .mcp.call import McpToolCaller
 from .mcp.client_manager import McpClientManager, McpConnectedClient

langchain_agentx/loop/graph/factory.py

@@ -1593,13 +1593,25 @@ class LoopGraphBuilder:
             patch["compaction_pipeline_meta"] = meta
         meta["compact_progress"] = progress_events
 
+    def _clear_file_reads_after_message_compaction(self, patch: dict[str, Any]) -> None:
+        """消息被 compaction 改写后清空 last_read（对齐 CC ``readFileState.clear()``）。
+
+        防止 Read dedup 返回 file_unchanged 却断言「内容仍在本会话」（A2）。
+        """
+        if "messages" not in patch:
+            return
+        store = getattr(self, "_session_store", None)
+        clearer = getattr(store, "clear_file_read_state", None)
+        if callable(clearer):
+            clearer()
+
     def _apply_prune_and_compress(self, state: dict[str, Any]) -> dict[str, Any]:
         if self._session_memory_compact_bridge is not None:
             compacted_messages = self._session_memory_compact_bridge.try_compact(
                 list(state.get("messages") or [])
             )
             if compacted_messages is not None:
-                return {
+                patch = {
                     "messages": compacted_messages,
                     "collapse_retry_available": True,
                     "compaction_pipeline_meta": {
@@ -1607,10 +1619,13 @@ class LoopGraphBuilder:
                         "session_memory_compaction": "applied",
                     },
                 }
+                self._clear_file_reads_after_message_compaction(patch)
+                return patch
         patch = self._loop_context_compaction.run(state, model=self._model)
         compaction_meta = patch.get("compaction_pipeline_meta")
         if isinstance(compaction_meta, dict):
             patch["collapse_retry_available"] = bool(compaction_meta.get("tokens_freed_sum", 0))
+        self._clear_file_reads_after_message_compaction(patch)
         return patch
 
     async def _apply_prune_and_compress_async(self, state: dict[str, Any]) -> dict[str, Any]:
@@ -1619,7 +1634,7 @@ class LoopGraphBuilder:
                 list(state.get("messages") or [])
             )
             if compacted_messages is not None:
-                return {
+                patch = {
                     "messages": compacted_messages,
                     "collapse_retry_available": True,
                     "compaction_pipeline_meta": {
@@ -1627,6 +1642,8 @@ class LoopGraphBuilder:
                         "session_memory_compaction": "applied",
                     },
                 }
+                self._clear_file_reads_after_message_compaction(patch)
+                return patch
         progress_events: list[dict[str, Any]] = []
         seen_progress = False
 
@@ -1660,6 +1677,7 @@ class LoopGraphBuilder:
         compaction_meta = patch.get("compaction_pipeline_meta")
         if isinstance(compaction_meta, dict):
             patch["collapse_retry_available"] = bool(compaction_meta.get("tokens_freed_sum", 0))
+        self._clear_file_reads_after_message_compaction(patch)
         return patch
 
     def _run_prune_and_compress_with_trace(self, state: dict[str, Any]) -> dict[str, Any]:

langchain_agentx/loop/subagent/context.py

@@ -117,6 +117,8 @@ class SubagentContext:
     loop_compilation_context: LoopCompilationContext | None = None
     can_use_tool: Callable[[str, dict[str, Any]], bool] | None = None
     register_transcript: bool = True
+    transcript_store: Any | None = None
+    """可选落盘后端；None → runner 使用 InMemoryTranscriptStore。Workflow 注入 workflows/<runId>/。"""
 
     # Thinking 控制字段（request-side 生成意图，与 UI 展示意图分离）
     thinking_generation_enabled: bool = True  # 子代理 request-side thinking 生成开关

langchain_agentx/loop/subagent/runner.py

@@ -864,7 +864,7 @@ async def _run_subagent_body(
     resolved_model = _resolve_subagent_model(ctx, model)
 
     if ctx.register_transcript and ctx.agent_id:
-        store = InMemoryTranscriptStore()
+        store = getattr(ctx, "transcript_store", None) or InMemoryTranscriptStore()
         transcript: SubagentTranscriptManager | NoOpTranscriptManager = SubagentTranscriptManager(
             store=store,
             agent_id=ctx.agent_id,

langchain_agentx/tool_runtime/errors.py

@@ -20,7 +20,6 @@ from typing import Literal
 
 from .limits import ERROR_TRUNCATE_HALF, ERROR_TRUNCATE_THRESHOLD
 from .messages import (
-    DENIAL_WORKAROUND_GUIDANCE,
     INTERRUPT_MESSAGE_FOR_TOOL_USE,
     auto_reject_message,
 )
@@ -68,10 +67,6 @@ def truncate_error_text(text: str) -> str:
     return _DEFAULT_TRUNCATOR.truncate(text)
 
 
-def _llm_summary_already_formatted(message: str) -> bool:
-    return "STOP and explain" in message or DENIAL_WORKAROUND_GUIDANCE in message
-
-
 # ---------------------------------------------------------------------------
 # 框架级异常类型
 # ---------------------------------------------------------------------------
@@ -236,12 +231,13 @@ def blocked_envelope(
     """
     构造 status="blocked" 的 ToolResultEnvelope。
 
-    check_permissions() 返回 deny 时由 pipeline 调用。
-    模型可见 summary 默认使用 AUTO_REJECT_MESSAGE；L3 已格式化的拒因可经 llm_summary 透传。
+    对齐 CC ``permissionDecision.message → tool_result content``：
+    模型可见 summary 优先使用决策拒因（message / llm_summary）；
+    仅当拒因空时回退 AUTO_REJECT_MESSAGE（与 CC headless 无细文案时一致）。
     """
     if llm_summary is not None:
         summary_text = truncate_error_text(llm_summary)
-    elif _llm_summary_already_formatted(message):
+    elif isinstance(message, str) and message.strip():
         summary_text = truncate_error_text(message)
     else:
         summary_text = truncate_error_text(auto_reject_message(tool_name))

langchain_agentx/tool_runtime/loader.py

@@ -96,10 +96,11 @@ class ToolRuntimeLoader:
         agent_home_segment: str = ".langchain_agentx",
         include_agent: bool = True,
         include_skill: bool = False,
+        include_workflow: bool = False,
         agent_registry: Any | None = None,
     ) -> "ToolRuntimeLoader":
         """
-        注册默认工具集（Read/Grep/Glob/Bash + 可选 Agent/Skill）。
+        注册默认工具集（Read/Grep/Glob/Bash + 可选 Agent/Skill/Workflow）。
 
         向后兼容：在 loader 自身 registry 上注册（单 loop 模式）。
         create_loop_agent 应优先使用 ``spawn_loop_loader`` 获得 per-loop 隔离。
@@ -109,6 +110,7 @@ class ToolRuntimeLoader:
             agent_home_segment: agent home 子目录名（如 .claude、.cursor）
             include_agent: 是否包含 Agent 工具
             include_skill: 是否包含 Skill 工具
+            include_workflow: 是否包含 Workflow 工具（默认 False，结项前不进默认池）
             agent_registry: 可选的自定义 agent 注册表
         """
         loop = self.spawn_loop_loader(
@@ -118,6 +120,7 @@ class ToolRuntimeLoader:
         loop.register_default_tools(
             include_agent=include_agent,
             include_skill=include_skill,
+            include_workflow=include_workflow,
             agent_registry=agent_registry,
         )
         for tool in loop.registry.list():

langchain_agentx/tool_runtime/loop_loader.py

@@ -86,6 +86,7 @@ class LoopLoader:
         *,
         include_agent: bool = True,
         include_skill: bool = False,
+        include_workflow: bool = False,
         agent_registry: Any | None = None,
     ) -> "LoopLoader":
         from pathlib import Path
@@ -198,6 +199,11 @@ class LoopLoader:
                 )
             )
 
+        if include_workflow:
+            from langchain_agentx.tools.workflow import WorkflowRuntimeTool
+
+            self.register(WorkflowRuntimeTool(config=cfg))
+
         return self
 
     def attach_mcp(

langchain_agentx/tool_runtime/session_store.py

@@ -163,6 +163,14 @@ class AgentSessionStore:
         """用与 LangGraph state 中 last_read 条目同构的 dict 覆盖该路径。"""
         self._file_read_state[path] = FileReadRecord.from_bridge_dict(path, entry)
 
+    def clear_file_read_state(self) -> None:
+        """清空文件读缓存（对齐 CC ``readFileState.clear()`` on compact）。
+
+        compaction 蒸发消息后若不清理，Read dedup 会返回 ``file_unchanged`` stub
+        却断言「内容仍在本会话」（BUG-20261107-28 A2）。
+        """
+        self._file_read_state.clear()
+
     def replace_all_file_reads_from_bridge_map(self, data: dict[str, Any]) -> None:
         """整体替换文件读映射（对应 ToolStateBridge.set_last_read_map）。"""
         self._file_read_state.clear()