adapter

type Adapter interface {
	// Name returns the lookup key used by config (e.g. "deepseek").
	Name() string

	// MapModel converts an Anthropic-style model name (which may be e.g.
	// "claude-3-5-sonnet-20240620") into the upstream's expected name.
	// Adapters handle the empty-input case themselves — typically by
	// returning a "default" model.
	MapModel(anthropicModel string) string

	// Validate confirms the adapter has all configuration it needs to serve
	// requests. Called once at server startup; non-nil error blocks startup.
	// Replaces the prior substring-match preflight backchannel on the
	// request path.
	Validate() error

	// BuildRequest takes an already-translated OpenAI ChatCompletions body
	// and returns an http.Request bound to {BaseURL}/chat/completions with
	// auth headers set. Adapter must call req.WithContext(ctx).
	BuildRequest(ctx context.Context, body []byte) (*http.Request, error)

	// NormalizeResponse reads a buffered (non-streaming) upstream response and
	// returns a canonical body for the Translator's FromUpstream, erroring on
	// non-2xx (the server routes that to writeUpstreamError). Adapter is
	// responsible for unwrapping any provider-specific envelope. The streaming
	// path does NOT call this — it gates on HTTP status directly, since a
	// native-Anthropic passthrough cannot normalize a live SSE stream to bytes.
	//
	// The implementation MUST close resp.Body: the non-stream handler delegates
	// the close here and does not close it itself. Failing to close leaks a
	// connection per non-stream request.
	NormalizeResponse(resp *http.Response) ([]byte, error)

	// Translator returns the wire-format translator for this adapter's
	// transport dialect. OpenAI-dialect adapters return
	// translate.AnthropicOpenAI(); a native-Anthropic passthrough returns an
	// identity translator. The server handler calls it instead of hard-wiring
	// a dialect, keeping dialect knowledge inside the adapter.
	Translator() translate.Translator
}