protocol

type Annotation struct {
	Audience     []Role  `json:"audience,omitempty"`     // 目标受众 (user, assistant)
	Priority     float64 `json:"priority,omitempty"`     // 优先级 (0.0-1.0)
	LastModified string  `json:"lastModified,omitempty"` // 最后修改时间 (ISO 8601)
}

type AudioContent struct {
	Type        ContentType `json:"type"`
	Data        string      `json:"data"`     // Base64 编码的音频数据
	MimeType    string      `json:"mimeType"` // 例如: audio/wav, audio/mp3
	Annotations *Annotation `json:"annotations,omitempty"`
}

type CallToolParams struct {
	Meta      map[string]any `json:"_meta,omitempty"`
	Name      string         `json:"name"`
	Arguments map[string]any `json:"arguments"`
}

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

type CallToolResult struct {
	Content           []Content      `json:"content"`
	IsError           bool           `json:"isError,omitempty"`
	StructuredContent any            `json:"structuredContent,omitempty"` // MCP 2025-06-18
	Meta              map[string]any `json:"_meta,omitempty"`             // MCP 2025-06-18: 扩展元数据
}

type CancelledNotificationParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
	// 要取消的请求 ID
	RequestID any `json:"requestId"`
	// 可选的取消原因描述
	Reason string `json:"reason,omitempty"`
}

type ClientCapabilities struct {
	Roots        *RootsCapability       `json:"roots,omitempty"`
	Sampling     *SamplingCapability    `json:"sampling,omitempty"`
	Elicitation  *ElicitationCapability `json:"elicitation,omitempty"`
	Experimental map[string]interface{} `json:"experimental,omitempty"`
}

type ClientInfo struct {
	Name       string `json:"name"`
	Title      string `json:"title,omitempty"`
	Version    string `json:"version"`
	WebsiteURL string `json:"websiteUrl,omitempty"`
	Icons      []Icon `json:"icons,omitempty"`
}

type CompleteRequest struct {
	Ref      map[string]any     `json:"ref"`               // 引用 (PromptReference 或 ResourceReference)
	Argument CompletionArgument `json:"argument"`          // 要补全的参数
	Context  *CompletionContext `json:"context,omitempty"` // 可选的上下文
}

type CompleteResult struct {
	Completion CompletionResult `json:"completion"` // 补全结果
}

type CompletionArgument struct {
	Name  string `json:"name"`  // 参数名称
	Value string `json:"value"` // 当前值
}

type CompletionCapability struct{}

type CompletionContext struct {
	Arguments map[string]string `json:"arguments,omitempty"` // 已解析的参数映射
}

type CompletionReference interface {
	GetType() ReferenceType
}

type CompletionResult struct {
	Values  []string `json:"values"`          // 补全建议列表 (最多 100 个)
	Total   *int     `json:"total,omitempty"` // 可选: 总匹配数
	HasMore bool     `json:"hasMore"`         // 是否有更多结果
}

type Content interface {
	GetType() ContentType
}

type ContentType string

type CreateMessageParams = CreateMessageRequest

type CreateMessageRequest struct {
	Meta             map[string]any         `json:"_meta,omitempty"`
	Messages         []SamplingMessage      `json:"messages"`
	ModelPreferences *ModelPreferences      `json:"modelPreferences,omitempty"`
	SystemPrompt     string                 `json:"systemPrompt,omitempty"`
	IncludeContext   IncludeContext         `json:"includeContext,omitempty"`
	Temperature      *float64               `json:"temperature,omitempty"` // 0.0-1.0
	MaxTokens        int                    `json:"maxTokens"`             // 必需
	StopSequences    []string               `json:"stopSequences,omitempty"`
	Metadata         map[string]interface{} `json:"metadata,omitempty"`
}

type CreateMessageResult struct {
	Role       Role       `json:"role"`
	Content    Content    `json:"content"`
	Model      string     `json:"model"`
	StopReason StopReason `json:"stopReason"`
}

type ElicitationAction string

type ElicitationCapability struct{}

type ElicitationCreateParams struct {
	Message         string     `json:"message"`
	RequestedSchema JSONSchema `json:"requestedSchema"`
}

type ElicitationResult struct {
	Action  ElicitationAction `json:"action"`
	Content interface{}       `json:"content,omitempty"`
}

type EmbeddedResourceContent struct {
	Type     ContentType      `json:"type"`
	Resource ResourceContents `json:"resource"`
}

type EmptyResult struct{}

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

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

type GetPromptResult struct {
	Description string          `json:"description,omitempty"`
	Messages    []PromptMessage `json:"messages"`
	Meta        map[string]any  `json:"_meta,omitempty"`
}

type Icon struct {
	// Source 指向图标资源的 URI (必需)，可以是:
	// - HTTP/HTTPS URL 指向图像文件
	// - data URI 包含 base64 编码的图像数据
	Source string `json:"src"`
	// MIMEType 可选的 MIME 类型
	MIMEType string `json:"mimeType,omitempty"`
	// Sizes 可选的尺寸规范 (如 ["48x48"], ["any"] 用于 SVG 等可缩放格式)
	Sizes []string `json:"sizes,omitempty"`
	// Theme 可选的主题,如 "light" 或 "dark"
	Theme string `json:"theme,omitempty"`
}

