protocol

type AlertQueryFilter struct {
	Since     string `json:"since,omitempty"`      // RFC3339 or duration like "5m"
	ProcessID string `json:"process_id,omitempty"` // Filter to specific process
	Severity  string `json:"severity,omitempty"`   // Filter by severity
	Limit     int    `json:"limit,omitempty"`      // Max results (0 = all)

	Global      bool   `json:"global,omitempty"`       // Bypass session scope (cross-project)
	SessionCode string `json:"session_code,omitempty"` // Explicit session to scope to
	Directory   string `json:"directory,omitempty"`    // Explicit project directory to scope to
}

type AlertReportPayload struct {
	PatternID   string `json:"pattern_id"`
	Severity    string `json:"severity"`    // "error", "warning", "info"
	Category    string `json:"category"`    // "go", "dotnet", "webpack", "generic", "custom"
	Description string `json:"description"` // Pattern description
	Line        string `json:"line"`        // Matched output line
	ScriptID    string `json:"script_id"`   // Process that produced the line
	ProjectPath string `json:"project_path,omitempty"`
	Timestamp   string `json:"timestamp"` // RFC3339
}

type AutomateBatchRequest struct {
	Tasks []AutomateProcessRequest `json:"tasks"`
}

type AutomateOptions struct {
	Model       string  `json:"model,omitempty"`       // Model to use (haiku, sonnet)
	MaxTokens   int     `json:"max_tokens,omitempty"`  // Max response tokens
	Temperature float64 `json:"temperature,omitempty"` // 0.0-1.0
}

type AutomateProcessRequest struct {
	Type    string                 `json:"type"`    // Task type (audit_process, summarize, etc.)
	Data    map[string]interface{} `json:"data"`    // Task-specific input data
	Context map[string]interface{} `json:"context"` // Additional context
	Options AutomateOptions        `json:"options,omitempty"`
}

type AutomateProcessResponse struct {
	Success  bool        `json:"success"`
	Result   interface{} `json:"result,omitempty"`
	Error    string      `json:"error,omitempty"`
	Tokens   int         `json:"tokens_used"`
	CostUSD  float64     `json:"cost_usd"`
	Duration string      `json:"duration"`
}

type AutomationEvaluateConfig struct {
	SessionID string `json:"session_id"` // Session ID (required)
	Script    string `json:"script"`     // JavaScript to evaluate (required)
}

type AutomationNavigateConfig struct {
	SessionID string `json:"session_id"` // Session ID (required)
	URL       string `json:"url"`        // URL to navigate to (required)
}

type AutomationScreenshotConfig struct {
	SessionID string  `json:"session_id"`         // Session ID (required)
	Type      string  `json:"type,omitempty"`     // viewport, fullpage, element, clip
	Label     string  `json:"label,omitempty"`    // Optional label for filename
	Selector  string  `json:"selector,omitempty"` // CSS selector for element type
	Viewport  string  `json:"viewport,omitempty"` // Viewport preset name
	X         float64 `json:"x,omitempty"`        // Clip X
	Y         float64 `json:"y,omitempty"`        // Clip Y
	Width     float64 `json:"width,omitempty"`    // Clip width
	Height    float64 `json:"height,omitempty"`   // Clip height
}

type AutomationStartConfig struct {
	ID       string `json:"id,omitempty"`       // Session ID (auto-generated if empty)
	URL      string `json:"url,omitempty"`      // URL to open
	ProxyID  string `json:"proxy_id,omitempty"` // Proxy to use
	Headless *bool  `json:"headless,omitempty"` // Default: true
}

type AutostartRunConfig struct {
	ProjectPath    string `json:"project_path"`
	NonInteractive bool   `json:"non_interactive"`
}

type BrowserStartConfig struct {
	ID         string `json:"id,omitempty"`          // Browser ID (auto-generated if empty)
	URL        string `json:"url,omitempty"`         // URL to open
	ProxyID    string `json:"proxy_id,omitempty"`    // Proxy to use (auto-starts if needed)
	Headless   *bool  `json:"headless,omitempty"`    // Default: true
	BinaryPath string `json:"binary_path,omitempty"` // Optional Chrome path
}

