iatoolkit 0.59.1__py3-none-any.whl → 0.67.0__py3-none-any.whl

iatoolkit/locales/es.yaml

@@ -0,0 +1,163 @@
+    # locales/es.yaml
+    ui:
+      login_widget:
+        title: "Iniciar Sesión"
+        welcome_message: "Ingresa tus credenciales o registrate para acceder a la plataforma IA de Sample Company."
+        email_placeholder: "Correo electrónico"
+        login_button: "Acceder"
+        forgot_password_link: "¿Olvidaste tu contraseña?"
+        no_account_prompt: "¿No tienes una cuenta?"
+        signup_link: "Regístrate"
+
+      signup:
+        title: "Crear una Cuenta"
+        subtitle: "Comienza tu viaje con nosotros hoy."
+        first_name_label: "Nombre"
+        last_name_label: "Apellido"
+        email_label: "Correo Electrónico"
+        password_label: "Contraseña"
+        confirm_password_label: "Confirmar Contraseña"
+        signup_button: "Crear Cuenta"
+        already_have_account: "¿Ya tienes una cuenta?"
+        login_link: "Inicia Sesión"
+        disclaimer: "🔒 Valoramos tu privacidad. Tus datos se usarán exclusivamente para el funcionamiento de la plataforma."
+
+      forgot_password:
+        title: "Recuperar Contraseña"
+        subtitle: "Ingresa tu correo electrónico y te enviaremos un enlace para restablecer tu contraseña."
+        submit_button: "Enviar Enlace de Recuperación"
+        back_to_login: "Volver a Iniciar Sesión"
+
+      change_password:
+        title: "Crear Nueva Contraseña"
+        subtitle: "Estás cambiando la contraseña para <strong>{email}</strong>."
+        temp_code_label: "Código Temporal"
+        temp_code_placeholder: "Revisa tu correo electrónico"
+        new_password_label: "Nueva Contraseña"
+        password_instructions: "Debe contener al menos 8 caracteres, mayúscula, minúscula, número y un carácter especial."
+        confirm_password_label: "Confirmar Nueva Contraseña"
+        save_button: "Guardar Contraseña"
+        back_to_home: "Volver al inicio"
+
+      chat:
+        welcome_message: "¡Hola! ¿En qué te puedo ayudar hoy?"
+        input_placeholder: "Escribe tu consulta aquí..."
+        prompts_available: "Prompts disponibles"
+
+      tooltips:
+        history: "Historial con mis consultas"
+        reload_context: "Forzar Recarga de Contexto"
+        feedback: "Tu feedback es muy importante"
+        usage_guide: "Guía de Uso"
+        onboarding: "Cómo preguntar mejor"
+        logout: "Cerrar sesión"
+        use_prompt_assistant: "Usar Asistente de Prompts"
+        attach_files: "Adjuntar archivos"
+        view_attached_files: "Ver archivos adjuntos"
+      modals:
+        files_title: "Archivos Cargados"
+        feedback_title: "Tu Opinión es Importante"
+        feedback_prompt: "¿Qué tan útil fue la respuesta del asistente?"
+        feedback_comment_label: "Tu comentario nos ayuda a mejorar:"
+        feedback_comment_placeholder: "Escribe aquí tu opinión, sugerencias o comentarios..."
+        history_title: "Historial de Consultas"
+        history_table_date: "Fecha"
+        history_table_query: "Consulta"
+        loading_history: "Cargando historial..."
+        no_history_found: "No se encontró historial de consultas."
+        help_title: "Guía de uso del Asistente IA"
+
+      buttons:
+        cancel: "Cerrar"
+        send: "Enviar"
+        stop: "Detener"
+
+    errors:
+      company_not_found: "La empresa {company_short_name} no existe."
+      timeout: "El tiempo de espera ha expirado."
+
+
+      auth:
+        invalid_password: "La contraseña proporcionada es incorrecta."
+        user_not_found: "No se encontró un usuario con ese correo."
+        invalid_or_expired_token: "Token inválido o expirado."
+        session_creation_failed: "No se pudo crear la sesión del usuario."
+        authentication_required: "Autenticación requerida. No se proporcionó cookie de sesión o clave de API."
+        invalid_api_key: "Clave de API inválida o inactiva."
+        no_user_identifier_api: "No se proporcionó user_identifier para la llamada a la API."
+      templates:
+        company_not_found: "Empresa no encontrada."
+        home_template_not_found: "La plantilla de la página de inicio para la empresa '{company_name}' no está configurada."
+        processing_error: "Error al procesar el template: {error}"
+        template_not_found: "No se encontro el template: '{template_name}'."
+
+      general:
+        unexpected_error: "Ha ocurrido un error inesperado: {error}."
+        unsupported_language: "El idioma seleccionado no es válido."
+      signup:
+        company_not_found: "La empresa {company_name} no existe."
+        incorrect_password_for_existing_user: "La contraseña para el usuario {email} es incorrecta."
+        user_already_registered: "El usuario con email '{email}' ya existe en esta empresa."
+        password_mismatch: "Las contraseñas no coinciden. Por favor, inténtalo de nuevo."
+      change_password:
+        token_expired: "El enlace de cambio de contraseña ha expirado. Por favor, solicita uno nuevo."
+        password_mismatch: "Las contraseñas no coinciden. Por favor, inténtalo nuevamente."
+        invalid_temp_code: "El código temporal no es válido. Por favor, verifica o solicita uno nuevo."
+      forgot_password:
+        user_not_registered: "El usuario con correo {email} no está registrado."
+      verification:
+        token_expired: "El enlace de verificación ha expirado. Por favor, contacta a soporte si necesitas uno nuevo."
+        user_not_found: "El usuario que intentas verificar no existe."
+      validation:
+        password_too_short: "La contraseña debe tener al menos 8 caracteres."
+        password_no_uppercase: "La contraseña debe tener al menos una letra mayúscula."
+        password_no_lowercase: "La contraseña debe tener al menos una letra minúscula."
+        password_no_digit: "La contraseña debe tener al menos un número."
+        password_no_special_char: "La contraseña debe tener al menos un carácter especial."
+
+      services:
+        no_text_file: "El archivo no es texto o la codificación no es UTF-8"
+        no_output_file: "falta el nombre del archivo de salida"
+        no_data_for_excel: "faltan los datos  o no es una lista de diccionarios"
+        no_download_directory: "no esta configurado el directorio temporal para guardar excels"
+        cannot_create_excel: "no se pudo crear el archivo excel"
+        invalid_filename: "Nombre de archivo inválido"
+        file_not_exist : "Archivo no encontrado"
+        path_is_not_a_file : "La ruta no corresponde a un archivo"
+        file_validation_error : "Error validando archivo"
+        user_not_authorized: "Usuario no esta autorizado para esta empresa"
+        account_not_verified: "Tu cuenta no ha sido verificada. Por favor, revisa tu correo."
+        missing_response_id: "No se encontró 'previous_response_id' para '{company_short_name}/{user_identifier}'. Reinicia el contexto."
+
+    api_responses:
+      context_reloaded_success: "El contexto se ha recargado con éxito."
+
+    services:
+      mail_sent: "mail enviado exitosamente."
+      start_query: "Hola, cual es tu pregunta?"
+
+    flash_messages:
+      password_changed_success: "Tu contraseña ha sido restablecida exitosamente. Ahora puedes iniciar sesión."
+      signup_success: "Registro exitoso. Por favor, revisa tu correo para verificar tu cuenta."
+      user_associated_success: "Usuario existente asociado exitosamente a la nueva empresa."
+      account_verified_success: "Tu cuenta ha sido verificada exitosamente. ¡Bienvenido!"
+      forgot_password_success: "Si tu correo está registrado, recibirás un enlace para restablecer tu contraseña."
+
+    # Claves específicas para JavaScript
+    js_messages:
+      feedback_sent_success_title: "Feedback Enviado"
+      feedback_sent_success_body: "¡Gracias por tu comentario!"
+      feedback_sent_error: "No se pudo enviar el feedback, por favor intente nuevamente."
+      feedback_rating_error: "Por favor, califica al asistente con las estrellas."
+      feedback_comment_error: "Por favor, escribe tu comentario antes de enviar."
+      context_reloaded: "El contexto ha sido recargado."
+      error_loading_history: "Ocurrió un error al cargar el historial."
+      request_aborted: "La generación de la respuesta ha sido detenida."
+      processing_error: "Ocurrió un error al procesar la solicitud."
+      server_comm_error: "Error de comunicación con el servidor ({status}). Por favor, intente de nuevo más tarde."
+      network_error: "Ocurrió un error de red. Por favor, inténtalo de nuevo en unos momentos."
+      unknown_server_error: "Error desconocido del servidor."
+      loading: "Cargando..."
+      reload_init: "Iniciando recarga de contexto en segundo plano..."
+      no_history_found: "No existe historial de consultas."
+

