server

type APIError struct {
	Code    string `json:"code"`
	Message string `json:"message"`
	Details string `json:"details,omitempty"`
}

type APIResponse struct {
	Success bool      `json:"success"`
	Data    any       `json:"data,omitempty"`
	Error   *APIError `json:"error,omitempty"`
}

type BatchEvalRequest struct {
	// TestCases 测试用例列表
	TestCases []BatchTestCaseRequest `json:"test_cases"`
	// Scorers 要使用的评分器列表
	Scorers []string `json:"scorers,omitempty"`
	// Concurrency 并发数（默认: 1）
	Concurrency int `json:"concurrency,omitempty"`
	// StopOnError 遇到错误时是否停止（默认: false）
	StopOnError bool `json:"stop_on_error,omitempty"`
	// Keywords 关键词列表（用于keyword_coverage scorer）
	Keywords []string `json:"keywords,omitempty"`
	// ProviderConfig 可选的LLM Provider配置（用于LLM-based scorers）
	ProviderConfig *types.ModelConfig `json:"provider_config,omitempty"`
}

type BatchEvalResponse struct {
	Results       []BatchResultResponse `json:"results"`
	Summary       *BatchSummaryResponse `json:"summary"`
	TotalDuration int64                 `json:"total_duration_ms"`
}

type BatchResultResponse struct {
	TestCaseID string              `json:"test_case_id"`
	Scores     []evals.ScoreResult `json:"scores"`
	Duration   int64               `json:"duration_ms"`
	Error      string              `json:"error,omitempty"`
	Metadata   map[string]any      `json:"metadata,omitempty"`
}

type BatchSummaryResponse struct {
	TotalCases      int                `json:"total_cases"`
	SuccessfulCases int                `json:"successful_cases"`
	FailedCases     int                `json:"failed_cases"`
	AverageScores   map[string]float64 `json:"average_scores"`
	AverageDuration int64              `json:"average_duration_ms"`
}

type BatchTestCaseRequest struct {
	ID        string         `json:"id"`
	Answer    string         `json:"answer"`
	Context   []string       `json:"context,omitempty"`
	Reference string         `json:"reference,omitempty"`
	Metadata  map[string]any `json:"metadata,omitempty"`
}

type ChatRequest struct {
	// TemplateID 指定要使用的 Agent 模板 ID。
	TemplateID string `json:"template_id"`
	// Input 用户输入的自然语言文本。
	Input string `json:"input"`

	// RoutingProfile 可选路由偏好,与 types.AgentConfig.RoutingProfile 对应。
	// 例如: "cost"、"quality"、"latency"。
	RoutingProfile string `json:"routing_profile,omitempty"`

	// ModelConfig 可选模型配置,未提供时使用模板默认配置。
	ModelConfig *types.ModelConfig `json:"model_config,omitempty"`
	// Sandbox 可选沙箱配置,未提供时使用默认本地沙箱。
	Sandbox *types.SandboxConfig `json:"sandbox,omitempty"`
	// Middlewares 可选中间件列表。
	Middlewares []string `json:"middlewares,omitempty"`
	// Metadata 可选元数据,会传递给 AgentConfig.Metadata。
	Metadata map[string]any `json:"metadata,omitempty"`

	// Skills 可选: 本次请求允许启用的 Skills 列表。
	// 对应 types.SkillsPackageConfig.EnabledSkills, 用于按请求粒度控制 Skill 集合,
	// 类似 Claude API 中 container.skills 的作用。
	Skills []string `json:"skills,omitempty"`

	// SkillsPackage 可选: 更细粒度控制 Skills 包的配置。
	// 如果提供, 则优先于 Skills 字段, 直接传递给 AgentConfig.SkillsPackage。
	SkillsPackage *types.SkillsPackageConfig `json:"skills_package,omitempty"`
}

