Lumina AI - Intelligent Workspace

# Lumina AI Project Description Lumina AI is a Manifest V3 Chrome extension that turns the browser into a developer-focused AI workspace. It is built around a simple but powerful idea: the browser is where a large amount of modern thinking, building, researching, debugging, writing, and planning already happens, so an AI assistant should live directly inside that browser workflow instead of forcing the user to keep switching to a separate application. The project replaces the default Chrome new tab page with a calm assistant workspace, adds an in-page assistant that can summarize and answer questions about normal websites, and includes a dedicated voice-only room for hands-free interaction. Together, these surfaces create a lightweight browser-native command center for developers, students, product builders, founders, and other power users who spend much of their workday moving between tabs, documentation, search results, notes, and AI conversations. The extension is intentionally small in its technical footprint. It does not use a frontend framework, a build system, a package manager, remote JavaScript, or a project-owned backend server. The user interface is written directly in HTML, CSS, and JavaScript. The extension uses Chrome extension APIs for storage, tab control, page scripting, alarms, notifications, and toolbar behavior. AI completions are sent directly to Groq's OpenAI-compatible chat completions endpoint using an API key saved locally in the browser. Optional ElevenLabs support appears in the main new tab runtime as a legacy or experimental path for higher-fidelity spoken replies, but the current dedicated voice room primarily uses browser speech recognition and browser speech synthesis. This design keeps the project easy to inspect, easy to modify, and easy to package for Chrome Web Store release. At a product level, Lumina AI is not just a chat box. It is a collection of browser workflows organized around the new tab page, the current webpage, and the user's voice. The main workspace provides a text assistant with prompt shortcuts, conversation history, notes, settings, themes, and assistant modes such as web search, research brief, and think-it-through. The content script injects a compact assistant drawer into normal HTTP and HTTPS pages, letting users summarize selected text, summarize a whole page, or ask a custom question about page content. The voice page offers a separate room with an animated sphere, live state labels, transcript display, start and freeze controls, speech recognition, spoken answers, and simple voice browser commands such as opening websites or searching the web. The overall project identity is "Lumina AI - Intelligent Workspace." The manifest describes the extension as "A new tab AI workspace for chat, page summaries, notes, reminders, app ideas, and browser actions." That description captures the central purpose well: Lumina is meant to be a workspace, not only an AI wrapper. It is designed to help a user move from messy input to concrete next action. A user might open a new tab and ask for an implementation plan, paste a stack trace and ask for debugging help, summarize a technical article, save a short note, generate app ideas, search the web, open a site, close duplicate tabs, set a timer, change the visual theme, or switch to voice mode. The assistant is most valuable when those actions happen in the same place where the user's browser context already exists. The file structure reflects this product shape. `manifest.json` defines the Chrome extension, permissions, host permissions, background service worker, content script, new tab override, action icon, and icon assets. `newtab.html`, `newtab.css`, and `newtab.js` implement the main workspace. `content.js` implements the in-page assistant injected into websites. `background.js` handles toolbar clicks, fallback script injection, background Groq requests for content scripts, alarm events, notifications, and timer state. `voice.html`, `voice.css`, and `voice.js` implement the dedicated voice mode. `README.md`, `SALES_PITCH.md`, and `deployment_guide.md` document the project, its positioning, installation, privacy model, deployment process, and Chrome Web Store considerations. `build-release.ps1` packages the extension for release, while `gen-icons.ps1` and the icon files support the visual identity. `local-secrets.js` is a local-only configuration file and should not be included in production packages. The manifest is concise and clearly declares the extension's major capabilities. It uses `manifest_version` 3, names the extension "Lumina AI - Intelligent Workspace," and sets the version to `1.0.1`. The permissions include `storage`, `tabs`, `alarms`, `notifications`, and `scripting`. These map directly to the product's features: storing keys and user data, creating and managing tabs, supporting timers and reminders, displaying notifications, and extracting page text when the user asks for page-aware assistance. Host permissions include Groq, ElevenLabs, and `<all_urls>`. The Groq host permission supports AI requests. The ElevenLabs host permission supports the optional text-to-speech path. The broad `<all_urls>` permission supports page summarization and the in-page assistant across normal websites, but it is also the permission that requires the clearest privacy explanation when publishing to the Chrome Web Store. The main new tab page is the heart of the project. Its HTML defines a desktop-first workspace with a top bar, brand area, navigation pills, a collapsible prompt sidebar, a conversation column, assistant mode buttons, a text composer, history and scratchpad side panels, a settings panel, and a suggestion modal. The first impression is a focused developer workspace rather than a marketing landing page. The empty state invites the user to "Start from an idea, a tab, or a messy stack trace," which is a good summary of the intended use cases. The user can begin from direct chat in…