type ImageContent struct {
	Type        ContentType `json:"type"`
	Data        string      `json:"data"`
	MimeType    string      `json:"mimeType"`
	Annotations *Annotation `json:"annotations,omitempty"` // MCP 2025-06-18
}

type IncludeContext string

type InitializeParams struct {
	Meta            map[string]any     `json:"_meta,omitempty"`
	ProtocolVersion string             `json:"protocolVersion"`
	Capabilities    ClientCapabilities `json:"capabilities"`
	ClientInfo      ClientInfo         `json:"clientInfo"`
}

type InitializeResult struct {
	ProtocolVersion string             `json:"protocolVersion"`
	Capabilities    ServerCapabilities `json:"capabilities"`
	ServerInfo      ServerInfo         `json:"serverInfo"`
	Instructions    string             `json:"instructions,omitempty"`
}

type InitializedParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

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

type JSONRPCMessage struct {
	JSONRPC string          `json:"jsonrpc"`
	ID      json.RawMessage `json:"id,omitempty"`
	Method  string          `json:"method,omitempty"`
	Params  json.RawMessage `json:"params,omitempty"`
	Result  json.RawMessage `json:"result,omitempty"`
	Error   *JSONRPCError   `json:"error,omitempty"`
}

type JSONSchema map[string]interface{}

type ListPromptsParams struct {
	Cursor string `json:"cursor,omitempty"`
}

type ListPromptsRequest struct {
	Cursor string `json:"cursor,omitempty"`
}

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

type ListResourceTemplatesParams = ListResourceTemplatesRequest

type ListResourceTemplatesRequest struct {
	Cursor string `json:"cursor,omitempty"`
}

type ListResourceTemplatesResult struct {
	ResourceTemplates []ResourceTemplate `json:"resourceTemplates"`
	PaginatedResult
}

type ListResourcesParams struct {
	Cursor string `json:"cursor,omitempty"`
}

type ListResourcesRequest struct {
	Cursor string `json:"cursor,omitempty"`
}

type ListResourcesResult struct {
	Resources []Resource `json:"resources"`
	PaginatedResult
}

type ListRootsParams struct {
}

type ListRootsRequest struct {
}

type ListRootsResult struct {
	Roots []Root `json:"roots"`
}

type ListToolsParams struct {
	Cursor string `json:"cursor,omitempty"`
}

type ListToolsRequest struct {
	Cursor string `json:"cursor,omitempty"`
}

type ListToolsResult struct {
	Tools []Tool `json:"tools"`
	PaginatedResult
}

type LoggingCapability struct{}

type LoggingLevel string

type LoggingMessageParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
	// 要记录的数据,例如字符串消息或对象
	// 允许任何 JSON 可序列化类型
	Data any `json:"data"`
	// 此日志消息的严重性级别
	Level LoggingLevel `json:"level"`
	// 发出此消息的日志记录器的可选名称
	Logger string `json:"logger,omitempty"`
}

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

type ModelHint struct {
	Name string `json:"name,omitempty"`
}

type ModelPreferences struct {
	Hints                []ModelHint `json:"hints,omitempty"`
	CostPriority         *float64    `json:"costPriority,omitempty"`         // 0-1, 成本优先级
	SpeedPriority        *float64    `json:"speedPriority,omitempty"`        // 0-1, 速度优先级
	IntelligencePriority *float64    `json:"intelligencePriority,omitempty"` // 0-1, 智能优先级
}

type PaginatedResult struct {
	NextCursor *string `json:"nextCursor,omitempty"`
}

type PaginationParams struct {
	Cursor string `json:"cursor,omitempty"`
}

type PingParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

type ProgressNotificationParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
	// 进度令牌,用于关联此通知与正在进行的请求
	ProgressToken any `json:"progressToken"`
	// 当前进度值,每次进度更新时应该增加
	Progress float64 `json:"progress"`
	// 总进度值(如果已知),0 表示未知
	Total float64 `json:"total,omitempty"`
	// 可选的进度描述消息
	Message string `json:"message,omitempty"`
}

type Prompt struct {
	Name        string           `json:"name"`
	Title       string           `json:"title,omitempty"` // MCP 2025-06-18: 人类友好的标题
	Description string           `json:"description,omitempty"`
	Arguments   []PromptArgument `json:"arguments,omitempty"`
	Meta        map[string]any   `json:"_meta,omitempty"` // MCP 2025-06-18: 扩展元数据
}

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

type PromptListChangedParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

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

type PromptReference struct {
	Type ReferenceType `json:"type"` // 必须是 "ref/prompt"
	Name string        `json:"name"` // 提示名称
}

type PromptsCapability struct {
	ListChanged bool `json:"listChanged,omitempty"`
}

