agent

type AdaptedModule struct {
	Name  string   `json:"name"`
	Steps []string `json:"adapted_steps"`
}

type Agent interface {
	core.Runnable[Input, Output]

	// ID 返回 Agent 唯一标识
	ID() string

	// Role 返回 Agent 的角色定义
	Role() Role

	// Tools 返回 Agent 可用的工具列表
	Tools() []tool.Tool

	// Memory 返回 Agent 的记忆系统
	Memory() memory.Memory

	// LLM 返回 Agent 使用的 LLM Provider
	LLM() llm.Provider

	// Run 执行 Agent（向后兼容方法）
	// Deprecated: 请使用 Invoke
	Run(ctx context.Context, input Input) (Output, error)
}

type AgentHandler func(ctx context.Context, input Input) (Output, error)

type AgentInfo struct {
	// ID Agent 唯一标识
	ID string `json:"id"`

	// Name Agent 名称
	Name string `json:"name"`

	// Description Agent 描述
	Description string `json:"description,omitempty"`

	// Version 版本号
	Version string `json:"version,omitempty"`

	// Tags 标签列表
	Tags []string `json:"tags,omitempty"`

	// Capabilities 能力列表
	Capabilities []Capability `json:"capabilities,omitempty"`

	// Endpoint 服务端点
	Endpoint string `json:"endpoint,omitempty"`

	// Metadata 元数据
	Metadata map[string]any `json:"metadata,omitempty"`

	// Status 状态
	Status AgentStatus `json:"status"`

	// RegisteredAt 注册时间
	RegisteredAt time.Time `json:"registered_at"`

	// LastHeartbeat 最后心跳时间
	LastHeartbeat time.Time `json:"last_heartbeat"`

	// HealthCheck 健康检查配置
	HealthCheck *HealthCheckConfig `json:"health_check,omitempty"`

	// Weight 权重（用于负载均衡）
	Weight int `json:"weight,omitempty"`

	// MaxConcurrency 最大并发数
	MaxConcurrency int `json:"max_concurrency,omitempty"`

	// CurrentLoad 当前负载
	CurrentLoad int `json:"current_load,omitempty"`
	// contains filtered or unexported fields
}

type AgentMiddleware func(next AgentHandler) AgentHandler

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

type AgentState interface {
	// Get 获取值
	Get(key string) (any, bool)

	// Set 设置值
	Set(key string, value any)

	// Delete 删除值
	Delete(key string)

	// All 获取所有键值对
	All() map[string]any

	// Stats 获取 Agent 统计信息
	Stats() AgentStats

	// UpdateStats 更新统计信息
	UpdateStats(fn func(*AgentStats))
}

type AgentStats struct {
	TotalRuns        int64         `json:"total_runs"`
	SuccessfulRuns   int64         `json:"successful_runs"`
	FailedRuns       int64         `json:"failed_runs"`
	TotalTokens      int64         `json:"total_tokens"`
	PromptTokens     int64         `json:"prompt_tokens"`
	CompletionTokens int64         `json:"completion_tokens"`
	TotalToolCalls   int64         `json:"total_tool_calls"`
	TotalDuration    time.Duration `json:"total_duration"`
	LastRunAt        time.Time     `json:"last_run_at"`
}

type AgentStatus string

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

type AgentToolInput struct {
	// Message 传递给 Agent 的消息
	Message string `json:"message" desc:"Message to send to the agent" required:"true"`

	// Context 额外上下文
	Context map[string]any `json:"context,omitempty" desc:"Additional context to pass to the agent"`
}

type AgentToolOption func(*AgentTool)

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

type Capability struct {
	// Name 能力名称
	Name string `json:"name"`

	// Description 能力描述
	Description string `json:"description,omitempty"`

	// Version 能力版本
	Version string `json:"version,omitempty"`

	// InputSchema 输入 Schema
	InputSchema map[string]any `json:"input_schema,omitempty"`

	// OutputSchema 输出 Schema
	OutputSchema map[string]any `json:"output_schema,omitempty"`

	// Constraints 约束条件
	Constraints map[string]any `json:"constraints,omitempty"`
}

type CapabilityAssignment struct {
	// Requirement 需求
	Requirement *CapabilityRequirement `json:"requirement"`

	// Agent 分配的 Agent
	Agent *AgentInfo `json:"agent"`

	// Capability 匹配的能力
	Capability *CapabilitySpec `json:"capability"`

	// Score 匹配分数
	Score float64 `json:"score"`
}