iatoolkit/repositories/database_manager.py

@@ -27,8 +27,8 @@ class DatabaseManager:
             self._engine = create_engine(
                 database_url,
                 echo=False,
-                pool_size=2,  # per worker
-                max_overflow=3,
+                pool_size=10,  # per worker
+                max_overflow=20,
                 pool_timeout=30,
                 pool_recycle=1800,
                 pool_pre_ping=True,
@@ -77,7 +77,7 @@ class DatabaseManager:
         inspector = inspect(self._engine)
 
         if table_name not in inspector.get_table_names():
-            raise RuntimeError(f"La tabla '{table_name}' no existe en la BD.")
+            raise RuntimeError(f"Table '{table_name}' does not exist.")
 
         if exclude_columns is None:
             exclude_columns = []

iatoolkit/repositories/document_repo.py

@@ -22,7 +22,7 @@ class DocumentRepo:
     def get(self, company_id, filename: str ) -> Document:
         if not company_id or not filename:
             raise IAToolkitException(IAToolkitException.ErrorType.PARAM_NOT_FILLED,
-                               'Falta empresa o filename')
+                               'missing company_id or filename')
 
         return self.session.query(Document).filter_by(company_id=company_id, filename=filename).first()
 

iatoolkit/repositories/models.py

@@ -53,14 +53,12 @@ class Company(Base):
     id = Column(Integer, primary_key=True)
     short_name = Column(String(20), nullable=False, unique=True, index=True)
     name = Column(String(256), nullable=False)
