config

type CacheInvalidation struct {
	TimeoutMs int64
	Admin     *gateway.DocumentAccess
}

type CacheProvider struct {
	spec.CacheSettings
	Enabled *bool `json:"enabled,omitempty"`
}

type Config struct {
	// ConstURL identifies one trusted flat YAML/JSON instance constant mapping.
	ConstURL string
	Const    *constant.Values `json:"-"`
	gateway.Config
	URL               string `json:"-"`
	Version           string
	Endpoint          Endpoint
	Info              *openapi3.Info
	GoBootstrap       *Packages
	Warmup            *Warmup
	CacheInvalidation *CacheInvalidation
	Observation       *Observation
	// BaseDir and ModuleDirs locate trusted local source modules. Package selection
	// retains original GoBootstrap names; discovery is owned by transcribe.
	BaseDir    string
	ModuleDirs []string
	Connector  string
	Connectors []connector.Config
	// Caches supplies named reader services. CacheProviders accepts legacy dependency documents.
	Caches         map[string]*spec.CacheSettings
	CacheProviders []*CacheProvider
	JWTValidator   *verifier.Config
	JwtSigner      *signer.Config
	Cognito        *cognito.Config
	Firebase       *firebase.Config
	JWTClaims      *auth.ClaimPolicy
	MCP            *MCP
	RouteURL       string
	PluginsURL     string
	DependencyURL  string
	Jobs           *Jobs
	JobURL         string
	FailedJobURL   string
	MaxJobs        int
}

type Endpoint struct {
	Port int
	// Address is an explicit listener override, including port zero for OS allocation.
	Address             string
	ReadTimeoutMs       int
	ReadHeaderTimeoutMs int
	IdleTimeoutMs       int
	WriteTimeoutMs      int
	MaxHeaderBytes      int
	ShutdownTimeoutMs   int
}

type Jobs struct {
	Connector            string
	Table                string
	Dataset              string
	DisableTableCreation bool
	Notification         xasync.Notification
	TTLSeconds           int64
	ErrorTTLSeconds      int64
	PollIntervalMs       int64
}

type Loader struct {
	// ConstURL overrides the config file selection; its relative path is process-relative.
	ConstURL string
	FS       afs.Service
	// StaticLocalRoot grants an independently selected, caller-owned authority for
	// local ContentURL paths. Such paths stay relative to this handle, not the
	// config file. The caller keeps it open for the server's reload lifetime.
	StaticLocalRoot *os.Root
}

type MCP struct {
	Folders       []resource.Folder
	Port          *int
	Address       string
	Authorization *authorization.Policy
}

type OTel struct {
	Enabled                         bool
	QueueSize, BatchSize, MaxSpans  int
	BatchTimeoutMs, ExportTimeoutMs int64
	ServiceName, ServiceVersion     string
	IncludeSQL                      bool
	HTTP                            otel.HTTPExporter
}

type Observation struct {
	LogSummaries bool
	OTel         *OTel
}

type Packages struct {
	Packages, Exclude []string
	// EagerComponents explicitly opts into compiling every selected component
	// at startup, for example when exporting complete OpenAPI schemas.
	EagerComponents bool
}

type Warmup struct {
	TimeoutMs int64
	Admin     *gateway.DocumentAccess
}