type CapabilityMatcher interface {
	// Match 检查 Agent 能力是否满足需求
	Match(requirement *CapabilityRequirement, capability *CapabilitySpec) bool
}

type CapabilityRequirement struct {
	// Name 需要的能力名称
	Name string `json:"name"`

	// Version 需要的版本（可选）
	Version string `json:"version,omitempty"`

	// Parameters 参数要求
	Parameters map[string]any `json:"parameters,omitempty"`

	// Constraints 约束要求
	Constraints []Constraint `json:"constraints,omitempty"`

	// Priority 优先级（1-10）
	Priority int `json:"priority,omitempty"`

	// Optional 是否可选
	Optional bool `json:"optional,omitempty"`
}

type CapabilityScorer interface {
	// Score 计算能力匹配分数
	Score(requirement *CapabilityRequirement, capability *CapabilitySpec) float64
}

type CapabilitySpec struct {
	// Name 能力名称
	Name string `json:"name"`

	// Version 能力版本
	Version string `json:"version,omitempty"`

	// Description 能力描述
	Description string `json:"description,omitempty"`

	// Category 能力分类
	Category string `json:"category,omitempty"`

	// InputSchema 输入 Schema
	InputSchema map[string]any `json:"input_schema,omitempty"`

	// OutputSchema 输出 Schema
	OutputSchema map[string]any `json:"output_schema,omitempty"`

	// Parameters 参数定义
	Parameters []ParameterSpec `json:"parameters,omitempty"`

	// Constraints 约束条件
	Constraints []Constraint `json:"constraints,omitempty"`

	// Dependencies 依赖的能力
	Dependencies []string `json:"dependencies,omitempty"`

	// Cost 能力成本估算
	Cost *CostEstimate `json:"cost,omitempty"`

	// SLA 服务级别协议
	SLA *SLASpec `json:"sla,omitempty"`
}

type Config struct {
	// ID Agent 唯一标识
	ID string

	// Name Agent 名称
	Name string

	// Description Agent 描述
	Description string

	// Role Agent 角色定义
	Role Role

	// SystemPrompt 系统提示词
	SystemPrompt string

	// LLM LLM 提供者
	LLM llm.Provider

	// Tools 可用工具列表
	Tools []tool.Tool

	// Memory 记忆系统
	Memory memory.Memory

	// MaxIterations 最大迭代次数（防止无限循环）
	MaxIterations int

	// Verbose 是否输出详细日志
	Verbose bool

	// Middleware 注入到底层 runtime 的中间件链（按序在每步 BeforeLLM/AfterLLM/
	// BeforeTool/AfterTool/Finalize 触发）。这是 runtime 中间件扩展点在 Agent 层的出口。
	//
	// 典型用途——共享同一个 cost.Controller 接入统一预算控制：
	//
	//	ctrl, err := cost.NewController(cost.WithBudget(10.0))
	//	if err != nil {
	//	    return nil, err
	//	}
	//	// 在 provider/调用方每次真正发起 LLM 请求前执行：
	//	if err := ctrl.CheckRequest(ctx, estimatedTokens); err != nil {
	//	    return nil, err
	//	}
	//	agent := NewReAct(WithLLM(p), WithMiddleware(middleware.NewBudgetControl(
	//	    middleware.BudgetControlConfig{
	//	        Limits: middleware.BudgetLimits{MaxCostUSD: 10.0, MaxTokens: 100000},
	//	        Cost:   ctrl.BudgetCostFunc(),
	//	        Record: ctrl.RecordUsageFunc(),
	//	    },
	//	)))
	//
	// 为空时（默认）底层 runner 不挂任何中间件，行为不变。
	//
	// NewBudgetControl 是首选入口，内部组合两层语义：Budget 按每次 runtime run
	// 检查 token/墙钟/成本，CostControl 通过 RecordUsageFunc 把每次 LLM 响应写入
	// 共享 Controller，因而对 PlanExecute/Reflection 等多 run agent 也提供全程累计
	// 封顶。CheckRequest 是发请求前的 token/频率预检，不由中间件代替；三者
	// 应共享同一 Controller。直接挂 Budget 或 CostControl 仅适合明确只需底层
	// per-run 或 cross-run 单层语义的高级用法。
	Middleware []agentruntime.Middleware

	// Durable 可选：开启可持久化/可恢复执行（经 WithCheckpointer 设置）。
	//
	// 非 nil 时，Agent 的底层 runtime run 会在每步边界持久化快照，并支持经 Resume
	// 从最近快照续跑。nil 时（默认）不触碰持久化、行为不变。
	//
	// 语义按 agent 类型：仅 ReActAgent（单次多轮 run）有干净的"整次执行可恢复"语义；
	// 多 run agent（PlanExecute/Reflection）每次内部调用是独立 run，Durable 不适用其整体恢复。
	Durable agentruntime.DurableExecution

	// Strategy 可选：选择统一 agent loop 的执行策略（经 WithStrategy 设置）。
	//
	// 统一 runtime 的回合循环由 Strategy 定制（系统前缀 / 是否继续 / 收尾）。nil 时
	// 默认 NoopStrategy（等价 ReAct）。借助 runtime/strategy 包可让同一个 ReActAgent
	// 以 ReAct / PlanExecute / Reflection 三种策略在**同一个统一回合循环**上运行
	// （提示词引导式），无需各自独立的 loop 实现。
	//
	// 注：独立的 PlanExecuteAgent / ReflectionAgent 是功能更丰富的多调用编排实现，
	// 与本"统一 loop + 策略"轻量路径并存，互不影响。
	Strategy agentruntime.Strategy
}

