proxy

type AttributeChange struct {
	Name     string `json:"name"`
	OldValue string `json:"old_value,omitempty"`
	NewValue string `json:"new_value,omitempty"`
}

type AuthBreakout struct {
	// Mode is "popup" or "top" (validated at config parse time).
	Mode string `json:"mode"`
	// Patterns are case-insensitive wildcard fragments matched against the
	// full navigation URL: `*` matches any run of characters, plain text
	// matches as a substring.
	Patterns []string `json:"patterns"`
	// contains filtered or unexported fields
}

type ChaosConfig struct {
	Enabled     bool         `json:"enabled"`
	Rules       []*ChaosRule `json:"rules"`
	GlobalOdds  float64      `json:"global_odds,omitempty"` // 0.0-1.0, applies to all
	Seed        int64        `json:"seed,omitempty"`        // For reproducible chaos
	LoggingMode LoggingMode  `json:"logging_mode,omitempty"`
}

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

type ChaosRule struct {
	ID      string    `json:"id"`
	Name    string    `json:"name"`
	Type    ChaosType `json:"type"`
	Enabled bool      `json:"enabled"`

	// Matching criteria
	URLPattern  string   `json:"url_pattern,omitempty"` // Regex pattern for URL
	Methods     []string `json:"methods,omitempty"`     // HTTP methods (empty = all)
	Probability float64  `json:"probability,omitempty"` // 0.0-1.0, default 1.0

	// Latency config
	MinLatencyMs int `json:"min_latency_ms,omitempty"`
	MaxLatencyMs int `json:"max_latency_ms,omitempty"`
	JitterMs     int `json:"jitter_ms,omitempty"`

	// Slow-drip config
	BytesPerMs int `json:"bytes_per_ms,omitempty"` // Bytes to write per millisecond
	ChunkSize  int `json:"chunk_size,omitempty"`   // Size of each write chunk

	// Connection drop config
	DropAfterPercent float64 `json:"drop_after_percent,omitempty"` // Drop after % of body
	DropAfterBytes   int64   `json:"drop_after_bytes,omitempty"`   // Drop after N bytes

	// Error injection config
	ErrorCodes   []int  `json:"error_codes,omitempty"` // HTTP status codes
	ErrorMessage string `json:"error_message,omitempty"`

	// Truncation config
	TruncatePercent float64 `json:"truncate_percent,omitempty"` // Keep this % of response

	// Out-of-order config
	ReorderMinRequests int `json:"reorder_min_requests,omitempty"` // Min concurrent to reorder
	ReorderMaxWaitMs   int `json:"reorder_max_wait_ms,omitempty"`  // Max wait for batch

	// Stale config
	StaleDelayMs int64 `json:"stale_delay_ms,omitempty"` // Delay in milliseconds
	// contains filtered or unexported fields
}

type ChaosRuleSnapshot struct {
	*ChaosRule
	Enabled bool  `json:"enabled"`
	Applied int64 `json:"applied"`
}

type ChaosSnapshot struct {
	Enabled    bool                 `json:"enabled"`
	GlobalOdds float64              `json:"global_odds,omitempty"`
	Seed       int64                `json:"seed,omitempty"`
	Rules      []*ChaosRuleSnapshot `json:"rules"`
	Stats      ChaosStats           `json:"stats"`
	// SwallowDetect mirrors the runtime swallowed-error toggle so the panel
	// renders the switch in the right position.
	SwallowDetect bool `json:"swallow_detect"`
}

type ChaosStats struct {
	TotalRequests   int64            `json:"total_requests"`
	AffectedCount   int64            `json:"affected_count"`
	LatencyInjected int64            `json:"latency_injected_ms"`
	ErrorsInjected  int64            `json:"errors_injected"`
	DropsInjected   int64            `json:"drops_injected"`
	TruncatedCount  int64            `json:"truncated_count"`
	ReorderedCount  int64            `json:"reordered_count"`
	RuleStats       map[string]int64 `json:"rule_stats"` // Rule ID -> times applied
}

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

type ChaosType string

type ConnAttempt struct {
	Timestamp time.Time
	Event     string // "connection_refused", "timeout", "reset", etc.
	Message   string
}

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

type CustomLog struct {
	ID        string                 `json:"id"`
	Timestamp time.Time              `json:"timestamp"`
	Level     string                 `json:"level"` // debug, info, warn, error
	Message   string                 `json:"message"`
	Data      map[string]interface{} `json:"data,omitempty"`
	URL       string                 `json:"url"`
}

