PyPI - zerochat - Versions diffs - 7.3.0__py3-none-any.whl - Mend

zerochat 7.3.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (130) hide show

zerochat-7.3.0.dist-info/METADATA +70 -0
zerochat-7.3.0.dist-info/RECORD +130 -0
zerochat-7.3.0.dist-info/WHEEL +5 -0
zerochat-7.3.0.dist-info/entry_points.txt +2 -0
zerochat-7.3.0.dist-info/licenses/LICENSE +34 -0
zerochat-7.3.0.dist-info/top_level.txt +2 -0
zerochat.py +2004 -0
zerochat_runtime/__init__.py +1 -0
zerochat_runtime/assets/css/base.css +199 -0
zerochat_runtime/assets/css/components/composer.css +1258 -0
zerochat_runtime/assets/css/components/debug.css +777 -0
zerochat_runtime/assets/css/components/header.css +97 -0
zerochat_runtime/assets/css/components/icons.css +39 -0
zerochat_runtime/assets/css/components/markdown.css +685 -0
zerochat_runtime/assets/css/components/messages.css +473 -0
zerochat_runtime/assets/css/components/modals.css +1319 -0
zerochat_runtime/assets/css/components/sidebar.css +622 -0
zerochat_runtime/assets/css/components/tools.css +1223 -0
zerochat_runtime/assets/css/layout.css +171 -0
zerochat_runtime/assets/css/print.css +120 -0
zerochat_runtime/assets/css/styles.css +18 -0
zerochat_runtime/assets/css/theme-overrides.css +555 -0
zerochat_runtime/assets/css/tokens.css +165 -0
zerochat_runtime/assets/help/architecture.html +247 -0
zerochat_runtime/assets/help/composer.html +134 -0
zerochat_runtime/assets/help/conversations.html +105 -0
zerochat_runtime/assets/help/debug.html +108 -0
zerochat_runtime/assets/help/en/architecture.html +247 -0
zerochat_runtime/assets/help/en/composer.html +134 -0
zerochat_runtime/assets/help/en/conversations.html +104 -0
zerochat_runtime/assets/help/en/debug.html +105 -0
zerochat_runtime/assets/help/en/gemini-free.html +39 -0
zerochat_runtime/assets/help/en/index.html +191 -0
zerochat_runtime/assets/help/en/learning.html +71 -0
zerochat_runtime/assets/help/en/mcp.html +143 -0
zerochat_runtime/assets/help/en/openrouter-free.html +39 -0
zerochat_runtime/assets/help/en/profiles.html +173 -0
zerochat_runtime/assets/help/en/rag.html +130 -0
zerochat_runtime/assets/help/en/reasoning-telemetry.html +108 -0
zerochat_runtime/assets/help/en/tools-agent.html +133 -0
zerochat_runtime/assets/help/en/webllm.html +355 -0
zerochat_runtime/assets/help/gemini-free.html +39 -0
zerochat_runtime/assets/help/help.css +604 -0
zerochat_runtime/assets/help/help.js +51 -0
zerochat_runtime/assets/help/index.html +194 -0
zerochat_runtime/assets/help/learning.html +71 -0
zerochat_runtime/assets/help/mcp.html +143 -0
zerochat_runtime/assets/help/openrouter-free.html +39 -0
zerochat_runtime/assets/help/profiles.html +174 -0
zerochat_runtime/assets/help/rag.html +130 -0
zerochat_runtime/assets/help/reasoning-telemetry.html +111 -0
zerochat_runtime/assets/help/tools-agent.html +133 -0
zerochat_runtime/assets/help/webllm.html +359 -0
zerochat_runtime/assets/js/agent-core.js +1553 -0
zerochat_runtime/assets/js/api.js +844 -0
zerochat_runtime/assets/js/app.js +2558 -0
zerochat_runtime/assets/js/attachments.js +220 -0
zerochat_runtime/assets/js/charts.js +338 -0
zerochat_runtime/assets/js/chat-engine.js +566 -0
zerochat_runtime/assets/js/config-store.js +207 -0
zerochat_runtime/assets/js/context-manager.js +584 -0
zerochat_runtime/assets/js/conversation-service.js +484 -0
zerochat_runtime/assets/js/cookies.js +688 -0
zerochat_runtime/assets/js/data-reset-service.js +136 -0
zerochat_runtime/assets/js/debug.js +508 -0
zerochat_runtime/assets/js/defaults.js +16 -0
zerochat_runtime/assets/js/export.js +179 -0
zerochat_runtime/assets/js/file-parser.js +2088 -0
zerochat_runtime/assets/js/generation-controller.js +417 -0
zerochat_runtime/assets/js/i18n.js +1483 -0
zerochat_runtime/assets/js/icons.js +156 -0
zerochat_runtime/assets/js/ingestionEngine.js +436 -0
zerochat_runtime/assets/js/markdown.js +588 -0
zerochat_runtime/assets/js/mcp.js +1271 -0
zerochat_runtime/assets/js/message-turns.js +62 -0
zerochat_runtime/assets/js/profile-backup.js +118 -0
zerochat_runtime/assets/js/profile-export-bundle.js +481 -0
zerochat_runtime/assets/js/profile-repository.js +213 -0
zerochat_runtime/assets/js/providers-webllm.js +486 -0
zerochat_runtime/assets/js/providers.js +1560 -0
zerochat_runtime/assets/js/rag-index.js +295 -0
zerochat_runtime/assets/js/rag-service.js +530 -0
zerochat_runtime/assets/js/rag-ui.js +997 -0
zerochat_runtime/assets/js/ragStorage.js +676 -0
zerochat_runtime/assets/js/sandbox.js +449 -0
zerochat_runtime/assets/js/state.js +704 -0
zerochat_runtime/assets/js/storage-db.js +144 -0
zerochat_runtime/assets/js/tool-cards.js +330 -0
zerochat_runtime/assets/js/tool-security.js +653 -0
zerochat_runtime/assets/js/tools/README.md +50 -0
zerochat_runtime/assets/js/tools/builtin/agent-checkpoint.tool.js +212 -0
zerochat_runtime/assets/js/tools/builtin/download-pdf.tool.js +111 -0
zerochat_runtime/assets/js/tools/builtin/execute-javascript.tool.js +219 -0
zerochat_runtime/assets/js/tools/builtin/fetch-web-page.tool.js +112 -0
zerochat_runtime/assets/js/tools/builtin/list-documents.tool.js +117 -0
zerochat_runtime/assets/js/tools/builtin/read-knowledge-chunk.tool.js +129 -0
zerochat_runtime/assets/js/tools/builtin/read-knowledge-image.tool.js +95 -0
zerochat_runtime/assets/js/tools/builtin/render-chart.tool.js +90 -0
zerochat_runtime/assets/js/tools/builtin/search-knowledge-base.tool.js +124 -0
zerochat_runtime/assets/js/tools/builtin/search-web.tool.js +125 -0
zerochat_runtime/assets/js/tools/tool-manifest.js +53 -0
zerochat_runtime/assets/js/tools/tool-runtime.js +77 -0
zerochat_runtime/assets/js/ui-composer.js +319 -0
zerochat_runtime/assets/js/ui-conversation.js +655 -0
zerochat_runtime/assets/js/ui-dialogs.js +132 -0
zerochat_runtime/assets/js/ui-generation-status.js +119 -0
zerochat_runtime/assets/js/ui-inspector.js +804 -0
zerochat_runtime/assets/js/ui-mcp.js +604 -0
zerochat_runtime/assets/js/ui-profiles.js +824 -0
zerochat_runtime/assets/js/ui-reasoning.js +146 -0
zerochat_runtime/assets/js/ui-settings.js +825 -0
zerochat_runtime/assets/js/ui-shell.js +215 -0
zerochat_runtime/assets/js/ui-sidebar.js +429 -0
zerochat_runtime/assets/js/ui-telemetry.js +404 -0
zerochat_runtime/assets/js/ui-transfer.js +262 -0
zerochat_runtime/assets/js/utils.js +216 -0
zerochat_runtime/assets/js/vendor/orama.browser.js +11 -0
zerochat_runtime/assets/js/web-browser.js +569 -0
zerochat_runtime/assets/js/web-search.js +519 -0
zerochat_runtime/assets/manifest.webmanifest +20 -0
zerochat_runtime/assets/services/dummy_mcp/dummy_mcp_server.py +47 -0
zerochat_runtime/assets/services/dummy_mcp/service.json +22 -0
zerochat_runtime/assets/services/lsp/installer.json +9 -0
zerochat_runtime/assets/services/lsp/service.json +22 -0
zerochat_runtime/assets/services/memory/installer.json +9 -0
zerochat_runtime/assets/services/memory/service.json +24 -0
zerochat_runtime/assets/services/playwright/installer.json +10 -0
zerochat_runtime/assets/services/playwright/service.json +39 -0
zerochat_runtime/assets/sw.js +164 -0
zerochat_runtime/assets/zerochat.html +671 -0

