.env.example

# Slack Bot Token (xoxb-...)
AGENT_BRIDGE_SLACK_BOT_TOKEN=

# Slack App-Level Token for Socket Mode (xapp-...)
AGENT_BRIDGE_SLACK_APP_TOKEN=

# Optional: Send a Slack message after Socket Mode connects
# AGENT_BRIDGE_SLACK_STARTUP_NOTIFY_CHANNEL=C12345678
# AGENT_BRIDGE_SLACK_STARTUP_NOTIFY_MESSAGE=Bot is online

# Optional: comma-separated channel-name allow-list. Empty/unset = allow every
# channel. When set, only messages from these channels reach the agent; all
# others (including DMs, which have no name) get a fixed reply and are dropped.
# Use names (#hash, whitespace, and case are ignored), not channel IDs.
# AGENT_BRIDGE_SLACK_ALLOW_CHANNELS=ops-alerts,team-eng,incidents

# Optional: reply sent to messages from non-allowed channels (and DMs when the
# allow-list is set). Defaults to a fixed English notice.
# AGENT_BRIDGE_SLACK_CHANNEL_NOT_ALLOWED_MESSAGE=Sorry, I'm not available here.

# Optional: append a usage/cost footer below the final agent reply.
# Unset/false = no footer. The session line is shown only when the bridge has
# tracked the session from its first turn (omitted after restarts / for
# pre-existing sessions). Defaults to false.
# AGENT_BRIDGE_SLACK_USAGE_REPORT_ENABLED=false
# Optional: override the footer format with a {placeholder} template. Unknown
# placeholders render blank. Each token/cost field also has a session_-prefixed
# variant (e.g. {session_cost_usd}). Available: cost_usd, input_tokens,
# output_tokens, cache_read_tokens, cache_creation_tokens, total_tokens,
# num_turns, duration_ms, duration_s, duration_api_ms.
# AGENT_BRIDGE_SLACK_USAGE_REPORT_TEMPLATE=💵 {cost_usd} | {total_tokens} tokens | {duration_s}s

# Anthropic API Key (required for Claude Code CLI)
ANTHROPIC_API_KEY=

# Directory where Claude Code will operate
AGENT_BRIDGE_CLAUDE_WORK_DIR=.

# Claude Code permission mode: acceptEdits, dangerously-skip-permissions, default, plan
AGENT_BRIDGE_CLAUDE_PERMISSION_MODE=acceptEdits

# Claude Code effort level (low, medium, high, xhigh, max). Defaults to xhigh.
# AGENT_BRIDGE_CLAUDE_EFFORT=xhigh

# Path to session store JSON file
AGENT_BRIDGE_SESSION_STORE_PATH=./sessions.json

# Session TTL in hours (sessions inactive longer than this are expired)
AGENT_BRIDGE_SESSION_TTL_HOURS=72

# Timeout for a single Claude invocation in seconds
AGENT_BRIDGE_CLAUDE_TIMEOUT_SECONDS=600

# Run each session in its own git worktree (Claude Code's -w flag).
# Requires AGENT_BRIDGE_CLAUDE_WORK_DIR to be a git repo with an 'origin' remote
# whose HEAD resolves (i.e. origin/HEAD is set). Worktrees are created at
# <work_dir>/.claude/worktrees/<session_id>; branches named worktree-<session_id>.
AGENT_BRIDGE_CLAUDE_WORKTREE_ENABLED=false

# Maximum number of sessions processed concurrently
AGENT_BRIDGE_MAX_CONCURRENT_SESSIONS=5

# Cross-session prompt dedupe. When TTL > 0, identical (canonicalized) prompts
# arriving in the same channel-scope within the window collapse to a single
# agent run; subsequent hits get a short-circuit Completion. 0 disables.
# Canonicalization masks URLs / UUIDs / long numbers / timestamps / emails so
# alerts that only differ in those bits still collide.
AGENT_BRIDGE_DEDUPE_TTL_SECONDS=0
AGENT_BRIDGE_DEDUPE_MAX_ENTRIES=512
# Optional SimHash Hamming-distance threshold for fuzzy match. 0 = exact
# canonical match only. Typical range 3-10 when enabled.
AGENT_BRIDGE_DEDUPE_SIMHASH_THRESHOLD=0

# Heartbeat platform: periodically fires a fixed prompt to the agent.
# When enabled, requires INTERVAL_MINUTES and PROMPT.
AGENT_BRIDGE_HEARTBEAT_ENABLED=false
# AGENT_BRIDGE_HEARTBEAT_INTERVAL_MINUTES=60
# AGENT_BRIDGE_HEARTBEAT_PROMPT=Check your task list and work on the next item.
# AGENT_BRIDGE_HEARTBEAT_STATE_PATH=./heartbeat.json

# Log level: DEBUG / INFO / WARNING / ERROR
AGENT_BRIDGE_LOG_LEVEL=INFO