golem-add-config-moonbit

Annotate a struct with #derive.config to generate ConfigField implementations, then add a @config.Config[T] parameter to the agent's new function. The platform loads and validates all config values at agent construction time, accessible via self.config.value.

Wrap sensitive fields in @config.Secret[T] inside your config struct and retrieve values with get!(). Secrets are stored per environment and fetched dynamically on each call, managed via secretDefaults in golem.yaml or the golem secret create CLI command.

Supported types include String, Bool, Int, UInt, Int64, UInt64, Float, Double, Byte, Char, Bytes, plus optional T?, Array[T], Result[T, E], and nested #derive.config structs. Generic structs and config types nested inside containers are not supported.

No, #derive.config types cannot be nested inside Option, Array, Result, or Tuple containers. Only direct nesting of one config struct inside another is allowed, and Secret cannot wrap a derived config type.

Regular config values are loaded once during agent construction via @config.load_config(). Secret values are not cached; each get!() call fetches the current value from the host, and the platform validates all required values at deploy time.