config

type AgentConfig struct {
	// Name Agent 名称
	Name string `yaml:"name" json:"name"`

	// Description Agent 描述
	Description string `yaml:"description" json:"description"`

	// Type Agent 类型: react, plan, custom
	Type string `yaml:"type" json:"type"`

	// Role 角色配置
	Role RoleConfig `yaml:"role" json:"role"`

	// LLM LLM 配置
	LLM LLMConfig `yaml:"llm" json:"llm"`

	// Tools 工具列表
	Tools []ToolConfig `yaml:"tools" json:"tools"`

	// Memory 记忆配置
	Memory MemoryConfig `yaml:"memory" json:"memory"`

	// MaxIterations 最大迭代次数
	MaxIterations int `yaml:"max_iterations" json:"max_iterations"`

	// Verbose 详细输出
	Verbose bool `yaml:"verbose" json:"verbose"`
}

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

type BuilderConfig struct {
	// BaseDir 基础目录
	BaseDir string

	// EnvPrefix 环境变量前缀
	EnvPrefix string

	// Strict 严格模式（验证所有引用）
	Strict bool

	// DefaultProvider 默认 LLM Provider
	DefaultProvider string

	// DefaultModel 默认模型
	DefaultModel string
}

type BuilderOption func(*BuilderConfig)

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

type Diff struct {
	// Path 字段路径（如 "llm.model"）
	Path string `json:"path"`

	// Type 差异类型
	Type DiffType `json:"type"`

	// OldValue 旧值
	OldValue any `json:"old_value,omitempty"`

	// NewValue 新值
	NewValue any `json:"new_value,omitempty"`

	// Message 差异描述
	Message string `json:"message,omitempty"`
}

type DiffResult struct {
	// Diffs 差异列表
	Diffs []Diff `json:"diffs"`

	// HasChanges 是否有变化
	HasChanges bool `json:"has_changes"`

	// AddedCount 新增字段数量
	AddedCount int `json:"added_count"`

	// RemovedCount 删除字段数量
	RemovedCount int `json:"removed_count"`

	// ModifiedCount 修改字段数量
	ModifiedCount int `json:"modified_count"`
}

type DiffSummary struct {
	// ConfigType 配置类型
	ConfigType string `json:"config_type"`

	// Result 差异结果
	Result *DiffResult `json:"result"`

	// KeyChanges 关键变化（如 LLM 模型变化、工具新增/删除等）
	KeyChanges []string `json:"key_changes,omitempty"`
}

type DiffType string

type EdgeConfig struct {
	// From 源节点
	From string `yaml:"from" json:"from"`

	// To 目标节点
	To string `yaml:"to" json:"to"`

	// Condition 条件（可选）
	Condition string `yaml:"condition" json:"condition"`

	// Label 标签
	Label string `yaml:"label" json:"label"`
}

type Environment string

type EnvironmentConfig struct {
	// CurrentEnv 当前环境
	CurrentEnv Environment `yaml:"current_env" json:"current_env"`

	// BaseDir 配置文件基础目录
	BaseDir string `yaml:"base_dir" json:"base_dir"`

	// Configs 各环境配置路径
	Configs map[Environment]string `yaml:"configs" json:"configs"`
}

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

type EnvironmentManagerOption func(*EnvironmentManager)

type ErrorHandler func(err error)

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

type HotReloadOption func(*HotReloader)

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

type LLMConfig struct {
	// Provider 提供商: openai, deepseek, anthropic, etc.
	Provider string `yaml:"provider" json:"provider"`

	// Model 模型名称
	Model string `yaml:"model" json:"model"`

	// APIKey API 密钥（可从环境变量读取）
	APIKey string `yaml:"api_key" json:"api_key"`

	// BaseURL 自定义 API 地址
	BaseURL string `yaml:"base_url" json:"base_url"`

	// Temperature 温度参数
	Temperature float64 `yaml:"temperature" json:"temperature"`

	// MaxTokens 最大 Token 数
	MaxTokens int `yaml:"max_tokens" json:"max_tokens"`
}

type MemoryConfig struct {
	// Type 记忆类型: buffer, vector, summary
	Type string `yaml:"type" json:"type"`

	// MaxSize 最大大小
	MaxSize int `yaml:"max_size" json:"max_size"`

	// Config 特定配置
	Config map[string]any `yaml:"config" json:"config"`
}