type PromptsListChangedNotification struct{}

type ReadResourceParams struct {
	URI string `json:"uri"`
}

type ReadResourceRequest struct {
	URI string `json:"uri"`
}

type ReadResourceResult struct {
	Contents []ResourceContents `json:"contents"`
}

type ReferenceType string

type Resource struct {
	URI         string         `json:"uri"`
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	MimeType    string         `json:"mimeType,omitempty"`
	Meta        map[string]any `json:"_meta,omitempty"`
}

type ResourceContents struct {
	URI         string      `json:"uri"`
	Title       string      `json:"title,omitempty"`
	MimeType    string      `json:"mimeType,omitempty"`
	Text        string      `json:"text,omitempty"`
	Blob        string      `json:"blob,omitempty"`
	Annotations *Annotation `json:"annotations,omitempty"`
}

type ResourceLinkContent struct {
	Type        ContentType `json:"type"`
	URI         string      `json:"uri"`
	Name        string      `json:"name,omitempty"`
	Description string      `json:"description,omitempty"`
	MimeType    string      `json:"mimeType,omitempty"`
	Annotations *Annotation `json:"annotations,omitempty"`
}

type ResourceListChangedParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

type ResourceReference struct {
	Type ReferenceType `json:"type"` // 必须是 "ref/resource"
	URI  string        `json:"uri"`  // 资源 URI (可能包含模板变量)
}

type ResourceTemplate struct {
	URITemplate string         `json:"uriTemplate"`
	Name        string         `json:"name"`
	Description string         `json:"description,omitempty"`
	MimeType    string         `json:"mimeType,omitempty"`
	Meta        map[string]any `json:"_meta,omitempty"`
}

type ResourceTemplateListChangedParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

type ResourceTemplatesListChangedNotification struct{}

type ResourceUpdatedNotificationParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
	// 更新的资源 URI
	URI string `json:"uri"`
}

type ResourcesCapability struct {
	Subscribe   bool `json:"subscribe,omitempty"`
	ListChanged bool `json:"listChanged,omitempty"`
	Templates   bool `json:"templates,omitempty"`
}

type ResourcesListChangedNotification struct{}

type Role string

type Root struct {
	URI  string `json:"uri"`            // 根目录URI，必须是 file:// 协议
	Name string `json:"name,omitempty"` // 可选的人类可读名称
}

type RootsCapability struct {
	ListChanged bool `json:"listChanged,omitempty"`
}

type RootsListChangedNotification struct{}

type RootsListChangedParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

type SamplingCapability struct{}

type SamplingMessage struct {
	Role    Role    `json:"role"`
	Content Content `json:"content"`
}

type ServerCapabilities struct {
	Tools        *ToolsCapability       `json:"tools,omitempty"`
	Resources    *ResourcesCapability   `json:"resources,omitempty"`
	Prompts      *PromptsCapability     `json:"prompts,omitempty"`
	Logging      *LoggingCapability     `json:"logging,omitempty"`
	Completion   *CompletionCapability  `json:"completions,omitempty"` // MCP 2025-06-18: 参数自动补全
	Experimental map[string]interface{} `json:"experimental,omitempty"`
}

type ServerInfo struct {
	Name       string `json:"name"`
	Title      string `json:"title,omitempty"`
	Version    string `json:"version"`
	WebsiteURL string `json:"websiteUrl,omitempty"`
	Icons      []Icon `json:"icons,omitempty"`
}

type SetLoggingLevelParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
	// 客户端希望从服务器接收的日志级别
	// 服务器应该发送此级别及更高级别(即更严重)的所有日志到客户端
	Level LoggingLevel `json:"level"`
}

type StopReason string

type SubscribeParams struct {
	URI string `json:"uri"`
}

type TextContent struct {
	Type        ContentType `json:"type"`
	Text        string      `json:"text"`
	Annotations *Annotation `json:"annotations,omitempty"` // MCP 2025-06-18
}

type Tool struct {
	Name         string         `json:"name"`
	Title        string         `json:"title,omitempty"` // MCP 2025-06-18: 人类友好的标题
	Description  string         `json:"description,omitempty"`
	InputSchema  JSONSchema     `json:"inputSchema"`
	OutputSchema JSONSchema     `json:"outputSchema,omitempty"` // MCP 2025-06-18
	Meta         map[string]any `json:"_meta,omitempty"`        // MCP 2025-06-18: 扩展元数据
}

type ToolList struct {
	Tools []Tool `json:"tools"`
}

type ToolListChangedParams struct {
	Meta map[string]any `json:"_meta,omitempty"`
}

type ToolParameter struct {
	Name        string     `json:"name"`
	Description string     `json:"description,omitempty"`
	Required    bool       `json:"required,omitempty"`
	Schema      JSONSchema `json:"schema,omitempty"`
}

type ToolsCapability struct {
	ListChanged bool `json:"listChanged,omitempty"`
}

type ToolsListChangedNotification struct{}

type UnsubscribeParams struct {
	URI string `json:"uri"`
}