plugin

type CallToolArgs struct {
	ToolName string         `json:"tool_name"` // 工具名称
	Params   map[string]any `json:"params"`    // 调用参数
}

type CallToolResult struct {
	Result
	// Content 工具调用返回的内容数组，可以包含文本、文件或结构体内容
	Content []Content `json:"content"`
	// IsError 表示工具调用是否以错误结束
	// 如果未设置，则假定为 false（调用成功）
	IsError bool `json:"isError,omitempty"`
}

type Content interface {
	// GetType 返回内容的类型
	GetType() ContentType
}

type ContentType string

type FileContent struct {
	Type     ContentType `json:"type"`           // 内容类型，固定为 "file"
	FileType FileType    `json:"fileType"`       // 文件类型
	Data     string      `json:"data"`           // 文件数据（Base64编码）
	MimeType string      `json:"mimeType"`       // MIME类型
	Name     string      `json:"name,omitempty"` // 文件名称（可选）
	Size     int64       `json:"size,omitempty"` // 文件大小（字节）（可选）

	// 图片特定属性
	Width  int `json:"width,omitempty"`  // 图片宽度（仅图片文件）
	Height int `json:"height,omitempty"` // 图片高度（仅图片文件）

	// 音频/视频特定属性
	Duration float64 `json:"duration,omitempty"` // 音频/视频时长（秒）（仅音频/视频文件）
	Bitrate  int     `json:"bitrate,omitempty"`  // 比特率（仅音频/视频文件）

	// 文档特定属性
	PageCount int    `json:"pageCount,omitempty"` // 页数（仅文档文件）
	Author    string `json:"author,omitempty"`    // 作者（仅文档文件）

	// 通用文件属性
	Encoding string         `json:"encoding,omitempty"` // 文件编码
	Checksum string         `json:"checksum,omitempty"` // 文件校验和
	URL      string         `json:"url,omitempty"`      // 文件URL（可选）
	Metadata map[string]any `json:"metadata,omitempty"` // 额外元数据
}

type FileType string

type LoadedPlugin struct {
	Name     string              // 插件名称
	Path     string              // 插件文件路径
	Client   *plugin.Client      // 插件客户端
	Instance ToolPluginInterface // 插件实例
	Info     PluginInfo          // 插件信息
	Tools    []Tool              // 插件提供的工具
}

type PluginInfo struct {
	Name        string `json:"name"`        // 插件名称
	Version     string `json:"version"`     // 插件版本
	Description string `json:"description"` // 插件描述
	Author      string `json:"author"`      // 插件作者
}

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

type PropertyOption func(map[string]any)

type Result struct {
	// Meta 元数据属性由协议保留，允许客户端和服务器向其响应附加额外的元数据
	Meta map[string]any `json:"_meta,omitempty"`
}

type StructCallToolArgs struct {
	ToolName string `json:"tool_name"` // 工具名称
	Params   any    `json:"params"`    // 结构化参数（通常是map[string]any）
}

type StructContent struct {
	Type   ContentType `json:"type"`             // 内容类型，固定为 "struct"
	Data   any         `json:"data"`             // 结构体数据（可以是任意类型）
	Name   string      `json:"name,omitempty"`   // 结构体名称（可选）
	Schema string      `json:"schema,omitempty"` // 结构体模式定义（可选）
	Format string      `json:"format,omitempty"` // 数据格式（如 json、yaml 等）
}

type TextContent struct {
	Type ContentType `json:"type"`           // 内容类型，固定为 "text"
	Text string      `json:"text"`           // 文本内容
	Name string      `json:"name,omitempty"` // 内容名称（可选）
}

type Tool struct {
	Name           string          `json:"name"`         // 工具名称
	Description    string          `json:"description"`  // 工具描述
	InputSchema    ToolInputSchema `json:"input_schema"` // 工具输入参数 与 RawInputSchema 二选一
	RawInputSchema json.RawMessage `json:"-"`            // 工具输入参数的原始JSON Schema 与 InputSchema 二选一
}

type ToolInputSchema struct {
	Type       string         `json:"type"`                 // 参数类型
	Properties map[string]any `json:"properties,omitempty"` // 参数属性
	Required   []string       `json:"required,omitempty"`   // 参数必填
}

type ToolOption func(*Tool)

type ToolPlugin struct {
	Impl ToolPluginInterface // 插件的实际实现
}

type ToolPluginGenericInterface interface {
	// 包含基础接口的所有方法
	ToolPluginInterface

	// CallToolWithStruct 使用结构化参数调用指定的工具
	// params 是一个结构体，必须是可序列化的
	CallToolWithStruct(toolName string, params any) (*CallToolResult, error)
}

type ToolPluginInterface interface {
	// GetTools 获取插件提供的所有工具定义
	GetTools() ([]Tool, error)

	// CallTool 调用指定的工具并返回结果
	// 这是原始的方法，接受 map[string]any 类型的参数
	CallTool(toolName string, params map[string]any) (*CallToolResult, error)

	// GetPluginInfo 获取插件的基本信息
	GetPluginInfo() (PluginInfo, error)
}

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

type ToolPluginRPCServer struct {
	Impl ToolPluginInterface // 实际的插件实现
}