services.json

{
  "_doc": "Canonical HME service registry. Consumers should derive health URLs, heartbeat files, and startup hints from here instead of hardcoding ports in doctors, pulse probes, and docs.",
  "services": [
    {
      "id": "proxy",
      "kind": "http",
      "description": "Anthropic-compatible proxy and middleware pipeline",
      "env_port": "HME_PROXY_PORT",
      "default_port": 9099,
      "host": "127.0.0.1",
      "health_path": "/health",
      "required": true,
      "pid_label": "proxy",
      "stop_group": "proxy_bundle",
      "timeout_sec": 3,
      "start": ["tools/HME/hooks/direct/proxy-supervisor.sh", "start"],
      "pid_file": "tools/HME/runtime/proxy-supervisor.pid",
      "process_patterns": ["hme_proxy.js"],
      "log_file": "log/hme-proxy.out",
      "fix": "tools/HME/hooks/direct/proxy-supervisor.sh start"
    },
    {
      "id": "proxy_a",
      "kind": "http",
      "description": "Active-active proxy backend slot A (shuffler forwards to whichever of a/b is routable)",
      "env_port": "HME_PROXY_BACKEND_A_PORT",
      "default_port": 9100,
      "host": "127.0.0.1",
      "health_path": "/health",
      "required": false,
      "pid_label": "proxy_a",
      "stop_group": "proxy_bundle",
      "timeout_sec": 3,
      "process_patterns": ["hme_proxy.js"],
      "heartbeat_file": "tools/HME/runtime/proxy-a.health",
      "drain_flag": "tools/HME/runtime/proxy-a.drain.flag",
      "restart_throttle_sentinel": "tools/HME/runtime/proxy-restart-a.ts",
      "log_file": "log/hme-proxy-a.out",
      "fix": "tools/HME/launcher/polychron-proxy-restart.sh --slot a"
    },
    {
      "id": "proxy_b",
      "kind": "http",
      "description": "Active-active proxy backend slot B (shuffler forwards to whichever of a/b is routable)",
      "env_port": "HME_PROXY_BACKEND_B_PORT",
      "default_port": 9101,
      "host": "127.0.0.1",
      "health_path": "/health",
      "required": false,
      "pid_label": "proxy_b",
      "stop_group": "proxy_bundle",
      "timeout_sec": 3,
      "process_patterns": ["hme_proxy.js"],
      "heartbeat_file": "tools/HME/runtime/proxy-b.health",
      "drain_flag": "tools/HME/runtime/proxy-b.drain.flag",
      "restart_throttle_sentinel": "tools/HME/runtime/proxy-restart-b.ts",
      "log_file": "log/hme-proxy-b.out",
      "fix": "tools/HME/launcher/polychron-proxy-restart.sh --slot b"
    },
    {
      "id": "worker",
      "kind": "http",
      "description": "HME MCP worker",
      "env_port": "HME_WORKER_PORT",
      "default_port": 9098,
      "host": "127.0.0.1",
      "health_path": "/health",
      "required": true,
      "supervised_by": "proxy",
      "pid_label": "worker",
      "stop_group": "proxy_bundle",
      "timeout_sec": 3,
      "process_patterns": ["worker.py"],
      "log_file": "log/hme-worker.out",
      "fix": "restart HME proxy; it supervises worker.py"
    },
    {
      "id": "codex_proxy",
      "kind": "http",
      "description": "OpenAI Responses-compatible Codex proxy",
      "env_port": "HME_CODEX_PROXY_PORT",
      "default_port": 9102,
      "host": "127.0.0.1",
      "health_path": "/health",
      "required": false,
      "pid_label": "codex_proxy",
      "stop_group": "codex_proxy",
      "timeout_sec": 3,
      "start": ["tools/HME/hooks/direct/codex-proxy-supervisor.sh", "start"],
      "pid_file": "tools/HME/runtime/codex-proxy.pid",
      "process_patterns": ["codex_proxy.js"],
      "log_file": "log/hme-codex-proxy.out",
      "fix": "tools/HME/hooks/direct/codex-proxy-supervisor.sh start"
    },
    {
      "id": "llamacpp_daemon",
      "kind": "http",
      "description": "Local llama.cpp daemon",
      "env_port": "HME_LLAMACPP_DAEMON_PORT",
      "default_port": 7735,
      "host": "127.0.0.1",
      "health_path": "/health",
      "required": false,
      "supervised_by": "proxy",
      "pid_label": "llamacpp_daemon",
      "stop_group": "proxy_bundle",
      "timeout_sec": 3,
      "process_patterns": ["llamacpp_daemon"],
      "log_file": "log/hme-llamacpp_daemon.out",
      "fix": "enable/start local inference daemon when local synthesis is required"
    },
    {
      "id": "omniroute",
      "kind": "http",
      "description": "OpenAI/Anthropic translation router used by OVERDRIVE_MODE=1",
      "env_port": "HME_OMNIROUTE_PORT",
      "default_port": 20128,
      "host": "127.0.0.1",
      "health_path": "/v1/models",
      "required": false,
      "pid_label": "omniroute",
      "stop_group": "omniroute",
      "timeout_sec": 3,
      "enabled_when": {
        "env": "OVERDRIVE_MODE",
        "in": ["1"],
        "unless_env": "HME_OMNIROUTE_OFF",
        "unless_value": "1"
      },
      "start": ["tools/omniroute/start.sh"],
      "process_patterns": ["node_modules/.bin/omniroute", "omniroute --no-open"],
      "log_file": "log/omniroute.out",
      "fix": "tools/omniroute/start.sh"
    },
    {
      "id": "universal_pulse",
      "kind": "heartbeat",
      "description": "Out-of-band health pulse and active probe loop",
      "heartbeat_file": "tmp/hme-universal-pulse.heartbeat",
      "max_age_sec": 90,
      "required": true,
      "pid_label": "universal_pulse",
      "stop_group": "pulse",
      "start": ["tools/HME/hooks/direct/universal-pulse-supervisor.sh", "start"],
      "pid_file": "tools/HME/runtime/universal-pulse-supervisor.pid",
      "log_file": "log/hme-errors.log",
      "fix": "tools/HME/hooks/direct/universal-pulse-supervisor.sh start"
    }
  ]
}