Equal reports whether all section hashes match.

Error logs an error-level message. This is used for serious problems that need attention and may prevent normal operation.

Run starts the interactive TUI loop. It loads config and state, then presents the chooser, launches harnesses in a tabbed multiplexer, and loops back

Contains reports whether value is in the whitelist. Returns true if value is in the list.

Fatal logs a fatal-level message. This is used for critical situations that require immediate attention and will terminate the program.

SendError sends a BifrostError response

GetValue returns the resolved value.

SetValue sets a value in the internal userValues map. For scoped contexts, delegates to the root context via valueDelegate. This is thread-safe and ca

Info logs an info-level message. This is used for general informational messages about normal operation.

Unlock releases the lock if it's held by this holder. Returns an error if the lock is not held by this holder.

Warn logs a warning-level message. This is used for potentially harmful situations that don't prevent normal operation.

Lock acquires the lock, blocking until it's available or the context is cancelled. It will make up to (maxRetries + 1) attempts, sleeping retryInterva

Value implements driver.Valuer for database storage. It stores the secret reference (e.g., "env.API_KEY" or "vault.path/to/secret") if the type is env

Debug logs a debug-level message. This is used for detailed debugging information that is typically only needed during development or troubleshooting.

push appends the given rows to the ring, dropping the oldest entries when the cap is exceeded. Each row is appended by reference; vt10x's WithOnScroll

Add stores a new vector in the vector store.

String returns a human-readable representation of the duration.

Log appends a structured log entry for the current plugin scope. No-op if the context is not scoped to a plugin or has no log store.

* Delete a provider

Len returns the number of key-value pairs.

setupMCPManager creates an MCP manager for testing

MakeRequest makes an HTTP request to the Bifrost API

Set stores a value using the store's default TTL.

Write records downloaded bytes and periodically prints a progress line.

============================================================================= HELPER FUNCTIONS =======================================================

DB returns the current runtime database connection. The returned pointer is only valid for the duration of the caller's operation — after a RefreshCon

Len returns the number of currently non-expired keys.

SendJSON sends a JSON response with 200 OK status

Format provider and model into the standard "provider/model" format. Args: provider: Provider name model: Model name

Err returns the error explaining why the context was cancelled. For scoped contexts, delegates to the root context. Returns nil if the context has not

Migrate executes all migrations that did not run yet.

NewLocalGovernanceStore creates a new in-memory governance store The modelCatalog parameter is optional (can be nil) and enables cross-provider model

KV is a shorthand constructor for Pair.

sendError sends an error response with the appropriate status code and JSON body. It handles different error types (string, error interface, or arbitr

Done returns a channel that is closed when the context is cancelled.

SetMCPManager sets the MCP manager for this Bifrost instance. This allows injecting a custom MCP manager implementation. If the provided manager is a

MarshalSorted serializes the OrderedMap to JSON with keys sorted alphabetically. Use this when deterministic output is needed regardless of insertion

postChat sends a chat completion and parses the response.

Ptr creates a pointer to any value. This is a helper function for creating pointers to values.

setupBifrost creates a Bifrost instance for testing

GetSampleEchoToolCall returns a sample echo tool call

* Check if an element is visible

newBifrostError wraps a standard error into a BifrostError with IsBifrostError set to false. This helper function reduces code duplication when handli

Unmarshal decodes JSON data into v using the standard library.

ChatCompletionRequest sends a chat completion request to the specified provider.

assertMiss verifies the response is a cache miss with a non-empty cache_id stamped. cache_debug must be present (plugin ran), CacheHit must be false,

CreateChatResponseWithToolCalls creates a Chat response with tool calls

GetTestConfig loads configuration from environment variables

Delete removes a vector from the vector store.

LoadConfig loads initial configuration from a JSON config file into memory with full preprocessing including environment variable resolution and key c

initTestLogger initializes the global logger for SQLite integration tests

Empty reports whether no file-backed section hashes are present.

Agent Mode Operations CheckAndExecuteAgentForChatRequest handles agent mode for Chat Completions API. Tool executions inside the agent loop go through

============================================================================= INPROCESS TOOL REGISTRATION HELPERS ====================================

NewOrderedMapFromPairs creates an OrderedMap from key-value pairs, preserving the given order.

Client Management GetClients returns all MCP clients

MarshalSorted encodes v to JSON with map keys sorted alphabetically. Use this when deterministic output is needed (e.g., hashing, caching keys). Recur

Scan implements sql.Scanner for SkillJSONMap.

SetAttribute sets an attribute on the span. Attributes provide additional context about the operation.

Convenience function to get model name

WithValue returns a new context with the given value set.

createConfigFile creates a config.json file with the given data

AddChatResponse adds a Chat response function

ExtractIDFromResponse extracts the ID from a creation response

generateRandomID generates a random ID for test resources

GenerateConfigHash generates a SHA256 hash of the provider configuration. This is used to detect changes between config.json and database config. Keys

Cleanup is called on bifrost shutdown. It allows plugins to clean up any resources they have allocated. Returns any error that occurred during cleanup

IsFromSecret returns true if the value is sourced from an external secret (env var or vault).

AssertNoCacheHit verifies that a response was NOT served from cache

WaitForCache waits for async cache operations to complete. WaitForPendingOperations now drains the writersWg accurately (every PostLLMHook goroutine

--- private helpers (shared across pricing/*.go files) --- makeKey is the composite map key used by pricingData: model|provider|mode.

CreateChatResponseWithText creates a Chat response with text

Count returns the number of active sessions.

Value returns the value associated with the key. For scoped contexts, delegates to the root context via valueDelegate. Otherwise checks the internal u