agentrail/.env.example at main · CleanDev-Fix/agentrail · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# Local AgentRail API configuration.
#
# Copy this file to .env before running `npm start`.

AGENTRAIL_HOST=127.0.0.1
AGENTRAIL_PORT=3000
AGENTRAIL_PUBLIC_BASE_URL=http://127.0.0.1:3000
# Production on Railway: set to https://api.agentrail.app/v1.
# When this value carries a path prefix such as /v1, the service accepts both
# root routes (/tasks/...) and prefixed routes (/v1/tasks/...).

# Optional: persist task lifecycle events (for example .agentrail/events.ndjson)
# so SSE/webhook replay survives local restarts.
AGENTRAIL_EVENT_STORE_PATH=
# Optional: persist current task state and metadata (for example
# .agentrail/tasks.json) so assignments, statuses, and checkpoints survive
# local restarts.
AGENTRAIL_TASK_STORE_PATH=
# Optional: persist agent auth keys and usage data (for example
# .agentrail/agent-auth.json).
AGENTRAIL_AGENT_AUTH_STORE_PATH=
# Optional: persist routing rule sets (for example .agentrail/routing-rules.json).
AGENTRAIL_ROUTING_RULES_STORE_PATH=
# Optional: persist routing audit decisions and evaluation/intake idempotency
# replay records (for example .agentrail/routing-audit.json).
AGENTRAIL_ROUTING_AUDIT_STORE_PATH=
# Optional: persist agent routing profiles (for example .agentrail/agent-profiles.json).
AGENTRAIL_AGENT_PROFILES_STORE_PATH=

# Required for GitHub-backed submit, review, and CI adapters.
# Use a GitHub personal access token or GitHub App installation token with the
# repo and workflow access your repository flow needs. Create one in GitHub
# Settings -> Developer settings -> Personal access tokens.
GITHUB_TOKEN=

# Required for Linear issue intake and outbound GraphQL mutations.
# Create a Personal API Key in Linear Settings -> Account -> Security & Access.
# Grant the issue/comment permissions your workflow needs, keep it secret, and paste it here.
LINEAR_API_KEY=

# Required to verify signed Linear webhook deliveries.
# Create a webhook in Linear Settings -> Administration -> API, copy the webhook secret,
# keep it secret, and paste it here so AgentRail can verify signed deliveries.
LINEAR_WEBHOOK_SECRET=

# JSON object keyed by task id with provider metadata.
# Example:
# AGENTRAIL_TASK_SOURCES={"tsk_123":{"provider":"github","owner":"oxnw","repo":"agentrail","issueNumber":123,"branch":"feat/example","baseBranch":"main"}}
AGENTRAIL_TASK_SOURCES={}

# Observability: set to "json" to emit structured JSON log lines per operation.
# Fields: ts, level, operation, agentId, taskId, provider, idempotencyKey,
#         estimatedTokens, durationMs, statusCode, retryCount, fallbackUsed, errorClass
AGENTRAIL_LOG_FORMAT=text
AGENTRAIL_OBSERVABILITY=true

# Fallback switch: set to "true" to put AgentRail into passive fallback mode.
# In fallback mode all task-lifecycle API routes return 503 with a structured
# response that agents can detect to revert to direct GitHub / Paperclip APIs.
# Set back to "false" (or remove) to restore normal operation.
AGENTRAIL_FALLBACK_MODE=false