zerochat_runtime/assets/help/architecture.html ADDED Viewed

@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Arquitectura y Portabilidad · Ayuda de ZeroChat</title>
+  <meta name="description" content="Detalles de la arquitectura técnica de ZeroChat: aplicación web estática servida por HTTPS, backend local unificado en zerochat.py, almacenamiento local en IndexedDB y privacidad.">
+  <link rel="stylesheet" href="help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="en/architecture.html" class="top-nav-link">English 🌐</a>
+          <a href="index.html" class="top-nav-link">← Volver al Índice</a>
+        </div>
+      </div>
+      <h1>Arquitectura y Portabilidad</h1>
+      <p class="subtitle">Descubre cómo funciona ZeroChat como aplicación web autónoma, independiente de servidor y 100% portable.</p>
+    </header>
+    <div class="card">
+      <h2>1. Arquitectura Web Estática y Backend Unificado</h2>
+      <p>
+        ZeroChat está diseñado bajo una premisa fundamental: <strong>máxima simplicidad, velocidad y control sin dependencias pesadas</strong>.
+      </p>
+      <p>
+        La aplicación web se sirve de forma directa y estática por HTTPS desde GitHub Pages como <code>zerochat.html</code>, cargando sus módulos <code>css/</code> y <code>js/</code> sin proceso de empaquetado. El Service Worker permite reutilizar recursos disponibles sin sustituir la conexión cuando sea necesaria.
+      </p>
+      <p>
+        Toda la interacción con el sistema local (ejecución de comandos, lectura y edición de archivos) se canaliza a través de un único ejecutable en Python: <code>zerochat.py</code>, que gestiona su propio entorno virtual en <code>./zerochat</code> y autentica las sesiones mediante tokens diarios de seguridad.
+      </p>
+      <div class="alert alert-success">
+        <strong>Ventaja clave:</strong> Sin compiladores ni herramientas complejas de empaquetado. La aplicación web se sirve estáticamente y el backend local se ejecuta en cualquier equipo con un simple comando de terminal.
+      </div>
+    </div>
+    <div class="card" id="modos-arranque">
+      <h2>2. Modos de arranque: zerochat.html (Web) vs. zerochat.py (Backend local)</h2>
+      <p>
+        ZeroChat está concebido para ofrecer dos experiencias complementarias según el contexto de uso: una <strong>aplicación web universal y autónoma</strong> (ideal para movilidad y uso diario sin instalación) y una <strong>estación de trabajo local</strong> (para desarrollo y control directo del sistema operativo).
+      </p>
+      <h3>A. La versión Web pura (<code>zerochat.html</code>)</h3>
+      <p>
+        Disponible directamente en la web (GitHub Pages) o abriendo el archivo localmente. Es una aplicación completa y autosuficiente que <strong>no requiere Python, terminal, servidores auxiliares ni instalación</strong>.
+      </p>
+      <ul>
+        <li>
+          <strong>Experiencia web universal:</strong>
+          Diseñada como Progressive Web App (PWA) instalable desde navegadores modernos, con panel lateral táctil y composer autoexpansible. No requiere Python, root ni herramientas de terminal.
+        </li>
+        <li>
+          <strong>Conectividad multimodelo completa:</strong>
+          Conexión directa desde el navegador con OpenAI, Anthropic Claude, Google Gemini y OpenRouter, así como servidores locales en red con CORS (Ollama, LM Studio).
+        </li>
+        <li>
+          <strong>Inferencia local privada en navegador (WebLLM / WebGPU):</strong>
+          Descarga y ejecuta modelos de lenguaje open-source en la GPU del propio dispositivo sin enviar datos al exterior.
+        </li>
+        <li>
+          <strong>Motor RAG documental integrado:</strong>
+          Indexación y búsqueda vectorial/léxica de PDFs y documentos con Orama, ejecutada en Web Workers y persistida en IndexedDB.
+        </li>
+        <li>
+          <strong>Modo Agente con herramientas de navegador:</strong>
+          Ejecución de código JavaScript en sandbox seguro de navegador, generación de gráficas interactivas SVG, búsqueda en la web y lectura de páginas públicas.
+        </li>
+        <li>
+          <strong>Soberanía absoluta de datos:</strong>
+          Historiales, ramas, adjuntos y configuraciones residen exclusivamente en el IndexedDB local de tu navegador.
+        </li>
+      </ul>
+      <h3>B. Qué añade el Backend local (<code>zerochat.py</code>)</h3>
+      <p>
+        Diseñado para puestos de escritorio (Linux, macOS, Windows) donde el agente de IA necesita actuar como asistente de desarrollo sobre el sistema operativo. También se ha probado en Android mediante Termux:
+      </p>
+      <ul>
+        <li>
+          <strong>Acceso al sistema de archivos local:</strong>
+          Exploración de directorios, lectura de código fuente e inserción o edición atómica de archivos en el disco duro (<code>read_file</code>, <code>edit_file</code>, <code>list_directory</code>).
+        </li>
+        <li>
+          <strong>Ejecución de comandos del sistema:</strong>
+          Lanzamiento de compilaciones, pruebas y comandos shell en la terminal local del equipo (<code>execute_command</code>).
+        </li>
+        <li>
+          <strong>Servidores MCP externos:</strong>
+          Integración con el ecosistema Model Context Protocol (automatización de navegador con Playwright, servidores LSP de análisis estático, persistencia relacional SQLite).
+        </li>
+        <li>
+          <strong>Gestión automatizada de entorno:</strong>
+          Auto-gestión de venv en <code>./zerochat</code>, autenticación por token efímero diario y logging en tiempo real con marcas de tiempo y diagnóstico de errores.
+        </li>
+      </ul>
+      <h3>Tabla comparativa de capacidades</h3>
+      <div class="table-responsive">
+        <table>
+          <thead>
+            <tr>
+              <th>Capacidad / Característica</th>
+              <th style="text-align: center;"><code>zerochat.html</code> (Web / PWA)</th>
+              <th style="text-align: center;"><code>zerochat.py</code> (Backend local)</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td>Conexión con proveedores de IA comerciales (OpenAI, Claude, Gemini, etc.)</td>
+              <td style="text-align: center;">✅ Sí</td>
+              <td style="text-align: center;">✅ Sí</td>
+            </tr>
+            <tr>
+              <td>Inferencia 100% local en navegador con WebLLM y WebGPU</td>
+              <td style="text-align: center;">✅ Sí</td>
+              <td style="text-align: center;">✅ Sí</td>
+            </tr>
+            <tr>
+              <td>Base de conocimiento RAG documental (Orama en navegador)</td>
+              <td style="text-align: center;">✅ Sí</td>
+              <td style="text-align: center;">✅ Sí</td>
+            </tr>
+            <tr>
+              <td>Modo Agente con sandbox JS, búsqueda web y gráficas SVG</td>
+              <td style="text-align: center;">✅ Sí</td>
+              <td style="text-align: center;">✅ Sí</td>
+            </tr>
+            <tr>
+              <td>Persistencia privada en IndexedDB y exportación/importación</td>
+              <td style="text-align: center;">✅ Sí</td>
+              <td style="text-align: center;">✅ Sí</td>
+            </tr>
+            <tr>
+              <td>Uso directo en móviles (Android / iOS) sin terminal ni Python</td>
+              <td style="text-align: center;">✅ Nativo (PWA)</td>
+              <td style="text-align: center;">⚠️ Requiere Python (Termux o escritorio)</td>
+            </tr>
+            <tr>
+              <td>Lectura, edición y navegación de archivos en el disco local</td>
+              <td style="text-align: center;">❌ No disponible</td>
+              <td style="text-align: center;">✅ Sí (herramientas locales)</td>
+            </tr>
+            <tr>
+              <td>Ejecución de comandos de terminal y shell en el host</td>
+              <td style="text-align: center;">❌ No disponible</td>
+              <td style="text-align: center;">✅ Sí (bash/shell)</td>
+            </tr>
+            <tr>
+              <td>Servidores MCP externos (Playwright, memoria, LSP)</td>
+              <td style="text-align: center;">❌ No disponible</td>
+              <td style="text-align: center;">✅ Sí (gestor MCP integrado)</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+    <div class="card">
+      <h2>3. Entrega Web Estática y Conexión con el Backend Local</h2>
+      <p>ZeroChat se sirve de manera estática y universal a través de la web:</p>
+      <ul>
+        <li>
+          <strong>Servicio Web Universal (HTTPS):</strong> Servido directamente desde GitHub Pages (<code>https://albalday.github.io/zerochat/zerochat.html</code>). Toda la ejecución de interfaz, renderizado y llamadas a APIs de inferencia ocurre en el navegador con acceso a APIs modernas de persistencia como <code>navigator.storage.persist()</code> y almacenamiento seguro en IndexedDB.
+        </li>
+        <li>
+          <strong>Backend Local Unificado (<code>zerochat.py</code>):</strong> Al ejecutar <code>python3 zerochat.py</code>, el servidor local arranca en <code>127.0.0.1:6388</code>, abre automáticamente el navegador apuntando a la aplicación web y transfiere el token de sesión diario de forma segura en el fragmento de la URL. En Termux, detecta el entorno y usa <code>termux-open-url</code> para abrir el navegador Android; en los demás escritorios Linux usa el gestor de aplicaciones predeterminado. El comando de arranque es el mismo en ambos casos. La aplicación consume ese fragmento una sola vez, lo elimina de la barra de direcciones y conserva la sesión local en una cookie de duración limitada; así las recargas y nuevas pestañas no exponen ni vuelven a propagar el token.
+        </li>
+      </ul>
+      <div class="alert alert-info">
+        <strong>Desarrollo y pruebas locales automáticas:</strong> Al ejecutar <code>python3 zerochat.py</code> directamente dentro del repositorio clonado, el script detecta automáticamente el entorno de desarrollo y sirve la interfaz local en <code>http://127.0.0.1:6388/zerochat.html</code> sin necesidad de servidores auxiliares ni parámetros.
+        <br><br>
+        <strong>Cómo lanzar las pruebas:</strong>
+        <ul style="margin-top: 0.5rem; margin-bottom: 0;">
+          <li><code>python3 zerochat.py</code>: Arranca el backend y abre automáticamente la interfaz local de desarrollo en el navegador.</li>
+          <li><code>python3 zerochat.py --test</code>: Ejecuta la autocomprobación interna rápida de herramientas del sistema (lectura, listado y comandos).</li>
+          <li><code>npm test</code>: Ejecuta la suite completa automatizada (unitarias, integración, arquitectura, infraestructura y navegador con Playwright).</li>
+          <li><code>npm run test:browser</code>: Ejecuta exclusivamente las pruebas de interfaz visual y navegador.</li>
+        </ul>
+      </div>
+    </div>
+    <div class="card">
+      <h2>4. Almacenamiento Local y Privacidad de Datos</h2>
+      <p>
+        La arquitectura de datos de ZeroChat sigue el principio de <strong>soberanía del usuario</strong>. La aplicación nunca envía historiales de conversación, credenciales ni documentos a ningún servidor centralizado de telemetría.
+      </p>
+      <h3>Capas de almacenamiento en el cliente:</h3>
+      <ul>
+        <li>
+          <strong>IndexedDB (ZeroChatDB):</strong> Base de datos estructurada en el navegador donde se guardan las sesiones de chat, los mensajes, metadatos, configuraciones de perfiles de usuario y las ramas del motor RAG.
+        </li>
+        <li>
+          <strong>Almacenamiento aislado de adjuntos:</strong> Las imágenes Base64 y los documentos pesados se aíslan en almacenes específicos de IndexedDB para que el árbol de mensajes permanezca rápido, ligero y fluido.
+        </li>
+        <li>
+          <strong>Cache Storage API:</strong> Utilizada por el motor WebLLM para almacenar de forma persistente los pesos y parámetros de modelos locales de lenguaje descargados.
+        </li>
+        <li>
+          <strong>LocalStorage / Cookies de sesión (ChatStorage):</strong> Gestiona estados efímeros y preferencias de interfaz (como el tema oscuro o claro activo).
+        </li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>5. El Estado Canónico (ChatState)</h2>
+      <p>
+        Para evitar fugas de memoria o desincronizaciones entre componentes, ZeroChat utiliza un almacén de estado único y centralizado denominado <code>ChatState</code>.
+      </p>
+      <p>
+        Todo cambio en el ciclo de vida de la aplicación (cambio de sesión, inserción de un mensaje por streaming, progreso de inferencia o invocación de herramientas) se realiza mediante mutadores atómicos de dominio (como <code>appendMessage</code>, <code>replaceMessages</code> o <code>saveSessionMetadata</code>). De este modo, la interfaz se actualiza de manera reactiva y consistente en todo momento.
+      </p>
+    </div>
+    <div class="card">
+      <h2>6. Reglas compartidas de conversación</h2>
+      <p>Las respuestas nuevas y restauradas comparten componentes visuales de bloques y copia. El streaming conserva su cursor durante la generación. Los errores de conexión utilizan una vista común que escapa el mensaje recibido y la URL antes de incorporarlos al HTML.</p>
+      <p>La configuración activa se obtiene de <code>ChatConfig</code>. Las interfaces de perfiles y catálogo consultan al proveedor WebLLM para conocer los modelos completados, sin interpretar por separado sus metadatos almacenados.</p>
+      <p>El estado, el motor y las vistas reutilizan las reglas de <code>message-turns.js</code> para identificar turnos y reconocer mensajes iniciales de fecha. La eliminación de turnos comparte un algoritmo de saneamiento; <code>ChatState</code> conserva el bloqueo durante la generación y la actualización atómica del historial.</p>
+    </div>
+    <nav class="page-navigation" aria-label="Navegación de ayuda">
+      <div class="nav-button disabled">
+        <span class="nav-direction">Primera página</span>
+        <span class="nav-title">—</span>
+      </div>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Índice</span>
+        <span class="nav-title">Ver todos los temas</span>
+      </a>
+      <a href="profiles.html" class="nav-button next">
+        <span class="nav-direction">Siguiente →</span>
+        <span class="nav-title">Perfiles y Proveedores</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Cliente Web Universal de IA · Manual de Usuario</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/composer.html ADDED Viewed

@@ -0,0 +1,134 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Composer, Atajos y Archivos Adjuntos · Ayuda de ZeroChat</title>
+  <meta name="description" content="Guía del cuadro de entrada de ZeroChat: autoexpansión de texto, atajos de teclado y adjuntos multimedia como imágenes para visión, PDFs, código y CSV.">
+  <link rel="stylesheet" href="help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="en/composer.html" class="top-nav-link">English 🌐</a>
+          <a href="index.html" class="top-nav-link">← Volver al Índice</a>
+        </div>
+      </div>
+      <h1>Composer, Atajos y Archivos Adjuntos</h1>
+      <p class="subtitle">Aprende a redactar mensajes con comodidad, utilizar atajos rápidos y enviar archivos multimedia o código al modelo.</p>
+    </header>
+    <div class="card">
+      <h2>1. El Composer Flotante Inteligente</h2>
+      <p>
+        El área de entrada o <strong>Composer</strong> de ZeroChat está diseñada para ofrecer una experiencia moderna, limpia y fluida, inspirada en las mejores interfaces de chat de IA.
+      </p>
+      <ul>
+        <li><strong>Auto-expansión suave:</strong> El campo de texto crece dinámicamente conforme escribes párrafos largos (utilizando la directiva moderna <code>field-sizing: content</code> con soporte de fallback automático), sin desbordar la ventana ni tapar los mensajes previos.</li>
+        <li><strong>Barra inferior integrada:</strong> Reúne adjuntos, razonamiento, RAG y telemetría de contexto. Las herramientas y MCP se configuran desde Ajustes.</li>
+        <li><strong>Entrada móvil:</strong> El campo muestra una indicación breve para que el texto de fondo no ocupe varias líneas en pantallas estrechas.</li>
+        <li><strong>Botón de detención (Stop):</strong> Durante la generación en tiempo real (streaming SSE), el botón de envío se convierte en un botón de parada instantánea para cancelar la respuesta en cualquier momento.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>2. Atajos de Teclado Esenciales</h2>
+      <div class="table-responsive">
+        <table>
+          <thead>
+            <tr>
+              <th>Atajo</th>
+              <th>Contexto</th>
+              <th>Acción realizada</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td><code>Enter</code></td>
+              <td>En el cuadro de texto</td>
+              <td>Enviar el mensaje actual al modelo.</td>
+            </tr>
+            <tr>
+              <td><code>Shift + Enter</code></td>
+              <td>En el cuadro de texto</td>
+              <td>Insertar un salto de línea sin enviar.</td>
+            </tr>
+            <tr>
+              <td><code>Escape</code></td>
+              <td>En cualquier modal o menú</td>
+              <td>Cerrar el diálogo emergente o desplegable activo.</td>
+            </tr>
+            <tr>
+              <td><code>Flechas ↑ / ↓</code></td>
+              <td>En el selector de perfiles</td>
+              <td>Navegar entre los perfiles disponibles de la lista.</td>
+            </tr>
+            <tr>
+              <td><code>Ctrl / Cmd + V</code></td>
+              <td>En la ventana del chat</td>
+              <td>Pegar imágenes o texto directamente desde el portapapeles.</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+    <div class="card">
+      <h2>3. Adjuntar Archivos y Documentos</h2>
+      <p>
+        ZeroChat cuenta con un potente motor cliente de procesamiento de archivos (<code>file-parser.js</code>). Puedes añadir archivos pulsando el icono del clip o simplemente <strong>arrastrándolos y soltándolos</strong> (Drag & Drop) sobre el área del chat.
+      </p>
+      <h3>Formatos compatibles:</h3>
+      <ul>
+        <li><strong>Imágenes (PNG, JPEG, WebP, GIF):</strong> Si el modelo activo soporta capacidades multimodales de visión (como GPT-4o, Claude 3.5/3.7 Sonnet o Gemini Flash/Pro), la imagen se procesa y se envía al modelo para que pueda analizarla, describirla o extraer información de ella.</li>
+        <li><strong>Documentos PDF:</strong> El texto del PDF se extrae localmente en el navegador y se adjunta de forma estructurada al mensaje con su nombre y recuento de páginas.</li>
+        <li><strong>Código Fuente y Scripts:</strong> Archivos <code>.js</code>, <code>.ts</code>, <code>.py</code>, <code>.html</code>, <code>.css</code>, <code>.json</code>, <code>.sql</code>, <code>.c</code>, <code>.cpp</code>, <code>.rs</code>, <code>.go</code>, <code>.sh</code> y más. Se preparan como bloques de código con marcado de sintaxis.</li>
+        <li><strong>Tablas y Datos:</strong> Archivos <code>.csv</code> y <code>.tsv</code> que el modelo puede parsear e interpretar para análisis de datos o generación de gráficos.</li>
+        <li><strong>Documentos de Texto:</strong> <code>.md</code> (Markdown), <code>.txt</code>, <code>.xml</code>, <code>.yaml</code>.</li>
+      </ul>
+      <div class="alert alert-info">
+        <strong>Previsualización y eliminación:</strong> Antes de pulsar enviar, verás miniaturas interactivas de cada archivo adjunto con su nombre y tamaño. Puedes eliminar cualquiera de ellos pulsando su botón "X".
+      </div>
+    </div>
+    <div class="card">
+      <h2>4. Renderizado Enriquecido de Mensajes</h2>
+      <p>
+        Las respuestas del asistente se procesan con un motor Markdown completo de alto rendimiento que incluye:
+      </p>
+      <ul>
+        <li>Resaltado de sintaxis en bloques de código con botón de copia rápida al portapapeles.</li>
+        <li>Tablas formateadas con alineación de columnas.</li>
+        <li>Fórmulas matemáticas en formato LaTeX (KaTeX) inline y en bloque.</li>
+        <li>Bloques colapsables de razonamiento (Thinking) con contador de tiempo de reflexión.</li>
+        <li>Tarjetas interactivas de herramientas (Tool Cards) para ejecuciones del agente.</li>
+      </ul>
+    </div>
+    <nav class="page-navigation" aria-label="Navegación de ayuda">
+      <a href="conversations.html" class="nav-button prev">
+        <span class="nav-direction">← Anterior</span>
+        <span class="nav-title">Conversaciones y Ramas</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Índice</span>
+        <span class="nav-title">Ver todos los temas</span>
+      </a>
+      <a href="reasoning-telemetry.html" class="nav-button next">
+        <span class="nav-direction">Siguiente →</span>
+        <span class="nav-title">Razonamiento y Telemetría</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Cliente Web Universal de IA · Manual de Usuario</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/conversations.html ADDED Viewed

@@ -0,0 +1,105 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Conversaciones, Historial y Ramas · Ayuda de ZeroChat</title>
+  <meta name="description" content="Manual para organizar chats en ZeroChat: barra lateral cronológica, búsqueda de conversaciones, ramificación (branching) y exportación/importación segura.">
+  <link rel="stylesheet" href="help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="en/conversations.html" class="top-nav-link">English 🌐</a>
+          <a href="index.html" class="top-nav-link">← Volver al Índice</a>
+        </div>
+      </div>
+      <h1>Conversaciones, Historial y Ramas</h1>
+      <p class="subtitle">Aprende a gestionar tus sesiones de chat, explorar caminos alternativos con branching y respaldar tus datos.</p>
+    </header>
+    <div class="card">
+      <h2>1. La Barra Lateral de Conversaciones</h2>
+      <p>
+        En la parte izquierda de la pantalla encontrarás la <strong>Barra Lateral</strong> (accesible en dispositivos móviles mediante el icono de menú superior).
+      </p>
+      <p>Características principales de la barra lateral:</p>
+      <ul>
+        <li><strong>Nueva conversación:</strong> Botón directo para iniciar un chat limpio conservando el perfil seleccionado.</li>
+        <li><strong>Agrupación cronológica inteligente:</strong> Las conversaciones se ordenan automáticamente en secciones temporales legibles: <em>Hoy</em>, <em>Ayer</em>, <em>Últimos 7 días</em>, <em>Este mes</em> y <em>Anteriores</em>.</li>
+        <li><strong>Búsqueda en tiempo real:</strong> Escribe en el cuadro de búsqueda para filtrar al instante cualquier conversación por su título.</li>
+        <li><strong>Acciones rápidas por sesión:</strong> Al pasar el ratón por cada chat, dispones de botones para exportar esa conversación individual o borrarla.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>2. Ramificación de Conversaciones (Branching)</h2>
+      <p>
+        El <strong>Branching</strong> o ramificación es una de las funcionalidades más potentes de ZeroChat para explorar ideas sin perder el contexto original.
+      </p>
+      <h3>¿Cómo funciona?</h3>
+      <ol>
+        <li>Bajo cualquier respuesta del asistente verás el botón de ramificación con el icono de bifurcación (<em>Branch</em>).</li>
+        <li>Al pulsar sobre él, ZeroChat crea una <strong>nueva conversación independiente</strong> que contiene el historial exacto hasta ese punto seleccionado.</li>
+        <li>Los turnos posteriores de la conversación original se descartan en la nueva rama, permitiéndote formular una pregunta distinta, cambiar de modelo o probar una hipótesis alternativa.</li>
+        <li>La conversación origen permanece intacta y ambas ramas pueden consultarse y continuarse en cualquier momento desde la barra lateral.</li>
+      </ol>
+      <div class="alert alert-info">
+        <strong>Caso de uso típico:</strong> Imagina que el asistente te da dos posibles soluciones a un problema. Puedes ramificar en esa respuesta para seguir desarrollando la "Opción A" en una conversación y la "Opción B" en otra diferente.
+      </div>
+    </div>
+    <div class="card">
+      <h2>3. Exportación de Conversaciones</h2>
+      <p>
+        ZeroChat te permite exportar tus conversaciones en múltiples formatos estándar para compartirlas, archivarlas o usarlas en informes:
+      </p>
+      <ul>
+        <li><strong>JSON Completo de Sesión:</strong> Incluye los mensajes de usuario y asistente, metadatos, perfil utilizado, uso de tokens y llamadas a herramientas. Este archivo sirve además como copia de seguridad exacta que puedes importar de vuelta.</li>
+        <li><strong>Markdown (.md):</strong> Formato de texto estructurado listo para publicar en GitHub, Obsidian, Notion o tu editor favorito, preservando encabezados, bloques de código, tablas y fórmulas matemáticas.</li>
+        <li><strong>Texto Plano (.txt):</strong> Transcripción limpia y ligera de la conversación para lectura rápida.</li>
+        <li><strong>PDF:</strong> Vista preparada para imprimir o guardar como PDF.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>4. Importación y Copia de Seguridad</h2>
+      <p>
+        En el pie de la barra lateral dispones del botón <strong>"Importar conversación"</strong>. Permite seleccionar cualquier archivo <code>.json</code> exportado previamente por ZeroChat.
+      </p>
+      <p>
+        Al importar, la conversación se valida de forma estricta, se sanitiza para prevenir inyecciones maliciosas y se almacena en tu base de datos IndexedDB local, apareciendo al instante en la lista de chats.
+      </p>
+      <p>Solo se importan copias JSON de ZeroChat y la importación no está disponible mientras se genera una respuesta.</p>
+      <div class="alert alert-warning">
+        <strong>Borrado masivo seguro:</strong> El botón con icono de papelera en el pie de la barra lateral permite eliminar todas las conversaciones de golpe. Antes de proceder, ZeroChat solicitará tu confirmación explícita para evitar pérdidas accidentales.
+      </div>
+    </div>
+    <nav class="page-navigation" aria-label="Navegación de ayuda">
+      <a href="debug.html" class="nav-button prev">
+        <span class="nav-direction">← Anterior</span>
+        <span class="nav-title">Depuración e Interceptor</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Índice</span>
+        <span class="nav-title">Ver todos los temas</span>
+      </a>
+      <a href="composer.html" class="nav-button next">
+        <span class="nav-direction">Siguiente →</span>
+        <span class="nav-title">Composer y Multimedia</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Cliente Web Universal de IA · Manual de Usuario</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/debug.html ADDED Viewed

@@ -0,0 +1,108 @@
+<!DOCTYPE html>
+<html lang="es">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Depuración, Logs e Interceptor de Mensajes · Ayuda de ZeroChat</title>
+  <meta name="description" content="Guía del panel de depuración, visor Raw e interceptor de peticiones de ZeroChat.">
+  <link rel="stylesheet" href="help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="en/debug.html" class="top-nav-link">English 🌐</a>
+          <a href="index.html" class="top-nav-link">← Volver al Índice</a>
+        </div>
+      </div>
+      <h1>Depuración, Logs e Interceptor</h1>
+      <p class="subtitle">Inspecciona las entrañas de la inferencia, supervisa el tráfico de red y modifica peticiones en vuelo con el interceptor interactivo.</p>
+    </header>
+    <div class="card">
+      <h2>1. El Panel Lateral de Depuración (Debug Panel)</h2>
+      <p>
+        ZeroChat incluye un panel lateral derecho especializado para desarrolladores, auditores de seguridad y usuarios curiosos. Se abre pulsando el icono de terminal en la esquina superior derecha del encabezado.
+      </p>
+      <p>
+        Este panel muestra en tiempo real una consola con formato monoespaciado donde se registran cronológicamente todos los eventos internos de la aplicación.
+      </p>
+      <h3>Pestañas de Filtrado de Eventos:</h3>
+      <ul>
+        <li><strong>Todo (All):</strong> Vista unificada con todos los mensajes del sistema, red y herramientas.</li>
+        <li><strong>Razonamiento (Thinking):</strong> Filtra exclusivamente los fragmentos de pensamiento interno generados por el modelo.</li>
+        <li><strong>Herramientas (Tool):</strong> Muestra las llamadas a funciones emitidas por el agente y los valores devueltos tras la ejecución.</li>
+        <li><strong>Red (Network):</strong> Peticiones HTTP, cabeceras, códigos de respuesta de los servidores de inferencia y tiempos de conexión.</li>
+        <li><strong>Raw:</strong> Muestra las entradas y salidas sin procesar de la comunicación del proveedor.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>2. Utilidades de la Consola de Logs</h2>
+      <p>En la cabecera del panel de depuración dispones de acciones rápidas:</p>
+      <ul>
+        <li><strong>Copiar logs:</strong> Vuelca todo el historial de eventos en el portapapeles en formato texto con marcas de tiempo para adjuntarlo a un reporte de incidencias o bug.</li>
+        <li><strong>Limpiar consola:</strong> Vacía el registro en pantalla para comenzar una nueva sesión de depuración limpia.</li>
+        <li><strong>Auto-scroll:</strong> Alterna entre seguir automáticamente la salida conforme se emite o pausar el desplazamiento para examinar un fragmento anterior con comodidad.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>3. Modo Interceptor de Mensajes (Debug Messages)</h2>
+      <p>
+        Una de las herramientas más singulares de ZeroChat para experimentación y pruebas de seguridad es el <strong>Interceptor de Mensajes</strong>. Se activa mediante el interruptor <em>"Debug messages"</em> en la barra de controles del panel de depuración.
+      </p>
+      <h3>¿Cómo funciona el interceptor?</h3>
+      <ol>
+        <li>Al escribir un mensaje en el chat y pulsar Enviar, la petición <strong>no viaja inmediatamente a la red</strong>.</li>
+        <li>Se abre una ventana modal de inspección interactiva mostrando el <strong>payload JSON exacto</strong> que se iba a transmitir al proveedor (mensajes del historial, sistema de prompts, herramientas registradas, temperatura, etc.).</li>
+        <li>Puedes inspeccionar los campos, editar manualmente cualquier parámetro o inyectar roles de prueba directamente en el editor.</li>
+        <li>La cabecera reúne las acciones de envío y el botón X para cancelar:
+          <ul>
+            <li><strong>Continuar / Enviar:</strong> Transmite la petición (con las modificaciones que hayas realizado) al servidor.</li>
+            <li><strong>Enviar y parar debug:</strong> Transmite la petición y desactiva el interceptor para los siguientes envíos.</li>
+            <li><strong>X:</strong> Aborta el envío de forma limpia sin generar tráfico ni consumir tokens.</li>
+          </ul>
+        </li>
+      </ol>
+      <div class="alert alert-info">
+        <strong>Ideal para desarrolladores:</strong> Esta función permite simular respuestas intermedias, evaluar la resistencia del modelo ante jailbreaks o prompts modificados y comprobar cómo empaqueta ZeroChat las herramientas en la llamada HTTP.
+      </div>
+    </div>
+    <div class="card">
+      <h2>4. Vista Raw</h2>
+      <p>
+        La pestaña <em>Raw</em> está disponible directamente en el panel; no requiere activación adicional. Las entradas se limitan para que el panel siga siendo utilizable.
+      </p>
+      <p>
+        Úsala para comprobar solicitudes, respuestas de streaming y llamadas a herramientas al diagnosticar un proveedor.
+      </p>
+    </div>
+    <nav class="page-navigation" aria-label="Navegación de ayuda">
+      <a href="mcp.html" class="nav-button prev">
+        <span class="nav-direction">← Anterior</span>
+        <span class="nav-title">Protocolo MCP</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Índice</span>
+        <span class="nav-title">Ver todos los temas</span>
+      </a>
+      <a href="conversations.html" class="nav-button next">
+        <span class="nav-direction">Siguiente →</span>
+        <span class="nav-title">Conversaciones y Ramas</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Cliente Web Universal de IA · Manual de Usuario</p>
+    </footer>
+  </div>
+</body>
+</html>