Skip to content

fix(platform): report a missing Action Center app as a deployment error [MST-18256] - #2002

Open
IevgenUiPath wants to merge 1 commit into
mainfrom
fix/MST-18256-app-not-found-deployment-error
Open

IevgenUiPath wants to merge 1 commit into
mainfrom
fix/MST-18256-app-not-found-deployment-error

Conversation

@IevgenUiPath

@IevgenUiPath IevgenUiPath commented Nov 18, 2026 •

Copy link
Copy Markdown

Problem

An agent escalation (or any CreateTask / CreateEscalation interrupt) that names an Action Center app which is not deployed in the tenant or folder fails like a platform fault. TasksService._extract_deployed_app raises a bare Exception, and UiPathResumeTriggerCreator.create_trigger wraps every bare exception as ErrorCategory.SYSTEM, "Failed to create HITL action".

In Maestro this reaches the customer as "Unexpected Error ... please try again later or contact your Administrator", with the real cause ("App 'X' was not found in folder ...") only in the details. Retrying cannot help; the customer has to deploy the app or fix the folder. See MST-18256 (sample instance 5731bca3).

Change

  • New AppNotFoundError in uipath.platform.errors. It is still an Exception and carries the same message, so existing callers that catch Exception or match on the text keep working.
  • TasksService._extract_deployed_app raises it for "not found in the current tenant" and "not found in folder".
  • _handle_task_trigger maps it to UiPathFaultedTriggerError(ErrorCategory.DEPLOYMENT, "Action app not found. Check that the app is deployed and available in the configured folder.", <original message>). This is the same pattern already used for ContextGroundingIndexNotFoundError in the deep RAG and batch transform triggers.
  • Version bump 0.3.12 → 0.3.13.

Tests

  • test_missing_task_app_is_deployment_error in tests/services/test_hitl.py.
  • The three existing not-found cases in tests/services/test_actions_service.py now assert the typed error.
  • pytest tests/services/test_hitl.py tests/services/test_actions_service.py, ruff check and ruff format --check pass locally. mypy was not run locally.

Not in this PR

The other causes under the same "Unexpected Error" wrapper in MST-18256: a missing storage bucket during document extraction, a model tool call with null arguments, an out-of-range FieldSettings.weight, and the opaque "Server returned an error response" at agent startup. Each needs its own fix.

🤖 Generated with Claude Code

@github-actions github-actions Bot added test:uipath-langchain Triggers tests in the uipath-langchain-python repository test:uipath-integrations labels Nov 18, 2026
@IevgenUiPath
IevgenUiPath marked this pull request as ready for review November 18, 2026 17:05
Copilot AI balanced review requested due to automatic review settings November 18, 2026 17:05

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

No active review issues remain for the change that reports missing Action Center apps as deployment errors.

No open issues 🎉

What changed in this PR

This PR updates the UiPath Platform SDK so missing Action Center apps are reported as deployment errors rather than generic system faults, giving Maestro users clearer guidance.

Changes:

  • Adds and exports AppNotFoundError, then maps it to a deployment error for task and escalation triggers while preserving the original details.
  • Adds regression coverage for error classification and updates existing missing-app assertions.
  • Bumps uipath-platform from 0.3.10 to 0.3.11 and synchronizes both lockfiles.
File Description
packages/​uipath/​uv.lock Updates the platform package version to 0.3.11.
packages/​uipath-platform/​uv.lock Synchronizes the platform lockfile version.
packages/​uipath-platform/​tests/​services/​test_hitl.py Tests deployment classification, error details, and exception chaining.
packages/​uipath-platform/​tests/​services/​test_actions_service.py Asserts the typed error for tenant and folder lookup failures.
packages/​uipath-platform/​src/​uipath/​platform/​resume_triggers/​_protocol.py Maps missing-app errors to deployment faults.
packages/​uipath-platform/​src/​uipath/​platform/​errors/​_app_not_found_error.py Defines the missing Action Center app exception.
packages/​uipath-platform/​src/​uipath/​platform/​errors/​__init__.py Exports and documents the new exception.
packages/​uipath-platform/​src/​uipath/​platform/​action_center/​_tasks_service.py Raises the typed exception when app lookup fails.
packages/​uipath-platform/​pyproject.toml Bumps the platform package version to 0.3.11.

Review effort: Balanced

@IevgenUiPath
IevgenUiPath force-pushed the fix/MST-18256-app-not-found-deployment-error branch from 54d1d0e to 9fd0b00 Compare November 19, 2026 19:25
…or [MST-18256]

When an agent escalation or task names an app that is not deployed in the
tenant or folder, the tasks service raised a bare Exception. Trigger
creation wrapped it as a SYSTEM fault, "Failed to create HITL action",
so the user was told to try again later for something only they can fix.

The tasks service now raises AppNotFoundError (still an Exception, same
message) and trigger creation maps it to a DEPLOYMENT error that says to
check the app is deployed in the configured folder, the same way a
missing context grounding index is already handled.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
@IevgenUiPath
IevgenUiPath force-pushed the fix/MST-18256-app-not-found-deployment-error branch from 9fd0b00 to f13d9b1 Compare November 20, 2026 18:07
@sonarqubecloud

Copy link
Copy Markdown

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

test:uipath-integrations test:uipath-langchain Triggers tests in the uipath-langchain-python repository

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants