responsesapi

type APIError struct {
	StatusCode int
	Code       string
	Message    string
	Param      string
	Type       string
}

type CacheKeyPlacement struct {
	Header                 string
	UsePromptCacheKeyField bool
}

type Config struct {
	Endpoint          string
	Headers           map[string][]string
	CacheKeyPlacement CacheKeyPlacement
	// Nil uses DefaultMaxAttempts.
	MaxAttempts *int
	// Trace borrows read-only bodies: request JSON and terminal response JSON or HTTP error.
	Trace func(Exchange)
	// Extensions are provider-specific top-level fields merged into every request
	// body, such as OpenRouter's automatic prompt caching and upstream routing.
	// A key that names a standard Responses API field is rejected per request.
	Extensions map[string]jsontext.Value
}

type Exchange struct {
	RequestBody  []byte
	StatusCode   int
	ResponseBody []byte
}