Method register

src/environment/context.py:457–589

Register an environment class. This will: - Create an environment instance - Create an `EnvironmentConfig` - Store it as the current config and append to version history - Register the version in `version_manager` and FAISS index Args

(self, 
                       env_cls: Type[Environment], 
                       env_config_dict: Optional[Dict[str, Any]] = None,
                       override: bool = False,
                       version: Optional[str] = None)

            raise
    
    async def register(self, 
                       env_cls: Type[Environment], 
                       env_config_dict: Optional[Dict[str, Any]] = None,
                       override: bool = False,
                       version: Optional[str] = None) -> EnvironmentConfig:
        """Register an environment class.
        
        This will:
        - Create an environment instance
        - Create an `EnvironmentConfig`
        - Store it as the current config and append to version history
        - Register the version in `version_manager` and FAISS index
        
        Args:
            env_cls: Environment class
            env_config_dict: Configuration dict for environment initialization.
                           If None, will try to get from global config or use empty dict.
            override: Whether to override existing registration
            version: Optional version string. If None, auto-generates from version_manager.
            
        Returns:
            EnvironmentConfig: Environment configuration
        """
        try:
            if env_config_dict is None:
                # Fallback to global config by class name
                env_config_key = inflection.underscore(env_cls.__name__)
                env_config_dict = getattr(config, env_config_key, {}) if hasattr(config, env_config_key) else {}
            
            # Instantiate environment immediately (register is a runtime operation)
            try:
                env_instance = env_cls(**env_config_dict)
            except Exception as e:
                logger.error(f"| ❌ Failed to create environment instance for {env_cls.__name__}: {e}")
                raise ValueError(f"Failed to instantiate environment {env_cls.__name__} with provided config: {e}")
            
            env_name = env_instance.name
            env_description = env_instance.description
            env_metadata = getattr(env_instance, 'metadata', {})
            env_require_grad = getattr(env_instance, 'require_grad', False)
            
            if not env_name:
                raise ValueError("Environment.name cannot be empty.")
            
            if env_name in self._environment_configs and not override:
                raise ValueError(f"Environment '{env_name}' already registered. Use override=True to replace it.")
            
            # Get or generate version from version_manager
            if version is None:
                env_version = await version_manager.get_version("environment", env_name)
            else:
                env_version = version
            
            # Get environment code
            env_code = dynamic_manager.get_full_module_source(env_cls)
            
            # Build actions from environment class (same as _load_from_registry)
            actions = {}