servercard

type Config struct {
	// Version is advertised as the card's version and SHOULD match the
	// runtime serverInfo version. When empty, "0.0.0-dev" is used.
	Version string

	// RemoteURL is the absolute streamable-HTTP endpoint advertised in the
	// card's single remote. When empty, DefaultRemoteURL is used. The remote
	// repository supplies a per-environment URL here.
	RemoteURL string

	// RemoteURLFunc, when set, derives the streamable-HTTP remote URL from the
	// incoming request, taking precedence over RemoteURL whenever it returns a
	// non-empty value. This supports multi-tenant deployments (e.g. proxima)
	// where the absolute URL varies per request (e.g. from X-Forwarded-Host).
	//
	// It is consumed by the Handler when serving a card; NewServerCard ignores
	// it, since the card constructor is not request-aware.
	RemoteURLFunc func(*http.Request) string
}

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

type Remote struct {
	// Type is the transport type ("streamable-http" or "sse").
	Type string `json:"type"`
	// URL is the endpoint URL.
	URL string `json:"url"`
}

type Repository struct {
	// URL is the repository URL for browsing source and cloning.
	URL string `json:"url"`
	// Source is the hosting service identifier (e.g. "github").
	Source string `json:"source"`
	// ID is the optional repository identifier owned by the hosting service.
	ID string `json:"id,omitempty"`
}

type ServerCard struct {
	// Schema is the Server Card JSON Schema URI this document conforms to.
	Schema string `json:"$schema"`
	// Name is the server name in reverse-DNS format with exactly one slash.
	Name string `json:"name"`
	// Version is the server version, equivalent to Implementation.version.
	Version string `json:"version"`
	// Description is a short, human-readable explanation of server functionality.
	Description string `json:"description"`
	// Title is an optional human-readable display name.
	Title string `json:"title,omitempty"`
	// WebsiteURL optionally links to the server's homepage or documentation.
	WebsiteURL string `json:"websiteUrl,omitempty"`
	// Repository optionally describes the server's source code for inspection.
	Repository *Repository `json:"repository,omitempty"`
	// Remotes lists the HTTP-based endpoints for connecting to the server.
	Remotes []Remote `json:"remotes,omitempty"`
}