type ChaosConfigPayload struct {
	Enabled     bool               `json:"enabled"`
	Rules       []*ChaosRuleConfig `json:"rules,omitempty"`
	GlobalOdds  float64            `json:"global_odds,omitempty"`  // 0.0-1.0
	Seed        int64              `json:"seed,omitempty"`         // For reproducible chaos
	LoggingMode int                `json:"logging_mode,omitempty"` // 0=silent, 1=testing, 2=coordinated
}

type ChaosRuleConfig struct {
	ID          string   `json:"id"`
	Name        string   `json:"name,omitempty"`
	Type        string   `json:"type"` // latency, out_of_order, slow_drip, disconnect, http_error, truncate, etc.
	Enabled     bool     `json:"enabled"`
	URLPattern  string   `json:"url_pattern,omitempty"`
	Methods     []string `json:"methods,omitempty"`
	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"`
	ChunkSize  int `json:"chunk_size,omitempty"`

	// Connection drop config
	DropAfterPercent float64 `json:"drop_after_percent,omitempty"`
	DropAfterBytes   int64   `json:"drop_after_bytes,omitempty"`

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

	// Truncation config
	TruncatePercent float64 `json:"truncate_percent,omitempty"`

	// Out-of-order config
	ReorderMinRequests int `json:"reorder_min_requests,omitempty"`
	ReorderMaxWaitMs   int `json:"reorder_max_wait_ms,omitempty"`

	// Stale config
	StaleDelayMs int64 `json:"stale_delay_ms,omitempty"`
}

type Command = hubprotocol.Command

type DirectoryFilter = hubprotocol.DirectoryFilter

type ErrUnknownCommand = hubprotocol.ErrUnknownCommand

type ErrorCode = hubprotocol.ErrorCode

type HookPayload struct {
	Event   string            `json:"event"`
	Payload json.RawMessage   `json:"payload,omitempty"`
	Tags    map[string]string `json:"tags,omitempty"`
}

type InboxStatsRecord struct {
	Critical int   `json:"critical"`
	Error    int   `json:"error"`
	Warning  int   `json:"warning"`
	Info     int   `json:"info"`
	Dropped  int64 `json:"dropped"`
	New      int   `json:"new"` // unread entries
}

type IncidentContext struct {
	ProcessID   string `json:"process_id,omitempty"`
	ProxyID     string `json:"proxy_id,omitempty"`
	SessionID   string `json:"session_id,omitempty"`
	ProjectPath string `json:"project_path,omitempty"`
	URL         string `json:"url,omitempty"`
	PID         int    `json:"pid,omitempty"`
	Port        int    `json:"port,omitempty"`
}

type IncidentQueryFilter struct {
	Severities   []string `json:"severities,omitempty"`   // critical/error/warning/info; empty = all
	Since        string   `json:"since,omitempty"`        // RFC3339 timestamp for lower bound
	Fingerprints []string `json:"fingerprints,omitempty"` // limit to specific fps
	Sources      []string `json:"sources,omitempty"`      // filter by Source enum values
	ProxyID      string   `json:"proxy_id,omitempty"`
	ProcessID    string   `json:"process_id,omitempty"`
	Detail       string   `json:"detail,omitempty"` // "summary" (default) | "full"
	MarkRead     bool     `json:"mark_read,omitempty"`
	Limit        int      `json:"limit,omitempty"` // 0 → 20; max 100
}

type IncidentQueryResult struct {
	Incidents  []IncidentRecord `json:"incidents"`
	InboxStats InboxStatsRecord `json:"inbox_stats"`
	Cursor     string           `json:"cursor,omitempty"` // RFC3339 of last-seen for resumable pulls
	Truncated  bool             `json:"truncated"`
	// PipelineEnabled reports whether the caller's session actually has an
	// incident pipeline (alerts.incident-pipeline). True only when a session
	// pipeline exists — distinguishes "pipeline on, inbox empty" from "pipeline
	// off". get_errors uses this to decide whether to shim over the inbox.
	PipelineEnabled bool `json:"pipeline_enabled"`
}

