approval

type Approvable interface {
	SetApprover(approver Approver)
}

type Approver interface {
	Approve(ctx context.Context, req Request) (Decision, error)
}

type ApproverOption func(*PermissionApprover)

type Asker interface {
	// Available reports whether the user can be asked at all (a terminal is attached).
	Available() bool
	// Ask shows each question in turn. Pressing ctrl+c returns errUtils.ErrUserAborted.
	Ask(ctx context.Context, questions []Question) (map[string]string, error)
}

type Decision struct {
	// Allow is true when the tool may run.
	Allow bool
	// UpdatedInput replaces the tool input when Allow is true and it is not nil.
	// Questions to the user use it to return the answers.
	UpdatedInput map[string]any
	// Message is returned to the model when the tool is denied.
	Message string
	// Interrupt asks the provider to stop the whole run (user pressed Ctrl-C).
	Interrupt bool
	// NonInteractive is true when approval was required but no terminal was
	// available to ask. The provider reports this as an error with a hint
	// instead of surfacing the model's prose.
	NonInteractive bool
}

type Event struct {
	Kind EventKind
	// Tool is the provider's tool name (for example "Bash").
	Tool string
	// Summary is a short human-readable description (for example "atmos list stacks").
	Summary string
}

type EventKind int

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

type ProgressReporter interface {
	SetProgressHandler(handler func(Event))
}

type Question struct {
	// Question is the full text of the question.
	Question string `json:"question"`
	// Header is a short label for the question, such as "Beverage".
	Header string `json:"header"`
	// Options are the choices offered.
	Options []QuestionOption `json:"options"`
	// MultiSelect allows choosing more than one option.
	MultiSelect bool `json:"multiSelect"`
}

type QuestionOption struct {
	Label       string `json:"label"`
	Description string `json:"description"`
}

type Request struct {
	// ToolName is the provider's name for the tool (for example "Bash").
	ToolName string
	// ToolUseID identifies the tool call within the provider's session.
	ToolUseID string
	// Input holds the tool parameters (for Bash: "command" and "description").
	Input map[string]any
}

type TimeoutManaged interface {
	SetTimeout(timeout time.Duration)
}