.env.advanced.example

# Copy this file to `.env` if you want the fuller local/hosted configuration
# surface. For the smallest public sandbox setup, use `.env.example`.

# =============================================================================
# REQUIRED — Minimum to run the sandbox
# =============================================================================

# Your Unify API key (https://unify.ai)
UNIFY_KEY=

# At least one LLM provider key is required. OpenAI chat models are reached
# through OpenRouter, so OPENROUTER_API_KEY covers them.
ANTHROPIC_API_KEY=
OPENROUTER_API_KEY=
# Speech-to-text and realtime voice only; not an LLM provider key.
OPENAI_API_KEY=
# Together AI key for OpenRouter BYOK (Together-pinned open-weight models).
TOGETHER_API_KEY=

# =============================================================================
# Orchestra
# =============================================================================

# API endpoint (default: hosted Unify platform)
ORCHESTRA_URL="https://api.unify.ai/v0"

# Auto-shutdown timeout for local orchestra (seconds). 0 = never.
ORCHESTRA_INACTIVITY_TIMEOUT_SECONDS=600

# =============================================================================
# OPTIONAL — App integrations (Composio + Pipedream)
# =============================================================================
# Used by the self-host stack and local Orchestra for third-party app actions.
# Composio covers the primary catalog; Pipedream fills Composio-only gaps.
# PIPEDREAM_ENVIRONMENT=development is required locally (production Connect
# execution needs a paid Pipedream plan).

COMPOSIO_API_KEY=
PIPEDREAM_CLIENT_ID=
PIPEDREAM_CLIENT_SECRET=
PIPEDREAM_PROJECT_ID=
PIPEDREAM_ENVIRONMENT=development

# =============================================================================
# OPTIONAL — Provider-event triggers (source stack / stack.sh)
# =============================================================================
# Third-party task triggers (Composio or Pipedream github.issue_created). Disabled
# by default. Requires a public HTTPS callback base and wrapping master key.
# Composio and/or Pipedream credentials are optional per backend. Values here or
# in ~/.unity/.env (overlay) are read by unity-deploy/selfhost/stack.sh.
# Unify does not provide a managed callback tunnel for provider triggers.

SELF_HOST_PROVIDER_TRIGGERS_ENABLED=false
ORCHESTRA_TRIGGER_CALLBACK_BASE_URL=
TRIGGER_EVENT_WRAPPING_MASTER_KEY=
COMPOSIO_WEBHOOK_SECRET=

# =============================================================================
# OPTIONAL — Local comms mode
# =============================================================================
# Unity can own the local comms ingress directly. This is the default
# self-hosted path for SMS, email, and voice integrations.

UNITY_CONVERSATION_LOCAL_COMMS_ENABLED=true
UNITY_CONVERSATION_LOCAL_COMMS_MODE=local
UNITY_CONVERSATION_LOCAL_COMMS_HOST=127.0.0.1
UNITY_CONVERSATION_LOCAL_COMMS_PORT=8787
UNITY_CONVERSATION_LOCAL_COMMS_PUBLIC_URL=

# =============================================================================
# OPTIONAL — Unity gateway local setup wizard
# =============================================================================
# These keys are managed by `python -m unity.gateway setup --interactive`.

UNITY_GATEWAY_PUBLIC_URL=
UNITY_GATEWAY_LOCAL_INGRESS_URL=
UNITY_GATEWAY_STORAGE_DIR=
UNITY_ADAPTERS_URL=

# --- Twilio phone/SMS/social verification ---
TWILIO_ACCOUNT_SID=
TWILIO_AUTH_TOKEN=
ASSISTANT_NUMBER=
USER_NUMBER=

# --- Twilio WhatsApp ---
TWILIO_WA_ACCOUNT_SID=
TWILIO_WA_AUTH_TOKEN=
TWILIO_WA_FROM=

# --- Slack ---
SLACK_SIGNING_SECRET=

# --- Google/Gmail ---
GOOGLE_OAUTH_CLIENT_ID=
GOOGLE_OAUTH_CLIENT_SECRET=
GCP_SA_KEY=

# --- Microsoft/Outlook/Teams/SharePoint ---
MS365_BYOD_CLIENT_ID=
MS365_BYOD_CLIENT_SECRET=
OUTLOOK_WEBHOOK_SECRET=
TEAMS_WEBHOOK_SECRET=
MS365_ADMIN_TENANT_ID=
MS365_ADMIN_CLIENT_ID=
MS365_ADMIN_CLIENT_SECRET=

# =============================================================================
# OPTIONAL — Hosted comms service
# =============================================================================
# Only needed if you want to route comms through the hosted communication
# service instead of Unity's local ingress.

# Admin key for Orchestra admin API (outbound comms, VM management).
ORCHESTRA_ADMIN_KEY=

# Communication service URL (outbound calls, SMS, emails, LiveKit dispatch).
UNITY_COMMS_URL=

# GCP project ID for hosted Pub/Sub topics or echo-responder workflows.
GCP_PROJECT_ID=

# =============================================================================
# LLM & Caching
# =============================================================================

# Validate that LLM provider API keys are set on startup.
UNITY_VALIDATE_LLM_PROVIDERS=true

# Cache LLM responses locally. First run hits the LLM; subsequent runs replay.
UNILLM_CACHE=true

# =============================================================================
# Unify Client  (UNIFY_*)
# =============================================================================

# Shared API key for cross-assistant operations (AssistantJobs project).
SHARED_UNIFY_KEY=

# Terminal (console) logging for the unify client (file logging via UNISDK_LOG_DIR).
UNISDK_TERMINAL_LOG=true

# --- Test project management (consumed by tests/conftest.py) ---

# Use a random project name per test session (avoids shared-state collisions).
UNIFY_TESTS_RAND_PROJ=false

# Delete the shared project before/after the test run.
UNIFY_TESTS_DELETE_PROJ_ON_START=true
UNIFY_TESTS_DELETE_PROJ_ON_EXIT=false

# Delete each test's Unify context on exit. Useful for cleanup but slower.
UNIFY_DELETE_CONTEXT_ON_EXIT=false

# Overwrite the project if it already exists on activation.
UNIFY_OVERWRITE_PROJECT=false

# Pre-create test contexts during collection (before tests run).
UNIFY_PRETEST_CONTEXT_CREATE=false

# =============================================================================
# UniLLM  (UNILLM_*)
# =============================================================================

# Terminal (console) logging for unillm (file logging via UNILLM_LOG_DIR).
UNILLM_TERMINAL_LOG=true

# =============================================================================
# Unity  (UNITY_*)
# =============================================================================

# Master logging switch for Unity.
UNITY_LOG=true

# --- FileManager (Plot API) ---
UNITY_FILE_PLOT_API_ENDPOINT="/logs/plot"
UNITY_FILE_PLOT_API_TIMEOUT=30.0
UNITY_FILE_PLOT_API_MAX_RETRIES=3
UNITY_FILE_PLOT_API_RETRY_BACKOFF=1.0

# =============================================================================
# Test Infrastructure
# =============================================================================

# Git branch for local orchestra checkout (used by parallel_run.sh).
LOCAL_ORCHESTRA_BRANCH="staging"

# Write pytest output to per-test log files (in logs/pytest/).
PYTEST_LOG_TO_FILE=1

# Terminal (console) logging — set to 0 to suppress terminal output.
UNITY_TERMINAL_LOG=1

# Enable Python asyncio debug mode (performance overhead).
UNITY_ASYNCIO_DEBUG=0

# =============================================================================
# OPTIONAL — EventBus (Orchestra Events/* + Live Actions)
# =============================================================================
# Master switch: publish events to in-memory bus / Orchestra / Pub/Sub paths.
# EVENTBUS_PUBLISHING_ENABLED=false

# Orchestra persistence when publishing is on:
#   all       — write every event to Events/* (default, legacy behavior)
#   allowlist — write only ManagerMethod/ToolLoop for listed action/tool names
# EVENTBUS_ORCHESTRA_PERSIST_MODE=all
# EVENTBUS_ORCHESTRA_PERSIST_TOOLS=act,execute_code,execute_function

# Stream ManagerMethod/ToolLoop to Pub/Sub for Console Live Actions (independent
# of the Orchestra allowlist; stream_filters apply here only).
# EVENTBUS_PUBSUB_STREAMING=false

# =============================================================================
# OPTIONAL — Third-Party APIs
# =============================================================================

# --- LiveKit (Voice Calls) ---
# Use LiveKit Cloud credentials so browser Meet, SIP calls, and Unity workers
# share one backend.
LIVEKIT_SIP_URI=
LIVEKIT_URL=
LIVEKIT_API_KEY=
LIVEKIT_API_SECRET=

# --- Speech & Voice ---
DEEPGRAM_API_KEY=
CARTESIA_API_KEY=
ELEVEN_API_KEY=

# --- Web Search (Unity CM reads UNITY_WEB_TAVILY_API_KEY; set UNITY_WEB_ENABLED=true) ---
UNITY_WEB_TAVILY_API_KEY=
UNITY_WEB_ENABLED=false

# =============================================================================
# OPTIONAL — Magnitude Agent  (UNITY_MAGNITUDE_CACHE_*)
# =============================================================================
# Visual semantic cache for the magnitude browser agent (agent-service).

# Master toggle for visual semantic caching.
UNITY_MAGNITUDE_CACHE_ENABLED=false

# Unify context name used to store cached trajectories.
UNITY_MAGNITUDE_CACHE_CONTEXT=VisualSemanticCache

# Use image embeddings (primary) vs perceptual hashing (fallback) for similarity.
UNITY_MAGNITUDE_CACHE_USE_IMAGE_EMBEDDING=false