env.bot.example

DEEPGRAM_API_KEY=
GRADIUM_API_KEY=
CARTESIA_API_KEY=
ANTHROPIC_API_KEY=
GOOGLE_API_KEY=
OPENAI_API_KEY=
MINIMAX_API_KEY=

SUPABASE_URL=http://127.0.0.1:54321
SUPABASE_SERVICE_ROLE_KEY=

# Trusted-backend credential sent on every edge call as X-Edge-Auth.
# Required in production. Not the BYOA wake bearer (that's per-ship).
EDGE_API_TOKEN=

# Optional: run edge-function logic in-process against Postgres instead of
# over HTTP. Set to the Supabase session pooler connection string.
# e.g. postgresql://postgres.{REF}:{PASS}@aws-0-{REGION}.pooler.supabase.com:5432/postgres
LOCAL_API_POSTGRES_URL=

# Optional overrides
# required for the Daily transport
DAILY_API_KEY=
# gradium (default) or cartesia
TTS_PROVIDER=gradium

# Optional: Daily raw-tracks recording to a custom S3 bucket.
# Set all three to enable; requires DAILY_API_KEY above.
DAILY_RECORDING_BUCKET_NAME=
DAILY_RECORDING_BUCKET_REGION=
DAILY_RECORDING_ASSUME_ROLE_ARN=
# location of token usage metrics #default:"logs/token_usage.csv"
TOKEN_USAGE_LOG=
# hardcode character id to join with (used in client testing)
BOT_TEST_CHARACTER_ID=
# hardcoded character name
BOT_TEST_CHARACTER_NAME=
# hardcoded npc name
BOT_TEST_NPC_CHARACTER_NAME=
# dev-only: Supabase Auth access_token for local /start without going through the proxy edge function
BOT_TEST_ACCESS_TOKEN=

# Event delivery: `pubsub` (default, direct Postgres session pgmq queue) or
# `polling` (HTTP against events_since).
EVENT_TRANSPORT=pubsub

# Session-mode Postgres URL with admin credentials. Required for pubsub.
PGMQ_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres

# Session queue lifecycle. Cleanup is scheduled in the database; these values
# control the bot heartbeat/read behavior.
EVENT_SESSION_HEARTBEAT_SECONDS=15
EVENT_SESSION_TTL_SECONDS=60
EVENT_SESSION_HARD_TTL_SECONDS=21600
EVENT_SESSION_VISIBILITY_TIMEOUT_SECONDS=10
EVENT_SESSION_EMPTY_POLL_INTERVAL_SECONDS=1.0
EVENT_SESSION_BATCH_QTY=100
EVENT_SESSION_BOOTSTRAP_DRAIN_TIMEOUT_SECONDS=2.0

# Subagent bus transport: `local` (default, in-process AsyncQueueBus) or
# `pgmq` (Postgres bus via the public.bus_* SECURITY DEFINER wrappers).
# `pgmq` is required to enable BYOA.
SUBAGENT_BUS_TRANSPORT=local
# SUBAGENT_BUS_DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres

# Optional: LLM provider configuration (defaults shown)
# Supported providers: google, anthropic, openai, minimax
VOICE_LLM_PROVIDER=google
VOICE_LLM_MODEL=gemini-2.5-flash
TASK_LLM_PROVIDER=google
TASK_LLM_MODEL=gemini-2.5-flash
TASK_LLM_THINKING_BUDGET=4096

# Idle task status reports (set to 0 to disable)
BOT_IDLE_REPORT_ENABLED=1
# BOT_IDLE_REPORT_TIME=9.0
# BOT_IDLE_REPORT_COOLDOWN=45.0

# New-player onboarding prompt/route seeding. Set to 0 for evals.
BOT_NEW_PLAYER_ONBOARDING=1

# Max task agent lifetime in seconds (cancelled on expiry). Unset = no timeout.
TASK_AGENT_TIMEOUT=1800
# Delay before event-triggered task-agent inference, to let already-delivered
# sibling events drain through the ordered mailbox. Set 0 to disable.
TASK_AGENT_EVENT_DRAIN_GRACE_SECONDS=1.0

# UI agent LLM (optional)
UI_AGENT_LLM_PROVIDER=google
UI_AGENT_LLM_MODEL=gemini-2.5-flash
UI_AGENT_LLM_THINKING_BUDGET=0

# Ships list cache TTL for UI agent (seconds)
UI_AGENT_SHIPS_CACHE_TTL_SECS=60

# Context summarization
# messages before auto-summarization triggers
CONTEXT_SUMMARIZATION_MESSAGE_LIMIT=200

# Optional: Weave observability (W&B). Set both to enable span-based tracing
# for edge functions run locally inside the bot container.
WANDB_API_KEY=
# "entity/project" format, e.g. "my-team/gradientbang"
WEAVE_PROJECT=

# Optional: Cekura tracing for simulation. Set all three to enable.
CEKURA_API_KEY=
CEKURA_AGENT_ID=
# set to "true" to enable
CEKURA_TRACER_ENABLED=false