fix: use wrapper pattern for escalation tool to provide tool_call_id

The escalation tool was failing with:
  TypeError: escalation_tool_fn() missing 1 required positional argument: 'runtime'

Root cause: Tool expected `runtime: ToolRuntime` param but nothing provided it.

Solution: Use wrapper pattern instead of injection
- Tool returns graph-agnostic EscalationResult dataclass
- Wrapper converts result to Command using call["id"] (tool_call_id)
- Remove ToolRuntime injection code from tool_node.py

This follows reviewer feedback: tools should be graph-agnostic,
wrappers handle graph integration.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: saksharthakkar

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-langchain"
-version = "0.2.4"
+version = "0.2.5"
 description = "Python SDK that enables developers to build and deploy LangGraph agents to the UiPath Cloud Platform"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

src/uipath_langchain/agent/tools/escalation_tool.py

@@ -1,11 +1,12 @@
 """Escalation tool creation for Action Center integration."""
 
+from dataclasses import dataclass
 from enum import Enum
 from typing import Any
 
-from langchain.tools import ToolRuntime
 from langchain_core.messages import ToolMessage
-from langchain_core.tools import StructuredTool
+from langchain_core.messages.tool import ToolCall
+from langchain_core.tools import BaseTool, StructuredTool
 from langgraph.types import Command, interrupt
 from uipath.agent.models.agent import (
     AgentEscalationChannel,
@@ -17,6 +18,8 @@
 
 from uipath_langchain.agent.react.jsonschema_pydantic_converter import create_model
 
+from ..react.types import AgentGraphNode, AgentGraphState, AgentTerminationSource
+from .tool_node import ToolWrapperMixin
 from .utils import sanitize_tool_name
 
 
@@ -27,7 +30,20 @@ class EscalationAction(str, Enum):
     END = "end"
 
 
-def create_escalation_tool(resource: AgentEscalationResourceConfig) -> StructuredTool:
+@dataclass
+class EscalationResult:
+    """Graph-agnostic result from escalation tool."""
+
+    action: EscalationAction
+    output: dict[str, Any]
+    escalation_action: str | None = None
+
+
+class StructuredToolWithWrapper(StructuredTool, ToolWrapperMixin):
+    pass
+
+
+def create_escalation_tool(resource: AgentEscalationResourceConfig) -> BaseTool:
     """Uses interrupt() for Action Center human-in-the-loop."""
 
     tool_name: str = f"escalate_{sanitize_tool_name(resource.name)}"
@@ -50,9 +66,7 @@ def create_escalation_tool(resource: AgentEscalationResourceConfig) -> Structure
         output_schema=output_model.model_json_schema(),
         example_calls=channel.properties.example_calls,
     )
