Skip to content

Error paths / ON-FAIL in UI steps #4

@Explorer-64

Description

@Explorer-64

Problem

The current spec has no error handling in UI step sequences. VERIFY
tells an agent whether a flow succeeded or failed — but gives no
guidance on what to do next if it fails.

When step 4 fails, agents are left to guess. Common failure scenarios
with no current resolution path:

  • A WAIT times out (element never appears)
  • A VERIFY condition is false
  • A NAVIGATE lands on an error page
  • An INPUT is rejected by validation

Proposed addition

An ON-FAIL clause for steps or capabilities:

WAIT [data-agent-id="result-panel"] (max: 30s)
ON-FAIL VERIFY selector_exists [data-agent-id="error-message"]

Or a capability-level fallback declaration:

on-fail: retry-once | abort | notify-user

Source

Raised during implementation review. Without error paths, agent
behavior on failure is undefined and unpredictable across
implementations.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions