zerochat 7.11.0__tar.gz → 8.0.0__tar.gz

zerochat-8.0.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: zerochat
+Version: 8.0.0
+Summary: Private local web client for AI models, tools and MCP services
+Author: Alberto Alday
+License-Expression: MIT
+Project-URL: Homepage, https://albalday.github.io/zerochat/
+Project-URL: Repository, https://github.com/albalday/zerochat
+Project-URL: Issues, https://github.com/albalday/zerochat/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ZeroChat
+
+ZeroChat es un cliente web de uso personal para conversar con modelos de IA, consultar documentos y utilizar herramientas. Esta documentación corresponde a la serie **8.x**, que consolida las funcionalidades existentes. El desarrollo de nuevas funcionalidades queda en pausa por el momento.
+
+La interfaz se sirve como archivos estáticos: `zerochat.html` necesita sus módulos `js/` y `css/`. El historial y la configuración se guardan en el navegador; no se sincronizan automáticamente entre dispositivos. Los proveedores remotos reciben el contenido incluido en las peticiones, y las herramientas web pueden utilizar servicios intermediarios. Almacenamiento local no significa privacidad absoluta.
+
+*English:* ZeroChat is a web client for personal use: chatting with AI models, consulting documents and using tools. This documentation covers the **8.x** series, which consolidates existing features. New feature development is paused for now.
+
+The interface is served as static files: `zerochat.html` needs its `js/` and `css/` modules. History and settings are stored in the browser, without automatic cross-device sync. Remote providers receive content included in requests, and web tools may use intermediary services. Local storage does not mean absolute privacy.
+
+## Características principales / Main features
+
+- **Perfiles:** OpenAI y APIs de chat compatibles, Ollama, OpenRouter, Claude y Gemini. La visión, las herramientas y el razonamiento dependen del modelo y del adaptador.
+- **WebLLM:** inferencia en el navegador con WebGPU, tras descargar un modelo. Necesita hardware compatible y memoria suficiente.
+- **Documentos:** adjuntos y colecciones RAG con extracción local y búsqueda léxica mediante Orama; sin embeddings. Los fragmentos recuperados se envían al modelo elegido. La extracción de PDF tiene límites y no incluye OCR general.
+- **Herramientas:** JavaScript aislado, búsqueda y lectura web, gráficos, planes y puntos de control. El backend opcional añade archivos, comandos, diagnósticos, automatización de navegador y servicios MCP.
+- **Historial y diagnóstico:** ramas de conversación, exportación JSON y Markdown, impresión a PDF, métricas de contexto y revisión de peticiones antes del envío.
+
+*English:*
+
+- **Profiles:** OpenAI and compatible chat APIs, Ollama, OpenRouter, Claude and Gemini. Vision, tools and reasoning depend on the model and adapter.
+- **WebLLM:** browser inference through WebGPU after downloading a model. Requires compatible hardware and enough memory.
+- **Documents:** attachments and RAG collections with local extraction and Orama lexical search, without embeddings. Retrieved passages are sent to the selected model. PDF extraction has limitations and no general OCR.
+- **Tools:** isolated JavaScript, web search and retrieval, charts, plans and checkpoints. The optional backend adds files, commands, diagnostics, browser automation and MCP services.
+- **History and diagnostics:** conversation branches, JSON and Markdown export, printing to PDF, context metrics and request inspection before sending.
+
+## Inicio rápido / Quick start
+
+Abre [ZeroChat en GitHub Pages](https://albalday.github.io/zerochat/zerochat.html), crea un perfil, introduce la URL y la clave si corresponde, consulta los modelos con **Query** y guarda. El perfil **Espejo** permite probar la interfaz sin inferencia. Para WebLLM, prepara un modelo del catálogo.
+
+*English:* Open [ZeroChat on GitHub Pages](https://albalday.github.io/zerochat/zerochat.html), create a profile, enter the URL and key where required, query models with **Query**, and save. **Mirror** lets you try the interface without inference. For WebLLM, prepare a catalogue model.
+
+Para añadir herramientas del equipo, instala y ejecuta el backend con Python. / To add computer tools, install and run the Python backend:
+
+```bash
+pip install zerochat
+zerochat
+```
+
+También puedes descargar el script y ejecutarlo. / You can also download and run the script:
+
+```bash
+curl -sL https://albalday.github.io/zerochat/zerochat.py -o zerochat.py
+python3 zerochat.py
+```
+
+Fuera del repositorio de desarrollo, ambos modos abren la interfaz de GitHub Pages. Crean `~/zerochat/` para configuración y servicios, con `.venv/` para dependencias MCP Python. Mantén el proceso abierto y usa su enlace de arranque para autenticar la conexión local. Revisa **Ajustes → MCP** y **Permisos** antes de habilitar herramientas: los comandos actúan con los permisos del proceso local y detenerlos no deshace cambios.
+
+Borrar `~/zerochat/` elimina ese estado y los MCP gestionados, no el ejecutable, los archivos modificados fuera de esa carpeta ni los datos del navegador. Exporta las conversaciones y perfiles que quieras conservar; sus copias no incluyen las colecciones RAG ni los modelos descargados. El cifrado predeterminado de perfiles utiliza una clave integrada conocida: trata las copias como archivos sensibles.
+
+*English:* Outside the development repository, both modes open the GitHub Pages interface. They create `~/zerochat/` for configuration and services, with `.venv/` for Python MCP dependencies. Keep the process running and use its startup link to authenticate the local connection. Review **Settings → MCP** and **Permissions** before enabling tools: commands run with the local process permissions, and stopping them does not undo changes.
+
+Deleting `~/zerochat/` removes that state and managed MCP services, not the executable, files changed elsewhere or browser data. Export conversations and profiles you want to keep; these backups do not include RAG collections or downloaded models. Default profile encryption uses a known built-in key: treat backups as sensitive files.
+
+## Documentación y ayuda / Documentation and help
+
+- [Ayuda de ZeroChat 8.x — Español](https://albalday.github.io/zerochat/help/index.html)
+- [ZeroChat 8.x help — English](https://albalday.github.io/zerochat/help/en/index.html)
+
+Las guías explican configuración, uso y límites. Los informes conservan su versión y fecha de revisión originales; no son una certificación de 8.x ni una promesa de nuevas funcionalidades.
+
+*English:* The guides explain setup, usage and limits. Reports retain their original reviewed version and date; they are not an 8.x certification or a promise of new features.
+
+## Desarrollo / Development
+
+Trabaja en `dev`. Para instalar dependencias y ejecutar las pruebas del proyecto: / Work on `dev`. To install dependencies and run the project tests:
+
+```bash
+npm install
+npm test
+```
+
+Dentro del repositorio, `python3 zerochat.py` sirve la interfaz local de desarrollo. Si modificas `py/`, reconstruye `zerochat.py` con `npm run build:backend`. La web carga directamente sus módulos, sin un bundle de aplicación.
+
+*English:* Inside the repository, `python3 zerochat.py` serves the local development interface. After changing `py/`, rebuild `zerochat.py` with `npm run build:backend`. The web app loads its modules directly, without an application bundle.
+
+Las normas y validaciones se describen en [`AGENTS.md`](./AGENTS.md) y [`tests/README.md`](./tests/README.md).
+
+*English:* See those files for the applicable development rules and validation.

zerochat-8.0.0/README.md

@@ -0,0 +1,79 @@
+# ZeroChat
+
+ZeroChat es un cliente web de uso personal para conversar con modelos de IA, consultar documentos y utilizar herramientas. Esta documentación corresponde a la serie **8.x**, que consolida las funcionalidades existentes. El desarrollo de nuevas funcionalidades queda en pausa por el momento.
+
+La interfaz se sirve como archivos estáticos: `zerochat.html` necesita sus módulos `js/` y `css/`. El historial y la configuración se guardan en el navegador; no se sincronizan automáticamente entre dispositivos. Los proveedores remotos reciben el contenido incluido en las peticiones, y las herramientas web pueden utilizar servicios intermediarios. Almacenamiento local no significa privacidad absoluta.
+
+*English:* ZeroChat is a web client for personal use: chatting with AI models, consulting documents and using tools. This documentation covers the **8.x** series, which consolidates existing features. New feature development is paused for now.
+
+The interface is served as static files: `zerochat.html` needs its `js/` and `css/` modules. History and settings are stored in the browser, without automatic cross-device sync. Remote providers receive content included in requests, and web tools may use intermediary services. Local storage does not mean absolute privacy.
+
+## Características principales / Main features
+
+- **Perfiles:** OpenAI y APIs de chat compatibles, Ollama, OpenRouter, Claude y Gemini. La visión, las herramientas y el razonamiento dependen del modelo y del adaptador.
+- **WebLLM:** inferencia en el navegador con WebGPU, tras descargar un modelo. Necesita hardware compatible y memoria suficiente.
+- **Documentos:** adjuntos y colecciones RAG con extracción local y búsqueda léxica mediante Orama; sin embeddings. Los fragmentos recuperados se envían al modelo elegido. La extracción de PDF tiene límites y no incluye OCR general.
+- **Herramientas:** JavaScript aislado, búsqueda y lectura web, gráficos, planes y puntos de control. El backend opcional añade archivos, comandos, diagnósticos, automatización de navegador y servicios MCP.
+- **Historial y diagnóstico:** ramas de conversación, exportación JSON y Markdown, impresión a PDF, métricas de contexto y revisión de peticiones antes del envío.
+
+*English:*
+
+- **Profiles:** OpenAI and compatible chat APIs, Ollama, OpenRouter, Claude and Gemini. Vision, tools and reasoning depend on the model and adapter.
+- **WebLLM:** browser inference through WebGPU after downloading a model. Requires compatible hardware and enough memory.
+- **Documents:** attachments and RAG collections with local extraction and Orama lexical search, without embeddings. Retrieved passages are sent to the selected model. PDF extraction has limitations and no general OCR.
+- **Tools:** isolated JavaScript, web search and retrieval, charts, plans and checkpoints. The optional backend adds files, commands, diagnostics, browser automation and MCP services.
+- **History and diagnostics:** conversation branches, JSON and Markdown export, printing to PDF, context metrics and request inspection before sending.
+
+## Inicio rápido / Quick start
+
+Abre [ZeroChat en GitHub Pages](https://albalday.github.io/zerochat/zerochat.html), crea un perfil, introduce la URL y la clave si corresponde, consulta los modelos con **Query** y guarda. El perfil **Espejo** permite probar la interfaz sin inferencia. Para WebLLM, prepara un modelo del catálogo.
+
+*English:* Open [ZeroChat on GitHub Pages](https://albalday.github.io/zerochat/zerochat.html), create a profile, enter the URL and key where required, query models with **Query**, and save. **Mirror** lets you try the interface without inference. For WebLLM, prepare a catalogue model.
+
+Para añadir herramientas del equipo, instala y ejecuta el backend con Python. / To add computer tools, install and run the Python backend:
+
+```bash
+pip install zerochat
+zerochat
+```
+
+También puedes descargar el script y ejecutarlo. / You can also download and run the script:
+
+```bash
+curl -sL https://albalday.github.io/zerochat/zerochat.py -o zerochat.py
+python3 zerochat.py
+```
+
+Fuera del repositorio de desarrollo, ambos modos abren la interfaz de GitHub Pages. Crean `~/zerochat/` para configuración y servicios, con `.venv/` para dependencias MCP Python. Mantén el proceso abierto y usa su enlace de arranque para autenticar la conexión local. Revisa **Ajustes → MCP** y **Permisos** antes de habilitar herramientas: los comandos actúan con los permisos del proceso local y detenerlos no deshace cambios.
+
+Borrar `~/zerochat/` elimina ese estado y los MCP gestionados, no el ejecutable, los archivos modificados fuera de esa carpeta ni los datos del navegador. Exporta las conversaciones y perfiles que quieras conservar; sus copias no incluyen las colecciones RAG ni los modelos descargados. El cifrado predeterminado de perfiles utiliza una clave integrada conocida: trata las copias como archivos sensibles.
+
+*English:* Outside the development repository, both modes open the GitHub Pages interface. They create `~/zerochat/` for configuration and services, with `.venv/` for Python MCP dependencies. Keep the process running and use its startup link to authenticate the local connection. Review **Settings → MCP** and **Permissions** before enabling tools: commands run with the local process permissions, and stopping them does not undo changes.
+
+Deleting `~/zerochat/` removes that state and managed MCP services, not the executable, files changed elsewhere or browser data. Export conversations and profiles you want to keep; these backups do not include RAG collections or downloaded models. Default profile encryption uses a known built-in key: treat backups as sensitive files.
+
+## Documentación y ayuda / Documentation and help
+
+- [Ayuda de ZeroChat 8.x — Español](https://albalday.github.io/zerochat/help/index.html)
+- [ZeroChat 8.x help — English](https://albalday.github.io/zerochat/help/en/index.html)
+
+Las guías explican configuración, uso y límites. Los informes conservan su versión y fecha de revisión originales; no son una certificación de 8.x ni una promesa de nuevas funcionalidades.
+
+*English:* The guides explain setup, usage and limits. Reports retain their original reviewed version and date; they are not an 8.x certification or a promise of new features.
+
+## Desarrollo / Development
+
+Trabaja en `dev`. Para instalar dependencias y ejecutar las pruebas del proyecto: / Work on `dev`. To install dependencies and run the project tests:
+
+```bash
+npm install
+npm test
+```
+
+Dentro del repositorio, `python3 zerochat.py` sirve la interfaz local de desarrollo. Si modificas `py/`, reconstruye `zerochat.py` con `npm run build:backend`. La web carga directamente sus módulos, sin un bundle de aplicación.
+
+*English:* Inside the repository, `python3 zerochat.py` serves the local development interface. After changing `py/`, rebuild `zerochat.py` with `npm run build:backend`. The web app loads its modules directly, without an application bundle.
+
+Las normas y validaciones se describen en [`AGENTS.md`](./AGENTS.md) y [`tests/README.md`](./tests/README.md).
+
+*English:* See those files for the applicable development rules and validation.

{zerochat-7.11.0 → zerochat-8.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "zerochat"
-version = "7.11.0"
+version = "8.0.0"
 description = "Private local web client for AI models, tools and MCP services"
 readme = "README.md"
 requires-python = ">=3.10"

zerochat-8.0.0/zerochat.egg-info/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: zerochat
+Version: 8.0.0
+Summary: Private local web client for AI models, tools and MCP services
+Author: Alberto Alday
+License-Expression: MIT
+Project-URL: Homepage, https://albalday.github.io/zerochat/
+Project-URL: Repository, https://github.com/albalday/zerochat
+Project-URL: Issues, https://github.com/albalday/zerochat/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ZeroChat
+
+ZeroChat es un cliente web de uso personal para conversar con modelos de IA, consultar documentos y utilizar herramientas. Esta documentación corresponde a la serie **8.x**, que consolida las funcionalidades existentes. El desarrollo de nuevas funcionalidades queda en pausa por el momento.
+
+La interfaz se sirve como archivos estáticos: `zerochat.html` necesita sus módulos `js/` y `css/`. El historial y la configuración se guardan en el navegador; no se sincronizan automáticamente entre dispositivos. Los proveedores remotos reciben el contenido incluido en las peticiones, y las herramientas web pueden utilizar servicios intermediarios. Almacenamiento local no significa privacidad absoluta.
+
+*English:* ZeroChat is a web client for personal use: chatting with AI models, consulting documents and using tools. This documentation covers the **8.x** series, which consolidates existing features. New feature development is paused for now.
+
+The interface is served as static files: `zerochat.html` needs its `js/` and `css/` modules. History and settings are stored in the browser, without automatic cross-device sync. Remote providers receive content included in requests, and web tools may use intermediary services. Local storage does not mean absolute privacy.
+
+## Características principales / Main features
+
+- **Perfiles:** OpenAI y APIs de chat compatibles, Ollama, OpenRouter, Claude y Gemini. La visión, las herramientas y el razonamiento dependen del modelo y del adaptador.
+- **WebLLM:** inferencia en el navegador con WebGPU, tras descargar un modelo. Necesita hardware compatible y memoria suficiente.
+- **Documentos:** adjuntos y colecciones RAG con extracción local y búsqueda léxica mediante Orama; sin embeddings. Los fragmentos recuperados se envían al modelo elegido. La extracción de PDF tiene límites y no incluye OCR general.
+- **Herramientas:** JavaScript aislado, búsqueda y lectura web, gráficos, planes y puntos de control. El backend opcional añade archivos, comandos, diagnósticos, automatización de navegador y servicios MCP.
+- **Historial y diagnóstico:** ramas de conversación, exportación JSON y Markdown, impresión a PDF, métricas de contexto y revisión de peticiones antes del envío.
+
+*English:*
+
+- **Profiles:** OpenAI and compatible chat APIs, Ollama, OpenRouter, Claude and Gemini. Vision, tools and reasoning depend on the model and adapter.
+- **WebLLM:** browser inference through WebGPU after downloading a model. Requires compatible hardware and enough memory.
+- **Documents:** attachments and RAG collections with local extraction and Orama lexical search, without embeddings. Retrieved passages are sent to the selected model. PDF extraction has limitations and no general OCR.
+- **Tools:** isolated JavaScript, web search and retrieval, charts, plans and checkpoints. The optional backend adds files, commands, diagnostics, browser automation and MCP services.
+- **History and diagnostics:** conversation branches, JSON and Markdown export, printing to PDF, context metrics and request inspection before sending.
+
+## Inicio rápido / Quick start
+
+Abre [ZeroChat en GitHub Pages](https://albalday.github.io/zerochat/zerochat.html), crea un perfil, introduce la URL y la clave si corresponde, consulta los modelos con **Query** y guarda. El perfil **Espejo** permite probar la interfaz sin inferencia. Para WebLLM, prepara un modelo del catálogo.
+
+*English:* Open [ZeroChat on GitHub Pages](https://albalday.github.io/zerochat/zerochat.html), create a profile, enter the URL and key where required, query models with **Query**, and save. **Mirror** lets you try the interface without inference. For WebLLM, prepare a catalogue model.
+
+Para añadir herramientas del equipo, instala y ejecuta el backend con Python. / To add computer tools, install and run the Python backend:
+
+```bash
+pip install zerochat
+zerochat
+```
+
+También puedes descargar el script y ejecutarlo. / You can also download and run the script:
+
+```bash
+curl -sL https://albalday.github.io/zerochat/zerochat.py -o zerochat.py
+python3 zerochat.py
+```
+
+Fuera del repositorio de desarrollo, ambos modos abren la interfaz de GitHub Pages. Crean `~/zerochat/` para configuración y servicios, con `.venv/` para dependencias MCP Python. Mantén el proceso abierto y usa su enlace de arranque para autenticar la conexión local. Revisa **Ajustes → MCP** y **Permisos** antes de habilitar herramientas: los comandos actúan con los permisos del proceso local y detenerlos no deshace cambios.
+
+Borrar `~/zerochat/` elimina ese estado y los MCP gestionados, no el ejecutable, los archivos modificados fuera de esa carpeta ni los datos del navegador. Exporta las conversaciones y perfiles que quieras conservar; sus copias no incluyen las colecciones RAG ni los modelos descargados. El cifrado predeterminado de perfiles utiliza una clave integrada conocida: trata las copias como archivos sensibles.
+
+*English:* Outside the development repository, both modes open the GitHub Pages interface. They create `~/zerochat/` for configuration and services, with `.venv/` for Python MCP dependencies. Keep the process running and use its startup link to authenticate the local connection. Review **Settings → MCP** and **Permissions** before enabling tools: commands run with the local process permissions, and stopping them does not undo changes.
+
+Deleting `~/zerochat/` removes that state and managed MCP services, not the executable, files changed elsewhere or browser data. Export conversations and profiles you want to keep; these backups do not include RAG collections or downloaded models. Default profile encryption uses a known built-in key: treat backups as sensitive files.
+
+## Documentación y ayuda / Documentation and help
+
+- [Ayuda de ZeroChat 8.x — Español](https://albalday.github.io/zerochat/help/index.html)
+- [ZeroChat 8.x help — English](https://albalday.github.io/zerochat/help/en/index.html)
+
+Las guías explican configuración, uso y límites. Los informes conservan su versión y fecha de revisión originales; no son una certificación de 8.x ni una promesa de nuevas funcionalidades.
+
+*English:* The guides explain setup, usage and limits. Reports retain their original reviewed version and date; they are not an 8.x certification or a promise of new features.
+
+## Desarrollo / Development
+
+Trabaja en `dev`. Para instalar dependencias y ejecutar las pruebas del proyecto: / Work on `dev`. To install dependencies and run the project tests:
+
+```bash
+npm install
+npm test
+```
+
+Dentro del repositorio, `python3 zerochat.py` sirve la interfaz local de desarrollo. Si modificas `py/`, reconstruye `zerochat.py` con `npm run build:backend`. La web carga directamente sus módulos, sin un bundle de aplicación.
+
+*English:* Inside the repository, `python3 zerochat.py` serves the local development interface. After changing `py/`, rebuild `zerochat.py` with `npm run build:backend`. The web app loads its modules directly, without an application bundle.
+
+Las normas y validaciones se describen en [`AGENTS.md`](./AGENTS.md) y [`tests/README.md`](./tests/README.md).
+
+*English:* See those files for the applicable development rules and validation.

{zerochat-7.11.0 → zerochat-8.0.0}/zerochat.py

@@ -14,8 +14,10 @@ from __future__ import annotations
 import argparse
 import ast
 import atexit
+import base64
 import datetime
 import fnmatch
+import hashlib
 import hmac
 import importlib.metadata
 import json
@@ -40,7 +42,7 @@ import webbrowser
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 
-SOURCE_BACKEND_VERSION = "7.11.0"
+SOURCE_BACKEND_VERSION = "8.0.0"
 
 def _read_source_version(filename: str) -> str | None:
     """Lee la versión de un archivo del repositorio cuando se ejecuta desde fuentes."""
@@ -96,143 +98,97 @@ PYPI_VERSION_URL = "https://pypi.org/pypi/zerochat/json"
 REMOTE_SCRIPT_URL = "https://raw.githubusercontent.com/albalday/zerochat/master/zerochat.py"
 CONSOLE_STATUS_IDLE_SECONDS = 8.0
 CONSOLE_CONTROL = None
-
-
-def format_uptime(seconds: float) -> str:
-    """Devuelve una duración breve y estable para la línea de estado de consola."""
-    total = max(0, int(seconds))
-    hours, remainder = divmod(total, 3600)
-    minutes, secs = divmod(remainder, 60)
-    return f"{hours:02d}:{minutes:02d}:{secs:02d}"
-
-
+NOTICES: list[str] = []
+NOTICES_LOCK = threading.Lock()
 class ConsoleControl:
-    """Atajos de consola y línea de estado, solo para terminales interactivos."""
+    """Muestra una sola línea de ayuda tras un periodo de inactividad en consola."""
     def __init__(self, server: ThreadingHTTPServer, parser: argparse.ArgumentParser, target_url: str | None = None):
         self.server = server
         self.parser = parser
         self.target_url = target_url
-        self.started_at = time.monotonic()
-        self.last_activity = self.started_at
-        self.stop_event = threading.Event()
+        self.last_activity = time.monotonic()
         self.lock = threading.Lock()
-        self.status_visible = False
-        self.enabled = bool(getattr(sys.stdin, "isatty", lambda: False)() and getattr(sys.stdout, "isatty", lambda: False)())
-        self._threads: list[threading.Thread] = []
-        self._terminal_fd: int | None = None
-        self._terminal_state = None
+        self.enabled = bool(getattr(sys.stdout, "isatty", lambda: False)())
+        self._keyboard_enabled = bool(getattr(sys.stdin, "isatty", lambda: False)())
+        self._idle_timer: threading.Timer | None = None
+        self._keyboard_stop = threading.Event()
+        self._keyboard_thread: threading.Thread | None = None
+        self._timer_generation = 0
         self._closed = False
 
     def start(self):
-        if not self.enabled:
-            return
-        if os.name != "nt":
-            try:
-                import termios
-                import tty
-                self._terminal_fd = sys.stdin.fileno()
-                self._terminal_state = termios.tcgetattr(self._terminal_fd)
-                tty.setcbreak(self._terminal_fd)
-            except (OSError, ValueError):
-                self._restore_terminal()
-                self.enabled = False
-                return
-        self._threads = [
-            threading.Thread(target=self._status_loop, name="zerochat-console-status", daemon=True),
-            threading.Thread(target=self._keyboard_loop, name="zerochat-console-input", daemon=True),
-        ]
-        for thread in self._threads:
-            thread.start()
+        if self.enabled:
+            self._reset_idle_timer()
+        if self._keyboard_enabled:
+            self._keyboard_thread = threading.Thread(target=self._keyboard_loop, name="zerochat-console-input", daemon=True)
+            self._keyboard_thread.start()
 
     def close(self):
-        if self._closed:
-            return
-        self._closed = True
-        self.stop_event.set()
-        for thread in self._threads:
-            if thread is not threading.current_thread():
-                thread.join(timeout=1.0)
-        self._restore_terminal()
-        self.clear_status(final=True)
-
-    def _restore_terminal(self):
-        if self._terminal_fd is None or self._terminal_state is None:
-            return
-        try:
-            import termios
-            termios.tcsetattr(self._terminal_fd, termios.TCSADRAIN, self._terminal_state)
-        except OSError:
-            pass
-        finally:
-            self._terminal_fd = None
-            self._terminal_state = None
-
-    def clear_status(self, *, final: bool = False):
-        if not self.enabled:
-            return
         with self.lock:
-            if self.status_visible:
-                sys.stdout.write("\r\033[2K")
-                self.status_visible = False
-            if final:
-                sys.stdout.write("\r\n")
-            sys.stdout.flush()
+            self._closed = True
+            self._keyboard_stop.set()
+            if self._idle_timer:
+                self._idle_timer.cancel()
+                self._idle_timer = None
 
-    def log(self, message: str, *, flush: bool = True):
+    def _reset_idle_timer(self):
         with self.lock:
-            if self.enabled and self.status_visible:
-                sys.stdout.write("\r\033[2K")
-                self.status_visible = False
-            print(message, flush=flush)
+            if self._closed:
+                return
             self.last_activity = time.monotonic()
+            self._timer_generation += 1
+            if self._idle_timer:
+                self._idle_timer.cancel()
+            generation = self._timer_generation
+            self._idle_timer = threading.Timer(CONSOLE_STATUS_IDLE_SECONDS, self._show_commands_once, args=(generation,))
+            self._idle_timer.daemon = True
+            self._idle_timer.start()
+
+    def _show_commands_once(self, generation: int):
+        with self.lock:
+            if self._closed or generation != self._timer_generation:
+                return
+            commands = "[h] ayuda · [n] Navegador"
+            if get_notices():
+                commands += " · [i] información"
+            print(f"Comandos de consola: {commands} · [x] salir ordenadamente", flush=True)
+            self._idle_timer = None
+
+    def log(self, message: str, *, flush: bool = True):
+        print(message, flush=flush)
+        if self.enabled:
+            self._reset_idle_timer()
 
     def show_help(self):
-        with self.lock:
-            if self.status_visible:
-                sys.stdout.write("\r\033[2K")
-                self.status_visible = False
-            print("\nComandos de consola: [h] ayuda · [n] Navegador · [x] salir ordenadamente\n", flush=True)
-            print(self.parser.format_help().rstrip(), flush=True)
-            self.last_activity = time.monotonic()
+        print(self.parser.format_help().rstrip(), flush=True)
 
-    def _render_status(self):
-        if not self.enabled:
+    def show_notices(self):
+        notices = get_notices()
+        if not notices:
             return
-        uptime = format_uptime(time.monotonic() - self.started_at)
-        with self.lock:
-            if time.monotonic() - self.last_activity < CONSOLE_STATUS_IDLE_SECONDS:
-                return
-            sys.stdout.write(f"\r\033[2KZeroChat activo {uptime} · [h] ayuda · [n] Navegador · [x] salir")
-            sys.stdout.flush()
-            self.status_visible = True
-
-    def _status_loop(self):
-        while not self.stop_event.wait(1.0):
-            self._render_status()
+        print("Información:", flush=True)
+        for notice in notices:
+            print(f"- {notice}", flush=True)
 
-    def _handle_key(self, key: str):
-        if key.lower() == "h":
+    def _handle_command(self, command: str):
+        key = command.strip().lower()
+        if key == "h":
             self.show_help()
-        elif key.lower() == "n":
-            if self.target_url:
-                launch_browser(self.target_url)
-        elif key.lower() == "x":
+        elif key == "n" and self.target_url:
+            launch_browser(self.target_url)
+        elif key == "i":
+            self.show_notices()
+        elif key == "x":
             self.log(f"[{time.strftime('%H:%M:%S')}] Deteniendo servidor ZeroChat...")
             stop_zerochat_server(self.server)
 
     def _keyboard_loop(self):
-        if os.name == "nt":
-            import msvcrt
-            while not self.stop_event.wait(0.05):
-                if msvcrt.kbhit():
-                    self._handle_key(msvcrt.getwch())
-            return
-
-        import select
-        while not self.stop_event.is_set():
-            ready, _, _ = select.select([sys.stdin], [], [], 0.1)
-            if ready:
-                self._handle_key(sys.stdin.read(1))
+        """Lee comandos normales terminados con Intro, sin alterar el terminal."""
+        while not self._keyboard_stop.is_set():
+            line = sys.stdin.readline()
+            if not line:
+                return
+            self._handle_command(line)
 
 
 def console_log(message: str, *, flush: bool = True):
@@ -282,6 +238,26 @@ def get_venv_dir() -> Path:
     return get_data_dir() / ".venv"
 
 
+def reset_notices():
+    """Reinicia los avisos transitorios de la ejecución actual."""
+    with NOTICES_LOCK:
+        NOTICES.clear()
+
+
+def add_notice(message: str):
+    """Añade un aviso para la consola interactiva de la ejecución actual."""
+    if not isinstance(message, str) or not message.strip():
+        raise ValueError("El aviso debe ser texto no vacío")
+    with NOTICES_LOCK:
+        NOTICES.append(message.strip())
+
+
+def get_notices() -> tuple[str, ...]:
+    """Devuelve una instantánea inmutable de los avisos actuales."""
+    with NOTICES_LOCK:
+        return tuple(NOTICES)
+
+
 def get_daily_token() -> str:
     """Devuelve un token de sesión diario persistido en ~/zerochat/config/token.json."""
     config_dir = get_data_dir() / "config"
@@ -310,6 +286,16 @@ SESSION_TOKEN = get_daily_token()
 ACTIVE_PORT = DEFAULT_PORT
 ACTIVE_HOST = DEFAULT_HOST
 
+# Kept only for this Python process: binds an approved browser tool call to
+# the exact JSON-RPC bytes sent to the local host.
+TOOL_AUTH_VERSION = "zerochat-tool-auth-v1"
+TOOL_AUTH_TTL_MS = 30_000
+TOOL_AUTH_MAX_NONCES = 10_000
+TOOL_AUTH_KEY = secrets.token_bytes(32)
+TOOL_AUTH_SESSION_ID = secrets.token_urlsafe(18)
+TOOL_AUTH_NONCES: dict[str, int] = {}
+TOOL_AUTH_NONCES_LOCK = threading.Lock()
+
 DETECTED_OS = "windows" if sys.platform.startswith("win") else ("android" if "ANDROID_ROOT" in os.environ else "linux")
 
 
@@ -381,16 +367,15 @@ def check_version():
         installed = is_installed_runtime()
         remote_ver = _read_remote_version(PYPI_VERSION_URL if installed else REMOTE_VERSION_URL)
         if remote_ver and re.match(r"^\d+(\.\d+)+", remote_ver) and has_new_backend_version(remote_ver):
-            console_log(f"[{time.strftime('%H:%M:%S')}] [zerochat] Nueva versión del servidor disponible (Local: {VERSION}, Remota: {compatibility_version(remote_ver)})", flush=True)
+            notice = f"Nueva versión del servidor disponible (local: {VERSION}, remota: {compatibility_version(remote_ver)})."
             if installed:
-                console_log(f"[{time.strftime('%H:%M:%S')}] [zerochat] Actualiza cuando quieras con: {sys.executable} -m pip install --upgrade --no-cache-dir zerochat", flush=True)
+                notice += f" Actualiza cuando quieras con: {sys.executable} -m pip install --upgrade --no-cache-dir zerochat"
             else:
-                console_log(f"[{time.strftime('%H:%M:%S')}] [zerochat] Actualiza con: curl -sSL {REMOTE_SCRIPT_URL} -o zerochat.py", flush=True)
+                notice += f" Actualiza con: curl -sSL {REMOTE_SCRIPT_URL} -o zerochat.py"
+            add_notice(notice)
     except Exception:
         # Modo offline o timeout ignorado de forma segura
         pass
-
-
 # ==============================================================================
 # Herramientas Locales Core
 # ==============================================================================
@@ -1163,6 +1148,38 @@ try {
 _BROWSER_SESSION = PersistentBrowserSession()
 
 
+def browser_action_availability() -> dict:
+    """Comprueba requisitos locales sin lanzar Node.js ni Chromium."""
+    if not shutil.which("node"):
+        return {"available": False, "error": "Node.js is not installed or not found in system PATH."}
+    playwright_locations = (
+        Path.cwd() / "node_modules" / "playwright",
+        get_data_dir() / "services" / "playwright" / "node_modules" / "playwright"
+    )
+    if not any(location.is_dir() for location in playwright_locations):
+        return {"available": False, "error": "Playwright is not available."}
+    browser_commands = (
+        "google-chrome", "google-chrome-stable", "chromium", "chromium-browser",
+        "msedge", "msedge.exe", "chrome", "chrome.exe"
+    )
+    if sys.platform == "darwin":
+        playwright_cache = Path.home() / "Library" / "Caches" / "ms-playwright"
+    elif sys.platform.startswith("win"):
+        playwright_cache = Path(os.environ.get("LOCALAPPDATA", Path.home() / "AppData" / "Local")) / "ms-playwright"
+    else:
+        playwright_cache = Path.home() / ".cache" / "ms-playwright"
+    try:
+        has_playwright_browser = playwright_cache.is_dir() and any(
+            child.is_dir() and child.name.startswith("chromium")
+            for child in playwright_cache.iterdir()
+        )
+    except OSError:
+        has_playwright_browser = False
+    if has_playwright_browser or any(shutil.which(command) for command in browser_commands):
+        return {"available": True}
+    return {"available": False, "error": "Playwright Chromium is not installed."}
+
+
 def browser_action(action: str, url: str | None = None, selector: str | None = None, value: str | None = None) -> str:
     """Control a headless browser for UI testing and visual inspection."""
     try:
@@ -1321,7 +1338,6 @@ LOCAL_TOOL_HANDLERS = {
     "get_diagnostics": get_diagnostics,
     "browser_action": browser_action
 }
-
 # ==============================================================================
 # Servidor HTTP JSON-RPC 2.0 y SSE con Autenticación por Token
 # ==============================================================================
@@ -2202,7 +2218,7 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
             return
         self.send_header("Access-Control-Allow-Origin", origin if origin else "*")
         self.send_header("Access-Control-Allow-Methods", "POST, GET, OPTIONS")
-        self.send_header("Access-Control-Allow-Headers", "Content-Type, Accept, Authorization, X-ZeroChat-Token, X-ZeroChat-Client")
+        self.send_header("Access-Control-Allow-Headers", "Content-Type, Accept, Authorization, X-ZeroChat-Token, X-ZeroChat-Client, X-ZeroChat-Tool-Session, X-ZeroChat-Tool-Expires, X-ZeroChat-Tool-Nonce, X-ZeroChat-Tool-Signature")
         self.send_header("Access-Control-Allow-Private-Network", "true")
 
     def verify_token(self) -> bool:
@@ -2221,6 +2237,42 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
             mark_browser_active()
         return is_valid
 
+    def verify_tool_authorization(self, body: bytes, request_path: str) -> str | None:
+        """Validate and atomically consume an authorization for one tool call."""
+        session_id = self.headers.get("X-ZeroChat-Tool-Session", "")
+        expires_raw = self.headers.get("X-ZeroChat-Tool-Expires", "")
+        nonce = self.headers.get("X-ZeroChat-Tool-Nonce", "")
+        signature = self.headers.get("X-ZeroChat-Tool-Signature", "")
+        if (not isinstance(session_id, str) or len(session_id) > 128 or
+                not isinstance(nonce, str) or not re.fullmatch(r"[A-Za-z0-9_-]{22,128}", nonce) or
+                not isinstance(signature, str) or not re.fullmatch(r"[A-Za-z0-9_-]{43,128}", signature)):
+            return "Missing or invalid tool authorization"
+        try:
+            expires_at = int(expires_raw)
+        except (TypeError, ValueError):
+            return "Missing or invalid tool authorization"
+        now_ms = int(time.time() * 1000)
+        if session_id != TOOL_AUTH_SESSION_ID or expires_at < now_ms or expires_at > now_ms + TOOL_AUTH_TTL_MS:
+            return "Expired or invalid tool authorization"
+        body_hash = hashlib.sha256(body).hexdigest()
+        signature_base = json.dumps(
+            [TOOL_AUTH_VERSION, session_id, "POST", request_path or "/", expires_at, nonce, body_hash],
+            separators=(",", ":"), ensure_ascii=True
+        ).encode("utf-8")
+        expected = base64.urlsafe_b64encode(hmac.new(TOOL_AUTH_KEY, signature_base, hashlib.sha256).digest()).rstrip(b"=").decode("ascii")
+        if not hmac.compare_digest(signature, expected):
+            return "Invalid tool authorization signature"
+        with TOOL_AUTH_NONCES_LOCK:
+            for value, expiry in list(TOOL_AUTH_NONCES.items()):
+                if expiry < now_ms:
+                    del TOOL_AUTH_NONCES[value]
+            if nonce in TOOL_AUTH_NONCES:
+                return "Tool authorization was already used"
+            if len(TOOL_AUTH_NONCES) >= TOOL_AUTH_MAX_NONCES:
+                return "Tool authorization cache is full"
+            TOOL_AUTH_NONCES[nonce] = expires_at
+        return None
+
     def do_OPTIONS(self):
         t0 = time.monotonic()
         safe_path = sanitize_log_path(self.path)
@@ -2270,6 +2322,13 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
             self._log_res(200, safe_path, (time.monotonic() - t0) * 1000)
             return
 
+        # Browsers request this optional public resource without API credentials.
+        if path_clean == "/favicon.ico":
+            self.send_response(204)
+            self.send_header("Content-Length", "0")
+            self.end_headers()
+            return
+
         if not is_heartbeat:
             self._log_req("GET", safe_path)
 
@@ -2303,12 +2362,13 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
             self._log_res(200, f"{safe_path} [SSE canal activo]", (time.monotonic() - t0) * 1000)
             return
 
-        # Status general
         res_data = json.dumps({
             "status": "active",
             "server": "ZeroChat Local Server",
             "version": VERSION,
+            "cwd": str(Path.cwd().resolve()),
             "tools_count": len(LOCAL_TOOLS_DEFINITIONS),
+            "browser_action": browser_action_availability(),
             "os": DETECTED_OS
         }, ensure_ascii=False, indent=2).encode("utf-8")
 
@@ -2431,6 +2491,11 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
                 self._send_json_response(400, {"error": tool_args_error})
                 self._log_res(400, safe_path, (time.monotonic() - t0) * 1000, tool_args_error)
                 return
+            auth_error = self.verify_tool_authorization(post_data, self.path.split("?", 1)[0].rstrip("/") or "/")
+            if auth_error:
+                self._send_json_response(403, {"error": auth_error})
+                self._log_res(403, safe_path, (time.monotonic() - t0) * 1000, auth_error)
+                return
 
         req_path = self.path.split("?", 1)[0].rstrip("/")
 
@@ -2469,6 +2534,12 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
                     },
                     "capabilities": {
                         "tools": {"listChanged": True}
+                    },
+                    "toolAuthorization": {
+                        "version": TOOL_AUTH_VERSION,
+                        "sessionId": TOOL_AUTH_SESSION_ID,
+                        "key": base64.urlsafe_b64encode(TOOL_AUTH_KEY).rstrip(b"=").decode("ascii"),
+                        "ttlMs": TOOL_AUTH_TTL_MS
                     }
                 }
             elif method == "tools/list":
@@ -2498,14 +2569,34 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
                     "protocolVersion": "2024-11-05",
                     "serverInfo": {
                         "name": "ZeroChat Local Server",
-                        "version": VERSION
+                        "version": VERSION,
+                        "cwd": str(Path.cwd().resolve())
                     },
                     "capabilities": {
                         "tools": {"listChanged": True}
+                    },
+                    "toolAuthorization": {
+                        "version": TOOL_AUTH_VERSION,
+                        "sessionId": TOOL_AUTH_SESSION_ID,
+                        "key": base64.urlsafe_b64encode(TOOL_AUTH_KEY).rstrip(b"=").decode("ascii"),
+                        "ttlMs": TOOL_AUTH_TTL_MS
                     }
                 }
             elif method == "tools/list":
-                result = {"tools": list(LOCAL_TOOLS_DEFINITIONS)}
+                browser_availability = browser_action_availability()
+                tools = []
+                for definition in LOCAL_TOOLS_DEFINITIONS:
+                    item = dict(definition)
+                    if item.get("name") == "browser_action":
+                        item["availability"] = browser_availability
+                    tools.append(item)
+                result = {"tools": tools}
+            elif method == "tools/availability":
+                requested_name = params.get("name", "") if isinstance(params, dict) else ""
+                if requested_name != "browser_action":
+                    error = {"code": -32602, "message": "Herramienta no compatible con comprobación de disponibilidad."}
+                else:
+                    result = browser_action_availability()
             elif method == "tools/call":
                 tool_name = params.get("name", "") if isinstance(params, dict) else ""
                 tool_args = params.get("arguments", {}) if isinstance(params, dict) else {}
@@ -2595,7 +2686,6 @@ class ZeroChatServerHandler(BaseHTTPRequestHandler):
     def log_message(self, format, *args):
         # Silenciar logs ruidosos por defecto
         pass
-
 def is_termux_environment() -> bool:
     """Devuelve si el proceso se ejecuta dentro de la instalación de Termux."""
     termux_prefix = "/data/data/com.termux/files/usr"
@@ -2752,6 +2842,7 @@ def launch_browser(url: str) -> bool:
 
 def main():
     global ACTIVE_PORT, ACTIVE_HOST, SESSION_TOKEN, CONSOLE_CONTROL
+    global TOOL_AUTH_KEY, TOOL_AUTH_SESSION_ID, TOOL_AUTH_NONCES
 
     parser = argparse.ArgumentParser(description=f"ZeroChat Local Server v{VERSION}")
     parser.add_argument("--port", type=int, default=int(os.environ.get("ZEROCHAT_PORT", DEFAULT_PORT)), help=f"Puerto de escucha (default: {DEFAULT_PORT})")
@@ -2765,6 +2856,9 @@ def main():
     parser.add_argument("--version", action="version", version=f"ZeroChat {VERSION}")
     args = parser.parse_args()
 
+    # Los avisos no persisten entre ejecuciones del servidor.
+    reset_notices()
+
     if args.test:
         print(f"[{time.strftime('%H:%M:%S')}] TEST list_directory {'ok' if json.loads(list_directory('.'))['success'] else 'error'}")
         print(f"[{time.strftime('%H:%M:%S')}] TEST read_file {'ok' if json.loads(read_file('package.json', max_lines=5))['success'] else 'error'}")
@@ -2776,6 +2870,14 @@ def main():
     if not args.no_venv:
         ensure_virtual_environment()
 
+    browser_availability = browser_action_availability()
+    if not browser_availability.get("available"):
+        add_notice(
+            "browser_action no está disponible y permanecerá desactivada. "
+            "Instala Node.js, Playwright y Chromium: "
+            "https://albalday.github.io/zerochat/help/browser-action.html"
+        )
+
     # 2. Detectar entorno de desarrollo y resolver URL de destino
     dev_root = get_dev_root()
     static_root = get_static_root()
@@ -2792,6 +2894,11 @@ def main():
         SESSION_TOKEN = args.token
     else:
         SESSION_TOKEN = get_daily_token()
+    # A restart deliberately invalidates every browser-side signing credential.
+    TOOL_AUTH_KEY = secrets.token_bytes(32)
+    TOOL_AUTH_SESSION_ID = secrets.token_urlsafe(18)
+    with TOOL_AUTH_NONCES_LOCK:
+        TOOL_AUTH_NONCES = {}
 
     server = ThreadingHTTPServer((ACTIVE_HOST, ACTIVE_PORT), ZeroChatServerHandler)
 

zerochat-7.11.0/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: zerochat
-Version: 7.11.0
-Summary: Private local web client for AI models, tools and MCP services
-Author: Alberto Alday
-License-Expression: MIT
-Project-URL: Homepage, https://albalday.github.io/zerochat/
-Project-URL: Repository, https://github.com/albalday/zerochat
-Project-URL: Issues, https://github.com/albalday/zerochat/issues
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# ZeroChat
-
-ZeroChat es un cliente web universal para interactuar con modelos de inteligencia artificial y agentes de forma privada, rápida y sin intermediarios.
-
-Funciona de forma estática en el navegador (servido por GitHub Pages o directamente desde local en un único archivo HTML), almacenando tus conversaciones, configuraciones y datos de forma segura en tu propio dispositivo (IndexedDB).
-
-## Características principales
-
-- **Multi-proveedor y modelos locales**: compatible con APIs estándar (OpenAI, Anthropic Claude, Google Gemini, OpenRouter) y motores locales (Ollama, LM Studio, vLLM, WebLLM con WebGPU directo en el navegador).
-- **Herramientas y MCP (Model Context Protocol)**: soporte para agentes, herramientas de búsqueda/cálculo y servidores MCP locales coordinados mediante `zerochat.py`.
-- **Conocimiento local (RAG)**: carga de documentos y recuperación contextual procesada íntegramente en el navegador.
-- **Privacidad absoluta**: tus claves API y datos viajan directamente de tu navegador al proveedor seleccionado, sin servidores puente de terceros.
-- **Sin necesidad de empaquetado**: distribuible de forma universal y ligera.
-
-## Inicio rápido
-
-- **Uso web directo**: abre [zerochat.html en GitHub Pages](https://albalday.github.io/zerochat/zerochat.html).
-- **Servidor local con herramientas MCP**:
-  ```bash
-  python3 zerochat.py
-  ```
-  Inicia el asistente local, crea `~/zerochat/.venv` para los MCP y abre la interfaz web en tu navegador.
-- **Instalación con PyPI**:
-  ```bash
-  pip install zerochat
-  zerochat
-  ```
-  Es la vía recomendada para instalar el servidor local desde PyPI. Igual que con la descarga directa, crea `~/zerochat/` para el estado y los MCP; la interfaz se carga desde GitHub Pages.
-
-En ambos modos, `~/zerochat/` contiene configuración, token, servicios MCP y sus dependencias Python en `.venv/`. Borrar ese directorio elimina el estado local y los MCP, sin desinstalar el ejecutable de PyPI ni el archivo descargado.
-
-Las publicaciones se realizan desde el repositorio oficial mediante GitHub Actions y PyPI Trusted Publishing.
-
-## Documentación y Ayuda
-
-Para consultar guías paso a paso, configuración de modelos, perfiles y agentes:
-
-- 📖 **[Centro de Ayuda de ZeroChat (Español)](https://albalday.github.io/zerochat/help/index.html)**
-- 📖 **[ZeroChat Documentation & Help (English)](https://albalday.github.io/zerochat/help/en/index.html)**
-
-## Desarrollo
-
-Para ejecutar las pruebas del proyecto:
-
-```bash
-npm install
-npm test
-```
-
-Consulta [`AGENTS.md`](./AGENTS.md) para conocer las normas de desarrollo y arquitectura, y [`tests/README.md`](./tests/README.md) para la suite de pruebas.

zerochat-7.11.0/README.md

@@ -1,50 +0,0 @@
-# ZeroChat
-
-ZeroChat es un cliente web universal para interactuar con modelos de inteligencia artificial y agentes de forma privada, rápida y sin intermediarios.
-
-Funciona de forma estática en el navegador (servido por GitHub Pages o directamente desde local en un único archivo HTML), almacenando tus conversaciones, configuraciones y datos de forma segura en tu propio dispositivo (IndexedDB).
-
-## Características principales
-
-- **Multi-proveedor y modelos locales**: compatible con APIs estándar (OpenAI, Anthropic Claude, Google Gemini, OpenRouter) y motores locales (Ollama, LM Studio, vLLM, WebLLM con WebGPU directo en el navegador).
-- **Herramientas y MCP (Model Context Protocol)**: soporte para agentes, herramientas de búsqueda/cálculo y servidores MCP locales coordinados mediante `zerochat.py`.
-- **Conocimiento local (RAG)**: carga de documentos y recuperación contextual procesada íntegramente en el navegador.
-- **Privacidad absoluta**: tus claves API y datos viajan directamente de tu navegador al proveedor seleccionado, sin servidores puente de terceros.
-- **Sin necesidad de empaquetado**: distribuible de forma universal y ligera.
-
-## Inicio rápido
-
-- **Uso web directo**: abre [zerochat.html en GitHub Pages](https://albalday.github.io/zerochat/zerochat.html).
-- **Servidor local con herramientas MCP**:
-  ```bash
-  python3 zerochat.py
-  ```
-  Inicia el asistente local, crea `~/zerochat/.venv` para los MCP y abre la interfaz web en tu navegador.
-- **Instalación con PyPI**:
-  ```bash
-  pip install zerochat
-  zerochat
-  ```
-  Es la vía recomendada para instalar el servidor local desde PyPI. Igual que con la descarga directa, crea `~/zerochat/` para el estado y los MCP; la interfaz se carga desde GitHub Pages.
-
-En ambos modos, `~/zerochat/` contiene configuración, token, servicios MCP y sus dependencias Python en `.venv/`. Borrar ese directorio elimina el estado local y los MCP, sin desinstalar el ejecutable de PyPI ni el archivo descargado.
-
-Las publicaciones se realizan desde el repositorio oficial mediante GitHub Actions y PyPI Trusted Publishing.
-
-## Documentación y Ayuda
-
-Para consultar guías paso a paso, configuración de modelos, perfiles y agentes:
-
-- 📖 **[Centro de Ayuda de ZeroChat (Español)](https://albalday.github.io/zerochat/help/index.html)**
-- 📖 **[ZeroChat Documentation & Help (English)](https://albalday.github.io/zerochat/help/en/index.html)**
-
-## Desarrollo
-
-Para ejecutar las pruebas del proyecto:
-
-```bash
-npm install
-npm test
-```
-
-Consulta [`AGENTS.md`](./AGENTS.md) para conocer las normas de desarrollo y arquitectura, y [`tests/README.md`](./tests/README.md) para la suite de pruebas.

zerochat-7.11.0/zerochat.egg-info/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: zerochat
-Version: 7.11.0
-Summary: Private local web client for AI models, tools and MCP services
-Author: Alberto Alday
-License-Expression: MIT
-Project-URL: Homepage, https://albalday.github.io/zerochat/
-Project-URL: Repository, https://github.com/albalday/zerochat
-Project-URL: Issues, https://github.com/albalday/zerochat/issues
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Web Environment
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Dynamic: license-file
-
-# ZeroChat
-
-ZeroChat es un cliente web universal para interactuar con modelos de inteligencia artificial y agentes de forma privada, rápida y sin intermediarios.
-
-Funciona de forma estática en el navegador (servido por GitHub Pages o directamente desde local en un único archivo HTML), almacenando tus conversaciones, configuraciones y datos de forma segura en tu propio dispositivo (IndexedDB).
-
-## Características principales
-
-- **Multi-proveedor y modelos locales**: compatible con APIs estándar (OpenAI, Anthropic Claude, Google Gemini, OpenRouter) y motores locales (Ollama, LM Studio, vLLM, WebLLM con WebGPU directo en el navegador).
-- **Herramientas y MCP (Model Context Protocol)**: soporte para agentes, herramientas de búsqueda/cálculo y servidores MCP locales coordinados mediante `zerochat.py`.
-- **Conocimiento local (RAG)**: carga de documentos y recuperación contextual procesada íntegramente en el navegador.
-- **Privacidad absoluta**: tus claves API y datos viajan directamente de tu navegador al proveedor seleccionado, sin servidores puente de terceros.
-- **Sin necesidad de empaquetado**: distribuible de forma universal y ligera.
-
-## Inicio rápido
-
-- **Uso web directo**: abre [zerochat.html en GitHub Pages](https://albalday.github.io/zerochat/zerochat.html).
-- **Servidor local con herramientas MCP**:
-  ```bash
-  python3 zerochat.py
-  ```
-  Inicia el asistente local, crea `~/zerochat/.venv` para los MCP y abre la interfaz web en tu navegador.
-- **Instalación con PyPI**:
-  ```bash
-  pip install zerochat
-  zerochat
-  ```
-  Es la vía recomendada para instalar el servidor local desde PyPI. Igual que con la descarga directa, crea `~/zerochat/` para el estado y los MCP; la interfaz se carga desde GitHub Pages.
-
-En ambos modos, `~/zerochat/` contiene configuración, token, servicios MCP y sus dependencias Python en `.venv/`. Borrar ese directorio elimina el estado local y los MCP, sin desinstalar el ejecutable de PyPI ni el archivo descargado.
-
-Las publicaciones se realizan desde el repositorio oficial mediante GitHub Actions y PyPI Trusted Publishing.
-
-## Documentación y Ayuda
-
-Para consultar guías paso a paso, configuración de modelos, perfiles y agentes:
-
-- 📖 **[Centro de Ayuda de ZeroChat (Español)](https://albalday.github.io/zerochat/help/index.html)**
-- 📖 **[ZeroChat Documentation & Help (English)](https://albalday.github.io/zerochat/help/en/index.html)**
-
-## Desarrollo
-
-Para ejecutar las pruebas del proyecto:
-
-```bash
-npm install
-npm test
-```
-
-Consulta [`AGENTS.md`](./AGENTS.md) para conocer las normas de desarrollo y arquitectura, y [`tests/README.md`](./tests/README.md) para la suite de pruebas.