type DeepgramConfig struct {
	Model          string
	Language       string
	Punctuate      bool
	SmartFormat    bool
	InterimResults bool
	Encoding       string
	SampleRate     int
	Channels       int
}

type DeepgramMessage struct {
	Type    string `json:"type"`
	Channel struct {
		Alternatives []struct {
			Transcript string  `json:"transcript"`
			Confidence float64 `json:"confidence"`
			Words      []struct {
				Word       string  `json:"word"`
				Start      float64 `json:"start"`
				End        float64 `json:"end"`
				Confidence float64 `json:"confidence"`
			} `json:"words"`
		} `json:"alternatives"`
	} `json:"channel"`
	IsFinal     bool    `json:"is_final"`
	SpeechFinal bool    `json:"speech_final"`
	Start       float64 `json:"start"`
	Duration    float64 `json:"duration"`
}

type DesignChat struct {
	ID             string                `json:"id"`
	Timestamp      time.Time             `json:"timestamp"`
	Message        string                `json:"message"` // User's chat message
	Selector       string                `json:"selector"`
	XPath          string                `json:"xpath"`
	CurrentHTML    string                `json:"current_html"`
	OriginalHTML   string                `json:"original_html"`
	ContextHTML    string                `json:"context_html"`
	Metadata       DesignElementMetadata `json:"metadata"`
	ChatHistory    []DesignChatMessage   `json:"chat_history,omitempty"`
	URL            string                `json:"url"`
	ScreenshotPath string                `json:"screenshot_path,omitempty"` // saved PNG of the live segment
}

type DesignChatMessage struct {
	Timestamp int64  `json:"timestamp"`
	Message   string `json:"message"`
	Role      string `json:"role"` // user or assistant
}

type DesignEdit struct {
	ID             string                `json:"id"`
	Timestamp      time.Time             `json:"timestamp"`
	Selector       string                `json:"selector"`
	XPath          string                `json:"xpath"`
	OID            string                `json:"oid"`             // data-devtool-oid value
	Deltas         map[string]string     `json:"deltas"`          // property → final value
	ComputedBefore map[string]string     `json:"computed_before"` // measured before the drag
	ComputedAfter  map[string]string     `json:"computed_after"`  // measured after the drag
	Metadata       DesignElementMetadata `json:"metadata"`
	URL            string                `json:"url"`
}

type DesignElementMetadata struct {
	Tag        string            `json:"tag"`
	ID         string            `json:"id,omitempty"`
	Classes    []string          `json:"classes,omitempty"`
	Attributes map[string]string `json:"attributes,omitempty"`
	Text       string            `json:"text,omitempty"` // Truncated text content
	Rect       struct {
		Width  int `json:"width"`
		Height int `json:"height"`
	} `json:"rect,omitempty"`
}

type DesignRequest struct {
	ID                string                `json:"id"`
	Timestamp         time.Time             `json:"timestamp"`
	Selector          string                `json:"selector"`
	XPath             string                `json:"xpath"`
	CurrentHTML       string                `json:"current_html"`  // Current HTML being displayed
	OriginalHTML      string                `json:"original_html"` // Original HTML before any changes
	ContextHTML       string                `json:"context_html"`  // Parent context
	Metadata          DesignElementMetadata `json:"metadata"`
	AlternativesCount int                   `json:"alternatives_count"` // How many alternatives already exist
	ChatHistory       []DesignChatMessage   `json:"chat_history,omitempty"`
	Scheme            *DesignScheme         `json:"scheme,omitempty"` // live-extracted design tokens of the proxied app
	URL               string                `json:"url"`
	ScreenshotPath    string                `json:"screenshot_path,omitempty"` // saved PNG of the live segment (dataURL stripped after save)
}

type DesignScheme struct {
	Palette      []string          `json:"palette,omitempty"`       // frequency-ranked colors (hex/rgb)
	FontFamilies []string          `json:"font_families,omitempty"` // distinct font-family stacks
	FontSizes    []string          `json:"font_sizes,omitempty"`    // observed font-size ladder
	FontWeights  []string          `json:"font_weights,omitempty"`  // observed font weights
	Spacing      []string          `json:"spacing,omitempty"`       // observed margin/padding/gap steps
	Radius       []string          `json:"radius,omitempty"`        // observed border-radius values
	Shadows      []string          `json:"shadows,omitempty"`       // observed box-shadow samples
	CSSVars      map[string]string `json:"css_vars,omitempty"`      // declared --* custom properties
}

