zerochat 7.12.0__tar.gz → 8.1.0__tar.gz

zerochat-8.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: zerochat
+Version: 8.1.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.1.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.12.0 → zerochat-8.1.0}/pyproject.toml

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

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

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: zerochat
+Version: 8.1.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.12.0 → zerochat-8.1.0}/zerochat.py

@@ -42,7 +42,7 @@ import webbrowser
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 
-SOURCE_BACKEND_VERSION = "7.12.0"
+SOURCE_BACKEND_VERSION = "8.1.0"
 
 def _read_source_version(filename: str) -> str | None:
     """Lee la versión de un archivo del repositorio cuando se ejecuta desde fuentes."""
@@ -100,164 +100,95 @@ CONSOLE_STATUS_IDLE_SECONDS = 8.0
 CONSOLE_CONTROL = None
 NOTICES: list[str] = []
 NOTICES_LOCK = threading.Lock()
-
-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}"
-
-
 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()
-
-    def show_help(self):
+            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.status_visible:
-                sys.stdout.write("\r\033[2K")
-                self.status_visible = False
+            if self._closed or generation != self._timer_generation:
+                return
             commands = "[h] ayuda · [n] Navegador"
             if get_notices():
                 commands += " · [i] información"
-            print(f"\nComandos de consola: {commands} · [x] salir ordenadamente\n", flush=True)
-            print(self.parser.format_help().rstrip(), flush=True)
-            self.last_activity = time.monotonic()
+            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):
+        print(self.parser.format_help().rstrip(), flush=True)
 
     def show_notices(self):
         notices = get_notices()
         if not notices:
             return
-        with self.lock:
-            if self.status_visible:
-                sys.stdout.write("\r\033[2K")
-                self.status_visible = False
-            print("\nInformación:", flush=True)
-            for notice in notices:
-                print(f"- {notice}", flush=True)
-            print(flush=True)
-            self.last_activity = time.monotonic()
-
-    def _render_status(self):
-        if not self.enabled:
-            return
-        uptime = format_uptime(time.monotonic() - self.started_at)
-        with self.lock:
-            if time.monotonic() - self.last_activity < CONSOLE_STATUS_IDLE_SECONDS:
-                return
-            commands = "[h] ayuda · [n] Navegador"
-            if get_notices():
-                commands += " · [i] información"
-            sys.stdout.write(f"\r\033[2KZeroChat activo {uptime} · {commands} · [x] salir")
-            sys.stdout.flush()
-            self.status_visible = True
+        print("Información:", flush=True)
+        for notice in notices:
+            print(f"- {notice}", flush=True)
 
-    def _status_loop(self):
-        while not self.stop_event.wait(1.0):
-            self._render_status()
-
-    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() == "i":
+        elif key == "n" and self.target_url:
+            launch_browser(self.target_url)
+        elif key == "i":
             self.show_notices()
-        elif key.lower() == "x":
+        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):
@@ -1825,7 +1756,8 @@ for raw in sys.stdin:
                 "product": {
                     "package": "@playwright/mcp",
                     "version": "0.0.81",
-                    "browser": "chromium"
+                    "browser": "chromium",
+                    "nodeMajor": 18
                 }
             }, indent=2), encoding="utf-8")
 
@@ -1864,7 +1796,8 @@ for raw in sys.stdin:
                 "type": "npm",
                 "product": {
                     "package": "@modelcontextprotocol/server-memory",
-                    "version": "2026.8.31"
+                    "version": "2026.8.31",
+                    "nodeMajor": 18
                 }
             }, indent=2), encoding="utf-8")
 
@@ -1901,7 +1834,8 @@ for raw in sys.stdin:
                 "type": "npm",
                 "product": {
                     "package": "@axivo/mcp-lsp",
-                    "version": "1.0.5"
+                    "version": "1.0.5",
+                    "nodeMajor": 24
                 }
             }, indent=2), encoding="utf-8")
 
@@ -1986,9 +1920,25 @@ for raw in sys.stdin:
                 if not package or not version:
                     raise RuntimeError("El instalador npm debe definir package y version")
                 if not shutil.which("node") or not shutil.which("npm"):
-                    raise RuntimeError("Node.js 18+ y npm son necesarios para instalar este servicio MCP")
+                    raise RuntimeError("Node.js y npm son necesarios para instalar este servicio MCP")
+
+                required_node_major = int(product.get(
+                    "nodeMajor",
+                    24 if package == "@axivo/mcp-lsp" else 18
+                ))
+                version_result = subprocess.run(
+                    [node, "--version"], capture_output=True, text=True, timeout=5
+                )
+                version_match = re.match(r"v(\\d+)", version_result.stdout.strip())
+                if version_result.returncode != 0 or not version_match:
+                    raise RuntimeError("No se pudo comprobar la versión de Node.js necesaria para este servicio MCP")
+                if int(version_match.group(1)) < required_node_major:
+                    raise RuntimeError(
+                        f"{server_id} requiere Node.js {required_node_major}+; se detectó {version_result.stdout.strip()}"
+                    )
 
-                needs_install = not marker.exists()
+                package_dir = service_dir / "node_modules" / Path(*package.split("/"))
+                needs_install = not marker.exists() or not package_dir.is_dir()
                 if not needs_install:
                     try:
                         installation = json.loads(marker.read_text(encoding="utf-8"))
@@ -2008,9 +1958,18 @@ for raw in sys.stdin:
                     browser = product.get("browser")
                     if browser:
                         playwright_cli = service_dir / "node_modules" / "playwright" / "cli.js"
-                        if playwright_cli.is_file():
-                            subprocess.run([node, str(playwright_cli), "install", browser], cwd=service_dir, capture_output=True, text=True, timeout=600)
-                            installation["browser"] = browser
+                        if not playwright_cli.is_file():
+                            raise RuntimeError("No se encontró Playwright después de instalar el servicio MCP")
+                        browser_result = subprocess.run(
+                            [node, str(playwright_cli), "install", browser], cwd=service_dir,
+                            capture_output=True, text=True, timeout=600
+                        )
+                        if browser_result.returncode != 0:
+                            raise RuntimeError(
+                                f"Fallo instalando el navegador {browser} de Playwright: "
+                                f"{browser_result.stderr or browser_result.stdout}"
+                            )
+                        installation["browser"] = browser
                     marker.write_text(json.dumps(installation, indent=2), encoding="utf-8")
 
         return {
@@ -2133,7 +2092,6 @@ for raw in sys.stdin:
 
 
 GLOBAL_MCP_MANAGER = McpServiceManager()
-
 DEFAULT_HEARTBEAT_TIMEOUT = float(os.environ.get("ZEROCHAT_HEARTBEAT_TIMEOUT", "60.0"))
 DEFAULT_HEARTBEAT_GRACE = float(os.environ.get("ZEROCHAT_HEARTBEAT_GRACE", "45.0"))
 DEFAULT_HEARTBEAT_POLL = float(os.environ.get("ZEROCHAT_HEARTBEAT_POLL", "5.0"))

zerochat-7.12.0/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: zerochat
-Version: 7.12.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.12.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.12.0/zerochat.egg-info/PKG-INFO

@@ -1,72 +0,0 @@
-Metadata-Version: 2.4
-Name: zerochat
-Version: 7.12.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.