Editing OpenSimulator Internals/Code Map/ROBUST/LoginService (section)

=== LaunchAgentAtGrid() ===

 protected AgentCircuitData LaunchAgentAtGrid(...)

Builds AgentCircuitData via MakeAgent() and launches the agent at the destination region.

Two paths depending on whether UserAgentService is configured:

Without UserAgentService (non-HG or standalone):
* Uses LocalSimulationService if available, else RemoteSimulationService
* Calls LaunchAgentDirectly(): QueryAccess() then CreateAgent()
* On failure: tries fallback regions from GridService.GetFallbackRegions()

With UserAgentService (HG-enabled):
* Constructs gatekeeper GridRegion from m_GatekeeperURL if not already provided
* Calls LaunchAgentIndirectly(): UserAgentService.LoginAgentToGrid()
* On failure: tries fallback regions

Returns AgentCircuitData on success, null on failure.

MakeAgent() populates AgentCircuitData:
* Generates random circuit code
* Sets appearance (or empty AvatarAppearance if none)
* Generates random CapsPath
* Sets child = false (login agent is always root)
* Calls SetServiceURLs()

SetServiceURLs():
* Copies ServiceURLs from UserAccount record
* Overrides with SRV_-prefixed keys from [LoginService] config
* Appends GatekeeperURI if configured
* Calls UserAccountService.StoreUserAccount() if any URLs were updated

----