Files
sub2api/backend/internal/service/openai_gateway_grok_cache_test.go
T
李建琦 6d655c9903
Release / update-version (push) Has been cancelled
Release / build-frontend (push) Has been cancelled
Release / release (push) Has been cancelled
Release / sync-version-file (push) Has been cancelled
CI / shell (push) Canceled after 0s
CI / test (push) Canceled after 0s
CI / frontend (push) Canceled after 0s
CI / golangci-lint (push) Canceled after 0s
Security Scan / backend-security (push) Canceled after 0s
Security Scan / frontend-security (push) Canceled after 0s
Sub2API v1.0 - AI API 网关(二开初始版本,基于上游 Wei-Shaw/sub2api)
2026-08-21 18:30:13 +08:00

1113 lines
46 KiB
Go

//go:build unit
package service
import (
"net/http"
"net/http/httptest"
"sync"
"testing"
"github.com/Wei-Shaw/sub2api/internal/pkg/xai"
"github.com/gin-gonic/gin"
"github.com/stretchr/testify/require"
"github.com/tidwall/gjson"
)
func newGrokCacheTestContext(apiKeyID int64) *gin.Context {
recorder := httptest.NewRecorder()
c, _ := gin.CreateTestContext(recorder)
c.Request = httptest.NewRequest(http.MethodPost, "/v1/responses", nil)
if apiKeyID > 0 {
c.Set("api_key", &APIKey{ID: apiKeyID, Group: &Group{Platform: PlatformGrok}})
}
return c
}
func TestGrokPreviousResponseSessionSeed(t *testing.T) {
require.Equal(t, "grok-prev-resp:resp_abc123", grokPreviousResponseSessionSeed([]byte(`{"previous_response_id":"resp_abc123"}`)))
require.Empty(t, grokPreviousResponseSessionSeed([]byte(`{"previous_response_id":"msg_abc123"}`)))
require.Empty(t, grokPreviousResponseSessionSeed([]byte(`{"previous_response_id":""}`)))
require.Empty(t, grokPreviousResponseSessionSeed([]byte(`{}`)))
}
func TestResolveGrokCacheIdentityUsesPreviousResponseIDWhenNoOtherSeed(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(301)
// No prompt_cache_key / headers / reusable prefix — only previous_response_id.
body := []byte(`{"model":"grok","input":[{"role":"user","content":"follow up"}],"previous_response_id":"resp_chain_001"}`)
got := resolveGrokCacheIdentity(c, body, "", "grok-4.5")
require.NotEmpty(t, got)
// Same previous_response_id → same identity (model already in isolated seed).
again := resolveGrokCacheIdentity(c, body, "", "grok-4.5")
require.Equal(t, got, again)
// Different model → different identity (model scope).
otherModel := resolveGrokCacheIdentity(c, body, "", "grok-4.3")
require.NotEqual(t, got, otherModel)
// prompt_cache_key still wins over previous_response_id.
withCache := []byte(`{"model":"grok","prompt_cache_key":"client-session","previous_response_id":"resp_chain_001","input":[{"role":"user","content":"x"}]}`)
cacheID := resolveGrokCacheIdentity(c, withCache, "", "grok-4.5")
require.NotEmpty(t, cacheID)
require.NotEqual(t, got, cacheID)
}
func TestResolveGrokCacheIdentityStableAcrossAppendOnlyTurns(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(101)
round1 := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"lookup","parameters":{"type":"object"}}],"input":[{"role":"user","content":"first question"}]}`)
round2 := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"lookup","parameters":{"type":"object"}}],"input":[{"role":"user","content":"first question"},{"role":"assistant","content":"first answer"},{"role":"user","content":"second question"}]}`)
first := resolveGrokCacheIdentity(c, round1, "", "grok-4.5")
second := resolveGrokCacheIdentity(c, round2, "", "grok-4.5")
require.NotEmpty(t, first)
require.Len(t, first, 36)
require.Equal(t, first, second)
}
func TestResolveGrokCacheIdentityStableAcrossIndependentPromptsWithSamePrefix(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(102)
firstBody := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"lookup"}],"input":[{"role":"user","content":"Question A"}]}`)
secondBody := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"lookup"}],"input":[{"role":"user","content":"Question B"}]}`)
first := resolveGrokCacheIdentity(c, firstBody, "", "grok-4.5")
second := resolveGrokCacheIdentity(c, secondBody, "", "grok-4.5")
require.NotEmpty(t, first)
require.Equal(t, first, second)
}
func TestResolveGrokCacheIdentityStablePrefixIsolation(t *testing.T) {
gin.SetMode(gin.TestMode)
baseBody := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"lookup"}],"input":[{"role":"system","content":"System A"},{"role":"user","content":"Question A"}]}`)
differentInstructions := []byte(`{"model":"grok","instructions":"be detailed","tools":[{"type":"function","name":"lookup"}],"input":[{"role":"system","content":"System A"},{"role":"user","content":"Question B"}]}`)
differentSystem := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"lookup"}],"input":[{"role":"system","content":"System B"},{"role":"user","content":"Question B"}]}`)
differentTools := []byte(`{"model":"grok","instructions":"be concise","tools":[{"type":"function","name":"search"}],"input":[{"role":"system","content":"System A"},{"role":"user","content":"Question B"}]}`)
base := resolveGrokCacheIdentity(newGrokCacheTestContext(103), baseBody, "", "grok-4.5")
require.NotEqual(t, base, resolveGrokCacheIdentity(newGrokCacheTestContext(104), baseBody, "", "grok-4.5"))
require.NotEqual(t, base, resolveGrokCacheIdentity(newGrokCacheTestContext(103), baseBody, "", "grok-4.3"))
require.NotEqual(t, base, resolveGrokCacheIdentity(newGrokCacheTestContext(103), differentInstructions, "", "grok-4.5"))
require.NotEqual(t, base, resolveGrokCacheIdentity(newGrokCacheTestContext(103), differentSystem, "", "grok-4.5"))
require.NotEqual(t, base, resolveGrokCacheIdentity(newGrokCacheTestContext(103), differentTools, "", "grok-4.5"))
}
func TestResolveGrokCacheIdentityFallsBackWhenStablePrefixIsEmpty(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(105)
firstBody := []byte(`{"model":"grok","tools":[],"input":"Question A"}`)
secondBody := []byte(`{"model":"grok","tools":[],"input":"Question B"}`)
first := resolveGrokCacheIdentity(c, firstBody, "", "grok-4.5")
second := resolveGrokCacheIdentity(c, secondBody, "", "grok-4.5")
require.NotEmpty(t, first)
require.NotEmpty(t, second)
require.NotEqual(t, first, second)
}
func TestResolveGrokCacheIdentitySkipsUnanchoredFallback(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(106)
tests := [][]byte{
[]byte(`{"model":"grok"}`),
[]byte(`{"model":"grok","messages":[{"role":"assistant","content":"answer"}]}`),
[]byte(`{"model":"grok","messages":[{"role":"user","content":""}]}`),
[]byte(`{"model":"grok","input":" "}`),
}
for _, body := range tests {
require.Empty(t, resolveGrokCacheIdentity(c, body, "", "grok-4.5"))
}
}
func TestResolveGrokCacheIdentityIsolatesAPIKeyAndMappedModel(t *testing.T) {
gin.SetMode(gin.TestMode)
body := []byte(`{"model":"grok","input":"same prompt"}`)
base := resolveGrokCacheIdentity(newGrokCacheTestContext(201), body, "", "grok-4.5")
otherTenant := resolveGrokCacheIdentity(newGrokCacheTestContext(202), body, "", "grok-4.5")
otherModel := resolveGrokCacheIdentity(newGrokCacheTestContext(201), body, "", "grok-4.3")
require.NotEmpty(t, base)
require.NotEqual(t, base, otherTenant)
require.NotEqual(t, base, otherModel)
}
func TestResolveGrokCacheIdentityUsesAndIsolatesNativeConversationHeader(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(301)
c.Request.Header.Set(grokConversationIDHeader, "raw-native-conversation")
body1 := []byte(`{"model":"grok","input":"one"}`)
body2 := []byte(`{"model":"grok","input":"different body that must not replace the explicit session"}`)
first := resolveGrokCacheIdentity(c, body1, "body-cache-key", "grok-4.5")
second := resolveGrokCacheIdentity(c, body2, "another-body-cache-key", "grok-4.5")
require.Equal(t, "raw-native-conversation", (&OpenAIGatewayService{}).ExtractSessionID(c, body1))
require.Equal(t, first, second)
require.NotEqual(t, "raw-native-conversation", first)
require.NotContains(t, first, "raw-native-conversation")
}
func TestResolveGrokCacheIdentityExplicitHeaderPriority(t *testing.T) {
gin.SetMode(gin.TestMode)
body := []byte(`{"model":"grok","prompt_cache_key":"body-key","input":"hi"}`)
c := newGrokCacheTestContext(401)
c.Request.Header.Set(grokConversationIDHeader, "grok-key")
c.Request.Header.Set("conversation_id", "conversation-key")
c.Request.Header.Set("session_id", "session-key")
got := resolveGrokCacheIdentity(c, body, "explicit-argument", "grok-4.5")
onlySession := newGrokCacheTestContext(401)
onlySession.Request.Header.Set("session_id", "session-key")
want := resolveGrokCacheIdentity(onlySession, []byte(`{"model":"grok","input":"unrelated"}`), "", "grok-4.5")
require.Equal(t, want, got)
}
func TestResolveGrokCacheIdentityIDEHeaderPriority(t *testing.T) {
gin.SetMode(gin.TestMode)
body := []byte(`{"model":"grok","prompt_cache_key":"body-key","input":"hi"}`)
headers := []struct {
name string
value string
}{
{name: openCodeSessionAffinityHeader, value: "opencode-affinity"},
{name: openCodeSessionIDHeader, value: "opencode-session-id"},
{name: openCodeNativeSessionHeader, value: "opencode-native-session"},
{name: codeBuddyConversationHeader, value: "codebuddy-conversation"},
{name: grokConversationIDHeader, value: "grok-conversation"},
}
c := newGrokCacheTestContext(402)
for _, header := range headers {
c.Request.Header.Set(header.name, header.value)
}
for _, header := range headers {
got := resolveGrokCacheIdentity(c, body, "explicit-argument", "grok-4.5")
onlyCurrent := newGrokCacheTestContext(402)
onlyCurrent.Request.Header.Set(header.name, header.value)
want := resolveGrokCacheIdentity(onlyCurrent, []byte(`{"model":"grok","input":"unrelated"}`), "", "grok-4.5")
require.Equal(t, want, got, header.name)
c.Request.Header.Del(header.name)
}
}
func TestExplicitGrokCacheSeedPriority(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(403)
headers := []struct {
name string
value string
}{
{name: claudeCodeSessionHeader, value: "claude-session"},
{name: "session_id", value: "generic-session"},
{name: "conversation_id", value: "generic-conversation"},
{name: openCodeSessionAffinityHeader, value: "opencode-affinity"},
{name: openCodeSessionIDHeader, value: "opencode-session-id"},
{name: openCodeNativeSessionHeader, value: "opencode-native-session"},
{name: codeBuddyConversationHeader, value: "codebuddy-conversation"},
{name: grokConversationIDHeader, value: "grok-conversation"},
}
for _, header := range headers {
c.Request.Header.Set(header.name, header.value)
}
body := []byte(`{"model":"grok","prompt_cache_key":"body-key","input":"hi"}`)
for _, header := range headers {
require.Equal(t, header.value, explicitGrokCacheSeed(c, body, "explicit-argument"), header.name)
c.Request.Header.Del(header.name)
}
require.Equal(t, "body-key", explicitGrokCacheSeed(c, body, "explicit-argument"))
require.Equal(t, "explicit-argument", explicitGrokCacheSeed(c, []byte(`{"model":"grok"}`), "explicit-argument"))
}
func TestResolveGrokCacheIdentityIDEHeadersAreStableIsolatedAndOpaque(t *testing.T) {
gin.SetMode(gin.TestMode)
tests := []struct {
name string
header string
}{
{name: "OpenCode affinity", header: openCodeSessionAffinityHeader},
{name: "OpenCode session ID", header: openCodeSessionIDHeader},
{name: "OpenCode native session", header: openCodeNativeSessionHeader},
{name: "CodeBuddy conversation", header: codeBuddyConversationHeader},
}
for index, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
rawSession := "raw-ide-session-" + tt.name
apiKeyID := int64(800 + index)
c := newGrokCacheTestContext(apiKeyID)
c.Request.Header.Set(tt.header, rawSession)
firstBody := []byte(`{"model":"grok","prompt_cache_key":"turn-one-body-key","input":"first turn"}`)
secondBody := []byte(`{"model":"grok","prompt_cache_key":"turn-two-body-key","input":"different second turn"}`)
first := resolveGrokCacheIdentity(c, firstBody, "first-explicit-key", "grok-4.5")
second := resolveGrokCacheIdentity(c, secondBody, "second-explicit-key", "grok-4.5")
require.NotEmpty(t, first)
require.Equal(t, first, second)
require.NotEqual(t, rawSession, first)
require.NotContains(t, first, rawSession)
otherTenant := newGrokCacheTestContext(apiKeyID + 100)
otherTenant.Request.Header.Set(tt.header, rawSession)
require.NotEqual(t, first, resolveGrokCacheIdentity(otherTenant, firstBody, "", "grok-4.5"))
require.NotEqual(t, first, resolveGrokCacheIdentity(c, firstBody, "", "grok-4.3"))
})
}
}
func TestOpenCodeResponsesHeaderAndBodyCacheSignalsConverge(t *testing.T) {
gin.SetMode(gin.TestMode)
const rawSession = "opencode-session-42"
c := newGrokCacheTestContext(901)
c.Request.Header.Set(openCodeSessionAffinityHeader, rawSession)
c.Request.Header.Set(openCodeSessionIDHeader, rawSession)
firstBody := []byte(`{"model":"grok","prompt_cache_key":"opencode-session-42","input":"first turn"}`)
secondBody := []byte(`{"model":"grok","prompt_cache_key":"opencode-session-42","input":"different second turn"}`)
first := resolveGrokCacheIdentity(c, firstBody, "", "grok-4.5")
second := resolveGrokCacheIdentity(c, secondBody, "", "grok-4.5")
bodyOnly := resolveGrokCacheIdentity(newGrokCacheTestContext(901), secondBody, "", "grok-4.5")
require.NotEmpty(t, first)
require.Equal(t, first, second)
require.Equal(t, first, bodyOnly)
patched, err := applyGrokResponsesCacheIdentity(secondBody, secondBody, second, false)
require.NoError(t, err)
require.Equal(t, second, gjson.GetBytes(patched, "prompt_cache_key").String())
headers := make(http.Header)
applyGrokCacheHeaders(headers, second)
require.Equal(t, second, headers.Get(grokConversationIDHeader))
require.NotContains(t, string(patched), rawSession)
}
func TestResolveGrokCacheIdentityPrefersClaudeCodeSession(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(701)
c.Request.Header.Set(claudeCodeSessionHeader, "cc-session-abc")
c.Request.Header.Set("session_id", "session-key")
body1 := []byte(`{"model":"grok","input":"turn-1"}`)
body2 := []byte(`{"model":"grok","input":"turn-2-different-user-text"}`)
first := resolveGrokCacheIdentity(c, body1, "", "grok-4.5")
second := resolveGrokCacheIdentity(c, body2, "unrelated-explicit", "grok-4.5")
require.NotEmpty(t, first)
require.Equal(t, first, second, "same Claude Code session must keep stable Grok cache identity across turns")
// metadata.user_id JSON form used by Claude Code clients
metaBody := []byte(`{"model":"grok","metadata":{"user_id":"{\"session_id\":\"meta-session-xyz\"}"},"input":"hi"}`)
metaOnly := newGrokCacheTestContext(702)
metaID := resolveGrokCacheIdentity(metaOnly, metaBody, "", "grok-4.5")
require.NotEmpty(t, metaID)
metaBody2 := []byte(`{"model":"grok","metadata":{"user_id":"{\"session_id\":\"meta-session-xyz\"}"},"input":"later turn"}`)
require.Equal(t, metaID, resolveGrokCacheIdentity(metaOnly, metaBody2, "", "grok-4.5"))
}
func TestResolveGrokCacheIdentityFailsClosedWithoutAPIKeyContext(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(0)
c.Request.Header.Set(grokConversationIDHeader, "native-session")
require.Empty(t, resolveGrokCacheIdentity(c, []byte(`{"model":"grok","input":"hi"}`), "", "grok-4.5"))
require.Empty(t, resolveGrokCacheIdentity(nil, []byte(`{"model":"grok","prompt_cache_key":"key"}`), "key", "grok-4.5"))
}
func TestGrokConversationHeaderIsScopedToGrokRequestScheduling(t *testing.T) {
gin.SetMode(gin.TestMode)
body := []byte(`{"model":"grok","prompt_cache_key":"body-session","input":"hi"}`)
grokContext := newGrokCacheTestContext(601)
grokContext.Request.Header.Set(grokConversationIDHeader, "native-grok-session")
require.Equal(t, "native-grok-session", (&OpenAIGatewayService{}).ExtractSessionID(grokContext, body))
openAIContext := newGrokCacheTestContext(601)
openAIContext.Set("api_key", &APIKey{ID: 601, Group: &Group{Platform: PlatformOpenAI}})
openAIContext.Request.Header.Set(grokConversationIDHeader, "must-be-ignored")
require.Equal(t, "body-session", (&OpenAIGatewayService{}).ExtractSessionID(openAIContext, body))
withoutGrokHeader := newGrokCacheTestContext(601)
withoutGrokHeader.Set("api_key", &APIKey{ID: 601, Group: &Group{Platform: PlatformOpenAI}})
require.Equal(t,
(&OpenAIGatewayService{}).GenerateSessionHash(withoutGrokHeader, body),
(&OpenAIGatewayService{}).GenerateSessionHash(openAIContext, body),
)
}
func TestApplyGrokCacheIdentityWritesResponsesBodyAndHeader(t *testing.T) {
sourceBody := []byte(`{"model":"grok-4.5","prompt_cache_key":"raw-client-key"}`)
body, err := applyGrokResponsesCacheIdentity(sourceBody, sourceBody, "isolated-id", true)
require.NoError(t, err)
require.Equal(t, "isolated-id", gjson.GetBytes(body, "prompt_cache_key").String())
require.Equal(t, "web_search", gjson.GetBytes(body, "tools.0.type").String())
require.Equal(t, "x_search", gjson.GetBytes(body, "tools.1.type").String())
require.Equal(t, grokFreeCacheDisabledToolChoice, gjson.GetBytes(body, "tool_choice").String())
headers := make(http.Header)
headers.Set(grokConversationIDHeader, "spoofed-client-value")
applyGrokCacheHeaders(headers, "isolated-id")
require.Equal(t, "isolated-id", headers.Get(grokConversationIDHeader))
applyGrokCacheHeaders(headers, "")
require.Empty(t, headers.Get(grokConversationIDHeader))
chatBody, err := stripGrokChatPromptCacheKey(body)
require.NoError(t, err)
require.False(t, gjson.GetBytes(chatBody, "prompt_cache_key").Exists())
unscopedSourceBody := []byte(`{"model":"grok","prompt_cache_key":"raw-client-key"}`)
unscopedBody, err := applyGrokResponsesCacheIdentity(unscopedSourceBody, unscopedSourceBody, "", true)
require.NoError(t, err)
require.False(t, gjson.GetBytes(unscopedBody, "prompt_cache_key").Exists())
require.False(t, gjson.GetBytes(unscopedBody, "tools").Exists())
require.False(t, gjson.GetBytes(unscopedBody, "tool_choice").Exists())
}
func TestGrokFreeMessagesClientToolCacheDefaultsOnForKnownFree(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(901, "access-token")
account.Credentials["subscription_tier"] = " FREE "
tests := []struct {
name string
toolChoiceJSON string
wantChoice bool
}{
{name: "missing tool choice"},
{name: "automatic tool choice", toolChoiceJSON: `,"tool_choice":"auto"`, wantChoice: true},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"lookup","description":"look up a value","parameters":{"type":"object"}},{"type":"function","name":"save","parameters":{"type":"object"}}]` + tt.toolChoiceJSON + `}`)
body, err := applyGrokResponsesCacheIdentity(intentBody, intentBody, "isolated-id", true)
require.NoError(t, err)
body, err = applyGrokFreeMessagesFunctionToolCacheRoute(body, intentBody, account, "isolated-id")
require.NoError(t, err)
require.Equal(t, "isolated-id", gjson.GetBytes(body, "prompt_cache_key").String())
tools := gjson.GetBytes(body, "tools").Array()
require.Len(t, tools, 4)
require.Equal(t, "function", tools[0].Get("type").String())
require.Equal(t, "lookup", tools[0].Get("name").String())
require.Equal(t, "function", tools[1].Get("type").String())
require.Equal(t, "save", tools[1].Get("name").String())
require.Equal(t, "web_search", tools[2].Get("type").String())
require.Equal(t, "x_search", tools[3].Get("type").String())
require.Equal(t, tt.wantChoice, gjson.GetBytes(body, "tool_choice").Exists())
})
}
}
func TestGrokFreeMessagesClientToolCacheDefaultsWithMissingAccountSetting(t *testing.T) {
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
tests := []struct {
name string
extra map[string]any
}{
{name: "nil extra"},
{name: "empty extra", extra: map[string]any{}},
{name: "unrelated extra", extra: map[string]any{"other_setting": true}},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90101, "access-token")
account.Credentials["subscription_tier"] = "free"
account.Extra = tt.extra
patched, err := applyGrokFreeMessagesFunctionToolCacheRoute(body, body, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(patched, "tools").Array()
require.Len(t, tools, 3)
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
})
}
}
func TestApplyGrokCacheIdentityAppendsNativeToolsWhenSearchPresent(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(901, "access-token")
account.Credentials["subscription_tier"] = " FREE "
// Function tools INCLUDING web_search → convert + complement with x_search.
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"lookup","description":"look up a value","parameters":{"type":"object"}},{"type":"function","name":"web_search","description":"search","parameters":{"type":"object"}}]}`)
body, err := applyGrokResponsesCacheIdentity(intentBody, intentBody, "isolated-id", true)
require.NoError(t, err)
body, err = applyGrokFreeMessagesFunctionToolCacheRoute(body, intentBody, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(body, "tools").Array()
require.Len(t, tools, 3, "lookup(function) + web_search(native) + x_search(native)")
require.Equal(t, "function", tools[0].Get("type").String())
require.Equal(t, "lookup", tools[0].Get("name").String())
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
}
func TestGrokFreeClientToolCacheAccountOptIn(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(9011, "access-token")
account.Credentials["subscription_tier"] = "free"
account.Extra = map[string]any{grokClientToolCacheOptInExtraKey: true}
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}},{"type":"function","name":"read_file","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
body, err := applyGrokResponsesCacheIdentity(intentBody, intentBody, "isolated-id", true)
require.NoError(t, err)
body, err = applyGrokFreeMessagesFunctionToolCacheRoute(body, intentBody, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(body, "tools").Array()
require.Len(t, tools, 4)
require.Equal(t, "view_image", tools[0].Get("name").String())
require.Equal(t, "read_file", tools[1].Get("name").String())
require.Equal(t, "web_search", tools[2].Get("type").String())
require.Equal(t, "x_search", tools[3].Get("type").String())
}
func TestGrokFreeMessagesClientToolCacheAccountOptOut(t *testing.T) {
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
tests := []struct {
name string
value any
}{
{name: "explicit false", value: false},
{name: "string false is malformed", value: "false"},
{name: "numeric value is malformed", value: 1},
{name: "null value is malformed", value: nil},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90111, "access-token")
account.Credentials["subscription_tier"] = "free"
account.Extra = map[string]any{grokClientToolCacheOptInExtraKey: tt.value}
patched, err := applyGrokFreeMessagesFunctionToolCacheRoute(body, body, account, "isolated-id")
require.NoError(t, err)
require.JSONEq(t, string(body), string(patched))
})
}
}
func TestGrokFreeClientToolCacheRequestOptInOverridesAccountOptOut(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(9014, "access-token")
account.Credentials["subscription_tier"] = "free"
account.Extra = map[string]any{grokClientToolCacheOptInExtraKey: false}
c := newGrokCacheTestContext(9014)
c.Request.Header.Set(grokClientToolCacheOptInHeader, "prefer-cache")
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
body, err := applyGrokResponsesCacheIdentity(intentBody, intentBody, "isolated-id", true)
require.NoError(t, err)
body, err = applyGrokFreeRequestToolCacheRoute(c, body, intentBody, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(body, "tools").Array()
require.Len(t, tools, 3)
require.Equal(t, "view_image", tools[0].Get("name").String())
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
}
func TestGrokFreeChatRequestClientToolCacheDefaultsOnWithoutClientFingerprint(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90140, "access-token")
account.Credentials["subscription_tier"] = "free"
c := newGrokCacheTestContext(90140)
c.Request.URL.Path = "/v1/chat/completions"
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(patched, "tools").Array()
require.Len(t, tools, 3)
require.Equal(t, "view_image", tools[0].Get("name").String())
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
}
func TestGrokFreeClientToolCacheClaudeDesktopResponsesAutoOptIn(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90141, "access-token")
account.Credentials["subscription_tier"] = "free"
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"Read","parameters":{"type":"object"}},{"type":"function","name":"Edit","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
for _, xApp := range []string{"cli", "cli-bg"} {
t.Run(xApp, func(t *testing.T) {
c := newGrokCacheTestContext(90141)
// The desktop marker text is intentionally not required; CC Switch and
// Claude Desktop may change the descriptive User-Agent suffix.
c.Request.Header.Set("User-Agent", "claude-cli/2.1.215 (external, future-desktop, agent-sdk/0.3.215)")
c.Request.Header.Set("X-App", xApp)
c.Request.Header.Set("anthropic-client-platform", "desktop_app")
c.Request.Header.Set("X-Claude-Code-Session-Id", "desktop-session-1")
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(patched, "tools").Array()
require.Len(t, tools, 4)
require.Equal(t, "Read", tools[0].Get("name").String())
require.Equal(t, "Edit", tools[1].Get("name").String())
require.Equal(t, "web_search", tools[2].Get("type").String())
require.Equal(t, "x_search", tools[3].Get("type").String())
})
}
}
func TestGrokFreeClientToolCacheClaudeDesktopFingerprintRequiresAllSignals(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90142, "access-token")
account.Credentials["subscription_tier"] = "free"
account.Extra = map[string]any{grokClientToolCacheOptInExtraKey: false}
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"Read","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
tests := []struct {
name string
path string
ua string
xApp string
platform string
session string
}{
{
name: "chat path",
path: "/v1/chat/completions",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
xApp: "cli",
platform: "desktop_app",
session: "desktop-session-1",
},
{
name: "compact responses path",
path: "/v1/responses/compact",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
xApp: "cli",
platform: "desktop_app",
session: "desktop-session-1",
},
{
name: "non claude cli user agent",
path: "/v1/responses",
ua: "Mozilla/5.0 (claude-desktop-3p)",
xApp: "cli",
platform: "desktop_app",
session: "desktop-session-1",
},
{
name: "missing x app",
path: "/v1/responses",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
platform: "desktop_app",
session: "desktop-session-1",
},
{
name: "wrong x app",
path: "/v1/responses",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
xApp: "desktop",
platform: "desktop_app",
session: "desktop-session-1",
},
{
name: "missing client platform",
path: "/v1/responses",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
xApp: "cli",
session: "desktop-session-1",
},
{
name: "wrong client platform",
path: "/v1/responses",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
xApp: "cli",
platform: "web",
session: "desktop-session-1",
},
{
name: "missing session header",
path: "/v1/responses",
ua: "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)",
xApp: "cli",
platform: "desktop_app",
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
c := newGrokCacheTestContext(90142)
c.Request.URL.Path = tt.path
if tt.ua != "" {
c.Request.Header.Set("User-Agent", tt.ua)
}
if tt.xApp != "" {
c.Request.Header.Set("X-App", tt.xApp)
}
if tt.platform != "" {
c.Request.Header.Set("anthropic-client-platform", tt.platform)
}
if tt.session != "" {
c.Request.Header.Set("X-Claude-Code-Session-Id", tt.session)
}
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
require.JSONEq(t, string(body), string(patched))
})
}
}
func TestGrokFreeClientToolCacheExplicitRequestOptOut(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90144, "access-token")
account.Credentials["subscription_tier"] = "free"
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"Read","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
for _, value := range []string{"0", "false", "no", "off"} {
t.Run(value, func(t *testing.T) {
c := newGrokCacheTestContext(90144)
c.Request.URL.Path = "/v1/chat/completions"
c.Request.Header.Set(grokClientToolCacheOptInHeader, value)
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
require.JSONEq(t, string(body), string(patched))
})
}
}
func TestGrokFreeClientToolCacheClaudeDesktopAutoOptInDoesNotOverridePaidTier(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(90143, "access-token")
account.Credentials["subscription_tier"] = "supergrok"
c := newGrokCacheTestContext(90143)
c.Request.Header.Set("User-Agent", "claude-cli/2.1.215 (external, claude-desktop-3p, agent-sdk/0.3.215)")
c.Request.Header.Set("X-App", "cli")
c.Request.Header.Set("anthropic-client-platform", "desktop_app")
c.Request.Header.Set("X-Claude-Code-Session-Id", "desktop-session-1")
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"Read","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
require.JSONEq(t, string(body), string(patched))
}
func TestGrokFreeRequestClientSearchFunctionUsesDefaultAccountPolicy(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(9015, "access-token")
account.Credentials["subscription_tier"] = "free"
c := newGrokCacheTestContext(9015)
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}},{"type":"function","name":"web_search","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(patched, "tools").Array()
require.Len(t, tools, 3)
require.Equal(t, "view_image", tools[0].Get("name").String())
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
}
func TestGrokFreeRequestToolChoiceNoneUsesSafeCacheRoute(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(9016, "access-token")
account.Credentials["subscription_tier"] = "free"
c := newGrokCacheTestContext(9016)
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}}],"tool_choice":"none"}`)
patched, err := applyGrokFreeRequestToolCacheRoute(c, body, body, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(patched, "tools").Array()
require.Len(t, tools, 3)
require.Equal(t, "view_image", tools[0].Get("name").String())
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
require.Equal(t, "none", gjson.GetBytes(patched, "tool_choice").String())
}
func TestApplyGrokCacheIdentityRecognizesResponsesLiteAdditionalTools(t *testing.T) {
intentBody := []byte(`{"model":"grok","input":[{"type":"additional_tools","tools":[{"type":"function","name":"lookup","parameters":{"type":"object"}}]},{"type":"message","role":"user","content":"hello"}]}`)
patchedBody := []byte(`{"model":"grok-4.5","tools":[{"type":"function","name":"lookup","parameters":{"type":"object"}}],"input":[{"type":"message","role":"user","content":"hello"}]}`)
patched, err := applyGrokResponsesCacheIdentity(patchedBody, intentBody, "isolated-id", true)
require.NoError(t, err)
tools := gjson.GetBytes(patched, "tools").Array()
require.Len(t, tools, 1)
require.Equal(t, "lookup", tools[0].Get("name").String())
require.False(t, gjson.GetBytes(patched, "tool_choice").Exists())
require.Equal(t, "isolated-id", gjson.GetBytes(patched, "prompt_cache_key").String())
}
func TestGrokFreeCacheRoutePreservesMixedSupportedToolsWithSearchIntent(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(9012, "access-token")
account.Credentials["subscription_tier"] = "free"
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}},{"type":"shell"},{"type":"web_search"}],"tool_choice":"auto"}`)
body, err := applyGrokResponsesCacheIdentity(intentBody, intentBody, "isolated-id", true)
require.NoError(t, err)
body, err = applyGrokFreeMessagesFunctionToolCacheRoute(body, intentBody, account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(body, "tools").Array()
require.Len(t, tools, 4)
require.Equal(t, "function", tools[0].Get("type").String())
require.Equal(t, "shell", tools[1].Get("type").String())
require.Equal(t, "web_search", tools[2].Get("type").String())
require.Equal(t, "x_search", tools[3].Get("type").String())
}
func TestGrokClientToolCacheOptInDoesNotOverridePaidTier(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(9013, "access-token")
account.Credentials["subscription_tier"] = "supergrok"
account.Extra = map[string]any{grokClientToolCacheOptInExtraKey: true}
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"view_image","parameters":{"type":"object"}}],"tool_choice":"auto"}`)
patched, err := applyGrokFreeMessagesFunctionToolCacheRoute(body, body, account, "isolated-id")
require.NoError(t, err)
require.JSONEq(t, string(body), string(patched))
}
func TestApplyGrokCacheIdentityRequiresPatchedFunctionTools(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(902, "access-token")
account.Credentials["subscription_tier"] = "free"
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"lookup"}],"tool_choice":"auto"}`)
tests := []struct {
name string
patchedBody string
}{
{name: "missing tools", patchedBody: `{"model":"grok-4.5"}`},
{name: "empty tools", patchedBody: `{"model":"grok-4.5","tools":[]}`},
{name: "native tools only", patchedBody: `{"model":"grok-4.5","tools":[{"type":"web_search"}]}`},
{name: "unexpected patched tool", patchedBody: `{"model":"grok-4.5","tools":[{"type":"function","name":"lookup"},{"type":"namespace","name":"server"}]}`},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
beforeTools := gjson.Get(tt.patchedBody, "tools")
body, err := applyGrokResponsesCacheIdentity([]byte(tt.patchedBody), intentBody, "isolated-id", true)
require.NoError(t, err)
body, err = applyGrokFreeMessagesFunctionToolCacheRoute(body, intentBody, account, "isolated-id")
require.NoError(t, err)
require.Equal(t, "isolated-id", gjson.GetBytes(body, "prompt_cache_key").String())
afterTools := gjson.GetBytes(body, "tools")
require.Equal(t, beforeTools.Exists(), afterTools.Exists())
require.Equal(t, beforeTools.Raw, afterTools.Raw)
})
}
}
func TestGrokFreeMessagesFunctionToolCacheRouteRequiresKnownFreeTier(t *testing.T) {
// Include web_search as a function to also cover its conversion to a native tool.
intentBody := []byte(`{"model":"grok","tools":[{"type":"function","name":"lookup"},{"type":"function","name":"web_search"}],"tool_choice":"auto"}`)
tests := []struct {
name string
account *Account
wantMix bool
}{
{
name: "free credential tier",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(910, "access-token")
a.Credentials["subscription_tier"] = "free"
return a
}(),
wantMix: true,
},
{
name: "free billing tier",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(911, "access-token")
a.Extra = map[string]any{grokBillingExtraKey: map[string]any{"plan": "FREE"}}
return a
}(),
wantMix: true,
},
{
name: "free successful billing has blank plan",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(9111, "access-token")
a.Extra = map[string]any{grokBillingExtraKey: map[string]any{
"status_code": http.StatusOK,
"source": "billing_probe",
"monthly_updated_at": "2026-07-15T05:00:00Z",
}}
return a
}(),
wantMix: true,
},
{
name: "free rolling token quota",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(9112, "access-token")
a.Extra = map[string]any{grokQuotaSnapshotExtraKey: map[string]any{
"headers_observed": true,
"tokens": map[string]any{"limit": xai.GrokFreeRolling24hTokenLimit},
}}
return a
}(),
wantMix: true,
},
{
name: "legacy free rolling token quota",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(9113, "access-token")
a.Extra = map[string]any{grokQuotaSnapshotExtraKey: map[string]any{
"headers_observed": true,
"tokens": map[string]any{"limit": int64(2_000_000)},
}}
return a
}(),
wantMix: true,
},
{
name: "supergrok remains unchanged",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(912, "access-token")
a.Credentials["subscription_tier"] = "supergrok"
return a
}(),
},
{
name: "paid billing overrides stale free quota",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(9121, "access-token")
a.Extra = map[string]any{
grokBillingExtraKey: map[string]any{"plan": "SuperGrok", "status_code": http.StatusOK},
grokQuotaSnapshotExtraKey: map[string]any{
"headers_observed": true,
"tokens": map[string]any{"limit": int64(2_000_000)},
},
}
return a
}(),
},
{
name: "paid billing overrides stale free credentials",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(9123, "access-token")
a.Credentials["subscription_tier"] = "free"
a.Extra = map[string]any{
grokBillingExtraKey: map[string]any{"plan": "SuperGrok", "status_code": http.StatusOK},
}
return a
}(),
},
{
name: "partial billing without monthly evidence remains unknown",
account: func() *Account {
a := healthyGrokOAuthGatewayTestAccount(9122, "access-token")
a.Extra = map[string]any{grokBillingExtraKey: map[string]any{
"status_code": http.StatusOK,
"source": "billing_probe",
"partial": true,
"failed_windows": []string{"monthly"},
}}
return a
}(),
},
{
name: "unknown tier remains unchanged",
account: healthyGrokOAuthGatewayTestAccount(913, "access-token"),
},
{
name: "api key remains unchanged",
account: &Account{
ID: 914,
Platform: PlatformGrok,
Type: AccountTypeAPIKey,
},
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
body, err := applyGrokFreeMessagesFunctionToolCacheRoute(intentBody, intentBody, tt.account, "isolated-id")
require.NoError(t, err)
tools := gjson.GetBytes(body, "tools").Array()
if tt.wantMix {
require.Len(t, tools, 3)
require.Equal(t, "web_search", tools[1].Get("type").String())
require.Equal(t, "x_search", tools[2].Get("type").String())
return
}
require.Len(t, tools, 2, "non-free accounts should not get native search injected")
})
}
}
func TestGrokFreeMessagesFunctionToolCacheRouteRequiresIdentity(t *testing.T) {
account := healthyGrokOAuthGatewayTestAccount(915, "access-token")
account.Credentials["subscription_tier"] = "free"
body := []byte(`{"model":"grok","tools":[{"type":"function","name":"lookup"}],"tool_choice":"auto"}`)
patched, err := applyGrokFreeMessagesFunctionToolCacheRoute(body, body, account, "")
require.NoError(t, err)
require.JSONEq(t, string(body), string(patched))
require.Len(t, gjson.GetBytes(patched, "tools").Array(), 1)
}
func TestApplyGrokCacheIdentityPreservesIneligibleClientToolFields(t *testing.T) {
tests := []struct {
name string
body string
}{
{
name: "empty tools array",
body: `{"model":"grok","tools":[]}`,
},
{
name: "null tools",
body: `{"model":"grok","tools":null}`,
},
{
name: "tool choice only",
body: `{"model":"grok","tool_choice":{"type":"function","name":"lookup"}}`,
},
{
name: "null tool choice",
body: `{"model":"grok","tool_choice":null}`,
},
{
name: "native tool with auto choice",
body: `{"model":"grok","tools":[{"type":"web_search"}],"tool_choice":"auto"}`,
},
{
name: "function with required choice",
body: `{"model":"grok","tools":[{"type":"function","name":"lookup"}],"tool_choice":"required"}`,
},
{
name: "function with none choice",
body: `{"model":"grok","tools":[{"type":"function","name":"lookup"}],"tool_choice":"none"}`,
},
{
name: "function with specific choice",
body: `{"model":"grok","tools":[{"type":"function","name":"lookup"}],"tool_choice":{"type":"function","name":"lookup"}}`,
},
{
name: "function with object auto choice",
body: `{"model":"grok","tools":[{"type":"function","name":"lookup"}],"tool_choice":{"type":"auto"}}`,
},
{
name: "function mixed with unsupported tool",
body: `{"model":"grok","tools":[{"type":"function","name":"lookup"},{"type":"namespace","name":"client_tools"}],"tool_choice":"auto"}`,
},
{
name: "unsupported tool only",
body: `{"model":"grok","tools":[{"type":"namespace","name":"client_tools"}]}`,
},
{
name: "chat completions function shape",
body: `{"model":"grok","tools":[{"type":"function","function":{"name":"lookup","parameters":{"type":"object"}}}],"tool_choice":"auto"}`,
},
{
name: "incomplete responses function",
body: `{"model":"grok","tools":[{"type":"function","parameters":{"type":"object"}}]}`,
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
beforeTools := gjson.Get(tt.body, "tools")
beforeChoice := gjson.Get(tt.body, "tool_choice")
body, err := applyGrokResponsesCacheIdentity([]byte(tt.body), []byte(tt.body), "isolated-id", true)
require.NoError(t, err)
require.Equal(t, "isolated-id", gjson.GetBytes(body, "prompt_cache_key").String())
require.Equal(t, beforeTools.Exists(), gjson.GetBytes(body, "tools").Exists())
require.Equal(t, beforeTools.Raw, gjson.GetBytes(body, "tools").Raw)
require.Equal(t, beforeChoice.Exists(), gjson.GetBytes(body, "tool_choice").Exists())
require.Equal(t, beforeChoice.Raw, gjson.GetBytes(body, "tool_choice").Raw)
})
}
}
func TestApplyGrokCacheIdentityUsesPreSanitizationToolIntent(t *testing.T) {
tests := []struct {
name string
intentBody string
}{
{
name: "unsupported tools removed by sanitizer",
intentBody: `{"model":"grok","tools":[{"type":"namespace","name":"client_tools"}]}`,
},
{
name: "tool choice removed with unsupported tool",
intentBody: `{"model":"grok","tools":[{"type":"namespace","name":"client_tools"}],"tool_choice":{"type":"namespace","name":"client_tools"}}`,
},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
// This is the shape apply receives after patchGrokResponsesBody has
// removed unsupported tools and their associated tool_choice.
patchedBody := []byte(`{"model":"grok-4.5","input":"hello"}`)
body, err := applyGrokResponsesCacheIdentity(patchedBody, []byte(tt.intentBody), "isolated-id", true)
require.NoError(t, err)
require.Equal(t, "isolated-id", gjson.GetBytes(body, "prompt_cache_key").String())
require.False(t, gjson.GetBytes(body, "tools").Exists())
require.False(t, gjson.GetBytes(body, "tool_choice").Exists())
})
}
}
func TestApplyGrokCacheIdentityWithoutFreeTierRoutingOnlyWritesIdentity(t *testing.T) {
sourceBody := []byte(`{"model":"grok-4.5","input":"hello"}`)
body, err := applyGrokResponsesCacheIdentity(sourceBody, sourceBody, "isolated-id", false)
require.NoError(t, err)
require.Equal(t, "isolated-id", gjson.GetBytes(body, "prompt_cache_key").String())
require.False(t, gjson.GetBytes(body, "tools").Exists())
require.False(t, gjson.GetBytes(body, "tool_choice").Exists())
}
func TestGrokCompactRequestSkipsCacheIdentityAndNativeTools(t *testing.T) {
gin.SetMode(gin.TestMode)
c := newGrokCacheTestContext(701)
c.Request = httptest.NewRequest(http.MethodPost, "/v1/responses/compact", nil)
body := []byte(`{"model":"grok","input":"compact this","prompt_cache_key":"raw-client-key"}`)
identity := resolveGrokCacheIdentity(c, body, "", "grok-4.5")
patched, err := applyGrokResponsesCacheIdentity(body, body, identity, true)
require.NoError(t, err)
require.Empty(t, identity)
require.False(t, gjson.GetBytes(patched, "prompt_cache_key").Exists())
require.False(t, gjson.GetBytes(patched, "tools").Exists())
require.False(t, gjson.GetBytes(patched, "tool_choice").Exists())
}
func TestResolveGrokCacheIdentityConcurrentDeterminism(t *testing.T) {
gin.SetMode(gin.TestMode)
const workers = 50
body := []byte(`{"model":"grok","messages":[{"role":"system","content":"stable"},{"role":"user","content":"hello"}]}`)
identities := make(chan string, workers)
var wg sync.WaitGroup
for i := 0; i < workers; i++ {
wg.Add(1)
go func() {
defer wg.Done()
identities <- resolveGrokCacheIdentity(newGrokCacheTestContext(501), body, "", "grok-4.5")
}()
}
wg.Wait()
close(identities)
var first string
for identity := range identities {
if first == "" {
first = identity
}
require.Equal(t, first, identity)
}
require.NotEmpty(t, first)
}