iatoolkit 0.62.0__tar.gz → 0.64.7__tar.gz

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iatoolkit
-Version: 0.62.0
+Version: 0.64.7
 Summary: IAToolkit
 Author: Fernando Libedinsky
 License-Expression: MIT

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iatoolkit"
-version = "0.62.0"
+version = "0.64.7"
 requires-python = ">=3.12"
 description = "IAToolkit"
 readme = "readme.md"

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/src/iatoolkit/common/routes.py

@@ -5,7 +5,6 @@
 
 from flask import render_template, redirect, url_for,send_from_directory, current_app, abort
 from flask import jsonify
-from iatoolkit.views.history_api_view import HistoryApiView
 
 
 # this function register all the views
@@ -24,6 +23,9 @@ def register_views(injector, app):
     from iatoolkit.views.file_store_api_view import FileStoreApiView
     from iatoolkit.views.user_feedback_api_view import UserFeedbackApiView
     from iatoolkit.views.prompt_api_view import PromptApiView
+    from iatoolkit.views.history_api_view import HistoryApiView
+    from iatoolkit.views.help_content_api_view import HelpContentApiView
+
     from iatoolkit.views.login_view import LoginView, FinalizeContextView
     from iatoolkit.views.external_login_view import ExternalLoginView, RedeemTokenApiView
     from iatoolkit.views.logout_api_view import LogoutApiView
@@ -79,9 +81,10 @@ def register_views(injector, app):
     # open the promt directory
     app.add_url_rule('/<company_short_name>/api/prompts', view_func=PromptApiView.as_view('prompt'))
 
-    # feedback and history
+    # toolbar buttons
     app.add_url_rule('/<company_short_name>/api/feedback', view_func=UserFeedbackApiView.as_view('feedback'))
     app.add_url_rule('/<company_short_name>/api/history', view_func=HistoryApiView.as_view('history'))
+    app.add_url_rule('/<company_short_name>/api/help-content', view_func=HelpContentApiView.as_view('help-content'))
 
     # tasks management endpoints: create task, and review answer
     app.add_url_rule('/tasks', view_func=TaskApiView.as_view('tasks'))

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/src/iatoolkit/iatoolkit.py

@@ -19,7 +19,7 @@ from werkzeug.middleware.proxy_fix import ProxyFix
 from injector import Binder, Injector, singleton
 from importlib.metadata import version as _pkg_version, PackageNotFoundError
 
-IATOOLKIT_VERSION = "0.62.0"
+IATOOLKIT_VERSION = "0.64.7"
 
 # global variable for the unique instance of IAToolkit
 _iatoolkit_instance: Optional['IAToolkit'] = None

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/src/iatoolkit/services/branding_service.py

@@ -4,6 +4,7 @@
 # IAToolkit is open source software.
 
 from iatoolkit.repositories.models import Company
+from injector import inject
 
 
 class BrandingService:
@@ -11,6 +12,7 @@ class BrandingService:
     Servicio centralizado que gestiona la configuración de branding.
     """
 
+    @inject
     def __init__(self):
         """
         Define los estilos de branding por defecto para la aplicación.
@@ -19,13 +21,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 +45,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:
@@ -80,10 +87,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 +106,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 +121,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 +140,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-0.64.7/src/iatoolkit/services/help_content_service.py

@@ -0,0 +1,30 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+from iatoolkit.common.util import Utility
+from iatoolkit.common.exceptions import IAToolkitException
+import os
+from injector import inject
+import logging
+
+
+class HelpContentService:
+    @inject
+    def __init__(self, util: Utility):
+        self.util = util
+
+    def get_content(self, company_short_name: str | None) -> dict:
+        filepath = f'companies/{company_short_name}/help_content.yaml'
+        if not os.path.exists(filepath):
+            return {}
+
+        # read the file
+        try:
+            help_content = self.util.load_schema_from_yaml(filepath)
+            return help_content
+        except Exception as e:
+            logging.exception(e)
+            raise IAToolkitException(IAToolkitException.ErrorType.CONFIG_ERROR,
+                            f"Error obteniendo help de {company_short_name}: {str(e)}") from e

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/src/iatoolkit/services/user_feedback_service.py

