Title: [DX] GAP-04: MemorySaver + cross-process --resume interaction is undocumented and silently broken · Issue #1497 · UiPath/uipath-python · GitHub
Open Graph Title: [DX] GAP-04: MemorySaver + cross-process --resume interaction is undocumented and silently broken · Issue #1497 · UiPath/uipath-python
X Title: [DX] GAP-04: MemorySaver + cross-process --resume interaction is undocumented and silently broken · Issue #1497 · UiPath/uipath-python
Description: Summary Using --resume with MemorySaver sometimes re-runs the agent from scratch instead of resuming at the interrupt point, with no error message. The behavior is inconsistent and there is no documentation explaining why or how to fix i...
Open Graph Description: Summary Using --resume with MemorySaver sometimes re-runs the agent from scratch instead of resuming at the interrupt point, with no error message. The behavior is inconsistent and there is no docu...
X Description: Summary Using --resume with MemorySaver sometimes re-runs the agent from scratch instead of resuming at the interrupt point, with no error message. The behavior is inconsistent and there is no docu...
Opengraph URL: https://github.com/UiPath/uipath-python/issues/1497
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"[DX] GAP-04: MemorySaver + cross-process --resume interaction is undocumented and silently broken","articleBody":"## Summary\n\nUsing `--resume` with `MemorySaver` sometimes re-runs the agent from scratch instead of resuming at the interrupt point, with no error message. The behavior is inconsistent and there is no documentation explaining why or how to fix it.\n\n## Root Cause\n\n`MemorySaver` is an in-memory checkpointer. When the initial process exits (normally or due to an interrupt), all checkpoints are lost. When `--resume` is called in a new process, there are no checkpoints to restore from — so the runtime either starts a fresh run silently or fails in an opaque way.\n\nWhether the runtime injects its own SQLite-backed checkpointer (and under what conditions) depends on the presence of `--state-file`, but this behavior is not documented anywhere.\n\n## Observed Behaviour\n\n1. Run agent: `uv run uipath run agent.py '{\"invoices\": [...]}'`\n2. Agent hits `interrupt()`, process suspends\n3. Human completes the Action Center task\n4. Run: `uv run uipath run agent.py --resume`\n5. Result: agent starts from scratch (re-runs all tools) rather than resuming at the interrupt\n\nNo error is printed. The `--resume` flag appears to succeed but the checkpoint is not found.\n\n## Workaround\n\nAlways pass `--state-file` on **both** the initial run and every `--resume`:\n\n```bash\n# Initial run\nuv run uipath run agent.py '{\"invoices\": [...]}' --state-file ./agent-state.db\n\n# Resume\nuv run uipath run agent.py --resume --state-file ./agent-state.db\n```\n\nWhen `--state-file` is provided, the runtime persists LangGraph checkpoints in a SQLite file that survives across process invocations.\n\n## Suggested Fix\n\n1. Print which checkpointer is active at startup (e.g. `INFO: Using SqliteCheckpointer (state-file: ./agent-state.db)`)\n2. Warn at startup if `MemorySaver` is detected and `--state-file` is not provided:\n ```\n Warning: MemorySaver is in-memory only. Cross-process --resume will silently fail. \n Use --state-file to persist checkpoints across process invocations.\n ```\n3. Document the `--state-file` requirement prominently in the HITL/interrupt docs.\n\n## Impact\n\n- Severity: **Medium**\n- Affects all LangGraph agents using `interrupt()` + `MemorySaver` for local development\n- The silent failure mode causes developers to waste significant time debugging why resume doesn't work","author":{"url":"https://github.com/AlexBizon","@type":"Person","name":"AlexBizon"},"datePublished":"2026-03-26T15:22:13Z","url":"https://github.com/UiPath/uipath-python/issues/1497"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:97353db0-d63d-1883-61a6-44b75015c271 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | E6F8:31D53E:1E9847:28C43C:6AFF631E |
| html-safe-nonce | 9be4beb2936070cd1114081422d308224c69d4c5e85f458148730e503bb4b234 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFNkY4OjMxRDUzRToxRTk4NDc6MjhDNDNDOjZBRkY2MzFFIiwidmlzaXRvcl9pZCI6IjUwODg1MDQ1NDA1NzYwNDc5MDIiLCJyZWdpb25fZWRnZSI6ImlhZCIsInJlZ2lvbl9yZW5kZXIiOiJpYWQifQ== |
| visitor-hmac | cb9e50766d2a776d0933c95bd26ee71d50b1b0938f733bcc958495023d7f03c0 |
| hovercard-subject-tag | issue:4144968276 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/UiPath/uipath-python/1497/issue_layout |
| twitter:image | https://opengraph.githubassets.com/6e9474c79086838ae319142c180c1e26f7cadb4c8bc8513ce3287eab1b932628/UiPath/uipath-python/issues/1497 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/6e9474c79086838ae319142c180c1e26f7cadb4c8bc8513ce3287eab1b932628/UiPath/uipath-python/issues/1497 |
| og:image:alt | Summary Using --resume with MemorySaver sometimes re-runs the agent from scratch instead of resuming at the interrupt point, with no error message. The behavior is inconsistent and there is no docu... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | AlexBizon |
| hostname | github.com |
| expected-hostname | github.com |
| None | 41b58589a1c4eda1e3c8904144a412b88ca4455f63ca2ad3629f2e9f3c3a1d12 |
| turbo-cache-control | no-preview |
| go-import | github.com/UiPath/uipath-python git https://github.com/UiPath/uipath-python.git |
| octolytics-dimension-user_id | 375663 |
| octolytics-dimension-user_login | UiPath |
| octolytics-dimension-repository_id | 925171912 |
| octolytics-dimension-repository_nwo | UiPath/uipath-python |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 925171912 |
| octolytics-dimension-repository_network_root_nwo | UiPath/uipath-python |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 8968d6d6acc65d74e4df332d23932dd3fd0502a4 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width