Skip to content

Add CheckPrerequisite to WorkflowStep to validate state machine edges#374

Open
Zoe Zhao (zoez7) wants to merge 4 commits into
agent-substrate:mainfrom
zoez7:check-prerequisite
Open

Add CheckPrerequisite to WorkflowStep to validate state machine edges#374
Zoe Zhao (zoez7) wants to merge 4 commits into
agent-substrate:mainfrom
zoez7:check-prerequisite

Conversation

@zoez7

@zoez7 Zoe Zhao (zoez7) commented Jul 2, 2026

Copy link
Copy Markdown
Collaborator

Fixes #369

Add a CheckPrerequisite method to the WorkflowStep interface, called by RunWorkflow after IsComplete returns false and before Execute, so that each workflow validates its actor state-machine edge up front while retried (reentrant) workflows still fast-forward past completed steps.

@zoez7 Zoe Zhao (zoez7) force-pushed the check-prerequisite branch 4 times, most recently from 9e8acdf to 3921ac8 Compare July 8, 2026 23:55
}
func (s *AssignWorkerStep) CheckPrerequisite(ctx context.Context, input *ResumeInput, state *ResumeState) error {
// The resume edge exists from SUSPENDED and PAUSED.
// RESUMING is allowed for retrying this step.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is because of line 168 below.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could you please clarify what is special at line 168? Is it for cases it was an error in resuming process and we are OK to try resuming one more time?

Same case might happening with Pausing and the CheckPrerequisite for CallAteletPauseStep does not accept pausing state.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated the logic here and stopped allowing resuming state to reenter the AssignWorkerStep. Because setting the state to Resuming is the last step of AssignWorkerStep, if the actor is already in resuming, we know it has completed all the steps and don't need to retry.

On line 168, we would check which worker is assigned and if the worker is no longer eligible, we will pick another one, but this is for cleaning up and doesn't have to be retried during this operation.

Comment thread cmd/ateapi/internal/controlapi/workflow_suspend.go
@zoez7 Zoe Zhao (zoez7) marked this pull request as ready for review July 8, 2026 23:58
return nil
}
func (s *CallAteletPauseStep) Execute(ctx context.Context, input *PauseInput, state *PauseState) error {
if state.Actor.GetAteomPodNamespace() == "" || state.Actor.GetAteomPodName() == "" {

@dberkov Dmitry Berkovich (dberkov) Jul 10, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is a pre-requisite too, however function in current implementation does not support transition to crashActor.

Might be rename the "CheckPrerequisite" to different name? might be allow transition to crash? or might be from the beginning we were not supposed to be in this state, that actor does not have pod or namespace?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should crash the actor here. We can only get here if MarkPausing has succeeded, not having the ateom pod or namespace should crash the actor. I changed the implementation.

Comment thread cmd/ateapi/internal/controlapi/workflow_pause_test.go Outdated
return nil
}
func (s *CallAteletPauseStep) Execute(ctx context.Context, input *PauseInput, state *PauseState) error {
if state.Actor.GetAteomPodNamespace() == "" || state.Actor.GetAteomPodName() == "" {

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should crash the actor here. We can only get here if MarkPausing has succeeded, not having the ateom pod or namespace should crash the actor. I changed the implementation.

Comment thread cmd/ateapi/internal/controlapi/workflow_pause_test.go Outdated
}
func (s *AssignWorkerStep) CheckPrerequisite(ctx context.Context, input *ResumeInput, state *ResumeState) error {
// The resume edge exists from SUSPENDED and PAUSED.
// RESUMING is allowed for retrying this step.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated the logic here and stopped allowing resuming state to reenter the AssignWorkerStep. Because setting the state to Resuming is the last step of AssignWorkerStep, if the actor is already in resuming, we know it has completed all the steps and don't need to retry.

On line 168, we would check which worker is assigned and if the worker is no longer eligible, we will pick another one, but this is for cleaning up and doesn't have to be retried during this operation.

state.ActorTemplate = actorTemplate

// If the Actor is in Resuming state, it means a previous attempt crashed after AssignWorkerStep.
// We don't need to repeat the AssignWorkerStep, load the Worker now.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added this step so if we retry resumeActor for Actor already in RESUMING state, it will still load worker to the ResumeState

func (s *CallAteletRestoreStep) IsComplete(ctx context.Context, input *ResumeInput, state *ResumeState) (bool, error) {
return state.Actor.GetStatus() == ateapipb.Actor_STATUS_RUNNING, nil
}
func (s *CallAteletRestoreStep) CheckPrerequisite(ctx context.Context, input *ResumeInput, state *ResumeState) error {

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I added more checks in CheckPrerequisite to make sure that, if we retry ResumeActor, the Worker assignment and eligibility are still correct for the actor.

…o check the worker eligibility again if previous attempt failed after setting actor to RESUMING state.

If the worker becomes ineligible, set the actor to crashed state.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Actor state machine] Add CheckPrerequisite steps to WorkflowStep definition

3 participants