Interface Prompter

internal/oauth/prompter.go:38–59

Prompter presents authorization prompts to the user out of band from the LLM context — for example via MCP elicitation. Keeping prompts out of the model's context prevents the authorization URL (and any session-bound state) from leaking into tool arguments or transcripts. A nil Prompter is valid an

// its last-resort channel. Implementations wrap a transport-specific client
// (e.g. an MCP session); see the ghmcp adapter.
type Prompter interface {
	// CanPromptURL reports whether the client can display a URL securely via
	// URL-mode elicitation.
	CanPromptURL() bool

	// PromptURL securely presents an authorization URL to the user and blocks
	// until the user acknowledges, declines, or ctx is done. Returning nil means
	// the prompt was shown (not that authorization completed); the caller waits
	// for the OAuth flow itself to finish. It returns ErrPromptDeclined if the
	// user declines or cancels, or ErrPromptUnavailable if the prompt could not
	// be delivered.
	PromptURL(ctx context.Context, p Prompt) error

	// CanPromptForm reports whether the client supports form elicitation, used
	// to display a device code when URL elicitation is unavailable.
	CanPromptForm() bool

	// PromptForm presents a textual acknowledgement prompt and blocks until the
	// user responds. It returns ErrPromptDeclined if the user declines, or
	// ErrPromptUnavailable if the prompt could not be delivered.
	PromptForm(ctx context.Context, p Prompt) error
}

// canPromptURL reports URL support, tolerating a nil Prompter.
func canPromptURL(p Prompter) bool { return p != nil && p.CanPromptURL() }