type ConsensusConfig struct {
	// Strategy 共识策略
	Strategy ConsensusStrategy

	// Threshold 阈值（用于多数投票，默认 0.5）
	Threshold float64

	// Timeout 超时时间
	Timeout time.Duration

	// MinParticipation 最小参与率（默认 0.5）
	MinParticipation float64

	// Weights Agent 权重（用于加权投票）
	Weights map[string]float64

	// Scorer 评分函数（用于最佳选择）
	Scorer func(vote Vote) float64

	// Validator 投票验证函数
	Validator func(vote Vote) bool

	// AllowAbstain 允许弃权
	AllowAbstain bool
}

type ConsensusOption func(*ConsensusConfig)

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

type ConsensusResult struct {
	// ID 结果 ID
	ID string `json:"id"`

	// Strategy 使用的策略
	Strategy ConsensusStrategy `json:"strategy"`

	// Decision 最终决策
	Decision any `json:"decision"`

	// Confidence 置信度（0-1）
	Confidence float64 `json:"confidence"`

	// Votes 所有投票
	Votes []Vote `json:"votes"`

	// VoteCount 投票统计
	VoteCount map[string]int `json:"vote_count"`

	// Participation 参与率
	Participation float64 `json:"participation"`

	// Reached 是否达成共识
	Reached bool `json:"reached"`

	// Reason 结果说明
	Reason string `json:"reason"`

	// Duration 耗时
	Duration time.Duration `json:"duration"`

	// Timestamp 时间戳
	Timestamp time.Time `json:"timestamp"`
}

type ConsensusStrategy int

type Constraint struct {
	// Type 约束类型
	Type ConstraintType `json:"type"`

	// Expression 约束表达式
	Expression string `json:"expression,omitempty"`

	// Value 约束值
	Value any `json:"value,omitempty"`

	// Description 约束描述
	Description string `json:"description,omitempty"`
}

type ConstraintType string

type ContextVariables map[string]any

type ConvMessage struct {
	// Role 角色（user/assistant）
	Role string `json:"role"`

	// Content 内容
	Content string `json:"content"`

	// Timestamp 时间戳
	Timestamp time.Time `json:"timestamp"`
}

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

type ConversationOption func(*ConversationAgent)

type CostEstimate struct {
	// PerRequest 每请求成本
	PerRequest float64 `json:"per_request,omitempty"`

	// PerToken 每 token 成本
	PerToken float64 `json:"per_token,omitempty"`

	// PerMinute 每分钟成本
	PerMinute float64 `json:"per_minute,omitempty"`

	// Currency 货币单位
	Currency string `json:"currency,omitempty"`
}

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

type DeepOption func(*DeepAgent)

type DefaultCapabilityMatcher struct{}

type DefaultCapabilityScorer struct {
	// Weights 各维度权重
	Weights ScoreWeights
}

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

type DiscoverOption func(*DiscoverQuery)

type DiscoverQuery struct {
	Tags         []string
	Capabilities []string
	Status       AgentStatus
	Metadata     map[string]any
}

