.env.example

# Cryptic Crossword Solver - Environment Configuration

# --- Split Hosting / API Access ---
# Comma-separated list of frontend origins allowed to call the backend API.
# Example:
# CROSSWORD_CORS_ORIGINS=https://cryptic-tutor.vercel.app,http://localhost:5173
# Leave unset for local same-origin or proxy-based development.
# CROSSWORD_CORS_ORIGINS=

# --- Storage ---
# Session persistence backend. Current supported values: filesystem, sqlite
# CROSSWORD_SESSION_STORE=filesystem
# Optional filesystem root when using the filesystem session store
# CROSSWORD_SESSION_FILESYSTEM_ROOT=backend_data/sessions
# Optional custom SQLite path when using sqlite
# CROSSWORD_SESSION_SQLITE_PATH=backend_data/sessions.sqlite3
# Puzzle definition/import storage backend. Current supported values: filesystem, sqlite
# CROSSWORD_PUZZLE_STORE=filesystem
# Optional filesystem root when using the filesystem puzzle store
# CROSSWORD_PUZZLE_FILESYSTEM_ROOT=samples
# Optional custom SQLite path when using sqlite
# CROSSWORD_PUZZLE_SQLITE_PATH=backend_data/puzzles.sqlite3

# --- AI Runtime Configuration ---
# To enable AI-powered hints and semantic validation, set this to the command 
# that invokes your LLM agent runtime. 
# The built-in Codex runtime wrapper is recommended:
CROSSWORD_RUNTIME_COMMAND=python backend/runtime_wrappers/codex_runtime.py

# Optional: Override just the semantic check path
# CROSSWORD_SEMANTIC_COMMAND=...

# --- Codex Runtime Wrapper Settings ---
# These are used if you use the codex_runtime.py wrapper above.
# Requirements: 'codex' CLI must be in your PATH or CODEX_RUNTIME_EXECUTABLE set.

# Model selection (fallbacks to CODEX_MODEL if specific ones aren't set)
# CODEX_MODEL=gpt-5.4
# CODEX_MODEL_LITE=gpt-5.4-mini
# CODEX_MODEL_REASONER=gpt-5.4

# Reasoning effort (none, low, medium, high, xhigh)
# CODEX_REASONING_EFFORT_REASONER=xhigh

# Path to codex executable (if not in PATH)
# CODEX_RUNTIME_EXECUTABLE=C:\path\to\codex.exe