type DesignState struct {
	ID           string                `json:"id"`
	Timestamp    time.Time             `json:"timestamp"`
	Selector     string                `json:"selector"` // CSS selector
	XPath        string                `json:"xpath"`    // XPath for robustness
	OriginalHTML string                `json:"original_html"`
	ContextHTML  string                `json:"context_html"` // Parent element with siblings for context
	Metadata     DesignElementMetadata `json:"metadata"`
	Scheme       *DesignScheme         `json:"scheme,omitempty"` // live-extracted design tokens of the proxied app
	URL          string                `json:"url"`
}

type ElementCapture struct {
	ID        string    `json:"id"` // Reference ID for use in messages
	Timestamp time.Time `json:"timestamp"`
	URL       string    `json:"url"`
	Summary   string    `json:"summary"`  // Human-readable summary
	Selector  string    `json:"selector"` // CSS selector
	Tag       string    `json:"tag"`
	ElementID string    `json:"element_id,omitempty"` // DOM element id attribute
	Classes   []string  `json:"classes,omitempty"`
	Text      string    `json:"text,omitempty"` // Truncated text content
	Rect      struct {
		X      float64 `json:"x"`
		Y      float64 `json:"y"`
		Width  float64 `json:"width"`
		Height float64 `json:"height"`
	} `json:"rect,omitempty"`
}

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

type ExecutionResponse struct {
	ID        string        `json:"id"`
	Timestamp time.Time     `json:"timestamp"`
	ExecID    string        `json:"exec_id"` // Original execution ID
	Success   bool          `json:"success"`
	Result    string        `json:"result,omitempty"`
	Error     string        `json:"error,omitempty"`
	Duration  time.Duration `json:"duration"`
}

type ExecutionResult struct {
	ID        string                 `json:"id"`
	Timestamp time.Time              `json:"timestamp"`
	Code      string                 `json:"code"`   // The code that was executed
	Result    string                 `json:"result"` // String representation of result
	Error     string                 `json:"error,omitempty"`
	Duration  time.Duration          `json:"duration"`
	URL       string                 `json:"url"`
	Data      map[string]interface{} `json:"data,omitempty"`
	FilePath  string                 `json:"file_path,omitempty"` // Path to file if result was too large
}

type FrontendError struct {
	ID        string    `json:"id"`
	Timestamp time.Time `json:"timestamp"`
	Message   string    `json:"message"`
	Source    string    `json:"source,omitempty"`
	LineNo    int       `json:"lineno,omitempty"`
	ColNo     int       `json:"colno,omitempty"`
	Error     string    `json:"error,omitempty"`
	Stack     string    `json:"stack,omitempty"`
	URL       string    `json:"url"` // Page URL where error occurred
}

type HTTPLogEntry struct {
	ID              string            `json:"id"`
	Timestamp       time.Time         `json:"timestamp"`
	Method          string            `json:"method"`
	URL             string            `json:"url"`
	RequestHeaders  map[string]string `json:"request_headers"`
	RequestBody     string            `json:"request_body,omitempty"`
	StatusCode      int               `json:"status_code"`
	ResponseHeaders map[string]string `json:"response_headers"`
	ResponseBody    string            `json:"response_body,omitempty"`
	Duration        time.Duration     `json:"duration"`
	Error           string            `json:"error,omitempty"`
	// Chaos marks a response the chaos engine synthesised (injected error
	// status / corruption) rather than one the backend actually produced.
	// Synthetic faults stay in the traffic log (proxylog query still surfaces
	// them) but are suppressed from the agent incident inbox so an injected
	// 500 is not mistaken for a real backend error. The swallow detector also
	// keys off this flag.
	Chaos bool `json:"chaos,omitempty"`
	// ChaosSwallowWatch is set when this injected fault should be watched by
	// the swallowed-error heuristic — i.e. chaos injected it AND the proxy's
	// runtime swallow-detect toggle (browser panel) was on. The daemon records
	// it as a pending fault; if no app-side error follows in the window it is
	// raised as a swallowed-error incident.
	ChaosSwallowWatch bool `json:"chaos_swallow_watch,omitempty"`
}

