cache

package
v7.2.33 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jun 23, 2026 License: MIT Imports: 15 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	// AntigravityReasoningReplayCacheTTL limits how long encrypted reasoning replay
	// items stay in process memory.
	AntigravityReasoningReplayCacheTTL = 1 * time.Hour

	// AntigravityReasoningReplayCacheMaxEntries bounds process memory for replay
	// continuity. Oldest entries are evicted first.
	AntigravityReasoningReplayCacheMaxEntries = 10240

	// AntigravityReasoningReplayCacheEvictBatchSize leaves headroom after the cache
	// reaches capacity so high write volume does not rescan the map every turn.
	AntigravityReasoningReplayCacheEvictBatchSize = 128
)
View Source 
const (
	// CodexReasoningReplayCacheTTL limits how long encrypted reasoning replay
	// items stay in process memory.
	CodexReasoningReplayCacheTTL = 1 * time.Hour

	// CodexReasoningReplayCacheMaxEntries bounds process memory for replay
	// continuity. Oldest entries are evicted first.
	CodexReasoningReplayCacheMaxEntries = 10240

	// CodexReasoningReplayCacheEvictBatchSize leaves headroom after the cache
	// reaches capacity so high write volume does not rescan the map every turn.
	CodexReasoningReplayCacheEvictBatchSize = 128
)
View Source 
const (
	// SignatureCacheTTL is how long signatures are valid
	SignatureCacheTTL = 3 * time.Hour

	// SignatureTextHashLen is the length of the hash key (16 hex chars = 64-bit key space)
	SignatureTextHashLen = 16

	// MinValidSignatureLen is the minimum length for a signature to be considered valid
	MinValidSignatureLen = 50

	// CacheCleanupInterval controls how often stale entries are purged
	CacheCleanupInterval = 10 * time.Minute
)
View Source 
const (
	// XAIReasoningReplayCacheTTL limits how long encrypted reasoning replay
	// items stay in process memory.
	XAIReasoningReplayCacheTTL = 1 * time.Hour

	// XAIReasoningReplayCacheMaxEntries bounds process memory for replay
	// continuity. Oldest entries are evicted first.
	XAIReasoningReplayCacheMaxEntries = 10240

	// XAIReasoningReplayCacheEvictBatchSize leaves headroom after the cache
	// reaches capacity so high write volume does not rescan the map every turn.
	XAIReasoningReplayCacheEvictBatchSize = 128
)

Variables

This section is empty.

Functions

func CacheAntigravityReasoningReplayItem added in v7.2.23 

func CacheAntigravityReasoningReplayItem(modelName, sessionKey string, item []byte) bool

CacheAntigravityReasoningReplayItem stores a final GPT/Codex reasoning item for stateless replay. The stored item is normalized to the minimal shape accepted by Responses input replay.

func CacheAntigravityReasoningReplayItems added in v7.2.23 

func CacheAntigravityReasoningReplayItems(modelName, sessionKey string, items [][]byte) bool

CacheAntigravityReasoningReplayItems stores the final GPT/Codex assistant output items needed to replay a stateless next turn.

func CacheAntigravityReasoningReplayItemsBestEffort added in v7.2.23 

func CacheAntigravityReasoningReplayItemsBestEffort(ctx context.Context, modelName, sessionKey string, items [][]byte) bool

CacheAntigravityReasoningReplayItemsBestEffort stores replay items for completed response paths.

func CacheCodexReasoningReplayItem added in v7.1.40 

func CacheCodexReasoningReplayItem(modelName, sessionKey string, item []byte) bool

CacheCodexReasoningReplayItem stores a final GPT/Codex reasoning item for stateless replay. The stored item is normalized to the minimal shape accepted by Responses input replay.

func CacheCodexReasoningReplayItems added in v7.1.40 

func CacheCodexReasoningReplayItems(modelName, sessionKey string, items [][]byte) bool

CacheCodexReasoningReplayItems stores the final GPT/Codex assistant output items needed to replay a stateless next turn.

