bridge

type A11yNode = bridgeobserve.A11yNode

type ActionFunc func(ctx context.Context, req ActionRequest) (map[string]any, error)

type ActionRecord struct {
	Timestamp  time.Time `json:"timestamp"`
	Method     string    `json:"method"`
	Endpoint   string    `json:"endpoint"`
	URL        string    `json:"url"`
	TabID      string    `json:"tabId"`
	DurationMs int64     `json:"durationMs"`
	Status     int       `json:"status"`
}

type ActionRequest struct {
	TabID    string `json:"tabId"`
	Kind     string `json:"kind"`
	Ref      string `json:"ref,omitempty"`
	Selector string `json:"selector,omitempty"`

	// Text/Value use omitempty, and HasText records that one of them was
	// SUPPLIED, for the same reason X/Y do below: an empty fill is a
	// legitimate request to clear the field, so absent and empty must not
	// share a representation. While they did, `fill` could not refuse a
	// request whose text never arrived — it wrote "" and answered
	// filled:true, len:0 — and its read-back verification, gated on a
	// non-empty Text, switched itself off in exactly that case. Re-marshaling
	// without omitempty would re-introduce "text":"" and make every forwarded
	// request look supplied.
	Text    string `json:"text,omitempty"`
	Value   string `json:"value,omitempty"`
	HasText bool   `json:"hasText,omitempty"`

	Key    string `json:"key"`
	NodeID int64  `json:"nodeId"`

	// X/Y use omitempty so that re-marshaling an ActionRequest without
	// explicit coordinates (e.g. when the tab-scoped handler forwards to
	// the generic one) doesn't spuriously re-introduce "x":0, "y":0. The
	// ActionRequest.UnmarshalJSON code infers HasXY from the presence of
	// these keys, so preserving omission is what makes "use current
	// pointer" work for mouse-down/up after a prior mouse-move. HasXY is
	// still marshaled (with omitempty) when it was explicitly set, which
	// preserves the explicit-click-at-(0,0) case through the round-trip.
	X      float64 `json:"x,omitempty"`
	Y      float64 `json:"y,omitempty"`
	HasXY  bool    `json:"hasXY,omitempty"`
	Button string  `json:"button,omitempty"`
	Mode   string  `json:"mode,omitempty"`

	// FrameW/FrameH are the pixel dimensions of the screencast frame the caller
	// mapped the coordinates against (the dashboard maps a click to frame-pixel
	// space). When set, X/Y are scaled from that frame space into the live CSS
	// viewport before dispatch, so a HiDPI frame (e.g. 2x the CSS viewport) does
	// not land clicks at twice their intended position. Zero means X/Y are
	// already CSS pixels.
	FrameW float64 `json:"frameW,omitempty"`
	FrameH float64 `json:"frameH,omitempty"`

	// Modifiers is the CDP key-modifier bitmask (Alt=1, Ctrl=2, Meta=4, Shift=8)
	// held during a press, enabling keyboard chords such as Ctrl+C or Shift+Arrow.
	Modifiers int `json:"modifiers,omitempty"`

	// ScrollX/ScrollY use omitempty for the same reason X/Y do: UnmarshalJSON
	// infers HasScroll from the presence of these keys, so a re-marshal that
	// re-introduced "scrollX":0 would turn every bare scroll into an explicit
	// zero and refuse it. The explicit zero survives the omission because
	// HasScroll is itself marshaled and the decoder ORs it back in — that is
	// what keeps an explicit zero from decaying into the default 120px step.
	ScrollX int `json:"scrollX,omitempty"`
	ScrollY int `json:"scrollY,omitempty"`

	HasScroll bool `json:"hasScroll,omitempty"`
	// DeltaX/DeltaY are the wheel spelling; ScrollX/ScrollY remain for compatibility.
	DeltaX   int  `json:"deltaX,omitempty"`
	DeltaY   int  `json:"deltaY,omitempty"`
	HasDelta bool `json:"hasDelta,omitempty"`
	DragX    int  `json:"dragX"`
	DragY    int  `json:"dragY"`

	// A drag's destination. ToSelector takes the same unified selector vocabulary as
	// Selector and the handler resolves it to ToNodeID; HasToXY separates an absent
	// destination from the legitimate one at (0,0).
	ToSelector string  `json:"toSelector,omitempty"`
	ToNodeID   int64   `json:"toNodeId,omitempty"`
	ToX        float64 `json:"toX,omitempty"`
	ToY        float64 `json:"toY,omitempty"`
	HasToXY    bool    `json:"hasToXY,omitempty"`

	WaitNav bool   `json:"waitNav"`
	Fast    bool   `json:"fast"`
	Owner   string `json:"owner"`
	// Submit is an explicit opt-in to a terminal action. Fill dispatches Enter
	// after filling; click uses one DOM click and lets the handler observe a
	// bounded post-submit state. Ordinary clicks retain their normal delivery.
	Submit bool `json:"submit,omitempty"`

	// DismissBanners, when true and combined with WaitNav, runs a best-effort
	// cookie/consent-banner dismissal pass after a click that triggered a
	// navigation. Bridge layer ignores this field; the handler reads it and
	// invokes the dismissal helper post-action. No effect on actions that
	// don't trigger navigation.
	DismissBanners bool `json:"dismissBanners,omitempty"`
	// DismissKnownInterstitials requests the conservative, catalog-backed
	// pre-action pass. Unlike DismissBanners it never removes generic overlays.
	DismissKnownInterstitials bool `json:"dismissKnownInterstitials,omitempty"`

	// Humanize, when set, overrides the per-instance `humanize` default for
	// this action only. nil = use the configured default. true forces the
	// bezier/jitter/pre-press-sleep code path; false forces the raw
	// straight-to-target dispatch.
	Humanize *bool `json:"humanize,omitempty"`

	// AutoSwitch, when explicitly set to false, disables the popup-aware
	// auto-switch behavior on click actions. nil or true = on (default). When
	// on, a click that opens a new tab adopts + focuses it and surfaces the
	// new tab ID on the response as "switchedToTab". Only click/dblclick
	// honor this field.
	AutoSwitch *bool `json:"autoSwitch,omitempty"`

	// DialogAction arms a one-shot dialog auto-handler before the action
	// executes. Used when clicking a button/link that opens a JS dialog
	// (alert/confirm/prompt). Values: "accept" or "dismiss". When set, the
	// dialog is handled automatically without a second HTTP call.
	DialogAction string `json:"dialogAction,omitempty"`
	// DialogText is the optional prompt text used when DialogAction is
	// "accept" on a prompt() dialog.
	DialogText string `json:"dialogText,omitempty"`

	// Browser specifies which browser to use for this request (e.g. "chrome",
	// "cloak", "ghost-chrome"). Validated against configured + registry
	// browsers. Recorded on route metadata but does not change actual
	// routing yet.
	Browser string `json:"browser,omitempty"`

	Vocab string `json:"vocab,omitempty"`
}