type HookLogEntry struct {
	Event       string          `json:"event"`
	Payload     json.RawMessage `json:"payload,omitempty"`
	SessionID   string          `json:"session_id,omitempty"`
	ProjectPath string          `json:"project_path,omitempty"`
	Agent       string          `json:"agent,omitempty"`
	ReceivedAt  time.Time       `json:"received_at"`
}

type InteractionEvent struct {
	ID        string                 `json:"id"`
	Timestamp time.Time              `json:"timestamp"`
	EventType string                 `json:"event_type"` // click, dblclick, keydown, input, scroll, focus, blur, submit, contextmenu, mousemove
	Target    InteractionTarget      `json:"target"`
	Position  *InteractionPosition   `json:"position,omitempty"` // For mouse events
	Key       *KeyboardInfo          `json:"key,omitempty"`      // For keyboard events
	Value     string                 `json:"value,omitempty"`    // For input events (sanitized, no passwords)
	URL       string                 `json:"url"`
	Data      map[string]interface{} `json:"data,omitempty"` // Extra data (scroll_position, etc.)
}

type InteractionPosition struct {
	ClientX int `json:"client_x"`
	ClientY int `json:"client_y"`
	PageX   int `json:"page_x"`
	PageY   int `json:"page_y"`
}

type InteractionTarget struct {
	Selector   string            `json:"selector"`
	Tag        string            `json:"tag"`
	ID         string            `json:"id,omitempty"`
	Classes    []string          `json:"classes,omitempty"`
	Text       string            `json:"text,omitempty"`       // Truncated innerText
	Attributes map[string]string `json:"attributes,omitempty"` // Relevant attrs only (href, src, type, etc.)
}

type KeyboardInfo struct {
	Key   string `json:"key"`
	Code  string `json:"code"`
	Ctrl  bool   `json:"ctrl,omitempty"`
	Alt   bool   `json:"alt,omitempty"`
	Shift bool   `json:"shift,omitempty"`
	Meta  bool   `json:"meta,omitempty"`
}

type LogEntry struct {
	Type LogEntryType `json:"type"`
	// FrameID attributes a browser-sourced entry to the content frame that
	// emitted it (the always-wrap model — docs/responsive-canonical-target.md
	// §5.2). Empty for server-sourced entries (HTTP) and for unframed/legacy
	// pages. Carried once on the envelope rather than on each typed payload.
	FrameID           string              `json:"frame_id,omitempty"`
	HTTP              *HTTPLogEntry       `json:"http,omitempty"`
	Error             *FrontendError      `json:"error,omitempty"`
	Performance       *PerformanceMetric  `json:"performance,omitempty"`
	Custom            *CustomLog          `json:"custom,omitempty"`
	Screenshot        *Screenshot         `json:"screenshot,omitempty"`
	Execution         *ExecutionResult    `json:"execution,omitempty"`
	Response          *ExecutionResponse  `json:"response,omitempty"`
	Interaction       *InteractionEvent   `json:"interaction,omitempty"`
	Mutation          *MutationEvent      `json:"mutation,omitempty"`
	PanelMessage      *PanelMessage       `json:"panel_message,omitempty"`
	Sketch            *SketchEntry        `json:"sketch,omitempty"`
	ScreenshotCapture *ScreenshotCapture  `json:"screenshot_capture,omitempty"`
	ElementCapture    *ElementCapture     `json:"element_capture,omitempty"`
	SketchCapture     *SketchCapture      `json:"sketch_capture,omitempty"`
	DesignState       *DesignState        `json:"design_state,omitempty"`
	DesignRequest     *DesignRequest      `json:"design_request,omitempty"`
	DesignChat        *DesignChat         `json:"design_chat,omitempty"`
	DesignEdit        *DesignEdit         `json:"design_edit,omitempty"`
	Walkthrough       *WalkthroughEntry   `json:"walkthrough,omitempty"`
	ResponsiveRequest *ResponsiveRequest  `json:"responsive_request,omitempty"`
	ResponsiveState   *ResponsiveState    `json:"responsive_state,omitempty"`
	Diagnostic        *ProxyDiagnostic    `json:"diagnostic,omitempty"`
	ProcessOutput     *ProcessOutputEvent `json:"process,omitempty"`
	Hook              *HookLogEntry       `json:"hook,omitempty"`
}

type LogEntryType string

