.env.example

# Synapseia node — example environment

# Coordinator HTTP endpoint. Used for REST calls (heartbeat, /work-orders,
# /research-rounds, telemetry, etc.).
COORDINATOR_URL=http://localhost:3701

# Coordinator WebSocket endpoint. Optional — defaults to COORDINATOR_URL.
#
# In production the coord runs as three split processes (T5.4):
#   - coordinator-http   (port 3701) — REST API
#   - coordinator-ws     (port 3702) — Socket.IO gateway
#   - coordinator-worker (no port)   — background jobs
#
# Point this at the WS port so Socket.IO subscriptions don't ride on the
# HTTP process — otherwise restarting coord-http drops every node's WS.
COORDINATOR_WS_URL=http://localhost:3702

# Optional — local Ollama URL for LLM inference.
# OLLAMA_URL=http://localhost:11434

# Optional — cloud LLM API key (used when --model points at a cloud provider).
# LLM_KEY=

# Langfuse LLM tracing (LOCAL DEV ONLY — leave unset in prod).
#
# When unset, the LangGraph agent runs with zero observability overhead.
# When set, every graph.invoke() emits a trace tree with userId=peerId,
# sessionId=workOrderId, and per-LangGraph-node spans (planning, retrieve,
# generate, critique, submit, ...) plus LLM call attribution.
#
# The LangChain callback handler piggybacks on the OTel SpanProcessor
# already initialized in src/instrumentation.ts — connection details are
# read by the @langfuse/otel exporter from the same env vars.
# LANGFUSE_PUBLIC_KEY=pk-lf-synapseia-dev
# LANGFUSE_SECRET_KEY=sk-lf-synapseia-dev
# LANGFUSE_BASE_URL=http://localhost:3700