langchain-agentx-python 1.1.7__tar.gz → 1.1.8__tar.gz

{langchain-agentx-python-1.1.7/langchain_agentx_python.egg-info → langchain-agentx-python-1.1.8}/PKG-INFO

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

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/loop/config/__init__.py

@@ -13,6 +13,7 @@ from .interaction_profile import (
     normalize_config,
     sanity_check_profile,
 )
+from .loop_runtime_overlay import LoopRuntimeOverlay
 from .model_context_resolver import ModelContextResolver
 from .token_estimator import TokenEstimator
 from .runtime_settings import (
@@ -32,6 +33,7 @@ __all__ = [
     "assemble_services",
     "normalize_config",
     "sanity_check_profile",
+    "LoopRuntimeOverlay",
     "ModelContextResolver",
     "TokenEstimator",
     "build_agent_config",

langchain-agentx-python-1.1.8/langchain_agentx/loop/config/loop_runtime_overlay.py

@@ -0,0 +1,66 @@
+"""
+loop_runtime_overlay.py — L4 graph_factory 运行期 overlay（IF-G6）
+
+职责：
+    统一三 L4 工厂 graph_factory 的可变字段；禁止 overlay permission / container 剖面。
+
+链路位置：
+    create_agent_session / create_conversation_session / make_workflow_graph_factory
+    → graph_factory(overlay) → apply_to(AgentLoopConfig) → create_loop_agent
+
+当前裁剪范围：
+    仅 session_id、trace 父链、subagent 标记、capabilities、enable_trace；不含 container_type。
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, replace
+from typing import Any, Callable
+
+from langchain_agentx.loop.config.loop_config import AgentLoopConfig
+
+
+@dataclass(frozen=True)
+class LoopRuntimeOverlay:
+    """运行期 overlay：per-invoke 字段，不含 permission / container_type。"""
+
+    session_id: str | None = None
+    enable_trace: bool | None = None
+    capabilities: Any = None
+    parent_conversation_session_id: str | None = None
+    is_subagent: bool | None = None
+
+    def apply_to(self, base: AgentLoopConfig) -> AgentLoopConfig:
+        """把 overlay 合并到静态 config（不触碰 container_type / permission_mode）。"""
+        cfg = base
+        if self.session_id is not None:
+            cfg = replace(cfg, session_id=self.session_id)
+
+        trace = cfg.trace
+        trace_changed = False
+        if self.enable_trace is not None:
+            trace = replace(trace, enabled=self.enable_trace)
+            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
+        if trace_changed:
+            cfg = replace(cfg, trace=trace)
+
+        if self.is_subagent is not None:
+            cfg = replace(
+                cfg,
+                subagent=replace(cfg.subagent, is_subagent=self.is_subagent),
+            )
+        return cfg
+
+
+ConversationGraphFactory = Callable[[LoopRuntimeOverlay], Any]
+AgentGraphFactory = Callable[..., Any]
+"""AgentSession：``(overlay, *, active_files_getter=...)``。"""
+
+__all__ = [
+    "LoopRuntimeOverlay",
+    "ConversationGraphFactory",
+    "AgentGraphFactory",
+]

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/session/agent_session.py

@@ -44,6 +44,7 @@ from .recovery import (
     finish_outcome_from_stream_driver_result,
     run_with_recovery_loop,
 )
+from ..loop.config.loop_runtime_overlay import LoopRuntimeOverlay
 from ..loop.context.compaction_service import default_loop_context_compaction
 from ..loop.context.message_utils import total_estimated_tokens_for_messages
 from ..loop.hook.types import HookContext, HookEvent
@@ -455,10 +456,11 @@ class AgentSession:
             raise RuntimeError("AgentSession requires either graph or graph_factory")
         getter = lambda: list(self._active_files)
         return self._graph_factory(
+            LoopRuntimeOverlay(
+                enable_trace=self._enable_trace,
+                capabilities=self._capabilities,
+            ),
             active_files_getter=getter,
-            container_type=self._container_type,
-            enable_trace=self._enable_trace,
-            capabilities=self._capabilities,
         )
 
     def _append_transcript_message(self, message: Any) -> None:

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/session/conversation_factory.py

@@ -8,8 +8,7 @@ session/conversation_factory.py — ConversationSession 入口工厂。
     作为 Web/IM 对话场景创建 ConversationSession 的便捷入口。
 
 当前裁剪范围：
-    仅覆盖基础参数透传，不包含 HTTP 框架集成。
-    Phase 3.5：移除 translator，全面 config-first。
+    强制 qa-auto 剖面（conversation + auto + headless）；不含 HTTP 框架集成。
 """
 
 from __future__ import annotations
@@ -23,7 +22,9 @@ from uuid import uuid4
 from langchain_core.messages import BaseMessage
 from langchain_core.language_models.chat_models import BaseChatModel
 
+from langchain_agentx.loop.config.interaction_profile import normalize_config
 from langchain_agentx.loop.config.loop_config import AgentLoopConfig, LoopServices
+from langchain_agentx.loop.config.loop_runtime_overlay import LoopRuntimeOverlay
 from langchain_agentx.loop.graph.factory import create_loop_agent
 from langchain_agentx.loop.hook import HookEngine, HooksConfigSnapshot, HookRegistry, WorkspaceTrustChecker
 from langchain_agentx.workspace import resolve_agent_state_config
@@ -35,39 +36,23 @@ def create_conversation_session(
     *,
     config: AgentLoopConfig | None = None,
     services: LoopServices | None = None,
-    # —— 仅 session 级编排，与 loop 无关 ——
     conversation_id: str | None = None,
-    workspace_trust_prompter: Any | None = None,  # P2: 添加 trust prompter 支持
+    workspace_trust_prompter: Any | None = None,
     hook_engine: Any | None = None,
     initial_messages: list[BaseMessage] | None = None,
 ) -> ConversationSession:
-    """创建 config-first 风格的 ConversationSession。
-
-    Args:
-        model: 模型
-        config: AgentLoopConfig 配置，为 None 时使用默认值
-        services: LoopServices 服务，为 None 时使用默认值
-        conversation_id: 会话 ID，为 None 时自动生成
-        workspace_trust_prompter: workspace 信任确认回调（Web/IM 场景可选）
-        hook_engine: 显式注入的 HookEngine，为 None 时从 services.hooks 推导
-        initial_messages: 初始消息列表
-
-    Returns:
-        配置好的 ConversationSession
-    """
-    cfg = config or AgentLoopConfig()
+    """创建 config-first 风格的 ConversationSession（qa-auto L4 入口）。"""
+    cfg = _ensure_qa_auto_config(config or AgentLoopConfig())
     svcs = services or LoopServices()
 
-    # 解析 AgentWorkspaceConfig
     agent_workspace_cfg = resolve_agent_state_config(
         workspace_root=cfg.workspace.workspace_root,
         agent_home_segment=cfg.workspace.agent_home_segment,
     )
 
-    # session 级默认值推断
     cfg = _resolve_session_defaults(cfg, agent_workspace_cfg)
+    cfg = normalize_config(cfg)
 
-    # P2: workspace trust 处理（与 AgentSession 保持一致）
     workspace_trust_accepted = _resolve_workspace_trust_accepted(
         agent_workspace_cfg,
         workspace_trust_prompter,
@@ -75,30 +60,24 @@ def create_conversation_session(
     agent_workspace_cfg = replace(agent_workspace_cfg, workspace_trust_accepted=workspace_trust_accepted)
     cfg = replace(cfg, workspace=replace(cfg.workspace, workspace_trust_accepted=workspace_trust_accepted))
 
-    # conversation_id 推断
     resolved_id = conversation_id or f"conv-{uuid4().hex}"
 
-    # hook_engine 装配
     if hook_engine is None:
         snapshot = svcs.hooks.build_snapshot() if svcs.hooks is not None else HooksConfigSnapshot()
         hook_engine = HookEngine(
             snapshot,
             trust_checker=WorkspaceTrustChecker(
-                headless=False,
+                headless=True,
                 workspace_trust_accepted=workspace_trust_accepted,
             ),
         )
 
-    def _graph_factory(
-        session_id: str,
-        container_type: str = "conversation",
-        capabilities: Any = None,
-        **_ignored: Any,
-    ) -> Any:
-        # P0: 合并 runtime 注入的 session_id/container_type 到 cfg
-        runtime_cfg = replace(cfg, session_id=session_id, container_type=container_type)
-        # 合并 services 里的运行时注入（与 AgentSession 保持一致）
-        final_svcs = replace(svcs, capabilities=capabilities)
+    def _graph_factory(overlay: LoopRuntimeOverlay) -> Any:
+        runtime_cfg = overlay.apply_to(cfg)
+        final_svcs = replace(
+            svcs,
+            capabilities=overlay.capabilities if overlay.capabilities is not None else svcs.capabilities,
+        )
         return create_loop_agent(model, config=runtime_cfg, services=final_svcs)
 
     return ConversationSession(
@@ -111,31 +90,38 @@ def create_conversation_session(
     )
 
 
+def _ensure_qa_auto_config(config: AgentLoopConfig) -> AgentLoopConfig:
+    """IF-G2：Conversation 工厂强制 qa-auto 三元组静态种子。"""
+    raw = config.container_type or "conversation"
+    if raw not in ("conversation", None, ""):
+        raise ValueError(
+            f"create_conversation_session requires container_type='conversation', got {raw!r}"
+        )
+    mode = config.permission_mode
+    return replace(
+        config,
+        container_type="conversation",
+        permission_mode=mode,
+        headless=True,
+    )
+
+
 def _resolve_session_defaults(
     config: AgentLoopConfig,
     agent_workspace_cfg: Any,
 ) -> AgentLoopConfig:
-    """解析 session 级默认值。
-
-    仅做三件真正属于 session 层的事：
-    1. workspace.workspace_root 未提供时使用 AgentWorkspaceConfig 的值
-    2. conversation_session_id 推断
-    3. session_id 推断（作为 graph_factory 的默认值，会被 runtime 覆盖）
-    """
+    """解析 conversation session 级默认值。"""
     changes = {}
 
-    # workspace_root 推断
     if config.workspace.workspace_root is None:
         changes["workspace"] = replace(
             config.workspace,
             workspace_root=agent_workspace_cfg.workspace_root,
         )
 
-    # conversation_session_id 推断
     if config.conversation_session_id is None:
         changes["conversation_session_id"] = f"conv-{uuid4().hex}"
 
-    # session_id 推断（作为默认值，会被 runtime 覆盖）
     if config.session_id is None:
         changes["session_id"] = f"conv-{uuid4().hex}"
 
@@ -146,7 +132,7 @@ def _resolve_workspace_trust_accepted(
     agent_workspace_cfg: Any,
     workspace_trust_prompter: Any | None,
 ) -> bool:
-    """解析 workspace trust 状态（与 AgentSession 保持一致）。"""
+    """解析 workspace trust 状态。"""
     persisted = _read_workspace_trust_flag(agent_workspace_cfg)
     if persisted:
         return True
@@ -161,7 +147,6 @@ def _resolve_workspace_trust_accepted(
 
 
 def _read_workspace_trust_flag(agent_workspace_cfg: Any) -> bool:
-    """读取持久化的 workspace trust 标志。"""
     path = agent_workspace_cfg.workspace_config_path
     if not path.exists():
         return False
@@ -173,7 +158,6 @@ def _read_workspace_trust_flag(agent_workspace_cfg: Any) -> bool:
 
 
 def _write_workspace_trust_flag(agent_workspace_cfg: Any, *, accepted: bool) -> None:
-    """持久化 workspace trust 标志。"""
     path = agent_workspace_cfg.workspace_config_path
     path.parent.mkdir(parents=True, exist_ok=True)
     payload = {"workspace_trust_accepted": bool(accepted)}

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/session/conversation_session.py

@@ -34,6 +34,7 @@ from ..command.builtin import (
     make_memory_command,
     make_reload_plugins_command,
 )
+from ..loop.config.loop_runtime_overlay import LoopRuntimeOverlay
 from ..loop.context.compaction_service import default_loop_context_compaction
 from ..loop.context.message_utils import total_estimated_tokens_for_messages
 from ..loop.hook.types import HookContext, HookEvent
@@ -113,9 +114,10 @@ class ConversationSession:
         appended_message = HumanMessage(content=user_input)
         self._messages.append(appended_message)
         graph = self._graph_factory(
-            session_id=self._conversation_id,
-            container_type="conversation",
-            capabilities=self._capabilities,
+            LoopRuntimeOverlay(
+                session_id=self._conversation_id,
+                capabilities=self._capabilities,
+            ),
         )
         try:
             result = await graph.ainvoke(
@@ -147,9 +149,10 @@ class ConversationSession:
             from ..command.fork_executor import run_forked_slash_command
 
             graph = self._graph_factory(
-                session_id=self._conversation_id,
-                container_type="conversation",
-                capabilities=self._capabilities,
+                LoopRuntimeOverlay(
+                    session_id=self._conversation_id,
+                    capabilities=self._capabilities,
+                ),
             )
             output = await asyncio.to_thread(
                 run_forked_slash_command,
@@ -162,9 +165,10 @@ class ConversationSession:
             return {"command_result": result, "output": output}
 
         graph = self._graph_factory(
-            session_id=self._conversation_id,
-            container_type="conversation",
-            capabilities=self._capabilities,
+            LoopRuntimeOverlay(
+                session_id=self._conversation_id,
+                capabilities=self._capabilities,
+            ),
         )
         store = session_store_from_graph(graph)
         prompt = result.injected_prompt or user_input
@@ -209,9 +213,10 @@ class ConversationSession:
         appended_message = HumanMessage(content=user_input)
         self._messages.append(appended_message)
         graph = self._graph_factory(
-            session_id=self._conversation_id,
-            container_type="conversation",
-            capabilities=self._capabilities,
+            LoopRuntimeOverlay(
+                session_id=self._conversation_id,
+                capabilities=self._capabilities,
+            ),
         )
         output_messages: list[Any] | None = None
         graph_output: dict[str, Any] | None = None

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/session/factory.py

@@ -8,7 +8,7 @@ session/factory.py — AgentSession 入口工厂。
     作为上层应用（CLI/示例）创建 AgentSession 的便捷入口，底层仍复用 create_loop_agent。
 
 当前裁剪范围：
-    REPL 的 prompt_handler 由 CLI 写入 LoopServices 后传入；本模块不接收 user_ui。
+    仅 code-interactive（container_type=interactive）；REPL prompt_handler 由 CLI 写入 LoopServices。
 """
 
 from __future__ import annotations
@@ -21,7 +21,9 @@ from uuid import uuid4
 
 from langchain_core.language_models.chat_models import BaseChatModel
 
+from langchain_agentx.loop.config.interaction_profile import normalize_config
 from langchain_agentx.loop.config.loop_config import AgentLoopConfig, LoopServices, AgentStateConfig
+from langchain_agentx.loop.config.loop_runtime_overlay import LoopRuntimeOverlay
 from langchain_agentx.loop.graph.factory import create_loop_agent
 from langchain_agentx.loop.hook import HookEngine, HooksConfigSnapshot, HookRegistry, WorkspaceTrustChecker
 from langchain_agentx.loop.subagent.transcript import SubagentTranscriptStore
@@ -39,68 +41,48 @@ def create_agent_session(
     transcript_writer: SubagentTranscriptStore | None = None,
     hook_engine: Any | None = None,
 ) -> AgentSession:
-    """创建 config-first 风格的 AgentSession。
-
-    Args:
-        model: 模型
-        config: AgentLoopConfig 配置，为 None 时使用默认值
-        services: LoopServices 服务；REPL 须含 prompt_handler（CLI 侧组装）
-        workspace_trust_prompter: workspace 信任确认回调
-        transcript_writer: 子代理 transcript 写入器
-        hook_engine: 显式注入的 HookEngine，为 None 时从 services.hooks 推导
-
-    Returns:
-        配置好的 AgentSession
-    """
-    cfg = config or AgentLoopConfig()
+    """创建 config-first 风格的 AgentSession（code-interactive L4 入口）。"""
+    cfg = _ensure_code_interactive_config(config or AgentLoopConfig())
     svcs = services or LoopServices()
 
-    # 解析 AgentWorkspaceConfig（用于路径派生和 trust 持久化）
     agent_workspace_cfg = resolve_agent_state_config(
         workspace_root=cfg.workspace.workspace_root,
         agent_home_segment=cfg.workspace.agent_home_segment,
     )
 
-    # session 级默认值推断
     cfg = _resolve_session_defaults(cfg, agent_workspace_cfg)
+    cfg = normalize_config(cfg)
 
-    # workspace trust 处理
     workspace_trust_accepted = _resolve_workspace_trust_accepted(
         agent_workspace_cfg,
         workspace_trust_prompter,
     )
     agent_workspace_cfg = replace(agent_workspace_cfg, workspace_trust_accepted=workspace_trust_accepted)
-
-    # 同步 workspace_trust_accepted 到 config.workspace
     cfg = replace(cfg, workspace=replace(cfg.workspace, workspace_trust_accepted=workspace_trust_accepted))
 
-    # hook_engine 装配
     if hook_engine is None:
         snapshot = svcs.hooks.build_snapshot() if svcs.hooks is not None else HooksConfigSnapshot()
         hook_engine = HookEngine(
             snapshot,
             trust_checker=WorkspaceTrustChecker(
-                headless=cfg.headless or False,
+                headless=bool(cfg.headless),
                 workspace_trust_accepted=workspace_trust_accepted,
             ),
         )
 
-    # session_id（已由 _resolve_session_defaults 填充）
     session_id = cfg.session_id
 
     def _graph_factory(
+        overlay: LoopRuntimeOverlay,
+        *,
         active_files_getter: Any = None,
-        capabilities: Any = None,
-        container_type: str | None = None,
-        enable_trace: bool | None = None,
-        **_ignored: Any,
     ):
-        runtime_cfg = cfg
-        if container_type is not None and container_type != cfg.container_type:
-            runtime_cfg = replace(runtime_cfg, container_type=container_type)
-        if enable_trace is not None and enable_trace != cfg.trace.enabled:
-            runtime_cfg = replace(runtime_cfg, trace=replace(runtime_cfg.trace, enabled=enable_trace))
-        final_svcs = replace(svcs, active_files_getter=active_files_getter, capabilities=capabilities)
+        runtime_cfg = overlay.apply_to(cfg)
+        final_svcs = replace(
+            svcs,
+            active_files_getter=active_files_getter,
+            capabilities=overlay.capabilities if overlay.capabilities is not None else svcs.capabilities,
+        )
         return create_loop_agent(model, config=runtime_cfg, services=final_svcs)
 
     return AgentSession(
@@ -110,53 +92,42 @@ def create_agent_session(
         workspace_cfg=agent_workspace_cfg,
         hook_engine=hook_engine,
         transcript_writer=transcript_writer,
-        container_type=cfg.container_type or "interactive",
+        container_type=cfg.container_type,
         enable_trace=cfg.trace.enabled,
         capabilities=svcs.capabilities,
     )
 
 
+def _ensure_code_interactive_config(config: AgentLoopConfig) -> AgentLoopConfig:
+    """IF-G7：AgentSession 仅服务 code-interactive；禁止 worker/qa 剖面混入。"""
+    raw = config.container_type or "interactive"
+    if raw != "interactive":
+        raise ValueError(
+            f"create_agent_session requires container_type='interactive' (code-interactive), "
+            f"got {raw!r}; use create_conversation_session or make_workflow_graph_factory"
+        )
+    return replace(config, container_type="interactive")
+
+
 def _resolve_session_defaults(
     config: AgentLoopConfig,
     agent_workspace_cfg: Any,
 ) -> AgentLoopConfig:
-    """解析 session 级默认值。
-
-    仅做三件真正属于 session 层的事：
-    1. session_id 未提供时生成
-    2. workspace.workspace_root 未提供时使用 AgentWorkspaceConfig 的值
-    3. headless 推断
-    """
+    """解析 session 级默认值（interactive 专用）。"""
     changes = {}
 
-    # session_id 推断
     if config.session_id is None:
         changes["session_id"] = f"session-{uuid4().hex}"
 
-    # workspace_root 推断：如果 config.workspace.workspace_root 为 None，
-    # 使用 agent_workspace_cfg.workspace_root（已通过 resolve_agent_state_config 解析）
     if config.workspace.workspace_root is None:
         changes["workspace"] = replace(
             config.workspace,
             workspace_root=agent_workspace_cfg.workspace_root,
         )
 
-    # headless 推断：worker 类强制 True；interactive 留 None 由 create_loop_agent 规范化
-    if config.headless is None:
-        inferred = _infer_headless(config.container_type or "interactive")
-        if inferred is not None:
-            changes["headless"] = inferred
-
     return replace(config, **changes) if changes else config
 
 
-def _infer_headless(container_type: str) -> bool | None:
-    """根据 container_type 推断 headless；interactive 返回 None 交由 loop 入口规范化。"""
-    if container_type in {"background", "batch", "worker", "sdk"}:
-        return True
-    return None
-
-
 def _resolve_workspace_trust_accepted(
     agent_workspace_cfg: Any,
     workspace_trust_prompter: Any | None,

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx/workflow/base.py

@@ -310,7 +310,6 @@ class BaseWorkflow(ABC):
             session_id=f"{self._workflow_id}-{task_key}",
             parent_conversation_session_id=parent_session_id,
             is_subagent=parent_session_id is not None,
-            container_type=self.container_type,
         )
         async with self._semaphore:
             graph = self._graph_factory(runtime)

langchain-agentx-python-1.1.8/langchain_agentx/workflow/runtime.py

@@ -0,0 +1,93 @@
+"""workflow/runtime.py — Workflow graph_factory 契约定义
+
+职责：
+    定义 WorkflowAgentRuntime 显式 dataclass，替代隐式 **kwargs 传递。
+    Workflow 在每次任务执行前注入 runtime 上下文，与 caller 的静态
+    AgentLoopConfig 合并产生本次任务的最终 config。
+
+链路位置：
+    BaseWorkflow._invoke_agent → WorkflowAgentRuntime → graph_factory(runtime)
+
+当前裁剪范围：
+    runtime overlay 不含 container_type / permission_mode（IF-G7）；静态 config 经 qa-auto 校验。
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, replace
+from typing import Any, Callable
+
+from langchain_core.language_models.chat_models import BaseChatModel
+from langchain_core.runnables import Runnable
+
+from langchain_agentx.loop.config.interaction_profile import normalize_config
+from langchain_agentx.loop.config.loop_config import AgentLoopConfig, LoopServices
+from langchain_agentx.loop.config.loop_runtime_overlay import LoopRuntimeOverlay
+from langchain_agentx.loop.graph.factory import create_loop_agent
+
+
+@dataclass(frozen=True)
+class WorkflowAgentRuntime:
+    """Workflow 每次任务注入的运行时 overlay（不含 container_type）。"""
+
+    session_id: str
+    parent_conversation_session_id: str | None = None
+    is_subagent: bool = False
+
+    def to_overlay(self) -> LoopRuntimeOverlay:
+        return LoopRuntimeOverlay(
+            session_id=self.session_id,
+            parent_conversation_session_id=self.parent_conversation_session_id,
+            is_subagent=self.is_subagent,
+        )
+
+    def apply_to(self, base: AgentLoopConfig) -> AgentLoopConfig:
+        return self.to_overlay().apply_to(base)
+
+
+CompiledStateGraph = Runnable[Any, Any]
+WorkflowGraphFactory = Callable[[WorkflowAgentRuntime], CompiledStateGraph]
+
+
+def _ensure_workflow_auto_config(config: AgentLoopConfig) -> AgentLoopConfig:
+    """IF-G5：Workflow 工厂静态 config 必须为 workflow-auto 剖面。"""
+    raw = config.container_type or "workflow_task"
+    if raw not in ("workflow_task", None, ""):
+        raise ValueError(
+            f"make_workflow_graph_factory requires container_type='workflow_task', got {raw!r}"
+        )
+    return replace(
+        config,
+        container_type="workflow_task",
+        headless=True if config.headless is None else config.headless,
+    )
+
+
+def make_workflow_graph_factory(
+    model: str | BaseChatModel,
+    *,
+    config: AgentLoopConfig,
+    services: LoopServices | None = None,
+) -> WorkflowGraphFactory:
+    """生成 Workflow graph_factory；静态 config 经 workflow-auto 规范化。"""
+    if services is None:
+        services = LoopServices()
+
+    static_cfg = normalize_config(_ensure_workflow_auto_config(config))
+
+    def factory(runtime: WorkflowAgentRuntime) -> CompiledStateGraph:
+        return create_loop_agent(
+            model,
+            config=runtime.apply_to(static_cfg),
+            services=services,
+        )
+
+    return factory
+
+
+__all__ = [
+    "WorkflowAgentRuntime",
+    "WorkflowGraphFactory",
+    "CompiledStateGraph",
+    "make_workflow_graph_factory",
+]

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/langchain_agentx_python.egg-info/SOURCES.txt

@@ -34,6 +34,7 @@ langchain_agentx/loop/config/__init__.py
 langchain_agentx/loop/config/agent_config.py
 langchain_agentx/loop/config/interaction_profile.py
 langchain_agentx/loop/config/loop_config.py
+langchain_agentx/loop/config/loop_runtime_overlay.py
 langchain_agentx/loop/config/model_context_resolver.py
 langchain_agentx/loop/config/runtime_settings.py
 langchain_agentx/loop/config/token_estimator.py

{langchain-agentx-python-1.1.7 → langchain-agentx-python-1.1.8}/pyproject.toml

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