type AnalyticsReport struct {
	TotalActions   int            `json:"totalActions"`
	Last24h        int            `json:"last24h"`
	CommonHosts    map[string]int `json:"commonHosts"`
	TopEndpoints   map[string]int `json:"topEndpoints,omitempty"`
	RepeatPatterns []string       `json:"repeatPatterns,omitempty"`
	Suggestions    []string       `json:"suggestions,omitempty"`
}

type BoundingBox = bridgeobserve.BoundingBox

type Bridge struct {
	AllocCtx      context.Context
	AllocCancel   context.CancelFunc
	BrowserCtx    context.Context
	BrowserCancel context.CancelFunc
	Config        *config.RuntimeConfig
	URLReader     URLReader
	IdMgr         *ids.Manager
	*TabManager
	StealthBundle *stealth.Bundle
	Actions       map[string]ActionFunc
	Locks         *LockManager
	Dialogs       *DialogManager
	LogStore      *ConsoleLogStore
	// contains filtered or unexported fields
}

type BridgeAPI interface {
	BrowserContext() context.Context
	TabContext(tabID string) (ctx *TabHandle, resolvedID string, err error)
	ListTargets() ([]TabTarget, error)
	CreateTab(url string) (tabID string, ctx context.Context, cancel context.CancelFunc, err error)
	CloseTab(tabID string) error
	FocusTab(tabID string) error

	// ScheduleAutoClose (re)arms the per-tab idle close timer when the
	// lifecycle policy is "close_idle". No-op otherwise.
	ScheduleAutoClose(tabID string)
	CancelAutoClose(tabID string)

	GetRefCache(tabID string) *RefCache
	SetRefCache(tabID string, cache *RefCache)
	DeleteRefCache(tabID string)

	ExecuteAction(ctx context.Context, kind string, req ActionRequest) (map[string]any, error)
	AvailableActions() []string

	// Execute runs a task for a tab with per-tab sequential execution
	// and cross-tab bounded parallelism. If not supported, runs directly.
	Execute(ctx context.Context, tabID string, task func(ctx context.Context) error) error

	TabLockInfo(tabID string) *LockInfo
	Lock(tabID, owner string, ttl time.Duration) error
	Unlock(tabID, owner string) error

	EnsureBrowser(cfg *config.RuntimeConfig) error
	RestartBrowser(cfg *config.RuntimeConfig) error
	// RunningBrowser reports the provider of the live browser process, or
	// ("", false) when nothing is running. EnsureBrowser ignores the requested
	// config once initialized, so handlers use this to reject explicit
	// browser params that the running process cannot honor.
	RunningBrowser() (string, bool)
	StealthStatus() *stealth.Status

	GetMemoryMetrics(tabID string) (*MemoryMetrics, error)
	GetBrowserMemoryMetrics() (*MemoryMetrics, error)
	GetAggregatedMemoryMetrics() (*MemoryMetrics, error)

	GetCrashLogs() []string

	NetworkMonitor() *NetworkMonitor

	AddRouteRule(tabID string, rule RouteRule) error
	RemoveRouteRule(tabID, pattern string) (int, error)
	ListRouteRules(tabID string) ([]RouteRule, error)

	GetDialogManager() *DialogManager

	GetConsoleLogs(tabID string, limit int) []LogEntry
	ClearConsoleLogs(tabID string)
	GetErrorLogs(tabID string, limit int) []ErrorEntry
	ClearErrorLogs(tabID string)

	Navigate(ctx context.Context, url string, params NavigateParams) (*NavigateResult, error)

	Snapshot(ctx context.Context, tabID string, filter string, params ContentParams) (*SnapshotResult, error)

	Text(ctx context.Context, tabID string, params ContentParams) (*TextResult, error)

	ClearCache(ctx context.Context) error
	CanClearCache(ctx context.Context) (bool, error)

	ClearCookies(ctx context.Context) error

	Evaluate(ctx context.Context, expression string, result any, opts EvalOpts) error

	// CallFunctionOnNode resolves a backend node ID to a Runtime object,
	// then calls the given JavaScript function on it. args may be nil.
	// The result is unmarshaled from the CDP returnByValue response.
	CallFunctionOnNode(ctx context.Context, backendNodeID int64, functionDecl string, args []map[string]any, result any) error

	// EvaluateInFrame evaluates a JavaScript expression in the given
	// frame's execution context. If frameID is empty, behaves like Evaluate.
	EvaluateInFrame(ctx context.Context, frameID string, expression string, result any, opts EvalOpts) error

	DescribeNode(ctx context.Context, backendNodeID int64) (*NodeInfo, error)

	CaptureScreenshot(ctx context.Context, format string, quality int, clip *cdptk.ScreenshotClip) ([]byte, error)

	StartScreencast(ctx context.Context, opts ScreencastOpts) (*ScreencastStream, error)

	SetViewport(ctx context.Context, params ViewportParams) error
	SetGeolocation(ctx context.Context, lat, lng, accuracy float64) error
	SetEmulatedMedia(ctx context.Context, feature, value string) error

	SetNetworkConditions(ctx context.Context, params NetworkConditions) error
	SetExtraHTTPHeaders(ctx context.Context, headers map[string]string) error
	GetCookies(ctx context.Context, urls []string) ([]CookieData, error)
	SetCookie(ctx context.Context, params SetCookieParams) error

	CurrentURL(ctx context.Context) (string, error)
	CurrentTitle(ctx context.Context) (string, error)

	PrintToPDF(ctx context.Context, params PDFParams) ([]byte, error)

	SetFileInputFiles(ctx context.Context, nodeID int64, paths []string) error
	ResolveSelectorToNodeID(ctx context.Context, selector string) (int64, error)

	DownloadURL(ctx context.Context, dlURL string, opts DownloadOpts) (*DownloadResult, error)

	EnableFetchWithAuth(ctx context.Context) error
	DisableFetch(ctx context.Context) error
	ListenAuthRequired(ctx context.Context, handler func(requestID string, isAuth bool))
	ContinueWithAuth(ctx context.Context, requestID, username, password string) error
	ContinueRequest(ctx context.Context, requestID string) error
	// SetFetchPauseSuppressed toggles per-tab suppression of the proxy-auth
	// listener's blanket ContinueRequest while the credentials handler owns
	// request-pause dispatch. Declared here (not probed) so decorated bridges
	// forward it instead of silently dropping the suppression contract.
	SetFetchPauseSuppressed(tabID string, v bool)

	GoBack(ctx context.Context) (didNavigate bool, err error)
	GoForward(ctx context.Context) (didNavigate bool, err error)
	Reload(ctx context.Context) error

	WaitVisible(ctx context.Context, selector string) error

	EnableNetwork(ctx context.Context) error
	ListenNetworkEvents(ctx context.Context, handler NetworkEventHandler)

	SetRawCookie(ctx context.Context, params RawSetCookieParams) error
	GetRawCookies(ctx context.Context) ([]RawCookie, error)

	SetUserAgentOverride(ctx context.Context, params UserAgentOverrideParams) error
	SetLocaleOverride(ctx context.Context, locale string) error
	SetTimezoneOverride(ctx context.Context, timezoneID string) error
	SetDeviceMetricsOverride(ctx context.Context, params DeviceMetricsOverrideParams) error
	AddScriptToEvaluateOnNewDocument(ctx context.Context, source string) (string, error)
}

