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

zerochat 7.3.0__py3-none-any.whl

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

Files changed (130) hide show

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

zerochat_runtime/assets/help/en/architecture.html ADDED Viewed

@@ -0,0 +1,247 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Architecture & Portability · ZeroChat Help</title>
+  <meta name="description" content="Technical architecture of ZeroChat: static HTTPS web application, unified zerochat.py local backend, local IndexedDB storage, and absolute data privacy.">
+  <link rel="stylesheet" href="../help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="../architecture.html" class="top-nav-link">Español 🌐</a>
+          <a href="index.html" class="top-nav-link">← Back to Index</a>
+        </div>
+      </div>
+      <h1>Architecture & Portability</h1>
+      <p class="subtitle">Learn how ZeroChat operates as a server-independent, fully autonomous, 100% portable web application.</p>
+    </header>
+    <div class="card">
+      <h2>1. Static Web Architecture & Unified Backend</h2>
+      <p>
+        ZeroChat is built on a fundamental premise: <strong>maximum simplicity, speed, and control without heavy dependencies</strong>.
+      </p>
+      <p>
+        The web application is served directly and statically over HTTPS from GitHub Pages as <code>zerochat.html</code>, loading modular <code>css/</code> and <code>js/</code> files with no build step. Its Service Worker reuses available resources but does not replace a connection when one is needed.
+      </p>
+      <p>
+        All local system interaction (command execution, file reading, and editing) is channeled through a single Python executable: <code>zerochat.py</code>, which manages its own virtual environment in <code>./zerochat</code> and authenticates sessions using secure daily tokens.
+      </p>
+      <div class="alert alert-success">
+        <strong>Key advantage:</strong> No bundlers, compilers, or build pipelines. The web application runs statically and the local backend runs on any system with a single terminal command.
+      </div>
+    </div>
+    <div class="card" id="modos-arranque">
+      <h2>2. Launch Modes: zerochat.html (Web) vs. zerochat.py (Local Backend)</h2>
+      <p>
+        ZeroChat is designed to deliver two complementary experiences depending on the workflow context: an <strong>autonomous universal web application</strong> (ideal for mobile devices and zero-install daily usage) and a <strong>local workstation host</strong> (for developer workflows requiring direct operating system control).
+      </p>
+      <h3>A. The Standalone Web Version (<code>zerochat.html</code>)</h3>
+      <p>
+        Accessible directly online (via GitHub Pages) or by opening the HTML file locally in any browser. It is a complete, self-contained application that <strong>requires neither Python, terminal commands, auxiliary servers, nor installation</strong>.
+      </p>
+      <ul>
+        <li>
+          <strong>Universal web experience:</strong>
+          Engineered as an installable Progressive Web App (PWA) in modern browsers, with a touch-friendly drawer sidebar and auto-expanding composer. No Python, root access, or terminal tools are needed.
+        </li>
+        <li>
+          <strong>Universal Multi-Model Connectivity:</strong>
+          Connects directly from the browser to commercial cloud AI providers (OpenAI, Anthropic Claude, Google Gemini, OpenRouter) as well as CORS-enabled local network endpoints (Ollama, LM Studio).
+        </li>
+        <li>
+          <strong>Private In-Browser Local Inference (WebLLM / WebGPU):</strong>
+          Downloads and executes open-source LLMs directly on your device GPU with WebGPU, ensuring absolute data privacy without sending messages over the wire.
+        </li>
+        <li>
+          <strong>Integrated Document RAG Knowledge Engine:</strong>
+          Vector and lexical indexing of PDFs, Markdown, and text files using Orama running entirely inside Web Workers and persisted in IndexedDB.
+        </li>
+        <li>
+          <strong>Browser-Sandboxed Agent Mode:</strong>
+          Autonomous multi-turn loop capable of executing JavaScript code in a secure browser sandbox, rendering interactive SVG charts, performing web searches, and fetching public web pages.
+        </li>
+        <li>
+          <strong>Total User Data Sovereignty:</strong>
+          Conversations, branches, attachments, and configurations reside exclusively in your browser's private IndexedDB storage.
+        </li>
+      </ul>
+      <h3>B. What the Local Backend Adds (<code>zerochat.py</code>)</h3>
+      <p>
+        Tailored for desktop workstations (Linux, macOS, Windows) where an agent needs to act as a coding assistant with access to the host operating system. It has also been tested on Android through Termux:
+      </p>
+      <ul>
+        <li>
+          <strong>Host File System Control:</strong>
+          Inspect directory structures, read workspace source code, and apply atomic or chunk-level file modifications on the local disk (<code>read_file</code>, <code>edit_file</code>, <code>list_directory</code>).
+        </li>
+        <li>
+          <strong>Terminal Command Execution:</strong>
+          Run build tools, test runners, scripts, and shell commands in the host terminal environment (<code>execute_command</code>).
+        </li>
+        <li>
+          <strong>External MCP Server Ecosystem:</strong>
+          Integrate Model Context Protocol servers to expand agent capabilities (headless browser automation with Playwright, LSP static analysis servers, SQLite relational storage).
+        </li>
+        <li>
+          <strong>Automated Environment Management:</strong>
+          Manages its own virtual environment in <code>./zerochat</code>, binds to port 6388 with strict ephemeral daily token authorization, and streams real-time terminal logs with timestamping and error diagnostics.
+        </li>
+      </ul>
+      <h3>Feature Comparison Matrix</h3>
+      <div class="table-responsive">
+        <table>
+          <thead>
+            <tr>
+              <th>Feature / Capability</th>
+              <th style="text-align: center;"><code>zerochat.html</code> (Web / PWA)</th>
+              <th style="text-align: center;"><code>zerochat.py</code> (Local Backend)</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td>Commercial AI API connections (OpenAI, Claude, Gemini, etc.)</td>
+              <td style="text-align: center;">✅ Yes</td>
+              <td style="text-align: center;">✅ Yes</td>
+            </tr>
+            <tr>
+              <td>100% In-browser local inference via WebLLM &amp; WebGPU</td>
+              <td style="text-align: center;">✅ Yes</td>
+              <td style="text-align: center;">✅ Yes</td>
+            </tr>
+            <tr>
+              <td>In-browser Document RAG Knowledge Base (Orama)</td>
+              <td style="text-align: center;">✅ Yes</td>
+              <td style="text-align: center;">✅ Yes</td>
+            </tr>
+            <tr>
+              <td>Agent Mode with JS sandbox, web search &amp; SVG charts</td>
+              <td style="text-align: center;">✅ Yes</td>
+              <td style="text-align: center;">✅ Yes</td>
+            </tr>
+            <tr>
+              <td>Private IndexedDB persistence and JSON/Markdown export</td>
+              <td style="text-align: center;">✅ Yes</td>
+              <td style="text-align: center;">✅ Yes</td>
+            </tr>
+            <tr>
+              <td>Direct usage on Mobile (Android / iOS) without Python/terminal</td>
+              <td style="text-align: center;">✅ Native (PWA)</td>
+              <td style="text-align: center;">⚠️ Requires Python (Termux or desktop)</td>
+            </tr>
+            <tr>
+              <td>Host file system navigation, reading and atomic editing</td>
+              <td style="text-align: center;">❌ Not available</td>
+              <td style="text-align: center;">✅ Yes (host tools)</td>
+            </tr>
+            <tr>
+              <td>Host terminal shell command execution</td>
+              <td style="text-align: center;">❌ Not available</td>
+              <td style="text-align: center;">✅ Yes (bash/shell)</td>
+            </tr>
+            <tr>
+              <td>External MCP servers (Playwright, memory, LSP)</td>
+              <td style="text-align: center;">❌ Not available</td>
+              <td style="text-align: center;">✅ Yes (integrated MCP manager)</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+    <div class="card">
+      <h2>3. Static Web Delivery & Local Backend Connectivity</h2>
+      <p>ZeroChat is distributed as a universal static web application:</p>
+      <ul>
+        <li>
+          <strong>Universal Web Delivery (HTTPS):</strong> Served directly from GitHub Pages (<code>https://albalday.github.io/zerochat/zerochat.html</code>). All interface rendering, agent execution, and inference calls happen in the browser with full access to modern web APIs like <code>navigator.storage.persist()</code> and private local IndexedDB storage.
+        </li>
+        <li>
+          <strong>Unified Local Backend (<code>zerochat.py</code>):</strong> Running <code>python3 zerochat.py</code> launches the local server on <code>127.0.0.1:6388</code>, opens the browser pointing to the web app, and passes the daily session token securely via the URL fragment. In Termux, it detects the environment and uses <code>termux-open-url</code> to open the Android browser; on other Linux desktops it uses the default application launcher. The launch command is the same in both cases. The app consumes that fragment only once, removes it from the address bar, and retains the local session in a short-lived cookie, so reloads and new tabs neither expose nor propagate the token again.
+        </li>
+      </ul>
+      <div class="alert alert-info">
+        <strong>Automatic local development &amp; testing:</strong> When running <code>python3 zerochat.py</code> directly inside the cloned repository, it automatically detects the development environment and serves the local interface at <code>http://127.0.0.1:6388/zerochat.html</code> without requiring auxiliary servers or launch scripts.
+        <br><br>
+        <strong>How to run tests:</strong>
+        <ul style="margin-top: 0.5rem; margin-bottom: 0;">
+          <li><code>python3 zerochat.py</code>: Starts the backend and automatically opens the local development web UI in the default browser.</li>
+          <li><code>python3 zerochat.py --test</code>: Runs quick internal self-tests for core host tools (file reading, directory listing, command execution).</li>
+          <li><code>npm test</code>: Runs the full automated test suite (unit, integration, architecture, infrastructure, and Playwright browser tests).</li>
+          <li><code>npm run test:browser</code>: Runs only browser and visual UI tests.</li>
+        </ul>
+      </div>
+    </div>
+    <div class="card">
+      <h2>4. Local Storage & Data Privacy</h2>
+      <p>
+        ZeroChat's storage architecture strictly respects <strong>user data sovereignty</strong>. The application never transmits conversation history, credentials, or documents to any telemetry backend.
+      </p>
+      <h3>Client-side storage layers:</h3>
+      <ul>
+        <li>
+          <strong>IndexedDB (ZeroChatDB):</strong> Structured browser database storing chat sessions, messages, metadata, user profile configurations, and local RAG branches.
+        </li>
+        <li>
+          <strong>Isolated Attachment Store:</strong> Large Base64 images and uploaded documents are isolated in dedicated IndexedDB object stores to keep the active message tree fast, responsive, and lightweight.
+        </li>
+        <li>
+          <strong>Cache Storage API:</strong> Used by WebLLM to persist downloaded local model weights and shader modules.
+        </li>
+        <li>
+          <strong>LocalStorage / Session Cookies (ChatStorage):</strong> Manages UI state and interface preferences (such as the active color theme).
+        </li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>5. Canonical State (ChatState)</h2>
+      <p>
+        To prevent memory leaks or state desynchronization across components, ZeroChat uses a single canonical state store: <code>ChatState</code>.
+      </p>
+      <p>
+        Every lifecycle change (switching sessions, appending streamed tokens, tracking inference progress, or executing tools) occurs through domain mutators (such as <code>appendMessage</code>, <code>replaceMessages</code>, or <code>saveSessionMetadata</code>). This ensures reactive, synchronized updates throughout the UI.
+      </p>
+    </div>
+    <div class="card">
+      <h2>6. Shared conversation rules</h2>
+      <p>New and restored responses share visual block and copy components. Streaming retains its cursor during generation. Connection errors use a common view that escapes the received message and URL before inserting them into HTML.</p>
+      <p>Active configuration comes from <code>ChatConfig</code>. Profile and catalog interfaces query the WebLLM provider for completed models instead of independently parsing stored metadata.</p>
+      <p>State, engine and views reuse <code>message-turns.js</code> rules to identify turns and recognize initial date messages. Turn removal shares a sanitization algorithm; <code>ChatState</code> retains the generation guard and atomic history update.</p>
+    </div>
+    <nav class="page-navigation" aria-label="Help navigation">
+      <div class="nav-button disabled">
+        <span class="nav-direction">First page</span>
+        <span class="nav-title">—</span>
+      </div>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Index</span>
+        <span class="nav-title">View all topics</span>
+      </a>
+      <a href="profiles.html" class="nav-button next">
+        <span class="nav-direction">Next →</span>
+        <span class="nav-title">Profiles & Providers</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Universal Web AI Client · User Manual</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/en/composer.html ADDED Viewed

@@ -0,0 +1,134 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Composer, Shortcuts & Attachments · ZeroChat Help</title>
+  <meta name="description" content="Guide for ZeroChat composer: auto-expanding input, keyboard shortcuts, and multi-format attachments (vision images, PDFs, code, CSV).">
+  <link rel="stylesheet" href="../help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="../composer.html" class="top-nav-link">Español 🌐</a>
+          <a href="index.html" class="top-nav-link">← Back to Index</a>
+        </div>
+      </div>
+      <h1>Composer, Shortcuts & Attachments</h1>
+      <p class="subtitle">Compose prompts comfortably, use keyboard shortcuts, and attach multi-format files and source code.</p>
+    </header>
+    <div class="card">
+      <h2>1. The Floating Composer</h2>
+      <p>
+        ZeroChat's input area is built for a responsive, fluid typing experience:
+      </p>
+      <ul>
+        <li><strong>Smooth Auto-expansion:</strong> The input box grows as you type longer prompts (using <code>field-sizing: content</code> with fallback) without overflowing the viewport.</li>
+        <li><strong>Integrated Controls Bar:</strong> Groups attachments, thinking, RAG, and context telemetry. Tools and MCP are configured in Settings.</li>
+        <li><strong>Mobile input:</strong> The field uses a short hint so the placeholder stays on one line on narrow screens.</li>
+        <li><strong>Stop Stream Button:</strong> During real-time token generation, the send button switches to an instant stop control.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>2. Essential Keyboard Shortcuts</h2>
+      <div class="table-responsive">
+        <table>
+          <thead>
+            <tr>
+              <th>Shortcut</th>
+              <th>Context</th>
+              <th>Action Performed</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td><code>Enter</code></td>
+              <td>In prompt textarea</td>
+              <td>Send message to model.</td>
+            </tr>
+            <tr>
+              <td><code>Shift + Enter</code></td>
+              <td>In prompt textarea</td>
+              <td>Insert a new line without sending.</td>
+            </tr>
+            <tr>
+              <td><code>Escape</code></td>
+              <td>In any open modal or menu</td>
+              <td>Close active popup or dialog.</td>
+            </tr>
+            <tr>
+              <td><code>Arrow Keys ↑ / ↓</code></td>
+              <td>In profile selection menu</td>
+              <td>Navigate through available profiles.</td>
+            </tr>
+            <tr>
+              <td><code>Ctrl / Cmd + V</code></td>
+              <td>Anywhere in chat window</td>
+              <td>Paste images or text directly from clipboard.</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </div>
+    <div class="card">
+      <h2>3. Attaching Files & Documents</h2>
+      <p>
+        ZeroChat includes a client-side file ingestion engine (<code>file-parser.js</code>). Attach files via the paperclip icon or by <strong>dragging and dropping</strong> them into the window.
+      </p>
+      <h3>Supported Formats:</h3>
+      <ul>
+        <li><strong>Images (PNG, JPEG, WebP, GIF):</strong> For vision-capable models (e.g., GPT-4o, Claude 3.5/3.7, Gemini Flash/Pro).</li>
+        <li><strong>PDF Documents:</strong> Text is extracted client-side with page count and title metadata.</li>
+        <li><strong>Source Code & Scripts:</strong> <code>.js</code>, <code>.ts</code>, <code>.py</code>, <code>.html</code>, <code>.css</code>, <code>.json</code>, <code>.sql</code>, <code>.c</code>, <code>.rs</code>, <code>.go</code>, <code>.sh</code> with syntax highlighting.</li>
+        <li><strong>Data Tables:</strong> <code>.csv</code> and <code>.tsv</code> files for data extraction and charting.</li>
+        <li><strong>Text Files:</strong> <code>.md</code>, <code>.txt</code>, <code>.xml</code>, <code>.yaml</code>.</li>
+      </ul>
+      <div class="alert alert-info">
+        <strong>Preview & Removal:</strong> Miniatures show file name and size before sending. Click the "X" on any item to discard it.
+      </div>
+    </div>
+    <div class="card">
+      <h2>4. Rich Message Formatting</h2>
+      <p>
+        Assistant responses are rendered with a high-performance Markdown engine featuring:
+      </p>
+      <ul>
+        <li>Syntax-highlighted code blocks with a quick copy button.</li>
+        <li>Formatted tables with alignment styling.</li>
+        <li>LaTeX math equations (KaTeX) inline and in block mode.</li>
+        <li>Collapsible Thinking blocks with deliberation timers.</li>
+        <li>Interactive Tool Cards for agent executions.</li>
+      </ul>
+    </div>
+    <nav class="page-navigation" aria-label="Help navigation">
+      <a href="conversations.html" class="nav-button prev">
+        <span class="nav-direction">← Previous</span>
+        <span class="nav-title">Conversations & Branching</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Index</span>
+        <span class="nav-title">View all topics</span>
+      </a>
+      <a href="reasoning-telemetry.html" class="nav-button next">
+        <span class="nav-direction">Next →</span>
+        <span class="nav-title">Reasoning & Telemetry</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Universal Web AI Client · User Manual</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/en/conversations.html ADDED Viewed

@@ -0,0 +1,104 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Conversations, History & Branching · ZeroChat Help</title>
+  <meta name="description" content="Guide for organizing conversations in ZeroChat: chronological sidebar, instant search, turn branching, and secure session export/import.">
+  <link rel="stylesheet" href="../help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="../conversations.html" class="top-nav-link">Español 🌐</a>
+          <a href="index.html" class="top-nav-link">← Back to Index</a>
+        </div>
+      </div>
+      <h1>Conversations, History & Branching</h1>
+      <p class="subtitle">Manage chat sessions, explore alternative answers with branching, and safely back up your conversations.</p>
+    </header>
+    <div class="card">
+      <h2>1. The Conversations Sidebar</h2>
+      <p>
+        The left-hand sidebar (accessible on mobile via the top-left menu button) houses your complete chat archive.
+      </p>
+      <ul>
+        <li><strong>New Chat:</strong> Instantly creates a clean chat session preserving your active profile.</li>
+        <li><strong>Chronological Grouping:</strong> Chats are organized into clear time buckets: <em>Today</em>, <em>Yesterday</em>, <em>Previous 7 Days</em>, <em>This Month</em>, and <em>Older</em>.</li>
+        <li><strong>Real-time Search:</strong> Filter your chat history instantly by title.</li>
+        <li><strong>Quick Session Actions:</strong> Hover over any session to export or delete it individually.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>2. Turn Branching</h2>
+      <p>
+        <strong>Branching</strong> lets you explore alternative lines of thought without losing previous context.
+      </p>
+      <h3>How it works:</h3>
+      <ol>
+        <li>Click the branch icon button beneath any assistant response.</li>
+        <li>ZeroChat creates a <strong>new independent chat</strong> containing the conversation history up to that point.</li>
+        <li>Subsequent messages from the original conversation are omitted in the new branch, allowing you to ask a different follow-up or test an alternative model.</li>
+        <li>The original conversation remains completely intact and accessible from the sidebar.</li>
+      </ol>
+      <div class="alert alert-info">
+        <strong>Typical use case:</strong> When an assistant offers two approaches to a problem, branch at that turn to explore "Option A" in one chat and "Option B" in another.
+      </div>
+    </div>
+    <div class="card">
+      <h2>3. Exporting Conversations</h2>
+      <p>
+        Export your chat sessions into standard formats:
+      </p>
+      <ul>
+        <li><strong>Full Session JSON:</strong> Contains messages, metadata, tool calls, and profile settings. Functions as a 1:1 backup that can be imported back into ZeroChat.</li>
+        <li><strong>Markdown (.md):</strong> Formatted text ready for Obsidian, GitHub, Notion, or personal wikis, preserving headers, code blocks, tables, and math equations.</li>
+        <li><strong>Plain Text (.txt):</strong> Lightweight transcript for quick reading and sharing.</li>
+        <li><strong>PDF:</strong> A print-ready view that can be saved as PDF.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>4. Session Import & Safe Purge</h2>
+      <p>
+        Click <strong>"Import chat"</strong> in the sidebar footer to load any exported ZeroChat <code>.json</code> file.
+      </p>
+      <p>
+        Imported sessions are validated, sanitized, and stored directly into your browser's IndexedDB database.
+      </p>
+      <p>Only ZeroChat JSON backups can be imported, and importing is unavailable while a response is being generated.</p>
+      <div class="alert alert-warning">
+        <strong>Safe Bulk Deletion:</strong> The trash icon in the sidebar footer lets you delete all stored chats at once. ZeroChat prompts for confirmation before wiping data.
+      </div>
+    </div>
+    <nav class="page-navigation" aria-label="Help navigation">
+      <a href="debug.html" class="nav-button prev">
+        <span class="nav-direction">← Previous</span>
+        <span class="nav-title">Debugging & Interceptor</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Index</span>
+        <span class="nav-title">View all topics</span>
+      </a>
+      <a href="composer.html" class="nav-button next">
+        <span class="nav-direction">Next →</span>
+        <span class="nav-title">Composer & Multimedia</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Universal Web AI Client · User Manual</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/en/debug.html ADDED Viewed

@@ -0,0 +1,105 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Debugging, Logs & Message Interceptor · ZeroChat Help</title>
+  <meta name="description" content="Guide to ZeroChat's debug panel, Raw view, and request interceptor.">
+  <link rel="stylesheet" href="../help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <div class="header-top">
+        <a href="index.html" class="logo-badge">
+          <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 17l6-6-6-6M12 19h8"/></svg>
+          ZeroChat Docs
+        </a>
+        <div class="header-actions">
+          <a href="../debug.html" class="top-nav-link">Español 🌐</a>
+          <a href="index.html" class="top-nav-link">← Back to Index</a>
+        </div>
+      </div>
+      <h1>Debugging, Logs & Interceptor</h1>
+      <p class="subtitle">Inspect internal inference events, monitor network traffic, and modify payloads in flight with the interactive interceptor.</p>
+    </header>
+    <div class="card">
+      <h2>1. The Debug Panel</h2>
+      <p>
+        ZeroChat includes a right-hand sidebar designed for developers, security researchers, and power users. Click the terminal icon in the top-right header to toggle the panel.
+      </p>
+      <p>
+        The panel provides a live, monospace console streaming system events in real time.
+      </p>
+      <h3>Event Filter Tabs:</h3>
+      <ul>
+        <li><strong>All:</strong> Unified log view containing system, network, and tool execution messages.</li>
+        <li><strong>Thinking:</strong> Isolates native model reasoning and chain-of-thought blocks.</li>
+        <li><strong>Tool:</strong> Tracks function invocations, parameter bindings, and return values.</li>
+        <li><strong>Network:</strong> Displays HTTP calls, header payloads, status codes, and connection latency.</li>
+        <li><strong>Raw:</strong> Shows unprocessed provider communication entries and outputs.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>2. Console Utilities</h2>
+      <ul>
+        <li><strong>Copy Logs:</strong> Copies the formatted log history with timestamps to your clipboard for bug reporting.</li>
+        <li><strong>Clear Console:</strong> Clears the active log view to begin a fresh debugging session.</li>
+        <li><strong>Auto-scroll:</strong> Toggles following latest events automatically or pausing to inspect past entries.</li>
+      </ul>
+    </div>
+    <div class="card">
+      <h2>3. Message Interceptor Mode (Debug Messages)</h2>
+      <p>
+        The <strong>Message Interceptor</strong> pauses outgoing requests right before transmission when the <em>"Debug messages"</em> switch is enabled.
+      </p>
+      <h3>How it works:</h3>
+      <ol>
+        <li>Type a prompt and press Send. The request is <strong>held before reaching the network</strong>.</li>
+        <li>An inspection dialog opens showing the exact <strong>JSON payload</strong> (system prompts, message history, registered tool schemas, temperature, etc.).</li>
+        <li>You can inspect fields, manually edit parameters, or test prompt mutations directly.</li>
+        <li>The header contains the send actions and an X button to cancel:
+          <ul>
+            <li><strong>Continue / Send:</strong> Sends the edited payload to the provider.</li>
+            <li><strong>Send &amp; stop debug:</strong> Sends the payload and disables the interceptor for subsequent requests.</li>
+            <li><strong>X:</strong> Aborts the request cleanly with zero tokens spent.</li>
+          </ul>
+        </li>
+      </ol>
+      <div class="alert alert-info">
+        <strong>Ideal for developers:</strong> Test model robustness against adversarial prompts or verify tool call schema definitions without writing custom proxy code.
+      </div>
+    </div>
+    <div class="card">
+      <h2>4. Raw view</h2>
+      <p>
+        The <em>Raw</em> tab is available directly in the panel; it needs no separate activation. Entries are capped to keep the panel usable.
+      </p>
+      <p>Use it to inspect requests, streaming responses, and tool calls while diagnosing a provider.</p>
+    </div>
+    <nav class="page-navigation" aria-label="Help navigation">
+      <a href="mcp.html" class="nav-button prev">
+        <span class="nav-direction">← Previous</span>
+        <span class="nav-title">MCP Protocol</span>
+      </a>
+      <a href="index.html" class="nav-button index">
+        <span class="nav-direction">Index</span>
+        <span class="nav-title">View all topics</span>
+      </a>
+      <a href="conversations.html" class="nav-button next">
+        <span class="nav-direction">Next →</span>
+        <span class="nav-title">Conversations & Branching</span>
+      </a>
+    </nav>
+    <footer>
+      <p>ZeroChat · Universal Web AI Client · User Manual</p>
+    </footer>
+  </div>
+</body>
+</html>

zerochat_runtime/assets/help/en/gemini-free.html ADDED Viewed

@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Gemini API key · ZeroChat</title>
+  <meta name="description" content="How to create a Gemini API key for use in ZeroChat.">
+  <link rel="stylesheet" href="../help.css">
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>Get a Gemini API key</h1>
+      <p class="subtitle">Create the key in Google AI Studio using your Google account.</p>
+    </header>
+    <main>
+      <section class="card">
+        <h2>Steps</h2>
+        <ol>
+          <li>
+            Open <a href="https://aistudio.google.com/apikey" target="_blank" rel="noopener noreferrer">Google AI Studio’s official API keys page</a> and sign in with your Google account.
+          </li>
+          <li>Accept the terms if Google asks you to. New accounts may receive an initial project and API key automatically.</li>
+          <li>If you do not have a key to use, select <strong>Create API key</strong> and follow the dialog to create or choose a project.</li>
+          <li>Copy the API key and store it privately.</li>
+          <li>In ZeroChat, create or edit a <strong>Gemini</strong> provider profile, paste the key, and select an available model.</li>
+        </ol>
+      </section>
+      <section class="card">
+        <h2>Important</h2>
+        <p>Models, limits, prices, and availability change. Check <a href="https://ai.google.dev/gemini-api/docs/billing" target="_blank" rel="noopener noreferrer">Gemini API's official information</a> before production use.</p>
+        <p>Never share the API key or publish it in chats, screenshots, repositories, or public configuration files.</p>
+      </section>
+    </main>
+  </div>
+</body>
+</html>