application.conf

# ── Server ------------------------------------------------------------------
# host: bind address.
# port: HTTP and WebSocket listen port (also update -p mapping in run_docker.sh
#       if you change this).
server {
  host = "127.0.0.1"
  port = 8080
}

# ── WebSocket ----------------------------------------------------------------
websocket {
  queueTimeoutMs = 1000   # outgoing message queue drain timeout (ms)
  enabled        = true
}

# ── Logging -----------------------------------------------------------------
# level: verbosity – DEBUG | INFO | WARN | ERROR
# consoleOutput: print log lines to stdout
logging {
  level         = "INFO"
  consoleOutput = false
}

# ── Engine ------------------------------------------------------------------
# defaultTickDelayMs: pause between execution ticks for newly created
#                     environments (can be overridden via /setTickDelay).
# defaultEventTtlMs:  time-to-live for events in milliseconds; 0 means events
#                     live forever (can be overridden per environment via API).
engine {
  defaultTickDelayMs = 500
  defaultEventTtlMs  = 3000  
  # eventConsumptionOnFire: when true (default) events are only marked as processed when a
  #   transition actually fires; when false they are consumed as soon as the engine evaluates
  #   their condition (can cause events to vanish if no transition fires).
  eventConsumptionOnFire = true
}

# ── Engine Tracing ----------------------------------------------------------
# tracingEnabled:      write per-environment execution trace log files.
# tracingLogDirectory: directory where trace log files are written.
#                      · Local run : use a relative path, e.g. "logs"
#                        (resolved relative to the karpfen-runtime/ directory).
#                      · Docker run: set to "/app/logs" – this is the
#                        container-side mount point that run_docker.sh maps to
#                        a directory on the host, so trace files persist after
#                        the container is removed.
# tracingConsoleOutput: also print trace lines to stdout.
# simpleTrace:         when true, observatory WebSocket trace messages are
#                      sent in a compact format (short message, no details map).
engineTracing {
  tracingEnabled      = false
  tracingLogDirectory = "logs"
  tracingConsoleOutput = false
  simpleTrace          = true
}