settings

type PairedClient struct {
	ClientID  string    `json:"clientID"`
	Name      string    `json:"name,omitempty"`
	TokenHash string    `json:"tokenHash"`
	CreatedAt time.Time `json:"createdAt"`
}

type PublicTunnelSettings struct {
	Enabled        bool   `json:"enabled"`
	RouteID        string `json:"routeID,omitempty"`
	Owner          string `json:"owner,omitempty"`
	PublicHostname string `json:"publicHostname,omitempty"`
	PathPrefix     string `json:"pathPrefix,omitempty"`
	AuthMode       string `json:"authMode,omitempty"`
}

type RelaySettings struct {
	Enabled    bool   `json:"enabled"`
	URL        string `json:"url,omitempty"`
	HostID     string `json:"hostID,omitempty"`
	RouteID    string `json:"routeID,omitempty"`
	RelayKeyID string `json:"relayKeyID,omitempty"`
	RelayKey   string `json:"relayKey,omitempty"`
	LastError  string `json:"lastError,omitempty"`
}

type Settings struct {
	// DefaultRuntime is the engine used for sessions created without an
	// explicit runtimeKind. Ghostline is the only supported runtime.
	DefaultRuntime string `json:"defaultRuntime"`
	// RuntimeEnv overrides environment variables for newly created session
	// shells. The daemon itself never applies these values to its process
	// environment. An empty value requests an unset in the session shell.
	RuntimeEnv map[string]string `json:"runtimeEnv,omitempty"`
	// Relay contains the non-secret Relay lifecycle and route metadata. The
	// canonical daemon token remains in token-file/platform credentials and is
	// never duplicated here.
	Relay        RelaySettings        `json:"relay,omitempty"`
	PublicTunnel PublicTunnelSettings `json:"publicTunnel,omitempty"`
	// AutoOpenShell controls whether opening an empty workspace creates a
	// default Shell session. Explicit New Session/Shell actions are unaffected.
	AutoOpenShell bool `json:"autoOpenShell"`
	// AutoStartAI controls whether entering an empty workspace starts the first
	// AI preset. Explicit session actions are unaffected.
	AutoStartAI bool `json:"autoStartAI"`
	// OpenAIBaseURL, OpenAIModel, and OpenAIKey configure the optional
	// capability used for automatic session titles. The key is never returned
	// by the settings APIs.
	OpenAIBaseURL      string `json:"openaiBaseURL,omitempty"`
	OpenAIModel        string `json:"openaiModel,omitempty"`
	OpenAIKey          string `json:"openaiKey,omitempty"`
	OpenAITitleEnabled bool   `json:"openaiTitleEnabled"`
	// PairedClients contains metadata for explicitly paired native clients.
	// Only a SHA-256 token hash is persisted; bearer tokens are returned once
	// over the temporary LAN pairing exchange and remain on the client.
	PairedClients []PairedClient `json:"pairedClients,omitempty"`
}