func CacheCodexReasoningReplayItemsBestEffort added in v7.2.0 

func CacheCodexReasoningReplayItemsBestEffort(ctx context.Context, modelName, sessionKey string, items [][]byte) bool

CacheCodexReasoningReplayItemsBestEffort stores replay items for completed response paths.

func CacheSignature 

func CacheSignature(modelName, text, signature string)

CacheSignature stores a thinking signature for a given model group and text. Used for Claude models that require signed thinking blocks in multi-turn conversations.

func CacheSignatureBestEffort added in v7.2.0 

func CacheSignatureBestEffort(ctx context.Context, modelName, text, signature string) bool

CacheSignatureBestEffort stores a thinking signature for completed response paths.

func CacheXAIReasoningReplayItem added in v7.2.31 

func CacheXAIReasoningReplayItem(modelName, sessionKey string, item []byte) bool

CacheXAIReasoningReplayItem stores a final Grok reasoning item for stateless replay. The stored item is normalized to the minimal shape accepted by Responses input replay.

func CacheXAIReasoningReplayItems added in v7.2.31 

func CacheXAIReasoningReplayItems(modelName, sessionKey string, items [][]byte) bool

CacheXAIReasoningReplayItems stores the final Grok assistant output items needed to replay a stateless next turn.

func CacheXAIReasoningReplayItemsBestEffort added in v7.2.31 

func CacheXAIReasoningReplayItemsBestEffort(ctx context.Context, modelName, sessionKey string, items [][]byte) bool

CacheXAIReasoningReplayItemsBestEffort stores replay items for completed response paths.

func ClearAntigravityReasoningReplayCache added in v7.2.23 

func ClearAntigravityReasoningReplayCache()

ClearAntigravityReasoningReplayCache clears all Antigravity reasoning replay state.

func ClearCodexReasoningReplayCache added in v7.1.40 

func ClearCodexReasoningReplayCache()

ClearCodexReasoningReplayCache clears all Codex reasoning replay state.

func ClearSignatureCache 

func ClearSignatureCache(modelName string)

ClearSignatureCache clears signature cache for a specific model group or all groups.

func ClearXAIReasoningReplayCache added in v7.2.31 

func ClearXAIReasoningReplayCache()

ClearXAIReasoningReplayCache clears all xAI reasoning replay state.

func DeleteAntigravityReasoningReplayItem added in v7.2.23 

func DeleteAntigravityReasoningReplayItem(modelName, sessionKey string)

DeleteAntigravityReasoningReplayItem removes one replay item after upstream rejects it or the caller otherwise knows it is stale.

func DeleteAntigravityReasoningReplayItemRequired added in v7.2.23 

func DeleteAntigravityReasoningReplayItemRequired(ctx context.Context, modelName, sessionKey string) error

DeleteAntigravityReasoningReplayItemRequired removes one replay item for request-time paths.

func DeleteCachedSignatureRequired added in v7.2.0 

func DeleteCachedSignatureRequired(ctx context.Context, modelName, text string) error

DeleteCachedSignatureRequired removes one exact cached signature.

func DeleteCodexReasoningReplayItem added in v7.1.40 

func DeleteCodexReasoningReplayItem(modelName, sessionKey string)

DeleteCodexReasoningReplayItem removes one replay item after upstream rejects it or the caller otherwise knows it is stale.

func DeleteCodexReasoningReplayItemRequired added in v7.2.0 

func DeleteCodexReasoningReplayItemRequired(ctx context.Context, modelName, sessionKey string) error

DeleteCodexReasoningReplayItemRequired removes one replay item for request-time paths.

func DeleteXAIReasoningReplayItem added in v7.2.31 

func DeleteXAIReasoningReplayItem(modelName, sessionKey string)

DeleteXAIReasoningReplayItem removes one replay item after upstream rejects it or the caller otherwise knows it is stale.

func DeleteXAIReasoningReplayItemRequired added in v7.2.31 

