application

type AsyncConfig struct {
	Store        *jobs.SQLStore
	Authorize    jobs.Authorizer
	TTL          time.Duration
	ErrorTTL     time.Duration
	Notify       func(context.Context, *xasync.Job) error
	FS           afs.Service
	Notification xasync.Notification
	// Empty JobURL disables polling, while schedule/status/external dispatch stay
	// available. Notification.Destination independently selects publication.
	Watch jobstorage.WatchConfig
}

type Build struct {
	Documentation xdocs.Source
	Components    []*registry.RegisteredComponent
	// Observability is application-owned; configure it through application.New.
	// Stage-local observation options are rejected before constructing a runtime.
	RuntimeOptions []runtime.Option
	MCP            mcp.Config
	// HTTP is validated with the rest of the stage before publication. Manager
	// supplies its shared server lifetime; stages must not supply Warmup.Lifetime.
	HTTP   gateway.Config
	Logger xlogger.Logger
	// BootstrapLogger emits source/index lifecycle diagnostics without enabling
	// request logging for protocol handlers.
	BootstrapLogger xlogger.Logger
	Version         string
	// Resources is the stage-owned filesystem authority shared by all compilers,
	// runtime binding and MCP. Conflicting explicitly configured stores fail.
	Resources *resource.Store
	// Types is the actual staged catalog consumed by component compilation when
	// that compiler creates its own detached catalog. Nil uses Compile's input.
	Types *typecatalog.Catalog
	// Index publishes bootstrap route/MCP metadata without compiling every
	// component. Materializer is invoked once per used component and generation.
	Index        *bootstrapindex.Snapshot
	Materializer bootstrapindex.Materializer
	// Preload names only explicitly configured startup consumers such as cache
	// warmup or async routes; unrelated indexed components remain lazy.
	Preload []spec.Key
	// Shutdown owns stage-local external resources such as database handles.
	// After publication, Manager calls it exactly once when the generation has
	// retired and all admitted requests have released their generation lease. A
	// failed stage is also shut down before Reload returns.
	Shutdown func(context.Context) error
}

type Manager struct {
	// contains filtered or unexported fields
}

type Metadata struct {
	Revision   uint64            `json:"revision"`
	Components []*spec.Component `json:"components"`
}

type Option func(*options) error

type Request struct {
	// Revision is the monotonic revision of the complete authored source set.
	Revision uint64
	// Compile receives a detached catalog. It must compile the complete source
	// set and all plans before returning, without side effects on active services.
	Compile func(context.Context, *typecatalog.Catalog) (*Build, error)
}