variants

type DeprecationInfo struct {
	// Message is a human-readable message explaining why this variant is
	// deprecated and how to migrate.
	Message string `json:"message"`

	// Replacement is the suggested replacement variant identifier.
	Replacement string `json:"replacement,omitempty"`

	// RemovalDate is an optional ISO 8601 date when this variant is planned
	// to be removed. Servers SHOULD continue to support the variant until
	// that date.
	RemovalDate string `json:"removalDate,omitempty"`
}

type HintKey = string

type RankingFunc func(ctx context.Context, hints VariantHints, variants []ServerVariant) []ServerVariant

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

type ServerVariant struct {
	// ID is a unique identifier for this variant. Freeform string that servers
	// define. Examples: "claude-optimized", "gpt-optimized", "compact",
	// "agent-plan".
	//
	// Each variant's ID MUST be unique within availableVariants.
	ID string `json:"id"`

	// Description is a human-readable description of this variant, suitable
	// for display to users or for LLM reasoning about variant selection.
	//
	// SHOULD include:
	//   - Target use case or model family
	//   - Key characteristics or optimizations
	//   - Trade-offs compared to other variants
	Description string `json:"description"`

	// Hints are key-value pairs providing structured metadata for intelligent
	// variant selection. Clients and LLMs can use these hints to
	// programmatically filter and rank variants.
	//
	// Unknown hint keys MUST be ignored by clients and servers.
	Hints map[string]string `json:"hints,omitempty"`

	// Status is the stability status of this variant.
	// Defaults to Stable if empty.
	Status VariantStatus `json:"status,omitempty"`

	// DeprecationInfo provides migration guidance when Status is Deprecated.
	DeprecationInfo *DeprecationInfo `json:"deprecationInfo,omitempty"`
	// contains filtered or unexported fields
}

type VariantHints struct {
	// Description is a human-readable description of the client's context and
	// requirements.
	Description string `json:"description,omitempty"`

	// Hints are key-value pairs providing structured metadata for variant
	// selection. Values can be a single string or an array of strings (in
	// order of preference).
	//
	// Unknown hint keys MUST be ignored by clients and servers.
	Hints map[string]any `json:"hints,omitempty"`
}

type VariantStatus string