.env.example

# Copy to .env in the gateway's working directory (the agent workspace), or
# let `inkbox-opencode autostart install` snapshot your shell env instead.
# Load order: INKBOX_OPENCODE_ENV_FILE, ./.env, ~/.inkbox-opencode/.env —
# each only fills vars not already set; the real environment always wins.

# --- Inkbox identity (required; ~/.inkbox/config works too) ---
INKBOX_API_KEY=ApiKey_xxxxxxxxxxxx
INKBOX_IDENTITY=my-agent-handle
INKBOX_SIGNING_KEY=whsec_xxxxxxxxxxxx

# --- Inkbox (optional) ---
# INKBOX_BASE_URL=https://inkbox.ai
# INKBOX_PUBLIC_URL=https://your-public-host.example   # omit to use an Inkbox tunnel
# INKBOX_TUNNEL_NAME=my-agent-handle
# INKBOX_ALLOW_ALL_USERS=true                          # rely on Inkbox contact rules
# INKBOX_ALLOWED_USERS=+15551234567,me@example.com     # optional local allowlist
# INKBOX_REQUIRE_SIGNATURE=true
# INKBOX_EXTERNAL_EVENTS_ENABLED=false                 # wake the agent on external webhooks
# INKBOX_WEBHOOK_SECRET_GITHUB=...                     # verification secret for a registered source
# INKBOX_GATEWAY_PORT=8767

# --- Phone call voice stack ---
# INKBOX_VOICE_STACK=inkbox_voice_ai                   # or openai_realtime / inkbox_tts_stt
# INKBOX_VOICE_AI_AUTHORITY_MODE=contact_scoped        # or yolo; local mirror checked by doctor
# INKBOX_VOICEMAIL_DETECTION=enabled                   # set disabled for calls that must ignore detection
# OPENAI_API_KEY=sk-openai                             # enables OpenAI Realtime calls
# INKBOX_REALTIME_API_KEY=sk-realtime                  # dedicated key; OPENAI_API_KEY backstops
# INKBOX_VOICE_ENABLED=false                           # stop answering calls entirely
# INKBOX_REALTIME_ENABLED=false                        # force Inkbox STT/TTS instead of Realtime
# INKBOX_REALTIME_MODEL=gpt-realtime-2
# INKBOX_REALTIME_VOICE=cedar
# INKBOX_REALTIME_FALLBACK_TO_INKBOX_STT_TTS=true

# --- opencode ---
# INKBOX_GATEWAY_AGENT=inkbox-channel                  # opencode agent for gateway sessions
# INKBOX_GATEWAY_MODEL=openai/gpt-5.4-mini             # "provider/model" override
# OPENCODE_SERVER_URL=http://127.0.0.1:4096            # attach to an existing server instead
# INKBOX_GATEWAY_SERVE_PORT=4097                       # port for the managed `opencode serve`
# INKBOX_OPENCODE_BIN=opencode                         # binary for the managed server
# INKBOX_TEXT_BATCH_WINDOW_MS=0                        # batch rapid-fire texts into one turn
# INKBOX_CONTACT_MEMORIES_ENABLED=false                # omit matched-contact memory context