display

type AppProvider interface {
	// ListRunning returns all running applications visible to the windowing system.
	// On macOS this includes every NSRunningApplication. On X11 this enumerates
	// top-level windows via _NET_CLIENT_LIST and deduplicates by PID.
	ListRunning(ctx context.Context) ([]domain.Application, error)

	// Activate brings a running application to the foreground by its stable ID
	// (as returned by ListRunning or GetFocused). Returns an error wrapping
	// ErrAppNotFound when no such application is running, or a generic error
	// when the OS refuses the activation.
	Activate(ctx context.Context, id string) error

	// GetFocused returns the currently focused (frontmost) application.
	// Returns nil with a nil error when no application is focused (headless
	// session with no windows).
	GetFocused(ctx context.Context) (*domain.Application, error)
}

type DisplayController interface {
	// Screen operations
	CaptureScreenBytes(ctx context.Context, region *Region) ([]byte, error)
	CaptureScreen(ctx context.Context, region *Region) (image.Image, error)
	GetScreenDimensions(ctx context.Context) (width, height int, err error)

	// Mouse operations
	GetCursorPosition(ctx context.Context) (x, y int, err error)
	MoveMouse(ctx context.Context, x, y int) error
	ClickMouse(ctx context.Context, button MouseButton, clicks int) error
	ScrollMouse(ctx context.Context, clicks int, direction string) error

	// Keyboard operations
	TypeText(ctx context.Context, text string, delayMs int) error
	SendKeyCombo(ctx context.Context, combo string) error

	// Lifecycle
	Close() error
}

type DisplayInfo struct {
	Name              string // "x11", "wayland", "macos"
	SupportsRegions   bool
	SupportsMouse     bool
	SupportsKeyboard  bool
	MaxTextLength     int
	RequiresElevation bool
}

type MouseButton int

type Provider interface {
	// GetController creates a new DisplayController (display is auto-detected from environment)
	GetController() (DisplayController, error)

	// GetDisplayInfo returns information about the display server/protocol
	GetDisplayInfo() DisplayInfo

	// IsAvailable returns true if this display server is available on the current system
	IsAvailable() bool
}

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

type Registry struct {
	// contains filtered or unexported fields
}