fix: match guardrail tools by display_name in addition to tool name

When matching tools for deterministic guardrails, also check the tool's
metadata display_name field. This fixes cases where the guardrail
match_names reference the display name rather than the internal tool name.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ctiliescuuipath

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-langchain"
-version = "0.9.18"
+version = "0.9.19"
 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/guardrails/guardrails_factory.py

@@ -315,8 +315,9 @@ def _compute_field_sources_for_guardrail(
 
     # Deterministic guardrails have one single tool
     if guardrail.selector.match_names and len(guardrail.selector.match_names) > 0:
+        match_name = guardrail.selector.match_names[0]
         matching_tool = next(
-            (t for t in tools if t.name == guardrail.selector.match_names[0]), None
+            (t for t in tools if t.name == match_name or t.metadata.get("display_name") == match_name), None,
         )
 
         if matching_tool:
@@ -339,7 +340,7 @@ def _compute_field_sources_for_guardrail(
         code=AgentStartupErrorCode.INVALID_GUARDRAIL_CONFIG,
         title="Invalid guardrail match_names",
         detail=f"Guardrail '{guardrail.name}' requires a valid match_names with at least one tool. "
-        f"Tool '{tool_name}' not found in available tools. Please verify the tool name in your guardrail config."
+               f"Tool '{tool_name}' not found in available tools. Please verify the tool name in your guardrail config."
         if tool_name
         else f"Guardrail '{guardrail.name}' has match_names empty or not specified. Please add at least one tool name to match_names.",
         category=UiPathErrorCategory.USER,
@@ -519,8 +520,8 @@ def build_guardrails_with_actions(
                     code=AgentStartupErrorCode.INVALID_GUARDRAIL_CONFIG,
                     title="Invalid guardrail scope",
                     detail=f"Deterministic guardrail '{converted_guardrail.name}' can only be used with TOOL scope. "
-                    f"Found invalid scopes: {[scope.name for scope in non_tool_scopes]}. "
-                    f"Please configure this guardrail to use only TOOL scope.",
+                           f"Found invalid scopes: {[scope.name for scope in non_tool_scopes]}. "
+                           f"Please configure this guardrail to use only TOOL scope.",
                     category=UiPathErrorCategory.USER,
                 )
         else: