[PR #28122] feat(api): Introduce WorkflowResumptionContext for pause state management #31953

Closed
opened 2026-02-21 20:50:28 -05:00 by yindo · 0 comments
Owner

Original Pull Request: https://github.com/langgenius/dify/pull/28122

State: closed
Merged: Yes


Summary

Certain metadata (including but not limited to InvokeFrom, call_depth, and streaming) is required when resuming a paused workflow. However, these fields are not part of GraphRuntimeState and were not saved in the previous
implementation of PauseStatePersistenceLayer.

This commit addresses this limitation by introducing a WorkflowResumptionContext model that wraps both the *GenerateEntity and GraphRuntimeState. This approach provides:

  • A structured container for all necessary resumption data
  • Better separation of concerns between execution state and persistence
  • Enhanced extensibility for future metadata additions
  • Clearer naming that distinguishes from GraphRuntimeState

The WorkflowResumptionContext model makes extending the pause state easier while maintaining backward compatibility and proper version management for the entire execution state ecosystem.

Resolves #28121.

Screenshots

N/A

Checklist

  • This change requires a documentation update, included: Dify Document
  • I understand that this PR may be closed in case there was no previous discussion or issues. (This doesn't apply to typos!)
  • I've added a test for each change that was introduced, and I tried as much as possible to make a single atomic change.
  • I've updated the documentation accordingly.
  • I ran dev/reformat(backend) and cd web && npx lint-staged(frontend) to appease the lint gods
**Original Pull Request:** https://github.com/langgenius/dify/pull/28122 **State:** closed **Merged:** Yes --- ## Summary Certain metadata (including but not limited to `InvokeFrom`, `call_depth`, and `streaming`) is required when resuming a paused workflow. However, these fields are not part of `GraphRuntimeState` and were not saved in the previous implementation of `PauseStatePersistenceLayer`. This commit addresses this limitation by introducing a `WorkflowResumptionContext` model that wraps both the `*GenerateEntity` and `GraphRuntimeState`. This approach provides: - A structured container for all necessary resumption data - Better separation of concerns between execution state and persistence - Enhanced extensibility for future metadata additions - Clearer naming that distinguishes from `GraphRuntimeState` The `WorkflowResumptionContext` model makes extending the pause state easier while maintaining backward compatibility and proper version management for the entire execution state ecosystem. Resolves #28121. ## Screenshots N/A ## Checklist - [ ] This change requires a documentation update, included: [Dify Document](https://github.com/langgenius/dify-docs) - [x] I understand that this PR may be closed in case there was no previous discussion or issues. (This doesn't apply to typos!) - [x] I've added a test for each change that was introduced, and I tried as much as possible to make a single atomic change. - [x] I've updated the documentation accordingly. - [x] I ran `dev/reformat`(backend) and `cd web && npx lint-staged`(frontend) to appease the lint gods
yindo added the pull-request label 2026-02-21 20:50:28 -05:00
yindo closed this issue 2026-02-21 20:50:28 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#31953