type GlobalState interface {
	// Get 获取值
	Get(key string) (any, bool)

	// Set 设置值
	Set(key string, value any)

	// Delete 删除值
	Delete(key string)

	// All 获取所有键值对
	All() map[string]any

	// RegisterAgent 注册 Agent
	RegisterAgent(agentID string, agent Agent)

	// GetAgent 获取已注册的 Agent
	GetAgent(agentID string) (Agent, bool)

	// ListAgents 列出所有已注册的 Agent
	ListAgents() []string
}

type Handoff struct {
	// TargetAgent 目标 Agent
	TargetAgent Agent

	// Message 交接消息
	Message string

	// Context 交接上下文
	Context map[string]any

	// Reason 交接原因
	Reason string
}

type HandoffHandler struct {
	// OnHandoff 交接回调
	OnHandoff func(ctx context.Context, handoff Handoff) error
}

type HealthCheckConfig struct {
	// Interval 检查间隔
	Interval time.Duration `json:"interval"`

	// Timeout 超时时间
	Timeout time.Duration `json:"timeout"`

	// HealthyThreshold 健康阈值
	HealthyThreshold int `json:"healthy_threshold"`

	// UnhealthyThreshold 不健康阈值
	UnhealthyThreshold int `json:"unhealthy_threshold"`

	// HTTPPath HTTP 检查路径
	HTTPPath string `json:"http_path,omitempty"`
}

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

type Input struct {
	// Query 用户查询
	Query string `json:"query"`

	// Context 额外上下文
	Context map[string]any `json:"context,omitempty"`
}

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

type LeastConnectionsBalancer struct{}

type LoadBalancer interface {
	Select(agents []*AgentInfo) *AgentInfo
}

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

type LoopOption func(*LoopAgent)

type MemorySetter interface {
	SetMemory(mem memory.Memory)
}

type Message struct {
	Role      string         `json:"role"`
	Content   string         `json:"content"`
	ToolCalls []ToolCall     `json:"tool_calls,omitempty"`
	Metadata  map[string]any `json:"metadata,omitempty"`
}

type MessageHandler func(ctx context.Context, msg *NetworkMessage) (*NetworkMessage, error)

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

type MessageType int

type MetricsCollector interface {
	// RecordDuration 记录执行时长
	RecordDuration(duration time.Duration)

	// RecordCall 记录调用（成功或失败）
	RecordCall(success bool)

	// RecordToolCalls 记录工具调用次数
	RecordToolCalls(count int)

	// RecordTokens 记录 Token 使用量
	RecordTokens(count int)
}

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

type NegotiationPreferences struct {
	// PreferredAgents 偏好的 Agent ID
	PreferredAgents []string `json:"preferred_agents,omitempty"`

	// ExcludedAgents 排除的 Agent ID
	ExcludedAgents []string `json:"excluded_agents,omitempty"`

	// MaxCost 最大成本
	MaxCost *float64 `json:"max_cost,omitempty"`

	// MinAvailability 最低可用性
	MinAvailability *float64 `json:"min_availability,omitempty"`

	// MaxResponseTime 最大响应时间（毫秒）
	MaxResponseTime *int `json:"max_response_time,omitempty"`
}

type NegotiationRequest struct {
	// Requirements 能力需求列表
	Requirements []*CapabilityRequirement `json:"requirements"`

	// Preferences 偏好设置
	Preferences *NegotiationPreferences `json:"preferences,omitempty"`

	// Metadata 元数据
	Metadata map[string]any `json:"metadata,omitempty"`
}

type NegotiationResult struct {
	// Success 是否成功
	Success bool `json:"success"`

	// Assignments 能力分配
	Assignments []*CapabilityAssignment `json:"assignments"`

	// UnmetRequirements 未满足的需求
	UnmetRequirements []*CapabilityRequirement `json:"unmet_requirements,omitempty"`

	// Score 总分
	Score float64 `json:"score"`

	// Error 错误信息
	Error string `json:"error,omitempty"`
}

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

type NegotiatorOption func(*Negotiator)

