env.example

# =============================================================================
# STACKONE KNOWLEDGE AGENT - ENVIRONMENT CONFIGURATION
# =============================================================================
# Copy this file to .env.local and fill in your actual values
# Never commit .env.local to version control

# =============================================================================
# DATABASE (PostgreSQL)
# =============================================================================
# Local: use Docker Compose (see docker-compose.yml). Default host port is 5433.
#   DATABASE_URL=postgres://postgres:postgres@localhost:5433/rag_agent
# Production (e.g. Neon, Supabase via Vercel Marketplace): set DATABASE_URL in your hosting env
# Requires pgvector extension: CREATE EXTENSION IF NOT EXISTS vector;
DATABASE_URL=postgres://postgres:postgres@localhost:5433/rag_agent

# =============================================================================
# OPENAI CONFIGURATION
# =============================================================================
# Get your API key from https://platform.openai.com/api-keys
OPENAI_API_KEY=your_openai_api_key

# Model for chat responses (default: gpt-4o)
# Options: gpt-4o, gpt-4-turbo, gpt-4, gpt-3.5-turbo, etc.
OPENAI_CHAT_MODEL=gpt-4o

# Model for embeddings (default: text-embedding-3-small)
# Options: text-embedding-3-small, text-embedding-3-large, text-embedding-ada-002
OPENAI_EMBEDDING_MODEL=text-embedding-3-small

# Embedding dimensions (default: 1536)
# Must match your database schema. text-embedding-3-small supports 512, 1536
# text-embedding-3-large supports 256, 1024, 3072
OPENAI_EMBEDDING_DIMENSIONS=1536

# Optional: Lighter/cheaper model for classification/decision-making
# If not set, uses the chat model for decisions
# Recommended: Use a cheaper model like gpt-3.5-turbo or gpt-4o-mini for cost savings
# OPENAI_CLASSIFIER_MODEL=gpt-3.5-turbo

# =============================================================================
# AGENT CONFIGURATION
# =============================================================================
# Maximum number of turns the agent can take in a multi-turn conversation loop
# Each turn can be: RAG retrieval, tool execution, or final response
# Default: 10
AGENT_MAX_TURNS=10

# =============================================================================
# STACKONE CONFIGURATION
# =============================================================================
# Get these from your StackOne dashboard
STACKONE_API_KEY=your_stackone_api_key

# Optional: Custom StackOne API base URL (default: https://api.stackone.com)
# Only needed if using a custom StackOne instance
# STACKONE_BASE_URL=https://api.stackone.com

# Webhook signing secret from StackOne dashboard (Webhooks > your webhook > Signing secret).
# If set, the app verifies x-stackone-signature (HMAC SHA256 base64url of body).
# For local testing with ngrok: use the secret from StackOne and point the webhook URL to
# your ngrok URL, e.g. https://your-subdomain.ngrok.io/api/stackone/webhook
STACKONE_WEBHOOK_SECRET=

# =============================================================================
# NEXT.JS / NEXT-AUTH CONFIGURATION
# =============================================================================
# Generate a random secret for NextAuth
NEXTAUTH_SECRET=your_nextauth_secret_here
NEXTAUTH_URL=http://localhost:3000
APP_URL=http://localhost:3000

# Optional: Google SSO (get from Google Cloud Console > APIs & Services > Credentials)
# Create OAuth 2.0 Client ID (Web app), add authorized redirect:
#   http://localhost:3000/api/auth/callback/google  (dev)
#   https://your-domain.com/api/auth/callback/google (prod)
# GOOGLE_CLIENT_ID=
# GOOGLE_CLIENT_SECRET=

# =============================================================================
# INTEGRATION CONFIGURATION
# =============================================================================
# Comma-separated list of available integrations (StackOne provider keys).
# These need to be enabled in your StackOne project.
# Examples: googledrive, googledocs, googlesheets, notion_documents
AVAILABLE_INTEGRATIONS=googledrive,googledocs,googlesheets,notion_documents

# Optional: StackOne provider versions for connectors that require provider_version (e.g. googledrive, googlesheets).
# Format: provider:version,provider:version
# When set, connect_sessions will send provider + provider_version for the given provider.
# AVAILABLE_INTEGRATION_VERSIONS=googledrive:1.0,googlesheets:1.0
AVAILABLE_INTEGRATION_VERSIONS=

# =============================================================================
# DEBUG (optional)
# =============================================================================
# Set DEBUG=1 or DEBUG_CHAT=1 to enable verbose logging (chat, agent, tools).
# Leave unset for quiet logs; only errors and warnings are shown.
# DEBUG_CHAT=1
# DEBUG_STACKONE_UTILITY_TOOLS=1  # Log underlying HTTP request/response for StackOne API calls
# DEBUG_STACKONE_META_TOOLS=1     # Alias for DEBUG_STACKONE_UTILITY_TOOLS
# DEBUG_TOOLS=1                   # Log full tool_search/tool_execute inputs and outputs (and agent stream tool-call/tool-result payloads)