type CaptureOpts struct {
	Image              ScreenshotOpts
	Filter             string // snapshot filter ("" or FilterInteractive)
	MaxDepth           int    // -1 for full tree
	ScopeBackendNodeID int64  // optional snapshot subtree scope
	ScopeFrameID       string // optional frame-scoped capture
	DisableAnimations  bool

	// Wait controls the lifecycle wait before the capture window opens.
	// Empty (or "none") skips the wait. "load" polls document.readyState
	// until it reaches "complete" (2s ceiling). "stable" waits for
	// Page.lifecycleEvent quiescence — 250ms of silence, 750ms ceiling.
	Wait string

	// WithBounds populates BoundingBox + Visible on every snapshot node that
	// has a non-zero backend node id. Adds one DOM.getBoxModel round trip
	// per node (~5ms each).
	WithBounds bool
}

type Config struct {
	Rand *rand.Rand
}

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

type ContentParams struct {
	ContentGuard *contentguard.Scanner
	MaxDepth     int // max AX tree depth for snapshots; 0 or -1 means unlimited
	SkipMetadata bool
}

type CookieData = runtimetypes.CookieData

type CrashEvent struct {
	Time       time.Time `json:"time"`
	TargetID   string    `json:"targetId,omitempty"`
	TabID      string    `json:"tabId,omitempty"`
	URL        string    `json:"url,omitempty"`
	Reason     string    `json:"reason"`
	LastError  string    `json:"lastError,omitempty"`
	Generation uint64    `json:"-"`
}