type LogFilter struct {
	Types            []LogEntryType `json:"types,omitempty"`       // Filter by entry type
	Methods          []string       `json:"methods,omitempty"`     // HTTP methods
	URLPattern       string         `json:"url_pattern,omitempty"` // URL substring match
	StatusCodes      []int          `json:"status_codes,omitempty"`
	Since            *time.Time     `json:"since,omitempty"`
	Until            *time.Time     `json:"until,omitempty"`
	Limit            int            `json:"limit,omitempty"`             // Max results (0 = all)
	InteractionTypes []string       `json:"interaction_types,omitempty"` // click, keydown, scroll, etc.
	MutationTypes    []string       `json:"mutation_types,omitempty"`    // added, removed, attributes
	DiagnosticLevels []string       `json:"diagnostic_levels,omitempty"` // info, warning, error
	ErrorsOnly       bool           `json:"errors_only,omitempty"`       // Filter to errors from all sources
	Frames           []string       `json:"frames,omitempty"`            // Filter to entries from these content frame ids
}

type LoggerStats struct {
	TotalEntries     int64 `json:"total_entries"`
	AvailableEntries int64 `json:"available_entries"`
	MaxSize          int64 `json:"max_size"`
	Dropped          int64 `json:"dropped"`
}

type LoggingMode int32

type MutationEvent struct {
	ID           string           `json:"id"`
	Timestamp    time.Time        `json:"timestamp"`
	MutationType string           `json:"mutation_type"` // added, removed, attributes, characterData
	Target       MutationTarget   `json:"target"`
	Added        []MutationNode   `json:"added,omitempty"`
	Removed      []MutationNode   `json:"removed,omitempty"`
	Attribute    *AttributeChange `json:"attribute,omitempty"`
	URL          string           `json:"url"`
	// TriggeredBy correlates this mutation to the user interaction that likely
	// caused it (the browser walks recent interaction history within a 500ms
	// window). Nil when no interaction preceded the mutation.
	TriggeredBy *MutationTrigger `json:"triggered_by,omitempty"`
}

type MutationNode struct {
	Selector string `json:"selector,omitempty"`
	Tag      string `json:"tag"`
	ID       string `json:"id,omitempty"`
	HTML     string `json:"html,omitempty"` // Truncated outerHTML
}

type MutationTarget struct {
	Selector string `json:"selector"`
	Tag      string `json:"tag"`
	ID       string `json:"id,omitempty"`
}

type MutationTrigger struct {
	Type      string `json:"type,omitempty"`      // interaction event type (click, keydown, ...)
	Timestamp int64  `json:"timestamp,omitempty"` // interaction time (ms epoch, browser clock)
	Latency   int64  `json:"latency,omitempty"`   // ms between interaction and mutation
	Target    string `json:"target,omitempty"`    // selector of the interaction target
}

type OverlayEvent struct {
	Type      string      `json:"type"`
	ProxyID   string      `json:"proxy_id"`
	Timestamp time.Time   `json:"timestamp"`
	Data      interface{} `json:"data"`
}

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

type PageSession struct {
	ID             string    `json:"id"`
	URL            string    `json:"url"`                       // Current/most recent URL
	BrowserSession string    `json:"browser_session,omitempty"` // Browser tab session ID (from cookie)
	PageTitle      string    `json:"page_title,omitempty"`
	StartTime      time.Time `json:"start_time"`
	LastActivity   time.Time `json:"last_activity"`
	Active         bool      `json:"active"`

	// Navigation history - all document requests in this tab session
	Navigations     []HTTPLogEntry     `json:"navigations,omitempty"`
	DocumentRequest *HTTPLogEntry      `json:"document_request,omitempty"` // Most recent document request (for backwards compat)
	Resources       []HTTPLogEntry     `json:"resources"`
	Errors          []FrontendError    `json:"errors,omitempty"`
	Performance     *PerformanceMetric `json:"performance,omitempty"`

	// User interaction tracking
	Interactions     []InteractionEvent `json:"interactions,omitempty"`
	InteractionCount int                `json:"interaction_count"` // Total count (may exceed slice length)

	// DOM mutation tracking
	Mutations     []MutationEvent `json:"mutations,omitempty"`
	MutationCount int             `json:"mutation_count"` // Total count (may exceed slice length)
}

