daemon

type APIDependencies struct {
	// Addr specifies the network address to bind (e.g., "0.0.0.0:8090").
	Addr string

	// ClientManager handles MCP client connections.
	ClientManager contracts.MCPClientAccessor

	// HealthTracker monitors server health status.
	HealthTracker contracts.MCPHealthMonitor

	// Logger for API server operations.
	Logger hclog.Logger
}

type APIOption func(*APIOptions) error

type APIOptions struct {
	// CORS configuration for cross-origin requests.
	CORS CORSConfig

	// ShutdownTimeout specifies how long to wait for graceful shutdown.
	ShutdownTimeout time.Duration

	// MiddlewareProvider lazily provides HTTP middleware when called during API server startup.
	// This allows plugin initialization to be deferred until the server actually starts.
	MiddlewareProvider func(context.Context) (func(http.Handler) http.Handler, error)
}

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

type CORSConfig struct {
	// Enabled determines whether CORS headers are added to responses.
	Enabled bool

	// AllowCredentials indicates whether the request can include credentials.
	// Must be false when AllowOrigins contains "*"
	AllowCredentials bool

	// AllowedHeaders specifies which headers the client can include in requests.
	AllowedHeaders []string

	// AllowMethods specifies which HTTP methods are permitted.
	// Using strings to match the go-chi/cors library API.
	AllowMethods []string

	// AllowOrigins specifies which origins can access the API.
	// Use ["*"] to allow all origins (not recommended for production).
	AllowOrigins []string

	// ExposedHeaders specifies which response headers are accessible to the client.
	ExposedHeaders []string

	// MaxAge specifies how long browsers can cache preflight responses.
	MaxAge time.Duration
}

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

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

type Dependencies struct {
	// APIAddr specifies the network address for the APIServer to bind (e.g., "0.0.0.0:8090").
	APIAddr string

	// Logger for daemon and subcomponent (API server) operations.
	Logger hclog.Logger

	// RuntimeServers contains the aggregated runtime servers (config + secrets).
	RuntimeServers []runtime.Server
}

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

type Option func(*Options) error

type Options struct {
	// APIOptions contains functional options for the API server.
	APIOptions []APIOption

	// ClientInitTimeout specifies how long to wait for MCP server initialization.
	ClientInitTimeout time.Duration

	// ClientHealthCheckInterval specifies how often to ping MCP servers for health checks.
	ClientHealthCheckInterval time.Duration

	// ClientHealthCheckTimeout specifies maximum time to wait for health check responses.
	ClientHealthCheckTimeout time.Duration

	// ClientShutdownTimeout specifies how long to wait for MCP clients to close.
	ClientShutdownTimeout time.Duration

	// PluginConfig specifies the configuration for plugins.
	PluginConfig *config.PluginConfig
}