Configuration

Client configuration values and config-file helpers.

RuntaConfig

Selects the API endpoint, credentials, config file, and request timeout.

RuntaConfig declaration

interface RuntaConfig

RuntaConfig properties

Name	Type	Description
configPath?	string	Configuration file path.
endpoint?	string	Resolved Runta API endpoint.
fetch?	(input: URL | RequestInfo, init?: RequestInit) => Promise<Response>	Custom Fetch implementation.
timeoutMs?	number	Request timeout in milliseconds.
token?	string	Bearer token used for authentication.
userAgent?	string	User-Agent header sent with requests.

DEFAULT_ENDPOINT

Default Runta control-plane endpoint.

DEFAULT_ENDPOINT declaration

const DEFAULT_ENDPOINT: "https://api.runta.dev"

readRuntaConfig

Reads endpoint and token values from the Runta TOML config file.

readRuntaConfig signature

function readRuntaConfig(configPath?: string): { endpoint?: string; token?: string }

Parameters

Name	Type	Default	Description
configPath?	string	Optional	Path to the Runta TOML configuration file.

Returns

• { endpoint?: string; token?: string }

resolveConfig

Resolves explicit, environment, and config-file client settings.

resolveConfig signature

function resolveConfig(input: { configPath?: string; endpoint?: string; token?: string }): ResolvedConfig

Parameters

Name	Type	Default	Description
input	{ configPath?: string; endpoint?: string; token?: string }	Required	Explicit client configuration values.

Returns

• ResolvedConfig