mcp

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

type CachedTool struct {
	Name        string          `json:"name"`
	Description string          `json:"description,omitempty"`
	InputSchema json.RawMessage `json:"inputSchema"`
}

type Caller interface {
	ListTools(context.Context, mcpsdk.ListToolsRequest) (*mcpsdk.ListToolsResult, error)
	CallTool(context.Context, mcpsdk.CallToolRequest) (*mcpsdk.CallToolResult, error)
	OnNotification(func(mcpsdk.JSONRPCNotification))
}

type CatalogCache struct {
	Fingerprint   string        `json:"fingerprint"`
	FetchedAt     time.Time     `json:"fetchedAt"`
	TTL           time.Duration `json:"ttl"`
	Transport     string        `json:"transport"`
	ServerName    string        `json:"serverName,omitempty"`
	ServerVersion string        `json:"serverVersion,omitempty"`
	Tools         []CachedTool  `json:"tools"`
}

type ClientOptions struct {
	// OpenBrowser overrides the platform browser opener used during OAuth login.
	OpenBrowser func(string) error
}

type ClientSession struct {
	Caller        Caller
	Transport     string
	ServerName    string
	ServerVersion string
	// contains filtered or unexported fields
}

type CommandOptions struct {
	ConfigPath    string
	Transport     string
	Address       string
	Port          int
	AutoExpose    bool
	InitialConfig *Config
}

type Config struct {
	// Server settings
	Name        string `json:"name"`
	Description string `json:"description"`
	Version     string `json:"version"`

	// Transport configuration
	Transport TransportConfig `json:"transport"`

	// Security settings
	Security SecurityConfig `json:"security"`

	// Tool exposure settings
	Tools ToolsConfig `json:"tools"`
}

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

type GetPromptResponse struct {
	Description string           `json:"description"`
	Arguments   []PromptArgument `json:"arguments,omitempty"`
	Messages    []PromptMessage  `json:"messages"`
}

type IgnoredParamRule struct {
	ToolGlob string   `json:"tool_glob"`
	Params   []string `json:"params"`
}

type JSONRPCError struct {
	Code    int         `json:"code"`
	Message string      `json:"message"`
	Data    interface{} `json:"data,omitempty"`
}

type JSONRPCRequest struct {
	JSONRPC string      `json:"jsonrpc"`
	ID      interface{} `json:"id,omitempty"`
	Method  string      `json:"method"`
	Params  interface{} `json:"params,omitempty"`
}

type JSONRPCResponse struct {
	JSONRPC string        `json:"jsonrpc"`
	ID      interface{}   `json:"id,omitempty"`
	Result  interface{}   `json:"result,omitempty"`
	Error   *JSONRPCError `json:"error,omitempty"`
}

type ListPromptsResponse struct {
	Prompts []Prompt `json:"prompts"`
}

type ListToolsResponse struct {
	Tools []ToolDefinition `json:"tools"`
}

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

type OAuthClientConfig struct {
	ClientID                     string   `json:"clientId,omitempty"`
	ClientSecret                 string   `json:"clientSecret,omitempty"`
	ClientName                   string   `json:"clientName,omitempty"`
	Scopes                       []string `json:"scopes,omitempty"`
	RedirectURI                  string   `json:"redirectUri,omitempty"`
	AuthServerMetadataURL        string   `json:"authServerMetadataUrl,omitempty"`
	ProtectedResourceMetadataURL string   `json:"protectedResourceMetadataUrl,omitempty"`
	Issuer                       string   `json:"issuer,omitempty"`
	DynamicallyRegistered        bool     `json:"dynamicallyRegistered,omitempty"`

	// TokenStore is required when an OAuth configuration is passed directly to
	// Dial. Registry-loaded configurations receive a private file-backed store.
	TokenStore client.TokenStore `json:"-"`
}

type OAuthLoginOptions struct {
	OpenBrowser func(string) error
	Out         io.Writer
	NoBrowser   bool
}

type Prompt struct {
	Name        string           `json:"name"`
	Description string           `json:"description"`
	Arguments   []PromptArgument `json:"arguments,omitempty"`
	Template    string           `json:"template"`
	Tags        []string         `json:"tags,omitempty"`
	Examples    []string         `json:"examples,omitempty"`
}

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

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

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

