zerochat 8.2.0__tar.gz → 8.3.0__tar.gz

{zerochat-8.2.0/zerochat.egg-info → zerochat-8.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zerochat
-Version: 8.2.0
+Version: 8.3.0
 Summary: Private local web client for AI models, tools and MCP services
 Author: Alberto Alday
 License-Expression: MIT

{zerochat-8.2.0 → zerochat-8.3.0}/pyproject.toml

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

{zerochat-8.2.0 → zerochat-8.3.0/zerochat.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: zerochat
-Version: 8.2.0
+Version: 8.3.0
 Summary: Private local web client for AI models, tools and MCP services
 Author: Alberto Alday
 License-Expression: MIT

{zerochat-8.2.0 → zerochat-8.3.0}/zerochat.py

@@ -42,7 +42,7 @@ import webbrowser
 from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
 from pathlib import Path
 
-SOURCE_BACKEND_VERSION = "8.2.0"
+SOURCE_BACKEND_VERSION = "8.3.0"
 
 def _read_source_version(filename: str) -> str | None:
     """Lee la versión de un archivo del repositorio cuando se ejecuta desde fuentes."""
@@ -93,9 +93,11 @@ UI_VERSION = _read_ui_version()
 DEFAULT_PORT = 6388
 DEFAULT_HOST = "127.0.0.1"
 DEFAULT_UI_URL = "https://albalday.github.io/zerochat/zerochat.html"
-REMOTE_VERSION_URL = "https://raw.githubusercontent.com/albalday/zerochat/master/package.json"
-PYPI_VERSION_URL = "https://pypi.org/pypi/zerochat/json"
 REMOTE_SCRIPT_URL = "https://raw.githubusercontent.com/albalday/zerochat/master/zerochat.py"
+# Las versiones remotas se consultan en las dos distribuciones que consume el
+# usuario: la interfaz publicada en GitHub Pages y el ejecutable en GitHub.
+REMOTE_UI_VERSION_URL = DEFAULT_UI_URL
+REMOTE_BACKEND_VERSION_URL = REMOTE_SCRIPT_URL
 CONSOLE_STATUS_IDLE_SECONDS = 8.0
 CONSOLE_CONTROL = None
 NOTICES: list[str] = []
@@ -335,22 +337,24 @@ def parse_version(ver: str) -> tuple[int, ...]:
     return tuple(parts)
 
 
-def _read_remote_version(url: str) -> str | None:
-    """Obtiene una versión publicada desde package.json o la API JSON de PyPI."""
+def _read_remote_content(url: str) -> str:
+    """Lee una cabecera acotada de un recurso publicado de ZeroChat."""
     req = urllib.request.Request(url, headers={"User-Agent": f"ZeroChat/{VERSION}"})
     with urllib.request.urlopen(req, timeout=3) as resp:
-        content = resp.read(4096).decode("utf-8", errors="ignore")
-    try:
-        data = json.loads(content)
-        if isinstance(data, dict):
-            candidate = data.get("version")
-            if not isinstance(candidate, str) and isinstance(data.get("info"), dict):
-                candidate = data["info"].get("version")
-            if isinstance(candidate, str):
-                return candidate.strip()
-    except (json.JSONDecodeError, TypeError):
-        pass
-    match = re.search(r'["\']?version["\']?\s*[:=]\s*["\'](\d+\.\d+\.\d+)["\']', content)
+        return resp.read(4096).decode("utf-8", errors="ignore")
+
+
+def _read_remote_ui_version() -> str | None:
+    """Extrae la versión del título de la interfaz servida por GitHub Pages."""
+    content = _read_remote_content(REMOTE_UI_VERSION_URL)
+    match = re.search(r"<title>\s*ZeroChat\s+v(\d+\.\d+\.\d+)\s*</title>", content, re.IGNORECASE)
+    return match.group(1) if match else None
+
+
+def _read_remote_backend_version() -> str | None:
+    """Extrae la versión estática del ejecutable publicado en GitHub."""
+    content = _read_remote_content(REMOTE_BACKEND_VERSION_URL)
+    match = re.search(r'^SOURCE_BACKEND_VERSION\s*=\s*["\'](\d+\.\d+\.\d+)["\']', content, re.MULTILINE)
     return match.group(1) if match else None
 
 
@@ -360,14 +364,21 @@ def has_new_backend_version(remote_version: str, local_version: str = VERSION) -
 
 
 def check_version():
-    """Informa de actualizaciones del backend, sin avisar por parches web."""
+    """Informa de la versión de Pages y de actualizaciones del ejecutable."""
     if get_dev_root() is not None:
         return
     try:
         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):
-            notice = f"Nueva versión del servidor disponible (local: {VERSION}, remota: {compatibility_version(remote_ver)})."
+        remote_ui_version = _read_remote_ui_version()
+        if remote_ui_version:
+            notice = f"Interfaz web en GitHub Pages: v{remote_ui_version}."
+            if remote_ui_version != UI_VERSION:
+                notice += f" El ejecutable incluye la referencia v{UI_VERSION}; la interfaz remota se cargará al abrir el navegador."
+            add_notice(notice)
+
+        remote_backend_version = _read_remote_backend_version()
+        if remote_backend_version and has_new_backend_version(remote_backend_version):
+            notice = f"Nueva versión del servidor disponible (local: {VERSION}, remota: {compatibility_version(remote_backend_version)})."
             if installed:
                 notice += f" Actualiza cuando quieras con: {sys.executable} -m pip install --upgrade --no-cache-dir zerochat"
             else:
@@ -1635,11 +1646,7 @@ class McpServiceManager:
         if services_root:
             self.services_root = Path(services_root)
         else:
-            candidates = [
-                Path.cwd() / "services",
-                get_data_dir() / "services"
-            ]
-            self.services_root = candidates[0] if get_dev_root() is not None and candidates[0].is_dir() else candidates[1]
+            self.services_root = get_data_dir() / "services"
         self.services_root.mkdir(parents=True, exist_ok=True)
         self.config_file = get_data_dir() / "config" / "services.json"
         self.config_file.parent.mkdir(parents=True, exist_ok=True)
@@ -1656,36 +1663,45 @@ class McpServiceManager:
         console_log(f"[{time.strftime('%H:%M:%S')}] [MCP {server_id}] {_mcp_trace_text(message)}", flush=True)
 
     def _ensure_default_services(self):
-        dummy_dir = self.services_root / "dummy_mcp"
-        dummy_dir.mkdir(parents=True, exist_ok=True)
-        service_json_file = dummy_dir / "service.json"
-        dummy_server_file = dummy_dir / "dummy_mcp_server.py"
+        example_dir = self.services_root / "ejemplo"
+        example_dir.mkdir(parents=True, exist_ok=True)
+        service_json_file = example_dir / "service.json"
+        example_server_file = example_dir / "ejemplo_mcp_server.py"
+        example_readme_file = example_dir / "README.md"
+        installer_example_file = example_dir / "installer.json.example"
 
         if not service_json_file.exists():
             service_json_file.write_text(json.dumps({
                 "schemaVersion": 1,
-                "id": "dummy_mcp",
+                "id": "ejemplo",
                 "displayName": {
-                    "es": "MCP de prueba",
-                    "en": "Test MCP"
+                    "es": "Ejemplo de MCP",
+                    "en": "MCP example"
                 },
                 "description": {
-                    "es": "Servicio MCP mínimo para comprobar la infraestructura externa.",
-                    "en": "Minimal MCP service for verifying the external infrastructure."
+                    "es": "Plantilla mínima para crear servicios MCP gestionados por ZeroChat. Muestra el protocolo stdio y la estructura de configuración que debe seguir un nuevo MCP.",
+                    "en": "Minimal template for creating ZeroChat-managed MCP services. It demonstrates the stdio protocol and configuration structure for a new MCP."
+                },
+                "help": {
+                    "url": "help/mcp.html#crear-mcp-con-agente",
+                    "label": {
+                        "es": "Guía para crear un MCP gestionado",
+                        "en": "Guide to creating a managed MCP"
+                    }
                 },
                 "enabledByDefault": False,
                 "transport": "stdio",
                 "launch": {
                     "executable": "${pythonExecutable}",
-                    "args": ["${serviceDir}/dummy_mcp_server.py"],
+                    "args": ["${serviceDir}/ejemplo_mcp_server.py"],
                     "cwd": "${serviceDir}",
                     "env": {},
                     "handshakeTimeoutSeconds": 10
                 }
             }, indent=2), encoding="utf-8")
 
-        if not dummy_server_file.exists():
-            dummy_server_file.write_text('''#!/usr/bin/env python3
+        if not example_server_file.exists():
+            example_server_file.write_text('''#!/usr/bin/env python3
 import json, sys
 
 def reply(req_id, result=None, error=None):
@@ -1702,7 +1718,7 @@ for raw in sys.stdin:
     if method == "initialize":
         reply(req_id, {
             "protocolVersion": "2024-11-05",
-            "serverInfo": {"name": "ZeroChat Dummy MCP", "version": "1.0.0"},
+            "serverInfo": {"name": "ZeroChat MCP Example", "version": "1.0.0"},
             "capabilities": {"tools": {}}
         })
     elif method == "tools/list":
@@ -1726,6 +1742,66 @@ for raw in sys.stdin:
         })
 ''', encoding="utf-8")
 
+        if not installer_example_file.exists():
+            installer_example_file.write_text(json.dumps({
+                "schemaVersion": 1,
+                "type": "npm",
+                "product": {
+                    "package": "@scope/mcp-package",
+                    "version": "1.2.3"
+                },
+                "requirements": {
+                    "node": {"minimumMajor": 18}
+                }
+            }, indent=2) + "\n", encoding="utf-8")
+
+        if not example_readme_file.exists():
+            example_readme_file.write_text('''# Ejemplo de MCP gestionado\n\nEsta carpeta es la plantilla para que un agente cree un servicio MCP gestionado por ZeroChat. Para crear uno nuevo, copie esta estructura en `~/zerochat/services/<id-seguro>/`; no modifique este ejemplo.\n\n## Archivos\n\n- `service.json` es obligatorio. Define el identificador, los textos visibles, el proceso y el campo estándar opcional `help`.\n- `installer.json` es opcional. Créelo a partir de `installer.json.example` solo si ZeroChat debe instalar un paquete npm. Fije siempre una versión exacta.\n- El ejecutable o script de arranque se declara en `launch`. Use `${serviceDir}`, `${pythonExecutable}` o `${nodeExecutable}` en lugar de rutas de usuario.\n\n## Campo de ayuda\n\nTodos los servicios pueden incluir:\n\n```json\n"help": {\n  "url": "help/mcp.html",\n  "label": { "es": "Texto en español", "en": "English text" }\n}\n```\n\nLa interfaz muestra ese enlace en la tarjeta del servicio. `url` debe ser una ruta relativa de ZeroChat o una URL `https:` o `http:`.\n\n## Instrucción para un agente\n\nCopia este texto y sustituye solo `<nombre-del-mcp>`:\n\n```text\nSiguiendo estrictamente la estructura de ~/zerochat/services/ejemplo, busca en Internet la documentación oficial de instalación del MCP <nombre-del-mcp> y crea en ~/zerochat/services/ el directorio y los JSON necesarios para instalarlo y ejecutarlo en ZeroChat. Usa exclusivamente fuentes oficiales, fija versiones concretas, añade la sección help con el enlace a la documentación oficial, no incluyas secretos y no inicies el servicio. Al terminar, resume los archivos creados, las fuentes consultadas y los requisitos pendientes.\n```\n''', encoding="utf-8")
+
+        example_readme_file.write_text('''# Crear un MCP gestionado por ZeroChat
+
+Esta carpeta es la referencia para crear servicios MCP gestionados. La ubicación de producción es el directorio personal del usuario, seguido de `zerochat/services` (por ejemplo, `/home/usuario/zerochat/services`). No uses `~`, `$HOME` ni una ruta relativa como `services/`: primero identifica la ruta absoluta del directorio personal y úsala para localizar este archivo. El nuevo servicio se crea como carpeta hermana de `ejemplo`, nunca dentro de ella.
+
+## Procedimiento obligatorio
+
+1. Lee `README.md`, `service.json` y `installer.json.example` de la carpeta `ejemplo` situada en el directorio de datos de ZeroChat.
+2. Consulta solo la documentación oficial del MCP solicitado.
+3. Crea una carpeta con un identificador seguro y descriptivo junto a `ejemplo`.
+4. Crea `service.json` copiando esta estructura y adapta únicamente los valores necesarios.
+5. Crea `installer.json` solo si el MCP se distribuye como paquete npm. Copia `installer.json.example`, fija la versión exacta y declara la versión mínima de Node.js.
+6. Añade `help.url` con la página oficial de instalación y etiquetas en español e inglés.
+7. No incluyas tokens, contraseñas ni valores privados. Decláralos en `launch.env` con un marcador, por ejemplo `${HOME_ASSISTANT_TOKEN}`.
+8. No inicies el servicio. Al terminar, informa de los archivos creados, fuentes oficiales y requisitos pendientes.
+
+## Límites de ZeroChat
+
+ZeroChat gestiona procesos MCP por `stdio`. Puede instalar paquetes npm mediante `installer.json` y arrancarlos con `${nodeExecutable}`. También puede arrancar un ejecutable o script ya disponible con `launch`.
+
+No inventes una configuración para un MCP que requiera OAuth interactivo, transporte remoto HTTP/SSE, Docker, Python u otro instalador no soportado por estos JSON. En ese caso, no crees archivos: explica el requisito y qué soporte faltaría.
+
+## Contratos JSON
+
+- `service.json` es obligatorio. Conserva `schemaVersion`, `id`, textos bilingües, `transport: "stdio"` y `launch`.
+- En `launch`, usa `${serviceDir}`, `${nodeExecutable}` o `${pythonExecutable}`; no uses rutas absolutas de usuario.
+- `installer.json` es opcional y hoy solo admite `type: "npm"`.
+- `help` es opcional, pero debe incluirse en todo servicio creado:
+
+```json
+"help": {
+  "url": "https://documentacion-oficial.example/install",
+  "label": { "es": "Instalación oficial", "en": "Official installation" }
+}
+```
+
+## Prompt para el usuario
+
+Sustituye únicamente `<nombre-del-mcp>`:
+
+```text
+Para instalar el MCP <nombre-del-mcp>, localiza el directorio personal del usuario y lee primero el archivo zerochat/services/ejemplo/README.md usando su ruta absoluta. Sigue exactamente sus instrucciones.
+```
+''', encoding="utf-8")
+
         # 2. playwright
         playwright_dir = self.services_root / "playwright"
         playwright_dir.mkdir(parents=True, exist_ok=True)
@@ -1871,6 +1947,7 @@ for raw in sys.stdin:
                 "id": server_id,
                 "displayName": server.get("displayName", {}),
                 "description": server.get("description", {}),
+                "help": server.get("help"),
                 "enabled": pref.get("enabled", server.get("enabledByDefault", False)),
                 "status": "running" if running else self.states.get(server_id, "stopped"),
                 "toolCount": len(client.tools) if running else 0,