agent

type AgentResponse struct {
	Type           string          `json:"type"`
	ToolCall       *ToolCall       `json:"tool_call,omitempty"`
	ToolCalls      []ToolCall      `json:"tool_calls,omitempty"`
	Plan           *Plan           `json:"plan,omitempty"`
	Final          *Final          `json:"final,omitempty"`
	FinalAnswer    *Final          `json:"final_answer,omitempty"`
	RawFinalAnswer json.RawMessage `json:"-"`
}

type Config struct {
	MaxSteps        int
	MaxTokenBudget  int
	ParseRetries    int
	ToolRepeatLimit int
}

type Context struct {
	Task           string
	Steps          []Step
	MaxSteps       int
	Plan           *Plan
	Metrics        *Metrics
	RawFinalAnswer json.RawMessage
}

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

type Final struct {
	Thought       string `json:"thought,omitempty"`
	Output        any    `json:"output,omitempty"`
	Plan          *Plan  `json:"plan,omitempty"`
	Reaction      string `json:"reaction,omitempty"`
	IsLightweight bool   `json:"is_lightweight,omitempty"`
}

type Hook func(ctx context.Context, step int, agentCtx *Context, messages *[]llm.Message) error

type Limits struct {
	MaxSteps        int
	ParseRetries    int
	MaxTokenBudget  int
	ToolRepeatLimit int
}

type LogOptions struct {
	IncludeThoughts      bool
	IncludeToolParams    bool
	IncludeSkillContents bool

	MaxThoughtChars      int
	MaxJSONBytes         int
	MaxStringValueChars  int
	MaxSkillContentChars int

	RedactKeys []string
}

type Metrics struct {
	LLMRounds    int
	TotalTokens  int
	TotalCost    float64
	StartTime    time.Time
	ElapsedMs    int64
	ToolCalls    int
	ParseRetries int
}

type Option func(*Engine)

type PendingOutput struct {
	Status            string `json:"status"`
	ApprovalRequestID string `json:"approval_request_id"`
	Message           string `json:"message"`
}

type Plan struct {
	Thought string    `json:"thought,omitempty"`
	Steps   PlanSteps `json:"steps,omitempty"`
}

type PlanStep struct {
	Step   string `json:"step"`
	Status string `json:"status,omitempty"` // pending|in_progress|completed
}

type PlanStepUpdate struct {
	CompletedIndex int
	CompletedStep  string
	StartedIndex   int
	StartedStep    string
	Reason         string
}

type PlanSteps []PlanStep

type PromptBlock struct {
	Content string
}

type PromptSkill struct {
	Name         string
	FilePath     string
	Description  string
	Requirements []string
}

type PromptSpec struct {
	Identity string
	Rules    []string
	Skills   []PromptSkill
	Blocks   []PromptBlock
}

type RunOptions struct {
	Model   string
	History []llm.Message
	Meta    map[string]any
	// SkipTaskMessage suppresses appending task as a trailing user message.
	// Useful when the current user input is already represented in structured History.
	SkipTaskMessage bool
}

type Step struct {
	StepNumber  int
	Thought     string
	Action      string
	ActionInput map[string]any
	Observation string
	Error       error
	Duration    time.Duration
}

type ToolCall struct {
	ID               string         `json:"tool_call_id,omitempty"`
	Type             string         `json:"tool_call_type,omitempty"`
	Thought          string         `json:"thought"`
	Name             string         `json:"tool_name"`
	Params           map[string]any `json:"tool_params"`
	RawArguments     string         `json:"raw_arguments,omitempty"`
	ThoughtSignature string         `json:"thought_signature,omitempty"`
}