langchain-agentx-python 0.9.6__tar.gz → 0.9.8__tar.gz

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/PKG-INFO

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

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx/__init__.py

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

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx/loop/graph/factory.py

@@ -1153,7 +1153,8 @@ class LoopGraphBuilder:
                     if self._task_runtime is not None:
                         runtime_events = self._task_runtime.drain_events()
                         for event in runtime_events:
-                            if str(event.event_type.value) == "terminal":
+                            event_type = str(event.event_type.value)
+                            if event_type == "terminal":
                                 task_events.append(
                                     {
                                         "event_type": "task-terminated",
@@ -1166,6 +1167,30 @@ class LoopGraphBuilder:
                                         "loop_terminal_reason": read_terminal_reason(state.get("terminal")),
                                     }
                                 )
+                            elif event_type == "started":
+                                task_events.append(
+                                    {
+                                        "event_type": "started",
+                                        "task_id": event.task_id,
+                                        "task_type": event.task_type.value,
+                                        "status": event.status.value,
+                                        "summary": event.summary,
+                                        "description": event.summary,
+                                        "agent_id": event.scope.agent_id,
+                                    }
+                                )
+                            elif event_type == "progress":
+                                task_events.append(
+                                    {
+                                        "event_type": "progress",
+                                        "task_id": event.task_id,
+                                        "task_type": event.task_type.value,
+                                        "status": event.status.value,
+                                        "summary": event.summary,
+                                        "description": event.summary,
+                                        "agent_id": event.scope.agent_id,
+                                    }
+                                )
                     return {
                         "pending_task_batch_id": None,
                         "pending_task_command_ids": [],
@@ -1196,7 +1221,8 @@ class LoopGraphBuilder:
                 if self._task_runtime is not None:
                     runtime_events = self._task_runtime.drain_events()
                     for event in runtime_events:
-                        if str(event.event_type.value) == "terminal":
+                        event_type = str(event.event_type.value)
+                        if event_type == "terminal":
                             task_events.append(
                                 {
                                     "event_type": "task-terminated",
@@ -1209,6 +1235,30 @@ class LoopGraphBuilder:
                                     "loop_terminal_reason": read_terminal_reason(state.get("terminal")),
                                 }
                             )
+                        elif event_type == "started":
+                            task_events.append(
+                                {
+                                    "event_type": "started",
+                                    "task_id": event.task_id,
+                                    "task_type": event.task_type.value,
+                                    "status": event.status.value,
+                                    "summary": event.summary,
+                                    "description": event.summary,
+                                    "agent_id": event.scope.agent_id,
+                                }
+                            )
+                        elif event_type == "progress":
+                            task_events.append(
+                                {
+                                    "event_type": "progress",
+                                    "task_id": event.task_id,
+                                    "task_type": event.task_type.value,
+                                    "status": event.status.value,
+                                    "summary": event.summary,
+                                    "description": event.summary,
+                                    "agent_id": event.scope.agent_id,
+                                }
+                            )
                 return {
                     "messages": messages,
                     "pending_task_batch_id": encode_provider_batch_id(

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx/loop/model/tool_call_degradation_corrector.py

@@ -163,6 +163,68 @@ class ToolCallDegradationCorrector:
             allowed_tool_names=self._allowed_tool_names | new_names,
         )
 
+    def bind(self, **kwargs: Any) -> "ToolCallDegradationCorrector":
+        """保住 wrapper：底层 ``bind(**model_settings)`` 后重新包装。
+
+        必须存在的原因：
+            ``get_bound_model`` 在「请求未携带工具」分支会执行
+            ``request.model.bind(**model_settings)``。如果只透传 ``__getattr__``，
+            返回的是底层 LLM 的 ``RunnableBinding``，纠偏逻辑会被剥掉，
+            导致 ``ainvoke`` 路径同样出现 silent drop。
+        """
+        bound = self._llm.bind(**kwargs)
+        return ToolCallDegradationCorrector(
+            llm=bound,
+            allowed_tool_names=set(self._allowed_tool_names),
+        )
+
+    def with_config(self, *args: Any, **kwargs: Any) -> "ToolCallDegradationCorrector":
+        """保住 wrapper：底层 ``with_config(...)`` 后重新包装。
+
+        必须存在的原因：
+            ``ModelNode._bind_llm_callback_handler`` 在 ``trace.enabled=True``
+            时会执行 ``model.with_config({"callbacks": [...]})``。若不覆写，
+            ``__getattr__`` 透传到底层 LLM，返回 ``RunnableBinding``，
+            纠偏逻辑同样被剥掉。
+        """
+        bound = self._llm.with_config(*args, **kwargs)
+        return ToolCallDegradationCorrector(
+            llm=bound,
+            allowed_tool_names=set(self._allowed_tool_names),
+        )
+
+    def with_retry(self, *args: Any, **kwargs: Any) -> "ToolCallDegradationCorrector":
+        """保住 wrapper：``Runnable.with_retry`` 入口必须返回 corrector，不退化为底层 binding。"""
+        bound = self._llm.with_retry(*args, **kwargs)
+        return ToolCallDegradationCorrector(
+            llm=bound,
+            allowed_tool_names=set(self._allowed_tool_names),
+        )
+
+    def with_fallbacks(self, *args: Any, **kwargs: Any) -> "ToolCallDegradationCorrector":
+        """保住 wrapper：``Runnable.with_fallbacks`` 入口必须返回 corrector。"""
+        bound = self._llm.with_fallbacks(*args, **kwargs)
+        return ToolCallDegradationCorrector(
+            llm=bound,
+            allowed_tool_names=set(self._allowed_tool_names),
+        )
+
+    def with_listeners(self, *args: Any, **kwargs: Any) -> "ToolCallDegradationCorrector":
+        """保住 wrapper：``Runnable.with_listeners`` 入口必须返回 corrector。"""
+        bound = self._llm.with_listeners(*args, **kwargs)
+        return ToolCallDegradationCorrector(
+            llm=bound,
+            allowed_tool_names=set(self._allowed_tool_names),
+        )
+
+    def with_types(self, *args: Any, **kwargs: Any) -> "ToolCallDegradationCorrector":
+        """保住 wrapper：``Runnable.with_types`` 入口必须返回 corrector。"""
+        bound = self._llm.with_types(*args, **kwargs)
+        return ToolCallDegradationCorrector(
+            llm=bound,
+            allowed_tool_names=set(self._allowed_tool_names),
+        )
+
     # ----------------------------
     # Runnable 接口：invoke / ainvoke
     # ----------------------------

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx/observability/events/langchain_agentx_event_adapter.py

@@ -98,6 +98,9 @@ class LangchainAgentEventType(Enum):
     # 错误
     ERROR = "error"
 
+    # Artifact（方案 A：通过自定义事件传递 artifact）
+    TOOL_ARTIFACT = "tool-artifact"
+
     # Task Runtime（对齐 CC task_started/task_progress）
     TASK_STARTED = "task-started"
     TASK_PROGRESS = "task-progress"
@@ -1336,6 +1339,36 @@ class LangGraphToLangchainAgentEventAdapter:
             )
             return
 
+        # 处理 tool_artifact 自定义事件（方案 A：解决 on_tool_end 不包含 artifact）
+        if event_name == "tool_artifact":
+            data = event.get("data", {})
+            if not isinstance(data, dict):
+                return
+            artifact = data.get("artifact")
+            if not isinstance(artifact, dict):
+                return
+            tool_name = data.get("tool_name", "")
+            status = data.get("status", "ok")
+            tool_call_id = data.get("tool_call_id", "")
+            # 发送 TOOL_ARTIFACT 事件，包含完整的 artifact 数据（含 display）
+            artifact_event_data = {
+                "tool_name": tool_name,
+                "tool_call_id": tool_call_id,
+                "status": status,
+            }
+            # 平铺 artifact v1 字段
+            artifact_event_data.update(self._flatten_artifact_v1_fields(artifact))
+            # 单独处理 display 字段
+            if "display" in artifact:
+                artifact_event_data["display"] = artifact["display"]
+            yield self._event(
+                event_type=LangchainAgentEventType.TOOL_ARTIFACT,
+                data=artifact_event_data,
+                step_index=self.state.step_index,
+                tool_name=tool_name,
+            )
+            return
+
         if not self.enable_subagent_events:
             return
 

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx/tool_runtime/adapter.py

@@ -453,7 +453,7 @@ class LangChainAdapter:
                 run_result=run_result,
                 ctx=ctx,
             )