type CrashHandler func(event CrashEvent)

type DeviceMetricsOverrideParams struct {
	Width             int64
	Height            int64
	DeviceScaleFactor float64
	Mobile            bool
	ScreenWidth       int64
	ScreenHeight      int64
}

type DialogManager = bridgetabs.DialogManager

type DialogResult = bridgetabs.DialogResult

type DialogState = bridgetabs.DialogState

type DownloadOpts = runtimetypes.DownloadOpts

type DownloadResult = runtimetypes.DownloadResult

type ErrDialogBlocking struct {
	DialogType    string
	DialogMessage string
}

type ErrorEntry struct {
	Timestamp time.Time `json:"timestamp"`
	Message   string    `json:"message"`
	Type      string    `json:"type,omitempty"`
	URL       string    `json:"url,omitempty"`
	Line      int64     `json:"line,omitempty"`
	Column    int64     `json:"column,omitempty"`
	Stack     string    `json:"stack,omitempty"`
}

type EvalOpts = runtimetypes.EvalOpts

type ExecutorStats = bridgetabs.ExecutorStats

type FrameContext = bridgeobserve.FrameContext

type FrameElementMeta struct {
	TagName string `json:"tagName"`
	ID      string `json:"id,omitempty"`
	Name    string `json:"name,omitempty"`
	Title   string `json:"title,omitempty"`
	Src     string `json:"src,omitempty"`
}

type FrameScope struct {
	FrameID   string `json:"frameId,omitempty"`
	FrameURL  string `json:"frameUrl,omitempty"`
	FrameName string `json:"frameName,omitempty"`
	OwnerRef  string `json:"ownerRef,omitempty"`
}

