feat(agent): add quickForm escalation tool

[cotovanu-cristian]

Summary

Adds support for QuickForm escalation channels (type: actionCenterQuickForm) to the low-code agent escalation tool. A QuickForm channel renders a schema-first FormLib task inline (no deployed Action Center app), while Action Center channels keep dispatching to their app task. The two variants are modeled as the upstream discriminated union EscalationChannel = AgentEscalationChannel | AgentQuickFormEscalationChannel and flow through the existing create_escalation_tool — no separate tool or factory branch. Channel configuration is validated up front at tool construction so malformed escalations fail fast at agent startup rather than mid-run.

Changes

• escalation_tool.py
  • create_escalation_tool consumes channel: EscalationChannel and handles both variants.
  • New module-level create_task_for_channel(client, channel, *, title, data, recipient, folder_path) -> Task concentrates per-channel dispatch: QuickForm → tasks.create_quickform_async(task_schema_key=schema_id, schema=form_schema, …); Action Center → tasks.create_async(app_name=…, …).
  • _resolve_channel(resource) resolves the channel and validates configuration at construction — a QuickForm channel missing its schema_id raises AgentStartupError(INVALID_TOOL_CONFIG) (previously a runtime AgentRuntimeError).
  • _try_get_channel_app_name(channel) derives app_name (Action Center → its app name; QuickForm → None), used for both WaitEscalation.app_name and the tool's display_name metadata (falls back to channel.name).
  • Form body is read via channel.properties.form_schema (the field; "schema" is its serialization alias) and the id via the schema_id property.
• ixp_escalation_tool.py
  • _resolve_action_center_channel(resource) validates that a VS escalation uses an Action Center channel, rejecting QuickForm with AgentStartupError(INVALID_TOOL_CONFIG). The narrowed type lets display_name read channel.properties.app_name directly (no lossy helper).
• pyproject.toml / uv.lock — bump uipath 2.10.74 → 2.10.79 (ships the EscalationChannel union, AgentQuickFormChannelProperties, and TasksService.create_quickform_async); package version 0.11.13 → 0.11.14.
• Tests
  • test_escalation_tool.py — TestQuickFormEscalation (dispatch to create_quickform_async, app_name=None in WaitEscalation, outcome-mapping END termination, tool metadata, Action-Center-does-not-dispatch-to-QuickForm) + construction-time missing-schema_id validation.
  • test_ixp_escalation_tool.py — display_name is the channel app name + VS escalation rejects a QuickForm channel at construction.
  • test_tool_factory.py — a QuickForm resource routes through the existing AgentEscalationResourceConfig path (no new factory branch).

Flow

flowchart TD
    A[create_escalation_tool] --> B[_resolve_channel]
    B -->|QuickForm without schemaId| E[AgentStartupError INVALID_TOOL_CONFIG]
    B -->|valid channel| C[tool invoked]
    C --> G[create_task_for_channel]
    G -->|actionCenterQuickForm| D[tasks.create_quickform_async]
    G -->|actionCenter| F[tasks.create_async with app_name]

Loading

Testing

• ruff check . + httpx-client linter — pass
• ruff format --check . — pass
• mypy on changed files — clean (remaining errors are pre-existing optional boto3/vertex extras, resolved in CI --all-extras)
• pytest tests/agent/ — 1177 passed
• Unit tests added/updated (QuickForm dispatch, construction-time validation, factory routing, IXP channel guard)
• Type-safe — no # type: ignore / suppressions added

Breaking changes

None — additive. QuickForm is a new channel variant; existing Action Center escalation behavior is unchanged.

[Copilot]

Pull request overview

Adds support for QuickForm escalation channels (type: actionCenterQuickForm) in the low-code agent escalation tool by routing task creation through a single per-channel dispatch helper, while keeping existing Action Center escalation behavior intact. This extends the agent tools layer to support schema-first inline forms without introducing a new tool/factory branch.

Changes:

• Extend create_escalation_tool to accept the upstream EscalationChannel union and dispatch task creation via new create_task_for_channel() (QuickForm → create_quickform_async, Action Center → create_async).
• Adjust tool metadata/display name behavior to handle channels without an app_name (QuickForm falls back to channel name; IXP escalation now guards display_name via _channel_app_name).
• Add comprehensive QuickForm-focused tests and bump uipath dependency/lockfile to the version that provides the new channel models + create_quickform_async.

Reviewed changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/uipath_langchain/agent/tools/escalation_tool.py	Adds union-channel handling, per-channel task dispatch, and display name fallback for QuickForm.
src/uipath_langchain/agent/tools/ixp_escalation_tool.py	Uses shared channel→app_name derivation for metadata display name.
src/uipath_langchain/agent/tools/escalation_memory.py	Formatting-only import/signature wrapping (no behavior change).
tests/agent/tools/test_escalation_tool.py	Adds QuickForm coverage (dispatch, metadata, outcome mapping termination, schema-id validation, non-regression).
tests/agent/tools/test_tool_factory.py	Ensures QuickForm resources route through the existing escalation tool factory path.
pyproject.toml	Version bump to 0.11.14 and updates uipath minimum version.
uv.lock	Updates resolved uipath version and lock metadata to match dependency changes.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud