ask

type AskUserQuestionHandler struct{}

type Config struct {
	// DefaultMode is the default mode for new sessions
	DefaultMode Mode `json:"default_mode"`

	// Timeout is the default timeout for requests
	Timeout time.Duration `json:"timeout"`

	// EnableWhitelist enables tool whitelisting
	EnableWhitelist bool `json:"enable_whitelist"`

	// Whitelist contains auto-approved tools
	Whitelist []string `json:"whitelist"`

	// Blacklist contains auto-denied tools
	Blacklist []string `json:"blacklist"`

	// RememberDecisions enables decision caching
	RememberDecisions bool `json:"remember_decisions"`

	// DecisionDuration is how long to cache decisions
	DecisionDuration time.Duration `json:"decision_duration"`
}

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

type DefaultToolHandler struct{}

type DenyAllPrompter struct{}

type Handler interface {
	// Ask sends a request to the user and waits for response
	Ask(ctx context.Context, req Request) (Result, error)

	// SetMode sets the mode for a session/scope
	SetMode(scopeID string, mode Mode) error

	// GetMode gets the current mode for a session/scope
	GetMode(scopeID string) (Mode, error)

	// SubmitResult submits a result for a pending request (for async handlers)
	SubmitResult(requestID string, result Result) error

	// GetPendingRequests returns all pending requests
	GetPendingRequests() []Request

	// SetPrompter sets the prompter for user interaction
	SetPrompter(p Prompter)
}

type Mode string

type NoOpPrompter struct{}

type Prompter interface {
	// Prompt sends a prompt to the user and returns the response
	Prompt(ctx context.Context, req Request) (Result, error)
}

type Request struct {
	// ID is the unique identifier for this request
	ID string `json:"id"`

	// Type is the type of user interaction
	Type     Type   `json:"type"`
	ChatID   string `json:"chat_id"`
	Platform string `json:"platform"`
	BotUUID  string `json:"bot_uuid"`

	// SessionID is the session this request belongs to
	SessionID string `json:"session_id,omitempty"`

	// AgentType is the source agent type
	AgentType agentboot.AgentType `json:"agent_type"`

	// ToolName is the tool name for permission requests
	ToolName string `json:"tool_name,omitempty"`

	// Input is the tool input data
	Input map[string]interface{} `json:"input,omitempty"`

	// Title is an optional title for the prompt
	Title string `json:"title,omitempty"`

	// Message is the main prompt message
	Message string `json:"message,omitempty"`

	// Reason explains why this request is being made
	Reason string `json:"reason,omitempty"`

	// Timeout is the maximum time to wait for a response
	Timeout time.Duration `json:"timeout,omitempty"`

	// Metadata contains additional context (e.g., chat_id, platform for IM)
	Metadata map[string]interface{} `json:"metadata,omitempty"`
}

type Response struct {
	// Type indicates the response type: "button", "text", "selection"
	Type string `json:"type"`

	// Data contains the raw response data
	Data string `json:"data"`

	// Selections contains structured selections for multi-select scenarios
	Selections map[string]interface{} `json:"selections,omitempty"`
}

type Result struct {
	// ID matches the request ID
	ID string `json:"id"`

	// Approved indicates if the request was approved (for permission/confirmation)
	Approved bool `json:"approved,omitempty"`

	// Response contains text input (for text_input type)
	Response string `json:"response,omitempty"`

	// Selection contains structured selections (for question type)
	// Key is typically the question index or ID, value is the selected option
	Selection map[string]interface{} `json:"selection,omitempty"`

	// Remember indicates this decision should be remembered
	Remember bool `json:"remember,omitempty"`

	// Reason explains the decision
	Reason string `json:"reason,omitempty"`

	// UpdatedInput contains modified tool input (for AskUserQuestion answers)
	UpdatedInput map[string]interface{} `json:"updated_input,omitempty"`
}

type StdinPrompter struct {
	// Debug enables verbose output
	Debug bool

	// Colors for terminal output (can be disabled by setting to empty strings)
	ColorReset  string
	ColorRed    string
	ColorGreen  string
	ColorYellow string
	ColorCyan   string
	// contains filtered or unexported fields
}

type ToolHandler interface {
	// CanHandle returns true if this handler can handle the given tool
	CanHandle(toolName string, input map[string]interface{}) bool

	// Description returns a human-readable description of this handler
	Description() string
}

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

type ToolPromptBuilder interface {
	ToolHandler

	// BuildPrompt creates the prompt message for this tool
	BuildPrompt(req Request) string
}

type ToolResponseParser interface {
	ToolHandler

	// ParseResponse parses user response into Result
	ParseResponse(req Request, response Response) (Result, error)
}

type Type string

type UserPrompter interface {
	PromptPermission(ctx context.Context, req agentboot.PermissionRequest) (agentboot.PermissionResult, error)
}