Repository navigation
fix(platform): report a missing Action Center app as a deployment error [MST-18256] - #2002
Open
IevgenUiPath wants to merge 1 commit into
Open
IevgenUiPath wants to merge 1 commit into
IevgenUiPath wants to merge 1 commit into
Conversation
IevgenUiPath
marked this pull request as ready for review
November 18, 2026 17:05
Contributor
There was a problem hiding this comment.
🟢 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-platformfrom 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
force-pushed
the
fix/MST-18256-app-not-found-deployment-error
branch
from
November 19, 2026 19:25
54d1d0e to
9fd0b00
Compare
…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
force-pushed
the
fix/MST-18256-app-not-found-deployment-error
branch
from
November 20, 2026 18:07
9fd0b00 to
f13d9b1
Compare
|
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



Problem
An agent escalation (or any
CreateTask/CreateEscalationinterrupt) that names an Action Center app which is not deployed in the tenant or folder fails like a platform fault.TasksService._extract_deployed_appraises a bareException, andUiPathResumeTriggerCreator.create_triggerwraps every bare exception asErrorCategory.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
AppNotFoundErrorinuipath.platform.errors. It is still anExceptionand carries the same message, so existing callers that catchExceptionor match on the text keep working.TasksService._extract_deployed_appraises it for "not found in the current tenant" and "not found in folder"._handle_task_triggermaps it toUiPathFaultedTriggerError(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 forContextGroundingIndexNotFoundErrorin the deep RAG and batch transform triggers.Tests
test_missing_task_app_is_deployment_errorintests/services/test_hitl.py.tests/services/test_actions_service.pynow assert the typed error.pytest tests/services/test_hitl.py tests/services/test_actions_service.py,ruff checkandruff format --checkpass locally.mypywas 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