iatoolkit 0.50.2__tar.gz → 0.55.0__tar.gz

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/PKG-INFO

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

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/pyproject.toml

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

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/common/routes.py

@@ -26,8 +26,8 @@ def register_views(injector, app):
     from iatoolkit.views.tasks_view import TaskView
     from iatoolkit.views.tasks_review_view import TaskReviewView
     from iatoolkit.views.login_test_view import LoginTest
-    from iatoolkit.views.login_view import LoginView, InitiateLoginView
-    from iatoolkit.views.external_login_view import InitiateExternalChatView
+    from iatoolkit.views.login_view import LoginView, FinalizeContextView
+    from iatoolkit.views.external_login_view import ExternalLoginView
     from iatoolkit.views.signup_view import SignupView
     from iatoolkit.views.verify_user_view import VerifyAccountView
     from iatoolkit.views.forgot_password_view import ForgotPasswordView
@@ -46,8 +46,8 @@ def register_views(injector, app):
 
     # this functions are for login external users (with api-key)
     # only the first one should be used from an external app
-    app.add_url_rule('/<company_short_name>/initiate_external_chat',
-                     view_func=InitiateExternalChatView.as_view('initiate_external_chat'))
+    app.add_url_rule('/<company_short_name>/external_login',
+                     view_func=ExternalLoginView.as_view('external_login'))
 
     # this endpoint is for requesting a chat token for external users
     app.add_url_rule('/auth/chat_token',
@@ -55,8 +55,8 @@ def register_views(injector, app):
 
     # login for the iatoolkit integrated frontend
     # this is the main login endpoint for the frontend
-    app.add_url_rule('/<company_short_name>/chat', view_func=InitiateLoginView.as_view('chat'))
     app.add_url_rule('/<company_short_name>/login', view_func=LoginView.as_view('login'))
+    app.add_url_rule('/<company_short_name>/finalize_context_load', view_func=FinalizeContextView.as_view('finalize_context_load'))
 
     # register new user, account verification and forgot password
     app.add_url_rule('/<company_short_name>/signup',view_func=SignupView.as_view('signup'))

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/iatoolkit.py

@@ -19,7 +19,7 @@ from werkzeug.middleware.proxy_fix import ProxyFix
 from injector import Binder, singleton, Injector
 from importlib.metadata import version as _pkg_version, PackageNotFoundError
 
-IATOOLKIT_VERSION = "0.21.0"
+IATOOLKIT_VERSION = "0.55.0"
 
 # global variable for the unique instance of IAToolkit
 _iatoolkit_instance: Optional['IAToolkit'] = None
@@ -360,6 +360,10 @@ class IAToolkit:
         @self.app.context_processor
         def inject_globals():
             from iatoolkit.common.session_manager import SessionManager
+            from iatoolkit.services.profile_service import ProfileService
+
+            profile_service = self._injector.get(ProfileService)
+            user_profile = profile_service.get_current_session_info().get('profile', {})
 
             return {
                 'url_for': url_for,
@@ -367,6 +371,8 @@ class IAToolkit:
                 'app_name': 'IAToolkit',
                 'user_identifier': SessionManager.get('user_identifier'),
                 'company_short_name': SessionManager.get('company_short_name'),
+                'user_is_local': user_profile.get('user_is_local'),
+                'user_email': user_profile.get('user_email'),
                 'iatoolkit_base_url': os.environ.get('IATOOLKIT_BASE_URL', ''),
             }
 

iatoolkit-0.55.0/src/iatoolkit/static/js/chat_onboarding.js

@@ -0,0 +1,98 @@
+// static/js/chat_onboarding.js
+(function (global) {
+  function qs(root, sel) { return (typeof sel === 'string') ? root.querySelector(sel) : sel; }
+
+  function createDots(container, count, activeIdx, activeColor) {
+    container.innerHTML = '';
+    for (let i = 0; i < count; i++) {
+      const d = document.createElement('div');
+      if (i === activeIdx) d.classList.add('active');
+      d.style.width = '10px';
+      d.style.height = '10px';
+      d.style.borderRadius = '50%';
+      d.style.backgroundColor = i === activeIdx ? (activeColor || 'var(--brand-primary-color, #FF5100)') : '#ddd';
+      d.style.transition = 'background-color .3s';
+      container.appendChild(d);
+    }
+  }
+
+  function initOnboarding(opts) {
+    const {
+      mode = 'modal',
+      cards = [],
+      ui = {},
+      autoRotateMs = 5000,
+      shell = {}
+    } = opts;
+
+    const root = document;
+    const elIcon = qs(root, ui.icon);
+    const elTitle = qs(root, ui.title);
+    const elText = qs(root, ui.text);
+    const elDots = qs(root, ui.dots);
+    const elPrev = qs(root, ui.prev);
+    const elNext = qs(root, ui.next);
+
+    let idx = 0;
+    let autoTimer = null;
+
+    function hasCards() { return Array.isArray(cards) && cards.length > 0; }
+
+    function render() {
+      if (!hasCards()) return;
+      const c = cards[idx] || {};
+      if (elIcon) elIcon.innerHTML = `<i class="${c.icon || 'bi bi-lightbulb'}"></i>`;
+      if (elTitle) elTitle.textContent = c.title || '';
+      if (elText) elText.innerHTML = c.text || '';
+      if (elDots) createDots(elDots, cards.length, idx);
+    }
+
+    function next() { if (!hasCards()) return; idx = (idx + 1) % cards.length; render(); }
+    function prev() { if (!hasCards()) return; idx = (idx - 1 + cards.length) % cards.length; render(); }
+
+    function startAuto() {
+      stopAuto();
+      if (!hasCards()) return;
+      autoTimer = setInterval(next, autoRotateMs);
+    }
+    function stopAuto() { if (autoTimer) { clearInterval(autoTimer); autoTimer = null; } }
+
+    function setupShellIfNeeded() {
+      if (mode !== 'shell') return;
+      const loader = ui.loader ? qs(root, ui.loader) : null;
+      const container = ui.container ? qs(root, ui.container) : null;
+      if (!container || !shell.iframeSrc) return;
+
+      const iframe = document.createElement('iframe');
+      iframe.src = shell.iframeSrc;
+      iframe.style.width = '100%';
+      iframe.style.height = '100%';
+      iframe.style.border = 'none';
+      iframe.style.display = 'none';
+
+      iframe.onload = function () {
+        iframe.style.display = 'block';
+        if (loader) {
+          loader.style.opacity = '0';
+          setTimeout(() => loader.style.display = 'none', 500);
+        }
+      };
+      container.appendChild(iframe);
+    }
+
+    if (elPrev) elPrev.addEventListener('click', () => { prev(); startAuto(); });
+    if (elNext) elNext.addEventListener('click', () => { next(); startAuto(); });
+
+    function start() {
+      idx = 0;
+      render();
+      startAuto();
+      if (mode === 'shell') setupShellIfNeeded();
+    }
+
+    return { start, stop: stopAuto, next, prev, hasCards };
+  }
+
+  // Export global
+  global.initOnboarding = initOnboarding;
+})(window);

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/static/styles/chat_iatoolkit.css

@@ -455,4 +455,3 @@
 #send-button i {
     color: var(--brand-send-button-color);
 }
