workflow

type Action struct {
	URL           string       `yaml:"url,omitempty"`
	ForceNavigate bool         `yaml:"force_navigate,omitempty"` // navigate even if URL matches current page
	Headed        bool         `yaml:"headed,omitempty"`         // show browser window (used by BRZ_HEADED=auto)
	Viewport      *Viewport    `yaml:"viewport,omitempty"`       // override workflow-level viewport
	Steps         []Step       `yaml:"steps"`
	Eval          []EvalAssert `yaml:"eval,omitempty"` // post-action assertions
}

type ActionResult struct {
	OK               bool   `json:"ok"`
	Action           string `json:"action"`
	Steps            int    `json:"steps"`
	DurationMs       int64  `json:"duration_ms"`
	Download         string `json:"download,omitempty"`
	DownloadSize     int64  `json:"download_size,omitempty"`
	Error            string `json:"error,omitempty"`
	FailedStep       int    `json:"failed_step,omitempty"`
	StepType         string `json:"step_type,omitempty"`
	Screenshot       string `json:"screenshot,omitempty"`        // page state after failure
	ScreenshotBefore string `json:"screenshot_before,omitempty"` // page state before the failed step
	PageHTML         string `json:"page_html,omitempty"`         // page HTML at time of failure (for debugging)
	PageURL          string `json:"page_url,omitempty"`          // page URL at time of failure
	Escalated        bool   `json:"escalated,omitempty"`         // true if auto-escalated from headless to headed
	StatusCode       int    `json:"status_code,omitempty"`       // HTTP status code of the last navigation

	// Eval results
	EvalsPassed int      `json:"evals_passed,omitempty"` // number of eval assertions that passed
	EvalsFailed int      `json:"evals_failed,omitempty"` // number of eval assertions that failed
	EvalErrors  []string `json:"eval_errors,omitempty"`  // descriptions of failed assertions
}

type ClickStep struct {
	Selector string `yaml:"selector"`
	Text     string `yaml:"text,omitempty"` // match by visible text
	Nth      int    `yaml:"nth,omitempty"`  // 0-indexed, use when multiple matches
	Timeout  string `yaml:"timeout,omitempty"`
}

type DownloadStep struct {
	Timeout string `yaml:"timeout,omitempty"`
	SaveAs  string `yaml:"save_as,omitempty"` // optional filename pattern
}

type ElementInfo struct {
	Selector    string `json:"selector"`
	Tag         string `json:"tag"`
	Type        string `json:"type,omitempty"`
	Name        string `json:"name,omitempty"`
	Placeholder string `json:"placeholder,omitempty"`
	Text        string `json:"text,omitempty"`
	Href        string `json:"href,omitempty"`
	Value       string `json:"value,omitempty"`
	Role        string `json:"role,omitempty"`
	Hidden      bool   `json:"hidden,omitempty"`
}

type EvalAssert struct {
	// Page state
	JS          string `yaml:"js,omitempty"`           // JS expression that must return truthy
	URLContains string `yaml:"url_contains,omitempty"` // current URL must contain this string
	TextVisible string `yaml:"text_visible,omitempty"` // text must be visible on page
	NoText      string `yaml:"no_text,omitempty"`      // text must NOT be visible on page
	Selector    string `yaml:"selector,omitempty"`     // element must exist on page
	Timeout     string `yaml:"timeout,omitempty"`      // timeout for page-state checks (default "5s")

	// Response state
	StatusCode int `yaml:"status_code,omitempty"` // HTTP status code must match (e.g. 200)

	// Download state
	DownloadMinSize    int64    `yaml:"download_min_size,omitempty"`    // downloaded file must be at least N bytes
	DownloadMinRows    int      `yaml:"download_min_rows,omitempty"`    // CSV must have at least N data rows (excluding header)
	DownloadHasColumns []string `yaml:"download_has_columns,omitempty"` // CSV header must contain these columns

	// Metadata
	Label string `yaml:"label,omitempty"` // human-readable description for logging/errors
}

type EvalResult struct {
	Passed int
	Failed int
	Errors []string
}

type Executor struct {

	// LastDownload holds the path to the most recently downloaded file.
	LastDownload string
	// LastResult holds the string result of the most recent action (e.g. downloaded CSV content).
	LastResult string
	// LastStatusCode holds the HTTP status code from the most recent navigation.
	LastStatusCode int
	// contains filtered or unexported fields
}

type FillStep struct {
	Selector string `yaml:"selector"`
	Value    string `yaml:"value"`           // supports ${ENV_VAR} interpolation
	Clear    bool   `yaml:"clear,omitempty"` // clear field before filling
}

type InspectResult struct {
	OK         bool          `json:"ok"`
	URL        string        `json:"url"`
	Title      string        `json:"title"`
	Elements   []ElementInfo `json:"elements"`
	Total      int           `json:"total"`
	Truncated  bool          `json:"truncated,omitempty"`
	DurationMs int64         `json:"duration_ms"`
	Error      string        `json:"error,omitempty"`
}

type Option func(*Executor)

type SelectStep struct {
	Selector string `yaml:"selector"`
	Value    string `yaml:"value,omitempty"`   // option value to select (supports ${ENV_VAR})
	Text     string `yaml:"text,omitempty"`    // match by visible text instead of value
	Timeout  string `yaml:"timeout,omitempty"` // default 5s
}

type SleepStep struct {
	Duration string `yaml:"duration"`
}

type Step struct {
	// Navigation
	Navigate string `yaml:"navigate,omitempty"`

	// Interactions
	Click    *ClickStep    `yaml:"click,omitempty"`
	Fill     *FillStep     `yaml:"fill,omitempty"`
	Select   *SelectStep   `yaml:"select,omitempty"`
	Upload   *UploadStep   `yaml:"upload,omitempty"`
	Download *DownloadStep `yaml:"download,omitempty"`

	// Waits
	WaitVisible *WaitStep    `yaml:"wait_visible,omitempty"`
	WaitText    *WaitStep    `yaml:"wait_text,omitempty"`
	WaitURL     *WaitURLStep `yaml:"wait_url,omitempty"`

	// Utilities
	Screenshot string     `yaml:"screenshot,omitempty"`
	Sleep      *SleepStep `yaml:"sleep,omitempty"`
	Eval       string     `yaml:"eval,omitempty"`

	// Control flow
	Label    string `yaml:"label,omitempty"`    // human-readable step description for logging
	Optional bool   `yaml:"optional,omitempty"` // if true, step failure is non-fatal
}

type UploadStep struct {
	Selector string `yaml:"selector"`
	Source   string `yaml:"source"` // "result" to use previous step's output, or a path
}

type Viewport struct {
	Width  int `yaml:"width"`
	Height int `yaml:"height"`
}

type WaitStep struct {
	Selector string `yaml:"selector,omitempty"`
	Text     string `yaml:"text,omitempty"`
	State    string `yaml:"state,omitempty"` // visible, attached, hidden
	Timeout  string `yaml:"timeout,omitempty"`
}

type WaitURLStep struct {
	Match   string `yaml:"match"`
	Timeout string `yaml:"timeout,omitempty"`
}

type Workflow struct {
	Name             string            `yaml:"name"`
	Env              map[string]string `yaml:"env,omitempty"`
	Viewport         *Viewport         `yaml:"viewport,omitempty"`
	DebugScreenshots *bool             `yaml:"debug_screenshots,omitempty"` // default: true
	Actions          map[string]Action `yaml:"actions"`
}