langchain-agentx-python 1.0.4__tar.gz → 1.0.7__tar.gz

{langchain-agentx-python-1.0.4 → langchain-agentx-python-1.0.7}/PKG-INFO

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

{langchain-agentx-python-1.0.4 → langchain-agentx-python-1.0.7}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.0.4 → langchain-agentx-python-1.0.7}/langchain_agentx/loop/config/loop_config.py

@@ -251,6 +251,7 @@ class AgentLoopConfig:
     # -----------------------------------------------------------------------
     task_notification_max_priority: QueuePriority = QueuePriority.NEXT
     managed_rules: str | None = None
+    claude_md_excludes: tuple[str, ...] = ()
 
     # -----------------------------------------------------------------------
     # 模型 profile

{langchain-agentx-python-1.0.4 → langchain-agentx-python-1.0.7}/langchain_agentx/loop/context/__init__.py

@@ -3,6 +3,12 @@
 from __future__ import annotations
 
 from .blocking_guard import CompactionBlockingGuard, default_compaction_blocking_guard
+from .query_source import (
+    LoopCompilationContext,
+    QuerySource,
+    QuerySourcePolicy,
+    default_query_source_policy,
+)
 from .compaction_service import LoopContextCompaction, default_loop_context_compaction
 from .pipeline import ContextPipeline, DefaultCompactionStages
 from .settings import (
@@ -59,8 +65,12 @@ __all__ = [
     "get_compact_prompt",
     "get_compact_user_summary_message",
     "get_partial_compact_prompt",
+    "LoopCompilationContext",
     "LoopContextCompaction",
     "MicrocompactStage",
+    "QuerySource",
+    "QuerySourcePolicy",
+    "default_query_source_policy",
     "set_active_compaction_settings",
     "SnipCompactStage",
     "StageResult",

langchain-agentx-python-1.0.7/langchain_agentx/loop/context/query_source.py

@@ -0,0 +1,161 @@
+"""
+query_source 守卫策略（Compaction / Fork / UI 路由）。
+
+职责：
+    autocompact / microcompact / token_blocking / persist_replacements 的统一跳过判定。
+
+链路位置：
+    ForkedAgentRunner / Loop 编译 → QuerySourcePolicy.compile_loop_context()
+    → ContextCompactionContext / CompactionSettings / model_node 守卫。
+
+当前裁剪范围：
+    常量定义在 loop.exit.query_source（对齐 CC constants/querySource.ts）；
+    本模块仅承载与 compaction 相关的策略类。
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Final, FrozenSet, Literal
+
+from langchain_agentx.loop.exit.query_source import QuerySource
+
+CompactionGuardStage = Literal[
+    "autocompact",
+    "microcompact",
+    "token_blocking",
+    "persist_replacements",
+]
+
+EmitterRoute = Literal["main", "sidechain", "drop"]
+
+# 后台 fork 任务：跳过 autocompact / microcompact
+_BACKGROUND_COMPACTION_SKIP: Final[FrozenSet[str]] = frozenset(
+    {
+        QuerySource.EXTRACT_MEMORIES,
+        QuerySource.SESSION_MEMORY,
+        QuerySource.COMPACT,
+        QuerySource.AGENT_SUMMARY,
+    }
+)
+
+# token_blocking 跳过（agent_summary 仍启用）
+_TOKEN_BLOCKING_SKIP: Final[FrozenSet[str]] = frozenset(
+    {
+        QuerySource.EXTRACT_MEMORIES,
+        QuerySource.SESSION_MEMORY,
+        QuerySource.COMPACT,
+    }
+)
+
+
+@dataclass(frozen=True)
+class LoopCompilationContext:
+    """子 Loop 编译时的 query_source 守卫快照。"""
+
+    query_source: str
+    skip_autocompact: bool
+    skip_microcompact: bool
+    skip_token_blocking: bool
+    persist_replacements: bool
+
+    @property
+    def skip_compaction_stages(self) -> bool:
+        return self.skip_autocompact or self.skip_microcompact
+
+
+class QuerySourcePolicy:
+    """query_source 守卫策略（单一来源）。"""
+
+    @staticmethod
+    def microcompact_skip_sources() -> FrozenSet[str]:
+        return _BACKGROUND_COMPACTION_SKIP
+
+    @staticmethod
+    def autocompact_skip_sources() -> FrozenSet[str]:
+        return _BACKGROUND_COMPACTION_SKIP
+
+    @staticmethod
+    def token_blocking_skip_sources() -> FrozenSet[str]:
+        return _TOKEN_BLOCKING_SKIP
+
+    @staticmethod
+    def should_persist_replacements(query_source: str | None) -> bool:
+        normalized = QuerySource.normalize(query_source)
+        if QuerySource.is_agent_subagent(normalized):
+            return True
+        return normalized == QuerySource.MAIN_THREAD
+
+    @classmethod
+    def should_skip(cls, stage: CompactionGuardStage, query_source: str | None) -> bool:
+        normalized = QuerySource.normalize(query_source)
+        if stage == "autocompact":
+            return normalized in cls.autocompact_skip_sources()
+        if stage == "microcompact":
+            return normalized in cls.microcompact_skip_sources()
+        if stage == "token_blocking":
+            return normalized in cls.token_blocking_skip_sources()
+        if stage == "persist_replacements":
+            return not cls.should_persist_replacements(normalized)
+        raise ValueError(f"unknown compaction guard stage: {stage}")
+
+    @classmethod
+    def compile_loop_context(cls, query_source: str | None) -> LoopCompilationContext:
+        normalized = QuerySource.normalize(query_source)
+        return LoopCompilationContext(
+            query_source=normalized,
+            skip_autocompact=cls.should_skip("autocompact", normalized),
+            skip_microcompact=cls.should_skip("microcompact", normalized),
+            skip_token_blocking=cls.should_skip("token_blocking", normalized),
+            persist_replacements=cls.should_persist_replacements(normalized),
+        )
+
+    @classmethod
+    def is_main_repl_thread(cls, query_source: str | None) -> bool:
+        """对齐 CC querySource === 'repl_main_thread'；缺省 / None 视为 main。"""
+        normalized = QuerySource.normalize(query_source)
+        if normalized == QuerySource.MAIN_THREAD:
+            return True
+        return normalized == "repl_main_thread" or normalized.startswith("repl_main_thread:")
+
+    @classmethod
+    def default_ui_visible(cls, query_source: str | None) -> bool:
+        normalized = QuerySource.normalize(query_source)
+        if normalized == QuerySource.MAIN_THREAD:
+            return True
+        if QuerySource.is_agent_subagent(normalized):
+            return True
+        return False
+
+    @classmethod
+    def resolve_emitter_route(
+        cls,
+        *,
+        query_source: str | None,
+        skip_transcript: bool,
+    ) -> EmitterRoute:
+        if skip_transcript:
+            return "drop"
+        if cls.default_ui_visible(query_source):
+            return "main"
+        return "sidechain"
+
+
+_default_policy: QuerySourcePolicy | None = None
+
+
+def default_query_source_policy() -> QuerySourcePolicy:
+    global _default_policy
+    if _default_policy is None:
+        _default_policy = QuerySourcePolicy()
+    return _default_policy
+
+
+__all__ = [
+    "CompactionGuardStage",
+    "EmitterRoute",
+    "LoopCompilationContext",
+    "QuerySource",
+    "QuerySourcePolicy",
+    "default_query_source_policy",
+]

{langchain-agentx-python-1.0.4 → langchain-agentx-python-1.0.7}/langchain_agentx/loop/context/settings.py

@@ -19,6 +19,7 @@ from dataclasses import dataclass, field
 from typing import FrozenSet
 
 from ..prompt.compact import AutocompactLlmPromptKind
+from .query_source import QuerySourcePolicy
 
 
 @dataclass(frozen=True)
@@ -52,13 +53,13 @@ class CompactionSettings:
     snip_suffix: str = field(default="\n\n[... snipped by snip_compact ...]")
     # --- microcompact（轻量规范化；递归压缩时跳过）---
     microcompact_skip_query_sources: FrozenSet[str] = field(
-        default_factory=lambda: frozenset({"compact"})
+        default_factory=QuerySourcePolicy.microcompact_skip_sources
     )
     # --- context_collapse（重复 tool 结果治理）---
     collapse_dedupe_consecutive_same_tool_call_id: bool = True
     # --- autocompact（阈值触发；产品与 CC 对齐默认走 LLM 摘要，无 model 时回退 prune）---
     autocompact_skip_query_sources: FrozenSet[str] = field(
-        default_factory=lambda: frozenset({"compact"})
+        default_factory=QuerySourcePolicy.autocompact_skip_sources
     )
     autocompact_use_llm_when_available: bool = True
     autocompact_llm_excerpt_chars_per_message: int = 20_000

{langchain-agentx-python-1.0.4 → langchain-agentx-python-1.0.7}/langchain_agentx/loop/exit/exit_logic.py

@@ -25,6 +25,8 @@ from typing import Any, NotRequired, TypedDict
 
 from langchain_core.messages import AIMessage
 
+from .query_source import QuerySource
+
 from .resolution import LoopResolution
 from .terminal import LoopTerminal
 
@@ -219,6 +221,7 @@ def create_initial_state(
         "finish_reason": None,
         "finish_reasons": [],
         "section_cache": {},
+        "query_source": QuerySource.MAIN_THREAD,
     }
 
 
@@ -264,6 +267,7 @@ class AgentLoopState(TypedDict):
     finish_reason: str | None  # Provider 协议层：这一轮 completion 为何停
     finish_reasons: list[str]  # finish_reason 历史（观测用）
     section_cache: dict[str, str | None]  # SystemPromptSection session 级缓存（key=name, value=compute() 结果）
+    query_source: NotRequired[str]  # Loop 来源标签；主 REPL 为 main_thread，Fork 子图透传
 
 
 # 状态字段契约别名（对外统一使用 LoopAgentStateFields）

langchain-agentx-python-1.0.7/langchain_agentx/loop/exit/query_source.py

@@ -0,0 +1,54 @@
+"""
+query_source 官方常量（对齐 CC constants/querySource.ts）。
+
+职责：
+    Loop 来源标签的单一字面量来源；与 compaction / fork 策略解耦。
+
+链路位置：
+    AgentLoopState 默认值（exit_logic）与各层通过 query_source 字段透传。
+
+当前裁剪范围：
+    仅常量与 normalize；守卫策略见 loop.context.query_source.QuerySourcePolicy。
+"""
+
+from __future__ import annotations
+
+from typing import Final, FrozenSet
+
+
+class QuerySource:
+    """官方 query_source 常量（禁止在业务代码散落字面量）。"""
+
+    MAIN_THREAD: Final[str] = "main_thread"
+    EXTRACT_MEMORIES: Final[str] = "extract_memories"
+    SESSION_MEMORY: Final[str] = "session_memory"
+    COMPACT: Final[str] = "compact"
+    AGENT_SUMMARY: Final[str] = "agent_summary"
+    MEMDIR_RELEVANCE: Final[str] = "memdir_relevance"
+    AGENT_PREFIX: Final[str] = "agent:"
+
+    @classmethod
+    def all_official(cls) -> FrozenSet[str]:
+        return frozenset(
+            {
+                cls.MAIN_THREAD,
+                cls.EXTRACT_MEMORIES,
+                cls.SESSION_MEMORY,
+                cls.COMPACT,
+                cls.AGENT_SUMMARY,
+                cls.MEMDIR_RELEVANCE,
+            }
+        )
+
+    @classmethod
+    def is_agent_subagent(cls, query_source: str | None) -> bool:
+        return isinstance(query_source, str) and query_source.startswith(cls.AGENT_PREFIX)
+
+    @classmethod
+    def normalize(cls, query_source: str | None) -> str:
+        if isinstance(query_source, str) and query_source.strip():
+            return query_source.strip()
+        return cls.MAIN_THREAD
+
+
+__all__ = ["QuerySource"]