type PageSessionSummary struct {
	ID             string    `json:"id"`
	URL            string    `json:"url"`
	PageTitle      string    `json:"page_title,omitempty"`
	StartTime      time.Time `json:"start_time"`
	LastActivity   time.Time `json:"last_activity"`
	Active         bool      `json:"active"`
	ResourceCount  int       `json:"resource_count"`
	ErrorCount     int       `json:"error_count"`
	HasPerformance bool      `json:"has_performance"`
	LoadTimeMs     int64     `json:"load_time_ms,omitempty"`
	// Counts only, no detailed arrays
	InteractionCount int `json:"interaction_count"`
	MutationCount    int `json:"mutation_count"`
}

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

type PanelAttachment struct {
	Type     string                 `json:"type"` // element, screenshot_area
	Selector string                 `json:"selector,omitempty"`
	Tag      string                 `json:"tag,omitempty"`
	ID       string                 `json:"id,omitempty"`
	Classes  []string               `json:"classes,omitempty"`
	Text     string                 `json:"text,omitempty"`
	Summary  string                 `json:"summary,omitempty"`
	FilePath string                 `json:"filePath,omitempty"` // Browser-side file path from capture_ack
	Area     *ScreenshotArea        `json:"area,omitempty"`
	Data     map[string]interface{} `json:"data,omitempty"`
}

type PanelMessage struct {
	ID                  string            `json:"id"`
	Timestamp           time.Time         `json:"timestamp"`
	Message             string            `json:"message"`
	Attachments         []PanelAttachment `json:"attachments,omitempty"`
	URL                 string            `json:"url"`
	RequestNotification bool              `json:"request_notification,omitempty"`
}

type PerformanceMetric struct {
	ID                   string                 `json:"id"`
	Timestamp            time.Time              `json:"timestamp"`
	URL                  string                 `json:"url"` // Page URL
	NavigationStart      int64                  `json:"navigation_start,omitempty"`
	LoadEventEnd         int64                  `json:"load_event_end,omitempty"`
	DOMContentLoaded     int64                  `json:"dom_content_loaded,omitempty"`
	FirstPaint           int64                  `json:"first_paint,omitempty"`
	FirstContentfulPaint int64                  `json:"first_contentful_paint,omitempty"`
	Resources            []ResourceTiming       `json:"resources,omitempty"`
	Custom               map[string]interface{} `json:"custom,omitempty"`

	// Page context captured alongside the performance sample. PageTitle is the
	// document title (also copied onto the owning PageSession); the dimensions
	// are surfaced by the currentpage summary.
	PageTitle      string `json:"page_title,omitempty"`
	PageWidth      int    `json:"page_width,omitempty"`
	PageHeight     int    `json:"page_height,omitempty"`
	ViewportWidth  int    `json:"viewport_width,omitempty"`
	ViewportHeight int    `json:"viewport_height,omitempty"`
}

type ProcessOutputEvent struct {
	ProcessID string    `json:"process_id"`
	Stream    string    `json:"stream"`    // "stdout" or "stderr"
	Line      string    `json:"line"`      // Output line content (without trailing newline)
	Timestamp time.Time `json:"timestamp"` // When the line was received
}

type ProxyConfig struct {
	ID            string
	TargetURL     string
	ListenPort    int
	MaxLogSize    int
	AutoRestart   bool   // Enable automatic restart on crash (default: true)
	Path          string // Working directory where proxy was created
	BindAddress   string // Bind address: "127.0.0.1" (default, localhost only) or "0.0.0.0" (all interfaces)
	PublicURL     string // Optional public URL for tunnel services (e.g., "https://abc123.trycloudflare.com")
	AllowExternal bool   // Allow binding to non-localhost addresses (0.0.0.0, ::). Requires explicit opt-in for security.
	SkipTLSVerify bool   // Skip TLS certificate verification (default: false, verifies certs). Set true for self-signed/expired certs in dev.
	// StrictListenPort disables the silent :0 auto-assign fallback when
	// ListenPort is already in use. When true, a bind conflict surfaces
	// as a hard error from Start(). Used by autostart when a user
	// explicitly declares `listen-port` in .agnt.kdl — an explicit port
	// means "this port or nothing", not "this port or a random one".
	StrictListenPort bool
	Tunnel           *protocol.TunnelConfig

	// HealthCheckInterval controls how often the backend is probed.
	// Zero disables health checks. Default: 30s.
	HealthCheckInterval time.Duration
	// HealthFailThreshold is the number of consecutive failures before
	// marking the backend unhealthy and emitting a diagnostic event.
	// Default: 3.
	HealthFailThreshold int

	// AuthBreakout enables OAuth-flow breakout from the content iframe
	// (nil = off). Populated from the project's .agnt.kdl auth-breakout
	// block; may also be set post-create via SetAuthBreakout.
	AuthBreakout *AuthBreakout
}

