- NPX
- Docker
2.2.0
✨ Features
- Claude Desktop and Cowork Marketplace - Skills stored in Bifrost can now be registered as a marketplace in Claude Desktop and Cowork, which reject the direct JSON URL and require a cloneable Git repository URL. A new
/api/skills/serve/claude-code.gitendpoint implements the two Git smart-HTTP requests used during a clone and serves a repository containing.claude-plugin/marketplace.json; the existing Claude Code flow is unchanged (#7152) - Time-of-Day Peak and Off-Peak Pricing - Model pricing accepts
off_peak_cost_multiplierand apeak_hoursweekly schedule, so providers like DeepSeek that bill the same model at two rates are costed correctly. Base rates are treated as peak; the multiplier scales usage-based charges outside the declared windows. Flat per-request fees, per-search-query fees and guardrail/MCPAdditionalCostare never discounted. Windows use IANA timezones, weekday numbers and half-openHH:MMintervals that may wrap past midnight, and both fields are editable from the custom pricing override sheet (#6574, #6575, #6576, #6577, #6578, #6579, #7054) - GA Realtime Transcription - OpenAI and Azure GA transcription sessions are served over both WebSocket and WebRTC with normal Bifrost authentication, routing, governance, guardrails, logging and transcription-aware pricing. These sessions carry only
intent=transcriptionon the connection and deliver the routing model later insession.update(or in the initial multipart/v1/realtime/callsrequest for WebRTC), so Bifrost now routes on the nested transcription model while preserving realtime connection and turn semantics (#7089) - Regex Model Allow and Block Lists -
allowed_models/blacklisted_modelson virtual keys andmodels/blacklisted_modelson provider keys acceptregex:<pattern>entries next to exact names. Patterns are compiled once as case-insensitive full matches, a pattern that is empty,*or does not compile is refused with 400, and list-models never surfaces a pattern as a model. Provider-key create and update now validatemodelsthe same way asblacklisted_models. This supersedes the separate*_patternsfields, which were added and then withdrawn before release (#6987, #6988, #6989, #6990, #7031, #7133, #7134) - Governance Entity Names on MCP Tool Logs -
mcp_tool_logsgains the same attribution shape thelogstable has:user_name,team_name,customer_nameandbusiness_unit_namebecome real columns instead of transients, the multi-valuedteam_ids/team_names,customer_ids/customer_namesandbusiness_unit_ids/business_unit_namessets are stored as index-aligned JSON arrays, andbudget_idsandrate_limit_idsare recorded. Names are written from the request context at ingestion, with nothing resolved on read, so the dashboard stops rendering raw UUIDs (#7154) - Endpoint-Attributed MCP Inspections - Inspected MCP tool calls are logged with bounded identity sourced from the gateway rather than payload-supplied headers. A new
MCPObservationcarries device, app key, server label, tool name and decision onto both the pending and final log entry, and the MCP logs view falls back toapp_keywhenappis absent so endpoint-attributed rows show the right app icon and name (#6959) - Virtual MCP References by Name - Access profiles and governance projects reference Virtual MCPs through
virtual_mcp_name, making config files portable across environments; names resolve on startup and a name matching nothing is refused.mcp_configs({ mcp_client_id, tools_to_execute }) replaces themcp_servers/mcp_tool_overridesinclude-exclude model with a single allowlist, where["*"]grants all tools including future ones and[]grants none.virtual_mcp_idand the old keys are deprecated, still accepted, and folded into the new shape at load time (#7181) - Normalized
error_typeMetric Label -bifrost_error_requests_totalgains anerror_typelabel with a closed, prefix-structured vocabulary (caller_*,policy_*,provider_*,bifrost_*,_OTHER) so a 429 from a governance rate limit is distinguishable from a 429 from an upstream, and a 503 Bifrost shed under queue pressure from an upstream overload. Classification resolves a declaredExtraFields.ErrorTypefirst, then Bifrost’s own markers, then the status code; it deliberately ignores providererror.typestrings, which disagree across providers for the same condition (#7141) - Bedrock OpenAI-Compatible Endpoint Routing - A
use_openai_endpointsflag on Bedrock keys and aliases routes chat completions and responses through Bedrock’s/openai/v1surface instead of Converse, for models that support it. It is opt-in by design: Converse carries Bedrock Guardrails,performanceConfigandrequestMetadatathat the OpenAI-compatible surface silently ignores, so diverting automatically could stop a guardrail from being enforced with no visible error. The alias value wins over the key, matchinguse_anthropic_endpointsprecedence (#7071, #7073) - Anthropic Tool Search on Bedrock Claude - Anthropic tool search (
tool_search_tool_*,defer_loading) is served onbedrock/Claude models by routing those requests to InvokeModel / InvokeModelWithResponseStream, the only Bedrock API AWS allows it on; CountTokens counts such requests with the same InvokeModel body. Server-side tool search also survives the Bedrock-native invoke ingress end to end: the tool is carried as an ingress-only marker so the egress predicate can see it, results are returned as aserver_tool_useplustool_search_tool_resultpair rather than a clienttool_use(which the API rejects when echoed back), the streaming path emits the same pair, replayed blocks round-trip unchanged, and the Anthropic-native response path carries them too (#6900, #6908, #7162, #7163, #7164, #7165, #7166) - Namespace Tool Support Across Providers - Responses
namespacetools are flattened in core for every provider whose wire lacks the type, with nested functions renamed to<namespace>__<function>so two namespaces sharing a function name no longer collide into an upstreamTool names must be unique400. Returnedfunction_callitems map back to the bare name plus namespace, prior-turn calls andtool_choicenames are re-aliased, and a still-duplicate name is rejected with a clear 400 before reaching the provider. Flattened names honour each wire’s documented tool-name limit, overridable per model throughtool_name_max_length. The names a provider reserves for its own server tools come from the datasheet rowreserved_tool_namespaces, and Codex’s literalfunctionsnamespace is unwrapped to top-level tools for every provider (#7039, #7082, #7084, #7161) - Trusted Networks for the SSRF Guard - A
trusted_networkslist of IP/CIDR entries the SSRF guard consults before outbound discovery calls, so a self-hosted IdP on an internal network can be reached by the generic provider’s discover-endpoints and discover-claims flows. Declaring the key inconfig.jsonmakes it own the whole list, an explicit empty array clears dashboard-added entries, and omitting it leaves the stored allowlist untouched. Hostnames are refused, since DNS would then decide which requests bypass SSRF protection (#7081) - Prompt Cache Reload Through the Server -
ReloadPromptCachemoves ontoServerCallbacksso enterprise can gossip it across nodes. The prompts plugin’s in-memory index was previously rebuilt only in the process that served the write, so on a multi-node deployment a prompt published on node A left node B resolvingx-bf-prompt-id/x-bf-prompt-versionagainst a stale index until restart: an unknown version errored andlatestserved the old content. OSS behaviour is unchanged (#7061) - Guardrail Tool-Call Argument Redaction - Guardrail redaction covers LLM tool-call arguments (Chat function arguments, Responses function arguments and custom-tool input) across the Anthropic streaming and non-streaming paths, reading and writing
delta.partial_jsononinput_json_deltaevents and collecting string-valued paths inside atool_useblock’sinputwithout touching tool names, IDs or definitions. A separate identity-based transformer path lets provider-managed rewrites (Model Armor, Bedrock) land in the correct native JSON field even when the same text appears in several fields, verifyingOriginalbefore patching and the written value after (#6977, #7049) - Regions and Service URLs in Plaintext - Regions and service URLs (Azure endpoint, Vertex/Bedrock/Bedrock Mantle region, vLLM/Ollama/SGL/Databricks URL, MCP connection string) are public identifiers, not credentials, and were being unconditionally redacted into unreadable values in the UI. A new
SecretVar.RedactedIfSecret()returns a plain clone for a literal value and still masks anything sourced from an env var or vault reference (#7085) wait_for_usagefor Custom Providers - Await_for_usageflag oncustom_provider_configtells Bifrost the upstream sends a trailing usage-only frame, so the read loop holds open pastfinish_reasonuntil it arrives instead of synthesizing a zero-usage terminal chunk. Termination stays bounded by the usage chunk, two consecutive post-finish heartbeat comments, EOF, orstream_idle_timeout_in_seconds(#7187)- Pinnable Log Search Mode - The logs search box gains a mode dropdown (Auto, Content, Request ID). Auto-detection treated UUID-shaped input as an ID lookup and everything else as a content scan, which breaks for request IDs that are not UUID-shaped and for UUID-shaped strings that should be searched as content. A pinned mode bypasses all sniffing and re-runs the current input immediately (#7149)
- MCP Usage Guide Auth Methods - The MCP usage guide generates client configs for Virtual key, OAuth and Identity provider authentication instead of requiring a virtual key for every config. Credential resolution is centralized in
buildMCPHeaders(), so OAuth emits no headers, identity provider emits aBearerplaceholder, and virtual key keepsx-bf-vk(#7111) - Chart Color System - Dashboard charts, status badges and components read a structured set of CSS custom properties instead of hard-coded hex values, so colors adapt correctly between light and dark themes. Tokens are grouped as semantic (hues 0 to 70 reserved so no category can look like an error), sequential, ordinal for percentile series, and categorical at matched chroma assigned by rank (#7113)
🐞 Fixed
- Client Disconnect Not Cancelling Requests - A client that closes its socket while Bifrost is still waiting on core (silent upstream header wait, retry backoff) now cancels the request.
ConvertToBifrostContextstarts a socket watcher that peeks the client connection every 500 ms withMSG_PEEKand cancels the context on FIN or RST, so upstream retries stop as soon as nobody is listening; previously fasthttp offered no per-requestDoneand a disconnect was only noticed when an SSE write failed. No-op on non-unix platforms and on in-memory test connections (#7035, #7106) - Silent Upstream Never Timed Out -
default_request_timeout_in_secondsnow bounds the wait for response headers on streaming requests, and cancelling a request closes the upstream socket. Every fasthttp client runs through a Bifrost-ownedRoundTripperthat applies the client’s read/write timeouts and the request context to the request write and the header wait, then lifts the socket deadline once headers are parsed sostream_idle_timeout_in_secondsremains the only bound on the body. An upstream that accepts the connection and never answers now fails with 504RequestTimedOutand its fallbacks are used, instead of pinning the provider worker. Unary large-response downloads bound every body read the same way, gzip-encoded bodies are classified for large-response mode by decompressed size, and a mid-body connection drop is again reported as the retryable 502 completion-marker error instead of a generic unexpected EOF (#7034, #7104) - Retry Storm After Client Disconnect - fasthttp-level stale-connection retries no longer multiply
max_retries.contextTransport.RoundTripreports a pre-header failure on a freshly dialed socket withretry=false, soStaleConnectionRetryIfErronly walks past pooled keep-alive sockets the upstream closed while idle; an upstream that closes a fresh connection without answering now costs exactly one attempt instead of up to four. Retry backoff also ends as soon as the request context is cancelled, freeing the worker immediately instead of after up toretry_backoff_max(#7035, #7105) - Abandoned Request Billing Coin Flip - Non-streaming requests whose caller had already disconnected were billed and logged only about half the time. The worker’s delivery
selecthad two simultaneously ready cases, a send into a cap-1 channel andctx.Done(), and Go picks uniformly among ready cases, so terminal post-hooks were skipped roughly 50% of the time. The worker now checksreq.Context.Err()before the select and callsbillAbandonedTerminaldeterministically, keeping the 5-second timer guard for a caller that leaves between the check and the send (#6972, #7116) - Stream Never Terminated Without
[DONE]- An OpenAI-compatible upstream that omits[DONE]and then goes silent afterfinish_reasonno longer fails the stream whenstream_idle_timeout_in_secondsfires. The chat and text completion read loops treat an idle timeout after a terminal signal as a parked upstream, abandon the connection rather than drain it, and synthesize the final chunk with the bufferedfinish_reason; a stall beforefinish_reasonstill surfaces as the idle-timeout error (#7108, #7115) - Dropped SSE Frames in
raw_response- Role-only, finish-only and usage-only frames never entered the chunk-forwarding branch, so their bytes were discarded from the reconstructedraw_response, leaving the captured audit trail irreconcilable against a provider invoice since the usage frame carries the token counts Bifrost bills from. ApendingRawFramesbuffer drains onto the next forwarded chunk or the synthetic terminal chunk, the Responses-over-Chat fallback no longer stamps one upstream frame onto every derived event, anddelta.refusalanddelta.annotationsare forwarded instead of dropped entirely (#7144, #7184) - Bedrock Mantle Trailing Usage - Bedrock Mantle chat streaming no longer drops the usage-only chunk that arrives after
finish_reason;ProviderSendsDoneMarkernow treatsbedrock_mantleand the legacy Mantle route under thebedrockkey as sending[DONE], so streamed usage and cost are recorded (#7065, #7076) - Fallbacks Re-Ran the Primary for Image and Video Edits - Fallbacks for image edit, image variation and video edit requests now reach the configured fallback provider and model.
prepareFallbackRequesthad no arm for those three types, so the shallow copy kept the primary’s sub-request pointer and the attempt was routed back to the primary while routing info, headers, the log row and thefallback_indexmetric label all reported it as a fallback. The helper now verifies the prepared request targets the fallback and skips it with a warning otherwise, so a future request type added without an arm fails loudly (#6966, #7118) - Provider Response Headers Leaked Across Fallbacks -
clearCtxForFallbackmissedBifrostContextKeyProviderResponseHeaders. Providers set that key before the status check so error paths can forward it, and when a fallback failed pre-flight (key selection failed, a plugin short-circuited, the queue was retiring) nothing overwrote it, so the client received a response attributed to provider B carrying provider A’sRetry-Afterand rate-limit headers (#6973, #7021) (thanks @Huang-404-Q!) - Credential-Bearing Response Headers Forwarded - The provider-response extractors filtered only against a fixed map of 28 exact names, so any credential-named header outside it was re-served to the inference caller in both the HTTP response and
extra_fields.provider_response_headers. The path now also consultsschemas.IsSensitiveHeader, which recognizes credential names by substring and suffix and already knew aboutcf-access-*andx-amzn-oidc-*; a fixed list cannot enumerate the space whennetwork_config.extra_headersexists to carry custom auth headers and some upstreams echo request headers back (#7120, #7121) (thanks @Atharva-Kanherkar!) - Nil Dereference on Incomplete Fallback Errors - A plugin returning a
BifrostErrorwhose nestedErrorfield is nil crashed the request worker. Fallback processing now nil-checks the error and guards access toError.Type, using the nil-safeGetErrorString()helper, and continues to the next fallback when allowed (#6967, #7110) (thanks @Constantine3!) - Bedrock Duplicate Document Names - Every untitled document block was given the literal default name
document, and Converse rejects duplicate document names, so any request with two or more untitled documents failed unconditionally with aValidationException. A per-request document namer now disambiguates with numeric suffixes (document,document-2, and so on) and suffixes titled documents only on an actual collision, on both the Converse and Responses replay paths (#7003, #7027) (thanks @Huang-404-Q!) - Bedrock Text Document Source - Converse rejects document blocks that use a text-only
DocumentSourceunless citations are explicitly enabled, so plain text formats (text/plain,text/markdown,text/csv,text/html) failed withmust set one of the following keys: bytes, s3Location. All document content, including data URLs, percent-encoded payloads andfile_data, now ships base64-encoded throughsource.bytes(#7072, #7079) - Bedrock Tool Result Images - Some Bedrock-hosted models (OpenAI and Grok families) reject image blocks placed directly inside a
toolResultin Converse, even though they accept images in tool output via Responses. AhoistToolResultImagespass moves images out oftoolResultblocks and re-inserts them after the last tool result in the same message, leaving a placeholder text block so the now image-free result is not rejected for being empty. A datasheet rowsupports_converse_tool_result_imagesoverrides the family-level default (#7150) - gpt-oss Message Mistagging on Mantle - Claude Code replaying a prior assistant message through
POST /anthropic/v1/messagesat a Bedrock Mantle model was rejected with hundreds of validation errors: the Bedrock-grouped ingress converter tagged user and system input text asoutput_text(onlyinput_textis valid on input messages) and omitted the requiredstatuson replayed assistant messages. Bedrock requests with no explicitmax_tokensnow also populate it from the model’s known capacity instead of truncating silently (#7074, #7075) - Azure Foundry Output Token Cap - Azure Foundry deployments of Fireworks-hosted models were silently capped at 4096 output tokens on
/openai/v1/responsesbecause Microsoft routes those models through chat completions internally. The Azure provider now checks the model’s datasheetsupported_endpointsand transparently serves bothResponsesandResponsesStreamthrough/openai/v1/chat/completionswhen/v1/responsesis absent. Separately, a turn truncated by the output-token cap on any OpenAI-shaped Responses provider now reportsstop_reason: max_tokenson the Anthropic egress instead of hiding the truncation asend_turn(#6782, #7142) - Gemini Inline Image and Audio Dropped - Gemini image-generation output (
inlineData) was silently dropped on/v1/chat/completions, both unary and streaming (#7032, #7033) (thanks @Atharva-Kanherkar!) - Gemini Image Edit Misclassified -
isImageEditRequestonly checkedcontents[0].parts[0], so a request with the prompt text before theinlineDatapart, which is the ordering in Google’s own REST edit sample, was misclassified as image generation: the image never reached Vertex and the model invented a picture from the prompt alone, returning HTTP 200. Detection now scans all parts across all contents.imageConfig.aspectRatiois also preserved as a typed parameter instead of being folded into aWxHsize string that collapsed any unsupported ratio to1:1(#7173) - Gemini Per-Part Media Resolution Dropped -
Partwas missingmediaResolution, which overridesgenerationConfig.mediaResolutionfor a single part, and becausePart.UnmarshalJSONdecodes into a closed alias the key was discarded before any conversion ran. Per-part image and PDF tokenization fell back to the model default, so anULTRA_HIGHimage billed about 21k prompt tokens through/genaiinstead of about 22.1k direct. The field now round-trips both spellings end to end and is stripped on the OpenAI wire path where it is unknown (#7156) - Gemini
generationConfigLost Across Retries -convertParamsToGenerationConfigResponsesdeletedtop_k,frequency_penalty,presence_penalty,stop_sequencesandmedia_resolutionfromExtraParamswhile mapping them intogenerationConfig, and that conversion runs once per attempt on the same request, so every retry or fallback after the first was sent without them. On Vertex the only visible signal waspromptTokenCounthalving on retried requests, making the downgrade silent (#7138) (thanks @VictorRequenaMaisa!) - MCP Tool Schema Property Order - MCP tool schemas keep one property and
$defsorder across tool syncs, so prompt caching is not invalidated by reordering alone (#7169, #7170) (thanks @dougcalobrisi!) - vLLM Alias Resolution During Key Selection - The generic allow and block lists correctly evaluated the user-facing alias, but vLLM key selection compared each key’s physical
model_nameagainst the unresolved alias and rejected valid keys. The alias is now resolved per key before that comparison, so the same public alias can map to different physical model IDs across vLLM instances, while allow and block checks keep matching the original alias. Allowed Models, Blocked Models and Deployments/Aliases are now exposed on the vLLM key form (#6956) (thanks @Constantine3!) - opencode-zen Responses Routing - opencode-zen Responses calls are routed through
/v1/chat/completions, which its upstream serves, instead of/v1/responses, which it does not (#6778, #6819) (thanks @miguelchico!) - DeepSeek
max_completion_tokensIgnored - DeepSeek’s chat-completions endpoint only recognizes the legacymax_tokensfield and silently ignoresmax_completion_tokens, so the limit had no effect. The field is now remapped on the wire, matching the behaviour already in place for Opencode and Ollama (#7131) - Anthropic Server Tools on Third-Party Endpoints - Fireworks’ Anthropic-compatible endpoint returns 400 when a request includes Anthropic server tools such as
web_search_20250305, because those run on Anthropic-operated infrastructure that does not exist on third-party hosts; clients whose built-in web search is always on hit this on every request. Unsupported server tools are now dropped before the request leaves Bifrost, the caller’s function tools are kept, and the drops are reported onDroppedUnsupportedToolsinstead of failing the call. The same applies to vLLM and SGLang (#7090) - Bedrock Guardrail Headers - Bedrock’s OpenAI-compatible endpoints apply guardrails through request headers rather than the
guardrailConfigbody field Converse uses, so a configured guardrail was silently ignored there.guardrailIdentifier,guardrailVersionandtraceare now mapped to theX-Amzn-Bedrock-Guardrail*headers on both chat completions and responses, streaming and non-streaming, and the key is consumed so it is not also emitted into the body. A half-formed config with only one of identifier or version is left untouched rather than sent (#7095) - Responses SSE
item: null- Responses stream events that carry no item payload no longer serialize"item": null, which strict OpenAI Responses clients reject as an invalid frame, breaking streamed/v1/responsesusage (#6395) (thanks @ReStranger!) - Responses
actionString Decode -image_generation_callitems where OpenAI emitsactionas a bare JSON string failed to decode, becauseUnmarshalJSONimmediately peeked at a.typefield that cannot be read from a string. That silently dropped theresponse.output_item.doneandresponse.completedevents carrying the image, leaving the stream without a terminal event and surfacing as a bogus “provider closed the stream” truncation error. The completed item also keeps the generation settings OpenAI echoes back (#7060) - Mid-Conversation System Messages Broke Prompt Caching - Mid-conversation
role: "system"messages are inlined in place as<system-reminder>user turns on every converter with a top-level system field: Bedrock Converse (Responses and Chat Completions), Gemini Chat Completions, and the Anthropic wire shape used by DeepSeek, Fireworks and SGL. Previously only Claude on Bedrock and Anthropic inlined; everything else hoisted each reminder into the top-level system block. Claude Code appends a trailing<total_tokens>reminder after every turn, so the hoisted block grew the front of the prompt each turn and prefix-based caches reported a full cache write and zero cache reads on every turn (#7145) - Unsupported
reasoning.contextRejected the Request - Areasoning.contextvalue the target model does not accept is dropped on the OpenAI and Azure Responses path, soall_turnson the original gpt-5 family including gpt-5-pro, gpt-5.1 to gpt-5.3 and the o-series runs under the model’s owncurrent_turndefault instead of failing withUnsupported value. gpt-5.4, gpt-5.5 and gpt-5.6 keep it. Accepted values come from the datasheet rowsupported_reasoning_contexts(#7140) - ClickHouse Retention Filled Replica Disks - ClickHouse log store deletes no longer run as heavyweight
ALTER TABLE ... DELETEmutations. The retention cleaner issued one per 100 rows, each rewriting the whole current-month part, and the once-a-minute stale-processingsweeps issued one per table unconditionally. Every delete is now a single lightweightDELETE FROM ... WHEREper run, skipped when nothing matches. The table TTL derived fromlogs_store.retention_daysis reconciled on every startup with a metadata-onlyMODIFY TTL, so changing the value reaches existing tables;0leaves an existing TTL untouched (#7098, #7103) - Governance Cleanup Dump Race -
UsageTracker.Cleanup()took its final budget and rate-limit snapshots before stopping the periodic reset worker, sotrackerCancel()could cancel an in-flight dump and fail withcontext canceled. The worker is now cancelled and awaited before the final dumps, a queued ticker event cannot start another reset cycle during shutdown, andcontext.Canceledis treated as expected only when the tracker context was actually cancelled (#7099, #7100) (thanks @Constantine3!) - OAuth Refresh Failed for Public Clients - Public OAuth2 clients registered against servers that only support
token_endpoint_auth_method: nonehave no client secret, and unconditionally settingclient_secret=in the refresh POST body sent an emptyclient_secret_postattempt. Strict authorization servers answeredinvalid_client, flipping the token row toneeds_reautheven though the refresh token was valid. The parameter is now omitted when the secret is empty, matching the PKCE code-exchange path (#7042) - Complexity Router Skipped Continuation Turns - When a turn is a continuation, such as a tool result following a prior user message, the complexity router discarded the extracted input and skipped classification entirely if no active session was found, leaving new or recovered sessions without a tier. Continuation turns now keep the populated
ComplexityInputand fall back to classifying the recoveredLastUserText; the skip path applies only when that is also empty (#7122) - Runtime Responses-Compat Routing - Bedrock runtime models that serve the Responses API are routed to it through a dedicated surface resolver rather than falling back to Converse (#7071)
- Bedrock Mantle Base Path - Bedrock Mantle serves each model on exactly one of two base paths (
v1oropenai/v1) and returns a 400 on the other. Hard-coded string matching in two packages covered only generations up to GPT-5 and Gemma 4, so GPT-6 and any future closed-generation model silently fell through to the wrong path. Resolution is centralized inResolveBedrockMantleBasePath, backed by abedrock_mantle_base_pathdatasheet field with family-name detection as the fallback, so a new generation needs a datasheet row rather than a code change (#7077) - Virtual Key
allowed_models: ["*"]Handling Reverted - The wildcard handling for governance virtual keys added in #6767 is reverted. Configurations relying onallowed_models: ["*"]with an empty synced catalog return to the previous behaviour (#7053) - Helm
perUserHeaderKeysNot Rendered -mcp.clientConfigs[].perUserHeaderKeysis mapped into the renderedconfig.json(#6033, #6034) (thanks @CallumWayve!) - Helm Plural Access Profiles - Governance roles accept
access_profilesas an array in the Helm and config schemas. Bifrost supports multiple access profiles but the schemas accepted only the deprecated singularaccess_profile. The singular form keeps rendering unchanged, the plural wins when both are present, and an explicitly empty plural list clears existing grants (#7044) (thanks @CarlosLanderas!) - Sidebar Title Overflow - Long sidebar item titles are truncated instead of overflowing (#7069)
- MCP Logs App Icon - App icons in the MCP logs table render at 20x20 and no longer shrink when the column is narrow (#7167)
🗄️ Database Migrations
- add_use_openai_endpoints_column - Adds the
use_openai_endpointscolumn to the provider keys table for Bedrock OpenAI-compatible endpoint routing. Reversible: the rollback drops the added column. Additive and nullable, so it is safe to run during a rolling upgrade. - add_time_of_day_pricing_columns - Adds
off_peak_cost_multiplierandpeak_hourstogovernance_model_pricingfor time-of-day pricing. Reversible: the rollback drops both added columns. Additive and nullable, so it is safe to run during a rolling upgrade. - mcp_tool_logs_add_governance_snapshots - Adds twelve governance attribution columns to
mcp_tool_logs:user_name,team_name,customer_name,business_unit_name, theteam_ids/team_names,customer_ids/customer_namesandbusiness_unit_ids/business_unit_namespairs, plusbudget_idsandrate_limit_ids. Reversible: the rollback drops all twelve in reverse order. Additive and nullable, so it is safe to run during a rolling upgrade. The twelveALTER TABLEs run under a bounded DDL lock wait, so startup does not stall behind a long-running log transaction holdingACCESS EXCLUSIVEon a continuously written table.
🐙 Closed GitHub Issues
- #6033 - Helm chart: mcp.clientConfigs[].perUserHeaderKeys not rendered into config.json
- #6778 - opencode-zen Anthropic endpoint fails, zen upstream doesn’t support /v1/responses
- #6782 - Azure Fireworks/Foundry models capped at 4096 output tokens on Responses + Anthropic ingress (chat completions is not); truncation reported as end_turn
- #6825 - Bedrock provider silently drops Anthropic compaction (compact_20260112), capability matrix says supported, but Claude egress is Converse-only
- #6966 - fallbacks silently re-target the primary provider for image edit / variation requests
- #6967 - shouldContinueWithFallbacks nil-derefs BifrostError.Error, crashing the process on a plugin-returned error
- #6972 - abandoned-request billing is a ~50% coin flip when a client disconnects mid-request
- #6973 - provider response headers leak across fallback boundaries (clearCtxForFallback misses ProviderResponseHeaders)
- #7003 - Bedrock Converse assigns duplicate default name “document” to untitled document blocks, ValidationException
- #7032 - Gemini image-generation output (inlineData) silently dropped on /v1/chat/completions, both unary and streaming
- #7034 -
default_request_timeout_in_secondsandstream_idle_timeout_in_secondsdo not fire while waiting for response headers, a silent upstream blocks the request until the upstream closes, and the fallback is never used - #7035 - upstream retries continue after the client has disconnected, and go past
max_retries, one abandoned request produced 10 upstream attempts over ~20 minutes - #7048 - Compat namespace flattening creates duplicate tool names for DeepSeek 4.1 Flash
- #7065 - Bedrock Mantle chat streaming drops trailing usage after finish_reason
- #7072 - Bedrock Converse drops text-format document bytes, DocumentSource “must set one of the following keys: bytes, s3Location” (v1 to v2 regression)
- #7074 - openai.gpt-oss-120b via Bedrock Responses API mistags replayed history as output_text instead of input_text, breaks multi-turn Claude Code sessions
- #7098 - ClickHouse logs store: retention cleaner runs one
ALTER TABLE ... DELETEmutation per 100 rows and fills replica disks - #7099 - UsageTracker cleanup races the periodic rate-limit dump during shutdown
- #7108 - Custom-provider streaming never terminates when the upstream omits [DONE] (heartbeats mask stream_idle_timeout_in_seconds)
- #7120 - Provider response-header filter ignores IsSensitiveHeader, forwarding credential-named headers to inference callers
- #7143 - does_not_send_done_marker drops trailing Chat Completions usage and records zero cost
- #7144 - Chat Completions streaming raw_response omits usage-only and finish-only SSE frames
- #7155 - Bedrock-native invoke ingress silently drops Anthropic tool search (
tool_search_tool_*/defer_loading), served eagerly over Converse - #7169 - MCP tool schema property order changes between tool syncs, breaking prompt caching
1.9.0
- [fix]: MCP tool schemas keep one property order across tool syncs @dougcalobrisi
- feat:
WhiteListandBlackListentries that start withregex:are RE2 patterns.MatchEntrycompiles them once as a case-insensitive full match,Validaterefuses a pattern that is empty,*or does not compile, and the list-models pipeline never surfaces a pattern as a model. Plain entries keep their exact, case-insensitive match - fix: fasthttp-level stale-connection retries no longer multiply
max_retries.contextTransport.RoundTripreports a failure before response headers on a freshly dialed socket withretry=false, sonetwork.StaleConnectionRetryIfErronly walks past pooled keep-alive sockets the upstream closed while idle; an upstream that closes a fresh connection without answering now costs exactly one attempt of Bifrost’s own retry budget instead of up to four. The retry backoff also ends as soon as the request context is cancelled, so a worker is freed immediately instead of after up toretry_backoff_max(#7035) - [fix]: Gemini provider - preserve inline image and audio data in chat completions responses @Atharva-Kanherkar
- [fix]: route opencode-zen Responses calls through /v1/chat/completions, which its upstream does not serve on /v1/responses @miguelchico
- feat: the namespace-tool names a provider reserves for its own server tools (
web,image_gen,browser,pythonon Bedrock and Bedrock Mantle) are now read from the datasheet rowreserved_tool_namespaces(newModelCapabilitiesfield andModelCaps.ReservedToolNamespaces) for the base provider and canonical model; a non-empty row replaces the hardcoded list, an absent or empty row keeps it, so any OpenAI-wire provider can reserve names through a row without a code change - fix: Codex >= 0.147 wraps its default tools in a namespace literally named
functions(openai/codex#37022), which Bedrock Mantle reserves and rejects withUser-defined namespace 'functions' collides with an existing tool namespace. Core now unwraps that namespace to top-level tools, unprefixed, for every provider before dispatch; Codex treats the bare name and the explicitfunctionsnamespace as the same tool, so no mapping back is needed; a description on thefunctionsnamespace is prepended to each hoisted member, as flattening does - fix: Responses
namespacetools are now flattened in core for every provider whose wire does not support the type (Anthropic, Gemini, Vertex, Bedrock Converse, DeepSeek, and every OpenAI-compatible third party), with nested functions renamed to<namespace>__<function>so two namespaces that share a function name no longer collide into an upstreamTool names must be unique400; returnedfunction_callitems are mapped back to the barenameplusnamespace(unary and streaming), prior-turn calls carryingnamespaceandtool_choicenames are re-aliased to match, and a name that is still duplicated after flattening or atool_choicethat matches several namespaces is rejected with a clear 400 before reaching the provider. Bedrock answers namespace support from its own surface resolver via the new optionalResponsesNamespaceToolProviderinterface. A datasheet rowsupports_namespace_tools(newModelCapabilitiesfield andModelCaps.SupportsNamespaceTools) overrides the per-provider default for a (provider, model) pair; with no row the default applies. A row can only narrow within what the wire can carry: the Anthropic Messages API (Anthropic, Claude on Azure or Bedrock Mantle), the Gemini API (Gemini, Vertex) and Bedrock Converse have no namespace container, so they answer false regardless of the row and always flatten. Flattened names honour the target wire’s documented tool-name limit, 64 characters of[A-Za-z0-9_-]for OpenAI-compatible wires, Bedrock Converse and Fireworks, 128 for Anthropic, and 128 with.and:allowed for Gemini and Vertex, overridable per model through the datasheet rowtool_name_max_length(a row below 10 cannot hold the hashed form and is ignored); a longer alias becomes an 8-hex hash prefix plus the function name, deterministically, so history andtool_choicere-alias to the same string. The alias map travels on the prepared request (BifrostResponsesRequest.NamespaceToolAliases) and is applied to that attempt’s response, unary and streaming; nothing is kept on the request context or in process-wide state (#7048) - fix: drop namespace tools whose name Amazon Bedrock reserves (
web,image_gen,browser,python) on the Bedrock and Bedrock Mantle Responses paths instead of forwarding them into atools.namespacecollision 400; a dropped Codexwebnamespace becomes the hostedweb_searchtool on Bedrock Mantle - fix: Bedrock Mantle chat streaming no longer drops the usage-only chunk that arrives after
finish_reason;ProviderSendsDoneMarkernow treatsbedrock_mantle(and the legacy Mantle route under thebedrockkey) as sending[DONE], so streamed usage and cost are recorded (#7065) - fix:
default_request_timeout_in_secondsnow bounds the wait for response headers on streaming requests, and cancelling a request now closes the upstream socket. Every fasthttp client is driven through a Bifrost-ownedRoundTripper(core/providers/utils/roundtripper.go) that applies the client’s read/write timeouts and the request context to the request write and the header wait, then lifts the socket deadline once headers are parsed sostream_idle_timeout_in_secondsremains the only bound on the body.BuildStreamingClientandBuildLargeResponseClientno longer zero the timeouts. An upstream that accepts the connection and never answers now fails with 504RequestTimedOutafter the request timeout and the request’s fallbacks are used, instead of pinning the provider worker until the upstream closes the socket;MakeRequestWithContextno longer leaves a backgroundclient.Dorunning untilReadTimeoutafter its context is cancelled (#7034) - fix: unary large-response downloads (
FinalizeResponseWithLargeDetection) now bound every body read withstream_idle_timeout_in_secondsand close the upstream socket on request cancellation, mirroring the streamed passthrough path; a stall during the prefetch surfaces as 504RequestTimedOutinstead of pinning the provider worker, and a stall while the transport drains theLargeResponseReaderfails the read with the idle-timeout error instead of blocking the writer indefinitely (#7104) - fix: gzip-encoded unary responses are now classified for large-response mode by decompressed size;
Content-Lengthdescribes the compressed bytes, so a body that was small on the wire but large once decompressed used to be materialized in full pastlarge_response_threshold(#7104) - fix: an OpenAI-compatible upstream that omits
[DONE]and then goes silent afterfinish_reasonno longer fails the stream whenstream_idle_timeout_in_secondsfires. The chat and text completion read loops now treat an idle timeout after a terminal signal as a parked upstream, mark the stream parked so the connection is abandoned rather than drained, and synthesize the final chunk with the bufferedfinish_reason; a stall beforefinish_reasonstill surfaces as the idle-timeout error (#7108) - fix: a streamed upstream that drops the connection mid-body is again reported as the retryable 502
provider closed the stream before sending a completion markererror instead of a genericError reading stream: unexpected EOF. The Bifrost round tripper’s chunked decoder surfaced the drop asio.ErrUnexpectedEOF, which no provider read loop treats as end of stream; it now reports the plainio.EOFfasthttp always did and discards the half-read connection (#7104 follow-up) - fix: fallbacks for image edit, image variation and video edit requests now reach the configured fallback provider and model.
prepareFallbackRequesthad no arm for those three types, so the shallow request copy kept the primary’s sub-request pointer and the “fallback” attempt was routed back to the primary whileRoutingInfo, thex-bifrost-routing-info-*headers, the log row and thefallback_indexmetric label reported it as a fallback. The helper now also verifies the prepared request targets the fallback provider and model and skips the fallback with a warning otherwise, so a future request type added without an arm fails loudly instead of silently re-running the primary (#6966) - fix: route Bedrock Claude requests that carry a
compact_20260112edit to InvokeModel / InvokeModelWithResponseStream with the native Anthropic Messages body, so server-side compaction works onbedrock/models, including keys that pin an inference-profile ARN. AWS documents compaction as unsupported on the Converse API, which previously received the edit and silently ignored it (#6825) - feat: serve Anthropic tool search (
tool_search_tool_*,defer_loading) onbedrock/Claude models by routing those requests to InvokeModel / InvokeModelWithResponseStream, the only Bedrock API AWS allows it on; CountTokens counts such requests with the same InvokeModel body via theinvokeModelinput - fix: a
reasoning.contextvalue the target model does not accept is now dropped on the OpenAI and Azure Responses path, soall_turnson the original gpt-5 family incl. gpt-5-pro, gpt-5.1 to gpt-5.3, and the o-series runs under the model’s owncurrent_turndefault instead of failing withUnsupported value: 'all_turns' is not supported with the 'gpt-5-pro' model; gpt-5.4, gpt-5.5 and gpt-5.6 keep it. The accepted values come from the datasheet rowsupported_reasoning_contexts(newModelCapabilitiesfield andModelCaps.SupportedReasoningContexts), falling back to a name-based default ofautoandcurrent_turneverywhere plusall_turnson gpt-5.4+ - fix: mid-conversation
role: "system"messages are now inlined in place as<system-reminder>user turns for every model family on every converter that has a top-level system field: Bedrock Converse (Responses and Chat Completions), Gemini Chat Completions (systemInstruction), and the Anthropic wire shape used by DeepSeek, Fireworks and SGL. Previously only Claude on Bedrock/Anthropic inlined; everything else hoisted each reminder into the top-level system block. Claude Code appends a trailing<total_tokens>system reminder after every turn, so the hoisted block grew the front of the prompt each turn and prefix-based caches (Bedrock implicit caching forglobal.openai.gpt-5.6-lunaon Converse, Gemini implicit caching, DeepSeek context caching) reported a full cache write and zero cache reads on every turn - [fix]: vLLM key selection resolves the requested alias through
key.Aliasesper key before comparing it withvllm_key_config.model_name, so a valid key is no longer rejected when the request used an alias; the same public alias can map to different physical model IDs across vLLM instances, and allow and block checks keep matching the original user-facing alias @Constantine3 - [fix]: Gemini Responses requests keep
top_k,frequency_penalty,presence_penalty,stop_sequencesandmedia_resolutionacross retries and fallbacks.convertParamsToGenerationConfigResponsesdeleted those keys fromExtraParamswhile mapping them intogenerationConfig, and the conversion runs once per attempt on the same request, so every attempt after the first reached the provider without them; the outboundExtraParamsis now built through a filtered copy instead of mutating the request @VictorRequenaMaisa - feat:
wait_for_usageoncustom_provider_configkeeps the OpenAI-compatible chat and text completion read loops open pastfinish_reasonuntil the trailing usage-only frame arrives, so a custom provider that also setsdoes_not_send_done_markerno longer synthesizes a zero-usage terminal chunk and records the request at zero tokens and zero cost.WaitForUsageis carried onBifrostContextKeyWaitForUsagewith the same set-or-clear discipline asDoesNotSendDoneMarker, so it never leaks onto a fallback provider that did not declare it, and termination stays bounded by the usage chunk, two consecutive post-finish heartbeat comments, EOF, orstream_idle_timeout_in_seconds(#7143) - fix:
ExtraFields.RawResponsenow carries role-only, finish-only and usage-only SSE frames on the OpenAI-compatible chat stream. Those frames never entered the chunk-forwarding branch, so their bytes were discarded from the reconstructedraw_response, which made the captured audit trail irreconcilable against a provider invoice because the usage frame carries the token counts Bifrost bills from. ApendingRawFramesbuffer accumulates them and drains onto the next forwarded chunk or the synthetic terminal chunk; the Responses-over-Chat fallback no longer stamps one upstream frame onto every derived event, anddelta.refusalanddelta.annotationsare added to the forwarding predicate so refusals and streamed URL citations are no longer dropped entirely (#7144) - fix: Anthropic server-side tool search survives the Bedrock-native invoke ingress end to end.
tool_search_tool_*was dropped during the Converse-shaped intermediate conversion, leaving the egress predicate blind to the tool and routing the request to Converse where server-side tool search is unavailable; the tool is now carried as an ingress-only marker (json:"-", never reaching a Converse body) and the neutral tool is rebuilt inToBifrostResponsesRequestalong withdefer_loading. Results are returned as aserver_tool_useplustool_search_tool_resultpair rather than a clienttool_use, which Anthropic rejects when the caller echoes atool_resultfor thesrvtoolu_ID on the next turn, on both the unary and streaming paths;BedrockContentBlock.UnmarshalJSONgainedserver_tool_useandtool_search_tool_resultcases so replayed turns round-trip unchanged instead of falling through to empty structs; and the Anthropic-native response path carries the same blocks (#7155) - fix: native Gemini
generateContentimage requests routed through/genaino longer return HTTP 200 while silently ignoring part of the request.isImageEditRequestonly inspectedcontents[0].parts[0], so a request with the prompt text before theinlineDatapart, the ordering in Google’s own REST edit sample, was misclassified as image generation: the image never reached Vertex and the model invented a picture from the prompt alone. Detection now scans every part across every content.imageConfig.aspectRatiois preserved as a typedaspect_ratioparam that both outbound converters prefer, instead of being folded into aWxHsize string that collapsed any ratio outside1:1,3:4,4:3,9:16and16:9back to square (#7173) - fix: Gemini
PartgainedmediaResolution, the per-part override forgenerationConfig.mediaResolution.Part.UnmarshalJSONdecodes into a closed alias, so the key was discarded before any conversion ran and per-part image and PDF tokenization fell back to the model default; anULTRA_HIGHimage billed about 21k prompt tokens through/genaiinstead of about 22.1k direct. Both themediaResolutionandmedia_resolutionspellings are parsed, the value round-trips throughResponsesMessageContentBlockand is reconstructed on the outbound part, and it is stripped on the OpenAI wire path where the field is unknown (#7156) - fix: image blocks inside a Bedrock Converse
toolResultare hoisted out and re-inserted immediately after the last tool result in the same message, with a placeholder text block left behind so the now image-free result is not rejected for being empty. Some Bedrock-hosted models, notably the OpenAI and Grok families, reject nested tool-result images on Converse even though they accept images in tool output via the Responses API.BedrockModelSupportsToolResultImagessupplies the name-based default and the datasheet fieldsupports_converse_tool_result_images(newModelCapabilitiesfield andModelCaps.SupportsConverseToolResultImages) overrides it per row (#7150) - feat:
bifrost_error_requests_totalgains a normalizederror_typelabel drawn from a closed, prefix-structured vocabulary (caller_*,policy_*,provider_*,bifrost_*,_OTHER), so a 429 from a governance rate limit is distinguishable from a 429 from an upstream provider, a 403 from a blocked model from one from a bad key, and a 503 Bifrost shed under queue pressure from an upstream overload.ClassifyErrorTyperesolves a declaredExtraFields.ErrorTypefirst, then Bifrost’s own string markers, then the upstream status code; it deliberately ignores the provider’s ownerror.typeanderror.codestrings, which disagree across providers for the same condition. Values are prefixed by fault domain so an alarm expression can match a family with a single regex (#7141) - fix: Azure Foundry deployments of Fireworks-hosted models are no longer silently capped at 4096 output tokens on
/openai/v1/responses, where Microsoft routes those models through chat completions internally. The Azure provider checks the model’s datasheetsupported_endpointsand, when/v1/responsesis absent, transparently serves bothResponsesandResponsesStreamthrough/openai/v1/chat/completionsand converts the result back to the Responses shape; a model with an explicit/v1/responsesentry or no datasheet row at all is unchanged. Separately,ToAnthropicResponsesResponsenow followsStopReason > IncompleteDetails > tool_use inference > end_turn, so a turn truncated by the output-token cap on any OpenAI-shaped Responses provider reportsstop_reason: max_tokensinstead of hiding the truncation asend_turn(#6782) - fix: DeepSeek chat requests move
max_completion_tokensintomax_tokenson the wire. DeepSeek’s chat-completions endpoint only recognizes the legacy field and silently ignoresmax_completion_tokens, so the limit had no effect; this matches the behaviour already in place for Opencode and Ollama (#7131) - feat: guardrail redaction gains an identity-based transformation path for provider-native request and response bodies, so exact provider-managed rewrites such as Model Armor and Bedrock land in the correct native JSON field even when the same text value appears in several fields.
TextTargetID,TextTargetIDForIndexandTextRewriteidentify each guardrail-visible field by a stable ID rather than by content value;RawRequestBodyTextTransformerandRawResponseTextTransformerlet integrations register handlers on the request context; andrewriteRawJSONTextTargetsvalidates target uniqueness, verifies eachOriginalvalue before patching and re-reads the written value after, so stale or mismatched normalized text cannot silently rewrite the wrong field (#7049) - feat: guardrail redaction covers LLM tool-call arguments, Chat function arguments, Responses function arguments and custom-tool input, across the Anthropic streaming and non-streaming paths.
input_json_deltaevents are inspected and rewritten alongsidetext_delta, reading and writingdelta.partial_json;collectAnthropicArgumentStringPathsrecursively collects string-valued paths inside atool_useblock’sinputwithout touching tool names, IDs or definitions;BifrostResponsesStreamResponsegainedInputto carry the full custom-tool payload oncustom_tool_call_input.done; andDeepCopyResponsesMessagedeep-copiesResponsesCustomToolCallso a copied message cannot mutate the original (#6977) - fix: an abandoned non-streaming request, one whose caller context was already cancelled by the time the upstream finished, is billed and logged deterministically instead of about half the time. The worker’s delivery
selecthad two simultaneously ready cases, a send into a cap-1 channel andctx.Done(), and Go picks uniformly among ready cases, so the terminal post-hooks that record billing and finalize the log row were skipped roughly 50% of the time.requestWorkernow checksreq.Context.Err()before the select on both the error and success paths and callsbillAbandonedTerminaldirectly, keeping the 5-second timer guard inside the select for a caller that leaves between the check and the send (#6972) - fix: provider response headers are filtered by classifier, not only by a fixed map of 28 exact names, so a credential-named header outside that map is no longer re-served to the inference caller in the HTTP response and
extra_fields.provider_response_headers. The extractors now also consultschemas.IsSensitiveHeader, which matches credential names by substring and suffix and already recognizedcf-access-*andx-amzn-oidc-*; a fixed list cannot enumerate the space whennetwork_config.extra_headersexists to carry custom authentication headers and some upstreams echo request headers back (#7120) @Atharva-Kanherkar - [fix]: a plugin that returns an incomplete
BifrostErrorwhose nestedErrorfield is nil no longer panics the request worker. The fallback decision helper nil-checksfallbackErr, guards access toError.Typeand reads the message through the nil-safeGetErrorString()helper, continuing to the next fallback when allowed; behaviour for cancelled requests andAllowFallbacks == falseis unchanged (#6967) @Constantine3 - [fix]:
clearCtxForFallbacknow clearsBifrostContextKeyProviderResponseHeaders. Providers set that key from their own HTTP response before the status check so error paths can forward it, and when a fallback attempt failed pre-flight, key selection failing for the fallback provider, a plugin short-circuiting it, or the queue retiring, nothing overwrote the key and the primary’s headers survived onto the fallback’s error response. A client could receive a response attributed to provider B carrying provider A’sRetry-Afterandx-ratelimit-remaining-*, and wait according to a limit belonging to a provider that never served the request (#6973) @Huang-404-Q - [fix]: untitled document blocks get unique names on the Bedrock Converse path. Every untitled block was named the literal
document, and Converse rejects duplicate document names, so any request carrying two or more untitled documents failed unconditionally withValidationException: Messages can't contain duplicate document names. A per-request namer threaded through the content-block conversion disambiguates with numeric suffixes (document,document-2,document-3) and suffixes explicitly titled documents only on an actual collision; the Responses input replay path gets the same treatment scoped to its content-block list (#7003) @Huang-404-Q - [fix]:
BifrostResponsesStreamResponse.Itemisomitempty, so Responses stream events that carry no item payload no longer serialize"item": null. Strict OpenAI Responses clients reject those as invalid stream frames, which broke streamed/v1/responsesusage entirely;response.output_item.addedandresponse.output_item.donestill emit the item object @ReStranger - feat:
SecretVar.RedactedIfSecret()returns a plain clone when the value is a literal and delegates toRedacted()when it is env-var or vault-backed, so regions and service URLs (Azure endpoint, Vertex/Bedrock/Bedrock Mantle region, vLLM/Ollama/SGL/Databricks URL, MCP connection string) are readable in the UI instead of being masked as if they were credentials. It always returns a fresh pointer, so the redacted copy never aliases the live config, and it replaces the ad-hocIsFromSecret()guard blocks that tried to replicate this inline (#7085) - feat: GA realtime transcription is served for OpenAI and Azure over both WebSocket and WebRTC with normal Bifrost authentication, routing, governance, guardrails, logging and transcription-aware pricing. Unlike a normal realtime session, which names its routing model in the connect URL, a GA transcription session carries only
intent=transcriptionand delivers the model later insession.updateunderaudio.input.transcription.model(or in the initial multipart/v1/realtime/callsrequest on WebRTC), so routing now resolves from the nested transcription model while realtime connection and turn semantics are preserved (#7089) - fix: Claude Code replaying a prior assistant message through
POST /anthropic/v1/messagesat a Bedrock Mantle model is no longer rejected with hundreds of validation errors. The Bedrock-grouped ingress converter tagged user and system input text asoutput_text, though onlyinput_textis valid on input messages, and omitted the requiredstatuson replayed assistant output messages, so Mantle’s strict OpenAI-compatible validator refused the whole request. Replayed assistant messages now carryStatus: "completed"and input text blocks are taggedinput_text. Bedrock requests with no explicitmax_tokensalso populate it from the model’s known capacity instead of truncating silently on large context windows (#7074) - fix: Anthropic server tools such as
web_search_20250305are stripped before a request reaches Fireworks, vLLM or SGLang on their Anthropic-compatible endpoints, which return 400 for tools executed by Anthropic-operated infrastructure that does not exist on third-party hosts; clients whose built-in web search is always on, such as Codex, hit this on every request.ProviderFeaturesentries forFireworks,VLLMandSGLdeclare all server-tool flags off so the existing validators strip them,StripUnsupportedServerToolsFromRawBodymirrors that on the raw-body passthrough path, the caller’s function tools are kept, and the drops are reported on the response’sDroppedUnsupportedToolsinstead of failing the call (#7090) - fix:
guardrailConfigreaches Bedrock’s OpenAI-compatiblechat/completionsandresponsessurfaces, streaming and non-streaming, which apply guardrails through request headers rather than the body field Converse uses, so a configured guardrail was previously ignored there with no error.withGuardrailHeadersmapsguardrailIdentifier,guardrailVersionand optionaltracetoX-Amzn-Bedrock-GuardrailIdentifier,X-Amzn-Bedrock-GuardrailVersionandX-Amzn-Bedrock-Trace, then deletes the key fromExtraParamsso it is not also emitted into the body. A half-formed config with only one of identifier or version is left untouched rather than sent, since both are required upstream, and the base header map is cloned rather than mutated (#7095) - feat:
use_openai_endpointson Bedrock keys and aliases routes chat completions and responses through Bedrock’s OpenAI-compatible/openai/v1endpoints instead of Converse, for models that support them, mirroring the existinguse_anthropic_endpointspattern. It is opt-in by design: Converse carries Bedrock Guardrails,performanceConfigandrequestMetadatathat the OpenAI-compatible surface silently ignores, so diverting automatically could stop a guardrail from being enforced with no visible error.ResolveUseOpenAIEndpointsgives the alias value precedence over the key, and the narrowruntimeServesResponsescheck is replaced by a generalruntimeServesOpenAIAPIthat takes aBedrockAPIdiscriminator; chat completions, streaming and non-streaming, gained the runtime path that previously existed only for Responses (#7073) - fix: Bedrock runtime models that serve the Responses API are routed to it through a dedicated surface resolver rather than falling back to Converse (#7071)
- fix: Bedrock Converse document blocks always ship their content base64-encoded through
source.bytes, never throughsource.text, which Converse rejects unless citations are explicitly enabled. Plain text formats (text/plain,text/markdown,text/csv,text/html) previously took the text branch and failed withDocumentSource must set one of the following keys: bytes, s3Location; the branch is removed for data URLs, percent-encoded payloads and the non-data-URLfile_datapath alike (#7072) - fix: the Bedrock Mantle base path is resolved from the model capabilities datasheet instead of hard-coded string matching in two packages. Mantle serves each model on exactly one of
v1oropenai/v1and returns a 400 on the other, and the previous matching covered only generations up to GPT-5 and Gemma 4, so GPT-6 and any future closed-generation model silently fell through to the wrong path.ResolveBedrockMantleBasePathapplies family-name detection as a fallback and defers to the newBedrockMantleBasePathfield onModelCapabilities, so a new generation needs a datasheet row rather than a code change (#7077) - fix:
image_generation_callitems where OpenAI emitsactionas a bare JSON string, such as"generate", decode correctly.ResponsesToolMessageActionStruct.UnmarshalJSONimmediately peeked at a.typefield, which cannot be read from a JSON string, so the whole decode failed withfailed to peek at type field; that silently dropped theresponse.output_item.doneandresponse.completedevents carrying the image, leaving the stream without a terminal event and surfacing as a bogusprovider closed the streamtruncation error. The action is now tried as a bare string before falling back to the object type-peek, andResponsesImageGenerationCallkeeps thebackground,output_format,quality,revised_promptandsizesettings OpenAI echoes back on completed items (#7060)
1.7.0
- feat: model allow and block lists accept
regex:entries. The provider-key aggregate keeps an exact name next to a pattern that also covers it, the catalog allow check tries a pattern against the bare name andprovider/model, and listings skip pattern entries - fix: ClickHouse log store deletes no longer run as heavyweight
ALTER TABLE ... DELETEmutations. The retention cleaner issued one such mutation per 100 rows, each rewriting the whole current-month part, and the once-a-minute stale-processingsweeps issued one per table unconditionally, filling replica disks in minutes. Every delete on the ClickHouse store (retention sweep,Flush/FlushMCPToolLogs, UI log deletes, async job and webhook delivery expiry) is now a single lightweightDELETE FROM ... WHEREper run, skipped entirely when nothing matches. The table TTL derived fromlogs_store.retention_daysis now reconciled on every startup withMODIFY TTL(metadata only), so changing the value reaches existing tables;0leaves an existing TTL untouched (#7098) - feat: access profiles and governance projects reference Virtual MCPs through
virtual_mcp_name, so config files are portable across environments instead of carrying database-assigned integer IDs. Names resolve to stored records on startup and a name that matches nothing is refused;virtual_mcp_idis deprecated, still accepted, and wins when both are set.mcp_configs({ mcp_client_id, tools_to_execute }) replaces themcp_serversandmcp_tool_overridesinclude-exclude model with a single allowlist, where["*"]grants all tools including future ones,[]grants none, and a named list grants only those; the old keys are deprecated, still accepted, and folded into the new shape at load time (#7181) - feat:
MCPToolLogrecords governance entity names beside their IDs, so MCP tool logs carry the same attribution shape thelogstable has instead of rendering raw UUIDs in the dashboard.user_name,team_name,customer_nameandbusiness_unit_namestop beinggorm:"-"transients and become storage; the multi-valuedteam_ids/team_names,customer_ids/customer_namesandbusiness_unit_ids/business_unit_namessets are stored as index-aligned JSON arrays; andbudget_idsandrate_limit_idsare recorded id-only, as inlogs. Names are written from the request context at ingestion through the newMCPToolLog.ApplyGovernanceinframework/logstore/governance.go, with nothing resolved on read. Added by migrationmcp_tool_logs_add_governance_snapshots(#7154) - feat: endpoint-attributed MCP observations are carried in the standard logging pipeline, so inspected MCP tool calls are logged with bounded identity (device, app key, server label, tool name, decision) sourced from the gateway rather than from payload-supplied headers.
SetMCPObservationattaches the attribution to aBifrostContextandapplyMCPObservationwrites it onto theMCPToolLogfrom bothPreMCPHookandPostMCPHook, snapshotting the observation so it cannot alias across async log entries (#6959) - feat: the
error_typeclassification vocabulary is threaded through the framework sobifrost_error_requests_totalcan carry a normalized fault-domain label alongsidestatus_code(#7141) - feat: model pricing supports time-of-day peak and off-peak rates.
TableModelPricinggainsoff_peak_cost_multiplier(a nullable float) andpeak_hours(a JSON-serializedPeakHoursScheduleof recurring weekly windows using IANA timezone names, weekday numbers and half-openHH:MMintervals that may wrap past midnight), added by migrationadd_time_of_day_pricing_columnsand aliased into the datasheet package so the JSON shape stays self-contained. The cost engine evaluates the schedule against the request start time and scales usage-based charges by the multiplier when the request falls outside every peak window, applied once incomputeCostFromInputso every modality is covered; flatCostPerRequestandSearchQueriesCostfees are excluded, as isAdditionalCost, which is discounted independently through its own pricing rows. Both fields are exposed onPricingPatchin the OpenAPI and governance schemas, withoff_peak_cost_multiplierbounded to(0, 1](#6574, #6575, #6576) - feat:
SecretVar.RedactedIfSecret()is used for non-credential fields inProviderConfig.Redacted(),Config.GetAllKeys()andConfig.RedactMCPClientConfig(), so regions, endpoints, service URLs and MCP connection strings surface as plaintext while anything env-var or vault-backed stays masked (#7085) - feat: GA realtime transcription sessions are routed, governed, logged and priced through the normal framework pipeline, resolving the routing model from the nested
audio.input.transcription.modelthat arrives insession.updaterather than from the connect URL (#7089) - feat: a
use_openai_endpointscolumn on the provider keys table, added by migrationadd_use_openai_endpoints_column, opts a Bedrock key or alias into Bedrock’s OpenAI-compatible endpoints instead of Converse (#7073) - feat: the reserved tool-namespace list a provider keeps for its own server tools is read from the datasheet row
reserved_tool_namespaces, so a namespace collision check no longer requires a code change (#7084) - fix:
exchangeRefreshTokenincludesclient_secretonly when the secret is non-empty, matchingexchangeCodeForTokensWithPKCE. Public OAuth2 clients registered against servers that support onlytoken_endpoint_auth_method: nonehave no secret, and unconditionally settingclient_secret=sent an emptyclient_secret_postattempt that strict authorization servers answered withinvalid_client, flipping the token row toneeds_reautheven though the refresh token was valid (#7042) - fix: the virtual key
allowed_models: ["*"]handling for governance added in #6767 is reverted, returning the wildcard-with-empty-synced-catalog case to its previous behaviour (#7053)
0.3.0
- fix: removed the namespace-tool flattening that ran under
should_convert_params; it spliced nested functions into the top-level list without a namespace prefix, so two namespaces sharing a function name produced duplicate tool names and an upstream 400. Flattening now lives in Bifrost core for every provider whose wire lacks thenamespacetype, with unique<namespace>__<function>names and response-side mapping back.should_convert_paramsis still accepted so existing configs load, but it no longer changes any request (#7048) - chore: upgraded core to v1.9.0 and framework to v1.7.0
1.8.0
- feat: MCP tool logs record governance entity names beside their IDs, so the plugin stamps
user_name,team_name,customer_name,business_unit_nameand the multi-valued team, customer and business-unit sets onto the log entry at ingestion instead of leaving the dashboard to render raw UUIDs (#7154) - feat: endpoint-attributed MCP inspections carry bounded identity (device, app key, server label, tool name, decision) from the gateway into the MCP authorization path, so an inspected tool call is attributed without trusting payload-supplied headers (#6959)
- feat: governance errors are classified into the normalized
error_typevocabulary, so a 429 raised by a governance rate limit is distinguishable from an upstream 429 onbifrost_error_requests_total(#7141) - feat: model allow and block lists accept
regex:entries. The*_patternsfields added earlier in this release window were withdrawn in favour of the prefix form, which needs no new schema fields (#6988, #7133, #7134) - fix:
UsageTracker.Cleanup()cancels and waits for the periodic reset worker before taking its final budget and rate-limit snapshots. It previously dumped first, sotrackerCancel()could cancel an in-flight rate-limit dump and fail withfailed to dump rate limits to database: context canceled, and the final dump was not guaranteed to be the tracker’s last database writer. A queued ticker event can no longer start another reset cycle during shutdown, the current cycle stops when the tracker context is cancelled, andcontext.Canceledis treated as an expected result only when that context was actually cancelled (#7099) @Constantine3
1.6.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.8.0
- feat: MCP tool log rows carry governance entity names alongside their IDs, written from the request context at ingestion, so nothing is resolved on read (#7154)
- feat: endpoint-attributed MCP observations are written onto both the pending and the final MCP tool log entry, with the observation snapshotted so it cannot alias across async entries (#6959)
- feat: cost recalculation honours time-of-day peak and off-peak pricing, scaling usage-based charges by
off_peak_cost_multiplierwhen a request falls outside every declared peak window (#6575) - feat: GA realtime transcription sessions are logged and priced through the standard pipeline with transcription-aware pricing (#7089)
- fix: a request whose caller disconnected before the upstream finished is logged and finalized deterministically rather than roughly half the time, so abandoned requests no longer leave a log row stuck in its pending state (#6972)
- docs: clarified that
CountRecalcTargetsreads a materialized view that can lag, so itsTotalis an approximation rather than an exact count (#7078)
1.7.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.6.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.1.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.5.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.1.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.1.0
- fix: a continuation turn, such as a tool result following a prior user message, is classified instead of skipped when no active session state is found.
BuildInputWithDispositionnow returns the populatedComplexityInputincludingLastUserTextfor trailing-continuation turns in both the chat and responses paths, andcomputeComplexityfalls back to classifying that recovered text, so new or recovered sessions get a tier assignment; the skip path applies only whenLastUserTextis also empty (#7122)
1.6.3
- chore: upgraded core to v1.9.0 and framework to v1.7.0
1.7.0
- feat:
bifrost_error_requests_totalcarries a normalizederror_typelabel alongsidestatus_code, drawn from a closed prefix-structured vocabulary (caller_*,policy_*,provider_*,bifrost_*,_OTHER), so alarm expressions can separate fault domains with a single regex instead of enumerating status codes (#7141)