@@ -96,7 +96,7 @@ class UserFeedbackService:
                 logging.error(f"No se pudo guardar el feedback para el usuario {user_identifier} en la empresa {company_short_name}")
                 return {'error': 'No se pudo guardar el feedback'}
 
-            return {'message': 'Feedback guardado correctamente'}
+            return {'success': True, 'message': 'Feedback guardado correctamente'}
 
         except Exception as e:
             logging.exception(f"Error crítico en el servicio de feedback: {e}")

iatoolkit-0.64.7/src/iatoolkit/static/js/chat_feedback_button.js

@@ -0,0 +1,82 @@
+$(document).ready(function () {
+    $('#submit-feedback').on('click', function () {
+        sendFeedback(this);
+    });
+
+    // Evento para enviar el feedback
+    async function sendFeedback(submitButton) {
+        toastr.options = {"positionClass": "toast-bottom-right", "preventDuplicates": true};
+        const feedbackText = $('#feedback-text').val().trim();
+        const activeStars = $('.star.active').length;
+
+        if (!feedbackText) {
+            toastr.error('Por favor, escribe tu comentario antes de enviar.');
+            return;
+        }
+
+        if (activeStars === 0) {
+            toastr.error('Por favor, califica al asistente con las estrellas.');
+            return;
+        }
+
+        submitButton.disabled = true;
+
+        // call the IAToolkit API to send feedback
+        const data = {
+            "user_identifier": window.user_identifier,
+            "message": feedbackText,
+            "rating": activeStars,
+        };
+
+        const responseData = await callToolkit('/api/feedback', data, "POST");
+        if (responseData)
+            toastr.success('¡Gracias por tu comentario!', 'Feedback Enviado');
+        else
+            toastr.error('No se pudo enviar el feedback, por favor intente nuevamente.');
+
+        submitButton.disabled = false;
+        $('#feedbackModal').modal('hide');
+    }
+
+// Evento para abrir el modal de feedback
+$('#send-feedback-button').on('click', function () {
+    $('#submit-feedback').prop('disabled', false);
+    $('#submit-feedback').html('<i class="bi bi-send me-1 icon-spaced"></i>Enviar');
+    $('.star').removeClass('active hover-active'); // Resetea estrellas
+    $('#feedback-text').val(''); // Limpia texto
+    $('.modal-body .alert').remove(); // Quita alertas previas
+    $('#feedbackModal').modal('show');
+});
+
+// Evento que se dispara DESPUÉS de que el modal se ha ocultado
+$('#feedbackModal').on('hidden.bs.modal', function () {
+    $('#feedback-text').val('');
+    $('.modal-body .alert').remove();
+    $('.star').removeClass('active');
+});
+
+// Función para el sistema de estrellas
+window.gfg = function (rating) {
+    $('.star').removeClass('active');
+    $('.star').each(function (index) {
+        if (index < rating) {
+            $(this).addClass('active');
+        }
+    });
+};
+
+$('.star').hover(
+    function () {
+        const rating = $(this).data('rating');
+        $('.star').removeClass('hover-active');
+        $('.star').each(function (index) {
+            if ($(this).data('rating') <= rating) {
+                $(this).addClass('hover-active');
+            }
+        });
+    },
+    function () {
+        $('.star').removeClass('hover-active');
+    });
+
+});

iatoolkit-0.64.7/src/iatoolkit/static/js/chat_help_content.js

