AurexConfig

Configure the auditor singleton. Provider-call resilience uses the separate resilience key — see ResiliencePolicy.

Agent hint

Use for api_key, ledger_path, cloud_sync, flush intervals, storage_mode, and pricing paths.

In scope

  • Core sync and ledger options
  • Pricing and heuristic thresholds
  • Link to resilience policy

Out of scope

  • BudgetGuard fields — see BudgetGuard
  • ResiliencePolicy fields — see /docs/reliability/policy
PythonNode.jsDefaultDescription
api_keyapiKeyNoneProject API key; enables cloud sync.
projectproject"default"Logical project label.
ledger_pathledgerPath.aurex/ledger.jsonlLocal JSONL ledger path.
per_process_ledgerperProcessLedgerTrueAppend worker suffix; set False in unit tests.
cloud_synccloudSyncFalse / autoBackground POST to /ledger/events.
base_urlbaseUrllocalhost APIBackend REST base URL.
local_onlylocalOnlyTrueSkip cloud even if key is set.
storage_modestorageMode"file"file or memory (auto-fallback if FS unwritable).
flush_interval_secondsflushIntervalMs30s / 30000msBackground flush interval.
max_batch_sizemaxBatchSize100Events per upload batch.
max_queue_sizemaxQueueSize10000Bounded in-memory queue.
sync_timeout_secondssyncTimeoutMs10s / 10000msHTTP timeout per sync attempt.
sync_max_retriessyncMaxRetries3Cloud sync retries with jitter.
sync_prompt_hashessyncPromptHashesFalseInclude prompt hashes in cloud payload.
pricing_pathpricingPathNoneCustom pricing JSON path.
default_pricingdefaultPricing1.50 / 6.00USD per 1M tokens fallback.
budget_guardbudgetGuard{}Spend circuit breaker — see BudgetGuard.
resilienceresilienceenabled: falseProvider-call retry/fallback — see ResiliencePolicy.

See also