actions

type BootstrapRequest struct {
	// Site is the registry key, e.g. "tiktok.com". Used for storage path.
	Site string
	// BootstrapURL is the warm-up URL the browser navigates to first.
	BootstrapURL string
	// RequiredCookies is the list of cookie names the caller expects to see
	// set after navigation. Bootstrap keeps waiting (up to Timeout) until all
	// of them are present, so TLS-clients can replay with a valid session.
	RequiredCookies []string
	// Timeout caps the whole navigate + wait operation. Defaults to 45s.
	Timeout time.Duration
	// BrowserPath overrides the Chrome binary if set; otherwise rod picks.
	BrowserPath string
	// Headless runs Chrome without a visible window. Default true. Some
	// sites detect classic headless more aggressively — flip to false for
	// the toughest targets at the cost of a visible Chrome window.
	Headless bool
	// StorageDir is the parent directory where per-site cookie jars live.
	// Typically ~/.hermai/sessions. BootstrapSession writes to
	// {StorageDir}/{Site}/cookies.json.
	StorageDir string
	// PersistentProfileDir is the Chrome user-data-dir to reuse across
	// bootstraps. Empty defaults to ~/.hermai/chrome-profile. Reusing the
	// same dir makes the browser look like a returning user to anti-bot
	// sensors (accumulated TLS tickets, history, IndexedDB). Tests pass a
	// temp dir to isolate state.
	PersistentProfileDir string
}

type BootstrapResult struct {
	Site              string
	CookieCount       int
	RequiredFound     []string // which required_cookies were actually set
	RequiredMiss      []string // required_cookies that never appeared
	AkamaiUnvalidated bool     // _abck was present but never reached ~-1~ validated state
	StoragePath       string   // absolute path to the saved cookies.json
	Duration          time.Duration
}

type Catalog struct {
	Domain   string          `json:"domain"`
	URL      string          `json:"url"`
	Source   string          `json:"source"`
	Coverage string          `json:"coverage,omitempty"`
	Actions  []schema.Action `json:"actions"`
}

type ClearanceResult struct {
	Cookies map[string]string // name → value
	Source  string            // "cache", "bootstrap", or "browser"
}

type CookieFile struct {
	Site     string            `json:"site"`
	SavedAt  time.Time         `json:"saved_at"`
	Domain   string            `json:"domain"`
	Cookies  map[string]string `json:"cookies"`
	Required []string          `json:"required_cookies,omitempty"`
}

type DiscoverOptions struct {
	ProxyURL string
	Insecure bool
}

type ExecutionResult struct {
	URL         string          `json:"url"`
	Action      string          `json:"action"`
	Kind        string          `json:"kind"`
	Transport   string          `json:"transport"`
	Source      string          `json:"source"`
	Content     any             `json:"content,omitempty"`
	Data        any             `json:"data,omitempty"`
	NextActions []schema.Action `json:"next_actions,omitempty"`
	Metadata    Metadata        `json:"metadata"`
}

type HTTPOptions struct {
	ProxyURL        string
	Insecure        bool
	Stealth         bool // use TLS+HTTP/2 fingerprinting (Chrome profile)
	HeaderOverrides map[string]string
	BrowserPath     string        // path to Chromium binary for anti-bot fallback (empty = auto-detect)
	NoBrowser       bool          // disable browser anti-bot fallback entirely
	CacheDir        string        // schema cache dir for persisting clearance cookies
	Cache           cache.Service // optional pre-built cache (takes precedence over CacheDir)
}

type Metadata struct {
	StatusCode     int   `json:"status_code"`
	TotalLatencyMs int64 `json:"total_latency_ms"`
}