@@ -0,0 +1,124 @@
+$(document).ready(function () {
+
+    let helpContent = null; // Variable para cachear el contenido de ayuda
+
+    // Evento de clic en el botón de ayuda
+    $('#open-help-button').on('click', async function () {
+        const helpModal = new bootstrap.Modal(document.getElementById('helpModal'));
+        const accordionContainer = $('#help-accordion-container');
+        const spinner = $('#help-spinner');
+
+        // Si el contenido no se ha cargado, hacer la llamada a la API
+        if (helpContent) {
+            // Si el contenido ya está cacheado, solo muestra el modal
+            helpModal.show();
+            return;
+        }
+
+        spinner.show();
+        accordionContainer.hide();
+        helpModal.show();
+
+        try {
+            const helpContent = await callToolkit('/api/help-content', {}, "POST");
+
+            if (!helpContent) {
+                toastr.error('No se pudo cargar la guía de uso. Por favor, intente más tarde.');
+                spinner.hide();
+                helpModal.hide();
+                return;
+            }
+
+            // Construir el HTML del acordeón y mostrarlo
+            buildHelpAccordion(helpContent);
+            spinner.hide();
+            accordionContainer.show();
+
+        } catch (error) {
+            console.error("Error al cargar el contenido de ayuda:", error);
+            toastr.error('Ocurrió un error de red al cargar la guía.');
+            spinner.hide();
+            helpModal.hide();
+        }
+    });
+
+    /**
+     * Construye dinámicamente el HTML para el acordeón de ayuda a partir de los datos.
+     * @param {object} data El objeto JSON con el contenido de ayuda.
+     */
+    function buildHelpAccordion(data) {
+        const container = $('#help-accordion-container');
+        container.empty(); // Limpiar cualquier contenido previo
+
+        let accordionHtml = '';
+
+        if (data.data_sources) {
+            let contentHtml = '<dl>';
+            data.data_sources.forEach(p => {
+                contentHtml += `<dt>${p.source}</dt><dd>${p.description}</dd>`;
+            });
+            contentHtml += `</dl>`;
+            accordionHtml += createAccordionItem('sources', 'Datos disponibles', contentHtml, true);
+        }
+
+        if (data.example_questions) {
+            let contentHtml = '';
+            data.example_questions.forEach(cat => {
+                contentHtml += `<h6 class="fw-bold">${cat.category}</h6><ul>`;
+                cat.questions.forEach(q => contentHtml += `<li>${q}</li>`);
+                contentHtml += `</ul>`;
+            });
+            accordionHtml += createAccordionItem('examples', 'Preguntas de Ejemplo', contentHtml);
+        }
+
+        if (data.best_practices) {
+            let contentHtml = '<dl>';
+            data.best_practices.forEach(p => {
+                contentHtml += `<dt>${p.title}</dt><dd>${p.description}`;
+                if (p.example) {
+                    contentHtml += `<br><small class="text-muted"><em>Ej: "${p.example}"</em></small>`;
+                }
+                contentHtml += `</dd>`;
+            });
+            contentHtml += `</dl>`;
+            accordionHtml += createAccordionItem('practices', 'Mejores Prácticas', contentHtml);
+        }
+
+        if (data.capabilities) {
+            let contentHtml = `<div class="row">`;
+            contentHtml += `<div class="col-md-6"><h6 class="fw-bold">Puede hacer:</h6><ul>${data.capabilities.can_do.map(item => `<li>${item}</li>`).join('')}</ul></div>`;
+            contentHtml += `<div class="col-md-6"><h6 class="fw-bold">No puede hacer:</h6><ul>${data.capabilities.cannot_do.map(item => `<li>${item}</li>`).join('')}</ul></div>`;
+            contentHtml += `</div>`;
+            accordionHtml += createAccordionItem('capabilities', 'Capacidades y Límites', contentHtml);
+        }
+
+        container.html(accordionHtml);
+    }
+
+    /**
+     * Helper para crear un item del acordeón de Bootstrap.
+     * @param {string} id El ID base para los elementos.
+     * @param {string} title El título que se muestra en el botón del acordeón.
+     * @param {string} contentHtml El HTML que va dentro del cuerpo colapsable.
+     * @param {boolean} isOpen Si el item debe estar abierto por defecto.
+     * @returns {string} El string HTML del item del acordeón.
+     */
+    function createAccordionItem(id, title, contentHtml, isOpen = false) {
+        const showClass = isOpen ? 'show' : '';
+        const collapsedClass = isOpen ? '' : 'collapsed';
+
+        return `
+            <div class="accordion-item">
+                <h2 class="accordion-header" id="heading-${id}">
+                    <button class="accordion-button ${collapsedClass}" type="button" data-bs-toggle="collapse" data-bs-target="#collapse-${id}" aria-expanded="${isOpen}" aria-controls="collapse-${id}">
+                        ${title}
+                    </button>
+                </h2>
+                <div id="collapse-${id}" class="accordion-collapse collapse ${showClass}" aria-labelledby="heading-${id}" data-bs-parent="#help-accordion-container">
+                    <div class="accordion-body">
+                        ${contentHtml}
+                    </div>
+                </div>
+            </div>`;
+    }
+});

