feat(agent/tools): finalize QuickForm escalation tool + display_name fallback

Fold the standalone QuickForm escalation tool into escalation_tool, and
default the tool's display_name metadata to the channel name when the
channel has no app_name (QuickForm). A None display_name previously broke
automation-tracker OperationPayload validation downstream. Adds a test
covering the QuickForm fallback.

Bumps uipath-langchain to 0.11.14.

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

Author: cotovanu-cristian

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "uipath-langchain"
-version = "0.11.13"
+version = "0.11.14"
 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/__init__.py

@@ -8,7 +8,6 @@
 from .ixp_escalation_tool import create_ixp_escalation_tool
 from .mcp import open_mcp_tools
 from .process_tool import create_process_tool
-from .quick_form_escalation_tool import create_quick_form_escalation_tool
 from .tool_factory import (
     create_tools_from_resources,
 )
@@ -33,7 +32,6 @@
     "create_escalation_tool",
     "create_ixp_extraction_tool",
     "create_ixp_escalation_tool",
-    "create_quick_form_escalation_tool",
     "UiPathToolNode",
     "RunnableCallableWithTool",
     "ToolWrapperMixin",

src/uipath_langchain/agent/tools/escalation_memory.py

@@ -7,7 +7,9 @@
 from uuid import UUID
 
 from pydantic import BaseModel, ConfigDict, Field, ValidationError, field_validator
-from uipath.agent.models.agent import AgentEscalationResourceConfig
+from uipath.agent.models.agent import (
+    AgentEscalationResourceConfig,
+)
 from uipath.platform import UiPath
 from uipath.platform.common import UiPathConfig
 from uipath.platform.common._bindings import _resource_overwrites
@@ -360,7 +362,9 @@ def _get_escalation_memory_settings(
     return _coerce_memory_settings(memory)
 
 
-def _is_escalation_memory_enabled(resource: AgentEscalationResourceConfig) -> bool:
+def _is_escalation_memory_enabled(
+    resource: AgentEscalationResourceConfig,
+) -> bool:
     memory = _get_escalation_memory_properties(resource)
     memory_enabled = _read_value(memory, "isEnabled", "is_enabled")
     if memory_enabled is not None:
@@ -370,7 +374,9 @@ def _is_escalation_memory_enabled(resource: AgentEscalationResourceConfig) -> bo
     )
 
 
-def _get_escalation_memory_properties(resource: AgentEscalationResourceConfig) -> Any:
+def _get_escalation_memory_properties(
+    resource: AgentEscalationResourceConfig,
+) -> Any:
     properties = _read_value(resource, "properties")
     return _read_value(properties, "memory") if properties is not None else None
 

src/uipath_langchain/agent/tools/escalation_tool.py

@@ -14,6 +14,7 @@
     AgentEscalationRecipient,
     AgentEscalationRecipientType,
     AgentEscalationResourceConfig,
+    AgentQuickFormEscalationChannel,
     ArgumentEmailRecipient,
     ArgumentGroupNameRecipient,
     AssetRecipient,
@@ -254,10 +255,19 @@ def create_escalation_tool(
     resource: AgentEscalationResourceConfig,
     agent: LowCodeAgentDefinition | None = None,
 ) -> StructuredTool:
-    """Uses interrupt() for Action Center human-in-the-loop."""
+    """Uses interrupt() for Action Center human-in-the-loop.
+
+    Handles both Action Center app-task channels (``actionCenter``) and
+    quick-form channels (``actionCenterQuickForm``). Quick-form channels render
+    a schema-first FormLib task via
+    :meth:`uipath.platform.action_center.tasks.TasksService.create_quickform_async`
+    using ``channel.properties.schema`` instead of dispatching to an Action
+    Center app.
+    """
 
     tool_name: str = f"escalate_{sanitize_tool_name(resource.name)}"
     channel: AgentEscalationChannel = resource.channels[0]
+    is_quick_form = isinstance(channel, AgentQuickFormEscalationChannel)
 
     input_model: Any = create_model(channel.input_schema)
     output_model: Any = create_model(channel.output_schema)
@@ -327,25 +337,50 @@ async def escalate(**_tool_kwargs: Any):
             @durable_interrupt
             async def create_escalation_task():
                 client = UiPath()
-                created_task = await client.tasks.create_async(
-                    title=task_title,
-                    data=serialized_data,
-                    app_name=channel.properties.app_name,
-                    app_folder_path=folder_path,
-                    recipient=recipient,
-                    priority=channel.priority,
-                    labels=channel.labels,
-                    is_actionable_message_enabled=channel.properties.is_actionable_message_enabled,
-                    actionable_message_metadata=channel.properties.actionable_message_meta_data,
-                )
+                if isinstance(channel, AgentQuickFormEscalationChannel):
+                    schema_id = channel.properties.schema_id
+                    if schema_id is None:
+                        raise AgentRuntimeError(
+                            code=AgentRuntimeErrorCode.TERMINATION_ESCALATION_ERROR,
+                            title="Quick form escalation is missing a schema id",
+                            detail=(
+                                f"Escalation '{resource.name}' has a quick form "
+                                "schema without a schemaId."
+                            ),
+                            category=UiPathErrorCategory.USER,
+                        )
+                    created_task = await client.tasks.create_quickform_async(
+                        title=task_title,
+                        task_schema_key=schema_id,
+                        schema=channel.properties.schema,
+                        data=serialized_data,
+                        folder_path=folder_path,
+                        recipient=recipient,
+                        priority=channel.priority,
+                        labels=channel.labels,
+                        is_actionable_message_enabled=channel.properties.is_actionable_message_enabled,
+                        actionable_message_metadata=channel.properties.actionable_message_meta_data,
+                    )
+                else:
+                    created_task = await client.tasks.create_async(
+                        title=task_title,
+                        data=serialized_data,
+                        app_name=channel.properties.app_name,
+                        app_folder_path=folder_path,
+                        recipient=recipient,
+                        priority=channel.priority,
+                        labels=channel.labels,
+                        is_actionable_message_enabled=channel.properties.is_actionable_message_enabled,
+                        actionable_message_metadata=channel.properties.actionable_message_meta_data,
+                    )
 
                 if created_task.id is not None:
                     _bts_context["task_key"] = str(created_task.id)
 
                 return WaitEscalation(
                     action=created_task,
                     app_folder_path=folder_path,
-                    app_name=channel.properties.app_name,
+                    app_name=None if is_quick_form else channel.properties.app_name,
                     recipient=recipient,
                 )
 
@@ -487,7 +522,7 @@ async def escalation_wrapper(
         argument_properties=channel.argument_properties,
         metadata={
             "tool_type": "escalation",
-            "display_name": channel.properties.app_name,
+            "display_name": channel.properties.app_name or channel.name,
             "channel_type": channel.type,
             "recipient": None,
             "args_schema": input_model,