embeddings

type APIError struct {
	// Status is the HTTP status code, or 0 for a transport-level failure
	// (connection refused, timeout) where no response was received.
	Status int
	// Code is the provider's machine error code when present (e.g.
	// "context_length_exceeded"); empty when the provider omits it.
	Code string
	// Message is the provider's human-readable error message, or the
	// transport error string when Status is 0.
	Message string
	// RequestedTokens is the token count the provider reported for the
	// rejected input, parsed from Message; 0 when not reported.
	RequestedTokens int
	// Transient marks a transport-level failure (Status 0) as retryable.
	Transient bool
}

type Embedder interface {
	// Embed converts text into a vector embedding.
	Embed(ctx context.Context, text string) ([]float32, error)

	// Close releases any resources held by the embedder.
	Close() error
}