openai

type CodexAccountResolver func(ctx context.Context) (accountID string, ok bool, err error)

type CodexOptions struct {
	Options
	// Originator is the value of the `originator` header. Empty defaults to
	// "codex_cli_rs" (the same value the openai/codex CLI ships). The Codex
	// backend reads this to attribute traffic; changing it is supported but
	// unusual.
	Originator string
	// UserAgent overrides the openai Options.UserAgent when non-empty. The
	// Codex backend logs the User-Agent for diagnostics, so a "codex_cli_rs"
	// / "zero" branded value is recommended.
	UserAgent string
	// AccountID is a static `chatgpt-account-id` that bypasses the resolver.
	// Leave empty in production wiring so the AccountResolver is consulted on
	// every request — that path reads the live OAuth token from the store and
	// survives a refresh that rotates the bearer (and its account claim).
	// The field exists for tests that want a pinned value without standing up
	// a resolver.
	AccountID string
	// AccountResolver, when set, returns the account id dynamically per
	// request (including the 401-refresh retry). The factory wires this so a
	// refresh that updates the stored token's Account field takes effect on
	// the next outgoing request without restarting the agent.
	//
	// ok=false means "no account id known" — the Codex provider simply omits
	// the header in that case (the request will 401, but that's recoverable:
	// the user re-auths and the next login persists a fresh id).
	AccountResolver CodexAccountResolver
	// RequestTimeout caps each outbound Codex request. 0 => 60s. The Codex
	// backend is hosted behind Cloudflare, so a few seconds is plenty for a
	// healthy connection; the cap is a safety net for the rare case the
	// request hangs past the streaming idle watchdog.
	RequestTimeout time.Duration
}

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

type Options struct {
	APIKey  string
	BaseURL string
	// Endpoint, when non-empty, overrides the default `{BaseURL}/chat/completions`
	// request URL. Used by flavors (notably the Codex provider) that speak a
	// different path on the same host — e.g. `/responses` on the ChatGPT Codex
	// backend. When empty, the openai provider falls back to its default
	// chat-completions path so every existing caller is unchanged.
	Endpoint        string
	Model           string
	AuthHeader      string
	AuthScheme      string
	AuthHeaderValue string
	CustomHeaders   map[string]string
	HTTPClient      *http.Client
	UserAgent       string
	// OAuthResolver, when set, supplies an OAuth bearer credential per request and
	// is preferred over APIKey; a nil resolver (or one that yields ok=false) uses
	// the API key. See providerio.SendWithAuthRetry.
	OAuthResolver providerio.TokenResolver
	// MaxTokens caps the model's output tokens. Zero omits the cap (the model's
	// own default applies). Resolved from the model registry by the factory.
	MaxTokens int
	// StreamIdleTimeout aborts the stream if no data arrives for this long.
	// When unset, Zero uses providerio.ResolveStreamIdleTimeout — the
	// ZERO_STREAM_IDLE_TIMEOUT override or providerio.DefaultStreamIdleTimeout.
	StreamIdleTimeout time.Duration
	// ParseThinkTags converts streamed <think>...</think> content into reasoning
	// events for OpenAI-compatible models known to emit that legacy format.
	ParseThinkTags bool
	// SetRequestExtra, when non-nil, is invoked on every outgoing request after
	// the provider's built-in headers (Content-Type, User-Agent) are set, so a
	// wrapper (notably the Codex provider) can inject request-specific headers
	// — e.g. an account id resolved from the OAuth token, or a hard-coded
	// "originator" value. It is also called on the 401-refresh retry, so any
	// per-request state must be re-derivable from the live request.
	SetRequestExtra func(*http.Request)
	// DisablePromptCacheKey omits OpenAI's prompt_cache_key even when the
	// caller supplies a session identity. Used for openai-compatible gateways
	// (NVIDIA NIM, strict local proxies, …) that validate and reject unknown
	// request fields instead of ignoring them. Official OpenAI keeps the field
	// enabled; the ZERO_DISABLE_PROMPT_CACHE_KEY env kill switch still applies
	// on top for any endpoint.
	DisablePromptCacheKey bool
}

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