api

type AuthProvider interface {
	// IsRequireOAuth indicates whether OAuth authentication is required.
	IsRequireOAuth() bool
}

type BaseConfig interface {
	AuthProvider
	ClusterProvider
	ConfirmationRulesProvider
	DeniedResourcesProvider
	ExtendedConfigProvider
	StsConfigProvider
	ValidationEnabledProvider
	RequireTLSProvider
}

type ClusterProvider interface {
	// GetClusterProviderStrategy returns the cluster provider strategy (if configured).
	GetClusterProviderStrategy() string
	// GetKubeConfigPath returns the path to the kubeconfig file (if configured).
	GetKubeConfigPath() string
}

type ConfirmationRule struct {
	// Tool-level fields
	Tool        string `toml:"tool,omitempty"`
	Destructive *bool  `toml:"destructive,omitempty"`
	// Kube-level fields
	Verb      string `toml:"verb,omitempty"`
	Kind      string `toml:"kind,omitempty"`
	Group     string `toml:"group,omitempty"`
	Version   string `toml:"version,omitempty"`
	Name      string `toml:"name,omitempty"`
	Namespace string `toml:"namespace,omitempty"`
	// Common fields
	Message string `toml:"message"`
}

type ConfirmationRulesProvider interface {
	GetConfirmationRules() []ConfirmationRule
	GetConfirmationFallback() string
}

type DeniedResourcesProvider interface {
	// GetDeniedResources returns a list of GroupVersionKinds that are denied.
	GetDeniedResources() []GroupVersionKind
}

type ElicitParams struct {
	// Message is the message to present to the user.
	Message string
	// RequestedSchema is a JSON Schema defining the expected form fields. Used in form mode only.
	RequestedSchema *jsonschema.Schema
	// URL is the URL to present to the user. Used in URL mode only.
	URL string
	// ElicitationID is a tracking identifier for out-of-band URL elicitation completion. Used in URL mode only.
	ElicitationID string
}

type ElicitResult struct {
	// Action is one of the ElicitAction constants.
	Action string
	// Content contains the submitted form data. Only populated when Action is ElicitActionAccept.
	Content map[string]any
}

type Elicitor interface {
	Elicit(ctx context.Context, params *ElicitParams) (*ElicitResult, error)
}

type ErrInvalidInt64Type struct {
	Value interface{}
}

type ExtendedConfig interface {
	// Validate validates the extended configuration.  Returns an error if the configuration is invalid.
	Validate() error
}

type ExtendedConfigProvider interface {
	// GetProviderConfig returns the extended configuration for the given provider strategy.
	// The boolean return value indicates whether the configuration was found.
	GetProviderConfig(strategy string) (ExtendedConfig, bool)
	// GetToolsetConfig returns the extended configuration for the given toolset name.
	// The boolean return value indicates whether the configuration was found.
	GetToolsetConfig(name string) (ExtendedConfig, bool)
}

type GroupVersionKind struct {
	Group   string `json:"group" toml:"group"`
	Version string `json:"version" toml:"version"`
	Kind    string `json:"kind,omitempty" toml:"kind,omitempty"`
}

type HTTPValidationRequest struct {
	GVR          *schema.GroupVersionResource
	GVK          *schema.GroupVersionKind
	HTTPMethod   string // GET, POST, PUT, DELETE, PATCH
	Verb         string // get, list, create, update, delete, patch
	Namespace    string
	ResourceName string
	Body         []byte // For create/update validation
	Path         string
}

type HTTPValidator interface {
	Validate(ctx context.Context, req *HTTPValidationRequest) error
	Name() string
}

type KubernetesClient interface {
	genericclioptions.RESTClientGetter
	kubernetes.Interface
	// NamespaceOrDefault returns the provided namespace or the default configured namespace if empty
	NamespaceOrDefault(namespace string) string
	// RESTConfig returns the REST config used to create clients
	RESTConfig() *rest.Config
	// RESTMapper returns the REST mapper used to map GVK to GVR
	RESTMapper() meta.ResettableRESTMapper
	// DiscoveryClient returns the cached discovery client
	DiscoveryClient() discovery.CachedDiscoveryInterface
	// DynamicClient returns the dynamic client
	DynamicClient() dynamic.Interface
	// MetricsV1beta1Client returns the metrics v1beta1 client
	MetricsV1beta1Client() *metricsv1beta1.MetricsV1beta1Client
}

type ListOptions struct {
	metav1.ListOptions
	AsTable bool
}

type NodesTopOptions struct {
	metav1.ListOptions
	Name string
}

type Openshift interface {
	IsOpenShift(context.Context) bool
}

type PodsTopOptions struct {
	metav1.ListOptions
	AllNamespaces bool
	Namespace     string
	Name          string
}

type Prompt struct {
	Name        string           `json:"name" toml:"name"`
	Title       string           `json:"title,omitempty" toml:"title,omitempty"`
	Description string           `json:"description,omitempty" toml:"description,omitempty"`
	Arguments   []PromptArgument `json:"arguments,omitempty" toml:"arguments,omitempty"`
	Templates   []PromptTemplate `json:"messages,omitempty" toml:"messages,omitempty"`
}