+    default_language = Column(String(5), nullable=False, default='es')
 
     # encrypted api-key
     openai_api_key = Column(String, nullable=True)
     gemini_api_key = Column(String, nullable=True)
-
-    branding = Column(JSON, nullable=True)
-    onboarding_cards = Column(JSON, nullable=True)
-    parameters = Column(JSON, nullable=True, default={})
+    parameters = Column(JSON, nullable=True)
     created_at = Column(DateTime, default=datetime.now)
     allow_jwt = Column(Boolean, default=True, nullable=True)
 
@@ -107,6 +105,7 @@ class User(Base):
     created_at = Column(DateTime, default=datetime.now)
     password = Column(String, nullable=False)
     verified = Column(Boolean, nullable=False, default=False)
+    preferred_language = Column(String(5), nullable=True)
     verification_url = Column(String, nullable=True)
     temp_code = Column(String, nullable=True)
 

iatoolkit/repositories/profile_repo.py

@@ -74,10 +74,6 @@ class ProfileRepo:
         if company:
             if company.parameters != new_company.parameters:
                 company.parameters = new_company.parameters
-            if company.branding != new_company.branding:
-                company.branding = new_company.branding
-            if company.onboarding_cards != new_company.onboarding_cards:
-                company.onboarding_cards = new_company.onboarding_cards
         else:
             # Si la compañía no existe, la añade a la sesión.
             self.session.add(new_company)

iatoolkit/services/auth_service.py

@@ -7,6 +7,7 @@ from flask import request
 from injector import inject
 from iatoolkit.services.profile_service import ProfileService
 from iatoolkit.services.jwt_service import JWTService
+from iatoolkit.services.i18n_service import I18nService
 from iatoolkit.repositories.database_manager import DatabaseManager
 from iatoolkit.repositories.models import AccessLog
 from flask import request
@@ -23,18 +24,20 @@ class AuthService:
     @inject
     def __init__(self, profile_service: ProfileService,
                  jwt_service: JWTService,
-                 db_manager: DatabaseManager
+                 db_manager: DatabaseManager,
+                 i18n_service: I18nService
                  ):
         self.profile_service = profile_service
         self.jwt_service = jwt_service
         self.db_manager = db_manager
