# Hades Agent 2.0.2 Release Notes

🚀 Improvements & Fixes

• Susurro Recording Stability: Addressed a critical race condition that could cause "Failed to start audio recording" errors during rapid UI events. Synchronous ref-based tracking was implemented to stabilize the recording state when the window loses focus.
• UI Refinements:
  • Removed the deprecated window-minimizing icon from the interface to reduce clutter.
  • Corrected the styling for the token cost popup so that information is fully visible without truncation.
• General Cleanup: Removed associated unused CSS styles.

---

Built with ❤️ for a better AI agent experience.

🚀 Hades Agent Release Notes - v2.0.0 (05/25/2026)

This update brings a massive set of architectural refactors, Electron performance improvements, state stabilization (React/IPC), and UI/UX refinements. Below is the technical and functional breakdown of the changes made.

---

✨ New Features

Gemini Live: Chain of Thought (Internal Monologue) Filter

• Implementation in GeminiLiveService: Added a new interception layer in the Gemini API stream. The system now parses the parts objects in real-time and identifies the thought: true flag.
• Stream Cleanup: All reasoning content (internal monologue / Chain of Thought) from the AI is now actively filtered and discarded from the output. The frontend now receives strictly the final formatted text (consumer-facing text), eliminating visual "pollution" in the chat from unfinished responses.

LinkedIn Bot: New Generation Structure

• Update to generation_rules.md: Complete refactoring of the prompt instructions for the LinkedIn bot. The adopted persona is now strictly "Senior Copywriter".
• New Structure (Inverted Pyramid): Post generation now mandatorily follows the structure: Hook -> Fact -> Impact -> Application -> CTA/Source -> Hashtags.
• Legacy Removal: Removed the legacy requirement for cover image links, focusing purely on high-readability text.

---

🛠️ Performance and Core (Electron & IPC)

New Resize and Drag Engine (Window Manager)

• Replacement of legacy startResizing: Manual mouse event tracking via JavaScript to manage window borders in Electron has been completely discarded.
• Native Implementation + requestAnimationFrame: Developed a new "fire-and-forget" strategy, tied to the Operating System's native optimizations and throttled via requestAnimationFrame (rAF). The result is the eradication of any lag, stuttering, or UI freezing when resizing the window.
• Preload and Drag Refactoring: Updated the IPC logic between core services and preload scripts, substantially improving the window dragging behavior (-webkit-app-region: drag) in both the MiniChat and Susurro interfaces.

---

🎨 UI/UX and Styling

Visual Standardization and Sidebars (Susurro & MiniChat)

• Window Parity: Standardized the rendering dimensions of the Susurro and MiniChat interfaces. This architectural change resolves icon misalignments and padding inconsistencies that occurred when switching between modes.
• Navigation Menu Refactoring: The lateral (hamburger) menu was converted to a fluid model, filling the entire height of the screen, utilizing precise absolute positioning (position: absolute) and high-performance CSS transitions.

Menu and Settings Behavior Fixes

• Z-Index and Overlay: Fixed the bug where the settings menu (SettingsMenu) wouldn't receive clicks and the screen turned dark. The overlay layer (.settings-overlay) was set to transparent, and the z-index of the settings menu was fixed (9999) to remain clickable and float correctly.
• Incorrect Blur Removal: Removed the backdrop-filter: blur directly from the settings menu (.settings-menu) which was causing unwanted visual artifacts. The background was adjusted for higher native opacity.
• Conditional Visibility Removed: Eliminated the imperative logic in ChatHeader.tsx that injected display: none and the .hidden class into the settings button (Settings2) when the menu was open, allowing natural rendering and overlapping behavior.

---

🐛 Bug Fixes

Global Shortcuts and Navigation

• Alt+B Shortcut Fix (Susurro): The Alt+B shortcut now correctly initializes the recording interface without accidentally starting a recording (auto-start), and forces the internal state rendering to 'susurro' via the IPC channel, eliminating the bug where the screen would revert to chat or cause window desynchronization.

Critical Data Persistence in Susurro

• Race Condition Fix: There was an architectural flaw (race condition) between the Electron windowManager closing/minimizing events and the local state cleanup in the useSusurro.ts hook.
• Synchronization with sessions.json: The end-session handlers were adjusted to block the transcription state cleanup before the session is fully processed, titled, and persisted in the backend store.
• Loading Feedback: Implemented visual loading states during audio/transcription finalization to prevent the user from closing the app before the data is safely processed.

Stability and Codebase Cleanup (Tech Debt)

• Compilable JSX Failure Resolved: Fixed a severe DOM tree break caused by improperly closed <div> tags in ChatHeader.tsx.
• geminiLiveService.js Refactoring: The massive cyclomatic complexity of this file was reduced by segmenting the parsing responsibilities.
• Legacy Files Cleanup: Total removal of imports based on outdated Node.js libraries, and purging of dozens of unused variables in windowManager.js.
• CSS Refinement: Removal of duplicated and redundant selectors from the global components.css file.
• Accessibility (a11y): Inclusion and fixing of labels and structures that violated basic accessibility guidelines in the headers.

Hades Agent v1.0.0 — First Public Release 🔥

Hades Agent v1.0.0 — First Public Release 🔥

The first official public release of Hades Agent — an invisible, stealth desktop AI companion
for Windows, built on Electron + React + Google Gemini Live API.

---

✨ What's Hades Agent?

Hades floats silently over your desktop, completely hidden from screen recorders and
screenshot tools. Summon it instantly with a global hotkey from any application, get
AI-powered answers grounded in real-time web search, or have a full voice conversation —
all without leaving your workflow.

---

🚀 Core Features

• 🛡️ Anti-Recording Shield — OS-level setContentProtection makes Hades fully invisible
  to OBS, Discord, Teams, Zoom, and all Windows screen-capture APIs.
• ⚡ Spotlight Command Bar (Alt+D) — Floating, borderless AI command bar with image
  attachment support and real-time web search via Tavily.
• 🎙️ Voice HUD — Susurro (Alt+B) — Full-duplex 16 kHz raw PCM audio streamed directly
  to Gemini Live API. Sub-100ms voice-to-response latency.
• 💬 Session MiniChat — Persistent chat HUD with live token counter, model display, and
  one-click session wipe.
• 🧠 Dream Memory Consolidation — Background AI cycles synthesize session logs into a
  compressed local learnings.json memory profile. Fully offline.
• 📋 Task & Reminder Scheduler — Local, offline task ledger via encrypted IPC handlers.
  No cloud dependency.

---

🔑 Requirements

You need two free API keys:

• Google Gemini API Key — AI inference + voice streaming
• Tavily Search API Key — Real-time web search grounding

---

⌨️ Keyboard Shortcuts

Shortcut	Action
Alt+D	Summon / dismiss Spotlight Command Bar
Alt+B	Summon / dismiss Susurro Voice HUD
Alt+S	Open Settings & Shortcut Customization
Alt+V	Toggle voice input mode
Esc	Hide active window and restore prior focus

All shortcuts are fully rebindable inside the Settings panel.

---

📦 Installation

1. Download Hades-Setup-1.0.0.exe below.
2. Run the installer.
3. Press Alt+S to open Settings and save your API keys.
4. Press Alt+D to start.

---

🛠️ Built With

Electron · React 19 · TypeScript · Vite · Google Gemini Live API · Tavily Search API
Co-engineered with Google Antigravity (Advanced Agentic Coding Assistant by Google DeepMind).