type NetworkMessage struct {
	// ID 消息 ID
	ID string `json:"id"`

	// Type 消息类型
	Type MessageType `json:"type"`

	// From 发送者 Agent ID
	From string `json:"from"`

	// To 接收者 Agent ID（空表示广播）
	To string `json:"to,omitempty"`

	// Topic 消息主题
	Topic string `json:"topic,omitempty"`

	// Content 消息内容
	Content any `json:"content"`

	// Metadata 元数据
	Metadata map[string]any `json:"metadata,omitempty"`

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

	// ReplyTo 回复的消息 ID
	ReplyTo string `json:"reply_to,omitempty"`

	// TTL 消息生存时间
	TTL time.Duration `json:"ttl,omitempty"`

	// Priority 优先级（0-9，越大越高）
	Priority int `json:"priority,omitempty"`
}

type NetworkNode struct {
	// Agent 关联的 Agent
	Agent Agent

	// Neighbors 相邻节点 ID
	Neighbors []string

	// Inbox 收件箱
	Inbox chan *NetworkMessage

	// Status 节点状态
	Status NodeStatus

	// LastHeartbeat 最后心跳时间
	LastHeartbeat time.Time

	// Metadata 节点元数据
	Metadata map[string]any
	// contains filtered or unexported fields
}

type NetworkOption func(*AgentNetwork)

type NetworkStats struct {
	TotalNodes     int    `json:"total_nodes"`
	OnlineNodes    int    `json:"online_nodes"`
	OfflineNodes   int    `json:"offline_nodes"`
	BusyNodes      int    `json:"busy_nodes"`
	TotalEdges     int    `json:"total_edges"`
	Topology       string `json:"topology"`
	MessagesSent   int64  `json:"messages_sent"`
	MessagesRecv   int64  `json:"messages_recv"`
	MessagesFailed int64  `json:"messages_failed"`
}

type NetworkTopology int

type NodeStatus int

type Option func(*Config)

type Output struct {
	// Content 最终回复内容
	Content string `json:"content"`

	// ToolCalls 执行的工具调用记录
	ToolCalls []ToolCallRecord `json:"tool_calls,omitempty"`

	// Blocks 本次运行的有序内容块流（text↔tool 交错序），与 runtime.Result.Blocks 对齐。
	// SDK 消费者（如 hexeye）据此保真展示多步 ReAct，而非把 Content 压平。
	Blocks template.Blocks `json:"blocks,omitempty"`

	// Usage Token 使用统计
	Usage llm.Usage `json:"usage,omitempty"`

	// StopReason 运行终止原因（end_turn / max_turns），与运行时 Result.StopReason 对齐，
	// 让调用方据此决定如何呈现（如轮次耗尽时提示「可继续」），无需 errors.Is 反查。
	StopReason agentruntime.StopReason `json:"stop_reason,omitempty"`

	// Metadata 额外元数据
	Metadata map[string]any `json:"metadata,omitempty"`
}

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

type ParallelOption func(*ParallelAgent)

type ParameterSpec struct {
	// Name 参数名称
	Name string `json:"name"`

	// Type 参数类型
	Type string `json:"type"`

	// Required 是否必需
	Required bool `json:"required,omitempty"`

	// Description 参数描述
	Description string `json:"description,omitempty"`

	// Default 默认值
	Default any `json:"default,omitempty"`

	// Enum 枚举值
	Enum []any `json:"enum,omitempty"`

	// Min 最小值
	Min *float64 `json:"min,omitempty"`

	// Max 最大值
	Max *float64 `json:"max,omitempty"`
}

type PlanExecuteAgent struct {
	*BaseAgent
	// contains filtered or unexported fields
}

type PlanExecuteOption func(*PlanExecuteAgent)

type Poll struct {
	// ID 投票 ID
	ID string

	// Question 问题
	Question string

	// Options 选项（可选）
	Options []any

	// Voters 投票者列表
	Voters []string

	// Votes 收到的投票
	Votes []Vote

	// StartedAt 开始时间
	StartedAt time.Time

	// Closed 是否关闭
	Closed bool
	// contains filtered or unexported fields
}

type ProxyConfig struct {
	// WriteToShared 是否将写入同步到共享记忆（默认 true）
	WriteToShared bool

	// ReadFromShared 是否从共享记忆读取（默认 true）
	ReadFromShared bool

	// SharedSearchLimit 从共享记忆搜索的结果数量限制（默认 5）
	SharedSearchLimit int
}

type ProxyOption func(*ProxyConfig)

type RateLimiter interface {
	// Wait 等待获取令牌
	Wait(ctx context.Context) error
}