+        self.i18n_service = i18n_service
 
     def login_local_user(self, company_short_name: str, email: str, password: str) -> dict:
         # try to autenticate a local user, register the event and return the result
         auth_response = self.profile_service.login(
             company_short_name=company_short_name,
             email=email,
-            password=password
+            password=password,
         )
 
         if not auth_response.get('success'):
@@ -66,7 +69,7 @@ class AuthService:
                 outcome='failure',
                 reason_code='JWT_INVALID'
             )
-            return {'success': False, 'error': 'Token inválido o expirado'}
+            return {'success': False, 'error': self.i18n_service.t('errors.auth.invalid_or_expired_token')}
 
         # 2. if token is valid, extract the user_identifier
         user_identifier = payload.get('user_identifier')
@@ -81,7 +84,7 @@ class AuthService:
             )
             return {'success': True, 'user_identifier': user_identifier}
         except Exception as e:
-            logging.error(f"Error al crear la sesión desde token para {user_identifier}: {e}")
+            logging.error(f"error creeating session for Token of {user_identifier}: {e}")
             self.log_access(
                 company_short_name=company_short_name,
                 auth_type='redeem_token',
@@ -89,11 +92,12 @@ class AuthService:
                 reason_code='SESSION_CREATION_FAILED',
                 user_identifier=user_identifier
             )
-            return {'success': False, 'error': 'No se pudo crear la sesión del usuario'}
+            return {'success': False, 'error': self.i18n_service.t('errors.auth.session_creation_failed')}
 
-    def verify(self) -> dict:
+    def verify(self, anonymous: bool = False) -> dict:
         """
         Verifies the current request and identifies the user.
+        If anonymous is True the non-presence of use_identifier is ignored
 
         Returns a dictionary with:
         - success: bool
@@ -109,7 +113,7 @@ class AuthService:
             return {
                 "success": True,
                 "company_short_name": session_info['company_short_name'],
-                "user_identifier": session_info['user_identifier']
+                "user_identifier": session_info['user_identifier'],
             }
 
         # --- Priority 2: Check for a valid API Key in headers ---
@@ -118,31 +122,39 @@ class AuthService:
         if isinstance(auth, str) and auth.lower().startswith('bearer '):
             api_key =  auth.split(' ', 1)[1].strip()
 
-        if api_key:
-            api_key_entry = self.profile_service.get_active_api_key_entry(api_key)
-            if not api_key_entry:
-                logging.info(f"Invalid or inactive API Key {api_key}")
-                return {"success": False, "error_message": "Invalid or inactive API Key", "status_code": 401}
+        if not api_key:
+            # --- Failure: No valid credentials found ---
+            logging.info(f"Authentication required. No session cookie or API Key provided.")
+            return {"success": False,
+                    "error_message": self.i18n_service.t('errors.auth.authentication_required'),
+                    "status_code": 401}
+
+        # check if the api-key is valid and active
+        api_key_entry = self.profile_service.get_active_api_key_entry(api_key)
+        if not api_key_entry:
+            logging.info(f"Invalid or inactive API Key {api_key}")
+            return {"success": False,
+                    "error_message": self.i18n_service.t('errors.auth.invalid_api_key'),
+                    "status_code": 402}
+
+        # get the company from the api_key_entry
+        company = api_key_entry.company
+
+        # For API calls, the external_user_id must be provided in the request.
+        data = request.get_json(silent=True) or {}
+        user_identifier = data.get('user_identifier', '')
+        if not anonymous and not user_identifier:
+            logging.info(f"No user_identifier provided for API call.")
+            return {"success": False,
+                    "error_message": self.i18n_service.t('errors.auth.no_user_identifier_api'),
+                    "status_code": 403}
+
+        return {
+            "success": True,
+            "company_short_name": company.short_name,
+            "user_identifier": user_identifier
+        }
 
-            # obtain the company from the api_key_entry
-            company = api_key_entry.company
-
-            # For API calls, the external_user_id must be provided in the request.
-            user_identifier = ''
-            if request.is_json:
-                data = request.get_json() or {}
-                user_identifier = data.get('user_identifier', '')
-
-            return {
-                "success": True,
-                "company_short_name": company.short_name,
-                "user_identifier": user_identifier
-            }
-
-        # --- Failure: No valid credentials found ---
-        logging.info(f"Authentication required. No session cookie or API Key provided. session: {str(session_info)}")
-        return {"success": False, "error_message": "Authentication required. No session cookie or API Key provided.",
-                "status_code": 402}
 
     def log_access(self,
                    company_short_name: str,
@@ -177,5 +189,5 @@ class AuthService:
             session.commit()
 
         except Exception as e:
-            logging.error(f"Fallo al escribir en AccessLog: {e}", exc_info=False)
+            logging.error(f"error writting to AccessLog: {e}", exc_info=False)
             session.rollback()

iatoolkit/services/branding_service.py

@@ -4,14 +4,17 @@
 # IAToolkit is open source software.
 
 from iatoolkit.repositories.models import Company
+from iatoolkit.services.configuration_service import ConfigurationService
+from injector import inject
 
 
 class BrandingService:
     """
