[tudormatei1]

Coded agents lose the files they write to disk when their job suspends and resumes. This adds ManagedWorkspace, which builds the workspace hydrator and both wrappers in one place. The uipath CLI uses it to give coded agents the persistence low-code advanced agents already have (UiPath/uipath-python#1976), and uipath-agents drops its own copy of the same wiring (https://github.com/UiPath/uipath-agents-python/pull/867).

Note

Release this first. The uipath and uipath-agents PRs import ManagedWorkspace, and their CI fails until 0.13.7 is on PyPI.

Changes

• ManagedWorkspace (workspace/managed.py) builds HydrationRuntime and ConversationalWorkspaceRuntime around one shared hydrator. The attachments and jobs services come in as a factory and are created on first use, so building the wrappers needs no credentials and this package stays free of platform code.
• Breakpoints in HydrationRuntime: a debugger pause no longer uploads the workspace, and the call that continues skips the restore, so edits made before the pause aren't replaced by the last suspended version. This only applies when the call asked for breakpoints. Any other suspend uploads as before.
• HydrationRuntime takes an optional runtime_id for outer wrappers to read; agents' telemetry reads it.
• Version 0.13.7.

Testing

• New tests for ManagedWorkspace: resume restores files, services are created lazily, both wrappers share one hydrator, a folder it creates is removed and a caller's folder is kept.
• New breakpoint tests: continue keeps edits and deletions, a suspend after a breakpoint is restored on resume, only the first call after a pause skips the restore, and a breakpoint-shaped result from a run that asked for no breakpoints still uploads.
• Live on alpha with the four PR branches installed together: a coded LangGraph job writes a file, suspends on interrupt(), and uipath run --resume in a new process reads it back from job attachments. With the langchain opt-in turned off, the same check fails. The script is in my local playground, not in a repo.
• Not run: a real serverless or robot job. The live check used an existing job key as a stand-in.

🤖 Generated with Claude Code

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

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

See analysis details on SonarQube Cloud

[Copilot]

🟡 Changes recommended

The conversational wrapper invokes the services factory during construction, so credential validation can fail before execution, violating the stated credential-free wrapper construction guarantee.

1 open issue

• Defer conversational services initialization until execution · New

What changed in this PR

Adds ManagedWorkspace to centralize workspace persistence wiring for coded agents and downstream integrations, helping preserve files across job suspension and resume.

Changes:

• Adds shared workspace, hydrator, and wrapper construction with public exports.
• Preserves local workspace changes across debugger pauses and exposes runtime_id.
• Adds persistence and breakpoint tests and bumps the package to 0.13.7.

File	Description
uv.lock	Updates the locked package version to 0.13.7.
tests/​workspace/​test_workspace_hydration.py	Tests breakpoint continuation and suspension persistence.
tests/​workspace/​test_managed_workspace.py	Tests wrapper wiring, service initialization, persistence, and cleanup.
src/​uipath/​runtime/​workspace/​managed.py	Adds shared workspace and wrapper construction.
src/​uipath/​runtime/​workspace/​hydration.py	Handles debugger pauses and exposes runtime identity.
src/​uipath/​runtime/​workspace/​__init__.py	Exports the new workspace APIs.
src/​uipath/​runtime/​__init__.py	Exposes the new APIs at package level.
pyproject.toml	Bumps the release version to 0.13.7.

_{Review effort: Balanced}