Skip to content

DEFAULT_AGUI_HOST

const DEFAULT_AGUI_HOST: "127.0.0.1" = '127.0.0.1'

Defined in: _worktrees/docs-release/gaunt-sloth/packages/agent/src/modules/apiAgUiModule.ts:392

The interface the AG-UI server binds when nothing says otherwise: IPv4 loopback.

A default is a decision someone inherits rather than makes, so this one is the safe half of the choice — the server is an unauthenticated agent endpoint, and a wildcard default puts it on the coffee-shop wifi, the office LAN and the container’s published port without anyone deciding that. The LAN client is a real user and keeps a door: --host / commands.api.host.

It is deliberately NOT in DEFAULT_CONFIG. The value has to hold for a programmatic caller of startAgUiServer whose config never went through the loader, and one definition at the bind site cannot drift from a second one in the defaults table. DEFAULT_CONFIG’s prompts key is absent for the same reason: defaulted at the read site.

Exported, and deliberately imported nowhere in this repo — it is not a dangling export. An embedder calling startAgUiServer directly has no flag and no loader to tell it what an omitted host means, and @gaunt-sloth/agent’s exports map reaches this module, so the value is readable rather than guessable; GthConfig’s commands.api.host docblock sends readers here by name. The two CLI doors do not import it on purpose: each passes undefined when its flag is absent so the default is applied once, below, and neither door can outrank the config file with a default of its own. apiCommand.ts also loads this module lazily, inside the action, so a static import for a help string would pull the agent into command registration.