type ReActAgent struct {
	*BaseAgent
}

type ReasoningModule struct {
	// Name 模块名称
	Name string `json:"name"`

	// Description 模块描述
	Description string `json:"description"`

	// Template 推理模板（用于 ADAPT 阶段）
	Template string `json:"template"`

	// Examples 示例（可选）
	Examples []string `json:"examples,omitempty"`
}

type Reflection struct {
	// Quality 质量评分 (0.0 - 1.0)
	Quality float32 `json:"quality"`

	// Strengths 优点列表
	Strengths []string `json:"strengths,omitempty"`

	// Weaknesses 缺点列表
	Weaknesses []string `json:"weaknesses,omitempty"`

	// Suggestions 改进建议列表
	Suggestions []string `json:"suggestions,omitempty"`

	// ShouldRetry 是否需要重试
	ShouldRetry bool `json:"should_retry"`

	// Feedback 给下次执行的反馈（用于改进）
	Feedback string `json:"feedback,omitempty"`
}

type ReflectionAgent struct {
	*BaseAgent
	// contains filtered or unexported fields
}

type ReflectionOption func(*ReflectionAgent)

type Reflector interface {
	// Reflect 对输出进行反思
	// 返回反思结果，包括质量评分、优缺点和改进建议
	Reflect(ctx context.Context, input Input, output Output) (*Reflection, error)

	// ScoreQuality 仅评估输出质量分数
	// 返回 0.0-1.0 之间的分数
	ScoreQuality(ctx context.Context, input Input, output Output) (float32, error)
}

type RegisterOption func(*AgentInfo)

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

type RegistryConfig struct {
	// HealthCheckInterval 健康检查间隔
	HealthCheckInterval time.Duration

	// HeartbeatTimeout 心跳超时时间
	HeartbeatTimeout time.Duration

	// DeregisterAfter 超时后自动注销时间
	DeregisterAfter time.Duration

	// EnableHealthCheck 启用健康检查
	EnableHealthCheck bool
}

type ReplaySafety = agentruntime.ToolSideEffect

type ReplaySafetyAware interface {
	ReplaySafety() ReplaySafety
}

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

	// Title 角色头衔 (e.g., "Senior Researcher", "Lead Developer")
	Title string `yaml:"title" json:"title"`

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

	// Backstory 背景故事，帮助 LLM 更好地扮演角色
	Backstory string `yaml:"backstory" json:"backstory"`

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

	// Tools 可用工具名称列表
	Tools []string `yaml:"tools" json:"tools"`

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

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

	// AllowDelegation 是否允许委托任务给其他 Agent
	AllowDelegation bool `yaml:"allow_delegation" json:"allow_delegation"`

	// DelegateTo 可以委托给的 Agent 名称列表
	DelegateTo []string `yaml:"delegate_to" json:"delegate_to"`
}

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

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

type SLASpec struct {
	// Availability 可用性（百分比）
	Availability float64 `json:"availability,omitempty"`

	// ResponseTime 响应时间（毫秒）
	ResponseTime int `json:"response_time,omitempty"`

	// Throughput 吞吐量（请求/秒）
	Throughput int `json:"throughput,omitempty"`

	// ErrorRate 错误率（百分比）
	ErrorRate float64 `json:"error_rate,omitempty"`
}

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

type ScoreWeights struct {
	// VersionMatch 版本匹配权重
	VersionMatch float64

	// ConstraintMatch 约束匹配权重
	ConstraintMatch float64

	// CostWeight 成本权重
	CostWeight float64

	// SLAWeight SLA 权重
	SLAWeight float64
}

type SelfDiscoveryAgent struct {
	*BaseAgent
	// contains filtered or unexported fields
}

type SelfDiscoveryOption func(*SelfDiscoveryAgent)

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

type SessionState interface {
	// ID 获取会话 ID
	ID() string

	// Get 获取值
	Get(key string) (any, bool)

	// Set 设置值
	Set(key string, value any)

	// Delete 删除值
	Delete(key string)

	// All 获取所有键值对
	All() map[string]any

	// CreatedAt 获取创建时间
	CreatedAt() time.Time

	// UpdatedAt 获取最后更新时间
	UpdatedAt() time.Time

	// TurnCount 获取轮次计数
	TurnCount() int

	// IncrementTurnCount 增加轮次计数
	IncrementTurnCount()
}

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