type IncidentRecord struct {
	ID          string              `json:"id"`
	Fingerprint string              `json:"fingerprint"`
	FirstSeen   string              `json:"first_seen"` // RFC3339
	LastSeen    string              `json:"last_seen"`  // RFC3339
	Count       int                 `json:"count"`
	Severity    string              `json:"severity"`
	Source      string              `json:"source"`
	Category    string              `json:"category,omitempty"`
	Summary     string              `json:"summary,omitempty"`
	Payload     *string             `json:"payload,omitempty"` // set when detail="full"
	Context     IncidentContext     `json:"context,omitempty"`
	Remediation IncidentRemediation `json:"remediation,omitempty"`
	Read        bool                `json:"read"`
}

type IncidentRemediation struct {
	PrimaryTool  string         `json:"primary_tool,omitempty"`
	PrimaryArgs  map[string]any `json:"primary_args,omitempty"`
	FallbackTool string         `json:"fallback_tool,omitempty"`
	SkillHint    string         `json:"skill_hint,omitempty"`
}

type LogQueryFilter struct {
	Types       []string `json:"types,omitempty"`
	Methods     []string `json:"methods,omitempty"`
	URLPattern  string   `json:"url_pattern,omitempty"`
	StatusCodes []int    `json:"status_codes,omitempty"`
	Since       string   `json:"since,omitempty"`
	Until       string   `json:"until,omitempty"`
	Limit       int      `json:"limit,omitempty"`
	// ErrorsOnly filters to error-class entries (HTTP 4xx/5xx, JS errors,
	// error-level diagnostics) across all sources.
	ErrorsOnly bool `json:"errors_only,omitempty"`
	// DiagnosticLevels filters diagnostic entries by level (info, warning, error).
	DiagnosticLevels []string `json:"diagnostic_levels,omitempty"`
}

type OutputFilter = hubprotocol.OutputFilter

type Parser = hubprotocol.Parser

type ProxyStartConfig struct {
	ID          string        `json:"id"`
	TargetURL   string        `json:"target_url"`
	Port        int           `json:"port"`
	MaxLogSize  int           `json:"max_log_size,omitempty"`
	BindAddress string        `json:"bind_address,omitempty"` // "127.0.0.1" (default) or "0.0.0.0" (all interfaces)
	PublicURL   string        `json:"public_url,omitempty"`   // Public URL for tunnels (e.g., "https://abc.trycloudflare.com")
	Tunnel      *TunnelConfig `json:"tunnel,omitempty"`
}

type Response = hubprotocol.Response

type ResponseType = hubprotocol.ResponseType

type RunConfig = hubprotocol.RunConfig

type SessionHostCreateConfig struct {
	Name        string            `json:"name,omitempty"`
	ProjectPath string            `json:"project_path"`
	Command     string            `json:"command"`
	Args        []string          `json:"args,omitempty"`
	Cols        int               `json:"cols"`
	Rows        int               `json:"rows"`
	Env         map[string]string `json:"env,omitempty"`
}

type SessionHostCreateResult struct {
	SessionID   string `json:"session_id"`
	SessionPGID int    `json:"session_pgid"`
}

type SessionHostResizeConfig struct {
	SessionID string `json:"session_id"`
	Cols      int    `json:"cols"`
	Rows      int    `json:"rows"`
}

