upstream

type Upstream interface {
	// Shutdown gracefully terminates the upstream service.
	Shutdown(ctx context.Context) error

	// Register inspects the upstream service defined by the serviceConfig,
	// discovers its capabilities, and registers them.
	//
	// ctx is the context for the registration process.
	// serviceConfig contains the configuration for the upstream service.
	// toolManager is the manager where discovered tools will be registered.
	// promptManager is the manager where discovered prompts will be registered.
	// resourceManager is the manager where discovered resources will be registered.
	// isReload indicates whether this is an initial registration or a reload of an
	// existing service.
	// It returns a unique service key, a list of discovered tool definitions, and
	// an error if registration fails.
	Register(
		ctx context.Context,
		serviceConfig *configv1.UpstreamServiceConfig,
		toolManager tool.ManagerInterface,
		promptManager prompt.ManagerInterface,
		resourceManager resource.ManagerInterface,
		isReload bool,
	) (string, []*configv1.ToolDefinition, []*configv1.ResourceDefinition, error)
}