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.
	//
	// Parameters:
	//   - ctx: The context for the registration process.
	//   - serviceConfig: The configuration for the upstream service.
	//   - toolManager: The manager where discovered tools will be registered.
	//   - promptManager: The manager where discovered prompts will be registered.
	//   - resourceManager: The manager where discovered resources will be registered.
	//   - isReload: Indicates whether this is an initial registration or a reload.
	//
	// Returns:
	//   - A unique service key.
	//   - A list of discovered tool definitions.
	//   - A list of discovered resource definitions.
	//   - 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)
}