type SessionRegisterConfig struct {
	OverlayPath      string   `json:"overlay_path"`                 // Unix socket path for overlay
	ProjectPath      string   `json:"project_path"`                 // Directory where session was started
	Command          string   `json:"command"`                      // Command being run (e.g., "claude")
	Args             []string `json:"args,omitempty"`               // Command arguments
	SessionPGID      int      `json:"session_pgid,omitempty"`       // POSIX process group ID of the PTY child (session leader); 0 on Windows or when unavailable
	SessionJobHandle uint64   `json:"session_job_handle,omitempty"` // Windows Job Object handle for the PTY child subtree; 0 on Unix or when unavailable. Handles are per-process on Windows — this is a best-effort hint for daemon cleanup, not a stable cross-process identifier.
}

type SessionScheduleConfig struct {
	SessionCode string `json:"session_code"` // Target session
	Duration    string `json:"duration"`     // Go duration string (e.g., "5m", "1h30m")
	Message     string `json:"message"`      // Message to deliver
	ProjectPath string `json:"project_path"` // For project-scoped storage
}

type StoreClearRequest struct {
	Scope    string `json:"scope"`
	ScopeKey string `json:"scope_key"`
}

type StoreDeleteRequest struct {
	Scope    string `json:"scope"`
	ScopeKey string `json:"scope_key"`
	Key      string `json:"key"`
}

type StoreGetAllRequest struct {
	Scope    string `json:"scope"`
	ScopeKey string `json:"scope_key"`
}

type StoreGetRequest struct {
	Scope    string `json:"scope"`
	ScopeKey string `json:"scope_key"`
	Key      string `json:"key"`
}

type StoreListRequest struct {
	Scope    string `json:"scope"`
	ScopeKey string `json:"scope_key"`
}

type StoreSetRequest struct {
	Scope    string         `json:"scope"`
	ScopeKey string         `json:"scope_key"`
	Key      string         `json:"key"`
	Value    interface{}    `json:"value"`
	Metadata map[string]any `json:"metadata,omitempty"`
}

type StreamEventFilter struct {
	Types       []string `json:"types,omitempty"`        // Log entry types: error, http, panel_message, process, etc.
	ProxyID     string   `json:"proxy_id,omitempty"`     // Filter to specific proxy
	ProjectPath string   `json:"project_path,omitempty"` // Filter to proxies belonging to this project directory
	ProcessID   string   `json:"process_id,omitempty"`   // Filter to specific process output
	Severity    string   `json:"severity,omitempty"`     // Filter by severity: error, warning, info
	Grep        string   `json:"grep,omitempty"`         // Substring match on process output lines
	GrepStream  string   `json:"grep_stream,omitempty"`  // Filter process output stream: "stdout" or "stderr"
}

type StructuredError = hubprotocol.StructuredError

type ToastConfig struct {
	Type     string `json:"type"`               // success, error, warning, info
	Title    string `json:"title,omitempty"`    // Toast title (optional)
	Message  string `json:"message"`            // Toast message
	Duration int    `json:"duration,omitempty"` // Duration in ms (0 for default)
}

type TunnelConfig struct {
	// Provider is the tunnel provider: "ngrok", "cloudflared", "tailscale", or "custom"
	Provider string `json:"provider"`
	// Command is used when Provider is "custom" - the full command to run
	Command string `json:"command,omitempty"`
	// Args are additional arguments for the tunnel command
	Args []string `json:"args,omitempty"`
	// AuthToken is the authentication token (for ngrok)
	AuthToken string `json:"auth_token,omitempty"`
	// Region is the tunnel region (optional)
	Region string `json:"region,omitempty"`
}

type TunnelStartConfig struct {
	ID         string `json:"id"`                    // Tunnel ID (usually same as proxy ID)
	Provider   string `json:"provider"`              // "cloudflare" or "ngrok"
	LocalPort  int    `json:"local_port"`            // Local port to tunnel
	LocalHost  string `json:"local_host,omitempty"`  // Local host (default: localhost)
	BinaryPath string `json:"binary_path,omitempty"` // Optional path to tunnel binary
	ProxyID    string `json:"proxy_id,omitempty"`    // Optional proxy ID to auto-configure public_url
}

type VerbRegistry = hubprotocol.VerbRegistry

type Writer = hubprotocol.Writer