-    Servicio centralizado que gestiona la configuración de branding.
+    Branding configuration for IAToolkit
     """
-
-    def __init__(self):
+    @inject
+    def __init__(self, config_service: ConfigurationService):
+        self.config_service = config_service
         """
         Define los estilos de branding por defecto para la aplicación.
         """
@@ -19,13 +22,16 @@ class BrandingService:
             # --- Estilos del Encabezado Principal ---
             "header_background_color": "#FFFFFF",
             "header_text_color": "#6C757D",
-            "primary_font_weight": "bold",
-            "primary_font_size": "1rem",
-            "secondary_font_weight": "600",
-            "secondary_font_size": "0.875rem",
-            "tertiary_font_weight": "normal",
-            "tertiary_font_size": "0.75rem",
-            "tertiary_opacity": "0.8",
+            "primary_font_weight": "600",
+            "primary_font_size": "1.2rem",
+            "secondary_font_weight": "400",
+            "secondary_font_size": "0.9rem",
+            "tertiary_font_weight": "300",
+            "tertiary_font_size": "0.8rem",
+            "tertiary_opacity": "0.7",
+
+            # headings
+            "brand_text_heading_color": "#334155",  # Gris pizarra por defecto
 
             # Estilos Globales de la Marca ---
             "brand_primary_color": "#0d6efd",  # Azul de Bootstrap por defecto
@@ -40,25 +46,27 @@ class BrandingService:
             "brand_danger_border": "#f5c2c7",  # Borde rojo intermedio
 
             # Estilos para Alertas Informativas ---
-            "brand_info_bg": "#cff4fc",  # Fondo celeste pálido
-            "brand_info_text": "#055160",  # Texto azul oscuro
-            "brand_info_border": "#b6effb",
+            "brand_info_bg": "#F0F4F8",         # Un fondo de gris azulado muy pálido
+            "brand_info_text": "#0d6efd",       # Texto en el color primario
+            "brand_info_border": "#D9E2EC",     # Borde de gris azulado pálido
 
             # Estilos para el Asistente de Prompts ---
             "prompt_assistant_bg": "#f8f9fa",
             "prompt_assistant_border": "#dee2e6",
-            "prompt_assistant_icon_color": "#6c757d",
             "prompt_assistant_button_bg": "#FFFFFF",
             "prompt_assistant_button_text": "#495057",
             "prompt_assistant_button_border": "#ced4da",
             "prompt_assistant_dropdown_bg": "#f8f9fa",
             "prompt_assistant_header_bg": "#e9ecef",
             "prompt_assistant_header_text": "#495057",
-            "prompt_assistant_item_hover_bg": None,  # Usará el primario por defecto
-            "prompt_assistant_item_hover_text": None,  # Usará el texto sobre primario
+
+            # this use the primary by default
+            "prompt_assistant_icon_color": None,
+            "prompt_assistant_item_hover_bg": None,
+            "prompt_assistant_item_hover_text": None,
 
             # Color para el botón de Enviar ---
-            "send_button_color": "#212529"  # Gris oscuro/casi negro por defecto
+            "send_button_color": "#212529"          # Gris oscuro/casi negro por defecto
         }
 
     def get_company_branding(self, company: Company | None) -> dict:
@@ -68,8 +76,9 @@ class BrandingService:
         """
         final_branding_values = self._default_branding.copy()
 
