domain

type Action struct {
	Kind      ActionKind
	Target    *Target
	Text      string // type: the text to type
	Combo     string // key: a combo such as "cmd+shift+t"
	Button    string // click kinds: left (default), right, middle
	Direction string // scroll: vertical (default) or horizontal
	Amount    int    // scroll: wheel clicks; negative reverses direction
}

type ActionKind string

type Image struct {
	Data     string // base64-encoded
	MimeType string
	Path     string // on-disk copy, reachable by ImageDecode for non-vision models
}

type Observation struct {
	Message string // LLM-facing outcome description
	CursorX int
	CursorY int
	Width   int // frame-space dimensions
	Height  int
	Image   *Image // set by screenshot actions
}

type Region struct {
	X      int
	Y      int
	Width  int
	Height int
}

type Target struct {
	X int
	Y int
	// Region, on a screenshot action, captures only this rectangle.
	Region *Region
}