agentplugin

type Author struct {
	Name  string `json:"name,omitempty"`
	Email string `json:"email,omitempty"`
	URL   string `json:"url,omitempty"`
}

type MCPConfig struct {
	Schema     string                   `json:"$schema"`
	MCPServers map[string]MCPServerSpec `json:"mcpServers"`
}

type MCPEntryStatus struct {
	Name      string        // server 条目名
	Spec      MCPServerSpec // 原始配置(占位符已展开)
	Connected bool          // 是否已连接
	ToolCount int           // 已发现的工具数
	Error     string        // 连接/校验失败原因(空表示成功)
}

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

type MCPServerSpec struct {
	Type    string            `json:"type"`              // stdio | streamable-http | sse
	Command string            `json:"command,omitempty"` // stdio:单个可执行 token(不展开占位符)
	Args    []string          `json:"args,omitempty"`    // stdio:展开占位符
	Env     map[string]string `json:"env,omitempty"`     // stdio:env 值展开占位符,key 不展开
	Cwd     string            `json:"cwd,omitempty"`     // stdio:展开占位符,须在 PLUGIN_ROOT/PLUGIN_DATA 内
	URL     string            `json:"url,omitempty"`     // http:绝对 URL(不展开占位符)
	Headers map[string]string `json:"headers,omitempty"` // http:字面 headers,不含凭证
}

type ManagedPlugin struct {
	Plugin   *Plugin
	Runtime  *Runtime // MCP 运行时;无 MCP 或被禁用时为 nil
	Disabled bool     // 是否被显式禁用(禁用时不启动 MCP、不注入 skills/tools)
}

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

type Manifest struct {
	Schema      string         `json:"$schema"`           // 必须,选择规范校验契约
	Name        string         `json:"name"`              // 必须,1-64 字符,小写字母/数字/连字符/点
	Version     string         `json:"version,omitempty"` // 可选,推荐 SemVer
	Description string         `json:"description,omitempty"`
	Author      *Author        `json:"author,omitempty"`
	Homepage    string         `json:"homepage,omitempty"`
	Repository  string         `json:"repository,omitempty"`
	License     string         `json:"license,omitempty"`
	Keywords    []string       `json:"keywords,omitempty"`
	Extensions  map[string]any `json:"extensions,omitempty"` // 反向域名命名空间,客户端按需消费
	Unknown     []string       `json:"-"`                    // 加载时检测到的未知顶层字段(报告用)
}

type Plugin struct {
	Root       string           // 插件根目录(文件系统解析后的绝对路径)
	DataDir    string           // PLUGIN_DATA 可写数据目录(跨更新持久)
	Manifest   *Manifest        // 清单
	Skills     []SkillRef       // 发现的 skills
	MCPServers []MCPEntryStatus // MCP 连接状态
	Extensions map[string]any   // 已识别的扩展命名空间数据(未实现的命名空间已忽略)

	// 加载报告
	MCPDisabled   bool     // 顶层 mcp.json 无效时整个 MCP 被禁用
	ManifestValid bool     // 清单是否通过校验
	FatalError    string   // 致命错误(非空时插件被拒绝,仅 Root/Manifest 可用)
	Warnings      []string // 非致命报告(unknown 字段、非 object extensions、跳过的 skill 等)
}

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

type SkillRef struct {
	Name  string        // skill 子目录名
	Dir   string        // skill 目录绝对路径(已解析符号链接)
	Skill *skills.Skill // 解析后的 skill(失败时为 nil)
	Error string        // 该 skill 加载失败原因(空表示成功)
}

type SkillsGroup struct {
	Plugin string
	Skills []*skills.Skill
}

type ToolRegistrar interface {
	Register(t tool.Tool)
}