type ProxyDiagnostic struct {
	Timestamp time.Time            `json:"timestamp"`
	Level     ProxyDiagnosticLevel `json:"level"`
	Category  string               `json:"category"` // "proxy", "connection", "request"
	Event     string               `json:"event"`    // "error", "timeout", "refused", etc.
	Message   string               `json:"message"`
	RequestID string               `json:"request_id,omitempty"`
	Method    string               `json:"method,omitempty"`
	URL       string               `json:"url,omitempty"`
	Target    string               `json:"target,omitempty"`
	Data      map[string]any       `json:"data,omitempty"`
}

type ProxyDiagnosticLevel string

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

type ProxyServer struct {
	ID            string
	TargetURL     *url.URL
	ListenAddr    string
	Path          string
	BindAddress   string // Bind address used (127.0.0.1 or 0.0.0.0)
	AllowExternal bool   // Whether external binding was explicitly allowed
	// StrictListenPort, when true, disables the silent :0 auto-assign
	// fallback in Start(). A bind failure on the requested listen port
	// becomes a hard error instead of being papered over with a random
	// port. Set by callers that hand us an explicit listen port (e.g.
	// autostart with .agnt.kdl `listen-port`).
	StrictListenPort bool
	PublicURL        string // Optional public URL for tunnel services
	// contains filtered or unexported fields
}

type ProxyStats struct {
	ID            string        `json:"id"`
	TargetURL     string        `json:"target_url"`
	ListenAddr    string        `json:"listen_addr"`
	Path          string        `json:"path,omitempty"`         // Working directory where proxy was created
	BindAddress   string        `json:"bind_address,omitempty"` // Bind address (127.0.0.1 or 0.0.0.0)
	PublicURL     string        `json:"public_url,omitempty"`   // Public URL for tunnels
	Running       bool          `json:"running"`
	Uptime        time.Duration `json:"uptime"`
	TotalRequests int64         `json:"total_requests"`
	LoggerStats   LoggerStats   `json:"logger_stats"`
	LastError     string        `json:"last_error,omitempty"` // Set if server crashed
	RestartCount  int           `json:"restart_count"`        // Number of restarts in current window
	AutoRestart   bool          `json:"auto_restart"`         // Whether auto-restart is enabled

	// Backend health probe state
	BackendHealthy      bool      `json:"backend_healthy"`                // false after consecutive probe failures
	LastHealthCheck     time.Time `json:"last_health_check,omitempty"`    // time of last probe
	ConsecutiveFailures int32     `json:"consecutive_failures,omitempty"` // current consecutive failure count

	// Restart backoff
	BackoffDelay time.Duration `json:"backoff_delay,omitempty"` // current backoff base duration (0 = no backoff active)

	// Readiness gate (wait-for dependencies). ReadyForForwarding is
	// false while the proxy is gating on declared script dependencies;
	// WaitingFor holds the sorted list of pending dep names. An empty
	// WaitingFor with ReadyForForwarding=true is the normal running case.
	ReadyForForwarding bool     `json:"ready_for_forwarding"`
	WaitingFor         []string `json:"waiting_for,omitempty"`
}

type ReadinessBody struct {
	Error        string   `json:"error"`
	Message      string   `json:"message"`
	Pending      []string `json:"pending"`
	RetryAfterMs int      `json:"retry_after_ms"`
}

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

type ResourceTiming struct {
	Name     string `json:"name"`
	Duration int64  `json:"duration"`
	Size     int64  `json:"size,omitempty"`
}

type ResponsiveRequest struct {
	ID        string                   `json:"id"`
	Timestamp time.Time                `json:"timestamp"`
	URL       string                   `json:"url"`
	Width     int                      `json:"width"`
	Shifts    []map[string]interface{} `json:"shifts,omitempty"`    // layout-shift findings (id/type/severity/selector/message/width/isNew)
	Selectors []map[string]interface{} `json:"selectors,omitempty"` // flat {id, selector} list for quick targeting
}

type ResponsiveState struct {
	ID         string    `json:"id"`
	Timestamp  time.Time `json:"timestamp"`
	URL        string    `json:"url"`
	Width      int       `json:"width"`
	ShiftCount int       `json:"shift_count"`
}