-        if company and company.branding:
-            final_branding_values.update(company.branding)
+        if company:
+            branding_data = self.config_service.get_company_content(company.short_name, 'branding')
+            final_branding_values.update(branding_data)
 
         # Función para convertir HEX a RGB
         def hex_to_rgb(hex_color):
@@ -80,10 +89,6 @@ class BrandingService:
         secondary_rgb = hex_to_rgb(final_branding_values['brand_secondary_color'])
 
         # --- CONSTRUCCIÓN DE ESTILOS Y VARIABLES CSS ---
-        header_style = (
-            f"background-color: {final_branding_values['header_background_color']}; "
-            f"color: {final_branding_values['header_text_color']};"
-        )
         primary_text_style = (
             f"font-weight: {final_branding_values['primary_font_weight']}; "
             f"font-size: {final_branding_values['primary_font_size']};"
@@ -103,6 +108,10 @@ class BrandingService:
             :root {{
                 --brand-primary-color: {final_branding_values['brand_primary_color']};
                 --brand-secondary-color: {final_branding_values['brand_secondary_color']};
+                --brand-header-bg: {final_branding_values['header_background_color']};
+                --brand-header-text: {final_branding_values['header_text_color']};
+                --brand-text-heading-color: {final_branding_values['brand_text_heading_color']};
+
                 --brand-primary-color-rgb: {', '.join(map(str, primary_rgb))};
                 --brand-secondary-color-rgb: {', '.join(map(str, secondary_rgb))};
                 --brand-text-on-primary: {final_branding_values['brand_text_on_primary']};
@@ -114,11 +123,11 @@ class BrandingService:
                 --brand-danger-text: {final_branding_values['brand_danger_text']};
                 --brand-danger-border: {final_branding_values['brand_danger_border']};
                 --brand-info-bg: {final_branding_values['brand_info_bg']};
-                --brand-info-text: {final_branding_values['brand_info_text']};
+                --brand-info-text: {final_branding_values['brand_info_text'] or final_branding_values['brand_primary_color']};
                 --brand-info-border: {final_branding_values['brand_info_border']};
                 --brand-prompt-assistant-bg: {final_branding_values['prompt_assistant_bg']};
                 --brand-prompt-assistant-border: {final_branding_values['prompt_assistant_border']};
-                --brand-prompt-assistant-icon-color: {final_branding_values['prompt_assistant_icon_color']};
+                --brand-prompt-assistant-icon-color: {final_branding_values['prompt_assistant_icon_color'] or final_branding_values['brand_primary_color']};
                 --brand-prompt-assistant-button-bg: {final_branding_values['prompt_assistant_button_bg']};
                 --brand-prompt-assistant-button-text: {final_branding_values['prompt_assistant_button_text']};
                 --brand-prompt-assistant-button-border: {final_branding_values['prompt_assistant_button_border']};
@@ -133,11 +142,10 @@ class BrandingService:
 
         return {
             "name": company.name if company else "IAToolkit",
-            "header_style": header_style,
             "primary_text_style": primary_text_style,
             "secondary_text_style": secondary_text_style,
             "tertiary_text_style": tertiary_text_style,
             "header_text_color": final_branding_values['header_text_color'],
             "css_variables": css_variables,
-            "send_button_color": final_branding_values['send_button_color']
+            "send_button_color": final_branding_values['brand_primary_color']
         }

iatoolkit/services/configuration_service.py

@@ -0,0 +1,140 @@
+# iatoolkit/services/configuration_service.py
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+
+from pathlib import Path
+from iatoolkit import BaseCompany
+from iatoolkit.repositories.profile_repo import ProfileRepo
+from iatoolkit.repositories.models import Company
+from iatoolkit.common.util import Utility
+from injector import inject
+import logging
+
+class ConfigurationService:
+    """
+    Orchestrates the configuration of a Company by reading its YAML files
+    and using the BaseCompany's protected methods to register settings.
+    """
+
+    @inject
+    def __init__(self,
+                 profile_repo: ProfileRepo,
+                 utility: Utility):
+        self.profile_repo = profile_repo
+        self.utility = utility
+        self._loaded_configs = {}   # cache for store loaded configurations
+
+    def get_company_content(self, company_short_name: str, content_key: str) -> dict | list | None:
+        """
+        Public method to provide a specific section of a company's configuration.
+        It uses a cache to avoid reading files from disk on every call.
+        """
+        self._ensure_config_loaded(company_short_name)
+        return self._loaded_configs[company_short_name].get(content_key)
+
+    def register_company(self, company_short_name: str, company_instance: BaseCompany):
+        """
+        Main entry point for configuring a company instance.
+        This method is invoked by the dispatcher for each registered company.
+        """
+        logging.info(f"⚙️  Starting configuration for company '{company_short_name}'...")
+
+        # 1. identify the instance with his name and load info from database
+        company_instance.id = company_short_name
+        company_instance.company = self.profile_repo.get_company_by_short_name(company_short_name)
+
+        # 2. Load the main configuration file and supplementary content files
+        config = self._load_and_merge_configs(company_short_name)
+
+        # 3. Register core company details and get the database object
+        company_db_object = self._register_core_details(company_instance, config)
+
+        # 4. Register tools (functions)
+        self._register_tools(company_instance, config.get('tools', []))
+
+        # 5. Register prompt categories and prompts
+        self._register_prompts(company_instance, config)
+
+        # 6. Link the persisted Company object back to the running instance
+        company_instance.company = company_db_object
+
+        logging.info(f"✅ Company '{company_short_name}' configured successfully.")
+
+    def _ensure_config_loaded(self, company_short_name: str):
+        """
+        Checks if the configuration for a company is in the cache.
+        If not, it loads it from files and stores it.
+        """
+        if company_short_name not in self._loaded_configs:
+            self._loaded_configs[company_short_name] = self._load_and_merge_configs(company_short_name)
+
+    def _load_and_merge_configs(self, company_short_name: str) -> dict:
+        """
+        Loads the main company.yaml and merges data from supplementary files
+        specified in the 'content_files' section.
+        """
+        config_dir = Path("companies") / company_short_name / "config"
+        main_config_path = config_dir / "company.yaml"
+
+        if not main_config_path.exists():
+            raise FileNotFoundError(f"Main configuration file not found: {main_config_path}")
+
+        config = self.utility.load_schema_from_yaml(main_config_path)
+
+        # Load and merge supplementary content files (e.g., onboarding_cards)
+        for key, file_path in config.get('help_files', {}).items():
+            supplementary_path = config_dir / file_path
+            if supplementary_path.exists():
+                config[key] = self.utility.load_schema_from_yaml(supplementary_path)
+            else:
+                logging.warning(f"⚠️  Warning: Content file not found: {supplementary_path}")
+                config[key] = None  # Ensure the key exists but is empty
+
+        return config
+
+    def _register_core_details(self, company_instance: BaseCompany, config: dict) -> Company:
+        """Calls _create_company with data from the merged YAML config."""
+        return company_instance._create_company(
+            name=config['name'],
+            short_name=config['id'],
+            parameters=config.get('parameters', {})
+        )
+
+    def _register_tools(self, company_instance: BaseCompany, tools_config: list):
+        """Calls _create_function for each tool defined in the YAML."""
+        for tool in tools_config:
+            company_instance._create_function(
+                function_name=tool['function_name'],
+                description=tool['description'],
+                params=tool['params']
+            )
+
+    def _register_prompts(self, company_instance: BaseCompany, config: dict):
+        """
+        Creates prompt categories first, then creates each prompt and assigns
+        it to its respective category.
+        """
+        prompts_config = config.get('prompts', [])
+        categories_config = config.get('prompt_categories', [])
+
+        created_categories = {}
+        for i, category_name in enumerate(categories_config):
+            category_obj = company_instance._create_prompt_category(name=category_name, order=i + 1)
+            created_categories[category_name] = category_obj
+
+        for prompt_data in prompts_config:
+            category_name = prompt_data.get('category')
+            if not category_name or category_name not in created_categories:
+                logging.info(f"⚠️  Warning: Prompt '{prompt_data['name']}' has an invalid or missing category. Skipping.")
+                continue
+
+            category_obj = created_categories[category_name]
+
+            company_instance._create_prompt(
+                prompt_name=prompt_data['name'],
+                description=prompt_data['description'],
+                order=prompt_data['order'],
+                category=category_obj,
+                active=prompt_data.get('active', True),
+                custom_fields=prompt_data.get('custom_fields', [])
+            )