.env.example

# Ad Seller System Configuration

# Required: Anthropic API Key for CrewAI agents
ANTHROPIC_API_KEY=your-api-key-here

# OpenDirect Server Configuration
# Default: Live IAB Tech Lab agentic-direct server (OpenDirect 2.1)
OPENDIRECT_BASE_URL=https://agentic-direct-server-hwgrypmndq-uk.a.run.app

# Optional: For local OpenDirect 2.1 server
# OPENDIRECT_BASE_URL=http://localhost:3000

# Optional: OpenDirect API key / token (only needed if the server requires auth)
# OPENDIRECT_API_KEY=your-opendirect-api-key
# OPENDIRECT_TOKEN=your-opendirect-token

# Protocol Selection: opendirect21 (default), a2a (agent-to-agent)
DEFAULT_PROTOCOL=opendirect21

# Seller Identity
SELLER_ORGANIZATION_ID=my-publisher-001
SELLER_ORGANIZATION_NAME=My Publisher

# Public URL of this seller agent (used by buyer agents and registries to reach you)
SELLER_AGENT_URL=http://localhost:8000
# Display name for this seller agent in buyer-facing discovery
SELLER_AGENT_NAME=Ad Seller Agent

# =============================================================================
# Ad Server Configuration
# =============================================================================

# Ad server type: google_ad_manager (default), freewheel, csv
AD_SERVER_TYPE=google_ad_manager

# CSV Ad Server (for testing/demo without GAM or FreeWheel)
# AD_SERVER_TYPE=csv
# CSV_DATA_DIR=./data/csv/samples/ctv_streaming

# -----------------------------------------------------------------------------
# Google Ad Manager (GAM) Configuration
# -----------------------------------------------------------------------------
# To enable GAM integration:
# 1. Create a Google Cloud Project with Ad Manager API enabled
# 2. Create a Service Account with JSON key
# 3. Link Service Account to GAM Network (Admin > Global Settings > API access)
# 4. Set the configuration below

# Feature flag to enable GAM integration
GAM_ENABLED=false

# GAM network code (found in Admin > Global Settings)
# GAM_NETWORK_CODE=12345678

# Path to service account JSON key file
# GAM_JSON_KEY_PATH=/path/to/service-account-key.json

# Application name for GAM API requests
GAM_APPLICATION_NAME=AdSellerSystem

# SOAP API version (check https://developers.google.com/ad-manager/api/rel_notes)
GAM_API_VERSION=v202411

# Default trafficker user ID for orders (GAM user who manages the order)
# Find this in GAM Admin > Users
# GAM_DEFAULT_TRAFFICKER_ID=123456789

# -----------------------------------------------------------------------------
# FreeWheel Configuration (alternative ad server)
# -----------------------------------------------------------------------------
# Feature flag to enable FreeWheel integration
FREEWHEEL_ENABLED=false

# Publisher network/account ID in FreeWheel
# FREEWHEEL_NETWORK_ID=your-freewheel-network-id

# Inventory access mode:
#   full       — agent calls list_inventory() and sees all available inventory
#   deals_only — agent only sees pre-configured deals/packages set up for agentic selling
FREEWHEEL_INVENTORY_MODE=deals_only

# Streaming Hub MCP (publisher-side: inventory, deals, audiences, forecasting)
# Auth uses OAuth 2.1 PKCE against /mcp/oauth.
# First run: ad-seller freewheel-login
# FREEWHEEL_SH_MCP_URL=https://shmcp.freewheel.com

# Buyer Cloud MCP (demand-side: campaign execution, creatives, reporting)
# Auth uses OAuth 2.1 PKCE against /mcp/oauth.
# First run: ad-seller freewheel-login --provider bc
# FREEWHEEL_BC_MCP_URL=https://bcmcp.freewheel.com

# =============================================================================
# SSP Connectors
# =============================================================================
# Comma-separated list of SSP names to enable (e.g. "pubmatic,magnite")
SSP_CONNECTORS=

# Routing rules: inventory_type:ssp_name pairs, comma-separated
# e.g. "ctv:pubmatic,display:magnite"
SSP_ROUTING_RULES=

# PubMatic SSP (MCP-based)
# PUBMATIC_MCP_URL=https://mcp.pubmatic.com/sses
# PUBMATIC_API_KEY=your-pubmatic-api-key

# Magnite SSP (REST API)
# MAGNITE_API_URL=https://api.magnite.com
# MAGNITE_API_KEY=your-magnite-api-key

# Index Exchange SSP (REST API)
# INDEX_EXCHANGE_API_URL=https://api.indexexchange.com
# INDEX_EXCHANGE_API_KEY=your-index-exchange-api-key

# =============================================================================
# Database / Storage Configuration
# =============================================================================
# Default: SQLite (no setup required)
STORAGE_TYPE=sqlite
DATABASE_URL=sqlite:///./ad_seller.db

# Optional: Redis (for production / distributed deployments)
# Set STORAGE_TYPE=redis and provide REDIS_URL to use Redis instead of SQLite
# STORAGE_TYPE=redis
# REDIS_URL=redis://localhost:6379/0

# Optional: hybrid mode uses both SQLite/PostgreSQL and Redis
# STORAGE_TYPE=hybrid

# PostgreSQL connection pool sizes (only used when DATABASE_URL is a postgres:// URL)
# POSTGRES_POOL_MIN=2
# POSTGRES_POOL_MAX=10

# =============================================================================
# Pricing Configuration
# =============================================================================
DEFAULT_CURRENCY=USD
MIN_DEAL_VALUE=1000.0
DEFAULT_PRICE_FLOOR_CPM=5.0

