[JasperSelmanUiPath]

Fixes #1957 · AGVSOL-9364

What broke: exists_file and exists_file_async always returned False, even for a file that is in the bucket. Both methods add a leading / to blob_file_path and compare the result exactly with the fullPath that ListFiles returns. Orchestrator returns fullPath without a leading /, so the two never match.

The fix: compare both paths without the leading /. exists_file now returns True whether or not blob_file_path starts with /. The ListFiles prefix query is unchanged, because ListFiles finds the file with either prefix.

Tests: the exists_file tests mocked fullPath with a leading /, which is why they passed while the method was broken. They now mock it without one, as Orchestrator returns it. The found-cases (sync and async) also run with a blob_file_path that starts with /. Before the fix, 7 of these tests fail; after it, all 2058 uipath-platform tests pass.

The list_files tests also mocked fullPath with a leading /. They now mock it without one, to match the real API. list_files does not compare paths, so this changes no behavior.

Bumps uipath-platform to 0.3.1.

🤖 Generated with Claude Code

[github-actions]

🚨 Heads up: uipath-integrations cross-tests are FAILING 🚨

Your changes may break one or more integrations in uipath-integrations-python:

• uipath-openai-agents
• uipath-google-adk
• uipath-agent-framework
• uipath-llamaindex
• uipath-pydantic-ai

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

[github-actions]

🚨 Heads up: uipath-langchain cross-tests are FAILING 🚨

Your changes may break the uipath-langchain-python integration.

⚠️ These checks are NOT enforced by branch protection rules. Please review the failures before merging.

🔍 Inspect the failed run →

[Copilot]

🟢 Approval recommended

There are no active review issues for the bucket path-normalization change.

No open issues 🎉

What changed in this PR

Fixes #1957 by making synchronous and asynchronous bucket file-existence checks match paths with or without a leading slash.

Changes:

• Removes one leading slash from both paths before comparison, leaving the ListFiles prefix query unchanged.
• Updates test fixtures to match Orchestrator responses and tests caller paths with and without a leading slash.
• Bumps uipath-platform to 0.3.1 and updates both lockfiles.

File	Description
packages/​uipath/​uv.lock	Updates the platform dependency version to 0.3.1.
packages/​uipath-platform/​uv.lock	Records platform version 0.3.1.
packages/​uipath-platform/​tests/​services/​test_buckets_service.py	Corrects response fixtures and expands leading-slash coverage.
packages/​uipath-platform/​src/​uipath/​platform/​orchestrator/​_buckets_service.py	Normalizes path comparisons in both existence-check methods.
packages/​uipath-platform/​pyproject.toml	Bumps the package version to 0.3.1.

_{Review effort: Balanced}

[Copilot]

🟢 Approval recommended

No active review issues block approval of the changes aligning bucket file-existence checks with Orchestrator path formats.

No open issues 🎉

_{Review effort: Balanced}

[andreitava-uip]

Not changed, for the owners to decide: the list_files and get_files tests in test_buckets_service.py also mock fullPath with a leading / (for example "/data/file1.txt"), which is not what Orchestrator returns. Those methods pass fullPath through without comparing it, so the tests still pass, but the fixtures don't match the real API. I left them as they are. Should they be changed to match?

Worth to change it, it should have no impact but it betters expresses the actual behavior.

[andreitava-uip]

please rebase to latest main before merging

[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