type Instance struct {
	ID             string          `json:"id"`            // Hash-based ID: inst_XXXXXXXX
	ProfileID      string          `json:"profileId"`     // Hash-based profile ID: prof_XXXXXXXX
	ProfileName    string          `json:"profileName"`   // Human-readable profile name (for display only)
	Port           string          `json:"port"`          // Internal: instance port
	URL            string          `json:"url,omitempty"` // Canonical base URL for bridge-backed instances
	Mode           string          `json:"mode"`          // API mode: "headless" or "headed"
	Headless       bool            `json:"headless"`      // Mode: headless vs headed
	Status         string          `json:"status"`        // Status: starting/running/stopping/stopped/error
	StartTime      time.Time       `json:"startTime"`
	Error          string          `json:"error,omitempty"`      // Error message if status=error
	Attached       bool            `json:"attached"`             // True if attached rather than locally launched
	AttachType     string          `json:"attachType,omitempty"` // "cdp" or "bridge" for attached instances
	CdpURL         string          `json:"cdpUrl,omitempty"`     // CDP WebSocket URL (for CDP-attached instances)
	SecurityPolicy *SecurityPolicy `json:"securityPolicy,omitempty"`

	Browser string `json:"browser,omitempty"`

	// FallbackFrom/FallbackReason: omitempty keeps successful-launch
	// Instance JSON byte-identical to pre-P2.4a output.
	FallbackFrom   string `json:"fallbackFrom,omitempty"`
	FallbackReason string `json:"fallbackReason,omitempty"`
}

type InstanceTab struct {
	ID         string `json:"id"`         // Runtime tab ID (raw CDP target ID on this branch)
	InstanceID string `json:"instanceId"` // Hash-based instance ID: inst_XXXXXXXX
	URL        string `json:"url"`
	Title      string `json:"title"`
}

type LockInfo = bridgetabs.LockInfo

type LockManager = bridgetabs.LockManager

type LogEntry struct {
	Timestamp time.Time `json:"timestamp"`
	Level     string    `json:"level"`
	Message   string    `json:"message"`
	Source    string    `json:"source,omitempty"`
}

type MemoryMetrics = bridgeobserve.MemoryMetrics

type NavigateParams struct {
	MaxRedirects int
	// DispatchOnly sends Page.navigate and returns after Chrome accepts it,
	// without waiting for load/ready state. The caller must poll the explicit
	// tab for readiness. This is used for headed background tabs whose SPA load
	// event can remain pending indefinitely without ever activating the window.
	DispatchOnly       bool
	AllowInternal      bool
	TrustedProxyCIDRs  []net.IPNet
	TrustedResolvedIPs []net.IP
	IDPIGuard          idpi.Guard
	// NoEscalate makes a static-first bridge return *StaticEscalateError
	// instead of internally escalating to Chrome. Handlers use it to defer
	// the Chrome launch until the static path has proven insufficient.
	NoEscalate bool
	// SkipStatic bypasses the static-first attempt entirely (the handler
	// already ran it via NoEscalate and is escalating).
	SkipStatic bool
}

type NavigateResult struct {
	TabID string
	URL   string
	Title string
	Route *browserops.RouteMetadata
}

type NetworkBuffer = bridgeobserve.NetworkBuffer

type NetworkConditions = runtimetypes.NetworkConditions

type NetworkEntry = bridgeobserve.NetworkEntry

type NetworkEventHandler struct {
	OnRequestWillBeSent func(frameID, requestID string, resourceType string)
	OnResponseReceived  func(requestID string, remoteIPAddress string)
}

type NetworkFilter = bridgeobserve.NetworkFilter

type NetworkMonitor = bridgeobserve.NetworkMonitor

type NodeInfo = runtimetypes.NodeInfo

type OrchestratorService interface {
	RegisterHandlers(mux *http.ServeMux)
	Launch(name, port string, headless bool, extensionPaths []string) (*Instance, error)
	Stop(id string) error
	StopProfile(name string) error
	List() []Instance
	Logs(id string) (string, error)
	FirstRunningURL() string
	AllTabs() []InstanceTab
	FindInstanceByTab(tabID string) (*Instance, bool)
	ScreencastURL(instanceID, tabID string) string
	Shutdown()
	ForceShutdown()
}