type MultiConfig struct {
	Agents    []*AgentConfig
	Teams     []*TeamConfig
	Workflows []*WorkflowConfig
}

type NodeConfig struct {
	// Name 节点名称
	Name string `yaml:"name" json:"name"`

	// Type 节点类型: agent, tool, condition, parallel
	Type string `yaml:"type" json:"type"`

	// Agent Agent 配置（如果是 agent 类型）
	Agent *AgentConfig `yaml:"agent" json:"agent"`

	// AgentRef Agent 引用（引用已定义的 Agent）
	AgentRef string `yaml:"agent_ref" json:"agent_ref"`

	// Condition 条件表达式（如果是 condition 类型）
	Condition string `yaml:"condition" json:"condition"`

	// Parallel 并行节点列表（如果是 parallel 类型）
	Parallel []string `yaml:"parallel" json:"parallel"`
}

type ProviderFactory interface {
	Create(provider string, opts ProviderOptions) (llm.Provider, error)
}

type ProviderOptions struct {
	Model       string
	APIKey      string
	BaseURL     string
	Temperature float64
	MaxTokens   int
}

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

type ReloadCallback func(config any, err error)

type RoleConfig struct {
	// Name 角色名称
	Name string `yaml:"name" json:"name"`

	// Title 角色头衔
	Title string `yaml:"title" json:"title"`

	// Goal 角色目标
	Goal string `yaml:"goal" json:"goal"`

	// Backstory 背景故事
	Backstory string `yaml:"backstory" json:"backstory"`

	// Expertise 专长领域
	Expertise []string `yaml:"expertise" json:"expertise"`

	// Personality 性格特点
	Personality string `yaml:"personality" json:"personality"`

	// Constraints 行为约束
	Constraints []string `yaml:"constraints" json:"constraints"`
}

type TeamConfig struct {
	// Name 团队名称
	Name string `yaml:"name" json:"name"`

	// Description 团队描述
	Description string `yaml:"description" json:"description"`

	// Mode 工作模式: sequential, hierarchical, collaborative, round_robin
	Mode string `yaml:"mode" json:"mode"`

	// Manager 管理者 Agent（仅用于 hierarchical 模式）
	Manager string `yaml:"manager" json:"manager"`

	// Agents Agent 配置列表
	Agents []AgentConfig `yaml:"agents" json:"agents"`

	// MaxRounds 最大轮次
	MaxRounds int `yaml:"max_rounds" json:"max_rounds"`
}

type ToolConfig struct {
	// Name 工具名称
	Name string `yaml:"name" json:"name"`

	// Type 工具类型: builtin, mcp, custom
	Type string `yaml:"type" json:"type"`

	// Config 工具特定配置
	Config map[string]any `yaml:"config" json:"config"`
}

type ToolFactory interface {
	Create(name, toolType string, config map[string]any) (tool.Tool, error)
}

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

type Version struct {
	// ID 版本 ID（时间戳 + 哈希前8位）
	ID string `json:"id" yaml:"id"`

	// Hash 配置内容哈希（SHA256）
	Hash string `json:"hash" yaml:"hash"`

	// Timestamp 创建时间戳
	Timestamp time.Time `json:"timestamp" yaml:"timestamp"`

	// Description 版本描述
	Description string `json:"description" yaml:"description"`

	// Tags 版本标签（如 production, staging, test）
	Tags []string `json:"tags,omitempty" yaml:"tags,omitempty"`

	// Config 配置内容（JSON 格式）
	Config string `json:"config" yaml:"config"`

	// ConfigType 配置类型（agent/team/workflow）
	ConfigType string `json:"config_type" yaml:"config_type"`
}

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

type VersionManagerOption func(*VersionManager)

type WorkflowConfig struct {
	// Name 工作流名称
	Name string `yaml:"name" json:"name"`

	// Description 工作流描述
	Description string `yaml:"description" json:"description"`

	// Nodes 节点列表
	Nodes []NodeConfig `yaml:"nodes" json:"nodes"`

	// Edges 边列表
	Edges []EdgeConfig `yaml:"edges" json:"edges"`

	// EntryPoint 入口点
	EntryPoint string `yaml:"entry_point" json:"entry_point"`
}