catalog

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

type Entry struct {
	Name        string `json:"name"`
	Title       string `json:"title,omitempty"`
	Description string `json:"description"`
	// Tier is TierCurated or TierRegistry, assigned at load time.
	Tier string `json:"tier,omitempty"`
	// Namespace links a curated entry to its MCP Registry name so merged
	// search results dedupe (the curated entry wins). Empty for registry
	// entries, whose Name is already the registry name.
	Namespace  string `json:"namespace,omitempty"`
	Homepage   string `json:"homepage,omitempty"`
	Repository string `json:"repository,omitempty"`
	// Status is StatusActive or StatusDeprecated. Empty means active.
	Status  string  `json:"status,omitempty"`
	Install Install `json:"install"`
	Inputs  []Input `json:"inputs,omitempty"`

	// Unsupported records the registry package type when no supported
	// install shape could be derived (mcpb, nuget, cargo, templated URLs).
	// Such entries still appear in search; Entry.Server rejects them with
	// UnsupportedInstallError.
	Unsupported string `json:"unsupported,omitempty"`

	// Reserved metadata: parsed and preserved for later enforcement
	// features (approval gates, trifecta policy, per-call costs), never
	// acted on today.
	Permissions      *Permissions `json:"permissions,omitempty"`
	RequiresApproval *bool        `json:"requires_approval,omitempty"`
	CostPerCall      *float64     `json:"cost_per_call,omitempty"`
}

type Input struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
	// Secret values are masked when prompted and routed into the variable
	// store as ${var:KEY} references rather than written literally.
	Secret bool `json:"secret,omitempty"`
	// Arg inputs are appended to the install command as positional
	// arguments instead of set in env.
	Arg bool `json:"arg,omitempty"`
	// Auth inputs feed the install's auth block (bearer token or header
	// value) instead of env. Only meaningful on url installs.
	Auth        bool     `json:"auth,omitempty"`
	Default     string   `json:"default,omitempty"`
	Placeholder string   `json:"placeholder,omitempty"`
	Choices     []string `json:"choices,omitempty"`
	// Format hints the value shape: "string", "number", "boolean", or
	// "filepath" (the MCP Registry input vocabulary).
	Format string `json:"format,omitempty"`
}

type Install struct {
	Type string `json:"type"`
	// Transport is "stdio", "http", or "sse" (config.MCPServer vocabulary;
	// the registry's "streamable-http" is normalized to "http" at load).
	Transport string `json:"transport"`

	// Container image (type: image).
	Image string `json:"image,omitempty"`
	Port  int    `json:"port,omitempty"`

	// Local process (type: command). Positional inputs (Input.Arg) are
	// appended to this base command in input order.
	Command []string `json:"command,omitempty"`

	// External remote (type: url).
	URL string `json:"url,omitempty"`
	// AuthType is "", "bearer", or "header". The value comes from the
	// entry's Auth input at install time.
	AuthType   string `json:"auth_type,omitempty"`
	AuthHeader string `json:"auth_header,omitempty"`
}

type Permissions struct {
	ReadPrivateData         bool `json:"read_private_data,omitempty"`
	ReadUntrustedPublicData bool `json:"read_untrusted_public_data,omitempty"`
	WriteOperation          bool `json:"write_operation,omitempty"`
}

type UnsupportedInstallError struct {
	// Kind names what was unsupported, e.g. "mcpb", "nuget", "cargo", or
	// "templated URL".
	Kind string
}