type PDFParams = runtimetypes.PDFParams

type PairedResult struct {
	URL        string
	Title      string
	CapturedAt time.Time
	DurationMs int64

	FrameID   string
	LoaderID  string
	DomEpoch  string
	Navigated bool

	ImageBytes  []byte
	ImageFormat string // "jpeg" or "png"

	// Viewport metadata captured alongside the image. CoordinateSpace is
	// "viewport" by default, "document" when ImageOpts.BeyondViewport is true,
	// and "clip" for selector-clipped captures. Bounding boxes are expressed in
	// the named space.
	Viewport        ViewportInfo
	CoordinateSpace string
	Clip            *page.Viewport

	Filter string
	Nodes  []A11yNode
	Refs   map[string]int64
}

type ProfileInfo struct {
	ID                string    `json:"id,omitempty"`
	Name              string    `json:"name"`
	Path              string    `json:"path,omitempty"`
	PathExists        bool      `json:"pathExists,omitempty"`
	Created           time.Time `json:"created"`
	LastUsed          time.Time `json:"lastUsed"`
	DiskUsage         int64     `json:"diskUsage"`
	Running           bool      `json:"running"`
	Temporary         bool      `json:"temporary,omitempty"`   // ephemeral instance profiles (auto-generated)
	Quarantined       bool      `json:"quarantined,omitempty"` // corrupted profiles renamed aside by quarantine
	Source            string    `json:"source,omitempty"`
	ChromeProfileName string    `json:"chromeProfileName,omitempty"`
	AccountEmail      string    `json:"accountEmail,omitempty"`
	AccountName       string    `json:"accountName,omitempty"`
	HasAccount        bool      `json:"hasAccount,omitempty"`
	UseWhen           string    `json:"useWhen,omitempty"`
	Description       string    `json:"description,omitempty"`
}

type ProfileService interface {
	RegisterHandlers(mux *http.ServeMux)
	List() ([]ProfileInfo, error)
	Create(name string) error
	Import(name, sourcePath string) error
	Reset(name string) error
	Delete(name string) error
	Logs(name string, limit int) []ActionRecord
	Analytics(name string) AnalyticsReport
	RecordAction(profile string, record ActionRecord)
}

type QuarantineRemoval struct {
	Path  string
	Bytes int64
}

type RawAXNode = bridgeobserve.RawAXNode

type RawAXProp = bridgeobserve.RawAXProp

type RawAXValue = bridgeobserve.RawAXValue

type RawCookie struct {
	Name     string  `json:"name"`
	Value    string  `json:"value"`
	Domain   string  `json:"domain"`
	Path     string  `json:"path"`
	Expires  float64 `json:"expires"`
	Secure   bool    `json:"secure"`
	HTTPOnly bool    `json:"httpOnly"`
	SameSite string  `json:"sameSite"`
}

type RawFrame = bridgeobserve.RawFrame

type RawFrameTree = bridgeobserve.RawFrameTree

type RawSetCookieParams struct {
	Name     string
	Value    string
	Domain   string
	Path     string
	Secure   bool
	HTTPOnly bool
	SameSite string // "Strict", "Lax", "None", or ""
}

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

type RefCache struct {
	Refs     map[string]int64
	Targets  map[string]RefTarget
	Nodes    []A11yNode
	DomEpoch string
	Book     *RefBook
}

type RefTarget struct {
	BackendNodeID  int64  `json:"backendNodeId"`
	FrameID        string `json:"frameId,omitempty"`
	FrameURL       string `json:"frameUrl,omitempty"`
	FrameName      string `json:"frameName,omitempty"`
	ChildFrameID   string `json:"childFrameId,omitempty"`
	ChildFrameURL  string `json:"childFrameUrl,omitempty"`
	ChildFrameName string `json:"childFrameName,omitempty"`
}

type RouteAction string

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

type RouteRule struct {
	Pattern      string      `json:"pattern"`
	Action       RouteAction `json:"action"`
	Body         string      `json:"body,omitempty"`
	ContentType  string      `json:"contentType,omitempty"`
	Status       int         `json:"status,omitempty"`
	ResourceType string      `json:"resourceType,omitempty"`

	// Method, when non-empty, narrows matches to the given HTTP method
	// (case-insensitive). Empty Method matches any method, with one exception:
	// fulfill rules skip OPTIONS preflights by default — fulfilling preflights
	// can break or bypass CORS, so the operator must explicitly set
	// Method="OPTIONS" to opt in.
	Method string `json:"method,omitempty"`
	// contains filtered or unexported fields
}