func DeleteXAIReasoningReplayItemRequired(ctx context.Context, modelName, sessionKey string) error

DeleteXAIReasoningReplayItemRequired removes one replay item for request-time paths.

func GetAntigravityReasoningReplayItem added in v7.2.23 

func GetAntigravityReasoningReplayItem(modelName, sessionKey string) ([]byte, bool)

GetAntigravityReasoningReplayItem retrieves a normalized reasoning replay item.

func GetAntigravityReasoningReplayItems added in v7.2.23 

func GetAntigravityReasoningReplayItems(modelName, sessionKey string) ([][]byte, bool)

GetAntigravityReasoningReplayItems retrieves normalized assistant output items.

func GetAntigravityReasoningReplayItemsRequired added in v7.2.23 

func GetAntigravityReasoningReplayItemsRequired(ctx context.Context, modelName, sessionKey string) ([][]byte, bool, error)

GetAntigravityReasoningReplayItemsRequired retrieves replay items for request-time paths.

func GetCachedSignature 

func GetCachedSignature(modelName, text string) string

GetCachedSignature retrieves a cached signature for a given model group and text. Returns empty string if not found or expired.

func GetCachedSignatureRequired added in v7.2.0 

func GetCachedSignatureRequired(ctx context.Context, modelName, text string) (string, error)

GetCachedSignatureRequired retrieves a cached signature for request-time paths.

func GetCodexReasoningReplayItem added in v7.1.40 

func GetCodexReasoningReplayItem(modelName, sessionKey string) ([]byte, bool)

GetCodexReasoningReplayItem retrieves a normalized reasoning replay item.

func GetCodexReasoningReplayItems added in v7.1.40 

func GetCodexReasoningReplayItems(modelName, sessionKey string) ([][]byte, bool)

GetCodexReasoningReplayItems retrieves normalized assistant output items.

func GetCodexReasoningReplayItemsRequired added in v7.2.0 

func GetCodexReasoningReplayItemsRequired(ctx context.Context, modelName, sessionKey string) ([][]byte, bool, error)

GetCodexReasoningReplayItemsRequired retrieves replay items for request-time paths.

func GetModelGroup 

func GetModelGroup(modelName string) string

func GetXAIReasoningReplayItem added in v7.2.31 

func GetXAIReasoningReplayItem(modelName, sessionKey string) ([]byte, bool)

GetXAIReasoningReplayItem retrieves a normalized reasoning replay item.

func GetXAIReasoningReplayItems added in v7.2.31 

func GetXAIReasoningReplayItems(modelName, sessionKey string) ([][]byte, bool)

GetXAIReasoningReplayItems retrieves normalized assistant output items.

func GetXAIReasoningReplayItemsRequired added in v7.2.31 

func GetXAIReasoningReplayItemsRequired(ctx context.Context, modelName, sessionKey string) ([][]byte, bool, error)

GetXAIReasoningReplayItemsRequired retrieves replay items for request-time paths.

func HasValidSignature 

func HasValidSignature(modelName, signature string) bool

HasValidSignature checks if a signature is valid (non-empty and long enough)

func SetSignatureBypassStrictMode 

func SetSignatureBypassStrictMode(strict bool)

SetSignatureBypassStrictMode controls whether bypass mode uses strict protobuf-tree validation.

func SetSignatureCacheEnabled 

func SetSignatureCacheEnabled(enabled bool)

SetSignatureCacheEnabled switches Antigravity signature handling between cache mode and bypass mode.

func SignatureBypassStrictMode 

func SignatureBypassStrictMode() bool

SignatureBypassStrictMode returns whether bypass mode uses strict protobuf-tree validation.

func SignatureCacheEnabled 

func SignatureCacheEnabled() bool

SignatureCacheEnabled returns whether signature cache validation is enabled.

Types

type SignatureEntry 

type SignatureEntry struct {
	Signature string
	Timestamp time.Time
}

SignatureEntry holds a cached thinking signature with timestamp

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.