Documentation
¶
Index ¶
- Constants
- func AlignClaudeToolResults(content gjson.Result, toolUseIDs []string) gjson.Result
- func AntigravityToolNameToUpstream(name string) string
- func AntigravityUpstreamToolNameToClient(name string) string
- func AppendSSEEventBytes(out []byte, event string, payload []byte, trailingNewlines int) []byte
- func AppendSSEEventString(out []byte, event, payload string, trailingNewlines int) []byte
- func AttachCacheControl(dst []byte, src gjson.Result) []byte
- func AttachMessageCacheControl(msg []byte, src gjson.Result) []byte
- func ClaudeInputTokensJSON(count int64) []byte
- func ClaudeMessageSystemReminderText(content gjson.Result) (string, bool)
- func ContentHasGeminiFunctionResponse(content []byte) bool
- func DeriveClaudeUserID(rawJSON []byte) string
- func GeminiTokenCountJSON(count int64) []byte
- func GenerateClaudeToolCallID() string
- func InteractionsUsage(root gjson.Result) gjson.Result
- func IsGeminiThoughtPart(part gjson.Result) bool
- func JoinRawArray(items [][]byte) []byte
- func MergeAdjacentGeminiContents(contents [][]byte) [][]byte
- func MergeAdjacentGeminiUserContents(contents [][]byte) [][]byte
- func NewRawArrayItems(capacity int64) [][]byte
- func NormalizeOpenAIFileData(filename, fallbackMIMEType, fileData string) (mimeType, data string, ok bool)
- func RequestModelName(originalRequestRawJSON, requestRawJSON []byte) string
- func SSEEventData(event string, payload []byte) []byte
- func SetRawArrayItems(data []byte, path string, items [][]byte) []byte
- func SetResponsesToolCallIdentity(item []byte, name, namespace, itemPath string) []byte
- type ClaudeMessageAccumulator
Constants ¶
const ExternalToolPrefix = "external_"
Antigravity agents (Interactions API) ship intrinsic sandbox tools such as read_file / write_file / execute_code. When a client-defined function re-declares one of those names, Google returns 500 "Unknown Error". The proxy therefore renames colliding client tools with the ExternalToolPrefix on the way upstream and strips the prefix again on every response path, so the client keeps seeing its original names.
Variables ¶
This section is empty.
Functions ¶
func AlignClaudeToolResults ¶ added in v7.2.142
AlignClaudeToolResults orders tool_result blocks by the preceding tool_use IDs, preserving non-result content blocks at their existing indexes. If a complete one-to-one match is unavailable, the original content is returned.
func AntigravityToolNameToUpstream ¶ added in v7.2.150
AntigravityToolNameToUpstream maps a client-facing tool name to the name sent to the antigravity Interactions API. Names that do not collide are returned unchanged.
func AntigravityUpstreamToolNameToClient ¶ added in v7.2.150
AntigravityUpstreamToolNameToClient strips the external prefix from an upstream tool name before it reaches the client, provided that the base name is an intrinsic tool that was prefixed to avoid collisions. Non-colliding or non-prefixed names pass through unchanged.
func AppendSSEEventBytes ¶
func AppendSSEEventString ¶
func AttachCacheControl ¶ added in v7.2.55
AttachCacheControl copies a Claude-compatible cache_control object from src onto dst. Returns dst unchanged when cache_control is missing or not an object.
func AttachMessageCacheControl ¶ added in v7.2.55
AttachMessageCacheControl applies message-level cache_control onto the last content block. Part-level cache_control wins when the last block already has one. String content is promoted to a content array so Claude can accept cache_control.
func ClaudeInputTokensJSON ¶
func ClaudeMessageSystemReminderText ¶ added in v7.2.30
ClaudeMessageSystemReminderText converts a Claude message-level system value into ordinary user-visible reminder text for non-Claude upstream formats.
func ContentHasGeminiFunctionResponse ¶ added in v7.2.150
ContentHasGeminiFunctionResponse reports whether a Gemini content turn contains any functionResponse part.
func DeriveClaudeUserID ¶ added in v7.2.140
DeriveClaudeUserID returns a stable value for the Claude request field metadata.user_id. It preserves any caller-supplied metadata.user_id or OpenAI Chat Completions user field, then derives a deterministic value from stable client signals (prompt_cache_key, session_id, conversation_id, first user message content, and model/system instructions). The same conversation therefore gets the same user_id on every worker and every turn, while different conversations get different values.
func GeminiTokenCountJSON ¶
func GenerateClaudeToolCallID ¶ added in v7.2.133
func GenerateClaudeToolCallID() string
GenerateClaudeToolCallID generates a random tool use ID prefixed with toolu_ using rejection sampling to guarantee a uniform distribution across the 62 alphanumeric characters.
func IsGeminiThoughtPart ¶ added in v7.2.131
IsGeminiThoughtPart reports whether a Gemini part contains hidden model thought.
func JoinRawArray ¶ added in v7.2.89
func MergeAdjacentGeminiContents ¶ added in v7.2.147
MergeAdjacentGeminiContents merges consecutive user Content turns. Mid-conversation system messages in Claude requests are downgraded to user reminder turns. When followed or preceded by other user turns or tool results, their parts are merged into a single user turn. Consecutive model turns are strictly kept unmerged to avoid shifting part indices and breaking cryptographic thought signatures and reasoning replay.
func MergeAdjacentGeminiUserContents ¶ added in v7.2.150
MergeAdjacentGeminiUserContents merges consecutive user Content turns, but leaves turns containing functionResponse unmerged to preserve tool-call/response boundaries.
func NewRawArrayItems ¶ added in v7.2.89
NewRawArrayItems creates a raw item slice sized for the expected input.
func NormalizeOpenAIFileData ¶ added in v7.2.90
func NormalizeOpenAIFileData(filename, fallbackMIMEType, fileData string) (mimeType, data string, ok bool)
NormalizeOpenAIFileData returns the MIME type and raw base64 payload for OpenAI file content.
func RequestModelName ¶ added in v7.2.117
RequestModelName returns the model name from the original request, falling back to the translated request when the original request is unavailable.
func SSEEventData ¶
func SetRawArrayItems ¶ added in v7.2.89
SetRawArrayItems replaces an empty JSON array at path with raw items. The single-item path avoids allocating an intermediate joined array.
func SetResponsesToolCallIdentity ¶ added in v7.2.126
SetResponsesToolCallIdentity writes a resolved Responses tool name and namespace.
Types ¶
type ClaudeMessageAccumulator ¶ added in v7.2.121
type ClaudeMessageAccumulator struct {
// contains filtered or unexported fields
}
ClaudeMessageAccumulator groups consecutive Claude messages by role.
func NewClaudeMessageAccumulator ¶ added in v7.2.121
func NewClaudeMessageAccumulator(capacity int) *ClaudeMessageAccumulator
NewClaudeMessageAccumulator creates an accumulator sized for the expected messages.
func (*ClaudeMessageAccumulator) Append ¶ added in v7.2.121
func (a *ClaudeMessageAccumulator) Append(message []byte)
Append adds one Claude-shaped message to the current role turn.
func (*ClaudeMessageAccumulator) Flush ¶ added in v7.2.121
func (a *ClaudeMessageAccumulator) Flush()
Flush closes the current role turn while keeping accumulated messages.
func (*ClaudeMessageAccumulator) Messages ¶ added in v7.2.121
func (a *ClaudeMessageAccumulator) Messages() [][]byte
Messages flushes the final turn and returns all accumulated messages.