# Code Engine MCP Server — environment variables
#
# Copy this file to .env and fill in your values, OR export the variables
# in your shell profile (~/.zshrc / ~/.bash_profile) so they are never
# written into an MCP config file.
#
# Usage (shell profile — most secure):
#   export IBMCLOUD_API_KEY="your-ibm-cloud-api-key-here"
#
# Usage (local .env — loaded by your shell or a dotenv tool):
#   cp .env.example .env
#   # edit .env, then: source .env
#
# The MCP config can then reference the value without embedding it:
#   "IBMCLOUD_API_KEY": "${env:IBMCLOUD_API_KEY}"
#
# NEVER commit a .env file that contains real credentials.
# .env is already listed in .gitignore.

# ── Required ──────────────────────────────────────────────────────────────────

# Your IBM Cloud API key.
# Create one at: https://cloud.ibm.com/iam/apikeys → "Create an IBM Cloud API key"
IBMCLOUD_API_KEY=your-ibm-cloud-api-key-here

# ── Optional ──────────────────────────────────────────────────────────────────

# Default IBM Cloud region for Code Engine API calls.
# The server auto-discovers the region for a given project ID, so this is
# only needed if you want to restrict lookups to a specific region.
# Supported values: us-south us-east eu-de eu-gb jp-tok jp-osa au-syd ca-tor br-sao
# IBMCLOUD_REGION=us-south

# Force a specific container runtime instead of auto-detecting.
# Leave commented out unless you have both Docker and Podman installed and
# need to pick one explicitly.
# Supported values: docker  podman
# CONTAINER_RUNTIME=podman

# Enable verbose debug logging from the MCP server.
# DEBUG=true

# ── Optional addon: Provenance (off by default) ─────────────────────────────────
# Not required for Code Engine MCP. Enable only for signed receipts (experimental v0.1).
# Docs: provenance-addon/README.md · Chat prompts: provenance-addon/PROVENANCE-CHAT-COMMANDS.md
# PROVENANCE_ENABLED=true
# PROVENANCE_KEY_DIR=provenance-addon/.keys
# PROVENANCE_RECEIPTS_DIR=provenance-addon/receipts/live
# PROVENANCE_WORKSPACE_ROOT=/path/to/writable/workspace
# PROVENANCE_SESSION_ID=session:my-chat-001
# PROVENANCE_TASK_ID=task:write-files
# PROVENANCE_CHAT_LABEL=My chat topic in plain English
# PROVENANCE_TASK_LABEL=What I asked the agent to do right now
# PROVENANCE_GIT_REF=main@abc123
# PROVENANCE_LINEAGE_REF=ticket:ENG-417

# ── Optional: MCP Activity Dashboard (no provenance; on by default for local MCP) ──
# Logs tool start/finish to JSONL for the live dashboard in dashboard/.
# Cursor MCP config can override these; mcp-client.mjs defaults to enabled=true.
MCP_ACTIVITY_ENABLED=true
MCP_ACTIVITY_EVENTS_PATH=/absolute/path/to/code-engine-mcp-server/dashboard/activity/live/events.jsonl
# MCP_ACTIVITY_SESSION_ID=session:my-chat-001
# MCP_ACTIVITY_CHAT_LABEL=My chat topic in plain English
# MCP_ACTIVITY_TASK_LABEL=What I asked the agent to do right now
# MCP_ACTIVITY_GAP_THRESHOLD_MS=3000
# MCP_ACTIVITY_SESSION_ID=session:my-chat-001
# MCP_ACTIVITY_CHAT_LABEL=My chat topic in plain English
# MCP_ACTIVITY_TASK_LABEL=What I asked the agent to do right now