-    async def escalation_tool_fn(
-        runtime: ToolRuntime, **kwargs: Any
-    ) -> Command[Any] | Any:
+    async def escalation_tool_fn(**kwargs: Any) -> EscalationResult:
         task_title = channel.task_title or "Escalation Task"
 
         result = interrupt(
@@ -73,23 +87,41 @@ async def escalation_tool_fn(
         escalation_action = getattr(result, "action", None)
         escalation_output = getattr(result, "data", {})
 
-        outcome = (
+        outcome_str = (
             channel.outcome_mapping.get(escalation_action)
             if channel.outcome_mapping and escalation_action
             else None
         )
+        outcome = (
+            EscalationAction(outcome_str) if outcome_str else EscalationAction.CONTINUE
+        )
 
-        if outcome == EscalationAction.END:
-            output_detail = f"Escalation output: {escalation_output}"
-            termination_title = f"Agent run ended based on escalation outcome {outcome} with directive {escalation_action}"
-            from ..react.types import AgentGraphNode, AgentTerminationSource
+        return EscalationResult(
+            action=outcome,
+            output=escalation_output,
+            escalation_action=escalation_action,
+        )
+
+    async def escalation_wrapper(
+        tool: BaseTool,
+        call: ToolCall,
+        state: AgentGraphState,
+    ) -> dict[str, Any] | Command[Any]:
+        result: EscalationResult = await tool.ainvoke(call["args"])
+
+        if result.action == EscalationAction.END:
+            output_detail = f"Escalation output: {result.output}"
+            termination_title = (
+                f"Agent run ended based on escalation outcome {result.action} "
+                f"with directive {result.escalation_action}"
+            )
 
             return Command(
                 update={
                     "messages": [
                         ToolMessage(
                             content=f"{termination_title}. {output_detail}",
-                            tool_call_id=runtime.tool_call_id,
+                            tool_call_id=call["id"],
                         )
                     ],
                     "termination": {
@@ -101,9 +133,9 @@ async def escalation_tool_fn(
                 goto=AgentGraphNode.TERMINATE,
             )
 
-        return escalation_output
+        return result.output
 
-    tool = StructuredTool(
+    tool = StructuredToolWithWrapper(
         name=tool_name,
         description=resource.description,
         args_schema=input_model,
@@ -115,5 +147,6 @@ async def escalation_tool_fn(
             "assignee": assignee,
         },
     )
+    tool.set_tool_wrappers(awrapper=escalation_wrapper)
 
     return tool

src/uipath_langchain/agent/tools/tool_factory.py

@@ -1,7 +1,7 @@
 """Factory functions for creating tools from agent resources."""
 
 from langchain_core.language_models import BaseChatModel
-from langchain_core.tools import BaseTool, StructuredTool
+from langchain_core.tools import BaseTool
 from uipath.agent.models.agent import (
     AgentContextResourceConfig,
     AgentEscalationResourceConfig,
@@ -34,7 +34,7 @@ async def create_tools_from_resources(
 
 async def _build_tool_for_resource(
     resource: BaseAgentResourceConfig, llm: BaseChatModel
-) -> StructuredTool | None:
+) -> BaseTool | None:
     if isinstance(resource, AgentProcessToolResourceConfig):
         return create_process_tool(resource)
 

src/uipath_langchain/agent/tools/tool_node.py

@@ -6,6 +6,7 @@
 
 from langchain_core.messages.ai import AIMessage
 from langchain_core.messages.tool import ToolCall, ToolMessage
+from langchain_core.runnables.config import RunnableConfig
 from langchain_core.tools import BaseTool
 from langgraph._internal._runnable import RunnableCallable
 from langgraph.types import Command
@@ -48,7 +49,7 @@ def __init__(
         self.wrapper = wrapper
         self.awrapper = awrapper
 
-    def _func(self, state: Any) -> OutputType:
+    def _func(self, state: Any, config: RunnableConfig | None = None) -> OutputType:
         call = self._extract_tool_call(state)
         if call is None:
             return None
@@ -57,10 +58,11 @@ def _func(self, state: Any) -> OutputType:
             result = self.wrapper(self.tool, call, filtered_state)
         else:
             result = self.tool.invoke(call["args"])
-
         return self._process_result(call, result)
 
-    async def _afunc(self, state: Any) -> OutputType:
+    async def _afunc(
+        self, state: Any, config: RunnableConfig | None = None
+    ) -> OutputType:
         call = self._extract_tool_call(state)
         if call is None:
             return None
@@ -69,7 +71,6 @@ async def _afunc(self, state: Any) -> OutputType:
             result = await self.awrapper(self.tool, call, filtered_state)
         else:
             result = await self.tool.ainvoke(call["args"])
-
         return self._process_result(call, result)
 
     def _extract_tool_call(self, state: Any) -> ToolCall | None:

tests/agent/tools/test_tool_node.py

@@ -1,5 +1,7 @@
 """Tests for tool_node.py module."""
 
+import importlib.util
+import sys
 from typing import Any, Dict
 
 import pytest
@@ -9,11 +11,36 @@
 from langgraph.types import Command
 from pydantic import BaseModel
 
-from uipath_langchain.agent.tools.tool_node import (
-    ToolWrapperMixin,
-    UiPathToolNode,
-    create_tool_node,
-)
+
+# Import directly from module file to avoid circular import through __init__.py
+def _import_tool_node() -> Any:
+    """Import tool_node module directly to bypass circular import."""
+    import os
+
+    module_path = os.path.join(
+        os.path.dirname(__file__),
+        "..",
+        "..",
+        "..",
+        "src",
+        "uipath_langchain",
+        "agent",
+        "tools",
+        "tool_node.py",
+    )
+    module_path = os.path.abspath(module_path)
+    spec = importlib.util.spec_from_file_location("tool_node", module_path)
+    assert spec is not None and spec.loader is not None
+    module = importlib.util.module_from_spec(spec)
+    sys.modules["tool_node"] = module
+    spec.loader.exec_module(module)
+    return module
+
+
+_tool_node_module = _import_tool_node()
+ToolWrapperMixin: Any = _tool_node_module.ToolWrapperMixin
+UiPathToolNode: Any = _tool_node_module.UiPathToolNode
+create_tool_node: Any = _tool_node_module.create_tool_node
 
 
 class MockTool(BaseTool):