type PromptsGetParams struct {
	Name      string            `json:"name"`
	Arguments map[string]string `json:"arguments,omitempty"`
}

type Property struct {
	Type        string      `json:"type"`
	Description string      `json:"description"`
	Enum        []string    `json:"enum,omitempty"`
	Default     interface{} `json:"default,omitempty"`
}

type Schema struct {
	Type       string              `json:"type"`
	Properties map[string]Property `json:"properties"`
	Required   []string            `json:"required"`
}

type SecurityConfig struct {
	// Require user confirmation for tool invocations
	RequireConfirmation bool `json:"require_confirmation"`

	// Allowed commands (if empty, all commands are allowed)
	AllowedCommands []string `json:"allowed_commands"`

	// Blocked commands
	BlockedCommands []string `json:"blocked_commands"`

	// Enable audit logging
	AuditLog bool `json:"audit_log"`

	// Maximum execution time for tools
	TimeoutSeconds int `json:"timeout_seconds"`
}

type ServerConfig struct {
	Type         string             `json:"type,omitempty"`
	Command      string             `json:"command,omitempty"`
	Args         []string           `json:"args,omitempty"`
	Env          map[string]string  `json:"env,omitempty"`
	URL          string             `json:"url,omitempty"`
	Headers      map[string]string  `json:"headers,omitempty"`
	OAuth        *OAuthClientConfig `json:"oauth,omitempty"`
	Timeout      string             `json:"timeout,omitempty"`
	IncludeTools []string           `json:"includeTools,omitempty"`
	ExcludeTools []string           `json:"excludeTools,omitempty"`
	CacheTTL     string             `json:"cacheTTL,omitempty"`
}

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

type ToolAnnotations struct {
	Title           string `json:"title,omitempty"`
	ReadOnlyHint    *bool  `json:"readOnlyHint,omitempty"`
	DestructiveHint *bool  `json:"destructiveHint,omitempty"`
	IdempotentHint  *bool  `json:"idempotentHint,omitempty"`
	OpenWorldHint   *bool  `json:"openWorldHint,omitempty"`
}

type ToolCallParams struct {
	Name      string                 `json:"name"`
	Arguments map[string]interface{} `json:"arguments"`
}

type ToolCallResult struct {
	Content []ContentBlock `json:"content"`
	IsError bool           `json:"isError,omitempty"`
}

type ToolDefinition struct {
	Name         string                   `json:"name"`
	Title        string                   `json:"title"`
	Description  string                   `json:"description"`
	InputSchema  Schema                   `json:"inputSchema"`
	OutputSchema *Schema                  `json:"outputSchema,omitempty"`
	Annotations  *ToolAnnotations         `json:"annotations,omitempty"`
	Meta         map[string]any           `json:"_meta,omitempty"`
	Command      entity.ExecutableCommand `json:"-"` // Internal reference
}

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

type ToolsConfig struct {
	// Auto-expose all commands
	AutoExpose bool `json:"auto_expose"`

	// Include pattern for command names
	Include []string `json:"include"`

	// Exclude pattern for command names
	Exclude []string `json:"exclude"`

	// Override descriptions for specific commands
	Descriptions map[string]string `json:"descriptions,omitempty"`

	// IgnoredParams strips parameters (flags or positional names) from
	// the MCP-facing tool schema. Each rule applies to tools whose name
	// matches ToolGlob (path.Match semantics; "*" matches all). Names
	// in Params may include the "--" prefix or omit it.
	// MCP-only — does not affect OpenAPI generation.
	IgnoredParams []IgnoredParamRule `json:"ignored_params,omitempty"`

	// Format overrides the format/color settings of every tool execution
	// by setting the corresponding cobra flags on the command before it
	// runs. Useful for forcing Markdown without ANSI for AI clients.
	Format *formatters.FormatOptions `json:"format,omitempty"`
}

type TransportConfig struct {
	Type    string `json:"type"`    // "stdio" or "http"
	Address string `json:"address"` // For HTTP transport
	Port    int    `json:"port"`    // For HTTP transport
}