type ChatResponse struct {
	AgentID string `json:"agent_id"`
	Text    string `json:"text"`
	Status  string `json:"status"`

	// ErrorMessage 非空表示请求失败时的错误信息。
	ErrorMessage string `json:"error_message,omitempty"`
}

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

type PaginatedResponse struct {
	Items      any `json:"items"`
	Total      int `json:"total"`
	Page       int `json:"page"`
	PageSize   int `json:"page_size"`
	TotalPages int `json:"total_pages"`
}

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

type SessionEvalRequest struct {
	// Events 会话事件列表, 使用 pkg/session.Event 结构。
	Events []session.Event `json:"events"`
	// Reference 可选参考答案, 用于词汇相似度评估。
	Reference string `json:"reference,omitempty"`
	// Keywords 关键词列表, 用于关键词覆盖率评估。
	Keywords []string `json:"keywords,omitempty"`
	// Scorers 指定要启用的 scorer 名称, 为空时默认启用:
	// ["keyword_coverage", "lexical_similarity"]。
	Scorers []string `json:"scorers,omitempty"`
}

type TextEvalRequest struct {
	// Answer 待评估的模型输出。
	Answer string `json:"answer"`
	// Context 可选的上下文信息, 当前实现不会直接使用, 预留扩展。
	Context []string `json:"context,omitempty"`
	// Reference 可选参考答案, 用于词汇相似度评估。
	Reference string `json:"reference,omitempty"`
	// Keywords 关键词列表, 用于关键词覆盖率评估。
	Keywords []string `json:"keywords,omitempty"`
	// Scorers 指定要启用的 scorer 名称, 为空时默认启用:
	// ["keyword_coverage", "lexical_similarity"]。
	Scorers []string `json:"scorers,omitempty"`
}

type TextEvalResponse struct {
	Scores       []evals.ScoreResult `json:"scores"`
	ErrorMessage string              `json:"error_message,omitempty"`
}

type WorkflowEvent struct {
	ID        string         `json:"id"`
	Timestamp time.Time      `json:"timestamp"`
	AgentID   string         `json:"agent_id"`
	Branch    string         `json:"branch,omitempty"`
	Author    string         `json:"author"`
	Text      string         `json:"text"`
	Metadata  map[string]any `json:"metadata,omitempty"`
}

type WorkflowRunEvalRequest struct {
	WorkflowRunRequest

	// Reference 可选参考答案, 用于词汇相似度评估。
	Reference string `json:"reference,omitempty"`
	// Keywords 可选关键词列表, 用于关键词覆盖率评估。
	Keywords []string `json:"keywords,omitempty"`
	// Scorers 指定要启用的 scorer 名称, 为空时默认启用:
	// ["keyword_coverage", "lexical_similarity"]。
	Scorers []string `json:"scorers,omitempty"`
}

type WorkflowRunEvalResponse struct {
	WorkflowRunResponse

	EvalScores []evals.ScoreResult `json:"eval_scores,omitempty"`
}

type WorkflowRunRecord struct {
	ID           string              `json:"id"`
	WorkflowID   string              `json:"workflow_id"`
	Input        string              `json:"input"`
	Events       []WorkflowEvent     `json:"events"`
	EvalScores   []evals.ScoreResult `json:"eval_scores,omitempty"`
	ErrorMessage string              `json:"error_message,omitempty"`
	CreatedAt    time.Time           `json:"created_at"`
}

type WorkflowRunRequest struct {
	// WorkflowID 工作流标识:
	// - "sequential_demo"
	// - "parallel_demo"
	// - "loop_demo"
	// - "nested_demo"
	WorkflowID string `json:"workflow_id"`

	// Input 传递给工作流的输入消息。
	Input string `json:"input"`
}

type WorkflowRunResponse struct {
	RunID        string          `json:"run_id,omitempty"`
	Events       []WorkflowEvent `json:"events"`
	ErrorMessage string          `json:"error_message,omitempty"`
}