Module: Legion::LLM::Settings::API

Extended by:
Legion::Logging::Helper
Defined in:
lib/legion/llm/settings/api.rb

Overview

API-surface settings. Owning surface for the SSOT v3 routing_too_early_retry_after value (controlling design D16): the Retry-After emitted on compatibility 503/529 responses that map an internal TooEarly/ServiceUnavailable/AttemptsExhausted rejection.

Class Method Summary collapse

Class Method Details

.defaults ⇒ Object 



13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/legion/llm/settings/api.rb', line 13

def self.defaults
  {
    use_namespaces:                   true,
    batch_pool_size:                  4,
    auth:                             {
      enabled:      false,
      api_keys:     [],
      pass_through: false
    },
    # G21 — X-Legion-Format and X-Legion-Debug surface. Default ON for
    # lite/dev because the envelope leaks routing/escalation internals;
    # production deployments must explicitly opt in.
    debug_formats:                    Legion::LLM::Settings.debug_formats_defaults,
    # opus M5 / G14: Retry-After seconds sent with EscalationExhausted (503).
    # SDKs auto-retry on 503; this value tells them when to retry.
    escalation_exhausted_retry_after: 5,
    # SSOT v3 D16: Retry-After (seconds) sent on compatibility 503/529
    # responses derived from an internal too_early/service_unavailable/
    # attempts_exhausted routing rejection. Native routes keep 425 and
    # this same value. Valid range 1..30; not a provider/model default.
    routing_too_early_retry_after:    1
  }
end