type ScreencastOpts = runtimetypes.ScreencastOpts

type ScreencastStream = runtimetypes.ScreencastStream

type ScreenshotClip = page.Viewport

type ScreenshotFormat = page.CaptureScreenshotFormat

type ScreenshotOpts struct {
	Format         page.CaptureScreenshotFormat
	Quality        int
	Clip           *page.Viewport
	BeyondViewport bool

	// Scale rescales the rendered output bitmap. 1 (or 0) = native. 0.5
	// halves the image in each axis (quarter of the pixels). Applied via
	// CDP's clip.scale; when no Clip is otherwise set we synthesize one
	// covering the viewport so the parameter takes effect.
	Scale float64

	// ViewportWidth/ViewportHeight are used only when Scale != 1 and Clip is
	// nil — to build a viewport-covering clip. Callers fetch these from
	// observe.FetchLayout (or similar) before invoking CaptureScreenshot.
	ViewportWidth  float64
	ViewportHeight float64

	// DisableActivation suppresses the Page.bringToFront call that wakes a
	// backgrounded tab's compositor before capturing (the inverse of
	// instanceDefaults.captureAllowActivation, default true — so the zero
	// value here is the safe/reliable default even if a caller forgets to
	// set it). When true, capture relies solely on focus emulation and never
	// raises the tab in the operator's browser, accepting that a background
	// tab's capture may then block until the caller's deadline.
	DisableActivation bool
}

type SecurityPolicy struct {
	AllowedDomains []string `json:"allowedDomains,omitempty"`
}

type SessionState struct {
	Tabs    []TabState `json:"tabs"`
	SavedAt string     `json:"savedAt"`
}

type SetCookieParams = runtimetypes.SetCookieParams

type SnapshotResult struct {
	Nodes       []A11yNode
	Refs        map[string]int64
	Targets     map[string]RefTarget
	URL         string
	Title       string
	Truncated   bool
	Hint        string
	IDPIWarning string
	Route       *browserops.RouteMetadata
}

type StaticEscalateError struct {
	Quality int
	Reason  string
	Route   *browserops.RouteMetadata
}

type TabEntry struct {
	Ctx                   context.Context
	Cancel                context.CancelFunc
	Accessed              bool
	CDPID                 string // raw CDP target ID
	CreatedAt             time.Time
	LastUsed              time.Time
	Policy                TabPolicyState
	Watching              bool
	ConsoleCaptureEnabled bool
	// contains filtered or unexported fields
}

type TabExecutor = bridgetabs.TabExecutor

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

type TabHandoffState struct {
	Status        string    `json:"status"`
	Reason        string    `json:"reason,omitempty"`
	PausedAt      time.Time `json:"pausedAt"`
	LastUpdatedAt time.Time `json:"lastUpdatedAt"`
	ExpiresAt     time.Time `json:"expiresAt,omitempty"`
}

type TabLimitError struct {
	Current int
	Max     int
}

type TabLogs struct {
	Console []LogEntry
	Errors  []ErrorEntry
	// contains filtered or unexported fields
}

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

type TabPolicyState struct {
	CurrentURL string
	Threat     bool
	Blocked    bool
	Reason     string
	UpdatedAt  time.Time
}

type TabSetupFunc func(ctx context.Context, tabID string) error

type TabState struct {
	ID            string `json:"id"`
	URL           string `json:"url"`
	Title         string `json:"title"`
	Status        string `json:"status,omitempty"`
	HandoffReason string `json:"handoffReason,omitempty"`
}

type TabTarget struct {
	TargetID         string `json:"targetId"`
	URL              string `json:"url"`
	Title            string `json:"title"`
	Type             string `json:"type"`
	BrowserContextID string `json:"browserContextId,omitempty"`
}

type TextResult struct {
	Text        string
	URL         string
	Title       string
	Truncated   bool
	IDPIWarning string
	Route       *browserops.RouteMetadata
}

type URLReader func(ctx context.Context) (string, error)

type UserAgentOverrideParams struct {
	UserAgent      string
	Platform       string
	AcceptLanguage string
}

type ViewportInfo = bridgeobserve.ViewportInfo

type ViewportParams = runtimetypes.ViewportParams