[tudormatei1]

Coded LangGraph and deepagents agents now keep the files they write across suspend and resume. The factory opts in to the CLI-managed workspace from UiPath/uipath-python#1976, and UiPathWorkspaceBackend gives deepagents a file backend rooted in that workspace.

Changes

• UiPathWorkspaceBackend (agent/advanced/workspace_backend.py) is a deepagents FilesystemBackend that looks up its root with get_workspace_path() on every file operation. Coded graphs are built once at import, before any run, so a root fixed when the graph is built would never be the run's folder. Outside a managed run (local runs, uipath dev, older CLIs) it uses one temp folder and logs a warning naming it. It never falls back to the project folder, so an agent can't edit the project's files.
• get_settings() returns managed_workspace=True. Older CLIs ignore the flag.
• Docs: a "Keeping files across suspend and resume" section in docs/human_in_the_loop.md, for the backend and for plain tools that call get_workspace_path().
• Sample: samples/deepagent-workspace-files, a deepagents agent that writes /report.md, suspends on interrupt() for a review, and edits the same file after resume. Its review tool reads the draft from disk with plain Python, which is the case for real files over DeepAgents' default StateBackend.
• Version 0.18.57 (0.18.56 is taken by the open PC-5320 work).

Note

This works with the released uipath-runtime. The docs describe CLI behavior from UiPath/uipath-python#1976, so release that first or together. uipath-agents overrides get_settings with the flag off, so low-code agents aren't wrapped twice.

Testing

• New tests: the backend reads, writes, lists, globs and greps inside the managed folder; a file written in one run is back after resume; traversal outside the folder is blocked; the fallback folder is created once. The factory test checks the flag.
• Full suite in this repo's own venv: 4247 passed.
• Live on alpha with the four PR branches installed together: a coded LangGraph job writes through UiPathWorkspaceBackend, suspends on interrupt(), and uipath run --resume in a new process reads the file back from job attachments.
• The sample, live on alpha with an existing job key: run 1 wrote /report.md and suspended in request_review. uipath run --resume in a new process ran edit_file on the restored file, and the final report included the feedback. Without a job key, the resume finds no draft, as its README says.
• Not run: a real serverless job.

🤖 Generated with Claude Code

[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