skills

type CapabilityDescriptor struct {
	Name        string
	Description string
	Category    string // "task", "query", or "stream"
	AgentID     string
	AgentName   string
	Tags        []string
	Metadata    map[string]string
}

type CapabilityRegistrar interface {
	RegisterCapability(ctx context.Context, descriptor *CapabilityDescriptor) error
	UnregisterCapability(ctx context.Context, agentID string, capabilityName string) error
}

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

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

type Skill struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Version     string   `json:"version"`
	Description string   `json:"description"`
	Category    string   `json:"category,omitempty"` // 技能分类
	Tags        []string `json:"tags,omitempty"`     // 标签

	// 核心内容
	Instructions string         `json:"instructions"` // 技能指令
	Tools        []string       `json:"tools"`        // 需要的工具列表
	Resources    map[string]any `json:"resources"`    // 资源（文件、数据等）
	Examples     []SkillExample `json:"examples"`     // 使用示例

	// 加载策略
	LazyLoad     bool     `json:"lazy_load"`    // 是否延迟加载
	Priority     int      `json:"priority"`     // 优先级（用于冲突解决）
	Dependencies []string `json:"dependencies"` // 依赖的其他技能

	// 元数据
	Author    string    `json:"author,omitempty"`
	License   string    `json:"license,omitempty"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`

	// 运行时状态
	Loaded   bool      `json:"-"` // 是否已加载
	LoadedAt time.Time `json:"-"` // 加载时间
}

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

type SkillCategory string

type SkillDefinition struct {
	ID           string          `json:"id"`
	Name         string          `json:"name"`
	Version      string          `json:"version"`
	Category     SkillCategory   `json:"category"`
	Description  string          `json:"description"`
	InputSchema  json.RawMessage `json:"input_schema"`
	OutputSchema json.RawMessage `json:"output_schema"`
	Requirements []string        `json:"requirements,omitempty"`
	Tags         []string        `json:"tags,omitempty"`
	Author       string          `json:"author,omitempty"`
	License      string          `json:"license,omitempty"`
	Metadata     map[string]any  `json:"metadata,omitempty"`
	CreatedAt    time.Time       `json:"created_at"`
	UpdatedAt    time.Time       `json:"updated_at"`
}

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

type SkillExample struct {
	Input       string `json:"input"`
	Output      string `json:"output"`
	Explanation string `json:"explanation,omitempty"`
}

type SkillHandler func(ctx context.Context, input json.RawMessage) (json.RawMessage, error)

type SkillInstance struct {
	Definition *SkillDefinition `json:"definition"`
	Handler    SkillHandler     `json:"-"`
	Enabled    bool             `json:"enabled"`
	Stats      SkillStats       `json:"stats"`
}

type SkillManager interface {
	// 技能发现
	DiscoverSkills(ctx context.Context, task string) ([]*Skill, error)

	// 技能加载
	LoadSkill(ctx context.Context, skillID string) (*Skill, error)
	UnloadSkill(ctx context.Context, skillID string) error

	// 技能查询
	GetSkill(skillID string) (*Skill, bool)
	ListSkills() []*SkillMetadata
	SearchSkills(query string) []*SkillMetadata

	// 技能管理
	RegisterSkill(skill *Skill) error
	UnregisterSkill(skillID string) error

	// 技能仓库
	ScanDirectory(dir string) error
	RefreshIndex() error
}

type SkillManagerConfig struct {
	AutoLoad        bool    `json:"auto_load"`         // 自动加载技能
	MaxLoadedSkills int     `json:"max_loaded_skills"` // 最大加载技能数
	MinMatchScore   float64 `json:"min_match_score"`   // 最低匹配分数
	EnableCaching   bool    `json:"enable_caching"`    // 启用缓存
	CacheTTL        int     `json:"cache_ttl"`         // 缓存 TTL（秒）
}

type SkillManifest struct {
	Skill
	Files []string `json:"files,omitempty"` // 关联的文件列表
}

type SkillMetadata struct {
	ID          string   `json:"id"`
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Category    string   `json:"category"`
	Tags        []string `json:"tags"`
	Version     string   `json:"version"`
	Path        string   `json:"path"` // 技能文件路径
}

type SkillStats struct {
	Invocations int64         `json:"invocations"`
	Successes   int64         `json:"successes"`
	Failures    int64         `json:"failures"`
	AvgLatency  time.Duration `json:"avg_latency"`
	LastInvoked *time.Time    `json:"last_invoked,omitempty"`
}

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