config.example.json

{
  "identity": {
    "agent_name": "Agent",
    "owner_name": "Owner",
    "owner_display_name": "Owner Name"
  },
  "locale": {
    "timezone": ""
  },
  "engine": {
    "dbPath": "./constellation.db",
    "modelId": "Xenova/bge-m3",
    "ir": {
      "episodic": { "enabled": true, "rerank_min": 0.3, "top_k": 5, "pool_size": 10 },
      "deep_recall": { "enabled": true, "rerank_min": 0.3, "cutoff_days": 7 },
      "pool_anchor": { "enabled": true },
      "raw_context": {
        "enabled": true,
        "min_turns": 40,
        "min_hours": 4,
        "max_turns": 80,
        "tight_episodic_max_turns": 40
      },
      "mimir_inject": {
        "enabled": false,
        "_note": "Default OFF. When OFF, autonomous explorations and cron findings stay out of the main session's raw injection — they still live in the star map and surface via SA/episodic."
      }
    },
    "star_map": {
      "permanent_slots": []
    }
  },
  "llm": {
    "_notes": "authMode controls which transport the engine uses. Supported: 'api-key' (provider-native API, set the matching API key env var), 'gateway' (generic OpenAI-compat endpoint — works with OpenAI, Ollama, LM Studio, LiteLLM, Together AI, OpenRouter, Codex OAuth shim, etc. — set baseUrl + apiKey). The first-run wizard will populate provider/apiKey/model fields for you; the values below are placeholders.",
    "authMode": "api-key",
    "provider": "",
    "apiKey": "",
    "baseUrl": "",
    "primaryModel": "",
    "compactModel": "",
    "fallbackModel": "",
    "maxRetries": 2,
    "timeoutMs": 5400000,
    "_provider_examples": {
      "anthropic_direct": { "authMode": "api-key", "primaryModel": "claude-opus-4-7", "compactModel": "claude-haiku-4-5-20251001" },
      "openai": { "authMode": "gateway", "baseUrl": "https://api.openai.com", "apiKey": "sk-...", "primaryModel": "gpt-4o", "compactModel": "gpt-4o-mini" },
      "ollama_local": { "authMode": "gateway", "baseUrl": "http://127.0.0.1:11434", "apiKey": "ollama", "primaryModel": "qwen2.5:14b", "compactModel": "qwen2.5:7b" },
      "lm_studio": { "authMode": "gateway", "baseUrl": "http://127.0.0.1:1234", "apiKey": "lm-studio", "primaryModel": "loaded-model-id" },
      "together_ai": { "authMode": "gateway", "baseUrl": "https://api.together.xyz", "apiKey": "...", "primaryModel": "meta-llama/Llama-3.3-70B-Instruct-Turbo" },
      "openrouter": { "authMode": "gateway", "baseUrl": "https://openrouter.ai/api/v1", "apiKey": "sk-or-...", "primaryModel": "anthropic/claude-3.5-sonnet" },
      "codex_oauth": { "authMode": "gateway", "provider": "codex-oauth", "baseUrl": "http://127.0.0.1:3457/v1", "apiKey": "local", "primaryModel": "gpt-5.4-mini", "gatewayVendor": "codex-shim", "_note": "Optional local-only bridge for users who installed Codex CLI and ran `codex login`. Constellation never reads or stores the Codex OAuth token." },
      "custom_local_bridge": { "authMode": "gateway", "baseUrl": "http://127.0.0.1:3456/v1", "apiKey": "local", "primaryModel": "your-model-id", "_note": "Any user-managed OpenAI-compatible local server. We do not bundle or recommend specific bridge software." }
    },
    "_roles_note": "Per-role model routing (main/anamnesis/consolidation/worker/explore/compact) is written by the launcher onboarding (electron/onboarding/llm-config.js) — not by this example. If you bypass the launcher and only set primaryModel/compactModel above, LLMRouter auto-synthesizes a roles map at boot."
  },
  "telegram": {
    "token": "$TELEGRAM_BOT_TOKEN",
    "allowedUserId": "$OWNER_USER_ID",
    "maxMessageLength": 4096
  },
  "cron": {
    "timezone": "UTC",
    "tasks": []
  },
  "runtime": {
    "compileMode": "single",
    "contextBudget": 180000,
    "fixedRatio": 0.1,
    "constellationRatio": 0.28,
    "summaryRatio": 0.1,
    "activeRatio": 0.52,
    "compactionThreshold": 0.7,
    "maxToolRounds": 30,
    "maxTurnTotalTokens": 2000000,
    "sessionTokenBudget": 10000000,
    "fixedFiles": [
      "identity/SYSTEM_PREAMBLE.md",
      "identity/COMMUNICATION_STYLE.md"
    ],
    "streamingIR": {
      "enabled": true,
      "maxDynamic": 15,
      "evictMissThreshold": 3,
      "evictAThreshold": 0.15,
      "emaAlpha": 0.3,
      "refractoryMs": 30000,
      "challengerMargin": 0.1,
      "_note": "Streaming IR keeps the dynamic pool warm across turns with EMA smoothing, refractory on evicted ids, and a challenger margin for swap stability. Anchors (permanent slots) pass through daemon-sorted."
    }
  },
  "dashboard": {
    "port": 18800,
    "authToken": "$DASHBOARD_AUTH_TOKEN"
  }
}