Skip to main content

Response Caching

Envelope-Scoped Caching​

Cache entries are scoped by:

  • Tenant (organization)
  • Security classification
  • Response contract
  • Task type
  • Provider capability class

This ensures cache reuse never crosses security boundaries or tenant scopes.

Configuration​

cache:
  enabled: true
  ttl_seconds: 3600
  max_entries: 10000
  similarity_threshold: 0.95
  allow_cross_provider_reuse: false  # Default: false (SEC-003)

Cross-Provider Reuse​

By default, cached responses from one provider cannot be reused for requests routed to a different provider. Enable only with explicit provider-equivalence contracts:

cache:
  allow_cross_provider_reuse: true  # Requires provider-equivalence contract