iatoolkit-0.64.7/src/iatoolkit/static/js/chat_history_button.js

@@ -0,0 +1,94 @@
+$(document).ready(function () {
+    // Evento para abrir el modal de historial
+    $('#history-button').on('click', function() {
+        loadHistory();
+    });
+
+
+    // Función para cargar el historial
+    async function loadHistory() {
+        const historyLoading = $('#history-loading');
+
+        historyLoading.show();
+
+        // cal the toolkit, handle the response and errors
+        const data = await callToolkit("/api/history", {}, "POST");
+
+        if (data && data.history) {
+            $('#historyModal').modal('show');
+            displayAllHistory(data.history);
+            $('#history-content').show();
+        }
+        historyLoading.hide();
+    }
+
+    // Función para mostrar todo el historial
+    function displayAllHistory(historyData) {
+        const historyTableBody = $('#history-table-body');
+
+        historyTableBody.empty();
+
+        // Filtrar solo consultas que son strings simples
+        const filteredHistory = historyData.filter(item => {
+            try {
+                JSON.parse(item.query);
+                return false;
+            } catch (e) {
+                return true;
+            }
+        });
+
+        // Poblar la tabla
+        filteredHistory.forEach((item, index) => {
+            const icon = $('<i>').addClass('bi bi-pencil-fill');
+
+            const link = $('<a>')
+                .attr('href', 'javascript:void(0);')
+                .addClass('edit-pencil')
+                .attr('title', 'Copiar consulta al chat')
+                .data('query', item.query)
+                .append(icon);
+
+            const row = $('<tr>').append(
+                $('<td>').addClass('text-nowrap').text(formatDate(item.created_at)),
+                $('<td>').text(item.query),
+                $('<td>').append(link),
+            );
+
+            historyTableBody.append(row);
+        });
+    }
+
+    function formatDate(dateString) {
+        const date = new Date(dateString);
+
+        const padTo2Digits = (num) => num.toString().padStart(2, '0');
+
+        const day = padTo2Digits(date.getDate());
+        const month = padTo2Digits(date.getMonth() + 1);
+        const year = date.getFullYear();
+        const hours = padTo2Digits(date.getHours());
+        const minutes = padTo2Digits(date.getMinutes());
+
+        return `${day}-${month} ${hours}:${minutes}`;
+    }
+
+    // event handler for the edit pencil icon
+    $('#history-table-body').on('click', '.edit-pencil', function() {
+        const queryText = $(this).data('query');
+
+        // copy the text to the chat input box
+        if (queryText) {
+            $('#question').val(queryText);
+            autoResizeTextarea($('#question')[0]);
+            $('#send-button').removeClass('disabled');
+
+            // Cerrar el modal
+            $('#historyModal').modal('hide');
+
+            // Hacer focus en el textarea
+            if (window.innerWidth > 768)
+                $('#question').focus();
+        }
+    });
+});

{iatoolkit-0.62.0 → iatoolkit-0.64.7}/src/iatoolkit/static/js/chat_main.js