-            return adapter.envelope_to_structured_tool_return(
+            content, artifact = adapter.envelope_to_structured_tool_return(
                 run_result.envelope,
                 tool=tool,
                 ctx=ctx,
@@ -461,6 +461,28 @@ class LangChainAdapter:
                 invoke_result=run_result.invoke_result,
             )
 
+            # 方案 A：发送 tool_artifact 自定义事件
+            # 将 artifact 通过自定义事件传递给下游，解决 on_tool_end 不包含 artifact 的问题
+            if artifact and isinstance(artifact, dict):
+                try:
+                    from langchain_core.callbacks import adispatch_custom_event
+
+                    await adispatch_custom_event(
+                        "tool_artifact",
+                        {
+                            "artifact": artifact,
+                            "tool_name": str(tool.name),
+                            "tool_call_id": ctx.tool_call_id,
+                            "status": artifact.get("status", "ok"),
+                        },
+                        config=config,
+                    )
+                except Exception:
+                    # 忽略事件发送失败，不影响工具功能
+                    pass
+
+            return content, artifact
+
         return StructuredTool(
             name=tool.name,
             description=tool.description,

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx/tool_runtime/pipeline.py

@@ -42,6 +42,10 @@ import logging
 import os
 import time
 import warnings
+from dataclasses import is_dataclass
+from datetime import date, datetime
+from enum import Enum
+from pathlib import Path
 from typing import TYPE_CHECKING, Any
 
 from pydantic import ValidationError
@@ -639,6 +643,32 @@ class ToolExecutorPipeline:
                 tool.name,
                 run_result.envelope.status,
             )
+
+            # 方案 A：发送 tool_artifact 自定义事件
+            # 将 artifact 通过自定义事件传递给下游，解决 on_tool_end 不包含 artifact 的问题
+            if ctx.runnable_config is not None:
+                # 从 envelope 构建 artifact（不依赖 adapter，避免循环依赖）
+                artifact = self._build_artifact_from_envelope(
+                    run_result.envelope, tool, ctx, run_result.parsed_input, run_result.invoke_result
+                )
+                if artifact and isinstance(artifact, dict):
+                    try:
+                        from langchain_core.callbacks import adispatch_custom_event
+
+                        await adispatch_custom_event(
+                            "tool_artifact",
+                            {
+                                "artifact": artifact,
+                                "tool_name": str(tool.name),
+                                "tool_call_id": ctx.tool_call_id,
+                                "status": artifact.get("status", "ok"),
+                            },
+                            config=ctx.runnable_config,
+                        )
+                    except Exception:
+                        # 忽略事件发送失败，不影响工具功能
+                        pass
+
             await self._emit_tool_outcome_telemetry_async(
                 run_result.envelope, ctx, raw_input=raw_input
             )
@@ -662,6 +692,59 @@ class ToolExecutorPipeline:
         """异步执行完整 pipeline，始终返回 ToolResultEnvelope。"""
         return (await self.arun_with_result(tool=tool, raw_input=raw_input, ctx=ctx)).envelope
 
+    @staticmethod
+    def _build_artifact_from_envelope(
+        env: Any,
+        tool: Any,
+        ctx: ToolExecutionContext,
+        parsed_input: dict[str, Any] | None = None,
+        invoke_result: Any = None,
+    ) -> dict[str, Any]:
+        """从 envelope 构建 artifact（简化版，不依赖 LangChainAdapter）。"""
+        from dataclasses import asdict
+
+        def json_safe(value: Any) -> Any:
+            if value is None or isinstance(value, (bool, int, float, str)):
+                return value
+            if isinstance(value, Enum):
+                return value.value
+            if isinstance(value, Path):
+                return str(value)
+            if isinstance(value, (datetime, date)):
+                return value.isoformat()
+            if isinstance(value, bytes):
+                return value.decode("utf-8", errors="replace")
+            if is_dataclass(value) and not isinstance(value, type):
+                return json_safe(asdict(value))
+            if isinstance(value, dict):
+                return {str(k): json_safe(v) for k, v in value.items()}
+            if isinstance(value, (list, tuple)):
+                return [json_safe(v) for v in value]
+            return value
+
+        # 获取 envelope 数据
+        if hasattr(env, "envelope"):
+            # 如果是 PipelineRunResult，先提取 envelope
+            envelope = env.envelope
+        elif hasattr(env, "__dataclass_fields__"):
+            envelope = env
+        else:
+            return {}
+
+        artifact = json_safe(asdict(envelope))
+        artifact["schema_version"] = "2"
+
+        # 添加 display 字段（如果工具有 present_for_display 方法）
+        if hasattr(tool, "present_for_display") and parsed_input is not None:
+            try:
+                display = tool.present_for_display(parsed_input, invoke_result, ctx)
+                if display:
+                    artifact["display"] = display
+            except Exception:
+                pass
+
+        return artifact
+
     # ---- 内部实现 ----
 
     def _run(

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/langchain_agentx_python.egg-info/PKG-INFO

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

{langchain-agentx-python-0.9.6 → langchain-agentx-python-0.9.8}/pyproject.toml

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