task

type CreateTaskRequest struct {
	// Type is the task type
	// Type 是任务类型
	Type TaskType `json:"type" binding:"required"`

	// HostID is the target host ID
	// HostID 是目标主机 ID
	HostID uint `json:"host_id" binding:"required"`

	// Params contains task-specific parameters
	// Params 包含任务特定的参数
	Params map[string]interface{} `json:"params,omitempty"`

	// TimeoutSeconds is the task timeout in seconds
	// TimeoutSeconds 是任务超时时间（秒）
	TimeoutSeconds int `json:"timeout_seconds,omitempty"`
}

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

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

type ProgressCallback func(progress *TaskProgress)

type Task struct {
	// ID is the unique task identifier
	// ID 是唯一的任务标识符
	ID string `json:"id"`

	// Type is the task type
	// Type 是任务类型
	Type TaskType `json:"type"`

	// HostID is the target host ID
	// HostID 是目标主机 ID
	HostID uint `json:"host_id"`

	// AgentID is the target agent ID
	// AgentID 是目标 Agent ID
	AgentID string `json:"agent_id"`

	// Status is the current task status
	// Status 是当前任务状态
	Status TaskStatus `json:"status"`

	// Progress is the task progress (0-100)
	// Progress 是任务进度（0-100）
	Progress int `json:"progress"`

	// Message is the current status message
	// Message 是当前状态消息
	Message string `json:"message,omitempty"`

	// Error is the error message if failed
	// Error 是失败时的错误消息
	Error string `json:"error,omitempty"`

	// Params contains task-specific parameters
	// Params 包含任务特定的参数
	Params map[string]interface{} `json:"params,omitempty"`

	// Result contains task execution result
	// Result 包含任务执行结果
	Result map[string]interface{} `json:"result,omitempty"`

	// CreatedAt is when the task was created
	// CreatedAt 是任务创建时间
	CreatedAt time.Time `json:"created_at"`

	// StartedAt is when the task started executing
	// StartedAt 是任务开始执行时间
	StartedAt *time.Time `json:"started_at,omitempty"`

	// CompletedAt is when the task completed
	// CompletedAt 是任务完成时间
	CompletedAt *time.Time `json:"completed_at,omitempty"`

	// TimeoutSeconds is the task timeout in seconds (0 means no timeout)
	// TimeoutSeconds 是任务超时时间（秒），0 表示无超时
	TimeoutSeconds int `json:"timeout_seconds,omitempty"`

	// Retryable indicates if the task can be retried
	// Retryable 表示任务是否可重试
	Retryable bool `json:"retryable"`

	// RetryCount is the number of retry attempts
	// RetryCount 是重试次数
	RetryCount int `json:"retry_count"`

	// MaxRetries is the maximum number of retries
	// MaxRetries 是最大重试次数
	MaxRetries int `json:"max_retries"`

	// CreatedBy is the user who created the task
	// CreatedBy 是创建任务的用户
	CreatedBy string `json:"created_by,omitempty"`
}

type TaskListAPIResponse struct {
	ErrorMsg string            `json:"error_msg"`
	Data     *TaskListResponse `json:"data"`
}

type TaskListResponse struct {
	// Tasks is the list of tasks
	// Tasks 是任务列表
	Tasks []*Task `json:"tasks"`

	// Total is the total number of tasks
	// Total 是任务总数
	Total int `json:"total"`
}

type TaskProgress struct {
	// TaskID is the task identifier
	// TaskID 是任务标识符
	TaskID string `json:"task_id"`

	// Status is the current status
	// Status 是当前状态
	Status TaskStatus `json:"status"`

	// Progress is the overall progress (0-100)
	// Progress 是总体进度（0-100）
	Progress int `json:"progress"`

	// Message is the status message
	// Message 是状态消息
	Message string `json:"message,omitempty"`

	// CurrentStep is the current step name
	// CurrentStep 是当前步骤名称
	CurrentStep string `json:"current_step,omitempty"`

	// Steps contains all step statuses
	// Steps 包含所有步骤状态
	Steps []TaskStep `json:"steps,omitempty"`

	// Error is the error message if failed
	// Error 是失败时的错误消息
	Error string `json:"error,omitempty"`

	// Timestamp is when this progress was reported
	// Timestamp 是进度上报时间
	Timestamp time.Time `json:"timestamp"`
}

type TaskResponse struct {
	ErrorMsg string `json:"error_msg"`
	Data     *Task  `json:"data"`
}

type TaskStatus string

type TaskStep struct {
	// Name is the step name
	// Name 是步骤名称
	Name string `json:"name"`

	// Description is the step description
	// Description 是步骤描述
	Description string `json:"description"`

	// Status is the step status
	// Status 是步骤状态
	Status TaskStatus `json:"status"`

	// Progress is the step progress (0-100)
	// Progress 是步骤进度（0-100）
	Progress int `json:"progress"`

	// Message is the current status message
	// Message 是当前状态消息
	Message string `json:"message,omitempty"`

	// Error is the error message if failed
	// Error 是失败时的错误消息
	Error string `json:"error,omitempty"`

	// StartedAt is when the step started
	// StartedAt 是步骤开始时间
	StartedAt *time.Time `json:"started_at,omitempty"`

	// CompletedAt is when the step completed
	// CompletedAt 是步骤完成时间
	CompletedAt *time.Time `json:"completed_at,omitempty"`
}

type TaskType string