executionplan

type ExecutionOptions struct {
	// 并行执行
	AllowParallel    bool `json:"allow_parallel,omitempty"`     // 是否允许并行执行无依赖的步骤
	MaxParallelSteps int  `json:"max_parallel_steps,omitempty"` // 最大并行步骤数

	// 错误处理
	StopOnError     bool `json:"stop_on_error,omitempty"`     // 出错时是否停止
	ContinueOnError bool `json:"continue_on_error,omitempty"` // 出错时是否继续

	// 超时控制
	StepTimeoutMs  int64 `json:"step_timeout_ms,omitempty"`  // 单步超时（毫秒）
	TotalTimeoutMs int64 `json:"total_timeout_ms,omitempty"` // 总超时（毫秒）

	// 审批要求
	RequireApproval   bool  `json:"require_approval,omitempty"`    // 是否需要用户审批
	AutoApprove       bool  `json:"auto_approve,omitempty"`        // 是否自动审批
	ApprovalTimeoutMs int64 `json:"approval_timeout_ms,omitempty"` // 审批超时（毫秒）
}

type ExecutionPlan struct {
	// 基础信息
	ID          string `json:"id"`                // 计划唯一ID
	TaskID      string `json:"task_id,omitempty"` // 关联的任务ID
	Name        string `json:"name,omitempty"`    // 计划名称
	Description string `json:"description"`       // 计划描述（自然语言）

	// 步骤列表
	Steps []Step `json:"steps"`

	// 审批状态
	UserApproved  bool       `json:"user_approved"`            // 是否已用户审批
	ApprovedAt    *time.Time `json:"approved_at,omitempty"`    // 审批时间
	ApprovedBy    string     `json:"approved_by,omitempty"`    // 审批人
	RejectionNote string     `json:"rejection_note,omitempty"` // 拒绝原因

	// 执行状态
	Status          Status     `json:"status"`
	CurrentStep     int        `json:"current_step"` // 当前执行到的步骤索引
	CreatedAt       time.Time  `json:"created_at"`
	UpdatedAt       time.Time  `json:"updated_at"`
	StartedAt       *time.Time `json:"started_at,omitempty"`
	CompletedAt     *time.Time `json:"completed_at,omitempty"`
	TotalDurationMs int64      `json:"total_duration_ms,omitempty"`

	// 上下文信息
	AgentID  string         `json:"agent_id,omitempty"`  // 关联的 Agent ID
	OrgID    string         `json:"org_id,omitempty"`    // 组织 ID（多租户）
	TenantID string         `json:"tenant_id,omitempty"` // 租户 ID（多租户）
	Metadata map[string]any `json:"metadata,omitempty"`  // 自定义元数据

	// 执行选项
	Options *ExecutionOptions `json:"options,omitempty"`
}

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

type ExecutorOption func(*Executor)

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

type GeneratorOption func(*Generator)

type PlanRequest struct {
	// UserRequest 用户的原始请求
	UserRequest string

	// Context 附加上下文信息（可选）
	Context string

	// AvailableTools 可用工具列表（如果为空，使用注册表中所有工具）
	AvailableTools []string

	// Options 执行选项（可选）
	Options *ExecutionOptions

	// Metadata 自定义元数据
	Metadata map[string]any
}

type PlanSummary struct {
	ID          string  `json:"id"`
	Description string  `json:"description"`
	Status      Status  `json:"status"`
	TotalSteps  int     `json:"total_steps"`
	Completed   int     `json:"completed"`
	Failed      int     `json:"failed"`
	Pending     int     `json:"pending"`
	Running     int     `json:"running"`
	Progress    float64 `json:"progress"` // 完成百分比
}

type Status string

type Step struct {
	// 基础信息
	ID          string `json:"id"`          // 步骤唯一ID
	Index       int    `json:"index"`       // 步骤序号（从0开始）
	ToolName    string `json:"tool_name"`   // 要调用的工具名称
	Description string `json:"description"` // 步骤描述（自然语言）

	// 参数
	Input      string         `json:"input,omitempty"`      // 原始输入（LLM 生成的字符串）
	Parameters map[string]any `json:"parameters,omitempty"` // 解析后的参数

	// 执行状态
	Status      StepStatus `json:"status"`
	Result      any        `json:"result,omitempty"`       // 执行结果
	Error       string     `json:"error,omitempty"`        // 错误信息
	StartedAt   *time.Time `json:"started_at,omitempty"`   // 开始时间
	CompletedAt *time.Time `json:"completed_at,omitempty"` // 完成时间
	DurationMs  int64      `json:"duration_ms,omitempty"`  // 执行耗时（毫秒）

	// 依赖关系
	DependsOn []string `json:"depends_on,omitempty"` // 依赖的步骤ID列表

	// 重试信息
	RetryCount   int `json:"retry_count,omitempty"`    // 已重试次数
	MaxRetries   int `json:"max_retries,omitempty"`    // 最大重试次数
	RetryDelayMs int `json:"retry_delay_ms,omitempty"` // 重试间隔（毫秒）
}

type StepStatus string