-

iatoolkit-0.55.0/src/iatoolkit/static/styles/onboarding.css

@@ -0,0 +1,169 @@
+/* static/css/onboarding.css */
+
+/* Fuente base para ambos contextos */
+.ob-root {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+}
+
+/* Tarjeta */
+.ob-card {
+  background-color: #fff;
+  border-radius: 12px;
+  box-shadow: 0 4px 20px rgba(0,0,0,0.1);
+  padding: 30px;
+  width: 90%;
+  max-width: 450px;
+  text-align: center;
+  transition: opacity 0.3s ease-in-out;
+  margin: 0 auto;
+}
+
+/* Contenido de tarjeta */
+.ob-icon {
+  font-size: 40px;
+  color: var(--brand-primary-color, #FF5100);
+  margin-bottom: 15px;
+}
+.ob-title {
+  font-size: 1.25rem;
+  color: #333;
+  margin-bottom: 10px;
+}
+.ob-text {
+  font-size: 0.95rem;
+  color: #666;
+  line-height: 1.5;
+  min-height: 60px;
+}
+
+/* Navegación */
+.ob-nav {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-top: 20px;
+}
+.ob-btn {
+  background-color: var(--brand-secondary-color, #06326B);
+  border: none;
+  color: var(--brand-text-on-secondary, #FFFFFF);
+  border-radius: 50%;
+  width: 40px;
+  height: 40px;
+  cursor: pointer;
+  transition: opacity 0.2s;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+.ob-btn:hover { opacity: 0.85; }
+
+/* Dots */
+.ob-dots {
+  display: flex;
+  gap: 8px;
+}
+.ob-dots > div {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  background-color: #ddd;
+  transition: background-color 0.3s;
+}
+.ob-dots > div.active {
+  background-color: var(--brand-primary-color, #FF5100);
+}
+
+/* Encabezado reutilizable (si se usa) */
+.ob-brand-header {
+  font-size: 2rem;
+  font-weight: 700;
+  margin-bottom: 24px;
+  color: var(--brand-secondary-color, #06326B);
+  text-align: center;
+}
+.ob-brand-header .brand-name {
+  color: var(--brand-primary-color, #FF5100);
+}
+
+/* Utilidades */
+.ob-fade {
+  transition: opacity 0.5s ease-in-out;
+}
+
+/* Responsivo */
+@media (max-width: 420px) {
+  .ob-card { padding: 24px; }
+  .ob-icon { font-size: 34px; }
+}
+
+/* Overlay a pantalla completa */
+.onboarding-shell-root {
+  position: relative;
+  height: calc(100vh - 0px);
+}
+
+/* Centrado vertical y horizontal del contenido del loader */
+#loader-wrapper {
+  position: absolute; inset: 0;
+  background-color: #f4f7f6;
+  z-index: 1000;
+  display: flex; align-items: center; justify-content: center;
+  padding: 20px; box-sizing: border-box;
+  transition: opacity 0.5s ease-in-out;
+}
+
+/* Pila vertical: header + tarjeta + banda de carga */
+.ob-stack {
+  width: 100%;
+  max-width: 520px; /* ligeramente más que la tarjeta para respiración */
+  display: flex;
+  flex-direction: column;
+  align-items: stretch; /* la tarjeta ocupa el ancho */
+  gap: 16px;
+}
+
+/* Header de marca consistente */
+.ob-brand-header {
+  font-size: 2rem;
+  font-weight: 700;
+  margin: 0;
+  color: var(--brand-secondary-color, #06326B);
+  text-align: center;
+}
+.ob-brand-header .brand-name {
+  color: var(--brand-primary-color, #FF5100);
+}
+
+/* Banda de estado integrada visualmente con la tarjeta */
+.ob-loading-band {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 12px;
+  padding: 12px 14px;
+  background: #ffffff;
+  border-radius: 12px;
+  box-shadow: 0 4px 20px rgba(0,0,0,0.08);
+}
+
+/* Spinner */
+.spinner {
+  width: 28px; height: 28px;
+  border: 4px solid rgba(0,0,0,0.1);
+  border-top-color: var(--brand-primary-color, #FF5100);
+  border-radius: 50%;
+  animation: spin 1s linear infinite;
+}
+@keyframes spin { to { transform: rotate(360deg); } }
+
+#loading-status p {
+  font-size: 0.95rem;
+  font-weight: 500;
+  color: #555;
+  margin: 0;
+}
+
+/* Iframe contenedor */
+#content-container { width: 100%; height: 100%; }
+#content-container iframe { width: 100%; height: 100%; border: none; }

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/templates/_login_widget.html

@@ -10,7 +10,7 @@
 
     <!-- 2. Formulario de Inicio de Sesión -->
     <form id="login-form"
-          action="{{ url_for('chat', company_short_name=company_short_name) }}"
+          action="{{ url_for('login', company_short_name=company_short_name) }}"
           method="post">
       <div class="mb-3">
         <label for="email" class="form-label d-block">Correo Electrónico</label>

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/templates/base.html

@@ -10,6 +10,7 @@
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/filepond/dist/filepond.min.css">
     <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/sweetalert2@11/dist/sweetalert2.min.css">
     <link rel="stylesheet" href="{{ url_for('static', filename='styles/chat_iatoolkit.css', _external=True) }}">
+    <link rel="stylesheet" href="{{ url_for('static', filename='styles/onboarding.css', _external=True) }}">
     <link rel="stylesheet" href="{{ url_for('static', filename='styles/chat_modal.css',  _external=True) }}">
     <link rel="stylesheet" href="{{ url_for('static', filename='styles/llm_output.css', _external=True) }}">
 </head>

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/templates/chat.html

@@ -7,6 +7,9 @@
 <style>
     {{ branding.css_variables | safe }}
 </style>
+<link rel="stylesheet" href="{{ url_for('static', filename='css/onboarding.css', _external=True) }}">
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/all.min.css">
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css">
 
 <!-- Sección de encabezado con el usuario conectado -->
 <div id="company-section" class="company-section d-flex justify-content-between align-items-center px-3 py-2"
@@ -49,6 +52,11 @@
            class="ms-3 action-icon-style" title="Tu feedback es muy importante" style="color: {{ branding.header_text_color }};">
             <i class="bi bi-emoji-smile"></i>
         </a>
+        <a href="javascript:void(0);" id="onboarding-button"
+           class="ms-3 action-icon-style" title="Ver onboarding"
+           style="color: {{ branding.header_text_color }};">
+            <i class="bi bi-lightbulb"></i>
+        </a>
 
         <!-- Icono de cerrar sesión (al final) -->
         {% if user_is_local %}
@@ -174,20 +182,16 @@
     window.iatoolkit_base_url = "{{ iatoolkit_base_url }}";
     window.availablePrompts = {{ prompts.message | tojson }};
     window.sendButtonColor = "{{ branding.send_button_color }}";
-
-    {% if auth_method == 'jwt' and session_jwt %}
-        // Store session JWT if it exists, defined in the same global scope
-        window.sessionJWT = "{{ session_jwt }}";
-    {% endif %}
+    window.onboardingCards = {{ onboarding_cards | tojson }};
 </script>
 
 <!-- Carga de los scripts JS externos después de definir las variables globales -->
+<script src="{{ url_for('static', filename='js/chat_onboarding.js', _external=True) }}"></script>
 <script src="{{ url_for('static', filename='js/chat_filepond.js', _external=True) }}"></script>
 <script src="{{ url_for('static', filename='js/chat_history.js', _external=True) }}"></script>
 <script src="{{ url_for('static', filename='js/chat_feedback.js', _external=True) }}"></script>
 <script src="{{ url_for('static', filename='js/chat_main.js', _external=True) }}"></script>
 
-
 <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/toastr.js/latest/toastr.min.css">
 <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
 <script src="https://cdnjs.cloudflare.com/ajax/libs/toastr.js/latest/toastr.min.js"></script>
@@ -274,5 +278,44 @@ document.addEventListener('DOMContentLoaded', function() {
         });
     });
 });
+
+// Inicialización del modal de onboarding
+document.addEventListener('DOMContentLoaded', function () {
+  const btn = document.getElementById('onboarding-button');
+  if (!btn) return;
+
+  const modalEl = document.getElementById('onboardingModal');
+  const modal = new bootstrap.Modal(modalEl);
+
+  if (!window.initOnboarding) {
+    console.error('initOnboarding no disponible. Verifica chat_onboarding.js');
+    return;
+  }
+
+  const onboarding = initOnboarding({
+    mode: 'modal',
+    cards: Array.isArray(window.onboardingCards) ? window.onboardingCards : [],
+    ui: {
+      icon: '#ob-icon',
+      title: '#ob-title',
+      text: '#ob-text',
+      dots: '#ob-dots',
+      prev: '#ob-prev',
+      next: '#ob-next'
+    },
+    autoRotateMs: 5000
+  });
+
+  modalEl.addEventListener('hidden.bs.modal', () => onboarding.stop());
+
+  btn.addEventListener('click', () => {
+    if (!onboarding.hasCards()) {
+      toastr.info('No hay información de onboarding disponible.');
+      return;
+    }
+    onboarding.start();
+    modal.show();
+  });
+});
 </script>
 {% endblock %}

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/templates/chat_modals.html

@@ -109,4 +109,37 @@
             </div>
         </div>
     </div>
+</div>
+
+<!-- Modal de Onboarding -->
+<div class="modal fade" id="onboardingModal" tabindex="-1" aria-labelledby="onboardingModalLabel" aria-hidden="true">
+  <div class="modal-dialog modal-dialog-centered">
+    <div class="modal-content" style="border-radius:12px;">
+      <div class="modal-header">
+        <h5 class="modal-title w-100 text-center" id="onboardingModalLabel" style="color: var(--brand-primary-color, #FF5100);">
+            Bienvenido a {{ branding.name }}
+        </h5>
+          <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Cerrar"></button>
+      </div>
+
+      <div class="modal-body ob-root">
+        <div id="ob-card" class="ob-card">
+          <div id="ob-icon" class="ob-icon"><i class="bi bi-lightbulb"></i></div>
+          <h6 id="ob-title" class="ob-title"></h6>
+          <div id="ob-text" class="ob-text"></div>
+          <div class="ob-nav">
+            <button id="ob-prev" class="ob-btn" aria-label="Anterior"><i class="bi bi-chevron-left"></i></button>
+            <div id="ob-dots" class="ob-dots"></div>
+            <button id="ob-next" class="ob-btn" aria-label="Siguiente"><i class="bi bi-chevron-right"></i></button>
+          </div>
+        </div>
+      </div>
+
+      <div class="modal-footer">
+        <button id="ob-close" type="button" class="btn btn-branded-secondary" data-bs-dismiss="modal">
+            Cerrar
+        </button>
+        </div>
+    </div>
+  </div>
 </div>

{iatoolkit-0.50.2 → iatoolkit-0.55.0}/src/iatoolkit/templates/login_test.html

@@ -72,7 +72,7 @@
 
           // Actualizar action del formulario "Iniciar Sesión"
           if (selectedCompany && selectedCompany.trim() !== '') {
-              const loginAction = '/' + selectedCompany + '/chat';
+              const loginAction = '/' + selectedCompany + '/external_login';
               $('#login-form').attr('action', loginAction); // Actualizamos la URL del form
           } else {
               $('#login-form').attr('action', '#'); // URL genérica si no hay selección
@@ -116,7 +116,7 @@
               return;
           }
 
-          fetch(`/${selectedCompany}/initiate_external_chat`, {
+          fetch(`/${selectedCompany}/external_login`, {
               method: 'POST',
               headers: {
                   'Content-Type': 'application/json',

iatoolkit-0.55.0/src/iatoolkit/templates/onboarding_shell.html

@@ -0,0 +1,101 @@
+{% extends "base.html" %}
+
+{% block title %}Iniciando {{ branding.name | default('IAToolkit') }} IA...{% endblock %}
+
+{% block styles %}
+<link rel="stylesheet" href="{{ url_for('static', filename='styles/llm_output.css', _external=True) }}?v=6">
+<link rel="stylesheet" href="{{ url_for('static', filename='css/onboarding.css', _external=True) }}?v=6">
+<style>
+  .onboarding-shell-root { position: relative; height: 100vh; }
+  .onboarding-shell-root #loader-wrapper { position: absolute; inset: 0; background: #f4f7f6; z-index: 1000; display:flex; align-items:center; justify-content:center; padding:20px; box-sizing:border-box; transition: opacity .5s; }
+  .onboarding-shell-root .ob-stack { width:100%; max-width:520px; display:flex; flex-direction:column; gap:16px; }
+  .onboarding-shell-root .ob-loading-band { display:flex; align-items:center; justify-content:center; gap:12px; padding:12px 14px; background:#fff; border-radius:12px; box-shadow:0 4px 20px rgba(0,0,0,.08); }
+  .onboarding-shell-root .spinner { width:28px; height:28px; border:4px solid rgba(0,0,0,.1); border-top-color: var(--brand-primary-color, #FF5100); border-radius:50%; animation: spin 1s linear infinite; }
+  @keyframes spin { to { transform: rotate(360deg); } }
+  .onboarding-shell-root #content-container { width:100%; height:100%; }
+  .onboarding-shell-root #content-container iframe { width:100%; height:100%; border:none; }
+
+  /* Forzar colores de marca (sube especificidad y evita overrides) */
+  .onboarding-shell-root .ob-brand-header { color: var(--brand-secondary-color, #06326B) !important; }
+  .onboarding-shell-root .ob-brand-header .brand-name { color: var(--brand-primary-color, #FF5100) !important; }
+  .onboarding-shell-root .ob-icon { color: var(--brand-primary-color, #FF5100) !important; }
+  .onboarding-shell-root .ob-btn { background-color: var(--brand-secondary-color, #06326B) !important; color: var(--brand-text-on-secondary, #FFFFFF) !important; border:none !important; }
+  .onboarding-shell-root .ob-dots > div.active { background-color: var(--brand-primary-color, #FF5100) !important; }
+</style>
+{% if branding and branding.css_variables %}
+<style>
+  {{ branding.css_variables|safe }}
+</style>
+{% endif %}
+{% endblock %}
+
+{% block content %}
+<div class="onboarding-shell-root ob-root">
+  <div id="loader-wrapper">
+    <div class="ob-stack">
+      <h1 id="ob-brand-header" class="ob-brand-header">
+        <span class="brand-name text-brand-primary">{{ branding.name | default('IAToolkit') }}</span>
+        <span class="brand-rest"> IA</span>
+      </h1>
+
+      <div id="card-container" class="ob-card">
+        <div id="card-icon" class="ob-icon"><i class="fas fa-lightbulb"></i></div>
+        <h3 id="card-title" class="ob-title">Título de la Tarjeta</h3>
+        <p id="card-text" class="ob-text">Descripción de la tarjeta de capacitación.</p>
+        <div class="ob-nav">
+          <button id="prev-card" class="ob-btn btn-branded-primary" aria-label="Anterior">
+            <i class="fas fa-chevron-left"></i>
+          </button>
+          <div id="progress-dots" class="ob-dots"></div>
+          <button id="next-card" class="ob-btn btn-branded-primary" aria-label="Siguiente">
+            <i class="fas fa-chevron-right"></i>
+          </button>
+        </div>
+      </div>
+
+      <div id="loading-status" class="ob-loading-band">
+        <div class="spinner"></div>
+        <p>Inicializando el contexto de {{ branding.name }} para la IA...</p>
+      </div>
+    </div>
+  </div>
+
+  <div id="content-container"></div>
+</div>
+{% endblock %}
+
+{% block scripts %}
+<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/all.min.css">
+
+<script src="{{ url_for('static', filename='js/chat_onboarding.js', _external=True) }}"></script>
+<script>
+  (function() {
+    const cardsData = {{ onboarding_cards | tojson }};
+    const iframeSrc = "{{ iframe_src_url }}";
+
+    if (!window.initOnboarding) {
+      console.error('initOnboarding no está disponible. Verifica la carga de chat_onboarding.js');
+      return;
+    }
+
+    const onboarding = initOnboarding({
+      mode: 'shell',
+      cards: cardsData,
+      ui: {
+        icon: '#card-icon',
+        title: '#card-title',
+        text: '#card-text',
+        dots: '#progress-dots',
+        prev: '#prev-card',
+        next: '#next-card',
+        loader: '#loader-wrapper',
+        container: '#content-container'
+      },
+      autoRotateMs: 5000,
+      shell: { iframeSrc: iframeSrc }
+    });
+
+    onboarding.start();
+  })();
+</script>
+{% endblock %}