util

func ApplyCustomHeadersFromAttrs ¶ added in v6.3.23

func ApplyCustomHeadersFromAttrs(r *http.Request, attrs map[string]string)

ApplyCustomHeadersFromAttrs applies user-defined headers stored in the provided attributes map. Custom headers override built-in defaults when conflicts occur.

func CleanJSONSchemaForAntigravity ¶ added in v6.6.40

func CleanJSONSchemaForAntigravity(jsonStr string) string

CleanJSONSchemaForAntigravity transforms a JSON schema to be compatible with Antigravity API. It handles unsupported keywords, type flattening, and schema simplification while preserving semantic information as description hints.

func CountAuthFiles ¶

func CountAuthFiles[T any](ctx context.Context, store interface {
	List(context.Context) ([]T, error)
}) int

CountAuthFiles returns the number of auth records available through the provided Store. For filesystem-backed stores, this reflects the number of JSON auth files under the configured directory.

func CreateWhiteImageBase64 ¶ added in v6.1.13

func CreateWhiteImageBase64(aspectRatio string) (string, error)

func DeleteKey ¶ added in v6.5.42

func DeleteKey(jsonStr, keyName string) string

func FixJSON ¶

func FixJSON(input string) string

FixJSON converts non-standard JSON that uses single quotes for strings into RFC 8259-compliant JSON by converting those single-quoted strings to double-quoted strings with proper escaping.

Examples:

{'a': 1, 'b': '2'}      => {"a": 1, "b": "2"}
{"t": 'He said "hi"'} => {"t": "He said \"hi\""}

Rules:

• Existing double-quoted JSON strings are preserved as-is.
• Single-quoted strings are converted to double-quoted strings.
• Inside converted strings, any double quote is escaped (\").
• Common backslash escapes (\n, \r, \t, \b, \f, \\) are preserved.
• \' inside single-quoted strings becomes a literal ' in the output (no escaping needed inside double quotes).
• Unicode escapes (\uXXXX) inside single-quoted strings are forwarded.
• The function does not attempt to fix other non-JSON features beyond quotes.

func GetIPAddress ¶

func GetIPAddress() string

GetIPAddress attempts to find the best-available IP address. It first tries to get the public IP address, and if that fails, it falls back to getting the local outbound IP address.

Returns:

• string: The determined IP address (preferring public IPv4)

func GetOpenAICompatibilityConfig ¶

func GetOpenAICompatibilityConfig(alias string, cfg *config.Config) (*config.OpenAICompatibility, *config.OpenAICompatibilityModel)

GetOpenAICompatibilityConfig returns the OpenAI compatibility configuration and model details for the given alias.

Parameters:

• alias: The model alias to find configuration for
• cfg: The application configuration containing OpenAI compatibility settings

Returns:

• *config.OpenAICompatibility: The matching compatibility configuration, or nil if not found
• *config.OpenAICompatibilityModel: The matching model configuration, or nil if not found

func GetProviderName ¶

func GetProviderName(modelName string) []string

GetProviderName determines all AI service providers capable of serving a registered model. It first queries the global model registry to retrieve the providers backing the supplied model name. When the model has not been registered yet, it falls back to legacy string heuristics to infer potential providers.

Supported providers include (but are not limited to):

• "gemini" for Google's Gemini family
• "codex" for OpenAI GPT-compatible providers
• "claude" for Anthropic models
• "qwen" for Alibaba's Qwen models
• "openai-compatibility" for external OpenAI-compatible providers

Parameters:

• modelName: The name of the model to identify providers for.
• cfg: The application configuration containing OpenAI compatibility settings.

Returns:

• []string: All provider identifiers capable of serving the model, ordered by preference.

func HideAPIKey ¶

func HideAPIKey(apiKey string) string

HideAPIKey obscures an API key for logging purposes, showing only the first and last few characters.

Parameters:

• apiKey: The API key to hide.

Returns:

• string: The obscured API key.

func InArray ¶

func InArray(hystack []string, needle string) bool

InArray checks if a string exists in a slice of strings. It iterates through the slice and returns true if the target string is found, otherwise it returns false.

Parameters:

• hystack: The slice of strings to search in
• needle: The string to search for

Returns:

• bool: True if the string is found, false otherwise

func IsClaudeThinkingModel ¶ added in v6.6.40

func IsClaudeThinkingModel(model string) bool

IsClaudeThinkingModel checks if the model is a Claude thinking model that requires the interleaved-thinking beta header.

func IsOpenAICompatibilityAlias ¶

func IsOpenAICompatibilityAlias(modelName string, cfg *config.Config) bool

IsOpenAICompatibilityAlias checks if the given model name is an alias configured for OpenAI compatibility routing.

Parameters:

• modelName: The model name to check
• cfg: The application configuration containing OpenAI compatibility settings

Returns:

• bool: True if the model name is an OpenAI compatibility alias, false otherwise

func MaskAuthorizationHeader ¶ added in v6.2.22

func MaskAuthorizationHeader(value string) string

maskAuthorizationHeader masks the Authorization header value while preserving the auth type prefix. Common formats: "Bearer <token>", "Basic <credentials>", "ApiKey <key>", etc. It preserves the prefix (e.g., "Bearer ") and only masks the token/credential part.

Parameters:

• value: The Authorization header value

Returns:

• string: The masked Authorization value with prefix preserved

func MaskSensitiveHeaderValue ¶ added in v6.2.22

func MaskSensitiveHeaderValue(key, value string) string

MaskSensitiveHeaderValue masks sensitive header values while preserving expected formats.

Behavior by header key (case-insensitive):

• "Authorization": Preserve the auth type prefix (e.g., "Bearer ") and mask only the credential part.
• Headers containing "api-key": Mask the entire value using HideAPIKey.
• Others: Return the original value unchanged.

Parameters:

• key: The HTTP header name to inspect (case-insensitive matching).
• value: The header value to mask when sensitive.

Returns:

• string: The masked value according to the header type; unchanged if not sensitive.

func MaskSensitiveQuery ¶ added in v6.2.33

func MaskSensitiveQuery(raw string) string

MaskSensitiveQuery masks sensitive query parameters, e.g. auth_token, within the raw query string.

func PrintSSHTunnelInstructions ¶

func PrintSSHTunnelInstructions(port int)

PrintSSHTunnelInstructions detects the IP address and prints SSH tunnel instructions for the user to connect to the local OAuth callback server from a remote machine.

Parameters:

• port: The local port number for the SSH tunnel

func RenameKey ¶

func RenameKey(jsonStr, oldKeyPath, newKeyPath string) (string, error)

RenameKey renames a key in a JSON string by moving its value to a new key path and then deleting the old key path.

Parameters:

• jsonStr: The JSON string to modify
• oldKeyPath: The dot-notation path to the key that should be renamed
• newKeyPath: The dot-notation path where the value should be moved to

Returns:

• string: The modified JSON string with the key renamed
• error: An error if the operation fails

The function performs the rename in two steps: 1. Sets the value at the new key path 2. Deletes the old key path

func ResolveAuthDir ¶ added in v6.0.10

func ResolveAuthDir(authDir string) (string, error)

ResolveAuthDir normalizes the auth directory path for consistent reuse throughout the app. It expands a leading tilde (~) to the user's home directory and returns a cleaned path.

func ResolveAutoModel ¶ added in v6.3.35

func ResolveAutoModel(modelName string) string

ResolveAutoModel resolves the "auto" model name to an actual available model. It uses an empty handler type to get any available model from the registry.

Parameters:

• modelName: The model name to check (should be "auto")

Returns:

• string: The resolved model name, or the original if not "auto" or resolution fails

func SanitizeFunctionName ¶ added in v6.6.76

func SanitizeFunctionName(name string) string

SanitizeFunctionName ensures a function name matches the requirements for Gemini/Vertex AI. It replaces invalid characters with underscores, ensures it starts with a letter or underscore, and truncates it to 64 characters if necessary. Regex Rule: [^a-zA-Z0-9_.:-] replaced with _.

func SetLogLevel ¶

func SetLogLevel(cfg *config.Config)

SetLogLevel configures the logrus log level based on the configuration. It sets the log level to DebugLevel if debug mode is enabled, otherwise to InfoLevel.

func SetProxy ¶

func SetProxy(cfg *config.SDKConfig, httpClient *http.Client) *http.Client

SetProxy configures the provided HTTP client with proxy settings from the configuration. It supports SOCKS5, HTTP, and HTTPS proxies. The function modifies the client's transport to route requests through the configured proxy server.

func Walk ¶

func Walk(value gjson.Result, path, field string, paths *[]string)

Walk recursively traverses a JSON structure to find all occurrences of a specific field. It builds paths to each occurrence and adds them to the provided paths slice.

Parameters:

• value: The gjson.Result object to traverse
• path: The current path in the JSON structure (empty string for root)
• field: The field name to search for
• paths: Pointer to a slice where found paths will be stored

The function works recursively, building dot-notation paths to each occurrence of the specified field throughout the JSON structure.

func WritablePath ¶ added in v6.2.23

func WritablePath() string

WritablePath returns the cleaned WRITABLE_PATH environment variable when it is set. It accepts both uppercase and lowercase variants for compatibility with existing conventions.