# =============================================================================
# Yield Optimization
# =============================================================================
YIELD_OPTIMIZATION_ENABLED=true
PROGRAMMATIC_FLOOR_MULTIPLIER=1.2
PREFERRED_DEAL_DISCOUNT_MAX=0.15

# =============================================================================
# LLM Configuration
# =============================================================================
# Only one provider can be active at a time.
# Uncomment the block for your chosen provider and comment out the others.

# Provider: Anthropic (default)
ANTHROPIC_API_KEY=your-anthropic-api-key-here
DEFAULT_LLM_MODEL=anthropic/claude-sonnet-4-5-20250929
MANAGER_LLM_MODEL=anthropic/claude-opus-4-20250514
LLM_TEMPERATURE=0.3
LLM_MAX_TOKENS=4096

# Provider: OpenAI (alternative)
# To switch to OpenAI, set DEFAULT_LLM_MODEL and OPENAI_API_KEY:
# OPENAI_API_KEY=your-openai-api-key-here
# DEFAULT_LLM_MODEL=openai/gpt-4o
# MANAGER_LLM_MODEL=openai/gpt-4o

# Provider: Google Gemini (alternative)
# To switch to Gemini, set DEFAULT_LLM_MODEL and GOOGLE_API_KEY:
# GOOGLE_API_KEY=your-google-api-key-here
# DEFAULT_LLM_MODEL=gemini/gemini-2.5-flash
# MANAGER_LLM_MODEL=gemini/gemini-2.5-flash

# Provider: AWS Bedrock (alternative)
# To switch to Bedrock, set DEFAULT_LLM_MODEL and AWS credentials:
# AWS_ACCESS_KEY_ID=your-aws-access-key
# AWS_SECRET_ACCESS_KEY=your-aws-secret-key
# AWS_REGION=us-west-2
# DEFAULT_LLM_MODEL=bedrock/us.anthropic.claude-sonnet-4-5-20250929-v1:0
# MANAGER_LLM_MODEL=bedrock/us.anthropic.claude-opus-4-20250514-v1:0

# Provider: Custom OpenAI-compatible endpoint (alternative)
# For endpoints with no CrewAI native provider prefix of their own — NVIDIA
# NIM, Ollama, HuggingFace TGI, vLLM, LM Studio, etc. Set DEFAULT_LLM_MODEL to
# the raw model id the endpoint expects, plus
# OPENAI_COMPATIBLE_LLM_API_BASE_URL. OPENAI_COMPATIBLE_LLM_API_KEY is
# optional — omit it for endpoints (e.g. a local Ollama server) that don't
# require one.
#
# NVIDIA NIM:
# OPENAI_COMPATIBLE_LLM_API_KEY=nvapi-your-nvidia-api-key
# OPENAI_COMPATIBLE_LLM_API_BASE_URL=https://integrate.api.nvidia.com/v1
# DEFAULT_LLM_MODEL=meta/llama-3.1-70b-instruct
# MANAGER_LLM_MODEL=meta/llama-3.1-70b-instruct
#
# Ollama (local or self-hosted):
# OPENAI_COMPATIBLE_LLM_API_BASE_URL=http://localhost:11434/v1
# DEFAULT_LLM_MODEL=llama3
# MANAGER_LLM_MODEL=llama3
#
# HuggingFace TGI (self-hosted):
# OPENAI_COMPATIBLE_LLM_API_KEY=hf_your-huggingface-token
# OPENAI_COMPATIBLE_LLM_API_BASE_URL=https://your-tgi-endpoint.example.com/v1
# DEFAULT_LLM_MODEL=meta-llama/Meta-Llama-3-8B-Instruct
# MANAGER_LLM_MODEL=meta-llama/Meta-Llama-3-8B-Instruct

# =============================================================================
# CrewAI Configuration
# =============================================================================
CREW_MEMORY_ENABLED=true
CREW_VERBOSE=true
CREW_MAX_ITERATIONS=15

# =============================================================================
# Inventory Sync Scheduling
# =============================================================================
# Enable periodic sync from your ad server to local inventory cache
INVENTORY_SYNC_ENABLED=false
INVENTORY_SYNC_INTERVAL_MINUTES=60
INVENTORY_SYNC_INCLUDE_ARCHIVED=false

# Path to your sellers.json file (IAB Supply Chain Transparency spec)
# SELLERS_JSON_PATH=/path/to/sellers.json

# =============================================================================
# Event Bus / Human-in-the-Loop Configuration
# =============================================================================
EVENT_BUS_ENABLED=true

# Require human approval before deals go live (default off, opt-in)
APPROVAL_GATE_ENABLED=false
APPROVAL_TIMEOUT_HOURS=24

# Comma-separated list of approval gate names to require manual sign-off on.
# Options: proposal_decision, deal_registration
# APPROVAL_REQUIRED_FLOWS=proposal_decision,deal_registration

# =============================================================================
# Session Configuration
# =============================================================================
SESSION_TTL_SECONDS=604800
SESSION_MAX_MESSAGES=200

# =============================================================================
# Agent Registry
# =============================================================================
AGENT_REGISTRY_ENABLED=true
AGENT_REGISTRY_URL=https://tools.iabtechlab.com/agent-registry

# Comma-separated list of additional registry URLs to check
# AGENT_REGISTRY_EXTRA_URLS=https://registry.example.com

# Trust settings for buyer agents
AUTO_APPROVE_REGISTERED_AGENTS=true
REQUIRE_APPROVAL_FOR_UNREGISTERED=true

# =============================================================================
# API Key Authentication
# =============================================================================
API_KEY_AUTH_ENABLED=true

# Default expiry in days for new API keys (leave blank for no expiry)
# API_KEY_DEFAULT_EXPIRY_DAYS=90