type PromptArgument struct {
	Name        string `json:"name" toml:"name"`
	Description string `json:"description,omitempty" toml:"description,omitempty"`
	Required    bool   `json:"required" toml:"required"`
}

type PromptCallRequest interface {
	GetArguments() map[string]string
}

type PromptCallResult struct {
	Description string
	Messages    []PromptMessage
	Error       error
}

type PromptContent struct {
	Type string `json:"type" toml:"type"`
	Text string `json:"text,omitempty" toml:"text,omitempty"`
}

type PromptHandlerFunc func(params PromptHandlerParams) (*PromptCallResult, error)

type PromptHandlerParams struct {
	context.Context
	BaseConfig
	KubernetesClient
	PromptCallRequest
	Elicitor
}

type PromptMessage struct {
	Role    string        `json:"role" toml:"role"`
	Content PromptContent `json:"content" toml:"content"`
}

type PromptTemplate struct {
	Role    string `json:"role" toml:"role"`
	Content string `json:"content" toml:"content"`
}

type RequireTLSProvider interface {
	IsRequireTLS() bool
}

type ServerPrompt struct {
	Prompt         Prompt
	Handler        PromptHandlerFunc
	ClusterAware   *bool
	ArgumentSchema map[string]PromptArgument
}

type ServerTool struct {
	Tool               Tool
	Handler            ToolHandlerFunc
	ClusterAware       *bool
	TargetListProvider *bool
}

type StsConfigProvider interface {
	GetStsClientId() string
	GetStsClientSecret() string
	GetStsAudience() string
	GetStsScopes() []string
}

type Tool struct {
	// The name of the tool.
	// Intended for programmatic or logical use, but used as a display name in past
	// specs or fallback (if title isn't present).
	Name string `json:"name"`
	// A human-readable description of the tool.
	//
	// This can be used by clients to improve the LLM's understanding of available
	// tools. It can be thought of like a "hint" to the model.
	Description string `json:"description,omitempty"`
	// Additional tool information.
	Annotations ToolAnnotations `json:"annotations"`
	// Meta contains additional metadata for the tool (e.g., MCP Apps UI resource URI).
	// Example: map[string]any{"ui": map[string]any{"resourceUri": "ui://server/app.html"}}
	Meta map[string]any `json:"_meta,omitempty"`
	// A JSON Schema object defining the expected parameters for the tool.
	InputSchema *jsonschema.Schema
}

type ToolAnnotations struct {
	// Human-readable title for the tool
	Title string `json:"title,omitempty"`
	// If true, the tool does not modify its environment.
	ReadOnlyHint *bool `json:"readOnlyHint,omitempty"`
	// If true, the tool may perform destructive updates to its environment. If
	// false, the tool performs only additive updates.
	//
	// (This property is meaningful only when ReadOnlyHint == false.)
	DestructiveHint *bool `json:"destructiveHint,omitempty"`
	// If true, calling the tool repeatedly with the same arguments will have no
	// additional effect on its environment.
	//
	// (This property is meaningful only when ReadOnlyHint == false.)
	IdempotentHint *bool `json:"idempotentHint,omitempty"`
	// If true, this tool may interact with an "open world" of external entities. If
	// false, the tool's domain of interaction is closed. For example, the world of
	// a web search tool is open, whereas that of a memory tool is not.
	OpenWorldHint *bool `json:"openWorldHint,omitempty"`
}

type ToolCallRequest interface {
	GetArguments() map[string]any
}

type ToolCallResult struct {
	// Raw content returned by the tool.
	Content string
	// StructuredContent is an optional JSON-serializable value for MCP Apps UI rendering.
	// When set, it is passed as structuredContent in the MCP CallToolResult alongside Content.
	// Must be completely omitted (nil) when not used.
	StructuredContent any
	// Error (non-protocol) to send back to the LLM.
	Error error
}

type ToolHandlerFunc func(params ToolHandlerParams) (*ToolCallResult, error)

type ToolHandlerParams struct {
	context.Context
	BaseConfig
	KubernetesClient
	ToolCallRequest
	ListOutput output.Output
	Elicitor
}

type Toolset interface {
	// GetName returns the name of the toolset.
	// Used to identify the toolset in configuration, logs, and command-line arguments.
	// Examples: "core", "metrics", "helm"
	GetName() string
	// GetDescription returns a human-readable description of the toolset.
	// Will be used to generate documentation and help text.
	GetDescription() string
	GetTools(o Openshift) []ServerTool
	// GetPrompts returns the prompts provided by this toolset.
	// Returns nil if the toolset doesn't provide any prompts.
	GetPrompts() []ServerPrompt
}

type ValidationEnabledProvider interface {
	IsValidationEnabled() bool
}

type ValidationError struct {
	Code    ValidationErrorCode
	Message string
	Field   string // optional, for field-level errors
}

type ValidationErrorCode string