type Screenshot struct {
	ID        string    `json:"id"`
	Timestamp time.Time `json:"timestamp"`
	Name      string    `json:"name"`
	FilePath  string    `json:"file_path"` // Path to saved screenshot file
	URL       string    `json:"url"`       // Page URL where screenshot was taken
	Width     int       `json:"width"`
	Height    int       `json:"height"`
	Format    string    `json:"format"`   // png, jpeg
	Selector  string    `json:"selector"` // CSS selector for element (or "body" for full page)
	Error     string    `json:"error,omitempty"`
}

type ScreenshotArea struct {
	X      int    `json:"x"`
	Y      int    `json:"y"`
	Width  int    `json:"width"`
	Height int    `json:"height"`
	Data   string `json:"data,omitempty"` // Base64 image data
}

type ScreenshotCapture struct {
	ID        string    `json:"id"` // Reference ID for use in messages
	Timestamp time.Time `json:"timestamp"`
	URL       string    `json:"url"`
	Summary   string    `json:"summary"`    // Human-readable summary
	ImageData string    `json:"image_data"` // Base64 PNG data (cleared after save)
	FilePath  string    `json:"file_path"`  // Path to saved image file
	Area      struct {
		X      int `json:"x"`
		Y      int `json:"y"`
		Width  int `json:"width"`
		Height int `json:"height"`
	} `json:"area"`
}

type SessionClient interface {
	SessionList(dirFilter protocol.DirectoryFilter) (map[string]interface{}, error)
	SessionGet(code string) (map[string]interface{}, error)
	SessionSend(code string, message string) (map[string]interface{}, error)
	SessionSchedule(code string, duration string, message string) (map[string]interface{}, error)
	SessionTasks(dirFilter protocol.DirectoryFilter) (map[string]interface{}, error)
	SessionCancel(taskID string) error
	StoreGet(req protocol.StoreGetRequest) (map[string]interface{}, error)
	StoreSet(req protocol.StoreSetRequest) error
	StoreDelete(req protocol.StoreDeleteRequest) error
	StoreList(req protocol.StoreListRequest) (map[string]interface{}, error)
	StoreClear(req protocol.StoreClearRequest) error
	StoreGetAll(req protocol.StoreGetAllRequest) (map[string]interface{}, error)
	Close() error
}

type SessionClientFactory func() (SessionClient, error)

type SketchCapture struct {
	ID           string                 `json:"id"` // Reference ID for use in messages
	Timestamp    time.Time              `json:"timestamp"`
	URL          string                 `json:"url"`
	Summary      string                 `json:"summary"` // Human-readable summary
	ElementCount int                    `json:"element_count"`
	Sketch       map[string]interface{} `json:"sketch,omitempty"` // Sketch data
	ImageData    string                 `json:"image_data,omitempty"`
	FilePath     string                 `json:"file_path,omitempty"`
}

type SketchEntry struct {
	ID           string                 `json:"id"`
	Timestamp    time.Time              `json:"timestamp"`
	URL          string                 `json:"url"`
	Description  string                 `json:"description"`   // User description of the wireframe
	Sketch       map[string]interface{} `json:"sketch"`        // JSON-serialized sketch data
	ImageData    string                 `json:"image_data"`    // Base64 PNG of the sketch
	FilePath     string                 `json:"file_path"`     // Path to saved image file
	ElementCount int                    `json:"element_count"` // Number of elements in sketch
}

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

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

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

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

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

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

type VoiceTranscript struct {
	Type       string  `json:"type"`
	Transcript string  `json:"transcript"`
	IsFinal    bool    `json:"is_final"`
	Confidence float64 `json:"confidence"`
	Start      float64 `json:"start"`
	Duration   float64 `json:"duration"`
}

type WalkthroughEntry struct {
	ID        string    `json:"id"`
	Timestamp time.Time `json:"timestamp"`
	URL       string    `json:"url"`
	Event     string    `json:"event"`
	ScriptID  string    `json:"script_id,omitempty"`
	Title     string    `json:"title,omitempty"`
	StepIndex int       `json:"step_index"`
	Total     int       `json:"total,omitempty"`
	StepTitle string    `json:"step_title,omitempty"`
	Advance   string    `json:"advance,omitempty"` // auto | click-target | wait
	How       string    `json:"how,omitempty"`     // timer | click | wait | manual | start | goto
	Mode      string    `json:"mode,omitempty"`    // auto | manual
	Message   string    `json:"message,omitempty"`
}