react

type AgentState struct {
	Messages                 []*schema.Message `json:"messages"`
	ReasoningHistory         []Reasoning       `json:"reasoning_history"`
	Iteration                int               `json:"iteration"`
	MaxIterations            int               `json:"max_iterations"`
	Completed                bool              `json:"completed"`
	FinalAnswer              string            `json:"final_answer"`
	ReturnDirectlyToolCallID string            `json:"return_directly_tool_call_id"`
	// ForceFinalAnswer indicates the next reasoning step must produce a final answer
	// and disallow tool calls or continued thinking.
	ForceFinalAnswer bool `json:"force_final_answer"`
}

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

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

type MessageHandler interface {
	OnMessage(ctx context.Context, message *schema.Message) (context.Context, error)
	OnStreamMessage(ctx context.Context, message *schema.StreamReader[*schema.Message]) (context.Context, error)
}

type MessageModifier func([]*schema.Message) []*schema.Message

type ReactAgent struct {
	Runnable         compose.Runnable[[]*schema.Message, *schema.Message]
	Graph            *compose.Graph[[]*schema.Message, *schema.Message]
	GraphAddNodeOpts []compose.GraphAddNodeOpt
	AgentOptions     []base.AgentOption
	Config           ReactAgentConfig
}

type ReactAgentConfig struct {
	// Model for reasoning and tool calling
	ToolCallingModel model.ToolCallingChatModel

	// ReasoningPrompt is the prompt template for reasoning
	ReasoningPrompt string

	// IsSupportStructuredOutput is whether the model supports structured output
	IsSupportStructuredOutput bool

	// Tools available to the agent
	ToolsConfig compose.ToolsNodeConfig

	// Message modifier for preprocessing
	MessageModifier MessageModifier

	// Maximum number of reasoning iterations
	MaxStep int

	// Enable debug mode
	DebugMode bool

	// Custom graph options
	GraphOptions []compose.GraphAddNodeOpt

	// Tools that should return directly without further reasoning
	// Map of tool name to whether it should return directly
	ToolReturnDirectly map[string]bool
}

type Reasoning struct {
	Thought     string            `json:"thought"`
	Action      string            `json:"action"`
	ToolCalls   []schema.ToolCall `json:"tool_call,omitempty"`
	FinalAnswer string            `json:"final_answer,omitempty"`
	Confidence  float64           `json:"confidence"`
}

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

type ReasoningOutput struct {
	Thought     string  `json:"thought"`
	Action      string  `json:"action"`
	FinalAnswer string  `json:"final_answer"`
	Confidence  float64 `json:"confidence"`
}

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