router

type CircuitBreakerAdmin interface {
	ClearService(ctx context.Context, serviceID string) int
}

type ConfigReporter interface {
	// GetSanitizedConfig returns a sanitized view of the active configuration.
	// All sensitive information (private keys, passwords) MUST be redacted.
	GetSanitizedConfig() map[string]interface{}
}

type ServiceReadinessReporter interface {
	// GetServiceReadiness returns readiness info for a specific service.
	// Returns endpoint count, whether sessions are available, and any error.
	GetServiceReadiness(serviceID protocol.ServiceID) (endpointCount int, hasSession bool, err error)

	// GetServiceEndpointDetails returns detailed endpoint information for a specific service.
	// Includes reputation scores, archival status, latency metrics, and more.
	GetServiceEndpointDetails(serviceID protocol.ServiceID) ([]protocol.EndpointDetails, error)

	// GetServicePerceivedBlockHeight returns the perceived block height for a service.
	// This is the highest block number observed across all endpoints for the service.
	// Returns 0 if no block number has been observed yet.
	GetServicePerceivedBlockHeight(serviceID protocol.ServiceID) uint64

	// GetServiceBlockConsensusStats returns block consensus statistics for a service.
	// Returns (medianBlock, observationCount) for observability.
	GetServiceBlockConsensusStats(serviceID protocol.ServiceID) (medianBlock uint64, observationCount int)

	// ConfiguredServiceIDs returns all configured service IDs.
	ConfiguredServiceIDs() map[protocol.ServiceID]struct{}
}

type ServiceReadinessResponse struct {
	Ready    bool                        `json:"ready"`
	Services map[string]ServiceReadyInfo `json:"services,omitempty"`
	Message  string                      `json:"message,omitempty"`
}

type ServiceReadyInfo struct {
	Ready                bool                       `json:"ready"`
	EndpointCount        int                        `json:"endpoint_count"`
	HasSession           bool                       `json:"has_session"`
	PerceivedBlockHeight uint64                     `json:"perceived_block_height,omitempty"`
	MedianBlockHeight    uint64                     `json:"median_block_height,omitempty"`
	BlockObservations    int                        `json:"block_observations,omitempty"`
	Error                string                     `json:"error,omitempty"`
	Endpoints            []protocol.EndpointDetails `json:"endpoints,omitempty"`
}