.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: OAuth 2.0 ROPCG — the streaming_hub_login MCP tool wraps the token
# exchange at https://api.freewheel.tv/auth/token.  Tokens valid for 7 days.
# Rate limit: 3 requests/second on the token endpoint.
# FREEWHEEL_SH_MCP_URL=https://shmcp.freewheel.com
# FREEWHEEL_SH_USERNAME=your-sh-username
# FREEWHEEL_SH_PASSWORD=your-sh-password

# Buyer Cloud / Beeswax MCP (demand-side: campaign execution, creatives, reporting)
# Auth: Session cookie via buyer_cloud_login MCP tool (wraps Beeswax
# POST https://<buzz_key>.api.beeswax.com/rest/authenticate).
# Sessions last 100 hours; extended to 30 days with keep_logged_in.
# Only needed for PG deals that require cross-MCP campaign management.
# FREEWHEEL_BC_MCP_URL=https://<buzz_key>.api.beeswax.com
# FREEWHEEL_BC_EMAIL=your-beeswax-email
# FREEWHEEL_BC_PASSWORD=your-beeswax-password
# FREEWHEEL_BC_BUZZ_KEY=your-buzz-key

# Legacy FreeWheel REST API (deprecated — use MCP URLs above for new integrations)
# FREEWHEEL_API_URL=https://api.freewheel.com
# FREEWHEEL_API_KEY=your-freewheel-api-key

# =============================================================================
# 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
# =============================================================================
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

# =============================================================================
# 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