planner

type Action struct {
	// Type 动作类型
	Type ActionType `json:"type"`

	// Name 动作名称 (工具名/Agent名等)
	Name string `json:"name"`

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

	// Description 动作描述
	Description string `json:"description,omitempty"`
}

type ActionDefinition struct {
	Name        string
	Description string
	Parameters  map[string]any
}

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

type ActionPlannerOption func(*ActionPlanner)

type ActionType string

type Executor interface {
	// Execute 执行计划
	Execute(ctx context.Context, plan *Plan) error

	// ExecuteStep 执行单个步骤
	ExecuteStep(ctx context.Context, step *Step) (*StepResult, error)

	// Pause 暂停执行
	Pause(ctx context.Context, plan *Plan) error

	// Resume 恢复执行
	Resume(ctx context.Context, plan *Plan) error

	// Cancel 取消执行
	Cancel(ctx context.Context, plan *Plan) error
}

type Plan struct {
	// ID 计划唯一标识
	ID string `json:"id"`

	// Goal 目标描述
	Goal string `json:"goal"`

	// Steps 执行步骤
	Steps []*Step `json:"steps"`

	// State 计划状态
	State PlanState `json:"state"`

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

	// CreatedAt 创建时间
	CreatedAt time.Time `json:"created_at"`

	// UpdatedAt 更新时间
	UpdatedAt time.Time `json:"updated_at"`
}

type PlanOption func(*planConfig)

type PlanState string

type Planner interface {
	// Name 返回规划器名称
	Name() string

	// Plan 创建执行计划
	Plan(ctx context.Context, goal string, opts ...PlanOption) (*Plan, error)

	// Replan 根据执行结果重新规划
	Replan(ctx context.Context, plan *Plan, feedback string) (*Plan, error)
}

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

type SequentialPlannerOption func(*SequentialPlanner)

type Step struct {
	// ID 步骤唯一标识
	ID string `json:"id"`

	// Index 步骤序号
	Index int `json:"index"`

	// Description 步骤描述
	Description string `json:"description"`

	// Action 执行动作
	Action *Action `json:"action"`

	// State 步骤状态
	State StepState `json:"state"`

	// Dependencies 依赖的步骤 ID
	Dependencies []string `json:"dependencies,omitempty"`

	// Result 执行结果
	Result *StepResult `json:"result,omitempty"`

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

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

	// Output 输出内容
	Output any `json:"output,omitempty"`

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

	// Duration 执行时长 (毫秒)
	Duration int64 `json:"duration_ms"`

	// Tokens 消耗的 Token 数
	Tokens int `json:"tokens,omitempty"`
}

type StepState string

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

type StepwisePlannerOption func(*StepwisePlanner)

type ToolInfo struct {
	Name        string         `json:"name"`
	Description string         `json:"description"`
	Parameters  map[string]any `json:"parameters,omitempty"`
}