@@ -11,6 +11,22 @@ $(document).ready(function () {
             callToolkit(url, {'token': window.redeemToken}, "POST").catch(() => {});
         }
 
+    const layoutContainer = document.querySelector('.chat-layout-container');
+    const promptAssistantCollapse = document.getElementById('prompt-assistant-collapse');
+
+    if (layoutContainer && promptAssistantCollapse) {
+        promptAssistantCollapse.addEventListener('show.bs.collapse', function () {
+            layoutContainer.classList.add('prompt-assistant-open');
+            setTimeout(() => {
+                window.scrollTo({ top: document.body.scrollHeight, behavior: 'smooth' });
+            }, 300);
+        });
+
+        promptAssistantCollapse.addEventListener('hide.bs.collapse', function () {
+            layoutContainer.classList.remove('prompt-assistant-open');
+        });
+    }
+
     // --- chat main event hadlers ---
     $('#send-button').on('click', handleChatMessage);
     $('#stop-button').on('click', abortCurrentRequest);
@@ -183,7 +199,6 @@ const toggleSendStopButtons = function (showStop) {
     $('#stop-button-container').toggle(showStop);
 };
 
-
 /**
  * Generic function to make API calls to the backend.
  * @param {string} apiPath - The API endpoint path.
@@ -273,11 +288,13 @@ const displayUserMessage = function(message, isEditable, originalQuestion) {
     userMessage.append(messageText);
 
     if (isEditable) {
-        const editIcon = $('<i>').addClass('p-2 bi bi-pencil-fill edit-icon').attr('title', 'Edit query').on('click', function () {
-            $('#question').val(originalQuestion).focus();
+        const editIcon = $('<i>').addClass('p-2 bi bi-pencil-fill edit-icon edit-pencil').attr('title', 'Edit query').on('click', function () {
+            $('#question').val(originalQuestion)
             autoResizeTextarea($('#question')[0]);
-
             $('#send-button').removeClass('disabled');
+
+            if (window.innerWidth > 768)
+                $('#question').focus();
         });
         userMessage.append(editIcon);
     }
@@ -312,7 +329,7 @@ const showSpinner = function () {
     const accessibilityClass = (typeof bootstrap !== 'undefined') ? 'visually-hidden' : 'sr-only';
     const spinner = $(`
         <div id="spinner" style="display: flex; align-items: center; justify-content: start; margin: 10px 0; padding: 10px;">
-            <div class="spinner-border text-primary" role="status" style="width: 1.5rem; height: 1.5rem; margin-right: 15px;">
+            <div class="spinner-border" role="status" style="width: 1.5rem; height: 1.5rem; margin-right: 15px;">
                 <span class="${accessibilityClass}">Loading...</span>
             </div>
             <span style="font-weight: bold; font-size: 15px;">Cargando...</span>

iatoolkit-0.64.7/src/iatoolkit/static/js/chat_reload_button.js

@@ -0,0 +1,35 @@
+$(document).ready(function () {
+    $('#force-reload-button').on('click', function() {
+        reloadButton(this);
+     });
+
+    async function reloadButton(button) {
+        const originalIconClass = 'bi bi-arrow-clockwise';
+        const spinnerIconClass = 'spinner-border spinner-border-sm';
+
+        // Configuración de Toastr para que aparezca abajo a la derecha
+        toastr.options = {"positionClass": "toast-bottom-right", "preventDuplicates": true};
+
+        // 1. Deshabilitar y mostrar spinner
+        button.disabled = true;
+        const icon = button.querySelector('i');
+        icon.className = spinnerIconClass;
+        toastr.info('Iniciando recarga de contexto en segundo plano...');
+
+        // 2. prepare the api parameters
+        const apiPath = '/api/init-context';
+        const payload = {'user_identifier': window.user_identifier};
+
+        // 3. make the call to callToolkit
+        const data = await callToolkit(apiPath, payload, 'POST');
+        if (data) {
+            if (data.status === 'OK')
+                toastr.success(data.message || 'Contexto recargado.');
+            else
+                toastr.error(data.error_message || 'Ocurrió un error desconocido durante la recarga.');
+        }
+
+        button.disabled = false;
+        icon.className = originalIconClass;
+    }
+});